@usetheo/ui 0.13.1 → 0.14.0

package/dist/components/primitives/permission-matrix/permission-matrix.d.ts

@@ -1,43 +0,0 @@
-import type { HTMLAttributes, ReactNode } from "react";
-export type PermissionDecisionKind = "allow" | "ask" | "deny";
-export interface PermissionRule {
-    id: string;
-    /** Tool the rule applies to. Use "*" for any. */
-    tool: string;
-    /** Glob path it applies to. Use "*" for any. */
-    path: string;
-    decision: PermissionDecisionKind;
-    /** Optional rationale shown as helper text. */
-    note?: string;
-}
-interface PermissionMatrixProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
-    rules: PermissionRule[];
-    title?: ReactNode;
-    /**
-     * Available tools shown in the add form. Pass `undefined` (or omit) — or an
-     * empty array — to hide the add form entirely. The form only renders when
-     * `onAdd` is provided AND `toolOptions` has at least one entry.
-     */
-    toolOptions?: string[];
-    onAdd?: (rule: Omit<PermissionRule, "id">) => void;
-    onRemove?: (id: string) => void;
-    onDecisionChange?: (id: string, decision: PermissionDecisionKind) => void;
-}
-/**
- * PermissionMatrix — tool × path × decision grid for fine-grained access
- * control. Used as the "permissions" tab in the agent settings.
- *
- * One PermissionRule per row. Click the decision pill to cycle Allow → Ask → Deny.
- *
- * Design decision (2026-05-14): PermissionMatrix stays in `primitives/`
- * — not `composites/` — even though it renders inputs and a select. The native
- * `<input>` / `<select>` elements use Theo design tokens directly (border-input,
- * ring, font-mono) so visual parity with `Input` / `Select` primitives is
- * preserved. Reason for keeping it primitive: a consumer installing
- * `permission-matrix` from the registry gets a single self-contained file with
- * no transitive Theo dependencies — opposite trade-off from `EnvVarEditor`
- * which is intentionally a composite. Both shapes are valid; we ship one of
- * each so consumers can pick the dependency profile that fits their app.
- */
-declare const PermissionMatrix: import("react").ForwardRefExoticComponent<PermissionMatrixProps & import("react").RefAttributes<HTMLDivElement>>;
-export { PermissionMatrix };

package/dist/components/primitives/progress-checklist/index.d.ts

@@ -1 +0,0 @@
-export { ProgressChecklist } from "./progress-checklist.js";

package/dist/components/primitives/progress-checklist/progress-checklist.d.ts

@@ -1,18 +0,0 @@
-import type { HTMLAttributes, ReactNode } from "react";
-import type { TaskStep } from "../../../types/task.js";
-interface ProgressChecklistProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
-    title?: ReactNode;
-    steps: TaskStep[];
-    /**
-     * If true, shows percentage bar for running steps with `progress`.
-     */
-    showProgressBars?: boolean;
-}
-/**
- * ProgressChecklist — right-inspector checklist.
- *
- * Visual: vertical list of steps with status dot, label, optional progress bar.
- * Matches WIREMOCKS §3 / §4 ("Progresso") with checkmarks and pulse on running.
- */
-declare const ProgressChecklist: import("react").ForwardRefExoticComponent<ProgressChecklistProps & import("react").RefAttributes<HTMLDivElement>>;
-export { ProgressChecklist };

package/dist/components/primitives/project-switcher/index.d.ts

@@ -1 +0,0 @@
-export { ProjectSwitcher, type ProjectStatus } from "./project-switcher.js";

package/dist/components/primitives/project-switcher/project-switcher.d.ts

