@refraction-ui/react 0.18.3 → 0.19.0

package/dist/internal/device-frame/index.d.ts

@@ -1,5 +1,3 @@
-import { AccessibilityProps } from '../shared/index.js';
-
 type DeviceType = 'iphone' | 'ipad' | 'android-phone' | 'android-tablet';
 type DeviceOrientation = 'portrait' | 'landscape';
 interface DeviceFrameProps {
@@ -24,7 +22,7 @@ interface DeviceFrameAPI {
     /** Computed dimensions for the device */
     dimensions: DeviceDimensions;
     /** ARIA attributes for the device frame */
-    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    ariaProps: Record<string, string | number | boolean>;
     /** Data attributes for styling hooks */
     dataAttributes: Record<string, string>;
 }

package/dist/internal/diff-viewer/index.d.cts

@@ -0,0 +1,118 @@
+import { AccessibilityProps, TokenContract } from '../shared/index.cjs';
+
+type DiffViewerTheme = 'light' | 'dark';
+type DiffViewMode = 'side-by-side' | 'inline';
+type DiffFileStatus = 'added' | 'modified' | 'deleted' | 'renamed';
+interface DiffFile {
+    /** File path */
+    path: string;
+    /** Change status */
+    status: DiffFileStatus;
+    /** Lines added */
+    additions: number;
+    /** Lines deleted */
+    deletions: number;
+    /** Unified diff content for this file */
+    diff?: string;
+    /** Old path for renamed files */
+    oldPath?: string;
+}
+interface DiffViewerProps {
+    /** Files in this diff */
+    files?: DiffFile[];
+    /** Index of the active file */
+    activeFileIndex?: number;
+    /** View mode */
+    viewMode?: DiffViewMode;
+    /** Theme */
+    theme?: DiffViewerTheme;
+    /** Language for syntax highlighting */
+    language?: string;
+    /** Whether the sidebar is visible */
+    sidebarOpen?: boolean;
+    /** Callback when active file changes */
+    onFileSelect?: (index: number) => void;
+    /** Callback when view mode changes */
+    onViewModeChange?: (mode: DiffViewMode) => void;
+    /** Callback when sidebar toggled */
+    onSidebarToggle?: () => void;
+}
+interface DiffViewerState {
+    activeFileIndex: number;
+    viewMode: DiffViewMode;
+    theme: DiffViewerTheme;
+    language: string;
+    sidebarOpen: boolean;
+    files: DiffFile[];
+}
+interface DiffViewerAPI {
+    /** Current viewer state */
+    state: DiffViewerState;
+    /** ARIA attributes for the root element */
+    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    /** Data attributes for CSS styling hooks */
+    dataAttributes: Record<string, string>;
+    /** Select a file by index */
+    selectFile: (index: number) => void;
+    /** Move to next file */
+    nextFile: () => void;
+    /** Move to previous file */
+    prevFile: () => void;
+    /** Toggle view mode */
+    toggleViewMode: () => void;
+    /** Toggle sidebar */
+    toggleSidebar: () => void;
+    /** Get language label for a file path */
+    getLanguageForFile: (path: string) => string;
+    /** Get human-readable file status icon */
+    getFileStatusIcon: (status: DiffFileStatus) => string;
+    /** Get total additions across all files */
+    totalAdditions: () => number;
+    /** Get total deletions across all files */
+    totalDeletions: () => number;
+}
+/**
+ * Create a headless diff viewer API.
+ *
+ * Manages file selection, view mode, sidebar state, and produces ARIA/data
+ * attributes. The actual rendering (Monaco DiffEditor, custom renderer, etc.)
+ * is handled by framework-specific wrappers.
+ */
+declare function createDiffViewer(props?: DiffViewerProps): DiffViewerAPI;
+
+declare const diffViewerTokens: TokenContract;
+declare const diffViewerVariants: (props?: ({
+    theme?: "light" | "dark" | undefined;
+    fullscreen?: "true" | "false" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const sidebarVariants: (props?: ({
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const sidebarItemVariants: (props?: ({
+    active?: "true" | "false" | undefined;
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const tabBarVariants: (props?: ({
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const tabVariants: (props?: ({
+    active?: "true" | "false" | undefined;
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const statusBarVariants: (props?: ({
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type DiffFile, type DiffFileStatus, type DiffViewMode, type DiffViewerAPI, type DiffViewerProps, type DiffViewerState, type DiffViewerTheme, createDiffViewer, diffViewerTokens, diffViewerVariants, sidebarItemVariants, sidebarVariants, statusBarVariants, tabBarVariants, tabVariants };

package/dist/internal/diff-viewer/index.d.ts

@@ -0,0 +1,118 @@
+import { AccessibilityProps, TokenContract } from '../shared/index.js';
+
+type DiffViewerTheme = 'light' | 'dark';
+type DiffViewMode = 'side-by-side' | 'inline';
+type DiffFileStatus = 'added' | 'modified' | 'deleted' | 'renamed';
+interface DiffFile {
+    /** File path */
+    path: string;
+    /** Change status */
+    status: DiffFileStatus;
+    /** Lines added */
+    additions: number;
+    /** Lines deleted */
+    deletions: number;
+    /** Unified diff content for this file */
+    diff?: string;
+    /** Old path for renamed files */
+    oldPath?: string;
+}
+interface DiffViewerProps {
+    /** Files in this diff */
+    files?: DiffFile[];
+    /** Index of the active file */
+    activeFileIndex?: number;
+    /** View mode */
+    viewMode?: DiffViewMode;
+    /** Theme */
+    theme?: DiffViewerTheme;
+    /** Language for syntax highlighting */
+    language?: string;
+    /** Whether the sidebar is visible */
+    sidebarOpen?: boolean;
+    /** Callback when active file changes */
+    onFileSelect?: (index: number) => void;
+    /** Callback when view mode changes */
+    onViewModeChange?: (mode: DiffViewMode) => void;
+    /** Callback when sidebar toggled */
+    onSidebarToggle?: () => void;
+}
+interface DiffViewerState {
+    activeFileIndex: number;
+    viewMode: DiffViewMode;
+    theme: DiffViewerTheme;
+    language: string;
+    sidebarOpen: boolean;
+    files: DiffFile[];
+}
+interface DiffViewerAPI {
+    /** Current viewer state */
+    state: DiffViewerState;
+    /** ARIA attributes for the root element */
+    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    /** Data attributes for CSS styling hooks */
+    dataAttributes: Record<string, string>;
+    /** Select a file by index */
+    selectFile: (index: number) => void;
+    /** Move to next file */
+    nextFile: () => void;
+    /** Move to previous file */
+    prevFile: () => void;
+    /** Toggle view mode */
+    toggleViewMode: () => void;
+    /** Toggle sidebar */
+    toggleSidebar: () => void;
+    /** Get language label for a file path */
+    getLanguageForFile: (path: string) => string;
+    /** Get human-readable file status icon */
+    getFileStatusIcon: (status: DiffFileStatus) => string;
+    /** Get total additions across all files */
+    totalAdditions: () => number;
+    /** Get total deletions across all files */
+    totalDeletions: () => number;
+}
+/**
+ * Create a headless diff viewer API.
+ *
+ * Manages file selection, view mode, sidebar state, and produces ARIA/data
+ * attributes. The actual rendering (Monaco DiffEditor, custom renderer, etc.)
+ * is handled by framework-specific wrappers.
+ */
+declare function createDiffViewer(props?: DiffViewerProps): DiffViewerAPI;
+
+declare const diffViewerTokens: TokenContract;
+declare const diffViewerVariants: (props?: ({
+    theme?: "light" | "dark" | undefined;
+    fullscreen?: "true" | "false" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const sidebarVariants: (props?: ({
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const sidebarItemVariants: (props?: ({
+    active?: "true" | "false" | undefined;
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const tabBarVariants: (props?: ({
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const tabVariants: (props?: ({
+    active?: "true" | "false" | undefined;
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const statusBarVariants: (props?: ({
+    theme?: "light" | "dark" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type DiffFile, type DiffFileStatus, type DiffViewMode, type DiffViewerAPI, type DiffViewerProps, type DiffViewerState, type DiffViewerTheme, createDiffViewer, diffViewerTokens, diffViewerVariants, sidebarItemVariants, sidebarVariants, statusBarVariants, tabBarVariants, tabVariants };

package/dist/internal/emoji-picker/index.d.cts

@@ -1,5 +1,3 @@
-import { AccessibilityProps } from '../shared/index.cjs';
-
 type EmojiCategory = 'smileys' | 'people' | 'nature' | 'food' | 'travel' | 'activities' | 'objects' | 'symbols' | 'flags';
 interface EmojiEntry {
     /** The rendered glyph (native codepoints). */
@@ -77,7 +75,7 @@ interface EmojiPickerAPI {
         emoji: string;
     }[];
     /** ARIA props for the picker container */
-    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    ariaProps: Record<string, string | number | boolean>;
     /** ARIA props for the search input */
     searchInputProps: Record<string, unknown>;
     /** Get ARIA props for an emoji button */

package/dist/internal/emoji-picker/index.d.ts

@@ -1,5 +1,3 @@
-import { AccessibilityProps } from '../shared/index.js';
-
 type EmojiCategory = 'smileys' | 'people' | 'nature' | 'food' | 'travel' | 'activities' | 'objects' | 'symbols' | 'flags';
 interface EmojiEntry {
     /** The rendered glyph (native codepoints). */
@@ -77,7 +75,7 @@ interface EmojiPickerAPI {
         emoji: string;
     }[];
     /** ARIA props for the picker container */
-    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    ariaProps: Record<string, string | number | boolean>;
     /** ARIA props for the search input */
     searchInputProps: Record<string, unknown>;
     /** Get ARIA props for an emoji button */

package/dist/internal/file-tree/index.d.cts

@@ -0,0 +1,125 @@
+/**
+ * @refraction-ui/file-tree — headless tree view.
+ *
+ * Owns the *behavior* of a hierarchical tree: the node model, expand/collapse
+ * state, single selection, roving focus, and WAI-ARIA treeview keyboard
+ * semantics. It has NO UI opinion — adapters render the nested markup and
+ * spread the ARIA objects.
+ */
+/** A node in the tree. Parents carry `children`; leaves do not. */
+interface FileTreeNode {
+    /** Unique, stable id (used for expansion/selection/focus). */
+    id: string;
+    /** Display label. */
+    label: string;
+    /** Child nodes — presence (even empty is not allowed: omit for leaves) marks a parent. */
+    children?: FileTreeNode[];
+    /** Disabled nodes cannot be selected, toggled, or focused via click. */
+    disabled?: boolean;
+}
+/** Options for {@link createFileTree}. */
+interface FileTreeConfig {
+    /** Root-level nodes. */
+    nodes?: FileTreeNode[];
+    /** Controlled expanded node ids. Pair with `onExpandedChange`. */
+    expandedIds?: string[];
+    /** Uncontrolled initial expanded node ids. */
+    defaultExpandedIds?: string[];
+    /** Controlled selected node id (`null` = none). Pair with `onSelectionChange`. */
+    selectedId?: string | null;
+    /** Uncontrolled initial selected node id. */
+    defaultSelectedId?: string | null;
+    /** Called whenever the expanded set changes. */
+    onExpandedChange?: (ids: string[]) => void;
+    /** Called whenever the selection changes. */
+    onSelectionChange?: (id: string | null) => void;
+    /** Accessible label for the tree (default `'File tree'`). */
+    'aria-label'?: string;
+}
+/** Snapshot of the store. Returned by `getState()`; treat as immutable. */
+interface FileTreeState {
+    nodes: FileTreeNode[];
+    expandedIds: string[];
+    selectedId: string | null;
+    /** Node holding the roving-tabindex focus (null = the first visible item). */
+    focusedId: string | null;
+}
+/** A row of the flattened, currently-visible tree (DFS order). */
+interface VisibleTreeItem {
+    node: FileTreeNode;
+    /** Id of the parent node, or null for root-level items. */
+    parentId: string | null;
+    /** 1-based nesting depth (ARIA `aria-level`). */
+    depth: number;
+    hasChildren: boolean;
+    isExpanded: boolean;
+    isSelected: boolean;
+    isFocused: boolean;
+}
+/** The framework-agnostic store. React/Astro adapters wrap this. */
+interface FileTreeAPI {
+    /** Current immutable snapshot */
+    getState(): FileTreeState;
+    /** Subscribe to changes; returns an unsubscribe fn (suits useSyncExternalStore) */
+    subscribe(listener: () => void): () => void;
+    /** Flattened visible rows in DFS order (children of collapsed parents omitted) */
+    getVisibleItems(): VisibleTreeItem[];
+    isExpanded(id: string): boolean;
+    /** Toggle a parent's expanded state (no-op for leaves/disabled nodes) */
+    toggle(id: string): void;
+    expand(id: string): void;
+    collapse(id: string): void;
+    /** Select a node (`null` clears). No-op for unknown/disabled nodes. */
+    select(id: string | null): void;
+    /** Move the roving focus to a node */
+    focus(id: string | null): void;
+    /**
+     * WAI-ARIA treeview keyboard semantics, applied to the focused item:
+     * ArrowDown/Up move, ArrowRight expands or descends, ArrowLeft collapses or
+     * ascends, Home/End jump, Enter/Space selects.
+     */
+    handleKey(key: string): void;
+    /** Replace the node model (adapters sync the prop) */
+    setNodes(nodes: FileTreeNode[]): void;
+    /** Sync a controlled expanded set */
+    setExpandedIds(ids: string[]): void;
+    /** Sync a controlled selection */
+    setSelectedId(id: string | null): void;
+    /** Update callbacks/options after creation */
+    setOptions(options: {
+        onExpandedChange?: (ids: string[]) => void;
+        onSelectionChange?: (id: string | null) => void;
+        'aria-label'?: string;
+    }): void;
+    /** ARIA attributes for the tree container (`role="tree"`). */
+    getTreeAria(): Record<string, string | number | boolean>;
+    /** ARIA attributes for one visible row (`role="treeitem"`). */
+    getItemAria(item: VisibleTreeItem): Record<string, string | number | boolean>;
+}
+/**
+ * createFileTree — headless tree store with expand/collapse, single
+ * selection, roving focus, and treeview keyboard semantics. Supports
+ * controlled (`expandedIds` / `selectedId`) and uncontrolled
+ * (`defaultExpandedIds` / `defaultSelectedId`) usage.
+ */
+declare function createFileTree(config?: FileTreeConfig): FileTreeAPI;
+
+/** Tree container. */
+declare const fileTreeVariants: (props?: ({
+    [x: string]: string | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+/**
+ * A single tree row (treeitem). The `selected` variant carries the
+ * selected-row treatment so adapters never inline these classes.
+ */
+declare const fileTreeItemVariants: (props?: ({
+    selected?: "true" | "false" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+/** Expand/collapse glyph or file marker preceding the label. */
+declare const fileTreeGlyphClass = "w-4 shrink-0 text-center text-muted-foreground";
+
+export { type FileTreeAPI, type FileTreeConfig, type FileTreeNode, type FileTreeState, type VisibleTreeItem, createFileTree, fileTreeGlyphClass, fileTreeItemVariants, fileTreeVariants };

package/dist/internal/file-tree/index.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @refraction-ui/file-tree — headless tree view.
+ *
+ * Owns the *behavior* of a hierarchical tree: the node model, expand/collapse
+ * state, single selection, roving focus, and WAI-ARIA treeview keyboard
+ * semantics. It has NO UI opinion — adapters render the nested markup and
+ * spread the ARIA objects.
+ */
+/** A node in the tree. Parents carry `children`; leaves do not. */
+interface FileTreeNode {
+    /** Unique, stable id (used for expansion/selection/focus). */
+    id: string;
+    /** Display label. */
+    label: string;
+    /** Child nodes — presence (even empty is not allowed: omit for leaves) marks a parent. */
+    children?: FileTreeNode[];
+    /** Disabled nodes cannot be selected, toggled, or focused via click. */
+    disabled?: boolean;
+}
+/** Options for {@link createFileTree}. */
+interface FileTreeConfig {
+    /** Root-level nodes. */
+    nodes?: FileTreeNode[];
+    /** Controlled expanded node ids. Pair with `onExpandedChange`. */
+    expandedIds?: string[];
+    /** Uncontrolled initial expanded node ids. */
+    defaultExpandedIds?: string[];
+    /** Controlled selected node id (`null` = none). Pair with `onSelectionChange`. */
+    selectedId?: string | null;
+    /** Uncontrolled initial selected node id. */
+    defaultSelectedId?: string | null;
+    /** Called whenever the expanded set changes. */
+    onExpandedChange?: (ids: string[]) => void;
+    /** Called whenever the selection changes. */
+    onSelectionChange?: (id: string | null) => void;
+    /** Accessible label for the tree (default `'File tree'`). */
+    'aria-label'?: string;
+}
+/** Snapshot of the store. Returned by `getState()`; treat as immutable. */
+interface FileTreeState {
+    nodes: FileTreeNode[];
+    expandedIds: string[];
+    selectedId: string | null;
+    /** Node holding the roving-tabindex focus (null = the first visible item). */
+    focusedId: string | null;
+}
+/** A row of the flattened, currently-visible tree (DFS order). */
+interface VisibleTreeItem {
+    node: FileTreeNode;
+    /** Id of the parent node, or null for root-level items. */
+    parentId: string | null;
+    /** 1-based nesting depth (ARIA `aria-level`). */
+    depth: number;
+    hasChildren: boolean;
+    isExpanded: boolean;
+    isSelected: boolean;
+    isFocused: boolean;
+}
+/** The framework-agnostic store. React/Astro adapters wrap this. */
+interface FileTreeAPI {
+    /** Current immutable snapshot */
+    getState(): FileTreeState;
+    /** Subscribe to changes; returns an unsubscribe fn (suits useSyncExternalStore) */
+    subscribe(listener: () => void): () => void;
+    /** Flattened visible rows in DFS order (children of collapsed parents omitted) */
+    getVisibleItems(): VisibleTreeItem[];
+    isExpanded(id: string): boolean;
+    /** Toggle a parent's expanded state (no-op for leaves/disabled nodes) */
+    toggle(id: string): void;
+    expand(id: string): void;
+    collapse(id: string): void;
+    /** Select a node (`null` clears). No-op for unknown/disabled nodes. */
+    select(id: string | null): void;
+    /** Move the roving focus to a node */
+    focus(id: string | null): void;
+    /**
+     * WAI-ARIA treeview keyboard semantics, applied to the focused item:
+     * ArrowDown/Up move, ArrowRight expands or descends, ArrowLeft collapses or
+     * ascends, Home/End jump, Enter/Space selects.
+     */
+    handleKey(key: string): void;
+    /** Replace the node model (adapters sync the prop) */
+    setNodes(nodes: FileTreeNode[]): void;
+    /** Sync a controlled expanded set */
+    setExpandedIds(ids: string[]): void;
+    /** Sync a controlled selection */
+    setSelectedId(id: string | null): void;
+    /** Update callbacks/options after creation */
+    setOptions(options: {
+        onExpandedChange?: (ids: string[]) => void;
+        onSelectionChange?: (id: string | null) => void;
+        'aria-label'?: string;
+    }): void;
+    /** ARIA attributes for the tree container (`role="tree"`). */
+    getTreeAria(): Record<string, string | number | boolean>;
+    /** ARIA attributes for one visible row (`role="treeitem"`). */
+    getItemAria(item: VisibleTreeItem): Record<string, string | number | boolean>;
+}
+/**
+ * createFileTree — headless tree store with expand/collapse, single
+ * selection, roving focus, and treeview keyboard semantics. Supports
+ * controlled (`expandedIds` / `selectedId`) and uncontrolled
+ * (`defaultExpandedIds` / `defaultSelectedId`) usage.
+ */
+declare function createFileTree(config?: FileTreeConfig): FileTreeAPI;
+
+/** Tree container. */
+declare const fileTreeVariants: (props?: ({
+    [x: string]: string | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+/**
+ * A single tree row (treeitem). The `selected` variant carries the
+ * selected-row treatment so adapters never inline these classes.
+ */
+declare const fileTreeItemVariants: (props?: ({
+    selected?: "true" | "false" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+/** Expand/collapse glyph or file marker preceding the label. */
+declare const fileTreeGlyphClass = "w-4 shrink-0 text-center text-muted-foreground";
+
+export { type FileTreeAPI, type FileTreeConfig, type FileTreeNode, type FileTreeState, type VisibleTreeItem, createFileTree, fileTreeGlyphClass, fileTreeItemVariants, fileTreeVariants };

package/dist/internal/footer/index.d.cts

@@ -14,6 +14,8 @@ interface FooterProps {
     copyright?: string;
     socialLinks?: SocialLink[];
     columns?: FooterColumn[];
+    /** Year for the default copyrightText. Default: ambient current year — inject to avoid year-boundary SSR/CSR mismatch. */
+    year?: number;
 }
 interface FooterAPI {
     ariaProps: Record<string, string>;

package/dist/internal/footer/index.d.ts

@@ -14,6 +14,8 @@ interface FooterProps {
     copyright?: string;
     socialLinks?: SocialLink[];
     columns?: FooterColumn[];
+    /** Year for the default copyrightText. Default: ambient current year — inject to avoid year-boundary SSR/CSR mismatch. */
+    year?: number;
 }
 interface FooterAPI {
     ariaProps: Record<string, string>;

package/dist/internal/logger/index.d.cts

@@ -74,6 +74,10 @@ interface TelemetryConfig {
      * PII / secrets, e.g. `['password', 'token', 'authorization']`.
      */
     redactKeys?: string[];
+    /** Clock for record timestamps and span timing (ms epoch). Default: ambient `Date.now()` — inject for deterministic tests. */
+    now?: () => number;
+    /** RNG for sample-rate decisions. Default: ambient `Math.random` — inject for deterministic tests. */
+    random?: () => number;
 }
 /** A logger bound to a context. Child loggers inherit + extend that context. */
 interface Logger {

package/dist/internal/logger/index.d.ts

@@ -74,6 +74,10 @@ interface TelemetryConfig {
      * PII / secrets, e.g. `['password', 'token', 'authorization']`.
      */
     redactKeys?: string[];
+    /** Clock for record timestamps and span timing (ms epoch). Default: ambient `Date.now()` — inject for deterministic tests. */
+    now?: () => number;
+    /** RNG for sample-rate decisions. Default: ambient `Math.random` — inject for deterministic tests. */
+    random?: () => number;
 }
 /** A logger bound to a context. Child loggers inherit + extend that context. */
 interface Logger {

package/dist/internal/presence-indicator/index.d.cts

@@ -1,5 +1,3 @@
-import { AccessibilityProps } from '../shared/index.cjs';
-
 type PresenceStatus = 'online' | 'offline' | 'away' | 'busy' | 'dnd';
 interface PresenceProps {
     /** The presence status to display */
@@ -11,7 +9,7 @@ interface PresenceProps {
 }
 interface PresenceAPI {
     /** ARIA attributes for the indicator */
-    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    ariaProps: Record<string, string | number | boolean>;
     /** CSS color for the status dot */
     color: string;
     /** Human-readable label for the status */

package/dist/internal/presence-indicator/index.d.ts

@@ -1,5 +1,3 @@
-import { AccessibilityProps } from '../shared/index.js';
-
 type PresenceStatus = 'online' | 'offline' | 'away' | 'busy' | 'dnd';
 interface PresenceProps {
     /** The presence status to display */
@@ -11,7 +9,7 @@ interface PresenceProps {
 }
 interface PresenceAPI {
     /** ARIA attributes for the indicator */
-    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    ariaProps: Record<string, string | number | boolean>;
     /** CSS color for the status dot */
     color: string;
     /** Human-readable label for the status */

package/dist/internal/react-ai/index.d.cts

@@ -0,0 +1,59 @@
+import * as React from 'react';
+import { GenerateOptions, AIConfig, AIProvider as AIProvider$1, TTSOptions, TTSConfig, TTSProvider as TTSProvider$1 } from '../ai/index.cjs';
+export { AIProvider as AIProviderInterface, GenerateOptions, RouterFn, TTSOptions, TTSProvider as TTSProviderInterface } from '../ai/index.cjs';
+
+interface AIContextValue {
+    generateText: (prompt: string, opts?: GenerateOptions) => Promise<string>;
+    generateJSON: <T = unknown>(prompt: string, opts?: GenerateOptions) => Promise<T>;
+    providers: string[];
+    isGenerating: boolean;
+}
+interface AIProviderProps extends AIConfig {
+    children: React.ReactNode;
+    /** Pre-register providers by name */
+    providers?: Record<string, AIProvider$1>;
+}
+/**
+ * AIProvider — wraps your app with AI context.
+ *
+ * ```tsx
+ * <AIProvider default="openai" providers={{ openai: myOpenAIProvider }}>
+ *   <App />
+ * </AIProvider>
+ * ```
+ */
+declare function AIProvider({ children, providers: providerMap, ...config }: AIProviderProps): React.FunctionComponentElement<React.ProviderProps<AIContextValue | null>>;
+/**
+ * useAI — access AI generation methods and state.
+ * Must be used within <AIProvider>.
+ */
+declare function useAI(): AIContextValue;
+
+interface TTSContextValue {
+    speak: (text: string, opts?: TTSOptions) => void;
+    stop: () => void;
+    isSpeaking: boolean;
+    providers: string[];
+}
+interface TTSProviderProps extends TTSConfig {
+    children: React.ReactNode;
+    /** Pre-register providers by name */
+    providers?: Record<string, TTSProvider$1>;
+}
+/**
+ * TTSProvider — wraps your app with TTS context.
+ *
+ * ```tsx
+ * <TTSProvider providers={{ browser: myBrowserTTS }}>
+ *   <App />
+ * </TTSProvider>
+ * ```
+ */
+declare function TTSProvider({ children, providers: providerMap, ...config }: TTSProviderProps): React.FunctionComponentElement<React.ProviderProps<TTSContextValue | null>>;
+/**
+ * useTTS — access TTS methods and state.
+ * Must be used within <TTSProvider>.
+ */
+declare function useTTS(): TTSContextValue;
+
+export { type AIContextValue, AIProvider, type AIProviderProps, type TTSContextValue, TTSProvider, type TTSProviderProps, useAI, useTTS };