@temir.ra/create-ts-lib 0.6.1 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Version 0
 
+## 0.7.0
+
+1. Updated `.gitignore`: added `bun.lock`, `buildinfo-template.txt`, `CHANGELOG-template.md`, `README-template.md`; replaced nested `template/.gitignore` with `template/gitignore` to prevent template files from being excluded during distribution.
+2. Removed `CLAUDE.md`, `AGENTS.md`, and `src/dev.ts` from root and template.
+3. Overhauled the generated `package.json`: added `private: false`; removed `sideEffects: false`; added build scripts to published `files`; updated `clean:tsbuildinfo` to `rm -f *.tsbuildinfo || true`; renamed `build:lib-bundle` to `build:bundle`; removed `build:lib` and `dev` scripts; added `reinstall` script; bumped typescript to `^6.0.2`.
+4. Updated the generated `tsconfig.json`: changed `target` to `ESNext`; removed `DOM` from `lib`; added `types: ["bun"]`.
+5. Removed generated `tsconfig.build.json`; TSC compilation is now opt-in and documented in `README.md`.
+6. Renamed `scripts/build-lib-bundle.ts` to `scripts/build-bundle.ts` in root and template; updated to produce ESM and IIFE browser bundles; added to published `files`; updated CDN rewrite plugin filter.
+7. Extracted path constants from `src/cli.ts` to `src/constants.ts`; CLI now copies `README.md` as `README-template.md` to generated projects; improved error message for missing package name argument; moved `template/src/dev.ts` to `template/scripts/dev.ts`.
+8. Updated `scripts/buildinfo.ts` in root and template: reads version from `package.json` instead of `npm_package_version` env var; handles pre-existing `+` in version string.
+9. Refactored `template/tests/buildinfo.test.ts` to use a proper semver regex.
+10. Overhauled `README.md`: new documentation structure with build strategies overview, `package.json` and `tsconfig.json` sections referencing `create-workspace`, opt-in TSC Compilation section, `bin` field documentation, `scripts/dev.ts` section; removed `CLAUDE.md`/`AGENTS.md` section.
+11. Updated from `@temir.ra/template@0.1.3` template.
+
+## 0.6.3
+
+1. Cleaned up dormant package scripts.
+2. Cleaned up minor `README.md` inconsistencies.
+
+## 0.6.2
+
+1. Updated `clean:tsbuildinfo` script to remove both `tsconfig.tsbuildinfo` and `tsconfig.build.tsbuildinfo`.
+
 ## 0.6.1
 
 1. Cleaned up dormant imports.

package/README.md

