@updog/data-editor-wc 0.1.84 → 0.1.86

package/index.d.ts

@@ -492,6 +492,7 @@ declare var export_default = {
       matchColumns: {
         allMatched: "All columns are matched",
         banner: "Some columns could not be automatically matched",
+        changeHeaderRow: "Change header row",
         importedColumns: "Imported columns",
         matchedCount: "{{matched}}/{{total}} matched",
         targetColumns: "Target columns",
@@ -768,8 +769,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. */