@arbidocs/blocks 0.5.121 → 0.5.122

package/dist/connection/presentation/PresentationPill.js

@@ -1,10 +1,10 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Presentation } from "lucide-react";
-import { DOCUMENT_VIEWER_PANEL, useArbiSessionState, useArbiSessionStore } from "@arbidocs/react";
+import { useArbiSessionState, useArbiSessionStore } from "@arbidocs/react";
 import { Button } from "@arbidocs/react/ui";
 import { usePresentation } from "../../presentation/store.js";
-import { editPresentation } from "./requests.js";
+import { showPresentation } from "./requests.js";
 function PresentationPill({ compact }) {
   const session = useArbiSessionStore();
   const boundTo = usePresentation((s) => s.boundTo);
@@ -14,12 +14,7 @@ function PresentationPill({ compact }) {
     (s) => s.viewingDocument?.id === boundTo && s.documentViewer.tab === "slides"
   );
   if (onIt || boundTo === null && clips === 0) return null;
-  const back = () => {
-    if (boundTo === null) return editPresentation(session, { kind: "new" });
-    session.setViewingDocument({ id: boundTo, page: null });
-    session.setDocumentViewer({ tab: "slides" });
-    session.openPanel(DOCUMENT_VIEWER_PANEL, "docked");
-  };
+  const back = () => showPresentation(session, boundTo);
   return /* @__PURE__ */ jsxs(
     Button,
     {

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

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

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

@@ -8,6 +8,11 @@ export type PresentationRequest = {
     documentId: string;
     version?: number;
 };
+/**
+ * Back to the presentation being edited, on its slides tab (a new one when none is open yet): from
+ * any document the viewer shows.
+ */
+export declare function showPresentation(session: Session, boundTo: string | null): void;
 /**
  * Edit a presentation in the viewer's slides tab: a saved one (its document, on that tab), or a
  * new one (a presentation draft, saved into Files › Presentations when it is first saved).

package/dist/connection/presentation/requests.js

@@ -1,6 +1,12 @@
 "use client";
 import { DOCUMENT_VIEWER_PANEL } from "@arbidocs/react";
 import { versionRef } from "@arbidocs/react/artifacts";
+function showPresentation(session, boundTo) {
+  if (boundTo === null) return editPresentation(session, { kind: "new" });
+  session.setViewingDocument({ id: boundTo, page: null });
+  session.setDocumentViewer({ tab: "slides" });
+  session.openPanel(DOCUMENT_VIEWER_PANEL, "docked");
+}
 function editPresentation(session, request) {
   if (request.kind === "new") {
     session.startDraftDocument("presentation");
@@ -15,6 +21,7 @@ function editPresentation(session, request) {
   session.openPanel(DOCUMENT_VIEWER_PANEL, "docked");
 }
 export {
-  editPresentation
+  editPresentation,
+  showPresentation
 };
 //# sourceMappingURL=requests.js.map

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

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

package/dist/connection/viewer/ViewerPdfPane.js

@@ -10,6 +10,7 @@ import {
 } from "@arbidocs/react/viewers";
 import { friendlyFileType } from "@arbidocs/react/ui";
 import { ViewerLoadError, ViewerMessage, ViewerPreviewUnavailable } from "../../files/index.js";
+import { usePdfClipOutlines } from "./pdf/usePdfClipOutlines.js";
 import { usePdfPassageHighlights } from "./pdf/usePdfPassageHighlights.js";
 import { useViewerIsDetached } from "./support.js";
 import { isLegacyPresentationFile } from "../../presentation/panel-id.js";
@@ -44,13 +45,15 @@ function SessionPdfViewer(props) {
     [session, viewingId]
   );
   const passageHighlights = usePdfPassageHighlights(viewingId);
+  const clipOutlines = usePdfClipOutlines(viewingId);
   const { renderPageOverlay: modeOverlay } = props;
   const renderPageOverlay = useCallback(
     (page) => /* @__PURE__ */ jsxs(Fragment, { children: [
       passageHighlights(page.pageNumber),
+      clipOutlines(page.pageNumber),
       modeOverlay?.(page)
     ] }),
-    [passageHighlights, modeOverlay]
+    [passageHighlights, clipOutlines, modeOverlay]
   );
   return /* @__PURE__ */ jsx(
     KitPdfViewer,

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/connection/viewer/ViewerPdfPane.tsx"],
-  "sourcesContent": ["/**\n * The PDF (or media) body of the document viewer: loading and failure states, the image, audio and\n * video players, and the PDF with its tools \u2014 the markup layer, signature placement, a signature\n * request being prepared or signed.\n */\n\nimport { lazy, Suspense, useCallback } from 'react'\nimport { useArbiSessionState, useArbiSessionStore } from '@arbidocs/react'\nimport type {\n  SignatureAppearance,\n  SignatureRequest,\n  useDocumentMarkup,\n} from '@arbidocs/react/document-tools'\nimport {\n  AudioViewer,\n  ImageViewer,\n  PdfViewer as KitPdfViewer,\n  VideoViewer,\n  type PdfViewerProps,\n} from '@arbidocs/react/viewers'\nimport { friendlyFileType } from '@arbidocs/react/ui'\nimport { ViewerLoadError, ViewerMessage, ViewerPreviewUnavailable } from '../../files'\nimport { usePdfPassageHighlights } from './pdf/usePdfPassageHighlights'\nimport { useViewerIsDetached } from './support'\nimport { isLegacyPresentationFile } from '../../presentation/panel-id'\nimport { PresentationFileCard } from '../presentation/PresentationFileCard'\nimport { fileExtension, type ViewedDocument } from './useViewedDocument'\n\n// The markup viewer brings in pdf-lib, which nothing else needs: load it only when it is shown.\nconst AnnotatedPdfViewer = lazy(() =>\n  import('../../document-tools/viewer').then((m) => ({ default: m.AnnotatedPdfViewer }))\n)\nconst SignaturePlacementViewer = lazy(() =>\n  import('../../document-tools/viewer').then((m) => ({ default: m.SignaturePlacementViewer }))\n)\n// Signature requests: placing fields for signers, and a signer's guided signing.\nconst SignatureRequestEditor = lazy(() =>\n  import('../../document-tools/viewer').then((m) => ({ default: m.SignatureRequestEditor }))\n)\n// Clip mode for the presentation: its own chunk (the presentation module).\nconst ClippingPdfViewer = lazy(() =>\n  import('../presentation/ClippingPdfViewer').then((m) => ({ default: m.ClippingPdfViewer }))\n)\nconst ClippingMediaViewer = lazy(() =>\n  import('../presentation/ClippingMediaViewer').then((m) => ({ default: m.ClippingMediaViewer }))\n)\nconst GuidedSigningViewer = lazy(() =>\n  import('../../document-tools/viewer').then((m) => ({ default: m.GuidedSigningViewer }))\n)\n\n/** A signature request: the author placing fields, or a signer walked through theirs. */\nexport type SignatureFlow =\n  | { kind: 'prepare'; draft?: SignatureRequest; self?: boolean }\n  | { kind: 'sign'; request: SignatureRequest }\n  | null\n\n/**\n * The kit PDF viewer, reporting the page read into the session state; in a detached window its\n * pages render without the opener's web fonts (canvas text in another document cannot use them).\n */\nfunction SessionPdfViewer(props: Omit<PdfViewerProps, 'onPageChange' | 'disableFontFace'>) {\n  const session = useArbiSessionStore()\n  const viewingId = useArbiSessionState((s) => s.viewingDocument?.id)\n  const isDetached = useViewerIsDetached()\n  const onPageChange = useCallback(\n    (page: number) => {\n      if (viewingId) session.setViewingDocument({ id: viewingId, page })\n    },\n    [session, viewingId]\n  )\n  // The passages a citation lights, over their pages, under whatever the mode draws (markup).\n  const passageHighlights = usePdfPassageHighlights(viewingId)\n  const { renderPageOverlay: modeOverlay } = props\n  const renderPageOverlay = useCallback<NonNullable<PdfViewerProps['renderPageOverlay']>>(\n    (page) => (\n      <>\n        {passageHighlights(page.pageNumber)}\n        {modeOverlay?.(page)}\n      </>\n    ),\n    [passageHighlights, modeOverlay]\n  )\n  return (\n    <KitPdfViewer\n      {...props}\n      renderPageOverlay={renderPageOverlay}\n      onPageChange={onPageChange}\n      disableFontFace={!!isDetached}\n    />\n  )\n}\n\nexport interface ViewerPdfPaneProps {\n  documentId: string\n  doc: ViewedDocument\n  pdfBlob: Blob | null\n  isPdfLoading: boolean\n  pdfError: unknown\n  onDownload: () => void\n  viewerProps: {\n    currentPage: number | undefined\n    onLoadSuccess: (pages: number) => void\n    scrollTrigger: number\n    zoom: number\n    onZoomChange: (zoom: number) => void\n  }\n  signatureFlow: SignatureFlow\n  onSignatureFlow: (flow: SignatureFlow) => void\n  currentUserId: string | undefined\n  placingSignature: boolean\n  onPlacingDone: (appearance?: SignatureAppearance) => void\n  annotating: boolean\n  /** Clip mode: dragging over a page adds that area to the presentation. */\n  clipping?: boolean\n  markup: ReturnType<typeof useDocumentMarkup>\n  pdfSnapshotNumber: number | undefined\n  isSigned: boolean\n  /** One's saved signature or initials to place as a picture stamp (PDF tab \u203A My signature). */\n  placeMark?: { image: string; label: string; key: number } | null\n}\n\nexport function ViewerPdfPane({\n  documentId,\n  doc,\n  pdfBlob,\n  isPdfLoading,\n  pdfError,\n  onDownload,\n  viewerProps,\n  signatureFlow,\n  onSignatureFlow,\n  currentUserId,\n  placingSignature,\n  onPlacingDone,\n  annotating,\n  clipping = false,\n  markup,\n  pdfSnapshotNumber,\n  isSigned,\n  placeMark = null,\n}: ViewerPdfPaneProps) {\n  const { documentData, isDownloadOnly, isVideo, isAudio, isImage, isDocx } = doc\n  const showMarkup = markup.hasMarkup && !markup.showOriginal\n\n  // A presentation saved before it was a PDF (its data alone): what it is, and Edit presentation.\n  if (isLegacyPresentationFile(documentData?.file_name)) {\n    return <PresentationFileCard documentId={documentId} fileName={documentData?.file_name ?? ''} />\n  }\n\n  // Files that cannot be previewed in the browser: the download, at once.\n  if (isDownloadOnly) {\n    return (\n      <ViewerPreviewUnavailable\n        extension={fileExtension(documentData?.file_name)}\n        onDownload={onDownload}\n      />\n    )\n  }\n\n  // Text files are rendered to a PDF too, so name what the user opened, not the rendering.\n  const loadingLabel = isVideo\n    ? 'Loading video...'\n    : isAudio\n      ? 'Loading audio...'\n      : isImage\n        ? 'Loading image...'\n        : !documentData\n          ? 'Loading document...'\n          : friendlyFileType(documentData.file_type, documentData.file_name) === 'Text'\n            ? 'Loading text...'\n            : 'Loading PDF...'\n  const errorLabel = isVideo\n    ? 'Failed to load video'\n    : isAudio\n      ? 'Failed to load audio'\n      : isImage\n        ? 'Failed to load image'\n        : 'Failed to load PDF'\n\n  if (\n    isDocx &&\n    !pdfSnapshotNumber &&\n    documentData &&\n    !['completed', 'low-content', 'failed'].includes(documentData.status || '')\n  ) {\n    return (\n      <ViewerMessage>\n        PDF and search indexing are processing. Open the DOCX tab to edit now.\n      </ViewerMessage>\n    )\n  }\n  if (isDocx && !pdfSnapshotNumber && documentData?.status === 'failed') {\n    return (\n      <ViewerMessage>\n        PDF conversion failed. Open the Word editor or download the document.\n      </ViewerMessage>\n    )\n  }\n  if (isPdfLoading) return <ViewerMessage>{loadingLabel}</ViewerMessage>\n  if (pdfError) {\n    return (\n      <ViewerLoadError\n        message={\n          isVideo || isAudio || isImage\n            ? `${errorLabel} \u2014 download it instead.`\n            : \"Couldn't display the PDF \u2014 download it instead.\"\n        }\n        onDownload={onDownload}\n      />\n    )\n  }\n  // Nothing is fetched yet: the PDF is read once the document record has loaded, so the viewer\n  // would otherwise sit empty for that first stretch.\n  if (!pdfBlob) return <ViewerMessage>{loadingLabel}</ViewerMessage>\n\n  // Clip mode on an image or a video: drag over it for the presentation.\n  if (clipping && (isImage || isVideo)) {\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <ClippingMediaViewer\n          file={pdfBlob}\n          kind={isVideo ? 'video' : 'image'}\n          documentId={documentId}\n          fileName={documentData?.file_name || (isVideo ? 'Video' : 'Image')}\n        />\n      </Suspense>\n    )\n  }\n  if (isVideo) return <VideoViewer blob={pdfBlob} title={documentData?.file_name || 'Video'} />\n  if (isAudio) return <AudioViewer blob={pdfBlob} title={documentData?.file_name || 'Audio'} />\n  if (isImage) {\n    return <ImageViewer blob={pdfBlob} alt={documentData?.file_name || 'Document image'} />\n  }\n  if (signatureFlow?.kind === 'prepare') {\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <SignatureRequestEditor\n          {...viewerProps}\n          file={pdfBlob}\n          documentId={documentId}\n          version={pdfSnapshotNumber ?? documentData?.current_version ?? undefined}\n          selfSigning={signatureFlow.self}\n          draft={signatureFlow.draft}\n          shareFile={!signatureFlow.draft}\n          viewer={SessionPdfViewer}\n          onCancel={() => onSignatureFlow(null)}\n          onSaved={() => onSignatureFlow(null)}\n        />\n      </Suspense>\n    )\n  }\n  if (signatureFlow?.kind === 'sign' && currentUserId) {\n    const { currentPage: _page, scrollTrigger: _trigger, ...guidedProps } = viewerProps\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <GuidedSigningViewer\n          {...guidedProps}\n          file={pdfBlob}\n          request={signatureFlow.request}\n          signer={currentUserId}\n          viewer={SessionPdfViewer}\n          onClose={() => onSignatureFlow(null)}\n          onSigned={() => onSignatureFlow(null)}\n        />\n      </Suspense>\n    )\n  }\n  if (placingSignature) {\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <SignaturePlacementViewer\n          {...viewerProps}\n          file={pdfBlob}\n          documentId={documentId}\n          viewer={SessionPdfViewer}\n          onCancel={() => onPlacingDone()}\n          onContinue={(appearance) => onPlacingDone(appearance)}\n        />\n      </Suspense>\n    )\n  }\n  if (clipping) {\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <ClippingPdfViewer\n          {...viewerProps}\n          file={pdfBlob}\n          documentId={documentId}\n          version={pdfSnapshotNumber}\n          fileName={documentData?.file_name || 'Document'}\n          hasMarkup={markup.hasMarkup}\n          viewer={SessionPdfViewer}\n        />\n      </Suspense>\n    )\n  }\n  // Annotate mode, or the markup as the reading view: one viewer, so leaving annotate mode keeps\n  // (and saves) what was just drawn.\n  if (annotating || showMarkup) {\n    return (\n      <Suspense\n        fallback={\n          <ViewerMessage>\n            {annotating ? 'Loading annotation tools\u2026' : 'Loading markup\u2026'}\n          </ViewerMessage>\n        }\n      >\n        <AnnotatedPdfViewer\n          key={`${documentId}@${pdfSnapshotNumber ?? 'current'}`}\n          {...viewerProps}\n          file={pdfBlob}\n          documentId={documentId}\n          version={pdfSnapshotNumber}\n          editing={annotating}\n          onMarkupChange={markup.onMarkupChange}\n          fileName={documentData?.file_name}\n          shared={documentData?.shared ?? false}\n          folder={documentData?.folder}\n          workspaceId={documentData?.workspace_ext_id}\n          viewer={SessionPdfViewer}\n          signed={isSigned}\n          placeStamp={placeMark}\n        />\n      </Suspense>\n    )\n  }\n  return <SessionPdfViewer {...viewerProps} file={pdfBlob} />\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * The PDF (or media) body of the document viewer: loading and failure states, the image, audio and\n * video players, and the PDF with its tools \u2014 the markup layer, signature placement, a signature\n * request being prepared or signed.\n */\n\nimport { lazy, Suspense, useCallback } from 'react'\nimport { useArbiSessionState, useArbiSessionStore } from '@arbidocs/react'\nimport type {\n  SignatureAppearance,\n  SignatureRequest,\n  useDocumentMarkup,\n} from '@arbidocs/react/document-tools'\nimport {\n  AudioViewer,\n  ImageViewer,\n  PdfViewer as KitPdfViewer,\n  VideoViewer,\n  type PdfViewerProps,\n} from '@arbidocs/react/viewers'\nimport { friendlyFileType } from '@arbidocs/react/ui'\nimport { ViewerLoadError, ViewerMessage, ViewerPreviewUnavailable } from '../../files'\nimport { usePdfClipOutlines } from './pdf/usePdfClipOutlines'\nimport { usePdfPassageHighlights } from './pdf/usePdfPassageHighlights'\nimport { useViewerIsDetached } from './support'\nimport { isLegacyPresentationFile } from '../../presentation/panel-id'\nimport { PresentationFileCard } from '../presentation/PresentationFileCard'\nimport { fileExtension, type ViewedDocument } from './useViewedDocument'\n\n// The markup viewer brings in pdf-lib, which nothing else needs: load it only when it is shown.\nconst AnnotatedPdfViewer = lazy(() =>\n  import('../../document-tools/viewer').then((m) => ({ default: m.AnnotatedPdfViewer }))\n)\nconst SignaturePlacementViewer = lazy(() =>\n  import('../../document-tools/viewer').then((m) => ({ default: m.SignaturePlacementViewer }))\n)\n// Signature requests: placing fields for signers, and a signer's guided signing.\nconst SignatureRequestEditor = lazy(() =>\n  import('../../document-tools/viewer').then((m) => ({ default: m.SignatureRequestEditor }))\n)\n// Clip mode for the presentation: its own chunk (the presentation module).\nconst ClippingPdfViewer = lazy(() =>\n  import('../presentation/ClippingPdfViewer').then((m) => ({ default: m.ClippingPdfViewer }))\n)\nconst ClippingMediaViewer = lazy(() =>\n  import('../presentation/ClippingMediaViewer').then((m) => ({ default: m.ClippingMediaViewer }))\n)\nconst GuidedSigningViewer = lazy(() =>\n  import('../../document-tools/viewer').then((m) => ({ default: m.GuidedSigningViewer }))\n)\n\n/** A signature request: the author placing fields, or a signer walked through theirs. */\nexport type SignatureFlow =\n  | { kind: 'prepare'; draft?: SignatureRequest; self?: boolean }\n  | { kind: 'sign'; request: SignatureRequest }\n  | null\n\n/**\n * The kit PDF viewer, reporting the page read into the session state; in a detached window its\n * pages render without the opener's web fonts (canvas text in another document cannot use them).\n */\nfunction SessionPdfViewer(props: Omit<PdfViewerProps, 'onPageChange' | 'disableFontFace'>) {\n  const session = useArbiSessionStore()\n  const viewingId = useArbiSessionState((s) => s.viewingDocument?.id)\n  const isDetached = useViewerIsDetached()\n  const onPageChange = useCallback(\n    (page: number) => {\n      if (viewingId) session.setViewingDocument({ id: viewingId, page })\n    },\n    [session, viewingId]\n  )\n  // The passages a citation lights, over their pages, under whatever the mode draws (markup).\n  const passageHighlights = usePdfPassageHighlights(viewingId)\n  // The open presentation's clips of this document, where they were cut.\n  const clipOutlines = usePdfClipOutlines(viewingId)\n  const { renderPageOverlay: modeOverlay } = props\n  const renderPageOverlay = useCallback<NonNullable<PdfViewerProps['renderPageOverlay']>>(\n    (page) => (\n      <>\n        {passageHighlights(page.pageNumber)}\n        {clipOutlines(page.pageNumber)}\n        {modeOverlay?.(page)}\n      </>\n    ),\n    [passageHighlights, clipOutlines, modeOverlay]\n  )\n  return (\n    <KitPdfViewer\n      {...props}\n      renderPageOverlay={renderPageOverlay}\n      onPageChange={onPageChange}\n      disableFontFace={!!isDetached}\n    />\n  )\n}\n\nexport interface ViewerPdfPaneProps {\n  documentId: string\n  doc: ViewedDocument\n  pdfBlob: Blob | null\n  isPdfLoading: boolean\n  pdfError: unknown\n  onDownload: () => void\n  viewerProps: {\n    currentPage: number | undefined\n    onLoadSuccess: (pages: number) => void\n    scrollTrigger: number\n    zoom: number\n    onZoomChange: (zoom: number) => void\n  }\n  signatureFlow: SignatureFlow\n  onSignatureFlow: (flow: SignatureFlow) => void\n  currentUserId: string | undefined\n  placingSignature: boolean\n  onPlacingDone: (appearance?: SignatureAppearance) => void\n  annotating: boolean\n  /** Clip mode: dragging over a page adds that area to the presentation. */\n  clipping?: boolean\n  markup: ReturnType<typeof useDocumentMarkup>\n  pdfSnapshotNumber: number | undefined\n  isSigned: boolean\n  /** One's saved signature or initials to place as a picture stamp (PDF tab \u203A My signature). */\n  placeMark?: { image: string; label: string; key: number } | null\n}\n\nexport function ViewerPdfPane({\n  documentId,\n  doc,\n  pdfBlob,\n  isPdfLoading,\n  pdfError,\n  onDownload,\n  viewerProps,\n  signatureFlow,\n  onSignatureFlow,\n  currentUserId,\n  placingSignature,\n  onPlacingDone,\n  annotating,\n  clipping = false,\n  markup,\n  pdfSnapshotNumber,\n  isSigned,\n  placeMark = null,\n}: ViewerPdfPaneProps) {\n  const { documentData, isDownloadOnly, isVideo, isAudio, isImage, isDocx } = doc\n  const showMarkup = markup.hasMarkup && !markup.showOriginal\n\n  // A presentation saved before it was a PDF (its data alone): what it is, and Edit presentation.\n  if (isLegacyPresentationFile(documentData?.file_name)) {\n    return <PresentationFileCard documentId={documentId} fileName={documentData?.file_name ?? ''} />\n  }\n\n  // Files that cannot be previewed in the browser: the download, at once.\n  if (isDownloadOnly) {\n    return (\n      <ViewerPreviewUnavailable\n        extension={fileExtension(documentData?.file_name)}\n        onDownload={onDownload}\n      />\n    )\n  }\n\n  // Text files are rendered to a PDF too, so name what the user opened, not the rendering.\n  const loadingLabel = isVideo\n    ? 'Loading video...'\n    : isAudio\n      ? 'Loading audio...'\n      : isImage\n        ? 'Loading image...'\n        : !documentData\n          ? 'Loading document...'\n          : friendlyFileType(documentData.file_type, documentData.file_name) === 'Text'\n            ? 'Loading text...'\n            : 'Loading PDF...'\n  const errorLabel = isVideo\n    ? 'Failed to load video'\n    : isAudio\n      ? 'Failed to load audio'\n      : isImage\n        ? 'Failed to load image'\n        : 'Failed to load PDF'\n\n  if (\n    isDocx &&\n    !pdfSnapshotNumber &&\n    documentData &&\n    !['completed', 'low-content', 'failed'].includes(documentData.status || '')\n  ) {\n    return (\n      <ViewerMessage>\n        PDF and search indexing are processing. Open the DOCX tab to edit now.\n      </ViewerMessage>\n    )\n  }\n  if (isDocx && !pdfSnapshotNumber && documentData?.status === 'failed') {\n    return (\n      <ViewerMessage>\n        PDF conversion failed. Open the Word editor or download the document.\n      </ViewerMessage>\n    )\n  }\n  if (isPdfLoading) return <ViewerMessage>{loadingLabel}</ViewerMessage>\n  if (pdfError) {\n    return (\n      <ViewerLoadError\n        message={\n          isVideo || isAudio || isImage\n            ? `${errorLabel} \u2014 download it instead.`\n            : \"Couldn't display the PDF \u2014 download it instead.\"\n        }\n        onDownload={onDownload}\n      />\n    )\n  }\n  // Nothing is fetched yet: the PDF is read once the document record has loaded, so the viewer\n  // would otherwise sit empty for that first stretch.\n  if (!pdfBlob) return <ViewerMessage>{loadingLabel}</ViewerMessage>\n\n  // Clip mode on an image or a video: drag over it for the presentation.\n  if (clipping && (isImage || isVideo)) {\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <ClippingMediaViewer\n          file={pdfBlob}\n          kind={isVideo ? 'video' : 'image'}\n          documentId={documentId}\n          fileName={documentData?.file_name || (isVideo ? 'Video' : 'Image')}\n        />\n      </Suspense>\n    )\n  }\n  if (isVideo) return <VideoViewer blob={pdfBlob} title={documentData?.file_name || 'Video'} />\n  if (isAudio) return <AudioViewer blob={pdfBlob} title={documentData?.file_name || 'Audio'} />\n  if (isImage) {\n    return <ImageViewer blob={pdfBlob} alt={documentData?.file_name || 'Document image'} />\n  }\n  if (signatureFlow?.kind === 'prepare') {\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <SignatureRequestEditor\n          {...viewerProps}\n          file={pdfBlob}\n          documentId={documentId}\n          version={pdfSnapshotNumber ?? documentData?.current_version ?? undefined}\n          selfSigning={signatureFlow.self}\n          draft={signatureFlow.draft}\n          shareFile={!signatureFlow.draft}\n          viewer={SessionPdfViewer}\n          onCancel={() => onSignatureFlow(null)}\n          onSaved={() => onSignatureFlow(null)}\n        />\n      </Suspense>\n    )\n  }\n  if (signatureFlow?.kind === 'sign' && currentUserId) {\n    const { currentPage: _page, scrollTrigger: _trigger, ...guidedProps } = viewerProps\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <GuidedSigningViewer\n          {...guidedProps}\n          file={pdfBlob}\n          request={signatureFlow.request}\n          signer={currentUserId}\n          viewer={SessionPdfViewer}\n          onClose={() => onSignatureFlow(null)}\n          onSigned={() => onSignatureFlow(null)}\n        />\n      </Suspense>\n    )\n  }\n  if (placingSignature) {\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <SignaturePlacementViewer\n          {...viewerProps}\n          file={pdfBlob}\n          documentId={documentId}\n          viewer={SessionPdfViewer}\n          onCancel={() => onPlacingDone()}\n          onContinue={(appearance) => onPlacingDone(appearance)}\n        />\n      </Suspense>\n    )\n  }\n  if (clipping) {\n    return (\n      <Suspense fallback={<ViewerMessage>Loading\u2026</ViewerMessage>}>\n        <ClippingPdfViewer\n          {...viewerProps}\n          file={pdfBlob}\n          documentId={documentId}\n          version={pdfSnapshotNumber}\n          fileName={documentData?.file_name || 'Document'}\n          hasMarkup={markup.hasMarkup}\n          viewer={SessionPdfViewer}\n        />\n      </Suspense>\n    )\n  }\n  // Annotate mode, or the markup as the reading view: one viewer, so leaving annotate mode keeps\n  // (and saves) what was just drawn.\n  if (annotating || showMarkup) {\n    return (\n      <Suspense\n        fallback={\n          <ViewerMessage>\n            {annotating ? 'Loading annotation tools\u2026' : 'Loading markup\u2026'}\n          </ViewerMessage>\n        }\n      >\n        <AnnotatedPdfViewer\n          key={`${documentId}@${pdfSnapshotNumber ?? 'current'}`}\n          {...viewerProps}\n          file={pdfBlob}\n          documentId={documentId}\n          version={pdfSnapshotNumber}\n          editing={annotating}\n          onMarkupChange={markup.onMarkupChange}\n          fileName={documentData?.file_name}\n          shared={documentData?.shared ?? false}\n          folder={documentData?.folder}\n          workspaceId={documentData?.workspace_ext_id}\n          viewer={SessionPdfViewer}\n          signed={isSigned}\n          placeStamp={placeMark}\n        />\n      </Suspense>\n    )\n  }\n  return <SessionPdfViewer {...viewerProps} file={pdfBlob} />\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -20,11 +20,12 @@ export interface DocumentPlace {
 }
 /**
  * Open a place in the session's viewer: the document at its page (else the first), its passage
- * marked (else none, so a passage of the document open before never carries over). A passage or a
- * page opens the text view, where passages are marked, unless the place asks for the PDF;
- * otherwise the PDF.
+ * marked (else none, so a passage of the document open before never carries over), on the PDF: a
+ * passage is lit there, in the box the parser found it in. A passage the parser could not place on
+ * its page (a document parsed before passages had boxes) is shown on the text view instead
+ * (`usePdfPassageHighlights`).
  */
-export declare function showDocumentPlace(session: Pick<ArbiSessionStore, 'setViewingDocument' | 'setDocumentViewer'>, { documentId, passageId, page, tab }: DocumentPlace): void;
+export declare function showDocumentPlace(session: Pick<ArbiSessionStore, 'setViewingDocument' | 'setDocumentViewer'>, { documentId, passageId, page }: DocumentPlace): void;
 /** One key per place: two links to the same place are the same link. */
 export declare function documentPlaceKey(place: DocumentPlace | null | undefined): string | null;
 /**

package/dist/connection/viewer/documentPlace.js

@@ -1,7 +1,7 @@
 "use client";
-function showDocumentPlace(session, { documentId, passageId, page, tab }) {
+function showDocumentPlace(session, { documentId, passageId, page }) {
   session.setViewingDocument({ id: documentId, page: page ?? 1, passageId: passageId ?? null });
-  session.setDocumentViewer({ tab: tab !== "pdf" && (passageId || page) ? "html" : "pdf" });
+  session.setDocumentViewer({ tab: "pdf" });
 }
 function documentPlaceKey(place) {
   if (!place?.documentId) return null;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/connection/viewer/documentPlace.ts"],
-  "sourcesContent": ["/**\n * Where a link opens a document: the document (or one of its versions, `doc-\u2026@v{n}`), at a cited\n * passage or a page. Every way into a document goes through one rule, `showDocumentPlace`, so a\n * citation, a deep link, a production's QR code and a click in a list land the same way.\n */\n\nimport type { ArbiSessionStore } from '@arbidocs/react'\nimport type { DocumentViewerTab } from './documentViewerTabs'\n\nexport interface DocumentPlace {\n  /** The document, or a version reference `doc-\u2026@v{n}` (that version opens read-only). */\n  documentId: string\n  /** A passage (`cnk-\u2026`) to scroll to and mark. */\n  passageId?: string | null\n  /** A page to open on. */\n  page?: number | null\n  /**\n   * The document itself (`pdf`, as the environment's `openDocument` asks): a copy the document\n   * tools just made, a signature request.\n   */\n  tab?: 'pdf' | null\n}\n\n/**\n * Open a place in the session's viewer: the document at its page (else the first), its passage\n * marked (else none, so a passage of the document open before never carries over). A passage or a\n * page opens the text view, where passages are marked, unless the place asks for the PDF;\n * otherwise the PDF.\n */\nexport function showDocumentPlace(\n  session: Pick<ArbiSessionStore, 'setViewingDocument' | 'setDocumentViewer'>,\n  { documentId, passageId, page, tab }: DocumentPlace\n): void {\n  session.setViewingDocument({ id: documentId, page: page ?? 1, passageId: passageId ?? null })\n  session.setDocumentViewer({ tab: tab !== 'pdf' && (passageId || page) ? 'html' : 'pdf' })\n}\n\n/** One key per place: two links to the same place are the same link. */\nexport function documentPlaceKey(place: DocumentPlace | null | undefined): string | null {\n  if (!place?.documentId) return null\n  return `${place.documentId}|${place.passageId ?? ''}|${place.page ?? ''}|${place.tab ?? ''}`\n}\n\n/**\n * The dialog's first tab for a place: the PDF asked for, or a page alone, on the document itself; a\n * cited passage in the review; anything else on the first tab offered.\n */\nexport function dialogTabForPlace(\n  place: DocumentPlace,\n  tabs: readonly DocumentViewerTab[]\n): DocumentViewerTab | undefined {\n  if (place.tab === 'pdf' && tabs.includes('document')) return 'document'\n  if (place.passageId && tabs.includes('review')) return 'review'\n  if (place.page && !place.passageId && tabs.includes('document')) return 'document'\n  return tabs[0]\n}\n"],
-  "mappings": ";AA6BO,SAAS,kBACd,SACA,EAAE,YAAY,WAAW,MAAM,IAAI,GAC7B;AACN,UAAQ,mBAAmB,EAAE,IAAI,YAAY,MAAM,QAAQ,GAAG,WAAW,aAAa,KAAK,CAAC;AAC5F,UAAQ,kBAAkB,EAAE,KAAK,QAAQ,UAAU,aAAa,QAAQ,SAAS,MAAM,CAAC;AAC1F;AAGO,SAAS,iBAAiB,OAAwD;AACvF,MAAI,CAAC,OAAO,WAAY,QAAO;AAC/B,SAAO,GAAG,MAAM,UAAU,IAAI,MAAM,aAAa,EAAE,IAAI,MAAM,QAAQ,EAAE,IAAI,MAAM,OAAO,EAAE;AAC5F;AAMO,SAAS,kBACd,OACA,MAC+B;AAC/B,MAAI,MAAM,QAAQ,SAAS,KAAK,SAAS,UAAU,EAAG,QAAO;AAC7D,MAAI,MAAM,aAAa,KAAK,SAAS,QAAQ,EAAG,QAAO;AACvD,MAAI,MAAM,QAAQ,CAAC,MAAM,aAAa,KAAK,SAAS,UAAU,EAAG,QAAO;AACxE,SAAO,KAAK,CAAC;AACf;",
+  "sourcesContent": ["/**\n * Where a link opens a document: the document (or one of its versions, `doc-\u2026@v{n}`), at a cited\n * passage or a page. Every way into a document goes through one rule, `showDocumentPlace`, so a\n * citation, a deep link, a production's QR code and a click in a list land the same way.\n */\n\nimport type { ArbiSessionStore } from '@arbidocs/react'\nimport type { DocumentViewerTab } from './documentViewerTabs'\n\nexport interface DocumentPlace {\n  /** The document, or a version reference `doc-\u2026@v{n}` (that version opens read-only). */\n  documentId: string\n  /** A passage (`cnk-\u2026`) to scroll to and mark. */\n  passageId?: string | null\n  /** A page to open on. */\n  page?: number | null\n  /**\n   * The document itself (`pdf`, as the environment's `openDocument` asks): a copy the document\n   * tools just made, a signature request.\n   */\n  tab?: 'pdf' | null\n}\n\n/**\n * Open a place in the session's viewer: the document at its page (else the first), its passage\n * marked (else none, so a passage of the document open before never carries over), on the PDF: a\n * passage is lit there, in the box the parser found it in. A passage the parser could not place on\n * its page (a document parsed before passages had boxes) is shown on the text view instead\n * (`usePdfPassageHighlights`).\n */\nexport function showDocumentPlace(\n  session: Pick<ArbiSessionStore, 'setViewingDocument' | 'setDocumentViewer'>,\n  { documentId, passageId, page }: DocumentPlace\n): void {\n  session.setViewingDocument({ id: documentId, page: page ?? 1, passageId: passageId ?? null })\n  session.setDocumentViewer({ tab: 'pdf' })\n}\n\n/** One key per place: two links to the same place are the same link. */\nexport function documentPlaceKey(place: DocumentPlace | null | undefined): string | null {\n  if (!place?.documentId) return null\n  return `${place.documentId}|${place.passageId ?? ''}|${place.page ?? ''}|${place.tab ?? ''}`\n}\n\n/**\n * The dialog's first tab for a place: the PDF asked for, or a page alone, on the document itself; a\n * cited passage in the review; anything else on the first tab offered.\n */\nexport function dialogTabForPlace(\n  place: DocumentPlace,\n  tabs: readonly DocumentViewerTab[]\n): DocumentViewerTab | undefined {\n  if (place.tab === 'pdf' && tabs.includes('document')) return 'document'\n  if (place.passageId && tabs.includes('review')) return 'review'\n  if (place.page && !place.passageId && tabs.includes('document')) return 'document'\n  return tabs[0]\n}\n"],
+  "mappings": ";AA8BO,SAAS,kBACd,SACA,EAAE,YAAY,WAAW,KAAK,GACxB;AACN,UAAQ,mBAAmB,EAAE,IAAI,YAAY,MAAM,QAAQ,GAAG,WAAW,aAAa,KAAK,CAAC;AAC5F,UAAQ,kBAAkB,EAAE,KAAK,MAAM,CAAC;AAC1C;AAGO,SAAS,iBAAiB,OAAwD;AACvF,MAAI,CAAC,OAAO,WAAY,QAAO;AAC/B,SAAO,GAAG,MAAM,UAAU,IAAI,MAAM,aAAa,EAAE,IAAI,MAAM,QAAQ,EAAE,IAAI,MAAM,OAAO,EAAE;AAC5F;AAMO,SAAS,kBACd,OACA,MAC+B;AAC/B,MAAI,MAAM,QAAQ,SAAS,KAAK,SAAS,UAAU,EAAG,QAAO;AAC7D,MAAI,MAAM,aAAa,KAAK,SAAS,QAAQ,EAAG,QAAO;AACvD,MAAI,MAAM,QAAQ,CAAC,MAAM,aAAa,KAAK,SAAS,UAAU,EAAG,QAAO;AACxE,SAAO,KAAK,CAAC;AACf;",
   "names": []
 }

package/dist/connection/viewer/pdf/PdfClipOutlines.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The open presentation's clips of this document, outlined on its PDF pages: where each clip was
+ * cut, and the slide it is on. The outline takes no pointer events (the page stays selectable);
+ * its label goes to that slide in the presentation.
+ */
+import type { PdfClipOutline } from './clipOutlines';
+export interface PdfClipOutlinesProps {
+    outlines: readonly PdfClipOutline[];
+    onShow: (outline: PdfClipOutline) => void;
+}
+export declare function PdfClipOutlines({ outlines, onShow }: PdfClipOutlinesProps): import("react").JSX.Element;

package/dist/connection/viewer/pdf/PdfClipOutlines.js

@@ -0,0 +1,42 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Presentation } from "lucide-react";
+function PdfClipOutlines({ outlines, onShow }) {
+  return /* @__PURE__ */ jsx("div", { className: "pointer-events-none absolute inset-0", "data-testid": "pdf-clip-outlines", children: outlines.map((outline) => {
+    const { rect } = outline;
+    const label = outline.slides.length ? `Slide ${outline.slides.map((index) => index + 1).join(", ")}` : "In the tray";
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: "absolute rounded-sm border-2 border-dashed border-primary/70",
+        style: {
+          left: `${rect.x * 100}%`,
+          top: `${rect.y * 100}%`,
+          width: `${rect.w * 100}%`,
+          height: `${rect.h * 100}%`
+        },
+        "data-testid": "pdf-clip-outline",
+        "data-clip-id": outline.clipId,
+        children: /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            className: "pointer-events-auto absolute -top-2.5 left-1 inline-flex items-center gap-1 rounded-full bg-primary px-1.5 text-[10px] font-medium leading-4 text-primary-foreground shadow-sm hover:bg-primary/90",
+            title: outline.slides.length ? `Clipped for the presentation: go to ${label.toLowerCase()}` : "Clipped for the presentation: not on a slide yet",
+            onClick: () => onShow(outline),
+            "data-testid": "pdf-clip-outline-label",
+            children: [
+              /* @__PURE__ */ jsx(Presentation, { className: "size-2.5" }),
+              label
+            ]
+          }
+        )
+      },
+      outline.clipId
+    );
+  }) });
+}
+export {
+  PdfClipOutlines
+};
+//# sourceMappingURL=PdfClipOutlines.js.map

