@arbidocs/blocks 0.5.119 → 0.5.121

package/dist/connection/presentation/PresentationFileCard.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/presentation/PresentationFileCard.tsx"],
+  "sourcesContent": ["/**\n * A presentation saved before presentations were PDFs (the editable data alone), in the viewer's\n * PDF tab: it has no slides to show there, so the card says what it is and opens its slides.\n */\n\nimport { Pencil, Presentation } from 'lucide-react'\nimport { useArbiSessionStore } from '@arbidocs/react'\nimport { Button } from '@arbidocs/react/ui'\nimport { EmptyState } from '../../components/EmptyState'\nimport { presentationTitle } from '../../presentation/persistence'\nimport { editPresentation } from './requests'\n\nexport interface PresentationFileCardProps {\n  documentId: string\n  fileName: string\n}\n\n/** A presentation saved in the older format: opening it and saving makes it a presentation PDF. */\nexport function PresentationFileCard({ documentId, fileName }: PresentationFileCardProps) {\n  const session = useArbiSessionStore()\n  return (\n    <div className=\"flex h-full items-center justify-center p-6\" data-testid=\"presentation-file\">\n      <EmptyState\n        icon={Presentation}\n        title={presentationTitle(fileName)}\n        description=\"A presentation saved in an earlier format, without its slides. Open it and save it to keep it as a presentation PDF; this file can then be deleted.\"\n        action={\n          <Button\n            type=\"button\"\n            onClick={() => editPresentation(session, { kind: 'open', documentId })}\n            data-testid=\"presentation-file-edit\"\n          >\n            <Pencil className=\"size-4\" />\n            Open the slides\n          </Button>\n        }\n      />\n    </div>\n  )\n}\n"],
+  "mappings": ";AA2BU,SAKE,KALF;AAtBV,SAAS,QAAQ,oBAAoB;AACrC,SAAS,2BAA2B;AACpC,SAAS,cAAc;AACvB,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAClC,SAAS,wBAAwB;AAQ1B,SAAS,qBAAqB,EAAE,YAAY,SAAS,GAA8B;AACxF,QAAM,UAAU,oBAAoB;AACpC,SACE,oBAAC,SAAI,WAAU,+CAA8C,eAAY,qBACvE;AAAA,IAAC;AAAA;AAAA,MACC,MAAM;AAAA,MACN,OAAO,kBAAkB,QAAQ;AAAA,MACjC,aAAY;AAAA,MACZ,QACE;AAAA,QAAC;AAAA;AAAA,UACC,MAAK;AAAA,UACL,SAAS,MAAM,iBAAiB,SAAS,EAAE,MAAM,QAAQ,WAAW,CAAC;AAAA,UACrE,eAAY;AAAA,UAEZ;AAAA,gCAAC,UAAO,WAAU,UAAS;AAAA,YAAE;AAAA;AAAA;AAAA,MAE/B;AAAA;AAAA,EAEJ,GACF;AAEJ;",
+  "names": []
+}

package/dist/connection/presentation/PresentationPill.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Back to the presentation, from any document the viewer shows (clips are gathered while reading,
+ * then arranged): its title and how many clips wait in its tray. Shown while a presentation is
+ * being made and the viewer is elsewhere.
+ */
+export declare function PresentationPill({ compact }: {
+    compact: boolean;
+}): import("react").JSX.Element | null;

package/dist/connection/presentation/PresentationPill.js

@@ -0,0 +1,44 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Presentation } from "lucide-react";
+import { DOCUMENT_VIEWER_PANEL, useArbiSessionState, useArbiSessionStore } from "@arbidocs/react";
+import { Button } from "@arbidocs/react/ui";
+import { usePresentation } from "../../presentation/store.js";
+import { editPresentation } from "./requests.js";
+function PresentationPill({ compact }) {
+  const session = useArbiSessionStore();
+  const boundTo = usePresentation((s) => s.boundTo);
+  const clips = usePresentation((s) => s.clips.length);
+  const title = usePresentation((s) => s.title);
+  const onIt = useArbiSessionState(
+    (s) => s.viewingDocument?.id === boundTo && s.documentViewer.tab === "slides"
+  );
+  if (onIt || boundTo === null && clips === 0) return null;
+  const back = () => {
+    if (boundTo === null) return editPresentation(session, { kind: "new" });
+    session.setViewingDocument({ id: boundTo, page: null });
+    session.setDocumentViewer({ tab: "slides" });
+    session.openPanel(DOCUMENT_VIEWER_PANEL, "docked");
+  };
+  return /* @__PURE__ */ jsxs(
+    Button,
+    {
+      type: "button",
+      variant: "outline",
+      size: "sm",
+      className: "h-7 max-w-56 gap-1.5 rounded-full px-2.5 text-xs",
+      onClick: back,
+      title: `Back to the presentation "${title}": ${clips} clip${clips === 1 ? "" : "s"} to arrange`,
+      "data-testid": "presentation-pill",
+      children: [
+        /* @__PURE__ */ jsx(Presentation, { className: "size-3.5 shrink-0" }),
+        !compact && /* @__PURE__ */ jsx("span", { className: "min-w-0 truncate", children: title }),
+        clips > 0 && /* @__PURE__ */ jsx("span", { className: "rounded-full bg-primary px-1.5 text-[10px] font-semibold leading-4 text-primary-foreground", children: clips })
+      ]
+    }
+  );
+}
+export {
+  PresentationPill
+};
+//# sourceMappingURL=PresentationPill.js.map

