@drawnagency/primitives 0.1.112 → 0.1.114

package/src/lib/tags.ts

@@ -0,0 +1,148 @@
+import type { TagEntry } from "../schemas/tags";
+import type { SiteIndex } from "../schemas/site-config";
+
+/**
+ * Repair the tag sidecar against the current section set.
+ *
+ * Total, pure, and idempotent — the same contract as reconcileNav, for the same
+ * reason: tags.json survives writers that do not know it exists, so it can name
+ * sections an older writer (or an agent) has since deleted, and the repair has
+ * to happen on read rather than by rejecting content. It is deliberately NOT a
+ * schema refinement: parse-rejecting content would leave the editor unable to
+ * load the site it needs to repair it.
+ *
+ * Drops assignments to sections absent from `sections`, duplicate section ids
+ * within a tag, duplicate tag ids (first wins), and tags with no usable id. A
+ * tag with no assignments left is KEPT — the registry outlives its sections.
+ * Every entry is rebuilt key by key, so the output always parses as a
+ * TagsFile and never shares structure with the input (the editor holds this in
+ * React state, where a shared array would let a later edit mutate prior state).
+ */
+export function reconcileTags(entries: TagEntry[], sections: SiteIndex["sections"]): TagEntry[] {
+  const entryList = Array.isArray(entries) ? entries : [];
+  const validIds = new Set(sections && typeof sections === "object" ? Object.keys(sections) : []);
+
+  const seenTagIds = new Set<string>();
+  const result: TagEntry[] = [];
+  for (const entry of entryList) {
+    if (!entry || typeof entry !== "object") continue;
+    if (typeof entry.id !== "string" || entry.id === "" || seenTagIds.has(entry.id)) continue;
+    seenTagIds.add(entry.id);
+
+    const claimed = Array.isArray(entry.sectionIds) ? entry.sectionIds : [];
+    const sectionIds: string[] = [];
+    for (const id of claimed) {
+      if (typeof id === "string" && validIds.has(id) && !sectionIds.includes(id)) sectionIds.push(id);
+    }
+    result.push({ id: entry.id, label: typeof entry.label === "string" ? entry.label : "", sectionIds });
+  }
+  return result;
+}
+
+/**
+ * The ONLY sanctioned way to read the tags. Always reconciles, so callers never
+ * reason about whether index.tags is present, stale, or names deleted sections.
+ */
+export function siteTags(index: SiteIndex): TagEntry[] {
+  return reconcileTags(index.tags ?? [], index.sections);
+}
+
+/** Display fallback for blank tag labels — mirrors groupDisplayLabel. */
+export function tagDisplayLabel(label: string): string {
+  return label || "Untitled tag";
+}
+
+/** The tag already using this name (case- and whitespace-insensitive) — what
+ *  an inline create reuses, and what the registry refuses to duplicate. */
+export function findTagByLabel(tags: TagEntry[], label: string): TagEntry | null {
+  const wanted = label.trim().toLowerCase();
+  if (!wanted) return null;
+  return tags.find((t) => t.label.trim().toLowerCase() === wanted) ?? null;
+}
+
+export function addTag(index: SiteIndex, id: string, label: string, sectionId?: string): SiteIndex {
+  const tags = siteTags(index);
+  if (tags.some((t) => t.id === id)) return { ...index, tags };
+  return { ...index, tags: reconcileTags([...tags, { id, label, sectionIds: sectionId ? [sectionId] : [] }], index.sections) };
+}
+
+export function renameTag(index: SiteIndex, id: string, label: string): SiteIndex {
+  return { ...index, tags: siteTags(index).map((t) => (t.id === id ? { ...t, label } : t)) };
+}
+
+export function deleteTag(index: SiteIndex, id: string): SiteIndex {
+  return { ...index, tags: siteTags(index).filter((t) => t.id !== id) };
+}
+
+export function setSectionTagged(index: SiteIndex, sectionId: string, tagId: string, tagged: boolean): SiteIndex {
+  return {
+    ...index,
+    tags: siteTags(index).map((t) => {
+      if (t.id !== tagId) return t;
+      const without = t.sectionIds.filter((id) => id !== sectionId);
+      return { ...t, sectionIds: tagged ? [...without, sectionId] : without };
+    }),
+  };
+}
+
+/**
+ * Three-way merge of the tag sidecar for the collab rebase.
+ *
+ * Nav's rebase rule is "the remote's persisted tree wins", which is safe there
+ * because grouping is edited rarely. Tags are edited from every section's
+ * chrome, so the same rule would silently drop unsaved tagging whenever a peer
+ * saved anything at all. Instead, local edits are diffed against the clean
+ * baseline (`base`) and replayed onto the remote:
+ *  - a tag created locally is appended; one deleted locally is dropped;
+ *  - a local rename wins, otherwise the remote label stands;
+ *  - per (tag, section) pair, a local add or remove is replayed;
+ *  - a tag the REMOTE deleted stays deleted, local assignments included —
+ *    persisted state beats unsaved edits to a tag that no longer exists.
+ * With no baseline to diff against, the remote wins (nav's rule). A remote with
+ * no tags at all (an older server that does not attach the sidecar) leaves the
+ * local tags intact rather than wiping them. Inputs are never mutated; the
+ * result is not reconciled — readers do that through siteTags.
+ */
+export function mergeTags(args: {
+  base: TagEntry[] | undefined;
+  local: TagEntry[] | undefined;
+  remote: TagEntry[] | undefined;
+}): TagEntry[] | undefined {
+  const { base, local, remote } = args;
+  if (remote === undefined) return local?.map((t) => ({ ...t, sectionIds: [...t.sectionIds] }));
+  if (base === undefined || local === undefined) return remote.map((t) => ({ ...t, sectionIds: [...t.sectionIds] }));
+
+  // First occurrence wins, matching reconcileTags — `base` is an unreconciled
+  // server read, and a last-wins map would invent a diff against a duplicate.
+  const firstById = (tags: TagEntry[]) => {
+    const byId = new Map<string, TagEntry>();
+    for (const t of tags) if (!byId.has(t.id)) byId.set(t.id, t);
+    return byId;
+  };
+  const baseById = firstById(base);
+  const localById = firstById(local);
+  const remoteIds = new Set(remote.map((t) => t.id));
+
+  const result: TagEntry[] = [];
+  for (const r of remote) {
+    const b = baseById.get(r.id);
+    const l = localById.get(r.id);
+    if (b && !l) continue; // deleted locally
+    const members = [...r.sectionIds];
+    let label = r.label;
+    if (b && l) {
+      if (l.label !== b.label) label = l.label;
+      for (const id of l.sectionIds) if (!b.sectionIds.includes(id) && !members.includes(id)) members.push(id);
+      for (const id of b.sectionIds) {
+        if (l.sectionIds.includes(id)) continue;
+        const at = members.indexOf(id);
+        if (at !== -1) members.splice(at, 1);
+      }
+    }
+    result.push({ id: r.id, label, sectionIds: members });
+  }
+  for (const l of local) {
+    if (!remoteIds.has(l.id) && !baseById.has(l.id)) result.push({ ...l, sectionIds: [...l.sectionIds] });
+  }
+  return result;
+}

