@shapesos/clay 0.16.0 → 0.18.0

package/dist/{types-GCkXbyFm.d.ts → types-C8JtnwNY.d.ts}

@@ -16,6 +16,7 @@ import { C as ChartSeries } from './types-B2aYk82c.js';
 declare const artifactTypes: {
     readonly TABLE: "TABLE";
     readonly CHART: "CHART";
+    readonly DECK: "DECK";
 };
 /** Discriminator for artifact types. Additive — new types extend this union. */
 type ArtifactType = (typeof artifactTypes)[keyof typeof artifactTypes];
@@ -255,6 +256,201 @@ interface TableArtifactCallbacks {
     onDownload?: (artifact: TableArtifactRecord) => void;
 }
 
+/**
+ * Block-type discriminator constants for `DeckBlock`. Uppercase to match the GraphQL
+ * `DeckBlockType` enum (which serializes as `TEXT` / `CHART` / `TABLE`) and the existing CHART
+ * `variant` precedent — the discriminator is identical end-to-end (agent → io-server → clay) with
+ * no case mapping at any boundary. Use these instead of string literals so a typo is a
+ * compile-time error rather than a silent wrong-branch at runtime.
+ */
+declare const deckBlockTypes: {
+    readonly TEXT: "TEXT";
+    readonly CHART: "CHART";
+    readonly TABLE: "TABLE";
+};
+/**
+ * Slide-template kind discriminator constants for `DeckSlide`. Uppercase, end-to-end (agent →
+ * io-server → clay), mirroring `deckBlockTypes`. Use these instead of string literals so a typo
+ * is a compile-time error rather than a silent wrong-branch at runtime.
+ */
+declare const deckSlideKinds: {
+    readonly TITLE: "TITLE";
+    readonly AGENDA: "AGENDA";
+    readonly SECTION: "SECTION";
+    readonly CONTENT: "CONTENT";
+    readonly CLOSING: "CLOSING";
+};
+/** Discriminator for the visual template a slide renders with. */
+type DeckSlideKind = (typeof deckSlideKinds)[keyof typeof deckSlideKinds];
+/**
+ * A markdown text block on a slide. Rendered with the same react-markdown pipeline as chat text
+ * blocks (GFM + single-newline breaks), so `**bold**`, lists, and headings render as formatted
+ * output rather than literal syntax.
+ */
+interface DeckTextBlock {
+    /** Discriminator. */
+    type: typeof deckBlockTypes.TEXT;
+    /** Markdown source for the block body. */
+    markdown: string;
+}
+/**
+ * A chart block on a slide. Carries its data inline (`rows`) alongside the same `ChartConfig` the
+ * standalone `CHART` artifact uses — the deck renderer feeds both straight into
+ * `ChartArtifactContent` with no fetch (decks have no presigned data payload).
+ */
+interface DeckChartBlock {
+    /** Discriminator. */
+    type: typeof deckBlockTypes.CHART;
+    /** Chart rendering config — reused verbatim from the `CHART` artifact. */
+    config: ChartConfig;
+    /** Inline data rows the chart plots. Each cell is a raw string (or `null`), matching the CSV wire. */
+    rows: ArtifactDataRow[];
+}
+/**
+ * A table block on a slide. Carries its data inline (`rows`) alongside the same `TableConfig` the
+ * standalone `TABLE` artifact uses — the deck renderer feeds both into `TableArtifactContent`
+ * (wrapping `rows` in a synthetic `"ready"` data state) with no fetch.
+ */
+interface DeckTableBlock {
+    /** Discriminator. */
+    type: typeof deckBlockTypes.TABLE;
+    /** Table rendering config — reused verbatim from the `TABLE` artifact. */
+    config: TableConfig;
+    /** Inline data rows. Each cell is a raw string (or `null`), matching the CSV wire. */
+    rows: ArtifactDataRow[];
+}
+/**
+ * Discriminated union of the content blocks a slide can render. Discriminated by `type`; data is
+ * inline (no presigned-asset fetch). Older clay versions encountering a future block kind render
+ * it as the unavailable-state rather than crashing — see `DeckArtifactContent`.
+ */
+type DeckBlock = DeckTextBlock | DeckChartBlock | DeckTableBlock;
+/**
+ * A single slide inside a `DeckArtifact`. Unlike `TABLE` / `CHART`, a deck carries NO underlying
+ * CSV / protected-asset payload for rendering — its content lives entirely inline in
+ * `config.slides[*].content`, so the renderer reads slides straight from `artifact.config` and
+ * never fetches a presigned URL to draw them. (The presigned URL, when present, points at a
+ * downloadable `.pptx` export — a separate path from rendering.)
+ */
+interface DeckSlide {
+    /** Slide heading, rendered prominently at the top of the slide. Required. */
+    title: string;
+    /** Ordered content blocks (text / chart / table) rendered top-to-bottom. May be empty. */
+    content: DeckBlock[];
+    /**
+     * Visual template kind. Absent / unknown → treated as `"CONTENT"` (backward-compatible).
+     * Use `deckSlideKinds` constants to avoid typos.
+     */
+    kind?: DeckSlideKind;
+    /** Subtitle line shown below the main title. Used on TITLE slides; ignored by other kinds. */
+    subtitle?: string;
+    /** Short description paragraph. Used on TITLE slides below the subtitle. */
+    description?: string;
+    /**
+     * Agenda items (AGENDA kind). Each string is one line item rendered with an ordinal
+     * prefix (`01`, `02`, …) in Crimson Pro italic accent. Ignored by non-AGENDA kinds.
+     */
+    items?: string[];
+}
+/**
+ * Optional stats embedded in `DeckConfig`. Mirrors `TableStats` / `ChartStats` — lets a consumer
+ * render deck chrome (e.g. "Slide 1 / N") before deeply inspecting the slide array.
+ *
+ * Backward-compat: optional everywhere; the renderer derives the count from `slides.length` when
+ * absent.
+ */
+interface DeckStats {
+    /** Total number of slides in the deck. */
+    slideCount: number;
+}
+/**
+ * Optional deck-level metadata embedded in `DeckConfig`. Injected by the client at render time;
+ * clay renders each field if present and ignores it when absent.
+ */
+interface DeckMeta {
+    /** Short eyebrow / running header text shown at top-left of every slide (e.g. org name). */
+    eyebrow?: string;
+    /** Date string shown on the TITLE slide (e.g. "Q2 2026"). No formatting is applied — rendered as-is. */
+    date?: string;
+    /**
+     * Theme identifier. Defaults to `"shapes-light"` when absent.
+     * Currently only `"shapes-light"` is implemented; unknown values fall back to the default.
+     */
+    theme?: string;
+    /**
+     * Account logo URL injected by the client at render time. Clay renders `<img src={logoUrl}>`
+     * (capped height, object-contain) at top-right of every slide when present. Omitted → no logo.
+     *
+     * CROSS-REPO DEVIATION: this field exists ONLY on clay's `DeckMeta`. io-server's `DeckMeta`
+     * (and the GraphQL SDL) deliberately omit `logoUrl` — it is client-injected from the account's
+     * branding and must NOT round-trip through the server. Keep the two `DeckMeta` shapes in sync on
+     * every field EXCEPT this one. The renderer validates it against an http(s) allowlist before use.
+     */
+    logoUrl?: string;
+}
+/** Rendering config for a deck artifact, stored at `artifact.config` (JSONB on the server). */
+interface DeckConfig {
+    /** Ordered slides. At least one; the renderer guards against an empty array. */
+    slides: DeckSlide[];
+    /** Optional metadata describing the deck — used for chrome before slide inspection. */
+    stats?: DeckStats;
+    /** Optional deck-level metadata (eyebrow, date, theme, logo). */
+    meta?: DeckMeta;
+}
+/** Concrete deck artifact record. */
+type DeckArtifactRecord = ArtifactBase<typeof artifactTypes.DECK, DeckConfig>;
+/**
+ * Localized labels for the `DECK` artifact's user-facing strings. Covers navigation controls,
+ * the download action, and status messages. Consumer passes the bag from their i18n layer; clay
+ * falls back to English defaults when omitted (per-key Partial merge).
+ *
+ * `chart` / `table` are nested bags forwarded to embedded chart / table blocks' renderers so
+ * those inherit the consumer's translations (status / empty / loading strings). Both are optional;
+ * the orchestrator defaults them to `DEFAULT_CHART_ARTIFACT_LABELS` / `DEFAULT_TABLE_ARTIFACT_LABELS`.
+ */
+interface DeckArtifactLabels {
+    /** aria-label on the "previous slide" navigation button. */
+    previous: string;
+    /** aria-label on the "next slide" navigation button. */
+    next: string;
+    /**
+     * Slide-position indicator template. `{current}` and `{total}` are substituted at render time
+     * (e.g. "Slide {current} of {total}" → "Slide 2 of 5").
+     */
+    position: string;
+    /** Tooltip + aria-label on the Download (`.pptx`) button in the deck artifact header. */
+    download: string;
+    /** Status message shown when the deck config is malformed or has no slides. */
+    unavailable: string;
+    /** aria-label on the expand / enter-fullscreen button in the artifact header. */
+    enterFullscreen: string;
+    /** aria-label on the collapse / exit-fullscreen button in the fullscreen overlay. */
+    exitFullscreen: string;
+    /** "Thank you" closing message shown on the CLOSING slide. */
+    thankYou: string;
+    /** "Questions?" prompt shown on the CLOSING slide below the thank-you message. */
+    questions: string;
+    /** Fallback title for the AGENDA slide when the slide's `title` is empty. */
+    agenda: string;
+    /** Label bag forwarded to embedded chart blocks. Defaults to `DEFAULT_CHART_ARTIFACT_LABELS`. */
+    chart?: ChartArtifactLabels;
+    /** Label bag forwarded to embedded table blocks. Defaults to `DEFAULT_TABLE_ARTIFACT_LABELS`. */
+    table?: TableArtifactLabels;
+}
+/** English fallback for `DeckArtifactLabels`. Used when the consumer hasn't passed `labels`. */
+declare const DEFAULT_DECK_ARTIFACT_LABELS: DeckArtifactLabels;
+/**
+ * Consumer-supplied side-effect callbacks for actions on the deck artifact. Mirrors
+ * `TableArtifactCallbacks` — every callback is optional and receives the `DeckArtifactRecord` so
+ * consumers can derive analytics context without a per-block closure at every render site.
+ */
+interface DeckArtifactCallbacks {
+    /** Fires when the user navigates to a different slide. `slideIndex` is zero-based. */
+    onNavigate?: (artifact: DeckArtifactRecord, slideIndex: number) => void;
+    /** Fires when the Download (`.pptx`) button is clicked. Browser-native download still happens. */
+    onDownload?: (artifact: DeckArtifactRecord) => void;
+}
+
 /**
  * Artifact-domain types — wire-protocol shapes shared between artifact components, block-services,
  * and consumers. Splits responsibilities across three layers so each artifact kind owns its own
@@ -278,16 +474,16 @@ interface TableArtifactCallbacks {
  * clay versions that don't know about a new type silently render nothing — see `ArtifactRefBlock`
  * guard.
  */
