@omniviewdev/base-ui 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -10,6 +10,7 @@ import { ButtonHTMLAttributes } from 'react';
 import { ChangeEventHandler } from 'react';
 import { Checkbox as Checkbox_2 } from '@base-ui/react/checkbox';
 import { CheckboxGroup as CheckboxGroup_2 } from '@base-ui/react/checkbox-group';
+import { ClipboardEvent as ClipboardEvent_2 } from 'react';
 import { ColumnDef as ColumnDef_2 } from '@tanstack/react-table';
 import { ColumnOrderState } from '@tanstack/react-table';
 import { ColumnPinningState } from '@tanstack/react-table';
@@ -39,13 +40,16 @@ import { FieldDescriptionProps } from '@base-ui/react';
 import { FieldErrorProps } from '@base-ui/react';
 import { FieldLabelProps } from '@base-ui/react';
 import { FieldsetHTMLAttributes } from 'react';
+import { FocusEvent as FocusEvent_2 } from 'react';
 import { ForwardRefExoticComponent } from 'react';
 import { HTMLAttributes } from 'react';
 import { ImgHTMLAttributes } from 'react';
 import { Input as Input_2 } from '@base-ui/react/input';
 import { JSX } from 'react/jsx-runtime';
+import { KeyboardEvent as KeyboardEvent_2 } from 'react';
 import { LabelHTMLAttributes } from 'react';
 import { Menu as Menu_2 } from '@base-ui/react/menu';
+import { MouseEvent as MouseEvent_2 } from 'react';
 import { NamedExoticComponent } from 'react';
 import { NumberField } from '@base-ui/react/number-field';
 import { PaginationState } from '@tanstack/react-table';
@@ -142,7 +146,7 @@ export declare interface AccordionProps extends HTMLAttributes<HTMLDivElement> {
 
 declare const AccordionRoot: ForwardRefExoticComponent<AccordionProps & RefAttributes<HTMLDivElement>>;
 
-export declare type AccordionSize = 'sm' | 'md' | 'lg';
+export declare type AccordionSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 
 export declare type AccordionVariant = 'default' | 'flush';
 
@@ -445,7 +449,7 @@ export declare type AvatarShape = 'circle' | 'rounded';
 
 export declare const Badge: ForwardRefExoticComponent<BadgeProps & RefAttributes<HTMLSpanElement>>;
 
-export declare type BadgeColor = 'neutral' | 'brand' | 'success' | 'warning' | 'danger';
+export declare type BadgeColor = 'neutral' | 'brand' | 'success' | 'warning' | 'danger' | 'discovery' | 'secondary';
 
 export declare type BadgeOverlap = 'rectangular' | 'circular';
 
@@ -467,7 +471,7 @@ export declare interface BadgeProps extends Omit<HTMLAttributes<HTMLSpanElement>
     children: ReactNode;
 }
 
-export declare type BadgeSize = 'sm' | 'md' | 'lg';
+export declare type BadgeSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 
 export declare type BadgeVariant = 'standard' | 'dot';
 
@@ -601,6 +605,28 @@ export declare interface BreadcrumbsProps extends HTMLAttributes<HTMLElement> {
 
 declare const BreadcrumbsRoot: ForwardRefExoticComponent<BreadcrumbsProps & RefAttributes<HTMLElement>>;
 
+/**
+ * Build an ordered array of `Section`s for the given mode/locale/options.
+ *
+ * Uses `Intl.DateTimeFormat(locale).formatToParts(<representative date>)` to establish
+ * the display order (e.g. `en-US` -> month/day/year, `en-GB` -> day/month/year).
+ */
+export declare function buildSections(options: BuildSectionsOptions): Section[];
+
+export declare interface BuildSectionsOptions {
+    mode: 'date' | 'time' | 'datetime';
+    locale?: string;
+    hourCycle?: 12 | 24;
+    showSeconds?: boolean;
+    /** Optional current value used to seed section content. */
+    value?: Date | null;
+}
+
+export declare const BUILT_IN_THEME_MODES: readonly BuiltInThemeMode[];
+
+/** The built-in modes that a custom theme can inherit from. */
+export declare type BuiltInThemeMode = 'dark' | 'light' | 'high-contrast-dark' | 'high-contrast-light' | 'obsidian' | 'carbon' | 'void';
+
 export declare const Button: ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & RefAttributes<HTMLElement>>;
 
 export declare const ButtonGroup: ButtonGroupCompound;
@@ -632,6 +658,36 @@ export declare interface ButtonProps extends Button_2.Props, StyledComponentProp
     endDecorator?: ReactNode;
 }
 
