@ai-matrx/office 0.8.48 → 0.8.49

package/dist/pdf.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode } from 'react';
+import { ComponentType, ReactNode } from 'react';
 import { ComingSoonEntry } from '@ai-matrx/kit/coming-soon';
 
 /**
@@ -62,6 +62,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). */
@@ -119,6 +121,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;
@@ -155,6 +189,8 @@ 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. */
@@ -252,4 +288,4 @@ declare const canRedo: (h: History<unknown>) => boolean;
 declare const undoLabel: (h: History<unknown>) => string;
 declare const redoLabel: (h: History<unknown>) => string;
 
-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, PdfWorkspace, type PdfWorkspaceHost, type PdfWorkspaceProps, 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, PdfWorkspace, type PdfWorkspaceHost, type PdfWorkspaceProps, 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.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode } from 'react';
+import { ComponentType, ReactNode } from 'react';
 import { ComingSoonEntry } from '@ai-matrx/kit/coming-soon';
 
 /**
@@ -62,6 +62,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). */
@@ -119,6 +121,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;
@@ -155,6 +189,8 @@ 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. */
@@ -252,4 +288,4 @@ declare const canRedo: (h: History<unknown>) => boolean;
 declare const undoLabel: (h: History<unknown>) => string;
 declare const redoLabel: (h: History<unknown>) => string;
 
-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, PdfWorkspace, type PdfWorkspaceHost, type PdfWorkspaceProps, 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, PdfWorkspace, type PdfWorkspaceHost, type PdfWorkspaceProps, 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.js

@@ -564,25 +564,41 @@ function useWidth(ref) {
   }, [ref]);
   return size;
 }
