@cossistant/react 0.0.26 → 0.0.28

package/support/context/slots.d.ts

@@ -0,0 +1,85 @@
+import * as React$1 from "react";
+
+//#region src/support/context/slots.d.ts
+type SlotContextValue = {
+  /**
+   * Custom header slot content
+   */
+  header: React$1.ReactNode | null;
+  /**
+   * Custom footer slot content
+   */
+  footer: React$1.ReactNode | null;
+  /**
+   * Whether to use the custom header
+   */
+  hasCustomHeader: boolean;
+  /**
+   * Whether to use the custom footer
+   */
+  hasCustomFooter: boolean;
+};
+type SlotProviderProps = {
+  children: React$1.ReactNode;
+};
+/**
+ * Provider for slot-based customization.
+ * Allows children to register custom header/footer content.
+ */
+declare const SlotProvider: React$1.FC<SlotProviderProps>;
+/**
+ * Access slot values (for content component)
+ */
+declare function useSlots(): SlotContextValue;
+type SlotProps = {
+  /**
+   * Content to render in the slot.
+   */
+  children: React$1.ReactNode;
+  /**
+   * When true, renders children directly without a wrapper.
+   * Useful when you want your component to receive all props.
+   */
+  asChild?: boolean;
+};
+/**
+ * Header slot component.
+ * Use inside Support.Content to replace the default header.
+ *
+ * @example
+ * <Support.Content>
+ *   <Support.Header>
+ *     <MyCustomHeader />
+ *   </Support.Header>
+ *   <Support.Router />
+ * </Support.Content>
+ *
+ * @example
+ * // With asChild pattern
+ * <Support.Header asChild>
+ *   <MyCustomHeader showBackButton />
+ * </Support.Header>
+ */
+declare const HeaderSlot: React$1.FC<SlotProps>;
+/**
+ * Footer slot component.
+ * Use inside Support.Content to replace the default footer.
+ *
+ * @example
+ * <Support.Content>
+ *   <Support.Router />
+ *   <Support.Footer>
+ *     <MyCustomFooter />
+ *   </Support.Footer>
+ * </Support.Content>
+ *
+ * @example
+ * // With asChild pattern
+ * <Support.Footer asChild>
+ *   <MyCustomFooter showBranding={false} />
+ * </Support.Footer>
+ */
+declare const FooterSlot: React$1.FC<SlotProps>;
+//#endregion
+export { FooterSlot, HeaderSlot, SlotContextValue, SlotProps, SlotProvider, SlotProviderProps, useSlots };
+//# sourceMappingURL=slots.d.ts.map

package/support/context/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","names":[],"sources":["../../../src/support/context/slots.tsx"],"sourcesContent":[],"mappings":";;;KAQY,gBAAA;;AAAZ;AAyCA;EAQa,MAAA,EA7CJ,OAAA,CAAM,SA0Ed,GAAA,IA7BmC;EAsCpB;AAehB;AA8BA;EAoCa,MAAA,EAhKJ,OAAA,CAAM,SA6Kd,GAbiC,IAAA;;;;;;;;;;KA/HtB,iBAAA;YACD,OAAA,CAAM;;;;;;cAOJ,cAAc,OAAA,CAAM,GAAG;;;;iBAsCpB,QAAA,CAAA,GAAY;KAehB,SAAA;;;;YAID,OAAA,CAAM;;;;;;;;;;;;;;;;;;;;;;;;;cA0BJ,YAAY,OAAA,CAAM,GAAG;;;;;;;;;;;;;;;;;;;cAoCrB,YAAY,OAAA,CAAM,GAAG"}

package/support/context/slots.js

@@ -0,0 +1,115 @@
+"use client";
+
+
+import * as React$1 from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/support/context/slots.tsx
+const SlotContext = React$1.createContext({
+	header: null,
+	footer: null,
+	hasCustomHeader: false,
+	hasCustomFooter: false
+});
+const SlotRegistrationContext = React$1.createContext(null);
+/**
+* Provider for slot-based customization.
+* Allows children to register custom header/footer content.
+*/
+const SlotProvider = ({ children }) => {
+	const [header, setHeader] = React$1.useState(null);
+	const [footer, setFooter] = React$1.useState(null);
+	const registration = React$1.useMemo(() => ({
+		registerHeader: (content) => setHeader(content),
+		registerFooter: (content) => setFooter(content),
+		unregisterHeader: () => setHeader(null),
+		unregisterFooter: () => setFooter(null)
+	}), []);
+	const value = React$1.useMemo(() => ({
+		header,
+		footer,
+		hasCustomHeader: header !== null,
+		hasCustomFooter: footer !== null
+	}), [header, footer]);
+	return /* @__PURE__ */ jsx(SlotRegistrationContext.Provider, {
+		value: registration,
+		children: /* @__PURE__ */ jsx(SlotContext.Provider, {
+			value,
+			children
+		})
+	});
+};
+/**
+* Access slot values (for content component)
+*/
+function useSlots() {
+	return React$1.useContext(SlotContext);
+}
+/**
+* Access slot registration (for slot components)
+*/
+function useSlotRegistration() {
+	return React$1.useContext(SlotRegistrationContext);
+}
+/**
+* Header slot component.
+* Use inside Support.Content to replace the default header.
+*
+* @example
+* <Support.Content>
+*   <Support.Header>
+*     <MyCustomHeader />
+*   </Support.Header>
+*   <Support.Router />
+* </Support.Content>
+*
+* @example
+* // With asChild pattern
+* <Support.Header asChild>
+*   <MyCustomHeader showBackButton />
+* </Support.Header>
+*/
+const HeaderSlot = ({ children, asChild }) => {
+	const registration = useSlotRegistration();
+	React$1.useEffect(() => {
+		if (registration) {
+			registration.registerHeader(children);
+			return () => registration.unregisterHeader();
+		}
+	}, [registration, children]);
+	return null;
+};
+HeaderSlot.displayName = "Support.Header";
+/**
+* Footer slot component.
+* Use inside Support.Content to replace the default footer.
+*
+* @example
+* <Support.Content>
+*   <Support.Router />
+*   <Support.Footer>
+*     <MyCustomFooter />
+*   </Support.Footer>
+* </Support.Content>
+*
+* @example
+* // With asChild pattern
+* <Support.Footer asChild>
+*   <MyCustomFooter showBranding={false} />
+* </Support.Footer>
+*/
+const FooterSlot = ({ children, asChild }) => {
+	const registration = useSlotRegistration();
+	React$1.useEffect(() => {
+		if (registration) {
+			registration.registerFooter(children);
+			return () => registration.unregisterFooter();
+		}
+	}, [registration, children]);
+	return null;
+};
+FooterSlot.displayName = "Support.Footer";
+
+//#endregion
+export { FooterSlot, HeaderSlot, SlotProvider, useSlots };
+//# sourceMappingURL=slots.js.map

