@ttsc/playground 0.14.0-dev.20250530.1

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;

package/lib/src/compiler/pickEmittedJS.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickEmittedJS = pickEmittedJS;
+/**
+ * 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.
+ */
+function pickEmittedJS(output, entryFile) {
+    const base = entryFile.replace(/\.[cm]?tsx?$/i, ".js");
+    const candidates = [`dist/${base}`, `dist/src/${base}`, `src/${base}`, base];
+    for (const key of candidates) {
+        if (output[key] !== undefined)
+            return output[key];
+    }
+    const jsKeys = Object.keys(output).filter((k) => k.endsWith(".js"));
+    if (jsKeys.length > 0)
+        return output[jsKeys[0]] ?? null;
+    return null;
+}
+//# sourceMappingURL=pickEmittedJS.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pickEmittedJS.js","sourceRoot":"","sources":["../../../src/compiler/pickEmittedJS.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,uBACE,MAA8B,EAC9B,SAAiB;IAEjB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,YAAY,IAAI,EAAE,EAAE,OAAO,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7E,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,IAAI,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/src/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `@ttsc/playground` — reusable Web Worker + React scaffolding for in-browser
+ * ttsc playgrounds built on `@ttsc/wasm`.
+ *
+ * The package is organized by concern: the `compiler/*` modules implement the
+ * worker-side `ICompilerService` contract; the `npm/*` modules install
+ * on-the-fly npm dependencies into the wasm MemFS; the `sandbox/*` modules
+ * drive an in-page `new Function` execute sandbox; the `react/*` modules render
+ * the shell, editor, and result panes.
+ *
+ * The package root re-exports everything; sub-path imports are not needed.
+ */
+export { buildTsconfigJSON } from "./compiler/buildTsconfigJSON";
+export { createTypiaSourcePackMount } from "./compiler/createTypiaSourcePackMount";
+export { createWorkerCompiler } from "./compiler/createWorkerCompiler";
+export { DEFAULT_ENTRY_FILE } from "./compiler/DEFAULT_ENTRY_FILE";
+export { DEFAULT_LINT_PLUGIN_NAME } from "./compiler/DEFAULT_LINT_PLUGIN_NAME";
+export { DEFAULT_PLAYGROUND_COMPILER_OPTIONS } from "./compiler/DEFAULT_PLAYGROUND_COMPILER_OPTIONS";
+export { DEFAULT_TSCONFIG_PATH } from "./compiler/DEFAULT_TSCONFIG_PATH";
+export { DEFAULT_TYPIA_PLUGIN_NAME } from "./compiler/DEFAULT_TYPIA_PLUGIN_NAME";
+export { DEFAULT_WORK_DIR } from "./compiler/DEFAULT_WORK_DIR";
+export { installDependenciesIntoMemFS } from "./compiler/installDependenciesIntoMemFS";
+export { installTypiaSourcePack } from "./compiler/installTypiaSourcePack";
+export { lineColumnOf } from "./compiler/lineColumnOf";
+export { loadTypiaSourcePack } from "./compiler/loadTypiaSourcePack";
+export { mapDiagnostic } from "./compiler/mapDiagnostic";
+export { normalizeError } from "./compiler/normalizeError";
+export { normalizeNodeModulePath } from "./compiler/normalizeNodeModulePath";
+export { pickEmittedJS } from "./compiler/pickEmittedJS";
+export { BUILT_IN_PLAYGROUND_PACKAGES } from "./npm/BUILT_IN_PLAYGROUND_PACKAGES";
+export { collectExternalPackageNames } from "./npm/collectExternalPackageNames";
+export { installPlaygroundDependencies } from "./npm/installPlaygroundDependencies";
+export { packageNameFromSpecifier } from "./npm/packageNameFromSpecifier";
+export { createSandboxRequire } from "./sandbox/createSandboxRequire";
+export { loadTypiaRuntimePack } from "./sandbox/loadTypiaRuntimePack";
+export { ConsoleViewer } from "./react/ConsoleViewer";
+export { createCompilerClient } from "./react/createCompilerClient";
+export { DEFAULT_OPTION_TOGGLES } from "./react/DEFAULT_OPTION_TOGGLES";
+export { DependencyProgressModal } from "./react/DependencyProgressModal";
+export { DiagnosticsPanel } from "./react/DiagnosticsPanel";
+export { ExamplePicker } from "./react/ExamplePicker";
+export { LintPane } from "./react/LintPane";
+export { OptionsPanel } from "./react/OptionsPanel";
+export { PlaygroundShell } from "./react/PlaygroundShell";
+export { ResultViewer } from "./react/ResultViewer";
+export { SourceEditor } from "./react/SourceEditor";
+export * from "./structures/index";

