@temir.ra/create-template 0.1.11 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Version 0
 
+## 0.2.1
+
+1. Updated Quick Start section.
+
+## 0.2.0
+
+1. Synced with `ts-lib@0.9.0` template.
+2. Switched to `esbuild` for bundling.
+3. Updated Quick Start section to reflect typical usage patterns.
+4. Updated files from self.
+
 ## 0.1.11
 
 1. Synced with `ts-lib@0.8.4` template.

package/README.md

@@ -14,25 +14,21 @@
 
 ```bash
 # placeholder:
-    # <TEMPLATE_PACKAGE: @temir.ra/create-template
-    # <TEMPLATE_NAME: @temir.ra/template
     # <NEW_PACKAGE: <NEW_PACKAGE>
-      # is used as:
-      #   - the path where the package is created
-      #   - the "name" field in the generated package.json
-    # <@_VERSION: <@_VERSION>
+    # <TEMPLATE_PACKAGE_NAME: @temir.ra/create-template
+    # <TEMPLATE_NAME: @temir.ra/template
+
+mkdir -p <NEW_PACKAGE>
+cd <NEW_PACKAGE>
 
-# pinned version
+# print the latest version
 bun info "@temir.ra/create-template" version
-bun create --no-install --no-git "@temir.ra/template<@_VERSION>" <NEW_PACKAGE>
 
-# latest
-# clear the cache to pick up the latest version
-bun pm cache rm
-bun create --no-install --no-git "@temir.ra/template" <NEW_PACKAGE>
+# create/update a package from the template in the current directory
+bun create --no-install --no-git "@temir.ra/template@latest" .
+
+# set metadata in package.json
 
-# templates only copy files, run install and any setup scripts manually
-cd <NEW_PACKAGE>
 bun install
 ```
 

package/buildinfo.txt

@@ -1 +1 @@
-0.1.11+05a1e68
+0.2.1+57fdfbd

package/dist/cli.bundle.js

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

package/dist/cli.bundle.js.map

