themelia-react-ui 0.0.0-stage → 1.0.0

package/dist/components/features/schema-form/schema-form.types.d.ts

@@ -0,0 +1,271 @@
+import type { LucideIcon } from 'lucide-react';
+import type { FormEvent, ReactNode } from 'react';
+import type { CardCheckboxGroupProps, CardRadioGroupProps, SelectProps, SwitchCardProps, ToggleFieldProps } from '../../base/choice-inputs';
+import type { InputProps, TextareaProps } from '../../base/text-inputs';
+import type { TagsInputProps } from '../../base/value-inputs';
+import type { DecimalInputProps } from '../../base/forms-numeric';
+import type { StringsProp } from '../../../lib/strings';
+import type { SchemaFormStrings } from './schema-form.strings';
+export type SchemaFormPrimitiveValue = string | number | boolean | null;
+export type SchemaFormStructuredValue = SchemaFormPrimitiveValue | SchemaFormPrimitiveValue[] | Record<string, unknown> | unknown[];
+export type SchemaFormValue = SchemaFormStructuredValue | undefined;
+export type SchemaFormValues = Record<string, SchemaFormValue>;
+export type SchemaFormErrors = Record<string, string | undefined>;
+export type SchemaFormLayout = 'form' | 'cards';
+export type SchemaFormFieldWidth = 'auto' | 'half' | 'third' | 'full';
+export type SchemaFormFieldType = 'text' | 'email' | 'password' | 'url' | 'tel' | 'search' | 'textarea' | 'number' | 'integer' | 'decimal' | 'select' | 'radio-cards' | 'checkbox-cards' | 'tags' | 'switch' | 'json' | 'custom';
+export interface SchemaFormOption {
+    /** Current field values. Controlled. */
+    value: string;
+    /** Display label. */
+    label: string;
+    /** Supporting copy shown under the label. */
+    description?: string;
+    /** Leading glyph. */
+    icon?: LucideIcon;
+    /** Renders the entry as unselectable. */
+    disabled?: boolean;
+}
+export type SchemaFormValidator = (value: SchemaFormValue, values: SchemaFormValues, field: SchemaFormField) => true | string | null | undefined;
+export interface SchemaFormFieldBase {
+    key: string;
+    type?: SchemaFormFieldType;
+    /** Display label. */
+    label: string;
+    /** Supporting copy shown under the label. */
+    description?: string;
+    hint?: string;
+    helperText?: string;
+    placeholder?: string;
+    /** Marks the field required. */
+    required?: boolean;
+    /** Renders the entry as unselectable. */
+    disabled?: boolean | ((values: SchemaFormValues) => boolean);
+    hidden?: boolean | ((values: SchemaFormValues) => boolean);
+    /** Initial field values for uncontrolled use. */
+    defaultValue?: SchemaFormValue;
+    sectionId?: string;
+    width?: SchemaFormFieldWidth;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Merged onto the control. */
+    controlClassName?: string;
+    validate?: SchemaFormValidator | SchemaFormValidator[];
+    formatValue?: (value: SchemaFormValue, values: SchemaFormValues) => string;
+    parseValue?: (value: string, values: SchemaFormValues) => SchemaFormValue;
+    meta?: Record<string, unknown>;
+}
+type ControlledInputProps = Omit<InputProps, 'value' | 'defaultValue' | 'onChange' | 'invalid' | 'name' | 'required' | 'disabled' | 'placeholder' | 'type'>;
+type ControlledTextareaProps = Omit<TextareaProps, 'value' | 'defaultValue' | 'onChange' | 'invalid' | 'name' | 'required' | 'disabled' | 'placeholder'>;
+type ControlledDecimalInputProps = Omit<DecimalInputProps, 'value' | 'defaultValue' | 'onChange' | 'invalid' | 'name' | 'required' | 'disabled' | 'placeholder'>;
+type ControlledSelectProps = Omit<SelectProps, 'options' | 'value' | 'defaultValue' | 'onChange' | 'onValueChange' | 'invalid' | 'name' | 'required' | 'disabled' | 'placeholder'>;
+type ControlledCardRadioGroupProps = Omit<CardRadioGroupProps, 'options' | 'value' | 'defaultValue' | 'onChange' | 'invalid' | 'name' | 'disabled'>;
+type ControlledCardCheckboxGroupProps = Omit<CardCheckboxGroupProps, 'options' | 'value' | 'defaultValue' | 'onChange' | 'invalid' | 'name' | 'disabled'>;
+type ControlledTagsInputProps = Omit<TagsInputProps<string>, 'value' | 'onChange' | 'invalid' | 'disabled' | 'placeholder'>;
+type ControlledToggleFieldProps = Omit<ToggleFieldProps, 'label' | 'description' | 'value' | 'defaultValue' | 'onChange' | 'invalid' | 'name' | 'disabled'>;
+type ControlledSwitchCardProps = Omit<SwitchCardProps, 'label' | 'description' | 'hint' | 'value' | 'defaultValue' | 'onChange' | 'invalid' | 'name' | 'disabled'>;
+export interface SchemaFormTextField extends SchemaFormFieldBase {
+    type?: 'text' | 'email' | 'password' | 'url' | 'tel' | 'search';
+    inputProps?: ControlledInputProps;
+}
+export interface SchemaFormTextareaField extends SchemaFormFieldBase {
+    type: 'textarea';
+    /** Rows to render. */
+    rows?: number;
+    textareaProps?: ControlledTextareaProps;
+}
+export interface SchemaFormNumberField extends SchemaFormFieldBase {
+    type: 'number' | 'integer' | 'decimal';
+    min?: number;
+    max?: number;
+    step?: number;
+    decimalPlaces?: number;
+    numberProps?: ControlledDecimalInputProps;
+}
+export interface SchemaFormSelectField extends SchemaFormFieldBase {
+    type: 'select';
+    options: SchemaFormOption[];
+    allowClear?: boolean;
+    selectProps?: ControlledSelectProps;
+}
+export interface SchemaFormRadioCardsField extends SchemaFormFieldBase {
+    type: 'radio-cards';
+    options: SchemaFormOption[];
+    /** Column definitions, in display order. */
+    columns?: 1 | 2 | 3 | 4;
+    radioProps?: ControlledCardRadioGroupProps;
+}
+export interface SchemaFormCheckboxCardsField extends SchemaFormFieldBase {
+    type: 'checkbox-cards';
+    options: SchemaFormOption[];
+    /** Column definitions, in display order. */
+    columns?: 1 | 2 | 3 | 4;
+    checkboxProps?: ControlledCardCheckboxGroupProps;
+}
+export interface SchemaFormTagsField extends SchemaFormFieldBase {
+    type: 'tags';
+    recommendations?: string[];
+    maxTags?: number;
+    tagsProps?: ControlledTagsInputProps;
+}
+export interface SchemaFormSwitchField extends SchemaFormFieldBase {
+    type: 'switch';
+    switchStyle?: 'row' | 'card';
+    switchProps?: ControlledToggleFieldProps;
+    switchCardProps?: ControlledSwitchCardProps;
+}
+export interface SchemaFormJsonField extends SchemaFormFieldBase {
+    type: 'json';
+    /** Rows to render. */
+    rows?: number;
+    jsonIndent?: number;
+    textareaProps?: ControlledTextareaProps;
+}
+export interface SchemaFormCustomField extends SchemaFormFieldBase {
+    type: 'custom';
+    render: SchemaFormFieldRender;
+}
+export type SchemaFormField = SchemaFormTextField | SchemaFormTextareaField | SchemaFormNumberField | SchemaFormSelectField | SchemaFormRadioCardsField | SchemaFormCheckboxCardsField | SchemaFormTagsField | SchemaFormSwitchField | SchemaFormJsonField | SchemaFormCustomField;
+export interface SchemaFormSection {
+    /** Stable identity for this entry. */
+    id: string;
+    /** Surface title. */
+    title?: ReactNode;
+    /** Supporting copy shown under the label. */
+    description?: ReactNode;
+    /** Leading glyph. */
+    icon?: ReactNode;
+    fields?: string[];
+    /** How many columns the grid layout uses. */
+    columns?: 1 | 2 | 3;
+    /** Content rendered in the footer. */
+    footerSlot?: ReactNode;
+    /** Merged onto the outermost node. */
+    className?: string;
+}
+export interface SchemaFormSchema {
+    /** Surface title. */
+    title?: ReactNode;
+    /** Supporting copy shown under the label. */
+    description?: ReactNode;
+    sections?: SchemaFormSection[];
+    fields: SchemaFormField[];
+}
+export interface SchemaFormFieldContext {
+    /** Definition of the field to render. */
+    field: SchemaFormField;
+    /** Current field values. Controlled. */
+    value: SchemaFormValue;
+    /** Current form values, for fields whose visibility depends on siblings. */
+    values: SchemaFormValues;
+    /** Validation message for this field. */
+    error?: string;
+    /** Renders the entry as unselectable. */
+    disabled: boolean;
+    /** Marks the field required. */
+    required: boolean;
+    /** DOM id linking the control to its label. */
+    fieldId: string;
+    onValueChange: (value: SchemaFormValue) => void;
+    onError?: (error: unknown) => void;
+}
+export type SchemaFormFieldRender = (context: SchemaFormFieldContext) => ReactNode;
+export interface SchemaFormRenderFieldContext extends SchemaFormFieldContext {
+    defaultField: ReactNode;
+}
+export interface SchemaFormRenderSectionContext {
+    section: ResolvedSchemaFormSection;
+    fields: ReactNode;
+    /** Current form values, for fields whose visibility depends on siblings. */
+    values: SchemaFormValues;
+}
+export interface ResolvedSchemaFormSection {
+    /** Stable identity for this entry. */
+    id: string;
+    /** Surface title. */
+    title?: ReactNode;
+    /** Supporting copy shown under the label. */
+    description?: ReactNode;
+    /** Leading glyph. */
+    icon?: ReactNode;
+    fields: SchemaFormField[];
+    /** Column definitions, in display order. */
+    columns: 1 | 2 | 3;
+    /** Content rendered in the footer. */
+    footerSlot?: ReactNode;
+    /** Merged onto the outermost node. */
+    className?: string;
+}
+export interface SchemaFormSubmitHelpers {
+    setFieldValue: (key: string, value: SchemaFormValue) => void;
+    setValues: (values: SchemaFormValues) => void;
+    reset: () => SchemaFormValues;
+    validate: () => boolean;
+}
+export interface SchemaFormProps {
+    /** Field definitions the form renders and validates against. */
+    schema: SchemaFormSchema;
+    /** Current field values. Controlled. */
+    value?: SchemaFormValues;
+    /** Initial field values for uncontrolled use. */
+    defaultValue?: SchemaFormValues;
+    /** Validation messages keyed by field key. */
+    errors?: SchemaFormErrors;
+    /** Renders the entry as unselectable. */
+    disabled?: boolean;
+    /** How fields are arranged — stacked, grid, or sectioned. */
+    layout?: SchemaFormLayout;
+    /** Column definitions, in display order. */
+    columns?: 1 | 2 | 3;
+    /** Stable identity for this entry. */
+    id?: string;
+    /** Display name. */
+    name?: string;
+    /** Surface title. */
+    title?: ReactNode;
+    /** Supporting copy shown under the label. */
+    description?: ReactNode;
+    /** Content above the first field. */
+    headerSlot?: ReactNode;
+    /** Content rendered in the footer. */
+    footerSlot?: ReactNode;
+    /** Replaces the generated submit and reset buttons. */
+    actionsSlot?: ReactNode;
+    /** Shown when the schema defines no visible fields. */
+    emptySlot?: ReactNode;
+    /** Renders the actions. */
+    showActions?: boolean;
+    /** Copy for the submit button. */
+    submitLabel?: string;
+    /** Copy for the reset button. */
+    resetLabel?: string;
+    /** Disables the submit button. */
+    submitDisabled?: boolean;
+    /** Disables the reset button. */
+    resetDisabled?: boolean;
+    /** Shows the pending state on submit and blocks repeat presses. */
+    submitting?: boolean;
+    onValueChange?: (values: SchemaFormValues) => void;
+    onFieldChange?: (key: string, value: SchemaFormValue, values: SchemaFormValues) => void;
+    /** Fired when an entry is submitted. */
+    onSubmit?: (
+    /** Current form values, for fields whose visibility depends on siblings. */
+    values: SchemaFormValues, helpers: SchemaFormSubmitHelpers, event: FormEvent<HTMLFormElement>) => void | Promise<void>;
+    onReset?: (values: SchemaFormValues, helpers: SchemaFormSubmitHelpers) => void;
+    onError?: (error: unknown) => void;
+    /** Replaces the default field rendering. */
+    renderField?: (context: SchemaFormRenderFieldContext) => ReactNode;
+    /** Replaces the default section rendering. */
+    renderSection?: (context: SchemaFormRenderSectionContext) => ReactNode;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<SchemaFormStrings>;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Merged onto the content. */
+    contentClassName?: string;
+    /** Merged onto the section. */
+    sectionClassName?: string;
+    /** Merged onto the field. */
+    fieldClassName?: string;
+}
+export {};

