@arbidocs/blocks 0.5.119 → 0.5.121

package/dist/connection/presentation/usePresentationFiles.js

@@ -0,0 +1,307 @@
+"use client";
+import { useCallback } from "react";
+import { useArbi, useArbiSessionState } from "@arbidocs/react";
+import { isPresentationFileName } from "@arbidocs/react/ui";
+import {
+  createMarkupStore,
+  fetchDocumentPdf,
+  imagesToPdf,
+  MarkupStoreError,
+  readPdfAttachment,
+  useDocumentTools
+} from "@arbidocs/react/document-tools";
+import {
+  EXPORTS_FOLDER,
+  PRESENTATIONS_FOLDER,
+  PRESENTATION_ATTACHMENT,
+  TEMPLATES_FOLDER,
+  parsePresentation,
+  presentationFileName,
+  presentationTitle,
+  safeFileStem,
+  serializePresentation
+} from "../../presentation/persistence.js";
+import { usePresentation } from "../../presentation/store.js";
+import { renderSlide } from "../../presentation/render-slides.js";
+import { buildPptx } from "../../presentation/export-pptx.js";
+import {
+  isZipBytes,
+  readPptxPresentationData,
+  writePptxPresentationData
+} from "../../presentation/pptx-data.js";
+import { importPptx, slideFingerprints } from "../../presentation/import-pptx.js";
+import { mergeOutsideEdits } from "../../presentation/merge-outside-edits.js";
+const PPTX_TYPE = "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+const SLIDE_PAGE = { width: 1280, height: 720 };
+function dataUrlBlob(url) {
+  const [head, body] = url.split(",", 2);
+  const type = /^data:([^;]+)/.exec(head)?.[1] ?? "application/octet-stream";
+  const binary = atob(body ?? "");
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+  return new Blob([bytes], { type });
+}
+async function presentationData(bytes) {
+  if (isZipBytes(bytes)) return readPptxPresentationData(bytes);
+  const isPdf = bytes[0] === 37 && bytes[1] === 80 && bytes[2] === 68 && bytes[3] === 70;
+  if (!isPdf) return new TextDecoder().decode(bytes);
+  const data = await readPdfAttachment(bytes, PRESENTATION_ATTACHMENT);
+  if (!data) {
+    throw new Error(
+      "This PDF has no editable presentation in it (it may have been changed outside ARBI)."
+    );
+  }
+  return new TextDecoder().decode(data);
+}
+function current(withoutClips) {
+  const state = usePresentation.getState();
+  return withoutClips ? {
+    ...state,
+    clips: [],
+    slides: state.slides.map((slide) => ({ ...slide, items: [] }))
+  } : state;
+}
+const lookOf = (state) => ({
+  labels: state.captions,
+  columnValues: state.columnValues,
+  theme: state.theme,
+  logo: state.logoImage,
+  media: state.media
+});
+function usePresentationFiles() {
+  const arbi = useArbi();
+  const { client } = useDocumentTools();
+  const workspaceId = useArbiSessionState((s) => s.workspaceId);
+  const buildFile = useCallback(async (title, withoutClips) => {
+    const state = current(withoutClips);
+    const deck = await buildPptx({ title, slides: state.slides, clips: state.clips }, lookOf(state));
+    const fingerprints = await slideFingerprints(deck);
+    const data = serializePresentation({ ...state, title, fingerprints });
+    return writePptxPresentationData(deck, JSON.stringify(data, null, 2));
+  }, []);
+  const save = useCallback(
+    async (title, { asNew = false, template = false } = {}) => {
+      if (!arbi || !workspaceId) throw new Error("Open a workspace to save the presentation.");
+      const state = usePresentation.getState();
+      const versionOf = asNew || template ? null : state.savedId;
+      const deck = await buildFile(title, template);
+      const file = new File([deck], presentationFileName(title), { type: PPTX_TYPE });
+      const result = await arbi.documents.upload([file], {
+        folder: template ? TEMPLATES_FOLDER : PRESENTATIONS_FOLDER,
+        workspaceExtId: workspaceId,
+        ...versionOf ? { versionOf } : {}
+      });
+      const id = versionOf ?? result.doc_ext_ids?.[0];
+      if (!id) throw new Error("The presentation could not be saved.");
+      if (!template) {
+        const [doc] = await arbi.documents.get([id]).catch(() => []);
+        state.setSaved(id, title, doc?.current_version ?? null);
+      }
+      return id;
+    },
+    [arbi, workspaceId, buildFile]
+  );
+  const exportPdf = useCallback(
+    async (title) => {
+      if (!arbi || !workspaceId) throw new Error("Open a workspace to export the PDF.");
+      const state = current(false);
+      const pages = [];
+      for (const slide of state.slides) {
+        const { image, text } = await renderSlide(slide, state.clips, lookOf(state));
+        pages.push({ image, text, width: SLIDE_PAGE.width, height: SLIDE_PAGE.height });
+      }
+      const pdf = await imagesToPdf(pages, { title });
+      const result = await arbi.documents.upload(
+        [new File([pdf], `${safeFileStem(title)}.pdf`, { type: "application/pdf" })],
+        { folder: EXPORTS_FOLDER, workspaceExtId: workspaceId }
+      );
+      const id = result.doc_ext_ids?.[0];
+      if (!id) throw new Error("The PDF could not be saved.");
+      return id;
+    },
+    [arbi, workspaceId]
+  );
+  const list = useCallback(
+    async (scope = "presentations") => {
+      if (!arbi || !workspaceId) return [];
+      const docs = await arbi.documents.list({ workspaceId });
+      return docs.filter((doc) => {
+        const folder = doc.folder ?? "";
+        if (!isPresentationFileName(doc.file_name, folder)) return false;
+        return scope === "templates" ? folder === TEMPLATES_FOLDER : folder.startsWith(PRESENTATIONS_FOLDER) && folder !== TEMPLATES_FOLDER && !folder.startsWith(EXPORTS_FOLDER);
+      }).map((doc) => ({
+        id: doc.external_id,
+        title: presentationTitle(doc.file_name ?? ""),
+        updatedAt: doc.updated_at ?? doc.created_at ?? null
+      })).sort((a, b) => (a.updatedAt ?? "") < (b.updatedAt ?? "") ? 1 : -1);
+    },
+    [arbi, workspaceId]
+  );
+  const readSaved = useCallback(
+    async (id, version) => {
+      if (!arbi) throw new Error("Sign in to open a presentation.");
+      const response = await arbi.documents.download(id, version);
+      const bytes = new Uint8Array(await response.arrayBuffer());
+      const text = await presentationData(bytes);
+      const [doc] = await arbi.documents.get([id]).catch(() => []);
+      const openedVersion = version ?? doc?.current_version ?? null;
+      if (text === null) {
+        const imported = await importPptx(bytes, {
+          title: presentationTitle(doc?.file_name ?? "Presentation.pptx"),
+          documentId: id,
+          version: version ?? doc?.current_version,
+          fileName: doc?.file_name ?? void 0
+        });
+        return {
+          saved: imported.saved,
+          legacy: false,
+          imported: { notes: imported.notes },
+          openedVersion
+        };
+      }
+      let saved = parsePresentation(text);
+      let changedOutside;
+      if (isZipBytes(bytes) && saved.slides.some((slide) => slide.fingerprint)) {
+        const now = await slideFingerprints(bytes);
+        const unchanged = now.length === saved.slides.length && now.every((fingerprint, i) => fingerprint === saved.slides[i].fingerprint);
+        if (!unchanged) {
+          const imported = await importPptx(bytes, {
+            title: saved.title,
+            documentId: id,
+            version: version ?? doc?.current_version,
+            fileName: doc?.file_name ?? void 0
+          });
+          const merged = mergeOutsideEdits(saved, imported.saved, now);
+          saved = merged.saved;
+          changedOutside = merged.changed;
+        }
+      }
+      return {
+        saved,
+        // Saved before presentations were PowerPoint files: its next save is a new PowerPoint
+        // file, not a version of this one (a document's versions keep one format).
+        legacy: !isZipBytes(bytes),
+        changedOutside,
+        openedVersion
+      };
+    },
+    [arbi]
+  );
+  const startFromTemplate = useCallback(
+    async (id) => {
+      const { saved } = await readSaved(id);
+      usePresentation.getState().load({
+        title: "Untitled presentation",
+        savedId: null,
+        captions: saved.captions,
+        labelColumn: saved.labelColumn ?? null,
+        theme: saved.theme,
+        clips: [],
+        slides: saved.slides.map((slide) => ({ ...slide, items: [] })),
+        media: saved.media
+      });
+    },
+    [readSaved]
+  );
+  const downloadFile = useCallback(
+    async (id) => {
+      if (!arbi) throw new Error("Sign in to read the file.");
+      return (await arbi.documents.download(id)).blob();
+    },
+    [arbi]
+  );
+  const open = useCallback(
+    async (id, version) => {
+      if (!arbi) throw new Error("Sign in to open a presentation.");
+      const { saved, legacy, imported, changedOutside, openedVersion } = await readSaved(
+        id,
+        version
+      );
+      const media = saved.media ?? {};
+      const sources = /* @__PURE__ */ new Map();
+      const sourceOf = (clip) => {
+        if (clip.media) {
+          const url = media[clip.media];
+          return url ? Promise.resolve(dataUrlBlob(url)) : Promise.reject(new Error("No image"));
+        }
+        const key = `${clip.kind === "pdf" ? "pdf" : "file"}:${clip.documentId}@${clip.version ?? ""}`;
+        let pending = sources.get(key);
+        if (!pending) {
+          pending = clip.kind === "pdf" ? fetchDocumentPdf(client, clip.documentId, { version: clip.version ?? null }) : arbi.documents.download(clip.documentId, clip.version).then((r) => r.blob());
+          sources.set(key, pending);
+        }
+        return pending;
+      };
+      const markups = /* @__PURE__ */ new Map();
+      const masksOf = (clip) => {
+        const key = `${clip.documentId}@${clip.version ?? ""}`;
+        let pending = markups.get(key);
+        if (!pending) {
+          pending = createMarkupStore({ version: clip.version, client }).load(clip.documentId).then((layer) => {
+            const byPage = /* @__PURE__ */ new Map();
+            for (const mark of layer.annotations) {
+              if (mark.kind !== "redaction" || mark.status === "rejected") continue;
+              byPage.set(mark.page, [...byPage.get(mark.page) ?? [], ...mark.rects]);
+            }
+            return byPage;
+          }).catch((error) => {
+            if (error instanceof MarkupStoreError && error.status === 404) return /* @__PURE__ */ new Map();
+            throw error;
+          });
+          markups.set(key, pending);
+        }
+        return pending;
+      };
+      const opened = await Promise.all(
+        saved.clips.map(async (clip) => {
+          try {
+            const [source, masks] = await Promise.all([
+              sourceOf(clip),
+              clip.kind === "pdf" && !clip.media ? masksOf(clip) : Promise.resolve(/* @__PURE__ */ new Map())
+            ]);
+            return { ...clip, source, masks: masks.get(clip.page) ?? [] };
+          } catch {
+            return null;
+          }
+        })
+      );
+      const kept = [];
+      const newIndex = opened.map((clip) => clip ? kept.push(clip) - 1 : -1);
+      usePresentation.getState().load({
+        title: saved.title,
+        savedId: legacy ? null : id,
+        version: legacy ? null : openedVersion,
+        boundTo: id,
+        captions: saved.captions,
+        labelColumn: saved.labelColumn ?? null,
+        theme: saved.theme,
+        clips: kept,
+        slides: saved.slides.map((slide) => ({
+          ...slide,
+          items: slide.items.filter((item) => newIndex[item.clip] >= 0).map((item) => ({ ...item, clip: newIndex[item.clip] }))
+        })),
+        media
+      });
+      return {
+        missing: opened.length - kept.length,
+        stale: saved.slidesStale === true,
+        ...imported ? { imported } : {},
+        ...changedOutside?.length ? { changedOutside } : {}
+      };
+    },
+    [arbi, client, readSaved]
+  );
+  return {
+    save,
+    exportPdf,
+    list,
+    open,
+    startFromTemplate,
+    downloadFile,
+    canSave: !!arbi && !!workspaceId
+  };
+}
+export {
+  usePresentationFiles
+};
+//# sourceMappingURL=usePresentationFiles.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/presentation/usePresentationFiles.ts"],
+  "sourcesContent": ["/**\n * Saving and opening presentations as documents of the open workspace's `Presentations` folder:\n * a PowerPoint file (`<title>.pptx`: its slides as editable PowerPoint, the presentation's own data\n * inside it, `pptx-data`). Saving again adds a version to the same document; Export PDF saves a\n * PDF of the slides.\n *\n * Opening fetches each clip's source again: the PDF the viewer shows for a page clip (so Word and\n * text documents work too), the original file for an image or a video. A page clip's redactions\n * are read again from the markup; a clip whose source or redactions cannot be read is left out\n * (never shown unredacted), and how many were is reported.\n *\n * Presentations saved before they were PowerPoint files (a PDF with the data attached, or the data\n * alone) still open; their first save makes a PowerPoint file of them.\n */\n\nimport { useCallback } from 'react'\nimport { useArbi, useArbiSessionState } from '@arbidocs/react'\nimport { isPresentationFileName } from '@arbidocs/react/ui'\nimport {\n  createMarkupStore,\n  fetchDocumentPdf,\n  imagesToPdf,\n  MarkupStoreError,\n  readPdfAttachment,\n  useDocumentTools,\n} from '@arbidocs/react/document-tools'\nimport type { Clip, Rect, Slide } from '../../presentation/model'\nimport {\n  EXPORTS_FOLDER,\n  PRESENTATIONS_FOLDER,\n  PRESENTATION_ATTACHMENT,\n  TEMPLATES_FOLDER,\n  parsePresentation,\n  presentationFileName,\n  presentationTitle,\n  safeFileStem,\n  serializePresentation,\n  type SavedClip,\n} from '../../presentation/persistence'\nimport { usePresentation } from '../../presentation/store'\nimport { renderSlide } from '../../presentation/render-slides'\nimport { buildPptx } from '../../presentation/export-pptx'\nimport {\n  isZipBytes,\n  readPptxPresentationData,\n  writePptxPresentationData,\n} from '../../presentation/pptx-data'\nimport { importPptx, slideFingerprints } from '../../presentation/import-pptx'\nimport { mergeOutsideEdits } from '../../presentation/merge-outside-edits'\nimport type { SavedPresentation } from '../../presentation/persistence'\n\nconst PPTX_TYPE = 'application/vnd.openxmlformats-officedocument.presentationml.presentation'\n\n/** A slide's page in the exported PDF, in points: 16:9. */\nconst SLIDE_PAGE = { width: 1280, height: 720 }\n\n/** An image embedded as a data URL, as a file. */\nfunction dataUrlBlob(url: string): Blob {\n  const [head, body] = url.split(',', 2)\n  const type = /^data:([^;]+)/.exec(head)?.[1] ?? 'application/octet-stream'\n  const binary = atob(body ?? '')\n  const bytes = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)\n  return new Blob([bytes], { type })\n}\n\n/** What opening a presentation found besides its content. */\nexport interface OpenedPresentation {\n  /** Clips whose source could not be opened (left out). */\n  missing: number\n  /** Changed outside the editor (an agent): the slides are drawn again on the next save. */\n  stale: boolean\n  /** A PowerPoint made elsewhere, imported: what did not come across as it was. */\n  imported?: { notes: string[] }\n  /** Slides (1-based) changed in PowerPoint since the editor saved it, brought in. */\n  changedOutside?: number[]\n}\n\n/**\n * The editable data of a saved presentation: inside its PowerPoint file; or, saved before that,\n * attached to its PDF, or the file itself.\n */\nasync function presentationData(bytes: Uint8Array): Promise<string | null> {\n  if (isZipBytes(bytes)) return readPptxPresentationData(bytes)\n  const isPdf = bytes[0] === 0x25 && bytes[1] === 0x50 && bytes[2] === 0x44 && bytes[3] === 0x46\n  if (!isPdf) return new TextDecoder().decode(bytes)\n  const data = await readPdfAttachment(bytes, PRESENTATION_ATTACHMENT)\n  if (!data) {\n    throw new Error(\n      'This PDF has no editable presentation in it (it may have been changed outside ARBI).'\n    )\n  }\n  return new TextDecoder().decode(data)\n}\n\nexport interface SavedPresentationEntry {\n  id: string\n  title: string\n  updatedAt: string | null\n}\n\n/** The presentation as it is now, or (`withoutClips`) its look and slides only: a template. */\nfunction current(withoutClips: boolean) {\n  const state = usePresentation.getState()\n  return withoutClips\n    ? {\n        ...state,\n        clips: [],\n        slides: state.slides.map((slide): Slide => ({ ...slide, items: [] })),\n      }\n    : state\n}\n\nconst lookOf = (state: ReturnType<typeof current>) => ({\n  labels: state.captions,\n  columnValues: state.columnValues,\n  theme: state.theme,\n  logo: state.logoImage,\n  media: state.media,\n})\n\nexport function usePresentationFiles() {\n  const arbi = useArbi()\n  const { client } = useDocumentTools()\n  const workspaceId = useArbiSessionState((s) => s.workspaceId)\n\n  /** The presentation as its PowerPoint file, its editable data inside. */\n  const buildFile = useCallback(async (title: string, withoutClips: boolean): Promise<Blob> => {\n    const state = current(withoutClips)\n    const deck = await buildPptx({ title, slides: state.slides, clips: state.clips }, lookOf(state))\n    // Drawn just now from the presentation itself: never stale. Each slide's fingerprint tells,\n    // when it is opened again, which slides were changed in PowerPoint meanwhile.\n    const fingerprints = await slideFingerprints(deck)\n    const data = serializePresentation({ ...state, title, fingerprints })\n    return writePptxPresentationData(deck, JSON.stringify(data, null, 2))\n  }, [])\n\n  /**\n   * Save the presentation: `<title>.pptx` in Presentations, through the ordinary upload, so it is\n   * viewed, searched and downloaded like any document (and opens in PowerPoint). A new version of\n   * the document it was saved as, or (never saved, or `asNew`: Save as) a new document named\n   * `title`; a template (its look and slides, no clips) goes to Presentations/Templates. Resolves\n   * with its id.\n   */\n  const save = useCallback(\n    async (\n      title: string,\n      { asNew = false, template = false }: { asNew?: boolean; template?: boolean } = {}\n    ): Promise<string> => {\n      if (!arbi || !workspaceId) throw new Error('Open a workspace to save the presentation.')\n      const state = usePresentation.getState()\n      // A template is always a new document; the open presentation stays what it was.\n      const versionOf = asNew || template ? null : state.savedId\n      const deck = await buildFile(title, template)\n      const file = new File([deck], presentationFileName(title), { type: PPTX_TYPE })\n      const result = await arbi.documents.upload([file], {\n        folder: template ? TEMPLATES_FOLDER : PRESENTATIONS_FOLDER,\n        workspaceExtId: workspaceId,\n        ...(versionOf ? { versionOf } : {}),\n      })\n      const id = versionOf ?? result.doc_ext_ids?.[0]\n      if (!id) throw new Error('The presentation could not be saved.')\n      if (!template) {\n        // The version just saved: a newer one (saved by ARBI, or someone else) is then told apart.\n        const [doc] = await arbi.documents.get([id]).catch(() => [])\n        state.setSaved(id, title, doc?.current_version ?? null)\n      }\n      return id\n    },\n    [arbi, workspaceId, buildFile]\n  )\n\n  /**\n   * Export the slides as a PDF named `title` (in Presentations/Exports): to send outside or file\n   * in a bundle, each slide a page as presented, redactions burnt in.\n   */\n  const exportPdf = useCallback(\n    async (title: string): Promise<string> => {\n      if (!arbi || !workspaceId) throw new Error('Open a workspace to export the PDF.')\n      const state = current(false)\n      const pages = []\n      for (const slide of state.slides) {\n        const { image, text } = await renderSlide(slide, state.clips, lookOf(state))\n        pages.push({ image, text, width: SLIDE_PAGE.width, height: SLIDE_PAGE.height })\n      }\n      const pdf = await imagesToPdf(pages, { title })\n      const result = await arbi.documents.upload(\n        [new File([pdf], `${safeFileStem(title)}.pdf`, { type: 'application/pdf' })],\n        { folder: EXPORTS_FOLDER, workspaceExtId: workspaceId }\n      )\n      const id = result.doc_ext_ids?.[0]\n      if (!id) throw new Error('The PDF could not be saved.')\n      return id\n    },\n    [arbi, workspaceId]\n  )\n\n  /** The presentations saved in the open workspace (or its templates), newest first. */\n  const list = useCallback(\n    async (\n      scope: 'presentations' | 'templates' = 'presentations'\n    ): Promise<SavedPresentationEntry[]> => {\n      if (!arbi || !workspaceId) return []\n      const docs = await arbi.documents.list({ workspaceId })\n      return docs\n        .filter((doc) => {\n          const folder = doc.folder ?? ''\n          if (!isPresentationFileName(doc.file_name, folder)) return false\n          return scope === 'templates'\n            ? folder === TEMPLATES_FOLDER\n            : folder.startsWith(PRESENTATIONS_FOLDER) &&\n                folder !== TEMPLATES_FOLDER &&\n                !folder.startsWith(EXPORTS_FOLDER)\n        })\n        .map((doc) => ({\n          id: doc.external_id,\n          title: presentationTitle(doc.file_name ?? ''),\n          updatedAt: doc.updated_at ?? doc.created_at ?? null,\n        }))\n        .sort((a, b) => ((a.updatedAt ?? '') < (b.updatedAt ?? '') ? 1 : -1))\n    },\n    [arbi, workspaceId]\n  )\n\n  /**\n   * A saved presentation's data: from its PowerPoint file (slides changed in PowerPoint since\n   * brought in), its PDF's attachment or a file saved before that; a PowerPoint made elsewhere is\n   * imported.\n   */\n  const readSaved = useCallback(\n    async (id: string, version?: number) => {\n      if (!arbi) throw new Error('Sign in to open a presentation.')\n      const response = await arbi.documents.download(id, version)\n      const bytes = new Uint8Array(await response.arrayBuffer())\n      const text = await presentationData(bytes)\n      const [doc] = await arbi.documents.get([id]).catch(() => [])\n      const openedVersion = version ?? doc?.current_version ?? null\n      if (text === null) {\n        // A PowerPoint made elsewhere: imported, the version imported pinned (what cannot be edited\n        // here is shown from that version's PDF).\n        const imported = await importPptx(bytes, {\n          title: presentationTitle(doc?.file_name ?? 'Presentation.pptx'),\n          documentId: id,\n          version: version ?? doc?.current_version,\n          fileName: doc?.file_name ?? undefined,\n        })\n        return {\n          saved: imported.saved,\n          legacy: false,\n          imported: { notes: imported.notes },\n          openedVersion,\n        }\n      }\n      let saved: SavedPresentation = parsePresentation(text)\n      let changedOutside: number[] | undefined\n      if (isZipBytes(bytes) && saved.slides.some((slide) => slide.fingerprint)) {\n        const now = await slideFingerprints(bytes)\n        const unchanged =\n          now.length === saved.slides.length &&\n          now.every((fingerprint, i) => fingerprint === saved.slides[i].fingerprint)\n        if (!unchanged) {\n          const imported = await importPptx(bytes, {\n            title: saved.title,\n            documentId: id,\n            version: version ?? doc?.current_version,\n            fileName: doc?.file_name ?? undefined,\n          })\n          const merged = mergeOutsideEdits(saved, imported.saved, now)\n          saved = merged.saved\n          changedOutside = merged.changed\n        }\n      }\n      return {\n        saved,\n        // Saved before presentations were PowerPoint files: its next save is a new PowerPoint\n        // file, not a version of this one (a document's versions keep one format).\n        legacy: !isZipBytes(bytes),\n        changedOutside,\n        openedVersion,\n      }\n    },\n    [arbi]\n  )\n\n  /** A new presentation from a template: its look and slides, without clips, unsaved. */\n  const startFromTemplate = useCallback(\n    async (id: string) => {\n      const { saved } = await readSaved(id)\n      usePresentation.getState().load({\n        title: 'Untitled presentation',\n        savedId: null,\n        captions: saved.captions,\n        labelColumn: saved.labelColumn ?? null,\n        theme: saved.theme,\n        clips: [],\n        slides: saved.slides.map((slide) => ({ ...slide, items: [] })),\n        media: saved.media,\n      })\n    },\n    [readSaved]\n  )\n\n  /** A file of the workspace (e.g. the theme's logo). */\n  const downloadFile = useCallback(\n    async (id: string): Promise<Blob> => {\n      if (!arbi) throw new Error('Sign in to read the file.')\n      return (await arbi.documents.download(id)).blob()\n    },\n    [arbi]\n  )\n\n  /**\n   * Open a saved presentation (as of `version`; default its current one) in place of this one.\n   * Resolves with how many clips were left out, and whether its slides are stale (its data was\n   * changed outside the editor: the next save draws them again).\n   */\n  const open = useCallback(\n    async (id: string, version?: number): Promise<OpenedPresentation> => {\n      if (!arbi) throw new Error('Sign in to open a presentation.')\n      const { saved, legacy, imported, changedOutside, openedVersion } = await readSaved(\n        id,\n        version\n      )\n      const media = saved.media ?? {}\n\n      // Each source fetched once, however many clips come from it.\n      const sources = new Map<string, Promise<Blob>>()\n      const sourceOf = (clip: SavedClip) => {\n        if (clip.media) {\n          const url = media[clip.media]\n          return url ? Promise.resolve(dataUrlBlob(url)) : Promise.reject(new Error('No image'))\n        }\n        const key = `${clip.kind === 'pdf' ? 'pdf' : 'file'}:${clip.documentId}@${clip.version ?? ''}`\n        let pending = sources.get(key)\n        if (!pending) {\n          pending =\n            clip.kind === 'pdf'\n              ? fetchDocumentPdf(client, clip.documentId, { version: clip.version ?? null })\n              : arbi.documents.download(clip.documentId, clip.version).then((r) => r.blob())\n          sources.set(key, pending)\n        }\n        return pending\n      }\n      // Redactions per page, read once per source version.\n      const markups = new Map<string, Promise<Map<number, Rect[]>>>()\n      const masksOf = (clip: SavedClip) => {\n        const key = `${clip.documentId}@${clip.version ?? ''}`\n        let pending = markups.get(key)\n        if (!pending) {\n          pending = createMarkupStore({ version: clip.version, client })\n            .load(clip.documentId)\n            .then((layer) => {\n              const byPage = new Map<number, Rect[]>()\n              for (const mark of layer.annotations) {\n                if (mark.kind !== 'redaction' || mark.status === 'rejected') continue\n                byPage.set(mark.page, [...(byPage.get(mark.page) ?? []), ...mark.rects])\n              }\n              return byPage\n            })\n            .catch((error: unknown) => {\n              // No markup at all is no redaction; anything else is a reason not to show it.\n              if (error instanceof MarkupStoreError && error.status === 404) return new Map()\n              throw error\n            })\n          markups.set(key, pending)\n        }\n        return pending\n      }\n\n      const opened = await Promise.all(\n        saved.clips.map(async (clip): Promise<Omit<Clip, 'id'> | null> => {\n          try {\n            const [source, masks] = await Promise.all([\n              sourceOf(clip),\n              clip.kind === 'pdf' && !clip.media\n                ? masksOf(clip)\n                : Promise.resolve(new Map<number, Rect[]>()),\n            ])\n            return { ...clip, source, masks: masks.get(clip.page) ?? [] }\n          } catch {\n            return null\n          }\n        })\n      )\n      // Keep slide items pointing at the right clips once the missing ones are dropped.\n      const kept: Omit<Clip, 'id'>[] = []\n      const newIndex = opened.map((clip) => (clip ? kept.push(clip) - 1 : -1))\n      usePresentation.getState().load({\n        title: saved.title,\n        savedId: legacy ? null : id,\n        version: legacy ? null : openedVersion,\n        boundTo: id,\n        captions: saved.captions,\n        labelColumn: saved.labelColumn ?? null,\n        theme: saved.theme,\n        clips: kept,\n        slides: saved.slides.map((slide) => ({\n          ...slide,\n          items: slide.items\n            .filter((item) => newIndex[item.clip] >= 0)\n            .map((item) => ({ ...item, clip: newIndex[item.clip] })),\n        })),\n        media,\n      })\n      return {\n        missing: opened.length - kept.length,\n        stale: saved.slidesStale === true,\n        ...(imported ? { imported } : {}),\n        ...(changedOutside?.length ? { changedOutside } : {}),\n      }\n    },\n    [arbi, client, readSaved]\n  )\n\n  return {\n    save,\n    exportPdf,\n    list,\n    open,\n    startFromTemplate,\n    downloadFile,\n    canSave: !!arbi && !!workspaceId,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,14 @@
+/**
+ * The document viewer's Clip mode: whether it is on, and its header controls. Clips made in it
+ * join the presentation's tray (a presentation being made, or one started from them); it stays on
+ * from one document to the next, so clips are gathered from several documents in a row. Beside it,
+ * the Presentation pill goes back to arrange them.
+ */
+import { type ReactNode } from 'react';
+export declare function useViewerClipping(
+/** A PDF, an image or a video is on screen. Clip mode shows over the viewer's other modes. */
+clippable: boolean, compact: boolean): {
+    clipping: boolean;
+    stop: () => void;
+    button: ReactNode;
+};

package/dist/connection/presentation/useViewerClipping.js

@@ -0,0 +1,18 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { ClipButton } from "../../document-tools/DocumentToolButtons.js";
+import { PresentationPill } from "./PresentationPill.js";
+function useViewerClipping(clippable, compact) {
+  const [on, setOn] = useState(false);
+  const stop = useCallback(() => setOn(false), []);
+  const button = /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(PresentationPill, { compact }),
+    clippable && /* @__PURE__ */ jsx(ClipButton, { active: on, compact, onClick: () => setOn(!on) })
+  ] });
+  return { clipping: on && clippable, stop, button };
+}
+export {
+  useViewerClipping
+};
+//# sourceMappingURL=useViewerClipping.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/presentation/useViewerClipping.tsx"],
+  "sourcesContent": ["/**\n * The document viewer's Clip mode: whether it is on, and its header controls. Clips made in it\n * join the presentation's tray (a presentation being made, or one started from them); it stays on\n * from one document to the next, so clips are gathered from several documents in a row. Beside it,\n * the Presentation pill goes back to arrange them.\n */\n\nimport { useCallback, useState, type ReactNode } from 'react'\nimport { ClipButton } from '../../document-tools/DocumentToolButtons'\nimport { PresentationPill } from './PresentationPill'\n\nexport function useViewerClipping(\n  /** A PDF, an image or a video is on screen. Clip mode shows over the viewer's other modes. */\n  clippable: boolean,\n  compact: boolean\n): { clipping: boolean; stop: () => void; button: ReactNode } {\n  const [on, setOn] = useState(false)\n  const stop = useCallback(() => setOn(false), [])\n  const button = (\n    <>\n      <PresentationPill compact={compact} />\n      {clippable && <ClipButton active={on} compact={compact} onClick={() => setOn(!on)} />}\n    </>\n  )\n  return { clipping: on && clippable, stop, button }\n}\n"],
+  "mappings": ";AAmBI,mBACE,KADF;AAZJ,SAAS,aAAa,gBAAgC;AACtD,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB;AAE1B,SAAS,kBAEd,WACA,SAC4D;AAC5D,QAAM,CAAC,IAAI,KAAK,IAAI,SAAS,KAAK;AAClC,QAAM,OAAO,YAAY,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC;AAC/C,QAAM,SACJ,iCACE;AAAA,wBAAC,oBAAiB,SAAkB;AAAA,IACnC,aAAa,oBAAC,cAAW,QAAQ,IAAI,SAAkB,SAAS,MAAM,MAAM,CAAC,EAAE,GAAG;AAAA,KACrF;AAEF,SAAO,EAAE,UAAU,MAAM,WAAW,MAAM,OAAO;AACnD;",
+  "names": []
+}