@@ -1,11 +1,7 @@
 {
   "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    templateUrl,\r\n    changelogUrl,\r\n    buildinfoUrl,\r\n    readmeUrl\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(templateUrl, destinationPath, { recursive: true });\r\n    cpSync(changelogUrl, resolve(destinationPath, 'CHANGELOG-template.md'));\r\n    cpSync(buildinfoUrl, resolve(destinationPath, 'buildinfo-template.txt'));\r\n    cpSync(readmeUrl, 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",
-    "export const packageUrl: URL = new URL('../', import.meta.url);\r\nexport const buildinfoUrl: URL = new URL('buildinfo.txt', packageUrl);\r\nexport const distUrl: URL = new URL('dist/', packageUrl);\r\n\r\nexport const templateUrl: URL = new URL('template/', packageUrl);\r\nexport const changelogUrl: URL = new URL('CHANGELOG.md', packageUrl);\r\nexport const readmeUrl: URL = new URL('README.md', packageUrl);\r\n"
-  ],
-  "mappings": ";AAEA,iBAAS,kBAAQ,gBAAc,mBAAY,WAC3C,kBAAS,aCHF,IAAM,EAAkB,IAAI,IAAI,MAAO,YAAY,GAAG,EAChD,EAAoB,IAAI,IAAI,gBAAiB,CAAU,EACvD,EAAe,IAAI,IAAI,QAAS,CAAU,EAE1C,EAAmB,IAAI,IAAI,YAAa,CAAU,EAClD,EAAoB,IAAI,IAAI,eAAgB,CAAU,EACtD,EAAiB,IAAI,IAAI,YAAa,CAAU,EDM7D,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,EAAa,EAAiB,CAAE,UAAW,EAAK,CAAC,EACxD,EAAO,EAAc,EAAQ,EAAiB,uBAAuB,CAAC,EACtE,EAAO,EAAc,EAAQ,EAAiB,wBAAwB,CAAC,EACvE,EAAO,EAAW,EAAQ,EAAiB,oBAAoB,CAAC,EAEhE,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": "EF224A42FEFD5AB864756E2164756E21",
-  "names": []
-}
+  "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    templateUrl,\r\n    changelogUrl,\r\n    buildinfoUrl,\r\n    readmeUrl\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(templateUrl, destinationPath, { recursive: true });\r\n    cpSync(changelogUrl, resolve(destinationPath, 'CHANGELOG-template.md'));\r\n    cpSync(buildinfoUrl, resolve(destinationPath, 'buildinfo-template.txt'));\r\n    cpSync(readmeUrl, 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", "export const packageUrl: URL = new URL('../', import.meta.url);\r\nexport const buildinfoUrl: URL = new URL('buildinfo.txt', packageUrl);\r\nexport const distUrl: URL = new URL('dist/', packageUrl);\r\n\r\nexport const templateUrl: URL = new URL('template/', packageUrl);\r\nexport const changelogUrl: URL = new URL('CHANGELOG.md', packageUrl);\r\nexport const readmeUrl: URL = new URL('README.md', packageUrl);\r\n"],
+  "mappings": ";AAEA,OAAS,UAAAA,EAAQ,gBAAAC,EAAc,cAAAC,EAAY,iBAAAC,MAAqB,KAChE,OAAS,WAAAC,MAAe,OCHjB,IAAMC,EAAkB,IAAI,IAAI,MAAO,YAAY,GAAG,EAChDC,EAAoB,IAAI,IAAI,gBAAiBD,CAAU,EACvDE,EAAe,IAAI,IAAI,QAASF,CAAU,EAE1CG,EAAmB,IAAI,IAAI,YAAaH,CAAU,EAClDI,EAAoB,IAAI,IAAI,eAAgBJ,CAAU,EACtDK,EAAiB,IAAI,IAAI,YAAaL,CAAU,EDM7D,GAAI,CAEA,IAAMM,EAAsB,QAAQ,KAAK,CAAC,EAC1C,GAAI,CAACA,EACD,MAAM,IAAI,MAAM,wFAAwF,EAC5G,IAAMC,EAAcD,EAAoB,QAAQ,MAAO,GAAG,EAEpDE,EAAkBC,EAAQ,QAAQ,IAAI,EAAGF,CAAW,EAE1DG,EAAOC,EAAaH,EAAiB,CAAE,UAAW,EAAK,CAAC,EACxDE,EAAOE,EAAcH,EAAQD,EAAiB,uBAAuB,CAAC,EACtEE,EAAOG,EAAcJ,EAAQD,EAAiB,wBAAwB,CAAC,EACvEE,EAAOI,EAAWL,EAAQD,EAAiB,oBAAoB,CAAC,EAEhE,IAAMO,EAAkBN,EAAQD,EAAiB,cAAc,EACzDQ,EAAc,KAAK,MAAMC,EAAaF,EAAiB,OAAO,CAAC,EACrEC,EAAY,KAAOT,EACnBW,EAAcH,EAAiB,KAAK,UAAUC,EAAa,KAAM,CAAC,CAAC,EAEnEG,EAAWV,EAAQD,EAAiB,WAAW,EAAGC,EAAQD,EAAiB,YAAY,CAAC,EAExF,QAAQ,IAAI,mDAAmDA,CAAe,wBAAwBD,CAAW,IAAI,CAEzH,OACOa,EAAO,CACV,IAAMC,EAAMD,aAAiB,MAAQA,EAAQ,IAAI,MAAM,OAAOA,CAAK,CAAC,EACpE,QAAQ,MAAM,SAAUC,EAAI,OAAO,EACnC,QAAQ,KAAK,CAAC,CAClB",
+  "names": ["cpSync", "readFileSync", "renameSync", "writeFileSync", "resolve", "packageUrl", "buildinfoUrl", "distUrl", "templateUrl", "changelogUrl", "readmeUrl", "packageNameArgument", "packageName", "destinationPath", "resolve", "cpSync", "templateUrl", "changelogUrl", "buildinfoUrl", "readmeUrl", "packageJsonPath", "packageJson", "readFileSync", "writeFileSync", "renameSync", "error", "err"]
+}

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@temir.ra/create-template",
-  "version": "0.1.11",
+  "version": "0.2.1",
   "description": "A template for a template package.",
   "author": "temir.ra",
   "license": "MIT",
   "keywords": [
     "typescript",
-    "bun",
-    "template"
+    "template-template"
   ],
   "repository": {
     "type": "git",
@@ -38,10 +37,12 @@
     "tests": "bun test",
     "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"
+    "build:cli-bundle": "esbuild src/cli.ts --outdir=dist --entry-names=[dir]/[name].bundle --platform=node --format=esm --bundle --minify --sourcemap=external"
   },
   "devDependencies": {
     "@types/bun": "latest",
+    "@types/node": "latest",
+    "esbuild": "latest",
     "typescript": "^6.0.3"
   }
 }

package/scripts/build-bundle.ts

