@refraction-ui/react 0.18.3 → 0.19.0

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/analytics/index.d.cts

@@ -166,6 +166,8 @@ interface HttpSinkOptions {
     maxBatchBytes?: number;
     /** Soft per-event byte cap (Segment ≈ 32KB). Default 32_000. */
     maxEventBytes?: number;
+    /** Clock for the batch `sentAt` stamp. Default: ambient `new Date()` — inject for deterministic tests. */
+    now?: () => Date;
 }
 /** `createAnalytics` configuration. */
 interface AnalyticsConfig {
@@ -200,6 +202,10 @@ interface AnalyticsConfig {
     batchSize?: number;
     /** Auto-flush interval in ms (prod). Default 10_000. */
     flushIntervalMs?: number;
+    /** Clock for default event timestamps. Default: ambient `new Date()` — inject for deterministic tests/SSR. */
+    now?: () => Date;
+    /** RNG for sample-rate decisions. Default: ambient `Math.random` — inject for deterministic tests. */
+    random?: () => number;
 }
 /** Options accepted by every top-level call. */
 interface CallOptions {

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

@@ -166,6 +166,8 @@ interface HttpSinkOptions {
     maxBatchBytes?: number;
     /** Soft per-event byte cap (Segment ≈ 32KB). Default 32_000. */
     maxEventBytes?: number;
+    /** Clock for the batch `sentAt` stamp. Default: ambient `new Date()` — inject for deterministic tests. */
+    now?: () => Date;
 }
 /** `createAnalytics` configuration. */
 interface AnalyticsConfig {
@@ -200,6 +202,10 @@ interface AnalyticsConfig {
     batchSize?: number;
     /** Auto-flush interval in ms (prod). Default 10_000. */
     flushIntervalMs?: number;
+    /** Clock for default event timestamps. Default: ambient `new Date()` — inject for deterministic tests/SSR. */
+    now?: () => Date;
+    /** RNG for sample-rate decisions. Default: ambient `Math.random` — inject for deterministic tests. */
+    random?: () => number;
 }
 /** Options accepted by every top-level call. */
 interface CallOptions {

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

@@ -17,6 +17,8 @@ interface CalendarProps {
     maxDate?: Date;
     /** Specific dates to disable */
     disabledDates?: Date[];
+    /** Reference "today" for isToday/aria-current. Default: ambient `new Date()` — inject to avoid SSR/CSR hydration mismatch. */
+    today?: Date;
 }
 interface CalendarDay {
     /** The date this cell represents */
@@ -48,9 +50,9 @@ interface CalendarAPI {
     /** Select a date */
     select(date: Date): void;
     /** ARIA attributes for the calendar grid */
-    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    ariaProps: Partial<AccessibilityProps> & Record<string, string | number | boolean>;
     /** Get ARIA attributes for a specific day cell */
-    getDayAriaProps(day: CalendarDay): Partial<AccessibilityProps> & Record<string, unknown>;
+    getDayAriaProps(day: CalendarDay): Partial<AccessibilityProps> & Record<string, string | number | boolean>;
     /** Generated IDs */
     ids: {
         grid: string;
@@ -65,7 +67,7 @@ declare const calendarVariants: (props?: ({
     className?: string;
 }) | undefined) => string;
 declare const dayVariants: (props?: ({
-    state?: "default" | "selected" | "today" | "disabled" | "outside" | undefined;
+    state?: "today" | "default" | "selected" | "disabled" | "outside" | undefined;
 } & {
     className?: string;
 }) | undefined) => string;

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

@@ -17,6 +17,8 @@ interface CalendarProps {
     maxDate?: Date;
     /** Specific dates to disable */
     disabledDates?: Date[];
+    /** Reference "today" for isToday/aria-current. Default: ambient `new Date()` — inject to avoid SSR/CSR hydration mismatch. */
+    today?: Date;
 }
 interface CalendarDay {
     /** The date this cell represents */
@@ -48,9 +50,9 @@ interface CalendarAPI {
     /** Select a date */
     select(date: Date): void;
     /** ARIA attributes for the calendar grid */
-    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    ariaProps: Partial<AccessibilityProps> & Record<string, string | number | boolean>;
     /** Get ARIA attributes for a specific day cell */
-    getDayAriaProps(day: CalendarDay): Partial<AccessibilityProps> & Record<string, unknown>;
+    getDayAriaProps(day: CalendarDay): Partial<AccessibilityProps> & Record<string, string | number | boolean>;
     /** Generated IDs */
     ids: {
         grid: string;
@@ -65,7 +67,7 @@ declare const calendarVariants: (props?: ({
     className?: string;
 }) | undefined) => string;
 declare const dayVariants: (props?: ({
-    state?: "default" | "selected" | "today" | "disabled" | "outside" | undefined;
+    state?: "today" | "default" | "selected" | "disabled" | "outside" | undefined;
 } & {
     className?: string;
 }) | undefined) => string;

package/dist/internal/call-controls/index.d.ts

@@ -1,5 +1,3 @@
-import { AccessibilityProps } from '../shared/index.js';
-
 /** Visual/semantic tone of a call control button. */
 type CallControlTone = 'default' | 'active' | 'destructive';
 /**
@@ -29,7 +27,7 @@ interface CallControlsProps {
 }
 interface CallControlsAPI {
     /** ARIA attributes to spread on the toolbar element (`role="toolbar"`). */
-    ariaProps: Partial<AccessibilityProps>;
+    ariaProps: Record<string, string | number | boolean>;
     /** Data attributes for styling hooks. */
     dataAttributes: Record<string, string>;
 }

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/conversation/index.d.cts

@@ -157,6 +157,8 @@ interface ConversationConfig {
     generateTitle?: (firstMessage: string) => string;
     /** Threading mode (default 'inline') */
     threadingMode?: ThreadingMode;
+    /** Clock for conversation/message timestamps. Default: ambient `new Date()` — inject for deterministic SSR/tests. */
+    now?: () => Date;
 }
 /** Options for a single `sendMessage`. */
 interface SendOptions {

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

@@ -157,6 +157,8 @@ interface ConversationConfig {
     generateTitle?: (firstMessage: string) => string;
     /** Threading mode (default 'inline') */
     threadingMode?: ThreadingMode;
+    /** Clock for conversation/message timestamps. Default: ambient `new Date()` — inject for deterministic SSR/tests. */
+    now?: () => Date;
 }
 /** Options for a single `sendMessage`. */
 interface SendOptions {

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

@@ -24,6 +24,8 @@ interface DatePickerProps {
     onOpenChange?: (open: boolean) => void;
     /** The currently displayed month (controlled) */
     currentMonth?: Date;
+    /** Reference "today" for isToday/aria-current and time defaults. Default: ambient `new Date()` — inject to avoid SSR/CSR hydration mismatch. */
+    today?: Date;
 }
 interface DatePickerState {
     open: boolean;

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

@@ -24,6 +24,8 @@ interface DatePickerProps {
     onOpenChange?: (open: boolean) => void;
     /** The currently displayed month (controlled) */
     currentMonth?: Date;
+    /** Reference "today" for isToday/aria-current and time defaults. Default: ambient `new Date()` — inject to avoid SSR/CSR hydration mismatch. */
+    today?: Date;
 }
 interface DatePickerState {
     open: boolean;

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

@@ -1,5 +1,3 @@
-import { AccessibilityProps } from '../shared/index.cjs';
-
 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>;
 }