@agent-native/toolkit 0.0.0-beta-20260819143124

package/dist/collab-ui/LiveCursorOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveCursorOverlay.js","sourceRoot":"","sources":["../../src/collab-ui/LiveCursorOverlay.tsx"],"names":[],"mappings":"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"}

package/dist/collab-ui/PresenceBar.d.ts

@@ -0,0 +1,30 @@
+import { type CollabUser } from "./types.js";
+export interface PresenceBarProps {
+    /** Active collaborators on this document. */
+    activeUsers: CollabUser[];
+    /** Whether the agent has a durable presence entry. */
+    agentPresent?: boolean;
+    /** Whether the agent is actively making edits right now. */
+    agentActive?: boolean;
+    /** Whether to show the status dot beside the active agent label. When false,
+     *  the label is integrated with the avatar pill. */
+    showAgentEditingDot?: boolean;
+    /** Current user's email (to exclude from the list). */
+    currentUserEmail?: string;
+    /** Max visible avatars before "+N" overflow. Default: 5 */
+    maxVisible?: number;
+    /** Additional CSS classes. */
+    className?: string;
+    /**
+     * Called when an avatar is clicked. Receives the user being clicked
+     * (or null for the agent avatar). Use this to start/stop follow mode.
+     */
+    onAvatarClick?: (user: CollabUser | null) => void;
+    /**
+     * The email of the user currently being followed. Highlighted with a
+     * blue ring to indicate active follow mode.
+     */
+    followingEmail?: string | null;
+}
+export declare function PresenceBar({ activeUsers, agentPresent, agentActive, showAgentEditingDot, currentUserEmail, maxVisible, className, onAvatarClick, followingEmail, }: PresenceBarProps): import("react").JSX.Element | null;
+//# sourceMappingURL=PresenceBar.d.ts.map

package/dist/collab-ui/PresenceBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceBar.d.ts","sourceRoot":"","sources":["../../src/collab-ui/PresenceBar.tsx"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;wDACoD;IACpD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAiQD,wBAAgB,WAAW,CAAC,EAC1B,WAAW,EACX,YAAY,EACZ,WAAW,EACX,mBAA0B,EAC1B,gBAAgB,EAChB,UAAc,EACd,SAAS,EACT,aAAa,EACb,cAAc,GACf,EAAE,gBAAgB,sCAgElB"}

package/dist/collab-ui/PresenceBar.js