-type ArtifactRecord = TableArtifactRecord | ChartArtifactRecord;
+type ArtifactRecord = TableArtifactRecord | ChartArtifactRecord | DeckArtifactRecord;
 /**
  * Type-level lookup from an `ArtifactRecord` branch to its labels / callbacks slice. The block
  * layer already carries the discriminator on `artifact.type`, so the renderer-side `labels` and
  * `callbacks` props expose exactly one type's slice — never a union-bag keyed by type. Consumers
  * emit a flat object; the dispatcher narrows it implicitly via `TArtifact`.
  */
-type ArtifactLabelsOf<TArtifact extends ArtifactRecord> = TArtifact extends ChartArtifactRecord ? ChartArtifactLabels : TArtifact extends TableArtifactRecord ? TableArtifactLabels : never;
+type ArtifactLabelsOf<TArtifact extends ArtifactRecord> = TArtifact extends ChartArtifactRecord ? ChartArtifactLabels : TArtifact extends TableArtifactRecord ? TableArtifactLabels : TArtifact extends DeckArtifactRecord ? DeckArtifactLabels : never;
 /** Sibling to `ArtifactLabelsOf` — callbacks slice matching the artifact branch. */
-type ArtifactCallbacksOf<TArtifact extends ArtifactRecord> = TArtifact extends ChartArtifactRecord ? ChartArtifactCallbacks : TArtifact extends TableArtifactRecord ? TableArtifactCallbacks : never;
+type ArtifactCallbacksOf<TArtifact extends ArtifactRecord> = TArtifact extends ChartArtifactRecord ? ChartArtifactCallbacks : TArtifact extends TableArtifactRecord ? TableArtifactCallbacks : TArtifact extends DeckArtifactRecord ? DeckArtifactCallbacks : never;
 /**
  * Props every concrete artifact component receives from the dispatcher.
  *
@@ -327,4 +523,4 @@ interface ArtifactService<TArtifact extends ArtifactRecord = ArtifactRecord> {
     toClipboardText: (artifact: TArtifact) => string;
 }
 
-export { type ArtifactCallbacksOf as A, type BarChartConfig as B, type ChartArtifactLabels as C, DEFAULT_CHART_ARTIFACT_LABELS as D, type LineChartConfig as L, type PieChartConfig as P, type TableArtifactLabels as T, type ArtifactDataRow as a, type ArtifactLabelsOf as b, type ArtifactRecord as c, type ArtifactService as d, type ArtifactServiceProps as e, type ArtifactType as f, type ChartArtifactRecord as g, type ChartConfig as h, type ChartStats as i, DEFAULT_TABLE_ARTIFACT_LABELS as j, type TableArtifactRecord as k, type TableColumn as l, type TableConfig as m, type TableRow as n, type TableStats as o, artifactTypes as p };
+export { type ArtifactCallbacksOf as A, type BarChartConfig as B, type ChartArtifactLabels as C, DEFAULT_CHART_ARTIFACT_LABELS as D, type TableRow as E, type TableStats as F, artifactTypes as G, deckBlockTypes as H, deckSlideKinds as I, type LineChartConfig as L, type PieChartConfig as P, type TableArtifactLabels as T, type ArtifactDataRow as a, type ArtifactLabelsOf as b, type ArtifactRecord as c, type ArtifactService as d, type ArtifactServiceProps as e, type ArtifactType as f, type ChartArtifactRecord as g, type ChartConfig as h, type ChartStats as i, DEFAULT_DECK_ARTIFACT_LABELS as j, DEFAULT_TABLE_ARTIFACT_LABELS as k, type DeckArtifactCallbacks as l, type DeckArtifactLabels as m, type DeckArtifactRecord as n, type DeckBlock as o, type DeckChartBlock as p, type DeckConfig as q, type DeckMeta as r, type DeckSlide as s, type DeckSlideKind as t, type DeckStats as u, type DeckTableBlock as v, type DeckTextBlock as w, type TableArtifactRecord as x, type TableColumn as y, type TableConfig as z };

package/dist/{types-BzXPBy6s.d.cts → types-DTdDFU3O.d.cts}

@@ -16,6 +16,7 @@ import { C as ChartSeries } from './types-B2aYk82c.cjs';
 declare const artifactTypes: {
     readonly TABLE: "TABLE";
     readonly CHART: "CHART";
+    readonly DECK: "DECK";
 };
 /** Discriminator for artifact types. Additive — new types extend this union. */
 type ArtifactType = (typeof artifactTypes)[keyof typeof artifactTypes];
