@ttsc/playground 0.14.0-dev.20260528.1

package/lib/src/compiler/createWorkerCompiler.js

@@ -0,0 +1,227 @@
+"use strict";
+// Worker-side playground compiler factory.
+//
+// This module ships a ready-to-bind `ICompilerService` implementation. The
+// consumer's worker entry boots the wasm once, builds tsconfig variants for
+// the site's chosen module shape, registers the typia/lint plugin verbs (or
+// the site-provided overrides), and serializes every MemFS-mutating call onto
+// a single chain so concurrent compiles never corrupt each other.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkerCompiler = createWorkerCompiler;
+const wasm_1 = require("@ttsc/wasm");
+const buildTsconfigJSON_1 = require("./buildTsconfigJSON");
+const DEFAULT_ENTRY_FILE_1 = require("./DEFAULT_ENTRY_FILE");
+const DEFAULT_LINT_PLUGIN_NAME_1 = require("./DEFAULT_LINT_PLUGIN_NAME");
+const DEFAULT_TSCONFIG_PATH_1 = require("./DEFAULT_TSCONFIG_PATH");
+const DEFAULT_TYPIA_PLUGIN_NAME_1 = require("./DEFAULT_TYPIA_PLUGIN_NAME");
+const DEFAULT_WORK_DIR_1 = require("./DEFAULT_WORK_DIR");
+const installDependenciesIntoMemFS_1 = require("./installDependenciesIntoMemFS");
+const joinUnder_1 = require("./internal/joinUnder");
+const parseLintDiagnostics_1 = require("./internal/parseLintDiagnostics");
+const safeParseTypiaTransform_1 = require("./internal/safeParseTypiaTransform");
+const mapDiagnostic_1 = require("./mapDiagnostic");
+const normalizeError_1 = require("./normalizeError");
+const pickEmittedJS_1 = require("./pickEmittedJS");
+/**
+ * Build an `ICompilerService` ready to register with tgrid's `WorkerServer`.
+ *
+ * Usage in the worker entry:
+ *
+ * ```ts
+ * import { createWorkerCompiler } from "@ttsc/playground";
+ * import { WorkerServer } from "tgrid";
+ *
+ * const service = createWorkerCompiler({
+ *   wasmUrl: "/compiler/playground.wasm",
+ *   apiName: "ttscPlayground",
+ *   typiaPlugin: { mount: installTypiaPack },
+ * });
+ *
+ * const main = async () => {
+ *   const worker = new WorkerServer();
+ *   await worker.open(service);
+ * };
+ * void main();
+ * ```
+ */
+function createWorkerCompiler(options) {
+    const workDir = options.workDir ?? DEFAULT_WORK_DIR_1.DEFAULT_WORK_DIR;
+    const tsconfigPath = options.tsconfigPath ?? DEFAULT_TSCONFIG_PATH_1.DEFAULT_TSCONFIG_PATH;
+    const entryFile = options.entryFile ?? DEFAULT_ENTRY_FILE_1.DEFAULT_ENTRY_FILE;
+    const typiaPlugin = options.typiaPlugin === false ? null : (options.typiaPlugin ?? {});
+    const typiaPluginName = typiaPlugin?.name ?? DEFAULT_TYPIA_PLUGIN_NAME_1.DEFAULT_TYPIA_PLUGIN_NAME;
+    const typiaTransformModule = typiaPlugin?.transformModule ?? "typia/lib/transform";
+    const lintPlugin = options.lintPlugin === false ? null : (options.lintPlugin ?? {});
+    const lintPluginName = lintPlugin?.name ?? DEFAULT_LINT_PLUGIN_NAME_1.DEFAULT_LINT_PLUGIN_NAME;
+    // tsconfig variants. ESM for the "Compiled JS" preview lane, CommonJS for
+    // the bundle/Execute lane (whose `new Function` driver expects CJS).
+    const tsconfigPlugins = typiaPlugin
+        ? [{ transform: typiaTransformModule }]
+        : [];
+    const extraCompilerOptions = {
+        ...(options.extraCompilerOptions ?? {}),
+        ...(tsconfigPlugins.length > 0 ? { plugins: tsconfigPlugins } : {}),
+    };
+    const tsconfigESM = (0, buildTsconfigJSON_1.buildTsconfigJSON)({
+        module: "ESNext",
+        compilerOptions: extraCompilerOptions,
+    });
+    const tsconfigCJS = (0, buildTsconfigJSON_1.buildTsconfigJSON)({
+        module: "CommonJS",
+        compilerOptions: extraCompilerOptions,
+    });
+    // Cache the boot promise across calls. If the boot rejects we clear the
+    // cache so the next call retries — otherwise every later compile/bundle/
+    // lint would replay the same rejection forever (page reload required).
+    // Mirrors the createCompilerClient (UI-side) pattern.
+    let boot = null;
+    function getBoot() {
+        if (boot)
+            return boot;
+        boot = (async () => {
+            const result = await (0, wasm_1.bootTtsc)({
+                wasmUrl: options.wasmUrl,
+                wasmExecUrl: options.wasmExecUrl,
+                apiName: options.apiName,
+            });
+            if (typiaPlugin?.mount)
+                await typiaPlugin.mount(result.host, workDir);
+            return result;
+        })().catch((err) => {
+            boot = null;
+            throw err;
+        });
+        return boot;
+    }
+    // Serialize every MemFS-mutating call. tgrid queues incoming messages, but
+    // the wasm-side host runs them concurrently — a fast keystroke could
+    // interleave a bundle's tsconfig rewrite with a lint pass and corrupt
+    // either result. The chain keeps compile/bundle/lint linear.
+    let busy = Promise.resolve();
+    const enqueue = (fn) => {
+        const next = busy.then(fn, fn);
+        busy = next.catch(() => { });
+        return next;
+    };
+    const projectFiles = (source, tsconfigText) => ({
+        [`${workDir}/${tsconfigPath}`]: tsconfigText,
+        [`${workDir}/${entryFile}`]: source,
+    });
+    const writeProject = (host, files) => {
+        for (const [path, text] of Object.entries(files)) {
+            host.writeFile(path, text);
+        }
+    };
+    // Typia transform — run the registered typia plugin's `transform` verb,
+    // parse its JSON stdout, and write the rewritten TS back into MemFS so the
+    // subsequent `api.build` sees the post-transform text.
+    const applyTypiaTransform = async (api, host) => {
+        if (!typiaPlugin)
+            return;
+        try {
+            const raw = await api.plugin({
+                name: typiaPluginName,
+                command: "transform",
+                cwd: workDir,
+                tsconfig: tsconfigPath,
+                output: "ts",
+            });
+            if (!raw.stdout)
+                return;
+            const transformed = (0, safeParseTypiaTransform_1.safeParseTypiaTransform)(raw.stdout);
+            if (!transformed)
+                return;
+            for (const [rel, text] of Object.entries(transformed.typescript)) {
+                host.writeFile((0, joinUnder_1.joinUnder)(workDir, rel), text);
+            }
+        }
+        catch {
+            // Swallow plugin spawn / JSON parse failures so the user still sees the
+            // tsgo compile diagnostics from the subsequent build call. Real
+            // user-facing errors (e.g. typia rule violations) flow through the
+            // wasm-side diagnostics path.
+        }
+    };
+    const runBuildPipeline = async (source, runTypia, tsconfigText) => {
+        try {
+            const { api, host } = await getBoot();
+            writeProject(host, projectFiles(source, tsconfigText));
+            if (runTypia)
+                await applyTypiaTransform(api, host);
+            const raw = await api.build({
+                cwd: workDir,
+                tsconfig: tsconfigPath,
+            });
+            if (raw.code !== 0 && !raw.result) {
+                return {
+                    type: "error",
+                    target: "javascript",
+                    value: {
+                        message: raw.stderr || "ttsc: build failed without a result payload",
+                    },
+                };
+            }
+            const parsed = (0, wasm_1.parseResult)(raw);
+            if (!parsed) {
+                return {
+                    type: "error",
+                    target: "javascript",
+                    value: { message: "ttsc: result JSON could not be parsed" },
+                };
+            }
+            const diagnostics = (parsed.diagnostics ?? []).map((d) => (0, mapDiagnostic_1.mapDiagnostic)(d, source));
+            const js = (0, pickEmittedJS_1.pickEmittedJS)(parsed.output ?? {}, entryFile);
+            const errors = diagnostics.filter((d) => d.severity === "error");
+            if (errors.length > 0) {
+                return {
+                    type: "failure",
+                    target: "javascript",
+                    value: js ?? "",
+                    diagnostics,
+                };
+            }
+            return { type: "success", target: "javascript", value: js ?? "" };
+        }
+        catch (error) {
+            return {
+                type: "error",
+                target: "javascript",
+                value: (0, normalizeError_1.normalizeError)(error),
+            };
+        }
+    };
+    // Lint pipeline. The lint plugin emits tsgo-style pretty diagnostics on
+    // stderr; we parse those lines back into IDiagnostic so the UI can render
+    // them in the Lint tab.
+    const runLintPipeline = async (source) => {
+        if (!lintPlugin)
+            return { diagnostics: [] };
+        try {
+            const { api, host } = await getBoot();
+            writeProject(host, projectFiles(source, tsconfigESM));
+            const raw = await api.plugin({
+                name: lintPluginName,
+                command: "check",
+                cwd: workDir,
+                tsconfig: tsconfigPath,
+            });
+            return { diagnostics: (0, parseLintDiagnostics_1.parseLintDiagnostics)(raw.stderr, source) };
+        }
+        catch {
+            return { diagnostics: [] };
+        }
+    };
+    return {
+        installDependencies: (props) => enqueue(async () => {
+            const { host } = await getBoot();
+            return (0, installDependenciesIntoMemFS_1.installDependenciesIntoMemFS)(host, workDir, props);
+        }),
+        compile: (props) => enqueue(() => runBuildPipeline(props.source, shouldRunTypia(props.options), tsconfigESM)),
+        bundle: (props) => enqueue(() => runBuildPipeline(props.source, shouldRunTypia(props.options), tsconfigCJS)),
+        lint: (props) => enqueue(() => runLintPipeline(props.source)),
+    };
+}
+function shouldRunTypia(options) {
+    return options?.typia !== false;
+}
+//# sourceMappingURL=createWorkerCompiler.js.map

