@updog/data-editor-wc 0.1.28 → 0.1.29

package/index.d.ts

@@ -1015,14 +1015,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 */
@@ -1034,6 +1057,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;
 /**

package/index.js

@@ -18296,7 +18296,7 @@ function Nu(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;
@@ -19726,6 +19726,20 @@ var gd = /* @__PURE__ */ new Map(), _d = 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);
@@ -21843,7 +21857,7 @@ function Wd(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,
@@ -21855,7 +21869,7 @@ function Wd(e, t, n, r) {
 				isInitialData: !0
 			}), e.setSourceLoading($l, !0), !0), c = $l), 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-wc",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "Client-side CSV importer and spreadsheet editor SDK as a Web Component. Drop into Vue, Angular, Svelte, or vanilla JS. Import CSV, Excel, JSON; edit 1M+ rows entirely in the browser.",
   "author": "Mikhail Kutateladze <admin@updog.tech>",
   "homepage": "https://updog.tech",