@konce-pt/react 0.12.0 → 0.14.0

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

@@ -1,35 +1,56 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
 import { type KptI18nOverrides } from '../i18n/i18n-context.tsx';
+import { type KptSpeechColor } from '../speech/speech-button.tsx';
 import type { KptCellEditEvent, KptCellEditRenderers, KptCellRenderers, KptColumn, KptTableLazyState } from './data-table-types.ts';
 export interface KptDataTableProps<T> extends Omit<ComponentPropsWithRef<'div'>, 'onSelect' | 'children'>, KptI18nOverrides {
     columns: readonly KptColumn[];
     data?: readonly T[];
     /** Pole filtra globalnego w pasku narzędzi. */
     filterable?: boolean;
+    /**
+     * Mikrofon przy filtrze globalnym (wymaga `filterable`). Kliknięcie czyści filtr, a jedna
+     * podyktowana fraza staje się nowym filtrem. Bez wsparcia przeglądarki się nie pokazuje.
+     */
+    filterSpeech?: boolean;
+    /** Język dyktowania filtra (BCP 47); bez niego z `KptI18nProvider`. */
+    filterSpeechLang?: string;
+    /** Kolor "stop" i fali w trakcie nasłuchu; domyślnie kolor motywu. */
+    filterSpeechColor?: KptSpeechColor;
     filterRowPosition?: 'top' | 'bottom';
     /** Rozmiar strony; 0 wyłącza paginację. */
     pageSize?: number;
     pageSizeOptions?: readonly number[];
     selectable?: 'none' | 'single' | 'multiple';
-    /** Trwa ładowanie — tabela dostaje `aria-busy`, a ciało pokazuje komunikat `dataTable.loading`. */
+    /** Trwa ładowanie - tabela dostaje `aria-busy`, a ciało pokazuje komunikat `dataTable.loading`. */
     loading?: boolean;
     /** Nazwa dostępna tabeli, gdy nie ma widocznego podpisu (`caption`). */
     ariaLabel?: string | null;
-    /** Widoczny podpis tabeli (`<caption>`) — zarazem jej nazwa dla czytnika. */
+    /** Widoczny podpis tabeli (`<caption>`) - zarazem jej nazwa dla czytnika. */
     caption?: string | null;
     /**
      * Wiersze jako akcja: fokusowalne (Tab) i aktywowane Enterem/Spacją, które wołają `onRowClick`.
-     * Domyślnie włączone, gdy podano `onRowClick` — inaczej klik w wiersz działałby tylko myszą.
+     * Domyślnie włączone, gdy podano `onRowClick` - inaczej klik w wiersz działałby tylko myszą.
      */
     clickableRows?: boolean;
     emptyMessage?: string;
     /** Pole identyfikujące wiersz; bez niego wiersze porównujemy po referencji. */
     rowKey?: string | null;
     scrollHeight?: string | null;
-    /** Wirtualizacja wierszy; wymaga `scrollHeight`. */
+    /**
+     * Wirtualizacja dla dużych zbiorów: renderuje tylko widoczne wiersze **i kolumny** (z buforem).
+     * Wymaga `scrollHeight`. Tabela przechodzi na `table-layout: fixed` - szerokości kolumn
+     * liczone są z `width` w `px`/`rem`/`em`, a pozostałe (brak, `%`, `ch`) dostają `columnWidth`.
+     */
     virtualScroll?: boolean;
+    /** Szerokość kolumny bez liczalnego `width` w trybie `virtualScroll` (`px`/`rem`/`em`). */
+    columnWidth?: string;
     rowHeight?: number;
     reorderable?: boolean;
+    /**
+     * Przykleja kolumny systemowe (rozwijanie, zaznaczanie) do lewej krawędzi także bez kolumn `frozen`.
+     * Z kolumnami `frozen` kolumny systemowe kleją się zawsze.
+     */
+    frozenSystemColumns?: boolean;
     exportable?: boolean;
     exportFilename?: string;
     /** Tryb serwerowy: bez filtrowania, sortowania i paginacji po stronie klienta. */
@@ -38,7 +59,7 @@ export interface KptDataTableProps<T> extends Omit<ComponentPropsWithRef<'div'>,
     expandable?: boolean;
     multiExpand?: boolean;
     summaryLabel?: string;
-    /** Gotowe wartości podsumowania (pole → wartość); nadpisują wyliczenia, w `lazy` są jedynym źródłem. */
+    /** Gotowe wartości podsumowania (pole -> wartość); nadpisują wyliczenia, w `lazy` są jedynym źródłem. */
     summaryValues?: Record<string, unknown> | null;
     selection?: T[];
     defaultSelection?: T[];
@@ -53,13 +74,13 @@ export interface KptDataTableProps<T> extends Omit<ComponentPropsWithRef<'div'>,
     /** Tryb lazy: woła się na starcie (pierwsza strona) i po każdej zmianie sortowania/filtra/strony. */
     onLazyLoad?: (state: KptTableLazyState) => void;
     onCellEdit?: (event: KptCellEditEvent<T>) => void;
-    /** Szablony komórek: pole → funkcja renderująca. */
+    /** Szablony komórek: pole -> funkcja renderująca. */
     cells?: KptCellRenderers<T>;
-    /** Własne edytory komórek: pole → funkcja renderująca. */
+    /** Własne edytory komórek: pole -> funkcja renderująca. */
     cellEditors?: KptCellEditRenderers<T>;
     /** Treść rozwiniętego wiersza (wymaga `expandable`). */
     renderRowDetail?: (row: T) => ReactNode;
     /** Treść po lewej stronie paginatora (odpowiednik slotu `[kptPaginatorActions]`). */
     paginatorActions?: ReactNode;
 }
-export declare function KptDataTable<T = Record<string, unknown>>({ columns, data, filterable, filterRowPosition, pageSize, pageSizeOptions, selectable, loading, ariaLabel, caption, clickableRows, emptyMessage, rowKey, scrollHeight, virtualScroll, rowHeight, reorderable, exportable, exportFilename, lazy, totalRecords, expandable, multiExpand, summaryLabel, summaryValues, selection, defaultSelection, onSelectionChange, expandedRows, defaultExpandedRows, onExpandedRowsChange, hiddenFields, defaultHiddenFields, onHiddenFieldsChange, onRowClick, onLazyLoad, onCellEdit, cells, cellEditors, renderRowDetail, paginatorActions, locale, dictionary, className, style, ...rest }: Readonly<KptDataTableProps<T>>): import("react").JSX.Element;
+export declare function KptDataTable<T = Record<string, unknown>>({ columns, data, filterable, filterSpeech, filterSpeechLang, filterSpeechColor, filterRowPosition, pageSize, pageSizeOptions, selectable, loading, ariaLabel, caption, clickableRows, emptyMessage, rowKey, scrollHeight, virtualScroll, columnWidth, rowHeight, reorderable, frozenSystemColumns, exportable, exportFilename, lazy, totalRecords, expandable, multiExpand, summaryLabel, summaryValues, selection, defaultSelection, onSelectionChange, expandedRows, defaultExpandedRows, onExpandedRowsChange, hiddenFields, defaultHiddenFields, onHiddenFieldsChange, onRowClick, onLazyLoad, onCellEdit, cells, cellEditors, renderRowDetail, paginatorActions, locale, dictionary, className, style, ...rest }: Readonly<KptDataTableProps<T>>): import("react").JSX.Element;