package/lib/src/compiler/createWorkerCompiler.js.map

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

package/lib/src/compiler/installDependenciesIntoMemFS.d.ts

@@ -0,0 +1,12 @@
+import type { IMemFSHost } from "@ttsc/wasm";
+import type { ICompilerService } from "../structures/ICompilerService";
+/**
+ * Mount external npm package files into the worker's MemFS under
+ * `<workDir>/node_modules/...`.
+ *
+ * Used by `createWorkerCompiler` to implement the `installDependencies` verb
+ * of `ICompilerService`. The dependency installer (UI side) feeds keys like
+ * `node_modules/uuid/dist/index.js`; we normalize, sanity-check, and copy
+ * each entry under the project root.
+ */
+export declare function installDependenciesIntoMemFS(host: IMemFSHost, workDir: string, props: ICompilerService.IInstallDependenciesProps): ICompilerService.IInstallDependenciesResult;

package/lib/src/compiler/installDependenciesIntoMemFS.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDependenciesIntoMemFS = installDependenciesIntoMemFS;
+const normalizeNodeModulePath_1 = require("./normalizeNodeModulePath");
+/**
+ * Mount external npm package files into the worker's MemFS under
+ * `<workDir>/node_modules/...`.
+ *
+ * Used by `createWorkerCompiler` to implement the `installDependencies` verb
+ * of `ICompilerService`. The dependency installer (UI side) feeds keys like
+ * `node_modules/uuid/dist/index.js`; we normalize, sanity-check, and copy
+ * each entry under the project root.
+ */
+function installDependenciesIntoMemFS(host, workDir, props) {
+    let fileCount = 0;
+    for (const [rel, text] of Object.entries(props.files)) {
+        const normalized = (0, normalizeNodeModulePath_1.normalizeNodeModulePath)(rel);
+        if (!normalized)
+            continue;
+        host.writeFile(`${workDir}/${normalized}`, text);
+        fileCount++;
+    }
+    return { installed: props.packages, fileCount };
+}
+//# sourceMappingURL=installDependenciesIntoMemFS.js.map

