@ai-matrx/office 0.8.45 → 0.8.47

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.8.47
+
+- `EditorBridgeLike` / `FilterServiceLike` accept Univer's own `IEditorBridgeService` and `SheetsFilterService` types (their `Nullable<…>` returns, `IRange`): a host passing `injector.get(IEditorBridgeService)` to `editorBridgeCell`, or the filter service to `filterServiceRange`, type-checks. New `FilterRangeLike`. Consumer action: none.
+- Sheets co-editing, an open cell editor holds less: only a remote op that writes its cell (a value, style, merge, format, rule or sort whose ranges cover it) or moves or removes it (a row/column insert, remove or move before it, its sheet's removal, a shrink past it) waits until the editor closes. A later op passes the held ones when the two commute; everything else applies live, so the person sees the others work while typing. `SheetsOtPort.busy()` no longer includes the editor hold; `touchesEditedCell` is exported. Consumer action: none.
+- Sheets co-editing, the loser of a held cell hears of it: the commit rebased past a held op names what it overrode (`overrode`, data's `LocalEditOptions`), so the person whose value was overwritten gets the `overridden` notice ("Someone changed the same cells"). `SheetsOtAdapter.rebaseLocalOverHeld` returns `{ op, overrode }`. Consumer action: none.
+- Added `./pdf` and `./pdf-model`: the PDF workspace chrome (Acrobat layout, tools rail, page panel, properties forms, find, session undo/redo, shortcut map, reading mode, phone sheets) with host-injected ports. Unbuilt tools announce through the Coming-soon registry.
+
 ## 0.8.45
 
 - Sheets co-editing, typing into a cell a collaborator writes at the same moment (live attack F1, "$1,234.50" vs "$7" became 507): Univer rewrote an open cell editor's text whenever any write landed on its cell, caret back at 0, and Enter committed the splice. `univerSheetsOtPort` takes `cellEditor` (`editorBridgeCell(IEditorBridgeService)`); while it is open, a remote op touching its cell or sheet is held (`SheetsOtPort.defers`), with every op after it, and the person's commit is rebased over them when the editor closes. A held op never feeds a quiet hash. Consumer action: lend `cellEditor: editorBridgeCell(injector.get(IEditorBridgeService))`.

package/dist/pdf-model.cjs

@@ -0,0 +1,232 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/pdf/model.ts
+var model_exports = {};
+__export(model_exports, {
+  HISTORY_LIMIT: () => HISTORY_LIMIT,
+  PDF_COMING_SOON: () => PDF_COMING_SOON,
+  PDF_SHORTCUTS: () => PDF_SHORTCUTS,
+  PDF_TOOLS: () => PDF_TOOLS,
+  canRedo: () => canRedo,
+  canUndo: () => canUndo,
+  comingSoonIdOf: () => comingSoonIdOf,
+  compilePageOps: () => compilePageOps,
+  deletePages: () => deletePages,
+  formatKeys: () => formatKeys,
+  freshDecisions: () => freshDecisions,
+  isDirty: () => isDirty,
+  keptOrder: () => keptOrder,
+  matchShortcut: () => matchShortcut,
+  pdfTool: () => pdfTool,
+  pushStep: () => pushStep,
+  redo: () => redo,
+  redoLabel: () => redoLabel,
+  reorderPages: () => reorderPages,
+  restorePages: () => restorePages,
+  startHistory: () => startHistory,
+  turnPages: () => turnPages,
+  undo: () => undo,
+  undoLabel: () => undoLabel
+});
+module.exports = __toCommonJS(model_exports);
+
+// src/pdf/tools.ts
+var PDF_TOOLS = [
+  { id: "browse", label: "Browse", key: "v", status: "ready", opens: "none", group: 0 },
+  { id: "organize", label: "Organize pages", key: "o", status: "ready", capability: "rotate-pages,delete-pages,reorder-pages", opens: "panel", group: 0 },
+  { id: "extract-pages", label: "Extract pages", key: "e", status: "ready", capability: "extract-pages", opens: "panel", group: 0 },
+  { id: "split", label: "Split", key: "s", status: "ready", capability: "split", opens: "panel", group: 0 },
+  { id: "crop", label: "Crop pages", key: "c", status: "ready", capability: "crop-pages", opens: "panel", group: 0 },
+  { id: "redact", label: "Redact", key: "r", status: "ready", capability: "redact-pattern", opens: "panel", group: 1 },
+  { id: "compress", label: "Compress", key: "z", status: "ready", capability: "compress", opens: "panel", group: 1 },
+  { id: "extract-data", label: "Text and tables", key: "t", status: "ready", capability: "extract-text-remote,extract-tables", opens: "panel", group: 1 },
+  { id: "scan", label: "Scan", status: "ready", capability: "route:/tools/scanner", opens: "page", group: 1 },
+  { id: "sign", label: "Sign", status: "ready", capability: "route:/esign/new", opens: "page", group: 1 },
+  { id: "edit", label: "Edit text and images", status: "soon", opens: "none", group: 2 },
+  { id: "forms", label: "Fill forms", status: "soon", opens: "none", group: 2 },
+  { id: "protect", label: "Protect", status: "soon", opens: "none", group: 2 },
+  { id: "ocr", label: "Recognize text", status: "soon", opens: "none", group: 2 },
+  { id: "convert", label: "Convert", status: "soon", opens: "none", group: 2 },
+  { id: "compare", label: "Compare", status: "soon", opens: "none", group: 2 },
+  { id: "stamp", label: "Stamp and number", status: "soon", opens: "none", group: 2 }
+];
+var pdfTool = (id) => PDF_TOOLS.find((t) => t.id === id);
+var comingSoonIdOf = (id) => `pdf.${id}`;
+var PROMISES = {
+  edit: "Change text and swap images right on the page.",
+  forms: "Fill in a form and keep the values in the file.",
+  protect: "Lock a PDF with a password and limit what others can do.",
+  ocr: "Turn a scanned PDF into one you can search and copy from.",
+  convert: "Turn a PDF into Word, Excel or PowerPoint, and back.",
+  compare: "Put two versions side by side and see what changed.",
+  stamp: "Add watermarks, page numbers and Bates numbers."
+};
+var PANEL_PROMISES = {
+  "pdf.layers": {
+    id: "pdf.layers",
+    label: "Layers",
+    owner: "pdf",
+    promise: "Show or hide the layers inside a PDF.",
+    stage: "planned",
+    surfaces: ["PDF workspace page panel"]
+  }
+};
+var PDF_COMING_SOON = {
+  ...Object.fromEntries(
+    PDF_TOOLS.filter((t) => t.status === "soon").map((t) => {
+      const id = comingSoonIdOf(t.id);
+      return [id, { id, label: t.label, owner: "pdf", promise: PROMISES[t.id] ?? "", stage: "planned", surfaces: ["PDF workspace tool rail"] }];
+    })
+  ),
+  ...PANEL_PROMISES
+};
+
+// src/pdf/shortcuts.ts
+var PDF_SHORTCUTS = [
+  { action: "undo", label: "Undo", keys: "Mod+Z", section: "Edit" },
+  { action: "redo", label: "Redo", keys: "Mod+Shift+Z", section: "Edit" },
+  { action: "save", label: "Apply page changes", keys: "Mod+S", section: "Edit" },
+  { action: "find", label: "Find", keys: "Mod+F", section: "Edit" },
+  { action: "print", label: "Print", keys: "Mod+P", section: "Edit" },
+  { action: "zoom-in", label: "Zoom in", keys: "Mod+=", section: "View" },
+  { action: "zoom-out", label: "Zoom out", keys: "Mod+-", section: "View" },
+  { action: "zoom-fit-width", label: "Fit width", keys: "Mod+1", section: "View" },
+  { action: "zoom-fit-page", label: "Fit page", keys: "Mod+0", section: "View" },
+  { action: "two-up", label: "Two pages side by side", keys: "Mod+Shift+2", section: "View" },
+  { action: "read-mode", label: "Reading mode", keys: "Mod+Shift+H", section: "View" },
+  { action: "toggle-pages", label: "Page thumbnails", keys: "Mod+Shift+T", section: "View" },
+  { action: "toggle-properties", label: "Properties panel", keys: "Mod+Shift+P", section: "View" },
+  { action: "shortcuts", label: "Keyboard shortcuts", keys: "?", section: "View" },
+  { action: "page-next", label: "Next page", keys: "ArrowRight", section: "Pages" },
+  { action: "page-prev", label: "Previous page", keys: "ArrowLeft", section: "Pages" },
+  { action: "page-first", label: "First page", keys: "Home", section: "Pages" },
+  { action: "page-last", label: "Last page", keys: "End", section: "Pages" },
+  { action: "select-all-pages", label: "Select all pages", keys: "Mod+A", section: "Pages" },
+  { action: "rotate-right", label: "Rotate selected pages right", keys: "Mod+]", section: "Pages" },
+  { action: "rotate-left", label: "Rotate selected pages left", keys: "Mod+[", section: "Pages" },
+  { action: "delete-pages", label: "Delete selected pages", keys: "Delete", section: "Pages" },
+  ...PDF_TOOLS.filter((t) => t.key && t.status === "ready").map((t) => ({
+    action: `tool:${t.id}`,
+    label: t.label,
+    keys: t.key.toUpperCase(),
+    section: "Tools"
+  }))
+];
+function parse(keys) {
+  const parts = keys.split("+");
+  const key = parts[parts.length - 1] === "" ? "+" : parts[parts.length - 1];
+  return { mod: parts.includes("Mod"), shift: parts.includes("Shift"), key };
+}
+var TYPING_PASSES = /* @__PURE__ */ new Set(["find", "save", "print"]);
+function matchShortcut(e, typing) {
+  const mod = e.ctrlKey || e.metaKey;
+  const pressed = e.key.length === 1 ? e.key.toLowerCase() : e.key;
+  for (const s of PDF_SHORTCUTS) {
+    const want = parse(s.keys);
+    const wantKey = want.key.length === 1 ? want.key.toLowerCase() : want.key;
+    if (want.mod !== mod || e.altKey) continue;
+    const shiftOk = want.key === "?" ? true : want.shift === e.shiftKey || want.key === "=" && e.shiftKey && pressed === "+";
+    if (!shiftOk) continue;
+    if (pressed === wantKey || want.key === "=" && pressed === "+") {
+      if (typing && !TYPING_PASSES.has(s.action)) return null;
+      return s.action;
+    }
+  }
+  return null;
+}
+function formatKeys(keys, mac) {
+  return keys.split("+").map((k) => k === "Mod" ? mac ? "\u2318" : "Ctrl" : k === "Shift" ? mac ? "\u21E7" : "Shift" : k === "ArrowRight" ? "\u2192" : k === "ArrowLeft" ? "\u2190" : k).join(mac ? "" : "+");
+}
+
+// src/pdf/page-decisions.ts
+function freshDecisions(pageCount) {
+  return { order: Array.from({ length: Math.max(0, pageCount) }, (_, i) => i + 1), turns: {}, deleted: [] };
+}
+var norm = (t) => (t % 360 + 360) % 360;
+function turnPages(d, pages, by) {
+  const turns = { ...d.turns };
+  for (const p of pages) {
+    const next = norm((turns[p] ?? 0) + by);
+    if (next === 0) delete turns[p];
+    else turns[p] = next;
+  }
+  return { ...d, turns };
+}
+function deletePages(d, pages) {
+  const set = /* @__PURE__ */ new Set([...d.deleted, ...pages.filter((p) => d.order.includes(p))]);
+  if (set.size >= d.order.length) return d;
+  return { ...d, deleted: [...set].sort((a, b) => a - b) };
+}
+function restorePages(d, pages) {
+  const gone = new Set(pages);
+  return { ...d, deleted: d.deleted.filter((p) => !gone.has(p)) };
+}
+function reorderPages(d, order) {
+  if (order.length !== d.order.length || [...order].sort((a, b) => a - b).some((p, i) => p !== i + 1)) return d;
+  return { ...d, order: [...order] };
+}
+function isDirty(d) {
+  const moved = d.order.some((p, i) => p !== i + 1);
+  return moved || d.deleted.length > 0 || Object.keys(d.turns).length > 0;
+}
+function keptOrder(d) {
+  const gone = new Set(d.deleted);
+  return d.order.filter((p) => !gone.has(p));
+}
+function compilePageOps(d) {
+  const ops = [];
+  const gone = new Set(d.deleted);
+  for (const rotation of [90, 180, 270]) {
+    const pages = Object.entries(d.turns).filter(([p, t]) => t === rotation && !gone.has(Number(p))).map(([p]) => Number(p)).sort((a, b) => a - b);
+    if (pages.length) ops.push({ kind: "rotate", pages, rotation });
+  }
+  if (d.deleted.length) ops.push({ kind: "delete", pages: [...d.deleted] });
+  const kept = keptOrder(d);
+  const renumber = new Map([...kept].sort((a, b) => a - b).map((p, i) => [p, i + 1]));
+  const newOrder = kept.map((p) => renumber.get(p));
+  if (newOrder.some((p, i) => p !== i + 1)) ops.push({ kind: "reorder", newOrder });
+  return ops;
+}
+
+// src/pdf/session-history.ts
+var HISTORY_LIMIT = 100;
+function startHistory(value) {
+  return { past: [], present: { label: "", value }, future: [] };
+}
+function pushStep(h, label, value, limit = HISTORY_LIMIT) {
+  if (Object.is(h.present.value, value)) return h;
+  const past = [...h.past, h.present].slice(-limit);
+  return { past, present: { label, value }, future: [] };
+}
+function undo(h) {
+  const prev = h.past[h.past.length - 1];
+  if (!prev) return h;
+  return { past: h.past.slice(0, -1), present: prev, future: [h.present, ...h.future] };
+}
+function redo(h) {
+  const next = h.future[0];
+  if (!next) return h;
+  return { past: [...h.past, h.present], present: next, future: h.future.slice(1) };
+}
+var canUndo = (h) => h.past.length > 0;
+var canRedo = (h) => h.future.length > 0;
+var undoLabel = (h) => h.present.label;
+var redoLabel = (h) => h.future[0]?.label ?? "";
+//# sourceMappingURL=pdf-model.cjs.map

package/dist/pdf-model.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pdf/model.ts","../src/pdf/tools.ts","../src/pdf/shortcuts.ts","../src/pdf/page-decisions.ts","../src/pdf/session-history.ts"],"sourcesContent":["/** The workspace's pure model: tools, shortcuts, page decisions, the session stack and the host ports. No React. */\nexport * from \"./tools\";\nexport * from \"./shortcuts\";\nexport * from \"./page-decisions\";\nexport * from \"./session-history\";\nexport type * from \"./ports\";\n","/**\n * The PDF workspace's tool rail, as data. Pure (no React, no icons): the host registers the\n * Coming-soon rows from here (`PDF_COMING_SOON`), the shell draws the rail from it, and the tests\n * check that the two agree.\n *\n * A tool is `ready` only where a real capability stands behind it today (`capability` names the\n * server operation or app route). Anything else is `soon`: the rail shows it plainly marked, and\n * choosing it announces its registered promise through `@ai-matrx/kit/coming-soon`. There is no\n * third state, so no dead button.\n */\nimport type { ComingSoonEntry } from \"@ai-matrx/kit/coming-soon\";\n\nexport type PdfToolId =\n  | \"browse\"\n  | \"organize\"\n  | \"extract-pages\"\n  | \"split\"\n  | \"crop\"\n  | \"redact\"\n  | \"compress\"\n  | \"scan\"\n  | \"sign\"\n  | \"extract-data\"\n  | \"edit\"\n  | \"forms\"\n  | \"protect\"\n  | \"ocr\"\n  | \"convert\"\n  | \"compare\"\n  | \"stamp\";\n\nexport interface PdfToolDef {\n  id: PdfToolId;\n  label: string;\n  /** Single-key shortcut that picks the tool (shown in the tooltip and the shortcut map). */\n  key?: string;\n  status: \"ready\" | \"soon\";\n  /** The server operation or route behind a ready tool; the wiring test reads it. */\n  capability?: string;\n  /** What choosing a ready tool does: show its panel, or leave for another page. */\n  opens: \"panel\" | \"page\" | \"none\";\n  group: 0 | 1 | 2;\n  /** One short line under the panel title. */\n  hint?: string;\n}\n\nexport const PDF_TOOLS: readonly PdfToolDef[] = [\n  { id: \"browse\", label: \"Browse\", key: \"v\", status: \"ready\", opens: \"none\", group: 0 },\n  { id: \"organize\", label: \"Organize pages\", key: \"o\", status: \"ready\", capability: \"rotate-pages,delete-pages,reorder-pages\", opens: \"panel\", group: 0 },\n  { id: \"extract-pages\", label: \"Extract pages\", key: \"e\", status: \"ready\", capability: \"extract-pages\", opens: \"panel\", group: 0 },\n  { id: \"split\", label: \"Split\", key: \"s\", status: \"ready\", capability: \"split\", opens: \"panel\", group: 0 },\n  { id: \"crop\", label: \"Crop pages\", key: \"c\", status: \"ready\", capability: \"crop-pages\", opens: \"panel\", group: 0 },\n  { id: \"redact\", label: \"Redact\", key: \"r\", status: \"ready\", capability: \"redact-pattern\", opens: \"panel\", group: 1 },\n  { id: \"compress\", label: \"Compress\", key: \"z\", status: \"ready\", capability: \"compress\", opens: \"panel\", group: 1 },\n  { id: \"extract-data\", label: \"Text and tables\", key: \"t\", status: \"ready\", capability: \"extract-text-remote,extract-tables\", opens: \"panel\", group: 1 },\n  { id: \"scan\", label: \"Scan\", status: \"ready\", capability: \"route:/tools/scanner\", opens: \"page\", group: 1 },\n  { id: \"sign\", label: \"Sign\", status: \"ready\", capability: \"route:/esign/new\", opens: \"page\", group: 1 },\n  { id: \"edit\", label: \"Edit text and images\", status: \"soon\", opens: \"none\", group: 2 },\n  { id: \"forms\", label: \"Fill forms\", status: \"soon\", opens: \"none\", group: 2 },\n  { id: \"protect\", label: \"Protect\", status: \"soon\", opens: \"none\", group: 2 },\n  { id: \"ocr\", label: \"Recognize text\", status: \"soon\", opens: \"none\", group: 2 },\n  { id: \"convert\", label: \"Convert\", status: \"soon\", opens: \"none\", group: 2 },\n  { id: \"compare\", label: \"Compare\", status: \"soon\", opens: \"none\", group: 2 },\n  { id: \"stamp\", label: \"Stamp and number\", status: \"soon\", opens: \"none\", group: 2 },\n];\n\nexport const pdfTool = (id: string): PdfToolDef | undefined => PDF_TOOLS.find((t) => t.id === id);\n\n/** The Coming-soon id of an unbuilt tool. */\nexport const comingSoonIdOf = (id: PdfToolId): string => `pdf.${id}`;\n\nconst PROMISES: Record<string, string> = {\n  edit: \"Change text and swap images right on the page.\",\n  forms: \"Fill in a form and keep the values in the file.\",\n  protect: \"Lock a PDF with a password and limit what others can do.\",\n  ocr: \"Turn a scanned PDF into one you can search and copy from.\",\n  convert: \"Turn a PDF into Word, Excel or PowerPoint, and back.\",\n  compare: \"Put two versions side by side and see what changed.\",\n  stamp: \"Add watermarks, page numbers and Bates numbers.\",\n};\n\nconst PANEL_PROMISES: Record<string, ComingSoonEntry> = {\n  \"pdf.layers\": {\n    id: \"pdf.layers\",\n    label: \"Layers\",\n    owner: \"pdf\",\n    promise: \"Show or hide the layers inside a PDF.\",\n    stage: \"planned\",\n    surfaces: [\"PDF workspace page panel\"],\n  },\n};\n\n/** One row per unbuilt tool, ready for `registerComingSoon` or the host's registry table. */\nexport const PDF_COMING_SOON: Record<string, ComingSoonEntry> = {\n  ...Object.fromEntries(\n    PDF_TOOLS.filter((t) => t.status === \"soon\").map((t): [string, ComingSoonEntry] => {\n      const id = comingSoonIdOf(t.id);\n      return [id, { id, label: t.label, owner: \"pdf\", promise: PROMISES[t.id] ?? \"\", stage: \"planned\", surfaces: [\"PDF workspace tool rail\"] }];\n    }),\n  ),\n  ...PANEL_PROMISES,\n};\n","/**\n * The PDF workspace's one keyboard map. A shortcut is data: the shell mounts ONE key handler that\n * asks `matchShortcut` for the action, and the shortcuts popover lists the same rows, so the map\n * on screen and the keys that work cannot drift (the test fires every documented key).\n */\nimport { PDF_TOOLS } from \"./tools\";\n\nexport type PdfActionId =\n  | \"undo\" | \"redo\" | \"find\" | \"print\" | \"save\"\n  | \"zoom-in\" | \"zoom-out\" | \"zoom-fit-width\" | \"zoom-fit-page\"\n  | \"page-next\" | \"page-prev\" | \"page-first\" | \"page-last\"\n  | \"rotate-right\" | \"rotate-left\" | \"delete-pages\" | \"select-all-pages\"\n  | \"toggle-pages\" | \"toggle-properties\" | \"read-mode\" | \"two-up\" | \"shortcuts\"\n  | `tool:${string}`;\n\nexport interface PdfShortcut {\n  action: PdfActionId;\n  label: string;\n  /** Display keys: \"Mod+Z\" shows as Cmd+Z on a Mac and Ctrl+Z elsewhere. */\n  keys: string;\n  section: \"Edit\" | \"View\" | \"Pages\" | \"Tools\";\n}\n\nexport const PDF_SHORTCUTS: readonly PdfShortcut[] = [\n  { action: \"undo\", label: \"Undo\", keys: \"Mod+Z\", section: \"Edit\" },\n  { action: \"redo\", label: \"Redo\", keys: \"Mod+Shift+Z\", section: \"Edit\" },\n  { action: \"save\", label: \"Apply page changes\", keys: \"Mod+S\", section: \"Edit\" },\n  { action: \"find\", label: \"Find\", keys: \"Mod+F\", section: \"Edit\" },\n  { action: \"print\", label: \"Print\", keys: \"Mod+P\", section: \"Edit\" },\n  { action: \"zoom-in\", label: \"Zoom in\", keys: \"Mod+=\", section: \"View\" },\n  { action: \"zoom-out\", label: \"Zoom out\", keys: \"Mod+-\", section: \"View\" },\n  { action: \"zoom-fit-width\", label: \"Fit width\", keys: \"Mod+1\", section: \"View\" },\n  { action: \"zoom-fit-page\", label: \"Fit page\", keys: \"Mod+0\", section: \"View\" },\n  { action: \"two-up\", label: \"Two pages side by side\", keys: \"Mod+Shift+2\", section: \"View\" },\n  { action: \"read-mode\", label: \"Reading mode\", keys: \"Mod+Shift+H\", section: \"View\" },\n  { action: \"toggle-pages\", label: \"Page thumbnails\", keys: \"Mod+Shift+T\", section: \"View\" },\n  { action: \"toggle-properties\", label: \"Properties panel\", keys: \"Mod+Shift+P\", section: \"View\" },\n  { action: \"shortcuts\", label: \"Keyboard shortcuts\", keys: \"?\", section: \"View\" },\n  { action: \"page-next\", label: \"Next page\", keys: \"ArrowRight\", section: \"Pages\" },\n  { action: \"page-prev\", label: \"Previous page\", keys: \"ArrowLeft\", section: \"Pages\" },\n  { action: \"page-first\", label: \"First page\", keys: \"Home\", section: \"Pages\" },\n  { action: \"page-last\", label: \"Last page\", keys: \"End\", section: \"Pages\" },\n  { action: \"select-all-pages\", label: \"Select all pages\", keys: \"Mod+A\", section: \"Pages\" },\n  { action: \"rotate-right\", label: \"Rotate selected pages right\", keys: \"Mod+]\", section: \"Pages\" },\n  { action: \"rotate-left\", label: \"Rotate selected pages left\", keys: \"Mod+[\", section: \"Pages\" },\n  { action: \"delete-pages\", label: \"Delete selected pages\", keys: \"Delete\", section: \"Pages\" },\n  ...PDF_TOOLS.filter((t) => t.key && t.status === \"ready\").map((t): PdfShortcut => ({\n    action: `tool:${t.id}`,\n    label: t.label,\n    keys: t.key!.toUpperCase(),\n    section: \"Tools\",\n  })),\n];\n\nexport interface KeyLike {\n  key: string;\n  ctrlKey: boolean;\n  metaKey: boolean;\n  shiftKey: boolean;\n  altKey: boolean;\n}\n\nfunction parse(keys: string) {\n  const parts = keys.split(\"+\");\n  const key = parts[parts.length - 1] === \"\" ? \"+\" : parts[parts.length - 1]!;\n  return { mod: parts.includes(\"Mod\"), shift: parts.includes(\"Shift\"), key };\n}\n\nconst TYPING_PASSES = new Set<PdfActionId>([\"find\", \"save\", \"print\"]);\n\n/** The action a key press means, or null. Never matches while `typing` (a text field has the key). */\nexport function matchShortcut(e: KeyLike, typing: boolean): PdfActionId | null {\n  const mod = e.ctrlKey || e.metaKey;\n  const pressed = e.key.length === 1 ? e.key.toLowerCase() : e.key;\n  for (const s of PDF_SHORTCUTS) {\n    const want = parse(s.keys);\n    const wantKey = want.key.length === 1 ? want.key.toLowerCase() : want.key;\n    if (want.mod !== mod || e.altKey) continue;\n    // \"?\" is typed with Shift; every other plain key must have no Shift unless the map says so.\n    const shiftOk = want.key === \"?\" ? true : want.shift === e.shiftKey || (want.key === \"=\" && e.shiftKey && pressed === \"+\");\n    if (!shiftOk) continue;\n    if (pressed === wantKey || (want.key === \"=\" && pressed === \"+\")) {\n      // A text field keeps its own keys (typing, its own undo, select all); only these still reach the shell.\n      if (typing && !TYPING_PASSES.has(s.action)) return null;\n      return s.action;\n    }\n  }\n  return null;\n}\n\n/** \"Mod+Shift+Z\" → \"⌘⇧Z\" on a Mac, \"Ctrl+Shift+Z\" elsewhere. */\nexport function formatKeys(keys: string, mac: boolean): string {\n  return keys\n    .split(\"+\")\n    .map((k) => (k === \"Mod\" ? (mac ? \"⌘\" : \"Ctrl\") : k === \"Shift\" ? (mac ? \"⇧\" : \"Shift\") : k === \"ArrowRight\" ? \"→\" : k === \"ArrowLeft\" ? \"←\" : k))\n    .join(mac ? \"\" : \"+\");\n}\n","/**\n * The page decisions of one workspace session: which pages are turned, left out, or moved. Pure.\n *\n * Decisions are PENDING: the viewer and the page grid show them at once, and \"Apply\" sends them\n * to the server as the smallest list of page operations (`compilePageOps`). Pages are named by\n * their ORIGINAL 1-based number everywhere, so a decision survives any later move.\n */\n\nexport type Turn = 0 | 90 | 180 | 270;\n\nexport interface PageDecisions {\n  /** Original page numbers in the order the person wants them (deleted pages stay in the list). */\n  order: number[];\n  /** Extra clockwise turn per original page; absent = 0. */\n  turns: Record<number, Turn>;\n  /** Original page numbers left out. */\n  deleted: number[];\n}\n\nexport function freshDecisions(pageCount: number): PageDecisions {\n  return { order: Array.from({ length: Math.max(0, pageCount) }, (_, i) => i + 1), turns: {}, deleted: [] };\n}\n\nconst norm = (t: number): Turn => ((((t % 360) + 360) % 360) as Turn);\n\nexport function turnPages(d: PageDecisions, pages: readonly number[], by: 90 | -90 | 180): PageDecisions {\n  const turns = { ...d.turns };\n  for (const p of pages) {\n    const next = norm((turns[p] ?? 0) + by);\n    if (next === 0) delete turns[p];\n    else turns[p] = next;\n  }\n  return { ...d, turns };\n}\n\nexport function deletePages(d: PageDecisions, pages: readonly number[]): PageDecisions {\n  const set = new Set([...d.deleted, ...pages.filter((p) => d.order.includes(p))]);\n  // A document with no page left is not a document: the last page cannot be deleted.\n  if (set.size >= d.order.length) return d;\n  return { ...d, deleted: [...set].sort((a, b) => a - b) };\n}\n\nexport function restorePages(d: PageDecisions, pages: readonly number[]): PageDecisions {\n  const gone = new Set(pages);\n  return { ...d, deleted: d.deleted.filter((p) => !gone.has(p)) };\n}\n\n/** The new order, as the grid reports it (a list of original page numbers). */\nexport function reorderPages(d: PageDecisions, order: readonly number[]): PageDecisions {\n  if (order.length !== d.order.length || [...order].sort((a, b) => a - b).some((p, i) => p !== i + 1)) return d;\n  return { ...d, order: [...order] };\n}\n\nexport function isDirty(d: PageDecisions): boolean {\n  const moved = d.order.some((p, i) => p !== i + 1);\n  return moved || d.deleted.length > 0 || Object.keys(d.turns).length > 0;\n}\n\n/** The pages that will remain, in their new order. */\nexport function keptOrder(d: PageDecisions): number[] {\n  const gone = new Set(d.deleted);\n  return d.order.filter((p) => !gone.has(p));\n}\n\nexport type PageOp =\n  | { kind: \"rotate\"; pages: number[]; rotation: 90 | 180 | 270 }\n  | { kind: \"delete\"; pages: number[] }\n  | { kind: \"reorder\"; newOrder: number[] };\n\n/**\n * The server operations that make the document match the decisions, in the order they must run:\n * turns (original numbering), deletions (original numbering), then one reorder over what remains\n * (renumbered 1..n). Nothing is emitted for a decision that changes nothing.\n */\nexport function compilePageOps(d: PageDecisions): PageOp[] {\n  const ops: PageOp[] = [];\n  const gone = new Set(d.deleted);\n  for (const rotation of [90, 180, 270] as const) {\n    const pages = Object.entries(d.turns)\n      .filter(([p, t]) => t === rotation && !gone.has(Number(p)))\n      .map(([p]) => Number(p))\n      .sort((a, b) => a - b);\n    if (pages.length) ops.push({ kind: \"rotate\", pages, rotation });\n  }\n  if (d.deleted.length) ops.push({ kind: \"delete\", pages: [...d.deleted] });\n  const kept = keptOrder(d);\n  const renumber = new Map([...kept].sort((a, b) => a - b).map((p, i) => [p, i + 1] as const));\n  const newOrder = kept.map((p) => renumber.get(p)!);\n  if (newOrder.some((p, i) => p !== i + 1)) ops.push({ kind: \"reorder\", newOrder });\n  return ops;\n}\n","/**\n * The session's one undo/redo stack. Pure and generic: the workspace keeps page decisions and tool\n * form values in it, each step with the label the menu shows (\"Undo Rotate 3 pages\"). A new step\n * clears what was undone; the stack holds at most `limit` steps. Saved versions of the file are the\n * durable undo: applying changes empties this stack.\n */\nexport interface History<T> {\n  past: Array<{ label: string; value: T }>;\n  present: { label: string; value: T };\n  future: Array<{ label: string; value: T }>;\n}\n\nexport const HISTORY_LIMIT = 100;\n\nexport function startHistory<T>(value: T): History<T> {\n  return { past: [], present: { label: \"\", value }, future: [] };\n}\n\nexport function pushStep<T>(h: History<T>, label: string, value: T, limit = HISTORY_LIMIT): History<T> {\n  if (Object.is(h.present.value, value)) return h;\n  const past = [...h.past, h.present].slice(-limit);\n  return { past, present: { label, value }, future: [] };\n}\n\nexport function undo<T>(h: History<T>): History<T> {\n  const prev = h.past[h.past.length - 1];\n  if (!prev) return h;\n  return { past: h.past.slice(0, -1), present: prev, future: [h.present, ...h.future] };\n}\n\nexport function redo<T>(h: History<T>): History<T> {\n  const next = h.future[0];\n  if (!next) return h;\n  return { past: [...h.past, h.present], present: next, future: h.future.slice(1) };\n}\n\nexport const canUndo = (h: History<unknown>) => h.past.length > 0;\nexport const canRedo = (h: History<unknown>) => h.future.length > 0;\n/** The label of the step Undo would take back. */\nexport const undoLabel = (h: History<unknown>) => h.present.label;\nexport const redoLabel = (h: History<unknown>) => h.future[0]?.label ?? \"\";\n"],"mappings":"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","names":[]}

