@openpresentation/opf 0.10.0 → 0.10.1

package/dist/{catalogs-HCTav5Wv.d.ts → catalogs-DoVmvDr7.d.ts}

@@ -311,9 +311,9 @@ interface Layout {
      */
     description?: string;
     /**
-     * Primary kind of content the layout holds. Drives pickers and AI placement decisions.
+     * Primary kind of content the layout holds. Drives pickers and AI placement decisions. Metric is the canonical numeric/KPI category; Number remains an accepted legacy label.
      */
-    contentType?: ("Title" | "Text" | "List" | "Image" | "Number" | "Chart");
+    contentType?: ("Title" | "Text" | "List" | "Image" | "Number" | "Metric" | "Chart" | "Table" | "Code" | "Video" | "Quote" | "Timeline");
     /**
      * How many parallel content blocks the layout exposes ('2x' = two-column, '3x' = three-up, etc.).
      */
@@ -407,9 +407,9 @@ interface Layout {
  */
 interface Placeholder {
     /**
-     * OPF placeholder kind. 'text' and 'list' are flexible textual content regions. The named kinds describe a specific content role used by pickers, AI generation, and engine defaulting.
+     * OPF placeholder kind. 'text' and 'list' are flexible textual content regions. 'metric' is a numeric/KPI content region filled by a metric payload, including its optional label, description, unit, delta, and trend. The named kinds describe a specific content role used by pickers, AI generation, and engine defaulting. 'picture' and legacy 'diagram' use image payloads; 'media' uses video. Quote and timeline use their corresponding payload fields.
      */
-    type: ("title" | "subtitle" | "tag" | "text" | "list" | "chart" | "picture" | "table" | "media" | "diagram" | "code");
+    type: ("title" | "subtitle" | "tag" | "text" | "metric" | "quote" | "timeline" | "list" | "chart" | "picture" | "table" | "media" | "diagram" | "code");
     [k: string]: unknown;
 }
 /**
@@ -789,7 +789,7 @@ interface Beat {
      */
     slideCount?: number;
     /**
-     * Default content kind for the beat's slide. Mirrors ContentPayload.type and helps engines choose a sensible layout when only the beat is specified.
+     * Default content kind for the beat's slide. Uses ContentPayload.type names to help engines choose a layout. The legacy shape value is retained for compatibility and requests an image representation; it is not a native ContentPayload type.
      */
     slideType?: ("text" | "list" | "image" | "shape" | "chart" | "table" | "video" | "code" | "metric" | "quote" | "timeline");
     /**

package/dist/catalogs.d.ts

@@ -1,2 +1,2 @@
-export { C as CatalogEntry, a as CatalogIndex, b as CatalogIndexRecord, c as CatalogKind, d as CatalogRecord, i as audiences, j as catalogEntries, k as catalogIndexes, l as catalogKinds, m as catalogSchemaNames, n as catalogs, o as chartTypes, p as colorSchemes, q as fontSchemes, r as languages, s as layouts, t as narratives, u as purposes, v as socialPlatforms, w as themes, x as tones } from './catalogs-HCTav5Wv.js';
+export { C as CatalogEntry, a as CatalogIndex, b as CatalogIndexRecord, c as CatalogKind, d as CatalogRecord, i as audiences, j as catalogEntries, k as catalogIndexes, l as catalogKinds, m as catalogSchemaNames, n as catalogs, o as chartTypes, p as colorSchemes, q as fontSchemes, r as languages, s as layouts, t as narratives, u as purposes, v as socialPlatforms, w as themes, x as tones } from './catalogs-DoVmvDr7.js';
 import './schemas-BYe5y8-i.js';

package/dist/catalogs.js

@@ -1 +1 @@
-export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-TWMRZ43O.js';
+export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-TU7I3KSB.js';

package/dist/{chunk-GQSK3T7X.js → chunk-D3GQIREP.js}

@@ -4873,9 +4873,15 @@ var layout = {
         "List",
         "Image",
         "Number",
-        "Chart"
+        "Metric",
+        "Chart",
+        "Table",
+        "Code",
+        "Video",
+        "Quote",
+        "Timeline"
       ],
-      "description": "Primary kind of content the layout holds. Drives pickers and AI placement decisions."
+      "description": "Primary kind of content the layout holds. Drives pickers and AI placement decisions. Metric is the canonical numeric/KPI category; Number remains an accepted legacy label."
     },
     "contentMultiple": {
       "type": "string",
@@ -5083,6 +5089,9 @@ var layout = {
             "subtitle",
             "tag",
             "text",
+            "metric",
+            "quote",
+            "timeline",
             "list",
             "chart",
             "picture",
@@ -5091,7 +5100,7 @@ var layout = {
             "diagram",
             "code"
           ],
-          "description": "OPF placeholder kind. 'text' and 'list' are flexible textual content regions. The named kinds describe a specific content role used by pickers, AI generation, and engine defaulting."
+          "description": "OPF placeholder kind. 'text' and 'list' are flexible textual content regions. 'metric' is a numeric/KPI content region filled by a metric payload, including its optional label, description, unit, delta, and trend. The named kinds describe a specific content role used by pickers, AI generation, and engine defaulting. 'picture' and legacy 'diagram' use image payloads; 'media' uses video. Quote and timeline use their corresponding payload fields."
         }
       }
     },
@@ -5871,7 +5880,7 @@ var narrative = {
             "quote",
             "timeline"
           ],
-          "description": "Default content kind for the beat's slide. Mirrors ContentPayload.type and helps engines choose a sensible layout when only the beat is specified."
+          "description": "Default content kind for the beat's slide. Uses ContentPayload.type names to help engines choose a layout. The legacy shape value is retained for compatibility and requests an image representation; it is not a native ContentPayload type."
         },
         "layoutHint": {
           "type": "string",

package/dist/{chunk-NPOKUFEX.js → chunk-EWJNRHXA.js}

@@ -1,6 +1,6 @@
-import { validatePresentation, validationDefinition, validateCatalogRecord } from './chunk-GCB6LGJM.js';
-import { schemas, schemaEntries } from './chunk-GQSK3T7X.js';
-import { catalogKinds, catalogEntries, catalogSchemaNames } from './chunk-TWMRZ43O.js';
+import { validatePresentation, validationDefinition, validateCatalogRecord } from './chunk-ZIL7MGZU.js';
+import { schemas, schemaEntries } from './chunk-D3GQIREP.js';
+import { catalogKinds, catalogEntries, catalogSchemaNames } from './chunk-TU7I3KSB.js';
 import { parseTree, printParseErrorCode, getNodePath } from 'jsonc-parser';
 
 var own = (value, key) => Object.hasOwn(value, key);

package/dist/{chunk-TK3QHM3U.js → chunk-FHGJX5QK.js}

@@ -1,6 +1,6 @@
-import { assertValidPresentation } from './chunk-GCB6LGJM.js';
-import { resolveFontFamilies, resolveCanvasDimensions, composeSlide, tableRowBoundaries } from './chunk-BAWLYSUN.js';
-import { catalogs } from './chunk-TWMRZ43O.js';
+import { assertValidPresentation } from './chunk-ZIL7MGZU.js';
+import { resolveFontFamilies, resolveCanvasDimensions, composeSlide, tableRowBoundaries } from './chunk-PQJRDNA6.js';
+import { catalogs } from './chunk-TU7I3KSB.js';
 
 // src/pagination.ts
 var OPFPaginationError = class extends Error {
@@ -83,14 +83,23 @@ function paginateSlide(input, options = {}) {
   };
   source = withReadability(source);
   let evaluations = 0;
-  const geometry = (slide) => {
+  const geometry = (slide, pageIndex = 0) => {
     if (++evaluations > 2e4) throw new OPFPaginationError("Pagination exceeded its layout evaluation limit. Split the input into smaller sections.");
-    return composeSlide(withReadability(slide, true), options);
+    return composeSlide(withReadability(slide, true), { ...options, slideNumber: (options.slideNumber ?? sourceIndex + 1) + pageIndex });
   };
   const initial = geometry(source);
-  if (!initial.diagnostics.length) return { slides: [source], pages: [{ slideIndex: sourceIndex, mappings: initial.items.map((item) => ({ sourcePath: item.path, outputPath: item.path })) }] };
-  const headerIssues = initial.diagnostics.filter((issue) => headingFields.has(issue.path.slice(sourceBase.length + 1)));
-  if (headerIssues.length) throw new OPFPaginationError("The repeated heading does not fit. Shorten it or change the slide design before pagination.", headerIssues);
+  const repeatedMappings = (pageIndex) => {
+    if (!initial.furniture) return [];
+    const paths = new Set(initial.items.filter((item) => headingFields.has(item.field)).map((item) => item.path));
+    for (const part of initial.furniture?.parts ?? []) {
+      paths.add(part.path);
+      if (part.sourcePath) paths.add(part.sourcePath);
+    }
+    return [...paths].map((sourcePath) => ({ sourcePath, outputPath: sourcePath.startsWith(`${sourceBase}.`) ? `slides.${sourceIndex + pageIndex}${sourcePath.slice(sourceBase.length)}` : sourcePath }));
+  };
+  if (!initial.diagnostics.length) return { slides: [source], pages: [{ slideIndex: sourceIndex, mappings: initial.items.map((item) => ({ sourcePath: item.path, outputPath: item.path })), ...initial.furniture ? { repeatedMappings: repeatedMappings(0) } : {} }] };
+  const headerIssues = initial.diagnostics.filter((issue) => headingFields.has(issue.path.slice(sourceBase.length + 1)) || initial.furniture?.diagnostics.includes(issue));
+  if (headerIssues.length) throw new OPFPaginationError("Repeated headings or header/footer content cannot fit or resolve. Change the repeated content or slide design before pagination.", headerIssues);
   const leaves = initial.items.filter((item) => !headingFields.has(item.field)).map((item) => leafFor(item.path, item.field, item.value));
   const leafPaths = new Set(leaves.map((leaf) => leaf.path));
   const slides = [], pages = [];
@@ -135,11 +144,13 @@ function paginateSlide(input, options = {}) {
     if (pageIndex > 0) delete slide.notes;
     return { slide, mappings };
   };
-  const diagnosticsFor = (portions) => geometry(project(portions, slides.length).slide).diagnostics;
+  const diagnosticsFor = (portions) => geometry(project(portions, slides.length).slide, slides.length).diagnostics;
   const finish = () => {
     if (!selected.size) return;
     if (slides.length >= maxSlides) throw new OPFPaginationError(`Pagination needs more than ${maxSlides} slides. No partial result was returned.`);
     const { slide, mappings } = project(selected, slides.length);
+    const issues = geometry(slide, slides.length).diagnostics;
+    if (issues.length) throw new OPFPaginationError("A continuation page does not fit at its final page number. No partial result was returned.", issues);
     if (slides.length && typeof source.id === "string") {
       let suffix = slides.length + 1, id = `${source.id}--${suffix}`;
       while (reservedIds.has(id)) id = `${source.id}--${++suffix}`;
@@ -148,7 +159,7 @@ function paginateSlide(input, options = {}) {
     }
     assertValidPresentation({ slides: [slide] });
     slides.push(slide);
-    pages.push({ slideIndex: sourceIndex + slides.length - 1, mappings });
+    pages.push({ slideIndex: sourceIndex + slides.length - 1, mappings, ...initial.furniture ? { repeatedMappings: repeatedMappings(slides.length - 1) } : {} });
     selected = /* @__PURE__ */ new Map();
   };
   for (const leaf of leaves) {
@@ -218,10 +229,11 @@ function paginatePresentation(input, options = {}) {
     const fontReference = design.fontScheme ?? theme.fontScheme ?? "roboto";
     const fontScheme = typeof fontReference === "string" ? resolve("fontSchemes", fontReference) : { ...resolve("fontSchemes", fontReference.id), ...fontReference };
     const fonts = resolveFontFamilies(fontScheme);
-    const result = paginateSlide(slide, { ...resolveCanvasDimensions(design.dimensions ?? theme.dimensions), layout, fonts, contentAlignment: design.contentAlignment, titleAlignment: design.titleAlignment, contentBox: design.contentBox, textMeasurement: options.textMeasurement, textRasterPadding: options.textRasterPadding, ...overrides, slideIndex: index, maxSlides: maxSlides - output.length, minFontSize: options.minFontSize, reservedIds });
+    const result = paginateSlide(slide, { ...resolveCanvasDimensions(design.dimensions ?? theme.dimensions), layout, fonts, contentAlignment: design.contentAlignment, titleAlignment: design.titleAlignment, contentBox: design.contentBox, textMeasurement: options.textMeasurement, textRasterPadding: options.textRasterPadding, ...overrides, presentation, slideIndex: index, slideNumber: output.length + 1, maxSlides: maxSlides - output.length, minFontSize: options.minFontSize, reservedIds });
     const outputStart = output.length;
     result.pages.forEach((page, pageIndex) => {
-      pages.push({ sourceSlideIndex: index, slideIndex: outputStart + pageIndex, mappings: page.mappings.map((mapping) => ({ ...mapping, outputPath: mapping.outputPath.replace(/^slides\.\d+/, `slides.${outputStart + pageIndex}`) })) });
+      const remap = (mapping) => ({ ...mapping, outputPath: mapping.outputPath.replace(/^slides\.\d+/, `slides.${outputStart + pageIndex}`) });
+      pages.push({ sourceSlideIndex: index, slideIndex: outputStart + pageIndex, mappings: page.mappings.map(remap), ...page.repeatedMappings ? { repeatedMappings: page.repeatedMappings.map(remap) } : {} });
     });
     output.push(...result.slides);
     reservedIds.push(...result.slides.map((slide2) => slide2.id).filter(Boolean));

package/dist/{chunk-BAWLYSUN.js → chunk-PQJRDNA6.js}

@@ -146,8 +146,105 @@ var headings = /* @__PURE__ */ new Set(["title", "subtitle", "tag"]);
 var rows = ["top", "middle", "bottom"];
 var columns = ["left", "center", "right"];
 var record2 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
-var kind = (field) => field === "items" || field === "bullets" ? "list" : field;
+var kind = (field) => field === "items" ? "list" : field === "bullets" ? "text" : field;
 var round = (value) => Math.round(value * 1e6) / 1e6 || value;
+function layoutFurniture(input, options = {}) {
+  const slide = record2(input), width = options.width ?? 1280, height = options.height ?? 720, scale = Math.min(width, height) / 720;
+  const settings = { ...record2(record2(options.layout).composition), ...record2(slide.composition) };
+  assertComposition(settings);
+  const minimum = (settings.minFontSize ?? 16) * scale, size = Math.max(13 * scale, minimum), padding = (options.textRasterPadding ?? 2) * scale;
+  if (![width, height, scale, minimum, padding].every(Number.isFinite) || width <= 0 || height <= 0 || minimum <= 0 || padding < 0) throw new RangeError("Furniture requires finite positive dimensions and nonnegative raster padding.");
+  const number = options.slideNumber ?? (options.slideIndex ?? 0) + 1;
+  if (!Number.isSafeInteger(number) || number < 1) throw new RangeError("Displayed slide number must be a positive safe integer.");
+  const outlines = options.textMeasurement?.outlineBounds !== void 0, parts = [], diagnostics = [];
+  const sourceRoot = `slides.${options.slideIndex ?? 0}`, organizations = Array.isArray(options.presentation?.organization) ? options.presentation.organization : [options.presentation?.organization];
+  const primaryIndex = organizations.findIndex((item) => record2(item).role === "primary"), organizationIndex = primaryIndex >= 0 ? primaryIndex : organizations.findIndex(Boolean);
+  const organization = record2(organizations[organizationIndex]), organizationPath = Array.isArray(options.presentation?.organization) ? `organization.${organizationIndex}.name` : "organization.name";
+  const fontFamily = options.fonts?.body ?? "sans-serif";
+  let headerBottom = 0, footerTop = height, configured = false;
+  const error = (path, message, code = "text-overflow") => diagnostics.push({ code, path, message });
+  for (const kind2 of ["header", "footer"]) {
+    const local = record2(slide.design)[kind2] !== void 0, value = local ? record2(slide.design)[kind2] : options.presentation?.design?.[kind2];
+    if (value === void 0 || value === false) continue;
+    const root = local ? `${sourceRoot}.design.${kind2}` : `design.${kind2}`;
+    if (!value || typeof value !== "object" || Array.isArray(value)) throw new TypeError("Header/footer content must be an object or false.");
+    configured = true;
+    const zones = [];
+    for (const [index, zone] of ["left", "center", "right"].entries()) {
+      const content = record2(record2(value)[zone]), path = `${root}.${zone}`, x = width * (0.07 + index * 0.3), zoneWidth = width * 0.26, zoneParts = [];
+      let y = 0;
+      const add = (field, text, generated = false, sourcePath) => {
+        if (text === void 0) return;
+        if (typeof text !== "string") throw new TypeError(`Furniture field ${path}.${field} requires string content.`);
+        const partPath = `${path}.${field}`, style = resolveTextStyle({ fontFamily, fontWeight: 400, italic: false, path: partPath }, options.textMeasurement);
+        const fit = fitText(text, { width: Math.max(Number.MIN_VALUE, zoneWidth - (outlines ? 2 * padding : 0)), height: Number.MAX_VALUE }, size, size, textWidthMeasurer(style, options.textMeasurement));
+        const ink = fit.sourceLines.map((line, index2) => {
+          let outline = null;
+          if (outlines) {
+            for (const segment of line.segments) if (segment.kind === "text") {
+              const bounds = measureTextOutline(text.slice(segment.start, segment.end), size, style, options.textMeasurement);
+              if (bounds) {
+                const next = { ...bounds, x: bounds.x + segment.x };
+                if (!outline) outline = next;
+                else {
+                  const right = Math.max(outline.x + outline.width, next.x + next.width), bottom = Math.max(outline.y + outline.height, next.y + next.height);
+                  outline.x = Math.min(outline.x, next.x);
+                  outline.y = Math.min(outline.y, next.y);
+                  outline.width = right - outline.x;
+                  outline.height = bottom - outline.y;
+                }
+              }
+            }
+          }
+          return { width: line.width, y: index2 * fit.lineHeight, baseline: size + index2 * fit.lineHeight, height: fit.lineHeight, outline };
+        });
+        const natural = outlines ? placeTextLines(ink, { x, y, width: zoneWidth, height: Number.MAX_VALUE }, zone, padding) : void 0;
+        const partHeight = natural?.height ?? fit.sourceLines.length * fit.lineHeight;
+        if (!Number.isFinite(partHeight)) throw new RangeError("Furniture exceeds finite layout coordinates.");
+        const box = { x, y, width: zoneWidth, height: Math.max(scale, partHeight) }, placement = outlines ? placeTextLines(ink, box, zone, padding) : void 0;
+        const accepted = { ...fit, ...placement ? { placement } : {}, overflow: fit.overflow || !!placement?.overflow };
+        zoneParts.push({ type: "text", kind: kind2, zone, field, path: partPath, sourcePath: sourcePath ?? (!generated ? partPath : void 0), generated, text, style, requestedFontSize: 13 * scale, minFontSize: minimum, box, alignment: zone, fit: accepted });
+        if (accepted.overflow) error(partPath, "Repeated text exceeds its zone at the selected readability floor; change the furniture or slide design.");
+        y += box.height;
+      };
+      if (content.image !== void 0) {
+        const box = { x, y, width: zoneWidth, height: Math.max(32 * scale, Math.min(height * 0.05, 72 * scale)) };
+        zoneParts.push({ type: "image", kind: kind2, zone, field: "image", path: `${path}.image`, sourcePath: `${path}.image`, generated: false, image: content.image, box, alignment: zone });
+        y += box.height;
+      }
+      add("text", content.text);
+      if (content.organization === true) {
+        if (typeof organization.name === "string") add("organization", organization.name, true, organizationPath);
+        else error(`${path}.organization`, "Generated organization name needs a named organization in the presentation.", "unresolved-content");
+      }
+      if (content.section === true) {
+        if (typeof slide.section === "string") add("section", slide.section, true, `${sourceRoot}.section`);
+        else error(`${path}.section`, "Generated section needs a literal slide section.", "unresolved-content");
+      }
+      if (content.slideNumber === true) add("slideNumber", String(number), true);
+      if (content.date === true) error(`${path}.date`, "Use a literal date string for deterministic header/footer content.", "unresolved-content");
+      else if (typeof content.date === "string") add("date", content.date);
+      zones.push(zoneParts);
+    }
+    const tallest = Math.max(0, ...zones.map((zone) => zone.reduce((sum, part) => sum + part.box.height, 0)));
+    if (!tallest) continue;
+    const top = kind2 === "header" ? height * 0.025 : Math.max(height * 0.025, height - height * 0.04 - tallest);
+    if (kind2 === "header") headerBottom = top + tallest;
+    else footerTop = top;
+    for (const zone of zones) for (const part of zone) {
+      part.box.y += top;
+      if (part.type === "text" && part.fit.placement) for (const line of part.fit.placement.lines) {
+        line.y += top;
+        line.baseline += top;
+        if (line.outline) line.outline.y += top;
+      }
+      if (part.box.y + part.box.height > height - height * 0.04 + 0.01) error(part.path, "Repeated header/footer content extends beyond the usable slide height. Change its content or design before pagination.");
+      parts.push(part);
+    }
+  }
+  if (headerBottom > footerTop + 0.01) error(parts.find((part) => part.kind === "footer")?.path ?? sourceRoot, "Header and footer content overlap; repeated content cannot be repaired by splitting body content.");
+  return { algorithm: "furniture-flow-v2", configured, textMeasurement: options.textMeasurement ? "provided" : "estimated", textOutlines: outlines ? "provided" : "unavailable", parts, headerBottom, footerTop, diagnostics, overflow: diagnostics.length > 0 };
+}
 var textSegments = new Intl.Segmenter("und", { granularity: "grapheme" });
 function measureText(text, fontSize) {
   let units = 0;
@@ -1078,7 +1175,11 @@ function composeSlide(input, options = {}) {
   const fitContent = (field, value, text, box, size, minimum, path2) => field === "text" ? fitPlacedText(field, value, text, box, size, minimum, path2) : field === "items" || field === "bullets" ? fitList(value, box, size, minimum, { style: styleFor(field, path2), textMeasurement: options.textMeasurement }) : fitText(text, box, size, minimum, widthFor(field, path2));
   const path = `slides.${options.slideIndex ?? 0}`;
   const items = [], diagnostics = [];
-  let y = padding;
+  const measuredFurniture = layoutFurniture(slide, options);
+  const furniture = measuredFurniture.configured || measuredFurniture.diagnostics.length ? measuredFurniture : void 0;
+  if (furniture) diagnostics.push(...furniture.diagnostics);
+  const bodyBottom = Math.min(height - padding, furniture && furniture.footerTop < height ? furniture.footerTop - gap * 0.5 : height - padding);
+  let y = Math.max(padding, furniture?.headerBottom ? furniture.headerBottom + gap * 0.5 : padding);
   for (const field of ["tag", "title", "subtitle"]) {
     if (!slide[field]) continue;
     const requested = (field === "title" ? 54 : field === "tag" ? 16 : 25) * scale;
@@ -1086,11 +1187,12 @@ function composeSlide(input, options = {}) {
     const box = { x: padding, y, width: width - padding * 2, height: maxHeight };
     const text = fitPlacedText(field, slide[field], String(slide[field]), box, requested, minSize, `${path}.${field}`);
     box.height = Math.min(maxHeight, Math.max(text.lines.length * text.lineHeight, text.placement?.height ?? 0));
+    if (furniture && box.y + box.height > bodyBottom + 0.01) diagnostics.push({ code: "text-overflow", path: `${path}.${field}`, message: "Repeated furniture leaves too little room for this heading. Change the header/footer or slide design." });
     items.push({ path: `${path}.${field}`, field, type: "text", value: slide[field], payload: { text: slide[field] }, box, text, textStyle: styleFor(field, `${path}.${field}`), composition });
     y += box.height + gap * 0.5;
   }
   if (items.length) y += gap * 0.5;
-  const contentBox = { x: padding, y, width: width - padding * 2, height: Math.max(scale, height - padding - y) };
+  const contentBox = { x: padding, y, width: width - padding * 2, height: Math.max(scale, bodyBottom - y) };
   const collect = (host, basePath, depth = 0, ancestors = []) => {
     if (Array.isArray(host.blocks)) {
       if (depth >= MAX_COMPOSITION_DEPTH || ancestors.includes(host)) throw new RangeError(`Content groups must be acyclic and nest at most ${MAX_COMPOSITION_DEPTH} levels.`);
@@ -1285,6 +1387,7 @@ function composeSlide(input, options = {}) {
   for (const group of groups) for (const box of [group.box, group.contentBox]) for (const key of ["x", "y", "width", "height"]) box[key] = round(box[key]);
   const strictPaths = new Set(items.filter((item) => item.composition.overflow === "error").map((item) => item.path));
   const failures = diagnostics.filter((diagnostic) => {
+    if (composition.overflow === "error") return true;
     let path2 = diagnostic.path;
     while (path2) {
       if (strictPaths.has(path2)) return true;
@@ -1295,7 +1398,7 @@ function composeSlide(input, options = {}) {
     return false;
   });
   const explanation = decisions ? {
-    algorithm: "grid-score-v8",
+    algorithm: "grid-score-v9",
     textMeasurement: options.textMeasurement ? "provided" : "estimated",
     textOutlines: options.textMeasurement?.outlineBounds ? "provided" : "unavailable",
     textRasterPadding: rasterPadding,
@@ -1303,7 +1406,7 @@ function composeSlide(input, options = {}) {
     unmeasuredPayloads: items.filter((item) => !headings.has(item.field) && !item.quoteLayout && !item.codeLayout && !item.metricLayout && !item.timelineLayout && !["text", "items", "bullets", "table"].includes(item.field)).map((item) => item.path)
   } : void 0;
   if (failures.length) throw new OPFCompositionError(failures, explanation);
-  return { width, height, contentBox, items, groups, flows, diagnostics, composition, ...explanation ? { explanation } : {} };
+  return { width, height, contentBox, items, groups, flows, diagnostics, composition, ...furniture ? { furniture } : {}, ...explanation ? { explanation } : {} };
 }
 function resolveCanvasDimensions(input) {
   const presets = {
@@ -1323,4 +1426,4 @@ function resolveCanvasDimensions(input) {
   return { width, height };
 }
 
-export { MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText };
+export { MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText };

package/dist/{chunk-OZULJBSG.js → chunk-RS5GZ5RW.js}

@@ -1872,6 +1872,12 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/layouts/quote-1x.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/layouts/quote-1x.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/layouts/table-1x.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/layouts/table-1x.json",
@@ -1896,6 +1902,12 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/layouts/timeline-1x.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/layouts/timeline-1x.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/layouts/title-subtitle.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/layouts/title-subtitle.json",
@@ -3188,10 +3200,12 @@ var specFilePaths = [
   "catalogs/layouts/number-4x.json",
   "catalogs/layouts/number-5x.json",
   "catalogs/layouts/number-6x.json",
+  "catalogs/layouts/quote-1x.json",
   "catalogs/layouts/table-1x.json",
   "catalogs/layouts/text-1x.json",
   "catalogs/layouts/text-2x.json",
   "catalogs/layouts/text-3x.json",
+  "catalogs/layouts/timeline-1x.json",
   "catalogs/layouts/title-subtitle.json",
   "catalogs/layouts/title.json",
   "catalogs/narratives/board-meeting.json",

package/dist/{chunk-TWMRZ43O.js → chunk-TU7I3KSB.js}

@@ -1177,7 +1177,7 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ]
   },
@@ -1190,10 +1190,10 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -1209,13 +1209,13 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -1231,16 +1231,16 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -1257,19 +1257,19 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -1286,22 +1286,22 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -1309,6 +1309,19 @@ var layouts = [
       "columns": 3
     }
   },
+  {
+    "$schema": "https://openpresentation.org/schema/opf-layout/v1",
+    "id": "quote-1x",
+    "name": "Quote 1x",
+    "placeholders": [
+      {
+        "type": "title"
+      },
+      {
+        "type": "quote"
+      }
+    ]
+  },
   {
     "$schema": "https://openpresentation.org/schema/opf-layout/v1",
     "id": "table-1x",
@@ -1382,6 +1395,19 @@ var layouts = [
       "mode": "row"
     }
   },
+  {
+    "$schema": "https://openpresentation.org/schema/opf-layout/v1",
+    "id": "timeline-1x",
+    "name": "Timeline 1x",
+    "placeholders": [
+      {
+        "type": "title"
+      },
+      {
+        "type": "timeline"
+      }
+    ]
+  },
   {
     "$schema": "https://openpresentation.org/schema/opf-layout/v1",
     "id": "title",
@@ -15562,6 +15588,11 @@ var catalogIndexes = {
         "name": "Number 6x",
         "file": "number-6x.json"
       },
+      {
+        "id": "quote-1x",
+        "name": "Quote 1x",
+        "file": "quote-1x.json"
+      },
       {
         "id": "table-1x",
         "name": "Table 1x",
@@ -15582,6 +15613,11 @@ var catalogIndexes = {
         "name": "Text 3x",
         "file": "text-3x.json"
       },
+      {
+        "id": "timeline-1x",
+        "name": "Timeline 1x",
+        "file": "timeline-1x.json"
+      },
       {
         "id": "title",
         "name": "Title",
@@ -18231,10 +18267,12 @@ var catalogEntries = [
     "number-4x.json",
     "number-5x.json",
     "number-6x.json",
+    "quote-1x.json",
     "table-1x.json",
     "text-1x.json",
     "text-2x.json",
     "text-3x.json",
+    "timeline-1x.json",
     "title.json",
     "title-subtitle.json"
   ], records: layouts, index: catalogIndexes.layouts },

package/dist/{chunk-GCB6LGJM.js → chunk-ZIL7MGZU.js}

@@ -1,6 +1,6 @@
-import { MAX_COMPOSITION_DEPTH, tableGrid } from './chunk-BAWLYSUN.js';
-import { schemas, schemaEntries } from './chunk-GQSK3T7X.js';
-import { catalogSchemaNames } from './chunk-TWMRZ43O.js';
+import { MAX_COMPOSITION_DEPTH, tableGrid } from './chunk-PQJRDNA6.js';
+import { schemas, schemaEntries } from './chunk-D3GQIREP.js';
+import { catalogSchemaNames } from './chunk-TU7I3KSB.js';
 import Ajv2020 from 'ajv/dist/2020.js';
 import addFormats from 'ajv-formats';
 
@@ -67,10 +67,12 @@ var catalogIds = {
     "number-4x",
     "number-5x",
     "number-6x",
+    "quote-1x",
     "table-1x",
     "text-1x",
     "text-2x",
     "text-3x",
+    "timeline-1x",
     "title",
     "title-subtitle"
   ],