@updog/data-editor 0.1.77 → 0.1.79

package/index.d.ts

@@ -475,7 +475,7 @@ declare var export_default = {
         matchColumns: "Match columns",
         matchColumnsOf: "Match columns ({{current}} of {{total}})",
         matchValues: "Match values",
-        primaryKey: "Primary key",
+        addOrUpdate: "Add or update",
       },
       uploadFile: {
         parseError: "Failed to parse file",
@@ -560,10 +560,11 @@ declare var export_default = {
         separator: "Separator",
         separatedBy: "Values separated by",
       },
-      primaryKey: {
-        none: "No primary key",
-        noneHint:
-          "All rows will be appended as new entries without deduplication.",
+      addOrUpdate: {
+        addEvery: "Add every row",
+        addEveryHint:
+          "Every row becomes a new entry, even if it repeats one you already have.",
+        updateBy: "Update by {{column}}",
       },
     },
     chat: {
@@ -1443,8 +1444,8 @@ type ChatErrorSummary = {
 type ChatDataContext<TRow extends DataEditorRow = DataEditorRow> = {
     /** Full column definitions. */
     columns: DataEditorColumn[];
-    /** Row identifier field. */
-    primaryKey: keyof TRow;
+    /** Row identifier field, or the list of fields that identify a row together. */
+    primaryKey: keyof TRow | readonly (keyof TRow)[];
     /** Total rows in the dataset. */
     totalRowCount: number;
     /** Rows in the current filtered view. */
@@ -1651,6 +1652,8 @@ type NormalizedColumn = DataEditorColumn & {
     asyncConfig?: AsyncFunctionValidator[];
 };
 
+type PrimaryKeyInput = string | readonly string[];
+
 type RegisterSourceOptions = {
     name: string;
     id?: DataSourceId;
@@ -2264,6 +2267,7 @@ type IValidator<TRow extends DataEditorRow = DataEditorRow> = {
     validateColumn(field: string, oldValues: ReadonlyMap<TRowId, unknown>): void;
     revalidateColumnChunked(field: string, oldValues: ReadonlyMap<TRowId, unknown>, newValues: ReadonlyMap<TRowId, unknown>, processor: ChunkedProcessor<TRowId>, onComplete: () => void): void;
     removeRow(rowId: TRowId): void;
+    replaceRow(rowId: TRowId): void;
     setAsyncPort(port: AsyncValidationPort): void;
     destroy(): void;
 };
@@ -2334,7 +2338,7 @@ declare class SourceLifecycle<TRow extends DataEditorRow = DataEditorRow> {
     restore(snapshot: SourceSnapshot<TRow>): void;
     register(options: RegisterSourceOptions): DataSourceId;
     trackAppend(sourceId: DataSourceId, rowIds: TRowId[], rows: TRow[], usedIdMap: boolean): void;
-    trackPrimaryKey(sourceId: DataSourceId, primaryKey: keyof TRow): void;
+    trackPrimaryKey(sourceId: DataSourceId, primaryKey: string[]): void;
     finalize(sourceId: DataSourceId): Promise<void>;
     private pushImportCommandIfTracked;
     private removeInternal;
@@ -2401,6 +2405,11 @@ type ApplyFormulaOptions = {
      */
     readonly deleteColumnsAfter?: readonly string[];
 };
+type UpsertOptions = {
+    anchorKey?: PrimaryKeyInput;
+    newRowIds?: TRowId[];
+    skipRowValidation?: boolean;
+};
 declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
     private readonly _mode;
     isServer(): boolean;
@@ -2421,12 +2430,13 @@ declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
     private serverCounts;
     private editBuilder;
     private isUndoRedoing;
+    private anchorMapCache;
     private pendingBatchCommands;
     private _version;
     private _skipNotify;
     private _bulkMode;
     private _editedCells;
-    private _primaryKey;
+    private _primaryKeyFields;
     /** Columns that are currently locked (pre-locked from schema + user-locked at runtime). */
     private _lockedColumns;
     /** Columns locked via schema definition — user cannot unlock these. */
@@ -2463,7 +2473,7 @@ declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
     getRowId(index: number): TRowId | undefined;
     getLocalRowCount(): number;
     setValidator(validator: IValidator<TRow>): void;
-    setPrimaryKey(key: string): void;
+    setPrimaryKey(key: PrimaryKeyInput): void;
     isColumnLocked(field: string): boolean;
     isColumnPreLocked(field: string): boolean;
     lockColumn(field: string, mode?: ColumnLockMode): void;
@@ -2601,10 +2611,10 @@ declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
     insertRowServer(row: TRow, localPosition: number, anchorRowId: TRowId | undefined, insertPosition: "above" | "below", columnIds: string[]): Promise<TRowId>;
     appendRows(sourceId: DataSourceId, newRows: TRow[], rowIdMap?: Map<number, TRowId>): TRowId[];
     seedInitialChanges(assignedRowIds: TRowId[], currentRows: TRow[], changes: InitialRowChange<TRow>[]): void;
-    upsertRows(sourceId: DataSourceId, newRows: TRow[], options?: {
-        anchorKey?: keyof TRow;
-        newRowIds?: TRowId[];
-    }): UpsertResult<TRow>;
+    upsertRows(sourceId: DataSourceId, newRows: TRow[], options?: UpsertOptions): UpsertResult<TRow>;
+    private getAnchorMap;
+    private clearAnchorMapCache;
+    private upsertRowsInner;
     setLoading(isLoading: boolean): void;
     setPhase(phase: ProcessingPhase, info?: ProcessingInfo): void;
     getPhase(): ProcessingPhase;
@@ -2675,6 +2685,7 @@ declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
      */
     updateColumnDirect(field: string, values: ReadonlyMap<TRowId, unknown>): void;
     batch(fn: () => void): number | undefined;
+    private batched;
     canUndo(): boolean;
     getAllRowIds(): readonly TRowId[];
     undo(): Promise<UndoRedoResult>;
@@ -2729,7 +2740,7 @@ declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
     private _applyChatOpsViaWorker;
     private _applyChatOpsSync;
     private _commitChatOps;
-    applyChatRows(incomingRows: Record<string, unknown>[], primaryKey: string): Promise<void>;
+    applyChatRows(incomingRows: Record<string, unknown>[], primaryKey: PrimaryKeyInput): Promise<void>;
     private syncChatTransformToServer;
     private get revertRowReader();
     revertColumns(fields: string[]): Promise<void>;
@@ -3127,11 +3138,11 @@ type DataEditorBaseProps<TRow extends DataEditorRow = DataEditorRow> = {
     /** Column definitions. Each entry describes one column in the grid. */
     columns: DataEditorColumn[];
     /**
-     * The column ID used to uniquely identify each row (e.g. `"id"` or
-     * `"employeeId"`). Used to match imported rows against existing data and to
-     * track edits.
+     * The column or columns that uniquely identify a row (`"id"`, or
+     * `["orgId", "externalId"]`). Used to match imported rows against existing
+     * data. A row matches only when every listed column matches.
      */
-    primaryKey: keyof TRow;
+    primaryKey: keyof TRow | readonly (keyof TRow)[];
     /**
      * Async function that feeds data into the editor. Called once when the editor opens.
      * Call `onChunk` one or more times to stream rows in batches.