@arbidocs/blocks 0.5.120 → 0.5.121

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/shell/ConnectedAppShell.js

@@ -22,6 +22,7 @@ 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 }) {
@@ -109,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 { 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 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    </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;

package/dist/connection/viewer/CleanViewControl.js

@@ -0,0 +1,76 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from "react";
+import { Maximize, PanelTop } from "lucide-react";
+import { Button, cn } from "@arbidocs/react/ui";
+import { toggleFullscreen } from "../../presentation/usePresenterKeys.js";
+const IDLE_MS = 2e3;
+function CleanViewControl({ onExit }) {
+  const [view, setView] = useState(null);
+  const [shown, setShown] = useState(true);
+  const ref = useCallback((node) => {
+    setView(node?.ownerDocument.defaultView ?? null);
+  }, []);
+  useEffect(() => {
+    if (!view) return;
+    let timer = view.setTimeout(() => setShown(false), IDLE_MS);
+    const wake = () => {
+      setShown(true);
+      view.clearTimeout(timer);
+      timer = view.setTimeout(() => setShown(false), IDLE_MS);
+    };
+    view.addEventListener("pointermove", wake);
+    view.addEventListener("keydown", wake);
+    return () => {
+      view.clearTimeout(timer);
+      view.removeEventListener("pointermove", wake);
+      view.removeEventListener("keydown", wake);
+    };
+  }, [view]);
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref,
+      className: cn(
+        "absolute right-3 top-3 z-20 flex gap-1 rounded-md bg-background/90 p-1 shadow-md transition-opacity",
+        shown ? "opacity-100" : "pointer-events-none opacity-0"
+      ),
+      "data-testid": "viewer-clean-control",
+      children: [
+        /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            size: "sm",
+            variant: "ghost",
+            className: "h-7",
+            onClick: () => view && toggleFullscreen(view),
+            children: [
+              /* @__PURE__ */ jsx(Maximize, { className: "size-3.5" }),
+              "Full screen"
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            size: "sm",
+            variant: "ghost",
+            className: "h-7",
+            onClick: onExit,
+            "data-testid": "viewer-clean-exit",
+            children: [
+              /* @__PURE__ */ jsx(PanelTop, { className: "size-3.5" }),
+              "Show controls"
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+export {
+  CleanViewControl
+};
+//# sourceMappingURL=CleanViewControl.js.map

package/dist/connection/viewer/CleanViewControl.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/connection/viewer/CleanViewControl.tsx"],
+  "sourcesContent": ["import { useCallback, useEffect, useState } from 'react'\nimport { Maximize, PanelTop } from 'lucide-react'\nimport { Button, cn } from '@arbidocs/react/ui'\nimport { toggleFullscreen } from '../../presentation/usePresenterKeys'\n\nconst IDLE_MS = 2000\n\n/**\n * Over the viewer's clean view: Full screen, and Show controls (leave the clean view). It shows\n * while the pointer moves or a key is pressed and fades after a moment, so a share rarely\n * catches it.\n */\nexport function CleanViewControl({ onExit }: { onExit: () => void }) {\n  const [view, setView] = useState<Window | null>(null)\n  const [shown, setShown] = useState(true)\n  const ref = useCallback((node: HTMLDivElement | null) => {\n    setView(node?.ownerDocument.defaultView ?? null)\n  }, [])\n\n  useEffect(() => {\n    if (!view) return\n    let timer = view.setTimeout(() => setShown(false), IDLE_MS)\n    const wake = () => {\n      setShown(true)\n      view.clearTimeout(timer)\n      timer = view.setTimeout(() => setShown(false), IDLE_MS)\n    }\n    view.addEventListener('pointermove', wake)\n    view.addEventListener('keydown', wake)\n    return () => {\n      view.clearTimeout(timer)\n      view.removeEventListener('pointermove', wake)\n      view.removeEventListener('keydown', wake)\n    }\n  }, [view])\n\n  return (\n    <div\n      ref={ref}\n      className={cn(\n        'absolute right-3 top-3 z-20 flex gap-1 rounded-md bg-background/90 p-1 shadow-md transition-opacity',\n        shown ? 'opacity-100' : 'pointer-events-none opacity-0'\n      )}\n      data-testid=\"viewer-clean-control\"\n    >\n      <Button\n        type=\"button\"\n        size=\"sm\"\n        variant=\"ghost\"\n        className=\"h-7\"\n        onClick={() => view && toggleFullscreen(view)}\n      >\n        <Maximize className=\"size-3.5\" />\n        Full screen\n      </Button>\n      <Button\n        type=\"button\"\n        size=\"sm\"\n        variant=\"ghost\"\n        className=\"h-7\"\n        onClick={onExit}\n        data-testid=\"viewer-clean-exit\"\n      >\n        <PanelTop className=\"size-3.5\" />\n        Show controls\n      </Button>\n    </div>\n  )\n}\n"],
+  "mappings": ";AA6CM,SAOE,KAPF;AA7CN,SAAS,aAAa,WAAW,gBAAgB;AACjD,SAAS,UAAU,gBAAgB;AACnC,SAAS,QAAQ,UAAU;AAC3B,SAAS,wBAAwB;AAEjC,MAAM,UAAU;AAOT,SAAS,iBAAiB,EAAE,OAAO,GAA2B;AACnE,QAAM,CAAC,MAAM,OAAO,IAAI,SAAwB,IAAI;AACpD,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,IAAI;AACvC,QAAM,MAAM,YAAY,CAAC,SAAgC;AACvD,YAAQ,MAAM,cAAc,eAAe,IAAI;AAAA,EACjD,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACd,QAAI,CAAC,KAAM;AACX,QAAI,QAAQ,KAAK,WAAW,MAAM,SAAS,KAAK,GAAG,OAAO;AAC1D,UAAM,OAAO,MAAM;AACjB,eAAS,IAAI;AACb,WAAK,aAAa,KAAK;AACvB,cAAQ,KAAK,WAAW,MAAM,SAAS,KAAK,GAAG,OAAO;AAAA,IACxD;AACA,SAAK,iBAAiB,eAAe,IAAI;AACzC,SAAK,iBAAiB,WAAW,IAAI;AACrC,WAAO,MAAM;AACX,WAAK,aAAa,KAAK;AACvB,WAAK,oBAAoB,eAAe,IAAI;AAC5C,WAAK,oBAAoB,WAAW,IAAI;AAAA,IAC1C;AAAA,EACF,GAAG,CAAC,IAAI,CAAC;AAET,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,WAAW;AAAA,QACT;AAAA,QACA,QAAQ,gBAAgB;AAAA,MAC1B;AAAA,MACA,eAAY;AAAA,MAEZ;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,MAAK;AAAA,YACL,MAAK;AAAA,YACL,SAAQ;AAAA,YACR,WAAU;AAAA,YACV,SAAS,MAAM,QAAQ,iBAAiB,IAAI;AAAA,YAE5C;AAAA,kCAAC,YAAS,WAAU,YAAW;AAAA,cAAE;AAAA;AAAA;AAAA,QAEnC;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,MAAK;AAAA,YACL,MAAK;AAAA,YACL,SAAQ;AAAA,YACR,WAAU;AAAA,YACV,SAAS;AAAA,YACT,eAAY;AAAA,YAEZ;AAAA,kCAAC,YAAS,WAAU,YAAW;AAAA,cAAE;AAAA;AAAA;AAAA,QAEnC;AAAA;AAAA;AAAA,EACF;AAEJ;",
+  "names": []
+}

package/dist/connection/viewer/ConnectedDocumentViewer.js

@@ -10,13 +10,7 @@ import {
   PenLine,
   Users
 } from "lucide-react";
-import {
-  DEFAULT_ASPECT_OPTIONS,
-  ImageCropModal,
-  useArbi,
-  useArbiSessionState,
-  useArbiSessionStore
-} from "@arbidocs/react";
+import { useArbi, useArbiSessionState, useArbiSessionStore } from "@arbidocs/react";
 import { findVersion, parseVersionRef, versionLabel } from "@arbidocs/react/artifacts";
 import {
   SIGNED_LOCKED_REASON,
@@ -63,6 +57,8 @@ import {
   SignatureStatus,
   VersionSnapshotBar
 } from "../../document-tools/index.js";
+import { useViewerClipping } from "../presentation/useViewerClipping.js";
+import { useCleanView } from "./useCleanView.js";
 import {
   DocumentLabelBar,
   PdfPageNav,
@@ -89,6 +85,7 @@ import { ConnectedDocumentToolsProvider } from "./ConnectedDocumentToolsProvider
 import { FinaliseTranslationButton } from "./FinaliseTranslationButton.js";
 import { useDocumentViewerSupport } from "./support.js";
 import { useImageCrop } from "./useImageCrop.js";
+import { ViewerCropModal } from "./ViewerCropModal.js";
 import { useViewedDocument } from "./useViewedDocument.js";
 import { useViewerBlobs } from "./useViewerBlobs.js";
 import { useViewerTabs } from "./useViewerTabs.js";
@@ -98,6 +95,7 @@ import { ParsedTextView } from "./parsed/ParsedTextView.js";
 import { ViewerPdfPane } from "./ViewerPdfPane.js";
 import { ConnectedNativeDocxEditor as NativeDocxEditor } from "../docx/ConnectedNativeDocxEditor.js";
 import { canChangeVisibility } from "../../files/permissions.js";
+import { SlidesTab } from "./slidesTabChunk.js";
 const StreamedWordArtifact = lazy(
   () => import("../docx/ConnectedStreamedWordArtifact.js").then((m) => ({
     default: m.ConnectedStreamedWordArtifact
@@ -179,6 +177,7 @@ function DocumentViewerContent({
     streamingDoc,
     isStreaming,
     draftDoc,
+    isPresentation,
     isDraft,
     isCaptureDraft,
     labelSummaries,
@@ -298,7 +297,7 @@ function DocumentViewerContent({
     signatureDocumentId,
     !isDraft && !liveKind
   );
-  const isCoEditing = !snapshotDocumentId && !compareDocumentId && !isDraft && (activeTab === "docx" && isDocx || activeTab === "edit" && isArtifact && !liveKind && !isStreaming);
+  const isCoEditing = !snapshotDocumentId && !compareDocumentId && !isDraft && (activeTab === "docx" && isDocx || activeTab === "slides" && isPresentation || activeTab === "edit" && isArtifact && !liveKind && !isStreaming);
   const currentVersionLabel = isCoEditing ? void 0 : !snapshotDocumentId && !compareDocumentId && (isDocx || isArtifact && !liveKind) ? "Live" : versionLabel(versions, snapshotDocumentId || documentId);
   const compareVersionLabel = versionLabel(versions, compareDocumentId);
   const snapshotNumber = findVersion(versions, snapshotDocumentId)?.number;
@@ -422,6 +421,8 @@ function DocumentViewerContent({
     isSnapshot: !!snapshotDocumentId,
     isComparing
   });
+  const clip = useViewerClipping(annotatable || !!pdfBlob && (isImage || isVideo), isCompact);
+  const clean = useCleanView();
   const signatureBanner = !isDraft && !liveKind && !snapshotDocumentId && /* @__PURE__ */ jsx(
     SignatureRequestBanner,
     {
@@ -460,11 +461,13 @@ function DocumentViewerContent({
         compact: isCompact,
         onClick: () => {
           setPlacingSignature(false);
+          clip.stop();
           markup.setShowOriginal(false);
           setAnnotating((on) => !on);
         }
       }
     ),
+    clip.button,
     activeTab === "pdf" && pdfBlob && !placingSignature && (markup.hasMarkup || annotating) && /* @__PURE__ */ jsx(
       ShowOriginalButton,
       {
@@ -725,22 +728,8 @@ function DocumentViewerContent({
         )
       ] }),
       compareRow: isComparing ? compareIndicator || void 0 : void 0,
-      footer: (
-        // Crop to a new document. Full resolution (no maxSize): a crop frames, it never downscales.
-        /* @__PURE__ */ jsx(
-          ImageCropModal,
-          {
-            open: crop.cropImageUrl !== null,
-            image: crop.cropImageUrl,
-            title: "Crop image",
-            saveLabel: "Save as a copy",
-            aspectOptions: DEFAULT_ASPECT_OPTIONS,
-            output: { mimeType: "image/png" },
-            onComplete: crop.handleCropComplete,
-            onCancel: crop.closeCrop
-          }
-        )
-      ),
+      ...clean.frame,
+      footer: /* @__PURE__ */ jsx(ViewerCropModal, { crop }),
       children: [
         isComparing && /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(ViewerMessage, { children: "Loading comparison\u2026" }), children: /* @__PURE__ */ jsx(
           NativeDocxComparison,
@@ -752,14 +741,14 @@ function DocumentViewerContent({
         ) }),
         isCaptureDraft && /* @__PURE__ */ jsx(ViewerCaptureDraft, { documentId }),
         !isCaptureDraft && (activeTab === "pdf" || isMedia && activeTab === "html") && (!isArtifact || isDocx && !isDraft && !isStreaming && !liveKind) && !isComparing && /* @__PURE__ */ jsxs(ViewerPane, { hidden: activeTab !== "pdf", children: [
-          /* @__PURE__ */ jsx(DocumentLabelBar, { summaries: labelSummaries }),
-          !isMedia && !isImage && signatureBanner,
-          activeTab === "pdf" && pdfBlob && !pdfVerified && /* @__PURE__ */ jsxs(ViewerMessage, { children: [
+          !clean.on && /* @__PURE__ */ jsx(DocumentLabelBar, { summaries: labelSummaries }),
+          !clean.on && !isMedia && !isImage && signatureBanner,
+          !clean.on && activeTab === "pdf" && pdfBlob && !pdfVerified && /* @__PURE__ */ jsxs(ViewerMessage, { children: [
             "Offline copy: its version cannot be verified. Reconnect before signing.",
             " ",
             /* @__PURE__ */ jsx("button", { type: "button", onClick: () => void blobs.retryPdf(), className: "underline", children: "Retry loading the current PDF" })
           ] }),
-          activeTab === "pdf" && !isMedia && !isImage && /* @__PURE__ */ jsx(
+          !clean.on && activeTab === "pdf" && !isMedia && !isImage && /* @__PURE__ */ jsx(
             MarkupNotices,
             {
               legacyPrompt: markup.legacyPrompt,
@@ -767,7 +756,7 @@ function DocumentViewerContent({
               onOpenVersion: (n) => setSnapshotDocumentId(`${documentId}@v${n}`)
             }
           ),
-          /* @__PURE__ */ jsx(ViewerControlBar, { controls: activeTab === "pdf" && pageNav, children: /* @__PURE__ */ jsx(
+          /* @__PURE__ */ jsx(ViewerControlBar, { controls: !clean.on && activeTab === "pdf" && pageNav, children: /* @__PURE__ */ jsx(
             ViewerPdfPane,
             {
               documentId,
@@ -788,6 +777,7 @@ function DocumentViewerContent({
                 setIsSignOpen(true);
               },
               annotating,
+              clipping: clip.clipping,
               markup,
               pdfSnapshotNumber,
               isSigned,
@@ -851,6 +841,15 @@ function DocumentViewerContent({
           }
         ),
         activeTab === "xlsx" && isXlsx && (xlsxBlob ? /* @__PURE__ */ jsx(XlsxViewer, { blob: xlsxBlob }) : /* @__PURE__ */ jsx(ViewerMessage, { children: xlsxError ? "Failed to load spreadsheet" : "Loading spreadsheet..." })),
+        activeTab === "slides" && isPresentation && /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(ViewerMessage, { children: "Loading slides\u2026" }), children: /* @__PURE__ */ jsx(
+          SlidesTab,
+          {
+            documentId,
+            version: snapshotDocumentId ? snapshotNumber : void 0,
+            currentVersion: documentData?.current_version ?? void 0,
+            draftTitle: isDraft ? draftDoc?.title ?? "" : void 0
+          }
+        ) }),
         activeTab === "docx" && isDocx && !isComparing && /* @__PURE__ */ jsxs(Suspense, { fallback: /* @__PURE__ */ jsx(ViewerMessage, { children: "Loading editor\u2026" }), children: [
           signatureBanner,
           isSigned && !snapshotDocumentId && /* @__PURE__ */ jsx(SignedEditNote, {}),