@updog/data-editor 0.1.5 → 0.1.7

package/assets/chatTransform.worker-xnO1PFUC.js

@@ -0,0 +1 @@
+(function(){function e(e){let{ops:t,rows:n,fields:r}=e,i={};for(let[t,n]of Object.entries(e.ctx.opts))i[t]=new Set(n);let a={opts:i},o=[],s=[];for(let e of t)try{let t=Function(`return `+e.fn)();s.push({action:e.action,fn:t})}catch(t){o.push(`Failed to compile ${e.action} op: ${t instanceof Error?t.message:String(t)}`)}let c=new Map,l=[];for(let[e,t]of n){let n={...t},i=!1;for(let e of s)if(e.action===`delete`)try{if(e.fn(n,a)){i=!0;break}}catch{}else try{e.fn(n,a)}catch{}if(i){l.push(e);continue}for(let i of r){let r=t[i],a=n[i];if(a!==r){let t=c.get(i);t||(t=[],c.set(i,t)),t.push([e,r,a])}}}let u=[];for(let[e,t]of c)u.push({field:e,changes:t});return{deltas:u,deleteIds:l,errors:o}}let t=self;self.addEventListener(`message`,n=>{try{let{ops:r,ctx:i,rows:a,fields:o}=n.data,s=e({ops:r,ctx:i,rows:a,fields:o});t.postMessage({type:`RESULT`,deltas:s.deltas,deleteIds:s.deleteIds,errors:s.errors})}catch(e){t.postMessage({type:`ERROR`,message:e instanceof Error?e.message:`Transform worker error`})}})})();

package/index.d.ts

@@ -1379,6 +1379,189 @@ type PasteSpec = {
     isCut: boolean;
 };
 
