@drawnagency/primitives 0.1.114 → 0.1.116

package/dist/lib/loader.d.ts

@@ -1,5 +1,8 @@
 import { type Section } from "../schemas/sections";
 import { type SiteIndex, type SectionMeta } from "../schemas/site-config";
+import type { NavEntry } from "../schemas/nav";
+import type { TagEntry } from "../schemas/tags";
+import type { SidecarRead } from "./sidecars";
 export interface LoadedSection {
     section: Section;
     meta: SectionMeta;
@@ -10,39 +13,35 @@ export interface LoadedSection {
 export interface SiteContent {
     sections: LoadedSection[];
     index: SiteIndex;
-    /** True when nav.json was present but held entries this package version could
-     *  not represent (unknown kinds, invalid shapes) — the returned nav is missing
-     *  them. Writers must treat a degraded nav as read-only: wholesale-replacing
-     *  nav.json from a degraded read permanently destroys the entries this
-     *  version dropped. */
+    /** A Degraded read of nav.json (see SidecarRead): the returned nav is missing
+     *  entries, so writers treat it as read-only — wholesale-replacing nav.json
+     *  from it permanently destroys the entries this version dropped. */
     navDegraded: boolean;
     /** Same contract as navDegraded, for tags.json: a degraded read is
      *  read-only for tags. */
     tagsDegraded: boolean;
 }
 /**
- * Whether a load looked for tags.json. Not loaded ⇒ no `index.tags` is attached
- * and writers leave the file alone; loaded ⇒ `file` is its parsed contents,
- * with null/undefined meaning absent (an empty registry). Unlike nav, the
- * difference is load-bearing — an attached `[]` that a writer saves back
- * deletes every tag — hence an explicit flag rather than undefined-vs-null.
+ * The Sidecars a load read, from the Sidecar module's readers. A Sidecar the
+ * load did not look for is omitted. Tags then stay unattached ("not loaded":
+ * writers leave tags.json alone, where an attached `[]` saved back would delete
+ * every tag). Nav is attached as `[]` either way — the editor has no nav gate
+ * yet to make "not loaded" safe for nav (exploration B).
  */
-export type TagsSidecar = {
-    loaded: false;
-} | {
-    loaded: true;
-    file: unknown;
+export type SidecarReads = {
+    nav?: SidecarRead<NavEntry>;
+    tags?: SidecarRead<TagEntry>;
 };
 /**
  * Merge a validated index with raw section file contents.
  * Validates each section file against its Zod schema.
  * Returns sections in the concatenated order of every page's order.
  */
-export declare function mergeSiteContent(index: SiteIndex, sectionFiles: Record<string, unknown>, navFile?: unknown, tagsSidecar?: TagsSidecar): SiteContent;
+export declare function mergeSiteContent(index: SiteIndex, sectionFiles: Record<string, unknown>, sidecars?: SidecarReads): SiteContent;
 /**
  * Build a SiteContent from a Vite `import.meta.glob` result.
  * Callers glob the section JSON files at build time, pass the parsed index, and
  * receive sections merged across every page's order.
  */
-export declare function loadStaticSiteContent(index: SiteIndex, sectionGlob: Record<string, unknown>, navFile?: unknown, tagsSidecar?: TagsSidecar): SiteContent;
+export declare function loadStaticSiteContent(index: SiteIndex, sectionGlob: Record<string, unknown>, sidecars?: SidecarReads): SiteContent;
 //# sourceMappingURL=loader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/lib/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAOvF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB;+DAC2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB;;;;2BAIuB;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB;8BAC0B;IAC1B,YAAY,EAAE,OAAO,CAAC;CACvB;AAyDD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,OAAO,EACjB,WAAW,GAAE,WAA+B,GAC3C,WAAW,CA4Db;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,OAAO,EACjB,WAAW,GAAE,WAA+B,GAC3C,WAAW,CAQb"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/lib/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB;+DAC2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB;;yEAEqE;IACrE,WAAW,EAAE,OAAO,CAAC;IACrB;8BAC0B;IAC1B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,GAAG,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;CAAE,CAAC;AAEzF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,GAAE,YAAiB,GAC1B,WAAW,CA2Db;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,GAAE,YAAiB,GAC1B,WAAW,CAQb"}

package/dist/lib/media-ops.d.ts

@@ -0,0 +1,73 @@
+import type { MediaItem, MediaManifest } from "../schemas/media";
+import type { DocumentManifest, DocumentManifestEntry } from "../schemas/documents";
+export type MediaBlob = {
+    path: string;
+    base64: string;
+};
+export type MediaOp = 
+/**
+ * A new image and its variant files, keyed by its id (the content hash).
+ * `alt` is the caller's alt text, if it sent one — the only alt applied when
+ * the image turns out to be in the library already (`entry.alt` is just the
+ * new entry's default).
+ */
+{
+    op: "addImage";
+    entry: MediaItem;
+    blobs: MediaBlob[];
+    alt?: string;
+} | {
+    op: "setImageAlt";
+    imageId: string;
+    alt: string;
+} | {
+    op: "deleteImage";
+    imageId: string;
+}
+/**
+ * A document's manifest entry, with its bytes when they ride in the commit
+ * (git tier; bucket-tier bytes are uploaded beforehand). For an id already in
+ * the library — git-tier ids are the content hash, so the same bytes — only
+ * the filename is applied: its stored bytes and path stay. That is how a
+ * rename lands.
+ */
+ | {
+    op: "putDocument";
+    documentId: string;
+    entry: DocumentManifestEntry;
+    blob?: MediaBlob;
+};
+/**
+ * Per op, in order. `existed` means `addImage` found the image already in the
+ * library: its bytes are not committed again, and only a differing alt text is
+ * applied.
+ */
+export type MediaOpOutcome = "added" | "existed" | "updated" | "deleted";
+export type AppliedMediaOps = {
+    ok: true;
+    images: MediaManifest;
+    /** Null when no op touched documents, so the write leaves that file alone. */
+    documents: DocumentManifest | null;
+    uploads: {
+        item: {
+            id: string;
+            folder: string;
+        };
+        blobs: MediaBlob[];
+    }[];
+    /** Images whose variant folders the write deletes. */
+    deletions: {
+        id: string;
+        folder: string;
+    }[];
+    outcomes: MediaOpOutcome[];
+};
+export declare function applyMediaOps(manifests: {
+    images: MediaManifest;
+    documents: DocumentManifest;
+}, ops: MediaOp[]): AppliedMediaOps | {
+    ok: false;
+    code: "not_found";
+    error: string;
+};
+//# sourceMappingURL=media-ops.d.ts.map

package/dist/lib/media-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-ops.d.ts","sourceRoot":"","sources":["../../src/lib/media-ops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AASpF,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,OAAO;AACjB;;;;;GAKG;AACD;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACxC;;;;;;GAMG;GACD;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE9F;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,aAAa,CAAC;IACtB,8EAA8E;IAC9E,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,EAAE,CAAC;IACxE,sDAAsD;IACtD,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAAC;AAEF,wBAAgB,aAAa,CAC3B,SAAS,EAAE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,EACjE,GAAG,EAAE,OAAO,EAAE,GACb,eAAe,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA2DnE"}

package/dist/lib/media-ops.js

@@ -0,0 +1,60 @@
+import "../chunk-JSBRDJBE.js";
+
+// src/lib/media-ops.ts
+function applyMediaOps(manifests, ops) {
+  const images = { ...manifests.images, images: { ...manifests.images.images } };
+  let documents = null;
+  const uploads = [];
+  const deletions = [];
+  const outcomes = [];
+  const keyOf = (imageId) => imageId in images.images ? imageId : Object.keys(images.images).find((key) => images.images[key].id === imageId);
+  const notFound = (imageId) => ({ ok: false, code: "not_found", error: `No media with imageId "${imageId}" in the site's media library.` });
+  for (const op of ops) {
+    switch (op.op) {
+      case "addImage": {
+        const key = keyOf(op.entry.id);
+        if (key === void 0) {
+          images.images[op.entry.id] = op.entry;
+          uploads.push({ item: { id: op.entry.id, folder: op.entry.folder }, blobs: op.blobs });
+          outcomes.push("added");
+        } else {
+          if (op.alt !== void 0) images.images[key] = { ...images.images[key], alt: op.alt };
+          outcomes.push("existed");
+        }
+        break;
+      }
+      case "setImageAlt": {
+        const key = keyOf(op.imageId);
+        if (key === void 0) return notFound(op.imageId);
+        images.images[key] = { ...images.images[key], alt: op.alt };
+        outcomes.push("updated");
+        break;
+      }
+      case "deleteImage": {
+        const key = keyOf(op.imageId);
+        if (key === void 0) return notFound(op.imageId);
+        deletions.push({ id: key, folder: images.images[key].folder });
+        delete images.images[key];
+        outcomes.push("deleted");
+        break;
+      }
+      case "putDocument": {
+        documents ??= { ...manifests.documents };
+        const existing = documents[op.documentId];
+        if (existing) {
+          documents[op.documentId] = { ...existing, filename: op.entry.filename };
+          outcomes.push(existing.filename === op.entry.filename ? "existed" : "updated");
+        } else {
+          documents[op.documentId] = op.entry;
+          if (op.blob) uploads.push({ item: { id: op.documentId, folder: op.blob.path.split("/")[2] ?? "" }, blobs: [op.blob] });
+          outcomes.push("added");
+        }
+        break;
+      }
+    }
+  }
+  return { ok: true, images, documents, uploads, deletions, outcomes };
+}
+export {
+  applyMediaOps
+};

package/dist/lib/nav-tree.d.ts

@@ -1,5 +1,6 @@
 import type { NavEntry, NavGroupEntry } from "../schemas/nav";
 import type { Page, SiteIndex } from "../schemas/site-config";
+import { type SidecarDiagnostic } from "./sidecar-diagnostics";
 /**
  * Repair an authored nav against the current page set.
  *
@@ -18,6 +19,11 @@ import type { Page, SiteIndex } from "../schemas/site-config";
  * prior state and defeat identity-based re-render checks.
  */
 export declare function reconcileNav(entries: NavEntry[], pages: Page[]): NavEntry[];
+/** reconcileNav plus what the repair changed — what a validator reports. */
+export declare function reconcileNavReport(entries: NavEntry[], pages: Page[]): {
+    entries: NavEntry[];
+    diagnostics: SidecarDiagnostic[];
+};
 /**
  * The ONLY sanctioned way to read the nav. Always reconciles, so callers never
  * have to reason about whether index.nav is present, stale, or authored by an

package/dist/lib/nav-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nav-tree.d.ts","sourceRoot":"","sources":["../../src/lib/nav-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAwD3E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,CAEvD;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,CAexD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAKlF;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAIxC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMrB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAKrE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAIvF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,SAAS,CAI5G;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAUxE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,SAAS,CAgC5F;AAqBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAkD5G"}
+{"version":3,"file":"nav-tree.d.ts","sourceRoot":"","sources":["../../src/lib/nav-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAErF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAE3E;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,QAAQ,EAAE,EACnB,KAAK,EAAE,IAAI,EAAE,GACZ;IAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAAC,WAAW,EAAE,iBAAiB,EAAE,CAAA;CAAE,CA4E3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,CAEvD;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,CAexD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAKlF;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAIxC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMrB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAKrE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAIvF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,SAAS,CAI5G;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAUxE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,SAAS,CAgC5F;AAqBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAkD5G"}

package/dist/lib/pages.d.ts

@@ -1,12 +1,13 @@
 import type { Page, SiteIndex, SectionMeta } from "../schemas/site-config";
 import { type DocumentOptions } from "../document/engine/settings";
+import { slugifyPageSlug } from "./slug";
 /**
  * Display fallback for blank page titles. addPage creates pages with an empty
  * title (the editor prompts for one), and closing the modal can leave it blank
  * — every UI that renders a page title must go through this.
  */
 export declare function pageDisplayTitle(title: string): string;
-export declare function slugifyPageSlug(input: string): string;
+export { slugifyPageSlug };
 export declare function uniquePageSlug(base: string, existing: string[]): string;
 export declare function pageById(index: SiteIndex, id: string): Page | undefined;
 export declare function homePage(index: SiteIndex): Page;

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

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

package/dist/lib/reference-validation.js

@@ -1,38 +1,9 @@
 import {
-  REFERENCE_TYPE
-} from "../chunk-5GFACGSN.js";
+  describeReferenceProblem,
+  referenceProblems
+} from "../chunk-FGQXHUAE.js";
+import "../chunk-5GFACGSN.js";
 import "../chunk-JSBRDJBE.js";
-
-// src/lib/reference-validation.ts
-var strings = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
-function referenceProblems(sections, index, tagIds) {
-  const onPage = new Set(index.pages.flatMap((p) => p.order));
-  const problems = [];
-  for (const { id, content } of sections) {
-    const body = content;
-    if (body?.type !== REFERENCE_TYPE && index.sections[id]?.type !== REFERENCE_TYPE) continue;
-    const picks = strings(body?.content?.sectionIds).filter((pick) => pick !== id);
-    const problem = {
-      referenceId: id,
-      unknownTagIds: tagIds ? strings(body?.content?.tagIds).filter((tag) => !tagIds.has(tag)) : [],
-      unplacedSectionIds: picks.filter((pick) => !onPage.has(pick)),
-      referencePickIds: picks.filter((pick) => onPage.has(pick) && index.sections[pick]?.type === REFERENCE_TYPE),
-      picksItself: strings(body?.content?.sectionIds).includes(id)
-    };
-    if (problem.unknownTagIds.length || problem.unplacedSectionIds.length || problem.referencePickIds.length || problem.picksItself) problems.push(problem);
-  }
-  return problems;
-}
-function describeReferenceProblem(problem) {
-  const list = (ids) => ids.map((id) => `"${id}"`).join(", ");
-  const issues = [
-    ...problem.unknownTagIds.length ? [`tagIds ${list(problem.unknownTagIds)} are not tags on this site`] : [],
-    ...problem.unplacedSectionIds.length ? [`sectionIds ${list(problem.unplacedSectionIds)} are not top-level sections on any page (a container's child cannot be picked \u2014 pick the container)`] : [],
-    ...problem.referencePickIds.length ? [`sectionIds ${list(problem.referencePickIds)} are References, which a Reference never shows`] : [],
-    ...problem.picksItself ? ["sectionIds includes the Reference itself"] : []
-  ];
-  return `Reference "${problem.referenceId}": ${issues.join("; ")}.`;
-}
 export {
   describeReferenceProblem,
   referenceProblems

package/dist/lib/section-check.d.ts

@@ -0,0 +1,49 @@
+import type { ZodError } from "zod";
+/**
+ * The first thing wrong with one section body: schema, then layout envelope,
+ * then nesting depth, then a Reference nested in a container. Only ever one — a
+ * body failing its schema is not also judged on its layout — so the write
+ * path's `errors[0]` stays the first failure it has always reported.
+ */
+export type SectionCheckError = {
+    code: "schema";
+    zodError: ZodError;
+} | {
+    code: "layout";
+    zodError: ZodError;
+} | {
+    code: "depth";
+} | {
+    code: "reference-in-container";
+};
+/** HTML entities found in one plain-text field, by path relative to the section. */
+export interface EntityFinding {
+    path: string;
+    entities: string[];
+}
+export interface SectionCheck {
+    /**
+     * No schema is registered for the type, so only the nesting bound was
+     * checked. Whether that is acceptable (a site-local type) or an unknown type
+     * is the caller's call.
+     */
+    unregistered: boolean;
+    error: SectionCheckError | null;
+    /** Empty whenever `error` is set. */
+    entities: EntityFinding[];
+}
+/**
+ * Judge one section body against `type`'s registered schema — the write path's
+ * (`validateContent`) per-section rules, kept here so the site validators can
+ * apply the same ones.
+ * Reads the schema registry only: callers register the schemas first.
+ */
+export declare function checkSection(type: string, body: unknown): SectionCheck;
+/**
+ * The write path's sentence for a section check's error, shared with
+ * validate_site so a dry run words a failure exactly as the save it predicts.
+ */
+export declare function sectionCheckMessage(sectionId: string, type: string, code: SectionCheckError["code"]): string;
+/** The write path's warning for one entity finding, shared with validate_site. */
+export declare function entityWarning(sectionId: string, { path, entities }: EntityFinding): string;
+//# sourceMappingURL=section-check.d.ts.map

package/dist/lib/section-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-check.d.ts","sourceRoot":"","sources":["../../src/lib/section-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAKpC;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAEvC,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChC,qCAAqC;IACrC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,CAgCtE;AAsED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,MAAM,CAW5G;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,aAAa,GAAG,MAAM,CAG1F"}

package/dist/lib/section-check.js

@@ -0,0 +1,14 @@
+import {
+  checkSection,
+  entityWarning,
+  sectionCheckMessage
+} from "../chunk-26V4YNOR.js";
+import "../chunk-5GFACGSN.js";
+import "../chunk-FTPETWXE.js";
+import "../chunk-NSCT3AMV.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  checkSection,
+  entityWarning,
+  sectionCheckMessage
+};

package/dist/lib/sidecar-diagnostics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What a Sidecar reconcile changed. Reconcile repairs silently on every read, so
+ * these are only ever warnings: a validator reports them, nothing rejects on them.
+ *  - dangling: ids of pages/sections the index does not have, dropped
+ *  - duplicate-id: a group/tag id used again, later uses dropped
+ *  - duplicate-member: a page placed twice / a section tagged twice, later placements dropped
+ *  - unlisted: pages missing from the nav, appended to its end (nav only)
+ *
+ * Its own leaf so nav-tree and tags can report without importing the Sidecar
+ * module that imports them.
+ */
+export type SidecarDiagnostic = {
+    code: "dangling" | "duplicate-id" | "duplicate-member" | "unlisted";
+    ids: string[];
+};
+export declare function diagnosticsCollector(): {
+    add(code: SidecarDiagnostic["code"], id: string): void;
+    list(): SidecarDiagnostic[];
+};
+//# sourceMappingURL=sidecar-diagnostics.d.ts.map

package/dist/lib/sidecar-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-diagnostics.d.ts","sourceRoot":"","sources":["../../src/lib/sidecar-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,kBAAkB,GAAG,UAAU,CAAC;IACpE,GAAG,EAAE,MAAM,EAAE,CAAC;CACf,CAAC;AAEF,wBAAgB,oBAAoB;cAGtB,iBAAiB,CAAC,MAAM,CAAC,MAAM,MAAM;YAKvC,iBAAiB,EAAE;EAI9B"}

package/dist/lib/sidecars.d.ts

@@ -0,0 +1,118 @@
+import type { ZodType } from "zod";
+import { type NavEntry } from "../schemas/nav";
+import { type TagEntry } from "../schemas/tags";
+import type { SiteIndex } from "../schemas/site-config";
+import type { SidecarDiagnostic } from "./sidecar-diagnostics";
+export type { SidecarDiagnostic };
+/**
+ * One definition per Sidecar — a content file kept beside index.json rather than
+ * on it, so a writer that predates it cannot drop it (CONTEXT.md). Every rule a
+ * caller would otherwise re-implement per file lives behind these: lenient
+ * parse, lifting the wire key off an index before IndexSchema strips it, and the
+ * two places the Sidecars genuinely differ — how a list is repaired against the
+ * index, and how concurrent edits rebase. Pure and browser-safe: the editor uses
+ * it during hydration, and callers do their own I/O.
+ */
+export interface SidecarDefinition<E> {
+    /** Also the key the Sidecar travels under on the wire (`index.nav`, `index.tags`). */
+    name: "nav" | "tags";
+    path: string;
+    /** The key holding the entry list inside the file. */
+    fileKey: "entries" | "tags";
+    entrySchema: ZodType<E>;
+    fileSchema: ZodType<unknown>;
+    /** Total, pure and idempotent; also reports what it repaired. */
+    reconcile(entries: E[], index: SiteIndex): {
+        entries: E[];
+        diagnostics: SidecarDiagnostic[];
+    };
+    /** The list after a collab rebase; `undefined` when no side carries one. */
+    rebase(args: {
+        base: E[] | undefined;
+        local: E[] | undefined;
+        remote: E[] | undefined;
+    }): E[] | undefined;
+    /** Words for a declined write's warning. */
+    words: {
+        /** What the file holds: "navigation entries". */
+        entries: string;
+        /** What did not land: "Page grouping changes". */
+        changes: string;
+        /** What a valid payload is: "a valid navigation tree". */
+        valid: string;
+        /** The expected wire shape, for an agent that sent the wrong one. */
+        shape: string;
+    };
+}
+export declare const NAV: SidecarDefinition<NavEntry>;
+export declare const TAGS: SidecarDefinition<TagEntry>;
+export declare const SIDECARS: readonly SidecarDefinition<unknown>[];
+/**
+ * A Sidecar as read. `degraded` means the file was present but held something
+ * this package version could not represent, so `entries` is missing it: the read
+ * is a Degraded read, never to be cached, posted back, or written over the file.
+ */
+export type SidecarRead<E> = {
+    entries: E[];
+    degraded: boolean;
+};
+/** Read a parsed Sidecar file. Absent (null/undefined) is an empty list, not degraded. */
+export declare function readSidecar<E>(def: SidecarDefinition<E>, file: unknown): SidecarRead<E>;
+/**
+ * Read a Sidecar file's raw text. Present-but-unparseable JSON is degraded, not
+ * absent: a site whose nav.json is corrupt still has groups, and treating it as
+ * "never had any" would let a writer replace them.
+ */
+export declare function readSidecarText<E>(def: SidecarDefinition<E>, text: string | undefined): SidecarRead<E>;
+/**
+ * Lift the Sidecars off an index as it arrives on the wire, BEFORE anything
+ * parses it with IndexSchema — the parse strips unknown keys, and an index
+ * round-tripped through it has lost its Sidecars. A key the index does not carry
+ * is `undefined` (omitted: writers leave the file alone); a carried key is read
+ * with the file's per-entry leniency, into fresh objects that never alias the
+ * caller's.
+ */
+export declare function liftSidecars(rawIndex: unknown): {
+    nav?: SidecarRead<NavEntry>;
+    tags?: SidecarRead<TagEntry>;
+};
+/** The Sidecar file on the branch a write lands on, as the writer read it. */
+export type SidecarFileState = {
+    kind: "absent";
+} | {
+    kind: "present";
+    text: string;
+}
+/** The read itself failed, so nothing is known about the file. */
+ | {
+    kind: "unreadable";
+};
+export type SidecarWritePlan = {
+    action: "untouched";
+} | {
+    action: "write";
+    path: string;
+    content: string;
+}
+/** Declined. The rest of the write still lands, so the warning is what tells the caller. */
+ | {
+    action: "skip";
+    warning: string;
+};
+/**
+ * What a write does to one Sidecar file, given what was posted (from
+ * liftSidecars) and the file on the branch. Every Sidecar write REPLACES the
+ * file, and the posted list was built from what this package version could
+ * READ — so a file holding anything this version cannot fully parse (an entry
+ * from a newer package, or a corrupt file) is read-only: replacing it would
+ * destroy those entries with a clean write. The same holds for a posted
+ * Degraded read.
+ *
+ * Emptiness is judged on the POSTED list, before reconcile: an empty list never
+ * creates a file (every editor save carries the Sidecars, and nav's reconcile
+ * would turn [] into the page list), while an empty list over an existing file
+ * replaces it wholesale. A written list is reconciled against the index being
+ * written, so it never names a page or section that write removed.
+ */
+export declare function planSidecarWrite<E>(def: SidecarDefinition<E>, posted: SidecarRead<E> | undefined, branch: SidecarFileState, index: SiteIndex): SidecarWritePlan;
+//# sourceMappingURL=sidecars.d.ts.map

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

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

package/dist/lib/sidecars.js

@@ -0,0 +1,23 @@
+import {
+  NAV,
+  SIDECARS,
+  TAGS,
+  liftSidecars,
+  planSidecarWrite,
+  readSidecar,
+  readSidecarText
+} from "../chunk-DJABADOO.js";
+import "../chunk-DJOGPSRU.js";
+import "../chunk-4WQ36ZP7.js";
+import "../chunk-GNF6KFQ7.js";
+import "../chunk-4Y2JQQZL.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  NAV,
+  SIDECARS,
+  TAGS,
+  liftSidecars,
+  planSidecarWrite,
+  readSidecar,
+  readSidecarText
+};