docs: add reproduction example

Author: danielpza

.gitignore

@@ -75,3 +75,5 @@ fabric.properties
 
 # Editor-based Rest Client
 .idea/httpRequests
+
+pnpm-lock.yaml

examples/basic/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "example-basic",
+  "type": "module",
+  "scripts": {
+    "start": "node dist/index.js",
+    "build": "tsc",
+    "prepare": "ts-patch install -s && pnpm build"
+  },
+  "packageManager": "pnpm@10.12.4",
+  "devDependencies": {
+    "ts-patch": "^3.3.0",
+    "typescript": "^5.9.2",
+    "typescript-transform-paths": "^3.5.5"
+  }
+}

examples/basic/pnpm-lock.yaml

@@ -0,0 +1,3 @@
+import { greet } from "#utils/greet.js";
+
+console.log(greet("World"));

examples/basic/src/index.ts

@@ -0,0 +1,3 @@
+export function greet(name: string) {
+  return `Hello ${name}!`;
+}

examples/basic/src/utils/greet.ts

@@ -0,0 +1,55 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "nodenext",
+    "target": "esnext",
+    "types": [],
+    // For nodejs:
+    // "lib": ["esnext"],
+    // "types": ["node"],
+    // and npm install -D @types/node
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+
+    // Add Plugin
+    "plugins": [
+      { "transform": "typescript-transform-paths", "useRootDirs": true },
+      { "transform": "typescript-transform-paths", "useRootDirs": true, "afterDeclarations": true }
+    ],
+    // Configure paths
+    "baseUrl": ".",
+    "paths": {
+      "#utils/*.js": ["./src/utils/*.js"]
+    }
+  }
+}