@adobe/data-lit 0.10.13 → 0.10.14

package/dist/hooks/component/hooks-controller.d.ts

@@ -12,11 +12,25 @@ import type { Component } from "./component.js";
  *
  * This installs a single Lit {@link ReactiveController} — the one hook-friendly
  * path to a genuine `hostDisconnected` — that:
- *  - on connect, dispatches `"connected"`, and on every *re*-connect forces a
- *    re-render so the (previously torn-down) hooks re-initialize and
- *    re-subscribe;
- *  - on disconnect, dispatches `"disconnected"` then disposes and clears all
- *    hook slots (full unmount semantics).
+ *  - on disconnect, *schedules* (on a microtask) dispatching `"disconnected"`,
+ *    disposing every hook slot, and clearing the cursor (full unmount semantics);
+ *  - on connect, if a teardown is still pending it CANCELS it (the disconnect
+ *    was half of a DOM move — hooks are intact, so nothing re-subscribes and no
+ *    re-render is forced); otherwise it dispatches `"connected"` and, on a true
+ *    reconnect, forces a re-render so the torn-down hooks re-initialize.
+ *
+ * ## Why disposal is deferred
+ *
+ * The DOM fires `disconnectedCallback` then `connectedCallback` **synchronously,
+ * in the same task,** whenever a connected element is merely *moved* — a Lit
+ * `repeat` reorder, a list re-parenting, a drag-reorder. Disposing inline would
+ * tear down and rebuild every subscription (re-running uncached producers) plus
+ * force a re-render on every such move, with the hook state momentarily reset —
+ * the studio-page lag, refresh churn, and transient empty lists on project
+ * switch (FFP-111900). Deferring teardown one microtask lets a synchronous
+ * reconnect distinguish a move (cancel) from a genuine unmount (let it run), so
+ * a move is a no-op and only a real unmount disposes. A late reconnect (a
+ * different task) is treated as unmount+remount, which is correct.
  *
  * It is installed lazily from inside the wrapped `render` (see {@link withHooks}),
  * which runs after `connectedCallback`, so `addController` fires `hostConnected`

package/dist/hooks/component/hooks-controller.integration.test.js

@@ -14,14 +14,18 @@ import { useObservable } from "../use-observable.js";
  * is torn down when the element leaves the DOM (instead of leaking and firing
  * `requestUpdate` on a detached element).
  */
-/** An Observe whose live subscriber count the test can inspect. */
+/** An Observe whose live subscriber count and cumulative churn the test can inspect. */
 function createTrackedObservable() {
     const subscribers = new Set();
     let current = 0;
+    let subscribes = 0;
+    let unsubscribes = 0;
     const observable = observer => {
+        subscribes++;
         subscribers.add(observer);
         observer(current);
         return () => {
+            unsubscribes++;
             subscribers.delete(observer);
         };
     };
@@ -33,8 +37,12 @@ function createTrackedObservable() {
                 observer(value);
         },
         subscriberCount: () => subscribers.size,
+        totalSubscribes: () => subscribes,
+        totalUnsubscribes: () => unsubscribes,
     };
 }