package/dist/connection/sharing/WorkspaceMembersList.d.ts

@@ -0,0 +1,4 @@
+/** The workspace's members with their role; mounted only while a card is open, so read on first hover. */
+export declare function WorkspaceMembersList({ workspaceId }: {
+    workspaceId?: string | null;
+}): import("react").JSX.Element;

package/dist/connection/sharing/WorkspaceMembersList.js

@@ -0,0 +1,34 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useWorkspaceUsers } from "@arbidocs/react";
+import { formatRole } from "../../workspaces/workspace-roles.js";
+const ROLE_ORDER = { owner: 0, collaborator: 1, guest: 2 };
+function memberName(member) {
+  const { given_name, family_name, email } = member.user;
+  return [given_name, family_name].filter(Boolean).join(" ") || email;
+}
+function sortMembers(members) {
+  return [...members].sort(
+    (a, b) => (ROLE_ORDER[a.role] ?? 3) - (ROLE_ORDER[b.role] ?? 3) || memberName(a).localeCompare(memberName(b))
+  );
+}
+function WorkspaceMembersList({ workspaceId }) {
+  const { data, isLoading, isError } = useWorkspaceUsers(workspaceId);
+  if (isLoading) return /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: "Loading members\u2026" });
+  if (isError || !data) return /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: "Members unavailable" });
+  return /* @__PURE__ */ jsx("ul", { className: "max-h-60 space-y-1.5 overflow-y-auto", "data-testid": "sharing-members", children: sortMembers(data).map((m) => /* @__PURE__ */ jsxs("li", { className: "flex items-center justify-between gap-3 text-xs", children: [
+    /* @__PURE__ */ jsx("span", { className: "truncate", title: m.user.email, children: memberName(m) }),
+    /* @__PURE__ */ jsx(
+      "span",
+      {
+        className: "shrink-0 rounded bg-muted px-1.5 py-0.5 text-muted-foreground",
+        "data-role": m.role,
+        children: formatRole(m.role)
+      }
+    )
+  ] }, m.user.external_id)) });
+}
+export {
+  WorkspaceMembersList
+};
+//# sourceMappingURL=WorkspaceMembersList.js.map