package/dist/connection/presentation/PresentationPill.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/presentation/PresentationPill.tsx"],
+  "sourcesContent": ["import { Presentation } from 'lucide-react'\nimport { DOCUMENT_VIEWER_PANEL, useArbiSessionState, useArbiSessionStore } from '@arbidocs/react'\nimport { Button } from '@arbidocs/react/ui'\nimport { usePresentation } from '../../presentation/store'\nimport { editPresentation } from './requests'\n\n/**\n * Back to the presentation, from any document the viewer shows (clips are gathered while reading,\n * then arranged): its title and how many clips wait in its tray. Shown while a presentation is\n * being made and the viewer is elsewhere.\n */\nexport function PresentationPill({ compact }: { compact: boolean }) {\n  const session = useArbiSessionStore()\n  const boundTo = usePresentation((s) => s.boundTo)\n  const clips = usePresentation((s) => s.clips.length)\n  const title = usePresentation((s) => s.title)\n  const onIt = useArbiSessionState(\n    (s) => s.viewingDocument?.id === boundTo && s.documentViewer.tab === 'slides'\n  )\n  if (onIt || (boundTo === null && clips === 0)) return null\n  const back = () => {\n    if (boundTo === null) return editPresentation(session, { kind: 'new' })\n    session.setViewingDocument({ id: boundTo, page: null })\n    session.setDocumentViewer({ tab: 'slides' })\n    session.openPanel(DOCUMENT_VIEWER_PANEL, 'docked')\n  }\n  return (\n    <Button\n      type=\"button\"\n      variant=\"outline\"\n      size=\"sm\"\n      className=\"h-7 max-w-56 gap-1.5 rounded-full px-2.5 text-xs\"\n      onClick={back}\n      title={`Back to the presentation \"${title}\": ${clips} clip${clips === 1 ? '' : 's'} to arrange`}\n      data-testid=\"presentation-pill\"\n    >\n      <Presentation className=\"size-3.5 shrink-0\" />\n      {!compact && <span className=\"min-w-0 truncate\">{title}</span>}\n      {clips > 0 && (\n        <span className=\"rounded-full bg-primary px-1.5 text-[10px] font-semibold leading-4 text-primary-foreground\">\n          {clips}\n        </span>\n      )}\n    </Button>\n  )\n}\n"],
+  "mappings": ";AA2BI,SASE,KATF;AA3BJ,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB,qBAAqB,2BAA2B;AAChF,SAAS,cAAc;AACvB,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AAO1B,SAAS,iBAAiB,EAAE,QAAQ,GAAyB;AAClE,QAAM,UAAU,oBAAoB;AACpC,QAAM,UAAU,gBAAgB,CAAC,MAAM,EAAE,OAAO;AAChD,QAAM,QAAQ,gBAAgB,CAAC,MAAM,EAAE,MAAM,MAAM;AACnD,QAAM,QAAQ,gBAAgB,CAAC,MAAM,EAAE,KAAK;AAC5C,QAAM,OAAO;AAAA,IACX,CAAC,MAAM,EAAE,iBAAiB,OAAO,WAAW,EAAE,eAAe,QAAQ;AAAA,EACvE;AACA,MAAI,QAAS,YAAY,QAAQ,UAAU,EAAI,QAAO;AACtD,QAAM,OAAO,MAAM;AACjB,QAAI,YAAY,KAAM,QAAO,iBAAiB,SAAS,EAAE,MAAM,MAAM,CAAC;AACtE,YAAQ,mBAAmB,EAAE,IAAI,SAAS,MAAM,KAAK,CAAC;AACtD,YAAQ,kBAAkB,EAAE,KAAK,SAAS,CAAC;AAC3C,YAAQ,UAAU,uBAAuB,QAAQ;AAAA,EACnD;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,SAAQ;AAAA,MACR,MAAK;AAAA,MACL,WAAU;AAAA,MACV,SAAS;AAAA,MACT,OAAO,6BAA6B,KAAK,MAAM,KAAK,QAAQ,UAAU,IAAI,KAAK,GAAG;AAAA,MAClF,eAAY;AAAA,MAEZ;AAAA,4BAAC,gBAAa,WAAU,qBAAoB;AAAA,QAC3C,CAAC,WAAW,oBAAC,UAAK,WAAU,oBAAoB,iBAAM;AAAA,QACtD,QAAQ,KACP,oBAAC,UAAK,WAAU,8FACb,iBACH;AAAA;AAAA;AAAA,EAEJ;AAEJ;",
+  "names": []
+}

package/dist/connection/presentation/PresentationSlot.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Where the app shell mounts the presentation module: nothing (and none of the PDF engine) until
+ * the presentation is first opened, then `ConnectedPresentation` for the rest of the page's life,
+ * so the clips survive the presentation window being closed. A failure inside it is contained
+ * here: the presentation goes, the rest of the app stays.
+ */
+export declare function PresentationSlot(): import("react").JSX.Element | null;

package/dist/connection/presentation/PresentationSlot.js

@@ -0,0 +1,35 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { lazy, Suspense, useEffect, useState } from "react";
+import { isPanelOpen, useArbiSessionState, useArbiSessionStore } from "@arbidocs/react";
+import { logger } from "@arbidocs/client";
+import { ErrorBoundary } from "../../components/ErrorBoundary.js";
+import { PRESENTATION_PANEL, presentationOpenedInThisPage } from "../../presentation/panel-id.js";
+const ConnectedPresentation = lazy(
+  () => import("./ConnectedPresentation.js").then((m) => ({ default: m.ConnectedPresentation }))
+);
+function PresentationSlot() {
+  const session = useArbiSessionStore();
+  const isOpen = useArbiSessionState((state) => isPanelOpen(state, PRESENTATION_PANEL));
+  const [mounted, setMounted] = useState(false);
+  const opened = isOpen && presentationOpenedInThisPage();
+  useEffect(() => {
+    if (opened) setMounted(true);
+    else if (isOpen) session.closePanel(PRESENTATION_PANEL);
+  }, [opened, isOpen, session]);
+  return mounted ? /* @__PURE__ */ jsx(
+    ErrorBoundary,
+    {
+      fallback: () => null,
+      onError: (error) => {
+        logger.error("The presentation failed", error);
+        session.closePanel(PRESENTATION_PANEL);
+      },
+      children: /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(ConnectedPresentation, {}) })
+    }
+  ) : null;
+}
+export {
+  PresentationSlot
+};
+//# sourceMappingURL=PresentationSlot.js.map

