@temir.ra/create-ts-lib 0.6.3 → 0.7.1

package/template/README.md

@@ -14,31 +14,25 @@
 
 # Quick Start
 
-```bash
-# remove dist/ and tsconfig.tsbuildinfo and tsconfig.build.tsbuildinfo
-bun run clean
+*<QUICK START INSTRUCTIONS>*
 
-# remove dist/ only
-bun run clean:dist
+# Documentation
 
-# remove tsconfig.tsbuildinfo and tsconfig.build.tsbuildinfo only
-bun run clean:tsbuildinfo
+*<DOCUMENTATION>*
 
-# compile + bundle
-bun run build
+# DevOps
+
+```bash
+bun install
 
-# run tests
+bun run clean
+bun run build
 bun run tests
 
-# run src/dev.ts in watch mode
 bun run dev
-```
-
-# Documentation
 
-*<DOCUMENTATION>*
-
-# DevOps
+# see publish section for publish instructions
+```
 
 ## Change Management
 
@@ -47,7 +41,7 @@ bun run dev
 3. Bump the version in [`package.json`](package.json).
 4. Add an entry for the new version in [`CHANGELOG.md`](CHANGELOG.md).
 5. Pull request the branch.
-6. After merge, run `bun run build` - ensures artifacts are current before publish.
+6. Ensure package artifacts are current.
 7. Publish.
 
 ## Publish

package/template/buildinfo-template.txt

@@ -0,0 +1 @@
+0.4.1+f472194

package/template/buildinfo.txt

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

package/template/gitignore

@@ -1,7 +1,7 @@
-dist
 node_modules
 buildinfo.txt
-*.tsbuildinfo
 buildinfo-template.txt
 CHANGELOG-template.md
 README-template.md
+*.tsbuildinfo
+dist

package/template/package.json

@@ -11,6 +11,7 @@
     "type": "git",
     "url": ""
   },
+  "private": false,
   "type": "module",
   "exports": {
     ".": {
@@ -24,21 +25,24 @@
     "#src/*.js": "./src/*.ts"
   },
   "files": [
-    "dist",
+    "scripts/buildinfo.ts",
+    "scripts/build-bundle.ts",
+    "scripts/cdn-rewrite-map.json",
     "CHANGELOG.md",
-    "buildinfo.txt"
+    "buildinfo.txt",
+    "dist"
   ],
   "scripts": {
+    "reinstall": "rm -rf node_modules && rm -f bun.lock && bun pm cache rm && bun install && bunx tsc --version",
+    "typecheck": "tsc --noEmit",
+    "buildinfo": "bun run scripts/buildinfo.ts",
     "clean:dist": "rm -rf dist/",
-    "clean:tsbuildinfo": "rm -f tsconfig.tsbuildinfo tsconfig.build.tsbuildinfo",
+    "clean:tsbuildinfo": "rm -f *.tsbuildinfo || true",
     "clean": "bun run clean:dist && bun run clean:tsbuildinfo",
-    "prebuild": "bun run scripts/buildinfo.ts",
     "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"
+    "prebuild": "bun run buildinfo",
+    "build": "bun run build:bundle",
+    "build:bundle": "bun run scripts/build-bundle.ts"
   },
   "devDependencies": {
     "@types/bun": "latest",

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/{src → scripts}/dev.ts

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

package/template/tsconfig.json

@@ -1,39 +1,38 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "lib": [
-      "ESNext",
-      "DOM"
-    ],
-    "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": [
-    "src/**/*.ts",
-    "tests/**/*.ts",
-    "scripts/**/*.ts",
-    "scripts/**/*.json"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
+{
+  "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": [
+    "scripts/**/*.ts",
+    "scripts/**/*.json",
+    "src/**/*.ts",
+    "tests/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
 }

package/dist/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-import { cpSync, readFileSync, renameSync, writeFileSync } from 'fs';
-import { resolve } from 'path';
-import { templatePath, changelogPath, buildinfoPath, readmePath } from './constants.js';
-try {
-    const packageNameArgument = process.argv[2];
-    if (!packageNameArgument)
-        throw new Error('Package name argument is required. Usage: `create-ts-lib <package-name>`');
-    const packageName = packageNameArgument.replace(/\\/g, '/');
-    const destinationPath = resolve(process.cwd(), packageName);
-    cpSync(templatePath, destinationPath, { recursive: true });
-    cpSync(changelogPath, resolve(destinationPath, 'CHANGELOG-template.md'));
-    cpSync(buildinfoPath, resolve(destinationPath, 'buildinfo-template.txt'));
-    cpSync(readmePath, resolve(destinationPath, 'README-template.md'));
-    const packageJsonPath = resolve(destinationPath, 'package.json');
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-    packageJson.name = packageName;
-    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
-    renameSync(resolve(destinationPath, 'gitignore'), resolve(destinationPath, '.gitignore'));
-    console.log(`Template has been successfully instantiated at '${destinationPath}' with package name '${packageName}'.`);
-}
-catch (error) {
-    const err = error instanceof Error ? error : new Error(String(error));
-    console.error('Error:', err.message);
-    process.exit(1);
-}

package/dist/constants.d.ts

@@ -1,7 +0,0 @@
-export declare const packageUrl: URL;
-export declare const packagePath: string;
-export declare const templatePath: string;
-export declare const changelogPath: string;
-export declare const buildinfoPath: string;
-export declare const readmePath: string;
-//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,EAAE,GAAqC,CAAC;AAC/D,eAAO,MAAM,WAAW,EAAE,MAA2C,CAAC;AAEtE,eAAO,MAAM,YAAY,EAAE,MAA0C,CAAC;AAEtE,eAAO,MAAM,aAAa,EAAE,MAA6C,CAAC;AAC1E,eAAO,MAAM,aAAa,EAAE,MAA8C,CAAC;AAC3E,eAAO,MAAM,UAAU,EAAE,MAA0C,CAAC"}

package/dist/constants.js

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

package/template/tsconfig.build.json

@@ -1,19 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "rootDir": "./src",
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "emitDeclarationOnly": false,
-  },
-  "include": [
-    "src/**/*.ts"
-  ],
-  "exclude": [
-    "src/dev.ts",
-    "node_modules",
-    "dist",
-    "tests",
-    "scripts"
-  ]
-}