@temir.ra/create-template 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Version 0
+
+## 0.1.0
+
+1. First published version.
+
+## 0.0.0
+
+1. Package created.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Temir Ra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# Introduction
+
+*<INTRO TEXT>*
+
+## Table of Contents
+
+1. [Quick Start](#quick-start)
+2. [Documentation](#documentation)
+3. [DevOps](#devops)
+    1. [Change Management](#change-management)
+    2. [Publish](#publish)
+
+# Quick Start
+
+```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>
+
+# pinned 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>
+
+# templates only copy files, run install and any setup scripts manually
+cd <NEW_PACKAGE>
+bun install
+```
+
+# Documentation
+
+*&lt;DOCUMENTATION&gt;*
+
+# DevOps
+
+## Change Management
+
+1. Create a new branch for the change.
+2. Make the changes and commit.
+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. Ensure package artifacts are current.
+7. Publish.
+
+## Publish
+
+Publish to the public npm registry.
+
+```powershell
+# authenticate
+npm login
+# publish
+bun publish --registry https://registry.npmjs.org/ --access public
+```

package/buildinfo.txt

@@ -0,0 +1 @@
+0.1.0+4727289

package/dist/cli.bundle.js

@@ -0,0 +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('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=C4A0E6EEF1219B4364756E2164756E21

package/dist/cli.bundle.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["..\\src\\cli.ts", "..\\src\\constants.ts"],
+  "sourcesContent": [
+    "#!/usr/bin/env node\r\n\r\nimport { cpSync, readFileSync, renameSync, writeFileSync } from 'fs';\r\nimport { resolve } from 'path';\r\nimport {\r\n    templatePath,\r\n    changelogPath,\r\n    buildinfoPath,\r\n    readmePath\r\n} from './constants.js';\r\n\r\n\r\ntry {\r\n\r\n    const packageNameArgument = process.argv[2];\r\n    if (!packageNameArgument)\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,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

@@ -0,0 +1,45 @@
+{
+  "name": "@temir.ra/create-template",
+  "version": "0.1.0",
+  "description": "Template package to create new template packages",
+  "author": "temir.ra",
+  "license": "MIT",
+  "keywords": [
+    "typescript",
+    "template",
+    "bun"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://git.chimps.quest/trs/create-template.git"
+  },
+  "private": false,
+  "type": "module",
+  "imports": {
+    "#src/*.js": "./src/*.ts"
+  },
+  "bin": "./dist/cli.bundle.js",
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "buildinfo.txt",
+    "template"
+  ],
+  "scripts": {
+    "clean:dist": "rm -rf dist/",
+    "clean:tsbuildinfo": "rm -f *.tsbuildinfo || true",
+    "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
+    "buildinfo": "bun run scripts/buildinfo.ts",
+    "tests": "bun test",
+    "typecheck": "tsc --noEmit",
+    "reinstall": "rm -rf node_modules && rm -f bun.lock && bun pm cache rm && bun install && bunx tsc --version",
+    "dev": "bun run buildinfo && bun run --watch scripts/dev.ts",
+    "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",
+    "typescript": "^6.0.2"
+  }
+}

package/template/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Version 0
+
+## 0.0.0
+
+1. Package created.

package/template/README.md

@@ -0,0 +1,98 @@
+# Introduction
+
+*<INTRO TEXT>*
+
+## Table of Contents
+
+1. [Quick Start](#quick-start)
+2. [Documentation](#documentation)
+3. [DevOps](#devops)
+    1. [Change Management](#change-management)
+    2. [Publish](#publish)
+        1. [npmjs.org](#npmjsorg)
+        2. [Custom registry](#custom-registry)
+
+# Quick Start
+
+```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>
+
+# pinned version
+bun info "<TEMPLATE_PACKAGE>" version
+bun create --no-install --no-git "<TEMPLATE_NAME><@_VERSION>" <NEW_PACKAGE>
+
+# latest
+# clear the cache to pick up the latest version
+bun pm cache rm
+bun create --no-install --no-git "<TEMPLATE_NAME>" <NEW_PACKAGE>
+
+# templates only copy files, run install and any setup scripts manually
+cd <NEW_PACKAGE>
+bun install
+```
+
+# Documentation
+
+*&lt;DOCUMENTATION&gt;*
+
+# DevOps
+
+## Change Management
+
+1. Create a new branch for the change.
+2. Make the changes and commit.
+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. Ensure package artifacts are current.
+7. Publish.
+
+## Publish
+
+See the following sources to configure the target registry and authentication.
+
+- [Configuring npm - `npmrc`](https://docs.npmjs.com/cli/v10/configuring-npm/npmrc)
+- [Bun package manager - `install.registry`](https://bun.com/docs/runtime/bunfig#install-scopes)
+
+⚠️ Package Scope and the authentication for the target registry must be aligned.
+
+### `npmjs.org`
+
+Publish to the public npm registry.
+
+```powershell
+# authenticate
+npm login
+# publish
+bun publish --registry https://registry.npmjs.org/ --access public
+```
+
+### Custom registry
+
+```bash
+# placeholder:
+  # <SCOPE_WITHOUT_AT: <SCOPE_WITHOUT_AT>
+  # <REGISTRY_URL: <REGISTRY_URL>
+  # <BUN_PUBLISH_AUTH_TOKEN: <BUN_PUBLISH_AUTH_TOKEN>
+```
+
+`~/.bunfig.toml` or `bunfig.toml`:
+
+```toml
+[install.scopes]
+"<SCOPE_WITHOUT_AT>" = { url = "<REGISTRY_URL>", token = "$BUN_PUBLISH_AUTH_TOKEN" }
+```
+
+```powershell
+# authenticate
+$env:BUN_PUBLISH_AUTH_TOKEN = "<BUN_PUBLISH_AUTH_TOKEN>"
+# publish
+bun publish
+```

package/template/buildinfo.txt

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

package/template/gitignore

@@ -0,0 +1,9 @@
+node_modules
+buildinfo.txt
+*.tsbuildinfo
+buildinfo-template.txt
+CHANGELOG-template.md
+README-template.md
+dist
+example/
+bun.lock

package/template/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "",
+  "version": "0.0.0",
+  "description": "",
+  "author": "",
+  "license": "",
+  "keywords": [
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "private": true,
+  "type": "module",
+  "imports": {
+    "#src/*.js": "./src/*.ts"
+  },
+  "bin": "./dist/cli.bundle.js",
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "buildinfo.txt",
+    "template"
+  ],
+  "scripts": {
+    "clean:dist": "rm -rf dist/",
+    "clean:tsbuildinfo": "rm -f *.tsbuildinfo || true",
+    "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
+    "buildinfo": "bun run scripts/buildinfo.ts",
+    "tests": "bun test",
+    "typecheck": "tsc --noEmit",
+    "reinstall": "rm -rf node_modules && rm -f bun.lock && bun pm cache rm && bun install && bunx tsc --version",
+    "dev": "bun run buildinfo && bun run --watch scripts/dev.ts",
+    "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",
+    "typescript": "^6.0.2"
+  }
+}

package/template/scripts/build-bundle.ts

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

package/template/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/template/scripts/cdn-rewrite-map.json

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

package/template/scripts/dev.ts

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

package/template/src/cli.ts

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+import { cpSync, readFileSync, renameSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+import {
+    templatePath,
+    changelogPath,
+    buildinfoPath,
+    readmePath
+} from './constants.js';
+
+
+try {
+
+    const packageNameArgument = process.argv[2];
+    if (!packageNameArgument)
+        throw new Error('First argument must be the package name (e.g. "my-package" or "@my-scope/my-package").');
+    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/template/src/constants.ts

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

package/template/tests/buildinfo.test.ts

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

package/template/tsconfig.json

@@ -0,0 +1,38 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "lib": [
+      "ESNext"
+    ],
+    "moduleResolution": "bundler",
+    "strict": true,
+    "verbatimModuleSyntax": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitOverride": true,
+    "isolatedDeclarations": true,
+    "esModuleInterop": true,
+    "composite": true,
+    "skipLibCheck": true,
+    "types": [
+      "bun"
+    ],
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "emitDeclarationOnly": true,
+    "outDir": "./dist"
+  },
+  "include": [
+    "tests/**/*.ts",
+    "scripts/**/*.ts",
+    "scripts/**/*.json",
+    "src/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}