@iyulab/flex-table 0.40.3 → 0.41.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## [0.41.0] - 2026-10-03
+
+### Added
+
+- **`mergeRepeated` column option — a run of repeated values reads as one merged cell.** For lists of
+  child rows under a parent (order lines under an order, boxes under a shipment), the parent's columns
+  no longer repeat on every line: the value shows once, on the run's first row, the lines inside the run
+  are dropped, and the run keeps one background. `true` merges equal values (empty values never merge);
+  a function `(row, previousRow, col) => boolean` decides by any rule — e.g. merge a customer only within
+  one order. Every row keeps its own value, so sorting, filtering, copying, export and screen readers
+  see each row as before. Rows are compared in display order; the value is drawn again on the first row
+  in view and below frozen rows, so scrolling or paging through a run never hides it.
+
+### Fixed
+
+- **Number entry reads a decimal comma.** The `number` cell editor and the number filter used the native
+  number input, which turns `1,5` into `15` or an empty value depending on the browser. Both are now text
+  fields with a decimal keyboard (`inputmode="decimal"`) that read numbers in the active `Locale` — `1,5`
+  is 1.5 and `1.234,5` is 1234.5 on a comma-decimal page — and the editor shows the current value with
+  that locale's decimal separator. The filter keeps what you typed while you type it and marks a condition
+  it cannot read (`aria-invalid`).
+- **Pasting `1,5` into a number column stores 1.5.** Pasted text was read with `Number()`, so a value from a
+  comma-decimal spreadsheet stayed text (`"1,5"`) and sorted and summed wrongly. Plain notation (`1e3`) is
+  still read; text that is not a number still stays text.
+- **The built-in editor rejects text that is not a number** in a `number` column. It fires
+  `validation-error` (`error`: "Enter a number") and keeps the old value, like a validator failure — the
+  native input never let such text through, so a text field must not store it.
+- The strict-autocomplete error ("Value must be from the existing list") follows the `Locale` (new keys
+  `notANumber` and `notInList` in `flexTableLocale`; `ko` built in).
+
+### Changed
+
+- **The `@iyulab/components` peer is `>=1.54.0`** — number parsing uses its `parseNumber`.
+
+- The optional `@lit/react` peer is `^1.0.8` (was `^1.0.0`) — the version the React entry is tested
+  with.
+
+### Documentation
+
+- README: the Accessibility section links the KWCAG 2.2 table in `@iyulab/components`.
+
 ## [0.40.3] - 2026-09-30
 
 ### Fixed
@@ -587,8 +628,6 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
-
 ## [0.23.1] - 2026-08-03
 
 ### Fixed

package/README.md

