@luzmo/analytics-components-kit 1.0.4-beta.3 → 1.0.4-beta.4

package/components/viz-item-menu-DEpm1w7U.cjs

@@ -0,0 +1,55 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+const e=require("./decorate-DCJt-2rt.cjs"),t=require("./localized-mixin-DrK3QZNa.cjs");let n=require("@luzmo/icons");require("@luzmo/lucero/icon");let r=require("lit"),i=require("lit/decorators.js"),a=require("@lit/localize");require("@luzmo/lucero/tooltip");var o=`:host{box-sizing:border-box;width:min-content;display:block}:host luzmo-icon{display:flex}:host .viz-item-menu{align-items:center;gap:var(--luzmo-viz-item-menu-gap,var(--viz-item-menu-gap));font-size:var(--luzmo-viz-item-menu-font-size,var(--viz-item-menu-font-size));flex-direction:column;width:min-content;display:flex}:host .viz-item-menu .viz-item-menu-top-section{gap:var(--luzmo-viz-item-menu-button-edit-gap,var(--viz-item-menu-button-edit-gap));flex-direction:column;display:flex}:host .viz-item-menu .viz-item-menu-top-section>.viz-item-menu-button{padding:var(--luzmo-viz-item-menu-button-edit-padding,var(--viz-item-menu-button-edit-padding));background-color:var(--luzmo-viz-item-menu-button-edit-background,var(--viz-item-menu-button-edit-background))}:host .viz-item-menu .viz-item-menu-top-section>.viz-item-menu-button:first-child{border-top-right-radius:var(--luzmo-viz-item-menu-button-edit-border-radius,var(--viz-item-menu-button-edit-border-radius));border-top-left-radius:var(--luzmo-viz-item-menu-button-edit-border-radius,var(--viz-item-menu-button-edit-border-radius))}:host .viz-item-menu .viz-item-menu-top-section>.viz-item-menu-button:last-child{border-bottom-right-radius:var(--luzmo-viz-item-menu-button-edit-border-radius,var(--viz-item-menu-button-edit-border-radius));border-bottom-left-radius:var(--luzmo-viz-item-menu-button-edit-border-radius,var(--viz-item-menu-button-edit-border-radius));box-shadow:var(--luzmo-viz-item-menu-box-shadow,var(--viz-item-menu-box-shadow))}:host .viz-item-menu .viz-item-menu-top-section>.viz-item-menu-button:hover{background-color:var(--luzmo-viz-item-menu-button-edit-background-hover,var(--viz-item-menu-button-edit-background-hover))}:host .viz-item-menu .viz-item-menu-top-section>.viz-item-menu-button:active,:host .viz-item-menu .viz-item-menu-top-section>.viz-item-menu-button[aria-pressed=true]{background-color:var(--luzmo-viz-item-menu-button-edit-background-active,var(--viz-item-menu-button-edit-background-active))}:host .viz-item-menu .viz-item-menu-top-section>.viz-item-menu-button luzmo-icon{color:var(--luzmo-viz-item-menu-button-edit-icon-color,var(--viz-item-menu-button-edit-icon-color))}:host .viz-item-menu .viz-item-menu-button{cursor:pointer;transition:var(--luzmo-viz-item-menu-transition,var(--viz-item-menu-transition));width:1rem;height:1rem;font:inherit;color:inherit;box-sizing:content-box;background:0 0;border:none;justify-content:center;align-items:center;padding:0;display:flex;position:relative}:host .viz-item-menu .viz-item-menu-button-delete{padding:var(--luzmo-viz-item-menu-delete-padding,var(--viz-item-menu-delete-padding));border-radius:var(--luzmo-viz-item-menu-delete-border-radius,var(--viz-item-menu-delete-border-radius));background-color:var(--luzmo-viz-item-menu-delete-background,var(--viz-item-menu-delete-background));box-shadow:var(--luzmo-viz-item-menu-box-shadow,var(--viz-item-menu-box-shadow))}:host .viz-item-menu .viz-item-menu-button-delete:hover{background-color:var(--luzmo-viz-item-menu-delete-background-hover,var(--viz-item-menu-delete-background-hover))}:host .viz-item-menu .viz-item-menu-button-delete:hover luzmo-icon{color:var(--luzmo-viz-item-menu-delete-icon-color-hover,var(--viz-item-menu-delete-icon-color-hover))}:host .viz-item-menu .viz-item-menu-button-delete:active{background-color:var(--luzmo-viz-item-menu-delete-background-active,var(--viz-item-menu-delete-background-active))}:host .viz-item-menu .viz-item-menu-button-delete:active luzmo-icon{color:var(--luzmo-viz-item-menu-delete-icon-color-hover,var(--viz-item-menu-delete-icon-color-hover))}:host .viz-item-menu .viz-item-menu-button-delete luzmo-icon{color:var(--luzmo-viz-item-menu-delete-icon-color,var(--viz-item-menu-delete-icon-color))}:host .viz-item-menu luzmo-tooltip{--tooltip-font-family:var(--luzmo-viz-item-menu-tooltip-font-family,var(--viz-item-menu-tooltip-font-family));font-family:var(--luzmo-viz-item-menu-tooltip-font-family,var(--viz-item-menu-tooltip-font-family))}@media (prefers-reduced-motion:reduce){:host .viz-item-menu .viz-item-menu-button{transition:none}}:host{--viz-item-menu-gap:var(--luzmo-spacing-3,.375rem);--viz-item-menu-button-edit-gap:0;--viz-item-menu-button-edit-padding:var(--luzmo-spacing-3,.125rem);--viz-item-menu-button-edit-border-radius:var(--luzmo-border-radius,.25rem);--viz-item-menu-button-edit-background:oklch(40.3678% 2.98023e-8 none);--viz-item-menu-button-edit-background-hover:var(--secondary,var(--luzmo-primary));--viz-item-menu-button-edit-background-active:var(--primary,var(--luzmo-primary));--viz-item-menu-button-edit-icon-color:var(--luzmo-primary-inverse-color,white);--viz-item-menu-delete-padding:var(--luzmo-spacing-3,.125rem);--viz-item-menu-delete-border-radius:var(--luzmo-border-radius,.25rem);--viz-item-menu-delete-background:oklch(40.3678% 2.98023e-8 none);--viz-item-menu-delete-background-hover:var(--luzmo-negative-color,#de3737);--viz-item-menu-delete-background-active:var(--luzmo-negative-color,#de3737);--viz-item-menu-delete-icon-color:var(--luzmo-primary-inverse-color,white);--viz-item-menu-delete-icon-color-hover:var(--luzmo-primary-inverse-color,white);--viz-item-menu-transition:all var(--luzmo-animation-duration,.2s) ease;--viz-item-menu-font-size:var(--luzmo-font-size-m,.875rem);--viz-item-menu-box-shadow:0px 4px 4px 0px var(--Boxshadow,rgba(var(--luzmo-border-color-rgb), .2));--viz-item-menu-tooltip-font-family:var(--luzmo-font-family,"Geist", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Open Sans", "Helvetica Neue", sans-serif)}`,s=class extends t.t(r.LitElement){constructor(...e){super(...e),this.vizItemId=``,this.hiddenButtons=[],this.selectedButton=null,this.menuButtonConfigs={edit:{icon:n.luzmoEdit,label:`Edit`,eventName:`edit`,type:`edit`,cssClass:`viz-item-menu-button viz-item-menu-button-edit`,dataE2e:`viz-item-menu-button-edit`,onHover:()=>this._handleHoverOverEdit()},clone:{icon:n.luzmoClone,label:`Clone`,eventName:`clone`,type:`clone`,cssClass:`viz-item-menu-button viz-item-menu-button-clone`,dataE2e:`viz-item-menu-button-clone`},delete:{icon:n.luzmoTrashOutline,label:`Delete`,eventName:`delete`,type:`delete`,cssClass:`viz-item-menu-button viz-item-menu-button-delete`,dataE2e:`viz-item-menu-button-delete`}}}static{this.styles=(0,r.unsafeCSS)(o)}static{this.tagName=`luzmo-viz-item-menu`}get hasTopSectionButtons(){let e=this._shouldShowButton(`edit`),t=this._shouldShowButton(`clone`);return e||t}_shouldShowButton(e){return!this.hiddenButtons?.includes(e)}_handleSelectedToggle(e){e===`edit`&&(this.selectedButton=this.selectedButton===e?null:e,this._emitSelectedChanged())}_emitSelectedChanged(){this.dispatchEvent(new CustomEvent(`selected-changed`,{bubbles:!0,composed:!0,detail:{selectedButton:this.selectedButton}}))}_handleMenuButtonClick(e){this._handleSelectedToggle(e.type),this.dispatchEvent(new CustomEvent(`button-clicked`,{bubbles:!0,composed:!0,detail:{action:e.eventName,type:e.type,id:this.vizItemId}}))}_createMenuButtonClickHandler(e){return()=>this._handleMenuButtonClick(e)}_handleHoverOverEdit(){this.dispatchEvent(new CustomEvent(`edit-button-hovered`,{bubbles:!0,composed:!0}))}_renderMenuButton(e){let t=this.selectedButton===e.type,n=``;e.type===`edit`?n=(0,a.msg)(`Edit`,{desc:`Edit action label`}):e.type===`clone`?n=(0,a.msg)(`Clone`,{desc:`Grid item action tooltip`}):e.type===`delete`&&(n=(0,a.msg)(`Delete`,{desc:`Delete action label`}));let i=e.type===`edit`;return r.html`
+      <button
+        class=${e.cssClass}
+        data-e2e=${e.dataE2e||``}
+        data-menu-button=${e.type}
+        aria-label=${n}
+        aria-pressed=${i?t?`true`:`false`:r.nothing}
+        ?selected=${t}
+        @mouseenter=${e.onHover}
+        @click=${this._createMenuButtonClickHandler(e)}
+        @keydown=${t=>{(t.key===`Enter`||t.key===` `)&&(t.preventDefault(),this._createMenuButtonClickHandler(e)())}}
+      >
+        <luzmo-icon .icon=${e.icon} size="xs"></luzmo-icon>
+        <luzmo-tooltip
+          self-managed
+          placement="right"
+          fallback-placements="left"
+        >
+          ${n}
+        </luzmo-tooltip>
+      </button>
+    `}_renderTopSection(){return this.hasTopSectionButtons?r.html`
+      <div class="viz-item-menu-top-section">
+        ${this._shouldShowButton(`edit`)?this._renderMenuButton(this.menuButtonConfigs.edit):``}
+        ${this._shouldShowButton(`clone`)?this._renderMenuButton(this.menuButtonConfigs.clone):``}
+      </div>
+    `:r.html`
+        
+      `}_renderBottomSection(){return this._shouldShowButton(`delete`)?this._renderMenuButton(this.menuButtonConfigs.delete):r.html`
+        
+      `}render(){return r.html`
+      <div class="viz-item-menu" role="toolbar" aria-label=${(0,a.msg)(`Item actions`,{desc:`Item actions toolbar label`})}>
+        ${this._renderTopSection()}
+        ${this._renderBottomSection()}
+      </div>
+    `}};e.t([(0,i.property)({type:String,reflect:!0,attribute:`viz-item-id`})],s.prototype,`vizItemId`,void 0),e.t([(0,i.property)({type:Array,attribute:!1})],s.prototype,`hiddenButtons`,void 0),e.t([(0,i.property)({type:String,reflect:!0,attribute:`selected-button`})],s.prototype,`selectedButton`,void 0),s=e.t([(0,a.localized)()],s),customElements.get(`luzmo-viz-item-menu`)||customElements.define(`luzmo-viz-item-menu`,s),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return s}});

