@evelan/jexity-widget 0.3.0 → 0.4.0

package/dist/types/features/chat/components/ChatInput.d.ts

@@ -1,3 +1,14 @@
-/** Text input + send button. Demo mode: echoes user messages with a 1s bot delay. */
-export declare function ChatInput(): import("preact").JSX.Element;
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
+interface ChatInputProps {
+    sessionId: Id<'contactSessions'> | null;
+    visitorId: string | null;
+    isLoading: boolean;
+    ensureSession: () => Promise<{
+        sessionId: Id<'contactSessions'>;
+        visitorId: string;
+    } | null>;
+}
+/** Text input + send button. Creates session lazily on first send. */
+export declare function ChatInput({ sessionId, visitorId, isLoading, ensureSession }: ChatInputProps): import("preact").JSX.Element;
+export {};
 //# sourceMappingURL=ChatInput.d.ts.map

package/dist/types/features/chat/components/ChatInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatInput.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/ChatInput.tsx"],"names":[],"mappings":"AAMA,qFAAqF;AACrF,wBAAgB,SAAS,iCAkDxB"}
+{"version":3,"file":"ChatInput.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/ChatInput.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,UAAU,cAAc;IACtB,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,aAAa,EAAE,MAAM,OAAO,CAAC;QAAE,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;CAC7F;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,cAAc,gCAgD3F"}

package/dist/types/features/chat/components/ChatScreen.d.ts

@@ -1,8 +1,11 @@
 interface ChatScreenProps {
-    /** Initial bot greeting — seeded once when chat is first opened. */
     greeting: string;
+    orgSlug: string;
 }
-/** Full chat conversation screen — orchestrates message list and input. */
-export declare function ChatScreen({ greeting }: ChatScreenProps): import("preact").JSX.Element;
+/**
+ * Chat screen — renders immediately with greeting + input.
+ * Session is created lazily on first send (no loading spinner on open).
+ */
+export declare function ChatScreen({ greeting, orgSlug }: ChatScreenProps): import("preact").JSX.Element;
 export {};
 //# sourceMappingURL=ChatScreen.d.ts.map

package/dist/types/features/chat/components/ChatScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatScreen.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/ChatScreen.tsx"],"names":[],"mappings":"AAKA,UAAU,eAAe;IACvB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,eAAe,gCAevD"}
+{"version":3,"file":"ChatScreen.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/ChatScreen.tsx"],"names":[],"mappings":"AAIA,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,eAAe,gCAkBhE"}

package/dist/types/features/chat/components/MessageList.d.ts

@@ -1,3 +1,10 @@
-/** Scrollable message area — auto-scrolls to the latest message. */
-export declare function MessageList(): import("preact").JSX.Element;
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
+interface MessageListProps {
+    sessionId: Id<'contactSessions'> | null;
+    visitorId: string | null;
+    greeting: string;
+}
+/** Scrollable message area — subscribes to Convex once a session exists. */
+export declare function MessageList({ sessionId, visitorId, greeting }: MessageListProps): import("preact").JSX.Element;
+export {};
 //# sourceMappingURL=MessageList.d.ts.map

