@tylertech/forge-ai 0.12.0 → 0.13.1

package/custom-elements.json

@@ -138,77 +138,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/lib/ai-artifact/ai-artifact.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AiArtifactComponentTagName",
-          "type": {
-            "text": "keyof HTMLElementTagNameMap"
-          },
-          "default": "'forge-ai-artifact'"
-        },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AiArtifactComponent",
-          "cssProperties": [
-            {
-              "description": "Surface color override for the toolbar (defaults to transparent)",
-              "name": "--forge-theme-surface"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Content for the start (left) side of the toolbar, typically used for titles or headings",
-              "name": "start"
-            },
-            {
-              "description": "Action buttons for the end (right) side of the toolbar",
-              "name": "actions"
-            },
-            {
-              "description": "Main content area below the toolbar",
-              "name": ""
-            }
-          ],
-          "members": [],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "forge-ai-artifact",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiArtifactComponentTagName",
-          "declaration": {
-            "name": "AiArtifactComponentTagName",
-            "module": "src/lib/ai-artifact/ai-artifact.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AiArtifactComponent",
-          "declaration": {
-            "name": "AiArtifactComponent",
-            "module": "src/lib/ai-artifact/ai-artifact.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "declaration": {
-            "name": "AiArtifactComponent",
-            "module": "src/lib/ai-artifact/ai-artifact.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/lib/ai-agent-selector/ai-agent-selector.ts",
@@ -344,137 +273,71 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/ai-assistant-response/ai-assistant-response.ts",
+      "path": "src/lib/ai-artifact/ai-artifact.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "AiAssistantResponseComponentTagName",
+          "name": "AiArtifactComponentTagName",
           "type": {
             "text": "keyof HTMLElementTagNameMap"
           },
-          "default": "'forge-ai-assistant-response'"
+          "default": "'forge-ai-artifact'"
         },
         {
           "kind": "class",
           "description": "",
-          "name": "AiAssistantResponseComponent",
-          "members": [
-            {
-              "kind": "field",
-              "name": "response",
-              "type": {
-                "text": "AssistantResponse"
-              },
-              "privacy": "public"
-            },
-            {
-              "kind": "field",
-              "name": "tools",
-              "type": {
-                "text": "Map<string, ToolDefinition> | undefined"
-              },
-              "privacy": "public"
-            },
-            {
-              "kind": "field",
-              "name": "enableReactions",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false",
-              "attribute": "enable-reactions"
-            },
+          "name": "AiArtifactComponent",
+          "cssProperties": [
             {
-              "kind": "field",
-              "name": "debugMode",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false",
-              "attribute": "debug-mode"
+              "description": "Surface color override for the toolbar (defaults to transparent)",
+              "name": "--forge-theme-surface"
             }
           ],
-          "events": [
-            {
-              "type": {
-                "text": "CustomEvent<{ responseId: string }>"
-              },
-              "description": "Fired when copy action is clicked",
-              "name": "forge-ai-assistant-response-copy"
-            },
-            {
-              "type": {
-                "text": "CustomEvent<{ responseId: string }>"
-              },
-              "description": "Fired when resend action is clicked",
-              "name": "forge-ai-assistant-response-resend"
-            },
+          "slots": [
             {
-              "type": {
-                "text": "CustomEvent<ForgeAiAssistantResponseFeedbackEventData>"
-              },
-              "description": "Fired when thumbs up is clicked",
-              "name": "forge-ai-assistant-response-thumbs-up"
+              "description": "Content for the start (left) side of the toolbar, typically used for titles or headings",
+              "name": "start"
             },
             {
-              "type": {
-                "text": "CustomEvent<ForgeAiAssistantResponseFeedbackEventData>"
-              },
-              "description": "Fired when thumbs down is clicked",
-              "name": "forge-ai-assistant-response-thumbs-down"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "enable-reactions",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "enableReactions"
+              "description": "Action buttons for the end (right) side of the toolbar",
+              "name": "actions"
             },
             {
-              "name": "debug-mode",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "debugMode"
+              "description": "Main content area below the toolbar",
+              "name": ""
             }
           ],
+          "members": [],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "forge-ai-assistant-response",
-          "customElement": true,
-          "summary": "Renders a complete assistant response with interleaved text chunks and tool calls."
+          "tagName": "forge-ai-artifact",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiAssistantResponseComponentTagName",
+          "name": "AiArtifactComponentTagName",
           "declaration": {
-            "name": "AiAssistantResponseComponentTagName",
-            "module": "src/lib/ai-assistant-response/ai-assistant-response.ts"
+            "name": "AiArtifactComponentTagName",
+            "module": "src/lib/ai-artifact/ai-artifact.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AiAssistantResponseComponent",
+          "name": "AiArtifactComponent",
           "declaration": {
-            "name": "AiAssistantResponseComponent",
-            "module": "src/lib/ai-assistant-response/ai-assistant-response.ts"
+            "name": "AiArtifactComponent",
+            "module": "src/lib/ai-artifact/ai-artifact.ts"
           }
         },
         {
           "kind": "custom-element-definition",
           "declaration": {
-            "name": "AiAssistantResponseComponent",
-            "module": "src/lib/ai-assistant-response/ai-assistant-response.ts"
+            "name": "AiArtifactComponent",
+            "module": "src/lib/ai-artifact/ai-artifact.ts"
           }
         }
       ]
@@ -651,73 +514,210 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/ai-button/ai-button.ts",
+      "path": "src/lib/ai-assistant-response/ai-assistant-response.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "AiButtonComponentTagName",
+          "name": "AiAssistantResponseComponentTagName",
           "type": {
             "text": "keyof HTMLElementTagNameMap"
           },
-          "default": "'forge-ai-button'"
+          "default": "'forge-ai-assistant-response'"
         },
         {
           "kind": "class",
           "description": "",
-          "name": "AiButtonComponent",
-          "slots": [
-            {
-              "description": "Default slot for button content",
-              "name": ""
-            }
-          ],
+          "name": "AiAssistantResponseComponent",
           "members": [
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "response",
+              "type": {
+                "text": "AssistantResponse"
+              },
+              "privacy": "public"
+            },
+            {
+              "kind": "field",
+              "name": "tools",
+              "type": {
+                "text": "Map<string, ToolDefinition> | undefined"
+              },
+              "privacy": "public"
+            },
+            {
+              "kind": "field",
+              "name": "enableReactions",
               "type": {
                 "text": "boolean"
               },
               "privacy": "public",
               "default": "false",
-              "description": "Whether the button is disabled",
-              "attribute": "disabled",
-              "reflects": true
-            }
-          ],
-          "attributes": [
+              "attribute": "enable-reactions"
+            },
             {
-              "name": "disabled",
+              "kind": "field",
+              "name": "debugMode",
               "type": {
                 "text": "boolean"
               },
+              "privacy": "public",
               "default": "false",
-              "description": "Whether the button is disabled",
-              "fieldName": "disabled"
+              "attribute": "debug-mode"
             }
           ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "forge-ai-button",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiButtonComponentTagName",
-          "declaration": {
-            "name": "AiButtonComponentTagName",
-            "module": "src/lib/ai-button/ai-button.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AiButtonComponent",
-          "declaration": {
-            "name": "AiButtonComponent",
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent<{ responseId: string }>"
+              },
+              "description": "Fired when copy action is clicked",
+              "name": "forge-ai-assistant-response-copy"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{ responseId: string }>"
+              },
+              "description": "Fired when resend action is clicked",
+              "name": "forge-ai-assistant-response-resend"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<ForgeAiAssistantResponseFeedbackEventData>"
+              },
+              "description": "Fired when thumbs up is clicked",
+              "name": "forge-ai-assistant-response-thumbs-up"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<ForgeAiAssistantResponseFeedbackEventData>"
+              },
+              "description": "Fired when thumbs down is clicked",
+              "name": "forge-ai-assistant-response-thumbs-down"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "enable-reactions",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "enableReactions"
+            },
+            {
+              "name": "debug-mode",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "debugMode"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "forge-ai-assistant-response",
+          "customElement": true,
+          "summary": "Renders a complete assistant response with interleaved text chunks and tool calls."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiAssistantResponseComponentTagName",
+          "declaration": {
+            "name": "AiAssistantResponseComponentTagName",
+            "module": "src/lib/ai-assistant-response/ai-assistant-response.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiAssistantResponseComponent",
+          "declaration": {
+            "name": "AiAssistantResponseComponent",
+            "module": "src/lib/ai-assistant-response/ai-assistant-response.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "declaration": {
+            "name": "AiAssistantResponseComponent",
+            "module": "src/lib/ai-assistant-response/ai-assistant-response.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-button/ai-button.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiButtonComponentTagName",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-ai-button'"
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AiButtonComponent",
+          "slots": [
+            {
+              "description": "Default slot for button content",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "description": "Whether the button is disabled",
+              "attribute": "disabled",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the button is disabled",
+              "fieldName": "disabled"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "forge-ai-button",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiButtonComponentTagName",
+          "declaration": {
+            "name": "AiButtonComponentTagName",
+            "module": "src/lib/ai-button/ai-button.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiButtonComponent",
+          "declaration": {
+            "name": "AiButtonComponent",
             "module": "src/lib/ai-button/ai-button.ts"
           }
         },
@@ -825,6 +825,10 @@
             {
               "description": "Slot for custom icon (default: forge-ai-icon)",
               "name": "icon"
+            },
+            {
+              "description": "Slot for custom header action buttons (rendered before built-in header actions)",
+              "name": "header-actions"
             }
           ],
           "members": [
@@ -3326,6 +3330,14 @@
               "description": "Slot for custom header icon (default: forge-ai-icon)",
               "name": "icon"
             },
+            {
+              "description": "Slot for custom header action buttons (rendered before built-in header actions)",
+              "name": "header-actions"
+            },
+            {
+              "description": "Slot for custom empty state icon",
+              "name": "empty-state-icon"
+            },
             {
               "description": "Slot for custom empty state content (overrides default suggestions)",
               "name": "empty-state"
@@ -5238,12 +5250,16 @@
               "name": "icon"
             },
             {
-              "description": "Slot for custom heading content",
+              "description": "Slot for custom heading content (welcome view only)",
               "name": "heading"
             },
             {
-              "description": "Slot for custom description/welcome message below the title",
+              "description": "Slot for custom description/welcome message below the title (welcome view only)",
               "name": "description"
+            },
+            {
+              "description": "Slot for custom header action buttons in conversation mode (rendered before built-in header actions)",
+              "name": "header-actions"
             }
           ],
           "members": [
@@ -6191,107 +6207,409 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/ai-dropdown-menu/ai-dropdown-menu-item-group.ts",
+      "path": "src/lib/ai-disclaimer/ai-disclaimer.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiDisclaimerComponentTagName",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-ai-disclaimer'"
+        },
         {
           "kind": "class",
           "description": "",
-          "name": "ForgeAiDropdownMenuItemGroupComponent",
+          "name": "AiDisclaimerComponent",
           "slots": [
             {
-              "description": "The default slot for dropdown menu items.",
+              "description": "Optional icon at top",
+              "name": "icon"
+            },
+            {
+              "description": "Default slot for scrollable disclaimer content",
               "name": ""
             },
             {
-              "description": "The label slot for the group heading text.",
-              "name": "label"
+              "description": "Text for Disagree button (default: \"Disagree\")",
+              "name": "disagree-button-text"
+            },
+            {
+              "description": "Text for Agree button (default: \"Agree\")",
+              "name": "agree-button-text"
             }
           ],
           "members": [],
+          "events": [
+            {
+              "name": "forge-ai-disclaimer-agree",
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when Agree button is clicked"
+            },
+            {
+              "name": "forge-ai-disclaimer-disagree",
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when Disagree button is clicked"
+            }
+          ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "summary": "A group component for organizing items within ai-dropdown-menu.",
-          "tagName": "forge-ai-dropdown-menu-item-group",
-          "customElement": true
+          "tagName": "forge-ai-disclaimer",
+          "customElement": true,
+          "summary": "Disclaimer overlay requiring user acknowledgment"
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "ForgeAiDropdownMenuItemGroupComponent",
+          "name": "AiDisclaimerComponentTagName",
           "declaration": {
-            "name": "ForgeAiDropdownMenuItemGroupComponent",
-            "module": "src/lib/ai-dropdown-menu/ai-dropdown-menu-item-group.ts"
+            "name": "AiDisclaimerComponentTagName",
+            "module": "src/lib/ai-disclaimer/ai-disclaimer.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiDisclaimerComponent",
+          "declaration": {
+            "name": "AiDisclaimerComponent",
+            "module": "src/lib/ai-disclaimer/ai-disclaimer.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "forge-ai-dropdown-menu-item-group",
           "declaration": {
-            "name": "ForgeAiDropdownMenuItemGroupComponent",
-            "module": "src/lib/ai-dropdown-menu/ai-dropdown-menu-item-group.ts"
+            "name": "AiDisclaimerComponent",
+            "module": "src/lib/ai-disclaimer/ai-disclaimer.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/ai-dropdown-menu/ai-dropdown-menu-item.ts",
+      "path": "src/lib/ai-embedded-chat/ai-embedded-chat.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiEmbeddedChatComponentTagName",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-ai-embedded-chat'"
+        },
         {
           "kind": "class",
           "description": "",
-          "name": "ForgeAiDropdownMenuItemComponent",
-          "cssProperties": [
-            {
-              "description": "Size of selection and submenu icons.",
-              "name": "--forge-ai-dropdown-menu-item-selection-icon-size"
-            }
-          ],
+          "name": "AiEmbeddedChatComponent",
           "slots": [
             {
-              "description": "The default slot for item text content.",
-              "name": ""
-            },
-            {
-              "description": "The description slot for additional item details.",
-              "name": "description"
-            },
-            {
-              "description": "The start icon slot.",
-              "name": "start"
-            },
-            {
-              "description": "The end icon slot.",
-              "name": "end"
+              "description": "Slot for custom header title content (default: \"AI Assistant\")",
+              "name": "header-title"
             },
             {
-              "description": "The slot for nested dropdown menu components.",
-              "name": "submenu"
+              "description": "Slot for custom empty state heading",
+              "name": "empty-state-heading"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "value",
+              "name": "expanded",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
               "privacy": "public",
-              "default": "''",
-              "description": "The value associated with this menu item.",
-              "attribute": "value"
+              "default": "false",
+              "description": "Controls whether the modal view is open when expanded.",
+              "attribute": "expanded"
             },
             {
               "kind": "field",
-              "name": "selected",
+              "name": "gradientVariant",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
               "privacy": "public",
-              "default": "false",
+              "default": "'medium'",
+              "description": "Gradient variant for embedded view ('low' | 'medium' | 'high', default: 'medium')",
+              "attribute": "gradient-variant"
+            },
+            {
+              "kind": "field",
+              "name": "adapter",
+              "type": {
+                "text": "AgentAdapter"
+              },
+              "privacy": "public",
+              "description": "Required. The adapter for communication with the AI service"
+            },
+            {
+              "kind": "field",
+              "name": "threadId",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "public",
+              "attribute": "thread-id"
+            },
+            {
+              "kind": "field",
+              "name": "fileUpload",
+              "type": {
+                "text": "FeatureToggle"
+              },
+              "privacy": "public",
+              "default": "'off'",
+              "description": "Enable file upload functionality (default: 'off')",
+              "attribute": "file-upload"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "default": "'Ask a question...'",
+              "description": "Placeholder text for input (default: \"Ask a question...\")",
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "field",
+              "name": "suggestions",
+              "type": {
+                "text": "Suggestion[]"
+              },
+              "privacy": "public",
+              "description": "Optional suggestions for empty state"
+            },
+            {
+              "kind": "method",
+              "name": "expand",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Expands the chat to modal view."
+            },
+            {
+              "kind": "method",
+              "name": "collapse",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Collapses the chat from modal view back to embedded view."
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when the chat is expanded to modal view",
+              "name": "forge-ai-embedded-chat-expand"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when the chat is collapsed from modal view",
+              "name": "forge-ai-embedded-chat-collapse"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Controls whether the modal view is open when expanded.",
+              "fieldName": "expanded"
+            },
+            {
+              "name": "gradient-variant",
+              "type": {
+                "text": "string"
+              },
+              "default": "'medium'",
+              "description": "Gradient variant for embedded view ('low' | 'medium' | 'high', default: 'medium')",
+              "fieldName": "gradientVariant"
+            },
+            {
+              "name": "thread-id",
+              "type": {
+                "text": "string | undefined"
+              },
+              "fieldName": "threadId"
+            },
+            {
+              "name": "file-upload",
+              "type": {
+                "text": "FeatureToggle"
+              },
+              "default": "'off'",
+              "description": "Enable file upload functionality (default: 'off')",
+              "fieldName": "fileUpload"
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Ask a question...'",
+              "description": "Placeholder text for input (default: \"Ask a question...\")",
+              "fieldName": "placeholder"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "forge-ai-embedded-chat",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiEmbeddedChatComponentTagName",
+          "declaration": {
+            "name": "AiEmbeddedChatComponentTagName",
+            "module": "src/lib/ai-embedded-chat/ai-embedded-chat.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiEmbeddedChatComponent",
+          "declaration": {
+            "name": "AiEmbeddedChatComponent",
+            "module": "src/lib/ai-embedded-chat/ai-embedded-chat.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "declaration": {
+            "name": "AiEmbeddedChatComponent",
+            "module": "src/lib/ai-embedded-chat/ai-embedded-chat.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-dropdown-menu/ai-dropdown-menu-item-group.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ForgeAiDropdownMenuItemGroupComponent",
+          "slots": [
+            {
+              "description": "The default slot for dropdown menu items.",
+              "name": ""
+            },
+            {
+              "description": "The label slot for the group heading text.",
+              "name": "label"
+            }
+          ],
+          "members": [],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "summary": "A group component for organizing items within ai-dropdown-menu.",
+          "tagName": "forge-ai-dropdown-menu-item-group",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ForgeAiDropdownMenuItemGroupComponent",
+          "declaration": {
+            "name": "ForgeAiDropdownMenuItemGroupComponent",
+            "module": "src/lib/ai-dropdown-menu/ai-dropdown-menu-item-group.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "forge-ai-dropdown-menu-item-group",
+          "declaration": {
+            "name": "ForgeAiDropdownMenuItemGroupComponent",
+            "module": "src/lib/ai-dropdown-menu/ai-dropdown-menu-item-group.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-dropdown-menu/ai-dropdown-menu-item.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ForgeAiDropdownMenuItemComponent",
+          "cssProperties": [
+            {
+              "description": "Size of selection and submenu icons.",
+              "name": "--forge-ai-dropdown-menu-item-selection-icon-size"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The default slot for item text content.",
+              "name": ""
+            },
+            {
+              "description": "The description slot for additional item details.",
+              "name": "description"
+            },
+            {
+              "description": "The start icon slot.",
+              "name": "start"
+            },
+            {
+              "description": "The end icon slot.",
+              "name": "end"
+            },
+            {
+              "description": "The slot for nested dropdown menu components.",
+              "name": "submenu"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "default": "''",
+              "description": "The value associated with this menu item.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
               "description": "Whether this menu item is selected.",
               "attribute": "selected",
               "reflects": true
@@ -6913,267 +7231,51 @@
                   "text": "ForgeAiDropdownMenuItemComponent[]"
                 }
               },
-              "description": "Gets the currently selected items"
-            },
-            {
-              "kind": "method",
-              "name": "getSelectedText",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "description": "Gets text representation of the current selection"
-            },
-            {
-              "kind": "method",
-              "name": "shouldShowSelectedText",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "description": "Checks if selection text should be displayed"
-            },
-            {
-              "kind": "method",
-              "name": "reset",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Resets the selection state"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SelectionManager",
-          "declaration": {
-            "name": "SelectionManager",
-            "module": "src/lib/ai-dropdown-menu/selection-manager.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/lib/ai-embedded-chat/ai-embedded-chat.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AiEmbeddedChatComponentTagName",
-          "type": {
-            "text": "keyof HTMLElementTagNameMap"
-          },
-          "default": "'forge-ai-embedded-chat'"
-        },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AiEmbeddedChatComponent",
-          "slots": [
-            {
-              "description": "Slot for custom header title content (default: \"AI Assistant\")",
-              "name": "header-title"
-            },
-            {
-              "description": "Slot for custom empty state heading",
-              "name": "empty-state-heading"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "expanded",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false",
-              "description": "Controls whether the modal view is open when expanded.",
-              "attribute": "expanded"
-            },
-            {
-              "kind": "field",
-              "name": "gradientVariant",
-              "type": {
-                "text": "string"
-              },
-              "privacy": "public",
-              "default": "'medium'",
-              "description": "Gradient variant for embedded view ('low' | 'medium' | 'high', default: 'medium')",
-              "attribute": "gradient-variant"
-            },
-            {
-              "kind": "field",
-              "name": "adapter",
-              "type": {
-                "text": "AgentAdapter"
-              },
-              "privacy": "public",
-              "description": "Required. The adapter for communication with the AI service"
-            },
-            {
-              "kind": "field",
-              "name": "threadId",
-              "type": {
-                "text": "string | undefined"
-              },
-              "privacy": "public",
-              "attribute": "thread-id"
-            },
-            {
-              "kind": "field",
-              "name": "fileUpload",
-              "type": {
-                "text": "FeatureToggle"
-              },
-              "privacy": "public",
-              "default": "'off'",
-              "description": "Enable file upload functionality (default: 'off')",
-              "attribute": "file-upload"
-            },
-            {
-              "kind": "field",
-              "name": "placeholder",
-              "type": {
-                "text": "string"
-              },
-              "privacy": "public",
-              "default": "'Ask a question...'",
-              "description": "Placeholder text for input (default: \"Ask a question...\")",
-              "attribute": "placeholder"
-            },
-            {
-              "kind": "field",
-              "name": "suggestions",
-              "type": {
-                "text": "Suggestion[]"
-              },
-              "privacy": "public",
-              "description": "Optional suggestions for empty state"
-            },
-            {
-              "kind": "method",
-              "name": "expand",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Expands the chat to modal view."
-            },
-            {
-              "kind": "method",
-              "name": "collapse",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Collapses the chat from modal view back to embedded view."
-            }
-          ],
-          "events": [
-            {
-              "type": {
-                "text": "CustomEvent<void>"
-              },
-              "description": "Fired when the chat is expanded to modal view",
-              "name": "forge-ai-embedded-chat-expand"
-            },
-            {
-              "type": {
-                "text": "CustomEvent<void>"
-              },
-              "description": "Fired when the chat is collapsed from modal view",
-              "name": "forge-ai-embedded-chat-collapse"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "expanded",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Controls whether the modal view is open when expanded.",
-              "fieldName": "expanded"
-            },
-            {
-              "name": "gradient-variant",
-              "type": {
-                "text": "string"
-              },
-              "default": "'medium'",
-              "description": "Gradient variant for embedded view ('low' | 'medium' | 'high', default: 'medium')",
-              "fieldName": "gradientVariant"
+              "description": "Gets the currently selected items"
             },
             {
-              "name": "thread-id",
-              "type": {
-                "text": "string | undefined"
+              "kind": "method",
+              "name": "getSelectedText",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
               },
-              "fieldName": "threadId"
+              "description": "Gets text representation of the current selection"
             },
             {
-              "name": "file-upload",
-              "type": {
-                "text": "FeatureToggle"
+              "kind": "method",
+              "name": "shouldShowSelectedText",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
-              "default": "'off'",
-              "description": "Enable file upload functionality (default: 'off')",
-              "fieldName": "fileUpload"
+              "description": "Checks if selection text should be displayed"
             },
             {
-              "name": "placeholder",
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "reset",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "default": "'Ask a question...'",
-              "description": "Placeholder text for input (default: \"Ask a question...\")",
-              "fieldName": "placeholder"
+              "description": "Resets the selection state"
             }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "forge-ai-embedded-chat",
-          "customElement": true
+          ]
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiEmbeddedChatComponentTagName",
-          "declaration": {
-            "name": "AiEmbeddedChatComponentTagName",
-            "module": "src/lib/ai-embedded-chat/ai-embedded-chat.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AiEmbeddedChatComponent",
-          "declaration": {
-            "name": "AiEmbeddedChatComponent",
-            "module": "src/lib/ai-embedded-chat/ai-embedded-chat.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
+          "name": "SelectionManager",
           "declaration": {
-            "name": "AiEmbeddedChatComponent",
-            "module": "src/lib/ai-embedded-chat/ai-embedded-chat.ts"
+            "name": "SelectionManager",
+            "module": "src/lib/ai-dropdown-menu/selection-manager.ts"
           }
         }
       ]
@@ -7200,7 +7302,7 @@
               "name": ""
             },
             {
-              "description": "The custom icon/graphic to display.",
+              "description": "The icon/graphic to display.",
               "name": "icon"
             },
             {
@@ -7391,10 +7493,28 @@
           "kind": "class",
           "description": "",
           "name": "AiFabComponent",
+          "cssProperties": [
+            {
+              "description": "The background color. Defaults to the gradient container background color.",
+              "name": "--forge-fab-background"
+            },
+            {
+              "description": "The color of the text. Only applies when in the extended state.",
+              "name": "--forge-fab-text-color"
+            },
+            {
+              "description": "The color of the outline. Defaults to the gradient container high state.",
+              "name": "--forge-fab-outline-color"
+            }
+          ],
           "slots": [
             {
               "description": "Default slot for button content",
               "name": ""
+            },
+            {
+              "description": "Slot for the icon",
+              "name": "icon"
             }
           ],
           "members": [
@@ -7858,113 +7978,339 @@
               "type": {
                 "text": "AiGradientContainerVariant"
               },
-              "default": "'medium'",
-              "description": "Gradient intensity variant",
-              "fieldName": "variant"
+              "default": "'medium'",
+              "description": "Gradient intensity variant",
+              "fieldName": "variant"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "forge-ai-gradient-container",
+          "customElement": true,
+          "states": [
+            {
+              "name": "low",
+              "description": "The container displays a low intensity gradient."
+            },
+            {
+              "name": "medium",
+              "description": "The container displays a medium intensity gradient."
+            },
+            {
+              "name": "high",
+              "description": "The container displays a high intensity gradient."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiGradientContainerComponentTagName",
+          "declaration": {
+            "name": "AiGradientContainerComponentTagName",
+            "module": "src/lib/ai-gradient-container/ai-gradient-container.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiGradientContainerComponent",
+          "declaration": {
+            "name": "AiGradientContainerComponent",
+            "module": "src/lib/ai-gradient-container/ai-gradient-container.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "declaration": {
+            "name": "AiGradientContainerComponent",
+            "module": "src/lib/ai-gradient-container/ai-gradient-container.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-icon/ai-icon.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiIconComponentTagName",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-ai-icon'"
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AiIconComponent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "outline",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "description": "Whether to display the icon with an outline",
+              "attribute": "outline"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "outline",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether to display the icon with an outline",
+              "fieldName": "outline"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "forge-ai-icon",
+          "customElement": true,
+          "states": [
+            {
+              "name": "no-border",
+              "description": "The icon is displayed without a border."
+            },
+            {
+              "name": "border",
+              "description": "The icon is displayed with a border."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiIconComponentTagName",
+          "declaration": {
+            "name": "AiIconComponentTagName",
+            "module": "src/lib/ai-icon/ai-icon.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiIconComponent",
+          "declaration": {
+            "name": "AiIconComponent",
+            "module": "src/lib/ai-icon/ai-icon.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "declaration": {
+            "name": "AiIconComponent",
+            "module": "src/lib/ai-icon/ai-icon.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-icon-button/ai-icon-button.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiIconButtonComponentTagName",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-ai-icon-button'"
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AiIconButtonComponent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "description": "Whether the button is disabled",
+              "attribute": "disabled",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the button is disabled",
+              "fieldName": "disabled"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "forge-ai-gradient-container",
-          "customElement": true,
-          "states": [
-            {
-              "name": "low",
-              "description": "The container displays a low intensity gradient."
-            },
-            {
-              "name": "medium",
-              "description": "The container displays a medium intensity gradient."
-            },
-            {
-              "name": "high",
-              "description": "The container displays a high intensity gradient."
-            }
-          ]
+          "tagName": "forge-ai-icon-button",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiGradientContainerComponentTagName",
+          "name": "AiIconButtonComponentTagName",
           "declaration": {
-            "name": "AiGradientContainerComponentTagName",
-            "module": "src/lib/ai-gradient-container/ai-gradient-container.ts"
+            "name": "AiIconButtonComponentTagName",
+            "module": "src/lib/ai-icon-button/ai-icon-button.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AiGradientContainerComponent",
+          "name": "AiIconButtonComponent",
           "declaration": {
-            "name": "AiGradientContainerComponent",
-            "module": "src/lib/ai-gradient-container/ai-gradient-container.ts"
+            "name": "AiIconButtonComponent",
+            "module": "src/lib/ai-icon-button/ai-icon-button.ts"
           }
         },
         {
           "kind": "custom-element-definition",
           "declaration": {
-            "name": "AiGradientContainerComponent",
-            "module": "src/lib/ai-gradient-container/ai-gradient-container.ts"
+            "name": "AiIconButtonComponent",
+            "module": "src/lib/ai-icon-button/ai-icon-button.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/ai-icon/ai-icon.ts",
+      "path": "src/lib/ai-modal/ai-modal.ts",
       "declarations": [
-        {
-          "kind": "variable",
-          "name": "AiIconComponentTagName",
-          "type": {
-            "text": "keyof HTMLElementTagNameMap"
-          },
-          "default": "'forge-ai-icon'"
-        },
         {
           "kind": "class",
           "description": "",
-          "name": "AiIconComponent",
+          "name": "AiModalComponent",
+          "cssProperties": [
+            {
+              "description": "Width of the modal in non-fullscreen mode",
+              "name": "--forge-ai-modal-width"
+            },
+            {
+              "description": "Height of the modal in non-fullscreen mode",
+              "name": "--forge-ai-modal-height"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Default slot for modal content",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "outline",
+              "name": "open",
               "type": {
                 "text": "boolean"
               },
               "privacy": "public",
               "default": "false",
-              "description": "Whether to display the icon with an outline",
-              "attribute": "outline"
+              "description": "Controls whether the modal is open or closed.",
+              "attribute": "open"
+            },
+            {
+              "kind": "field",
+              "name": "fullscreen",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "privacy": "public",
+              "description": "Controls whether the modal is displayed in fullscreen mode.\nWhen not explicitly set, this will be automatically determined based on viewport size.",
+              "attribute": "fullscreen"
+            },
+            {
+              "kind": "method",
+              "name": "show",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Shows the modal dialog."
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Closes the modal dialog."
+            }
+          ],
+          "events": [
+            {
+              "name": "forge-ai-modal-open",
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when the modal is opened"
+            },
+            {
+              "name": "forge-ai-modal-close",
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when the modal is closed"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{ isFullscreen: boolean }>"
+              },
+              "description": "Fired when the fullscreen state changes",
+              "name": "forge-ai-modal-fullscreen-change"
             }
           ],
           "attributes": [
             {
-              "name": "outline",
+              "name": "open",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to display the icon with an outline",
-              "fieldName": "outline"
+              "description": "Controls whether the modal is open or closed.",
+              "fieldName": "open"
+            },
+            {
+              "name": "fullscreen",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "Controls whether the modal is displayed in fullscreen mode.\nWhen not explicitly set, this will be automatically determined based on viewport size.",
+              "fieldName": "fullscreen"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "forge-ai-icon",
+          "tagName": "forge-ai-modal",
           "customElement": true,
           "states": [
             {
-              "name": "no-border",
-              "description": "The icon is displayed without a border."
-            },
-            {
-              "name": "border",
-              "description": "The icon is displayed with a border."
+              "name": "fullscreen",
+              "description": "The modal is in fullscreen mode"
             }
           ]
         }
@@ -7972,25 +8318,18 @@
       "exports": [
         {
           "kind": "js",
-          "name": "AiIconComponentTagName",
-          "declaration": {
-            "name": "AiIconComponentTagName",
-            "module": "src/lib/ai-icon/ai-icon.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AiIconComponent",
+          "name": "AiModalComponent",
           "declaration": {
-            "name": "AiIconComponent",
-            "module": "src/lib/ai-icon/ai-icon.ts"
+            "name": "AiModalComponent",
+            "module": "src/lib/ai-modal/ai-modal.ts"
           }
         },
         {
           "kind": "custom-element-definition",
+          "name": "forge-ai-modal",
           "declaration": {
-            "name": "AiIconComponent",
-            "module": "src/lib/ai-icon/ai-icon.ts"
+            "name": "AiModalComponent",
+            "module": "src/lib/ai-modal/ai-modal.ts"
           }
         }
       ]
@@ -8018,10 +8357,18 @@
             }
           ],
           "slots": [
+            {
+              "description": "Slot for custom empty state icon",
+              "name": "empty-state-icon"
+            },
             {
               "description": "Slot for custom empty state heading content",
               "name": "empty-state-heading"
             },
+            {
+              "description": "Slot for custom empty state message content",
+              "name": "empty-state-message"
+            },
             {
               "description": "Slot for custom empty state actions (e.g., suggestions)",
               "name": "empty-state-actions"
@@ -8145,136 +8492,61 @@
               "fieldName": "enableReactions"
             },
             {
-              "name": "show-thinking",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "showThinking"
-            },
-            {
-              "name": "auto-scroll",
-              "type": {
-                "text": "FeatureToggle"
-              },
-              "default": "'on'",
-              "fieldName": "autoScroll"
-            },
-            {
-              "name": "debug-mode",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "debugMode"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "forge-ai-message-thread",
-          "customElement": true,
-          "summary": "A primitive component for rendering a thread of chat messages, including user, assistant, system, and tool call messages."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiMessageThreadComponentTagName",
-          "declaration": {
-            "name": "AiMessageThreadComponentTagName",
-            "module": "src/lib/ai-message-thread/ai-message-thread.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AiMessageThreadComponent",
-          "declaration": {
-            "name": "AiMessageThreadComponent",
-            "module": "src/lib/ai-message-thread/ai-message-thread.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "declaration": {
-            "name": "AiMessageThreadComponent",
-            "module": "src/lib/ai-message-thread/ai-message-thread.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/lib/ai-icon-button/ai-icon-button.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AiIconButtonComponentTagName",
-          "type": {
-            "text": "keyof HTMLElementTagNameMap"
-          },
-          "default": "'forge-ai-icon-button'"
-        },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AiIconButtonComponent",
-          "members": [
-            {
-              "kind": "field",
-              "name": "disabled",
+              "name": "show-thinking",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "public",
               "default": "false",
-              "description": "Whether the button is disabled",
-              "attribute": "disabled",
-              "reflects": true
-            }
-          ],
-          "attributes": [
+              "fieldName": "showThinking"
+            },
             {
-              "name": "disabled",
+              "name": "auto-scroll",
+              "type": {
+                "text": "FeatureToggle"
+              },
+              "default": "'on'",
+              "fieldName": "autoScroll"
+            },
+            {
+              "name": "debug-mode",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the button is disabled",
-              "fieldName": "disabled"
+              "fieldName": "debugMode"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "forge-ai-icon-button",
-          "customElement": true
+          "tagName": "forge-ai-message-thread",
+          "customElement": true,
+          "summary": "A primitive component for rendering a thread of chat messages, including user, assistant, system, and tool call messages."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiIconButtonComponentTagName",
+          "name": "AiMessageThreadComponentTagName",
           "declaration": {
-            "name": "AiIconButtonComponentTagName",
-            "module": "src/lib/ai-icon-button/ai-icon-button.ts"
+            "name": "AiMessageThreadComponentTagName",
+            "module": "src/lib/ai-message-thread/ai-message-thread.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AiIconButtonComponent",
+          "name": "AiMessageThreadComponent",
           "declaration": {
-            "name": "AiIconButtonComponent",
-            "module": "src/lib/ai-icon-button/ai-icon-button.ts"
+            "name": "AiMessageThreadComponent",
+            "module": "src/lib/ai-message-thread/ai-message-thread.ts"
           }
         },
         {
           "kind": "custom-element-definition",
           "declaration": {
-            "name": "AiIconButtonComponent",
-            "module": "src/lib/ai-icon-button/ai-icon-button.ts"
+            "name": "AiMessageThreadComponent",
+            "module": "src/lib/ai-message-thread/ai-message-thread.ts"
           }
         }
       ]
@@ -8659,150 +8931,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/lib/ai-modal/ai-modal.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AiModalComponent",
-          "cssProperties": [
-            {
-              "description": "Width of the modal in non-fullscreen mode",
-              "name": "--forge-ai-modal-width"
-            },
-            {
-              "description": "Height of the modal in non-fullscreen mode",
-              "name": "--forge-ai-modal-height"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Default slot for modal content",
-              "name": ""
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "open",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false",
-              "description": "Controls whether the modal is open or closed.",
-              "attribute": "open"
-            },
-            {
-              "kind": "field",
-              "name": "fullscreen",
-              "type": {
-                "text": "boolean | undefined"
-              },
-              "privacy": "public",
-              "description": "Controls whether the modal is displayed in fullscreen mode.\nWhen not explicitly set, this will be automatically determined based on viewport size.",
-              "attribute": "fullscreen"
-            },
-            {
-              "kind": "method",
-              "name": "show",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Shows the modal dialog."
-            },
-            {
-              "kind": "method",
-              "name": "close",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Closes the modal dialog."
-            }
-          ],
-          "events": [
-            {
-              "name": "forge-ai-modal-open",
-              "type": {
-                "text": "CustomEvent<void>"
-              },
-              "description": "Fired when the modal is opened"
-            },
-            {
-              "name": "forge-ai-modal-close",
-              "type": {
-                "text": "CustomEvent<void>"
-              },
-              "description": "Fired when the modal is closed"
-            },
-            {
-              "type": {
-                "text": "CustomEvent<{ isFullscreen: boolean }>"
-              },
-              "description": "Fired when the fullscreen state changes",
-              "name": "forge-ai-modal-fullscreen-change"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "open",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Controls whether the modal is open or closed.",
-              "fieldName": "open"
-            },
-            {
-              "name": "fullscreen",
-              "type": {
-                "text": "boolean | undefined"
-              },
-              "description": "Controls whether the modal is displayed in fullscreen mode.\nWhen not explicitly set, this will be automatically determined based on viewport size.",
-              "fieldName": "fullscreen"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "forge-ai-modal",
-          "customElement": true,
-          "states": [
-            {
-              "name": "fullscreen",
-              "description": "The modal is in fullscreen mode"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiModalComponent",
-          "declaration": {
-            "name": "AiModalComponent",
-            "module": "src/lib/ai-modal/ai-modal.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "forge-ai-modal",
-          "declaration": {
-            "name": "AiModalComponent",
-            "module": "src/lib/ai-modal/ai-modal.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/lib/ai-reasoning/ai-reasoning.ts",
@@ -8827,105 +8955,53 @@
                 "text": "boolean"
               },
               "privacy": "public",
-              "default": "false",
-              "description": "Whether the reasoning is expanded",
-              "attribute": "expanded",
-              "reflects": true
-            }
-          ],
-          "attributes": [
-            {
-              "name": "expanded",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the reasoning is expanded",
-              "fieldName": "expanded"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "forge-ai-reasoning",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiReasoningComponentTagName",
-          "declaration": {
-            "name": "AiReasoningComponentTagName",
-            "module": "src/lib/ai-reasoning/ai-reasoning.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AiReasoningComponent",
-          "declaration": {
-            "name": "AiReasoningComponent",
-            "module": "src/lib/ai-reasoning/ai-reasoning.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "declaration": {
-            "name": "AiReasoningComponent",
-            "module": "src/lib/ai-reasoning/ai-reasoning.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/lib/ai-response-message/ai-response-message.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AiResponseMessageComponentTagName",
-          "type": {
-            "text": "keyof HTMLElementTagNameMap"
-          },
-          "default": "'forge-ai-response-message'"
-        },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AiResponseMessageComponent",
-          "members": [],
+              "default": "false",
+              "description": "Whether the reasoning is expanded",
+              "attribute": "expanded",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the reasoning is expanded",
+              "fieldName": "expanded"
+            }
+          ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "forge-ai-response-message",
-          "customElement": true,
-          "summary": "A simple wrapper component for rendering assistant response message content."
+          "tagName": "forge-ai-reasoning",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiResponseMessageComponentTagName",
+          "name": "AiReasoningComponentTagName",
           "declaration": {
-            "name": "AiResponseMessageComponentTagName",
-            "module": "src/lib/ai-response-message/ai-response-message.ts"
+            "name": "AiReasoningComponentTagName",
+            "module": "src/lib/ai-reasoning/ai-reasoning.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AiResponseMessageComponent",
+          "name": "AiReasoningComponent",
           "declaration": {
-            "name": "AiResponseMessageComponent",
-            "module": "src/lib/ai-response-message/ai-response-message.ts"
+            "name": "AiReasoningComponent",
+            "module": "src/lib/ai-reasoning/ai-reasoning.ts"
           }
         },
         {
           "kind": "custom-element-definition",
           "declaration": {
-            "name": "AiResponseMessageComponent",
-            "module": "src/lib/ai-response-message/ai-response-message.ts"
+            "name": "AiReasoningComponent",
+            "module": "src/lib/ai-reasoning/ai-reasoning.ts"
           }
         }
       ]
@@ -9045,6 +9121,58 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-response-message/ai-response-message.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiResponseMessageComponentTagName",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-ai-response-message'"
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AiResponseMessageComponent",
+          "members": [],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "forge-ai-response-message",
+          "customElement": true,
+          "summary": "A simple wrapper component for rendering assistant response message content."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiResponseMessageComponentTagName",
+          "declaration": {
+            "name": "AiResponseMessageComponentTagName",
+            "module": "src/lib/ai-response-message/ai-response-message.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiResponseMessageComponent",
+          "declaration": {
+            "name": "AiResponseMessageComponent",
+            "module": "src/lib/ai-response-message/ai-response-message.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "declaration": {
+            "name": "AiResponseMessageComponent",
+            "module": "src/lib/ai-response-message/ai-response-message.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/lib/ai-response-message-toolbar/ai-response-message-toolbar.ts",
@@ -9167,23 +9295,23 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts",
+      "path": "src/lib/ai-sidebar/ai-sidebar.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "AiSidebarChatComponentTagName",
+          "name": "AiSidebarComponentTagName",
           "type": {
             "text": "keyof HTMLElementTagNameMap"
           },
-          "default": "'forge-ai-sidebar-chat'"
+          "default": "'forge-ai-sidebar'"
         },
         {
           "kind": "class",
           "description": "",
-          "name": "AiSidebarChatComponent",
+          "name": "AiSidebarComponent",
           "slots": [
             {
-              "description": "Default slot for chatbot component",
+              "description": "Default slot for sidebar content (typically ai-chat-interface)",
               "name": ""
             }
           ],
@@ -9196,18 +9324,9 @@
               },
               "privacy": "public",
               "default": "false",
+              "description": "Indicates whether the sidebar is open.",
               "attribute": "open"
             },
-            {
-              "kind": "field",
-              "name": "expanded",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false",
-              "attribute": "expanded"
-            },
             {
               "kind": "method",
               "name": "show",
@@ -9216,7 +9335,8 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Opens the sidebar."
             },
             {
               "kind": "method",
@@ -9226,7 +9346,8 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Closes the sidebar."
             },
             {
               "kind": "method",
@@ -9236,45 +9357,18 @@
                 "type": {
                   "text": "void"
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "expand",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "collapse",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              },
+              "description": "Toggles the sidebar open state."
             }
           ],
           "events": [
             {
-              "description": "Fired when the sidebar chat is opened",
-              "name": "forge-ai-sidebar-chat-open"
-            },
-            {
-              "description": "Fired when the sidebar chat is closed",
-              "name": "forge-ai-sidebar-chat-close"
-            },
-            {
-              "description": "Fired when the sidebar chat is expanded to modal",
-              "name": "forge-ai-sidebar-chat-expand"
+              "description": "Fired when the sidebar is opened",
+              "name": "forge-ai-sidebar-open"
             },
             {
-              "description": "Fired when the sidebar chat is collapsed from modal",
-              "name": "forge-ai-sidebar-chat-collapse"
+              "description": "Fired when the sidebar is closed",
+              "name": "forge-ai-sidebar-close"
             }
           ],
           "attributes": [
@@ -9284,70 +9378,63 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Indicates whether the sidebar is open.",
               "fieldName": "open"
-            },
-            {
-              "name": "expanded",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "expanded"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "forge-ai-sidebar-chat",
+          "tagName": "forge-ai-sidebar",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiSidebarChatComponentTagName",
+          "name": "AiSidebarComponentTagName",
           "declaration": {
-            "name": "AiSidebarChatComponentTagName",
-            "module": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts"
+            "name": "AiSidebarComponentTagName",
+            "module": "src/lib/ai-sidebar/ai-sidebar.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AiSidebarChatComponent",
+          "name": "AiSidebarComponent",
           "declaration": {
-            "name": "AiSidebarChatComponent",
-            "module": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts"
+            "name": "AiSidebarComponent",
+            "module": "src/lib/ai-sidebar/ai-sidebar.ts"
           }
         },
         {
           "kind": "custom-element-definition",
           "declaration": {
-            "name": "AiSidebarChatComponent",
-            "module": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts"
+            "name": "AiSidebarComponent",
+            "module": "src/lib/ai-sidebar/ai-sidebar.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/ai-sidebar/ai-sidebar.ts",
+      "path": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "AiSidebarComponentTagName",
+          "name": "AiSidebarChatComponentTagName",
           "type": {
             "text": "keyof HTMLElementTagNameMap"
           },
-          "default": "'forge-ai-sidebar'"
+          "default": "'forge-ai-sidebar-chat'"
         },
         {
           "kind": "class",
           "description": "",
-          "name": "AiSidebarComponent",
+          "name": "AiSidebarChatComponent",
           "slots": [
             {
-              "description": "Default slot for sidebar content (typically ai-chat-interface)",
+              "description": "Default slot for chatbot component",
               "name": ""
             }
           ],
@@ -9360,9 +9447,18 @@
               },
               "privacy": "public",
               "default": "false",
-              "description": "Indicates whether the sidebar is open.",
               "attribute": "open"
             },
+            {
+              "kind": "field",
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "attribute": "expanded"
+            },
             {
               "kind": "method",
               "name": "show",
@@ -9371,8 +9467,7 @@
                 "type": {
                   "text": "void"
                 }
-              },
-              "description": "Opens the sidebar."
+              }
             },
             {
               "kind": "method",
@@ -9382,8 +9477,7 @@
                 "type": {
                   "text": "void"
                 }
-              },
-              "description": "Closes the sidebar."
+              }
             },
             {
               "kind": "method",
@@ -9393,61 +9487,95 @@
                 "type": {
                   "text": "void"
                 }
-              },
-              "description": "Toggles the sidebar open state."
+              }
+            },
+            {
+              "kind": "method",
+              "name": "expand",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "collapse",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             }
           ],
           "events": [
             {
-              "description": "Fired when the sidebar is opened",
-              "name": "forge-ai-sidebar-open"
+              "description": "Fired when the sidebar chat is opened",
+              "name": "forge-ai-sidebar-chat-open"
             },
             {
-              "description": "Fired when the sidebar is closed",
-              "name": "forge-ai-sidebar-close"
+              "description": "Fired when the sidebar chat is closed",
+              "name": "forge-ai-sidebar-chat-close"
+            },
+            {
+              "description": "Fired when the sidebar chat is expanded to modal",
+              "name": "forge-ai-sidebar-chat-expand"
+            },
+            {
+              "description": "Fired when the sidebar chat is collapsed from modal",
+              "name": "forge-ai-sidebar-chat-collapse"
             }
           ],
           "attributes": [
             {
-              "name": "open",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "open"
+            },
+            {
+              "name": "expanded",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Indicates whether the sidebar is open.",
-              "fieldName": "open"
+              "fieldName": "expanded"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "forge-ai-sidebar",
+          "tagName": "forge-ai-sidebar-chat",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiSidebarComponentTagName",
+          "name": "AiSidebarChatComponentTagName",
           "declaration": {
-            "name": "AiSidebarComponentTagName",
-            "module": "src/lib/ai-sidebar/ai-sidebar.ts"
+            "name": "AiSidebarChatComponentTagName",
+            "module": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AiSidebarComponent",
+          "name": "AiSidebarChatComponent",
           "declaration": {
-            "name": "AiSidebarComponent",
-            "module": "src/lib/ai-sidebar/ai-sidebar.ts"
+            "name": "AiSidebarChatComponent",
+            "module": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts"
           }
         },
         {
           "kind": "custom-element-definition",
           "declaration": {
-            "name": "AiSidebarComponent",
-            "module": "src/lib/ai-sidebar/ai-sidebar.ts"
+            "name": "AiSidebarChatComponent",
+            "module": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts"
           }
         }
       ]
@@ -9613,89 +9741,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/lib/ai-spinner/ai-spinner.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AiSpinnerComponentTagName",
-          "type": {
-            "text": "keyof HTMLElementTagNameMap"
-          },
-          "default": "'forge-ai-spinner'"
-        },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AiSpinnerComponent",
-          "cssProperties": [
-            {
-              "description": "Color of the spinner indicator",
-              "name": "--forge-ai-spinner-color"
-            },
-            {
-              "description": "Color of the spinner track",
-              "name": "--forge-ai-spinner-track-color"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "SpinnerSize"
-              },
-              "privacy": "public",
-              "default": "'medium'",
-              "attribute": "size"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "size",
-              "type": {
-                "text": "SpinnerSize"
-              },
-              "default": "'medium'",
-              "fieldName": "size"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "forge-ai-spinner",
-          "customElement": true,
-          "summary": "Indeterminate circular progress indicator."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiSpinnerComponentTagName",
-          "declaration": {
-            "name": "AiSpinnerComponentTagName",
-            "module": "src/lib/ai-spinner/ai-spinner.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AiSpinnerComponent",
-          "declaration": {
-            "name": "AiSpinnerComponent",
-            "module": "src/lib/ai-spinner/ai-spinner.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "declaration": {
-            "name": "AiSpinnerComponent",
-            "module": "src/lib/ai-spinner/ai-spinner.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/lib/ai-thinking-indicator/ai-thinking-indicator.ts",
@@ -9805,6 +9850,89 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/ai-spinner/ai-spinner.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiSpinnerComponentTagName",
+          "type": {
+            "text": "keyof HTMLElementTagNameMap"
+          },
+          "default": "'forge-ai-spinner'"
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AiSpinnerComponent",
+          "cssProperties": [
+            {
+              "description": "Color of the spinner indicator",
+              "name": "--forge-ai-spinner-color"
+            },
+            {
+              "description": "Color of the spinner track",
+              "name": "--forge-ai-spinner-track-color"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "SpinnerSize"
+              },
+              "privacy": "public",
+              "default": "'medium'",
+              "attribute": "size"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "size",
+              "type": {
+                "text": "SpinnerSize"
+              },
+              "default": "'medium'",
+              "fieldName": "size"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "forge-ai-spinner",
+          "customElement": true,
+          "summary": "Indeterminate circular progress indicator."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiSpinnerComponentTagName",
+          "declaration": {
+            "name": "AiSpinnerComponentTagName",
+            "module": "src/lib/ai-spinner/ai-spinner.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiSpinnerComponent",
+          "declaration": {
+            "name": "AiSpinnerComponent",
+            "module": "src/lib/ai-spinner/ai-spinner.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "declaration": {
+            "name": "AiSpinnerComponent",
+            "module": "src/lib/ai-spinner/ai-spinner.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/lib/ai-suggestions/ai-suggestions.ts",
@@ -11332,78 +11460,16 @@
         {
           "kind": "js",
           "name": "ReasoningContentComponent",
-          "declaration": {
-            "name": "ReasoningContentComponent",
-            "module": "src/lib/ai-reasoning/reasoning-content/reasoning-content.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "declaration": {
-            "name": "ReasoningContentComponent",
-            "module": "src/lib/ai-reasoning/reasoning-content/reasoning-content.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/lib/tools/ai-data-table/ai-data-table-definition.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "displayDataTableTool",
-          "type": {
-            "text": "ToolDefinition"
-          },
-          "default": "{ name: 'displayDataTable', displayName: 'Display Data Table', description: 'Display tabular data in a formatted table with headers and rows. Use this tool when you want to present structured data, lists where there are 2 or more columns, statistics, or any information that works well in a table format.', parameters: { type: 'object' as const, properties: { title: { type: 'string', description: 'Table title or caption displayed above the data.' }, headers: { type: 'array', items: { type: 'string' }, description: 'Column names displayed as table headers. Order matches the row data order.' }, maxNumberOfRows: { type: 'number', description: 'Limit total rows shown. Useful for large datasets to prevent overwhelming display.' }, rows: { type: 'array', items: { type: 'array', items: { anyOf: [{ type: 'string' }, { type: 'number' }] } }, description: 'Data rows where each row is an array of values matching header order.' } }, required: ['headers', 'rows'] }, renderer: createToolRenderer({ elementTag: 'forge-ai-tool-data-table' }) }"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "displayDataTableTool",
-          "declaration": {
-            "name": "displayDataTableTool",
-            "module": "src/lib/tools/ai-data-table/ai-data-table-definition.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/lib/tools/ai-data-table/ai-data-table.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "Data table component tool renderer for displaying tabular data with pagination and filtering.",
-          "name": "DataTableToolElement",
-          "members": [
-            {
-              "kind": "field",
-              "name": "toolCall",
-              "type": {
-                "text": "ToolCall<TableData>"
-              },
-              "privacy": "public",
-              "description": "Tool call data containing table configuration and data"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "forge-ai-tool-data-table",
-          "customElement": true
-        }
-      ],
-      "exports": [
+          "declaration": {
+            "name": "ReasoningContentComponent",
+            "module": "src/lib/ai-reasoning/reasoning-content/reasoning-content.ts"
+          }
+        },
         {
           "kind": "custom-element-definition",
-          "name": "forge-ai-tool-data-table",
           "declaration": {
-            "name": "DataTableToolElement",
-            "module": "src/lib/tools/ai-data-table/ai-data-table.ts"
+            "name": "ReasoningContentComponent",
+            "module": "src/lib/ai-reasoning/reasoning-content/reasoning-content.ts"
           }
         }
       ]
@@ -11512,222 +11578,77 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/core/overlay/overlay.ts",
+      "path": "src/lib/tools/ai-data-table/ai-data-table-definition.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "displayDataTableTool",
+          "type": {
+            "text": "ToolDefinition"
+          },
+          "default": "{ name: 'displayDataTable', displayName: 'Display Data Table', description: 'Display tabular data in a formatted table with headers and rows. Use this tool when you want to present structured data, lists where there are 2 or more columns, statistics, or any information that works well in a table format.', parameters: { type: 'object' as const, properties: { title: { type: 'string', description: 'Table title or caption displayed above the data.' }, headers: { type: 'array', items: { type: 'string' }, description: 'Column names displayed as table headers. Order matches the row data order.' }, maxNumberOfRows: { type: 'number', description: 'Limit total rows shown. Useful for large datasets to prevent overwhelming display.' }, rows: { type: 'array', items: { type: 'array', items: { anyOf: [{ type: 'string' }, { type: 'number' }] } }, description: 'Data rows where each row is an array of values matching header order.' } }, required: ['headers', 'rows'] }, renderer: createToolRenderer({ elementTag: 'forge-ai-tool-data-table' }) }"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "displayDataTableTool",
+          "declaration": {
+            "name": "displayDataTableTool",
+            "module": "src/lib/tools/ai-data-table/ai-data-table-definition.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/tools/ai-data-table/ai-data-table.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "",
-          "name": "ForgeAiOverlayComponent",
-          "slots": [
-            {
-              "description": "The default slot for overlay content.",
-              "name": ""
-            }
-          ],
+          "description": "Data table component tool renderer for displaying tabular data with pagination and filtering.",
+          "name": "DataTableToolElement",
           "members": [
             {
               "kind": "field",
-              "name": "anchor",
-              "type": {
-                "text": "Element | null"
-              },
-              "privacy": "public",
-              "default": "null",
-              "description": "The anchor element to position the overlay relative to.",
-              "attribute": "anchor"
-            },
-            {
-              "kind": "field",
-              "name": "placement",
-              "type": {
-                "text": "OverlayPlacement"
-              },
-              "privacy": "public",
-              "default": "'bottom-start'",
-              "description": "The placement of the overlay relative to the anchor.",
-              "attribute": "placement"
-            },
-            {
-              "kind": "field",
-              "name": "flip",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "true",
-              "description": "Whether the overlay should flip to the opposite side when there's no space.",
-              "attribute": "flip"
-            },
-            {
-              "kind": "field",
-              "name": "shift",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false",
-              "description": "Whether the overlay should shift to stay in view.",
-              "attribute": "shift"
-            },
-            {
-              "kind": "field",
-              "name": "open",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false",
-              "description": "Whether the overlay is open.",
-              "attribute": "open",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "arrowElement",
-              "type": {
-                "text": "HTMLElement | null"
-              },
-              "privacy": "public",
-              "default": "null",
-              "description": "The arrow element to position relative to the overlay.",
-              "attribute": "arrowElement"
-            },
-            {
-              "kind": "field",
-              "name": "offset",
-              "type": {
-                "text": "OverlayOffset | undefined"
-              },
-              "privacy": "public",
-              "default": "undefined",
-              "description": "The offset of the overlay from the anchor element.\nCan be a number (main axis offset) or an object with mainAxis, crossAxis, and alignmentAxis properties.",
-              "attribute": "offset"
-            },
-            {
-              "kind": "field",
-              "name": "dismissMode",
+              "name": "toolCall",
               "type": {
-                "text": "'auto' | 'manual'"
+                "text": "ToolCall<TableData>"
               },
               "privacy": "public",
-              "default": "'auto'",
-              "description": "The dismiss mode for the overlay.\n- 'auto': Automatically closes on outside clicks and Escape key\n- 'manual': Requires manual control to close",
-              "attribute": "dismiss-mode"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "anchor",
-              "type": {
-                "text": "Element | null"
-              },
-              "default": "null",
-              "description": "The anchor element to position the overlay relative to.",
-              "fieldName": "anchor"
-            },
-            {
-              "name": "placement",
-              "type": {
-                "text": "OverlayPlacement"
-              },
-              "default": "'bottom-start'",
-              "description": "The placement of the overlay relative to the anchor.",
-              "fieldName": "placement"
-            },
-            {
-              "name": "flip",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Whether the overlay should flip to the opposite side when there's no space.",
-              "fieldName": "flip"
-            },
-            {
-              "name": "shift",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the overlay should shift to stay in view.",
-              "fieldName": "shift"
-            },
-            {
-              "name": "open",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the overlay is open.",
-              "fieldName": "open"
-            },
-            {
-              "name": "arrowElement",
-              "type": {
-                "text": "HTMLElement | null"
-              },
-              "default": "null",
-              "description": "The arrow element to position relative to the overlay.",
-              "fieldName": "arrowElement"
-            },
-            {
-              "name": "offset",
-              "type": {
-                "text": "OverlayOffset | undefined"
-              },
-              "default": "undefined",
-              "description": "The offset of the overlay from the anchor element.\nCan be a number (main axis offset) or an object with mainAxis, crossAxis, and alignmentAxis properties.",
-              "fieldName": "offset"
-            },
-            {
-              "name": "dismiss-mode",
-              "type": {
-                "text": "'auto' | 'manual'"
-              },
-              "default": "'auto'",
-              "description": "The dismiss mode for the overlay.\n- 'auto': Automatically closes on outside clicks and Escape key\n- 'manual': Requires manual control to close",
-              "fieldName": "dismissMode"
+              "description": "Tool call data containing table configuration and data"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "summary": "A low-level overlay component for internal use within AI components.",
-          "tagName": "forge-ai-overlay",
+          "tagName": "forge-ai-tool-data-table",
           "customElement": true
         }
       ],
       "exports": [
-        {
-          "kind": "js",
-          "name": "ForgeAiOverlayComponent",
-          "declaration": {
-            "name": "ForgeAiOverlayComponent",
-            "module": "src/lib/core/overlay/overlay.ts"
-          }
-        },
         {
           "kind": "custom-element-definition",
-          "name": "forge-ai-overlay",
+          "name": "forge-ai-tool-data-table",
           "declaration": {
-            "name": "ForgeAiOverlayComponent",
-            "module": "src/lib/core/overlay/overlay.ts"
+            "name": "DataTableToolElement",
+            "module": "src/lib/tools/ai-data-table/ai-data-table.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/lib/core/popover/popover.ts",
+      "path": "src/lib/core/overlay/overlay.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "ForgeAiPopoverComponent",
+          "name": "ForgeAiOverlayComponent",
           "slots": [
             {
-              "description": "The default slot for popover content.",
+              "description": "The default slot for overlay content.",
               "name": ""
             }
           ],
@@ -11740,18 +11661,18 @@
               },
               "privacy": "public",
               "default": "null",
-              "description": "The anchor element to position the popover relative to.",
+              "description": "The anchor element to position the overlay relative to.",
               "attribute": "anchor"
             },
             {
               "kind": "field",
               "name": "placement",
               "type": {
-                "text": "PopoverPlacement"
+                "text": "OverlayPlacement"
               },
               "privacy": "public",
               "default": "'bottom-start'",
-              "description": "The placement of the popover relative to the anchor.",
+              "description": "The placement of the overlay relative to the anchor.",
               "attribute": "placement"
             },
             {
@@ -11761,8 +11682,8 @@
                 "text": "boolean"
               },
               "privacy": "public",
-              "default": "false",
-              "description": "Whether the popover should flip to the opposite side when there's no space.",
+              "default": "true",
+              "description": "Whether the overlay should flip to the opposite side when there's no space.",
               "attribute": "flip"
             },
             {
@@ -11773,7 +11694,7 @@
               },
               "privacy": "public",
               "default": "false",
-              "description": "Whether the popover should shift to stay in view.",
+              "description": "Whether the overlay should shift to stay in view.",
               "attribute": "shift"
             },
             {
@@ -11784,30 +11705,30 @@
               },
               "privacy": "public",
               "default": "false",
-              "description": "Whether the popover is open.",
+              "description": "Whether the overlay is open.",
               "attribute": "open",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "arrow",
+              "name": "arrowElement",
               "type": {
-                "text": "boolean"
+                "text": "HTMLElement | null"
               },
               "privacy": "public",
-              "default": "false",
-              "description": "Whether to show an arrow pointing to the anchor element.",
-              "attribute": "arrow"
+              "default": "null",
+              "description": "The arrow element to position relative to the overlay.",
+              "attribute": "arrowElement"
             },
             {
               "kind": "field",
               "name": "offset",
               "type": {
-                "text": "PopoverOffset | undefined"
+                "text": "OverlayOffset | undefined"
               },
               "privacy": "public",
               "default": "undefined",
-              "description": "The offset of the popover from the anchor element.\nCan be a number (main axis offset) or an object with mainAxis, crossAxis, and alignmentAxis properties.",
+              "description": "The offset of the overlay from the anchor element.\nCan be a number (main axis offset) or an object with mainAxis, crossAxis, and alignmentAxis properties.",
               "attribute": "offset"
             },
             {
@@ -11818,7 +11739,7 @@
               },
               "privacy": "public",
               "default": "'auto'",
-              "description": "The dismiss mode for the popover.\n- 'auto': Automatically closes on outside clicks and Escape key\n- 'manual': Requires manual control to close",
+              "description": "The dismiss mode for the overlay.\n- 'auto': Automatically closes on outside clicks and Escape key\n- 'manual': Requires manual control to close",
               "attribute": "dismiss-mode"
             }
           ],
@@ -11829,16 +11750,16 @@
                 "text": "Element | null"
               },
               "default": "null",
-              "description": "The anchor element to position the popover relative to.",
+              "description": "The anchor element to position the overlay relative to.",
               "fieldName": "anchor"
             },
             {
               "name": "placement",
               "type": {
-                "text": "PopoverPlacement"
+                "text": "OverlayPlacement"
               },
               "default": "'bottom-start'",
-              "description": "The placement of the popover relative to the anchor.",
+              "description": "The placement of the overlay relative to the anchor.",
               "fieldName": "placement"
             },
             {
@@ -11846,8 +11767,8 @@
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Whether the popover should flip to the opposite side when there's no space.",
+              "default": "true",
+              "description": "Whether the overlay should flip to the opposite side when there's no space.",
               "fieldName": "flip"
             },
             {
@@ -11856,7 +11777,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the popover should shift to stay in view.",
+              "description": "Whether the overlay should shift to stay in view.",
               "fieldName": "shift"
             },
             {
@@ -11865,25 +11786,25 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the popover is open.",
+              "description": "Whether the overlay is open.",
               "fieldName": "open"
             },
             {
-              "name": "arrow",
+              "name": "arrowElement",
               "type": {
-                "text": "boolean"
+                "text": "HTMLElement | null"
               },
-              "default": "false",
-              "description": "Whether to show an arrow pointing to the anchor element.",
-              "fieldName": "arrow"
+              "default": "null",
+              "description": "The arrow element to position relative to the overlay.",
+              "fieldName": "arrowElement"
             },
             {
               "name": "offset",
               "type": {
-                "text": "PopoverOffset | undefined"
+                "text": "OverlayOffset | undefined"
               },
               "default": "undefined",
-              "description": "The offset of the popover from the anchor element.\nCan be a number (main axis offset) or an object with mainAxis, crossAxis, and alignmentAxis properties.",
+              "description": "The offset of the overlay from the anchor element.\nCan be a number (main axis offset) or an object with mainAxis, crossAxis, and alignmentAxis properties.",
               "fieldName": "offset"
             },
             {
@@ -11892,7 +11813,7 @@
                 "text": "'auto' | 'manual'"
               },
               "default": "'auto'",
-              "description": "The dismiss mode for the popover.\n- 'auto': Automatically closes on outside clicks and Escape key\n- 'manual': Requires manual control to close",
+              "description": "The dismiss mode for the overlay.\n- 'auto': Automatically closes on outside clicks and Escape key\n- 'manual': Requires manual control to close",
               "fieldName": "dismissMode"
             }
           ],
@@ -11900,26 +11821,26 @@
             "name": "LitElement",
             "package": "lit"
           },
-          "summary": "A popover component that provides styled overlay functionality.",
-          "tagName": "forge-ai-popover",
+          "summary": "A low-level overlay component for internal use within AI components.",
+          "tagName": "forge-ai-overlay",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "ForgeAiPopoverComponent",
+          "name": "ForgeAiOverlayComponent",
           "declaration": {
-            "name": "ForgeAiPopoverComponent",
-            "module": "src/lib/core/popover/popover.ts"
+            "name": "ForgeAiOverlayComponent",
+            "module": "src/lib/core/overlay/overlay.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "forge-ai-popover",
+          "name": "forge-ai-overlay",
           "declaration": {
-            "name": "ForgeAiPopoverComponent",
-            "module": "src/lib/core/popover/popover.ts"
+            "name": "ForgeAiOverlayComponent",
+            "module": "src/lib/core/overlay/overlay.ts"
           }
         }
       ]
@@ -12018,85 +11939,283 @@
             },
             {
               "kind": "field",
-              "name": "hideDelay",
+              "name": "hideDelay",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "default": "0",
+              "description": "Delay in milliseconds before hiding the tooltip.",
+              "attribute": "hide-delay"
+            },
+            {
+              "kind": "method",
+              "name": "show",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Show the tooltip programmatically."
+            },
+            {
+              "kind": "method",
+              "name": "hide",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hide the tooltip programmatically."
+            },
+            {
+              "kind": "method",
+              "name": "toggle",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Toggle the tooltip programmatically."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "for",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The ID of the anchor element to attach the tooltip to.",
+              "fieldName": "for"
+            },
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The text content of the tooltip (alternative to slotted content).",
+              "fieldName": "text"
+            },
+            {
+              "name": "placement",
+              "type": {
+                "text": "TooltipPlacement"
+              },
+              "default": "'top'",
+              "description": "The placement of the tooltip relative to the anchor.",
+              "fieldName": "placement"
+            },
+            {
+              "name": "trigger",
+              "type": {
+                "text": "TooltipTrigger"
+              },
+              "default": "'hover'",
+              "description": "How the tooltip should be triggered.",
+              "fieldName": "trigger"
+            },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the tooltip is open.",
+              "fieldName": "open"
+            },
+            {
+              "name": "delay",
+              "type": {
+                "text": "number"
+              },
+              "default": "500",
+              "description": "Delay in milliseconds before showing the tooltip.",
+              "fieldName": "delay"
+            },
+            {
+              "name": "hide-delay",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Delay in milliseconds before hiding the tooltip.",
+              "fieldName": "hideDelay"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "summary": "A tooltip component with accessibility features and dynamic positioning.",
+          "tagName": "forge-ai-tooltip",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ForgeAiTooltipComponent",
+          "declaration": {
+            "name": "ForgeAiTooltipComponent",
+            "module": "src/lib/core/tooltip/tooltip.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "forge-ai-tooltip",
+          "declaration": {
+            "name": "ForgeAiTooltipComponent",
+            "module": "src/lib/core/tooltip/tooltip.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/lib/core/popover/popover.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "ForgeAiPopoverComponent",
+          "slots": [
+            {
+              "description": "The default slot for popover content.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "anchor",
+              "type": {
+                "text": "Element | null"
+              },
+              "privacy": "public",
+              "default": "null",
+              "description": "The anchor element to position the popover relative to.",
+              "attribute": "anchor"
+            },
+            {
+              "kind": "field",
+              "name": "placement",
+              "type": {
+                "text": "PopoverPlacement"
+              },
+              "privacy": "public",
+              "default": "'bottom-start'",
+              "description": "The placement of the popover relative to the anchor.",
+              "attribute": "placement"
+            },
+            {
+              "kind": "field",
+              "name": "flip",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "description": "Whether the popover should flip to the opposite side when there's no space.",
+              "attribute": "flip"
+            },
+            {
+              "kind": "field",
+              "name": "shift",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "description": "Whether the popover should shift to stay in view.",
+              "attribute": "shift"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false",
+              "description": "Whether the popover is open.",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "arrow",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
               "privacy": "public",
-              "default": "0",
-              "description": "Delay in milliseconds before hiding the tooltip.",
-              "attribute": "hide-delay"
+              "default": "false",
+              "description": "Whether to show an arrow pointing to the anchor element.",
+              "attribute": "arrow"
             },
             {
-              "kind": "method",
-              "name": "show",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "offset",
+              "type": {
+                "text": "PopoverOffset | undefined"
               },
-              "description": "Show the tooltip programmatically."
-            },
-            {
-              "kind": "method",
-              "name": "hide",
               "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Hide the tooltip programmatically."
+              "default": "undefined",
+              "description": "The offset of the popover from the anchor element.\nCan be a number (main axis offset) or an object with mainAxis, crossAxis, and alignmentAxis properties.",
+              "attribute": "offset"
             },
             {
-              "kind": "method",
-              "name": "toggle",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "dismissMode",
+              "type": {
+                "text": "'auto' | 'manual'"
               },
-              "description": "Toggle the tooltip programmatically."
+              "privacy": "public",
+              "default": "'auto'",
+              "description": "The dismiss mode for the popover.\n- 'auto': Automatically closes on outside clicks and Escape key\n- 'manual': Requires manual control to close",
+              "attribute": "dismiss-mode"
             }
           ],
           "attributes": [
             {
-              "name": "for",
+              "name": "anchor",
               "type": {
-                "text": "string"
+                "text": "Element | null"
               },
-              "default": "''",
-              "description": "The ID of the anchor element to attach the tooltip to.",
-              "fieldName": "for"
+              "default": "null",
+              "description": "The anchor element to position the popover relative to.",
+              "fieldName": "anchor"
             },
             {
-              "name": "text",
+              "name": "placement",
               "type": {
-                "text": "string"
+                "text": "PopoverPlacement"
               },
-              "default": "''",
-              "description": "The text content of the tooltip (alternative to slotted content).",
-              "fieldName": "text"
+              "default": "'bottom-start'",
+              "description": "The placement of the popover relative to the anchor.",
+              "fieldName": "placement"
             },
             {
-              "name": "placement",
+              "name": "flip",
               "type": {
-                "text": "TooltipPlacement"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The placement of the tooltip relative to the anchor.",
-              "fieldName": "placement"
+              "default": "false",
+              "description": "Whether the popover should flip to the opposite side when there's no space.",
+              "fieldName": "flip"
             },
             {
-              "name": "trigger",
+              "name": "shift",
               "type": {
-                "text": "TooltipTrigger"
+                "text": "boolean"
               },
-              "default": "'hover'",
-              "description": "How the tooltip should be triggered.",
-              "fieldName": "trigger"
+              "default": "false",
+              "description": "Whether the popover should shift to stay in view.",
+              "fieldName": "shift"
             },
             {
               "name": "open",
@@ -12104,52 +12223,61 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the tooltip is open.",
+              "description": "Whether the popover is open.",
               "fieldName": "open"
             },
             {
-              "name": "delay",
+              "name": "arrow",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "500",
-              "description": "Delay in milliseconds before showing the tooltip.",
-              "fieldName": "delay"
+              "default": "false",
+              "description": "Whether to show an arrow pointing to the anchor element.",
+              "fieldName": "arrow"
             },
             {
-              "name": "hide-delay",
+              "name": "offset",
               "type": {
-                "text": "number"
+                "text": "PopoverOffset | undefined"
               },
-              "default": "0",
-              "description": "Delay in milliseconds before hiding the tooltip.",
-              "fieldName": "hideDelay"
+              "default": "undefined",
+              "description": "The offset of the popover from the anchor element.\nCan be a number (main axis offset) or an object with mainAxis, crossAxis, and alignmentAxis properties.",
+              "fieldName": "offset"
+            },
+            {
+              "name": "dismiss-mode",
+              "type": {
+                "text": "'auto' | 'manual'"
+              },
+              "default": "'auto'",
+              "description": "The dismiss mode for the popover.\n- 'auto': Automatically closes on outside clicks and Escape key\n- 'manual': Requires manual control to close",
+              "fieldName": "dismissMode"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "summary": "A tooltip component with accessibility features and dynamic positioning.",
-          "tagName": "forge-ai-tooltip",
+          "summary": "A popover component that provides styled overlay functionality.",
+          "tagName": "forge-ai-popover",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "ForgeAiTooltipComponent",
+          "name": "ForgeAiPopoverComponent",
           "declaration": {
-            "name": "ForgeAiTooltipComponent",
-            "module": "src/lib/core/tooltip/tooltip.ts"
+            "name": "ForgeAiPopoverComponent",
+            "module": "src/lib/core/popover/popover.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "forge-ai-tooltip",
+          "name": "forge-ai-popover",
           "declaration": {
-            "name": "ForgeAiTooltipComponent",
-            "module": "src/lib/core/tooltip/tooltip.ts"
+            "name": "ForgeAiPopoverComponent",
+            "module": "src/lib/core/popover/popover.ts"
           }
         }
       ]
@@ -12165,10 +12293,6 @@
       "path": "src/lib/ai-agent-info/ai-agent-info.ts",
       "lineNumber": 29
     },
-    "AiArtifactComponent": {
-      "path": "src/lib/ai-artifact/ai-artifact.ts",
-      "lineNumber": 23
-    },
     "ForgeAiAgentSelectorChangeEventData": {
       "path": "src/lib/ai-agent-selector/ai-agent-selector.ts",
       "lineNumber": 23
@@ -12177,13 +12301,9 @@
       "path": "src/lib/ai-agent-selector/ai-agent-selector.ts",
       "lineNumber": 48
     },
-    "ForgeAiAssistantResponseFeedbackEventData": {
-      "path": "src/lib/ai-assistant-response/ai-assistant-response.ts",
-      "lineNumber": 31
-    },
-    "AiAssistantResponseComponent": {
-      "path": "src/lib/ai-assistant-response/ai-assistant-response.ts",
-      "lineNumber": 48
+    "AiArtifactComponent": {
+      "path": "src/lib/ai-artifact/ai-artifact.ts",
+      "lineNumber": 23
     },
     "ForgeAiAttachmentRemoveEventData": {
       "path": "src/lib/ai-attachment/ai-attachment.ts",
@@ -12193,6 +12313,14 @@
       "path": "src/lib/ai-attachment/ai-attachment.ts",
       "lineNumber": 41
     },
+    "ForgeAiAssistantResponseFeedbackEventData": {
+      "path": "src/lib/ai-assistant-response/ai-assistant-response.ts",
+      "lineNumber": 31
+    },
+    "AiAssistantResponseComponent": {
+      "path": "src/lib/ai-assistant-response/ai-assistant-response.ts",
+      "lineNumber": 48
+    },
     "AiButtonComponent": {
       "path": "src/lib/ai-button/ai-button.ts",
       "lineNumber": 22
@@ -12215,7 +12343,7 @@
     },
     "AiChatHeaderComponent": {
       "path": "src/lib/ai-chat-header/ai-chat-header.ts",
-      "lineNumber": 76
+      "lineNumber": 77
     },
     "AiChatInterfaceComponent": {
       "path": "src/lib/ai-chat-interface/ai-chat-interface.ts",
@@ -12379,7 +12507,7 @@
     },
     "AiChatbotComponent": {
       "path": "src/lib/ai-chatbot/ai-chatbot.ts",
-      "lineNumber": 132
+      "lineNumber": 134
     },
     "CreateToolRendererElementConfig": {
       "path": "src/lib/ai-chatbot/create-tool-renderer.ts",
@@ -12551,7 +12679,7 @@
     },
     "AiChatbotLauncherComponent": {
       "path": "src/lib/ai-chatbot-launcher/ai-chatbot-launcher.ts",
-      "lineNumber": 73
+      "lineNumber": 74
     },
     "AiConfirmationPromptComponent": {
       "path": "src/lib/ai-confirmation-prompt/ai-confirmation-prompt.ts",
@@ -12561,6 +12689,14 @@
       "path": "src/lib/ai-dialog/ai-dialog.ts",
       "lineNumber": 35
     },
+    "AiDisclaimerComponent": {
+      "path": "src/lib/ai-disclaimer/ai-disclaimer.ts",
+      "lineNumber": 32
+    },
+    "AiEmbeddedChatComponent": {
+      "path": "src/lib/ai-embedded-chat/ai-embedded-chat.ts",
+      "lineNumber": 47
+    },
     "ForgeAiDropdownMenuItemGroupComponent": {
       "path": "src/lib/ai-dropdown-menu/ai-dropdown-menu-item-group.ts",
       "lineNumber": 29
@@ -12621,10 +12757,6 @@
       "path": "src/lib/ai-dropdown-menu/selection-manager.ts",
       "lineNumber": 85
     },
-    "AiEmbeddedChatComponent": {
-      "path": "src/lib/ai-embedded-chat/ai-embedded-chat.ts",
-      "lineNumber": 47
-    },
     "AiEmptyStateComponent": {
       "path": "src/lib/ai-empty-state/ai-empty-state.ts",
       "lineNumber": 23
@@ -12639,7 +12771,7 @@
     },
     "AiFabComponent": {
       "path": "src/lib/ai-fab/ai-fab.ts",
-      "lineNumber": 22
+      "lineNumber": 27
     },
     "ForgeAiFilePickerChangeEventData": {
       "path": "src/lib/ai-file-picker/ai-file-picker.ts",
@@ -12673,6 +12805,14 @@
       "path": "src/lib/ai-icon/ai-icon.ts",
       "lineNumber": 23
     },
+    "AiIconButtonComponent": {
+      "path": "src/lib/ai-icon-button/ai-icon-button.ts",
+      "lineNumber": 19
+    },
+    "AiModalComponent": {
+      "path": "src/lib/ai-modal/ai-modal.ts",
+      "lineNumber": 36
+    },
     "ForgeAiMessageThreadCopyEventData": {
       "path": "src/lib/ai-message-thread/ai-message-thread.ts",
       "lineNumber": 37
@@ -12691,11 +12831,7 @@
     },
     "AiMessageThreadComponent": {
       "path": "src/lib/ai-message-thread/ai-message-thread.ts",
-      "lineNumber": 78
-    },
-    "AiIconButtonComponent": {
-      "path": "src/lib/ai-icon-button/ai-icon-button.ts",
-      "lineNumber": 19
+      "lineNumber": 80
     },
     "ForgeAiPromptSendEventData": {
       "path": "src/lib/ai-prompt/ai-prompt.ts",
@@ -12717,22 +12853,18 @@
       "path": "src/lib/ai-prompt/ai-prompt.ts",
       "lineNumber": 63
     },
-    "AiModalComponent": {
-      "path": "src/lib/ai-modal/ai-modal.ts",
-      "lineNumber": 36
-    },
     "AiReasoningComponent": {
       "path": "src/lib/ai-reasoning/ai-reasoning.ts",
       "lineNumber": 17
     },
-    "AiResponseMessageComponent": {
-      "path": "src/lib/ai-response-message/ai-response-message.ts",
-      "lineNumber": 19
-    },
     "AiReasoningHeaderComponent": {
       "path": "src/lib/ai-reasoning-header/ai-reasoning-header.ts",
       "lineNumber": 22
     },
+    "AiResponseMessageComponent": {
+      "path": "src/lib/ai-response-message/ai-response-message.ts",
+      "lineNumber": 19
+    },
     "ForgeAiResponseMessageToolbarActionEventData": {
       "path": "src/lib/ai-response-message-toolbar/ai-response-message-toolbar.ts",
       "lineNumber": 23
@@ -12749,18 +12881,22 @@
       "path": "src/lib/ai-response-message-toolbar/ai-response-message-toolbar.ts",
       "lineNumber": 43
     },
-    "AiSidebarChatComponent": {
-      "path": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts",
-      "lineNumber": 42
-    },
     "AiSidebarComponent": {
       "path": "src/lib/ai-sidebar/ai-sidebar.ts",
       "lineNumber": 28
     },
+    "AiSidebarChatComponent": {
+      "path": "src/lib/ai-sidebar-chat/ai-sidebar-chat.ts",
+      "lineNumber": 42
+    },
     "AiSlashCommandMenuComponent": {
       "path": "src/lib/ai-slash-command-menu/ai-slash-command-menu.ts",
       "lineNumber": 32
     },
+    "AiThinkingIndicatorComponent": {
+      "path": "src/lib/ai-thinking-indicator/ai-thinking-indicator.ts",
+      "lineNumber": 38
+    },
     "SpinnerSize": {
       "path": "src/lib/ai-spinner/ai-spinner.ts",
       "lineNumber": 14
@@ -12769,10 +12905,6 @@
       "path": "src/lib/ai-spinner/ai-spinner.ts",
       "lineNumber": 27
     },
-    "AiThinkingIndicatorComponent": {
-      "path": "src/lib/ai-thinking-indicator/ai-thinking-indicator.ts",
-      "lineNumber": 38
-    },
     "Suggestion": {
       "path": "src/lib/ai-suggestions/ai-suggestions.ts",
       "lineNumber": 20
@@ -12901,6 +13033,10 @@
       "path": "src/lib/ai-reasoning/reasoning-content/reasoning-content.ts",
       "lineNumber": 17
     },
+    "AiPaginator": {
+      "path": "src/lib/tools/ai-paginator/ai-paginator.ts",
+      "lineNumber": 13
+    },
     "TableData": {
       "path": "src/lib/tools/ai-data-table/ai-data-table.ts",
       "lineNumber": 16
@@ -12909,10 +13045,6 @@
       "path": "src/lib/tools/ai-data-table/ai-data-table.ts",
       "lineNumber": 32
     },
-    "AiPaginator": {
-      "path": "src/lib/tools/ai-paginator/ai-paginator.ts",
-      "lineNumber": 13
-    },
     "OverlayPlacement": {
       "path": "src/lib/core/overlay/overlay.ts",
       "lineNumber": 31
@@ -12925,22 +13057,6 @@
       "path": "src/lib/core/overlay/overlay.ts",
       "lineNumber": 40
     },
-    "PopoverToggleEventData": {
-      "path": "src/lib/core/popover/popover.ts",
-      "lineNumber": 18
-    },
-    "PopoverPlacement": {
-      "path": "src/lib/core/popover/popover.ts",
-      "lineNumber": 24
-    },
-    "PopoverOffset": {
-      "path": "src/lib/core/popover/popover.ts",
-      "lineNumber": 26
-    },
-    "ForgeAiPopoverComponent": {
-      "path": "src/lib/core/popover/popover.ts",
-      "lineNumber": 37
-    },
     "TooltipToggleEventDetail": {
       "path": "src/lib/core/tooltip/tooltip.ts",
       "lineNumber": 20
@@ -12956,6 +13072,22 @@
     "ForgeAiTooltipComponent": {
       "path": "src/lib/core/tooltip/tooltip.ts",
       "lineNumber": 44
+    },
+    "PopoverToggleEventData": {
+      "path": "src/lib/core/popover/popover.ts",
+      "lineNumber": 18
+    },
+    "PopoverPlacement": {
+      "path": "src/lib/core/popover/popover.ts",
+      "lineNumber": 24
+    },
+    "PopoverOffset": {
+      "path": "src/lib/core/popover/popover.ts",
+      "lineNumber": 26
+    },
+    "ForgeAiPopoverComponent": {
+      "path": "src/lib/core/popover/popover.ts",
+      "lineNumber": 37
     }
   }
 }