@openpresentation/opf 0.13.0 → 0.15.1

package/dist/{presentation-mG-IYErQ.d.ts → presentation-CDKQVkyI.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;
+/**
+ * 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 catalog record and override selected fields, or use 'name' for a custom inline tone.
+ * 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,21 +193,21 @@ 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.
+ * 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" | "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, mediaType, or format matters.
+ * 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.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Asset".
@@ -272,11 +233,30 @@ type Asset = (string | {
      * Optional MIME media type when it cannot be inferred from src.
      */
     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. 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".
+ */
+type Watermark = ({
     /**
-     * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
+     * Source for the watermark image: an 'asset:<id>' reference, HTTPS URL, data URI, relative path or local path, as for Asset.src. Exactly one of src and text is set.
      */
-    format?: string;
-});
+    src?: string;
+    /**
+     * Text for a text watermark, such as DRAFT or CONFIDENTIAL; line breaks are drawn as spaces. Exactly one of src and text is set.
+     */
+    text?: string;
+    /**
+     * Watermark opacity from 0 (fully transparent) to 1 (fully opaque).
+     */
+    opacity: number;
+} & Watermark1);
+type Watermark1 = {
+    [k: string]: unknown;
+};
 /**
  * A single named variable: a hex string (shorthand for a color variable) or an object whose 'type' is color, text, number, date, image, url or list. 'value' is the current value and is optional: a variable with no value is unfilled, which a template allows and a normal deck does not. 'example' only illustrates the slot (fill forms, template previews) and never reaches output.
  *
@@ -320,11 +300,19 @@ type TextRun = (string | {
      */
     fontSize?: number;
     /**
-     * Run font family override.
+     * Run font family override. It wins over the code font a run with 'code' takes.
      */
     fontFamily?: string;
     /**
-     * URL to link the run text to.
+     * Whether the run is an inline code span: it is drawn in the design's code font (design.fontScheme.code, else the resolved font scheme's code family, else Roboto Mono), unless the run names its own fontFamily. Only the font changes; there is no background, because a PPTX run cannot have one. Markdown backticks read and write code runs.
+     */
+    code?: boolean;
+    /**
+     * BCP-47 language tag of the run, such as 'fr-FR' or 'ja-JP', when it differs from the deck language. It sets the proofing language (PPTX a:rPr lang) and the language the run's script fonts and glyph variants follow (for example the Japanese or the Simplified Chinese face for Han characters); without it the run follows the deck language.
+     */
+    lang?: string;
+    /**
+     * URL to link the run text to: an http(s) URL, a 'mailto:' address or a 'tel:' number, without whitespace. The preview draws it as a link and PPTX export writes a native hyperlink for all three; any other scheme is not valid.
      */
     link?: string;
     /**
@@ -336,11 +324,11 @@ type TextRun = (string | {
      */
     subscript?: boolean;
     /**
-     * One or more ids from the top-level references list that this run cites. Engines draw a superscript marker ('1', or '1,2' for several ids) directly after the run and list '<n> <reference text>' in the slide's footnote area; markers are numbered per deck in order of first use, and the same id keeps its number. An id missing from references is a validation error (cite-unknown-reference). Supported in text, bullets and list item runs.
+     * One or more ids from the top-level references list that this run cites. Engines draw a superscript marker ('1', or '1,2' for several ids) directly after the run and list '<n> <reference text>' in the slide's footnote area; markers are numbered per deck in order of first use, and the same id keeps its number. An id missing from references is a validation error (cite-unknown-reference). Supported in text, bullets and list item runs, in the slide title, subtitle and tag, and in the quote text.
      */
     cite?: (string | [string, ...(string)[]]);
     /**
-     * An inline note for this run, without a references entry. Engines draw a superscript marker after the run and list the note in the slide's footnote area; every footnote takes a new number in the deck's marker sequence. Supported in text, bullets and list item runs.
+     * An inline note for this run, without a references entry. Engines draw a superscript marker after the run and list the note in the slide's footnote area; every footnote takes a new number in the deck's marker sequence. Supported in text, bullets and list item runs, in the slide title, subtitle and tag, and in the quote text.
      */
     footnote?: (string | [TextRun, ...(TextRun)[]]);
     [k: string]: unknown;
