ttsc 0.30.3 → 0.31.0

package/lib/launcher/internal/runtime/CommonJsRuntimeSource.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Give a hook-served CommonJS module its own source-aware require function.
+ *
+ * Node's module-local require binding is writable. Adapting that binding keeps
+ * the shared module cache and callable loader while leaving Node's resolver and
+ * global extension registry untouched. Source maps account for the inserted
+ * first-line columns; directive and hashbang semantics remain those of the
+ * body.
+ *
+ * @evidence contracts/common.md#principled-implementation The public load boundary supplies CommonJS source and its wrapper binding; an owned function delegates loading to createRequire's shared native cache. Acorn identifies real directives and comments before inserting bootstrap syntax.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace owns the source bootstrap and the function it installs; the runtime installer supplies its existing source-resolution policy.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Only the served module's local binding changes. No foreign resolver, module cache entry or global extension handler is replaced.
+ * @evidence contracts/common.md#meaningful-documentation Native prose describes binding ownership, public loader delegation and source-location preservation; members distinguish installation policy from per-module adaptation.
+ * @evidence contracts/portability.md#os-neutral-implementation createRequire consumes the native module filename and pathToFileURL encodes map source identity; filesystem case decisions stay with the supplied runtime resolver.
+ *
+ * @evidenceExclude contracts/performance.md#efficient-algorithms The namespace groups operations; source and function construction describe their processing costs below.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Runtime and Node cache owners decide evaluation reuse; the namespace does not cache transformed bodies.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Operations own their retained callback and per-module function lifetimes.
+ */
+export declare namespace CommonJsRuntimeSource {
+    /**
+     * Install the runtime's resolution policy before loading user modules. The
+     * capability owner also selects whether direct module API consumers need an
+     * owned createRequire view; native hook-complete runtimes keep Node's API.
+     *
+     * @evidence contracts/common.md#principled-implementation The callback receives Node's original resolver and actual module filename, keeping successful native resolutions authoritative. The supplied actual hook capability selects the owned API view, rather than an OS or version-name exception.
+     * @evidence contracts/common.md#clear-and-simple-design Installation stores one policy; per-module factories do not duplicate runtime project or descriptor-observation logic.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The callback is owned state and does not replace any Node method.
+     * @evidence contracts/common.md#meaningful-documentation The native purpose states the ordering prerequisite and policy owner.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation Storing the supplied callback accesses no filesystem, process or path representation; the resolver and per-module factory own those boundaries.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Assigning a callback selects no input-processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Policy installation does not authorize sharing a compiled result.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources This helper instance retains one replaceable policy; its installation-owned global symbol slot retains the factory even if its CommonJS cache entry is removed. No per-request history or native handle is added.
+     */
+    function configure(policy: Resolver, adaptModuleApi?: boolean): void;
+    /**
+     * A private public-hook URL serves an owned view of Node's module API on
+     * runtimes whose native createRequire.resolve does not consult hooks. The
+     * view delegates construction and every unrelated member to Node. Its
+     * createRequire returns the same source-aware callable used by served
+     * CommonJS modules; Node's original exports and module cache are untouched.
+     *
+     * @evidence contracts/common.md#principled-implementation The load hook supplies this module body and bypasses only its own native import. A process-owned symbol supplies the shared facade without assigning a foreign property.
+     * @evidence contracts/common.md#clear-and-simple-design CommonJS and ESM module API consumers share one facade and one require construction policy.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The facade is an owned callable view, not a replacement of Node's builtin exports or private resolver.
+     * @evidence contracts/common.md#meaningful-documentation The native comment states its private URL, delegation and unchanged native ownership.
+     * @evidence contracts/portability.md#os-neutral-implementation Public createRequire validates native paths and file URLs before the adapter converts the accepted anchor.
+     * @evidence contracts/performance.md#efficient-algorithms The fixed module body retains no source population and the process owns one facade.
+     * @evidence contracts/performance.md#reuse-equivalent-work One facade preserves identity across served consumers; Node continues to own evaluated-module reuse.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The installed runtime retains one facade and symbol slot, with no per-request history or native handles.
+     */
+    function moduleSource(): {
+        url: string;
+        source: string;
+    };
+    /**
+     * Construct an owned require with local TypeScript extension advertisements.
+     *
+     * @evidence contracts/common.md#principled-implementation createRequire loads through Node's shared CommonJS cache; copied public properties preserve cache/main access, while a copied registry advertises the already-supported source extensions without changing their actual loader.
+     * @evidence contracts/common.md#clear-and-simple-design The callable and resolve member share one filename anchor; source recovery remains in the configured policy.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Extension entries belong to this new function, not Module._extensions or a foreign require; no private loader slot is assigned.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies ownership and distinguishes advertisements from actual loading.
+     * @evidence contracts/portability.md#os-neutral-implementation The public createRequire API takes the native filename; no OS-name or path-string case heuristic is introduced.
+     * @evidence contracts/performance.md#efficient-algorithms Construction copies public require properties and E extension entries, including their property observations, and creates a native filename-anchored require. Calls delegate native resolution, module evaluation/cache work or the configured resolver; their cost is not bounded by construction or extension count.
+     * @evidence contracts/performance.md#reuse-equivalent-work Callable loading delegates to Node's CommonJS cache; the configured resolve policy remains a distinct per-call operation, not a cached result of constructing the function.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The evaluated module owns the returned function, captured filename/native require and copied extension registry. Captured cache/main references share Node or original-require state rather than copying all cached modules; the factory adds no historical module collection or native handle.
+     */
+    function create(original: NodeJS.Require, filename: string): NodeJS.Require;
+    /**
+     * Insert the local bootstrap without changing lines or directive semantics. A
+     * module that declares its own top-level require function keeps that binding.
+     * Flat and embedded indexed JSON maps preserve their source coordinates.
+     * Base64/charset and percent-encoded inline payloads are decoded; unusable
+     * payloads, inspected map shapes or first-column encodings fall back to an
+     * identity map. This is not validation of every source-map field, and
+     * optional metadata failures do not become executable-syntax failures.
+     *
+     * @evidence contracts/common.md#principled-implementation Acorn's CommonJS grammar identifies directive prologues, hoisted require declarations and actual trailing source-map comments. Flat mappings or indexed section offsets shift generated columns on exactly the insertion line, preserving original locations. Optional malformed or externally indexed maps do not become executable-syntax failures.
+     * @evidence contracts/common.md#clear-and-simple-design Source adaptation constructs one prefix and one corresponding map adjustment; evaluation stays with Node rather than a second interpreter.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The bootstrap reads an installation-owned symbol factory through the public VM context API, independently of mutable require.cache entries and user wrapper declarations. User-owned hoisted require functions are left intact.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states line/directive preservation and the user-owned binding exception.
+     * @evidence contracts/portability.md#os-neutral-implementation JSON quotes the installation key and actual native filename; the filename becomes a file URL only for source-map identity, preserving native and protocol spelling separately.
+     * @evidence contracts/performance.md#efficient-algorithms Parsing, comments, source copying and construction scale with B source bytes and M decoded JSON/map text and sections. Recursive indexed-map processing uses nesting-dependent stack without a configured depth cap; a fallback first line adds C exact-column segments. Returned source contains encoded map bytes as well as the body.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Node's evaluation owner calls this operation once for each loaded body; this function retains no mutable-source cache.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources AST, comments and map data end with this call, scaling with source and map bytes; the returned body belongs to the loader. The installation owns one process-lifetime factory slot per helper location, replaced by configure without retaining body history.
+     */
+    function prepare(source: string, filename: string): string;
+}
+type Resolver = (native: NodeJS.RequireResolve, specifier: string, options: {
+    paths?: string[];
+} | undefined, filename: string) => string;
+export {};