package/components/{wordcloud-chart-options.config-DntH4Hvg.js → wordcloud-chart-options.config-D041tFDG.js}

@@ -17,7 +17,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  * */
-import { s as e } from "./pragmatic-element-adapter-BFUFSRw6.js";
+import { s as e } from "./pragmatic-element-adapter-C_7HSvGV.js";
 import { a as t, d as n, o as r, t as i } from "./helpers-d8Tb1scY.js";
 //#region node_modules/@luzmo/dashboard-contents-types/src/lib/wordcloud-chart/wordcloud-chart-options.config.js
 var a = /* @__PURE__ */ e({ default: () => o }), o = [{

package/components/wordcloud-chart-options.config-DgH4JgN2.cjs

@@ -0,0 +1,20 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+const e=require("./rolldown-runtime-mLOUI7ql.cjs"),t=require("./helpers-ByM0mGw3.cjs");var n=e.n({default:()=>r}),r=[{key:`general`,type:`group`,open:!0,children:[{key:`display.title`,control:{type:`switch`,label:`Title`,default:!0}},{key:`categories.colored`,control:{type:`switch`,label:`Word color by category`,default:!0}},{key:`color`,control:{type:`color-picker`,default:({theme:e})=>t.d(e),extraLabel:({options:e,theme:n})=>t.o(e,n,`color`),extraLabelHasClickAction:({options:e,theme:n})=>t.a(e,n,`color`),extraLabelClickAction:({options:e,theme:n})=>t.t(e,n,`color`)},visibleIf:({options:e})=>e?.categories?.colored===!1},{key:`layout`,control:{type:`radio-button-group`,label:`Layout`,default:`horizontal`,enum:[`horizontal`,`random`]}}]},{key:`order`,type:`group`,label:`Limit`,open:!0,children:[{key:`ranking.direction`,control:{type:`picker`,label:`Direction`,default:`top`,enum:[`top`,`bottom`]}},{key:`ranking.number`,control:{type:`number-field`,label:`Number of words`,default:250,min:1,max:999999}}]}];Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}});

