@drawnagency/primitives 0.1.115 → 0.1.116

package/dist/lib/index-ops.js

@@ -3,6 +3,9 @@ import {
   deletePage,
   uniquePageSlug
 } from "../chunk-VY3IFGE3.js";
+import {
+  slugifyPageSlug
+} from "../chunk-S7QRHUWO.js";
 import {
   liftSidecars
 } from "../chunk-DJABADOO.js";
@@ -18,9 +21,6 @@ import {
 } from "../chunk-DJOGPSRU.js";
 import "../chunk-4WQ36ZP7.js";
 import "../chunk-GNF6KFQ7.js";
-import {
-  slugifyPageSlug
-} from "../chunk-S7QRHUWO.js";
 import {
   IndexSchema,
   PageStatusSchema,

package/dist/lib/index.js

@@ -19,32 +19,33 @@ import {
 import {
   formatTimestamp
 } from "../chunk-MM7KZS5C.js";
-import {
-  generateNavLinks,
-  resolveReference,
-  toSectionId
-} from "../chunk-WYOFQHKI.js";
-import {
-  ensureSanitizer,
-  sanitizeHtml
-} from "../chunk-QQ3S3P5P.js";
 import {
   curatedIcons,
   getIcon
 } from "../chunk-WDSVHKAH.js";
-import "../chunk-L45X7DKX.js";
 import {
   createEvent,
   darkModeEvent,
   editModeEvent
 } from "../chunk-XDEPXTBY.js";
-import "../chunk-FRVO75DK.js";
+import {
+  generateNavLinks,
+  resolveReference,
+  toSectionId
+} from "../chunk-W72BPGR3.js";
+import {
+  ensureSanitizer,
+  sanitizeHtml
+} from "../chunk-QQ3S3P5P.js";
 import {
   cn
 } from "../chunk-7EOSDFS3.js";
 import {
   audiencePasses
 } from "../chunk-VY3IFGE3.js";
+import "../chunk-S7QRHUWO.js";
+import "../chunk-FRVO75DK.js";
+import "../chunk-L45X7DKX.js";
 import {
   NAV,
   SIDECARS,
@@ -67,7 +68,6 @@ import {
   tagDisplayLabel
 } from "../chunk-4WQ36ZP7.js";
 import "../chunk-GNF6KFQ7.js";
-import "../chunk-S7QRHUWO.js";
 import {
   REFERENCE_TYPE
 } from "../chunk-5GFACGSN.js";

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/site-validation.d.ts

@@ -0,0 +1,123 @@
+import { type SidecarDiagnostic } from "./sidecars";
+import { type ReferenceProblem } from "./reference-validation";
+/** What the caller can vouch for. Never how severe anything is — that is SEVERITY. */
+export interface SiteValidationPolicy {
+    /**
+     * A section type with no registered schema: `trust` reads it as a real type
+     * this caller cannot check (the connector, whose branch index is the proof; a
+     * CLI whose site sections module failed to load), `reject` as an unknown type.
+     */
+    unregisteredTypes: "trust" | "reject";
+}
+export interface SchemaIssue {
+    path: readonly PropertyKey[];
+    message: string;
+}
+type ProblemBody = {
+    code: "index-missing";
+} | {
+    code: "index-invalid";
+    detail: string;
+} | {
+    code: "site-id-empty";
+} | {
+    code: "site-config-missing";
+} | {
+    code: "site-config-invalid";
+    detail: string;
+} | {
+    code: "sidecar-degraded";
+    sidecar: "nav" | "tags";
+} | {
+    code: "sidecar-repaired";
+    sidecar: "nav" | "tags";
+    diagnostic: SidecarDiagnostic;
+} | {
+    code: "image-manifest-invalid";
+    detail: string;
+} | {
+    code: "document-manifest-invalid";
+    detail: string;
+} | {
+    code: "section-missing";
+    sectionId: string;
+} | {
+    code: "section-unparseable";
+    sectionId: string;
+    detail: string;
+} | {
+    code: "section-id-mismatch";
+    sectionId: string;
+    fileId: unknown;
+} | {
+    code: "section-type-mismatch";
+    sectionId: string;
+    fileType: unknown;
+    indexType: string;
+} | {
+    code: "unknown-type";
+    sectionId: string;
+    type: string;
+} | {
+    code: "unvalidated-type";
+    sectionId: string;
+    type: string;
+} | {
+    code: "section-invalid";
+    sectionId: string;
+    type: string;
+    issues: SchemaIssue[];
+} | {
+    code: "layout-invalid";
+    sectionId: string;
+    issues: SchemaIssue[];
+} | {
+    code: "too-deep";
+    sectionId: string;
+} | {
+    code: "reference-in-container";
+    sectionId: string;
+} | {
+    code: "html-entities";
+    sectionId: string;
+    path: string;
+    entities: string[];
+} | {
+    code: "dangling-image";
+    sectionId: string;
+    imageId: string;
+} | {
+    code: "dangling-document";
+    sectionId: string;
+    documentId: string;
+} | {
+    code: "reference-problem";
+    problem: ReferenceProblem;
+};
+export type SiteProblemCode = ProblemBody["code"];
+export type Severity = "error" | "warning";
+export type SiteProblem = ProblemBody & {
+    severity: Severity;
+};
+/**
+ * The one severity table every caller shares. An ERROR is something the site
+ * cannot load, or authored content it silently loses or rejects. A WARNING is
+ * something the site renders through — dropping or repairing it itself — and
+ * that is fixable in-product, so it must not fail a build.
+ */
+export declare const SEVERITY: Readonly<Record<SiteProblemCode, Severity>>;
+export interface SiteValidation {
+    problems: SiteProblem[];
+    /** The section ids the index places on pages; null when the index could not be read. */
+    placedIds: string[] | null;
+}
+/**
+ * Validate a site's committed content. `files` maps repo paths under
+ * `src/content/` to their text; an absent path is an absent file. Pure: it reads
+ * the schema registry, so callers register built-in (and any site-local)
+ * schemas first. Only sections the index places on a page are judged — orphan
+ * files are the caller's concern.
+ */
+export declare function validateSite(files: Readonly<Record<string, string>>, policy: SiteValidationPolicy): SiteValidation;
+export {};
+//# sourceMappingURL=site-validation.d.ts.map

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

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

package/dist/lib/site-validation.js

@@ -0,0 +1,230 @@
+import {
+  collectDocumentIds
+} from "../chunk-DKZCHCV3.js";
+import {
+  referenceProblems
+} from "../chunk-FGQXHUAE.js";
+import {
+  checkSection
+} from "../chunk-26V4YNOR.js";
+import {
+  upgradeLegacySection
+} from "../chunk-FRVO75DK.js";
+import "../chunk-L45X7DKX.js";
+import {
+  NAV,
+  TAGS,
+  readSidecarText
+} from "../chunk-DJABADOO.js";
+import "../chunk-DJOGPSRU.js";
+import "../chunk-4WQ36ZP7.js";
+import "../chunk-GNF6KFQ7.js";
+import "../chunk-5GFACGSN.js";
+import {
+  IndexSchema,
+  SiteConfigSchema
+} from "../chunk-67P34WNW.js";
+import "../chunk-4TZJZU2T.js";
+import "../chunk-4Y2JQQZL.js";
+import {
+  ImageManifestSchema
+} from "../chunk-APIJPTFG.js";
+import "../chunk-FTPETWXE.js";
+import "../chunk-AASEGXNT.js";
+import "../chunk-NSCT3AMV.js";
+import {
+  DOCUMENT_MANIFEST_PATH,
+  DocumentManifestSchema
+} from "../chunk-BS5AQHZG.js";
+import "../chunk-JSBRDJBE.js";
+
+// src/lib/image-refs.ts
+function tallyImageIds(value, counts = /* @__PURE__ */ new Map()) {
+  if (Array.isArray(value)) {
+    for (const item of value) tallyImageIds(item, counts);
+  } else if (value !== null && typeof value === "object") {
+    for (const [key, v] of Object.entries(value)) {
+      if (key === "imageId" && typeof v === "string" && v !== "") {
+        counts.set(v, (counts.get(v) ?? 0) + 1);
+      } else {
+        tallyImageIds(v, counts);
+      }
+    }
+  }
+  return counts;
+}
+function collectImageIds(value) {
+  return new Set(tallyImageIds(value).keys());
+}
+
+// src/lib/site-validation.ts
+var INDEX_PATH = "src/content/index.json";
+var SITE_CONFIG_PATH = "src/content/site-config.json";
+var IMAGE_MANIFEST_PATH = "src/content/image-manifest.json";
+var sectionPath = (id) => `src/content/sections/${id}.json`;
+var SEVERITY = {
+  "index-missing": "error",
+  "index-invalid": "error",
+  "site-id-empty": "error",
+  "site-config-missing": "error",
+  "site-config-invalid": "error",
+  // The loader drops what it cannot read, so authored grouping or tags vanish.
+  "sidecar-degraded": "error",
+  // What reconcile repairs on every load: the runtime has already fixed it.
+  "sidecar-repaired": "warning",
+  "image-manifest-invalid": "error",
+  "document-manifest-invalid": "error",
+  "section-missing": "error",
+  "section-unparseable": "error",
+  "section-id-mismatch": "error",
+  "section-type-mismatch": "error",
+  "unknown-type": "error",
+  "unvalidated-type": "warning",
+  "section-invalid": "error",
+  "layout-invalid": "error",
+  "too-deep": "error",
+  "reference-in-container": "error",
+  "html-entities": "warning",
+  "dangling-image": "warning",
+  "dangling-document": "warning",
+  "reference-problem": "warning"
+};
+function parseJson(text) {
+  try {
+    return { ok: true, value: JSON.parse(text) };
+  } catch (e) {
+    return { ok: false, detail: e instanceof Error ? e.message : String(e) };
+  }
+}
+function parseFile(text, schema) {
+  const json = parseJson(text);
+  if (!json.ok) return json;
+  const parsed = schema.safeParse(json.value);
+  return parsed.success ? { ok: true, data: parsed.data } : { ok: false, detail: parsed.error.message };
+}
+function validateSite(files, policy) {
+  const problems = [];
+  const report = (body) => problems.push({ ...body, severity: SEVERITY[body.code] });
+  const indexText = files[INDEX_PATH];
+  if (indexText === void 0) {
+    report({ code: "index-missing" });
+    return { problems, placedIds: null };
+  }
+  const indexRead = parseFile(indexText, IndexSchema);
+  if (!indexRead.ok) {
+    report({ code: "index-invalid", detail: indexRead.detail });
+    return { problems, placedIds: null };
+  }
+  const index = indexRead.data;
+  const placedIds = [...new Set(index.pages.flatMap((p) => p.order))];
+  if (!index.siteId) report({ code: "site-id-empty" });
+  const configText = files[SITE_CONFIG_PATH];
+  if (configText === void 0) {
+    report({ code: "site-config-missing" });
+  } else {
+    const configRead = parseFile(configText, SiteConfigSchema);
+    if (!configRead.ok) report({ code: "site-config-invalid", detail: configRead.detail });
+  }
+  const checkSidecar = (def) => {
+    const text = files[def.path];
+    if (text === void 0) return [];
+    const read = readSidecarText(def, text);
+    if (read.degraded) {
+      report({ code: "sidecar-degraded", sidecar: def.name });
+      return null;
+    }
+    for (const diagnostic of def.reconcile(read.entries, index).diagnostics) {
+      report({ code: "sidecar-repaired", sidecar: def.name, diagnostic });
+    }
+    return read.entries;
+  };
+  checkSidecar(NAV);
+  const tags = checkSidecar(TAGS);
+  const tagIds = tags === null ? null : new Set(tags.map((t) => t.id));
+  let imageIds = /* @__PURE__ */ new Set();
+  const imageText = files[IMAGE_MANIFEST_PATH];
+  if (imageText !== void 0) {
+    const read = parseFile(imageText, ImageManifestSchema);
+    if (read.ok) imageIds = new Set(Object.keys(read.data.images));
+    else {
+      report({ code: "image-manifest-invalid", detail: read.detail });
+      imageIds = null;
+    }
+  }
+  let documentIds = /* @__PURE__ */ new Set();
+  const documentText = files[DOCUMENT_MANIFEST_PATH];
+  if (documentText !== void 0) {
+    const read = parseFile(documentText, DocumentManifestSchema);
+    if (read.ok) documentIds = new Set(Object.keys(read.data));
+    else {
+      report({ code: "document-manifest-invalid", detail: read.detail });
+      documentIds = null;
+    }
+  }
+  const bodies = [];
+  for (const id of placedIds) {
+    const text = files[sectionPath(id)];
+    if (text === void 0) {
+      report({ code: "section-missing", sectionId: id });
+      continue;
+    }
+    const json = parseJson(text);
+    if (!json.ok) {
+      report({ code: "section-unparseable", sectionId: id, detail: json.detail });
+      continue;
+    }
+    const onDisk = typeof json.value === "object" && json.value !== null ? json.value : {};
+    if (onDisk.id !== id) report({ code: "section-id-mismatch", sectionId: id, fileId: onDisk.id });
+    const body = upgradeLegacySection(json.value);
+    bodies.push({ id, content: body });
+    const upgradedType = typeof body === "object" && body !== null ? body.type : void 0;
+    const type = typeof upgradedType === "string" ? upgradedType : "";
+    const indexType = index.sections[id].type;
+    if (indexType !== onDisk.type && indexType !== upgradedType) {
+      report({ code: "section-type-mismatch", sectionId: id, fileType: onDisk.type, indexType });
+    }
+    if (type === "") continue;
+    const check = checkSection(type, body);
+    if (check.unregistered) {
+      if (policy.unregisteredTypes === "reject") {
+        report({ code: "unknown-type", sectionId: id, type });
+      } else {
+        report({ code: "unvalidated-type", sectionId: id, type });
+        if (check.error?.code === "depth") report({ code: "too-deep", sectionId: id });
+      }
+    } else if (check.error) {
+      const error = check.error;
+      switch (error.code) {
+        case "schema":
+          report({ code: "section-invalid", sectionId: id, type, issues: error.zodError.issues });
+          break;
+        case "layout":
+          report({ code: "layout-invalid", sectionId: id, issues: error.zodError.issues });
+          break;
+        case "depth":
+          report({ code: "too-deep", sectionId: id });
+          break;
+        case "reference-in-container":
+          report({ code: "reference-in-container", sectionId: id });
+          break;
+      }
+    }
+    for (const { path, entities } of check.entities) report({ code: "html-entities", sectionId: id, path, entities });
+    if (imageIds) {
+      for (const imageId of collectImageIds(body)) {
+        if (!imageIds.has(imageId)) report({ code: "dangling-image", sectionId: id, imageId });
+      }
+    }
+    if (documentIds) {
+      for (const documentId of collectDocumentIds(body)) {
+        if (!documentIds.has(documentId)) report({ code: "dangling-document", sectionId: id, documentId });
+      }
+    }
+  }
+  for (const problem of referenceProblems(bodies, index, tagIds)) report({ code: "reference-problem", problem });
+  return { problems, placedIds };
+}
+export {
+  SEVERITY,
+  validateSite
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawnagency/primitives",
-  "version": "0.1.115",
+  "version": "0.1.116",
   "description": "Browser-safe foundation of the Brand Portal framework: Zod schemas, section components, editor shell, hooks, pure libs, collab contract, document engine.",
   "type": "module",
   "exports": {
@@ -105,6 +105,18 @@
       "types": "./dist/lib/reference-validation.d.ts",
       "default": "./dist/lib/reference-validation.js"
     },
+    "./lib/section-check": {
+      "types": "./dist/lib/section-check.d.ts",
+      "default": "./dist/lib/section-check.js"
+    },
+    "./lib/site-validation": {
+      "types": "./dist/lib/site-validation.d.ts",
+      "default": "./dist/lib/site-validation.js"
+    },
+    "./lib/document-refs": {
+      "types": "./dist/lib/document-refs.d.ts",
+      "default": "./dist/lib/document-refs.js"
+    },
     "./lib/deck-access": {
       "types": "./dist/lib/deck-access.d.ts",
       "default": "./dist/lib/deck-access.js"
@@ -213,6 +225,7 @@
     "clsx": "^2.1.1",
     "dexie": "^4.4.2",
     "dompurify": "^3.2.6",
+    "entities": "^6.0.1",
     "jose": "^6.2.2",
     "lucide-react": "^1.7.0",
     "marked": "^18.0.5",

package/src/lib/document-refs.ts

@@ -81,3 +81,33 @@ export function clearDocumentRefs(
   if (!changed) return { changed: false, section };
   return { changed: true, section: { ...section, content: { ...section.content, children: next } } };
 }
+
+/**
+ * The non-empty `documentId`s referenced by unvalidated section JSON, including
+ * ones nested in a container's children — `tallyDocumentIds` for a body that
+ * has not been through a schema, so every step is shape-checked. Walks by node
+ * type like the rest of this module, so an unrelated field called `doc` is
+ * never mistaken for a reference.
+ */
+export function collectDocumentIds(value: unknown, out: Set<string> = new Set()): Set<string> {
+  if (Array.isArray(value)) {
+    for (const item of value) collectDocumentIds(item, out);
+    return out;
+  }
+  if (typeof value !== "object" || value === null) return out;
+  const node = value as { type?: unknown; content?: unknown };
+  const content = node.content;
+  if (typeof content !== "object" || content === null || Array.isArray(content)) return out;
+  const record = content as Record<string, unknown>;
+
+  if (node.type === "document") {
+    const doc = record.doc;
+    const documentId =
+      typeof doc === "object" && doc !== null ? (doc as Record<string, unknown>).documentId : undefined;
+    // Empty string is the routine unconfigured slot (the schema defaults to
+    // it), not a broken reference.
+    if (typeof documentId === "string" && documentId !== "") out.add(documentId);
+  }
+  if (Array.isArray(record.children)) collectDocumentIds(record.children, out);
+  return out;
+}