package/dist/connection/presentation/PresentationSlot.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/presentation/PresentationSlot.tsx"],
+  "sourcesContent": ["/**\n * Where the app shell mounts the presentation module: nothing (and none of the PDF engine) until\n * the presentation is first opened, then `ConnectedPresentation` for the rest of the page's life,\n * so the clips survive the presentation window being closed. A failure inside it is contained\n * here: the presentation goes, the rest of the app stays.\n */\n\nimport { lazy, Suspense, useEffect, useState } from 'react'\nimport { isPanelOpen, useArbiSessionState, useArbiSessionStore } from '@arbidocs/react'\nimport { logger } from '@arbidocs/client'\nimport { ErrorBoundary } from '../../components/ErrorBoundary'\nimport { PRESENTATION_PANEL, presentationOpenedInThisPage } from '../../presentation/panel-id'\n\nconst ConnectedPresentation = lazy(() =>\n  import('./ConnectedPresentation').then((m) => ({ default: m.ConnectedPresentation }))\n)\n\nexport function PresentationSlot() {\n  const session = useArbiSessionStore()\n  const isOpen = useArbiSessionState((state) => isPanelOpen(state, PRESENTATION_PANEL))\n  const [mounted, setMounted] = useState(false)\n  const opened = isOpen && presentationOpenedInThisPage()\n\n  useEffect(() => {\n    if (opened) setMounted(true)\n    // Restored open from an earlier page: there is nothing to present.\n    else if (isOpen) session.closePanel(PRESENTATION_PANEL)\n  }, [opened, isOpen, session])\n\n  return mounted ? (\n    <ErrorBoundary\n      fallback={() => null}\n      onError={(error) => {\n        logger.error('The presentation failed', error)\n        session.closePanel(PRESENTATION_PANEL)\n      }}\n    >\n      <Suspense fallback={null}>\n        <ConnectedPresentation />\n      </Suspense>\n    </ErrorBoundary>\n  ) : null\n}\n"],
+  "mappings": ";AAsCQ;AA/BR,SAAS,MAAM,UAAU,WAAW,gBAAgB;AACpD,SAAS,aAAa,qBAAqB,2BAA2B;AACtE,SAAS,cAAc;AACvB,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB,oCAAoC;AAEjE,MAAM,wBAAwB;AAAA,EAAK,MACjC,OAAO,yBAAyB,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE;AACtF;AAEO,SAAS,mBAAmB;AACjC,QAAM,UAAU,oBAAoB;AACpC,QAAM,SAAS,oBAAoB,CAAC,UAAU,YAAY,OAAO,kBAAkB,CAAC;AACpF,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAC5C,QAAM,SAAS,UAAU,6BAA6B;AAEtD,YAAU,MAAM;AACd,QAAI,OAAQ,YAAW,IAAI;AAAA,aAElB,OAAQ,SAAQ,WAAW,kBAAkB;AAAA,EACxD,GAAG,CAAC,QAAQ,QAAQ,OAAO,CAAC;AAE5B,SAAO,UACL;AAAA,IAAC;AAAA;AAAA,MACC,UAAU,MAAM;AAAA,MAChB,SAAS,CAAC,UAAU;AAClB,eAAO,MAAM,2BAA2B,KAAK;AAC7C,gBAAQ,WAAW,kBAAkB;AAAA,MACvC;AAAA,MAEA,8BAAC,YAAS,UAAU,MAClB,8BAAC,yBAAsB,GACzB;AAAA;AAAA,EACF,IACE;AACN;",
+  "names": []
+}

package/dist/connection/presentation/requests.d.ts

@@ -0,0 +1,16 @@
+import { type ArbiSessionStore } from '@arbidocs/react';
+type Session = Pick<ArbiSessionStore, 'setViewingDocument' | 'setDocumentViewer' | 'openPanel' | 'startDraftDocument'>;
+/** A presentation to edit: a new one, or a saved one (as of `version`; default its current one). */
+export type PresentationRequest = {
+    kind: 'new';
+} | {
+    kind: 'open';
+    documentId: string;
+    version?: number;
+};
+/**
+ * Edit a presentation in the viewer's slides tab: a saved one (its document, on that tab), or a
+ * new one (a presentation draft, saved into Files › Presentations when it is first saved).
+ */
+export declare function editPresentation(session: Session, request: PresentationRequest): void;
+export {};

package/dist/connection/presentation/requests.js

@@ -0,0 +1,20 @@
+"use client";
+import { DOCUMENT_VIEWER_PANEL } from "@arbidocs/react";
+import { versionRef } from "@arbidocs/react/artifacts";
+function editPresentation(session, request) {
+  if (request.kind === "new") {
+    session.startDraftDocument("presentation");
+    return;
+  }
+  const { documentId, version } = request;
+  session.setViewingDocument({
+    id: version ? versionRef(documentId, version) : documentId,
+    page: null
+  });
+  session.setDocumentViewer({ tab: "slides" });
+  session.openPanel(DOCUMENT_VIEWER_PANEL, "docked");
+}
+export {
+  editPresentation
+};
+//# sourceMappingURL=requests.js.map

package/dist/connection/presentation/requests.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/presentation/requests.ts"],
+  "sourcesContent": ["import { DOCUMENT_VIEWER_PANEL, type ArbiSessionStore } from '@arbidocs/react'\nimport { versionRef } from '@arbidocs/react/artifacts'\n\ntype Session = Pick<\n  ArbiSessionStore,\n  'setViewingDocument' | 'setDocumentViewer' | 'openPanel' | 'startDraftDocument'\n>\n\n/** A presentation to edit: a new one, or a saved one (as of `version`; default its current one). */\nexport type PresentationRequest =\n  { kind: 'new' } | { kind: 'open'; documentId: string; version?: number }\n\n/**\n * Edit a presentation in the viewer's slides tab: a saved one (its document, on that tab), or a\n * new one (a presentation draft, saved into Files \u203A Presentations when it is first saved).\n */\nexport function editPresentation(session: Session, request: PresentationRequest): void {\n  if (request.kind === 'new') {\n    session.startDraftDocument('presentation')\n    return\n  }\n  const { documentId, version } = request\n  session.setViewingDocument({\n    id: version ? versionRef(documentId, version) : documentId,\n    page: null,\n  })\n  session.setDocumentViewer({ tab: 'slides' })\n  session.openPanel(DOCUMENT_VIEWER_PANEL, 'docked')\n}\n"],
+  "mappings": ";AAAA,SAAS,6BAAoD;AAC7D,SAAS,kBAAkB;AAepB,SAAS,iBAAiB,SAAkB,SAAoC;AACrF,MAAI,QAAQ,SAAS,OAAO;AAC1B,YAAQ,mBAAmB,cAAc;AACzC;AAAA,EACF;AACA,QAAM,EAAE,YAAY,QAAQ,IAAI;AAChC,UAAQ,mBAAmB;AAAA,IACzB,IAAI,UAAU,WAAW,YAAY,OAAO,IAAI;AAAA,IAChD,MAAM;AAAA,EACR,CAAC;AACD,UAAQ,kBAAkB,EAAE,KAAK,SAAS,CAAC;AAC3C,UAAQ,UAAU,uBAAuB,QAAQ;AACnD;",
+  "names": []
+}

