@ttsc/playground 0.14.0-dev.20250530.1

package/lib/src/structures/ICompilerService.d.ts

@@ -0,0 +1,84 @@
+import type { ITransformOptions } from "./ITransformOptions";
+/**
+ * Worker ↔ UI RPC contract for the playground compiler service.
+ *
+ * `createWorkerCompiler` (worker side) implements this. `createCompilerClient`
+ * (UI side) returns a tgrid Driver bound to this shape. Sites that need an
+ * `extraTabs` lane should layer additional verbs over this base interface in
+ * their own ICompilerService subtype.
+ */
+export interface ICompilerService {
+    /**
+     * Mount external npm package files into the worker's MemFS under
+     * `node_modules/`. Driven by the dependency installer in
+     * `@ttsc/playground/npm`.
+     */
+    installDependencies(props: ICompilerService.IInstallDependenciesProps): Promise<ICompilerService.IInstallDependenciesResult>;
+    /**
+     * Compile the user's source into JavaScript with diagnostics. Plugin
+     * transforms (typia, when enabled in options) run first; the result is the
+     * post-transform emit.
+     */
+    compile(props: ICompilerService.IProps): Promise<ICompilerService.IResult>;
+    /**
+     * Same pipeline as `compile`, but using the bundle-flavored tsconfig
+     * (typically `module: "CommonJS"` for in-page `new Function` sandboxing).
+     * Sites that don't run user code may treat this identically to `compile`.
+     */
+    bundle(props: ICompilerService.IProps): Promise<ICompilerService.IResult>;
+    /**
+     * Run the lint plugin and parse its findings into the same diagnostic shape
+     * as `compile`. Returns an empty list when no lint plugin is wired into the
+     * worker.
+     */
+    lint(props: ICompilerService.IProps): Promise<ICompilerService.ILintResult>;
+}
+export declare namespace ICompilerService {
+    export interface IProps {
+        source: string;
+        options?: ITransformOptions;
+    }
+    export interface IInstallDependenciesProps {
+        /** Node_modules-relative paths to text content. */
+        files: Record<string, string>;
+        /** Metadata for the packages whose files are in `files`. */
+        packages: IInstalledPackage[];
+    }
+    export interface IInstalledPackage {
+        name: string;
+        version: string;
+    }
+    export interface IInstallDependenciesResult {
+        installed: IInstalledPackage[];
+        fileCount: number;
+    }
+    export type IResult = ISuccess | IFailure | IError;
+    export interface ISuccess extends IBase<"success", string> {
+    }
+    export interface IFailure extends IBase<"failure", string> {
+        diagnostics: IDiagnostic[];
+    }
+    export interface IError extends IBase<"error", unknown> {
+    }
+    interface IBase<Type extends string, Value> {
+        type: Type;
+        target: "javascript";
+        value: Value;
+    }
+    export interface IDiagnostic {
+        /** 1-based line number. */
+        line: number;
+        /** 1-based column number. */
+        column: number;
+        /** Length of the span in source characters; at least 1. */
+        length: number;
+        severity: "error" | "warning";
+        message: string;
+        /** Diagnostic code, e.g. `"TS2322"` or a lint rule id. */
+        code?: string;
+    }
+    export interface ILintResult {
+        diagnostics: IDiagnostic[];
+    }
+    export {};
+}

package/lib/src/structures/ICompilerService.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ICompilerService.js.map

package/lib/src/structures/ICompilerService.js.map

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

package/lib/src/structures/IConsoleMessage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * One captured `console.*` invocation. `value` is the argv (the spread of
+ * `console.log(...args)`), so `console.log("user:", user)` shows up as a single
+ * row with both pieces rendered inline, separated by a space — same as a real
+ * DevTools console.
+ */
+export interface IConsoleMessage {
+    type: "debug" | "dir" | "error" | "info" | "log" | "table" | "warn";
+    value: unknown[];
+}

package/lib/src/structures/IConsoleMessage.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IConsoleMessage.js.map

package/lib/src/structures/IConsoleMessage.js.map

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

package/lib/src/structures/ICreateCompilerClientOptions.d.ts

@@ -0,0 +1,13 @@
+/** Options for {@link createCompilerClient}. */
+export interface ICreateCompilerClientOptions {
+    /**
+     * URL of the bundled worker script (the site's rspack output of its
+     * `compiler/index.ts` worker entry, which calls `createWorkerCompiler`).
+     *
+     * The Worker is constructed by tgrid's `WorkerConnector` with classic- worker
+     * semantics. A custom Worker factory hook is intentionally not exposed — the
+     * upstream tgrid v1 API only accepts a URL. File an issue if you need module
+     * workers, named workers, or custom credentials.
+     */
+    workerUrl: string;
+}