package/src/lib/theme-vars.ts

@@ -1,5 +1,6 @@
 import type { SiteConfig } from "../schemas/site-config";
 import { suggestAccessibleOn } from "./contrast";
+import { cornerRadiusValue } from "./corner-radius";
 
 /**
  * Computes the CSS value for the brand `--color-primary` / `--color-primary-contrast`
@@ -50,3 +51,25 @@ export function onPrimaryVarValue(c?: Partial<ThemeColorConfig> | null): string
   const dark = c?.primaryColorDark ? suggestAccessibleOn(c.primaryColorDark) : null;
   return lightDark(light, dark, c?.darkMode === "optional");
 }
+
+/**
+ * The full inline `<html style>` string both `Layout.astro` and
+ * `LoginLayout.astro` set at SSR time — one assembly point for the 9 custom
+ * properties instead of the same template literal copied into both files.
+ * Byte-for-byte identical to what those files built inline before this
+ * existed; changing the property order or defaults here is a client-facing
+ * change to every site's `<html>` tag, not a refactor.
+ */
+export function themeStyle(siteConfig?: SiteConfig | null): string {
+  return (
+    `--color-primary: ${primaryVarValue(siteConfig)}; ` +
+    `--color-primary-contrast: ${accentVarValue(siteConfig)}; ` +
+    `--color-on-primary: ${onPrimaryVarValue(siteConfig)}; ` +
+    `--font-heading: ${siteConfig?.headingFont ?? "system-ui"}, system-ui, sans-serif; ` +
+    `--font-body: ${siteConfig?.bodyFont ?? "system-ui"}, system-ui, sans-serif; ` +
+    `--heading-text-transform: ${siteConfig?.uppercaseHeadings !== false ? "uppercase" : "none"}; ` +
+    `--subheading-text-transform: ${siteConfig?.uppercaseSubheadings !== false ? "uppercase" : "none"}; ` +
+    `--nav-text-transform: ${siteConfig?.uppercaseNavHeadings !== false ? "uppercase" : "none"}; ` +
+    `--radius-outer: ${cornerRadiusValue(siteConfig?.cornerRadius)};`
+  );
+}