package/lib/src/index.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * `@ttsc/playground` — reusable Web Worker + React scaffolding for in-browser
+ * ttsc playgrounds built on `@ttsc/wasm`.
+ *
+ * The package is organized by concern: the `compiler/*` modules implement the
+ * worker-side `ICompilerService` contract; the `npm/*` modules install
+ * on-the-fly npm dependencies into the wasm MemFS; the `sandbox/*` modules
+ * drive an in-page `new Function` execute sandbox; the `react/*` modules render
+ * the shell, editor, and result panes.
+ *
+ * The package root re-exports everything; sub-path imports are not needed.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SourceEditor = exports.ResultViewer = exports.PlaygroundShell = exports.OptionsPanel = exports.LintPane = exports.ExamplePicker = exports.DiagnosticsPanel = exports.DependencyProgressModal = exports.DEFAULT_OPTION_TOGGLES = exports.createCompilerClient = exports.ConsoleViewer = exports.loadTypiaRuntimePack = exports.createSandboxRequire = exports.packageNameFromSpecifier = exports.installPlaygroundDependencies = exports.collectExternalPackageNames = exports.BUILT_IN_PLAYGROUND_PACKAGES = exports.pickEmittedJS = exports.normalizeNodeModulePath = exports.normalizeError = exports.mapDiagnostic = exports.loadTypiaSourcePack = exports.lineColumnOf = exports.installTypiaSourcePack = exports.installDependenciesIntoMemFS = exports.DEFAULT_WORK_DIR = exports.DEFAULT_TYPIA_PLUGIN_NAME = exports.DEFAULT_TSCONFIG_PATH = exports.DEFAULT_PLAYGROUND_COMPILER_OPTIONS = exports.DEFAULT_LINT_PLUGIN_NAME = exports.DEFAULT_ENTRY_FILE = exports.createWorkerCompiler = exports.createTypiaSourcePackMount = exports.buildTsconfigJSON = void 0;
+// ── compiler / worker core ────────────────────────────────────────────────
+var buildTsconfigJSON_1 = require("./compiler/buildTsconfigJSON");
+Object.defineProperty(exports, "buildTsconfigJSON", { enumerable: true, get: function () { return buildTsconfigJSON_1.buildTsconfigJSON; } });
+var createTypiaSourcePackMount_1 = require("./compiler/createTypiaSourcePackMount");
+Object.defineProperty(exports, "createTypiaSourcePackMount", { enumerable: true, get: function () { return createTypiaSourcePackMount_1.createTypiaSourcePackMount; } });
+var createWorkerCompiler_1 = require("./compiler/createWorkerCompiler");
+Object.defineProperty(exports, "createWorkerCompiler", { enumerable: true, get: function () { return createWorkerCompiler_1.createWorkerCompiler; } });
+var DEFAULT_ENTRY_FILE_1 = require("./compiler/DEFAULT_ENTRY_FILE");
+Object.defineProperty(exports, "DEFAULT_ENTRY_FILE", { enumerable: true, get: function () { return DEFAULT_ENTRY_FILE_1.DEFAULT_ENTRY_FILE; } });
+var DEFAULT_LINT_PLUGIN_NAME_1 = require("./compiler/DEFAULT_LINT_PLUGIN_NAME");
+Object.defineProperty(exports, "DEFAULT_LINT_PLUGIN_NAME", { enumerable: true, get: function () { return DEFAULT_LINT_PLUGIN_NAME_1.DEFAULT_LINT_PLUGIN_NAME; } });
+var DEFAULT_PLAYGROUND_COMPILER_OPTIONS_1 = require("./compiler/DEFAULT_PLAYGROUND_COMPILER_OPTIONS");
+Object.defineProperty(exports, "DEFAULT_PLAYGROUND_COMPILER_OPTIONS", { enumerable: true, get: function () { return DEFAULT_PLAYGROUND_COMPILER_OPTIONS_1.DEFAULT_PLAYGROUND_COMPILER_OPTIONS; } });
+var DEFAULT_TSCONFIG_PATH_1 = require("./compiler/DEFAULT_TSCONFIG_PATH");
+Object.defineProperty(exports, "DEFAULT_TSCONFIG_PATH", { enumerable: true, get: function () { return DEFAULT_TSCONFIG_PATH_1.DEFAULT_TSCONFIG_PATH; } });
+var DEFAULT_TYPIA_PLUGIN_NAME_1 = require("./compiler/DEFAULT_TYPIA_PLUGIN_NAME");
+Object.defineProperty(exports, "DEFAULT_TYPIA_PLUGIN_NAME", { enumerable: true, get: function () { return DEFAULT_TYPIA_PLUGIN_NAME_1.DEFAULT_TYPIA_PLUGIN_NAME; } });
+var DEFAULT_WORK_DIR_1 = require("./compiler/DEFAULT_WORK_DIR");
+Object.defineProperty(exports, "DEFAULT_WORK_DIR", { enumerable: true, get: function () { return DEFAULT_WORK_DIR_1.DEFAULT_WORK_DIR; } });
+var installDependenciesIntoMemFS_1 = require("./compiler/installDependenciesIntoMemFS");
+Object.defineProperty(exports, "installDependenciesIntoMemFS", { enumerable: true, get: function () { return installDependenciesIntoMemFS_1.installDependenciesIntoMemFS; } });
+var installTypiaSourcePack_1 = require("./compiler/installTypiaSourcePack");
+Object.defineProperty(exports, "installTypiaSourcePack", { enumerable: true, get: function () { return installTypiaSourcePack_1.installTypiaSourcePack; } });
+var lineColumnOf_1 = require("./compiler/lineColumnOf");
+Object.defineProperty(exports, "lineColumnOf", { enumerable: true, get: function () { return lineColumnOf_1.lineColumnOf; } });
+var loadTypiaSourcePack_1 = require("./compiler/loadTypiaSourcePack");
+Object.defineProperty(exports, "loadTypiaSourcePack", { enumerable: true, get: function () { return loadTypiaSourcePack_1.loadTypiaSourcePack; } });
+var mapDiagnostic_1 = require("./compiler/mapDiagnostic");
+Object.defineProperty(exports, "mapDiagnostic", { enumerable: true, get: function () { return mapDiagnostic_1.mapDiagnostic; } });
+var normalizeError_1 = require("./compiler/normalizeError");
+Object.defineProperty(exports, "normalizeError", { enumerable: true, get: function () { return normalizeError_1.normalizeError; } });
+var normalizeNodeModulePath_1 = require("./compiler/normalizeNodeModulePath");
+Object.defineProperty(exports, "normalizeNodeModulePath", { enumerable: true, get: function () { return normalizeNodeModulePath_1.normalizeNodeModulePath; } });
+var pickEmittedJS_1 = require("./compiler/pickEmittedJS");
+Object.defineProperty(exports, "pickEmittedJS", { enumerable: true, get: function () { return pickEmittedJS_1.pickEmittedJS; } });
+// ── npm-from-the-browser dependency installer ─────────────────────────────
+var BUILT_IN_PLAYGROUND_PACKAGES_1 = require("./npm/BUILT_IN_PLAYGROUND_PACKAGES");
+Object.defineProperty(exports, "BUILT_IN_PLAYGROUND_PACKAGES", { enumerable: true, get: function () { return BUILT_IN_PLAYGROUND_PACKAGES_1.BUILT_IN_PLAYGROUND_PACKAGES; } });
+var collectExternalPackageNames_1 = require("./npm/collectExternalPackageNames");
+Object.defineProperty(exports, "collectExternalPackageNames", { enumerable: true, get: function () { return collectExternalPackageNames_1.collectExternalPackageNames; } });
+var installPlaygroundDependencies_1 = require("./npm/installPlaygroundDependencies");
+Object.defineProperty(exports, "installPlaygroundDependencies", { enumerable: true, get: function () { return installPlaygroundDependencies_1.installPlaygroundDependencies; } });
+var packageNameFromSpecifier_1 = require("./npm/packageNameFromSpecifier");
+Object.defineProperty(exports, "packageNameFromSpecifier", { enumerable: true, get: function () { return packageNameFromSpecifier_1.packageNameFromSpecifier; } });
+// ── typia runtime sandbox (CJS-flavoured require over a pack JSON) ────────
+var createSandboxRequire_1 = require("./sandbox/createSandboxRequire");
+Object.defineProperty(exports, "createSandboxRequire", { enumerable: true, get: function () { return createSandboxRequire_1.createSandboxRequire; } });
+var loadTypiaRuntimePack_1 = require("./sandbox/loadTypiaRuntimePack");
+Object.defineProperty(exports, "loadTypiaRuntimePack", { enumerable: true, get: function () { return loadTypiaRuntimePack_1.loadTypiaRuntimePack; } });
+// ── React UI surface ──────────────────────────────────────────────────────
+var ConsoleViewer_1 = require("./react/ConsoleViewer");
+Object.defineProperty(exports, "ConsoleViewer", { enumerable: true, get: function () { return ConsoleViewer_1.ConsoleViewer; } });
+var createCompilerClient_1 = require("./react/createCompilerClient");
+Object.defineProperty(exports, "createCompilerClient", { enumerable: true, get: function () { return createCompilerClient_1.createCompilerClient; } });
+var DEFAULT_OPTION_TOGGLES_1 = require("./react/DEFAULT_OPTION_TOGGLES");
+Object.defineProperty(exports, "DEFAULT_OPTION_TOGGLES", { enumerable: true, get: function () { return DEFAULT_OPTION_TOGGLES_1.DEFAULT_OPTION_TOGGLES; } });
+var DependencyProgressModal_1 = require("./react/DependencyProgressModal");
+Object.defineProperty(exports, "DependencyProgressModal", { enumerable: true, get: function () { return DependencyProgressModal_1.DependencyProgressModal; } });
+var DiagnosticsPanel_1 = require("./react/DiagnosticsPanel");
+Object.defineProperty(exports, "DiagnosticsPanel", { enumerable: true, get: function () { return DiagnosticsPanel_1.DiagnosticsPanel; } });
+var ExamplePicker_1 = require("./react/ExamplePicker");
+Object.defineProperty(exports, "ExamplePicker", { enumerable: true, get: function () { return ExamplePicker_1.ExamplePicker; } });
+var LintPane_1 = require("./react/LintPane");
+Object.defineProperty(exports, "LintPane", { enumerable: true, get: function () { return LintPane_1.LintPane; } });
+var OptionsPanel_1 = require("./react/OptionsPanel");
+Object.defineProperty(exports, "OptionsPanel", { enumerable: true, get: function () { return OptionsPanel_1.OptionsPanel; } });
+var PlaygroundShell_1 = require("./react/PlaygroundShell");
+Object.defineProperty(exports, "PlaygroundShell", { enumerable: true, get: function () { return PlaygroundShell_1.PlaygroundShell; } });
+var ResultViewer_1 = require("./react/ResultViewer");
+Object.defineProperty(exports, "ResultViewer", { enumerable: true, get: function () { return ResultViewer_1.ResultViewer; } });
+var SourceEditor_1 = require("./react/SourceEditor");
+Object.defineProperty(exports, "SourceEditor", { enumerable: true, get: function () { return SourceEditor_1.SourceEditor; } });
+// ── structured types ──────────────────────────────────────────────────────
+__exportStar(require("./structures/index"), exports);
+//# sourceMappingURL=index.js.map