@@ -1,32 +0,0 @@
-import type { ButtonHTMLAttributes, ReactNode } from "react";
-/**
- * ProjectSwitcher — sidebar header for a code agent app.
- *
- * Shows the active workspace (folder name) + branch + status dot + a tiny
- * `ChevronsUpDown` hint when clickable. Used in Sidebar.Header to anchor the
- * current project context for the session list below.
- *
- *   <Sidebar.Header className="p-0">
- *     <ProjectSwitcher
- *       workspace="acme-web"
- *       branch="claude/alignment-grid"
- *       status="running"
- *       onClick={openProjectPicker}
- *     />
- *   </Sidebar.Header>
- *
- * If `onClick` is omitted, renders as a static `<div>` (no chevron, not focusable).
- */
-export type ProjectStatus = "idle" | "running" | "error" | "offline";
-interface ProjectSwitcherProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" | "children"> {
-    /** Workspace / folder name (e.g. "acme-web"). */
-    workspace: ReactNode;
-    /** Optional git branch. Renders inline with a GitBranch icon. */
-    branch?: ReactNode;
-    /** Optional status dot. Defaults to "idle". */
-    status?: ProjectStatus;
-    /** Brand letter / icon shown in the violet tile. Default: first char of workspace if string. */
-    brand?: ReactNode;
-}
-declare const ProjectSwitcher: import("react").ForwardRefExoticComponent<ProjectSwitcherProps & import("react").RefAttributes<HTMLButtonElement>>;
-export { ProjectSwitcher };

package/dist/components/primitives/quick-action-chips/index.d.ts

@@ -1 +0,0 @@
-export { QuickActionChips, type QuickAction } from "./quick-action-chips.js";

package/dist/components/primitives/quick-action-chips/quick-action-chips.d.ts

@@ -1,22 +0,0 @@
-import type { HTMLAttributes, ReactNode } from "react";
-import type { IconComponent } from "../../../lib/types.js";
-export interface QuickAction {
-    id: string;
-    label: ReactNode;
-    /** Icon component (e.g. from lucide-react). */
-    icon?: IconComponent;
-    /** When true, the chip is highlighted as the suggested next action. */
-    primary?: boolean;
-}
-interface QuickActionChipsProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect"> {
-    actions: QuickAction[];
-    onSelect?: (id: string) => void;
-}
-/**
- * QuickActionChips — row of intent chips below a hero composer.
- *
- * Used in Chat Home ("Escrever / Aprender / Código / Assuntos pessoais")
- * and the Files panel.
- */
-declare const QuickActionChips: import("react").ForwardRefExoticComponent<QuickActionChipsProps & import("react").RefAttributes<HTMLDivElement>>;
-export { QuickActionChips };

package/dist/components/primitives/recent-folders-list/index.d.ts

@@ -1 +0,0 @@
-export { RecentFoldersList, type RecentFolder } from "./recent-folders-list.js";

package/dist/components/primitives/recent-folders-list/recent-folders-list.d.ts

@@ -1,21 +0,0 @@
-import type { HTMLAttributes, ReactNode } from "react";
-export interface RecentFolder {
-    id: string;
-    name: ReactNode;
-    path: string;
-    /** When true, the row is highlighted as selected. */
-    active?: boolean;
-}
-interface RecentFoldersListProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "onSelect"> {
-    title?: ReactNode;
-    folders: RecentFolder[];
-    onSelect?: (id: string) => void;
-}
-/**
- * RecentFoldersList — recently-used folders for the Files picker.
- *
- * Visual: a stack of rows with folder icon + name + path (smaller, muted),
- * active row highlighted with violet bg.
- */
-declare const RecentFoldersList: import("react").ForwardRefExoticComponent<RecentFoldersListProps & import("react").RefAttributes<HTMLDivElement>>;
-export { RecentFoldersList };

package/dist/components/primitives/rule-card/index.d.ts

@@ -1 +0,0 @@
-export { RuleCard } from "./rule-card.js";

package/dist/components/primitives/rule-card/rule-card.d.ts

@@ -1,15 +0,0 @@
-import type { HTMLAttributes } from "react";
-import type { Rule, RuleState } from "../../../types/rule.js";
-interface RuleCardProps extends Omit<HTMLAttributes<HTMLElement>, "title" | "onSelect" | "onToggle"> {
-    rule: Rule;
-    /** Click on the card body — typically opens detail/edit view. */
-    onSelect?: (id: string) => void;
-    /** Click on the edit pencil. Defaults to onSelect if omitted. */
-    onEdit?: (id: string) => void;
-    /** Click on the trash icon. Renders the icon only when provided. */
-    onDelete?: (id: string) => void;
-    /** Toggle enabled/disabled. Renders the switch-like dot only when provided. */
-    onToggle?: (id: string, next: RuleState) => void;
-}
-declare const RuleCard: import("react").ForwardRefExoticComponent<RuleCardProps & import("react").RefAttributes<HTMLElement>>;
-export { RuleCard };