package/components/{wordcloud-chart-positioning.config-DhoAsQP-.cjs → wordcloud-chart-positioning.config-CeP0_j_m.cjs}

@@ -17,4 +17,4 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  * */
-const e=require("./item-slot-drop-panel-Crw-ktDj.cjs");var t={grid:{columns:2,rows:2,columnSizes:[`1fr`,e.n],rowSizes:[`1fr`,e.n],gap:`0`},slots:{measure:{column:1,row:1,align:`center`,justify:`center`,rotate:!1},category:{column:1,row:2,align:`center`,justify:`center`,rotate:!1},color:{column:2,row:1,align:`center`,justify:`center`,rotate:!0}}};exports.wordcloudChartPositioningConfig=t;
+const e=require("./item-slot-drop-panel-DTvbJtNW.cjs");var t={grid:{columns:2,rows:2,columnSizes:[`1fr`,e.n],rowSizes:[`1fr`,e.n],gap:`0`},slots:{measure:{column:1,row:1,align:`center`,justify:`center`,rotate:!1},category:{column:1,row:2,align:`center`,justify:`center`,rotate:!1},color:{column:2,row:1,align:`center`,justify:`center`,rotate:!0}}};exports.wordcloudChartPositioningConfig=t;

package/components/{wordcloud-chart-positioning.config-C3Zulr2Q.js → wordcloud-chart-positioning.config-tVRXTpdQ.js}