package/dist/components/features/schema-form/schema-form.utils.d.ts

@@ -0,0 +1,18 @@
+import type { ResolvedSchemaFormSection, SchemaFormField, SchemaFormFieldWidth, SchemaFormSchema, SchemaFormValue, SchemaFormValues } from './schema-form.types';
+type SchemaFormErrorHandler = (error: unknown) => void;
+export declare const SCHEMA_FORM_COLUMNS: Record<1 | 2 | 3, string>;
+export declare const SCHEMA_FORM_FIELD_WIDTH: Record<SchemaFormFieldWidth, string>;
+export declare function isFieldHidden(field: SchemaFormField, values: SchemaFormValues, onError?: SchemaFormErrorHandler): boolean;
+export declare function isFieldDisabled(field: SchemaFormField, values: SchemaFormValues, onError?: SchemaFormErrorHandler): boolean;
+export declare function getVisibleFields(fields: SchemaFormField[], values: SchemaFormValues, onError?: SchemaFormErrorHandler): SchemaFormField[];
+export declare function resolveSchemaSections(schema: SchemaFormSchema, values: SchemaFormValues, defaultSectionTitle: string, defaultColumns: 1 | 2 | 3, onError?: SchemaFormErrorHandler): ResolvedSchemaFormSection[];
+export declare function toStringValue(value: SchemaFormValue): string;
+export declare function toStringArray(value: SchemaFormValue): string[];
+export declare function toBooleanValue(value: SchemaFormValue): boolean;
+export declare function parseNumberValue(rawValue: string, integer?: boolean): number | null;
+export declare function formatJsonValue(value: SchemaFormValue, indent?: number): string;
+export declare function parseJsonValue(rawValue: string): {
+    value: SchemaFormValue;
+    valid: boolean;
+};
+export {};