@@ -255,6 +256,201 @@ interface TableArtifactCallbacks {
     onDownload?: (artifact: TableArtifactRecord) => void;
 }
 
+/**
+ * Block-type discriminator constants for `DeckBlock`. Uppercase to match the GraphQL
+ * `DeckBlockType` enum (which serializes as `TEXT` / `CHART` / `TABLE`) and the existing CHART
+ * `variant` precedent — the discriminator is identical end-to-end (agent → io-server → clay) with
+ * no case mapping at any boundary. Use these instead of string literals so a typo is a
+ * compile-time error rather than a silent wrong-branch at runtime.
+ */
+declare const deckBlockTypes: {
+    readonly TEXT: "TEXT";
+    readonly CHART: "CHART";
+    readonly TABLE: "TABLE";
+};
+/**
+ * Slide-template kind discriminator constants for `DeckSlide`. Uppercase, end-to-end (agent →
+ * io-server → clay), mirroring `deckBlockTypes`. Use these instead of string literals so a typo
+ * is a compile-time error rather than a silent wrong-branch at runtime.
+ */
+declare const deckSlideKinds: {
+    readonly TITLE: "TITLE";
+    readonly AGENDA: "AGENDA";
+    readonly SECTION: "SECTION";
+    readonly CONTENT: "CONTENT";
+    readonly CLOSING: "CLOSING";
+};
+/** Discriminator for the visual template a slide renders with. */
+type DeckSlideKind = (typeof deckSlideKinds)[keyof typeof deckSlideKinds];
+/**
+ * A markdown text block on a slide. Rendered with the same react-markdown pipeline as chat text
+ * blocks (GFM + single-newline breaks), so `**bold**`, lists, and headings render as formatted
+ * output rather than literal syntax.
+ */
+interface DeckTextBlock {
+    /** Discriminator. */
+    type: typeof deckBlockTypes.TEXT;
+    /** Markdown source for the block body. */
+    markdown: string;
+}
+/**
+ * A chart block on a slide. Carries its data inline (`rows`) alongside the same `ChartConfig` the
+ * standalone `CHART` artifact uses — the deck renderer feeds both straight into
+ * `ChartArtifactContent` with no fetch (decks have no presigned data payload).
+ */
+interface DeckChartBlock {
+    /** Discriminator. */
+    type: typeof deckBlockTypes.CHART;
+    /** Chart rendering config — reused verbatim from the `CHART` artifact. */
+    config: ChartConfig;
+    /** Inline data rows the chart plots. Each cell is a raw string (or `null`), matching the CSV wire. */
+    rows: ArtifactDataRow[];
+}
+/**
+ * A table block on a slide. Carries its data inline (`rows`) alongside the same `TableConfig` the
+ * standalone `TABLE` artifact uses — the deck renderer feeds both into `TableArtifactContent`
+ * (wrapping `rows` in a synthetic `"ready"` data state) with no fetch.
+ */
+interface DeckTableBlock {
+    /** Discriminator. */
+    type: typeof deckBlockTypes.TABLE;
+    /** Table rendering config — reused verbatim from the `TABLE` artifact. */
+    config: TableConfig;
+    /** Inline data rows. Each cell is a raw string (or `null`), matching the CSV wire. */
+    rows: ArtifactDataRow[];
+}
+/**
+ * Discriminated union of the content blocks a slide can render. Discriminated by `type`; data is
+ * inline (no presigned-asset fetch). Older clay versions encountering a future block kind render
+ * it as the unavailable-state rather than crashing — see `DeckArtifactContent`.
+ */
+type DeckBlock = DeckTextBlock | DeckChartBlock | DeckTableBlock;
+/**
+ * A single slide inside a `DeckArtifact`. Unlike `TABLE` / `CHART`, a deck carries NO underlying
+ * CSV / protected-asset payload for rendering — its content lives entirely inline in
+ * `config.slides[*].content`, so the renderer reads slides straight from `artifact.config` and
+ * never fetches a presigned URL to draw them. (The presigned URL, when present, points at a
+ * downloadable `.pptx` export — a separate path from rendering.)
+ */
+interface DeckSlide {
+    /** Slide heading, rendered prominently at the top of the slide. Required. */
+    title: string;
+    /** Ordered content blocks (text / chart / table) rendered top-to-bottom. May be empty. */
+    content: DeckBlock[];
+    /**
+     * Visual template kind. Absent / unknown → treated as `"CONTENT"` (backward-compatible).
+     * Use `deckSlideKinds` constants to avoid typos.
+     */
+    kind?: DeckSlideKind;
+    /** Subtitle line shown below the main title. Used on TITLE slides; ignored by other kinds. */
+    subtitle?: string;
+    /** Short description paragraph. Used on TITLE slides below the subtitle. */
+    description?: string;
+    /**
+     * Agenda items (AGENDA kind). Each string is one line item rendered with an ordinal
+     * prefix (`01`, `02`, …) in Crimson Pro italic accent. Ignored by non-AGENDA kinds.
+     */
+    items?: string[];
+}
+/**
+ * Optional stats embedded in `DeckConfig`. Mirrors `TableStats` / `ChartStats` — lets a consumer
+ * render deck chrome (e.g. "Slide 1 / N") before deeply inspecting the slide array.
+ *
+ * Backward-compat: optional everywhere; the renderer derives the count from `slides.length` when
+ * absent.
+ */
+interface DeckStats {
+    /** Total number of slides in the deck. */
+    slideCount: number;
+}
+/**
+ * Optional deck-level metadata embedded in `DeckConfig`. Injected by the client at render time;
+ * clay renders each field if present and ignores it when absent.
+ */
+interface DeckMeta {
+    /** Short eyebrow / running header text shown at top-left of every slide (e.g. org name). */
+    eyebrow?: string;
+    /** Date string shown on the TITLE slide (e.g. "Q2 2026"). No formatting is applied — rendered as-is. */
+    date?: string;
+    /**
+     * Theme identifier. Defaults to `"shapes-light"` when absent.
+     * Currently only `"shapes-light"` is implemented; unknown values fall back to the default.
+     */
+    theme?: string;
+    /**
+     * Account logo URL injected by the client at render time. Clay renders `<img src={logoUrl}>`
+     * (capped height, object-contain) at top-right of every slide when present. Omitted → no logo.
+     *
+     * CROSS-REPO DEVIATION: this field exists ONLY on clay's `DeckMeta`. io-server's `DeckMeta`
+     * (and the GraphQL SDL) deliberately omit `logoUrl` — it is client-injected from the account's
+     * branding and must NOT round-trip through the server. Keep the two `DeckMeta` shapes in sync on
+     * every field EXCEPT this one. The renderer validates it against an http(s) allowlist before use.
+     */
+    logoUrl?: string;
+}
+/** Rendering config for a deck artifact, stored at `artifact.config` (JSONB on the server). */
+interface DeckConfig {
+    /** Ordered slides. At least one; the renderer guards against an empty array. */
+    slides: DeckSlide[];
+    /** Optional metadata describing the deck — used for chrome before slide inspection. */
+    stats?: DeckStats;
+    /** Optional deck-level metadata (eyebrow, date, theme, logo). */
+    meta?: DeckMeta;
+}
+/** Concrete deck artifact record. */
+type DeckArtifactRecord = ArtifactBase<typeof artifactTypes.DECK, DeckConfig>;
+/**
+ * Localized labels for the `DECK` artifact's user-facing strings. Covers navigation controls,
+ * the download action, and status messages. Consumer passes the bag from their i18n layer; clay
+ * falls back to English defaults when omitted (per-key Partial merge).
+ *
+ * `chart` / `table` are nested bags forwarded to embedded chart / table blocks' renderers so
+ * those inherit the consumer's translations (status / empty / loading strings). Both are optional;
+ * the orchestrator defaults them to `DEFAULT_CHART_ARTIFACT_LABELS` / `DEFAULT_TABLE_ARTIFACT_LABELS`.
+ */
+interface DeckArtifactLabels {
+    /** aria-label on the "previous slide" navigation button. */
+    previous: string;
+    /** aria-label on the "next slide" navigation button. */
+    next: string;
+    /**
+     * Slide-position indicator template. `{current}` and `{total}` are substituted at render time
+     * (e.g. "Slide {current} of {total}" → "Slide 2 of 5").
+     */
+    position: string;
+    /** Tooltip + aria-label on the Download (`.pptx`) button in the deck artifact header. */
+    download: string;
+    /** Status message shown when the deck config is malformed or has no slides. */
+    unavailable: string;
+    /** aria-label on the expand / enter-fullscreen button in the artifact header. */
+    enterFullscreen: string;
+    /** aria-label on the collapse / exit-fullscreen button in the fullscreen overlay. */
+    exitFullscreen: string;
+    /** "Thank you" closing message shown on the CLOSING slide. */
+    thankYou: string;
+    /** "Questions?" prompt shown on the CLOSING slide below the thank-you message. */
+    questions: string;
+    /** Fallback title for the AGENDA slide when the slide's `title` is empty. */
+    agenda: string;
+    /** Label bag forwarded to embedded chart blocks. Defaults to `DEFAULT_CHART_ARTIFACT_LABELS`. */
+    chart?: ChartArtifactLabels;
+    /** Label bag forwarded to embedded table blocks. Defaults to `DEFAULT_TABLE_ARTIFACT_LABELS`. */
+    table?: TableArtifactLabels;
+}
+/** English fallback for `DeckArtifactLabels`. Used when the consumer hasn't passed `labels`. */
+declare const DEFAULT_DECK_ARTIFACT_LABELS: DeckArtifactLabels;
+/**
+ * Consumer-supplied side-effect callbacks for actions on the deck artifact. Mirrors
+ * `TableArtifactCallbacks` — every callback is optional and receives the `DeckArtifactRecord` so
+ * consumers can derive analytics context without a per-block closure at every render site.
+ */
+interface DeckArtifactCallbacks {
+    /** Fires when the user navigates to a different slide. `slideIndex` is zero-based. */
+    onNavigate?: (artifact: DeckArtifactRecord, slideIndex: number) => void;
+    /** Fires when the Download (`.pptx`) button is clicked. Browser-native download still happens. */
+    onDownload?: (artifact: DeckArtifactRecord) => void;
+}
+
 /**
  * Artifact-domain types — wire-protocol shapes shared between artifact components, block-services,
  * and consumers. Splits responsibilities across three layers so each artifact kind owns its own
@@ -278,16 +474,16 @@ interface TableArtifactCallbacks {
  * clay versions that don't know about a new type silently render nothing — see `ArtifactRefBlock`
  * guard.
  */
