@akcelik/strct 4.9.0 → 4.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "4.9.0",
+  "version": "4.10.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

@@ -3503,6 +3503,19 @@ interface StrctDatagridColumn {
      * change in your handler and pass the updated array back in.
      */
     editable?: boolean;
+    /**
+     * Which editor an `editable` column opens. `'text'` (the default) is the
+     * free-text box; `'number'` opens `strct-number`, and `'select'` opens
+     * `strct-select` over `editorOptions` — a value that is one of a set is
+     * chosen, not typed. The cell shows the chosen option's label at rest.
+     */
+    editor?: 'text' | 'number' | 'select';
+    /** Options for `editor: 'select'` (the library's own option shape). */
+    editorOptions?: StrctOption[];
+    /** Bounds and step for `editor: 'number'`. */
+    editorMin?: number;
+    editorMax?: number;
+    editorStep?: number;
 }
 /** Per-column filter state: contains-text, or the checked value set. */
 type StrctDatagridFilters = Record<string, string | unknown[]>;
@@ -3742,12 +3755,20 @@ declare class StrctDatagrid {
     }>;
     /** Server-side data request (lazy mode): load this page / sort and set `rows`. */
     readonly lazyLoad: _angular_core.OutputEmitterRef<StrctDatagridLazyState>;
-    /** An editable cell was committed (Enter / blur). The grid does not mutate
-     *  rows — apply `value` to your data and pass the updated array back in. */
+    /** An editable cell was committed (Enter / blur, or choosing in a `select`
+     *  editor). The grid does not mutate rows — apply the value to your data and
+     *  pass the updated array back in. */
     readonly cellEdit: _angular_core.OutputEmitterRef<{
         row: StrctRow;
         column: StrctDatagridColumn;
+        /** The committed value as text — what a `text` editor produces. */
         value: string;
+        /**
+         * The same commit, typed: the number a `number` editor holds, or the
+         * option's `value` a `select` editor chose. `value` stays a string so
+         * handlers written against it keep working.
+         */
+        typedValue: unknown;
         previous: unknown;
     }>;
     private readonly menu;
@@ -3836,7 +3857,26 @@ declare class StrctDatagrid {
         colKey: string;
     } | null>;
     protected isEditingCell(row: StrctRow, col: StrctDatagridColumn): boolean;
+    /** The value a typed editor holds while it is open (committed on Enter / blur). */
+    protected readonly editDraft: _angular_core.WritableSignal<unknown>;
     protected startEdit(row: StrctRow, col: StrctDatagridColumn): void;
+    /** A select column reads as its option's label, not as the stored value. */
+    protected displayValue(row: StrctRow, col: StrctDatagridColumn): unknown;
+    /** Close the editor and emit `cellEdit` when the value actually changed. */
+    protected commitValue(row: StrctRow, col: StrctDatagridColumn, raw: unknown): void;
+    /** Enter / blur on a typed editor commits what it currently holds. */
+    protected commitDraft(row: StrctRow, col: StrctDatagridColumn, event?: Event): void;
+    /**
+     * A column that declares bounds means them: Enter commits what the field
+     * holds, and `strct-number` only clamps on blur, so the grid clamps here
+     * rather than letting an out-of-range value reach `cellEdit`.
+     */
+    private clampToColumn;
+    /**
+     * A number editor is a field between two stepper buttons, so focus moves
+     * inside it — only a move that actually leaves the editor is a blur.
+     */
+    protected commitOnLeave(row: StrctRow, col: StrctDatagridColumn, event: FocusEvent): void;
     protected commitEdit(row: StrctRow, col: StrctDatagridColumn, event: Event): void;
     protected cancelEdit(event?: Event): void;
     /**