@typeberry/lib 0.5.1-a4d7c93 → 0.5.1-eb84786

package/bin/lib/exports/workers-api.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Workers API and multi-threading utilities.
+ *
+ * This module provides the Workers API for parallel processing and multi-threading,
+ * enabling efficient utilization of system resources.
+ *
+ * @module workers-api
+ */
+export * from "#@typeberry/workers-api";
+//# sourceMappingURL=workers-api.d.ts.map

package/bin/lib/exports/workers-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers-api.d.ts","sourceRoot":"","sources":["../../../../../bin/lib/exports/workers-api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,wBAAwB,CAAC"}

package/bin/lib/exports/workers-api.js

@@ -0,0 +1,9 @@
+/**
+ * Workers API and multi-threading utilities.
+ *
+ * This module provides the Workers API for parallel processing and multi-threading,
+ * enabling efficient utilization of system resources.
+ *
+ * @module workers-api
+ */
+export * from "#@typeberry/workers-api";

package/bin/lib/index.d.ts

@@ -0,0 +1,34 @@
+export type { __REPRESENTATION_BYTES__, WithBytesRepresentation } from "#@typeberry/numbers";
+export type { __OPAQUE_TYPE__, TEST_COMPARE_USING, WithOpaque } from "#@typeberry/utils";
+export * as block from "./exports/block.js";
+export * as block_json from "./exports/block-json.js";
+export * as bytes from "./exports/bytes.js";
+export * as codec from "./exports/codec.js";
+export * as collections from "./exports/collections.js";
+export * as config from "./exports/config.js";
+export * as config_node from "./exports/config-node.js";
+export * as crypto from "./exports/crypto.js";
+export * as database from "./exports/database.js";
+export * as erasure_coding from "./exports/erasure-coding.js";
+export * as fuzz_proto from "./exports/fuzz-proto.js";
+export * as hash from "./exports/hash.js";
+export * as importer from "./exports/importer.js";
+export * as jam_host_calls from "./exports/jam-host-calls.js";
+export * as json_parser from "./exports/json-parser.js";
+export * as logger from "./exports/logger.js";
+export * as mmr from "./exports/mmr.js";
+export * as numbers from "./exports/numbers.js";
+export * as ordering from "./exports/ordering.js";
+export * as pvm_host_calls from "./exports/pvm-host-calls.js";
+export * as pvm_interface from "./exports/pvm-interface.js";
+export * as pvm_interpreter from "./exports/pvm-interpreter.js";
+export * as shuffling from "./exports/shuffling.js";
+export * as state from "./exports/state.js";
+export * as state_json from "./exports/state-json.js";
+export * as state_merkleization from "./exports/state-merkleization.js";
+export * as state_vectors from "./exports/state-vectors.js";
+export * as transition from "./exports/transition.js";
+export * as trie from "./exports/trie.js";
+export * as utils from "./exports/utils.js";
+export * as workers_api from "./exports/workers-api.js";
+//# sourceMappingURL=index.d.ts.map

package/bin/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../bin/lib/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAExF,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,QAAQ,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,cAAc,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,cAAc,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAC9C,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,cAAc,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,aAAa,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,eAAe,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,mBAAmB,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,aAAa,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAC"}

package/bin/lib/index.js

@@ -0,0 +1,31 @@
+export * as block from "./exports/block.js";
+export * as block_json from "./exports/block-json.js";
+export * as bytes from "./exports/bytes.js";
+export * as codec from "./exports/codec.js";
+export * as collections from "./exports/collections.js";
+export * as config from "./exports/config.js";
+export * as config_node from "./exports/config-node.js";
+export * as crypto from "./exports/crypto.js";
+export * as database from "./exports/database.js";
+export * as erasure_coding from "./exports/erasure-coding.js";
+export * as fuzz_proto from "./exports/fuzz-proto.js";
+export * as hash from "./exports/hash.js";
+export * as importer from "./exports/importer.js";
+export * as jam_host_calls from "./exports/jam-host-calls.js";
+export * as json_parser from "./exports/json-parser.js";
+export * as logger from "./exports/logger.js";
+export * as mmr from "./exports/mmr.js";
+export * as numbers from "./exports/numbers.js";
+export * as ordering from "./exports/ordering.js";
+export * as pvm_host_calls from "./exports/pvm-host-calls.js";
+export * as pvm_interface from "./exports/pvm-interface.js";
+export * as pvm_interpreter from "./exports/pvm-interpreter.js";
+export * as shuffling from "./exports/shuffling.js";
+export * as state from "./exports/state.js";
+export * as state_json from "./exports/state-json.js";
+export * as state_merkleization from "./exports/state-merkleization.js";
+export * as state_vectors from "./exports/state-vectors.js";
+export * as transition from "./exports/transition.js";
+export * as trie from "./exports/trie.js";
+export * as utils from "./exports/utils.js";
+export * as workers_api from "./exports/workers-api.js";

