@openpresentation/opf 0.18.4 → 0.20.1

package/README.md

@@ -30,7 +30,7 @@ Use the common root API for most application code:
 
 ```ts
 import { presentation, validate, embed } from "@openpresentation/opf";
-import { defaultCatalog } from "@openpresentation/opf/catalog";
+import { gallery } from "@openpresentation/gallery";
 
 import type { Presentation } from "@openpresentation/opf";
 
@@ -40,13 +40,14 @@ const deck: Presentation = {
 };
 
 console.log(presentation.$id);
-// Register the catalogs your host trusts; core itself ships no records in its main entry.
-const catalogs = [defaultCatalog];
+// Register the catalogs your host trusts; core ships no records. In Node, validate, stats, paginate, embed and edit
+// register the gallery (@openpresentation/gallery, a dependency of core) when a call names none.
+const catalogs = [gallery];
 console.log(validate({ ...deck, design: { theme: "classic" } }, { catalogs }).valid);
 // Save with every record the deck uses embedded, so it renders the same with no catalog registered.
 const saved = embed({ ...deck, design: { theme: "classic" } }, { catalogs }).document;
 console.log(Object.keys(saved.catalogs.default.themes)); // ["classic"]
-console.log(Object.keys(defaultCatalog.tones));
+console.log(Object.keys(gallery.tones));
 ```
 
 In Node (and Bun and Deno), the root adds files: `convert` turns one file into another (a deck to PDF, PNG, SVG or PPTX, a PowerPoint file to a deck, one deck form to another, or bytes with no output path), `open` reads a deck file or imports a `.pptx`, and `save` writes one. The same import works in every runtime, so one namespace import covers an application:
@@ -67,13 +68,12 @@ Use focused imports when you only need one surface:
 
 ```ts
 import { presentation, audience } from "@openpresentation/opf/schemas";
-import { defaultCatalog, catalogDisplay, layoutPreviews, getLayoutPreview, hasLayoutPreview } from "@openpresentation/opf/catalog";
 import { specFileEntries } from "@openpresentation/opf/spec-files";
 import { validate, assertValid, validationRules } from "@openpresentation/opf/validator";
 import type { Presentation, Audience, Tone } from "@openpresentation/opf/types";
 ```
 