@@ -17,7 +17,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  * */
-import { n as e } from "./item-slot-drop-panel-D5vaJidp.js";
+import { n as e } from "./item-slot-drop-panel-BaJoR9Zc.js";
 //#region node_modules/@luzmo/dashboard-contents-types/src/lib/wordcloud-chart/wordcloud-chart-positioning.config.js
 var t = {
 	grid: {

package/components/{wordcloud-chart-slots.config-CsFBBXDz.js → wordcloud-chart-slots.config-Cy-Jgcaq.js}

@@ -17,7 +17,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  * */
-import { s as e } from "./pragmatic-element-adapter-BFUFSRw6.js";
+import { s as e } from "./pragmatic-element-adapter-C_7HSvGV.js";
 //#region node_modules/@luzmo/dashboard-contents-types/src/lib/wordcloud-chart/wordcloud-chart-slots.config.js
 var t = /* @__PURE__ */ e({ wordcloudChartSlotsConfig: () => n }), n = [
 	{

package/components/{bubble-chart-slots.config-smlOOwcK.cjs → wordcloud-chart-slots.config-V29v2Fhr.cjs}

@@ -17,4 +17,4 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  * */
-var e=require("./chunk-mLOUI7ql.cjs").n({bubbleChartSlotsConfig:()=>t}),t=[{name:`measure`,rotate:!1,label:`Measure`,type:`numeric`,canAcceptFormula:!0},{name:`category`,rotate:!1,label:`Category`,options:{areDatetimeOptionsEnabled:!0},type:`categorical`,isRequired:!0},{name:`color`,label:`Color`,options:{areDatetimeOptionsEnabled:!0},rotate:!0,type:`categorical`}];Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return e}});
+var e=require("./rolldown-runtime-mLOUI7ql.cjs").n({wordcloudChartSlotsConfig:()=>t}),t=[{name:`measure`,rotate:!1,label:`Measure`,type:`numeric`,canAcceptFormula:!0},{name:`category`,rotate:!1,label:`Category`,type:`categorical`,isRequired:!0},{name:`color`,rotate:!0,label:`Color`,type:`categorical`}];Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return t}});

