@pantheon-systems/puck-css 0.12.0 → 0.14.0

package/dist/auth/index.js

@@ -1,12 +1,4 @@
-/**
- * P1 Auth module
- *
- * Reusable authentication components for P1-integrated React apps.
- * Exports P1AuthProvider, useP1Auth, and P1LoginPage.
- *
- * For standalone apps, use P1LoginPage as a ready-made login screen.
- * For embedded apps, use useP1Auth() to build your own login UI.
- */
 export { P1AuthProvider, useP1Auth, useOptionalP1Auth, DEMO_USERS, P1_LOGGED_IN_KEY, } from './P1AuthProvider.js';
 export { P1LoginPage } from './P1LoginPage.js';
+export { performLogout } from './logout.js';
 //# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/auth/logout.d.ts

@@ -0,0 +1,23 @@
+import type { LogoutOutcome } from '@pantheon-systems/css-client';
+export type { LogoutOutcome };
+export interface PerformLogoutConfig {
+    cssBaseUrl: string;
+    siteApiToken?: string;
+    /**
+     * The puck-css token key, matching P1AuthProvider's `tokenStorageKey` prop.
+     * Not the broker JWT key — css-client owns that one and resolves it itself.
+     */
+    tokenStorageKey?: string;
+}
+/**
+ * Canonical logout for P1 broker-mode apps. Owns the full sequence:
+ *   1. POST to the backend to obtain the Auth0 logout URL (token still present).
+ *   2. On success: clear broker token (inside brokerLogout) and puck-css keys.
+ *   3. Return the outcome — caller navigates on `signed_out`.
+ *
+ * On `error`, credentials are left intact so the caller can retry or fall back.
+ * Puck-css keys are cleared on `no_session` too — the broker session is gone,
+ * so local state should match.
+ */
+export declare function performLogout(config: PerformLogoutConfig): Promise<LogoutOutcome>;
+//# sourceMappingURL=logout.d.ts.map

package/dist/auth/logout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../src/auth/logout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAevF"}

package/dist/auth/logout.js

@@ -0,0 +1,14 @@
+import { brokerLogout } from '@pantheon-systems/css-client';
+import { DEFAULT_TOKEN_KEY, P1_LOGGED_IN_KEY } from './storage-keys.js';
+export async function performLogout(config) {
+    const { tokenStorageKey, ...brokerConfig } = config;
+    const outcome = await brokerLogout(brokerConfig);
+    if (outcome.status === 'signed_out' || outcome.status === 'no_session') {
+        if (typeof window !== 'undefined') {
+            window.localStorage.removeItem(tokenStorageKey ?? DEFAULT_TOKEN_KEY);
+            window.localStorage.removeItem(P1_LOGGED_IN_KEY);
+        }
+    }
+    return outcome;
+}
+//# sourceMappingURL=logout.js.map

package/dist/auth/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../src/auth/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAwBxE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAA2B;IAI7D,MAAM,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IAEjD,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACvE,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,eAAe,IAAI,iBAAiB,CAAC,CAAC;YACrE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/auth/storage-keys.d.ts

@@ -0,0 +1,5 @@
+/** localStorage key holding the auth token, unless the consumer overrides it. */
+export declare const DEFAULT_TOKEN_KEY = "p1_auth_token";
+/** Set once a user is authenticated; read by host apps to show signed-in UI. */
+export declare const P1_LOGGED_IN_KEY = "p1_logged_in";
+//# sourceMappingURL=storage-keys.d.ts.map

package/dist/auth/storage-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-keys.d.ts","sourceRoot":"","sources":["../../src/auth/storage-keys.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,iBAAiB,CAAC"}

package/dist/auth/storage-keys.js

@@ -0,0 +1,3 @@
+export const DEFAULT_TOKEN_KEY = 'p1_auth_token';
+export const P1_LOGGED_IN_KEY = 'p1_logged_in';
+//# sourceMappingURL=storage-keys.js.map

