@luzmo/analytics-components-kit 1.0.3-beta.1 → 1.0.3-beta.11

package/custom-elements.json

@@ -4,70 +4,215 @@
   "modules": [
     {
       "kind": "javascript-module",
-      "path": "src/components/ai-chat/ai-chat-streaming.ts",
+      "path": "src/components/ai-chat/ai-chat-events.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "createInitialProgress",
+          "name": "isRecognizedStep",
           "return": {
             "type": {
-              "text": "ProgressTreeNode"
+              "text": "event is RecognizedStepEvent"
+            }
+          },
+          "parameters": [
+            {
+              "name": "event",
+              "type": {
+                "text": "AiChatStepEvent"
+              }
             }
+          ],
+          "description": "Type guard separating the typed, recognized step set from the open passthrough.\nLets consumers `switch` exhaustively on `event.type` with fully narrowed `data`."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "isRecognizedStep",
+          "declaration": {
+            "name": "isRecognizedStep",
+            "module": "src/components/ai-chat/ai-chat-events.ts"
           }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/ai-chat-request.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "getAiPromptUrl",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "apiUrl",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "apiVersion",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
         },
         {
           "kind": "function",
-          "name": "hasProgressChunk",
+          "name": "chartToItemAsset",
           "return": {
             "type": {
-              "text": "boolean"
+              "text": "Record<string, unknown> | null"
             }
           },
           "parameters": [
             {
-              "name": "value",
+              "name": "chart",
               "type": {
-                "text": "Record<string, unknown>"
+                "text": "LuzmoChart"
               }
             }
           ]
         },
         {
           "kind": "function",
-          "name": "fetchStreamingResponse",
+          "name": "buildItemAiPromptProperties",
           "return": {
             "type": {
-              "text": "Promise<StreamingResponse>"
+              "text": "AiPromptProperties"
             }
           },
           "parameters": [
             {
-              "name": "options",
+              "name": "ctx",
               "type": {
-                "text": "StreamingRequestOptions"
+                "text": "BuildAiPromptRequestContext"
               }
             }
           ]
         },
         {
           "kind": "function",
-          "name": "readNdjsonStream",
+          "name": "buildDashboardAiPromptProperties",
           "return": {
             "type": {
-              "text": "Promise<void>"
+              "text": "AiPromptProperties"
             }
           },
           "parameters": [
             {
-              "name": "body",
+              "name": "ctx",
               "type": {
-                "text": "ReadableStream<Uint8Array>"
+                "text": "BuildAiPromptRequestContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "buildAnalystAiPromptProperties",
+          "return": {
+            "type": {
+              "text": "AiPromptProperties"
+            }
+          },
+          "parameters": [
+            {
+              "name": "ctx",
+              "type": {
+                "text": "BuildAiPromptRequestContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "buildAiPromptProperties",
+          "return": {
+            "type": {
+              "text": "AiPromptProperties"
+            }
+          },
+          "parameters": [
+            {
+              "name": "agent",
+              "type": {
+                "text": "AiPromptAgent"
               }
             },
             {
-              "name": "onChunk",
+              "name": "ctx",
               "type": {
-                "text": "(chunk: Record<string, unknown>) => void"
+                "text": "BuildAiPromptRequestContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "buildAiPromptRequest",
+          "return": {
+            "type": {
+              "text": "AiPromptCreateBody"
+            }
+          },
+          "parameters": [
+            {
+              "name": "agent",
+              "type": {
+                "text": "AiPromptAgent"
+              }
+            },
+            {
+              "name": "ctx",
+              "type": {
+                "text": "BuildAiPromptRequestContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "buildAiPromptDeleteRequest",
+          "return": {
+            "type": {
+              "text": "AiPromptDeleteBody"
+            }
+          },
+          "parameters": [
+            {
+              "name": "restoreToMessageId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "authKey",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "authToken",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "apiVersion",
+              "default": "'0.1.0'"
+            },
+            {
+              "name": "conversationId",
+              "default": "null",
+              "type": {
+                "text": "string | null"
               }
             }
           ]
@@ -76,34 +221,162 @@
       "exports": [
         {
           "kind": "js",
-          "name": "createInitialProgress",
+          "name": "AiPromptAgent",
           "declaration": {
-            "name": "createInitialProgress",
-            "module": "src/components/ai-chat/ai-chat-streaming.ts"
+            "name": "AiPromptAgent",
+            "module": "./ai-prompt-types"
           }
         },
         {
           "kind": "js",
-          "name": "hasProgressChunk",
+          "name": "AiPromptCreateBody",
           "declaration": {
-            "name": "hasProgressChunk",
-            "module": "src/components/ai-chat/ai-chat-streaming.ts"
+            "name": "AiPromptCreateBody",
+            "module": "./ai-prompt-types"
           }
         },
         {
           "kind": "js",
-          "name": "fetchStreamingResponse",
+          "name": "AiPromptDeleteBody",
           "declaration": {
-            "name": "fetchStreamingResponse",
-            "module": "src/components/ai-chat/ai-chat-streaming.ts"
+            "name": "AiPromptDeleteBody",
+            "module": "./ai-prompt-types"
           }
         },
         {
           "kind": "js",
-          "name": "readNdjsonStream",
+          "name": "AiPromptInput",
           "declaration": {
-            "name": "readNdjsonStream",
-            "module": "src/components/ai-chat/ai-chat-streaming.ts"
+            "name": "AiPromptInput",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiPromptItemTask",
+          "declaration": {
+            "name": "AiPromptItemTask",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiPromptProperties",
+          "declaration": {
+            "name": "AiPromptProperties",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiPromptScreenMode",
+          "declaration": {
+            "name": "AiPromptScreenMode",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BuildAiPromptRequestContext",
+          "declaration": {
+            "name": "BuildAiPromptRequestContext",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DashboardStatePayload",
+          "declaration": {
+            "name": "DashboardStatePayload",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoDashboardGeneratedEventDetail",
+          "declaration": {
+            "name": "LuzmoDashboardGeneratedEventDetail",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoPromptSubmittedEventDetail",
+          "declaration": {
+            "name": "LuzmoPromptSubmittedEventDetail",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoRestoreRequestedEventDetail",
+          "declaration": {
+            "name": "LuzmoRestoreRequestedEventDetail",
+            "module": "./ai-prompt-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getAiPromptUrl",
+          "declaration": {
+            "name": "getAiPromptUrl",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "chartToItemAsset",
+          "declaration": {
+            "name": "chartToItemAsset",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildItemAiPromptProperties",
+          "declaration": {
+            "name": "buildItemAiPromptProperties",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildDashboardAiPromptProperties",
+          "declaration": {
+            "name": "buildDashboardAiPromptProperties",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildAnalystAiPromptProperties",
+          "declaration": {
+            "name": "buildAnalystAiPromptProperties",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildAiPromptProperties",
+          "declaration": {
+            "name": "buildAiPromptProperties",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildAiPromptRequest",
+          "declaration": {
+            "name": "buildAiPromptRequest",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildAiPromptDeleteRequest",
+          "declaration": {
+            "name": "buildAiPromptDeleteRequest",
+            "module": "src/components/ai-chat/ai-chat-request.ts"
           }
         }
       ]
@@ -133,7 +406,7 @@
                 "text": "ChatMessage[]"
               },
               "default": "[]",
-              "description": "Array of chat messages to display",
+              "description": "Live transcript is AiChatSession.state.messages. This prop optionally seeds the session on first connect.",
               "attribute": "messages"
             },
             {
@@ -143,7 +416,7 @@
                 "text": "Dataset[]"
               },
               "default": "[]",
-              "description": "Array of selected datasets for the input",
+              "description": "Live selection is in the session. This prop optionally seeds on first connect.",
               "attribute": "selected-datasets"
             },
             {
@@ -167,6 +440,17 @@
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "stoppable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, shows a stop control on the prompt input while a response is generating",
+              "attribute": "stoppable",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "showAssistantContextMenu",
@@ -279,57 +563,114 @@
             },
             {
               "kind": "field",
-              "name": "modelPreference",
+              "name": "requireDataset",
               "type": {
-                "text": "'performance' | 'quality'"
+                "text": "boolean"
               },
-              "default": "'performance'",
-              "description": "AI model preference for chart generation",
-              "attribute": "model-preference"
+              "default": "false",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "attribute": "require-dataset"
             },
             {
               "kind": "field",
-              "name": "requestMode",
+              "name": "agent",
               "type": {
-                "text": "'internal' | 'external'"
+                "text": "AiPromptAgent"
               },
-              "default": "'internal'",
-              "description": "Controls if API calls are handled internally or by the host application.",
-              "attribute": "request-mode"
+              "default": "'item'",
+              "description": "Which aiprompt agent to use. Determines request payload and stream handling.",
+              "attribute": "agent"
             },
             {
               "kind": "field",
-              "name": "isGenerating",
+              "name": "task",
               "type": {
-                "text": "boolean"
+                "text": "AiPromptItemTask"
               },
-              "default": "false",
-              "description": "Used only in external request mode to reflect request lifecycle in the UI.",
-              "attribute": "is-generating"
+              "default": "'generate'",
+              "description": "Task for the item agent (`generate`, `suggest`, `describe`).",
+              "attribute": "task"
             },
             {
               "kind": "field",
-              "name": "conversationId",
+              "name": "modelPreference",
               "type": {
-                "text": "string | null"
+                "text": "'performance' | 'quality'"
               },
-              "default": "null",
-              "description": "Conversation ID",
-              "attribute": "conversation-id"
+              "default": "'performance'",
+              "description": "AI model preference for item agent chart generation",
+              "attribute": "model-preference"
             },
             {
               "kind": "field",
-              "name": "chart",
+              "name": "chatSession",
               "type": {
-                "text": "LuzmoChart | null"
+                "text": "AiChatSession | null"
               },
               "default": "null",
-              "description": "vizItem",
-              "attribute": "chart"
+              "description": "Host-owned AiChatSession. The component subscribes and renders; does not abort on disconnect."
             },
             {
               "kind": "field",
-              "name": "apiVersion",
+              "name": "conversationId",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Conversation ID (synced into the session; updated when the API returns a new id).",
+              "attribute": "conversation-id"
+            },
+            {
+              "kind": "field",
+              "name": "chart",
+              "type": {
+                "text": "LuzmoChart | null"
+              },
+              "default": "null",
+              "description": "Chart context for `agent=\"item\"`.",
+              "attribute": "chart"
+            },
+            {
+              "kind": "field",
+              "name": "dashboard",
+              "type": {
+                "text": "DashboardStatePayload | null"
+              },
+              "default": "null",
+              "description": "Dashboard context for `agent=\"dashboard\"`.",
+              "attribute": "dashboard"
+            },
+            {
+              "kind": "field",
+              "name": "currentScreenMode",
+              "type": {
+                "text": "AiPromptScreenMode | undefined"
+              },
+              "description": "Current screen mode when editing a dashboard.",
+              "attribute": "current-screen-mode"
+            },
+            {
+              "kind": "field",
+              "name": "localeId",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Locale ID sent to the aiprompt API.",
+              "attribute": "locale-id"
+            },
+            {
+              "kind": "field",
+              "name": "timezoneId",
+              "type": {
+                "text": "string"
+              },
+              "default": "'UTC'",
+              "description": "Timezone ID for dashboard agent requests.",
+              "attribute": "timezone-id"
+            },
+            {
+              "kind": "field",
+              "name": "apiVersion",
               "type": {
                 "text": "string"
               },
@@ -354,7 +695,7 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "Loading message shown while generating and before progress steps are available.\nOnly effective in external request mode; in internal mode, progress steps\nare initialized immediately.",
+              "description": "Loading message shown while generating and before progress steps are available.",
               "attribute": "loading-message"
             },
             {
@@ -364,28 +705,46 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "When set, the component auto-submits this prompt via the streaming API\nwithout adding a duplicate user message (assumes it is already in `messages`).\nUseful when the prompt originates from an external source (e.g. a dropdown).",
+              "description": "When set, auto-submits via the session without adding a duplicate user message\n(assumes the prompt is already in the transcript).",
               "attribute": "initial-prompt"
             },
             {
               "kind": "field",
-              "name": "progress",
+              "name": "emptyStateTitle",
               "type": {
-                "text": "ProgressTreeNode | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "Progress tree for external request mode. Ignored in internal mode.",
-              "attribute": "progress"
+              "default": "''",
+              "description": "Title for the empty state when there are no messages.",
+              "attribute": "empty-state-title"
             },
             {
               "kind": "field",
-              "name": "progressCollapsed",
+              "name": "emptyStateSubtitle",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether progress steps should be shown collapsed.\nOnly used in external request mode. Ignored in internal mode.",
-              "attribute": "progress-collapsed"
+              "default": "''",
+              "description": "Optional label above empty-state suggestion chips. Only shown when `emptyStateSuggestions` is non-empty.",
+              "attribute": "empty-state-subtitle"
+            },
+            {
+              "kind": "field",
+              "name": "emptyStateSuggestions",
+              "type": {
+                "text": "AiChatEmptyStateSuggestion[]"
+              },
+              "default": "[]",
+              "description": "Optional suggestion chips for the empty state. When empty, only the title is shown.\nEach entry may include `selectedDatasets` to pre-select datasets when the chip is activated."
+            },
+            {
+              "kind": "field",
+              "name": "session",
+              "type": {
+                "text": "AiChatSession | null"
+              },
+              "description": "Active AiChatSession (host or auto-created). Null until first bind or action.",
+              "readonly": true
             },
             {
               "type": {
@@ -590,45 +949,46 @@
           ],
           "events": [
             {
-              "name": "luzmo-response-received",
+              "name": "luzmo-message-sent",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<AiChatMessageSentEventDetail>"
               },
-              "description": "Fired when an AI text response is received. For chart responses, this event is only fired if the response includes a `message` field. For error responses, this event is always fired with the error explanation."
+              "description": "Fired when a user sends a message"
             },
             {
-              "name": "luzmo-chart-generated",
+              "name": "luzmo-datasets-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<AiChatDatasetsChangedEventDetail>"
               },
-              "description": "Fired when the AI generates a chart (includes generatedChart in response)"
+              "description": "Fired when the selected datasets change"
             },
             {
-              "name": "luzmo-message-sent",
+              "name": "luzmo-step",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<AiChatStepEvent>"
               },
-              "description": "Fired when a user sends a message"
+              "description": "Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow."
             },
             {
-              "name": "luzmo-restore-requested",
+              "name": "luzmo-complete",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<AiChatCompleteEvent>"
               },
-              "description": "Fired when a restore action is triggered in external mode"
+              "description": "Fired exactly once per response with the authoritative final result (dashboard/chart/name) or an `error`."
             },
             {
-              "name": "luzmo-datasets-changed",
+              "name": "luzmo-stop",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when an in-flight prompt is stopped"
             },
             {
-              "name": "luzmo-prompt-submitted",
+              "name": "luzmo-conversation-id-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<AiChatConversationIdChangedEventDetail>"
               },
-              "description": "Fired when request-mode is set to external so the host can execute the API request lifecycle."
+              "description": "Fired when the conversation ID is updated from the API"
             }
           ],
           "attributes": [
@@ -638,7 +998,7 @@
                 "text": "ChatMessage[]"
               },
               "default": "[]",
-              "description": "Array of chat messages to display",
+              "description": "Live transcript is AiChatSession.state.messages. This prop optionally seeds the session on first connect.",
               "fieldName": "messages"
             },
             {
@@ -647,7 +1007,7 @@
                 "text": "Dataset[]"
               },
               "default": "[]",
-              "description": "Array of selected datasets for the input",
+              "description": "Live selection is in the session. This prop optionally seeds on first connect.",
               "fieldName": "selectedDatasets"
             },
             {
@@ -668,6 +1028,15 @@
               "description": "When true, disables the entire chat interface",
               "fieldName": "disabled"
             },
+            {
+              "name": "stoppable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, shows a stop control on the prompt input while a response is generating",
+              "fieldName": "stoppable"
+            },
             {
               "name": "show-assistant-context-menu",
               "type": {
@@ -768,31 +1137,40 @@
               "fieldName": "disableColumnMentions"
             },
             {
-              "name": "model-preference",
+              "name": "require-dataset",
               "type": {
-                "text": "'performance' | 'quality'"
+                "text": "boolean"
               },
-              "default": "'performance'",
-              "description": "AI model preference for chart generation",
-              "fieldName": "modelPreference"
+              "default": "false",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "fieldName": "requireDataset"
             },
             {
-              "name": "request-mode",
+              "name": "agent",
               "type": {
-                "text": "'internal' | 'external'"
+                "text": "AiPromptAgent"
               },
-              "default": "'internal'",
-              "description": "Controls if API calls are handled internally or by the host application.",
-              "fieldName": "requestMode"
+              "default": "'item'",
+              "description": "Which aiprompt agent to use. Determines request payload and stream handling.",
+              "fieldName": "agent"
             },
             {
-              "name": "is-generating",
+              "name": "task",
               "type": {
-                "text": "boolean"
+                "text": "AiPromptItemTask"
               },
-              "default": "false",
-              "description": "Used only in external request mode to reflect request lifecycle in the UI.",
-              "fieldName": "isGenerating"
+              "default": "'generate'",
+              "description": "Task for the item agent (`generate`, `suggest`, `describe`).",
+              "fieldName": "task"
+            },
+            {
+              "name": "model-preference",
+              "type": {
+                "text": "'performance' | 'quality'"
+              },
+              "default": "'performance'",
+              "description": "AI model preference for item agent chart generation",
+              "fieldName": "modelPreference"
             },
             {
               "name": "conversation-id",
@@ -800,7 +1178,7 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "Conversation ID",
+              "description": "Conversation ID (synced into the session; updated when the API returns a new id).",
               "fieldName": "conversationId"
             },
             {
@@ -809,9 +1187,43 @@
                 "text": "LuzmoChart | null"
               },
               "default": "null",
-              "description": "vizItem",
+              "description": "Chart context for `agent=\"item\"`.",
               "fieldName": "chart"
             },
+            {
+              "name": "dashboard",
+              "type": {
+                "text": "DashboardStatePayload | null"
+              },
+              "default": "null",
+              "description": "Dashboard context for `agent=\"dashboard\"`.",
+              "fieldName": "dashboard"
+            },
+            {
+              "name": "current-screen-mode",
+              "type": {
+                "text": "AiPromptScreenMode | undefined"
+              },
+              "description": "Current screen mode when editing a dashboard.",
+              "fieldName": "currentScreenMode"
+            },
+            {
+              "name": "locale-id",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Locale ID sent to the aiprompt API.",
+              "fieldName": "localeId"
+            },
+            {
+              "name": "timezone-id",
+              "type": {
+                "text": "string"
+              },
+              "default": "'UTC'",
+              "description": "Timezone ID for dashboard agent requests.",
+              "fieldName": "timezoneId"
+            },
             {
               "name": "api-version",
               "type": {
@@ -836,7 +1248,7 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "Loading message shown while generating and before progress steps are available.\nOnly effective in external request mode; in internal mode, progress steps\nare initialized immediately.",
+              "description": "Loading message shown while generating and before progress steps are available.",
               "fieldName": "loadingMessage"
             },
             {
@@ -845,26 +1257,26 @@
                 "text": "string | null"
               },
               "default": "null",
-              "description": "When set, the component auto-submits this prompt via the streaming API\nwithout adding a duplicate user message (assumes it is already in `messages`).\nUseful when the prompt originates from an external source (e.g. a dropdown).",
+              "description": "When set, auto-submits via the session without adding a duplicate user message\n(assumes the prompt is already in the transcript).",
               "fieldName": "initialPrompt"
             },
             {
-              "name": "progress",
+              "name": "empty-state-title",
               "type": {
-                "text": "ProgressTreeNode | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "Progress tree for external request mode. Ignored in internal mode.",
-              "fieldName": "progress"
+              "default": "''",
+              "description": "Title for the empty state when there are no messages.",
+              "fieldName": "emptyStateTitle"
             },
             {
-              "name": "progress-collapsed",
+              "name": "empty-state-subtitle",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Whether progress steps should be shown collapsed.\nOnly used in external request mode. Ignored in internal mode.",
-              "fieldName": "progressCollapsed"
+              "default": "''",
+              "description": "Optional label above empty-state suggestion chips. Only shown when `emptyStateSuggestions` is non-empty.",
+              "fieldName": "emptyStateSubtitle"
             }
           ],
           "superclass": {
@@ -873,15 +1285,7 @@
           },
           "tagName": "luzmo-ai-chat",
           "customElement": true,
-          "summary": "A complete AI chat interface combining messages display and input"
-        },
-        {
-          "kind": "variable",
-          "name": "request"
-        },
-        {
-          "kind": "variable",
-          "name": "messageIndex"
+          "summary": "AI chat UI backed by AiChatSession for transcript, datasets, and streaming."
         }
       ],
       "exports": [
@@ -897,86 +1301,18 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/ai-chat/request-contract.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "buildAiMessageRequest",
-          "return": {
-            "type": {
-              "text": "AiMessageRequestBody"
-            }
-          },
-          "parameters": [
-            {
-              "name": "options",
-              "type": {
-                "text": "BuildAiMessageRequestOptions"
-              }
-            }
-          ]
-        },
-        {
-          "kind": "function",
-          "name": "buildAiMessageDeleteRequest",
-          "return": {
-            "type": {
-              "text": "AiMessageDeleteRequestBody"
-            }
-          },
-          "parameters": [
-            {
-              "name": "restoreToMessageId",
-              "type": {
-                "text": "string"
-              }
-            },
-            {
-              "name": "authKey",
-              "type": {
-                "text": "string"
-              }
-            },
-            {
-              "name": "authToken",
-              "type": {
-                "text": "string"
-              }
-            },
-            {
-              "name": "apiVersion",
-              "default": "'0.1.0'"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "buildAiMessageRequest",
-          "declaration": {
-            "name": "buildAiMessageRequest",
-            "module": "src/components/ai-chat/request-contract.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "buildAiMessageDeleteRequest",
-          "declaration": {
-            "name": "buildAiMessageDeleteRequest",
-            "module": "src/components/ai-chat/request-contract.ts"
-          }
-        }
-      ]
+      "path": "src/components/ai-chat/ai-prompt-types.ts",
+      "declarations": [],
+      "exports": []
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/ai-interaction-textarea/ai-interaction-textarea.ts",
+      "path": "src/components/ai-chat/empty-state/ai-chat-empty-state.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "LuzmoAiInteractionTextarea",
+          "name": "LuzmoAiChatEmptyState",
           "members": [
             {
               "kind": "field",
@@ -985,361 +1321,1486 @@
                 "text": "string"
               },
               "static": true,
-              "default": "'luzmo-ai-interaction-textarea'"
+              "default": "'luzmo-ai-chat-empty-state'"
             },
             {
               "kind": "field",
-              "name": "placeholder",
+              "name": "title",
+              "description": "Heading shown above the suggestions.",
+              "attribute": "title"
+            },
+            {
+              "kind": "field",
+              "name": "subtitle",
               "type": {
                 "text": "string"
               },
-              "default": "'Type your prompt here...'",
-              "description": "Placeholder text for the textarea",
-              "attribute": "placeholder"
+              "default": "''",
+              "description": "Supporting text shown above suggestion chips when `suggestions` is non-empty.",
+              "attribute": "subtitle"
             },
             {
               "kind": "field",
-              "name": "selectedDatasets",
+              "name": "suggestions",
               "type": {
-                "text": "Dataset[]"
+                "text": "AiChatEmptyStateSuggestion[]"
               },
               "default": "[]",
-              "description": "Array of selected datasets",
-              "attribute": "selectedDatasets"
+              "description": "Suggestion chips rendered with https://lucero.luzmo.com/ | Lucero `luzmo-action-button` (`variant=\"accent\"`).",
+              "attribute": "suggestions"
             },
             {
               "kind": "field",
-              "name": "authKey",
+              "name": "disabled",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Auth key for DataBroker authentication",
-              "attribute": "auth-key"
+              "default": "false",
+              "description": "When true, suggestion chips cannot be activated.",
+              "attribute": "disabled",
+              "reflects": true
             },
             {
-              "kind": "field",
-              "name": "authToken",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Auth token for DataBroker authentication",
-              "attribute": "auth-token"
+              "description": "Gap between the title and the actions block",
+              "name": "--luzmo-ai-chat-empty-state-header-actions-gap",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "apiUrl",
               "type": {
                 "text": "string"
               },
-              "default": "'https://api.luzmo.com'",
-              "description": "API URL for DataBroker",
-              "attribute": "api-url"
+              "description": "Gap between the actions label and suggestion chips",
+              "name": "--luzmo-ai-chat-empty-state-actions-gap",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "appServer",
               "type": {
                 "text": "string"
               },
-              "default": "'https://app.luzmo.com'",
-              "description": "The URL of the app server for thumbnails and assets",
-              "attribute": "app-server"
+              "description": "Gap between suggestion chips",
+              "name": "--luzmo-ai-chat-empty-state-suggestions-gap",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "flagOpendata",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
-              "attribute": "flag-opendata"
+              "description": "Maximum content width",
+              "name": "--luzmo-ai-chat-empty-state-max-width",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "disabled",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When true, disables the entire component (opacity 60%, no interactions)",
-              "attribute": "disabled",
-              "reflects": true
+              "description": "Vertical padding",
+              "name": "--luzmo-ai-chat-empty-state-padding-block",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "singleLine",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When true, starts in compact single-line mode and auto-expands as needed",
-              "attribute": "single-line"
-            },
-            {
-              "kind": "field",
-              "name": "hideDatasetButton",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "When true, hides the \"+ Add dataset\" button",
-              "attribute": "hide-dataset-button"
+              "description": "Horizontal padding",
+              "name": "--luzmo-ai-chat-empty-state-padding-inline",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "hideDatasetIcons",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When true, hides dataset-specific icons in selector tags and @ mention dataset headers",
-              "attribute": "hide-dataset-icons"
+              "description": "Title font size",
+              "name": "--luzmo-ai-chat-empty-state-title-font-size",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "disableDatasetModification",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When true, hides the \"+ Add dataset\" button and disables dataset pill removal",
-              "attribute": "disable-dataset-modification"
+              "description": "Title font weight",
+              "name": "--luzmo-ai-chat-empty-state-title-font-weight",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "hideSelectedDatasets",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When true, hides the dataset row entirely",
-              "attribute": "hide-selected-datasets"
+              "description": "Title line height",
+              "name": "--luzmo-ai-chat-empty-state-title-line-height",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "disableColumnMentions",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When true, disables @ trigger mentions completely",
-              "attribute": "disable-column-mentions"
+              "description": "Title text color",
+              "name": "--luzmo-ai-chat-empty-state-title-color",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "isGenerating",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When true, shows a spinning loader icon instead of the submit arrow",
-              "attribute": "is-generating"
+              "description": "Subtitle font size",
+              "name": "--luzmo-ai-chat-empty-state-subtitle-font-size",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "value",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "The current value of the textarea (can be controlled from parent to clear or set text)",
-              "attribute": "value"
+              "description": "Subtitle font weight",
+              "name": "--luzmo-ai-chat-empty-state-subtitle-font-weight",
+              "kind": "field"
             },
             {
-              "kind": "field",
-              "name": "retainOnSubmit",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "When true, retains the input value after submitting a prompt (default: false)\nWhen false (default), clears the textarea value after submission",
-              "attribute": "retain-on-submit"
+              "description": "Subtitle line height",
+              "name": "--luzmo-ai-chat-empty-state-subtitle-line-height",
+              "kind": "field"
             },
             {
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "When true, starts in compact single-line mode and auto-expands as needed",
-              "name": "single-line",
+              "description": "Subtitle text color (`--luzmo-font-color-dimmed`)",
+              "name": "--luzmo-ai-chat-empty-state-subtitle-color",
               "kind": "field"
-            },
+            }
+          ],
+          "events": [
             {
+              "name": "luzmo-suggestion-selected",
               "type": {
-                "text": "boolean"
+                "text": "CustomEvent<AiChatEmptyStateSuggestionSelectedDetail>"
               },
-              "description": "When true, hides the \"+ Add dataset\" button",
-              "name": "hide-dataset-button",
-              "kind": "field"
+              "description": "Fired when the user selects a suggestion chip"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "title",
+              "description": "Heading shown above the suggestions.",
+              "fieldName": "title"
             },
             {
+              "name": "subtitle",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "When true, hides dataset-specific icons in selector tags and `@` mention dataset headers",
-              "name": "hide-dataset-icons",
-              "kind": "field"
+              "default": "''",
+              "description": "Supporting text shown above suggestion chips when `suggestions` is non-empty.",
+              "fieldName": "subtitle"
             },
             {
+              "name": "suggestions",
               "type": {
-                "text": "boolean"
+                "text": "AiChatEmptyStateSuggestion[]"
               },
-              "description": "When true, hides the \"+ Add dataset\" button and disables dataset pill removal",
-              "name": "disable-dataset-modification",
-              "kind": "field"
+              "default": "[]",
+              "description": "Suggestion chips rendered with https://lucero.luzmo.com/ | Lucero `luzmo-action-button` (`variant=\"accent\"`).",
+              "fieldName": "suggestions"
             },
             {
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
-              "description": "When true, hides the dataset row entirely",
-              "name": "hide-selected-datasets",
-              "kind": "field"
-            },
+              "default": "false",
+              "description": "When true, suggestion chips cannot be activated.",
+              "fieldName": "disabled"
+            }
+          ],
+          "superclass": {
+            "name": "LuzmoElement",
+            "package": "@utils/base"
+          },
+          "tagName": "luzmo-ai-chat-empty-state",
+          "customElement": true,
+          "summary": "Empty state for AI chat with title, subtitle, and prompt suggestions."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LuzmoAiChatEmptyState",
+          "declaration": {
+            "name": "LuzmoAiChatEmptyState",
+            "module": "src/components/ai-chat/empty-state/ai-chat-empty-state.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/empty-state/types.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/session/ai-chat-session-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Single AiChatSession slot for `luzmo-ai-chat`.\nThe chat component uses current, state, and requireSession only.",
+          "name": "AiChatSessionController",
+          "members": [
             {
+              "kind": "field",
+              "name": "current",
               "type": {
-                "text": "boolean"
+                "text": "AiChatSession | null"
               },
-              "description": "When true, disables `@` trigger mentions completely",
-              "name": "disable-column-mentions",
-              "kind": "field"
+              "readonly": true
             },
             {
+              "kind": "field",
+              "name": "state",
               "type": {
-                "text": "boolean"
+                "text": "Readonly<AiChatSessionState>"
               },
-              "description": "When true, shows a spinning loader icon instead of the submit arrow",
-              "name": "is-generating",
-              "kind": "field"
+              "readonly": true
             },
             {
+              "kind": "field",
+              "name": "ownsCurrentSession",
               "type": {
                 "text": "boolean"
               },
-              "description": "When true, retains the input value after submission (default: false, clears on submit)",
-              "name": "retain-on-submit",
-              "kind": "field"
+              "readonly": true
             },
             {
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "setSession",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "Background color of the component",
-              "name": "--luzmo-ai-interaction-textarea-background-color",
-              "kind": "field"
+              "parameters": [
+                {
+                  "name": "session",
+                  "type": {
+                    "text": "AiChatSession | null"
+                  }
+                }
+              ],
+              "description": "Use an app-provided session (e.g. from `.chatSession`).\nPass `null` to clear it; an owned session may be created later via requireSession."
             },
             {
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "syncProperties",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "Border color of the component",
-              "name": "--luzmo-ai-interaction-textarea-border-color",
-              "kind": "field"
+              "parameters": [
+                {
+                  "name": "changedProperties",
+                  "type": {
+                    "text": "Map<string, unknown>"
+                  }
+                }
+              ],
+              "description": "Sync config / seed props after Lit `updated`.\nCall after handling `chatSession` via setSession."
             },
             {
-              "type": {
-                "text": "string"
-              },
-              "description": "Border radius of the component",
-              "name": "--luzmo-ai-interaction-textarea-border-radius",
-              "kind": "field"
+              "kind": "method",
+              "name": "requireSession",
+              "return": {
+                "type": {
+                  "text": "AiChatSession"
+                }
+              }
             },
             {
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "connect",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "Vertical and horizontal padding of the component",
-              "name": "--luzmo-ai-interaction-textarea-padding",
-              "kind": "field"
+              "description": "Re-attach UI bridge and state subscription after teardown on reconnect."
             },
             {
+              "kind": "method",
+              "name": "teardown",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiChatSessionController",
+          "declaration": {
+            "name": "AiChatSessionController",
+            "module": "src/components/ai-chat/session/ai-chat-session-controller.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/session/ai-chat-session-types.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiPromptCreateBody",
+          "declaration": {
+            "name": "AiPromptCreateBody",
+            "module": "src/components/ai-chat/session/ai-chat-session-types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiPromptDeleteBody",
+          "declaration": {
+            "name": "AiPromptDeleteBody",
+            "module": "src/components/ai-chat/session/ai-chat-session-types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoPromptSubmittedEventDetail",
+          "declaration": {
+            "name": "LuzmoPromptSubmittedEventDetail",
+            "module": "src/components/ai-chat/session/ai-chat-session-types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LuzmoRestoreRequestedEventDetail",
+          "declaration": {
+            "name": "LuzmoRestoreRequestedEventDetail",
+            "module": "src/components/ai-chat/session/ai-chat-session-types.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/session/ai-chat-session.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Headless chat controller: transcript, datasets, streaming, and API calls without a DOM host.\nUse with `luzmo-ai-chat` via `.chatSession` for the same simplicity as internal mode,\nwhile keeping the session alive when the panel unmounts.",
+          "name": "AiChatSession",
+          "members": [
+            {
+              "kind": "field",
+              "name": "state",
               "type": {
-                "text": "string"
+                "text": "Readonly<AiChatSessionState>"
               },
-              "description": "Gap between textarea sections",
-              "name": "--luzmo-ai-interaction-textarea-gap",
-              "kind": "field"
+              "readonly": true
             },
             {
+              "kind": "field",
+              "name": "isGenerating",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Font family used in the prompt box",
-              "name": "--luzmo-ai-interaction-textarea-font-family",
-              "kind": "field"
+              "readonly": true
             },
             {
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
               },
-              "description": "Font size used in the prompt box",
-              "name": "--luzmo-ai-interaction-textarea-font-size",
-              "kind": "field"
+              "parameters": [
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(state: AiChatSessionState) => void"
+                  }
+                }
+              ],
+              "description": "Subscribe to full session state (for `luzmo-ai-chat` rendering). Returns an unsubscribe function.\nThe listener is invoked immediately with the current state."
             },
             {
-              "type": {
+              "kind": "method",
+              "name": "setUiBridge",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "bridge",
+                  "type": {
+                    "text": "AiChatSessionCallbacks"
+                  }
+                }
+              ],
+              "description": "Wire `luzmo-ai-chat` DOM event bridging. Safe to call again when hot-swapping the same\nsession back onto the component — replaces the previous bridge instead of stacking it."
+            },
+            {
+              "kind": "method",
+              "name": "updateConfig",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "partial",
+                  "type": {
+                    "text": "Partial<AiChatSessionConfig>"
+                  }
+                }
+              ],
+              "description": "Merge config (chart, conversationId, agent, …) without aborting an in-flight request."
+            },
+            {
+              "kind": "method",
+              "name": "setSelectedDatasets",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "datasets",
+                  "type": {
+                    "text": "Dataset[]"
+                  }
+                }
+              ],
+              "description": "Replace the full dataset selection (e.g. when the dashboard context changes)."
+            },
+            {
+              "kind": "method",
+              "name": "addDataset",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "dataset",
+                  "type": {
+                    "text": "Dataset"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "removeDataset",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "datasetId",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "isDatasetRequirementMet",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getAiPromptUrl",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "buildRequestBody",
+              "return": {
+                "type": {
+                  "text": "AiPromptCreateBody"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "prompt",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "datasetIds",
+                  "type": {
+                    "text": "string[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "buildPromptSubmittedDetail",
+              "return": {
+                "type": {
+                  "text": "LuzmoPromptSubmittedEventDetail"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "prompt",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "selectedDatasets",
+                  "type": {
+                    "text": "Dataset[]"
+                  }
+                },
+                {
+                  "name": "datasetIds",
+                  "type": {
+                    "text": "string[]"
+                  }
+                },
+                {
+                  "name": "signal",
+                  "optional": true,
+                  "type": {
+                    "text": "AbortSignal"
+                  }
+                }
+              ],
+              "description": "Same payload passed to AiChatSessionCallbacks.onPromptSubmitted."
+            },
+            {
+              "kind": "method",
+              "name": "submit",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "params",
+                  "type": {
+                    "text": "AiChatSessionSubmitParams"
+                  }
+                }
+              ],
+              "description": "Append the user prompt (unless `skipUserMessage`), start streaming, and update state."
+            },
+            {
+              "kind": "method",
+              "name": "restore",
+              "return": {
+                "type": {
+                  "text": "Promise<AiChatSessionRestoreResult>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "params",
+                  "type": {
+                    "text": "AiChatSessionRestoreParams"
+                  }
+                }
+              ],
+              "description": "Item agent only — restore conversation to a prior API message."
+            },
+            {
+              "kind": "method",
+              "name": "buildRestoreRequest",
+              "return": {
+                "type": {
+                  "text": "AiPromptDeleteBody"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "restoreToMessageId",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "abort",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "default": "{}",
+                  "type": {
+                    "text": "{ notify?: boolean }"
+                  }
+                }
+              ],
+              "description": "Cancel the in-flight prompt and discard any partial assistant output."
+            }
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "aiMessage",
+          "type": {
+            "text": "ChatMessage"
+          },
+          "default": "{ id: params.aiMessageId ?? generateMessageId(), type: 'ai', message: '' }"
+        },
+        {
+          "kind": "function",
+          "name": "createAiChatSession",
+          "return": {
+            "type": {
+              "text": "AiChatSession"
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "AiChatSessionConfig"
+              }
+            },
+            {
+              "name": "callbacks",
+              "optional": true,
+              "type": {
+                "text": "AiChatSessionCallbacks"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiChatSession",
+          "declaration": {
+            "name": "AiChatSession",
+            "module": "src/components/ai-chat/session/ai-chat-session.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createAiChatSession",
+          "declaration": {
+            "name": "createAiChatSession",
+            "module": "src/components/ai-chat/session/ai-chat-session.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/chunk-extractors.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "extractInlineStreamText",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractStreamText",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "isStreamDone",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "applyConversationId",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            },
+            {
+              "name": "ctx",
+              "type": {
+                "text": "StreamHandlerContext"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractChartFromChunk",
+          "return": {
+            "type": {
+              "text": "Record<string, unknown> | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractDashboardName",
+          "return": {
+            "type": {
+              "text": "Record<string, string> | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "assets",
+              "type": {
+                "text": "unknown[]"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractDashboardFromChunk",
+          "return": {
+            "type": {
+              "text": "DashboardStatePayload | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractDashboardNameFromChunk",
+          "return": {
+            "type": {
+              "text": "Record<string, string> | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ],
+          "description": "Collect dashboard name from whichever asset array the chunk exposes."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "extractInlineStreamText",
+          "declaration": {
+            "name": "extractInlineStreamText",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractStreamText",
+          "declaration": {
+            "name": "extractStreamText",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isStreamDone",
+          "declaration": {
+            "name": "isStreamDone",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "applyConversationId",
+          "declaration": {
+            "name": "applyConversationId",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractChartFromChunk",
+          "declaration": {
+            "name": "extractChartFromChunk",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractDashboardName",
+          "declaration": {
+            "name": "extractDashboardName",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractDashboardFromChunk",
+          "declaration": {
+            "name": "extractDashboardFromChunk",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractDashboardNameFromChunk",
+          "declaration": {
+            "name": "extractDashboardNameFromChunk",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/progress.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "createInitialProgress",
+          "return": {
+            "type": {
+              "text": "ProgressTreeNode"
+            }
+          }
+        },
+        {
+          "kind": "function",
+          "name": "hasProgressChunk",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "createInitialProgress",
+          "declaration": {
+            "name": "createInitialProgress",
+            "module": "src/components/ai-chat/stream/progress.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "hasProgressChunk",
+          "declaration": {
+            "name": "hasProgressChunk",
+            "module": "src/components/ai-chat/stream/progress.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/registry.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "getAgentStreamDefinition",
+          "return": {
+            "type": {
+              "text": "AgentStreamDefinition"
+            }
+          },
+          "parameters": [
+            {
+              "name": "agent",
+              "type": {
+                "text": "AiPromptAgent"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "createStreamHandler",
+          "return": {
+            "type": {
+              "text": "StreamChunkProcessor"
+            }
+          },
+          "parameters": [
+            {
+              "name": "agent",
+              "type": {
+                "text": "AiPromptAgent"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "createInitialStreamState",
+          "return": {
+            "type": {
+              "text": "StreamHandlerContext['state']"
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getAgentStreamDefinition",
+          "declaration": {
+            "name": "getAgentStreamDefinition",
+            "module": "src/components/ai-chat/stream/registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createStreamHandler",
+          "declaration": {
+            "name": "createStreamHandler",
+            "module": "src/components/ai-chat/stream/registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createInitialStreamState",
+          "declaration": {
+            "name": "createInitialStreamState",
+            "module": "src/components/ai-chat/stream/registry.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/stream-processor.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "type"
+        },
+        {
+          "kind": "function",
+          "name": "processStreamChunk",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            },
+            {
+              "name": "ctx",
+              "type": {
+                "text": "StreamHandlerContext"
+              }
+            },
+            {
+              "name": "def",
+              "type": {
+                "text": "AgentStreamDefinition"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "processStreamChunk",
+          "declaration": {
+            "name": "processStreamChunk",
+            "module": "src/components/ai-chat/stream/stream-processor.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/transport.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "fetchStreamingResponse",
+          "return": {
+            "type": {
+              "text": "Promise<StreamingResponse>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "text": "StreamingRequestOptions"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "parseStreamLine",
+          "return": {
+            "type": {
+              "text": "Record<string, unknown> | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "line",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Parse one line from an aiprompt response stream.\nSupports plain NDJSON (`{\"type\":\"progress\",...}`) and SSE (`data: {...}`)."
+        },
+        {
+          "kind": "function",
+          "name": "readNdjsonStream",
+          "return": {
+            "type": {
+              "text": "Promise<void>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "body",
+              "type": {
+                "text": "ReadableStream<Uint8Array>"
+              }
+            },
+            {
+              "name": "onChunk",
+              "type": {
+                "text": "(chunk: Record<string, unknown>) => void"
+              }
+            }
+          ],
+          "description": "Read NDJSON or SSE (`data:`) chunks from a streaming aiprompt response body."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "fetchStreamingResponse",
+          "declaration": {
+            "name": "fetchStreamingResponse",
+            "module": "src/components/ai-chat/stream/transport.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseStreamLine",
+          "declaration": {
+            "name": "parseStreamLine",
+            "module": "src/components/ai-chat/stream/transport.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "readNdjsonStream",
+          "declaration": {
+            "name": "readNdjsonStream",
+            "module": "src/components/ai-chat/stream/transport.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/stream/types.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-interaction-textarea/ai-interaction-textarea.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "LuzmoAiInteractionTextarea",
+          "members": [
+            {
+              "kind": "field",
+              "name": "tagName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "default": "'luzmo-ai-interaction-textarea'"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Type your prompt here...'",
+              "description": "Placeholder text for the textarea",
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "field",
+              "name": "selectedDatasets",
+              "type": {
+                "text": "Dataset[]"
+              },
+              "default": "[]",
+              "description": "Array of selected datasets",
+              "attribute": "selectedDatasets"
+            },
+            {
+              "kind": "field",
+              "name": "authKey",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Auth key for DataBroker authentication",
+              "attribute": "auth-key"
+            },
+            {
+              "kind": "field",
+              "name": "authToken",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Auth token for DataBroker authentication",
+              "attribute": "auth-token"
+            },
+            {
+              "kind": "field",
+              "name": "apiUrl",
+              "type": {
+                "text": "string"
+              },
+              "default": "'https://api.luzmo.com'",
+              "description": "API URL for DataBroker",
+              "attribute": "api-url"
+            },
+            {
+              "kind": "field",
+              "name": "appServer",
+              "type": {
+                "text": "string"
+              },
+              "default": "'https://app.luzmo.com'",
+              "description": "The URL of the app server for thumbnails and assets",
+              "attribute": "app-server"
+            },
+            {
+              "kind": "field",
+              "name": "flagOpendata",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, restricts results to public datasets (opendata parity)",
+              "attribute": "flag-opendata"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, disables the entire component (opacity 60%, no interactions)",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "singleLine",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, starts in compact single-line mode and auto-expands as needed",
+              "attribute": "single-line"
+            },
+            {
+              "kind": "field",
+              "name": "hideDatasetButton",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, hides the \"+ Add dataset\" button",
+              "attribute": "hide-dataset-button"
+            },
+            {
+              "kind": "field",
+              "name": "hideDatasetIcons",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, hides dataset-specific icons in selector tags and @ mention dataset headers",
+              "attribute": "hide-dataset-icons"
+            },
+            {
+              "kind": "field",
+              "name": "disableDatasetModification",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, disables the \"+ Add dataset\" button and disables dataset pill removal",
+              "attribute": "disable-dataset-modification"
+            },
+            {
+              "kind": "field",
+              "name": "hideSelectedDatasets",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, hides the dataset row entirely",
+              "attribute": "hide-selected-datasets"
+            },
+            {
+              "kind": "field",
+              "name": "disableColumnMentions",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, disables @ trigger mentions completely",
+              "attribute": "disable-column-mentions"
+            },
+            {
+              "kind": "field",
+              "name": "isGenerating",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, shows a spinning loader icon instead of the submit arrow",
+              "attribute": "is-generating"
+            },
+            {
+              "kind": "field",
+              "name": "stoppable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, shows a stop control while `is-generating` is true",
+              "attribute": "stoppable",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
                 "text": "string"
               },
-              "description": "Border color when focused",
-              "name": "--luzmo-ai-interaction-textarea-focus-border-color",
+              "default": "''",
+              "description": "The current value of the textarea (can be controlled from parent to clear or set text)",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "retainOnSubmit",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, retains the input value after submitting a prompt (default: false)\nWhen false (default), clears the textarea value after submission",
+              "attribute": "retain-on-submit"
+            },
+            {
+              "kind": "field",
+              "name": "requireDataset",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "attribute": "require-dataset"
+            },
+            {
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, starts in compact single-line mode and auto-expands as needed",
+              "name": "single-line",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, hides the \"+ Add dataset\" button",
+              "name": "hide-dataset-button",
               "kind": "field"
             },
             {
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Box shadow when focused",
-              "name": "--luzmo-ai-interaction-textarea-focus-box-shadow",
+              "description": "When true, hides dataset-specific icons in selector tags and `@` mention dataset headers",
+              "name": "hide-dataset-icons",
               "kind": "field"
             },
             {
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Text color of the prompt input",
-              "name": "--luzmo-ai-interaction-textarea-textarea-color",
+              "description": "When true, disables the \"+ Add dataset\" button and disables dataset pill removal",
+              "name": "disable-dataset-modification",
               "kind": "field"
             },
             {
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Placeholder color of the prompt input",
-              "name": "--luzmo-ai-interaction-textarea-textarea-placeholder-color",
+              "description": "When true, hides the dataset row entirely",
+              "name": "hide-selected-datasets",
               "kind": "field"
             },
             {
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Size of the submit button",
-              "name": "--luzmo-ai-interaction-textarea-button-min-height",
+              "description": "When true, disables `@` trigger mentions completely",
+              "name": "disable-column-mentions",
               "kind": "field"
             },
             {
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Background color of the submit button",
-              "name": "--luzmo-ai-interaction-textarea-button-background-color",
+              "description": "When true, shows a spinning loader icon instead of the submit arrow",
+              "name": "is-generating",
               "kind": "field"
             },
             {
               "type": {
-                "text": "string"
+                "text": "boolean"
+              },
+              "description": "When true, retains the input value after submission (default: false, clears on submit)",
+              "name": "retain-on-submit",
+              "kind": "field"
+            },
+            {
+              "type": {
+                "text": "boolean"
               },
-              "description": "Text color of the submit button",
-              "name": "--luzmo-ai-interaction-textarea-button-color",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "name": "require-dataset",
               "kind": "field"
             },
             {
               "type": {
                 "text": "string"
               },
-              "description": "Text color of dataset header rows in @ mention options",
-              "name": "--luzmo-ai-interaction-textarea-trigger-option-header-color",
+              "description": "Opacity of the host when `disabled` (does not map to Lucero prompt-box tokens)",
+              "name": "--luzmo-ai-interaction-textarea-disabled-opacity",
               "kind": "field"
             }
           ],
@@ -1347,9 +2808,16 @@
             {
               "name": "prompt-submitted",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<PromptSubmittedEventDetail>"
               },
               "description": "Fired when a prompt is submitted with selected datasets"
+            },
+            {
+              "name": "prompt-stopped",
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when a running prompt is stopped"
             }
           ],
           "attributes": [
@@ -1458,7 +2926,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, hides the \"+ Add dataset\" button and disables dataset pill removal",
+              "description": "When true, disables the \"+ Add dataset\" button and disables dataset pill removal",
               "fieldName": "disableDatasetModification"
             },
             {
@@ -1488,6 +2956,15 @@
               "description": "When true, shows a spinning loader icon instead of the submit arrow",
               "fieldName": "isGenerating"
             },
+            {
+              "name": "stoppable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, shows a stop control while `is-generating` is true",
+              "fieldName": "stoppable"
+            },
             {
               "name": "value",
               "type": {
@@ -1505,6 +2982,15 @@
               "default": "false",
               "description": "When true, retains the input value after submitting a prompt (default: false)\nWhen false (default), clears the textarea value after submission",
               "fieldName": "retainOnSubmit"
+            },
+            {
+              "name": "require-dataset",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, at least one dataset must be selected before the prompt can be submitted",
+              "fieldName": "requireDataset"
             }
           ],
           "superclass": {
@@ -1513,7 +2999,7 @@
           },
           "tagName": "luzmo-ai-interaction-textarea",
           "customElement": true,
-          "summary": "A textarea component for AI interaction with dataset selection"
+          "summary": "A textarea for AI interaction with dataset selection. Uses Lucero `luzmo-prompt-box` for visuals; theme it with `--luzmo-prompt-box-*` on this host or an ancestor."
         }
       ],
       "exports": [
@@ -1527,6 +3013,12 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-interaction-textarea/types.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/data-field/data-field.ts",
@@ -1586,14 +3078,14 @@
           "events": [
             {
               "type": {
-                "text": "CustomEvent<{data: DatasetDataField}>"
+                "text": "CustomEvent<DataFieldDroppedEventDetail>"
               },
               "description": "Announces that the data field has been dropped",
               "name": "luzmo-data-field-dropped"
             },
             {
               "type": {
-                "text": "CustomEvent<{data: DatasetDataField}>"
+                "text": "CustomEvent<DataFieldDragStartedEventDetail>"
               },
               "description": "Announces that the drag is started on the data field",
               "name": "luzmo-data-field-drag-started"
@@ -1746,14 +3238,14 @@
           "events": [
             {
               "type": {
-                "text": "CustomEvent<{data: DatasetDataField}>"
+                "text": "CustomEvent<DataFieldDroppedEventDetail>"
               },
               "description": "Announces that the data field has been dropped",
               "name": "luzmo-data-field-dropped"
             },
             {
               "type": {
-                "text": "CustomEvent<{data: DatasetDataField}>"
+                "text": "CustomEvent<DataFieldDragStartedEventDetail>"
               },
               "description": "Announces that the drag is started on the data field",
               "name": "luzmo-data-field-drag-started"
@@ -2093,15 +3585,21 @@
             {
               "name": "luzmo-dataset-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DatasetChangedEventDetail>"
               },
               "description": "Announces that the selected dataset has changed"
             },
             {
+              "type": {
+                "text": "CustomEvent<DataFieldDroppedEventDetail>"
+              },
               "description": "Announces that a data field has been dropped",
               "name": "luzmo-data-field-dropped"
             },
             {
+              "type": {
+                "text": "CustomEvent<DataFieldDragStartedEventDetail>"
+              },
               "description": "Announces that a drag has started on a data field",
               "name": "luzmo-data-field-drag-started"
             }
@@ -2475,9 +3973,9 @@
             {
               "name": "luzmo-data-fields-selected",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DataFieldsSelectedEventDetail>"
               },
-              "description": "Emitted when data fields are selected. Event detail contains `{ dataFields: DatasetDataField[] }`"
+              "description": "Emitted when data fields are selected"
             }
           ],
           "attributes": [
@@ -2671,6 +4169,12 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/data-fields-select/types.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/dataset-icon/dataset-icon.ts",
@@ -3039,7 +4543,7 @@
             {
               "name": "dataset-selected",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<Dataset>"
               },
               "description": "Fired when a dataset is selected"
             }
@@ -3238,7 +4742,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, disables all interactions: hides the add button, removes dataset pill delete buttons, and makes tags non-interactive",
+              "description": "When true, disables all interactions: disables the add button, removes dataset pill delete buttons, and makes tags non-interactive",
               "attribute": "disabled",
               "reflects": true
             },
@@ -3312,39 +4816,23 @@
               "type": {
                 "text": "string"
               },
-              "description": "Maximum height of the dataset search dropdown menu (Lucero `--luzmo-popover-max-height`)",
+              "description": "Optional scoped max height for this row’s search dropdown; falls back to inherited `--luzmo-popover-max-height`, then `400px`",
               "name": "--luzmo-dataset-selector-row-search-popover-max-height",
               "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Maximum width of each selected dataset tag",
-              "name": "--luzmo-dataset-selector-row-tag-max-width",
-              "kind": "field"
-            },
-            {
-              "type": {
-                "text": "string"
-              },
-              "description": "Height of selected dataset tags",
-              "name": "--luzmo-dataset-selector-row-tag-height",
-              "kind": "field"
             }
           ],
           "events": [
             {
               "name": "dataset-selected",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<Dataset>"
               },
               "description": "Fired when a dataset is selected"
             },
             {
               "name": "dataset-removed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<Dataset>"
               },
               "description": "Fired when a dataset is removed"
             }
@@ -3415,7 +4903,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, disables all interactions: hides the add button, removes dataset pill delete buttons, and makes tags non-interactive",
+              "description": "When true, disables all interactions: disables the add button, removes dataset pill delete buttons, and makes tags non-interactive",
               "fieldName": "disabled"
             },
             {
@@ -3434,7 +4922,7 @@
           },
           "tagName": "luzmo-dataset-selector-row",
           "customElement": true,
-          "summary": "A row component for selecting and managing datasets with pills and overlay"
+          "summary": "A row component for selecting and managing datasets with pills and overlay. Theme Lucero primitives (`luzmo-select`, options, popover, tags) with `--luzmo-select-*`, `--luzmo-popover-max-height`, `--luzmo-option-*`, `--luzmo-tag-*` on this host or an ancestor; optional `--luzmo-dataset-selector-row-*` overrides ACK row shell defaults (gap, typography, search max width, scoped popover height)."
         }
       ],
       "exports": [
@@ -3582,21 +5070,21 @@
             {
               "name": "luzmo-slot-content-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DisplaySettingsSlotContentChangedEventDetail>"
               },
               "description": "Event that is fired when the slot content is changed"
             },
             {
               "name": "luzmo-remove-slot-content",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DisplaySettingsRemoveSlotContentEventDetail>"
               },
               "description": "Event that is fired when the remove button is clicked"
             },
             {
               "name": "luzmo-info-visibility-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<InfoVisibilityChangedEventDetail>"
               },
               "description": "Event that is fired when the info button is clicked, includes the visibility state and ID values"
             }
@@ -3766,7 +5254,7 @@
             {
               "name": "luzmo-slot-content-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DisplaySettingsSlotContentChangedEventDetail>"
               },
               "description": "Event that is fired when the slot content is changed"
             }
@@ -3855,6 +5343,9 @@
           ],
           "events": [
             {
+              "type": {
+                "text": "CustomEvent<DisplaySettingsSlotContentChangedEventDetail>"
+              },
               "description": "Event that is fired when the slot content is changed",
               "name": "luzmo-slot-content-changed"
             }
@@ -3944,7 +5435,7 @@
             {
               "name": "luzmo-slot-content-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DisplaySettingsSlotContentChangedEventDetail>"
               },
               "description": "Event that is fired when the slot content is changed"
             }
@@ -4043,6 +5534,9 @@
           ],
           "events": [
             {
+              "type": {
+                "text": "CustomEvent<DisplaySettingsSlotContentChangedEventDetail>"
+              },
               "description": "Event that is fired when the slot content is changed",
               "name": "luzmo-slot-content-changed"
             }
@@ -4246,7 +5740,7 @@
             {
               "name": "luzmo-slot-content-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DisplaySettingsSlotContentChangedEventDetail>"
               },
               "description": "Event that is fired when the slot content is changed"
             }
@@ -5272,16 +6766,179 @@
               ]
             },
             {
-              "kind": "method",
-              "name": "setQuantity",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "CustomEvent"
-                  }
-                }
-              ]
+              "kind": "method",
+              "name": "setQuantity",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "CustomEvent"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "name": "luzmo-filter-value-changed",
+              "type": {
+                "text": "CustomEvent"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "content-language",
+              "type": {
+                "text": "string"
+              },
+              "default": "'en'",
+              "description": "The language to use for locale-aware formatting and column/formula labels",
+              "fieldName": "contentLanguage"
+            },
+            {
+              "name": "time-zone",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The time zone to use for the date picker",
+              "fieldName": "timeZone"
+            },
+            {
+              "name": "filter",
+              "type": {
+                "text": "any | undefined"
+              },
+              "description": "The filter used to retrieve the value",
+              "fieldName": "filter"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "'s' | 'm' | 'l' | 'xl'"
+              },
+              "default": "m",
+              "description": "The size of the element",
+              "fieldName": "size"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disable this control. It will not receive focus or events",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "autofocus",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When this control is rendered, focus it automatically",
+              "fieldName": "autofocus"
+            },
+            {
+              "name": "tabIndex",
+              "type": {
+                "text": "number"
+              },
+              "description": "The tab index to apply to this control. See general documentation about the tabindex HTML property",
+              "fieldName": "tabIndex"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "LocalizedMixin",
+              "package": "@utils/base/localized-mixin"
+            }
+          ],
+          "tagName": "luzmo-filter-value-picker-datetime",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LuzmoFilterValuePickerDatetime",
+          "declaration": {
+            "name": "LuzmoFilterValuePickerDatetime",
+            "module": "src/components/filter-value-picker-datetime/filter-value-picker-datetime.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/filter-value-picker-hierarchy/filter-value-picker-hierarchy.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "LuzmoFilterValuePickerHierarchy",
+          "members": [
+            {
+              "kind": "field",
+              "name": "apiUrl",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The API URL of the databroker",
+              "default": "https://api.luzmo.com",
+              "attribute": "api-url",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "authKey",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The auth key of the databroker",
+              "attribute": "auth-key",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "authToken",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The auth token of the databroker",
+              "attribute": "auth-token",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "cacheTime",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "The cache time of the databroker",
+              "default": "30000",
+              "attribute": "cache-time",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "contentLanguage",
+              "type": {
+                "text": "string"
+              },
+              "default": "'en'",
+              "description": "The language to use for locale-aware formatting and labels",
+              "attribute": "content-language",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "filter",
+              "type": {
+                "text": "any | undefined"
+              },
+              "description": "The filter used to retrieve the value",
+              "attribute": "filter"
             }
           ],
           "events": [
@@ -5294,21 +6951,47 @@
           ],
           "attributes": [
             {
-              "name": "content-language",
+              "name": "api-url",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
-              "default": "'en'",
-              "description": "The language to use for locale-aware formatting and column/formula labels",
-              "fieldName": "contentLanguage"
+              "description": "The API URL of the databroker",
+              "default": "https://api.luzmo.com",
+              "fieldName": "apiUrl"
             },
             {
-              "name": "time-zone",
+              "name": "auth-key",
               "type": {
                 "text": "string | undefined"
               },
-              "description": "The time zone to use for the date picker",
-              "fieldName": "timeZone"
+              "description": "The auth key of the databroker",
+              "fieldName": "authKey"
+            },
+            {
+              "name": "auth-token",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The auth token of the databroker",
+              "fieldName": "authToken"
+            },
+            {
+              "name": "cache-time",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "The cache time of the databroker",
+              "default": "30000",
+              "fieldName": "cacheTime"
+            },
+            {
+              "name": "content-language",
+              "type": {
+                "text": "string"
+              },
+              "default": "'en'",
+              "description": "The language to use for locale-aware formatting and labels",
+              "fieldName": "contentLanguage"
             },
             {
               "name": "filter",
@@ -5357,32 +7040,42 @@
           "mixins": [
             {
               "name": "LocalizedMixin",
-              "package": "@utils/base/localized-mixin"
+              "module": "/src/utils/base/localized-mixin"
             }
           ],
-          "tagName": "luzmo-filter-value-picker-datetime",
+          "tagName": "luzmo-filter-value-picker-hierarchy",
           "customElement": true
+        },
+        {
+          "kind": "variable",
+          "name": "abortController",
+          "default": "new AbortController()"
+        },
+        {
+          "kind": "variable",
+          "name": "promise",
+          "default": "new Promise((resolve, reject) => { const fetchDataPromise = dataBroker.fetchData(query); fetchDataPromise.then(resolve).catch(reject); abortController.signal.addEventListener('abort', () => { console.warn('Request aborted'); reject({ status: 'aborted' }); }); })"
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "LuzmoFilterValuePickerDatetime",
+          "name": "LuzmoFilterValuePickerHierarchy",
           "declaration": {
-            "name": "LuzmoFilterValuePickerDatetime",
-            "module": "src/components/filter-value-picker-datetime/filter-value-picker-datetime.ts"
+            "name": "LuzmoFilterValuePickerHierarchy",
+            "module": "src/components/filter-value-picker-hierarchy/filter-value-picker-hierarchy.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/filter-value-picker-hierarchy/filter-value-picker-hierarchy.ts",
+      "path": "src/components/filter-value-picker-numeric/filter-value-picker-numeric.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "LuzmoFilterValuePickerHierarchy",
+          "name": "LuzmoFilterValuePickerNumeric",
           "members": [
             {
               "kind": "field",
@@ -5546,10 +7239,10 @@
           "mixins": [
             {
               "name": "LocalizedMixin",
-              "module": "/src/utils/base/localized-mixin"
+              "package": "@utils/base/localized-mixin"
             }
           ],
-          "tagName": "luzmo-filter-value-picker-hierarchy",
+          "tagName": "luzmo-filter-value-picker-numeric",
           "customElement": true
         },
         {
@@ -5566,22 +7259,22 @@
       "exports": [
         {
           "kind": "js",
-          "name": "LuzmoFilterValuePickerHierarchy",
+          "name": "LuzmoFilterValuePickerNumeric",
           "declaration": {
-            "name": "LuzmoFilterValuePickerHierarchy",
-            "module": "src/components/filter-value-picker-hierarchy/filter-value-picker-hierarchy.ts"
+            "name": "LuzmoFilterValuePickerNumeric",
+            "module": "src/components/filter-value-picker-numeric/filter-value-picker-numeric.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/filter-value-picker-numeric/filter-value-picker-numeric.ts",
+      "path": "src/components/filters/filters.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "LuzmoFilterValuePickerNumeric",
+          "name": "LuzmoFilters",
           "members": [
             {
               "kind": "field",
@@ -5589,8 +7282,8 @@
               "type": {
                 "text": "string | undefined"
               },
+              "default": "'https://api.luzmo.com'",
               "description": "The API URL of the databroker",
-              "default": "https://api.luzmo.com",
               "attribute": "api-url",
               "reflects": true
             },
@@ -5621,7 +7314,6 @@
                 "text": "number | undefined"
               },
               "description": "The cache time of the databroker",
-              "default": "30000",
               "attribute": "cache-time",
               "reflects": true
             },
@@ -5638,20 +7330,53 @@
             },
             {
               "kind": "field",
-              "name": "filter",
+              "name": "timeZone",
               "type": {
-                "text": "any | undefined"
+                "text": "string | undefined"
               },
-              "description": "The filter used to retrieve the value",
-              "attribute": "filter"
+              "description": "The time zone to use for the date picker",
+              "attribute": "time-zone",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "datasetIds",
+              "type": {
+                "text": "string[] | undefined"
+              },
+              "description": "The dataset ids to fetch columns & formulas",
+              "attribute": "dataset-ids",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "filters",
+              "type": {
+                "text": "ItemFilterGroup[]"
+              },
+              "default": "[]",
+              "description": "The filter groups to display",
+              "attribute": "filters"
+            },
+            {
+              "kind": "field",
+              "name": "debounce",
+              "type": {
+                "text": "number"
+              },
+              "default": "300",
+              "description": "Debounce time in milliseconds for the filters-changed event",
+              "attribute": "debounce",
+              "reflects": true
             }
           ],
           "events": [
             {
-              "name": "luzmo-filter-value-changed",
+              "name": "luzmo-filters-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<FiltersChangedEventDetail>"
+              },
+              "description": "Announces that the filters have changed"
             }
           ],
           "attributes": [
@@ -5660,8 +7385,8 @@
               "type": {
                 "text": "string | undefined"
               },
+              "default": "'https://api.luzmo.com'",
               "description": "The API URL of the databroker",
-              "default": "https://api.luzmo.com",
               "fieldName": "apiUrl"
             },
             {
@@ -5686,7 +7411,6 @@
                 "text": "number | undefined"
               },
               "description": "The cache time of the databroker",
-              "default": "30000",
               "fieldName": "cacheTime"
             },
             {
@@ -5699,12 +7423,38 @@
               "fieldName": "contentLanguage"
             },
             {
-              "name": "filter",
+              "name": "time-zone",
               "type": {
-                "text": "any | undefined"
+                "text": "string | undefined"
               },
-              "description": "The filter used to retrieve the value",
-              "fieldName": "filter"
+              "description": "The time zone to use for the date picker",
+              "fieldName": "timeZone"
+            },
+            {
+              "name": "dataset-ids",
+              "type": {
+                "text": "string[] | undefined"
+              },
+              "description": "The dataset ids to fetch columns & formulas",
+              "fieldName": "datasetIds"
+            },
+            {
+              "name": "filters",
+              "type": {
+                "text": "ItemFilterGroup[]"
+              },
+              "default": "[]",
+              "description": "The filter groups to display",
+              "fieldName": "filters"
+            },
+            {
+              "name": "debounce",
+              "type": {
+                "text": "number"
+              },
+              "default": "300",
+              "description": "Debounce time in milliseconds for the filters-changed event",
+              "fieldName": "debounce"
             },
             {
               "name": "size",
@@ -5734,363 +7484,441 @@
               "fieldName": "autofocus"
             },
             {
-              "name": "tabIndex",
+              "name": "tabIndex",
+              "type": {
+                "text": "number"
+              },
+              "description": "The tab index to apply to this control. See general documentation about the tabindex HTML property",
+              "fieldName": "tabIndex"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "LocalizedMixin",
+              "module": "/src/utils/base/localized-mixin"
+            }
+          ],
+          "tagName": "luzmo-filters",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LuzmoFilters",
+          "declaration": {
+            "name": "LuzmoFilters",
+            "module": "src/components/filters/filters.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/filters/types.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/filters/transformations/transform-filters.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "transformFilters",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "filters",
+              "type": {
+                "text": "EditFilterGroup | null | undefined"
+              },
+              "description": "Filter group in the internal/legacy filters format"
+            }
+          ],
+          "description": "Transform EditFilterGroup from filters component into the format\nexpected by luzmo-embed-viz-item (ItemFilterGroup[])."
+        },
+        {
+          "kind": "function",
+          "name": "reverseTransformFilters",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "filters",
               "type": {
-                "text": "number"
+                "text": "ItemFilterGroup[] | null | undefined"
               },
-              "description": "The tab index to apply to this control. See general documentation about the tabindex HTML property",
-              "fieldName": "tabIndex"
-            }
-          ],
-          "mixins": [
-            {
-              "name": "LocalizedMixin",
-              "package": "@utils/base/localized-mixin"
+              "description": "Filter groups from viz-item filters property or getFilters()"
             }
           ],
-          "tagName": "luzmo-filter-value-picker-numeric",
-          "customElement": true
-        },
-        {
-          "kind": "variable",
-          "name": "abortController",
-          "default": "new AbortController()"
-        },
-        {
-          "kind": "variable",
-          "name": "promise",
-          "default": "new Promise((resolve, reject) => { const fetchDataPromise = dataBroker.fetchData(query); fetchDataPromise.then(resolve).catch(reject); abortController.signal.addEventListener('abort', () => { console.warn('Request aborted'); reject({ status: 'aborted' }); }); })"
+          "description": "Transform filter groups from luzmo-embed-viz-item format into the format\nused internally by luzmo-filters."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "LuzmoFilterValuePickerNumeric",
+          "name": "VizItemFilterGroup",
           "declaration": {
-            "name": "LuzmoFilterValuePickerNumeric",
-            "module": "src/components/filter-value-picker-numeric/filter-value-picker-numeric.ts"
+            "name": "ItemFilterGroup",
+            "package": "@luzmo/dashboard-contents-types"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "transformFilters",
+          "declaration": {
+            "name": "transformFilters",
+            "module": "src/components/filters/transformations/transform-filters.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "reverseTransformFilters",
+          "declaration": {
+            "name": "reverseTransformFilters",
+            "module": "src/components/filters/transformations/transform-filters.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/filters/filters.ts",
+      "path": "src/components/formula/formula.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "LuzmoFilters",
+          "name": "LuzmoFormula",
           "members": [
             {
               "kind": "field",
-              "name": "apiUrl",
-              "type": {
-                "text": "string | undefined"
-              },
-              "default": "'https://api.luzmo.com'",
-              "description": "The API URL of the databroker",
-              "attribute": "api-url",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "authKey",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "The auth key of the databroker",
-              "attribute": "auth-key",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "authToken",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "The auth token of the databroker",
-              "attribute": "auth-token",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "cacheTime",
-              "type": {
-                "text": "number | undefined"
-              },
-              "description": "The cache time of the databroker",
-              "attribute": "cache-time",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "contentLanguage",
-              "type": {
-                "text": "string"
-              },
-              "default": "'en'",
-              "description": "The language to use for locale-aware formatting and labels",
-              "attribute": "content-language",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "timeZone",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "The time zone to use for the date picker",
-              "attribute": "time-zone",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "datasetIds",
-              "type": {
-                "text": "string[] | undefined"
-              },
-              "description": "The dataset ids to fetch columns & formulas",
-              "attribute": "dataset-ids",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "filters",
-              "type": {
-                "text": "ItemFilterGroup[]"
-              },
-              "default": "[]",
-              "description": "The filter groups to display",
-              "attribute": "filters"
-            },
-            {
-              "kind": "field",
-              "name": "debounce",
+              "name": "display",
               "type": {
-                "text": "number"
+                "text": "'rich' | 'text'"
               },
-              "default": "300",
-              "description": "Debounce time in milliseconds for the filters-changed event",
-              "attribute": "debounce",
+              "default": "'rich'",
+              "description": "Rendering mode. `rich` (default) renders read-only column / aggregation\npills; `text` renders plain text with an inline type icon per column. Both\nare always read-only.",
+              "attribute": "display",
               "reflects": true
             }
           ],
           "events": [
             {
-              "name": "luzmo-filters-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DatasetsErrorEventDetail>"
               },
-              "description": "Announces that the filters have changed"
+              "description": "Fired when fetching datasets by id fails.",
+              "name": "luzmo-datasets-error"
             }
           ],
           "attributes": [
             {
-              "name": "api-url",
-              "type": {
-                "text": "string | undefined"
-              },
-              "default": "'https://api.luzmo.com'",
-              "description": "The API URL of the databroker",
-              "fieldName": "apiUrl"
-            },
-            {
-              "name": "auth-key",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "The auth key of the databroker",
-              "fieldName": "authKey"
-            },
-            {
-              "name": "auth-token",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "The auth token of the databroker",
-              "fieldName": "authToken"
-            },
-            {
-              "name": "cache-time",
+              "name": "display",
               "type": {
-                "text": "number | undefined"
+                "text": "'rich' | 'text'"
               },
-              "description": "The cache time of the databroker",
-              "fieldName": "cacheTime"
-            },
+              "default": "'rich'",
+              "description": "Rendering mode. `rich` (default) renders read-only column / aggregation\npills; `text` renders plain text with an inline type icon per column. Both\nare always read-only.",
+              "fieldName": "display"
+            }
+          ],
+          "superclass": {
+            "name": "LuzmoFormulaBase",
+            "package": "@utils/formula/base/formula-base"
+          },
+          "tagName": "luzmo-formula",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LuzmoFormula",
+          "declaration": {
+            "name": "LuzmoFormula",
+            "module": "src/components/formula/formula.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-editor/formula-aggregations-list.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderAggregationsList",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
             {
-              "name": "content-language",
+              "name": "params",
               "type": {
-                "text": "string"
-              },
-              "default": "'en'",
-              "description": "The language to use for locale-aware formatting and labels",
-              "fieldName": "contentLanguage"
-            },
+                "text": "AggregationsListParams"
+              }
+            }
+          ],
+          "description": "Renders the aggregation-functions list (draggable / insertable pills) inside\nthe formula editor. Replaces the former `luzmo-formula-aggregations-list`\nelement: stateless markup driven entirely by the editor."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderAggregationsList",
+          "declaration": {
+            "name": "renderAggregationsList",
+            "module": "src/components/formula-editor/formula-aggregations-list.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-editor/formula-datasets-list.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderDatasetsList",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
             {
-              "name": "time-zone",
+              "name": "params",
               "type": {
-                "text": "string | undefined"
-              },
-              "description": "The time zone to use for the date picker",
-              "fieldName": "timeZone"
-            },
+                "text": "DatasetsListParams"
+              }
+            }
+          ],
+          "description": "Renders the datasets list (searchable, grouped, draggable columns) inside the\nformula editor. Replaces the former `luzmo-formula-datasets-list` element; the\nsearch query and collapsed groups live on the editor and are passed back in."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderDatasetsList",
+          "declaration": {
+            "name": "renderDatasetsList",
+            "module": "src/components/formula-editor/formula-datasets-list.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-editor/formula-description.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderDescription",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
             {
-              "name": "dataset-ids",
+              "name": "{ target, size }",
               "type": {
-                "text": "string[] | undefined"
+                "text": "DescriptionParams"
+              }
+            }
+          ],
+          "description": "Renders the description region (label, description and example for the hovered\n/ selected function, aggregation or grouping) inside the formula editor.\nReplaces the former `luzmo-formula-description` element."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderDescription",
+          "declaration": {
+            "name": "renderDescription",
+            "module": "src/components/formula-editor/formula-description.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-editor/formula-editor.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "LuzmoFormulaEditor",
+          "members": [
+            {
+              "kind": "field",
+              "name": "expressionResource",
+              "type": {
+                "text": "'column' | 'formula'"
               },
-              "description": "The dataset ids to fetch columns & formulas",
-              "fieldName": "datasetIds"
+              "default": "'formula'",
+              "description": "Whether the expression is validated as a column or a formula.",
+              "attribute": "expression-resource",
+              "reflects": true
             },
             {
-              "name": "filters",
+              "kind": "field",
+              "name": "explanationDisplay",
               "type": {
-                "text": "ItemFilterGroup[]"
+                "text": "'tooltip' | 'description'"
               },
-              "default": "[]",
-              "description": "The filter groups to display",
-              "fieldName": "filters"
-            },
+              "default": "'tooltip'",
+              "description": "How function / aggregation explanations are surfaced: as hover `tooltip`s on\nthe list items (default), or in a dedicated `description` region. With\n`tooltip` there is no description, so the remaining lists spread across\nthe full width.",
+              "attribute": "explanation-display",
+              "reflects": true
+            }
+          ],
+          "events": [
             {
-              "name": "debounce",
+              "name": "luzmo-validity-changed",
               "type": {
-                "text": "number"
+                "text": "CustomEvent<ValidityChangedEventDetail>"
               },
-              "default": "300",
-              "description": "Debounce time in milliseconds for the filters-changed event",
-              "fieldName": "debounce"
+              "description": "Fired when expression validity changes."
             },
             {
-              "name": "size",
               "type": {
-                "text": "'s' | 'm' | 'l' | 'xl'"
+                "text": "CustomEvent<ExpressionChangedEventDetail>"
               },
-              "default": "m",
-              "description": "The size of the element",
-              "fieldName": "size"
+              "description": "Fired (debounced) when the expression changes.",
+              "name": "luzmo-expression-changed"
             },
             {
-              "name": "disabled",
               "type": {
-                "text": "boolean"
+                "text": "CustomEvent<DatasetsErrorEventDetail>"
               },
-              "default": "false",
-              "description": "Disable this control. It will not receive focus or events",
-              "fieldName": "disabled"
-            },
+              "description": "Fired when fetching datasets by id fails.",
+              "name": "luzmo-datasets-error"
+            }
+          ],
+          "attributes": [
             {
-              "name": "autofocus",
+              "name": "expression-resource",
               "type": {
-                "text": "boolean"
+                "text": "'column' | 'formula'"
               },
-              "default": "false",
-              "description": "When this control is rendered, focus it automatically",
-              "fieldName": "autofocus"
+              "default": "'formula'",
+              "description": "Whether the expression is validated as a column or a formula.",
+              "fieldName": "expressionResource"
             },
             {
-              "name": "tabIndex",
+              "name": "explanation-display",
               "type": {
-                "text": "number"
+                "text": "'tooltip' | 'description'"
               },
-              "description": "The tab index to apply to this control. See general documentation about the tabindex HTML property",
-              "fieldName": "tabIndex"
-            }
-          ],
-          "mixins": [
-            {
-              "name": "LocalizedMixin",
-              "module": "/src/utils/base/localized-mixin"
+              "default": "'tooltip'",
+              "description": "How function / aggregation explanations are surfaced: as hover `tooltip`s on\nthe list items (default), or in a dedicated `description` region. With\n`tooltip` there is no description, so the remaining lists spread across\nthe full width.",
+              "fieldName": "explanationDisplay"
             }
           ],
-          "tagName": "luzmo-filters",
+          "superclass": {
+            "name": "LuzmoFormulaInputBase",
+            "package": "@utils/formula/base/formula-input-base"
+          },
+          "tagName": "luzmo-formula-editor",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "LuzmoFilters",
+          "name": "LuzmoFormulaEditor",
           "declaration": {
-            "name": "LuzmoFilters",
-            "module": "src/components/filters/filters.ts"
+            "name": "LuzmoFormulaEditor",
+            "module": "src/components/formula-editor/formula-editor.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/filters/types.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/filters/transformations/transform-filters.ts",
+      "path": "src/components/formula-editor/formula-functions-list.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "transformFilters",
+          "name": "renderFunctionsList",
           "return": {
             "type": {
-              "text": ""
+              "text": "TemplateResult"
             }
           },
           "parameters": [
             {
-              "name": "filters",
+              "name": "params",
               "type": {
-                "text": "EditFilterGroup | null | undefined"
-              },
-              "description": "Filter group in the internal/legacy filters format"
+                "text": "FunctionsListParams"
+              }
             }
           ],
-          "description": "Transform EditFilterGroup from filters component into the format\nexpected by luzmo-embed-viz-item (ItemFilterGroup[])."
-        },
+          "description": "Renders the functions list (category selector + draggable / insertable\nfunctions) inside the formula editor. Replaces the former\n`luzmo-formula-functions-list` element; the selected category lives on the\neditor and is passed back in."
+        }
+      ],
+      "exports": [
         {
-          "kind": "function",
-          "name": "reverseTransformFilters",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
+          "kind": "js",
+          "name": "renderFunctionsList",
+          "declaration": {
+            "name": "renderFunctionsList",
+            "module": "src/components/formula-editor/formula-functions-list.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/formula-field/formula-field.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "LuzmoFormulaField",
+          "members": [],
+          "events": [
             {
-              "name": "filters",
               "type": {
-                "text": "ItemFilterGroup[] | null | undefined"
+                "text": "CustomEvent<ExpressionChangedEventDetail>"
               },
-              "description": "Filter groups from viz-item filters property or getFilters()"
+              "description": "Fired (debounced) when the expression changes (only when not readonly).",
+              "name": "luzmo-expression-changed"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<DatasetsErrorEventDetail>"
+              },
+              "description": "Fired when fetching datasets by id fails.",
+              "name": "luzmo-datasets-error"
             }
           ],
-          "description": "Transform filter groups from luzmo-embed-viz-item format into the format\nused internally by luzmo-filters."
+          "superclass": {
+            "name": "LuzmoFormulaInputBase",
+            "package": "@utils/formula/base/formula-input-base"
+          },
+          "tagName": "luzmo-formula-field",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "VizItemFilterGroup",
-          "declaration": {
-            "name": "ItemFilterGroup",
-            "package": "@luzmo/dashboard-contents-types"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "transformFilters",
-          "declaration": {
-            "name": "transformFilters",
-            "module": "src/components/filters/transformations/transform-filters.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "reverseTransformFilters",
+          "name": "LuzmoFormulaField",
           "declaration": {
-            "name": "reverseTransformFilters",
-            "module": "src/components/filters/transformations/transform-filters.ts"
+            "name": "LuzmoFormulaField",
+            "module": "src/components/formula-field/formula-field.ts"
           }
         }
       ]
@@ -6367,6 +8195,17 @@
               "attribute": "view-mode",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "itemActionsDocumentPopover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "When true (default), the item actions menu uses the Document Popover API (`popover=\"manual\"`),\nwhich paints in the top layer. Set to false when embedding the grid next to another UI that\nalso uses a document popover (e.g. an analyst side pane) so the actions menu stays in normal\nstacking with `position: fixed` + Floating UI instead.",
+              "attribute": "item-actions-document-popover",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "placementItemActionsMenu",
@@ -6459,18 +8298,30 @@
           ],
           "events": [
             {
+              "type": {
+                "text": "CustomEvent<GridItemActionEventDetail>"
+              },
               "description": "Fired when an item action is performed",
               "name": "luzmo-item-grid-item-action"
             },
             {
+              "type": {
+                "text": "CustomEvent<GridLifecycleEventDetail>"
+              },
               "description": "Fired when the grid layout is changed",
               "name": "luzmo-item-grid-layout-changed"
             },
             {
+              "type": {
+                "text": "CustomEvent<GridLifecycleEventDetail>"
+              },
               "description": "Fired when the grid is ready",
               "name": "luzmo-item-grid-ready"
             },
             {
+              "type": {
+                "text": "CustomEvent<GridItemStatesChangedEventDetail>"
+              },
               "description": "Fired when item states change (controlled and uncontrolled mode)",
               "name": "luzmo-item-grid-item-states-changed"
             }
@@ -6564,6 +8415,15 @@
               "description": "Whether the grid is in view mode. When true, dragging, resizing and action buttons are disabled.",
               "fieldName": "viewMode"
             },
+            {
+              "name": "item-actions-document-popover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "When true (default), the item actions menu uses the Document Popover API (`popover=\"manual\"`),\nwhich paints in the top layer. Set to false when embedding the grid next to another UI that\nalso uses a document popover (e.g. an analyst side pane) so the actions menu stays in normal\nstacking with `position: fixed` + Floating UI instead.",
+              "fieldName": "itemActionsDocumentPopover"
+            },
             {
               "name": "placement-item-actions-menu",
               "type": {
@@ -7178,7 +9038,7 @@
           },
           "parameters": [
             {
-              "name": "{\n  element,\n  activeActions,\n  getGridItemById,\n  placementItemActionsMenu,\n  renderOverlayContent,\n  removeItemActionsMenuPopover\n}",
+              "name": "{\n  element,\n  activeActions,\n  getGridItemById,\n  placementItemActionsMenu,\n  renderOverlayContent,\n  removeItemActionsMenuPopover,\n  itemActionsDocumentPopover = true\n}",
               "type": {
                 "text": "CreateItemActionsMenuPopoverArgs"
               }
@@ -7593,7 +9453,7 @@
           },
           "parameters": [
             {
-              "name": "{\n  item,\n  activeActions,\n  defaultItemActionsMenu,\n  placementItemActionsMenu,\n  language,\n  handleAction\n}",
+              "name": "{\n  item,\n  activeActions,\n  defaultItemActionsMenu,\n  placementItemActionsMenu,\n  language,\n  handleAction,\n  itemActionsDocumentPopover = true\n}",
               "type": {
                 "text": "RenderOverlayContentArgs"
               }
@@ -8238,6 +10098,15 @@
               "name": "changedOptions"
             }
           ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent<ItemOptionsChangedEventDetail>"
+              },
+              "description": "Announces that the `options` of the element have changed",
+              "name": "luzmo-options-changed"
+            }
+          ],
           "attributes": [
             {
               "name": "language",
@@ -8351,6 +10220,12 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/item-option/types.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/item-option/helpers/control-markup.ts",
@@ -8988,8 +10863,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -9063,8 +10939,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -9218,9 +11095,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
               },
-              "description": "Emitted when the color is changed."
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -9321,9 +11198,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
               },
-              "description": "Emitted when the color range is changed."
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -9490,8 +11367,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -9607,8 +11485,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -9842,6 +11721,9 @@
           ],
           "events": [
             {
+              "type": {
+                "text": "CustomEvent<ItemOptionsChangedEventDetail>"
+              },
               "description": "Announces that the `options` of the element have changed",
               "name": "luzmo-options-changed"
             }
@@ -9973,8 +11855,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -10063,8 +11946,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -10159,8 +12043,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -10265,8 +12150,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -10408,8 +12294,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -10525,8 +12412,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -10607,8 +12495,9 @@
             {
               "name": "luzmo-option-changed",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<ItemOptionChangedEventDetail>"
+              },
+              "description": "Emitted when the option value changes."
             }
           ],
           "attributes": [
@@ -10842,14 +12731,16 @@
             {
               "name": "luzmo-slot-menu-active",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<SlotMenuActiveEventDetail>"
+              },
+              "description": "Emitted when the slot menu overlay opens for a slot"
             },
             {
               "name": "luzmo-slot-menu-highlight",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<SlotMenuHighlightEventDetail>"
+              },
+              "description": "Emitted to highlight the active column or formula in the slot menu"
             },
             {
               "name": "luzmo-info-visibility-changed",
@@ -11243,11 +13134,14 @@
             {
               "name": "luzmo-slot-constraint-triggered",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<SlotConstraintTriggeredEventDetail>"
               },
               "description": "Emitted when constraint-mode is 'event-only' and a change would trigger constraints"
             },
             {
+              "type": {
+                "text": "CustomEvent<SlotsContentsChangedEventDetail>"
+              },
               "description": "Announces that the slots contents have changed",
               "name": "luzmo-slots-contents-changed"
             }
@@ -11665,6 +13559,9 @@
           ],
           "events": [
             {
+              "type": {
+                "text": "CustomEvent<SlotContentsChangedEventDetail>"
+              },
               "description": "Announces that the slot contents has changed",
               "name": "luzmo-slot-contents-changed"
             }
@@ -12234,28 +14131,28 @@
             {
               "name": "luzmo-dataset-constraint-triggered",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DatasetConstraintTriggeredEventDetail>"
               },
               "description": "Emitted when constraint-mode is 'event-only' and dataset change would clear slots"
             },
             {
               "name": "luzmo-slots-contents-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<SlotsContentsChangedEventDetail>"
               },
               "description": "Announces that the slots contents have changed"
             },
             {
               "name": "luzmo-dataset-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<DatasetChangedEventDetail>"
               },
               "description": "Announces that the selected dataset has changed"
             },
             {
               "name": "luzmo-slot-constraint-triggered",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<SlotConstraintTriggeredEventDetail>"
               },
               "description": "Emitted when constraint-mode is 'event-only' and a change would trigger constraints"
             }
@@ -12758,28 +14655,30 @@
             {
               "name": "luzmo-slot-contents-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<SlotContentsChangedEventDetail>"
               },
               "description": "Emitted when the slot contents change"
             },
             {
               "name": "luzmo-close",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<void>"
               },
               "description": "Emitted when the slot menu is closed"
             },
             {
               "name": "luzmo-slot-menu-active",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<SlotMenuActiveEventDetail>"
+              },
+              "description": "Emitted when the slot menu becomes active for a dataset"
             },
             {
               "name": "luzmo-slot-menu-highlight",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "CustomEvent<SlotMenuHighlightEventDetail>"
+              },
+              "description": "Emitted to highlight a column or formula in the slot menu"
             },
             {
               "name": "luzmo-slot-menu-inactive",
@@ -12790,7 +14689,7 @@
             {
               "name": "luzmo-info-visibility-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<InfoVisibilityChangedEventDetail>"
               },
               "description": "Event that is fired when the info button is clicked in display-settings, includes the visibility state and ID values"
             }
@@ -13078,6 +14977,9 @@
           ],
           "events": [
             {
+              "type": {
+                "text": "CustomEvent<SlotListChangedEventDetail>"
+              },
               "description": "Emitted when the slot list changes",
               "name": "luzmo-slot-list-changed"
             }
@@ -13206,21 +15108,21 @@
             {
               "name": "selected-changed",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<VizItemMenuSelectedChangedEventDetail>"
               },
-              "description": "Emitted when the selected button changes, includes { selectedButton: VizItemMenuButton | null } in detail"
+              "description": "Emitted when the selected button changes"
             },
             {
               "name": "button-clicked",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<VizItemMenuButtonClickedEventDetail>"
               },
-              "description": "Emitted when any menu item is clicked, includes { action: string, type: VizItemMenuButton, id: string } in detail"
+              "description": "Emitted when any menu item is clicked"
             },
             {
               "name": "edit-button-hovered",
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<void>"
               },
               "description": "Emitted when hovering over the edit button"
             }