@kouji-ui/core 0.10.0 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kouji-ui/core",
-  "version": "0.10.0",
+  "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
@@ -12186,6 +12205,20 @@ declare class KjTable<TData extends RowData = unknown> {
      * @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;
     /**
@@ -12218,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. */
@@ -12238,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. */
@@ -12328,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>;
 }
 
 /**