@drawnagency/primitives 0.1.95 → 0.1.97

package/dist/lib/index.js

@@ -18,7 +18,7 @@ import {
   safeRedirect,
   suggestAccessibleOn,
   wcagLevel
-} from "../chunk-ABV7OZB3.js";
+} from "../chunk-QEHPGA5N.js";
 import {
   curatedIcons,
   getIcon
@@ -34,17 +34,22 @@ import {
   generateNavLinks,
   sanitizeHtml,
   toSectionId
-} from "../chunk-53DKVAB6.js";
+} from "../chunk-72CG6AA2.js";
 import {
   cn
 } from "../chunk-7EOSDFS3.js";
-import "../chunk-S2L3BPLS.js";
 import {
-  audiencePasses
-} from "../chunk-YBVK254P.js";
+  audiencePasses,
+  groupDisplayLabel,
+  groupOfPage,
+  navEntries,
+  pagesInNavOrder,
+  reconcileNav
+} from "../chunk-ZD6XGRQM.js";
+import "../chunk-S2L3BPLS.js";
 import "../chunk-5BM2Y3NJ.js";
+import "../chunk-HJSE6SK5.js";
 import "../chunk-TZQPOR5A.js";
-import "../chunk-RHWWQV3J.js";
 import {
   clearRegistry,
   createRegistry,
@@ -56,6 +61,7 @@ import {
   registerSchema,
   registerSection
 } from "../chunk-VKAGMEKE.js";
+import "../chunk-RHWWQV3J.js";
 import "../chunk-FM4M4Q2W.js";
 import "../chunk-NSCT3AMV.js";
 import {
@@ -88,12 +94,17 @@ export {
   getSchema,
   getSection,
   gridColsClass,
+  groupDisplayLabel,
+  groupOfPage,
   loadSiteContent,
   loadStaticSiteContent,
   mergeSiteContent,
   navChangeEvent,
+  navEntries,
   onPrimaryVarValue,
+  pagesInNavOrder,
   primaryVarValue,
+  reconcileNav,
   registerSchema,
   registerSection,
   relativeLuminance,

package/dist/lib/loader.d.ts

@@ -13,13 +13,13 @@ export interface SiteContent {
  * 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>): SiteContent;
+export declare function mergeSiteContent(index: SiteIndex, sectionFiles: Record<string, unknown>, navFile?: unknown): 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>): SiteContent;
+export declare function loadStaticSiteContent(index: SiteIndex, sectionGlob: Record<string, unknown>, navFile?: unknown): SiteContent;
 /**
  * Load site content from the filesystem.
  * For use in scripts and tests — Astro pages should use import.meta.glob instead.

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,EAAoB,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAKvF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,WAAW,CA6Cb;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,WAAW,CAQb;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAe9E"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/lib/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAMvF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;CAClB;AAiBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW,CA6Cb;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW,CAQb;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwB9E"}

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

@@ -0,0 +1,63 @@
+import type { NavEntry, NavGroupEntry } from "../schemas/nav";
+import type { Page, SiteIndex } from "../schemas/site-config";
+/**
+ * Repair an authored nav against the current page set.
+ *
+ * Total, pure, and idempotent: every possible input maps to a valid nav in
+ * which each page appears exactly once. This is what lets the sidecar tolerate
+ * an older writer editing index.json without knowing about nav.json — the worst
+ * case is a page drifting to the bottom of the nav, never a hard failure. It is
+ * deliberately NOT a schema refinement: parse-rejecting content leaves viewer
+ * and editor both refusing to load, with no in-product repair path.
+ *
+ * "Total" is meant literally, so the shape guards below are load-bearing rather
+ * than paranoia: callers include agent-authored JSON and live editor state, and
+ * `pages` is not id-unique (IndexSchema checks slug uniqueness, not page ids).
+ * Every entry is cloned on the way out — the editor holds this in React state,
+ * where a returned-by-reference entry would let a later mutation silently edit
+ * prior state and defeat identity-based re-render checks.
+ */
+export declare function reconcileNav(entries: NavEntry[], pages: Page[]): NavEntry[];
+/**
+ * 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
+ * older writer. Cheap and idempotent — call it freely.
+ */
+export declare function navEntries(index: SiteIndex): NavEntry[];
+/** Pages in authored nav order. Use this anywhere user-visible sequence matters. */
+export declare function pagesInNavOrder(index: SiteIndex): Page[];
+export declare function groupOfPage(index: SiteIndex, pageId: string): NavGroupEntry | null;
+/** Display fallback for blank group labels — mirrors pageDisplayTitle in lib/pages.ts. */
+export declare function groupDisplayLabel(label: string): string;
+/** A position in the nav: inside a group, or at the top level when groupId is null. */
+export interface NavLocation {
+    groupId: string | null;
+    index: number;
+}
+export type NavRow = {
+    kind: "page";
+    pageId: string;
+    groupId: string | null;
+    index: number;
+} | {
+    kind: "group";
+    groupId: string;
+    index: number;
+} | {
+    kind: "empty-group";
+    groupId: string;
+} | {
+    kind: "tail";
+};
+export declare function addGroup(index: SiteIndex, groupId: string): SiteIndex;
+export declare function renameGroup(index: SiteIndex, groupId: string, label: string): SiteIndex;
+export declare function setGroupStartCollapsed(index: SiteIndex, groupId: string, startCollapsed: boolean): SiteIndex;
+/** Removes the group; its members become top-level entries at the group's slot. */
+export declare function deleteGroup(index: SiteIndex, groupId: string): SiteIndex;
+/**
+ * The single reorder+reparent primitive. `from` and `to` are both NavLocations,
+ * so moving within a container, between containers, and promoting/demoting a
+ * page are all the same operation.
+ */
+export declare function moveNavEntry(index: SiteIndex, from: NavLocation, to: NavLocation): SiteIndex;
+//# sourceMappingURL=nav-tree.d.ts.map

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

@@ -0,0 +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,CA0C3E;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"}

package/dist/lib/nav.d.ts

@@ -17,9 +17,20 @@ export interface PageNavItem {
     isActive: boolean;
     headings: NavItem[];
 }
-export interface SiteNav {
+export interface GroupNavItem {
+    kind: "group";
+    id: string;
+    label: string;
+    startCollapsed: boolean;
     pages: PageNavItem[];
-    /** Live pages with showInNav off — editor-only group, like the archive. */
+}
+export type SiteNavEntry = ({
+    kind: "page";
+} & PageNavItem) | GroupNavItem;
+export interface SiteNav {
+    /** The authored tree: loose pages and groups, in nav order. */
+    entries: SiteNavEntry[];
+    /** Live pages with showInNav off — editor-only flat bucket, like the archive. */
     hidden: PageNavItem[];
     archive: PageNavItem[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/lib/nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAchD;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EAAE,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,EAAE,CAqDX;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAMD,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,GAAG,OAAO,CA4BV"}
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/lib/nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAchD;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EAAE,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,EAAE,CAqDX;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAAC,GAAG,YAAY,CAAC;AAE3E,MAAM,WAAW,OAAO;IACtB,+DAA+D;IAC/D,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iFAAiF;IACjF,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAMD,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,GAAG,OAAO,CAiDV"}

package/dist/lib/pages.d.ts

@@ -13,7 +13,6 @@ export declare function homePage(index: SiteIndex): Page;
 export declare function pageBySlug(index: SiteIndex, slug: string): Page | undefined;
 export declare function audiencePasses(access: string[], audience: string | null): boolean;
 export declare function addPage(index: SiteIndex, id: string): SiteIndex;
-export declare function reorderPages(index: SiteIndex, fromIndex: number, toIndex: number): SiteIndex;
 export declare function setHomePage(index: SiteIndex, pageId: string): SiteIndex;
 export declare function setPageArchived(index: SiteIndex, pageId: string, archived: boolean): SiteIndex;
 export declare function setPageFields(index: SiteIndex, pageId: string, patch: Partial<Pick<Page, "title" | "slug" | "showInNav">>): SiteIndex;

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

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/lib/pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAK3E,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE1F;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAQvE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEvE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAE/C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAI3E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAIjF;AAMD,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAQ/D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAO5F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAWvE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,CAM9F;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,GACzD,SAAS,CAEX;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAgB5G;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EAAE,GACf;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CAkBjD;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAUnD;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,MAAM,GAClB,SAAS,CAQX;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAOrF;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,SAAS,CAWX;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GACzB,SAAS,CAuBX"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/lib/pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAK3E,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG1F;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAQvE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEvE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAE/C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAI3E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAIjF;AAMD,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAY/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAWvE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,CAM9F;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,GACzD,SAAS,CAEX;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAgB5G;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EAAE,GACf;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CAkBjD;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBnD;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,MAAM,GAClB,SAAS,CAQX;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAOrF;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,SAAS,CAWX;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GACzB,SAAS,CAuBX"}

package/dist/lib/reorder.d.ts

@@ -1,3 +1,4 @@
+import type { NavLocation, NavRow } from "./nav-tree";
 /**
  * Compute the destination index for a closest-edge drag-to-reorder drop.
  *
@@ -9,4 +10,27 @@
  * Returns the target index, or `null` when the drop would not move the row.
  */
 export declare function computeReorderTarget(fromIndex: number, overIndex: number, edge: "top" | "bottom" | null): number | null;
+/**
+ * Resolve a closest-edge drop over a nav row into a destination NavLocation.
+ *
+ * With one level of nesting a target's own identity determines its container,
+ * so page drags need no depth inference. Group drags DO need remapping: a group
+ * can only live at the top level, so hovering a member row is reinterpreted as
+ * "next to that member's group" rather than rejected — otherwise every member
+ * row of every expanded group is an inert dead zone during a group drag.
+ *
+ * `overEntryIndex` is the row's index in the TOP-LEVEL entry list: its own index
+ * for a top-level page or group row, its enclosing group's index for a member
+ * row, and the total entry count for the tail row. Group-drag remapping targets
+ * it directly.
+ *
+ * Returns null when the drop would not move anything, or is not permitted.
+ */
+export declare function computeNavDropTarget(args: {
+    from: NavLocation;
+    fromKind: "page" | "group";
+    over: NavRow;
+    overEntryIndex: number;
+    edge: "top" | "bottom" | null;
+}): NavLocation | null;
 //# sourceMappingURL=reorder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"reorder.d.ts","sourceRoot":"","sources":["../../src/lib/reorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,GAC5B,MAAM,GAAG,IAAI,CAKf"}
+{"version":3,"file":"reorder.d.ts","sourceRoot":"","sources":["../../src/lib/reorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,GAC5B,MAAM,GAAG,IAAI,CAKf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;CAC/B,GAAG,WAAW,GAAG,IAAI,CA8BrB"}

package/dist/media/index.js

@@ -18,8 +18,8 @@ import {
   resolveMedia,
   sanitizeMediaName,
   setMediaProvider
-} from "../chunk-SOILPZ7U.js";
-import "../chunk-YBVK254P.js";
+} from "../chunk-S4L3ZFKM.js";
+import "../chunk-ZD6XGRQM.js";
 import {
   ImageManifestSchema,
   MediaConfigSchema,

package/dist/schemas/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./shared";
 export * from "./sections";
 export * from "./site-config";
+export * from "./nav";
 export * from "./media";
 export * from "./audience";
 export * from "./media-grid-options";

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}

package/dist/schemas/index.js

@@ -3,7 +3,7 @@ import {
   AudienceNameSchema,
   MediaGridOptionsSchema,
   slugifyAudienceName
-} from "../chunk-3HJDMFTB.js";
+} from "../chunk-XYCCXKVC.js";
 import {
   AudienceSchema,
   RoleSchema,
@@ -16,10 +16,15 @@ import {
   LinkValueSchema,
   isSafeHref
 } from "../chunk-PZJL2S3Z.js";
+import {
+  NavEntrySchema,
+  NavFileSchema
+} from "../chunk-HJSE6SK5.js";
 import {
   getSectionContentSchema,
   getSectionSchema
 } from "../chunk-TZQPOR5A.js";
+import "../chunk-VKAGMEKE.js";
 import {
   ChatbotConfigSchema,
   ChatbotTaskSchema,
@@ -42,7 +47,6 @@ import {
   VariantSchema,
   normalizeSiteIndex
 } from "../chunk-RHWWQV3J.js";
-import "../chunk-VKAGMEKE.js";
 import "../chunk-FM4M4Q2W.js";
 import "../chunk-NSCT3AMV.js";
 import "../chunk-JSBRDJBE.js";
@@ -64,6 +68,8 @@ export {
   MediaGridOptionsSchema,
   MediaItemSchema,
   MediaReferenceSchema,
+  NavEntrySchema,
+  NavFileSchema,
   PageSchema,
   PageStatusSchema,
   RESERVED_SLUGS,

package/dist/schemas/nav.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+/**
+ * The site's authored navigation tree, persisted to `src/content/nav.json`.
+ *
+ * Deliberately NOT a key on index.json: `applyContentWrite` re-serializes the
+ * Zod-parsed index, so any writer running a package version that predates a new
+ * index key silently deletes it from disk. A sidecar is absent from an old
+ * writer's file list and survives untouched.
+ */
+export declare const NavEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"page">;
+    pageId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"group">;
+    id: z.ZodString;
+    label: z.ZodDefault<z.ZodString>;
+    startCollapsed: z.ZodDefault<z.ZodBoolean>;
+    pageIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>], "kind">;
+export declare const NavFileSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"page">;
+        pageId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"group">;
+        id: z.ZodString;
+        label: z.ZodDefault<z.ZodString>;
+        startCollapsed: z.ZodDefault<z.ZodBoolean>;
+        pageIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>], "kind">>;
+}, z.core.$strip>;
+export type NavEntry = z.infer<typeof NavEntrySchema>;
+export type NavPageEntry = Extract<NavEntry, {
+    kind: "page";
+}>;
+export type NavGroupEntry = Extract<NavEntry, {
+    kind: "group";
+}>;
+export type NavFile = z.infer<typeof NavFileSchema>;
+//# sourceMappingURL=nav.d.ts.map

package/dist/schemas/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/schemas/nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;2BAgBzB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;iBAExB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC/D,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AACjE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schemas/site-config.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { NavEntry } from "./nav";
 export declare const StatusSchema: z.ZodPipe<z.ZodEnum<{
     draft: "draft";
     live: "live";
@@ -417,7 +418,16 @@ export declare const IndexSchema: z.ZodPipe<z.ZodPipe<z.ZodObject<{
     }, z.core.$strip>>;
     lastModified: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>>;
-export type SiteIndex = z.infer<typeof CanonicalIndexSchema>;
+/**
+ * `nav` is a RUNTIME field only: it is loaded from the src/content/nav.json
+ * sidecar and attached by the loader, never parsed from or written to
+ * index.json. It is optional because most SiteIndex values (tests, legacy
+ * content, partial writes) have no nav — reads go through navEntries(), which
+ * reconciles a missing nav into a flat one.
+ */
+export type SiteIndex = z.infer<typeof CanonicalIndexSchema> & {
+    nav?: NavEntry[];
+};
 /** Parse + normalize any raw index (legacy or canonical) to the canonical shape. */
 export declare function normalizeSiteIndex(raw: unknown): SiteIndex;
 export declare const ChatbotTaskSchema: z.ZodObject<{

package/dist/schemas/site-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site-config.d.ts","sourceRoot":"","sources":["../../src/schemas/site-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,YAAY;;;;;+FAExB,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;iBAI5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAQ5D,eAAO,MAAM,cAAc,8EAA+E,CAAC;AAW3G,eAAO,MAAM,gBAAgB;;;EAA+B,CAAC;AAE7D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AA0C9C,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuEtB,CAAC;AAEL,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyE,CAAC;AAElG,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE7D,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAE1D;AAMD,eAAO,MAAM,iBAAiB;;;;;iBAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAiC5B,CAAC;AACL,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmE3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"site-config.d.ts","sourceRoot":"","sources":["../../src/schemas/site-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,eAAO,MAAM,YAAY;;;;;+FAExB,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;iBAI5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAQ5D,eAAO,MAAM,cAAc,8EAA+E,CAAC;AAW3G,eAAO,MAAM,gBAAgB;;;EAA+B,CAAC;AAE7D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AA0C9C,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuEtB,CAAC;AAEL,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyE,CAAC;AAElG;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC;AAEpF,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAE1D;AAMD,eAAO,MAAM,iBAAiB;;;;;iBAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAiC5B,CAAC;AACL,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmE3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/storage/index.d.ts

@@ -1,3 +1,3 @@
 export type { StorageProvider, FileWrite, AssetStore } from "./types";
-export { StorageConflictError, ASSET_CACHE_CONTROL } from "./types";
+export { StorageConflictError, ASSET_CACHE_CONTROL, IDEMPOTENCY_TRAILER, IDEMPOTENCY_KEY_RE, withIdempotencyTrailer } from "./types";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC"}

package/dist/storage/index.js

@@ -1,9 +1,15 @@
 import {
   ASSET_CACHE_CONTROL,
-  StorageConflictError
-} from "../chunk-VAOW4WXQ.js";
+  IDEMPOTENCY_KEY_RE,
+  IDEMPOTENCY_TRAILER,
+  StorageConflictError,
+  withIdempotencyTrailer
+} from "../chunk-EUSWEVOA.js";
 import "../chunk-JSBRDJBE.js";
 export {
   ASSET_CACHE_CONTROL,
-  StorageConflictError
+  IDEMPOTENCY_KEY_RE,
+  IDEMPOTENCY_TRAILER,
+  StorageConflictError,
+  withIdempotencyTrailer
 };

package/dist/storage/types.d.ts

@@ -24,7 +24,51 @@ export interface StorageProvider {
     listDirectory(path: string, options?: {
         draft?: boolean;
     }): Promise<string[]>;
+    /**
+     * Find a recent commit on the draft branch whose message carries the given
+     * `Idempotency-Key:` trailer, returning its sha (null if not found).
+     *
+     * This exists to make a retried write LEGIBLE, not to make it safe — safety is
+     * already `writeFiles`' baseVersion check, which a retry cannot get past once
+     * the original landed (the head moved, so the retry's baseVersion is stale).
+     * What the check cannot do is tell "your write failed" from "your write
+     * succeeded and you didn't hear back", and it reports both as a conflict. A
+     * caller that tagged its write can ask that question here.
+     *
+     * OPTIONAL: providers that cannot search history omit it, and callers fall
+     * back to surfacing the plain conflict.
+     *
+     * Best-effort by contract. It searches a BOUNDED window, so an old key reads
+     * as absent, and an implementation may answer "not found" when the history
+     * read itself fails — failing closed keeps the conflict rather than inventing
+     * a replay. So `null` means "could not confirm", NOT "your write did not
+     * land": a caller must not tell the user the earlier attempt failed.
+     */
+    findCommitByIdempotencyKey?(key: string, options?: {
+        limit?: number;
+    }): Promise<string | null>;
 }
+/**
+ * Commit-message trailer carrying a write's idempotency key. The commit itself is
+ * the store — no table, and no TTL to tune: keys live exactly as long as the
+ * draft branch, and `promoteDraft` deletes it, which is the correct lifetime
+ * (after a publish there is no draft, so an old write must not replay).
+ */
+export declare const IDEMPOTENCY_TRAILER = "Idempotency-Key";
+/**
+ * Keys are interpolated into a commit message, so the charset is enforced HERE,
+ * at the interpolation point, and not only by the caller that happens to have a
+ * schema. A key containing a newline would let a caller append arbitrary further
+ * trailer lines to the commit.
+ */
+export declare const IDEMPOTENCY_KEY_RE: RegExp;
+/**
+ * Build a commit message carrying `key` as a trailer, or return `subject`
+ * unchanged when no key is given. Throws on a malformed key: every caller
+ * reaches this through a write path that should have validated first, so an
+ * invalid key here is a bug, not user input to be tolerated.
+ */
+export declare function withIdempotencyTrailer(subject: string, key?: string): string;
 export type FileWrite = {
     path: string;
     content: string | Uint8Array | null;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,cAAc,EAAE,MAAM,GAAG,IAAI;gBAA7B,cAAc,EAAE,MAAM,GAAG,IAAI;CAI1D;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CACR,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE,MAAM,EAIf,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACxC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEhC,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE9B,YAAY,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE7C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC/E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,gCAAgC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAC5B,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEnE,oEAAoE;IACpE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,sDAAsD;IACtD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;CACpF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,cAAc,EAAE,MAAM,GAAG,IAAI;gBAA7B,cAAc,EAAE,MAAM,GAAG,IAAI;CAI1D;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CACR,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE,MAAM,EAIf,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACxC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEhC,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAE9B,YAAY,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE7C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,0BAA0B,CAAC,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAA6B,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,gCAAgC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAC5B,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEnE,oEAAoE;IACpE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,sDAAsD;IACtD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;CACpF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawnagency/primitives",
-  "version": "0.1.95",
+  "version": "0.1.97",
   "type": "module",
   "exports": {
     "./package.json": "./package.json",
@@ -60,6 +60,10 @@
       "types": "./dist/lib/registry.d.ts",
       "default": "./dist/lib/registry.js"
     },
+    "./lib/index-ops": {
+      "types": "./dist/lib/index-ops.d.ts",
+      "default": "./dist/lib/index-ops.js"
+    },
     "./lib/media-folders": {
       "types": "./dist/lib/media-folders.d.ts",
       "default": "./dist/lib/media-folders.js"

package/src/collab/rebase.ts

@@ -3,6 +3,8 @@
 // path and the live save-sync path (both in core); no I/O here.
 import type { LoadedSection } from "../lib/loader";
 import type { SiteIndex } from "../schemas/site-config";
+import { IndexSchema } from "../schemas/site-config";
+import { NavFileSchema } from "../schemas/nav";
 
 export interface RebaseArgs {
   localSections: LoadedSection[];
@@ -79,6 +81,39 @@ export function reconcileRemoteIndex(remoteIndex: SiteIndex, localIndex: SiteInd
   };
 }
 
+/** Parse a peer's raw live-index broadcast and fold it under ours — the whole
+ *  `onRemoteIndexUpdate` transform, kept here rather than in the handler so the
+ *  nav-preservation step below cannot be lost to a future refactor of the shell.
+ *  Returns null when the payload is not a valid index (caller ignores the
+ *  message).
+ *
+ *  The `nav` lift is load-bearing and mirrors content-ops' write path.
+ *  `IndexSchema` STRIPS unknown keys — that strip is what guarantees nav never
+ *  reaches index.json — so parsing a peer's index without lifting nav off first
+ *  yields a nav-less index. Installing that flattens the local sidebar, and
+ *  since every structural mutation materializes a full nav from `navEntries()`,
+ *  the next local page/group edit would save a flat nav.json and delete every
+ *  group on the site. Silent, and reachable from an ordinary two-editor session.
+ *
+ *  Nav entries address PAGES, which `reconcileRemoteIndex`'s section-id prune
+ *  never touches, so the peer's nav transfers whole; readers go through
+ *  `navEntries()` → `reconcileNav`, which repairs any drift against the
+ *  resulting page set. A peer that sends no nav (an older client) leaves ours
+ *  intact rather than flattening it. */
+export function applyRemoteIndexUpdate(rawRemoteIndex: unknown, localIndex: SiteIndex): SiteIndex | null {
+  const rawNav = (rawRemoteIndex as { nav?: unknown } | null | undefined)?.nav;
+  const parsed = IndexSchema.safeParse(rawRemoteIndex);
+  if (!parsed.success) return null;
+
+  // safeParse, not parse: this arrives off the network, and a throw inside a
+  // collab callback would take down the session rather than one bad message.
+  const parsedNav = rawNav === undefined ? null : NavFileSchema.safeParse({ entries: rawNav });
+  const nav = parsedNav?.success ? parsedNav.data.entries : localIndex.nav;
+
+  const reconciled = reconcileRemoteIndex(parsed.data, localIndex);
+  return nav !== undefined ? { ...reconciled, nav } : reconciled;
+}
+
 export function rebaseContent(args: RebaseArgs): RebaseResult {
   const localById = new Map(args.localSections.map((s) => [s.section.id, s]));
   const remoteIds = new Set(args.remoteSections.map((s) => s.section.id));

package/src/components/editor/DropEdgeIndicator.tsx

@@ -1,13 +1,20 @@
 /**
  * The horizontal insertion line shown at the top or bottom edge of a row during
  * a closest-edge drag-to-reorder, paired with `useSortableRow`'s `closestEdge`.
+ *
+ * `inset` starts the line at the nested-row indent, which is the ONLY thing
+ * distinguishing "drop inside this group" from "drop before this group" — and
+ * a group's last member slot from the top-level slot that follows it.
  */
-export function DropEdgeIndicator({ edge }: { edge: "top" | "bottom" | null }) {
-  if (edge === "top") {
-    return <div className="absolute top-0 right-0 left-0 z-10 h-0.5 -translate-y-1/2 bg-primary" />;
-  }
-  if (edge === "bottom") {
-    return <div className="absolute right-0 bottom-0 left-0 z-10 h-0.5 translate-y-1/2 bg-primary" />;
-  }
-  return null;
+export function DropEdgeIndicator({ edge, inset = false }: { edge: "top" | "bottom" | null; inset?: boolean }) {
+  if (!edge) return null;
+  return (
+    <div
+      className={[
+        "absolute right-0 z-10 h-0.5 bg-primary",
+        inset ? "left-6" : "left-0",
+        edge === "top" ? "top-0 -translate-y-1/2" : "bottom-0 translate-y-1/2",
+      ].join(" ")}
+    />
+  );
 }