@skygraph/react 0.0.0-placeholder.0 → 0.5.0

package/dist/Table-CpKMOH2x.d.cts

@@ -0,0 +1,1017 @@
+import React__default from 'react';
+import { TableOptions, RowId, Core, TableEngine, TableState, SortDirection, SortConfig, ColumnFilter, FilterOperator } from '@skygraph/core';
+import { B as BaseComponentProps, I as InteractiveProps, S as SizableProps } from './common-CdpocIEz.cjs';
+
+/** Locale strings for the Pagination component. */
+interface PaginationLocale {
+    /** Text shown before the total count (e.g. "Total"). */
+    totalPrefix?: string;
+    /** Label for the page-size selector (e.g. "items / page"). */
+    itemsPerPage?: string;
+    /** Label for the page-jump input (e.g. "Go to"). */
+    jump?: string;
+    /** Unit label for a page (e.g. "page"). */
+    page?: string;
+    /** Accessible name for the surrounding `<nav>` element. */
+    ariaLabel?: string;
+}
+/**
+ * Localizable strings for the `Table` component. This is the *single*
+ * canonical declaration; `complex/Table/types.ts` re-exports the same type
+ * to keep imports stable inside the Table subtree.
+ */
+interface TableLocale {
+    /** Empty state body text. */
+    emptyText?: React__default.ReactNode;
+    /** Filter reset button label. */
+    filterReset?: string;
+    /** Filter confirm button label. */
+    filterConfirm?: string;
+    /** Placeholder for filter list search. */
+    filterSearchPlaceholder?: string;
+    /** Message when filter search has no matches. */
+    filterEmptyText?: string;
+    /** Toolbar global search placeholder. */
+    searchPlaceholder?: string;
+    /** Ascending sort affordance in header. */
+    sortAsc?: React__default.ReactNode;
+    /** Descending sort affordance in header. */
+    sortDesc?: React__default.ReactNode;
+    /** Row/tree expander icon. */
+    expandIcon?: React__default.ReactNode;
+    /** Default column filter icon. */
+    filterIcon?: React__default.ReactNode;
+    /** Column search-mode filter icon. */
+    searchIcon?: React__default.ReactNode;
+    /** Formats total row count label. */
+    totalRows?: (count: number) => string;
+    /** Formats selection count in the summary bar. */
+    selectedRows?: (count: number) => string;
+    /** CSV export toolbar label. */
+    exportCSV?: string;
+    /** JSON export toolbar label. */
+    exportJSON?: string;
+    /** Copy table toolbar label. */
+    copyTable?: string;
+    /** Pin column to left context label. */
+    pinLeft?: string;
+    /** Pin column to right context label. */
+    pinRight?: string;
+    /** Unpin column context label. */
+    unpin?: string;
+    /** Column visibility menu trigger label. */
+    showColumns?: string;
+    /** Print toolbar label. */
+    print?: string;
+    /** Enter fullscreen label. */
+    fullscreen?: string;
+    /** Exit fullscreen label. */
+    exitFullscreen?: string;
+    /** Density menu trigger label. */
+    density?: string;
+    /** Compact density option. */
+    densitySmall?: string;
+    /** Default density option. */
+    densityMiddle?: string;
+    /** Comfortable density option. */
+    densityLarge?: string;
+    /** Collapse all groups toolbar label. */
+    groupCollapse?: string;
+    /** Expand all groups toolbar label. */
+    groupExpand?: string;
+    /** Aggregate label for sum. */
+    sum?: string;
+    /** Aggregate label for average. */
+    avg?: string;
+    /** Aggregate label for count. */
+    count?: string;
+    /** Aggregate label for minimum. */
+    min?: string;
+    /** Aggregate label for maximum. */
+    max?: string;
+    /** Copy success toast (reserved). */
+    copiedToClipboard?: string;
+    /** Row number column header. */
+    rowNumber?: string;
+    /** Toolbar dropdown trigger label for picking a `groupBy` field. */
+    groupByLabel?: string;
+    /** "No grouping" option label inside the group-by dropdown. */
+    groupByNone?: string;
+    /** Placeholder for advanced filter scalar value input. */
+    filterAdvancedValuePlaceholder?: string;
+    /** Placeholder for advanced filter `in` / `notIn` comma-separated input. */
+    filterAdvancedInPlaceholder?: string;
+    /** Placeholder for the upper bound of `between` operator. */
+    filterAdvancedBetweenMaxPlaceholder?: string;
+    /** Operator label: equal. */
+    filterOpEq?: string;
+    /** Operator label: not equal. */
+    filterOpNeq?: string;
+    /** Operator label: less than. */
+    filterOpLt?: string;
+    /** Operator label: less than or equal. */
+    filterOpLte?: string;
+    /** Operator label: greater than. */
+    filterOpGt?: string;
+    /** Operator label: greater than or equal. */
+    filterOpGte?: string;
+    /** Operator label: between (inclusive). */
+    filterOpBetween?: string;
+    /** Operator label: in list. */
+    filterOpIn?: string;
+    /** Operator label: not in list. */
+    filterOpNotIn?: string;
+    /** Operator label: contains substring. */
+    filterOpContains?: string;
+    /** Operator label: starts with. */
+    filterOpStartsWith?: string;
+    /** Operator label: ends with. */
+    filterOpEndsWith?: string;
+    /** Operator label: is empty / null. */
+    filterOpIsEmpty?: string;
+    /** Operator label: is not empty. */
+    filterOpIsNotEmpty?: string;
+    /** Accessible label for the filter-operator `<Select>`. */
+    filterOperatorAriaLabel?: string;
+}
+/** Locale strings for the DataGrid component. */
+interface DataGridLocale {
+    /** Text shown when the grid has no data. */
+    noData?: string;
+    /** Label for the "Select all" action. */
+    selectAll?: string;
+}
+/** Locale strings for the Modal component. */
+interface ModalLocale {
+    /** Label for the OK / confirm button. */
+    okText?: string;
+    /** Label for the Cancel button. */
+    cancelText?: string;
+    /** Accessible name for the close (×) button. */
+    closeAriaLabel?: string;
+}
+/** Locale strings for the Popconfirm component. */
+interface PopconfirmLocale {
+    /** Label for the OK / confirm button. */
+    okText?: string;
+    /** Label for the Cancel button. */
+    cancelText?: string;
+}
+/** Locale strings for the Empty component. */
+interface EmptyLocale {
+    /** Default description shown when no data is available. */
+    description?: string;
+}
+/** Locale strings for form-related components. */
+interface FormLocale {
+    /** Marker text for required fields. */
+    required?: string;
+    /** Marker text for optional fields. */
+    optional?: string;
+    /** Label for the submit button. */
+    submitText?: string;
+    /** Label for the reset button. */
+    resetText?: string;
+}
+/** Locale strings for the Upload component. */
+interface UploadLocale {
+    /** Label for the upload trigger. */
+    uploadText?: string;
+    /** Label for the remove-file action. */
+    removeFile?: string;
+    /** Text shown when an upload fails. */
+    uploadError?: string;
+    /** Label for the preview-file action. */
+    previewFile?: string;
+    /** Accessible name for the upload-file `<input type="file">`. */
+    uploadAriaLabel?: string;
+}
+/** Locale strings for the Transfer component. */
+interface TransferLocale {
+    /** Titles for the left and right lists. */
+    titles?: [string, string];
+    /** Placeholder for the search input inside lists. */
+    searchPlaceholder?: string;
+    /** Singular unit label for items (e.g. "item"). */
+    itemUnit?: string;
+    /** Plural unit label for items (e.g. "items"). */
+    itemsUnit?: string;
+    /** Content shown when no items match the search. */
+    notFoundContent?: string;
+    /** Label for the "Select all" checkbox. */
+    selectAll?: string;
+    /** Label for the "Deselect all" checkbox. */
+    deselectAll?: string;
+}
+/** Locale strings for the Calendar component. */
+interface CalendarLocale {
+    /** Localized month names (12 entries). */
+    monthNames?: string[];
+    /** Localized day-of-week names (7 entries, starting from Sunday or Monday depending on locale). */
+    dayNames?: string[];
+    /** Label for the "Today" button. */
+    today?: string;
+    /** Label for the "Now" shortcut when picking date + time. */
+    now?: string;
+    /** Column header for the ISO week number when `showWeekNumber` is enabled. */
+    week?: string;
+    /** Tooltip on the "previous year" navigation button. */
+    prevYear?: string;
+    /** Tooltip on the "next year" navigation button. */
+    nextYear?: string;
+    /** Tooltip on the "previous month" navigation button. */
+    prevMonth?: string;
+    /** Tooltip on the "next month" navigation button. */
+    nextMonth?: string;
+}
+/** Locale strings for the InputPassword component. */
+interface InputPasswordLocale {
+    /** Accessible label for the visibility toggle when password is hidden. */
+    showPassword?: string;
+    /** Accessible label for the visibility toggle when password is visible. */
+    hidePassword?: string;
+}
+/** Locale strings for the SearchInput component. */
+interface SearchInputLocale {
+    /** Accessible label for the clear (×) button. */
+    clear?: string;
+}
+/** Locale strings for the InlineEdit component. */
+interface InlineEditLocale {
+    /** Accessible label for the save (✓) button. */
+    save?: string;
+    /** Accessible label for the cancel (✕) button. */
+    cancel?: string;
+}
+/** Locale strings for the TagInput component. */
+interface TagInputLocale {
+    /**
+     * Formats the per-tag remove (×) button accessible label.
+     * Default: `(tag) => `Remove ${tag}``.
+     */
+    removeTag?: (tag: string) => string;
+}
+/** Locale strings for the Drawer component. */
+interface DrawerLocale {
+    /** Accessible label for the close button. */
+    closeAriaLabel?: string;
+}
+/** Locale strings for the Notification component. */
+interface NotificationLocale {
+    /** Accessible label for the close button on each toast. */
+    closeAriaLabel?: string;
+}
+/** Locale strings for the Tag component. */
+interface TagLocale {
+    /** Accessible label for the close (×) button on closable tags. */
+    closeAriaLabel?: string;
+}
+/** Locale strings for the Spin component. */
+interface SpinLocale {
+    /** Accessible label for the spinner role. */
+    loading?: string;
+}
+/** Locale strings for the Skeleton component. */
+interface SkeletonLocale {
+    /** Accessible label announced while content is loading. */
+    loading?: string;
+}
+/** Locale strings for the Breadcrumb component. */
+interface BreadcrumbLocale {
+    /** Accessible name for the surrounding `<nav>` element. */
+    ariaLabel?: string;
+}
+/** Locale strings for the Carousel component. */
+interface CarouselLocale {
+    /** Formats the per-slide indicator accessible label. Default `(i) => `Slide ${i}``. */
+    slide?: (index: number) => string;
+}
+/** Locale strings for the Rate component. */
+interface RateLocale {
+    /** Accessible label for the radio-group root. */
+    ariaLabel?: string;
+    /** Formats the per-star accessible label (default `(n) => `${n} star${n > 1 ? 's' : ''}``). */
+    star?: (count: number) => string;
+}
+/** Locale strings for the Charts components. */
+interface ChartsLocale {
+    /** Accessible label for `<LineChart>`. */
+    lineChart?: string;
+    /** Accessible label for `<BarChart>`. */
+    barChart?: string;
+    /** Accessible label for `<AreaChart>`. */
+    areaChart?: string;
+    /** Accessible label for `<PieChart>`. */
+    pieChart?: string;
+    /** Accessible label for `<ChartLegend>`. */
+    legend?: string;
+    /** Accessible label for the hover-toolbar `<div role="toolbar">`. */
+    actions?: string;
+}
+/** Locale strings for the DatePicker / RangePicker components. */
+interface DatePickerLocale {
+    /** Tooltip on the "previous year" navigation button. */
+    prevYear?: string;
+    /** Tooltip on the "next year" navigation button. */
+    nextYear?: string;
+    /** Tooltip on the "previous month" navigation button. */
+    prevMonth?: string;
+    /** Tooltip on the "next month" navigation button. */
+    nextMonth?: string;
+}
+/** Locale strings for the Cascader component. */
+interface CascaderLocale {
+    /** Placeholder for the search input inside the dropdown. */
+    searchPlaceholder?: string;
+    /** Empty-state text shown when search has no matches. */
+    noMatches?: string;
+}
+/** Locale strings for the TreeSelect component. */
+interface TreeSelectLocale {
+    /** Placeholder for the search input inside the dropdown. */
+    searchPlaceholder?: string;
+    /** Empty-state text shown when search has no matches. */
+    noMatches?: string;
+}
+/** Locale strings for the Dashboard / DashboardEditor components. */
+interface DashboardLocale {
+    /** Accessible label for the dashboard root. */
+    ariaLabel?: string;
+    /** Accessible label for the editor root (DashboardEditor). */
+    editorAriaLabel?: string;
+    /** Accessible label for the per-widget resize handle. */
+    resizeWidget?: string;
+    /** Accessible label for the widget actions (≡ menu) trigger. */
+    widgetActions?: string;
+}
+/** Locale strings for the Gantt component. */
+interface GanttLocale {
+    /** Accessible label for the gantt root. */
+    ariaLabel?: string;
+    /** Accessible label for the per-task resize handle. */
+    resizeTask?: string;
+}
+/** Locale strings for the ResourceCalendar component. */
+interface ResourceCalendarLocale {
+    /** Accessible label for the calendar root. */
+    ariaLabel?: string;
+    /** Accessible label for the resource lane. Default `(name) => `Resource ${name}``. */
+    resource?: (name: string) => string;
+    /** Accessible label for capacity. Default `(n) => `capacity ${n} per slot``. */
+    capacity?: (capacityPerSlot: number) => string;
+    /** Accessible label for the start-side resize handle. */
+    resizeStart?: string;
+    /** Accessible label for the end-side resize handle. */
+    resizeEnd?: string;
+    /** Suffix appended to the assignment aria-label when status is conflict. Default ` (conflict)`. */
+    conflictSuffix?: string;
+}
+/** Locale strings for the Timeline component (both the simple and event variants). */
+interface TimelineLocale {
+    /** Accessible label for the timeline root. */
+    ariaLabel?: string;
+}
+/** Locale strings for the SchemaFormEditor component. */
+interface SchemaFormEditorLocale {
+    /** Tooltip / aria-label for the undo button. */
+    undo?: string;
+    /** Tooltip / aria-label for the redo button. */
+    redo?: string;
+    /** Accessible label for the per-option remove (×) button in the inspector. */
+    removeOption?: string;
+    /** Accessible label for the read-only generated JSON `<pre>`. */
+    schemaView?: string;
+    /** Inspector "Label" placeholder. */
+    optionLabelPlaceholder?: string;
+    /** Inspector "Value" placeholder. */
+    optionValuePlaceholder?: string;
+    /** Per-field action: move up. */
+    moveFieldUp?: string;
+    /** Per-field action: move down. */
+    moveFieldDown?: string;
+    /** Per-field action: duplicate. */
+    duplicateField?: string;
+    /** Per-field action: delete. */
+    deleteField?: string;
+}
+/** Root locale object that aggregates all component-level locales. */
+interface SgLocale {
+    /** Table locale overrides. */
+    table?: TableLocale;
+    /** Pagination locale overrides. */
+    pagination?: PaginationLocale;
+    /** DataGrid locale overrides. */
+    dataGrid?: DataGridLocale;
+    /** Modal locale overrides. */
+    modal?: ModalLocale;
+    /** Popconfirm locale overrides. */
+    popconfirm?: PopconfirmLocale;
+    /** Empty locale overrides. */
+    empty?: EmptyLocale;
+    /** Form locale overrides. */
+    form?: FormLocale;
+    /** Upload locale overrides. */
+    upload?: UploadLocale;
+    /** Transfer locale overrides. */
+    transfer?: TransferLocale;
+    /** Calendar locale overrides. */
+    calendar?: CalendarLocale;
+    /** InputPassword locale overrides. */
+    inputPassword?: InputPasswordLocale;
+    /** SearchInput locale overrides. */
+    searchInput?: SearchInputLocale;
+    /** InlineEdit locale overrides. */
+    inlineEdit?: InlineEditLocale;
+    /** TagInput locale overrides. */
+    tagInput?: TagInputLocale;
+    /** Drawer locale overrides. */
+    drawer?: DrawerLocale;
+    /** Notification locale overrides. */
+    notification?: NotificationLocale;
+    /** Tag locale overrides. */
+    tag?: TagLocale;
+    /** Spin locale overrides. */
+    spin?: SpinLocale;
+    /** Skeleton locale overrides. */
+    skeleton?: SkeletonLocale;
+    /** Breadcrumb locale overrides. */
+    breadcrumb?: BreadcrumbLocale;
+    /** Carousel locale overrides. */
+    carousel?: CarouselLocale;
+    /** Rate locale overrides. */
+    rate?: RateLocale;
+    /** Charts locale overrides. */
+    charts?: ChartsLocale;
+    /** DatePicker / RangePicker locale overrides. */
+    datePicker?: DatePickerLocale;
+    /** Cascader locale overrides. */
+    cascader?: CascaderLocale;
+    /** TreeSelect locale overrides. */
+    treeSelect?: TreeSelectLocale;
+    /** Dashboard / DashboardEditor locale overrides. */
+    dashboard?: DashboardLocale;
+    /** Gantt locale overrides. */
+    gantt?: GanttLocale;
+    /** ResourceCalendar locale overrides. */
+    resourceCalendar?: ResourceCalendarLocale;
+    /** Timeline (event timeline + step timeline) locale overrides. */
+    timeline?: TimelineLocale;
+    /** SchemaFormEditor locale overrides. */
+    schemaFormEditor?: SchemaFormEditorLocale;
+}
+
+/**
+ * Слот-API: публичный контракт для точечной стилизации сложных компонентов.
+ * См. `docs/styling-contract.md` §2.2, §4.
+ *
+ * - `classNames?: XxxClassNames` — дополнительный класс на конкретный слот;
+ * - `styles?: XxxStyles` — инлайн-стили на конкретный слот;
+ * - `className` / `style` (на корне) — применяются дополнительно к `classNames.root` / `styles.root`;
+ * - порядок: дефолтный класс библиотеки → пользовательский слот-класс → корневой `className`.
+ */
+/** Мапа `слот → className`. */
+type SlotClassNames<K extends string> = Partial<Record<K, string>>;
+/** Мапа `слот → React.CSSProperties`. */
+type SlotStyles<K extends string> = Partial<Record<K, React__default.CSSProperties>>;
+
+/**
+ * Параметры печати для {@link printElement} и `ref.print()` методов
+ * компонентов (Table / Diagram / Charts).
+ *
+ * Дизайн осознанно skinny: всё, что выходит за пределы CSS `@page` и не
+ * требует runtime-зависимости, — отдано пользователю через `customStyles`.
+ */
+interface PrintOptions {
+    /**
+     * Заголовок popup-окна, используется браузером как `document.title`
+     * (а в "Save as PDF" — как имя файла по умолчанию).
+     */
+    fileName?: string;
+    /** Ориентация страницы. @default 'portrait' */
+    orientation?: 'portrait' | 'landscape';
+    /**
+     * CSS-значение для `@page { size }`. Стандартные ключевые слова
+     * (`'A4'`, `'Letter'`, `'A3'`, `'Legal'`) или custom-строка
+     * (`'210mm 297mm'`).
+     * @default 'A4'
+     */
+    pageSize?: 'A4' | 'A3' | 'A5' | 'Letter' | 'Legal' | string;
+    /**
+     * Множитель `transform: scale(...)` на корневом контейнере popup-страницы.
+     * Полезно когда исходный фрагмент шире страницы.
+     * @default 1
+     */
+    scale?: number;
+    /**
+     * Поля страницы (`@page { margin }`). Строка как есть подставляется в
+     * CSS, поэтому "1cm", "10mm 20mm" и т.п. — все валидны.
+     * @default '1cm'
+     */
+    margins?: string;
+    /**
+     * Дополнительный CSS, инжектируемый поверх стилей SkyGraph. Применяется
+     * последним, поэтому селекторы из этой строки имеют максимальный приоритет
+     * при равной специфичности.
+     */
+    customStyles?: string;
+    /**
+     * Не вызывать `window.print()` автоматически — popup откроется и останется
+     * под управлением вызывающего кода (для тестов / кастомных сценариев).
+     * @default false
+     */
+    skipPrint?: boolean;
+    /**
+     * Не закрывать popup после печати. По умолчанию popup закрывается через
+     * `window.close()` сразу после возврата из `print()`.
+     * @default false
+     */
+    keepOpen?: boolean;
+}
+/**
+ * Возможные значения prop `printable` на компонентах с поддержкой
+ * `ref.print()` (`Table`, `Diagram`, `LineChart`, `BarChart`, `AreaChart`,
+ * `PieChart`).
+ *
+ * - `false` / `undefined` — печать отключена (toolbar-кнопок не появляется,
+ *   `ref.print()` всё равно работает на компонентах с ref).
+ * - `true` — печать включена с дефолтами.
+ * - `{ fileName?: '...' }` — печать включена, имя popup-окна переопределено.
+ */
+type PrintableProp = boolean | {
+    fileName?: string;
+};
+
+interface UseTableOptions extends TableOptions {
+    data?: Array<{
+        id: RowId;
+        data: Record<string, unknown>;
+    }>;
+}
+type FilterFn = (row: Record<string, unknown>) => boolean;
+interface UseTableReturn {
+    core: Core;
+    table: TableEngine;
+    visibleRows: Array<{
+        id: RowId;
+        data: Record<string, unknown>;
+    }>;
+    tableState: TableState;
+    /** Snapshot of pinned columns; refreshes after `pinColumn` / `clearPinned`. */
+    pinnedColumns: {
+        left: string[];
+        right: string[];
+    };
+    /** Snapshot of persisted column widths; refreshes after `setColumnWidth` /
+     *  `clearColumnWidths`. */
+    columnWidths: Record<string, number>;
+    setSort: (column: string, direction: SortDirection) => void;
+    setSorts: (sorts: SortConfig[]) => void;
+    clearSort: () => void;
+    addFilter: (filter: ColumnFilter) => void;
+    removeFilter: (column: string) => void;
+    clearFilters: () => void;
+    setFilterFn: (fn: FilterFn | null) => void;
+    setPage: (page: number) => void;
+    nextPage: () => void;
+    prevPage: () => void;
+    pinColumn: (column: string, side: 'left' | 'right' | null) => void;
+    clearPinned: () => void;
+    setColumnWidth: (column: string, width: number) => void;
+    clearColumnWidths: () => void;
+    refresh: () => void;
+}
+declare function useTable(options?: UseTableOptions): UseTableReturn;
+
+/** One entry in a table context menu. */
+interface ContextMenuItem {
+    /** Unique key among siblings. */
+    key: string;
+    /** Primary label. */
+    label: React__default.ReactNode;
+    /** Optional leading icon. */
+    icon?: React__default.ReactNode;
+    /** Destructive styling. */
+    danger?: boolean;
+    /** Disables click handling. */
+    disabled?: boolean;
+    /** Renders a separator instead of a row. */
+    divider?: boolean;
+    /** Invoked on item activate. */
+    onClick?: () => void;
+    /** Nested submenu items. */
+    children?: ContextMenuItem[];
+}
+
+/**
+ * Имена слотов `Table` для пропов `classNames` / `styles`.
+ * Полный список и описания — `docs/styling-contract.md` §4.1.
+ */
+type TableSlot = 'root' | 'toolbar' | 'scroll' | 'grid' | 'headerRow' | 'headerCell' | 'headerCellContent' | 'row' | 'bodyCell' | 'empty' | 'pagination' | 'footer';
+/** Мапа `слот → className` для `Table`. */
+type TableClassNames = SlotClassNames<TableSlot>;
+/** Мапа `слот → inline-style` для `Table`. */
+type TableStyles = SlotStyles<TableSlot>;
+
+/** Cell merge span metadata from `onCell`. */
+interface CellSpan {
+    /** Vertical span count; `0` hides the cell. */
+    rowSpan?: number;
+    /** Horizontal span count; `0` hides the cell. */
+    colSpan?: number;
+}
+/** Props passed to a custom column filter dropdown. */
+interface FilterDropdownProps {
+    /** Filter values currently selected in the dropdown. */
+    selectedKeys: unknown[];
+    /** Updates selected filter values before confirm. */
+    setSelectedKeys: (keys: unknown[]) => void;
+    /** Applies the current selection and closes the dropdown. */
+    confirm: () => void;
+    /** Clears active filters for the column. */
+    clearFilters: () => void;
+    /** Closes the dropdown without applying. */
+    close: () => void;
+}
+/** Built-in footer aggregate operation identifiers. */
+type AggregateType = 'sum' | 'avg' | 'count' | 'min' | 'max';
+/** Column definition for `Table` (leaf or group parent). */
+interface TableColumn {
+    /** Unique column key matching row data fields. */
+    key: string;
+    /** Header label or node. */
+    title: React__default.ReactNode;
+    /** Default column width in pixels. */
+    width?: number;
+    /** Minimum width when resizing. */
+    minWidth?: number;
+    /** Enables click-to-sort on this column. */
+    sortable?: boolean;
+    /** Shows a drag handle to resize the column. */
+    resizable?: boolean;
+    /** Allows in-cell editing when `onCellEdit` is set on the table. */
+    editable?: boolean;
+    /** Sticky column position. */
+    fixed?: 'left' | 'right';
+    /** Truncates overflowing cell text with ellipsis. */
+    ellipsis?: boolean;
+    /** Cell text alignment. */
+    align?: 'left' | 'center' | 'right';
+    /** Hides the column when true. */
+    hidden?: boolean;
+    /** Preset filter options for the column filter menu. */
+    filters?: Array<{
+        text: string;
+        value: unknown;
+    }>;
+    /** Predicate to test if a row matches a filter value. */
+    onFilter?: (value: unknown, row: Record<string, unknown>) => boolean;
+    /** Custom filter dropdown UI or render function. */
+    filterDropdown?: React__default.ReactNode | ((props: FilterDropdownProps) => React__default.ReactNode);
+    /** Custom filter icon in the header. */
+    filterIcon?: React__default.ReactNode | ((filtered: boolean) => React__default.ReactNode);
+    /** When false, filter mode is single-select radio. */
+    filterMultiple?: boolean;
+    /** Enables or customizes filter option search in the menu. */
+    filterSearch?: boolean | ((input: string, record: {
+        text: string;
+        value: unknown;
+    }) => boolean);
+    /**
+     * Filter UI mode:
+     *  - `'menu'` — preset list with checkboxes (default).
+     *  - `'search'` — single search input.
+     *  - `'advanced'` — operator picker + value input (`AdvancedFilter`).
+     */
+    filterMode?: 'menu' | 'search' | 'advanced';
+    /**
+     * Список доступных операторов в `advanced`-моде. По умолчанию выводится
+     * полный набор кроме строгих строковых операторов (для нестроковых полей).
+     * Передайте свой массив, чтобы ограничить пользователя.
+     */
+    advancedFilterOperators?: FilterOperator[];
+    /**
+     * Тип значения колонки — подсказка для `advanced`-режима, чтобы выбрать
+     * корректный input (`number` / `text`) и стартовый набор операторов.
+     * @default 'text'
+     */
+    advancedFilterType?: 'text' | 'number';
+    /** Controlled active filter values for the column. */
+    filteredValue?: unknown[];
+    /** Initial filter values for uncontrolled usage. */
+    defaultFilteredValue?: unknown[];
+    /** Custom cell content renderer. */
+    render?: (value: unknown, row: Record<string, unknown>, id: RowId) => React__default.ReactNode;
+    /** Returns rowspan/colspan for the cell at this row index. */
+    onCell?: (row: Record<string, unknown>, rowIndex: number) => CellSpan;
+    /** Child columns for grouped headers. */
+    children?: TableColumn[];
+    /** Small info icon with this content in the header. */
+    tooltip?: string | React__default.ReactNode;
+    /** Extra class for body cells. */
+    cellClassName?: string | ((value: unknown, row: Record<string, unknown>, id: RowId) => string);
+    /** Extra class for header cell of this column. */
+    headerClassName?: string;
+    /** Shows a copy-to-clipboard control on the cell. */
+    copyable?: boolean;
+    /** Footer aggregate for this column (built-in name or custom reducer). */
+    aggregate?: AggregateType | ((values: unknown[]) => React__default.ReactNode);
+}
+/** Controlled row selection configuration. */
+interface RowSelectionConfig {
+    /** Keys of currently selected rows. */
+    selectedKeys: RowId[];
+    /** Called when selection changes. */
+    onChange: (keys: RowId[], rows: Array<Record<string, unknown>>) => void;
+    /** Selection control type. */
+    type?: 'checkbox' | 'radio';
+}
+/** Expandable row configuration. */
+interface ExpandableConfig {
+    /** Renders content below the row when expanded. */
+    expandedRowRender: (row: Record<string, unknown>, id: RowId) => React__default.ReactNode;
+    /** Controlled expanded row keys. */
+    expandedKeys?: RowId[];
+    /** Keys expanded on first mount when `expandedKeys` is not controlled. */
+    defaultExpandedRowKeys?: RowId[];
+    /** Fires when a row expand state toggles. */
+    onExpand?: (expanded: boolean, id: RowId) => void;
+    /** Limits which rows show an expand control. */
+    rowExpandable?: (row: Record<string, unknown>) => boolean;
+}
+/** Tree-shaped row data options for the table. */
+interface TreeConfig {
+    /** Row field holding nested rows (default `children`). */
+    childrenColumnName?: string;
+    /** Pixels per tree depth level. */
+    indentSize?: number;
+    /** Starts with all tree nodes expanded. */
+    defaultExpandAllRows?: boolean;
+}
+/** One cell in a custom summary row from `summary`. */
+interface SummaryCell {
+    /** Cell body. */
+    content: React__default.ReactNode;
+    /** Horizontal span in the summary grid. */
+    colSpan?: number;
+    /** Text alignment. */
+    align?: 'left' | 'center' | 'right';
+}
+/** Configuration for the optional row number column. */
+interface RowNumberConfig {
+    /** Header title for the row number column. */
+    title?: React__default.ReactNode;
+    /** Column width in pixels. */
+    width?: number;
+    /** Pins the row number column. */
+    fixed?: 'left';
+}
+/** Row ids pinned to the top or bottom of the scroll area. */
+interface PinnedRowsConfig {
+    /** Row ids rendered in a block above the main body. */
+    top?: RowId[];
+    /** Row ids rendered in a block below the main body. */
+    bottom?: RowId[];
+}
+/** Internal metadata for a grouped header row in the body. */
+interface GroupRow {
+    /** Marks this synthetic row as a group header. */
+    __isGroup: true;
+    /** Stable key for the group (stringified value). */
+    groupKey: string;
+    /** Raw grouping value. */
+    groupValue: unknown;
+    /** Number of rows in the group. */
+    count: number;
+    /** Whether child rows are visible. */
+    expanded: boolean;
+    /** Per-column aggregate display for the group header. */
+    aggregates: Record<string, React__default.ReactNode>;
+}
+/** Action button in the selection summary bar. */
+interface SelectionSummaryAction {
+    /** Stable action key. */
+    key: string;
+    /** Button label. */
+    label: React__default.ReactNode;
+    /** Invoked with current selection when the action is clicked. */
+    onClick: (selectedKeys: RowId[], selectedRows: Array<Record<string, unknown>>) => void;
+    /** Destructive styling hint. */
+    danger?: boolean;
+}
+/**
+ * Props for the `Table` component: column model, selection, scrolling, and toolbar features.
+ * Styling and interaction props from `BaseComponentProps`, `InteractiveProps`, and `SizableProps` are inherited without per-prop docs here.
+ */
+interface TableProps extends Omit<UseTableOptions, 'columns'>, BaseComponentProps, InteractiveProps, SizableProps {
+    /** Column definitions (leaf and/or grouped). */
+    columns: TableColumn[];
+    /** Dataset rows bound to the table engine (from `useTable` options). */
+    data?: Array<{
+        id: RowId;
+        data: Record<string, unknown>;
+    }>;
+    /** Page size for built-in pagination (from table engine options). */
+    pageSize?: number;
+    /** Row selection state and callbacks. */
+    rowSelection?: RowSelectionConfig;
+    /** Optional expandable row renderer. */
+    expandable?: ExpandableConfig;
+    /** Renders hierarchical rows from nested data. */
+    tree?: TreeConfig;
+    /** Sticky header while scrolling vertically. */
+    sticky?: boolean;
+    /** Enables column reorder by drag-and-drop in the header. */
+    draggable?: boolean;
+    /** Shows toolbar search across visible columns. */
+    searchable?: boolean;
+    /** @default true */
+    showPagination?: boolean;
+    /** Outlined table borders. */
+    bordered?: boolean;
+    /** Horizontal and/or vertical scroll constraints. */
+    scroll?: {
+        x?: number | string;
+        y?: number | string;
+    };
+    /** Custom summary rows below the body. */
+    summary?: (data: Array<{
+        id: RowId;
+        data: Record<string, unknown>;
+    }>) => SummaryCell[][];
+    /** Row click handler. */
+    onRowClick?: (id: RowId, data: Record<string, unknown>) => void;
+    /** Commits inline cell edit values. */
+    onCellEdit?: (id: RowId, column: string, value: unknown) => void;
+    /** Called after header columns are reordered by drag-and-drop. */
+    onColumnOrderChange?: (order: string[]) => void;
+    /** Extra class for each body row. */
+    rowClassName?: string | ((row: Record<string, unknown>, id: RowId) => string);
+    /** Overrides default locale strings. */
+    locale?: TableLocale;
+    /** Enables shift-click multi-column sort. */
+    multiSort?: boolean;
+    /** Controlled multi-sort model. */
+    sorts?: SortConfig[];
+    /** Fires when multi-sort state changes. */
+    onSortsChange?: (sorts: SortConfig[]) => void;
+    /** Enables dragging body rows to reorder. */
+    rowDraggable?: boolean;
+    /** Called after row reorder via drag-and-drop. */
+    onRowOrderChange?: (fromIndex: number, toIndex: number) => void;
+    /** Builds context menu items for a header cell. */
+    headerContextMenu?: (column: TableColumn) => ContextMenuItem[];
+    /** Builds context menu items for a body cell. */
+    cellContextMenu?: (id: RowId, column: string, data: Record<string, unknown>) => ContextMenuItem[];
+    /** Shows column visibility controls in the toolbar. */
+    columnVisibility?: boolean;
+    /** Controlled hidden column keys. */
+    hiddenColumns?: string[];
+    /** Fires when visible columns change. */
+    onHiddenColumnsChange?: (keys: string[]) => void;
+    /** Enables pin/unpin via header context menu. */
+    columnPinning?: boolean;
+    /** Fires when a column pin side changes. */
+    onColumnPinChange?: (key: string, fixed: 'left' | 'right' | undefined) => void;
+    /**
+     * Виртуализирует тело таблицы для больших датасетов.
+     *
+     *  - `true` — фиксированная высота 40px.
+     *  - `{ rowHeight: 60 }` — фиксированная высота 60px.
+     *  - `{ rowHeight: (row, id) => h }` — динамическая высота, переданная
+     *    функция используется как эстимейт до того, как `ResizeObserver`
+     *    отчитается о реальной высоте каждой строки.
+     *  - `{ rowHeight: 40, estimateRowHeight: (row) => h }` — то же самое,
+     *    но с явным разделением "первое значение / эстимейт-callback".
+     */
+    virtual?: boolean | {
+        /**
+         * Стартовое значение высоты строки. Число — фиксированный фоллбэк
+         * (быстрый путь). Функция — включает динамическое измерение через
+         * ResizeObserver, вызываясь как эстимейт до первого реального
+         * измерения.
+         */
+        rowHeight?: number | ((row: Record<string, unknown>, id: RowId) => number);
+        /**
+         * Дополнительный эстимейт высоты, разрешает динамическое измерение
+         * даже при числовом `rowHeight`. Имеет приоритет над `rowHeight`-
+         * фоллбэком при выборе размера до измерения.
+         */
+        estimateRowHeight?: (row: Record<string, unknown>, id: RowId) => number;
+        overscan?: number;
+        height?: number | string;
+    };
+    /** Shows CSV export and copy actions in the toolbar. */
+    exportable?: boolean;
+    /** Custom export handler; default downloads CSV. */
+    onExport?: (data: string[][]) => void;
+    /** Shows a bar when rows are selected. */
+    selectionSummary?: boolean;
+    /** Buttons rendered in the selection summary bar. */
+    selectionActions?: SelectionSummaryAction[];
+    /** Zebra striping on body rows. */
+    striped?: boolean;
+    /** Page size selector on the pagination control. */
+    showSizeChanger?: boolean;
+    /** Options for page size selector. */
+    pageSizeOptions?: number[];
+    /** Quick jump to page input on pagination. */
+    showQuickJumper?: boolean;
+    /** Total / range label on pagination. */
+    showTotal?: boolean | ((total: number, range: [number, number]) => React__default.ReactNode);
+    /** Fires when page size changes. */
+    onPageSizeChange?: (size: number) => void;
+    /** Prepends a row index column. */
+    showRowNumber?: boolean | RowNumberConfig;
+    /** Shows aggregate values in a footer row. */
+    footer?: boolean;
+    /** Fullscreen toggle in the toolbar. */
+    fullscreenable?: boolean;
+    /** Density (row height) selector in the toolbar. */
+    densityToggle?: boolean;
+    /** Field key to group rows by. */
+    groupBy?: string;
+    /** Starts with all groups expanded. */
+    defaultGroupExpanded?: boolean;
+    /** Fires when a group expand state changes. */
+    onGroupExpandChange?: (groupKey: string, expanded: boolean) => void;
+    /**
+     * Optional list of fields the user can pick to group by from the toolbar
+     * dropdown. When omitted, the dropdown is hidden and only the controlled
+     * `groupBy` value is used.
+     */
+    groupByOptions?: Array<{
+        key: string;
+        label: React__default.ReactNode;
+    }>;
+    /** Called when the user picks a different `groupBy` field from the toolbar. */
+    onGroupByChange?: (field: string | null) => void;
+    /** Arrow-key focus navigation between cells. */
+    keyboardNavigation?: boolean;
+    /** Pins specific row ids to top or bottom. */
+    pinnedRows?: PinnedRowsConfig;
+    /** Replaces default empty state content. */
+    emptyContent?: React__default.ReactNode;
+    /**
+     * Print action in the toolbar и/или включение `ref.print()`.
+     *
+     * `true` — стандартная кнопка в тулбаре.
+     * `{ fileName?: string }` — кнопка + имя popup-окна (используется браузером
+     *   как заголовок и дефолтное имя файла в "Save as PDF").
+     * `false` / `undefined` — кнопки нет; `ref.print()` всё равно работает.
+     */
+    printable?: PrintableProp;
+    /** JSON export action in the toolbar. */
+    exportJSON?: boolean;
+    /** Row hover highlight; set false to disable. */
+    highlightOnHover?: boolean;
+    /** Double-click resize handle fits column to content. */
+    columnAutoResize?: boolean;
+    /**
+     * Дополнительные классы по слотам. Публичный API — см. `docs/styling-contract.md` §4.1.
+     * Имена слотов стабильны, классы-значения применяются поверх встроенных `.sg-table-*`.
+     */
+    classNames?: TableClassNames;
+    /** Инлайн-стили по слотам. Публичный API — см. `docs/styling-contract.md` §4.1. */
+    styles?: TableStyles;
+}
+/** One cell in a multi-row header grid. */
+interface HeaderCell {
+    /** Column at this header position. */
+    col: TableColumn;
+    /** Horizontal span in header grid units. */
+    colSpan: number;
+    /** Vertical span in header grid units. */
+    rowSpan: number;
+}
+/** Flattened row model passed to body renderers. */
+interface FlatRow {
+    /** Row id. */
+    id: RowId;
+    /** Row field values. */
+    data: Record<string, unknown>;
+    /** Tree depth when tree mode is enabled. */
+    depth: number;
+    /** Whether the row has nested children in tree mode. */
+    hasChildren: boolean;
+    /** Present when this row is a group header. */
+    __groupRow?: GroupRow;
+}
+
+/**
+ * Императивный API таблицы для ref.print() и других ref-методов.
+ */
+interface TableRef {
+    /**
+     * Открыть popup и вызвать window.print() для текущей DOM-области таблицы.
+     * Опции мерджатся с теми, что заданы через prop `printable`
+     * (на уровне prop приоритетен `fileName`).
+     */
+    print: (opts?: PrintOptions) => void;
+}
+/**
+ * Data table — основная экспортная функция (forwardRef-обёртка над `TableInner`).
+ * Ref-методы — см. `TableRef`.
+ */
+declare const Table: React__default.ForwardRefExoticComponent<TableProps & React__default.RefAttributes<TableRef>>;
+
+export { type TreeSelectLocale as $, type AggregateType as A, type BreadcrumbLocale as B, type CellSpan as C, type DashboardLocale as D, type ExpandableConfig as E, type FilterDropdownProps as F, type GroupRow as G, type HeaderCell as H, type InlineEditLocale as I, type RateLocale as J, type ResourceCalendarLocale as K, type SchemaFormEditorLocale as L, type ModalLocale as M, type NotificationLocale as N, type SearchInputLocale as O, type PinnedRowsConfig as P, type SkeletonLocale as Q, type RowNumberConfig as R, type SelectionSummaryAction as S, Table as T, type UseTableOptions as U, type SpinLocale as V, type TableRef as W, type TagInputLocale as X, type TagLocale as Y, type TimelineLocale as Z, type TransferLocale as _, type FlatRow as a, type UploadLocale as a0, type RowSelectionConfig as b, type SummaryCell as c, type TableColumn as d, type TableLocale as e, type TableProps as f, type TreeConfig as g, type UseTableReturn as h, type SgLocale as i, type PrintOptions as j, type CalendarLocale as k, type PrintableProp as l, type SlotClassNames as m, type SlotStyles as n, type CarouselLocale as o, type CascaderLocale as p, type ChartsLocale as q, type DatePickerLocale as r, type DrawerLocale as s, type EmptyLocale as t, useTable as u, type FormLocale as v, type GanttLocale as w, type InputPasswordLocale as x, type PaginationLocale as y, type PopconfirmLocale as z };