@classic-homes/slides 0.2.0 → 0.3.0

package/dist/render-DcyKuBRD.d.ts

@@ -0,0 +1,580 @@
+import { z } from 'zod';
+
+declare const Image: z.ZodEffects<z.ZodObject<{
+    src: z.ZodString;
+    alt: z.ZodDefault<z.ZodString>;
+    fit: z.ZodDefault<z.ZodEnum<["cover", "contain"]>>;
+    size: z.ZodDefault<z.ZodEnum<["fill", "natural"]>>;
+    focus: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    src: string;
+    alt: string;
+    fit: "cover" | "contain";
+    size: "fill" | "natural";
+    focus?: string | undefined;
+}, {
+    src: string;
+    alt?: string | undefined;
+    fit?: "cover" | "contain" | undefined;
+    size?: "fill" | "natural" | undefined;
+    focus?: string | undefined;
+}>, {
+    src: string;
+    alt: string;
+    fit: "cover" | "contain";
+    size: "fill" | "natural";
+    focus?: string | undefined;
+}, unknown>;
+type ImageInput = z.input<typeof Image>;
+type ImageValue = z.output<typeof Image>;
+declare const Item: z.ZodEffects<z.ZodObject<{
+    text: z.ZodString;
+    sub: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    sub?: string | undefined;
+}, {
+    text: string;
+    sub?: string | undefined;
+}>, {
+    text: string;
+    sub?: string | undefined;
+}, unknown>;
+type ItemValue = z.output<typeof Item>;
+
+declare const BrandPaletteSchema: z.ZodObject<{
+    primary: z.ZodString;
+    accent: z.ZodString;
+    dark: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    dark: string;
+    primary: string;
+    accent: string;
+}, {
+    dark: string;
+    primary: string;
+    accent: string;
+}>;
+type BrandPalette = z.infer<typeof BrandPaletteSchema>;
+declare const BrandProfileSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    tagline: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodDefault<z.ZodString>;
+        fit: z.ZodDefault<z.ZodEnum<["cover", "contain"]>>;
+        size: z.ZodDefault<z.ZodEnum<["fill", "natural"]>>;
+        focus: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, {
+        src: string;
+        alt?: string | undefined;
+        fit?: "cover" | "contain" | undefined;
+        size?: "fill" | "natural" | undefined;
+        focus?: string | undefined;
+    }>, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, unknown>>;
+    logoOnDark: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodDefault<z.ZodString>;
+        fit: z.ZodDefault<z.ZodEnum<["cover", "contain"]>>;
+        size: z.ZodDefault<z.ZodEnum<["fill", "natural"]>>;
+        focus: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, {
+        src: string;
+        alt?: string | undefined;
+        fit?: "cover" | "contain" | undefined;
+        size?: "fill" | "natural" | undefined;
+        focus?: string | undefined;
+    }>, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, unknown>>;
+    favicon: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodDefault<z.ZodString>;
+        fit: z.ZodDefault<z.ZodEnum<["cover", "contain"]>>;
+        size: z.ZodDefault<z.ZodEnum<["fill", "natural"]>>;
+        focus: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, {
+        src: string;
+        alt?: string | undefined;
+        fit?: "cover" | "contain" | undefined;
+        size?: "fill" | "natural" | undefined;
+        focus?: string | undefined;
+    }>, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, unknown>>;
+    palette: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodString;
+        accent: z.ZodString;
+        dark: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        dark: string;
+        primary: string;
+        accent: string;
+    }, {
+        dark: string;
+        primary: string;
+        accent: string;
+    }>>;
+    footer: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    key: string;
+    name: string;
+    tagline?: string | undefined;
+    logo?: {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    } | undefined;
+    logoOnDark?: {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    } | undefined;
+    favicon?: {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    } | undefined;
+    palette?: {
+        dark: string;
+        primary: string;
+        accent: string;
+    } | undefined;
+    footer?: string | undefined;
+}, {
+    key: string;
+    name: string;
+    tagline?: string | undefined;
+    logo?: unknown;
+    logoOnDark?: unknown;
+    favicon?: unknown;
+    palette?: {
+        dark: string;
+        primary: string;
+        accent: string;
+    } | undefined;
+    footer?: string | undefined;
+}>;
+type BrandProfileInput = z.input<typeof BrandProfileSchema>;
+type BrandProfile = z.output<typeof BrandProfileSchema>;
+/** Per-deck brand choice and overrides (deck.brand). */
+declare const DeckBrandSchema: z.ZodObject<{
+    profile: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    tagline: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodDefault<z.ZodString>;
+        fit: z.ZodDefault<z.ZodEnum<["cover", "contain"]>>;
+        size: z.ZodDefault<z.ZodEnum<["fill", "natural"]>>;
+        focus: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, {
+        src: string;
+        alt?: string | undefined;
+        fit?: "cover" | "contain" | undefined;
+        size?: "fill" | "natural" | undefined;
+        focus?: string | undefined;
+    }>, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, unknown>>;
+    logoOnDark: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodDefault<z.ZodString>;
+        fit: z.ZodDefault<z.ZodEnum<["cover", "contain"]>>;
+        size: z.ZodDefault<z.ZodEnum<["fill", "natural"]>>;
+        focus: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, {
+        src: string;
+        alt?: string | undefined;
+        fit?: "cover" | "contain" | undefined;
+        size?: "fill" | "natural" | undefined;
+        focus?: string | undefined;
+    }>, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, unknown>>;
+    favicon: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodDefault<z.ZodString>;
+        fit: z.ZodDefault<z.ZodEnum<["cover", "contain"]>>;
+        size: z.ZodDefault<z.ZodEnum<["fill", "natural"]>>;
+        focus: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, {
+        src: string;
+        alt?: string | undefined;
+        fit?: "cover" | "contain" | undefined;
+        size?: "fill" | "natural" | undefined;
+        focus?: string | undefined;
+    }>, {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    }, unknown>>;
+    footer: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name?: string | undefined;
+    tagline?: string | undefined;
+    logo?: {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    } | undefined;
+    logoOnDark?: {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    } | undefined;
+    favicon?: {
+        src: string;
+        alt: string;
+        fit: "cover" | "contain";
+        size: "fill" | "natural";
+        focus?: string | undefined;
+    } | undefined;
+    footer?: string | undefined;
+    profile?: string | undefined;
+}, {
+    name?: string | undefined;
+    tagline?: string | undefined;
+    logo?: unknown;
+    logoOnDark?: unknown;
+    favicon?: unknown;
+    footer?: string | undefined;
+    profile?: string | undefined;
+}>;
+type DeckBrand = z.output<typeof DeckBrandSchema>;
+declare const CLASSIC_HOMES_PALETTE: BrandPalette;
+declare const CLASSIC_HOMES_BRAND: BrandProfile;
+interface ResolvedBrand {
+    key: string;
+    name: string;
+    tagline?: string;
+    footer?: string;
+    logo?: ImageValue;
+    logoOnDark?: ImageValue;
+    favicon?: ImageValue;
+    palette: BrandPalette;
+    /** True when the palette is the stock Classic Homes one. */
+    stock: boolean;
+}
+/** Merges defaults ← profile ← deck overrides. Unknown profiles fall back to the default (validation reports them). */
+declare function resolveBrand(deckBrand: DeckBrand | undefined, brands?: BrandProfile[]): ResolvedBrand;
+interface PaletteIssue {
+    field: keyof BrandPalette;
+    message: string;
+}
+/**
+ * Every palette colour is used both as text on the light paper ground and as
+ * a solid ground under white text, so each must reach WCAG AA (4.5:1) both ways.
+ */
+declare function checkPalette(palette: BrandPalette): PaletteIssue[];
+/** Validates an admin-supplied profile: schema plus contrast. */
+declare function validateBrandProfile(input: unknown): {
+    ok: true;
+    profile: BrandProfile;
+} | {
+    ok: false;
+    issues: {
+        path: (string | number)[];
+        message: string;
+    }[];
+};
+
+/** The deck-level fields a layout may read while rendering. */
+interface DeckContext {
+    title: string;
+    journey?: {
+        steps: string[];
+        label: string;
+    };
+}
+/** A chart to pre-render before slides are rendered (see charts.ts). */
+interface ChartRequest {
+    key: string;
+    spec: unknown;
+    width: number;
+    height: number;
+}
+interface RenderContext {
+    deck: DeckContext;
+    /** Resolved image sources (original src → data URI or URL). */
+    image(src: string): string;
+    /** Pre-rendered QR code SVG for a URL (declare URLs in `prepare`). */
+    qr(url: string): string;
+    /** Pre-rendered chart SVG (declare charts in `prepare`). */
+    chart(key: string): string;
+    /** The deck's logo lockup for this brand ('' when settings.logo is 'none'). */
+    logo(): string;
+    /** Resolved brand name. */
+    brandName: string;
+}
+/** Async work a layout needs done before render: QR codes and charts. */
+interface Prepared {
+    qr?: string[];
+    charts?: ChartRequest[];
+    /** Extra image URLs to resolve (inline) that are not `src` fields, e.g. video posters. */
+    images?: string[];
+}
+/** One rendered <section>. Layouts return several when one entry expands into a sequence. */
+interface RenderedSlide {
+    html: string;
+    /** Extra classes on the section (layout class is added automatically). */
+    classes?: string[];
+    /** Overrides the slide's own notes (e.g. per-stage notes in a walkthrough). */
+    notes?: string;
+    time?: string;
+}
+interface LayoutIssue {
+    level: 'error' | 'warning';
+    path: (string | number)[];
+    message: string;
+}
+interface LayoutDef<Shape extends z.ZodRawShape = z.ZodRawShape> {
+    /** Value of `layout` in the deck file. */
+    name: string;
+    /** One line: what the slide looks like. */
+    description: string;
+    /** When an author or agent should pick this layout. */
+    whenToUse: string;
+    /** Layout-specific fields (base slide fields are added by the deck schema). */
+    shape: Shape;
+    /** Defaults applied when the slide leaves them unset. */
+    defaults?: {
+        background?: string;
+        track?: 'value' | 'build' | 'neutral';
+    };
+    /** A complete, valid example slide. */
+    example: Record<string, unknown>;
+    /** Declares QR codes / charts to pre-render for this slide. */
+    prepare?(slide: z.infer<z.ZodObject<Shape>>): Prepared;
+    /** Soft checks beyond the schema: length and density limits that keep slides clean. */
+    lint?(slide: z.infer<z.ZodObject<Shape>>): LayoutIssue[];
+    render(slide: z.infer<z.ZodObject<Shape>>, ctx: RenderContext): RenderedSlide | RenderedSlide[];
+}
+
+/** Every layout, in the order they are offered to authors. */
+declare const LAYOUTS: readonly LayoutDef<any>[];
+type LayoutName = 'title' | 'section' | 'statement' | 'bullets' | 'split' | 'cards' | 'stats' | 'comparison' | 'journey' | 'photos' | 'image' | 'walkthrough' | 'quote' | 'qr' | 'contacts' | 'chart' | 'table' | 'flow' | 'timeline' | 'cycle' | 'hierarchy' | 'matrix' | 'tiers' | 'video' | 'embed' | 'compare';
+declare function getLayout(name: string): LayoutDef | undefined;
+
+type LayoutCategory = 'Openers & dividers' | 'Text' | 'Data' | 'Diagrams' | 'Media' | 'People & places';
+/** Category display order for layout pickers. */
+declare const LAYOUT_CATEGORY_ORDER: LayoutCategory[];
+/** Category of each layout. */
+declare const LAYOUT_CATEGORIES: Record<LayoutName, LayoutCategory>;
+
+/** Fields every slide has after parsing; layout-specific fields ride along. */
+interface SlideData {
+    layout: LayoutName;
+    id?: string;
+    track?: 'value' | 'build' | 'neutral';
+    background?: 'paper' | 'navy' | 'slate' | 'red' | 'teal' | 'plum' | 'grey' | 'stone';
+    notes?: string;
+    time?: string;
+    step?: number;
+    stepDone?: boolean;
+    showJourney?: boolean;
+    hidden?: boolean;
+    backgroundImage?: ImageValue;
+    overlay?: 'dark' | 'light' | 'brand';
+    [field: string]: unknown;
+}
+interface Deck {
+    title: string;
+    description?: string;
+    author?: string;
+    date?: string;
+    lang: string;
+    journey?: {
+        steps: string[];
+        label: string;
+    };
+    brand?: DeckBrand;
+    settings: DeckSettings;
+    slides: SlideData[];
+}
+interface DeckSettings {
+    slideNumbers: boolean;
+    logo: 'title' | 'all' | 'none';
+    confidential?: string;
+    autoAdvance?: number;
+    loop: boolean;
+}
+/** A deck as authored (before defaults are applied). */
+type DeckInput = Omit<Partial<Deck>, 'slides' | 'journey' | 'settings'> & {
+    settings?: Partial<DeckSettings>;
+    title: string;
+    journey?: {
+        steps: string[];
+        label?: string;
+    };
+    slides: ({
+        layout: LayoutName;
+    } & Record<string, unknown>)[];
+};
+type SlideInput = DeckInput['slides'][number];
+declare const SlideSchema: z.ZodType<SlideData, z.ZodTypeDef, unknown>;
+declare const DeckSettingsSchema: z.ZodObject<{
+    slideNumbers: z.ZodDefault<z.ZodBoolean>;
+    logo: z.ZodDefault<z.ZodEnum<["title", "all", "none"]>>;
+    confidential: z.ZodOptional<z.ZodString>;
+    autoAdvance: z.ZodOptional<z.ZodNumber>;
+    loop: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    logo: "title" | "all" | "none";
+    slideNumbers: boolean;
+    loop: boolean;
+    confidential?: string | undefined;
+    autoAdvance?: number | undefined;
+}, {
+    logo?: "title" | "all" | "none" | undefined;
+    slideNumbers?: boolean | undefined;
+    confidential?: string | undefined;
+    autoAdvance?: number | undefined;
+    loop?: boolean | undefined;
+}>;
+declare const DeckSchema: z.ZodType<Deck, z.ZodTypeDef, unknown>;
+
+interface ValidationResult {
+    ok: boolean;
+    deck?: Deck;
+    /** Errors block rendering; warnings are advice that keeps slides clean. */
+    issues: LayoutIssue[];
+}
+interface ValidateOptions {
+    /** Brand profiles `deck.brand.profile` may reference (classic-homes is built in). */
+    brands?: BrandProfile[];
+}
+declare function validateDeck(input: unknown, options?: ValidateOptions): ValidationResult;
+/** Human path: slides.3.items.0 → "slide 4 › items › 1" (positions are 1-based, like the outline). */
+declare function formatPath(path: (string | number)[]): string;
+declare function formatIssues(issues: LayoutIssue[]): string;
+declare class DeckError extends Error {
+    issues: LayoutIssue[];
+    constructor(issues: LayoutIssue[]);
+}
+
+/**
+ * Size to lay a preview out at before scaling it down. Slides are responsive
+ * and switch to a stacked layout below ~840px wide, so small previews should
+ * render at this size and use a CSS transform.
+ */
+declare const PREVIEW_SIZE: {
+    readonly width: 1280;
+    readonly height: 720;
+};
+type ImageResolver = (src: string) => Promise<string> | string;
+interface RenderOptions {
+    /**
+     * Turns an image `src` from the deck into something the browser can load,
+     * normally a data: URI so the file stays self-contained. The default passes
+     * data: and https: URLs through and rejects everything else.
+     */
+    resolveImage?: ImageResolver;
+    /**
+     * Maximum escaped UTF-8 bytes of data-URI images emitted into HTML, counting
+     * every occurrence (including repeated logos, backgrounds and favicon).
+     * Over-budget resolved images retain their original https URL. Authored
+     * data URIs/local images with no safe remote fallback raise DeckError.
+     * Fixed embedded fonts are excluded. Omit for unrestricted local exports.
+     */
+    maxInlineImageBytes?: number;
+    /** Embed the deck source (JSON, without image data) so the HTML can be re-opened for editing. Default true. */
+    embedSource?: boolean;
+    /** 0-based rendered slide to open on (ignored when the URL has #slide-N). Handy for editor previews. */
+    initialSlide?: number;
+    /** Brand profiles available to `deck.brand.profile` (the built-in classic-homes profile is always present). */
+    brands?: BrandProfile[];
+    /** Render slides marked `hidden` too (dimmed, badged). For editor previews. */
+    includeHidden?: boolean;
+    /** Include speaker notes, the notes panel and the presenter window. Default true; turn off for shared links. */
+    speakerNotes?: boolean;
+    /** Permit kiosk auto-advance in an isolated presentation host (editor previews stay paused). */
+    allowEmbeddedKiosk?: boolean;
+}
+interface RenderResult {
+    html: string;
+    deck: Deck;
+    slideCount: number;
+    /** For each deck slide, the 0-based indices of the rendered slides it produced (a walkthrough yields several). */
+    slideMap: number[][];
+    warnings: ReturnType<typeof validateDeck>['issues'];
+    brand: ResolvedBrand;
+}
+/** 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>;
+/** Pulls the embedded deck source back out of a rendered HTML file. */
+declare function extractDeckSource(html: string): unknown | undefined;
+
+export { checkPalette as A, type BrandPalette as B, CLASSIC_HOMES_BRAND as C, type Deck as D, collectImageSources as E, extractDeckSource as F, formatIssues as G, formatPath as H, type ImageInput as I, getLayout as J, renderDeck as K, type LayoutCategory as L, resolveBrand as M, validateBrandProfile as N, validateDeck as O, PREVIEW_SIZE as P, type RenderOptions as R, type SlideData as S, type ValidateOptions as V, 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 ItemValue as o, LAYOUTS as p, LAYOUT_CATEGORIES as q, LAYOUT_CATEGORY_ORDER as r, type LayoutDef as s, type LayoutIssue as t, type LayoutName as u, type RenderResult as v, type ResolvedBrand as w, type SlideInput as x, SlideSchema as y, type ValidationResult as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/slides",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Branded Classic Homes presentations from structured deck files: schema, layouts, renderer, CLI and MCP server",
   "type": "module",
   "main": "dist/index.js",
@@ -51,19 +51,29 @@
     "clean": "node ../../scripts/rm.mjs dist src/generated"
   },
   "dependencies": {
+    "@classic-homes/charts-core": "^0.1.36",
     "@classic-homes/theme-tokens": "^0.4.0",
-    "@modelcontextprotocol/sdk": "^1.11.0",
+    "echarts": "^5.5.0",
     "qrcode": "^1.5.4",
     "yaml": "^2.6.0",
     "zod": "^3.25.0",
     "zod-to-json-schema": "^3.24.0"
   },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/qrcode": "^1.5.5",
     "tsup": "^8.0.0",
     "tsx": "^4.0.0",
     "typescript": "^5.3.0",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.10",
