@openpresentation/opf 0.11.1 → 0.11.2

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

@@ -319,6 +319,21 @@ function placeTextLines(lines, box, alignment = "left", rasterPadding = 0) {
   }
   return { alignment, rasterPadding, lines: placed, height, overflow };
 }
+function translateTextFit(fit, dy) {
+  if (!dy || !fit.placement) return fit;
+  return {
+    ...fit,
+    placement: {
+      ...fit.placement,
+      lines: fit.placement.lines.map((line) => ({
+        ...line,
+        y: line.y + dy,
+        baseline: line.baseline + dy,
+        outline: line.outline ? { ...line.outline, y: line.outline.y + dy } : line.outline
+      }))
+    }
+  };
+}
 var OPFCompositionError = class extends Error {
   constructor(diagnostics, explanation) {
     super("Slide content does not fit its composition.");
@@ -332,6 +347,7 @@ var OPFCompositionError = class extends Error {
 };
 var fields = ["text", "items", "bullets", "image", "video", "chart", "table", "code", "metric", "quote", "timeline"];
 var headings = /* @__PURE__ */ new Set(["title", "subtitle", "tag"]);
+var COVER_LAYOUT_IDS = /* @__PURE__ */ new Set(["title", "title-subtitle"]);
 var rows = ["top", "middle", "bottom"];
 var columns = ["left", "center", "right"];
 var record2 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
@@ -1520,7 +1536,16 @@ function composeSlide(input, options = {}) {
   const furniture = measuredFurniture.configured || measuredFurniture.diagnostics.length ? measuredFurniture : void 0;
   if (furniture) diagnostics.push(...furniture.diagnostics);
   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);
+  const headingTop = Math.max(area.top + padding, furniture?.headerBottom ? furniture.headerBottom + gap * 0.5 : padding);
+  const layoutPlaceholders = Array.isArray(layout.placeholders) ? layout.placeholders : [];
+  const headingOnlyLayout = COVER_LAYOUT_IDS.has(String(layout.id ?? "")) || layoutPlaceholders.length > 0 && layoutPlaceholders.every((placeholder) => headings.has(placeholder.type ?? ""));
+  const regions = Object.keys(slide).filter((key) => regionParts(key)).sort();
+  const emptyPayload = (value) => value === void 0 || value === null || value === "" || Array.isArray(value) && value.length === 0;
+  const emptyHost = (host) => emptyPayload(host.blocks) && fields.every((field) => emptyPayload(host[field]));
+  const hasBodyPayload = regions.some((key) => !emptyHost(record2(slide[key]))) || !emptyPayload(slide.blocks) || fields.some((field) => !emptyPayload(slide[field]));
+  const isCover = !hasBodyPayload && (headingOnlyLayout || !layout.id && !layoutPlaceholders.some((placeholder) => !headings.has(placeholder.type ?? "")));
+  let y = headingTop;
+  const headingItems = [];
   for (const field of ["tag", "title", "subtitle"]) {
     if (!slide[field]) continue;
     const requested = (field === "title" ? 54 : field === "tag" ? 16 : 25) * scale;
@@ -1529,10 +1554,22 @@ function composeSlide(input, options = {}) {
     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, alignment: alignmentFor(field) });
+    const item = { path: `${path}.${field}`, field, type: "text", value: slide[field], payload: { text: slide[field] }, box, text, textStyle: styleFor(field, `${path}.${field}`), composition, alignment: alignmentFor(field) };
+    headingItems.push(item);
+    items.push(item);
     y += box.height + gap * 0.5;
   }
-  if (items.length) y += gap * 0.5;
+  if (headingItems.length) {
+    if (isCover) {
+      const last = headingItems[headingItems.length - 1];
+      const shift = Math.max(0, (bodyBottom - (last.box.y + last.box.height)) / 2);
+      if (shift) for (const item of headingItems) {
+        item.box.y += shift;
+        if (item.text) item.text = translateTextFit(item.text, shift);
+      }
+      y = last.box.y + last.box.height + gap;
+    } else y += gap * 0.5;
+  }
   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)) {
@@ -1551,7 +1588,6 @@ 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(slideImage?.replacesContent ? { ...slide, image: void 0 } : slide, path);
   const groups = [], flows = [];
   const decisions = options.explain ? [] : void 0;

package/dist/{chunk-M4GTWRK7.js → chunk-DJRZMGKY.js}

@@ -1,4 +1,4 @@
-import { MAX_COMPOSITION_DEPTH, tableGrid } from './chunk-6UPHKXI5.js';
+import { MAX_COMPOSITION_DEPTH, tableGrid } from './chunk-BVLWFMDX.js';
 import { schemas, schemaEntries } from './chunk-LTSDDBNW.js';
 import { catalogSchemaNames } from './chunk-7LF37SG3.js';
 import Ajv2020 from 'ajv/dist/2020.js';

package/dist/{chunk-BP6WMSSS.js → chunk-K7IWYODS.js}

@@ -1,4 +1,4 @@
-import { validatePresentation, validationDefinition, validateCatalogRecord } from './chunk-M4GTWRK7.js';
+import { validatePresentation, validationDefinition, validateCatalogRecord } from './chunk-DJRZMGKY.js';
 import { schemas, schemaEntries } from './chunk-LTSDDBNW.js';
 import { catalogKinds, catalogEntries, catalogSchemaNames } from './chunk-7LF37SG3.js';
 import { parseTree, printParseErrorCode, getNodePath } from 'jsonc-parser';

package/dist/{chunk-NPYN4TZ5.js → chunk-KZ6BT5UG.js}

@@ -6,9 +6,9 @@ var fontPolicySource = {
     "note": "Owner decisions resolved provisionally with the recommended defaults. Changing a decision here is the whole edit: every row whose replacement names this decision takes its family and compatibility from it. A recorded measurement for a different family is ignored (treated as unmeasured) until scripts/measure-font-replacements.mjs is re-run.",
     "decisions": {
       "aptos-preview": {
-        "replacement": "Roboto",
-        "compatibility": "visual",
-        "note": "Default scheme aptos previews with Roboto; the PPTX still names Aptos."
+        "replacement": "Intos",
+        "compatibility": "metric",
+        "note": "Owner policy 2026-09-29: a licensed font the user selects previews with an open replacement that looks similar and has the same size on screen; the PPTX keeps the selected name. Aptos previews with Intos (metric, OFL-1.1, vendored in opf-render); Roboto and Carlito are alternates for registries built without the Intos faces (they are in the opf-render office pack)."
       },
       "segoe-ui-preview": {
         "replacement": "Red Hat Display",
@@ -26,7 +26,7 @@ var fontPolicySource = {
   "description": "OPF font policy (font-fidelity-everywhere FF-31). One row per font family that OPF catalogs, defaults or renderer rules name. Renderers preview a proprietary family with its openly licensed replacement for measurement and drawing only. Exporters always write the chosen family, never write a replacement, and never embed a proprietary family. Open families may be bundled for rendering and reach a PPTX only through an explicit embed path. See docs/font-fidelity.md.",
   "version": 1,
   "measurement": {
-    "tool": "fontkit 2.0.4 shaping with default features (kerning, ligatures), as opf-render measures text",
+    "tool": "fontkit 2.0.4 shaping with default features (kerning, ligatures), as opf-render measures text; a replacement that lists disabledFeatures (Georgia -> Gelasio) is shaped with those features off",
     "corpus": "300 Latin title/body strings sampled from the 126 bundled example decks",
     "evidence": "docs/evidence/font-replacements-20260923/README.md",
     "definition": "For each style both fonts have (regular, bold, italic, bold italic, or the weight the family name encodes), the shaped advance width of every corpus string in the replacement is divided by the width in the real font. meanAbsWidthDelta averages |ratio - 1| over strings and styles; meanWidthDelta averages the signed value; maxAbsWidthDelta is the largest single-string |ratio - 1|. Reference fonts were read in place from a licensed Windows 11 + Microsoft 365 host and never copied."
@@ -107,16 +107,18 @@ var fontPolicySource = {
       "embeddableByOpf": false,
       "replacement": {
         "decision": "aptos-preview",
+        "source": "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
         "measured": {
-          "replacement": "Roboto",
-          "meanAbsWidthDelta": 0.0215,
-          "meanWidthDelta": 8e-4,
-          "maxAbsWidthDelta": 0.0739,
+          "replacement": "Intos",
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
           "styles": 4,
           "reference": "Aptos 2.01;O365"
         }
       },
       "alternates": [
+        "Roboto",
         "Carlito"
       ],
       "sources": [
@@ -127,7 +129,7 @@ var fontPolicySource = {
         "https://microsoft.design/articles/a-change-of-typeface-microsoft-s-new-default-font-has-arrived/",
         "https://www.microsoft.com/en-us/download/details.aspx?id=106087"
       ],
-      "note": "Microsoft 365 cloud font; not redistributable. Roboto is the closest measured open face with all four styles already in the base pack. Carlito (the previous substitute) measured 7.1% narrower. Not in the Windows 10/11 font lists; delivered as a Microsoft 365 cloud font. Microsoft also offers a standalone download (Download Center id=106087) under Microsoft terms, not an open license."
+      "note": "Microsoft 365 cloud font; not redistributable. Intos is metric-compatible (OFL, Inter-derived outlines with Aptos advances, kerning and vertical metrics) and previews it in the default opf-render office pack; Roboto and Carlito are the visual fallbacks for registries built without the Intos faces. Not in the Windows 10/11 font lists; delivered as a Microsoft 365 cloud font. Microsoft also offers a standalone download (Download Center id=106087) under Microsoft terms, not an open license."
     },
     {
       "family": "Aptos Display",
@@ -138,18 +140,20 @@ var fontPolicySource = {
       ],
       "embeddableByOpf": false,
       "replacement": {
-        "family": "Carlito",
-        "compatibility": "visual",
+        "family": "Intos Display",
+        "compatibility": "metric",
+        "source": "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
         "measured": {
-          "replacement": "Carlito",
-          "meanAbsWidthDelta": 0.0184,
-          "meanWidthDelta": -57e-4,
-          "maxAbsWidthDelta": 0.0691,
+          "replacement": "Intos Display",
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
           "styles": 4,
           "reference": "Aptos Display 2.01;O365"
         }
       },
       "alternates": [
+        "Carlito",
         "Roboto"
       ],
       "sources": [
@@ -159,7 +163,7 @@ var fontPolicySource = {
         "https://support.apple.com/en-us/122869",
         "https://microsoft.design/articles/a-change-of-typeface-microsoft-s-new-default-font-has-arrived/"
       ],
-      "note": "Part of the Aptos family; cloud font list has Aptos Display (+Bold/Italic/Bold Italic)."
+      "note": "Part of the Aptos family; cloud font list has Aptos Display (+Bold/Italic/Bold Italic). Intos Display is its metric-compatible preview replacement."
     },
     {
       "family": "Aptos Mono",
@@ -195,13 +199,14 @@ var fontPolicySource = {
       ],
       "embeddableByOpf": false,
       "replacement": {
-        "family": "Carlito",
-        "compatibility": "visual",
+        "family": "Intos Narrow",
+        "compatibility": "metric",
+        "source": "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
         "measured": {
-          "replacement": "Carlito",
-          "meanAbsWidthDelta": 0.0233,
-          "meanWidthDelta": 0.0222,
-          "maxAbsWidthDelta": 0.0786,
+          "replacement": "Intos Narrow",
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
           "styles": 4,
           "reference": "Aptos Narrow 2.01;O365"
         }
@@ -213,7 +218,10 @@ var fontPolicySource = {
         "https://support.apple.com/en-us/122869",
         "https://microsoft.design/articles/a-change-of-typeface-microsoft-s-new-default-font-has-arrived/"
       ],
-      "note": "Part of the Aptos family; cloud font list has Aptos Narrow (+Bold/Italic/Bold Italic)."
+      "note": "Part of the Aptos family; cloud font list has Aptos Narrow (+Bold/Italic/Bold Italic). Intos Narrow is its metric-compatible preview replacement.",
+      "alternates": [
+        "Carlito"
+      ]
     },
     {
       "family": "Aptos Serif",
@@ -224,9 +232,17 @@ var fontPolicySource = {
       ],
       "embeddableByOpf": false,
       "replacement": {
-        "family": "Tinos",
-        "compatibility": "visual",
-        "measured": null
+        "family": "Intos Serif",
+        "compatibility": "metric",
+        "source": "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "measured": {
+          "replacement": "Intos Serif",
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
+          "styles": 4,
+          "reference": "Aptos Serif 2.01;240513210638;O365"
+        }
       },
       "sources": [
         "https://learn.microsoft.com/en-us/typography/fonts/windows_11_font_list",
@@ -234,7 +250,10 @@ var fontPolicySource = {
         "https://learn.microsoft.com/en-us/typography/font-list/aptos",
         "https://support.apple.com/en-us/122869"
       ],
-      "note": "Reference not available to the measuring host. Aptos family member; cloud list has Aptos Serif, Bold, Italic and Bold Italic."
+      "note": "Part of the Aptos family; cloud list has Aptos Serif, Bold, Italic and Bold Italic. Intos Serif (Gelasio-derived outlines, Aptos Serif metrics) is its metric-compatible preview replacement. Not installed on the measuring host: measured from the files in Microsoft's Aptos Fonts download (Download Center id=106087).",
+      "alternates": [
+        "Tinos"
+      ]
     },
     {
       "family": "Arabic Typesetting",
@@ -1302,12 +1321,16 @@ var fontPolicySource = {
       "embeddableByOpf": false,
       "replacement": {
         "family": "Gelasio",
-        "compatibility": "visual",
+        "compatibility": "metric",
+        "disabledFeatures": [
+          "liga",
+          "clig"
+        ],
         "measured": {
           "replacement": "Gelasio",
-          "meanAbsWidthDelta": 2e-4,
-          "meanWidthDelta": -2e-4,
-          "maxAbsWidthDelta": 0.0102,
+          "meanAbsWidthDelta": 0,
+          "meanWidthDelta": 0,
+          "maxAbsWidthDelta": 0,
           "styles": 4,
           "reference": "Georgia 5.59"
         },
@@ -1320,7 +1343,7 @@ var fontPolicySource = {
         "https://learn.microsoft.com/en-us/typography/font-list/georgia",
         "https://support.apple.com/en-us/122869"
       ],
-      "note": "Gelasio is designed to Georgia metrics and every basic-Latin advance matches Georgia 5.59, but opf-render shapes with default features, and runs where Gelasio applies optional ligatures differ by up to 1.02%. OPF classes it as visual."
+      "note": "Gelasio is designed to Georgia metrics and every basic-Latin advance matches Georgia 5.59. With default features Gelasio applies fi/fl/ffi/ffl ligatures that Georgia does not, which changes runs by up to 1.02%. Renderers therefore turn liga and clig off in Gelasio (disabledFeatures); the measurement below shapes Gelasio that way. Georgia has no liga or clig feature, so its default shaping is unchanged. The metric claim holds only with those features off."
     },
     {
       "family": "Gill Sans MT",
@@ -1503,6 +1526,58 @@ var fontPolicySource = {
         "https://support.apple.com/en-us/122869"
       ]
     },
+    {
+      "family": "Intos",
+      "licenseClass": "open",
+      "license": "OFL-1.1",
+      "availability": [],
+      "embeddableByOpf": true,
+      "replacement": null,
+      "sources": [
+        "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "https://github.com/muglug/intos/blob/fef9315c14da9e4b23b4c3cac8e718998d4e4736/LICENSE.txt"
+      ],
+      "note": "Metric-compatible with Aptos (Aptos advance widths, kerning and vertical metrics on Inter-derived outlines). Vendored in opf-render at the pinned commit; single-maintainer project created September 2026, so Roboto and Carlito stay as fallbacks."
+    },
+    {
+      "family": "Intos Display",
+      "licenseClass": "open",
+      "license": "OFL-1.1",
+      "availability": [],
+      "embeddableByOpf": true,
+      "replacement": null,
+      "sources": [
+        "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "https://github.com/muglug/intos/blob/fef9315c14da9e4b23b4c3cac8e718998d4e4736/LICENSE.txt"
+      ],
+      "note": "Metric-compatible with Aptos Display (Aptos advance widths, kerning and vertical metrics on Inter-derived outlines). Vendored in opf-render at the pinned commit; single-maintainer project created September 2026, so Roboto and Carlito stay as fallbacks."
+    },
+    {
+      "family": "Intos Narrow",
+      "licenseClass": "open",
+      "license": "OFL-1.1",
+      "availability": [],
+      "embeddableByOpf": true,
+      "replacement": null,
+      "sources": [
+        "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "https://github.com/muglug/intos/blob/fef9315c14da9e4b23b4c3cac8e718998d4e4736/LICENSE.txt"
+      ],
+      "note": "Metric-compatible with Aptos Narrow (Aptos advance widths, kerning and vertical metrics on Inter-derived outlines). Vendored in opf-render at the pinned commit; single-maintainer project created September 2026, so Roboto and Carlito stay as fallbacks."
+    },
+    {
+      "family": "Intos Serif",
+      "licenseClass": "open",
+      "license": "OFL-1.1",
+      "availability": [],
+      "embeddableByOpf": true,
+      "replacement": null,
+      "sources": [
+        "https://github.com/muglug/intos/tree/fef9315c14da9e4b23b4c3cac8e718998d4e4736",
+        "https://github.com/muglug/intos/blob/fef9315c14da9e4b23b4c3cac8e718998d4e4736/LICENSE.txt"
+      ],
+      "note": "Metric-compatible with Aptos Serif (Aptos Serif advance widths, kerning and vertical metrics on Gelasio-derived outlines). Vendored in opf-render at the pinned commit; Tinos stays as the visual fallback."
+    },
     {
       "family": "Kalinga",
       "licenseClass": "proprietary-standard",
@@ -2722,7 +2797,7 @@ var fontPolicySource = {
         "https://learn.microsoft.com/en-us/typography/font-list/segoe-ui",
         "https://support.apple.com/en-us/122869"
       ],
-      "note": "Microsoft's OFL Selawik is the documented Segoe UI fallback but is not published as a pinned package; Red Hat Display is the closest measured shipped face. MS Learn lists vendor as Agfa Monotype but copyright Microsoft."
+      "note": "Microsoft's OFL Selawik 1.01 was measured and rejected as a metric replacement: 0.16% mean and 2.5% maximum in regular, no italic faces (2.65% mean), and Semibold is 1.75% off. Red Hat Display remains the closest shipped face with all four styles; see docs/programs/font-fidelity-everywhere/font-licensing.md."
     },
     {
       "family": "Segoe UI Emoji",

package/dist/{chunk-KWIOQ3QR.js → chunk-SMYEM3HV.js}

@@ -1,5 +1,5 @@
-import { assertValidPresentation, visitContentPayloads } from './chunk-M4GTWRK7.js';
-import { DEFAULT_FONT_SCHEME, resolveFontSchemeReference, resolveFontFamilies, resolveCanvasDimensions, composeSlide, tableRowBoundaries } from './chunk-6UPHKXI5.js';
+import { assertValidPresentation, visitContentPayloads } from './chunk-DJRZMGKY.js';
+import { DEFAULT_FONT_SCHEME, resolveFontSchemeReference, resolveFontFamilies, resolveCanvasDimensions, composeSlide, tableRowBoundaries } from './chunk-BVLWFMDX.js';
 import { catalogs } from './chunk-7LF37SG3.js';
 
 // src/pagination.ts

package/dist/composition.js

@@ -1 +1 @@
-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, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveFontSchemeReference, resolveSocialProfile, resolveTextStyle, slideImageShape, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText } from './chunk-6UPHKXI5.js';
+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, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveFontSchemeReference, resolveSocialProfile, resolveTextStyle, slideImageShape, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText } from './chunk-BVLWFMDX.js';