package/dist/components/features/suggestions/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useSuggestions } from './use-suggestions';

package/dist/components/features/suggestions/hooks/use-suggestions.d.ts

@@ -0,0 +1,9 @@
+import type { UseSuggestionsConfig, UseSuggestionsResult } from '../suggestions.types';
+/**
+ * Headless data-fetching state machine for the suggestions feature.
+ *
+ * Returns the search/selection/open state plus the latest items + loading flag.
+ * Consumers that want a different visual layer can build their own UI on top
+ * of this hook without touching `<SuggestionsCombobox>`.
+ */
+export declare function useSuggestions<T>(config: UseSuggestionsConfig<T>): UseSuggestionsResult<T>;

package/dist/components/features/suggestions/index.d.ts

@@ -0,0 +1,4 @@
+export { SuggestionsCombobox } from './suggestions';
+export { useSuggestions } from './hooks';
+export type { SuggestionsComboboxProps, UseSuggestionsConfig, UseSuggestionsResult, SuggestionsErrorRenderContext, SuggestionsFetchContext, MaybePromise, } from './suggestions.types';
+export { defaultSuggestionsStrings, type SuggestionsStrings, } from './suggestions.strings';

package/dist/components/features/suggestions/suggestions.d.ts

@@ -0,0 +1,5 @@
+import type { SuggestionsComboboxProps } from './suggestions.types';
+export declare function SuggestionsCombobox<T>(props: SuggestionsComboboxProps<T>): import("react").JSX.Element;
+export declare namespace SuggestionsCombobox {
+    var displayName: string;
+}

