@openpresentation/opf 0.1.0

package/dist/validator-Be5EzqAt.d.ts

@@ -0,0 +1,2700 @@
+import { CatalogKind } from './catalogs.js';
+import { SchemaName } from './schemas.js';
+
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+interface JsonObject {
+    readonly [key: string]: JsonValue;
+}
+type JsonSchema = JsonObject;
+
+/**
+ * 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.
+ *
+ * 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.
+     */
+    id?: string;
+    /**
+     * Human-readable audience name shown in pickers.
+     */
+    name?: string;
+    /**
+     * One-sentence positioning of the audience.
+     */
+    summary?: string;
+    /**
+     * Longer prose describing the audience and how to address them.
+     */
+    description?: string;
+    /**
+     * Typical seniority level of the audience.
+     */
+    seniority?: ("ic" | "manager" | "director" | "vp" | "c-suite" | "mixed");
+    /**
+     * Typical technical fluency of the audience.
+     */
+    technicalFluency?: ("low" | "medium" | "high" | "mixed");
+    /**
+     * Whether the audience is expected to be informed, advise, or decide.
+     */
+    decisionPower?: ("informational" | "advisory" | "decision-maker");
+    /**
+     * Realistic upper bound on focused attention for a single presentation, in minutes.
+     */
+    attentionBudgetMinutes?: number;
+    /**
+     * Soft cross-link: narrative-catalog ids that work well for this audience.
+     */
+    recommendedNarratives?: string[];
+    /**
+     * Soft cross-link: tone-catalog ids that work well for this audience.
+     */
+    recommendedTones?: string[];
+    /**
+     * Free-form labels for filtering and search.
+     */
+    tags?: string[];
+    [k: string]: unknown;
+});
+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.
+ *
+ * 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.
+     */
+    id?: string;
+    /**
+     * Human-readable purpose name shown in pickers.
+     */
+    name?: string;
+    /**
+     * One-sentence positioning of the purpose.
+     */
+    summary?: string;
+    /**
+     * Longer prose describing when to use this purpose and how it should shape a deck.
+     */
+    description?: string;
+    /**
+     * Desired audience outcome after the presentation.
+     */
+    outcome?: string;
+    /**
+     * Observable signals that the deck accomplished this purpose.
+     */
+    successCriteria?: string[];
+    /**
+     * Soft cross-link: narrative-catalog ids that work well for this purpose.
+     */
+    recommendedNarratives?: string[];
+    /**
+     * Soft cross-link: tone-catalog ids that work well for this purpose.
+     */
+    recommendedTones?: string[];
+    /**
+     * Free-form labels for filtering and search.
+     */
+    tags?: string[];
+    [k: string]: unknown;
+});
+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.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Language".
+ */
+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;
+    /**
+     * ISO 639-3 or 639-2 language code carried for engines that prefer ISO codes.
+     */
+    code?: string;
+    /**
+     * Base text direction for the language.
+     */
+    direction?: ("ltr" | "rtl");
+    /**
+     * ISO 15924 script code when the writing system should be explicit.
+     */
+    script?: string;
+    /**
+     * Default font-scheme id for this language when targeting PowerPoint output.
+     */
+    fontScheme?: string;
+    /**
+     * Default font-scheme id for this language when targeting 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;
+};
+/**
+ * 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.
+ *
+ * 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.
+     */
+    id?: string;
+    /**
+     * Human-readable tone name shown in pickers.
+     */
+    name?: string;
+    /**
+     * One-sentence positioning of the tone.
+     */
+    summary?: string;
+    /**
+     * Longer prose describing the tone and the kinds of decks it suits.
+     */
+    description?: string;
+    /**
+     * Short directives that shape AI generation toward this tone.
+     */
+    voiceCues?: string[];
+    /**
+     * Anti-patterns that AI generation should not produce when this tone is active.
+     */
+    avoid?: string[];
+    /**
+     * Short example phrases that exemplify this tone.
+     */
+    samplePhrases?: string[];
+    /**
+     * Soft cross-link: narrative-catalog ids this tone pairs well with.
+     */
+    recommendedNarratives?: string[];
+    /**
+     * Free-form labels for filtering and search.
+     */
+    tags?: string[];
+    [k: string]: unknown;
+});
+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 }.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "BackgroundShortcut".
+ */
+type BackgroundShortcut = (ThemeBackgroundSlot | HexColor);
+/**
+ * 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.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "ThemeBackgroundSlot".
+ */
+type ThemeBackgroundSlot = ("light1" | "light2" | "dark1" | "dark2");
+/**
+ * Hex color shorthand accepted by selected string fields.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "HexColor".
+ */
+type HexColor = string;
+/**
+ * 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` "Background".
+ */
+type Background = (ThemeBackground | SolidBackground | GradientBackground | ImageBackground | PatternBackground);
+/**
+ * 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.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "DimensionPreset".
+ */
+type DimensionPreset = ("16:9" | "4:3" | "16:10" | "letter" | "a4" | "widescreen" | "standard");
+/**
+ * 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.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Asset".
+ */
+type Asset = (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 authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
+     */
+    format?: string;
+});
+/**
+ * A contiguous run of text. Strings cover unformatted spans; object form adds character formatting.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "TextRun".
+ */
+type TextRun = (string | {
+    /**
+     * Text for this run.
+     */
+    text: string;
+    /**
+     * Whether the run is rendered in bold.
+     */
+    bold?: boolean;
+    /**
+     * Whether the run is rendered in italic.
+     */
+    italic?: boolean;
+    /**
+     * Whether the run is underlined.
+     */
+    underline?: boolean;
+    /**
+     * Whether the run is rendered with a strikethrough line.
+     */
+    strikethrough?: boolean;
+    /**
+     * Run text color as a hex string.
+     */
+    color?: string;
+    /**
+     * Run font size in points.
+     */
+    fontSize?: number;
+    /**
+     * Run font family override.
+     */
+    fontFamily?: string;
+    /**
+     * URL to link the run text to.
+     */
+    link?: string;
+    /**
+     * Whether the run is rendered as superscript.
+     */
+    superscript?: boolean;
+    /**
+     * Whether the run is rendered as subscript.
+     */
+    subscript?: boolean;
+    [k: string]: unknown;
+});
+/**
+ * A flat item inside a list. Strings cover the common case, TextRun[] supports inline rich text without an object wrapper, and object form adds description and nesting depth without creating nested slide content payloads.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "ListItem".
+ */
+type ListItem = (string | TextRun[] | {
+    /**
+     * Text for the list item. Use a string for plain text or TextRun[] for inline rich text. TextRun items may be plain strings or formatted run objects.
+     */
+    text: (string | TextRun[]);
+    /**
+     * Optional supporting detail for the list item. Use a string for plain text or TextRun[] for inline rich text.
+     */
+    description?: (string | TextRun[]);
+    /**
+     * Zero-based nesting level for the list item.
+     */
+    level?: number;
+});
+/**
+ * A flat bullet item. Strings cover the common case, TextRun[] supports inline rich text without an object wrapper, and object form adds nesting depth without list-item descriptions.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "BulletItem".
+ */
+type BulletItem = (string | TextRun[] | {
+    /**
+     * Text for the bullet. Use a string for plain text or TextRun[] for inline rich text. TextRun items may be plain strings or formatted run objects.
+     */
+    text: (string | TextRun[]);
+    /**
+     * Zero-based nesting level for the bullet.
+     */
+    level?: number;
+});
+/**
+ * A cell in inline chart data.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "ChartDataCell".
+ */
+type ChartDataCell = (string | number | boolean | null);
+/**
+ * A cell in table content.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "TableCell".
+ */
+type TableCell = (string | number | boolean | null);
+/**
+ * A single content payload. The optional 'type' discriminator can make intent explicit, but validators and engines infer it from fields such as text, bullets, items, image, video, chart, table, code, metric, quote, or timeline.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "ContentPayload".
+ */
+type ContentPayload = ({
+    [k: string]: unknown;
+} & {
+    /**
+     * Optional content kind. When omitted, engines infer the kind from the fields present.
+     */
+    type?: ("text" | "list" | "image" | "chart" | "table" | "video" | "code" | "metric" | "quote" | "timeline");
+    /**
+     * Text payload. Use a string for plain text or TextRun[] for inline rich text. TextRun items may be plain strings or formatted run objects.
+     */
+    text?: (string | TextRun[]);
+    /**
+     * Generic list payload. Each item is either a plain string, a TextRun[] rich text sequence, or a ListItem object. List nesting uses item.level rather than nested content payloads.
+     */
+    items?: ListItem[];
+    /**
+     * Text-style bullet payload. Presence of this field infers type 'text'.
+     */
+    bullets?: BulletItem[];
+    /**
+     * 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.
+     */
+    image?: (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 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.
+     */
+    video?: (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 authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
+         */
+        format?: string;
+    });
+    chart?: Chart1;
+    table?: Table1;
+    /**
+     * Code payload. A string is shorthand for { "source": value }; object form carries optional syntax language and filename metadata.
+     */
+    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?: (string | number | Metric);
+    /**
+     * Quote payload. A string is shorthand for { "text": value }; object form carries optional attribution and source metadata.
+     */
+    quote?: (string | Quote);
+    /**
+     * Timeline payload ordered by narrative or chronology.
+     */
+    timeline?: ([TimelineEvent, ...(TimelineEvent)[]] | {
+        /**
+         * Short timeline label.
+         */
+        name?: string;
+        /**
+         * Optional timeline-level context.
+         */
+        description?: string;
+        /**
+         * Timeline events ordered by narrative, sequence, or chronology.
+         *
+         * @minItems 1
+         */
+        events: [TimelineEvent, ...(TimelineEvent)[]];
+    });
+});
+/**
+ * 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.
+ * - A package reference of the form 'pkg:<package>[/<subpath>]'; resolved through a locally-installed package on the engine's package path.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "CatalogSource".
+ */
+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>. 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.
+ *
+ * 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.
+ */
+interface Presentation {
+    /**
+     * Optional OPF schema version. When omitted, validators and engines should assume the latest supported OPF schema.
+     */
+    $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.
+     */
+    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).
+     */
+    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.
+     */
+    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?: (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.
+     */
+    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.
+     */
+    author?: (string | [string, ...(string)[]]);
+    /**
+     * Intended audiences for the presentation. Each item accepts either:
+     * - A string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executives'), an HTTPS URL, or a 'pkg:' reference.
+     * - An inline Audience object for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.
+     *
+     * Resolution order for catalog ids and references: inline catalogs.audiences.records[] → catalogs.audiences.source → default catalog at https://www.pptx.gallery/audiences.
+     *
+     * @minItems 1
+     */
+    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'.
+     *
+     * Resolution order for catalog ids and references: inline catalogs.purposes.records[] → catalogs.purposes.source → default catalog at https://www.pptx.gallery/purposes.
+     */
+    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'.
+     *
+     * Resolution order for catalog ids and references: inline catalogs.languages.records[] → catalogs.languages.source → default catalog at https://www.pptx.gallery/languages.
+     */
+    language?: (string | 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'.
+     *
+     * Resolution order for catalog ids and references: inline catalogs.tones.records[] → catalogs.tones.source → default catalog at https://www.pptx.gallery/tones.
+     */
+    tone?: (string | 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.
+     */
+    duration?: number;
+    /**
+     * Free-form labels used for categorization, search, and filtering. Lowercase kebab-case is recommended for consistency across a deck library.
+     */
+    tags?: string[];
+    design?: Design;
+    /**
+     * 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.
+     */
+    narrative?: (string | Narrative);
+    /**
+     * Ordered array of slides that make up the presentation.
+     *
+     * @minItems 1
+     */
+    slides: [Slide, ...(Slide)[]];
+    assets?: Assets;
+    catalogs?: Catalogs;
+    /**
+     * Custom data passthrough for agent workflows; ignored by the engine but preserved across read/write round-trips.
+     */
+    extensions?: {
+        [k: string]: unknown;
+    };
+}
+/**
+ * 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.
+ *
+ * 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.
+     */
+    id: string;
+    /**
+     * Display name shown on slides.
+     */
+    name: string;
+    /**
+     * Optional legal entity name when it differs from the display name.
+     */
+    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 is used by default for cover-slide and footer branding; design.logo overrides the source.
+     */
+    logo?: (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 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).
+     */
+    domain?: string;
+    /**
+     * General contact email for the organization. Used on contact slides and footer attribution.
+     */
+    email?: string;
+    /**
+     * Main contact phone number for the organization. E.164 format is recommended.
+     */
+    phone?: string;
+    /**
+     * Short tagline rendered alongside the organization name on cover slides.
+     */
+    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?: ("primary" | "partner" | "client" | "sponsor" | "host");
+    socials?: Socials;
+    [k: string]: unknown;
+}
+/**
+ * Optional social media handles or URLs for the organization.
+ */
+interface Socials {
+    /**
+     * Handle or URL for the platform identified by the property key.
+     */
+    [k: string]: string;
+}
+/**
+ * A person presenting the deck. Used for cover slides, bio/intro slides, footer attribution, and panel formats with multiple presenters.
+ *
+ * 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.
+     */
+    id: string;
+    /**
+     * Display name.
+     */
+    name: string;
+    /**
+     * Role or title. Often paired with the speaker's organization on cover slides.
+     */
+    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. Used on cover and bio slides.
+     */
+    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 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.
+     */
+    email?: string;
+    /**
+     * Contact phone number for the speaker. E.164 format is recommended.
+     */
+    phone?: string;
+    /**
+     * Short biographical paragraph for bio or 'about the speaker' slides.
+     */
+    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.
+     */
+    organizationId?: string;
+    socials?: Socials1;
+    [k: string]: unknown;
+}
+/**
+ * Optional social media handles or URLs for the speaker.
+ */
+interface Socials1 {
+    /**
+     * Handle or URL for the platform identified by the property key.
+     */
+    [k: string]: string;
+}
+/**
+ * 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.
+     */
+    theme?: (string | Theme);
+    /**
+     * 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.
+     *
+     * Resolution order: inline catalogs.colorSchemes.records[] -> catalogs.colorSchemes.source -> default catalog at https://www.pptx.gallery/color-schemes.
+     */
+    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.
+     *
+     * Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.source -> default catalog at https://www.pptx.gallery/font-schemes.
+     */
+    fontScheme?: (string | FontScheme);
+    /**
+     * Slide dimensions and aspect ratio. String shorthand such as 'widescreen' is equivalent to { preset: 'widescreen' }.
+     */
+    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.
+     */
+    background?: (BackgroundShortcut | Background);
+    /**
+     * Deck logo assets used by layouts, covers, section dividers, headers, and footers. A string is the default logo source; object form provides light/dark, stacked, icon, and wordmark variants. When omitted, the renderer falls back to the primary organization logo.
+     */
+    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 }.
+     */
+    watermark?: (false | Asset | Watermark);
+    /**
+     * Repeated header furniture rendered outside the main slide content. Use false to suppress an inherited header.
+     */
+    header?: (false | HeaderFooter);
+    /**
+     * Repeated footer furniture rendered outside the main slide content. Use false to suppress an inherited footer.
+     */
+    footer?: (false | HeaderFooter);
+    /**
+     * Default horizontal alignment for title placeholders in resolved layouts.
+     */
+    titleAlignment?: ("left" | "center" | "right");
+    /**
+     * Default horizontal alignment for body/content regions in resolved layouts.
+     */
+    contentAlignment?: ("left" | "center" | "right");
+    /**
+     * Whether body/content regions are rendered inside a visible card or surface.
+     */
+    contentBox?: boolean;
+    /**
+     * Optional slide-level image treatment used by layouts that support a decorative or editorial image separate from content images.
+     */
+    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.
+         */
+        position: ("background" | "top" | "bottom" | "left" | "right");
+    });
+    /**
+     * Axis along which parallel body/content regions are arranged.
+     */
+    contentDirection?: ("horizontal" | "vertical");
+    /**
+     * For chart layouts, where the primary chart sits relative to supporting content. 'none' means chart regions have equal weight.
+     */
+    chartPrimary?: ("none" | "top" | "bottom" | "left" | "right");
+    /**
+     * How picture placeholders fill their allocated region.
+     */
+    imageFill?: ("crop" | "fit");
+    /**
+     * Default bullet rendering style for list layouts.
+     */
+    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.
+ *
+ * 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.
+ *
+ * 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'.
+ *
+ * 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.
+     */
+    id?: string;
+    /**
+     * Accent 1 color (hex). Mirrors the OOXML accent1 slot.
+     */
+    accent1?: string;
+    /**
+     * Accent 2 color (hex). Mirrors the OOXML accent2 slot.
+     */
+    accent2?: string;
+    /**
+     * Accent 3 color (hex). Mirrors the OOXML accent3 slot.
+     */
+    accent3?: string;
+    /**
+     * Accent 4 color (hex). Mirrors the OOXML accent4 slot.
+     */
+    accent4?: string;
+    /**
+     * Accent 5 color (hex). Mirrors the OOXML accent5 slot.
+     */
+    accent5?: string;
+    /**
+     * Accent 6 color (hex). Mirrors the OOXML accent6 slot.
+     */
+    accent6?: string;
+    /**
+     * Dark 1 color (hex). Typically the deepest neutral; OOXML dark1.
+     */
+    dark1?: string;
+    /**
+     * Dark 2 color (hex). Secondary dark; OOXML dark2.
+     */
+    dark2?: string;
+    /**
+     * Light 1 color (hex). Typically the slide canvas; OOXML lt1.
+     */
+    light1?: string;
+    /**
+     * Light 2 color (hex). Secondary light surface; OOXML lt2.
+     */
+    light2?: string;
+    /**
+     * Hyperlink color (hex). OOXML hlink.
+     */
+    hyperlink?: string;
+    /**
+     * Followed-hyperlink color (hex). OOXML folHlink.
+     */
+    followedHyperlink?: string;
+    /**
+     * Abstract role: primary brand color (hex). The engine maps this onto an OOXML accent slot when serializing.
+     */
+    primary?: string;
+    /**
+     * Abstract role: secondary brand color (hex).
+     */
+    secondary?: string;
+    /**
+     * Abstract role: accent color used for highlights and emphasis (hex).
+     */
+    accent?: string;
+    /**
+     * Abstract role: default slide background color (hex). The engine maps this to one of light1 / light2 / dark1 / dark2 when serializing.
+     */
+    background?: string;
+    /**
+     * Abstract role: color for elevated surfaces such as cards and panels (hex).
+     */
+    surface?: string;
+    /**
+     * Abstract role: primary body text color (hex).
+     */
+    text?: string;
+    /**
+     * Abstract role: secondary or muted text color used for captions and supporting copy (hex).
+     */
+    textSecondary?: string;
+    /**
+     * Map of custom named colors for advanced or theme-specific use.
+     */
+    custom?: {
+        [k: string]: string;
+    };
+    [k: string]: unknown;
+}
+/**
+ * Typography selections used by the design system. The pair fields (major, minor) and refinement fields (type, app, languageFamily) mirror font-scheme.schema.json (https://openpresentation.org/schema/opf-font-scheme/v1) so library records and inline OPF overrides are interchangeable on those fields.
+ *
+ * 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; not part of the catalog record schema.
+ *
+ * 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'.
+ *
+ * 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.
+     */
+    id?: string;
+    /**
+     * Heading (major) font family — mirrors the OOXML majorFont entry. Pairs with 'minor'.
+     */
+    major?: string;
+    /**
+     * Body (minor) font family — mirrors the OOXML minorFont entry. Pairs with 'major'.
+     */
+    minor?: string;
+    /**
+     * High-level typographic class of the scheme.
+     */
+    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.
+     */
+    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.
+     */
+    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 accent text such as quotes or callouts. No direct OOXML slot.
+ */
+interface Font2 {
+    /**
+     * 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: monospaced font used for code blocks. No direct OOXML slot.
+ */
+interface Font3 {
+    /**
+     * 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;
+}
+/**
+ * Theme-controlled PowerPoint slide background. The slot is resolved through the active color scheme and remains theme-aware.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "ThemeBackground".
+ */
+interface ThemeBackground {
+    /**
+     * Theme-controlled background fill.
+     */
+    type: "theme";
+    slot: ThemeBackgroundSlot;
+    [k: string]: unknown;
+}
+/**
+ * Fixed solid slide background fill.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "SolidBackground".
+ */
+interface SolidBackground {
+    /**
+     * Fixed solid background fill.
+     */
+    type: "solid";
+    /**
+     * Fixed solid fill color, usually a hex string. Use { type: 'theme', slot: ... } for PowerPoint's four theme-controlled background choices.
+     */
+    color: string;
+    /**
+     * Background opacity from 0 (fully transparent) to 1 (fully opaque).
+     */
+    opacity?: number;
+    [k: string]: unknown;
+}
+/**
+ * Fixed gradient slide background fill.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "GradientBackground".
+ */
+interface GradientBackground {
+    /**
+     * Fixed gradient background fill.
+     */
+    type: "gradient";
+    /**
+     * Gradient fill definition.
+     */
+    gradient: {
+        /**
+         * Gradient angle in degrees (0 = left-to-right, 90 = top-to-bottom).
+         */
+        angle?: number;
+        /**
+         * Ordered list of color stops along the gradient.
+         */
+        stops?: {
+            /**
+             * Stop color as a hex string.
+             */
+            color: string;
+            /**
+             * Stop position along the gradient, from 0 (start) to 1 (end).
+             */
+            position: number;
+            [k: string]: unknown;
+        }[];
+        [k: string]: unknown;
+    };
+    /**
+     * Background opacity from 0 (fully transparent) to 1 (fully opaque).
+     */
+    opacity?: number;
+    [k: string]: unknown;
+}
+/**
+ * Fixed image slide background fill.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "ImageBackground".
+ */
+interface ImageBackground {
+    /**
+     * Fixed image background fill.
+     */
+    type: "image";
+    /**
+     * Image fill definition.
+     */
+    image: {
+        /**
+         * Source for the background image.
+         */
+        src: string;
+        /**
+         * How the image fills the slide background.
+         */
+        fit?: ("cover" | "contain" | "tile");
+        [k: string]: unknown;
+    };
+    /**
+     * Background opacity from 0 (fully transparent) to 1 (fully opaque).
+     */
+    opacity?: number;
+    [k: string]: unknown;
+}
+/**
+ * Fixed pattern slide background fill.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "PatternBackground".
+ */
+interface PatternBackground {
+    /**
+     * Fixed pattern background fill.
+     */
+    type: "pattern";
+    /**
+     * Pattern fill definition.
+     */
+    pattern: {
+        /**
+         * Pattern preset or engine-defined pattern id.
+         */
+        preset: string;
+        /**
+         * Foreground color for the pattern, usually a hex string.
+         */
+        foregroundColor?: string;
+        /**
+         * Background color behind the pattern, usually a hex string.
+         */
+        backgroundColor?: string;
+        [k: string]: unknown;
+    };
+    /**
+     * Background opacity from 0 (fully transparent) to 1 (fully opaque).
+     */
+    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 layouts, covers, section dividers, headers, and footers. Organization identity lives in organization; this object only controls visual rendering assets. Renderer convention: on dark backgrounds prefer the 'light' variant, on light backgrounds prefer the 'dark' variant, and in square/vertical slots prefer the stacked family when present.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "LogoSet".
+ */
+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.
+     */
+    default?: (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 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.
+     */
+    light?: (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 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.
+     */
+    dark?: (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 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.
+     */
+    stacked?: (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 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.
+     */
+    stackedLight?: (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 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.
+     */
+    stackedDark?: (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 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.
+     */
+    icon?: (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 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.
+     */
+    iconLight?: (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 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.
+     */
+    iconDark?: (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 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.
+     */
+    wordmark?: (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 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.
+     */
+    wordmarkLight?: (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 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.
+     */
+    wordmarkDark?: (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 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.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "HeaderFooter".
+ */
+interface HeaderFooter {
+    left?: HeaderFooterItem;
+    center?: HeaderFooterItem1;
+    right?: HeaderFooterItem2;
+    [k: string]: unknown;
+}
+/**
+ * Left-aligned header/footer content.
+ */
+interface HeaderFooterItem {
+    /**
+     * Literal text rendered in this zone.
+     */
+    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.
+     */
+    image?: (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 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.
+     */
+    slideNumber?: boolean;
+    /**
+     * Whether to render the presentation date, or a literal date string to render.
+     */
+    date?: (boolean | string);
+    /**
+     * Whether to render the primary organization name from organization.
+     */
+    organization?: boolean;
+    /**
+     * Whether to render the current slide section label.
+     */
+    section?: boolean;
+    [k: string]: unknown;
+}
+/**
+ * Centered header/footer content.
+ */
+interface HeaderFooterItem1 {
+    /**
+     * Literal text rendered in this zone.
+     */
+    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.
+     */
+    image?: (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 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.
+     */
+    slideNumber?: boolean;
+    /**
+     * Whether to render the presentation date, or a literal date string to render.
+     */
+    date?: (boolean | string);
+    /**
+     * Whether to render the primary organization name from organization.
+     */
+    organization?: boolean;
+    /**
+     * Whether to render the current slide section label.
+     */
+    section?: boolean;
+    [k: string]: unknown;
+}
+/**
+ * Right-aligned header/footer content.
+ */
+interface HeaderFooterItem2 {
+    /**
+     * Literal text rendered in this zone.
+     */
+    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.
+     */
+    image?: (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 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.
+     */
+    slideNumber?: boolean;
+    /**
+     * Whether to render the presentation date, or a literal date string to render.
+     */
+    date?: (boolean | string);
+    /**
+     * Whether to render the primary organization name from organization.
+     */
+    organization?: boolean;
+    /**
+     * Whether to render the current slide section label.
+     */
+    section?: boolean;
+    [k: string]: unknown;
+}
+/**
+ * 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.
+     */
+    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;
+    };
+    /**
+     * 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.
+     */
+    beats?: NarrativeBeat[];
+    [k: string]: unknown;
+}
+/**
+ * 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.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "NarrativeBeat".
+ */
+interface NarrativeBeat {
+    /**
+     * Stable slug used by Slide.beat to reference this beat. Lowercase kebab-case.
+     */
+    id: string;
+    /**
+     * Human-readable beat name.
+     */
+    name: string;
+    /**
+     * Curator-written prose that explains what this beat should accomplish.
+     */
+    description?: string;
+    /**
+     * Short author-facing instruction for the beat — typically one phrase. Complements 'description' with a concise directive.
+     */
+    instructions?: 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.
+     */
+    slideCount?: number;
+    /**
+     * Default content kind for the beat's slide. Mirrors ContentPayload.type and helps engines choose a sensible layout when only the beat is specified.
+     */
+    slideType?: ("text" | "list" | "image" | "chart" | "table" | "video" | "code" | "metric" | "quote" | "timeline");
+    /**
+     * 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.
+     */
+    layoutHint?: string;
+    /**
+     * Optional speaker or thinking cues attached to the beat. Surfaced in presenter notes.
+     */
+    thoughtCues?: string[];
+    [k: string]: unknown;
+}
+/**
+ * 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'.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Slide".
+ */
+interface Slide {
+    /**
+     * Optional stable identifier for the slide within the document. Use when another system needs to reference a slide across edits, comments, generation state, exports, or narrative tooling. Slide order is defined by the slides array, so simple decks may omit this.
+     */
+    id?: string;
+    /**
+     * Optional full-slide content kind. When omitted, engines infer the kind from root payload fields.
+     */
+    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.
+     */
+    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.
+     */
+    layout?: string;
+    /**
+     * Slide-level title content. When the resolved layout exposes a 'title' placeholder, the engine renders this value there.
+     */
+    title?: string;
+    /**
+     * Slide-level subtitle or supporting line. When the resolved layout exposes a 'subtitle' placeholder, the engine renders this value there.
+     */
+    subtitle?: string;
+    /**
+     * Small slide-level label or badge. When the resolved layout exposes a 'tag' placeholder, the engine renders this value there.
+     */
+    tag?: string;
+    /**
+     * 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.
+     */
+    text?: (string | TextRun[]);
+    /**
+     * Full-slide generic list payload. Presence of this field infers type 'list'.
+     */
+    items?: ListItem[];
+    /**
+     * Full-slide text-style bullet payload. Presence of this field infers type 'text'.
+     */
+    bullets?: BulletItem[];
+    /**
+     * 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.
+     */
+    image?: (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 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.
+     */
+    video?: (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 authoring/parsing format hint. Useful when format is more convenient than a full MIME media type.
+         */
+        format?: string;
+    });
+    chart?: Chart;
+    table?: Table;
+    /**
+     * Full-slide code payload. A string is shorthand for { "source": value }; object form carries optional syntax language and filename metadata.
+     */
+    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'.
+     */
+    metric?: (string | number | Metric);
+    /**
+     * Full-slide quote payload. A string is shorthand for { "text": value }; object form carries optional attribution and source metadata. Presence of this field infers type 'quote'.
+     */
+    quote?: (string | Quote);
+    /**
+     * Full-slide timeline payload. An array is shorthand for { "events": value }; object form carries optional name and description metadata. Presence of this field infers type 'timeline'.
+     */
+    timeline?: ([TimelineEvent, ...(TimelineEvent)[]] | {
+        /**
+         * Short timeline label.
+         */
+        name?: string;
+        /**
+         * Optional timeline-level context.
+         */
+        description?: string;
+        /**
+         * Timeline events ordered by narrative, sequence, or chronology.
+         *
+         * @minItems 1
+         */
+        events: [TimelineEvent, ...(TimelineEvent)[]];
+    });
+    /**
+     * Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified.
+     */
+    blocks?: ContentPayload[];
+    design?: Design1;
+    left?: ContentPayload;
+    center?: ContentPayload;
+    right?: ContentPayload;
+    "left+center"?: ContentPayload;
+    "center+right"?: ContentPayload;
+    "left+center+right"?: ContentPayload;
+    top?: ContentPayload;
+    middle?: ContentPayload;
+    bottom?: ContentPayload;
+    "top+middle"?: ContentPayload;
+    "middle+bottom"?: ContentPayload;
+    "top+middle+bottom"?: ContentPayload;
+    "top:left"?: ContentPayload;
+    "top:center"?: ContentPayload;
+    "top:right"?: ContentPayload;
+    "top:left+center"?: ContentPayload;
+    "top:center+right"?: ContentPayload;
+    "top:left+center+right"?: ContentPayload;
+    "middle:left"?: ContentPayload;
+    "middle:center"?: ContentPayload;
+    "middle:right"?: ContentPayload;
+    "middle:left+center"?: ContentPayload;
+    "middle:center+right"?: ContentPayload;
+    "middle:left+center+right"?: ContentPayload;
+    "bottom:left"?: ContentPayload;
+    "bottom:center"?: ContentPayload;
+    "bottom:right"?: ContentPayload;
+    "bottom:left+center"?: ContentPayload;
+    "bottom:center+right"?: ContentPayload;
+    "bottom:left+center+right"?: ContentPayload;
+    "top+middle:left"?: ContentPayload;
+    "top+middle:center"?: ContentPayload;
+    "top+middle:right"?: ContentPayload;
+    "top+middle:left+center"?: ContentPayload;
+    "top+middle:center+right"?: ContentPayload;
+    "top+middle:left+center+right"?: ContentPayload;
+    "middle+bottom:left"?: ContentPayload;
+    "middle+bottom:center"?: ContentPayload;
+    "middle+bottom:right"?: ContentPayload;
+    "middle+bottom:left+center"?: ContentPayload;
+    "middle+bottom:center+right"?: ContentPayload;
+    "middle+bottom:left+center+right"?: ContentPayload;
+    "top+middle+bottom:left"?: ContentPayload;
+    "top+middle+bottom:center"?: ContentPayload;
+    "top+middle+bottom:right"?: ContentPayload;
+    "top+middle+bottom:left+center"?: ContentPayload;
+    "top+middle+bottom:center+right"?: ContentPayload;
+    "top+middle+bottom:left+center+right"?: ContentPayload;
+    /**
+     * Speaker notes shown in presenter view.
+     */
+    notes?: string;
+    /**
+     * PowerPoint-style slide section label. Consecutive slides with the same value belong to the same section in presenter view, outlines, and PowerPoint section-aware exports.
+     */
+    section?: string;
+    /**
+     * Whether the slide is hidden from the presented sequence.
+     */
+    hidden?: boolean;
+}
+/**
+ * Full-slide chart payload. Presence of this field infers type 'chart'.
+ */
+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.
+     */
+    type: string;
+    /**
+     * Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally.
+     */
+    data: (ChartData | ChartDataSource);
+}
+/**
+ * Inline tabular data driving a chart. The first column usually supplies category/x-axis labels; subsequent columns are plotted measures unless a chart type or renderer maps them differently.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "ChartData".
+ */
+interface ChartData {
+    /**
+     * Ordered column labels for the chart data table.
+     *
+     * @minItems 1
+     */
+    columns: [string, ...(string)[]];
+    /**
+     * Tabular chart rows. Each row aligns by index with columns.
+     *
+     * @minItems 1
+     */
+    rows: [ChartDataCell[], ...(ChartDataCell[])[]];
+}
+/**
+ * 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[];
+}
+/**
+ * Full-slide table payload. Presence of this field infers type 'table'.
+ */
+interface Table {
+    /**
+     * Optional column labels rendered above table rows.
+     */
+    columns?: string[];
+    /**
+     * Two-dimensional table row data; each row aligns by index with columns when columns are supplied.
+     */
+    rows: TableCell[][];
+}
+/**
+ * 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 }.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Code".
+ */
+interface Code {
+    /**
+     * Source code text to display.
+     */
+    source: string;
+    /**
+     * Language identifier used for syntax highlighting.
+     */
+    language?: string;
+    /**
+     * Optional file label shown with the code block.
+     */
+    filename?: string;
+}
+/**
+ * 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.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Metric".
+ */
+interface Metric {
+    /**
+     * Primary metric value.
+     */
+    value: (string | number);
+    /**
+     * Metric label.
+     */
+    label?: string;
+    /**
+     * Optional supporting context for the metric.
+     */
+    description?: string;
+    /**
+     * Metric unit, suffix, or currency marker.
+     */
+    unit?: string;
+    /**
+     * Metric change value.
+     */
+    delta?: (string | number);
+    /**
+     * Metric trend direction.
+     */
+    trend?: ("up" | "down" | "flat");
+}
+/**
+ * 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 }.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Quote".
+ */
+interface Quote {
+    /**
+     * Quoted text.
+     */
+    text: string;
+    /**
+     * Person or organization credited for the quote.
+     */
+    attribution?: string;
+    /**
+     * Optional quote source, citation, or URL.
+     */
+    source?: string;
+}
+/**
+ * A single event inside a timeline content payload.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "TimelineEvent".
+ */
+interface TimelineEvent {
+    /**
+     * Event time, date, or sequence label. Use ISO-like values when possible, but human labels are allowed for quarters, eras, and relative milestones.
+     */
+    when?: string;
+    /**
+     * Short event label.
+     */
+    what: string;
+    /**
+     * Optional event detail.
+     */
+    description?: string;
+}
+/**
+ * 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.
+     */
+    type: string;
+    /**
+     * Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally.
+     */
+    data: (ChartData | ChartDataSource);
+}
+/**
+ * Table payload. Presence of this field infers type 'table'.
+ */
+interface Table1 {
+    /**
+     * Optional column labels rendered above table rows.
+     */
+    columns?: string[];
+    /**
+     * Two-dimensional table row data; each row aligns by index with columns when columns are supplied.
+     */
+    rows: TableCell[][];
+}
+/**
+ * Slide-level design applied on top of the deck-wide 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.
+     */
+    theme?: (string | Theme);
+    /**
+     * 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.
+     *
+     * Resolution order: inline catalogs.colorSchemes.records[] -> catalogs.colorSchemes.source -> default catalog at https://www.pptx.gallery/color-schemes.
+     */
+    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.
+     *
+     * Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.source -> default catalog at https://www.pptx.gallery/font-schemes.
+     */
+    fontScheme?: (string | FontScheme);
+    /**
+     * Slide dimensions and aspect ratio. String shorthand such as 'widescreen' is equivalent to { preset: 'widescreen' }.
+     */
+    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.
+     */
+    background?: (BackgroundShortcut | Background);
+    /**
+     * Deck logo assets used by layouts, covers, section dividers, headers, and footers. A string is the default logo source; object form provides light/dark, stacked, icon, and wordmark variants. When omitted, the renderer falls back to the primary organization logo.
+     */
+    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 }.
+     */
+    watermark?: (false | Asset | Watermark);
+    /**
+     * Repeated header furniture rendered outside the main slide content. Use false to suppress an inherited header.
+     */
+    header?: (false | HeaderFooter);
+    /**
+     * Repeated footer furniture rendered outside the main slide content. Use false to suppress an inherited footer.
+     */
+    footer?: (false | HeaderFooter);
+    /**
+     * Default horizontal alignment for title placeholders in resolved layouts.
+     */
+    titleAlignment?: ("left" | "center" | "right");
+    /**
+     * Default horizontal alignment for body/content regions in resolved layouts.
+     */
+    contentAlignment?: ("left" | "center" | "right");
+    /**
+     * Whether body/content regions are rendered inside a visible card or surface.
+     */
+    contentBox?: boolean;
+    /**
+     * Optional slide-level image treatment used by layouts that support a decorative or editorial image separate from content images.
+     */
+    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.
+         */
+        position: ("background" | "top" | "bottom" | "left" | "right");
+    });
+    /**
+     * Axis along which parallel body/content regions are arranged.
+     */
+    contentDirection?: ("horizontal" | "vertical");
+    /**
+     * For chart layouts, where the primary chart sits relative to supporting content. 'none' means chart regions have equal weight.
+     */
+    chartPrimary?: ("none" | "top" | "bottom" | "left" | "right");
+    /**
+     * How picture placeholders fill their allocated region.
+     */
+    imageFill?: ("crop" | "fit");
+    /**
+     * Default bullet rendering style for list layouts.
+     */
+    listBullet?: ("character" | "image");
+    [k: string]: unknown;
+}
+/**
+ * Optional reusable asset registry for images, data files, videos, documents, fonts, and other resources referenced elsewhere in the deck via 'asset:<id>' strings.
+ */
+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.
+ */
+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 https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * 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 https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * Catalog of color schemes. Records validate against https://openpresentation.org/schema/opf-color-scheme/v1. Default source: https://www.pptx.gallery/color-schemes.
+ */
+interface CatalogEntry2 {
+    /**
+     * Single source or an ordered search path of sources. When omitted, the engine falls back to https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * Catalog of font schemes. Records validate against https://openpresentation.org/schema/opf-font-scheme/v1. Default source: https://www.pptx.gallery/font-schemes.
+ */
+interface CatalogEntry3 {
+    /**
+     * Single source or an ordered search path of sources. When omitted, the engine falls back to https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * Catalog of languages. Records validate against https://openpresentation.org/schema/opf-language/v1. Default source: https://www.pptx.gallery/languages.
+ */
+interface CatalogEntry4 {
+    /**
+     * Single source or an ordered search path of sources. When omitted, the engine falls back to https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * Catalog of slide layouts. Records validate against https://openpresentation.org/schema/opf-layout/v1. Default source: https://www.pptx.gallery/layouts.
+ */
+interface CatalogEntry5 {
+    /**
+     * Single source or an ordered search path of sources. When omitted, the engine falls back to https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * Catalog of chart types. Records validate against https://openpresentation.org/schema/opf-chart-type/v1. Default source: https://www.pptx.gallery/chart-types.
+ */
+interface CatalogEntry6 {
+    /**
+     * Single source or an ordered search path of sources. When omitted, the engine falls back to https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * Catalog of presentation tones. Records validate against https://openpresentation.org/schema/opf-tone/v1. Default source: https://www.pptx.gallery/tones. Referenced from tone.
+ */
+interface CatalogEntry7 {
+    /**
+     * Single source or an ordered search path of sources. When omitted, the engine falls back to https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * Catalog of presentation purposes. Records validate against https://openpresentation.org/schema/opf-purpose/v1. Default source: https://www.pptx.gallery/purposes. Referenced from purpose.
+ */
+interface CatalogEntry8 {
+    /**
+     * Single source or an ordered search path of sources. When omitted, the engine falls back to https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * Catalog of presentation audiences. Records validate against https://openpresentation.org/schema/opf-audience/v1. Default source: https://www.pptx.gallery/audiences. Referenced from audience.
+ */
+interface CatalogEntry9 {
+    /**
+     * Single source or an ordered search path of sources. When omitted, the engine falls back to https://www.pptx.gallery/<kind>.
+     */
+    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;
+}
+/**
+ * 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).
+ */
+interface CatalogEntry10 {
+    /**
+     * Single source or an ordered search path of sources. When omitted, the engine falls back to https://www.pptx.gallery/<kind>.
+     */
+    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 ValidationIssue {
+    path: string;
+    message: string;
+    keyword: string;
+    schemaPath: string;
+    params: Record<string, unknown>;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    schemaName?: SchemaName;
+    catalogKind?: CatalogKind;
+}
+type SchemaOrKind = SchemaName | CatalogKind | JsonSchema;
+declare class OPFValidationError extends Error {
+    readonly issues: ValidationIssue[];
+    readonly result: ValidationResult;
+    constructor(result: ValidationResult);
+}
+declare function validate(value: unknown, schemaOrKind?: SchemaOrKind): ValidationResult;
+declare function assertValid<T = unknown>(value: T, schemaOrKind?: SchemaOrKind): T;
+declare function validatePresentation(value: unknown): ValidationResult;
+declare function assertValidPresentation(value: unknown): asserts value is Presentation;
+declare function validateCatalogRecord(kind: CatalogKind, value: unknown): ValidationResult;
+declare function assertValidCatalogRecord(kind: CatalogKind, value: unknown): void;
+
+export { OPFValidationError as O, type Presentation as P, type SchemaOrKind as S, type ValidationIssue as V, type ValidationResult as a, assertValid as b, assertValidCatalogRecord as c, assertValidPresentation as d, validateCatalogRecord as e, validatePresentation as f, validate as v };