@agent-native/toolkit 0.2.0 → 0.4.1

package/README.md

@@ -3,19 +3,31 @@
 Reusable app-building UI and helpers for Agent-Native apps.
 
 `@agent-native/core` owns the foundational runtime contracts: actions, server
-plugins, DB, app state, agent chat transport, sharing stores, and other
-framework primitives. `@agent-native/toolkit` owns optional reusable surfaces
-used to compose apps: shadcn-style UI primitives, shared hooks, shell helpers,
-and other app-building modules.
+plugins, DB, app state, agent chat transport, sharing stores, collaboration
+transport, and other framework primitives. `@agent-native/toolkit` owns reusable
+app-building surfaces: shadcn-style UI primitives, app-shell helpers, shared
+hooks, sharing display UI, and collaboration display UI.
 
 Existing `@agent-native/core` imports remain supported during the migration
-window through compatibility re-exports.
+window through compatibility re-exports. Those re-exports are temporary
+migration support; the long-term dependency direction is Toolkit composing core
+runtime APIs where needed, not core permanently depending on Toolkit for app UI.
+
+Extract future behaviorful kits one at a time before broadening the split.
+Sharing is the first candidate because it validates runtime composition, access
+checks, action-backed data, and share-link UI together.
 
 ## Imports
 
 ```tsx
+import { ToolkitProvider } from "@agent-native/toolkit/provider";
+import { PresenceBar } from "@agent-native/toolkit/collab-ui";
+import { VisibilityBadge } from "@agent-native/toolkit/sharing";
 import { Button } from "@agent-native/toolkit/ui/button";
 import { Toaster } from "@agent-native/toolkit/ui/sonner";
 import { useToast } from "@agent-native/toolkit/hooks/use-toast";
 import { useSetHeaderActions } from "@agent-native/toolkit/app-shell";
 ```
+
+Inside template apps, prefer local adapters such as `@/components/ui/button` so
+apps can replace their primitives without changing every callsite.

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

@@ -0,0 +1,12 @@
+export interface AgentPresenceChipProps {
+    /** Whether the agent is actively editing this element. */
+    active: boolean;
+    /** Label text. Default: "AI editing" */
+    label?: string;
+    /** Color. Default: "#00B5FF" */
+    color?: string;
+    /** Additional CSS classes. */
+    className?: string;
+}
+export declare function AgentPresenceChip({ active, label, color, className, }: AgentPresenceChipProps): import("react").JSX.Element | null;
+//# sourceMappingURL=AgentPresenceChip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPresenceChip.d.ts","sourceRoot":"","sources":["../../src/collab-ui/AgentPresenceChip.tsx"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmBD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,KAAoB,EACpB,KAAiB,EACjB,SAAS,GACV,EAAE,sBAAsB,sCAmCxB"}

