@thkl/agrid 0.1.11 → 0.1.12

package/README.md

@@ -72,14 +72,69 @@ be dragged.
 `confirmRowDelete` protects grid delete actions with a localized in-row Yes/No confirmation.
 Direct calls to `AgridDataSource.removeRow()` remain immediate.
 
-`enableRowMarking` adds a checkbox to each control cell. Marked rows are included in keyboard,
-cell-context, and row-context copy operations. Read `grid.markedRowIndices()` or call
+`enableRowMarking` makes each control-cell row header clickable and adds a checkbox. Clicking the
+header outside its nested controls toggles the same mark state and emits `(rowMark)` with the row,
+its original datasource index, and the resulting `marked` state. Marked rows are included in
+keyboard, cell-context, and row-context copy operations. Read `grid.markedRowIndices()` or call
 `grid.clearMarkedRows()` when the host needs to inspect or reset the copy basket.
 
 Marking is independent from row selection. Cell and range copy use the same copied columns for
 every marked row, while Copy row uses every visible column. Duplicate rows are omitted, and marked
 rows remain included when filters hide them.
 
+Selecting numeric cells displays a live status bar with count, sum, average, minimum, and maximum.
+Read the same values from `grid.selectionSummary()`. The signal is `null` when the active selection
+contains no finite numeric values.
+
+Set `enableColumnMarking: true` to toggle complete-column highlighting by clicking a header outside
+its menu and resize controls. The grid exposes `markedColumnFields()` and emits `(columnMark)`.
+
+Append custom commands to one column's menu and handle them through one typed output:
+
+```ts
+{ field: 'status', header: 'Status', headerMenuItems: [
+  { key: 'archive', label: 'Archive', icon: '⌂' },
+] }
+```
+
+```html
+<agrid [provider]="provider" (columnHeaderAction)="onColumnHeaderAction($event)" />
+```
+
+The event contains `{ column, key }`.
+
+Use `(firstDataRendered)` when host logic must wait until the grid has completed its first render
+containing datasource rows:
+
+```html
+<agrid [provider]="provider" (firstDataRendered)="onGridReady($event)" />
+```
+
+The event fires once per grid component. An initially empty datasource delays it until rows arrive.
+Server-side loading placeholders do not count as rendered data. The payload contains `rows`,
+`rowCount`, `provider`, and `datasource`.
+
+For commands that change `textAlign` at runtime, keep the writable signal in the host instead of
+mutating `event.column`:
+
+```ts
+readonly salaryAlignment = signal<'left' | 'center' | 'right'>('right');
+
+// Column definition
+{ field: 'salary', header: 'Salary', textAlign: this.salaryAlignment }
+
+onColumnHeaderAction(event: ColumnHeaderActionEvent<Employee>): void {
+  if (event.column.field !== 'salary') return;
+  if (event.key === 'align-left') this.salaryAlignment.set('left');
+  if (event.key === 'align-center') this.salaryAlignment.set('center');
+  if (event.key === 'align-right') this.salaryAlignment.set('right');
+}
+```
+
+Assigning `event.column.textAlign = 'center'` mutates plain configuration and does not trigger an
+Angular update. Calling `.set()` on `event.column.textAlign` is also not type-safe because the
+property may contain a static string or a read-only signal.
+
 ## Menu bar
 
 Set `menuBarItems` to render command buttons above the headers. An item with `items` becomes a
@@ -171,6 +226,10 @@ does not include. Numbers offer `=`, `≠`, `>`, `≥`, `<`, `≤`, and `between
 before / after / between. Conditions combine with the header text filter, value picker, and other
 columns using AND semantics, and are included in `AgridControl.toJSON()` state.
 
+The header arrow opens the complete column menu. The condition button beside the inline filter
+opens only the condition operator and operand controls; sorting, layout, grouping, custom commands,
+clear-all actions, and distinct-value selection remain in the complete menu.
+
 ```ts
 const columns: ColDef<Order>[] = [
   { field: 'reference', header: 'Reference', filterable: true },
@@ -316,6 +375,14 @@ tree.
 Tree mode can be combined with `masterDetail: true` and a `detailRenderer`. Detail expanders are
 shown only for leaf rows; parent rows retain their tree expand/collapse control.
 
+Set `detailColumnField` to a column field when the panel should expose one larger multiline value.
+The formatted value is shown normally; click it or focus it and press Enter to open a textarea.
+Blur or Ctrl/Cmd+Enter commits, while Escape cancels. Editability, validation, history, and edit
+events follow the linked column's normal cell behavior.
+Set `detailActions` to add text-template buttons above the textarea. Each action has an `id`,
+`label`, and optional `text` string or row-aware resolver; clicking inserts at the current
+selection, or appends if the button opens the textarea.
+
 ## Standalone tree control
 
 Use `<agrid-tree>` for the same parent-ID or path hierarchy without grid columns. It adds tree
@@ -453,7 +520,8 @@ Use `rowChanged` to send one request after the user edits one or more fields in
 ```ts
 saveRow(event: RowUpdateEvent<Person>): void {
   this.http.patch(`/api/people/${event.row.id}`, event.row).subscribe(() => {
-    this.grid()?.clearChangedCells(event.originalIndex);
+    this.provider.control.indicate(event.originalIndex, '#2da44e', 1000);
+    this.provider.control.clearChangedCells(event.originalIndex);
   });
 }
 ```
@@ -461,6 +529,8 @@ saveRow(event: RowUpdateEvent<Person>): void {
 The event fires with the latest complete row when inline navigation leaves that row, or when the
 sidebar editor Save button is used. `cellEdit` and `recordEdit` remain available for every committed
 field change. With `showChangedCellIndicator: true`, changed cells keep a corner marker until the
-PATCH succeeds. Override `--agrid-color-cell-changed` to customize its color.
+PATCH succeeds. Override `--agrid-color-cell-changed` to customize its color. Call
+`control.indicate(index, color, durationMs)` to flash a complete row for transient server-side
+feedback.
 
 Full documentation and demos: https://thkl.github.io/agrid/