@updog/data-editor 0.1.82 → 0.1.84

package/README.md

@@ -204,7 +204,7 @@ const columns: DataEditorColumn[] = [
 ];
 ```
 
-**Cell editors**: `{ type: "text" }` (default), `{ type: "date", minDate?, maxDate? }`, `{ type: "select", options: string[] }`, `{ type: "number", decimalPlaces?, decimalSeparator?, thousandsSeparator?, allowChars? }`.
+**Cell editors**: `{ type: "text" }` (default), `{ type: "date" }`, `{ type: "select", options: string[] }`, `{ type: "number", decimalSeparator?, thousandsSeparator? }`.
 
 **Column filters**: `{ type: "select", label?, placeholder?, options?, multiple? }`, `{ type: "number-range", label? }`, `{ type: "date-range", label? }`.
 
@@ -216,11 +216,10 @@ Validators are declarative objects passed in the `validators` array on each colu
 |---|---|---|
 | `"required"` | `message?` | Value must be non-empty. |
 | `"email"` | `message?` | Value must look like an email address. |
-| `"numeric"` | `message?` | Value must parse as a number. Commas are stripped before parsing. |
 | `"regex"` | `pattern`, `flags?`, `message?` | Value must match the regular expression. Empty values are skipped. |
-| `"range"` | `min?`, `max?`, `message?` | Value must be numerically within `[min, max]`. Either bound is optional. |
+| `"number"` | `min?`, `max?`, `decimalPlaces?`, `message?` | Value must be the canonical form — plain digits, a dot for decimals, no grouping, no leading zeros. `min` and `max` are inclusive; `decimalPlaces` caps the decimal digits (`0` means integers) and flags rather than rounds. `min` and `decimalPlaces` also configure the column's number editor. |
 | `"oneOf"` | `values: string[]`, `message?` | Value must be one of the listed strings. |
-| `"date"` | `format?: "YYYY-MM-DD" \| "DD/MM/YYYY"`, `message?` | Value must parse as a date in the given format. When `format` is omitted, either format is accepted. |
+| `"date"` | `min?`, `max?`, `message?` | Value must be an ISO `YYYY-MM-DD` date that exists in the calendar. `min` and `max` are inclusive ISO bounds, and they also set the range the cell's date picker offers. |
 | `"unique"` | `message?` | Value must not appear in any other row of the column. Always checked last, after all other validators pass — list position is ignored. |
 
 ```tsx
@@ -234,7 +233,7 @@ const columns: DataEditorColumn[] = [
       { type: "email", message: "Invalid email" },
     ],
   },
