@danielsimonjr/mathts-workbook 0.3.24 → 0.4.0

package/dist/{chunk-RKUVI3F6.js → chunk-ZVCYWKM5.js}

@@ -321,7 +321,7 @@ var Session = class {
 
 // src/contract.ts
 var SCHEMA_VERSION = { major: 1, minor: 0 };
-var VERSION = "0.3.24";
+var VERSION = "0.4.0";
 var COMMAND_NAMES = [
   "run",
   "describe",

package/dist/cli.js

@@ -15,7 +15,7 @@ import {
   runWorkbookWithTimeout,
   setMetadata,
   writeFileAtomic
-} from "./chunk-RKUVI3F6.js";
+} from "./chunk-ZVCYWKM5.js";
 import {
   buildDependencyGraph,
   createExecutor,
@@ -31,6 +31,7 @@ import {
 } from "./chunk-M2K7SQG2.js";
 
 // src/cli.ts
+import { createHash } from "crypto";
 import { readFileSync, writeFileSync, lstatSync, realpathSync } from "fs";
 import { pathToFileURL } from "url";
 import { basename } from "path";
@@ -599,6 +600,7 @@ mtsw - MathTS Workbook CLI
 
 Usage:
   mtsw run <file> [-c <id>] [-v] [--json] [--write] [--timeout <ms>]
+                 [--expect-hash <sha256>]
                                             Execute a workbook (or one cell + its
                                             deps with -c/--cell). -v: events,
                                             --json: machine output, --write: persist
@@ -607,6 +609,8 @@ Usage:
                                             kills it (WorkbookTimeoutError) if it
                                             exceeds the budget \u2014 a runaway cell can't
                                             hang the process. Incompatible with -c/-v.
+                                            --expect-hash refuses to run unless the
+                                            file's SHA-256 matches (optimistic lock).
   mtsw describe <file> [--json]             Structured document model (cells, graph)
   mtsw validate <file> [--json]             Validate structure (ids, deps, cycles)
   mtsw graph <file> [-f mermaid|dot]        Print the dependency graph
@@ -790,6 +794,13 @@ async function runCommand(args) {
   }
   const read = readFile(file);
   if (read.error) return fail([read.error]);
+  const expectHash = flagValue(args, "--expect-hash");
+  if (expectHash !== void 0) {
+    const actual = createHash("sha256").update(read.content, "utf8").digest("hex");
+    if (actual.toLowerCase() !== expectHash.toLowerCase()) {
+      return fail([`--expect-hash mismatch: file SHA-256 is ${actual}, expected ${expectHash}`]);
+    }
+  }
   const parsed = parseWorkbook(read.content);
   if (!parsed.success) {
     const problems2 = parsed.errors ?? [];

package/dist/index.d.ts

@@ -431,6 +431,25 @@ interface HandleResult {
 }
 declare function handleRequest(session: Session, request: JsonRpcRequest): Promise<HandleResult>;
 
+/**
+ * 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.
+ */
+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.
+ */
+declare function mathMLToSVG(mathml: string, options?: MathSvgOptions): string;
+
 /**
  * Shared message/result shapes between `timeout-runner.ts` (the coordinator,
  * running on the caller's thread) and `run-worker.ts` (the `worker_threads`
@@ -480,4 +499,4 @@ declare class WorkbookTimeoutError extends Error {
  */
 declare function runWorkbookWithTimeout(source: string, options: RunWorkbookWithTimeoutOptions): Promise<SerializedRunResult>;
 
-export { type Cell, type CellPosition, type CellResult, type CellType, type ExecutionMode, type ParseResult, type RemoveResult, type RunResult, type RunWorkbookWithTimeoutOptions, type RuntimeConfig, SCHEMA_VERSION, type SerializedCellResult, type SerializedRunResult, Session, VERSION, type Workbook, type WorkbookEvent, WorkbookExecutor, type WorkbookMetadata, WorkbookTimeoutError, addCell, buildDependencyGraph, createExecutor, detectCellType, detectCycles, editCell, formatResult, getAncestors, getDependents, handleRequest, moveCell, parseWorkbook, removeCell, renameCell, runWorkbookWithTimeout, serializeWorkbook, setMetadata, stripOutputs, toMermaid, topologicalSort };
+export { type Cell, type CellPosition, type CellResult, type CellType, type ExecutionMode, type MathSvgOptions, type ParseResult, type RemoveResult, type RunResult, type RunWorkbookWithTimeoutOptions, type RuntimeConfig, SCHEMA_VERSION, type SerializedCellResult, type SerializedRunResult, Session, VERSION, type Workbook, type WorkbookEvent, WorkbookExecutor, type WorkbookMetadata, WorkbookTimeoutError, addCell, buildDependencyGraph, createExecutor, detectCellType, detectCycles, editCell, formatResult, getAncestors, getDependents, handleRequest, mathMLToSVG, moveCell, parseWorkbook, removeCell, renameCell, runWorkbookWithTimeout, serializeWorkbook, setMetadata, stripOutputs, toMermaid, topologicalSort };

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   renameCell,
   runWorkbookWithTimeout,
   setMetadata
-} from "./chunk-RKUVI3F6.js";
+} from "./chunk-ZVCYWKM5.js";
 import {
   WorkbookExecutor,
   buildDependencyGraph,
@@ -27,6 +27,23 @@ import {
   toMermaid,
   topologicalSort
 } from "./chunk-M2K7SQG2.js";
+
+// src/svg-math.ts
+function mathMLToSVG(mathml, options = {}) {
+  const display = options.display ?? "block";
+  const pad = options.padding ?? 4;
+  const inner = mathml.includes("<math") ? mathml : `<math xmlns="http://www.w3.org/1998/Math/MathML" display="${display}">${mathml}</math>`;
+  const text = inner.replace(/<[^>]+>/g, "");
+  const width = Math.max(24, text.length * 10 + pad * 2);
+  const height = display === "block" ? 36 + pad * 2 : 20 + pad * 2;
+  return [
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">`,
+    `<foreignObject x="${pad}" y="${pad}" width="${width - pad * 2}" height="${height - pad * 2}">`,
+    inner,
+    `</foreignObject>`,
+    `</svg>`
+  ].join("");
+}
 export {
   SCHEMA_VERSION,
   Session,
@@ -43,6 +60,7 @@ export {
   getAncestors,
   getDependents,
   handleRequest,
+  mathMLToSVG,
   moveCell,
   parseWorkbook,
   removeCell,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danielsimonjr/mathts-workbook",
-  "version": "0.3.24",
+  "version": "0.4.0",
   "description": "Scientific workbook runtime for MathTS (.mtsw format)",
   "author": "Daniel Simon Jr.",
   "license": "MIT",
@@ -36,12 +36,12 @@
   "dependencies": {
     "@danielsimonjr/mathts-core": "^0.14.1",
     "@danielsimonjr/mathts-expression": "^0.7.1",
-    "@danielsimonjr/mathts-functions": "^0.63.0",
-    "@danielsimonjr/mathts-plot": "^0.4.1",
+    "@danielsimonjr/mathts-functions": "^0.64.0",
+    "@danielsimonjr/mathts-plot": "^0.4.2",
     "yaml": "^2.3.0"
   },
   "devDependencies": {
-    "@types/node": "^25.5.2",
+    "@types/node": "^26.2.0",
     "tsup": "^8.0.0",
     "typescript": "^5.3.0",
     "vitest": "^4.1.10"