@drawnagency/primitives 0.1.114 → 0.1.115

package/dist/chunk-DJABADOO.js

@@ -0,0 +1,131 @@
+import {
+  reconcileNavReport
+} from "./chunk-DJOGPSRU.js";
+import {
+  mergeTags,
+  reconcileTagsReport
+} from "./chunk-4WQ36ZP7.js";
+import {
+  NavEntrySchema,
+  NavFileSchema,
+  TagEntrySchema,
+  TagsFileSchema
+} from "./chunk-4Y2JQQZL.js";
+
+// src/lib/sidecars.ts
+var NAV = {
+  name: "nav",
+  path: "src/content/nav.json",
+  fileKey: "entries",
+  entrySchema: NavEntrySchema,
+  fileSchema: NavFileSchema,
+  reconcile: (entries, index) => reconcileNavReport(entries, index.pages),
+  // Grouping is edited rarely and has no dirty tracking, so persisted remote
+  // state beats unsaved local edits. A remote without the Sidecar (an older
+  // server) keeps ours rather than flattening it.
+  rebase: ({ local, remote }) => remote !== void 0 ? remote : local,
+  words: {
+    entries: "navigation entries",
+    changes: "Page grouping changes",
+    valid: "a valid navigation tree",
+    shape: 'an array of {kind:"page",pageId} / {kind:"group",id,label,startCollapsed,pageIds} entries'
+  }
+};
+var TAGS = {
+  name: "tags",
+  path: "src/content/tags.json",
+  fileKey: "tags",
+  entrySchema: TagEntrySchema,
+  fileSchema: TagsFileSchema,
+  reconcile: (entries, index) => reconcileTagsReport(entries, index.sections),
+  // Tagging is edited from every section's chrome, so remote-wins would drop
+  // unsaved tagging whenever a peer saved anything. See mergeTags.
+  rebase: mergeTags,
+  words: {
+    entries: "tag entries",
+    changes: "Tag changes",
+    valid: "a valid tag list",
+    shape: "an array of {id,label,sectionIds} entries"
+  }
+};
+var SIDECARS = [NAV, TAGS];
+function readEntries(def, raw) {
+  if (!Array.isArray(raw)) {
+    console.warn(`[sidecars] ${def.name}: entry list is not a list; reading it as empty and degraded`);
+    return { entries: [], degraded: true };
+  }
+  const entries = [];
+  let dropped = 0;
+  for (const item of raw) {
+    const parsed = def.entrySchema.safeParse(item);
+    if (parsed.success) entries.push(parsed.data);
+    else dropped++;
+  }
+  if (dropped > 0) {
+    console.warn(`[sidecars] ${def.name}: dropped ${dropped} entr${dropped === 1 ? "y" : "ies"} this package version cannot represent; the read is degraded`);
+  }
+  return { entries, degraded: dropped > 0 };
+}
+function readSidecar(def, file) {
+  if (file === void 0 || file === null) return { entries: [], degraded: false };
+  return readEntries(def, file[def.fileKey]);
+}
+function readSidecarText(def, text) {
+  if (text === void 0) return { entries: [], degraded: false };
+  let file;
+  try {
+    file = JSON.parse(text);
+  } catch {
+    console.warn(`[sidecars] ${def.name}: ${def.path} is not valid JSON; the read is degraded`);
+    return { entries: [], degraded: true };
+  }
+  return readSidecar(def, file);
+}
+function liftSidecars(rawIndex) {
+  const raw = rawIndex !== null && typeof rawIndex === "object" ? rawIndex : {};
+  return {
+    ...raw.nav !== void 0 ? { nav: readEntries(NAV, raw.nav) } : {},
+    ...raw.tags !== void 0 ? { tags: readEntries(TAGS, raw.tags) } : {}
+  };
+}
+function planSidecarWrite(def, posted, branch, index) {
+  if (posted === void 0) return { action: "untouched" };
+  const skip = (reason) => ({
+    action: "skip",
+    warning: `${def.path} was left unchanged: ${reason} ${def.words.changes} from this save did not land. Upgrade the site's @drawnagency packages (or repair ${def.path} directly in the repo), then retry.`
+  });
+  if (posted.degraded) {
+    return {
+      action: "skip",
+      warning: `${def.name} was not ${def.words.valid}, so ${def.path} was left unchanged (it held entries this package version cannot read). Expected ${def.words.shape}.`
+    };
+  }
+  if (branch.kind === "unreadable") {
+    return skip("the current file could not be read to confirm the replacement loses nothing.");
+  }
+  if (branch.kind === "present") {
+    let existing;
+    try {
+      existing = JSON.parse(branch.text);
+    } catch {
+      return skip("the current file is not valid JSON, so this version cannot prove a replacement keeps its entries.");
+    }
+    if (!def.fileSchema.safeParse(existing).success) {
+      return skip(`the current file holds ${def.words.entries} this package version cannot represent (likely written by a newer version).`);
+    }
+  } else if (posted.entries.length === 0) {
+    return { action: "untouched" };
+  }
+  const { entries } = def.reconcile(posted.entries, index);
+  return { action: "write", path: def.path, content: JSON.stringify({ [def.fileKey]: entries }, null, 2) };
+}
+
+export {
+  NAV,
+  TAGS,
+  SIDECARS,
+  readSidecar,
+  readSidecarText,
+  liftSidecars,
+  planSidecarWrite
+};