package/dist/components/primitives/run-stats/index.d.ts

@@ -1 +0,0 @@
-export { RunStats } from "./run-stats.js";

package/dist/components/primitives/run-stats/run-stats.d.ts

@@ -1,16 +0,0 @@
-import type { HTMLAttributes } from "react";
-interface RunStatsProps extends HTMLAttributes<HTMLDivElement> {
-    duration?: string;
-    /** Formatted token count, e.g. "35.7k". */
-    tokens?: string;
-    /** Number of files changed in the run. */
-    filesChanged?: number;
-}
-/**
- * RunStats — inline metric row shown after an agent run.
- *
- * Visual: muted bullet-separated row with clock + tokens + files-changed icons.
- * All optional — the component skips entries that aren't provided.
- */
-declare const RunStats: import("react").ForwardRefExoticComponent<RunStatsProps & import("react").RefAttributes<HTMLDivElement>>;
-export { RunStats };

package/dist/components/primitives/run-status-pill/index.d.ts

@@ -1 +0,0 @@
-export { RunStatusPill, type RunStatus, type RunStatusPillProps, } from "./run-status-pill.js";

package/dist/components/primitives/run-status-pill/run-status-pill.d.ts

@@ -1,13 +0,0 @@
-import { type HTMLAttributes } from "react";
-/**
- * RunStatusPill — compact status indicator for Run/Task lifecycle states.
- * Mirrors OpenClaw's `Run status: In progress | Done | Interrupted` pill.
- * Closed enum mirrors SDK `Task` state (D362).
- */
-export type RunStatus = "queued" | "in_progress" | "finished" | "error" | "cancelled" | "interrupted";
-export interface RunStatusPillProps extends Omit<HTMLAttributes<HTMLSpanElement>, "title"> {
-    status: RunStatus;
-    detail?: string;
-    "data-testid"?: string;
-}
-export declare const RunStatusPill: import("react").ForwardRefExoticComponent<RunStatusPillProps & import("react").RefAttributes<HTMLSpanElement>>;

package/dist/components/primitives/running-tasks-panel/index.d.ts

@@ -1 +0,0 @@
-export { RunningTasksPanel, type RunningTaskItem, type RunningTaskStatus, type TaskSource, } from "./running-tasks-panel.js";

package/dist/components/primitives/running-tasks-panel/running-tasks-panel.d.ts

@@ -1,20 +0,0 @@
-import type { HTMLAttributes, ReactNode } from "react";
-export type TaskSource = "agent" | "bash" | "tool";
-export type RunningTaskStatus = "running" | "completed" | "failed";
-export interface RunningTaskItem {
-    id: string;
-    label: ReactNode;
-    source: TaskSource;
-    status: RunningTaskStatus;
-}
-interface RunningTasksPanelProps extends HTMLAttributes<HTMLElement> {
-    tasks: RunningTaskItem[];
-}
-/**
- * RunningTasksPanel — split list of Running vs Completed tasks.
- *
- * Used in the Code workspace right rail to give operational visibility into
- * what the agent is executing (foreground/background) vs what already finished.
- */
-declare const RunningTasksPanel: import("react").ForwardRefExoticComponent<RunningTasksPanelProps & import("react").RefAttributes<HTMLElement>>;
-export { RunningTasksPanel };

package/dist/components/primitives/session-list-item/index.d.ts

@@ -1 +0,0 @@
-export { SessionListItem, type SessionRunStatus, type SessionMode, } from "./session-list-item.js";

package/dist/components/primitives/session-list-item/session-list-item.d.ts