package/dist/components/features/suggestions/suggestions.strings.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Default user-facing strings for `<SuggestionsCombobox>`.
+ *
+ * Consumers wire backend i18n at the call site:
+ *
+ *   <SuggestionsCombobox strings={{ emptyMessage: t('search.empty') }} … />
+ */
+export interface SuggestionsStrings {
+    placeholder: string;
+    emptyMessage: string;
+    loadingMessage: string;
+    startTypingMessage: string;
+    errorMessage: string;
+    retry: string;
+}
+export declare const defaultSuggestionsStrings: SuggestionsStrings;

package/dist/components/features/suggestions/suggestions.types.d.ts

@@ -0,0 +1,79 @@
+import type { ReactNode } from 'react';
+import type { StringsProp } from '../../../lib/strings';
+import type { SuggestionsStrings } from './suggestions.strings';
+export type MaybePromise<T> = T | Promise<T>;
+export interface SuggestionsFetchContext {
+    /** Abort signal for cancelling superseded or unmounted requests. */
+    signal?: AbortSignal;
+}
+export interface UseSuggestionsConfig<T> {
+    /** Loads suggestions for a query. Receives an `AbortSignal` for the superseded request. */
+    fetchData: (query: string, context?: SuggestionsFetchContext) => MaybePromise<T[]>;
+    /** Characters required before a request is issued. Default: `1`. */
+    minQueryLength?: number;
+    /** Quiet period before a request is scheduled, in milliseconds. Default: `250`. */
+    debounceMs?: number;
+    /** Extra wait before `fetchData` runs, applied once the loading state is already visible. Default: `0`. */
+    requestDelay?: number;
+    /** Issues a request for the empty query so suggestions exist before typing. */
+    preload?: boolean;
+    /** Controlled query. */
+    query?: string;
+    /** Initial query for uncontrolled usage. */
+    defaultQuery?: string;
+    onQueryChange?: (query: string) => void;
+    /** Controlled selected value. `null` represents an explicit empty selection. */
+    value?: T | null;
+    /** Initial selected value for uncontrolled usage. */
+    defaultValue?: T | null;
+    onValueChange?: (value: T | null) => void;
+    /** Controlled popup state. */
+    open?: boolean;
+    /** Initial popup state for uncontrolled usage. */
+    defaultOpen?: boolean;
+    /** Fired when a change is opened. */
+    onOpenChange?: (open: boolean) => void;
+    /** Fires on fetcher rejection — consumer wires telemetry / toasts here. */
+    onError?: (error: unknown, query: string) => void;
+}
+export interface UseSuggestionsResult<T> {
+    items: T[];
+    /** Replaces the content with the loading state. */
+    isLoading: boolean;
+    error: unknown | null;
+    isError: boolean;
+    retry: () => void;
+    /** Canonical query state channel. */
+    query: string;
+    setQuery: (value: string) => void;
+    /** Canonical selected-value state channel. */
+    value: T | null;
+    setValue: (value: T | null) => void;
+    open: boolean;
+    setOpen: (value: boolean) => void;
+}
+export interface SuggestionsErrorRenderContext {
+    error: unknown;
+    query: string;
+    retry: () => void;
+}
+export interface SuggestionsComboboxProps<T> extends UseSuggestionsConfig<T> {
+    /** Reads a stable identity off each suggestion. */
+    itemKey: (item: T) => string | number;
+    /** Reads the display text off each suggestion. */
+    itemText: (item: T) => string;
+    /** Replaces the default item rendering. */
+    renderItem?: (item: T) => ReactNode;
+    /** Replaces the package error state while retaining access to retry. */
+    renderError?: (context: SuggestionsErrorRenderContext) => ReactNode;
+    /** Shows a control that clears the current selection. */
+    allowClear?: boolean;
+    /** Resets the query when the list closes without a selection. */
+    clearInputOnClose?: boolean;
+    /** Renders the entry as unselectable. */
+    disabled?: boolean;
+    /** Merged onto the outermost node. */
+    className?: string;
+    /** Per-instance string overrides (deep-merged over `defaultSuggestionsStrings`). */
+    strings?: StringsProp<SuggestionsStrings>;
+}

