@drawnagency/primitives 0.1.113 → 0.1.114

package/dist/lib/dexie.js

@@ -169,7 +169,13 @@ async function restoreLocalChanges() {
     const siteId = metaRow?.siteId || getDb().siteId;
     return {
       sections,
-      siteIndex: { siteId, pages: indexRow.pages, sections: indexRow.sections, nav: indexRow.nav },
+      siteIndex: {
+        siteId,
+        pages: indexRow.pages,
+        sections: indexRow.sections,
+        nav: indexRow.nav,
+        ...indexRow.tags !== void 0 ? { tags: indexRow.tags } : {}
+      },
       siteConfig: configRow?.config,
       deletedSections: indexRow.deletedSections ?? []
     };
@@ -197,6 +203,7 @@ async function persistSiteIndex(index, deletedSections = []) {
       pages: index.pages,
       sections: index.sections,
       nav: index.nav,
+      tags: index.tags,
       deletedSections,
       updatedAt: now
     });
@@ -275,6 +282,7 @@ async function persistAll(sections, siteIndex, deletedSectionIds, siteConfig) {
           pages: siteIndex.pages,
           sections: siteIndex.sections,
           nav: siteIndex.nav,
+          tags: siteIndex.tags,
           // Record the deletion INTENT, not just its effect on the order. The
           // restore path reads this back; when it was hardcoded `[]` that path
           // had to re-derive deletions by diffing this snapshot against a fresh

package/dist/lib/env.d.ts

@@ -4,4 +4,8 @@ declare global {
     }
 }
 export declare function env(key: string): string;
+/** Vite replaces `import.meta.env.PROD` with a boolean literal at build time
+ *  (packages are `noExternal`, so that covers this file too), which is why the
+ *  declared string type above is bypassed here. False under Node and vitest. */
+export declare function isProd(): boolean;
 //# sourceMappingURL=env.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;KACnD;CACF;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMvC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;KACnD;CACF;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMvC;AAED;;gFAEgF;AAChF,wBAAgB,MAAM,IAAI,OAAO,CAEhC"}

package/dist/lib/env.js

@@ -1,7 +1,9 @@
 import {
-  env
-} from "../chunk-WKZ7OENC.js";
+  env,
+  isProd
+} from "../chunk-BQ5TZZUE.js";
 import "../chunk-JSBRDJBE.js";
 export {
-  env
+  env,
+  isProd
 };

package/dist/lib/events.d.ts

