@kouji-ui/core 0.9.2 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kouji-ui/core",
-  "version": "0.9.2",
+  "version": "0.11.0",
   "description": "Headless Angular UI primitives — signal-driven directives with WCAG 2.1 AAA semantics, no CDK, and a handful of opt-in global stylesheets.",
   "license": "MIT",
   "repository": {

package/types/kouji-ui-core.d.ts

@@ -12141,6 +12141,25 @@ declare class KjTable<TData extends RowData = unknown> {
      * row index. Mirrors TanStack's `getRowId` option.
      */
     kjGetRowId: _angular_core.InputSignal<((row: TData, index: number) => string) | undefined>;
+    /**
+     * Tree rows: returns a row's children (TanStack `getSubRows`). Children are
+     * real table rows with the same columns, shown under their parent while it
+     * is expanded. `undefined` (default) keeps the table flat.
+     */
+    kjGetSubRows: _angular_core.InputSignal<((row: TData, index: number) => readonly TData[] | undefined) | undefined>;
+    /**
+     * Tree rows: whether selecting a parent also selects its children
+     * (TanStack `enableSubRowSelection`). Defaults to `false` — every row is
+     * selected on its own.
+     */
+    kjSelectSubRows: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Tree rows: whether parents start expanded. Applies to every parent with
+     * no explicit expanded state — on first render, to rows loaded later, and
+     * again after {@link resetExpansion} (an infinite table's request change).
+     * Defaults to `false`.
+     */
+    kjDefaultExpanded: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly _state;
     /**
      * The full table state as a single deep signal. Call `state()` for the
@@ -12169,6 +12188,46 @@ declare class KjTable<TData extends RowData = unknown> {
     readonly rowCount: _angular_core.Signal<number | null>;
     readonly manualPagination: _angular_core.Signal<boolean>;
     setRowCount(n: number | null): void;
+    /**
+     * Server-side infinite mode. When on, `kjTableData` is index-aligned with
+     * the server's result set and may hold holes (`undefined` / `null`) for
+     * rows that are not loaded yet: the holes are dropped before the rows reach
+     * TanStack, and {@link sourceIndex} maps each loaded row back to its
+     * position in the full result set. Sorting, filtering and pagination are
+     * left to the server (TanStack's `manual*` flags), so a header click only
+     * changes `state.sorting()` — feed it into your loader's request.
+     */
+    private readonly _infinite;
+    /** Whether server-side infinite mode is on — see {@link setInfinite}. */
+    readonly infinite: _angular_core.Signal<boolean>;
+    /**
+     * Turn server-side infinite mode on or off.
+     * @param on `true` while the data is a sparse window of a server result set.
+     */
+    setInfinite(on: boolean): void;
+    /**
+     * Whether a tree parent with no explicit entry in `state.expanded` is open.
+     * Starts at `kjDefaultExpanded`; {@link expandAll} / {@link collapseAll}
+     * flip it so rows loaded later follow the last bulk action.
+     */
+    private readonly _expandDefault;
+    /**
+     * `state.expanded` as TanStack sees it. Open-by-default with no exceptions
+     * is handed over as `true`: TanStack skips expansion altogether for an
+     * empty record, and `getIsRowExpanded` still keeps leaf rows closed.
+     */
+    private readonly tanstackExpanded;
+    /** Whether a row is expanded: its explicit state, else the tree default for parents. */
+    private isRowExpanded;
+    /** Rows handed to TanStack plus, in infinite mode, their positions in the full result set. */
+    private readonly compacted;
+    /**
+     * In infinite mode, the result-set position of each loaded top-level row,
+     * indexed by its TanStack `row.index`; `null` otherwise.
+     */
+    readonly sourceIndex: _angular_core.Signal<readonly number[] | null>;
+    /** Position of a top-level row in the full result set (its `row.index` outside infinite mode). */
+    private sourceIndexOf;
     /**
      * Apply a TanStack updater (value or function) to a single state slice.
      *
@@ -12192,6 +12251,32 @@ declare class KjTable<TData extends RowData = unknown> {
     private readonly boundColumns;
     /** The TanStack table instance. Access rows, headers, and state here. */
     readonly table: () => Table<TData>;
+    constructor();
+    /**
+     * Whether every loaded parent row is expanded (`false` when no row has
+     * children). Rows of an infinite table that are not loaded yet do not count.
+     */
+    readonly isAllExpanded: _angular_core.Signal<boolean>;
+    /**
+     * Whether a row is expanded — its own choice, else `kjDefaultExpanded`
+     * (or the last expand-all / collapse-all) for parents.
+     * @param row The row.
+     */
+    getRowExpanded(row: Row<TData>): boolean;
+    /**
+     * Expand or collapse one row. Unlike TanStack's `row.toggleExpanded()`, the
+     * choice is stored explicitly, so it holds against `kjDefaultExpanded`.
+     * @param row The row.
+     * @param expanded The new state; omitted, the current one flips.
+     * @returns The row's new expanded state.
+     */
+    setRowExpanded(row: Row<TData>, expanded?: boolean): boolean;
+    /** Expand every parent row, including the ones loaded later. */
+    expandAll(): void;
+    /** Collapse every parent row, including the ones loaded later. */
+    collapseAll(): void;
+    /** Forget per-row expansion and go back to `kjDefaultExpanded` — e.g. when the rows are replaced. */
+    resetExpansion(): void;
     /** Merge a partial state. Unspecified slices are left untouched. */
     setState(partial: Partial<KjTableState>): void;
     /** Reset every slice back to the directive's default state. */
@@ -12212,7 +12297,7 @@ declare class KjTable<TData extends RowData = unknown> {
      */
     get columnApi(): KjColumnApi<TData>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KjTable<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KjTable<any>, "[kjTable]", ["kjTable"], { "kjTable": { "alias": "kjTable"; "required": true; "isSignal": true; }; "kjTableData": { "alias": "kjTableData"; "required": false; "isSignal": true; }; "kjGetRowId": { "alias": "kjGetRowId"; "required": false; "isSignal": true; }; }, { "kjTableData": "kjTableDataChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KjTable<any>, "[kjTable]", ["kjTable"], { "kjTable": { "alias": "kjTable"; "required": true; "isSignal": true; }; "kjTableData": { "alias": "kjTableData"; "required": false; "isSignal": true; }; "kjGetRowId": { "alias": "kjGetRowId"; "required": false; "isSignal": true; }; "kjGetSubRows": { "alias": "kjGetSubRows"; "required": false; "isSignal": true; }; "kjSelectSubRows": { "alias": "kjSelectSubRows"; "required": false; "isSignal": true; }; "kjDefaultExpanded": { "alias": "kjDefaultExpanded"; "required": false; "isSignal": true; }; }, { "kjTableData": "kjTableDataChange"; }, never, never, true, never>;
 }
 
 /** Sort direction for table columns. */
@@ -12302,13 +12387,19 @@ declare class KjTableSort {
 declare class KjTableRow<TData extends RowData = unknown> {
     /** TanStack row instance — pass from getRowModel().rows. */
     kjRow: _angular_core.InputSignal<_tanstack_angular_table.Row<TData>>;
+    /**
+     * Overrides the 1-based `aria-rowindex` — for rows whose place in the grid
+     * is not their `row.index`, like the children of a tree row. `null`
+     * (default) derives it from the row.
+     */
+    kjAriaRowIndex: _angular_core.InputSignal<number | null>;
     private readonly table;
     /** 1-based ARIA index — accounts for header row(s). */
     readonly ariaRowIndex: _angular_core.Signal<number>;
     readonly isSelectable: _angular_core.Signal<boolean>;
     readonly isSelected: _angular_core.Signal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KjTableRow<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KjTableRow<any>, "[kjTableRow]", never, { "kjRow": { "alias": "kjRow"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KjTableRow<any>, "[kjTableRow]", never, { "kjRow": { "alias": "kjRow"; "required": true; "isSignal": true; }; "kjAriaRowIndex": { "alias": "kjAriaRowIndex"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**