@temir.ra/create-ts-lib 0.8.4 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Version 0
 
+## 0.9.0
+
+1. Switched to `esbuild` for bundling.
+2. Switched to `@types/node` for type definitions.
+3. Updated documentation to reflect the `esbuild` and `@types/node` changes.
+4. Synced with `template@0.2.0-pre.5` template.
+
 ## 0.8.4
 
 1. Fixed CDN rewrite plugin filter.

package/README.md

@@ -27,25 +27,22 @@ A template for TypeScript libraries distributed via npm-compatible registries. P
 
 ```bash
 # placeholder:
-    # <TEMPLATE_PACKAGE: @temir.ra/create-ts-lib
-    # <TEMPLATE_NAME: @temir.ra/ts-lib
     # <NEW_PACKAGE: <NEW_PACKAGE>
-      # is used as:
-      #   - the path where the package is created
-      #   - the "name" field in the generated package.json
-    # <@_VERSION: <@_VERSION>
+    # <TEMPLATE_PACKAGE_NAME: @temir.ra/create-ts-lib
+    # <TEMPLATE_NAME: @temir.ra/ts-lib
+
+mkdir -p <NEW_PACKAGE>
+cd <NEW_PACKAGE>
 
-# pinned version
+# print the latest version
 bun info "@temir.ra/create-ts-lib" version
-bun create --no-install --no-git "@temir.ra/ts-lib<@_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/ts-lib" <NEW_PACKAGE>
+# create/update a package from the template in the current directory
+# clear the package manager cache to pick up the latest version when not pinning a specific version
+bun create --no-install --no-git "@temir.ra/ts-lib" .
+
+# set metadata in package.json
 
-# templates only copy files, run install and any setup scripts manually
-cd <NEW_PACKAGE>
 bun install
 ```
 
@@ -53,22 +50,18 @@ bun install
 
 The following sections explain the configurations and conventions baked into the generated package. Useful when adapting it to fit specific needs.
 
-The central addition over [`create-workspace`](https://www.npmjs.com/package/@temir.ra/create-workspace) is a build pipeline for distributing the library. Two build strategies are supported:
+The major addition compared to the [`workspace` template](https://www.npmjs.com/package/@temir.ra/create-workspace) is a build pipeline for distributing the library. Two build strategies are supported:
 
-- **Bundling** (`scripts/build-bundle.ts`) - generated by default; bundles the library to ESM and IIFE formats.
-- **TSC compilation** (`tsconfig.build.json` + `build:tsc`) - optional, not generated by default; compiles source files one-for-one to ESM JavaScript and declaration files.
+- **Bundling** (`scripts/build-bundle.ts`) - bundles the library to ESM and IIFE formats using [`esbuild`](https://esbuild.github.io/).
+- **TSC compilation** (`tsconfig.build.json` + `build:tsc`) - compiles the library to declaration files and ESM JavaScript using [`tsc`](https://www.typescriptlang.org/docs/handbook/compiler-options.html).
 
 Both strategies can be combined.
 
 ## `package.json`
 
-Selected fields are documented in the [`create-workspace` README](https://www.npmjs.com/package/@temir.ra/create-workspace#packagejson).
-
-See npmjs documentation on [package.json](https://docs.npmjs.com/cli/v11/configuring-npm/package-json) for detailed explanations of all fields.
+Selected fields are documented in the [`workspace` template README](https://www.npmjs.com/package/@temir.ra/create-workspace#packagejson).
 
-The following lists the additions and overrides relative to [`create-workspace`](https://www.npmjs.com/package/@temir.ra/create-workspace#packagejson).
-
-The generated package is pre-configured with `build:bundle` only. See [TSC Compilation](#tsc-compilation) and [`"bin"` field](#bin-field-in-packagejson) for extending it.
+The following fields are specific to this template:
 
 ```json
 {
@@ -150,8 +143,15 @@ The generated package is pre-configured with `build:bundle` only. See [TSC Compi
     "build:tsc": "tsc --project tsconfig.build.json",
 
     // bundles the CLI into a single file for distribution; requires the "bin" field to be set to the bundled output
-    "build:cli-bundle": "bun build src/cli.ts --entry-naming \"[dir]/[name].bundle.[ext]\" --outdir dist --target node --format esm --minify --sourcemap=external"
+    "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"
   }
 
 }
@@ -159,9 +159,11 @@ The generated package is pre-configured with `build:bundle` only. See [TSC Compi
 
 It is highly recommended to include `tests/` in the `files` field. Note, that `tests/` is not included by default in the generated `package.json`.
 
+`"@types/bun": "latest"` is required to run tests.
+
 ## Script `scripts/build-bundle.ts`
 
-Bundles the library to ESM and IIFE formats. Entry points are resolved from the `entrypoint` condition in the `exports` field of `package.json`. Note, the `entrypoint` condition is a custom, non-standard export condition used solely for build tooling.
+Bundles the library to ESM and IIFE formats using `esbuild`. Entry points are resolved from the `entrypoint` condition in the `exports` field of `package.json`. Note, the `entrypoint` condition is a custom, non-standard export condition used solely for build tooling.
 
 Import specifiers can be rewritten to CDN URLs via `scripts/cdn-rewrite-map.json`.
 
@@ -181,7 +183,7 @@ Maps import specifiers to CDN URLs. During bundling, matching specifiers in sour
 
 `tsconfig.json` provided by [`workspace` template](https://www.npmjs.com/package/@temir.ra/create-workspace) is intended for development only. `tsconfig.build.json` extends it with settings for compiling the source files for distribution.
 
-See [`create-workspace` README](https://www.npmjs.com/package/@temir.ra/create-workspace#tsconfigjson) and [tsconfig.json](https://www.typescriptlang.org/tsconfig) for detailed explanations of all options.
+See [`workspace` template README](https://www.npmjs.com/package/@temir.ra/create-workspace#tsconfigjson) and [tsconfig.json](https://www.typescriptlang.org/tsconfig) for detailed explanations of all options.
 
 ```json
 {
@@ -360,6 +362,8 @@ const asset = await readFile(assetPath);
 
 The generated `./src/constants.ts` scaffolds the isomorphic approach and `./constants` is configured as an additional entry point in `package.json` for direct imports:
 
+⚠️ Beware that `import.meta.url` is replaced by `document.currentScript.src` during bundling in IIFE format since it is available only under ESM (research "import.meta vs document.currentScript.src").
+
 ```json
 {
   // ... ,

package/buildinfo.txt

@@ -1 +1 @@
-0.8.4+c28f38b
+0.9.0+1a97fac

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,12 +1,11 @@
 {
   "name": "@temir.ra/create-ts-lib",
-  "version": "0.8.4",
+  "version": "0.9.0",
   "description": "A template for a distributable TypeScript library package.",
   "author": "temir.ra",
   "license": "MIT",
   "keywords": [
     "typescript",
-    "bun",
     "template",
     "library"
   ],
@@ -39,10 +38,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/package.json

@@ -5,8 +5,7 @@
   "author": "",
   "license": "",
   "keywords": [
-    "typescript",
-    "bun"
+    "typescript"
   ],
   "repository": {
     "type": "git",
@@ -54,6 +53,8 @@
   },
   "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