-type ArtifactRecord = TableArtifactRecord | ChartArtifactRecord;
+type ArtifactRecord = TableArtifactRecord | ChartArtifactRecord | DeckArtifactRecord;
 /**
  * Type-level lookup from an `ArtifactRecord` branch to its labels / callbacks slice. The block
  * layer already carries the discriminator on `artifact.type`, so the renderer-side `labels` and
  * `callbacks` props expose exactly one type's slice — never a union-bag keyed by type. Consumers
  * emit a flat object; the dispatcher narrows it implicitly via `TArtifact`.
  */
-type ArtifactLabelsOf<TArtifact extends ArtifactRecord> = TArtifact extends ChartArtifactRecord ? ChartArtifactLabels : TArtifact extends TableArtifactRecord ? TableArtifactLabels : never;
+type ArtifactLabelsOf<TArtifact extends ArtifactRecord> = TArtifact extends ChartArtifactRecord ? ChartArtifactLabels : TArtifact extends TableArtifactRecord ? TableArtifactLabels : TArtifact extends DeckArtifactRecord ? DeckArtifactLabels : never;
 /** Sibling to `ArtifactLabelsOf` — callbacks slice matching the artifact branch. */
-type ArtifactCallbacksOf<TArtifact extends ArtifactRecord> = TArtifact extends ChartArtifactRecord ? ChartArtifactCallbacks : TArtifact extends TableArtifactRecord ? TableArtifactCallbacks : never;
+type ArtifactCallbacksOf<TArtifact extends ArtifactRecord> = TArtifact extends ChartArtifactRecord ? ChartArtifactCallbacks : TArtifact extends TableArtifactRecord ? TableArtifactCallbacks : TArtifact extends DeckArtifactRecord ? DeckArtifactCallbacks : never;
 /**
  * Props every concrete artifact component receives from the dispatcher.
  *
@@ -327,4 +523,4 @@ interface ArtifactService<TArtifact extends ArtifactRecord = ArtifactRecord> {
     toClipboardText: (artifact: TArtifact) => string;
 }
 
-export { type ArtifactCallbacksOf as A, type BarChartConfig as B, type ChartArtifactLabels as C, DEFAULT_CHART_ARTIFACT_LABELS as D, type LineChartConfig as L, type PieChartConfig as P, type TableArtifactLabels as T, type ArtifactDataRow as a, type ArtifactLabelsOf as b, type ArtifactRecord as c, type ArtifactService as d, type ArtifactServiceProps as e, type ArtifactType as f, type ChartArtifactRecord as g, type ChartConfig as h, type ChartStats as i, DEFAULT_TABLE_ARTIFACT_LABELS as j, type TableArtifactRecord as k, type TableColumn as l, type TableConfig as m, type TableRow as n, type TableStats as o, artifactTypes as p };
+export { type ArtifactCallbacksOf as A, type BarChartConfig as B, type ChartArtifactLabels as C, DEFAULT_CHART_ARTIFACT_LABELS as D, type TableRow as E, type TableStats as F, artifactTypes as G, deckBlockTypes as H, deckSlideKinds as I, type LineChartConfig as L, type PieChartConfig as P, type TableArtifactLabels as T, type ArtifactDataRow as a, type ArtifactLabelsOf as b, type ArtifactRecord as c, type ArtifactService as d, type ArtifactServiceProps as e, type ArtifactType as f, type ChartArtifactRecord as g, type ChartConfig as h, type ChartStats as i, DEFAULT_DECK_ARTIFACT_LABELS as j, DEFAULT_TABLE_ARTIFACT_LABELS as k, type DeckArtifactCallbacks as l, type DeckArtifactLabels as m, type DeckArtifactRecord as n, type DeckBlock as o, type DeckChartBlock as p, type DeckConfig as q, type DeckMeta as r, type DeckSlide as s, type DeckSlideKind as t, type DeckStats as u, type DeckTableBlock as v, type DeckTextBlock as w, type TableArtifactRecord as x, type TableColumn as y, type TableConfig as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapesos/clay",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "devDependencies": {