package/bin/lib/scripts/build-lib.d.ts

@@ -0,0 +1,64 @@
+#!/usr/bin/env tsx
+/**
+ * @typeberry/lib Build Script
+ *
+ * This script post-processes the TypeScript compilation output to create a distributable
+ * package using package.json "imports" field for internal package resolution.
+ *
+ * ## Build Process Overview
+ *
+ * 1. **TypeScript Compilation**
+ *    - First, `tsc` compiles all TypeScript files to JavaScript in `dist/lib/`
+ *    - This produces .js, .d.ts, and .d.ts.map files
+ *    - Imports remain as workspace references (e.g., `@typeberry/bytes`)
+ *
+ * 2. **Package Discovery**
+ *    - Reads the root package.json to discover all workspace packages
+ *    - Builds a map of package names to their filesystem paths
+ *    - Example: `@typeberry/bytes` → `packages/core/bytes`
+ *
+ * 3. **Import Rewriting**
+ *    - Recursively processes all .js and .d.ts files in dist/lib/
+ *    - Converts workspace imports to internal imports by prepending #:
+ *      - `@typeberry/bytes` → `#@typeberry/bytes`
+ *      - `@typeberry/pvm-interpreter/ops/math-consts.js` → `#@typeberry/pvm-interpreter/ops/math-consts.js`
+ *    - Preserves subpaths in imports (e.g., package/submodule)
+ *
+ * 4. **Package.json Generation**
+ *    - Copies bin/lib/package.json and transforms it for distribution:
+ *      - Updates `main` and `types` to point to `./bin/lib/index.js` and `./bin/lib/index.d.ts`
+ *      - Transforms `exports` to include both types and default fields
+ *      - Removes workspace dependencies
+ *      - Adds `imports` field to map `#<package-name>/*` to actual package locations
+ *
+ * 5. **Distribution Files**
+ *    - Copies README.md to dist/lib/
+ *    - Copies .npmignore to dist/lib/
+ *
+ * ## Why Package.json Imports?
+ *
+ * The compiled package uses the "imports" field because:
+ * - It provides a clean, maintainable way to handle internal package references
+ * - No need for complex relative path calculations
+ * - Node.js natively resolves these imports
+ * - Easier to understand and debug
+ *
+ * ## Output Structure
+ *
+ * ```
+ * dist/lib/
+ * ├── package.json       (with "imports" field mapping #<package-name>/* to paths)
+ * ├── README.md          (copied from bin/lib/)
+ * ├── .npmignore         (copied from bin/lib/)
+ * ├── bin/lib/           (compiled @typeberry/lib entry points)
+ * │   ├── index.js
+ * │   ├── index.d.ts
+ * │   └── exports/       (re-export files with # prefixed imports)
+ * └── packages/          (all compiled workspace packages)
+ *     ├── core/
+ *     ├── jam/
+ *     └── workers/
+ * ```
+ */
+export {};
+//# sourceMappingURL=build-lib.d.ts.map

package/bin/lib/scripts/build-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-lib.d.ts","sourceRoot":"","sources":["../../../../../bin/lib/scripts/build-lib.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG"}

package/bin/lib/scripts/build-lib.js