package/dist/pdf-model.d.cts

@@ -0,0 +1,248 @@
+import { ComingSoonEntry } from '@ai-matrx/kit/coming-soon';
+import { ReactNode } from 'react';
+
+/**
+ * The PDF workspace's tool rail, as data. Pure (no React, no icons): the host registers the
+ * Coming-soon rows from here (`PDF_COMING_SOON`), the shell draws the rail from it, and the tests
+ * check that the two agree.
+ *
+ * A tool is `ready` only where a real capability stands behind it today (`capability` names the
+ * server operation or app route). Anything else is `soon`: the rail shows it plainly marked, and
+ * choosing it announces its registered promise through `@ai-matrx/kit/coming-soon`. There is no
+ * third state, so no dead button.
+ */
+
+type PdfToolId = "browse" | "organize" | "extract-pages" | "split" | "crop" | "redact" | "compress" | "scan" | "sign" | "extract-data" | "edit" | "forms" | "protect" | "ocr" | "convert" | "compare" | "stamp";
+interface PdfToolDef {
+    id: PdfToolId;
+    label: string;
+    /** Single-key shortcut that picks the tool (shown in the tooltip and the shortcut map). */
+    key?: string;
+    status: "ready" | "soon";
+    /** The server operation or route behind a ready tool; the wiring test reads it. */
+    capability?: string;
+    /** What choosing a ready tool does: show its panel, or leave for another page. */
+    opens: "panel" | "page" | "none";
+    group: 0 | 1 | 2;
+    /** One short line under the panel title. */
+    hint?: string;
+}
+declare const PDF_TOOLS: readonly PdfToolDef[];
+declare const pdfTool: (id: string) => PdfToolDef | undefined;
+/** The Coming-soon id of an unbuilt tool. */
+declare const comingSoonIdOf: (id: PdfToolId) => string;
+/** One row per unbuilt tool, ready for `registerComingSoon` or the host's registry table. */
+declare const PDF_COMING_SOON: Record<string, ComingSoonEntry>;
+
+type PdfActionId = "undo" | "redo" | "find" | "print" | "save" | "zoom-in" | "zoom-out" | "zoom-fit-width" | "zoom-fit-page" | "page-next" | "page-prev" | "page-first" | "page-last" | "rotate-right" | "rotate-left" | "delete-pages" | "select-all-pages" | "toggle-pages" | "toggle-properties" | "read-mode" | "two-up" | "shortcuts" | `tool:${string}`;
+interface PdfShortcut {
+    action: PdfActionId;
+    label: string;
+    /** Display keys: "Mod+Z" shows as Cmd+Z on a Mac and Ctrl+Z elsewhere. */
+    keys: string;
+    section: "Edit" | "View" | "Pages" | "Tools";
+}
+declare const PDF_SHORTCUTS: readonly PdfShortcut[];
+interface KeyLike {
+    key: string;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+}
+/** The action a key press means, or null. Never matches while `typing` (a text field has the key). */
+declare function matchShortcut(e: KeyLike, typing: boolean): PdfActionId | null;
+/** "Mod+Shift+Z" → "⌘⇧Z" on a Mac, "Ctrl+Shift+Z" elsewhere. */
+declare function formatKeys(keys: string, mac: boolean): string;
+
+/**
+ * The page decisions of one workspace session: which pages are turned, left out, or moved. Pure.
+ *
+ * Decisions are PENDING: the viewer and the page grid show them at once, and "Apply" sends them
+ * to the server as the smallest list of page operations (`compilePageOps`). Pages are named by
+ * their ORIGINAL 1-based number everywhere, so a decision survives any later move.
+ */
+type Turn = 0 | 90 | 180 | 270;
+interface PageDecisions {
+    /** Original page numbers in the order the person wants them (deleted pages stay in the list). */
+    order: number[];
+    /** Extra clockwise turn per original page; absent = 0. */
+    turns: Record<number, Turn>;
+    /** Original page numbers left out. */
+    deleted: number[];
+}
+declare function freshDecisions(pageCount: number): PageDecisions;
+declare function turnPages(d: PageDecisions, pages: readonly number[], by: 90 | -90 | 180): PageDecisions;
+declare function deletePages(d: PageDecisions, pages: readonly number[]): PageDecisions;
+declare function restorePages(d: PageDecisions, pages: readonly number[]): PageDecisions;
+/** The new order, as the grid reports it (a list of original page numbers). */
+declare function reorderPages(d: PageDecisions, order: readonly number[]): PageDecisions;
+declare function isDirty(d: PageDecisions): boolean;
+/** The pages that will remain, in their new order. */
+declare function keptOrder(d: PageDecisions): number[];
+type PageOp = {
+    kind: "rotate";
+    pages: number[];
+    rotation: 90 | 180 | 270;
+} | {
+    kind: "delete";
+    pages: number[];
+} | {
+    kind: "reorder";
+    newOrder: number[];
+};
+/**
+ * The server operations that make the document match the decisions, in the order they must run:
+ * turns (original numbering), deletions (original numbering), then one reorder over what remains
+ * (renumbered 1..n). Nothing is emitted for a decision that changes nothing.
+ */
+declare function compilePageOps(d: PageDecisions): PageOp[];
+
+/**
+ * The session's one undo/redo stack. Pure and generic: the workspace keeps page decisions and tool
+ * form values in it, each step with the label the menu shows ("Undo Rotate 3 pages"). A new step
+ * clears what was undone; the stack holds at most `limit` steps. Saved versions of the file are the
+ * durable undo: applying changes empties this stack.
+ */
+interface History<T> {
+    past: Array<{
+        label: string;
+        value: T;
+    }>;
+    present: {
+        label: string;
+        value: T;
+    };
+    future: Array<{
+        label: string;
+        value: T;
+    }>;
+}
+declare const HISTORY_LIMIT = 100;
+declare function startHistory<T>(value: T): History<T>;
+declare function pushStep<T>(h: History<T>, label: string, value: T, limit?: number): History<T>;
+declare function undo<T>(h: History<T>): History<T>;
+declare function redo<T>(h: History<T>): History<T>;
+declare const canUndo: (h: History<unknown>) => boolean;
+declare const canRedo: (h: History<unknown>) => boolean;
+/** The label of the step Undo would take back. */
+declare const undoLabel: (h: History<unknown>) => string;
+declare const redoLabel: (h: History<unknown>) => string;
+
+/**
+ * What the PDF workspace needs from the app that mounts it. The package owns the chrome (rail,
+ * panels, top bar, find, undo, shortcuts); the host owns everything that touches a server, a route
+ * or the PDF engine: it injects them as ONE object (`PdfWorkspaceHost`), the same way the Sheets and
+ * Docs hosts inject theirs. Nothing here fails silently: an operation that cannot run REJECTS with a
+ * sentence and the shell shows it; an optional port that is absent hides its control (no dead button).
+ */
+
+/** What the shell hands the injected viewer. */
+interface PdfViewerState {
+    /** 1 = the container's width (the viewer's own zoom unit). */
+    zoom: number;
+    spread: "single" | "two-up";
+    /** Pending turns per page, degrees clockwise (see `PageDecisions`). */
+    rotations: Record<number, number>;
+    /** Changes when the file changed on the server: the viewer must load it again. */
+    reloadKey: number;
+    /** The document parsed with this many pages. */
+    onDocumentLoad(pageCount: number): void;
+    /** A page was measured, in PDF points (crop and fit-page need it). */
+    onPageSize(page: number, widthPt: number, heightPt: number): void;
+}
+type PdfRunRequest = {
+    tool: "apply-pages";
+    ops: PageOp[];
+} | {
+    tool: "extract-pages";
+    pages: number[];
+} | {
+    tool: "split";
+    maxPagesPerPart: number;
+} | {
+    tool: "crop";
+    pages: number[];
+    box: {
+        x0: number;
+        y0: number;
+        x1: number;
+        y1: number;
+    };
+} | {
+    tool: "redact";
+    pattern: string;
+    reason: string;
+} | {
+    tool: "compress";
+    level: 1 | 2 | 3 | 4 | 5;
+} | {
+    tool: "extract-text";
+} | {
+    tool: "extract-tables";
+    pages: number[];
+};
+type PdfRunResult = 
+/** The file itself changed (a new version): the shell reloads the viewer. */
+{
+    kind: "replaced";
+    version?: number;
+}
+/** A new file was made (the original is untouched). */
+ | {
+    kind: "file";
+    fileId: string;
+    name?: string;
+} | {
+    kind: "text";
+    text: string;
+} | {
+    kind: "tables";
+    tables: Array<{
+        page: number;
+        rows: string[][];
+    }>;
+};
+interface PdfWorkspaceHost {
+    file: {
+        id: string;
+        name: string;
+    };
+    /** The injected windowed viewer (`@ai-matrx/media/viewers/pdf`, continuous layout, no toolbar). */
+    renderViewer(state: PdfViewerState): ReactNode;
+    /** One page thumbnail (the left panel). Absent: the panel numbers its pages only. */
+    renderThumbnail?(page: number, widthPx: number): ReactNode;
+    /** Run one tool on the server. Rejects with a sentence on failure. */
+    run(request: PdfRunRequest): Promise<PdfRunResult>;
+    /** Open another page of the app for the same file (Scan, Sign). */
+    openTool(tool: "scan" | "sign"): void;
+    /** Open a file the workspace made. */
+    openFile(fileId: string): void;
+    download(): void;
+    /** Absent: no Share control. */
+    share?(): void;
+    /** Rename the file. Absent: the name is read-only. */
+    rename?(name: string): Promise<void>;
+    /** Print the whole file (`pages` null) or just these. Absent: no Print control. */
+    print?(pages: number[] | null): Promise<void>;
+    /** The layers (optional content) of the document. Absent: the Layers tab announces it is not built. */
+    layers?: {
+        list(): Promise<Array<{
+            id: string;
+            name: string;
+            visible: boolean;
+        }>>;
+        set(id: string, visible: boolean): Promise<void>;
+    };
+    /** The server's redaction pattern catalog (ids are the server's contract). Absent: a free pattern field. */
+    redactPatterns?(): Promise<Array<{
+        id: string;
+        label: string;
+    }>>;
+    /** False while the device is offline: the save pill says so and edits are not queued. */
+    online?: boolean;
+    /** Show a failure to the person (the host's toast). Defaults to an inline banner. */
+    notify?(message: string, tone: "error" | "info"): void;
+}
+
+export { HISTORY_LIMIT, type History, type KeyLike, PDF_COMING_SOON, PDF_SHORTCUTS, PDF_TOOLS, type PageDecisions, type PageOp, type PdfActionId, type PdfRunRequest, type PdfRunResult, type PdfShortcut, type PdfToolDef, type PdfToolId, type PdfViewerState, type PdfWorkspaceHost, type Turn, canRedo, canUndo, comingSoonIdOf, compilePageOps, deletePages, formatKeys, freshDecisions, isDirty, keptOrder, matchShortcut, pdfTool, pushStep, redo, redoLabel, reorderPages, restorePages, startHistory, turnPages, undo, undoLabel };