@@ -1,4 +1,4 @@
-import type { NavItem, SiteNav } from "./nav";
+import type { SiteNav } from "./nav";
 export interface TypedEvent<T> {
     dispatch(detail: T): void;
     listen(callback: (detail: T) => void): () => void;
@@ -7,7 +7,6 @@ export declare function createEvent<T>(name: string): TypedEvent<T>;
 export declare const editModeEvent: TypedEvent<{
     isEditMode: boolean;
 }>;
-export declare const navChangeEvent: TypedEvent<NavItem[]>;
 export declare const darkModeEvent: TypedEvent<string>;
 export declare const siteNameChangeEvent: TypedEvent<string>;
 export declare const historySelectEvent: TypedEvent<{

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE9C,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAW1D;AAED,eAAO,MAAM,aAAa;gBAA6B,OAAO;EAAqB,CAAC;AACpF,eAAO,MAAM,cAAc,uBAA0C,CAAC;AACtE,eAAO,MAAM,aAAa,oBAAsC,CAAC;AACjE,eAAO,MAAM,mBAAmB,oBAAwC,CAAC;AACzE,eAAO,MAAM,kBAAkB;SAAsB,MAAM;UAAQ,MAAM;EAAqB,CAAC;AAC/F;;2EAE2E;AAC3E,eAAO,MAAM,mBAAmB;SAAsB,MAAM;UAAQ,MAAM;EAAsB,CAAC;AACjG;;4BAE4B;AAC5B,eAAO,MAAM,yBAAyB;aAA0B,MAAM;EAA6B,CAAC;AACpG;8EAC8E;AAC9E,eAAO,MAAM,gBAAgB;uBAAoC,OAAO;EAAmB,CAAC;AAC5F,eAAO,MAAM,kBAAkB,qBAA2C,CAAC;AAC3E,eAAO,MAAM,eAAe,oBAAoC,CAAC;AACjE;kFACkF;AAClF,eAAO,MAAM,oBAAoB,kBAA2C,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAW1D;AAED,eAAO,MAAM,aAAa;gBAA6B,OAAO;EAAqB,CAAC;AACpF,eAAO,MAAM,aAAa,oBAAsC,CAAC;AACjE,eAAO,MAAM,mBAAmB,oBAAwC,CAAC;AACzE,eAAO,MAAM,kBAAkB;SAAsB,MAAM;UAAQ,MAAM;EAAqB,CAAC;AAC/F;;2EAE2E;AAC3E,eAAO,MAAM,mBAAmB;SAAsB,MAAM;UAAQ,MAAM;EAAsB,CAAC;AACjG;;4BAE4B;AAC5B,eAAO,MAAM,yBAAyB;aAA0B,MAAM;EAA6B,CAAC;AACpG;8EAC8E;AAC9E,eAAO,MAAM,gBAAgB;uBAAoC,OAAO;EAAmB,CAAC;AAC5F,eAAO,MAAM,kBAAkB,qBAA2C,CAAC;AAC3E,eAAO,MAAM,eAAe,oBAAoC,CAAC;AACjE;kFACkF;AAClF,eAAO,MAAM,oBAAoB,kBAA2C,CAAC"}

package/dist/lib/image-background.d.ts

@@ -0,0 +1,8 @@
+import type { CSSProperties } from "react";
+import type { ImageBackground } from "../schemas/shared";
+export interface ImageBackdrop {
+    className?: string;
+    style?: CSSProperties;
+}
+export declare function imageBackdrop(bg: ImageBackground | undefined): ImageBackdrop | undefined;
+//# sourceMappingURL=image-background.d.ts.map

package/dist/lib/image-background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-background.d.ts","sourceRoot":"","sources":["../../src/lib/image-background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAA0B,MAAM,mBAAmB,CAAC;AAkBjF,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAMxF"}

package/dist/lib/index-ops.js

@@ -11,15 +11,15 @@ import {
   setGroupStartCollapsed,
   slugifyPageSlug,
   uniquePageSlug
-} from "../chunk-NHN2LSIU.js";
+} from "../chunk-IP2SEBAJ.js";
 import {
   IndexSchema,
   PageStatusSchema,
   RESERVED_SLUGS,
   SLUG_RE
-} from "../chunk-AHALSCQH.js";
+} from "../chunk-PTY2RG2K.js";
 import "../chunk-4TZJZU2T.js";
-import "../chunk-GGXZZ77Z.js";
+import "../chunk-AASEGXNT.js";
 import "../chunk-JSBRDJBE.js";
 
 // src/lib/index-ops.ts

package/dist/lib/index.d.ts

@@ -4,15 +4,17 @@ export { audiencePasses } from "./pages";
 export { resolveChatbotName, resolveThinkingPhrases, DEFAULT_CHATBOT_NAME } from "./chatbot";
 export { generateNavLinks, toSectionId, type NavItem } from "./nav";
 export { navEntries, pagesInNavOrder, groupOfPage, groupDisplayLabel, reconcileNav } from "./nav-tree";
+export { siteTags, tagDisplayLabel, reconcileTags } from "./tags";
+export { resolveReference, type ReferenceContent } from "./references";
+export { REFERENCE_TYPE } from "./reference-type";
 export { deriveContrast, contrastColor, relativeLuminance, contrastRatio, wcagLevel, suggestAccessibleOn, type WcagLevel, } from "./contrast";
 export { primaryVarValue, accentVarValue, onPrimaryVarValue } from "./theme-vars";
 export { sanitizeHtml, ensureSanitizer } from "./sanitize";
-export { gridColsClass } from "./grid";
 export { getIcon, curatedIcons, type IconEntry } from "./icons";
 export { buildGoogleFontsUrl } from "./google-fonts";
 export { formatTimestamp } from "./timestamp";
-export { safeRedirect } from "./safeRedirect";
-export { createEvent, editModeEvent, navChangeEvent, darkModeEvent, type TypedEvent } from "./events";
+export { safeRedirect } from "./safe-redirect";
+export { createEvent, editModeEvent, darkModeEvent, type TypedEvent } from "./events";
 export { createRegistry, defineSection, registerSection, registerSchema, getSection, getSchema, getAllSections, getAllSchemas, clearRegistry, type SectionRegistry, type SectionDefinition, type SectionProps, type WrapperProps, type SettingsFieldDef, type SettingsSchema, type CustomSettingsFormProps, } from "./registry";
