@drawnagency/primitives 0.1.98 → 0.1.100

package/dist/{chunk-EUSWEVOA.js → chunk-3TO4RRHY.js}

@@ -7,6 +7,14 @@ var StorageConflictError = class extends Error {
   }
   currentVersion;
 };
+var IdempotencyLookupUnavailableError = class extends Error {
+  constructor(cause) {
+    super("Could not search draft history for the idempotency key");
+    this.cause = cause;
+    this.name = "IdempotencyLookupUnavailableError";
+  }
+  cause;
+};
 var IDEMPOTENCY_TRAILER = "Idempotency-Key";
 var IDEMPOTENCY_KEY_RE = /^[A-Za-z0-9._:-]{8,200}$/;
 function withIdempotencyTrailer(subject, key) {
@@ -19,11 +27,14 @@ function withIdempotencyTrailer(subject, key) {
 ${IDEMPOTENCY_TRAILER}: ${key}`;
 }
 var ASSET_CACHE_CONTROL = "max-age=31536000, immutable";
+var DOCUMENT_CACHE_CONTROL = "private, max-age=31536000, immutable";
 
 export {
   StorageConflictError,
+  IdempotencyLookupUnavailableError,
   IDEMPOTENCY_TRAILER,
   IDEMPOTENCY_KEY_RE,
   withIdempotencyTrailer,
-  ASSET_CACHE_CONTROL
+  ASSET_CACHE_CONTROL,
+  DOCUMENT_CACHE_CONTROL
 };

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

@@ -24,6 +24,9 @@ import {
   curatedIcons,
   getIcon
 } from "./chunk-WDSVHKAH.js";
+import {
+  createEvent
+} from "./chunk-PTOLUMGV.js";
 import {
   cn
 } from "./chunk-7EOSDFS3.js";
@@ -65,9 +68,9 @@ function getContrastClass(hex) {
   const h = hex.replace("#", "");
   if (h.length < 6) return "text-white";
   const r = parseInt(h.substring(0, 2), 16);
-  const g = parseInt(h.substring(2, 4), 16);
+  const g2 = parseInt(h.substring(2, 4), 16);
   const b = parseInt(h.substring(4, 6), 16);
-  const yiq = (r * 299 + g * 587 + b * 114) / 1e3;
+  const yiq = (r * 299 + g2 * 587 + b * 114) / 1e3;
   return yiq >= 128 ? "text-black" : "text-white";
 }
 var createColorItem = () => ({
@@ -1295,13 +1298,253 @@ var DoDontMedia_default = defineSection({
   ]
 });
 
+// src/components/sections/Document/index.tsx
+import { useEffect as useEffect5, useState as useState6 } from "react";
+import { z as z5 } from "zod";
+import { ExternalLink, FileText } from "lucide-react";
+
+// src/lib/container-ops.ts
+function getContainerChildren(block) {
+  const content = block.content;
+  return Array.isArray(content?.children) ? content.children : [];
+}
+function withChildren(container, children) {
+  return { ...container, content: { ...container.content, children } };
+}
+function containerColumns(container) {
+  const n = container.content?.columns;
+  return typeof n === "number" && n >= 1 ? n : 1;
+}
+function removeChildAt(container, index) {
+  const children = getContainerChildren(container);
+  if (index < 0 || index >= children.length) return { container, removed: null };
+  const next = [...children];
+  const [removed] = next.splice(index, 1);
+  return { container: withChildren(container, next), removed };
+}
+function duplicateChildAt(container, index, newId) {
+  const children = getContainerChildren(container);
+  if (index < 0 || index >= children.length) return container;
+  const clone = { ...JSON.parse(JSON.stringify(children[index])), id: newId() };
+  const next = [...children];
+  next.splice(index + 1, 0, clone);
+  return withChildren(container, next);
+}
+function setChildColSpan(container, index, span) {
+  const children = getContainerChildren(container);
+  if (index < 0 || index >= children.length) return container;
+  const clamped = Math.max(1, Math.min(span, containerColumns(container)));
+  const next = children.map((child, i) => {
+    if (i !== index) return child;
+    if (clamped <= 1) {
+      const { layout: _drop, ...rest } = child;
+      return rest;
+    }
+    return { ...child, layout: { ...child.layout, colSpan: clamped } };
+  });
+  return withChildren(container, next);
+}
+function effectiveSpan(child, columns) {
+  return isSpacer(child) ? 1 : Math.min(child.layout?.colSpan ?? 1, columns);
+}
+function isSpacer(child) {
+  return child.type === "spacer";
+}
+function occupiedColumns(children, columns) {
+  return children.reduce((sum, c) => sum + effectiveSpan(c, columns), 0);
+}
+function trimTrailingSpacers(container) {
+  const children = getContainerChildren(container);
+  let end = children.length;
+  while (end > 0 && isSpacer(children[end - 1])) end--;
+  if (end === children.length) return container;
+  return withChildren(container, children.slice(0, end));
+}
+
+// src/lib/documents.ts
+function formatDocSize(bytes) {
+  if (!Number.isFinite(bytes) || bytes < 0) return "";
+  if (bytes < 1024) return `${Math.round(bytes)} B`;
+  const units = ["KB", "MB", "GB"];
+  let value = bytes / 1024;
+  let unit = 0;
+  while (value >= 1024 && unit < units.length - 1) {
+    value /= 1024;
+    unit++;
+  }
+  return `${value >= 100 ? Math.round(value) : Number(value.toFixed(1))} ${units[unit]}`;
+}
+
+// src/components/docfile/doc-file-state.ts
+var DOC_OPEN_CLASS = "bp-doc-open";
+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");
+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 };
+    g[STORE_KEY] = s;
+  }
+  return s;
+}
+function isDocDesktop() {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return true;
+  return window.matchMedia(DOC_DESKTOP_QUERY).matches;
+}
+function apply(sectionId) {
+  const s = store();
+  if (s.open === sectionId) return;
+  s.open = sectionId;
+  if (typeof document !== "undefined") {
+    document.documentElement.classList.toggle(DOC_OPEN_CLASS, sectionId !== null);
+  }
+  for (const listener of [...s.openListeners]) listener(sectionId);
+}
+function openDocFile(sectionId) {
+  if (typeof window !== "undefined") {
+    const hash = `#doc=${encodeURIComponent(sectionId)}`;
+    if (window.location.hash !== hash) {
+      window.history.pushState(null, "", hash);
+    }
+  }
+  apply(sectionId);
+  docFileOpenEvent.dispatch({ sectionId });
+}
+function getSiteDocuments() {
+  return store().docs;
+}
+function subscribeSiteDocuments(cb) {
+  const s = store();
+  s.docsListeners.add(cb);
+  return () => {
+    s.docsListeners.delete(cb);
+  };
+}
+
+// src/components/sections/Document/index.tsx
+import { jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";
+var schema4 = z5.object({
+  type: z5.literal("document"),
+  content: z5.object({
+    title: z5.string().describe("Row title. Leave it blank to show the file name without its extension; type a title to override that."),
+    doc: z5.object({
+      documentId: z5.string().default("").describe(
+        "Hash key into the document manifest (src/content/document-manifest.json). Deliberately NOT `imageId`: documents are not resolved by the media ref-baker."
+      )
+    }),
+    showInDocumentsNav: z5.boolean().default(true).describe(
+      "When true, this document also appears in the auto-derived Documents group at the bottom of the left navigation, openable from any page."
+    )
+  }),
+  options: z5.object({}).default({})
+});
+function useSiteDocument(sectionId) {
+  const [docs, setDocs] = useState6(null);
+  useEffect5(() => {
+    setDocs(getSiteDocuments());
+    return subscribeSiteDocuments(setDocs);
+  }, []);
+  return {
+    doc: docs ? docs.find((d) => d.sectionId === sectionId) ?? null : null,
+    resolved: docs !== null
+  };
+}
+function DocumentRow({
+  sectionId,
+  title,
+  isEditMode
+}) {
+  const { doc, resolved } = useSiteDocument(sectionId);
+  if (resolved && !doc && !isEditMode) return null;
+  const label = doc?.title ?? title;
+  function handleClick() {
+    if (!doc) return;
+    if (doc.kind === "pdf" && !isDocDesktop()) {
+      window.open(doc.url, "_blank", "noopener,noreferrer");
+      return;
+    }
+    openDocFile(sectionId);
+  }
+  return /* @__PURE__ */ jsxs9(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      disabled: !doc,
+      "aria-label": doc ? `Open ${label}` : void 0,
+      className: cn(
+        "flex w-full min-w-0 items-center gap-3 rounded-outer border border-base-200 bg-base px-4 py-3 text-left transition-colors",
+        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__ */ jsx13("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" })
+      ]
+    }
+  );
+}
+var Document_default = defineSection({
+  type: "document",
+  category: "brand-guide",
+  label: "Document",
+  icon: /* @__PURE__ */ jsx13(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(
+    DocumentRow,
+    {
+      sectionId: content.id ?? "",
+      title: content.content.title,
+      isEditMode
+    }
+  ),
+  defaults: () => ({
+    type: "document",
+    content: { title: "", doc: { documentId: "" }, showInDocumentsNav: true },
+    options: {}
+  }),
+  getLabel: (content) => content.content.title || "Document",
+  settings: {
+    doc: { type: "document-source", label: "File", target: "content", default: { documentId: "" } },
+    title: { type: "text", label: "Title", target: "content", default: "", placeholder: "Document title" },
+    showInDocumentsNav: {
+      type: "checkbox",
+      label: "Show in Documents menu",
+      target: "content",
+      default: true
+    }
+  },
+  settingsTabs: [
+    { label: "File", fields: ["doc", "title"] },
+    { label: "Display", fields: ["showInDocumentsNav"] }
+  ]
+});
+
 // src/components/sections/brand-guide.ts
-var brandGuideSectionDefs = [Colors_default, IconList_default, DoDontMedia_default];
+var brandGuideSectionDefs = [Colors_default, IconList_default, DoDontMedia_default, Document_default];
 
 export {
   stripHtmlToPlainText,
   truncate,
   pluralize,
+  removeChildAt,
+  duplicateChildAt,
+  setChildColSpan,
+  isSpacer,
+  occupiedColumns,
+  trimTrailingSpacers,
   ColorSpaceSchema,
   ColorItemSchema,
   brandGuideSectionDefs

package/dist/chunk-BS5AQHZG.js

@@ -0,0 +1,45 @@
+// src/schemas/documents.ts
+import { z } from "zod";
+var DOCUMENT_MANIFEST_PATH = "src/content/document-manifest.json";
+var DOCUMENT_GIT_MAX_BYTES = 2621440;
+var DOCUMENT_BUCKET_MAX_BYTES = 209715200;
+var DOCUMENT_MIME_TO_EXT = {
+  "application/pdf": "pdf",
+  "text/html": "html"
+};
+var DOCUMENT_KIND_TO_MIME = {
+  pdf: "application/pdf",
+  html: "text/html"
+};
+var DocumentManifestEntrySchema = z.object({
+  filename: z.string(),
+  size: z.number().int().positive(),
+  kind: z.enum(["pdf", "html"]),
+  storage: z.enum(["git", "bucket"]),
+  /** git: repo path under assets/documents/…; bucket: site-relative object key. */
+  path: z.string()
+});
+var DocumentManifestSchema = z.record(z.string(), DocumentManifestEntrySchema);
+function documentFileUrl(documentId, filename, opts = {}) {
+  const base = `/api/document-file/${documentId}/${encodeURIComponent(filename)}`;
+  return opts.download ? `${base}?download=1` : base;
+}
+function documentGitPath(slugName, hash, kind) {
+  return `assets/documents/${slugName}-${hash}/original.${kind}`;
+}
+function documentBucketPath(documentId, kind) {
+  return `documents/${documentId}/original.${kind}`;
+}
+
+export {
+  DOCUMENT_MANIFEST_PATH,
+  DOCUMENT_GIT_MAX_BYTES,
+  DOCUMENT_BUCKET_MAX_BYTES,
+  DOCUMENT_MIME_TO_EXT,
+  DOCUMENT_KIND_TO_MIME,
+  DocumentManifestEntrySchema,
+  DocumentManifestSchema,
+  documentFileUrl,
+  documentGitPath,
+  documentBucketPath
+};

package/dist/{chunk-NA5EJM6Z.js → chunk-CZLYECHC.js}

@@ -5,8 +5,8 @@ import {
   upgradeLegacySection
 } from "./chunk-5BM2Y3NJ.js";
 import {
-  NavFileSchema
-} from "./chunk-HJSE6SK5.js";
+  NavEntrySchema
+} from "./chunk-REDDTTGJ.js";
 import {
   getSectionSchema
 } from "./chunk-TZQPOR5A.js";
@@ -153,13 +153,23 @@ function safeRedirect(url, fallback) {
 
 // src/lib/loader.ts
 function parseNavFile(navFile) {
-  if (!navFile) return [];
-  const result = NavFileSchema.safeParse(navFile);
-  if (!result.success) {
+  if (!navFile) return { entries: [], degraded: false };
+  const rawEntries = navFile.entries;
+  if (!Array.isArray(rawEntries)) {
     console.warn("Invalid nav.json, falling back to a flat navigation");
-    return [];
+    return { entries: [], degraded: true };
   }
-  return result.data.entries;
+  const entries = [];
+  let dropped = 0;
+  for (const raw of rawEntries) {
+    const result = NavEntrySchema.safeParse(raw);
+    if (result.success) entries.push(result.data);
+    else dropped++;
+  }
+  if (dropped > 0) {
+    console.warn(`nav.json: dropped ${dropped} entr${dropped === 1 ? "y" : "ies"} this package version cannot represent; navigation is degraded`);
+  }
+  return { entries, degraded: dropped > 0 };
 }
 function mergeSiteContent(index, sectionFiles, navFile) {
   const sections = [];
@@ -192,7 +202,8 @@ function mergeSiteContent(index, sectionFiles, navFile) {
       sections.push({ section: raw, meta });
     }
   }
-  return { sections, index: { ...index, nav: parseNavFile(navFile) } };
+  const nav = parseNavFile(navFile);
+  return { sections, index: { ...index, nav: nav.entries }, navDegraded: nav.degraded };
 }
 function loadStaticSiteContent(index, sectionGlob, navFile) {
   const sectionFiles = {};

package/dist/{chunk-HKHEAH5F.js → chunk-GOCFTXR3.js}

@@ -1,9 +1,15 @@
 import {
   brandGuideSectionDefs,
+  duplicateChildAt,
+  isSpacer,
+  occupiedColumns,
   pluralize,
+  removeChildAt,
+  setChildColSpan,
   stripHtmlToPlainText,
+  trimTrailingSpacers,
   truncate
-} from "./chunk-KP4DWTPR.js";
+} from "./chunk-72FMQQIA.js";
 import {
   DeleteButton,
   DragHandle,
@@ -17,7 +23,7 @@ import {
   buildBlockDropData,
   canDropBlock,
   isBlockDragData
-} from "./chunk-GYCBWGVW.js";
+} from "./chunk-LBHQWIVL.js";
 import {
   EditableRichText,
   defineHeadingSection
@@ -717,64 +723,6 @@ function useBlockDropZone({ containerId, index, toColumn, allowedEdges, enabled
   return { dropRef, closestEdge };
 }
 
-// src/lib/container-ops.ts
-function getContainerChildren(block) {
-  const content = block.content;
-  return Array.isArray(content?.children) ? content.children : [];
-}
-function withChildren(container, children) {
-  return { ...container, content: { ...container.content, children } };
-}
-function containerColumns(container) {
-  const n = container.content?.columns;
-  return typeof n === "number" && n >= 1 ? n : 1;
-}
-function removeChildAt(container, index) {
-  const children = getContainerChildren(container);
-  if (index < 0 || index >= children.length) return { container, removed: null };
-  const next = [...children];
-  const [removed] = next.splice(index, 1);
-  return { container: withChildren(container, next), removed };
-}
-function duplicateChildAt(container, index, newId2) {
-  const children = getContainerChildren(container);
-  if (index < 0 || index >= children.length) return container;
-  const clone = { ...JSON.parse(JSON.stringify(children[index])), id: newId2() };
-  const next = [...children];
-  next.splice(index + 1, 0, clone);
-  return withChildren(container, next);
-}
-function setChildColSpan(container, index, span) {
-  const children = getContainerChildren(container);
-  if (index < 0 || index >= children.length) return container;
-  const clamped = Math.max(1, Math.min(span, containerColumns(container)));
-  const next = children.map((child, i) => {
-    if (i !== index) return child;
-    if (clamped <= 1) {
-      const { layout: _drop, ...rest } = child;
-      return rest;
-    }
-    return { ...child, layout: { ...child.layout, colSpan: clamped } };
-  });
-  return withChildren(container, next);
-}
-function effectiveSpan(child, columns) {
-  return isSpacer(child) ? 1 : Math.min(child.layout?.colSpan ?? 1, columns);
-}
-function isSpacer(child) {
-  return child.type === "spacer";
-}
-function occupiedColumns(children, columns) {
-  return children.reduce((sum, c) => sum + effectiveSpan(c, columns), 0);
-}
-function trimTrailingSpacers(container) {
-  const children = getContainerChildren(container);
-  let end = children.length;
-  while (end > 0 && isSpacer(children[end - 1])) end--;
-  if (end === children.length) return container;
-  return withChildren(container, children.slice(0, end));
-}
-
 // src/components/sections/Container/Container.tsx
 import { jsx as jsx13, jsxs as jsxs5 } from "react/jsx-runtime";
 var ROW_EDGES = ["left", "right"];