@texuli/deck 0.0.0-stage → 0.5.0

package/dist/model/deck.d.ts

@@ -0,0 +1,392 @@
+/**
+ * The deck model v2 schemas (ADR-009, model-v2 §3.1, §3.2): `meta`, `style`,
+ * `navigation`, `outline` and 1 to 200 slides discriminated by `layout` (the
+ * 20 catalog layouts, `free`, `component` and `custom`), with
+ * `formatVersion: 2`. Built on the owned schema kit, so one definition gives
+ * all-issues validation, the `Infer` types and the JSON Schema export.
+ *
+ * The engine is L0: blocks and component props are checked here only as
+ * bounded JSON with a block head (`type`, `id`, step fields) and known
+ * nested containers. `parseDeck` hands each block and component to the
+ * host's validators (the slides stage injects `@texuli/blocks` and the
+ * component registry).
+ */
+import { type Infer, type JsonSchema, type JsonValue, type PathSegment, type Schema } from '../schema/index.js';
+import { type DeckCatalogLayoutId, type LayoutProps } from './layouts/catalog.js';
+import { stepFields } from './shared.js';
+import { deckStyle } from './style/schema.js';
+/** The model's format version. */
+export declare const DECK_FORMAT_VERSION = 2;
+/** Deck-level limits (model-v2 §3.2). */
+export declare const DECK_MODEL_LIMITS: Readonly<{
+    slides: 200;
+    sections: 200;
+    sectionSlides: 200;
+    titleLength: 200;
+    descriptionLength: 500;
+    authorLength: 120;
+    outlineTitleLength: 120;
+    notesLength: 6000;
+    stepLabels: 32;
+    stepLabelLength: 80;
+    freeBlocks: 2000;
+    autoSlideMinMs: 1000;
+    autoSlideMaxMs: 600000;
+}>;
+/** v1's eight free-slide arrangements (`master` on a free slide; default `content`). */
+export declare const SLIDE_MASTERS: readonly ["title", "section", "content", "two-column", "media-left", "media-right", "quote", "closing"];
+export type SlideMasterId = (typeof SLIDE_MASTERS)[number];
+/** The slide kinds that are not catalog layouts. */
+export declare const DECK_SLIDE_KINDS: readonly ["free", "component", "custom"];
+export type DeckSlideKind = (typeof DECK_SLIDE_KINDS)[number];
+/** Every `layout` value a slide may carry: 20 catalog layouts and the 3 slide kinds. */
+export declare const DECK_SLIDE_LAYOUTS: readonly ["title-hero", "section-divider", "two-column-split", "three-column-cards", "image-left", "image-right", "image-centered", "image-full-bleed", "quote", "code-with-callout", "big-stat", "comparison-table", "process-steps", "timeline", "team-avatars", "closing-cta", "video-centered", "video-left", "video-right", "chart", "free", "component", "custom"];
+export type DeckSlideLayout = (typeof DECK_SLIDE_LAYOUTS)[number];
+export declare const DECK_DIRECTIONS: readonly ["ltr", "rtl", "auto"];
+export type DeckDirection = (typeof DECK_DIRECTIONS)[number];
+/** BCP 47 language tag syntax (`en`, `en-GB`, `pt-BR`). */
+export declare const LOCALE_PATTERN = "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$";
+/** An ISO 8601 calendar date. */
+export declare const ISO_DATE_PATTERN = "^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$";
+/** Block `type` and catalog component ids: a lowercase slug starting with a letter. */
+export declare const BLOCK_TYPE_PATTERN = "^[a-z][a-z0-9-]{0,63}$";
+export declare const COMPONENT_ID_PATTERN = "^[a-z][a-z0-9-]{0,63}$";
+/** Block tones (`@texuli/blocks` `BLOCK_TONES`): the fragment tones plus `neutral`. */
+export declare const BLOCK_TONES: readonly ["neutral", "accent", "info", "success", "warning", "danger"];
+/** Component item heights. */
+export declare const COMPONENT_HEIGHTS: readonly ["sm", "md", "lg", "fill"];
+/** Bounds for one free-slide item (the outer guard; the host block parser is tighter). */
+export declare const BLOCK_JSON_LIMITS: Readonly<{
+    depth: 12;
+    maxKeys: 100;
+    maxItems: 2000;
+    /** Room for a 192 KB base64 `data:` image; code and markdown are far smaller. */
+    maxString: 300000;
+    maxKeyLength: 64;
+}>;
+/**
+ * Where nested blocks live inside a block, as the steps pass walks them:
+ * `blocks` and `children` (lists of blocks), `columns` (a list of lists) and
+ * `panels` (objects with `blocks`).
+ */
+export declare const BLOCK_CONTAINERS: Readonly<{
+    lists: readonly ["blocks", "children"];
+    columns: "columns";
+    panels: "panels";
+}>;
+/** The step fields every slide item may carry (removed before the host block parser). */
+export declare const STEP_FIELD_KEYS: readonly ["step", "fragment", "reveal"];
+export declare const deckMeta: import("../index.js").ObjectSchema<{
+    readonly title: import("../index.js").StringSchema;
+    readonly description: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly locale: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly dir: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"ltr" | "rtl" | "auto">, false>;
+    readonly author: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly date: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+}>;
+export type DeckMeta = Infer<typeof deckMeta>;
+export declare const deckNavigation: import("../index.js").ObjectSchema<{
+    readonly start: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly loop: import("../index.js").OptionalSchema<import("../index.js").BooleanSchema, false>;
+    readonly autoSlideMs: import("../index.js").OptionalSchema<import("../index.js").RefineSchema<import("../index.js").NumberSchema>, false>;
+}>;
+export type DeckNavigation = Infer<typeof deckNavigation>;
+export declare const deckSection: import("../index.js").ObjectSchema<{
+    readonly id: import("../index.js").StringSchema;
+    readonly title: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly slideIds: import("../index.js").ArraySchema<import("../index.js").StringSchema>;
+    readonly stack: import("../index.js").OptionalSchema<import("../index.js").BooleanSchema, false>;
+}>;
+export type DeckSection = Infer<typeof deckSection>;
+export declare const deckOutline: import("../index.js").ObjectSchema<{
+    readonly title: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly sections: import("../index.js").ArraySchema<import("../index.js").ObjectSchema<{
+        readonly id: import("../index.js").StringSchema;
+        readonly title: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+        readonly slideIds: import("../index.js").ArraySchema<import("../index.js").StringSchema>;
+        readonly stack: import("../index.js").OptionalSchema<import("../index.js").BooleanSchema, false>;
+    }>>;
+}>;
+export type DeckOutline = Infer<typeof deckOutline>;
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+/** A catalog component placed inline on a free slide. */
+export declare const componentItem: import("../index.js").ObjectSchema<{
+    readonly step: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+    readonly fragment: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"in" | "fade-up" | "out" | "in-then-out" | "grow" | "shrink" | "highlight" | "strike">, false>;
+    readonly reveal: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"fade-up" | "grow" | "highlight" | "strike" | "fade">, false>;
+    readonly tone: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"accent" | "info" | "success" | "warning" | "danger">, false>;
+    readonly type: import("../index.js").LiteralSchema<"component">;
+    readonly id: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly component: import("../index.js").StringSchema;
+    readonly props: import("../index.js").RefineSchema<import("../index.js").JsonValueSchema>;
+    readonly height: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"sm" | "md" | "lg" | "fill">, false>;
+}>;
+export type SlideComponentItem = Infer<typeof componentItem>;
+type Bag = Record<string, unknown>;
+/** Visit the nested blocks of a block (see `BLOCK_CONTAINERS`). */
+export declare function forEachNested(block: Bag, path: readonly PathSegment[], visit: (child: unknown, path: PathSegment[]) => void): void;
+/**
+ * One free-slide item: a block (any `@texuli/blocks` block, checked here as
+ * bounded JSON with a block head) or a component item. Nested blocks in the
+ * known containers get the same head check.
+ */
+export declare const slideItem: Schema<SlideItem>;
+/** A block on a free slide: a bounded JSON object with a `type`; its body is the host's. */
+export type SlideBlock = JsonObject & {
+    type: string;
+    id?: string;
+    step?: number;
+    fragment?: Infer<typeof stepFields.fragment>;
+    reveal?: Infer<typeof stepFields.reveal>;
+    tone?: (typeof BLOCK_TONES)[number];
+};
+export type SlideItem = SlideBlock | SlideComponentItem;
+declare const slideBase: import("../index.js").ObjectSchema<{
+    readonly id: import("../index.js").StringSchema;
+    readonly title: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly notes: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly hidden: import("../index.js").OptionalSchema<import("../index.js").BooleanSchema, false>;
+    readonly background: import("../index.js").OptionalSchema<import("../index.js").UnionSchema<readonly [import("../index.js").EnumSchema<"solid-color" | "solid-surface" | "solid-primary" | "solid-accent" | "solid-muted" | "solid-inverse" | "gradient-brand" | "gradient-dusk" | "gradient-dawn" | "gradient-forest" | "gradient-mist" | "pattern-dots" | "pattern-grid">, import("../index.js").UnionSchema<readonly [import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"solid">;
+        readonly token: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"accent" | "background" | "surface" | "primary" | "muted" | "inverse">, false>;
+        readonly color: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    }>>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"gradient">;
+        readonly gradient: import("../index.js").EnumSchema<"brand" | "dusk" | "dawn" | "forest" | "mist">;
+        readonly angle: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"pattern">;
+        readonly pattern: import("../index.js").EnumSchema<"dots" | "grid">;
+    }>, import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly tone: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light">, false>;
+        readonly overlay: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+        readonly position: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"center" | "top" | "bottom" | "left" | "right">, false>;
+        readonly kind: import("../index.js").EnumSchema<"image" | "image-full">;
+        readonly src: import("../index.js").StringSchema;
+        readonly alt: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+        readonly fit: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"cover" | "contain">, false>;
+    }>>, import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly tone: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light">, false>;
+        readonly overlay: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+        readonly position: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"center" | "top" | "bottom" | "left" | "right">, false>;
+        readonly kind: import("../index.js").EnumSchema<"video" | "video-full">;
+        readonly src: import("../index.js").StringSchema;
+        readonly poster: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    }>>]>]>, false>;
+    readonly transition: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"fade-up" | "fade" | "none" | "slide" | "zoom" | "morph">, false>;
+    readonly theme: import("../index.js").OptionalSchema<import("../index.js").UnionSchema<readonly [import("../index.js").StringSchema, import("../index.js").UnionSchema<readonly [import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"catalog">;
+        readonly id: import("../index.js").StringSchema;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"embedded">;
+        readonly theme: import("../index.js").RefineSchema<import("../index.js").JsonValueSchema>;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"seed">;
+        readonly seed: import("../index.js").NumberSchema;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>]>]>, false>;
+    readonly steps: import("../index.js").OptionalSchema<import("../index.js").ArraySchema<import("../index.js").StringSchema>, false>;
+}>;
+/** The fields every slide kind shares. */
+export type SlideBase = Infer<typeof slideBase>;
+export declare const freeSlide: import("../index.js").ObjectSchema<{
+    readonly layout: import("../index.js").LiteralSchema<"free">;
+    readonly master: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"title" | "quote" | "section" | "content" | "two-column" | "media-left" | "media-right" | "closing">, false>;
+    readonly blocks: import("../index.js").ArraySchema<Schema<SlideItem>>;
+    readonly id: import("../index.js").StringSchema;
+    readonly title: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly notes: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly hidden: import("../index.js").OptionalSchema<import("../index.js").BooleanSchema, false>;
+    readonly background: import("../index.js").OptionalSchema<import("../index.js").UnionSchema<readonly [import("../index.js").EnumSchema<"solid-color" | "solid-surface" | "solid-primary" | "solid-accent" | "solid-muted" | "solid-inverse" | "gradient-brand" | "gradient-dusk" | "gradient-dawn" | "gradient-forest" | "gradient-mist" | "pattern-dots" | "pattern-grid">, import("../index.js").UnionSchema<readonly [import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"solid">;
+        readonly token: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"accent" | "background" | "surface" | "primary" | "muted" | "inverse">, false>;
+        readonly color: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    }>>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"gradient">;
+        readonly gradient: import("../index.js").EnumSchema<"brand" | "dusk" | "dawn" | "forest" | "mist">;
+        readonly angle: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"pattern">;
+        readonly pattern: import("../index.js").EnumSchema<"dots" | "grid">;
+    }>, import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly tone: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light">, false>;
+        readonly overlay: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+        readonly position: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"center" | "top" | "bottom" | "left" | "right">, false>;
+        readonly kind: import("../index.js").EnumSchema<"image" | "image-full">;
+        readonly src: import("../index.js").StringSchema;
+        readonly alt: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+        readonly fit: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"cover" | "contain">, false>;
+    }>>, import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly tone: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light">, false>;
+        readonly overlay: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+        readonly position: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"center" | "top" | "bottom" | "left" | "right">, false>;
+        readonly kind: import("../index.js").EnumSchema<"video" | "video-full">;
+        readonly src: import("../index.js").StringSchema;
+        readonly poster: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    }>>]>]>, false>;
+    readonly transition: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"fade-up" | "fade" | "none" | "slide" | "zoom" | "morph">, false>;
+    readonly theme: import("../index.js").OptionalSchema<import("../index.js").UnionSchema<readonly [import("../index.js").StringSchema, import("../index.js").UnionSchema<readonly [import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"catalog">;
+        readonly id: import("../index.js").StringSchema;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"embedded">;
+        readonly theme: import("../index.js").RefineSchema<import("../index.js").JsonValueSchema>;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"seed">;
+        readonly seed: import("../index.js").NumberSchema;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>]>]>, false>;
+    readonly steps: import("../index.js").OptionalSchema<import("../index.js").ArraySchema<import("../index.js").StringSchema>, false>;
+}>;
+export type FreeSlide = Omit<Infer<typeof freeSlide>, 'blocks'> & {
+    blocks: SlideItem[];
+};
+export declare const componentSlide: import("../index.js").ObjectSchema<{
+    readonly layout: import("../index.js").LiteralSchema<"component">;
+    readonly component: import("../index.js").ObjectSchema<{
+        readonly component: import("../index.js").StringSchema;
+        readonly props: import("../index.js").RefineSchema<import("../index.js").JsonValueSchema>;
+    }>;
+    readonly id: import("../index.js").StringSchema;
+    readonly title: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly notes: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly hidden: import("../index.js").OptionalSchema<import("../index.js").BooleanSchema, false>;
+    readonly background: import("../index.js").OptionalSchema<import("../index.js").UnionSchema<readonly [import("../index.js").EnumSchema<"solid-color" | "solid-surface" | "solid-primary" | "solid-accent" | "solid-muted" | "solid-inverse" | "gradient-brand" | "gradient-dusk" | "gradient-dawn" | "gradient-forest" | "gradient-mist" | "pattern-dots" | "pattern-grid">, import("../index.js").UnionSchema<readonly [import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"solid">;
+        readonly token: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"accent" | "background" | "surface" | "primary" | "muted" | "inverse">, false>;
+        readonly color: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    }>>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"gradient">;
+        readonly gradient: import("../index.js").EnumSchema<"brand" | "dusk" | "dawn" | "forest" | "mist">;
+        readonly angle: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"pattern">;
+        readonly pattern: import("../index.js").EnumSchema<"dots" | "grid">;
+    }>, import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly tone: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light">, false>;
+        readonly overlay: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+        readonly position: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"center" | "top" | "bottom" | "left" | "right">, false>;
+        readonly kind: import("../index.js").EnumSchema<"image" | "image-full">;
+        readonly src: import("../index.js").StringSchema;
+        readonly alt: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+        readonly fit: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"cover" | "contain">, false>;
+    }>>, import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly tone: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light">, false>;
+        readonly overlay: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+        readonly position: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"center" | "top" | "bottom" | "left" | "right">, false>;
+        readonly kind: import("../index.js").EnumSchema<"video" | "video-full">;
+        readonly src: import("../index.js").StringSchema;
+        readonly poster: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    }>>]>]>, false>;
+    readonly transition: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"fade-up" | "fade" | "none" | "slide" | "zoom" | "morph">, false>;
+    readonly theme: import("../index.js").OptionalSchema<import("../index.js").UnionSchema<readonly [import("../index.js").StringSchema, import("../index.js").UnionSchema<readonly [import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"catalog">;
+        readonly id: import("../index.js").StringSchema;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"embedded">;
+        readonly theme: import("../index.js").RefineSchema<import("../index.js").JsonValueSchema>;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"seed">;
+        readonly seed: import("../index.js").NumberSchema;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>]>]>, false>;
+    readonly steps: import("../index.js").OptionalSchema<import("../index.js").ArraySchema<import("../index.js").StringSchema>, false>;
+}>;
+export type ComponentSlide = Infer<typeof componentSlide>;
+export declare const customSlide: import("../index.js").ObjectSchema<{
+    readonly layout: import("../index.js").LiteralSchema<"custom">;
+    readonly props: import("../index.js").ObjectSchema<{
+        readonly component: import("../index.js").StringSchema;
+        readonly data: import("../index.js").OptionalSchema<import("../index.js").RefineSchema<import("../index.js").JsonValueSchema>, false>;
+    }>;
+    readonly id: import("../index.js").StringSchema;
+    readonly title: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly notes: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    readonly hidden: import("../index.js").OptionalSchema<import("../index.js").BooleanSchema, false>;
+    readonly background: import("../index.js").OptionalSchema<import("../index.js").UnionSchema<readonly [import("../index.js").EnumSchema<"solid-color" | "solid-surface" | "solid-primary" | "solid-accent" | "solid-muted" | "solid-inverse" | "gradient-brand" | "gradient-dusk" | "gradient-dawn" | "gradient-forest" | "gradient-mist" | "pattern-dots" | "pattern-grid">, import("../index.js").UnionSchema<readonly [import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"solid">;
+        readonly token: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"accent" | "background" | "surface" | "primary" | "muted" | "inverse">, false>;
+        readonly color: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    }>>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"gradient">;
+        readonly gradient: import("../index.js").EnumSchema<"brand" | "dusk" | "dawn" | "forest" | "mist">;
+        readonly angle: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"pattern">;
+        readonly pattern: import("../index.js").EnumSchema<"dots" | "grid">;
+    }>, import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly tone: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light">, false>;
+        readonly overlay: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+        readonly position: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"center" | "top" | "bottom" | "left" | "right">, false>;
+        readonly kind: import("../index.js").EnumSchema<"image" | "image-full">;
+        readonly src: import("../index.js").StringSchema;
+        readonly alt: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+        readonly fit: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"cover" | "contain">, false>;
+    }>>, import("../index.js").RefineSchema<import("../index.js").ObjectSchema<{
+        readonly tone: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light">, false>;
+        readonly overlay: import("../index.js").OptionalSchema<import("../index.js").NumberSchema, false>;
+        readonly position: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"center" | "top" | "bottom" | "left" | "right">, false>;
+        readonly kind: import("../index.js").EnumSchema<"video" | "video-full">;
+        readonly src: import("../index.js").StringSchema;
+        readonly poster: import("../index.js").OptionalSchema<import("../index.js").StringSchema, false>;
+    }>>]>]>, false>;
+    readonly transition: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"fade-up" | "fade" | "none" | "slide" | "zoom" | "morph">, false>;
+    readonly theme: import("../index.js").OptionalSchema<import("../index.js").UnionSchema<readonly [import("../index.js").StringSchema, import("../index.js").UnionSchema<readonly [import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"catalog">;
+        readonly id: import("../index.js").StringSchema;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"embedded">;
+        readonly theme: import("../index.js").RefineSchema<import("../index.js").JsonValueSchema>;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>, import("../index.js").ObjectSchema<{
+        readonly kind: import("../index.js").LiteralSchema<"seed">;
+        readonly seed: import("../index.js").NumberSchema;
+        readonly mode: import("../index.js").OptionalSchema<import("../index.js").EnumSchema<"dark" | "light" | "high-contrast" | "system">, false>;
+    }>]>]>, false>;
+    readonly steps: import("../index.js").OptionalSchema<import("../index.js").ArraySchema<import("../index.js").StringSchema>, false>;
+}>;
+export type CustomSlide = Infer<typeof customSlide>;
+/** A catalog layout slide: `layout` names the layout, `props` follow its strict schema. */
+export type LayoutSlide = {
+    [K in DeckCatalogLayoutId]: SlideBase & {
+        layout: K;
+        props: LayoutProps[K];
+    };
+}[DeckCatalogLayoutId];
+export type DeckSlide = LayoutSlide | FreeSlide | ComponentSlide | CustomSlide;
+/** One slide, told apart by `layout` (an unknown one is a single `unknown-layout` issue). */
+export declare const deckSlide: Schema<DeckSlide>;
+/** The deck document (model v2). Cross-field rules run in `parseDeck`. */
+export declare const deckSchema: Schema<Deck>;
+export interface Deck {
+    formatVersion: 2;
+    meta: DeckMeta;
+    style?: Infer<typeof deckStyle>;
+    navigation?: DeckNavigation;
+    outline?: DeckOutline;
+    slides: DeckSlide[];
+}
+/** True when `layout` is a slide kind or a catalog layout id. */
+export declare function isSlideLayout(value: unknown): value is DeckSlideLayout;
+/** True when `value` matches the slide id syntax. */
+export declare function isSlideId(value: unknown): value is string;
+export interface DeckJsonSchemaOptions {
+    $id?: string;
+}
+/**
+ * The JSON Schema 2020-12 document of a v2 deck, generated from the same
+ * schemas `parseDeck` validates with. Each catalog layout's props is a
+ * `$defs` entry named by its id (`#/$defs/title-hero`); cross-field rules are
+ * described in `description`.
+ */
+export declare function deckJsonSchema(options?: DeckJsonSchemaOptions): JsonSchema;
+export {};