package/lib/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;AAEH,6EAA6E;AAC7E,kEAAiE;AAAxD,sHAAA,iBAAiB,OAAA;AAC1B,oFAAmF;AAA1E,wIAAA,0BAA0B,OAAA;AACnC,wEAAuE;AAA9D,4HAAA,oBAAoB,OAAA;AAC7B,oEAAmE;AAA1D,wHAAA,kBAAkB,OAAA;AAC3B,gFAA+E;AAAtE,oIAAA,wBAAwB,OAAA;AACjC,sGAAqG;AAA5F,0JAAA,mCAAmC,OAAA;AAC5C,0EAAyE;AAAhE,8HAAA,qBAAqB,OAAA;AAC9B,kFAAiF;AAAxE,sIAAA,yBAAyB,OAAA;AAClC,gEAA+D;AAAtD,oHAAA,gBAAgB,OAAA;AACzB,wFAAuF;AAA9E,4IAAA,4BAA4B,OAAA;AACrC,4EAA2E;AAAlE,gIAAA,sBAAsB,OAAA;AAC/B,wDAAuD;AAA9C,4GAAA,YAAY,OAAA;AACrB,sEAAqE;AAA5D,0HAAA,mBAAmB,OAAA;AAC5B,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AACtB,4DAA2D;AAAlD,gHAAA,cAAc,OAAA;AACvB,8EAA6E;AAApE,kIAAA,uBAAuB,OAAA;AAChC,0DAAyD;AAAhD,8GAAA,aAAa,OAAA;AAEtB,6EAA6E;AAC7E,mFAAkF;AAAzE,4IAAA,4BAA4B,OAAA;AACrC,iFAAgF;AAAvE,0IAAA,2BAA2B,OAAA;AACpC,qFAAoF;AAA3E,8IAAA,6BAA6B,OAAA;AACtC,2EAA0E;AAAjE,oIAAA,wBAAwB,OAAA;AAEjC,6EAA6E;AAC7E,uEAAsE;AAA7D,4HAAA,oBAAoB,OAAA;AAC7B,uEAAsE;AAA7D,4HAAA,oBAAoB,OAAA;AAE7B,6EAA6E;AAC7E,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,qEAAoE;AAA3D,4HAAA,oBAAoB,OAAA;AAC7B,yEAAwE;AAA/D,gIAAA,sBAAsB,OAAA;AAC/B,2EAA0E;AAAjE,kIAAA,uBAAuB,OAAA;AAChC,6DAA4D;AAAnD,oHAAA,gBAAgB,OAAA;AACzB,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,6CAA4C;AAAnC,oGAAA,QAAQ,OAAA;AACjB,qDAAoD;AAA3C,4GAAA,YAAY,OAAA;AACrB,2DAA0D;AAAjD,kHAAA,eAAe,OAAA;AACxB,qDAAoD;AAA3C,4GAAA,YAAY,OAAA;AACrB,qDAAoD;AAA3C,4GAAA,YAAY,OAAA;AAErB,6EAA6E;AAC7E,qDAAmC"}