package/support/context/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","names":["React","SlotProvider: React.FC<SlotProviderProps>","HeaderSlot: React.FC<SlotProps>","FooterSlot: React.FC<SlotProps>"],"sources":["../../../src/support/context/slots.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\n\n// =============================================================================\n// Slot Types\n// =============================================================================\n\nexport type SlotContextValue = {\n\t/**\n\t * Custom header slot content\n\t */\n\theader: React.ReactNode | null;\n\t/**\n\t * Custom footer slot content\n\t */\n\tfooter: React.ReactNode | null;\n\t/**\n\t * Whether to use the custom header\n\t */\n\thasCustomHeader: boolean;\n\t/**\n\t * Whether to use the custom footer\n\t */\n\thasCustomFooter: boolean;\n};\n\ntype SlotRegistration = {\n\tregisterHeader: (content: React.ReactNode) => void;\n\tregisterFooter: (content: React.ReactNode) => void;\n\tunregisterHeader: () => void;\n\tunregisterFooter: () => void;\n};\n\nconst SlotContext = React.createContext<SlotContextValue>({\n\theader: null,\n\tfooter: null,\n\thasCustomHeader: false,\n\thasCustomFooter: false,\n});\n\nconst SlotRegistrationContext = React.createContext<SlotRegistration | null>(\n\tnull\n);\n\n// =============================================================================\n// Provider\n// =============================================================================\n\nexport type SlotProviderProps = {\n\tchildren: React.ReactNode;\n};\n\n/**\n * Provider for slot-based customization.\n * Allows children to register custom header/footer content.\n */\nexport const SlotProvider: React.FC<SlotProviderProps> = ({ children }) => {\n\tconst [header, setHeader] = React.useState<React.ReactNode | null>(null);\n\tconst [footer, setFooter] = React.useState<React.ReactNode | null>(null);\n\n\tconst registration = React.useMemo<SlotRegistration>(\n\t\t() => ({\n\t\t\tregisterHeader: (content) => setHeader(content),\n\t\t\tregisterFooter: (content) => setFooter(content),\n\t\t\tunregisterHeader: () => setHeader(null),\n\t\t\tunregisterFooter: () => setFooter(null),\n\t\t}),\n\t\t[]\n\t);\n\n\tconst value = React.useMemo<SlotContextValue>(\n\t\t() => ({\n\t\t\theader,\n\t\t\tfooter,\n\t\t\thasCustomHeader: header !== null,\n\t\t\thasCustomFooter: footer !== null,\n\t\t}),\n\t\t[header, footer]\n\t);\n\n\treturn (\n\t\t<SlotRegistrationContext.Provider value={registration}>\n\t\t\t<SlotContext.Provider value={value}>{children}</SlotContext.Provider>\n\t\t</SlotRegistrationContext.Provider>\n\t);\n};\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\n/**\n * Access slot values (for content component)\n */\nexport function useSlots(): SlotContextValue {\n\treturn React.useContext(SlotContext);\n}\n\n/**\n * Access slot registration (for slot components)\n */\nfunction useSlotRegistration(): SlotRegistration | null {\n\treturn React.useContext(SlotRegistrationContext);\n}\n\n// =============================================================================\n// Slot Components\n// =============================================================================\n\nexport type SlotProps = {\n\t/**\n\t * Content to render in the slot.\n\t */\n\tchildren: React.ReactNode;\n\t/**\n\t * When true, renders children directly without a wrapper.\n\t * Useful when you want your component to receive all props.\n\t */\n\tasChild?: boolean;\n};\n\n/**\n * Header slot component.\n * Use inside Support.Content to replace the default header.\n *\n * @example\n * <Support.Content>\n *   <Support.Header>\n *     <MyCustomHeader />\n *   </Support.Header>\n *   <Support.Router />\n * </Support.Content>\n *\n * @example\n * // With asChild pattern\n * <Support.Header asChild>\n *   <MyCustomHeader showBackButton />\n * </Support.Header>\n */\nexport const HeaderSlot: React.FC<SlotProps> = ({ children, asChild }) => {\n\tconst registration = useSlotRegistration();\n\n\tReact.useEffect(() => {\n\t\tif (registration) {\n\t\t\tregistration.registerHeader(children);\n\t\t\treturn () => registration.unregisterHeader();\n\t\t}\n\t}, [registration, children]);\n\n\t// This component doesn't render anything directly\n\t// It registers its children as the header slot\n\treturn null;\n};\n\n(HeaderSlot as React.FC & { displayName?: string }).displayName =\n\t\"Support.Header\";\n\n/**\n * Footer slot component.\n * Use inside Support.Content to replace the default footer.\n *\n * @example\n * <Support.Content>\n *   <Support.Router />\n *   <Support.Footer>\n *     <MyCustomFooter />\n *   </Support.Footer>\n * </Support.Content>\n *\n * @example\n * // With asChild pattern\n * <Support.Footer asChild>\n *   <MyCustomFooter showBranding={false} />\n * </Support.Footer>\n */\nexport const FooterSlot: React.FC<SlotProps> = ({ children, asChild }) => {\n\tconst registration = useSlotRegistration();\n\n\tReact.useEffect(() => {\n\t\tif (registration) {\n\t\t\tregistration.registerFooter(children);\n\t\t\treturn () => registration.unregisterFooter();\n\t\t}\n\t}, [registration, children]);\n\n\t// This component doesn't render anything directly\n\t// It registers its children as the footer slot\n\treturn null;\n};\n\n(FooterSlot as React.FC & { displayName?: string }).displayName =\n\t\"Support.Footer\";\n"],"mappings":";;;;;;;AAkCA,MAAM,cAAcA,QAAM,cAAgC;CACzD,QAAQ;CACR,QAAQ;CACR,iBAAiB;CACjB,iBAAiB;CACjB,CAAC;AAEF,MAAM,0BAA0BA,QAAM,cACrC,KACA;;;;;AAcD,MAAaC,gBAA6C,EAAE,eAAe;CAC1E,MAAM,CAAC,QAAQ,aAAaD,QAAM,SAAiC,KAAK;CACxE,MAAM,CAAC,QAAQ,aAAaA,QAAM,SAAiC,KAAK;CAExE,MAAM,eAAeA,QAAM,eACnB;EACN,iBAAiB,YAAY,UAAU,QAAQ;EAC/C,iBAAiB,YAAY,UAAU,QAAQ;EAC/C,wBAAwB,UAAU,KAAK;EACvC,wBAAwB,UAAU,KAAK;EACvC,GACD,EAAE,CACF;CAED,MAAM,QAAQA,QAAM,eACZ;EACN;EACA;EACA,iBAAiB,WAAW;EAC5B,iBAAiB,WAAW;EAC5B,GACD,CAAC,QAAQ,OAAO,CAChB;AAED,QACC,oBAAC,wBAAwB;EAAS,OAAO;YACxC,oBAAC,YAAY;GAAgB;GAAQ;IAAgC;GACnC;;;;;AAWrC,SAAgB,WAA6B;AAC5C,QAAOA,QAAM,WAAW,YAAY;;;;;AAMrC,SAAS,sBAA+C;AACvD,QAAOA,QAAM,WAAW,wBAAwB;;;;;;;;;;;;;;;;;;;;AAqCjD,MAAaE,cAAmC,EAAE,UAAU,cAAc;CACzE,MAAM,eAAe,qBAAqB;AAE1C,SAAM,gBAAgB;AACrB,MAAI,cAAc;AACjB,gBAAa,eAAe,SAAS;AACrC,gBAAa,aAAa,kBAAkB;;IAE3C,CAAC,cAAc,SAAS,CAAC;AAI5B,QAAO;;AAGR,AAAC,WAAmD,cACnD;;;;;;;;;;;;;;;;;;;AAoBD,MAAaC,cAAmC,EAAE,UAAU,cAAc;CACzE,MAAM,eAAe,qBAAqB;AAE1C,SAAM,gBAAgB;AACrB,MAAI,cAAc;AACjB,gBAAa,eAAe,SAAS;AACrC,gBAAa,aAAa,kBAAkB;;IAE3C,CAAC,cAAc,SAAS,CAAC;AAI5B,QAAO;;AAGR,AAAC,WAAmD,cACnD"}