-  { id: "salary", title: "Salary", validators: [{ type: "numeric", message: "Must be a number" }] },
+  { id: "salary", title: "Salary", validators: [{ type: "number", min: 0, decimalPlaces: 2 }] },
   {
     id: "status",
     title: "Status",
@@ -243,7 +242,7 @@ const columns: DataEditorColumn[] = [
   {
     id: "startDate",
     title: "Start",
-    validators: [{ type: "date", format: "YYYY-MM-DD", message: "Use YYYY-MM-DD" }],
+    validators: [{ type: "date", message: "Use a valid date" }],
     editor: { type: "date" },
     dependentFields: ["endDate"],
   },

package/index.d.ts

@@ -417,6 +417,7 @@ declare var export_default = {
       outOfRange: "Out of range",
       required: "This field is required",
       structuralMismatch: "This might be in the wrong column.",
+      tooManyDecimals: "Too many decimal places",
       valueMustBeUnique: "Value must be unique",
     },
     license: {
@@ -694,13 +695,9 @@ type CellValidator = (value: unknown, row: DataEditorRow) => ValidationError | n
 type TextEditorCell = {
     type: "text";
 };
-/** Date picker cell. Optionally restrict the selectable date range. */
+/** Date picker cell. Bounds come from the column's `{ type: "date" }` validator. */
 type DateEditorCell = {
     type: "date";
-    /** Earliest selectable date. */
-    minDate?: Date;
-    /** Latest selectable date. */
-    maxDate?: Date;
 };
 /** Dropdown select cell. The user picks from a fixed list of options. */
 type SelectEditorCell = {
@@ -723,23 +720,19 @@ type MultiSelectEditorCell = {
     /** Splits a raw imported cell and joins on export. Omitted: import auto-detects, export joins with `", "`. */
     delimiter?: string;
 };
-/** Number input cell with locale-aware formatting. */
+/** Number input cell with locale-aware formatting. Bounds and decimal digits come from the column's `{ type: "number" }` validator. */
 type NumberEditorCell = {
     type: "number";
-    /** Maximum number of decimal digits allowed. When omitted, decimals are unrestricted. */
-    decimalPlaces?: number;
     /** Character used as the decimal point (e.g. `"."` or `","`). Defaults to the browser locale. */
     decimalSeparator?: string;
     /** Character inserted between groups of three digits (e.g. `","` or `"."`). Defaults to the browser locale. */
     thousandsSeparator?: string;
-    /** Extra characters to allow beyond digits, decimal separator, and minus sign (e.g. `"%-"`). When defined, minus is only kept if explicitly included. */
-    allowChars?: string;
 };
 /**
  * Controls how a cell is edited.
  *
  * - `"text"` — plain text input (default).
- * - `"date"` — date picker with optional min/max bounds.
+ * - `"date"` — date picker; the calendar honours the column's date validator bounds.
  * - `"select"` — dropdown with a fixed list of options.
  * - `"multiselect"` — dropdown allowing zero or more options; stored as `string[]`.
  * - `"number"` — number input with locale-aware formatting.
@@ -788,7 +781,7 @@ type ColumnLockMode = "all" | "default";
  *   { id: "name", title: "Full Name", size: 200, validators: [{ type: "required", message: "Name is required" }] },
  *   { id: "email", title: "Email", size: 250, validators: [{ type: "required", message: "Email is required" }, { type: "email", message: "Invalid email" }, { type: "unique" }] },
  *   { id: "role", title: "Role", editor: { type: "select", options: ["Admin", "Editor", "Viewer"] } },
- *   { id: "salary", title: "Salary", validators: [{ type: "numeric", message: "Must be a number" }], formatter: (v) => v ? `$${v}` : "" },
+ *   { id: "salary", title: "Salary", validators: [{ type: "number", message: "Must be a number" }], formatter: (v) => v ? `$${v}` : "" },
  * ];
  * ```
  */
@@ -799,7 +792,7 @@ type DataEditorColumn = {
     title: string;
     /**
      * One or more validators run on every edit. Accepts:
-     * - Built-in object literals: `{ type: "required" | "email" | "regex" | "range" | "oneOf" | "date" | "numeric" | "unique", ... }`.
+     * - Built-in object literals: `{ type: "required" | "email" | "regex" | "number" | "oneOf" | "date" | "unique", ... }`.
      * - `{ type: "function", fn }` — a JS predicate run inline.
      * - `{ type: "asyncFunction", fn }` — batched remote checks.
      */
@@ -839,8 +832,7 @@ type DataEditorColumn = {
 };
 
 /**
- * A built-in declarative validator — a declarative object the SDK interprets,
- * per `api/validators.json`.
+ * A built-in declarative validator — a declarative object the SDK interprets.
  */
 type BuiltInValidator = {
     type: "required";
@@ -855,19 +847,21 @@ type BuiltInValidator = {
     values: string[];
     message?: string;
 } | {
-    type: "range";
+    type: "number";
+    /** Inclusive lower bound. */
     min?: number;
+    /** Inclusive upper bound. */
     max?: number;
+    /** Maximum decimal digits; `0` means integers. Values with more are flagged, never rounded. */
+    decimalPlaces?: number;
     message?: string;
 } | {
     type: "email";
     message?: string;
 } | {
     type: "date";
-    format?: "YYYY-MM-DD" | "DD/MM/YYYY";
-    message?: string;
-} | {
-    type: "numeric";
+    min?: string;
+    max?: string;
     message?: string;
 } | {
     type: "unique";
@@ -1233,14 +1227,26 @@ type UniqueConfig = {
     fn?: UniqueRemoteFn;
 };
 /**
- * Core-internal column shape produced by normalizeUniqueColumns. Uniqueness
+ * Core-internal column shape produced by normalizeColumns. Uniqueness
  * lives in `uniqueConfig` and asyncFunction rules in `asyncConfig` — the
  * single internal sources of truth — never as entries in `validators`.
  * Never exported from the package entry.
  */
-type NormalizedColumn = DataEditorColumn & {
+type NormalizedColumn = Omit<DataEditorColumn, "validators"> & {
+    validators?: ValidatorRule[];
     uniqueConfig?: UniqueConfig;
     asyncConfig?: AsyncFunctionValidator[];
+    numberConfig?: NumberConfig;
+    dateConfig?: DateConfig;
+};
+type NumberConfig = {
+    min?: number;
+    max?: number;
+    decimalPlaces?: number;
+};
+type DateConfig = {
+    min?: string;
+    max?: string;
 };
 
 type PrimaryKeyInput = string | readonly string[];
@@ -1992,6 +1998,14 @@ declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
     getRealRowPosition(rowId: TRowId): number;
     insertRow(sourceId: DataSourceId, row: TRow, position: number): Promise<TRowId>;
     insertRowDirect(rowId: TRowId, row: TRow, sourceId: DataSourceId, position: number): void;
+    /**
+     * Append rows supplied by the client through `loadData`. Date columns are
+     * canonicalised to ISO, number columns to the canonical stored form, and
+     * `column.transformer` runs, matching what a file import does. `appendRows` stays a plain append, so the import path — which
+     * has already normalised through buildImportRow — never transforms twice.
+     */
+    appendClientRows(sourceId: DataSourceId, newRows: TRow[]): TRowId[];
+    private normalizeClientRows;
     appendRows(sourceId: DataSourceId, newRows: TRow[], rowIdMap?: Map<number, TRowId>): TRowId[];
     seedInitialChanges(assignedRowIds: TRowId[], currentRows: TRow[], changes: InitialRowChange<TRow>[]): void;
     upsertRows(sourceId: DataSourceId, newRows: TRow[], options?: UpsertOptions): UpsertResult<TRow>;
@@ -2163,7 +2177,7 @@ interface Command<TRow extends DataEditorRow = DataEditorRow> {
  *
  * When operation cost >= LARGE_OP_CELLS:
  *   1. Viewport rows are applied synchronously (instant visual result)
- *   2. Remaining rows are processed in chunks via requestIdleCallback
+ *   2. Remaining rows are processed in chunks via MessageChannel
  *   3. Validation runs chunked after all mutations complete
  *   4. Command is pushed to history only after everything finishes
  *
@@ -2675,7 +2689,9 @@ type DataEditorBaseProps<TRow extends DataEditorRow = DataEditorRow> = {
      * target (a column ID/title, or an option value); the array lists aliases the
      * matching engine treats as equivalent. Merged with the built-ins per key.
      *
-     * Feed `result.learnedSynonyms` straight back — it comes out in this shape.
+     * `result.learnedSynonyms` comes out as `{ source, target }` entries under
+     * `columns` and `values`. Group each pair's source under its target to
+     * build this shape.
      *
      * @example
      * ```ts