@classic-homes/slides 0.6.0 → 0.8.0

package/dist/{images-DCwWhenK.d.ts → images-C90NCxYd.d.ts}

@@ -350,6 +350,117 @@ declare function validateBrandProfile(input: unknown): {
     }[];
 };
 
+/**
+ * Chart specs for the `chart` layout. Authors describe data, never styling;
+ * this module turns a spec into an ECharts option themed from the brand, and
+ * renders it to static SVG (server-side rendering, no runtime JS) so charts
+ * work offline, in print, in Workers and in the browser alike.
+ *
+ * This module never imports ECharts: chart-render.ts draws with it (loaded
+ * lazily), and the `/core` entry leaves it out for callers that inject their
+ * own `ChartSvgRenderer`.
+ */
+
+declare const CHART_TYPES: readonly ["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar", "percent-column", "percent-bar", "combo", "waterfall", "heatmap", "dumbbell", "bullet", "treemap", "ring", "sankey", "pictogram"];
+type ChartType = (typeof CHART_TYPES)[number];
+/** Types that only read the first series. */
+declare const SINGLE_SERIES_CHARTS: readonly ChartType[];
+declare const ChartSpec: z.ZodObject<{
+    type: z.ZodEnum<["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar", "percent-column", "percent-bar", "combo", "waterfall", "heatmap", "dumbbell", "bullet", "treemap", "ring", "sankey", "pictogram"]>;
+    labels: z.ZodArray<z.ZodString, "many">;
+    series: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        values: z.ZodArray<z.ZodNumber, "many">;
+        as: z.ZodOptional<z.ZodEnum<["bar", "line"]>>;
+        axis: z.ZodOptional<z.ZodEnum<["primary", "secondary"]>>;
+    }, "strip", z.ZodTypeAny, {
+        values: number[];
+        name: string;
+        as?: "bar" | "line" | undefined;
+        axis?: "primary" | "secondary" | undefined;
+    }, {
+        values: number[];
+        name: string;
+        as?: "bar" | "line" | undefined;
+        axis?: "primary" | "secondary" | undefined;
+    }>, "many">;
+    format: z.ZodDefault<z.ZodEnum<["number", "percent", "currency", "compact"]>>;
+    decimals: z.ZodDefault<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+    legend: z.ZodDefault<z.ZodEnum<["auto", "show", "hide"]>>;
+    labelsOnData: z.ZodDefault<z.ZodBoolean>;
+    highlight: z.ZodOptional<z.ZodString>;
+    max: z.ZodOptional<z.ZodNumber>;
+    secondaryFormat: z.ZodOptional<z.ZodEnum<["number", "percent", "currency", "compact"]>>;
+    totals: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    perIcon: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar" | "percent-column" | "percent-bar" | "combo" | "waterfall" | "heatmap" | "dumbbell" | "bullet" | "treemap" | "ring" | "sankey" | "pictogram";
+    labels: string[];
+    series: {
+        values: number[];
+        name: string;
+        as?: "bar" | "line" | undefined;
+        axis?: "primary" | "secondary" | undefined;
+    }[];
+    format: "number" | "percent" | "currency" | "compact";
+    decimals: number;
+    legend: "auto" | "show" | "hide";
+    labelsOnData: boolean;
+    unit?: string | undefined;
+    highlight?: string | undefined;
+    max?: number | undefined;
+    secondaryFormat?: "number" | "percent" | "currency" | "compact" | undefined;
+    totals?: string[] | undefined;
+    perIcon?: number | undefined;
+}, {
+    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar" | "percent-column" | "percent-bar" | "combo" | "waterfall" | "heatmap" | "dumbbell" | "bullet" | "treemap" | "ring" | "sankey" | "pictogram";
+    labels: string[];
+    series: {
+        values: number[];
+        name: string;
+        as?: "bar" | "line" | undefined;
+        axis?: "primary" | "secondary" | undefined;
+    }[];
+    format?: "number" | "percent" | "currency" | "compact" | undefined;
+    decimals?: number | undefined;
+    unit?: string | undefined;
+    legend?: "auto" | "show" | "hide" | undefined;
+    labelsOnData?: boolean | undefined;
+    highlight?: string | undefined;
+    max?: number | undefined;
+    secondaryFormat?: "number" | "percent" | "currency" | "compact" | undefined;
+    totals?: string[] | undefined;
+    perIcon?: number | undefined;
+}>;
+type ChartSpecInput = z.input<typeof ChartSpec>;
+type ChartSpecValue = z.output<typeof ChartSpec>;
+declare function formatValue(v: number, spec: Pick<ChartSpecValue, 'format' | 'decimals' | 'unit'>): string;
+/** Builds the ECharts option for a spec. Pure; exported for tests and custom renderers. */
+declare function chartOption(spec: ChartSpecValue, palette?: BrandPalette): Record<string, unknown>;
+interface ChartRenderer {
+    render(option: Record<string, unknown>, width: number, height: number): string;
+}
+/** One chart for a `ChartSvgRenderer` to draw. Plain data, so it can cross a process boundary. */
+interface ChartSvgRequest {
+    spec: ChartSpecValue;
+    width: number;
+    height: number;
+    /** Brand palette; omitted for the stock Classic Homes brand. */
+    palette?: BrandPalette;
+    title?: string;
+}
+/**
+ * Draws charts to finished SVG strings (`renderChartSvg` output), one per
+ * request, in request order. `renderDeck` takes one as `renderCharts` so
+ * ECharts can run somewhere else, such as a separate Worker.
+ */
+type ChartSvgRenderer = (charts: ChartSvgRequest[]) => Promise<string[]>;
+/** Labels a raw ECharts SVG for screen readers and makes it responsive. */
+declare function finishChartSvg(svg: string, spec: ChartSpecValue, title?: string): string;
+/** Plain-language summary for screen readers. */
+declare function describeChart(spec: ChartSpecValue): string;
+
 /** The deck-level fields a layout may read while rendering. */
 interface DeckContext {
     title: string;
@@ -571,6 +682,12 @@ interface RenderOptions {
      * stop navigating. Off by default; never use it for shared or exported decks.
      */
     editorMarkers?: boolean;
+    /**
+     * Draws the deck's charts. The main entry defaults to ECharts in process;
+     * the `/core` entry has no default, so a deck with charts needs one there
+     * (for example, a call to a Worker that runs ECharts).
+     */
+    renderCharts?: ChartSvgRenderer;
 }
 /** A field the editor runtime can match a clicked element to. */
 interface FieldMarker {
@@ -598,6 +715,35 @@ interface RenderResult {
 /** Collects every image src in the deck (any object with a string `src`). */
 declare function collectImageSources(value: unknown, out?: Set<string>): Set<string>;
 declare function renderDeck(input: unknown, options?: RenderOptions): Promise<RenderResult>;
+interface SpeakerNotesOptions {
+    /** Brand profiles available to `deck.brand.profile` (needed to validate decks that name one). */
+    brands?: BrandProfile[];
+    /** List slides marked `hidden` too. Default false, matching a presentation. */
+    includeHidden?: boolean;
+}
+/** One presented slide's speaker notes. */
+interface SpeakerNote {
+    /** 1-based slide number as presented (a walkthrough counts once per stage). */
+    number: number;
+    /** 0-based index of the deck slide it came from. */
+    deckIndex: number;
+    slideId?: string;
+    /** Stage of a slide that expands into several (a walkthrough), else absent. */
+    part?: {
+        index: number;
+        count: number;
+    };
+    /** Timing cue. */
+    time?: string;
+    /** Notes as HTML (paragraphs, bullets, inline marks), escaped; '' when there are none. */
+    html: string;
+}
+/**
+ * Every presented slide's speaker notes, numbered as `renderDeck` numbers
+ * them, for a printed notes handout. Walks the slides the way `renderDeck`
+ * does but skips images, QR codes and charts, so nothing is fetched or drawn.
+ */
+declare function speakerNotes(input: unknown, options?: SpeakerNotesOptions): SpeakerNote[];
 /** Pulls the embedded deck source back out of a rendered HTML file. */
 declare function extractDeckSource(html: string): unknown | undefined;
 
@@ -638,4 +784,4 @@ declare function inlineDeckImages(input: unknown, resolve: ImageResolver, option
  */
 declare function externalizeDeckImages(input: unknown, upload: (dataUri: string) => string | Promise<string>, options?: MapImagesOptions): Promise<unknown>;
 
-export { type ValidationResult as A, type BrandPalette as B, CLASSIC_HOMES_BRAND as C, type Deck as D, checkPalette as E, type FieldMarker as F, collectImageSources as G, externalizeDeckImages as H, type ImageInput as I, extractDeckSource as J, fieldMarkers as K, type LayoutCategory as L, type MapImagesOptions as M, formatIssues as N, formatPath as O, PREVIEW_SIZE as P, getLayout as Q, type RenderOptions as R, type SlideData as S, inlineDeckImages as T, mapDeckImages as U, type ValidateOptions as V, renderDeck as W, resolveBrand as X, validateBrandProfile as Y, validateDeck as Z, BrandPaletteSchema as a, type BrandProfile as b, type BrandProfileInput as c, BrandProfileSchema as d, CLASSIC_HOMES_PALETTE as e, type DeckBrand as f, DeckBrandSchema as g, DeckError as h, type DeckInput as i, DeckSchema as j, type DeckSettings as k, DeckSettingsSchema as l, type ImageResolver as m, type ImageValue as n, type InlineImagesResult as o, type ItemValue as p, LAYOUTS as q, LAYOUT_CATEGORIES as r, LAYOUT_CATEGORY_ORDER as s, type LayoutDef as t, type LayoutIssue as u, type LayoutName as v, type RenderResult as w, type ResolvedBrand as x, type SlideInput as y, SlideSchema as z };
+export { externalizeDeckImages as $, type LayoutCategory as A, type BrandPalette as B, type ChartSpecValue as C, type Deck as D, type LayoutDef as E, type FieldMarker as F, type LayoutIssue as G, type LayoutName as H, type ImageInput as I, type RenderResult as J, type ResolvedBrand as K, LAYOUTS as L, type MapImagesOptions as M, type SlideData as N, type SlideInput as O, PREVIEW_SIZE as P, SlideSchema as Q, type RenderOptions as R, SINGLE_SERIES_CHARTS as S, type SpeakerNote as T, type SpeakerNotesOptions as U, type ValidateOptions as V, type ValidationResult as W, chartOption as X, checkPalette as Y, collectImageSources as Z, describeChart as _, type ChartSvgRenderer as a, extractDeckSource as a0, fieldMarkers as a1, finishChartSvg as a2, formatIssues as a3, formatPath as a4, formatValue as a5, getLayout as a6, inlineDeckImages as a7, mapDeckImages as a8, resolveBrand as a9, speakerNotes as aa, validateBrandProfile as ab, validateDeck as ac, renderDeck as ad, BrandPaletteSchema as b, type BrandProfile as c, type BrandProfileInput as d, BrandProfileSchema as e, CHART_TYPES as f, CLASSIC_HOMES_BRAND as g, CLASSIC_HOMES_PALETTE as h, type ChartRenderer as i, ChartSpec as j, type ChartSpecInput as k, type ChartSvgRequest as l, type ChartType as m, type DeckBrand as n, DeckBrandSchema as o, DeckError as p, type DeckInput as q, DeckSchema as r, type DeckSettings as s, DeckSettingsSchema as t, type ImageResolver as u, type ImageValue as v, type InlineImagesResult as w, type ItemValue as x, LAYOUT_CATEGORIES as y, LAYOUT_CATEGORY_ORDER as z };

package/dist/index.d.ts

@@ -1,301 +1,17 @@
-import { L as LayoutCategory, B as BrandPalette } from './images-DCwWhenK.js';
-export { a as BrandPaletteSchema, b as BrandProfile, c as BrandProfileInput, d as BrandProfileSchema, C as CLASSIC_HOMES_BRAND, e as CLASSIC_HOMES_PALETTE, D as Deck, f as DeckBrand, g as DeckBrandSchema, h as DeckError, i as DeckInput, j as DeckSchema, k as DeckSettings, l as DeckSettingsSchema, F as FieldMarker, I as ImageInput, m as ImageResolver, n as ImageValue, o as InlineImagesResult, p as ItemValue, q as LAYOUTS, r as LAYOUT_CATEGORIES, s as LAYOUT_CATEGORY_ORDER, t as LayoutDef, u as LayoutIssue, v as LayoutName, M as MapImagesOptions, P as PREVIEW_SIZE, R as RenderOptions, w as RenderResult, x as ResolvedBrand, S as SlideData, y as SlideInput, z as SlideSchema, V as ValidateOptions, A as ValidationResult, E as checkPalette, G as collectImageSources, H as externalizeDeckImages, J as extractDeckSource, K as fieldMarkers, N as formatIssues, O as formatPath, Q as getLayout, T as inlineDeckImages, U as mapDeckImages, W as renderDeck, X as resolveBrand, Y as validateBrandProfile, Z as validateDeck } from './images-DCwWhenK.js';
-import * as zod_to_json_schema from 'zod-to-json-schema';
-import { z } from 'zod';
+import { C as ChartSpecValue, B as BrandPalette, a as ChartSvgRenderer } from './images-C90NCxYd.js';
+export { b as BrandPaletteSchema, c as BrandProfile, d as BrandProfileInput, e as BrandProfileSchema, f as CHART_TYPES, g as CLASSIC_HOMES_BRAND, h as CLASSIC_HOMES_PALETTE, i as ChartRenderer, j as ChartSpec, k as ChartSpecInput, l as ChartSvgRequest, m as ChartType, D as Deck, n as DeckBrand, o as DeckBrandSchema, p as DeckError, q as DeckInput, r as DeckSchema, s as DeckSettings, t as DeckSettingsSchema, F as FieldMarker, I as ImageInput, u as ImageResolver, v as ImageValue, w as InlineImagesResult, x as ItemValue, L as LAYOUTS, y as LAYOUT_CATEGORIES, z as LAYOUT_CATEGORY_ORDER, A as LayoutCategory, E as LayoutDef, G as LayoutIssue, H as LayoutName, M as MapImagesOptions, P as PREVIEW_SIZE, R as RenderOptions, J as RenderResult, K as ResolvedBrand, S as SINGLE_SERIES_CHARTS, N as SlideData, O as SlideInput, Q as SlideSchema, T as SpeakerNote, U as SpeakerNotesOptions, V as ValidateOptions, W as ValidationResult, X as chartOption, Y as checkPalette, Z as collectImageSources, _ as describeChart, $ as externalizeDeckImages, a0 as extractDeckSource, a1 as fieldMarkers, a2 as finishChartSvg, a3 as formatIssues, a4 as formatPath, a5 as formatValue, a6 as getLayout, a7 as inlineDeckImages, a8 as mapDeckImages, a9 as resolveBrand, aa as speakerNotes, ab as validateBrandProfile, ac as validateDeck } from './images-C90NCxYd.js';
+export { AUTHORING_GUIDE, EditableDeck, EditorField, LOGO_SVG, LayoutEditorInfo, PALETTE, PLACEHOLDER_IMAGE, RUNTIME_SCRIPT_HASH, SlideRef, VideoRef, addSlide, allLayoutEditorInfo, blankSlide, commonSlideFields, deckEditorFields, deckJsonSchema, describeLayout, ensureSlideIds, escapeHtml, findSlide, inline, isPlaceholderImage, layoutEditorInfo, layoutGalleryDeck, listLayouts, logoLockup, moveSlide, newSlideId, outline, parseDeckSource, parseVideoUrl, prose, removeSlide, slideKey, stringifyDeck, updateSlide, videoEmbedUrl } from './core.js';
+export { r as renderDeck } from './render-default-B-QkReoS.js';
+import 'zod';
+import 'zod-to-json-schema';
 
-interface LayoutSummary {
-    name: string;
-    category: LayoutCategory;
-    description: string;
-    whenToUse: string;
-}
-declare function listLayouts(): LayoutSummary[];
-/** Full description of one layout: fields as JSON Schema plus a working example. */
-declare function describeLayout(name: string): {
-    name: string;
-    description: string;
-    whenToUse: string;
-    defaults: {
-        background?: string;
-        track?: "value" | "build" | "neutral";
-    };
-    schema: zod_to_json_schema.JsonSchema7Type & {
-        $schema?: string | undefined;
-        definitions?: {
-            [key: string]: zod_to_json_schema.JsonSchema7Type;
-        } | undefined;
-    };
-    example: Record<string, unknown>;
-} | undefined;
-/** JSON Schema for a whole deck (editor tooling, `$schema` in deck files). */
-declare function deckJsonSchema(): zod_to_json_schema.JsonSchema7Type & {
-    $schema?: string | undefined;
-    definitions?: {
-        [key: string]: zod_to_json_schema.JsonSchema7Type;
-    } | undefined;
-};
-/** Authoring guidance shared by the CLI, MCP server and docs. */
-declare const AUTHORING_GUIDE = "# Writing a Classic Homes deck\n\nA deck is a YAML (or JSON) file: deck-level fields plus a list of slides. Each slide\npicks a **layout** and fills its fields. Layouts own all styling \u2014 there is no way to\nset colours, fonts or sizes directly, which is what keeps every deck on-brand.\n\n## Principles\n- **One idea per slide.** The headline states the point. Detail goes in `notes`.\n- **Short copy.** Titles under ~70 characters, bullets a few words, at most 6 bullets.\n  `validate` warns when a slide gets crowded \u2014 split it rather than shrinking text.\n- **Speaker notes on every content slide.** Presenters press N (or P for presenter view).\n- **Real photos over decoration.** Every image needs `alt` text.\n- **Tracks** colour the accent: `value` (red, default) for the homeowner/value story,\n  `build` (teal) for construction/process, `neutral` (navy) for framing slides.\n- **Backgrounds**: `paper` (default) for content; solid `navy`/`red`/`teal`/`plum`/`grey`/`stone`\n  for dividers. `backgroundImage` + `overlay` puts a photo behind title/section/statement slides.\n\n## Picking a layout\n- **Numbers:** `stats` (2\u20136 headline figures, optional trend + sparkline), `chart` (a real chart \u2014\n  put the takeaway in the title), `table` (exact figures people compare).\n- **Processes & structure:** `flow` (ordered steps with arrows), `timeline` (dated milestones, phases),\n  `cycle` (things that repeat), `hierarchy` (org chart / tree), `matrix` (2\u00D72), `tiers`\n  (funnel or pyramid), `walkthrough` (photo per stage), `journey` (deck agenda).\n- **Media:** `split` (text + photos), `photos`, `image` (with numbered `hotspots` for floor plans\n  and site maps), `compare` (before/after slider), `video` (YouTube/Vimeo), `embed` (any https page:\n  maps, dashboards, 3D tours, forms).\n- **Words:** `statement`, `bullets`, `cards`, `comparison`, `quote`.\n- **Wrap-up:** `qr` (send people somewhere), `contacts`, closing `statement`.\n\n## Charts\n`chart.labels` are the categories; each series has one value per label. Use `highlight` to\nemphasise one category and `format`/`unit` instead of typing symbols into numbers.\n- **Compare:** `column`/`bar`; `dumbbell` (2+ series as dots per row, e.g. last year vs this\n  year); `bullet` (series 1 actual, series 2 target; `max` sets the track).\n- **Part of whole:** `stacked-*` (absolute), `percent-column`/`percent-bar` (each row = 100%),\n  `pie`/`donut` (\u2264 7 slices), `treemap` (many categories).\n- **Change:** `line`/`area`; `combo` (series 1 bars, the rest lines; set a series' `as` to\n  override and `axis: secondary` + `secondaryFormat` for a second scale, e.g. closings and average\n  price); `waterfall` (series 1 is signed changes; list running-total rows in `totals`).\n- **Single value:** `gauge` (one value, needs `max`); `ring` (up to 4 progress rings, one per label;\n  `max`, or `format: percent` for 100); `pictogram` (house icons per row; `perIcon` sets the step).\n- **Grid & flow:** `heatmap` (labels are rows, series names are columns); `sankey` (labels are\n  sources, series names are destinations, each cell a flow; a destination that is also a label chains\n  stages; no loops).\n- **Other:** `funnel` (drop-off, first series), `scatter` (two series as x and y), `radar`.\nPie, donut, funnel, gauge, ring, treemap, waterfall and pictogram read the first series only.\n\n## Video & embeds\nThey need internet while presenting. Offline, in print and in PDF they show a poster (or\n`fallback` screenshot) with a QR code. Some sites refuse to be framed \u2014 the \"Open \u2197\" link\nalways works; add a `fallback` image for anything critical.\n\n## Brand\n`brand.profile` picks who the deck speaks for (default `classic-homes`). You may override\n`name`, `tagline`, `logo`, `logoOnDark`, `favicon` and `footer`; colours come from the profile.\n`settings` controls slide numbers, logo placement, a confidential label and kiosk auto-advance.\n\n## Presenting\nArrow keys / Space advance (and step through `build: true` reveals). N notes \u00B7 P presenter window\n(current + next slide, notes, timer) \u00B7 O overview \u00B7 F fullscreen \u00B7 `?kiosk=15` on the URL loops\nunattended. `hidden: true` skips a slide without deleting it.\n\n## Inline text\n`**bold**`, `*highlight*` (accent colour), `\\`code\\``, `[label](https://\u2026)`. No HTML.\n\n## Journey decks\nSet `journey.steps` at deck level to get a numbered agenda. Then:\n- a `journey` slide shows the full map,\n- `step: 3` on any slide draws the vertical STEP rail,\n- `showJourney: true` adds the compact \"you are here\" strip (great on `section` slides).\n\n## Typical shape\n1. `title`\n2. `statement` or `journey` (why we're here / the agenda)\n3. per part: `section` \u2192 2\u20135 content slides\n4. `qr` (where to go next) \u2192 `contacts` \u2192 closing `statement`\n";
-
-/** Parses deck source text. YAML is a superset of JSON, so both work. */
-declare function parseDeckSource(text: string): unknown;
-/** Serializes a deck back to YAML, the human-editable format. */
-declare function stringifyDeck(deck: unknown): string;
-
-/**
- * Inline text formatting for slide copy and speaker notes.
- *
- * Deck text is never raw HTML: authors and agents write a tiny markdown subset
- * and everything else is escaped. That keeps decks on-brand (no inline styles)
- * and makes rendered output safe to publish.
- *
- *   **bold**        → <b>          (strong ink colour)
- *   *highlight*     → <em class="hl"> (track accent colour)
- *   `code`          → <code>
- *   [label](url)    → <a>          (http/https/mailto/tel only)
- *   single newline  → <br>
- */
-declare function escapeHtml(value: string): string;
-/** Formats one run of inline text. Newlines become line breaks. */
-declare function inline(text: string | undefined | null): string;
-/**
- * Formats a block of prose (speaker notes, long captions): blank lines split
- * paragraphs, lines starting with "- " become a bullet list.
- */
-declare function prose(text: string | undefined | null): string;
-
-/**
- * Slide palette. Mostly brand tokens used as-is; the few surface tints
- * (paper, soft accents) are deck-specific and derived here.
- */
-declare const PALETTE: {
-    readonly red: "#a91c22";
-    readonly redLogo: "#e02726";
-    readonly teal: "#236265";
-    readonly tealFill: "#236265";
-    readonly navy: "#002e3f";
-    readonly plum: "#5e2c41";
-    readonly sage: "#969a82";
-    readonly stone: "#676d69";
-    readonly grey: "#4f4f4f";
-    readonly ink: "#002e3f";
-    readonly inkSoft: "#4f4f4f";
-    readonly inkFaint: "#7a7a7a";
-};
-/** Horizontal Classic Homes lockup (mark + wordmark), mirrors LogoMain in theme-svelte. Colours follow CSS. */
-declare const LOGO_SVG: string;
-/**
- * Logo lockup from a name. Classic Homes brands (divisions, studios) keep the
- * flower mark; partner brands without a logo file get a clean wordmark so
- * they are never shown under the Classic Homes mark.
- */
-declare function logoLockup(name: string, withMark?: boolean): string;
-
-/**
- * Slide-level edits on a deck object. Pure functions shared by the MCP
- * server and (later) the hosted editor, so agents change one slide at a
- * time instead of rewriting whole files.
- */
-interface EditableDeck {
-    slides: Record<string, unknown>[];
-    [key: string]: unknown;
-}
-/** A slide reference: its `id`, or its 1-based position. */
-type SlideRef = string | number;
-declare function findSlide(deck: EditableDeck, ref: SlideRef): number;
-/** A short random slide id such as "s-k3f9x2" (valid for the slide `id` field). */
-declare function newSlideId(taken?: ReadonlySet<string>): string;
 /**
- * Gives every slide without an `id` a stable random one, so comments and
- * analytics can anchor to slides across edits and reorders. Idempotent;
- * returns how many ids were added.
+ * The built-in chart renderer: ECharts server-side SVG, in process. ECharts
+ * is imported lazily (echarts-render.ts) so decks without charts never load
+ * it. Only the main entry reaches this module; `/core` callers inject their
+ * own `ChartSvgRenderer`.
  */
-declare function ensureSlideIds(deck: EditableDeck): number;
-/** Stable key for a slide: its id, or "#<position>" for decks saved before ids existed. */
-declare function slideKey(slide: {
-    id?: unknown;
-}, index: number): string;
-/** Inserts a slide. `position` is 1-based; omitted appends. Returns the new slide's position. */
-declare function addSlide(deck: EditableDeck, slide: Record<string, unknown>, position?: number): number;
-/** Shallow-merges fields into a slide. A field set to null is removed. Changing `layout` replaces the slide. */
-declare function updateSlide(deck: EditableDeck, ref: SlideRef, patch: Record<string, unknown>): number;
-declare function moveSlide(deck: EditableDeck, ref: SlideRef, to: number): number;
-declare function removeSlide(deck: EditableDeck, ref: SlideRef): Record<string, unknown>;
-/** One-line outline of each slide, for agents and CLIs. */
-declare function outline(deck: EditableDeck): string[];
 
-type EditorField = FieldBase<'inline'> | FieldBase<'string'> | (FieldBase<'enum'> & {
-    options: (string | number)[];
-}) | FieldBase<'boolean'> | (FieldBase<'number'> & {
-    min?: number;
-    max?: number;
-    integer: boolean;
-}) | FieldBase<'image'> | FieldBase<'item'> | (FieldBase<'list'> & {
-    of: EditorField;
-    min?: number;
-    max?: number;
-}) | (FieldBase<'group'> & {
-    fields: EditorField[];
-});
-interface FieldBase<K extends string> {
-    kind: K;
-    /** Property name ('' for list elements). */
-    key: string;
-    label: string;
-    description?: string;
-    required: boolean;
-    default?: unknown;
-    /** Suggest a textarea rather than a one-line input. */
-    multiline?: boolean;
-    /**
-     * Suggests a richer widget; editors that don't know a hint can fall back to `kind`.
-     * - url: https link · video-url: YouTube/Vimeo link
-     * - chart: ChartSpec group (edit labels × series as a grid)
-     * - grid: list of rows of cells (table layout)
-     * - point: {x, y} in % of an image (hotspot picker)
-     */
-    hint?: 'url' | 'video-url' | 'chart' | 'grid' | 'point';
-    /** Rarely changed; editors should tuck it behind an "Advanced" section. */
-    advanced?: boolean;
-}
-/** Deck-level fields for a settings panel: brand overrides and presentation settings. */
-declare function deckEditorFields(): {
-    brand: EditorField[];
-    settings: EditorField[];
-};
-interface LayoutEditorInfo {
-    name: string;
-    category: LayoutCategory;
-    description: string;
-    whenToUse: string;
-    defaults: {
-        background?: string;
-        track?: string;
-    };
-    /** Layout-specific fields, in declaration order. */
-    fields: EditorField[];
-    /** A valid starting slide for this layout. */
-    example: Record<string, unknown>;
-}
-/** Fields shared by every slide (track, background, notes, step…). */
-declare function commonSlideFields(): EditorField[];
-declare function layoutEditorInfo(name: string): LayoutEditorInfo | undefined;
-declare function allLayoutEditorInfo(): LayoutEditorInfo[];
-/**
- * One deck holding every layout's starting slide, in palette order, for
- * rendering layout thumbnails once (render it, then show slide N of the
- * result per layout). `slideFor[layout]` is that layout's slide index.
- */
-declare function layoutGalleryDeck(): {
-    deck: {
-        title: string;
-        journey: {
-            steps: string[];
-        };
-        slides: Record<string, unknown>[];
-    };
-    slideFor: Record<string, number>;
-};
-/**
- * Stand-in image for new slides: a neutral frame reading "Add a photo".
- * It validates (so a fresh slide previews immediately) but lint warns until
- * it is replaced.
- */
-declare const PLACEHOLDER_IMAGE: string;
-declare function isPlaceholderImage(src: string | undefined): boolean;
-/**
- * A new slide for a layout, ready to edit: the layout's example with sample
- * image paths swapped for {@link PLACEHOLDER_IMAGE}. Always passes validation.
- */
-declare function blankSlide(name: string): Record<string, unknown> | undefined;
-
-/**
- * Chart specs for the `chart` layout. Authors describe data, never styling;
- * this module turns a spec into an ECharts option themed from the brand, and
- * renders it to static SVG (server-side rendering, no runtime JS) so charts
- * work offline, in print, in Workers and in the browser alike.
- *
- * ECharts is imported lazily (echarts-render.ts) so decks without charts
- * never load it.
- */
-
-declare const CHART_TYPES: readonly ["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar", "percent-column", "percent-bar", "combo", "waterfall", "heatmap", "dumbbell", "bullet", "treemap", "ring", "sankey", "pictogram"];
-type ChartType = (typeof CHART_TYPES)[number];
-/** Types that only read the first series. */
-declare const SINGLE_SERIES_CHARTS: readonly ChartType[];
-declare const ChartSpec: z.ZodObject<{
-    type: z.ZodEnum<["column", "bar", "stacked-column", "stacked-bar", "line", "area", "pie", "donut", "funnel", "gauge", "scatter", "radar", "percent-column", "percent-bar", "combo", "waterfall", "heatmap", "dumbbell", "bullet", "treemap", "ring", "sankey", "pictogram"]>;
-    labels: z.ZodArray<z.ZodString, "many">;
-    series: z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        values: z.ZodArray<z.ZodNumber, "many">;
-        as: z.ZodOptional<z.ZodEnum<["bar", "line"]>>;
-        axis: z.ZodOptional<z.ZodEnum<["primary", "secondary"]>>;
-    }, "strip", z.ZodTypeAny, {
-        values: number[];
-        name: string;
-        as?: "bar" | "line" | undefined;
-        axis?: "primary" | "secondary" | undefined;
-    }, {
-        values: number[];
-        name: string;
-        as?: "bar" | "line" | undefined;
-        axis?: "primary" | "secondary" | undefined;
-    }>, "many">;
-    format: z.ZodDefault<z.ZodEnum<["number", "percent", "currency", "compact"]>>;
-    decimals: z.ZodDefault<z.ZodNumber>;
-    unit: z.ZodOptional<z.ZodString>;
-    legend: z.ZodDefault<z.ZodEnum<["auto", "show", "hide"]>>;
-    labelsOnData: z.ZodDefault<z.ZodBoolean>;
-    highlight: z.ZodOptional<z.ZodString>;
-    max: z.ZodOptional<z.ZodNumber>;
-    secondaryFormat: z.ZodOptional<z.ZodEnum<["number", "percent", "currency", "compact"]>>;
-    totals: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    perIcon: z.ZodOptional<z.ZodNumber>;
-}, "strict", z.ZodTypeAny, {
-    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar" | "percent-column" | "percent-bar" | "combo" | "waterfall" | "heatmap" | "dumbbell" | "bullet" | "treemap" | "ring" | "sankey" | "pictogram";
-    labels: string[];
-    series: {
-        values: number[];
-        name: string;
-        as?: "bar" | "line" | undefined;
-        axis?: "primary" | "secondary" | undefined;
-    }[];
-    format: "number" | "percent" | "currency" | "compact";
-    decimals: number;
-    legend: "auto" | "show" | "hide";
-    labelsOnData: boolean;
-    unit?: string | undefined;
-    highlight?: string | undefined;
-    max?: number | undefined;
-    secondaryFormat?: "number" | "percent" | "currency" | "compact" | undefined;
-    totals?: string[] | undefined;
-    perIcon?: number | undefined;
-}, {
-    type: "column" | "bar" | "stacked-column" | "stacked-bar" | "line" | "area" | "pie" | "donut" | "funnel" | "gauge" | "scatter" | "radar" | "percent-column" | "percent-bar" | "combo" | "waterfall" | "heatmap" | "dumbbell" | "bullet" | "treemap" | "ring" | "sankey" | "pictogram";
-    labels: string[];
-    series: {
-        values: number[];
-        name: string;
-        as?: "bar" | "line" | undefined;
-        axis?: "primary" | "secondary" | undefined;
-    }[];
-    format?: "number" | "percent" | "currency" | "compact" | undefined;
-    decimals?: number | undefined;
-    unit?: string | undefined;
-    legend?: "auto" | "show" | "hide" | undefined;
-    labelsOnData?: boolean | undefined;
-    highlight?: string | undefined;
-    max?: number | undefined;
-    secondaryFormat?: "number" | "percent" | "currency" | "compact" | undefined;
-    totals?: string[] | undefined;
-    perIcon?: number | undefined;
-}>;
-type ChartSpecInput = z.input<typeof ChartSpec>;
-type ChartSpecValue = z.output<typeof ChartSpec>;
-declare function formatValue(v: number, spec: Pick<ChartSpecValue, 'format' | 'decimals' | 'unit'>): string;
-/** Builds the ECharts option for a spec. Pure; exported for tests and custom renderers. */
-declare function chartOption(spec: ChartSpecValue, palette?: BrandPalette): Record<string, unknown>;
 /** Renders one chart spec to an accessible, responsive SVG string. */
 declare function renderChartSvg(spec: ChartSpecValue, opts?: {
     width?: number;
@@ -303,30 +19,7 @@ declare function renderChartSvg(spec: ChartSpecValue, opts?: {
     palette?: BrandPalette;
     title?: string;
 }): Promise<string>;
-/** Plain-language summary for screen readers. */
-declare function describeChart(spec: ChartSpecValue): string;
-
-/** YouTube / Vimeo URL parsing for the video layout. */
-interface VideoRef {
-    provider: 'youtube' | 'vimeo';
-    id: string;
-    /** Canonical watch URL (used for QR codes and "open" links). */
-    watchUrl: string;
-    /** Poster image URL, when the provider exposes a predictable one. */
-    poster?: string;
-}
-declare function parseVideoUrl(url: string): VideoRef | undefined;
-interface EmbedOptions {
-    start?: number;
-    end?: number;
-    muted?: boolean;
-    captions?: boolean;
-    autoplay?: boolean;
-}
-/** Privacy-friendly player URL (youtube-nocookie, Vimeo with dnt). */
-declare function videoEmbedUrl(ref: VideoRef, o: EmbedOptions): string;
-
-/** CSP source for the inline presenter runtime: script-src '<hash>'. */
-declare const RUNTIME_SCRIPT_HASH = "sha256-gElvQAb4VPvKu4UeyJRVKuoHYNp8NGhXwx2EhL7NB88=";
+/** `ChartSvgRenderer` over `renderChartSvg`: the default for `renderDeck`. */
+declare const renderChartSvgs: ChartSvgRenderer;
 
-export { AUTHORING_GUIDE, BrandPalette, CHART_TYPES, ChartSpec, type ChartSpecInput, type ChartSpecValue, type ChartType, type EditableDeck, type EditorField, LOGO_SVG, LayoutCategory, type LayoutEditorInfo, PALETTE, PLACEHOLDER_IMAGE, RUNTIME_SCRIPT_HASH, SINGLE_SERIES_CHARTS, type SlideRef, type VideoRef, addSlide, allLayoutEditorInfo, blankSlide, chartOption, commonSlideFields, deckEditorFields, deckJsonSchema, describeChart, describeLayout, ensureSlideIds, escapeHtml, findSlide, formatValue, inline, isPlaceholderImage, layoutEditorInfo, layoutGalleryDeck, listLayouts, logoLockup, moveSlide, newSlideId, outline, parseDeckSource, parseVideoUrl, prose, removeSlide, renderChartSvg, slideKey, stringifyDeck, updateSlide, videoEmbedUrl };
+export { BrandPalette, ChartSpecValue, ChartSvgRenderer, renderChartSvg, renderChartSvgs };

package/dist/index.js

@@ -1,9 +1,17 @@
+import {
+  RUNTIME_SCRIPT_HASH
+} from "./chunk-4NSKDQ5V.js";
 import {
   AUTHORING_GUIDE,
   deckJsonSchema,
   describeLayout,
   listLayouts
-} from "./chunk-7NSNE5ED.js";
+} from "./chunk-QOKQWHHD.js";
+import {
+  renderChartSvg,
+  renderChartSvgs,
+  renderDeck
+} from "./chunk-6ARF37DO.js";
 import {
   BrandPaletteSchema,
   BrandProfileSchema,
@@ -39,6 +47,7 @@ import {
   extractDeckSource,
   fieldMarkers,
   findSlide,
+  finishChartSvg,
   formatIssues,
   formatPath,
   formatValue,
@@ -57,19 +66,15 @@ import {
   parseVideoUrl,
   prose,
   removeSlide,
-  renderChartSvg,
-  renderDeck,
   resolveBrand,
   slideKey,
+  speakerNotes,
   stringifyDeck,
   updateSlide,
   validateBrandProfile,
   validateDeck,
   videoEmbedUrl
-} from "./chunk-KQXT376T.js";
-
-// src/generated/runtime-hash.ts
-var RUNTIME_SCRIPT_HASH = "sha256-gElvQAb4VPvKu4UeyJRVKuoHYNp8NGhXwx2EhL7NB88=";
+} from "./chunk-MCG5BFJN.js";
 export {
   AUTHORING_GUIDE,
   BrandPaletteSchema,
@@ -109,6 +114,7 @@ export {
   extractDeckSource,
   fieldMarkers,
   findSlide,
+  finishChartSvg,
   formatIssues,
   formatPath,
   formatValue,
@@ -129,9 +135,11 @@ export {
   prose,
   removeSlide,
   renderChartSvg,
+  renderChartSvgs,
   renderDeck,
   resolveBrand,
   slideKey,
+  speakerNotes,
   stringifyDeck,
   updateSlide,
   validateBrandProfile,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/generated/runtime-hash.ts"],"sourcesContent":["// Generated by scripts/embed-fonts.ts. Do not edit.\n/** CSP source for the inline presenter runtime: script-src '<hash>'. */\nexport const RUNTIME_SCRIPT_HASH = 'sha256-gElvQAb4VPvKu4UeyJRVKuoHYNp8NGhXwx2EhL7NB88=';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEO,IAAM,sBAAsB;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{mcp-VBUAVGHS.js → mcp-ZBYNCCHN.js}

@@ -2,13 +2,14 @@ import {
   AUTHORING_GUIDE,
   describeLayout,
   listLayouts
-} from "./chunk-7NSNE5ED.js";
+} from "./chunk-QOKQWHHD.js";
 import {
   buildDeckFile,
   confinedPath,
   loadDeckFile,
   saveDeckFile
-} from "./chunk-B3MBJRHZ.js";
+} from "./chunk-4LBQOMMI.js";
+import "./chunk-6ARF37DO.js";
 import {
   addSlide,
   formatIssues,
@@ -18,7 +19,7 @@ import {
   stringifyDeck,
   updateSlide,
   validateDeck
-} from "./chunk-KQXT376T.js";
+} from "./chunk-MCG5BFJN.js";
 
 // src/node/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -320,4 +321,4 @@ export {
   createSlidesMcpServer,
   runStdio
 };
-//# sourceMappingURL=mcp-VBUAVGHS.js.map
+//# sourceMappingURL=mcp-ZBYNCCHN.js.map