package/lib/src/structures/ICreateCompilerClientOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ICreateCompilerClientOptions.js.map

package/lib/src/structures/ICreateCompilerClientOptions.js.map

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

package/lib/src/structures/ICreateWorkerCompilerOptions.d.ts

@@ -0,0 +1,35 @@
+import type { ILintPluginConfig } from "./ILintPluginConfig";
+import type { ITypiaPluginConfig } from "./ITypiaPluginConfig";
+/** Options for {@link createWorkerCompiler}. */
+export interface ICreateWorkerCompilerOptions {
+    /** URL of the site's pre-built playground.wasm. */
+    wasmUrl: string;
+    /** URL of the matching wasm_exec.js. Defaults to next to wasmUrl. */
+    wasmExecUrl?: string;
+    /**
+     * `globalThis[apiName]` the wasm binds. Must match the `apiName` passed to
+     * `host.Expose` when the site's wasm was built.
+     */
+    apiName: string;
+    /** In-MemFS project root. Defaults to `/work`. */
+    workDir?: string;
+    /** Tsconfig path relative to `workDir`. Defaults to `tsconfig.json`. */
+    tsconfigPath?: string;
+    /** Entry source path relative to `workDir`. Defaults to `src/playground.ts`. */
+    entryFile?: string;
+    /**
+     * Typia integration. Pass `false` to disable. When omitted, defaults to `{
+     * name: "typia", transformModule: "typia/lib/transform" }` — and only
+     * actually runs when the per-call `options.typia` is not `false`.
+     */
+    typiaPlugin?: ITypiaPluginConfig | false;
+    /** Lint integration. Pass `false` to disable. */
+    lintPlugin?: ILintPluginConfig | false;
+    /**
+     * Extra entries spliced into the tsconfig's `compilerOptions`. Use to wire
+     * site-specific plugins, paths, or lib overrides. The typia plugin entry is
+     * appended automatically when `typiaPlugin` is enabled — sites should NOT
+     * include it here.
+     */
+    extraCompilerOptions?: Record<string, unknown>;
+}

package/lib/src/structures/ICreateWorkerCompilerOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ICreateWorkerCompilerOptions.js.map

package/lib/src/structures/ICreateWorkerCompilerOptions.js.map

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

package/lib/src/structures/IInstallTypiaSourcePackOptions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Options for {@link installTypiaSourcePack} and
+ * {@link createTypiaSourcePackMount}.
+ */
+export interface IInstallTypiaSourcePackOptions {
+    /** URL the site serves the pre-built typia source pack from. */
+    url: string;
+    /**
+     * Where to mount the pack inside the MemFS. Defaults to `/work/node_modules`,
+     * matching `DEFAULT_WORK_DIR + "/node_modules"`.
+     */
+    mountRoot?: string;
+    /**
+     * Optional fetcher. Defaults to `globalThis.fetch`. Override for tests or for
+     * sites that want their own caching strategy.
+     */
+    fetch?: (input: string) => Promise<Response>;
+}

package/lib/src/structures/IInstallTypiaSourcePackOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IInstallTypiaSourcePackOptions.js.map

package/lib/src/structures/IInstallTypiaSourcePackOptions.js.map

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

package/lib/src/structures/ILintPluginConfig.d.ts

@@ -0,0 +1,5 @@
+/** Options for the `@ttsc/lint` integration of {@link createWorkerCompiler}. */
+export interface ILintPluginConfig {
+    /** Plugin id registered with `host.Expose` (default: `"@ttsc/lint"`). */
+    name?: string;
+}

package/lib/src/structures/ILintPluginConfig.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILintPluginConfig.js.map

package/lib/src/structures/ILintPluginConfig.js.map

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

package/lib/src/structures/IOptionToggle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Toggle metadata the OptionsPanel renders.
+ *
+ * Sites declare these for whatever transform plugins their wasm registered; the
+ * panel renders one row per entry and bubbles `onChange` with the merged
+ * options object.
+ */
+export interface IOptionToggle {
+    key: string;
+    label: string;
+    description: string;
+}

package/lib/src/structures/IOptionToggle.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IOptionToggle.js.map

package/lib/src/structures/IOptionToggle.js.map

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

package/lib/src/structures/IPlaygroundDependencyInstallOptions.d.ts