package/dist/types/features/chat/components/MessageList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/MessageList.tsx"],"names":[],"mappings":"AAMA,oEAAoE;AACpE,wBAAgB,WAAW,iCAkB1B"}
+{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/components/MessageList.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,EAAO,MAAM,2CAA2C,CAAA;AAExE,UAAU,gBAAgB;IACxB,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,gBAAgB,gCA8B/E"}

package/dist/types/features/chat/hooks/useConvexSession.d.ts

@@ -0,0 +1,22 @@
+import type { Id } from '@repo/backend/convex/_generated/dataModel';
+interface SessionResult {
+    sessionId: Id<'contactSessions'>;
+    visitorId: string;
+}
+interface ConvexSession {
+    sessionId: Id<'contactSessions'> | null;
+    visitorId: string | null;
+    isLoading: boolean;
+    /** Call before the first send — creates/resumes a Convex session lazily. */
+    ensureSession: () => Promise<SessionResult | null>;
+}
+/**
+ * Lazy session hook — does NOT create a session on mount.
+ * Call `ensureSession()` when the visitor sends their first message.
+ *
+ * Uses a ref to track the resolved session, avoiding stale closures
+ * and preventing duplicate mutations on rapid double-sends.
+ */
+export declare function useConvexSession(orgSlug: string): ConvexSession;
+export {};
+//# sourceMappingURL=useConvexSession.d.ts.map

package/dist/types/features/chat/hooks/useConvexSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConvexSession.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/hooks/useConvexSession.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2CAA2C,CAAA;AAEnE,UAAU,aAAa;IACrB,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,UAAU,aAAa;IACrB,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;CACnD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAmC/D"}

package/dist/types/features/chat/lib/chat.d.ts

@@ -1,13 +1,3 @@
-export interface Message {
-    id: number;
-    text: string;
-    sender: 'user' | 'bot';
-}
-/** Demo messages — replaced in Phase 2 with Convex subscription */
-export declare const messages: import("@preact/signals").Signal<Message[]>;
-export declare const isTyping: import("@preact/signals").Signal<boolean>;
-/** Convex session ID — populated in Phase 2 */
-export declare const sessionId: import("@preact/signals").Signal<string | null>;
-/** Reset all chat state for a new conversation. */
+/** Reset chat state for a new conversation. */
 export declare function clearChat(): void;
 //# sourceMappingURL=chat.d.ts.map

package/dist/types/features/chat/lib/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/lib/chat.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,KAAK,CAAA;CACvB;AAED,mEAAmE;AACnE,eAAO,MAAM,QAAQ,6CAAwB,CAAA;AAC7C,eAAO,MAAM,QAAQ,2CAAgB,CAAA;AACrC,+CAA+C;AAC/C,eAAO,MAAM,SAAS,iDAA8B,CAAA;AAEpD,mDAAmD;AACnD,wBAAgB,SAAS,IAAI,IAAI,CAIhC"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../../../src/features/chat/lib/chat.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,wBAAgB,SAAS,IAAI,IAAI,CAGhC"}

package/dist/types/lib/convex-url.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Convex URL normalisation helpers.
+ *
+ * VITE_CONVEX_URL accepts either Convex URL format:
+ *   https://<name>.convex.cloud   — WebSocket / REST API base
+ *   https://<name>.convex.site    — HTTP Actions base
+ *
+ * These helpers normalise whichever format is provided to the one needed
+ * by each consumer, so only a single env var is required.
+ *
+ * The \b word-boundary in each regex prevents partial matches if the
+ * hostname ever contains the pattern mid-string.
+ */
+/** Returns the .convex.cloud URL regardless of which format is provided. */
+export declare function toConvexCloudUrl(url: string): string;
+/** Returns the .convex.site URL regardless of which format is provided. */
+export declare function toConvexSiteUrl(url: string): string;
+//# sourceMappingURL=convex-url.d.ts.map

package/dist/types/lib/convex-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex-url.d.ts","sourceRoot":"","sources":["../../../src/lib/convex-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/types/lib/widget-config.d.ts