package/support/context/websocket.d.ts

@@ -23,8 +23,15 @@ type WebSocketProviderProps = {
 declare const WebSocketProvider: React.FC<WebSocketProviderProps>;
 /**
  * Accessor for the support websocket context.
+ * Throws if used outside WebSocketProvider.
  */
 declare const useWebSocket: () => WebSocketContextValue;
+/**
+ * Safe accessor for the support websocket context.
+ * Returns null if used outside WebSocketProvider instead of throwing.
+ * Useful for optional WebSocket usage in hooks that may or may not have the provider.
+ */
+declare const useWebSocketSafe: () => WebSocketContextValue | null;
 //#endregion
-export { type RealtimeEvent, type WebSocketContextValue, WebSocketProvider, type WebSocketProviderProps, useWebSocket };
+export { type RealtimeEvent, type WebSocketContextValue, WebSocketProvider, type WebSocketProviderProps, useWebSocket, useWebSocketSafe };
 //# sourceMappingURL=websocket.d.ts.map

package/support/context/websocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.d.ts","names":[],"sources":["../../../src/support/context/websocket.tsx"],"sourcesContent":[],"mappings":";;;;;;KAYK,qBAAA,GAAwB;KAExB,sBAAA;YACM,KAAA,CAAM;;EAHZ,SAAA,CAAA,EAAA,MAAA;EAEA,SAAA,CAAA,EAAA,MAAA;EAsJQ,KAAA,CAAA,EAAA,MAAA;EA8BA,WAAA,CAAA,EAAA,OAMZ;;;oBAjLkB;;;;;;cA6IN,mBAAmB,KAAA,CAAM,GAAG;;;;cA8B5B,oBAAmB"}
+{"version":3,"file":"websocket.d.ts","names":[],"sources":["../../../src/support/context/websocket.tsx"],"sourcesContent":[],"mappings":";;;;;;KAYK,qBAAA,GAAwB;KAExB,sBAAA;YACM,KAAA,CAAM;;EAHZ,SAAA,CAAA,EAAA,MAAA;EAEA,SAAA,CAAA,EAAA,MAAA;EAsJQ,KAAA,CAAA,EAAA,MAAA;EA+BA,WAAA,CAAA,EAAA,OAMZ;EAOY,SAAA,CAAA,EAAA,GAAA,GAAA,IACgB;;oBA1LV;;;;;;cA6IN,mBAAmB,KAAA,CAAM,GAAG;;;;;cA+B5B,oBAAmB;;;;;;cAanB,wBAAuB"}

package/support/context/websocket.js

@@ -107,13 +107,20 @@ const WebSocketProvider = ({ children, publicKey, websiteId, visitorId, wsUrl, a
 };
 /**
 * Accessor for the support websocket context.
+* Throws if used outside WebSocketProvider.
 */
 const useWebSocket = () => {
 	const context = useContext(WebSocketContext);
 	if (!context) throw new Error("useWebSocket must be used within WebSocketProvider");
 	return context;
 };
+/**
+* Safe accessor for the support websocket context.
+* Returns null if used outside WebSocketProvider instead of throwing.
+* Useful for optional WebSocket usage in hooks that may or may not have the provider.
+*/
+const useWebSocketSafe = () => useContext(WebSocketContext);
 
 //#endregion
-export { WebSocketProvider, useWebSocket };
+export { WebSocketProvider, useWebSocket, useWebSocketSafe };
 //# sourceMappingURL=websocket.js.map

package/support/context/websocket.js.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.js","names":["WebSocketBridge: React.FC<WebSocketBridgeProps>","intervalId: number | null","WebSocketProvider: React.FC<WebSocketProviderProps>"],"sources":["../../../src/support/context/websocket.tsx"],"sourcesContent":["\"use client\";\n\nimport { PRESENCE_PING_INTERVAL_MS } from \"@cossistant/types\";\nimport type React from \"react\";\nimport { createContext, useContext, useEffect, useMemo } from \"react\";\nimport {\n\ttype RealtimeAuthConfig,\n\ttype RealtimeContextValue,\n\tRealtimeProvider,\n\tuseRealtimeConnection,\n} from \"../../realtime\";\n\ntype WebSocketContextValue = RealtimeContextValue;\n\ntype WebSocketProviderProps = {\n\tchildren: React.ReactNode;\n\tpublicKey?: string;\n\twebsiteId?: string;\n\tvisitorId?: string;\n\twsUrl?: string;\n\tautoConnect?: boolean;\n\tonConnect?: () => void;\n\tonDisconnect?: () => void;\n\tonError?: (error: Error) => void;\n};\n\nconst WebSocketContext = createContext<WebSocketContextValue | null>(null);\n\nfunction createVisitorAuthConfig({\n\tvisitorId,\n\twebsiteId,\n\tpublicKey,\n}: Pick<\n\tWebSocketProviderProps,\n\t\"visitorId\" | \"websiteId\" | \"publicKey\"\n>): RealtimeAuthConfig | null {\n\tconst normalizedVisitorId = visitorId?.trim();\n\tif (!normalizedVisitorId) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\tkind: \"visitor\",\n\t\tvisitorId: normalizedVisitorId,\n\t\twebsiteId: websiteId?.trim() || null,\n\t\tpublicKey: publicKey?.trim() || null,\n\t} satisfies RealtimeAuthConfig;\n}\n\ntype WebSocketBridgeProps = {\n\tchildren: React.ReactNode;\n\tonError?: (error: Error) => void;\n};\n\nconst WebSocketBridge: React.FC<WebSocketBridgeProps> = ({\n\tchildren,\n\tonError,\n}) => {\n\tconst connection = useRealtimeConnection();\n\tconst { visitorId, sendRaw, isConnected } = connection;\n\n\tuseEffect(() => {\n\t\tif (typeof window === \"undefined\" || typeof document === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\n\t\tif (!(visitorId && sendRaw)) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst pingMessage = \"presence:ping\";\n\n\t\tconst sendPresencePing = () => {\n\t\t\tif (!isConnected) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tsendRaw(pingMessage);\n\t\t\t} catch (error) {\n\t\t\t\tif (!onError) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst normalizedError =\n\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t? error\n\t\t\t\t\t\t: new Error(\n\t\t\t\t\t\t\t\ttypeof error === \"string\"\n\t\t\t\t\t\t\t\t\t? error\n\t\t\t\t\t\t\t\t\t: \"Unknown presence ping error\"\n\t\t\t\t\t\t\t);\n\n\t\t\t\tif (!normalizedError.message.includes(\"Failed to send presence ping\")) {\n\t\t\t\t\tnormalizedError.message = `Failed to send presence ping: ${normalizedError.message}`;\n\t\t\t\t}\n\n\t\t\t\tonError(normalizedError);\n\t\t\t}\n\t\t};\n\n\t\tlet intervalId: number | null = null;\n\n\t\tconst clearPresenceInterval = () => {\n\t\t\tif (intervalId !== null) {\n\t\t\t\twindow.clearInterval(intervalId);\n\t\t\t\tintervalId = null;\n\t\t\t}\n\t\t};\n\n\t\tconst startPresenceInterval = () => {\n\t\t\tclearPresenceInterval();\n\n\t\t\tif (!isConnected || document.visibilityState === \"hidden\") {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tintervalId = window.setInterval(\n\t\t\t\tsendPresencePing,\n\t\t\t\tPRESENCE_PING_INTERVAL_MS\n\t\t\t);\n\t\t};\n\n\t\tconst handleFocus = () => {\n\t\t\tsendPresencePing();\n\t\t\tstartPresenceInterval();\n\t\t};\n\n\t\tconst handleVisibilityChange = () => {\n\t\t\tif (document.visibilityState === \"hidden\") {\n\t\t\t\tclearPresenceInterval();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tsendPresencePing();\n\t\t\tstartPresenceInterval();\n\t\t};\n\n\t\twindow.addEventListener(\"focus\", handleFocus);\n\t\tdocument.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n\t\tif (isConnected && document.visibilityState !== \"hidden\") {\n\t\t\tsendPresencePing();\n\t\t\tstartPresenceInterval();\n\t\t}\n\n\t\treturn () => {\n\t\t\twindow.removeEventListener(\"focus\", handleFocus);\n\t\t\tdocument.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n\t\t\tclearPresenceInterval();\n\t\t};\n\t}, [isConnected, onError, sendRaw, visitorId]);\n\tconst value = useMemo(() => connection, [connection]);\n\treturn (\n\t\t<WebSocketContext.Provider value={value}>\n\t\t\t{children}\n\t\t</WebSocketContext.Provider>\n\t);\n};\n\n/**\n * Support-specific realtime provider that authenticates visitors and keeps the\n * connection alive with presence pings.\n */\nexport const WebSocketProvider: React.FC<WebSocketProviderProps> = ({\n\tchildren,\n\tpublicKey,\n\twebsiteId,\n\tvisitorId,\n\twsUrl,\n\tautoConnect = true,\n\tonConnect,\n\tonDisconnect,\n\tonError,\n}) => {\n\tconst auth = createVisitorAuthConfig({ publicKey, websiteId, visitorId });\n\n\treturn (\n\t\t<RealtimeProvider\n\t\t\tauth={auth}\n\t\t\tautoConnect={autoConnect}\n\t\t\tonConnect={onConnect}\n\t\t\tonDisconnect={onDisconnect}\n\t\t\tonError={onError}\n\t\t\twsUrl={wsUrl}\n\t\t>\n\t\t\t<WebSocketBridge onError={onError}>{children}</WebSocketBridge>\n\t\t</RealtimeProvider>\n\t);\n};\n\n/**\n * Accessor for the support websocket context.\n */\nexport const useWebSocket = (): WebSocketContextValue => {\n\tconst context = useContext(WebSocketContext);\n\tif (!context) {\n\t\tthrow new Error(\"useWebSocket must be used within WebSocketProvider\");\n\t}\n\treturn context;\n};\n\nexport type { WebSocketContextValue, WebSocketProviderProps };\nexport type { RealtimeEvent } from \"@cossistant/types/realtime-events\";\n"],"mappings":";;;;;;;;;AA0BA,MAAM,mBAAmB,cAA4C,KAAK;AAE1E,SAAS,wBAAwB,EAChC,WACA,WACA,aAI6B;CAC7B,MAAM,sBAAsB,WAAW,MAAM;AAC7C,KAAI,CAAC,oBACJ,QAAO;AAGR,QAAO;EACN,MAAM;EACN,WAAW;EACX,WAAW,WAAW,MAAM,IAAI;EAChC,WAAW,WAAW,MAAM,IAAI;EAChC;;AAQF,MAAMA,mBAAmD,EACxD,UACA,cACK;CACL,MAAM,aAAa,uBAAuB;CAC1C,MAAM,EAAE,WAAW,SAAS,gBAAgB;AAE5C,iBAAgB;AACf,MAAI,OAAO,WAAW,eAAe,OAAO,aAAa,YACxD;AAGD,MAAI,EAAE,aAAa,SAClB;EAGD,MAAM,cAAc;EAEpB,MAAM,yBAAyB;AAC9B,OAAI,CAAC,YACJ;AAGD,OAAI;AACH,YAAQ,YAAY;YACZ,OAAO;AACf,QAAI,CAAC,QACJ;IAGD,MAAM,kBACL,iBAAiB,QACd,QACA,IAAI,MACJ,OAAO,UAAU,WACd,QACA,8BACH;AAEJ,QAAI,CAAC,gBAAgB,QAAQ,SAAS,+BAA+B,CACpE,iBAAgB,UAAU,iCAAiC,gBAAgB;AAG5E,YAAQ,gBAAgB;;;EAI1B,IAAIC,aAA4B;EAEhC,MAAM,8BAA8B;AACnC,OAAI,eAAe,MAAM;AACxB,WAAO,cAAc,WAAW;AAChC,iBAAa;;;EAIf,MAAM,8BAA8B;AACnC,0BAAuB;AAEvB,OAAI,CAAC,eAAe,SAAS,oBAAoB,SAChD;AAGD,gBAAa,OAAO,YACnB,kBACA,0BACA;;EAGF,MAAM,oBAAoB;AACzB,qBAAkB;AAClB,0BAAuB;;EAGxB,MAAM,+BAA+B;AACpC,OAAI,SAAS,oBAAoB,UAAU;AAC1C,2BAAuB;AACvB;;AAGD,qBAAkB;AAClB,0BAAuB;;AAGxB,SAAO,iBAAiB,SAAS,YAAY;AAC7C,WAAS,iBAAiB,oBAAoB,uBAAuB;AAErE,MAAI,eAAe,SAAS,oBAAoB,UAAU;AACzD,qBAAkB;AAClB,0BAAuB;;AAGxB,eAAa;AACZ,UAAO,oBAAoB,SAAS,YAAY;AAChD,YAAS,oBAAoB,oBAAoB,uBAAuB;AACxE,0BAAuB;;IAEtB;EAAC;EAAa;EAAS;EAAS;EAAU,CAAC;CAC9C,MAAM,QAAQ,cAAc,YAAY,CAAC,WAAW,CAAC;AACrD,QACC,oBAAC,iBAAiB;EAAgB;EAChC;GAC0B;;;;;;AAQ9B,MAAaC,qBAAuD,EACnE,UACA,WACA,WACA,WACA,OACA,cAAc,MACd,WACA,cACA,cACK;AAGL,QACC,oBAAC;EACA,MAJW,wBAAwB;GAAE;GAAW;GAAW;GAAW,CAAC;EAK1D;EACF;EACG;EACL;EACF;YAEP,oBAAC;GAAyB;GAAU;IAA2B;GAC7C;;;;;AAOrB,MAAa,qBAA4C;CACxD,MAAM,UAAU,WAAW,iBAAiB;AAC5C,KAAI,CAAC,QACJ,OAAM,IAAI,MAAM,qDAAqD;AAEtE,QAAO"}
+{"version":3,"file":"websocket.js","names":["WebSocketBridge: React.FC<WebSocketBridgeProps>","intervalId: number | null","WebSocketProvider: React.FC<WebSocketProviderProps>"],"sources":["../../../src/support/context/websocket.tsx"],"sourcesContent":["\"use client\";\n\nimport { PRESENCE_PING_INTERVAL_MS } from \"@cossistant/types\";\nimport type React from \"react\";\nimport { createContext, useContext, useEffect, useMemo } from \"react\";\nimport {\n\ttype RealtimeAuthConfig,\n\ttype RealtimeContextValue,\n\tRealtimeProvider,\n\tuseRealtimeConnection,\n} from \"../../realtime\";\n\ntype WebSocketContextValue = RealtimeContextValue;\n\ntype WebSocketProviderProps = {\n\tchildren: React.ReactNode;\n\tpublicKey?: string;\n\twebsiteId?: string;\n\tvisitorId?: string;\n\twsUrl?: string;\n\tautoConnect?: boolean;\n\tonConnect?: () => void;\n\tonDisconnect?: () => void;\n\tonError?: (error: Error) => void;\n};\n\nconst WebSocketContext = createContext<WebSocketContextValue | null>(null);\n\nfunction createVisitorAuthConfig({\n\tvisitorId,\n\twebsiteId,\n\tpublicKey,\n}: Pick<\n\tWebSocketProviderProps,\n\t\"visitorId\" | \"websiteId\" | \"publicKey\"\n>): RealtimeAuthConfig | null {\n\tconst normalizedVisitorId = visitorId?.trim();\n\tif (!normalizedVisitorId) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\tkind: \"visitor\",\n\t\tvisitorId: normalizedVisitorId,\n\t\twebsiteId: websiteId?.trim() || null,\n\t\tpublicKey: publicKey?.trim() || null,\n\t} satisfies RealtimeAuthConfig;\n}\n\ntype WebSocketBridgeProps = {\n\tchildren: React.ReactNode;\n\tonError?: (error: Error) => void;\n};\n\nconst WebSocketBridge: React.FC<WebSocketBridgeProps> = ({\n\tchildren,\n\tonError,\n}) => {\n\tconst connection = useRealtimeConnection();\n\tconst { visitorId, sendRaw, isConnected } = connection;\n\n\tuseEffect(() => {\n\t\tif (typeof window === \"undefined\" || typeof document === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\n\t\tif (!(visitorId && sendRaw)) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst pingMessage = \"presence:ping\";\n\n\t\tconst sendPresencePing = () => {\n\t\t\tif (!isConnected) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tsendRaw(pingMessage);\n\t\t\t} catch (error) {\n\t\t\t\tif (!onError) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst normalizedError =\n\t\t\t\t\terror instanceof Error\n\t\t\t\t\t\t? error\n\t\t\t\t\t\t: new Error(\n\t\t\t\t\t\t\t\ttypeof error === \"string\"\n\t\t\t\t\t\t\t\t\t? error\n\t\t\t\t\t\t\t\t\t: \"Unknown presence ping error\"\n\t\t\t\t\t\t\t);\n\n\t\t\t\tif (!normalizedError.message.includes(\"Failed to send presence ping\")) {\n\t\t\t\t\tnormalizedError.message = `Failed to send presence ping: ${normalizedError.message}`;\n\t\t\t\t}\n\n\t\t\t\tonError(normalizedError);\n\t\t\t}\n\t\t};\n\n\t\tlet intervalId: number | null = null;\n\n\t\tconst clearPresenceInterval = () => {\n\t\t\tif (intervalId !== null) {\n\t\t\t\twindow.clearInterval(intervalId);\n\t\t\t\tintervalId = null;\n\t\t\t}\n\t\t};\n\n\t\tconst startPresenceInterval = () => {\n\t\t\tclearPresenceInterval();\n\n\t\t\tif (!isConnected || document.visibilityState === \"hidden\") {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tintervalId = window.setInterval(\n\t\t\t\tsendPresencePing,\n\t\t\t\tPRESENCE_PING_INTERVAL_MS\n\t\t\t);\n\t\t};\n\n\t\tconst handleFocus = () => {\n\t\t\tsendPresencePing();\n\t\t\tstartPresenceInterval();\n\t\t};\n\n\t\tconst handleVisibilityChange = () => {\n\t\t\tif (document.visibilityState === \"hidden\") {\n\t\t\t\tclearPresenceInterval();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tsendPresencePing();\n\t\t\tstartPresenceInterval();\n\t\t};\n\n\t\twindow.addEventListener(\"focus\", handleFocus);\n\t\tdocument.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n\t\tif (isConnected && document.visibilityState !== \"hidden\") {\n\t\t\tsendPresencePing();\n\t\t\tstartPresenceInterval();\n\t\t}\n\n\t\treturn () => {\n\t\t\twindow.removeEventListener(\"focus\", handleFocus);\n\t\t\tdocument.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n\t\t\tclearPresenceInterval();\n\t\t};\n\t}, [isConnected, onError, sendRaw, visitorId]);\n\tconst value = useMemo(() => connection, [connection]);\n\treturn (\n\t\t<WebSocketContext.Provider value={value}>\n\t\t\t{children}\n\t\t</WebSocketContext.Provider>\n\t);\n};\n\n/**\n * Support-specific realtime provider that authenticates visitors and keeps the\n * connection alive with presence pings.\n */\nexport const WebSocketProvider: React.FC<WebSocketProviderProps> = ({\n\tchildren,\n\tpublicKey,\n\twebsiteId,\n\tvisitorId,\n\twsUrl,\n\tautoConnect = true,\n\tonConnect,\n\tonDisconnect,\n\tonError,\n}) => {\n\tconst auth = createVisitorAuthConfig({ publicKey, websiteId, visitorId });\n\n\treturn (\n\t\t<RealtimeProvider\n\t\t\tauth={auth}\n\t\t\tautoConnect={autoConnect}\n\t\t\tonConnect={onConnect}\n\t\t\tonDisconnect={onDisconnect}\n\t\t\tonError={onError}\n\t\t\twsUrl={wsUrl}\n\t\t>\n\t\t\t<WebSocketBridge onError={onError}>{children}</WebSocketBridge>\n\t\t</RealtimeProvider>\n\t);\n};\n\n/**\n * Accessor for the support websocket context.\n * Throws if used outside WebSocketProvider.\n */\nexport const useWebSocket = (): WebSocketContextValue => {\n\tconst context = useContext(WebSocketContext);\n\tif (!context) {\n\t\tthrow new Error(\"useWebSocket must be used within WebSocketProvider\");\n\t}\n\treturn context;\n};\n\n/**\n * Safe accessor for the support websocket context.\n * Returns null if used outside WebSocketProvider instead of throwing.\n * Useful for optional WebSocket usage in hooks that may or may not have the provider.\n */\nexport const useWebSocketSafe = (): WebSocketContextValue | null =>\n\tuseContext(WebSocketContext);\n\nexport type { WebSocketContextValue, WebSocketProviderProps };\nexport type { RealtimeEvent } from \"@cossistant/types/realtime-events\";\n"],"mappings":";;;;;;;;;AA0BA,MAAM,mBAAmB,cAA4C,KAAK;AAE1E,SAAS,wBAAwB,EAChC,WACA,WACA,aAI6B;CAC7B,MAAM,sBAAsB,WAAW,MAAM;AAC7C,KAAI,CAAC,oBACJ,QAAO;AAGR,QAAO;EACN,MAAM;EACN,WAAW;EACX,WAAW,WAAW,MAAM,IAAI;EAChC,WAAW,WAAW,MAAM,IAAI;EAChC;;AAQF,MAAMA,mBAAmD,EACxD,UACA,cACK;CACL,MAAM,aAAa,uBAAuB;CAC1C,MAAM,EAAE,WAAW,SAAS,gBAAgB;AAE5C,iBAAgB;AACf,MAAI,OAAO,WAAW,eAAe,OAAO,aAAa,YACxD;AAGD,MAAI,EAAE,aAAa,SAClB;EAGD,MAAM,cAAc;EAEpB,MAAM,yBAAyB;AAC9B,OAAI,CAAC,YACJ;AAGD,OAAI;AACH,YAAQ,YAAY;YACZ,OAAO;AACf,QAAI,CAAC,QACJ;IAGD,MAAM,kBACL,iBAAiB,QACd,QACA,IAAI,MACJ,OAAO,UAAU,WACd,QACA,8BACH;AAEJ,QAAI,CAAC,gBAAgB,QAAQ,SAAS,+BAA+B,CACpE,iBAAgB,UAAU,iCAAiC,gBAAgB;AAG5E,YAAQ,gBAAgB;;;EAI1B,IAAIC,aAA4B;EAEhC,MAAM,8BAA8B;AACnC,OAAI,eAAe,MAAM;AACxB,WAAO,cAAc,WAAW;AAChC,iBAAa;;;EAIf,MAAM,8BAA8B;AACnC,0BAAuB;AAEvB,OAAI,CAAC,eAAe,SAAS,oBAAoB,SAChD;AAGD,gBAAa,OAAO,YACnB,kBACA,0BACA;;EAGF,MAAM,oBAAoB;AACzB,qBAAkB;AAClB,0BAAuB;;EAGxB,MAAM,+BAA+B;AACpC,OAAI,SAAS,oBAAoB,UAAU;AAC1C,2BAAuB;AACvB;;AAGD,qBAAkB;AAClB,0BAAuB;;AAGxB,SAAO,iBAAiB,SAAS,YAAY;AAC7C,WAAS,iBAAiB,oBAAoB,uBAAuB;AAErE,MAAI,eAAe,SAAS,oBAAoB,UAAU;AACzD,qBAAkB;AAClB,0BAAuB;;AAGxB,eAAa;AACZ,UAAO,oBAAoB,SAAS,YAAY;AAChD,YAAS,oBAAoB,oBAAoB,uBAAuB;AACxE,0BAAuB;;IAEtB;EAAC;EAAa;EAAS;EAAS;EAAU,CAAC;CAC9C,MAAM,QAAQ,cAAc,YAAY,CAAC,WAAW,CAAC;AACrD,QACC,oBAAC,iBAAiB;EAAgB;EAChC;GAC0B;;;;;;AAQ9B,MAAaC,qBAAuD,EACnE,UACA,WACA,WACA,WACA,OACA,cAAc,MACd,WACA,cACA,cACK;AAGL,QACC,oBAAC;EACA,MAJW,wBAAwB;GAAE;GAAW;GAAW;GAAW,CAAC;EAK1D;EACF;EACG;EACL;EACF;YAEP,oBAAC;GAAyB;GAAU;IAA2B;GAC7C;;;;;;AAQrB,MAAa,qBAA4C;CACxD,MAAM,UAAU,WAAW,iBAAiB;AAC5C,KAAI,CAAC,QACJ,OAAM,IAAI,MAAM,qDAAqD;AAEtE,QAAO;;;;;;;AAQR,MAAa,yBACZ,WAAW,iBAAiB"}

