@openpresentation/opf 0.17.0 → 0.18.3

package/dist/{presentation-fb8CZmRq.d.ts → presentation-81rNihF0.d.ts}

@@ -1,3 +1,31 @@
+/**
+ * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "Asset".
+ */
+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;
+});
 /**
  * Inline audience metadata for the presentation. Use 'id' to reference an audiences record (a bare id or 'name:id') and override selected fields, or use 'name' for a custom inline audience.
  *
@@ -165,7 +193,7 @@ type Tone1 = {
     [k: string]: unknown;
 };
 /**
- * Named dimension preset; chooses both aspect ratio and physical size. 'widescreen' is an alias for 16:9 in PowerPoint widescreen size; 'standard' is an alias for 4:3 in PowerPoint standard size. The social-feed ratios keep the widescreen short edge of 7.5 in: 1:1 is 7.5 x 7.5 in, 4:5 is 7.5 x 9.375 in and 9:16 is 7.5 x 13.333 in (portrait).
+ * Named preset; sets aspect ratio and physical size. 16:9 ('widescreen'): 13.333 x 7.5 in, PowerPoint's Widescreen. 4:3 ('standard'): 10 x 7.5 in. 16:10: 10 x 6.25 in. letter (11 x 8.5 in) and a4 (11.69 x 8.27 in) are paper sizes, not PowerPoint's Letter Paper or A4 Paper. 1:1, 4:5 and 9:16 are 7.5 in on the short edge.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "DimensionPreset".
@@ -206,34 +234,6 @@ type ImageSource = string;
  * via the `definition` "Background".
  */
 type Background = (ThemeBackground | SolidBackground | GradientBackground | ImageBackground | PatternBackground);
-/**
- * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
- *
- * 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;
-});
 /**
  * Decorative watermark: an image ('src') or a text stamp ('text'), exactly one of the two, with its opacity. An image is drawn once per slide, contained and centered in a fixed frame (the middle 40% of the slide width and height, from 30% to 70% on each axis). A text watermark is one line of text in the heading font and the theme text color at the given opacity, centered on the slide and rotated 30 degrees counterclockwise (rising to the right), sized to span at most 70% of the slide width and at most 30% of the shorter slide edge in height; it is drawn behind the slide content and above the background. There is no option to move, scale, rotate or tile either form. PPTX export writes one native picture (image) or one native text box (text) per slide with the opacity as alpha, and import restores the watermark. A string or Asset (no opacity) is the image watermark at opacity 0.08. A watermark object needs opacity and exactly one of src and text; use a plain string or Asset for an image at the default opacity. Use design.watermark = false to disable an inherited watermark.
  *
@@ -631,7 +631,7 @@ interface Presentation {
      */
     filename?: string;
     /**
-     * Organization associated with the presentation, usually the presenting company. Array form supports hosts, partners, clients, and sponsors. The primary organization (Organization.role 'primary', else the first item) supplies the default deck logo, the 'socials' header/footer field and the 'organization.<field>' built-in variables; the others are available by id as 'organization.<id>.<field>' and are not drawn automatically.
+     * Organization associated with the presentation, usually the presenting company. Array form supports hosts, partners, clients, and sponsors. The primary organization (Organization.role 'primary', else the first item) supplies the cover and section logo, the 'socials' header/footer field and the 'organization.<field>' built-in variables; the others are available by id as 'organization.<id>.<field>' and are not drawn automatically.
      */
     organization?: (Organization | [Organization, ...(Organization)[]]);
     /**
@@ -718,7 +718,7 @@ interface Presentation {
     };
 }
 /**
- * An organization associated with the presentation, typically the presenting company, but also hosts, partners, clients, or sponsors. The primary organization (role 'primary', else the first one) supplies the default deck logo (unless design.logo overrides it) and the 'socials' header/footer field (its socials). Every field is also a built-in variable ('{{organization.name}}', 'var:organization.logo', 'organization.<id>.<field>'). Nothing else about an organization is drawn automatically. See docs/templates-and-variables.md.
+ * An organization associated with the presentation, typically the presenting company, but also hosts, partners, clients, or sponsors. The primary organization (role 'primary', else the first one) supplies the cover and section logo (unless design.logo overrides it) and the 'socials' header/footer field (its socials). Every field is also a built-in variable ('{{organization.name}}', 'organization.<id>.<field>'), and every logo a slide-scoped image ('var:organization.logo.icon', 'var:organization.<id>.logo'). Nothing else about an organization is drawn automatically. See docs/templates-and-variables.md.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Organization".
@@ -737,30 +737,9 @@ interface Organization {
      */
     legalName?: string;
     /**
-     * Source for the organization's logo image. Accepts an HTTPS URL, data URI, relative path (resolved against the OPF file location), local path, or 'asset:<id>' reference. Common formats are SVG (preferred for vector logos), PNG (with transparency), or JPG. The primary organization's logo (role 'primary', else the first organization) is the fallback source wherever the deck logo is drawn: a slide's design.logo, then design.logo, then this value. It is therefore drawn on cover and section slides and by header/footer zones with logo: true, exactly as design.logo would be (see design.logo and docs/design-resolution.md). It is also the built-in image variable 'organization.logo' (or 'organization.<id>.logo'), placed with 'var:organization.logo' in an image field.
+     * The organization's logo. A path, URL or Asset is one logo for every shape; an object gives up to four shapes (full, stacked, icon, wordmark), each a path or Asset, or { onLight, onDark } for the two backgrounds. A path is resolved against the OPF file location; an HTTPS URL, data URI or 'asset:<id>' reference works too. SVG (preferred for vector logos) or PNG with transparency are typical. The primary organization's full logo (role 'primary', else the first organization) is drawn on cover and section slides unless design.logo names another or is false. Every logo is also a slide-scoped built-in image, placed with a whole-field reference in any image field: 'var:organization.logo' (the full logo), 'var:organization.logo.icon' (likewise stacked, wordmark, full), and 'var:organization.<id>.logo' or 'var:organization.<id>.logo.<shape>' for another organization. A missing shape falls back to full, and full to the first defined of wordmark, stacked and icon. The onLight or onDark value is chosen for each slide's background; a missing one uses the other. See docs/templates-and-variables.md and docs/design-resolution.md.
      */
