@luzmo/analytics-components-kit 1.0.9-beta.11 → 1.0.9-beta.13

package/custom-elements.json

@@ -981,6 +981,17 @@
               "description": "When true, shows context menu (3 dots) on assistant messages",
               "attribute": "show-assistant-context-menu"
             },
+            {
+              "kind": "field",
+              "name": "showAssistantMessageFeedback",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, shows thumbs up/down feedback buttons below each completed assistant message.\nA message with `hideFeedback: true` hides its buttons; the selected rating is kept in `ChatMessage.feedback`.",
+              "attribute": "show-assistant-message-feedback",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "authKey",
@@ -1672,7 +1683,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Top spacing above the assistant message actions footer",
+              "description": "Top spacing above the assistant message feedback and actions row",
               "name": "--luzmo-ai-chat-assistant-message-actions-margin-top",
               "kind": "field"
             },
@@ -1829,13 +1840,29 @@
                 "text": "CustomEvent<AssistantMessageActionEventDetail>"
               },
               "description": "Fired when a built-in assistant message action is activated (after confirmation when `confirm` is set)"
+            },
+            {
+              "name": "luzmo-assistant-message-feedback",
+              "type": {
+                "text": "CustomEvent<AssistantMessageFeedbackEventDetail>"
+              },
+              "description": "Fired once when the user selects, switches or clears a thumbs rating, after the session holds the new rating. Not fired for programmatic updates."
             }
           ],
           "attributes": [
             {
-              "description": "Size of the chat: `s`, `m` (default), `l` or `xl`. Scales messages, progress steps, questions, the empty state and the prompt input together. Custom actions beyond built-in `ChatMessage.actions` buttons can be projected via the `assistant-message-actions` light-DOM slot on the latest assistant message.",
+              "description": "Size of the chat: `s`, `m` (default), `l` or `xl`. Scales messages, progress steps, questions, the empty state and the prompt input together.",
               "name": "size"
             },
+            {
+              "description": "When true, shows thumbs up/down feedback buttons below each completed assistant message.\nA message with `hideFeedback: true` hides its buttons; the selected rating is kept in `ChatMessage.feedback`.",
+              "name": "show-assistant-message-feedback",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showAssistantMessageFeedback"
+            },
             {
               "name": "messages",
               "type": {
@@ -2606,6 +2633,104 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/ai-chat/helpers/assistant-message-feedback.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "nextAssistantMessageFeedbackRating",
+          "return": {
+            "type": {
+              "text": "AssistantMessageFeedbackRating"
+            }
+          },
+          "parameters": [
+            {
+              "name": "current",
+              "type": {
+                "text": "AssistantMessageFeedbackRating | undefined"
+              }
+            },
+            {
+              "name": "clicked",
+              "type": {
+                "text": "1 | -1"
+              }
+            }
+          ],
+          "description": "Clicking the selected thumb clears the rating; clicking the other thumb switches to it."
+        },
+        {
+          "kind": "function",
+          "name": "isAssistantMessageFeedbackOnlyChange",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "previous",
+              "type": {
+                "text": "AiChatSessionState | null"
+              }
+            },
+            {
+              "name": "next",
+              "type": {
+                "text": "AiChatSessionState"
+              }
+            }
+          ],
+          "description": "True when the only change between two session states is a message's `feedback` or `hideFeedback`.\nSuch updates re-render the transcript but must not scroll it, so rating an older reply keeps the viewport."
+        },
+        {
+          "kind": "function",
+          "name": "assistantMessageFeedbackMarkup",
+          "return": {
+            "type": {
+              "text": "TemplateResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "{\n  labelId,\n  rating,\n  size,\n  disabled,\n  onRate\n}",
+              "type": {
+                "text": "AssistantMessageFeedbackMarkupArgs"
+              }
+            }
+          ],
+          "description": "Thumbs up/down toggle buttons for an assistant message. The chat owns the rating: each button's own toggle is\nreverted and its native `change` kept inside the chat, so `luzmo-assistant-message-feedback` is the only notification."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "nextAssistantMessageFeedbackRating",
+          "declaration": {
+            "name": "nextAssistantMessageFeedbackRating",
+            "module": "src/components/ai-chat/helpers/assistant-message-feedback.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isAssistantMessageFeedbackOnlyChange",
+          "declaration": {
+            "name": "isAssistantMessageFeedbackOnlyChange",
+            "module": "src/components/ai-chat/helpers/assistant-message-feedback.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "assistantMessageFeedbackMarkup",
+          "declaration": {
+            "name": "assistantMessageFeedbackMarkup",
+            "module": "src/components/ai-chat/helpers/assistant-message-feedback.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/ai-chat/helpers/elicitation-template.ts",
@@ -3094,6 +3219,30 @@
               ],
               "description": "Answer the clarifying question on the last message and send the answer as the next prompt.\nResolves to `false` without sending while a response is generating, when that message has no open\nquestion or another message follows it, when `answer` is not one of its options, when the dataset requirement is not met, or when\nthe send is aborted or superseded before the request goes out; the answer is cleared again then."
             },
+            {
+              "kind": "method",
+              "name": "setMessageFeedback",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "messageId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "rating",
+                  "type": {
+                    "text": "AssistantMessageFeedbackRating"
+                  }
+                }
+              ],
+              "description": "Select, switch or clear the thumbs rating of an assistant message (`0` clears it). Use it to restore a saved\nrating or roll back a failed save; it never fires `luzmo-assistant-message-feedback`.\nReturns `false` without changing state for an unknown id, a user message, the in-flight reply, an invalid\nrating, or a rating that is already set (omitted counts as `0`)."
+            },
             {
               "kind": "method",
               "name": "restore",
@@ -3298,6 +3447,24 @@
             }
           ]
         },