@@ -467,7 +455,7 @@ type ContentPayload = {
      */
     numbering?: (NumberingStyle | Numbering | [(NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)]);
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     image?: (string | {
         /**
@@ -490,13 +478,46 @@ type ContentPayload = {
          * Optional MIME media type when it cannot be inferred from src.
          */
         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);
         /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
+         * Color at luminance 1.
          */
-        format?: string;
+        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, mediaType, or format matters.
+     * 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.
      */
     video?: (string | {
         /**
@@ -519,10 +540,6 @@ type ContentPayload = {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     chart?: Chart1;
     table?: Table1;
@@ -531,11 +548,11 @@ type ContentPayload = {
      */
     code?: (string | Code);
     /**
-     * Metric payload. A string or number is shorthand for { "value": value }; object form carries optional label, description, unit, delta, and trend metadata. Numeric values remain numbers; renderers format them for display.
+     * Metric payload. A string or number is shorthand for { "value": value }; object form carries optional label, description, unit, delta, trend, and sentiment metadata. Numeric values remain numbers; renderers format them for display.
      */
     metric?: (string | number | Metric);
     /**
-     * Quote payload. A string is shorthand for { "text": value }; object form carries optional attribution and source metadata.
+     * Quote payload. A string is shorthand for { "text": value }; object form carries optional attribution, role, photo and source metadata.
      */
     quote?: (string | Quote);
     /**
@@ -583,10 +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>]'; resolved through a locally-installed package on the engine's package path.
+ * 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".
@@ -595,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 {
     /**
@@ -605,67 +619,68 @@ interface Presentation {
      */
     $schema?: "https://openpresentation.org/schema/opf/v1";
     /**
-     * Display name of the presentation for GUI/TUI lists, library/search indexing, OS-level metadata, and default export filenames. This is deck identity, not slide content. Use slides[].title and slides[].subtitle for text that should appear on presented slides.
+     * Display name of the presentation for GUI/TUI lists, library/search indexing, OS-level metadata, and default export filenames. This is deck identity, not slide content. Use slides[].title and slides[].subtitle for text that should appear on presented slides. Also the built-in variable 'deck.name'.
      */
     name?: string;
     /**
-     * Free-form prose describing what this presentation is about. Used by agents and humans as a deck-level summary; complements purpose (the goal) and narrative (the structured storyline). Round-trips to OOXML 'docProps/core.xml' as '<dc:description>' (PowerPoint surfaces this as the 'Comments' field in File → Properties).
+     * Free-form prose describing what this presentation is about. Used by agents and humans as a deck-level summary; complements purpose (the goal) and narrative (the structured storyline). Round-trips to OOXML 'docProps/core.xml' as '<dc:description>' (PowerPoint surfaces this as the 'Comments' field in File → Properties). Also the built-in variable 'deck.description'.
      */
     description?: string;
     /**
-     * Optional base filename for exports (without extension). Engine strips a trailing .pptx, .pdf, .png, or .svg (case-insensitive) and appends the target format's extension. When omitted, the engine slugifies name when present. See /docs/opf for full validation rules.
+     * Optional base filename for exports (without extension). The opf CLI (render, export) and the editor strip a trailing .pptx, .pdf, .png, or .svg (case-insensitive) and append the target format's extension. When omitted, they slugify name; with no usable name the CLI uses the input file name and the editor uses 'presentation'. See /docs/opf for full validation rules.
      */
     filename?: string;
     /**
-     * Organization associated with the presentation, usually the presenting company. Array form supports hosts, partners, clients, and sponsors. The primary organization (declared via Organization.role or, if no role is set, the first item) drives default branding such as cover-slide logo.
+     * Organization associated with the presentation, usually the presenting company. Array form supports hosts, partners, clients, and sponsors. The primary organization (Organization.role 'primary', else the first item) supplies the default deck logo, the 'organization' and 'socials' header/footer fields and the 'organization.<field>' built-in variables; the others are available by id as 'organization.<id>.<field>' and are not drawn automatically.
      */
     organization?: (Organization | [Organization, ...(Organization)[]]);
     /**
-     * Person presenting the deck. Array form supports panels and multi-speaker decks. Used for cover slides, bio slides, footers, and panel attribution.
+     * Person presenting the deck. Array form supports panels and multi-speaker decks. The first speaker is the primary speaker: the built-in variables 'speaker.<field>' and the 'speaker' header/footer field read it, 'speakers' lists every name, and 'speaker.<id>.<field>' addresses one by id. A speaker is drawn nowhere else.
      */
     speaker?: (Speaker | [Speaker, ...(Speaker)[]]);
     /**
-     * Optional credit for the person who authored or contributed to the deck, distinct from speaker. Array form supports multiple contributors. Round-trips to OOXML 'docProps/core.xml' as '<dc:creator>' (semicolon-joined when multiple) and seeds '<cp:lastModifiedBy>' on first write; subsequent edits in PowerPoint overwrite '<cp:lastModifiedBy>' with the editing user.
+     * Optional credit for the person who authored or contributed to the deck, distinct from speaker. Array form supports multiple contributors. Round-trips to OOXML 'docProps/core.xml' as '<dc:creator>' (semicolon-joined when multiple) and seeds '<cp:lastModifiedBy>' on first write; subsequent edits in PowerPoint overwrite '<cp:lastModifiedBy>' with the editing user. Also the built-in variable 'deck.author' (an array joined with ', ').
      */
     author?: (string | [string, ...(string)[]]);
     /**
-     * Intended audiences for the presentation. Accepts either:
-     * - A single string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executive'), an HTTPS URL, or a 'pkg:' reference.
-     * - An array of string shorthands and/or inline Audience objects for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.
+     * Intended audiences for the presentation. Accepts any of:
+     * - 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 | [(string | Audience), ...((string | 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.
      */
     takeaway?: (string | [string, ...(string)[]]);
     /**
-     * Target presentation duration, as an integer number of minutes. Used by AI to set pace and depth, and to compare against the resolved narrative's durationRange.
+     * Target presentation duration, as an integer number of minutes. The opf-render presenter view counts the elapsed time against it, and core validate warns when it lies outside the resolved narrative's 'duration' range. Agents can also use it to set pace and depth. Nothing else reads it: the preview and the PPTX export draw no duration.
      */
     duration?: number;
     /**
@@ -679,17 +694,9 @@ interface Presentation {
      */
     template?: boolean;
     /**
-     * Structured storyline describing the deck's arc and beats. Resolves to the 'id' of a 'narratives' catalog record.
-     *
-     * Accepts two forms:
-     * - String shorthand for the common case: 'narrative = "classic-story"'. Accepts a bare id (lowercase kebab-case), an HTTPS URL pointing at a record file, or a 'pkg:' reference to a locally-installed package.
-     * - Object form for inline overrides or fully custom narratives: 'narrative = { id: "classic-story", beats: [...] }'. The object shape mirrors https://openpresentation.org/schema/opf-narrative/v1 (sans '$schema'), so a library record and an inline narrative are interchangeable.
-     *
-     * 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 aren't part of the storyline (audience, tone, takeaway, duration) live as siblings on the presentation root rather than inside the narrative object.
+     * 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 | Narrative);
+    narrative?: string;
     /**
      * Ordered array of slides that make up the presentation.
      *
@@ -697,7 +704,7 @@ interface Presentation {
      */
     slides: [Slide, ...(Slide)[]];
     /**
-     * Sources that text runs cite with 'cite'. Ids are unique. A cited reference is listed in the footnote area of every slide that cites it, with a marker number assigned per deck in order of first use; a reference no run cites is a lint warning (opf/unused-reference). referencesSlide() turns the cited references into an ordinary list slide.
+     * Sources that text runs cite with 'cite'. Ids are unique. A cited reference is listed in the footnote area of every slide that cites it, with a marker number assigned per deck in order of first use; a reference no run cites is the warning opf/unused-reference. referencesSlide() turns the cited references into an ordinary list slide.
      */
     references?: Reference[];
     datasets?: Datasets;
@@ -711,26 +718,26 @@ interface Presentation {
     };
 }
 /**
- * An organization associated with the presentation — typically the presenting company, but also hosts, partners, clients, or sponsors. Surfaced on cover slides, footers, and brand bars; the primary organization's logo is the default deck logo unless overridden by design.logo.
+ * An organization associated with the presentation, typically the presenting company, but also hosts, partners, clients, or sponsors. The primary organization (role 'primary', else the first one) supplies the default deck logo (unless design.logo overrides it), the 'organization' header/footer field (its name) and the 'socials' field (its socials). Every field is also a built-in variable ('{{organization.name}}', 'var:organization.logo', 'organization.<id>.<field>'). Nothing else about an organization is drawn automatically. See docs/templates-and-variables.md.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Organization".
  */
 interface Organization {
     /**
-     * Stable identifier for the organization, used to reference it from Speaker.organizationId. Must be unique within the deck.
+     * Stable identifier for the organization, used to reference it from Speaker.organizationId and to address it in built-in variables as 'organization.<id>.<field>'. Must be unique among organizations (a duplicate is a validation error).
      */
     id: string;
     /**
-     * Display name shown on slides.
+     * Display name. Drawn by the 'organization' header/footer field for the primary organization; the built-in variable 'organization.name' (or 'organization.<id>.name') carries it into any string.
      */
     name: string;
     /**
-     * Optional legal entity name when it differs from the display name.
+     * Optional legal entity name when it differs from the display name. Never drawn automatically; available as the built-in variable 'organization.legalName'.
      */
     legalName?: string;
     /**
-     * Source for the organization's logo image. Accepts an HTTPS URL, data URI, relative path (resolved against the OPF file location), local path, or 'asset:<id>' reference. Common formats are SVG (preferred for vector logos), PNG (with transparency), or JPG. The primary organization's logo (role 'primary', else the first organization) is the fallback source wherever the deck logo is drawn: a slide's design.logo, then design.logo, then this value. It is therefore drawn on cover and section slides and by header/footer zones with logo: true, exactly as design.logo would be (see design.logo and docs/design-resolution.md).
+     * Source for the organization's logo image. Accepts an HTTPS URL, data URI, relative path (resolved against the OPF file location), local path, or 'asset:<id>' reference. Common formats are SVG (preferred for vector logos), PNG (with transparency), or JPG. The primary organization's logo (role 'primary', else the first organization) is the fallback source wherever the deck logo is drawn: a slide's design.logo, then design.logo, then this value. It is therefore drawn on cover and section slides and by header/footer zones with logo: true, exactly as design.logo would be (see design.logo and docs/design-resolution.md). It is also the built-in image variable 'organization.logo' (or 'organization.<id>.logo'), placed with 'var:organization.logo' in an image field.
      */
     logo?: (string | {
         /**
@@ -753,29 +760,25 @@ interface Organization {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * Bare internet domain for the organization. Used for footers, contact slides, and engine-driven asset lookups (e.g., favicon-based brand defaults).
+     * Bare internet domain for the organization. Never drawn automatically and not used to look up assets; available as the built-in variable 'organization.domain'.
      */
     domain?: string;
     /**
-     * General contact email for the organization. Used on contact slides and footer attribution.
+     * General contact email for the organization. Never drawn automatically; available as the built-in variable 'organization.email'.
      */
     email?: string;
     /**
-     * Main contact phone number for the organization. E.164 format is recommended.
+     * Main contact phone number for the organization. E.164 format is recommended. Never drawn automatically; available as the built-in variable 'organization.phone'.
      */
     phone?: string;
     /**
-     * Short tagline rendered alongside the organization name on cover slides.
+     * Short tagline. Never drawn automatically (cover slides do not show it); available as the built-in variable 'organization.tagline', for example in a footer 'text' of '{{organization.tagline}}'.
      */
     tagline?: string;
     /**
-     * Role of the organization relative to the presentation. When omitted, the single organization or first organization in array form is treated as primary.
+     * Role of the organization relative to the presentation. Only 'primary' has behavior: it selects the primary organization (deck logo, 'organization' and 'socials' header/footer fields, and the 'organization.<field>' built-ins). When no organization has role 'primary', the first one is primary. 'partner', 'client', 'sponsor' and 'host' are descriptive labels that change nothing.
      */
     role?: ("primary" | "partner" | "client" | "sponsor" | "host");
     socials?: Socials;
@@ -791,26 +794,26 @@ interface Socials {
     [k: string]: string;
 }
 /**
- * A person presenting the deck. Used for cover slides, bio/intro slides, footer attribution, and panel formats with multiple presenters.
+ * A person presenting the deck. A speaker is drawn only through built-in variables ('{{speaker.name}}' inside any string, 'var:speaker.photo' as a whole image field) and the 'speaker' header/footer field (the first speaker's name and title). No layout, cover or bio slide places a speaker on its own. See docs/templates-and-variables.md.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Speaker".
  */
 interface Speaker {
     /**
-     * Stable identifier for the speaker, used for cross-references within the deck. Must be unique within the deck.
+     * Stable identifier for the speaker. Must be unique among speakers (a duplicate is a validation error). Addresses this speaker in built-in variables as 'speaker.<id>.<field>', such as '{{speaker.alice.title}}'.
      */
     id: string;
     /**
-     * Display name.
+     * Display name. Built-in variable 'speaker.name' (first speaker) or 'speaker.<id>.name'; the first speaker's name is also drawn by the 'speaker' header/footer field and every name is listed by 'speakers'.
      */
     name: string;
     /**
-     * Role or title. Often paired with the speaker's organization on cover slides.
+     * Role or title. Built-in variable 'speaker.title'; the 'speaker' header/footer field draws it after the name ('Alice Chen, VP of Engineering').
      */
     title?: string;
     /**
-     * Source for the speaker's headshot image. Accepts an HTTPS URL, data URI, relative path (resolved against the OPF file location), local path, or 'asset:<id>' reference. Common formats are JPG or PNG; SVG is not appropriate for photographic content. Authoring metadata for hosts and layouts (cover and bio slides built by a host): the reference renderer and exporter do not draw it, because no slide field or layout slot places a speaker; it round-trips through PPTX provenance.
+     * Source for the speaker's headshot image. Accepts an HTTPS URL, data URI, relative path (resolved against the OPF file location), local path, or 'asset:<id>' reference. Common formats are JPG or PNG; SVG is not appropriate for photographic content. Never drawn automatically: it is the built-in image variable 'speaker.photo' (or 'speaker.<id>.photo'), placed with 'var:speaker.photo' in a slide's image field. It also round-trips through PPTX provenance.
      */
     photo?: (string | {
         /**
@@ -833,32 +836,28 @@ interface Speaker {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * Contact email, used on contact slides or footer attribution when appropriate.
+     * Contact email. Never drawn automatically; available as the built-in variable 'speaker.email'.
      */
     email?: string;
     /**
-     * Contact phone number for the speaker. E.164 format is recommended.
+     * Contact phone number for the speaker. E.164 format is recommended. Never drawn automatically; available as the built-in variable 'speaker.phone'.
      */
     phone?: string;
     /**
-     * Short biographical paragraph for bio or 'about the speaker' slides.
+     * Short biographical paragraph. Never drawn automatically; available as the built-in variable 'speaker.bio', for a bio or 'about the speaker' slide you write.
      */
     bio?: string;
     /**
-     * Reference to an Organization.id in organization. Lets a speaker be attributed to their org in panel or multi-org decks without repeating organization details.
+     * Reference to an Organization.id in organization; it must name an existing organization (a validation error otherwise). Attribution metadata for hosts: no engine draws it or changes which organization is primary because of it.
      */
     organizationId?: string;
     socials?: Socials1;
     [k: string]: unknown;
 }
 /**
- * Optional social media handles or URLs for the speaker. Authoring metadata: no header/footer field renders speaker socials yet.
+ * Optional social media handles or URLs for the speaker. Authoring metadata only: nothing draws speaker socials and there is no built-in variable for them (the 'socials' header/footer field draws the primary organization's socials).
  */
 interface Socials1 {
     /**
@@ -866,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);
     /**
@@ -901,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);
     /**
@@ -909,7 +955,7 @@ interface Design {
      */
     logo?: (Asset | LogoSet);
     /**
-     * Optional decorative watermark applied across slides. Use false to suppress an inherited watermark in slide-level design; a string is equivalent to { src: value }.
+     * Optional decorative watermark applied across slides: an image or a text stamp, in the fixed frame and at the opacity described on Watermark. Use false to suppress an inherited watermark in slide-level design; a string or Asset is the image at opacity 0.08.
      */
     watermark?: (false | Asset | Watermark);
     /**
@@ -921,191 +967,50 @@ interface Design {
      */
     footer?: (false | HeaderFooter);
     /**
-     * Default horizontal alignment for title placeholders in resolved layouts.
+     * Default horizontal alignment for title placeholders in resolved layouts. Effective value: the slide's design, then the deck's design, then the layout record's design.titleAlignment, then the engine default.
      */
     titleAlignment?: ("left" | "center" | "right");
     /**
-     * Default horizontal alignment for body/content regions in resolved layouts.
+     * Default horizontal alignment for body/content regions in resolved layouts. Effective value: the slide's design, then the deck's design, then the layout record's design.contentAlignment, then the engine default. A cover's tag and subtitle follow titleAlignment unless the slide's own design sets contentAlignment.
      */
     contentAlignment?: ("left" | "center" | "right");
     /**
-     * Whether body/content regions are rendered inside a visible card or surface.
+     * 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 declares slideImage: true 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" | "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" | "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" | "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" | "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 this value (slide design, then deck design), then the layout record's slideLayoutDirection, 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.
+     * 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 contentTypeChartPrimary. 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.
      */
     chartPrimary?: ("none" | "top" | "bottom" | "left" | "right");
     /**
-     * How picture placeholders fill their allocated region.
+     * 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. '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.
+     * 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. 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.
+ * 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.
  *
  * Two parallel models are supported and may be mixed:
  * - 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, custom) - 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.
+ * - 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;
     /**
@@ -1149,7 +1054,7 @@ interface ColorScheme {
      */
     light2?: string;
     /**
-     * Hyperlink color (hex). OOXML hlink.
+     * Hyperlink color (hex). OOXML hlink. Link runs with no color of their own are drawn underlined in it, in the preview and in PowerPoint, unless it has under 4.5:1 contrast against the slide background, then in the slide text color.
      */
     hyperlink?: string;
     /**
@@ -1169,27 +1074,21 @@ interface ColorScheme {
      */
     accent?: string;
     /**
-     * Abstract role: default slide background color (hex). The engine maps this to one of light1 / light2 / dark1 / dark2 when serializing.
+     * Abstract role: default slide background color (hex), used when the design names no single-color background (and for gradient and picture backgrounds). Overrides light1 as that default.
      */
     background?: string;
     /**
-     * Abstract role: color for elevated surfaces such as cards and panels (hex).
+     * Abstract role: color for elevated surfaces such as cards and panels (hex). Overrides the default of light2 (dark2 on a dark slide).
      */
     surface?: string;
     /**
-     * Abstract role: primary body text color (hex).
+     * Abstract role: primary body text color (hex). Overrides dark1 on a light slide only; a dark slide always uses light1.
      */
     text?: string;
     /**
-     * Abstract role: secondary or muted text color used for captions and supporting copy (hex).
+     * Abstract role: secondary or muted text color used for captions and supporting copy (hex). Overrides the default of dark2 (light2 on a dark slide).
      */
     textSecondary?: string;
-    /**
-     * Map of custom named colors for advanced or theme-specific use.
-     */
-    custom?: {
-        [k: string]: string;
-    };
     [k: string]: unknown;
 }
 /**
@@ -1197,18 +1096,16 @@ interface ColorScheme {
  *
  * Two parallel models are supported and may be mixed:
  * - 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 objects 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.
+ * - 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;
     /**
@@ -1250,105 +1147,47 @@ interface FontScheme {
      */
     type?: ("sans-serif" | "serif" | "monospace");
     /**
-     * Target application this font pairing is intended for.
-     */
-    app?: ("PowerPoint" | "Google Slides");
-    /**
-     * OOXML font-language family this scheme is intended for: 'latin' for Latin-script content, 'ea' for East Asian scripts, 'cs' for Complex Scripts. As the design font scheme, an 'ea' or 'cs' scheme also fills that script slot with its own major/minor families when its languages list is empty or names the presentation language.
-     */
-    languageFamily?: ("latin" | "ea" | "cs");
-    heading?: Font;
-    body?: Font1;
-    accent?: Font2;
-    code?: Font3;
-    [k: string]: unknown;
-}
-/**
- * Abstract role: font used for slide titles and headings. Maps onto the OOXML major slot when serializing.
- */
-interface Font {
-    /**
-     * Font family name.
-     */
-    family: string;
-    /**
-     * Numeric font weight (e.g., 400 for regular, 700 for bold).
-     */
-    weight?: number;
-    /**
-     * Font style.
-     */
-    style?: ("normal" | "italic");
-    /**
-     * Letter spacing (tracking) in ems.
-     */
-    letterSpacing?: number;
-    [k: string]: unknown;
-}
-/**
- * Abstract role: font used for body copy. Maps onto the OOXML minor slot when serializing.
- */
-interface Font1 {
-    /**
-     * Font family name.
+     * Target application this font pairing is intended for. Metadata for pickers and catalog filters: no engine changes its output by it.
      */
-    family: string;
+    app?: ("powerpoint" | "google-slides");
     /**
-     * Numeric font weight (e.g., 400 for regular, 700 for bold).
+     * Font-language family this scheme is intended for: 'latin' for Latin-script content, 'ea' (or 'eastAsian', the same value) for East Asian scripts, 'cs' (or 'complexScript', the same value) for Complex Scripts. The long names match the 'eastAsian' and 'complexScript' slot keys; the short names match the OOXML a:ea and a:cs elements; core reads both spellings as one value. As the design font scheme, an 'ea'/'eastAsian' or 'cs'/'complexScript' scheme also fills that script slot with its own major/minor families when its languages list is empty or names the presentation language.
      */
-    weight?: number;
-    /**
-     * Font style.
-     */
-    style?: ("normal" | "italic");
-    /**
-     * Letter spacing (tracking) in ems.
-     */
-    letterSpacing?: number;
-    [k: string]: unknown;
-}
-/**
- * Abstract role: font used for accent text. When set, the slide tag (eyebrow) and the quote body use this family instead of the body and heading families; nothing else changes. resolveFontFamilies() returns it as accent only when the scheme defines it. No direct OOXML slot: PPTX export writes it on those runs, and the theme fonts stay major/minor.
- */
-interface Font2 {
+    languageFamily?: ("latin" | "ea" | "cs" | "eastAsian" | "complexScript");
     /**
-     * Font family name.
+     * Abstract role: font family name used for slide titles and headings. Maps onto the OOXML major slot when serializing.
      */
-    family: string;
+    heading?: string;
     /**
-     * Numeric font weight (e.g., 400 for regular, 700 for bold).
+     * Abstract role: font family name used for body copy. Maps onto the OOXML minor slot when serializing.
      */
-    weight?: number;
+    body?: string;
     /**
-     * Font style.
+     * Abstract role: font family name used for accent text. When set, the slide tag (eyebrow) and the quote body use this family instead of the body and heading families; nothing else changes. resolveFontFamilies() returns it as accent only when the scheme defines it. No direct OOXML slot: PPTX export writes it on those runs, and the theme fonts stay major/minor.
      */
-    style?: ("normal" | "italic");
+    accent?: string;
     /**
-     * Letter spacing (tracking) in ems.
+     * 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.
      */
-    letterSpacing?: number;
+    code?: string;
     [k: string]: unknown;
 }
 /**
- * Abstract role: monospaced font used for code blocks and inline 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.
+ * Slide dimensions; either pick a preset or specify custom inches.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Dimensions".
  */
-interface Font3 {
-    /**
-     * Font family name.
-     */
-    family: string;
-    /**
-     * Numeric font weight (e.g., 400 for regular, 700 for bold).
-     */
-    weight?: number;
+interface Dimensions {
+    preset?: DimensionPreset;
     /**
-     * Font style.
+     * Custom slide width in inches; overrides the preset width when provided.
      */
-    style?: ("normal" | "italic");
+    widthInches?: number;
     /**
-     * Letter spacing (tracking) in ems.
+     * Custom slide height in inches; overrides the preset height when provided.
      */
-    letterSpacing?: number;
+    heightInches?: number;
     [k: string]: unknown;
 }
 /**
@@ -1379,7 +1218,7 @@ interface SolidBackground {
     /**
      * Fixed solid fill color: a hex string, a color-scheme slot or role name, or a var:<id> variable reference (a ColorRef, resolved against the effective color scheme and the deck variables). Use { type: 'theme', slot: ... } for PowerPoint's four theme-controlled background choices.
      */
-    color: string;
+    color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
     /**
      * Background opacity from 0 (fully transparent) to 1 (fully opaque).
      */
@@ -1406,21 +1245,47 @@ interface GradientBackground {
          */
         angle?: number;
         /**
-         * Ordered list of color stops along the gradient.
+         * Ordered list of color stops along the gradient. A gradient needs at least two stops.
+         *
+         * @minItems 2
          *
          * Items: Color stop along the gradient.
          */
-        stops?: {
-            /**
-             * Stop color: a hex string, a color-scheme slot or role name, or a var:<id> variable reference (a ColorRef).
-             */
-            color: string;
-            /**
-             * Stop position along the gradient, from 0 (start) to 1 (end).
-             */
-            position: number;
-            [k: string]: unknown;
-        }[];
+        stops?: [
+            {
+                /**
+                 * Stop color: a hex string, a color-scheme slot or role name, or a var:<id> variable reference (a ColorRef).
+                 */
+                color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
+                /**
+                 * Stop position along the gradient, from 0 (start) to 1 (end).
+                 */
+                position: number;
+                [k: string]: unknown;
+            },
+            {
+                /**
+                 * Stop color: a hex string, a color-scheme slot or role name, or a var:<id> variable reference (a ColorRef).
+                 */
+                color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
+                /**
+                 * Stop position along the gradient, from 0 (start) to 1 (end).
+                 */
+                position: number;
+                [k: string]: unknown;
+            },
+            ...({
+                /**
+                 * Stop color: a hex string, a color-scheme slot or role name, or a var:<id> variable reference (a ColorRef).
+                 */
+                color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
+                /**
+                 * Stop position along the gradient, from 0 (start) to 1 (end).
+                 */
+                position: number;
+                [k: string]: unknown;
+            })[]
+        ];
         [k: string]: unknown;
     };
     /**
@@ -1430,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.
      */
-    image: {
+    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.
+     */
+    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.
@@ -1482,11 +1393,11 @@ interface PatternBackground {
         /**
          * Foreground color for the pattern: a hex string, a color-scheme slot or role name, or a var:<id> variable reference (a ColorRef).
          */
-        foregroundColor?: string;
+        foregroundColor?: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
         /**
          * Background color behind the pattern: a hex string, a color-scheme slot or role name, or a var:<id> variable reference (a ColorRef).
          */
-        backgroundColor?: string;
+        backgroundColor?: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
         [k: string]: unknown;
     };
     /**
@@ -1495,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.
  *
@@ -1521,7 +1414,7 @@ interface Dimensions {
  */
 interface LogoSet {
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     default?: (string | {
         /**
@@ -1544,13 +1437,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     light?: (string | {
         /**
@@ -1573,13 +1462,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     dark?: (string | {
         /**
@@ -1602,13 +1487,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     stacked?: (string | {
         /**
@@ -1631,13 +1512,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     stackedLight?: (string | {
         /**
@@ -1660,13 +1537,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     stackedDark?: (string | {
         /**
@@ -1689,13 +1562,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     icon?: (string | {
         /**
@@ -1718,13 +1587,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     iconLight?: (string | {
         /**
@@ -1747,13 +1612,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     iconDark?: (string | {
         /**
@@ -1776,13 +1637,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     wordmark?: (string | {
         /**
@@ -1805,13 +1662,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     wordmarkLight?: (string | {
         /**
@@ -1834,13 +1687,9 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     wordmarkDark?: (string | {
         /**
@@ -1863,28 +1712,8 @@ interface LogoSet {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
 }
-/**
- * Decorative watermark image and rendering options. Use design.watermark = false to disable an inherited watermark.
- *
- * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "Watermark".
- */
-interface Watermark {
-    /**
-     * Source for the watermark image.
-     */
-    src?: string;
-    /**
-     * Watermark opacity from 0 (fully transparent) to 1 (fully opaque).
-     */
-    opacity: number;
-}
 /**
  * Repeated header or footer content split into left, center, and right zones. Header/footer content is slide furniture, separate from the main slide content payloads.
  *
@@ -1910,7 +1739,7 @@ interface HeaderFooterItem {
      */
     text?: string;
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     image?: (string | {
         /**
@@ -1933,10 +1762,6 @@ interface HeaderFooterItem {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
      * Whether to render the current slide number in this zone. PPTX export writes a native slide-number field when its value fits within one accepted text line; a value split across lines exports as static text with a diagnostic.
@@ -1955,9 +1780,13 @@ interface HeaderFooterItem {
      */
     dateFormat?: string;
     /**
-     * Whether to render the primary organization name from organization.
+     * Whether to render the primary organization's name from organization (role 'primary', else the first organization).
      */
     organization?: boolean;
+    /**
+     * Whether to render the primary (first) speaker's name and title from speaker, joined as 'Ada Lovelace, CTO' (just the name when the speaker has no title). It is generated text: without a named speaker the engine reports unresolved-content at this field. PPTX export writes it as static text and import restores the flag from the file's furniture provenance.
+     */
+    speaker?: boolean;
     /**
      * Whether to render the current slide section label.
      */
@@ -1981,7 +1810,7 @@ interface HeaderFooterItem1 {
      */
     text?: string;
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     image?: (string | {
         /**
@@ -2004,10 +1833,6 @@ interface HeaderFooterItem1 {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
      * Whether to render the current slide number in this zone. PPTX export writes a native slide-number field when its value fits within one accepted text line; a value split across lines exports as static text with a diagnostic.
@@ -2026,9 +1851,13 @@ interface HeaderFooterItem1 {
      */
     dateFormat?: string;
     /**
-     * Whether to render the primary organization name from organization.
+     * Whether to render the primary organization's name from organization (role 'primary', else the first organization).
      */
     organization?: boolean;
+    /**
+     * Whether to render the primary (first) speaker's name and title from speaker, joined as 'Ada Lovelace, CTO' (just the name when the speaker has no title). It is generated text: without a named speaker the engine reports unresolved-content at this field. PPTX export writes it as static text and import restores the flag from the file's furniture provenance.
+     */
+    speaker?: boolean;
     /**
      * Whether to render the current slide section label.
      */
@@ -2052,7 +1881,7 @@ interface HeaderFooterItem2 {
      */
     text?: string;
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     image?: (string | {
         /**
@@ -2075,10 +1904,6 @@ interface HeaderFooterItem2 {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
      * Whether to render the current slide number in this zone. PPTX export writes a native slide-number field when its value fits within one accepted text line; a value split across lines exports as static text with a diagnostic.
@@ -2097,9 +1922,13 @@ interface HeaderFooterItem2 {
      */
     dateFormat?: string;
     /**
-     * Whether to render the primary organization name from organization.
+     * Whether to render the primary organization's name from organization (role 'primary', else the first organization).
      */
     organization?: boolean;
+    /**
+     * Whether to render the primary (first) speaker's name and title from speaker, joined as 'Ada Lovelace, CTO' (just the name when the speaker has no title). It is generated text: without a named speaker the engine reports unresolved-content at this field. PPTX export writes it as static text and import restores the flag from the file's furniture provenance.
+     */
+    speaker?: boolean;
     /**
      * Whether to render the current slide section label.
      */
@@ -2111,7 +1940,7 @@ interface HeaderFooterItem2 {
     [k: string]: unknown;
 }
 /**
- * Optional named variables: deck colors referenced as 'var:<id>' (the original use), and typed content variables (text, number, date, image, url, list) referenced inline as '{{<id>}}' or whole as 'var:<id>'. Variables are what makes a deck a fillable template when combined with 'template': true. Color variables complement the color scheme: scheme slots and roles stay the primary vocabulary; variables cover deck-specific named colors that have no scheme slot.
+ * Optional named variables: deck colors referenced as 'var:<id>' (the original use), and typed content variables (text, number, date, image, url, list) referenced inline as '{{<id>}}' or whole as 'var:<id>'. Variables are what makes a deck a fillable template when combined with 'template': true. Color variables complement the color scheme: scheme slots and roles stay the primary vocabulary; variables cover deck-specific named colors that have no scheme slot. Built-in variables ('{{speaker.name}}', 'var:organization.logo', 'deck.name', ...) need no declaration; see Variables.
  */
 interface Variables {
     [k: string]: Variable;
@@ -2264,7 +2093,7 @@ interface ImageVariable {
      */
     type: "image";
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     value?: (string | {
         /**
@@ -2287,10 +2116,6 @@ interface ImageVariable {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
      * Whether the variable must be filled. Defaults to true: a variable with no 'value' is unfilled, and an unfilled required variable is an error in a normal deck and expected in a template. Set false for an optional slot: an unfilled optional variable resolves to empty text (inline tokens) or the field that references it is omitted.
@@ -2305,7 +2130,7 @@ interface ImageVariable {
      */
     description?: string;
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     example?: (string | {
         /**
@@ -2328,10 +2153,6 @@ interface ImageVariable {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
 }
 /**
@@ -2358,157 +2179,45 @@ interface UrlVariable {
      */
     label?: string;
     /**
-     * Optional prose describing what the variable is for, surfaced by pickers, fill forms and agents.
-     */
-    description?: string;
-    /**
-     * Illustrative link shown in fill forms and used when a template is previewed with examples. Never written to output.
-     */
-    example?: string;
-}
-/**
- * A list of strings, for bullets and list items. A whole-string array element 'var:<id>' splices every entry into the array in place; a whole field 'var:<id>' becomes the array; '{{<id>}}' joins the entries with ', ' (or the separator after a pipe: '{{<id>|; }}').
- *
- * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "ListVariable".
- */
-interface ListVariable {
-    /**
-     * Variable kind. One of color, text, number, date, image, url or list.
-     */
-    type: "list";
-    /**
-     * Entries this variable resolves to.
-     */
-    value?: string[];
-    /**
-     * Whether the variable must be filled. Defaults to true: a variable with no 'value' is unfilled, and an unfilled required variable is an error in a normal deck and expected in a template. Set false for an optional slot: an unfilled optional variable resolves to empty text (inline tokens) or the field that references it is omitted.
-     */
-    required?: boolean;
-    /**
-     * Optional short human label for forms and fill panels.
-     */
-    label?: string;
-    /**
-     * Optional prose describing what the variable is for, surfaced by pickers, fill forms and agents.
-     */
-    description?: string;
-    /**
-     * Illustrative entries shown in fill forms and used when a template is previewed with examples. Never written to output.
-     */
-    example?: string[];
-}
-/**
- * Structured storyline used by AI to shape generated content. Mirrors the OPF Narrative Template record at https://openpresentation.org/schema/opf-narrative/v1 (sans '$schema'), so a library record and an inline narrative are interchangeable.
- *
- * Narrative declares the deck's intended story arc; slides may opt into beats via Slide.beat. The narrative does not constrain slide structure — validators warn on drift (orphan slides, unused beats) but never error. Slides are the source of truth; narrative is intent that travels with the deck.
- *
- * When 'id' matches a record in the resolved 'narratives' catalog, the inline fields override matching fields on the catalog record (beats merge by beat 'id'). When 'id' doesn't match, this object defines a fully custom inline narrative.
- *
- * Deck-level concerns that aren't part of the storyline (audience, tone, takeaway, duration) live as siblings on the presentation root rather than inside this object.
- *
- * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "Narrative".
- */
-interface Narrative {
-    /**
-     * Stable slug identifying this narrative. When it matches a record in the resolved 'narratives' catalog, the catalog record's beats and metadata seed this narrative; inline fields override per-key. When it doesn't match, this is a fully custom inline narrative. Lowercase kebab-case.
-     */
-    id?: string;
-    /**
-     * Human-readable narrative name.
-     */
-    name?: string;
-    /**
-     * One-sentence description of when and why to use this narrative.
-     */
-    summary?: string;
-    /**
-     * Longer prose describing the narrative arc and ideal use cases. Used by AI-driven generation to seed deck-level direction.
-     */
-    description?: string;
-    /**
-     * Audiences this narrative works well for. Free-form strings or 'audiences' catalog ids.
-     */
-    audienceFit?: string[];
-    /**
-     * Typical talk-length window this narrative suits. Compared by validators against duration.
-     */
-    durationRange?: {
-        minMinutes?: number;
-        maxMinutes?: number;
-        [k: string]: unknown;
-    };
-    /**
-     * Free-form labels for filtering and search.
-     */
-    tags?: string[];
-    /**
-     * Visual previews of the narrative, used by picker UIs and inline rendering. All sub-fields are optional.
+     * Optional prose describing what the variable is for, surfaced by pickers, fill forms and agents.
      */
-    preview?: {
-        /**
-         * Main preview image (PNG/JPG).
-         */
-        src?: string;
-        /**
-         * Smaller thumbnail preview for dense grid views.
-         */
-        thumbnailSrc?: string;
-        /**
-         * SVG / vector preview for crisp scaling at any size.
-         */
-        vectorSrc?: string;
-        [k: string]: unknown;
-    };
+    description?: string;
     /**
-     * Ordered list of beats that make up the narrative arc. When 'id' matches a catalog record, beats here override or extend matching catalog beats by their own 'id'. Beat IDs must be unique within the narrative.
+     * Illustrative link shown in fill forms and used when a template is previewed with examples. Never written to output.
      */
-    beats?: NarrativeBeat[];
-    [k: string]: unknown;
+    example?: string;
 }
 /**
- * A single narrative beat — a labeled segment of the story arc with a specific dramatic purpose (e.g. 'hook', 'problem', 'evidence', 'ask'). Slides reference beats via Slide.beat. Beats may also carry slide-blueprint hints (slideType, layoutHint, thoughtCues, instructions) that guide the assigned slide.
- *
- * Mirrors the Beat definition in narrative.schema.json (https://openpresentation.org/schema/opf-narrative/v1) so library entries and inline OPF beats are interchangeable.
+ * A list of strings, for bullets and list items. A whole-string array element 'var:<id>' splices every entry into the array in place; a whole field 'var:<id>' becomes the array; '{{<id>}}' joins the entries with ', ' (or the separator after a pipe: '{{<id>|; }}').
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "NarrativeBeat".
+ * via the `definition` "ListVariable".
  */
-interface NarrativeBeat {
-    /**
-     * Stable slug used by Slide.beat to reference this beat. Lowercase kebab-case.
-     */
-    id: string;
-    /**
-     * Human-readable beat name.
-     */
-    name: string;
+interface ListVariable {
     /**
-     * Curator-written prose that explains what this beat should accomplish.
+     * Variable kind. One of color, text, number, date, image, url or list.
      */
-    description?: string;
+    type: "list";
     /**
-     * Short author-facing instruction for the beat — typically one phrase. Complements 'description' with a concise directive.
+     * Entries this variable resolves to.
      */
-    instructions?: string;
+    value?: string[];
     /**
-     * Optional explicit slide count for this beat. Defaults to 1 when omitted; values >1 are reserved for beats that intentionally span multiple slides. Prefer decomposing a heavy beat into multiple beats over setting a high slideCount. The validator emits a warning if the deck's actual count differs significantly.
+     * Whether the variable must be filled. Defaults to true: a variable with no 'value' is unfilled, and an unfilled required variable is an error in a normal deck and expected in a template. Set false for an optional slot: an unfilled optional variable resolves to empty text (inline tokens) or the field that references it is omitted.
      */
-    slideCount?: number;
+    required?: boolean;
     /**
-     * Default content kind for the beat's slide. Mirrors ContentPayload.type and helps engines choose a sensible layout when only the beat is specified.
+     * Optional short human label for forms and fill panels.
      */
-    slideType?: ("text" | "list" | "image" | "chart" | "table" | "video" | "code" | "metric" | "quote" | "timeline");
+    label?: string;
     /**
-     * Suggested layout id for the beat's opening slide. Resolves the same way as Slide.layout — against catalogs.layouts and the default catalog at https://www.pptx.gallery/layouts.
+     * Optional prose describing what the variable is for, surfaced by pickers, fill forms and agents.
      */
-    layoutHint?: string;
+    description?: string;
     /**
-     * Optional speaker or thinking cues attached to the beat. Surfaced in presenter notes.
+     * Illustrative entries shown in fill forms and used when a template is previewed with examples. Never written to output.
      */
-    thoughtCues?: string[];
-    [k: string]: unknown;
+    example?: string[];
 }
 /**
  * A single slide. Content can be authored as a full-slide root payload, or inside promoted named region keys such as 'left', 'center+right', and 'top:left'.
@@ -2526,27 +2235,25 @@ interface Slide {
      */
     type?: ("text" | "list" | "image" | "chart" | "table" | "video" | "code" | "metric" | "quote" | "timeline");
     /**
-     * Optional reference to one or more narrative beats (each value matches an id from narrative.beats or the resolved template). A single string declares the slide's primary beat; an array declares that one slide covers multiple beats. Declares the slide's role in the story arc; does not constrain ordering or structure. Slides without a beat are valid; multiple slides may share a beat.
+     * Optional reference to one or more beats of the deck's narrative (each value is the id of a beat in the narrative record that the root 'narrative' resolves to). A single string declares the slide's primary beat; an array declares that one slide covers multiple beats. Declares the slide's role in the story arc; does not constrain ordering or structure. Core validate warns about a beat id the resolved narrative does not define, and reports a beat that no slide references. Slides without a beat are valid; multiple slides may share a beat.
      */
     beat?: (string | string[]);
     /**
-     * Optional slide layout reference. Resolves to the 'id' of a 'layouts' catalog record. When omitted, engines infer a layout from the slide's root payload or promoted region keys. Accepts a bare id (lowercase kebab-case, e.g. 'title-subtitle'), an HTTPS URL pointing at a record file, or a 'pkg:' reference. Free-form custom layout names that don't resolve through any catalog fall through to engine-defined layouts.
-     *
-     * 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;
     /**
-     * Slide-level title content. When the resolved layout exposes a 'title' placeholder, the engine renders this value there.
+     * Slide-level title content. When the resolved layout exposes a 'title' placeholder, the engine renders this value there. Use a string for plain text or TextRun[] for inline rich text (a colored word, bold, a link, a citation or footnote marker); the heading keeps its size and fitting rules either way, and run colors resolve like body text.
      */
-    title?: string;
+    title?: (string | TextRun[]);
     /**
-     * Slide-level subtitle or supporting line. When the resolved layout exposes a 'subtitle' placeholder, the engine renders this value there.
+     * Slide-level subtitle or supporting line. When the resolved layout exposes a 'subtitle' placeholder, the engine renders this value there. Use a string for plain text or TextRun[] for inline rich text (a colored word, bold, a link, a citation or footnote marker); the heading keeps its size and fitting rules either way, and run colors resolve like body text.
      */
-    subtitle?: string;
+    subtitle?: (string | TextRun[]);
     /**
-     * Small slide-level label or badge. When the resolved layout exposes a 'tag' placeholder, the engine renders this value there.
+     * Small slide-level label or badge. When the resolved layout exposes a 'tag' placeholder, the engine renders this value there. Use a string for plain text or TextRun[] for inline rich text (a colored word, bold, a link, a citation or footnote marker); the heading keeps its size and fitting rules either way, and run colors resolve like body text.
      */
-    tag?: string;
+    tag?: (string | TextRun[]);
     /**
      * Full-slide text payload. Use a string for plain text or TextRun[] for inline rich text. TextRun items may be plain strings or formatted run objects.
      */
@@ -2564,7 +2271,7 @@ interface Slide {
      */
     numbering?: (NumberingStyle | Numbering | [(NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)] | [(NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering), (NumberingStyle | Numbering)]);
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     image?: (string | {
         /**
@@ -2587,13 +2294,9 @@ interface Slide {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     /**
-     * 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, mediaType, or format matters.
+     * 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.
      */
     video?: (string | {
         /**
@@ -2616,10 +2319,6 @@ interface Slide {
          * Optional MIME media type when it cannot be inferred from src.
          */
         mediaType?: string;
-        /**
-         * Optional authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
-         */
-        format?: string;
     });
     chart?: Chart;
     table?: Table;
@@ -2628,7 +2327,7 @@ interface Slide {
      */
     code?: (string | Code);
     /**
-     * Full-slide metric payload. A string or number is shorthand for { "value": value }; object form carries optional label, description, unit, delta, and trend metadata. Numeric values remain numbers; renderers format them for display. Presence of this field infers type 'metric'.
+     * Full-slide metric payload. A string or number is shorthand for { "value": value }; object form carries optional label, description, unit, delta, trend, and sentiment metadata. Numeric values remain numbers; renderers format them for display. Presence of this field infers type 'metric'.
      */
     metric?: (string | number | Metric);
     /**
@@ -2675,6 +2374,9 @@ interface Slide {
      * Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for equivalent blocks.
      */
     blocks?: ContentPayload[];
+    /**
+     * Slide-level design applied on top of the deck-wide design.
+     */
     design?: Design1;
     left?: ContentPayload;
     center?: ContentPayload;
@@ -2733,7 +2435,7 @@ interface Slide {
      */
     section?: string;
     /**
-     * Whether the slide is hidden from the presented sequence.
+     * Whether the slide is hidden from the presented sequence. The player skips it, the PPTX export writes it as a hidden slide, and per-slide image and PDF output skips it unless the caller asks to include hidden slides (opf CLI: --include-hidden; the deck-level renderSvg: the opt-in skipHidden). A slide named explicitly (opf render --slides, renderSvg slideIndex) is still rendered.
      */
     hidden?: boolean;
     composition?: Composition1;
@@ -2769,14 +2471,26 @@ 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; deprecated ids still resolve but validate with a warning naming their replacement.
+     * 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. A ChartDataSource is not resolved by any engine (a 'chart-data-source-unresolved' warning; engines draw a placeholder); prefer inline data with a 'source'.
+     * 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.
      */
-    data: (ChartData | ChartDataSource | DatasetRef);
+    data: (ChartData | DatasetRef);
     mapping?: ChartMapping;
+    /**
+     * Combo charts only (type 'combo'): the plotted series, by column name, that are drawn as lines with markers; every other plotted series is drawn as clustered columns. Absent: the last plotted series is the line. A combo chart keeps at least one column series, so a list that names every series draws the first one as columns. Column series are drawn, exported and listed in the legend first, then the line series on the primary axis, then those on the secondary axis, each in plotted order. A name that is not a column is a 'chart-mapping-unknown-column' error; a column that is not plotted is a 'chart-mapping-adapted' warning. On any other chart type it is ignored with a 'chart-option-adapted' warning.
+     *
+     * @minItems 1
+     */
+    line?: [string, ...(string)[]];
+    /**
+     * Combo charts only: line series, by column name, plotted against a secondary value axis at the right of the plot. That axis has its own scale, and its tick labels use the number format of the first secondary series' column (DataColumn.format), for example '0%' for a margin. Absent: every series shares the primary value axis at the left. A name that is not a line series (see 'line') stays on the primary axis with a 'chart-mapping-adapted' warning; an unknown column is a 'chart-mapping-unknown-column' error. On any other chart type it is ignored with a 'chart-option-adapted' warning.
+     *
+     * @minItems 1
+     */
+    secondaryAxis?: [string, ...(string)[]];
     axisTitles?: ChartAxisTitles;
     /**
      * Optional legend position. 'none' hides the legend. Absent keeps today's behaviour exactly (a legend at the right of multi-series charts and of pie and doughnut charts, none for single-series charts). A named position shows the legend there even for a single-series chart. Of the Office 2016 constructs only box-and-whisker takes a legend; histogram, pareto, waterfall, funnel, treemap and map drop the option with a 'chart-option-adapted' diagnostic.
@@ -2786,6 +2500,11 @@ interface Chart {
      * Optional data labels. true shows value labels at each type's default position, false (or absent) shows none, which is today's behaviour. Use the object form for the label content, position and separator.
      */
     dataLabels?: (boolean | ChartDataLabels);
+    /**
+     * Text alternative for the chart: what the data shows (the point and the key numbers), not 'a chart' or 'bar chart'. The preview exposes it as the chart's accessible name (role img with aria-label) and the PowerPoint export writes it as the chart frame's alternative text (descr); import reads it back. An empty string marks the chart decorative, with the same meaning as an empty Asset alt, but it is a reviewed choice that opf/chart-text-alternative still reports as info (a chart almost always carries a message). When absent, validate accepts text beside the chart instead.
+     */
+    alt?: string;
+    highlight?: ChartHighlight;
 }
 /**
  * Inline tabular data driving a chart. The first column usually supplies category/x-axis labels; subsequent columns are plotted measures unless 'chart.mapping' or a chart type maps them differently. Value cells are numbers; a string is read only in strict decimal syntax ('12', '-3.5', '1e6'), and anything else ('12%', '$5', '(5)', '1,234') is a gap and a 'chart-value-not-numeric' warning.
@@ -2855,30 +2574,6 @@ interface DataSourceRef {
      */
     description?: string;
 }
-/**
- * Chart data sourced from an asset reference, URL, data URI, relative path, or local path such as CSV, TSV, JSON, or XLSX. The source is interpreted as a table; optional columns select or order fields from that table.
- *
- * This interface was referenced by `Presentation`'s JSON-Schema
- * via the `definition` "ChartDataSource".
- */
-interface ChartDataSource {
-    /**
-     * Data source. Use 'asset:<id>' to reference the top-level assets registry, or provide an HTTPS URL, data URI, relative path, or local filesystem path.
-     */
-    src: string;
-    /**
-     * Optional sheet name or table name for spreadsheet-like assets.
-     */
-    sheet?: string;
-    /**
-     * Optional A1-style range or engine-defined range selector for spreadsheet-like assets.
-     */
-    range?: string;
-    /**
-     * Optional ordered columns or fields to read from the source. When omitted, renderers may use the source's own header row or schema.
-     */
-    columns?: string[];
-}
 /**
  * Chart data taken from a top-level dataset. Engines inline it before plotting; 'chart.mapping' names columns after the 'fields' selection.
  *
@@ -2912,7 +2607,7 @@ interface ChartMapping {
     series?: [string, ...(string)[]];
 }
 /**
- * Optional axis titles. Absent keeps today's untitled axes. Supported on the chart types that have a category/value (or X/Y) axis pair (column, bar, line, area, scatter, and the histogram, pareto, waterfall and box-and-whisker constructs; the funnel construct takes a category title only); a title on a type without that axis (pie, doughnut, radar, treemap, map) is dropped with a 'chart-option-adapted' diagnostic by renderers and exporters.
+ * Optional axis titles. Absent keeps today's untitled axes. Supported on the chart types that have a category/value (or X/Y) axis pair (column, bar, line, area, scatter, and the histogram, pareto, waterfall and box-and-whisker constructs; the funnel construct takes a category title only; a combo chart also takes 'secondary' when it plots a series on the secondary axis); a title on a type without that axis (pie, doughnut, radar, treemap, map) is dropped with a 'chart-option-adapted' diagnostic by renderers and exporters.
  */
 interface ChartAxisTitles {
     /**
@@ -2920,9 +2615,13 @@ interface ChartAxisTitles {
      */
     category?: string;
     /**
-     * Title of the value (Y) axis.
+     * Title of the value (Y) axis. On a combo chart, the primary (left) value axis.
      */
     value?: string;
+    /**
+     * Combo charts only: title of the secondary value axis at the right of the plot, drawn rotated like the primary value axis title. Dropped with a 'chart-option-adapted' diagnostic on any other chart type and on a combo chart without 'secondaryAxis'.
+     */
+    secondary?: string;
 }
 /**
  * Data label settings. A label shows the selected content parts in the fixed order category, value, percent, joined by the separator.
@@ -2938,7 +2637,7 @@ interface ChartDataLabels {
      */
     content?: [("value" | "percent" | "category"), ...(("value" | "percent" | "category"))[]];
     /**
-     * Where a label sits relative to its mark. 'auto' (the default) is the type's default: outside-end for clustered columns and bars, pie slices and the histogram, pareto and waterfall constructs; center for stacked columns and bars; above for line and scatter points. Clustered columns and bars and the histogram, pareto and waterfall constructs take center, inside-end, inside-base and outside-end; stacked columns and bars take center, inside-end and inside-base; pie takes center, inside-end and outside-end; line and scatter points take above, below, left, right and center. Area, doughnut and radar charts and the funnel and treemap constructs take only 'auto' (the box-and-whisker and map constructs have no data labels). An unsupported position falls back to 'auto' with a 'chart-option-adapted' diagnostic.
+     * Where a label sits relative to its mark. 'auto' (the default) is the type's default: outside-end for clustered columns and bars, pie slices and the histogram, pareto and waterfall constructs; center for stacked columns and bars; above for line and scatter points. Clustered columns and bars and the histogram, pareto and waterfall constructs take center, inside-end, inside-base and outside-end; stacked columns and bars take center, inside-end and inside-base; pie takes center, inside-end and outside-end; line and scatter points take above, below, left, right and center. Area, doughnut and radar charts and the funnel and treemap constructs take only 'auto' (the box-and-whisker and map constructs have no data labels). A combo chart places the labels of its column series like clustered columns and those of its line series like line points; a position only one part takes applies to that part, and the other part keeps its default (outside-end, above). An unsupported position falls back to 'auto' with a 'chart-option-adapted' diagnostic.
      */
     position?: ("auto" | "center" | "inside-end" | "inside-base" | "outside-end" | "above" | "below" | "left" | "right");
     /**
@@ -2946,6 +2645,23 @@ interface ChartDataLabels {
      */
     separator?: string;
 }
+/**
+ * Optional emphasis: the series and/or categories that carry the message. The engines draw the highlighted marks in the deck's primary (accent) color and every other mark in a muted neutral derived from the theme (a light grey on a light chart panel, a dim grey on a dark one); there is no color field. A mark is highlighted when its series OR its category is named. Absent keeps today's colors exactly. Supported on column, bar and line charts (series and categories; on a line a category highlight marks that category's points), pie and doughnut charts (categories, one per slice), and area, scatter and radar charts (series); the histogram, pareto, waterfall, funnel, treemap, box-and-whisker, map and combo constructs drop the option with a 'chart-option-adapted' diagnostic, as does a part the type cannot highlight. A name that matches no column or row label is a 'chart-highlight-unknown-name' error.
+ */
+interface ChartHighlight {
+    /**
+     * Series (value columns) to highlight: all marks of each named series. A name that is not a column is a 'chart-highlight-unknown-name' error; a column that is not plotted as a series (the category or X column, or one mapping.series leaves out) highlights nothing and is a 'chart-highlight-adapted' warning.
+     *
+     * @minItems 1
+     */
+    series?: [string, ...(string)[]];
+    /**
+     * Categories (row labels) to highlight: the marks of each named category (a column or bar of every series, a line's points, a pie or doughnut slice). A label no row has is a 'chart-highlight-unknown-name' error.
+     *
+     * @minItems 1
+     */
+    categories?: [string, ...(string)[]];
+}
 /**
  * Full-slide table payload. Presence of this field infers type 'table'.
  */
@@ -2999,11 +2715,11 @@ interface TableCellStyle {
     /**
      * Cell background: a hex color, a color-scheme slot or role name, or a 'var:<id>' variable reference. Eight-digit hex colors include alpha; #00000000 is transparent.
      */
-    fill?: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "text" | "textSecondary") | string);
+    fill?: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
     /**
      * Default text color, overridden by individual rich run colors. Accepts 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" | "text" | "textSecondary") | string);
+    color?: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
     /**
      * Horizontal text alignment inside the cell.
      */
@@ -3045,7 +2761,7 @@ interface TableCellBorder {
     /**
      * Border color: a hex color, a color-scheme slot or role name, or a 'var:<id>' variable reference. Eight-digit hex colors include alpha; #00000000 is transparent.
      */
-    color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "text" | "textSecondary") | string);
+    color: (HexColor | ("accent1" | "accent2" | "accent3" | "accent4" | "accent5" | "accent6" | "dark1" | "dark2" | "light1" | "light2" | "hyperlink" | "followedHyperlink" | "primary" | "secondary" | "accent" | "background" | "surface" | "surfaceAlt" | "text" | "textSecondary") | string);
     /**
      * Border width in reference pixels; 0 removes this edge.
      */
@@ -3056,7 +2772,7 @@ interface TableCellBorder {
     dash?: ("solid" | "dash" | "dot");
 }
 /**
- * Code content with optional rendering metadata. Use 'source' for the code text, 'language' for syntax highlighting, and 'filename' when the rendered block should show a file label. A string value in a code field is shorthand for { "source": value }.
+ * Code content with optional rendering metadata. Use 'source' for the code text, 'language' for syntax highlighting, 'filename' when the rendered block should show a file label, and 'highlight' to emphasize lines. A string value in a code field is shorthand for { "source": value }.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Code".
@@ -3074,9 +2790,15 @@ interface Code {
      * Optional file label shown with the code block.
      */
     filename?: string;
+    /**
+     * Source lines to emphasize, 1-based: each entry is a line number or an inclusive [start, end] range, so [3, [5, 7]] marks lines 3 and 5 to 7. Lines are counted by line break in 'source', so a line that wraps stays one line. Engines draw a theme-derived band behind the marked lines and dim the other lines slightly, keeping every line at least 4.5:1 against its background; PPTX export draws one native rectangle behind the line text boxes and import restores the list. A line number past the last line, or a range written end before start, gets a validation warning (code-highlight-out-of-range, code-highlight-range-reversed) and is ignored. When a code block is paginated across slides each page keeps the lines that fall on it, renumbered from 1.
+     *
+     * @minItems 1
+     */
+    highlight?: [(number | [number, number]), ...((number | [number, number]))[]];
 }
 /**
- * Metric content with optional display metadata. Use 'value' for the primary value, 'label' for the metric name, 'description' for supporting context, 'unit' for a suffix/currency marker, 'delta' for change, and 'trend' for direction. A string or number value in a metric field is shorthand for { "value": value }; numeric values remain numbers and are formatted by renderers.
+ * Metric content with optional display metadata. Use 'value' for the primary value, 'label' for the metric name, 'description' for supporting context, 'unit' for a suffix/currency marker, 'delta' for change, 'trend' for direction, and 'sentiment' for whether the change is good news. A string or number value in a metric field is shorthand for { "value": value }; numeric values remain numbers and are formatted by renderers.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Metric".
@@ -3103,27 +2825,60 @@ interface Metric {
      */
     delta?: (string | number);
     /**
-     * Metric trend direction.
+     * Metric trend direction. The preview and the PowerPoint export draw an arrow beside the trend word that always points the way the trend does (up, down or flat) and colour the arrow, the trend word and the delta text by `sentiment`.
      */
     trend?: ("up" | "down" | "flat");
+    /**
+     * Whether the change is good news. Positive draws the trend arrow and the trend and delta text in green, negative in red and neutral in the neutral text colour, each kept at 4.5:1 contrast or more against the slide background. When absent the colour follows the trend: up is positive, down is negative and flat is neutral. Set it when the direction is not the verdict, for example positive on a falling churn, cost or latency trend. The arrow always keeps the direction of `trend`. Only the trend arrow and the trend and delta text take the colour, so sentiment has no visible effect on a metric without a trend.
+     */
+    sentiment?: ("positive" | "negative" | "neutral");
 }
 /**
- * Quote content with optional attribution metadata. Use 'text' for the quoted text, 'attribution' for the credited person or organization, and 'source' for a citation or URL. A string value in a quote field is shorthand for { "text": value }.
+ * Quote content with optional attribution metadata. Use 'text' for the quoted text, 'attribution' for the credited person or organization, 'role' for that person's title and organization, 'photo' for their headshot and 'source' for a citation or URL. A string value in a quote field is shorthand for { "text": value }.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Quote".
  */
 interface Quote {
     /**
-     * Quoted text.
+     * Quoted text: a string, or TextRun[] for inline rich text (a colored phrase, bold, a link, or a citation or footnote marker). The engine draws the surrounding quotation marks.
      */
-    text: string;
+    text: (string | TextRun[]);
     /**
-     * Person or organization credited for the quote.
+     * Person or organization credited for the quote. Drawn after the quote text, in the muted text color.
      */
     attribution?: string;
     /**
-     * Optional quote source, citation, or URL.
+     * Title and organization of the attributed person. Drawn on its own line under the attribution; without an attribution it stands alone. It does not replace the attribution, so the person's name belongs in 'attribution'.
+     */
+    role?: string;
+    /**
+     * 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.
+     */
+    photo?: (string | {
+        /**
+         * Resource source. Accepts an 'asset:<id>' reference, HTTPS URL, data URI, relative path resolved against the OPF file location, or local filesystem path.
+         */
+        src: string;
+        /**
+         * Alternative text for images and other visual assets.
+         */
+        alt?: string;
+        /**
+         * Human-readable asset title for editors and asset pickers.
+         */
+        title?: string;
+        /**
+         * Optional notes about the asset's contents, provenance, or intended use.
+         */
+        description?: string;
+        /**
+         * Optional MIME media type when it cannot be inferred from src.
+         */
+        mediaType?: string;
+    });
+    /**
+     * Optional quote source, citation, or URL. Follows the attribution and role after ' - '.
      */
     source?: string;
 }
@@ -3146,20 +2901,100 @@ interface TimelineEvent {
      * Optional event detail.
      */
     description?: string;
+    /**
+     * Progress of the event, drawn from the deck's own colors by both the SVG renderer and the PPTX exporter. Absent means no status and the event is drawn as a plain filled marker with normal text, which is also how 'done' looks. 'done' is a filled marker in the primary color with normal text. 'current' marks 'we are here': the filled marker is surrounded by a ring and the event label (`what`) is bold. 'planned' is an outlined, hollow marker (primary-color outline over the slide background) with muted secondary text. Text colors keep a 4.5:1 contrast against the slide background. In PPTX the markers are native ellipses (the ring is a second ellipse), and PPTX import restores the status the export recorded. Status describes progress only; schedule health such as at risk or blocked belongs in the event text.
+     */
+    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; deprecated ids still resolve but validate with a warning naming their replacement.
+     * 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. A ChartDataSource is not resolved by any engine (a 'chart-data-source-unresolved' warning; engines draw a placeholder); prefer inline data with a 'source'.
+     * 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.
      */
-    data: (ChartData | ChartDataSource | DatasetRef);
+    data: (ChartData | DatasetRef);
     mapping?: ChartMapping;
+    /**
+     * Combo charts only (type 'combo'): the plotted series, by column name, that are drawn as lines with markers; every other plotted series is drawn as clustered columns. Absent: the last plotted series is the line. A combo chart keeps at least one column series, so a list that names every series draws the first one as columns. Column series are drawn, exported and listed in the legend first, then the line series on the primary axis, then those on the secondary axis, each in plotted order. A name that is not a column is a 'chart-mapping-unknown-column' error; a column that is not plotted is a 'chart-mapping-adapted' warning. On any other chart type it is ignored with a 'chart-option-adapted' warning.
+     *
+     * @minItems 1
+     */
+    line?: [string, ...(string)[]];
+    /**
+     * Combo charts only: line series, by column name, plotted against a secondary value axis at the right of the plot. That axis has its own scale, and its tick labels use the number format of the first secondary series' column (DataColumn.format), for example '0%' for a margin. Absent: every series shares the primary value axis at the left. A name that is not a line series (see 'line') stays on the primary axis with a 'chart-mapping-adapted' warning; an unknown column is a 'chart-mapping-unknown-column' error. On any other chart type it is ignored with a 'chart-option-adapted' warning.
+     *
+     * @minItems 1
+     */
+    secondaryAxis?: [string, ...(string)[]];
     axisTitles?: ChartAxisTitles;
     /**
      * Optional legend position. 'none' hides the legend. Absent keeps today's behaviour exactly (a legend at the right of multi-series charts and of pie and doughnut charts, none for single-series charts). A named position shows the legend there even for a single-series chart. Of the Office 2016 constructs only box-and-whisker takes a legend; histogram, pareto, waterfall, funnel, treemap and map drop the option with a 'chart-option-adapted' diagnostic.
@@ -3169,6 +3004,11 @@ interface Chart1 {
      * Optional data labels. true shows value labels at each type's default position, false (or absent) shows none, which is today's behaviour. Use the object form for the label content, position and separator.
      */
     dataLabels?: (boolean | ChartDataLabels);
+    /**
+     * Text alternative for the chart: what the data shows (the point and the key numbers), not 'a chart' or 'bar chart'. The preview exposes it as the chart's accessible name (role img with aria-label) and the PowerPoint export writes it as the chart frame's alternative text (descr); import reads it back. An empty string marks the chart decorative, with the same meaning as an empty Asset alt, but it is a reviewed choice that opf/chart-text-alternative still reports as info (a chart almost always carries a message). When absent, validate accepts text beside the chart instead.
+     */
+    alt?: string;
+    highlight?: ChartHighlight;
 }
 /**
  * Table payload. Presence of this field infers type 'table'.
@@ -3225,33 +3065,30 @@ interface Composition {
     overflow?: ("warn" | "error");
 }
 /**
- * Slide-level design applied on top of the deck-wide design.
+ * Visual design system applied to the presentation; individual slides may override fields via Slide.design.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Design".
  */
 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);
     /**
@@ -3259,7 +3096,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);
     /**
@@ -3267,7 +3104,7 @@ interface Design1 {
      */
     logo?: (Asset | LogoSet);
     /**
-     * Optional decorative watermark applied across slides. Use false to suppress an inherited watermark in slide-level design; a string is equivalent to { src: value }.
+     * Optional decorative watermark applied across slides: an image or a text stamp, in the fixed frame and at the opacity described on Watermark. Use false to suppress an inherited watermark in slide-level design; a string or Asset is the image at opacity 0.08.
      */
     watermark?: (false | Asset | Watermark);
     /**
@@ -3279,123 +3116,31 @@ interface Design1 {
      */
     footer?: (false | HeaderFooter);
     /**
-     * Default horizontal alignment for title placeholders in resolved layouts.
+     * Default horizontal alignment for title placeholders in resolved layouts. Effective value: the slide's design, then the deck's design, then the layout record's design.titleAlignment, then the engine default.
      */
     titleAlignment?: ("left" | "center" | "right");
     /**
-     * Default horizontal alignment for body/content regions in resolved layouts.
+     * Default horizontal alignment for body/content regions in resolved layouts. Effective value: the slide's design, then the deck's design, then the layout record's design.contentAlignment, then the engine default. A cover's tag and subtitle follow titleAlignment unless the slide's own design sets contentAlignment.
      */
     contentAlignment?: ("left" | "center" | "right");
     /**
-     * Whether body/content regions are rendered inside a visible card or surface.
+     * 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 declares slideImage: true 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" | "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" | "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" | "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" | "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 this value (slide design, then deck design), then the layout record's slideLayoutDirection, 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.
+     * 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 contentTypeChartPrimary. 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.
      */
     chartPrimary?: ("none" | "top" | "bottom" | "left" | "right");
     /**
-     * How picture placeholders fill their allocated region.
+     * 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. '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.
+     * 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;
@@ -3460,7 +3205,7 @@ interface Reference {
     url?: string;
 }
 /**
- * Optional shared data tables, keyed by id. A chart ('chart.data': { "dataset": "<id>" }) or a table ('table': { "dataset": "<id>" }) references one instead of holding its own copy; engines inline the reference before composing, rendering or exporting. A dataset nothing references is a lint warning (opf/unused-dataset). See docs/chart-table-data.md.
+ * Optional shared data tables, keyed by id. A chart ('chart.data': { "dataset": "<id>" }) or a table ('table': { "dataset": "<id>" }) references one instead of holding its own copy; engines inline the reference before composing, rendering or exporting. A dataset nothing references is the warning opf/unused-dataset. See docs/chart-table-data.md.
  */
 interface Datasets {
     [k: string]: Dataset;
@@ -3530,197 +3275,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. 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
+     * 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 {
-    /**
-     * 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
-     */
-    source?: (CatalogSource | [CatalogSource, ...(CatalogSource)[]]);
+    custom?: CatalogGroup;
     /**
-     * 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.
+     * A named catalog: its source and the records of it this document embeds. References name it as a prefix ('acme:hero').
      */
-    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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
-     */
-    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 {
+interface CatalogRecords {
     /**
-     * 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
+     * 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 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
+     * 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 {
+interface CatalogRecords2 {
     /**
-     * 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
+     * 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 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 {
+interface CatalogRecords3 {
     /**
-     * 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
+     * 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 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 {
+interface CatalogRecords4 {
     /**
-     * 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
+     * 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 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
+     * 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 {
+interface CatalogRecords6 {
     /**
-     * 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
+     * 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 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 {
+interface CatalogRecords7 {
     /**
-     * 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. Fetching a declared source is an explicit opt-in: the engine or its caller performs that fetch.
+     * 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;
+    };
 }
 
 export type { Presentation as P };