package/support/index.d.ts

@@ -1,74 +1,259 @@
 import { SupportLocale, SupportTextContentOverrides } from "./text/locales/keys.js";
-import { CustomPage } from "./router.js";
+import { CustomPage, PageProps } from "./router.js";
+import { SlotProps } from "./context/slots.js";
+import { ConversationEndEvent, ConversationStartEvent, ErrorEvent, MessageReceivedEvent, MessageSentEvent, SupportEvent, SupportEventCallbacks, SupportEventType, useSupportEventEmitter, useSupportEvents } from "./context/events.js";
+import { SupportHandle, useSupportHandle } from "./context/handle.js";
 import { Text, useSupportText } from "./text/index.js";
-import { BubbleSlotProps, ContainerSlotProps, RouterSlotProps } from "./types.js";
+import { Align, CollisionPadding, ContentProps, RootProps, Side, TriggerRenderProps } from "./types.js";
 import { CoButton } from "./components/button.js";
 import { Header } from "./components/header.js";
 import { WebSocketContextValue, WebSocketProvider, useWebSocket } from "./context/websocket.js";
 import { useSupportConfig, useSupportNavigation, useSupportStore } from "./store/support-store.js";
 import "./store/index.js";
-import React, { ReactElement } from "react";
-import { DefaultRoutes, NavigationState, RouteRegistry, SupportPage } from "@cossistant/core";
+import * as React$1 from "react";
+import * as _cossistant_core0 from "@cossistant/core";
+import { DefaultRoutes, NavigationState, RouteRegistry, SupportPage as SupportPageType } from "@cossistant/core";
 import { DefaultMessage } from "@cossistant/types";
 
 //#region src/support/index.d.ts
 type SupportProps<Locale extends string = SupportLocale> = {
+  /**
+   * Additional CSS classes for the root wrapper.
+   */
   className?: string;
-  position?: "top" | "bottom";
-  align?: "right" | "left";
-  positioning?: "fixed" | "absolute";
+  /**
+   * Which side of the trigger to place the content.
+   * @default "top"
+   */
+  side?: Side;
+  /**
+   * Alignment along the side axis.
+   * @default "end"
+   */
+  align?: Align;
+  /**
+   * Distance (in pixels) between the trigger and the content.
+   * @default 16
+   */
+  sideOffset?: number;
+  /**
+   * Enable automatic collision avoidance.
+   * When true, the content repositions to stay within the viewport.
+   * @default true
+   */
+  avoidCollisions?: boolean;
+  /**
+   * Padding from viewport edges when avoiding collisions.
+   * @default 8
+   */
+  collisionPadding?: CollisionPadding;
+  /**
+   * Granular className overrides for specific parts.
+   */
+  classNames?: {
+    trigger?: string;
+    content?: string;
+  };
+  /**
+   * Force a specific theme. Omit for automatic detection.
+   */
+  theme?: "light" | "dark";
+  /**
+   * Controlled open state.
+   * When provided, the widget operates in controlled mode.
+   * Use with `onOpenChange` to manage state externally.
+   */
+  open?: boolean;
+  /**
+   * Callback fired when the open state should change.
+   * Use with `open` prop for controlled mode.
+   *
+   * @example
+   * const [isOpen, setIsOpen] = useState(false);
+   * <Support open={isOpen} onOpenChange={setIsOpen} />
+   */
+  onOpenChange?: (open: boolean) => void;
+  /**
+   * Whether the widget should open automatically on mount (uncontrolled mode).
+   * Ignored when `open` prop is provided (controlled mode).
+   * @default false
+   */
+  defaultOpen?: boolean;
+  /**
+   * Quick reply options displayed to users.
+   */
   quickOptions?: string[];
+  /**
+   * Custom welcome messages shown before a conversation starts.
+   */
   defaultMessages?: DefaultMessage[];
-  defaultOpen?: boolean;
+  /**
+   * Locale string for widget translations.
+   */
   locale?: Locale;
+  /**
+   * Custom text content overrides for internationalization.
+   */
   content?: SupportTextContentOverrides<Locale>;
-  theme?: "light" | "dark";
-  slots?: {
-    bubble?: React.ComponentType<BubbleSlotProps>;
-    container?: React.ComponentType<ContainerSlotProps>;
-    router?: React.ComponentType<RouterSlotProps>;
-  };
-  classNames?: {
-    root?: string;
-    bubble?: string;
-    container?: string;
-  };
+  /**
+   * Custom pages to add to the router.
+   */
   customPages?: CustomPage[];
-  children?: React.ReactNode;
+  /**
+   * Called when a new conversation is started.
+   */
+  onConversationStart?: (event: ConversationStartEvent) => void;
+  /**
+   * Called when a conversation ends (resolved, closed, etc.).
+   */
+  onConversationEnd?: (event: ConversationEndEvent) => void;
+  /**
+   * Called when the visitor sends a message.
+   */
+  onMessageSent?: (event: MessageSentEvent) => void;
+  /**
+   * Called when a message is received from an agent (human or AI).
+   */
+  onMessageReceived?: (event: MessageReceivedEvent) => void;
+  /**
+   * Called when an error occurs within the widget.
+   */
+  onError?: (event: ErrorEvent) => void;
+  /**
+   * Children for composition. Can include:
+   * - <Support.Trigger> for custom trigger
+   * - <Support.Content> for custom content positioning
+   * - <Support.Page> components for custom routes
+   */
+  children?: React$1.ReactNode;
+};
+type SupportTriggerProps = Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, "children"> & {
+  /**
+   * Content to render inside the trigger.
+   * Can be static content or a function receiving render props.
+   */
+  children?: React$1.ReactNode | ((props: TriggerRenderProps) => React$1.ReactNode);
+  /**
+   * When true, renders children directly with all props passed through.
+   */
+  asChild?: boolean;
+  className?: string;
+};
+type SupportContentProps = {
+  className?: string;
+  /**
+   * Which side of the trigger to place the content.
+   * @default "top"
+   */
+  side?: Side;
+  /**
+   * Alignment along the side axis.
+   * @default "end"
+   */
+  align?: Align;
+  /**
+   * Distance (in pixels) between the trigger and the content.
+   * @default 16
+   */
+  sideOffset?: number;
+  /**
+   * Enable automatic collision avoidance.
+   * When true, the content repositions to stay within the viewport.
+   * @default true
+   */
+  avoidCollisions?: boolean;
+  /**
+   * Padding from viewport edges when avoiding collisions.
+   * @default 8
+   */
+  collisionPadding?: CollisionPadding;
+  children?: React$1.ReactNode;
+};
+type SupportRouterProps = {
+  /**
+   * Custom pages to add alongside built-in pages.
+   */
+  customPages?: CustomPage[];
+  /**
+   * Page components to register.
+   */
+  children?: React$1.ReactNode;
+};
+type SupportPageProps<K extends keyof _cossistant_core0.RouteRegistry = keyof _cossistant_core0.RouteRegistry> = {
+  name: K;
+  component: React$1.ComponentType<{
+    params?: _cossistant_core0.RouteRegistry[K];
+  }>;
+};
+type SupportRootProps = {
+  /**
+   * Controlled open state.
+   * When provided, the widget operates in controlled mode.
+   */
+  open?: boolean;
+  /**
+   * Callback fired when the open state should change.
+   * Use with `open` prop for controlled mode.
+   */
+  onOpenChange?: (open: boolean) => void;
+  /**
+   * Whether the widget should open automatically (uncontrolled mode).
+   * Ignored when `open` prop is provided.
+   * @default false
+   */
+  defaultOpen?: boolean;
+  /**
+   * Force a specific theme.
+   */
+  theme?: "light" | "dark";
+  /**
+   * Additional CSS classes.
+   */
+  className?: string;
+  /**
+   * Called when a new conversation is started.
+   */
+  onConversationStart?: (event: ConversationStartEvent) => void;
+  /**
+   * Called when a conversation ends.
+   */
+  onConversationEnd?: (event: ConversationEndEvent) => void;
+  /**
+   * Called when the visitor sends a message.
+   */
+  onMessageSent?: (event: MessageSentEvent) => void;
+  /**
+   * Called when a message is received from an agent.
+   */
+  onMessageReceived?: (event: MessageReceivedEvent) => void;
+  /**
+   * Called when an error occurs.
+   */
+  onError?: (event: ErrorEvent) => void;
+  children: React$1.ReactNode;
+};
+declare const Support: (<Locale extends string = SupportLocale>(props: SupportProps<Locale> & {
+  ref?: React$1.Ref<SupportHandle>;
+}) => React$1.ReactElement | null) & {
+  Root: React$1.ForwardRefExoticComponent<SupportRootProps & React$1.RefAttributes<SupportHandle>>;
+  Trigger: React$1.ForwardRefExoticComponent<Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, "children"> & {
+    /**
+     * Content to render inside the trigger.
+     * Can be static content or a function receiving render props.
+     */
+    children?: React$1.ReactNode | ((props: TriggerRenderProps) => React$1.ReactNode);
+    /**
+     * When true, renders children directly with all props passed through.
+     */
+    asChild?: boolean;
+    className?: string;
+  } & React$1.RefAttributes<HTMLButtonElement>>;
+  Content: React$1.FC<SupportContentProps>;
+  Router: React$1.FC<SupportRouterProps>;
+  Page: <K extends keyof _cossistant_core0.RouteRegistry>(_props: PageProps<K>) => null;
+  Header: React$1.FC<SlotProps>;
+  Footer: React$1.FC<SlotProps>;
 };