package/dist/connection/presentation/useImageGeneration.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate image, for a presentation: the app's own Generate image dialog (the workflow's form:
+ * prompt, source images to edit or combine, shape) launched here instead of into a chat. The run is
+ * the platform's `/image` command sent exactly as that workflow sends it (`PROMPT_BINDINGS`: the
+ * shape and source images ride structured tool arguments); like the workflow it leaves a thread
+ * and the image as a document in the workspace. The image is then added to the presentation as a
+ * clip of the whole picture.
+ */
+import type { OnWorkflowLaunch } from '../../agents/workflows/types';
+/** The Generate image dialog's launch, run for the presentation: the image becomes a clip. */
+export declare function useGenerateImageLaunch(): OnWorkflowLaunch;

package/dist/connection/presentation/useImageGeneration.js

@@ -0,0 +1,66 @@
+"use client";
+import { useCallback } from "react";
+import { useArbi, useArbiSessionState } from "@arbidocs/react";
+import { GENERATE_IMAGE_ID } from "../../agents/workflows/catalogue/seed.js";
+import { PROMPT_BINDINGS } from "../workflows/launch-bindings.js";
+import { mediaCaption } from "../../presentation/model.js";
+import { usePresentation } from "../../presentation/store.js";
+const WHOLE = { x: 0, y: 0, w: 1, h: 1 };
+async function aspectOf(blob) {
+  const bitmap = await createImageBitmap(blob);
+  const aspect = bitmap.width / bitmap.height;
+  bitmap.close();
+  return aspect;
+}
+function useGenerateImageLaunch() {
+  const arbi = useArbi();
+  const workspaceId = useArbiSessionState((s) => s.workspaceId);
+  return useCallback(
+    async ({ inputs }) => {
+      if (!arbi || !workspaceId) throw new Error("Open a workspace to generate images.");
+      const prompt = typeof inputs.prompt === "string" ? inputs.prompt.trim() : "";
+      if (!prompt) return;
+      const tools = PROMPT_BINDINGS[GENERATE_IMAGE_ID].tools?.(inputs);
+      let image;
+      let answer = "";
+      let failure = "";
+      await arbi.assistant.ask(
+        { question: `/image ${prompt}`, workspaceId, ...tools ? { tools } : {} },
+        {
+          onToken: (token) => {
+            answer += token;
+          },
+          onError: (error) => {
+            failure = error instanceof Error ? error.message : String(error);
+          },
+          onArtifact: (artifact) => {
+            if (artifact.mode === "image" && artifact.doc_ext_id) image = artifact;
+          }
+        }
+      ).catch((error) => {
+        failure ||= error instanceof Error ? error.message : String(error);
+      });
+      const documentId = image?.doc_ext_id;
+      if (!documentId)
+        throw new Error(failure || answer.trim() || "The image could not be generated.");
+      const source = await (await arbi.documents.download(documentId)).blob();
+      const fileName = `${prompt.split("\n")[0].slice(0, 60)}.png`;
+      usePresentation.getState().addClip({
+        kind: "image",
+        documentId,
+        fileName,
+        page: 1,
+        rect: WHOLE,
+        aspect: await aspectOf(source),
+        masks: [],
+        source,
+        caption: mediaCaption(fileName)
+      });
+    },
+    [arbi, workspaceId]
+  );
+}
+export {
+  useGenerateImageLaunch
+};
+//# sourceMappingURL=useImageGeneration.js.map

