@refraction-ui/react 0.18.2 → 0.18.4

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

@@ -0,0 +1,111 @@
+/** AI provider interface — implemented by adapter packages (OpenAI, Anthropic, etc.) */
+interface AIProvider {
+    name: string;
+    generateText(prompt: string, opts?: GenerateOptions): Promise<string>;
+    generateJSON<T = unknown>(prompt: string, opts?: GenerateOptions): Promise<T>;
+    supportsVision: boolean;
+}
+/** Options passed to generate calls */
+interface GenerateOptions {
+    provider?: string;
+    model?: string;
+    intent?: string;
+    image?: unknown;
+    maxTokens?: number;
+    temperature?: number;
+    [key: string]: unknown;
+}
+/** TTS provider interface — implemented by TTS adapter packages */
+interface TTSProvider {
+    name: string;
+    speak(text: string, opts?: TTSOptions): void;
+    stop(): void;
+    isSupported: boolean;
+}
+/** Options passed to TTS calls */
+interface TTSOptions {
+    provider?: string;
+    voice?: string;
+    language?: string;
+    speed?: number;
+    onEnd?: () => void;
+    [key: string]: unknown;
+}
+/** Router function — picks a provider name given a request and context */
+type RouterFn<T> = (request: T, context: {
+    providers: string[];
+    default: string;
+}) => string;
+/** Config for createAI */
+interface AIConfig {
+    default?: string;
+    fallback?: string[];
+    router?: RouterFn<GenerateOptions>;
+}
+/** Config for createTTS */
+interface TTSConfig {
+    default?: string;
+    router?: RouterFn<TTSOptions>;
+}
+/** Return type of createAI */
+interface AIAPI {
+    providers: string[];
+    generateText(prompt: string, opts?: GenerateOptions): Promise<string>;
+    generateJSON<T = unknown>(prompt: string, opts?: GenerateOptions): Promise<T>;
+    addProvider(name: string, provider: AIProvider): void;
+    removeProvider(name: string): void;
+}
+/** Return type of createTTS */
+interface TTSAPI {
+    providers: string[];
+    speak(text: string, opts?: TTSOptions): void;
+    stop(): void;
+    addProvider(name: string, provider: TTSProvider): void;
+}
+
+/**
+ * createAI — creates an AI manager that routes requests to registered providers.
+ *
+ * Resolution order: explicit opts.provider -> router -> default -> first available
+ * Fallback: on error, try next in fallback chain
+ */
+declare function createAI(config?: AIConfig): AIAPI;
+
+/**
+ * createTTS — creates a TTS manager that routes requests to registered providers.
+ *
+ * Resolution order: explicit opts.provider -> router -> default -> first available
+ */
+declare function createTTS(config?: TTSConfig): TTSAPI;
+
+interface MockAIResponses {
+    text?: string[];
+    json?: unknown[];
+}
+interface MockTTSProviderExtended extends TTSProvider {
+    speakCalls: Array<{
+        text: string;
+        opts?: TTSOptions;
+    }>;
+    stopCalls: number;
+}
+/**
+ * createMockAIProvider — returns an AIProvider that returns canned responses.
+ * Used for testing without real API calls.
+ */
+declare function createMockAIProvider(name?: string, responses?: MockAIResponses): AIProvider;
+/**
+ * createMockTTSProvider — returns a TTSProvider that tracks calls for assertion.
+ * Used for testing without real speech synthesis.
+ */
+declare function createMockTTSProvider(name?: string): MockTTSProviderExtended;
+
+/**
+ * sanitizeForSpeech — converts AI-generated text (with markdown, LaTeX, HTML)
+ * into clean, speakable plain text suitable for TTS engines.
+ *
+ * 30+ regex-based transformation rules applied in order.
+ */
+declare function sanitizeForSpeech(text: string): string;
+
+export { type AIAPI, type AIConfig, type AIProvider, type GenerateOptions, type MockAIResponses, type MockTTSProviderExtended, type RouterFn, type TTSAPI, type TTSConfig, type TTSOptions, type TTSProvider, createAI, createMockAIProvider, createMockTTSProvider, createTTS, sanitizeForSpeech };

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

