npm - @temir.ra/create-test115 - Versions diffs - 0.0.25 → 0.0.27 - Mend

@temir.ra/create-test115 0.0.25 → 0.0.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/CHANGELOG.md +2 -47
package/README.md +97 -88
package/buildinfo.txt +1 -1
package/dist/cli.bundle.js +2 -2
package/dist/cli.bundle.js.map +3 -3
package/package.json +8 -2
package/template/AGENTS.md +1 -0
package/template/CLAUDE.md +73 -0
package/template/README.md +53 -3
package/template/package.json +6 -0
package/template/scripts/build-lib-bundle.ts +1 -1
package/template/src/dev.ts +1 -1
package/template/src/urls.ts +3 -3
package/template/tests/buildinfo.test.ts +1 -1
package/template/tsconfig.json +5 -6

package/CHANGELOG.md CHANGED Viewed

@@ -1,50 +1,5 @@
 # Version 0
-## next
+## 0.0.0
-1. Restructured the package files to comply with the "create-" template convention.
-## 0.3.0
-1. Updated `scripts/buildinfo.ts` to use `join` from `path` module for better cross-platform compatibility.
-2. Added `scripts/build-cdn.ts` to generate a bundled version of the library for CDN usage.
-3. Added `scripts/build-cdn-map.json` to configure import path rewrites for the CDN build.
-4. Cleaned up legacy fields `main`, `module`, and `types` from `package.json` to rely solely on the `exports` field for module resolution.
-5. Added `browser` condition to the `exports` field in `package.json` to specify the bundled version for CDN usage.
-6. Added `src/dev.ts` as a development entry point for testing and experimentation during development.
-7. Added QoL `clean` and `test` scripts to `package.json`.
-8. Updated `build` workflow in `package.json`. Now it runs `build:lib` to create JavaScript and declaration files, then runs `build:cdn` to create the bundled version for CDN, and finally runs `build:assets` as a placeholder for any future asset build steps.
-9. Added `description` metadata field to `package.json`.
-10. Updated `tsconfig.json` and `tsconfig.build.json` with opiniated settings for better development, build, and publishing experience.
-11. Added documentation for custom scripts and rationale for the selected values in `tsconfig.json`, `tsconfig.build.json`, and `package.json`.
-12. Updated Quick Start instructions to reflect the new scripts and workflow.
-13. Renamed `README.md` and `CHANGELOG.md` to `README.md.template` and `CHANGELOG.md.template` respectively, and added a `bun-create` configuration in `package.json` to rename them back during project creation.
-14. Added `gitignore` (note the missing dot) to the template to ensure that generated projects have a proper `.gitignore` file.
-## 0.2.0
-1. Added `tests/` directory for unit tests using Bun's built-in test runner.
-2. Updated `tsconfig.json` to include `tests/` in the `include` array to allow TypeScript to recognize test files during development, while still excluding them from the build output using `tsconfig.build.json`.
-3. Updated `tsconfig.build.json` to exclude `tests/` to ensure that test files are not included in the build output.
-4. Updated `tsconfig.json` to include `baseUrl` and `paths` for better module resolution and cleaner import statements in the source code.
-## 0.1.4
-1. Introduced `tsconfig.build.json` to separate build-specific TypeScript configuration from development configuration, allowing for more tailored settings for each use case.
-2. Updated scripts in `package.json` to utilize `tsconfig.build.json` for the build process, ensuring that the build is optimized and does not include unnecessary files or settings meant for development.
-## 0.1.3
-1. Added `--no-git` to `bun create` command in Quick Start instructions to allow users to choose when to initialize git repository.
-## 0.1.2
-1. Added `--no-install` to `bun create` command in Quick Start instructions to allow users to choose when to install dependencies.
-## 0.1.1
-1. Fixed github user in Quick Start instructions.
-## 0.1.0
-1. First version of the template.
+1. Versioning initialized.

package/README.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # Introduction
-This package serves as a template for creating Bun libraries. It includes a basic setup with TypeScript, build scripts, and versioning information.
+A template for TypeScript libraries distributed via npm-compatible registries. Provides TypeScript configuration, build tooling for ESM and bundled outputs, and build metadata generation.
 ## Table of Contents