@@ -0,0 +1,172 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "../ui/tooltip.js";
+import { dedupeCollabUsersByEmail, emailToColor, emailToName, } from "./types.js";
+const AVATAR_SIZE = 28;
+const OVERLAP = -8;
+const BORDER_WIDTH = 2;
+const FONT_SIZE = 12;
+const AGENT_COLOR = "#00B5FF";
+const baseAvatarStyle = {
+    width: AVATAR_SIZE,
+    height: AVATAR_SIZE,
+    borderRadius: "50%",
+    display: "flex",
+    alignItems: "center",
+    justifyContent: "center",
+    fontSize: FONT_SIZE,
+    fontWeight: 700,
+    color: "#fff",
+    border: `${BORDER_WIDTH}px solid #fff`,
+    flexShrink: 0,
+    position: "relative",
+    cursor: "default",
+    boxSizing: "border-box",
+};
+const containerStyle = {
+    display: "flex",
+    alignItems: "center",
+    flexDirection: "row",
+};
+const pulseKeyframes = `
+@keyframes _anPresencePulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.6; }
+}
+`;
+let styleInjected = false;
+function injectStyles() {
+    if (styleInjected || typeof document === "undefined")
+        return;
+    const style = document.createElement("style");
+    style.textContent = pulseKeyframes;
+    document.head.appendChild(style);
+    styleInjected = true;
+}
+function UserAvatar({ user, isFirst, onClick, isFollowing, }) {
+    const color = user.color || emailToColor(user.email);
+    const name = user.name || emailToName(user.email);
+    const initial = name.charAt(0).toUpperCase();
+    return (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("div", { style: {
+                        ...baseAvatarStyle,
+                        backgroundColor: color,
+                        marginLeft: isFirst ? 0 : OVERLAP,
+                        cursor: onClick ? "pointer" : "default",
+                        boxShadow: isFollowing
+                            ? `0 0 0 2px #3b82f6, 0 0 0 4px #fff`
+                            : `0 0 0 2px #fff`,
+                    }, "aria-label": `${name} (${user.email})${isFollowing ? " — following" : ""}`, tabIndex: onClick ? 0 : undefined, role: onClick ? "button" : undefined, onClick: onClick, onKeyDown: (e) => {
+                        if (e.key === "Enter" || e.key === " ")
+                            onClick?.();
+                    }, children: user.avatarUrl ? (_jsx("img", { src: user.avatarUrl, alt: "", style: {
+                            width: "100%",
+                            height: "100%",
+                            borderRadius: "50%",
+                            objectFit: "cover",
+                        } })) : (initial) }) }), _jsx(TooltipContent, { side: "bottom", children: isFollowing
+                    ? `Following ${name} — click to stop`
+                    : onClick
+                        ? `${name} — click to follow`
+                        : user.email })] }));
+}
+function AgentAvatar({ active, onClick, isFollowing, showAgentEditingDot, }) {
+    injectStyles();
+    const integratedEditingBadge = active && !isFollowing && !showAgentEditingDot;
+    return (_jsxs("div", { style: {
+            display: "flex",
+            alignItems: "center",
+            gap: 4,
+            ...(integratedEditingBadge && {
+                height: AVATAR_SIZE,
+                paddingRight: 8,
+                borderRadius: 9999,
+                backgroundColor: `${AGENT_COLOR}20`,
+            }),
+        }, children: [_jsx("div", { style: {
+                    ...baseAvatarStyle,
+                    backgroundColor: AGENT_COLOR,
+                    marginLeft: 0,
+                    animation: active ? "_anPresencePulse 2s infinite" : undefined,
+                    cursor: onClick ? "pointer" : "default",
+                    boxShadow: isFollowing
+                        ? `0 0 0 2px #3b82f6, 0 0 0 4px #fff`
+                        : undefined,
+                }, title: isFollowing
+                    ? "Following AI — click to stop"
+                    : active
+                        ? "AI is editing"
+                        : "AI agent", onClick: onClick, tabIndex: onClick ? 0 : undefined, onKeyDown: (e) => {
+                    if (e.key === "Enter" || e.key === " ")
+                        onClick?.();
+                }, role: onClick ? "button" : undefined, children: "A" }), active && !isFollowing && (_jsx(AgentEditingChip, { showDot: showAgentEditingDot, integrated: integratedEditingBadge })), isFollowing && (_jsx("span", { style: {
+                    display: "inline-flex",
+                    alignItems: "center",
+                    height: 20,
+                    padding: "0 8px",
+                    borderRadius: 9999,
+                    backgroundColor: `#3b82f620`,
+                    color: "#3b82f6",
+                    fontSize: 11,
+                    fontWeight: 600,
+                    whiteSpace: "nowrap",
+                }, children: "Following AI" }))] }));
+}
+function AgentEditingChip({ showDot, integrated, }) {
+    return (_jsxs("span", { style: {
+            display: "inline-flex",
+            alignItems: "center",
+            gap: showDot ? 4 : 0,
+            height: integrated ? "auto" : 20,
+            padding: integrated ? "0 0 0 2px" : "0 8px",
+            borderRadius: integrated ? 0 : 9999,
+            backgroundColor: integrated ? "transparent" : `${AGENT_COLOR}20`,
+            color: AGENT_COLOR,
+            fontSize: 11,
+            fontWeight: 600,
+            whiteSpace: "nowrap",
+        }, children: [showDot && (_jsx("span", { style: {
+                    width: 6,
+                    height: 6,
+                    borderRadius: "50%",
+                    backgroundColor: AGENT_COLOR,
+                    animation: "_anPresencePulse 2s infinite",
+                    flexShrink: 0,
+                } })), "AI editing"] }));
+}
+function OverflowBadge({ count, isFirst, }) {
+    return (_jsxs("div", { style: {
+            ...baseAvatarStyle,
+            backgroundColor: "rgba(255,255,255,0.1)",
+            color: "rgba(255,255,255,0.5)",
+            marginLeft: isFirst ? 0 : OVERLAP,
+            fontSize: 10,
+        }, title: `${count} more collaborator${count === 1 ? "" : "s"}`, children: ["+", count] }));
+}
+export function PresenceBar({ activeUsers, agentPresent, agentActive, showAgentEditingDot = true, currentUserEmail, maxVisible = 5, className, onAvatarClick, followingEmail, }) {
+    const { humanUsers, showAgent } = useMemo(() => {
+        const currentEmail = currentUserEmail?.trim().toLowerCase();
+        const uniqueUsers = dedupeCollabUsersByEmail(activeUsers);
+        const humans = uniqueUsers.filter((u) => {
+            const email = u.email.trim().toLowerCase();
+            return email !== currentEmail && email !== "agent@system";
+        });
+        const hasAgentUser = uniqueUsers.some((u) => u.email.trim().toLowerCase() === "agent@system");
+        return {
+            humanUsers: humans,
+            showAgent: agentPresent || agentActive || hasAgentUser,
+        };
+    }, [activeUsers, currentUserEmail, agentPresent, agentActive]);
+    const visibleUsers = humanUsers.slice(0, maxVisible);
+    const overflowCount = humanUsers.length - visibleUsers.length;
+    if (!showAgent && humanUsers.length === 0)
+        return null;
+    const followingLower = followingEmail?.trim().toLowerCase() ?? null;
+    const isFollowingAgent = followingLower === "agent@system";
+    return (_jsx(TooltipProvider, { delayDuration: 150, children: _jsxs("div", { style: containerStyle, className: className, children: [showAgent && (_jsx(AgentAvatar, { active: !!agentActive, onClick: onAvatarClick ? () => onAvatarClick(null) : undefined, isFollowing: isFollowingAgent, showAgentEditingDot: showAgentEditingDot })), visibleUsers.length > 0 && (_jsxs("div", { style: {
+                        display: "flex",
+                        alignItems: "center",
+                        marginLeft: showAgent ? 6 : 0,
+                    }, children: [visibleUsers.map((u, i) => (_jsx(UserAvatar, { user: u, isFirst: i === 0, onClick: onAvatarClick ? () => onAvatarClick(u) : undefined, isFollowing: followingLower != null &&
+                                u.email.trim().toLowerCase() === followingLower }, u.email))), overflowCount > 0 && (_jsx(OverflowBadge, { count: overflowCount, isFirst: false }))] }))] }) }));
+}
+//# sourceMappingURL=PresenceBar.js.map

