@updog/data-editor-wc 0.1.59 → 0.1.60

package/index.d.ts

@@ -374,6 +374,7 @@ declare var export_default = {
       redo: "Redo",
     },
     validation: {
+      alreadyExists: "Already exists in your database",
       endDateBeforeStart: "End date must be after start date",
       invalidDate: "Invalid date",
       invalidEmail: "Invalid email address",
@@ -615,6 +616,38 @@ type BuiltInValidator = {
 } | {
     type: "numeric";
     message?: string;
+} | {
+    type: "unique";
+    message?: string;
+    fn?: UniqueRemoteFn;
+};
+/** One cell in an asyncFunction batch. Row is passed by reference. */
+type AsyncValidatorCell = {
+    /** Value of the validated column for this cell. */
+    value: unknown;
+    /** The full row — for row-dependent checks. */
+    row: DataEditorRow;
+};
+/**
+ * Remote existence check for `{ type: "unique" }`. Called once per sweep
+ * with all distinct candidate values; report the subset that already exists —
+ * return it and/or stream it via onChunk (results are unioned). `signal`
+ * fires only when results can no longer be used. Client-mode only.
+ */
+type UniqueRemoteFn = (values: unknown[], onChunk: (existing: unknown[]) => void, signal: AbortSignal) => Promise<unknown[] | void>;
+type AsyncFunctionValidator = {
+    type: "asyncFunction";
+    /**
+     * Called once per column per operation with every affected cell. Report
+     * failures by `index` into `cells`: return an array aligned with the input
+     * (null = valid) and/or stream sparse failures via onChunk (unioned, any
+     * order). `signal` fires only when results can no longer be used.
+     * Client-mode only. For uniqueness use `unique.fn`, not this.
+     */
+    fn: (cells: AsyncValidatorCell[], onChunk: (failures: {
+        index: number;
+        error: ValidationError;
+    }[]) => void, signal: AbortSignal) => Promise<(ValidationError | null)[] | void>;
 };
 /**
  * Server-mode-only escape hatch: an expression evaluated by the Go binary
@@ -641,7 +674,7 @@ type FunctionValidator = {
  * Named `ValidatorRule` (not `Validator`) so it doesn't clash with the
  * runtime `Validator` class in `core/Validator.ts`.
  */
-type ValidatorRule = BuiltInValidator | ExpressionValidator | FunctionValidator;
+type ValidatorRule = BuiltInValidator | ExpressionValidator | FunctionValidator | AsyncFunctionValidator;
 
 /**
  * Severity level for a validation message.
@@ -772,7 +805,7 @@ type ColumnLockMode = "all" | "default";
  * ```ts
  * const columns: DataEditorColumn[] = [
  *   { 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" }], unique: true },
+ *   { 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}` : "" },
  * ];
@@ -785,19 +818,13 @@ 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", ... }`.
+     * - Built-in object literals: `{ type: "required" | "email" | "regex" | "range" | "oneOf" | "date" | "numeric" | "unique", ... }`.
      * - `{ type: "expression", expr }` — server-mode only. Warned in client mode.
      * - `{ type: "function", fn }` — client-mode only. Dropped+warned in server mode.
      *
      * See `_specs/VALIDATIONS.md` §4.5 for the per-mode support matrix.
      */
     validators?: ValidatorRule[];
-    /**
-     * When `true`, the editor flags duplicate values in this column as errors.
-     * The error message is localized via the `translations` prop
-     * (`dataEditor.validation.valueMustBeUnique`).
-     */
-    unique?: boolean;
     /**
      * Column IDs to revalidate when this column changes. Use for cross-field
      * rules like "end date must be after start date".