package/dist/connection/viewer/pdf/PdfClipOutlines.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/connection/viewer/pdf/PdfClipOutlines.tsx"],
+  "sourcesContent": ["/**\n * The open presentation's clips of this document, outlined on its PDF pages: where each clip was\n * cut, and the slide it is on. The outline takes no pointer events (the page stays selectable);\n * its label goes to that slide in the presentation.\n */\n\nimport { Presentation } from 'lucide-react'\nimport type { PdfClipOutline } from './clipOutlines'\n\nexport interface PdfClipOutlinesProps {\n  outlines: readonly PdfClipOutline[]\n  onShow: (outline: PdfClipOutline) => void\n}\n\nexport function PdfClipOutlines({ outlines, onShow }: PdfClipOutlinesProps) {\n  return (\n    <div className=\"pointer-events-none absolute inset-0\" data-testid=\"pdf-clip-outlines\">\n      {outlines.map((outline) => {\n        const { rect } = outline\n        const label = outline.slides.length\n          ? `Slide ${outline.slides.map((index) => index + 1).join(', ')}`\n          : 'In the tray'\n        return (\n          <div\n            key={outline.clipId}\n            className=\"absolute rounded-sm border-2 border-dashed border-primary/70\"\n            style={{\n              left: `${rect.x * 100}%`,\n              top: `${rect.y * 100}%`,\n              width: `${rect.w * 100}%`,\n              height: `${rect.h * 100}%`,\n            }}\n            data-testid=\"pdf-clip-outline\"\n            data-clip-id={outline.clipId}\n          >\n            <button\n              type=\"button\"\n              className=\"pointer-events-auto absolute -top-2.5 left-1 inline-flex items-center gap-1 rounded-full bg-primary px-1.5 text-[10px] font-medium leading-4 text-primary-foreground shadow-sm hover:bg-primary/90\"\n              title={\n                outline.slides.length\n                  ? `Clipped for the presentation: go to ${label.toLowerCase()}`\n                  : 'Clipped for the presentation: not on a slide yet'\n              }\n              onClick={() => onShow(outline)}\n              data-testid=\"pdf-clip-outline-label\"\n            >\n              <Presentation className=\"size-2.5\" />\n              {label}\n            </button>\n          </div>\n        )\n      })}\n    </div>\n  )\n}\n"],
+  "mappings": ";AAmCY,SAWE,KAXF;AA7BZ,SAAS,oBAAoB;AAQtB,SAAS,gBAAgB,EAAE,UAAU,OAAO,GAAyB;AAC1E,SACE,oBAAC,SAAI,WAAU,wCAAuC,eAAY,qBAC/D,mBAAS,IAAI,CAAC,YAAY;AACzB,UAAM,EAAE,KAAK,IAAI;AACjB,UAAM,QAAQ,QAAQ,OAAO,SACzB,SAAS,QAAQ,OAAO,IAAI,CAAC,UAAU,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,KAC5D;AACJ,WACE;AAAA,MAAC;AAAA;AAAA,QAEC,WAAU;AAAA,QACV,OAAO;AAAA,UACL,MAAM,GAAG,KAAK,IAAI,GAAG;AAAA,UACrB,KAAK,GAAG,KAAK,IAAI,GAAG;AAAA,UACpB,OAAO,GAAG,KAAK,IAAI,GAAG;AAAA,UACtB,QAAQ,GAAG,KAAK,IAAI,GAAG;AAAA,QACzB;AAAA,QACA,eAAY;AAAA,QACZ,gBAAc,QAAQ;AAAA,QAEtB;AAAA,UAAC;AAAA;AAAA,YACC,MAAK;AAAA,YACL,WAAU;AAAA,YACV,OACE,QAAQ,OAAO,SACX,uCAAuC,MAAM,YAAY,CAAC,KAC1D;AAAA,YAEN,SAAS,MAAM,OAAO,OAAO;AAAA,YAC7B,eAAY;AAAA,YAEZ;AAAA,kCAAC,gBAAa,WAAU,YAAW;AAAA,cAClC;AAAA;AAAA;AAAA,QACH;AAAA;AAAA,MAxBK,QAAQ;AAAA,IAyBf;AAAA,EAEJ,CAAC,GACH;AAEJ;",
+  "names": []
+}