@@ -6,12 +6,15 @@ A template for TypeScript libraries distributed via npm-compatible registries. P
 
 1. [Quick Start](#quick-start)
 2. [Documentation](#documentation)
-    1. [`tsconfig.json` and `tsconfig.build.json`](#tsconfigjson-and-tsconfigbuildjson)
-    2. [`package.json`](#packagejson)
-    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. [`"bin"` field in `package.json`](#bin-field-in-packagejson)
+    1. [`package.json`](#packagejson)
+    2. [`"bin"` field in `package.json`](#bin-field-in-packagejson)
+    3. [`scripts/dev.ts`](#scriptsdevts)
+    4. [`tsconfig.json`](#tsconfigjson)
+    5. [TSC Compilation](#tsc-compilation)
+        1. [`tsconfig.build.json`](#tsconfigbuildjson)
+        2. [`package.json`](#packagejson-1)
+    6. [Script `scripts/build-bundle.ts`](#script-scriptsbuild-bundlets)
+        1. [CDN Map `scripts/cdn-rewrite-map.json`](#cdn-map-scriptscdn-rewrite-mapjson)
     7. [Asset Resolution](#asset-resolution)
         1. [Externalized - loaded from CDN or `node_modules/`](#externalized---loaded-from-cdn-or-node_modules)
         2. [Bundled - absorbed into the consumer's output](#bundled---absorbed-into-the-consumers-output)
@@ -20,108 +23,178 @@ A template for TypeScript libraries distributed via npm-compatible registries. P
             2. [Accessing assets](#accessing-assets)
             3. [README statement for library consumers](#readme-statement-for-library-consumers)
             4. [When the library is bundled by the consumer](#when-the-library-is-bundled-by-the-consumer)
-    8. [`src/dev.ts`](#srcdevts)
 3. [DevOps](#devops)
     1. [Change Management](#change-management)
     2. [Publish](#publish)
-        1. [npmjs.org](#npmjsorg)
-        2. [Custom registry](#custom-registry)
 
 # Quick Start
 
-*`bun create` caches the template package - a newer published version will not be picked up automatically. Pin the version or clear the cache to use the latest.*
-
 ```bash
 # placeholder:
+    # <TEMPLATE_PACKAGE: @temir.ra/create-ts-lib
+    # <TEMPLATE_NAME: @temir.ra/ts-lib
     # <NEW_PACKAGE: <NEW_PACKAGE>
+      # is used as:
+      #   - the path where the package is created
+      #   - the "name" field in the generated package.json
     # <@_VERSION: <@_VERSION>
 
-# identify the latest version of the template package as <@_VERSION.
+# pinned version
 bun info "@temir.ra/create-ts-lib" version
-# create a new library from the template version
 bun create --no-install --no-git "@temir.ra/ts-lib<@_VERSION>" <NEW_PACKAGE>
 
-# or
-
-# clear package manager cache to ensure the latest template version is used
+# latest
+# clear the cache to pick up the latest version
 bun pm cache rm
-# create a new library from the latest template version
 bun create --no-install --no-git "@temir.ra/ts-lib" <NEW_PACKAGE>
 
-# dependencies must be installed manually
+# templates only copy files, run install and any setup scripts manually
 cd <NEW_PACKAGE>
 bun install
 ```
 
 # Documentation
 
-The following sections explain the configurations and conventions baked into the generated package. Useful when adapting the generated package to fit a specific library's needs.
+The following sections explain the configurations and conventions baked into the generated package. Useful when adapting it to fit specific needs.
+
+The central addition over [`create-workspace`](https://www.npmjs.com/package/@temir.ra/create-workspace) is a build pipeline for distributing the library. Two build strategies are supported:
+
+- **Bundling** (`scripts/build-bundle.ts`) - generated by default; bundles the library to ESM and IIFE formats.
+- **TSC compilation** (`tsconfig.build.json` + `build:tsc`) - optional, not generated by default; compiles source files one-for-one to ESM JavaScript and declaration files.
+
+Both strategies can be combined.
+
+## `package.json`
+
+Selected fields are documented in the [`create-workspace` README](https://www.npmjs.com/package/@temir.ra/create-workspace#packagejson).
+
+See npmjs documentation on [package.json](https://docs.npmjs.com/cli/v11/configuring-npm/package-json) for detailed explanations of all fields.
 
-## `tsconfig.json` and `tsconfig.build.json`
+The following lists the additions and overrides relative to [`create-workspace`](https://www.npmjs.com/package/@temir.ra/create-workspace#packagejson).
 
-See the typescriptlang documentation on [tsconfig.json](https://www.typescriptlang.org/tsconfig) for detailed explanations of all options.
+The generated package is pre-configured with `build:bundle` only. See [TSC Compilation](#tsc-compilation) and [`"bin"` field](#bin-field-in-packagejson) for extending it.
 
 ```json
 {
 
-  "compilerOptions": {
+  // ... ,
+
+  // the package is anticipated to be published
+  "private": false,
+
+  // treats all .js files as ES modules; use .cjs extension for CommonJS files
+  "type": "module",
+
+  // package entry points
+  // 
+  // scripts/build-bundle.ts (non-standard) export condition:
+  // "entrypoint" - locates the source entry point for bundling
+  // 
+  // standard export conditions:
+  // "types"      - TypeScript consumers; resolves to the declaration files;
+  // "browser"    - browser bundler consumers; resolves to the bundled output
+  // "import"     - ESM consumers; resolves to the compiled module output
+  "exports": {
+    ".": {
+      "entrypoint": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.bundle.js",
+      "import": "./dist/index.js"
+    }
+  },
+
+  // convenience alias for source-execution only - does NOT survive transpilation or bundling
+  // NOT for use in source files compiled by tsconfig.build.json
+  // the .js extension is required in import statements (nodenext compliance)
+  "imports": {
+    "#src/*.js": "./src/*.ts"
+  },
+
+  // CLI entry point
+  "bin": "./dist/cli.bundle.js",
+
+  // files to include in the published package
+  "files": [
+    "scripts/buildinfo.ts",
+    "scripts/build-bundle.ts",
+    "scripts/cdn-rewrite-map.json",
+    "dist",
+    "CHANGELOG.md",
+    "buildinfo.txt"
+  ],
+
+  "scripts": {
+
+    // ... ,
+
+    // executed before build; generates buildinfo.txt
+    "prebuild": "bun run buildinfo",
+
+    // convenience script to run the build steps in sequence
+    "build": "bun run build:tsc && bun run build:bundle && bun run build:cli-bundle",
+
+    // compiles the library to declaration files and ESM JavaScript in dist/
+    "build:tsc": "tsc --project tsconfig.build.json",
 
-    // ECMAScript version of emitted output; ESNext targets the latest JS version supported by the TypeScript compiler
-    // if the package must support older runtimes or browsers, pin to a specific year (e.g. "ES2022", "ES2024")
-    "target": "ESNext",
+    // bundles the library into ESM and IIFE formats for distribution
+    "build:bundle": "bun run scripts/build-bundle.ts",
+
+    // bundles the CLI into a single file for distribution; requires the "bin" field to be set to the bundled output
+    "build:cli-bundle": "bun build src/cli.ts --entry-naming \"[dir]/[name].bundle.[ext]\" --outdir dist --target node --format esm --minify --sourcemap=external"
 
-    // output module format; ESNext passes ES module syntax through unchanged
-    // ES module syntax: import/export statements (as opposed to CommonJS require()/module.exports)
-    "module": "ESNext",
+  }
 
-    // type definitions for built-in APIs
-    "lib": [
-      "ESNext", // standard JavaScript runtime APIs
-      "DOM"     // browser globals for bundled output
-    ],
+}
+```
+
+## `"bin"` field in `package.json`
+
+For CLI packages, add the following to `package.json`:
 
-    // module resolution strategy; bundler mode allows omitting file extensions in imports
-    // tsconfig.build.json overrides this to nodenext for strict ESM compliance
-    "moduleResolution": "bundler",
+```json
+{
+  // ... ,
+  "bin": "./dist/cli.bundle.js",
+  // ... ,
+  "scripts": {
+    // ... ,
+    "build": "... && bun run build:cli-bundle",
+    // ... ,
+    "build:cli-bundle": "bun build src/cli.ts --entry-naming \"[dir]/[name].bundle.[ext]\" --outdir dist --target node --format esm --minify --sourcemap=external"
+  }
+}
+```
 
-    // enables all strict type-checking options
-    "strict": true,
+`src/cli.ts` must begin with a hashbang so the OS knows which interpreter to invoke when the binary is executed directly. Bun preserves it in the bundled output.
 
-    // enforces import type for type-only imports; emitted module syntax matches source exactly
-    "verbatimModuleSyntax": true,
+```typescript
+#!/usr/bin/env node
+```
 
-    // array indexing and index signature access returns T | undefined instead of T
-    "noUncheckedIndexedAccess": true,
+If the package exports a CLI only and is not intended to be imported in other packages, the `exports` field can be omitted.
 
-    // distinguishes absent optional properties from those explicitly set to undefined
-    "exactOptionalPropertyTypes": true,
+## `scripts/dev.ts`
 
-    // requires explicit override keyword when overriding base class methods
-    "noImplicitOverride": true,
+Development scratchpad. Execute it manually with `bun run --watch scripts/dev.ts`. Useful to test and explore library code during development.
 
-    // requires explicit types on all exported declarations; enables parallel .d.ts generation by external tools
-    "isolatedDeclarations": true,
+## `tsconfig.json`
 
-    // allows default imports from CommonJS modules
-    "esModuleInterop": true,
+Selected fields are documented in the [`create-workspace` README](https://www.npmjs.com/package/@temir.ra/create-workspace#tsconfigjson).
 
-    // enables project references and incremental builds via *.tsbuildinfo
-    "composite": true,
+See the TypeScript documentation on [tsconfig.json](https://www.typescriptlang.org/tsconfig) for detailed explanations of all options.
 
-    // do not type-check `.d.ts` files in `node_modules/`
-    "skipLibCheck": true,
+The following lists the additions and overrides relative to [`create-workspace`](https://www.npmjs.com/package/@temir.ra/create-workspace#tsconfigjson).
 
-    // TS6 defaults types to [] — @types/* packages must be listed explicitly
-    "types": ["bun"],
+```json
+{
 
-    // enforce consistent casing across import statements
-    "forceConsistentCasingInFileNames": true,
+  "compilerOptions": {
 
-    // allows importing JSON files as typed modules
-    "resolveJsonModule": true,
+    // ... ,
 
     // emit .d.ts declaration files
     "declaration": true,
+
     // emit .d.ts.map files mapping declarations back to source
     "declarationMap": true,
 
@@ -129,32 +202,40 @@ See the typescriptlang documentation on [tsconfig.json](https://www.typescriptla
     "emitDeclarationOnly": true,
 
     // output directory for emitted files
-    "outDir": "./dist",
-
-    // root directory mirrored into outDir; set to project root during development, overridden to src/ in tsconfig.build.json (TS6 default — not set in actual config)
-    "rootDir": ".",
+    "outDir": "./dist"
 
   },
 
-  // includes src/, tests/, and scripts/ for type-checking and IDE support; overridden in tsconfig.build.json
   "include": [
-    "src/**/*.ts",
-    "tests/**/*.ts",
-    "scripts/**/*.ts",
-    "scripts/**/*.json"
+    // ... ,
+    // include `scripts/**/*.json` for script configuration files
+    "scripts/**/*.json",
+    // include `src/**/*.ts` for source files
+    "src/**/*.ts"
   ],
   "exclude": [
-    "node_modules",
+    // ... ,
+    // exclude `dist/`
     "dist"
   ]
 
 }
 ```
 
-`tsconfig.json` is the development configuration. `tsconfig.build.json` extends it, narrowing scope to `src/` and enabling JavaScript output for distribution.
-
 `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`.
 
+## TSC Compilation
+
+Not generated by default. Enables file-for-file tsc compilation of `src/` to ESM JavaScript and declaration files alongside bundling.
+
+### `tsconfig.build.json`
+
+Extends `tsconfig.json`, narrowing scope to `src/` only and switching to `nodenext` module resolution for strict ESM compliance.
+
+Enables JavaScript output alongside declaration files for distribution.
+
+Development files (`dev.ts`, `tests/`, `scripts/`) are excluded.
+
 ```json
 {
 
@@ -174,11 +255,12 @@ See the typescriptlang documentation on [tsconfig.json](https://www.typescriptla
 
   },
 
+  // include only src/ files for distribution
   "include": [
     "src/**/*.ts"
   ],
+  // exclude development files and directories from distribution
   "exclude": [
-    "src/dev.ts",
     "node_modules",
     "dist",
     "tests",
@@ -188,102 +270,30 @@ See the typescriptlang documentation on [tsconfig.json](https://www.typescriptla
 }
 ```
 
-## `package.json`
-
-See npmjs documentation on [package.json](https://docs.npmjs.com/cli/v11/configuring-npm/package-json) for detailed explanations of all fields.
+### `package.json`
 
 ```json
 {
-  "name": "",
-  "version": "0.0.0",
-
-  "description": "",
-  "author": "",
-  "license": "",
-
-  "keywords": ["typescript"],
-
-  "repository": {
-    "type": "git",
-    "url": ""
-  },
-
-  // treats all .js files as ES modules; use .cjs extension for CommonJS files
-  "type": "module",
-
-  // package entry points by consumer type
-  // "entrypoint" - custom condition; used by the bundle script to locate the source entry point
-  // "types"      - TypeScript consumers; resolves to the declaration files; must precede "import" so TypeScript matches it before the JS condition
-  // "browser"    - browser bundler consumers; resolves to the bundled output
-  // "import"     - ESM consumers; resolves to the compiled module output
-  "exports": {
-    ".": {
-      "entrypoint": "./src/index.ts",
-      "types": "./dist/index.d.ts",
-      "browser": "./dist/index.bundle.js",
-      "import": "./dist/index.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/*.js": "./src/*.ts"
-  },
-
-  // CLI entry point; omit if the package is not a CLI tool
-  "bin": "./dist/cli.bundle.js",
-
-  // files to include in the published package
-  "files": [
-    "dist",
-    "CHANGELOG.md",
-    "buildinfo.txt"
-  ],
-
+  // ... ,
   "scripts": {
-
-    "clean:dist": "rm -rf dist/",
-    "clean:tsbuildinfo": "rm -f tsconfig.tsbuildinfo 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",
-
-    "tests": "bun test",
-
-    "build": "bun run build:lib && bun run build:lib-bundle",
-
-    "build:lib": "tsc --project tsconfig.build.json",
-    // bundles the library into ESM and IIFE formats for distribution
-    "build:lib-bundle": "bun run scripts/build-lib-bundle.ts",
-
-    "typecheck": "tsc --noEmit",
-
-    // runs src/dev.ts in watch mode
-    "dev": "bun run --watch src/dev.ts"
-
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^6.0.2"
+    // ... ,
+    "build": "bun run build:tsc && bun run build:bundle",
+    "build:tsc": "tsc --project tsconfig.build.json"
   }
 }
 ```
 
-## Script `scripts/buildinfo.ts`
+## Script `scripts/build-bundle.ts`
 
-Generates `buildinfo.txt` containing the version from `package.json` and the git commit hash (if available). Included in the published package for build traceability.
+Bundles the library to ESM and IIFE formats. Entry points are resolved from the `entrypoint` condition in the `exports` field of `package.json`. Note, the `entrypoint` condition is a custom, non-standard export condition used solely for build tooling.
 
-## Script `scripts/build-lib-bundle.ts`
+Import specifiers can be rewritten to CDN URLs via `scripts/cdn-rewrite-map.json`.
 
-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`
 
-## CDN Map `scripts/cdn-rewrite-map.json`
+Maps import specifiers to CDN URLs. During bundling, matching specifiers in source files are rewritten to their CDN equivalents.
 
-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`.
+`<VERSION>` in a URL is replaced with the version of the matching package from `package.json`.
 
 ```json
 {
@@ -291,25 +301,6 @@ Maps import specifiers to CDN URLs. During bundling, matching specifiers in sour
 }
 ```
 
-## `"bin"` field in `package.json`
-
-For CLI packages, add the following to `package.json`:
-
-```json
-{
-  "exports": ...,
-  "bin": "./dist/cli.bundle.js",
-  "files": ...,
-  "scripts": {
-    ...,
-    "build": "... && bun run build:cli-bundle",
-    ...,
-    "build:cli-bundle": "bun build src/cli.ts --entry-naming \"[dir]/[name].bundle.[ext]\" --outdir dist --target node --format esm --minify --sourcemap=external",
-    ...,
-  }
-}
-```
-
 ## Asset Resolution
 
 The key question to ask is: **does my library retain its own URL at runtime?** Everything else follows from it.
@@ -395,7 +386,7 @@ import { fileURLToPath } from 'url';
 const asset = JSON.parse(await readFile(fileURLToPath(new URL('<ASSET>', assetsUrl)), 'utf-8'));
 ```
 
-### README statement for library consumers
+#### README statement for library consumers
 
 ```markdown
 ## Asset resolution
@@ -418,27 +409,18 @@ consumer output/
 
 From the bundle's perspective `assets/<@SCOPE>/<LIB_NAME>/` is at the same directory level as `bundle.js`, so `new URL('assets/<@SCOPE>/<LIB_NAME>/...', import.meta.url)` resolves correctly. No code configuration is needed - only the file copy.
 
-## `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.
-
 # DevOps
 
 ```bash
-# remove dist/ and tsconfig.tsbuildinfo and tsconfig.build.tsbuildinfo
-bun run clean
-
-# remove dist/ only
-bun run clean:dist
-
-# remove tsconfig.tsbuildinfo and tsconfig.build.tsbuildinfo only
-bun run clean:tsbuildinfo
+bun install
 
-# compile + bundle
+bun run clean
 bun run build
+bun run tests
+
+bun run dev
 
-# create a new test library in example/
-bun run dist/cli.bundle.js -- example
+# see publish section for publish instructions
 ```
 
 ## Change Management
@@ -448,7 +430,7 @@ bun run dist/cli.bundle.js -- example
 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.
-6. After merge, run `bun run build` - ensures artifacts are current before publish.
+6. Ensure package artifacts are current.
 7. Publish.
 
 ## Publish

package/buildinfo.txt

@@ -1 +1 @@
-0.6.1+f14d02f
+0.7.0+b45e7d0

package/dist/cli.bundle.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import{cpSync as s,readFileSync as f,renameSync as u,writeFileSync as P}from"fs";import{resolve as t}from"path";import{resolve as o}from"path";import{fileURLToPath as h}from"url";var d=new URL("../",import.meta.url),n=o(h(d)),m=o(n,"template/"),p=o(n,"CHANGELOG.md"),g=o(n,"buildinfo.txt"),l=o(n,"README.md");try{let r=process.argv[2];if(!r)throw Error("Package name argument is required. Usage: `create-ts-lib <package-name>`");let a=r.replace(/\\/g,"/"),e=t(process.cwd(),a);s(m,e,{recursive:!0}),s(p,t(e,"CHANGELOG-template.md")),s(g,t(e,"buildinfo-template.txt")),s(l,t(e,"README-template.md"));let c=t(e,"package.json"),i=JSON.parse(f(c,"utf-8"));i.name=a,P(c,JSON.stringify(i,null,2)),u(t(e,"gitignore"),t(e,".gitignore")),console.log(`Template has been successfully instantiated at '${e}' with package name '${a}'.`)}catch(r){let a=r instanceof Error?r:Error(String(r));console.error("Error:",a.message),process.exit(1)}
+import{cpSync as s,readFileSync as f,renameSync as u,writeFileSync as P}from"fs";import{resolve as t}from"path";import{resolve as o}from"path";import{fileURLToPath as h}from"url";var d=new URL("../",import.meta.url),n=o(h(d)),m=o(n,"template/"),p=o(n,"CHANGELOG.md"),g=o(n,"buildinfo.txt"),l=o(n,"README.md");try{let r=process.argv[2];if(!r)throw Error('First argument must be the package name (e.g. "my-package" or "@my-scope/my-package").');let a=r.replace(/\\/g,"/"),e=t(process.cwd(),a);s(m,e,{recursive:!0}),s(p,t(e,"CHANGELOG-template.md")),s(g,t(e,"buildinfo-template.txt")),s(l,t(e,"README-template.md"));let c=t(e,"package.json"),i=JSON.parse(f(c,"utf-8"));i.name=a,P(c,JSON.stringify(i,null,2)),u(t(e,"gitignore"),t(e,".gitignore")),console.log(`Template has been successfully instantiated at '${e}' with package name '${a}'.`)}catch(r){let a=r instanceof Error?r:Error(String(r));console.error("Error:",a.message),process.exit(1)}
 
-//# debugId=05227D46E6CAAF7464756E2164756E21
+//# debugId=C4A0E6EEF1219B4364756E2164756E21

package/dist/cli.bundle.js.map

@@ -2,10 +2,10 @@
   "version": 3,
   "sources": ["..\\src\\cli.ts", "..\\src\\constants.ts"],
   "sourcesContent": [
-    "#!/usr/bin/env node\r\n\r\nimport { cpSync, readFileSync, renameSync, writeFileSync } from 'fs';\r\nimport { resolve } from 'path';\r\nimport {\r\n    templatePath,\r\n    changelogPath,\r\n    buildinfoPath,\r\n    readmePath\r\n} from './constants.js';\r\n\r\n\r\ntry {\r\n\r\n    const packageNameArgument = process.argv[2];\r\n    if (!packageNameArgument) throw new Error('Package name argument is required. Usage: `create-ts-lib <package-name>`');\r\n    const packageName = packageNameArgument.replace(/\\\\/g, '/');\r\n\r\n    const destinationPath = resolve(process.cwd(), packageName);\r\n\r\n    cpSync(templatePath, destinationPath, { recursive: true });\r\n    cpSync(changelogPath, resolve(destinationPath, 'CHANGELOG-template.md'));\r\n    cpSync(buildinfoPath, resolve(destinationPath, 'buildinfo-template.txt'));\r\n    cpSync(readmePath, resolve(destinationPath, 'README-template.md'));\r\n\r\n    const packageJsonPath = resolve(destinationPath, 'package.json');\r\n    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));\r\n    packageJson.name = packageName;\r\n    writeFileSync(packageJsonPath, JSON.stringify(packageJson, 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 } from 'path';\r\nimport {\r\n    templatePath,\r\n    changelogPath,\r\n    buildinfoPath,\r\n    readmePath\r\n} from './constants.js';\r\n\r\n\r\ntry {\r\n\r\n    const packageNameArgument = process.argv[2];\r\n    if (!packageNameArgument)\r\n        throw new Error('First argument must be the package name (e.g. \"my-package\" or \"@my-scope/my-package\").');\r\n    const packageName = packageNameArgument.replace(/\\\\/g, '/');\r\n\r\n    const destinationPath = resolve(process.cwd(), packageName);\r\n\r\n    cpSync(templatePath, destinationPath, { recursive: true });\r\n    cpSync(changelogPath, resolve(destinationPath, 'CHANGELOG-template.md'));\r\n    cpSync(buildinfoPath, resolve(destinationPath, 'buildinfo-template.txt'));\r\n    cpSync(readmePath, resolve(destinationPath, 'README-template.md'));\r\n\r\n    const packageJsonPath = resolve(destinationPath, 'package.json');\r\n    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));\r\n    packageJson.name = packageName;\r\n    writeFileSync(packageJsonPath, JSON.stringify(packageJson, 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",
     "import { resolve } from 'path';\r\nimport { fileURLToPath } from 'url';\r\n\r\n\r\nexport const packageUrl: URL = new URL('../', import.meta.url);\r\nexport const packagePath: string = resolve(fileURLToPath(packageUrl));\r\n\r\nexport const templatePath: string = resolve(packagePath, 'template/');\r\n\r\nexport const changelogPath: string = resolve(packagePath, 'CHANGELOG.md');\r\nexport const buildinfoPath: string = resolve(packagePath, 'buildinfo.txt');\r\nexport const readmePath: string = resolve(packagePath, 'README.md');\r\n"
   ],
-  "mappings": ";AAEA,iBAAS,kBAAQ,gBAAc,mBAAY,WAC3C,kBAAS,aCHT,kBAAS,aACT,wBAAS,YAGF,IAAM,EAAkB,IAAI,IAAI,MAAO,YAAY,GAAG,EAChD,EAAsB,EAAQ,EAAc,CAAU,CAAC,EAEvD,EAAuB,EAAQ,EAAa,WAAW,EAEvD,EAAwB,EAAQ,EAAa,cAAc,EAC3D,EAAwB,EAAQ,EAAa,eAAe,EAC5D,EAAqB,EAAQ,EAAa,WAAW,EDClE,GAAI,CAEA,IAAM,EAAsB,QAAQ,KAAK,GACzC,GAAI,CAAC,EAAqB,MAAU,MAAM,0EAA0E,EACpH,IAAM,EAAc,EAAoB,QAAQ,MAAO,GAAG,EAEpD,EAAkB,EAAQ,QAAQ,IAAI,EAAG,CAAW,EAE1D,EAAO,EAAc,EAAiB,CAAE,UAAW,EAAK,CAAC,EACzD,EAAO,EAAe,EAAQ,EAAiB,uBAAuB,CAAC,EACvE,EAAO,EAAe,EAAQ,EAAiB,wBAAwB,CAAC,EACxE,EAAO,EAAY,EAAQ,EAAiB,oBAAoB,CAAC,EAEjE,IAAM,EAAkB,EAAQ,EAAiB,cAAc,EACzD,EAAc,KAAK,MAAM,EAAa,EAAiB,OAAO,CAAC,EACrE,EAAY,KAAO,EACnB,EAAc,EAAiB,KAAK,UAAU,EAAa,KAAM,CAAC,CAAC,EAEnE,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": "05227D46E6CAAF7464756E2164756E21",
+  "mappings": ";AAEA,iBAAS,kBAAQ,gBAAc,mBAAY,WAC3C,kBAAS,aCHT,kBAAS,aACT,wBAAS,YAGF,IAAM,EAAkB,IAAI,IAAI,MAAO,YAAY,GAAG,EAChD,EAAsB,EAAQ,EAAc,CAAU,CAAC,EAEvD,EAAuB,EAAQ,EAAa,WAAW,EAEvD,EAAwB,EAAQ,EAAa,cAAc,EAC3D,EAAwB,EAAQ,EAAa,eAAe,EAC5D,EAAqB,EAAQ,EAAa,WAAW,EDClE,GAAI,CAEA,IAAM,EAAsB,QAAQ,KAAK,GACzC,GAAI,CAAC,EACD,MAAU,MAAM,wFAAwF,EAC5G,IAAM,EAAc,EAAoB,QAAQ,MAAO,GAAG,EAEpD,EAAkB,EAAQ,QAAQ,IAAI,EAAG,CAAW,EAE1D,EAAO,EAAc,EAAiB,CAAE,UAAW,EAAK,CAAC,EACzD,EAAO,EAAe,EAAQ,EAAiB,uBAAuB,CAAC,EACvE,EAAO,EAAe,EAAQ,EAAiB,wBAAwB,CAAC,EACxE,EAAO,EAAY,EAAQ,EAAiB,oBAAoB,CAAC,EAEjE,IAAM,EAAkB,EAAQ,EAAiB,cAAc,EACzD,EAAc,KAAK,MAAM,EAAa,EAAiB,OAAO,CAAC,EACrE,EAAY,KAAO,EACnB,EAAc,EAAiB,KAAK,UAAU,EAAa,KAAM,CAAC,CAAC,EAEnE,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": "C4A0E6EEF1219B4364756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temir.ra/create-ts-lib",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Typescript library template",
   "author": "temir.ra",
   "license": "MIT",
@@ -14,12 +14,16 @@
     "type": "git",
     "url": "https://git.chimps.quest/trs/create-ts-lib.git"
   },
+  "private": false,
   "type": "module",
   "imports": {
     "#src/*.js": "./src/*.ts"
   },
   "bin": "./dist/cli.bundle.js",
   "files": [
+    "scripts/buildinfo.ts",
+    "scripts/build-bundle.ts",
+    "scripts/cdn-rewrite-map.json",
     "dist",
     "CHANGELOG.md",
     "buildinfo.txt",
@@ -27,15 +31,15 @@
   ],
   "scripts": {
     "clean:dist": "rm -rf dist/",
-    "clean:tsbuildinfo": "rm -f tsconfig.build.tsbuildinfo",
+    "clean:tsbuildinfo": "rm -f *.tsbuildinfo || true",
     "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
-    "prebuild": "bun run scripts/buildinfo.ts",
+    "buildinfo": "bun run scripts/buildinfo.ts",
     "tests": "bun test",
-    "build": "bun run build:lib && bun run build:cli-bundle",
-    "build:lib": "tsc --project tsconfig.build.json",
-    "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"
+    "reinstall": "rm -rf node_modules && rm -f bun.lock && bun pm cache rm && bun install && bunx tsc --version",
+    "prebuild": "bun run buildinfo",
+    "build": "bun run build:cli-bundle",
+    "build:cli-bundle": "bun build src/cli.ts --entry-naming \"[dir]/[name].bundle.[ext]\" --outdir dist --target node --format esm --minify --sourcemap=external"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/{template/scripts/build-lib-bundle.ts → scripts/build-bundle.ts}

@@ -1,14 +1,15 @@
 import { readFileSync } from 'fs';
 import { join } from 'path';
+
 import CDN_REWRITE_MAP from './cdn-rewrite-map.json';
 
 
 interface ExportConditions {
     [key: string]: string | undefined;
-    import?: string;
+    entrypoint?: string;
     types?: string;
     browser?: string;
-    entrypoint?: string;
+    import?: string;
 }
 
 interface DependencyMap {
@@ -34,9 +35,9 @@ function getManifest(packageIdentifier?: string): PackageManifest {
         manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
     } catch {
         if (packageIdentifier)
-            throw new Error("[scripts/build-lib-bundle.ts] Could not read manifest for '" + packageIdentifier + "' at '" + manifestPath + "'. Is it installed?");
+            throw new Error(`[scripts/build-bundle.ts] Could not read manifest for '${packageIdentifier}' at '${manifestPath}'.`);
         else
-            throw new Error("[scripts/build-lib-bundle.ts] Could not read package manifest at '" + manifestPath + "'.");
+            throw new Error(`[scripts/build-bundle.ts] Could not read package manifest at '${manifestPath}'.`);
     }
 
     return manifest;
@@ -46,11 +47,13 @@ function getManifest(packageIdentifier?: string): PackageManifest {
 function getManifestEntrypoints(packageManifest: PackageManifest): string[] {
 
     const exports = packageManifest.exports;
-    if (!exports) throw new Error('[scripts/build-lib-bundle.ts] No exports field found in package.json.');
+    if (!exports)
+        throw new Error(`[scripts/build-bundle.ts] No 'exports' field found in the given package manifest.`);
 
     const entrypoints = Object.entries(exports)
         .map(([key, conditions]) => {
-            if (!conditions.entrypoint) throw new Error(`[scripts/build-lib-bundle.ts] Export '${key}' does not have an 'entrypoint' condition.`);
+            if (!conditions.entrypoint)
+                throw new Error(`[scripts/build-bundle.ts] Export '${key}' does not have an 'entrypoint' condition.`);
             return conditions.entrypoint;
         });
 
@@ -70,11 +73,13 @@ function getPackageVersion(manifest: PackageManifest, packageIdentifier?: string
         };
 
         version = dependencies[packageIdentifier];
-        if (!version) throw new Error(`[scripts/build-lib-bundle.ts] Package '${packageIdentifier}' is not listed in dependencies.`);
+        if (!version)
+            throw new Error(`[scripts/build-bundle.ts] Package '${packageIdentifier}' is not listed in dependencies.`);
 
     }
     else {
-        if (!manifest.version) throw new Error('[scripts/build-lib-bundle.ts] Package manifest does not contain a version field.');
+        if (!manifest.version)
+            throw new Error('[scripts/build-bundle.ts] Package manifest does not contain a version field.');
         version = manifest.version;
     }
 
@@ -109,11 +114,11 @@ const cdnRewritePlugin = {
 
 
 const entrypoints = getManifestEntrypoints(getManifest());
-console.log('[scripts/build-lib-bundle.ts] Entrypoints:', entrypoints);
+console.log('[scripts/build-bundle.ts] Entrypoints:', entrypoints);
 
 let buildResult;
 
-console.log('[scripts/build-lib-bundle.ts] Starting ESM bundle build...');
+console.log('[scripts/build-bundle.ts] Starting ESM bundle build...');
 buildResult = await Bun.build({
     entrypoints,
     outdir: 'dist',
@@ -126,15 +131,15 @@ buildResult = await Bun.build({
 });
 
 if (!buildResult.success) {
-    console.error('[scripts/build-lib-bundle.ts] Build failed:');
+    console.error('[scripts/build-bundle.ts] Build failed:');
     for (const message of buildResult.logs) {
         console.error(message);
     }
     process.exit(1);
 }
-console.log('[scripts/build-lib-bundle.ts] ESM bundle build completed successfully.');
+console.log('[scripts/build-bundle.ts] ESM bundle build completed successfully.');
 
-console.log('[scripts/build-lib-bundle.ts] Starting IIFE bundle build...');
+console.log('[scripts/build-bundle.ts] Starting IIFE bundle build...');
 buildResult = await Bun.build({
     entrypoints,
     outdir: 'dist',
@@ -147,10 +152,10 @@ buildResult = await Bun.build({
 });
 
 if (!buildResult.success) {
-    console.error('[scripts/build-lib-bundle.ts] Build failed:');
+    console.error('[scripts/build-bundle.ts] Build failed:');
     for (const message of buildResult.logs) {
         console.error(message);
     }
     process.exit(1);
 }
-console.log('[scripts/build-lib-bundle.ts] IIFE bundle build completed successfully.');
+console.log('[scripts/build-bundle.ts] IIFE bundle build completed successfully.');

package/scripts/buildinfo.ts

@@ -0,0 +1,25 @@
+import { execSync } from 'child_process';
+import { readFileSync, writeFileSync } from 'fs';
+
+
+const BUILD_INFO_FILE = 'buildinfo.txt';
+const GIT_COMMAND = 'git rev-parse --short HEAD';
+
+const version: string = JSON.parse(readFileSync('package.json', 'utf-8')).version;
+
+let gitHash = '';
+try {
+    gitHash = execSync(GIT_COMMAND, { stdio: ['ignore', 'pipe', 'ignore'] })
+        .toString()
+        .trim();
+} catch { }
+
+const buildinfo = gitHash
+    ? version.includes('+')
+        ? `${version}.${gitHash}`
+        : `${version}+${gitHash}`
+    : version;
+
+writeFileSync(BUILD_INFO_FILE, buildinfo.trim(), 'utf-8');
+
+console.log(`'${BUILD_INFO_FILE}' has been updated with build info: ${buildinfo}`);

package/scripts/cdn-rewrite-map.json

@@ -0,0 +1 @@
+{}

package/template/CHANGELOG.md

@@ -2,4 +2,4 @@
 
 ## 0.0.0
 
-1. Versioning initialized.
+1. Package created.

package/template/README.md

@@ -14,31 +14,25 @@
 
 # Quick Start
 
-```bash
-# remove dist/ and tsconfig.tsbuildinfo and tsconfig.build.tsbuildinfo
-bun run clean
+*<QUICK START INSTRUCTIONS>*
 
-# remove dist/ only
-bun run clean:dist
+# Documentation
 
-# remove tsconfig.tsbuildinfo and tsconfig.build.tsbuildinfo only
-bun run clean:tsbuildinfo
+*<DOCUMENTATION>*
 
-# compile + bundle
-bun run build
+# DevOps
+
+```bash
+bun install
 
-# run tests
+bun run clean
+bun run build
 bun run tests
 
-# run src/dev.ts in watch mode
 bun run dev
-```
-
-# Documentation
 
-*<DOCUMENTATION>*
-
-# DevOps
+# see publish section for publish instructions
+```
 
 ## Change Management
 
@@ -47,7 +41,7 @@ bun run dev
 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.
-6. After merge, run `bun run build` - ensures artifacts are current before publish.
+6. Ensure package artifacts are current.
 7. Publish.
 
 ## Publish

package/template/buildinfo.txt

@@ -0,0 +1 @@
+0.0.0

package/template/gitignore

@@ -1,7 +1,7 @@
-dist
 node_modules
 buildinfo.txt
 *.tsbuildinfo
 buildinfo-template.txt
 CHANGELOG-template.md
 README-template.md
+dist

package/template/package.json

@@ -11,6 +11,7 @@
     "type": "git",
     "url": ""
   },
+  "private": false,
   "type": "module",
   "exports": {
     ".": {
@@ -24,21 +25,24 @@
     "#src/*.js": "./src/*.ts"
   },
   "files": [
+    "scripts/buildinfo.ts",
+    "scripts/build-bundle.ts",
+    "scripts/cdn-rewrite-map.json",
     "dist",
     "CHANGELOG.md",
     "buildinfo.txt"
   ],
   "scripts": {
     "clean:dist": "rm -rf dist/",
-    "clean:tsbuildinfo": "rm -f tsconfig.build.tsbuildinfo",
+    "clean:tsbuildinfo": "rm -f *.tsbuildinfo || true",
     "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
-    "prebuild": "bun run scripts/buildinfo.ts",
+    "buildinfo": "bun run scripts/buildinfo.ts",
     "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",
     "typecheck": "tsc --noEmit",
-    "dev": "bun run --watch src/dev.ts"
+    "reinstall": "rm -rf node_modules && rm -f bun.lock && bun pm cache rm && bun install && bunx tsc --version",
+    "prebuild": "bun run buildinfo",
+    "build": "bun run build:bundle",
+    "build:bundle": "bun run scripts/build-bundle.ts"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/template/scripts/build-bundle.ts

@@ -0,0 +1,161 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
+
+import CDN_REWRITE_MAP from './cdn-rewrite-map.json';
+
+
+interface ExportConditions {
+    [key: string]: string | undefined;
+    entrypoint?: string;
+    types?: string;
+    browser?: string;
+    import?: string;
+}
+
+interface DependencyMap {
+    [packageName: string]: string;
+}
+
+interface PackageManifest {
+    version: string;
+    exports?: Record<string, ExportConditions>;
+    dependencies?: DependencyMap;
+    devDependencies?: DependencyMap;
+    peerDependencies?: DependencyMap;
+}
+
+function getManifest(packageIdentifier?: string): PackageManifest {
+
+    const manifestPath = packageIdentifier
+        ? join('node_modules', packageIdentifier, 'package.json')
+        : 'package.json';
+
+    let manifest: PackageManifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    } catch {
+        if (packageIdentifier)
+            throw new Error(`[scripts/build-bundle.ts] Could not read manifest for '${packageIdentifier}' at '${manifestPath}'.`);
+        else
+            throw new Error(`[scripts/build-bundle.ts] Could not read package manifest at '${manifestPath}'.`);
+    }
+
+    return manifest;
+
+}
+
+function getManifestEntrypoints(packageManifest: PackageManifest): string[] {
+
+    const exports = packageManifest.exports;
+    if (!exports)
+        throw new Error(`[scripts/build-bundle.ts] No 'exports' field found in the given package manifest.`);
+
+    const entrypoints = Object.entries(exports)
+        .map(([key, conditions]) => {
+            if (!conditions.entrypoint)
+                throw new Error(`[scripts/build-bundle.ts] Export '${key}' does not have an 'entrypoint' condition.`);
+            return conditions.entrypoint;
+        });
+
+    return entrypoints;
+
+}
+
+function getPackageVersion(manifest: PackageManifest, packageIdentifier?: string): string {
+
+    let version: string | undefined;
+    if (packageIdentifier) {
+
+        const dependencies = {
+            ...manifest.dependencies,
+            ...manifest.devDependencies,
+            ...manifest.peerDependencies,
+        };
+
+        version = dependencies[packageIdentifier];
+        if (!version)
+            throw new Error(`[scripts/build-bundle.ts] Package '${packageIdentifier}' is not listed in dependencies.`);
+
+    }
+    else {
+        if (!manifest.version)
+            throw new Error('[scripts/build-bundle.ts] Package manifest does not contain a version field.');
+        version = manifest.version;
+    }
+
+    return version;
+
+}
+
+function resolveCdnUrl(importSpecifier: string, urlTemplate: string): string {
+    const manifest = getManifest();
+    const version = getPackageVersion(manifest, importSpecifier);
+    return urlTemplate.replace('<VERSION>', version);
+}
+
+const cdnRewritePlugin = {
+    name: 'cdn-rewrite',
+    setup(build: any) {
+
+        const resolved = new Map<string, string>();
+        for (const [importSpecifier, urlTemplate] of Object.entries(CDN_REWRITE_MAP) as [string, string][]) {
+            const url = resolveCdnUrl(importSpecifier, urlTemplate);
+            resolved.set(importSpecifier, url);
+            console.log(`[cdn-rewrite] '${importSpecifier}' → '${url}'`);
+        }
+
+        build.onResolve({ filter: /\*/ }, (args: any) => {
+            const url = resolved.get(args.path);
+            if (url) return { path: url, external: true };
+        });
+
+    },
+};
+
+
+const entrypoints = getManifestEntrypoints(getManifest());
+console.log('[scripts/build-bundle.ts] Entrypoints:', entrypoints);
+
+let buildResult;
+
+console.log('[scripts/build-bundle.ts] Starting ESM bundle build...');
+buildResult = await Bun.build({
+    entrypoints,
+    outdir: 'dist',
+    naming: '[dir]/[name].bundle.[ext]',
+    target: 'browser',
+    format: 'esm',
+    minify: true,
+    sourcemap: 'external',
+    plugins: [cdnRewritePlugin],
+});
+
+if (!buildResult.success) {
+    console.error('[scripts/build-bundle.ts] Build failed:');
+    for (const message of buildResult.logs) {
+        console.error(message);
+    }
+    process.exit(1);
+}
+console.log('[scripts/build-bundle.ts] ESM bundle build completed successfully.');
+
+console.log('[scripts/build-bundle.ts] Starting IIFE bundle build...');
+buildResult = await Bun.build({
+    entrypoints,
+    outdir: 'dist',
+    naming: '[dir]/[name].iife.[ext]',
+    target: 'browser',
+    format: 'iife',
+    minify: true,
+    sourcemap: 'external',
+    plugins: [cdnRewritePlugin],
+});
+
+if (!buildResult.success) {
+    console.error('[scripts/build-bundle.ts] Build failed:');
+    for (const message of buildResult.logs) {
+        console.error(message);
+    }
+    process.exit(1);
+}
+console.log('[scripts/build-bundle.ts] IIFE bundle build completed successfully.');

package/template/{src → scripts}/dev.ts

@@ -7,7 +7,7 @@ const packageUrl = new URL('../', import.meta.url);
 console.log(`'packagePath':`, fileURLToPath(packageUrl));
 
 
-// dev code
+// dev scratchpad
 
 
 console.log(`${(performance.now() - start).toFixed(3)}ms`);

package/template/tsconfig.json

@@ -3,8 +3,7 @@
     "target": "ESNext",
     "module": "ESNext",
     "lib": [
-      "ESNext",
-      "DOM"
+      "ESNext"
     ],
     "moduleResolution": "bundler",
     "strict": true,
@@ -24,13 +23,13 @@
     "declaration": true,
     "declarationMap": true,
     "emitDeclarationOnly": true,
-    "outDir": "./dist",
+    "outDir": "./dist"
   },
   "include": [
-    "src/**/*.ts",
     "tests/**/*.ts",
     "scripts/**/*.ts",
-    "scripts/**/*.json"
+    "scripts/**/*.json",
+    "src/**/*.ts"
   ],
   "exclude": [
     "node_modules",

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-import { cpSync, readFileSync, renameSync, writeFileSync } from 'fs';
-import { resolve } from 'path';
-import { templatePath, changelogPath, buildinfoPath, readmePath } from './constants.js';
-try {
-    const packageNameArgument = process.argv[2];
-    if (!packageNameArgument)
-        throw new Error('Package name argument is required. Usage: `create-ts-lib <package-name>`');
-    const packageName = packageNameArgument.replace(/\\/g, '/');
-    const destinationPath = resolve(process.cwd(), packageName);
-    cpSync(templatePath, destinationPath, { recursive: true });
-    cpSync(changelogPath, resolve(destinationPath, 'CHANGELOG-template.md'));
-    cpSync(buildinfoPath, resolve(destinationPath, 'buildinfo-template.txt'));
-    cpSync(readmePath, resolve(destinationPath, 'README-template.md'));
-    const packageJsonPath = resolve(destinationPath, 'package.json');
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-    packageJson.name = packageName;
-    writeFileSync(packageJsonPath, JSON.stringify(packageJson, 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/constants.d.ts

@@ -1,7 +0,0 @@
-export declare const packageUrl: URL;
-export declare const packagePath: string;
-export declare const templatePath: string;
-export declare const changelogPath: string;
-export declare const buildinfoPath: string;
-export declare const readmePath: string;
-//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,EAAE,GAAqC,CAAC;AAC/D,eAAO,MAAM,WAAW,EAAE,MAA2C,CAAC;AAEtE,eAAO,MAAM,YAAY,EAAE,MAA0C,CAAC;AAEtE,eAAO,MAAM,aAAa,EAAE,MAA6C,CAAC;AAC1E,eAAO,MAAM,aAAa,EAAE,MAA8C,CAAC;AAC3E,eAAO,MAAM,UAAU,EAAE,MAA0C,CAAC"}

package/dist/constants.js

@@ -1,8 +0,0 @@
-import { resolve } from 'path';
-import { fileURLToPath } from 'url';
-export const packageUrl = new URL('../', import.meta.url);
-export const packagePath = resolve(fileURLToPath(packageUrl));
-export const templatePath = resolve(packagePath, 'template/');
-export const changelogPath = resolve(packagePath, 'CHANGELOG.md');
-export const buildinfoPath = resolve(packagePath, 'buildinfo.txt');
-export const readmePath = resolve(packagePath, 'README.md');

package/template/tsconfig.build.json

@@ -1,19 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "rootDir": "./src",
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "emitDeclarationOnly": false,
-  },
-  "include": [
-    "src/**/*.ts"
-  ],
-  "exclude": [
-    "src/dev.ts",
-    "node_modules",
-    "dist",
-    "tests",
-    "scripts"
-  ]
-}