package/lib/src/npm/BUILT_IN_PLAYGROUND_PACKAGES.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Packages the typia source pack already mounts inside the wasm. The npm
+ * installer skips these so it doesn't try to fetch typia / @typia/* from the
+ * registry on top of the mounted source tree.
+ */
+export declare const BUILT_IN_PLAYGROUND_PACKAGES: readonly ["typia", "@typia/interface", "@typia/utils", "@standard-schema/spec"];

package/lib/src/npm/BUILT_IN_PLAYGROUND_PACKAGES.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILT_IN_PLAYGROUND_PACKAGES = void 0;
+/**
+ * Packages the typia source pack already mounts inside the wasm. The npm
+ * installer skips these so it doesn't try to fetch typia / @typia/* from the
+ * registry on top of the mounted source tree.
+ */
+exports.BUILT_IN_PLAYGROUND_PACKAGES = [
+    "typia",
+    "@typia/interface",
+    "@typia/utils",
+    "@standard-schema/spec",
+];
+//# sourceMappingURL=BUILT_IN_PLAYGROUND_PACKAGES.js.map

package/lib/src/npm/BUILT_IN_PLAYGROUND_PACKAGES.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BUILT_IN_PLAYGROUND_PACKAGES.js","sourceRoot":"","sources":["../../../src/npm/BUILT_IN_PLAYGROUND_PACKAGES.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,4BAA4B,GAAG;IAC1C,OAAO;IACP,kBAAkB;IAClB,cAAc;IACd,uBAAuB;CACf,CAAC"}