package/dist/connection/presentation/useImageGeneration.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/presentation/useImageGeneration.ts"],
+  "sourcesContent": ["/**\n * Generate image, for a presentation: the app's own Generate image dialog (the workflow's form:\n * prompt, source images to edit or combine, shape) launched here instead of into a chat. The run is\n * the platform's `/image` command sent exactly as that workflow sends it (`PROMPT_BINDINGS`: the\n * shape and source images ride structured tool arguments); like the workflow it leaves a thread\n * and the image as a document in the workspace. The image is then added to the presentation as a\n * clip of the whole picture.\n */\n\nimport { useCallback } from 'react'\nimport { useArbi, useArbiSessionState } from '@arbidocs/react'\nimport type { ArtifactEvent } from '@arbidocs/sdk/browser'\nimport { GENERATE_IMAGE_ID } from '../../agents/workflows/catalogue/seed'\nimport type { OnWorkflowLaunch } from '../../agents/workflows/types'\nimport { PROMPT_BINDINGS } from '../workflows/launch-bindings'\nimport { mediaCaption } from '../../presentation/model'\nimport { usePresentation } from '../../presentation/store'\n\nconst WHOLE = { x: 0, y: 0, w: 1, h: 1 }\n\n/** An image's width / height. */\nasync function aspectOf(blob: Blob): Promise<number> {\n  const bitmap = await createImageBitmap(blob)\n  const aspect = bitmap.width / bitmap.height\n  bitmap.close()\n  return aspect\n}\n\n/** The Generate image dialog's launch, run for the presentation: the image becomes a clip. */\nexport function useGenerateImageLaunch(): OnWorkflowLaunch {\n  const arbi = useArbi()\n  const workspaceId = useArbiSessionState((s) => s.workspaceId)\n\n  return useCallback(\n    async ({ inputs }) => {\n      if (!arbi || !workspaceId) throw new Error('Open a workspace to generate images.')\n      const prompt = typeof inputs.prompt === 'string' ? inputs.prompt.trim() : ''\n      if (!prompt) return\n      const tools = PROMPT_BINDINGS[GENERATE_IMAGE_ID].tools?.(inputs)\n      let image: ArtifactEvent | undefined\n      let answer = ''\n      let failure = ''\n      await arbi.assistant\n        .ask(\n          { question: `/image ${prompt}`, workspaceId, ...(tools ? { tools } : {}) },\n          {\n            onToken: (token) => {\n              answer += token\n            },\n            onError: (error) => {\n              failure = error instanceof Error ? error.message : String(error)\n            },\n            onArtifact: (artifact) => {\n              if (artifact.mode === 'image' && artifact.doc_ext_id) image = artifact\n            },\n          }\n        )\n        .catch((error: unknown) => {\n          failure ||= error instanceof Error ? error.message : String(error)\n        })\n      const documentId = image?.doc_ext_id\n      // `/image` reports a refused or failed generation as its answer text.\n      if (!documentId)\n        throw new Error(failure || answer.trim() || 'The image could not be generated.')\n      const source = await (await arbi.documents.download(documentId)).blob()\n      const fileName = `${prompt.split('\\n')[0].slice(0, 60)}.png`\n      usePresentation.getState().addClip({\n        kind: 'image',\n        documentId,\n        fileName,\n        page: 1,\n        rect: WHOLE,\n        aspect: await aspectOf(source),\n        masks: [],\n        source,\n        caption: mediaCaption(fileName),\n      })\n    },\n    [arbi, workspaceId]\n  )\n}\n"],
+  "mappings": ";AASA,SAAS,mBAAmB;AAC5B,SAAS,SAAS,2BAA2B;AAE7C,SAAS,yBAAyB;AAElC,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,SAAS,uBAAuB;AAEhC,MAAM,QAAQ,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE;AAGvC,eAAe,SAAS,MAA6B;AACnD,QAAM,SAAS,MAAM,kBAAkB,IAAI;AAC3C,QAAM,SAAS,OAAO,QAAQ,OAAO;AACrC,SAAO,MAAM;AACb,SAAO;AACT;AAGO,SAAS,yBAA2C;AACzD,QAAM,OAAO,QAAQ;AACrB,QAAM,cAAc,oBAAoB,CAAC,MAAM,EAAE,WAAW;AAE5D,SAAO;AAAA,IACL,OAAO,EAAE,OAAO,MAAM;AACpB,UAAI,CAAC,QAAQ,CAAC,YAAa,OAAM,IAAI,MAAM,sCAAsC;AACjF,YAAM,SAAS,OAAO,OAAO,WAAW,WAAW,OAAO,OAAO,KAAK,IAAI;AAC1E,UAAI,CAAC,OAAQ;AACb,YAAM,QAAQ,gBAAgB,iBAAiB,EAAE,QAAQ,MAAM;AAC/D,UAAI;AACJ,UAAI,SAAS;AACb,UAAI,UAAU;AACd,YAAM,KAAK,UACR;AAAA,QACC,EAAE,UAAU,UAAU,MAAM,IAAI,aAAa,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG;AAAA,QACzE;AAAA,UACE,SAAS,CAAC,UAAU;AAClB,sBAAU;AAAA,UACZ;AAAA,UACA,SAAS,CAAC,UAAU;AAClB,sBAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UACjE;AAAA,UACA,YAAY,CAAC,aAAa;AACxB,gBAAI,SAAS,SAAS,WAAW,SAAS,WAAY,SAAQ;AAAA,UAChE;AAAA,QACF;AAAA,MACF,EACC,MAAM,CAAC,UAAmB;AACzB,oBAAY,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MACnE,CAAC;AACH,YAAM,aAAa,OAAO;AAE1B,UAAI,CAAC;AACH,cAAM,IAAI,MAAM,WAAW,OAAO,KAAK,KAAK,mCAAmC;AACjF,YAAM,SAAS,OAAO,MAAM,KAAK,UAAU,SAAS,UAAU,GAAG,KAAK;AACtE,YAAM,WAAW,GAAG,OAAO,MAAM,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC;AACtD,sBAAgB,SAAS,EAAE,QAAQ;AAAA,QACjC,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA,MAAM;AAAA,QACN,MAAM;AAAA,QACN,QAAQ,MAAM,SAAS,MAAM;AAAA,QAC7B,OAAO,CAAC;AAAA,QACR;AAAA,QACA,SAAS,aAAa,QAAQ;AAAA,MAChC,CAAC;AAAA,IACH;AAAA,IACA,CAAC,MAAM,WAAW;AAAA,EACpB;AACF;",
+  "names": []
+}

package/dist/connection/presentation/useLabelColumns.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Labelling clips with an annotation column: an Exhibit column's "R-100" leads the label of every
+ * clip of that document ("R-100 · Statement of case · p. 3"), so a hearing bundle's numbering is on
+ * the slide. The values are read live from the documents (editing one in Files updates the slides);
+ * only the column's choice is saved with the presentation.
+ */
+export interface LabelColumn {
+    id: string;
+    name: string;
+}
+/**
+ * The workspace's columns a clip can be labelled with, and (while the presentation is open) each
+ * clip document's value in the chosen one, kept in the presentation store.
+ */
+export declare function useLabelColumns(active: boolean): LabelColumn[];

package/dist/connection/presentation/useLabelColumns.js

@@ -0,0 +1,33 @@
+"use client";
+import { useEffect, useMemo } from "react";
+import { useArbiSessionState, useDocuments, useTags } from "@arbidocs/react";
+import { usePresentation } from "../../presentation/store.js";
+const VALUE_FORMATS = /* @__PURE__ */ new Set(["text", "number", "select"]);
+function useLabelColumns(active) {
+  const workspaceId = useArbiSessionState((s) => s.workspaceId);
+  const { data: tags } = useTags(workspaceId, { enabled: active });
+  const { data: documents } = useDocuments(workspaceId, { enabled: active });
+  const labelColumn = usePresentation((s) => s.labelColumn);
+  const documentIds = usePresentation((s) => s.clips.map((clip) => clip.documentId).join(" "));
+  const columns = useMemo(
+    () => (tags ?? []).filter((tag) => tag.kind !== "search" && VALUE_FORMATS.has(tag.tag_type.type)).map((tag) => ({ id: tag.external_id, name: tag.name })).sort((a, b) => a.name.localeCompare(b.name)),
+    [tags]
+  );
+  useEffect(() => {
+    const values = {};
+    if (labelColumn) {
+      const wanted = new Set(documentIds.split(" "));
+      for (const doc of documents ?? []) {
+        if (!wanted.has(doc.external_id)) continue;
+        const note = doc.doctags?.find((dt) => dt.tag_ext_id === labelColumn)?.note?.trim();
+        if (note) values[doc.external_id] = note;
+      }
+    }
+    usePresentation.getState().setColumnValues(values);
+  }, [labelColumn, documentIds, documents]);
+  return columns;
+}
+export {
+  useLabelColumns
+};
+//# sourceMappingURL=useLabelColumns.js.map

