@usetheo/ui 0.12.0 → 0.13.1

package/dist/slide/index.d.ts

@@ -1,212 +0,0 @@
-import { FC, ReactElement, RefObject } from 'react';
-import { S as SlideValidationError, a as SlidePlugin, b as SlideFrontmatter, M as MergedSanitizeExtensions, c as SlideInput } from '../plugin-Atb0VKtr.js';
-export { P as PluginComposer, d as SlideSanitizeExtension, e as SlideValidationErrorCode, f as composePlugins, s as slideFrontmatter, g as slideInput, h as slideTheme } from '../plugin-Atb0VKtr.js';
-import { Root, Element } from 'hast';
-import { Root as Root$1 } from 'mdast';
-import * as hast_util_sanitize from 'hast-util-sanitize';
-import 'zod';
-
-/**
- * Theme registry for the Slide primitive. Built-in themes that ship with the
- * `@usetheo/ui/slide` subpath. Custom themes are NOT registered through this
- * module in v0.1 — consumers override CSS variables on `.theo-slide` directly.
- */
-declare const slideThemes: readonly ["default", "violet-forge"];
-type SlideTheme = (typeof slideThemes)[number];
-/** Returns true if `value` is a recognized built-in theme. */
-declare function isSlideTheme(value: unknown): value is SlideTheme;
-
-interface SlideAspectRatio {
-    width: number;
-    height: number;
-}
-interface SlideProps {
-    /**
-     * Slide markdown. CommonMark + GFM + optional YAML frontmatter delimited
-     * by `---`. Top-level horizontal rules (`---` on their own line outside
-     * frontmatter) imply a deck split and trigger `MULTIPLE_SLIDES`; only the
-     * first slide is rendered.
-     *
-     * Note: `<figure>`/`<figcaption>` tags are stripped by the default
-     * sanitize schema (D8). Use `<img>` directly for captionless images.
-     */
-    markdown: string;
-    /** Theme name. Defaults to `"default"`. */
-    theme?: SlideTheme;
-    /**
-     * Aspect ratio of the logical canvas. Default `"16:9"` → 1280×720.
-     * Custom `{ width, height }` accepted; zero/negative/NaN fallback to 16:9.
-     */
-    aspectRatio?: "16:9" | "4:3" | SlideAspectRatio;
-    /** Lower clamp for container-fit scale. Default 0.1. */
-    minScale?: number;
-    /** Upper clamp for container-fit scale. Default 4. */
-    maxScale?: number;
-    /** Best-effort callback invoked in useEffect when validation/sanitize emits errors. */
-    onValidationError?: (errors: SlideValidationError[]) => void;
-    /** Override individual element renderers (passed to hast-util-to-jsx-runtime). */
-    components?: Record<string, FC<any>>;
-    /**
-     * Rich-content plugins (Tier 2). Each plugin transforms the mdast/hast tree
-     * or adds React component overrides. Pass MEMOIZED arrays to avoid re-parses
-     * on every render (D15).
-     *
-     * @example
-     *   const plugins = useMemo(() => [emojiPlugin(), shikiPlugin()], []);
-     *   <Slide markdown={md} plugins={plugins} />
-     */
-    plugins?: SlidePlugin[];
-    /** Accessible label for the slide. Defaults to `"Slide"`. */
-    "aria-label"?: string;
-    /** Optional class applied to the outer host element (sizing/positioning hook). */
-    className?: string;
-}
-declare const Slide: FC<SlideProps>;
-
-interface ParseSlideOptions {
-    /** Override individual element renderers (passed to hast-util-to-jsx-runtime). */
-    components?: Record<string, unknown>;
-    /** Rich-content plugins (Tier 2). Order matters — D13 / RFC 0004. */
-    plugins?: SlidePlugin[];
-}
-interface ExtractedBackground {
-    /** Sanitized URL (http/https only). */
-    url: string;
-    /** Optional Marpit modifier: `cover` | `fit` | `left` | `right`. */
-    modifier?: "cover" | "fit" | "left" | "right";
-}
-interface ParsedSlide {
-    frontmatter: SlideFrontmatter;
-    /** React element renderable as the body of a slide. Always defined (may be empty Fragment). */
-    tree: ReactElement;
-    /** Validation + sanitize errors collected during parsing. Empty on success. */
-    errors: SlideValidationError[];
-    /** True when the input contained a top-level thematic break and only the first slide was rendered. */
-    truncated: boolean;
-    /**
-     * Background image extracted from Marpit `![bg](url)` syntax (D18 / EC-5).
-     * Precedence: `frontmatter.backgroundImage` > `extractedBackground.url`.
-     */
-    extractedBackground?: ExtractedBackground;
-}
-declare function parseBody(body: string): Promise<Root$1>;
-declare function mdastToHast(tree: Root$1): Promise<Root>;
-declare function sanitizeHast(tree: Root, extensions?: MergedSanitizeExtensions): Promise<{
-    tree: Root;
-    bannedTags: string[];
-}>;
-declare function hastToReact(tree: Root, components?: Record<string, unknown>): Promise<ReactElement>;
-/**
- * Public entry point. Validates → parses → sanitizes → returns a React tree.
- *
- * Never throws on input. Errors (validation, BANNED_TAG) are collected into
- * `errors[]` so callers can show them via `onValidationError`.
- */
-declare function parseSlide(markdown: string, opts?: ParseSlideOptions): Promise<ParsedSlide>;
-
-/**
- * Async validator for slide markdown input.
- *
- * Returns `Promise<ValidationResult>` (ADR D11 — sync impossible because
- * `yaml` and `mdast-util-from-markdown` are lazy-imported peer-deps).
- *
- * Pipeline:
- *   1. Strip BOM + extract frontmatter (`frontmatter.ts`).
- *   2. Reject `FRONTMATTER_TOO_LARGE` early if raw > 10 KB (ADR D14).
- *   3. Parse YAML in safe mode → validate against `slideFrontmatter` (Zod).
- *   4. Validate body length → emit `CONTENT_TOO_LARGE` if > 50 KB.
- *   5. Detect multi-slide via mdast `thematicBreak` walk (ADR D12) — not
- *      a regex, so `---` inside fenced code blocks does not false-positive.
- *   6. Return `{ ok, input, errors[] }`.
- *
- * Errors are structured so an LLM can self-correct from the callback.
- */
-
-type ValidationResult = {
-    ok: true;
-    input: SlideInput;
-    errors: SlideValidationError[];
-} | {
-    ok: false;
-    errors: SlideValidationError[];
-};
-/**
- * Validate the markdown input. Returns errors structured for LLM self-correction.
- *
- * Async because frontmatter YAML parsing and mdast multi-slide detection both
- * use lazy-imported peer-deps (yaml + mdast-util-from-markdown).
- */
-declare function validateSlide(markdown: string): Promise<ValidationResult>;
-
-/**
- * Lightweight, dependency-free extractor that separates YAML frontmatter from
- * the markdown body.
- *
- * Strips a leading BOM (``) before matching the regex — common when
- * markdown is pasted from Word/Notion. See plan ADR D14 and edge-case EC-4.
- *
- * Returns `{ rawFrontmatter, body, tooLarge? }`:
- *   - `rawFrontmatter`: the YAML string between the two `---` delimiters, or
- *     `null` if no frontmatter is present.
- *   - `body`: the markdown after the closing `---\n` (or the full input when
- *     no frontmatter).
- *   - `tooLarge`: `true` if `rawFrontmatter` exceeds `MAX_RAW_FRONTMATTER`
- *     bytes — the caller turns this into `FRONTMATTER_TOO_LARGE`.
- */
-/** Maximum size of the raw frontmatter string before YAML parsing. 10 KB cap. */
-declare const MAX_RAW_FRONTMATTER = 10240;
-interface ExtractFrontmatterResult {
-    rawFrontmatter: string | null;
-    body: string;
-    tooLarge?: boolean;
-}
-declare function extractFrontmatter(md: string): ExtractFrontmatterResult;
-
-/**
- * Container-fit hook for the Slide primitive.
- *
- * Observes the host element via `ResizeObserver` and computes a CSS scale
- * factor that fits the fixed logical canvas (default 1280×720) inside it,
- * preserving aspect ratio. Clamped to `[minScale, maxScale]`.
- *
- * Algorithm: `scale = clamp(min(W / canvasW, H / canvasH), min, max)`.
- *
- * Adapted from Reveal.js `transformSlides` (see reference doc §4.5 / §14.2).
- *
- * Cleanup: disconnects the observer on unmount or when deps change.
- */
-
-interface UseSlideFitOptions {
-    /** Lower clamp for scale. Default 0.1. */
-    minScale?: number;
-    /** Upper clamp for scale. Default 4. */
-    maxScale?: number;
-}
-declare function useSlideFit(ref: RefObject<HTMLElement | null>, canvasW: number, canvasH: number, opts?: UseSlideFitOptions): number;
-
-/**
- * Lazy accessor for the sanitize schema.
- *
- * Always merges `defaultSchema` with the Tier 1 baseline (aside + className).
- * When `extensions` is provided, plugin-declared tag names + attributes are
- * unioned on top (D17 / EC-3). Plugins NEVER bypass sanitize — they declare
- * what they need via `sanitizeSchemaExtension`.
- *
- * Implementation notes:
- *   - The baseline schema (default + Tier 1) is cached.
- *   - Plugin-merged schemas are NOT cached (depends on combination).
- */
-declare function getSlideSanitizeSchema(extensions?: MergedSanitizeExtensions): Promise<hast_util_sanitize.Schema>;
-/** Count elements by tagName in a hast tree. Used for BANNED_TAG detection (ADR D13). */
-declare function collectTagCounts(tree: Root | Element): Map<string, number>;
-
-interface JsonSchemaProperties {
-    [key: string]: Record<string, unknown>;
-}
-interface JsonSchemaWithProperties {
-    properties?: JsonSchemaProperties;
-    [key: string]: unknown;
-}
-declare const slideFrontmatterJsonSchema: JsonSchemaWithProperties;
-
-export { type ExtractFrontmatterResult, MAX_RAW_FRONTMATTER, MergedSanitizeExtensions, type ParseSlideOptions, type ParsedSlide, Slide, type SlideAspectRatio, SlideFrontmatter, SlideInput, SlidePlugin, type SlideProps, type SlideTheme, SlideValidationError, type UseSlideFitOptions, type ValidationResult, collectTagCounts, extractFrontmatter, getSlideSanitizeSchema, hastToReact, isSlideTheme, mdastToHast, parseBody, parseSlide, sanitizeHast, slideFrontmatterJsonSchema, slideThemes, useSlideFit, validateSlide };

