@updog/data-editor-wc 0.1.85 → 0.1.87

package/index.d.ts

@@ -65,6 +65,8 @@ declare var export_default = {
       clearField: "Clear field",
       showPassword: "Show password",
       hidePassword: "Hide password",
+      switchToAm: "Switch to AM",
+      switchToPm: "Switch to PM",
     },
     select: {
       noResults: "No results",
@@ -412,10 +414,12 @@ declare var export_default = {
       invalidFormat: "Invalid format",
       invalidNumber: "Invalid number",
       invalidOption: "Invalid option",
+      invalidTime: "Invalid time",
       outOfRange: "Out of range",
       required: "This field is required",
       structuralMismatch: "This might be in the wrong column.",
       tooManyDecimals: "Too many decimal places",
+      tooPreciseTime: "Too precise for this column",
       valueMustBeUnique: "Value must be unique",
     },
     license: {
@@ -663,6 +667,16 @@ type TextEditorCell = {
 type DateEditorCell = {
     type: "date";
 };
+/** Time-of-day cell. Bounds come from the column's `{ type: "time" }` validator. */
+type TimeEditorCell = {
+    type: "time";
+    /**
+     * The clock the cell draws, `h23` for `18:00` and `h12` for `6:00 PM`.
+     * Defaults to the clock the reader's own browser uses. Whichever is drawn,
+     * both forms stay readable when the person types.
+     */
+    hourCycle?: "h12" | "h23";
+};
 /** Dropdown select cell. The user picks from a fixed list of options. */
 type SelectEditorCell = {
     type: "select";
@@ -697,11 +711,12 @@ type NumberEditorCell = {
  *
  * - `"text"` — plain text input (default).
  * - `"date"` — date picker; the calendar honours the column's date validator bounds.
+ * - `"time"` — plain text input for a time of day; the column is checked against `{ type: "time" }`.
  * - `"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.
  */
-type CellEditor = TextEditorCell | DateEditorCell | SelectEditorCell | MultiSelectEditorCell | NumberEditorCell;
+type CellEditor = TextEditorCell | DateEditorCell | TimeEditorCell | SelectEditorCell | MultiSelectEditorCell | NumberEditorCell;
 /** Dropdown filter shown in the sidebar Filters panel. */
 type SelectColumnFilter = {
     type: "select";
@@ -726,14 +741,21 @@ type DateRangeColumnFilter = {
     /** Label displayed above the filter. */
     label?: string;
 };
+/** Time-of-day min/max range filter shown in the sidebar Filters panel. */
+type TimeRangeColumnFilter = {
+    type: "time-range";
+    /** Label displayed above the filter. */
+    label?: string;
+};
 /**
  * Filter control shown in the sidebar Filters panel for a column.
  *
  * - `"select"` — dropdown to pick one or more values.
  * - `"number-range"` — two inputs for min and max number.
  * - `"date-range"` — two date pickers for start and end date.
+ * - `"time-range"` — two time fields for the earliest and latest time of day.
  */
-type ColumnFilter = SelectColumnFilter | NumberRangeColumnFilter | DateRangeColumnFilter;
+type ColumnFilter = SelectColumnFilter | NumberRangeColumnFilter | DateRangeColumnFilter | TimeRangeColumnFilter;
 /** Lock mode for a column. `"all"` locks for every row; `"default"` locks only default-source rows. */
 type ColumnLockMode = "all" | "default";
 /**
@@ -769,8 +791,21 @@ type DataEditorColumn = {
     /** Format the display value without changing stored data. E.g. add `$` prefix. */
     formatter?: (value: string) => string;
     /**
-     * Transform a value before it enters the store. Runs when rows are uploaded
-     * to the data editor.
+     * Transform a value on its way into the store. Runs on every value arriving
+     * from outside the editor, so `loadData`, a file import, a remote source, a
+     * custom format, and a paste of text from another app all call it. A value
+     * moving inside the grid is left alone, so a manual edit, a fill, a paste of
+     * cells copied from the grid itself, undo, and redo never call it.
+     *
+     * The value arrives in the shape the cell is stored in. Numbers and dates
+     * canonicalize first, and a `select` value resolves through value matching
+     * first, so the transformer sees the option the user confirmed. On a
+     * `multiselect` column it runs once per token, the way `formatter` already
+     * reads that column. A token it empties leaves the list, and two tokens it
+     * makes equal collapse into one.
+     *
+     * It runs before validation, so a transformer that moves a value outside
+     * `editor.options` makes its own column fail a `oneOf` rule.
      */
     transformer?: (value: unknown) => unknown;
     /** How the cell is edited. Defaults to text input. */
@@ -795,6 +830,8 @@ type DataEditorColumn = {
     locked?: boolean | ColumnLockMode;
 };
 
+/** How precisely a time-of-day column is written. */
+type TimePrecision = "minutes" | "seconds" | "milliseconds";
 /**
  * A built-in declarative validator — a declarative object the SDK interprets.
  */
@@ -827,6 +864,15 @@ type BuiltInValidator = {
     min?: string;
     max?: string;
     message?: string;
+} | {
+    type: "time";
+    /** Inclusive lower bound, canonical, any of the three precisions. */
+    min?: string;
+    /** Inclusive upper bound, canonical, any of the three precisions. */
+    max?: string;
+    /** The finest the column is written. A value carrying more is flagged, never trimmed. */
+    precision?: TimePrecision;
+    message?: string;
 } | {
     type: "unique";
     message?: string;