@@ -1,5 +1,15 @@
 import { readFileSync } from 'fs';
 import { join } from 'path';
+import {
+    build,
+    type BuildFailure,
+    type OnResolveArgs,
+    type OnResolveResult,
+    type Plugin as EsbuildPlugin,
+    type PluginBuild,
+    type BuildOptions,
+    type BuildResult
+} from 'esbuild';
 
 import CDN_REWRITE_MAP from './cdn-rewrite-map.json';
 
@@ -11,17 +21,15 @@ interface ExportConditions {
     browser?: string;
     import?: string;
 }
-
-interface DependencyMap {
+interface Dependency {
     [key: string]: string;
 }
-
 interface PackageManifest {
     version: string;
     exports?: Record<string, ExportConditions>;
-    dependencies?: DependencyMap;
-    devDependencies?: DependencyMap;
-    peerDependencies?: DependencyMap;
+    dependencies?: Dependency;
+    devDependencies?: Dependency;
+    peerDependencies?: Dependency;
 }
 
 function getManifest(packageIdentifier?: string): PackageManifest {
@@ -32,6 +40,7 @@ function getManifest(packageIdentifier?: string): PackageManifest {
         ;
 
     let manifest: PackageManifest;
+
     try {
         manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
     } catch {
@@ -41,24 +50,22 @@ function getManifest(packageIdentifier?: string): PackageManifest {
     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.`);
+        throw new Error(`[scripts/build-bundle.ts] Failed to read entrypoints from package manifest: 'exports' field is missing.`);
 
     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.`);
+                throw new Error(`[scripts/build-bundle.ts] Failed to read entrypoints from package manifest: 'entrypoint' condition is missing for export '${key}'.`);
             return conditions.entrypoint;
         });
 
     return entrypoints;
 
 }
-
 function getPackageVersion(manifest: PackageManifest, packageIdentifier?: string): string {
 
     let version: string | undefined;
@@ -72,12 +79,12 @@ function getPackageVersion(manifest: PackageManifest, packageIdentifier?: string
 
         version = dependencies[packageIdentifier];
         if (!version)
-            throw new Error(`[scripts/build-bundle.ts] Package '${packageIdentifier}' is not listed in dependencies.`);
+            throw new Error(`[scripts/build-bundle.ts] Failed to read version for package '${packageIdentifier}': package is not listed in dependencies.`);
 
     }
     else {
         if (!manifest.version)
-            throw new Error('[scripts/build-bundle.ts] Package manifest does not contain a version field.');
+            throw new Error('[scripts/build-bundle.ts] Failed to read package version from manifest: version field is missing.');
         version = manifest.version;
     }
 
@@ -85,36 +92,52 @@ function getPackageVersion(manifest: PackageManifest, packageIdentifier?: string
 
 }
 
-function resolveCdnUrl(importSpecifier: string, urlTemplate: string): string {
-    if (urlTemplate.includes('<VERSION>')) {
+function resolveVersionInCdnUrl(importSpecifier: string, cdnUrl: string): string {
+    if (cdnUrl.includes('<VERSION>')) {
         const manifest = getManifest();
         const version = getPackageVersion(manifest, importSpecifier);
         let resolvedVersion = version;
         if (resolvedVersion.startsWith('workspace:')) resolvedVersion = resolvedVersion.replace(/^workspace:/, '');
         if (resolvedVersion.startsWith('^') || resolvedVersion.startsWith('~')) resolvedVersion = resolvedVersion.substring(1);
-        if (resolvedVersion.length !== 0)
-            return urlTemplate.replace('<VERSION>', resolvedVersion);
+        if (resolvedVersion.length === 0)
+            throw new Error(`[scripts/build-bundle.ts] Failed to resolve version for package '${importSpecifier}': resolved version is empty.`);
+        return cdnUrl.replace('<VERSION>', resolvedVersion);
     }
-    return urlTemplate;
+    return cdnUrl;
 }
 
-const cdnRewritePlugin = {
+const esbuildLog: EsbuildPlugin = {
+    name: 'esbuild-log',
+    setup(build: PluginBuild) {
+        const format = build.initialOptions.format || 'unknown';
+        build.onStart(() => {
+            console.log(`[esbuild-log plugin] ${format} build started...`);
+        });
+        build.onEnd((result: BuildResult<BuildOptions>) => {
+            if (result.errors.length > 0) {
+                console.error(`[esbuild-log plugin] ${format} build failed.`);
+            } else {
+                console.log(`[esbuild-log plugin] ${format} build finished.`);
+            }
+        });
+    }
+}
+const cdnRewrite: EsbuildPlugin = {
     name: 'cdn-rewrite',
-    setup(build: any) {
+    setup(build: PluginBuild) {
 
-        const resolved: Record<string, string> = {};
         for (const [importSpecifier, urlTemplate] of Object.entries(CDN_REWRITE_MAP) as [string, string][]) {
 
-            const url = resolveCdnUrl(importSpecifier, urlTemplate);
-            resolved[importSpecifier] = url;
+            const url = resolveVersionInCdnUrl(importSpecifier, urlTemplate);
+            console.log(`[cdn-rewrite plugin] '${importSpecifier}' → '${url}'`);
 
             const escapedSpecifier = importSpecifier.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-            console.log(`[cdn-rewrite] '${importSpecifier}' → '${url}'`);
-
-            build.onResolve({ filter: new RegExp(`^${escapedSpecifier}$`) }, (args: any) => {
-                const url = resolved[args.path];
-                if (url) return { path: url, external: true };
-            });
+            build.onResolve(
+                { filter: new RegExp(`^${escapedSpecifier}$`) },
+                (args: OnResolveArgs): OnResolveResult | undefined => {
+                    return { path: url, external: true };
+                }
+            );
 
         }
 
@@ -125,50 +148,44 @@ const cdnRewritePlugin = {
 const entrypoints = getManifestEntrypoints(getManifest());
 console.log('[scripts/build-bundle.ts] Entrypoints:', entrypoints);
 
-const omitIife = process.argv.includes('--omit-iife');
-
-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',
+const buildOptions: BuildOptions = {
+    entryPoints: entrypoints,
+    outdir: 'dist/',
+    entryNames: '[dir]/[name].bundle',
+    platform: 'browser',
     format: 'esm',
+    bundle: true,
     minify: true,
     sourcemap: 'external',
-    plugins: [cdnRewritePlugin],
-});
+    plugins: [esbuildLog, cdnRewrite],
 
-if (!buildResult.success) {
+};
+
+try {
+    await build(buildOptions);
+} catch (error) {
     console.error('[scripts/build-bundle.ts] Build failed:');
-    for (const message of buildResult.logs) {
+    for (const message of (error as BuildFailure).errors) {
         console.error(message);
     }
     process.exit(1);
 }
-console.log('[scripts/build-bundle.ts] ESM bundle build completed successfully.');
 
+const omitIife = process.argv.includes('--omit-iife');
 if (!omitIife) {
-    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) {
+    try {
+        await build({
+            ...buildOptions,
+            entryNames: '[dir]/[name].iife.bundle',
+            format: 'iife',
+            banner: { js: 'var __importMetaUrl = document.currentScript && document.currentScript.src || \'\';' },
+            define: { 'import.meta.url': '__importMetaUrl' },
+        });
+    } catch (error) {
         console.error('[scripts/build-bundle.ts] Build failed:');
-        for (const message of buildResult.logs) {
+        for (const message of (error as BuildFailure).errors) {
             console.error(message);
         }
         process.exit(1);
     }
-    console.log('[scripts/build-bundle.ts] IIFE bundle build completed successfully.');
 }

package/template/README.md

@@ -16,25 +16,21 @@
 
 ```bash
 # placeholder:
-    # <TEMPLATE_PACKAGE: <TEMPLATE_PACKAGE>
-    # <TEMPLATE_NAME: <TEMPLATE_NAME>
     # <NEW_PACKAGE: <NEW_PACKAGE>
-      # is used as:
-      #   - the path where the package is created
-      #   - the "name" field in the generated package.json
-    # <@_VERSION: <@_VERSION>
+    # <TEMPLATE_PACKAGE_NAME: <TEMPLATE_PACKAGE_NAME>
+    # <TEMPLATE_NAME: <TEMPLATE_NAME>
+
+mkdir -p <NEW_PACKAGE>
+cd <NEW_PACKAGE>
 
-# pinned version
-bun info "<TEMPLATE_PACKAGE>" version
-bun create --no-install --no-git "<TEMPLATE_NAME><@_VERSION>" <NEW_PACKAGE>
+# print the latest version
+bun info "<TEMPLATE_PACKAGE_NAME>" version
 
-# latest
-# clear the cache to pick up the latest version
-bun pm cache rm
-bun create --no-install --no-git "<TEMPLATE_NAME>" <NEW_PACKAGE>
+# create/update a package from the template in the current directory
+bun create --no-install --no-git "<TEMPLATE_NAME>@latest" .
+
+# set metadata in package.json
 
-# templates only copy files, run install and any setup scripts manually
-cd <NEW_PACKAGE>
 bun install
 ```
 

package/template/package.json

@@ -6,7 +6,6 @@
   "license": "",
   "keywords": [
     "typescript",
-    "bun",
     "template"
   ],
   "repository": {
@@ -38,10 +37,12 @@
     "tests": "bun test",
     "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"
+    "build:cli-bundle": "esbuild src/cli.ts --outdir=dist --entry-names=[dir]/[name].bundle --platform=node --format=esm --bundle --minify --sourcemap=external"
   },
   "devDependencies": {
     "@types/bun": "latest",
+    "@types/node": "latest",
+    "esbuild": "latest",
     "typescript": "^6.0.3"
   }
 }

package/template/scripts/build-bundle.ts

@@ -1,5 +1,15 @@
 import { readFileSync } from 'fs';
 import { join } from 'path';
+import {
+    build,
+    type BuildFailure,
+    type OnResolveArgs,
+    type OnResolveResult,
+    type Plugin as EsbuildPlugin,
+    type PluginBuild,
+    type BuildOptions,
+    type BuildResult
+} from 'esbuild';
 
 import CDN_REWRITE_MAP from './cdn-rewrite-map.json';
 
@@ -11,17 +21,15 @@ interface ExportConditions {
     browser?: string;
     import?: string;
 }
-
-interface DependencyMap {
+interface Dependency {
     [key: string]: string;
 }
-
 interface PackageManifest {
     version: string;
     exports?: Record<string, ExportConditions>;
-    dependencies?: DependencyMap;
-    devDependencies?: DependencyMap;
-    peerDependencies?: DependencyMap;
+    dependencies?: Dependency;
+    devDependencies?: Dependency;
+    peerDependencies?: Dependency;
 }
 
 function getManifest(packageIdentifier?: string): PackageManifest {
@@ -32,6 +40,7 @@ function getManifest(packageIdentifier?: string): PackageManifest {
         ;
 
     let manifest: PackageManifest;
+
     try {
         manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
     } catch {
@@ -41,24 +50,22 @@ function getManifest(packageIdentifier?: string): PackageManifest {
     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.`);
+        throw new Error(`[scripts/build-bundle.ts] Failed to read entrypoints from package manifest: 'exports' field is missing.`);
 
     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.`);
+                throw new Error(`[scripts/build-bundle.ts] Failed to read entrypoints from package manifest: 'entrypoint' condition is missing for export '${key}'.`);
             return conditions.entrypoint;
         });
 
     return entrypoints;
 
 }
-
 function getPackageVersion(manifest: PackageManifest, packageIdentifier?: string): string {
 
     let version: string | undefined;
@@ -72,12 +79,12 @@ function getPackageVersion(manifest: PackageManifest, packageIdentifier?: string
 
         version = dependencies[packageIdentifier];
         if (!version)
-            throw new Error(`[scripts/build-bundle.ts] Package '${packageIdentifier}' is not listed in dependencies.`);
+            throw new Error(`[scripts/build-bundle.ts] Failed to read version for package '${packageIdentifier}': package is not listed in dependencies.`);
 
     }
     else {
         if (!manifest.version)
-            throw new Error('[scripts/build-bundle.ts] Package manifest does not contain a version field.');
+            throw new Error('[scripts/build-bundle.ts] Failed to read package version from manifest: version field is missing.');
         version = manifest.version;
     }
 
@@ -85,36 +92,52 @@ function getPackageVersion(manifest: PackageManifest, packageIdentifier?: string
 
 }
 
-function resolveCdnUrl(importSpecifier: string, urlTemplate: string): string {
-    if (urlTemplate.includes('<VERSION>')) {
+function resolveVersionInCdnUrl(importSpecifier: string, cdnUrl: string): string {
+    if (cdnUrl.includes('<VERSION>')) {
         const manifest = getManifest();
         const version = getPackageVersion(manifest, importSpecifier);
         let resolvedVersion = version;
         if (resolvedVersion.startsWith('workspace:')) resolvedVersion = resolvedVersion.replace(/^workspace:/, '');
         if (resolvedVersion.startsWith('^') || resolvedVersion.startsWith('~')) resolvedVersion = resolvedVersion.substring(1);
-        if (resolvedVersion.length !== 0)
-            return urlTemplate.replace('<VERSION>', resolvedVersion);
+        if (resolvedVersion.length === 0)
+            throw new Error(`[scripts/build-bundle.ts] Failed to resolve version for package '${importSpecifier}': resolved version is empty.`);
+        return cdnUrl.replace('<VERSION>', resolvedVersion);
     }
-    return urlTemplate;
+    return cdnUrl;
 }
 
-const cdnRewritePlugin = {
+const esbuildLog: EsbuildPlugin = {
+    name: 'esbuild-log',
+    setup(build: PluginBuild) {
+        const format = build.initialOptions.format || 'unknown';
+        build.onStart(() => {
+            console.log(`[esbuild-log plugin] ${format} build started...`);
+        });
+        build.onEnd((result: BuildResult<BuildOptions>) => {
+            if (result.errors.length > 0) {
+                console.error(`[esbuild-log plugin] ${format} build failed.`);
+            } else {
+                console.log(`[esbuild-log plugin] ${format} build finished.`);
+            }
+        });
+    }
+}
+const cdnRewrite: EsbuildPlugin = {
     name: 'cdn-rewrite',
-    setup(build: any) {
+    setup(build: PluginBuild) {
 
-        const resolved: Record<string, string> = {};
         for (const [importSpecifier, urlTemplate] of Object.entries(CDN_REWRITE_MAP) as [string, string][]) {
 
-            const url = resolveCdnUrl(importSpecifier, urlTemplate);
-            resolved[importSpecifier] = url;
+            const url = resolveVersionInCdnUrl(importSpecifier, urlTemplate);
+            console.log(`[cdn-rewrite plugin] '${importSpecifier}' → '${url}'`);
 
             const escapedSpecifier = importSpecifier.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-            console.log(`[cdn-rewrite] '${importSpecifier}' → '${url}'`);
-
-            build.onResolve({ filter: new RegExp(`^${escapedSpecifier}$`) }, (args: any) => {
-                const url = resolved[args.path];
-                if (url) return { path: url, external: true };
-            });
+            build.onResolve(
+                { filter: new RegExp(`^${escapedSpecifier}$`) },
+                (args: OnResolveArgs): OnResolveResult | undefined => {
+                    return { path: url, external: true };
+                }
+            );
 
         }
 
@@ -125,50 +148,44 @@ const cdnRewritePlugin = {
 const entrypoints = getManifestEntrypoints(getManifest());
 console.log('[scripts/build-bundle.ts] Entrypoints:', entrypoints);
 
-const omitIife = process.argv.includes('--omit-iife');
-
-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',
+const buildOptions: BuildOptions = {
+    entryPoints: entrypoints,
+    outdir: 'dist/',
+    entryNames: '[dir]/[name].bundle',
+    platform: 'browser',
     format: 'esm',
+    bundle: true,
     minify: true,
     sourcemap: 'external',
-    plugins: [cdnRewritePlugin],
-});
+    plugins: [esbuildLog, cdnRewrite],
 
-if (!buildResult.success) {
+};
+
+try {
+    await build(buildOptions);
+} catch (error) {
     console.error('[scripts/build-bundle.ts] Build failed:');
-    for (const message of buildResult.logs) {
+    for (const message of (error as BuildFailure).errors) {
         console.error(message);
     }
     process.exit(1);
 }
-console.log('[scripts/build-bundle.ts] ESM bundle build completed successfully.');
 
+const omitIife = process.argv.includes('--omit-iife');
 if (!omitIife) {
-    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) {
+    try {
+        await build({
+            ...buildOptions,
+            entryNames: '[dir]/[name].iife.bundle',
+            format: 'iife',
+            banner: { js: 'var __importMetaUrl = document.currentScript && document.currentScript.src || \'\';' },
+            define: { 'import.meta.url': '__importMetaUrl' },
+        });
+    } catch (error) {
         console.error('[scripts/build-bundle.ts] Build failed:');
-        for (const message of buildResult.logs) {
+        for (const message of (error as BuildFailure).errors) {
             console.error(message);
         }
         process.exit(1);
     }
-    console.log('[scripts/build-bundle.ts] IIFE bundle build completed successfully.');
 }

package/template/tests/buildinfo.test.ts

@@ -1,3 +1,4 @@
+/// <reference types="bun" />
 import { describe, it, expect } from 'bun:test';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';

package/template/tsconfig.json

@@ -17,7 +17,7 @@
     "composite": true,
     "skipLibCheck": true,
     "types": [
-      "bun"
+      "node"
     ],
     "forceConsistentCasingInFileNames": true,
     "resolveJsonModule": true