@avocadostudio-ai/preview-adapter 0.18.0 → 0.19.0

package/dist/bridge-controller.js

@@ -131,9 +131,10 @@ export function attachBridge(config) {
                 const isStructural = msg.op?.op === "add_block" || msg.op?.op === "move_block";
                 state.pendingScrollIntoView = isStructural || state.pendingScrollIntoView;
             }
-            if (msg.op?.op === "move_item") {
-                state.skipParentAnimationOnce = true;
-            }
+            // Assigned, not merely set: a stale `true` from an earlier message would
+            // otherwise silence the next real arrival, because the flag is cleared
+            // only when a focus poll actually runs.
+            state.skipEnterAnimationOnce = msg.animate === false || msg.op?.op === "move_item";
             state.expectingNewBlocks = msg.op?.op === "add_block";
             bridge.smoothRefresh();
             emitPatchAck(msg.txId, true);
@@ -158,6 +159,10 @@ export function attachBridge(config) {
             // scrolled into view after the refresh (a newly added block is only in
             // the DOM now). Explicit so the other ~20 draftUpdated callers are unaffected.
             state.pendingScrollIntoView = msg.payload.scrollIntoView === true;
+            // Same contract as applyPatch: the sender says whether this is an
+            // arrival worth animating. Typed edits fall back to this path whenever
+            // the patch transport is off or its ack was dropped.
+            state.skipEnterAnimationOnce = msg.payload.animate === false;
             state.expectingNewBlocks = true;
             bridge.clearLiveDraft();
             clearChildFocus();

package/dist/bridge-functions.d.ts

@@ -314,7 +314,21 @@ export type BridgeState = {
     } | null;
     suppressClickUntil: number;
     selectionMode: boolean;
-    skipParentAnimationOnce: boolean;
+    /**
+     * Suppress the focused block's arrival animation for the next refresh only.
+     *
+     * `applyBlockFocus(id, enter)` normally greets the block it focuses: a
+     * `block-enter` keyframe from `opacity: 0`, a 600 ms border flash and a
+     * sparkle sweep. That reads as "here is the thing that changed" and is worth
+     * having when a block is added, or when the agent edits one.
+     *
+     * It is wrong whenever the block was already on screen and only its contents
+     * changed in place — moving a list item inside it, or the user typing into
+     * one of its fields. Then the animation fades out the very block the user is
+     * looking at, once per debounce commit, which is read as a flash. The editor
+     * says which case it is with `animate: false` on the message.
+     */
+    skipEnterAnimationOnce: boolean;
     deleteConfirmTimer: {
         current: number | null;
     };

package/dist/bridge-functions.js

@@ -783,7 +783,7 @@ export function createBridgeState() {
         pendingScrollRestore: null,
         suppressClickUntil: 0,
         selectionMode: false,
-        skipParentAnimationOnce: false,
+        skipEnterAnimationOnce: false,
         deleteConfirmTimer: { current: null },
         pendingListItemMovePath: null,
         childSelectionLock: null,
@@ -1301,7 +1301,7 @@ export function createBridgeFunctions(state, callbacks, config) {
                 const nextPath = `${group.listKey}[${targetIndex}]`;
                 state.pendingListItemMovePath = nextPath;
                 setChildSelectionLock({ blockId, listKey: group.listKey, index: targetIndex, position: targetPosition });
-                state.skipParentAnimationOnce = true;
+                state.skipEnterAnimationOnce = true;
                 state.selectedEditablePath = nextPath;
                 state.selectedBlockId = blockId;
                 setHoveredListItem(null);
@@ -1324,7 +1324,7 @@ export function createBridgeFunctions(state, callbacks, config) {
                 const nextPath = `${group.listKey}[${targetIndex}]`;
                 state.pendingListItemMovePath = nextPath;
                 setChildSelectionLock({ blockId, listKey: group.listKey, index: targetIndex, position: targetPosition });
-                state.skipParentAnimationOnce = true;
+                state.skipEnterAnimationOnce = true;
                 state.selectedEditablePath = nextPath;
                 state.selectedBlockId = blockId;
                 setHoveredListItem(null);
@@ -1544,7 +1544,7 @@ export function createBridgeFunctions(state, callbacks, config) {
             return;
         let attempts = 0;
         const timer = window.setInterval(() => {
-            const shouldAnimate = !state.skipParentAnimationOnce;
+            const shouldAnimate = !state.skipEnterAnimationOnce;
             const done = applyBlockFocus(targetId, shouldAnimate, undefined, { scrollIntoView: state.pendingScrollIntoView });
             attempts += 1;
             if (done || attempts >= 20) {
@@ -1552,7 +1552,7 @@ export function createBridgeFunctions(state, callbacks, config) {
                 state.pendingFocusId = null;
                 state.pendingScrollIntoView = false;
                 state.pendingScrollAnchorY = null;
-                state.skipParentAnimationOnce = false;
+                state.skipEnterAnimationOnce = false;
             }
         }, 45);
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avocadostudio-ai/preview-adapter",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,7 +37,7 @@
     "src/styles.css"
   ],
   "dependencies": {
-    "@avocadostudio-ai/shared": "^0.18.0"
+    "@avocadostudio-ai/shared": "^0.19.0"
   },
   "peerDependencies": {
     "next": ">=15.0.0",