-    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;
-    });
+    logo?: (Asset | OrganizationLogo);
     /**
      * Bare internet domain for the organization. Never drawn automatically and not used to look up assets; available as the built-in variable 'organization.domain'.
      */
@@ -778,12 +757,240 @@ interface Organization {
      */
     tagline?: string;
     /**
-     * Role of the organization relative to the presentation. Only 'primary' has behavior: it selects the primary organization (deck logo, the 'socials' header/footer field, and the 'organization.<field>' built-ins). When no organization has role 'primary', the first one is primary. 'partner', 'client', 'sponsor' and 'host' are descriptive labels that change nothing.
+     * Role of the organization relative to the presentation. Only 'primary' has behavior: it selects the primary organization (cover and section logo, the 'socials' header/footer field, and the 'organization.<field>' built-ins). When no organization has role 'primary', the first one is primary. 'partner', 'client', 'sponsor' and 'host' are descriptive labels that change nothing.
      */
     role?: ("primary" | "partner" | "client" | "sponsor" | "host");
     socials?: Socials;
     [k: string]: unknown;
 }
+/**
+ * An organization's logo in up to four shapes. Each shape is a path or Asset, or { onLight, onDark } for the two backgrounds. A missing shape falls back to full, and full to the first defined of wordmark, stacked and icon; within a shape a missing onLight or onDark uses the other. Shapes are placed with slide-scoped references such as 'var:organization.logo.icon'.
+ *
+ * This interface was referenced by `Presentation`'s JSON-Schema
+ * via the `definition` "OrganizationLogo".
+ */
+interface OrganizationLogo {
+    /**
+     * The full logo (lockup): mark and name side by side. Drawn on cover and section slides, and placed by 'var:organization.logo'.
+     */
+    full?: (Asset | {
+        /**
+         * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
+         */
+        onLight?: (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;
+        });
+        /**
+         * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
+         */
+        onDark?: (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;
+        });
+    });
+    /**
+     * The stacked lockup: mark above the name, for portrait or square slots. Placed by 'var:organization.logo.stacked'.
+     */
+    stacked?: (Asset | {
+        /**
+         * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
+         */
+        onLight?: (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;
+        });
+        /**
+         * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
+         */
+        onDark?: (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;
+        });
+    });
+    /**
+     * The mark or symbol without the name, for tight spaces such as header and footer zones and picture bullets. Placed by 'var:organization.logo.icon'.
+     */
+    icon?: (Asset | {
+        /**
+         * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
+         */
+        onLight?: (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;
+        });
+        /**
+         * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
+         */
+        onDark?: (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;
+        });
+    });
+    /**
+     * The name set in the brand's lettering, without the mark. Placed by 'var:organization.logo.wordmark'.
+     */
+    wordmark?: (Asset | {
+        /**
+         * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
+         */
+        onLight?: (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;
+        });
+        /**
+         * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
+         */
+        onDark?: (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 social media handles or URLs for the organization. The primary organization's socials render in header/footer zones that set socials: true; otherwise they are authoring metadata.
  */
@@ -813,7 +1020,7 @@ interface Speaker {
      */
     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. Never drawn automatically: it is the built-in image variable 'speaker.photo' (or 'speaker.<id>.photo'), placed with 'var:speaker.photo' in a slide's image field. It also round-trips through PPTX provenance.
+     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
      */
     photo?: (string | {
         /**
@@ -951,9 +1158,9 @@ interface Design {
      */
     background?: (BackgroundShortcut | Background);
     /**
-     * Deck logo assets used by covers, section dividers, headers, footers and picture bullets. A string or Asset object is the default logo source; the LogoSet object form provides light/dark, stacked, icon, and wordmark variants (see LogoSet for the selection order). Source precedence: a slide's design.logo, then this value, then the primary organization's logo; absence inherits. Placement (reference engines, vetoable): on a cover or section slide (no body payload on a heading-only layout such as title, title-subtitle or section-divider, or no layout) the lockup variant is drawn at the top-left of the free area, inside the slide padding and below any header furniture, in a box 56 reference pixels tall and at most four times as wide; the tag/title/subtitle group then centers in the remaining span. Content slides never get an automatic logo. Header and footer zones draw the icon variant when they set logo: true, and design.listBullet 'image' draws it as the picture bullet. composeSlide returns the cover box as geometry.logo.
+     * Which logo covers, section dividers and picture bullets draw. Logos live on the organization (Organization.logo); without this field covers and sections draw the primary organization's full logo and picture bullets its icon. A logo reference overrides that: 'var:organization.beta.logo' draws organization beta's logo, and a reference that names a shape ('var:organization.logo.wordmark') draws that shape everywhere this field applies. false draws no logo. A slide's design.logo overrides the deck's; absence inherits. An override naming an organization without a logo draws nothing (validation warns). Placement (reference engines, vetoable): on a cover or section slide (no body payload on a heading-only layout such as title, title-subtitle or section-divider, or no layout) the logo is drawn at the top-left of the free area, inside the slide padding and below any header furniture, in a box 56 reference pixels tall and at most four times as wide; the tag/title/subtitle group then centers in the remaining span. Content slides never get an automatic logo; a header or footer zone places one with image: 'var:organization.logo.icon'. composeSlide returns the cover box as geometry.logo.
      */
-    logo?: (Asset | LogoSet);
+    logo?: (string | false);
     /**
      * Optional decorative watermark applied across slides: an image or a text stamp, in the fixed frame and at the opacity described on Watermark. Use false to suppress an inherited watermark in slide-level design; a string or Asset is the image at opacity 0.08.
      */
@@ -991,7 +1198,7 @@ interface Design {
      */
     imageFit?: ("cover" | "contain" | "stretch");
     /**
-     * Marker style for items and bullets lists. Effective value: the slide's design, then the deck's design, then the layout record's design.listBullet, then 'character'. 'character' (the default) draws the glyph marker. 'image' draws the deck's icon logo (a slide's design.logo, then design.logo, then the primary organization's logo; light variants on dark backgrounds) as a picture bullet: a square of the marker's font size whose bottom sits on the marker baseline, so list geometry does not change. Without a logo the glyph is drawn and the engine reports unresolved-content at this field.
+     * Marker style for items and bullets lists. Effective value: the slide's design, then the deck's design, then the layout record's design.listBullet, then 'character'. 'character' (the default) draws the glyph marker. 'image' draws the primary organization's icon logo (or the organization and shape design.logo names; the onDark value on dark backgrounds) as a picture bullet: a square of the marker's font size whose bottom sits on the marker baseline, so list geometry does not change. Without a logo the glyph is drawn and the engine reports unresolved-content at this field.
      */
     listBullet?: ("character" | "image");
     [k: string]: unknown;
@@ -1173,7 +1380,7 @@ interface FontScheme {
     [k: string]: unknown;
 }
 /**
- * Slide dimensions; either pick a preset or specify custom inches.
+ * Slide dimensions: a preset, or custom inches that override it. PowerPoint's Letter Paper (10 x 7.5 in), A4 Paper (10.8333 x 7.5 in) and On-screen Show (16:9) (10 x 5.625 in) are not OPF presets; use widthInches and heightInches. docs/slide-sizes.md compares every preset.
  *
  * This interface was referenced by `Presentation`'s JSON-Schema
  * via the `definition` "Dimensions".
@@ -1406,314 +1613,6 @@ interface PatternBackground {
     opacity?: number;
     [k: string]: unknown;
 }
-/**
- * Deck logo variants surfaced by covers, section dividers, headers, footers and picture bullets. Organization identity lives in organization; this object only controls visual rendering assets. Engines select one variant per slot and background tone (resolveLogo in @openpresentation/opf): same-tone variants first, neutral ones next, the opposite tone last. Lockup on a dark background: light, default, stackedLight, stacked, wordmarkLight, wordmark, iconLight, icon, then dark, stackedDark, wordmarkDark, iconDark; on a light background: dark, default, stackedDark, stacked, wordmarkDark, wordmark, iconDark, icon, then light, stackedLight, wordmarkLight, iconLight. The icon slot (headers, footers, picture bullets) tries iconLight or iconDark for the tone, then icon, then the lockup chain; the stacked slot tries stackedLight or stackedDark, then stacked, then the lockup chain.
- *
- * 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 or mediaType 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    light?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    dark?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    stacked?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    stackedLight?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    stackedDark?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    icon?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    iconLight?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    iconDark?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    wordmark?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    wordmarkLight?: (string | {
-        /**
-         * 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;
-    });
-    /**
-     * Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.
-     */
-    wordmarkDark?: (string | {
-        /**
-         * 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;
-    });
-}
 /**
  * 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.
  *
@@ -1730,10 +1629,6 @@ interface HeaderFooter {
  * Left-aligned header/footer content.
  */
 interface HeaderFooterItem {
-    /**
-     * Whether to render the deck's icon logo in this zone: a slide's design.logo, then design.logo, then the primary organization's logo (LogoSet icon variants first, light ones on dark backgrounds). It is a generated image part in the same box as image; without a logo the engine reports unresolved-content at this field. Use image for a literal picture that is not the deck logo.
-     */
-    logo?: boolean;
     /**
      * Text rendered in this zone. Variables resolve inside it like any string: deck-wide ones ('{{organization.name}}', '{{speaker.name}}, {{speaker.title}}', '{{customer}}') before composition, and the slide-scoped built-ins '{{slide.number}}', '{{slide.section}}' and '{{deck.slideCount}}' for each slide as it is laid out. Each '{{slide.number}}' is a live slide-number field: PPTX export writes it as a native field when its value fits within one accepted text line, and as static text with a diagnostic otherwise. '{{deck.slideCount}}' is fixed text, because PowerPoint has no slide-count field. Write '\{{' for literal braces.
      */
@@ -1780,10 +1675,6 @@ interface HeaderFooterItem {
  * Centered header/footer content.
  */
 interface HeaderFooterItem1 {
-    /**
-     * Whether to render the deck's icon logo in this zone: a slide's design.logo, then design.logo, then the primary organization's logo (LogoSet icon variants first, light ones on dark backgrounds). It is a generated image part in the same box as image; without a logo the engine reports unresolved-content at this field. Use image for a literal picture that is not the deck logo.
-     */
-    logo?: boolean;
     /**
      * Text rendered in this zone. Variables resolve inside it like any string: deck-wide ones ('{{organization.name}}', '{{speaker.name}}, {{speaker.title}}', '{{customer}}') before composition, and the slide-scoped built-ins '{{slide.number}}', '{{slide.section}}' and '{{deck.slideCount}}' for each slide as it is laid out. Each '{{slide.number}}' is a live slide-number field: PPTX export writes it as a native field when its value fits within one accepted text line, and as static text with a diagnostic otherwise. '{{deck.slideCount}}' is fixed text, because PowerPoint has no slide-count field. Write '\{{' for literal braces.
      */
@@ -1830,10 +1721,6 @@ interface HeaderFooterItem1 {
  * Right-aligned header/footer content.
  */
 interface HeaderFooterItem2 {
-    /**
-     * Whether to render the deck's icon logo in this zone: a slide's design.logo, then design.logo, then the primary organization's logo (LogoSet icon variants first, light ones on dark backgrounds). It is a generated image part in the same box as image; without a logo the engine reports unresolved-content at this field. Use image for a literal picture that is not the deck logo.
-     */
-    logo?: boolean;
     /**
      * Text rendered in this zone. Variables resolve inside it like any string: deck-wide ones ('{{organization.name}}', '{{speaker.name}}, {{speaker.title}}', '{{customer}}') before composition, and the slide-scoped built-ins '{{slide.number}}', '{{slide.section}}' and '{{deck.slideCount}}' for each slide as it is laid out. Each '{{slide.number}}' is a live slide-number field: PPTX export writes it as a native field when its value fits within one accepted text line, and as static text with a diagnostic otherwise. '{{deck.slideCount}}' is fixed text, because PowerPoint has no slide-count field. Write '\{{' for literal braces.
      */
@@ -2372,7 +2259,7 @@ interface Slide {
      */
     section?: string;
     /**
-     * Whether the slide is hidden from the presented sequence. The player skips it, the PPTX export writes it as a hidden slide, and per-slide image and PDF output skips it unless the caller asks to include hidden slides (opf CLI: --include-hidden; the deck-level renderSvg: the opt-in skipHidden). A slide named explicitly (opf render --slides, renderSvg slideIndex) is still rendered.
+     * Whether the slide is hidden from the presented sequence. The player skips it, the PPTX export writes it as a hidden slide, and per-slide image and PDF output skips it unless the caller asks to include hidden slides (opf CLI: --include-hidden; the deck-level toSvg: the opt-in skipHidden). A slide named explicitly (opf convert --slides, toSvg with a slide number) is still rendered.
      */
     hidden?: boolean;
     composition?: Composition1;
@@ -3045,9 +2932,9 @@ interface Design1 {
      */
     background?: (BackgroundShortcut | Background);
     /**
-     * Deck logo assets used by covers, section dividers, headers, footers and picture bullets. A string or Asset object is the default logo source; the LogoSet object form provides light/dark, stacked, icon, and wordmark variants (see LogoSet for the selection order). Source precedence: a slide's design.logo, then this value, then the primary organization's logo; absence inherits. Placement (reference engines, vetoable): on a cover or section slide (no body payload on a heading-only layout such as title, title-subtitle or section-divider, or no layout) the lockup variant is drawn at the top-left of the free area, inside the slide padding and below any header furniture, in a box 56 reference pixels tall and at most four times as wide; the tag/title/subtitle group then centers in the remaining span. Content slides never get an automatic logo. Header and footer zones draw the icon variant when they set logo: true, and design.listBullet 'image' draws it as the picture bullet. composeSlide returns the cover box as geometry.logo.
+     * Which logo covers, section dividers and picture bullets draw. Logos live on the organization (Organization.logo); without this field covers and sections draw the primary organization's full logo and picture bullets its icon. A logo reference overrides that: 'var:organization.beta.logo' draws organization beta's logo, and a reference that names a shape ('var:organization.logo.wordmark') draws that shape everywhere this field applies. false draws no logo. A slide's design.logo overrides the deck's; absence inherits. An override naming an organization without a logo draws nothing (validation warns). Placement (reference engines, vetoable): on a cover or section slide (no body payload on a heading-only layout such as title, title-subtitle or section-divider, or no layout) the logo is drawn at the top-left of the free area, inside the slide padding and below any header furniture, in a box 56 reference pixels tall and at most four times as wide; the tag/title/subtitle group then centers in the remaining span. Content slides never get an automatic logo; a header or footer zone places one with image: 'var:organization.logo.icon'. composeSlide returns the cover box as geometry.logo.
      */
-    logo?: (Asset | LogoSet);
+    logo?: (string | false);
     /**
      * Optional decorative watermark applied across slides: an image or a text stamp, in the fixed frame and at the opacity described on Watermark. Use false to suppress an inherited watermark in slide-level design; a string or Asset is the image at opacity 0.08.
      */
@@ -3085,7 +2972,7 @@ interface Design1 {
      */
     imageFit?: ("cover" | "contain" | "stretch");
     /**
-     * Marker style for items and bullets lists. Effective value: the slide's design, then the deck's design, then the layout record's design.listBullet, then 'character'. 'character' (the default) draws the glyph marker. 'image' draws the deck's icon logo (a slide's design.logo, then design.logo, then the primary organization's logo; light variants on dark backgrounds) as a picture bullet: a square of the marker's font size whose bottom sits on the marker baseline, so list geometry does not change. Without a logo the glyph is drawn and the engine reports unresolved-content at this field.
+     * Marker style for items and bullets lists. Effective value: the slide's design, then the deck's design, then the layout record's design.listBullet, then 'character'. 'character' (the default) draws the glyph marker. 'image' draws the primary organization's icon logo (or the organization and shape design.logo names; the onDark value on dark backgrounds) as a picture bullet: a square of the marker's font size whose bottom sits on the marker baseline, so list geometry does not change. Without a logo the glyph is drawn and the engine reports unresolved-content at this field.
      */
     listBullet?: ("character" | "image");
     [k: string]: unknown;