package/dist/components/features/sync/index.d.ts

@@ -0,0 +1,3 @@
+export { SyncRangeDialogForm } from './sync-range-dialog-form';
+export type { SyncRangeDialogFormProps, SyncRangeDialogFormSubmit, SyncRangeDialogFormValues, } from './sync.types';
+export { defaultSyncRangeDialogFormStrings, type SyncRangeDialogFormStrings, } from './sync.strings';

package/dist/components/features/sync/sync-range-dialog-form.d.ts

@@ -0,0 +1,5 @@
+import type { SyncRangeDialogFormProps, SyncRangeDialogFormSubmit } from './sync.types';
+export declare function SyncRangeDialogForm<TSubmit = SyncRangeDialogFormSubmit>(props: SyncRangeDialogFormProps<TSubmit>): import("react").JSX.Element;
+export declare namespace SyncRangeDialogForm {
+    var displayName: string;
+}

package/dist/components/features/sync/sync.strings.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Default user-facing strings for `<SyncRangeDialogForm>`.
+ *
+ * Consumers wire backend i18n at the call site:
+ *
+ *   <SyncRangeDialogForm strings={{ optionsLabel: t('sync.options') }} … />
+ */
+export interface SyncRangeDialogFormStrings {
+    /** Label rendered above the required sync-window radio group. */
+    hoursLabel: string;
+    /** Helper copy rendered below the sync-window label. */
+    hoursDescription: string;
+    /** Label rendered above the optional sync-options checkbox group. */
+    optionsLabel: string;
+    /** Helper copy rendered below the optional sync-options label. */
+    optionsDescription: string;
+}
+export declare const defaultSyncRangeDialogFormStrings: SyncRangeDialogFormStrings;