package/dist/slide/plugins/emoji/index.d.ts

@@ -1,29 +0,0 @@
-import { a as SlidePlugin } from '../../../plugin-Atb0VKtr.js';
-import 'hast';
-import 'mdast';
-import 'react';
-import 'zod';
-
-/**
- * 100 emoji shortcodes commonly used in tech presentations.
- *
- * Selection rationale: covers the top ~80% of GitHub markdown usage in code
- * docs, release notes, slides. Unicode-native (no external font dependency)
- * so the appearance follows the OS emoji font (Apple Color Emoji on macOS,
- * Segoe UI Emoji on Windows, Noto Color Emoji on Linux/Android).
- *
- * Adding entries: keep keys lowercase, kebab/underscore allowed, single Unicode
- * scalar value (sequences like 👨‍💻 are also OK).
- *
- * Twemoji variant: out of scope — `slide/plugins/emoji-twemoji` is a v0.5
- * candidate if demand emerges.
- */
-declare const EMOJI_MAP: Record<string, string>;
-
-interface EmojiPluginOptions {
-    /** Override or extend the default emoji map. Merged on top of the built-in 100. */
-    extra?: Record<string, string>;
-}
-declare function emojiPlugin(opts?: EmojiPluginOptions): SlidePlugin;
-
-export { EMOJI_MAP, type EmojiPluginOptions, emojiPlugin };