@@ -0,0 +1,16 @@
+import type { IPlaygroundDependencyProgress } from "./IPlaygroundDependencyProgress";
+/** Options for {@link installPlaygroundDependencies}. */
+export interface IPlaygroundDependencyInstallOptions {
+    /** Defaults to `globalThis.fetch`. Override for tests or for offline runs. */
+    fetch?: (input: string, init?: RequestInit) => Promise<Response>;
+    /** Package names the wasm already has — skip re-installing them. */
+    installedPackages?: Iterable<string>;
+    /** Package names to never install (preinstalled / built-in). */
+    ignoredPackages?: Iterable<string>;
+    /** Safety cap: error out after installing this many packages. */
+    maxPackages?: number;
+    /** Aborts the install when triggered. */
+    signal?: AbortSignal;
+    /** Fires for each phase transition during the install. */
+    onProgress?: (event: IPlaygroundDependencyProgress) => void;
+}

package/lib/src/structures/IPlaygroundDependencyInstallOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPlaygroundDependencyInstallOptions.js.map

package/lib/src/structures/IPlaygroundDependencyInstallOptions.js.map

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

package/lib/src/structures/IPlaygroundDependencyInstallResult.d.ts

@@ -0,0 +1,20 @@
+import type { IPlaygroundDependencyPackage } from "./IPlaygroundDependencyPackage";
+/** Aggregate result returned by {@link installPlaygroundDependencies}. */
+export interface IPlaygroundDependencyInstallResult {
+    packages: IPlaygroundDependencyPackage[];
+    /**
+     * `node_modules/...` keyed map of files to mount inside the wasm-side
+     * compiler MemFS.
+     */
+    compilerFiles: Record<string, string>;
+    /**
+     * `file:///node_modules/...` keyed map of `.d.ts` + `package.json` files to
+     * register with Monaco via `addExtraLib`.
+     */
+    editorLibs: Record<string, string>;
+    /**
+     * Package-rooted runtime files (e.g. `uuid/dist/index.js`) the in-page
+     * execute sandbox `require` can resolve.
+     */
+    runtimeFiles: Record<string, string>;
+}

package/lib/src/structures/IPlaygroundDependencyInstallResult.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPlaygroundDependencyInstallResult.js.map

package/lib/src/structures/IPlaygroundDependencyInstallResult.js.map

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

package/lib/src/structures/IPlaygroundDependencyPackage.d.ts

@@ -0,0 +1,8 @@
+/** Metadata for one successfully installed npm package. */
+export interface IPlaygroundDependencyPackage {
+    name: string;
+    version: string;
+    tarball: string;
+    fileCount: number;
+    declarationCount: number;
+}

package/lib/src/structures/IPlaygroundDependencyPackage.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPlaygroundDependencyPackage.js.map

package/lib/src/structures/IPlaygroundDependencyPackage.js.map

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

package/lib/src/structures/IPlaygroundDependencyProgress.d.ts

@@ -0,0 +1,10 @@
+import type { IPlaygroundDependencyProgressPhase } from "./IPlaygroundDependencyProgressPhase";
+/** A single progress event emitted while installing playground dependencies. */
+export interface IPlaygroundDependencyProgress {
+    phase: IPlaygroundDependencyProgressPhase;
+    packageName?: string;
+    version?: string;
+    completed: number;
+    total: number;
+    message: string;
+}

package/lib/src/structures/IPlaygroundDependencyProgress.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPlaygroundDependencyProgress.js.map

package/lib/src/structures/IPlaygroundDependencyProgress.js.map

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

package/lib/src/structures/IPlaygroundDependencyProgressPhase.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Lifecycle phase of a single dependency install reported via the progress
+ * callback.
+ */
+export type IPlaygroundDependencyProgressPhase = "queued" | "resolve" | "download" | "extract" | "skip" | "error" | "done";

package/lib/src/structures/IPlaygroundDependencyProgressPhase.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPlaygroundDependencyProgressPhase.js.map

package/lib/src/structures/IPlaygroundDependencyProgressPhase.js.map

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

package/lib/src/structures/IPlaygroundExample.d.ts

@@ -0,0 +1,16 @@
+/**
+ * One pre-canned source script the playground dropdown can load. Sites provide
+ * their own list — typia's site lists `random/is/json/protobuf`, the ttsc site
+ * lists `typia/lint/mixed`.
+ */
+export interface IPlaygroundExample {
+    id: string;
+    title: string;
+    description: string;
+    source: string;
+    /**
+     * Optional grouping bucket. Examples are rendered grouped by this label.
+     * Defaults to "Examples" when omitted.
+     */
+    group?: string;
+}

package/lib/src/structures/IPlaygroundExample.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPlaygroundExample.js.map