-function ToolRows({ tool, onPick }) {
-  return /* @__PURE__ */ jsx3(Fragment3, { children: PDF_TOOLS.filter((t) => t.id !== "browse").map((t) => {
-    const Icon = PDF_TOOL_ICONS[t.id];
-    return /* @__PURE__ */ jsx3("li", { role: "none", children: /* @__PURE__ */ jsxs3(
+function ToolRows({ tool, hostTools, onPick }) {
+  return /* @__PURE__ */ jsxs3(Fragment3, { children: [
+    hostTools.map((t) => /* @__PURE__ */ jsx3("li", { role: "none", children: /* @__PURE__ */ jsxs3(
       "button",
       {
         type: "button",
         role: "menuitem",
-        "aria-current": t.id === tool ? "true" : void 0,
-        className: 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: 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__ */ jsx3(Icon, { className: "size-4 shrink-0" }),
-          /* @__PURE__ */ jsx3("span", { className: "flex-1 whitespace-nowrap", children: t.label }),
-          t.status === "soon" ? /* @__PURE__ */ jsx3("span", { className: "text-muted-foreground", children: "Coming soon" }) : null
+          /* @__PURE__ */ jsx3(t.icon, { className: "size-4 shrink-0" }),
+          /* @__PURE__ */ jsx3("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__ */ jsx3("li", { role: "none", children: /* @__PURE__ */ jsxs3(
+        "button",
+        {
+          type: "button",
+          role: "menuitem",
+          "aria-current": t.id === tool ? "true" : void 0,
+          className: 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__ */ jsx3(Icon, { className: "size-4 shrink-0" }),
+            /* @__PURE__ */ jsx3("span", { className: "flex-1 whitespace-nowrap", children: t.label }),
+            t.status === "soon" ? /* @__PURE__ */ jsx3("span", { className: "text-muted-foreground", children: "Coming soon" }) : null
+          ]
+        }
+      ) }, t.id);
+    })
+  ] });
 }
 function PdfWorkspace({ host, className }) {
   const rootRef = useRef2(null);
@@ -596,6 +612,10 @@ function PdfWorkspace({ host, className }) {
   const decisions = history.present.value;
   const dirty = isDirty(decisions);
   const [tool, setTool] = useState3("browse");
+  const [hostToolId, setHostToolId] = useState3(null);
+  const hostTools = useMemo2(() => 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] = useState3(true);
   const [rightOpen, setRightOpen] = useState3(true);
   const [leftTab, setLeftTab] = useState3("pages");
@@ -748,8 +768,17 @@ function PdfWorkspace({ host, className }) {
   const discard = useCallback(() => setHistory(startHistory(freshDecisions(pageCount))), [pageCount]);
   const chooseTool = 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;
@@ -772,9 +801,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: MoreHorizontalIcon });
     return groups.filter((g) => g.length);
-  }, []);
+  }, [hostTools]);
   const runAction = useCallback(
     (action) => {
       if (action.startsWith("tool:")) return chooseTool(action.slice(5));
@@ -862,7 +892,10 @@ function PdfWorkspace({ host, className }) {
     }
   );
   const iconBtn = (label, icon, onClick, opts) => /* @__PURE__ */ jsx3(Button2, { 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__ */ jsx3(
     Field2,
     {
@@ -893,7 +926,13 @@ function PdfWorkspace({ host, className }) {
       children: host.file.name
     }
   );
-  const rightPanel = /* @__PURE__ */ jsxs3("div", { className: "flex h-full min-h-0 flex-col", children: [
+  const rightPanel = hostTool ? /* @__PURE__ */ jsxs3("div", { className: "flex h-full min-h-0 flex-col", "data-pdf-host-tool": hostTool.id, children: [
+    /* @__PURE__ */ jsxs3("div", { className: "shrink-0 border-b border-border px-3 py-2", children: [
+      /* @__PURE__ */ jsx3("div", { className: "text-sm font-medium", children: hostTool.label }),
+      hostTool.hint ? /* @__PURE__ */ jsx3("div", { className: "text-xs text-muted-foreground", children: hostTool.hint }) : null
+    ] }),
+    /* @__PURE__ */ jsx3("div", { className: "min-h-0 flex-1 overflow-hidden", children: hostTool.render({ currentPage, pageCount, selected: selectedPages, goToPage, reload: () => setReloadKey((k) => k + 1) }) })
+  ] }) : /* @__PURE__ */ jsxs3("div", { className: "flex h-full min-h-0 flex-col", children: [
     /* @__PURE__ */ jsxs3("div", { className: "shrink-0 border-b border-border px-3 py-2", children: [
       /* @__PURE__ */ jsx3("div", { className: "text-sm font-medium", children: toolDef.label }),
       toolDef.hint ? /* @__PURE__ */ jsx3("div", { className: "text-xs text-muted-foreground", children: toolDef.hint }) : null
@@ -940,9 +979,10 @@ function PdfWorkspace({ host, className }) {
       onLayersSoon: () => void announceSoon("pdf.layers").catch(fail)
     }
   );
+  const viewerPage = hostTool?.followsPage ? currentPage : 1;
   const viewer = useMemo2(
-    () => /* @__PURE__ */ jsx3(Fragment2, { children: host.renderViewer({ zoom, spread, rotations: decisions.turns, reloadKey, onDocumentLoad, onPageSize }) }, reloadKey),
-    [host, reloadKey, zoom, spread, decisions.turns, onDocumentLoad, onPageSize]
+    () => /* @__PURE__ */ jsx3(Fragment2, { 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";
@@ -1055,15 +1095,15 @@ function PdfWorkspace({ host, className }) {
           iconBtn("Reading mode", /* @__PURE__ */ jsx3(ExpandIcon, {}), () => setRead(true))
         ] }) : null,
         /* @__PURE__ */ jsxs3("div", { className: "relative flex min-h-0 flex-1", children: [
-          showChrome && !compact ? /* @__PURE__ */ jsx3("div", { className: "flex w-10 shrink-0 flex-col items-center border-r border-border bg-background py-2", "data-pdf-rail": "", children: /* @__PURE__ */ jsx3(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__ */ jsx3("div", { className: "flex w-10 shrink-0 flex-col items-center border-r border-border bg-background py-2", "data-pdf-rail": "", children: /* @__PURE__ */ jsx3(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__ */ jsx3("aside", { className: "w-56 shrink-0 border-r border-border bg-background", "aria-label": "Pages", "data-pdf-left": "", children: leftPanel }) : null,
           /* @__PURE__ */ jsxs3("main", { className: "relative flex min-w-0 flex-1 flex-col", children: [
             findOpen ? /* @__PURE__ */ jsx3("div", { className: "absolute right-4 top-2 z-20", children: /* @__PURE__ */ jsx3(RenderedFindBar, { rootRef: scrollerRef, onClose: () => setFindOpen(false), label: "Find in document", focusRequest: findFocus, compact: true }) }) : null,
             /* @__PURE__ */ jsx3("div", { ref: scrollerRef, tabIndex: 0, "data-pdf-scroller": "", className: "min-h-0 flex-1 overflow-auto bg-muted outline-none", children: viewer }),
             read ? /* @__PURE__ */ jsx3("div", { className: "absolute right-3 top-3 z-20", children: /* @__PURE__ */ jsx3(Button2, { variant: "outline", icon: /* @__PURE__ */ jsx3(XIcon, {}), onClick: () => setRead(false), children: "Exit reading mode" }) }) : null
           ] }),
-          showChrome && !compact && rightOpen ? /* @__PURE__ */ jsx3("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__ */ jsx3("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__ */ jsx3(ToolRows, { tool, onPick: (id) => {
+          showChrome && !compact && rightOpen ? /* @__PURE__ */ jsx3("aside", { className: 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__ */ jsx3("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__ */ jsx3(ToolRows, { tool: activeToolKey, hostTools, onPick: (id) => {
             setPop(null);
             chooseTool(id);
           } }) }) : null,
@@ -1094,7 +1134,7 @@ function PdfWorkspace({ host, className }) {
           compact && sheet ? /* @__PURE__ */ jsxs3(Fragment3, { children: [
             /* @__PURE__ */ jsx3("button", { type: "button", "aria-label": "Close", className: "absolute inset-0 z-30 bg-background/60", onClick: () => setSheet(null) }),
             /* @__PURE__ */ jsx3("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__ */ jsx3("div", { className: "h-[60vh] min-h-0", children: leftPanel }) : /* @__PURE__ */ jsxs3("div", { className: "flex min-h-0 flex-col overflow-y-auto", children: [
-              /* @__PURE__ */ jsx3("ul", { className: "p-2", role: "menu", "aria-label": "Tools", children: /* @__PURE__ */ jsx3(ToolRows, { tool, onPick: chooseTool }) }),
+              /* @__PURE__ */ jsx3("ul", { className: "p-2", role: "menu", "aria-label": "Tools", children: /* @__PURE__ */ jsx3(ToolRows, { tool: activeToolKey, hostTools, onPick: chooseTool }) }),
               /* @__PURE__ */ jsx3("div", { className: "border-t border-border", children: rightPanel })
             ] }) })
           ] }) : null