package/dist/collab-ui/PresenceBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceBar.js","sourceRoot":"","sources":["../../src/collab-ui/PresenceBar.tsx"],"names":[],"mappings":"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"}

package/dist/collab-ui/PresenceBar.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PresenceBar.spec.d.ts.map

package/dist/collab-ui/PresenceBar.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceBar.spec.d.ts","sourceRoot":"","sources":["../../src/collab-ui/PresenceBar.spec.tsx"],"names":[],"mappings":""}

package/dist/collab-ui/PresenceBar.spec.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { PresenceBar } from "./PresenceBar.js";
+describe("PresenceBar", () => {
+    let container;
+    let root;
+    beforeEach(() => {
+        vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", true);
+        container = document.createElement("div");
+        document.body.appendChild(container);
+        root = createRoot(container);
+    });
+    afterEach(() => {
+        act(() => root.unmount());
+        container.remove();
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+    });
+    it("gives the integrated AI editing label space after the avatar", () => {
+        act(() => {
+            root.render(_jsx(PresenceBar, { activeUsers: [], agentPresent: true, agentActive: true, showAgentEditingDot: false }));
+        });
+        const label = Array.from(container.querySelectorAll("span")).find((element) => element.textContent === "AI editing");
+        expect(label?.style.padding).toBe("0px 0px 0px 2px");
+    });
+});
+//# sourceMappingURL=PresenceBar.spec.js.map

