nudge-ui 0.2.4 → 0.2.5

package/dist/inspector/projection/textProjection.js

@@ -1,7 +1,8 @@
-import { getActiveDraftChanges, getDraftChanges } from "../changes/draftChanges.js";
+import { boundRuntimeEvidence, normalizeRuntimeTag, runtimeDomPath } from "../runtime/staticHtmlRuntimeIdentity.js";
+import { getActiveDraftChanges, getDraftChanges } from "../drafts/store.js";
 import { sourceSiteSelector } from "../selection/sourceSite.js";
 import { isNudgeUiDev } from "../runtime/devFlag.js";
-import { isTextContentChangeValue, isTextProjectionTargetValue, } from "../inline-text/textChangeBoundary.js";
+import { isTextContentChangeValue, isTextProjectionTargetValue, } from "../changes/editModel.js";
 import { isInteractionStylesInstalled } from "../overlay/interactionStyles.js";
 /** Strict JSON boundary guard for a text projection target. */
 export const isTextProjectionTarget = isTextProjectionTargetValue;
@@ -190,28 +191,32 @@ export function resolveTextProjectionTextNode(element, target, expectedText = ta
     }
     return matches.length === 1 ? matches[0] : null;
 }
-function hasSafeMixedDescendants(element) {
+/** Whether an element's text is code, form state, or other non-prose content. */
+export function isUnsafeTextHost(element) {
+    return UNSAFE_TEXT_TAGS.has(element.tagName);
+}
+/** Whether an application-owned editing region contains the element. */
+export function isInApplicationEditingHost(element) {
+    const editingHost = element.closest("[contenteditable]");
+    return Boolean(editingHost
+        && editingHost.getAttribute("data-inline-editor") !== "true"
+        && editingHost.getAttribute("contenteditable") !== "false");
+}
+/** Whether replacing one text node inside the element keeps its authored markup. */
+export function hasSafeMixedDescendants(element) {
     // <br> only controls line layout. The projection targets one exact text
     // node, so keeping the break while changing that node is safe; formatting
     // descendants below still reject a flattening text projection.
     for (const descendant of Array.from(element.querySelectorAll("*"))) {
         if (UNSAFE_MIXED_DESCENDANT_TAGS.has(descendant.tagName))
             return false;
-        const editingHost = descendant.closest("[contenteditable]");
-        if (editingHost
-            && editingHost.getAttribute("data-inline-editor") !== "true"
-            && editingHost.getAttribute("contenteditable") !== "false")
+        if (isInApplicationEditingHost(descendant))
             return false;
     }
     return true;
 }
 function textHostIsSafe(element, allowEmpty = false, target) {
-    if (UNSAFE_TEXT_TAGS.has(element.tagName))
-        return false;
-    const editingHost = element.closest("[contenteditable]");
-    if (editingHost
-        && editingHost.getAttribute("data-inline-editor") !== "true"
-        && editingHost.getAttribute("contenteditable") !== "false")
+    if (isUnsafeTextHost(element) || isInApplicationEditingHost(element))
         return false;
     if (allowEmpty && element.childNodes.length === 0)
         return true;
@@ -295,6 +300,9 @@ export function captureTextProjectionTarget(element, beforeText = element.textCo
         props: element.getAttribute("data-cprops"),
         ariaLabel: element.getAttribute("aria-label"),
         beforeText,
+        tagName: normalizeRuntimeTag(element.tagName),
+        elementId: boundRuntimeEvidence(element.id || null),
+        domPath: runtimeDomPath(element),
         ...pathTarget,
     };
 }

package/dist/inspector/prompt/clipboardHandoff.d.ts

@@ -27,5 +27,14 @@ export declare function getClipboardHandoffRecords(draftId: string): {
     structuralChanges: StructuralChange[];
 };
 export declare function reconcileClipboardHandoff(doc?: Document): Promise<number>;
+/**
+ * Verifies copied edits after the document changes. Each check briefly removes
+ * the copied preview, so a check that reconciles nothing doubles the minimum
+ * interval before the next one: a page that mutates continuously (clocks,
+ * carousels) would otherwise flash the preview every few hundred milliseconds.
+ * Later changes never postpone a pending check, so a busy page is still
+ * checked once per interval. Returning to the page or copying a new prompt
+ * resets the interval.
+ */
 export declare function startClipboardHandoffController(doc?: Document): () => void;
 export {};

package/dist/inspector/prompt/clipboardHandoff.js

@@ -1,5 +1,5 @@
 import { changeKey } from "../changes/model.js";
-import { getDraftChanges, getActiveDraftChanges, subscribeActiveDraftChanges } from "../changes/draftChanges.js";
+import { getDraftChanges, getActiveDraftChanges, subscribeActiveDraftChanges } from "../drafts/store.js";
 import { documentRevisions, subscribeDocumentRevision } from "../tokens/resolution/cssomCollector.js";
 import { captureHandoffOwner, handoffChangeFingerprint, handoffStructuralFingerprint, verifyAndReconcileHandoff, } from "../agent/verification.js";
 import { isDraftTarget } from "../drafts/model.js";
@@ -124,33 +124,58 @@ export async function reconcileClipboardHandoff(doc = document) {
     }
     return removed;
 }