@@ -1,35 +0,0 @@
-import type { ButtonHTMLAttributes, ReactNode } from "react";
-/**
- * SessionListItem — single row in the sidebar's Sessions list for a code agent
- * app. Richer than the generic `Sidebar.Item`: shows a status dot, the agent
- * mode last used (chat/code/infra), and a relative timestamp.
- *
- *   <SessionListItem
- *     title="Build the alignment grid demo"
- *     status="running"
- *     mode="code"
- *     timestamp="2m ago"
- *     active
- *     onClick={() => navigate(`/session/${id}`)}
- *   />
- *
- * The status dot maps to the agent run state and animates while running.
- */
-export type SessionRunStatus = "running" | "queued" | "completed" | "failed" | "cancelled";
-export type SessionMode = "chat" | "code" | "infra";
-interface SessionListItemProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" | "children" | "title"> {
-    /** Session title (truncated). */
-    title: ReactNode;
-    /** Agent run state. Drives the status dot. */
-    status: SessionRunStatus;
-    /** Last mode the user was viewing this session in. Optional pill. */
-    mode?: SessionMode;
-    /** Relative timestamp string ("2m ago", "yesterday"). */
-    timestamp?: ReactNode;
-    /** Optional unread count (pending agent events, new outputs). */
-    unread?: number;
-    /** Whether this is the currently selected session. */
-    active?: boolean;
-}
-declare const SessionListItem: import("react").ForwardRefExoticComponent<SessionListItemProps & import("react").RefAttributes<HTMLButtonElement>>;
-export { SessionListItem };

package/dist/components/primitives/session-timeline/index.d.ts

@@ -1 +0,0 @@
-export { SessionTimeline, type SessionStatus, type SessionSummary, } from "./session-timeline.js";

package/dist/components/primitives/session-timeline/session-timeline.d.ts

@@ -1,32 +0,0 @@
-import type { HTMLAttributes, ReactNode } from "react";
-export type SessionStatus = "active" | "completed" | "failed" | "aborted";
-export interface SessionSummary {
-    id: string;
-    /** Friendly title (often the first user message). */
-    title: string;
-    /** ISO timestamp / friendly date label. */
-    startedAt: string;
-    duration?: string;
-    status: SessionStatus;
-    /** Agent/model that ran the session. */
-    model?: string;
-    /** Total tokens consumed (formatted, e.g. "35.7k"). */
-    tokens?: string;
-    /** Total cost (USD). */
-    cost?: number;
-    /** Number of messages in the session. */
-    messageCount?: number;
-}
-interface SessionTimelineProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
-    sessions: SessionSummary[];
-    /** Title above the list. */
-    title?: ReactNode;
-    /** Fires when a row is clicked. */
-    onOpen?: (id: string) => void;
-}
-/**
- * SessionTimeline — historical view of past agent sessions with per-row
- * tokens / cost / duration / status. Click a row to open the full session.
- */
-declare const SessionTimeline: import("react").ForwardRefExoticComponent<SessionTimelineProps & import("react").RefAttributes<HTMLDivElement>>;
-export { SessionTimeline };

package/dist/components/primitives/skill-card/index.d.ts

@@ -1 +0,0 @@
-export { SkillCard, type Skill, type SkillSource, type SkillState } from "./skill-card.js";

package/dist/components/primitives/skill-card/skill-card.d.ts

@@ -1,28 +0,0 @@
-import type { HTMLAttributes, ReactNode } from "react";
-import type { Mode } from "../../../types/mode.js";
-export type SkillSource = "builtin" | "project" | "user" | "plugin";
-export type SkillState = "enabled" | "disabled";
-export interface Skill {
-    id: string;
-    name: string;
-    description?: ReactNode;
-    /** Where the skill comes from. */
-    source: SkillSource;
-    /** Optional tools the skill is allowed to use (informational). */
-    allowedTools?: string[];
-    /** Optional trigger keywords / patterns for discovery. */
-    triggers?: string[];
-    state?: SkillState;
-    /** Modes this skill is visible in. Omit / empty = global (all modes). */
-    modes?: Mode[];
-}
-interface SkillCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "onToggle"> {
-    skill: Skill;
-    onToggle?: (id: string, next: SkillState) => void;
-}
-/**
- * SkillCard — single skill entry showing what it does, where it came from,
- * and which tools it needs. Toggle to enable/disable for the current session.
- */
-declare const SkillCard: import("react").ForwardRefExoticComponent<SkillCardProps & import("react").RefAttributes<HTMLDivElement>>;
-export { SkillCard };

package/dist/components/primitives/slide/alerts.d.ts

