@danielsimonjr/mathts-workbook 0.4.0 → 0.4.1

package/dist/rpc.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Pure JSON-RPC 2.0 router for `mtsw serve`. `handleRequest(session, request)`
+ * maps a request to a Session call and returns the response plus any streamed
+ * `cell/event` notifications — no stdio, so the protocol logic is unit-testable.
+ */
+import type { Session } from './session';
+export interface JsonRpcRequest {
+    jsonrpc?: string;
+    id?: string | number | null;
+    method?: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+export interface JsonRpcEvent {
+    jsonrpc: '2.0';
+    method: 'cell/event';
+    params: {
+        type: string;
+        cellId?: string;
+        error?: string;
+    };
+}
+export interface HandleResult {
+    response: JsonRpcResponse;
+    events: JsonRpcEvent[];
+    shutdown: boolean;
+}
+declare const CODE: {
+    readonly PARSE: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL: -32603;
+};
+export declare function handleRequest(session: Session, request: JsonRpcRequest): Promise<HandleResult>;
+export { CODE as JSON_RPC_CODES };
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,QAAA,MAAM,IAAI;aACR,KAAK,EAAE,CAAC,KAAK;aACb,eAAe,EAAE,CAAC,KAAK;aACvB,gBAAgB,EAAE,CAAC,KAAK;aACxB,cAAc,EAAE,CAAC,KAAK;aACtB,QAAQ,EAAE,CAAC,KAAK;CACR,CAAC;AAMX,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAiGpG;AAED,OAAO,EAAE,IAAI,IAAI,cAAc,EAAE,CAAC"}

package/dist/run-worker.d.ts

@@ -1,2 +1,2 @@
-
-export {  }
+export {};
+//# sourceMappingURL=run-worker.d.ts.map

package/dist/run-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-worker.d.ts","sourceRoot":"","sources":["../src/run-worker.ts"],"names":[],"mappings":""}

package/dist/session.d.ts

@@ -0,0 +1,68 @@
+/**
+ * In-memory editing/execution session for a single workbook — the stateful
+ * core behind `mtsw serve`. Holds the workbook, a per-cell result cache, and a
+ * stale set so a `run` only re-executes what an edit invalidated.
+ *
+ * File I/O is limited to `open`/`save`; everything else is in-memory. Edits are
+ * not persisted until `save`.
+ */
+import type { Workbook, RunResult, CellType } from './types';
+import * as edit from './edit';
+export declare class Session {
+    workbook: Workbook | null;
+    path: string | null;
+    dirty: boolean;
+    private cache;
+    private stale;
+    private require;
+    /** A cell has a usable, up-to-date result (the basis for "not stale"). */
+    private hasValidResult;
+    /** Load a workbook file into the session. Refuses to discard unsaved edits. */
+    open(path: string, options?: {
+        force?: boolean;
+    }): void;
+    /** Replace the workbook and recompute the stale set by diffing old vs new. */
+    private commit;
+    addCell(spec: {
+        id: string;
+        type: CellType;
+        content?: string;
+        dependsOn?: string[];
+    }, position?: edit.CellPosition): void;
+    editCell(id: string, changes: {
+        content?: string;
+        type?: CellType;
+        dependsOn?: string[];
+    }): void;
+    removeCell(id: string, options?: {
+        force?: boolean;
+    }): string[];
+    moveCell(id: string, position: edit.CellPosition): void;
+    renameCell(oldId: string, newId: string): void;
+    setMetadata(changes: {
+        title?: string;
+        author?: string;
+        description?: string;
+        tags?: string[];
+    }): void;
+    /**
+     * Incremental run: execute only stale cells in the target set (`only` + its
+     * ancestors, or the whole workbook), reusing cached outputs for the rest.
+     * Returns the merged report over the target plus the streamed events.
+     */
+    run(only?: string): Promise<{
+        result: RunResult;
+        events: WorkbookEventLite[];
+    }>;
+    /** The set of cells awaiting (re-)execution. */
+    staleIds(): string[];
+    /** Serialize the current workbook and write it atomically. */
+    save(path?: string): string;
+}
+/** Slimmed event for streaming (avoids leaking timestamps / handler internals). */
+export interface WorkbookEventLite {
+    type: string;
+    cellId?: string;
+    error?: string;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAoB,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAK/E,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAW/B,qBAAa,OAAO;IAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACjC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC3B,KAAK,UAAS;IACd,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,KAAK,CAAqB;IAElC,OAAO,CAAC,OAAO;IAKf,0EAA0E;IAC1E,OAAO,CAAC,cAAc;IAKtB,+EAA+E;IAC/E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CActD;IAED,8EAA8E;IAC9E,OAAO,CAAC,MAAM;IAgCd,OAAO,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAExH;IACD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAE/F;IACD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,EAAE,CAI9D;IACD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAEtD;IACD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE7C;IACD,WAAW,CAAC,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAErG;IAED;;;;OAIG;IACG,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC,CAwCpF;IAED,gDAAgD;IAChD,QAAQ,IAAI,MAAM,EAAE,CAEnB;IAED,8DAA8D;IAC9D,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1B;CACF;AAED,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/svg-math.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MathML → SVG typesetting. Wraps a MathML fragment in an SVG document so
+ * rendered workbooks can emit SVG (browsers, rsvg, inkscape) instead of raw
+ * MathML. The glyph metrics are a conservative estimate — consumers that need
+ * pixel-perfect layout should typeset with a real engine; this is the
+ * no-dependency path the CLI/export uses.
+ */
+export interface MathSvgOptions {
+    /** Display (`block`) or inline. Default `block`. */
+    display?: 'block' | 'inline';
+    /** Extra padding in CSS pixels. Default 4. */
+    padding?: number;
+}
+/**
+ * Wrap a MathML fragment (or a full `<math>` document) in an SVG with a
+ * `foreignObject` so the math remains selectable and scalable.
+ */
+export declare function mathMLToSVG(mathml: string, options?: MathSvgOptions): string;
+//# sourceMappingURL=svg-math.d.ts.map

package/dist/svg-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-math.d.ts","sourceRoot":"","sources":["../src/svg-math.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAmBhF"}

package/dist/svg.d.ts

@@ -0,0 +1,9 @@
+export interface ChartSpec {
+    type?: 'line' | 'scatter' | 'bar';
+    title?: string;
+    xLabel?: string;
+    yLabel?: string;
+}
+/** Render an SVG (default) or embeddable TikZ chart from a spec plus raw x/y data. */
+export declare function renderChart(spec: ChartSpec, xRaw: unknown, yRaw: unknown, format?: 'svg' | 'tikz'): string;
+//# sourceMappingURL=svg.d.ts.map

package/dist/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../src/svg.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6BD,sFAAsF;AACtF,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,KAAK,GAAG,MAAc,GAC7B,MAAM,CAgBR"}

package/dist/tex.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Assemble a RenderDoc into one self-contained LaTeX document (or a fragment
+ * for \input) — the TeX analog of html.ts's toHTML. Markdown prose via
+ * markdownToTex, equations via the injected parser's .toTex(), code via
+ * listings, tests as colored status lines, charts as embedded TikZ. All plain
+ * text is LaTeX-escaped; never throws.
+ */
+import type { RenderDoc } from './html.js';
+export interface ToTexOptions {
+    /** Parser for equation expressions (e.g. the functions package `parse`). */
+    parse?: (expr: string) => unknown;
+    /** Emit only the cell bodies (for \input) instead of a standalone document. */
+    fragment?: boolean;
+}
+/** Render a document structure to a standalone (or fragment) LaTeX string. Never throws. */
+export declare function toTeX(doc: RenderDoc, options?: ToTexOptions): string;
+//# sourceMappingURL=tex.d.ts.map

package/dist/tex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tex.d.ts","sourceRoot":"","sources":["../src/tex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,WAAW,CAAC;AAGvD,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+DD,4FAA4F;AAC5F,wBAAgB,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAUxE"}

package/dist/timeout-runner.d.ts

@@ -0,0 +1,22 @@
+import type { SerializedRunResult } from './worker-protocol.js';
+export type { SerializedCellResult, SerializedRunResult, WorkerMessage, } from './worker-protocol.js';
+export interface RunWorkbookWithTimeoutOptions {
+    /** Wall-clock budget in milliseconds. Exceeding it terminates the worker. */
+    timeoutMs: number;
+}
+/** Thrown when a workbook run is terminated for exceeding its time budget. */
+export declare class WorkbookTimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/**
+ * Run a workbook's `.mtsw` source to completion (a continue-on-error report,
+ * like `runReport()`) inside a worker thread, killing that worker if it
+ * exceeds `timeoutMs`. The worker is ALWAYS terminated before this promise
+ * settles — on timeout, on success, and on error — so no handle is left open
+ * keeping the process alive.
+ *
+ * @throws {WorkbookTimeoutError} if the run is terminated for exceeding the budget.
+ */
+export declare function runWorkbookWithTimeout(source: string, options: RunWorkbookWithTimeoutOptions): Promise<SerializedRunResult>;
+//# sourceMappingURL=timeout-runner.d.ts.map

package/dist/timeout-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-runner.d.ts","sourceRoot":"","sources":["../src/timeout-runner.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,sBAAsB,CAAC;AAE/E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,6BAA6B;IAC5C,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8EAA8E;AAC9E,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,YAAY,SAAS,EAAE,MAAM,EAI5B;CACF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,mBAAmB,CAAC,CA2C9B"}

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Workbook type definitions
+ */
+/**
+ * Supported cell types
+ */
+export type CellType = 'markdown' | 'code' | 'tensor' | 'equation' | 'visualization' | 'data' | 'test' | 'export';
+/**
+ * Execution modes
+ */
+export type ExecutionMode = 'reactive' | 'sequential' | 'manual';
+/**
+ * Workbook metadata
+ */
+export interface WorkbookMetadata {
+    title?: string;
+    author?: string;
+    description?: string;
+    tags?: string[];
+    created?: string;
+    modified?: string;
+}
+/**
+ * Runtime configuration
+ */
+export interface RuntimeConfig {
+    engine: 'mathts' | 'custom';
+    execution: ExecutionMode;
+    timeout?: number;
+}
+/**
+ * Individual cell in a workbook
+ */
+export interface Cell {
+    id: string;
+    type: CellType;
+    content: string;
+    dependsOn?: string[];
+    output?: unknown;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Complete workbook structure
+ */
+export interface Workbook {
+    version: string;
+    metadata: WorkbookMetadata;
+    runtime: RuntimeConfig;
+    cells: Cell[];
+}
+/**
+ * Parse result with validation
+ */
+export interface ParseResult {
+    success: boolean;
+    workbook?: Workbook;
+    errors?: string[];
+    warnings?: string[];
+}
+/**
+ * Workbook execution events
+ */
+export interface WorkbookEvent {
+    type: 'cell:start' | 'cell:success' | 'cell:error' | 'cell:stale' | 'workbook:complete';
+    cellId?: string;
+    output?: unknown;
+    error?: string;
+    timestamp: number;
+}
+/**
+ * Result of executing a single cell in a run report.
+ */
+export interface CellResult {
+    id: string;
+    type: CellType;
+    status: 'success' | 'error' | 'pass' | 'fail';
+    output?: unknown;
+    error?: string;
+}
+/**
+ * Aggregated result of running an entire workbook (continue-on-error).
+ */
+export interface RunResult {
+    cells: CellResult[];
+    ok: boolean;
+}
+/**
+ * Dependency graph node
+ */
+export interface DependencyNode {
+    id: string;
+    dependencies: string[];
+    dependents: string[];
+}
+/**
+ * Dependency graph
+ */
+export interface DependencyGraph {
+    nodes: Map<string, DependencyNode>;
+    executionOrder: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,MAAM,GACN,QAAQ,GACR,UAAU,GACV,eAAe,GACf,MAAM,GACN,MAAM,GACN,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,mBAAmB,CAAC;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/worker-protocol.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared message/result shapes between `timeout-runner.ts` (the coordinator,
+ * running on the caller's thread) and `run-worker.ts` (the `worker_threads`
+ * entry point that actually executes the workbook). Kept in its own module so
+ * neither side needs to import the other's runtime code — the worker script
+ * stays a minimal, independently loadable entry point.
+ *
+ * Cell outputs are pre-formatted to strings (via `formatResult`) before they
+ * cross the worker boundary: `postMessage` uses the structured-clone
+ * algorithm, which cannot faithfully reproduce engine class instances
+ * (Complex, matrices, BigNumber, …) — it either drops their prototype or
+ * throws. Formatting to a string in the worker (the same rendering every
+ * other report consumer already uses) sidesteps that entirely.
+ */
+import type { CellResult } from './types.js';
+/** A `CellResult` with its output pre-formatted to a string (or absent). */
+export interface SerializedCellResult {
+    id: string;
+    type: CellResult['type'];
+    status: CellResult['status'];
+    output?: string;
+    error?: string;
+}
+/** A `RunResult` whose cells are `SerializedCellResult`s. */
+export interface SerializedRunResult {
+    cells: SerializedCellResult[];
+    ok: boolean;
+}
+export interface WorkerSuccessMessage {
+    ok: true;
+    report: SerializedRunResult;
+}
+export interface WorkerFailureMessage {
+    ok: false;
+    error: string;
+}
+/** The single message a worker posts back before exiting. */
+export type WorkerMessage = WorkerSuccessMessage | WorkerFailureMessage;
+/** `workerData` passed to `run-worker.ts` when it is spawned. */
+export interface RunWorkerData {
+    /** Raw `.mtsw` source (YAML) — the worker parses it itself. */
+    source: string;
+}
+//# sourceMappingURL=worker-protocol.d.ts.map

package/dist/worker-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-protocol.d.ts","sourceRoot":"","sources":["../src/worker-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAExE,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/yaml-safe.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Hardened YAML parsing shared by the workbook parser (document load) and the
+ * executor (data-cell payloads). Centralizing it keeps the two YAML entry
+ * points consistent: core schema only (no YAML 1.1 / custom-tag surprises),
+ * merge keys disabled, library warnings silenced, plus a prototype-pollution
+ * guard.
+ */
+/**
+ * Parse YAML with the hardened schema options (core schema, no merge keys).
+ * Does **not** walk the result for pollution keys — callers that want
+ * structured errors (the document parser) use {@link findPollutionKeys};
+ * callers that should fail closed use {@link parseYamlSafe}.
+ */
+export declare function parseYamlHardened(content: string): unknown;
+/**
+ * Parse YAML with hardened options and reject prototype-pollution keys.
+ * Use this at CLI / executor entry points that should throw rather than
+ * collect structured errors.
+ */
+export declare function parseYamlSafe(content: string): unknown;
+/**
+ * Collect every prototype-pollution key found anywhere in a parsed value.
+ * Only traverses plain objects and arrays (never class instances / built-in
+ * prototypes); a `seen` set guards against alias cycles.
+ *
+ * Also flags an object whose [[Prototype]] is neither `Object.prototype`
+ * nor `null` — that is the shape of `obj['__proto__'] = payload`, which
+ * does not create an own `__proto__` property for `getOwnPropertyNames`
+ * to find.
+ */
+export declare function findPollutionKeys(value: unknown, seen?: WeakSet<object>, found?: string[]): string[];
+/** Throw if a parsed value contains any prototype-pollution key. */
+export declare function assertNoPollution(value: unknown): void;
+//# sourceMappingURL=yaml-safe.d.ts.map

package/dist/yaml-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-safe.d.ts","sourceRoot":"","sources":["../src/yaml-safe.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAItD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,OAAO,CAAC,MAAM,CAAiB,EACrC,KAAK,GAAE,MAAM,EAAO,GACnB,MAAM,EAAE,CAuBV;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAKtD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danielsimonjr/mathts-workbook",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Scientific workbook runtime for MathTS (.mtsw format)",
   "author": "Daniel Simon Jr.",
   "license": "MIT",
@@ -22,29 +22,29 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc -p tsconfig.dts.json",
     "dev": "tsup --watch",
-    "test": "vitest run",
+    "test": "bun test --isolate --timeout 30000",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
+    "test:coverage": "bun test --isolate --timeout 30000 --coverage",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
+    "lint": "oxlint src",
+    "lint:fix": "oxlint src --fix",
     "clean": "rm -rf dist",
     "build:prod": "tsup --minify --treeshake"
   },
   "dependencies": {
-    "@danielsimonjr/mathts-core": "^0.14.1",
-    "@danielsimonjr/mathts-expression": "^0.7.1",
-    "@danielsimonjr/mathts-functions": "^0.64.0",
-    "@danielsimonjr/mathts-plot": "^0.4.2",
+    "@danielsimonjr/mathts-core": "^0.15.0",
+    "@danielsimonjr/mathts-expression": "^0.8.0",
+    "@danielsimonjr/mathts-functions": "^0.64.1",
+    "@danielsimonjr/mathts-plot": "^0.4.3",
     "yaml": "^2.3.0"
   },
   "devDependencies": {
-    "@types/node": "^26.2.0",
+    "@types/node": "^26.4.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.1.10"
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
   },
   "publishConfig": {
     "access": "public"