package/dist/connection/viewer/pdf/clipOutlines.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Which of the open presentation's clips were cut from a document's pages, and the slides each is
+ * on: what the PDF outlines (`PdfClipOutlines`).
+ */
+import type { Clip, Rect, Slide } from '../../../presentation/model';
+export interface PdfClipOutline {
+    clipId: string;
+    /** The clipped area, as fractions of the page. */
+    rect: Rect;
+    /** The slides (indexes) it is on; none while it waits in the tray. */
+    slides: number[];
+}
+/**
+ * The page clips of the document `viewingId` names, by page number. A clip of another version of
+ * it is left out when a version is viewed; the parts of a slide's design (`plain`) are left out.
+ */
+export declare function clipOutlinesByPage(viewingId: string | null | undefined, clips: readonly Clip[], slides: readonly Pick<Slide, 'items'>[]): Map<number, PdfClipOutline[]>;

package/dist/connection/viewer/pdf/clipOutlines.js

@@ -0,0 +1,24 @@
+"use client";
+function parseRef(id) {
+  const match = /^(.*)@v(\d+)$/.exec(id);
+  return match ? { documentId: match[1], version: Number(match[2]) } : { documentId: id, version: null };
+}
+function clipOutlinesByPage(viewingId, clips, slides) {
+  const byPage = /* @__PURE__ */ new Map();
+  if (!viewingId) return byPage;
+  const { documentId, version } = parseRef(viewingId);
+  for (const clip of clips) {
+    if (clip.kind !== "pdf" || clip.plain || clip.documentId !== documentId) continue;
+    if (version !== null && clip.version !== void 0 && clip.version !== version) continue;
+    const on = slides.flatMap(
+      (slide, index) => slide.items.some((item) => item.clipId === clip.id) ? [index] : []
+    );
+    const outline = { clipId: clip.id, rect: clip.rect, slides: on };
+    byPage.set(clip.page, [...byPage.get(clip.page) ?? [], outline]);
+  }
+  return byPage;
+}
+export {
+  clipOutlinesByPage
+};
+//# sourceMappingURL=clipOutlines.js.map

