@openpresentation/opf 0.14.0 → 0.16.0

package/dist/{presentation-C5eHkevA.d.ts → presentation-COrFuj2g.d.ts}

@@ -1,12 +1,12 @@
 /**
- * Inline audience metadata for the presentation. Use 'id' to reference an audiences catalog record and override selected fields, or use 'name' for a custom inline audience.
+ * Inline audience metadata for the presentation. Use 'id' to reference an audiences record (a bare id or 'name:id') and override selected fields, or use 'name' for a custom inline audience.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Audience".
  */
 type Audience = (Audience1 & {
     /**
-     * Optional audiences catalog id to resolve before applying inline overrides.
+     * Optional audiences reference (a bare id or 'name:id') resolved before applying the inline overrides.
      */
     id?: string;
     /**
@@ -38,11 +38,11 @@ type Audience = (Audience1 & {
      */
     attentionBudgetMinutes?: number;
     /**
-     * Soft cross-link: narrative-catalog ids that work well for this audience.
+     * Soft cross-link: narrative ids that work well for this audience, for picker UIs. Never resolved, embedded or validated as references.
      */
     recommendedNarratives?: string[];
     /**
-     * Soft cross-link: tone-catalog ids that work well for this audience.
+     * Soft cross-link: tone ids that work well for this audience, for picker UIs. Never resolved, embedded or validated as references.
      */
     recommendedTones?: string[];
     /**
@@ -55,14 +55,14 @@ type Audience1 = {
     [k: string]: unknown;
 };
 /**
- * Inline purpose metadata for the presentation. Use 'id' to reference a purposes catalog record and override selected fields, or use 'name' for a custom inline purpose.
+ * Inline purpose metadata for the presentation. Use 'id' to reference a purposes record (a bare id or 'name:id') and override selected fields, or use 'name' for a custom inline purpose.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Purpose".
  */
 type Purpose = (Purpose1 & {
     /**
-     * Optional purposes catalog id to resolve before applying inline overrides.
+     * Optional purposes reference (a bare id or 'name:id') resolved before applying the inline overrides.
      */
     id?: string;
     /**
@@ -86,11 +86,11 @@ type Purpose = (Purpose1 & {
      */
     successCriteria?: string[];
     /**
-     * Soft cross-link: narrative-catalog ids that work well for this purpose.
+     * Soft cross-link: narrative ids that work well for this purpose, for picker UIs. Never resolved, embedded or validated as references.
      */
     recommendedNarratives?: string[];
     /**
-     * Soft cross-link: tone-catalog ids that work well for this purpose.
+     * Soft cross-link: tone ids that work well for this purpose, for picker UIs. Never resolved, embedded or validated as references.
      */
     recommendedTones?: string[];
     /**
@@ -103,74 +103,28 @@ type Purpose1 = {
     [k: string]: unknown;
 };
 /**
- * Inline language metadata for the presentation. Use 'id' to reference a languages catalog record and override selected fields, or use 'bcp47' for a custom language tag without a catalog record.
+ * A BCP-47 language tag ('en-US', 'ja', 'zh-Hans', 'sr-Latn-ME'), an engine vocabulary. Use 'en-GB' for UK English; 'en-UK' is not a valid region.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "Language".
+ * via the `definition` "LanguageTag".
  */
-type Language = (Language1 & {
-    /**
-     * Optional languages catalog id to resolve before applying inline overrides.
-     */
-    id?: string;
-    /**
-     * Human-readable language name.
-     */
-    name?: string;
-    /**
-     * BCP-47 language tag used for locale-aware rendering, proofing, and accessibility metadata. Use 'en-GB' for UK English; 'en-UK' is not a valid BCP-47 region form.
-     */
-    bcp47?: string;
-    /**
-     * Curated culture tag for OOXML text-run language attributes (a:rPr/@lang, a:endParaRPr/@lang), in the language-[Script-]REGION form Office recognizes (e.g. 'ja-JP', 'ar-SA', 'ms-MY', 'nb-NO', 'fil-PH', 'zh-CN'). Engines emit it instead of 'bcp47' when the document names the language by catalog id or by a tag without a region; a region-bearing tag written by the author is emitted as written. Curated rather than inferred so output does not depend on the runtime's locale data.
-     */
-    ooxmlLang?: string;
-    /**
-     * ISO 639-3 or 639-2 language code carried for engines that prefer ISO codes.
-     */
-    code?: string;
-    /**
-     * Base text direction for the language. When omitted, engines derive it from the script: Arabic (Arab), Hebrew (Hebr), Syriac (Syrc), Thaana (Thaa), N'Ko (Nkoo), Adlam (Adlm), Samaritan (Samr), Mandaic (Mand) and Hanifi Rohingya (Rohg) are right-to-left; every other script is left-to-right. Bundled language records state it explicitly.
-     */
-    direction?: ("ltr" | "rtl");
-    /**
-     * ISO 15924 script code of the language's writing system. The script selects the OOXML font slot the language's text uses: East Asian scripts (Hans, Hant, Hani, Jpan, Kore, Hang, Hira, Kana, Bopo, Yiii) use the eastAsian slot; complex scripts (for example Arab, Hebr, Syrc, Thaa, Deva, Beng, Guru, Gujr, Orya, Taml, Telu, Knda, Mlym, Sinh, Thai, Laoo, Tibt, Mymr, Khmr, Mong) use the complexScript slot; every other script (Latn, Cyrl, Grek, Armn, Geor, Ethi, ...) uses the latin slot. When omitted, engines infer it from the BCP-47 tag. Bundled language records state it explicitly. See docs/programs/font-fidelity-everywhere/script-font-model.md.
-     */
-    script?: string;
-    /**
-     * Default font-scheme id for this language when targeting PowerPoint output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does. Its major/minor families fill the language's script slot (eastAsian or complexScript, chosen by 'script') unless the effective design font scheme sets that slot itself; the latin slot always follows the design font scheme.
-     */
-    fontScheme?: string;
-    /**
-     * Default font-scheme id for this language when targeting Google Slides output. Resolves against catalogs.fontSchemes the same way design.fontScheme or design.fontScheme.id does. Used in place of 'fontScheme' when resolving script fonts for Google Slides output.
-     */
-    googleFontScheme?: string;
-    /**
-     * One-sentence note about coverage or font defaults.
-     */
-    summary?: string;
-    /**
-     * Longer prose describing the language record and any font-pairing rationale.
-     */
-    description?: string;
-    /**
-     * Free-form labels for filtering and search.
-     */
-    tags?: string[];
-    [k: string]: unknown;
-});
-type Language1 = {
-    [k: string]: unknown;
-};
+type LanguageTag = string;
 /**
- * Inline tone metadata for the presentation. Use 'id' to reference a tones catalog record and override selected fields, or use 'name' for a custom inline tone.
+ * A content reference: a bare id ('two-column') or 'name:id' ('acme:hero'), where the prefix names a group of 'catalogs'. URLs and 'pkg:' strings are not references; a named catalog group replaces them. See Catalogs for the resolution order.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "CatalogReference".
+ */
+type CatalogReference = string;
+/**
+ * Inline tone metadata for the presentation. Use 'id' to reference a tones record (a bare id or 'name:id') and override selected fields, or use 'name' for a custom inline tone.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Tone".
  */
 type Tone = (Tone1 & {
     /**
-     * Optional tones catalog id to resolve before applying inline overrides.
+     * A content reference: a bare id ('two-column') or 'name:id' ('acme:hero'), where the prefix names a group of 'catalogs'. URLs and 'pkg:' strings are not references; a named catalog group replaces them. See Catalogs for the resolution order.
      */
     id?: string;
     /**
@@ -198,7 +152,7 @@ type Tone = (Tone1 & {
      */
     samplePhrases?: string[];
     /**
-     * Soft cross-link: narrative-catalog ids this tone pairs well with.
+     * Soft cross-link: narrative ids this tone pairs well with, for picker UIs. Never resolved, embedded or validated as references.
      */
     recommendedNarratives?: string[];
     /**
@@ -211,12 +165,19 @@ type Tone1 = {
     [k: string]: unknown;
 };
 /**
- * String shorthand for a background. Theme slots ('light1', 'light2', 'dark1', 'dark2') are equivalent to { type: 'theme', slot: value }; hex colors are equivalent to { type: 'solid', color: value }.
+ * Named dimension preset; chooses both aspect ratio and physical size. 'widescreen' is an alias for 16:9 in PowerPoint widescreen size; 'standard' is an alias for 4:3 in PowerPoint standard size. The social-feed ratios keep the widescreen short edge of 7.5 in: 1:1 is 7.5 x 7.5 in, 4:5 is 7.5 x 9.375 in and 9:16 is 7.5 x 13.333 in (portrait).
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "DimensionPreset".
+ */
+type DimensionPreset = ("16:9" | "4:3" | "16:10" | "1:1" | "4:5" | "9:16" | "letter" | "a4" | "widescreen" | "standard");
+/**
+ * String shorthand for a background. Theme slots ('light1', 'light2', 'dark1', 'dark2') are equivalent to { type: 'theme', slot: value }; hex colors are equivalent to { type: 'solid', color: value }; an image source (starting with 'asset:', 'https://', 'data:', './' or '../') is equivalent to { type: 'image', src: value }, a cover image. Any other string is invalid.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "BackgroundShortcut".
  */
-type BackgroundShortcut = (ThemeBackgroundSlot | HexColor);
+type BackgroundShortcut = (ThemeBackgroundSlot | HexColor | ImageSource);
 /**
  * PowerPoint theme-controlled slide background slot from the active color scheme. These are slots, not assumptions about actual colors: light1 is usually white and dark1 is usually black by convention, but the color scheme controls the real values.
  *
@@ -232,19 +193,19 @@ type ThemeBackgroundSlot = ("light1" | "light2" | "dark1" | "dark2");
  */
 type HexColor = string;
 /**
- * Background fill applied to slides. Theme backgrounds preserve PowerPoint's color-scheme background choice; other variants represent fixed background fills.
+ * An image source in a string shorthand: an 'asset:<id>' reference, an HTTPS URL, a data URI, or a relative path starting with './' or '../' (resolved against the OPF file location).
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "Background".
+ * via the `definition` "ImageSource".
  */
-type Background = (ThemeBackground | SolidBackground | GradientBackground | ImageBackground | PatternBackground);
+type ImageSource = string;
 /**
- * Named dimension preset; chooses both aspect ratio and physical size. 'widescreen' is an alias for 16:9 in PowerPoint widescreen size; 'standard' is an alias for 4:3 in PowerPoint standard size. The social-feed ratios keep the widescreen short edge of 7.5 in: 1:1 is 7.5 x 7.5 in, 4:5 is 7.5 x 9.375 in and 9:16 is 7.5 x 13.333 in (portrait).
+ * Background fill applied to slides. Theme backgrounds preserve PowerPoint's color-scheme background choice; other variants represent fixed background fills.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "DimensionPreset".
+ * via the `definition` "Background".
  */
-type DimensionPreset = ("16:9" | "4:3" | "16:10" | "1:1" | "4:5" | "9:16" | "letter" | "a4" | "widescreen" | "standard");
+type Background = (ThemeBackground | SolidBackground | GradientBackground | ImageBackground | PatternBackground);
 /**
  * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
  *
@@ -274,7 +235,7 @@ type Asset = (string | {
     mediaType?: string;
 });
 /**
- * Decorative watermark: an image ('src') or a text stamp ('text'), exactly one of the two, with its opacity. An image is drawn once per slide, contained and centered in a fixed frame (the middle 40% of the slide width and height, from 30% to 70% on each axis). A text watermark is one line of text in the heading font and the theme text color at the given opacity, centered on the slide and rotated 30 degrees counterclockwise (rising to the right), sized to span at most 70% of the slide width and at most 30% of the shorter slide edge in height; it is drawn behind the slide content and above the background and slide image. There is no option to move, scale, rotate or tile either form. PPTX export writes one native picture (image) or one native text box (text) per slide with the opacity as alpha, and import restores the watermark. A string or Asset (no opacity) is the image watermark at opacity 0.08. A watermark object needs opacity and exactly one of src and text; use a plain string or Asset for an image at the default opacity. Use design.watermark = false to disable an inherited watermark.
+ * Decorative watermark: an image ('src') or a text stamp ('text'), exactly one of the two, with its opacity. An image is drawn once per slide, contained and centered in a fixed frame (the middle 40% of the slide width and height, from 30% to 70% on each axis). A text watermark is one line of text in the heading font and the theme text color at the given opacity, centered on the slide and rotated 30 degrees counterclockwise (rising to the right), sized to span at most 70% of the slide width and at most 30% of the shorter slide edge in height; it is drawn behind the slide content and above the background. There is no option to move, scale, rotate or tile either form. PPTX export writes one native picture (image) or one native text box (text) per slide with the opacity as alpha, and import restores the watermark. A string or Asset (no opacity) is the image watermark at opacity 0.08. A watermark object needs opacity and exactly one of src and text; use a plain string or Asset for an image at the default opacity. Use design.watermark = false to disable an inherited watermark.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Watermark".
@@ -482,11 +443,11 @@ type ContentPayload = {
      */
     text?: (string | TextRun[]);
     /**
-     * Generic list payload. Each item is either a plain string, a TextRun[] rich text sequence, or a ListItem object. List nesting uses item.level rather than nested content payloads.
+     * Structured list payload (type 'list'). Each item is either a plain string, a TextRun[] rich text sequence, or a ListItem object with optional `description`. List nesting uses item.level rather than nested content payloads. Use `items` when entries share a shape or any entry needs a `description`; use `bullets` for plain talking points. Both draw the same marker, nesting and numbering. A block or region holds `items` or `bullets`, never both, and `items` cannot sit beside `text`.
      */
     items?: ListItem[];
     /**
-     * Text-style bullet payload. Presence of this field infers type 'text'.
+     * Prose bullet payload: short talking points, each standing alone. Presence of this field infers type 'text', so it may sit beside `text` in one payload. Entries have no `description`; use `items` for entries with supporting detail.
      */
     bullets?: BulletItem[];
     /**
@@ -518,6 +479,43 @@ type ContentPayload = {
          */
         mediaType?: string;
     });
+    /**
+     * Image payloads only. How the picture fills its frame: 'cover' fills it and crops what overflows around focus; 'contain' shows the whole picture centered; 'stretch' scales it to the frame exactly. Default: the effective design.imageFit, else 'cover'.
+     */
+    fit?: ("cover" | "contain" | "stretch");
+    focus?: ImageFocus1;
+    /**
+     * Image payloads only. Width-to-height ratio of the frame: the frame becomes the largest centered box with this ratio inside the block's region, for example 2.39 for a cinematic letterbox or 0.5 for a phone-shaped frame. shape 'circle' always uses 1.
+     */
+    aspectRatio?: number;
+    /**
+     * Image payloads only. Mask applied to the frame, exported as the picture's native preset geometry (rect, roundRect, ellipse, hexagon). 'circle' makes the frame square. Default 'rectangle'.
+     */
+    shape?: ("rectangle" | "rounded" | "circle" | "hexagon");
+    /**
+     * Image payloads only. Corner radius for shape 'rounded' as a fraction of the frame's shorter side. Default 0.16667, PowerPoint's roundRect default.
+     */
+    cornerRadius?: number;
+    border?: ImageBorder;
+    /**
+     * Image payloads only. Picture opacity from 0 to 1, exported as a native alphaModFix. The border and overlay keep their own opacity. Default 1.
+     */
+    opacity?: number;
+    /**
+     * Image payloads only. Grayscale or duotone treatment of the picture's pixels.
+     */
+    recolor?: ("grayscale" | {
+        /**
+         * Color at luminance 0.
+         */
+        dark: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
+        /**
+         * Color at luminance 1.
+         */
+        light: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
+    });
+    overlay?: Overlay1;
+    placement?: ImagePlacement;
     /**
      * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
      */
@@ -602,12 +600,7 @@ type ContentPayload = {
     composition?: Composition;
 };
 /**
- * Catalog source location. Accepts:
- * - A bare URL pointing at a catalog directory (e.g. 'https://acme.com/decks/narratives'); record ids resolve to '<base>/<id>.json'.
- * - A URL pointing at an index file (e.g. 'https://acme.com/decks/narratives/index.json'); records are resolved relative to the index file's directory and the index entries describe what's available. Index files follow https://openpresentation.org/schema/opf-catalog-index/v1; the default catalog's index is https://www.pptx.gallery/<kind>/index.json.
- * - A package reference of the form 'pkg:<package>[/<subpath>]'. 'pkg:@openpresentation/opf/...' resolves from the bundled snapshot; any other package reference needs the host to supply its records in 'catalogSources'.
- *
- * Engines never fetch or install anything for a source: the host supplies the records of every source other than the bundled default, as a 'catalogSources' map from the source string to its records.
+ * Identity of a catalog: an HTTPS URL ('https://www.pptx.gallery') or a package reference ('pkg:@acme/opf-catalog'). It names the catalog; engines never fetch or install it. A host registers the catalog's records under this exact string, and copying slides between documents matches groups by it.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "CatalogSource".
@@ -616,9 +609,9 @@ type CatalogSource = string;
 /**
  * Open-source JSON format for describing PowerPoint presentations. Agents describe narratives, content, audience, reusable assets, and design — the engine handles OOXML complexity.
  *
- * Fields that reference catalog records (narrative, language, tone, audience, purpose, design.theme / design.theme.id, design.colorScheme / design.colorScheme.id, design.fontScheme / design.fontScheme.id, Slide.layout, Chart.type, Organization.socials / Speaker.socials) resolve through the catalog system: inline 'catalogs.<kind>.records[]' on the document → 'catalogs.<kind>.source' on the document → engine defaults → the default catalog at https://www.pptx.gallery/<kind>. The default catalog is published by pptx.gallery: the index at https://www.pptx.gallery/<kind>/index.json (also GET https://www.pptx.gallery/<kind> with Accept: application/json) and each record at https://www.pptx.gallery/<kind>/<id>.json. Engines resolve it from the pinned snapshot bundled in @openpresentation/opf (spec/catalogs, pinned by spec/catalogs/manifest.json) and never fetch it at run time; fetching a document's catalogs.<kind>.source is an explicit opt-in by the caller. Every reference resolves to the catalog record's 'id' field. When an OPF document omits a reference entirely, the engine falls back to engine defaults (see /spec/reference/engine-defaults.json for a reference example). The defaults file is engine configuration; it is not part of the OPF document contract and has no JSON Schema.
+ * Content references (Slide.layout, design.theme, design.colorScheme / design.colorScheme.id, design.fontScheme / design.fontScheme.id, narrative, audience, purpose and tone, and the colorScheme / fontScheme a theme record names) point at catalog records. Each is a bare 'id' or a 'name:id' whose prefix names a group in 'catalogs'. A bare id resolves in catalogs.custom, then in the records embedded under catalogs.default, then in the catalog the host registered for catalogs.default.source (or the host's default catalog when 'default' is omitted); 'name:id' resolves in catalogs.<name>, then in the catalog the host registered for its source. A reference that resolves nowhere is the warning opf/unresolved-reference, and the slide uses automatic composition or the engine default. Engines never fetch a catalog: a saved document embeds every record it uses, and hosts register any other catalog by its source string. See docs/default-catalog.md.
  *
- * Most catalog references accept the bare 'id' as a string for the common case (e.g. narrative = 'classic-story', design.colorScheme = 'cool-horizon'). Audience, purpose, tone, design, and language object forms use 'id' as a base catalog reference plus inline overrides. Asset references use 'asset:<id>' strings that point into the top-level assets registry, and content color fields (rich-text runs, styled table cells) accept hex values, color-scheme slot/role names, or 'var:<id>' references into the top-level variables map.
+ * chart.type, the language tag and the keys of Organization.socials / Speaker.socials are engine vocabularies, validated directly with no catalog lookup. When a document names no theme, colour scheme or font scheme, every engine uses the same small engine defaults (spec/reference/engine-defaults.json). Asset references use 'asset:<id>' strings that point into the top-level assets registry, and content color fields (rich-text runs, styled table cells) accept hex values, color-scheme slot/role names, or 'var:<id>' references into the top-level variables map.
  */
 interface Presentation {
     /**
@@ -651,37 +644,37 @@ interface Presentation {
     author?: (string | [string, ...(string)[]]);
     /**
      * Intended audiences for the presentation. Accepts any of:
-     * - A single string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executive'), an HTTPS URL, or a 'pkg:' reference.
-     * - A single inline Audience object, like purpose and tone, for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.
-     * - An array of string shorthands and/or inline Audience objects, for more than one audience.
+     * - A single string: an audiences reference ('executive', or 'acme:board' for a record of the catalogs.acme group), or free-form text ('Series B investors'). A string that is a bare id or 'name:id' is a reference; any other string is free text and is never looked up.
+     * - A single inline Audience object, for custom audience metadata or overrides on a referenced record. Object form has the fields of https://openpresentation.org/schema/opf-audience/v1.
+     * - An array of strings and/or inline Audience objects, for more than one audience.
      *
-     * Resolution order for catalog ids and references: inline catalogs.audiences.records[] → catalogs.audiences.source → default catalog at https://www.pptx.gallery/audiences.
+     * A reference resolves like every content reference (see catalogs); one that resolves nowhere is the warning opf/unresolved-reference. Nothing is drawn from the audience.
      */
     audience?: (string | Audience | [(string | Audience), ...((string | Audience))[]]);
     /**
      * Primary goal of the presentation. Accepts either:
-     * - A string shorthand: free-form goal ('Raise a Series B round of $30M'), a purposes catalog id ('decide', 'align'), an HTTPS URL, or a 'pkg:' reference.
-     * - An inline Purpose object for custom purpose metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-purpose/v1 without '$schema'.
+     * - A string: a purposes reference ('decide', or 'acme:fundraise' for a record of the catalogs.acme group), or a free-form goal ('Raise a Series B round of $30M'). A string that is a bare id or 'name:id' is a reference; any other string is free text and is never looked up.
+     * - An inline Purpose object for custom purpose metadata or overrides on a referenced record. Object form has the fields of https://openpresentation.org/schema/opf-purpose/v1.
      *
-     * Resolution order for catalog ids and references: inline catalogs.purposes.records[] → catalogs.purposes.source → default catalog at https://www.pptx.gallery/purposes.
+     * A reference resolves like every content reference (see catalogs); one that resolves nowhere is the warning opf/unresolved-reference. Nothing is drawn from the purpose.
      */
     purpose?: (string | Purpose);
     /**
-     * Language for the presentation content. Accepts either:
-     * - A string shorthand: a BCP-47 language tag ('en-US', 'en-GB', 'ja-JP', 'fr'), a languages catalog id ('english', 'japanese'), an HTTPS URL, or a 'pkg:' reference.
-     * - An inline Language object for custom language metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-language/v1 without '$schema'.
+     * Language of the presentation content, an engine vocabulary: a BCP-47 language tag, validated directly with no catalog lookup. Accepts either:
+     * - A BCP-47 tag ('en-US', 'en-GB', 'ja', 'zh-Hans', 'ar-SA').
+     * - An inline Language object: a 'bcp47' tag plus overrides of what engines know about it (name, ooxmlLang, script, direction, the script font schemes).
      *
-     * Resolution order for catalog ids and references: inline catalogs.languages.records[] → catalogs.languages.source → default catalog at https://www.pptx.gallery/languages.
+     * Engines know the script, base direction, OOXML language tag and default script fonts of the tags in spec/reference/engine-vocabularies.json; any other well-formed tag is accepted and its script is inferred from the tag. Language names and descriptions are catalog display metadata, not part of the document.
      */
-    language?: (string | Language);
+    language?: (LanguageTag | Language);
     /**
      * Desired tone for the presentation. Accepts either:
-     * - A string shorthand: a tones catalog id ('formal'), an HTTPS URL, or a 'pkg:' reference.
-     * - An inline Tone object for custom tone metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-tone/v1 without '$schema'.
+     * - A tones reference: a bare id ('formal') or 'name:id' for a record of a named catalogs group.
+     * - An inline Tone object for custom tone metadata or overrides on a referenced record. Object form has the fields of https://openpresentation.org/schema/opf-tone/v1.
      *
-     * Resolution order for catalog ids and references: inline catalogs.tones.records[] → catalogs.tones.source → default catalog at https://www.pptx.gallery/tones.
+     * A reference resolves like every content reference (see catalogs); one that resolves nowhere is the warning opf/unresolved-reference. Nothing is drawn from the tone.
      */
-    tone?: (string | Tone);
+    tone?: (CatalogReference | Tone);
     /**
      * Audience-facing takeaway the presentation should leave behind. Array form supports multiple takeaways. Deck-level intent used by AI to seed and pressure-test slide content.
      */
@@ -701,13 +694,7 @@ interface Presentation {
      */
     template?: boolean;
     /**
-     * The deck's narrative plan, by reference: the 'id' of a 'narratives' catalog record, an HTTPS URL pointing at a record file, or a 'pkg:' reference to a locally-installed package. The deck holds only this pointer; the plan (the arc, its beats and what each beat must do) lives in the catalog record, which validates against https://openpresentation.org/schema/opf-narrative/v1. A custom narrative is a record in catalogs.narratives.records, referenced here by its id.
-     *
-     * Slides link themselves to beats with slides[].beat. Core validate warns about a slides[].beat id the resolved narrative does not define and about a root 'duration' outside its 'duration' range, and reports a beat that no slide references. The preview and the PPTX export draw nothing from the narrative; opf-pptx stores the reference for round-trip.
-     *
-     * Resolution order: inline catalogs.narratives.records[] → catalogs.narratives.source → default catalog at https://www.pptx.gallery/narratives. Unknown ids produce a validation warning, not an error.
-     *
-     * Deck-level concerns that are not part of the storyline (audience, tone, takeaway, duration) live as siblings on the presentation root.
+     * A content reference: a bare id ('two-column') or 'name:id' ('acme:hero'), where the prefix names a group of 'catalogs'. URLs and 'pkg:' strings are not references; a named catalog group replaces them. See Catalogs for the resolution order.
      */
     narrative?: string;
     /**
@@ -878,34 +865,81 @@ interface Socials1 {
      */
     [k: string]: string;
 }
+/**
+ * Inline language metadata for the presentation: a BCP-47 'bcp47' tag plus overrides of what engines know about it. Languages are an engine vocabulary, not catalog records, so there is no 'id'.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Language".
+ */
+interface Language {
+    /**
+     * Human-readable language name.
+     */
+    name?: string;
+    /**
+     * A BCP-47 language tag ('en-US', 'ja', 'zh-Hans', 'sr-Latn-ME'), an engine vocabulary. Use 'en-GB' for UK English; 'en-UK' is not a valid region.
+     */
+    bcp47: string;
+    /**
+     * Culture tag for OOXML text-run language attributes (a:rPr/@lang, a:endParaRPr/@lang), in the language-[Script-]REGION form Office recognizes (e.g. 'ja-JP', 'ar-SA', 'ms-MY', 'nb-NO', 'fil-PH', 'zh-CN'). Without it, engines emit the curated tag of their language vocabulary (spec/reference/engine-vocabularies.json) for a tag without a region, and a region-bearing tag as written. Curated rather than inferred so output does not depend on the runtime's locale data.
+     */
+    ooxmlLang?: string;
+    /**
+     * ISO 639-3 or 639-2 language code carried for engines that prefer ISO codes.
+     */
+    code?: string;
+    /**
+     * Base text direction for the language. When omitted, engines derive it from the script: Arabic (Arab), Hebrew (Hebr), Syriac (Syrc), Thaana (Thaa), N'Ko (Nkoo), Adlam (Adlm), Samaritan (Samr), Mandaic (Mand) and Hanifi Rohingya (Rohg) are right-to-left; every other script is left-to-right. The engine language vocabulary (spec/reference/engine-vocabularies.json) states it for the tags it knows.
+     */
+    direction?: ("ltr" | "rtl");
+    /**
+     * ISO 15924 script code of the language's writing system. The script selects the OOXML font slot the language's text uses: East Asian scripts (Hans, Hant, Hani, Jpan, Kore, Hang, Hira, Kana, Bopo, Yiii) use the eastAsian slot; complex scripts (for example Arab, Hebr, Syrc, Thaa, Deva, Beng, Guru, Gujr, Orya, Taml, Telu, Knda, Mlym, Sinh, Thai, Laoo, Tibt, Mymr, Khmr, Mong) use the complexScript slot; every other script (Latn, Cyrl, Grek, Armn, Geor, Ethi, ...) uses the latin slot. When omitted, engines infer it from the BCP-47 tag. The engine language vocabulary (spec/reference/engine-vocabularies.json) states it for the tags it knows. See docs/programs/font-fidelity-everywhere/script-font-model.md.
+     */
+    script?: string;
+    /**
+     * Font-scheme reference (a bare id or 'name:id') for this language's script slot when targeting PowerPoint output. Its major/minor families fill the language's script slot (eastAsian or complexScript, chosen by 'script') unless the effective design font scheme sets that slot itself; the latin slot always follows the design font scheme. Without it, engines use the default script fonts of their language vocabulary.
+     */
+    fontScheme?: string;
+    /**
+     * Font-scheme reference (a bare id or 'name:id') used in place of 'fontScheme' when resolving script fonts for Google Slides output.
+     */
+    googleFontScheme?: string;
+    /**
+     * One-sentence note about coverage or font defaults.
+     */
+    summary?: string;
+    /**
+     * Longer prose describing the language record and any font-pairing rationale.
+     */
+    description?: string;
+    /**
+     * Free-form labels for filtering and search.
+     */
+    tags?: string[];
+    [k: string]: unknown;
+}
 /**
  * Optional design system covering theme, color scheme, font scheme, dimensions, background, logo, watermark, header, and footer applied to the deck. When omitted, engines use their default design configuration.
  */
 interface Design {
     /**
-     * Theme for the deck. Accepts two forms:
-     * - String shorthand: 'design.theme = "minimal"'. Bare id, HTTPS URL, or 'pkg:' reference resolved as the 'id' of a 'themes' catalog record.
-     * - Object form: a Theme with an optional 'id' base reference plus theme-level overrides.
-     *
-     * Inline overrides on design.colorScheme / design.fontScheme / design.background / design.dimensions take precedence over the resolved theme.
-     *
-     * Resolution order: inline catalogs.themes.records[] -> catalogs.themes.source -> default catalog at https://www.pptx.gallery/themes.
+     * A content reference: a bare id ('two-column') or 'name:id' ('acme:hero'), where the prefix names a group of 'catalogs'. URLs and 'pkg:' strings are not references; a named catalog group replaces them. See Catalogs for the resolution order.
      */
-    theme?: (string | Theme);
+    theme?: string;
     /**
      * Color scheme for the presentation. Accepts two forms:
-     * - String shorthand: 'design.colorScheme = "cool-horizon"'. Bare id, HTTPS URL, or 'pkg:' reference resolved as the 'id' of a 'colorSchemes' catalog record.
-     * - Object form: a ColorScheme with an optional 'id' base reference plus slot/role overrides.
+     * - A colorSchemes reference: a bare id ('cool-horizon') or 'name:id' ('acme:ocean').
+     * - Object form: a ColorScheme with an optional 'id' reference as the base plus slot/role overrides. Without 'id', the overrides apply on top of the engine default colour scheme.
      *
-     * Resolution order: inline catalogs.colorSchemes.records[] -> catalogs.colorSchemes.source -> default catalog at https://www.pptx.gallery/color-schemes.
+     * Without either, the theme's colorScheme applies, then the engine default colour scheme.
      */
     colorScheme?: (string | ColorScheme);
     /**
      * Font scheme for heading, body, accent, and code text. Accepts two forms:
-     * - String shorthand: 'design.fontScheme = "aptos"'. Bare id, HTTPS URL, or 'pkg:' reference resolved as the 'id' of a 'fontSchemes' catalog record.
-     * - Object form: a FontScheme with an optional 'id' base reference plus pair/role overrides.
+     * - A fontSchemes reference: a bare id ('aptos') or 'name:id' ('acme:inter').
+     * - Object form: a FontScheme with an optional 'id' reference as the base plus pair/role overrides.
      *
-     * Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.source -> default catalog at https://www.pptx.gallery/font-schemes.
+     * Without either, the theme's fontScheme applies, then the engine default font scheme.
      */
     fontScheme?: (string | FontScheme);
     /**
@@ -913,7 +947,7 @@ interface Design {
      */
     dimensions?: (DimensionPreset | Dimensions);
     /**
-     * Default slide background applied across the deck unless overridden on a slide. String shorthand accepts theme slots ('light1', 'light2', 'dark1', 'dark2') or hex colors; object forms support theme, solid, gradient, image, or pattern fills.
+     * Default slide background applied across the deck unless overridden on a slide (slides.N.design.background); the resolved theme's background is the fallback. A background is the only canvas fill and never moves content. String shorthand accepts theme slots ('light1', 'light2', 'dark1', 'dark2'), hex colors, or an image source starting with 'asset:', 'https://', 'data:', './' or '../' (a cover image); object forms support theme, solid, gradient, image, or pattern fills.
      */
     background?: (BackgroundShortcut | Background);
     /**
@@ -944,163 +978,24 @@ interface Design {
      * Whether body/content regions are rendered inside a visible card or surface. Effective value: the slide's design, then the deck's design, then the layout record's design.contentBox, then the engine default.
      */
     contentBox?: boolean;
-    /**
-     * Optional slide-level image, separate from content images. It applies to a slide that sets its own design.slideImage, and to slides whose layout record sets design.slideImage or whose root image is the same source as a deck-level value. A root image with the same source becomes the slide image instead of a content item. Blur, shadows, soft edges, background removal and device artwork are not part of the treatment vocabulary; see docs/image-treatments.md.
-     */
-    slideImage?: (Asset | {
-        /**
-         * Source for the slide-level image. When omitted in a design override, the object only configures how a slide-level image should be placed when one is supplied by a content payload, asset, or renderer convention.
-         */
-        src?: string;
-        /**
-         * Where the slide-level image sits relative to the content. 'background' is a full-bleed image behind the content. The other positions give the image a band along that edge (see size) and compose headings and content in the rest of the slide.
-         */
-        position: ("background" | "top" | "bottom" | "left" | "right");
-        /**
-         * Alternative text for the slide-level image. Overrides the alt text of a referenced asset.
-         */
-        alt?: string;
-        /**
-         * How the image fills its frame: 'crop' covers the frame from the center; 'fit' shows the whole image centered inside it. Overrides design.imageFill for this image. Default: design.imageFill, else 'crop'.
-         */
-        fill?: ("crop" | "fit");
-        /**
-         * Share of the slide width (left/right) or height (top/bottom) given to the image band. Ignored for 'background'. Default 0.5.
-         */
-        size?: number;
-        /**
-         * Place the frame inside the slide padding instead of edge to edge, like a card. Default false.
-         */
-        inset?: boolean;
-        /**
-         * Width-to-height ratio of the frame. The frame becomes the largest centered box with this ratio inside the band or slide, for example 2.39 for a cinematic letterbox or 0.5 for a phone-shaped frame. 'circle' always uses 1.
-         */
-        aspectRatio?: number;
-        /**
-         * Mask applied to the frame, exported as the picture's native preset geometry (rect, roundRect, ellipse, hexagon). 'circle' makes the frame square. Default 'rectangle'.
-         */
-        shape?: ("rectangle" | "rounded" | "circle" | "hexagon");
-        /**
-         * Corner radius for shape 'rounded' as a fraction of the frame's shorter side. Default 0.16667, PowerPoint's roundRect default.
-         */
-        cornerRadius?: number;
-        /**
-         * Solid line along the frame's shape. A thick dark border on a rounded portrait frame gives a device bezel.
-         */
-        border?: {
-            /**
-             * Line color: a hex color, a color-scheme slot or role name, or a 'var:<id>' variable reference.
-             */
-            color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
-            /**
-             * Line width in reference pixels at a 720-pixel short edge, centered on the frame outline like a native picture line. 0 removes the line.
-             */
-            width: number;
-        };
-        /**
-         * Image opacity from 0 to 1, exported as a native alphaModFix. The border and overlay keep their own opacity. Default 1.
-         */
-        opacity?: number;
-        /**
-         * Color treatment for the image pixels. Luminance uses Rec. 601 weights (0.299, 0.587, 0.114) on sRGB values.
-         */
-        recolor?: ("grayscale" | {
-            /**
-             * Color at luminance 0.
-             */
-            dark: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
-            /**
-             * Color at luminance 1.
-             */
-            light: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
-        });
-        /**
-         * Solid scrim drawn over the image in the frame's shape, beneath headings and content, for example to keep overlaid text readable. Exported as a native shape above the picture.
-         */
-        overlay?: {
-            /**
-             * Overlay fill color.
-             */
-            color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
-            /**
-             * Overlay fill opacity.
-             */
-            opacity: number;
-            /**
-             * Cover only a band along this edge of the frame, for example a caption strip. Rectangle frames only; other shapes report unsupported-image-treatment and draw no overlay. Omit to cover the whole frame.
-             */
-            edge?: ("top" | "bottom" | "left" | "right");
-            /**
-             * Band share of the frame for an edge overlay. Default 0.3.
-             */
-            size?: number;
-        };
-    });
     /**
      * Axis along which parallel body content is arranged. Sets the root arrangement mode of blocks and root payloads when no composition.mode is set on the slide or on its layout record: 'vertical' is column, 'horizontal' is row. Precedence: composition.mode (the slide's own, else the layout record's geometry contract), then the effective value (slide design, then deck design, then the layout record's design.contentDirection), then automatic selection. A layout that carries a composition.mode keeps its grid or direction whatever this value says. Promoted regions (left, top:left, ...) keep their explicit geometry and nested groups keep their own composition.
      */
     contentDirection?: ("horizontal" | "vertical");
     /**
-     * Where the primary chart sits relative to supporting content. Effective value: slide design, then deck design, then the layout record's design.chartPrimary. When the slide has no promoted regions and no composition.mode of its own, and its root nodes mix at least one chart with other content, the first chart becomes a primary track and the other nodes form one synthetic sub-grid: 'left'/'right' is a two-track row and 'top'/'bottom' a two-track column, weighted 3:2 in favor of the chart; explicit root columns and weights are ignored while it applies. 'none' (the default) keeps the ordinary automatic grid with equal weight.
+     * Where the primary chart sits relative to supporting content. Effective value: slide design, then deck design, then the layout record's design.chartPrimary. When the slide has no promoted regions and no composition.mode of its own, and its root nodes mix at least one chart with other content, the first chart becomes a primary track and the other nodes form one synthetic sub-grid: 'left'/'right' is a two-track row and 'top'/'bottom' a two-track column, weighted 3:2 in favor of the chart; explicit root columns and weights are ignored while it applies. 'none' (the default) keeps the ordinary automatic grid with equal weight. It is shorthand for a placeholder group (layout.schema.json PlaceholderGroup): the slide composes exactly as on a layout record whose root composition is that weighted row or column and whose placeholders are the chart and one automatic group of the other content, and while it applies it replaces the layout record's own placeholder groups as well.
      */
     chartPrimary?: ("none" | "top" | "bottom" | "left" | "right");
     /**
-     * How images fill their allocated region: crop covers the region, fit shows the whole image. Effective value: the slide's design, then the deck's design, then the layout record's design.imageFill, then the engine default.
+     * Default fit of image blocks (and Slide.image) that set no fit of their own: 'cover' fills the frame and crops what overflows around the block's focus, 'contain' shows the whole picture centered in the frame, 'stretch' scales it to the frame exactly. Effective value: the slide's design, then the deck's design, then the layout record's design.imageFit, then 'cover'. Backgrounds set their own fit.
      */
-    imageFill?: ("crop" | "fit");
+    imageFit?: ("cover" | "contain" | "stretch");
     /**
      * Marker style for items and bullets lists. Effective value: the slide's design, then the deck's design, then the layout record's design.listBullet, then 'character'. 'character' (the default) draws the glyph marker. 'image' draws the deck's icon logo (a slide's design.logo, then design.logo, then the primary organization's logo; light variants on dark backgrounds) as a picture bullet: a square of the marker's font size whose bottom sits on the marker baseline, so list geometry does not change. Without a logo the glyph is drawn and the engine reports unresolved-content at this field.
      */
     listBullet?: ("character" | "image");
     [k: string]: unknown;
 }
-/**
- * Theme bundle used by the design system. In design.theme, 'id' resolves a themes catalog record as the base; any sibling fields override the resolved theme. The string shorthand on design.theme is equivalent to setting only 'id'.
- *
- * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "Theme".
- */
-interface Theme {
-    /**
-     * Theme reference. Resolves to the 'id' of a 'themes' catalog record. Accepts a bare id (lowercase kebab-case, e.g. 'minimal'), an HTTPS URL pointing at a record file, or a 'pkg:' reference. Field overrides on the surrounding Theme object take precedence over the resolved theme.
-     *
-     * Resolution order: inline catalogs.themes.records[] -> catalogs.themes.source -> default catalog at https://www.pptx.gallery/themes.
-     */
-    id?: string;
-    /**
-     * Human-readable theme name shown in pickers.
-     */
-    name?: string;
-    /**
-     * One-sentence positioning of the theme - when to reach for it.
-     */
-    summary?: string;
-    /**
-     * Longer prose describing what the theme looks and feels like and the kinds of decks it suits.
-     */
-    description?: string;
-    /**
-     * Default color scheme for this theme. A string resolves against catalogs.colorSchemes; an object may provide an 'id' base reference plus overrides.
-     */
-    colorScheme?: (string | ColorScheme);
-    /**
-     * Default font scheme for this theme. A string resolves against catalogs.fontSchemes; an object may provide an 'id' base reference plus overrides.
-     */
-    fontScheme?: (string | FontScheme);
-    /**
-     * Default background for this theme. String shorthand accepts theme slots ('light1', 'light2', 'dark1', 'dark2') or hex colors.
-     */
-    background?: (BackgroundShortcut | Background);
-    /**
-     * Default slide size for this theme. A string preset is equivalent to { preset: value }.
-     */
-    dimensions?: (DimensionPreset | Dimensions);
-    /**
-     * Free-form labels for filtering and search.
-     */
-    tags?: string[];
-    [k: string]: unknown;
-}
 /**
  * Color palette used by the design system. Every slot and role is a hex color ('#RGB', '#RRGGBB' or '#RRGGBBAA'); a color-scheme name or a 'var:<id>' reference is not valid here, because those resolve through the scheme. The slot fields (accent1-accent6, dark1, dark2, light1, light2, hyperlink, followedHyperlink) mirror color-scheme.schema.json (https://openpresentation.org/schema/opf-color-scheme/v1) so library records and inline OPF overrides are interchangeable on those fields.
  *
@@ -1108,16 +1003,14 @@ interface Theme {
  * - OOXML slots - the 12-slot PowerPoint theme model that round-trips directly to OOXML. Use these for full control over the palette as PowerPoint sees it.
  * - Abstract roles (primary, secondary, accent, background, surface, text, textSecondary) - OPF-specific semantic aliases the engine maps onto the OOXML slots. Convenient for inline overrides without thinking in slot numbers; not part of the catalog record schema.
  *
- * In design.colorScheme, 'id' resolves a colorSchemes catalog record as the base; slot and role overrides on the same object take precedence over the resolved scheme. The string shorthand on design.colorScheme is equivalent to setting only 'id'.
+ * In design.colorScheme, 'id' resolves a colorSchemes record as the base; slot and role overrides on the same object take precedence over the resolved scheme. The string form of design.colorScheme is equivalent to setting only 'id'.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "ColorScheme".
  */
 interface ColorScheme {
     /**
-     * Color scheme reference. Resolves to the 'id' of a 'colorSchemes' catalog record. Accepts a bare id (lowercase kebab-case, e.g. 'cool-horizon'), an HTTPS URL pointing at a record file, or a 'pkg:' reference. Slot and role overrides on the surrounding ColorScheme object take precedence over the resolved scheme.
-     *
-     * Resolution order: inline catalogs.colorSchemes.records[] -> catalogs.colorSchemes.source -> default catalog at https://www.pptx.gallery/color-schemes.
+     * A content reference: a bare id ('two-column') or 'name:id' ('acme:hero'), where the prefix names a group of 'catalogs'. URLs and 'pkg:' strings are not references; a named catalog group replaces them. See Catalogs for the resolution order.
      */
     id?: string;
     /**
@@ -1205,16 +1098,14 @@ interface ColorScheme {
  * - OOXML pairs (major, minor) - heading and body family names that round-trip directly to PowerPoint majorFont/minorFont entries.
  * - Abstract roles (heading, body, accent, code) - OPF-specific font family names the engine maps onto the OOXML pair when serializing. Convenient for inline overrides and for adding accent/code roles that don't have a direct OOXML slot. Catalog records may also carry 'code' (for example the consolas and courier-new records); heading, body and accent are not part of the catalog record schema. A role is a family name only: weight, style and tracking come from the text styles, and PowerPoint has no numeric weight.
  *
- * In design.fontScheme, 'id' resolves a fontSchemes catalog record as the base; pair and role overrides on the same object take precedence over the resolved scheme. The string shorthand on design.fontScheme is equivalent to setting only 'id'.
+ * In design.fontScheme, 'id' resolves a fontSchemes record as the base; pair and role overrides on the same object take precedence over the resolved scheme. The string form of design.fontScheme is equivalent to setting only 'id'.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "FontScheme".
  */
 interface FontScheme {
     /**
-     * Font scheme reference. Resolves to the 'id' of a 'fontSchemes' catalog record. Accepts a bare id (lowercase kebab-case, e.g. 'aptos'), an HTTPS URL pointing at a record file, or a 'pkg:' reference. Field overrides on the surrounding FontScheme object take precedence over the resolved scheme.
-     *
-     * Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.source -> default catalog at https://www.pptx.gallery/font-schemes.
+     * A content reference: a bare id ('two-column') or 'name:id' ('acme:hero'), where the prefix names a group of 'catalogs'. URLs and 'pkg:' strings are not references; a named catalog group replaces them. See Catalogs for the resolution order.
      */
     id?: string;
     /**
@@ -1276,11 +1167,29 @@ interface FontScheme {
      */
     accent?: string;
     /**
-     * Abstract role: monospaced font family name used for code blocks and for inline code runs (TextRun.code). No direct OOXML slot. Resolution: this override, then the resolved catalog record's 'code' (for example Consolas for the consolas scheme), then the engine fallback Roboto Mono. Heading and body families are never used as the code fallback.
+     * Abstract role: monospaced font family name used for code blocks and for inline code runs (TextRun.code). No direct OOXML slot. Resolution: this override, then the resolved font-scheme record's 'code' (for example Consolas for the consolas scheme), then the engine fallback Roboto Mono. Heading and body families are never used as the code fallback.
      */
     code?: string;
     [k: string]: unknown;
 }
+/**
+ * Slide dimensions; either pick a preset or specify custom inches.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Dimensions".
+ */
+interface Dimensions {
+    preset?: DimensionPreset;
+    /**
+     * Custom slide width in inches; overrides the preset width when provided.
+     */
+    widthInches?: number;
+    /**
+     * Custom slide height in inches; overrides the preset height when provided.
+     */
+    heightInches?: number;
+    [k: string]: unknown;
+}
 /**
  * Theme-controlled PowerPoint slide background. The slot is resolved through the active color scheme and remains theme-aware.
  *
@@ -1386,35 +1295,81 @@ interface GradientBackground {
     [k: string]: unknown;
 }
 /**
- * Fixed image slide background fill.
+ * Picture background: the image fills the whole canvas behind everything and never moves content (to push content aside, use an image block with placement). The string shorthand 'asset:x' (or any image source) is { type: 'image', src: 'asset:x' }, a cover image. Paint order: the colour scheme's default slide background, the picture, then the overlay, then furniture and content.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "ImageBackground".
  */
 interface ImageBackground {
     /**
-     * Fixed image background fill.
+     * Picture background.
      */
     type: "image";
     /**
-     * Image fill definition.
+     * Source for the background image: an 'asset:<id>' reference, HTTPS URL, data URI, or a relative path resolved against the OPF file location.
+     */
+    src: string;
+    /**
+     * Alternative text. A background with alt is meaningful: PowerPoint export draws it as a full-slide picture at the back that carries the text, so screen readers see it. Without alt it is decorative and exports as the native slide background; the alt text of a referenced asset does not count, so a background is decorative unless it says otherwise.
+     */
+    alt?: string;
+    /**
+     * How the picture fills the canvas: 'cover' fills it and crops what overflows around focus; 'contain' shows the whole picture centered over the colour scheme's default background; 'stretch' scales it to the canvas exactly; 'tile' repeats it at its own size from the top-left corner. Default 'cover'.
+     */
+    fit?: ("cover" | "contain" | "stretch" | "tile");
+    focus?: ImageFocus;
+    /**
+     * Picture opacity from 0 (fully transparent) to 1 (fully opaque); the overlay keeps its own opacity. Default 1.
      */
-    image: {
+    opacity?: number;
+    /**
+     * Grayscale or duotone treatment of the picture's pixels, as on an image block: recolor and opacity apply to the pixels, then the overlay is drawn above.
+     */
+    recolor?: ("grayscale" | {
         /**
-         * Source for the background image.
+         * Color at luminance 0.
          */
-        src: string;
+        dark: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
         /**
-         * How the image fills the slide background.
+         * Color at luminance 1.
          */
-        fit?: ("cover" | "contain" | "tile");
-        [k: string]: unknown;
-    };
+        light: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
+    });
+    overlay?: Overlay;
+}
+/**
+ * Point of the picture to keep in view when 'cover' crops it. Ignored by the other fits.
+ */
+interface ImageFocus {
     /**
-     * Background opacity from 0 (fully transparent) to 1 (fully opaque).
+     * Horizontal position, 0 (left edge) to 1 (right edge).
      */
-    opacity?: number;
-    [k: string]: unknown;
+    x: number;
+    /**
+     * Vertical position, 0 (top edge) to 1 (bottom edge).
+     */
+    y: number;
+}
+/**
+ * Scrim over the whole picture or a band along one edge (edge, size), beneath furniture and content, for example to keep a title readable over a busy photo.
+ */
+interface Overlay {
+    /**
+     * Overlay fill color: a hex color (eight-digit hex keeps its alpha), a color-scheme slot or role name, or a 'var:<id>' variable reference.
+     */
+    color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
+    /**
+     * Overlay fill opacity.
+     */
+    opacity: number;
+    /**
+     * Cover only a band along this edge of the frame, for example a caption strip. Backgrounds and rectangle image frames only; on another shape the overlay is not drawn and composition reports unsupported-image-treatment. Omit to cover the whole frame. In a right-to-left deck 'left' and 'right' are the start and end sides.
+     */
+    edge?: ("top" | "bottom" | "left" | "right");
+    /**
+     * Band share of the frame for an edge overlay. Default 0.3. Ignored without edge.
+     */
+    size?: number;
 }
 /**
  * Fixed pattern slide background fill.
@@ -1451,24 +1406,6 @@ interface PatternBackground {
     opacity?: number;
     [k: string]: unknown;
 }
-/**
- * Slide dimensions; either pick a preset or specify custom inches.
- *
- * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "Dimensions".
- */
-interface Dimensions {
-    preset?: DimensionPreset;
-    /**
-     * Custom slide width in inches; overrides the preset width when provided.
-     */
-    widthInches?: number;
-    /**
-     * Custom slide height in inches; overrides the preset height when provided.
-     */
-    heightInches?: number;
-    [k: string]: unknown;
-}
 /**
  * Deck logo variants surfaced by covers, section dividers, headers, footers and picture bullets. Organization identity lives in organization; this object only controls visual rendering assets. Engines select one variant per slot and background tone (resolveLogo in @openpresentation/opf): same-tone variants first, neutral ones next, the opposite tone last. Lockup on a dark background: light, default, stackedLight, stacked, wordmarkLight, wordmark, iconLight, icon, then dark, stackedDark, wordmarkDark, iconDark; on a light background: dark, default, stackedDark, stacked, wordmarkDark, wordmark, iconDark, icon, then light, stackedLight, wordmarkLight, iconLight. The icon slot (headers, footers, picture bullets) tries iconLight or iconDark for the tone, then icon, then the lockup chain; the stacked slot tries stackedLight or stackedDark, then stacked, then the lockup chain.
  *
@@ -2302,9 +2239,7 @@ interface Slide {
      */
     beat?: (string | string[]);
     /**
-     * Optional. Resolves to the 'id' of a 'layouts' catalog record. When omitted, or when it names an id that no inline record, host catalog or default catalog defines, the slide is composed with no layout record: engines arrange title, subtitle, tag and content automatically, a slide with no body payload is a cover (vertically centered), and design hints apply. A layout never changes what a slide contains. An unresolved id is an `unresolved-layout` diagnostic and a `catalog-reference` warning, never an error. Engines must not substitute a different layout for an omitted one. Accepts a bare id (lowercase kebab-case, e.g. 'title-subtitle'), an HTTPS URL pointing at a record file, or a 'pkg:' reference.
-     *
-     * Resolution order: inline catalogs.layouts.records[] → catalogs.layouts.source → default catalog at https://www.pptx.gallery/layouts.
+     * A content reference: a bare id ('two-column') or 'name:id' ('acme:hero'), where the prefix names a group of 'catalogs'. URLs and 'pkg:' strings are not references; a named catalog group replaces them. See Catalogs for the resolution order.
      */
     layout?: string;
     /**
@@ -2324,11 +2259,11 @@ interface Slide {
      */
     text?: (string | TextRun[]);
     /**
-     * Full-slide generic list payload. Presence of this field infers type 'list'. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for layout-agnostic blocks.
+     * Full-slide structured list payload. Presence of this field infers type 'list'. Entries are strings, TextRun[] or objects with `text`, optional `description` (supporting detail under the entry), `level` and `start`. Use `items` when entries share a shape (features, steps, options, risks) or any entry needs a `description`; use `bullets` for plain talking points. Both draw the same marker, nesting and numbering; they differ in the inferred kind and in `description`, which only `items` accepts. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for layout-agnostic blocks, so `items` next to `text` or `bullets` composes as separate blocks side by side.
      */
     items?: ListItem[];
     /**
-     * Full-slide text-style bullet payload. Presence of this field infers type 'text'.
+     * Full-slide prose bullet payload: short talking points, each standing alone. Presence of this field infers type 'text', so it may sit beside `text` in one payload. Entries are strings, TextRun[] or objects with `text`, `level` and `start`; there is no `description` (use `items` for entries with supporting detail).
      */
     bullets?: BulletItem[];
     /**
@@ -2536,9 +2471,9 @@ interface Numbering {
  */
 interface Chart {
     /**
-     * Chart type id. Resolves to the id of a chartTypes catalog record; renderers map that record through mappings.openxml and any renderer-specific mapping they understand. The bundled catalog covers the chart types Aspose.Slides officially supports, plus 'combo' (clustered columns with line series, see 'line' and 'secondaryAxis').
+     * Chart type, an engine vocabulary validated directly (no catalog lookup): the chart types Aspose.Slides officially supports, plus 'combo' (clustered columns with line series, see 'line' and 'secondaryAxis'). Each engine maps a type to its own chart model; labels and picker groups are catalog display metadata.
      */
-    type: string;
+    type: ("100pct-stacked-area" | "100pct-stacked-bar" | "100pct-stacked-column" | "area" | "bar" | "box-and-whisker" | "column" | "combo" | "doughnut" | "filled-radar" | "funnel" | "histogram" | "line" | "line-with-markers" | "pareto" | "pie" | "radar" | "radar-with-markers" | "scatter" | "stacked-area" | "stacked-bar" | "stacked-column" | "stacked-line" | "stacked-line-with-markers" | "treemap" | "waterfall" | "world");
     /**
      * Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally. A DatasetRef ({ "dataset": "<id>" }) plots a top-level dataset instead. Data from a spreadsheet or file is imported into inline columns and rows, and its origin is recorded in data.source.
      */
@@ -2744,6 +2679,10 @@ interface Table {
      */
     dataset?: string;
     fields?: DatasetFields1;
+    /**
+     * Text alternative for the table: what it shows (the point and the key numbers), not 'a table'. The preview exposes it as the table's accessible name (role group with aria-label; the cells stay readable) and the PowerPoint export writes it as the table frame's alternative text (descr); import reads it back. An empty string hides a purely decorative table, with the same meaning as an empty Asset alt. The alt is a summary read before the cells, which stay readable, so it is most useful for a large or dense table; validate does not require one and does not report a missing one.
+     */
+    alt?: string;
 }
 /**
  * A cell with explicit visual style or merged geometry. Its position remains its array column index; use null placeholders for every covered grid position.
@@ -2971,14 +2910,78 @@ interface TimelineEvent {
      */
     status?: ("done" | "current" | "planned");
 }
+/**
+ * Image payloads only. Point of the picture to keep in view when 'cover' crops it. Ignored by the other fits.
+ */
+interface ImageFocus1 {
+    /**
+     * Horizontal position, 0 (left edge) to 1 (right edge).
+     */
+    x: number;
+    /**
+     * Vertical position, 0 (top edge) to 1 (bottom edge).
+     */
+    y: number;
+}
+/**
+ * Image payloads only. Line along the frame's shape.
+ */
+interface ImageBorder {
+    /**
+     * Line color: a hex color, a color-scheme slot or role name, or a 'var:<id>' variable reference.
+     */
+    color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
+    /**
+     * Line width in reference pixels at a 720-pixel short edge. 0 removes the line.
+     */
+    width: number;
+}
+/**
+ * Image payloads only. Scrim over the picture in the frame's shape, or a band along one edge of a rectangle frame.
+ */
+interface Overlay1 {
+    /**
+     * Overlay fill color: a hex color (eight-digit hex keeps its alpha), a color-scheme slot or role name, or a 'var:<id>' variable reference.
+     */
+    color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
+    /**
+     * Overlay fill opacity.
+     */
+    opacity: number;
+    /**
+     * Cover only a band along this edge of the frame, for example a caption strip. Backgrounds and rectangle image frames only; on another shape the overlay is not drawn and composition reports unsupported-image-treatment. Omit to cover the whole frame. In a right-to-left deck 'left' and 'right' are the start and end sides.
+     */
+    edge?: ("top" | "bottom" | "left" | "right");
+    /**
+     * Band share of the frame for an edge overlay. Default 0.3. Ignored without edge.
+     */
+    size?: number;
+}
+/**
+ * Image payloads only, and only on a top-level block (slides.N.blocks.I), at most one per edge. Bleeds the image to one slide edge; the headings and the other blocks compose in the rest of the slide.
+ */
+interface ImagePlacement {
+    /**
+     * The slide edge the image bleeds to.
+     */
+    edge: ("left" | "right" | "top" | "bottom");
+    /**
+     * Share of the slide width (left, right) or height (top, bottom) given to the band. Default 0.5.
+     */
+    size?: number;
+    /**
+     * Draw the frame inside the slide padding on every side of the band, like a card, instead of edge to edge. Default false.
+     */
+    inset?: boolean;
+}
 /**
  * Chart payload. Presence of this field infers type 'chart'.
  */
 interface Chart1 {
     /**
-     * Chart type id. Resolves to the id of a chartTypes catalog record; renderers map that record through mappings.openxml and any renderer-specific mapping they understand. The bundled catalog covers the chart types Aspose.Slides officially supports, plus 'combo' (clustered columns with line series, see 'line' and 'secondaryAxis').
+     * Chart type, an engine vocabulary validated directly (no catalog lookup): the chart types Aspose.Slides officially supports, plus 'combo' (clustered columns with line series, see 'line' and 'secondaryAxis'). Each engine maps a type to its own chart model; labels and picker groups are catalog display metadata.
      */
-    type: string;
+    type: ("100pct-stacked-area" | "100pct-stacked-bar" | "100pct-stacked-column" | "area" | "bar" | "box-and-whisker" | "column" | "combo" | "doughnut" | "filled-radar" | "funnel" | "histogram" | "line" | "line-with-markers" | "pareto" | "pie" | "radar" | "radar-with-markers" | "scatter" | "stacked-area" | "stacked-bar" | "stacked-column" | "stacked-line" | "stacked-line-with-markers" | "treemap" | "waterfall" | "world");
     /**
      * Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally. A DatasetRef ({ "dataset": "<id>" }) plots a top-level dataset instead. Data from a spreadsheet or file is imported into inline columns and rows, and its origin is recorded in data.source.
      */
@@ -3028,6 +3031,10 @@ interface Table1 {
      */
     dataset?: string;
     fields?: DatasetFields1;
+    /**
+     * Text alternative for the table: what it shows (the point and the key numbers), not 'a table'. The preview exposes it as the table's accessible name (role group with aria-label; the cells stay readable) and the PowerPoint export writes it as the table frame's alternative text (descr); import reads it back. An empty string hides a purely decorative table, with the same meaning as an empty Asset alt. The alt is a summary read before the cells, which stay readable, so it is most useful for a large or dense table; validate does not require one and does not report a missing one.
+     */
+    alt?: string;
 }
 /**
  * Arrangement within this group. Only minFontSize and overflow inherit from the parent; strict overflow cannot be weakened.
@@ -3073,29 +3080,23 @@ interface Composition {
  */
 interface Design1 {
     /**
-     * Theme for the deck. Accepts two forms:
-     * - String shorthand: 'design.theme = "minimal"'. Bare id, HTTPS URL, or 'pkg:' reference resolved as the 'id' of a 'themes' catalog record.
-     * - Object form: a Theme with an optional 'id' base reference plus theme-level overrides.
-     *
-     * Inline overrides on design.colorScheme / design.fontScheme / design.background / design.dimensions take precedence over the resolved theme.
-     *
-     * Resolution order: inline catalogs.themes.records[] -> catalogs.themes.source -> default catalog at https://www.pptx.gallery/themes.
+     * A content reference: a bare id ('two-column') or 'name:id' ('acme:hero'), where the prefix names a group of 'catalogs'. URLs and 'pkg:' strings are not references; a named catalog group replaces them. See Catalogs for the resolution order.
      */
-    theme?: (string | Theme);
+    theme?: string;
     /**
      * Color scheme for the presentation. Accepts two forms:
-     * - String shorthand: 'design.colorScheme = "cool-horizon"'. Bare id, HTTPS URL, or 'pkg:' reference resolved as the 'id' of a 'colorSchemes' catalog record.
-     * - Object form: a ColorScheme with an optional 'id' base reference plus slot/role overrides.
+     * - A colorSchemes reference: a bare id ('cool-horizon') or 'name:id' ('acme:ocean').
+     * - Object form: a ColorScheme with an optional 'id' reference as the base plus slot/role overrides. Without 'id', the overrides apply on top of the engine default colour scheme.
      *
-     * Resolution order: inline catalogs.colorSchemes.records[] -> catalogs.colorSchemes.source -> default catalog at https://www.pptx.gallery/color-schemes.
+     * Without either, the theme's colorScheme applies, then the engine default colour scheme.
      */
     colorScheme?: (string | ColorScheme);
     /**
      * Font scheme for heading, body, accent, and code text. Accepts two forms:
-     * - String shorthand: 'design.fontScheme = "aptos"'. Bare id, HTTPS URL, or 'pkg:' reference resolved as the 'id' of a 'fontSchemes' catalog record.
-     * - Object form: a FontScheme with an optional 'id' base reference plus pair/role overrides.
+     * - A fontSchemes reference: a bare id ('aptos') or 'name:id' ('acme:inter').
+     * - Object form: a FontScheme with an optional 'id' reference as the base plus pair/role overrides.
      *
-     * Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.source -> default catalog at https://www.pptx.gallery/font-schemes.
+     * Without either, the theme's fontScheme applies, then the engine default font scheme.
      */
     fontScheme?: (string | FontScheme);
     /**
@@ -3103,7 +3104,7 @@ interface Design1 {
      */
     dimensions?: (DimensionPreset | Dimensions);
     /**
-     * Default slide background applied across the deck unless overridden on a slide. String shorthand accepts theme slots ('light1', 'light2', 'dark1', 'dark2') or hex colors; object forms support theme, solid, gradient, image, or pattern fills.
+     * Default slide background applied across the deck unless overridden on a slide (slides.N.design.background); the resolved theme's background is the fallback. A background is the only canvas fill and never moves content. String shorthand accepts theme slots ('light1', 'light2', 'dark1', 'dark2'), hex colors, or an image source starting with 'asset:', 'https://', 'data:', './' or '../' (a cover image); object forms support theme, solid, gradient, image, or pattern fills.
      */
     background?: (BackgroundShortcut | Background);
     /**
@@ -3134,110 +3135,18 @@ interface Design1 {
      * Whether body/content regions are rendered inside a visible card or surface. Effective value: the slide's design, then the deck's design, then the layout record's design.contentBox, then the engine default.
      */
     contentBox?: boolean;
-    /**
-     * Optional slide-level image, separate from content images. It applies to a slide that sets its own design.slideImage, and to slides whose layout record sets design.slideImage or whose root image is the same source as a deck-level value. A root image with the same source becomes the slide image instead of a content item. Blur, shadows, soft edges, background removal and device artwork are not part of the treatment vocabulary; see docs/image-treatments.md.
-     */
-    slideImage?: (Asset | {
-        /**
-         * Source for the slide-level image. When omitted in a design override, the object only configures how a slide-level image should be placed when one is supplied by a content payload, asset, or renderer convention.
-         */
-        src?: string;
-        /**
-         * Where the slide-level image sits relative to the content. 'background' is a full-bleed image behind the content. The other positions give the image a band along that edge (see size) and compose headings and content in the rest of the slide.
-         */
-        position: ("background" | "top" | "bottom" | "left" | "right");
-        /**
-         * Alternative text for the slide-level image. Overrides the alt text of a referenced asset.
-         */
-        alt?: string;
-        /**
-         * How the image fills its frame: 'crop' covers the frame from the center; 'fit' shows the whole image centered inside it. Overrides design.imageFill for this image. Default: design.imageFill, else 'crop'.
-         */
-        fill?: ("crop" | "fit");
-        /**
-         * Share of the slide width (left/right) or height (top/bottom) given to the image band. Ignored for 'background'. Default 0.5.
-         */
-        size?: number;
-        /**
-         * Place the frame inside the slide padding instead of edge to edge, like a card. Default false.
-         */
-        inset?: boolean;
-        /**
-         * Width-to-height ratio of the frame. The frame becomes the largest centered box with this ratio inside the band or slide, for example 2.39 for a cinematic letterbox or 0.5 for a phone-shaped frame. 'circle' always uses 1.
-         */
-        aspectRatio?: number;
-        /**
-         * Mask applied to the frame, exported as the picture's native preset geometry (rect, roundRect, ellipse, hexagon). 'circle' makes the frame square. Default 'rectangle'.
-         */
-        shape?: ("rectangle" | "rounded" | "circle" | "hexagon");
-        /**
-         * Corner radius for shape 'rounded' as a fraction of the frame's shorter side. Default 0.16667, PowerPoint's roundRect default.
-         */
-        cornerRadius?: number;
-        /**
-         * Solid line along the frame's shape. A thick dark border on a rounded portrait frame gives a device bezel.
-         */
-        border?: {
-            /**
-             * Line color: a hex color, a color-scheme slot or role name, or a 'var:<id>' variable reference.
-             */
-            color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
-            /**
-             * Line width in reference pixels at a 720-pixel short edge, centered on the frame outline like a native picture line. 0 removes the line.
-             */
-            width: number;
-        };
-        /**
-         * Image opacity from 0 to 1, exported as a native alphaModFix. The border and overlay keep their own opacity. Default 1.
-         */
-        opacity?: number;
-        /**
-         * Color treatment for the image pixels. Luminance uses Rec. 601 weights (0.299, 0.587, 0.114) on sRGB values.
-         */
-        recolor?: ("grayscale" | {
-            /**
-             * Color at luminance 0.
-             */
-            dark: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
-            /**
-             * Color at luminance 1.
-             */
-            light: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
-        });
-        /**
-         * Solid scrim drawn over the image in the frame's shape, beneath headings and content, for example to keep overlaid text readable. Exported as a native shape above the picture.
-         */
-        overlay?: {
-            /**
-             * Overlay fill color.
-             */
-            color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
-            /**
-             * Overlay fill opacity.
-             */
-            opacity: number;
-            /**
-             * Cover only a band along this edge of the frame, for example a caption strip. Rectangle frames only; other shapes report unsupported-image-treatment and draw no overlay. Omit to cover the whole frame.
-             */
-            edge?: ("top" | "bottom" | "left" | "right");
-            /**
-             * Band share of the frame for an edge overlay. Default 0.3.
-             */
-            size?: number;
-        };
-    });
     /**
      * Axis along which parallel body content is arranged. Sets the root arrangement mode of blocks and root payloads when no composition.mode is set on the slide or on its layout record: 'vertical' is column, 'horizontal' is row. Precedence: composition.mode (the slide's own, else the layout record's geometry contract), then the effective value (slide design, then deck design, then the layout record's design.contentDirection), then automatic selection. A layout that carries a composition.mode keeps its grid or direction whatever this value says. Promoted regions (left, top:left, ...) keep their explicit geometry and nested groups keep their own composition.
      */
     contentDirection?: ("horizontal" | "vertical");
     /**
-     * Where the primary chart sits relative to supporting content. Effective value: slide design, then deck design, then the layout record's design.chartPrimary. When the slide has no promoted regions and no composition.mode of its own, and its root nodes mix at least one chart with other content, the first chart becomes a primary track and the other nodes form one synthetic sub-grid: 'left'/'right' is a two-track row and 'top'/'bottom' a two-track column, weighted 3:2 in favor of the chart; explicit root columns and weights are ignored while it applies. 'none' (the default) keeps the ordinary automatic grid with equal weight.
+     * Where the primary chart sits relative to supporting content. Effective value: slide design, then deck design, then the layout record's design.chartPrimary. When the slide has no promoted regions and no composition.mode of its own, and its root nodes mix at least one chart with other content, the first chart becomes a primary track and the other nodes form one synthetic sub-grid: 'left'/'right' is a two-track row and 'top'/'bottom' a two-track column, weighted 3:2 in favor of the chart; explicit root columns and weights are ignored while it applies. 'none' (the default) keeps the ordinary automatic grid with equal weight. It is shorthand for a placeholder group (layout.schema.json PlaceholderGroup): the slide composes exactly as on a layout record whose root composition is that weighted row or column and whose placeholders are the chart and one automatic group of the other content, and while it applies it replaces the layout record's own placeholder groups as well.
      */
     chartPrimary?: ("none" | "top" | "bottom" | "left" | "right");
     /**
-     * How images fill their allocated region: crop covers the region, fit shows the whole image. Effective value: the slide's design, then the deck's design, then the layout record's design.imageFill, then the engine default.
+     * Default fit of image blocks (and Slide.image) that set no fit of their own: 'cover' fills the frame and crops what overflows around the block's focus, 'contain' shows the whole picture centered in the frame, 'stretch' scales it to the frame exactly. Effective value: the slide's design, then the deck's design, then the layout record's design.imageFit, then 'cover'. Backgrounds set their own fit.
      */
-    imageFill?: ("crop" | "fit");
+    imageFit?: ("cover" | "contain" | "stretch");
     /**
      * Marker style for items and bullets lists. Effective value: the slide's design, then the deck's design, then the layout record's design.listBullet, then 'character'. 'character' (the default) draws the glyph marker. 'image' draws the deck's icon logo (a slide's design.logo, then design.logo, then the primary organization's logo; light variants on dark backgrounds) as a picture bullet: a square of the marker's font size whose bottom sits on the marker baseline, so list geometry does not change. Without a logo the glyph is drawn and the engine reports unresolved-content at this field.
      */
@@ -3245,7 +3154,7 @@ interface Design1 {
     [k: string]: unknown;
 }
 /**
- * Portable dynamic composition. Slide fields override the resolved layout. Nested groups arrange their children independently, inheriting only minFontSize and overflow. Explicit promoted regions retain their positions.
+ * Portable dynamic composition. Slide fields override the resolved layout. Nested groups (content groups here, placeholder groups in a layout record) arrange their children independently, inheriting only minFontSize and overflow. Explicit promoted regions retain their positions.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Composition".
@@ -3374,197 +3283,128 @@ interface Assets {
     [k: string]: Asset;
 }
 /**
- * Optional per-kind catalog overrides. Each kind may declare a non-default 'source' and/or inline 'records' that override or supplement the default catalog at https://www.pptx.gallery/<kind>. References elsewhere in the document (e.g. design.theme, narrative) resolve through this section before falling back to the default catalog.
+ * The catalog records this document embeds, grouped by the catalog they came from: 'default' (the catalog bare ids come from), 'custom' (records the document defines itself) and any number of named catalogs ('acme', referenced as 'acme:<id>'). A saved document embeds every record it references, so it renders the same with no catalog registered. See Catalogs.
  */
 interface Catalogs {
-    narratives?: CatalogEntry;
-    themes?: CatalogEntry1;
-    colorSchemes?: CatalogEntry2;
-    fontSchemes?: CatalogEntry3;
-    languages?: CatalogEntry4;
-    layouts?: CatalogEntry5;
-    chartTypes?: CatalogEntry6;
-    tones?: CatalogEntry7;
-    purposes?: CatalogEntry8;
-    audiences?: CatalogEntry9;
-    socialPlatforms?: CatalogEntry10;
-    [k: string]: unknown;
-}
-/**
- * Catalog of narrative templates. Records validate against https://openpresentation.org/schema/opf-narrative/v1. A custom narrative goes in 'catalogs.narratives.records' and is referenced by its id from the root 'narrative'. Default source: https://www.pptx.gallery/narratives.
- */
-interface CatalogEntry {
     /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
+     * The catalog bare ids come from: its source and the records of it this document embeds. false turns off the catalog fallback for bare ids.
      */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
+    default?: (CatalogGroup | false);
     /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
+     * Records the document defines itself, referenced by bare id. Checked first for every bare id. Forking a catalog record copies it here under a new id, so the change of ownership is visible.
      */
-    records?: {
-        [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
-}
-/**
- * Catalog of themes. Records validate against https://openpresentation.org/schema/opf-theme/v1. Default source: https://www.pptx.gallery/themes.
- */
-interface CatalogEntry1 {
+    custom?: CatalogGroup;
     /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
+     * A named catalog: its source and the records of it this document embeds. References name it as a prefix ('acme:hero').
      */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
-    /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
-     */
-    records?: {
+    [k: string]: (CatalogGroup & {
         [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+    }) | CatalogGroup | false | undefined;
 }
 /**
- * Catalog of color schemes. Records validate against https://openpresentation.org/schema/opf-color-scheme/v1. Default source: https://www.pptx.gallery/color-schemes.
+ * One catalog group: the catalog's source and the records of it the document embeds, by kind and then by id.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "CatalogGroup".
  */
-interface CatalogEntry2 {
-    /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
-     */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
-    /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
-     */
-    records?: {
-        [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+interface CatalogGroup {
+    source?: CatalogSource;
+    layouts?: CatalogRecords;
+    themes?: CatalogRecords1;
+    colorSchemes?: CatalogRecords2;
+    fontSchemes?: CatalogRecords3;
+    narratives?: CatalogRecords4;
+    audiences?: CatalogRecords5;
+    purposes?: CatalogRecords6;
+    tones?: CatalogRecords7;
 }
 /**
- * Catalog of font schemes. Records validate against https://openpresentation.org/schema/opf-font-scheme/v1. Default source: https://www.pptx.gallery/font-schemes.
+ * Layout records keyed by id, each with the fields of https://openpresentation.org/schema/opf-layout/v1. Referenced from Slide.layout.
  */
-interface CatalogEntry3 {
-    /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
-     */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
+interface CatalogRecords {
     /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
+     * One embedded record: the fields of the kind's companion schema without '$schema' and 'id'.
      */
-    records?: {
+    [k: string]: {
         [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+    };
 }
 /**
- * Catalog of languages. Records validate against https://openpresentation.org/schema/opf-language/v1. Default source: https://www.pptx.gallery/languages.
+ * Theme records keyed by id, each with the fields of https://openpresentation.org/schema/opf-theme/v1. Referenced from design.theme.
  */
-interface CatalogEntry4 {
+interface CatalogRecords1 {
     /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
+     * One embedded record: the fields of the kind's companion schema without '$schema' and 'id'.
      */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
-    /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
-     */
-    records?: {
+    [k: string]: {
         [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+    };
 }
 /**
- * Catalog of slide layouts. Records validate against https://openpresentation.org/schema/opf-layout/v1. Default source: https://www.pptx.gallery/layouts.
+ * Colour-scheme records keyed by id, each with the fields of https://openpresentation.org/schema/opf-color-scheme/v1. Referenced from design.colorScheme and a theme's colorScheme.
  */
-interface CatalogEntry5 {
-    /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
-     */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
+interface CatalogRecords2 {
     /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
+     * One embedded record: the fields of the kind's companion schema without '$schema' and 'id'.
      */
-    records?: {
+    [k: string]: {
         [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+    };
 }
 /**
- * Catalog of chart types. Records validate against https://openpresentation.org/schema/opf-chart-type/v1. Default source: https://www.pptx.gallery/chart-types.
+ * Font-scheme records keyed by id, each with the fields of https://openpresentation.org/schema/opf-font-scheme/v1. Referenced from design.fontScheme, a theme's fontScheme and a language's font schemes.
  */
-interface CatalogEntry6 {
-    /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
-     */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
+interface CatalogRecords3 {
     /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
+     * One embedded record: the fields of the kind's companion schema without '$schema' and 'id'.
      */
-    records?: {
+    [k: string]: {
         [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+    };
 }
 /**
- * Catalog of presentation tones. Records validate against https://openpresentation.org/schema/opf-tone/v1. Default source: https://www.pptx.gallery/tones. Referenced from tone.
+ * Narrative records keyed by id, each with the fields of https://openpresentation.org/schema/opf-narrative/v1. Referenced from narrative.
  */
-interface CatalogEntry7 {
-    /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
-     */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
+interface CatalogRecords4 {
     /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
+     * One embedded record: the fields of the kind's companion schema without '$schema' and 'id'.
      */
-    records?: {
+    [k: string]: {
         [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+    };
 }
 /**
- * Catalog of presentation purposes. Records validate against https://openpresentation.org/schema/opf-purpose/v1. Default source: https://www.pptx.gallery/purposes. Referenced from purpose.
+ * Audience records keyed by id, each with the fields of https://openpresentation.org/schema/opf-audience/v1. Referenced from audience.
  */
-interface CatalogEntry8 {
+interface CatalogRecords5 {
     /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
+     * One embedded record: the fields of the kind's companion schema without '$schema' and 'id'.
      */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
-    /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
-     */
-    records?: {
+    [k: string]: {
         [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+    };
 }
 /**
- * Catalog of presentation audiences. Records validate against https://openpresentation.org/schema/opf-audience/v1. Default source: https://www.pptx.gallery/audiences. Referenced from audience.
+ * Purpose records keyed by id, each with the fields of https://openpresentation.org/schema/opf-purpose/v1. Referenced from purpose.
  */
-interface CatalogEntry9 {
-    /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
-     */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
+interface CatalogRecords6 {
     /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
+     * One embedded record: the fields of the kind's companion schema without '$schema' and 'id'.
      */
-    records?: {
+    [k: string]: {
         [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+    };
 }
 /**
- * Catalog of social-media platforms. Records validate against https://openpresentation.org/schema/opf-social-platform/v1. Default source: https://www.pptx.gallery/social-platforms. Referenced via the property keys of any Socials object (Organization.socials, Speaker.socials).
+ * Tone records keyed by id, each with the fields of https://openpresentation.org/schema/opf-tone/v1. Referenced from tone.
  */
-interface CatalogEntry10 {
-    /**
-     * Single source or an ordered search path of sources. When omitted, the engine falls back to the default catalog at https://www.pptx.gallery/<kind>, resolved from its bundled snapshot. Engines never fetch a source. The host loads the records itself and passes them to the renderer and exporter as a 'catalogSources' map from the source string to its records; a source with no entry in that map contributes no records, except the default catalog's own URL and the '@openpresentation/opf' package, which resolve from the bundled snapshot.
-     */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
+interface CatalogRecords7 {
     /**
-     * Inline catalog records embedded in this OPF document. Each record validates against the kind's companion schema (e.g. https://openpresentation.org/schema/opf-narrative/v1 for narratives). Inline records win over anything resolved from 'source' and over the default catalog.
+     * One embedded record: the fields of the kind's companion schema without '$schema' and 'id'.
      */
-    records?: {
+    [k: string]: {
         [k: string]: unknown;
-    }[];
-    [k: string]: unknown;
+    };
 }
 
-export type { Presentation as P };
+export type { Chart as C, Presentation as P };