@updog/data-editor-wc 0.1.75 → 0.1.76

package/index.d.ts

@@ -483,6 +483,8 @@ declare var export_default = {
         csvWarning_one: "{{count}} row had formatting issues (row {{rows}})",
         csvWarning_other:
           "{{count}} rows had formatting issues (rows {{rows}})",
+        customEmpty: "No tables were found in this file",
+        customFailed: "Could not process the file",
         downloadExample: "Download sample file",
         fileInputLabel: "Choose files to upload",
         fileTooLarge: "The file is too large to process",
@@ -529,6 +531,7 @@ declare var export_default = {
           "Unmatched columns won't be imported. Match this column to keep the data. You can transform columns after importing.",
       },
       sheetPreview: {
+        cancel: "Cancel processing",
         emptySheet: "Empty sheet",
         rowCount_one: "{{count}} row",
         rowCount_other: "{{count}} rows",
@@ -1261,6 +1264,47 @@ type RemoteSource = {
      */
     fetch: () => Promise<File | Record<string, unknown>[]>;
 };
+/** One table returned by a custom format handler. */
+type CustomImportTable = {
+    /** Table name, shown on the preview card. */
+    name: string;
+    rows: Record<string, unknown>[];
+};
+/**
+ * A file format the SDK cannot read, handled by client code.
+ *
+ * The SDK accepts the file, hands it to `handle()`, and stages whatever comes
+ * back. You own the processing; nothing about the file reaches Updog.
+ *
+ * @example
+ * ```ts
+ * const pdf: CustomImportFormat = {
+ *   label: "PDF",
+ *   extensions: [".pdf"],
+ *   handle: async (file, { signal }) => {
+ *     const body = new FormData();
+ *     body.append("file", file);
+ *     const res = await fetch("/api/extract", { method: "POST", body, signal });
+ *     return res.json(); // Record<string, unknown>[]
+ *   },
+ * };
+ * ```
+ */
+type CustomImportFormat = {
+    /** Shown in the format hint under the drop zone, e.g. "PDF". */
+    label: string;
+    /** Extensions this handler claims, leading dot included. */
+    extensions: string[];
+    /** Optional MIME match, wildcards allowed: `["image/*"]`. */
+    mimeTypes?: string[];
+    /**
+     * 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[]>;
+};
 /**
  * Controls the initial view when the editor opens.
  *
@@ -1376,6 +1420,11 @@ type DataEditorBaseProps<TRow extends DataEditorRow = DataEditorRow> = {
      * the result of `fetch()`.
      */
     remoteSources?: RemoteSource[];
+    /**
+     * File formats the SDK cannot read, handled by your own code. The SDK accepts
+     * the file and stages whatever `handle()` returns.
+     */
+    customFormats?: CustomImportFormat[];
     /**
      * Which file formats the user can export to. `undefined` allows all
      * formats, `false` disables export entirely.