@@ -1,31 +0,0 @@
-/**
- * GFM alerts post-processor — converts `> [!NOTE]` blockquotes into
- * `<aside class="theo-slide-alert" data-theo-slide-alert-type="...">` (ADR D3 of
- * the slide-rich-content plan).
- *
- * GitHub Flavored Markdown introduced this convention in 2023 for callouts.
- * `remark-gfm` (already in our dep tree) parses the blockquote but does NOT
- * distinguish alerts from regular blockquotes. We post-process the mdast tree
- * to detect the canonical marker and annotate with `hName` + `hProperties` so
- * `mdast-util-to-hast` emits the desired hast element.
- *
- * Five tag families are supported, mirroring GitHub:
- *   - NOTE      (info / blue)
- *   - TIP       (success / green)
- *   - IMPORTANT (purple)
- *   - WARNING   (yellow)
- *   - CAUTION   (red)
- *
- * Case-insensitive. Marker is stripped from the rendered text. Regular
- * blockquotes (without `[!TYPE]` prefix) are left untouched.
- */
-import type { Root } from "mdast";
-/** Canonical alert types — used by CSS via `data-theo-slide-alert-type="..."`. */
-export declare const ALERT_TYPES: readonly ["note", "tip", "important", "warning", "caution"];
-export type AlertType = (typeof ALERT_TYPES)[number];
-/**
- * Walk a mdast tree and mutate any blockquote that opens with `[!TYPE]` into
- * an `<aside>` annotation. Mutation is in-place to keep the pipeline allocation
- * profile flat; the same tree is returned for chainability.
- */
-export declare function detectAlerts(tree: Root): Root;

package/dist/components/primitives/slide/frontmatter.d.ts

@@ -1,23 +0,0 @@
-/**
- * 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. */
-export declare const MAX_RAW_FRONTMATTER = 10240;
-export interface ExtractFrontmatterResult {
-    rawFrontmatter: string | null;
-    body: string;
-    tooLarge?: boolean;
-}
-export declare function extractFrontmatter(md: string): ExtractFrontmatterResult;

package/dist/components/primitives/slide/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * Public surface of `@theokit/ui/slide`. Subpath-isolated engine: this bundle
- * is emitted separately from the barrel (see `tsup.config.ts`) and depends on
- * the markdown stack via optional peer-deps.
- */
-export { Slide } from "./slide.js";
-export type { SlideAspectRatio, SlideProps, SlideTheme, SlideValidationError, SlideValidationErrorCode, } from "./slide.js";
-export { parseSlide, parseBody, mdastToHast, sanitizeHast, hastToReact, type ParseSlideOptions, type ParsedSlide, } from "./parse.js";
-export { validateSlide, type ValidationResult } from "./validate.js";
-export { extractFrontmatter, MAX_RAW_FRONTMATTER, type ExtractFrontmatterResult, } from "./frontmatter.js";
-export { slideFrontmatter, slideInput, slideTheme, type SlideFrontmatter, type SlideInput, } from "./schema.js";
-export { isSlideTheme, slideThemes } from "./themes/index.js";
-export { useSlideFit, type UseSlideFitOptions } from "./use-slide-fit.js";
-export { collectTagCounts, getSlideSanitizeSchema } from "./sanitize.js";
-export { composePlugins, type SlidePlugin, type SlideSanitizeExtension, type MergedSanitizeExtensions, type PluginComposer, } from "./plugin.js";
-export { slideFrontmatterJsonSchema } from "./json-schema.js";

package/dist/components/primitives/slide/json-schema.d.ts

@@ -1,9 +0,0 @@
-interface JsonSchemaProperties {
-    [key: string]: Record<string, unknown>;
-}
-interface JsonSchemaWithProperties {
-    properties?: JsonSchemaProperties;
-    [key: string]: unknown;
-}
-export declare const slideFrontmatterJsonSchema: JsonSchemaWithProperties;
-export {};

package/dist/components/primitives/slide/marpit-bg.d.ts

