@agent-native/core 0.88.0 → 0.90.2

package/dist/client/components/RecentEditHighlights.js

@@ -1,146 +1,2 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * RecentEditHighlights — lingering, fading highlights over regions another
- * participant (human or agent) just edited, with their name/avatar flag.
- *
- * The Google-Docs/Figma feel: when a collaborator or the AI edits something,
- * the changed region glows in their color and the flag identifies them; the
- * highlight fades out over the last portion of its lifetime instead of
- * vanishing.
- *
- * Feed it `useRecentEdits(others)` (which reads participants' `recentEdits`
- * awareness rings) and a `resolveRect` that maps an edit descriptor to a
- * viewport DOMRect for your surface:
- *
- *   const others = usePresence(awareness, ydoc?.clientID).others;
- *   const edits = useRecentEdits(others);
- *   <RecentEditHighlights
- *     edits={edits}
- *     resolveRect={(edit) =>
- *       edit.descriptor.kind === "selector"
- *         ? container.querySelector(edit.descriptor.selector)?.getBoundingClientRect() ?? null
- *         : null
- *     }
- *     containerRef={containerRef}
- *   />
- */
-import { memo, useEffect, useLayoutEffect, useRef, useState } from "react";
-import { RECENT_EDIT_TTL_MS } from "../../collab/recent-edits.js";
-const HighlightItem = memo(function HighlightItem({ h }) {
-    return (_jsx("div", { "aria-label": `${h.label} edited this`, style: {
-            position: "absolute",
-            top: h.rect.top,
-            left: h.rect.left,
-            width: h.rect.width,
-            height: h.rect.height,
-            borderRadius: 4,
-            pointerEvents: "none",
-            zIndex: 9997,
-            opacity: h.opacity,
-            transition: "opacity 400ms ease-out",
-            outline: `2px solid ${h.color}`,
-            outlineOffset: 2,
-            backgroundColor: `${h.color}1A`,
-            boxShadow: `0 0 0 1px ${h.color}33, 0 0 12px ${h.color}40`,
-        }, children: _jsxs("div", { style: {
-                position: "absolute",
-                top: -22,
-                left: 0,
-                display: "flex",
-                alignItems: "center",
-                gap: 4,
-                backgroundColor: h.color,
-                color: "#fff",
-                fontSize: 10,
-                fontWeight: 600,
-                padding: "2px 6px",
-                borderRadius: 3,
-                whiteSpace: "nowrap",
-                maxWidth: 180,
-                overflow: "hidden",
-                textOverflow: "ellipsis",
-            }, children: [h.avatarUrl ? (_jsx("img", { src: h.avatarUrl, alt: "", style: {
-                        width: 12,
-                        height: 12,
-                        borderRadius: "50%",
-                        flexShrink: 0,
-                    } })) : null, h.label] }) }));
-});
-export function RecentEditHighlights({ edits, resolveRect, containerRef, ttlMs = RECENT_EDIT_TTL_MS, className, }) {
-    const [highlights, setHighlights] = useState([]);
-    const editsRef = useRef(edits);
-    editsRef.current = edits;
-    const resolveRef = useRef(resolveRect);
-    resolveRef.current = resolveRect;
-    const recompute = () => {
-        const container = containerRef.current;
-        if (!container) {
-            setHighlights([]);
-            return;
-        }
-        const containerRect = container.getBoundingClientRect();
-        const now = Date.now();
-        const next = [];
-        for (const edit of editsRef.current) {
-            const domRect = resolveRef.current(edit);
-            if (!domRect)
-                continue;
-            const top = domRect.top - containerRect.top;
-            const left = domRect.left - containerRect.left;
-            if (left + domRect.width < 0 ||
-                top + domRect.height < 0 ||
-                left > containerRect.width ||
-                top > containerRect.height) {
-                continue;
-            }
-            // Fade over the final 40% of the lifetime.
-            const age = now - edit.at;
-            const fadeStart = ttlMs * 0.6;
-            const opacity = age <= fadeStart
-                ? 1
-                : Math.max(0, 1 - (age - fadeStart) / (ttlMs - fadeStart));
-            next.push({
-                key: `${edit.clientId}:${edit.at}`,
-                color: edit.user.color || "#94a3b8",
-                label: edit.isAgent
-                    ? edit.label
-                        ? `AI — ${edit.label}`
-                        : "AI edited"
-                    : edit.label
-                        ? `${edit.user.name} — ${edit.label}`
-                        : edit.user.name,
-                avatarUrl: edit.user.avatarUrl,
-                isAgent: edit.isAgent,
-                opacity,
-                rect: { top, left, width: domRect.width, height: domRect.height },
-            });
-        }
-        setHighlights(next);
-    };
-    useLayoutEffect(() => {
-        recompute();
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [edits, ttlMs]);
-    useEffect(() => {
-        const container = containerRef.current;
-        if (!container)
-            return;
-        const observer = new ResizeObserver(() => recompute());
-        observer.observe(container);
-        container.addEventListener("scroll", recompute, { passive: true });
-        window.addEventListener("scroll", recompute, { passive: true });
-        return () => {
-            observer.disconnect();
-            container.removeEventListener("scroll", recompute);
-            window.removeEventListener("scroll", recompute);
-        };
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [containerRef]);
-    return (_jsx("div", { "aria-hidden": true, style: {
-            position: "absolute",
-            inset: 0,
-            pointerEvents: "none",
-            overflow: "hidden",
-        }, className: className, children: highlights.map((h) => (_jsx(HighlightItem, { h: h }, h.key))) }));
-}
+export { RecentEditHighlights, } from "@agent-native/toolkit/collab-ui";
 //# sourceMappingURL=RecentEditHighlights.js.map

package/dist/client/components/RecentEditHighlights.js.map

@@ -1 +1 @@
-{"version":3,"file":"RecentEditHighlights.js","sourceRoot":"","sources":["../../../src/client/components/RecentEditHighlights.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * RecentEditHighlights — lingering, fading highlights over regions another\n * participant (human or agent) just edited, with their name/avatar flag.\n *\n * The Google-Docs/Figma feel: when a collaborator or the AI edits something,\n * the changed region glows in their color and the flag identifies them; the\n * highlight fades out over the last portion of its lifetime instead of\n * vanishing.\n *\n * Feed it `useRecentEdits(others)` (which reads participants' `recentEdits`\n * awareness rings) and a `resolveRect` that maps an edit descriptor to a\n * viewport DOMRect for your surface:\n *\n *   const others = usePresence(awareness, ydoc?.clientID).others;\n *   const edits = useRecentEdits(others);\n *   <RecentEditHighlights\n *     edits={edits}\n *     resolveRect={(edit) =>\n *       edit.descriptor.kind === \"selector\"\n *         ? container.querySelector(edit.descriptor.selector)?.getBoundingClientRect() ?? null\n *         : null\n *     }\n *     containerRef={containerRef}\n *   />\n */\n\nimport { memo, useEffect, useLayoutEffect, useRef, useState } from \"react\";\n\nimport type { AttributedRecentEdit } from \"../../collab/recent-edits.js\";\nimport { RECENT_EDIT_TTL_MS } from \"../../collab/recent-edits.js\";\n\nexport interface RecentEditHighlightsProps {\n  /** Attributed recent edits (from `useRecentEdits`). */\n  edits: AttributedRecentEdit[];\n  /**\n   * Resolver: maps an edit to a viewport-relative DOMRect, or null when the\n   * region can't be located (the edit is skipped).\n   */\n  resolveRect: (edit: AttributedRecentEdit) => DOMRect | null;\n  /** Container the highlights are positioned within (position: relative). */\n  containerRef: React.RefObject<HTMLElement | null>;\n  /** Highlight lifetime; should match useRecentEdits ttlMs. Default 6000. */\n  ttlMs?: number;\n  /** Additional CSS class for the overlay div. */\n  className?: string;\n}\n\ninterface Highlight {\n  key: string;\n  color: string;\n  label: string;\n  avatarUrl?: string;\n  isAgent: boolean;\n  opacity: number;\n  rect: { top: number; left: number; width: number; height: number };\n}\n\nconst HighlightItem = memo(function HighlightItem({ h }: { h: Highlight }) {\n  return (\n    <div\n      aria-label={`${h.label} edited this`}\n      style={{\n        position: \"absolute\",\n        top: h.rect.top,\n        left: h.rect.left,\n        width: h.rect.width,\n        height: h.rect.height,\n        borderRadius: 4,\n        pointerEvents: \"none\",\n        zIndex: 9997,\n        opacity: h.opacity,\n        transition: \"opacity 400ms ease-out\",\n        outline: `2px solid ${h.color}`,\n        outlineOffset: 2,\n        backgroundColor: `${h.color}1A`,\n        boxShadow: `0 0 0 1px ${h.color}33, 0 0 12px ${h.color}40`,\n      }}\n    >\n      <div\n        style={{\n          position: \"absolute\",\n          top: -22,\n          left: 0,\n          display: \"flex\",\n          alignItems: \"center\",\n          gap: 4,\n          backgroundColor: h.color,\n          color: \"#fff\",\n          fontSize: 10,\n          fontWeight: 600,\n          padding: \"2px 6px\",\n          borderRadius: 3,\n          whiteSpace: \"nowrap\",\n          maxWidth: 180,\n          overflow: \"hidden\",\n          textOverflow: \"ellipsis\",\n        }}\n      >\n        {h.avatarUrl ? (\n          <img\n            src={h.avatarUrl}\n            alt=\"\"\n            style={{\n              width: 12,\n              height: 12,\n              borderRadius: \"50%\",\n              flexShrink: 0,\n            }}\n          />\n        ) : null}\n        {h.label}\n      </div>\n    </div>\n  );\n});\n\nexport function RecentEditHighlights({\n  edits,\n  resolveRect,\n  containerRef,\n  ttlMs = RECENT_EDIT_TTL_MS,\n  className,\n}: RecentEditHighlightsProps) {\n  const [highlights, setHighlights] = useState<Highlight[]>([]);\n  const editsRef = useRef(edits);\n  editsRef.current = edits;\n  const resolveRef = useRef(resolveRect);\n  resolveRef.current = resolveRect;\n\n  const recompute = () => {\n    const container = containerRef.current;\n    if (!container) {\n      setHighlights([]);\n      return;\n    }\n    const containerRect = container.getBoundingClientRect();\n    const now = Date.now();\n    const next: Highlight[] = [];\n\n    for (const edit of editsRef.current) {\n      const domRect = resolveRef.current(edit);\n      if (!domRect) continue;\n\n      const top = domRect.top - containerRect.top;\n      const left = domRect.left - containerRect.left;\n      if (\n        left + domRect.width < 0 ||\n        top + domRect.height < 0 ||\n        left > containerRect.width ||\n        top > containerRect.height\n      ) {\n        continue;\n      }\n\n      // Fade over the final 40% of the lifetime.\n      const age = now - edit.at;\n      const fadeStart = ttlMs * 0.6;\n      const opacity =\n        age <= fadeStart\n          ? 1\n          : Math.max(0, 1 - (age - fadeStart) / (ttlMs - fadeStart));\n\n      next.push({\n        key: `${edit.clientId}:${edit.at}`,\n        color: edit.user.color || \"#94a3b8\",\n        label: edit.isAgent\n          ? edit.label\n            ? `AI — ${edit.label}`\n            : \"AI edited\"\n          : edit.label\n            ? `${edit.user.name} — ${edit.label}`\n            : edit.user.name,\n        avatarUrl: (edit.user as { avatarUrl?: string }).avatarUrl,\n        isAgent: edit.isAgent,\n        opacity,\n        rect: { top, left, width: domRect.width, height: domRect.height },\n      });\n    }\n\n    setHighlights(next);\n  };\n\n  useLayoutEffect(() => {\n    recompute();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [edits, ttlMs]);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const observer = new ResizeObserver(() => recompute());\n    observer.observe(container);\n    container.addEventListener(\"scroll\", recompute, { passive: true });\n    window.addEventListener(\"scroll\", recompute, { passive: true });\n    return () => {\n      observer.disconnect();\n      container.removeEventListener(\"scroll\", recompute);\n      window.removeEventListener(\"scroll\", recompute);\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [containerRef]);\n\n  return (\n    <div\n      aria-hidden\n      style={{\n        position: \"absolute\",\n        inset: 0,\n        pointerEvents: \"none\",\n        overflow: \"hidden\",\n      }}\n      className={className}\n    >\n      {highlights.map((h) => (\n        <HighlightItem key={h.key} h={h} />\n      ))}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"RecentEditHighlights.js","sourceRoot":"","sources":["../../../src/client/components/RecentEditHighlights.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAErB,MAAM,iCAAiC,CAAC","sourcesContent":["export {\n  RecentEditHighlights,\n  type RecentEditHighlightsProps,\n} from \"@agent-native/toolkit/collab-ui\";\n"]}

package/dist/client/components/RemoteSelectionRings.d.ts

@@ -1,52 +1,2 @@
-/**
- * RemoteSelectionRings — renders colored outline rings + name tags over
- * elements selected by remote participants.
- *
- * Each participant's presence payload may contain a `selection` key with an
- * opaque descriptor (e.g. a CSS selector). The `resolveRect` callback maps
- * a descriptor to a DOMRect (or null when the element isn't found). Rings
- * are rendered as absolutely-positioned outlines anchored to the container.
- *
- * Usage:
- *   <div style={{ position: "relative" }}>
- *     {content}
- *     <RemoteSelectionRings
- *       others={others}
- *       resolveRect={(selector) => document.querySelector(selector)?.getBoundingClientRect() ?? null}
- *       containerRef={containerRef}
- *     />
- *   </div>
- */
-import type { OtherPresence } from "../../collab/presence.js";
-/**
- * Selection descriptors may be a plain string (treated as the resolver
- * input) or an object carrying a resolver input plus a human label
- * ("Editing hero section").
- */
-export type SelectionDescriptor = string | {
-    selector: string;
-    label?: string;
-};
-export interface RemoteSelectionRingsProps {
-    /** Remote participants. */
-    others: OtherPresence[];
-    /**
-     * Key inside presence payload that carries the selection descriptor.
-     * Default: "selection"
-     */
-    selectionKey?: string;
-    /**
-     * Resolver: maps a selection descriptor to a DOMRect relative to the
-     * viewport. Return null when the element is not found.
-     */
-    resolveRect: (descriptor: string) => DOMRect | null;
-    /**
-     * Container element ref. Rings are positioned relative to this element's
-     * bounding box.
-     */
-    containerRef: React.RefObject<HTMLElement | null>;
-    /** Additional CSS class for the overlay div. */
-    className?: string;
-}
-export declare function RemoteSelectionRings({ others, selectionKey, resolveRect, containerRef, className, }: RemoteSelectionRingsProps): import("react").JSX.Element;
+export { RemoteSelectionRings, type RemoteSelectionRingsProps, type SelectionDescriptor, } from "@agent-native/toolkit/collab-ui";
 //# sourceMappingURL=RemoteSelectionRings.d.ts.map

package/dist/client/components/RemoteSelectionRings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteSelectionRings.d.ts","sourceRoot":"","sources":["../../../src/client/components/RemoteSelectionRings.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,MAAM,WAAW,yBAAyB;IACxC,2BAA2B;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IACpD;;;OAGG;IACH,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAClD,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoED,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,YAA0B,EAC1B,WAAW,EACX,YAAY,EACZ,SAAS,GACV,EAAE,yBAAyB,+BA8F3B"}
+{"version":3,"file":"RemoteSelectionRings.d.ts","sourceRoot":"","sources":["../../../src/client/components/RemoteSelectionRings.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,GACzB,MAAM,iCAAiC,CAAC"}

package/dist/client/components/RemoteSelectionRings.js

@@ -1,130 +1,2 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * RemoteSelectionRings — renders colored outline rings + name tags over
- * elements selected by remote participants.
- *
- * Each participant's presence payload may contain a `selection` key with an
- * opaque descriptor (e.g. a CSS selector). The `resolveRect` callback maps
- * a descriptor to a DOMRect (or null when the element isn't found). Rings
- * are rendered as absolutely-positioned outlines anchored to the container.
- *
- * Usage:
- *   <div style={{ position: "relative" }}>
- *     {content}
- *     <RemoteSelectionRings
- *       others={others}
- *       resolveRect={(selector) => document.querySelector(selector)?.getBoundingClientRect() ?? null}
- *       containerRef={containerRef}
- *     />
- *   </div>
- */
-import { useState, useEffect, useRef, useLayoutEffect, memo } from "react";
-const RingItem = memo(function RingItem({ ring }) {
-    return (_jsx("div", { "aria-label": `${ring.label} selection`, style: {
-            position: "absolute",
-            top: ring.rect.top,
-            left: ring.rect.left,
-            width: ring.rect.width,
-            height: ring.rect.height,
-            outline: `2px solid ${ring.color}`,
-            outlineOffset: 2,
-            borderRadius: 3,
-            pointerEvents: "none",
-            boxShadow: `0 0 0 1px ${ring.color}40`,
-            zIndex: 9998,
-        }, children: _jsxs("div", { style: {
-                position: "absolute",
-                top: -20,
-                left: 0,
-                display: "flex",
-                alignItems: "center",
-                gap: 4,
-                backgroundColor: ring.color,
-                color: "#fff",
-                fontSize: 10,
-                fontWeight: 600,
-                padding: "1px 5px",
-                borderRadius: 3,
-                whiteSpace: "nowrap",
-                maxWidth: 160,
-                overflow: "hidden",
-                textOverflow: "ellipsis",
-            }, children: [ring.avatarUrl ? (_jsx("img", { src: ring.avatarUrl, alt: "", style: {
-                        width: 12,
-                        height: 12,
-                        borderRadius: "50%",
-                        flexShrink: 0,
-                    } })) : null, ring.label] }) }));
-});
-export function RemoteSelectionRings({ others, selectionKey = "selection", resolveRect, containerRef, className, }) {
-    const overlayRef = useRef(null);
-    const [rings, setRings] = useState([]);
-    // Recompute rings whenever others change or on animation frame.
-    const recompute = () => {
-        const container = containerRef.current;
-        if (!container) {
-            setRings([]);
-            return;
-        }
-        const containerRect = container.getBoundingClientRect();
-        const next = [];
-        for (const other of others) {
-            const raw = other.presence[selectionKey];
-            const selector = typeof raw === "string" ? raw : raw ? raw.selector : undefined;
-            if (!selector || typeof selector !== "string")
-                continue;
-            const selectionLabel = raw && typeof raw === "object" ? raw.label : undefined;
-            const domRect = resolveRect(selector);
-            if (!domRect)
-                continue;
-            // Convert viewport-relative rect to container-relative.
-            const top = domRect.top - containerRect.top;
-            const left = domRect.left - containerRect.left;
-            if (left + domRect.width < 0 ||
-                top + domRect.height < 0 ||
-                left > containerRect.width ||
-                top > containerRect.height) {
-                continue; // Out of container bounds — skip.
-            }
-            const baseName = other.isAgent
-                ? "AI"
-                : other.user.name || other.user.email;
-            next.push({
-                clientId: other.clientId,
-                color: other.user.color || "#94a3b8",
-                label: selectionLabel ? `${baseName} — ${selectionLabel}` : baseName,
-                avatarUrl: other.user.avatarUrl,
-                isAgent: other.isAgent,
-                rect: { top, left, width: domRect.width, height: domRect.height },
-            });
-        }
-        setRings(next);
-    };
-    // Recompute on scroll/resize of the container to keep rings in sync.
-    useLayoutEffect(() => {
-        recompute();
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [others, selectionKey]);
-    useEffect(() => {
-        const container = containerRef.current;
-        if (!container)
-            return;
-        const observer = new ResizeObserver(() => recompute());
-        observer.observe(container);
-        container.addEventListener("scroll", recompute, { passive: true });
-        window.addEventListener("scroll", recompute, { passive: true });
-        return () => {
-            observer.disconnect();
-            container.removeEventListener("scroll", recompute);
-            window.removeEventListener("scroll", recompute);
-        };
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [containerRef]);
-    return (_jsx("div", { ref: overlayRef, "aria-hidden": true, style: {
-            position: "absolute",
-            inset: 0,
-            pointerEvents: "none",
-            overflow: "hidden",
-        }, className: className, children: rings.map((ring) => (_jsx(RingItem, { ring: ring }, ring.clientId))) }));
-}
+export { RemoteSelectionRings, } from "@agent-native/toolkit/collab-ui";
 //# sourceMappingURL=RemoteSelectionRings.js.map

package/dist/client/components/RemoteSelectionRings.js.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteSelectionRings.js","sourceRoot":"","sources":["../../../src/client/components/RemoteSelectionRings.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * RemoteSelectionRings — renders colored outline rings + name tags over\n * elements selected by remote participants.\n *\n * Each participant's presence payload may contain a `selection` key with an\n * opaque descriptor (e.g. a CSS selector). The `resolveRect` callback maps\n * a descriptor to a DOMRect (or null when the element isn't found). Rings\n * are rendered as absolutely-positioned outlines anchored to the container.\n *\n * Usage:\n *   <div style={{ position: \"relative\" }}>\n *     {content}\n *     <RemoteSelectionRings\n *       others={others}\n *       resolveRect={(selector) => document.querySelector(selector)?.getBoundingClientRect() ?? null}\n *       containerRef={containerRef}\n *     />\n *   </div>\n */\n\nimport { useState, useEffect, useRef, useLayoutEffect, memo } from \"react\";\n\nimport type { OtherPresence } from \"../../collab/presence.js\";\n\n/**\n * Selection descriptors may be a plain string (treated as the resolver\n * input) or an object carrying a resolver input plus a human label\n * (\"Editing hero section\").\n */\nexport type SelectionDescriptor = string | { selector: string; label?: string };\n\nexport interface RemoteSelectionRingsProps {\n  /** Remote participants. */\n  others: OtherPresence[];\n  /**\n   * Key inside presence payload that carries the selection descriptor.\n   * Default: \"selection\"\n   */\n  selectionKey?: string;\n  /**\n   * Resolver: maps a selection descriptor to a DOMRect relative to the\n   * viewport. Return null when the element is not found.\n   */\n  resolveRect: (descriptor: string) => DOMRect | null;\n  /**\n   * Container element ref. Rings are positioned relative to this element's\n   * bounding box.\n   */\n  containerRef: React.RefObject<HTMLElement | null>;\n  /** Additional CSS class for the overlay div. */\n  className?: string;\n}\n\ninterface Ring {\n  clientId: number;\n  color: string;\n  label: string;\n  avatarUrl?: string;\n  isAgent: boolean;\n  rect: { top: number; left: number; width: number; height: number };\n}\n\nconst RingItem = memo(function RingItem({ ring }: { ring: Ring }) {\n  return (\n    <div\n      aria-label={`${ring.label} selection`}\n      style={{\n        position: \"absolute\",\n        top: ring.rect.top,\n        left: ring.rect.left,\n        width: ring.rect.width,\n        height: ring.rect.height,\n        outline: `2px solid ${ring.color}`,\n        outlineOffset: 2,\n        borderRadius: 3,\n        pointerEvents: \"none\",\n        boxShadow: `0 0 0 1px ${ring.color}40`,\n        zIndex: 9998,\n      }}\n    >\n      {/* Name tag in top-left corner of the ring */}\n      <div\n        style={{\n          position: \"absolute\",\n          top: -20,\n          left: 0,\n          display: \"flex\",\n          alignItems: \"center\",\n          gap: 4,\n          backgroundColor: ring.color,\n          color: \"#fff\",\n          fontSize: 10,\n          fontWeight: 600,\n          padding: \"1px 5px\",\n          borderRadius: 3,\n          whiteSpace: \"nowrap\",\n          maxWidth: 160,\n          overflow: \"hidden\",\n          textOverflow: \"ellipsis\",\n        }}\n      >\n        {ring.avatarUrl ? (\n          <img\n            src={ring.avatarUrl}\n            alt=\"\"\n            style={{\n              width: 12,\n              height: 12,\n              borderRadius: \"50%\",\n              flexShrink: 0,\n            }}\n          />\n        ) : null}\n        {ring.label}\n      </div>\n    </div>\n  );\n});\n\nexport function RemoteSelectionRings({\n  others,\n  selectionKey = \"selection\",\n  resolveRect,\n  containerRef,\n  className,\n}: RemoteSelectionRingsProps) {\n  const overlayRef = useRef<HTMLDivElement>(null);\n  const [rings, setRings] = useState<Ring[]>([]);\n\n  // Recompute rings whenever others change or on animation frame.\n  const recompute = () => {\n    const container = containerRef.current;\n    if (!container) {\n      setRings([]);\n      return;\n    }\n    const containerRect = container.getBoundingClientRect();\n    const next: Ring[] = [];\n\n    for (const other of others) {\n      const raw = other.presence[selectionKey] as\n        | SelectionDescriptor\n        | null\n        | undefined;\n      const selector =\n        typeof raw === \"string\" ? raw : raw ? raw.selector : undefined;\n      if (!selector || typeof selector !== \"string\") continue;\n      const selectionLabel =\n        raw && typeof raw === \"object\" ? raw.label : undefined;\n\n      const domRect = resolveRect(selector);\n      if (!domRect) continue;\n\n      // Convert viewport-relative rect to container-relative.\n      const top = domRect.top - containerRect.top;\n      const left = domRect.left - containerRect.left;\n      if (\n        left + domRect.width < 0 ||\n        top + domRect.height < 0 ||\n        left > containerRect.width ||\n        top > containerRect.height\n      ) {\n        continue; // Out of container bounds — skip.\n      }\n\n      const baseName = other.isAgent\n        ? \"AI\"\n        : other.user.name || other.user.email;\n      next.push({\n        clientId: other.clientId,\n        color: other.user.color || \"#94a3b8\",\n        label: selectionLabel ? `${baseName} — ${selectionLabel}` : baseName,\n        avatarUrl: (other.user as { avatarUrl?: string }).avatarUrl,\n        isAgent: other.isAgent,\n        rect: { top, left, width: domRect.width, height: domRect.height },\n      });\n    }\n\n    setRings(next);\n  };\n\n  // Recompute on scroll/resize of the container to keep rings in sync.\n  useLayoutEffect(() => {\n    recompute();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [others, selectionKey]);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    const observer = new ResizeObserver(() => recompute());\n    observer.observe(container);\n    container.addEventListener(\"scroll\", recompute, { passive: true });\n    window.addEventListener(\"scroll\", recompute, { passive: true });\n    return () => {\n      observer.disconnect();\n      container.removeEventListener(\"scroll\", recompute);\n      window.removeEventListener(\"scroll\", recompute);\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [containerRef]);\n\n  return (\n    <div\n      ref={overlayRef}\n      aria-hidden\n      style={{\n        position: \"absolute\",\n        inset: 0,\n        pointerEvents: \"none\",\n        overflow: \"hidden\",\n      }}\n      className={className}\n    >\n      {rings.map((ring) => (\n        <RingItem key={ring.clientId} ring={ring} />\n      ))}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"RemoteSelectionRings.js","sourceRoot":"","sources":["../../../src/client/components/RemoteSelectionRings.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAGrB,MAAM,iCAAiC,CAAC","sourcesContent":["export {\n  RemoteSelectionRings,\n  type RemoteSelectionRingsProps,\n  type SelectionDescriptor,\n} from \"@agent-native/toolkit/collab-ui\";\n"]}

package/dist/client/composer/TiptapComposer.d.ts

@@ -21,6 +21,10 @@ export declare function canSubmitComposerContent(options: {
 export declare function getOversizedDocumentAttachmentError(attachments: ReadonlyArray<unknown>): string | null;
 export declare function getComposerSubmitIntentForEnterKey(event: Pick<KeyboardEvent, "key" | "shiftKey" | "metaKey" | "ctrlKey">, isMac: boolean): ComposerSubmitIntent | null;
 export declare function insertComposerHardBreakAndScrollIntoView(view: Pick<EditorView, "state" | "dispatch">): boolean;
+export declare function getComposerPopoverPosition(view: Pick<EditorView, "coordsAtPos">, pos: number): {
+    top: number;
+    left: number;
+} | null;
 export declare function displayableComposerModeMessage(options: {
     messagePrefix: string;
     trimmedText: string;

package/dist/client/composer/TiptapComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TiptapComposer.d.ts","sourceRoot":"","sources":["../../../src/client/composer/TiptapComposer.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"TiptapComposer.d.ts","sourceRoot":"","sources":["../../../src/client/composer/TiptapComposer.tsx"],"names":[],"mappings":"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"}

package/dist/client/composer/TiptapComposer.js

@@ -170,6 +170,18 @@ export function insertComposerHardBreakAndScrollIntoView(view) {
     view.dispatch(view.state.tr.replaceSelectionWith(hardBreak.create()).scrollIntoView());
     return true;
 }
+export function getComposerPopoverPosition(view, pos) {
+    try {
+        const coords = view.coordsAtPos(pos);
+        if (!Number.isFinite(coords.top) || !Number.isFinite(coords.left)) {
+            return null;
+        }
+        return { top: coords.top, left: coords.left };
+    }
+    catch {
+        return null;
+    }
+}
 export function displayableComposerModeMessage(options) {
     const modePrompt = options.trimmedText ||
         (options.attachmentCount > 0 ? "Use the attached context." : "");
@@ -308,9 +320,9 @@ Use the create-extension action with Alpine.js HTML content. The extension runs
 
 After creating the extension, navigate the user to it with the path returned by create-extension; extension URLs may include a friendly "/extensions/<id>/<slug>" suffix.
 
-Make the extension functional and visually polished. Extensions can use extensionFetch() for external API calls, appAction()/appFetch() for app operations, extensionData for per-extension persistence, and dbQuery()/dbExec() only for existing app tables.
+Make the extension functional and visually polished. Extensions can use extensionFetch() for external API calls, appAction()/appFetch() for app operations and app data writes, extensionData for per-extension persistence, and dbQuery() only for read-only inspection of existing app tables.
 
-Prefer appAction()/appFetch() for app data. Some actions return JSON strings for CLI compatibility, so parse string results before counting rows or reading arrays. Do not guess raw SQL table names or columns for app data; use dbQuery()/dbExec() only when the table is known to exist in the current schema.`,
+Prefer appAction()/appFetch() for app data. Some actions return JSON strings for CLI compatibility, so parse string results before counting rows or reading arrays. Do not guess raw SQL table names or columns for app data; use dbQuery() only when the table is known to exist in the current schema.`,
     },
 };
 function ComposerModeChip({ mode, onRemove, }) {
@@ -591,6 +603,7 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
     const [popover, setPopover] = useState(null);
     const popoverRef = useRef(null);
     const composerRuntime = useComposerRuntime();
+    const lastComposerRuntimeSyncRef = useRef(null);
     const submitInFlightRef = useRef(false);
     const [editorHasText, setEditorHasText] = useState(false);
     const [slotReferences, setSlotReferences] = useState([]);
@@ -670,6 +683,9 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
             clearTimeout(draftTimerRef.current);
         };
     }, []);
+    useEffect(() => {
+        lastComposerRuntimeSyncRef.current = null;
+    }, [composerRuntime]);
     // Tiptap reads extension config once at init; ref keeps runtime prop
     // changes visible to Placeholder's function form.
     const placeholderRef = useRef(placeholder);
@@ -887,11 +903,13 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
                     const { from } = view.state.selection;
                     const textBefore = view.state.doc.textBetween(Math.max(0, from - 1), from);
                     if (from === 1 || textBefore === "" || /\s/.test(textBefore)) {
-                        const coords = view.coordsAtPos(from);
+                        const position = getComposerPopoverPosition(view, from);
+                        if (!position)
+                            return false;
                         setTimeout(() => {
                             const state = {
                                 type: "@",
-                                position: { top: coords.top, left: coords.left },
+                                position,
                                 startPos: view.state.selection.from,
                                 query: "",
                             };
@@ -906,11 +924,13 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
                     const { from } = view.state.selection;
                     const textBefore = view.state.doc.textBetween(Math.max(0, from - 1), from);
                     if (from === 1 || textBefore === "" || /\s/.test(textBefore)) {
-                        const coords = view.coordsAtPos(from);
+                        const position = getComposerPopoverPosition(view, from);
+                        if (!position)
+                            return false;
                         setTimeout(() => {
                             const state = {
                                 type: "/",
-                                position: { top: coords.top, left: coords.left },
+                                position,
                                 startPos: view.state.selection.from,
                                 query: "",
                             };
@@ -1267,8 +1287,7 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
         });
         return { text, references };
     }, [editor, slotReferences]);
-    const syncComposerState = useCallback(() => {
-        const { text, references } = extractComposerPayload();
+    const syncComposerRuntimeState = useCallback((text, references) => {
         const requestMode = execMode === "plan" ? "plan" : execMode === "build" ? "act" : undefined;
         const custom = {};
         if (references.length > 0) {
@@ -1277,10 +1296,46 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
         if (requestMode) {
             custom.requestMode = requestMode;
         }
+        const runConfig = Object.keys(custom).length > 0 ? { custom } : {};
+        const runConfigSignature = JSON.stringify(runConfig);
+        const last = lastComposerRuntimeSyncRef.current;
+        if (last?.text === text &&
+            last.runConfigSignature === runConfigSignature) {
+            return;
+        }
         composerRuntime.setText(text);
-        composerRuntime.setRunConfig(Object.keys(custom).length > 0 ? { custom } : {});
+        composerRuntime.setRunConfig(runConfig);
+        lastComposerRuntimeSyncRef.current = { text, runConfigSignature };
+    }, [composerRuntime, execMode]);
+    const resetComposerRuntimeState = useCallback(() => {
+        const runConfigSignature = "{}";
+        const last = lastComposerRuntimeSyncRef.current;
+        if (last?.text === "" && last.runConfigSignature === runConfigSignature) {
+            return;
+        }
+        composerRuntime.setText("");
+        composerRuntime.setRunConfig({});
+        lastComposerRuntimeSyncRef.current = { text: "", runConfigSignature };
+    }, [composerRuntime]);
+    const syncComposerState = useCallback(() => {
+        const { text, references } = extractComposerPayload();
+        syncComposerRuntimeState(text, references);
         return { text, references };
-    }, [composerRuntime, execMode, extractComposerPayload]);
+    }, [extractComposerPayload, syncComposerRuntimeState]);
+    const clearEditorAfterSubmit = useCallback(() => {
+        const ed = editor;
+        if (!ed)
+            return;
+        ed.commands.clearContent();
+        setEditorHasText(false);
+        setSlotReferences([]);
+        resetComposerRuntimeState();
+        try {
+            localStorage.removeItem(draftKey);
+        }
+        catch { }
+        closePopover();
+    }, [closePopover, draftKey, editor, resetComposerRuntimeState]);
     const submitComposer = useCallback(async (intent = "immediate") => {
         const ed = editor;
         if (!ed)
@@ -1309,12 +1364,7 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
             const cmdName = normalizeSlashCommandName(trimmed);
             const matched = allSlashCommands.find((c) => c.name === cmdName);
             if (matched) {
-                ed.commands.clearContent();
-                try {
-                    localStorage.removeItem(draftKey);
-                }
-                catch { }
-                closePopover();
+                clearEditorAfterSubmit();
                 onSlashCommandRef.current?.(matched.name);
                 return;
             }
@@ -1329,14 +1379,7 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
             interceptBuildRequestsForBuilder &&
             tryDelegateBuildRequestToBuilder(trimmed)) {
             cancelActiveVoice();
-            ed.commands.clearContent();
-            setEditorHasText(false);
-            setSlotReferences([]);
-            try {
-                localStorage.removeItem(draftKey);
-            }
-            catch { }
-            closePopover();
+            clearEditorAfterSubmit();
             return;
         }
         if (onBeforeSubmit) {
@@ -1398,6 +1441,9 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
                 closePopover();
                 return;
             }
+            cancelActiveVoice();
+            clearEditorAfterSubmit();
+            return;
         }
         else {
             composerRuntime.send();
@@ -1413,6 +1459,7 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
         closePopover();
     }, [
         closePopover,
+        clearEditorAfterSubmit,
         composerMode,
         composerRuntime,
         draftKey,
@@ -1517,7 +1564,6 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
         if (!editor || !popover)
             return;
         const updateHandler = () => {
-            syncComposerState();
             const pop = popoverStateRef.current;
             if (!pop)
                 return;
@@ -1537,6 +1583,8 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
                     return;
                 }
             }
+            if (pop.query === text)
+                return;
             const updated = { ...pop, query: text };
             popoverStateRef.current = updated;
             setPopover(updated);
@@ -1547,7 +1595,7 @@ export function TiptapComposer({ placeholder = "Message agent...", disabled = fa
             editor.off("update", updateHandler);
             editor.off("selectionUpdate", updateHandler);
         };
-    }, [editor, popover, closePopover, syncComposerState]);
+    }, [editor, popover, closePopover]);
     useEffect(() => {
         if (!editor)
             return;