package/dist/{chunk-IP2SEBAJ.js → chunk-DJOGPSRU.js}

@@ -1,9 +1,13 @@
 import {
-  RESERVED_SLUGS
-} from "./chunk-PTY2RG2K.js";
+  diagnosticsCollector
+} from "./chunk-GNF6KFQ7.js";
 
 // src/lib/nav-tree.ts
 function reconcileNav(entries, pages) {
+  return reconcileNavReport(entries, pages).entries;
+}
+function reconcileNavReport(entries, pages) {
+  const report = diagnosticsCollector();
   const entryList = Array.isArray(entries) ? entries : [];
   const pageList = Array.isArray(pages) ? pages : [];
   const validIds = /* @__PURE__ */ new Set();
@@ -15,18 +19,36 @@ function reconcileNav(entries, pages) {
   const result = [];
   for (const entry of entryList) {
     if (entry?.kind === "page") {
-      if (!validIds.has(entry.pageId) || placed.has(entry.pageId)) continue;
+      if (!validIds.has(entry.pageId)) {
+        report.add("dangling", entry.pageId);
+        continue;
+      }
+      if (placed.has(entry.pageId)) {
+        report.add("duplicate-member", entry.pageId);
+        continue;
+      }
       placed.add(entry.pageId);
       result.push({ ...entry });
       continue;
     }
     if (entry?.kind !== "group") continue;
     if (typeof entry.id !== "string" || entry.id === "") continue;
-    if (seenGroupIds.has(entry.id)) continue;
+    if (seenGroupIds.has(entry.id)) {
+      report.add("duplicate-id", entry.id);
+      continue;
+    }
     seenGroupIds.add(entry.id);
     const claimed = Array.isArray(entry.pageIds) ? entry.pageIds : [];
     const pageIds = claimed.filter((id) => {
-      if (typeof id !== "string" || !validIds.has(id) || placed.has(id)) return false;
+      if (typeof id !== "string") return false;
+      if (!validIds.has(id)) {
+        report.add("dangling", id);
+        return false;
+      }
+      if (placed.has(id)) {
+        report.add("duplicate-member", id);
+        return false;
+      }
       placed.add(id);
       return true;
     });
@@ -42,9 +64,10 @@ function reconcileNav(entries, pages) {
   for (const p of pageList) {
     if (!p?.id || placed.has(p.id)) continue;
     placed.add(p.id);
+    report.add("unlisted", p.id);
     result.push({ kind: "page", pageId: p.id });
   }
-  return result;
+  return { entries: result, diagnostics: report.list() };
 }
 function navEntries(index) {
   return reconcileNav(index.nav ?? [], index.pages);
@@ -132,67 +155,9 @@ function moveNavEntry(index, from, to) {
   return withNav(index, entries);
 }
 
-// src/lib/pages.ts
-function pageDisplayTitle(title) {
-  return title || "Untitled";
-}
-function slugifyPageSlug(input) {
-  return input.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-}
-function uniquePageSlug(base, existing) {
-  const taken = new Set(existing);
-  const reserved = new Set(RESERVED_SLUGS);
-  let candidate = base || "page";
-  if (!taken.has(candidate) && !reserved.has(candidate)) return candidate;
-  let n = 2;
-  while (taken.has(`${candidate}-${n}`) || reserved.has(`${candidate}-${n}`)) n++;
-  return `${candidate}-${n}`;
-}
-function pageById(index, id) {
-  return index.pages.find((p) => p.id === id);
-}
-function audiencePasses(access, audience) {
-  if (access.length === 0) return true;
-  if (!audience) return true;
-  return access.includes(audience);
-}
-function addPage(index, id) {
-  const slug = uniquePageSlug("new-page", index.pages.map((p) => p.slug));
-  const page = {
-    id,
-    title: "",
-    slug,
-    isHome: false,
-    showInNav: true,
-    status: "live",
-    access: [],
-    order: []
-  };
-  return {
-    ...index,
-    pages: [...index.pages, page],
-    nav: [...navEntries(index), { kind: "page", pageId: id }]
-  };
-}
-function deletePage(index, pageId) {
-  const page = pageById(index, pageId);
-  if (!page || page.isHome) return { index, removedSectionIds: [] };
-  const removedSectionIds = [...page.order];
-  const nextSections = { ...index.sections };
-  for (const id of removedSectionIds) delete nextSections[id];
-  return {
-    index: {
-      ...index,
-      pages: index.pages.filter((p) => p.id !== pageId),
-      sections: nextSections,
-      nav: navEntries(index).filter((e) => !(e.kind === "page" && e.pageId === pageId)).map((e) => e.kind === "group" ? { ...e, pageIds: e.pageIds.filter((id) => id !== pageId) } : e)
-    },
-    removedSectionIds
-  };
-}
-
 export {
   reconcileNav,
+  reconcileNavReport,
   navEntries,
   pagesInNavOrder,
   groupOfPage,
@@ -201,11 +166,5 @@ export {
   renameGroup,
   setGroupStartCollapsed,
   deleteGroup,
-  moveNavEntry,
-  pageDisplayTitle,
-  slugifyPageSlug,
-  uniquePageSlug,
-  audiencePasses,
-  addPage,
-  deletePage
+  moveNavEntry
 };

package/dist/{chunk-N3G7DOU3.js → chunk-FHTKSELX.js}

@@ -1,7 +1,3 @@
-import {
-  Checkbox,
-  Tabs
-} from "./chunk-JR24U7FJ.js";
 import {
   EditableGrid,
   EditableList,
@@ -9,7 +5,11 @@ import {
   MediaBlock,
   containerGridClass,
   useEditableCollection
-} from "./chunk-Y5QECJX7.js";
+} from "./chunk-YV3YSZEB.js";
+import {
+  Checkbox,
+  Tabs
+} from "./chunk-JR24U7FJ.js";
 import {
   DragHandle,
   DropEdgeIndicator,
@@ -19,7 +19,7 @@ import {
   Select,
   useMediaLibrary,
   usePages
-} from "./chunk-5KSAS4VY.js";
+} from "./chunk-RIITGTV3.js";
 import {
   IconButton
 } from "./chunk-IIDKW7AV.js";

package/dist/chunk-GNF6KFQ7.js

@@ -0,0 +1,18 @@
+// src/lib/sidecar-diagnostics.ts
+function diagnosticsCollector() {
+  const byCode = /* @__PURE__ */ new Map();
+  return {
+    add(code, id) {
+      const ids = byCode.get(code) ?? /* @__PURE__ */ new Set();
+      ids.add(id);
+      byCode.set(code, ids);
+    },
+    list() {
+      return [...byCode].map(([code, ids]) => ({ code, ids: [...ids] }));
+    }
+  };
+}
+
+export {
+  diagnosticsCollector
+};

package/dist/{chunk-QHMKIODQ.js → chunk-HHNPSKPT.js}

@@ -1,80 +1,3 @@
-import {
-  slugifyPageSlug
-} from "./chunk-IP2SEBAJ.js";
-
-// src/media/utils.ts
-async function hashFileBuffer(buffer) {
-  if (typeof crypto !== "undefined" && crypto.subtle) {
-    const hashBuffer = await crypto.subtle.digest("SHA-256", buffer);
-    const hashArray = new Uint8Array(hashBuffer);
-    return Array.from(hashArray.slice(0, 8)).map((b) => b.toString(16).padStart(2, "0")).join("");
-  }
-  const bytes = new Uint8Array(buffer);
-  const seeds = [2166136261, 84696351];
-  let result = "";
-  for (const seed of seeds) {
-    let h = seed;
-    for (let i = 0; i < bytes.length; i++) {
-      h ^= bytes[i];
-      h = Math.imul(h, 16777619);
-    }
-    result += (h >>> 0).toString(16).padStart(8, "0");
-  }
-  return result;
-}
-function sanitizeMediaName(name) {
-  return slugifyPageSlug(name.replace(/\.[^.]+$/, ""));
-}
-var MIME_TO_EXT = {
-  "image/gif": "gif",
-  "image/apng": "apng",
-  "image/png": "png",
-  "image/jpeg": "jpg",
-  "image/webp": "webp",
-  "image/svg+xml": "svg",
-  "video/mp4": "mp4",
-  "video/webm": "webm"
-};
-var EXT_TO_MIME = {
-  ...Object.fromEntries(
-    Object.entries(MIME_TO_EXT).map(([mime, ext]) => [`.${ext}`, mime])
-  ),
-  ".jpeg": "image/jpeg"
-};
-function mimeToExt(mime) {
-  return MIME_TO_EXT[mime] ?? "bin";
-}
-function mediaThumbnailUrl(item) {
-  if (item.mimeType === "image/svg+xml" || item.kind !== "image") {
-    return `/api/media/${item.id}/original.${mimeToExt(item.mimeType)}`;
-  }
-  if (item.variants.length === 0) return null;
-  const smallest = item.variants.reduce((a, b) => a.width < b.width ? a : b);
-  return `/api/media/${item.id}/${smallest.width}.webp`;
-}
-function imageThumbnailUrl(item) {
-  return item?.kind === "image" ? mediaThumbnailUrl(item) : null;
-}
-function displayFilenameExt(mime) {
-  const ext = MIME_TO_EXT[mime];
-  return ext ? `.${ext}` : "";
-}
-function displayFilename(originalName, mimeType) {
-  const ext = MIME_TO_EXT[mimeType];
-  if (!ext) return originalName;
-  const suffix = `.${ext}`;
-  if (originalName.toLowerCase().endsWith(suffix)) return originalName;
-  return `${originalName}${suffix}`;
-}
-function formatFileSize(bytes) {
-  if (bytes >= 1048576) return `${Math.round(bytes / 1048576)}MB`;
-  if (bytes >= 1024) return `${Math.round(bytes / 1024)}KB`;
-  return `${bytes}B`;
-}
-function displayName(item) {
-  return item.originalName;
-}
-
 // src/media/queue.ts
 var ProcessingQueue = class {
   items = /* @__PURE__ */ new Map();
@@ -142,7 +65,8 @@ var ProcessingQueue = class {
           primaryBlob: msg.primaryBlob,
           posterBlob: msg.posterBlob,
           width: msg.width,
-          height: msg.height
+          height: msg.height,
+          plan: msg.plan
         };
         this.options.onEvent({ type: "complete", item: { ...item } });
         delete item.result;
@@ -432,17 +356,6 @@ function getMediaProvider() {
 }
 
 export {
-  hashFileBuffer,
-  sanitizeMediaName,
-  MIME_TO_EXT,
-  EXT_TO_MIME,
-  mimeToExt,
-  mediaThumbnailUrl,
-  imageThumbnailUrl,
-  displayFilenameExt,
-  displayFilename,
-  formatFileSize,
-  displayName,
   ProcessingQueue,
   resolveMedia,
   resolveManifestReferences,

package/dist/{chunk-PZPGJZRG.js → chunk-JXATNKLV.js}

@@ -1,15 +1,15 @@
 import {
   EditablePlainText
-} from "./chunk-Y5QECJX7.js";
-import {
-  usePages
-} from "./chunk-5KSAS4VY.js";
+} from "./chunk-YV3YSZEB.js";
 import {
   Button
 } from "./chunk-GGYY3JQJ.js";
+import {
+  usePages
+} from "./chunk-RIITGTV3.js";
 import {
   toSectionId
-} from "./chunk-VUYCRBJK.js";
+} from "./chunk-WYOFQHKI.js";
 import {
   ensureSanitizer,
   isSanitizerReady,

package/dist/{chunk-PLANHXS7.js → chunk-NX7TFHA4.js}

@@ -1,3 +1,10 @@
+import {
+  Kbd,
+  Tooltip
+} from "./chunk-JCDZAFX2.js";
+import {
+  Button
+} from "./chunk-GGYY3JQJ.js";
 import {
   Checkbox,
   Tabs
@@ -10,20 +17,13 @@ import {
   Select,
   useMediaLibrary,
   useResolvedMedia
-} from "./chunk-5KSAS4VY.js";
-import {
-  Kbd,
-  Tooltip
-} from "./chunk-JCDZAFX2.js";
-import {
-  Button
-} from "./chunk-GGYY3JQJ.js";
+} from "./chunk-RIITGTV3.js";
 import {
   IconButton
 } from "./chunk-IIDKW7AV.js";
 import {
   formatFileSize
-} from "./chunk-QHMKIODQ.js";
+} from "./chunk-CDBURDPX.js";
 import {
   cn
 } from "./chunk-7EOSDFS3.js";

package/dist/{chunk-PNSCDBU7.js → chunk-O37AV27P.js}

@@ -7,10 +7,6 @@ import {
 import {
   getSectionSchemaForType
 } from "./chunk-DMCGN5AS.js";
-import {
-  NavEntrySchema,
-  TagEntrySchema
-} from "./chunk-4Y2JQQZL.js";
 import {
   getAllSchemas
 } from "./chunk-FTPETWXE.js";
@@ -111,45 +107,7 @@ function safeRedirect(url, fallback) {
 }
 
 // src/lib/loader.ts
-function parseNavFile(navFile) {
-  if (!navFile) return { entries: [], degraded: false };
-  const rawEntries = navFile.entries;
-  if (!Array.isArray(rawEntries)) {
-    console.warn("[loader] Invalid nav.json, falling back to a flat navigation");
-    return { entries: [], degraded: true };
-  }
-  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(`[loader] nav.json: dropped ${dropped} entr${dropped === 1 ? "y" : "ies"} this package version cannot represent; navigation is degraded`);
-  }
-  return { entries, degraded: dropped > 0 };
-}
-function parseTagsFile(tagsFile) {
-  if (!tagsFile) return { tags: [], degraded: false };
-  const rawTags = tagsFile.tags;
-  if (!Array.isArray(rawTags)) {
-    console.warn("[loader] Invalid tags.json, falling back to no tags");
-    return { tags: [], degraded: true };
-  }
-  const tags = [];
-  let dropped = 0;
-  for (const raw of rawTags) {
-    const result = TagEntrySchema.safeParse(raw);
-    if (result.success) tags.push(result.data);
-    else dropped++;
-  }
-  if (dropped > 0) {
-    console.warn(`[loader] tags.json: dropped ${dropped} entr${dropped === 1 ? "y" : "ies"} this package version cannot represent; tags are degraded`);
-  }
-  return { tags, degraded: dropped > 0 };
-}
-function mergeSiteContent(index, sectionFiles, navFile, tagsSidecar = { loaded: false }) {
+function mergeSiteContent(index, sectionFiles, sidecars = {}) {
   const sections = [];
   const canValidate = getAllSchemas().length >= 2;
   const orderedIds = index.pages.flatMap((p) => p.order);
@@ -180,23 +138,22 @@ function mergeSiteContent(index, sectionFiles, navFile, tagsSidecar = { loaded:
       sections.push({ section: raw, meta });
     }
   }
-  const nav = parseNavFile(navFile);
-  const tags = tagsSidecar.loaded ? parseTagsFile(tagsSidecar.file) : null;
+  const { nav, tags } = sidecars;
   return {
     sections,
-    index: { ...index, nav: nav.entries, ...tags ? { tags: tags.tags } : {} },
-    navDegraded: nav.degraded,
+    index: { ...index, nav: nav?.entries ?? [], ...tags ? { tags: tags.entries } : {} },
+    navDegraded: nav?.degraded ?? false,
     tagsDegraded: tags?.degraded ?? false
   };
 }
-function loadStaticSiteContent(index, sectionGlob, navFile, tagsSidecar = { loaded: false }) {
+function loadStaticSiteContent(index, sectionGlob, sidecars = {}) {
   const sectionFiles = {};
   for (const [path, data] of Object.entries(sectionGlob)) {
     const filename = path.split("/").pop();
     const id = filename.replace(".json", "");
     sectionFiles[id] = data;
   }
-  return mergeSiteContent(index, sectionFiles, navFile, tagsSidecar);
+  return mergeSiteContent(index, sectionFiles, sidecars);
 }
 
 export {

package/dist/{chunk-5KSAS4VY.js → chunk-RIITGTV3.js}

@@ -1,6 +1,6 @@
 import {
   getMediaProvider
-} from "./chunk-QHMKIODQ.js";
+} from "./chunk-HHNPSKPT.js";
 import {
   cn
 } from "./chunk-7EOSDFS3.js";

package/dist/chunk-S7QRHUWO.js

@@ -0,0 +1,8 @@
+// src/lib/slug.ts
+function slugifyPageSlug(input) {
+  return input.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+
+export {
+  slugifyPageSlug
+};