+        {
+          "kind": "function",
+          "name": "extractAssistantMessageId",
+          "return": {
+            "type": {
+              "text": "string | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "chunk",
+              "type": {
+                "text": "Record<string, unknown>"
+              }
+            }
+          ],
+          "description": "Explicit backend id of the assistant message, from modern `/aiprompt` streams.\n\nOnly `assistant_message_id` qualifies. `user_message_id` identifies the prompt, and the\nlegacy camelCase `messageId` is the persisted *user* message id in deprecated streams,\nso neither is a spelling alias for the assistant id."
+        },
         {
           "kind": "function",
           "name": "extractChartFromChunk",
@@ -3427,6 +3594,14 @@
             "module": "src/components/ai-chat/stream/chunk-extractors.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "extractAssistantMessageId",
+          "declaration": {
+            "name": "extractAssistantMessageId",
+            "module": "src/components/ai-chat/stream/chunk-extractors.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "extractChartFromChunk",
@@ -11050,6 +11225,17 @@
               "attribute": "format",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "simple",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show an AND-only editor without the condition column or group actions.\nExisting OR conditions are preserved and cannot be edited in this mode.",
+              "attribute": "simple",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "display",
@@ -11264,6 +11450,15 @@
               "description": "Output format for the `luzmo-filters-changed` event.\n\n`canonical` emits `ItemFilterGroup[]`; `clean` emits the clean clause groups\nthat aligned hosts consume. A tree that cannot be represented cleanly falls\nback to canonical output, and the event says which format it carries.",
               "fieldName": "format"
             },
+            {
+              "name": "simple",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show an AND-only editor without the condition column or group actions.\nExisting OR conditions are preserved and cannot be edited in this mode.",
+              "fieldName": "simple"
+            },
             {
               "name": "display",
               "type": {
@@ -20452,6 +20647,20 @@
           "kind": "class",
           "description": "",
           "name": "LuzmoItemSlotPicker",
+          "cssProperties": [
+            {
+              "description": "Space between the data field select and the Edit/Delete controls. Default: `--luzmo-spacing-2`.",
+              "name": "--luzmo-item-slot-picker-select-to-controls"
+            },
+            {
+              "description": "Space between a data field and its inline slot menu. Default: `--luzmo-spacing-2`.",
+              "name": "--luzmo-item-slot-picker-inline-slot-menu-gap"
+            },
+            {
+              "description": "Background color of the inline slot menu. Default: `--luzmo-background-color`.",
+              "name": "--luzmo-item-slot-picker-inline-slot-menu-background-color"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -20652,6 +20861,17 @@
               "attribute": "slot-menu-placement",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "slotMenuMode",
+              "type": {
+                "text": "'overlay' | 'inline'"
+              },
+              "default": "'overlay'",
+              "description": "How the slot menu opens: `overlay` shows it in a popover next to the Edit button,\n`inline` expands it below the data field. Use `inline` when the picker itself lives in an overlay.\n`inline` applies to `selects=\"single\"` only; multiple selects always use the overlay.",
+              "attribute": "slot-menu-mode",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "hideConfiguration",
@@ -20670,7 +20890,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to hide the clear button op a select",
+              "description": "Whether to hide the delete button",
               "attribute": "hide-clear",
               "reflects": true
             },
@@ -20950,6 +21170,15 @@
               "description": "Placement of the slot menu popover. Only relevant for 'popup' and 'draggable' menu type",
               "fieldName": "slotMenuPlacement"
             },
+            {
+              "name": "slot-menu-mode",
+              "type": {
+                "text": "'overlay' | 'inline'"
+              },
+              "default": "'overlay'",
+              "description": "How the slot menu opens: `overlay` shows it in a popover next to the Edit button,\n`inline` expands it below the data field. Use `inline` when the picker itself lives in an overlay.\n`inline` applies to `selects=\"single\"` only; multiple selects always use the overlay.",
+              "fieldName": "slotMenuMode"
+            },
             {
               "name": "hide-configuration",
               "type": {
@@ -20965,7 +21194,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether to hide the clear button op a select",
+              "description": "Whether to hide the delete button",
               "fieldName": "hideClear"
             },
             {
@@ -21209,6 +21438,17 @@
               "attribute": "slot-menu-placement",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "slotMenuMode",
+              "type": {
+                "text": "'overlay' | 'inline'"
+              },
+              "default": "'overlay'",
+              "description": "How the slot menu opens: `overlay` shows it in a popover, `inline` expands it below the data field.\nUse `inline` when the panel itself lives in an overlay. Applies to `selects=\"single\"` only.",
+              "attribute": "slot-menu-mode",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "constraintMode",
@@ -21293,7 +21533,7 @@
               },
               "description": "Gap between slot containers",
               "name": "--luzmo-item-slot-picker-panel-gap",
-              "default": "--luzmo-spacing-4",
+              "default": "--luzmo-spacing-5",
               "kind": "field"
             },
             {
@@ -21630,6 +21870,15 @@
               "description": "Placement of the slot menu popover",
               "fieldName": "slotMenuPlacement"
             },
+            {
+              "name": "slot-menu-mode",
+              "type": {
+                "text": "'overlay' | 'inline'"
+              },
+              "default": "'overlay'",
+              "description": "How the slot menu opens: `overlay` shows it in a popover, `inline` expands it below the data field.\nUse `inline` when the panel itself lives in an overlay. Applies to `selects=\"single\"` only.",
+              "fieldName": "slotMenuMode"
+            },
             {
               "name": "constraint-mode",
               "type": {
@@ -21803,6 +22052,16 @@
               "attribute": "no-top-menu-label",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "noRemove",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "Whether to hide the remove button in the popup variant, for hosts that already offer their own delete action",
+              "attribute": "no-remove",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "dragBoundary",
@@ -22185,6 +22444,14 @@
               "description": "Whether to show the top menu label & delete button",
               "fieldName": "noTopMenuLabel"
             },
+            {
+              "name": "no-remove",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "description": "Whether to hide the remove button in the popup variant, for hosts that already offer their own delete action",
+              "fieldName": "noRemove"
+            },
             {
               "name": "drag-boundary",
               "type": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luzmo/analytics-components-kit",
-  "version": "1.0.9-beta.11",
+  "version": "1.0.9-beta.13",
   "type": "module",
   "main": "./components/index.js",
   "module": "./components/index.js",
@@ -360,7 +360,7 @@
     "@codemirror/state": "^6.6.0",
     "@codemirror/view": "^6.43.1",
     "@floating-ui/dom": "^1.7.4",
-    "@luzmo/dashboard-contents-types": "1.0.43",
+    "@luzmo/dashboard-contents-types": "1.0.47",
     "@tanstack/query-core": "^5.90.5",
     "dompurify": "^3.4.16",
     "gridstack": "^14.0.0",

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, AssistantMessageActionEventDetail } from '@luzmo/analytics-components-kit/ai-chat';
+import { LuzmoAiChat as LuzmoAiChatClass, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatMessageSentEventDetail, AiChatStepEvent, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail } from '@luzmo/analytics-components-kit/ai-chat';
 
 const LuzmoAiChatComponent = createComponent({
   tagName: 'luzmo-ai-chat',
@@ -13,7 +13,8 @@ const LuzmoAiChatComponent = createComponent({
     onLuzmoComplete: 'luzmo-complete' as EventName<CustomEvent<AiChatCompleteEvent>>,
     onLuzmoStop: 'luzmo-stop' as EventName<CustomEvent<void>>,
     onLuzmoConversationIdChanged: 'luzmo-conversation-id-changed' as EventName<CustomEvent<AiChatConversationIdChangedEventDetail>>,
-    onLuzmoAssistantMessageAction: 'luzmo-assistant-message-action' as EventName<CustomEvent<AssistantMessageActionEventDetail>>
+    onLuzmoAssistantMessageAction: 'luzmo-assistant-message-action' as EventName<CustomEvent<AssistantMessageActionEventDetail>>,
+    onLuzmoAssistantMessageFeedback: 'luzmo-assistant-message-feedback' as EventName<CustomEvent<AssistantMessageFeedbackEventDetail>>
   }
 });
 
@@ -27,6 +28,7 @@ const LuzmoAiChatComponent = createComponent({
  * @event onLuzmoStop - Fired when an in-flight prompt is stopped
  * @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)
+ * @event onLuzmoAssistantMessageFeedback - Fired once when the user selects, switches or clears a thumbs rating, after the session holds the new rating. Not fired for programmatic updates.
  */
 export const LuzmoAiChat = LuzmoAiChatComponent as ReactWebComponent<
   LuzmoAiChatClass,
@@ -38,6 +40,7 @@ export const LuzmoAiChat = LuzmoAiChatComponent as ReactWebComponent<
     onLuzmoStop: EventName<CustomEvent<void>>;
     onLuzmoConversationIdChanged: EventName<CustomEvent<AiChatConversationIdChangedEventDetail>>;
     onLuzmoAssistantMessageAction: EventName<CustomEvent<AssistantMessageActionEventDetail>>;
+    onLuzmoAssistantMessageFeedback: EventName<CustomEvent<AssistantMessageFeedbackEventDetail>>;
   }
 >;
 

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, AssistantMessageActionEventDetail } from '@luzmo/analytics-components-kit/ai-chat';
+import { LuzmoAiChat as LuzmoAiChatClass, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatMessageSentEventDetail, AiChatStepEvent, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail } from '@luzmo/analytics-components-kit/ai-chat';
 /**
  * React wrapper for <luzmo-ai-chat>
  *
@@ -10,6 +10,7 @@ import { LuzmoAiChat as LuzmoAiChatClass, AiChatCompleteEvent, AiChatConversatio
  * @event onLuzmoStop - Fired when an in-flight prompt is stopped
  * @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)
+ * @event onLuzmoAssistantMessageFeedback - Fired once when the user selects, switches or clears a thumbs rating, after the session holds the new rating. Not fired for programmatic updates.
  */
 export declare const LuzmoAiChat: ReactWebComponent<LuzmoAiChatClass, {
     onLuzmoMessageSent: EventName<CustomEvent<AiChatMessageSentEventDetail>>;
@@ -19,6 +20,7 @@ export declare const LuzmoAiChat: ReactWebComponent<LuzmoAiChatClass, {
     onLuzmoStop: EventName<CustomEvent<void>>;
     onLuzmoConversationIdChanged: EventName<CustomEvent<AiChatConversationIdChangedEventDetail>>;
     onLuzmoAssistantMessageAction: EventName<CustomEvent<AssistantMessageActionEventDetail>>;
+    onLuzmoAssistantMessageFeedback: EventName<CustomEvent<AssistantMessageFeedbackEventDetail>>;
 }>;
 /** The underlying custom element type for LuzmoAiChat */
 export type LuzmoAiChatElement = LuzmoAiChatClass;

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

@@ -12,7 +12,8 @@ const LuzmoAiChatComponent = createComponent({
         onLuzmoComplete: 'luzmo-complete',
         onLuzmoStop: 'luzmo-stop',
         onLuzmoConversationIdChanged: 'luzmo-conversation-id-changed',
-        onLuzmoAssistantMessageAction: 'luzmo-assistant-message-action'
+        onLuzmoAssistantMessageAction: 'luzmo-assistant-message-action',
+        onLuzmoAssistantMessageFeedback: 'luzmo-assistant-message-feedback'
     }
 });
 /**
@@ -25,5 +26,6 @@ const LuzmoAiChatComponent = createComponent({
  * @event onLuzmoStop - Fired when an in-flight prompt is stopped
  * @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)
+ * @event onLuzmoAssistantMessageFeedback - Fired once when the user selects, switches or clears a thumbs rating, after the session holds the new rating. Not fired for programmatic updates.
  */
 export const LuzmoAiChat = LuzmoAiChatComponent;

package/react/luzmo-stub.d.ts

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

package/react/package.json

@@ -29,7 +29,7 @@
   "peerDependencies": {
     "@lit/react": "^1.0.6",
     "react": "^18.0.0 || ^19.0.0",
-    "@luzmo/analytics-components-kit": "^1.0.9-beta.11"
+    "@luzmo/analytics-components-kit": "^1.0.9-beta.13"
   },
-  "version": "1.0.9-beta.11"
+  "version": "1.0.9-beta.13"
 }