@ai-matrx/office 0.8.48 → 0.8.50

package/CHANGELOG.md

@@ -1,10 +1,25 @@
 # Changelog
 
-## 0.8.48
+## 0.8.50
 
 UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
 Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/office/src`.
 
+## 0.8.49
+
+SOURCE CHANGED WITH NO RELEASE NOTE. This release shipped source changes that nobody described in an Unreleased entry,
+so they may include breaking API changes. Consumer action is UNKNOWN: read the diff before upgrading.
+Diff: `git diff 184cfc8959 90e2be3bbc -- apps/shared/office/src`
+
+Changed shipped source files (2):
+- `apps/shared/office/src/pdf/PdfWorkspace.tsx`
+- `apps/shared/office/src/pdf/ports.ts`
+
+## 0.8.48
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 5da59424ae 184cfc8959 -- apps/shared/office/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 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.
@@ -305,6 +320,7 @@ Changed shipped source files (8):
 
 ### Unreleased
 
+- `./pdf`: `PdfWorkspaceHost.tools` lets the host bring its own rail tools (`PdfHostTool`: id, label, icon, `render(context)`, optional `wide` and `followsPage`); the shell gives each a rail button, an All-tools row, tool-search hit and the right panel, and tells it the page, page count, selection, `goToPage` and `reload`. `PdfViewerState.currentPage` is passed while a `followsPage` tool is open. Consumer action: none (optional).
 - **US spelling: the British spelling of "color" no longer exists in this package (Arman, 2026-10-21).** Every label, template string, comment, identifier, CSS class/variable and test name that spelled it the British way now says color. Guard: `design-system/src/us-spelling.test.ts` scans all of `apps/` for the word. Consumer action: none for imports; if you matched on a British-spelled identifier, class or CSS variable from this package, use the `color` spelling; update the package.
 - **Sheets co-editing on the ordered log (C6).** `@ai-matrx/office/univer/collab` adds the Sheets room: `openSheetsOtRoom` (the C2 session over the C5a/C5b group transform, saves at a quiet point with a matching hash, restore through `collab_replace`, undo items rebased over every remote op), `univerSheetsOtPort` (capture: onlyLocal/fromCollab filtered, grouped by outermost command with a try/finally depth guard on both execute paths, params allowlist, completeCellContent, exact merge removals, style objects never ids, whole-style overrides restated as merges, annotateFormulas, inverses from the applied params against a pre-state copy; a barrier or unknown id is `not_shared` and rolls the seat back), `sheetsStateHash` / `canonicalSheet` (merges as a set, defined names by id; the transform fuzz now hashes through it), and `startWorkbookOtRoom` / `workbookUsesOrderedRoom` (the `udt_workbook_snapshots` store, the C1 doors, presence). A remote row/column insert, remove or move carries this seat's selection along and never leaves it past the sheet's edge (the port's `selections` option; a stale whole-row selection after a peer's column delete crashed the editor in the live run). Remote applies run with `{ fromCollab: true }` only (not `onlyLocal`): Univer's formula engine skips onlyLocal value writes, so a peer's formula showed blank on every other seat in the live run. Flip is per room exactly like Docs. Consumer action: matrx-frontend's WorkbookEditor opens it when the workbook's room exists or `collab.ot_rooms` says so (shipped with this release); every other consumer: none.
 

package/dist/pdf-model.d.cts

@@ -1,5 +1,5 @@
 import { ComingSoonEntry } from '@ai-matrx/kit/coming-soon';
-import { ReactNode } from 'react';
+import { ComponentType, ReactNode } from 'react';
 
 /**
  * The PDF workspace's tool rail, as data. Pure (no React, no icons): the host registers the
@@ -146,6 +146,8 @@ interface PdfViewerState {
     rotations: Record<number, number>;
     /** Changes when the file changed on the server: the viewer must load it again. */
     reloadKey: number;
+    /** The page the person is on (1-based), passed only while a host tool with `followsPage` is open; otherwise 1. */
+    currentPage: 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). */
@@ -203,6 +205,38 @@ type PdfRunResult =
         rows: string[][];
     }>;
 };
+/** What the shell tells a host tool's panel about the session it sits in. */
+interface PdfHostToolContext {
+    currentPage: number;
+    pageCount: number;
+    /** Original page numbers selected in the page panel (empty when none). */
+    selected: number[];
+    goToPage(n: number): void;
+    /** The file changed under the same id: draw the viewer and thumbnails again. */
+    reload(): void;
+}
+/**
+ * A tool the host brings to the rail. The shell gives it a rail button, a place in "All tools", the
+ * tool search and the right panel; the host owns what is inside (its own server calls and state).
+ * This is how an app folds its older studios into the workspace without the package knowing them.
+ */
+interface PdfHostTool {
+    /** Unique among the host's tools. */
+    id: string;
+    label: string;
+    /** One short line under the panel title. */
+    hint?: string;
+    icon: ComponentType<{
+        className?: string;
+    }>;
+    /** The viewer receives `currentPage` while this tool is open (a one-page-at-a-time canvas needs it). */
+    followsPage?: boolean;
+    /** A wide panel (28rem) instead of the standard one (18rem). */
+    wide?: boolean;
+    /** Rail group: 1 (default) sits with the document tools. */
+    group?: 0 | 1 | 2;
+    render(context: PdfHostToolContext): ReactNode;
+}
 interface PdfWorkspaceHost {
     file: {
         id: string;
@@ -212,6 +246,8 @@ interface PdfWorkspaceHost {
     renderViewer(state: PdfViewerState): ReactNode;
     /** One page thumbnail (the left panel). Absent: the panel numbers its pages only. */
     renderThumbnail?(page: number, widthPx: number): ReactNode;
+    /** A small badge drawn in the corner of one page's thumbnail (the app's annotation count, for example). Null or absent: none. */
+    renderPageBadge?(page: 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). */
@@ -239,10 +275,12 @@ interface PdfWorkspaceHost {
         id: string;
         label: string;
     }>>;
+    /** Extra tools the host brings (see `PdfHostTool`). */
+    tools?: PdfHostTool[];
     /** 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 };
+export { HISTORY_LIMIT, type History, type KeyLike, PDF_COMING_SOON, PDF_SHORTCUTS, PDF_TOOLS, type PageDecisions, type PageOp, type PdfActionId, type PdfHostTool, type PdfHostToolContext, 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 };

package/dist/pdf-model.d.ts

@@ -1,5 +1,5 @@
 import { ComingSoonEntry } from '@ai-matrx/kit/coming-soon';
-import { ReactNode } from 'react';
+import { ComponentType, ReactNode } from 'react';
 
 /**
  * The PDF workspace's tool rail, as data. Pure (no React, no icons): the host registers the
@@ -146,6 +146,8 @@ interface PdfViewerState {
     rotations: Record<number, number>;
     /** Changes when the file changed on the server: the viewer must load it again. */
     reloadKey: number;
+    /** The page the person is on (1-based), passed only while a host tool with `followsPage` is open; otherwise 1. */
+    currentPage: 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). */
@@ -203,6 +205,38 @@ type PdfRunResult =
         rows: string[][];
     }>;
 };
+/** What the shell tells a host tool's panel about the session it sits in. */
+interface PdfHostToolContext {
+    currentPage: number;
+    pageCount: number;
+    /** Original page numbers selected in the page panel (empty when none). */
+    selected: number[];
+    goToPage(n: number): void;
+    /** The file changed under the same id: draw the viewer and thumbnails again. */
+    reload(): void;
+}
+/**
+ * A tool the host brings to the rail. The shell gives it a rail button, a place in "All tools", the
+ * tool search and the right panel; the host owns what is inside (its own server calls and state).
+ * This is how an app folds its older studios into the workspace without the package knowing them.
+ */
+interface PdfHostTool {
+    /** Unique among the host's tools. */
+    id: string;
+    label: string;
+    /** One short line under the panel title. */
+    hint?: string;
+    icon: ComponentType<{
+        className?: string;
+    }>;
+    /** The viewer receives `currentPage` while this tool is open (a one-page-at-a-time canvas needs it). */
+    followsPage?: boolean;
+    /** A wide panel (28rem) instead of the standard one (18rem). */
+    wide?: boolean;
+    /** Rail group: 1 (default) sits with the document tools. */
+    group?: 0 | 1 | 2;
+    render(context: PdfHostToolContext): ReactNode;
+}
 interface PdfWorkspaceHost {
     file: {
         id: string;
@@ -212,6 +246,8 @@ interface PdfWorkspaceHost {
     renderViewer(state: PdfViewerState): ReactNode;
     /** One page thumbnail (the left panel). Absent: the panel numbers its pages only. */
     renderThumbnail?(page: number, widthPx: number): ReactNode;
+    /** A small badge drawn in the corner of one page's thumbnail (the app's annotation count, for example). Null or absent: none. */
+    renderPageBadge?(page: 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). */
@@ -239,10 +275,12 @@ interface PdfWorkspaceHost {
         id: string;
         label: string;
     }>>;
+    /** Extra tools the host brings (see `PdfHostTool`). */
+    tools?: PdfHostTool[];
     /** 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 };
+export { HISTORY_LIMIT, type History, type KeyLike, PDF_COMING_SOON, PDF_SHORTCUTS, PDF_TOOLS, type PageDecisions, type PageOp, type PdfActionId, type PdfHostTool, type PdfHostToolContext, 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 };

package/dist/pdf.cjs

@@ -157,6 +157,7 @@ function LeftPanel(p) {
           const turn = p.decisions.turns[page] ?? 0;
           return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "relative flex h-full w-full items-center justify-center overflow-hidden bg-card", children: [
             /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { transform: turn ? `rotate(${turn}deg)` : void 0 }, className: "flex h-full w-full items-center justify-center", children: p.host.renderThumbnail ? p.host.renderThumbnail(page, THUMB_W) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "text-xs text-muted-foreground", children: page }) }),
+            p.host.renderPageBadge ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "pointer-events-none absolute right-1 top-1 z-10", "data-pdf-page-badge": page, children: p.host.renderPageBadge(page) }) : null,
             page === p.currentPage ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "pointer-events-none absolute inset-0 border-2 border-primary" }) : null,
             gone.has(page) ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "absolute inset-0 flex items-center justify-center bg-background/80 text-xs font-medium text-destructive", children: "Deleted" }) : null
           ] });
@@ -585,25 +586,41 @@ function useWidth(ref) {
   }, [ref]);
   return size;
 }
-function ToolRows({ tool, onPick }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_jsx_runtime3.Fragment, { children: PDF_TOOLS.filter((t) => t.id !== "browse").map((t) => {
-    const Icon = PDF_TOOL_ICONS[t.id];
-    return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("li", { role: "none", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+function ToolRows({ tool, hostTools, onPick }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
+    hostTools.map((t) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("li", { role: "none", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
       "button",
       {
         type: "button",
         role: "menuitem",
-        "aria-current": t.id === tool ? "true" : void 0,
-        className: (0, import_cn.cn)("flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-xs hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", t.id === tool && "bg-accent"),
-        onClick: () => onPick(t.id),
+        "aria-current": tool === `host:${t.id}` ? "true" : void 0,
+        className: (0, import_cn.cn)("flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-xs hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", tool === `host:${t.id}` && "bg-accent"),
+        onClick: () => onPick(`host:${t.id}`),
         children: [
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Icon, { className: "size-4 shrink-0" }),
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "flex-1 whitespace-nowrap", children: t.label }),
-          t.status === "soon" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "text-muted-foreground", children: "Coming soon" }) : null
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(t.icon, { className: "size-4 shrink-0" }),
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "flex-1 whitespace-nowrap", children: t.label })
         ]
       }
-    ) }, t.id);
-  }) });
+    ) }, `host:${t.id}`)),
+    PDF_TOOLS.filter((t) => t.id !== "browse").map((t) => {
+      const Icon = PDF_TOOL_ICONS[t.id];
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("li", { role: "none", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+        "button",
+        {
+          type: "button",
+          role: "menuitem",
+          "aria-current": t.id === tool ? "true" : void 0,
+          className: (0, import_cn.cn)("flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-xs hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", t.id === tool && "bg-accent"),
+          onClick: () => onPick(t.id),
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Icon, { className: "size-4 shrink-0" }),
+            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "flex-1 whitespace-nowrap", children: t.label }),
+            t.status === "soon" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "text-muted-foreground", children: "Coming soon" }) : null
+          ]
+        }
+      ) }, t.id);
+    })
+  ] });
 }
 function PdfWorkspace({ host, className }) {
   const rootRef = (0, import_react3.useRef)(null);
@@ -617,6 +634,10 @@ function PdfWorkspace({ host, className }) {
   const decisions = history.present.value;
   const dirty = isDirty(decisions);
   const [tool, setTool] = (0, import_react3.useState)("browse");
+  const [hostToolId, setHostToolId] = (0, import_react3.useState)(null);
+  const hostTools = (0, import_react3.useMemo)(() => host.tools ?? [], [host.tools]);
+  const hostTool = hostToolId ? hostTools.find((t) => t.id === hostToolId) ?? null : null;
+  const activeToolKey = hostTool ? `host:${hostTool.id}` : tool;
   const [leftOpen, setLeftOpen] = (0, import_react3.useState)(true);
   const [rightOpen, setRightOpen] = (0, import_react3.useState)(true);
   const [leftTab, setLeftTab] = (0, import_react3.useState)("pages");
@@ -769,8 +790,17 @@ function PdfWorkspace({ host, className }) {
   const discard = (0, import_react3.useCallback)(() => setHistory(startHistory(freshDecisions(pageCount))), [pageCount]);
   const chooseTool = (0, import_react3.useCallback)(
     (id) => {
+      if (id.startsWith("host:")) {
+        setHostToolId(id.slice(5));
+        setResult(null);
+        setError(null);
+        setRightOpen(true);
+        if (compact) setSheet("tools");
+        return;
+      }
       const def = pdfTool(id);
       if (!def) return;
+      setHostToolId(null);
       if (def.status === "soon") {
         announceSoon(comingSoonIdOf(def.id)).catch(fail);
         return;
@@ -793,9 +823,10 @@ function PdfWorkspace({ host, className }) {
       if (t.status !== "ready") continue;
       groups[t.group].push({ id: t.id, label: t.label, icon: PDF_TOOL_ICONS[t.id], ...t.key ? { shortcut: t.key.toUpperCase() } : null });
     }
+    for (const t of hostTools) groups[t.group ?? 1].push({ id: `host:${t.id}`, label: t.label, icon: t.icon });
     groups[2].push({ id: ALL_TOOLS, label: "All tools", icon: import_icons2.MoreHorizontalIcon });
     return groups.filter((g) => g.length);
-  }, []);
+  }, [hostTools]);
   const runAction = (0, import_react3.useCallback)(
     (action) => {
       if (action.startsWith("tool:")) return chooseTool(action.slice(5));
@@ -883,7 +914,10 @@ function PdfWorkspace({ host, className }) {
     }
   );
   const iconBtn = (label, icon, onClick, opts) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_controls4.Button, { variant: "quiet", icon, "aria-label": label, title: label, onClick, ...opts?.disabled !== void 0 ? { disabled: opts.disabled } : null, ...opts?.pressed !== void 0 ? { pressed: opts.pressed } : null });
-  const toolHits = toolQuery.trim() ? PDF_TOOLS.filter((t) => t.label.toLowerCase().includes(toolQuery.trim().toLowerCase())) : [];
+  const toolHits = toolQuery.trim() ? [
+    ...hostTools.map((t) => ({ id: `host:${t.id}`, label: t.label, status: "ready" })),
+    ...PDF_TOOLS
+  ].filter((t) => t.label.toLowerCase().includes(toolQuery.trim().toLowerCase())) : [];
   const nameNode = editingName && host.rename ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
     import_controls4.Field,
     {
@@ -914,7 +948,13 @@ function PdfWorkspace({ host, className }) {
       children: host.file.name
     }
   );
-  const rightPanel = /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "flex h-full min-h-0 flex-col", children: [
+  const rightPanel = hostTool ? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "flex h-full min-h-0 flex-col", "data-pdf-host-tool": hostTool.id, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "shrink-0 border-b border-border px-3 py-2", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "text-sm font-medium", children: hostTool.label }),
+      hostTool.hint ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "text-xs text-muted-foreground", children: hostTool.hint }) : null
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "min-h-0 flex-1 overflow-hidden", children: hostTool.render({ currentPage, pageCount, selected: selectedPages, goToPage, reload: () => setReloadKey((k) => k + 1) }) })
+  ] }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "flex h-full min-h-0 flex-col", children: [
     /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "shrink-0 border-b border-border px-3 py-2", children: [
       /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "text-sm font-medium", children: toolDef.label }),
       toolDef.hint ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "text-xs text-muted-foreground", children: toolDef.hint }) : null
@@ -961,9 +1001,10 @@ function PdfWorkspace({ host, className }) {
       onLayersSoon: () => void announceSoon("pdf.layers").catch(fail)
     }
   );
+  const viewerPage = hostTool?.followsPage ? currentPage : 1;
   const viewer = (0, import_react3.useMemo)(
-    () => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react3.Fragment, { children: host.renderViewer({ zoom, spread, rotations: decisions.turns, reloadKey, onDocumentLoad, onPageSize }) }, reloadKey),
-    [host, reloadKey, zoom, spread, decisions.turns, onDocumentLoad, onPageSize]
+    () => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_react3.Fragment, { children: host.renderViewer({ zoom, spread, rotations: decisions.turns, reloadKey, currentPage: viewerPage, onDocumentLoad, onPageSize }) }, reloadKey),
+    [host, reloadKey, zoom, spread, decisions.turns, viewerPage, onDocumentLoad, onPageSize]
   );
   const showChrome = !read;
   const popCard = "absolute right-2 top-11 z-30 rounded-lg border border-border bg-popover p-3 text-popover-foreground shadow-lg";
@@ -1076,15 +1117,15 @@ function PdfWorkspace({ host, className }) {
           iconBtn("Reading mode", /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_icons2.ExpandIcon, {}), () => setRead(true))
         ] }) : null,
         /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "relative flex min-h-0 flex-1", children: [
-          showChrome && !compact ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "flex w-10 shrink-0 flex-col items-center border-r border-border bg-background py-2", "data-pdf-rail": "", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_controls4.ToolRail, { groups: railGroups, value: pop === "all-tools" ? ALL_TOOLS : tool, onValueChange: (id) => id === ALL_TOOLS ? setPop((p) => p === "all-tools" ? null : "all-tools") : id && chooseTool(id), "aria-label": "PDF tools" }) }) : null,
+          showChrome && !compact ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "flex w-10 shrink-0 flex-col items-center border-r border-border bg-background py-2", "data-pdf-rail": "", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_controls4.ToolRail, { groups: railGroups, value: pop === "all-tools" ? ALL_TOOLS : activeToolKey, onValueChange: (id) => id === ALL_TOOLS ? setPop((p) => p === "all-tools" ? null : "all-tools") : id && chooseTool(id), "aria-label": "PDF tools" }) }) : null,
           showChrome && !compact && leftOpen ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("aside", { className: "w-56 shrink-0 border-r border-border bg-background", "aria-label": "Pages", "data-pdf-left": "", children: leftPanel }) : null,
           /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("main", { className: "relative flex min-w-0 flex-1 flex-col", children: [
             findOpen ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "absolute right-4 top-2 z-20", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_RenderedFindBar.RenderedFindBar, { rootRef: scrollerRef, onClose: () => setFindOpen(false), label: "Find in document", focusRequest: findFocus, compact: true }) }) : null,
             /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { ref: scrollerRef, tabIndex: 0, "data-pdf-scroller": "", className: "min-h-0 flex-1 overflow-auto bg-muted outline-none", children: viewer }),
             read ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "absolute right-3 top-3 z-20", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_controls4.Button, { variant: "outline", icon: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_icons2.XIcon, {}), onClick: () => setRead(false), children: "Exit reading mode" }) }) : null
           ] }),
-          showChrome && !compact && rightOpen ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("aside", { className: "w-72 shrink-0 border-l border-border bg-background", "aria-label": "Properties", "data-pdf-right": "", children: rightPanel }) : null,
-          pop === "all-tools" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("ul", { role: "menu", "aria-label": "All tools", className: "absolute left-12 top-2 z-30 w-72 rounded-lg border border-border bg-popover p-1 shadow-lg", "data-pdf-all-tools": "", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(ToolRows, { tool, onPick: (id) => {
+          showChrome && !compact && rightOpen ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("aside", { className: (0, import_cn.cn)("shrink-0 border-l border-border bg-background", hostTool?.wide ? "w-[28rem]" : "w-72"), "aria-label": "Properties", "data-pdf-right": "", children: rightPanel }) : null,
+          pop === "all-tools" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("ul", { role: "menu", "aria-label": "All tools", className: "absolute left-12 top-2 z-30 w-72 rounded-lg border border-border bg-popover p-1 shadow-lg", "data-pdf-all-tools": "", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(ToolRows, { tool: activeToolKey, hostTools, onPick: (id) => {
             setPop(null);
             chooseTool(id);
           } }) }) : null,
@@ -1115,7 +1156,7 @@ function PdfWorkspace({ host, className }) {
           compact && sheet ? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
             /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { type: "button", "aria-label": "Close", className: "absolute inset-0 z-30 bg-background/60", onClick: () => setSheet(null) }),
             /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "absolute inset-x-0 bottom-0 z-40 flex max-h-[75%] flex-col rounded-t-xl border-t border-border bg-background", role: "dialog", "aria-label": sheet === "pages" ? "Pages" : "Tools", children: sheet === "pages" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "h-[60vh] min-h-0", children: leftPanel }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "flex min-h-0 flex-col overflow-y-auto", children: [
-              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("ul", { className: "p-2", role: "menu", "aria-label": "Tools", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(ToolRows, { tool, onPick: chooseTool }) }),
+              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("ul", { className: "p-2", role: "menu", "aria-label": "Tools", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(ToolRows, { tool: activeToolKey, hostTools, onPick: chooseTool }) }),
               /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "border-t border-border", children: rightPanel })
             ] }) })
           ] }) : null