package/src/media/index.ts

@@ -5,7 +5,7 @@ export * from "./provider";
 export * from "./utils";
 export * from "./queue";
 export * from "./resolve";
-export { generateVideoPoster } from "./videoPoster";
+export { generateVideoPoster } from "./video-poster";
 export { composePreviewImage, type PreviewImageInputs } from "./compose-preview";
 
 const MEDIA_KEY = Symbol.for("@drawnagency/primitives/media");

package/src/media/resolve.ts

@@ -105,6 +105,7 @@ export interface ResolvedLogo {
   darkUrl: string | null;
   invertInDark: boolean;
   showInNav: boolean;
+  hideTitle: boolean;
 }
 
 /**
@@ -117,7 +118,7 @@ export interface ResolvedLogo {
  * both those tags resolve to `tag: "img"`.
  */
 export function resolveLogo(
-  logo: { light: { imageId: string }; dark: { imageId: string } | null; invertInDark: boolean; showInNav: boolean } | null,
+  logo: { light: { imageId: string }; dark: { imageId: string } | null; invertInDark: boolean; showInNav: boolean; hideTitle: boolean } | null,
   manifest: MediaManifest,
   provider: MediaProvider,
 ): ResolvedLogo | null {
@@ -131,5 +132,6 @@ export function resolveLogo(
     darkUrl,
     invertInDark: logo.invertInDark,
     showInNav: logo.showInNav,
+    hideTitle: logo.hideTitle,
   };
 }

package/src/media/utils.ts

@@ -48,6 +48,24 @@ export function mimeToExt(mime: string): string {
   return MIME_TO_EXT[mime] ?? "bin";
 }
 
+// Editor preview URL for a library item, matching what /api/media/[id] serves:
+// SVGs carry kind "image" but have no webp variants, only original.svg; rasters
+// get their smallest variant; animated and video items get their playable
+// original (a <video> src, not a still). Null for a raster with no variants.
+export function mediaThumbnailUrl(item: MediaItem): string | null {
+  if (item.mimeType === "image/svg+xml" || item.kind !== "image") {
+    return `/api/media/${item.id}/original.${mimeToExt(item.mimeType)}`;
+  }
+  if (item.variants.length === 0) return null;
+  const smallest = item.variants.reduce((a, b) => (a.width < b.width ? a : b));
+  return `/api/media/${item.id}/${smallest.width}.webp`;
+}
+
+// For <img>-only previews (cover, logo): null unless the item is a still image.
+export function imageThumbnailUrl(item: MediaItem | undefined): string | null {
+  return item?.kind === "image" ? mediaThumbnailUrl(item) : null;
+}
+
 export function displayFilenameExt(mime: string): string {
   const ext = MIME_TO_EXT[mime];
   return ext ? `.${ext}` : "";

package/src/media/{videoPoster.ts → video-poster.ts}

@@ -26,7 +26,7 @@ export function generateVideoPoster(
     }, 10_000);
 
     video.addEventListener("error", () => {
-      safeReject(new Error("Failed to load video for poster generation"));
+      safeReject(new Error("Couldn't load video for poster generation"));
     }, { once: true });
 
     video.muted = true;