@@ -0,0 +1,61 @@
+import type { JexityChatOptions } from '../types';
+import type { WidgetLocale } from '../i18n/index';
+/**
+ * Fully-resolved widget configuration — produced by merging embed-script
+ * options with the Convex remote config (embed options take precedence).
+ *
+ * All fields with defaults are non-optional so consumers never need ?? chains.
+ */
+export interface ResolvedWidgetConfig {
+    title: string;
+    greeting: string;
+    locale: string | undefined;
+    position: JexityChatOptions['position'];
+    colorScheme: JexityChatOptions['colorScheme'];
+    hideBranding: boolean;
+    triggerIcon: NonNullable<JexityChatOptions['triggerIcon']>;
+    triggerRadius: NonNullable<JexityChatOptions['triggerRadius']>;
+    triggerLabel: string;
+    primaryColor: string | undefined;
+    accentColor: string | undefined;
+    fontFamily: string | undefined;
+    fontSize: number | undefined;
+    borderRadius: string | undefined;
+    windowWidth: number | undefined;
+    windowHeight: number | undefined;
+}
+/**
+ * Merges embed-script options with the remote Convex config.
+ * Embed-script values always take precedence; remote config fills the gaps.
+ *
+ * Centralising the merge here means AppShell never needs ?? chains,
+ * and any new remote config field has exactly one place to wire it in.
+ */
+export declare function mergeWidgetConfig(options: JexityChatOptions, remote: RemoteConfig | null): ResolvedWidgetConfig;
+/**
+ * Shape of the response from the public GET /widget/config endpoint.
+ *
+ * Uses Pick<JexityChatOptions, ...> so that field types stay in sync with
+ * the embed-script options automatically — no need to duplicate type definitions.
+ *
+ * Extra fields (primaryColor, title, welcomeMessage) come from the database
+ * and have no equivalent in JexityChatOptions, so they're defined separately.
+ */
+export type RemoteConfig = Pick<JexityChatOptions, 'position' | 'colorScheme' | 'hideBranding' | 'accentColor' | 'fontFamily' | 'fontSize' | 'borderRadius' | 'windowWidth' | 'windowHeight' | 'triggerIcon' | 'triggerRadius' | 'triggerLabel'> & {
+    primaryColor: string;
+    title: string;
+    welcomeMessage: string;
+    locale?: WidgetLocale;
+};
+/**
+ * Fetches the widget's remote configuration from the Convex HTTP endpoint.
+ *
+ * @param siteUrl  The .convex.site base URL (HTTP Actions domain).
+ * @param orgSlug  The organisation slug embedded in the script tag.
+ * @param signal   AbortSignal to cancel the request on component unmount.
+ *
+ * @returns The parsed config, or null if the org is not found (404) or the
+ *          server returns any non-OK status.
+ */
+export declare function fetchRemoteConfig(siteUrl: string, orgSlug: string, signal: AbortSignal): Promise<RemoteConfig | null>;
+//# sourceMappingURL=widget-config.d.ts.map

package/dist/types/lib/widget-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-config.d.ts","sourceRoot":"","sources":["../../../src/lib/widget-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IAEnC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAE1B,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAA;IACvC,WAAW,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAA;IAC7C,YAAY,EAAE,OAAO,CAAA;IAErB,WAAW,EAAE,WAAW,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAA;IAC1D,aAAa,EAAE,WAAW,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAA;IAC9D,YAAY,EAAE,MAAM,CAAA;IAEpB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,YAAY,GAAG,IAAI,GAC1B,oBAAoB,CAoBtB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,EAC7C,UAAU,GAAG,aAAa,GAAG,cAAc,GAC3C,aAAa,GAAG,YAAY,GAAG,UAAU,GACzC,cAAc,GAAG,aAAa,GAAG,cAAc,GAC/C,aAAa,GAAG,eAAe,GAAG,cAAc,CACnD,GAAG;IACF,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAS9B"}

package/dist/types/module/screens/ScreenRouter.d.ts

@@ -1,8 +1,9 @@
 interface ScreenRouterProps {
     greeting: string;
     title: string;
+    orgSlug: string;
 }
 /** Renders only the active screen. No animation — add transitions later once routing is stable. */
-export declare function ScreenRouter({ greeting, title }: ScreenRouterProps): import("preact").JSX.Element;
+export declare function ScreenRouter({ greeting, title, orgSlug }: ScreenRouterProps): import("preact").JSX.Element;
 export {};
 //# sourceMappingURL=ScreenRouter.d.ts.map