+const CHECK_DELAY_MS = 450;
+const MAX_CHECK_DELAY_MS = 8_000;
+/**
+ * Verifies copied edits after the document changes. Each check briefly removes
+ * the copied preview, so a check that reconciles nothing doubles the minimum
+ * interval before the next one: a page that mutates continuously (clocks,
+ * carousels) would otherwise flash the preview every few hundred milliseconds.
+ * Later changes never postpone a pending check, so a busy page is still
+ * checked once per interval. Returning to the page or copying a new prompt
+ * resets the interval.
+ */
 export function startClipboardHandoffController(doc = document) {
     const view = doc.defaultView;
     let timer = null;
     let checking = false;
     let stopped = false;
-    const schedule = () => {
+    let interval = CHECK_DELAY_MS;
+    let lastCheckEndedAt = -Infinity;
+    const run = () => {
+        timer = null;
         if (stopped || checking || !checkpoints.size)
             return;
+        checking = true;
+        void reconcileClipboardHandoff(doc).then((removed) => {
+            interval = removed > 0 ? CHECK_DELAY_MS : Math.min(interval * 2, MAX_CHECK_DELAY_MS);
+        }, () => undefined).finally(() => {
+            lastCheckEndedAt = Date.now();
+            setTimeout(() => { checking = false; }, 0);
+        });
+    };
+    const schedule = () => {
+        if (stopped || checking || !checkpoints.size || timer !== null)
+            return;
+        // Let the change that triggered this settle, and keep the backoff interval.
+        timer = setTimeout(run, Math.max(CHECK_DELAY_MS, lastCheckEndedAt + interval - Date.now()));
+    };
+    const returned = () => {
+        interval = CHECK_DELAY_MS;
+        lastCheckEndedAt = -Infinity;
         if (timer !== null)
             clearTimeout(timer);
-        timer = setTimeout(() => {
-            timer = null;
-            if (stopped || checking || !checkpoints.size)
-                return;
-            checking = true;
-            void reconcileClipboardHandoff(doc).catch(() => undefined).finally(() => {
-                setTimeout(() => { checking = false; }, 0);
-            });
-        }, 450);
+        timer = null;
+        schedule();
     };
     const visible = () => { if (doc.visibilityState === "visible")
-        schedule(); };
+        returned(); };
     documentRevisions(doc);
     const stopRevision = subscribeDocumentRevision(doc, schedule);
     const stopChanges = subscribeActiveDraftChanges(pruneCheckpoints);
-    view?.addEventListener("focus", schedule);
-    view?.addEventListener("pageshow", schedule);
+    const stopHandoff = subscribeClipboardHandoff(() => { interval = CHECK_DELAY_MS; });
+    view?.addEventListener("focus", returned);
+    view?.addEventListener("pageshow", returned);
     doc.addEventListener("visibilitychange", visible);
     schedule();
     return () => {
@@ -159,8 +184,9 @@ export function startClipboardHandoffController(doc = document) {
             clearTimeout(timer);
         stopRevision();
         stopChanges();
-        view?.removeEventListener("focus", schedule);
-        view?.removeEventListener("pageshow", schedule);
+        stopHandoff();
+        view?.removeEventListener("focus", returned);
+        view?.removeEventListener("pageshow", returned);
         doc.removeEventListener("visibilitychange", visible);
     };
 }

package/dist/inspector/prompt/generatePrompt.d.ts

@@ -1,4 +1,4 @@
-import type { ChangeRecord } from "../changes/changesLog.js";
+import type { ChangeRecord } from "../changes/types.js";
 import type { StructuralChange } from "../projection/structuralProjection.js";
 import type { AgentSketchMetadata } from "../agent/protocol.js";
 import { type ElementComment } from "../comments/store.js";