@@ -0,0 +1,392 @@
+#!/usr/bin/env tsx
+/**
+ * @typeberry/lib Build Script
+ *
+ * This script post-processes the TypeScript compilation output to create a distributable
+ * package using package.json "imports" field for internal package resolution.
+ *
+ * ## Build Process Overview
+ *
+ * 1. **TypeScript Compilation**
+ *    - First, `tsc` compiles all TypeScript files to JavaScript in `dist/lib/`
+ *    - This produces .js, .d.ts, and .d.ts.map files
+ *    - Imports remain as workspace references (e.g., `@typeberry/bytes`)
+ *
+ * 2. **Package Discovery**
+ *    - Reads the root package.json to discover all workspace packages
+ *    - Builds a map of package names to their filesystem paths
+ *    - Example: `@typeberry/bytes` → `packages/core/bytes`
+ *
+ * 3. **Import Rewriting**
+ *    - Recursively processes all .js and .d.ts files in dist/lib/
+ *    - Converts workspace imports to internal imports by prepending #:
+ *      - `@typeberry/bytes` → `#@typeberry/bytes`
+ *      - `@typeberry/pvm-interpreter/ops/math-consts.js` → `#@typeberry/pvm-interpreter/ops/math-consts.js`
+ *    - Preserves subpaths in imports (e.g., package/submodule)
+ *
+ * 4. **Package.json Generation**
+ *    - Copies bin/lib/package.json and transforms it for distribution:
+ *      - Updates `main` and `types` to point to `./bin/lib/index.js` and `./bin/lib/index.d.ts`
+ *      - Transforms `exports` to include both types and default fields
+ *      - Removes workspace dependencies
+ *      - Adds `imports` field to map `#<package-name>/*` to actual package locations
+ *
+ * 5. **Distribution Files**
+ *    - Copies README.md to dist/lib/
+ *    - Copies .npmignore to dist/lib/
+ *
+ * ## Why Package.json Imports?
+ *
+ * The compiled package uses the "imports" field because:
+ * - It provides a clean, maintainable way to handle internal package references
+ * - No need for complex relative path calculations
+ * - Node.js natively resolves these imports
+ * - Easier to understand and debug
+ *
+ * ## Output Structure
+ *
+ * ```
+ * dist/lib/
+ * ├── package.json       (with "imports" field mapping #<package-name>/* to paths)
+ * ├── README.md          (copied from bin/lib/)
+ * ├── .npmignore         (copied from bin/lib/)
+ * ├── bin/lib/           (compiled @typeberry/lib entry points)
+ * │   ├── index.js
+ * │   ├── index.d.ts
+ * │   └── exports/       (re-export files with # prefixed imports)
+ * └── packages/          (all compiled workspace packages)
+ *     ├── core/
+ *     ├── jam/
+ *     └── workers/
+ * ```
+ */
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const ROOT_DIR = path.resolve(__dirname, "../../..");
+const DIST_DIR = path.resolve(ROOT_DIR, "dist/lib");
+/**
+ * Get the version string for the package
+ *
+ * If IS_RELEASE environment variable is set, uses the version from package.json as-is.
+ * Otherwise, appends the current git commit hash to create unique versions for each build.
+ *
+ * @param baseVersion - The base version from package.json
+ * @returns The version string to use for publishing
+ *
+ * @example
+ * // When IS_RELEASE is not set and commit is abc1234
+ * getVersion("0.5.1") // Returns "0.5.1-abc1234"
+ *
+ * // When IS_RELEASE is set
+ * getVersion("0.5.1") // Returns "0.5.1"
+ */
+function getVersion(baseVersion) {
+    const isRelease = process.env.IS_RELEASE !== undefined;
+    if (isRelease) {
+        return baseVersion;
+    }
+    const commitHash = execSync("git rev-parse --short HEAD").toString("utf8").trim();
+    return `${baseVersion}-${commitHash}`;
+}
+/**
+ * Build a map of package names to their workspace paths
+ *
+ * Reads the root package.json and discovers all workspace packages by reading each
+ * workspace's package.json file. This creates a mapping used for import rewriting.
+ *
+ * @returns A map from package names (e.g., "@typeberry/bytes") to workspace paths
+ *          (e.g., "packages/core/bytes")
+ *
+ * @example
+ * {
+ *   "@typeberry/bytes": "packages/core/bytes",
+ *   "@typeberry/codec": "packages/core/codec",
+ *   ...
+ * }
+ */
+function buildPackageMap() {
+    const rootPackageJsonPath = path.join(ROOT_DIR, "package.json");
+    const rootPackageJson = JSON.parse(fs.readFileSync(rootPackageJsonPath, "utf-8"));
+    if (rootPackageJson.workspaces === undefined || rootPackageJson.workspaces === null) {
+        throw new Error("No workspaces found in root package.json");
+    }
+    const packageMap = {};
+    for (const workspacePath of rootPackageJson.workspaces) {
+        const packageJsonPath = path.join(ROOT_DIR, workspacePath, "package.json");
+        if (!fs.existsSync(packageJsonPath)) {
+            // biome-ignore lint/suspicious/noConsole: Build script requires console output
+            console.warn(`Warning: No package.json found at ${workspacePath}`);
+            continue;
+        }
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+        if (packageJson.name !== undefined && packageJson.name !== null && packageJson.name !== "") {
+            packageMap[packageJson.name] = workspacePath;
+        }
+    }
+    return packageMap;
+}
+/**
+ * Extract package name from an import path
+ *
+ * Handles both scoped and non-scoped packages:
+ * - Scoped: "@typeberry/bytes" → "@typeberry/bytes"
+ * - Scoped with subpath: "@typeberry/bytes/something.js" → "@typeberry/bytes"
+ * - Non-scoped: "lodash" → "lodash"
+ * - Non-scoped with subpath: "lodash/map.js" → "lodash"
+ *
+ * @param importPath - The import path to extract from
+ * @returns The package name
+ */
+function extractPackageName(importPath) {
+    if (importPath.startsWith("@")) {
+        // Scoped package: take first two segments (@scope/name)
+        const match = importPath.match(/^(@[^/]+\/[^/]+)/);
+        return match !== null ? match[1] : importPath;
+    }
+    // Non-scoped package: take first segment
+    const match = importPath.match(/^([^/]+)/);
+    return match !== null ? match[1] : importPath;
+}
+/**
+ * Rewrite imports in a JavaScript or TypeScript declaration file
+ *
+ * Searches for all import/export statements and checks if they reference
+ * packages in the package map. If so, rewrites them to use # prefix
+ * which is resolved via package.json "imports" field.
+ *
+ * Handles both import and export statements:
+ * - `import { X } from "#@typeberry/bytes"` → `import { X } from "#@typeberry/bytes"`
+ * - `export * from "#@typeberry/codec"` → `export * from "#@typeberry/codec"`
+ *
+ * External packages not in the package map are left unchanged.
+ *
+ * @param filePath - Absolute path to the file to process
+ * @param packageMap - Map of package names to their workspace paths
+ */
+function rewriteImports(filePath, packageMap) {
+    let content = fs.readFileSync(filePath, "utf-8");
+    let modified = false;
+    // Match: import ... from "...";
+    // Match: export ... from "...";
+    const importRegex = /((?:import|export)\s+(?:[\s\S]*?)\s+from\s+["'])([^"']+)(["'])/g;
+    content = content.replace(importRegex, (match, prefix, importPath, suffix) => {
+        // Skip relative imports
+        if (typeof importPath === "string" && importPath.startsWith(".")) {
+            return match;
+        }
+        // Extract the package name from the import path
+        const packageName = extractPackageName(importPath);
+        // Only rewrite if this package is in our workspace
+        if (packageMap[packageName] !== undefined && packageMap[packageName] !== "") {
+            modified = true;
+            // Prepend # to the import path
+            const newImportPath = `#${importPath}`;
+            return `${prefix}${newImportPath}${suffix}`;
+        }
+        // External package - leave unchanged
+        return match;
+    });
+    if (modified) {
+        fs.writeFileSync(filePath, content);
+        console.log(`✓ Rewrote imports in ${path.relative(DIST_DIR, filePath)}`);
+    }
+}
+/**
+ * Recursively process all JS and DTS files in a directory
+ *
+ * Walks the directory tree and rewrites imports in all .js and .d.ts files.
+ *
+ * @param dir - Directory to process
+ * @param packageMap - Map of package names to their workspace paths
+ */
+function processDirectory(dir, packageMap) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            processDirectory(fullPath, packageMap);
+        }
+        else if (entry.isFile() && (entry.name.endsWith(".js") || entry.name.endsWith(".d.ts"))) {
+            rewriteImports(fullPath, packageMap);
+        }
+    }
+}
+/**
+ * Build the "imports" field for package.json
+ *
+ * Creates mappings from #<package-name>/* to the actual package locations in dist/lib/.
+ * Each package gets two entries:
+ * - Direct import: "#@typeberry/bytes" → "./packages/core/bytes/index.js"
+ * - Subpath import: "#@typeberry/bytes/*" → "./packages/core/bytes/*"
+ *
+ * @param packageMap - Map of package names to their workspace paths
+ * @returns The imports field object for package.json
+ *
+ * @example
+ * {
+ *   "#@typeberry/bytes": "./packages/core/bytes/index.js",
+ *   "#@typeberry/bytes/*": "./packages/core/bytes/*",
+ *   "#@typeberry/codec": "./packages/core/codec/index.js",
+ *   "#@typeberry/codec/*": "./packages/core/codec/*"
+ * }
+ */
+function buildImportsField(packageMap) {
+    const imports = {};
+    for (const [packageName, packagePath] of Object.entries(packageMap)) {
+        // Prepend # to package name
+        const internalName = `#${packageName}`;
+        // Direct import (e.g., import from "#@typeberry/bytes")
+        imports[internalName] = `./${packagePath}/index.js`;
+        // Subpath imports (e.g., import from "#@typeberry/bytes/something.js")
+        imports[`${internalName}/*`] = `./${packagePath}/*`;
+    }
+    return imports;
+}
+/**
+ * Create and fix the package.json at dist/lib
+ *
+ * Transforms the source package.json from bin/lib/ into a distribution-ready format:
+ * - Updates entry points to use ./bin/lib/ prefix
+ * - Adds TypeScript type declarations to exports
+ * - Removes workspace dependencies
+ * - Adds "imports" field to resolve #<package-name>/* references
+ *
+ * The resulting package.json uses the "exports" format with separate
+ * type and default exports for each module, and an "imports" field for
+ * internal package resolution.
+ *
+ * @param packageMap - Map of package names to their workspace paths
+ *
+ * @example
+ * // Input exports (from bin/lib/package.json):
+ * {
+ *   "./bytes": "./exports/bytes.js"
+ * }
+ *
+ * // Output exports (in dist/lib/package.json):
+ * {
+ *   "./bytes": {
+ *     "types": "./bin/lib/exports/bytes.d.ts",
+ *     "default": "./bin/lib/exports/bytes.js"
+ *   }
+ * }
+ *
+ * // Output imports:
+ * {
+ *   "imports": {
+ *     "#@typeberry/bytes": "./packages/core/bytes/index.js",
+ *     "#@typeberry/bytes/*": "./packages/core/bytes/*",
+ *     ...
+ *   }
+ * }
+ */
+function createDistPackageJson(packageMap) {
+    const sourcePackageJsonPath = path.join(ROOT_DIR, "bin/lib/package.json");
+    const targetPackageJsonPath = path.join(DIST_DIR, "package.json");
+    const sourcePackageJson = JSON.parse(fs.readFileSync(sourcePackageJsonPath, "utf-8"));
+    // Filter out workspace dependencies
+    const filteredDeps = Object.entries(sourcePackageJson.dependencies).filter(([_key, version]) => version !== "*");
+    // Create the new package.json structure
+    const distPackageJson = {
+        name: sourcePackageJson.name,
+        version: getVersion(sourcePackageJson.version),
+        description: sourcePackageJson.description,
+        main: "./bin/lib/index.js",
+        types: "./bin/lib/index.d.ts",
+        type: sourcePackageJson.type,
+        exports: {},
+        imports: buildImportsField(packageMap),
+        dependencies: Object.fromEntries(filteredDeps),
+        author: sourcePackageJson.author,
+        license: sourcePackageJson.license,
+    };
+    // Fix the exports paths to include bin/lib/ prefix and add types
+    for (const [key, value] of Object.entries(sourcePackageJson.exports)) {
+        if (typeof value === "string") {
+            if (key === ".") {
+                distPackageJson.exports[key] = {
+                    types: "./bin/lib/index.d.ts",
+                    default: "./bin/lib/index.js",
+                };
+            }
+            else {
+                // Convert path like "./exports/bytes.js" to "./bin/lib/exports/bytes.js"
+                const jsPath = `./bin/lib${value.startsWith("./") ? value.slice(1) : value}`;
+                // Replace .js with .d.ts for types
+                const dtsPath = jsPath.replace(/\.js$/, ".d.ts");
+                distPackageJson.exports[key] = {
+                    types: dtsPath,
+                    default: jsPath,
+                };
+            }
+        }
+    }
+    // Write the new package.json
+    fs.writeFileSync(targetPackageJsonPath, `${JSON.stringify(distPackageJson, null, 2)}\n`);
+    console.log(`✓ Created ${path.relative(ROOT_DIR, targetPackageJsonPath)}`);
+}
+/**
+ * Copy additional distribution files (README, .npmignore, etc.)
+ *
+ * Copies files needed for npm distribution from bin/lib/ to dist/lib/:
+ * - README.md: Package documentation
+ * - .npmignore: Files to exclude from npm publish
+ *
+ * Files are only copied if they exist in the source location. Missing files
+ * are skipped without error.
+ */
+function copyDistributionFiles() {
+    const binLibDir = path.join(ROOT_DIR, "bin/lib");
+    // Copy README.md
+    const readmeSrc = path.join(binLibDir, "README.md");
+    const readmeDest = path.join(DIST_DIR, "README.md");
+    if (fs.existsSync(readmeSrc)) {
+        fs.copyFileSync(readmeSrc, readmeDest);
+        console.log(`✓ Copied ${path.relative(ROOT_DIR, readmeDest)}`);
+    }
+    // Copy .npmignore if it exists
+    const npmignoreSrc = path.join(binLibDir, ".npmignore");
+    const npmignoreDest = path.join(DIST_DIR, ".npmignore");
+    if (fs.existsSync(npmignoreSrc)) {
+        fs.copyFileSync(npmignoreSrc, npmignoreDest);
+        console.log(`✓ Copied ${path.relative(ROOT_DIR, npmignoreDest)}`);
+    }
+}
+// ============================================================================
+// Main Execution
+// ============================================================================
+//
+// This script runs after TypeScript compilation (tsc) to post-process the
+// output and create a distributable package.
+//
+// Prerequisites:
+// - TypeScript must have already compiled the project to dist/lib/
+// - The workspace must be properly configured in the root package.json
+//
+// Process:
+// 1. Discover all workspace packages by reading package.json files
+// 2. Rewrite all workspace package imports to #<package-name>/* in .js and .d.ts files
+// 3. Create a distribution package.json with "imports" field for resolution
+// 4. Copy README.md and .npmignore for npm publishing
+console.log("Building package map from workspace configuration...");
+const packageMap = buildPackageMap();
+console.log(`Found ${Object.keys(packageMap).length} packages in workspace`);
+console.log("\nRewriting workspace imports to internal imports...");
+console.log(`Processing: ${DIST_DIR}`);
+if (!fs.existsSync(DIST_DIR)) {
+    // biome-ignore lint/suspicious/noConsole: Build script requires console output
+    console.error(`Error: Directory not found: ${DIST_DIR}`);
+    // biome-ignore lint/suspicious/noConsole: Build script requires console output
+    console.error("Please run TypeScript compilation (tsc) first.");
+    process.exit(1);
+}
+processDirectory(DIST_DIR, packageMap);
+console.log("\nCreating distribution package.json with imports field...");
+createDistPackageJson(packageMap);
+console.log("\nCopying distribution files...");
+copyDistributionFiles();
+console.log("\n✓ Build complete!");

package/bin/lib/scripts/extract-examples.d.ts

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

package/bin/lib/scripts/extract-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-examples.d.ts","sourceRoot":"","sources":["../../../../../bin/lib/scripts/extract-examples.ts"],"names":[],"mappings":""}