@drawnagency/primitives 0.1.100 → 0.1.102

package/dist/{chunk-GOCFTXR3.js → chunk-6SLGKRLW.js}

@@ -9,7 +9,7 @@ import {
   stripHtmlToPlainText,
   trimTrailingSpacers,
   truncate
-} from "./chunk-72FMQQIA.js";
+} from "./chunk-P3NNI3QI.js";
 import {
   DeleteButton,
   DragHandle,

package/dist/{chunk-72FMQQIA.js → chunk-P3NNI3QI.js}

@@ -14,12 +14,16 @@ import {
   AddIcon,
   DeleteIcon,
   DragHandle,
-  IconButton
+  IconButton,
+  useMediaLibrary
 } from "./chunk-26ALJO4K.js";
 import {
   DEFAULT_LINK,
   LinkValueSchema
 } from "./chunk-PZJL2S3Z.js";
+import {
+  DOCUMENT_MIME_TO_EXT
+} from "./chunk-BS5AQHZG.js";
 import {
   curatedIcons,
   getIcon
@@ -1299,10 +1303,61 @@ var DoDontMedia_default = defineSection({
 });
 
 // src/components/sections/Document/index.tsx
-import { useEffect as useEffect5, useState as useState6 } from "react";
+import { useEffect as useEffect5, useState as useState7 } from "react";
 import { z as z5 } from "zod";
 import { ExternalLink, FileText } from "lucide-react";
 
+// src/components/primitives/DocumentDropZone.tsx
+import { useState as useState6 } from "react";
+import { FileUp } from "lucide-react";
+import { jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";
+var isDocumentFile = (file) => file.type in DOCUMENT_MIME_TO_EXT;
+function DocumentDropZone({ onDocumentSelected, className }) {
+  const mediaLibrary = useMediaLibrary();
+  const [dragging, setDragging] = useState6(false);
+  const hasFiles = (e) => e.dataTransfer.types.includes("Files");
+  const handleDragOver = (e) => {
+    if (!hasFiles(e)) return;
+    e.preventDefault();
+    e.dataTransfer.dropEffect = "copy";
+    setDragging(true);
+  };
+  const handleDragLeave = (e) => {
+    if (!hasFiles(e)) return;
+    const related = e.relatedTarget;
+    if (related && e.currentTarget.contains(related)) return;
+    setDragging(false);
+  };
+  const handleDrop = (e) => {
+    if (!hasFiles(e)) return;
+    e.preventDefault();
+    e.stopPropagation();
+    setDragging(false);
+    const files = Array.from(e.dataTransfer.files);
+    if (files.length === 0) return;
+    void mediaLibrary?.uploadDocument?.(files.find(isDocumentFile) ?? files[0], onDocumentSelected);
+  };
+  return /* @__PURE__ */ jsxs9(
+    "button",
+    {
+      type: "button",
+      onClick: () => mediaLibrary?.openSelectModal(onDocumentSelected, { kinds: ["document"] }),
+      onDragOver: handleDragOver,
+      onDragLeave: handleDragLeave,
+      onDrop: handleDrop,
+      className: cn(
+        "flex w-full cursor-pointer items-center justify-center gap-2 rounded-outer border-2 border-dashed border-base-200 bg-base px-4 py-6 text-sm text-base-contrast-light transition-colors hover:border-base-300 hover:bg-base-accent hover:text-base-contrast",
+        dragging && "border-primary bg-primary/5 text-base-contrast",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx13(FileUp, { size: 18, "aria-hidden": "true", className: "shrink-0" }),
+        /* @__PURE__ */ jsx13("span", { children: "Drop a PDF or HTML file, or choose from the library" })
+      ]
+    }
+  );
+}
+
 // src/lib/container-ops.ts
 function getContainerChildren(block) {
   const content = block.content;
@@ -1377,6 +1432,8 @@ function formatDocSize(bytes) {
 
 // src/components/docfile/doc-file-state.ts
 var DOC_OPEN_CLASS = "bp-doc-open";
+var DOC_CLOSING_CLASS = "bp-doc-closing";
+var DOC_CLOSING_MS = 350;
 var DOC_DESKTOP_QUERY = "(min-width: 1024px)";
 var docFileOpenEvent = createEvent("bp-doc-file-open");
 var STORE_KEY = /* @__PURE__ */ Symbol.for("@drawnagency/primitives/doc-file-state");
@@ -1384,7 +1441,7 @@ var g = globalThis;
 function store() {
   let s = g[STORE_KEY];
   if (!s) {
-    s = { open: null, docs: null, openListeners: /* @__PURE__ */ new Set(), docsListeners: /* @__PURE__ */ new Set(), teardown: null };
+    s = { open: null, docs: null, openListeners: /* @__PURE__ */ new Set(), docsListeners: /* @__PURE__ */ new Set(), teardown: null, closingTimer: null };
     g[STORE_KEY] = s;
   }
   return s;
@@ -1396,9 +1453,23 @@ function isDocDesktop() {
 function apply(sectionId) {
   const s = store();
   if (s.open === sectionId) return;
+  const wasOpen = s.open !== null;
   s.open = sectionId;
   if (typeof document !== "undefined") {
-    document.documentElement.classList.toggle(DOC_OPEN_CLASS, sectionId !== null);
+    const root = document.documentElement;
+    root.classList.toggle(DOC_OPEN_CLASS, sectionId !== null);
+    if (s.closingTimer !== null) {
+      clearTimeout(s.closingTimer);
+      s.closingTimer = null;
+      root.classList.remove(DOC_CLOSING_CLASS);
+    }
+    if (sectionId === null && wasOpen) {
+      root.classList.add(DOC_CLOSING_CLASS);
+      s.closingTimer = setTimeout(() => {
+        root.classList.remove(DOC_CLOSING_CLASS);
+        s.closingTimer = null;
+      }, DOC_CLOSING_MS);
+    }
   }
   for (const listener of [...s.openListeners]) listener(sectionId);
 }
@@ -1424,7 +1495,7 @@ function subscribeSiteDocuments(cb) {
 }
 
 // src/components/sections/Document/index.tsx
-import { jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";
+import { jsx as jsx14, jsxs as jsxs10 } from "react/jsx-runtime";
 var schema4 = z5.object({
   type: z5.literal("document"),
   content: z5.object({
@@ -1441,7 +1512,7 @@ var schema4 = z5.object({
   options: z5.object({}).default({})
 });
 function useSiteDocument(sectionId) {
-  const [docs, setDocs] = useState6(null);
+  const [docs, setDocs] = useState7(null);
   useEffect5(() => {
     setDocs(getSiteDocuments());
     return subscribeSiteDocuments(setDocs);
@@ -1454,10 +1525,15 @@ function useSiteDocument(sectionId) {
 function DocumentRow({
   sectionId,
   title,
-  isEditMode
+  documentId = "",
+  isEditMode,
+  onDocumentSelected
 }) {
   const { doc, resolved } = useSiteDocument(sectionId);
   if (resolved && !doc && !isEditMode) return null;
+  if (isEditMode && !documentId && onDocumentSelected) {
+    return /* @__PURE__ */ jsx14(DocumentDropZone, { onDocumentSelected });
+  }
   const label = doc?.title ?? title;
   function handleClick() {
     if (!doc) return;
@@ -1467,7 +1543,7 @@ function DocumentRow({
     }
     openDocFile(sectionId);
   }
-  return /* @__PURE__ */ jsxs9(
+  return /* @__PURE__ */ jsxs10(
     "button",
     {
       type: "button",
@@ -1479,15 +1555,15 @@ function DocumentRow({
         doc ? "cursor-pointer hover:bg-base-accent" : "cursor-default opacity-60"
       ),
       children: [
-        /* @__PURE__ */ jsx13(FileText, { size: 18, "aria-hidden": "true", className: "shrink-0 text-base-contrast/60" }),
-        /* @__PURE__ */ jsxs9("div", { className: "min-w-0 flex-1", children: [
-          /* @__PURE__ */ jsxs9("div", { className: "flex items-center gap-2", children: [
-            /* @__PURE__ */ jsx13("span", { className: "truncate text-sm font-medium text-base-contrast", children: label }),
-            doc && /* @__PURE__ */ jsx13("span", { className: "shrink-0 rounded bg-base-100 px-1.5 py-0.5 text-xs font-medium text-base-contrast", children: doc.kind === "pdf" ? "PDF" : "HTML" })
+        /* @__PURE__ */ jsx14(FileText, { size: 18, "aria-hidden": "true", className: "shrink-0 text-base-contrast/60" }),
+        /* @__PURE__ */ jsxs10("div", { className: "min-w-0 flex-1", children: [
+          /* @__PURE__ */ jsxs10("div", { className: "flex items-center gap-2", children: [
+            /* @__PURE__ */ jsx14("span", { className: "truncate text-sm font-medium text-base-contrast", children: label }),
+            doc && /* @__PURE__ */ jsx14("span", { className: "shrink-0 rounded bg-base-100 px-1.5 py-0.5 text-xs font-medium text-base-contrast", children: doc.kind === "pdf" ? "PDF" : "HTML" })
           ] }),
-          /* @__PURE__ */ jsx13("div", { className: "truncate text-xs text-base-contrast/70", children: doc ? `${doc.filename} \xB7 ${formatDocSize(doc.size)}` : resolved ? "File missing" : "\xA0" })
+          /* @__PURE__ */ jsx14("div", { className: "truncate text-xs text-base-contrast/70", children: doc ? `${doc.filename} \xB7 ${formatDocSize(doc.size)}` : resolved ? "File missing" : "\xA0" })
         ] }),
-        doc && /* @__PURE__ */ jsx13(ExternalLink, { size: 16, "aria-hidden": "true", className: "shrink-0 text-base-contrast/50" })
+        doc && /* @__PURE__ */ jsx14(ExternalLink, { size: 16, "aria-hidden": "true", className: "shrink-0 text-base-contrast/50" })
       ]
     }
   );
@@ -1496,18 +1572,23 @@ var Document_default = defineSection({
   type: "document",
   category: "brand-guide",
   label: "Document",
-  icon: /* @__PURE__ */ jsx13(FileText, { size: 18 }),
+  icon: /* @__PURE__ */ jsx14(FileText, { size: 18 }),
   schema: schema4,
   // The row reads the client-side document registry and opens the overlay, so
   // the viewer hydrates it as an island rather than emitting static HTML.
   interactive: true,
   authoringNote: "One downloadable/viewable file \u2014 a PDF or a single self-contained HTML file \u2014 presented as a clickable row. Clicking opens it in a full-viewport preview overlay without leaving the page; on phones a PDF opens in the OS viewer instead. Pick the file from the media library (documents tab); leave the title blank to show the file name without its extension, or type one to override it. Leave 'Show in Documents menu' on for anything a viewer should be able to reach from any page \u2014 those entries collect into a derived Documents group at the bottom of the left nav. Use one section per file; for a set of downloads, place several document sections in a container.",
-  component: ({ content, isEditMode }) => /* @__PURE__ */ jsx13(
+  component: ({ content, isEditMode, onChange }) => /* @__PURE__ */ jsx14(
     DocumentRow,
     {
       sectionId: content.id ?? "",
       title: content.content.title,
-      isEditMode
+      documentId: content.content.doc?.documentId ?? "",
+      isEditMode,
+      onDocumentSelected: onChange ? (documentId) => onChange({
+        ...content,
+        content: { ...content.content, doc: { ...content.content.doc, documentId } }
+      }) : void 0
     }
   ),
   defaults: () => ({

package/dist/components/docfile/DocFilePane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocFilePane.d.ts","sourceRoot":"","sources":["../../../src/components/docfile/DocFilePane.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAClC,GAAG,EACH,OAAO,EACP,MAAc,GACf,EAAE;IAAE,GAAG,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,2CAyG9D"}
+{"version":3,"file":"DocFilePane.d.ts","sourceRoot":"","sources":["../../../src/components/docfile/DocFilePane.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAClC,GAAG,EACH,OAAO,EACP,MAAc,GACf,EAAE;IAAE,GAAG,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,2CAgH9D"}

package/dist/components/docfile/doc-file-state.d.ts

@@ -1,6 +1,11 @@
 import type { SiteDocument } from "../../lib/documents";
 /** Toggled on <html> while a document is open (the chat's class mechanism). */
 export declare const DOC_OPEN_CLASS = "bp-doc-open";
+/** Held on <html> for a beat after close. bp-doc-open's `transition: left`
+ *  rule leaves WITH the class, so without this the nav sidebar snaps home
+ *  instead of gliding back the way it glided out — this class carries the
+ *  same transition while the sidebar makes the return trip. */
+export declare const DOC_CLOSING_CLASS = "bp-doc-closing";
 /** The one breakpoint the doc feature keys off: at or above it the overlay
  *  gets the desktop stage; below it a PDF goes to the OS viewer instead (iOS
  *  Safari cannot scroll an iframed PDF, Android Chrome forces a download).

package/dist/components/docfile/doc-file-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-file-state.d.ts","sourceRoot":"","sources":["../../../src/components/docfile/doc-file-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,+EAA+E;AAC/E,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C;;;;;;;mBAOmB;AACnB,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD;;4CAE4C;AAC5C,eAAO,MAAM,gBAAgB;eAA4B,MAAM,GAAG,IAAI;EAAuB,CAAC;AA2B9F,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAmCD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAWnD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAUnC;AAED,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI,CAkCnF;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAI3D;AAED;2EAC2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAG5D;AAED,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,GAAG,IAAI,CAExD;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI,CAI5F;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}
+{"version":3,"file":"doc-file-state.d.ts","sourceRoot":"","sources":["../../../src/components/docfile/doc-file-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,+EAA+E;AAC/E,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C;;;+DAG+D;AAC/D,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAKlD;;;;;;;mBAOmB;AACnB,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD;;4CAE4C;AAC5C,eAAO,MAAM,gBAAgB;eAA4B,MAAM,GAAG,IAAI;EAAuB,CAAC;AA4B9F,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAkDD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAWnD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAUnC;AAED,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI,CAkCnF;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAI3D;AAED;2EAC2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAG5D;AAED,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,GAAG,IAAI,CAExD;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI,CAI5F;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,IAAI,IAAI,CAQxC"}

package/dist/components/primitives/DocumentDropZone.d.ts

@@ -0,0 +1,18 @@
+interface DocumentDropZoneProps {
+    /** Fired with the staged/committed document id once the upload resolves. */
+    onDocumentSelected: (documentId: string) => void;
+    className?: string;
+}
+/**
+ * The empty state of a `document` section in edit mode: drop a PDF/HTML file to
+ * upload it, or click to pick one from the library. Editor-only — the viewer
+ * never renders an unconfigured document section at all.
+ *
+ * Deliberately thin on validation: every rejection (wrong type, too large, no
+ * documents store) belongs to `uploadDocument`, which already routes typed copy
+ * through the pipeline's `onUploadError` → `UploadRejectionAlert` channel. The
+ * one judgement made here is WHICH file of a multi-file drop to hand over.
+ */
+export declare function DocumentDropZone({ onDocumentSelected, className }: DocumentDropZoneProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DocumentDropZone.d.ts.map

package/dist/components/primitives/DocumentDropZone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentDropZone.d.ts","sourceRoot":"","sources":["../../../src/components/primitives/DocumentDropZone.tsx"],"names":[],"mappings":"AAMA,UAAU,qBAAqB;IAC7B,4EAA4E;IAC5E,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,SAAS,EAAE,EAAE,qBAAqB,2CAsDxF"}

package/dist/components/sections/Document/index.d.ts

@@ -1,7 +1,13 @@
-export declare function DocumentRow({ sectionId, title, isEditMode, }: {
+export declare function DocumentRow({ sectionId, title, documentId, isEditMode, onDocumentSelected, }: {
     sectionId: string;
     title: string;
+    /** Raw `content.doc.documentId`. Empty means UNCONFIGURED, which is a
+     *  different state from an id that no longer resolves (see below). */
+    documentId?: string;
     isEditMode: boolean;
+    /** Present only when the section is editable — wires a picked/uploaded id
+     *  back into content. Absent for viewers and for a locked/read-only render. */
+    onDocumentSelected?: (documentId: string) => void;
 }): import("react/jsx-runtime").JSX.Element | null;
 declare const _default: import("../../..").SectionDefinition<{
     type: "document";

package/dist/components/sections/Document/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/sections/Document/index.tsx"],"names":[],"mappings":"AAqDA,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,KAAK,EACL,UAAU,GACX,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB,kDAsDA;;;;;;;;;;;;AAED,wBA6CG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/sections/Document/index.tsx"],"names":[],"mappings":"AAsDA,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,KAAK,EACL,UAAe,EACf,UAAU,EACV,kBAAkB,GACnB,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd;0EACsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB;mFAC+E;IAC/E,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD,kDA8DA;;;;;;;;;;;;AAED,wBA2DG"}

package/dist/components/sections/brand-guide.js

@@ -2,7 +2,7 @@ import {
   ColorItemSchema,
   ColorSpaceSchema,
   brandGuideSectionDefs
-} from "../../chunk-72FMQQIA.js";
+} from "../../chunk-P3NNI3QI.js";
 import "../../chunk-5THS4K5D.js";
 import "../../chunk-MUTHF2GT.js";
 import "../../chunk-26ALJO4K.js";

package/dist/components/sections/register-schemas.js

@@ -1,7 +1,7 @@
 import {
   allSectionDefs
-} from "../../chunk-GOCFTXR3.js";
-import "../../chunk-72FMQQIA.js";
+} from "../../chunk-6SLGKRLW.js";
+import "../../chunk-P3NNI3QI.js";
 import "../../chunk-LBHQWIVL.js";
 import "../../chunk-5THS4K5D.js";
 import "../../chunk-EWNDBKYK.js";

package/dist/components/sections/register.js

@@ -1,7 +1,7 @@
 import {
   allSectionDefs
-} from "../../chunk-GOCFTXR3.js";
-import "../../chunk-72FMQQIA.js";
+} from "../../chunk-6SLGKRLW.js";
+import "../../chunk-P3NNI3QI.js";
 import "../../chunk-LBHQWIVL.js";
 import "../../chunk-5THS4K5D.js";
 import "../../chunk-EWNDBKYK.js";

package/dist/components/shell/EditorShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EditorShell.d.ts","sourceRoot":"","sources":["../../../src/components/shell/EditorShell.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAejD,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAyDtF,OAAO,KAAK,EAAE,eAAe,EAA2D,MAAM,oBAAoB,CAAC;AA2CnH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA2BxD,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAC;IAIhB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,YAAY,EAAE;QACZ,KAAK,EAAE,OAAO,CAAC;QACf,aAAa,EAAE,OAAO,CAAC;QACvB,YAAY,EAAE,OAAO,CAAC;QACtB,cAAc,EAAE,OAAO,CAAC;QACxB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;KAAE,GAAG,IAAI,CAAC;IAIhE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAKjC,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAClC,OAAO,EACP,YAAY,EACZ,MAAM,EACN,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EACZ,WAAW,EACX,sBAA8B,EAC9B,eAAe,GAChB,EAAE,KAAK,2CA01DP;AAwED;6EAC6E;AAC7E,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,EACvC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,eAAe,EAAE,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK/B"}
+{"version":3,"file":"EditorShell.d.ts","sourceRoot":"","sources":["../../../src/components/shell/EditorShell.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAejD,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAyDtF,OAAO,KAAK,EAAE,eAAe,EAA2D,MAAM,oBAAoB,CAAC;AA2CnH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA2BxD,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAC;IAIhB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,YAAY,EAAE;QACZ,KAAK,EAAE,OAAO,CAAC;QACf,aAAa,EAAE,OAAO,CAAC;QACvB,YAAY,EAAE,OAAO,CAAC;QACtB,cAAc,EAAE,OAAO,CAAC;QACxB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;KAAE,GAAG,IAAI,CAAC;IAIhE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAKjC,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAClC,OAAO,EACP,YAAY,EACZ,MAAM,EACN,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EACZ,WAAW,EACX,sBAA8B,EAC9B,eAAe,GAChB,EAAE,KAAK,2CA82DP;AAwED;6EAC6E;AAC7E,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,EACvC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,eAAe,EAAE,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK/B"}

package/dist/components/shell/MediaLibraryContext.d.ts

@@ -31,6 +31,12 @@ export interface MediaLibraryContextValue {
      *  predate documents and must keep compiling. */
     documentManifest?: DocumentManifest;
     pendingDocuments?: PendingDocument[];
+    /** Upload a PDF/HTML file through the document pipeline, calling back with the
+     *  document id once it is staged. Optional for the same reason as the two
+     *  fields above. Owns every rejection itself (unsupported type, too large, no
+     *  documents store) — they surface on the pipeline's `onUploadError` channel,
+     *  so a caller never needs to pre-validate or report. */
+    uploadDocument?: (file: File, onComplete?: (documentId: string) => void) => void | Promise<void>;
 }
 export declare const MediaLibraryContext: import("react").Context<MediaLibraryContextValue | null>;
 export declare function useMediaLibrary(): MediaLibraryContextValue | null;

package/dist/components/shell/MediaLibraryContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaLibraryContext.d.ts","sourceRoot":"","sources":["../../../src/components/shell/MediaLibraryContext.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtE;wEACwE;AACxE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC;0EACsE;IACtE,eAAe,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9G,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACjC,sBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAC;IACnH,qBAAqB,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAAE,KAAK,IAAI,CAAC;IACpF,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B;qDACiD;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;CACtC;AAED,eAAO,MAAM,mBAAmB,0DAAuD,CAAC;AAExF,wBAAgB,eAAe,IAAI,wBAAwB,GAAG,IAAI,CAEjE"}
+{"version":3,"file":"MediaLibraryContext.d.ts","sourceRoot":"","sources":["../../../src/components/shell/MediaLibraryContext.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAEtE;wEACwE;AACxE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC;0EACsE;IACtE,eAAe,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9G,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACjC,sBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,CAAC;IACnH,qBAAqB,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAAE,KAAK,IAAI,CAAC;IACpF,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B;qDACiD;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC;;;;6DAIyD;IACzD,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClG;AAED,eAAO,MAAM,mBAAmB,0DAAuD,CAAC;AAExF,wBAAgB,eAAe,IAAI,wBAAwB,GAAG,IAAI,CAEjE"}

package/dist/hooks/useDocumentUploads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDocumentUploads.d.ts","sourceRoot":"","sources":["../../src/hooks/useDocumentUploads.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,sBAAsB,CAAC;AAapF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAS/E,UAAU,uBAAuB;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5E,oBAAoB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE;;;yEAGqE;IACrE,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,GACd,EAAE,uBAAuB;;;;2BAiET,IAAI,eAAe,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC;4BA4IhE,MAAM,EAAE;4BAqC2B,MAAM,EAAE;;EAqC1D"}
+{"version":3,"file":"useDocumentUploads.d.ts","sourceRoot":"","sources":["../../src/hooks/useDocumentUploads.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,sBAAsB,CAAC;AAapF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAS/E,UAAU,uBAAuB;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5E,oBAAoB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE;;;yEAGqE;IACrE,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,GACd,EAAE,uBAAuB;;;;2BAiET,IAAI,eAAe,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC;4BAiJhE,MAAM,EAAE;4BAqC2B,MAAM,EAAE;;EAqC1D"}

package/dist/hooks/useMediaPipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMediaPipeline.d.ts","sourceRoot":"","sources":["../../src/hooks/useMediaPipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAiBxF,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,UAAU,qBAAqB;IAC7B,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IACtE,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5E,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACnE,oBAAoB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,kBAAkB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACtE,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAIvE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAG1C,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAI3C,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,KAAK,IAAI,CAAC;CAC1E;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAoV8B,IAAI,EAAE,mBAAkB,MAAM,GAAG,IAAI;6BAiEvC,MAAM,EAAE;gCA0DL,MAAM,EAAE;;;+BA+Bf,MAAM,OAAO,MAAM;+BAiBnB,MAAM,YAAY,MAAM,GAAG,IAAI,KAAG,MAAM;6BAW1C,MAAM,QAAQ,MAAM;2BAWtB,MAAM,YAAY,MAAM,GAAG,IAAI;6BA4BvB,MAAM,YAAY,MAAM,GAAG,QAAQ;2BAd3C,MAAM,EAAE,YAAY,MAAM,GAAG,IAAI;kCA4DhE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,mBAC9B,MAAM,GAAG,IAAI;;;;wBA4CO,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,SAAS;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;;;;;;;EAgHjH"}
+{"version":3,"file":"useMediaPipeline.d.ts","sourceRoot":"","sources":["../../src/hooks/useMediaPipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAiBxF,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,UAAU,qBAAqB;IAC7B,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IACtE,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5E,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACnE,oBAAoB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,kBAAkB,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACtE,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAIvE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAG1C,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAI3C,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,KAAK,IAAI,CAAC;CAC1E;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAoV8B,IAAI,EAAE,mBAAkB,MAAM,GAAG,IAAI;6BAiEvC,MAAM,EAAE;gCA0DL,MAAM,EAAE;;;+BA+Bf,MAAM,OAAO,MAAM;+BAiBnB,MAAM,YAAY,MAAM,GAAG,IAAI,KAAG,MAAM;6BAW1C,MAAM,QAAQ,MAAM;2BAWtB,MAAM,YAAY,MAAM,GAAG,IAAI;6BA4BvB,MAAM,YAAY,MAAM,GAAG,QAAQ;2BAd3C,MAAM,EAAE,YAAY,MAAM,GAAG,IAAI;kCA4DhE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,mBAC9B,MAAM,GAAG,IAAI;;;;wBA4CO,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,SAAS;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;;;;;;;EAqHjH"}

package/dist/lib/dexie.d.ts

@@ -2,7 +2,7 @@ import type { SectionContent } from "../schemas/sections";
 import type { SiteIndex, SiteConfig } from "../schemas/site-config";
 import type { LoadedSection } from "./loader";
 import type { MediaManifest, MediaItem } from "../media/types";
-import type { DocumentManifestEntry } from "../schemas/documents";
+import type { DocumentManifest, DocumentManifestEntry } from "../schemas/documents";
 export interface PreservedEditRow {
     id: string;
     sectionId: string;
@@ -69,6 +69,7 @@ export declare function cacheContent(sha: string, sections: LoadedSection[], ind
     savedBranchSha: string | null;
     changedSectionIds: string[];
     mainIndex: SiteIndex | null;
+    documentManifest?: DocumentManifest;
 }): Promise<void>;
 export declare function getCachedContent(): Promise<{
     sha: string;
@@ -78,6 +79,7 @@ export declare function getCachedContent(): Promise<{
     savedBranchSha: string | null;
     changedSectionIds: string[];
     mainIndex: SiteIndex | null;
+    documentManifest: DocumentManifest;
 } | null>;
 /** Invalidate only the cached content snapshot (e.g. after a publish removes the
  * draft), forcing the next editor load to refetch rather than serve stale diff

package/dist/lib/dexie.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dexie.d.ts","sourceRoot":"","sources":["../../src/lib/dexie.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dexie.d.ts","sourceRoot":"","sources":["../../src/lib/dexie.ts"],"names":[],"mappings":"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"}

package/dist/lib/dexie.js

@@ -321,7 +321,8 @@ async function cacheContent(sha, sections, index, siteConfig, diff) {
     updatedAt: now,
     savedBranchSha: diff?.savedBranchSha ?? null,
     changedSectionIds: diff?.changedSectionIds ?? [],
-    mainIndex: diff?.mainIndex ?? null
+    mainIndex: diff?.mainIndex ?? null,
+    documentManifest: diff?.documentManifest ?? null
   });
 }
 async function getCachedContent() {
@@ -336,7 +337,11 @@ async function getCachedContent() {
     changedSectionIds: row.changedSectionIds ?? [],
     // No stored mainIndex (e.g. legacy or post-publish cache) means "no draft",
     // so the published index equals the current index.
-    mainIndex: row.mainIndex ?? row.index
+    mainIndex: row.mainIndex ?? row.index,
+    // Legacy row (pre-documents package): {} matches the fetch path's posture.
+    // The narrow stale edge — an old row at a sha that DOES hold a manifest —
+    // heals on the next fresh load or save.
+    documentManifest: row.documentManifest ?? {}
   };
 }
 async function clearContentCache() {

package/dist/storage/types.d.ts

@@ -111,9 +111,18 @@ export declare const ASSET_CACHE_CONTROL = "max-age=31536000, immutable";
  * can slot in. All paths are SITE-RELATIVE ("media/{hash}/original.mp4") —
  * implementations prepend the tenant prefix ("sites/{siteId}/") themselves so
  * a caller can never address another tenant's objects.
+ *
+ * This bucket is PUBLIC: an object's URL is statically derivable from the
+ * bucket's public base, so `createUploadUrl` returns it once at upload time
+ * (built locally in standalone mode, brokered from the admin app's env in
+ * platform mode) and the media manifest stores that absolute URL. Rendering
+ * reads the manifest — nothing on the read path re-derives a URL.
  */
 export interface AssetStore {
-    /** Mint a signed direct-upload URL for the browser (PUT). */
+    /**
+     * Mint a signed direct-upload URL for the browser (PUT), along with the
+     * object's permanent public URL for the caller to persist.
+     */
     createUploadUrl(path: string, opts: {
         contentType: string;
     }): Promise<{
@@ -121,8 +130,6 @@ export interface AssetStore {
         path: string;
         publicUrl: string;
     }>;
-    /** Deterministic public CDN URL for an object (no network call). */
-    getPublicUrl(path: string): string;
     delete(paths: string[]): Promise<void>;
     /** Recursive listing under a site-relative prefix. */
     list(prefix: string): Promise<{
@@ -145,8 +152,10 @@ export declare const DOCUMENT_CACHE_CONTROL = "private, max-age=31536000, immuta
  * Deliberately not an AssetStore: the assets bucket is public by configuration
  * at R2_PUBLIC_BASE (videos depend on it), so a signed GET there would protect
  * nothing and hosted HTML would render unsandboxed on a sibling origin. Hence
- * no `getPublicUrl` here at all — every read is a short-lived signed GET,
- * minted only after the gated route has authorized the requester.
+ * the asymmetry with AssetStore — an asset has a permanent public URL handed
+ * back by `createUploadUrl`, while a document has no durable URL at all: every
+ * read is a short-lived signed GET from `createDownloadUrl`, minted only after
+ * the gated route has authorized the requester.
  *
  * Paths are SITE-RELATIVE ("documents/{hash}/original.pdf"); implementations
  * prepend the tenant prefix themselves so a caller can never address another

package/dist/storage/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawnagency/primitives",
-  "version": "0.1.100",
+  "version": "0.1.102",
   "type": "module",
   "exports": {
     "./package.json": "./package.json",

package/src/components/docfile/DocFilePane.tsx

@@ -112,7 +112,14 @@ export default function DocFilePane({
         <iframe
           key={attempt}
           ref={frameRef}
-          src={doc.url}
+          // PDF open-parameters hide the native viewer's toolbar/side panel in
+          // Chromium so the pane's own top bar is the only chrome; Firefox and
+          // Safari ignore them harmlessly. view=FitH fits the page to the pane
+          // width in Chromium (default is fit-page, which wastes ~half the
+          // pane); zoom=page-width is the Firefox/pdf.js spelling of the same
+          // thing, verified harmless in Chromium. A client-side fragment: it
+          // survives the gated route's 302 and works on pre-save blob: URLs too.
+          src={doc.kind === "pdf" ? `${doc.url}#toolbar=0&navpanes=0&view=FitH&zoom=page-width` : doc.url}
           title={doc.title}
           // Opaque origin for authored HTML: no portal cookies, storage or
           // parent DOM. The ATTRIBUTE applies regardless of origin, so

package/src/components/docfile/doc-file-state.ts

@@ -4,6 +4,15 @@ import { createEvent } from "../../lib/events";
 /** Toggled on <html> while a document is open (the chat's class mechanism). */
 export const DOC_OPEN_CLASS = "bp-doc-open";
 
+/** Held on <html> for a beat after close. bp-doc-open's `transition: left`
+ *  rule leaves WITH the class, so without this the nav sidebar snaps home
+ *  instead of gliding back the way it glided out — this class carries the
+ *  same transition while the sidebar makes the return trip. */
+export const DOC_CLOSING_CLASS = "bp-doc-closing";
+
+/** Slightly longer than the 300ms CSS ease so the class outlives the glide. */
+const DOC_CLOSING_MS = 350;
+
 /** The one breakpoint the doc feature keys off: at or above it the overlay
  *  gets the desktop stage; below it a PDF goes to the OS viewer instead (iOS
  *  Safari cannot scroll an iframed PDF, Android Chrome forces a download).
@@ -27,6 +36,7 @@ interface DocFileStore {
   openListeners: Set<(id: string | null) => void>;
   docsListeners: Set<(docs: SiteDocument[] | null) => void>;
   teardown: (() => void) | null;
+  closingTimer: ReturnType<typeof setTimeout> | null;
 }
 
 // Symbol-keyed on globalThis for the same reason the section registry is: the
@@ -38,7 +48,7 @@ const g = globalThis as unknown as Record<symbol, DocFileStore | undefined>;
 function store(): DocFileStore {
   let s = g[STORE_KEY];
   if (!s) {
-    s = { open: null, docs: null, openListeners: new Set(), docsListeners: new Set(), teardown: null };
+    s = { open: null, docs: null, openListeners: new Set(), docsListeners: new Set(), teardown: null, closingTimer: null };
     g[STORE_KEY] = s;
   }
   return s;
@@ -63,9 +73,24 @@ function readHash(): string | null {
 function apply(sectionId: string | null): void {
   const s = store();
   if (s.open === sectionId) return;
+  const wasOpen = s.open !== null;
   s.open = sectionId;
   if (typeof document !== "undefined") {
-    document.documentElement.classList.toggle(DOC_OPEN_CLASS, sectionId !== null);
+    const root = document.documentElement;
+    root.classList.toggle(DOC_OPEN_CLASS, sectionId !== null);
+    // A reopen during the return glide cancels the closing state outright.
+    if (s.closingTimer !== null) {
+      clearTimeout(s.closingTimer);
+      s.closingTimer = null;
+      root.classList.remove(DOC_CLOSING_CLASS);
+    }
+    if (sectionId === null && wasOpen) {
+      root.classList.add(DOC_CLOSING_CLASS);
+      s.closingTimer = setTimeout(() => {
+        root.classList.remove(DOC_CLOSING_CLASS);
+        s.closingTimer = null;
+      }, DOC_CLOSING_MS);
+    }
   }
   for (const listener of [...s.openListeners]) listener(sectionId);
 }
@@ -175,6 +200,9 @@ export function subscribeSiteDocuments(cb: (docs: SiteDocument[] | null) => void
 export function resetDocFileState(): void {
   const s = g[STORE_KEY];
   if (s?.teardown) s.teardown();
-  if (typeof document !== "undefined") document.documentElement.classList.remove(DOC_OPEN_CLASS);
+  if (s?.closingTimer) clearTimeout(s.closingTimer);
+  if (typeof document !== "undefined") {
+    document.documentElement.classList.remove(DOC_OPEN_CLASS, DOC_CLOSING_CLASS);
+  }
   g[STORE_KEY] = undefined;
 }

package/src/components/primitives/DocumentDropZone.tsx

@@ -0,0 +1,79 @@
+import { useState, type DragEvent } from "react";
+import { FileUp } from "lucide-react";
+import { cn } from "../../lib/cn";
+import { DOCUMENT_MIME_TO_EXT } from "../../schemas/documents";
+import { useMediaLibrary } from "../shell/MediaLibraryContext";
+
+interface DocumentDropZoneProps {
+  /** Fired with the staged/committed document id once the upload resolves. */
+  onDocumentSelected: (documentId: string) => void;
+  className?: string;
+}
+
+const isDocumentFile = (file: File) => file.type in DOCUMENT_MIME_TO_EXT;
+
+/**
+ * The empty state of a `document` section in edit mode: drop a PDF/HTML file to
+ * upload it, or click to pick one from the library. Editor-only — the viewer
+ * never renders an unconfigured document section at all.
+ *
+ * Deliberately thin on validation: every rejection (wrong type, too large, no
+ * documents store) belongs to `uploadDocument`, which already routes typed copy
+ * through the pipeline's `onUploadError` → `UploadRejectionAlert` channel. The
+ * one judgement made here is WHICH file of a multi-file drop to hand over.
+ */
+export function DocumentDropZone({ onDocumentSelected, className }: DocumentDropZoneProps) {
+  const mediaLibrary = useMediaLibrary();
+  const [dragging, setDragging] = useState(false);
+
+  // Only react to drags carrying files, so the editor's block reorder (which
+  // carries no `Files`) passes straight through. Mirrors ImageDropZone.
+  const hasFiles = (e: DragEvent) => e.dataTransfer.types.includes("Files");
+
+  const handleDragOver = (e: DragEvent) => {
+    if (!hasFiles(e)) return;
+    e.preventDefault();
+    e.dataTransfer.dropEffect = "copy";
+    setDragging(true);
+  };
+
+  const handleDragLeave = (e: DragEvent) => {
+    if (!hasFiles(e)) return;
+    const related = e.relatedTarget as Node | null;
+    if (related && e.currentTarget.contains(related)) return;
+    setDragging(false);
+  };
+
+  const handleDrop = (e: DragEvent) => {
+    if (!hasFiles(e)) return;
+    e.preventDefault();
+    e.stopPropagation();
+    setDragging(false);
+    const files = Array.from(e.dataTransfer.files);
+    if (files.length === 0) return;
+    // First document-typed file wins. With none, the first file still goes to
+    // the pipeline so its rejection names the real constraint ("only PDF and
+    // HTML documents can be uploaded") instead of a hand-rolled message here.
+    void mediaLibrary?.uploadDocument?.(files.find(isDocumentFile) ?? files[0], onDocumentSelected);
+  };
+
+  return (
+    <button
+      type="button"
+      onClick={() =>
+        mediaLibrary?.openSelectModal(onDocumentSelected, { kinds: ["document"] })
+      }
+      onDragOver={handleDragOver}
+      onDragLeave={handleDragLeave}
+      onDrop={handleDrop}
+      className={cn(
+        "flex w-full cursor-pointer items-center justify-center gap-2 rounded-outer border-2 border-dashed border-base-200 bg-base px-4 py-6 text-sm text-base-contrast-light transition-colors hover:border-base-300 hover:bg-base-accent hover:text-base-contrast",
+        dragging && "border-primary bg-primary/5 text-base-contrast",
+        className,
+      )}
+    >
+      <FileUp size={18} aria-hidden="true" className="shrink-0" />
+      <span>Drop a PDF or HTML file, or choose from the library</span>
+    </button>
+  );
+}

package/src/components/sections/Document/index.tsx

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { ExternalLink, FileText } from "lucide-react";
 import { defineSection } from "../../../lib/registry";
 import { cn } from "../../../lib/cn";
+import { DocumentDropZone } from "../../primitives/DocumentDropZone";
 import { formatDocSize, type SiteDocument } from "../../../lib/documents";
 import {
   getSiteDocuments,
@@ -54,11 +55,19 @@ function useSiteDocument(sectionId: string): { doc: SiteDocument | null; resolve
 export function DocumentRow({
   sectionId,
   title,
+  documentId = "",
   isEditMode,
+  onDocumentSelected,
 }: {
   sectionId: string;
   title: string;
+  /** Raw `content.doc.documentId`. Empty means UNCONFIGURED, which is a
+   *  different state from an id that no longer resolves (see below). */
+  documentId?: string;
   isEditMode: boolean;
+  /** Present only when the section is editable — wires a picked/uploaded id
+   *  back into content. Absent for viewers and for a locked/read-only render. */
+  onDocumentSelected?: (documentId: string) => void;
 }) {
   const { doc, resolved } = useSiteDocument(sectionId);
 
@@ -67,6 +76,14 @@ export function DocumentRow({
   // the section stays selectable and repairable.
   if (resolved && !doc && !isEditMode) return null;
 
+  // An empty id is an unconfigured section: give editors somewhere to drop a
+  // file instead of a dead, permanently-disabled row. A NON-empty id that does
+  // not resolve is a different problem — it keeps the "File missing" row so the
+  // broken reference stays visible rather than looking like a fresh section.
+  if (isEditMode && !documentId && onDocumentSelected) {
+    return <DocumentDropZone onDocumentSelected={onDocumentSelected} />;
+  }
+
   // `doc.title` is already `content.title || filenameStem(entry.filename)` —
   // deriveSiteDocuments applies the fallback once so the row, the Documents nav
   // entry and the overlay top bar can never disagree. Picking a file NEVER
@@ -130,14 +147,28 @@ export default defineSection({
     "Pick the file from the media library (documents tab); leave the title blank to show the file name without its extension, or type one to override it. " +
     "Leave 'Show in Documents menu' on for anything a viewer should be able to reach from any page — those entries collect into a derived Documents group at the bottom of the left nav. " +
     "Use one section per file; for a set of downloads, place several document sections in a container.",
-  component: ({ content, isEditMode }) => (
+  component: ({ content, isEditMode, onChange }) => (
     <DocumentRow
       // The section id is added by the outer Section schema (id + layout
       // intersected with the per-type schema), so it is present at render time
       // but absent from this type's inferred content shape.
       sectionId={(content as unknown as { id?: string }).id ?? ""}
       title={content.content.title}
+      documentId={content.content.doc?.documentId ?? ""}
       isEditMode={isEditMode}
+      // Writes `doc` only: `title` stays the editor's (deriveSiteDocuments
+      // applies the filename-stem fallback for display) and showInDocumentsNav
+      // is untouched. Spreading `content` preserves the id and layout envelope,
+      // which the container path (Container.tsx updateChild) also re-attaches.
+      onDocumentSelected={
+        onChange
+          ? (documentId) =>
+              onChange({
+                ...content,
+                content: { ...content.content, doc: { ...content.content.doc, documentId } },
+              })
+          : undefined
+      }
     />
   ),
   defaults: () => ({

package/src/components/shell/EditorShell.tsx

@@ -247,7 +247,8 @@ export default function EditorShell({
   const [rejectedUploads, setRejectedUploads] = useState<{ name: string; reason: "size" | "type" }[]>([]);
   // Surfaces useMediaPipeline's onUploadError (oversized/disallowed files,
   // upload-intent failures, direct-to-bucket PUT failures) in the media
-  // library modal, alongside its existing client-side rejection banner.
+  // library modal, alongside its existing client-side rejection banner — and at
+  // shell level while that modal is closed, for uploads started from a section.
   const [uploadErrorMessage, setUploadErrorMessage] = useState<string | null>(null);
   // Surfaces useMediaPipeline's onUploadNotice (e.g. "N files already exist
   // and were left where they are" on dedup skip) in the media library modal.
@@ -1089,6 +1090,10 @@ export default function EditorShell({
         setMainSha(headSha);
         setChangedSectionIds(new Set(cached.changedSectionIds ?? []));
         setMainIndex(cached.mainIndex ?? loadedIndex);
+        // Without this, a cache-hit load left documentManifest null forever —
+        // the siteDocuments memo's null-guard then never lifted and every
+        // document row (committed or staged) read "File missing".
+        setDocumentManifest(cached.documentManifest ?? {});
       } else {
         const data = await fetchSavedContent();
         loadedSections = data.sections;
@@ -1098,6 +1103,7 @@ export default function EditorShell({
           savedBranchSha: data.savedBranchSha,
           changedSectionIds: data.changedSectionIds,
           mainIndex: data.mainIndex,
+          documentManifest: data.documentManifest ?? {},
         });
         if (data.mediaManifest) {
           loadedManifest = data.mediaManifest;
@@ -1824,6 +1830,20 @@ export default function EditorShell({
             </div>
           )}
 
+          {/* Same onUploadError message the media modal shows in its own banner,
+              surfaced at shell level when the modal is closed — an upload can now
+              start from a document section's drop zone, where nothing else would
+              ever render the rejection. Gated on the modal being shut so the two
+              never show the same message twice. */}
+          {uploadErrorMessage && !showMediaLibrary && (
+            <div className="sticky top-2 z-30 mx-auto w-full max-w-3xl px-4">
+              <UploadRejectionAlert
+                message={uploadErrorMessage}
+                onDismiss={() => setUploadErrorMessage(null)}
+              />
+            </div>
+          )}
+
           {unparseableSectionIds.length > 0 && (
             <div className="sticky top-2 z-30 mx-auto w-full max-w-3xl px-4">
               <UploadRejectionAlert

package/src/components/shell/MediaLibraryContext.tsx

@@ -28,6 +28,12 @@ export interface MediaLibraryContextValue {
    *  predate documents and must keep compiling. */
   documentManifest?: DocumentManifest;
   pendingDocuments?: PendingDocument[];
+  /** Upload a PDF/HTML file through the document pipeline, calling back with the
+   *  document id once it is staged. Optional for the same reason as the two
+   *  fields above. Owns every rejection itself (unsupported type, too large, no
+   *  documents store) — they surface on the pipeline's `onUploadError` channel,
+   *  so a caller never needs to pre-validate or report. */
+  uploadDocument?: (file: File, onComplete?: (documentId: string) => void) => void | Promise<void>;
 }
 
 export const MediaLibraryContext = createContext<MediaLibraryContextValue | null>(null);

package/src/hooks/useDocumentUploads.ts

@@ -1,4 +1,5 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { DOCUMENT_CACHE_CONTROL } from "../storage/types";
 import { hashFileBuffer } from "../media/utils";
 import type { DocumentManifest, DocumentManifestEntry } from "../schemas/documents";
 import {
@@ -209,6 +210,11 @@ export function useDocumentUploads({
             const xhr = new XMLHttpRequest();
             xhr.open("PUT", uploadUrl);
             xhr.setRequestHeader("Content-Type", file.type);
+            // The presign signs cache-control;content-type;host — BOTH headers
+            // must be sent byte-exact or R2 403s the PUT, and R2 omits CORS
+            // headers on errors, so the browser misreports it as a CORS block.
+            // (The video path sets ASSET_CACHE_CONTROL the same way.)
+            xhr.setRequestHeader("Cache-Control", DOCUMENT_CACHE_CONTROL);
             xhr.upload.onprogress = (e) => {
               if (e.lengthComputable) {
                 setDocumentUploadProgress((prev) => ({ ...prev, [documentId]: e.loaded / e.total }));
@@ -216,7 +222,7 @@ export function useDocumentUploads({
             };
             xhr.onload = () =>
               xhr.status >= 200 && xhr.status < 300 ? resolvePut() : rejectPut(new Error(`upload ${xhr.status}`));
-            xhr.onerror = () => rejectPut(new Error("upload failed"));
+            xhr.onerror = () => rejectPut(new Error("the storage request was blocked or interrupted"));
             xhr.send(file);
           });
         } catch (err) {

package/src/hooks/useMediaPipeline.ts

@@ -790,7 +790,12 @@ export function useMediaPipeline({
     // pipeline's pendingDocumentUrls — a context copy would be dead surface.
     documentManifest,
     pendingDocuments: documents.pendingDocuments,
-  }), [handleMediaUpload, enqueueFile, mediaManifest, pendingMediaItems, pendingLocalUrls, siteConfig, documentManifest, documents.pendingDocuments]);
+    // Direct document upload, for the `document` section's empty-state drop
+    // zone. Deliberately not routed through enqueueFile: that gate keys off the
+    // MIME type, so a file the drop zone means as a document but the browser
+    // typed as something else would silently become an image.
+    uploadDocument: documents.uploadDocument,
+  }), [handleMediaUpload, enqueueFile, mediaManifest, pendingMediaItems, pendingLocalUrls, siteConfig, documentManifest, documents.pendingDocuments, documents.uploadDocument]);
 
   return {
     processingItems,

package/src/lib/dexie.ts

@@ -4,7 +4,7 @@ import type { SiteIndex, SectionMeta, SiteConfig, Page } from "../schemas/site-c
 import type { NavEntry } from "../schemas/nav";
 import type { LoadedSection } from "./loader";
 import type { MediaManifest, MediaItem } from "../media/types";
-import type { DocumentManifestEntry } from "../schemas/documents";
+import type { DocumentManifest, DocumentManifestEntry } from "../schemas/documents";
 
 interface SectionRow {
   sectionId: string;
@@ -50,6 +50,11 @@ interface ContentCacheRow {
   savedBranchSha?: string | null;
   changedSectionIds?: string[];
   mainIndex?: SiteIndex | null;
+  // The document sidecar at this sha. Optional for rows written by older
+  // packages; readers fall back to {} (same posture as the fetch path's
+  // `data.documentManifest ?? {}`). Without this, a cache-hit editor load left
+  // documentManifest null and the whole documents feature dead for the session.
+  documentManifest?: DocumentManifest | null;
 }
 
 interface MediaManifestRow {
@@ -478,7 +483,7 @@ export async function cacheContent(
   sections: LoadedSection[],
   index: SiteIndex,
   siteConfig: Record<string, unknown>,
-  diff?: { savedBranchSha: string | null; changedSectionIds: string[]; mainIndex: SiteIndex | null },
+  diff?: { savedBranchSha: string | null; changedSectionIds: string[]; mainIndex: SiteIndex | null; documentManifest?: DocumentManifest },
 ): Promise<void> {
   const now = new Date().toISOString();
   await getDb().contentCache.put({
@@ -491,6 +496,7 @@ export async function cacheContent(
     savedBranchSha: diff?.savedBranchSha ?? null,
     changedSectionIds: diff?.changedSectionIds ?? [],
     mainIndex: diff?.mainIndex ?? null,
+    documentManifest: diff?.documentManifest ?? null,
   });
 }
 
@@ -502,6 +508,7 @@ export async function getCachedContent(): Promise<{
   savedBranchSha: string | null;
   changedSectionIds: string[];
   mainIndex: SiteIndex | null;
+  documentManifest: DocumentManifest;
 } | null> {
   const row = await getDb().contentCache.get("current");
   if (!row) return null;
@@ -515,6 +522,10 @@ export async function getCachedContent(): Promise<{
     // No stored mainIndex (e.g. legacy or post-publish cache) means "no draft",
     // so the published index equals the current index.
     mainIndex: row.mainIndex ?? row.index,
+    // Legacy row (pre-documents package): {} matches the fetch path's posture.
+    // The narrow stale edge — an old row at a sha that DOES hold a manifest —
+    // heals on the next fresh load or save.
+    documentManifest: row.documentManifest ?? {},
   };
 }
 

package/src/storage/types.ts

@@ -135,17 +135,23 @@ export const ASSET_CACHE_CONTROL = "max-age=31536000, immutable";
  * can slot in. All paths are SITE-RELATIVE ("media/{hash}/original.mp4") —
  * implementations prepend the tenant prefix ("sites/{siteId}/") themselves so
  * a caller can never address another tenant's objects.
+ *
+ * This bucket is PUBLIC: an object's URL is statically derivable from the
+ * bucket's public base, so `createUploadUrl` returns it once at upload time
+ * (built locally in standalone mode, brokered from the admin app's env in
+ * platform mode) and the media manifest stores that absolute URL. Rendering
+ * reads the manifest — nothing on the read path re-derives a URL.
  */
 export interface AssetStore {
-  /** Mint a signed direct-upload URL for the browser (PUT). */
+  /**
+   * Mint a signed direct-upload URL for the browser (PUT), along with the
+   * object's permanent public URL for the caller to persist.
+   */
   createUploadUrl(
     path: string,
     opts: { contentType: string },
   ): Promise<{ uploadUrl: string; path: string; publicUrl: string }>;
 
-  /** Deterministic public CDN URL for an object (no network call). */
-  getPublicUrl(path: string): string;
-
   delete(paths: string[]): Promise<void>;
 
   /** Recursive listing under a site-relative prefix. */
@@ -167,8 +173,10 @@ export const DOCUMENT_CACHE_CONTROL = "private, max-age=31536000, immutable";
  * Deliberately not an AssetStore: the assets bucket is public by configuration
  * at R2_PUBLIC_BASE (videos depend on it), so a signed GET there would protect
  * nothing and hosted HTML would render unsandboxed on a sibling origin. Hence
- * no `getPublicUrl` here at all — every read is a short-lived signed GET,
- * minted only after the gated route has authorized the requester.
+ * the asymmetry with AssetStore — an asset has a permanent public URL handed
+ * back by `createUploadUrl`, while a document has no durable URL at all: every
+ * read is a short-lived signed GET from `createDownloadUrl`, minted only after
+ * the gated route has authorized the requester.
  *
  * Paths are SITE-RELATIVE ("documents/{hash}/original.pdf"); implementations
  * prepend the tenant prefix themselves so a caller can never address another