@@ -56,7 +56,7 @@ export function generateVideoPoster(
               settled = true;
               cleanup();
               if (!posterBlob) {
-                reject(new Error("Failed to create poster blob"));
+                reject(new Error("Couldn't create poster blob"));
                 return;
               }
               resolve({ posterBlob, width: w, height: h, duration: video.duration });

package/src/schemas/index.ts

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

package/src/schemas/shared.ts

@@ -38,7 +38,7 @@ const BaseMediaRef = z.object({
     .union([z.string(), z.array(z.string())])
     .optional()
     .describe("Optional caption: a single string, or multiple lines as an array of strings."),
-  background: z.string().optional().describe("Optional CSS background color/value shown behind a transparent image."),
+  background: z.string().optional().describe("Legacy; not rendered. For a backdrop behind a media section's image, use the section's options.background."),
   invertFrom: z
     .string()
     .optional()
@@ -91,6 +91,29 @@ export const HexColorSchema = z
   .string()
   .regex(/^#[0-9a-fA-F]{6}$/, "must be a 6-digit hex color");
 
+const ImageBackgroundSurfaceSchema = z.enum(["none", "light", "dark"]);
+export type ImageBackgroundSurface = z.infer<typeof ImageBackgroundSurfaceSchema>;
+
+/** Per-placement backdrop painted behind an image (e.g. a dark plate under a
+ *  white transparent logo). Absent = no backdrop. */
+export const ImageBackgroundSchema = z.discriminatedUnion("mode", [
+  z.object({
+    mode: z.literal("theme").describe("Pick a site surface separately for light and dark mode."),
+    light: ImageBackgroundSurfaceSchema.describe(
+      "Backdrop in light mode: 'none', the site's light surface, or its dark surface.",
+    ),
+    dark: ImageBackgroundSurfaceSchema.describe(
+      "Backdrop in dark mode: 'none', the site's light surface, or its dark surface.",
+    ),
+  }),
+  z.object({
+    mode: z.literal("custom").describe("Use one custom color in both modes."),
+    color: HexColorSchema.describe("One backdrop color for both light and dark mode, as a 6-digit hex."),
+  }),
+]);
+
+export type ImageBackground = z.infer<typeof ImageBackgroundSchema>;
+
 // Font-family names are interpolated raw into the `style` attribute on <html>
 // (`--font-heading: ${headingFont}, ...`). Astro HTML-escapes the attribute, so
 // the residual risk is CSS-declaration injection via `;`/`{}`. Allow only the

package/src/schemas/site-config.ts

@@ -7,6 +7,7 @@ import { CORNER_RADIUS_OPTIONS } from "../lib/corner-radius";
 // document options block onto PageSchema.
 import { documentOptionsSchema } from "../document/engine/settings";
 import type { NavEntry } from "./nav";
+import type { TagEntry } from "./tags";
 
 export const StatusSchema = z.enum(["draft", "live", "archived", "published"]).transform(
   (val) => val === "published" ? "live" as const : val,
@@ -176,8 +177,12 @@ export const IndexSchema = RawIndexSchema.transform(normalizeRawIndex).pipe(Cano
  * 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.
+ *
+ * `tags` follows the same rules for the src/content/tags.json sidecar; read it
+ * only through siteTags() (lib/tags.ts). Absent means "not loaded", which every
+ * writer treats as "leave tags.json alone" — not as "no tags".
  */
-export type SiteIndex = z.infer<typeof CanonicalIndexSchema> & { nav?: NavEntry[] };
+export type SiteIndex = z.infer<typeof CanonicalIndexSchema> & { nav?: NavEntry[]; tags?: TagEntry[] };
 
 /** Parse + normalize any raw index (legacy or canonical) to the canonical shape. */
 export function normalizeSiteIndex(raw: unknown): SiteIndex {
@@ -292,6 +297,9 @@ export const SiteConfigSchema = z.object({
       dark: z.object({ imageId: z.string() }).nullable().default(null),
       invertInDark: z.boolean().default(false),
       showInNav: z.boolean().default(true),
+      // A nav logo stands in for the site name by default; the toggle is for
+      // wordmark-less logos that still need the name spelled out.
+      hideTitle: z.boolean().default(true),
     })
     .nullable()
     .default(null),

package/src/schemas/tags.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+
+/**
+ * The site's section tags, persisted to `src/content/tags.json`.
+ *
+ * A sidecar for the same reason nav.json is (see schemas/nav.ts): an older
+ * writer re-serializes the Zod-parsed index and silently deletes any key it
+ * does not know, so tags must never be a key on index.json or a section file.
+ *
+ * Each tag owns its assignments (`sectionIds`), so deleting a tag removes it
+ * from every section by construction; a deleted section is pruned by
+ * `reconcileTags` (lib/tags.ts). Array order is the registry's display order.
+ */
+export const TagEntrySchema = z.object({
+  id: z.string().min(1),
+  /** May be blank — agent-authored files can omit it; UI falls back to "Untitled tag". */
+  label: z.string().catch(""),
+  // Everything but `id` repairs rather than rejects. A rejected entry marks the
+  // read degraded, and a degraded tags.json refuses EVERY tags write until
+  // someone fixes the file by hand — far too heavy a price for one blank id in
+  // one tag's list, which reconcileTags would drop anyway.
+  sectionIds: z
+    .array(z.unknown())
+    .catch([])
+    .transform((ids) => ids.filter((id): id is string => typeof id === "string" && id !== "")),
+});
+
+export const TagsFileSchema = z.object({
+  tags: z.array(TagEntrySchema),
+});
+
+export type TagEntry = z.infer<typeof TagEntrySchema>;
+export type TagsFile = z.infer<typeof TagsFileSchema>;

package/src/storage/types.ts

@@ -86,7 +86,7 @@ export interface StorageProvider {
  */
 export class IdempotencyLookupUnavailableError extends Error {
   constructor(override readonly cause?: unknown) {
-    super("Could not search draft history for the idempotency key");
+    super("Couldn't search draft history for the idempotency key");
     this.name = "IdempotencyLookupUnavailableError";
   }
 }

package/src/types/database.ts

@@ -1,3 +1,5 @@
+// GENERATED by Supabase CLI — do not edit by hand.
+// Regenerate with `pnpm generate-types` after every migration.
 export type Json =
   | string
   | number
@@ -847,6 +849,10 @@ export type Database = {
         Args: { p_site_id: string; p_user_id: string }
         Returns: undefined
       }
+      set_site_user_role: {
+        Args: { p_role: string; p_site_id: string; p_user_id: string }
+        Returns: undefined
+      }
     }
     Enums: {
       [_ in never]: never

package/dist/chunk-BR4MIPTM.js

@@ -1,138 +0,0 @@
-import {
-  FormLabel,
-  Input
-} from "./chunk-TALRVOGO.js";
-import {
-  cn
-} from "./chunk-7EOSDFS3.js";
-
-// src/components/shared/PagesContext.tsx
-import { createContext, useContext } from "react";
-var PagesContext = createContext({ pages: [], getPageHeadings: () => [] });
-function usePages() {
-  return useContext(PagesContext);
-}
-
-// src/components/shared/Select.tsx
-import { useId } from "react";
-import { ChevronDown } from "lucide-react";
-import { jsx, jsxs } from "react/jsx-runtime";
-function Select({
-  label,
-  value,
-  onChange,
-  options,
-  disabled,
-  className,
-  selectClassName
-}) {
-  const id = useId();
-  return /* @__PURE__ */ jsxs("div", { className, children: [
-    label && /* @__PURE__ */ jsx(FormLabel, { htmlFor: id, children: label }),
-    /* @__PURE__ */ jsxs("div", { className: "relative", children: [
-      /* @__PURE__ */ jsx(
-        "select",
-        {
-          id,
-          value,
-          onChange: (e) => onChange(e.target.value),
-          disabled,
-          className: cn(
-            "w-full appearance-none rounded border border-base-200 bg-base py-2 pr-8 pl-3 text-sm text-base-contrast",
-            "focus:border-base-contrast focus:outline-none focus:ring-1 focus:ring-base-contrast",
-            disabled && "cursor-not-allowed opacity-50",
-            selectClassName
-          ),
-          children: options.map((opt) => /* @__PURE__ */ jsx("option", { value: opt.value, children: opt.label }, opt.value))
-        }
-      ),
-      /* @__PURE__ */ jsx(
-        ChevronDown,
-        {
-          size: 14,
-          className: "pointer-events-none absolute right-2.5 top-1/2 -translate-y-1/2 text-base-contrast-light"
-        }
-      )
-    ] })
-  ] });
-}
-
-// src/components/shared/LinkField.tsx
-import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-var TARGET_OPTIONS = [
-  { label: "Same tab (_self)", value: "_self" },
-  { label: "New tab (_blank)", value: "_blank" }
-];
-function LinkField({ label, value, onChange }) {
-  const { pages, getPageHeadings } = usePages();
-  const isInternal = value.kind === "internal";
-  function setMode(kind) {
-    if (kind === value.kind) return;
-    onChange(kind === "external" ? { kind: "external", href: "", target: value.target } : { kind: "internal", pageId: "", anchorSectionId: null, target: "_self" });
-  }
-  const pageId = isInternal ? value.pageId : "";
-  const headings = pageId ? getPageHeadings(pageId) : [];
-  return /* @__PURE__ */ jsxs2("div", { className: "flex flex-col gap-3", children: [
-    /* @__PURE__ */ jsx2(FormLabel, { children: label }),
-    /* @__PURE__ */ jsx2("div", { className: "flex gap-2", role: "tablist", children: ["internal", "external"].map((kind) => /* @__PURE__ */ jsx2(
-      "button",
-      {
-        type: "button",
-        role: "tab",
-        "aria-selected": value.kind === kind,
-        onClick: () => setMode(kind),
-        className: cn(
-          "cursor-pointer rounded border px-3 py-1 text-sm capitalize",
-          value.kind === kind ? "border-primary bg-primary text-primary-contrast" : "border-base-200 text-base-contrast"
-        ),
-        children: kind === "external" ? "External URL" : "Internal page"
-      },
-      kind
-    )) }),
-    value.kind === "external" ? /* @__PURE__ */ jsx2(
-      Input,
-      {
-        label: "URL",
-        value: value.href,
-        placeholder: "https://...",
-        onChange: (href) => onChange({ kind: "external", href, target: value.target })
-      }
-    ) : /* @__PURE__ */ jsxs2(Fragment, { children: [
-      /* @__PURE__ */ jsx2(
-        Select,
-        {
-          label: "Page",
-          value: value.pageId,
-          options: [{ label: "Select a page\u2026", value: "" }, ...pages.map((p) => ({ label: p.title, value: p.id }))],
-          onChange: (pid) => onChange({ kind: "internal", pageId: pid, anchorSectionId: null, target: value.target })
-        }
-      ),
-      /* @__PURE__ */ jsx2(
-        Select,
-        {
-          label: "Section",
-          value: value.anchorSectionId ?? "",
-          disabled: !pageId,
-          options: [{ label: "None (top of page)", value: "" }, ...headings.map((h) => ({ label: h.label, value: h.id }))],
-          onChange: (anchor) => onChange({ kind: "internal", pageId, anchorSectionId: anchor || null, target: value.target })
-        }
-      )
-    ] }),
-    value.kind === "external" && /* @__PURE__ */ jsx2(
-      Select,
-      {
-        label: "Opens in",
-        value: value.target,
-        options: TARGET_OPTIONS,
-        onChange: (t) => onChange({ ...value, target: t })
-      }
-    )
-  ] });
-}
-
-export {
-  PagesContext,
-  usePages,
-  Select,
-  LinkField
-};

package/dist/chunk-DNY72JZN.js

@@ -1,86 +0,0 @@
-import {
-  getContainerChildren
-} from "./chunk-CXZ5YJG4.js";
-import {
-  getSection
-} from "./chunk-FTPETWXE.js";
-
-// src/lib/nav.ts
-function toSectionId(text) {
-  const slug = text.normalize("NFKD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/^-+|-+$/g, "");
-  if (slug) return slug;
-  let hash = 0;
-  for (let i = 0; i < text.length; i++) {
-    hash = (hash << 5) - hash + text.charCodeAt(i) | 0;
-  }
-  return `section-${Math.abs(hash).toString(36)}`;
-}
-function flattenForNav(sections) {
-  const flat = [];
-  const walk = (loaded) => {
-    flat.push(loaded);
-    for (const child of getContainerChildren(loaded.section)) {
-      walk({ section: child, meta: loaded.meta });
-    }
-  };
-  sections.forEach(walk);
-  return flat;
-}
-function generateNavLinks(sections, registry) {
-  const nav = [];
-  let currentParent = null;
-  let currentChild = null;
-  const lookupRole = (type) => {
-    const def = registry ? registry.getSection(type) : getSection(type);
-    return def?.navRole;
-  };
-  for (const { section, meta } of flattenForNav(sections)) {
-    const content = section.content;
-    if (!content.heading) continue;
-    const role = lookupRole(section.type);
-    if (!role) continue;
-    if (role === "h1") {
-      if (content.excludeFromNav) {
-        currentParent = null;
-        currentChild = null;
-        continue;
-      }
-      currentParent = {
-        href: `#${toSectionId(content.heading)}`,
-        label: content.heading,
-        status: meta.status,
-        children: []
-      };
-      currentChild = null;
-      nav.push(currentParent);
-    } else if (role === "h2") {
-      if (content.excludeFromNav) {
-        currentChild = null;
-        continue;
-      }
-      if (!currentParent) continue;
-      currentChild = {
-        href: `#${toSectionId(content.heading)}`,
-        label: content.heading,
-        status: meta.status,
-        children: []
-      };
-      currentParent.children.push(currentChild);
-    } else if (role === "h3") {
-      if (content.excludeFromNav) continue;
-      if (!currentChild) continue;
-      currentChild.children.push({
-        href: `#${toSectionId(content.heading)}`,
-        label: content.heading,
-        status: meta.status,
-        children: []
-      });
-    }
-  }
-  return nav;
-}
-
-export {
-  toSectionId,
-  generateNavLinks
-};