-/**
- * Complete support widget with chat, routing, and real-time features.
- *
- * @example
- * // Zero config
- * <Support />
- *
- * @example
- * // With customization and custom pages
- * <Support
- *   theme="dark"
- *   classNames={{ bubble: "bg-purple-600" }}
- *   customPages={[
- *     { name: "FAQ", component: FAQPage }
- *   ]}
- * />
- */
-declare function Support<Locale extends string = SupportLocale>({
-  className,
-  position,
-  align,
-  positioning,
-  quickOptions,
-  defaultMessages,
-  defaultOpen,
-  locale,
-  content,
-  theme,
-  slots,
-  classNames,
-  customPages,
-  children
-}: SupportProps<Locale>): ReactElement | null;
 //#endregion
-export { type BubbleSlotProps, CoButton as Button, type ContainerSlotProps, type CustomPage, type DefaultRoutes, Header, type NavigationState, type RouteRegistry, type RouterSlotProps, Support, Support as default, type SupportLocale, type SupportPage, SupportProps, type SupportTextContentOverrides, Text, type WebSocketContextValue, WebSocketProvider, useSupportConfig, useSupportNavigation, useSupportStore, useSupportText, useWebSocket };
+export { type Align, CoButton as Button, type CollisionPadding, type ContentProps, type ConversationEndEvent, type ConversationStartEvent, type CustomPage, type DefaultRoutes, type ErrorEvent, Header, type MessageReceivedEvent, type MessageSentEvent, type NavigationState, type RootProps, type RouteRegistry, type Side, Support, Support as default, SupportContentProps, type SupportEvent, type SupportEventCallbacks, type SupportEventType, type SupportHandle, type SupportLocale, SupportPageProps, type SupportPageType, SupportProps, SupportRootProps, SupportRouterProps, type SupportTextContentOverrides, SupportTriggerProps, Text, type TriggerRenderProps, type WebSocketContextValue, WebSocketProvider, useSupportConfig, useSupportEventEmitter, useSupportEvents, useSupportHandle, useSupportNavigation, useSupportStore, useSupportText, useWebSocket };
 //# sourceMappingURL=index.d.ts.map