package/dist/connection/sharing/WorkspaceMembersList.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/sharing/WorkspaceMembersList.tsx"],
+  "sourcesContent": ["import { useWorkspaceUsers, type WorkspaceMember } from '@arbidocs/react'\nimport { formatRole } from '../../workspaces/workspace-roles'\n\nconst ROLE_ORDER: Record<string, number> = { owner: 0, collaborator: 1, guest: 2 }\n\nfunction memberName(member: WorkspaceMember): string {\n  const { given_name, family_name, email } = member.user\n  return [given_name, family_name].filter(Boolean).join(' ') || email\n}\n\n/** Owners first, then collaborators, then read-only members; alphabetical within a role. */\nfunction sortMembers(members: readonly WorkspaceMember[]): WorkspaceMember[] {\n  return [...members].sort(\n    (a, b) =>\n      (ROLE_ORDER[a.role] ?? 3) - (ROLE_ORDER[b.role] ?? 3) ||\n      memberName(a).localeCompare(memberName(b))\n  )\n}\n\n/** The workspace's members with their role; mounted only while a card is open, so read on first hover. */\nexport function WorkspaceMembersList({ workspaceId }: { workspaceId?: string | null }) {\n  const { data, isLoading, isError } = useWorkspaceUsers(workspaceId)\n  if (isLoading) return <p className=\"text-xs text-muted-foreground\">Loading members\u2026</p>\n  if (isError || !data) return <p className=\"text-xs text-muted-foreground\">Members unavailable</p>\n  return (\n    <ul className=\"max-h-60 space-y-1.5 overflow-y-auto\" data-testid=\"sharing-members\">\n      {sortMembers(data).map((m) => (\n        <li key={m.user.external_id} className=\"flex items-center justify-between gap-3 text-xs\">\n          <span className=\"truncate\" title={m.user.email}>\n            {memberName(m)}\n          </span>\n          <span\n            className=\"shrink-0 rounded bg-muted px-1.5 py-0.5 text-muted-foreground\"\n            data-role={m.role}\n          >\n            {formatRole(m.role)}\n          </span>\n        </li>\n      ))}\n    </ul>\n  )\n}\n"],
+  "mappings": ";AAsBwB,cAKhB,YALgB;AAtBxB,SAAS,yBAA+C;AACxD,SAAS,kBAAkB;AAE3B,MAAM,aAAqC,EAAE,OAAO,GAAG,cAAc,GAAG,OAAO,EAAE;AAEjF,SAAS,WAAW,QAAiC;AACnD,QAAM,EAAE,YAAY,aAAa,MAAM,IAAI,OAAO;AAClD,SAAO,CAAC,YAAY,WAAW,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,KAAK;AAChE;AAGA,SAAS,YAAY,SAAwD;AAC3E,SAAO,CAAC,GAAG,OAAO,EAAE;AAAA,IAClB,CAAC,GAAG,OACD,WAAW,EAAE,IAAI,KAAK,MAAM,WAAW,EAAE,IAAI,KAAK,MACnD,WAAW,CAAC,EAAE,cAAc,WAAW,CAAC,CAAC;AAAA,EAC7C;AACF;AAGO,SAAS,qBAAqB,EAAE,YAAY,GAAoC;AACrF,QAAM,EAAE,MAAM,WAAW,QAAQ,IAAI,kBAAkB,WAAW;AAClE,MAAI,UAAW,QAAO,oBAAC,OAAE,WAAU,iCAAgC,mCAAgB;AACnF,MAAI,WAAW,CAAC,KAAM,QAAO,oBAAC,OAAE,WAAU,iCAAgC,iCAAmB;AAC7F,SACE,oBAAC,QAAG,WAAU,wCAAuC,eAAY,mBAC9D,sBAAY,IAAI,EAAE,IAAI,CAAC,MACtB,qBAAC,QAA4B,WAAU,mDACrC;AAAA,wBAAC,UAAK,WAAU,YAAW,OAAO,EAAE,KAAK,OACtC,qBAAW,CAAC,GACf;AAAA,IACA;AAAA,MAAC;AAAA;AAAA,QACC,WAAU;AAAA,QACV,aAAW,EAAE;AAAA,QAEZ,qBAAW,EAAE,IAAI;AAAA;AAAA,IACpB;AAAA,OATO,EAAE,KAAK,WAUhB,CACD,GACH;AAEJ;",
+  "names": []
+}