package/dist/connection/presentation/useLabelColumns.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/presentation/useLabelColumns.ts"],
+  "sourcesContent": ["/**\n * Labelling clips with an annotation column: an Exhibit column's \"R-100\" leads the label of every\n * clip of that document (\"R-100 \u00B7 Statement of case \u00B7 p. 3\"), so a hearing bundle's numbering is on\n * the slide. The values are read live from the documents (editing one in Files updates the slides);\n * only the column's choice is saved with the presentation.\n */\n\nimport { useEffect, useMemo } from 'react'\nimport { useArbiSessionState, useDocuments, useTags } from '@arbidocs/react'\nimport { usePresentation } from '../../presentation/store'\n\n/** Column formats that hold one value per document (a checkbox only says yes or no). */\nconst VALUE_FORMATS = new Set(['text', 'number', 'select'])\n\nexport interface LabelColumn {\n  id: string\n  name: string\n}\n\n/**\n * The workspace's columns a clip can be labelled with, and (while the presentation is open) each\n * clip document's value in the chosen one, kept in the presentation store.\n */\nexport function useLabelColumns(active: boolean): LabelColumn[] {\n  const workspaceId = useArbiSessionState((s) => s.workspaceId)\n  const { data: tags } = useTags(workspaceId, { enabled: active })\n  const { data: documents } = useDocuments(workspaceId, { enabled: active })\n  const labelColumn = usePresentation((s) => s.labelColumn)\n  const documentIds = usePresentation((s) => s.clips.map((clip) => clip.documentId).join(' '))\n\n  const columns = useMemo(\n    () =>\n      (tags ?? [])\n        .filter((tag) => tag.kind !== 'search' && VALUE_FORMATS.has(tag.tag_type.type))\n        .map((tag) => ({ id: tag.external_id, name: tag.name }))\n        .sort((a, b) => a.name.localeCompare(b.name)),\n    [tags]\n  )\n\n  useEffect(() => {\n    const values: Record<string, string> = {}\n    if (labelColumn) {\n      const wanted = new Set(documentIds.split(' '))\n      for (const doc of documents ?? []) {\n        if (!wanted.has(doc.external_id)) continue\n        const note = doc.doctags?.find((dt) => dt.tag_ext_id === labelColumn)?.note?.trim()\n        if (note) values[doc.external_id] = note\n      }\n    }\n    usePresentation.getState().setColumnValues(values)\n  }, [labelColumn, documentIds, documents])\n\n  return columns\n}\n"],
+  "mappings": ";AAOA,SAAS,WAAW,eAAe;AACnC,SAAS,qBAAqB,cAAc,eAAe;AAC3D,SAAS,uBAAuB;AAGhC,MAAM,gBAAgB,oBAAI,IAAI,CAAC,QAAQ,UAAU,QAAQ,CAAC;AAWnD,SAAS,gBAAgB,QAAgC;AAC9D,QAAM,cAAc,oBAAoB,CAAC,MAAM,EAAE,WAAW;AAC5D,QAAM,EAAE,MAAM,KAAK,IAAI,QAAQ,aAAa,EAAE,SAAS,OAAO,CAAC;AAC/D,QAAM,EAAE,MAAM,UAAU,IAAI,aAAa,aAAa,EAAE,SAAS,OAAO,CAAC;AACzE,QAAM,cAAc,gBAAgB,CAAC,MAAM,EAAE,WAAW;AACxD,QAAM,cAAc,gBAAgB,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,KAAK,GAAG,CAAC;AAE3F,QAAM,UAAU;AAAA,IACd,OACG,QAAQ,CAAC,GACP,OAAO,CAAC,QAAQ,IAAI,SAAS,YAAY,cAAc,IAAI,IAAI,SAAS,IAAI,CAAC,EAC7E,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,aAAa,MAAM,IAAI,KAAK,EAAE,EACtD,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAAA,IAChD,CAAC,IAAI;AAAA,EACP;AAEA,YAAU,MAAM;AACd,UAAM,SAAiC,CAAC;AACxC,QAAI,aAAa;AACf,YAAM,SAAS,IAAI,IAAI,YAAY,MAAM,GAAG,CAAC;AAC7C,iBAAW,OAAO,aAAa,CAAC,GAAG;AACjC,YAAI,CAAC,OAAO,IAAI,IAAI,WAAW,EAAG;AAClC,cAAM,OAAO,IAAI,SAAS,KAAK,CAAC,OAAO,GAAG,eAAe,WAAW,GAAG,MAAM,KAAK;AAClF,YAAI,KAAM,QAAO,IAAI,WAAW,IAAI;AAAA,MACtC;AAAA,IACF;AACA,oBAAgB,SAAS,EAAE,gBAAgB,MAAM;AAAA,EACnD,GAAG,CAAC,aAAa,aAAa,SAAS,CAAC;AAExC,SAAO;AACT;",
+  "names": []
+}

package/dist/connection/presentation/usePresentationController.d.ts

@@ -0,0 +1,15 @@
+/**
+ * What the presentation editor gets from the session, wherever it is mounted (the viewer's slides
+ * tab, or the presentation's own window): Save, the "…" menu (Open, New from template, Save as,
+ * Save as template, Export PowerPoint, Export PDF, label column), Generate image, crop and the logo
+ * picker, and the dialogs they open (rendered by the host, in its own window).
+ */
+import { type ReactNode } from 'react';
+import type { SlidesEditorProps } from '../../presentation/SlidesEditor';
+export interface PresentationController {
+    /** The editor's session parts (the host adds its own actions and Present). */
+    editor: Omit<SlidesEditorProps, 'onPresent'>;
+    /** The dialogs, for the host to render in its window. */
+    dialogs: ReactNode;
+}
+export declare function usePresentationController(active: boolean): PresentationController;

package/dist/connection/presentation/usePresentationController.js

