@openpresentation/opf 0.10.1 → 0.11.1

package/dist/{chunk-PQJRDNA6.js → chunk-6UPHKXI5.js}

@@ -35,7 +35,184 @@ function tableRowBoundaries(value) {
   return [...allowed];
 }
 
+// src/furniture-fields.ts
+var DEFAULT_FURNITURE_DATE_FORMAT = "M/d/yyyy";
+var DEFAULT_SLIDE_NUMBER_FORMAT = "{current}";
+var months = ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
+var weekdays = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+var tokenWidths = { y: [1, 2, 4], M: [1, 2, 3, 4], d: [1, 2], E: [1, 2, 3, 4] };
+function parseFurnitureDateFormat(pattern) {
+  if (!pattern) return "dateFormat must not be empty.";
+  const tokens = [];
+  const literal = (text) => {
+    const last = tokens[tokens.length - 1];
+    if (last?.kind === "literal") last.text += text;
+    else tokens.push({ kind: "literal", text });
+  };
+  for (let index = 0; index < pattern.length; ) {
+    const character = pattern.charAt(index);
+    if (character === "'") {
+      if (pattern[index + 1] === "'") {
+        literal("'");
+        index += 2;
+        continue;
+      }
+      let end = index + 1, text = "";
+      for (; ; ) {
+        if (end >= pattern.length) return "dateFormat has an unterminated quoted literal.";
+        if (pattern[end] === "'") {
+          if (pattern[end + 1] === "'") {
+            text += "'";
+            end += 2;
+            continue;
+          }
+          break;
+        }
+        text += pattern[end];
+        end++;
+      }
+      literal(text);
+      index = end + 1;
+      continue;
+    }
+    if (/[A-Za-z]/.test(character)) {
+      let end = index;
+      while (pattern[end] === character) end++;
+      const width = end - index;
+      if (!tokenWidths[character]?.includes(width)) return `dateFormat token '${pattern.slice(index, end)}' is not supported; use yyyy, yy, MMMM, MMM, MM, M, dd, d, EEEE or EEE, and quote literal letters.`;
+      tokens.push({ kind: "field", letter: character, width });
+      index = end;
+      continue;
+    }
+    literal(character);
+    index++;
+  }
+  return tokens;
+}
+function parseIsoDate(value) {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+  if (!match) return null;
+  const year = Number(match[1]), month = Number(match[2]), day = Number(match[3]);
+  const date = new Date(Date.UTC(2e3, month - 1, day));
+  date.setUTCFullYear(year);
+  if (date.getUTCFullYear() !== year || date.getUTCMonth() !== month - 1 || date.getUTCDate() !== day) return null;
+  return { year, month, day };
+}
+function formatFurnitureDate(iso, pattern) {
+  const date = parseIsoDate(iso);
+  if (!date) return { error: `'${iso}' is not an ISO YYYY-MM-DD calendar date.` };
+  const tokens = parseFurnitureDateFormat(pattern);
+  if (typeof tokens === "string") return { error: tokens };
+  const utc = new Date(Date.UTC(2e3, date.month - 1, date.day));
+  utc.setUTCFullYear(date.year);
+  const pad = (value, width) => String(value).padStart(width, "0");
+  let text = "";
+  for (const token of tokens) {
+    if (token.kind === "literal") {
+      text += token.text;
+      continue;
+    }
+    const { letter, width } = token;
+    if (letter === "y") text += width === 2 ? pad(date.year % 100, 2) : width === 4 ? pad(date.year, 4) : String(date.year);
+    else if (letter === "M") {
+      const name = months[date.month - 1] ?? "";
+      text += width >= 3 ? width === 4 ? name : name.slice(0, 3) : pad(date.month, width);
+    } else if (letter === "d") text += pad(date.day, width);
+    else {
+      const name = weekdays[utc.getUTCDay()] ?? "";
+      text += width === 4 ? name : name.slice(0, 3);
+    }
+  }
+  return { text };
+}
+function formatSlideNumber(format, current, total) {
+  if (!format.includes("{current}")) return { error: "slideNumberFormat must contain {current}." };
+  if (format.includes("{total}") && total === void 0) return { error: "slideNumberFormat uses {total}, which needs the rendered slide count." };
+  let text = "";
+  const fields2 = [];
+  for (const piece of format.split(/(\{current\}|\{total\})/)) {
+    if (piece === "{current}") {
+      const value = String(current);
+      fields2.push({ type: "slideNumber", start: text.length, end: text.length + value.length });
+      text += value;
+    } else if (piece === "{total}") text += String(total);
+    else text += piece;
+  }
+  return { text, fields: fields2 };
+}
+
 // src/color.ts