package/dist/connection/viewer/pdf/clipOutlines.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/connection/viewer/pdf/clipOutlines.ts"],
+  "sourcesContent": ["/**\n * Which of the open presentation's clips were cut from a document's pages, and the slides each is\n * on: what the PDF outlines (`PdfClipOutlines`).\n */\n\nimport type { Clip, Rect, Slide } from '../../../presentation/model'\n\nexport interface PdfClipOutline {\n  clipId: string\n  /** The clipped area, as fractions of the page. */\n  rect: Rect\n  /** The slides (indexes) it is on; none while it waits in the tray. */\n  slides: number[]\n}\n\n/** The document a viewer id names, and its version (`doc-\u2026@v{n}`), if one. */\nfunction parseRef(id: string): { documentId: string; version: number | null } {\n  const match = /^(.*)@v(\\d+)$/.exec(id)\n  return match\n    ? { documentId: match[1], version: Number(match[2]) }\n    : { documentId: id, version: null }\n}\n\n/**\n * The page clips of the document `viewingId` names, by page number. A clip of another version of\n * it is left out when a version is viewed; the parts of a slide's design (`plain`) are left out.\n */\nexport function clipOutlinesByPage(\n  viewingId: string | null | undefined,\n  clips: readonly Clip[],\n  slides: readonly Pick<Slide, 'items'>[]\n): Map<number, PdfClipOutline[]> {\n  const byPage = new Map<number, PdfClipOutline[]>()\n  if (!viewingId) return byPage\n  const { documentId, version } = parseRef(viewingId)\n  for (const clip of clips) {\n    if (clip.kind !== 'pdf' || clip.plain || clip.documentId !== documentId) continue\n    if (version !== null && clip.version !== undefined && clip.version !== version) continue\n    const on = slides.flatMap((slide, index) =>\n      slide.items.some((item) => item.clipId === clip.id) ? [index] : []\n    )\n    const outline = { clipId: clip.id, rect: clip.rect, slides: on }\n    byPage.set(clip.page, [...(byPage.get(clip.page) ?? []), outline])\n  }\n  return byPage\n}\n"],
+  "mappings": ";AAgBA,SAAS,SAAS,IAA4D;AAC5E,QAAM,QAAQ,gBAAgB,KAAK,EAAE;AACrC,SAAO,QACH,EAAE,YAAY,MAAM,CAAC,GAAG,SAAS,OAAO,MAAM,CAAC,CAAC,EAAE,IAClD,EAAE,YAAY,IAAI,SAAS,KAAK;AACtC;AAMO,SAAS,mBACd,WACA,OACA,QAC+B;AAC/B,QAAM,SAAS,oBAAI,IAA8B;AACjD,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,EAAE,YAAY,QAAQ,IAAI,SAAS,SAAS;AAClD,aAAW,QAAQ,OAAO;AACxB,QAAI,KAAK,SAAS,SAAS,KAAK,SAAS,KAAK,eAAe,WAAY;AACzE,QAAI,YAAY,QAAQ,KAAK,YAAY,UAAa,KAAK,YAAY,QAAS;AAChF,UAAM,KAAK,OAAO;AAAA,MAAQ,CAAC,OAAO,UAChC,MAAM,MAAM,KAAK,CAAC,SAAS,KAAK,WAAW,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;AAAA,IACnE;AACA,UAAM,UAAU,EAAE,QAAQ,KAAK,IAAI,MAAM,KAAK,MAAM,QAAQ,GAAG;AAC/D,WAAO,IAAI,KAAK,MAAM,CAAC,GAAI,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC,GAAI,OAAO,CAAC;AAAA,EACnE;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/connection/viewer/pdf/passageHighlights.d.ts

