@updog/data-editor 0.1.75 → 0.1.77

package/index.d.ts

@@ -485,6 +485,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",
@@ -531,6 +533,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",
@@ -1659,6 +1662,8 @@ type MergeEntry<TRow> = {
     sourceId: DataSourceId;
     isNew: boolean;
     isEdited: boolean;
+    /** Diff basis the row carried before the merge. Present only when isEdited. */
+    originalRow?: TRow;
 };
 type RemovalPlan<TRow> = {
     rowsToDelete: Set<TRowId>;
@@ -1668,6 +1673,7 @@ type RemovalPlan<TRow> = {
         originalSourceId: DataSourceId;
         isNew: boolean;
         isEdited: boolean;
+        originalRow?: TRow;
     }>;
 };
 type ExtendedRemovalPlan<TRow> = RemovalPlan<TRow> & {
@@ -1702,7 +1708,7 @@ declare class SourceManager<TRow extends DataEditorRow = DataEditorRow> {
     finalizeAllSources(): void;
     values(): IterableIterator<DataSourceState>;
     getHiddenSourceIds(): Set<DataSourceId>;
-    saveMergeSnapshot(sourceId: DataSourceId, rowId: TRowId, existingRow: TRow, previousSourceId: DataSourceId, isNew: boolean, isEdited: boolean): void;
+    saveMergeSnapshot(sourceId: DataSourceId, rowId: TRowId, existingRow: TRow, previousSourceId: DataSourceId, isNew: boolean, isEdited: boolean, originalRow?: TRow): void;
     /**
      * Public so commands can re-install merge entries during undo of a remove.
      */
@@ -1939,9 +1945,8 @@ type IDirtyTracker<TRow extends DataEditorRow = DataEditorRow> = {
     hasOriginalRow(id: TRowId): boolean;
     trackNonBackendRow(id: TRowId): void;
     markNew(id: TRowId): void;
-    markEdited(id: TRowId): void;
-    snapshotOriginal(id: TRowId, row: TRow): void;
     classifyOnFirstEdit(id: TRowId, row: TRow): void;
+    classifyOverwrite(id: TRowId, originalRow: TRow, currentRow: TRow): void;
     checkRevert(id: TRowId, currentRow: TRow): {
         wasNew: boolean;
         wasEdited: boolean;
@@ -1953,7 +1958,7 @@ type IDirtyTracker<TRow extends DataEditorRow = DataEditorRow> = {
         isNew: boolean;
         isEdited: boolean;
     };
-    restoreMergeClassification(id: TRowId, isNew: boolean, isEdited: boolean): void;
+    restoreMergeClassification(id: TRowId, isNew: boolean, isEdited: boolean, originalRow?: TRow): void;
     clear(): void;
 };
 
@@ -2693,6 +2698,8 @@ declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
     hasEmptyCells(rowId: TRowId): boolean;
     hasRowMisplaced(rowId: TRowId): boolean;
     getRowsWithMisplaced(): ReadonlySet<TRowId>;
+    /** A column arriving or leaving invalidates every entry. See NOTES.md. */
+    private recheckEmptyCellsAfterColumnsChange;
     private checkRowEmptyCells;
     getValidAndInvalidRows(): {
         valid: TRow[];
@@ -2733,6 +2740,7 @@ declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
     clearColumn(field: string): Promise<void>;
     clearColumns(fields: string[]): Promise<void>;
     private syncClearToServer;
+    purgeField(columnId: string, rowIds?: TRowId[]): void;
     deleteColumn(columnId: string): Promise<void>;
     deleteColumns(columnIds: readonly string[]): Promise<void>;
     clearRange(rects: SelectionRect[]): Promise<void>;
@@ -3066,6 +3074,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.
  *
@@ -3181,6 +3230,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.
@@ -3426,4 +3480,4 @@ declare function exportDataEditor<TRow extends DataEditorRow>(params: ExportPara
 declare function DataEditor<TRow extends DataEditorRow = DataEditorRow>(allProps: DataEditorProps<TRow>): react_jsx_runtime.JSX.Element;
 
 export { DataEditor, downloadExampleFile, exportDataEditor };
-export type { CellValidator, ChatContext, ChatErrorSummary, ChatResponseChunk, ChatRow, ChatRowStatus, ChunkSourceOptions, DataEditorChat, DataEditorColumn, DataEditorFormat, DataEditorInlineProps, DataEditorLocalStorage, DataEditorModalProps, DataEditorMode, DataEditorProps, DataEditorResult, DataEditorRow, DataEditorSourceResult, DataEditorTranslations, DataEditorVariant, InitialRowChange, RemoteSource, ResultRow, UpdogError, UpdogErrorCode, ValidationError, ValueMatchInput, ValueMatchOutput };
+export type { CellValidator, ChatContext, ChatErrorSummary, ChatResponseChunk, ChatRow, ChatRowStatus, ChunkSourceOptions, CustomImportFormat, CustomImportTable, DataEditorChat, DataEditorColumn, DataEditorFormat, DataEditorInlineProps, DataEditorLocalStorage, DataEditorModalProps, DataEditorMode, DataEditorProps, DataEditorResult, DataEditorRow, DataEditorSourceResult, DataEditorTranslations, DataEditorVariant, InitialRowChange, RemoteSource, ResultRow, UpdogError, UpdogErrorCode, ValidationError, ValueMatchInput, ValueMatchOutput };