package/custom-elements.json

@@ -408,7 +408,7 @@
               "static": true,
               "readonly": true,
               "default": "'assistant-message-actions'",
-              "description": "Light-DOM slot name for optional actions below the latest assistant message."
+              "description": "Light-DOM slot for optional custom actions below the latest assistant message."
             },
             {
               "kind": "field",
@@ -417,7 +417,7 @@
                 "text": "ChatMessage[]"
               },
               "default": "[]",
-              "description": "Live transcript is AiChatSession.state.messages. This prop optionally seeds the session on first connect.",
+              "description": "Live transcript is AiChatSessionState.messages. This prop optionally seeds the session on first connect.",
               "attribute": "messages"
             },
             {
@@ -1217,7 +1217,7 @@
               "type": {
                 "text": "CustomEvent<void>"
               },
-              "description": "Fired when an in-flight prompt is stopped"
+              "description": "Fired when an in-flight prompt is stopped Custom actions beyond built-in `ChatMessage.actions` buttons can be projected via the `assistant-message-actions` light-DOM slot on the latest assistant message."
             },
             {
               "name": "luzmo-conversation-id-changed",
@@ -1225,6 +1225,13 @@
                 "text": "CustomEvent<AiChatConversationIdChangedEventDetail>"
               },
               "description": "Fired when the conversation ID is updated from the API"
+            },
+            {
+              "name": "luzmo-assistant-message-action",
+              "type": {
+                "text": "CustomEvent<AssistantMessageActionEventDetail>"
+              },
+              "description": "Fired when a built-in assistant message action is activated (after confirmation when `confirm` is set)"
             }
           ],
           "attributes": [
@@ -1234,7 +1241,7 @@
                 "text": "ChatMessage[]"
               },
               "default": "[]",