@@ -22,5 +22,7 @@ export interface PassageHighlightState {
 }
 /** How a passage is lit, or null when it is not. */
 export declare function passageHighlight(chunkId: string, { cited, active }: PassageHighlightState): PassageHighlight | null;
+/** The passage has a box on its page to light (not none, nor the whole page). */
+export declare function passagePlaced(pages: readonly ProcessedPage[], chunkId: string): boolean;
 /** The lit passages' boxes, by page number. Passages without a usable box are left out. */
 export declare function passageBoxesByPage(pages: readonly ProcessedPage[], state: PassageHighlightState): Map<number, PdfPassageBox[]>;

package/dist/connection/viewer/pdf/passageHighlights.js

@@ -15,6 +15,16 @@ function asBox(bbox) {
 function isWholePage([x0, y0, x1, y1]) {
   return x0 <= 0 && y0 <= 0 && x1 >= 1 && y1 >= 1;
 }
+function passagePlaced(pages, chunkId) {
+  for (const page of pages) {
+    const chunk = page.chunks.find((entry) => entry.chunkExtId === chunkId);
+    if (chunk) {
+      const box = asBox(chunk.pageBbox);
+      return !!box && !isWholePage(box);
+    }
+  }
+  return false;
+}
 function passageBoxesByPage(pages, state) {
   const byPage = /* @__PURE__ */ new Map();
   if (state.cited.size === 0 && !state.active) return byPage;
@@ -35,6 +45,7 @@ function passageBoxesByPage(pages, state) {
 }
 export {
   passageBoxesByPage,
-  passageHighlight
+  passageHighlight,
+  passagePlaced
 };
 //# sourceMappingURL=passageHighlights.js.map

package/dist/connection/viewer/pdf/passageHighlights.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/connection/viewer/pdf/passageHighlights.ts"],
-  "sourcesContent": ["/**\n * Which passages light up on the PDF, and where. The rules are the parsed view's (`ParsedPassage`):\n * while a fact's Citation popover is open its cited passages are light and the one being read is\n * strong; otherwise the passage a citation opened the document at is the one lit. A passage's box\n * is the parser's (`page_bbox`: fractions of its page, top-left origin), so it lands on the page\n * at any zoom.\n */\n\nimport type { ProcessedPage } from '@arbidocs/react/viewers'\nimport type { PassageHighlight } from '../../../files'\n\n/** [x0, y0, x1, y1] as fractions of the page. */\nexport type PageBox = readonly [number, number, number, number]\n\nexport interface PdfPassageBox {\n  chunkId: string\n  box: PageBox\n  highlight: PassageHighlight\n}\n\nexport interface PassageHighlightState {\n  /** A fact's cited passages (its Citation popover is open); empty when none is. */\n  cited: ReadonlySet<string>\n  /** The passage being read: the one a citation opened the document at. */\n  active: string | null\n}\n\n/** How a passage is lit, or null when it is not. */\nexport function passageHighlight(\n  chunkId: string,\n  { cited, active }: PassageHighlightState\n): PassageHighlight | null {\n  if (cited.size > 0) {\n    if (!cited.has(chunkId)) return null\n    return chunkId === active ? 'strong' : 'light'\n  }\n  return chunkId === active ? 'light' : null\n}\n\n/** A drawable box: four finite fractions with area. */\nfunction asBox(bbox: readonly number[] | undefined): PageBox | null {\n  if (!bbox || bbox.length !== 4 || !bbox.every(Number.isFinite)) return null\n  const [x0, y0, x1, y1] = bbox\n  if (x1 <= x0 || y1 <= y0) return null\n  return [x0, y0, x1, y1]\n}\n\n/**\n * The page's whole area: what the parser gives a chunk on a page where it recognized no block to\n * place it by. It says \"this page\", and a rectangle over the whole page would say nothing more.\n */\nfunction isWholePage([x0, y0, x1, y1]: PageBox): boolean {\n  return x0 <= 0 && y0 <= 0 && x1 >= 1 && y1 >= 1\n}\n\n/** The lit passages' boxes, by page number. Passages without a usable box are left out. */\nexport function passageBoxesByPage(\n  pages: readonly ProcessedPage[],\n  state: PassageHighlightState\n): Map<number, PdfPassageBox[]> {\n  const byPage = new Map<number, PdfPassageBox[]>()\n  if (state.cited.size === 0 && !state.active) return byPage\n  for (const page of pages) {\n    if (page.pageNumber === null) continue\n    for (const chunk of page.chunks) {\n      const chunkId = chunk.chunkExtId\n      if (!chunkId) continue\n      const highlight = passageHighlight(chunkId, state)\n      const box = highlight && asBox(chunk.pageBbox)\n      if (!highlight || !box || isWholePage(box)) continue\n      const boxes = byPage.get(page.pageNumber) ?? []\n      boxes.push({ chunkId, box, highlight })\n      byPage.set(page.pageNumber, boxes)\n    }\n  }\n  return byPage\n}\n"],
-  "mappings": ";AA4BO,SAAS,iBACd,SACA,EAAE,OAAO,OAAO,GACS;AACzB,MAAI,MAAM,OAAO,GAAG;AAClB,QAAI,CAAC,MAAM,IAAI,OAAO,EAAG,QAAO;AAChC,WAAO,YAAY,SAAS,WAAW;AAAA,EACzC;AACA,SAAO,YAAY,SAAS,UAAU;AACxC;AAGA,SAAS,MAAM,MAAqD;AAClE,MAAI,CAAC,QAAQ,KAAK,WAAW,KAAK,CAAC,KAAK,MAAM,OAAO,QAAQ,EAAG,QAAO;AACvE,QAAM,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI;AACzB,MAAI,MAAM,MAAM,MAAM,GAAI,QAAO;AACjC,SAAO,CAAC,IAAI,IAAI,IAAI,EAAE;AACxB;AAMA,SAAS,YAAY,CAAC,IAAI,IAAI,IAAI,EAAE,GAAqB;AACvD,SAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM;AAChD;AAGO,SAAS,mBACd,OACA,OAC8B;AAC9B,QAAM,SAAS,oBAAI,IAA6B;AAChD,MAAI,MAAM,MAAM,SAAS,KAAK,CAAC,MAAM,OAAQ,QAAO;AACpD,aAAW,QAAQ,OAAO;AACxB,QAAI,KAAK,eAAe,KAAM;AAC9B,eAAW,SAAS,KAAK,QAAQ;AAC/B,YAAM,UAAU,MAAM;AACtB,UAAI,CAAC,QAAS;AACd,YAAM,YAAY,iBAAiB,SAAS,KAAK;AACjD,YAAM,MAAM,aAAa,MAAM,MAAM,QAAQ;AAC7C,UAAI,CAAC,aAAa,CAAC,OAAO,YAAY,GAAG,EAAG;AAC5C,YAAM,QAAQ,OAAO,IAAI,KAAK,UAAU,KAAK,CAAC;AAC9C,YAAM,KAAK,EAAE,SAAS,KAAK,UAAU,CAAC;AACtC,aAAO,IAAI,KAAK,YAAY,KAAK;AAAA,IACnC;AAAA,EACF;AACA,SAAO;AACT;",
+  "sourcesContent": ["/**\n * Which passages light up on the PDF, and where. The rules are the parsed view's (`ParsedPassage`):\n * while a fact's Citation popover is open its cited passages are light and the one being read is\n * strong; otherwise the passage a citation opened the document at is the one lit. A passage's box\n * is the parser's (`page_bbox`: fractions of its page, top-left origin), so it lands on the page\n * at any zoom.\n */\n\nimport type { ProcessedPage } from '@arbidocs/react/viewers'\nimport type { PassageHighlight } from '../../../files'\n\n/** [x0, y0, x1, y1] as fractions of the page. */\nexport type PageBox = readonly [number, number, number, number]\n\nexport interface PdfPassageBox {\n  chunkId: string\n  box: PageBox\n  highlight: PassageHighlight\n}\n\nexport interface PassageHighlightState {\n  /** A fact's cited passages (its Citation popover is open); empty when none is. */\n  cited: ReadonlySet<string>\n  /** The passage being read: the one a citation opened the document at. */\n  active: string | null\n}\n\n/** How a passage is lit, or null when it is not. */\nexport function passageHighlight(\n  chunkId: string,\n  { cited, active }: PassageHighlightState\n): PassageHighlight | null {\n  if (cited.size > 0) {\n    if (!cited.has(chunkId)) return null\n    return chunkId === active ? 'strong' : 'light'\n  }\n  return chunkId === active ? 'light' : null\n}\n\n/** A drawable box: four finite fractions with area. */\nfunction asBox(bbox: readonly number[] | undefined): PageBox | null {\n  if (!bbox || bbox.length !== 4 || !bbox.every(Number.isFinite)) return null\n  const [x0, y0, x1, y1] = bbox\n  if (x1 <= x0 || y1 <= y0) return null\n  return [x0, y0, x1, y1]\n}\n\n/**\n * The page's whole area: what the parser gives a chunk on a page where it recognized no block to\n * place it by. It says \"this page\", and a rectangle over the whole page would say nothing more.\n */\nfunction isWholePage([x0, y0, x1, y1]: PageBox): boolean {\n  return x0 <= 0 && y0 <= 0 && x1 >= 1 && y1 >= 1\n}\n\n/** The passage has a box on its page to light (not none, nor the whole page). */\nexport function passagePlaced(pages: readonly ProcessedPage[], chunkId: string): boolean {\n  for (const page of pages) {\n    const chunk = page.chunks.find((entry) => entry.chunkExtId === chunkId)\n    if (chunk) {\n      const box = asBox(chunk.pageBbox)\n      return !!box && !isWholePage(box)\n    }\n  }\n  return false\n}\n\n/** The lit passages' boxes, by page number. Passages without a usable box are left out. */\nexport function passageBoxesByPage(\n  pages: readonly ProcessedPage[],\n  state: PassageHighlightState\n): Map<number, PdfPassageBox[]> {\n  const byPage = new Map<number, PdfPassageBox[]>()\n  if (state.cited.size === 0 && !state.active) return byPage\n  for (const page of pages) {\n    if (page.pageNumber === null) continue\n    for (const chunk of page.chunks) {\n      const chunkId = chunk.chunkExtId\n      if (!chunkId) continue\n      const highlight = passageHighlight(chunkId, state)\n      const box = highlight && asBox(chunk.pageBbox)\n      if (!highlight || !box || isWholePage(box)) continue\n      const boxes = byPage.get(page.pageNumber) ?? []\n      boxes.push({ chunkId, box, highlight })\n      byPage.set(page.pageNumber, boxes)\n    }\n  }\n  return byPage\n}\n"],
+  "mappings": ";AA4BO,SAAS,iBACd,SACA,EAAE,OAAO,OAAO,GACS;AACzB,MAAI,MAAM,OAAO,GAAG;AAClB,QAAI,CAAC,MAAM,IAAI,OAAO,EAAG,QAAO;AAChC,WAAO,YAAY,SAAS,WAAW;AAAA,EACzC;AACA,SAAO,YAAY,SAAS,UAAU;AACxC;AAGA,SAAS,MAAM,MAAqD;AAClE,MAAI,CAAC,QAAQ,KAAK,WAAW,KAAK,CAAC,KAAK,MAAM,OAAO,QAAQ,EAAG,QAAO;AACvE,QAAM,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI;AACzB,MAAI,MAAM,MAAM,MAAM,GAAI,QAAO;AACjC,SAAO,CAAC,IAAI,IAAI,IAAI,EAAE;AACxB;AAMA,SAAS,YAAY,CAAC,IAAI,IAAI,IAAI,EAAE,GAAqB;AACvD,SAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM;AAChD;AAGO,SAAS,cAAc,OAAiC,SAA0B;AACvF,aAAW,QAAQ,OAAO;AACxB,UAAM,QAAQ,KAAK,OAAO,KAAK,CAAC,UAAU,MAAM,eAAe,OAAO;AACtE,QAAI,OAAO;AACT,YAAM,MAAM,MAAM,MAAM,QAAQ;AAChC,aAAO,CAAC,CAAC,OAAO,CAAC,YAAY,GAAG;AAAA,IAClC;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,mBACd,OACA,OAC8B;AAC9B,QAAM,SAAS,oBAAI,IAA6B;AAChD,MAAI,MAAM,MAAM,SAAS,KAAK,CAAC,MAAM,OAAQ,QAAO;AACpD,aAAW,QAAQ,OAAO;AACxB,QAAI,KAAK,eAAe,KAAM;AAC9B,eAAW,SAAS,KAAK,QAAQ;AAC/B,YAAM,UAAU,MAAM;AACtB,UAAI,CAAC,QAAS;AACd,YAAM,YAAY,iBAAiB,SAAS,KAAK;AACjD,YAAM,MAAM,aAAa,MAAM,MAAM,QAAQ;AAC7C,UAAI,CAAC,aAAa,CAAC,OAAO,YAAY,GAAG,EAAG;AAC5C,YAAM,QAAQ,OAAO,IAAI,KAAK,UAAU,KAAK,CAAC;AAC9C,YAAM,KAAK,EAAE,SAAS,KAAK,UAAU,CAAC;AACtC,aAAO,IAAI,KAAK,YAAY,KAAK;AAAA,IACnC;AAAA,EACF;AACA,SAAO;AACT;",
   "names": []
 }

package/dist/connection/viewer/pdf/usePdfClipOutlines.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The open presentation's clips of the viewed document, outlined over its PDF pages
+ * (`clipOutlinesByPage`); a label goes to the clip's slide in the presentation.
+ */
+import { type ReactNode } from 'react';
+/** A PDF viewer's page overlay: `(page) => outlines | null`. */
+export declare function usePdfClipOutlines(viewingId: string | null | undefined): (pageNumber: number) => ReactNode;

package/dist/connection/viewer/pdf/usePdfClipOutlines.js

@@ -0,0 +1,36 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useCallback, useMemo } from "react";
+import { useArbiSessionStore } from "@arbidocs/react";
+import { usePresentation } from "../../../presentation/store.js";
+import { showPresentation } from "../../presentation/requests.js";
+import { PdfClipOutlines } from "./PdfClipOutlines.js";
+import { clipOutlinesByPage } from "./clipOutlines.js";
+function usePdfClipOutlines(viewingId) {
+  const session = useArbiSessionStore();
+  const clips = usePresentation((s) => s.clips);
+  const slides = usePresentation((s) => s.slides);
+  const byPage = useMemo(
+    () => clipOutlinesByPage(viewingId, clips, slides),
+    [viewingId, clips, slides]
+  );
+  const show = useCallback(
+    (outline) => {
+      const state = usePresentation.getState();
+      if (outline.slides.length) state.goTo(outline.slides[0]);
+      showPresentation(session, state.boundTo);
+    },
+    [session]
+  );
+  return useCallback(
+    (pageNumber) => {
+      const outlines = byPage.get(pageNumber);
+      return outlines ? /* @__PURE__ */ jsx(PdfClipOutlines, { outlines, onShow: show }) : null;
+    },
+    [byPage, show]
+  );
+}
+export {
+  usePdfClipOutlines
+};
+//# sourceMappingURL=usePdfClipOutlines.js.map