package/dist/auth/storage-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-keys.js","sourceRoot":"","sources":["../../src/auth/storage-keys.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAGjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC"}

package/dist/collaboration/components/AgentActivityBanner.js

@@ -1,16 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * AgentActivityBanner Component
- *
- * Banner shown when an agent is actively editing the document.
- * Displays agent name, intent, and affected regions.
- */
 import { useState } from 'react';
 import { getAvatarColor } from '../utils/avatarColor.js';
 const baseClass = 'css-puck-agent-banner';
-/**
- * Get initials from a name.
- */
 function getInitials(name) {
     return name
         .split(' ')
@@ -18,17 +9,11 @@ function getInitials(name) {
         .map((word) => word.charAt(0).toUpperCase())
         .join('');
 }
-/**
- * Banner shown when an agent is actively editing the document.
- * Displays agent name, intent, and affected regions.
- */
 export function AgentActivityBanner({ agent, showIdle = false, dismissible = false, onStopAgent, className, }) {
     const [isDismissed, setIsDismissed] = useState(false);
-    // Don't show if agent is idle and showIdle is false
     if (agent.state === 'idle' && !showIdle) {
         return null;
     }
-    // Don't show if dismissed
     if (isDismissed) {
         return null;
     }

package/dist/collaboration/components/AgentActivityBanner.js.map

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

package/dist/collaboration/components/CollaboratorAvatars.js

@@ -1,9 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { getAvatarColor } from '../utils/avatarColor.js';
 const baseClass = 'css-puck-collaborator-avatars';
-/**
- * Get initials from a name (first letter of first two words).
- */
 function getInitials(name) {
     return name
         .split(' ')
@@ -11,9 +8,6 @@ function getInitials(name) {
         .map((word) => word.charAt(0).toUpperCase())
         .join('');
 }
-/**
- * Build tooltip text for an actor.
- */
 function getTooltip(actor) {
     const parts = [actor.name];
     if (actor.role === 'agent' && actor.intent) {
@@ -24,9 +18,6 @@ function getTooltip(actor) {
     }
     return parts.join('\n');
 }
-/**
- * Renders a single avatar.
- */
 function Avatar({ actor, onClick, }) {
     const isEditing = actor.state === 'editing';
     const isAgent = actor.role === 'agent';
@@ -40,26 +31,18 @@ function Avatar({ actor, onClick, }) {
     const handleClick = () => {
         onClick?.(actor);
     };
-    // Generate a consistent color based on the actor's actual ID (not presence record ID)
-    // This ensures colors match the demo UserSwitcher and are consistent across sessions
     const backgroundColor = getAvatarColor(actor.actorId);
     return (_jsxs("div", { className: avatarClasses, style: { backgroundColor }, "data-tooltip": getTooltip(actor), onClick: handleClick, role: "button", tabIndex: 0, onKeyDown: (e) => e.key === 'Enter' && handleClick(), children: [actor.avatar ? (_jsx("img", { src: actor.avatar, alt: actor.name, className: `${baseClass}__image`, referrerPolicy: "no-referrer" })) : (_jsx("span", { className: `${baseClass}__initials`, children: getInitials(actor.name) })), isAgent && _jsx("span", { className: `${baseClass}__agent-badge`, "aria-hidden": "true" })] }));
 }
-/**
- * Displays stacked avatars of collaborators with tooltips showing names/intents.
- * Automatically updates based on usePresence hook.
- */
 export function CollaboratorAvatars({ actors, maxVisible = 5, separateAgents = false, onAvatarClick, className, }) {
     if (actors.length === 0) {
         return _jsx("div", { className: [baseClass, className].filter(Boolean).join(' ') });
     }
     const humans = actors.filter((a) => a.role === 'human');
     const agents = actors.filter((a) => a.role === 'agent');
-    // Determine which actors to display
     let displayActors;
     let overflowCount;
     if (separateAgents) {
-        // Show humans first, then separator, then agents
         const visibleHumans = humans.slice(0, Math.ceil(maxVisible / 2));
         const visibleAgents = agents.slice(0, Math.floor(maxVisible / 2));
         displayActors = [...visibleHumans, ...visibleAgents];

package/dist/collaboration/components/CollaboratorAvatars.js.map

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

package/dist/collaboration/components/FocusRegionHighlight.js

@@ -1,10 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 const baseClass = 'css-puck-focus-highlight';
-/**
- * Generate a consistent color based on actor ID.
- */
 function generateColorFromId(id) {
-    // Simple hash to generate a hue value
     let hash = 0;
     for (let i = 0; i < id.length; i++) {
         hash = id.charCodeAt(i) + ((hash << 5) - hash);
@@ -12,13 +8,8 @@ function generateColorFromId(id) {
     const hue = Math.abs(hash % 360);
     return `hsl(${hue}, 70%, 60%)`;
 }
-/**
- * Overlays visual highlights on Puck components that match actor's focusRegions.
- * Integrates with Puck's component tree.
- */
 export function FocusRegionHighlight({ actor, color, }) {
     const { focusRegions, state, name } = actor;
-    // Don't render if no focus regions
     if (!focusRegions || focusRegions.length === 0) {
         return null;
     }

package/dist/collaboration/components/FocusRegionHighlight.js.map

@@ -1 +1 @@
-{"version":3,"file":"FocusRegionHighlight.js","sourceRoot":"","sources":["../../../src/collaboration/components/FocusRegionHighlight.tsx"],"names":[],"mappings":";AAiBA,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAE7C;;GAEG;AACH,SAAS,mBAAmB,CAAC,EAAU;IACrC,sCAAsC;IACtC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IACjC,OAAO,OAAO,GAAG,aAAa,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,KAAK,EACL,KAAK,GACqB;IAC1B,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAE5C,mCAAmC;IACnC,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,CAAC;IACtC,MAAM,cAAc,GAAG,KAAK,IAAI,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEnE,MAAM,gBAAgB,GAAG;QACvB,SAAS;QACT,SAAS,IAAI,GAAG,SAAS,WAAW;KACrC;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,CACL,cACE,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,EAAE,mBAAmB,EAAE,cAAc,EAAyB,gBACzD,qBAAqB,IAAI,EAAE,YAEtC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC5B,cAEE,SAAS,EAAE,GAAG,SAAS,UAAU,iBACpB,MAAM,IAFd,MAAM,CAGX,CACH,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"FocusRegionHighlight.js","sourceRoot":"","sources":["../../../src/collaboration/components/FocusRegionHighlight.tsx"],"names":[],"mappings":";AAiBA,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAK7C,SAAS,mBAAmB,CAAC,EAAU;IAErC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;IACjC,OAAO,OAAO,GAAG,aAAa,CAAC;AACjC,CAAC;AAMD,MAAM,UAAU,oBAAoB,CAAC,EACnC,KAAK,EACL,KAAK,GACqB;IAC1B,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAG5C,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,CAAC;IACtC,MAAM,cAAc,GAAG,KAAK,IAAI,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEnE,MAAM,gBAAgB,GAAG;QACvB,SAAS;QACT,SAAS,IAAI,GAAG,SAAS,WAAW;KACrC;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,CACL,cACE,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,EAAE,mBAAmB,EAAE,cAAc,EAAyB,gBACzD,qBAAqB,IAAI,EAAE,YAEtC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC5B,cAEE,SAAS,EAAE,GAAG,SAAS,UAAU,iBACpB,MAAM,IAFd,MAAM,CAGX,CACH,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/collaboration/components/PresenceIndicator.js

@@ -1,15 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * PresenceIndicator Component
- *
- * Compact indicator showing presence count with expandable details panel.
- */
 import { useState } from 'react';
 const baseClass = 'css-puck-presence-indicator';
-/**
- * Compact indicator showing presence count with expandable details panel.
- * Shows: "3 collaborators" with breakdown on expand.
- */
 export function PresenceIndicator({ actors, expandable = true, panelPosition = 'bottom', className, }) {
     const [isExpanded, setIsExpanded] = useState(false);
     const count = actors.length;

package/dist/collaboration/components/PresenceIndicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceIndicator.js","sourceRoot":"","sources":["../../../src/collaboration/components/PresenceIndicator.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAc,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAcxC,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,MAAM,EACN,UAAU,GAAG,IAAI,EACjB,aAAa,GAAG,QAAQ,EACxB,SAAS,GACc;IACvB,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,gBAAgB,CAAC;IAE3G,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE1E,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,UAAU,EAAE,CAAC;YACf,aAAa,CAAC,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,eAAK,SAAS,EAAE,gBAAgB,aAC9B,iBACE,SAAS,EAAE,GAAG,SAAS,WAAW,EAClC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAC,QAAQ,mBACE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,YAElD,eAAM,SAAS,EAAE,GAAG,SAAS,SAAS,YAAG,KAAK,GAAQ,GAC/C,EAER,UAAU,IAAI,UAAU,IAAI,CAC3B,cACE,SAAS,EAAE,GAAG,SAAS,WAAW,SAAS,YAAY,aAAa,EAAE,EACtE,IAAI,EAAC,QAAQ,gBACF,eAAe,YAE1B,aAAI,SAAS,EAAE,GAAG,SAAS,QAAQ,YAChC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACrB,cAAmB,SAAS,EAAE,GAAG,SAAS,QAAQ,aAChD,eAAK,SAAS,EAAE,GAAG,SAAS,SAAS,aACnC,eAAM,SAAS,EAAE,GAAG,SAAS,QAAQ,YAAG,KAAK,CAAC,IAAI,GAAQ,EAC1D,eACE,SAAS,EAAE,GAAG,SAAS,WAAW,SAAS,YAAY,KAAK,CAAC,KAAK,EAAE,YAEnE,KAAK,CAAC,KAAK,GACP,IACH,EACL,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CACtD,cAAK,SAAS,EAAE,GAAG,SAAS,WAAW,YACpC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAClC,eAAmB,SAAS,EAAE,GAAG,SAAS,UAAU,YACjD,MAAM,IADE,MAAM,CAEV,CACR,CAAC,GACE,CACP,KAjBM,KAAK,CAAC,EAAE,CAkBZ,CACN,CAAC,GACC,GACD,CACP,IACG,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"PresenceIndicator.js","sourceRoot":"","sources":["../../../src/collaboration/components/PresenceIndicator.tsx"],"names":[],"mappings":";AAMA,OAAc,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAcxC,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAMhD,MAAM,UAAU,iBAAiB,CAAC,EAChC,MAAM,EACN,UAAU,GAAG,IAAI,EACjB,aAAa,GAAG,QAAQ,EACxB,SAAS,GACc;IACvB,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,gBAAgB,CAAC;IAE3G,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE1E,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,UAAU,EAAE,CAAC;YACf,aAAa,CAAC,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,eAAK,SAAS,EAAE,gBAAgB,aAC9B,iBACE,SAAS,EAAE,GAAG,SAAS,WAAW,EAClC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAC,QAAQ,mBACE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,YAElD,eAAM,SAAS,EAAE,GAAG,SAAS,SAAS,YAAG,KAAK,GAAQ,GAC/C,EAER,UAAU,IAAI,UAAU,IAAI,CAC3B,cACE,SAAS,EAAE,GAAG,SAAS,WAAW,SAAS,YAAY,aAAa,EAAE,EACtE,IAAI,EAAC,QAAQ,gBACF,eAAe,YAE1B,aAAI,SAAS,EAAE,GAAG,SAAS,QAAQ,YAChC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACrB,cAAmB,SAAS,EAAE,GAAG,SAAS,QAAQ,aAChD,eAAK,SAAS,EAAE,GAAG,SAAS,SAAS,aACnC,eAAM,SAAS,EAAE,GAAG,SAAS,QAAQ,YAAG,KAAK,CAAC,IAAI,GAAQ,EAC1D,eACE,SAAS,EAAE,GAAG,SAAS,WAAW,SAAS,YAAY,KAAK,CAAC,KAAK,EAAE,YAEnE,KAAK,CAAC,KAAK,GACP,IACH,EACL,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CACtD,cAAK,SAAS,EAAE,GAAG,SAAS,WAAW,YACpC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAClC,eAAmB,SAAS,EAAE,GAAG,SAAS,UAAU,YACjD,MAAM,IADE,MAAM,CAEV,CACR,CAAC,GACE,CACP,KAjBM,KAAK,CAAC,EAAE,CAkBZ,CACN,CAAC,GACC,GACD,CACP,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/collaboration/useBranchPresence.js

@@ -1,43 +1,13 @@
-/**
- * useBranchPresence Hook
- *
- * Provides branch-level presence aggregation with polling.
- */
 import { useState, useCallback, useEffect, useRef } from 'react';
 import { usePresenceContext } from '../core/PresenceContext.js';
-/**
- * Hook for consuming branch-level presence data.
- *
- * @param options - Configuration options
- * @returns Branch presence state and operations
- *
- * @example
- * ```tsx
- * function BranchCollaborators() {
- *   const { presence, activeDocuments, totalActors } = useBranchPresence();
- *
- *   return (
- *     <div>
- *       <span>{totalActors} collaborators on this branch</span>
- *       {activeDocuments.map(doc => (
- *         <DocumentBadge key={doc.documentId} path={doc.documentPath} />
- *       ))}
- *     </div>
- *   );
- * }
- * ```
- */
 export function useBranchPresence(options = {}) {
     const { pollingInterval = 10000 } = options;
     const { client, siteId, branchId } = usePresenceContext();
     const [presence, setPresence] = useState(null);
     const [isLoading, setIsLoading] = useState(true);
     const [error, setError] = useState(null);
-    // Track mounted state to avoid state updates after unmount
     const mountedRef = useRef(true);
-    // Ref for fetchPresence to avoid restarting polling interval
     const fetchPresenceRef = useRef(async () => { });
-    // Fetch presence data
     const fetchPresence = useCallback(async () => {
         try {
             const branchPresence = await client.presence.getBranchPresence(siteId, branchId);
@@ -57,20 +27,15 @@ export function useBranchPresence(options = {}) {
             }
         }
     }, [client, siteId, branchId]);
-    // Keep ref in sync with callback
     useEffect(() => {
         fetchPresenceRef.current = fetchPresence;
     }, [fetchPresence]);
-    // Manual refresh function
     const refresh = useCallback(async () => {
         await fetchPresence();
     }, [fetchPresence]);
-    // Initial fetch and polling
     useEffect(() => {
         mountedRef.current = true;
-        // Initial fetch
         void fetchPresenceRef.current();
-        // Set up polling - use ref to avoid restarting interval when callback changes
         const intervalId = setInterval(() => {
             void fetchPresenceRef.current();
         }, pollingInterval);
@@ -79,7 +44,6 @@ export function useBranchPresence(options = {}) {
             clearInterval(intervalId);
         };
     }, [pollingInterval]);
-    // Derived values
     const activeDocuments = presence?.documentSummary ?? [];
     const totalActors = presence?.summary.totalActors ?? 0;
     return {

package/dist/collaboration/useBranchPresence.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBranchPresence.js","sourceRoot":"","sources":["../../src/collaboration/useBranchPresence.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useBranchPresence.js","sourceRoot":"","sources":["../../src/collaboration/useBranchPresence.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAkDhE,MAAM,UAAU,iBAAiB,CAC/B,UAAoC,EAAE;IAEtC,MAAM,EAAE,eAAe,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAE1D,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAwB,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAGvD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAGhC,MAAM,gBAAgB,GAAG,MAAM,CAAsB,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,CAAC;IAGrE,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEjF,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAEhC,WAAW,CAAC,cAAc,CAAC,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;gBAAS,CAAC;YACT,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAG/B,SAAS,CAAC,GAAG,EAAE;QACb,gBAAgB,CAAC,OAAO,GAAG,aAAa,CAAC;IAC3C,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAGpB,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACrC,MAAM,aAAa,EAAE,CAAC;IACxB,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAGpB,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAG1B,KAAK,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAGhC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YAClC,KAAK,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC,EAAE,eAAe,CAAC,CAAC;QAEpB,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;YAC3B,aAAa,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAGtB,MAAM,eAAe,GAAG,QAAQ,EAAE,eAAe,IAAI,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,QAAQ,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAEvD,OAAO;QACL,QAAQ;QACR,eAAe;QACf,WAAW;QACX,SAAS;QACT,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/collaboration/useFocusRegionReporting.js

@@ -1,91 +1,41 @@
-/**
- * useFocusRegionReporting Hook
- *
- * Manages debounced reporting of focus regions to the backend.
- * Used to inform the server which components a human has selected in the editor,
- * enabling proactive collision detection before actual edits occur.
- */
 import { useState, useCallback, useEffect, useRef } from 'react';
 import { usePresenceContext } from '../core/PresenceContext.js';
-/**
- * Hook for reporting focus regions to the backend.
- *
- * Manages debounced updates, heartbeat keep-alive, and cleanup on unmount.
- * Focus regions tell the server which components the user has selected,
- * allowing agents to avoid editing those regions proactively.
- *
- * @param options - Configuration options
- * @returns Focus state and operations
- *
- * @example
- * ```tsx
- * function SelectionReporter() {
- *   const { setFocusRegions, clearFocus } = useFocusRegionReporting();
- *
- *   // When Puck selection changes
- *   useEffect(() => {
- *     if (selectedItem) {
- *       setFocusRegions([`/content/${selectedItem.index}`]);
- *     } else {
- *       clearFocus();
- *     }
- *   }, [selectedItem, setFocusRegions, clearFocus]);
- *
- *   return null;
- * }
- * ```
- */
 export function useFocusRegionReporting(options = {}) {
     const { enabled = true, debounceMs = 300, heartbeatMs = 15000, sendViaWebSocket } = options;
     const { client, siteId, branchId, documentPath, userId } = usePresenceContext();
-    // Ref for sendViaWebSocket to avoid callback recreation
     const sendViaWebSocketRef = useRef(sendViaWebSocket);
     useEffect(() => {
         sendViaWebSocketRef.current = sendViaWebSocket;
     }, [sendViaWebSocket]);
-    // Local state
     const [focusRegions, setFocusRegionsState] = useState([]);
     const [isReporting, setIsReporting] = useState(false);
-    // Refs for managing timers and cleanup
     const debounceTimerRef = useRef(null);
     const heartbeatTimerRef = useRef(null);
     const mountedRef = useRef(true);
     const lastReportedRef = useRef(null);
     const focusRegionsRef = useRef([]);
-    // Keep ref in sync with state
     useEffect(() => {
         focusRegionsRef.current = focusRegions;
     }, [focusRegions]);
-    // Ref for reportFocusRegions to avoid restarting heartbeat interval
     const reportFocusRegionsRef = useRef(async () => { });
-    /**
-     * Send focus regions to the server.
-     * Tries WebSocket first if available, falls back to HTTP.
-     */
     const reportFocusRegions = useCallback(async (regions) => {
-        // Deduplicate - don't report if regions haven't changed
         const serialized = JSON.stringify(regions);
         if (serialized === lastReportedRef.current) {
             return;
         }
-        // Skip if disabled, unmounted, or no document path
         if (!enabled || !mountedRef.current || !documentPath) {
             return;
         }
-        // Try WebSocket first if available, fall back to HTTP
         if (sendViaWebSocketRef.current?.(regions)) {
             lastReportedRef.current = serialized;
             return;
         }
-        // Fall back to HTTP
         try {
             setIsReporting(true);
             await client.presence.updateFocusRegions(siteId, branchId, documentPath, userId, regions);
             lastReportedRef.current = serialized;
         }
         catch {
-            // Silently handle errors - focus reporting is not critical
-            // Log for debugging if needed
         }
         finally {
             if (mountedRef.current) {
@@ -93,57 +43,41 @@ export function useFocusRegionReporting(options = {}) {
             }
         }
     }, [client, siteId, branchId, documentPath, userId, enabled]);
-    // Keep ref in sync with callback
     useEffect(() => {
         reportFocusRegionsRef.current = reportFocusRegions;
     }, [reportFocusRegions]);
-    /**
-     * Set focus regions with debouncing.
-     */
     const setFocusRegions = useCallback((regions) => {
-        // Update local state immediately
         setFocusRegionsState(regions);
         if (!enabled) {
             return;
         }
-        // Cancel any pending debounced call
         if (debounceTimerRef.current) {
             clearTimeout(debounceTimerRef.current);
         }
-        // Schedule debounced report
         debounceTimerRef.current = setTimeout(() => {
             void reportFocusRegions(regions);
         }, debounceMs);
     }, [enabled, debounceMs, reportFocusRegions]);
-    /**
-     * Clear focus regions.
-     */
     const clearFocus = useCallback(() => {
         setFocusRegionsState([]);
         if (!enabled) {
             return;
         }
-        // Cancel any pending debounced call
         if (debounceTimerRef.current) {
             clearTimeout(debounceTimerRef.current);
         }
-        // Schedule debounced report
         debounceTimerRef.current = setTimeout(() => {
             void reportFocusRegions([]);
         }, debounceMs);
     }, [enabled, debounceMs, reportFocusRegions]);
-    // Heartbeat to keep focus alive
     useEffect(() => {
         if (!enabled) {
             return;
         }
         heartbeatTimerRef.current = setInterval(() => {
-            // Only send heartbeat if we have focus regions
             if (focusRegionsRef.current.length > 0) {
-                // Reset lastReported to force the heartbeat through
                 const serialized = JSON.stringify(focusRegionsRef.current);
                 if (lastReportedRef.current === serialized) {
-                    // Same regions - force through by clearing last reported temporarily
                     lastReportedRef.current = null;
                 }
                 void reportFocusRegionsRef.current(focusRegionsRef.current);
@@ -156,35 +90,26 @@ export function useFocusRegionReporting(options = {}) {
             }
         };
     }, [enabled, heartbeatMs]);
-    // Cleanup on unmount
     useEffect(() => {
         mountedRef.current = true;
         return () => {
             mountedRef.current = false;
-            // Cancel pending debounced call
             if (debounceTimerRef.current) {
                 clearTimeout(debounceTimerRef.current);
                 debounceTimerRef.current = null;
             }
-            // Cancel heartbeat
             if (heartbeatTimerRef.current) {
                 clearInterval(heartbeatTimerRef.current);
                 heartbeatTimerRef.current = null;
             }
-            // Send final clear (fire-and-forget)
-            // Only if we have a document path to clear
             if (enabled && documentPath) {
-                // Reset lastReported to ensure the clear goes through
                 lastReportedRef.current = null;
-                // Try WebSocket first if available
                 if (sendViaWebSocketRef.current?.([])) {
                     return;
                 }
-                // Fall back to HTTP
                 void client.presence
                     .updateFocusRegions(siteId, branchId, documentPath, userId, [])
                     .catch(() => {
-                    // Ignore errors on unmount
                 });
             }
         };

package/dist/collaboration/useFocusRegionReporting.js.map

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