@temir.ra/create-test115 0.0.27 → 0.0.29

package/README.md

@@ -197,10 +197,12 @@ bun install
     }
   },
 
-  // package-internal import aliases resolved natively by Node.js and Bun; keys must start with #
-  // use as: import { foo } from "#src/utils.js"
+  // package-internal import alias resolved natively by Node.js and Bun at runtime; key must start with #
+  // for use in dev.ts, tests/, and scripts/ only — NOT in library source files compiled by tsconfig.build.json
+  // the .js extension is required in import statements (nodenext compliance);
+  // the runtime maps it to the actual .ts source file via this field
   "imports": {
-    "#src/*": "./src/*"
+    "#src/*.js": "./src/*.ts"
   },
 
   // CLI entry point; omit if the package is not a CLI tool
@@ -215,12 +217,14 @@ bun install
 
   "scripts": {
 
-    "clean": "rm -rf dist/",
+    "clean:dist": "rm -rf dist/",
+    "clean:tsbuildinfo": "rm -f tsconfig.build.tsbuildinfo",
+    "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
 
     // lifecycle hook; runs automatically before "build"; generates buildinfo.txt
     "prebuild": "bun run scripts/buildinfo.ts",
 
-    "test": "bun test",
+    "tests": "bun test",
 
     "build": "bun run build:lib && bun run build:lib-bundle",
 
@@ -299,10 +303,18 @@ AI assistant context files. Provide project layout, commands, and architecture n
 
 ## Build
 
-`prebuild` runs automatically before `build`, generating `buildinfo.txt`.
-
 ```bash
-bun run build      # compile via tsc + bundle to ESM, IIFE, and CLI
+# remove dist/ and tsconfig.build.tsbuildinfo
+bun run clean
+
+# remove dist/ only
+bun run clean:dist
+
+# remove tsconfig.build.tsbuildinfo only
+bun run clean:tsbuildinfo
+
+# compile + bundle
+bun run build
 ```
 
 ## Change Management

package/buildinfo.txt

@@ -1 +1 @@
-0.0.27+3f30950
+0.0.29+5b26ba8

package/dist/cli.bundle.js.map

@@ -2,7 +2,7 @@
   "version": 3,
   "sources": ["..\\src\\cli.ts", "..\\src\\urls.ts"],
   "sourcesContent": [
-    "#!/usr/bin/env node\r\n\r\nimport { cpSync, readFileSync, renameSync, writeFileSync } from 'fs';\r\nimport { resolve, basename } from 'path';\r\nimport { fileURLToPath } from 'url';\r\nimport { buildinfoUrl, changelogUrl, templateUrl } from './urls.js';\r\n\r\n\r\ntry {\r\n\r\n    const dest = process.argv[2];\r\n    if (!dest) throw new Error('Destination path is required. Usage: `bun/npm create <template> <destination>`');\r\n\r\n    const destinationPath = resolve(process.cwd(), dest);\r\n    const packageName = basename(destinationPath);\r\n\r\n    const templatePath = resolve(fileURLToPath(templateUrl));\r\n\r\n    cpSync(templatePath, destinationPath, { recursive: true });\r\n    cpSync(resolve(fileURLToPath(changelogUrl)), resolve(destinationPath, 'CHANGELOG-template.md'));\r\n    cpSync(resolve(fileURLToPath(buildinfoUrl)), resolve(destinationPath, 'buildinfo-template.txt'));\r\n\r\n    const packageManifestPath = resolve(destinationPath, 'package.json');\r\n    const packageManifest = JSON.parse(readFileSync(packageManifestPath, 'utf-8'));\r\n    packageManifest.name = packageName;\r\n    writeFileSync(packageManifestPath, JSON.stringify(packageManifest, null, 2));\r\n\r\n    renameSync(resolve(destinationPath, 'gitignore'), resolve(destinationPath, '.gitignore'));\r\n\r\n    console.log(`Template has been successfully instantiated at '${destinationPath}' with package name '${packageName}'.`);\r\n\r\n}\r\ncatch (error) {\r\n    const err = error instanceof Error ? error : new Error(String(error));\r\n    console.error('Error:', err.message);\r\n    process.exit(1);\r\n}\r\n",
+    "#!/usr/bin/env node\r\n\r\nimport { cpSync, readFileSync, renameSync, writeFileSync } from 'fs';\r\nimport { resolve, basename } from 'path';\r\nimport { fileURLToPath } from 'url';\r\nimport { buildinfoUrl, changelogUrl, templateUrl } from '#src/urls.js';\r\n\r\n\r\ntry {\r\n\r\n    const dest = process.argv[2];\r\n    if (!dest) throw new Error('Destination path is required. Usage: `bun/npm create <template> <destination>`');\r\n\r\n    const destinationPath = resolve(process.cwd(), dest);\r\n    const packageName = basename(destinationPath);\r\n\r\n    const templatePath = resolve(fileURLToPath(templateUrl));\r\n\r\n    cpSync(templatePath, destinationPath, { recursive: true });\r\n    cpSync(resolve(fileURLToPath(changelogUrl)), resolve(destinationPath, 'CHANGELOG-template.md'));\r\n    cpSync(resolve(fileURLToPath(buildinfoUrl)), resolve(destinationPath, 'buildinfo-template.txt'));\r\n\r\n    const packageManifestPath = resolve(destinationPath, 'package.json');\r\n    const packageManifest = JSON.parse(readFileSync(packageManifestPath, 'utf-8'));\r\n    packageManifest.name = packageName;\r\n    writeFileSync(packageManifestPath, JSON.stringify(packageManifest, null, 2));\r\n\r\n    renameSync(resolve(destinationPath, 'gitignore'), resolve(destinationPath, '.gitignore'));\r\n\r\n    console.log(`Template has been successfully instantiated at '${destinationPath}' with package name '${packageName}'.`);\r\n\r\n}\r\ncatch (error) {\r\n    const err = error instanceof Error ? error : new Error(String(error));\r\n    console.error('Error:', err.message);\r\n    process.exit(1);\r\n}\r\n",
     "export const distUrl: URL = new URL('.', import.meta.url);\r\nexport const changelogUrl: URL = new URL('../CHANGELOG.md', distUrl);\r\nexport const buildinfoUrl: URL = new URL('../buildinfo.txt', distUrl);\r\nexport const templateUrl: URL = new URL('../template', distUrl);\r\n"
   ],
   "mappings": ";AAEA,iBAAS,kBAAQ,gBAAc,mBAAY,WAC3C,kBAAS,cAAS,aAClB,wBAAS,YCJF,IAAM,EAAe,IAAI,IAAI,IAAK,YAAY,GAAG,EAC3C,EAAoB,IAAI,IAAI,kBAAmB,CAAO,EACtD,EAAoB,IAAI,IAAI,mBAAoB,CAAO,EACvD,EAAmB,IAAI,IAAI,cAAe,CAAO,EDK9D,GAAI,CAEA,IAAM,EAAO,QAAQ,KAAK,GAC1B,GAAI,CAAC,EAAM,MAAU,MAAM,gFAAgF,EAE3G,IAAM,EAAkB,EAAQ,QAAQ,IAAI,EAAG,CAAI,EAC7C,EAAc,EAAS,CAAe,EAEtC,EAAe,EAAQ,EAAc,CAAW,CAAC,EAEvD,EAAO,EAAc,EAAiB,CAAE,UAAW,EAAK,CAAC,EACzD,EAAO,EAAQ,EAAc,CAAY,CAAC,EAAG,EAAQ,EAAiB,uBAAuB,CAAC,EAC9F,EAAO,EAAQ,EAAc,CAAY,CAAC,EAAG,EAAQ,EAAiB,wBAAwB,CAAC,EAE/F,IAAM,EAAsB,EAAQ,EAAiB,cAAc,EAC7D,EAAkB,KAAK,MAAM,EAAa,EAAqB,OAAO,CAAC,EAC7E,EAAgB,KAAO,EACvB,EAAc,EAAqB,KAAK,UAAU,EAAiB,KAAM,CAAC,CAAC,EAE3E,EAAW,EAAQ,EAAiB,WAAW,EAAG,EAAQ,EAAiB,YAAY,CAAC,EAExF,QAAQ,IAAI,mDAAmD,yBAAuC,KAAe,EAGzH,MAAO,EAAO,CACV,IAAM,EAAM,aAAiB,MAAQ,EAAY,MAAM,OAAO,CAAK,CAAC,EACpE,QAAQ,MAAM,SAAU,EAAI,OAAO,EACnC,QAAQ,KAAK,CAAC",

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { cpSync, readFileSync, renameSync, writeFileSync } from 'fs';
+import { resolve, basename } from 'path';
+import { fileURLToPath } from 'url';
+import { buildinfoUrl, changelogUrl, templateUrl } from '#src/urls.js';
+try {
+    const dest = process.argv[2];
+    if (!dest)
+        throw new Error('Destination path is required. Usage: `bun/npm create <template> <destination>`');
+    const destinationPath = resolve(process.cwd(), dest);
+    const packageName = basename(destinationPath);
+    const templatePath = resolve(fileURLToPath(templateUrl));
+    cpSync(templatePath, destinationPath, { recursive: true });
+    cpSync(resolve(fileURLToPath(changelogUrl)), resolve(destinationPath, 'CHANGELOG-template.md'));
+    cpSync(resolve(fileURLToPath(buildinfoUrl)), resolve(destinationPath, 'buildinfo-template.txt'));
+    const packageManifestPath = resolve(destinationPath, 'package.json');
+    const packageManifest = JSON.parse(readFileSync(packageManifestPath, 'utf-8'));
+    packageManifest.name = packageName;
+    writeFileSync(packageManifestPath, JSON.stringify(packageManifest, null, 2));
+    renameSync(resolve(destinationPath, 'gitignore'), resolve(destinationPath, '.gitignore'));
+    console.log(`Template has been successfully instantiated at '${destinationPath}' with package name '${packageName}'.`);
+}
+catch (error) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    console.error('Error:', err.message);
+    process.exit(1);
+}