@@ -0,0 +1,118 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { Save } from "lucide-react";
+import { useArbiSessionStore } from "@arbidocs/react";
+import { Button, DropdownMenuItem } from "@arbidocs/react/ui";
+import { usePresentation } from "../../presentation/store.js";
+import {
+  ChooseLogoDialog,
+  GenerateImageDialog,
+  OpenPresentationDialog,
+  SavePresentationDialog
+} from "./PresentationDialogs.js";
+import { CropClipDialog } from "./CropClipDialog.js";
+import { LabelColumnMenu } from "./LabelColumnMenu.js";
+import { GenerateTile } from "./GenerateTile.js";
+import { editPresentation } from "./requests.js";
+import { useLabelColumns } from "./useLabelColumns.js";
+import { usePresentationFiles } from "./usePresentationFiles.js";
+function usePresentationController(active) {
+  const session = useArbiSessionStore();
+  const notify = usePresentation((s) => s.notify);
+  const { save, canSave } = usePresentationFiles();
+  const labelColumns = useLabelColumns(active);
+  const [dialog, setDialog] = useState(null);
+  const [reference, setReference] = useState(null);
+  const [cropping, setCropping] = useState(null);
+  const cropClip = usePresentation((s) => s.clips.find((c) => c.id === cropping) ?? null);
+  const [saving, setSaving] = useState(false);
+  const close = (open) => !open && setDialog(null);
+  const quickSave = useCallback(async () => {
+    const { savedId, title } = usePresentation.getState();
+    if (!savedId) return setDialog("save");
+    setSaving(true);
+    try {
+      await save(title);
+      notify("Presentation saved", "success");
+    } catch (error) {
+      notify(
+        error instanceof Error ? error.message : "The presentation could not be saved",
+        "error"
+      );
+    } finally {
+      setSaving(false);
+    }
+  }, [save, notify]);
+  const generate = useCallback((referenceId) => {
+    setReference(referenceId);
+    setDialog("generate");
+  }, []);
+  const saveModes = ["save", "saveAs", "export", "template"];
+  const dialogs = /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      SavePresentationDialog,
+      {
+        open: saveModes.includes(dialog),
+        mode: saveModes.includes(dialog) ? dialog : "save",
+        onOpenChange: close
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      OpenPresentationDialog,
+      {
+        open: dialog === "open" || dialog === "fromTemplate",
+        templates: dialog === "fromTemplate",
+        onOpened: (id) => editPresentation(session, id ? { kind: "open", documentId: id } : { kind: "new" }),
+        onOpenChange: close
+      }
+    ),
+    /* @__PURE__ */ jsx(ChooseLogoDialog, { open: dialog === "logo", onOpenChange: close }),
+    /* @__PURE__ */ jsx(CropClipDialog, { clip: cropClip, onOpenChange: (open) => !open && setCropping(null) }),
+    /* @__PURE__ */ jsx(
+      GenerateImageDialog,
+      {
+        open: dialog === "generate",
+        referenceId: reference,
+        onOpenChange: close
+      }
+    )
+  ] });
+  const editor = {
+    actions: canSave && /* @__PURE__ */ jsx(
+      Button,
+      {
+        type: "button",
+        size: "icon",
+        variant: "ghost",
+        className: "size-8 text-muted-foreground hover:text-foreground pointer-coarse:size-11",
+        title: "Save (in Files \u203A Presentations)",
+        "aria-label": "Save",
+        disabled: saving,
+        onClick: () => void quickSave(),
+        "data-testid": "presentation-save",
+        children: /* @__PURE__ */ jsx(Save, { className: "size-4" })
+      }
+    ),
+    menuItems: canSave && /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(DropdownMenuItem, { onSelect: () => setDialog("open"), children: "Open\u2026" }),
+      /* @__PURE__ */ jsx(DropdownMenuItem, { onSelect: () => setDialog("fromTemplate"), children: "New from template\u2026" }),
+      /* @__PURE__ */ jsx(DropdownMenuItem, { onSelect: () => setDialog("saveAs"), children: "Save as\u2026" }),
+      /* @__PURE__ */ jsx(DropdownMenuItem, { onSelect: () => setDialog("template"), children: "Save as template\u2026" }),
+      /* @__PURE__ */ jsx(DropdownMenuItem, { onSelect: () => setDialog("export"), children: "Export PDF\u2026" }),
+      /* @__PURE__ */ jsx(LabelColumnMenu, { columns: labelColumns })
+    ] }),
+    trayStart: canSave && /* @__PURE__ */ jsx(GenerateTile, { onClick: () => generate(null) }),
+    onChooseLogo: canSave ? () => setDialog("logo") : void 0,
+    onEditImage: (clipId) => {
+      const clip = usePresentation.getState().clips.find((c) => c.id === clipId);
+      if (clip) generate(clip.documentId);
+    },
+    onCropImage: setCropping
+  };
+  return { editor, dialogs };
+}
+export {
+  usePresentationController
+};
+//# sourceMappingURL=usePresentationController.js.map

