@acronis-platform/ui-react 0.55.0 → 0.56.1

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

@@ -1 +1,3 @@
-export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, type TableRowProps, type TableHeadProps, } from './table';
+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

@@ -16,8 +16,20 @@ export interface TableHeadProps extends React.ThHTMLAttributes<HTMLTableCellElem
     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>>;
-declare const TableCell: React.ForwardRefExoticComponent<React.TdHTMLAttributes<HTMLTableCellElement> & 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/tooltip/tooltip.d.ts

@@ -1,12 +1,20 @@
 import { Tooltip as TooltipPrimitive } from '@base-ui/react/tooltip';
 import * as React from 'react';
-declare const TooltipProvider: React.FC<import('@base-ui/react').TooltipProviderProps>;
+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>>;

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

@@ -1,13 +1,16 @@
 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';
@@ -16,6 +19,7 @@ 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';

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/use-doc-dir.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Document direction — SSR-safe (defaults to 'ltr', syncs after mount).
+ * Checks both the `dir` attribute and the computed `direction` style so a
+ * page that sets RTL purely via CSS (no `dir` attribute) is still detected.
+ */
+export declare function useDocDir(): 'ltr' | 'rtl';