@openpresentation/opf 0.1.0 → 0.2.1

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export { P as Presentation, V as ValidationIssue, a as ValidationResult } from './validator-Be5EzqAt.js';
+export { P as Presentation, V as ValidationIssue, a as ValidationResult } from './validator-D7WwzKyx.js';
 export { CatalogKind } from './catalogs.js';
 export { SchemaName } from './schemas.js';
 
@@ -766,7 +766,7 @@ interface Beat {
 }
 
 /**
- * Schema for social-platform records in the pptx.gallery library. Each record describes a single social-media platform — its base URL, profile-URL pattern, handle prefix, brand color, and themed icons. Records are referenced from OPF documents indirectly: the property keys of any Socials object (Organization.socials, Speaker.socials) match record ids, and renderers use the catalog record to format URLs and pick icons. The engine resolves references against catalogs.socialPlatforms (inline) → catalogs.socialPlatforms.source → the default catalog at https://www.pptx.gallery/social-platforms.
+ * Schema for social-platform records in the pptx.gallery library. Each record describes a single social-media platform — its base URL, profile-URL pattern, handle prefix, brand color, and themed icons. Records are referenced from OPF documents indirectly: the property keys of any Socials object (Organization.socials, Speaker.socials) match record ids, and renderers use the catalog record to format URLs and pick icons. The engine resolves references against catalogs.socialPlatforms (inline) → catalogs.socialPlatforms.source → the default catalog at https://www.pptx.gallery/social-platforms.
  */
 interface SocialPlatform {
     /**
@@ -774,7 +774,7 @@ interface SocialPlatform {
      */
     $schema: "https://openpresentation.org/schema/opf-social-platform/v1";
     /**
-     * Stable slug used by OPF documents to reference this platform — appears as a property key on Socials objects. Lowercase kebab-case.
+     * Stable slug used by OPF documents to reference this platform — appears as a property key on Socials objects. Lowercase kebab-case.
      */
     id: string;
     /**
@@ -782,7 +782,7 @@ interface SocialPlatform {
      */
     name: string;
     /**
-     * One-sentence positioning of the platform — what it's used for and who's on it.
+     * One-sentence positioning of the platform — what it's used for and who's on it.
      */
     summary?: string;
     /**
@@ -790,7 +790,7 @@ interface SocialPlatform {
      */
     description?: string;
     /**
-     * Canonical base URL of the platform — used as the prefix when normalizing handles to full URLs.
+     * Canonical base URL of the platform — used as the prefix when normalizing handles to full URLs.
      */
     baseUrl?: string;
     /**

package/dist/{validator-Be5EzqAt.d.ts → validator-D7WwzKyx.d.ts}

@@ -514,9 +514,9 @@ type ContentPayload = ({
  */
 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.
+ * 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.
+ * 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.
  */
@@ -530,7 +530,7 @@ interface Presentation {
      */
     name?: string;
     /**
-     * Free-form prose describing what this presentation is about. Used by agents and humans as a deck-level summary; complements purpose (the goal) and narrative (the structured storyline). Round-trips to OOXML 'docProps/core.xml' as '<dc:description>' (PowerPoint surfaces this as the 'Comments' field in File → Properties).
+     * Free-form prose describing what this presentation is about. Used by agents and humans as a deck-level summary; complements purpose (the goal) and narrative (the structured storyline). Round-trips to OOXML 'docProps/core.xml' as '<dc:description>' (PowerPoint surfaces this as the 'Comments' field in File → Properties).
      */
     description?: string;
     /**
@@ -554,7 +554,7 @@ interface Presentation {
      * - 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.
+     * Resolution order for catalog ids and references: inline catalogs.audiences.records[] → catalogs.audiences.source → default catalog at https://www.pptx.gallery/audiences.
      *
      * @minItems 1
      */
@@ -564,7 +564,7 @@ interface Presentation {
      * - 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.
+     * 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);
     /**
@@ -572,7 +572,7 @@ interface Presentation {
      * - 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.
+     * 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);
     /**
@@ -580,7 +580,7 @@ interface Presentation {
      * - 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.
+     * 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);
     /**
@@ -603,7 +603,7 @@ interface Presentation {
      * - 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.
+     * 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.
      */
@@ -624,7 +624,7 @@ interface Presentation {
     };
 }
 /**
- * An organization associated with the presentation — typically the presenting company, but also hosts, partners, clients, or sponsors. Surfaced on cover slides, footers, and brand bars; the primary organization's logo is the default deck logo unless overridden by design.logo.
+ * An organization associated with the presentation — typically the presenting company, but also hosts, partners, clients, or sponsors. 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".
@@ -1046,11 +1046,11 @@ interface FontScheme {
      */
     id?: string;
     /**
-     * Heading (major) font family — mirrors the OOXML majorFont entry. Pairs with 'minor'.
+     * 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'.
+     * Body (minor) font family — mirrors the OOXML minorFont entry. Pairs with 'major'.
      */
     minor?: string;
     /**
@@ -1871,7 +1871,7 @@ interface HeaderFooterItem2 {
 /**
  * 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.
+ * 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.
  *
@@ -1938,7 +1938,7 @@ interface Narrative {
     [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.
+ * 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.
  *
@@ -1959,7 +1959,7 @@ interface NarrativeBeat {
      */
     description?: string;
     /**
-     * Short author-facing instruction for the beat — typically one phrase. Complements 'description' with a concise directive.
+     * Short author-facing instruction for the beat — typically one phrase. Complements 'description' with a concise directive.
      */
     instructions?: string;
     /**
@@ -1971,7 +1971,7 @@ interface NarrativeBeat {
      */
     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.
+     * 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;
     /**
@@ -2002,7 +2002,7 @@ interface Slide {
     /**
      * 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.
+     * Resolution order: inline catalogs.layouts.records[] → catalogs.layouts.source → default catalog at https://www.pptx.gallery/layouts.
      */
     layout?: string;
     /**

package/dist/validator.d.ts

@@ -1,3 +1,3 @@
 import './catalogs.js';
-export { O as OPFValidationError, S as SchemaOrKind, V as ValidationIssue, a as ValidationResult, b as assertValid, c as assertValidCatalogRecord, d as assertValidPresentation, v as validate, e as validateCatalogRecord, f as validatePresentation } from './validator-Be5EzqAt.js';
+export { O as OPFValidationError, S as SchemaOrKind, V as ValidationIssue, a as ValidationResult, b as assertValid, c as assertValidCatalogRecord, d as assertValidPresentation, v as validate, e as validateCatalogRecord, f as validatePresentation } from './validator-D7WwzKyx.js';
 import './schemas.js';

package/dist/validator.js

@@ -20,8 +20,8 @@ var catalogSchemaNames = {
 var presentation = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf/v1",
-  "title": "OPF \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D Open Presentation Format",
-  "description": "Open-source JSON format for describing PowerPoint presentations. Agents describe narratives, content, audience, reusable assets, and design \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D the engine handles OOXML complexity.\n\nFields 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 \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 'catalogs.<kind>.source' on the document \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 engine defaults \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 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.\n\nMost 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.",
+  "title": "Presentation",
+  "description": "Open-source JSON format for describing PowerPoint presentations. Agents describe narratives, content, audience, reusable assets, and design \u2014 the engine handles OOXML complexity.\n\nFields 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 \u2192 'catalogs.<kind>.source' on the document \u2192 engine defaults \u2192 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.\n\nMost 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.",
   "type": "object",
   "required": [
     "slides"
@@ -38,13 +38,13 @@ var presentation = {
       "description": "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.",
       "examples": [
         "Q4 2026 Business Review",
-        "Series B Pitch \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D Acme",
+        "Series B Pitch \u2014 Acme",
         "The Future of Agentic Workflows"
       ]
     },
     "description": {
       "type": "string",
-      "description": "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 \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 Properties).",
+      "description": "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 \u2192 Properties).",
       "examples": [
         "Quarterly business review covering revenue, product, and hiring milestones for the executive team."
       ]
@@ -122,7 +122,7 @@ var presentation = {
         ]
       },
       "minItems": 1,
-      "description": "Intended audiences for the presentation. Each item accepts either:\n- A string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executives'), an HTTPS URL, or a 'pkg:' reference.\n- An inline Audience object for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.audiences.records[] \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 catalogs.audiences.source \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 default catalog at https://www.pptx.gallery/audiences.",
+      "description": "Intended audiences for the presentation. Each item accepts either:\n- A string shorthand: free-form description ('Series B investors'), an audiences catalog id ('executives'), an HTTPS URL, or a 'pkg:' reference.\n- An inline Audience object for custom audience metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-audience/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.audiences.records[] \u2192 catalogs.audiences.source \u2192 default catalog at https://www.pptx.gallery/audiences.",
       "examples": [
         [
           "executives"
@@ -158,7 +158,7 @@ var presentation = {
           "$ref": "#/$defs/Purpose"
         }
       ],
-      "description": "Primary goal of the presentation. Accepts either:\n- 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.\n- An inline Purpose object for custom purpose metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-purpose/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.purposes.records[] \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 catalogs.purposes.source \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 default catalog at https://www.pptx.gallery/purposes.",
+      "description": "Primary goal of the presentation. Accepts either:\n- 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.\n- An inline Purpose object for custom purpose metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-purpose/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.purposes.records[] \u2192 catalogs.purposes.source \u2192 default catalog at https://www.pptx.gallery/purposes.",
       "examples": [
         "Raise a Series B round of $30M",
         "align",
@@ -184,7 +184,7 @@ var presentation = {
           "$ref": "#/$defs/Language"
         }
       ],
-      "description": "Language for the presentation content. Accepts either:\n- 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.\n- An inline Language object for custom language metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-language/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.languages.records[] \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 catalogs.languages.source \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 default catalog at https://www.pptx.gallery/languages.",
+      "description": "Language for the presentation content. Accepts either:\n- 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.\n- An inline Language object for custom language metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-language/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.languages.records[] \u2192 catalogs.languages.source \u2192 default catalog at https://www.pptx.gallery/languages.",
       "examples": [
         "en-US",
         "en-GB",
@@ -218,7 +218,7 @@ var presentation = {
           "$ref": "#/$defs/Tone"
         }
       ],
-      "description": "Desired tone for the presentation. Accepts either:\n- A string shorthand: a tones catalog id ('formal'), an HTTPS URL, or a 'pkg:' reference.\n- An inline Tone object for custom tone metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-tone/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.tones.records[] \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 catalogs.tones.source \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 default catalog at https://www.pptx.gallery/tones.",
+      "description": "Desired tone for the presentation. Accepts either:\n- A string shorthand: a tones catalog id ('formal'), an HTTPS URL, or a 'pkg:' reference.\n- An inline Tone object for custom tone metadata or catalog-backed overrides. Object form mirrors https://openpresentation.org/schema/opf-tone/v1 without '$schema'.\n\nResolution order for catalog ids and references: inline catalogs.tones.records[] \u2192 catalogs.tones.source \u2192 default catalog at https://www.pptx.gallery/tones.",
       "examples": [
         "formal",
         "casual",
@@ -308,7 +308,7 @@ 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[] \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 catalogs.narratives.source \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 default catalog at https://www.pptx.gallery/narratives. Unknown ids produce a validation warning, not an error.
+Resolution order: inline catalogs.narratives.records[] \u2192 catalogs.narratives.source \u2192 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.`,
       "examples": [
@@ -799,7 +799,7 @@ Deck-level concerns that aren't part of the storyline (audience, tone, takeaway,
     },
     "Organization": {
       "type": "object",
-      "description": "An organization associated with the presentation \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D 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.",
+      "description": "An organization associated with the presentation \u2014 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.",
       "required": [
         "id",
         "name"
@@ -983,7 +983,7 @@ Deck-level concerns that aren't part of the storyline (audience, tone, takeaway,
     },
     "Socials": {
       "type": "object",
-      "description": "Social media handles or URLs, keyed by platform id from the 'socialPlatforms' catalog. Each value is a string \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D either a full URL or a platform handle (e.g., '@acme'). The catalog record for each platform carries the URL pattern, handle prefix, brand color, and themed icons used by renderers.\n\nKeys resolve to the 'id' of a 'socialPlatforms' catalog record. Resolution order: inline catalogs.socialPlatforms.records[] \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 catalogs.socialPlatforms.source \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 default catalog at https://www.pptx.gallery/social-platforms. Unknown platform keys render with engine fallbacks (the raw value as text). Used both for organization and speaker records.",
+      "description": "Social media handles or URLs, keyed by platform id from the 'socialPlatforms' catalog. Each value is a string \u2014 either a full URL or a platform handle (e.g., '@acme'). The catalog record for each platform carries the URL pattern, handle prefix, brand color, and themed icons used by renderers.\n\nKeys resolve to the 'id' of a 'socialPlatforms' catalog record. Resolution order: inline catalogs.socialPlatforms.records[] \u2192 catalogs.socialPlatforms.source \u2192 default catalog at https://www.pptx.gallery/social-platforms. Unknown platform keys render with engine fallbacks (the raw value as text). Used both for organization and speaker records.",
       "additionalProperties": {
         "type": "string",
         "description": "Handle or URL for the platform identified by the property key."
@@ -1007,7 +1007,7 @@ Deck-level concerns that aren't part of the storyline (audience, tone, takeaway,
     },
     "Narrative": {
       "type": "object",
-      "description": "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.\n\nNarrative declares the deck's intended story arc; slides may opt into beats via Slide.beat. The narrative does not constrain slide structure \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D 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.\n\nWhen '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.\n\nDeck-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.",
+      "description": "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.\n\nNarrative declares the deck's intended story arc; slides may opt into beats via Slide.beat. The narrative does not constrain slide structure \u2014 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.\n\nWhen '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.\n\nDeck-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.",
       "properties": {
         "id": {
           "type": "string",
@@ -1028,7 +1028,7 @@ Deck-level concerns that aren't part of the storyline (audience, tone, takeaway,
           "description": "Human-readable narrative name.",
           "examples": [
             "Classic Story",
-            "Problem \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 Solution",
+            "Problem \u2192 Solution",
             "SCQA",
             "Founder Pitch"
           ]
@@ -1118,7 +1118,7 @@ Deck-level concerns that aren't part of the storyline (audience, tone, takeaway,
     },
     "NarrativeBeat": {
       "type": "object",
-      "description": "A single narrative beat \xE2\u20AC\u201D 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.\n\nMirrors the Beat definition in narrative.schema.json (https://openpresentation.org/schema/opf-narrative/v1) so library entries and inline OPF beats are interchangeable.",
+      "description": "A single narrative beat \u2014 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.\n\nMirrors the Beat definition in narrative.schema.json (https://openpresentation.org/schema/opf-narrative/v1) so library entries and inline OPF beats are interchangeable.",
       "required": [
         "id",
         "name"
@@ -1155,7 +1155,7 @@ Deck-level concerns that aren't part of the storyline (audience, tone, takeaway,
         },
         "instructions": {
           "type": "string",
-          "description": "Short author-facing instruction for the beat \xE2\u20AC\u201D typically one phrase. Complements 'description' with a concise directive.",
+          "description": "Short author-facing instruction for the beat \u2014 typically one phrase. Complements 'description' with a concise directive.",
           "examples": [
             "Capture audience attention",
             "Introduce problem",
@@ -1186,7 +1186,7 @@ Deck-level concerns that aren't part of the storyline (audience, tone, takeaway,
         },
         "layoutHint": {
           "type": "string",
-          "description": "Suggested layout id for the beat's opening slide. Resolves the same way as Slide.layout \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D against catalogs.layouts and the default catalog at https://www.pptx.gallery/layouts.",
+          "description": "Suggested layout id for the beat's opening slide. Resolves the same way as Slide.layout \u2014 against catalogs.layouts and the default catalog at https://www.pptx.gallery/layouts.",
           "examples": [
             "section-divider",
             "title-slide",
@@ -1842,7 +1842,7 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
         },
         "major": {
           "type": "string",
-          "description": "Heading (major) font family \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D mirrors the OOXML majorFont entry. Pairs with 'minor'.",
+          "description": "Heading (major) font family \u2014 mirrors the OOXML majorFont entry. Pairs with 'minor'.",
           "examples": [
             "Aptos Display",
             "Calibri",
@@ -1852,7 +1852,7 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
         },
         "minor": {
           "type": "string",
-          "description": "Body (minor) font family \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D mirrors the OOXML minorFont entry. Pairs with 'major'.",
+          "description": "Body (minor) font family \u2014 mirrors the OOXML minorFont entry. Pairs with 'major'.",
           "examples": [
             "Aptos",
             "Calibri",
@@ -2421,7 +2421,7 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
         },
         "layout": {
           "type": "string",
-          "description": "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.\n\nResolution order: inline catalogs.layouts.records[] \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 catalogs.layouts.source \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 default catalog at https://www.pptx.gallery/layouts.",
+          "description": "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.\n\nResolution order: inline catalogs.layouts.records[] \u2192 catalogs.layouts.source \u2192 default catalog at https://www.pptx.gallery/layouts.",
           "examples": [
             "title",
             "title-subtitle",
@@ -3760,7 +3760,7 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
     },
     "Catalogs": {
       "type": "object",
-      "description": "Catalog overrides for the in-document references. Every property is optional. The default catalog for a kind lives at https://www.pptx.gallery/<kind> (e.g. https://www.pptx.gallery/narratives, https://www.pptx.gallery/themes). For each kind, declaring a 'source' replaces the default registry and/or 'records' adds inline records that take precedence over anything fetched from a source.\n\nResolution order for any reference (e.g. narrative, design.theme): inline catalogs.<kind>.records[] \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 catalogs.<kind>.source \xC3\xA2\xE2\u20AC\xA0\xE2\u20AC\u2122 default catalog at https://www.pptx.gallery/<kind>. Every reference resolves to the catalog record's 'id' field. References that are themselves URLs or 'pkg:' references skip the catalog lookup and resolve directly.",
+      "description": "Catalog overrides for the in-document references. Every property is optional. The default catalog for a kind lives at https://www.pptx.gallery/<kind> (e.g. https://www.pptx.gallery/narratives, https://www.pptx.gallery/themes). For each kind, declaring a 'source' replaces the default registry and/or 'records' adds inline records that take precedence over anything fetched from a source.\n\nResolution order for any reference (e.g. narrative, design.theme): inline catalogs.<kind>.records[] \u2192 catalogs.<kind>.source \u2192 default catalog at https://www.pptx.gallery/<kind>. Every reference resolves to the catalog record's 'id' field. References that are themselves URLs or 'pkg:' references skip the catalog lookup and resolve directly.",
       "properties": {
         "narratives": {
           "$ref": "#/$defs/CatalogEntry",
@@ -3852,7 +3852,7 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
 var audience = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-audience/v1",
-  "title": "OPF Audience",
+  "title": "Audience",
   "description": "Schema for audience records in the pptx.gallery library. Each record names an audience archetype (e.g. 'executives', 'engineering-team', 'investors') and carries seniority, technical-fluency, decision-power, and attention-budget hints used by AI-driven generation. Audiences are referenced from OPF documents via audience; the engine resolves the reference against catalogs.audiences (inline) \u2192 catalogs.audiences.source \u2192 the default catalog at https://www.pptx.gallery/audiences. The audience field also accepts free-form strings; this catalog is for engine-aware audience archetypes that carry generation hints.",
   "type": "object",
   "required": [
@@ -4024,7 +4024,7 @@ var audience = {
 var purpose = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-purpose/v1",
-  "title": "OPF Purpose",
+  "title": "Purpose",
   "description": "Schema for purpose records in the pptx.gallery library. Each record names a presentation objective such as informing, aligning, persuading, driving a decision, or selling. Purposes are referenced from OPF documents via purpose; the engine resolves the reference against catalogs.purposes (inline) \u2192 catalogs.purposes.source \u2192 the default catalog at https://www.pptx.gallery/purposes. The purpose field also accepts free-form strings and inline Purpose objects.",
   "type": "object",
   "required": [
@@ -4135,7 +4135,7 @@ var purpose = {
 var tone = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-tone/v1",
-  "title": "OPF Tone",
+  "title": "Tone",
   "description": "Schema for tone records in the pptx.gallery library. Each record names a presentation tone (e.g. 'formal', 'casual', 'inspirational') and carries voice cues, anti-patterns, and sample phrases that AI-driven generation uses to shape output. Tones are referenced from OPF documents via tone; the engine resolves the reference against catalogs.tones (inline) \u2192 catalogs.tones.source \u2192 the default catalog at https://www.pptx.gallery/tones.",
   "type": "object",
   "required": [
@@ -4294,7 +4294,7 @@ var tone = {
 var theme = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-theme/v1",
-  "title": "OPF Theme",
+  "title": "Theme",
   "description": "Schema for theme records in the pptx.gallery library. Each theme is a small, named bundle that pairs a color scheme, a font scheme, a default theme-controlled background, and a slide size. Themes are referenced from OPF documents via design.theme or design.theme.id; the engine resolves the reference against catalogs.themes (inline) \u2192 catalogs.themes.source \u2192 the default catalog at https://www.pptx.gallery/themes. Inline overrides on design.colorScheme / design.fontScheme / design.background / design.dimensions take precedence over a resolved theme.",
   "type": "object",
   "required": [
@@ -4470,7 +4470,7 @@ var theme = {
 var layout = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-layout/v1",
-  "title": "OPF Slide Layout",
+  "title": "Slide Layout",
   "description": "Schema for slide-layout records in the pptx.gallery library. Each record describes a semantic slide layout \u2014 what regions it exposes and what content kinds those regions are intended to hold. Layouts are referenced from OPF documents via Slide.layout; the engine resolves the reference against catalogs.layouts (inline) \u2192 catalogs.layouts.source \u2192 the default catalog at https://www.pptx.gallery/layouts. Free-form custom layout names that don't resolve through any catalog fall through to engine-defined layouts.",
   "type": "object",
   "required": [
@@ -4752,7 +4752,7 @@ var layout = {
 var chartType = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-chart-type/v1",
-  "title": "OPF Chart Type",
+  "title": "Chart Type",
   "description": "Schema for chart-type records in the pptx.gallery catalog. Each record describes a named chart variant, its Open XML mapping, its series/category cardinality, the column structure of the underlying workbook, and a small sample dataset suitable for previews. Chart types are referenced from OPF chart content payloads; the engine resolves the reference against catalogs.chartTypes (inline) -> catalogs.chartTypes.source -> the default catalog at https://www.pptx.gallery/chart-types.",
   "type": "object",
   "additionalProperties": false,
@@ -5289,7 +5289,7 @@ var chartType = {
 var narrative = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-narrative/v1",
-  "title": "OPF Narrative Template",
+  "title": "Narrative Template",
   "description": "Schema for narrative template files in the openpresentation.org catalog. Each template describes a named story arc (e.g. 'problem-solution', 'scqa') as an ordered list of beats. Templates are referenced from OPF documents via narrative \u2014 either as a bare id string (e.g. 'classic-story') or as an inline object whose shape matches this schema (sans '$schema').",
   "type": "object",
   "required": [
@@ -5496,8 +5496,8 @@ var narrative = {
 var socialPlatform = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-social-platform/v1",
-  "title": "OPF Social Platform",
-  "description": "Schema for social-platform records in the pptx.gallery library. Each record describes a single social-media platform \xE2\u20AC\u201D its base URL, profile-URL pattern, handle prefix, brand color, and themed icons. Records are referenced from OPF documents indirectly: the property keys of any Socials object (Organization.socials, Speaker.socials) match record ids, and renderers use the catalog record to format URLs and pick icons. The engine resolves references against catalogs.socialPlatforms (inline) \xE2\u2020\u2019 catalogs.socialPlatforms.source \xE2\u2020\u2019 the default catalog at https://www.pptx.gallery/social-platforms.",
+  "title": "Social Platform",
+  "description": "Schema for social-platform records in the pptx.gallery library. Each record describes a single social-media platform \u2014 its base URL, profile-URL pattern, handle prefix, brand color, and themed icons. Records are referenced from OPF documents indirectly: the property keys of any Socials object (Organization.socials, Speaker.socials) match record ids, and renderers use the catalog record to format URLs and pick icons. The engine resolves references against catalogs.socialPlatforms (inline) \u2192 catalogs.socialPlatforms.source \u2192 the default catalog at https://www.pptx.gallery/social-platforms.",
   "type": "object",
   "required": [
     "$schema",
@@ -5513,7 +5513,7 @@ var socialPlatform = {
     "id": {
       "type": "string",
       "pattern": "^[a-z][a-z0-9-]*$",
-      "description": "Stable slug used by OPF documents to reference this platform \xE2\u20AC\u201D appears as a property key on Socials objects. Lowercase kebab-case.",
+      "description": "Stable slug used by OPF documents to reference this platform \u2014 appears as a property key on Socials objects. Lowercase kebab-case.",
       "examples": [
         "linkedin",
         "x",
@@ -5545,7 +5545,7 @@ var socialPlatform = {
     },
     "summary": {
       "type": "string",
-      "description": "One-sentence positioning of the platform \xE2\u20AC\u201D what it's used for and who's on it.",
+      "description": "One-sentence positioning of the platform \u2014 what it's used for and who's on it.",
       "examples": [
         "Professional social network for individuals and companies.",
         "Real-time microblog for news, opinions, and discussion."
@@ -5561,7 +5561,7 @@ var socialPlatform = {
     "baseUrl": {
       "type": "string",
       "format": "uri",
-      "description": "Canonical base URL of the platform \xE2\u20AC\u201D used as the prefix when normalizing handles to full URLs.",
+      "description": "Canonical base URL of the platform \u2014 used as the prefix when normalizing handles to full URLs.",
       "examples": [
         "https://linkedin.com",
         "https://x.com",
@@ -5695,7 +5695,7 @@ var socialPlatform = {
 var language = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-language/v1",
-  "title": "OPF Language",
+  "title": "Language",
   "description": "Schema for language records in the pptx.gallery library. Each record names a presentation language, carries a BCP-47 language tag, and pairs it with sensible default font schemes for PowerPoint and Google Slides output. Languages are referenced from OPF documents via language; the engine resolves the reference against catalogs.languages (inline) \u2192 catalogs.languages.source \u2192 the default catalog at https://www.pptx.gallery/languages. The presentation language field also accepts BCP-47 tags directly or inline Language objects for engine-aware language records that carry default-font hints.",
   "type": "object",
   "required": [
@@ -5865,7 +5865,7 @@ var language = {
 var colorScheme = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-color-scheme/v1",
-  "title": "OPF Color Scheme",
+  "title": "Color Scheme",
   "description": "Schema for color-scheme records in the pptx.gallery library. Each scheme is a named palette with the twelve PowerPoint color slots (six accents, two darks, two lights, plus hyperlink and followed-hyperlink), suitable for being mapped directly into OOXML theme XML. Color schemes are referenced from OPF documents via design.colorScheme or design.colorScheme.id; the engine resolves the reference against catalogs.colorSchemes (inline) -> catalogs.colorSchemes.source -> the default catalog at https://www.pptx.gallery/color-schemes. Slot overrides on design.colorScheme take precedence over the resolved scheme.\n\nThe slot fields here mirror the inline-override fields on the in-document ColorScheme type (in opf.schema.json), so library entries and inline OPF overrides are interchangeable.",
   "type": "object",
   "required": [
@@ -6065,7 +6065,7 @@ var colorScheme = {
 var fontScheme = {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://openpresentation.org/schema/opf-font-scheme/v1",
-  "title": "OPF Font Scheme",
+  "title": "Font Scheme",
   "description": "Schema for font-scheme records in the pptx.gallery library. Each scheme pairs a major (heading) and minor (body) font family in the OOXML majorFont/minorFont sense, scoped to a target app (PowerPoint or Google Slides) and a language family (Latin, East Asian, or Complex Script). Font schemes are referenced from OPF documents via design.fontScheme or design.fontScheme.id; the engine resolves the reference against catalogs.fontSchemes (inline) \u2192 catalogs.fontSchemes.source \u2192 the default catalog at https://www.pptx.gallery/font-schemes. Role overrides on design.fontScheme (heading, body, accent, code) take precedence over the resolved scheme.",
   "type": "object",
   "required": [