package/lib/src/structures/IPlaygroundExample.js.map

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

package/lib/src/structures/IPlaygroundShellProps.d.ts

@@ -0,0 +1,70 @@
+import type { ReactNode } from "react";
+import type { IOptionToggle } from "./IOptionToggle";
+import type { IPlaygroundExample } from "./IPlaygroundExample";
+import type { ITransformOptions } from "./ITransformOptions";
+/**
+ * Props for the full playground shell.
+ *
+ * The shell is intentionally configurable rather than configurable-by-context:
+ * every changing field is an explicit prop, so wrappers can spread their own
+ * defaults without a Provider in between.
+ */
+export interface IPlaygroundShellProps {
+    /**
+     * URL of the bundled worker script (rspack output of the site's worker
+     * entry).
+     */
+    workerUrl: string;
+    /** Source code shown on first mount (and on Reset). */
+    defaultScript: string;
+    /** Examples available in the dropdown. Empty array hides the dropdown. */
+    examples?: readonly IPlaygroundExample[];
+    /** Display labels for example groups. */
+    exampleGroupLabels?: Record<string, string>;
+    /** Toggles rendered in the Options modal. Defaults to typia + lint. */
+    optionToggles?: readonly IOptionToggle[];
+    /**
+     * Initial values for the transform options. Defaults to `{typia: true, lint:
+     * true}`.
+     */
+    defaultOptions?: ITransformOptions;
+    /**
+     * Static extra .d.ts entries to mount in Monaco (e.g. a pre-packed typia type
+     * pack). Merged with dependencies installed at runtime.
+     */
+    staticEditorLibs?: Record<string, string>;
+    /**
+     * Packages the site has already pre-mounted into the wasm. These are skipped
+     * by the runtime npm dependency installer.
+     */
+    preinstalledPackages?: readonly string[];
+    /**
+     * Optional execute hook. When provided, the shell renders an "Execute"
+     * button; on click it calls `service.bundle(...)` to get the JS and passes it
+     * here. The returned messages are appended to the Console pane.
+     *
+     * `sandbox.runtimeFiles` is the accumulated runtime-file map produced by
+     * every `installPlaygroundDependencies` call so far in this session
+     * (package-rooted keys like `uuid/dist/index.js`). The site's executeBundle
+     * typically merges these on top of its own typia-runtime pack and feeds the
+     * union to `createSandboxRequire` — without this channel the in-page Execute
+     * sandbox cannot resolve any npm dependency the user installed.
+     *
+     * When omitted, the Execute UI is hidden.
+     */
+    executeBundle?: (code: string, sandbox: {
+        console: Record<string, (...args: unknown[]) => void>;
+        runtimeFiles: Record<string, string>;
+    }) => Promise<void>;
+    /**
+     * Brand slot in the toolbar (left side). Renders before the Playground label.
+     * Sites typically pass `<a href="/">SiteName</a>`.
+     */
+    brand?: ReactNode;
+    /**
+     * Caption shown on the result pane when the active tab is "javascript".
+     * Defaults to `"dist/playground.js"`. Receives the current transform options
+     * so sites can append `· typia disabled` etc.
+     */
+    resultCaption?: (options: ITransformOptions) => string;
+}

package/lib/src/structures/IPlaygroundShellProps.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPlaygroundShellProps.js.map

package/lib/src/structures/IPlaygroundShellProps.js.map

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

package/lib/src/structures/ISourceEditorProps.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Props for the Monaco-based source editor. The site provides `extraLibs` —
+ * typically the typia `.d.ts` pack and any installed npm package `.d.ts` files
+ * — and the editor mounts them via
+ * `monaco.languages.typescript.typescriptDefaults.addExtraLib`.
+ */
+export interface ISourceEditorProps {
+    value: string;
+    onChange: (value: string) => void;
+    /**
+     * Map of file path → declaration text. Mounted into Monaco's TypeScript
+     * extra-libs registry. Hot-replaceable: the editor disposes the previous libs
+     * and re-mounts when the map identity changes.
+     */
+    extraLibs?: Record<string, string>;
+    /** Editor model URI. Defaults to `file:///src/playground.ts`. */
+    path?: string;
+}

package/lib/src/structures/ISourceEditorProps.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ISourceEditorProps.js.map

package/lib/src/structures/ISourceEditorProps.js.map

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