package/lib/launcher/internal/runtime/CommonJsRuntimeSource.js

@@ -0,0 +1,354 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommonJsRuntimeSource = void 0;
+const acorn_1 = require("acorn");
+const node_module_1 = __importStar(require("node:module"));
+const node_url_1 = require("node:url");
+/**
+ * Give a hook-served CommonJS module its own source-aware require function.
+ *
+ * Node's module-local require binding is writable. Adapting that binding keeps
+ * the shared module cache and callable loader while leaving Node's resolver and
+ * global extension registry untouched. Source maps account for the inserted
+ * first-line columns; directive and hashbang semantics remain those of the
+ * body.
+ *
+ * @evidence contracts/common.md#principled-implementation The public load boundary supplies CommonJS source and its wrapper binding; an owned function delegates loading to createRequire's shared native cache. Acorn identifies real directives and comments before inserting bootstrap syntax.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace owns the source bootstrap and the function it installs; the runtime installer supplies its existing source-resolution policy.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Only the served module's local binding changes. No foreign resolver, module cache entry or global extension handler is replaced.
+ * @evidence contracts/common.md#meaningful-documentation Native prose describes binding ownership, public loader delegation and source-location preservation; members distinguish installation policy from per-module adaptation.
+ * @evidence contracts/portability.md#os-neutral-implementation createRequire consumes the native module filename and pathToFileURL encodes map source identity; filesystem case decisions stay with the supplied runtime resolver.
+ *
+ * @evidenceExclude contracts/performance.md#efficient-algorithms The namespace groups operations; source and function construction describe their processing costs below.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Runtime and Node cache owners decide evaluation reuse; the namespace does not cache transformed bodies.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Operations own their retained callback and per-module function lifetimes.
+ */
+var CommonJsRuntimeSource;
+(function (CommonJsRuntimeSource) {
+    /**
+     * Install the runtime's resolution policy before loading user modules. The
+     * capability owner also selects whether direct module API consumers need an
+     * owned createRequire view; native hook-complete runtimes keep Node's API.
+     *
+     * @evidence contracts/common.md#principled-implementation The callback receives Node's original resolver and actual module filename, keeping successful native resolutions authoritative. The supplied actual hook capability selects the owned API view, rather than an OS or version-name exception.
+     * @evidence contracts/common.md#clear-and-simple-design Installation stores one policy; per-module factories do not duplicate runtime project or descriptor-observation logic.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The callback is owned state and does not replace any Node method.
+     * @evidence contracts/common.md#meaningful-documentation The native purpose states the ordering prerequisite and policy owner.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation Storing the supplied callback accesses no filesystem, process or path representation; the resolver and per-module factory own those boundaries.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms Assigning a callback selects no input-processing algorithm.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Policy installation does not authorize sharing a compiled result.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources This helper instance retains one replaceable policy; its installation-owned global symbol slot retains the factory even if its CommonJS cache entry is removed. No per-request history or native handle is added.
+     */
+    function configure(policy, adaptModuleApi = false) {
+        resolve = policy;
+        moduleApiAdapted = adaptModuleApi;
+        factories[FACTORY_KEY] = create;
+        globalThis[MODULE_KEY] =
+            moduleFacade;
+    }
+    CommonJsRuntimeSource.configure = configure;
+    /**
+     * A private public-hook URL serves an owned view of Node's module API on
+     * runtimes whose native createRequire.resolve does not consult hooks. The
+     * view delegates construction and every unrelated member to Node. Its
+     * createRequire returns the same source-aware callable used by served
+     * CommonJS modules; Node's original exports and module cache are untouched.
+     *
+     * @evidence contracts/common.md#principled-implementation The load hook supplies this module body and bypasses only its own native import. A process-owned symbol supplies the shared facade without assigning a foreign property.
+     * @evidence contracts/common.md#clear-and-simple-design CommonJS and ESM module API consumers share one facade and one require construction policy.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The facade is an owned callable view, not a replacement of Node's builtin exports or private resolver.
+     * @evidence contracts/common.md#meaningful-documentation The native comment states its private URL, delegation and unchanged native ownership.
+     * @evidence contracts/portability.md#os-neutral-implementation Public createRequire validates native paths and file URLs before the adapter converts the accepted anchor.
+     * @evidence contracts/performance.md#efficient-algorithms The fixed module body retains no source population and the process owns one facade.
+     * @evidence contracts/performance.md#reuse-equivalent-work One facade preserves identity across served consumers; Node continues to own evaluated-module reuse.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The installed runtime retains one facade and symbol slot, with no per-request history or native handles.
+     */
+    function moduleSource() {
+        return {
+            url: MODULE_URL,
+            source: `export * from "node:module"; import { runInThisContext } from "node:vm"; const owned=runInThisContext(${JSON.stringify(`globalThis[Symbol.for(${JSON.stringify(MODULE_NAME)})]`)}); export const createRequire=owned.createRequire; export const Module=owned; export default owned;`,
+        };
+    }
+    CommonJsRuntimeSource.moduleSource = moduleSource;
+    /**
+     * Construct an owned require with local TypeScript extension advertisements.
+     *
+     * @evidence contracts/common.md#principled-implementation createRequire loads through Node's shared CommonJS cache; copied public properties preserve cache/main access, while a copied registry advertises the already-supported source extensions without changing their actual loader.
+     * @evidence contracts/common.md#clear-and-simple-design The callable and resolve member share one filename anchor; source recovery remains in the configured policy.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Extension entries belong to this new function, not Module._extensions or a foreign require; no private loader slot is assigned.
+     * @evidence contracts/common.md#meaningful-documentation Native prose identifies ownership and distinguishes advertisements from actual loading.
+     * @evidence contracts/portability.md#os-neutral-implementation The public createRequire API takes the native filename; no OS-name or path-string case heuristic is introduced.
+     * @evidence contracts/performance.md#efficient-algorithms Construction copies public require properties and E extension entries, including their property observations, and creates a native filename-anchored require. Calls delegate native resolution, module evaluation/cache work or the configured resolver; their cost is not bounded by construction or extension count.
+     * @evidence contracts/performance.md#reuse-equivalent-work Callable loading delegates to Node's CommonJS cache; the configured resolve policy remains a distinct per-call operation, not a cached result of constructing the function.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources The evaluated module owns the returned function, captured filename/native require and copied extension registry. Captured cache/main references share Node or original-require state rather than copying all cached modules; the factory adds no historical module collection or native handle.
+     */
+    function create(original, filename) {
+        const native = (0, node_module_1.createRequire)(filename);
+        const owned = ((specifier) => {
+            const loaded = native(specifier);
+            if (moduleApiAdapted &&
+                (specifier === "node:module" || specifier === "module") &&
+                (loaded === node_module_1.default || loaded?.default === moduleFacade))
+                return moduleFacade;
+            return loaded;
+        });
+        Object.assign(owned, native, original);
+        owned.resolve = ((specifier, options) => resolve(native.resolve, specifier, options, filename));
+        owned.resolve.paths = native.resolve.paths;
+        owned.cache = original.cache ?? native.cache;
+        owned.extensions = { ...(original.extensions ?? native.extensions) };
+        for (const extension of [".ts", ".tsx", ".cts", ".mts"])
+            owned.extensions[extension] = owned.extensions[".js"];
+        return owned;
+    }
+    CommonJsRuntimeSource.create = create;
+    /**
+     * Insert the local bootstrap without changing lines or directive semantics. A
+     * module that declares its own top-level require function keeps that binding.
+     * Flat and embedded indexed JSON maps preserve their source coordinates.
+     * Base64/charset and percent-encoded inline payloads are decoded; unusable
+     * payloads, inspected map shapes or first-column encodings fall back to an
+     * identity map. This is not validation of every source-map field, and
+     * optional metadata failures do not become executable-syntax failures.
+     *
+     * @evidence contracts/common.md#principled-implementation Acorn's CommonJS grammar identifies directive prologues, hoisted require declarations and actual trailing source-map comments. Flat mappings or indexed section offsets shift generated columns on exactly the insertion line, preserving original locations. Optional malformed or externally indexed maps do not become executable-syntax failures.
+     * @evidence contracts/common.md#clear-and-simple-design Source adaptation constructs one prefix and one corresponding map adjustment; evaluation stays with Node rather than a second interpreter.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The bootstrap reads an installation-owned symbol factory through the public VM context API, independently of mutable require.cache entries and user wrapper declarations. User-owned hoisted require functions are left intact.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states line/directive preservation and the user-owned binding exception.
+     * @evidence contracts/portability.md#os-neutral-implementation JSON quotes the installation key and actual native filename; the filename becomes a file URL only for source-map identity, preserving native and protocol spelling separately.
+     * @evidence contracts/performance.md#efficient-algorithms Parsing, comments, source copying and construction scale with B source bytes and M decoded JSON/map text and sections. Recursive indexed-map processing uses nesting-dependent stack without a configured depth cap; a fallback first line adds C exact-column segments. Returned source contains encoded map bytes as well as the body.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work Node's evaluation owner calls this operation once for each loaded body; this function retains no mutable-source cache.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources AST, comments and map data end with this call, scaling with source and map bytes; the returned body belongs to the loader. The installation owns one process-lifetime factory slot per helper location, replaced by configure without retaining body history.
+     */
+    function prepare(source, filename) {
+        const comments = [];
+        const program = (0, acorn_1.parse)(source, {
+            ecmaVersion: "latest",
+            sourceType: "commonjs",
+            onComment: (_block, text, start, end) => comments.push({ end, start, text }),
+        });
+        if (program.body.some((node) => node.type === "FunctionDeclaration" && node.id?.name === "require"))
+            return source;
+        let strict = false;
+        for (const node of program.body) {
+            if (node.type !== "ExpressionStatement" || !("directive" in node))
+                break;
+            if (node.directive === "use strict")
+                strict = true;
+        }
+        const firstBreak = /\r\n|[\r\n\u2028\u2029]/.exec(source);
+        if (source.startsWith("#!") && firstBreak === null)
+            return source;
+        const offset = source.startsWith("#!")
+            ? firstBreak.index + firstBreak[0].length
+            : 0;
+        const line = offset === 0 ? 0 : 1;
+        factories[FACTORY_KEY] ??= create;
+        const factoryExpression = `globalThis[Symbol.for(${JSON.stringify(FACTORY_NAME)})]`;
+        const header = `${strict ? '"use strict";' : ""}require=require("node:vm").runInThisContext(${JSON.stringify(factoryExpression)})(require,${JSON.stringify(filename)});`;
+        const trailing = comments.at(-1);
+        const directive = trailing !== undefined && source.slice(trailing.end).trim() === ""
+            ? /^\s*[#@]\s*sourceMappingURL\s*=\s*(\S+)\s*$/.exec(trailing.text)
+            : null;
+        let map;
+        let body = source;
+        const uri = directive?.[1];
+        if (uri !== undefined) {
+            map = adjustedInlineMap(uri, line, header.length);
+        }
+        if (map !== undefined) {
+            body = source.slice(0, trailing.start);
+        }
+        else {
+            const rows = Array(source.split(/\r\n|[\r\n\u2028\u2029]/).length).fill("A");
+            const first = source
+                .slice(offset)
+                .split(/\r\n|[\r\n\u2028\u2029]/, 1)[0];
+            rows[line] =
+                encodeColumn(header.length) +
+                    "A" +
+                    encodeColumn(line) +
+                    "A" +
+                    ",CAAC".repeat(first.length);
+            map = {
+                version: 3,
+                names: [],
+                sources: [(0, node_url_1.pathToFileURL)(filename).href],
+                sourcesContent: [source],
+                mappings: rows.join(";"),
+            };
+        }
+        return (body.slice(0, offset) +
+            header +
+            body.slice(offset) +
+            "\n//# sourceMappingURL=data:application/json;base64," +
+            Buffer.from(JSON.stringify(map)).toString("base64"));
+    }
+    CommonJsRuntimeSource.prepare = prepare;
+})(CommonJsRuntimeSource || (exports.CommonJsRuntimeSource = CommonJsRuntimeSource = {}));
+let resolve = (native, specifier, options) => native(specifier, options);
+let moduleApiAdapted = false;
+// The installed hooks outlive individual CommonJS cache entries. This owned
+// symbol retains one factory per helper location without mutating Node's cache.
+const FACTORY_NAME = `ttsc.CommonJsRuntimeSource:${__filename}`;
+const FACTORY_KEY = Symbol.for(FACTORY_NAME);
+const MODULE_NAME = `ttsc.CommonJsRuntimeSource.module:${__filename}`;
+const MODULE_KEY = Symbol.for(MODULE_NAME);
+const MODULE_URL = `ttsc:owned-module:${encodeURIComponent(__filename)}`;
+// The owned callable retains Node's constructor and static API semantics.
+// Configurable property descriptors are copied, so reflective reads of
+// createRequire see the owned function rather than escaping its policy.
+const moduleFacade = function (...args) {
+    return new.target === undefined
+        ? Reflect.apply(node_module_1.default, this, args)
+        : Reflect.construct(node_module_1.default, args, Object.is(new.target, moduleFacade) ? node_module_1.default : new.target);
+};
+Object.setPrototypeOf(moduleFacade, Object.getPrototypeOf(node_module_1.default));
+for (const key of Reflect.ownKeys(node_module_1.default)) {
+    const descriptor = Object.getOwnPropertyDescriptor(node_module_1.default, key);
+    const existing = Object.getOwnPropertyDescriptor(moduleFacade, key);
+    if (existing?.configurable === false)
+        continue;
+    Object.defineProperty(moduleFacade, key, descriptor);
+}
+Object.defineProperty(moduleFacade, "createRequire", {
+    ...Object.getOwnPropertyDescriptor(node_module_1.default, "createRequire"),
+    value: (anchor) => {
+        const native = (0, node_module_1.createRequire)(anchor);
+        const filename = anchor instanceof URL || anchor.startsWith("file:")
+            ? (0, node_url_1.fileURLToPath)(anchor)
+            : anchor;
+        return CommonJsRuntimeSource.create(native, filename);
+    },
+});
+Object.defineProperty(moduleFacade, "Module", {
+    ...Object.getOwnPropertyDescriptor(node_module_1.default, "Module"),
+    value: moduleFacade,
+});
+const factories = globalThis;
+const BASE64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+/** Encode one nonnegative source-map VLQ column or line delta. */
+function encodeColumn(value) {
+    let remaining = value * 2;
+    let output = "";
+    do {
+        const digit = remaining % 32;
+        remaining = Math.floor(remaining / 32);
+        output += BASE64[digit + (remaining ? 32 : 0)];
+    } while (remaining);
+    return output;
+}
+/**
+ * Shift only the first generated column; subsequent segment deltas are
+ * relative.
+ */
+function shiftFirstColumn(row, amount) {
+    let value = 0;
+    let power = 1;
+    let index = 0;
+    let digit;
+    do {
+        digit = BASE64.indexOf(row[index++]);
+        if (digit < 0)
+            throw new Error("ttsx: malformed CommonJS source map column");
+        value += (digit % 32) * power;
+        power *= 32;
+    } while (digit >= 32);
+    if (value % 2 !== 0)
+        throw new Error("ttsx: negative CommonJS source map column");
+    return encodeColumn(value / 2 + amount) + row.slice(index);
+}
+/**
+ * Decode optional JSON metadata; malformed maps must not reject valid
+ * JavaScript.
+ */
+function adjustedInlineMap(uri, line, amount) {
+    const match = /^data:application\/json((?:;[^,]*)?),([\s\S]*)$/i.exec(uri);
+    if (match === null)
+        return undefined;
+    try {
+        const json = /(?:^|;)base64(?:;|$)/i.test(match[1])
+            ? Buffer.from(match[2], "base64").toString("utf8")
+            : decodeURIComponent(match[2]);
+        const map = JSON.parse(json);
+        if (!shiftMapLine(map, line, amount))
+            return undefined;
+        return map;
+    }
+    catch {
+        // Source-map comments are optional debug metadata, not executable syntax.
+        return undefined;
+    }
+}
+/** Shift one generated line in a flat map or its recursively indexed sections. */
+function shiftMapLine(value, line, amount) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const map = value;
+    if (map.version !== 3)
+        return false;
+    if (typeof map.mappings === "string") {
+        const rows = map.mappings.split(";");
+        if (rows[line])
+            rows[line] = shiftFirstColumn(rows[line], amount);
+        map.mappings = rows.join(";");
+        return true;
+    }
+    if (!Array.isArray(map.sections))
+        return false;
+    for (const value of map.sections) {
+        if (value === null || typeof value !== "object" || Array.isArray(value))
+            return false;
+        const section = value;
+        const offset = section.offset;
+        if (offset === undefined ||
+            offset === null ||
+            !Number.isSafeInteger(offset.line) ||
+            !Number.isSafeInteger(offset.column) ||
+            offset.line < 0 ||
+            offset.column < 0)
+            return false;
+        const start = offset.line;
+        if (!shiftMapLine(section.map, start < line ? line - start : -1, start < line ? amount : 0))
+            return false;
+        if (start === line) {
+            // Section columns affect their first line alone, exactly as the prefix does.
+            offset.column = offset.column + amount;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=CommonJsRuntimeSource.js.map

package/lib/launcher/internal/runtime/CommonJsRuntimeSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommonJsRuntimeSource.js","sourceRoot":"","sources":["../../../../src/launcher/internal/runtime/CommonJsRuntimeSource.ts"],"names":[],"mappings":"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"}

package/lib/launcher/internal/runtime/DependencyBuildAdmission.d.ts

@@ -0,0 +1,72 @@
+import { DependencyBuildGeneration } from "./DependencyBuildGeneration";
+import type { DependencyBuildLockFence } from "./DependencyBuildLockFence";
+/**
+ * Admit a dependency builder without interpreting elapsed wait as owner death.
+ *
+ * @evidence contracts/common.md#principled-implementation Inspection supplies policy-selected abandonment grounds; the contender's monotonic budget itself grants no retirement authority. Inspector stale unreadable-owner policy remains distinct from proof of process death.
+ * @evidence contracts/common.md#clear-and-simple-design Run owns acquisition and release; wait reports publication and inspected ownership without retiring a generation.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Expiration throws instead of granting reclaim authority; only an inspected abandoned fence reaches the retirement operation.
+ * @evidence contracts/common.md#meaningful-documentation Public operations distinguish admission budget from holder liveness and state the optional coordination fallback.
+ * @evidence contracts/portability.md#os-neutral-implementation Native lock operations and shared cache readers own filesystem semantics; monotonic time measures waiting independently of wall-clock changes.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms The namespace groups the run and wait operations that describe their costs.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Run and wait own cache validation and reuse admission.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Run owns the acquired lease; wait retains only local observations.
+ */
+export declare namespace DependencyBuildAdmission {
+    /**
+     * Observation returned without changing a peer's lock ownership.
+     *
+     * @evidence contracts/common.md#principled-implementation Built publication, normal release and inspected abandonment remain distinct states; abandonment carries the exact observed generation fence.
+     * @evidence contracts/common.md#clear-and-simple-design A discriminated union requires consumers to handle publication separately from lock reacquisition and reclaim.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts There is no timeout outcome granting a peer retirement authority.
+     * @evidence contracts/common.md#meaningful-documentation The native purpose states this result cannot itself change ownership.
+     * @evidence contracts/portability.md#os-neutral-implementation Built results carry native generation/root/provenance paths; abandoned results carry diagnostic reason text and a hexadecimal generation fence, not authenticated pid authority. Released describes an observed absence, not acquisition; the inspector and reader own native observations and their uncertainty.
+     * @evidenceExclude contracts/performance.md#efficient-algorithms This outcome type selects no processing algorithm; run and wait own observation costs.
+     * @evidenceExclude contracts/performance.md#reuse-equivalent-work The type describes validated publication or peer state without authorizing independent reuse.
+     * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Outcome values acquire no handle or independent history; the waiting caller owns the returned observation.
+     */
+    type WaitResult = {
+        outcome: "built";
+        built: DependencyBuildGeneration.BuiltProject;
+    } | {
+        outcome: "released";
+    } | {
+        outcome: "abandoned";
+        reason: string;
+        fence: DependencyBuildLockFence;
+    };
+    /**
+     * Run one builder with a fenced lease, or reuse an accepted publication. Any
+     * acquisition exception invokes the existing uncoordinated build fallback,
+     * including failures after partial lock publication; it does not authenticate
+     * the namespace or guarantee that no held generation remains. One monotonic
+     * budget is checked across attempts and peer turnover, not as a hard deadline
+     * for native calls, building or retirement.
+     *
+     * @evidence contracts/common.md#principled-implementation Cache validation precedes acquisition and repeats after ownership; retirement receives only an inspected abandoned generation and release receives only this contender's acquired lease.
+     * @evidence contracts/common.md#clear-and-simple-design This operation owns admission, budget, cache rechecks and lease lifecycle; wait owns passive observation and runHoldingLock owns release error handling.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Contender expiration throws rather than authorizing retirement; acquisition exceptions invoke the actual build fallback instead of fabricating a hit, while inspected abandonment still follows the inspector's stale-record policy.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states the actual broad acquisition-exception fallback, partial-state possibility and checked-budget scope without certifying a hard native deadline.
+     * @evidence contracts/portability.md#os-neutral-implementation Shared native lease operations classify filesystem behavior; the timeout uses performance.now rather than OS names or wall-clock subtraction.
+     * @evidence contracts/performance.md#efficient-algorithms Each attempt adds reader marker/provenance/path/walk/identity work and native acquisition or inspection costs; fixed coordinates do not bound bytes or native latency. Polls yield instead of spinning, but native retirement and the build callback can outlast the contender budget.
+     * @evidence contracts/performance.md#reuse-equivalent-work Publication shape/presence is checked before and after acquisition under cooperative immutable-generation premises. The callback runs after an admitted miss or any acquisition exception; this operation does not independently authenticate marker observations or caller cache-key equivalence.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources runHoldingLock attempts acquired-lease release on either synchronous work outcome, ignores a false release result and suppresses thrown release errors through the supplied no-op reporter; recovery can remain necessary. No peer lease or historical observation list is retained, while build artifacts, tombstones and partial acquisition state follow their caller/protocol lifetime policies.
+     */
+    function run(cacheDir: string, metaPath: string, lockDir: string, build: () => DependencyBuildGeneration.BuiltProject, timeoutMs?: number): DependencyBuildGeneration.BuiltProject;
+    /**
+     * Observe publication and peer state, checking the remaining contender budget
+     * after cache and ownership reads. This operation never retires a generation;
+     * native observations can outlast the budget and return a newly observed
+     * publication, release or policy-selected abandonment before its next check.
+     *
+     * @evidence contracts/common.md#principled-implementation An accepted cache record returns a built result under cooperative publication premises; released observation triggers a second read, and only inspector-selected abandonment supplies a fence rather than turning contender expiration into authority.
+     * @evidence contracts/common.md#clear-and-simple-design This passive operation reports peer state or throws on expiration without acquiring, releasing or retiring a lock.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Elapsed time is never converted into owner-death evidence and wall-clock movement cannot renew the contender budget.
+     * @evidence contracts/common.md#meaningful-documentation Native prose states read-before-budget-check ordering and passive observation, without promising a hard native deadline or authenticating holder state.
+     * @evidence contracts/portability.md#os-neutral-implementation Native inspection owns peer identity; wall time remains only its ownerless-publication age input, while performance.now owns elapsed waiting.
+     * @evidence contracts/performance.md#efficient-algorithms Each poll delegates marker/provenance/path/walk/identity validation and native generation/owner reads and liveness or age observations. Poll count and native latency are not bounded by fixed coordinates; each sleep allocates a four-byte wait view and uses the smaller polling interval/remaining budget, without scanning lock history.
+     * @evidence contracts/performance.md#reuse-equivalent-work The shared reader checks publication shape and presence under cooperative generation premises; neither an active observation nor contender elapsed time invents a build result or independently proves caller cache-key equivalence.
+     * @evidence contracts/performance.md#bound-retention-and-release-resources This observer owns no lease or filesystem handle and keeps only the current observation and monotonic start time.
+     */
+    function wait(cacheDir: string, metaPath: string, lockDir: string, timeoutMs: number): WaitResult;
+}