@@ -150,6 +150,7 @@ interface ColumnDefinition {
   editor?: CellEditor;     // Custom cell editor: (value, row, col) => TemplateResult
   validator?: CellValidator; // Validate before commit: (value, row, col) => string | null
   conditionalRules?: ConditionalRule[]; // Per-cell style rules, see below
+  mergeRepeated?: boolean | ((row, previousRow, col) => boolean); // Merge runs of repeated values, see below
 }
 ```
 
@@ -157,6 +158,8 @@ The `editor` callback must return a Lit `TemplateResult` containing an input ele
 
 The `validator` callback returns `null` if valid, or an error message string. On failure, the cell shows a red border for 3 seconds and a `validation-error` event is dispatched.
 
+A `number` column's built-in editor reads numbers the way people type them in the active `Locale` — `1,5` on a comma-decimal page is 1.5, `1.234,5` is 1234.5 — and shows the value with that locale's decimal separator. Text that is not a number is rejected the same way as a validator failure (`error` is the localized "Enter a number"). The number filter's conditions and pasted values are read the same way; pasted text that is not a number stays text.
+
 ### `format` vs `render`
 
 Both control how a cell's raw value is displayed, but they differ in what they replace:
@@ -193,6 +196,22 @@ const columns: ColumnDefinition<Order>[] = [
 
 Rules are evaluated in order and combined; later matching rules override earlier ones for overlapping style properties.
 
+### Merging Repeated Values
+
+A list of child rows under a parent — order lines under an order, boxes under a shipment — repeats the parent's columns on every line. `mergeRepeated` draws each run of repeated values as one merged cell: the value shows once, on the run's first row, and the lines between the run's rows are dropped.
+
+```typescript
+const columns: ColumnDefinition<OrderLine>[] = [
+  { key: 'orderNo', label: 'Order', mergeRepeated: true },
+  // Two adjacent orders can share a customer — merge only within one order.
+  { key: 'customer', label: 'Customer', mergeRepeated: (row, prev) => row.orderNo === prev.orderNo },
+  { key: 'product', label: 'Product' },
+  { key: 'qty', label: 'Qty', type: 'number' },
+];
+```
+
+Every row keeps its own value. Sorting, filtering, copying, CSV/XLSX export and screen readers see each row exactly as without merging — a filter that drops a run's first row leaves the rest of the run labelled, and an export pivots. Rows are compared in display order, so sort by the merged column (or keep the server's order) for runs to form. The value is drawn again on the first row in view and on the first row below frozen rows, so scrolling or paging through a run never hides it. With `true`, empty values (`null`, `undefined`, `''`) never merge.
+
 ## Methods
 
 ### Row Operations
@@ -209,7 +228,7 @@ Rules are evaluated in order and combined; later matching rules override earlier
 | Method | Returns | Description |
 |--------|---------|-------------|
 | `addColumn(def, index?)` | `ColumnDefinition` | Add column at position (default: end) |
-| `deleteColumn(key)` | `void` | Remove column + cleanup filters/sort/widths |
+| `deleteColumn(key)` | `void` | Remove column + cleanup filters/sort/widths. Row objects keep that key's values (undo restores the column with them); delete the key from `data` yourself if you need it gone |
 | `moveColumn(key, newIndex)` | `void` | Reorder column to target index (clamped) |
 | `getColumnWidth(key)` | `number \| undefined` | Get internal resize width for column |
 | `selectColumn(colIndex)` | `void` | Select entire column (range selection) |
@@ -257,7 +276,7 @@ All events use `CustomEvent` with `bubbles: true, composed: true`.
 | `cell-edit-start` | `{ row, col, key, value }` | Cell editing started |
 | `cell-edit-commit` | `{ row, col, key, oldValue, newValue }` | Cell value committed |
 | `cell-edit-cancel` | `{ row, col }` | Cell edit cancelled (Escape) |
-| `validation-error` | `{ row, col, key, value, error }` | Cell validator rejected value |
+| `validation-error` | `{ row, col, key, value, error }` | Cell validator rejected value, or a `number` cell got text that is not a number |
 
 ### Data Events
 
@@ -476,6 +495,8 @@ conformance claim for the success criteria it does not list.
 Not yet measured: the boolean and date filter dropdowns and the comment popup. Color contrast comes
 from the `@iyulab/components` tokens this package reads.
 
+For **KWCAG 2.2** (the Korean web accessibility standard), the `@iyulab/components` README has a table of all 33 check items — which are guaranteed by a test across the sibling packages, which are shared with the app, and which do not apply: [KWCAG 2.2 대응표](https://github.com/iyulab/node-components#kwcag-22-대응표).
+
 ## Usage Guide
 
 ### React

package/dist/clipboard/clipboard.d.ts

@@ -6,3 +6,8 @@ import type { ColumnDefinition, DataRow } from '../models/types.js';
  */
 export declare function copyToClipboard(data: DataRow[], columns: ColumnDefinition[], range: CellRange): string;
 export declare function parseValueForColumn(raw: string, col: ColumnDefinition): unknown;
+/**
+ * A number as a person edits it: the active locale's decimal separator, no grouping, every digit
+ * kept (`1234.5` → `1234,5` on a German page). The inverse is {@link parseValueForColumn}.
+ */
+export declare function editableNumber(value: number): string;