@openpresentation/opf 0.18.3 → 0.19.0

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,23 +1,21 @@
-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';
-export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-WXSPETQ6.js';
+import { OPFApiError } from './chunk-V3RGXJJS.js';
+export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, edit, embed, fill, fillRecords, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog } from './chunk-V3RGXJJS.js';
+export { specFileEntries, specFileKinds, specFilePaths } from './chunk-UJSAR6GF.js';
+export { OPFDataImportError, ingest, parseTabularData } from './chunk-AK4UXIRP.js';
+export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-GRN3U5JT.js';
+export { fromMarkdown, toMarkdown } from './chunk-FGUQHD37.js';
+import './chunk-SIQWYDFF.js';
+export { OPFMarkdownError } from './chunk-LRPSMQ62.js';
+export { diff, merge } from './chunk-SEUJIS55.js';
+export { OPFPatchError, OPFPatchValidationError, applyPatch } from './chunk-WHKFIFN7.js';
+export { OPFFormatError, format } from './chunk-A6COIVTD.js';
+export { OPFPaginationError, paginate, paginateSlide } from './chunk-OVBGGGKO.js';
+import './chunk-YAHPQRVU.js';
+import './chunk-HBFRNOP4.js';
+export { CATALOG_SCHEMA, DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-65GDO6TJ.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-ZPCKGGI6.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-R5T4H4ZV.js';
+export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-F7PLNWHQ.js';
 
 // src/browser.ts
 var nodeOnly = (name, message) => new OPFApiError(`\`${name}\` ${message}`, "node-only", { details: { function: name, build: "browser" } });

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-KA3ZPFVT.js → chunk-65GDO6TJ.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-ZPCKGGI6.js';
+import { schemaEntries, schemas } from './chunk-R5T4H4ZV.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 = 2;
+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-JCOSZTOI.js → chunk-A6COIVTD.js}

@@ -1,4 +1,4 @@
-import { presentation } from './chunk-2PEWUUBR.js';
+import { presentation } from './chunk-R5T4H4ZV.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-ZCFSDSUX.js → chunk-AK4UXIRP.js}