package/dist/components/features/sync/sync.types.d.ts

@@ -0,0 +1,44 @@
+import type { CardCheckboxOption, CardRadioOption } from '../../base/choice-inputs';
+import type { StringsProp } from '../../../lib/strings';
+import type { SyncRangeDialogFormStrings } from './sync.strings';
+export type SyncRangeDialogFormValues = {
+    /** Selected range identifier. Numeric hour strings work with the default transformer. */
+    hours: string;
+    /** Date-range presets offered. */
+    options: string[];
+};
+export type SyncRangeDialogFormSubmit = {
+    hours: number;
+    /** Every selected option id, preserved for consumer-owned payloads. */
+    options: string[];
+};
+export interface SyncRangeDialogFormProps<TSubmit = SyncRangeDialogFormSubmit> {
+    /** `id` set on the form, so a dialog footer button can submit it. */
+    formId: string;
+    /** Date-range presets offered. */
+    options: CardRadioOption[];
+    /** Additional sync toggles offered alongside the range. */
+    syncOptions?: CardCheckboxOption[];
+    /** Current selection. Controlled. */
+    value?: SyncRangeDialogFormValues;
+    /** Initial selection for uncontrolled use. */
+    defaultValue?: Partial<SyncRangeDialogFormValues>;
+    onValueChange?: (value: SyncRangeDialogFormValues) => void;
+    /** Maps neutral form values to the consumer's API payload. */
+    transformSubmit?: (value: SyncRangeDialogFormValues) => TSubmit;
+    /** Fired when an entry is submitted. */
+    onSubmit: (
+    /** Records to render. */
+    data: TSubmit, values: SyncRangeDialogFormValues) => void | Promise<void>;
+    onError?: (error: unknown) => void;
+    /** Reset uncontrolled state when a mutation completes or the owning record changes. */
+    resetKey?: string | number;
+    /** Renders the entry as unselectable. */
+    disabled?: boolean;
+    /** Shows the pending state and blocks repeat submissions. */
+    submitting?: boolean;
+    /** Validation messages keyed by field. */
+    errors?: Record<string, string | string[] | undefined>;
+    /** Per-instance string overrides (deep-merged over `defaultSyncRangeDialogFormStrings`). */
+    strings?: StringsProp<SyncRangeDialogFormStrings>;
+}

