@starasia/admin 8.19.2 → 8.20.0

package/dist/components/TableLayout/TableLayout.d.ts

@@ -1,4 +1,4 @@
 import { default as React } from 'react';
 import { TableLayoutProps } from './types';
 
-export declare const TableLayout: <T>({ columns, data, getRowKey, rowBg, size, resizable, layout, widthStorageKey, columnState, onColumnStateChange, columnMenu, sort, defaultSort, onSortChange, height, mobileLayout, mobileBreakpoint, groupSeparator, summary, emptyState, loading, loadingRows, rowActions, }: TableLayoutProps<T>) => React.JSX.Element;
+export declare const TableLayout: <T>({ columns, data, getRowKey, rowBg, size, resizable, layout, widthStorageKey, columnState, onColumnStateChange, columnMenu, sort, defaultSort, onSortChange, height, mobileLayout, mobileBreakpoint, groupSeparator, summary, emptyState, loading, loadingRows, rowActions, selectable, selectedKeys, defaultSelectedKeys, onSelectionChange, isRowSelectable, }: TableLayoutProps<T>) => React.JSX.Element;

package/dist/components/TableLayout/index.d.ts

@@ -1,4 +1,4 @@
 export { TableLayout } from './TableLayout';
 export { ColumnMenu } from './ColumnMenu';
 export { useTableSortApiParams, type UseTableSortApiParamsOptions, type TableSortApiParams } from './hooks/useTableSortApiParams';
-export type { TableLayoutProps, TableLayoutColumn, TableLayoutColor, TableLayoutAlign, TableLayoutColumnState, TableLayoutCellProps, TableLayoutSort, TableLayoutSortDirection, TableLayoutRowAction } from './types';
+export type { TableLayoutProps, TableLayoutColumn, TableLayoutColor, TableLayoutAlign, TableLayoutColumnState, TableLayoutCellProps, TableLayoutSort, TableLayoutSortDirection, TableLayoutRowKey, TableLayoutRowAction } from './types';

package/dist/components/TableLayout/types.d.ts

@@ -40,6 +40,8 @@ export interface TableLayoutSort {
     key: string;
     direction: TableLayoutSortDirection;
 }
+/** Key baris terpilih (row selection) — selaras dengan return type `getRowKey`. */
+export type TableLayoutRowKey = string | number;
 /**
  * Atribut span/skip untuk satu cell body (kasus merge / rowspan-colspan).
  * Consumer yang menghitung merge-nya; TableLayout hanya menerapkan.
@@ -151,6 +153,37 @@ export interface TableLayoutProps<T> {
     rowActions?: TableLayoutRowAction<T>[];
     /** key unik per row; default pakai index */
     getRowKey?: (row: T, index: number) => string | number;
+    /**
+     * Aktifkan kolom checkbox di kiri untuk memilih baris (row selection).
+     * TableLayout HANYA mengelola state seleksi — checkbox per baris + select-all
+     * di header (berlaku untuk halaman yang sedang dirender saja, indeterminate
+     * saat sebagian terpilih). TIDAK ada bulk-action toolbar bawaan; consumer
+     * merender toolbar-nya sendiri dari `selectedKeys` / `onSelectionChange`.
+     * Toggle hanya lewat klik checkbox — klik row tidak mengubah seleksi.
+     *
+     * ⚠️ Saat dipakai dengan pagination/server data, WAJIB beri `getRowKey` yang
+     * stabil (mis. `r => r.id`) — default index membuat seleksi menempel ke
+     * POSISI baris, bukan ke datanya, saat data berganti halaman.
+     */
+    selectable?: boolean;
+    /**
+     * Baris terpilih (controlled). Isi dengan key hasil `getRowKey`; pasangkan
+     * dengan `onSelectionChange`. Tanpa ini → uncontrolled.
+     */
+    selectedKeys?: TableLayoutRowKey[];
+    /** seleksi awal (uncontrolled) */
+    defaultSelectedKeys?: TableLayoutRowKey[];
+    /**
+     * Dipanggil saat seleksi berubah. `keys` = SELURUH key terpilih (termasuk
+     * dari halaman lain pada mode controlled); `rows` = baris terpilih yang ada
+     * di `data` saat ini saja.
+     */
+    onSelectionChange?: (keys: TableLayoutRowKey[], rows: T[]) => void;
+    /**
+     * Return `false` → baris tidak bisa dipilih: checkbox-nya disabled dan
+     * dikecualikan dari hitungan/aksi select-all. Default: semua baris bisa.
+     */
+    isRowSelectable?: (row: T, index: number) => boolean;
     /**
      * Warnai SELURUH row berdasarkan data; return token/undefined. Diterapkan
      * sebagai background tint pada semua sel row (lewat CSS variable `--sa-tl-bg`,