@temir.ra/create-workspace 0.3.1 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Version 0
 
+## 0.4.1
+
+1. Cleaned up coding-specific aspects.
+2. Updated the description in `package.json`.
+
+## 0.4.0
+
+1. Updated `.gitignore`: added `buildinfo-template.txt`, `CHANGELOG-template.md`, `README-template.md`, `buildinfo.txt`, and `*.tsbuildinfo`; replaced nested `template/.gitignore` with `template/gitignore` to prevent template files from being excluded during distribution.
+2. Overhauled the generated `package.json`: added `keywords`, `repository`, and `devDependencies` fields; fixed recursive script execution; replaced propagating `clean` with `clean:dist` + `clean:tsbuildinfo` sub-scripts; removed `build` and workspace-propagating `tests`/`typecheck` (propagation is now opt-in, documented in the README); added `reinstall` script.
+3. Updated the generated `tsconfig.json`: removed `DOM` from `lib`; added `types: ["bun"]`.
+4. Improved CLI error message for missing package name argument.
+5. Overhauled `README.md`: rewritten intro, added `tsconfig.json` documentation section, updated `package.json` documentation, added Script Propagation section, added `create-doc` to the template family table; removed publishing section from `template/README.md`.
+6. Renamed `scripts/build-lib-bundle.ts` to `scripts/build-bundle.ts`; updated to produce both ESM and IIFE browser bundles; removed `tsconfig.build.json` and `build:lib` step; added build scripts to published `files`; set `private: false`.
+7. Updated from `@temir.ra/template@0.1.3` template.
+
 ## 0.3.1
 
 1. Fixed create commands in the **Quick Start** section of the `README.md` to reflect the create-template conventions.

package/README.md

@@ -1,56 +1,62 @@
 # Introduction
 
-A template for a package with build metadata, tests, and workspace-aware scripts. The generated package works standalone; add a `workspaces` field to scale it into a monorepo.
+The base template of the family. Scaffolds a Bun package: `package.json`, TypeScript configuration, and conventions for testing, change management, and git versioning. Use it as-is, extend it into a monorepo, or choose a more specific template from the family for common upgrade paths.
 
-The following templates are available in this ecosystem:
+For some use cases a purpose-built template already exists and reduces the amount of manual adjustment needed. Use the table to decide whether to start here or with a more specific template.
+
+Templates in this family:
 
 | Template | Purpose |
 |---|---|
