@mordn/chat-widget 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -120,11 +120,34 @@ interface FeatureConfig {
  * - full: 100% - fills entire screen
  */
 type ChatWidgetSize = 'compact' | 'default' | 'large' | 'full';
+/**
+ * Layout shape the widget renders in.
+ *
+ * - `popup`  : floating side panel, opened by a toggle button (default).
+ *              Best for ambient assistance available across pages.
+ * - `inline` : renders in place inside the parent element. No toggle button,
+ *              no fixed positioning, fills its container. Best for dashboard
+ *              cards or dedicated chat sections of a page.
+ * - `page`   : full-viewport layout with a conversation list sidebar on the
+ *              left and the active chat on the right. Best for a dedicated
+ *              chat route (e.g. `/chat`).
+ *
+ * The `popup` value is the historical default and remains backward compatible.
+ */
+type ChatWidgetLayout = 'popup' | 'inline' | 'page';
 interface DisplayConfig {
+    /**
+     * How the widget renders.
+     * Default: `'popup'` (backward compatible).
+     */
+    layout?: ChatWidgetLayout;
     /**
      * Preset size for the widget (recommended)
      * Uses clamp() for responsive sizing with min/max bounds
      * Default: 'default'
+     *
+     * Note: `size` only applies in `popup` layout. `inline` and `page` layouts
+     * fill their container regardless.
      */
     size?: ChatWidgetSize;
     /**

package/dist/index.d.ts

@@ -120,11 +120,34 @@ interface FeatureConfig {
  * - full: 100% - fills entire screen
  */
 type ChatWidgetSize = 'compact' | 'default' | 'large' | 'full';
+/**
+ * Layout shape the widget renders in.
+ *
+ * - `popup`  : floating side panel, opened by a toggle button (default).
+ *              Best for ambient assistance available across pages.
+ * - `inline` : renders in place inside the parent element. No toggle button,
+ *              no fixed positioning, fills its container. Best for dashboard
+ *              cards or dedicated chat sections of a page.
+ * - `page`   : full-viewport layout with a conversation list sidebar on the
+ *              left and the active chat on the right. Best for a dedicated
+ *              chat route (e.g. `/chat`).
+ *
+ * The `popup` value is the historical default and remains backward compatible.
+ */
+type ChatWidgetLayout = 'popup' | 'inline' | 'page';
 interface DisplayConfig {
+    /**
+     * How the widget renders.
+     * Default: `'popup'` (backward compatible).
+     */
+    layout?: ChatWidgetLayout;
     /**
      * Preset size for the widget (recommended)
      * Uses clamp() for responsive sizing with min/max bounds
      * Default: 'default'
+     *
+     * Note: `size` only applies in `popup` layout. `inline` and `page` layouts
+     * fill their container regardless.
      */
     size?: ChatWidgetSize;
     /**

package/dist/index.js

@@ -2027,26 +2027,21 @@ function ChatInterface({ id, initialMessages, config, onClose } = {}) {
                 /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: "p-2.5 border-b", style: {
                   borderColor: "var(--chat-border-soft)",
                   backgroundColor: "var(--chat-overlay)"
-                }, children: /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("div", { className: "relative", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(import_lucide_react10.SearchIcon, { className: "absolute left-2.5 top-1/2 -translate-y-1/2 h-3.5 w-3.5", style: {
-                    color: "hsl(var(--chat-text-muted))"
-                  }, strokeWidth: 2 }),
-                  /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
-                    "input",
-                    {
-                      type: "text",
-                      placeholder: "Search",
-                      value: searchQuery,
-                      onChange: (e) => setSearchQuery(e.target.value),
-                      className: "w-full h-7 pl-8 pr-2.5 text-[13px] rounded-lg focus:outline-none transition-all",
-                      style: {
-                        backgroundColor: "hsl(var(--chat-surface-deep))",
-                        border: `1px solid ${"var(--chat-border-medium)"}`,
-                        color: "hsl(var(--chat-text))"
-                      }
+                }, children: /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: "relative", children: /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
+                  "input",
+                  {
+                    type: "text",
+                    placeholder: "Search",
+                    value: searchQuery,
+                    onChange: (e) => setSearchQuery(e.target.value),
+                    className: "w-full h-7 px-2.5 text-[13px] rounded-lg focus:outline-none transition-all",
+                    style: {
+                      backgroundColor: "hsl(var(--chat-surface-deep))",
+                      border: `1px solid ${"var(--chat-border-medium)"}`,
+                      color: "hsl(var(--chat-text))"
                     }
-                  )
-                ] }) }),
+                  }
+                ) }) }),
                 /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: "max-h-[300px] overflow-y-auto ai-assistant-scrollbar", children: loadingHistory ? /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: "flex items-center justify-center py-12", children: /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: "text-[13px]", style: { color: "hsl(var(--chat-text-muted))" }, children: "Loading..." }) }) : conversations.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("div", { className: "flex flex-col items-center justify-center py-12 px-4 text-center", children: [
                   /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: "w-12 h-12 rounded-full flex items-center justify-center mb-3", style: {
                     backgroundColor: "hsl(var(--chat-surface))"
@@ -2222,10 +2217,13 @@ function ChatWidget({
   display,
   starterPrompts
 }) {
+  const layout = display?.layout || "popup";
   const showToggleButton = display?.showToggleButton !== false;
-  const resizable = display?.resizable !== false;
+  const resizable = layout === "popup" && display?.resizable !== false;
   const size = display?.size || "default";
-  const [isOpen, setIsOpen] = (0, import_react12.useState)(display?.defaultOpen || false);
+  const [isOpen, setIsOpen] = (0, import_react12.useState)(
+    layout !== "popup" ? true : display?.defaultOpen || false
+  );
   const [isResizing, setIsResizing] = (0, import_react12.useState)(false);
   const containerRef = (0, import_react12.useRef)(null);
   const customStyles = (0, import_react12.useMemo)(() => {
@@ -2286,6 +2284,43 @@ function ChatWidget({
     starterPrompts
   }), [userId, model, systemPrompt, temperature, theme, features, starterPrompts]);
   const togglePosition = display?.toggleButtonPosition || { bottom: "24px", right: "24px" };
+  const themeClass = theme?.mode === "dark" ? "dark" : "";
+  if (layout === "inline") {
+    return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(ChatStorageProvider, { userId, children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+      "div",
+      {
+        ref: containerRef,
+        className: `chat-widget-container chat-widget-inline chat-widget-content ${themeClass} ${className || ""}`,
+        style: customStyles,
+        children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+          ChatInterface,
+          {
+            id: conversationId,
+            initialMessages,
+            config
+          }
+        )
+      }
+    ) });
+  }
+  if (layout === "page") {
+    return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(ChatStorageProvider, { userId, children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+      "div",
+      {
+        ref: containerRef,
+        className: `chat-widget-container chat-widget-page chat-widget-content ${themeClass} ${className || ""}`,
+        style: customStyles,
+        children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+          ChatInterface,
+          {
+            id: conversationId,
+            initialMessages,
+            config
+          }
+        )
+      }
+    ) });
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)(ChatStorageProvider, { userId, children: [
     showToggleButton && !isOpen && /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       "button",
@@ -2301,7 +2336,7 @@ function ChatWidget({
       "div",
       {
         ref: containerRef,
-        className: `chat-widget-container chat-widget-popup chat-widget-content ${theme?.mode === "dark" ? "dark" : ""} ${className || ""}`,
+        className: `chat-widget-container chat-widget-popup chat-widget-content ${themeClass} ${className || ""}`,
         "data-size": size,
         "data-resizing": isResizing,
         style: customStyles,