package/dist/connection/viewer/pdf/usePdfClipOutlines.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/connection/viewer/pdf/usePdfClipOutlines.tsx"],
+  "sourcesContent": ["/**\n * The open presentation's clips of the viewed document, outlined over its PDF pages\n * (`clipOutlinesByPage`); a label goes to the clip's slide in the presentation.\n */\n\nimport { useCallback, useMemo, type ReactNode } from 'react'\nimport { useArbiSessionStore } from '@arbidocs/react'\nimport { usePresentation } from '../../../presentation/store'\nimport { showPresentation } from '../../presentation/requests'\nimport { PdfClipOutlines } from './PdfClipOutlines'\nimport { clipOutlinesByPage, type PdfClipOutline } from './clipOutlines'\n\n/** A PDF viewer's page overlay: `(page) => outlines | null`. */\nexport function usePdfClipOutlines(\n  viewingId: string | null | undefined\n): (pageNumber: number) => ReactNode {\n  const session = useArbiSessionStore()\n  const clips = usePresentation((s) => s.clips)\n  const slides = usePresentation((s) => s.slides)\n  const byPage = useMemo(\n    () => clipOutlinesByPage(viewingId, clips, slides),\n    [viewingId, clips, slides]\n  )\n  const show = useCallback(\n    (outline: PdfClipOutline) => {\n      const state = usePresentation.getState()\n      if (outline.slides.length) state.goTo(outline.slides[0])\n      showPresentation(session, state.boundTo)\n    },\n    [session]\n  )\n  return useCallback(\n    (pageNumber: number) => {\n      const outlines = byPage.get(pageNumber)\n      return outlines ? <PdfClipOutlines outlines={outlines} onShow={show} /> : null\n    },\n    [byPage, show]\n  )\n}\n"],
+  "mappings": ";AAkCwB;AA7BxB,SAAS,aAAa,eAA+B;AACrD,SAAS,2BAA2B;AACpC,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAChC,SAAS,0BAA+C;AAGjD,SAAS,mBACd,WACmC;AACnC,QAAM,UAAU,oBAAoB;AACpC,QAAM,QAAQ,gBAAgB,CAAC,MAAM,EAAE,KAAK;AAC5C,QAAM,SAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM;AAC9C,QAAM,SAAS;AAAA,IACb,MAAM,mBAAmB,WAAW,OAAO,MAAM;AAAA,IACjD,CAAC,WAAW,OAAO,MAAM;AAAA,EAC3B;AACA,QAAM,OAAO;AAAA,IACX,CAAC,YAA4B;AAC3B,YAAM,QAAQ,gBAAgB,SAAS;AACvC,UAAI,QAAQ,OAAO,OAAQ,OAAM,KAAK,QAAQ,OAAO,CAAC,CAAC;AACvD,uBAAiB,SAAS,MAAM,OAAO;AAAA,IACzC;AAAA,IACA,CAAC,OAAO;AAAA,EACV;AACA,SAAO;AAAA,IACL,CAAC,eAAuB;AACtB,YAAM,WAAW,OAAO,IAAI,UAAU;AACtC,aAAO,WAAW,oBAAC,mBAAgB,UAAoB,QAAQ,MAAM,IAAK;AAAA,IAC5E;AAAA,IACA,CAAC,QAAQ,IAAI;AAAA,EACf;AACF;",
+  "names": []
+}

