@updog/data-editor-wc 0.1.82 → 0.1.84

package/README.md

@@ -258,7 +258,7 @@ editor.columns = [
 ];
 ```
 
-**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? }`.
 
@@ -270,11 +270,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. |
 
 ```js
@@ -288,7 +287,7 @@ editor.columns = [
       { 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",
@@ -297,7 +296,7 @@ editor.columns = [
   {
     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

@@ -415,6 +415,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: {
@@ -657,13 +658,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 = {
@@ -686,23 +683,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.
@@ -751,7 +744,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}` : "" },
  * ];
  * ```
  */
@@ -762,7 +755,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.
      */
@@ -802,8 +795,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";
@@ -818,19 +810,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";
@@ -1470,7 +1464,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