@temir.ra/create-hono-spa 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Version 0
 
+## 0.3.0
+
+1. Updated from `@temir.ra/create-template@0.1.3`.
+
+## 0.2.1
+
+1. Updated files from `ts-lib@0.6.3` template.
+
 ## 0.2.0
 
 1. Updated documentation and configs to TypeScript 6.

package/README.md

@@ -5,63 +5,48 @@ A template for single-page applications distributed as Hono sub-app libraries. T
 ## Table of Contents
 
 1. [Quick Start](#quick-start)
-2. [AI Assistant Context](#ai-assistant-context)
-3. [Documentation](#documentation)
+2. [Documentation](#documentation)
     1. [`template/`](#template)
     2. [Architecture](#architecture)
     3. [`src/spa.ts`](#srcspa-ts)
     4. [`src/constants.ts`](#srcconstants-ts)
     5. [`assets/`](#assets)
-4. [DevOps](#devops)
+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-hono-spa
+    # <TEMPLATE_NAME: @temir.ra/hono-spa
     # <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-hono-spa" version
-# create a new library from the template version
 bun create --no-install --no-git "@temir.ra/hono-spa<@_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/hono-spa" <NEW_PACKAGE>
 
-# dependencies must be installed manually
+# templates only copy files, run install and any setup scripts manually
 cd <NEW_PACKAGE>
 bun install
 ```
 
-# AI Assistant Context
-
-To generate an AI coding assistant context file for this project:
-
-> Generate an AI coding assistant context file. Analyze the project structure and source files, using this README as the primary reference for architecture and conventions. Give particular attention to: the SPA-as-library abstraction and how assets are served via import.meta.url without any file copying on the consuming server, the `./spa` export condition and createSpa() as the library's public API, and the base href patching mechanism that enables client-side routing regardless of mount path.
-
 # Documentation
 
-The following sections explain the configurations and conventions baked into the generated package.
+The following sections explain the configurations and conventions baked into the generated package. Useful when adapting it to fit specific needs.
 
 ## `template/`
 
-The files in `template/` were created from the [`@temir.ra/ts-lib@0.5.0`](https://www.npmjs.com/package/@temir.ra/create-ts-lib/v/0.5.0) template and then updated to fit the needs of a Hono SPA template.
-
-```powershell
-bun create --no-install --no-git --force "@temir.ra/ts-lib@0.5.0" "template/"
-```
-
 [Official documentation](https://hono.dev/docs/) provided by the Hono team is a great resource.
 
 ## Architecture
@@ -142,23 +127,16 @@ assets/
 # DevOps
 
 ```bash
-# remove dist/ and tsconfig.build.tsbuildinfo
-bun run clean
-
-# remove dist/ only
-bun run clean:dist
-
-# remove tsconfig.build.tsbuildinfo only
-bun run clean:tsbuildinfo
+bun install
 
-# compile + bundle
+bun run clean
 bun run build
+bun run tests
 
-# create a new test hono spa in example/
-bun run dist/cli.bundle.js -- example
-```
+bun run dev
 
-**Publish** - see [Publish](#publish).
+# see publish section for publish instructions
+```
 
 ## Change Management
 
@@ -167,20 +145,11 @@ 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
 
-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
@@ -189,26 +158,3 @@ 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/buildinfo.txt

@@ -1 +1 @@
-0.2.0+40f404b
+0.3.0+1137cb4

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-hono-spa <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=22A62DDB3C86A9D764756E2164756E21
+//# 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, basename } 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-hono-spa <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,4EAA4E,EACtH,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": "22A62DDB3C86A9D764756E2164756E21",
+  "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-hono-spa",
-  "version": "0.2.0",
-  "description": "SPA template with Hono server backend",
+  "version": "0.3.0",
+  "description": "SPA template for Hono server backend",
   "author": "temir.ra",
   "license": "MIT",
   "keywords": [
@@ -15,12 +15,16 @@
     "type": "git",
     "url": "https://git.chimps.quest/trs/create-hono-spa.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",
@@ -28,14 +32,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"
+    "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/README.md

@@ -5,9 +5,8 @@
 ## Table of Contents
 
 1. [Quick Start](#quick-start)
-2. [AI Assistant Context](#ai-assistant-context)
-3. [Documentation](#documentation)
-4. [DevOps](#devops)
+2. [Documentation](#documentation)
+3. [DevOps](#devops)
     1. [Change Management](#change-management)
     2. [Publish](#publish)
         1. [npmjs.org](#npmjsorg)
@@ -16,13 +15,13 @@
 # Quick Start
 
 ```bash
-# remove dist/ and tsconfig.build.tsbuildinfo
+# remove dist/ and tsconfig.tsbuildinfo and tsconfig.build.tsbuildinfo
 bun run clean
 
 # remove dist/ only
 bun run clean:dist
 
-# remove tsconfig.build.tsbuildinfo only
+# remove tsconfig.tsbuildinfo and tsconfig.build.tsbuildinfo only
 bun run clean:tsbuildinfo
 
 # compile + bundle
@@ -35,30 +34,10 @@ bun run tests
 bun run dev
 ```
 
-**Publish** - see [Publish](#publish).
-
-# AI Assistant Context
-
-To generate an AI coding assistant context file for this project:
-
-> Generate an AI coding assistant context file. `README-template.md` is available now and documents the architectural conventions of this package — use it as your primary source. The generated context file must be self-contained: `README-template.md` will be deleted after context generation, so do not reference it in the output. Give particular attention to: the dual tsconfig setup and the import constraints it imposes, the `#src/*.js` alias and where it may and may not be used, the `./spa` export condition and createSpa() as the library's public API, the asset resolution via import.meta.url and why it is reliable when the package is loaded externalized, and the base href patching mechanism for client-side routing.
-
 # Documentation
 
 *<DOCUMENTATION>*
 
-## Asset Resolution
-
-*<!-- Remove this section if the library has no runtime assets. Replace `@scope/lib-name` throughout with the actual package name. -->*
-
-Assets are placed under `assets/@scope/lib-name/` (scoped to the package name to prevent collisions). They are resolved at runtime via `import.meta.url` and loaded with `fetch()` (browser) or `readFile` (Node). `assets/` must be listed in `files` in `package.json`.
-
-`import.meta.url` is reliable when the library is loaded as a discrete module (from CDN or `node_modules/`). When the consumer bundles the library, they must copy the assets - see below.
-
-### For consumers bundling this library
-
-Copy `node_modules/@scope/lib-name/assets/` into your build output alongside the bundle, preserving the relative path. No code configuration is required - only the file copy.
-
 # DevOps
 
 ## Change Management
@@ -95,9 +74,9 @@ bun publish --registry https://registry.npmjs.org/ --access public
 
 ```bash
 # placeholder:
-    # <SCOPE_WITHOUT_AT: <SCOPE_WITHOUT_AT>
-    # <REGISTRY_URL: <REGISTRY_URL>
-    # <BUN_PUBLISH_AUTH_TOKEN: <BUN_PUBLISH_AUTH_TOKEN>
+  # <SCOPE_WITHOUT_AT: <SCOPE_WITHOUT_AT>
+  # <REGISTRY_URL: <REGISTRY_URL>
+  # <BUN_PUBLISH_AUTH_TOKEN: <BUN_PUBLISH_AUTH_TOKEN>
 ```
 
 `~/.bunfig.toml` or `bunfig.toml`:

package/template/package.json

@@ -1,55 +1,55 @@
-{
-  "name": "",
-  "version": "0.0.0+FE",
-  "description": "",
-  "author": "",
-  "license": "",
-  "keywords": [
-    "typescript"
-  ],
-  "repository": {
-    "type": "git",
-    "url": ""
-  },
-  "type": "module",
-  "exports": {
-    ".": {
-      "entrypoint": "./src/index.ts",
-      "types": "./dist/index.d.ts",
-      "browser": "./dist/index.bundle.js",
-      "import": "./dist/index.js"
-    },
-    "./spa": {
-      "entrypoint": "./src/spa.ts",
-      "types": "./dist/spa.d.ts",
-      "browser": "./dist/spa.bundle.js",
-      "import": "./dist/spa.js"
-    }
-  },
-  "imports": {
-    "#src/*.js": "./src/*.ts"
-  },
-  "files": [
-    "dist",
-    "CHANGELOG.md",
-    "buildinfo.txt",
-    "assets"
-  ],
-  "scripts": {
-    "clean:dist": "rm -rf dist/",
-    "clean:tsbuildinfo": "rm -f tsconfig.build.tsbuildinfo",
-    "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
-    "prebuild": "bun run scripts/buildinfo.ts",
-    "tests": "bun test",
-    "build": "bun run build:lib && bun run build:lib-bundle",
-    "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"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^6.0.2",
-    "hono": "^4.12.5"
-  }
+{
+  "name": "",
+  "version": "0.0.0+FE",
+  "description": "",
+  "author": "",
+  "license": "",
+  "keywords": [
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "entrypoint": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.bundle.js",
+      "import": "./dist/index.js"
+    },
+    "./spa": {
+      "entrypoint": "./src/spa.ts",
+      "types": "./dist/spa.d.ts",
+      "browser": "./dist/spa.bundle.js",
+      "import": "./dist/spa.js"
+    }
+  },
+  "imports": {
+    "#src/*.js": "./src/*.ts"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "buildinfo.txt",
+    "assets"
+  ],
+  "scripts": {
+    "clean:dist": "rm -rf dist/",
+    "clean:tsbuildinfo": "rm -f tsconfig.tsbuildinfo tsconfig.build.tsbuildinfo",
+    "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
+    "prebuild": "bun run scripts/buildinfo.ts",
+    "tests": "bun test",
+    "build": "bun run build:lib && bun run build:lib-bundle",
+    "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"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^6.0.2",
+    "hono": "^4.12.5"
+  }
 }

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, basename } 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-hono-spa <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');