@openpresentation/cli 0.8.0 → 0.8.1

package/dist/index.js

@@ -8149,13 +8149,13 @@ import path2 from "path";
 // ../javascript/dist/index.js
 init_define_OPF_SKILLS();
 
-// ../javascript/dist/chunk-NPOKUFEX.js
+// ../javascript/dist/chunk-EWJNRHXA.js
 init_define_OPF_SKILLS();
 
-// ../javascript/dist/chunk-GCB6LGJM.js
+// ../javascript/dist/chunk-ZIL7MGZU.js
 init_define_OPF_SKILLS();
 
-// ../javascript/dist/chunk-BAWLYSUN.js
+// ../javascript/dist/chunk-PQJRDNA6.js
 init_define_OPF_SKILLS();
 var record = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
 function tableGrid(value, path3 = "table") {
@@ -8263,8 +8263,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, parts2 = [], 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 = (path3, message, code = "text-overflow") => diagnostics.push({ code, path: path3, 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 [index2, zone] of ["left", "center", "right"].entries()) {
+      const content = record2(record2(value)[zone]), path3 = `${root}.${zone}`, x = width * (0.07 + index2 * 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 ${path3}.${field} requires string content.`);
+        const partPath = `${path3}.${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, index22) => {
+          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: index22 * fit.lineHeight, baseline: size + index22 * 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: `${path3}.image`, sourcePath: `${path3}.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(`${path3}.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(`${path3}.section`, "Generated section needs a literal slide section.", "unresolved-content");
+      }
+      if (content.slideNumber === true) add("slideNumber", String(number), true);
+      if (content.date === true) error(`${path3}.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.");
+      parts2.push(part);
+    }
+  }
+  if (headerBottom > footerTop + 0.01) error(parts2.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: parts2, headerBottom, footerTop, diagnostics, overflow: diagnostics.length > 0 };
+}
 var textSegments = new Intl.Segmenter("und", { granularity: "grapheme" });
 function measureText(text, fontSize) {
   let units = 0;
@@ -9192,7 +9289,11 @@ function composeSlide(input, options = {}) {
   const fitContent = (field, value, text, box, size, minimum, path22) => field === "text" ? fitPlacedText(field, value, text, box, size, minimum, path22) : field === "items" || field === "bullets" ? fitList(value, box, size, minimum, { style: styleFor(field, path22), textMeasurement: options.textMeasurement }) : fitText(text, box, size, minimum, widthFor(field, path22));
   const path3 = `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;
@@ -9200,11 +9301,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, `${path3}.${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: `${path3}.${field}`, message: "Repeated furniture leaves too little room for this heading. Change the header/footer or slide design." });
     items.push({ path: `${path3}.${field}`, field, type: "text", value: slide[field], payload: { text: slide[field] }, box, text, textStyle: styleFor(field, `${path3}.${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.`);
@@ -9399,6 +9501,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 path22 = diagnostic.path;
     while (path22) {
       if (strictPaths.has(path22)) return true;
@@ -9409,7 +9512,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,
@@ -9417,7 +9520,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 = {
@@ -9437,7 +9540,7 @@ function resolveCanvasDimensions(input) {
   return { width, height };
 }
 
-// ../javascript/dist/chunk-GQSK3T7X.js
+// ../javascript/dist/chunk-D3GQIREP.js
 init_define_OPF_SKILLS();
 var presentation = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -14313,9 +14416,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",
@@ -14523,6 +14632,9 @@ var layout = {
             "subtitle",
             "tag",
             "text",
+            "metric",
+            "quote",
+            "timeline",
             "list",
             "chart",
             "picture",
@@ -14531,7 +14643,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."
         }
       }
     },
@@ -15311,7 +15423,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",
@@ -16113,7 +16225,7 @@ var schemaEntries = [
   { name: "fontScheme", file: "schemas/font-scheme.schema.json", schema: fontScheme }
 ];
 
-// ../javascript/dist/chunk-TWMRZ43O.js
+// ../javascript/dist/chunk-TU7I3KSB.js
 init_define_OPF_SKILLS();
 var audiences = [
   {
@@ -17293,7 +17405,7 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ]
   },
@@ -17306,10 +17418,10 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -17325,13 +17437,13 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -17347,16 +17459,16 @@ var layouts = [
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -17373,19 +17485,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": {
@@ -17402,22 +17514,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": {
@@ -17425,6 +17537,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",
@@ -17498,6 +17623,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",
@@ -31678,6 +31816,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",
@@ -31698,6 +31841,11 @@ var catalogIndexes = {
         "name": "Text 3x",
         "file": "text-3x.json"
       },
+      {
+        "id": "timeline-1x",
+        "name": "Timeline 1x",
+        "file": "timeline-1x.json"
+      },
       {
         "id": "title",
         "name": "Title",
@@ -34347,10 +34495,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 },
@@ -34689,7 +34839,7 @@ var catalogEntries = [
   ], records: fontSchemes, index: catalogIndexes.fontSchemes }
 ];
 
-// ../javascript/dist/chunk-GCB6LGJM.js
+// ../javascript/dist/chunk-ZIL7MGZU.js
 var import__ = __toESM(require__(), 1);
 var import_ajv_formats = __toESM(require_dist(), 1);
 var catalogIds = {
@@ -34754,10 +34904,12 @@ var catalogIds = {
     "number-4x",
     "number-5x",
     "number-6x",
+    "quote-1x",
     "table-1x",
     "text-1x",
     "text-2x",
     "text-3x",
+    "timeline-1x",
     "title",
     "title-subtitle"
   ],
@@ -36695,7 +36847,7 @@ function printParseErrorCode(code) {
   return "<unknown ParseErrorCode>";
 }
 
-// ../javascript/dist/chunk-NPOKUFEX.js
+// ../javascript/dist/chunk-EWJNRHXA.js
 var own = (value, key) => Object.hasOwn(value, key);
 var object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var primitive = (value) => value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value);
@@ -37430,7 +37582,7 @@ function createDataContent(input, options) {
   return { chart: { type: options.chartType ?? "column", data: { columns: names, rows: rows2 } } };
 }
 
-// ../javascript/dist/chunk-TK3QHM3U.js
+// ../javascript/dist/chunk-FHGJX5QK.js
 init_define_OPF_SKILLS();
 var OPFPaginationError = class extends Error {
   constructor(message, diagnostics = []) {
@@ -37512,14 +37664,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 = [];
@@ -37564,11 +37725,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}`;
@@ -37577,7 +37740,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) {
@@ -37647,10 +37810,11 @@ function paginatePresentation(input, options = {}) {
     const fontReference = design.fontScheme ?? theme2.fontScheme ?? "roboto";
     const fontScheme2 = typeof fontReference === "string" ? resolve2("fontSchemes", fontReference) : { ...resolve2("fontSchemes", fontReference.id), ...fontReference };
     const fonts = resolveFontFamilies(fontScheme2);
-    const result = paginateSlide(slide, { ...resolveCanvasDimensions(design.dimensions ?? theme2.dimensions), layout: layout2, fonts, contentAlignment: design.contentAlignment, titleAlignment: design.titleAlignment, contentBox: design.contentBox, textMeasurement: options.textMeasurement, textRasterPadding: options.textRasterPadding, ...overrides, slideIndex: index2, maxSlides: maxSlides - output.length, minFontSize: options.minFontSize, reservedIds });
+    const result = paginateSlide(slide, { ...resolveCanvasDimensions(design.dimensions ?? theme2.dimensions), layout: layout2, fonts, contentAlignment: design.contentAlignment, titleAlignment: design.titleAlignment, contentBox: design.contentBox, textMeasurement: options.textMeasurement, textRasterPadding: options.textRasterPadding, ...overrides, presentation: presentation2, slideIndex: index2, slideNumber: output.length + 1, maxSlides: maxSlides - output.length, minFontSize: options.minFontSize, reservedIds });
     const outputStart = output.length;
     result.pages.forEach((page, pageIndex) => {
-      pages.push({ sourceSlideIndex: index2, 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: index2, 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));
@@ -38157,7 +38321,7 @@ async function main(argv) {
     return;
   }
   if (argv.length === 1 && argv[0] === "--version") {
-    print({ cli: "0.8.0", opf: "0.10.0" });
+    print({ cli: "0.8.1", opf: "0.10.1" });
     return;
   }
   const [command, ...args] = argv;
@@ -38168,7 +38332,7 @@ async function main(argv) {
   if (command === "skills") {
     const { positional, options } = parse2(args, ["agent", "global", "directory"]);
     arity(positional, 1);
-    print(await manageSkills(positional[0], define_OPF_SKILLS_default, "0.8.0", { agent: options.agent, global: !!options.global, directory: options.directory }));
+    print(await manageSkills(positional[0], define_OPF_SKILLS_default, "0.8.1", { agent: options.agent, global: !!options.global, directory: options.directory }));
     return;
   }
   if (command === "create") {
@@ -38203,7 +38367,7 @@ async function main(argv) {
     print({
       ...result,
       sha256: hash(raw),
-      opfVersion: "0.10.0",
+      opfVersion: "0.10.1",
       ...config ? { context: { file: path2.resolve(String(options.config)), sha256: hash(config.raw) } } : {}
     });
     if (!result.valid || options.strict && result.counts.warning) process.exitCode = 1;