@ibti-tech/chatbot 0.8.0 → 0.8.5

package/README.md

@@ -21,7 +21,7 @@ npm install @ibti-tech/chatbot
 ## Usage (React)
 
 ```jsx
-import { ChatbotProvider, ChatbotBar } from '@ibti-tech/chatbot'
+import { ChatbotProvider, ChatbotBar, useChatbot } from '@ibti-tech/chatbot'
 
 function App() {
   return (
@@ -37,6 +37,8 @@ function App() {
 }
 ```
 
+All public types (e.g. `ChatbotTypes`, `ChatbotBarProps`) and parameters are documented with JSDoc in English in the source—your IDE will show parameter names, types, and descriptions on hover.
+
 ### Main props
 
 **ChatbotProvider**
@@ -58,9 +60,33 @@ function App() {
 | `horizontalPosition`     | `'left' \| 'right'` | `'right'` | Bar alignment                       |
 | `deviceHorizontalPosition`| `'left' \| 'right' \| 'center' \| string` | — | Device position on desktop (or e.g. `'20px'`, `'calc(100% - 200px)'`) |
 | `pushContentDown`         | `boolean` | `false`  | If `true` and `verticalPosition="top"`, widget pushes content down instead of overlaying |
+| `pushContentDownBarHeight`| `number`  | `32`     | Height in px of the bar when pushContentDown (24–120). |
 | `zIndex`, `topOffset`, `aboveHeader` | — | — | Optional layout/stacking           |
 
-When using `pushContentDown={true}` with `verticalPosition="top"`, render `ChatbotBar` **before** your header/main content so it appears at the top.
+When using `pushContentDown={true}` with `verticalPosition="top"`, the bar is fixed at the top and the widget adds the class `ibti-chatbot-push-down` and CSS variable `--ibti-chatbot-bar-height` (default 32px) to `body`. To avoid extra vertical scroll and keep your content below the bar, reserve the top space in your layout, for example:
+
+```css
+body.ibti-chatbot-push-down .your-main-content {
+  padding-top: var(--ibti-chatbot-bar-height, 32px);
+  min-height: calc(100vh - var(--ibti-chatbot-bar-height, 32px));
+}
+```
+
+### Types (`ChatbotTypes`)
+
+Import: `import type { ChatbotTypes } from '@ibti-tech/chatbot'`
+
+| Type | Description |
+|------|-------------|
+| `Theme` | `'light' \| 'dark'` |
+| `Locale` | `'pt-BR' \| 'en'` |
+| `CustomColors` | `{ primaryColor?, headerBackground?, userBalloonColor? }` (hex or rgb) |
+| `ChatMessage` | `{ id, timestamp, role, content, error? }` — one message in the thread |
+| `ChatContextItem` | `{ role, content }` — minimal shape for API context |
+| `Status` | `'writing' \| 'loading' \| 'online' \| 'unavailable'` |
+| `InitializationStatus` | `'loading' \| 'domain_not_allowed' \| 'error' \| 'ready'` |
+| `ChatbotPublicResponse` | Response of GET `/chatbots/public/:hash` (id, name, domain, etc.) |
+| `CustomTexts` / `Texts` | Override UI strings per locale (see JSDoc in `types/index.ts`) |
 
 ## Embed (no React)
 

package/dist/index.d.ts

@@ -55,56 +55,46 @@ declare module '@ibti-tech/chatbot/components/ChatUserFeedbackRating/styles.d.ts
 }
 declare module '@ibti-tech/chatbot/components/ChatbotBar/index' {
   import React from 'react';
+  /**
+   * Props for the ChatbotBar component (toggle button + floating chat panel).
+   * Use with ChatbotProvider; positioning is relative to viewport unless pushContentDown is used.
+   */
   export type ChatbotBarProps = {
+      /** Vertical anchor: 'top' | 'bottom'. Default: 'bottom'. */
       verticalPosition?: 'top' | 'bottom';
+      /** Horizontal anchor of the bar: 'left' | 'right'. Default: 'right'. */
       horizontalPosition?: 'left' | 'right';
       /**
-       * Horizontal position of the ChatbotDevice on desktop.
-       * Can be a predefined value ('left', 'right', 'center') or a custom value with any unit (e.g., '20px', '10%', '2rem', 'calc(100% - 200px)').
-       * When using a custom value, it will be applied as the 'left' property.
-       * If not provided, the device will use the parent container's positioning.
+       * Horizontal position of the chat panel on desktop.
+       * Predefined: 'left' | 'right' | 'center', or any CSS length (e.g. '20px', '10%', 'calc(100% - 200px)').
+       * Custom values are applied as the 'left' CSS property. Omit to use parent positioning.
        */
       deviceHorizontalPosition?: 'left' | 'right' | 'center' | string;
-      /**
-       * Custom z-index value. If not provided, uses theme.zIndex.modals
-       * Useful when you need the chatbot to appear above specific elements like headers
-       */
+      /** Custom z-index for the bar/panel. If omitted, uses theme.zIndex.modals. Use to appear above headers. */
       zIndex?: number;
-      /**
-       * Offset from the top when verticalPosition is 'top'
-       * Can be a number (in pixels) or a string (e.g., '100px', '10rem')
-       * Useful to position the chatbot below a fixed header
-       */
+      /** Offset from top when verticalPosition is 'top'. Number (px) or string (e.g. '100px', '10rem'). Use to sit below a fixed header. */
       topOffset?: string | number;
-      /**
-       * Convenient prop to position the chatbot above header elements
-       * When true, sets z-index to 9999 and allows topOffset configuration
-       */
+      /** When true, sets z-index to 9999 so the chatbot appears above header elements; use with topOffset. */
       aboveHeader?: boolean;
       /**
-       * When true and verticalPosition is 'top', the chatbot will push content down
-       * instead of overlaying it. The chatbot will occupy space in the document flow.
-       * When false, the chatbot will be fixed and overlay the content.
+       * When true and verticalPosition is 'top', the bar takes space in the document flow (pushes content down)
+       * instead of overlaying. When false, the bar is fixed and overlays content.
        */
       pushContentDown?: boolean;
-      /**
-       * Background color of the push-content-down row (full-width bar) for light theme.
-       * Does not affect the chatbot button. Accepts rgb(), hex (e.g. #e6e6e6), etc.
-       * Default: rgb(230, 230, 230)
-       */
+      /** Background of the push-content-down full-width row (light theme). Hex or rgb(). Default: rgb(230, 230, 230). */
       pushContentDownRowBackgroundLight?: string;
-      /**
-       * Background color of the push-content-down row (full-width bar) for dark theme.
-       * Does not affect the chatbot button. Accepts rgb(), hex (e.g. #000000), etc.
-       * Default: rgb(0, 0, 0)
-       */
+      /** Background of the push-content-down full-width row (dark theme). Hex or rgb(). Default: rgb(0, 0, 0). */
       pushContentDownRowBackgroundDark?: string;
+      /** Height in px of the bar when pushContentDown is true (closed state). Default: 32. */
+      pushContentDownBarHeight?: number;
   };
-  export const ChatbotBar: ({ verticalPosition, horizontalPosition, deviceHorizontalPosition, zIndex, topOffset, aboveHeader, pushContentDown, pushContentDownRowBackgroundLight, pushContentDownRowBackgroundDark, }: ChatbotBarProps) => React.JSX.Element;
+  /** Bar height in px when pushContentDown (closed state). Used for body class and CSS variable. */
+  export const PUSH_DOWN_BAR_HEIGHT_PX = 32;
+  export const ChatbotBar: ({ verticalPosition, horizontalPosition, deviceHorizontalPosition, zIndex, topOffset, aboveHeader, pushContentDown, pushContentDownRowBackgroundLight, pushContentDownRowBackgroundDark, pushContentDownBarHeight, }: ChatbotBarProps) => React.JSX.Element;
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/components/ChatbotBar/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotBar/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAIlD,MAAM,MAAM,eAAe,GAAG;IAC5B,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACnC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACrC;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC/D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,iCAAiC,CAAC,EAAE,MAAM,CAAA;IAC1C;;;;OAIG;IACH,gCAAgC,CAAC,EAAE,MAAM,CAAA;CAC1C,CAAA;AAKD,eAAO,MAAM,UAAU,GAAI,2LAUxB,eAAe,sBAuFjB,CAAA"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotBar/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAIlD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACnC,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACrC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC/D,2GAA2G;IAC3G,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sIAAsI;IACtI,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,wGAAwG;IACxG,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,mHAAmH;IACnH,iCAAiC,CAAC,EAAE,MAAM,CAAA;IAC1C,4GAA4G;IAC5G,gCAAgC,CAAC,EAAE,MAAM,CAAA;IACzC,wFAAwF;IACxF,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC,CAAA;AAKD,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAKzC,eAAO,MAAM,UAAU,GAAI,qNAWxB,eAAe,sBAgGjB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/components/ChatbotBar/styles' {
   import { breakpoints } from '@ibti-tech/ui';
@@ -121,6 +111,7 @@ declare module '@ibti-tech/chatbot/components/ChatbotBar/styles' {
   /** Full-width row strip (pushContentDown + top). Background only; device sits on top with theme styles. */
   export const PushDownRow: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
       $background: string;
+      $barHeight: number;
   }>> & string;
   export const Wrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
       $verticalPosition: "top" | "bottom";
@@ -130,11 +121,12 @@ declare module '@ibti-tech/chatbot/components/ChatbotBar/styles' {
       $topOffset?: string | number;
       $aboveHeader?: boolean;
       $pushContentDown?: boolean;
+      $pushContentDownBarHeight?: number;
   }>> & string;
   //# sourceMappingURL=styles.d.ts.map
 }
 declare module '@ibti-tech/chatbot/components/ChatbotBar/styles.d.ts' {
-  {"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotBar/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAW,MAAM,eAAe,CAAA;AAIpD,eAAO,MAAM,YAAY;;oBAEgB,kBAAmB;;yBADrC,MAAM,GAAG,OAAO;gCACT,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM;aACvD,OAAO;uBACG,KAAK,GAAG,QAAQ;uBAChB,OAAO;iMA4E3B,CAAA;AAED,2GAA2G;AAC3G,eAAO,MAAM,WAAW;iBAA6B,MAAM;YAS1D,CAAA;AAED,eAAO,MAAM,OAAO;uBACC,KAAK,GAAG,QAAQ;yBACd,MAAM,GAAG,OAAO;aAC5B,OAAO;cACN,MAAM;iBACH,MAAM,GAAG,MAAM;mBACb,OAAO;uBACH,OAAO;YA2H3B,CAAA"}
+  {"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotBar/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAW,MAAM,eAAe,CAAA;AAIpD,eAAO,MAAM,YAAY;;oBAEgB,kBAAmB;;yBADrC,MAAM,GAAG,OAAO;gCACT,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM;aACvD,OAAO;uBACG,KAAK,GAAG,QAAQ;uBAChB,OAAO;iMA4E3B,CAAA;AAED,2GAA2G;AAC3G,eAAO,MAAM,WAAW;iBAA6B,MAAM;gBAAc,MAAM;YAS9E,CAAA;AAED,eAAO,MAAM,OAAO;uBACC,KAAK,GAAG,QAAQ;yBACd,MAAM,GAAG,OAAO;aAC5B,OAAO;cACN,MAAM;iBACH,MAAM,GAAG,MAAM;mBACb,OAAO;uBACH,OAAO;gCACE,MAAM;YAgInC,CAAA"}
 }
 declare module '@ibti-tech/chatbot/components/ChatbotBody/index' {
   import React from 'react';
@@ -167,13 +159,15 @@ declare module '@ibti-tech/chatbot/components/ChatbotDevice/index' {
        * Default: undefined (uses parent container positioning)
        */
       horizontalPosition?: 'left' | 'right' | 'center' | string;
+      /** Height in px of the bar when pushContentDown (closed state). Default: 32. */
+      pushContentDownBarHeight?: number;
   };
-  export const ChatbotDevice: ({ verticalPosition, pushContentDown, horizontalPosition, }: ChatbotDeviceProps) => React.JSX.Element;
+  export const ChatbotDevice: ({ verticalPosition, pushContentDown, horizontalPosition, pushContentDownBarHeight, }: ChatbotDeviceProps) => React.JSX.Element;
   export default ChatbotDevice;
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/components/ChatbotDevice/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotDevice/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACnC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;CAC1D,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,4DAI3B,kBAAkB,sBAsBpB,CAAA;AAED,eAAe,aAAa,CAAA"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotDevice/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACnC,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IACzD,gFAAgF;IAChF,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC,CAAA;AAID,eAAO,MAAM,aAAa,GAAI,sFAK3B,kBAAkB,sBAyBpB,CAAA;AAED,eAAe,aAAa,CAAA"}
 }
 declare module '@ibti-tech/chatbot/components/ChatbotDevice/styles' {
   export const Wrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
@@ -181,11 +175,12 @@ declare module '@ibti-tech/chatbot/components/ChatbotDevice/styles' {
       $verticalPosition: "top" | "bottom";
       $pushContentDown?: boolean;
       $horizontalPosition?: "left" | "right" | "center" | string;
+      $pushContentDownBarHeight?: number;
   }>> & string;
   //# sourceMappingURL=styles.d.ts.map
 }
 declare module '@ibti-tech/chatbot/components/ChatbotDevice/styles.d.ts' {
-  {"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotDevice/styles.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO;aACT,OAAO;uBACG,KAAK,GAAG,QAAQ;uBAChB,OAAO;0BACJ,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM;YAqO3D,CAAA"}
+  {"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotDevice/styles.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO;aACT,OAAO;uBACG,KAAK,GAAG,QAAQ;uBAChB,OAAO;0BACJ,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM;gCAC9B,MAAM;YAyOnC,CAAA"}
 }
 declare module '@ibti-tech/chatbot/components/ChatbotFooter/index' {
   import React from 'react';
@@ -254,13 +249,15 @@ declare module '@ibti-tech/chatbot/components/ChatbotToggle/index' {
       verticalPosition?: 'top' | 'bottom';
       opened?: boolean;
       pushContentDown?: boolean;
+      /** Height in px of the bar when closed (pushContentDown or bottom). Default: 32. */
+      pushContentDownBarHeight?: number;
   };
-  export const ChatbotToggle: ({ verticalPosition, opened: openedProp, pushContentDown, }: ChatbotToggleProps) => React.JSX.Element;
+  export const ChatbotToggle: ({ verticalPosition, opened: openedProp, pushContentDown, pushContentDownBarHeight, }: ChatbotToggleProps) => React.JSX.Element;
   export default ChatbotToggle;
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/components/ChatbotToggle/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotToggle/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACnC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,4DAI3B,kBAAkB,sBAkCpB,CAAA;AAED,eAAe,aAAa,CAAA"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotToggle/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACnC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oFAAoF;IACpF,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC,CAAA;AAID,eAAO,MAAM,aAAa,GAAI,sFAK3B,kBAAkB,sBAmCpB,CAAA;AAED,eAAe,aAAa,CAAA"}
 }
 declare module '@ibti-tech/chatbot/components/ChatbotToggle/styles' {
   export const ButtonWrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, {
@@ -268,11 +265,12 @@ declare module '@ibti-tech/chatbot/components/ChatbotToggle/styles' {
       $verticalPosition: "top" | "bottom";
       $pushContentDown?: boolean;
       $themeMode?: "light" | "dark";
+      $barHeight?: number;
   }>> & string;
   //# sourceMappingURL=styles.d.ts.map
 }
 declare module '@ibti-tech/chatbot/components/ChatbotToggle/styles.d.ts' {
-  {"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotToggle/styles.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa;aACf,OAAO;uBACG,KAAK,GAAG,QAAQ;uBAChB,OAAO;iBACb,OAAO,GAAG,MAAM;YAwE9B,CAAA"}
+  {"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/components/ChatbotToggle/styles.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa;aACf,OAAO;uBACG,KAAK,GAAG,QAAQ;uBAChB,OAAO;iBACb,OAAO,GAAG,MAAM;iBAChB,MAAM;YAwEpB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/components/MessageBalloon/index' {
   import React from 'react';
@@ -372,57 +370,84 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/context' {
   import * as React from 'react';
   import { ChatbotTypes } from 'types';
   import { useChatbotSuggestedQuestions } from '@ibti-tech/chatbot/contexts/Chatbot/useChatbotSuggestedQuestions';
+  /**
+   * Shape of the chatbot context provided by ChatbotProvider.
+   * Consume via useChatbot() inside the provider tree.
+   */
   export type ChatbotContextProps = {
+      /** Current locale: 'pt-BR' | 'en'. */
       locale: ChatbotTypes.Locale;
+      /** Ordered list of chat messages (user + assistant). */
       chatMessages: ChatbotTypes.ChatMessage[];
+      /** Optional ref for the scrollable messages container. */
       scrollRef?: React.MutableRefObject<HTMLElement | null>;
+      /** Sends a user message and streams the assistant reply. Resolves when stream ends. */
       makeQuestion: (question: string) => Promise<void>;
+      /** True while the assistant is streaming a response. */
       writing: boolean;
+      /** True while the request is in flight (before first chunk). */
       loading: boolean;
+      /** Whether the chat panel is open. */
       opened: boolean;
+      /** Toggles opened state. */
       openedToggle: () => void;
+      /** Derived status: 'writing' | 'loading' | 'online' | 'unavailable'. */
       status: ChatbotTypes.Status;
+      /** True when API health check or request failed (e.g. network/CORS). */
       apiConnectionError: boolean;
+      /** Suggested questions hook result: { loading, data, fetchData, resetData }. */
       suggestedQuestions: ReturnType<typeof useChatbotSuggestedQuestions>;
+      /** Base URL of the chatbot API. */
       apiURL: string;
+      /** Optional custom texts per locale (overrides defaults). */
       texts?: ChatbotTypes.Texts;
+      /** Current theme: 'light' | 'dark'. */
       theme: ChatbotTypes.Theme;
-      /** Lucide icon name for the chatbot (button/header). */
+      /** Optional Lucide icon name for the chatbot button/header (e.g. 'Bot', 'MessageCircle'). */
       icon?: string;
-      /** Public hash of the chatbot (when using new API) */
+      /** Public hash of the chatbot when using the public API. */
       publicHash?: string;
-      /** Stable visitor ID for this chatbot session */
+      /** Stable visitor id for this session (when using publicHash). */
       visitorId?: string;
-      /** Whether the current domain is allowed for this chatbot */
+      /** True when current origin is in the chatbot's allowed domains. */
       domainAllowed: boolean;
-      /** Initialization state of the widget */
+      /** Widget init state: 'loading' | 'domain_not_allowed' | 'error' | 'ready'. */
       initializationStatus: ChatbotTypes.InitializationStatus;
-      /** Chatbot data from GET /chatbots/public/:hash (when ready) */
+      /** Chatbot config from GET /chatbots/public/:hash when initializationStatus is 'ready'. */
       chatbot?: ChatbotTypes.ChatbotPublicResponse;
   };
+  /** React context for chatbot state. Use useChatbot() to consume. */
   export const ChatbotContext: React.Context<ChatbotContextProps>;
   //# sourceMappingURL=context.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/context.d.ts' {
-  {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAE7E,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,YAAY,EAAE,YAAY,CAAC,WAAW,EAAE,CAAA;IACxC,SAAS,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtD,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,kBAAkB,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAA;IACnE,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IACzB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,aAAa,EAAE,OAAO,CAAA;IACtB,yCAAyC;IACzC,oBAAoB,EAAE,YAAY,CAAC,oBAAoB,CAAA;IACvD,gEAAgE;IAChE,OAAO,CAAC,EAAE,YAAY,CAAC,qBAAqB,CAAA;CAC7C,CAAA;AAED,eAAO,MAAM,cAAc,oCAAiD,CAAA"}
+  {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAE7E;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,sCAAsC;IACtC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,wDAAwD;IACxD,YAAY,EAAE,YAAY,CAAC,WAAW,EAAE,CAAA;IACxC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtD,uFAAuF;IACvF,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAA;IAChB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAA;IAChB,sCAAsC;IACtC,MAAM,EAAE,OAAO,CAAA;IACf,4BAA4B;IAC5B,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,wEAAwE;IACxE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,wEAAwE;IACxE,kBAAkB,EAAE,OAAO,CAAA;IAC3B,gFAAgF;IAChF,kBAAkB,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAA;IACnE,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,uCAAuC;IACvC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IACzB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,aAAa,EAAE,OAAO,CAAA;IACtB,+EAA+E;IAC/E,oBAAoB,EAAE,YAAY,CAAC,oBAAoB,CAAA;IACvD,2FAA2F;IAC3F,OAAO,CAAC,EAAE,YAAY,CAAC,qBAAqB,CAAA;CAC7C,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,cAAc,oCAAiD,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/provider' {
   import React, { ReactNode } from 'react';
   import { ChatbotTypes } from 'types';
+  /**
+   * Props for ChatbotProvider. Wrap your app (or chatbot subtree) with this to enable useChatbot().
+   */
   export type ChatbotProviderProps = {
+      /** Locale: 'pt-BR' | 'en'. */
       locale: ChatbotTypes.Locale;
+      /** Base URL of the chatbot API (e.g. https://api.example.com). */
       apiURL: string;
-      /** Public hash of the chatbot (required for new API; omit for legacy mode) */
+      /** Public hash of the chatbot (required for domain-validated API; omit for legacy). */
       publicHash?: string;
       children?: ReactNode;
+      /** UI theme: 'light' | 'dark'. */
       theme: ChatbotTypes.Theme;
+      /** Initial open state of the chat panel. Default: false. */
       isOpen?: boolean;
+      /** Optional custom texts per locale (key: 'pt-BR' | 'en', value: CustomTexts). */
       texts?: ChatbotTypes.Texts;
-      /** Override list of origins that skip domain check */
+      /** Origins that skip domain validation (e.g. for staging). */
       allowedOriginsWithoutCheck?: string[];
-      /** When true (e.g. admin preview iframe), skip domain validation entirely */
+      /** When true, skip domain check (e.g. admin preview iframe). Do not use in production embed. */
       skipDomainCheck?: boolean;
-      /** Custom colors for branding (primary, header, user balloons) */
+      /** Custom colors: primaryColor, headerBackground, userBalloonColor (hex or rgb). */
       colors?: ChatbotTypes.CustomColors;
       /** Lucide icon name for the chatbot button/header (e.g. 'Bot', 'MessageCircle'). */
       icon?: string;
@@ -431,13 +456,22 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/provider' {
   //# sourceMappingURL=provider.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/provider.d.ts' {
-  {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAwC,MAAM,OAAO,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AASpC,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,sDAAsD;IACtD,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAA;IACrC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kEAAkE;IAClE,MAAM,CAAC,EAAE,YAAY,CAAC,YAAY,CAAA;IAClC,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,sJAY7B,oBAAoB,sBAgLtB,CAAA"}
+  {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAwC,MAAM,OAAO,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AASpC;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;IACd,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,kCAAkC;IAClC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IACzB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kFAAkF;IAClF,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,8DAA8D;IAC9D,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAA;IACrC,gGAAgG;IAChG,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oFAAoF;IACpF,MAAM,CAAC,EAAE,YAAY,CAAC,YAAY,CAAA;IAClC,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,sJAY7B,oBAAoB,sBAgLtB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatFeedbackBox' {
+  /** Parameters for sendUserRating from useChatFeedbackBox. */
   type SendUserRatingProps = {
+      /** Rating value (e.g. 1–5). */
       ratingScore: number;
+      /** Optional free-text feedback. */
       description: string;
   };
+  /**
+   * Hook for the feedback modal: open/close and send rating.
+   * Uses useChatbot() for apiURL, locale, chatMessages, publicHash, visitorId.
+   *
+   * @returns { opened, open, close, sendUserRating, loading } — loading true while submit in progress
+   */
   export const useChatFeedbackBox: () => {
       opened: boolean;
       open: () => void;
@@ -449,22 +483,35 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatFeedbackBox' {
   //# sourceMappingURL=useChatFeedbackBox.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatFeedbackBox.d.ts' {
-  {"version":3,"file":"useChatFeedbackBox.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatFeedbackBox.ts"],"names":[],"mappings":"AAIA,KAAK,mBAAmB,GAAG;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,kBAAkB;;;;oDAkB1B,mBAAmB;;CA6BvB,CAAA"}
+  {"version":3,"file":"useChatFeedbackBox.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatFeedbackBox.ts"],"names":[],"mappings":"AAIA,6DAA6D;AAC7D,KAAK,mBAAmB,GAAG;IACzB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;oDAkB1B,mBAAmB;;CA6BvB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbot' {
+  /**
+   * Returns the chatbot context (state and actions).
+   * Must be used within a ChatbotProvider; throws otherwise.
+   *
+   * @returns ChatbotContextProps (locale, chatMessages, makeQuestion, opened, openedToggle, status, etc.)
+   */
   export const useChatbot: () => import("@ibti-tech/chatbot/contexts/Chatbot/context").ChatbotContextProps;
   export default useChatbot;
   //# sourceMappingURL=useChatbot.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbot.d.ts' {
-  {"version":3,"file":"useChatbot.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbot.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,+CAMtB,CAAA;AAED,eAAe,UAAU,CAAA"}
+  {"version":3,"file":"useChatbot.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbot.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,eAAO,MAAM,UAAU,+CAMtB,CAAA;AAED,eAAe,UAAU,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotMessages' {
   import { ChatbotTypes } from 'types';
+  /**
+   * Options for useChatbotMessages (used internally by ChatbotProvider).
+   */
   export type UseChatbotMessagesOptions = {
+      /** Base URL of the chatbot API. */
       apiURL: string;
+      /** Locale: 'pt-BR' | 'en'. */
       locale: ChatbotTypes.Locale;
+      /** Optional. Public hash when using the public API. */
       publicHash?: string;
+      /** Optional. Visitor id for conversation continuity. */
       visitorId?: string;
   };
   export const useChatbotMessages: ({ apiURL, locale, publicHash, visitorId, }: UseChatbotMessagesOptions) => {
@@ -485,15 +532,25 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotMessages' {
   //# sourceMappingURL=useChatbotMessages.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotMessages.d.ts' {
-  {"version":3,"file":"useChatbotMessages.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbotMessages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAYpC,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,4CAKhC,yBAAyB;;iCA2JgB,MAAM;;;;;;;;;;;CAqNjD,CAAA;AAED,eAAe,kBAAkB,CAAA"}
+  {"version":3,"file":"useChatbotMessages.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbotMessages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAYpC;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,4CAKhC,yBAAyB;;iCA2JgB,MAAM;;;;;;;;;;;CAqNjD,CAAA;AAED,eAAe,kBAAkB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotSuggestedQuestions' {
   import { ChatbotTypes } from 'types';
+  /**
+   * Options for useChatbotSuggestedQuestions (used internally for suggested questions).
+   */
   export type UseChatbotSuggestedQuestionsOptions = {
+      /** Current conversation context (role + content). */
       chatContext: ChatbotTypes.ChatContextItem[];
+      /** Base URL of the API. */
       apiURL: string;
+      /** Locale: 'pt-BR' | 'en'. */
       locale: ChatbotTypes.Locale;
   };
+  /**
+   * Hook for suggested questions (used by ChatbotProvider).
+   * Returns loading state, list of question strings, fetchData, and resetData.
+   */
   export const useChatbotSuggestedQuestions: ({ chatContext, locale, apiURL, }: UseChatbotSuggestedQuestionsOptions) => {
       loading: boolean;
       data: string[];
@@ -503,7 +560,7 @@ declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotSuggestedQuestions
   //# sourceMappingURL=useChatbotSuggestedQuestions.d.ts.map
 }
 declare module '@ibti-tech/chatbot/contexts/Chatbot/useChatbotSuggestedQuestions.d.ts' {
-  {"version":3,"file":"useChatbotSuggestedQuestions.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbotSuggestedQuestions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC,MAAM,MAAM,mCAAmC,GAAG;IAChD,WAAW,EAAE,YAAY,CAAC,eAAe,EAAE,CAAA;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;CAC5B,CAAA;AAED,eAAO,MAAM,4BAA4B,GAAI,kCAI1C,mCAAmC;;;;;CA2BrC,CAAA"}
+  {"version":3,"file":"useChatbotSuggestedQuestions.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/contexts/Chatbot/useChatbotSuggestedQuestions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,qDAAqD;IACrD,WAAW,EAAE,YAAY,CAAC,eAAe,EAAE,CAAA;IAC3C,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,kCAI1C,mCAAmC;;;;;CA2BrC,CAAA"}
 }
 declare module '@ibti-tech/chatbot/cookies/chat' {
   import { ChatbotTypes } from 'types';
@@ -555,30 +612,50 @@ declare module '@ibti-tech/chatbot/cookies/chat.d.ts' {
 }
 declare module '@ibti-tech/chatbot/embed' {
   /**
-   * Embed entry point for HTML/WordPress/PHP.
-   * Reads config from window.IBTIChatbotConfig or data-* attributes on the script element.
-   * Mounts the chatbot widget into a container (auto-created or existing #ibti-chatbot-root).
+   * Embed entry point for HTML / WordPress / PHP.
+   * Config: window.IBTIChatbotConfig or data-* attributes on the script tag.
+   * Mounts the widget into #ibti-chatbot-root (or containerId). Exposes window.IBTIChatbotEmbed.init(config) and destroy().
    */
   import type { ChatbotTypes } from '@ibti-tech/chatbot/types/index';
-  /** Embed configuration (from window.IBTIChatbotConfig or data-* attributes). */
+  /**
+   * Embed configuration. Pass to IBTIChatbotEmbed.init(config) or set window.IBTIChatbotConfig.
+   * data-* attributes: data-api-url, data-public-hash, data-locale, data-theme, data-position, data-colors (JSON), data-icon, data-texts (JSON).
+   */
   export interface IBTIChatbotEmbedConfig {
+      /** Base URL of the chatbot API. Required. */
       apiURL: string;
+      /** Public hash of the chatbot. Required. */
       publicHash: string;
+      /** Locale: 'pt-BR' | 'en'. Default: 'pt-BR'. */
       locale?: ChatbotTypes.Locale;
+      /** Theme: 'light' | 'dark'. Default: 'light'. */
       theme?: ChatbotTypes.Theme;
+      /** Bar position. Default: 'bottom-right'. */
       position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
-      /** Optional: custom container selector. Default creates a div appended to body. */
+      /** DOM id for the mount container. Default: 'ibti-chatbot-root'. If missing, a div is created and appended to body. */
       containerId?: string;
-      /** When true (e.g. admin embed preview), skip domain validation. Do not use in production embed. */
+      /** Skip domain validation (e.g. admin preview). Do not use in production. */
       skipDomainCheck?: boolean;
-      /** Custom colors for branding (hex or rgb). */
+      /** Custom colors: primaryColor, headerBackground, userBalloonColor (hex or rgb). */
       colors?: ChatbotTypes.CustomColors;
-      /** Initial open state of the chatbot. Default: false */
+      /** Initial open state of the chat panel. Default: false. */
       isOpen?: boolean;
-      /** Lucide icon name for the chatbot button/header (e.g. 'Bot', 'MessageCircle'). */
+      /** Lucide icon name for the button/header (e.g. 'Bot', 'MessageCircle'). */
       icon?: string;
-      /** Custom texts per locale for the chatbot UI. */
+      /** Custom UI texts per locale: { 'pt-BR': CustomTexts, 'en': CustomTexts }. */
       texts?: ChatbotTypes.Texts;
+      /** When true and position is top-*, the bar pushes page content down (no overlay). Avoids extra scroll when combined with body class .ibti-chatbot-push-down. */
+      pushContentDown?: boolean;
+      /** Offset from top (e.g. '64px', 80). Use to sit below a fixed header. */
+      topOffset?: string | number;
+      /** When true, sets z-index to 9999 so the chatbot appears above header elements. */
+      aboveHeader?: boolean;
+      /** Bar background when pushContentDown (light theme). Default rgb(230,230,230). */
+      pushContentDownRowBackgroundLight?: string;
+      /** Bar background when pushContentDown (dark theme). Default rgb(0,0,0). */
+      pushContentDownRowBackgroundDark?: string;
+      /** Height in px of the bar when pushContentDown is true. Default: 32. Clamped between 24 and 120. */
+      pushContentDownBarHeight?: number;
   }
   global {
       interface Window {
@@ -593,7 +670,7 @@ declare module '@ibti-tech/chatbot/embed' {
   //# sourceMappingURL=embed.d.ts.map
 }
 declare module '@ibti-tech/chatbot/embed.d.ts' {
-  {"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/embed.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAA;IAC5B,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;IACpE,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oGAAoG;IACpG,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,YAAY,CAAC,YAAY,CAAA;IAClC,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;CAC3B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,CAAC,EAAE,sBAAsB,CAAA;QAC1C,gBAAgB,CAAC,EAAE;YACjB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAA;YAC/C,OAAO,EAAE,MAAM,IAAI,CAAA;SACpB,CAAA;KACF;CACF;AAyID,wBAAgB,UAAU,SAEzB"}
+  {"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/embed.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAA;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;IACpE,uHAAuH;IACvH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oFAAoF;IACpF,MAAM,CAAC,EAAE,YAAY,CAAC,YAAY,CAAA;IAClC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAA;IAC1B,iKAAiK;IACjK,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,oFAAoF;IACpF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mFAAmF;IACnF,iCAAiC,CAAC,EAAE,MAAM,CAAA;IAC1C,4EAA4E;IAC5E,gCAAgC,CAAC,EAAE,MAAM,CAAA;IACzC,qGAAqG;IACrG,wBAAwB,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,CAAC,EAAE,sBAAsB,CAAA;QAC1C,gBAAgB,CAAC,EAAE;YACjB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,sBAAsB,KAAK,IAAI,CAAA;YAC/C,OAAO,EAAE,MAAM,IAAI,CAAA;SACpB,CAAA;KACF;CACF;AAmJD,wBAAgB,UAAU,SAEzB"}
 }
 declare module '@ibti-tech/chatbot/events/assistant-answer' {
   export const dispatchAssitantAnswer: () => void;
@@ -711,6 +788,18 @@ declare module '@ibti-tech/chatbot/i18n/index.d.ts' {
   {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/i18n/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAI3C,eAAO,MAAM,OAAO,0BAA2B,CAAA;AAE/C,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAGzD,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,MAAM,YAAY,CAAC,MAAM,gBAAe,CAAA"}
 }
 declare module '@ibti-tech/chatbot/index' {
+  /**
+   * @ibti-tech/chatbot — React package entry.
+   *
+   * React usage:
+   * - ChatbotProvider: wrap your app; props: locale, apiURL, publicHash, theme, isOpen?, texts?, colors?, icon?, skipDomainCheck?, allowedOriginsWithoutCheck?
+   * - ChatbotBar: floating bar + panel; props: verticalPosition?, horizontalPosition?, deviceHorizontalPosition?, zIndex?, topOffset?, aboveHeader?, pushContentDown?, pushContentDownRowBackgroundLight?, pushContentDownRowBackgroundDark?
+   * - useChatbot(): returns context (chatMessages, makeQuestion, opened, openedToggle, status, etc.)
+   * - ChatbotContext: React context (prefer useChatbot())
+   * - ChatbotDevice: inner device component (usually used by ChatbotBar)
+   *
+   * Types: ChatbotTypes (Theme, Locale, CustomColors, ChatMessage, ChatContextItem, Status, InitializationStatus, ChatbotPublicResponse, Config, CustomTexts, Texts)
+   */
   export { useChatbot } from 'contexts/Chatbot/useChatbot';
   export { ChatbotContext } from 'contexts/Chatbot/context';
   export { ChatbotProvider } from 'contexts/Chatbot/provider';
@@ -720,7 +809,7 @@ declare module '@ibti-tech/chatbot/index' {
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA"}
 }
 declare module '@ibti-tech/chatbot/mocks/chatHistory' {
   export const chatHistoryMocked: readonly [{
@@ -788,61 +877,67 @@ declare module '@ibti-tech/chatbot/mocks/chatHistory.d.ts' {
 }
 declare module '@ibti-tech/chatbot/services/api/http-client' {
   /**
-   * Returns default headers for all API requests.
-   * Includes Content-Type and User-Agent (from navigator when available).
+   * Default headers for all chatbot API requests.
+   * - Content-Type: application/json
+   * - User-Agent: navigator.userAgent when available, else 'IBTI-Chatbot/1.0'
+   *
+   * @returns Record of header name to value (suitable for fetch headers)
    */
   export const getDefaultHeaders: () => Record<string, string>;
   //# sourceMappingURL=http-client.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/api/http-client.d.ts' {
-  {"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/api/http-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAIxD,CAAA"}
+  {"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/api/http-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAIxD,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/chat/chat.api' {
   import { ChatbotTypes } from 'types';
   import type { SendNewQuestionOptions } from '@ibti-tech/chatbot/services/types/index';
   /**
    * Sends chat context to the completion endpoint and streams the response.
-   * POST /chat/completion?locale=&hash=&visitorId=
+   * Endpoint: POST /chat/completion?locale=&hash=&visitorId=
    *
-   * @param options - Chat context, locale, callbacks, and optional hash/visitorId
+   * @param options - SendNewQuestionOptions: chatContext, locale, apiURL, optional publicHash/visitorId, onReceiving, onDone
+   * @returns Promise that resolves when the stream ends (no value)
+   * @throws Error when response is not ok (includes status in message)
    */
   export const sendChatContext: ({ chatContext, locale, onReceiving, onDone, apiURL, publicHash, visitorId, }: SendNewQuestionOptions) => Promise<void>;
   /**
-   * Checks if the API is available by making a lightweight request.
-   * Tries HEAD first, falls back to GET if HEAD fails.
+   * Checks if the API is available (lightweight health check).
+   * Tries HEAD on /chat/welcome first; falls back to GET on failure. Timeout: 5s.
    *
-   * @param apiUrl - Base URL of the API
-   * @param locale - Locale for the request
-   * @param publicHash - Optional; includes hash in welcome URL when provided
-   * @returns true if API responds with ok status
+   * @param apiUrl - Base URL of the API (e.g. https://api.example.com)
+   * @param locale - Locale for query: 'pt-BR' | 'en'
+   * @param publicHash - Optional; added as query param when provided
+   * @returns true if response is ok, false on error or timeout
    */
   export const checkApiHealth: (apiUrl: string, locale?: ChatbotTypes.Locale, publicHash?: string) => Promise<boolean>;
   /**
    * Fetches the welcome message for the chatbot.
-   * GET /chat/welcome?locale=&hash=
+   * Endpoint: GET /chat/welcome?locale=&hash=
    *
    * @param apiUrl - Base URL of the API
-   * @param locale - Locale for the welcome message
-   * @param publicHash - Optional; identifies the chatbot when provided
-   * @returns The welcome message string
+   * @param locale - Locale for the welcome message: 'pt-BR' | 'en'
+   * @param publicHash - Optional; chatbot identifier when using public API
+   * @returns Promise resolving to the welcome message string
+   * @throws Error when response is not ok (uses i18n error message + status)
    */
   export const getWelcomeMessage: (apiUrl: string, locale?: ChatbotTypes.Locale, publicHash?: string) => Promise<string>;
   //# sourceMappingURL=chat.api.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/chat/chat.api.d.ts' {
-  {"version":3,"file":"chat.api.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/chat/chat.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAU,8EAQnC,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAwCvC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,EACd,SAAQ,YAAY,CAAC,MAAa,EAClC,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CAuCjB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,SAAQ,YAAY,CAAC,MAAa,EAClC,aAAa,MAAM,KAClB,OAAO,CAAC,MAAM,CAoBhB,CAAA"}
+  {"version":3,"file":"chat.api.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/chat/chat.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEtD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAU,8EAQnC,sBAAsB,KAAG,OAAO,CAAC,IAAI,CAwCvC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,EACd,SAAQ,YAAY,CAAC,MAAa,EAClC,aAAa,MAAM,KAClB,OAAO,CAAC,OAAO,CAuCjB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,SAAQ,YAAY,CAAC,MAAa,EAClC,aAAa,MAAM,KAClB,OAAO,CAAC,MAAM,CAoBhB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/chatbot/chatbot.api' {
   import { ChatbotTypes } from 'types';
   /**
    * Fetches a chatbot by its public hash.
-   * GET /chatbots/public/:hash
-   * Results are cached in memory for 5 minutes to speed up repeated loads (e.g. preview).
+   * Endpoint: GET /chatbots/public/:hash
+   * Results are cached in memory for 5 minutes (key: apiURL:publicHash).
    *
-   * @param apiURL - Base URL of the API
-   * @param publicHash - Public hash of the chatbot
-   * @returns The chatbot with domain, settings, instructions
-   * @throws Error when chatbot is not found (404 or other error status)
+   * @param apiURL - Base URL of the API (no trailing slash)
+   * @param publicHash - Public hash of the chatbot (from admin/embed config)
+   * @returns Promise resolving to ChatbotPublicResponse (id, name, domain, etc.)
+   * @throws Error when chatbot is not found (e.g. 404) or request fails
    */
   export const getChatbotByPublicHash: (apiURL: string, publicHash: string) => Promise<ChatbotTypes.ChatbotPublicResponse>;
   //# sourceMappingURL=chatbot.api.d.ts.map
@@ -853,25 +948,34 @@ declare module '@ibti-tech/chatbot/services/chatbot/chatbot.api.d.ts' {
 declare module '@ibti-tech/chatbot/services/feedback/feedback.api' {
   import type { SendUserChatFeedbackParams } from '@ibti-tech/chatbot/services/types/index';
   /**
-   * Sends user feedback (rating) for the chat session.
-   * POST /chat/feedback
+   * Sends user feedback (rating) for the current chat session.
+   * Endpoint: POST /chat/feedback
+   * Body: locale, rating_score, chat_context, message (optional), hash (optional), visitorId (optional).
    *
-   * When publicHash and visitorId are provided, the API can associate
-   * the feedback with the correct conversation.
-   *
-   * @param params - Feedback data including rating, context, optional hash/visitorId
-   * @returns The fetch Response (caller should check response.ok)
+   * @param params - SendUserChatFeedbackParams: apiURL, locale, chatContext, ratingScore, optional description, publicHash, visitorId
+   * @returns Promise resolving to the fetch Response; check response.ok for success
    */
   export const sendUserChatFeedback: ({ apiURL, chatContext, locale, ratingScore, description, publicHash, visitorId, }: SendUserChatFeedbackParams) => Promise<Response>;
   //# sourceMappingURL=feedback.api.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/feedback/feedback.api.d.ts' {
-  {"version":3,"file":"feedback.api.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/feedback/feedback.api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAU,mFAQxC,0BAA0B,KAAG,OAAO,CAAC,QAAQ,CAa/C,CAAA"}
+  {"version":3,"file":"feedback.api.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/feedback/feedback.api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAU,mFAQxC,0BAA0B,KAAG,OAAO,CAAC,QAAQ,CAa/C,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/index' {
   /**
-   * Services barrel export.
-   * Provides backward-compatible imports from 'services/chatbot-api' equivalent.
+   * Chatbot API services (barrel).
+   * Use these when integrating the chatbot or building a custom client.
+   *
+   * Chatbot config:
+   * - getChatbotByPublicHash(apiURL, publicHash) → ChatbotPublicResponse
+   *
+   * Chat:
+   * - sendChatContext(options) → streams completion, calls onReceiving/onDone
+   * - checkApiHealth(apiUrl, locale?, publicHash?) → boolean
+   * - getWelcomeMessage(apiUrl, locale?, publicHash?) → string
+   *
+   * Feedback:
+   * - sendUserChatFeedback(params) → Response
    */
   export { getChatbotByPublicHash } from '@ibti-tech/chatbot/services/chatbot/chatbot.api';
   export { sendChatContext, checkApiHealth, getWelcomeMessage, } from '@ibti-tech/chatbot/services/chat/chat.api';
@@ -880,24 +984,32 @@ declare module '@ibti-tech/chatbot/services/index' {
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAE9D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,SAAS,CAAA"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAE9D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,SAAS,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/types/chat.types' {
   import { ChatbotTypes } from 'types';
   /**
-   * Options for sending a new question to the chat completion endpoint.
+   * Options for sending a new question to the chat completion endpoint (POST /chat/completion).
+   * Used by `sendChatContext`.
    */
   export type SendNewQuestionOptions = {
+      /** Ordered list of messages (role + content) to send as context. */
       chatContext: Pick<ChatbotTypes.ChatMessage, 'content' | 'role'>[];
+      /** Locale for the request: `'pt-BR'` | `'en'`. */
       locale: ChatbotTypes.Locale;
+      /** Base URL of the chatbot API (no trailing slash). */
       apiURL: string;
+      /** Optional. Public hash of the chatbot (required for domain-validated API). */
       publicHash?: string;
+      /** Optional. Stable visitor id for conversation continuity. */
       visitorId?: string;
+      /** Called for each streamed chunk: full message so far and the new chunk. */
       onReceiving: (receivedMessage: string, receivedPart: string) => void;
+      /** Called when the stream finishes. */
       onDone: () => void;
   };
   /**
-   * Options for fetching suggested questions (currently unused).
+   * Options for fetching suggested questions (currently unused in UI).
    */
   export type GetSuggestedQuestions = {
       chatContext: Pick<ChatbotTypes.ChatMessage, 'content' | 'role'>[];
@@ -905,32 +1017,40 @@ declare module '@ibti-tech/chatbot/services/types/chat.types' {
       apiURL: string;
   };
   /**
-   * DTO for suggested questions response.
+   * Suggested question DTO (single string per item; API may return an array of these).
    */
   export type SuggestedQuestionDTO = string;
   //# sourceMappingURL=chat.types.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/types/chat.types.d.ts' {
-  {"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/types/chat.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;IACpE,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAA"}
+  {"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/types/chat.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,oEAAoE;IACpE,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,kDAAkD;IAClD,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,WAAW,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;IACpE,uCAAuC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/types/feedback.types' {
   import { ChatbotTypes } from 'types';
   /**
-   * Parameters for sending user chat feedback (rating).
+   * Parameters for sending user chat feedback (POST /chat/feedback).
+   * Used by `sendUserChatFeedback`.
    */
   export type SendUserChatFeedbackParams = {
+      /** Locale: `'pt-BR'` | `'en'`. */
       locale: ChatbotTypes.Locale;
+      /** Base URL of the chatbot API. */
       apiURL: string;
+      /** Optional. Public hash of the chatbot. */
       publicHash?: string;
+      /** Optional. Visitor id to associate feedback with the conversation. */
       visitorId?: string;
+      /** Current conversation context (role + content) for the session being rated. */
       chatContext: Pick<ChatbotTypes.ChatMessage, 'content' | 'role'>[];
+      /** Rating score (e.g. 1–5). */
       ratingScore: number;
+      /** Optional. Free-text feedback. */
       description?: string;
   };
   //# sourceMappingURL=feedback.types.d.ts.map
 }
 declare module '@ibti-tech/chatbot/services/types/feedback.types.d.ts' {
-  {"version":3,"file":"feedback.types.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/types/feedback.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}
+  {"version":3,"file":"feedback.types.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/services/types/feedback.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,kCAAkC;IAClC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAA;IAC3B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iFAAiF;IACjF,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,CAAA;IACjE,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA"}
 }
 declare module '@ibti-tech/chatbot/services/types/index' {
   export * from '@ibti-tech/chatbot/services/types/chat.types';
@@ -1072,33 +1192,64 @@ declare module '@ibti-tech/chatbot/themes/index.d.ts' {
   {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/themes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEzC,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGlB,CAAA;AAED,gDAAgD;AAChD,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,OAAO,iBAAiB,EACnC,YAAY,CAAC,EAAE,YAAY,CAAC,YAAY,GACvC,OAAO,iBAAiB,CAqC1B"}
 }
 declare module '@ibti-tech/chatbot/types/index' {
+  /**
+   * Chatbot frontend type definitions.
+   * Use these types when integrating the chatbot as a client (React app or embed).
+   */
   export namespace ChatbotTypes {
+      /** UI theme: `'light'` or `'dark'`. */
       type Theme = 'light' | 'dark';
+      /** Supported locales: `'pt-BR'` | `'en'`. */
       type Locale = 'pt-BR' | 'en';
-      /** Custom colors to override chatbot theme elements. Values in hex (#rrggbb) or rgb(r,g,b). */
+      /**
+       * Custom colors to override chatbot theme elements.
+       * Values: hex (e.g. `#rrggbb`) or `rgb(r,g,b)`.
+       */
       interface CustomColors {
-          /** Primary accent: header avatar, toggle, buttons, user balloons, links, scrollbars */
+          /** Primary accent: header avatar, toggle button, action buttons, user balloons, links, scrollbars. */
           primaryColor?: string;
-          /** Header bar background. Defaults to primaryColor if not set */
+          /** Header bar background. Defaults to `primaryColor` if not set. */
           headerBackground?: string;
-          /** User message balloon background. Defaults to primaryColor if not set */
+          /** User message balloon background. Defaults to `primaryColor` if not set. */
           userBalloonColor?: string;
       }
+      /**
+       * A single message in the chat thread (user or assistant).
+       */
       type ChatMessage = {
+          /** Unique message id (e.g. UUID). */
           id: string;
+          /** ISO/UTC timestamp string. */
           timestamp: string;
+          /** Sender: `'user'` or `'assistant'`. */
           role: 'user' | 'assistant';
+          /** Message body (plain text). */
           content: string;
+          /** When true, content is an error message to display. */
           error?: boolean;
       };
+      /**
+       * Minimal message shape for API context (role + content only).
+       * Used when sending chat context to completion or feedback endpoints.
+       */
       type ChatContextItem = {
           role: 'user' | 'assistant';
           content: string;
       };
+      /** Widget status shown in the header: writing indicator, loading, online, or unavailable. */
       type Status = 'writing' | 'loading' | 'online' | 'unavailable';
-      /** Status of the widget initialization */
+      /**
+       * Initialization state of the widget (when using `publicHash`).
+       * - `loading`: fetching chatbot config
+       * - `domain_not_allowed`: current origin not in allowed domains
+       * - `error`: network or API error
+       * - `ready`: widget ready to chat
+       */
       type InitializationStatus = 'loading' | 'domain_not_allowed' | 'error' | 'ready';
-      /** Response from GET /chatbots/public/:hash */
+      /**
+       * Response from GET `/chatbots/public/:hash`.
+       * Contains chatbot metadata and domain info.
+       */
       interface ChatbotPublicResponse {
           id: number;
           name: string;
@@ -1112,12 +1263,21 @@ declare module '@ibti-tech/chatbot/types/index' {
           chatInstructions?: unknown;
           client?: unknown;
       }
+      /**
+       * Optional config for API and domain behaviour.
+       * Used internally; for embed/client prefer ChatbotProvider props or IBTIChatbotEmbedConfig.
+       */
       interface Config {
           apiURL?: string;
           publicHash?: string;
           additionalInstructions?: string;
+          /** Origins that skip domain validation (e.g. for preview). */
           allowedOriginsWithoutCheck?: string[];
       }
+      /**
+       * Custom UI copy per section (locale key → strings).
+       * Override only the keys you need; rest use defaults.
+       */
       interface CustomTexts {
           CHATBOT_NAME?: string;
           INPUT_PLACEHOLDER?: string;
@@ -1155,6 +1315,7 @@ declare module '@ibti-tech/chatbot/types/index' {
           USER_LABEL?: string;
           WRITING_MESSAGE?: string;
       }
+      /** Map of locale code to CustomTexts. Example: `{ 'pt-BR': { ... }, 'en': { ... } }`. */
       interface Texts {
           [locale: string]: CustomTexts;
       }
@@ -1162,7 +1323,7 @@ declare module '@ibti-tech/chatbot/types/index' {
   //# sourceMappingURL=index.d.ts.map
 }
 declare module '@ibti-tech/chatbot/types/index.d.ts' {
-  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/types/index.ts"],"names":[],"mappings":"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"}
+  {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/ibti-chatbot/ibti-chatbot/src/types/index.ts"],"names":[],"mappings":"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"}
 }
 declare module '@ibti-tech/chatbot/utils/domainValidation' {
   /**

package/dist/index.mjs

@@ -1019,10 +1019,11 @@ var Wrapper = styled.div`
   
   /* Default height - will be overridden by specific states */
   ${(props) => {
+  const barH = props.$pushContentDownBarHeight ?? 32;
   if (props.$pushContentDown && props.$verticalPosition === "top") {
     if (!props.$opened) {
       return css`
-          height: 32px;
+          height: ${barH}px;
         `;
     }
     return css`
@@ -1080,12 +1081,13 @@ var Wrapper = styled.div`
   ${screens.tablet} {
     /* Height when closed with pushContentDown vs opened */
     ${(props) => {
+  const barH = props.$pushContentDownBarHeight ?? 32;
   if (props.$pushContentDown && props.$verticalPosition === "top") {
     if (!props.$opened) {
       return css`
-            height: 32px !important;
-            max-height: 32px !important;
-            min-height: 32px !important;
+            height: ${barH}px !important;
+            max-height: ${barH}px !important;
+            min-height: ${barH}px !important;
           `;
     } else {
       return css`
@@ -1131,18 +1133,20 @@ var Wrapper = styled.div`
   }
 
   /* Closed state styles */
-  ${(props) => !props.$opened && (props.$verticalPosition === "top" ? css`
+  ${(props) => {
+  const barH = props.$pushContentDownBarHeight ?? 32;
+  return !props.$opened && (props.$verticalPosition === "top" ? css`
           ${props.$pushContentDown ? css`
                 /* Push content down mode: show only toggle button - based on commit 8379cc8 */
-                height: 32px !important;
-                max-height: 32px !important;
-                min-height: 32px !important;
+                height: ${barH}px !important;
+                max-height: ${barH}px !important;
+                min-height: ${barH}px !important;
                 transform: none !important;
                 overflow: visible !important;
                 ${screens.tablet} {
-                  height: 32px !important;
-                  max-height: 32px !important;
-                  min-height: 32px !important;
+                  height: ${barH}px !important;
+                  max-height: ${barH}px !important;
+                  min-height: ${barH}px !important;
                   transform: none !important;
                 }
                 > *:not(:last-child) {
@@ -1150,9 +1154,9 @@ var Wrapper = styled.div`
                 }
                 > *:last-child {
                   flex-shrink: 0 !important;
-                  min-height: 32px !important;
-                  height: 32px !important;
-                  max-height: 32px !important;
+                  min-height: ${barH}px !important;
+                  height: ${barH}px !important;
+                  max-height: ${barH}px !important;
                   width: 100% !important;
                   min-width: 100% !important;
                   max-width: 100% !important;
@@ -1161,11 +1165,11 @@ var Wrapper = styled.div`
                 }
               ` : css`
                 /* Overlay mode: translate up to show only toggle button - based on commit 8379cc8 */
-                transform: translateY(calc(-100% + 32px));
+                transform: translateY(calc(-100% + ${barH}px));
               `}
         ` : css`
           /* Bottom position: translate down to show only toggle button */
-          transform: translateY(calc(100% - 32px));
+          transform: translateY(calc(100% - ${barH}px));
           width: 100%;
           
           ${screens.tablet} {
@@ -1180,11 +1184,12 @@ var Wrapper = styled.div`
           
           > *:last-child {
             flex-shrink: 0;
-            min-height: 32px;
-            height: 32px;
+            min-height: ${barH}px;
+            height: ${barH}px;
             width: 100%;
           }
-        `)}
+        `);
+}}
   
   /* Opened state styles when pushContentDown is true - must come after closed state */
   /* Chat overlays (Bar is fixed); same internal layout as overlay — no display overrides */
@@ -2530,9 +2535,9 @@ var ChatbotFooter_default = ChatbotFooter;
 import { screens as screens2 } from "@ibti-tech/ui";
 import { css as css4, styled as styled9 } from "styled-components";
 var ButtonWrapper = styled9.button`
-  height: 32px !important;
-  min-height: 32px !important;
-  max-height: 32px !important;
+  height: ${(p) => p.$barHeight ?? 32}px !important;
+  min-height: ${(p) => p.$barHeight ?? 32}px !important;
+  max-height: ${(p) => p.$barHeight ?? 32}px !important;
   width: 100% !important;
   min-width: 100% !important;
   max-width: 100% !important;
@@ -2561,8 +2566,8 @@ var ButtonWrapper = styled9.button`
   ${(props) => !props.$opened && props.$verticalPosition === "bottom" && css4`
       background-color: ${props.theme.colors.layers[1].background};
       cursor: pointer;
-      min-height: 32px;
-      height: 32px;
+      min-height: ${props.$barHeight ?? 32}px;
+      height: ${props.$barHeight ?? 32}px;
       width: 100%;
       flex-shrink: 0;
       box-sizing: border-box;
@@ -2595,10 +2600,12 @@ var ButtonWrapper = styled9.button`
 // src/components/ChatbotToggle/index.tsx
 import React12 from "react";
 import { ChevronDownIcon, ChevronUpIcon } from "@ibti-tech/ui/dist/icons";
+var DEFAULT_BAR_HEIGHT = 32;
 var ChatbotToggle = /* @__PURE__ */ __name(({
   verticalPosition = "bottom",
   opened: openedProp,
-  pushContentDown = false
+  pushContentDown = false,
+  pushContentDownBarHeight = DEFAULT_BAR_HEIGHT
 }) => {
   const { opened: openedContext, openedToggle, theme: themeMode } = useChatbot_default();
   const opened = openedProp ?? openedContext;
@@ -2612,7 +2619,8 @@ var ChatbotToggle = /* @__PURE__ */ __name(({
       $opened: opened,
       $verticalPosition: verticalPosition,
       $pushContentDown: pushContentDown,
-      $themeMode: themeMode
+      $themeMode: themeMode,
+      $barHeight: pushContentDownBarHeight
     },
     /* @__PURE__ */ React12.createElement(BotIcon, null),
     /* @__PURE__ */ React12.createElement("span", null, toggleText),
@@ -2852,20 +2860,24 @@ var useChatFeedbackBox = /* @__PURE__ */ __name(() => {
 }, "useChatFeedbackBox");
 
 // src/components/ChatbotDevice/index.tsx
+var DEFAULT_PUSH_DOWN_BAR_HEIGHT = 32;
 var ChatbotDevice = /* @__PURE__ */ __name(({
   verticalPosition = "bottom",
   pushContentDown = false,
-  horizontalPosition
+  horizontalPosition,
+  pushContentDownBarHeight = DEFAULT_PUSH_DOWN_BAR_HEIGHT
 }) => {
   const { opened } = useChatbot_default();
   const chatFeedbackBox = useChatFeedbackBox();
+  const barH = pushContentDownBarHeight;
   return /* @__PURE__ */ React14.createElement(
     Wrapper,
     {
       $opened: opened,
       $verticalPosition: verticalPosition,
       $pushContentDown: pushContentDown,
-      $horizontalPosition: horizontalPosition
+      $horizontalPosition: horizontalPosition,
+      $pushContentDownBarHeight: barH
     },
     /* @__PURE__ */ React14.createElement(ChatUserFeedbackRating, { chatFeedbackBox }),
     /* @__PURE__ */ React14.createElement(ChatbotHeader_default, { chatFeedbackBox }),
@@ -2876,7 +2888,8 @@ var ChatbotDevice = /* @__PURE__ */ __name(({
       {
         verticalPosition,
         opened,
-        pushContentDown
+        pushContentDown,
+        pushContentDownBarHeight: barH
       }
     )
   );
@@ -2954,20 +2967,22 @@ var PushDownRow = styled11.div`
   position: absolute;
   inset: 0;
   width: 100%;
-  height: 32px;
-  min-height: 32px;
+  height: ${(p) => p.$barHeight}px;
+  min-height: ${(p) => p.$barHeight}px;
   background-color: ${(p) => p.$background};
   z-index: 0;
   pointer-events: none;
 `;
 var Wrapper10 = styled11.div`
   ${(props) => {
+  const barH = props.$pushContentDownBarHeight ?? 32;
+  const topVal = props.$topOffset !== void 0 ? typeof props.$topOffset === "number" ? `${props.$topOffset}px` : props.$topOffset : "0";
   if (props.$pushContentDown && props.$verticalPosition === "top") {
     if (props.$opened) {
       return css6`
           position: fixed !important;
           width: 100%;
-          top: 0 !important;
+          top: ${topVal} !important;
           bottom: auto !important;
           left: 0 !important;
           right: 0 !important;
@@ -2982,13 +2997,13 @@ var Wrapper10 = styled11.div`
             background-color: transparent;
             border: none;
             padding: 0;
-            top: ${props.$topOffset !== void 0 ? typeof props.$topOffset === "number" ? `${props.$topOffset}px` : props.$topOffset : "0"} !important;
+            top: ${topVal} !important;
             bottom: auto !important;
             ${props.$horizontalPosition === "right" ? css6`left: auto !important; right: 2.5rem !important;` : css6`left: 2.5rem !important; right: auto !important;`}
           }
           @media screen and (max-width: ${breakpoints3.tablet}px) {
             padding-top: 0 !important;
-            top: 0 !important;
+            top: ${topVal} !important;
             height: 100vh;
           }
         `;
@@ -2996,14 +3011,14 @@ var Wrapper10 = styled11.div`
     return css6`
         position: fixed !important;
         width: 100%;
-        top: 0 !important;
+        top: ${topVal} !important;
         bottom: auto !important;
         left: 0 !important;
         right: 0 !important;
         z-index: ${props.$zIndex !== void 0 ? props.$zIndex : props.theme.zIndex.modals};
         pointer-events: auto;
-        height: 32px !important;
-        min-height: 32px !important;
+        height: ${barH}px !important;
+        min-height: ${barH}px !important;
         background-color: transparent;
         ${screens3.tablet} {
           width: 100% !important;
@@ -3011,10 +3026,12 @@ var Wrapper10 = styled11.div`
           border: none;
           padding: 0;
           bottom: auto !important;
+          top: ${topVal} !important;
         }
         @media screen and (max-width: ${breakpoints3.tablet}px) {
-          height: 32px !important;
-          min-height: 32px !important;
+          height: ${barH}px !important;
+          min-height: ${barH}px !important;
+          top: ${topVal} !important;
         }
       `;
   }
@@ -3063,6 +3080,9 @@ import React15, { useEffect as useEffect8, useState as useState10 } from "react"
 import { createPortal } from "react-dom";
 var PUSH_DOWN_ROW_BG_LIGHT = "rgb(230, 230, 230)";
 var PUSH_DOWN_ROW_BG_DARK = "rgb(0, 0, 0)";
+var PUSH_DOWN_BAR_HEIGHT_PX = 32;
+var BODY_CLASS_PUSH_DOWN = "ibti-chatbot-push-down";
+var BODY_CSS_VAR_BAR_HEIGHT = "--ibti-chatbot-bar-height";
 var ChatbotBar = /* @__PURE__ */ __name(({
   verticalPosition = "bottom",
   horizontalPosition = "right",
@@ -3072,8 +3092,10 @@ var ChatbotBar = /* @__PURE__ */ __name(({
   aboveHeader = false,
   pushContentDown = false,
   pushContentDownRowBackgroundLight = PUSH_DOWN_ROW_BG_LIGHT,
-  pushContentDownRowBackgroundDark = PUSH_DOWN_ROW_BG_DARK
+  pushContentDownRowBackgroundDark = PUSH_DOWN_ROW_BG_DARK,
+  pushContentDownBarHeight = PUSH_DOWN_BAR_HEIGHT_PX
 }) => {
+  const barHeightPx = Math.max(24, Math.min(120, pushContentDownBarHeight));
   const { opened, theme } = useChatbot_default();
   const pushDownRowBackground = theme === "dark" ? pushContentDownRowBackgroundDark : pushContentDownRowBackgroundLight;
   const [portalContainer, setPortalContainer] = useState10(null);
@@ -3101,18 +3123,17 @@ var ChatbotBar = /* @__PURE__ */ __name(({
     }
   }, [verticalPosition]);
   const usePushDown = pushContentDown && verticalPosition === "top";
-  const content = /* @__PURE__ */ React15.createElement(React15.Fragment, null, usePushDown && /* @__PURE__ */ React15.createElement(
-    "div",
-    {
-      style: {
-        height: 33,
-        minHeight: 33,
-        width: "100%",
-        backgroundColor: pushDownRowBackground
-      },
-      "aria-hidden": true
-    }
-  ), /* @__PURE__ */ React15.createElement(
+  useEffect8(() => {
+    if (!usePushDown || typeof document === "undefined") return;
+    const body = document.body;
+    body.classList.add(BODY_CLASS_PUSH_DOWN);
+    body.style.setProperty(BODY_CSS_VAR_BAR_HEIGHT, `${barHeightPx}px`);
+    return () => {
+      body.classList.remove(BODY_CLASS_PUSH_DOWN);
+      body.style.removeProperty(BODY_CSS_VAR_BAR_HEIGHT);
+    };
+  }, [usePushDown, barHeightPx]);
+  const content = /* @__PURE__ */ React15.createElement(React15.Fragment, null, /* @__PURE__ */ React15.createElement(
     Wrapper10,
     {
       $verticalPosition: verticalPosition,
@@ -3121,9 +3142,17 @@ var ChatbotBar = /* @__PURE__ */ __name(({
       $zIndex: calculatedZIndex,
       $topOffset: topOffset,
       $aboveHeader: aboveHeader,
-      $pushContentDown: pushContentDown
+      $pushContentDown: pushContentDown,
+      $pushContentDownBarHeight: barHeightPx
     },
-    usePushDown && !opened && /* @__PURE__ */ React15.createElement(PushDownRow, { $background: pushDownRowBackground, "aria-hidden": true }),
+    usePushDown && !opened && /* @__PURE__ */ React15.createElement(
+      PushDownRow,
+      {
+        $background: pushDownRowBackground,
+        $barHeight: barHeightPx,
+        "aria-hidden": true
+      }
+    ),
     /* @__PURE__ */ React15.createElement(
       BarContainer,
       {
@@ -3138,7 +3167,8 @@ var ChatbotBar = /* @__PURE__ */ __name(({
         {
           verticalPosition,
           pushContentDown: usePushDown,
-          horizontalPosition: deviceHorizontalPosition
+          horizontalPosition: deviceHorizontalPosition,
+          pushContentDownBarHeight: barHeightPx
         }
       )
     )

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ibti-tech/chatbot",
-  "version": "0.8.0",
-  "description": "Chatbot developed for IBTI products",
+  "version": "0.8.5",
+  "description": "Chatbot system developed to be embedded in any website",
   "packageManager": "yarn@3.6.4",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.ts",