package/lib/src/compiler/installDependenciesIntoMemFS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installDependenciesIntoMemFS.js","sourceRoot":"","sources":["../../../src/compiler/installDependenciesIntoMemFS.ts"],"names":[],"mappings":";;;AAGA,uEAAoE;AAEpE;;;;;;;;GAQG;AACH,sCACE,IAAgB,EAChB,OAAe,EACf,KAAiD;IAEjD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,IAAA,iDAAuB,EAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,IAAI,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;QACjD,SAAS,EAAE,CAAC;IACd,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;AAClD,CAAC"}

package/lib/src/compiler/installTypiaSourcePack.d.ts

@@ -0,0 +1,11 @@
+import type { IMemFSHost } from "@ttsc/wasm";
+import type { IInstallTypiaSourcePackOptions } from "../structures/IInstallTypiaSourcePackOptions";
+/**
+ * Mounts typia + @typia/* source trees into the in-browser MemFS so the
+ * wasm-side compiler can resolve `import typia, { tags } from "typia"`
+ * against the same code the published package uses.
+ *
+ * Idempotent on the same host (re-writing the same paths is a no-op for the
+ * MemFS implementation).
+ */
+export declare function installTypiaSourcePack(host: IMemFSHost, options: IInstallTypiaSourcePackOptions): Promise<void>;

