@openpresentation/opf 0.18.4 → 0.20.1

package/dist/types.d.ts

@@ -1,5 +1,5 @@
-export { P as Presentation } from './presentation-81rNihF0.js';
-export { C as CatalogKind } from './catalog-refs-BSfGELpt.js';
+export { P as Presentation } from './presentation-B_e2Djga.js';
+export { b as CatalogKind } from './catalog-refs-CSHevLn1.js';
 export { SchemaName } from './schemas.js';
 export { a as Finding, d as FindingCategory, e as FindingFix, f as FindingFocus, b as FindingLocation, F as FindingReport, c as FindingSeverity, g as FindingSuggestion, J as JsonPatchOperation, V as ValidationIssue } from './finding-CT_f_vbD.js';
 import './json-BFSdESOE.js';
@@ -259,6 +259,35 @@ interface Theme {
      * Default slide size for this theme. Accepts the same preset values as design.dimensions.preset.
      */
     dimensions?: ("16:9" | "4:3" | "16:10" | "1:1" | "4:5" | "9:16" | "letter" | "a4" | "widescreen" | "standard");
+    /**
+     * The theme's design defaults (OPF 0.19), so a house style such as boxed content or centred titles is set once: the keys and values of the deck's design for titleAlignment, contentAlignment, contentBox, contentDirection, imageFit and listBullet. Per key the slide's design wins, then the deck's design, then this, then the layout record's design, then the engine default.
+     */
+    design?: {
+        /**
+         * As design.titleAlignment of a deck.
+         */
+        titleAlignment?: ("left" | "center" | "right");
+        /**
+         * As design.contentAlignment of a deck.
+         */
+        contentAlignment?: ("left" | "center" | "right");
+        /**
+         * As design.contentBox of a deck.
+         */
+        contentBox?: boolean;
+        /**
+         * As design.contentDirection of a deck.
+         */
+        contentDirection?: ("horizontal" | "vertical");
+        /**
+         * As design.imageFit of a deck.
+         */
+        imageFit?: ("cover" | "contain" | "stretch");
+        /**
+         * As design.listBullet of a deck.
+         */
+        listBullet?: ("character" | "image");
+    };
     /**
      * Free-form labels for filtering and search.
      */
@@ -299,21 +328,21 @@ interface ThemeBackground {
 }
 
 /**
- * Schema for slide-layout records. Each record describes a semantic slide layout: what regions it exposes, what content kinds those regions are intended to hold, how they are arranged (composition) and its design hints. Documents reference a layout from Slide.layout; a slide without a layout, or whose layout resolves nowhere, composes automatically.
+ * Schema for slide-layout records (OPF 0.19). A layout is a grid template: 'areas' names the cells of a grid using nested row arrays, 'columns' and 'rows' size its tracks, and 'regions' says, for every body area, which content kinds it takes and how several blocks share it. Slide content stays flat: engines bind a slide's blocks to the regions by reading order, role and kind (bindRegions in @openpresentation/opf), a block may pin itself to a region with 'region', and an empty region collapses into a neighbour. Built-in and custom layouts are records of this one schema; a custom layout is embedded under catalogs.custom.layouts or shipped in a catalog. Documents reference a layout from Slide.layout; a slide without a layout, with layout 'auto', or whose layout resolves nowhere composes automatically.
  *
  * A document references a record as a bare id or 'name:id' and resolves it in its own catalogs groups first, then in the catalog the host registered for the group's source; engines never fetch a catalog. A published record file carries '$schema' and 'id'; the copy a document embeds under catalogs.<group>.<kind>.<id> carries neither (the key is the id) and no 'x-*' display metadata.
  */
 interface Layout {
     /**
-     * Identifies a published record file as a layout record. Required in a published file; an embedded copy omits it.
+     * Identifies a published record file as a layout template. Required in a published file; an embedded copy omits it.
      */
-    $schema: "https://openpresentation.org/schema/opf-layout/v1";
+    $schema: "https://openpresentation.org/schema/opf-layout/v2";
     /**
-     * The layout's id in its catalog, lowercase kebab-case. Required in a published record file; a document references the record by it (a bare id, or 'name:id' for a named group) and embeds it keyed by it, without this field.
+     * The layout's id in its catalog, lowercase kebab-case. Required in a published record file; a document references the record by it (a bare id, or 'name:id' for a named group) and embeds it keyed by it, without this field. 'auto' is reserved: Slide.layout 'auto' is automatic composition, so no catalog may define a layout of that id.
      */
     id: string;
     /**
-     * Human-readable layout name shown in layout pickers.
+     * Human-readable layout name, shown in layout pickers and as the PowerPoint layout name.
      */
     name: string;
     /**
@@ -326,9 +355,36 @@ interface Layout {
     description?: string;
     design?: DesignHints;
     /**
-     * Ordered regions the layout exposes. This is the single source of truth for what the layout holds: the content kind, the number of body regions and whether it has a title, subtitle or tag are derived from it (layoutContent in @openpresentation/opf, which counts the leaves of placeholder groups), never stored separately. The engine fills 'title', 'subtitle' and 'tag' placeholders from Slide.title, Slide.subtitle and Slide.tag. The other placeholders are content-kind regions that composition uses to size the body and that pickers use to match layouts. An entry may instead be a placeholder group ({ "type": "group", "composition", "placeholders" }) that arranges its own regions inside one cell of this record's composition, so a record can say 'two stacked panels beside a chart' once; groups nest at most three levels. Slide content stays flat: its body payloads fill the leaf regions in reading order (depth first, in array order). Slide content itself lives either in root payload fields, blocks or promoted region keys on Slide. Chrome (slide number, footer, date) is not included here; it is owned by Design.header / Design.footer.
+     * The grid as nested arrays: each inner array is a row, each string is one cell, and a name repeated over adjacent cells spans them; '.' is an empty cell. Cells are lowercase names ([a-z][a-z0-9-]*) or '.', and every row has the same number of cells (at most 12 rows and 12 columns). A name's cells must form one filled rectangle. 'title' and 'subtitle' are heading areas: 'title' holds the slide's heading group (tag, title and subtitle, stacked) and a 'subtitle' area takes the subtitle out of it; they have no regions entry, and a 'subtitle' area needs a 'title' area. A layout with no 'title' area gets an implicit auto row on top for a slide that has headings. Every other name is a body region and needs an entry in 'regions'. The grid rules a schema cannot express are the validate finding opf/layout-template.
+     *
+     * @minItems 1
+     * @maxItems 12
+     */
+    areas: [[string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]] | [[string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]], [string, ...(string)[]]];
+    /**
+     * Relative column widths, one per cell of a row; the columns share the content width in proportion, separated by the gap. Omitted: all 1. Columns are numbers only.
+     *
+     * @minItems 1
+     * @maxItems 12
+     */
+    columns?: [number] | [number, number] | [number, number, number] | [number, number, number, number] | [number, number, number, number, number] | [number, number, number, number, number, number] | [number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number, number, number, number];
+    /**
+     * Relative row heights, one per string of 'areas'. 'auto' is the height the row's content needs at the starting text size (at most half the content box; areas that span several rows do not size it); the numeric rows share the rest in proportion. An auto row whose areas are all empty has no height. Omitted: all 1.
+     *
+     * @minItems 1
+     * @maxItems 12
+     */
+    rows?: [(number | "auto")] | [(number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")] | [(number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto"), (number | "auto")];
+    /**
+     * One entry per body area, keyed by the area's name. Region names may not be 'title', 'subtitle', 'tag', 'auto' or one of the promoted-region words ('left', 'center', 'right', 'top', 'middle', 'bottom'), so a Markdown block's region= option stays unambiguous. Region rules the schema cannot express (an area without a region, a region without an area, a reserved name) are the validate finding opf/layout-region.
+     */
+    regions?: {
+        [k: string]: Region;
+    };
+    /**
+     * The region where content that no region accepts goes, whatever its 'accepts', while it has room; content beyond every region's room is drawn there too, with the warning opf/layout-unplaced. Omitted: the first primary region (in reading order) whose flow is not 'none'.
      */
-    placeholders?: PlaceholderEntry[];
+    overflowRegion?: string;
     /**
      * Free-form labels for filtering and search.
      */
@@ -355,11 +411,11 @@ interface Layout {
     [k: string]: unknown;
 }
 /**
- * The layout's design hints, with the same keys and values as the deck's design and a slide's design (a slide overrides exactly what its layout sets, by the same name). An absent key means the layout has no opinion. Every key is applied from the record as the lowest-precedence default, per key: the slide's design, then the deck's design, then this record's design, then the engine default, so a layout value nobody overrides is honored without copying it anywhere (a layout's composition.mode still ranks above contentDirection). Composition, the renderer and the PPTX exporter all read the one result.
+ * The layout's design defaults, with the same keys and values as the deck's design and a slide's design (a slide overrides exactly what its layout sets, by the same name). An absent key means the layout has no opinion. Per key the slide's design wins, then the deck's design, then the resolved theme's design, then this record's design, then the engine default. Composition, the renderer and the PPTX exporter all read the one result.
  */
 interface DesignHints {
     /**
-     * Horizontal alignment of the title placeholder.
+     * Horizontal alignment of the title heading area.
      */
     titleAlignment?: ("left" | "center" | "right");
     /**
@@ -371,11 +427,11 @@ interface DesignHints {
      */
     contentBox?: boolean;
     /**
-     * Axis along which parallel body content is arranged: 'vertical' is a column, 'horizontal' a row. Composition applies it when neither the slide nor this layout's composition sets a mode, below the slide's and the deck's design.contentDirection and above automatic selection.
+     * Axis along which parallel body content is arranged: 'vertical' is a column, 'horizontal' a row. On a layout slide it turns every flowing region into one row or one column; the slide's own composition.mode, columns and weights rank above it.
      */
     contentDirection?: ("horizontal" | "vertical");
     /**
-     * Where the primary chart sits relative to the other body content. Composition applies it below the slide's and the deck's design.chartPrimary, with the semantics described there. It is shorthand for a placeholder group: a record can state the same structure explicitly as a root row or column of the chart and one PlaceholderGroup of the other regions, weighted 3:2.
+     * Where the primary chart sits relative to supporting content on automatic slides. Template layouts express this arrangement with their regions; chartPrimary does not override a template.
      */
     chartPrimary?: ("none" | "top" | "bottom" | "left" | "right");
     /**
@@ -386,31 +442,57 @@ interface DesignHints {
      * Marker style of lists: 'character' draws the glyph, 'image' draws the deck's icon logo as a picture bullet.
      */
     listBullet?: ("character" | "image");
+    /**
+     * Draw the layout mirrored: each row's cells and the column sizes reversed, so a 'beside' layout puts its picture, chart or table at the end. Logical: a right-to-left deck mirrors on top. Binding and reading order do not change.
+     */
+    mirror?: boolean;
 }
 /**
- * One entry of a layout's placeholders: a region (Placeholder) or, when its type is 'group', a placeholder group (PlaceholderGroup).
- *
- * This interface was referenced by `Layout`'s JSON-Schema
- * via the `definition` "PlaceholderEntry".
- */
-interface PlaceholderEntry {
-    [k: string]: unknown;
-}
-/**
- * Portable dynamic composition. Slide fields override the resolved layout. Nested groups (placeholder groups here, content groups in a slide) arrange their children independently, inheriting only minFontSize and overflow. Explicit promoted regions retain their positions.
+ * One body region of a layout: which content it takes and how several blocks share it.
  *
  * This interface was referenced by `Layout`'s JSON-Schema
- * via the `definition` "Composition".
+ * via the `definition` "Region".
  */
-interface Composition {
+interface Region {
+    /**
+     * Content kinds the region takes: the body content kinds, and 'group' for a content group of any content. A group is also accepted where every one of its leaf kinds is.
+     *
+     * @minItems 1
+     */
+    accepts: [("text" | "list" | "image" | "video" | "chart" | "table" | "code" | "metric" | "quote" | "timeline" | "group"), ...(("text" | "list" | "image" | "video" | "chart" | "table" | "code" | "metric" | "quote" | "timeline" | "group"))[]];
+    /**
+     * Which content the region wants first. Binding gives a picture (image, video) to a media region first, then primary, secondary, supporting; every other kind to a primary region first, then secondary, supporting, media; of two equal regions the first in reading order fills first. A supporting region receives content only when no primary or secondary region that accepts it has room, or by a pin. Default 'primary'.
+     */
+    role?: ("primary" | "secondary" | "media" | "supporting");
+    /**
+     * How several blocks share the region: 'none' one block fills it; 'grid' by count (1 fills, 2 side by side, 3 in a row, 4 as 2 x 2, 5 as 3 + 2, 6 as 3 x 2, 7 to 12 in four columns; rows and columns swap in a portrait region; a short last row is centred); 'column' stacked with equal heights; 'auto' a grid when every block is short and a column when any block is long (more than 6 estimated lines in its grid cell at the starting size). design.contentDirection turns every flowing region into one row or one column. Default 'auto'.
+     */
+    flow?: ("none" | "grid" | "column" | "auto");
+    /**
+     * Blocks the region holds on one slide. Default 1 for flow 'none' (which requires 1), else 6. Content beyond every region's room is drawn in the overflow region with the warning opf/layout-unplaced, and paginate moves it to a continuation slide.
+     */
+    max?: number;
+    /**
+     * The region's outer edges that lie on the content box's edge extend to the slide edge, as a placed image does. A bled region is never drawn as a card. Default false.
+     */
+    bleed?: boolean;
+    /**
+     * 'auto': a list in the region that does not fit its cell at the starting size (a lone list, or one of several blocks) flows into up to three columns before it shrinks, as a list payload's columns: 'auto'. Default 1.
+     */
+    listColumns?: ("auto" | 1);
     /**
-     * auto chooses a grid from available space and content; grid uses columns; row and column use one horizontal or vertical track.
+     * Vertical position of the region's content when it is shorter than the region. Default 'top'.
      */
-    mode?: ("auto" | "grid" | "row" | "column");
+    anchor?: ("top" | "middle" | "bottom");
     /**
-     * Column count for grid. In auto mode this caps the number of columns.
+     * What the region does on a slide that gives it no content: 'collapse' (default) joins its cells to a neighbouring area that shares the full length of one of its edges and is not itself empty; 'keep' leaves the space.
      */
-    columns?: number;
+    empty?: ("collapse" | "keep");
+}
+/**
+ * Only 'gap', 'padding', 'minFontSize' and 'overflow', with their 0.18 meaning. A template's regions replace composition.mode, columns and weights.
+ */
+interface Composition {
     /**
      * Space between cells as a fraction of the container short edge (canvas at slide root). Default 0.03333333333333333.
      */
@@ -419,13 +501,6 @@ interface Composition {
      * Inset as a fraction of the container short edge. Default 0.08 on a slide, 0 inside a group.
      */
     padding?: number;
-    /**
-     * Relative track sizes: columns for row/grid/auto, rows for column. Omitted tracks have weight 1; extra weights are ignored.
-     *
-     * @minItems 1
-     * @maxItems 12
-     */
-    weights?: [number] | [number, number] | [number, number, number] | [number, number, number, number] | [number, number, number, number, number] | [number, number, number, number, number, number] | [number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number, number, number, number];
     /**
      * Minimum readable text size in reference pixels at a 720-pixel canvas short edge. Default 16. Overflow is diagnosed when text cannot fit at this size.
      */
@@ -437,7 +512,7 @@ interface Composition {
 }
 
 /**
- * Schema for chart-type records: display metadata for chart pickers (name, group, expected series, complexity) and the Open XML mapping a picker can describe. One record per chart type that Aspose.Slides officially supports (see mappings.renderers["aspose-slides"].chartType), plus the column-and-line combination 'combo'. A document's chart.type is an engine vocabulary validated directly; engines never look a chart-type record up. pptx.gallery publishes these records and @openpresentation/opf/catalog ships them as catalogDisplay.chartTypes.
+ * Schema for chart-type records: display metadata for chart pickers (name, group, expected series, complexity) and the Open XML mapping a picker can describe. One record per chart type that Aspose.Slides officially supports (see mappings.renderers["aspose-slides"].chartType), plus the column-and-line combination 'combo'. A document's chart.type is an engine vocabulary validated directly; engines never look a chart-type record up. pptx.gallery publishes these records and @openpresentation/gallery ships them as catalogDisplay.chartTypes.
  */
 interface ChartType {
     /**
@@ -500,7 +575,7 @@ interface ChartType {
         [k: string]: unknown;
     };
     /**
-     * Publisher extension member, such as the `x-gallery` presentation metadata that pptx.gallery adds to the records it publishes. Engines and validators ignore top-level `x-*` members, and the pinned snapshot in spec/catalogs never carries them.
+     * Publisher extension member, such as the `x-gallery` presentation metadata that pptx.gallery adds to the records it publishes. Engines and validators ignore top-level `x-*` members, and the pinned snapshot in @openpresentation/gallery never carries them.
      *
      * This interface was referenced by `ChartType`'s JSON-Schema definition
      * via the `patternProperty` "^x-".
@@ -741,7 +816,7 @@ interface Beat {
 }
 
 /**
- * Schema for social-platform records: display metadata for authoring UIs (name, brand color, handle example) alongside the URL patterns. The keys of a Socials object are an engine vocabulary validated directly; engines link a handle with the patterns in spec/reference/engine-vocabularies.json and never look a social-platform record up. pptx.gallery publishes these records and @openpresentation/opf/catalog ships them as catalogDisplay.socialPlatforms.
+ * Schema for social-platform records: display metadata for authoring UIs (name, brand color, handle example) alongside the URL patterns. The keys of a Socials object are an engine vocabulary validated directly; engines link a handle with the patterns in spec/reference/engine-vocabularies.json and never look a social-platform record up. pptx.gallery publishes these records and @openpresentation/gallery ships them as catalogDisplay.socialPlatforms.
  */
 interface SocialPlatform {
     /**
@@ -814,7 +889,7 @@ interface SocialPlatform {
 }
 
 /**
- * Schema for language records: display metadata for the language pickers of authoring tools (name, ISO code, the default font schemes a picker suggests). The document's 'language' is an engine vocabulary, a BCP-47 tag validated directly; engines never look a language record up, and their script, direction, OOXML tag and default script fonts come from spec/reference/engine-vocabularies.json. pptx.gallery publishes these records and @openpresentation/opf/catalog ships them as catalogDisplay.languages.
+ * Schema for language records: display metadata for the language pickers of authoring tools (name, ISO code, the default font schemes a picker suggests). The document's 'language' is an engine vocabulary, a BCP-47 tag validated directly; engines never look a language record up, and their script, direction, OOXML tag and default script fonts come from spec/reference/engine-vocabularies.json. pptx.gallery publishes these records and @openpresentation/gallery ships them as catalogDisplay.languages.
  */
 interface Language {
     /**

package/dist/{validation-types-PbGDrNUr.d.ts → validation-types-DtN8X_HZ.d.ts}

@@ -1,5 +1,5 @@
-import { a as Catalog } from './catalog-refs-BSfGELpt.js';
-import { T as TextMeasurement } from './composition-C-OoqvAr.js';
+import { C as Catalog } from './catalog-refs-CSHevLn1.js';
+import { T as TextMeasurement } from './composition-MFjGwuN_.js';
 import { c as FindingSeverity, F as FindingReport } from './finding-CT_f_vbD.js';
 import { J as JsonPrimitive } from './json-BFSdESOE.js';
 

package/dist/validator-1d29Z3YY.d.ts

@@ -0,0 +1,73 @@
+import { b as CatalogKind } from './catalog-refs-CSHevLn1.js';
+import { SchemaName } from './schemas.js';
+import { a as Finding } from './finding-CT_f_vbD.js';
+import { P as Presentation } from './presentation-B_e2Djga.js';
+import { b as ValidationThresholds, c as ValidationRuleInfo, V as ValidationReport, a as ValidateOptions } from './validation-types-DtN8X_HZ.js';
+
+/**
+ * RR-78: the version of the catalog record schemas (spec/schemas/<kind>.schema.json) this core reads. A catalog package
+ * declares the version its records target (`opf.catalogSchema` in its package.json, `CATALOG_SCHEMA` in its exports, as
+ * @openpresentation/gallery does); the Node defaults refuse a gallery that targets another one. A record schema change that
+ * old records no longer validate against raises it.
+ */
+declare const CATALOG_SCHEMA = 3;
+/** Kinds of catalog display metadata: published by catalogs for pickers, never referenced by documents. */
+declare const catalogDisplayKinds: readonly ["chartTypes", "languages", "socialPlatforms"];
+type CatalogDisplayKind = (typeof catalogDisplayKinds)[number];
+/** Every kind of record a catalog publishes: the content kinds documents reference, and the display kinds. */
+type CatalogRecordKind = CatalogKind | CatalogDisplayKind;
+/** The companion schema each catalog record kind validates against. */
+declare const catalogSchemaNames: Readonly<Record<CatalogRecordKind, SchemaName>>;
+
+/**
+ * The series palette opf-render and opf-pptx draw charts with (`CHART_COLORS`), in series order. A host with
+ * its own palette passes `ValidateOptions.chartPalette`.
+ */
+declare const DEFAULT_CHART_PALETTE: readonly string[];
+
+/**
+ * The rule registry: every rule `validate` can report, with its category, default severity, cost, rationale and the
+ * standard it follows. The format, references and policy rules are produced by the schema and reference checks; the
+ * accessibility, layout and content rules are implemented in `rules-*.ts`. Each rule has a stable `opf/<name>` id.
+ */
+declare const DEFAULT_VALIDATION_THRESHOLDS: Readonly<ValidationThresholds>;
+/**
+ * Every rule `validate` can report, with its category, default severity, cost, rationale and approximations, ordered by
+ * category (format, references, policy, accessibility, layout, content) and, within one, in report order.
+ */
+declare const validationRules: readonly ValidationRuleInfo[];
+/** The rule a full id (`opf/text-contrast`) or bare name (`text-contrast`) names, or undefined. */
+declare function findValidationRule(name: string): ValidationRuleInfo | undefined;
+
+declare const promotedRegionKeys: readonly ["left", "center", "right", "left+center", "center+right", "left+center+right", "top", "middle", "bottom", "top+middle", "middle+bottom", "top+middle+bottom", "top:left", "top:center", "top:right", "top:left+center", "top:center+right", "top:left+center+right", "middle:left", "middle:center", "middle:right", "middle:left+center", "middle:center+right", "middle:left+center+right", "bottom:left", "bottom:center", "bottom:right", "bottom:left+center", "bottom:center+right", "bottom:left+center+right", "top+middle:left", "top+middle:center", "top+middle:right", "top+middle:left+center", "top+middle:center+right", "top+middle:left+center+right", "middle+bottom:left", "middle+bottom:center", "middle+bottom:right", "middle+bottom:left+center", "middle+bottom:center+right", "middle+bottom:left+center+right", "top+middle+bottom:left", "top+middle+bottom:center", "top+middle+bottom:right", "top+middle+bottom:left+center", "top+middle+bottom:center+right", "top+middle+bottom:left+center+right"];
+
+declare class OPFValidationError extends Error {
+    /** The full report that failed. */
+    readonly report: ValidationReport;
+    /** The error-severity findings of the report. */
+    readonly findings: Finding[];
+    constructor(report: ValidationReport);
+}
+/**
+ * Check a presentation. `input` is a parsed presentation (an object) or the text of one, which is read as strict JSON and nothing
+ * else: syntax errors and duplicate keys come back with line and column, and findings carry the range of the value they are
+ * about. YAML and Markdown go through `fromYaml` and `fromMarkdown`, which call this for you.
+ *
+ * Never throws for a bad document, only for bad options (a `TypeError` naming the unknown rule, threshold or option, so a
+ * typo cannot silently disable a check).
+ */
+declare function validate(input: unknown, options?: ValidateOptions): ValidationReport;
+/**
+ * Throw `OPFValidationError` (carrying the `report`) unless `validate(value, options)` is valid; afterwards TypeScript
+ * knows `value` is a `Presentation`. It takes a parsed value, not text. Pass `{ only: ['format'] }` for the cheap check.
+ */
+declare function assertValid(value: unknown, options?: ValidateOptions): asserts value is Presentation;
+/**
+ * Check one published catalog record file (an audience, theme, layout, font scheme, chart type and so on) against its
+ * companion schema, `$schema` and `id` included. The report has the same shape as `validate`'s; every finding is `format`.
+ * A record a document embeds is checked by `validate`, keyed by its id and without `$schema`.
+ */
+declare function validateCatalogRecord(kind: CatalogRecordKind, value: unknown): ValidationReport;
+declare function assertValidCatalogRecord(kind: CatalogRecordKind, value: unknown): void;
+
+export { CATALOG_SCHEMA as C, DEFAULT_CHART_PALETTE as D, OPFValidationError as O, type CatalogDisplayKind as a, type CatalogRecordKind as b, DEFAULT_VALIDATION_THRESHOLDS as c, assertValid as d, assertValidCatalogRecord as e, catalogDisplayKinds as f, catalogSchemaNames as g, findValidationRule as h, validateCatalogRecord as i, validationRules as j, promotedRegionKeys as p, validate as v };

package/dist/validator.d.ts

@@ -1,63 +1,9 @@
-import { a as CatalogRecordKind } from './catalog-schemas-CinPh5WA.js';
-import { a as Finding } from './finding-CT_f_vbD.js';
-import { P as Presentation } from './presentation-81rNihF0.js';
-import { b as ValidationThresholds, c as ValidationRuleInfo, V as ValidationReport, a as ValidateOptions } from './validation-types-PbGDrNUr.js';
-export { C as Contract, d as ValidateFonts, e as ValidationCategory, f as ValidationChecks, g as ValidationRuleCost, v as validationCategories } from './validation-types-PbGDrNUr.js';
-import './catalog-refs-BSfGELpt.js';
+export { D as DEFAULT_CHART_PALETTE, c as DEFAULT_VALIDATION_THRESHOLDS, O as OPFValidationError, d as assertValid, e as assertValidCatalogRecord, h as findValidationRule, p as promotedRegionKeys, v as validate, i as validateCatalogRecord, j as validationRules } from './validator-1d29Z3YY.js';
+import './finding-CT_f_vbD.js';
+import './presentation-B_e2Djga.js';
+export { C as Contract, d as ValidateFonts, a as ValidateOptions, e as ValidationCategory, f as ValidationChecks, V as ValidationReport, g as ValidationRuleCost, c as ValidationRuleInfo, b as ValidationThresholds, v as validationCategories } from './validation-types-DtN8X_HZ.js';
+import './catalog-refs-CSHevLn1.js';
 import './schemas.js';
 import './json-BFSdESOE.js';
-import './composition-C-OoqvAr.js';
+import './composition-MFjGwuN_.js';
 import './chart-data-BnNqgnC-.js';
-
-/**
- * The series palette opf-render and opf-pptx draw charts with (`CHART_COLORS`), in series order. A host with
- * its own palette passes `ValidateOptions.chartPalette`.
- */
-declare const DEFAULT_CHART_PALETTE: readonly string[];
-
-/**
- * The rule registry: every rule `validate` can report, with its category, default severity, cost, rationale and the
- * standard it follows. The format, references and policy rules are produced by the schema and reference checks; the
- * accessibility, layout and content rules are implemented in `rules-*.ts`. Each rule has a stable `opf/<name>` id.
- */
-declare const DEFAULT_VALIDATION_THRESHOLDS: Readonly<ValidationThresholds>;
-/**
- * Every rule `validate` can report, with its category, default severity, cost, rationale and approximations, ordered by
- * category (format, references, policy, accessibility, layout, content) and, within one, in report order.
- */
-declare const validationRules: readonly ValidationRuleInfo[];
-/** The rule a full id (`opf/text-contrast`) or bare name (`text-contrast`) names, or undefined. */
-declare function findValidationRule(name: string): ValidationRuleInfo | undefined;
-
-declare const promotedRegionKeys: readonly ["left", "center", "right", "left+center", "center+right", "left+center+right", "top", "middle", "bottom", "top+middle", "middle+bottom", "top+middle+bottom", "top:left", "top:center", "top:right", "top:left+center", "top:center+right", "top:left+center+right", "middle:left", "middle:center", "middle:right", "middle:left+center", "middle:center+right", "middle:left+center+right", "bottom:left", "bottom:center", "bottom:right", "bottom:left+center", "bottom:center+right", "bottom:left+center+right", "top+middle:left", "top+middle:center", "top+middle:right", "top+middle:left+center", "top+middle:center+right", "top+middle:left+center+right", "middle+bottom:left", "middle+bottom:center", "middle+bottom:right", "middle+bottom:left+center", "middle+bottom:center+right", "middle+bottom:left+center+right", "top+middle+bottom:left", "top+middle+bottom:center", "top+middle+bottom:right", "top+middle+bottom:left+center", "top+middle+bottom:center+right", "top+middle+bottom:left+center+right"];
-
-declare class OPFValidationError extends Error {
-    /** The full report that failed. */
-    readonly report: ValidationReport;
-    /** The error-severity findings of the report. */
-    readonly findings: Finding[];
-    constructor(report: ValidationReport);
-}
-/**
- * Check a presentation. `input` is a parsed presentation (an object) or the text of one, which is read as strict JSON and nothing
- * else: syntax errors and duplicate keys come back with line and column, and findings carry the range of the value they are
- * about. YAML and Markdown go through `fromYaml` and `fromMarkdown`, which call this for you.
- *
- * Never throws for a bad document, only for bad options (a `TypeError` naming the unknown rule, threshold or option, so a
- * typo cannot silently disable a check).
- */
-declare function validate(input: unknown, options?: ValidateOptions): ValidationReport;
-/**
- * Throw `OPFValidationError` (carrying the `report`) unless `validate(value, options)` is valid; afterwards TypeScript
- * knows `value` is a `Presentation`. It takes a parsed value, not text. Pass `{ only: ['format'] }` for the cheap check.
- */
-declare function assertValid(value: unknown, options?: ValidateOptions): asserts value is Presentation;
-/**
- * Check one published catalog record file (an audience, theme, layout, font scheme, chart type and so on) against its
- * companion schema, `$schema` and `id` included. The report has the same shape as `validate`'s; every finding is `format`.
- * A record a document embeds is checked by `validate`, keyed by its id and without `$schema`.
- */
-declare function validateCatalogRecord(kind: CatalogRecordKind, value: unknown): ValidationReport;
-declare function assertValidCatalogRecord(kind: CatalogRecordKind, value: unknown): void;
-
-export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, ValidateOptions, ValidationReport, ValidationRuleInfo, ValidationThresholds, assertValid, assertValidCatalogRecord, findValidationRule, promotedRegionKeys, validate, validateCatalogRecord, validationRules };

package/dist/validator.js

@@ -1,5 +1,3 @@
-export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-KA3ZPFVT.js';
-export { promotedRegionKeys } from './chunk-MBU42S5Y.js';
-import './chunk-TRDXRRQK.js';
-import './chunk-SPFV27O5.js';
-import './chunk-2PEWUUBR.js';
+export { DEFAULT_CHART_PALETTE, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-7QUAOKS6.js';
+export { promotedRegionKeys } from './chunk-UAXSW6VV.js';
+import './chunk-VEHLQVGQ.js';

package/dist/yaml.d.ts

@@ -1,8 +1,8 @@
-import { a as Catalog } from './catalog-refs-BSfGELpt.js';
-import { P as Presentation } from './presentation-81rNihF0.js';
-import { a as ValidateOptions, V as ValidationReport } from './validation-types-PbGDrNUr.js';
+import { C as Catalog } from './catalog-refs-CSHevLn1.js';
+import { P as Presentation } from './presentation-B_e2Djga.js';
+import { a as ValidateOptions, V as ValidationReport } from './validation-types-DtN8X_HZ.js';
 import { a as Finding, b as FindingLocation } from './finding-CT_f_vbD.js';
-import './composition-C-OoqvAr.js';
+import './composition-MFjGwuN_.js';
 import './chart-data-BnNqgnC-.js';
 import './json-BFSdESOE.js';
 

package/dist/yaml.js

@@ -1,9 +1,7 @@
-export { OPFYamlError, YAML_SCHEMA_URL, fromYaml, parseYamlData, scanYamlComments, toYaml } from './chunk-ECP7QPGK.js';
-import './chunk-R7KIASS4.js';
-import './chunk-JCOSZTOI.js';
-import './chunk-TRELE6I6.js';
-import './chunk-KA3ZPFVT.js';
-import './chunk-MBU42S5Y.js';
-import './chunk-TRDXRRQK.js';
-import './chunk-SPFV27O5.js';
-import './chunk-2PEWUUBR.js';
+export { OPFYamlError, YAML_SCHEMA_URL, fromYaml, parseYamlData, scanYamlComments, toYaml } from './chunk-4FBXVST6.js';
+import './chunk-P6LMWUXV.js';
+import './chunk-32MHL3B3.js';
+import './chunk-ZU5EQ23T.js';
+import './chunk-7QUAOKS6.js';
+import './chunk-UAXSW6VV.js';
+import './chunk-VEHLQVGQ.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openpresentation/opf",
-  "version": "0.18.4",
-  "description": "Canonical Open Presentation Format schemas, TypeScript types, local validation and composition; the pinned default catalog ships as the opt-in @openpresentation/opf/catalog.",
+  "version": "0.20.1",
+  "description": "Canonical Open Presentation Format schemas, TypeScript types, local validation and composition; in Node, the file API and the CLI defaults register the pptx.gallery catalog of @openpresentation/gallery.",
   "license": "MIT",
   "author": "Open Presentation",
   "homepage": "https://openpresentation.org",
@@ -44,10 +44,6 @@
       "types": "./dist/schemas.d.ts",
       "import": "./dist/schemas.js"
     },
-    "./catalog": {
-      "types": "./dist/catalog.d.ts",
-      "import": "./dist/catalog.js"
-    },
     "./validator": {
       "types": "./dist/validator.d.ts",
       "import": "./dist/validator.js"
@@ -138,7 +134,7 @@
   },
   "scripts": {
     "clean": "rm -rf dist src/generated",
-    "generate": "node scripts/generate.mjs && node scripts/generate-previews.mjs && node scripts/generate-content.mjs",
+    "generate": "node scripts/generate.mjs && node scripts/generate-content.mjs",
     "build": "node ../../scripts/reuse-build.mjs check || (pnpm run generate && tsup && node scripts/copy-spec.mjs && node ../../scripts/reuse-build.mjs stamp)",
     "typecheck": "pnpm run generate && node ../../scripts/typecheck.mjs --noEmit",
     "test": "pnpm run build && node ../../scripts/run-tests.mjs",
@@ -146,6 +142,7 @@
     "pack:dry-run": "pnpm run build && npm pack --dry-run --cache /tmp/opf-npm-cache"
   },
   "dependencies": {
+    "@openpresentation/gallery": "^3.0.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "jsonc-parser": "3.3.1",
@@ -160,8 +157,8 @@
     "@expo-google-fonts/roboto": "0.4.3",
     "@expo-google-fonts/roboto-mono": "0.4.2",
     "@expo-google-fonts/tinos": "0.4.2",
-    "@openpresentation/opf-pptx": "0.18.0",
-    "@openpresentation/opf-render": "0.18.0",
+    "@openpresentation/opf-pptx": "0.19.0",
+    "@openpresentation/opf-render": "0.19.1",
     "@resvg/resvg-js": "2.6.2",
     "@types/node": "^24.13.4",
     "json-schema-to-typescript": "^16.0.0",
@@ -171,8 +168,8 @@
     "typescript": "~5.9.3"
   },
   "peerDependencies": {
-    "@openpresentation/opf-pptx": "^0.18.0",
-    "@openpresentation/opf-render": "^0.18.0"
+    "@openpresentation/opf-pptx": "^0.20.0",
+    "@openpresentation/opf-render": "^0.20.0"
   },
   "peerDependenciesMeta": {
     "@openpresentation/opf-pptx": {

package/dist/catalog-schemas-CinPh5WA.d.ts

@@ -1,12 +0,0 @@
-import { C as CatalogKind } from './catalog-refs-BSfGELpt.js';
-import { SchemaName } from './schemas.js';
-
-/** Kinds of catalog display metadata: published by catalogs for pickers, never referenced by documents. */
-declare const catalogDisplayKinds: readonly ["chartTypes", "languages", "socialPlatforms"];
-type CatalogDisplayKind = (typeof catalogDisplayKinds)[number];
-/** Every kind of record a catalog publishes: the content kinds documents reference, and the display kinds. */
-type CatalogRecordKind = CatalogKind | CatalogDisplayKind;
-/** The companion schema each catalog record kind validates against. */
-declare const catalogSchemaNames: Readonly<Record<CatalogRecordKind, SchemaName>>;
-
-export { type CatalogDisplayKind as C, type CatalogRecordKind as a, catalogSchemaNames as b, catalogDisplayKinds as c };