-The root entry holds the application-level API: schemas, catalog references and their resolution (`resolveReference`, `embed`, `copySlides`, `updateFromCatalog`), validation, variables, pagination, data helpers, font policy, `stats`, `resolveSlideContext` and `resolveSlideVariables`. Engines compose and draw `context.slide` from `resolveSlideContext(deck, index, { slideNumber, slideCount })`: the slide with the slide-scoped built-ins `{{slide.number}}`, `{{slide.section}}` and `{{deck.slideCount}}` substituted for the same numbers its `options` carry (`resolveSlideVariables(slide, { slideNumber, slideCount })` does that substitution alone). Header and footer text is substituted by `layoutFurniture`, which records each slide number in `FurnitureTextPart.fields`. See [templates and variables](../../docs/templates-and-variables.md#slide-scoped-built-ins). It carries no catalog records: the pinned pptx.gallery snapshot is the opt-in `@openpresentation/opf/catalog` (`defaultCatalog`, display metadata and layout previews), and every entry point that resolves references takes `{ catalogs }`, the catalogs the host registered; the first one is the default for documents that omit `catalogs.default`. See [catalogs and the default catalog](../../docs/default-catalog.md).
+The root entry holds the application-level API: schemas, catalog references and their resolution (`resolveReference`, `embed`, `copySlides`, `updateFromCatalog`), validation, variables, pagination, data helpers, font policy, `stats`, `resolveSlideContext` and `resolveSlideVariables`. Engines compose and draw `context.slide` from `resolveSlideContext(deck, index, { slideNumber, slideCount })`: the slide with the slide-scoped built-ins `{{slide.number}}`, `{{slide.section}}` and `{{deck.slideCount}}` substituted for the same numbers its `options` carry (`resolveSlideVariables(slide, { slideNumber, slideCount })` does that substitution alone). Header and footer text is substituted by `layoutFurniture`, which records each slide number in `FurnitureTextPart.fields`. See [templates and variables](../../docs/templates-and-variables.md#slide-scoped-built-ins). It carries no catalog records: the pptx.gallery catalog is the package `@openpresentation/gallery` (`gallery`, `catalogDisplay`, and the layout previews of `@openpresentation/gallery/previews`), a dependency of core released on its own version line, which the Node build registers when a call names no catalogs (OPF 0.19 removed `@openpresentation/opf/catalog` and `defaultCatalog`, with no alias). Every entry point that resolves references takes `{ catalogs }`, the catalogs the host registered; the first one is the default for documents that omit `catalogs.default`. See [catalogs and the default catalog](../../docs/default-catalog.md).
 
 The layout engine's names are not on the root. `composeSlide`, `fitText`, `layoutQuote` and the other `layoutX`/`fitX` functions, numbering, footnotes and citations, colour contrast, code syntax, pattern fills, metric trends, chart options, script fonts and text direction come from `@openpresentation/opf/composition`; the symbol-font tables come from `@openpresentation/opf/symbol-font-encodings`.
 
@@ -107,14 +107,14 @@ Added in 0.12.0 (not in 0.11.4 or earlier): `@openpresentation/opf/patch` is the
 
 ### Layout previews
 
-`@openpresentation/opf/catalog` ships pre-rendered HTML thumbnails for the
+`@openpresentation/gallery/previews` ships pre-rendered HTML thumbnails for the
 slide layouts catalogued at pptx.gallery. Each preview is a Tailwind-styled
 fragment sized to fill a 16:9 container and only depends on the standard
 `--background`, `--foreground`, `--card`, `--muted`, `--muted-foreground`,
 `--accent`, and `--border` CSS variables.
 
 ```tsx
-import { getLayoutPreview } from "@openpresentation/opf/catalog";
+import { getLayoutPreview } from "@openpresentation/gallery/previews";
 
 export function LayoutThumbnail({ slug }: { slug: string }) {
   const html = getLayoutPreview(slug);
@@ -128,8 +128,7 @@ export function LayoutThumbnail({ slug }: { slug: string }) {
 }
 ```
 
-Raw HTML source-of-truth lives under `spec/previews/layouts/<slug>.html` and is
-also addressable via `@openpresentation/opf/spec/previews/layouts/<slug>.html`.
+The HTML source lives in [OpenPresentation/gallery](https://github.com/OpenPresentation/gallery); this checkout materializes ignored copies from the installed package for checks.
 
 ### Example decks
 
@@ -195,7 +194,7 @@ in the records the document embeds (`catalogs.custom`, `catalogs.default`, named
 groups), then in the catalogs the host registered with `{ catalogs }`.
 
 ```ts
-const report = validate(deck, { catalogs: [defaultCatalog] });
+const report = validate(deck, { catalogs: [gallery] });
 if (!report.valid) console.error(report.findings.filter((finding) => finding.severity === "error"));
 for (const finding of report.findings) console.warn(finding.ruleId, finding.path, finding.message);
 ```
@@ -203,10 +202,12 @@ for (const finding of report.findings) console.warn(finding.ruleId, finding.path
 Validate catalog records locally:
 
 ```ts
-import { audiences, validateCatalogRecord } from "@openpresentation/opf";
+import { validateCatalogRecord } from "@openpresentation/opf";
+import { gallery } from "@openpresentation/gallery";
 
-for (const record of audiences) {
-  const result = validateCatalogRecord("audiences", record);
+for (const [id, record] of Object.entries(gallery.audiences)) {
+  // A published record file carries its $schema and id; the gallery keys records by id without them.
+  const result = validateCatalogRecord("audiences", { $schema: "https://openpresentation.org/schema/opf-audience/v1", id, ...record });
   if (!result.valid) {
     console.error(result.findings);
   }
@@ -230,11 +231,11 @@ const openApi = specFileEntries.find((entry) => entry.path === "openapi.yaml");
 console.log(openApi?.packagePath);
 ```
 
-The snapshot's raw record files stay package-addressable (`@openpresentation/opf/spec/catalogs/<kind>/<id>.json`) for tools that read published records; documents never point at them. A host registers the catalog instead:
+Core ships no catalog record files (RR-78): the records are `@openpresentation/gallery`'s, and pptx.gallery serves each published record file at `https://www.pptx.gallery/<kind>/<id>.json`. Documents never point at them. A host registers the catalog instead:
 
 ```js
-import { defaultCatalog } from "@openpresentation/opf/catalog";
-validate(deck, { catalogs: [defaultCatalog] });
+import { gallery } from "@openpresentation/gallery";
+validate(deck, { catalogs: [gallery] });
 ```
 
 ## Development

package/dist/browser.js

@@ -1,22 +1,20 @@
-import { OPFApiError } from './chunk-IM337HP5.js';
-export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, edit, embed, fill, fillRecords, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog } from './chunk-IM337HP5.js';
-export { specFileEntries, specFileKinds, specFilePaths } from './chunk-HXHOZ7AH.js';
-export { OPFDataImportError, ingest, parseTabularData } from './chunk-ZCFSDSUX.js';
-export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-GVOLSWAJ.js';
-export { fromMarkdown, toMarkdown } from './chunk-MSFE2HUK.js';
-import './chunk-ECP7QPGK.js';
-export { OPFMarkdownError } from './chunk-R7KIASS4.js';
-export { diff, merge } from './chunk-L5YACLWK.js';
-export { OPFPatchError, OPFPatchValidationError, applyPatch } from './chunk-WHHLGDCQ.js';
-export { OPFFormatError, format } from './chunk-JCOSZTOI.js';
-export { OPFPaginationError, paginate, paginateSlide } from './chunk-FO3WGS4R.js';
-import './chunk-PNINP5IF.js';
-import './chunk-TRELE6I6.js';
-export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-KA3ZPFVT.js';
-export { CHART_TYPES, DEFAULT_VARIABLE_DATE_FORMAT, ENGINE_DEFAULT_CHART_TYPES, ENGINE_DEFAULT_COLOR_SCHEME, ENGINE_DEFAULT_FONT_SCHEME, ENGINE_DEFAULT_THEME, LANGUAGES, LOGO_SHAPES, OPFVariableError, SLIDE_SCOPED_BUILTINS, SOCIAL_PLATFORMS, VARIABLE_KINDS, chartNumber, coerceVariableValue, datasetDiagnostics, formatDataNumber, formatVariableNumber, fromExcelNumberFormat, hasContentVariables, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isTemplate, isXYChartType, listBuiltinVariables, listVariables, normalizeLanguageFamily, numberFormatError, resolveChartData, resolveDesignRecords, resolveFontScheme, resolveSlideVariables, resolveTableData, resolveVariables, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unusedDatasets, variableDeclarations } from './chunk-MBU42S5Y.js';
-export { catalogDisplayKinds, catalogSchemaNames } from './chunk-TRDXRRQK.js';
-export { CATALOG_GROUP_PATTERN, CATALOG_REFERENCE_PATTERN, OPFCatalogsOptionError, OPFUnresolvedReferenceError, catalogGroupSource, catalogKinds, catalogRecords, catalogReferenceSites, parseReference, resolveReference, unresolvedReference } from './chunk-SPFV27O5.js';
-export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-2PEWUUBR.js';
+import { OPFApiError } from './chunk-2AGWO7RM.js';
+export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, edit, embed, fill, fillRecords, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog } from './chunk-2AGWO7RM.js';
+export { specFileEntries, specFileKinds, specFilePaths } from './chunk-UJSAR6GF.js';
+export { OPFDataImportError, ingest, parseTabularData } from './chunk-W7G5LSXI.js';
+export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-NZDWCYDI.js';
+export { fromMarkdown, toMarkdown } from './chunk-RFJ5TR3V.js';
+import './chunk-4FBXVST6.js';
+export { OPFMarkdownError } from './chunk-P6LMWUXV.js';
+export { diff, merge } from './chunk-L6RRLN6Q.js';
+export { OPFPatchError, OPFPatchValidationError, applyPatch } from './chunk-2XJUXMBS.js';
+export { OPFFormatError, format } from './chunk-32MHL3B3.js';
+export { OPFPaginationError, paginate, paginateSlide } from './chunk-BDXJYO6R.js';
+import './chunk-UA5EROLC.js';
+import './chunk-ZU5EQ23T.js';
+export { CATALOG_SCHEMA, DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-7QUAOKS6.js';
+export { CATALOG_GROUP_PATTERN, CATALOG_REFERENCE_PATTERN, CHART_TYPES, DEFAULT_VARIABLE_DATE_FORMAT, ENGINE_DEFAULT_CHART_TYPES, ENGINE_DEFAULT_COLOR_SCHEME, ENGINE_DEFAULT_FONT_SCHEME, ENGINE_DEFAULT_THEME, LANGUAGES, LOGO_SHAPES, OPFCatalogsOptionError, OPFUnresolvedReferenceError, OPFVariableError, SLIDE_SCOPED_BUILTINS, SOCIAL_PLATFORMS, VARIABLE_KINDS, catalogGroupSource, catalogKinds, catalogRecords, catalogReferenceSites, chartNumber, coerceVariableValue, datasetDiagnostics, formatDataNumber, formatVariableNumber, fromExcelNumberFormat, hasContentVariables, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isTemplate, isXYChartType, listBuiltinVariables, listVariables, normalizeLanguageFamily, numberFormatError, parseReference, resolveChartData, resolveDesignRecords, resolveFontScheme, resolveReference, resolveSlideVariables, resolveTableData, resolveVariables, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unresolvedReference, unusedDatasets, variableDeclarations } from './chunk-UAXSW6VV.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-VEHLQVGQ.js';
 export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-F7PLNWHQ.js';
 
 // src/browser.ts

package/dist/{catalog-refs-BSfGELpt.d.ts → catalog-refs-CSHevLn1.d.ts}

@@ -125,4 +125,4 @@ declare function catalogReferenceSites(document: unknown, options?: {
 /** Records a picker can offer for `kind`: the document's embedded records, then those of the registered catalogs its groups name, with the reference to write for each. */
 declare function catalogRecords(document: unknown, kind: CatalogKind, options?: CatalogOptions): ResolvedReference[];
 
-export { type CatalogKind as C, OPFCatalogsOptionError as O, type RecordProvenance as R, type UnresolvedReferenceDiagnostic as U, type Catalog as a, type CatalogOptions as b, CATALOG_GROUP_PATTERN as c, CATALOG_REFERENCE_PATTERN as d, type CatalogRecordMap as e, type CatalogRecords as f, type CatalogReferenceSite as g, OPFUnresolvedReferenceError as h, type ResolvedReference as i, catalogGroupSource as j, catalogKinds as k, catalogRecords as l, catalogReferenceSites as m, parseReference as p, resolveReference as r, unresolvedReference as u };
+export { type Catalog as C, OPFCatalogsOptionError as O, type RecordProvenance as R, type UnresolvedReferenceDiagnostic as U, type CatalogOptions as a, type CatalogKind as b, CATALOG_GROUP_PATTERN as c, CATALOG_REFERENCE_PATTERN as d, type CatalogRecordMap as e, type CatalogRecords as f, type CatalogReferenceSite as g, OPFUnresolvedReferenceError as h, type ResolvedReference as i, catalogGroupSource as j, catalogKinds as k, catalogRecords as l, catalogReferenceSites as m, parseReference as p, resolveReference as r, unresolvedReference as u };

package/dist/{chunk-IM337HP5.js → chunk-2AGWO7RM.js}

@@ -1,8 +1,7 @@
-import { OPFDataImportError, parseTabularData } from './chunk-ZCFSDSUX.js';
-import { applyPatchWithInverse } from './chunk-WHHLGDCQ.js';
-import { validate, OPFValidationError } from './chunk-KA3ZPFVT.js';
-import { isRecord, visitContentPayloads, listVariables, resolveVariables, LOGO_SHAPES, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-MBU42S5Y.js';
-import { embeddedCopy, checkCatalogsOption, catalogReferenceSites, parseReference, catalogGroupDeclared, resolveReference, dottedPath, unresolvedReference, recordReferenceSites, catalogGroupSource, registeredCatalog, catalogKinds, CATALOG_GROUP_PATTERN } from './chunk-SPFV27O5.js';
+import { OPFDataImportError, parseTabularData } from './chunk-W7G5LSXI.js';
+import { applyPatchWithInverse } from './chunk-2XJUXMBS.js';
+import { validate, OPFValidationError } from './chunk-7QUAOKS6.js';
+import { embeddedCopy, checkCatalogsOption, catalogReferenceSites, parseReference, catalogGroupDeclared, resolveReference, dottedPath, unresolvedReference, recordReferenceSites, catalogGroupSource, registeredCatalog, catalogKinds, CATALOG_GROUP_PATTERN, isRecord, visitContentPayloads, listVariables, resolveVariables, LOGO_SHAPES, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-UAXSW6VV.js';
 
 // src/api-errors.ts
 var OPFApiError = class extends Error {

package/dist/{chunk-WHHLGDCQ.js → chunk-2XJUXMBS.js}

@@ -1,4 +1,4 @@
-import { validate } from './chunk-KA3ZPFVT.js';
+import { validate } from './chunk-7QUAOKS6.js';
 
 // src/patch.ts
 var OPFPatchError = class extends Error {

package/dist/{chunk-JCOSZTOI.js → chunk-32MHL3B3.js}

@@ -1,4 +1,4 @@
-import { presentation } from './chunk-2PEWUUBR.js';
+import { presentation } from './chunk-VEHLQVGQ.js';
 
 // src/format.ts
 var OPFFormatError = class extends Error {
@@ -66,7 +66,12 @@ function format(input, options = {}) {
   const indent = options.indent ?? 2;
   if (!Number.isInteger(indent) || indent < 0 || indent > 8) throw new OPFFormatError("indent must be an integer from 0 to 8.");
   if (options.eol !== void 0 && options.eol !== "lf" && options.eol !== "crlf") throw new OPFFormatError("eol must be lf or crlf.");
-  const text = JSON.stringify(sortPresentationKeys(document), null, indent);
+  const sorted = sortPresentationKeys(document);
+  const slides = sorted !== null && typeof sorted === "object" && !Array.isArray(sorted) ? sorted.slides : void 0;
+  if (Array.isArray(slides)) {
+    for (const slide of slides) if (slide !== null && typeof slide === "object" && slide.layout === "auto") delete slide.layout;
+  }
+  const text = JSON.stringify(sorted, null, indent);
   if (text === void 0) throw new OPFFormatError("Nothing to format.");
   return options.eol === "crlf" ? `${text.replaceAll("\n", "\r\n")}\r
 ` : `${text}

package/dist/{chunk-ECP7QPGK.js → chunk-4FBXVST6.js}

@@ -1,9 +1,9 @@
-import { NOT_CHECKED, Ctx } from './chunk-R7KIASS4.js';
-import { sortPresentationKeys } from './chunk-JCOSZTOI.js';
-import { same } from './chunk-TRELE6I6.js';
-import { validate } from './chunk-KA3ZPFVT.js';
-import { checkCatalogsOption } from './chunk-SPFV27O5.js';
-import { presentation } from './chunk-2PEWUUBR.js';
+import { NOT_CHECKED, Ctx } from './chunk-P6LMWUXV.js';
+import { sortPresentationKeys } from './chunk-32MHL3B3.js';
+import { same } from './chunk-ZU5EQ23T.js';
+import { validate } from './chunk-7QUAOKS6.js';
+import { checkCatalogsOption } from './chunk-UAXSW6VV.js';
+import { presentation } from './chunk-VEHLQVGQ.js';
 import { Parser, parseDocument, isMap, Document, visit, isScalar, isAlias, isSeq } from 'yaml';
 
 var MAX_ALIAS_COUNT = 100;

package/dist/{chunk-KA3ZPFVT.js → chunk-7QUAOKS6.js}

@@ -1,11 +1,26 @@
-import { promotedRegionKeys, VARIABLE_KINDS, resolveChartData, chartPaletteForFill, imageBackground, tableGrid, timelineTextColor, LOGO_SHAPES, visitContentPayloads, readingRows, visualReadingOrder, intrinsicImageSize, textWidthMeasurer, normalizeHexColor, resolveColorRef, resolveDesignRecords, resolveFontFamilies, resolveColorRoles, resolveCanvasDimensions, resolveSlideVariables, defaultSlideBackground, isRecord, hasContentVariables, isTemplate, instantiateForValidation, resolveScriptFonts, unusedDatasets, MAX_COMPOSITION_DEPTH, datasetDiagnostics, pathFor, collectCitations, numberingFindings, walkCitationRuns, resolveTableData, resolveChartOptions, chartOptionTarget, codeHighlightLines, chartNumberFixesByCell, MAX_PLACEHOLDER_GROUP_DEPTH, OPFCompositionError, composeSlide } from './chunk-MBU42S5Y.js';
-import { catalogSchemaNames } from './chunk-TRDXRRQK.js';
-import { resolveReference, checkCatalogsOption, provenanceOf, unresolvedReference, OPFUnresolvedReferenceError, catalogReferenceSites, parseReference, catalogGroupDeclared, pointerPath, catalogRecords, catalogKinds, catalogGroupSource, registeredCatalog } from './chunk-SPFV27O5.js';
-import { schemaEntries, schemas } from './chunk-2PEWUUBR.js';
+import { promotedRegionKeys, VARIABLE_KINDS, resolveChartData, chartPaletteForFill, imageBackground, tableGrid, timelineTextColor, LOGO_SHAPES, visitContentPayloads, readingRows, visualReadingOrder, intrinsicImageSize, resolveReference, textWidthMeasurer, normalizeHexColor, resolveColorRef, resolveDesignRecords, resolveFontFamilies, checkCatalogsOption, provenanceOf, unresolvedReference, OPFUnresolvedReferenceError, resolveColorRoles, resolveCanvasDimensions, resolveSlideVariables, defaultSlideBackground, isRecord, hasContentVariables, isTemplate, instantiateForValidation, layoutTemplateIssues, resolveScriptFonts, catalogReferenceSites, parseReference, catalogGroupDeclared, pointerPath, unusedDatasets, MAX_COMPOSITION_DEPTH, datasetDiagnostics, pathFor, catalogRecords, collectCitations, numberingFindings, walkCitationRuns, resolveTableData, resolveChartOptions, chartOptionTarget, codeHighlightLines, chartNumberFixesByCell, catalogKinds, catalogGroupSource, registeredCatalog, OPFCompositionError, composeSlide } from './chunk-UAXSW6VV.js';
+import { schemaEntries, schemas } from './chunk-VEHLQVGQ.js';
 import Ajv2020 from 'ajv/dist/2020.js';
 import addFormats from 'ajv-formats';
 import { parseTree, printParseErrorCode, getNodePath } from 'jsonc-parser';
 
+// src/catalog-schemas.ts
+var CATALOG_SCHEMA = 3;
+var catalogDisplayKinds = ["chartTypes", "languages", "socialPlatforms"];
+var catalogSchemaNames = {
+  layouts: "layout",
+  themes: "theme",
+  colorSchemes: "colorScheme",
+  fontSchemes: "fontScheme",
+  narratives: "narrative",
+  audiences: "audience",
+  purposes: "purpose",
+  tones: "tone",
+  chartTypes: "chartType",
+  languages: "language",
+  socialPlatforms: "socialPlatform"
+};
+
 // src/annotation-validation.ts
 var issue = (path, message, params) => ({ path, message, keyword: "opf", schemaPath: "#/x-opf-semantics", params });
 var pointer = (dotted) => `/${dotted.split(".").map((part) => part.replaceAll("~", "~0").replaceAll("/", "~1")).join("/")}`;
@@ -909,33 +924,6 @@ function dataUnionErrors(errors, value) {
     return { ...error, message: field === "fields" ? "'fields' applies only to a dataset-backed table; add 'dataset' or remove 'fields'" : datasetTableMessage(field) };
   });
 }
-var placeholderHeadings = /* @__PURE__ */ new Set(["title", "subtitle", "tag"]);
-function placeholderGroupIssues(value) {
-  const issues = [];
-  if (!isRecord(value) || !Array.isArray(value.placeholders)) return issues;
-  const walk = (entries, path, depth) => entries.forEach((entry, index) => {
-    if (!isRecord(entry)) return;
-    const at2 = `${path}/${index}`;
-    if (entry.type === "group") {
-      if (depth >= MAX_PLACEHOLDER_GROUP_DEPTH) issues.push(semanticIssue(at2, `placeholder groups nest at most ${MAX_PLACEHOLDER_GROUP_DEPTH} levels inside a layout record; this group would be level ${depth + 1}`, { code: "layout-placeholder-group", depth: depth + 1, maxDepth: MAX_PLACEHOLDER_GROUP_DEPTH }));
-      else if (Array.isArray(entry.placeholders)) walk(entry.placeholders, `${at2}/placeholders`, depth + 1);
-      return;
-    }
-    if (depth === 0) return;
-    if (typeof entry.type === "string" && placeholderHeadings.has(entry.type)) issues.push(semanticIssue(`${at2}/type`, `a placeholder group holds body regions only; a '${entry.type}' placeholder belongs at the record's top level`, { code: "layout-placeholder-group" }));
-    if (hasOwn(entry, "placement")) issues.push(semanticIssue(`${at2}/placement`, "placement is only valid on a top-level image placeholder; a region inside a placeholder group cannot bleed to a slide edge", { code: "image-placement-invalid" }));
-  });
-  walk(value.placeholders, "/placeholders", 0);
-  return issues;
-}
-function withPlaceholderGroupIssues(errors, value) {
-  const issues = placeholderGroupIssues(value);
-  const entries = issues.map((issue2) => issue2.path.replace(/\/(type|placement)$/, ""));
-  const covered = (error) => entries.some((entry) => error.path === entry || error.path.startsWith(`${entry}/`));
-  const kept = errors.filter((error) => !covered(error));
-  const reported = [...kept.filter((error) => error.keyword !== "if"), ...issues].map((error) => error.path);
-  return [...kept.filter((error) => error.keyword !== "if" || !reported.some((path) => path === error.path || path.startsWith(`${error.path}/`))), ...issues];
-}
 function validateAgainstSchema(value, schemaOrKind = "presentation", options = {}) {
   const resolved = resolveValidator(schemaOrKind);
   if (resolved.schemaName === "presentation") {
@@ -968,7 +956,8 @@ function validateAgainstSchema(value, schemaOrKind = "presentation", options = {
   const valid = resolved.validate(subject) === true;
   const ajvErrors = valid ? [] : typedVariableErrors(resolved.validate.errors ?? [], subject);
   const mapped = (resolved.schemaName === "presentation" ? dataUnionErrors(ajvErrors, subject) : ajvErrors).map(toIssue);
-  const errors = resolved.schemaName === "layout" ? withPlaceholderGroupIssues(mapped, subject) : mapped;
+  const errors = mapped;
+  if (resolved.schemaName === "layout" && valid) for (const issue2 of layoutTemplateIssues(subject)) errors.push(semanticIssue(issue2.path, issue2.message, { code: issue2.code }));
   const warnings = [];
   if (resolved.schemaName === "presentation") {
     errors.push(...presentationSemanticIssues(subject));
@@ -1797,7 +1786,7 @@ var readingOrderRule = rule(
   {
     standard: 'WCAG 2.2 SC 1.3.2 Meaningful Sequence, level A (PowerPoint: "Check reading order")',
     cost: "composition",
-    approximations: "Compares the composed content order with a visual order recomputed from the composed boxes: items whose vertical centres fall in the same row are ordered along the reading direction (a right-to-left deck is checked by rows only), rows from top to bottom. Headings are expected first. Free-form overlap is not analysed."
+    approximations: "Compares the composed content order with a visual order recomputed from the composed boxes: items whose vertical centres fall in the same row are ordered along the reading direction (a right-to-left deck is checked by rows only), rows from top to bottom. Headings are expected first. Free-form overlap is not analysed. On a slide with a template layout (OPF 0.19) the expected order is the binding order instead (the regions in reading order, then the blocks of each region), and items outside a region (placed images, the row below the grid) are not compared."
   }
 );
 var readingOrderRules = [
@@ -1819,8 +1808,11 @@ var readingOrderRules = [
           });
         }
         if (body.length < 2) continue;
-        const visual = visualOrder(body, slide.rtl);
-        const composed = body.map((item) => item.path);
+        const regions = composition.regions;
+        const ordered = regions ? body.filter((item) => item.region !== void 0) : body;
+        if (ordered.length < 2) continue;
+        const visual = regions ? bindingOrder(ordered, regions) : visualOrder(ordered, slide.rtl);
+        const composed = ordered.map((item) => item.path);
         const index = composed.findIndex((path, i) => path !== visual[i]);
         if (index < 0) continue;
         const name = (path) => shortField(path);
@@ -1835,6 +1827,16 @@ var readingOrderRules = [
     }
   }
 ];
+function bindingOrder(items, regions) {
+  const rank = new Map(regions.map((region, index) => [region.name, index]));
+  const blockRank = (item) => {
+    const region = regions.find((entry) => entry.name === item.region);
+    const blocks = region ? [...region.content, ...region.overflow ?? []] : [];
+    const found = blocks.findIndex((block) => item.path === block || item.path.startsWith(`${block}.`));
+    return found < 0 ? blocks.length : found;
+  };
+  return items.map((item, index) => ({ item, index, region: rank.get(item.region ?? "") ?? regions.length, block: blockRank(item) })).sort((a, b) => a.region - b.region || a.block - b.block || a.index - b.index).map((entry) => entry.item.path);
+}
 function visualOrder(items, rtl) {
   if (rtl) return readingRows(items).flatMap((row) => row.map((item) => item.path));
   return visualReadingOrder(items).map((item) => item.path);
@@ -2160,10 +2162,43 @@ var minFontRule = rule(
     approximations: "Sizes are those composeSlide fitted, expressed on the 13.33 x 7.5 in reference slide (96 px per inch, so 1 px is 0.75 pt; a smaller canvas scales type down with it) and explicit run fontSize values in points. Per payload, the smallest part (a metric label or a quote attribution) is reported. Table cell text (default 11.25 pt), code and header/footer furniture are not checked."
   }
 );
+var regionUnknownRule = rule(
+  "region-unknown",
+  "layout",
+  "warning",
+  "A block is pinned to a region the layout does not have.",
+  "A region pin (`region` on a root block) names a region of the slide's layout. A name the layout does not have is ignored: the block is placed by its kind, which may not be where the author meant.",
+  { cost: "composition" }
+);
+var regionKindRule = rule(
+  "region-kind",
+  "layout",
+  "warning",
+  "A block is pinned to a region that does not accept its kind.",
+  "A region says which content kinds it takes. A pin to a region that does not take the block's kind is ignored and the block is placed by its kind.",
+  { cost: "composition" }
+);
+var regionFullRule = rule(
+  "region-full",
+  "layout",
+  "warning",
+  "A block is pinned to a region that is already full.",
+  "A region holds at most `max` blocks on one slide. A pin to a full region is ignored and the block is placed by its kind.",
+  { cost: "composition" }
+);
+var unplacedRule = rule(
+  "layout-unplaced",
+  "layout",
+  "warning",
+  "No region of the layout has room for a block.",
+  "Content is never dropped: a block no region has room for is drawn in the layout's overflow region beyond its max (or below the grid), where it crowds the others. Paginate moves it to a continuation slide with the same layout.",
+  { cost: "composition" }
+);
+var REGION_RULES = { "region-unknown": regionUnknownRule, "region-kind": regionKindRule, "region-full": regionFullRule, "layout-unplaced": unplacedRule };
 var layoutRules = [
   {
     info: overflowRule,
-    also: [unresolvedRule, layoutFailedRule, minFontRule],
+    also: [unresolvedRule, layoutFailedRule, minFontRule, regionUnknownRule, regionKindRule, regionFullRule, unplacedRule],
     run(context) {
       const deckLevel = /* @__PURE__ */ new Set();
       for (const slide of context.slides) {
@@ -2179,6 +2214,8 @@ var layoutRules = [
           if (diagnostic.code === "text-overflow")
             context.report(overflowRule, { path, slide, message: diagnostic.message, help: "Shorten the text, give it more space (fewer blocks, a different composition) or split the slide (paginate); raising the readable minimum makes it worse." });
           else if (diagnostic.code === "small-cell") continue;
+          else if (Object.hasOwn(REGION_RULES, diagnostic.code))
+            context.report(REGION_RULES[diagnostic.code], { path, slide, message: diagnostic.message, help: diagnostic.code === "layout-unplaced" ? "Paginate the slide, choose a layout with more room, pin the block to a region with room, or remove a block." : "Pin the block to a region of the layout that accepts it and has room, or remove the pin." });
           else context.report(unresolvedRule, { path, slide: path.startsWith("/slides/") ? slide : void 0, message: diagnostic.message, help: "Supply what the message asks for, or remove the setting that cannot be honoured." });
         }
         for (const tv of slide.texts)
@@ -2512,6 +2549,22 @@ var referenceRules = [
     "A record that fails its companion schema cannot be resolved. Invalid records are left out of the lookup, so the references to them are reported too.",
     { standard: "spec/schemas/<kind>.schema.json" }
   ),
+  rule(
+    "layout-template",
+    "references",
+    "error",
+    "A layout template's grid is malformed.",
+    'A layout (OPF 0.19) is a grid of named areas. Engines cannot compose a grid whose rows have different lengths, whose names do not form one filled rectangle each, whose column or row sizes do not match the grid, that is larger than 12 x 12, or that holds a word that is not a name or ".". composeSlide refuses such a record, so a slide that names it composes automatically.',
+    { standard: "spec/schemas/layout.schema.json and the area rules of OPF 0.19 (docs/layout-templates.md)", approximations: "Checked on every layout record the document embeds and every registered record it uses, once the record passes its schema." }
+  ),
+  rule(
+    "layout-region",
+    "references",
+    "error",
+    "A layout template's regions do not match its areas.",
+    "Every body area of a layout needs a region that says what it accepts, and every region needs an area. Region names may not be title, subtitle, tag, auto or a promoted-region word (left, center, right, top, middle, bottom), so a Markdown block's region= stays unambiguous; a subtitle area needs a title area; a region with flow 'none' holds one block; overflowRegion must name a region. composeSlide refuses such a record.",
+    { standard: "spec/schemas/layout.schema.json and the region rules of OPF 0.19 (docs/layout-templates.md)" }
+  ),
   rule(
     "unresolved-reference",
     "references",
@@ -2811,6 +2864,7 @@ function fields(document) {
   }
   return result;
 }
+var recordRuleId = (issue2) => issue2.keyword === "opf" && (issue2.params.code === "layout-template" || issue2.params.code === "layout-region") ? `opf/${issue2.params.code}` : "opf/catalog-record";
 var recordKey = (group, kind, id) => `${group}/${kind}/${id}`;
 function recordIssues(kind, id, value) {
   const schemaName = catalogSchemaNames[kind];
@@ -2826,7 +2880,7 @@ function embeddedRecordFindings(document, options, findings) {
         const path = pointer3(["catalogs", group, kind, id]);
         if (object(record) && (Object.hasOwn(record, "$schema") || Object.hasOwn(record, "id"))) continue;
         const validation = recordIssues(kind, id, record);
-        for (const issue2 of validation.errors) findings.push(issueFinding(issue2, "opf/catalog-record", catalogSchemaNames[kind], path, "document"));
+        for (const issue2 of validation.errors) findings.push(issueFinding(issue2, recordRuleId(issue2), catalogSchemaNames[kind], path, "document"));
         if (!validation.valid) invalid.add(recordKey(group, kind, id));
         if (group === "custom") continue;
         const source = catalogGroupSource(document, group, options);
@@ -3011,7 +3065,7 @@ function contentReferenceFindings(document, options, findings) {
     if (found?.origin === "host" && !registeredChecked.has(recordKey(found.group, site.kind, found.id))) {
       registeredChecked.add(recordKey(found.group, site.kind, found.id));
       for (const issue2 of recordIssues(site.kind, found.id, found.record).errors)
-        findings.push(issueFinding(issue2, "opf/catalog-record", catalogSchemaNames[site.kind], pointer3(["catalogs", found.group, site.kind, found.id]), "context"));
+        findings.push(issueFinding(issue2, recordRuleId(issue2), catalogSchemaNames[site.kind], pointer3(["catalogs", found.group, site.kind, found.id]), "context"));
     }
     if (found && !(found.origin === "document" && invalid.has(recordKey(found.group, site.kind, found.id)))) continue;
     const diagnostic = unresolvedReference(document, site.kind, site.reference, path, options);
@@ -3378,7 +3432,7 @@ function resolveSlideContext(presentation, index, options = {}) {
   const design = { ...rec2(deck.design), ...rec2(slide.design) };
   let layout;
   let layoutProvenance;
-  if (typeof slide.layout === "string") {
+  if (typeof slide.layout === "string" && slide.layout !== "auto") {
     const found = resolveReference(presentation, "layouts", slide.layout, catalogs);
     if (found) {
       layout = { ...found.record };
@@ -3396,6 +3450,8 @@ function resolveSlideContext(presentation, index, options = {}) {
     fontFamilies: resolveFontFamilies(fontScheme),
     darkBackground: resolveColorRoles(colorScheme, { background: decisionColor(design.background ?? theme.background, colorScheme, rec2(deck.variables)) }).dark,
     ...theme.background !== void 0 ? { themeBackground: theme.background } : {},
+    // OPF 0.19: a theme may carry the shared design keys (between the deck's design and the layout record's).
+    ...theme.design !== void 0 && rec2(theme.design) === theme.design ? { themeDesign: theme.design } : {},
     ...options.fonts?.textMeasurement ? { textMeasurement: options.fonts.textMeasurement } : {},
     ...options.date !== void 0 ? { date: options.date } : {}
   };
@@ -3767,4 +3823,4 @@ function assertValidCatalogRecord(kind, value) {
   if (!report2.valid) throw new OPFValidationError(report2);
 }
 
-export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, parseSource, resolveSlideContext, resolveSlideScriptMeasurement, validate, validateCatalogRecord, validationCategories, validationRules };
+export { CATALOG_SCHEMA, DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, parseSource, resolveSlideContext, resolveSlideScriptMeasurement, validate, validateCatalogRecord, validationCategories, validationRules };

package/dist/{chunk-FO3WGS4R.js → chunk-BDXJYO6R.js}

@@ -1,6 +1,5 @@
-import { assertValid, resolveSlideScriptMeasurement, resolveSlideContext } from './chunk-KA3ZPFVT.js';
-import { resolveSlideVariables, usesSlideBuiltin, composeSlide, codeHighlightSlice, tableRowBoundaries, visitContentPayloads, slideTokenSpans, sliceNumberedItems } from './chunk-MBU42S5Y.js';
-import { checkCatalogsOption } from './chunk-SPFV27O5.js';
+import { assertValid, resolveSlideScriptMeasurement, resolveSlideContext } from './chunk-7QUAOKS6.js';
+import { resolveSlideVariables, checkCatalogsOption, usesSlideBuiltin, composeSlide, codeHighlightSlice, tableRowBoundaries, visitContentPayloads, regionAccepts, slideTokenSpans, sliceNumberedItems } from './chunk-UAXSW6VV.js';
 
 // src/pagination.ts
 var OPFPaginationError = class extends Error {
@@ -110,16 +109,6 @@ function paginateSlide(input, options = {}) {
   const { fonts, catalogs, minFontSize: _minFontSize, maxSlides: _maxSlides, reservedIds: _reservedIds, ...engineOptions } = options;
   const textMeasurement = fonts?.textMeasurement && options.presentation !== void 0 ? resolveSlideScriptMeasurement(options.presentation, sourceIndex, fonts.textMeasurement, { ...catalogs !== void 0 ? { catalogs } : {}, ...options.fontFamilies ? { fontFamilies: options.fontFamilies } : {} }) : fonts?.textMeasurement;
   const composeOptions = { ...engineOptions, ...textMeasurement ? { textMeasurement } : {} };
-  const readableLayout = (layout) => {
-    if (!isRecord(layout) || !Array.isArray(layout.placeholders) || !layout.placeholders.some((entry) => isRecord(entry) && entry.type === "group")) return layout;
-    const visit = (entries) => entries.map((entry) => {
-      if (!isRecord(entry) || entry.type !== "group") return entry;
-      const own = isRecord(entry.composition) ? entry.composition : {};
-      return { ...entry, composition: { ...own, ...typeof own.minFontSize === "number" ? { minFontSize: Math.max(minFontSize, own.minFontSize) } : {}, overflow: "warn" }, placeholders: Array.isArray(entry.placeholders) ? visit(entry.placeholders) : entry.placeholders };
-    });
-    return { ...layout, placeholders: visit(layout.placeholders) };
-  };
-  if (options.layout !== void 0) composeOptions.layout = readableLayout(options.layout);
   const presentationSlides = options.presentation?.slides;
   const slideCount = options.slideCount ?? (Array.isArray(presentationSlides) && presentationSlides.length ? presentationSlides.length : void 0);
   const logoContext = options.presentation !== void 0 ? { presentation: options.presentation, darkBackground: options.darkBackground === true } : {};
@@ -129,7 +118,18 @@ function paginateSlide(input, options = {}) {
     return composeSlide(resolveSlideVariables(withReadability(slide, true), { slideNumber, ...slideCount !== void 0 ? { slideCount } : {}, ...logoContext }), { ...composeOptions, slideNumber });
   };
   const initial = geometry(source);
-  const fit = (diagnostics) => diagnostics.filter((issue) => issue.code === "text-overflow" || issue.code === "small-cell" || !!initial.furniture?.diagnostics.includes(issue));
+  const movable = (issue) => {
+    if (issue.region !== void 0) return true;
+    const match = /^slides\.\d+\.blocks\.(\d+)$/.exec(issue.path);
+    const block = match && Array.isArray(source.blocks) ? source.blocks[Number(match[1])] : void 0;
+    return block !== void 0 && (initial.regions ?? []).some((region) => regionAccepts(region, block));
+  };
+  const fit = (diagnostics) => diagnostics.filter((issue) => issue.code === "text-overflow" || issue.code === "small-cell" || issue.code === "layout-unplaced" && movable(issue) || !!initial.furniture?.diagnostics.includes(issue));
+  const regionOfBlock = /* @__PURE__ */ new Map();
+  for (const region of initial.regions ?? []) for (const content of [...region.content, ...region.overflow ?? []]) {
+    const match = /\.blocks\.(\d+)$/.exec(content);
+    if (match) regionOfBlock.set(Number(match[1]), { name: region.name, accepts: region.accepts });
+  }
   const repeatedMappings = (pageIndex) => {
     if (!initial.furniture) return [];
     const paths = new Set(initial.items.filter((item) => headingFields.has(item.field)).map((item) => item.path));
@@ -149,7 +149,13 @@ function paginateSlide(input, options = {}) {
     for (const key of path.slice(sourceBase.length + 1).split(".")) node = isRecord(node) || Array.isArray(node) ? node[key] : void 0;
     return node === void 0 ? fallback : node;
   };
-  const leaves = initial.items.filter((item) => !headingFields.has(item.field)).map((item) => leafFor(item.path, item.field, sourceValue(item.path, item.value)));
+  const blockIndex = (path) => {
+    const match = /^slides\.\d+\.blocks\.(\d+)/.exec(path);
+    return match ? Number(match[1]) : -1;
+  };
+  const bodyItems = initial.items.filter((item) => !headingFields.has(item.field));
+  if (initial.regions) bodyItems.sort((a, b) => blockIndex(a.path) - blockIndex(b.path));
+  const leaves = bodyItems.map((item) => leafFor(item.path, item.field, sourceValue(item.path, item.value)));
   const leafPaths = new Set(leaves.map((leaf) => leaf.path));
   const slides = [], pages = [];
   let selected = /* @__PURE__ */ new Map();
@@ -192,7 +198,10 @@ function paginateSlide(input, options = {}) {
           const children = [];
           value.forEach((child, index) => {
             const projected = visit(child, `${childPath}.${index}`, `${outputPath}.${children.length}`);
-            if (projected) children.push(projected);
+            if (!projected) return;
+            const region = root && pageIndex > 0 && projected.region === void 0 ? regionOfBlock.get(index) : void 0;
+            if (region && regionAccepts(region, projected)) projected.region = region.name;
+            children.push(projected);
           });
           if (children.length) {
             result.blocks = children;

package/dist/chunk-BYEIFHWS.js

@@ -0,0 +1,16 @@
+import { OPFApiError } from './chunk-2AGWO7RM.js';
+import { CATALOG_SCHEMA } from './chunk-7QUAOKS6.js';
+import { CATALOG_SCHEMA as CATALOG_SCHEMA$1, gallery } from '@openpresentation/gallery';
+
+function galleryMismatch(declared, reads = CATALOG_SCHEMA) {
+  if (declared === reads) return void 0;
+  return `@openpresentation/gallery targets catalog schema ${JSON.stringify(declared)}, and this @openpresentation/opf reads catalog schema ${reads}. Install the gallery release for schema ${reads} (the range in @openpresentation/opf's dependencies), or pass catalogs explicitly.`;
+}
+var mismatch = galleryMismatch(CATALOG_SCHEMA$1);
+var DEFAULTS = Object.freeze([gallery]);
+function defaultCatalogs() {
+  if (mismatch) throw new OPFApiError(mismatch, "gallery-schema-mismatch", { details: { gallery: CATALOG_SCHEMA$1, core: CATALOG_SCHEMA } });
+  return DEFAULTS;
+}
+
+export { defaultCatalogs, galleryMismatch };