package/lib/src/compiler/installTypiaSourcePack.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installTypiaSourcePack = installTypiaSourcePack;
+const loadTypiaSourcePack_1 = require("./loadTypiaSourcePack");
+/**
+ * Mounts typia + @typia/* source trees into the in-browser MemFS so the
+ * wasm-side compiler can resolve `import typia, { tags } from "typia"`
+ * against the same code the published package uses.
+ *
+ * Idempotent on the same host (re-writing the same paths is a no-op for the
+ * MemFS implementation).
+ */
+async function installTypiaSourcePack(host, options) {
+    const mountRoot = options.mountRoot ?? "/work/node_modules";
+    const pack = await (0, loadTypiaSourcePack_1.loadTypiaSourcePack)(options);
+    host.mkdirp(mountRoot);
+    for (const [rel, content] of Object.entries(pack)) {
+        host.writeFile(`${mountRoot}/${rel}`, content);
+    }
+}
+//# sourceMappingURL=installTypiaSourcePack.js.map

package/lib/src/compiler/installTypiaSourcePack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installTypiaSourcePack.js","sourceRoot":"","sources":["../../../src/compiler/installTypiaSourcePack.ts"],"names":[],"mappings":";;;AAGA,+DAA4D;AAE5D;;;;;;;GAOG;AACI,KAAK,iCACV,IAAgB,EAChB,OAAuC;IAEvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,oBAAoB,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,IAAA,yCAAmB,EAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvB,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,IAAI,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/lib/src/compiler/internal/joinUnder.d.ts

@@ -0,0 +1,2 @@
+/** Join a relative path under a base directory, ignoring base when `rel` is absolute. */
+export declare function joinUnder(base: string, rel: string): string;

package/lib/src/compiler/internal/joinUnder.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinUnder = joinUnder;
+/** Join a relative path under a base directory, ignoring base when `rel` is absolute. */
+function joinUnder(base, rel) {
+    if (rel.startsWith("/"))
+        return rel;
+    return `${base}/${rel}`;
+}
+//# sourceMappingURL=joinUnder.js.map

package/lib/src/compiler/internal/joinUnder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"joinUnder.js","sourceRoot":"","sources":["../../../../src/compiler/internal/joinUnder.ts"],"names":[],"mappings":";;;AAAA,yFAAyF;AACzF,mBAA0B,IAAY,EAAE,GAAW;IACjD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,OAAO,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;AAC1B,CAAC"}

package/lib/src/compiler/internal/parseLintDiagnostics.d.ts

@@ -0,0 +1,6 @@
+import type { ICompilerService } from "../../structures/ICompilerService";
+/**
+ * Parse the lint plugin's stderr (tsgo-style pretty diagnostics) into the
+ * playground's normalized diagnostic shape.
+ */
+export declare function parseLintDiagnostics(stderr: string, source: string): ICompilerService.IDiagnostic[];

