@mordn/chat-widget 0.2.1 → 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

@@ -2217,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)(() => {
@@ -2281,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",
@@ -2296,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,