@updog/data-editor-wc 0.1.80 → 0.1.82

package/index.d.ts

@@ -446,24 +446,6 @@ declare var export_default = {
           text: "Your subscription is no longer active. Please renew to continue.",
         },
       },
-      scale: {
-        bootstrap_failed: {
-          title: "Couldn't connect to the server",
-          text: "The server returned an error. Please refresh the page or contact support.",
-        },
-        workspace_lost: {
-          title: "Connection lost",
-          text: "The session ended unexpectedly. Refresh the page to reconnect.",
-        },
-        unreachable: {
-          title: "Server unreachable",
-          text: "Check your connection and refresh the page.",
-        },
-        server_error: {
-          title: "Server error",
-          text: "The server returned an error. Please refresh the page or contact support.",
-        },
-      },
     },
     uploader: {
       steps: {
@@ -638,98 +620,6 @@ type DataEditorTranslations = DeepPartial<ExpandPluralKeys<typeof export_default
  */
 type DataEditorRow = Record<string, unknown>;
 
-/**
- * A built-in declarative validator. Mode-symmetric: the SDK ships a TS
- * interpreter, the Updog Scale Go binary ships a Go interpreter, and both
- * agree on pass/fail outcomes per `api/validators.json`.
- */
-type BuiltInValidator = {
-    type: "required";
-    message?: string;
-} | {
-    type: "regex";
-    pattern: string;
-    flags?: string;
-    message?: string;
-} | {
-    type: "oneOf";
-    values: string[];
-    message?: string;
-} | {
-    type: "range";
-    min?: number;
-    max?: number;
-    message?: string;
-} | {
-    type: "email";
-    message?: string;
-} | {
-    type: "date";
-    format?: "YYYY-MM-DD" | "DD/MM/YYYY";
-    message?: string;
-} | {
-    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
- * via expr-lang. Skipped at runtime in client mode (warned at mount).
- */
-type ExpressionValidator = {
-    type: "expression";
-    expr: string;
-    message?: string;
-};
-/**
- * Client-mode-only escape hatch: a JS predicate run inline. Dropped (with
- * one warn per column) when the SDK serializes the schema for server mode.
- */
-type FunctionValidator = {
-    type: "function";
-    fn: CellValidator;
-};
-/**
- * The validator-rule union accepted by `DataEditorColumn.validators`.
- * - Built-ins and `expression` are declarative objects (cross the wire).
- * - `function` wraps a `CellValidator`; client-mode-only, dropped+warned in server mode.
- *
- * Named `ValidatorRule` (not `Validator`) so it doesn't clash with the
- * runtime `Validator` class in `core/Validator.ts`.
- */
-type ValidatorRule = BuiltInValidator | ExpressionValidator | FunctionValidator | AsyncFunctionValidator;
-
 /**
  * Severity level for a validation message.
  * - `"error"` — a validation failure: marks the row invalid, counts as an error.
@@ -873,10 +763,8 @@ type DataEditorColumn = {
     /**
      * One or more validators run on every edit. Accepts:
      * - 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.
+     * - `{ type: "function", fn }` — a JS predicate run inline.
+     * - `{ type: "asyncFunction", fn }` — batched remote checks.
      */
     validators?: ValidatorRule[];
     /**
@@ -913,6 +801,85 @@ type DataEditorColumn = {
     locked?: boolean | ColumnLockMode;
 };
 
+/**
+ * A built-in declarative validator — a declarative object the SDK interprets,
+ * per `api/validators.json`.
+ */
+type BuiltInValidator = {
+    type: "required";
+    message?: string;
+} | {
+    type: "regex";
+    pattern: string;
+    flags?: string;
+    message?: string;
+} | {
+    type: "oneOf";
+    values: string[];
+    message?: string;
+} | {
+    type: "range";
+    min?: number;
+    max?: number;
+    message?: string;
+} | {
+    type: "email";
+    message?: string;
+} | {
+    type: "date";
+    format?: "YYYY-MM-DD" | "DD/MM/YYYY";
+    message?: string;
+} | {
+    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>;
+};
+/**
+ * Escape hatch: a JS predicate run inline against the cell value and its row.
+ */
+type FunctionValidator = {
+    type: "function";
+    fn: CellValidator;
+};
+/**
+ * The validator-rule union accepted by `DataEditorColumn.validators`.
+ *
+ * Named `ValidatorRule` (not `Validator`) so it doesn't clash with the
+ * runtime `Validator` class in `core/Validator.ts`.
+ */
+type ValidatorRule = BuiltInValidator | FunctionValidator | AsyncFunctionValidator;
+
 /**
  * A single operation the LLM wants to apply to rows in the current filtered view.
  *
@@ -1053,12 +1020,10 @@ type DataEditorChat<TRow extends DataEditorRow = DataEditorRow> = {
 
 /**
  * Categories of internal errors surfaced through the `onError` callback.
- *
- * Existing categories cover client-side failures. `scale.*` codes cover
- * server-mode (Updog Scale) failures. `license.*` codes cover license
- * validation failures (previously a separate `LicenseErrorCode` enum).
+ * `license.*` codes cover license validation failures (previously a separate
+ * `LicenseErrorCode` enum).
  */
-type UpdogErrorCode = "PARSE_ERROR" | "RENDER_ERROR" | "TRANSFORM_ERROR" | "VALIDATION_ERROR" | "WORKER_ERROR" | "COMMAND_ERROR" | "OPERATION_ERROR" | "license.invalid" | "license.missing" | "license.domain_not_allowed" | "license.subscription_inactive" | "license.trial_expired" | "scale.bootstrap_failed" | "scale.workspace_lost" | "scale.unreachable" | "scale.server_error";
+type UpdogErrorCode = "PARSE_ERROR" | "RENDER_ERROR" | "TRANSFORM_ERROR" | "VALIDATION_ERROR" | "WORKER_ERROR" | "COMMAND_ERROR" | "OPERATION_ERROR" | "license.invalid" | "license.missing" | "license.domain_not_allowed" | "license.subscription_inactive" | "license.trial_expired";
 /**
  * An internal error caught by the SDK and passed to `onError`. The SDK
  * recovers gracefully where possible — `onError` is for your logging and
@@ -1084,10 +1049,6 @@ type UpdogError = {
     originalError?: unknown;
 };
 
-type ScaleServerConfig = {
-    url: string;
-};
-
 /**
  * A single row in the submit result, with orthogonal flags describing its state.
  *
@@ -1305,10 +1266,24 @@ type CustomImportFormat = {
      * Returns rows, named tables, or a `File` in a format the SDK already reads.
      * Throw to fail the import; the thrown message is shown to the user.
      */
-    handle: (file: File, ctx: {
-        signal: AbortSignal;
-    }) => Promise<File | Record<string, unknown>[] | CustomImportTable[]>;
+    handle: FileHandler;
 };
+/**
+ * What client code may hand back for a file the SDK will not read itself: rows,
+ * named tables, or a `File` in a format the SDK already reads.
+ */
+type FileHandlerResult = File | Record<string, unknown>[] | CustomImportTable[];
+/** Claims a file by extension and turns it into tables the SDK can stage. */
+type FileHandler = (file: File, ctx: {
+    signal: AbortSignal;
+}) => Promise<FileHandlerResult>;
+/**
+ * Takes over a readable file that holds no single table. `null` declines the
+ * file, leaving it to be staged the ordinary way.
+ */
+type UnstructuredFileHandler = (file: File, ctx: {
+    signal: AbortSignal;
+}) => Promise<FileHandlerResult | null>;
 /**
  * Controls the initial view when the editor opens.
  *
@@ -1429,6 +1404,17 @@ type DataEditorBaseProps<TRow extends DataEditorRow = DataEditorRow> = {
      * the file and stages whatever `handle()` returns.
      */
     customFormats?: CustomImportFormat[];
+    /**
+     * Called when a file the SDK can read turns out to hold no single table —
+     * a report with a banner, several tables on one sheet, a sheet that is really
+     * a document. You get the `File` and return tables, exactly as a
+     * `customFormats` handler does.
+     *
+     * Return `null`, throw, or take longer than 30 seconds and the file is staged
+     * the ordinary way, as if this prop were absent. Nothing about the file
+     * reaches Updog.
+     */
+    onUnstructuredFile?: UnstructuredFileHandler;
     /**
      * Which file formats the user can export to. `undefined` allows all
      * formats, `false` disables export entirely.
@@ -1539,11 +1525,6 @@ type DataEditorMode = "modal" | "inline";
 type DataEditorCommonProps<TRow extends DataEditorRow = DataEditorRow> = DataEditorBaseProps<TRow> & {
     /** Your Updog license key. Validated on each open. */
     apiKey: string;
-    /**
-     * @internal
-     * Reserved for future server-delegated mode. Not part of the public API.
-     */
-    __server?: ScaleServerConfig;
     /**
      * Controls what the editor stores in `localStorage`. Set to `false` to
      * disable all local storage usage.