@@ -1,36 +0,0 @@
-/**
- * Marpit-style `![bg](url)` background syntax detector.
- *
- * Marpit popularised the convention of declaring a slide background via a
- * standalone image whose alt-text starts with `bg`:
- *
- *     ![bg](https://example.com/photo.jpg)
- *     ![bg cover](url)   ![bg fit](url)   ![bg left](url)   ![bg right](url)
- *
- * LLMs trained on Marp output emit this naturally, so the slide primitive
- * adopts the same surface — but in a STRICTLY safe way:
- *
- * 1. Only triggers when the paragraph contains a SINGLE image (avoids
- *    collisions with inline images mixed with text).
- * 2. First-bg-wins (multiple `![bg]` directives in one slide → only the first
- *    is honoured; the others are also dropped from the tree to prevent
- *    duplicate rendering).
- * 3. The extracted result goes into `ParsedSlide.extractedBackground` (D18 /
- *    EC-5) and the Slide component prefers an explicit `frontmatter.backgroundImage`
- *    over the Marpit extraction.
- * 4. URL sanitization happens at the caller (`parseSlide`) via `sanitizeBgUrl`.
- */
-import type { Root } from "mdast";
-export interface ExtractedMarpitBackground {
-    url: string;
-    modifier?: "cover" | "fit" | "left" | "right";
-}
-/**
- * Walk the mdast tree, extract the first `![bg](url)` directive, drop ALL
- * matching paragraphs from the tree. Returns a new tree (children array
- * is filtered; node identities are preserved otherwise).
- */
-export declare function extractMarpitBackgrounds(tree: Root): {
-    tree: Root;
-    background?: ExtractedMarpitBackground;
-};

package/dist/components/primitives/slide/parse.d.ts