+/** Resolves after the current microtask checkpoint, so deferred teardown can run. */
+const flushMicrotasks = () => new Promise(resolve => queueMicrotask(resolve));
 class HookProbeElement extends LitElement {
     constructor() {
         super();
@@ -63,6 +71,9 @@ describe("hook disposal on real DOM disconnect", () => {
             originalRequestUpdate(...args);
         };
         el.remove();
+        // Teardown is deferred one microtask (so a re-parent MOVE can cancel it —
+        // see the move test below); a genuine unmount has no reconnect, so it runs.
+        await flushMicrotasks();
         // Disconnect ran the effect cleanup: the subscription is gone.
         expect(subscriberCount()).toBe(0);
         // A later emit reaches no leaked subscriber, so the detached element is
@@ -70,5 +81,39 @@ describe("hook disposal on real DOM disconnect", () => {
         emit(99);
         expect(updatesAfterRemove).toBe(0);
     });
+    it("does NOT tear down and rebuild subscriptions when the element is merely MOVED", async () => {
+        const { observable, subscriberCount, totalSubscribes, totalUnsubscribes } = createTrackedObservable();
+        const parentA = document.createElement("div");
+        const parentB = document.createElement("div");
+        document.body.appendChild(parentA);
+        document.body.appendChild(parentB);
+        const el = document.createElement("hook-probe-element");
+        el.observable = observable;
+        parentA.appendChild(el);
+        await el.updateComplete;
+        expect(subscriberCount()).toBe(1);
+        expect(totalSubscribes()).toBe(1);
+        let updatesDuringMove = 0;
+        const originalRequestUpdate = el.requestUpdate.bind(el);
+        el.requestUpdate = (...args) => {
+            updatesDuringMove++;
+            originalRequestUpdate(...args);
+        };
+        // MOVE: appendChild to another already-connected parent fires
+        // disconnectedCallback then connectedCallback synchronously, in one task.
+        parentB.appendChild(el);
+        await flushMicrotasks();
+        await el.updateComplete;
+        // The element is still mounted and its subscription is intact...
+        expect(el.isConnected).toBe(true);
+        expect(subscriberCount()).toBe(1);
+        // ...and, crucially, the move neither disposed nor re-created it. Before the
+        // deferred-disposal fix, a move disposed and re-subscribed (2 subs / 1 unsub)
+        // and forced an extra re-render — the source of the studio-page lag, churn,
+        // and transient empty lists on project switch (FFP-111900).
+        expect(totalUnsubscribes()).toBe(0);
+        expect(totalSubscribes()).toBe(1);
+        expect(updatesDuringMove).toBe(0);
+    });
 });
 //# sourceMappingURL=hooks-controller.integration.test.js.map

package/dist/hooks/component/hooks-controller.integration.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-controller.integration.test.js","sourceRoot":"","sources":["../../../src/hooks/component/hooks-controller.integration.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks-controller.integration.test.js","sourceRoot":"","sources":["../../../src/hooks/component/hooks-controller.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/hooks/component/hooks-controller.js

@@ -42,11 +42,25 @@ function disposeHooks(host) {
  *
  * This installs a single Lit {@link ReactiveController} — the one hook-friendly
  * path to a genuine `hostDisconnected` — that:
- *  - on connect, dispatches `"connected"`, and on every *re*-connect forces a
- *    re-render so the (previously torn-down) hooks re-initialize and
- *    re-subscribe;
- *  - on disconnect, dispatches `"disconnected"` then disposes and clears all
- *    hook slots (full unmount semantics).
+ *  - on disconnect, *schedules* (on a microtask) dispatching `"disconnected"`,
+ *    disposing every hook slot, and clearing the cursor (full unmount semantics);
+ *  - on connect, if a teardown is still pending it CANCELS it (the disconnect
+ *    was half of a DOM move — hooks are intact, so nothing re-subscribes and no
+ *    re-render is forced); otherwise it dispatches `"connected"` and, on a true
+ *    reconnect, forces a re-render so the torn-down hooks re-initialize.
+ *
+ * ## Why disposal is deferred
+ *
+ * The DOM fires `disconnectedCallback` then `connectedCallback` **synchronously,
+ * in the same task,** whenever a connected element is merely *moved* — a Lit
+ * `repeat` reorder, a list re-parenting, a drag-reorder. Disposing inline would
+ * tear down and rebuild every subscription (re-running uncached producers) plus
+ * force a re-render on every such move, with the hook state momentarily reset —
+ * the studio-page lag, refresh churn, and transient empty lists on project
+ * switch (FFP-111900). Deferring teardown one microtask lets a synchronous
+ * reconnect distinguish a move (cancel) from a genuine unmount (let it run), so
+ * a move is a no-op and only a real unmount disposes. A late reconnect (a
+ * different task) is treated as unmount+remount, which is correct.
  *
  * It is installed lazily from inside the wrapped `render` (see {@link withHooks}),
  * which runs after `connectedCallback`, so `addController` fires `hostConnected`
@@ -64,8 +78,18 @@ export function installHooksController(host) {
     // guards against a re-entrant render re-installing a duplicate controller.
     host[HOOKS_CONTROLLER] = true;
     let connectedOnce = false;
+    // True between a disconnect and its scheduled teardown. A reconnect that sees
+    // this flag set is the tail of a move and cancels the teardown.
+    let pendingDisposal = false;
     const controller = {
         hostConnected() {
+            if (pendingDisposal) {
+                // Tail of a MOVE: the just-fired disconnect scheduled a teardown that
+                // has not run yet. Cancel it — the hooks are untouched, so there is
+                // nothing to re-subscribe and no reason to force a re-render.
+                pendingDisposal = false;
+                return;
+            }
             // The "connected" / "disconnected" events are for EXTERNAL listeners only.
             // The internal useConnected does NOT depend on them: this fires before the
             // render body attaches any listener, so useConnected is driven by its direct
@@ -79,8 +103,17 @@ export function installHooksController(host) {
             connectedOnce = true;
         },
         hostDisconnected() {
-            host.dispatchEvent(new Event("disconnected"));
-            disposeHooks(host);
+            // Defer teardown one microtask so a synchronous reconnect (a DOM move)
+            // can cancel it above. Only a genuine unmount reaches the callback.
+            pendingDisposal = true;
+            queueMicrotask(() => {
+                if (!pendingDisposal) {
+                    return;
+                }
+                pendingDisposal = false;
+                host.dispatchEvent(new Event("disconnected"));
+                disposeHooks(host);
+            });
         },
     };
     try {

package/dist/hooks/component/hooks-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-controller.js","sourceRoot":"","sources":["../../../src/hooks/component/hooks-controller.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAKvD;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAI5D,SAAS,cAAc,CAAC,IAAe;IACnC,OAAO,eAAe,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,UAAU,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,IAAe;IACjC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvB,IAAI,KAAK,EAAE,CAAC;QACR,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACtB,IAA6C,EAAE,OAAO,EAAE,EAAE,CAAC;QAChE,CAAC;IACL,CAAC;IACD,iFAAiF;IACjF,mFAAmF;IACnF,iFAAiF;IACjF,gFAAgF;IAChF,8EAA8E;IAC9E,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAe;IAClD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClD,OAAO;IACX,CAAC;IACD,0EAA0E;IAC1E,8EAA8E;IAC9E,2EAA2E;IAC3E,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAE9B,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,MAAM,UAAU,GAAuB;QACnC,aAAa;YACT,2EAA2E;YAC3E,2EAA2E;YAC3E,6EAA6E;YAC7E,oDAAoD;YACpD,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;YAC3C,IAAI,aAAa,EAAE,CAAC;gBAChB,gEAAgE;gBAChE,4DAA4D;gBAC5D,IAAI,CAAC,aAAa,EAAE,CAAC;YACzB,CAAC;YACD,aAAa,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,gBAAgB;YACZ,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;YAC9C,YAAY,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;KACJ,CAAC;IACF,IAAI,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,4EAA4E;QAC5E,2EAA2E;QAC3E,IAAI,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;QACnC,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC"}
+{"version":3,"file":"hooks-controller.js","sourceRoot":"","sources":["../../../src/hooks/component/hooks-controller.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAKvD;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAI5D,SAAS,cAAc,CAAC,IAAe;IACnC,OAAO,eAAe,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,UAAU,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,IAAe;IACjC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvB,IAAI,KAAK,EAAE,CAAC;QACR,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACtB,IAA6C,EAAE,OAAO,EAAE,EAAE,CAAC;QAChE,CAAC;IACL,CAAC;IACD,iFAAiF;IACjF,mFAAmF;IACnF,iFAAiF;IACjF,gFAAgF;IAChF,8EAA8E;IAC9E,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAe;IAClD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClD,OAAO;IACX,CAAC;IACD,0EAA0E;IAC1E,8EAA8E;IAC9E,2EAA2E;IAC3E,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAE9B,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,8EAA8E;IAC9E,gEAAgE;IAChE,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,MAAM,UAAU,GAAuB;QACnC,aAAa;YACT,IAAI,eAAe,EAAE,CAAC;gBAClB,sEAAsE;gBACtE,oEAAoE;gBACpE,8DAA8D;gBAC9D,eAAe,GAAG,KAAK,CAAC;gBACxB,OAAO;YACX,CAAC;YACD,2EAA2E;YAC3E,2EAA2E;YAC3E,6EAA6E;YAC7E,oDAAoD;YACpD,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;YAC3C,IAAI,aAAa,EAAE,CAAC;gBAChB,gEAAgE;gBAChE,4DAA4D;gBAC5D,IAAI,CAAC,aAAa,EAAE,CAAC;YACzB,CAAC;YACD,aAAa,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,gBAAgB;YACZ,uEAAuE;YACvE,oEAAoE;YACpE,eAAe,GAAG,IAAI,CAAC;YACvB,cAAc,CAAC,GAAG,EAAE;gBAChB,IAAI,CAAC,eAAe,EAAE,CAAC;oBACnB,OAAO;gBACX,CAAC;gBACD,eAAe,GAAG,KAAK,CAAC;gBACxB,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;gBAC9C,YAAY,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;QACP,CAAC;KACJ,CAAC;IACF,IAAI,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,4EAA4E;QAC5E,2EAA2E;QAC3E,IAAI,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;QACnC,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC"}

package/dist/hooks/component/hooks-controller.test.js

@@ -30,8 +30,10 @@ class FakeHost extends EventTarget {
             c.hostDisconnected?.();
     }
 }
+/** Resolves after the current microtask checkpoint, so deferred teardown can run. */
+const flushMicrotasks = () => new Promise(resolve => queueMicrotask(resolve));
 describe("installHooksController", () => {
-    it("disposes every effect hook and resets the cursor on disconnect", () => {
+    it("disposes every effect hook and resets the cursor on a genuine disconnect", async () => {
         const host = new FakeHost();
         const disposeA = vi.fn();
         const disposeB = vi.fn();
@@ -44,12 +46,32 @@ describe("installHooksController", () => {
         host.hookIndex = 4;
         installHooksController(host);
         host.disconnect();
+        // Teardown is deferred one microtask (so a move can cancel it); with no
+        // reconnect this is a real unmount, so it runs on the next checkpoint.
+        await flushMicrotasks();
         expect(disposeA).toHaveBeenCalledTimes(1);
         expect(disposeB).toHaveBeenCalledTimes(1);
         expect(host.hooks).toEqual([]);
         expect(host.hookIndex).toBe(0);
     });
-    it("dispatches connected / disconnected events across the lifecycle", () => {
+    it("a synchronous disconnect→reconnect (a MOVE) cancels teardown and forces no re-render", async () => {
+        const host = new FakeHost();
+        const dispose = vi.fn();
+        host.hooks = [{ dispose, dependencies: [] }];
+        host.hookIndex = 1;
+        installHooksController(host);
+        host.connect(); // first mount
+        host.requestUpdate.mockClear();
+        // Disconnect immediately followed by reconnect, same task — a DOM move.
+        host.disconnect();
+        host.connect();
+        await flushMicrotasks();
+        // Nothing was torn down and no re-render was forced: the hooks survived.
+        expect(dispose).not.toHaveBeenCalled();
+        expect(host.hooks).toHaveLength(1);
+        expect(host.requestUpdate).not.toHaveBeenCalled();
+    });
+    it("dispatches connected / disconnected events across the lifecycle", async () => {
         const host = new FakeHost();
         const onConnected = vi.fn();
         const onDisconnected = vi.fn();
@@ -59,15 +81,17 @@ describe("installHooksController", () => {
         host.connect();
         expect(onConnected).toHaveBeenCalledTimes(1);
         host.disconnect();
+        await flushMicrotasks();
         expect(onDisconnected).toHaveBeenCalledTimes(1);
     });
-    it("forces a re-render only on RE-connect, not the first connect", () => {
+    it("forces a re-render only on a genuine RE-connect, not the first connect", async () => {
         const host = new FakeHost();
         installHooksController(host);
         host.connect(); // first mount
         expect(host.requestUpdate).not.toHaveBeenCalled();
         host.disconnect();
-        host.connect(); // reconnect
+        await flushMicrotasks(); // genuine unmount: teardown runs
+        host.connect(); // reconnect re-initializes the torn-down hooks
         expect(host.requestUpdate).toHaveBeenCalledTimes(1);
     });
     it("is idempotent — repeated installs register a single controller", () => {

package/dist/hooks/component/hooks-controller.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-controller.test.js","sourceRoot":"","sources":["../../../src/hooks/component/hooks-controller.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks-controller.test.js","sourceRoot":"","sources":["../../../src/hooks/component/hooks-controller.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-lit",
-  "version": "0.10.13",
+  "version": "0.10.14",
   "description": "Adobe data Lit bindings - hooks, elements, decorators",
   "type": "module",
   "private": false,
@@ -12,7 +12,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@adobe/data": "0.10.13"
+    "@adobe/data": "0.10.14"
   },
   "peerDependencies": {
     "lit": "^3.3.1"

package/src/hooks/component/hooks-controller.integration.test.ts

@@ -17,18 +17,24 @@ import { useObservable } from "../use-observable.js";
  * `requestUpdate` on a detached element).
  */
 
-/** An Observe whose live subscriber count the test can inspect. */
+/** An Observe whose live subscriber count and cumulative churn the test can inspect. */
 function createTrackedObservable(): {
     observable: Observe<number>;
     emit: (value: number) => void;
     subscriberCount: () => number;
+    totalSubscribes: () => number;
+    totalUnsubscribes: () => number;
 } {
     const subscribers = new Set<(value: number) => void>();
     let current = 0;
+    let subscribes = 0;
+    let unsubscribes = 0;
     const observable: Observe<number> = observer => {
+        subscribes++;
         subscribers.add(observer);
         observer(current);
         return () => {
+            unsubscribes++;
             subscribers.delete(observer);
         };
     };
@@ -39,9 +45,14 @@ function createTrackedObservable(): {
             for (const observer of subscribers) observer(value);
         },
         subscriberCount: () => subscribers.size,
+        totalSubscribes: () => subscribes,
+        totalUnsubscribes: () => unsubscribes,
     };
 }
 
+/** Resolves after the current microtask checkpoint, so deferred teardown can run. */
+const flushMicrotasks = (): Promise<void> => new Promise(resolve => queueMicrotask(resolve));
+
 class HookProbeElement extends LitElement {
     observable!: Observe<number>;
     constructor() {
@@ -76,6 +87,9 @@ describe("hook disposal on real DOM disconnect", () => {
         };
 
         el.remove();
+        // Teardown is deferred one microtask (so a re-parent MOVE can cancel it —
+        // see the move test below); a genuine unmount has no reconnect, so it runs.
+        await flushMicrotasks();
 
         // Disconnect ran the effect cleanup: the subscription is gone.
         expect(subscriberCount()).toBe(0);
@@ -85,4 +99,44 @@ describe("hook disposal on real DOM disconnect", () => {
         emit(99);
         expect(updatesAfterRemove).toBe(0);
     });
+
+    it("does NOT tear down and rebuild subscriptions when the element is merely MOVED", async () => {
+        const { observable, subscriberCount, totalSubscribes, totalUnsubscribes } = createTrackedObservable();
+
+        const parentA = document.createElement("div");
+        const parentB = document.createElement("div");
+        document.body.appendChild(parentA);
+        document.body.appendChild(parentB);
+
+        const el = document.createElement("hook-probe-element") as HookProbeElement;
+        el.observable = observable;
+        parentA.appendChild(el);
+        await el.updateComplete;
+        expect(subscriberCount()).toBe(1);
+        expect(totalSubscribes()).toBe(1);
+
+        let updatesDuringMove = 0;
+        const originalRequestUpdate = el.requestUpdate.bind(el);
+        el.requestUpdate = (...args: Parameters<HookProbeElement["requestUpdate"]>) => {
+            updatesDuringMove++;
+            originalRequestUpdate(...args);
+        };
+
+        // MOVE: appendChild to another already-connected parent fires
+        // disconnectedCallback then connectedCallback synchronously, in one task.
+        parentB.appendChild(el);
+        await flushMicrotasks();
+        await el.updateComplete;
+
+        // The element is still mounted and its subscription is intact...
+        expect(el.isConnected).toBe(true);
+        expect(subscriberCount()).toBe(1);
+        // ...and, crucially, the move neither disposed nor re-created it. Before the
+        // deferred-disposal fix, a move disposed and re-subscribed (2 subs / 1 unsub)
+        // and forced an extra re-render — the source of the studio-page lag, churn,
+        // and transient empty lists on project switch (FFP-111900).
+        expect(totalUnsubscribes()).toBe(0);
+        expect(totalSubscribes()).toBe(1);
+        expect(updatesDuringMove).toBe(0);
+    });
 });

package/src/hooks/component/hooks-controller.test.ts

@@ -30,8 +30,11 @@ class FakeHost extends EventTarget implements Component {
     }
 }
 
+/** Resolves after the current microtask checkpoint, so deferred teardown can run. */
+const flushMicrotasks = (): Promise<void> => new Promise(resolve => queueMicrotask(resolve));
+
 describe("installHooksController", () => {
-    it("disposes every effect hook and resets the cursor on disconnect", () => {
+    it("disposes every effect hook and resets the cursor on a genuine disconnect", async () => {
         const host = new FakeHost();
         const disposeA = vi.fn();
         const disposeB = vi.fn();
@@ -45,6 +48,9 @@ describe("installHooksController", () => {
 
         installHooksController(host);
         host.disconnect();
+        // Teardown is deferred one microtask (so a move can cancel it); with no
+        // reconnect this is a real unmount, so it runs on the next checkpoint.
+        await flushMicrotasks();
 
         expect(disposeA).toHaveBeenCalledTimes(1);
         expect(disposeB).toHaveBeenCalledTimes(1);
@@ -52,7 +58,28 @@ describe("installHooksController", () => {
         expect(host.hookIndex).toBe(0);
     });
 
-    it("dispatches connected / disconnected events across the lifecycle", () => {
+    it("a synchronous disconnect→reconnect (a MOVE) cancels teardown and forces no re-render", async () => {
+        const host = new FakeHost();
+        const dispose = vi.fn();
+        host.hooks = [{ dispose, dependencies: [] }];
+        host.hookIndex = 1;
+
+        installHooksController(host);
+        host.connect(); // first mount
+        host.requestUpdate.mockClear();
+
+        // Disconnect immediately followed by reconnect, same task — a DOM move.
+        host.disconnect();
+        host.connect();
+        await flushMicrotasks();
+
+        // Nothing was torn down and no re-render was forced: the hooks survived.
+        expect(dispose).not.toHaveBeenCalled();
+        expect(host.hooks).toHaveLength(1);
+        expect(host.requestUpdate).not.toHaveBeenCalled();
+    });
+
+    it("dispatches connected / disconnected events across the lifecycle", async () => {
         const host = new FakeHost();
         const onConnected = vi.fn();
         const onDisconnected = vi.fn();
@@ -64,10 +91,11 @@ describe("installHooksController", () => {
         expect(onConnected).toHaveBeenCalledTimes(1);
 
         host.disconnect();
+        await flushMicrotasks();
         expect(onDisconnected).toHaveBeenCalledTimes(1);
     });
 
-    it("forces a re-render only on RE-connect, not the first connect", () => {
+    it("forces a re-render only on a genuine RE-connect, not the first connect", async () => {
         const host = new FakeHost();
         installHooksController(host);
 
@@ -75,7 +103,8 @@ describe("installHooksController", () => {
         expect(host.requestUpdate).not.toHaveBeenCalled();
 
         host.disconnect();
-        host.connect(); // reconnect
+        await flushMicrotasks(); // genuine unmount: teardown runs
+        host.connect(); // reconnect re-initializes the torn-down hooks
         expect(host.requestUpdate).toHaveBeenCalledTimes(1);
     });
 

package/src/hooks/component/hooks-controller.ts

@@ -51,11 +51,25 @@ function disposeHooks(host: Component): void {
  *
  * This installs a single Lit {@link ReactiveController} — the one hook-friendly
  * path to a genuine `hostDisconnected` — that:
- *  - on connect, dispatches `"connected"`, and on every *re*-connect forces a
- *    re-render so the (previously torn-down) hooks re-initialize and
- *    re-subscribe;
- *  - on disconnect, dispatches `"disconnected"` then disposes and clears all
- *    hook slots (full unmount semantics).
+ *  - on disconnect, *schedules* (on a microtask) dispatching `"disconnected"`,
+ *    disposing every hook slot, and clearing the cursor (full unmount semantics);
+ *  - on connect, if a teardown is still pending it CANCELS it (the disconnect
+ *    was half of a DOM move — hooks are intact, so nothing re-subscribes and no
+ *    re-render is forced); otherwise it dispatches `"connected"` and, on a true
+ *    reconnect, forces a re-render so the torn-down hooks re-initialize.
+ *
+ * ## Why disposal is deferred
+ *
+ * The DOM fires `disconnectedCallback` then `connectedCallback` **synchronously,
+ * in the same task,** whenever a connected element is merely *moved* — a Lit
+ * `repeat` reorder, a list re-parenting, a drag-reorder. Disposing inline would
+ * tear down and rebuild every subscription (re-running uncached producers) plus
+ * force a re-render on every such move, with the hook state momentarily reset —
+ * the studio-page lag, refresh churn, and transient empty lists on project
+ * switch (FFP-111900). Deferring teardown one microtask lets a synchronous
+ * reconnect distinguish a move (cancel) from a genuine unmount (let it run), so
+ * a move is a no-op and only a real unmount disposes. A late reconnect (a
+ * different task) is treated as unmount+remount, which is correct.
  *
  * It is installed lazily from inside the wrapped `render` (see {@link withHooks}),
  * which runs after `connectedCallback`, so `addController` fires `hostConnected`
@@ -74,8 +88,18 @@ export function installHooksController(host: Component): void {
     host[HOOKS_CONTROLLER] = true;
 
     let connectedOnce = false;
+    // True between a disconnect and its scheduled teardown. A reconnect that sees
+    // this flag set is the tail of a move and cancels the teardown.
+    let pendingDisposal = false;
     const controller: ReactiveController = {
         hostConnected() {
+            if (pendingDisposal) {
+                // Tail of a MOVE: the just-fired disconnect scheduled a teardown that
+                // has not run yet. Cancel it — the hooks are untouched, so there is
+                // nothing to re-subscribe and no reason to force a re-render.
+                pendingDisposal = false;
+                return;
+            }
             // The "connected" / "disconnected" events are for EXTERNAL listeners only.
             // The internal useConnected does NOT depend on them: this fires before the
             // render body attaches any listener, so useConnected is driven by its direct
@@ -89,8 +113,17 @@ export function installHooksController(host: Component): void {
             connectedOnce = true;
         },
         hostDisconnected() {
-            host.dispatchEvent(new Event("disconnected"));
-            disposeHooks(host);
+            // Defer teardown one microtask so a synchronous reconnect (a DOM move)
+            // can cancel it above. Only a genuine unmount reaches the callback.
+            pendingDisposal = true;
+            queueMicrotask(() => {
+                if (!pendingDisposal) {
+                    return;
+                }
+                pendingDisposal = false;
+                host.dispatchEvent(new Event("disconnected"));
+                disposeHooks(host);
+            });
         },
     };
     try {