package/dist/connection/presentation/usePresentationController.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/presentation/usePresentationController.tsx"],
+  "sourcesContent": ["/**\n * What the presentation editor gets from the session, wherever it is mounted (the viewer's slides\n * tab, or the presentation's own window): Save, the \"\u2026\" menu (Open, New from template, Save as,\n * Save as template, Export PowerPoint, Export PDF, label column), Generate image, crop and the logo\n * picker, and the dialogs they open (rendered by the host, in its own window).\n */\n\nimport { useCallback, useState, type ReactNode } from 'react'\nimport { Save } from 'lucide-react'\nimport { useArbiSessionStore } from '@arbidocs/react'\nimport { Button, DropdownMenuItem } from '@arbidocs/react/ui'\nimport type { SlidesEditorProps } from '../../presentation/SlidesEditor'\nimport { usePresentation } from '../../presentation/store'\nimport {\n  ChooseLogoDialog,\n  GenerateImageDialog,\n  OpenPresentationDialog,\n  SavePresentationDialog,\n  type SaveMode,\n} from './PresentationDialogs'\nimport { CropClipDialog } from './CropClipDialog'\nimport { LabelColumnMenu } from './LabelColumnMenu'\nimport { GenerateTile } from './GenerateTile'\nimport { editPresentation } from './requests'\nimport { useLabelColumns } from './useLabelColumns'\nimport { usePresentationFiles } from './usePresentationFiles'\n\ntype Dialog = SaveMode | 'open' | 'fromTemplate' | 'generate' | 'logo'\n\nexport interface PresentationController {\n  /** The editor's session parts (the host adds its own actions and Present). */\n  editor: Omit<SlidesEditorProps, 'onPresent'>\n  /** The dialogs, for the host to render in its window. */\n  dialogs: ReactNode\n}\n\nexport function usePresentationController(active: boolean): PresentationController {\n  const session = useArbiSessionStore()\n  const notify = usePresentation((s) => s.notify)\n  const { save, canSave } = usePresentationFiles()\n  const labelColumns = useLabelColumns(active)\n  const [dialog, setDialog] = useState<Dialog | null>(null)\n  const [reference, setReference] = useState<string | null>(null)\n  const [cropping, setCropping] = useState<string | null>(null)\n  const cropClip = usePresentation((s) => s.clips.find((c) => c.id === cropping) ?? null)\n  const [saving, setSaving] = useState(false)\n  const close = (open: boolean) => !open && setDialog(null)\n\n  // Saved before: save again (a new version) at once; never saved: ask for a title.\n  const quickSave = useCallback(async () => {\n    const { savedId, title } = usePresentation.getState()\n    if (!savedId) return setDialog('save')\n    setSaving(true)\n    try {\n      await save(title)\n      notify('Presentation saved', 'success')\n    } catch (error) {\n      notify(\n        error instanceof Error ? error.message : 'The presentation could not be saved',\n        'error'\n      )\n    } finally {\n      setSaving(false)\n    }\n  }, [save, notify])\n\n  const generate = useCallback((referenceId: string | null) => {\n    setReference(referenceId)\n    setDialog('generate')\n  }, [])\n\n  const saveModes: SaveMode[] = ['save', 'saveAs', 'export', 'template']\n  const dialogs = (\n    <>\n      <SavePresentationDialog\n        open={saveModes.includes(dialog as SaveMode)}\n        mode={saveModes.includes(dialog as SaveMode) ? (dialog as SaveMode) : 'save'}\n        onOpenChange={close}\n      />\n      <OpenPresentationDialog\n        open={dialog === 'open' || dialog === 'fromTemplate'}\n        templates={dialog === 'fromTemplate'}\n        // A saved one opens in the viewer's slides tab (its document); a template, as a new one.\n        onOpened={(id) =>\n          editPresentation(session, id ? { kind: 'open', documentId: id } : { kind: 'new' })\n        }\n        onOpenChange={close}\n      />\n      <ChooseLogoDialog open={dialog === 'logo'} onOpenChange={close} />\n      <CropClipDialog clip={cropClip} onOpenChange={(open) => !open && setCropping(null)} />\n      <GenerateImageDialog\n        open={dialog === 'generate'}\n        referenceId={reference}\n        onOpenChange={close}\n      />\n    </>\n  )\n\n  const editor: PresentationController['editor'] = {\n    actions: canSave && (\n      <Button\n        type=\"button\"\n        size=\"icon\"\n        variant=\"ghost\"\n        className=\"size-8 text-muted-foreground hover:text-foreground pointer-coarse:size-11\"\n        title=\"Save (in Files \u203A Presentations)\"\n        aria-label=\"Save\"\n        disabled={saving}\n        onClick={() => void quickSave()}\n        data-testid=\"presentation-save\"\n      >\n        <Save className=\"size-4\" />\n      </Button>\n    ),\n    menuItems: canSave && (\n      <>\n        <DropdownMenuItem onSelect={() => setDialog('open')}>Open\u2026</DropdownMenuItem>\n        <DropdownMenuItem onSelect={() => setDialog('fromTemplate')}>\n          New from template\u2026\n        </DropdownMenuItem>\n        <DropdownMenuItem onSelect={() => setDialog('saveAs')}>Save as\u2026</DropdownMenuItem>\n        <DropdownMenuItem onSelect={() => setDialog('template')}>\n          Save as template\u2026\n        </DropdownMenuItem>\n        <DropdownMenuItem onSelect={() => setDialog('export')}>Export PDF\u2026</DropdownMenuItem>\n        <LabelColumnMenu columns={labelColumns} />\n      </>\n    ),\n    trayStart: canSave && <GenerateTile onClick={() => generate(null)} />,\n    onChooseLogo: canSave ? () => setDialog('logo') : undefined,\n    onEditImage: (clipId) => {\n      const clip = usePresentation.getState().clips.find((c) => c.id === clipId)\n      if (clip) generate(clip.documentId)\n    },\n    onCropImage: setCropping,\n  }\n  return { editor, dialogs }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/connection/presentation/usePresentationFiles.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Saving and opening presentations as documents of the open workspace's `Presentations` folder:
+ * a PowerPoint file (`<title>.pptx`: its slides as editable PowerPoint, the presentation's own data
+ * inside it, `pptx-data`). Saving again adds a version to the same document; Export PDF saves a
+ * PDF of the slides.
+ *
+ * Opening fetches each clip's source again: the PDF the viewer shows for a page clip (so Word and
+ * text documents work too), the original file for an image or a video. A page clip's redactions
+ * are read again from the markup; a clip whose source or redactions cannot be read is left out
+ * (never shown unredacted), and how many were is reported.
+ *
+ * Presentations saved before they were PowerPoint files (a PDF with the data attached, or the data
+ * alone) still open; their first save makes a PowerPoint file of them.
+ */
+/** What opening a presentation found besides its content. */
+export interface OpenedPresentation {
+    /** Clips whose source could not be opened (left out). */
+    missing: number;
+    /** Changed outside the editor (an agent): the slides are drawn again on the next save. */
+    stale: boolean;
+    /** A PowerPoint made elsewhere, imported: what did not come across as it was. */
+    imported?: {
+        notes: string[];
+    };
+    /** Slides (1-based) changed in PowerPoint since the editor saved it, brought in. */
+    changedOutside?: number[];
+}
+export interface SavedPresentationEntry {
+    id: string;
+    title: string;
+    updatedAt: string | null;
+}
+export declare function usePresentationFiles(): {
+    save: (title: string, { asNew, template }?: {
+        asNew?: boolean;
+        template?: boolean;
+    }) => Promise<string>;
+    exportPdf: (title: string) => Promise<string>;
+    list: (scope?: "presentations" | "templates") => Promise<SavedPresentationEntry[]>;
+    open: (id: string, version?: number) => Promise<OpenedPresentation>;
+    startFromTemplate: (id: string) => Promise<void>;
+    downloadFile: (id: string) => Promise<Blob>;
+    canSave: boolean;
+};