-export { mergeSiteContent, loadStaticSiteContent, loadSiteContent, type LoadedSection, type SiteContent, } from "./loader";
+export { mergeSiteContent, loadStaticSiteContent, type LoadedSection, type SiteContent, } from "./loader";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACtG,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,UAAU,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,UAAU,CAAC"}

package/dist/lib/index.js

@@ -5,8 +5,6 @@ import {
   contrastColor,
   contrastRatio,
   deriveContrast,
-  gridColsClass,
-  loadSiteContent,
   loadStaticSiteContent,
   mergeSiteContent,
   onPrimaryVarValue,
@@ -17,11 +15,7 @@ import {
   safeRedirect,
   suggestAccessibleOn,
   wcagLevel
-} from "../chunk-VWWY5TL5.js";
-import "../chunk-FRVO75DK.js";
-import {
-  formatTimestamp
-} from "../chunk-MM7KZS5C.js";
+} from "../chunk-PNSCDBU7.js";
 import {
   curatedIcons,
   getIcon
@@ -29,14 +23,18 @@ import {
 import {
   createEvent,
   darkModeEvent,
-  editModeEvent,
-  navChangeEvent
-} from "../chunk-4RNF2DRG.js";
+  editModeEvent
+} from "../chunk-XDEPXTBY.js";
 import {
   generateNavLinks,
+  resolveReference,
   toSectionId
-} from "../chunk-DNY72JZN.js";
-import "../chunk-CXZ5YJG4.js";
+} from "../chunk-VUYCRBJK.js";
+import "../chunk-L45X7DKX.js";
+import "../chunk-FRVO75DK.js";
+import {
+  formatTimestamp
+} from "../chunk-MM7KZS5C.js";
 import {
   ensureSanitizer,
   sanitizeHtml
@@ -44,6 +42,11 @@ import {
 import {
   cn
 } from "../chunk-7EOSDFS3.js";
+import {
+  reconcileTags,
+  siteTags,
+  tagDisplayLabel
+} from "../chunk-OAGJBCSH.js";
 import {
   audiencePasses,
   groupDisplayLabel,
@@ -51,14 +54,17 @@ import {
   navEntries,
   pagesInNavOrder,
   reconcileNav
-} from "../chunk-NHN2LSIU.js";
-import "../chunk-S2L3BPLS.js";
+} from "../chunk-IP2SEBAJ.js";
+import {
+  REFERENCE_TYPE
+} from "../chunk-5GFACGSN.js";
+import "../chunk-7SX42OP4.js";
 import {
   env
-} from "../chunk-WKZ7OENC.js";
-import "../chunk-REDDTTGJ.js";
+} from "../chunk-BQ5TZZUE.js";
 import "../chunk-DMCGN5AS.js";
-import "../chunk-AHALSCQH.js";
+import "../chunk-4Y2JQQZL.js";
+import "../chunk-PTY2RG2K.js";
 import "../chunk-4TZJZU2T.js";
 import {
   clearRegistry,
@@ -71,11 +77,12 @@ import {
   registerSchema,
   registerSection
 } from "../chunk-FTPETWXE.js";
-import "../chunk-GGXZZ77Z.js";
+import "../chunk-AASEGXNT.js";
 import "../chunk-NSCT3AMV.js";
 import "../chunk-JSBRDJBE.js";
 export {
   DEFAULT_CHATBOT_NAME,
+  REFERENCE_TYPE,
   accentVarValue,
   audiencePasses,
   buildGoogleFontsUrl,
@@ -99,26 +106,27 @@ export {
   getIcon,
   getSchema,
   getSection,
-  gridColsClass,
   groupDisplayLabel,
   groupOfPage,
-  loadSiteContent,
   loadStaticSiteContent,
   mergeSiteContent,
-  navChangeEvent,
   navEntries,
   onPrimaryVarValue,
   pagesInNavOrder,
   primaryVarValue,
   reconcileNav,
+  reconcileTags,
   registerSchema,
   registerSection,
   relativeLuminance,
   resolveChatbotName,
+  resolveReference,
   resolveThinkingPhrases,
   safeRedirect,
   sanitizeHtml,
+  siteTags,
   suggestAccessibleOn,
+  tagDisplayLabel,
   toSectionId,
   wcagLevel
 };

package/dist/lib/loader.d.ts

@@ -3,6 +3,9 @@ import { type SiteIndex, type SectionMeta } from "../schemas/site-config";
 export interface LoadedSection {
     section: Section;
     meta: SectionMeta;
+    /** Set only on render-time copies a Reference pulled in (resolveReference):
+     *  the id of that Reference. Never loaded or persisted. */
+    referencedBy?: string;
 }
 export interface SiteContent {
     sections: LoadedSection[];
@@ -13,22 +16,33 @@ export interface SiteContent {
      *  nav.json from a degraded read 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.
+ */
+export type TagsSidecar = {
+    loaded: false;
+} | {
+    loaded: true;
+    file: unknown;
+};
 /**
  * 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): SiteContent;
+export declare function mergeSiteContent(index: SiteIndex, sectionFiles: Record<string, unknown>, navFile?: unknown, tagsSidecar?: TagsSidecar): 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): SiteContent;
-/**
- * Load site content from the filesystem.
- * For use in scripts and tests — Astro pages should use import.meta.glob instead.
- */
-export declare function loadSiteContent(contentDir: string): Promise<SiteContent>;
+export declare function loadStaticSiteContent(index: SiteIndex, sectionGlob: Record<string, unknown>, navFile?: unknown, tagsSidecar?: TagsSidecar): 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;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;IACjB;;;;2BAIuB;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AA+BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW,CAsDb;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,CA6C9E"}
+{"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"}

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

@@ -60,4 +60,5 @@ export declare function deleteGroup(index: SiteIndex, groupId: string): SiteInde
  * page are all the same operation.
  */
 export declare function moveNavEntry(index: SiteIndex, from: NavLocation, to: NavLocation): SiteIndex;
+export declare function describeNavMove(prevIndex: SiteIndex, nextIndex: SiteIndex, from: NavLocation): string | null;
 //# sourceMappingURL=nav-tree.d.ts.map

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"}
+{"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"}

package/dist/lib/nav.d.ts

@@ -1,7 +1,9 @@
 import type { LoadedSection } from "./loader";
 import { type SectionRegistry } from "./registry";
 import type { SiteIndex } from "../schemas/site-config";
+import type { Section } from "../schemas/sections";
 import type { SiteDocument } from "./documents";
+import { type ReferenceQuery } from "./references";
 export interface NavItem {
     href: string;
     label: string;
@@ -9,7 +11,43 @@ export interface NavItem {
     children: NavItem[];
 }
 export declare function toSectionId(text: string): string;
+export type SummaryNavLevel = "off" | "heading" | "subheading";
 export declare function generateNavLinks(sections: LoadedSection[], registry?: SectionRegistry): NavItem[];
+export interface SummaryNavAnchor {
+    anchor: string;
+    /** False for a Subheading with no Link Heading above it: it renders its
+     *  anchor but is dropped from the nav, so the editor hints about it. */
+    inNav: boolean;
+}
+/** Per summary section id (nav on, label set): the anchor it renders and
+ *  whether it made it into the nav. Same derivation generateNavLinks uses. */
+export declare function summaryNavAnchors(sections: LoadedSection[], registry?: SectionRegistry): Record<string, SummaryNavAnchor>;
+/**
+ * Render-only copy of the page's sections with `navAnchor` stamped on every
+ * section whose rendered anchor it cannot derive alone — nav-bearing summaries
+ * and everything a Reference pulled in (container children included) — for
+ * renderers that can't share React context with the page: the SSR viewer
+ * renders each section as its own React tree. Never written back: the editor
+ * reads summary anchors from SummaryAnchorsContext instead, so stored content
+ * stays clean.
+ *
+ * `navAnchor` is not part of any section schema: it survives only because the
+ * viewer's later passes (media resolve, sanitizeLoadedSections) spread sections.
+ * A Zod re-parse after this point would strip it and leave the section without
+ * the id its nav entry links to — stamp after any parse, never before.
+ */
+export declare function withNavAnchors(sections: LoadedSection[], registry?: SectionRegistry): LoadedSection[];
+/**
+ * Every copy the editor renders for each Reference on the page, keyed by
+ * Reference id then source id, with anchors stamped over the WHOLE page — so
+ * the editor nav (built from expandReferences) links to exactly these ids, and
+ * two References showing one section never share a DOM id. Copies the
+ * published site drops (drafts, archived pages) claim after the rest, so a
+ * greyed copy can't take an anchor a published one would have.
+ * Lives here rather than in references.ts because it needs withNavAnchors, and
+ * references.ts importing nav.ts would cycle.
+ */
+export declare function pageReferenceCopies(pageSections: LoadedSection[], opts: Omit<ReferenceQuery, "referenceId" | "content">): Record<string, Record<string, Section>>;
 export interface PageNavItem {
     id: string;
     title: string;

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;AAI9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,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;AAqBD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EAAE,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,EAAE,CA8DX;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;;qBAEqB;AACrB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;iFACiF;AACjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB;AAED;2CAC2C;AAC3C,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAAC,GAAG,YAAY,GAAG,eAAe,CAAC;AAE7F,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;IAC3B;;;;;2BAKuB;IACvB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;CAC5B,GAAG,OAAO,CAkEV"}
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/lib/nav.ts"],"names":[],"mappings":"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"}

package/dist/lib/platform-broker.d.ts

@@ -8,7 +8,7 @@
  */
 export declare class PlatformBrokerError extends Error {
     readonly status: number | null;
-    constructor(status: number | null, message: string);
+    constructor(status: number | null, message: string, options?: ErrorOptions);
 }
 /** True when this runtime should broker privileged ops through the platform. */
 export declare function isPlatformMode(): boolean;
@@ -16,7 +16,9 @@ export declare function isPlatformMode(): boolean;
  * Call a platform broker endpoint scoped to this site. The platform authorizes
  * the op against the site that owns PLATFORM_API_KEY — the client never names
  * another tenant. Retries network/5xx (transient); 4xx is a real auth/config
- * error and is surfaced immediately. Mirrors fetchInstallationToken().
+ * error and is surfaced immediately. Writes are retried only on a gateway
+ * status: an unconfirmed write (timeout, dropped connection, 500) may already
+ * have landed. Mirrors fetchInstallationToken().
  */
 export declare function platformBroker<T = unknown>(path: string, opts?: {
     method?: string;

package/dist/lib/platform-broker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-broker.d.ts","sourceRoot":"","sources":["../../src/lib/platform-broker.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAChB,MAAM,EAAE,MAAM,GAAG,IAAI;gBAArB,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM;CAInE;AAED,gFAAgF;AAChF,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC7E,OAAO,CAAC,CAAC,CAAC,CAgDZ;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAyBrC"}
+{"version":3,"file":"platform-broker.d.ts","sourceRoot":"","sources":["../../src/lib/platform-broker.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAChB,MAAM,EAAE,MAAM,GAAG,IAAI;gBAArB,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAI3F;AAED,gFAAgF;AAChF,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC7E,OAAO,CAAC,CAAC,CAAC,CAuDZ;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CA8BrC"}

package/dist/lib/platform-broker.js

@@ -1,17 +1,19 @@
 import {
   env
-} from "../chunk-WKZ7OENC.js";
+} from "../chunk-BQ5TZZUE.js";
 import "../chunk-JSBRDJBE.js";
 
 // src/lib/platform-broker.ts
 var ATTEMPTS = 3;
 var RETRY_BASE_MS = 150;
+var REQUEST_TIMEOUT_MS = 1e4;
+var GATEWAY_STATUSES = /* @__PURE__ */ new Set([502, 503, 504]);
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 var PlatformBrokerError = class extends Error {
-  constructor(status, message) {
-    super(message);
+  constructor(status, message, options) {
+    super(message, options);
     this.status = status;
     this.name = "PlatformBrokerError";
   }
@@ -33,34 +35,34 @@ async function platformBroker(path, opts = {}) {
     headers["Content-Type"] = "application/json";
     serializedBody = JSON.stringify(opts.body);
   }
-  let lastError;
   for (let attempt = 0; attempt < ATTEMPTS; attempt++) {
     const isLast = attempt === ATTEMPTS - 1;
     let res;
     try {
-      res = await fetch(url, { method, headers, body: serializedBody });
+      res = await fetch(url, { method, headers, body: serializedBody, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
     } catch (err) {
-      lastError = err;
-      if (isLast) throw err;
+      if (method !== "GET" || isLast) {
+        throw new PlatformBrokerError(null, method === "GET" ? "Platform request failed \u2014 check your connection and try again." : "Platform request wasn't confirmed \u2014 check its status before trying again.", { cause: err });
+      }
       await sleep(RETRY_BASE_MS * 2 ** attempt);
       continue;
     }
     if (res.ok) {
       if (res.status === 204) return void 0;
       try {
-        return await res.json();
-      } catch {
-        return void 0;
+        const text = await res.text();
+        return text ? JSON.parse(text) : void 0;
+      } catch (err) {
+        throw new PlatformBrokerError(null, method === "GET" ? "Platform response couldn't be read \u2014 try again." : "Platform response couldn't be read \u2014 check the operation's status before trying again.", { cause: err });
       }
     }
-    if (res.status >= 500 && !isLast) {
-      lastError = new PlatformBrokerError(res.status, `Platform broker error (${res.status})`);
+    if (!isLast && (method === "GET" ? res.status >= 500 : GATEWAY_STATUSES.has(res.status))) {
       await sleep(RETRY_BASE_MS * 2 ** attempt);
       continue;
     }
     throw new PlatformBrokerError(res.status, `Platform broker error (${res.status}): ${await res.text()}`);
   }
-  throw lastError instanceof Error ? lastError : new PlatformBrokerError(null, "Platform broker unreachable");
+  throw new PlatformBrokerError(null, "Platform broker unreachable");
 }
 async function platformBrokerStream(path, body) {
   const apiUrl = env("PLATFORM_API_URL");
@@ -70,17 +72,23 @@ async function platformBrokerStream(path, body) {
   let lastError;
   for (let attempt = 0; attempt < ATTEMPTS; attempt++) {
     let res;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
     try {
       res = await fetch(url, {
+        signal: controller.signal,
         method: "POST",
         headers: { "x-api-key": apiKey, "x-site-id": siteId, "Content-Type": "application/json" },
         body: JSON.stringify(body)
       });
     } catch (err) {
       lastError = err;
+      if (controller.signal.aborted) throw new PlatformBrokerError(null, "Chat connection timed out \u2014 try again.");
       if (attempt === ATTEMPTS - 1) throw err;
       await sleep(RETRY_BASE_MS * 2 ** attempt);
       continue;
+    } finally {
+      clearTimeout(timer);
     }
     if (!res.ok || !res.body) throw new Error(`Platform broker error (${res.status})`);
     return res.body;

package/dist/lib/reference-type.d.ts

@@ -0,0 +1,2 @@
+export declare const REFERENCE_TYPE: "reference";
+//# sourceMappingURL=reference-type.d.ts.map

package/dist/lib/reference-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-type.d.ts","sourceRoot":"","sources":["../../src/lib/reference-type.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,EAAG,WAAoB,CAAC"}

package/dist/lib/reference-validation.d.ts

@@ -0,0 +1,31 @@
+import type { SiteIndex } from "../schemas/site-config";
+/** What one Reference names that it can never show. */
+export interface ReferenceProblem {
+    referenceId: string;
+    unknownTagIds: string[];
+    /** Not a top-level section on any page: deleted, or a container's child. */
+    unplacedSectionIds: string[];
+    /** Picks that are themselves References, which are never shown. */
+    referencePickIds: string[];
+    picksItself: boolean;
+}
+/**
+ * The dangling-id check for Reference sections — what save_sections rejects on,
+ * and what validate_site and `authoring validate` warn about.
+ *
+ * Deliberately NOT part of applyContentWrite or the schema: on the viewer and in
+ * the editor a dangling pick or a deleted tag is ordinary (someone deleted the
+ * source), so it drops silently and an editor save must keep succeeding. This
+ * is for whoever just chose the ids, where a bad one is a mistake.
+ *
+ * `sections` are full section bodies; anything that is not a Reference (by body
+ * type or index type) is ignored. `tagIds` null means the registry could not
+ * be read whole, so tag ids go unchecked rather than being misreported.
+ */
+export declare function referenceProblems(sections: readonly {
+    id: string;
+    content: unknown;
+}[], index: Pick<SiteIndex, "pages" | "sections">, tagIds: ReadonlySet<string> | null): ReferenceProblem[];
+/** One line per Reference, naming every bad id. */
+export declare function describeReferenceProblem(problem: ReferenceProblem): string;
+//# sourceMappingURL=reference-validation.d.ts.map

package/dist/lib/reference-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-validation.d.ts","sourceRoot":"","sources":["../../src/lib/reference-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;CACtB;AAKD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,EACrD,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC,EAC5C,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GACjC,gBAAgB,EAAE,CAoBpB;AAED,mDAAmD;AACnD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAW1E"}

package/dist/lib/reference-validation.js

@@ -0,0 +1,39 @@
+import {
+  REFERENCE_TYPE
+} from "../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
+};