package/dist/collab-ui/AgentPresenceChip.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const pulseKeyframes = `
+@keyframes _anChipPulse {
+  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;
+}
+export function AgentPresenceChip({ active, label = "AI editing", color = "#00B5FF", className, }) {
+    if (!active)
+        return null;
+    injectStyles();
+    return (_jsxs("span", { className: className, style: {
+            display: "inline-flex",
+            alignItems: "center",
+            gap: 4,
+            height: 20,
+            padding: "0 8px",
+            borderRadius: 9999,
+            backgroundColor: `${color}20`,
+            color,
+            fontSize: 11,
+            fontWeight: 600,
+            whiteSpace: "nowrap",
+        }, children: [_jsx("span", { style: {
+                    width: 6,
+                    height: 6,
+                    borderRadius: "50%",
+                    backgroundColor: color,
+                    animation: "_anChipPulse 2s infinite",
+                    flexShrink: 0,
+                } }), label] }));
+}
+//# sourceMappingURL=AgentPresenceChip.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPresenceChip.js","sourceRoot":"","sources":["../../src/collab-ui/AgentPresenceChip.tsx"],"names":[],"mappings":";AAWA,MAAM,cAAc,GAAG;;;;;CAKtB,CAAC;AAEF,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B,SAAS,YAAY;IACnB,IAAI,aAAa,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,KAAK,CAAC,WAAW,GAAG,cAAc,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAChC,MAAM,EACN,KAAK,GAAG,YAAY,EACpB,KAAK,GAAG,SAAS,EACjB,SAAS,GACc;IACvB,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,YAAY,EAAE,CAAC;IAEf,OAAO,CACL,gBACE,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE;YACL,OAAO,EAAE,aAAa;YACtB,UAAU,EAAE,QAAQ;YACpB,GAAG,EAAE,CAAC;YACN,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,GAAG,KAAK,IAAI;YAC7B,KAAK;YACL,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,QAAQ;SACrB,aAED,eACE,KAAK,EAAE;oBACL,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,CAAC;oBACT,YAAY,EAAE,KAAK;oBACnB,eAAe,EAAE,KAAK;oBACtB,SAAS,EAAE,0BAA0B;oBACrC,UAAU,EAAE,CAAC;iBACd,GACD,EACD,KAAK,IACD,CACR,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * LiveCursorOverlay — renders remote users' cursors over an absolutely-
+ * positioned container.
+ *
+ * Cursor positions are expected as normalized coordinates (0–1 relative to
+ * the container's content size) so different zoom/scroll positions map
+ * correctly. Pass a `mapCoords` prop to handle non-identity transforms
+ * (e.g. a zoomed canvas).
+ *
+ * The agent uses the same pointer shape with an "AI" label.
+ *
+ * Cursors fade out after 10 seconds of no movement.
+ */
+import { type RefObject } from "react";
+import type { OtherPresence, NormalizedPoint } from "./types.js";
+export interface CursorMapFn {
+    /** Convert normalized coords to pixel offsets within the overlay container. */
+    (norm: NormalizedPoint): {
+        x: number;
+        y: number;
+    };
+}
+export interface LiveCursorOverlayProps {
+    /** Remote participants with presence payload. */
+    others: OtherPresence[];
+    /**
+     * Key inside presence payload that carries the cursor position.
+     * Default: "cursor"
+     * Expected shape: { x: number; y: number } (normalized 0–1).
+     */
+    cursorKey?: string;
+    /**
+     * Override coordinate mapping. Default: scale by container clientWidth/Height.
+     * Pass this when the container uses transform: scale() or has virtual scroll.
+     */
+    mapCoords?: CursorMapFn;
+    /**
+     * Container element ref. Required when mapCoords is not provided —
+     * used to compute pixel positions from normalized coords.
+     */
+    containerRef?: RefObject<HTMLElement | null>;
+    /** Additional CSS class for the overlay div. */
+    className?: string;
+}
+export declare function LiveCursorOverlay({ others, cursorKey, mapCoords, containerRef, className, }: LiveCursorOverlayProps): import("react").JSX.Element;
+//# sourceMappingURL=LiveCursorOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LiveCursorOverlay.d.ts","sourceRoot":"","sources":["../../src/collab-ui/LiveCursorOverlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsGD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,SAAoB,EACpB,SAAS,EACT,YAAY,EACZ,SAAS,GACV,EAAE,sBAAsB,+BAuFxB"}

package/dist/collab-ui/LiveCursorOverlay.js

@@ -0,0 +1,124 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * LiveCursorOverlay — renders remote users' cursors over an absolutely-
+ * positioned container.
+ *
+ * Cursor positions are expected as normalized coordinates (0–1 relative to
+ * the container's content size) so different zoom/scroll positions map
+ * correctly. Pass a `mapCoords` prop to handle non-identity transforms
+ * (e.g. a zoomed canvas).
+ *
+ * The agent uses the same pointer shape with an "AI" label.
+ *
+ * Cursors fade out after 10 seconds of no movement.
+ */
+import { useState, useEffect, useRef, memo } from "react";
+const STALE_MS = 10_000; // Fade out cursors older than 10s
+function CursorPointer({ color }) {
+    return (_jsx("svg", { xmlns: "http://www.w3.org/2000/svg", width: "25", height: "29", viewBox: "0 0 25 29", fill: "none", "aria-hidden": true, style: {
+            display: "block",
+            filter: "drop-shadow(0 2px 3px rgba(15, 23, 42, 0.3))",
+        }, children: _jsx("path", { d: "M2.5 2.5L21.5 11L12.6 14.1L8.3 24.5L2.5 2.5Z", fill: color, stroke: "white", strokeLinejoin: "round", strokeWidth: "3" }) }));
+}
+const CursorLabel = memo(function CursorLabel({ entry, }) {
+    const { other, x, y } = entry;
+    const color = other.user.color || "#94a3b8";
+    const label = other.isAgent ? "AI" : other.user.name || other.user.email;
+    return (_jsxs("div", { "aria-label": `${label} cursor`, style: {
+            position: "absolute",
+            left: x,
+            top: y,
+            pointerEvents: "none",
+            userSelect: "none",
+            transform: "translate(-2px, -2px)",
+            zIndex: 9999,
+            transition: "left 120ms linear, top 120ms linear",
+            width: 0,
+            height: 0,
+        }, children: [_jsx(CursorPointer, { color: color }), _jsxs("div", { style: {
+                    position: "absolute",
+                    left: 31,
+                    top: 31,
+                    display: "flex",
+                    alignItems: "center",
+                    gap: 5,
+                    backgroundColor: color,
+                    color: "#fff",
+                    fontSize: 12,
+                    fontWeight: 500,
+                    lineHeight: "16px",
+                    padding: "2px 7px",
+                    borderRadius: 2,
+                    whiteSpace: "nowrap",
+                    boxShadow: "0 5px 12px rgba(15, 23, 42, 0.16)",
+                    maxWidth: 150,
+                    overflow: "hidden",
+                    textOverflow: "ellipsis",
+                }, children: [other.user.avatarUrl ? (_jsx("img", { src: other.user.avatarUrl, alt: "", style: {
+                            width: 14,
+                            height: 14,
+                            borderRadius: "50%",
+                            flexShrink: 0,
+                        } })) : null, label] })] }));
+});
+export function LiveCursorOverlay({ others, cursorKey = "cursor", mapCoords, containerRef, className, }) {
+    const overlayRef = useRef(null);
+    const [, tick] = useState(0); // Force re-render to prune stale cursors
+    const entriesRef = useRef(new Map());
+    // Tick every 5s to prune stale cursors (no re-render storm).
+    useEffect(() => {
+        const id = setInterval(() => tick((n) => n + 1), 5_000);
+        return () => clearInterval(id);
+    }, []);
+    // Build entries from others, computing pixel positions.
+    const now = Date.now();
+    const visible = [];
+    for (const other of others) {
+        const pos = other.presence[cursorKey];
+        if (!pos || typeof pos.x !== "number" || typeof pos.y !== "number")
+            continue;
+        // Compute pixel position.
+        let px;
+        let py;
+        if (mapCoords) {
+            const mapped = mapCoords(pos);
+            px = mapped.x;
+            py = mapped.y;
+        }
+        else {
+            const container = containerRef?.current ?? overlayRef.current?.parentElement;
+            const w = container ? container.clientWidth : 0;
+            const h = container ? container.clientHeight : 0;
+            px = pos.x * w;
+            py = pos.y * h;
+        }
+        const prev = entriesRef.current.get(other.clientId);
+        const lastSeen = prev && prev.x === px && prev.y === py ? prev.lastSeen : now;
+        const entry = { other, x: px, y: py, lastSeen };
+        entriesRef.current.set(other.clientId, entry);
+        if (now - lastSeen < STALE_MS) {
+            visible.push(entry);
+        }
+    }
+    // Remove entries for participants who left.
+    for (const clientId of entriesRef.current.keys()) {
+        if (!others.find((o) => o.clientId === clientId)) {
+            entriesRef.current.delete(clientId);
+        }
+    }
+    if (visible.length === 0) {
+        return (_jsx("div", { ref: overlayRef, "aria-hidden": true, style: {
+                position: "absolute",
+                inset: 0,
+                pointerEvents: "none",
+                overflow: "hidden",
+            }, className: className }));
+    }
+    return (_jsx("div", { ref: overlayRef, "aria-hidden": true, style: {
+            position: "absolute",
+            inset: 0,
+            pointerEvents: "none",
+            overflow: "hidden",
+        }, className: className, children: visible.map((entry) => (_jsx(CursorLabel, { entry: entry }, entry.other.clientId))) }));
+}
+//# sourceMappingURL=LiveCursorOverlay.js.map

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,27 @@
+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;
+    /** 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, 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,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;AA2OD,wBAAgB,WAAW,CAAC,EAC1B,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,UAAc,EACd,SAAS,EACT,aAAa,EACb,cAAc,GACf,EAAE,gBAAgB,sCA+DlB"}

package/dist/collab-ui/PresenceBar.js

@@ -0,0 +1,165 @@
+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, }) {
+    injectStyles();
+    return (_jsxs("div", { style: {
+            display: "flex",
+            alignItems: "center",
+            gap: 4,
+        }, 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, {}), 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() {
+    return (_jsxs("span", { style: {
+            display: "inline-flex",
+            alignItems: "center",
+            gap: 4,
+            height: 20,
+            padding: "0 8px",
+            borderRadius: 9999,
+            backgroundColor: `${AGENT_COLOR}20`,
+            color: AGENT_COLOR,
+            fontSize: 11,
+            fontWeight: 600,
+            whiteSpace: "nowrap",
+        }, children: [_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, 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 })), 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/RecentEditHighlights.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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;
+    /** Additional CSS class for the overlay div. */
+    className?: string;
+}
+export declare function RecentEditHighlights({ edits, resolveRect, containerRef, ttlMs, 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,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuED,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,WAAW,EACX,YAAY,EACZ,KAA0B,EAC1B,SAAS,GACV,EAAE,yBAAyB,+BAgG3B"}