@refraction-ui/react 0.18.4 → 0.19.1

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

@@ -26,16 +26,24 @@ interface CommandInputOptions {
     onCommandCommit?: (trigger: Trigger, text: string) => void;
     onCommandCancel?: () => void;
 }
+/**
+ * Minimal keyboard-event surface {@link CommandInput.handleKeyDown} needs.
+ * DOM `KeyboardEvent`s and framework synthetic events (e.g. React's) both
+ * satisfy this structurally, so adapters can pass their events without casts.
+ */
+interface CommandKeyEvent {
+    preventDefault(): void;
+}
 declare class CommandInput {
     private state;
     private options;
     constructor(options: CommandInputOptions);
     handleInput(text: string, cursorPosition: number): void;
-    handleKeyDown(key: string, event?: Event): void;
+    handleKeyDown(key: string, event?: CommandKeyEvent): void;
     get value(): InputNode[];
     getState(): CommandInputState;
     private parseInput;
     private notifyStateChange;
 }
 
-export { CommandInput, type CommandInputOptions, type CommandInputState, type CommandNode, type InputNode, type TextNode, type Trigger };
+export { CommandInput, type CommandInputOptions, type CommandInputState, type CommandKeyEvent, type CommandNode, type InputNode, type TextNode, type Trigger };

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

@@ -26,16 +26,24 @@ interface CommandInputOptions {
     onCommandCommit?: (trigger: Trigger, text: string) => void;
     onCommandCancel?: () => void;
 }
+/**
+ * Minimal keyboard-event surface {@link CommandInput.handleKeyDown} needs.
+ * DOM `KeyboardEvent`s and framework synthetic events (e.g. React's) both
+ * satisfy this structurally, so adapters can pass their events without casts.
+ */
+interface CommandKeyEvent {
+    preventDefault(): void;
+}
 declare class CommandInput {
     private state;
     private options;
     constructor(options: CommandInputOptions);
     handleInput(text: string, cursorPosition: number): void;
-    handleKeyDown(key: string, event?: Event): void;
+    handleKeyDown(key: string, event?: CommandKeyEvent): void;
     get value(): InputNode[];
     getState(): CommandInputState;
     private parseInput;
     private notifyStateChange;
 }
 
-export { CommandInput, type CommandInputOptions, type CommandInputState, type CommandNode, type InputNode, type TextNode, type Trigger };
+export { CommandInput, type CommandInputOptions, type CommandInputState, type CommandKeyEvent, 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>;
 }

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/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 */