@theokit/ui 0.13.0

package/dist/slide/index.d.ts

@@ -0,0 +1,212 @@
+import { FC, ReactElement, RefObject } from 'react';
+import { d as SlideValidationError, b as SlidePlugin, S as SlideFrontmatter, M as MergedSanitizeExtensions, a as SlideInput } from '../plugin-D5xmXqYb.js';
+export { P as PluginComposer, c as SlideSanitizeExtension, e as SlideValidationErrorCode, f as composePlugins, s as slideFrontmatter, g as slideInput, h as slideTheme } from '../plugin-D5xmXqYb.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
+ * `@theokit/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/index.js

@@ -0,0 +1,3 @@
+export { MAX_RAW_FRONTMATTER, Slide, collectTagCounts, composePlugins, extractFrontmatter, getSlideSanitizeSchema, hastToReact, isSlideTheme, mdastToHast, parseBody, parseSlide, sanitizeHast, slideFrontmatter, slideFrontmatterJsonSchema, slideInput, slideTheme, slideThemes, useSlideFit, validateSlide } from '../chunk-ZUS5KZGO.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/slide/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

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

@@ -0,0 +1,29 @@
+import { b as SlidePlugin } from '../../../plugin-D5xmXqYb.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/emoji/index.js

@@ -0,0 +1,157 @@
+// src/components/primitives/slide/plugins/emoji/map.ts
+var EMOJI_MAP = {
+  // Faces & reactions
+  smile: "\u{1F600}",
+  grin: "\u{1F601}",
+  joy: "\u{1F602}",
+  rofl: "\u{1F923}",
+  wink: "\u{1F609}",
+  sweat_smile: "\u{1F605}",
+  blush: "\u{1F60A}",
+  thinking: "\u{1F914}",
+  neutral_face: "\u{1F610}",
+  expressionless: "\u{1F611}",
+  no_mouth: "\u{1F636}",
+  heart_eyes: "\u{1F60D}",
+  sunglasses: "\u{1F60E}",
+  cry: "\u{1F622}",
+  sob: "\u{1F62D}",
+  scream: "\u{1F631}",
+  fearful: "\u{1F628}",
+  flushed: "\u{1F633}",
+  zzz: "\u{1F4A4}",
+  // Hand gestures
+  thumbsup: "\u{1F44D}",
+  thumbs_up: "\u{1F44D}",
+  thumbsdown: "\u{1F44E}",
+  thumbs_down: "\u{1F44E}",
+  ok_hand: "\u{1F44C}",
+  clap: "\u{1F44F}",
+  wave: "\u{1F44B}",
+  raised_hands: "\u{1F64C}",
+  pray: "\u{1F64F}",
+  muscle: "\u{1F4AA}",
+  point_right: "\u{1F449}",
+  point_left: "\u{1F448}",
+  point_up: "\u{1F446}",
+  point_down: "\u{1F447}",
+  // Signals & icons
+  check: "\u2705",
+  white_check_mark: "\u2705",
+  x: "\u274C",
+  heavy_check_mark: "\u2714",
+  ballot_box_with_check: "\u2611\uFE0F",
+  warning: "\u26A0\uFE0F",
+  no_entry: "\u26D4",
+  no_entry_sign: "\u{1F6AB}",
+  question: "\u2753",
+  exclamation: "\u2757",
+  bangbang: "\u203C\uFE0F",
+  information_source: "\u2139\uFE0F",
+  zap: "\u26A1",
+  bell: "\u{1F514}",
+  no_bell: "\u{1F515}",
+  // Tech
+  rocket: "\u{1F680}",
+  computer: "\u{1F4BB}",
+  desktop_computer: "\u{1F5A5}\uFE0F",
+  keyboard: "\u2328\uFE0F",
+  bulb: "\u{1F4A1}",
+  hammer: "\u{1F528}",
+  wrench: "\u{1F527}",
+  gear: "\u2699\uFE0F",
+  lock: "\u{1F512}",
+  unlock: "\u{1F513}",
+  key: "\u{1F511}",
+  package: "\u{1F4E6}",
+  link: "\u{1F517}",
+  paperclip: "\u{1F4CE}",
+  scissors: "\u2702\uFE0F",
+  hourglass: "\u23F3",
+  alarm_clock: "\u23F0",
+  stopwatch: "\u23F1\uFE0F",
+  hash: "#\uFE0F\u20E3",
+  // Files & docs
+  page_facing_up: "\u{1F4C4}",
+  pencil: "\u270F\uFE0F",
+  memo: "\u{1F4DD}",
+  book: "\u{1F4D6}",
+  books: "\u{1F4DA}",
+  bookmark: "\u{1F516}",
+  clipboard: "\u{1F4CB}",
+  chart_with_upwards_trend: "\u{1F4C8}",
+  chart_with_downwards_trend: "\u{1F4C9}",
+  bar_chart: "\u{1F4CA}",
+  // Status / energy
+  fire: "\u{1F525}",
+  sparkles: "\u2728",
+  star: "\u2B50",
+  star2: "\u{1F31F}",
+  tada: "\u{1F389}",
+  confetti_ball: "\u{1F38A}",
+  boom: "\u{1F4A5}",
+  rainbow: "\u{1F308}",
+  sunny: "\u2600\uFE0F",
+  cloud: "\u2601\uFE0F",
+  snowflake: "\u2744\uFE0F",
+  hot_face: "\u{1F975}",
+  cold_face: "\u{1F976}",
+  // Affection & symbols
+  heart: "\u2764\uFE0F",
+  broken_heart: "\u{1F494}",
+  hearts: "\u{1F495}",
+  fist: "\u270A",
+  trophy: "\u{1F3C6}",
+  medal: "\u{1F396}\uFE0F",
+  hundred: "\u{1F4AF}",
+  eye: "\u{1F441}\uFE0F",
+  eyes: "\u{1F440}",
+  // Coffee & food (slide signature)
+  coffee: "\u2615",
+  tea: "\u{1F375}",
+  beer: "\u{1F37A}",
+  pizza: "\u{1F355}",
+  // Arrows
+  arrow_right: "\u27A1\uFE0F",
+  arrow_left: "\u2B05\uFE0F",
+  arrow_up: "\u2B06\uFE0F",
+  arrow_down: "\u2B07\uFE0F",
+  arrow_upper_right: "\u2197\uFE0F",
+  arrow_lower_right: "\u2198\uFE0F"
+};
+
+// src/components/primitives/slide/plugins/emoji/index.ts
+var SHORTCODE_RE = /:([a-z0-9_+-]+):/g;
+function isInsideCodeOrPre(ancestors) {
+  for (let i = ancestors.length - 1; i >= 0; i--) {
+    const a = ancestors[i];
+    if (!a || a.type !== "element") continue;
+    if (a.tagName === "code" || a.tagName === "pre") return true;
+  }
+  return false;
+}
+function emojiPlugin(opts = {}) {
+  const map = { ...EMOJI_MAP, ...opts.extra ?? {} };
+  return {
+    name: "emoji",
+    async hastTransform(tree) {
+      const { visitParents } = await import('unist-util-visit-parents');
+      visitParents(
+        tree,
+        "text",
+        (node, ancestors) => {
+          if (isInsideCodeOrPre(ancestors)) return;
+          node.value = node.value.replace(SHORTCODE_RE, (match, code) => {
+            const replacement = map[code.toLowerCase()];
+            return replacement ?? match;
+          });
+        }
+      );
+      return tree;
+    }
+  };
+}
+
+export { EMOJI_MAP, emojiPlugin };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/slide/plugins/emoji/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/components/primitives/slide/plugins/emoji/map.ts","../../../../src/components/primitives/slide/plugins/emoji/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * 100 emoji shortcodes commonly used in tech presentations.\n *\n * Selection rationale: covers the top ~80% of GitHub markdown usage in code\n * docs, release notes, slides. Unicode-native (no external font dependency)\n * so the appearance follows the OS emoji font (Apple Color Emoji on macOS,\n * Segoe UI Emoji on Windows, Noto Color Emoji on Linux/Android).\n *\n * Adding entries: keep keys lowercase, kebab/underscore allowed, single Unicode\n * scalar value (sequences like 👨‍💻 are also OK).\n *\n * Twemoji variant: out of scope — `slide/plugins/emoji-twemoji` is a v0.5\n * candidate if demand emerges.\n */\nexport const EMOJI_MAP: Record<string, string> = {\n  // Faces & reactions\n  smile: \"\\u{1F600}\",\n  grin: \"\\u{1F601}\",\n  joy: \"\\u{1F602}\",\n  rofl: \"\\u{1F923}\",\n  wink: \"\\u{1F609}\",\n  sweat_smile: \"\\u{1F605}\",\n  blush: \"\\u{1F60A}\",\n  thinking: \"\\u{1F914}\",\n  neutral_face: \"\\u{1F610}\",\n  expressionless: \"\\u{1F611}\",\n  no_mouth: \"\\u{1F636}\",\n  heart_eyes: \"\\u{1F60D}\",\n  sunglasses: \"\\u{1F60E}\",\n  cry: \"\\u{1F622}\",\n  sob: \"\\u{1F62D}\",\n  scream: \"\\u{1F631}\",\n  fearful: \"\\u{1F628}\",\n  flushed: \"\\u{1F633}\",\n  zzz: \"\\u{1F4A4}\",\n\n  // Hand gestures\n  thumbsup: \"\\u{1F44D}\",\n  thumbs_up: \"\\u{1F44D}\",\n  thumbsdown: \"\\u{1F44E}\",\n  thumbs_down: \"\\u{1F44E}\",\n  ok_hand: \"\\u{1F44C}\",\n  clap: \"\\u{1F44F}\",\n  wave: \"\\u{1F44B}\",\n  raised_hands: \"\\u{1F64C}\",\n  pray: \"\\u{1F64F}\",\n  muscle: \"\\u{1F4AA}\",\n  point_right: \"\\u{1F449}\",\n  point_left: \"\\u{1F448}\",\n  point_up: \"\\u{1F446}\",\n  point_down: \"\\u{1F447}\",\n\n  // Signals & icons\n  check: \"✅\",\n  white_check_mark: \"✅\",\n  x: \"❌\",\n  heavy_check_mark: \"✔\",\n  ballot_box_with_check: \"☑️\",\n  warning: \"⚠️\",\n  no_entry: \"⛔\",\n  no_entry_sign: \"\\u{1F6AB}\",\n  question: \"❓\",\n  exclamation: \"❗\",\n  bangbang: \"‼️\",\n  information_source: \"ℹ️\",\n  zap: \"⚡\",\n  bell: \"\\u{1F514}\",\n  no_bell: \"\\u{1F515}\",\n\n  // Tech\n  rocket: \"\\u{1F680}\",\n  computer: \"\\u{1F4BB}\",\n  desktop_computer: \"\\u{1F5A5}️\",\n  keyboard: \"⌨️\",\n  bulb: \"\\u{1F4A1}\",\n  hammer: \"\\u{1F528}\",\n  wrench: \"\\u{1F527}\",\n  gear: \"⚙️\",\n  lock: \"\\u{1F512}\",\n  unlock: \"\\u{1F513}\",\n  key: \"\\u{1F511}\",\n  package: \"\\u{1F4E6}\",\n  link: \"\\u{1F517}\",\n  paperclip: \"\\u{1F4CE}\",\n  scissors: \"✂️\",\n  hourglass: \"⏳\",\n  alarm_clock: \"⏰\",\n  stopwatch: \"⏱️\",\n  hash: \"#️⃣\",\n\n  // Files & docs\n  page_facing_up: \"\\u{1F4C4}\",\n  pencil: \"✏️\",\n  memo: \"\\u{1F4DD}\",\n  book: \"\\u{1F4D6}\",\n  books: \"\\u{1F4DA}\",\n  bookmark: \"\\u{1F516}\",\n  clipboard: \"\\u{1F4CB}\",\n  chart_with_upwards_trend: \"\\u{1F4C8}\",\n  chart_with_downwards_trend: \"\\u{1F4C9}\",\n  bar_chart: \"\\u{1F4CA}\",\n\n  // Status / energy\n  fire: \"\\u{1F525}\",\n  sparkles: \"✨\",\n  star: \"⭐\",\n  star2: \"\\u{1F31F}\",\n  tada: \"\\u{1F389}\",\n  confetti_ball: \"\\u{1F38A}\",\n  boom: \"\\u{1F4A5}\",\n  rainbow: \"\\u{1F308}\",\n  sunny: \"☀️\",\n  cloud: \"☁️\",\n  snowflake: \"❄️\",\n  hot_face: \"\\u{1F975}\",\n  cold_face: \"\\u{1F976}\",\n\n  // Affection & symbols\n  heart: \"❤️\",\n  broken_heart: \"\\u{1F494}\",\n  hearts: \"\\u{1F495}\",\n  fist: \"✊\",\n  trophy: \"\\u{1F3C6}\",\n  medal: \"\\u{1F396}️\",\n  hundred: \"\\u{1F4AF}\",\n  eye: \"\\u{1F441}️\",\n  eyes: \"\\u{1F440}\",\n\n  // Coffee & food (slide signature)\n  coffee: \"☕\",\n  tea: \"\\u{1F375}\",\n  beer: \"\\u{1F37A}\",\n  pizza: \"\\u{1F355}\",\n\n  // Arrows\n  arrow_right: \"➡️\",\n  arrow_left: \"⬅️\",\n  arrow_up: \"⬆️\",\n  arrow_down: \"⬇️\",\n  arrow_upper_right: \"↗️\",\n  arrow_lower_right: \"↘️\",\n};\n","/**\n * Slide rich-content plugin — Unicode emoji shortcodes.\n *\n * Zero peer-deps for runtime (only unist-util-visit-parents which is part of\n * the existing slide stack tree). Substitutes `:shortcode:` patterns with the\n * matching Unicode emoji from the embedded map.\n *\n * EC-6: uses `visitParents` with an ancestor check so shortcodes inside\n * `<code>` / `<pre>` are NEVER replaced. This prevents corruption of code\n * samples that legitimately use `:colon:syntax` (Python type hints, YAML\n * keys, Ruby symbols, JSX self-closing, etc.).\n *\n * Unknown shortcodes pass through unchanged (`:foo:` stays as text).\n */\nimport type { Root as HastRoot } from \"hast\";\nimport type { SlidePlugin } from \"../../plugin.js\";\nimport { EMOJI_MAP } from \"./map.js\";\n\nconst SHORTCODE_RE = /:([a-z0-9_+-]+):/g;\n\n/**\n * Return true when any ancestor element is `<code>` or `<pre>`. Used to skip\n * emoji replacement inside code samples (EC-6).\n */\nfunction isInsideCodeOrPre(ancestors: ReadonlyArray<{ type: string; tagName?: string }>): boolean {\n  for (let i = ancestors.length - 1; i >= 0; i--) {\n    const a = ancestors[i];\n    if (!a || a.type !== \"element\") continue;\n    if (a.tagName === \"code\" || a.tagName === \"pre\") return true;\n  }\n  return false;\n}\n\nexport interface EmojiPluginOptions {\n  /** Override or extend the default emoji map. Merged on top of the built-in 100. */\n  extra?: Record<string, string>;\n}\n\nexport function emojiPlugin(opts: EmojiPluginOptions = {}): SlidePlugin {\n  const map = { ...EMOJI_MAP, ...(opts.extra ?? {}) };\n  return {\n    name: \"emoji\",\n    async hastTransform(tree: HastRoot): Promise<HastRoot> {\n      const { visitParents } = await import(\"unist-util-visit-parents\");\n      visitParents(\n        tree,\n        \"text\",\n        (node: { value: string }, ancestors: Array<{ type: string; tagName?: string }>) => {\n          if (isInsideCodeOrPre(ancestors)) return;\n          node.value = node.value.replace(SHORTCODE_RE, (match, code: string) => {\n            const replacement = map[code.toLowerCase()];\n            return replacement ?? match;\n          });\n        },\n      );\n      return tree;\n    },\n  };\n}\n\nexport { EMOJI_MAP };\n"]}

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

@@ -0,0 +1,13 @@
+import { b as SlidePlugin } from '../../../plugin-D5xmXqYb.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/math/index.js

@@ -0,0 +1,145 @@
+// src/components/primitives/slide/plugins/math/index.ts
+var MATHML_TAG_NAMES = [
+  "span",
+  "div",
+  "math",
+  "semantics",
+  "annotation",
+  "annotation-xml",
+  // token elements
+  "mtext",
+  "mn",
+  "mo",
+  "mi",
+  "ms",
+  "mglyph",
+  // general layout
+  "mrow",
+  "mfrac",
+  "msqrt",
+  "mroot",
+  "mstyle",
+  "merror",
+  "mpadded",
+  "mphantom",
+  "menclose",
+  "mspace",
+  // scripts & limits
+  "msub",
+  "msup",
+  "msubsup",
+  "munder",
+  "mover",
+  "munderover",
+  "mmultiscripts",
+  "mprescripts",
+  // tables (matrices)
+  "mtable",
+  "mtr",
+  "mtd",
+  "mlabeledtr"
+];
+var MATHML_ATTRIBUTES = {
+  "*": ["style", "className", "ariaHidden", "ariaLabel"],
+  span: ["style", "className"],
+  math: ["xmlns", "display"],
+  annotation: ["encoding"],
+  "annotation-xml": ["encoding"],
+  mfrac: ["linethickness"],
+  mspace: ["width", "height", "depth"],
+  mover: ["accent"],
+  munder: ["accentunder"],
+  mo: ["fence", "form", "lspace", "rspace", "stretchy", "symmetric"]
+};
+var INLINE_RE = /\$([^$\n]+)\$/g;
+var BLOCK_RE = /\$\$([\s\S]+?)\$\$/g;
+function mathPlugin(opts = {}) {
+  let peerDepMissing = false;
+  return {
+    name: "math",
+    sanitizeSchemaExtension: {
+      tagNames: MATHML_TAG_NAMES,
+      attributes: MATHML_ATTRIBUTES
+    },
+    async hastTransform(tree) {
+      if (peerDepMissing) return tree;
+      let katex;
+      let fromHtml;
+      let visit;
+      try {
+        katex = (await import('katex')).default;
+        fromHtml = (await import('hast-util-from-html')).fromHtml;
+        visit = (await import('unist-util-visit')).visit;
+      } catch (e) {
+        peerDepMissing = true;
+        throw new Error(
+          `[slide/plugins/math] peer-deps missing (katex / hast-util-from-html). Run: pnpm add katex hast-util-from-html. Math formulas remain as plain text. Error: ${e instanceof Error ? e.message : String(e)}`
+        );
+      }
+      visit(
+        tree,
+        "text",
+        (node, idx, parent) => {
+          if (!parent || idx === void 0) return;
+          if (parent.tagName === "code" || parent.tagName === "pre") return;
+          const value = node.value;
+          const replacements = [];
+          for (const m of value.matchAll(BLOCK_RE)) {
+            if (m.index === void 0) continue;
+            try {
+              replacements.push({
+                start: m.index,
+                end: m.index + m[0].length,
+                html: katex.renderToString(m[1], {
+                  ...opts.katexOptions ?? {},
+                  displayMode: true,
+                  throwOnError: false
+                })
+              });
+            } catch {
+            }
+          }
+          for (const m of value.matchAll(INLINE_RE)) {
+            if (m.index === void 0) continue;
+            if (replacements.some((r) => (m.index ?? 0) >= r.start && (m.index ?? 0) < r.end))
+              continue;
+            try {
+              replacements.push({
+                start: m.index,
+                end: m.index + m[0].length,
+                html: katex.renderToString(m[1], {
+                  ...opts.katexOptions ?? {},
+                  displayMode: false,
+                  throwOnError: false
+                })
+              });
+            } catch {
+            }
+          }
+          if (replacements.length === 0) return;
+          replacements.sort((a, b) => a.start - b.start);
+          const newChildren = [];
+          let cursor = 0;
+          for (const r of replacements) {
+            if (r.start > cursor) {
+              newChildren.push({ type: "text", value: value.slice(cursor, r.start) });
+            }
+            const fragment = fromHtml(r.html, { fragment: true });
+            newChildren.push(...fragment.children);
+            cursor = r.end;
+          }
+          if (cursor < value.length) {
+            newChildren.push({ type: "text", value: value.slice(cursor) });
+          }
+          parent.children.splice(idx, 1, ...newChildren);
+          return idx + newChildren.length;
+        }
+      );
+      return tree;
+    }
+  };
+}
+
+export { mathPlugin };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/slide/plugins/math/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/components/primitives/slide/plugins/math/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Slide rich-content plugin — KaTeX math rendering.\n *\n * Peer-deps (optional): `katex`, `hast-util-from-html`, `unist-util-visit`.\n * Lazy + opt-in (ADR D10 / D13 of the rich-content plan).\n *\n * Detects `$inline$` and `$$block$$` patterns in hast text nodes and replaces\n * them with KaTeX-rendered HTML. Block math (display mode) is rendered with\n * `displayMode: true` for proper line height + numbering.\n *\n * EC-2: every peer-dep is loaded via dynamic `import()` wrapped in try/catch;\n * a missing peer-dep surfaces via the D16 path (PLUGIN_ERROR) and the math\n * source stays as plain text — slide doesn't break.\n *\n * EC-4: `sanitizeSchemaExtension` lists ~30 MathML tags + KaTeX-specific\n * attributes so the rendered output survives the security barrier (D17).\n *\n * Consumer setup:\n *   import \"katex/dist/katex.min.css\";\n *   <Slide markdown={md} plugins={[mathPlugin()]} />\n */\nimport type { Root as HastRoot } from \"hast\";\nimport type { SlidePlugin } from \"../../plugin.js\";\n\nexport interface MathPluginOptions {\n  /** KaTeX render options forwarded to `renderToString`. */\n  katexOptions?: Record<string, unknown>;\n}\n\n// EC-4: complete MathML core tag list — KaTeX emits these for fraction, sqrt,\n// matrix, sub/super, accents, etc. Plus `<span>`/`<div>` for layout chrome.\nconst MATHML_TAG_NAMES = [\n  \"span\",\n  \"div\",\n  \"math\",\n  \"semantics\",\n  \"annotation\",\n  \"annotation-xml\",\n  // token elements\n  \"mtext\",\n  \"mn\",\n  \"mo\",\n  \"mi\",\n  \"ms\",\n  \"mglyph\",\n  // general layout\n  \"mrow\",\n  \"mfrac\",\n  \"msqrt\",\n  \"mroot\",\n  \"mstyle\",\n  \"merror\",\n  \"mpadded\",\n  \"mphantom\",\n  \"menclose\",\n  \"mspace\",\n  // scripts & limits\n  \"msub\",\n  \"msup\",\n  \"msubsup\",\n  \"munder\",\n  \"mover\",\n  \"munderover\",\n  \"mmultiscripts\",\n  \"mprescripts\",\n  // tables (matrices)\n  \"mtable\",\n  \"mtr\",\n  \"mtd\",\n  \"mlabeledtr\",\n];\n\nconst MATHML_ATTRIBUTES: Record<string, string[]> = {\n  \"*\": [\"style\", \"className\", \"ariaHidden\", \"ariaLabel\"],\n  span: [\"style\", \"className\"],\n  math: [\"xmlns\", \"display\"],\n  annotation: [\"encoding\"],\n  \"annotation-xml\": [\"encoding\"],\n  mfrac: [\"linethickness\"],\n  mspace: [\"width\", \"height\", \"depth\"],\n  mover: [\"accent\"],\n  munder: [\"accentunder\"],\n  mo: [\"fence\", \"form\", \"lspace\", \"rspace\", \"stretchy\", \"symmetric\"],\n};\n\nconst INLINE_RE = /\\$([^$\\n]+)\\$/g;\nconst BLOCK_RE = /\\$\\$([\\s\\S]+?)\\$\\$/g;\n\nexport function mathPlugin(opts: MathPluginOptions = {}): SlidePlugin {\n  let peerDepMissing = false;\n\n  return {\n    name: \"math\",\n    sanitizeSchemaExtension: {\n      tagNames: MATHML_TAG_NAMES,\n      attributes: MATHML_ATTRIBUTES,\n    },\n    async hastTransform(tree: HastRoot): Promise<HastRoot> {\n      if (peerDepMissing) return tree;\n      // EC-2: peer-dep guard. Throw on missing import — D16 absorbs into errors[].\n      // biome-ignore lint/suspicious/noExplicitAny: katex default export untyped here\n      let katex: any;\n      // biome-ignore lint/suspicious/noExplicitAny: hast-util-from-html fromHtml untyped here\n      let fromHtml: any;\n      // biome-ignore lint/suspicious/noExplicitAny: unist-util-visit\n      let visit: any;\n      try {\n        katex = (await import(\"katex\")).default;\n        fromHtml = (await import(\"hast-util-from-html\")).fromHtml;\n        visit = (await import(\"unist-util-visit\")).visit;\n      } catch (e) {\n        peerDepMissing = true;\n        throw new Error(\n          `[slide/plugins/math] peer-deps missing (katex / hast-util-from-html). Run: pnpm add katex hast-util-from-html. Math formulas remain as plain text. Error: ${e instanceof Error ? e.message : String(e)}`,\n        );\n      }\n\n      // Walk text nodes, find $..$ and $$..$$ patterns, replace with rendered HTML.\n      visit(\n        tree,\n        \"text\",\n        (\n          node: { value: string },\n          idx: number | undefined,\n          parent: { children: unknown[]; tagName?: string } | undefined,\n        ) => {\n          if (!parent || idx === undefined) return;\n          // Skip if the text is inside a code / pre block — math shouldn't\n          // accidentally trigger on `$amount = 100$` inside a code sample.\n          if (parent.tagName === \"code\" || parent.tagName === \"pre\") return;\n          const value = node.value;\n          const replacements: Array<{\n            start: number;\n            end: number;\n            html: string;\n          }> = [];\n          // Block math first ($$..$$) so we can mask its ranges before inline scan.\n          for (const m of value.matchAll(BLOCK_RE)) {\n            if (m.index === undefined) continue;\n            try {\n              replacements.push({\n                start: m.index,\n                end: m.index + m[0].length,\n                html: katex.renderToString(m[1], {\n                  ...(opts.katexOptions ?? {}),\n                  displayMode: true,\n                  throwOnError: false,\n                }),\n              });\n            } catch {\n              // Malformed TeX — KaTeX may throw with throwOnError:true. Skip.\n            }\n          }\n          for (const m of value.matchAll(INLINE_RE)) {\n            if (m.index === undefined) continue;\n            // Avoid re-processing inline matches that fall inside a block range.\n            if (replacements.some((r) => (m.index ?? 0) >= r.start && (m.index ?? 0) < r.end))\n              continue;\n            try {\n              replacements.push({\n                start: m.index,\n                end: m.index + m[0].length,\n                html: katex.renderToString(m[1], {\n                  ...(opts.katexOptions ?? {}),\n                  displayMode: false,\n                  throwOnError: false,\n                }),\n              });\n            } catch {\n              // skip\n            }\n          }\n          if (replacements.length === 0) return;\n          replacements.sort((a, b) => a.start - b.start);\n          const newChildren: unknown[] = [];\n          let cursor = 0;\n          for (const r of replacements) {\n            if (r.start > cursor) {\n              newChildren.push({ type: \"text\", value: value.slice(cursor, r.start) });\n            }\n            const fragment = fromHtml(r.html, { fragment: true });\n            newChildren.push(...fragment.children);\n            cursor = r.end;\n          }\n          if (cursor < value.length) {\n            newChildren.push({ type: \"text\", value: value.slice(cursor) });\n          }\n          parent.children.splice(idx, 1, ...newChildren);\n          return idx + newChildren.length;\n        },\n      );\n      return tree;\n    },\n  };\n}\n"]}