package/dist/urls.d.ts

@@ -0,0 +1,5 @@
+export declare const distUrl: URL;
+export declare const changelogUrl: URL;
+export declare const buildinfoUrl: URL;
+export declare const templateUrl: URL;
+//# sourceMappingURL=urls.d.ts.map

package/dist/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../src/urls.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,EAAE,GAAmC,CAAC;AAC1D,eAAO,MAAM,YAAY,EAAE,GAAyC,CAAC;AACrE,eAAO,MAAM,YAAY,EAAE,GAA0C,CAAC;AACtE,eAAO,MAAM,WAAW,EAAE,GAAqC,CAAC"}

package/dist/urls.js

@@ -0,0 +1,4 @@
+export const distUrl = new URL('.', import.meta.url);
+export const changelogUrl = new URL('../CHANGELOG.md', distUrl);
+export const buildinfoUrl = new URL('../buildinfo.txt', distUrl);
+export const templateUrl = new URL('../template', distUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temir.ra/create-test115",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "Typescript library template",
   "author": "temir.ra",
   "license": "MIT",
@@ -16,18 +16,8 @@
   },
   "type": "module",
   "sideEffects": false,
-  "exports": {
-    ".": {
-      "entrypoint": "./src/cli.ts",
-      "browser": "./dist/index.bundle.js",
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
   "imports": {
-    "#src/*": "./src/*",
-    "#scripts/*": "./scripts/*",
-    "#tests/*": "./tests/*"
+    "#src/*.js": "./src/*.ts"
   },
   "bin": "./dist/cli.bundle.js",
   "files": [
@@ -37,12 +27,13 @@
     "template"
   ],
   "scripts": {
-    "clean": "rm -rf dist/",
+    "clean:dist": "rm -rf dist/",
+    "clean:tsbuildinfo": "rm -f tsconfig.build.tsbuildinfo",
+    "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
     "prebuild": "bun run scripts/buildinfo.ts",
-    "test": "bun test",
-    "build": "bun run build:lib && bun run build:lib-bundle && bun run build:cli-bundle",
+    "tests": "bun test",
+    "build": "bun run build:lib && bun run build:cli-bundle",
     "build:lib": "tsc --project tsconfig.build.json",
-    "build:lib-bundle": "bun run scripts/build-lib-bundle.ts",
     "build:cli-bundle": "bun build src/cli.ts --entry-naming \"[dir]/[name].bundle.[ext]\" --outdir dist --target node --format esm --minify --sourcemap=external",
     "typecheck": "tsc --noEmit",
     "dev": "bun run --watch src/dev.ts"

package/template/CLAUDE.md

@@ -27,12 +27,71 @@ A Bun TypeScript library.
 ```bash
 bun install       # Install dependencies
 bun run build     # Compile + bundle the library
-bun run test      # Run unit tests
+bun run tests     # Run unit tests
 bun run typecheck # Type-check without emitting
 bun run dev       # Run src/dev.ts in watch mode
-bun run clean     # Remove dist/
+bun run clean              # Remove dist/ and tsconfig.build.tsbuildinfo
+bun run clean:dist         # Remove dist/ only
+bun run clean:tsbuildinfo  # Remove tsconfig.build.tsbuildinfo only
 ```
 
+## Writing Code
+
+### Where things go
+
+| Path | Purpose |
+|------|---------|
+| `src/index.ts` | Public API — the only entry point consumers see; export everything public from here |
+| `src/*.ts` | Library source modules — add new modules here, re-export from `index.ts` |
+| `src/dev.ts` | Development scratchpad — excluded from build, never published; use for manual testing |
+| `tests/*.test.ts` | Unit tests — Bun test runner |
+
+### Imports within `src/`
+
+`tsconfig.build.json` uses `moduleResolution: nodenext`, so imports between library source files must use explicit `.js` extensions:
+
+```ts
+import { helper } from "./helper.js"  // ✓
+import { helper } from "./helper"     // ✗ — fails under nodenext
+```
+
+The `#src/*.js` package alias is available in `dev.ts`, `tests/`, and `scripts/`, but **not** in library source files — tsc emits the specifier verbatim and it would break in published unbundled output.
+
+### Explicit return types (`isolatedDeclarations`)
+
+All exported declarations require explicit type annotations so tsc can emit `.d.ts` files without cross-file inference:
+
+```ts
+export function greet(name: string): string { ... }  // ✓
+export function greet(name: string) { ... }          // ✗ — implicit return type
+```
+
+### Type-only imports (`verbatimModuleSyntax`)
+
+Use `import type` for imports that are only used as types:
+
+```ts
+import type { Foo } from "./foo.js"       // ✓ — type-only import
+import { type Foo, bar } from "./foo.js"  // ✓ — mixed
+import { Foo } from "./foo.js"            // ✗ — if Foo is only used as a type
+```
+
+### Tests
+
+Tests live in `tests/` and use Bun's built-in runner:
+
+```ts
+import { describe, test, expect } from "bun:test"
+
+describe("greet", () => {
+  test("returns greeting", () => {
+    expect(greet("world")).toBe("hello, world")
+  })
+})
+```
+
+Run with `bun run tests`.
+
 ## TypeScript Configuration
 
 Two tsconfig files serve different purposes:
@@ -66,7 +125,7 @@ The `exports` field in `package.json` maps consumers to the right file:
 Key `package.json` fields:
 
 - `"sideEffects": false` — enables full tree-shaking by bundlers
-- `"imports": { "#src/*": "./src/*" }` — package-internal path aliases resolved natively at runtime; use `import { foo } from "#src/utils.js"`
+- `"imports": { "#src/*.js": "./src/*.ts" }` — package-internal alias for `src/`; use as `import { foo } from "#src/module.js"`. **Only for `dev.ts`, `tests/`, and `scripts/`** — not for library source files compiled by `tsconfig.build.json`, as tsc emits the specifier verbatim and it would break in published unbundled output.
 
 ## Publishing
 

package/template/README.md

@@ -12,25 +12,27 @@
 
 # Quick Start
 
-**Development**
-
 ```bash
-bun run dev        # run src/dev.ts in watch mode
-bun test           # run tests
-bun run typecheck  # type-check without emitting
-```
+# remove dist/ and tsconfig.build.tsbuildinfo
+bun run clean
 
-**Build**
+# remove dist/ only
+bun run clean:dist
 
-`prebuild` runs automatically before `build`, generating `buildinfo.txt`.
+# remove tsconfig.build.tsbuildinfo only
+bun run clean:tsbuildinfo
 
-```bash
-bun run build      # compile via tsc + bundle to ESM and IIFE
-```
+# compile + bundle
+bun run build
+
+# run tests
+bun run tests
 
-**Publish**
+# run src/dev.ts in watch mode
+bun run dev
+```
 
-See [Publish](#publish).
+**Publish** — see [Publish](#publish).
 
 # Documentation
 

package/template/package.json

@@ -22,9 +22,7 @@
     }
   },
   "imports": {
-    "#src/*": "./src/*",
-    "#scripts/*": "./scripts/*",
-    "#tests/*": "./tests/*"
+    "#src/*.js": "./src/*.ts"
   },
   "files": [
     "dist",
@@ -32,9 +30,11 @@
     "buildinfo.txt"
   ],
   "scripts": {
-    "clean": "rm -rf dist/",
+    "clean:dist": "rm -rf dist/",
+    "clean:tsbuildinfo": "rm -f tsconfig.build.tsbuildinfo",
+    "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
     "prebuild": "bun run scripts/buildinfo.ts",
-    "test": "bun test",
+    "tests": "bun test",
     "build": "bun run build:lib && bun run build:lib-bundle",
     "build:lib": "tsc --project tsconfig.build.json",
     "build:lib-bundle": "bun run scripts/build-lib-bundle.ts",

package/template/scripts/build-lib-bundle.ts

@@ -1,6 +1,6 @@
 import { readFileSync } from 'fs';
 import { join } from 'path';
-import CDN_REWRITE_MAP from '#scripts/cdn-rewrite-map.json';
+import CDN_REWRITE_MAP from './cdn-rewrite-map.json';
 
 
 interface ExportConditions {

package/template/src/dev.ts

@@ -1,5 +1,15 @@
+import { buildinfoUrl, changelogUrl, distUrl } from '#src/urls.js';
+import { fileURLToPath } from 'url';
+
+
 const start: number = performance.now();
 
+console.log(`'distPath':`, fileURLToPath(distUrl));
+console.log(`'buildinfoPath':`, fileURLToPath(buildinfoUrl));
+console.log(`'changelogPath':`, fileURLToPath(changelogUrl));
+
+
 // dev code
 
+
 console.log(`${(performance.now() - start).toFixed(3)}ms`);