+var schemeColorSlots = /* @__PURE__ */ new Set([
+  "accent1",
+  "accent2",
+  "accent3",
+  "accent4",
+  "accent5",
+  "accent6",
+  "dark1",
+  "dark2",
+  "light1",
+  "light2",
+  "hyperlink",
+  "followedHyperlink"
+]);
+var schemeColorRoles = /* @__PURE__ */ new Set([
+  "primary",
+  "secondary",
+  "accent",
+  "background",
+  "surface",
+  "text",
+  "textSecondary"
+]);
+var defaultRoleSlots = {
+  primary: "accent1",
+  secondary: "accent2",
+  accent: "accent3",
+  background: "light1",
+  surface: "light2",
+  text: "dark1",
+  textSecondary: "dark2"
+};
+function normalizeHexColor(value) {
+  if (typeof value !== "string") return void 0;
+  let hex = value.trim();
+  if (/^#[0-9a-f]{3}$/i.test(hex)) hex = `#${[...hex.slice(1)].map((char) => char + char).join("")}`;
+  if (/^#[0-9a-f]{6}([0-9a-f]{2})?$/i.test(hex)) return hex.length === 9 ? `#${hex.slice(1, 7).toUpperCase()}` : hex.toUpperCase();
+  return void 0;
+}
+function schemeSlot(colorScheme, slot, fallback) {
+  return normalizeHexColor(colorScheme[slot]) ?? fallback;
+}
+function resolveVariable(variables, id, fallback) {
+  const entry = variables[id];
+  if (typeof entry === "string") return normalizeHexColor(entry) ?? fallback;
+  if (entry && typeof entry === "object" && entry.type === "color") {
+    return normalizeHexColor(entry.value) ?? fallback;
+  }
+  return fallback;
+}
+function resolveColorRef(reference, options) {
+  const { colorScheme, roles, variables = {}, fallback } = options;
+  const literal = normalizeHexColor(reference);
+  if (literal) return literal;
+  if (reference.startsWith("var:")) {
+    const id = reference.slice("var:".length);
+    if (/^[a-z][a-z0-9-]*$/.test(id)) return resolveVariable(variables, id, fallback);
+    return fallback;
+  }
+  if (schemeColorRoles.has(reference)) {
+    const roleKey = reference;
+    const fromRoles = roles?.[roleKey];
+    if (fromRoles) return normalizeHexColor(fromRoles) ?? fallback;
+    const fromScheme = normalizeHexColor(colorScheme[reference]);
+    if (fromScheme) return fromScheme;
+    const slot = defaultRoleSlots[reference];
+    return slot ? schemeSlot(colorScheme, slot, fallback) : fallback;
+  }
+  if (schemeColorSlots.has(reference)) return schemeSlot(colorScheme, reference, fallback);
+  return fallback;
+}
 function luminance(value) {
   if (typeof value !== "string") return void 0;
   let hex = value.trim();
@@ -76,13 +253,25 @@ function chartColorForFill(fill, preferred) {
 
 // src/composition.ts
 var MAX_COMPOSITION_DEPTH = 32;
+var FALLBACK_CODE_FAMILY = "Roboto Mono";
+var DEFAULT_FONT_SCHEME = "aptos";
+var DEFAULT_FONT_FAMILIES = { heading: "Aptos Display", body: "Aptos" };
+function resolveFontSchemeReference(reference, lookup, path = "design.fontScheme") {
+  const overrides = typeof reference === "object" && reference !== null && !Array.isArray(reference) ? reference : void 0;
+  const id = typeof reference === "string" ? reference : typeof overrides?.id === "string" ? overrides.id : void 0;
+  const found = id === void 0 ? void 0 : lookup(id);
+  const base = record2(found ?? lookup(DEFAULT_FONT_SCHEME));
+  const scheme = overrides ? { ...base, ...overrides } : { ...base };
+  if (id === void 0 || found !== void 0) return { scheme };
+  return { scheme, diagnostic: { code: "unresolved-font-scheme", path, id, fallback: DEFAULT_FONT_SCHEME, message: `Font scheme '${id}' is not in the inline or bundled catalogs; using the default font scheme '${DEFAULT_FONT_SCHEME}'.` } };
+}
 function resolveFontFamilies(input) {
   const scheme = record2(input);
   const family = (value) => typeof value === "string" ? value : record2(value).family;
   return {
-    heading: family(scheme.heading) ?? scheme.major ?? scheme.minor ?? "Roboto",
-    body: family(scheme.body) ?? scheme.minor ?? scheme.major ?? "Roboto",
-    code: family(scheme.code) ?? "Roboto Mono"
+    heading: family(scheme.heading) ?? scheme.major ?? scheme.minor ?? DEFAULT_FONT_FAMILIES.heading,
+    body: family(scheme.body) ?? scheme.minor ?? scheme.major ?? DEFAULT_FONT_FAMILIES.body,
+    code: family(scheme.code) ?? FALLBACK_CODE_FAMILY
   };
 }
 function resolveTextStyle(style, measurement) {
@@ -148,6 +337,106 @@ var columns = ["left", "center", "right"];
 var record2 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
 var kind = (field) => field === "items" ? "list" : field === "bullets" ? "text" : field;
 var round = (value) => Math.round(value * 1e6) / 1e6 || value;
+var SLIDE_IMAGE_POSITIONS = ["background", "top", "bottom", "left", "right"];
+var SLIDE_IMAGE_BAND = 0.5;
+var assetSource = (value) => typeof value === "string" ? value : record2(value).src;
+var finite = (value, min, max) => typeof value === "number" && Number.isFinite(value) && value >= min && value <= max ? value : void 0;
+var pathNumber = (value) => String(round(value));
+var SLIDE_IMAGE_SHAPES = { rectangle: "rect", rounded: "roundRect", circle: "ellipse", hexagon: "hexagon" };
+function slideImageShape(kind2, box, cornerRadius = 1 / 6) {
+  const { x, y, width: w, height: h } = box, r = x + w, b = y + h, ss = Math.min(w, h), n = pathNumber;
+  const rect = `M${n(x)} ${n(y)}H${n(r)}V${n(b)}H${n(x)}Z`;
+  if (kind2 === "rounded") {
+    const adj = Math.round(Math.min(0.5, Math.max(0, cornerRadius)) * 1e5), radius = ss * adj / 1e5;
+    const path = radius <= 0 ? rect : `M${n(x)} ${n(y + radius)}A${n(radius)} ${n(radius)} 0 0 1 ${n(x + radius)} ${n(y)}H${n(r - radius)}A${n(radius)} ${n(radius)} 0 0 1 ${n(r)} ${n(y + radius)}V${n(b - radius)}A${n(radius)} ${n(radius)} 0 0 1 ${n(r - radius)} ${n(b)}H${n(x + radius)}A${n(radius)} ${n(radius)} 0 0 1 ${n(x)} ${n(b - radius)}Z`;
+    return { kind: kind2, preset: "roundRect", adjust: { adj }, path };
+  }
+  if (kind2 === "circle") {
+    const cy = y + h / 2;
+    return { kind: kind2, preset: "ellipse", adjust: {}, path: `M${n(x)} ${n(cy)}A${n(w / 2)} ${n(h / 2)} 0 1 1 ${n(r)} ${n(cy)}A${n(w / 2)} ${n(h / 2)} 0 1 1 ${n(x)} ${n(cy)}Z` };
+  }
+  if (kind2 === "hexagon") {
+    const adj = 25e3, vf = 115470, a = Math.min(Math.max(adj, 0), 5e4 * w / ss);
+    const x1 = ss * a / 1e5, x2 = r - x1, vc = y + h / 2, dy1 = h / 2 * vf / 1e5 * Math.sin(Math.PI / 3);
+    return { kind: kind2, preset: "hexagon", adjust: { adj, vf }, path: `M${n(x)} ${n(vc)}L${n(x + x1)} ${n(vc - dy1)}L${n(x2)} ${n(vc - dy1)}L${n(r)} ${n(vc)}L${n(x2)} ${n(vc + dy1)}L${n(x + x1)} ${n(vc + dy1)}Z` };
+  }
+  return { kind: "rectangle", preset: "rect", adjust: {}, path: rect };
+}
+function resolveSlideImage(slide, layout, presentation, width, height, path, padding, scale, diagnostics) {
+  const own = record2(slide.design), deck = record2(record2(presentation).design);
+  const local = own.slideImage !== void 0;
+  const configured = local ? own.slideImage : deck.slideImage;
+  if (!configured || typeof configured !== "object" && typeof configured !== "string") return void 0;
+  const treatment = typeof configured === "object" && !Array.isArray(configured) && "position" in configured ? record2(configured) : void 0;
+  const alignment = typeof layout.slideImageAlignment === "string" ? layout.slideImageAlignment.toLowerCase() : void 0;
+  const position = treatment ? treatment.position : SLIDE_IMAGE_POSITIONS.find((value2) => value2 === alignment) ?? "background";
+  if (!SLIDE_IMAGE_POSITIONS.includes(position)) return void 0;
+  const designSource = treatment ? treatment.src : configured;
+  const root = slide.image, sameSource = root !== void 0 && designSource !== void 0 && assetSource(root) === assetSource(designSource);
+  if (!local && layout.slideImage !== true && !sameSource) return void 0;
+  const replacesContent = root !== void 0 && (designSource === void 0 || sameSource);
+  const value = replacesContent ? root : designSource;
+  const source = assetSource(value);
+  if (typeof source !== "string" || !source) return void 0;
+  const t = treatment ?? {};
+  const fill = t.fill === "crop" || t.fill === "fit" ? t.fill : (own.imageFill ?? deck.imageFill) === "fit" ? "fit" : "crop";
+  const share = finite(t.size, 0.1, 0.9) ?? SLIDE_IMAGE_BAND;
+  const band = { width: round(width * share), height: round(height * share) };
+  const region = position === "left" ? { x: 0, y: 0, width: band.width, height } : position === "right" ? { x: round(width - band.width), y: 0, width: band.width, height } : position === "top" ? { x: 0, y: 0, width, height: band.height } : position === "bottom" ? { x: 0, y: round(height - band.height), width, height: band.height } : { x: 0, y: 0, width, height };
+  const designPath = local ? `${path}.design.slideImage` : "design.slideImage";
+  const kind2 = Object.hasOwn(SLIDE_IMAGE_SHAPES, t.shape) ? t.shape : "rectangle";
+  let box = t.inset === true ? { x: region.x + padding, y: region.y + padding, width: Math.max(scale, region.width - 2 * padding), height: Math.max(scale, region.height - 2 * padding) } : { ...region };
+  const aspect = kind2 === "circle" ? 1 : finite(t.aspectRatio, Number.MIN_VALUE, 10);
+  if (aspect) {
+    const frameWidth = Math.min(box.width, box.height * aspect), frameHeight = frameWidth / aspect;
+    box = { x: box.x + (box.width - frameWidth) / 2, y: box.y + (box.height - frameHeight) / 2, width: frameWidth, height: frameHeight };
+  }
+  box = { x: round(box.x), y: round(box.y), width: round(box.width), height: round(box.height) };
+  const result = {
+    path: designPath,
+    sourcePath: replacesContent ? `${path}.image` : designPath,
+    value,
+    position,
+    fill,
+    region,
+    box,
+    replacesContent,
+    shape: slideImageShape(kind2, box, finite(t.cornerRadius, 0, 0.5))
+  };
+  if (typeof t.alt === "string") result.alt = t.alt;
+  const border = record2(t.border), borderWidth = finite(border.width, 0, 64);
+  if (border.color !== void 0 && borderWidth) result.border = { color: border.color, width: round(borderWidth * scale) };
+  const opacity = finite(t.opacity, 0, 1);
+  if (opacity !== void 0 && opacity < 1) result.opacity = opacity;
+  if (t.recolor === "grayscale") result.recolor = { type: "grayscale" };
+  else if (record2(t.recolor).dark !== void 0 && record2(t.recolor).light !== void 0) result.recolor = { type: "duotone", dark: t.recolor.dark, light: t.recolor.light };
+  const overlay = record2(t.overlay), overlayOpacity = finite(overlay.opacity, 0, 1);
+  if (overlay.color !== void 0 && overlayOpacity !== void 0) {
+    const edge = ["top", "bottom", "left", "right"].includes(overlay.edge) ? overlay.edge : void 0;
+    if (edge && kind2 !== "rectangle") diagnostics.push({ code: "unsupported-image-treatment", path: `${designPath}.overlay.edge`, message: "An edge overlay needs a rectangle frame; a band cannot follow a rounded, circular or hexagonal mask as one native shape. Remove edge or use shape rectangle." });
+    else {
+      const part = finite(overlay.size, 0.05, 1) ?? 0.3;
+      const bandBox = !edge ? box : edge === "top" ? { ...box, height: round(box.height * part) } : edge === "bottom" ? { ...box, y: round(box.y + box.height * (1 - part)), height: round(box.height * part) } : edge === "left" ? { ...box, width: round(box.width * part) } : { ...box, x: round(box.x + box.width * (1 - part)), width: round(box.width * part) };
+      result.overlay = { color: overlay.color, opacity: overlayOpacity, box: bandBox, shape: edge ? slideImageShape("rectangle", bandBox) : result.shape };
+    }
+  }
+  return result;
+}
+var webUrl = /^https?:\/\/\S+$/i;
+function resolveSocialProfile(platform, value, records = [], owner = "organization") {
+  const raw = String(value).trim().replace(/\s+/gu, " ");
+  const display = (url2) => url2.replace(/^https:\/\//i, "");
+  if (webUrl.test(raw)) return { text: display(raw), href: raw, resolved: false };
+  const platformRecord = records.find((item) => item?.id === platform);
+  const base = typeof platformRecord?.baseUrl === "string" && webUrl.test(platformRecord.baseUrl) ? `${platformRecord.baseUrl.replace(/\/+$/u, "")}/{handle}` : void 0;
+  const pattern = (owner === "organization" ? platformRecord?.companyUrlPattern : void 0) ?? platformRecord?.profileUrlPattern ?? base;
+  const prefix = platformRecord?.handlePrefix ?? "";
+  const handle = prefix && raw.startsWith(prefix) ? raw.slice(prefix.length) : raw;
+  if (!handle || typeof pattern !== "string" || !pattern.includes("{handle}")) return { text: raw, resolved: false };
+  const url = pattern.split("{handle}").join(handle);
+  if (!webUrl.test(url)) return { text: raw, resolved: false };
+  return { text: display(url), href: encodeURI(url), resolved: true };
+}
 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) };
@@ -156,10 +445,14 @@ function layoutFurniture(input, options = {}) {
   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 presentationSlides = options.presentation?.slides, slideCount = options.slideCount ?? (Array.isArray(presentationSlides) && presentationSlides.length ? presentationSlides.length : void 0);
+  if (slideCount !== void 0 && (!Number.isSafeInteger(slideCount) || slideCount < 1)) throw new RangeError("Displayed slide count must be a positive safe integer.");
+  if (options.date !== void 0 && (typeof options.date !== "string" || !parseIsoDate(options.date))) throw new RangeError("The furniture date option must be an ISO YYYY-MM-DD calendar date.");
   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 organization = record2(organizations[organizationIndex]), organizationRoot = Array.isArray(options.presentation?.organization) ? `organization.${organizationIndex}` : "organization", organizationPath = `${organizationRoot}.name`;
+  const inlinePlatforms = record2(record2(options.presentation?.catalogs).socialPlatforms).records, platformRecords = [...Array.isArray(inlinePlatforms) ? inlinePlatforms : [], ...options.socialPlatforms ?? []];
   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 });
@@ -173,7 +466,7 @@ function layoutFurniture(input, options = {}) {
     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) => {
+      const add = (field, text, generated = false, sourcePath, extras = {}) => {
         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);
@@ -203,7 +496,7 @@ function layoutFurniture(input, options = {}) {
         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 });
+        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, ...extras.fields?.length ? { fields: extras.fields } : {}, ...extras.links?.length ? { links: extras.links } : {} });
         if (accepted.overflow) error(partPath, "Repeated text exceeds its zone at the selected readability floor; change the furniture or slide design.");
         y += box.height;
       };