package/support/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/support/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;KAmBY,qCAAqC;;;;;;oBAO9B;;EAPP,MAAA,CAAA,EASF,MATc;EAAyB,OAAA,CAAA,EAUtC,2BAVsC,CAUV,MAVU,CAAA;EAO9B,KAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAET,KAAA,CAAA,EAAA;IAC6B,MAAA,CAAA,EAO5B,KAAA,CAAM,aAPsB,CAOR,eAPQ,CAAA;IAA5B,SAAA,CAAA,EAQG,KAAA,CAAM,aART,CAQuB,kBARvB,CAAA;IAOoB,MAAA,CAAA,EAEpB,KAAA,CAAM,aAFc,CAEA,eAFA,CAAA;EAApB,CAAA;EACuB,UAAA,CAAA,EAAA;IAAd,IAAA,CAAA,EAAA,MAAA;IACW,MAAA,CAAA,EAAA,MAAA;IAAd,SAAA,CAAA,EAAA,MAAA;EAWF,CAAA;EAEH,WAAM,CAAA,EAFH,UAEG,EAAA;EAAS,QAAA,CAAA,EAAf,KAAA,CAAM,SAAS;AAoB3B,CAAA;;;;;;;;;;;;;;;;;;AAe0B,iBAfV,OAeU,CAAA,eAAA,MAAA,GAfsB,aAetB,CAAA,CAAA;EAAA,SAAA;EAAA,QAAA;EAAA,KAAA;EAAA,WAAA;EAAA,YAAA;EAAA,eAAA;EAAA,WAAA;EAAA,MAAA;EAAA,OAAA;EAAA,KAAA;EAAA,KAAA;EAAA,UAAA;EAAA,WAAA;EAAA;AAAA,CAAA,EAAvB,YAAuB,CAAV,MAAU,CAAA,CAAA,EAAA,YAAA,GAAA,IAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/support/index.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;KAsCY,qCAAqC;;;;;;;;;SAUzC;EAVI;;;;EAmCQ,KAAA,CAAA,EAnBX,KAmBW;EA+CD;;;;EAeJ,UAAA,CAAA,EAAA,MAAA;EASgB;;;;;EA4BnB,eAAM,CAAA,EAAA,OAAA;EAAS;AA6M3B;;;EAAkC,gBAAA,CAAA,EAhTd,gBAgTc;EAQtB;;;EAAiE,UAAA,CAAA,EAAA;IAsCjE,OAAA,CAAA,EAAA,MAAA;IAMJ,OAAA,CAAA,EAAA,MAAA;EAKC,CAAA;EAgBW;;;EA4CR,KAAA,CAAA,EAAA,OAAA,GAAA,MAAkB;EAsClB;;;;;EAMwC,IAAA,CAAA,EAAA,OAAA;EADxC;;AAuBZ;;;;;;EA6CW,YAAM,CAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAAA,IAAA;EAAS;AA2F1B;;;;EAtUiD,WAAA,CAAA,EAAA,OAAA;EAAV;;;;;;;oBA1PpB;;;;EAyQ2C,MAAM,CAAA,EApQ1D,MAoQ0D;;;;YA/PzD,4BAA4B;;;;gBAKxB;;;;gCASgB;;;;8BAKF;;;;0BAKJ;;;;8BAKI;;;;oBAKV;;;;;;;aAQP,OAAA,CAAM;;KA6MN,mBAAA,GAAsB,KACjC,OAAA,CAAM,qBAAqB;;;;;aAOhB,OAAA,CAAM,qBAAqB,uBAAuB,OAAA,CAAM;;;;;;;KAsCxD,mBAAA;;;;;;SAMJ;;;;;UAKC;;;;;;;;;;;;;;;;qBAgBW;aACR,OAAA,CAAM;;KA2CN,kBAAA;;;;gBAIG;;;;aAIH,OAAA,CAAM;;KA8BN,iCAAgB,iBAAA,CAEO,sBAAa,iBAAA,CAAoC;QAE7E;aACK,OAAA,CAAM;aADV,iBAAA,CAE8B,aAAA,CAAc;;;KAsBxC,gBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA4BmB;;;;8BAIF;;;;0BAIJ;;;;8BAII;;;;oBAIV;YACR,OAAA,CAAM;;cA2FJ,mCAxUS,sBAEd,aAAa;QAAkB,OAAA,CAAM,IAAI;MAC5C,OAAA,CAAM;;;;;;;eAcC,OAAA,CAAM,qBAAqB,uBAAuB,OAAA,CAAM"}