+/**
+ * Base row shape. Each key is a column ID, each value is the cell data.
+ * Extend this with your own type via the `<DataEditor<TRow>>` generic for
+ * type-safe column access. When the generic is omitted, rows are typed as
+ * `Record<string, unknown>`.
+ *
+ * @example
+ * ```ts
+ * type Employee = { id: string; name: string; email: string };
+ * <DataEditor<Employee> columns={...} primaryKey="id" />
+ * ```
+ */
+type DataEditorRow = Record<string, unknown>;
+/** Sort direction. */
+type SortDirection = "asc" | "desc";
+/** Current sort state. `null` means no active sort. */
+type SortState = {
+    columnId: string;
+    direction: SortDirection;
+} | null;
+type Filters = {
+    search: string;
+    matchCase: boolean;
+    matchEntireCell: boolean;
+    errorMessageFilters: string[];
+    showOnlyNewRows: boolean;
+    showOnlyEditedRows: boolean;
+    showOnlyEmptyCells: boolean;
+    /** When true, show only rows flagged for deletion (bin mode). All other filters are bypassed. */
+    showOnlyDeletedRows: boolean;
+    filterColumns: string[] | null;
+    /** Per-column value filters. Key = column ID, value = allowed display-formatted strings. */
+    columnValueFilters: Record<string, string[]>;
+    /** Per-column numeric range filters. Key = column ID. */
+    columnRangeFilters: Record<string, {
+        min?: number;
+        max?: number;
+    }>;
+    /** Per-column date range filters. Key = column ID, values are ISO date strings (YYYY-MM-DD). */
+    columnDateRangeFilters: Record<string, {
+        min?: string;
+        max?: string;
+    }>;
+};
+
+/**
+ * A single operation the LLM wants to apply to rows in the current filtered view.
+ *
+ * - `edit` — `fn` is `(r, ctx) => void`. Mutates `r` in place. Changed fields
+ *   become column deltas. Rows with no changes are no-ops.
+ * - `delete` — `fn` is `(r, ctx) => boolean`. Truthy means "flag this row for
+ *   deletion". Soft delete via `DeleteRowCommand`.
+ */
+type ChatOp = {
+    action: "edit";
+    fn: string;
+} | {
+    action: "delete";
+    fn: string;
+};
+/**
+ * A single chunk in the stream returned from `DataEditorChat.onMessage`.
+ *
+ * - `status` — progress message shown while processing (e.g. "Analyzing 500 rows...").
+ * - `message` — chat reply shown to the user.
+ * - `rows` — updated rows to apply to the grid. Matched by `primaryKey`.
+ * - `ops` — array of per-row operations (edits and/or deletes) to apply in order.
+ */
+type ChatResponseChunk<TRow extends DataEditorRow = DataEditorRow> = {
+    type: "status";
+    content: string;
+} | {
+    type: "message";
+    content: string;
+} | {
+    type: "rows";
+    content: TRow[];
+} | {
+    type: "ops";
+    content: ChatOp[];
+};
+/** Status of a row in the chat sample, relative to its origin snapshot. */
+type ChatRowStatus = "new" | "edited" | "original";
+/** A sample row handed to the chat callback, with its current status and validation errors. */
+type ChatRow<TRow extends DataEditorRow = DataEditorRow> = {
+    /** Row data keyed by column ID. */
+    data: TRow;
+    /** Whether the row was newly added, edited, or is unchanged. */
+    status: ChatRowStatus;
+    /** Validation errors keyed by column ID. */
+    errors: Record<string, string[]>;
+    /** The source this row belongs to. */
+    source: string;
+};
+/** Aggregated error count across the current view, grouped by field and message. */
+type ChatErrorSummary = {
+    /** Column ID where the error occurred. */
+    field: string;
+    /** The validation message. */
+    message: string;
+    /** How many rows hit this error. */
+    count: number;
+    /** A few example values that triggered the error. */
+    examples: string[];
+};
+/**
+ * Context about the current dataset, passed to `loadSuggestions` and extended
+ * into `ChatContext` for `onMessage`.
+ */
+type ChatDataContext<TRow extends DataEditorRow = DataEditorRow> = {
+    /** Full column definitions. */
+    columns: DataEditorColumn[];
+    /** Row identifier field. */
+    primaryKey: keyof TRow;
+    /** Total rows in the dataset. */
+    totalRowCount: number;
+    /** Rows in the current filtered view. */
+    filteredRowCount: number;
+    /** Sample rows, with status and errors. Size controlled by `sampleSize`. */
+    sample: ChatRow<TRow>[];
+    /** Aggregated error counts by field and message. */
+    errorSummary: ChatErrorSummary[];
+    /** Access all rows. Use for full-dataset operations. */
+    getRows: () => ChatRow<TRow>[];
+};
+/**
+ * The full context passed to `DataEditorChat.onMessage` when the user sends
+ * a prompt. Includes the prompt itself and all dataset context.
+ */
+type ChatContext<TRow extends DataEditorRow = DataEditorRow> = ChatDataContext<TRow> & {
+    /** The user's chat prompt. */
+    message: string;
+};
+/**
+ * Bring-your-own-AI chat configuration. When provided via the `chat` prop,
+ * the editor shows a chat panel alongside the grid. You own the AI
+ * integration; the SDK hands you dataset context and renders the streamed
+ * response.
+ *
+ * @example
+ * ```ts
+ * chat={{
+ *   sampleSize: 50,
+ *   onMessage: async function* (context) {
+ *     yield { type: "status", content: "Thinking..." };
+ *     const res = await fetch("/api/ai", {
+ *       method: "POST",
+ *       body: JSON.stringify({
+ *         prompt: context.message,
+ *         columns: context.columns,
+ *         sample: context.sample.map(r => r.data),
+ *         errors: context.errorSummary,
+ *       }),
+ *     }).then(r => r.json());
+ *     yield { type: "rows", content: res.updatedRows };
+ *     yield { type: "ops", content: res.ops };
+ *     yield { type: "message", content: res.reply };
+ *   },
+ * }}
+ * ```
+ */
+type DataEditorChat<TRow extends DataEditorRow = DataEditorRow> = {
+    /**
+     * How many rows to include in the context sample. The SDK picks a
+     * representative slice including rows with errors. When omitted, the SDK decides.
+     */
+    sampleSize?: number;
+    /** Title shown above the suggestion list when the chat is empty. */
+    emptyTitle?: string;
+    /** How many suggestions to request from `loadSuggestions`. */
+    suggestionsCount?: number;
+    /** Optional prompt generator for the empty-state suggestion chips. */
+    loadSuggestions?: (context: ChatDataContext<TRow>) => Promise<string[]>;
+    /**
+     * Called when the user sends a message. Receives full dataset context.
+     * Returns an async iterable of response chunks — the SDK streams them
+     * into the UI.
+     */
+    onMessage: (context: ChatContext<TRow>) => AsyncIterable<ChatResponseChunk<TRow>>;
+    /** Called when the user cancels a pending request. Use to abort your API call. */
+    onCancel?: () => void;
+};
+
 type ApplyFormulaOptions = {
     /**
      * Column IDs to delete AFTER the formula has been applied.
@@ -1683,12 +1866,14 @@ declare class DataStore<TRow extends DataEditorRow = DataEditorRow> {
     private syncFormulaToServer;
     private transformWorker;
     private initTransformWorker;
-    private buildChatTransformCommand;
-    applyChatTransform(fnString: string, ctx: {
+    private buildChatOpsCommand;
+    applyChatOps(ops: ChatOp[], ctx: {
         opts: Record<string, Set<string>>;
-    }): Promise<void>;
-    private _applyChatTransformViaWorker;
-    private _applyChatTransformSync;
+    }, enableDeleteRow: 'all' | 'new' | false): Promise<void>;
+    private filterDeleteIdsByPolicy;
+    private _applyChatOpsViaWorker;
+    private _applyChatOpsSync;
+    private _commitChatOps;
     applyChatRows(incomingRows: Record<string, unknown>[], primaryKey: string): Promise<void>;
     private syncChatTransformToServer;
     private get revertRowReader();
@@ -1772,174 +1957,6 @@ type ColumnDelta = {
     newValues: Map<TRowId, unknown>;
 };
 
-/**
- * Base row shape. Each key is a column ID, each value is the cell data.
- * Extend this with your own type via the `<DataEditor<TRow>>` generic for
- * type-safe column access. When the generic is omitted, rows are typed as
- * `Record<string, unknown>`.
- *
- * @example
- * ```ts
- * type Employee = { id: string; name: string; email: string };
- * <DataEditor<Employee> columns={...} primaryKey="id" />
- * ```
- */
-type DataEditorRow = Record<string, unknown>;
-/** Sort direction. */
-type SortDirection = "asc" | "desc";
-/** Current sort state. `null` means no active sort. */
-type SortState = {
-    columnId: string;
-    direction: SortDirection;
-} | null;
-type Filters = {
-    search: string;
-    matchCase: boolean;
-    matchEntireCell: boolean;
-    errorMessageFilters: string[];
-    showOnlyNewRows: boolean;
-    showOnlyEditedRows: boolean;
-    showOnlyEmptyCells: boolean;
-    /** When true, show only rows flagged for deletion (bin mode). All other filters are bypassed. */
-    showOnlyDeletedRows: boolean;
-    filterColumns: string[] | null;
-    /** Per-column value filters. Key = column ID, value = allowed display-formatted strings. */
-    columnValueFilters: Record<string, string[]>;
-    /** Per-column numeric range filters. Key = column ID. */
-    columnRangeFilters: Record<string, {
-        min?: number;
-        max?: number;
-    }>;
-    /** Per-column date range filters. Key = column ID, values are ISO date strings (YYYY-MM-DD). */
-    columnDateRangeFilters: Record<string, {
-        min?: string;
-        max?: string;
-    }>;
-};
-
-/**
- * A single chunk in the stream returned from `DataEditorChat.onMessage`.
- *
- * - `status` — progress message shown while processing (e.g. "Analyzing 500 rows...").
- * - `message` — chat reply shown to the user.
- * - `rows` — updated rows to apply to the grid. Matched by `primaryKey`.
- * - `transform` — description of the transform applied.
- */
-type ChatResponseChunk<TRow extends DataEditorRow = DataEditorRow> = {
-    type: "status";
-    content: string;
-} | {
-    type: "message";
-    content: string;
-} | {
-    type: "rows";
-    content: TRow[];
-} | {
-    type: "transform";
-    content: string;
-};
-/** Status of a row in the chat sample, relative to its origin snapshot. */
-type ChatRowStatus = "new" | "edited" | "original";
-/** A sample row handed to the chat callback, with its current status and validation errors. */
-type ChatRow<TRow extends DataEditorRow = DataEditorRow> = {
-    /** Row data keyed by column ID. */
-    data: TRow;
-    /** Whether the row was newly added, edited, or is unchanged. */
-    status: ChatRowStatus;
-    /** Validation errors keyed by column ID. */
-    errors: Record<string, string[]>;
-    /** The source this row belongs to. */
-    source: string;
-};
-/** Aggregated error count across the current view, grouped by field and message. */
-type ChatErrorSummary = {
-    /** Column ID where the error occurred. */
-    field: string;
-    /** The validation message. */
-    message: string;
-    /** How many rows hit this error. */
-    count: number;
-    /** A few example values that triggered the error. */
-    examples: string[];
-};
-/**
- * Context about the current dataset, passed to `loadSuggestions` and extended
- * into `ChatContext` for `onMessage`.
- */
-type ChatDataContext<TRow extends DataEditorRow = DataEditorRow> = {
-    /** Full column definitions. */
-    columns: DataEditorColumn[];
-    /** Row identifier field. */
-    primaryKey: keyof TRow;
-    /** Total rows in the dataset. */
-    totalRowCount: number;
-    /** Rows in the current filtered view. */
-    filteredRowCount: number;
-    /** Sample rows, with status and errors. Size controlled by `sampleSize`. */
-    sample: ChatRow<TRow>[];
-    /** Aggregated error counts by field and message. */
-    errorSummary: ChatErrorSummary[];
-    /** Access all rows. Use for full-dataset operations. */
-    getRows: () => ChatRow<TRow>[];
-};
-/**
- * The full context passed to `DataEditorChat.onMessage` when the user sends
- * a prompt. Includes the prompt itself and all dataset context.
- */
-type ChatContext<TRow extends DataEditorRow = DataEditorRow> = ChatDataContext<TRow> & {
-    /** The user's chat prompt. */
-    message: string;
-};
-/**
- * Bring-your-own-AI chat configuration. When provided via the `chat` prop,
- * the editor shows a chat panel alongside the grid. You own the AI
- * integration; the SDK hands you dataset context and renders the streamed
- * response.
- *
- * @example
- * ```ts
- * chat={{
- *   sampleSize: 50,
- *   onMessage: async function* (context) {
- *     yield { type: "status", content: "Thinking..." };
- *     const res = await fetch("/api/ai", {
- *       method: "POST",
- *       body: JSON.stringify({
- *         prompt: context.message,
- *         columns: context.columns,
- *         sample: context.sample.map(r => r.data),
- *         errors: context.errorSummary,
- *       }),
- *     }).then(r => r.json());
- *     yield { type: "rows", content: res.updatedRows };
- *     yield { type: "transform", content: res.description };
- *     yield { type: "message", content: res.reply };
- *   },
- * }}
- * ```
- */
-type DataEditorChat<TRow extends DataEditorRow = DataEditorRow> = {
-    /**
-     * How many rows to include in the context sample. The SDK picks a
-     * representative slice including rows with errors. When omitted, the SDK decides.
-     */
-    sampleSize?: number;
-    /** Title shown above the suggestion list when the chat is empty. */
-    emptyTitle?: string;
-    /** How many suggestions to request from `loadSuggestions`. */
-    suggestionsCount?: number;
-    /** Optional prompt generator for the empty-state suggestion chips. */
-    loadSuggestions?: (context: ChatDataContext<TRow>) => Promise<string[]>;
-    /**
-     * Called when the user sends a message. Receives full dataset context.
-     * Returns an async iterable of response chunks — the SDK streams them
-     * into the UI.
-     */
-    onMessage: (context: ChatContext<TRow>) => AsyncIterable<ChatResponseChunk<TRow>>;
-    /** Called when the user cancels a pending request. Use to abort your API call. */
-    onCancel?: () => void;
-};
-
 /** Severity level for a validation message. */
 type ValidationLevel = "error";
 /**