@@ -1,4 +1,4 @@
-import { chartNumber } from './chunk-MBU42S5Y.js';
+import { chartNumber } from './chunk-ZPCKGGI6.js';
 
 // src/data.ts
 var OPFDataImportError = class extends Error {

package/dist/{chunk-WXSPETQ6.js → chunk-F7PLNWHQ.js}

@@ -44,6 +44,11 @@ var fontPolicySource = {
       "replacement": {
         "family": "Noto Sans Thai",
         "compatibility": "visual",
+        "sizeAdjust": 0.75,
+        "lineAscent": 0.83,
+        "lineAscentMixed": 0.86,
+        "lineAscentBasis": "opf#361 native probe, PowerPoint 365 16.0 build 20430 (RR-38 setup, 2880 px; bottom edge of the last row with 35 percent of the darkest row's ink): 0.833 / 0.833 / 0.833 em at 18 / 24 / 32 pt, with a Latin run 0.856 / 0.866 / 0.862 (replaces the 0.85 read from 1280 px PNGs). Evidence: docs/evidence/ff-46-sizeadjust-native-20261010.",
+        "sizeAdjustBasis": "opf#361 rule: the smallest factor (0.01 steps, up) at which no line of the FF-44 script corpus or of the scheme's Latin overhangs over 3 percent natively, regular and bold (Angsana New 5.06 advances over Noto Sans Thai's, fontkit, read in place). Exact 0.7401; worst line thai-digits +1.6 percent; Latin slack 42.9 percent (Latin is drawn by the replacement at the composed size). Evidence: docs/evidence/ff-46-sizeadjust-native-20261010.",
         "measured": {
           "replacement": "Noto Sans Thai",
           "meanAbsWidthDelta": 0.7476,
@@ -275,9 +280,9 @@ var fontPolicySource = {
         "family": "Noto Naskh Arabic",
         "compatibility": "visual",
         "sizeAdjust": 0.64,
-        "lineAscent": 0.7,
-        "lineAscentMixed": 0.78,
-        "lineAscentBasis": "RR-38 native PowerPoint 365 probe (probe-arabic.pptx, 18, 24 and 32 pt, 100 percent line spacing, zero insets, top anchor, rtl paragraph): the baseline of an Arabic Typesetting-only line (the most common ink-bottom row of the line) sits 0.68, 0.71 and 0.72 em below the box top (regular) and 0.68, 0.72 and 0.73 em (bold), against Arabic Typesetting's hhea ascent of 0.701 em; a line that also holds an Aptos run (Arabic, 'PowerPoint 365', Arabic) sits 0.77, 0.78 and 0.78 em below it. Core places the baseline one em below the line top, so the preview drew Arabic lines 0.22 to 0.30 em lower.",
+        "lineAscent": 0.74,
+        "lineAscentMixed": 0.8,
+        "lineAscentBasis": "opf#361 native probe, PowerPoint 365 16.0 build 20430 (RR-38 setup, 2880 px; bottom edge of the last row with 35 percent of the darkest row's ink): 0.741 / 0.736 / 0.740 em at 18 / 24 / 32 pt, with a Latin run 0.801 / 0.810 / 0.800. Corrects RR-38's 0.70 / 0.78 (an earlier estimator; RR-38's own 2560 px PNGs re-read 0.743 / 0.745 / 0.746 and 0.79 to 0.80 with this rule). Evidence: docs/evidence/ff-46-sizeadjust-native-20261010.",
         "sizeAdjustBasis": "RR-38: sum of Arabic Typesetting 6.85 advances over sum of Noto Naskh Arabic 400 advances (fontkit, each sample's OpenType language). 0.643 on the 12 Arabic-script corpus samples of opf-render test/fixtures/script-corpora.json (per-sample range 0.57 to 0.86); 0.598 on 29 Arabic strings of the RR-05b native deck (running Arabic text); 0.614 pooled; Noto Naskh Arabic 700 gives 0.62, 0.58 and 0.59, so bold runs draw about 3 percent long. Ink height of alef, lam, meem and heh is 0.71 of Noto Naskh Arabic's. 0.64 balances the two: lines come out about 4 percent longer than PowerPoint's and glyphs about 10 percent smaller. Native check (RR-38 probe): PowerPoint's BoundWidth of the 45-character probe line is 216.9, 289.0 and 386.1 pt at 18, 24 and 32 pt, 1.8 to 2.0 percent above the fontkit advance of the installed font (213.0, 284.0, 378.7).",
         "measured": {
           "replacement": "Noto Naskh Arabic",
@@ -1100,6 +1105,11 @@ var fontPolicySource = {
       "replacement": {
         "family": "Noto Sans Thai",
         "compatibility": "visual",
+        "sizeAdjust": 0.68,
+        "lineAscent": 0.82,
+        "lineAscentMixed": 0.85,
+        "lineAscentBasis": "opf#361 native probe, PowerPoint 365 16.0 build 20430 (RR-38 setup, 2880 px; bottom edge of the last row with 35 percent of the darkest row's ink): 0.815 / 0.819 / 0.813 em at 18 / 24 / 32 pt, with a Latin run 0.856 / 0.852 / 0.841. Evidence: docs/evidence/ff-46-sizeadjust-native-20261010.",
+        "sizeAdjustBasis": "opf#361 rule: the smallest factor (0.01 steps, up) at which no line of the FF-44 script corpus or of the scheme's Latin overhangs over 3 percent natively, regular and bold (DilleniaUPC 5.05 advances over Noto Sans Thai's, fontkit, read in place). Exact 0.6704; worst line thai-digits +1.6 percent; Latin slack 41.5 percent (Latin is drawn by the replacement at the composed size). Evidence: docs/evidence/ff-46-sizeadjust-native-20261010.",
         "measured": {
           "replacement": "Noto Sans Thai",
           "meanAbsWidthDelta": 0.7077,
@@ -1905,6 +1915,8 @@ var fontPolicySource = {
       "replacement": {
         "family": "Noto Sans KR",
         "compatibility": "visual",
+        "sizeAdjust": 1.07,
+        "sizeAdjustBasis": "opf#361 rule: the smallest factor (0.01 steps, up) at which no line of the FF-44 script corpus or of the scheme's Latin overhangs over 3 percent natively, regular and bold (Malgun Gothic 6.69 advances over Noto Sans KR's, fontkit, read in place). Exact 1.0557 on precomposed Hangul; worst line kore-sentence +1.6 percent at 1.07 (Hangul); latn-numerals +2.7 percent (Latin, at any factor); Latin slack 1.6 percent (Latin is drawn by the replacement at the composed size). Evidence: docs/evidence/ff-46-sizeadjust-native-20261010. Decomposed conjoining jamo (U+1100-11FF, U+A960-A97F, U+D7B0-D7FF; sample kore-jamo, 1.0669) is a documented limitation outside the row decision: PowerPoint draws it unshaped. No lineAscent: the native baseline is 1.06 em, below core's 1.0.",
         "measured": {
           "replacement": "Noto Sans KR",
           "meanAbsWidthDelta": 0.0176,
@@ -2195,6 +2207,11 @@ var fontPolicySource = {
       "replacement": {
         "family": "Noto Sans Devanagari",
         "compatibility": "visual",
+        "sizeAdjust": 1.07,
+        "lineAscent": 0.97,
+        "lineAscentMixed": 0.94,
+        "lineAscentBasis": "opf#361 native probe, PowerPoint 365 16.0 build 20430 (RR-38 setup, 2880 px; bottom edge of the last row with 35 percent of the darkest row's ink): Devanagari stem bottoms 0.981 / 0.972 / 0.969 em at 18 / 24 / 32 pt, with a Latin run 0.930 / 0.935 / 0.935. Evidence: docs/evidence/ff-46-sizeadjust-native-20261010.",
+        "sizeAdjustBasis": "opf#361 rule: the smallest factor (0.01 steps, up) at which no line of the FF-44 script corpus or of the scheme's Latin overhangs over 3 percent natively, regular and bold (Nirmala UI 1.46 advances over Noto Sans Devanagari's, fontkit, read in place). Exact 1.0695; worst line deva-matras +2.9 percent; Latin slack 6.0 percent (Latin is drawn by the replacement at the composed size). Evidence: docs/evidence/ff-46-sizeadjust-native-20261010.",
         "measured": {
           "replacement": "Noto Sans Devanagari",
           "meanAbsWidthDelta": 0.0638,
@@ -2901,6 +2918,11 @@ var fontPolicySource = {
       "replacement": {
         "family": "Noto Naskh Arabic",
         "compatibility": "visual",
+        "sizeAdjust": 0.89,
+        "lineAscent": 0.76,
+        "lineAscentMixed": 0.81,
+        "lineAscentBasis": "opf#361 native probe, PowerPoint 365 16.0 build 20430 (RR-38 setup, 2880 px; bottom edge of the last row with 35 percent of the darkest row's ink): 0.759 / 0.764 / 0.760 em at 18 / 24 / 32 pt, with a Latin run 0.819 / 0.810 / 0.810 (replaces the 0.78 read from 1280 px PNGs). Evidence: docs/evidence/ff-46-sizeadjust-native-20261010.",
+        "sizeAdjustBasis": "opf#361 rule: the smallest factor (0.01 steps, up) at which no line of the FF-44 script corpus or of the scheme's Latin overhangs over 3 percent natively, regular and bold (Sakkal Majalla 7.00 advances over Noto Naskh Arabic's, fontkit, read in place). Exact 0.8866; worst line arab-fa-digits +2.6 percent; Latin slack 35.1 percent (Latin is drawn by the replacement at the composed size). Evidence: docs/evidence/ff-46-sizeadjust-native-20261010.",
         "measured": {
           "replacement": "Noto Naskh Arabic",
           "meanAbsWidthDelta": 0.5423,

package/dist/{chunk-MSFE2HUK.js → chunk-FGUQHD37.js}

@@ -1,8 +1,8 @@
-import { Ctx, splitLines, lineRange, readYamlMapping, NOT_CHECKED, OPFMarkdownError, writeYaml, readCsv, DECIMAL, csvField, scalarText } from './chunk-R7KIASS4.js';
-import { parseQuoteLines, levelsFromIndents, parseCodeFence, splitWhen, fenceCode } from './chunk-PNINP5IF.js';
-import { same, isRecord, runText, isPlainRun, FORMATTING } from './chunk-TRELE6I6.js';
-import { validate } from './chunk-KA3ZPFVT.js';
-import { checkCatalogsOption } from './chunk-SPFV27O5.js';
+import { Ctx, splitLines, lineRange, readYamlMapping, NOT_CHECKED, OPFMarkdownError, writeYaml, readCsv, DECIMAL, csvField, scalarText } from './chunk-LRPSMQ62.js';
+import { parseQuoteLines, levelsFromIndents, parseCodeFence, splitWhen, fenceCode } from './chunk-YAHPQRVU.js';
+import { same, isRecord, runText, isPlainRun, FORMATTING } from './chunk-HBFRNOP4.js';
+import { validate } from './chunk-65GDO6TJ.js';
+import { checkCatalogsOption, PROMOTED_REGION_KEY } from './chunk-ZPCKGGI6.js';
 
 // src/markdown/canon.ts
 var FORMAT_KEYS = FORMATTING;
@@ -1340,10 +1340,11 @@ var SlideParser = class {
     set("tag", options.tag);
     set("title", this.title);
     set("subtitle", this.subtitle);
-    const content = this.blocks.filter((block) => block.options?.region === void 0);
-    const regions = this.blocks.filter((block) => block.options?.region !== void 0);
+    const promoted = (block) => typeof block.options?.region === "string" && PROMOTED_REGION_KEY.test(block.options.region);
+    const content = this.blocks.filter((block) => !promoted(block));
+    const regions = this.blocks.filter(promoted);
     const [only2] = content;
-    if (content.length === 1 && only2?.key !== void 0 && only2.options?.id === void 0 && only2.options?.type === void 0 && isContentKey(only2.key) && Object.keys(only2.payload).length === 1) {
+    if (content.length === 1 && only2?.key !== void 0 && only2.options?.id === void 0 && only2.options?.type === void 0 && only2.options?.region === void 0 && isContentKey(only2.key) && Object.keys(only2.payload).length === 1) {
       slide[only2.key] = only2.payload[only2.key];
       ctx.ranges.set(`${path}/${only2.key}`, only2.range);
     } else if (content.length) {
@@ -1352,6 +1353,7 @@ var SlideParser = class {
         const out = {};
         if (block.options?.id !== void 0) out.id = block.options.id;
         if (block.options?.type !== void 0) out.type = block.options.type;
+        if (block.options?.region !== void 0) out.region = block.options.region;
         return Object.assign(out, block.payload);
       });
     }
@@ -1596,7 +1598,7 @@ function nativeLines(key, canon, marker) {
 }
 function blockOptionsLine(spec, as) {
   const parts = [];
-  for (const [key, value] of [["id", spec.id], ["type", spec.type], ["as", as], ["region", spec.region]]) {
+  for (const [key, value] of [["id", spec.id], ["type", spec.type], ["as", as], ["region", spec.region ?? spec.pin]]) {
     if (value === void 0) continue;
     const text = typeof value === "string" ? optionValue(value) : void 0;
     if (text === void 0) return void 0;
@@ -1615,7 +1617,7 @@ function nativeBlock(spec, marker) {
     const all = options ? [options, ...lines] : lines;
     const { slide, clean } = parseSlideText(all.join("\n"));
     if (!slide || !clean) continue;
-    const target = spec.region !== void 0 ? slide[spec.region] : spec.id !== void 0 || spec.type !== void 0 ? slide.blocks?.[0] : slide;
+    const target = spec.region !== void 0 ? slide[spec.region] : spec.id !== void 0 || spec.type !== void 0 || spec.pin !== void 0 ? slide.blocks?.[0] : slide;
     if (target && same(target[spec.key], canon)) return all;
   }
   return void 0;
@@ -1695,9 +1697,10 @@ function emitSlide(slide, index, mode) {
     slide.blocks.forEach((block, i) => {
       const where = `${path}/blocks/${i}`;
       if (!isRecord(block)) return;
-      const keys = Object.keys(block).filter((key) => key !== "id" && key !== "type");
+      const pin = typeof block.region === "string" ? block.region : void 0;
+      const keys = Object.keys(block).filter((key) => key !== "id" && key !== "type" && !(key === "region" && pin !== void 0));
       const only3 = keys.length === 1 && isContent(keys[0]) ? keys[0] : void 0;
-      specs.push({ spec: { key: only3 ?? "", value: only3 ? block[only3] : void 0, id: block.id, type: block.type }, where, payload: block });
+      specs.push({ spec: { key: only3 ?? "", value: only3 ? block[only3] : void 0, id: block.id, type: block.type, ...pin !== void 0 ? { pin } : {} }, where, payload: block });
     });
     for (const key of CONTENT2) if (slide[key] !== void 0) extras[key] = slide[key];
   } else {
@@ -1716,7 +1719,7 @@ function emitSlide(slide, index, mode) {
     const lines2 = spec.key ? nativeBlock(spec, marker) : void 0;
     if (lines2) {
       sections.push({ lines: lines2 });
-      const written = { ...spec.id !== void 0 ? { id: spec.id } : {}, ...spec.type !== void 0 ? { type: spec.type } : {}, [spec.key]: canonContent(spec.key, spec.value) };
+      const written = { ...spec.id !== void 0 ? { id: spec.id } : {}, ...spec.type !== void 0 ? { type: spec.type } : {}, ...spec.pin !== void 0 ? { region: spec.pin } : {}, [spec.key]: canonContent(spec.key, spec.value) };
       if (spec.region !== void 0) exp[spec.region] = written;
       else expBlocks.push(written);
       const list = spec.key === "items" || spec.key === "bullets";

package/dist/{chunk-GVOLSWAJ.js → chunk-GRN3U5JT.js}

@@ -1,8 +1,8 @@
-import { fromMarkdown, toMarkdown } from './chunk-MSFE2HUK.js';
-import { fromYaml, toYaml } from './chunk-ECP7QPGK.js';
-import { NOT_CHECKED } from './chunk-R7KIASS4.js';
-import { parseSource, validate, OPFValidationError } from './chunk-KA3ZPFVT.js';
-import { checkCatalogsOption } from './chunk-SPFV27O5.js';
+import { fromMarkdown, toMarkdown } from './chunk-FGUQHD37.js';
+import { fromYaml, toYaml } from './chunk-SIQWYDFF.js';
+import { NOT_CHECKED } from './chunk-LRPSMQ62.js';
+import { parseSource, validate, OPFValidationError } from './chunk-65GDO6TJ.js';
+import { checkCatalogsOption } from './chunk-ZPCKGGI6.js';
 
 // src/deck-report.ts
 var DECK_FORMATS = ["json", "yaml", "markdown"];