package/dist/components/features/table/column-visibility-toggle.d.ts

@@ -0,0 +1,5 @@
+import { type ColumnVisibilityToggleProps } from './table.types';
+export declare function ColumnVisibilityToggle<TData>({ table, className, align, labelVisibility, strings, }: ColumnVisibilityToggleProps<TData>): import("react").JSX.Element | null;
+export declare namespace ColumnVisibilityToggle {
+    var displayName: string;
+}

package/dist/components/features/table/data-table.d.ts

@@ -0,0 +1,6 @@
+export declare function useDataTableSize(): 'xs' | 'sm';
+import { type DataTableProps } from './table.types';
+export declare function DataTable<TData extends object, TValue = unknown>({ size, surface, headerTransparent, columns, data, columnGroups, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, enableSorting, enableFiltering, filterColumn, filterPlaceholder, manualSorting, enableColumnVisibility, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, enableRowSelection, enableMultiRowSelection, enableSubRowSelection, pagination, pageQueryKey, onPageChange, onSortingChange, onColumnFiltersChange, onRowClick, onRowSelectionChange, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, emptyStateMessage, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, innerClassName, tableContainerClassName, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, defaultSorting, columnVisibility: controlledColumnVisibility, defaultColumnVisibility, initialState, onColumnVisibilityChange, strings: stringsOverride, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, storageKey, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
+export declare namespace DataTable {
+    var displayName: string;
+}

package/dist/components/features/table/filter-bar.d.ts

@@ -0,0 +1,5 @@
+import { type DataTableFilterBarProps } from './table.types';
+export declare function DataTableFilterBar<TData>({ table, filterColumn, filterPlaceholder, enableColumnVisibility, customContent, strings, }: DataTableFilterBarProps<TData>): import("react").JSX.Element | null;
+export declare namespace DataTableFilterBar {
+    var displayName: string;
+}

package/dist/components/features/table/hooks.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Reusable hooks for DataTable consumers building custom toolbars or chrome.
+ *
+ * The default `DataTableToolbar` already wires these internally; expose them
+ * for consumers that need horizontal-scroll arrows in a
+ * custom layout (e.g. inside a hero banner above the table).
+ */
+import { type RefObject } from 'react';
+/**
+ * Locate the actual horizontally-scrollable element inside a `tableArea`
+ * wrapper. The shadcn-style Table primitive renders a
+ * `<div data-slot="table-container" class="overflow-x-auto">` we target.
+ */
+export declare function getDataTableScrollContainer(tableArea: HTMLDivElement | null): HTMLDivElement | null;
+export interface UseDataTableScrollStateReturn {
+    canScrollLeft: boolean;
+    canScrollRight: boolean;
+    scrollBy: (delta: number) => void;
+    scrollLeft: () => void;
+    scrollRight: () => void;
+}
+/**
+ * Track horizontal-overflow state for a DataTable wrapper. Returns booleans
+ * for whether each scroll direction is available, plus helpers to nudge the
+ * scroll container by a fixed amount.
+ *
+ * Pass the same `RefObject<HTMLDivElement>` you pass to `<DataTable>` as
+ * `tableAreaRef`.
+ */
+export declare function useDataTableScrollState(tableAreaRef: RefObject<HTMLDivElement | null>, options?: {
+    stepPx?: number;
+    deps?: ReadonlyArray<unknown>;
+}): UseDataTableScrollStateReturn;
+/**
+ * Modal behaviour for the full-screen table.
+ *
+ * Full-screen mode paints `fixed inset-0` over the entire viewport — the app's
+ * own header and navigation included — which makes it modal in every way that
+ * matters to a user. It shipped with none of the contract that implies: Escape
+ * did nothing, Tab walked out into the page underneath that nobody can see, and
+ * assistive technology was never told the rest of the document was unavailable.
+ *
+ * `aria-modal` on the region covers the announcement. This covers the rest:
+ * Escape leaves, Tab cycles inside, and focus returns to the control that
+ * opened it so keyboard users are not dropped at the top of the document.
+ */
+export declare function useFullscreenTableModality(active: boolean, regionRef: RefObject<HTMLElement | null>, onExit: () => void): void;

package/dist/components/features/table/index.d.ts

@@ -0,0 +1,16 @@
+export { DataTable, useDataTableSize } from './data-table';
+export { DataTableActions } from './table-actions';
+export { DataTableBody } from './table-body';
+export { DataTableFilterBar } from './filter-bar';
+export { DataTableHeader } from './table-header';
+export { Pagination } from './pagination';
+export { ColumnVisibilityToggle } from './column-visibility-toggle';
+export { DataTableToolbar } from './table-toolbar';
+export { CellValue, CellStack, type CellStackProps, type CellStackValue, type CellValueDescriptor, type CellValueKind, type CellValueProps, type CellValueTuple, type PrimitiveCellValue, } from './partials/cell-value';
+export { TableLink, type TableLinkProps } from './partials/table-link';
+export { StatusCell, type StatusCellEntry, type StatusCellProps, StatusClusterCell, type StatusClusterCellItem, type StatusClusterCellProps, DateCell, type DateCellProps, DateMetaCell, type DateMetaCellProps, CurrencyCell, type CurrencyCellProps, AvatarCell, type AvatarCellProps, ResourceCell, type ResourceCellBadge, type ResourceCellLinkProps, type ResourceCellMetadataItem, type ResourceCellProps, } from './partials/cell-renderers';
+export * from './table.types';
+export { defaultDataTableStrings, mergeDataTableStrings } from './table.strings';
+export { handleRowSelectionChange, handleSortingChange, handleColumnVisibilityChange, getRowClassName, getCellClassName, getSelectedRowsData, createRowSelectionCheckbox, createHeaderSelectionCheckbox, addSelectionColumn, } from './table-helpers';
+export { useDataTableScrollState, getDataTableScrollContainer, type UseDataTableScrollStateReturn, } from './hooks';
+export { FullscreenToggle, type FullscreenToggleProps } from './partials/fullscreen-toggle';

package/dist/components/features/table/pagination.d.ts

@@ -0,0 +1,5 @@
+import { type ServerPaginationProps } from './table.types';
+export declare function Pagination({ pagination, onPageChange, labels, pageQueryKey, }: ServerPaginationProps): import("react").JSX.Element;
+export declare namespace Pagination {
+    var displayName: string;
+}