package/dist/collab-ui/PresenceBar.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceBar.spec.js","sourceRoot":"","sources":["../../src/collab-ui/PresenceBar.spec.tsx"],"names":[],"mappings":";AAAA,gCAAgC;AAEhC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,SAAyB,CAAC;IAC9B,IAAI,IAAU,CAAC;IAEf,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,UAAU,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;QAChD,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1B,SAAS,CAAC,MAAM,EAAE,CAAC;QACnB,EAAE,CAAC,eAAe,EAAE,CAAC;QACrB,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,GAAG,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,MAAM,CACT,KAAC,WAAW,IACV,WAAW,EAAE,EAAE,EACf,YAAY,QACZ,WAAW,QACX,mBAAmB,EAAE,KAAK,GAC1B,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAC/D,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,KAAK,YAAY,CAClD,CAAC;QACF,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/collab-ui/RecentEditHighlights.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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 { type RefObject } from "react";
+import { type AttributedRecentEdit } from "./types.js";
+export interface RecentEditHighlightsProps {
+    /** Attributed recent edits (from `useRecentEdits`). */
+    edits: AttributedRecentEdit[];
+    /**
+     * Resolver: maps an edit to a viewport-relative DOMRect, or null when the
+     * region can't be located (the edit is skipped).
+     */
+    resolveRect: (edit: AttributedRecentEdit) => DOMRect | null;
+    /** Container the highlights are positioned within (position: relative). */
+    containerRef: RefObject<HTMLElement | null>;
+    /** Highlight lifetime; should match useRecentEdits ttlMs. Default 6000. */
+    ttlMs?: number;
+    /** Render the compact outline treatment used by the Slides editor. */
+    outlineOnly?: boolean;
+    /** Additional CSS class for the overlay div. */
+    className?: string;
+}
+export declare function RecentEditHighlights({ edits, resolveRect, containerRef, ttlMs, outlineOnly, className, }: RecentEditHighlightsProps): import("react").JSX.Element;
+//# sourceMappingURL=RecentEditHighlights.d.ts.map

package/dist/collab-ui/RecentEditHighlights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecentEditHighlights.d.ts","sourceRoot":"","sources":["../../src/collab-ui/RecentEditHighlights.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B;;;OAGG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,GAAG,IAAI,CAAC;IAC5D,2EAA2E;IAC3E,YAAY,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA+ED,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,WAAW,EACX,YAAY,EACZ,KAA0B,EAC1B,WAAmB,EACnB,SAAS,GACV,EAAE,yBAAyB,+BAmG3B"}

package/dist/collab-ui/RecentEditHighlights.js

@@ -0,0 +1,154 @@
+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 "./types.js";
+const HighlightItem = memo(function HighlightItem({ h }) {
+    return (_jsx("div", { "aria-label": h.isAgent && h.outlineOnly ? h.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,
+            ...(h.outlineOnly
+                ? {}
+                : {
+                    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.outlineOnly ? "transparent" : h.color,
+                border: h.outlineOnly ? `1px solid ${h.color}` : undefined,
+                color: h.outlineOnly ? h.color : "hsl(var(--background))",
+                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, outlineOnly = false, 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
+                    ? outlineOnly
+                        ? "AI editing"
+                        : edit.label
+                            ? `AI — ${edit.label}`
+                            : "AI edited"
+                    : edit.label
+                        ? `${edit.user.name} — ${edit.label}`
+                        : edit.user.name,
+                avatarUrl: edit.user.avatarUrl,
+                isAgent: edit.isAgent,
+                outlineOnly,
+                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))) }));
+}
+//# sourceMappingURL=RecentEditHighlights.js.map