@@ -0,0 +1,111 @@
+/** AI provider interface — implemented by adapter packages (OpenAI, Anthropic, etc.) */
+interface AIProvider {
+    name: string;
+    generateText(prompt: string, opts?: GenerateOptions): Promise<string>;
+    generateJSON<T = unknown>(prompt: string, opts?: GenerateOptions): Promise<T>;
+    supportsVision: boolean;
+}
+/** Options passed to generate calls */
+interface GenerateOptions {
+    provider?: string;
+    model?: string;
+    intent?: string;
+    image?: unknown;
+    maxTokens?: number;
+    temperature?: number;
+    [key: string]: unknown;
+}
+/** TTS provider interface — implemented by TTS adapter packages */
+interface TTSProvider {
+    name: string;
+    speak(text: string, opts?: TTSOptions): void;
+    stop(): void;
+    isSupported: boolean;
+}
+/** Options passed to TTS calls */
+interface TTSOptions {
+    provider?: string;
+    voice?: string;
+    language?: string;
+    speed?: number;
+    onEnd?: () => void;
+    [key: string]: unknown;
+}
+/** Router function — picks a provider name given a request and context */
+type RouterFn<T> = (request: T, context: {
+    providers: string[];
+    default: string;
+}) => string;
+/** Config for createAI */
+interface AIConfig {
+    default?: string;
+    fallback?: string[];
+    router?: RouterFn<GenerateOptions>;
+}
+/** Config for createTTS */
+interface TTSConfig {
+    default?: string;
+    router?: RouterFn<TTSOptions>;
+}
+/** Return type of createAI */
+interface AIAPI {
+    providers: string[];
+    generateText(prompt: string, opts?: GenerateOptions): Promise<string>;
+    generateJSON<T = unknown>(prompt: string, opts?: GenerateOptions): Promise<T>;
+    addProvider(name: string, provider: AIProvider): void;
+    removeProvider(name: string): void;
+}
+/** Return type of createTTS */
+interface TTSAPI {
+    providers: string[];
+    speak(text: string, opts?: TTSOptions): void;
+    stop(): void;
+    addProvider(name: string, provider: TTSProvider): void;
+}
+
+/**
+ * createAI — creates an AI manager that routes requests to registered providers.
+ *
+ * Resolution order: explicit opts.provider -> router -> default -> first available
+ * Fallback: on error, try next in fallback chain
+ */
+declare function createAI(config?: AIConfig): AIAPI;
+
+/**
+ * createTTS — creates a TTS manager that routes requests to registered providers.
+ *
+ * Resolution order: explicit opts.provider -> router -> default -> first available
+ */
+declare function createTTS(config?: TTSConfig): TTSAPI;
+
+interface MockAIResponses {
+    text?: string[];
+    json?: unknown[];
+}
+interface MockTTSProviderExtended extends TTSProvider {
+    speakCalls: Array<{
+        text: string;
+        opts?: TTSOptions;
+    }>;
+    stopCalls: number;
+}
+/**
+ * createMockAIProvider — returns an AIProvider that returns canned responses.
+ * Used for testing without real API calls.
+ */
+declare function createMockAIProvider(name?: string, responses?: MockAIResponses): AIProvider;
+/**
+ * createMockTTSProvider — returns a TTSProvider that tracks calls for assertion.
+ * Used for testing without real speech synthesis.
+ */
+declare function createMockTTSProvider(name?: string): MockTTSProviderExtended;
+
+/**
+ * sanitizeForSpeech — converts AI-generated text (with markdown, LaTeX, HTML)
+ * into clean, speakable plain text suitable for TTS engines.
+ *
+ * 30+ regex-based transformation rules applied in order.
+ */
+declare function sanitizeForSpeech(text: string): string;
+
+export { type AIAPI, type AIConfig, type AIProvider, type GenerateOptions, type MockAIResponses, type MockTTSProviderExtended, type RouterFn, type TTSAPI, type TTSConfig, type TTSOptions, type TTSProvider, createAI, createMockAIProvider, createMockTTSProvider, createTTS, sanitizeForSpeech };

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

