@akcelik/strct 5.19.0 → 5.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "5.19.0",
+  "version": "5.21.0",
   "description": "UIStruct — a standalone Angular component library with a tokenised, multi-palette theme system, built for datacenter / infrastructure management UIs.",
   "author": "Serkan Akcelik <serkan.akcelik@gmail.com>",
   "license": "MIT",

package/types/akcelik-strct.d.ts

@@ -1028,7 +1028,7 @@ declare class StrctTag {
     readonly activated: _angular_core.OutputEmitterRef<void>;
     protected onActivate(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctTag, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTag, "strct-tag", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "activateLabel": { "alias": "activateLabel"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "mono": { "alias": "mono"; "required": false; "isSignal": true; }; }, { "removed": "removed"; "activated": "activated"; }, never, ["[strctTagLeading]", "*", "[strctTagLeading]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTag, "strct-tag", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "activateLabel": { "alias": "activateLabel"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "mono": { "alias": "mono"; "required": false; "isSignal": true; }; }, { "removed": "removed"; "activated": "activated"; }, never, ["[strctTagLeading]", "*"], true, never>;
 }
 
 /** Avatar size variants. */
@@ -4200,6 +4200,17 @@ interface StrctDatagridLabels {
      * reorders every row, a page replaces them, a filter hides most of them —
      * none of it is visible to someone who cannot see the table.
      */
+    /** The resize separator's name, per column. */
+    resizeColumn: (column: string) => string;
+    /** The two empty states, and the way out of the filtered one. */
+    noMatches: string;
+    noMatchesFor: (query: string) => string;
+    clearFilters: string;
+    /** The bulk-selection escape: the page is selected, everything is not. */
+    pageSelected: (shown: number) => string;
+    selectAllCount: (total: number) => string;
+    allSelected: (total: number) => string;
+    clearSelection: string;
     sortedAscending: (column: string) => string;
     sortedDescending: (column: string) => string;
     sortCleared: string;
@@ -4536,6 +4547,14 @@ declare class StrctDatagrid {
         quickFilter: string;
         loadMore: string;
         showing: (shown: number, total?: number) => string;
+        resizeColumn: (column: string) => string;
+        noMatches: string;
+        noMatchesFor: (query: string) => string;
+        clearFilters: string;
+        pageSelected: (shown: number) => string;
+        selectAllCount: (total: number) => string;
+        allSelected: (total: number) => string;
+        clearSelection: string;
         sortedAscending: (column: string) => string;
         sortedDescending: (column: string) => string;
         sortCleared: string;
@@ -4709,13 +4728,31 @@ declare class StrctDatagrid {
     private readonly selected;
     protected readonly selectedCount: _angular_core.Signal<number>;
     private readonly expandedRows;
-    private readonly columnWidths;
+    protected readonly columnWidths: _angular_core.WritableSignal<Map<string, number>>;
     protected readonly hiddenColumns: _angular_core.WritableSignal<Set<string>>;
     protected readonly chooserOpen: _angular_core.WritableSignal<boolean>;
     private resizeState;
     private readonly onMove;
     private readonly onUp;
     colWidth(key: string): string | null;
+    /**
+     * A focusable separator owes ARIA a value, and a column that has never been
+     * resized has no stored width — so the header's real width is swept after
+     * render and whenever the grid resizes. Without it every handle was an
+     * `aria-required-attr` violation (12 of them on the showcase's own page).
+     */
+    private readonly measuredWidths;
+    protected separatorValue(key: string): number | null;
+    private sweepHeaderWidths;
+    /**
+     * The keyboard half of a resize: the arrows step 16px (4px with Shift for a
+     * fine adjustment), Home gives the column back its natural width. Steps are
+     * the only way a separator can be moved without a pointer.
+     */
+    protected onResizeKey(event: KeyboardEvent, key: string): void;
+    /** Give the column back the width the content asks for. */
+    protected resetWidth(key: string): void;
+    private setColumnWidth;
     onResizeStart(e: MouseEvent, key: string): void;
     private onResizeMove;
     private onResizeEnd;
@@ -4760,6 +4797,25 @@ declare class StrctDatagrid {
     protected setTextFilter(key: string, value: string): void;
     protected optionChecked(key: string, opt: unknown): boolean;
     protected toggleFilterOption(key: string, opt: unknown): void;
+    /**
+     * The escape every bulk workflow needs: the header tick selects the page,
+     * and nothing says the other pages exist. Offered only when the grid holds
+     * the rows — in `lazy` mode it cannot name rows the server has not sent,
+     * and selecting them would be a lie.
+     */
+    protected readonly bulkHint: _angular_core.Signal<{
+        text: string;
+        action: string;
+        run: () => void;
+    } | null>;
+    /** Select every row the filter allows, not only the page. */
+    selectAllFiltered(): void;
+    /** Rows exist, but nothing the filter allows — the undoable empty. */
+    protected readonly filteredAway: _angular_core.Signal<boolean>;
+    protected readonly anyFilter: _angular_core.Signal<boolean>;
+    protected noMatchesDescription(): string;
+    /** The way back out of the filtered empty state. */
+    protected clearAllFilters(): void;
     protected clearFilter(key: string): void;
     protected onDocClickOverlays(event: MouseEvent): void;
     /** Escape closes the topmost transient surface and hands focus back to its
@@ -4898,6 +4954,13 @@ declare class StrctDatagrid {
     private readonly vRange;
     /** The rows actually rendered: the virtual window, or the current page. */
     protected readonly renderRows: _angular_core.Signal<StrctRow[]>;
+    /**
+     * A virtual grid draws 23 rows of 20.000 and, without these, says it has
+     * 23. The count includes the header row, as the ARIA spec asks.
+     */
+    protected readonly ariaRowCount: _angular_core.Signal<number | null>;
+    /** 1 is the header row, so data rows start at 2. */
+    protected ariaRowIndex(row: StrctRow): number | null;
     protected readonly topPad: _angular_core.Signal<number>;
     protected readonly bottomPad: _angular_core.Signal<number>;
     protected readonly stickyActive: _angular_core.Signal<boolean>;
@@ -4959,6 +5022,8 @@ declare class StrctDatagrid {
     /** Last serialized column state pushed outward (loop guard). */
     private lastStateKey;
     constructor();
+    /** Whether the saved (or bound) column state has been read yet. */
+    private stateRestored;
     private readPersistedState;
     private applyColumnState;
     /** Whether a persisted or bound state has already decided what is hidden. */