@@ -217,13 +510,37 @@ function layoutFurniture(input, options = {}) {
         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.socials === true) {
+        const links = Object.entries(record2(organization.socials)).filter(([, value2]) => typeof value2 === "string" && value2.trim()).map(([platform, value2]) => ({ platform, sourcePath: `${organizationRoot}.socials.${platform}`, ...resolveSocialProfile(platform, value2, platformRecords, "organization") }));
+        if (links.length) add("socials", links.map((link) => link.text).join("\n"), true, `${organizationRoot}.socials`, { links });
+        else error(`${path}.socials`, "Generated social profiles need a primary organization with socials.", "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);
+      for (const setting of ["slideNumberFormat", "dateFormat"]) if (content[setting] !== void 0 && typeof content[setting] !== "string") throw new TypeError(`Furniture setting ${path}.${setting} requires a string.`);
+      if (content.slideNumber === true) {
+        const resolved = formatSlideNumber(content.slideNumberFormat ?? DEFAULT_SLIDE_NUMBER_FORMAT, number, slideCount);
+        if ("error" in resolved) error(`${path}.slideNumberFormat`, resolved.error, "unresolved-content");
+        else add("slideNumber", resolved.text, true, void 0, { fields: resolved.fields });
+      }
+      if (content.date === true) {
+        const format = content.dateFormat ?? DEFAULT_FURNITURE_DATE_FORMAT;
+        if (options.date === void 0) error(`${path}.date`, "A current date needs a host-supplied ISO date option. For fixed content use a literal date, or an ISO date with dateFormat.", "unresolved-content");
+        else {
+          const resolved = formatFurnitureDate(options.date, format);
+          if ("error" in resolved) error(`${path}.dateFormat`, resolved.error, "unresolved-content");
+          else add("date", resolved.text, true, void 0, { fields: [{ type: "date", start: 0, end: resolved.text.length, format }] });
+        }
+      } else if (typeof content.date === "string") {
+        if (content.dateFormat === void 0) add("date", content.date);
+        else {
+          const resolved = formatFurnitureDate(content.date, content.dateFormat);
+          if ("error" in resolved) error(`${path}.${parseIsoDate(content.date) ? "dateFormat" : "date"}`, resolved.error, "unresolved-content");
+          else add("date", resolved.text, true, `${path}.date`);
+        }
+      }
       zones.push(zoneParts);
     }
     const tallest = Math.max(0, ...zones.map((zone) => zone.reduce((sum, part) => sum + part.box.height, 0)));
@@ -860,9 +1177,24 @@ function richTextLayouter(input, box, requestedSize, options) {
         const text = whole.slice(a, b), normalSize = (entry.run.fontSize !== void 0 ? entry.run.fontSize * 4 / 3 : requestedSize) * ratio;
         const script = entry.run.superscript || entry.run.subscript;
         const size = normalSize * (script ? 0.7 : 1), baselineShift = entry.run.superscript ? -normalSize * 0.35 : entry.run.subscript ? normalSize * 0.2 : 0;
-        const width2 = textWidthMeasurer(entry.style, options.textMeasurement)(text, size);
-        result.push({ text, runIndex: entry.runIndex, start: a - entry.start, end: b - entry.start, x, width: width2, fontSize: size, baselineShift, style: entry.style, run: entry.run });
-        x += width2;
+        const measure = textWidthMeasurer(entry.style, options.textMeasurement);
+        let cursor = 0;
+        for (const [index, segment] of text.split("	").entries()) {
+          if (index) {
+            const tabStart = a + cursor, tabWidth = measure(" ", size) * 4;
+            if (!Number.isFinite(tabWidth) || tabWidth <= 0) throw new RangeError("Rich text tabs require a positive finite measured space advance.");
+            const next = (Math.floor(x / tabWidth + 1e-9) + 1) * tabWidth;
+            result.push({ kind: "tab", text: "	", runIndex: entry.runIndex, start: tabStart - entry.start, end: tabStart - entry.start + 1, x, width: next - x, fontSize: size, baselineShift, style: entry.style, run: entry.run });
+            x = next;
+            cursor++;
+          }
+          if (segment) {
+            const width2 = measure(segment, size), segmentStart = a + cursor;
+            result.push({ text: segment, runIndex: entry.runIndex, start: segmentStart - entry.start, end: segmentStart - entry.start + segment.length, x, width: width2, fontSize: size, baselineShift, style: entry.style, run: entry.run });
+            x += width2;
+            cursor += segment.length;
+          }
+        }
       }
       return result;
     };
