@konce-pt/react 0.11.2 → 0.14.0

package/dist/context-menu/llms.txt

@@ -5,15 +5,15 @@ Import: `import { KptContextMenu } from '@konce-pt/react';`
 
 ## DOM
     <div class="kpt-context-menu-host">
-      <div class="kpt-context-menu__area">…children…</div>
+      <div class="kpt-context-menu__area">...children...</div>
       <div class="kpt-context-menu__backdrop"></div>
-      <div class="kpt-context-menu__panel" role="menu" style="left: 320px; top: 210px">…</div>
+      <div class="kpt-context-menu__panel" role="menu" style="left: 320px; top: 210px">...</div>
     </div>
 
 ## Props
-- `items`: `KptMenuItem<T>[]` — the same shape as `KptMenu`
-- `children`: ReactNode — the area that reacts to the right mouse button
-- `onSelect(item)` — the picked item
+- `items`: `KptMenuItem<T>[]` - the same shape as `KptMenu`
+- `children`: ReactNode - the area that reacts to the right mouse button
+- `onSelect(item)` - the picked item
 - `className`, `ref` and every other `<div>` prop go to the host
 
 ## Not an overlay
@@ -29,7 +29,7 @@ open the browser's own menu. Picking an item closes it and reports the choice; `
 The same model as `KptMenu` (the shared `menu-keys.ts`): opening moves focus to the first item, arrows /
 `Home` / `End` move between items (disabled ones and separators are skipped), `Escape` and `Tab` close
 it and focus returns to where it was. `Shift+F10` and the context-menu key on a focused element inside
-the area open it too — the browser then sends `contextmenu` without mouse coordinates, so the panel is
+the area open it too - the browser then sends `contextmenu` without mouse coordinates, so the panel is
 placed at that element. The panel is kept inside the viewport (8px from the edges). Touch screens have
 no right click, so still offer the same actions through a visible button with `KptMenu`.
 
@@ -42,5 +42,8 @@ no right click, so still offer the same actions through a visible button with `K
 `--kpt-color-surface-raised`, `--kpt-color-border`, `--kpt-elevation-3`, `--kpt-color-danger`.
 
 ## Accessibility
-The panel is `role="menu"` with `role="menuitem"` buttons at `tabindex="-1"` (one Tab stop). Keyboard — see
+The panel is `role="menu"` with `role="menuitem"` buttons at `tabindex="-1"` (one Tab stop). Keyboard - see
 "Keyboard" above.
+
+## Positioning
+The panel opens in the top layer (`popover="manual"`), so an ancestor with `transform`, `filter` or `backdrop-filter` (an animated card, a glass panel) no longer shifts it and `overflow: hidden` no longer clips it. Scrolling or resizing the window closes the menu.

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

@@ -22,7 +22,7 @@ export interface KptColumn {
     align?: 'start' | 'center' | 'end';
     /** Szerokość kolumny (np. '10rem', '20%'). Wymagana dla kolumn zamrożonych. */
     width?: string;
-    /** Zamrożenie (sticky) — obsługiwane dla wiodących, sąsiadujących kolumn. */
+    /** Zamrożenie (sticky) - obsługiwane dla wiodących, sąsiadujących kolumn. */
     frozen?: boolean;
     /** Filtr kolumny w wierszu nagłówka. */
     filter?: KptColumnFilter;
@@ -38,7 +38,7 @@ export interface KptCellEditEvent<T> {
     field: string;
     /** Nowa wartość. */
     value: unknown;
-    /** Wiersz po scaleniu ze zmienioną wartością — gotowe body PUT/PATCH. */
+    /** Wiersz po scaleniu ze zmienioną wartością - gotowe body PUT/PATCH. */
     updatedRow: T;
 }
 export type KptSortDir = 'asc' | 'desc' | null;
@@ -49,7 +49,7 @@ export interface KptTableLazyState {
     sortField: string | null;
     sortDir: KptSortDir;
     filter: string;
-    /** Wartości filtrów per kolumna (pole → wartość kontrolki). */
+    /** Wartości filtrów per kolumna (pole -> wartość kontrolki). */
     columnFilters: Record<string, unknown>;
 }
 /** Kontekst własnego edytora komórki (odpowiednik `kptCellEdit` z Angulara). */
@@ -61,7 +61,7 @@ export interface KptCellEditContext<T> {
     /** Porzuca zmianę. */
     cancel: () => void;
 }
-/** Szablony komórek: pole → funkcja renderująca (odpowiednik `kptCell`). */
+/** Szablony komórek: pole -> funkcja renderująca (odpowiednik `kptCell`). */
 export type KptCellRenderers<T> = Record<string, (row: T, value: unknown) => ReactNode>;
-/** Własne edytory komórek: pole → funkcja renderująca (odpowiednik `kptCellEdit`). */
+/** Własne edytory komórek: pole -> funkcja renderująca (odpowiednik `kptCellEdit`). */
 export type KptCellEditRenderers<T> = Record<string, (context: KptCellEditContext<T>) => ReactNode>;

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

@@ -1,25 +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`. */
     loading?: boolean;
+    /** Nazwa dostępna tabeli, gdy nie ma widocznego podpisu (`caption`). */
+    ariaLabel?: string | null;
+    /** 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ą.
+     */
+    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. */
@@ -28,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[];
@@ -40,15 +71,16 @@ export interface KptDataTableProps<T> extends Omit<ComponentPropsWithRef<'div'>,
     defaultHiddenFields?: readonly string[];
     onHiddenFieldsChange?: (fields: readonly string[]) => void;
     onRowClick?: (row: T) => void;
+    /** 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, 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;