+export declare function Calendar(props: CalendarProps): JSX.Element;
+
+declare type CalendarBaseProps = {
+    min?: Date;
+    max?: Date;
+    isDateDisabled?: (date: Date) => boolean;
+    locale?: string;
+    weekStartsOn?: WeekStart;
+    autoFocus?: boolean;
+    className?: string;
+};
+
+export declare type CalendarProps = CalendarSingleProps | CalendarRangeProps;
+
+declare type CalendarRangeProps = CalendarBaseProps & {
+    mode: 'range';
+    startDate: Date | null;
+    endDate: Date | null;
+    onRangeChange: (range: {
+        start: Date | null;
+        end: Date | null;
+    }) => void;
+};
+
+declare type CalendarSingleProps = CalendarBaseProps & {
+    mode?: 'single';
+    value: Date | null;
+    onChange: (value: Date) => void;
+};
+
 export declare const Caption: <C extends CaptionElement = "span">(props: TypographyBaseProps & TruncationProps & {
     as?: C | undefined;
 } & Omit<PropsWithoutRef<ComponentProps<C>>, "color" | "as" | "truncate" | keyof TypographyBaseProps> & {
@@ -937,6 +993,8 @@ export declare interface CollapsibleTriggerProps extends HTMLAttributes<HTMLButt
     children: ReactNode;
 }
 
+declare type ColorTokenKey = 'color.accent.soft' | 'color.accent.strong' | 'color.ansi.black' | 'color.ansi.blue' | 'color.ansi.bright.black' | 'color.ansi.bright.blue' | 'color.ansi.bright.cyan' | 'color.ansi.bright.green' | 'color.ansi.bright.magenta' | 'color.ansi.bright.red' | 'color.ansi.bright.white' | 'color.ansi.bright.yellow' | 'color.ansi.cyan' | 'color.ansi.green' | 'color.ansi.magenta' | 'color.ansi.red' | 'color.ansi.white' | 'color.ansi.yellow' | 'color.bg.base' | 'color.bg.elevated' | 'color.bg.inset' | 'color.bg.surface' | 'color.bg.surface.overlay' | 'color.bg.surface.raised' | 'color.border.default' | 'color.border.focus' | 'color.border.muted' | 'color.border.strong' | 'color.brand.300' | 'color.brand.400' | 'color.brand.500' | 'color.danger' | 'color.danger.soft' | 'color.datepicker.cell.bg' | 'color.datepicker.cell.bg.hover' | 'color.datepicker.cell.bg.selected' | 'color.datepicker.cell.bg.today' | 'color.datepicker.cell.fg' | 'color.datepicker.cell.fg.disabled' | 'color.datepicker.cell.fg.other.month' | 'color.datepicker.cell.fg.selected' | 'color.datepicker.cell.fg.today' | 'color.datepicker.header.bg' | 'color.diff.insert.bg' | 'color.diff.remove.bg' | 'color.discovery' | 'color.discovery.soft' | 'color.drawer.handle' | 'color.drawer.handle.hover' | 'color.editor.bg' | 'color.editor.bracket.1' | 'color.editor.bracket.2' | 'color.editor.bracket.3' | 'color.editor.bracket.4' | 'color.editor.bracket.5' | 'color.editor.bracket.6' | 'color.editor.bracket.match.bg' | 'color.editor.bracket.match.border' | 'color.editor.cursor' | 'color.editor.fg' | 'color.editor.find.match.bg' | 'color.editor.find.match.border' | 'color.editor.find.range.bg' | 'color.editor.group.bg' | 'color.editor.group.border' | 'color.editor.group.drop.border' | 'color.editor.group.header.bg' | 'color.editor.indent.guide' | 'color.editor.indent.guide.active' | 'color.editor.line.highlight.bg' | 'color.editor.line.highlight.border' | 'color.editor.line.number' | 'color.editor.line.number.active' | 'color.editor.link' | 'color.editor.ruler' | 'color.editor.selection.bg' | 'color.editor.selection.inactive.bg' | 'color.editor.whitespace' | 'color.fg.default' | 'color.fg.disabled' | 'color.fg.inverse' | 'color.fg.muted' | 'color.fg.subtle' | 'color.gutter.added' | 'color.gutter.bg' | 'color.gutter.deleted' | 'color.gutter.modified' | 'color.info' | 'color.info.soft' | 'color.minimap.bg' | 'color.minimap.error' | 'color.minimap.find.match' | 'color.minimap.selection' | 'color.minimap.warning' | 'color.progress.fill' | 'color.progress.track' | 'color.scrollarea.thumb' | 'color.scrollarea.thumb.hover' | 'color.scrollarea.track' | 'color.secondary' | 'color.secondary.soft' | 'color.state.focus.ring' | 'color.state.hover' | 'color.state.pressed' | 'color.state.selected' | 'color.success' | 'color.success.soft' | 'color.tab.active.bg' | 'color.tab.active.border' | 'color.tab.active.fg' | 'color.tab.bg' | 'color.tab.border' | 'color.tab.fg' | 'color.tab.hover.bg' | 'color.tab.hover.fg' | 'color.tab.inactive.bg' | 'color.tab.inactive.fg' | 'color.tab.modified.border' | 'color.terminal.bg' | 'color.terminal.border' | 'color.terminal.cursor' | 'color.terminal.fg' | 'color.terminal.selection.bg' | 'color.terminal.selection.fg' | 'color.warning' | 'color.warning.soft';
+
 export declare interface ColumnDef {
     /** Unique column identifier, used for Cell matching and sort callbacks */
     id: string;
@@ -950,6 +1008,11 @@ export declare interface ColumnDef {
     sortable?: boolean;
 }
 
+export declare interface ColumnItem {
+    value: number | string;
+    label: string;
+}
+
 export declare const Combobox: ComboboxCompound;
 
 declare const ComboboxChip: ForwardRefExoticComponent<ComboboxChipProps & RefAttributes<HTMLDivElement>>;
@@ -1194,9 +1257,9 @@ declare interface CommandListStoreSnapshot {
     loading: boolean;
 }
 
-export declare type ComponentColor = 'neutral' | 'brand' | 'success' | 'warning' | 'danger' | 'info';
+export declare type ComponentColor = 'neutral' | 'brand' | 'success' | 'warning' | 'danger' | 'info' | 'discovery' | 'secondary';
 
-export declare type ComponentSize = 'sm' | 'md' | 'lg';
+export declare type ComponentSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 
 export declare type ComponentVariant = 'solid' | 'soft' | 'outline' | 'ghost';
 
@@ -1310,6 +1373,8 @@ declare const ContextMenuTrigger: ForwardRefExoticComponent<ContextMenuTriggerPr
 export declare interface ContextMenuTriggerProps extends Omit<ComponentPropsWithoutRef<typeof ContextMenu_2.Trigger>, 'color'>, StyledComponentProps {
 }
 
+export declare function createThemeRegistry(): ThemeRegistry;
+
 export declare const DataTable: DataTableCompound;
 
 declare const DataTableBody: ForwardRefExoticComponent<DataTableBodyProps & RefAttributes<HTMLTableSectionElement>>;
@@ -1419,6 +1484,112 @@ export declare interface DataTableVirtualBodyProps extends HTMLAttributes<HTMLTa
     fixedRowHeight?: boolean;
 }
 
+/**
+ * `DateField` — a sectioned, guided input for date/time entry. Each section
+ * (MM, DD, YYYY, HH, mm, ss, AM/PM) is individually editable and validated.
+ *
+ * The component is a thin wrapper over `useDateField`; consumers who need
+ * custom layouts can reach for the hook directly.
+ */
+export declare const DateField: ForwardRefExoticComponent<DateFieldProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface DateFieldProps {
+    value?: Date | null;
+    onChange?: (value: Date | null) => void;
+    mode?: 'date' | 'time' | 'datetime';
+    locale?: string;
+    hourCycle?: 12 | 24;
+    showSeconds?: boolean;
+    min?: Date;
+    max?: Date;
+    disabled?: boolean;
+    readOnly?: boolean;
+    className?: string;
+    'aria-label'?: string;
+    /**
+     * When true, removes the input-shell styling (border, background, padding,
+     * min-height, hover, focus-within ring) so the field can be embedded inside
+     * an outer shell (e.g. a picker trigger) without doubling the border.
+     */
+    bare?: boolean;
+}
+
+declare type DateFormat = Intl.DateTimeFormatOptions | ((date: Date) => string);
+
+export declare function DatePicker(props: DatePickerProps): JSX.Element;
+
+export declare namespace DatePicker {
+    var Calendar: Calendar;
+}
+
+export declare interface DatePickerProps extends StyledComponentProps {
+    value?: Date | null;
+    defaultValue?: Date | null;
+    onChange?: (value: Date | null) => void;
+    min?: Date;
+    max?: Date;
+    isDateDisabled?: (date: Date) => boolean;
+    /** @deprecated Ignored for the trigger display; DateField uses Intl locale formatting. Kept for API stability. */
+    format?: DateFormat;
+    locale?: string;
+    /** @deprecated DateField renders per-section placeholders. Kept for API stability. */
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    weekStartsOn?: WeekStart;
+    className?: string;
+}
+
+export declare interface DateRange {
+    start: Date | null;
+    end: Date | null;
+}
+
+export declare function DateRangePicker(props: DateRangePickerProps): JSX.Element;
+
+export declare interface DateRangePickerProps extends StyledComponentProps {
+    value?: DateRange;
+    defaultValue?: DateRange;
+    onChange?: (value: DateRange) => void;
+    min?: Date;
+    max?: Date;
+    isDateDisabled?: (date: Date) => boolean;
+    /** @deprecated Ignored for the trigger display; DateField uses Intl locale formatting. Kept for API stability. */
+    format?: DateFormat;
+    locale?: string;
+    /** @deprecated DateField renders per-section placeholders. Kept for API stability. */
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    weekStartsOn?: WeekStart;
+    className?: string;
+    /** Separator rendered between the start and end DateFields. Default: " – " (en dash with spaces). */
+    rangeSeparator?: string;
+}
+
+export declare function DateTimePicker(props: DateTimePickerProps): JSX.Element;
+
+export declare interface DateTimePickerProps extends StyledComponentProps {
+    value?: Date | null;
+    defaultValue?: Date | null;
+    onChange?: (value: Date | null) => void;
+    min?: Date;
+    max?: Date;
+    isDateDisabled?: (date: Date) => boolean;
+    /** @deprecated Ignored for the trigger display; DateField uses Intl locale formatting. Kept for API stability. */
+    format?: DateFormat;
+    locale?: string;
+    /** @deprecated DateField renders per-section placeholders. Kept for API stability. */
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    weekStartsOn?: WeekStart;
+    showSeconds?: boolean;
+    hourCycle?: 12 | 24;
+    minuteStep?: number;
+    className?: string;
+}
+
 declare interface DebouncedFunction<TArgs extends unknown[], TReturn> {
     (...args: TArgs): void;
     cancel: () => void;
@@ -1470,7 +1641,7 @@ export declare type DescriptionListLayout = 'horizontal' | 'vertical' | 'grid';
 export declare interface DescriptionListProps extends HTMLAttributes<HTMLDListElement> {
     layout?: DescriptionListLayout;
     columns?: DescriptionListColumns;
-    size?: 'sm' | 'md' | 'lg';
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 }
 
 declare const DescriptionListRoot: ForwardRefExoticComponent<DescriptionListProps & RefAttributes<HTMLDListElement>>;
@@ -2002,6 +2173,12 @@ export declare interface FormSectionProps extends FieldsetHTMLAttributes<HTMLFie
     description?: string;
 }
 
+/**
+ * Number of days in `month` (1-12) for `year`.
+ * If `year` is not supplied (NaN), assume non-leap behaviour for February (28).
+ */
+export declare function getDaysInMonth(year: number, month: number): number;
+
 export declare const Grid: GridCompound;
 
 declare interface GridBaseProps extends HTMLAttributes<HTMLDivElement> {
@@ -2081,7 +2258,6 @@ export declare const IconButton: ForwardRefExoticComponent<Omit<IconButtonProps,
 
 export declare interface IconButtonProps extends Omit<ButtonProps, 'children'> {
     children: ReactNode;
-    dense?: boolean;
 }
 
 declare const Image_2: NamedExoticComponent<ImageProps & RefAttributes<HTMLImageElement>>;
@@ -2161,6 +2337,9 @@ declare const InputRoot: ForwardRefExoticComponent<Omit<InputRootProps, "ref"> &
 export declare interface InputRootProps extends Field.Root.Props, StyledComponentProps {
 }
 
+/** True if the `year` is a leap year (Gregorian calendar). */
+export declare function isLeapYear(year: number): boolean;
+
 export declare interface ItemState {
     isSelected: boolean;
     isActive: boolean;
@@ -2872,6 +3051,63 @@ export declare interface SearchInputProps extends Omit<InputControlProps, 'start
 
 declare const SecondarySidebar: ForwardRefExoticComponent<AppShellSecondarySidebarProps & RefAttributes<HTMLElement>>;
 
+export declare interface Section {
+    type: SectionType;
+    /** Raw typed value or '' if empty */
+    value: string;
+    /** Placeholder shown when value is empty */
+    placeholder: string;
+    /** For digit sections: expected length (e.g. 2 for MM, 4 for YYYY). null for literal/meridiem. */
+    maxLength: number | null;
+    /** Inclusive min/max for validation (e.g. month = 1..12). null for literal/meridiem. */
+    min: number | null;
+    max: number | null;
+    /**
+     * Hour cycle (12 or 24). Set on hour sections only; undefined otherwise.
+     * Validation reads this flag to decide whether meridiem is required, rather
+     * than re-inferring from `max === 12`.
+     */
+    hourCycle?: 12 | 24;
+}
+
+export declare interface SectionDomProps {
+    /** Tag whether this section is currently focused. */
+    'data-focused': '' | undefined;
+    /** True when the value is empty (placeholder shown). */
+    'data-placeholder': '' | undefined;
+    /** True when this is a literal (separator) span — not editable. */
+    'data-literal': '' | undefined;
+    /** 0-based section index, for testing + delegation. */
+    'data-section-index': number;
+    /** Section type, for testing + delegation. */
+    'data-section-type': Section['type'];
+    role?: string;
+    'aria-label'?: string;
+    'aria-readonly'?: boolean;
+    'aria-hidden'?: boolean;
+    contentEditable?: 'true' | 'false' | 'plaintext-only';
+    suppressContentEditableWarning?: boolean;
+    tabIndex?: number;
+    spellCheck?: boolean;
+    autoCorrect?: string;
+    inputMode?: 'numeric' | 'text' | 'none';
+    onClick?: (e: MouseEvent_2<HTMLElement>) => void;
+    onFocus?: (e: FocusEvent_2<HTMLElement>) => void;
+    onBlur?: (e: FocusEvent_2<HTMLElement>) => void;
+    onKeyDown?: (e: KeyboardEvent_2<HTMLElement>) => void;
+    onBeforeInput?: (e: React.SyntheticEvent<HTMLElement>) => void;
+}
+
+/**
+ * Section model + pure helpers for the DateField primitive.
+ *
+ * Inspired by MUI X's `useField`, adapted for our constraints:
+ *  - Native `Date` (no adapter)
+ *  - `Intl.DateTimeFormatToParts` for format tokenization
+ *  - Simpler scope: skip localized digits, RTL reordering, adapters
+ */
+export declare type SectionType = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'meridiem' | 'literal';
+
 export declare const SegmentedControl: SegmentedControlCompound;
 
 declare type SegmentedControlCompound = typeof SegmentedControlRoot & {
@@ -3101,7 +3337,7 @@ export declare interface SkeletonProps extends HTMLAttributes<HTMLDivElement> {
     size?: SkeletonSize;
 }
 
-declare type SkeletonSize = 'sm' | 'md' | 'lg';
+declare type SkeletonSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 
 export declare type SkeletonVariant = 'text' | 'circular' | 'rectangular' | 'rounded';
 
@@ -3198,7 +3434,7 @@ export declare interface SplitButtonActionProps extends Omit<React.ButtonHTMLAtt
     disabled?: boolean;
 }
 
-declare type SplitButtonColor = 'neutral' | 'brand' | 'success' | 'warning' | 'danger';
+declare type SplitButtonColor = 'neutral' | 'brand' | 'success' | 'warning' | 'danger' | 'info' | 'discovery' | 'secondary';
 
 declare type SplitButtonCompound = typeof SplitButtonRoot & {
     Action: typeof SplitButtonAction;
@@ -3360,7 +3596,7 @@ export declare interface StatusDotProps extends HTMLAttributes<HTMLSpanElement>
     pulse?: boolean;
     /** Controls the visual intensity of the pulse animation. */
     pulseIntensity?: StatusDotPulseIntensity;
-    size?: 'sm' | 'md' | 'lg';
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 }
 
 export declare type StatusDotPulseIntensity = 'subtle' | 'default' | 'strong';
@@ -3472,6 +3708,8 @@ declare const SwitchThumb: ForwardRefExoticComponent<SwitchThumbProps & RefAttri
 export declare interface SwitchThumbProps extends Omit<ComponentPropsWithoutRef<typeof Switch_2.Thumb>, 'color'>, StyledComponentProps {
 }
 
+declare type SyntaxTokenKey = 'syntax.class' | 'syntax.comment' | 'syntax.decorator' | 'syntax.function' | 'syntax.interface' | 'syntax.keyword' | 'syntax.keyword.control' | 'syntax.keyword.operator' | 'syntax.method' | 'syntax.namespace' | 'syntax.number' | 'syntax.operator' | 'syntax.parameter' | 'syntax.property' | 'syntax.punctuation' | 'syntax.regexp' | 'syntax.string' | 'syntax.string.escape' | 'syntax.style.comment' | 'syntax.style.function' | 'syntax.style.keyword' | 'syntax.style.type' | 'syntax.type' | 'syntax.variable';
+
 export declare type TabDescriptor = {
     id: TabId;
     title: string;
@@ -3640,7 +3878,9 @@ export declare interface TabsRootProps extends Tabs_2.Root.Props, Omit<StyledCom
 declare const TabsTab: ForwardRefExoticComponent<Omit<TabsTabProps, "ref"> & RefAttributes<HTMLButtonElement>>;
 
 export declare type TabsTabProps = Tabs_2.Tab.Props & {
-    /** Slot rendered after the tab label (e.g. Badge, icon, count) */
+    /** Slot rendered before the tab label (e.g. icon) */
+    startDecorator?: ReactNode;
+    /** Slot rendered after the tab label (e.g. Badge, count) */
     endDecorator?: ReactNode;
 };
 
@@ -3671,6 +3911,8 @@ export declare interface TagInputProps extends Omit<HTMLAttributes<HTMLDivElemen
     inputProps?: React.InputHTMLAttributes<HTMLInputElement>;
 }
 
+declare type TerminalTokenKey = never;
+
 declare const Text_2: TextComponent;
 export { Text_2 as Text }
 
@@ -3758,9 +4000,39 @@ export declare interface ThemeContextValue extends ThemeState {
     setMotion: (motion: ThemeMotion) => void;
 }
 
+export declare interface ThemeDefinition {
+    /** Stable identifier, used for persistence and activation. */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** The built-in mode this theme inherits from. */
+    base: BuiltInThemeMode;
+    /** Optional author metadata. */
+    author?: string;
+    /** Optional version string. */
+    version?: string;
+    /** UI chrome color overrides, keyed by dotted token path. */
+    colors?: Partial<Record<ColorTokenKey, string>>;
+    /** Syntax highlighting overrides. */
+    syntax?: Partial<Record<SyntaxTokenKey, string>>;
+    /** Terminal ANSI palette overrides. */
+    terminal?: Partial<Record<TerminalTokenKey, string>>;
+}
+
 export declare type ThemeDensity = 'compact' | 'comfortable';
 
-export declare type ThemeMode = 'dark' | 'light' | 'high-contrast-dark' | 'high-contrast-light' | 'obsidian' | 'carbon' | 'void';
+export declare interface ThemeInfo {
+    id: string;
+    name: string;
+    base: BuiltInThemeMode;
+    builtIn: boolean;
+}
+
+/**
+ * A theme identifier. Built-in mode ids autocomplete; any registered custom
+ * theme id is also accepted.
+ */
+export declare type ThemeMode = BuiltInThemeMode | (string & {});
 
 export declare type ThemeMotion = 'normal' | 'reduced';
 
@@ -3773,6 +4045,33 @@ export declare interface ThemeProviderProps extends PropsWithChildren {
     persist?: boolean;
 }
 
+export declare interface ThemeRegistry {
+    register(theme: ThemeDefinition): void;
+    unregister(id: string): void;
+    get(id: string): ThemeDefinition | undefined;
+    list(): ThemeInfo[];
+    has(id: string): boolean;
+    apply(id: string): void;
+    active(): string | null;
+    subscribe(listener: ThemeRegistryListener): () => void;
+}
+
+/** Module-level singleton. */
+export declare const themeRegistry: ThemeRegistry;
+
+export declare type ThemeRegistryEvent = {
+    type: 'registered';
+    id: string;
+} | {
+    type: 'unregistered';
+    id: string;
+} | {
+    type: 'applied';
+    id: string;
+};
+
+export declare type ThemeRegistryListener = (event: ThemeRegistryEvent) => void;
+
 export declare interface ThemeState {
     theme: ThemeMode;
     density: ThemeDensity;
@@ -3785,6 +4084,21 @@ export declare interface ThemeSwitcherProps {
     className?: string;
 }
 
+export declare function TimeColumns({ value, onChange, hourCycle, showSeconds, minuteStep, disabled, readOnly, className, }: TimeColumnsProps): JSX.Element;
+
+export declare interface TimeColumnsProps {
+    value: Date;
+    onChange: (next: Date) => void;
+    hourCycle?: 12 | 24;
+    showSeconds?: boolean;
+    minuteStep?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    className?: string;
+    /** Auto-scroll columns so selected item is visible on mount. Default true. */
+    autoScroll?: boolean;
+}
+
 export declare const Timeline: TimelineCompound;
 
 declare type TimelineCompound = typeof TimelineRoot & {
@@ -3823,6 +4137,21 @@ export declare interface TimelineProps extends HTMLAttributes<HTMLDivElement> {
 
 declare const TimelineRoot: ForwardRefExoticComponent<TimelineProps & RefAttributes<HTMLDivElement>>;
 
+export declare function TimePicker(props: TimePickerProps): JSX.Element;
+
+export declare interface TimePickerProps extends StyledComponentProps {
+    value?: Date | null;
+    defaultValue?: Date | null;
+    onChange?: (value: Date) => void;
+    showSeconds?: boolean;
+    hourCycle?: 12 | 24;
+    minuteStep?: number;
+    disabled?: boolean;
+    readOnly?: boolean;
+    className?: string;
+    'aria-label'?: string;
+}
+
 declare interface ToastContextValue {
     toast: (message: string, options?: ToastOptions) => string;
     dismiss: (id: string) => void;
@@ -4272,6 +4601,50 @@ export declare interface UseDataTableOptions<TData> {
  */
 export declare function useDataTablePersistence(table: Table_2<any>, key: string | undefined): void;
 
+/**
+ * `useDateField` is the headless hook driving the sectioned input primitive.
+ * It maintains section state derived from (locale, mode, value), handles
+ * keyboard + paste, and calls `onChange` with a parsed Date when the sections
+ * represent a complete valid datetime.
+ */
+export declare function useDateField(options: UseDateFieldOptions): UseDateFieldReturn;
+
+export declare interface UseDateFieldOptions {
+    value: Date | null;
+    onChange?: (value: Date | null) => void;
+    mode: 'date' | 'time' | 'datetime';
+    locale?: string;
+    hourCycle?: 12 | 24;
+    showSeconds?: boolean;
+    min?: Date;
+    max?: Date;
+    disabled?: boolean;
+    readOnly?: boolean;
+}
+
+export declare interface UseDateFieldReturn {
+    /** Current sections (derived from options + user edits). */
+    sections: Section[];
+    /** 0-based index of the currently focused section, or null. */
+    focusedIndex: number | null;
+    /** Whether the current section state represents a complete valid date. */
+    isValid: boolean;
+    /** Spread these onto the root element. */
+    rootProps: {
+        role: 'group';
+        'aria-disabled': boolean | undefined;
+        onKeyDown: (e: KeyboardEvent_2<HTMLElement>) => void;
+        onPaste: (e: ClipboardEvent_2<HTMLElement>) => void;
+        onBlur: (e: FocusEvent_2<HTMLElement>) => void;
+    };
+    /** Returns per-section DOM props for the editable section span. */
+    getSectionProps: (index: number) => SectionDomProps;
+    /** Register a ref for a section's DOM element (callback ref). */
+    registerSectionRef: (index: number) => (el: HTMLElement | null) => void;
+    /** Programmatically focus a section by index. */
+    focusSection: (index: number) => void;
+}
+
 /**
  * Returns a debounced version of the callback that only fires after `delay` ms
  * of no invocations. Includes `cancel()` and `flush()` methods.
@@ -4368,6 +4741,16 @@ export declare function useTabDragBroker(): TabDragBrokerValue | null;
 
 export declare function useTheme(): ThemeContextValue;
 
+/**
+ * React hook that returns the current list of registered themes (built-in +
+ * custom) and re-renders the calling component whenever a theme is
+ * registered or unregistered.
+ */
+export declare function useThemeList(): readonly ThemeInfo[];
+
+/** Returns the module-level theme registry singleton. */
+export declare function useThemeRegistry(): ThemeRegistry;
+
 export declare function useToast(): ToastContextValue;
 
 export declare function useTreeActions(): TreeActionsContextValue;
@@ -4389,4 +4772,21 @@ export declare function useTreeStoreContext(): TreeStore;
 /** Validation function. Return a FieldErrors map (empty or all-undefined = valid). */
 export declare type ValidateItem = (key: Key, values: Record<string, string>) => FieldErrors | Promise<FieldErrors>;
 
+/**
+ * Validate + parse sections into a Date.
+ * Returns `{ valid: false, date: null, incomplete: true }` when any required section is empty.
+ */
+export declare function validateSections(sections: Section[]): ValidateSectionsResult;
+
+export declare interface ValidateSectionsResult {
+    /** True when all non-literal sections are populated AND valid. */
+    valid: boolean;
+    /** Parsed Date on success, null on failure or incompleteness. */
+    date: Date | null;
+    /** True if ANY section is empty (different from "invalid"). */
+    incomplete: boolean;
+}
+
+declare type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+
 export { }