@acronis-platform/ui-react 0.56.0 → 0.56.1

package/dist/src/components/ui/skeleton/index.d.ts

@@ -0,0 +1 @@
+export { Skeleton, type SkeletonProps } from './skeleton';

package/dist/src/components/ui/skeleton/skeleton.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+export type SkeletonProps = React.HTMLAttributes<HTMLDivElement>;
+declare const Skeleton: React.ForwardRefExoticComponent<SkeletonProps & React.RefAttributes<HTMLDivElement>>;
+export { Skeleton };

package/dist/src/components/ui/slider/index.d.ts

@@ -0,0 +1 @@
+export { Slider, type SliderProps } from './slider';

package/dist/src/components/ui/slider/slider.d.ts

@@ -0,0 +1,7 @@
+import { Slider as SliderPrimitive } from '@base-ui/react/slider';
+import * as React from 'react';
+export type SliderProps = React.ComponentPropsWithoutRef<typeof SliderPrimitive.Root>;
+declare const Slider: React.ForwardRefExoticComponent<Omit<SliderPrimitive.Root.Props<number | readonly number[]> & {
+    ref?: React.Ref<HTMLDivElement> | undefined;
+}, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export { Slider };

package/dist/src/components/ui/spinner/index.d.ts

@@ -0,0 +1 @@
+export { Spinner, spinnerVariants, type SpinnerProps } from './spinner';

package/dist/src/components/ui/spinner/spinner.d.ts

