@bendyline/squisq 1.2.2 → 1.4.0

package/dist/chunk-K32VJONL.js

@@ -0,0 +1,193 @@
+// src/jsonForm/chooseControl.ts
+var ENUM_SEGMENTED_LIMIT = 4;
+var MULTILINE_LENGTH_THRESHOLD = 200;
+function chooseControl(schema) {
+  const hint = schema.squisq?.control;
+  if (hint) return hint;
+  const type = primaryType(schema);
+  if (schema.format && type === "string") {
+    switch (schema.format) {
+      case "color":
+        return "color";
+      case "date":
+        return "date";
+      case "time":
+        return "time";
+      case "date-time":
+        return "datetime";
+      case "markdown":
+        return "richtext";
+      case "textarea":
+        return "multiline";
+    }
+  }
+  if (schema.enum && schema.enum.length > 0) {
+    return schema.enum.length <= ENUM_SEGMENTED_LIMIT ? "segmented" : "combobox";
+  }
+  if (schema.oneOf || schema.anyOf) return "tabs";
+  switch (type) {
+    case "array":
+      return arrayItemKind(schema) === "object" ? "card-stack" : "chip-bin";
+    case "object":
+      return "group";
+    case "boolean":
+      return "toggle";
+    case "integer":
+    case "number":
+      return hasFiniteRange(schema) ? "slider" : "stepper";
+    case "string":
+      if (typeof schema.maxLength === "number" && schema.maxLength > MULTILINE_LENGTH_THRESHOLD) {
+        return "multiline";
+      }
+      return "text";
+    default:
+      return "text";
+  }
+}
+function primaryType(schema) {
+  const t = schema.type;
+  if (typeof t === "string") return t;
+  if (Array.isArray(t)) return t.find((x) => x !== "null");
+  return void 0;
+}
+function arrayItemKind(schema) {
+  const items = Array.isArray(schema.items) ? schema.items[0] : schema.items;
+  if (!items) return "primitive";
+  return primaryType(items) === "object" ? "object" : "primitive";
+}
+function hasFiniteRange(schema) {
+  const min = schema.minimum ?? schema.exclusiveMinimum;
+  const max = schema.maximum ?? schema.exclusiveMaximum;
+  return typeof min === "number" && typeof max === "number";
+}
+
+// src/jsonForm/pointer.ts
+function toPointer(path) {
+  if (path === "" || path === "/") return "";
+  if (path.startsWith("/")) return path;
+  return "/" + path.split(".").map((seg) => seg.replace(/~/g, "~0").replace(/\//g, "~1")).join("/");
+}
+function pointerSegments(pointer) {
+  if (pointer === "") return [];
+  return pointer.slice(1).split("/").map((seg) => seg.replace(/~1/g, "/").replace(/~0/g, "~"));
+}
+function getByPointer(data, path) {
+  const segments = pointerSegments(toPointer(path));
+  let cur = data;
+  for (const seg of segments) {
+    if (cur === null || cur === void 0) return void 0;
+    if (Array.isArray(cur)) {
+      const idx = Number(seg);
+      if (!Number.isInteger(idx) || idx < 0 || idx >= cur.length) return void 0;
+      cur = cur[idx];
+    } else if (typeof cur === "object") {
+      cur = cur[seg];
+    } else {
+      return void 0;
+    }
+  }
+  return cur;
+}
+function setByPointer(data, path, value) {
+  const segments = pointerSegments(toPointer(path));
+  if (segments.length === 0) return value;
+  return setRec(data, segments, 0, value);
+}
+function setRec(node, segments, i, value) {
+  const seg = segments[i];
+  const isLast = i === segments.length - 1;
+  const nextSeg = isLast ? void 0 : segments[i + 1];
+  const writingArrayChild = nextSeg !== void 0 && /^\d+$/.test(nextSeg);
+  if (Array.isArray(node)) {
+    const idx = Number(seg);
+    const next = node.slice();
+    next[idx] = isLast ? value : setRec(node[idx] ?? (writingArrayChild ? [] : {}), segments, i + 1, value);
+    return next;
+  }
+  const obj = node && typeof node === "object" ? { ...node } : {};
+  obj[seg] = isLast ? value : setRec(obj[seg] ?? (writingArrayChild ? [] : {}), segments, i + 1, value);
+  return obj;
+}
+function resolveRef(schema, root) {
+  if (!schema.$ref) return schema;
+  const ref = schema.$ref;
+  if (!ref.startsWith("#/")) return void 0;
+  const segments = pointerSegments(ref.slice(1));
+  let cur = root;
+  for (const seg of segments) {
+    if (cur === null || cur === void 0 || typeof cur !== "object") return void 0;
+    cur = cur[seg];
+  }
+  return cur ?? void 0;
+}
+
+// src/jsonForm/evaluateWhen.ts
+function evaluateWhen(when, rootData) {
+  const actual = getByPointer(rootData, when.field);
+  if (when.equals !== void 0) {
+    return deepEqual(actual, when.equals);
+  }
+  if (when.oneOf !== void 0) {
+    return when.oneOf.some((v) => deepEqual(actual, v));
+  }
+  if (when.matches !== void 0) {
+    if (typeof actual !== "string") return false;
+    try {
+      return new RegExp(when.matches).test(actual);
+    } catch {
+      return false;
+    }
+  }
+  if (when.truthy !== void 0) {
+    return Boolean(actual) === when.truthy;
+  }
+  return actual !== void 0 && actual !== null;
+}
+function resolveFlag(flag, rootData) {
+  if (flag === void 0) return false;
+  if (typeof flag === "boolean") return flag;
+  return evaluateWhen(flag, rootData);
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return false;
+  if (typeof a !== typeof b) return false;
+  if (typeof a !== "object") return false;
+  if (Array.isArray(a)) {
+    if (!Array.isArray(b) || a.length !== b.length) return false;
+    return a.every((v, i) => deepEqual(v, b[i]));
+  }
+  if (Array.isArray(b)) return false;
+  const ao = a;
+  const bo = b;
+  const ak = Object.keys(ao);
+  const bk = Object.keys(bo);
+  if (ak.length !== bk.length) return false;
+  return ak.every((k) => deepEqual(ao[k], bo[k]));
+}
+
+// src/jsonForm/inferSchema.ts
+import { createSchema, mergeSchemas } from "genson-js";
+function inferSchema(sample, options = {}) {
+  const base = createSchema(sample);
+  if (!options.additionalSamples || options.additionalSamples.length === 0) {
+    return base;
+  }
+  const extras = options.additionalSamples.map((s) => createSchema(s));
+  return mergeSchemas([base, ...extras]);
+}
+
+export {
+  chooseControl,
+  primaryType,
+  arrayItemKind,
+  toPointer,
+  pointerSegments,
+  getByPointer,
+  setByPointer,
+  resolveRef,
+  evaluateWhen,
+  resolveFlag,
+  inferSchema
+};
+//# sourceMappingURL=chunk-K32VJONL.js.map

package/dist/chunk-K32VJONL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/jsonForm/chooseControl.ts","../src/jsonForm/pointer.ts","../src/jsonForm/evaluateWhen.ts","../src/jsonForm/inferSchema.ts"],"sourcesContent":["/**\n * Pick a `ControlKind` for a schema node. The single dispatcher used by\n * both `<JsonView>` and `<JsonEditor>` so view and edit modes always\n * agree on what each field _is_, even when their UIs differ.\n *\n * Order of precedence:\n *   1. Explicit `squisq.control` hint\n *   2. `format` keyword (color/date/time/datetime/markdown/textarea)\n *   3. Enum cardinality (segmented vs. combobox)\n *   4. Numeric range (slider when both min and max present)\n *   5. String length (multiline when maxLength > 200)\n *   6. Type-default (object/array/boolean/string/number)\n */\n\nimport type { ControlKind, SquisqAnnotatedSchema } from './types.js';\n\nconst ENUM_SEGMENTED_LIMIT = 4;\nconst MULTILINE_LENGTH_THRESHOLD = 200;\n\nexport function chooseControl(schema: SquisqAnnotatedSchema): ControlKind {\n  const hint = schema.squisq?.control;\n  if (hint) return hint;\n\n  const type = primaryType(schema);\n\n  if (schema.format && type === 'string') {\n    switch (schema.format) {\n      case 'color':\n        return 'color';\n      case 'date':\n        return 'date';\n      case 'time':\n        return 'time';\n      case 'date-time':\n        return 'datetime';\n      case 'markdown':\n        return 'richtext';\n      case 'textarea':\n        return 'multiline';\n    }\n  }\n\n  if (schema.enum && schema.enum.length > 0) {\n    return schema.enum.length <= ENUM_SEGMENTED_LIMIT ? 'segmented' : 'combobox';\n  }\n\n  if (schema.oneOf || schema.anyOf) return 'tabs';\n\n  switch (type) {\n    case 'array':\n      return arrayItemKind(schema) === 'object' ? 'card-stack' : 'chip-bin';\n    case 'object':\n      return 'group';\n    case 'boolean':\n      return 'toggle';\n    case 'integer':\n    case 'number':\n      return hasFiniteRange(schema) ? 'slider' : 'stepper';\n    case 'string':\n      if (typeof schema.maxLength === 'number' && schema.maxLength > MULTILINE_LENGTH_THRESHOLD) {\n        return 'multiline';\n      }\n      return 'text';\n    default:\n      return 'text';\n  }\n}\n\n/** Return the first concrete type of a schema, ignoring `null` for nullable shorthand. */\nexport function primaryType(schema: SquisqAnnotatedSchema): string | undefined {\n  const t = schema.type;\n  if (typeof t === 'string') return t;\n  if (Array.isArray(t)) return t.find((x) => x !== 'null');\n  return undefined;\n}\n\n/** Inspect `items` to decide whether an array holds objects or primitives. */\nexport function arrayItemKind(schema: SquisqAnnotatedSchema): 'object' | 'primitive' {\n  const items = Array.isArray(schema.items) ? schema.items[0] : schema.items;\n  if (!items) return 'primitive';\n  return primaryType(items) === 'object' ? 'object' : 'primitive';\n}\n\nfunction hasFiniteRange(schema: SquisqAnnotatedSchema): boolean {\n  const min = schema.minimum ?? schema.exclusiveMinimum;\n  const max = schema.maximum ?? schema.exclusiveMaximum;\n  return typeof min === 'number' && typeof max === 'number';\n}\n","/**\n * JSON Pointer helpers (RFC 6901) plus immutable get/set, plus a tiny\n * dotted-path normalizer so hosts can write `user.role` instead of\n * `/user/role`. `$ref` resolution is local-only (`#/$defs/Foo`).\n */\n\nimport type { SquisqAnnotatedSchema } from './types.js';\n\n/** Normalize a path to a JSON Pointer string. Accepts both forms. */\nexport function toPointer(path: string): string {\n  if (path === '' || path === '/') return '';\n  if (path.startsWith('/')) return path;\n  // Dotted form: split on `.` and escape per RFC 6901.\n  return (\n    '/' +\n    path\n      .split('.')\n      .map((seg) => seg.replace(/~/g, '~0').replace(/\\//g, '~1'))\n      .join('/')\n  );\n}\n\n/** Split a JSON Pointer into decoded segments. Empty string → []. */\nexport function pointerSegments(pointer: string): string[] {\n  if (pointer === '') return [];\n  return pointer\n    .slice(1)\n    .split('/')\n    .map((seg) => seg.replace(/~1/g, '/').replace(/~0/g, '~'));\n}\n\n/** Read a value from data by path (dotted or pointer). Returns undefined if missing. */\nexport function getByPointer(data: unknown, path: string): unknown {\n  const segments = pointerSegments(toPointer(path));\n  let cur: unknown = data;\n  for (const seg of segments) {\n    if (cur === null || cur === undefined) return undefined;\n    if (Array.isArray(cur)) {\n      const idx = Number(seg);\n      if (!Number.isInteger(idx) || idx < 0 || idx >= cur.length) return undefined;\n      cur = cur[idx];\n    } else if (typeof cur === 'object') {\n      cur = (cur as Record<string, unknown>)[seg];\n    } else {\n      return undefined;\n    }\n  }\n  return cur;\n}\n\n/**\n * Return a structurally-shared copy of `data` with the value at `path`\n * replaced. Intermediate objects/arrays are cloned along the path; the\n * rest is shared by reference. Creates intermediate objects if missing.\n */\nexport function setByPointer<T>(data: T, path: string, value: unknown): T {\n  const segments = pointerSegments(toPointer(path));\n  if (segments.length === 0) return value as T;\n  return setRec(data, segments, 0, value) as T;\n}\n\nfunction setRec(node: unknown, segments: string[], i: number, value: unknown): unknown {\n  const seg = segments[i];\n  const isLast = i === segments.length - 1;\n\n  // Decide whether the slot we're about to write into is an array index.\n  const nextSeg = isLast ? undefined : segments[i + 1];\n  const writingArrayChild = nextSeg !== undefined && /^\\d+$/.test(nextSeg);\n\n  if (Array.isArray(node)) {\n    const idx = Number(seg);\n    const next = node.slice();\n    next[idx] = isLast\n      ? value\n      : setRec(node[idx] ?? (writingArrayChild ? [] : {}), segments, i + 1, value);\n    return next;\n  }\n\n  const obj = (node && typeof node === 'object' ? { ...(node as object) } : {}) as Record<\n    string,\n    unknown\n  >;\n  obj[seg] = isLast\n    ? value\n    : setRec(obj[seg] ?? (writingArrayChild ? [] : {}), segments, i + 1, value);\n  return obj;\n}\n\n/**\n * Resolve a local `$ref` (e.g. `#/$defs/Foo`) against the root schema.\n * Returns the original schema if no `$ref` is present, or `undefined`\n * if the reference cannot be resolved. Cross-document refs are not\n * supported.\n */\nexport function resolveRef(\n  schema: SquisqAnnotatedSchema,\n  root: SquisqAnnotatedSchema,\n): SquisqAnnotatedSchema | undefined {\n  if (!schema.$ref) return schema;\n  const ref = schema.$ref;\n  if (!ref.startsWith('#/')) return undefined;\n  const segments = pointerSegments(ref.slice(1));\n  let cur: unknown = root;\n  for (const seg of segments) {\n    if (cur === null || cur === undefined || typeof cur !== 'object') return undefined;\n    cur = (cur as Record<string, unknown>)[seg];\n  }\n  return (cur as SquisqAnnotatedSchema | undefined) ?? undefined;\n}\n","/**\n * Evaluate a `SquisqWhen` rule against the current root data. Pure;\n * renderers call this on every render with fresh data.\n */\n\nimport type { SquisqWhen } from './types.js';\nimport { getByPointer } from './pointer.js';\n\nexport function evaluateWhen(when: SquisqWhen, rootData: unknown): boolean {\n  const actual = getByPointer(rootData, when.field);\n\n  if (when.equals !== undefined) {\n    return deepEqual(actual, when.equals);\n  }\n  if (when.oneOf !== undefined) {\n    return when.oneOf.some((v) => deepEqual(actual, v));\n  }\n  if (when.matches !== undefined) {\n    if (typeof actual !== 'string') return false;\n    try {\n      return new RegExp(when.matches).test(actual);\n    } catch {\n      return false;\n    }\n  }\n  if (when.truthy !== undefined) {\n    return Boolean(actual) === when.truthy;\n  }\n  // No operator specified — defaults to \"field has any defined value\".\n  return actual !== undefined && actual !== null;\n}\n\n/**\n * Resolve a `boolean | SquisqWhen` flag (used by `hidden`/`disabled`)\n * to a final boolean. Literal booleans pass through.\n */\nexport function resolveFlag(flag: boolean | SquisqWhen | undefined, rootData: unknown): boolean {\n  if (flag === undefined) return false;\n  if (typeof flag === 'boolean') return flag;\n  return evaluateWhen(flag, rootData);\n}\n\nfunction deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (a === null || b === null) return false;\n  if (typeof a !== typeof b) return false;\n  if (typeof a !== 'object') return false;\n  if (Array.isArray(a)) {\n    if (!Array.isArray(b) || a.length !== b.length) return false;\n    return a.every((v, i) => deepEqual(v, b[i]));\n  }\n  if (Array.isArray(b)) return false;\n  const ao = a as Record<string, unknown>;\n  const bo = b as Record<string, unknown>;\n  const ak = Object.keys(ao);\n  const bk = Object.keys(bo);\n  if (ak.length !== bk.length) return false;\n  return ak.every((k) => deepEqual(ao[k], bo[k]));\n}\n","/**\n * Infer a JSON Schema from an example JSON value. Thin facade over\n * `genson-js` so consumers don't depend on it directly and we can swap\n * the implementation later.\n */\n\nimport { createSchema, mergeSchemas } from 'genson-js';\nimport type { SquisqAnnotatedSchema } from './types.js';\n\nexport interface InferSchemaOptions {\n  /** Additional samples merged into the inferred schema for broader coverage. */\n  additionalSamples?: readonly unknown[];\n}\n\nexport function inferSchema(\n  sample: unknown,\n  options: InferSchemaOptions = {},\n): SquisqAnnotatedSchema {\n  const base = createSchema(sample) as SquisqAnnotatedSchema;\n  if (!options.additionalSamples || options.additionalSamples.length === 0) {\n    return base;\n  }\n  const extras = options.additionalSamples.map((s) => createSchema(s) as SquisqAnnotatedSchema);\n  return mergeSchemas([base, ...extras] as never[]) as SquisqAnnotatedSchema;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-GAQLMORN.js → chunk-KSWJR66U.js}

@@ -1,6 +1,7 @@
 import {
-  DEFAULT_THEME
-} from "./chunk-53TZ2UTL.js";
+  DEFAULT_THEME,
+  resolveFontFamily
+} from "./chunk-B4EEON3N.js";
 import {
   VIEWPORT_PRESETS,
   createTemplateContext,
@@ -8,10 +9,10 @@ import {
   isPersistentLayerTemplate,
   isTemplateBlock,
   scaledFontSize2 as scaledFontSize
-} from "./chunk-QM5PKNPW.js";
+} from "./chunk-5WFRKURX.js";
 import {
   extractPlainText
-} from "./chunk-7GF6RDED.js";
+} from "./chunk-H3AXU4MJ.js";
 import {
   estimateReadingTime
 } from "./chunk-4X3JQXNM.js";
@@ -388,11 +389,11 @@ function getThemeFont(context, role) {
   const { typography } = context.theme;
   switch (role) {
     case "title":
-      return typography.titleFontFamily || FALLBACK_TITLE;
+      return resolveFontFamily(typography.titleFont, FALLBACK_TITLE);
     case "body":
-      return typography.bodyFontFamily || FALLBACK_BODY;
+      return resolveFontFamily(typography.bodyFont, FALLBACK_BODY);
     case "mono":
-      return typography.monoFontFamily || FALLBACK_MONO;
+      return resolveFontFamily(typography.monoFont, FALLBACK_MONO);
   }
 }
 function themedFontSize(basePx, context, isTitle = false) {
@@ -1495,6 +1496,122 @@ function imageWithCaption(input, context) {
   return layers;
 }
 
+// src/doc/templates/featureBlock.ts
+function buildFeatureLayers(input, context, side) {
+  const { imageSrc, imageAlt, imageWidth, imageHeight, title, body } = input;
+  const { theme, layout } = context;
+  const sized = (imageWidth ?? 0) > 0 || (imageHeight ?? 0) > 0;
+  const stack = layout.stackColumns;
+  const titleFontSize = scaledFontSize(48, context, true);
+  const bodyFontSize = scaledFontSize(24, context, false);
+  let imgX;
+  let imgY;
+  let imgW;
+  let imgH;
+  let imageFit;
+  if (stack) {
+    imgX = "0";
+    imgY = "0";
+    imgW = "100%";
+    imgH = "50%";
+    imageFit = sized ? "contain" : "cover";
+  } else if (sized) {
+    const halfStart = side === "left" ? 5 : 55;
+    imgX = `${halfStart}%`;
+    imgY = "5%";
+    imgW = "40%";
+    imgH = "90%";
+    imageFit = "contain";
+  } else {
+    imgX = side === "left" ? "0" : "50%";
+    imgY = "0";
+    imgW = "50%";
+    imgH = "100%";
+    imageFit = "cover";
+  }
+  const COLUMN_INSET = 4;
+  const textColumnWidth = stack ? 90 : 42;
+  const textX = stack ? `${(100 - textColumnWidth) / 2}%` : side === "left" ? `${50 + COLUMN_INSET}%` : `${50 - COLUMN_INSET}%`;
+  const titleY = stack ? "60%" : body ? "42%" : "50%";
+  const bodyY = stack ? "78%" : title ? "55%" : "50%";
+  const textAnchor = side === "right" && !stack ? "top-right" : "top-left";
+  const textAlign = side === "right" && !stack ? "right" : "left";
+  const layers = [
+    {
+      type: "shape",
+      id: "feature-bg",
+      content: { shape: "rect", fill: theme.colors.background },
+      position: { x: 0, y: 0, width: "100%", height: "100%" }
+    }
+  ];
+  if (imageSrc) {
+    layers.push({
+      type: "image",
+      id: "feature-image",
+      content: {
+        src: imageSrc,
+        alt: imageAlt ?? title ?? "",
+        fit: imageFit
+      },
+      position: { x: imgX, y: imgY, width: imgW, height: imgH }
+    });
+  }
+  if (title) {
+    layers.push({
+      type: "text",
+      id: "feature-title",
+      content: {
+        text: title,
+        style: {
+          fontSize: titleFontSize,
+          fontFamily: getThemeFont(context, "title"),
+          fontWeight: "bold",
+          color: theme.colors.text,
+          textAlign,
+          lineHeight: 1.2
+        }
+      },
+      position: {
+        x: textX,
+        y: titleY,
+        anchor: textAnchor,
+        width: `${textColumnWidth}%`
+      },
+      animation: { type: "fadeIn", duration: 0.8 }
+    });
+  }
+  if (body) {
+    layers.push({
+      type: "text",
+      id: "feature-body",
+      content: {
+        text: body,
+        style: {
+          fontSize: bodyFontSize,
+          fontFamily: getThemeFont(context, "body"),
+          color: theme.colors.textMuted,
+          textAlign,
+          lineHeight: 1.5
+        }
+      },
+      position: {
+        x: textX,
+        y: bodyY,
+        anchor: textAnchor,
+        width: `${textColumnWidth}%`
+      },
+      animation: { type: "fadeIn", duration: 0.8, delay: 0.2 }
+    });
+  }
+  return layers;
+}
+function leftFeature(input, context) {
+  return buildFeatureLayers(input, context, "left");
+}
+function rightFeature(input, context) {
+  return buildFeatureLayers(input, context, "right");
+}
+
 // src/doc/templates/mapBlock.ts
 function mapBlock(input, context) {
   const {
@@ -1643,7 +1760,8 @@ function fullBleedQuote(input, context) {
 
 // src/doc/templates/listBlock.ts
 function listBlock(input, context) {
-  const { items, title, accentImage } = input;
+  const { title, accentImage } = input;
+  const items = Array.isArray(input.items) ? input.items : [];
   const { theme } = context;
   const accentLayout = accentImage ? getAccentLayout(accentImage.position) : DEFAULT_LAYOUT;
   const titleFontSize = scaledFontSize(44, context, true);
@@ -1687,6 +1805,9 @@ function listBlock(input, context) {
       animation: { type: "fadeIn", duration: 1 }
     });
   }
+  const centerX = parseFloat(accentLayout.textCenterX);
+  const widthPct = parseFloat(accentLayout.textWidth);
+  const leftX = Number.isFinite(centerX) && Number.isFinite(widthPct) ? `${centerX - widthPct / 2}%` : "8%";
   const endY = 80;
   const spacing = items.length > 1 ? (endY - startY) / (items.length - 1) : 0;
   for (let i = 0; i < items.length; i++) {
@@ -1701,14 +1822,14 @@ function listBlock(input, context) {
           fontSize: itemFontSize,
           fontFamily: getThemeFont(context, "body"),
           color: theme.colors.text,
-          lineHeight: 1.4,
+          textAlign: "left",
+          lineHeight: 1.2,
           shadow: !!accentImage
         }
       },
       position: {
-        x: accentLayout.textCenterX,
+        x: leftX,
         y: adjustY(`${y}%`, accentLayout),
-        anchor: "center",
         width: accentLayout.textWidth
       },
       animation: { type: "fadeIn", duration: 0.8, delay: 0.3 + 0.3 * i }
@@ -2579,17 +2700,19 @@ function expandCoverBlock(config, context) {
 
 // src/doc/templates/index.ts
 var templateRegistry = {
-  titleBlock,
+  title: titleBlock,
   sectionHeader,
   statHighlight,
-  quoteBlock,
+  quote: quoteBlock,
   factCard,
   twoColumn,
   dateEvent,
   imageWithCaption,
-  mapBlock,
+  leftFeature,
+  rightFeature,
+  map: mapBlock,
   fullBleedQuote,
-  listBlock,
+  list: listBlock,
   photoGrid,
   definitionCard,
   comparisonBar,
@@ -2598,8 +2721,18 @@ var templateRegistry = {
   videoPullQuote,
   dataTable
 };
+var TEMPLATE_ALIASES = {
+  titleBlock: "title",
+  quoteBlock: "quote",
+  mapBlock: "map",
+  listBlock: "list"
+};
+function resolveTemplateName(name) {
+  return TEMPLATE_ALIASES[name] ?? name;
+}
 function expandTemplateBlock(templateBlock, context) {
-  const templateFn = templateRegistry[templateBlock.template];
+  const resolved = resolveTemplateName(templateBlock.template);
+  const templateFn = templateRegistry[resolved];
   if (!templateFn) {
     console.warn(`Unknown template: ${templateBlock.template}`);
     return {
@@ -2614,10 +2747,7 @@ function expandTemplateBlock(templateBlock, context) {
   }
   let layers;
   try {
-    layers = templateFn(
-      templateBlock,
-      context
-    );
+    layers = templateFn(templateBlock, context);
     if (!Array.isArray(layers)) {
       console.error(
         `Template ${templateBlock.template} did not return an array, got:`,
@@ -2862,7 +2992,7 @@ function getAvailableTemplates() {
   return Object.keys(templateRegistry);
 }
 function hasTemplate(name) {
-  return name in templateRegistry;
+  return resolveTemplateName(name) in templateRegistry;
 }
 
 // src/doc/utils/animationUtils.ts
@@ -2983,7 +3113,8 @@ function markdownToDoc(markdownDoc, options) {
   function makeBlock(heading) {
     const id = heading ? generateId(heading, headingIndex++) : "preamble";
     const annotation = heading?.templateAnnotation;
-    const template = annotation?.template ?? (heading ? defaultTemplate : void 0);
+    const rawTemplate = annotation?.template ?? (heading ? defaultTemplate : void 0);
+    const template = rawTemplate != null ? resolveTemplateName(rawTemplate) : void 0;
     const title = heading ? extractPlainText(heading) : void 0;
     const block = {
       id,
@@ -3161,8 +3292,29 @@ function splitIntoSentences(text) {
   }
   return merged;
 }
+function findFirstHtmlImage(nodes) {
+  for (const node of nodes) {
+    if (node.type !== "htmlElement") continue;
+    if (node.tagName === "img" && node.attributes.src) {
+      return { url: node.attributes.src, alt: node.attributes.alt };
+    }
+    const nested = findFirstHtmlImage(node.children);
+    if (nested) return nested;
+  }
+  return void 0;
+}
 function findFirstImage(node) {
-  if (node.type === "image") return node;
+  if (node.type === "image") {
+    const img = node;
+    return { url: img.url, alt: img.alt };
+  }
+  if (node.type === "htmlBlock" || node.type === "htmlInline") {
+    const html = node;
+    if (html.htmlChildren) {
+      const found = findFirstHtmlImage(html.htmlChildren);
+      if (found) return found;
+    }
+  }
   if ("children" in node && Array.isArray(node.children)) {
     for (const child of node.children) {
       const found = findFirstImage(child);
@@ -3237,22 +3389,25 @@ function getLayers(block, context = {}) {
   if (existingLayers && existingLayers.length > 0 && !isTemplateBlock(block)) {
     return injectPersistentLayers(existingLayers, block, context);
   }
-  if (isTemplateBlock(block) && block.template in templateRegistry) {
-    const templateName = block.template;
-    const templateCtx = createTemplateContext(theme, blockIndex, totalBlocks, viewport);
-    let layers;
-    try {
-      const templateFn = templateRegistry[templateName];
-      layers = templateFn(block, templateCtx);
-      if (!Array.isArray(layers)) {
-        console.error(`Template ${templateName} did not return an array, got:`, typeof layers);
+  if (isTemplateBlock(block)) {
+    const resolved = resolveTemplateName(block.template);
+    if (resolved in templateRegistry) {
+      const templateName = resolved;
+      const templateCtx = createTemplateContext(theme, blockIndex, totalBlocks, viewport);
+      let layers;
+      try {
+        const templateFn = templateRegistry[templateName];
+        layers = templateFn(block, templateCtx);
+        if (!Array.isArray(layers)) {
+          console.error(`Template ${templateName} did not return an array, got:`, typeof layers);
+          layers = [];
+        }
+      } catch (err) {
+        console.error(`Error expanding template ${templateName}:`, err);
         layers = [];
       }
-    } catch (err) {
-      console.error(`Error expanding template ${templateName}:`, err);
-      layers = [];
+      return injectPersistentLayers(layers, block, context);
     }
-    return injectPersistentLayers(layers, block, context);
   }
   return injectPersistentLayers([], block, context);
 }
@@ -3324,17 +3479,62 @@ function flattenForAudio(blocks) {
   }
   return result;
 }
+var AUDIO_ONLY_EXTENSIONS = [".mp3", ".wav", ".ogg", ".m4a"];
+var AMBIGUOUS_EXTENSIONS = [".webm", ".mp4"];
+function isNarrationAudioPath(path) {
+  const lower = path.toLowerCase();
+  if (AUDIO_ONLY_EXTENSIONS.some((ext) => lower.endsWith(ext))) return true;
+  if (AMBIGUOUS_EXTENSIONS.some((ext) => lower.endsWith(ext))) {
+    return lower.startsWith("audio/");
+  }
+  return false;
+}
+function stripAudioExtension(filename) {
+  const lower = filename.toLowerCase();
+  for (const ext of [...AUDIO_ONLY_EXTENSIONS, ...AMBIGUOUS_EXTENSIONS]) {
+    if (lower.endsWith(ext)) return filename.slice(0, -ext.length);
+  }
+  return filename;
+}
+function parseConsolidatedTiming(data) {
+  try {
+    const text = new TextDecoder().decode(data);
+    const parsed = JSON.parse(text);
+    if (parsed && parsed.version === 2 && parsed.sections) {
+      return parsed.sections;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
 async function discoverMp3s(container) {
   const files = await container.listFiles();
-  const mp3Files = files.filter((f) => f.path.endsWith(".mp3"));
+  const audioFiles = files.filter((f) => isNarrationAudioPath(f.path));
   const results = [];
-  for (const file of mp3Files) {
+  let consolidatedSections = null;
+  const consolidatedData = await container.readFile("timing.json");
+  if (consolidatedData) {
+    consolidatedSections = parseConsolidatedTiming(consolidatedData);
+  }
+  for (const file of audioFiles) {
     const filename = file.path.split("/").pop() ?? file.path;
     let timing = null;
-    const timingPath = `${file.path}.timing.json`;
-    const timingData = await container.readFile(timingPath);
-    if (timingData) {
-      timing = parseTimingJson(timingData);
+    if (consolidatedSections) {
+      const audioBase = stripAudioExtension(filename);
+      for (const [sectionName, sectionTiming] of Object.entries(consolidatedSections)) {
+        if (audioBase.endsWith(`-${sectionName}`)) {
+          timing = sectionTiming;
+          break;
+        }
+      }
+    }
+    if (!timing) {
+      const timingPath = `${file.path}.timing.json`;
+      const timingData = await container.readFile(timingPath);
+      if (timingData) {
+        timing = parseTimingJson(timingData);
+      }
     }
     results.push({ path: file.path, filename, timing });
   }
@@ -3373,7 +3573,7 @@ function autoMatchBlocks(blocks, mp3s) {
       }
       if (score < MIN_CONTENT_SIMILARITY && block.title) {
         const titleSlug = slugify2(block.title);
-        const fileSlug = slugify2(mp3.filename.replace(/\.mp3$/, ""));
+        const fileSlug = slugify2(stripAudioExtension(mp3.filename));
         if (fileSlug.includes(titleSlug) && titleSlug.length >= 3) {
           score = Math.max(score, MIN_FILENAME_SIMILARITY + 0.1);
         }
@@ -3469,6 +3669,8 @@ export {
   twoColumn,
   dateEvent,
   imageWithCaption,
+  leftFeature,
+  rightFeature,
   mapBlock,
   fullBleedQuote,
   listBlock,
@@ -3482,6 +3684,8 @@ export {
   coverBlock,
   expandCoverBlock,
   templateRegistry,
+  TEMPLATE_ALIASES,
+  resolveTemplateName,
   expandTemplateBlock,
   expandDocBlocks,
   getAvailableTemplates,
@@ -3499,4 +3703,4 @@ export {
   scoreTextSimilarity,
   resolveAudioMapping
 };
-//# sourceMappingURL=chunk-GAQLMORN.js.map
+//# sourceMappingURL=chunk-KSWJR66U.js.map