@@ -1,59 +0,0 @@
-import type { Root as HastRoot } from "hast";
-/**
- * Markdown → React tree pipeline for the Slide primitive.
- *
- *   parseSlide(markdown)
- *     ├─ validateSlide(markdown) → { frontmatter, body, errors? }
- *     ├─ parseBody(body)        → mdast Root (micromark + GFM)
- *     ├─ mdastToHast(mdastTree) → hast Root (allowDangerousHtml: false)
- *     ├─ sanitizeHast(hastTree) → hast Root + BANNED_TAG diff (ADR D13)
- *     └─ hastToReact(hastTree)  → React tree (jsx-runtime, no innerHTML)
- *
- * Every transform is composed of lazy-imported peer-deps so the slide bundle
- * stays under budget and never vendors the markdown stack into the barrel
- * (ADR D2 / D3 of the slide plan).
- */
-import type { Root as MdastRoot } from "mdast";
-import type { ReactElement } from "react";
-import { type MergedSanitizeExtensions, type SlidePlugin } from "./plugin.js";
-import { type SlideFrontmatter, type SlideValidationError } from "./schema.js";
-export 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[];
-}
-export interface ExtractedBackground {
-    /** Sanitized URL (http/https only). */
-    url: string;
-    /** Optional Marpit modifier: `cover` | `fit` | `left` | `right`. */
-    modifier?: "cover" | "fit" | "left" | "right";
-}
-export 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;
-}
-export declare function parseBody(body: string): Promise<MdastRoot>;
-export declare function mdastToHast(tree: MdastRoot): Promise<HastRoot>;
-export declare function sanitizeHast(tree: HastRoot, extensions?: MergedSanitizeExtensions): Promise<{
-    tree: HastRoot;
-    bannedTags: string[];
-}>;
-export declare function hastToReact(tree: HastRoot, 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`.
- */
-export declare function parseSlide(markdown: string, opts?: ParseSlideOptions): Promise<ParsedSlide>;

package/dist/components/primitives/slide/plugin.d.ts

@@ -1,79 +0,0 @@
-/**
- * Slide plugin contract — extension points for rich-content engines.
- *
- * Plugins are composable transformers applied during `parseSlide`. Each plugin
- * may inspect/mutate the mdast tree (before HTML conversion), the hast tree
- * (after HTML conversion, before sanitize), and override React component
- * renderers (after sanitize). They may also declare sanitize-schema extensions
- * so custom tags (e.g. Shiki spans, KaTeX MathML, Mermaid SVG) survive the
- * security barrier.
- *
- * Design rules (ADRs in `.claude/knowledge-base/plans/slide-rich-content-plan.md`):
- *   D1  — explicit `plugins` prop (no auto-detect).
- *   D2  — plugin shape: { name, mdastTransform?, hastTransform?, components? }.
- *   D13 — execution order: mdast → hast → sanitize (with merged extensions) → components.
- *   D16 — plugin error isolation: each plugin call is try/catch wrapped; errors
- *         are collected, not thrown.
- *   D17 — sanitize-schema merge is OBLIGATORY for plugins emitting non-default
- *         tags; without it, the sanitize step silently strips the content.
- *
- * Sanitize is the security barrier. Plugins NEVER bypass `hast-util-sanitize`.
- */
-import type { Root as HastRoot } from "hast";
-import type { Root as MdastRoot } from "mdast";
-import type { FC } from "react";
-import type { SlideValidationError } from "./schema.js";
-/** Sanitize schema extension declared by a plugin. Merged with `defaultSchema` in `parseSlide`. */
-export interface SlideSanitizeExtension {
-    /** Additional element tag names allowed past the sanitizer. */
-    tagNames?: string[];
-    /** Additional attribute allow-list keyed by tag name (or `"*"` for all tags). */
-    attributes?: Record<string, string[]>;
-}
-/** A composable transformer + component-override unit. */
-export interface SlidePlugin {
-    /** Stable identifier used in PLUGIN_ERROR messages and dev logs. */
-    name: string;
-    /** Mutate the mdast tree before HTML conversion. Return value is forwarded. */
-    mdastTransform?: (tree: MdastRoot) => Promise<MdastRoot> | MdastRoot;
-    /** Mutate the hast tree after HTML conversion, before sanitize. */
-    hastTransform?: (tree: HastRoot) => Promise<HastRoot> | HastRoot;
-    /** React component overrides merged into the consumer's `components` map. */
-    components?: Record<string, FC<any>>;
-    /** Sanitize-schema extension. Required for plugins emitting non-default tags. */
-    sanitizeSchemaExtension?: SlideSanitizeExtension;
-}
-/** Merged sanitize-schema extensions from all plugins. */
-export interface MergedSanitizeExtensions {
-    tagNames: string[];
-    attributes: Record<string, string[]>;
-}
-/** Composer over a plugin array. Hooks orchestrate transformation + error isolation. */
-export interface PluginComposer {
-    /** Run all `mdastTransform` hooks in array order. Collects errors. */
-    runMdast(tree: MdastRoot, errors: SlideValidationError[]): Promise<MdastRoot>;
-    /** Run all `hastTransform` hooks in array order. Collects errors. */
-    runHast(tree: HastRoot, errors: SlideValidationError[]): Promise<HastRoot>;
-    /** Merge all plugin component overrides; later-plugin-wins on conflict. */
-    mergedComponents(): Record<string, FC<any>>;
-    /** Merge sanitize-schema extensions across all plugins (dedupes tag names). */
-    mergedSanitizeExtensions(): MergedSanitizeExtensions;
-}
-/**
- * Build a composer over an array of plugins.
- *
- * Order semantics:
- *   - mdast transforms run sequentially in array order.
- *   - hast transforms run sequentially in array order.
- *   - components merge: later plugin wins on conflict (Object.assign semantics).
- *   - sanitize-schema extensions: union of tag names; union of attributes by tag.
- *
- * Error semantics (D16):
- *   - Each plugin call is wrapped in try/catch.
- *   - On throw, an error of code `PLUGIN_ERROR` is pushed to `errors[]` and the
- *     pipeline continues with the **non-transformed** input from that plugin
- *     (i.e. subsequent plugins see the tree that failed plugin received).
- *   - The composer NEVER throws; `parseSlide` keeps its "never throws on input"
- *     contract (RFC 0002 D9).
- */
-export declare function composePlugins(plugins: SlidePlugin[]): PluginComposer;

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

@@ -1,8 +0,0 @@
-import type { SlidePlugin } from "../../plugin.js";
-import { EMOJI_MAP } from "./map.js";
-export interface EmojiPluginOptions {
-    /** Override or extend the default emoji map. Merged on top of the built-in 100. */
-    extra?: Record<string, string>;
-}
-export declare function emojiPlugin(opts?: EmojiPluginOptions): SlidePlugin;
-export { EMOJI_MAP };

package/dist/components/primitives/slide/plugins/emoji/map.d.ts

@@ -1,15 +0,0 @@
-/**
- * 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.
- */
-export declare const EMOJI_MAP: Record<string, string>;

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

@@ -1,6 +0,0 @@
-import type { SlidePlugin } from "../../plugin.js";
-export interface MathPluginOptions {
-    /** KaTeX render options forwarded to `renderToString`. */
-    katexOptions?: Record<string, unknown>;
-}
-export declare function mathPlugin(opts?: MathPluginOptions): SlidePlugin;