latticesql 3.4.0 → 3.4.2

package/dist/index.d.cts

@@ -1816,6 +1816,16 @@ type RenderProgressCallback = (event: RenderProgress) => void;
 interface RenderOptions {
     onProgress?: RenderProgressCallback;
     signal?: AbortSignal;
+    /**
+     * Incremental render scope. When set, ONLY the entity-context tables affected
+     * by a change to one of these tables are re-rendered — the changed table itself
+     * plus any entity context that SOURCES from it (cross-table dependents) — and
+     * every other table's manifest entry + rendered files are left untouched. Used
+     * by the auto-render that fires on a single write or a single remote (cloud)
+     * change, so a one-row edit re-renders one entity instead of the whole tree.
+     * Omitted → a full render of everything (initial open, explicit `render()`).
+     */
+    changedTables?: ReadonlySet<string>;
 }
 /**
  * Coalesces high-frequency `table-progress` events down to ≤ ~5/sec per table,
@@ -1903,6 +1913,16 @@ declare class Lattice {
     private _autoRenderPending;
     private _autoRenderInFlight;
     private _autoRenderDebounceMs;
+    /**
+     * Incremental auto-render scope, accumulated between debounced renders. A write
+     * or a remote (cloud) change records the AFFECTED table here, so the next
+     * auto-render re-renders only that entity (+ its cross-table dependents) instead
+     * of the whole tree. `_pendingRenderAll` forces a full render (the initial
+     * render, or a change with no known table). Captured + reset when a render
+     * starts, so changes during a render re-accumulate and re-trigger.
+     */
+    private _pendingRenderTables;
+    private _pendingRenderAll;
     /** Cache of actual table columns (from PRAGMA), populated after init(). */
     private readonly _columnCache;
     /** Derived encryption key (from options.encryptionKey via scrypt). */
@@ -2323,8 +2343,11 @@ declare class Lattice {
      * tree when a REMOTE change arrives — notably an owner re-sharing or un-sharing
      * a row, after which the member's per-viewer projection must be recompiled. A
      * no-op when auto-render isn't enabled.
+     *
+     * Pass the CHANGED table so only that entity (+ its cross-table dependents) is
+     * re-rendered instead of the whole tree; omit it to force a full render.
      */
-    requestRender(): void;
+    requestRender(table?: string): void;
     /**
      * True while a render is actively writing the context tree + manifest (auto-
      * render OR a guarded background render). The file-loopback watcher checks this
@@ -2483,6 +2506,10 @@ declare class Lattice {
     /** Turn off automatic rendering and cancel any pending render. */
     disableAutoRender(): this;
     private _scheduleAutoRender;
+    /** Arm the debounce timer if not already armed. Does NOT change the render
+     *  scope — used both by `_scheduleAutoRender` and the post-render re-arm so a
+     *  re-arm never escalates a pending incremental render to a full one. */
+    private _armAutoRenderTimer;
     /**
      * Shared single-flight render path used by {@link renderInBackground}.
      *

package/dist/index.d.ts

@@ -1816,6 +1816,16 @@ type RenderProgressCallback = (event: RenderProgress) => void;
 interface RenderOptions {
     onProgress?: RenderProgressCallback;
     signal?: AbortSignal;
+    /**
+     * Incremental render scope. When set, ONLY the entity-context tables affected
+     * by a change to one of these tables are re-rendered — the changed table itself
+     * plus any entity context that SOURCES from it (cross-table dependents) — and
+     * every other table's manifest entry + rendered files are left untouched. Used
+     * by the auto-render that fires on a single write or a single remote (cloud)
+     * change, so a one-row edit re-renders one entity instead of the whole tree.
+     * Omitted → a full render of everything (initial open, explicit `render()`).
+     */
+    changedTables?: ReadonlySet<string>;
 }
 /**
  * Coalesces high-frequency `table-progress` events down to ≤ ~5/sec per table,
@@ -1903,6 +1913,16 @@ declare class Lattice {
     private _autoRenderPending;
     private _autoRenderInFlight;
     private _autoRenderDebounceMs;
+    /**
+     * Incremental auto-render scope, accumulated between debounced renders. A write
+     * or a remote (cloud) change records the AFFECTED table here, so the next
+     * auto-render re-renders only that entity (+ its cross-table dependents) instead
+     * of the whole tree. `_pendingRenderAll` forces a full render (the initial
+     * render, or a change with no known table). Captured + reset when a render
+     * starts, so changes during a render re-accumulate and re-trigger.
+     */
+    private _pendingRenderTables;
+    private _pendingRenderAll;
     /** Cache of actual table columns (from PRAGMA), populated after init(). */
     private readonly _columnCache;
     /** Derived encryption key (from options.encryptionKey via scrypt). */
@@ -2323,8 +2343,11 @@ declare class Lattice {
      * tree when a REMOTE change arrives — notably an owner re-sharing or un-sharing
      * a row, after which the member's per-viewer projection must be recompiled. A
      * no-op when auto-render isn't enabled.
+     *
+     * Pass the CHANGED table so only that entity (+ its cross-table dependents) is
+     * re-rendered instead of the whole tree; omit it to force a full render.
      */
-    requestRender(): void;
+    requestRender(table?: string): void;
     /**
      * True while a render is actively writing the context tree + manifest (auto-
      * render OR a guarded background render). The file-loopback watcher checks this
@@ -2483,6 +2506,10 @@ declare class Lattice {
     /** Turn off automatic rendering and cancel any pending render. */
     disableAutoRender(): this;
     private _scheduleAutoRender;
+    /** Arm the debounce timer if not already armed. Does NOT change the render
+     *  scope — used both by `_scheduleAutoRender` and the post-render re-arm so a
+     *  re-arm never escalates a pending incremental render to a full one. */
+    private _armAutoRenderTimer;
     /**
      * Shared single-flight render path used by {@link renderInBackground}.
      *