@updog/data-editor 0.1.28 → 0.1.29

package/index.d.ts

@@ -2396,6 +2396,7 @@ 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[];
@@ -2662,14 +2663,37 @@ type DataEditorResult<TRow extends DataEditorRow = DataEditorRow> = {
         invalid: number;
     };
 };
+/**
+ * Describes the change state of a single row within a chunk, used to seed
+ * the editor with a previously saved diff on load.
+ *
+ * The client passes current-state rows via `onChunk` and attaches change
+ * descriptors to mark which rows were edited, added, or deleted in a
+ * previous session. The SDK uses these to seed DirtyTracker so the diff
+ * is visible from the first frame.
+ */
+type InitialRowChange<TRow extends DataEditorRow = DataEditorRow> = {
+    /** Index of this row within the chunk's rows array. */
+    index: number;
+    /**
+     * Original field values before the user's edits.
+     * Only include fields that differ from the current row.
+     * Presence of this field marks the row as "edited".
+     */
+    originalValues?: Partial<TRow>;
+    /** Marks this row as a new addition (not from backend). */
+    isNew?: boolean;
+    /** Marks this row as pending deletion. */
+    isDeleted?: boolean;
+};
 /**
  * Options used to tag a chunk passed to `loadData`'s `onChunk` callback.
- * Sources are auto-registered on first encounter. Chunks without options go
- * to "Existing Data".
+ * Sources are auto-registered on first encounter. Chunks without options
+ * (or options without `source`) go to "Existing Data".
  */
-type ChunkSourceOptions = {
-    /** Display name for this data source. Required when tagging a source. */
-    source: string;
+type ChunkSourceOptions<TRow extends DataEditorRow = DataEditorRow> = {
+    /** Display name for this data source. When omitted, chunk goes to the default backend source. */
+    source?: string;
     /** Stable identifier. Defaults to the `source` value when omitted. */
     id?: string;
     /** Whether the user can delete this source from the editor. @default false */
@@ -2681,6 +2705,8 @@ type ChunkSourceOptions = {
      * @default false
      */
     done?: boolean;
+    /** Seed change state for specific rows in this chunk. Sparse: only rows that differ from backend. */
+    changes?: InitialRowChange<TRow>[];
 };
 type DataSourceId = string;
 type DataSourceState = {
@@ -3130,4 +3156,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, RemoteSource, ResultRow, UpdogError, UpdogErrorCode, ValidationError, ValueMatchInput, ValueMatchOutput };
+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 };

package/index.js

@@ -6245,7 +6245,7 @@ function ec(e, t, n) {
 		newValues: /* @__PURE__ */ new Map()
 	});
 	for (let i of n) {
-		if (e.isNew(i) || !e.isEdited(i)) continue;
+		if (!e.isEdited(i)) continue;
 		let n = e.getRowById(i);
 		if (n) for (let a of t) {
 			if (!e.isCellDirty(i, a)) continue;
@@ -7675,6 +7675,20 @@ var Lc = /* @__PURE__ */ new Map(), Rc = class {
 		}
 		return r && (r.rowCount += i), this.valueIndex.bumpVersion(), this.snapshotManager.markCountsDirty(), this.rowStore.invalidateIndex(), this.sourceLifecycle.trackAppend(e, a, t, n !== void 0 && n.size > 0), this.filterEngine.notifyRowsAdded(o), this.filterEngine.updateRowsText(s), this.notify(), a;
 	}
+	seedInitialChanges(e, t, n) {
+		for (let r of n) {
+			let n = e[r.index], i = t[r.index];
+			if (r.isNew && (this.dirtyTracker.trackNonBackendRow(n), this.dirtyTracker.markNew(n)), r.originalValues) {
+				let e = {
+					...i,
+					...r.originalValues
+				};
+				this.dirtyTracker.snapshotOriginal(n, e), this.dirtyTracker.markEdited(n);
+			}
+			r.isDeleted && this.dirtyTracker.markDeleted(n);
+		}
+		this.filterEngine.markFlagsDirty(), this.filterEngine.flushPendingFlags(), this.snapshotManager.markCountsDirty(), this.notify();
+	}
 	upsertRows(e, t, n) {
 		let { anchorKey: r, newRowIds: i } = n ?? {};
 		r && this.sourceLifecycle.trackPrimaryKey(e, r);
@@ -9792,7 +9806,7 @@ function dl(e, t, n, r) {
 		};
 		n((n, o) => {
 			let c;
-			if (o ? (c = o.id ?? o.source, e.hasSource(c) || (e.registerSource({
+			if (o?.source ? (c = o.id ?? o.source, e.hasSource(c) || (e.registerSource({
 				name: o.source,
 				id: c,
 				isDeletable: o.deletable ?? !1,
@@ -9804,7 +9818,7 @@ function dl(e, t, n, r) {
 				isInitialData: !0
 			}), e.setSourceLoading(Os, !0), !0), c = Os), n.length > 0) {
 				let r = e.appendRows(c, n);
-				a++, requestIdleCallback(() => {
+				o?.changes?.length && e.seedInitialChanges(r, n, o.changes), a++, requestIdleCallback(() => {
 					t.current.validateRows(n, r), a--, s();
 				});
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@updog/data-editor",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "Client-side CSV importer and spreadsheet editor SDK for React. Import CSV, Excel, JSON, TSV, and XML, match columns, validate, and edit 1M+ rows entirely in the browser.",
   "author": "Mikhail Kutateladze <admin@updog.tech>",
   "homepage": "https://updog.tech",