package/dist/types/module/screens/ScreenRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenRouter.d.ts","sourceRoot":"","sources":["../../../../src/module/screens/ScreenRouter.tsx"],"names":[],"mappings":"AAWA,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,gCAqClE"}
+{"version":3,"file":"ScreenRouter.d.ts","sourceRoot":"","sources":["../../../../src/module/screens/ScreenRouter.tsx"],"names":[],"mappings":"AAWA,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,iBAAiB,gCAqC3E"}

package/dist/types/module/shell/{AppShell.d.ts → WidgetShell.d.ts}

@@ -1,8 +1,8 @@
 import type { JexityChatOptions } from '../../types';
-interface AppShellProps {
+interface WidgetShellProps {
     options: JexityChatOptions;
 }
 /** Inner Preact component tree — rendered inside the shadow root container. */
-export declare function AppShell({ options }: AppShellProps): import("preact").JSX.Element;
+export declare function WidgetShell({ options }: WidgetShellProps): import("preact").JSX.Element;
 export {};
-//# sourceMappingURL=AppShell.d.ts.map
+//# sourceMappingURL=WidgetShell.d.ts.map

package/dist/types/module/shell/WidgetShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetShell.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/WidgetShell.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,UAAU,gBAAgB;IACxB,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,gBAAgB,gCA2DxD"}

package/dist/types/module/shell/hooks/usePreviewBridge.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Listens for postMessage config updates sent from the dashboard preview iframe.
+ *
+ * This is a playground/dashboard-only concern — the `parentOrigin` option is
+ * only set when the widget is embedded inside the dashboard preview panel.
+ * Production embeds on customer websites never send this message type.
+ *
+ * Message shape:
+ *   { type: 'jexity:config', payload: { locale?: string } }
+ *
+ * Incoming locale strings are passed through `resolveWidgetLocale` so the full
+ * priority chain (config → localStorage → browser → default) is respected,
+ * and no type assertions are needed.
+ */
+export declare function usePreviewBridge(parentOrigin: string | undefined): void;
+//# sourceMappingURL=usePreviewBridge.d.ts.map

package/dist/types/module/shell/hooks/usePreviewBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreviewBridge.d.ts","sourceRoot":"","sources":["../../../../../src/module/shell/hooks/usePreviewBridge.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAkBvE"}

package/dist/types/module/shell/hooks/useRemoteConfig.d.ts

@@ -0,0 +1,13 @@
+import { type RemoteConfig } from '../../../lib/widget-config';
+/**
+ * Fetches the widget's remote config from Convex for the given orgSlug.
+ *
+ * - Returns null on first render, then updates once the fetch resolves.
+ * - Clears stale config immediately when orgSlug changes (prevents flashing
+ *   the previous org's title/colors while the new fetch is in flight).
+ * - Aborts the in-flight request if orgSlug changes or the hook unmounts.
+ * - Silent fail: any error (network, 404, parse) resolves to null so the
+ *   widget still renders using embed-script options as a fallback.
+ */
+export declare function useRemoteConfig(orgSlug: string): RemoteConfig | null;
+//# sourceMappingURL=useRemoteConfig.d.ts.map

package/dist/types/module/shell/hooks/useRemoteConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRemoteConfig.d.ts","sourceRoot":"","sources":["../../../../../src/module/shell/hooks/useRemoteConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEjF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAkCpE"}

package/dist/types/module/shell/mount.d.ts

@@ -1,13 +1,24 @@
-import type { JexityChatOptions, JexityChatInstance } from '../../types';
+import type { JexityChatOptions } from '../../types';
 /**
- * Mounts the widget into a Shadow DOM on the given host element.
- * Reuses an existing shadow root on re-mount (avoids "already has a shadow root" error
- * when the dev playground re-mounts on options change).
+ * LOW-LEVEL: Renders the widget into a Shadow DOM on the given host element.
+ *
+ * Why Shadow DOM?
+ *   The widget is injected into customer websites that have their own CSS.
+ *   Shadow DOM creates an isolated DOM subtree — styles on the host page
+ *   cannot leak in, and widget styles cannot leak out.
+ *
+ * Why injectStyles?
+ *   Stylesheets do not cross Shadow DOM boundaries automatically.
+ *   We must explicitly stamp the widget's CSS into the shadow root.
+ *
+ * Why reuse the existing shadow root?
+ *   Calling attachShadow() on an element that already has a shadow root
+ *   throws "already has a shadow root". The Studio playground re-mounts
+ *   on every config change, so we reuse the root instead of re-creating it.
+ *
+ * Returns a shutdown function that unmounts the Preact tree and resets state.
+ * Called by createInstance() — entry points (esm.ts, iife.ts) should not
+ * call this directly; use createInstance() instead.
  */
 export declare function mountWidget(hostEl: HTMLElement, options: JexityChatOptions): () => void;
-/**
- * Creates a JexityChatInstance wrapping mountWidget.
- * Used by entry points (iife.ts, esm.ts).
- */
-export declare function createInstance(mountEl: HTMLElement, options: JexityChatOptions, onRemove?: () => void): JexityChatInstance;
 //# sourceMappingURL=mount.d.ts.map

package/dist/types/module/shell/mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/mount.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAExE;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,iBAAiB,GACzB,MAAM,IAAI,CAmBZ;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,kBAAkB,CA0BpB"}
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/mount.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AASpD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,iBAAiB,GACzB,MAAM,IAAI,CA0BZ"}

package/dist/types/module/shell/shell.state.d.ts

@@ -1,2 +1,14 @@
+/**
+ * Whether the chat window is currently open.
+ *
+ * Lives in its own file because it is read and written across multiple layers:
+ *   - widget-instance.ts  open() / close() / toggle() / subscribe()
+ *   - mount.tsx           reset to false on shutdown
+ *   - WidgetShell.tsx     conditionally renders the chat window
+ *   - FAB.tsx             toggle button reads and flips this value
+ *
+ * Keeping it here prevents any one of those files from becoming the
+ * "source" that others import from — none of them own it, they all share it.
+ */
 export declare const isOpen: import("@preact/signals").Signal<boolean>;
 //# sourceMappingURL=shell.state.d.ts.map

package/dist/types/module/shell/shell.state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.state.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/shell.state.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,2CAAgB,CAAA"}
+{"version":3,"file":"shell.state.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/shell.state.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,2CAAgB,CAAA"}

package/dist/types/module/shell/widget-instance.d.ts

@@ -0,0 +1,27 @@
+import type { JexityChatOptions, JexityChatInstance } from '../../types';
+/**
+ * HIGH-LEVEL: Creates a JexityChatInstance for the given host element.
+ *
+ * This is the function entry points (esm.ts, iife.ts) call to get a widget.
+ * It wraps mountWidget() with the full public API:
+ *
+ *   instance.open()        — opens the chat window
+ *   instance.close()       — closes the chat window
+ *   instance.toggle()      — flips open/closed
+ *   instance.isOpen        — current open state (getter)
+ *   instance.subscribe(cb) — notified whenever open state changes
+ *   instance.shutdown()    — destroys the widget and cleans up everything
+ *
+ * How open/close state works:
+ *   `isOpen` is a Preact signal — a reactive value that any component can
+ *   subscribe to. When its value changes, only the components that read it
+ *   re-render (no prop drilling needed). `subscribe()` below taps into the
+ *   same signal so external callers (e.g. the React wrapper) can react to
+ *   open/close events without polling.
+ *
+ * The onRemove callback:
+ *   Passed by esm.ts to clean up the host <div> from document.body after
+ *   shutdown. Undefined when the caller manages the container themselves.
+ */
+export declare function createInstance(mountEl: HTMLElement, options: JexityChatOptions, onRemove?: () => void): JexityChatInstance;
+//# sourceMappingURL=widget-instance.d.ts.map

package/dist/types/module/shell/widget-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-instance.d.ts","sourceRoot":"","sources":["../../../../src/module/shell/widget-instance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAExE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,CAAC,EAAE,MAAM,IAAI,GACpB,kBAAkB,CA8BpB"}