package/dist/collab-ui/RecentEditHighlights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecentEditHighlights.js","sourceRoot":"","sources":["../../src/collab-ui/RecentEditHighlights.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EACL,IAAI,EACJ,SAAS,EACT,eAAe,EACf,MAAM,EACN,QAAQ,GAET,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,kBAAkB,EAA6B,MAAM,YAAY,CAAC;AA+B3E,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,aAAa,CAAC,EAAE,CAAC,EAAoB;IACvE,OAAO,CACL,4BAEI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,EAEjE,KAAK,EAAE;YACL,QAAQ,EAAE,UAAU;YACpB,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG;YACf,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;YACjB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;YACnB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM;YACrB,YAAY,EAAE,CAAC;YACf,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,UAAU,EAAE,wBAAwB;YACpC,OAAO,EAAE,aAAa,CAAC,CAAC,KAAK,EAAE;YAC/B,aAAa,EAAE,CAAC;YAChB,GAAG,CAAC,CAAC,CAAC,WAAW;gBACf,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,eAAe,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI;oBAC/B,SAAS,EAAE,aAAa,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,KAAK,IAAI;iBAC3D,CAAC;SACP,YAED,eACE,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,GAAG,EAAE,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,QAAQ;gBACpB,GAAG,EAAE,CAAC;gBACN,eAAe,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK;gBACxD,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;gBAC1D,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,wBAAwB;gBACzD,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,GAAG;gBACf,OAAO,EAAE,SAAS;gBAClB,YAAY,EAAE,CAAC;gBACf,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,GAAG;gBACb,QAAQ,EAAE,QAAQ;gBAClB,YAAY,EAAE,UAAU;aACzB,aAEA,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CACb,cACE,GAAG,EAAE,CAAC,CAAC,SAAS,EAChB,GAAG,EAAC,EAAE,EACN,KAAK,EAAE;wBACL,KAAK,EAAE,EAAE;wBACT,MAAM,EAAE,EAAE;wBACV,YAAY,EAAE,KAAK;wBACnB,UAAU,EAAE,CAAC;qBACd,GACD,CACH,CAAC,CAAC,CAAC,IAAI,EACP,CAAC,CAAC,KAAK,IACJ,GACF,CACP,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,EACnC,KAAK,EACL,WAAW,EACX,YAAY,EACZ,KAAK,GAAG,kBAAkB,EAC1B,WAAW,GAAG,KAAK,EACnB,SAAS,GACiB;IAC1B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAc,EAAE,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,UAAU,CAAC,OAAO,GAAG,WAAW,CAAC;IAEjC,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,aAAa,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,aAAa,GAAG,SAAS,CAAC,qBAAqB,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,GAAgB,EAAE,CAAC;QAE7B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC;YAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;YAC/C,IACE,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC;gBACxB,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;gBACxB,IAAI,GAAG,aAAa,CAAC,KAAK;gBAC1B,GAAG,GAAG,aAAa,CAAC,MAAM,EAC1B,CAAC;gBACD,SAAS;YACX,CAAC;YAED,2CAA2C;YAC3C,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,KAAK,GAAG,GAAG,CAAC;YAC9B,MAAM,OAAO,GACX,GAAG,IAAI,SAAS;gBACd,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC;YAE/D,IAAI,CAAC,IAAI,CAAC;gBACR,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,EAAE;gBAClC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,SAAS;gBACnC,KAAK,EAAE,IAAI,CAAC,OAAO;oBACjB,CAAC,CAAC,WAAW;wBACX,CAAC,CAAC,YAAY;wBACd,CAAC,CAAC,IAAI,CAAC,KAAK;4BACV,CAAC,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE;4BACtB,CAAC,CAAC,WAAW;oBACjB,CAAC,CAAC,IAAI,CAAC,KAAK;wBACV,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,KAAK,EAAE;wBACrC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBACpB,SAAS,EAAG,IAAI,CAAC,IAA+B,CAAC,SAAS;gBAC1D,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,WAAW;gBACX,OAAO;gBACP,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;aAClE,CAAC,CAAC;QACL,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC;IAEF,eAAe,CAAC,GAAG,EAAE;QACnB,SAAS,EAAE,CAAC;QACZ,uDAAuD;IACzD,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QACvD,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5B,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtB,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACnD,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAClD,CAAC,CAAC;QACF,uDAAuD;IACzD,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,OAAO,CACL,mCAEE,KAAK,EAAE;YACL,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,CAAC;YACR,aAAa,EAAE,MAAM;YACrB,QAAQ,EAAE,QAAQ;SACnB,EACD,SAAS,EAAE,SAAS,YAEnB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACrB,KAAC,aAAa,IAAa,CAAC,EAAE,CAAC,IAAX,CAAC,CAAC,GAAG,CAAU,CACpC,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/collab-ui/RemoteSelectionRings.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 RefObject } from "react";
+import type { OtherPresence } from "./types.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: 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;
+//# sourceMappingURL=RemoteSelectionRings.d.ts.map

package/dist/collab-ui/RemoteSelectionRings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteSelectionRings.d.ts","sourceRoot":"","sources":["../../src/collab-ui/RemoteSelectionRings.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;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,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C,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"}