@@ -0,0 +1,95 @@
+interface LinearScale {
+    (value: number): number;
+    invert: (value: number) => number;
+    ticks: (count?: number) => number[];
+    type: 'linear';
+    domain: [number, number];
+    range: [number, number];
+}
+declare function createLinearScale(domain: [number, number], range: [number, number]): LinearScale;
+interface BandScale {
+    (value: string): number;
+    bandwidth: () => number;
+    type: 'band';
+    domain: string[];
+    range: [number, number];
+}
+declare function createBandScale(domain: string[], range: [number, number], padding?: number): BandScale;
+interface TimeScale {
+    (value: Date): number;
+    invert: (value: number) => Date;
+    ticks: (count?: number) => Date[];
+    type: 'time';
+    domain: [Date, Date];
+    range: [number, number];
+}
+declare function createTimeScale(domain: [Date, Date], range: [number, number]): TimeScale;
+
+interface HistogramBin {
+    x0: number;
+    x1: number;
+    count: number;
+}
+declare function computeExtent(data: number[]): [number, number];
+declare function computeMean(data: number[]): number;
+declare function computeHistogramBins(data: number[], binCount?: number): HistogramBin[];
+declare function normalizeData<T>(data: T[], accessor: string | ((d: T) => unknown)): unknown[];
+
+interface Point {
+    x: number;
+    y: number;
+}
+declare function linePath(points: Point[]): string;
+declare function areaPath(points: Point[], baseline: number): string;
+declare function arcPath(cx: number, cy: number, radius: number, startAngle: number, endAngle: number): string;
+
+interface Margin {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+interface Dimensions {
+    width: number;
+    height: number;
+    margin: Margin;
+    boundedWidth: number;
+    boundedHeight: number;
+}
+interface ChartConfig {
+    width?: number;
+    height?: number;
+    margin?: Partial<Margin>;
+    data?: unknown[];
+}
+interface ChartAPI {
+    dimensions: Dimensions;
+    scales: Record<string, unknown>;
+    updateDimensions: (partial: Partial<ChartConfig>) => void;
+}
+declare function combineDimensions(partial: Partial<ChartConfig>): Dimensions;
+declare function createChart(config: ChartConfig): ChartAPI;
+
+type AnyScale = LinearScale | BandScale | TimeScale;
+declare function generateTicks(scale: AnyScale, count?: number): (number | string | Date)[];
+declare function formatTick(value: number | string | Date, type: 'number' | 'date' | 'string'): string;
+
+/**
+ * Colorblind-safe color palettes for charts.
+ * Based on Wong (2011) "Points of view: Color blindness" — Nature Methods.
+ * These 8 colors are distinguishable by people with all types of color vision deficiency.
+ */
+declare const COLORBLIND_SAFE_PALETTE: readonly ["#0072B2", "#E69F00", "#009E73", "#F0E442", "#56B4E9", "#D55E00", "#CC79A7", "#000000"];
+/** Convert hex to HSL string for CSS variables */
+declare function hexToHSL(hex: string): string;
+/** Get a colorblind-safe color by index (wraps around) */
+declare function getChartColor(index: number): string;
+/**
+ * Pattern fills for charts — when color alone isn't enough.
+ * Returns SVG pattern definitions that can be used as fill.
+ */
+type PatternType = 'solid' | 'diagonal' | 'dots' | 'crosshatch' | 'horizontal' | 'vertical' | 'zigzag' | 'checker';
+declare function getPatternDef(type: PatternType, color: string, id: string): string;
+declare const PATTERNS: PatternType[];
+
+export { type BandScale, COLORBLIND_SAFE_PALETTE, type ChartAPI, type ChartConfig, type Dimensions, type HistogramBin, type LinearScale, type Margin, PATTERNS, type PatternType, type Point, type TimeScale, arcPath, areaPath, combineDimensions, computeExtent, computeHistogramBins, computeMean, createBandScale, createChart, createLinearScale, createTimeScale, formatTick, generateTicks, getChartColor, getPatternDef, hexToHSL, linePath, normalizeData };

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

@@ -0,0 +1,95 @@
+interface LinearScale {
+    (value: number): number;
+    invert: (value: number) => number;
+    ticks: (count?: number) => number[];
+    type: 'linear';
+    domain: [number, number];
+    range: [number, number];
+}
+declare function createLinearScale(domain: [number, number], range: [number, number]): LinearScale;
+interface BandScale {
+    (value: string): number;
+    bandwidth: () => number;
+    type: 'band';
+    domain: string[];
+    range: [number, number];
+}
+declare function createBandScale(domain: string[], range: [number, number], padding?: number): BandScale;
+interface TimeScale {
+    (value: Date): number;
+    invert: (value: number) => Date;
+    ticks: (count?: number) => Date[];
+    type: 'time';
+    domain: [Date, Date];
+    range: [number, number];
+}
+declare function createTimeScale(domain: [Date, Date], range: [number, number]): TimeScale;
+
+interface HistogramBin {
+    x0: number;
+    x1: number;
+    count: number;
+}
+declare function computeExtent(data: number[]): [number, number];
+declare function computeMean(data: number[]): number;
+declare function computeHistogramBins(data: number[], binCount?: number): HistogramBin[];
+declare function normalizeData<T>(data: T[], accessor: string | ((d: T) => unknown)): unknown[];
+
+interface Point {
+    x: number;
+    y: number;
+}
+declare function linePath(points: Point[]): string;
+declare function areaPath(points: Point[], baseline: number): string;
+declare function arcPath(cx: number, cy: number, radius: number, startAngle: number, endAngle: number): string;
+
+interface Margin {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+interface Dimensions {
+    width: number;
+    height: number;
+    margin: Margin;
+    boundedWidth: number;
+    boundedHeight: number;
+}
+interface ChartConfig {
+    width?: number;
+    height?: number;
+    margin?: Partial<Margin>;
+    data?: unknown[];
+}
+interface ChartAPI {
+    dimensions: Dimensions;
+    scales: Record<string, unknown>;
+    updateDimensions: (partial: Partial<ChartConfig>) => void;
+}
+declare function combineDimensions(partial: Partial<ChartConfig>): Dimensions;
+declare function createChart(config: ChartConfig): ChartAPI;
+
+type AnyScale = LinearScale | BandScale | TimeScale;
+declare function generateTicks(scale: AnyScale, count?: number): (number | string | Date)[];
+declare function formatTick(value: number | string | Date, type: 'number' | 'date' | 'string'): string;
+
+/**
+ * Colorblind-safe color palettes for charts.
+ * Based on Wong (2011) "Points of view: Color blindness" — Nature Methods.
+ * These 8 colors are distinguishable by people with all types of color vision deficiency.
+ */
+declare const COLORBLIND_SAFE_PALETTE: readonly ["#0072B2", "#E69F00", "#009E73", "#F0E442", "#56B4E9", "#D55E00", "#CC79A7", "#000000"];
+/** Convert hex to HSL string for CSS variables */
+declare function hexToHSL(hex: string): string;
+/** Get a colorblind-safe color by index (wraps around) */
+declare function getChartColor(index: number): string;
+/**
+ * Pattern fills for charts — when color alone isn't enough.
+ * Returns SVG pattern definitions that can be used as fill.
+ */
+type PatternType = 'solid' | 'diagonal' | 'dots' | 'crosshatch' | 'horizontal' | 'vertical' | 'zigzag' | 'checker';
+declare function getPatternDef(type: PatternType, color: string, id: string): string;
+declare const PATTERNS: PatternType[];
+
+export { type BandScale, COLORBLIND_SAFE_PALETTE, type ChartAPI, type ChartConfig, type Dimensions, type HistogramBin, type LinearScale, type Margin, PATTERNS, type PatternType, type Point, type TimeScale, arcPath, areaPath, combineDimensions, computeExtent, computeHistogramBins, computeMean, createBandScale, createChart, createLinearScale, createTimeScale, formatTick, generateTicks, getChartColor, getPatternDef, hexToHSL, linePath, normalizeData };

package/dist/internal/command-input/index.d.cts

@@ -0,0 +1,41 @@
+interface Trigger {
+    char: string;
+    pattern?: RegExp;
+}
+interface CommandNode {
+    type: 'command';
+    trigger: string;
+    text: string;
+}
+interface TextNode {
+    type: 'text';
+    text: string;
+}
+type InputNode = TextNode | CommandNode;
+interface CommandInputState {
+    nodes: InputNode[];
+    rawText: string;
+    cursorPosition: number;
+    activeTrigger: Trigger | null;
+    activeCommandText: string | null;
+}
+interface CommandInputOptions {
+    triggers: Trigger[];
+    onCommandTriggered?: (trigger: Trigger, text: string) => void;
+    onStateChange?: (state: CommandInputState) => void;
+    onCommandCommit?: (trigger: Trigger, text: string) => void;
+    onCommandCancel?: () => void;
+}
+declare class CommandInput {
+    private state;
+    private options;
+    constructor(options: CommandInputOptions);
+    handleInput(text: string, cursorPosition: number): void;
+    handleKeyDown(key: string, event?: Event): void;
+    get value(): InputNode[];
+    getState(): CommandInputState;
+    private parseInput;
+    private notifyStateChange;
+}
+
+export { CommandInput, type CommandInputOptions, type CommandInputState, type CommandNode, type InputNode, type TextNode, type Trigger };

package/dist/internal/command-input/index.d.ts

@@ -0,0 +1,41 @@
+interface Trigger {
+    char: string;
+    pattern?: RegExp;
+}
+interface CommandNode {
+    type: 'command';
+    trigger: string;
+    text: string;
+}
+interface TextNode {
+    type: 'text';
+    text: string;
+}
+type InputNode = TextNode | CommandNode;
+interface CommandInputState {
+    nodes: InputNode[];
+    rawText: string;
+    cursorPosition: number;
+    activeTrigger: Trigger | null;
+    activeCommandText: string | null;
+}
+interface CommandInputOptions {
+    triggers: Trigger[];
+    onCommandTriggered?: (trigger: Trigger, text: string) => void;
+    onStateChange?: (state: CommandInputState) => void;
+    onCommandCommit?: (trigger: Trigger, text: string) => void;
+    onCommandCancel?: () => void;
+}
+declare class CommandInput {
+    private state;
+    private options;
+    constructor(options: CommandInputOptions);
+    handleInput(text: string, cursorPosition: number): void;
+    handleKeyDown(key: string, event?: Event): void;
+    get value(): InputNode[];
+    getState(): CommandInputState;
+    private parseInput;
+    private notifyStateChange;
+}
+
+export { CommandInput, type CommandInputOptions, type CommandInputState, type CommandNode, type InputNode, type TextNode, type Trigger };

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 };