@@ -11,9 +11,13 @@ This package serves as a template for creating Bun libraries. It includes a basi
     3. [Script `scripts/buildinfo.ts`](#script-scriptsbuildinfots)
     4. [Script `scripts/build-lib-bundle.ts`](#script-scriptsbuild-lib-bundlets)
     5. [CDN Map `scripts/cdn-rewrite-map.json`](#cdn-map-scriptscdn-rewrite-mapjson)
+    6. [`src/urls.ts`](#srcurlsts)
+    7. [`src/dev.ts`](#srcdevts)
+    8. [`CLAUDE.md` / `AGENTS.md`](#claudemd--agentsmd)
 3. [DevOps](#devops)
-    1. [Change Management](#change-management)
-    2. [Publish](#publish)
+    1. [Build](#build)
+    2. [Change Management](#change-management)
+    3. [Publish](#publish)
         1. [npmjs.org](#npmjsorg)
         2. [Custom registry](#custom-registry)
@@ -25,13 +29,7 @@ This package serves as a template for creating Bun libraries. It includes a basi
 bun create --no-install --no-git "@temir.ra/test115" <PACKAGE>
 cd <PACKAGE>
 bun install
-bun run build
-bun run test
-bun run dev
 ```
 # Documentation
@@ -43,33 +41,44 @@ bun run dev
   "compilerOptions": {
-    // supported JavaScript features and syntax in the emitted JavaScript files
-    // "ES2022" is a reasonable modern baseline
+    // ECMAScript version of emitted output
     "target": "ES2022",
-    // how import and export statements are written in the emitted JavaScript files
-    // "ESNext" emits standard ES module syntax unchanged
+    // output module format; ESNext passes ES module syntax through unchanged
     "module": "ESNext",
-    // available built-in types
+    // type definitions for built-in APIs
     "lib": [
       "ES2022", // standard JavaScript runtime APIs
-      "DOM"     // browser globals or `import.meta.url`
+      "DOM"     // browser globals for bundled output
     ],
-    // permissive about file extensions in import statements
-    // `tsconfig.build.json` switches to a stricter resolution mode
+    // module resolution strategy; bundler mode allows omitting file extensions in imports
+    // tsconfig.build.json overrides this to nodenext for strict ESM compliance
     "moduleResolution": "bundler",
-    // collection of type-safety checks
+    // enables all strict type-checking options
     "strict": true,
-    // compatibility shims that make it easier to import CommonJS modules as if they were ES modules
+    // enforces import type for type-only imports; emitted module syntax matches source exactly
+    "verbatimModuleSyntax": true,
+    // array indexing and index signature access returns T | undefined instead of T
+    "noUncheckedIndexedAccess": true,
+    // distinguishes absent optional properties from those explicitly set to undefined
+    "exactOptionalPropertyTypes": true,
+    // requires explicit override keyword when overriding base class methods
+    "noImplicitOverride": true,
+    // requires explicit types on all exported declarations; enables parallel .d.ts generation by external tools
+    "isolatedDeclarations": true,
+    // allows default imports from CommonJS modules
     "esModuleInterop": true,
-    // enables TypeScript project references
-    // required for `tsc --build` to work correctly across monorepo packages
-    // creates `*.tsbuildinfo` files that speed up subsequent builds by only rebuilding packages that have changed since the last build
+    // enables project references and incremental builds via *.tsbuildinfo
     "composite": true,
     // do not type-check `.d.ts` files in `node_modules/`
@@ -78,42 +87,26 @@ bun run dev
     // enforce consistent casing across import statements
     "forceConsistentCasingInFileNames": true,
-    // allow importing JSON files as modules and infer the full type of the JSON structure
+    // allows importing JSON files as typed modules
     "resolveJsonModule": true,
-    // generate .d.ts type declaration files alongside the JavaScript output
+    // emit .d.ts declaration files
     "declaration": true,
-    // allow a consumer's editor to "go to definition" on something from the library
+    // emit .d.ts.map files mapping declarations back to source
     "declarationMap": true,
-    // prevents tsc from emitting any JavaScript files
-    // during development, rely on executing environment to handle TypeScript directly
-    // during build, use `tsconfig.build.json` to override this setting and emit JavaScript files for distribution
+    // emit only .d.ts files, no JavaScript; overridden in tsconfig.build.json
     "emitDeclarationOnly": true,
-    // the directory where the emitted JavaScript and declaration files will be placed when building the library
+    // output directory for emitted files
     "outDir": "./dist",
-    // sets source root directory to mirror in the "outDir" when emitting files
-    // during development, it is set to the project root so that all files in the project are included in the editor features and type-checking
-    // during build, `tsconfig.build.json` narrows it down to only `src/`
+    // root directory mirrored into outDir; set to project root during development, overridden to src/ in tsconfig.build.json
     "rootDir": ".",
-    // the base directory to resolve non-relative module imports
-    "baseUrl": ".",
-    // a mapping of module import paths to physical paths in the project
-    // `paths` is a TypeScript-only feature - it must not be used in import statements in `src/` files
-    "paths": {
-      "@/*": [
-        "src/*"
-      ]
-    }
   },
-  // files to be included/excluded by the TypeScript compiler and the development environment
-  // `tsconfig.build.json` overrides these settings to include only `src/` files
+  // includes src/, tests/, and scripts/ for type-checking and IDE support; overridden in tsconfig.build.json
   "include": [
     "src/**/*.ts",
     "tests/**/*.ts",
@@ -128,9 +121,9 @@ bun run dev
 }
 ```
-During development, the `tsconfig.json` configuration prevents emitting JavaScript files and relies on the executing environment to handle TypeScript directly. The settings include `src/`, `tests/`, and `scripts/` for type-checking and editor features.
+`tsconfig.json` is the development configuration. `tsconfig.build.json` extends it, narrowing scope to `src/` and enabling JavaScript output for distribution.
-When building the library for distribution, the `tsconfig.build.json` configuration overrides the settings to emit JavaScript files while including only the `src/`.
+`declarationMap: true` enables go-to-definition for npm/bun consumers. For this to work, the original `.ts` source files must be accessible to the consumer. Consider adding `src/` to the `files` field in `package.json`.
 ```json
 {
@@ -139,11 +132,10 @@ When building the library for distribution, the `tsconfig.build.json` configurat
   "compilerOptions": {
-    // sets root directory to mirror in the "outDir" when emitting files
+    // narrows root to src/ for distribution output
     "rootDir": "./src",
-    // "nodenext" is the strictest and most forward-compatible ESM mode
-    // imports must include explicit `.js` file extensions
+    // nodenext enforces strict ESM compliance; imports must use explicit .js file extensions
     "module": "nodenext",
     "moduleResolution": "nodenext",
@@ -152,7 +144,6 @@ When building the library for distribution, the `tsconfig.build.json` configurat
   },
-  // include only the source files for the build, excluding tests and scripts
   "include": [
     "src/**/*.ts"
   ],
@@ -185,14 +176,18 @@ When building the library for distribution, the `tsconfig.build.json` configurat
     "url": ""
   },
-  // "module" makes every `.js` file in the package to be treated as an ES module unless explicitly named `.cjs`
+  // treats all .js files as ES modules; use .cjs extension for CommonJS files
   "type": "module",
-  // runtime consults "exports" to find the actual file to load
-  // "import" condition is used by ESM consumers
-  // "types" condition is used by TypeScript to find the declaration files
-  // "browser" condition is used by CDN infrastructure
-  // "entrypoint" is a custom condition used by the build script to find the entry point for the CDN build
+  // no module has side effects; enables full tree-shaking by bundlers
+  // set to an array of file paths if some modules do have side effects, e.g. ["./src/polyfill.ts"]
+  "sideEffects": false,
+  // package entry points by consumer type
+  // "entrypoint" — custom condition; used by the bundle script to locate the source entry point
+  // "browser"    — CDN consumers; resolves to the bundled output
+  // "import"     — ESM consumers; resolves to the compiled module output
+  // "types"      — TypeScript consumers; resolves to the declaration files
   "exports": {
     ".": {
       "entrypoint": "./src/index.ts",
@@ -202,7 +197,13 @@ When building the library for distribution, the `tsconfig.build.json` configurat
     }
   },
-  // specifies the entry point for the CLI executable exposed when the package is installed globally or as a dependency
+  // package-internal import aliases resolved natively by Node.js and Bun; keys must start with #
+  // use as: import { foo } from "#src/utils.js"
+  "imports": {
+    "#src/*": "./src/*"
+  },
+  // CLI entry point; omit if the package is not a CLI tool
   "bin": "./dist/cli.bundle.js",
   // files to include in the published package
@@ -214,30 +215,24 @@ When building the library for distribution, the `tsconfig.build.json` configurat
   "scripts": {
-    // cleans the `dist/` directory before building
     "clean": "rm -rf dist/",
-    // overwrites `src/buildinfo.ts` with the current version and git hash (if available)
+    // lifecycle hook; runs automatically before "build"; generates buildinfo.txt
     "prebuild": "bun run scripts/buildinfo.ts",
-    // runs all tests
     "test": "bun test",
-    // runs all build steps in sequence
     "build": "bun run build:lib && bun run build:lib-bundle",
-    // uses `tsconfig.build.json` to compile the TypeScript source files
     "build:lib": "tsc --project tsconfig.build.json",
-    // bundles the library for distribution in both ESM and IIFE formats
+    // bundles the library into ESM and IIFE formats for distribution
     "build:lib-bundle": "bun run scripts/build-lib-bundle.ts",
-    // builds the CLI (set by "bin" field) for distribution
     "build:cli-bundle": "bun build src/cli.ts --entry-naming \"[dir]/[name].bundle.[ext]\" --outdir dist --target node --format esm --minify --sourcemap=external",
-    // type checks the TypeScript source files without emitting any output
     "typecheck": "tsc --noEmit",
-    // runs the development file
+    // runs src/dev.ts in watch mode
     "dev": "bun run --watch src/dev.ts"
   },
@@ -250,21 +245,15 @@ When building the library for distribution, the `tsconfig.build.json` configurat
 ## Script `scripts/buildinfo.ts`
-This script overwrites `buildinfo.txt` with the current version from `package.json` and the current git hash (if available). The generated `buildinfo.txt` file is included in the published package and can be used for debugging and support purposes to quickly identify the exact version of the library being used, along with the corresponding source code in the repository.
+Generates `buildinfo.txt` containing the version from `package.json` and the git commit hash (if available). Included in the published package for build traceability.
 ## Script `scripts/build-lib-bundle.ts`
-This script bundles the library for distribution in both ESM and IIFE formats. It reads the `exports` field from `package.json` to determine the entry points for the library and generates bundled files. A custom condition `entrypoint` is used in the `exports` field to specify the entry point for the build.
-During the bundling process, the import specifiers in the source files can be rewritten to point to a CDN URL of a package, instead of using the package name that would be resolved from `node_modules/`.
-The list of import specifiers to rewrite and their corresponding CDN URLs can be configured in the `scripts/cdn-rewrite-map.json` file.
+Bundles the library to ESM and IIFE formats. Entry points are resolved from the `entrypoint` condition in the `exports` field of `package.json`. Import specifiers can be rewritten to CDN URLs via `scripts/cdn-rewrite-map.json`.
 ## CDN Map `scripts/cdn-rewrite-map.json`
-This JSON file contains a mapping of module import specifiers to their corresponding CDN URLs. During the CDN build process, if an import specifier in the source files matches a key in this map, it will be replaced with the corresponding CDN URL in the bundled output.
-The URL can contain the placeholder `<VERSION>` which will be replaced with the current version of a package from `package.json` that matches the import specifier.
+Maps import specifiers to CDN URLs. During bundling, matching specifiers in source files are rewritten to their CDN equivalents. `<VERSION>` in a URL is replaced with the version of the matching package from `package.json`.
 ```json
 {
@@ -272,14 +261,9 @@ The URL can contain the placeholder `<VERSION>` which will be replaced with the
 }
 ```
-- Keys are the import specifiers as they appear in source code.
-- Values are CDN URLs. The URL can contain the placeholder `<VERSION>` which will be replaced with the current version of a package from `package.json` that matches the import specifier.
 ## `"bin"` field in `package.json`
-The `"bin"` field in `package.json` specifies the entry point for the CLI executable exposed when the package is installed globally or as a dependency.
-If the package is intended to be used as a CLI tool, the `"bin"` field should point to the JavaScript file that serves as the entry point for the CLI. This file will be bundled during the build process (e.g. using `build:cli-bundle` script) and included in the published package.
+For CLI packages, add the following to `package.json`:
 ```json
 {
@@ -296,20 +280,45 @@ If the package is intended to be used as a CLI tool, the `"bin"` field should po
 }
 ```
+## `src/urls.ts`
+Resolves `CHANGELOG.md` and `buildinfo.txt` relative to `dist/` at runtime using `import.meta.url`. Provides stable references to published package assets regardless of install location.
+## `src/dev.ts`
+Development scratchpad — not published, excluded from `tsconfig.build.json`. Run with `bun run dev` in watch mode. Use it to manually test and explore library code during development.
+## `CLAUDE.md` / `AGENTS.md`
+AI assistant context files. Provide project layout, commands, and architecture notes. `AGENTS.md` references `CLAUDE.md`. The template ships two pairs:
+- Root pair — describes the template package itself (scaffolding tool, CLI, how `template/` maps to generated projects)
+- `template/` pair — describes the generated library project; update to reflect the specific library being developed
 # DevOps
+## Build
+`prebuild` runs automatically before `build`, generating `buildinfo.txt`.
+```bash
+bun run build      # compile via tsc + bundle to ESM, IIFE, and CLI
+```
 ## Change Management
 1. Create a new branch for the change.
-2. Make the changes and commit them to the branch.
-3. Add an entry for the new version in [`CHANGELOG-template.md`](CHANGELOG-template.md).
-4. Pull & publish request the branch.
+2. Make the changes and commit.
+3. Bump the version in [`package.json`](package.json).
+4. Add an entry for the new version in [`CHANGELOG.md`](CHANGELOG.md).
+5. Run `bun run build`.
+6. Pull request the branch and publish.
 ## Publish
 ### `npmjs.org`
-⚠️ Either run `npm login` or set up `~/.npmrc` or `bunfig.toml` with the appropriate auth token before running the publish command.
+⚠️ Authenticate first: run `npm login` or configure `~/.npmrc` or `bunfig.toml` with an auth token.
 ```powershell
 bun publish --registry https://registry.npmjs.org/ --access public

package/buildinfo.txt CHANGED Viewed

	@@ -1 +1 @@
1	- 0.0.25+~~721f42d~~
1	+ 0.0.27+3f30950

package/dist/cli.bundle.js CHANGED Viewed

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import{cpSync as o,readFileSync as f,renameSync as d,writeFileSync as u}from"fs";import{resolve as t,basename as U}from"path";import{fileURLToPath as a}from"url";var n=new URL(".",import.meta.url),l=new URL("../CHANGELOG.md",n),p=new URL("../buildinfo.txt",n),m=new URL("../template",n);try{let r=process.argv[2];if(!r)throw Error("Destination path is required. Usage: `bun/npm create <template> <destination>`");let e=t(process.cwd(),r),i=U(e),g=t(a(m));o(g,e,{recursive:!0}),o(t(a(l)),t(e,"CHANGELOG-template.md")),o(t(a(p)),t(e,"buildinfo-template.txt"));let s=t(e,"package.json"),c=JSON.parse(f(s,"utf-8"));c.name=i,u(s,JSON.stringify(c,null,2)),d(t(e,"gitignore"),t(e,".gitignore")),console.log(`Template has been successfully instantiated at '${e}' with package name '${i}'.`)}catch(r){let e=r instanceof Error?r:Error(String(r));console.error("Error:",e.message),process.exit(1)}
+import{cpSync as o,readFileSync as U,renameSync as f,writeFileSync as d}from"fs";import{resolve as t,basename as u}from"path";import{fileURLToPath as a}from"url";var n=new URL(".",import.meta.url),l=new URL("../CHANGELOG.md",n),p=new URL("../buildinfo.txt",n),m=new URL("../template",n);try{let r=process.argv[2];if(!r)throw Error("Destination path is required. Usage: `bun/npm create <template> <destination>`");let e=t(process.cwd(),r),i=u(e),g=t(a(m));o(g,e,{recursive:!0}),o(t(a(l)),t(e,"CHANGELOG-template.md")),o(t(a(p)),t(e,"buildinfo-template.txt"));let s=t(e,"package.json"),c=JSON.parse(U(s,"utf-8"));c.name=i,d(s,JSON.stringify(c,null,2)),f(t(e,"gitignore"),t(e,".gitignore")),console.log(`Template has been successfully instantiated at '${e}' with package name '${i}'.`)}catch(r){let e=r instanceof Error?r:Error(String(r));console.error("Error:",e.message),process.exit(1)}
-//# debugId=BED85076F5B77B3B64756E2164756E21
+//# debugId=683E20367A2ED95764756E2164756E21

package/dist/cli.bundle.js.map CHANGED Viewed

@@ -3,9 +3,9 @@
   "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",
-    "export const distUrl = new URL('.', import.meta.url);\r\nexport const changelogUrl = new URL('../CHANGELOG.md', distUrl);\r\nexport const buildinfoUrl = new URL('../buildinfo.txt', distUrl);\r\nexport const templateUrl = new URL('../template', distUrl);\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,EAAU,IAAI,IAAI,IAAK,YAAY,GAAG,EACtC,EAAe,IAAI,IAAI,kBAAmB,CAAO,EACjD,EAAe,IAAI,IAAI,mBAAoB,CAAO,EAClD,EAAc,IAAI,IAAI,cAAe,CAAO,EDKzD,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",
-  "debugId": "BED85076F5B77B3B64756E2164756E21",
+  "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",
+  "debugId": "683E20367A2ED95764756E2164756E21",
   "names": []
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@temir.ra/create-test115",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "Typescript library template",
   "author": "temir.ra",
   "license": "MIT",
@@ -15,14 +15,20 @@
     "url": ""
   },
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
-      "entrypoint": "./src/index.ts",
+      "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/*"
+  },
   "bin": "./dist/cli.bundle.js",
   "files": [
     "dist",

package/template/AGENTS.md ADDED Viewed

	@@ -0,0 +1 @@
1	+ See [CLAUDE.md](CLAUDE.md).

package/template/CLAUDE.md ADDED Viewed

@@ -0,0 +1,73 @@
+# <package-name>
+A Bun TypeScript library.
+## Project Layout
+```
+<package-name>/
+├── src/
+│   ├── index.ts        # Library entry point (public API)
+│   ├── dev.ts          # Development scratchpad — run with `bun run dev`
+│   └── urls.ts         # URL helpers (changelog, buildinfo)
+├── scripts/
+│   ├── buildinfo.ts            # Writes version + git hash to buildinfo.txt
+│   ├── build-lib-bundle.ts     # Bundles the library for ESM + CDN distribution
+│   └── cdn-rewrite-map.json    # CDN import rewrite rules (empty by default)
+├── tests/              # Unit tests (Bun test runner)
+├── dist/               # Build output (gitignored)
+├── buildinfo.txt       # Written during build; included in published package
+├── CHANGELOG.md        # Version history
+├── CLAUDE.md           # This file — AI context for the library project
+└── AGENTS.md           # References CLAUDE.md
+```
+## Commands
+```bash
+bun install       # Install dependencies
+bun run build     # Compile + bundle the library
+bun run test      # 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/
+```
+## TypeScript Configuration
+Two tsconfig files serve different purposes:
+| File | Purpose |
+|------|---------|
+| `tsconfig.json` | Development — no emit, includes `src/`, `tests/`, `scripts/` |
+| `tsconfig.build.json` | Build — emits JS + `.d.ts`, `src/` only (excludes `dev.ts`, tests, scripts) |
+`bun run build:lib` uses `tsconfig.build.json`. During development the runtime handles TypeScript directly so no compilation step is needed.
+Both configs enable an extended strict type-safety profile beyond `strict`: `verbatimModuleSyntax`, `noUncheckedIndexedAccess`, `exactOptionalPropertyTypes`, `noImplicitOverride`, `isolatedDeclarations`.
+## Build Outputs
+`bun run build` runs two steps in sequence:
+1. **`build:lib`** — `tsc --project tsconfig.build.json` → `dist/*.js` + `dist/*.d.ts`
+2. **`build:lib-bundle`** — `scripts/build-lib-bundle.ts` → `dist/index.bundle.js` (ESM, minified) + `dist/index.iife.js` (IIFE, minified)
+The `exports` field in `package.json` maps consumers to the right file:
+| Condition | File |
+|-----------|------|
+| `import` | `dist/index.js` |
+| `types` | `dist/index.d.ts` |
+| `browser` | `dist/index.bundle.js` |
+## Package Configuration
+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"`
+## Publishing
+See [README.md](README.md) for registry setup and publish commands.

package/template/README.md CHANGED Viewed

@@ -12,7 +12,25 @@
 # Quick Start
-*&lt;QUICK START INSTRUCTIONS&gt;*
+**Development**
+```bash
+bun run dev        # run src/dev.ts in watch mode
+bun test           # run tests
+bun run typecheck  # type-check without emitting
+```
+**Build**
+`prebuild` runs automatically before `build`, generating `buildinfo.txt`.
+```bash
+bun run build      # compile via tsc + bundle to ESM and IIFE
+```
+**Publish**
+See [Publish](#publish).
 # Documentation
@@ -23,7 +41,39 @@
 ## Change Management
 1. Create a new branch for the change.
-2. Make the changes and commit them to the branch.
+2. Make the changes and commit.
 3. Bump the version in [`package.json`](package.json).
 4. Add an entry for the new version in [`CHANGELOG.md`](CHANGELOG.md).
-5. Pull request the branch.
+5. Run `bun run build`.
+6. Pull request the branch and publish.
+## Publish
+### `npmjs.org`
+⚠️ Authenticate first: run `npm login` or configure `~/.npmrc` or `bunfig.toml` with an auth token.
+```powershell
+bun publish --registry https://registry.npmjs.org/ --access public
+```
+### Custom registry
+```bash
+# placeholder:
+    # <SCOPE_WITHOUT_AT: <SCOPE_WITHOUT_AT>
+    # <REGISTRY_URL: <REGISTRY_URL>
+    # <BUN_PUBLISH_AUTH_TOKEN: <BUN_PUBLISH_AUTH_TOKEN>
+```
+`bunfig.toml`:
+```toml
+[install.scopes]
+<SCOPE_WITHOUT_AT> = { url = "<REGISTRY_URL>", token = "$BUN_PUBLISH_AUTH_TOKEN" }
+```
+```powershell
+$env:BUN_PUBLISH_AUTH_TOKEN = "<BUN_PUBLISH_AUTH_TOKEN>"
+bun publish
+```

package/template/package.json CHANGED Viewed

@@ -12,6 +12,7 @@
     "url": ""
   },
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
       "entrypoint": "./src/index.ts",
@@ -20,6 +21,11 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "imports": {
+    "#src/*": "./src/*",
+    "#scripts/*": "./scripts/*",
+    "#tests/*": "./tests/*"
+  },
   "files": [
     "dist",
     "CHANGELOG.md",

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

@@ -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 '#scripts/cdn-rewrite-map.json';
 interface ExportConditions {

package/template/src/dev.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-const start = performance.now();
+const start: number = performance.now();
 // dev code

package/template/src/urls.ts CHANGED Viewed

@@ -1,3 +1,3 @@
-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 distUrl: URL = new URL('.', import.meta.url);
+export const changelogUrl: URL = new URL('../CHANGELOG.md', distUrl);
+export const buildinfoUrl: URL = new URL('../buildinfo.txt', distUrl);

package/template/tests/buildinfo.test.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import { describe, it, expect } from 'bun:test';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
-import { buildinfoUrl } from '@/urls';
+import { buildinfoUrl } from '#src/urls.js';
 describe('buildInfo', () => {

package/template/tsconfig.json CHANGED Viewed

@@ -8,6 +8,11 @@
     ],
     "moduleResolution": "bundler",
     "strict": true,
+    "verbatimModuleSyntax": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitOverride": true,
+    "isolatedDeclarations": true,
     "esModuleInterop": true,
     "composite": true,
     "skipLibCheck": true,
@@ -18,12 +23,6 @@
     "emitDeclarationOnly": true,
     "outDir": "./dist",
     "rootDir": ".",
-    "baseUrl": ".",
-    "paths": {
-      "@/*": [
-        "src/*"
-      ]
-    }
   },
   "include": [
     "src/**/*.ts",