@temir.ra/create-test115 0.0.28 → 0.0.29

package/README.md

@@ -217,7 +217,9 @@ 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",
@@ -302,6 +304,16 @@ AI assistant context files. Provide project layout, commands, and architecture n
 ## Build
 
 ```bash
+# 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
 ```
 

package/buildinfo.txt

@@ -1 +1 @@
-0.0.28+db1b08e
+0.0.29+5b26ba8

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.28",
+  "version": "0.0.29",
   "description": "Typescript library template",
   "author": "temir.ra",
   "license": "MIT",
@@ -27,7 +27,9 @@
     "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",
     "tests": "bun test",
     "build": "bun run build:lib && bun run build:cli-bundle",

package/template/CLAUDE.md

@@ -30,9 +30,68 @@ bun run build     # Compile + bundle the library
 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:

package/template/README.md

@@ -12,28 +12,27 @@
 
 # Quick Start
 
-**Development**
-
 ```bash
-# run src/dev.ts in watch mode
-bun run dev
-
-# run tests
-bun run tests
+# remove dist/ and tsconfig.build.tsbuildinfo
+bun run clean
 
-# type-check without emitting
-bun run typecheck
-```
+# remove dist/ only
+bun run clean:dist
 
-**Build**
+# remove tsconfig.build.tsbuildinfo only
+bun run clean:tsbuildinfo
 
-```bash
+# compile + bundle
 bun run build
-```
 
-**Publish**
+# run tests
+bun run tests
+
+# run src/dev.ts in watch mode
+bun run dev
+```
 
-See [Publish](#publish).
+**Publish** — see [Publish](#publish).
 
 # Documentation
 

package/template/package.json

@@ -30,7 +30,9 @@
     "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",
     "tests": "bun test",
     "build": "bun run build:lib && bun run build:lib-bundle",