package/dist/connection/viewer/pdf/usePdfPassageHighlights.js

@@ -1,11 +1,11 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef } from "react";
-import { useArbiSessionState, useParsedDocument } from "@arbidocs/react";
+import { useArbiSessionState, useArbiSessionStore, useParsedDocument } from "@arbidocs/react";
 import { useProcessedChunks } from "@arbidocs/react/viewers";
 import { useViewerPassageCitation } from "../support.js";
 import { PdfPassageHighlights } from "./PdfPassageHighlights.js";
-import { passageBoxesByPage } from "./passageHighlights.js";
+import { passageBoxesByPage, passagePlaced } from "./passageHighlights.js";
 const NONE = [];
 const NO_FOOTNOTES = {};
 function usePdfPassageHighlights(documentId) {
@@ -20,6 +20,15 @@ function usePdfPassageHighlights(documentId) {
     () => passageBoxesByPage(processedChunks, { cited, active }),
     [processedChunks, cited, active]
   );
+  const session = useArbiSessionStore();
+  const fellBackFor = useRef(null);
+  useEffect(() => {
+    if (!active || !parsed || !documentId) return;
+    const key = `${documentId}:${active}`;
+    if (fellBackFor.current === key || passagePlaced(processedChunks, active)) return;
+    fellBackFor.current = key;
+    session.setDocumentViewer({ tab: "html" });
+  }, [active, parsed, processedChunks, documentId, session]);
   const centredFor = useRef(null);
   const activeKey = active ? `${documentId}:${active}` : null;
   useEffect(() => {

package/dist/connection/viewer/pdf/usePdfPassageHighlights.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/connection/viewer/pdf/usePdfPassageHighlights.tsx"],
-  "sourcesContent": ["/**\n * The passages a citation lights, drawn over the PDF page by page: a fact's cited passages (its\n * Citation popover is open) and the passage a citation opened the document at, as the parsed view\n * lights them. Nothing is fetched until one is lit; the parsed chunks are the parsed view's own\n * query, so opening that tab afterwards costs nothing more.\n */\n\nimport { useCallback, useEffect, useMemo, useRef, type ReactNode } from 'react'\nimport { useArbiSessionState, useParsedDocument } from '@arbidocs/react'\nimport { useProcessedChunks } from '@arbidocs/react/viewers'\nimport { useViewerPassageCitation } from '../support'\nimport { PdfPassageHighlights } from './PdfPassageHighlights'\nimport { passageBoxesByPage } from './passageHighlights'\n\nconst NONE: readonly string[] = []\nconst NO_FOOTNOTES: Record<string, string> = {}\n\n/** A PDF viewer's page overlay for the document being viewed: `(page) => highlights | null`. */\nexport function usePdfPassageHighlights(\n  documentId: string | undefined\n): (pageNumber: number) => ReactNode {\n  const citedIds = useViewerPassageCitation()?.highlighted ?? NONE\n  const cited = useMemo(() => new Set(citedIds), [citedIds])\n  const active = useArbiSessionState((s) => s.viewingDocument?.passageId ?? null)\n\n  const { data: parsed } = useParsedDocument(documentId, 'final', {\n    enabled: cited.size > 0 || !!active,\n  })\n  const { processedChunks } = useProcessedChunks(parsed?.chunks, NO_FOOTNOTES)\n  const boxesByPage = useMemo(\n    () => passageBoxesByPage(processedChunks, { cited, active }),\n    [processedChunks, cited, active]\n  )\n\n  // The passage being read is brought into view once, when its page first draws it: the viewer\n  // opens the page, this centres the passage on it, and scrolling away is then left alone.\n  const centredFor = useRef<string | null>(null)\n  const activeKey = active ? `${documentId}:${active}` : null\n  useEffect(() => {\n    if (!activeKey) centredFor.current = null\n  }, [activeKey])\n  const centre = useCallback(\n    (element: HTMLElement) => {\n      if (!activeKey || centredFor.current === activeKey) return\n      centredFor.current = activeKey\n      element.scrollIntoView?.({ block: 'center', behavior: 'smooth' })\n    },\n    [activeKey]\n  )\n\n  return useCallback(\n    (pageNumber: number) => {\n      const boxes = boxesByPage.get(pageNumber)\n      return boxes ? (\n        <PdfPassageHighlights boxes={boxes} activeId={active} onActiveDrawn={centre} />\n      ) : null\n    },\n    [boxesByPage, active, centre]\n  )\n}\n"],
-  "mappings": ";AAsDQ;AA/CR,SAAS,aAAa,WAAW,SAAS,cAA8B;AACxE,SAAS,qBAAqB,yBAAyB;AACvD,SAAS,0BAA0B;AACnC,SAAS,gCAAgC;AACzC,SAAS,4BAA4B;AACrC,SAAS,0BAA0B;AAEnC,MAAM,OAA0B,CAAC;AACjC,MAAM,eAAuC,CAAC;AAGvC,SAAS,wBACd,YACmC;AACnC,QAAM,WAAW,yBAAyB,GAAG,eAAe;AAC5D,QAAM,QAAQ,QAAQ,MAAM,IAAI,IAAI,QAAQ,GAAG,CAAC,QAAQ,CAAC;AACzD,QAAM,SAAS,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,aAAa,IAAI;AAE9E,QAAM,EAAE,MAAM,OAAO,IAAI,kBAAkB,YAAY,SAAS;AAAA,IAC9D,SAAS,MAAM,OAAO,KAAK,CAAC,CAAC;AAAA,EAC/B,CAAC;AACD,QAAM,EAAE,gBAAgB,IAAI,mBAAmB,QAAQ,QAAQ,YAAY;AAC3E,QAAM,cAAc;AAAA,IAClB,MAAM,mBAAmB,iBAAiB,EAAE,OAAO,OAAO,CAAC;AAAA,IAC3D,CAAC,iBAAiB,OAAO,MAAM;AAAA,EACjC;AAIA,QAAM,aAAa,OAAsB,IAAI;AAC7C,QAAM,YAAY,SAAS,GAAG,UAAU,IAAI,MAAM,KAAK;AACvD,YAAU,MAAM;AACd,QAAI,CAAC,UAAW,YAAW,UAAU;AAAA,EACvC,GAAG,CAAC,SAAS,CAAC;AACd,QAAM,SAAS;AAAA,IACb,CAAC,YAAyB;AACxB,UAAI,CAAC,aAAa,WAAW,YAAY,UAAW;AACpD,iBAAW,UAAU;AACrB,cAAQ,iBAAiB,EAAE,OAAO,UAAU,UAAU,SAAS,CAAC;AAAA,IAClE;AAAA,IACA,CAAC,SAAS;AAAA,EACZ;AAEA,SAAO;AAAA,IACL,CAAC,eAAuB;AACtB,YAAM,QAAQ,YAAY,IAAI,UAAU;AACxC,aAAO,QACL,oBAAC,wBAAqB,OAAc,UAAU,QAAQ,eAAe,QAAQ,IAC3E;AAAA,IACN;AAAA,IACA,CAAC,aAAa,QAAQ,MAAM;AAAA,EAC9B;AACF;",
+  "sourcesContent": ["/**\n * The passages a citation lights, drawn over the PDF page by page: a fact's cited passages (its\n * Citation popover is open) and the passage a citation opened the document at, as the parsed view\n * lights them. Nothing is fetched until one is lit; the parsed chunks are the parsed view's own\n * query, so opening that tab afterwards costs nothing more.\n */\n\nimport { useCallback, useEffect, useMemo, useRef, type ReactNode } from 'react'\nimport { useArbiSessionState, useArbiSessionStore, useParsedDocument } from '@arbidocs/react'\nimport { useProcessedChunks } from '@arbidocs/react/viewers'\nimport { useViewerPassageCitation } from '../support'\nimport { PdfPassageHighlights } from './PdfPassageHighlights'\nimport { passageBoxesByPage, passagePlaced } from './passageHighlights'\n\nconst NONE: readonly string[] = []\nconst NO_FOOTNOTES: Record<string, string> = {}\n\n/** A PDF viewer's page overlay for the document being viewed: `(page) => highlights | null`. */\nexport function usePdfPassageHighlights(\n  documentId: string | undefined\n): (pageNumber: number) => ReactNode {\n  const citedIds = useViewerPassageCitation()?.highlighted ?? NONE\n  const cited = useMemo(() => new Set(citedIds), [citedIds])\n  const active = useArbiSessionState((s) => s.viewingDocument?.passageId ?? null)\n\n  const { data: parsed } = useParsedDocument(documentId, 'final', {\n    enabled: cited.size > 0 || !!active,\n  })\n  const { processedChunks } = useProcessedChunks(parsed?.chunks, NO_FOOTNOTES)\n  const boxesByPage = useMemo(\n    () => passageBoxesByPage(processedChunks, { cited, active }),\n    [processedChunks, cited, active]\n  )\n\n  // The passage being read could not be placed on its page (a document parsed before passages had\n  // boxes): the text view marks it instead.\n  const session = useArbiSessionStore()\n  const fellBackFor = useRef<string | null>(null)\n  useEffect(() => {\n    if (!active || !parsed || !documentId) return\n    const key = `${documentId}:${active}`\n    if (fellBackFor.current === key || passagePlaced(processedChunks, active)) return\n    fellBackFor.current = key\n    session.setDocumentViewer({ tab: 'html' })\n  }, [active, parsed, processedChunks, documentId, session])\n\n  // The passage being read is brought into view once, when its page first draws it: the viewer\n  // opens the page, this centres the passage on it, and scrolling away is then left alone.\n  const centredFor = useRef<string | null>(null)\n  const activeKey = active ? `${documentId}:${active}` : null\n  useEffect(() => {\n    if (!activeKey) centredFor.current = null\n  }, [activeKey])\n  const centre = useCallback(\n    (element: HTMLElement) => {\n      if (!activeKey || centredFor.current === activeKey) return\n      centredFor.current = activeKey\n      element.scrollIntoView?.({ block: 'center', behavior: 'smooth' })\n    },\n    [activeKey]\n  )\n\n  return useCallback(\n    (pageNumber: number) => {\n      const boxes = boxesByPage.get(pageNumber)\n      return boxes ? (\n        <PdfPassageHighlights boxes={boxes} activeId={active} onActiveDrawn={centre} />\n      ) : null\n    },\n    [boxesByPage, active, centre]\n  )\n}\n"],
+  "mappings": ";AAkEQ;AA3DR,SAAS,aAAa,WAAW,SAAS,cAA8B;AACxE,SAAS,qBAAqB,qBAAqB,yBAAyB;AAC5E,SAAS,0BAA0B;AACnC,SAAS,gCAAgC;AACzC,SAAS,4BAA4B;AACrC,SAAS,oBAAoB,qBAAqB;AAElD,MAAM,OAA0B,CAAC;AACjC,MAAM,eAAuC,CAAC;AAGvC,SAAS,wBACd,YACmC;AACnC,QAAM,WAAW,yBAAyB,GAAG,eAAe;AAC5D,QAAM,QAAQ,QAAQ,MAAM,IAAI,IAAI,QAAQ,GAAG,CAAC,QAAQ,CAAC;AACzD,QAAM,SAAS,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,aAAa,IAAI;AAE9E,QAAM,EAAE,MAAM,OAAO,IAAI,kBAAkB,YAAY,SAAS;AAAA,IAC9D,SAAS,MAAM,OAAO,KAAK,CAAC,CAAC;AAAA,EAC/B,CAAC;AACD,QAAM,EAAE,gBAAgB,IAAI,mBAAmB,QAAQ,QAAQ,YAAY;AAC3E,QAAM,cAAc;AAAA,IAClB,MAAM,mBAAmB,iBAAiB,EAAE,OAAO,OAAO,CAAC;AAAA,IAC3D,CAAC,iBAAiB,OAAO,MAAM;AAAA,EACjC;AAIA,QAAM,UAAU,oBAAoB;AACpC,QAAM,cAAc,OAAsB,IAAI;AAC9C,YAAU,MAAM;AACd,QAAI,CAAC,UAAU,CAAC,UAAU,CAAC,WAAY;AACvC,UAAM,MAAM,GAAG,UAAU,IAAI,MAAM;AACnC,QAAI,YAAY,YAAY,OAAO,cAAc,iBAAiB,MAAM,EAAG;AAC3E,gBAAY,UAAU;AACtB,YAAQ,kBAAkB,EAAE,KAAK,OAAO,CAAC;AAAA,EAC3C,GAAG,CAAC,QAAQ,QAAQ,iBAAiB,YAAY,OAAO,CAAC;AAIzD,QAAM,aAAa,OAAsB,IAAI;AAC7C,QAAM,YAAY,SAAS,GAAG,UAAU,IAAI,MAAM,KAAK;AACvD,YAAU,MAAM;AACd,QAAI,CAAC,UAAW,YAAW,UAAU;AAAA,EACvC,GAAG,CAAC,SAAS,CAAC;AACd,QAAM,SAAS;AAAA,IACb,CAAC,YAAyB;AACxB,UAAI,CAAC,aAAa,WAAW,YAAY,UAAW;AACpD,iBAAW,UAAU;AACrB,cAAQ,iBAAiB,EAAE,OAAO,UAAU,UAAU,SAAS,CAAC;AAAA,IAClE;AAAA,IACA,CAAC,SAAS;AAAA,EACZ;AAEA,SAAO;AAAA,IACL,CAAC,eAAuB;AACtB,YAAM,QAAQ,YAAY,IAAI,UAAU;AACxC,aAAO,QACL,oBAAC,wBAAqB,OAAc,UAAU,QAAQ,eAAe,QAAQ,IAC3E;AAAA,IACN;AAAA,IACA,CAAC,aAAa,QAAQ,MAAM;AAAA,EAC9B;AACF;",
   "names": []
 }

package/dist/dashboards/index.cjs

@@ -10,8 +10,8 @@ require('../chunk-ZU2B2RZK.cjs');
 var chunkNSD37OF5_cjs = require('../chunk-NSD37OF5.cjs');
 var chunkOEJQFPWO_cjs = require('../chunk-OEJQFPWO.cjs');
 require('../chunk-JV5TVUOU.cjs');
-require('../chunk-IPSHAMO2.cjs');
 var chunkZW6FPIFC_cjs = require('../chunk-ZW6FPIFC.cjs');
+require('../chunk-IPSHAMO2.cjs');
 var chunkTKHCIHE2_cjs = require('../chunk-TKHCIHE2.cjs');
 require('../chunk-JDFBEGQO.cjs');
 require('../chunk-ULWRNGGE.cjs');