@@ -1117,6 +1449,7 @@ function composeSlide(input, options = {}) {
   const minSize = (composition.minFontSize ?? 16) * scale;
   const rasterPadding = (options.textRasterPadding ?? 1) * scale;
   if (!Number.isFinite(rasterPadding) || rasterPadding < 0) throw new RangeError("Text raster padding must be finite and nonnegative.");
+  const alignmentFor = (field) => (field === "title" ? record2(slide.design).titleAlignment ?? options.titleAlignment : record2(slide.design).contentAlignment ?? options.contentAlignment) ?? "left";
   const styleFor = (field, path2) => resolveTextStyle({
     fontFamily: (field === "title" ? options.fonts?.heading : field === "code" ? options.fonts?.code : options.fonts?.body) ?? (field === "code" ? "monospace" : "sans-serif"),
     fontWeight: field === "title" ? 700 : 400,
@@ -1126,7 +1459,7 @@ function composeSlide(input, options = {}) {
   const fitPlacedText = (field, value, text, box, size, minimum, path2) => {
     const style = styleFor(field, path2), rich = field === "text" && Array.isArray(value);
     if (!options.textMeasurement?.outlineBounds) return rich ? fitRichText(value, box, size, minimum, { style, textMeasurement: options.textMeasurement }) : fitText(text, box, size, minimum, textWidthMeasurer(style, options.textMeasurement));
-    const alignment = (field === "title" ? record2(slide.design).titleAlignment ?? options.titleAlignment : record2(slide.design).contentAlignment ?? options.contentAlignment) ?? "left";
+    const alignment = alignmentFor(field);
     const richLayout = rich ? richTextLayouter(value, box, size, { style, textMeasurement: options.textMeasurement }) : void 0;
     const measure = textWidthMeasurer(style, options.textMeasurement), floor = rich ? richMinimum(value, size, minimum) : minimum, start = Math.max(size, floor);
     for (let trial = 0; trial <= 64; trial++) {
@@ -1136,6 +1469,7 @@ function composeSlide(input, options = {}) {
       const lines = richLines ? richLines.map((line) => {
         let outline = null;
         for (const fragment of line.fragments) {
+          if (fragment.kind === "tab") continue;
           const bounds = measureTextOutline(fragment.text, fragment.fontSize, fragment.style, options.textMeasurement);
           if (!bounds) continue;
           const next = { ...bounds, x: fragment.x + bounds.x, y: fragment.baselineShift + bounds.y };
@@ -1174,25 +1508,32 @@ 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 slideImageDiagnostics = [];
+  const slideImage = resolveSlideImage(slide, layout, options.presentation, width, height, path, padding, scale, slideImageDiagnostics);
+  const area = { left: 0, top: 0, right: width, bottom: height };
+  if (slideImage?.position === "left") area.left = slideImage.region.width;
+  else if (slideImage?.position === "right") area.right = slideImage.region.x;
+  else if (slideImage?.position === "top") area.top = slideImage.region.height;
+  else if (slideImage?.position === "bottom") area.bottom = slideImage.region.y;
   const items = [], diagnostics = [];
   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);
+  const bodyBottom = Math.min(area.bottom - padding, furniture && furniture.footerTop < height ? furniture.footerTop - gap * 0.5 : height - padding);
+  let y = Math.max(area.top + 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;
     const maxHeight = Math.max(height * (field === "title" ? 0.26 : field === "subtitle" ? 0.12 : 0.045), minSize * 1.22 + 2 * rasterPadding);
-    const box = { x: padding, y, width: width - padding * 2, height: maxHeight };
+    const box = { x: area.left + padding, y, width: area.right - area.left - 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 });
+    items.push({ path: `${path}.${field}`, field, type: "text", value: slide[field], payload: { text: slide[field] }, box, text, textStyle: styleFor(field, `${path}.${field}`), composition, alignment: alignmentFor(field) });
     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, bodyBottom - y) };
+  const contentBox = { x: area.left + padding, y, width: area.right - area.left - 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.`);
@@ -1211,7 +1552,7 @@ function composeSlide(input, options = {}) {
     return fields.filter((field) => host[field] !== void 0).map((field) => ({ field, type: host.type ?? kind(field), value: host[field], path: `${basePath}.${field}`, payload: { type: host.type ?? kind(field), [field]: host[field] } }));
   };
   const regions = Object.keys(slide).filter((key) => regionParts(key)).sort();
-  const pending = regions.length ? regions.flatMap((key) => collect(record2(slide[key]), `${path}.${key}`).map((item) => ({ ...item, region: regionParts(key) }))) : Array.isArray(slide.blocks) ? slide.blocks.flatMap((block, index) => collect(record2(block), `${path}.blocks.${index}`)) : collect(slide, path);
+  const pending = regions.length ? regions.flatMap((key) => collect(record2(slide[key]), `${path}.${key}`).map((item) => ({ ...item, region: regionParts(key) }))) : Array.isArray(slide.blocks) ? slide.blocks.flatMap((block, index) => collect(record2(block), `${path}.blocks.${index}`)) : collect(slideImage?.replacesContent ? { ...slide, image: void 0 } : slide, path);
   const groups = [], flows = [];
   const decisions = options.explain ? [] : void 0;
   const inheritedSettings = (parent, own = {}) => ({
@@ -1250,7 +1591,7 @@ function composeSlide(input, options = {}) {
     minFontSize: settings.minFontSize,
     path: node.path,
     textRasterPadding: options.textRasterPadding,
-    align: record2(slide.design).contentAlignment ?? options.contentAlignment
+    align: alignmentFor("metric")
   });
   const measureTimeline = (node, box, settings) => layoutTimeline(node.value, acceptedBox(box), {
     fonts: options.fonts,
@@ -1293,29 +1634,29 @@ function composeSlide(input, options = {}) {
     return score;
   };
   const modeFor = (settings) => settings.mode ?? "auto";
-  const defaultColumns = (count, area, settings) => {
+  const defaultColumns = (count, area2, settings) => {
     const mode = modeFor(settings);
-    return mode === "column" ? 1 : mode === "row" ? Math.max(1, count) : settings.columns ?? Math.max(1, Math.min(count, Math.ceil(Math.sqrt(count * area.width / area.height / 1.6))));
+    return mode === "column" ? 1 : mode === "row" ? Math.max(1, count) : settings.columns ?? Math.max(1, Math.min(count, Math.ceil(Math.sqrt(count * area2.width / area2.height / 1.6))));
   };
   const scoreNode = (node, box, settings, penalties) => {
     if (!node.children) return leafScore(node, box, settings, penalties);
-    const own = inheritedSettings(settings, node.composition), area = inset(box, own);
-    const cols = defaultColumns(node.children.length, area, own);
-    const boxes = gridBoxes(node.children.length, area, cols, (own.gap ?? 1 / 30) * Math.min(box.width, box.height), own.weights ?? [], modeFor(own) === "column");
+    const own = inheritedSettings(settings, node.composition), area2 = inset(box, own);
+    const cols = defaultColumns(node.children.length, area2, own);
+    const boxes = gridBoxes(node.children.length, area2, cols, (own.gap ?? 1 / 30) * Math.min(box.width, box.height), own.weights ?? [], modeFor(own) === "column");
     return node.children.reduce((score, child, index) => score + scoreNode(child, boxes[index], own, penalties), 0);
   };
-  const arrange = (nodes, area, settings, reserved = 0, gapOverride, containerPath = path) => {
+  const arrange = (nodes, area2, settings, reserved = 0, gapOverride, containerPath = path) => {
     const count = Math.max(nodes.length, reserved);
     if (!count) return;
-    const mode = modeFor(settings), localGap = (settings.gap ?? 1 / 30) * Math.min(area.width, area.height);
+    const mode = modeFor(settings), localGap = (settings.gap ?? 1 / 30) * Math.min(area2.width, area2.height);
     const actualGap = gapOverride ?? (settings === rootSettings ? gap : localGap);
-    let cols = defaultColumns(count, area, settings);
+    let cols = defaultColumns(count, area2, settings);
     const hasRegions = nodes.some((node) => node.region);
     const candidates = decisions ? [] : void 0;
     if (mode === "auto" && !hasRegions) {
       let best = Infinity;
       for (let candidate = 1; candidate <= Math.min(count, settings.columns ?? 6); candidate++) {
-        const boxes2 = gridBoxes(count, area, candidate, actualGap, settings.weights ?? [], false);
+        const boxes2 = gridBoxes(count, area2, candidate, actualGap, settings.weights ?? [], false);
         const emptySlots = (Math.ceil(count / candidate) * candidate - count) * 2;
         const penalties = candidates ? { cellProportions: 0, fontReduction: 0, textOverflow: 0, tableOverflow: 0, smallCells: 0, emptySlots } : void 0;
         const score = nodes.reduce((sum, node, i) => sum + scoreNode(node, boxes2[i], settings, penalties), 0) + emptySlots;
@@ -1333,11 +1674,11 @@ function composeSlide(input, options = {}) {
       ...hasRegions ? {} : { selectedColumns: cols },
       candidates: candidates ?? []
     });
-    const grid = gridGeometry(count, area, cols, actualGap, settings.weights ?? [], mode === "column");
+    const grid = gridGeometry(count, area2, cols, actualGap, settings.weights ?? [], mode === "column");
     const boxes = grid.boxes;
-    if (!nodes.some((node) => node.region)) flows.push({ path: containerPath, box: { ...area }, composition: { ...settings }, columns: grid.columns, rows: grid.rows, gap: grid.gap, itemCount: nodes.length, slotCount: count });
+    if (!nodes.some((node) => node.region)) flows.push({ path: containerPath, box: { ...area2 }, composition: { ...settings }, columns: grid.columns, rows: grid.rows, gap: grid.gap, itemCount: nodes.length, slotCount: count });
     nodes.forEach((node, index) => {
-      let box = node.region ? regionBox(node.region, area, actualGap) : boxes[index];
+      let box = node.region ? regionBox(node.region, area2, actualGap) : boxes[index];
       if (node.children) {
         const own = inheritedSettings(settings, node.composition), inner = inset(box, own);
         groups.push({ path: node.path, box, contentBox: inner, composition: own });
@@ -1363,6 +1704,7 @@ function composeSlide(input, options = {}) {
           text,
           textStyle: body?.style ?? styleFor(node.field, node.path),
           composition: settings,
+          alignment: alignmentFor(node.field),
           ...quoteLayout ? { quoteLayout } : {},
           ...codeLayout ? { codeLayout } : {},
           ...metricLayout ? { metricLayout } : {},
@@ -1373,6 +1715,10 @@ function composeSlide(input, options = {}) {
     });
   };
   const placeholders = Array.isArray(layout.placeholders) ? layout.placeholders.filter((p) => !headings.has(p.type)) : [];
+  if (slideImage?.replacesContent) {
+    const picture = placeholders.findIndex((p) => p.type === "picture");
+    if (picture >= 0) placeholders.splice(picture, 1);
+  }
   const rootSettings = { ...composition, mode: composition.mode ?? (layout.slideLayoutDirection === "Vertical" ? "column" : layout.slideLayoutDirection === "Horizontal" ? "row" : "auto") };
   arrange(pending, contentBox, rootSettings, composition.mode ? 0 : placeholders.length);
   for (const item of items) {
@@ -1406,7 +1752,8 @@ 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, ...furniture ? { furniture } : {}, ...explanation ? { explanation } : {} };
+  diagnostics.push(...slideImageDiagnostics);
+  return { width, height, contentBox, items, groups, flows, diagnostics, composition, ...furniture ? { furniture } : {}, ...slideImage ? { slideImage } : {}, ...explanation ? { explanation } : {} };
 }
 function resolveCanvasDimensions(input) {
   const presets = {
@@ -1426,4 +1773,4 @@ function resolveCanvasDimensions(input) {
   return { width, height };
 }
 
-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 };
+export { DEFAULT_FONT_SCHEME, DEFAULT_FURNITURE_DATE_FORMAT, DEFAULT_SLIDE_NUMBER_FORMAT, MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, formatFurnitureDate, formatSlideNumber, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, normalizeHexColor, placeTextLines, resolveCanvasDimensions, resolveColorRef, resolveFontFamilies, resolveFontSchemeReference, resolveSocialProfile, resolveTextStyle, slideImageShape, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText };