@actuate-media/cms-admin 0.12.0 → 0.13.0

package/dist/components/NotificationBell.js

@@ -0,0 +1,142 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { listNotifications as defaultListNotifications, markAllNotificationsRead as defaultMarkAllRead, markNotificationRead as defaultMarkRead, notificationSummary, subscribeNotificationStream as defaultSubscribeStream, unreadCount as defaultUnreadCount, } from '../lib/notifications-client.js';
+const defaultApi = {
+    list: (opts) => defaultListNotifications(opts),
+    unread: () => defaultUnreadCount(),
+    markRead: (id) => defaultMarkRead(id),
+    markAllRead: () => defaultMarkAllRead(),
+    subscribe: (opts) => defaultSubscribeStream(opts),
+};
+export function NotificationBell({ pollIntervalMs = 60_000, onSelect, onError, api = defaultApi, className, }) {
+    const [open, setOpen] = useState(false);
+    const [unread, setUnread] = useState(0);
+    const [items, setItems] = useState([]);
+    const [loading, setLoading] = useState(false);
+    const mountedRef = useRef(true);
+    // Set of notification IDs we've already rendered. The SSE handler
+    // consults this synchronously so duplicate deliveries (REST refresh
+    // + SSE push, or two SSE retries) don't double-bump the badge.
+    // Kept in sync with `items` via an effect — the items state is the
+    // source of truth; this ref is a derived O(1) lookup index.
+    const seenIdsRef = useRef(new Set());
+    useEffect(() => {
+        seenIdsRef.current = new Set(items.map((n) => n.id));
+    }, [items]);
+    useEffect(() => {
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const refreshUnread = useCallback(async () => {
+        const out = await api.unread();
+        if (!mountedRef.current)
+            return;
+        if (!out.ok) {
+            onError?.(out.error);
+            return;
+        }
+        setUnread(out.result);
+    }, [api, onError]);
+    const refreshList = useCallback(async (includeRead = false) => {
+        setLoading(true);
+        const out = await api.list({ includeRead });
+        if (!mountedRef.current)
+            return;
+        if (!out.ok) {
+            onError?.(out.error);
+            setItems([]);
+        }
+        else {
+            setItems(out.result);
+        }
+        setLoading(false);
+    }, [api, onError]);
+    useEffect(() => {
+        void refreshUnread();
+        if (!pollIntervalMs)
+            return;
+        const id = setInterval(() => void refreshUnread(), pollIntervalMs);
+        return () => clearInterval(id);
+    }, [refreshUnread, pollIntervalMs]);
+    // SSE push subscription. Bumps the badge + prepends the new row to
+    // the open dropdown the instant the server publishes. Falls back
+    // silently when the api/runtime doesn't support EventSource — the
+    // poll loop above keeps the bell correct in that case.
+    useEffect(() => {
+        if (!api.subscribe)
+            return;
+        const handle = api.subscribe({
+            onNotification: (n) => {
+                if (!mountedRef.current)
+                    return;
+                // Defensive: SSE events can race with REST refreshes (or with
+                // their own retries). The seen-id ref is updated
+                // synchronously so a second delivery of the same row is a
+                // no-op for BOTH `items` and the unread badge — guarding only
+                // setItems would still let the counter drift.
+                if (seenIdsRef.current.has(n.id))
+                    return;
+                seenIdsRef.current.add(n.id);
+                setItems((arr) => [n, ...arr]);
+                if (!n.readAt)
+                    setUnread((v) => v + 1);
+            },
+            onError: () => {
+                // Don't surface every transient SSE disconnect as a UI error —
+                // the browser auto-reconnects, and the poll loop keeps state
+                // converging. We deliberately stay quiet here.
+            },
+        });
+        return () => handle.close();
+    }, [api]);
+    useEffect(() => {
+        if (!open)
+            return;
+        void refreshList(false);
+    }, [open, refreshList]);
+    const handleClickRow = useCallback(async (n) => {
+        // Optimistic update: drop the unread count + tag the row read.
+        if (!n.readAt) {
+            setUnread((v) => Math.max(0, v - 1));
+            setItems((arr) => arr.map((row) => (row.id === n.id ? { ...row, readAt: new Date().toISOString() } : row)));
+            const out = await api.markRead(n.id);
+            if (!out.ok) {
+                onError?.(out.error);
+                // Roll back on failure.
+                setUnread((v) => v + 1);
+                setItems((arr) => arr.map((row) => (row.id === n.id ? { ...row, readAt: null } : row)));
+            }
+        }
+        onSelect?.(n);
+    }, [api, onError, onSelect]);
+    const handleMarkAll = useCallback(async () => {
+        // Snapshot ONLY the previously-unread IDs (and their original
+        // readAt values, which are null by definition). On rollback we
+        // restore those specific rows and leave anything that arrived
+        // via SSE while the request was in flight alone — otherwise a
+        // failed mark-all-read would drop fresh notifications.
+        const previouslyUnreadIds = items.filter((n) => n.readAt === null).map((n) => n.id);
+        if (previouslyUnreadIds.length === 0)
+            return;
+        const ids = new Set(previouslyUnreadIds);
+        const now = new Date().toISOString();
+        setItems((arr) => arr.map((n) => (ids.has(n.id) ? { ...n, readAt: n.readAt ?? now } : n)));
+        setUnread(0);
+        const out = await api.markAllRead();
+        if (!out.ok) {
+            onError?.(out.error);
+            // Functional rollback: only revert the rows we optimistically
+            // marked. Anything mid-flight (SSE arrivals, locally-added) is
+            // untouched.
+            setItems((arr) => arr.map((n) => (ids.has(n.id) ? { ...n, readAt: null } : n)));
+            await refreshUnread();
+        }
+    }, [api, items, onError, refreshUnread]);
+    return (_jsxs("div", { className: `relative ${className ?? ''}`, "data-testid": "notification-bell", children: [_jsxs("button", { type: "button", className: "relative rounded p-1.5 text-gray-600 hover:bg-gray-100 hover:text-gray-900", "aria-label": "Notifications", "aria-haspopup": "menu", "aria-expanded": open, onClick: () => setOpen((v) => !v), "data-testid": "bell-button", children: [_jsx(BellIcon, {}), unread > 0 && (_jsx("span", { className: "absolute -top-0.5 -right-0.5 inline-flex h-4 min-w-4 items-center justify-center rounded-full bg-red-600 px-1 text-[10px] font-semibold text-white", "data-testid": "bell-badge", children: unread > 99 ? '99+' : unread }))] }), open && (_jsxs("div", { role: "menu", className: "absolute right-0 z-50 mt-1 w-80 rounded border border-gray-200 bg-white shadow-lg", "data-testid": "bell-dropdown", children: [_jsxs("header", { className: "flex items-center justify-between border-b border-gray-100 px-3 py-2", children: [_jsx("span", { className: "text-sm font-semibold text-gray-900", children: "Notifications" }), _jsx("button", { type: "button", className: "text-xs text-gray-600 hover:text-gray-900 disabled:opacity-50", onClick: handleMarkAll, disabled: unread === 0, "data-testid": "bell-mark-all", children: "Mark all read" })] }), _jsx("div", { className: "max-h-80 overflow-y-auto", "aria-busy": loading, "data-testid": "bell-list", children: loading ? (_jsx("p", { className: "px-3 py-2 text-xs text-gray-500", children: "Loading\u2026" })) : items.length === 0 ? (_jsx("p", { className: "px-3 py-2 text-xs text-gray-500", children: "All caught up." })) : (_jsx("ul", { children: items.map((n) => (_jsx("li", { children: _jsxs("button", { type: "button", role: "menuitem", className: `block w-full px-3 py-2 text-left text-xs hover:bg-gray-50 ${n.readAt ? 'text-gray-500' : 'font-medium text-gray-900'}`, onClick: () => handleClickRow(n), "data-testid": `bell-row-${n.id}`, "data-read": n.readAt ? 'true' : 'false', children: [_jsx("div", { children: notificationSummary(n) }), _jsx("div", { className: "mt-0.5 text-[10px] text-gray-400", children: n.createdAt })] }) }, n.id))) })) })] }))] }));
+}
+function BellIcon() {
+    return (_jsxs("svg", { "aria-hidden": "true", width: "18", height: "18", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M6 8a6 6 0 0 1 12 0c0 7 3 9 3 9H3s3-2 3-9" }), _jsx("path", { d: "M10.3 21a1.94 1.94 0 0 0 3.4 0" })] }));
+}
+//# sourceMappingURL=NotificationBell.js.map

package/dist/components/NotificationBell.js.map

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

package/dist/components/OfflineStatus.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import type { CollaborationStatus, OfflinePersistenceStatus } from '../lib/collaboration-provider.js';
+/**
+ * Compact connection + offline-draft indicator. Rendered alongside the
+ * presence chips above the editor toolbar so editors get a single,
+ * always-visible signal:
+ *
+ * - **Saved & synced** — IndexedDB store is ready and the gateway
+ *   socket is connected.
+ * - **Saved locally** — IndexedDB ready but the socket is disconnected
+ *   (offline drafts in flight; will sync on reconnect).
+ * - **Syncing local copy…** — IndexedDB is replaying the last snapshot
+ *   into the doc. The editor is still usable but undo / cursor sync
+ *   may flicker briefly.
+ * - **Local drafts unsupported** — `indexedDB` is unavailable; the
+ *   editor will rely on the gateway only. Refresh loses uncommitted
+ *   edits.
+ * - **Local drafts failed** — IndexedDB threw on init (quota, private
+ *   browsing). Same risk as "unsupported", but with a different cause.
+ *
+ * Keeping the component dumb and prop-driven keeps the unit tests
+ * trivial — the parent owns the status transitions.
+ */
+export interface OfflineStatusProps {
+    connection: CollaborationStatus;
+    offline: OfflinePersistenceStatus;
+}
+export declare function OfflineStatus({ connection, offline }: OfflineStatusProps): React.JSX.Element;
+export type OfflineTone = 'good' | 'warn' | 'info' | 'bad';
+/**
+ * Pure helper that maps the (connection, offline) status pair to a
+ * single user-facing label + colour tone. Exported so the unit tests
+ * can exercise every combination without rendering React.
+ */
+export declare function describeOfflineStatus(connection: CollaborationStatus, offline: OfflinePersistenceStatus): {
+    label: string;
+    tone: OfflineTone;
+};
+//# sourceMappingURL=OfflineStatus.d.ts.map

package/dist/components/OfflineStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineStatus.d.ts","sourceRoot":"","sources":["../../src/components/OfflineStatus.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,kCAAkC,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,mBAAmB,CAAA;IAC/B,OAAO,EAAE,wBAAwB,CAAA;CAClC;AAED,wBAAgB,aAAa,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAa5F;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AAgB1D;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,wBAAwB,GAChC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAetC"}

package/dist/components/OfflineStatus.js

@@ -0,0 +1,47 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function OfflineStatus({ connection, offline }) {
+    const { label, tone } = describeOfflineStatus(connection, offline);
+    const baseClass = 'inline-flex items-center gap-1 rounded px-1.5 py-0.5 text-[11px] font-medium';
+    const toneClass = TONE_CLASSES[tone];
+    return (_jsxs("span", { className: `${baseClass} ${toneClass}`, "data-testid": "offline-status", "data-tone": tone, children: [_jsx("span", { "aria-hidden": "true", className: `inline-block h-1.5 w-1.5 rounded-full ${DOT_CLASSES[tone]}` }), label] }));
+}
+const TONE_CLASSES = {
+    good: 'bg-emerald-50 text-emerald-700',
+    warn: 'bg-amber-50 text-amber-800',
+    info: 'bg-blue-50 text-blue-700',
+    bad: 'bg-red-50 text-red-700',
+};
+const DOT_CLASSES = {
+    good: 'bg-emerald-500',
+    warn: 'bg-amber-500',
+    info: 'bg-blue-500',
+    bad: 'bg-red-500',
+};
+/**
+ * Pure helper that maps the (connection, offline) status pair to a
+ * single user-facing label + colour tone. Exported so the unit tests
+ * can exercise every combination without rendering React.
+ */
+export function describeOfflineStatus(connection, offline) {
+    if (offline === 'error')
+        return { label: 'Local drafts failed', tone: 'bad' };
+    if (offline === 'unsupported') {
+        // No local persistence; the WebSocket is the only safety net.
+        if (connection === 'connected')
+            return { label: 'Synced', tone: 'good' };
+        if (connection === 'connecting')
+            return { label: 'Connecting…', tone: 'info' };
+        return { label: 'Offline — drafts not persisted', tone: 'warn' };
+    }
+    if (offline === 'loading' || offline === 'pending') {
+        return { label: 'Restoring local copy…', tone: 'info' };
+    }
+    // offline === 'ready' from here on.
+    if (connection === 'connected')
+        return { label: 'Saved & synced', tone: 'good' };
+    if (connection === 'connecting')
+        return { label: 'Saved locally — reconnecting…', tone: 'warn' };
+    return { label: 'Saved locally — offline', tone: 'warn' };
+}
+//# sourceMappingURL=OfflineStatus.js.map

package/dist/components/OfflineStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineStatus.js","sourceRoot":"","sources":["../../src/components/OfflineStatus.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAmCZ,MAAM,UAAU,aAAa,CAAC,EAAE,UAAU,EAAE,OAAO,EAAsB;IACvE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAClE,MAAM,SAAS,GAAG,8EAA8E,CAAA;IAChG,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IACpC,OAAO,CACL,gBAAM,SAAS,EAAE,GAAG,SAAS,IAAI,SAAS,EAAE,iBAAc,gBAAgB,eAAY,IAAI,aACxF,8BACc,MAAM,EAClB,SAAS,EAAE,yCAAyC,WAAW,CAAC,IAAI,CAAC,EAAE,GACvE,EACD,KAAK,IACD,CACR,CAAA;AACH,CAAC;AAID,MAAM,YAAY,GAAgC;IAChD,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,0BAA0B;IAChC,GAAG,EAAE,wBAAwB;CAC9B,CAAA;AAED,MAAM,WAAW,GAAgC;IAC/C,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,aAAa;IACnB,GAAG,EAAE,YAAY;CAClB,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAA+B,EAC/B,OAAiC;IAEjC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC7E,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC9B,8DAA8D;QAC9D,IAAI,UAAU,KAAK,WAAW;YAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;QACxE,IAAI,UAAU,KAAK,YAAY;YAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;QAC9E,OAAO,EAAE,KAAK,EAAE,gCAAgC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAClE,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACzD,CAAC;IACD,oCAAoC;IACpC,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAChF,IAAI,UAAU,KAAK,YAAY;QAAE,OAAO,EAAE,KAAK,EAAE,+BAA+B,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAChG,OAAO,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AAC3D,CAAC"}

package/dist/components/PresenceChips.d.ts

@@ -0,0 +1,31 @@
+import { Awareness } from 'y-protocols/awareness';
+import { type CollaborationStatus } from '../lib/collaboration-provider.js';
+export interface PresenceChipsProps {
+    /** Awareness instance returned from `createCollaborationProvider`. */
+    awareness: Awareness;
+    /**
+     * Optional connection status. When provided the strip renders a small
+     * status pill (Connected / Connecting / Disconnected) on the left side.
+     */
+    status?: CollaborationStatus;
+    /**
+     * Hide the local user from the strip. Defaults to `true` — the local user
+     * already knows they're editing.
+     */
+    hideSelf?: boolean;
+    /** Max chips to show before collapsing to "+N". Defaults to 5. */
+    maxVisible?: number;
+    className?: string;
+}
+/**
+ * Small avatar / initials strip showing who else is currently editing the
+ * document. Subscribes to the supplied `Awareness` instance for live
+ * updates.
+ *
+ * The component is intentionally stateless about transport — it only reads
+ * from Awareness and `status`. Wiring is the caller's job.
+ */
+export declare function PresenceChips({ awareness, status, hideSelf, maxVisible, className, }: PresenceChipsProps): import("react/jsx-runtime").JSX.Element;
+/** Convert "Alice Cooper" → "AC", single names → "A", empty → "?". */
+export declare function nameToInitials(name: string): string;
+//# sourceMappingURL=PresenceChips.d.ts.map

package/dist/components/PresenceChips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceChips.d.ts","sourceRoot":"","sources":["../../src/components/PresenceChips.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEjD,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,kCAAkC,CAAA;AAEzC,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,SAAS,EAAE,SAAS,CAAA;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,MAAM,EACN,QAAe,EACf,UAAc,EACd,SAAS,GACV,EAAE,kBAAkB,2CA8CpB;AAiDD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUnD"}

package/dist/components/PresenceChips.js

@@ -0,0 +1,58 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { summarisePresence, } from '../lib/collaboration-provider.js';
+/**
+ * Small avatar / initials strip showing who else is currently editing the
+ * document. Subscribes to the supplied `Awareness` instance for live
+ * updates.
+ *
+ * The component is intentionally stateless about transport — it only reads
+ * from Awareness and `status`. Wiring is the caller's job.
+ */
+export function PresenceChips({ awareness, status, hideSelf = true, maxVisible = 5, className, }) {
+    const [snapshot, setSnapshot] = useState(() => summarisePresence(awareness));
+    useEffect(() => {
+        const update = () => {
+            setSnapshot(summarisePresence(awareness));
+        };
+        update();
+        awareness.on('update', update);
+        awareness.on('change', update);
+        return () => {
+            awareness.off('update', update);
+            awareness.off('change', update);
+        };
+    }, [awareness]);
+    const visible = hideSelf
+        ? snapshot.users.filter((u) => u.clientId !== snapshot.selfClientId)
+        : snapshot.users;
+    const overflow = Math.max(0, visible.length - maxVisible);
+    const shown = visible.slice(0, maxVisible);
+    return (_jsxs("div", { className: `inline-flex items-center gap-1.5 text-xs ${className ?? ''}`, "data-testid": "presence-chips", children: [status && _jsx(StatusPill, { status: status }), shown.length === 0 && status !== 'connecting' && (_jsx("span", { className: "text-gray-500", "data-testid": "presence-empty", children: "You're the only one here" })), shown.map(({ clientId, user }) => (_jsx(Chip, { name: user.name, color: user.color, avatarUrl: user.avatarUrl }, clientId))), overflow > 0 && (_jsxs("span", { className: "rounded-full bg-gray-100 px-2 py-0.5 text-gray-700", "data-testid": "presence-overflow", children: ["+", overflow] }))] }));
+}
+function StatusPill({ status }) {
+    const palette = {
+        connected: { dot: 'bg-emerald-500', label: 'Live', text: 'text-emerald-700' },
+        connecting: { dot: 'bg-amber-400 animate-pulse', label: 'Connecting', text: 'text-amber-700' },
+        disconnected: { dot: 'bg-gray-300', label: 'Offline', text: 'text-gray-500' },
+    };
+    const cfg = palette[status];
+    return (_jsxs("span", { className: `inline-flex items-center gap-1 rounded-full bg-gray-50 px-2 py-0.5 ${cfg.text}`, "data-testid": `presence-status-${status}`, children: [_jsx("span", { className: `h-1.5 w-1.5 rounded-full ${cfg.dot}` }), cfg.label] }));
+}
+function Chip({ name, color, avatarUrl }) {
+    const initials = nameToInitials(name);
+    return (_jsxs("span", { className: "inline-flex items-center gap-1 rounded-full bg-white px-1.5 py-0.5 ring-1 ring-gray-200", title: name, "data-testid": "presence-chip", children: [avatarUrl ? (_jsx("img", { src: avatarUrl, alt: "", className: "h-4 w-4 rounded-full object-cover", style: { boxShadow: `0 0 0 1.5px ${color}` } })) : (_jsx("span", { "aria-hidden": "true", className: "flex h-4 w-4 items-center justify-center rounded-full text-[8px] font-semibold text-white", style: { backgroundColor: color }, children: initials })), _jsx("span", { className: "max-w-[80px] truncate text-gray-700", children: name })] }));
+}
+/** Convert "Alice Cooper" → "AC", single names → "A", empty → "?". */
+export function nameToInitials(name) {
+    const cleaned = name.trim();
+    if (!cleaned)
+        return '?';
+    const parts = cleaned.split(/\s+/).slice(0, 2);
+    return (parts
+        .map((p) => (p[0] ?? '').toUpperCase())
+        .filter(Boolean)
+        .join('') || '?');
+}
+//# sourceMappingURL=PresenceChips.js.map

package/dist/components/PresenceChips.js.map

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

package/dist/components/TipTapEditor.d.ts

@@ -1,9 +1,69 @@
+import { type CollaborationUser } from '../lib/collaboration-provider.js';
+/**
+ * Configuration for real-time collaboration on this editor.
+ *
+ * When supplied the editor switches into CRDT mode: history is delegated to
+ * Yjs, edits sync through the cms-core realtime gateway, and a presence
+ * strip with live cursors appears beside the toolbar. The `content` prop is
+ * ignored in collaboration mode (the gateway is the source of truth);
+ * `onChange` still fires on every local update so existing autosave wiring
+ * keeps working.
+ */
+export interface TipTapCollaborationConfig {
+    documentId: string;
+    /**
+     * Base URL of the realtime gateway. `wss://your.app/api/cms/realtime/sync`
+     * in production, `ws://localhost:3000/api/cms/realtime/sync` for dev.
+     */
+    url: string;
+    user: CollaborationUser;
+    /** Extra query params (e.g. auth token for cross-origin deployments). */
+    params?: Record<string, string>;
+}
 export interface TipTapEditorProps {
     content: string;
     onChange: (html: string) => void;
     placeholder?: string;
     editable?: boolean;
     className?: string;
+    /**
+     * Toggle the AI co-author bubble menu on text selection.
+     * Defaults to `true` when the editor is editable. Set to `false` to opt
+     * out (e.g. for preview-only renders, or environments where the
+     * `/ai/coauthor` endpoint is intentionally disabled).
+     */
+    enableAI?: boolean;
+    /**
+     * Enable real-time collaboration via the cms-core realtime gateway. When
+     * set, the editor swaps in Yjs-backed history + the collaboration cursor
+     * extension and renders a presence strip above the toolbar.
+     */
+    collaboration?: TipTapCollaborationConfig;
+    /**
+     * Enable inline comments. When set, the `CommentMark` extension is
+     * loaded and a `CommentSidePanel` renders next to the editor. Anchors
+     * are encoded against the active Yjs text node when collaboration is
+     * also on, so highlights survive concurrent edits.
+     *
+     * Comments are independent of the collaboration prop — you can attach
+     * comments to a static document, but cross-user "live" highlighting
+     * only kicks in when collaboration is also enabled.
+     */
+    comments?: TipTapCommentsConfig;
+}
+/**
+ * Configuration for the comments side panel. The panel issues REST calls
+ * against the slice-4 endpoints; this prop is just the small set of
+ * presentation + identity bits the panel can't infer from the editor.
+ */
+export interface TipTapCommentsConfig {
+    documentId: string;
+    /** Logged-in user id — gates edit + delete affordances. */
+    currentUserId: string;
+    /** Set to true to expose moderation actions on every comment. */
+    isAdmin?: boolean;
+    /** Error sink so the host shell can show a toast. */
+    onError?: (message: string) => void;
 }
-export declare function TipTapEditor({ content, onChange, placeholder, editable, className, }: TipTapEditorProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function TipTapEditor({ content, onChange, placeholder, editable, className, enableAI, collaboration, comments, }: TipTapEditorProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=TipTapEditor.d.ts.map

package/dist/components/TipTapEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TipTapEditor.d.ts","sourceRoot":"","sources":["../../src/components/TipTapEditor.tsx"],"names":[],"mappings":"AA+CA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAwVD,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,QAAQ,EACR,WAAW,EACX,QAAe,EACf,SAAS,GACV,EAAE,iBAAiB,kDA6DnB"}
+{"version":3,"file":"TipTapEditor.d.ts","sourceRoot":"","sources":["../../src/components/TipTapEditor.tsx"],"names":[],"mappings":"AAWA,OAAO,EAIL,KAAK,iBAAiB,EAEvB,MAAM,kCAAkC,CAAA;AAgDzC;;;;;;;;;GASG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,iBAAiB,CAAA;IACvB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,yBAAyB,CAAA;IACzC;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAA;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAA;IACrB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qDAAqD;IACrD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC;AAwVD,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,QAAQ,EACR,WAAW,EACX,QAAe,EACf,SAAS,EACT,QAAe,EACf,aAAa,EACb,QAAQ,GACT,EAAE,iBAAiB,kDAiOnB"}