package/lib/src/compiler/internal/parseLintDiagnostics.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseLintDiagnostics = parseLintDiagnostics;
+// Match `file:line:col - severity TS<code>: [rule-name] message` lines from
+// tsgo's pretty diagnostic renderer. ANSI color escapes are stripped first
+// so the matcher works on the exact text rendered in the Lint tab.
+const LINT_LINE_REGEXP = /([^\s:]+):(\d+):(\d+)\s+-\s+(error|warning)\s+TS(\d+):\s+(?:\[([^\]]+)\]\s+)?(.*)$/;
+// Strip real ANSI SGR sequences, which always start with ESC (0x1b). The
+// leading ESC byte is required — `/\[[0-9;]*m/g` would also chew innocuous
+// substrings like "[m" or "[0;1m" inside diagnostic messages, and would
+// fail to actually strip the ESC bytes tsgo writes, leaving the
+// LINT_LINE_REGEXP unable to anchor on the filename column.
+const ANSI_REGEXP = /\x1b\[[0-9;]*m/g;
+/**
+ * Parse the lint plugin's stderr (tsgo-style pretty diagnostics) into the
+ * playground's normalized diagnostic shape.
+ */
+function parseLintDiagnostics(stderr, source) {
+    const stripped = stderr.replace(ANSI_REGEXP, "");
+    const lines = stripped.split(/\r?\n/);
+    const out = [];
+    for (const line of lines) {
+        const m = line.match(LINT_LINE_REGEXP);
+        if (!m)
+            continue;
+        const [, , lineStr, colStr, sev, codeStr, rule, message] = m;
+        const lineNum = Number(lineStr);
+        const colNum = Number(colStr);
+        if (!Number.isFinite(lineNum) || !Number.isFinite(colNum))
+            continue;
+        out.push({
+            line: lineNum,
+            column: colNum,
+            length: lengthOfTokenAt(source, lineNum, colNum) ?? 1,
+            severity: sev === "warning" ? "warning" : "error",
+            message: rule ? `[${rule}] ${message ?? ""}` : (message ?? ""),
+            code: `TS${codeStr ?? ""}`,
+        });
+    }
+    return out;
+}
+/**
+ * Best-effort length of the identifier-like token starting at (`line`, `column`)
+ * in `source`. Falls back to 1 when no token is found.
+ */
+function lengthOfTokenAt(source, line, column) {
+    const lines = source.split(/\r?\n/);
+    if (line < 1 || line > lines.length)
+        return null;
+    const text = lines[line - 1] ?? "";
+    const start = Math.max(0, column - 1);
+    const match = text.slice(start).match(/^[\w$]+/);
+    if (!match)
+        return null;
+    return match[0].length;
+}
+//# sourceMappingURL=parseLintDiagnostics.js.map

package/lib/src/compiler/internal/parseLintDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseLintDiagnostics.js","sourceRoot":"","sources":["../../../../src/compiler/internal/parseLintDiagnostics.ts"],"names":[],"mappings":";;;AAEA,4EAA4E;AAC5E,2EAA2E;AAC3E,mEAAmE;AACnE,MAAM,gBAAgB,GACpB,oFAAoF,CAAC;AACvF,yEAAyE;AACzE,2EAA2E;AAC3E,wEAAwE;AACxE,gEAAgE;AAChE,4DAA4D;AAC5D,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC;;;GAGG;AACH,8BACE,MAAc,EACd,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,GAAG,GAAmC,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,CAAC,EAAE,AAAD,EAAG,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS;QACpE,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;YACrD,QAAQ,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;YACjD,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;YAC9D,IAAI,EAAE,KAAK,OAAO,IAAI,EAAE,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CACtB,MAAc,EACd,IAAY,EACZ,MAAc;IAEd,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACzB,CAAC"}

package/lib/src/compiler/internal/safeParseTypiaTransform.d.ts

@@ -0,0 +1,11 @@
+/** Shape of the typia transform plugin's stdout JSON payload. */
+export interface ITypiaTransformOutput {
+    diagnostics?: unknown;
+    typescript: Record<string, string>;
+}
+/**
+ * Parse the typia transform plugin's stdout into the expected shape.
+ * Returns null on any parse / shape mismatch — the caller treats null as
+ * "transform produced no usable output".
+ */
+export declare function safeParseTypiaTransform(text: string): ITypiaTransformOutput | null;

package/lib/src/compiler/internal/safeParseTypiaTransform.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeParseTypiaTransform = safeParseTypiaTransform;
+/**
+ * Parse the typia transform plugin's stdout into the expected shape.
+ * Returns null on any parse / shape mismatch — the caller treats null as
+ * "transform produced no usable output".
+ */
+function safeParseTypiaTransform(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed && typeof parsed === "object" && parsed.typescript) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=safeParseTypiaTransform.js.map

package/lib/src/compiler/internal/safeParseTypiaTransform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeParseTypiaTransform.js","sourceRoot":"","sources":["../../../../src/compiler/internal/safeParseTypiaTransform.ts"],"names":[],"mappings":";;;AAMA;;;;GAIG;AACH,iCACE,IAAY;IAEZ,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA0B,CAAC;QACzD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC9D,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/lib/src/compiler/lineColumnOf.d.ts

@@ -0,0 +1,5 @@
+/** Compute 1-based line/column for a 0-based char offset into `source`. */
+export declare function lineColumnOf(source: string, start: number | undefined): {
+    line: number;
+    column: number;
+};

package/lib/src/compiler/lineColumnOf.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lineColumnOf = lineColumnOf;
+/** Compute 1-based line/column for a 0-based char offset into `source`. */
+function lineColumnOf(source, start) {
+    if (typeof start !== "number" || start < 0)
+        return { line: 1, column: 1 };
+    const slice = source.slice(0, Math.min(start, source.length));
+    const newlines = slice.match(/\n/g);
+    const line = newlines ? newlines.length + 1 : 1;
+    const lastNewline = slice.lastIndexOf("\n");
+    const column = lastNewline === -1 ? slice.length + 1 : slice.length - lastNewline;
+    return { line, column };
+}
+//# sourceMappingURL=lineColumnOf.js.map

package/lib/src/compiler/lineColumnOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineColumnOf.js","sourceRoot":"","sources":["../../../src/compiler/lineColumnOf.ts"],"names":[],"mappings":";;;AAAA,2EAA2E;AAC3E,sBACE,MAAc,EACd,KAAyB;IAEzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GACV,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;IACrE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC"}

package/lib/src/compiler/loadTypiaSourcePack.d.ts

@@ -0,0 +1,8 @@
+import type { IInstallTypiaSourcePackOptions } from "../structures/IInstallTypiaSourcePackOptions";
+/**
+ * Fetch the typia source pack JSON. Cached per URL across calls. On
+ * rejection the cache entry is cleared so the next call retries —
+ * otherwise a transient fetch failure during the first boot would wedge
+ * every later boot through `getBoot`'s typiaPlugin.mount path.
+ */
+export declare function loadTypiaSourcePack(options: IInstallTypiaSourcePackOptions): Promise<Record<string, string>>;

package/lib/src/compiler/loadTypiaSourcePack.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTypiaSourcePack = loadTypiaSourcePack;
+const packCache = new Map();
+/**
+ * Fetch the typia source pack JSON. Cached per URL across calls. On
+ * rejection the cache entry is cleared so the next call retries —
+ * otherwise a transient fetch failure during the first boot would wedge
+ * every later boot through `getBoot`'s typiaPlugin.mount path.
+ */
+function loadTypiaSourcePack(options) {
+    const cached = packCache.get(options.url);
+    if (cached)
+        return cached;
+    const fetchImpl = options.fetch ?? globalThis.fetch?.bind(globalThis);
+    if (!fetchImpl) {
+        throw new Error("loadTypiaSourcePack: no fetch implementation available in this environment.");
+    }
+    const url = options.url;
+    const promise = (async () => {
+        const response = await fetchImpl(url);
+        if (!response.ok) {
+            throw new Error(`loadTypiaSourcePack: failed to fetch ${url}: ${response.status}`);
+        }
+        return (await response.json());
+    })().catch((err) => {
+        packCache.delete(url);
+        throw err;
+    });
+    packCache.set(url, promise);
+    return promise;
+}
+//# sourceMappingURL=loadTypiaSourcePack.js.map

package/lib/src/compiler/loadTypiaSourcePack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTypiaSourcePack.js","sourceRoot":"","sources":["../../../src/compiler/loadTypiaSourcePack.ts"],"names":[],"mappings":";;;AAEA,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2C,CAAC;AAErE;;;;;GAKG;AACH,6BACE,OAAuC;IAEvC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,wCAAwC,GAAG,KAAK,QAAQ,CAAC,MAAM,EAAE,CAClE,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA2B,CAAC;IAC3D,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACjB,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/src/compiler/mapDiagnostic.d.ts

@@ -0,0 +1,9 @@
+import type { ITtscCompileResult } from "@ttsc/wasm";
+import type { ICompilerService } from "../structures/ICompilerService";
+/**
+ * Convert a `@ttsc/wasm` diagnostic into the playground's normalized shape.
+ *
+ * Falls back to computing line/column from the source text when the wasm
+ * diagnostic did not carry them (some plugin emitters drop them).
+ */
+export declare function mapDiagnostic(diag: NonNullable<ITtscCompileResult["diagnostics"]>[number], source: string): ICompilerService.IDiagnostic;

package/lib/src/compiler/mapDiagnostic.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapDiagnostic = mapDiagnostic;
+const lineColumnOf_1 = require("./lineColumnOf");
+/**
+ * Convert a `@ttsc/wasm` diagnostic into the playground's normalized shape.
+ *
+ * Falls back to computing line/column from the source text when the wasm
+ * diagnostic did not carry them (some plugin emitters drop them).
+ */
+function mapDiagnostic(diag, source) {
+    const fallback = (0, lineColumnOf_1.lineColumnOf)(source, diag.start);
+    return {
+        line: diag.line && diag.line > 0 ? diag.line : fallback.line,
+        column: diag.character && diag.character > 0 ? diag.character : fallback.column,
+        length: typeof diag.length === "number" ? diag.length : 1,
+        severity: diag.category === "warning" ? "warning" : "error",
+        message: diag.messageText,
+        code: typeof diag.code === "number" ? `TS${diag.code}` : String(diag.code),
+    };
+}
+//# sourceMappingURL=mapDiagnostic.js.map

package/lib/src/compiler/mapDiagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapDiagnostic.js","sourceRoot":"","sources":["../../../src/compiler/mapDiagnostic.ts"],"names":[],"mappings":";;;AAGA,iDAA8C;AAE9C;;;;;GAKG;AACH,uBACE,IAA4D,EAC5D,MAAc;IAEd,MAAM,QAAQ,GAAG,IAAA,2BAAY,EAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI;QAC5D,MAAM,EACJ,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM;QACzE,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzD,QAAQ,EAAE,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;QAC3D,OAAO,EAAE,IAAI,CAAC,WAAW;QACzB,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;KAC3E,CAAC;AACJ,CAAC"}

package/lib/src/compiler/normalizeError.d.ts

@@ -0,0 +1,2 @@
+/** Best-effort error normalization for tgrid transport. */
+export declare function normalizeError(error: unknown): unknown;

package/lib/src/compiler/normalizeError.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeError = normalizeError;
+/** Best-effort error normalization for tgrid transport. */
+function normalizeError(error) {
+    if (error instanceof Error)
+        return { name: error.name, message: error.message, stack: error.stack };
+    if (error &&
+        typeof error === "object" &&
+        "message" in error)
+        return error;
+    return { name: "Error", message: String(error) };
+}
+//# sourceMappingURL=normalizeError.js.map

package/lib/src/compiler/normalizeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeError.js","sourceRoot":"","sources":["../../../src/compiler/normalizeError.ts"],"names":[],"mappings":";;;AAAA,2DAA2D;AAC3D,wBAA+B,KAAc;IAC3C,IAAI,KAAK,YAAY,KAAK;QACxB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC1E,IACE,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,SAAS,IAAK,KAAiC;QAE/C,OAAO,KAAK,CAAC;IACf,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACnD,CAAC"}

package/lib/src/compiler/normalizeNodeModulePath.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Accept either `node_modules/...` or `/node_modules/...` (or backslash
+ * variants); reject anything that escapes the node_modules root via `..`.
+ *
+ * Returns `null` for paths that don't match the expected shape — the caller
+ * skips those entries instead of writing them to the MemFS.
+ */
+export declare function normalizeNodeModulePath(path: string): string | null;

package/lib/src/compiler/normalizeNodeModulePath.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeNodeModulePath = normalizeNodeModulePath;
+/**
+ * Accept either `node_modules/...` or `/node_modules/...` (or backslash
+ * variants); reject anything that escapes the node_modules root via `..`.
+ *
+ * Returns `null` for paths that don't match the expected shape — the caller
+ * skips those entries instead of writing them to the MemFS.
+ */
+function normalizeNodeModulePath(path) {
+    const normalized = path.replace(/\\/g, "/").replace(/^\/+/, "");
+    if (!normalized.startsWith("node_modules/"))
+        return null;
+    if (normalized.split("/").some((segment) => segment === ".."))
+        return null;
+    return normalized;
+}
+//# sourceMappingURL=normalizeNodeModulePath.js.map

package/lib/src/compiler/normalizeNodeModulePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeNodeModulePath.js","sourceRoot":"","sources":["../../../src/compiler/normalizeNodeModulePath.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,iCAAwC,IAAY;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/lib/src/compiler/pickEmittedJS.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Pick the most likely emitted JavaScript file from a compile result's output
+ * map. Tries common paths first, then falls back to the first `.js` entry.
+ * Returns null when no `.js` was emitted.
+ */
+export declare function pickEmittedJS(output: Record<string, string>, entryFile: string): string | null;