@@ -0,0 +1,9 @@
+import { VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+declare const spinnerVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | "xl" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface SpinnerProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof spinnerVariants> {
+}
+declare const Spinner: React.ForwardRefExoticComponent<SpinnerProps & React.RefAttributes<HTMLDivElement>>;
+export { Spinner, spinnerVariants };

package/dist/src/components/ui/stack/index.d.ts

@@ -0,0 +1 @@
+export { Stack, stackVariants, type StackProps } from './stack';

package/dist/src/components/ui/stack/stack.d.ts

@@ -0,0 +1,13 @@
+import { VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+declare const stackVariants: (props?: ({
+    direction?: "horizontal" | "vertical" | null | undefined;
+    gap?: "none" | "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+    align?: "center" | "end" | "start" | "stretch" | null | undefined;
+    justify?: "center" | "end" | "start" | "between" | null | undefined;
+    wrap?: boolean | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface StackProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof stackVariants> {
+}
+declare const Stack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<HTMLDivElement>>;
+export { Stack, stackVariants };

package/dist/src/components/ui/switch/index.d.ts

@@ -0,0 +1 @@
+export { Switch, type SwitchProps } from './switch';

package/dist/src/components/ui/switch/switch.d.ts

@@ -0,0 +1,8 @@
+import { Switch as SwitchPrimitive } from '@base-ui/react/switch';
+import * as React from 'react';
+export interface SwitchProps extends React.ComponentPropsWithoutRef<typeof SwitchPrimitive.Root> {
+    /** Optional label rendered beside the toggle; names the control. */
+    label?: React.ReactNode;
+}
+declare const Switch: React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLElement>>;
+export { Switch };

package/dist/src/components/ui/table/index.d.ts

@@ -0,0 +1,3 @@
+export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, type TableRowProps, type TableHeadProps, type TableCellProps, } from './table';
+export { TablePagination, type TablePaginationProps, } from './table-pagination';
+export { TableViewOptions, type TableViewOptionsProps, type TableColumnVisibility, } from './table-view-options';

package/dist/src/components/ui/table/table-pagination.d.ts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+export interface TablePaginationProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Zero-based index of the current page. */
+    pageIndex: number;
+    /** Total number of pages. */
+    pageCount: number;
+    /** Number of rows shown per page. */
+    pageSize: number;
+    /** Page-size options offered in the rows-per-page select. */
+    pageSizeOptions?: number[];
+    /** Total number of rows across all pages (drives the summary text). */
+    totalRows?: number;
+    /** Number of currently selected rows (drives the selection summary text). */
+    selectedRows?: number;
+    /** Invoked with the next zero-based page index. */
+    onPageIndexChange: (pageIndex: number) => void;
+    /** Invoked with the next page size. */
+    onPageSizeChange: (pageSize: number) => void;
+}
+declare const TablePagination: React.ForwardRefExoticComponent<TablePaginationProps & React.RefAttributes<HTMLDivElement>>;
+export { TablePagination };

package/dist/src/components/ui/table/table-view-options.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+export interface TableColumnVisibility {
+    /** Stable column identifier. */
+    id: string;
+    /** Human-readable label shown in the menu. */
+    label: string;
+    /** Whether the column is currently hidden. */
+    hidden: boolean;
+}
+export interface TableViewOptionsProps {
+    /** The toggleable columns and their current visibility. */
+    columns: TableColumnVisibility[];
+    /** Invoked with the column id whose visibility was toggled. */
+    onToggle: (id: string) => void;
+    /** Trigger label. Defaults to `View`. */
+    triggerLabel?: React.ReactNode;
+}
+declare function TableViewOptions({ columns, onToggle, triggerLabel, }: TableViewOptionsProps): import("react/jsx-runtime").JSX.Element;
+declare namespace TableViewOptions {
+    var displayName: string;
+}
+export { TableViewOptions };

package/dist/src/components/ui/table/table.d.ts

@@ -0,0 +1,35 @@
+import * as React from 'react';
+declare const Table: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableElement> & React.RefAttributes<HTMLTableElement>>;
+declare const TableHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+declare const TableBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+declare const TableFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+export interface TableRowProps extends React.HTMLAttributes<HTMLTableRowElement> {
+    /** Mark the row as selected — applies the active row token + `data-state`. */
+    selected?: boolean;
+}
+declare const TableRow: React.ForwardRefExoticComponent<TableRowProps & React.RefAttributes<HTMLTableRowElement>>;
+type SortDirection = 'asc' | 'desc' | false;
+export interface TableHeadProps extends React.ThHTMLAttributes<HTMLTableCellElement> {
+    /** Render the column as sortable — adds a sort affordance and `aria-sort`. */
+    sortable?: boolean;
+    /** Current sort direction for this column (`false` = sortable but unsorted). */
+    sortDirection?: SortDirection;
+    /** Invoked when the user activates a sortable header (click / Enter / Space). */
+    onSort?: () => void;
+    /**
+     * Allow the header to wrap onto multiple lines (`whitespace-normal`) and drop
+     * the fixed row height so the cell grows to fit its content.
+     */
+    wrap?: boolean;
+}
+declare const TableHead: React.ForwardRefExoticComponent<TableHeadProps & React.RefAttributes<HTMLTableCellElement>>;
+export interface TableCellProps extends React.TdHTMLAttributes<HTMLTableCellElement> {
+    /**
+     * Allow the cell to wrap onto multiple lines (`whitespace-normal`) and drop
+     * the fixed row height so the row grows to fit its content.
+     */
+    wrap?: boolean;
+}
+declare const TableCell: React.ForwardRefExoticComponent<TableCellProps & React.RefAttributes<HTMLTableCellElement>>;
+declare const TableCaption: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableCaptionElement> & React.RefAttributes<HTMLTableCaptionElement>>;
+export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, };

package/dist/src/components/ui/tabs/index.d.ts

@@ -0,0 +1 @@
+export { Tabs, TabsList, TabsTrigger, TabsContent } from './tabs';

package/dist/src/components/ui/tabs/tabs.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+declare const Tabs: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').TabsRootProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const TabsList: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').TabsListProps, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const TabsTrigger: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').TabsTabProps, "ref"> & React.RefAttributes<HTMLElement>, "ref"> & React.RefAttributes<HTMLElement>>;
+declare const TabsContent: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').TabsPanelProps, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export { Tabs, TabsList, TabsTrigger, TabsContent };

package/dist/src/components/ui/tabs/tabs.docs.d.ts

@@ -0,0 +1,25 @@
+import type * as React from 'react';
+/** Props for `Tabs` (the root). */
+export interface TabsProps {
+    /** Controlled selected-tab value. Pair with `onValueChange`. */
+    value?: string | number;
+    /** Initially selected tab value (uncontrolled). */
+    defaultValue?: string | number;
+    /** Fired with the newly selected tab value. */
+    onValueChange?: (value: string | number, eventDetails: unknown) => void;
+    /** Layout and arrow-key navigation orientation. Defaults to `horizontal`. */
+    orientation?: 'horizontal' | 'vertical';
+    /** A `TabsList` of `TabsTrigger`s plus matching `TabsContent` panels. */
+    children?: React.ReactNode;
+}
+/** Props shared by `TabsTrigger` and `TabsContent`. */
+export interface TabsPartProps {
+    /**
+     * Identifies the tab: a `TabsTrigger` and the `TabsContent` it controls share
+     * the same `value`.
+     */
+    value: string | number;
+    /** On `TabsTrigger` — disables selecting that tab. */
+    disabled?: boolean;
+    children?: React.ReactNode;
+}

package/dist/src/components/ui/tag/index.d.ts

@@ -0,0 +1 @@
+export { Tag, tagVariants, type TagProps } from './tag';

package/dist/src/components/ui/tag/tag.d.ts

@@ -0,0 +1,12 @@
+import { VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+declare const tagVariants: (props?: ({
+    variant?: "info" | "success" | "warning" | "critical" | "ai" | "neutral" | "danger" | null | undefined;
+    size?: "default" | "sm" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+export interface TagProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof tagVariants> {
+    /** Optional leading icon, rendered at 16px before the label. */
+    icon?: React.ReactNode;
+}
+declare const Tag: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<HTMLSpanElement>>;
+export { Tag, tagVariants };

package/dist/src/components/ui/toast/index.d.ts

@@ -0,0 +1 @@
+export { toast, Toaster, type ToasterProps, type ToastType, type ToastOptions, } from './toast';

package/dist/src/components/ui/toast/toast.d.ts

@@ -0,0 +1,48 @@
+import { Toast as ToastPrimitive } from '@base-ui/react/toast';
+import * as React from 'react';
+export type ToastType = 'success' | 'info' | 'warning' | 'error' | 'loading';
+export interface ToastOptions {
+    /** Secondary line under the title. */
+    description?: React.ReactNode;
+    /** Auto-dismiss delay in ms; `0` keeps the toast until dismissed. */
+    timeout?: number;
+    /** A single inline action button (e.g. Undo). */
+    action?: {
+        label: React.ReactNode;
+        onClick?: () => void;
+    };
+    /** Stable id — re-adding with the same id updates the toast in place. */
+    id?: string;
+}
+/**
+ * Imperative toast API. `toast(title, options)` shows a neutral toast;
+ * `toast.success` / `info` / `warning` / `error` / `loading` set the variant.
+ * `toast.dismiss(id?)` closes one (or all) and `toast.promise` ties a toast to a
+ * promise's lifecycle.
+ */
+declare const toast: ((title: React.ReactNode, options?: ToastOptions) => string) & {
+    success: (title: React.ReactNode, options?: ToastOptions) => string;
+    info: (title: React.ReactNode, options?: ToastOptions) => string;
+    warning: (title: React.ReactNode, options?: ToastOptions) => string;
+    error: (title: React.ReactNode, options?: ToastOptions) => string;
+    loading: (title: React.ReactNode, options?: ToastOptions) => string;
+    dismiss: (id?: string) => void;
+    promise: <Value, T extends any = any>(promiseValue: Promise<Value>, options: import('@base-ui/react').ToastManagerPromiseOptions<Value, T>) => Promise<Value>;
+};
+export interface ToasterProps {
+    /** Default auto-dismiss delay in ms for toasts that don't set one. */
+    timeout?: number;
+    /** Max toasts shown at once; the oldest is dropped past the limit. */
+    limit?: number;
+    /**
+     * Portal container for the toast stack. Pass a shadow-root mount for
+     * isolated-style previews (the docs demos do this via `useShadowMount`).
+     */
+    portalContainer?: ToastPrimitive.Portal.Props['container'];
+}
+/**
+ * The toast region. Render once near the app root; it portals a bottom-right
+ * stack and renders every queued toast. Trigger toasts with the `toast` API.
+ */
+declare function Toaster({ timeout, limit, portalContainer }: ToasterProps): import("react/jsx-runtime").JSX.Element;
+export { toast, Toaster };

package/dist/src/components/ui/toast/toast.docs.d.ts

@@ -0,0 +1,12 @@
+/** Props for `<Toaster>` — the toast region rendered once near the app root. */
+export interface ToasterProps {
+    /** Default auto-dismiss delay in ms for toasts that don't set one (default 5000). */
+    timeout?: number;
+    /** Max toasts shown at once; the oldest is dropped past the limit (default 3). */
+    limit?: number;
+    /**
+     * Portal container for the toast stack. Pass a shadow-root mount for
+     * isolated-style previews (the docs demos do this via `useShadowMount`).
+     */
+    portalContainer?: HTMLElement | null;
+}

package/dist/src/components/ui/toggle-group/index.d.ts

@@ -0,0 +1 @@
+export { Toggle, ToggleGroup, ToggleGroupItem } from './toggle-group';

package/dist/src/components/ui/toggle-group/toggle-group.d.ts

@@ -0,0 +1,7 @@
+import { Toggle as TogglePrimitive } from '@base-ui/react/toggle';
+import { ToggleGroup as ToggleGroupPrimitive } from '@base-ui/react/toggle-group';
+import * as React from 'react';
+declare const Toggle: React.ForwardRefExoticComponent<Omit<TogglePrimitive.Props<string> & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+declare const ToggleGroup: React.ForwardRefExoticComponent<Omit<ToggleGroupPrimitive.Props<string> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const ToggleGroupItem: React.ForwardRefExoticComponent<Omit<TogglePrimitive.Props<string> & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export { Toggle, ToggleGroup, ToggleGroupItem };

package/dist/src/components/ui/tooltip/index.d.ts

@@ -0,0 +1 @@
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider, } from './tooltip';

package/dist/src/components/ui/tooltip/tooltip.d.ts

@@ -0,0 +1,21 @@
+import { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';
+import * as React from 'react';
+declare function TooltipProvider(props: React.ComponentProps<typeof TooltipPrimitive.Provider>): import("react/jsx-runtime").JSX.Element;
+declare const Tooltip: <Payload>(props: TooltipPrimitive.Root.Props<Payload>) => import("react/jsx-runtime").JSX.Element;
+declare const TooltipTrigger: TooltipPrimitive.Trigger;
+declare const TooltipContent: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').TooltipPopupProps, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & {
+    sideOffset?: number;
+    side?: TooltipPrimitive.Positioner.Props["side"];
+    align?: TooltipPrimitive.Positioner.Props["align"];
+    /**
+     * Override what the popup is positioned against — defaults to the
+     * `TooltipTrigger` element. Useful when the hover/focus trigger is
+     * narrower than the element the tooltip should visually align to (e.g. a
+     * truncating label inside a full-width row, where the tooltip should
+     * anchor to the row's edge, not the label's).
+     */
+    anchor?: TooltipPrimitive.Positioner.Props["anchor"];
+    portalContainer?: TooltipPrimitive.Portal.Props["container"];
+    keepMounted?: TooltipPrimitive.Portal.Props["keepMounted"];
+} & React.RefAttributes<HTMLDivElement>>;
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/src/components/ui/widget-placeholder/index.d.ts

@@ -0,0 +1 @@
+export { WidgetPlaceholder, WidgetPlaceholderHeader, WidgetPlaceholderTitle, WidgetPlaceholderIcon, WidgetPlaceholderContent, WidgetPlaceholderImage, WidgetPlaceholderText, WidgetPlaceholderAction, WidgetPlaceholderFooter, type WidgetPlaceholderProps, } from './widget-placeholder';

package/dist/src/components/ui/widget-placeholder/widget-placeholder.d.ts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+export interface WidgetPlaceholderProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Make the whole widget focusable and clickable (hover/active surface + focus
+     * ring). Wire the behavior via `onClick`.
+     */
+    interactive?: boolean;
+}
+declare const WidgetPlaceholder: React.ForwardRefExoticComponent<WidgetPlaceholderProps & React.RefAttributes<HTMLDivElement>>;
+declare const WidgetPlaceholderHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const WidgetPlaceholderTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const WidgetPlaceholderIcon: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const WidgetPlaceholderContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const WidgetPlaceholderImage: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const WidgetPlaceholderText: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const WidgetPlaceholderAction: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const WidgetPlaceholderFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+export { WidgetPlaceholder, WidgetPlaceholderHeader, WidgetPlaceholderTitle, WidgetPlaceholderIcon, WidgetPlaceholderContent, WidgetPlaceholderImage, WidgetPlaceholderText, WidgetPlaceholderAction, WidgetPlaceholderFooter, };

package/dist/src/components/ui/widget-placeholder/widget-placeholder.docs.d.ts

@@ -0,0 +1,14 @@
+import type * as React from 'react';
+/** Props for `WidgetPlaceholder` — the root widget card. */
+export interface WidgetPlaceholderProps {
+    /**
+     * Make the whole widget focusable (`tabindex=0`) and clickable — adds
+     * hover/active surface tints and a focus ring. Wire the behavior with
+     * `onClick`.
+     */
+    interactive?: boolean;
+    /** Extra classes merged onto the root. */
+    className?: string;
+    /** The composed parts (header / content / footer). */
+    children?: React.ReactNode;
+}

package/dist/src/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export { useSortState, type SortDirection, type SortState, type SortComparator, type UseSortStateOptions, type UseSortStateResult, } from './use-sort-state';
+export { useTableUrlState, parseTableUrlState, serializeTableUrlState, DEFAULT_TABLE_URL_PARAM_KEYS, type TableUrlState, type TablePaginationState, type TableSortingState, type TableColumnFilterState, type TableUrlParamKeys, type TableUrlUpdater, type UseTableUrlStateOptions, type UseTableUrlStateResult, } from './use-table-url-state';

package/dist/src/hooks/use-sort-state.d.ts

@@ -0,0 +1,46 @@
+export type SortDirection = 'asc' | 'desc' | false;
+export interface SortState {
+    columnId: string;
+    direction: 'asc' | 'desc';
+}
+/**
+ * Compares two rows for a column. Ascending order; the hook negates the result
+ * for descending. Receives the full rows so a custom comparator has access to
+ * every field.
+ */
+export type SortComparator<TData> = (a: TData, b: TData) => number;
+export interface UseSortStateOptions<TData> {
+    /** Rows to sort. */
+    data: TData[];
+    /** Initial sorted column + direction. */
+    initialSort?: SortState | null;
+    /**
+     * Custom per-column comparators keyed by column id. When absent for a column,
+     * the default alphanumeric comparator on `getValue(row, columnId)` is used.
+     */
+    comparators?: Record<string, SortComparator<TData>>;
+    /**
+     * How to read a column's value from a row for the default comparator.
+     * Defaults to `row[columnId]`.
+     */
+    getValue?: (row: TData, columnId: string) => unknown;
+}
+export interface UseSortStateResult<TData> {
+    /** The rows sorted by the current sort state (unsorted `data` when none). */
+    sortedData: TData[];
+    /** The current sort, or `null` when unsorted. */
+    sort: SortState | null;
+    /** Directly set (or clear) the sort. */
+    setSort: (sort: SortState | null) => void;
+    /** Cycle a column's sort: none → asc → desc → none. */
+    toggleSort: (columnId: string) => void;
+    /** Direction for a column, shaped for `TableHead`'s `sortDirection` prop. */
+    getSortDirection: (columnId: string) => SortDirection;
+}
+/**
+ * Headless client-side sort state for the `Table` primitives (no TanStack
+ * dependency). Drives `TableHead`'s `sortable`/`sortDirection`/`onSort` props
+ * and returns the sorted rows. Default comparator is alphanumeric; pass
+ * `comparators` to override per column.
+ */
+export declare function useSortState<TData>({ data, initialSort, comparators, getValue, }: UseSortStateOptions<TData>): UseSortStateResult<TData>;

package/dist/src/hooks/use-table-url-state.d.ts

@@ -0,0 +1,85 @@
+export interface TablePaginationState {
+    /** Zero-based page index. */
+    pageIndex: number;
+    /** Rows per page. */
+    pageSize: number;
+}
+export interface TableSortingState {
+    /** Column id. */
+    id: string;
+    /** `true` for descending. */
+    desc: boolean;
+}
+export interface TableColumnFilterState {
+    /** Column id. */
+    id: string;
+    /** Filter value (string-encoded in the URL). */
+    value: string;
+}
+/**
+ * Controlled table state. The three fields mirror TanStack's `PaginationState`,
+ * `SortingState`, and `ColumnFiltersState` shapes (filter value narrowed to
+ * `string`) so they can wire straight into `onPaginationChange` /
+ * `onSortingChange` / `onColumnFiltersChange`.
+ */
+export interface TableUrlState {
+    pagination: TablePaginationState;
+    sorting: TableSortingState[];
+    columnFilters: TableColumnFilterState[];
+}
+/** Query-string keys. Namespaced (`tbl_*`) to avoid collisions with Storybook's
+ * own `path`/`args`/`globals` params on a shared preview-iframe URL. */
+export interface TableUrlParamKeys {
+    page: string;
+    size: string;
+    sort: string;
+    filter: string;
+}
+export declare const DEFAULT_TABLE_URL_PARAM_KEYS: TableUrlParamKeys;
+export interface UseTableUrlStateOptions {
+    /** Default page size; omitted from the URL when the size matches it. */
+    defaultPageSize?: number;
+    /** Override the namespaced query-string keys. */
+    paramKeys?: Partial<TableUrlParamKeys>;
+}
+export type TableUrlUpdater<T> = T | ((old: T) => T);
+export interface UseTableUrlStateResult {
+    state: TableUrlState;
+    /** Accepts a value or updater — shaped for TanStack's `onPaginationChange`. */
+    setPagination: (updater: TableUrlUpdater<TablePaginationState>) => void;
+    /** Accepts a value or updater — shaped for TanStack's `onSortingChange`. */
+    setSorting: (updater: TableUrlUpdater<TableSortingState[]>) => void;
+    /** Accepts a value or updater — shaped for TanStack's `onColumnFiltersChange`. */
+    setColumnFilters: (updater: TableUrlUpdater<TableColumnFilterState[]>) => void;
+}
+/**
+ * Parses table state out of a query string. Pure — safe to reuse for seeding a
+ * story or an SSR default. `search` may include or omit the leading `?`.
+ *
+ * Encoding: `tbl_page` is 1-based; `tbl_sort` is `id:asc|desc` pairs joined by
+ * `,`; `tbl_filter` is `id:<encoded-value>` pairs joined by `,` (the value is
+ * `encodeURIComponent`-escaped so it may contain `:`/`,`). Column ids must not
+ * contain `:` or `,`.
+ */
+export declare function parseTableUrlState(search: string, { defaultPageSize, paramKeys, }?: {
+    defaultPageSize?: number;
+    paramKeys?: TableUrlParamKeys;
+}): TableUrlState;
+/**
+ * Serializes table state onto a query string, preserving any foreign params
+ * already present in `search` (e.g. Storybook's `path`/`args`/`globals`).
+ * Returns the query string without a leading `?` (empty string when no params).
+ */
+export declare function serializeTableUrlState(state: TableUrlState, search: string, { defaultPageSize, paramKeys, }?: {
+    defaultPageSize?: number;
+    paramKeys?: TableUrlParamKeys;
+}): string;
+/**
+ * Router-agnostic hook that syncs controlled table state (pagination / sorting
+ * / column filters) to and from the URL query string via `history.pushState` +
+ * `popstate`. Depends only on `window.location` / `window.history`, so it works
+ * with any router (or none). Query keys are namespaced (`tbl_*`) so they never
+ * collide with other params on the same URL. Reads initial state from the URL,
+ * so a bookmarked link restores the table's view.
+ */
+export declare function useTableUrlState(options?: UseTableUrlStateOptions): UseTableUrlStateResult;

package/dist/src/index.d.ts

@@ -0,0 +1,72 @@
+export { cn } from './lib/utils';
+export * from './hooks';
+export { PortalContainerProvider, usePortalContainer, type PortalContainerProviderProps, } from './lib/portal-container';
+export * from './components/ui/accordion';
+export * from './components/ui/alert';
+export * from './components/ui/app-shell';
+export * from './components/ui/app-shell-chat';
+export * from './components/ui/auth-layout';
+export * from './components/ui/avatar';
+export * from './components/ui/breadcrumb';
+export * from './components/ui/button';
+export * from './components/ui/button-menu';
+export * from './components/ui/calendar';
+export * from './components/ui/card';
+export * from './components/ui/card-filter';
+export * from './components/ui/chart';
+export * from './components/ui/checkbox';
+export * from './components/ui/chip';
+export * from './components/ui/collapsible';
+export * from './components/ui/combobox';
+export * from './components/ui/data-table';
+export * from './components/ui/date-range-picker';
+export * from './components/ui/description-list';
+export * from './components/ui/dialog';
+export * from './components/ui/dropdown-menu';
+export * from './components/ui/empty';
+export * from './components/ui/field';
+export * from './components/ui/grid';
+export * from './components/ui/form';
+export * from './components/ui/radio';
+export * from './components/ui/input';
+export * from './components/ui/input-date-picker';
+export * from './components/ui/input-search';
+export * from './components/ui/input-select';
+export * from './components/ui/input-text';
+export * from './components/ui/input-text-area';
+export * from './components/ui/label';
+export * from './components/ui/link';
+export * from './components/ui/number-field';
+export * from './components/ui/page-content';
+export * from './components/ui/page-header';
+export * from './components/ui/pagination';
+export * from './components/ui/popover';
+export * from './components/ui/progress';
+export * from './components/ui/progress-circle';
+export * from './components/ui/scroll-area';
+export * from './components/ui/search-global';
+export { InputText as Input, type InputTextProps as InputProps, } from './components/ui/input-text';
+export { InputSearch as Search, type InputSearchProps as SearchProps, } from './components/ui/input-search';
+export { InputTextArea as Textarea, type InputTextAreaProps as TextareaProps, } from './components/ui/input-text-area';
+export * from './components/ui/section';
+export * from './components/ui/select';
+export * from './components/ui/separator';
+export * from './components/ui/sheet';
+export * from './components/ui/skeleton';
+export * from './components/ui/slider';
+export * from './components/ui/spinner';
+export * from './components/ui/stack';
+export * from './components/ui/resizable';
+export * from './components/ui/sidebar-primary';
+export * from './components/ui/sidebar-secondary';
+export * from './components/ui/button-icon';
+export * from './components/ui/filter-search';
+export * from './components/ui/switch';
+export * from './components/ui/table';
+export * from './components/ui/tabs';
+export * from './components/ui/toast';
+export * from './components/ui/toggle-group';
+export * from './components/ui/tooltip';
+export * from './components/ui/tag';
+export { Tag as Badge, type TagProps as BadgeProps, } from './components/ui/tag';
+export * from './components/ui/widget-placeholder';

package/dist/src/lib/__tests__/breakpoints.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/lib/__tests__/deep-equal.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/lib/__tests__/use-doc-dir.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/lib/breakpoints.d.ts

@@ -0,0 +1,8 @@
+export declare const ROOT_FONT_SIZE_PX = 16;
+export declare const BREAKPOINT_LG: number;
+export declare const BREAKPOINT_XL: number;
+export declare const BREAKPOINT_2XL: number;
+export declare const BREAKPOINT_3XL: number;
+export declare const BREAKPOINT_4XL: number;
+/** SSR-safe `window.innerWidth` read — `undefined` when there is no `window` (e.g. SSR). */
+export declare function getViewportWidth(): number | undefined;

package/dist/src/lib/deep-equal.d.ts

@@ -0,0 +1,2 @@
+/** Recursively compares two values for structural equality (arrays and plain objects). */
+export declare function deepEqual(a: unknown, b: unknown): boolean;

package/dist/src/lib/portal-container.d.ts

@@ -0,0 +1,36 @@
+import * as React from 'react';
+export interface PortalContainerProviderProps {
+    /**
+     * The DOM element portaled content should render into (e.g. a `<div>` inside
+     * a shadow root). When set, every ui-react portaling component
+     * (`Popover`, `DropdownMenu`, `Tooltip`, `Dialog`, `Sheet`, `Select`,
+     * `Combobox`, `Toast`) will mount its popup inside this element instead of
+     * `document.body`.
+     */
+    container: HTMLElement | null;
+    children: React.ReactNode;
+}
+/**
+ * Provides a default portal container for all ui-react portaling components.
+ *
+ * Wrap your app (or a subtree) so that popups, dialogs, tooltips, toasts, etc.
+ * render inside the given container instead of `document.body`. This is the
+ * recommended way for shadow-DOM MFEs to keep portaled content inside the
+ * shadow root where adopted stylesheets apply.
+ *
+ * Individual components' `portalContainer` prop overrides this context.
+ *
+ * @example
+ * ```tsx
+ * // Inside a shadow-DOM MFE — all portals go into the shadow root
+ * <PortalContainerProvider container={shadowRootMountDiv}>
+ *   <App />
+ * </PortalContainerProvider>
+ * ```
+ */
+export declare function PortalContainerProvider({ container, children }: PortalContainerProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the portal container set by the nearest `PortalContainerProvider`,
+ * or `undefined` if none exists (letting Base UI default to `document.body`).
+ */
+export declare function usePortalContainer(): HTMLElement | null | undefined;