package/dist/slide/plugins/math/index.d.ts

@@ -1,13 +0,0 @@
-import { a as SlidePlugin } from '../../../plugin-Atb0VKtr.js';
-import 'hast';
-import 'mdast';
-import 'react';
-import 'zod';
-
-interface MathPluginOptions {
-    /** KaTeX render options forwarded to `renderToString`. */
-    katexOptions?: Record<string, unknown>;
-}
-declare function mathPlugin(opts?: MathPluginOptions): SlidePlugin;
-
-export { type MathPluginOptions, mathPlugin };

package/dist/slide/plugins/mermaid/index.d.ts

@@ -1,55 +0,0 @@
-import { FC } from 'react';
-import { a as SlidePlugin } from '../../../plugin-Atb0VKtr.js';
-import 'hast';
-import 'mdast';
-import 'zod';
-
-/**
- * Slide rich-content plugin — Mermaid diagrams.
- *
- * Peer-dep: `mermaid` (optional, ~370 KB raw — lazy + opt-in mandatory).
- * Render is client-only because Mermaid measures DOM nodes during layout;
- * SSR / static render emits a labelled placeholder + source-code fallback.
- *
- * Pipeline contribution (D11 of the rich-content plan):
- *   - `hastTransform`: detect `<pre><code class="language-mermaid">…</code></pre>`
- *     and replace with `<div class="theo-slide-mermaid-host" data-theo-mermaid-source="…">`.
- *   - `components.div`: when div has `data-theo-mermaid-source`, render the
- *     `<MermaidDiagram>` React component that lazy-imports `mermaid` and
- *     injects the SVG via `dangerouslySetInnerHTML` after `mermaid.render()`.
- *
- * EC-4: complete SVG tag + attribute allow-list (~30 tags) so the rendered SVG
- * survives sanitize. Critical: without these, sanitize strips the SVG entirely.
- *
- * EC-10: SSR placeholder is distinguishable from a render error. Error path
- * surfaces the Mermaid source code in a `<pre>` so consumers can debug + the
- * print path still shows the code (PDF cannot run dynamic Mermaid).
- */
-
-interface MermaidPluginOptions {
-    /** Mermaid theme name. Defaults to `"default"`. */
-    theme?: "default" | "forest" | "dark" | "neutral" | "base";
-}
-/**
- * React component that renders Mermaid lazily on mount.
- *
- * SSR / pre-load: renders the source as `<pre>` + `role="img"` for a11y.
- * Client: lazy-loads `mermaid`, calls `mermaid.render()`, then injects the
- *         resulting SVG via `dangerouslySetInnerHTML` so React owns the DOM
- *         subtree (avoids reconciliation crashes when state flips back to the
- *         placeholder — `ref.innerHTML` would mutate under React's feet).
- *
- * The Mermaid output is a TRUSTED string from the `mermaid` lib itself (not
- * user-controlled markup) — the user-supplied source is the DSL, not raw HTML.
- * Using dangerouslySetInnerHTML here is a controlled escape hatch.
- *
- * Peer-dep guard: if `import("mermaid")` fails, falls back to the same
- * pre-formatted source view + an `aria-label` hint (EC-10).
- */
-declare const MermaidDiagram: FC<{
-    source: string;
-    theme?: string;
-}>;
-declare function mermaidPlugin(opts?: MermaidPluginOptions): SlidePlugin;
-
-export { MermaidDiagram, type MermaidPluginOptions, mermaidPlugin };

package/dist/slide/plugins/shiki/index.d.ts

@@ -1,18 +0,0 @@
-import { a as SlidePlugin } from '../../../plugin-Atb0VKtr.js';
-import 'hast';
-import 'mdast';
-import 'react';
-import 'zod';
-
-interface ShikiPluginOptions {
-    /** Dual-theme map — light/dark Shiki theme names. Defaults to `github-light` / `github-dark`. */
-    themes?: {
-        light: string;
-        dark: string;
-    };
-    /** Languages to pre-load. Unknown languages pass-through. Defaults to a tech-stack baseline. */
-    langs?: string[];
-}
-declare function shikiPlugin(opts?: ShikiPluginOptions): SlidePlugin;
-
-export { type ShikiPluginOptions, shikiPlugin };