+    "@modelcontextprotocol/sdk": "^1.11.0"
   }
 }

package/dist/chunk-CKVKX2ZD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/node/index.ts"],"sourcesContent":["/** Node-only helpers: read deck files, inline local images, write HTML. */\nimport { readFile, stat, writeFile } from 'node:fs/promises';\nimport { dirname, extname, isAbsolute, join, resolve } from 'node:path';\nimport { parseDeckSource, stringifyDeck } from '../parse.js';\nimport {\n  renderDeck,\n  type ImageResolver,\n  type RenderOptions,\n  type RenderResult,\n} from '../render.js';\n\nconst MIME: Record<string, string> = {\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.png': 'image/png',\n  '.webp': 'image/webp',\n  '.gif': 'image/gif',\n  '.svg': 'image/svg+xml',\n  '.avif': 'image/avif',\n};\n\n/** Largest single image we inline without warning. Big photos bloat the deck file. */\nexport const IMAGE_WARN_BYTES = 800 * 1024;\n\nexport interface FileResolverOptions {\n  /** Fetch https images and inline them so the deck works offline. Default true. */\n  inlineRemote?: boolean;\n  onWarning?: (message: string) => void;\n}\n\n/** Resolves image paths relative to the deck file and inlines them as data URIs. */\nexport function fileImageResolver(\n  baseDir: string,\n  options: FileResolverOptions = {}\n): ImageResolver {\n  const warn = options.onWarning ?? (() => {});\n  return async (src) => {\n    if (src.startsWith('data:')) return src;\n    if (/^https?:/.test(src)) {\n      if (options.inlineRemote === false) return src;\n      const res = await fetch(src);\n      if (!res.ok) throw new Error(`Image ${src} returned HTTP ${res.status}`);\n      const type = res.headers.get('content-type') ?? 'application/octet-stream';\n      const buf = Buffer.from(await res.arrayBuffer());\n      if (buf.length > IMAGE_WARN_BYTES)\n        warn(`${src} is ${(buf.length / 1024).toFixed(0)} KB; consider a smaller copy.`);\n      return `data:${type};base64,${buf.toString('base64')}`;\n    }\n    const path = isAbsolute(src) ? src : join(baseDir, src);\n    const type = MIME[extname(path).toLowerCase()];\n    if (!type)\n      throw new Error(`Unsupported image type for \"${src}\". Use jpg, png, webp, gif, svg or avif.`);\n    let buf: Buffer;\n    try {\n      buf = await readFile(path);\n    } catch {\n      throw new Error(`Image not found: \"${src}\" (looked in ${path})`);\n    }\n    if (buf.length > IMAGE_WARN_BYTES)\n      warn(`${src} is ${(buf.length / 1024).toFixed(0)} KB; consider resizing to ~2000px wide.`);\n    return `data:${type};base64,${buf.toString('base64')}`;\n  };\n}\n\nexport async function loadDeckFile(path: string): Promise<unknown> {\n  return parseDeckSource(await readFile(path, 'utf8'));\n}\n\nexport async function saveDeckFile(path: string, deck: unknown): Promise<void> {\n  const text = path.endsWith('.json') ? JSON.stringify(deck, null, 2) + '\\n' : stringifyDeck(deck);\n  await writeFile(path, text);\n}\n\nexport interface BuildOptions extends Omit<RenderOptions, 'resolveImage'>, FileResolverOptions {\n  out?: string;\n}\n\n/** Renders a deck file to a self-contained HTML file next to it (or at `out`). */\nexport async function buildDeckFile(\n  path: string,\n  options: BuildOptions = {}\n): Promise<RenderResult & { out: string; bytes: number }> {\n  const abs = resolve(path);\n  const deck = await loadDeckFile(abs);\n  const result = await renderDeck(deck, {\n    ...options,\n    resolveImage: fileImageResolver(dirname(abs), options),\n  });\n  const out = options.out ? resolve(options.out) : abs.replace(/\\.(ya?ml|json)$/i, '') + '.html';\n  await writeFile(out, result.html);\n  return { ...result, out, bytes: (await stat(out)).size };\n}\n\nexport { renderDeck };\n"],"mappings":";;;;;;;AACA,SAAS,UAAU,MAAM,iBAAiB;AAC1C,SAAS,SAAS,SAAS,YAAY,MAAM,eAAe;AAS5D,IAAM,OAA+B;AAAA,EACnC,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AACX;AAGO,IAAM,mBAAmB,MAAM;AAS/B,SAAS,kBACd,SACA,UAA+B,CAAC,GACjB;AACf,QAAM,OAAO,QAAQ,cAAc,MAAM;AAAA,EAAC;AAC1C,SAAO,OAAO,QAAQ;AACpB,QAAI,IAAI,WAAW,OAAO,EAAG,QAAO;AACpC,QAAI,WAAW,KAAK,GAAG,GAAG;AACxB,UAAI,QAAQ,iBAAiB,MAAO,QAAO;AAC3C,YAAM,MAAM,MAAM,MAAM,GAAG;AAC3B,UAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,SAAS,GAAG,kBAAkB,IAAI,MAAM,EAAE;AACvE,YAAMA,QAAO,IAAI,QAAQ,IAAI,cAAc,KAAK;AAChD,YAAMC,OAAM,OAAO,KAAK,MAAM,IAAI,YAAY,CAAC;AAC/C,UAAIA,KAAI,SAAS;AACf,aAAK,GAAG,GAAG,QAAQA,KAAI,SAAS,MAAM,QAAQ,CAAC,CAAC,+BAA+B;AACjF,aAAO,QAAQD,KAAI,WAAWC,KAAI,SAAS,QAAQ,CAAC;AAAA,IACtD;AACA,UAAM,OAAO,WAAW,GAAG,IAAI,MAAM,KAAK,SAAS,GAAG;AACtD,UAAM,OAAO,KAAK,QAAQ,IAAI,EAAE,YAAY,CAAC;AAC7C,QAAI,CAAC;AACH,YAAM,IAAI,MAAM,+BAA+B,GAAG,0CAA0C;AAC9F,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,SAAS,IAAI;AAAA,IAC3B,QAAQ;AACN,YAAM,IAAI,MAAM,qBAAqB,GAAG,gBAAgB,IAAI,GAAG;AAAA,IACjE;AACA,QAAI,IAAI,SAAS;AACf,WAAK,GAAG,GAAG,QAAQ,IAAI,SAAS,MAAM,QAAQ,CAAC,CAAC,yCAAyC;AAC3F,WAAO,QAAQ,IAAI,WAAW,IAAI,SAAS,QAAQ,CAAC;AAAA,EACtD;AACF;AAEA,eAAsB,aAAa,MAAgC;AACjE,SAAO,gBAAgB,MAAM,SAAS,MAAM,MAAM,CAAC;AACrD;AAEA,eAAsB,aAAa,MAAc,MAA8B;AAC7E,QAAM,OAAO,KAAK,SAAS,OAAO,IAAI,KAAK,UAAU,MAAM,MAAM,CAAC,IAAI,OAAO,cAAc,IAAI;AAC/F,QAAM,UAAU,MAAM,IAAI;AAC5B;AAOA,eAAsB,cACpB,MACA,UAAwB,CAAC,GAC+B;AACxD,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,OAAO,MAAM,aAAa,GAAG;AACnC,QAAM,SAAS,MAAM,WAAW,MAAM;AAAA,IACpC,GAAG;AAAA,IACH,cAAc,kBAAkB,QAAQ,GAAG,GAAG,OAAO;AAAA,EACvD,CAAC;AACD,QAAM,MAAM,QAAQ,MAAM,QAAQ,QAAQ,GAAG,IAAI,IAAI,QAAQ,oBAAoB,EAAE,IAAI;AACvF,QAAM,UAAU,KAAK,OAAO,IAAI;AAChC,SAAO,EAAE,GAAG,QAAQ,KAAK,QAAQ,MAAM,KAAK,GAAG,GAAG,KAAK;AACzD;","names":["type","buf"]}