-| [`create-ts-lib`](#create-ts-lib) | TypeScript library distributed via registry |
-| [`create-hono-server`](#create-hono-server) | Bun/Hono HTTP server |
-| [`create-hono-spa`](#create-hono-spa) | Frontend SPA as a Hono sub-app library |
+| [`create-workspace`](#packagejson) | Base Bun package; root of the template family *(this template)* |
+| [`create-ts-lib`](#create-ts-lib) | TypeScript library with build pipeline, distributed via registry |
+| [`create-hono-server`](#create-hono-server) | Bun+Hono web server |
+| [`create-hono-spa`](#create-hono-spa) | SPA scaffold, pluggable into a Hono server as a sub-app |
 | [`create-skill`](#create-skill) | LLM skill package |
-| [`create-workspace`](#packagejson) | Package with workspace support *(this template)* |
+| [`create-doc`](#create-doc) | Document as a collection of Markdown sections, compiled to PDF |
 
 ## Table of Contents
 
 1. [Quick Start](#quick-start)
 2. [Documentation](#documentation)
     1. [`package.json`](#packagejson)
-    2. [Workspaces](#workspaces)
-    3. [Cross-workspace Dependencies](#cross-workspace-dependencies)
-    4. [Scaffolding Patterns](#scaffolding-patterns)
-        1. [Library](#library)
-        2. [Server](#server)
-        3. [Server + SPA](#server--spa)
-        4. [Full-Stack with Shared Types](#full-stack-with-shared-types)
-        5. [Skill](#skill)
+    2. [`Script `scripts/build-bundle.ts`](#script-scriptsbuild-bundlets)
+    3. [`tsconfig.json`](#tsconfigjson)
+    4. [Workspaces](#workspaces)
+      1. [Script Propagation](#script-propagation)
+      2. [Cross-workspace Dependencies](#cross-workspace-dependencies)
+      3. [Scaffolding Patterns](#scaffolding-patterns)
+          1. [Library](#library)
+          2. [Server](#server)
+          3. [Server + SPA](#server--spa)
+          4. [Full-Stack with Shared Types](#full-stack-with-shared-types)
+          5. [Skill](#skill)
 3. [DevOps](#devops)
     1. [Change Management](#change-management)
     2. [Publish](#publish)
 
 # 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-workspace
+    # <TEMPLATE_NAME: @temir.ra/workspace
     # <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-workspace" version
-# create a new package from the template version
 bun create --no-install --no-git "@temir.ra/workspace<@_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 package from the latest template version
 bun create --no-install --no-git "@temir.ra/workspace" <NEW_PACKAGE>
 
-# dependencies must be installed manually
+# templates only copy files, run install and any setup scripts manually
 cd <NEW_PACKAGE>
 bun install
 ```
@@ -65,6 +71,7 @@ See npmjs documentation on [package.json](https://docs.npmjs.com/cli/v11/configu
 
 ```json
 {
+
   "name": "",
   "version": "0.0.0",
 
@@ -72,35 +79,116 @@ See npmjs documentation on [package.json](https://docs.npmjs.com/cli/v11/configu
   "author": "",
   "license": "",
 
-  // prevents publishing to a registry
-  "private": true,
+  "keywords": [],
 
-  "scripts": {
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
 
-    // removes dist/
-    "clean:dist": "rm -rf dist/",
+  // controls whether the package can be published to a registry
+  "private": true,
 
-    // removes dist/ and propagates clean to any workspace packages
-    "clean": "bun run clean:dist && bun run --filter '*' clean",
+  "scripts": {
 
-    // generates buildinfo.txt before each build
-    "prebuild": "bun run scripts/buildinfo.ts",
+    // deletes node_modules and the lockfile, clears the Bun cache, then reinstalls
+    // useful for recovering from a corrupted node_modules or lockfile
+    "reinstall": "rm -rf node_modules && rm -f bun.lock && bun pm cache rm && bun install && bunx tsc --version",
 
-    // propagates build to any workspace packages
-    "build": "bun run --filter '*' build",
+    // type-checks the project without emitting output
+    "typecheck": "tsc --noEmit",
 
-    // runs local tests and propagates tests to any workspace packages
-    "tests": "bun test && bun run --filter '*' tests",
+    // generates buildinfo.txt (for use in lifecycle hooks and CI pipelines)
+    "buildinfo": "bun run scripts/buildinfo.ts"
 
-    // propagates typecheck to any workspace packages
-    "typecheck": "bun run --filter '*' typecheck"
+  },
 
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^6.0.2"
   }
 
 }
 ```
 
-The `--filter '*'` scripts forward to any workspace packages when a `workspaces` field is present; they are no-ops otherwise. See [Workspaces](#workspaces) for how to opt in.
+## Script `scripts/buildinfo.ts`
+
+Writes `buildinfo.txt` with the package version from `package.json`, appending the git short hash as semver build metadata (`<version>+<hash>`). If the version already contains `+`, the hash is appended as `<version>+<existing>.<hash>` instead. Falls back to the bare version when git is unavailable.
+
+## `tsconfig.json`
+
+See the TypeScript documentation on [tsconfig.json](https://www.typescriptlang.org/tsconfig) for detailed explanations of all options.
+
+```json
+{
+
+  "compilerOptions": {
+
+    // 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",
+
+    // 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
+    ],
+
+    // module resolution strategy; bundler mode allows omitting file extensions in imports
+    "moduleResolution": "bundler",
+
+    // enables all strict type-checking options
+    "strict": true,
+
+    // 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 project references and incremental builds via *.tsbuildinfo
+    "composite": true,
+
+    // do not type-check `.d.ts` files in `node_modules/`
+    "skipLibCheck": true,
+
+    // TS6 defaults types to [] - @types/* packages must be listed explicitly
+    "types": ["bun"],
+
+    // enforce consistent casing across import statements
+    "forceConsistentCasingInFileNames": true,
+
+    // allows importing JSON files as typed modules
+    "resolveJsonModule": true
+
+  },
+
+  // files matched by include are type-checked and visible to the IDE (IntelliSense, go-to-definition, etc.)
+  "include": [
+    "scripts/**/*.ts"
+  ],
+  // files matched by exclude are hidden from the IDE and excluded from type-checking
+  "exclude": [
+    "node_modules"
+  ]
+
+}
+```
 
 ## Workspaces
 
@@ -128,6 +216,30 @@ The execution environment installs all workspace dependencies into a single shar
         └── ...
 ```
 
+### Script Propagation
+
+Append `&& bun run --filter './*' <script>` to any script to propagate the call to all workspace packages:
+
+```json
+{
+  "scripts": {
+    "clean:dist": "rm -rf dist/ && bun run --filter './*' clean:dist",
+    "clean:tsbuildinfo": "rm -f *.tsbuildinfo && bun run --filter './*' clean:tsbuildinfo",
+    "tests": "bun test && bun run --filter './*' tests",
+    "typecheck": "bun run --filter './*' typecheck"
+  }
+}
+```
+
+`./*` targets all direct workspace packages. Replace with a more specific glob to limit propagation to a subset.
+
+By default packages are run in sequence. Add `--parallel` to run them concurrently, or `--sequential` to make it explicit:
+
+```bash
+bun run --filter './*' --parallel typecheck
+bun run --filter './*' --sequential clean
+```
+
 ### Cross-workspace Dependencies
 
 To use one workspace package from another, declare it as a dependency using the `workspace:` protocol:
@@ -308,20 +420,15 @@ Starting point for any LLM skill package. See the full documentation at [`@temir
 # 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 package in example/
-bun run dist/cli.bundle.js -- example
+# see publish section for publish instructions
 ```
 
 ## Change Management
@@ -331,7 +438,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.3.1+96a0e4d
+0.4.1+f472194

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-workspace <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=33D8671BE383296E64756E2164756E21
+//# 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-workspace <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,6EAA6E,EACvH,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": "33D8671BE383296E64756E2164756E21",
+  "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,7 +1,7 @@
 {
   "name": "@temir.ra/create-workspace",
-  "version": "0.3.1",
-  "description": "Package scaffold with workspace support",
+  "version": "0.4.1",
+  "description": "Template for a generic TypeScript workspace.",
   "author": "temir.ra",
   "license": "MIT",
   "keywords": [
@@ -14,12 +14,16 @@
     "type": "git",
     "url": "https://git.chimps.quest/trs/create-workspace.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,14 +31,15 @@
   ],
   "scripts": {
     "clean:dist": "rm -rf dist/",
-    "clean:tsbuildinfo": "rm -f tsconfig.tsbuildinfo 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"
+    "typecheck": "tsc --noEmit",
+    "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/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/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

@@ -8,9 +8,6 @@
 2. [Documentation](#documentation)
 3. [DevOps](#devops)
     1. [Change Management](#change-management)
-    2. [Publish](#publish)
-        1. [npmjs.org](#npmjsorg)
-        2. [Custom registry](#custom-registry)
 
 # Quick Start
 
@@ -29,48 +26,5 @@
 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
-
-See the following sources to configure the target registry and authentication.
-
-- [Configuring npm - `npmrc`](https://docs.npmjs.com/cli/v10/configuring-npm/npmrc)
-- [Bun package manager - `install.registry`](https://bun.com/docs/runtime/bunfig#install-scopes)
-
-⚠️ Package Scope and the authentication for the target registry must be aligned.
-
-### `npmjs.org`
-
-Publish to the public npm registry.
-
-```powershell
-# authenticate
-npm login
-# publish
-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` or `bunfig.toml`:
-
-```toml
-[install.scopes]
-"<SCOPE_WITHOUT_AT>" = { url = "<REGISTRY_URL>", token = "$BUN_PUBLISH_AUTH_TOKEN" }
-```
-
-```powershell
-# authenticate
-$env:BUN_PUBLISH_AUTH_TOKEN = "<BUN_PUBLISH_AUTH_TOKEN>"
-# publish
-bun publish
-```

package/template/buildinfo.txt

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

package/template/gitignore

@@ -1 +1,5 @@
 node_modules
+buildinfo.txt
+buildinfo-template.txt
+CHANGELOG-template.md
+README-template.md

package/template/package.json

@@ -4,13 +4,19 @@
   "description": "",
   "author": "",
   "license": "",
+  "keywords": [],
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
   "private": true,
   "scripts": {
-    "clean:dist": "rm -rf dist/",
-    "clean": "bun run clean:dist && bun run --filter '*' clean",
-    "prebuild": "bun run scripts/buildinfo.ts",
-    "build": "bun run --filter '*' build",
-    "tests": "bun test && bun run --filter '*' tests",
-    "typecheck": "bun run --filter '*' typecheck"
+    "reinstall": "rm -rf node_modules && rm -f bun.lock && bun pm cache rm && bun install && bunx tsc --version",
+    "typecheck": "tsc --noEmit",
+    "buildinfo": "bun run scripts/buildinfo.ts"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^6.0.2"
   }
 }

package/template/tsconfig.json

@@ -3,8 +3,7 @@
     "target": "ESNext",
     "module": "ESNext",
     "lib": [
-      "ESNext",
-      "DOM"
+      "ESNext"
     ],
     "moduleResolution": "bundler",
     "strict": true,
@@ -16,11 +15,13 @@
     "esModuleInterop": true,
     "composite": true,
     "skipLibCheck": true,
+    "types": [
+      "bun"
+    ],
     "forceConsistentCasingInFileNames": true,
     "resolveJsonModule": true
   },
   "include": [
-    "tests/**/*.ts",
     "scripts/**/*.ts"
   ],
   "exclude": [

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-workspace <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/tests/buildinfo.test.ts

@@ -1,23 +0,0 @@
-import { describe, it, expect } from 'bun:test';
-import { readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
-
-
-const buildinfoUrl = new URL('../buildinfo.txt', import.meta.url);
-
-// taken from https://semver.org/#is-there-a-suggested-regular-expression-regex-to-check-a-semver-string
-// Captures: [1]=major, [2]=minor, [3]=patch, [4]=pre-release, [5]=build-metadata
-const SEMVER_REGEX =
-    /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
-
-function readBuildinfo(): string {
-    return readFileSync(fileURLToPath(buildinfoUrl), 'utf-8').trim();
-}
-
-describe('buildInfo', () => {
-
-    it('should be a valid semver string', () => {
-        expect(readBuildinfo()).toMatch(SEMVER_REGEX);
-    });
-
-});