package/lib/src/structures/ITransformOptions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Toggle flags the UI surfaces in the Options panel and forwards to the worker
+ * on every compile. The built-in `typia` and `lint` keys mirror the two plugin
+ * verbs `createWorkerCompiler` calls by default; sites that wire additional
+ * plugins can extend this interface via TypeScript declaration merging or pass
+ * a richer shape through `[key: string]: boolean | undefined`.
+ */
+export interface ITransformOptions {
+    /** Enable the typia transform plugin. Defaults to true. */
+    typia?: boolean;
+    /** Enable the `@ttsc/lint` preview rule pass. Defaults to true. */
+    lint?: boolean;
+    /** Additional site-specific toggles. */
+    [key: string]: boolean | undefined;
+}

package/lib/src/structures/ITransformOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITransformOptions.js.map

package/lib/src/structures/ITransformOptions.js.map

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

package/lib/src/structures/ITypiaPluginConfig.d.ts

@@ -0,0 +1,19 @@
+import type { IMemFSHost } from "@ttsc/wasm";
+/** Options for the typia integration of {@link createWorkerCompiler}. */
+export interface ITypiaPluginConfig {
+    /** Plugin id registered with `host.Expose` (default: `"typia"`). */
+    name?: string;
+    /**
+     * Module specifier the typia transform receives via `compilerOptions.plugins`
+     * (default: `"typia/lib/transform"`).
+     */
+    transformModule?: string;
+    /**
+     * Optional hook to mount typia source files into the MemFS during boot. The
+     * site fetches its pre-built typia pack and writes it under
+     * `<workDir>/node_modules/`. `workDir` is forwarded from
+     * `createWorkerCompiler` so the mount can honor a non-default project root
+     * without the site rewiring the URL.
+     */
+    mount?: (host: IMemFSHost, workDir: string) => Promise<void>;
+}

package/lib/src/structures/ITypiaPluginConfig.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITypiaPluginConfig.js.map

package/lib/src/structures/ITypiaPluginConfig.js.map

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

package/lib/src/structures/index.d.ts

@@ -0,0 +1,18 @@
+export * from "./IBuildTsconfigOptions";
+export * from "./ICompilerService";
+export * from "./IConsoleMessage";
+export * from "./ICreateCompilerClientOptions";
+export * from "./ICreateWorkerCompilerOptions";
+export * from "./IInstallTypiaSourcePackOptions";
+export * from "./ILintPluginConfig";
+export * from "./IOptionToggle";
+export * from "./IPlaygroundDependencyInstallOptions";
+export * from "./IPlaygroundDependencyInstallResult";
+export * from "./IPlaygroundDependencyPackage";
+export * from "./IPlaygroundDependencyProgress";
+export * from "./IPlaygroundDependencyProgressPhase";
+export * from "./IPlaygroundExample";
+export * from "./IPlaygroundShellProps";
+export * from "./ISourceEditorProps";
+export * from "./ITransformOptions";
+export * from "./ITypiaPluginConfig";

package/lib/src/structures/index.js

@@ -0,0 +1,35 @@
+"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 __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 });
+__exportStar(require("./IBuildTsconfigOptions"), exports);
+__exportStar(require("./ICompilerService"), exports);
+__exportStar(require("./IConsoleMessage"), exports);
+__exportStar(require("./ICreateCompilerClientOptions"), exports);
+__exportStar(require("./ICreateWorkerCompilerOptions"), exports);
+__exportStar(require("./IInstallTypiaSourcePackOptions"), exports);
+__exportStar(require("./ILintPluginConfig"), exports);
+__exportStar(require("./IOptionToggle"), exports);
+__exportStar(require("./IPlaygroundDependencyInstallOptions"), exports);
+__exportStar(require("./IPlaygroundDependencyInstallResult"), exports);
+__exportStar(require("./IPlaygroundDependencyPackage"), exports);
+__exportStar(require("./IPlaygroundDependencyProgress"), exports);
+__exportStar(require("./IPlaygroundDependencyProgressPhase"), exports);
+__exportStar(require("./IPlaygroundExample"), exports);
+__exportStar(require("./IPlaygroundShellProps"), exports);
+__exportStar(require("./ISourceEditorProps"), exports);
+__exportStar(require("./ITransformOptions"), exports);
+__exportStar(require("./ITypiaPluginConfig"), exports);
+//# sourceMappingURL=index.js.map

package/lib/src/structures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,qDAAmC;AACnC,oDAAkC;AAClC,iEAA+C;AAC/C,iEAA+C;AAC/C,mEAAiD;AACjD,sDAAoC;AACpC,kDAAgC;AAChC,wEAAsD;AACtD,uEAAqD;AACrD,iEAA+C;AAC/C,kEAAgD;AAChD,uEAAqD;AACrD,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AACrC,sDAAoC;AACpC,uDAAqC"}