package/dist/connection/shell/ConnectedAppShell.js

@@ -2,6 +2,8 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useEffect } from "react";
 import { useArbiSessionState, useArbiSessionStore } from "@arbidocs/react";
+import { configureSharingMembers } from "@arbidocs/react/ui";
+import { WorkspaceMembersList } from "../sharing/WorkspaceMembersList.js";
 import { DockZone } from "../../shell/DockZone.js";
 import {
   PageContainer,
@@ -20,12 +22,14 @@ import {
   RoutedShellTopbar
 } from "./RoutedShellChrome.js";
 import { ShellNavigationProvider } from "./ShellNavigationProvider.js";
+import { PresentationSlot } from "../presentation/PresentationSlot.js";
 import { useShellNavigation } from "./shell-navigation.js";
 const ROUTED_PAGE_INSET = "pt-4 sm:pt-6";
 function PaletteSlot({ palette }) {
   const visibleItems = useShellNavigation()?.visibleItems ?? [];
   return /* @__PURE__ */ jsx(Fragment, { children: typeof palette === "function" ? palette(visibleItems) : palette });
 }
+const SHARING_MEMBERS = /* @__PURE__ */ jsx(WorkspaceMembersList, {});
 function ConnectedAppShell({
   banner,
   topbar,
@@ -51,6 +55,7 @@ function ConnectedAppShell({
   tools,
   ...rootProps
 }) {
+  configureSharingMembers(SHARING_MEMBERS);
   const session = useArbiSessionStore();
   const dockedPanel = useArbiSessionState((state) => state.shell.panels.docked);
   const dockSqueezed = useMediaQuery(sidebarPolicy?.dockedRailQuery ?? "(max-width: 0px)");
@@ -105,7 +110,10 @@ function ConnectedAppShell({
       )
     }
   );
-  return /* @__PURE__ */ jsx(AppShellContext.Provider, { value: controller, children: navigation ? /* @__PURE__ */ jsx(ShellNavigationProvider, { navigation, children: root }) : root });
+  return /* @__PURE__ */ jsxs(AppShellContext.Provider, { value: controller, children: [
+    navigation ? /* @__PURE__ */ jsx(ShellNavigationProvider, { navigation, children: root }) : root,
+    /* @__PURE__ */ jsx(PresentationSlot, {})
+  ] });
 }
 export {
   ConnectedAppShell

package/dist/connection/shell/ConnectedAppShell.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/connection/shell/ConnectedAppShell.tsx"],
-  "sourcesContent": ["import { useEffect, type ReactNode } from 'react'\nimport { useArbiSessionState, useArbiSessionStore } from '@arbidocs/react'\nimport { DockZone } from '../../shell/DockZone'\nimport {\n  PageContainer,\n  Shell,\n  type PageContainerProps,\n  type ShellContentProps,\n  type ShellRootProps,\n} from '../../shell/Shell'\nimport {\n  useSidebarController,\n  type UseSidebarControllerOptions,\n} from '../../shell/use-sidebar-controller'\nimport { useMediaQuery } from '../../lib/use-media-query'\nimport { useSessionSidebar } from '../useSessionSidebar'\nimport { AppShellContext, type AppShellController } from './app-shell-controller'\nimport {\n  RoutedShellDock,\n  RoutedShellSidebar,\n  RoutedShellTabBar,\n  RoutedShellTopbar,\n  type RoutedShellChromeProps,\n} from './RoutedShellChrome'\nimport { ShellNavigationProvider } from './ShellNavigationProvider'\nimport type { AppNavItem } from '../../nav/types'\nimport { useShellNavigation, type ShellNavigation } from './shell-navigation'\n\ntype ShellSlot = ReactNode | ((controller: AppShellController) => ReactNode)\n\n/**\n * A routed page's top inset when the host sets no `page.innerClassName`: a page that opens with\n * its title (`PageHeader`) clears the top edge. The registry shell (no `navigation`) has none.\n */\nconst ROUTED_PAGE_INSET = 'pt-4 sm:pt-6'\ntype ShellRegions = 'banner' | 'topbar' | 'sidebar' | 'tabBar' | 'aside' | 'overlays'\n\n/**\n * A routed host's chrome as configuration: `navigation` (`defineNavigation`) and the routed props.\n * The shell draws the sidebar's sections, the phone app bar, drawer and tab bar, and the assistant\n * dock from them. The current row comes from the environment's `useLocation`; choosing a row is a\n * real link through its `navigate`. A region still given as a slot replaces only that part.\n */\nexport interface RoutedShellProps extends RoutedShellChromeProps {\n  navigation: ShellNavigation\n}\n\n/** Without `navigation` every region is a slot, and the routed props do not apply. */\ntype SlotShellProps = { navigation?: undefined } & {\n  [K in keyof RoutedShellChromeProps]?: never\n}\n\ninterface ConnectedAppShellBaseProps extends Omit<ShellRootProps, ShellRegions | 'children'> {\n  /**\n   * The command palette, mounted once inside the shell (`ConnectedCommandPalette`). A function\n   * gets a routed shell's visible destinations (gates applied), so a hidden row never shows there.\n   */\n  palette?: ReactNode | ((navigation: readonly AppNavItem[]) => ReactNode)\n  banner?: ShellSlot\n  topbar?: ShellSlot\n  sidebar?: ShellSlot\n  tabBar?: ShellSlot\n  aside?: ShellSlot\n  overlays?: ShellSlot\n  children: ReactNode\n  /** The host's navigation identity. A change closes the phone drawer, without changing scroll. */\n  navigationKey?: string\n  sidebarPolicy?: Pick<UseSidebarControllerOptions, 'hoverExpansion'> & {\n    /** A docked panel squeezes this host's sidebar into a rail below this media query. */\n    dockedRailQuery?: string\n  }\n  /** Page layout only; routes, permissions and whether a main panel is visible belong to the host. */\n  content?:\n    | { mode: 'routed' }\n    | { mode: 'docked'; mainPanelVisible: boolean; mainZoneId?: string; testId?: string }\n  /**\n   * The page column. With `navigation` it has a top inset (`pt-4 sm:pt-6`), skipped only when the\n   * host sets `innerClassName` (then the host's classes are the column's); `maxWidth`, `padding` and\n   * `wide` alone keep it.\n   */\n  page?: Omit<PageContainerProps, 'children'>\n  /** Clicking the content also selects the session's main focus area (away from any panel). */\n  contentProps?: Omit<ShellContentProps, 'children'>\n}\n\nexport type ConnectedAppShellProps = ConnectedAppShellBaseProps &\n  (RoutedShellProps | SlotShellProps)\n\n/** The palette slot; a function gets the routed shell's visible destinations. */\nfunction PaletteSlot({ palette }: { palette: NonNullable<ConnectedAppShellProps['palette']> }) {\n  const visibleItems = useShellNavigation()?.visibleItems ?? []\n  return <>{typeof palette === 'function' ? palette(visibleItems) : palette}</>\n}\n\n/**\n * Session-backed application frame. Routing stays in the host, which gives its chrome as region\n * slots or, for a routed custom site, as `navigation` and the routed props; the frame\n * shares its sidebar controller and assembles routed pages or persistent page/main-panel zones.\n * It never resets scroll: a host's page navigation and restored thread position remain distinct.\n */\nexport function ConnectedAppShell({\n  banner,\n  topbar,\n  sidebar: sidebarSlot,\n  tabBar,\n  aside,\n  overlays,\n  children,\n  navigationKey,\n  sidebarPolicy,\n  content = { mode: 'routed' },\n  page,\n  contentProps,\n  navigation,\n  palette,\n  brand,\n  account,\n  ask,\n  dock,\n  switcher,\n  tabBarIds,\n  tabBarLabel,\n  tools,\n  ...rootProps\n}: ConnectedAppShellProps) {\n  const session = useArbiSessionStore()\n  const dockedPanel = useArbiSessionState((state) => state.shell.panels.docked)\n  const dockSqueezed = useMediaQuery(sidebarPolicy?.dockedRailQuery ?? '(max-width: 0px)')\n  const sidebar = useSidebarController({\n    ...useSessionSidebar(),\n    forceRail: !!sidebarPolicy?.dockedRailQuery && dockSqueezed && dockedPanel !== null,\n    hoverExpansion: sidebarPolicy?.hoverExpansion,\n  })\n  const { closeDrawer } = sidebar\n  useEffect(() => {\n    if (navigationKey !== undefined) closeDrawer()\n  }, [navigationKey, closeDrawer])\n\n  const controller = { sidebar }\n  const renderSlot = (slot: ShellSlot) => (typeof slot === 'function' ? slot(controller) : slot)\n  // A routed page clears the top edge. Only the host's own `page.innerClassName` replaces the inset\n  // (its whole column classes); other `page` props (`maxWidth`, `padding`, `wide`) keep it.\n  const pageProps =\n    navigation && page?.innerClassName === undefined\n      ? { ...page, innerClassName: ROUTED_PAGE_INSET }\n      : page\n  const pageContent = <PageContainer {...pageProps}>{children}</PageContainer>\n  const chrome = { brand: brand!, account, ask, dock, switcher, tools }\n  // A routed host's chrome from its navigation; any region it gives as a slot wins.\n  const region = (slot: ShellSlot, routed: ReactNode) =>\n    slot === undefined && navigation ? routed : renderSlot(slot)\n  const overlayContent = renderSlot(overlays)\n\n  const root = (\n    <Shell.Root\n      {...rootProps}\n      banner={renderSlot(banner)}\n      topbar={region(topbar, <RoutedShellTopbar {...chrome} />)}\n      sidebar={region(sidebarSlot, <RoutedShellSidebar {...chrome} />)}\n      tabBar={region(tabBar, <RoutedShellTabBar tabBarIds={tabBarIds} tabBarLabel={tabBarLabel} />)}\n      aside={region(aside, <RoutedShellDock dock={dock} />)}\n      overlays={\n        palette ? (\n          <>\n            {overlayContent}\n            <PaletteSlot palette={palette} />\n          </>\n        ) : (\n          overlayContent\n        )\n      }\n    >\n      <Shell.Content\n        {...contentProps}\n        onClick={(event) => {\n          session.setFocusedArea('main')\n          contentProps?.onClick?.(event)\n        }}\n      >\n        {content.mode === 'docked' ? (\n          <DockZone data-testid={content.testId}>\n            {/* Keep the page mounted beneath a replacing panel, including drafts and scroll.\n                  The definite height chain also keeps sticky page footers inside the scroller. */}\n            <div className={content.mainPanelVisible ? 'hidden' : 'h-full min-h-0'}>\n              {pageContent}\n            </div>\n            <div\n              id={content.mainZoneId ?? 'main-zone'}\n              className={content.mainPanelVisible ? 'h-full' : 'hidden'}\n            />\n          </DockZone>\n        ) : (\n          pageContent\n        )}\n      </Shell.Content>\n    </Shell.Root>\n  )\n\n  return (\n    <AppShellContext.Provider value={controller}>\n      {navigation ? (\n        <ShellNavigationProvider navigation={navigation}>{root}</ShellNavigationProvider>\n      ) : (\n        root\n      )}\n    </AppShellContext.Provider>\n  )\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { useEffect, type ReactNode } from 'react'\nimport { useArbiSessionState, useArbiSessionStore } from '@arbidocs/react'\nimport { configureSharingMembers } from '@arbidocs/react/ui'\nimport { WorkspaceMembersList } from '../sharing/WorkspaceMembersList'\nimport { DockZone } from '../../shell/DockZone'\nimport {\n  PageContainer,\n  Shell,\n  type PageContainerProps,\n  type ShellContentProps,\n  type ShellRootProps,\n} from '../../shell/Shell'\nimport {\n  useSidebarController,\n  type UseSidebarControllerOptions,\n} from '../../shell/use-sidebar-controller'\nimport { useMediaQuery } from '../../lib/use-media-query'\nimport { useSessionSidebar } from '../useSessionSidebar'\nimport { AppShellContext, type AppShellController } from './app-shell-controller'\nimport {\n  RoutedShellDock,\n  RoutedShellSidebar,\n  RoutedShellTabBar,\n  RoutedShellTopbar,\n  type RoutedShellChromeProps,\n} from './RoutedShellChrome'\nimport { ShellNavigationProvider } from './ShellNavigationProvider'\nimport { PresentationSlot } from '../presentation/PresentationSlot'\nimport type { AppNavItem } from '../../nav/types'\nimport { useShellNavigation, type ShellNavigation } from './shell-navigation'\n\ntype ShellSlot = ReactNode | ((controller: AppShellController) => ReactNode)\n\n/**\n * A routed page's top inset when the host sets no `page.innerClassName`: a page that opens with\n * its title (`PageHeader`) clears the top edge. The registry shell (no `navigation`) has none.\n */\nconst ROUTED_PAGE_INSET = 'pt-4 sm:pt-6'\ntype ShellRegions = 'banner' | 'topbar' | 'sidebar' | 'tabBar' | 'aside' | 'overlays'\n\n/**\n * A routed host's chrome as configuration: `navigation` (`defineNavigation`) and the routed props.\n * The shell draws the sidebar's sections, the phone app bar, drawer and tab bar, and the assistant\n * dock from them. The current row comes from the environment's `useLocation`; choosing a row is a\n * real link through its `navigate`. A region still given as a slot replaces only that part.\n */\nexport interface RoutedShellProps extends RoutedShellChromeProps {\n  navigation: ShellNavigation\n}\n\n/** Without `navigation` every region is a slot, and the routed props do not apply. */\ntype SlotShellProps = { navigation?: undefined } & {\n  [K in keyof RoutedShellChromeProps]?: never\n}\n\ninterface ConnectedAppShellBaseProps extends Omit<ShellRootProps, ShellRegions | 'children'> {\n  /**\n   * The command palette, mounted once inside the shell (`ConnectedCommandPalette`). A function\n   * gets a routed shell's visible destinations (gates applied), so a hidden row never shows there.\n   */\n  palette?: ReactNode | ((navigation: readonly AppNavItem[]) => ReactNode)\n  banner?: ShellSlot\n  topbar?: ShellSlot\n  sidebar?: ShellSlot\n  tabBar?: ShellSlot\n  aside?: ShellSlot\n  overlays?: ShellSlot\n  children: ReactNode\n  /** The host's navigation identity. A change closes the phone drawer, without changing scroll. */\n  navigationKey?: string\n  sidebarPolicy?: Pick<UseSidebarControllerOptions, 'hoverExpansion'> & {\n    /** A docked panel squeezes this host's sidebar into a rail below this media query. */\n    dockedRailQuery?: string\n  }\n  /** Page layout only; routes, permissions and whether a main panel is visible belong to the host. */\n  content?:\n    | { mode: 'routed' }\n    | { mode: 'docked'; mainPanelVisible: boolean; mainZoneId?: string; testId?: string }\n  /**\n   * The page column. With `navigation` it has a top inset (`pt-4 sm:pt-6`), skipped only when the\n   * host sets `innerClassName` (then the host's classes are the column's); `maxWidth`, `padding` and\n   * `wide` alone keep it.\n   */\n  page?: Omit<PageContainerProps, 'children'>\n  /** Clicking the content also selects the session's main focus area (away from any panel). */\n  contentProps?: Omit<ShellContentProps, 'children'>\n}\n\nexport type ConnectedAppShellProps = ConnectedAppShellBaseProps &\n  (RoutedShellProps | SlotShellProps)\n\n/** The palette slot; a function gets the routed shell's visible destinations. */\nfunction PaletteSlot({ palette }: { palette: NonNullable<ConnectedAppShellProps['palette']> }) {\n  const visibleItems = useShellNavigation()?.visibleItems ?? []\n  return <>{typeof palette === 'function' ? palette(visibleItems) : palette}</>\n}\n\nconst SHARING_MEMBERS = <WorkspaceMembersList />\n\n/**\n * Session-backed application frame. Routing stays in the host, which gives its chrome as region\n * slots or, for a routed custom site, as `navigation` and the routed props; the frame\n * shares its sidebar controller and assembles routed pages or persistent page/main-panel zones.\n * It never resets scroll: a host's page navigation and restored thread position remain distinct.\n */\nexport function ConnectedAppShell({\n  banner,\n  topbar,\n  sidebar: sidebarSlot,\n  tabBar,\n  aside,\n  overlays,\n  children,\n  navigationKey,\n  sidebarPolicy,\n  content = { mode: 'routed' },\n  page,\n  contentProps,\n  navigation,\n  palette,\n  brand,\n  account,\n  ask,\n  dock,\n  switcher,\n  tabBarIds,\n  tabBarLabel,\n  tools,\n  ...rootProps\n}: ConnectedAppShellProps) {\n  // Every sharing pill (also in panels portalled out of this tree) lists the workspace's members.\n  configureSharingMembers(SHARING_MEMBERS)\n  const session = useArbiSessionStore()\n  const dockedPanel = useArbiSessionState((state) => state.shell.panels.docked)\n  const dockSqueezed = useMediaQuery(sidebarPolicy?.dockedRailQuery ?? '(max-width: 0px)')\n  const sidebar = useSidebarController({\n    ...useSessionSidebar(),\n    forceRail: !!sidebarPolicy?.dockedRailQuery && dockSqueezed && dockedPanel !== null,\n    hoverExpansion: sidebarPolicy?.hoverExpansion,\n  })\n  const { closeDrawer } = sidebar\n  useEffect(() => {\n    if (navigationKey !== undefined) closeDrawer()\n  }, [navigationKey, closeDrawer])\n\n  const controller = { sidebar }\n  const renderSlot = (slot: ShellSlot) => (typeof slot === 'function' ? slot(controller) : slot)\n  // A routed page clears the top edge. Only the host's own `page.innerClassName` replaces the inset\n  // (its whole column classes); other `page` props (`maxWidth`, `padding`, `wide`) keep it.\n  const pageProps =\n    navigation && page?.innerClassName === undefined\n      ? { ...page, innerClassName: ROUTED_PAGE_INSET }\n      : page\n  const pageContent = <PageContainer {...pageProps}>{children}</PageContainer>\n  const chrome = { brand: brand!, account, ask, dock, switcher, tools }\n  // A routed host's chrome from its navigation; any region it gives as a slot wins.\n  const region = (slot: ShellSlot, routed: ReactNode) =>\n    slot === undefined && navigation ? routed : renderSlot(slot)\n  const overlayContent = renderSlot(overlays)\n\n  const root = (\n    <Shell.Root\n      {...rootProps}\n      banner={renderSlot(banner)}\n      topbar={region(topbar, <RoutedShellTopbar {...chrome} />)}\n      sidebar={region(sidebarSlot, <RoutedShellSidebar {...chrome} />)}\n      tabBar={region(tabBar, <RoutedShellTabBar tabBarIds={tabBarIds} tabBarLabel={tabBarLabel} />)}\n      aside={region(aside, <RoutedShellDock dock={dock} />)}\n      overlays={\n        palette ? (\n          <>\n            {overlayContent}\n            <PaletteSlot palette={palette} />\n          </>\n        ) : (\n          overlayContent\n        )\n      }\n    >\n      <Shell.Content\n        {...contentProps}\n        onClick={(event) => {\n          session.setFocusedArea('main')\n          contentProps?.onClick?.(event)\n        }}\n      >\n        {content.mode === 'docked' ? (\n          <DockZone data-testid={content.testId}>\n            {/* Keep the page mounted beneath a replacing panel, including drafts and scroll.\n                  The definite height chain also keeps sticky page footers inside the scroller. */}\n            <div className={content.mainPanelVisible ? 'hidden' : 'h-full min-h-0'}>\n              {pageContent}\n            </div>\n            <div\n              id={content.mainZoneId ?? 'main-zone'}\n              className={content.mainPanelVisible ? 'h-full' : 'hidden'}\n            />\n          </DockZone>\n        ) : (\n          pageContent\n        )}\n      </Shell.Content>\n    </Shell.Root>\n  )\n\n  return (\n    <AppShellContext.Provider value={controller}>\n      {navigation ? (\n        <ShellNavigationProvider navigation={navigation}>{root}</ShellNavigationProvider>\n      ) : (\n        root\n      )}\n      {/* The presentation module (presenter panel, stage window), once a presentation opens. */}\n      <PresentationSlot />\n    </AppShellContext.Provider>\n  )\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/connection/viewer/CleanViewControl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Over the viewer's clean view: Full screen, and Show controls (leave the clean view). It shows
+ * while the pointer moves or a key is pressed and fades after a moment, so a share rarely
+ * catches it.
+ */
+export declare function CleanViewControl({ onExit }: {
+    onExit: () => void;
+}): import("react").JSX.Element;