package/lib/src/npm/collectExternalPackageNames.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Scan `source` for `import` / `require` specifiers and return the unique
+ * sorted list of bare npm package names that are not in `ignoredPackages`.
+ */
+export declare function collectExternalPackageNames(source: string, ignoredPackages?: Iterable<string>): string[];

package/lib/src/npm/collectExternalPackageNames.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectExternalPackageNames = collectExternalPackageNames;
+const BUILT_IN_PLAYGROUND_PACKAGES_1 = require("./BUILT_IN_PLAYGROUND_PACKAGES");
+const packageNameFromSpecifier_1 = require("./packageNameFromSpecifier");
+const MODULE_SPECIFIER_REGEXP = /\b(?:import|export)\s+(?:type\s+)?(?:[^"'()]*?\s+from\s*)?["']([^"']+)["']|import\s*\(\s*["']([^"']+)["']\s*\)|require\s*\(\s*["']([^"']+)["']\s*\)/g;
+/**
+ * Scan `source` for `import` / `require` specifiers and return the unique
+ * sorted list of bare npm package names that are not in `ignoredPackages`.
+ */
+function collectExternalPackageNames(source, ignoredPackages = BUILT_IN_PLAYGROUND_PACKAGES_1.BUILT_IN_PLAYGROUND_PACKAGES) {
+    const ignored = new Set(ignoredPackages);
+    const found = new Set();
+    for (const specifier of collectModuleSpecifiers(source)) {
+        const packageName = (0, packageNameFromSpecifier_1.packageNameFromSpecifier)(specifier);
+        if (packageName && !ignored.has(packageName))
+            found.add(packageName);
+    }
+    return [...found].sort();
+}
+function collectModuleSpecifiers(source) {
+    const out = [];
+    MODULE_SPECIFIER_REGEXP.lastIndex = 0;
+    for (;;) {
+        const match = MODULE_SPECIFIER_REGEXP.exec(source);
+        if (!match)
+            break;
+        const specifier = match[1] ?? match[2] ?? match[3];
+        if (specifier)
+            out.push(specifier);
+    }
+    return out;
+}
+//# sourceMappingURL=collectExternalPackageNames.js.map

package/lib/src/npm/collectExternalPackageNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectExternalPackageNames.js","sourceRoot":"","sources":["../../../src/npm/collectExternalPackageNames.ts"],"names":[],"mappings":";;;AAAA,iFAA8E;AAC9E,yEAAsE;AAEtE,MAAM,uBAAuB,GAC3B,sJAAsJ,CAAC;AAEzJ;;;GAGG;AACH,qCACE,MAAc,EACd,eAAe,GAAqB,2DAA4B;IAEhE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,SAAS,IAAI,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,IAAA,mDAAwB,EAAC,SAAS,CAAC,CAAC;QACxD,IAAI,WAAW,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC7C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,uBAAuB,CAAC,SAAS,GAAG,CAAC,CAAC;IACtC,SAAS,CAAC;QACR,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK;YAAE,MAAM;QAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QACnD,IAAI,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/src/npm/installPlaygroundDependencies.d.ts

@@ -0,0 +1,13 @@
+import type { IPlaygroundDependencyInstallOptions } from "../structures/IPlaygroundDependencyInstallOptions";
+import type { IPlaygroundDependencyInstallResult } from "../structures/IPlaygroundDependencyInstallResult";
+/**
+ * Resolve, download, and unpack a set of npm packages directly inside the
+ * browser, returning their files keyed for the wasm-side MemFS, Monaco's
+ * extra-libs registry, and the in-page execute sandbox `require`.
+ *
+ * Transitive dependencies are followed via the resolved `package.json`'s
+ * `dependencies` and (non-optional) `peerDependencies` fields. The walk is
+ * bounded by `maxPackages` to keep a single keystroke from exhausting the tab's
+ * network/memory budget.
+ */
+export declare function installPlaygroundDependencies(packageNames: Iterable<string>, options?: IPlaygroundDependencyInstallOptions): Promise<IPlaygroundDependencyInstallResult>;

package/lib/src/npm/installPlaygroundDependencies.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installPlaygroundDependencies = installPlaygroundDependencies;
+const BUILT_IN_PLAYGROUND_PACKAGES_1 = require("./BUILT_IN_PLAYGROUND_PACKAGES");
+const npmRegistry_1 = require("./internal/npmRegistry");
+const DEFAULT_MAX_PACKAGES = 48;
+/**
+ * Resolve, download, and unpack a set of npm packages directly inside the
+ * browser, returning their files keyed for the wasm-side MemFS, Monaco's
+ * extra-libs registry, and the in-page execute sandbox `require`.
+ *
+ * Transitive dependencies are followed via the resolved `package.json`'s
+ * `dependencies` and (non-optional) `peerDependencies` fields. The walk is
+ * bounded by `maxPackages` to keep a single keystroke from exhausting the tab's
+ * network/memory budget.
+ */
+async function installPlaygroundDependencies(packageNames, options = {}) {
+    const fetchImpl = options.fetch ?? globalThis.fetch?.bind(globalThis);
+    if (!fetchImpl) {
+        throw new Error("installPlaygroundDependencies requires fetch.");
+    }
+    (0, npmRegistry_1.throwIfAborted)(options.signal);
+    const ignored = new Set(options.ignoredPackages ?? BUILT_IN_PLAYGROUND_PACKAGES_1.BUILT_IN_PLAYGROUND_PACKAGES);
+    const installed = new Set(options.installedPackages ?? []);
+    const maxPackages = options.maxPackages ?? DEFAULT_MAX_PACKAGES;
+    const queue = [];
+    const queued = new Set();
+    const done = new Set();
+    const result = {
+        packages: [],
+        compilerFiles: {},
+        editorLibs: {},
+        runtimeFiles: {},
+    };
+    const enqueue = (item) => {
+        if (ignored.has(item.name) || installed.has(item.name))
+            return;
+        if (queued.has(item.name) || done.has(item.name))
+            return;
+        queued.add(item.name);
+        queue.push(item);
+        report("queued", item, `Queued ${item.name}`);
+    };
+    const report = (phase, item, message, version) => {
+        options.onProgress?.({
+            phase,
+            packageName: item?.name,
+            version,
+            completed: done.size,
+            total: Math.max(queue.length, done.size + (item ? 1 : 0)),
+            message,
+        });
+    };
+    for (const name of packageNames) {
+        enqueue({ name, range: "latest", optional: false });
+    }
+    for (let index = 0; index < queue.length; index++) {
+        if (done.size >= maxPackages) {
+            throw new Error(`Dependency install stopped after ${maxPackages} packages. Narrow the imports or raise maxPackages.`);
+        }
+        const item = queue[index];
+        if (installed.has(item.name) || done.has(item.name))
+            continue;
+        (0, npmRegistry_1.throwIfAborted)(options.signal);
+        report("resolve", item, `Resolving ${item.name}`);
+        const metadata = await (0, npmRegistry_1.fetchNpmMetadata)(fetchImpl, item.name, item.optional, options.signal);
+        (0, npmRegistry_1.throwIfAborted)(options.signal);
+        if (!metadata) {
+            done.add(item.name);
+            report("skip", item, `Skipped optional ${item.name}`);
+            continue;
+        }
+        const version = (0, npmRegistry_1.selectVersion)(metadata, item.range);
+        const versionMetadata = metadata.versions[version];
+        const tarball = versionMetadata?.dist?.tarball;
+        if (!versionMetadata || !tarball) {
+            if (item.optional) {
+                done.add(item.name);
+                report("skip", item, `Skipped optional ${item.name}`);
+                continue;
+            }
+            throw new Error(`No tarball found for ${item.name}@${version}.`);
+        }
+        report("download", item, `Downloading ${item.name}@${version}`, version);
+        const tgz = await (0, npmRegistry_1.downloadTarball)(fetchImpl, tarball, options.signal);
+        (0, npmRegistry_1.throwIfAborted)(options.signal);
+        report("extract", item, `Extracting ${item.name}@${version}`, version);
+        const unpacked = await (0, npmRegistry_1.unpackNpmTarball)(tgz, options.signal);
+        (0, npmRegistry_1.throwIfAborted)(options.signal);
+        const packageJson = {
+            ...versionMetadata,
+            ...unpacked.packageJson,
+        };
+        const mounted = (0, npmRegistry_1.mountPackageFiles)(item.name, unpacked.files);
+        Object.assign(result.compilerFiles, mounted.compilerFiles);
+        Object.assign(result.editorLibs, mounted.editorLibs);
+        Object.assign(result.runtimeFiles, mounted.runtimeFiles);
+        const declarationCount = Object.keys(mounted.editorLibs).filter((key) => npmRegistry_1.DECLARATION_FILE_REGEXP.test(key)).length;
+        result.packages.push({
+            name: item.name,
+            version,
+            tarball,
+            fileCount: Object.keys(mounted.compilerFiles).length,
+            declarationCount,
+        });
+        done.add(item.name);
+        installed.add(item.name);
+        report("done", item, `Installed ${item.name}@${version}`, version);
+        (0, npmRegistry_1.enqueuePackageDependencies)(packageJson, enqueue);
+        if (declarationCount === 0 && !item.name.startsWith("@types/")) {
+            enqueue({
+                name: (0, npmRegistry_1.toTypesPackageName)(item.name),
+                range: "latest",
+                optional: true,
+            });
+        }
+    }
+    report("done", null, "Dependency install complete");
+    return result;
+}
+//# sourceMappingURL=installPlaygroundDependencies.js.map

package/lib/src/npm/installPlaygroundDependencies.js.map

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

package/lib/src/npm/internal/npmRegistry.d.ts

@@ -0,0 +1,57 @@
+interface IPackageJson {
+    name?: string;
+    version?: string;
+    dependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    peerDependenciesMeta?: Record<string, {
+        optional?: boolean;
+    }>;
+}
+export interface INpmVersionMetadata {
+    name: string;
+    version: string;
+    dependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    peerDependenciesMeta?: Record<string, {
+        optional?: boolean;
+    }>;
+    dist?: {
+        tarball?: string;
+    };
+}
+export interface INpmMetadata {
+    name: string;
+    "dist-tags"?: Record<string, string>;
+    versions: Record<string, INpmVersionMetadata | undefined>;
+}
+export interface IUnpackedPackage {
+    files: Record<string, string>;
+    packageJson: IPackageJson;
+}
+export interface IQueueItem {
+    name: string;
+    range: string;
+    optional: boolean;
+}
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export declare const DECLARATION_FILE_REGEXP: RegExp;
+export declare function throwIfAborted(signal: AbortSignal | undefined): void;
+export declare function fetchNpmMetadata(fetchImpl: FetchLike, packageName: string, optional: boolean, signal: AbortSignal | undefined): Promise<INpmMetadata | null>;
+export declare function selectVersion(metadata: INpmMetadata, range: string): string;
+export declare function downloadTarball(fetchImpl: FetchLike, tarball: string, signal: AbortSignal | undefined): Promise<ArrayBuffer>;
+export declare function unpackNpmTarball(tgz: ArrayBuffer, signal: AbortSignal | undefined): Promise<IUnpackedPackage>;
+export interface IMountedFiles {
+    compilerFiles: Record<string, string>;
+    editorLibs: Record<string, string>;
+    runtimeFiles: Record<string, string>;
+}
+export declare function mountPackageFiles(packageName: string, files: Record<string, string>): IMountedFiles;
+export declare function enqueuePackageDependencies(packageJson: {
+    dependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    peerDependenciesMeta?: Record<string, {
+        optional?: boolean;
+    }>;
+}, enqueue: (item: IQueueItem) => void): void;
+export declare function toTypesPackageName(packageName: string): string;
+export {};