-              "description": "Live transcript is AiChatSession.state.messages. This prop optionally seeds the session on first connect.",
+              "description": "Live transcript is AiChatSessionState.messages. This prop optionally seeds the session on first connect.",
               "fieldName": "messages"
             },
             {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luzmo/analytics-components-kit",
-  "version": "1.0.4-beta.3",
+  "version": "1.0.4-beta.4",
   "type": "module",
   "main": "./components/index.js",
   "module": "./components/index.js",

package/react/components/ai-chat.component.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { createComponent, EventName, ReactWebComponent } from '@lit/react';
-import { LuzmoAiChat as LuzmoAiChatClass, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatMessageSentEventDetail, AiChatStepEvent } from '@luzmo/analytics-components-kit/ai-chat';
+import { LuzmoAiChat as LuzmoAiChatClass, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatMessageSentEventDetail, AiChatStepEvent, AssistantMessageActionEventDetail } from '@luzmo/analytics-components-kit/ai-chat';
 
 const LuzmoAiChatComponent = createComponent({
   tagName: 'luzmo-ai-chat',
@@ -12,7 +12,8 @@ const LuzmoAiChatComponent = createComponent({
     onLuzmoStep: 'luzmo-step' as EventName<CustomEvent<AiChatStepEvent>>,
     onLuzmoComplete: 'luzmo-complete' as EventName<CustomEvent<AiChatCompleteEvent>>,
     onLuzmoStop: 'luzmo-stop' as EventName<CustomEvent<void>>,
-    onLuzmoConversationIdChanged: 'luzmo-conversation-id-changed' as EventName<CustomEvent<AiChatConversationIdChangedEventDetail>>
+    onLuzmoConversationIdChanged: 'luzmo-conversation-id-changed' as EventName<CustomEvent<AiChatConversationIdChangedEventDetail>>,
+    onLuzmoAssistantMessageAction: 'luzmo-assistant-message-action' as EventName<CustomEvent<AssistantMessageActionEventDetail>>
   }
 });
 
@@ -23,8 +24,9 @@ const LuzmoAiChatComponent = createComponent({
  * @event onLuzmoDatasetsChanged - Fired when the selected datasets change
  * @event onLuzmoStep - 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.
  * @event onLuzmoComplete - Fired exactly once per response with the authoritative final result (dashboard/chart/name) or an `error`.
- * @event onLuzmoStop - Fired when an in-flight prompt is stopped
+ * @event onLuzmoStop - Fired when an in-flight prompt is stopped Custom actions beyond built-in `ChatMessage.actions` buttons can be projected via the `assistant-message-actions` light-DOM slot on the latest assistant message.
  * @event onLuzmoConversationIdChanged - Fired when the conversation ID is updated from the API
+ * @event onLuzmoAssistantMessageAction - Fired when a built-in assistant message action is activated (after confirmation when `confirm` is set)
  */
 export const LuzmoAiChat = LuzmoAiChatComponent as ReactWebComponent<
   LuzmoAiChatClass,
@@ -35,6 +37,7 @@ export const LuzmoAiChat = LuzmoAiChatComponent as ReactWebComponent<
     onLuzmoComplete: EventName<CustomEvent<AiChatCompleteEvent>>;
     onLuzmoStop: EventName<CustomEvent<void>>;
     onLuzmoConversationIdChanged: EventName<CustomEvent<AiChatConversationIdChangedEventDetail>>;
+    onLuzmoAssistantMessageAction: EventName<CustomEvent<AssistantMessageActionEventDetail>>;
   }
 >;
 

package/react/esm/components/ai-chat.component.d.ts

@@ -1,5 +1,5 @@
 import { EventName, ReactWebComponent } from '@lit/react';
-import { LuzmoAiChat as LuzmoAiChatClass, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatMessageSentEventDetail, AiChatStepEvent } from '@luzmo/analytics-components-kit/ai-chat';
+import { LuzmoAiChat as LuzmoAiChatClass, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatMessageSentEventDetail, AiChatStepEvent, AssistantMessageActionEventDetail } from '@luzmo/analytics-components-kit/ai-chat';
 /**
  * React wrapper for <luzmo-ai-chat>
  *
@@ -7,8 +7,9 @@ import { LuzmoAiChat as LuzmoAiChatClass, AiChatCompleteEvent, AiChatConversatio
  * @event onLuzmoDatasetsChanged - Fired when the selected datasets change
  * @event onLuzmoStep - 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.
  * @event onLuzmoComplete - Fired exactly once per response with the authoritative final result (dashboard/chart/name) or an `error`.
- * @event onLuzmoStop - Fired when an in-flight prompt is stopped
+ * @event onLuzmoStop - Fired when an in-flight prompt is stopped Custom actions beyond built-in `ChatMessage.actions` buttons can be projected via the `assistant-message-actions` light-DOM slot on the latest assistant message.
  * @event onLuzmoConversationIdChanged - Fired when the conversation ID is updated from the API
+ * @event onLuzmoAssistantMessageAction - Fired when a built-in assistant message action is activated (after confirmation when `confirm` is set)
  */
 export declare const LuzmoAiChat: ReactWebComponent<LuzmoAiChatClass, {
     onLuzmoMessageSent: EventName<CustomEvent<AiChatMessageSentEventDetail>>;
@@ -17,6 +18,7 @@ export declare const LuzmoAiChat: ReactWebComponent<LuzmoAiChatClass, {
     onLuzmoComplete: EventName<CustomEvent<AiChatCompleteEvent>>;
     onLuzmoStop: EventName<CustomEvent<void>>;
     onLuzmoConversationIdChanged: EventName<CustomEvent<AiChatConversationIdChangedEventDetail>>;
+    onLuzmoAssistantMessageAction: EventName<CustomEvent<AssistantMessageActionEventDetail>>;
 }>;
 /** The underlying custom element type for LuzmoAiChat */
 export type LuzmoAiChatElement = LuzmoAiChatClass;

package/react/esm/components/ai-chat.component.js

@@ -11,7 +11,8 @@ const LuzmoAiChatComponent = createComponent({
         onLuzmoStep: 'luzmo-step',
         onLuzmoComplete: 'luzmo-complete',
         onLuzmoStop: 'luzmo-stop',
-        onLuzmoConversationIdChanged: 'luzmo-conversation-id-changed'
+        onLuzmoConversationIdChanged: 'luzmo-conversation-id-changed',
+        onLuzmoAssistantMessageAction: 'luzmo-assistant-message-action'
     }
 });
 /**
@@ -21,7 +22,8 @@ const LuzmoAiChatComponent = createComponent({
  * @event onLuzmoDatasetsChanged - Fired when the selected datasets change
  * @event onLuzmoStep - 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.
  * @event onLuzmoComplete - Fired exactly once per response with the authoritative final result (dashboard/chart/name) or an `error`.
- * @event onLuzmoStop - Fired when an in-flight prompt is stopped
+ * @event onLuzmoStop - Fired when an in-flight prompt is stopped Custom actions beyond built-in `ChatMessage.actions` buttons can be projected via the `assistant-message-actions` light-DOM slot on the latest assistant message.
  * @event onLuzmoConversationIdChanged - Fired when the conversation ID is updated from the API
+ * @event onLuzmoAssistantMessageAction - Fired when a built-in assistant message action is activated (after confirmation when `confirm` is set)
  */
 export const LuzmoAiChat = LuzmoAiChatComponent;

package/react/luzmo-stub.d.ts

@@ -62,6 +62,7 @@ declare module '@luzmo/analytics-components-kit/ai-chat' {
   export type AiChatDatasetsChangedEventDetail = Record<string, unknown>;
   export type AiChatMessageSentEventDetail = Record<string, unknown>;
   export type AiChatStepEvent = Record<string, unknown>;
+  export type AssistantMessageActionEventDetail = Record<string, unknown>;
 }
 
 declare module '@luzmo/analytics-components-kit/ai-interaction-textarea' {

package/react/utils/store/index.d.ts

@@ -9,7 +9,7 @@
  * @example
  * ```typescript
  * // Standalone item with undo/redo
- * import { createItemStore } from '../../utils/store';
+ * import { createItemStore } from '@luzmo/analytics-components-kit/utils/store';
  *
  * const itemStore = createItemStore({
  *   type: 'bar-chart',
@@ -31,7 +31,7 @@
  * import {
  *   registerItemStore,
  *   getStore
- * } from '../../utils/store';
+ * } from '@luzmo/analytics-components-kit/utils/store';
  *
  * // Create and register stores
  * const store = registerItemStore({ type: 'bar-chart' });
@@ -46,7 +46,7 @@
  * @example
  * ```typescript
  * // Dashboard with real-time collaboration
- * import { createDashboardStore } from '../../utils/store';
+ * import { createDashboardStore } from '@luzmo/analytics-components-kit/utils/store';
  *
  * const dashboardStore = createDashboardStore(dashboardConfig);
  *
@@ -67,7 +67,7 @@ import type { ItemState, ItemStoreConfig, ItemStore, DashboardState, DashboardSt
  *
  * @example
  * ```typescript
- * import { ready, createItemStore } from '../../utils/store';
+ * import { ready, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
  *
  * await ready;
  * const store = createItemStore({ type: 'bar-chart' });
@@ -82,7 +82,7 @@ export declare const ready: Promise<void>;
  *
  * @example
  * ```typescript
- * import { onReady, createItemStore } from '../../utils/store';
+ * import { onReady, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
  *
  * onReady(() => {
  *   const store = createItemStore({ type: 'bar-chart' });

package/react/utils/store/store-registry.d.ts

@@ -11,7 +11,7 @@
  * import {
  *   registerItemStore,
  *   getStore
- * } from '../../utils/store';
+ * } from '@luzmo/analytics-components-kit/utils/store';
  *
  * // Create and register a store (auto-registers with its ID)
  * const store = registerItemStore({ type: 'bar-chart' });

package/types/ai-chat.types.d.ts

@@ -1,6 +1,26 @@
+import type { IconDefinition } from '@luzmo/icons';
 import type { ProgressTreeNode } from '@luzmo/lucero/progress-steps';
 import type { Dataset } from './dataset.types';
 export type { ProgressTreeNode };
+/** Lucero button variants allowed for assistant message action confirm buttons. */
+export type AssistantMessageActionConfirmVariant = 'primary' | 'secondary' | 'neutral' | 'negative' | 'positive' | 'white' | 'black';
+/** Built-in assistant message action rendered by luzmo-ai-chat. */
+export interface AssistantMessageAction {
+    /** Unique action identifier handled by the host application. */
+    id: string;
+    /** Button label shown in the assistant message actions footer. */
+    label: string;
+    /** Optional Lucero icon shown before the label. */
+    icon?: IconDefinition;
+    /** When true, the action button is not clickable. */
+    disabled?: boolean;
+    /** When true, shows a confirmation step before firing `luzmo-assistant-message-action`. */
+    confirm?: boolean;
+    /** Custom confirmation prompt. Used when `confirm` is true; falls back to a default message when omitted. */
+    confirmMessage?: string;
+    /** Confirm button variant. Used when `confirm` is true; defaults to `negative`. */
+    confirmVariant?: AssistantMessageActionConfirmVariant;
+}
 export interface ChatMessage {
     id?: string;
     apiMessageId?: string;
@@ -10,6 +30,13 @@ export interface ChatMessage {
     isError?: boolean;
     isCancelled?: boolean;
     hasChart?: boolean;
+    /** Built-in action buttons rendered below this assistant message. Use slots for custom actions. */
+    actions?: AssistantMessageAction[];
+}
+export interface AssistantMessageActionEventDetail {
+    messageId: string;
+    actionId: string;
+    message: ChatMessage;
 }
 export interface AiChatMessageSentEventDetail {
     message: ChatMessage;

package/utils/store/index.d.ts

@@ -9,7 +9,7 @@
  * @example
  * ```typescript
  * // Standalone item with undo/redo
- * import { createItemStore } from '../../utils/store';
+ * import { createItemStore } from '@luzmo/analytics-components-kit/utils/store';
  *
  * const itemStore = createItemStore({
  *   type: 'bar-chart',
@@ -31,7 +31,7 @@
  * import {
  *   registerItemStore,
  *   getStore
- * } from '../../utils/store';
+ * } from '@luzmo/analytics-components-kit/utils/store';
  *
  * // Create and register stores
  * const store = registerItemStore({ type: 'bar-chart' });
@@ -46,7 +46,7 @@
  * @example
  * ```typescript
  * // Dashboard with real-time collaboration
- * import { createDashboardStore } from '../../utils/store';
+ * import { createDashboardStore } from '@luzmo/analytics-components-kit/utils/store';
  *
  * const dashboardStore = createDashboardStore(dashboardConfig);
  *
@@ -67,7 +67,7 @@ import type { ItemState, ItemStoreConfig, ItemStore, DashboardState, DashboardSt
  *
  * @example
  * ```typescript
- * import { ready, createItemStore } from '../../utils/store';
+ * import { ready, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
  *
  * await ready;
  * const store = createItemStore({ type: 'bar-chart' });
@@ -82,7 +82,7 @@ export declare const ready: Promise<void>;
  *
  * @example
  * ```typescript
- * import { onReady, createItemStore } from '../../utils/store';
+ * import { onReady, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
  *
  * onReady(() => {
  *   const store = createItemStore({ type: 'bar-chart' });

package/utils/store/store-registry.d.ts

@@ -11,7 +11,7 @@
  * import {
  *   registerItemStore,
  *   getStore
- * } from '../../utils/store';
+ * } from '@luzmo/analytics-components-kit/utils/store';
  *
  * // Create and register a store (auto-registers with its ID)
  * const store = registerItemStore({ type: 'bar-chart' });