@luzmo/analytics-components-kit 1.4.0 → 2.0.0

package/README.md

@@ -15,7 +15,7 @@ ACK produces and edits chart configuration (type, slots, options, filters). It d
 ## Installation
 
 ```bash
-npm install @luzmo/analytics-components-kit lit@^3.3.2 @luzmo/lucero@^2.6.1 @luzmo/icons@^1.0.1-alpha.49
+npm install @luzmo/analytics-components-kit lit@^3.3.2 @luzmo/lucero@^2.7.1 @luzmo/icons@^1.0.1-alpha.49
 ```
 
 ACK uses Lucero 2 for its design-system primitives. Package managers that do not install peer dependencies automatically must install the compatible peer versions explicitly.
@@ -87,6 +87,12 @@ See the [ACK documentation](https://developer.luzmo.com/guide/ack--overview) for
 usage and API guidance. These exposed APIs follow semantic versioning. Internal
 helpers are not standalone public component subpaths.
 
+`luzmo-ai-chat` can render a saved Agent's choice questions. It declares them to
+the aiprompt API only when you opt in with `interactions: ['question']` in the
+`AiChatSession` config, because an API that predates `client_capabilities`
+rejects every request that carries it. Approval cards will follow in a later
+release.
+
 ### Data Fields
 
 Present the columns and formulas from a dataset so users can pick the data they want to visualize. Also includes components to display and edit Luzmo formula/column expressions (function syntax, e.g. `SUM({datasetId:columnId})`). Formula components accept datasets directly via `datasetsDataFields` or fetch them from the Luzmo API via `dataset-ids` (+ auth).
@@ -115,6 +121,8 @@ Let users assign data fields to chart slots (e.g. `x-axis`, `measure`, `legend`)
 
 Slot panels also surface inline calculations supplied through `slotsContents`. An aggregating ad-hoc measure uses `formula`; a non-aggregating derived dimension uses `expression`. Slots show compact **Formula** or **Expression** labels with matching icons; the **cog menu** shows the full read-only calculation under the same heading, with vertical scrolling after four rows. Override its size-dependent maximum width with `--luzmo-display-settings-calculation-max-width`. Clear the picker with its **X** action, or clear a drop target with its **trash** action, to return to column selection.
 
+Slot drops, pickers, and their panels accept `hasConnectedComparisonFilter` (default `false`) as runtime context. Update it when applicable comparison filters change, and supply full `slotsContents` plus `itemType` for comparison level limits. Emitted period comparisons, including event-only constraint proposals, contain only saved comparison settings and compact date-column references. Comparisons are supported for area, bar, combination, column and line charts, pivot tables and KPIs; chart categories using arrays, weekly levels or non-default datetime display modes are excluded.
+
 ### Item Options
 
 Let users adjust how a chart looks and behaves (colors, labels, chart mode, legend position, ...).
@@ -126,7 +134,7 @@ Let users adjust how a chart looks and behaves (colors, labels, chart mode, lege
 
 For an editor with undo, set `live-interactions` on `luzmo-item-option`, `luzmo-item-option-panel`, or `luzmo-interactive-viz-item`. You can also enable it directly on `luzmo-item-option-slider`, `luzmo-item-option-color-picker`, `luzmo-item-option-color-range`, and `luzmo-item-option-guidelines` (line colors). Drags and held keys then update live, without debounce. Gesture updates carry `interaction: { id }` on `luzmo-option-changed` for bare controls, `luzmo-options-changed` for item option/panel, and `luzmo-chart-changed` for interactive viz item.
 
-All these entry points emit or forward `luzmo-option-interaction-start` (detail `{ id }`) and `-end` / `-cancel` (detail `{ id, changed }`) so you can record one history entry per gesture. A press that changes nothing emits no lifecycle events. Events through item option/panel include `optionKey`; bare controls omit it. Interactive viz item forwards the lifecycle with `optionKey`, plus the original `chart` and `generation` context. Call `endInteraction()` on the control or enclosing item option, panel, or interactive viz item before removing or rebinding it: it synchronously ends open gestures while keeping their current values. Live interactions are off by default; the default keeps the debounced behavior. The gesture boundaries come from Lucero; ACK requires `@luzmo/lucero` `^2.6.1` (at least 2.6.1 and below 3.0.0).
+All these entry points emit or forward `luzmo-option-interaction-start` (detail `{ id }`) and `-end` / `-cancel` (detail `{ id, changed }`) so you can record one history entry per gesture. A press that changes nothing emits no lifecycle events. Events through item option/panel include `optionKey`; bare controls omit it. Interactive viz item forwards the lifecycle with `optionKey`, plus the original `chart` and `generation` context. Call `endInteraction()` on the control or enclosing item option, panel, or interactive viz item before removing or rebinding it: it synchronously ends open gestures while keeping their current values. Live interactions are off by default; the default keeps the debounced behavior. The gesture boundaries come from Lucero; ACK requires `@luzmo/lucero` `^2.7.1` (at least 2.7.1 and below 3.0.0).
 
 Individual option control editors are also exported for fully custom option UIs: `item-option-action-button-group`, `item-option-color-palette-picker`, `item-option-color-picker`, `item-option-color-range`, `item-option-guidelines`, `item-option-multi-language-field`, `item-option-number-field`, `item-option-picker`, `item-option-position-picker`, `item-option-positions-number-field`, `item-option-radio-button-group`, `item-option-slider`, `item-option-switch`, and `item-option-text-field`.
 
@@ -350,6 +358,8 @@ import type {
   DashboardFilterOutput,
   ItemOptionsChangedEventDetail,
   ItemOptionInteractionEventDetail,
+  ChatMessage,
+  ChatMessageQuestion,
   VizItemExportType
 } from '@luzmo/analytics-components-kit/types';
 ```

package/angular/components/ai-chat-empty-state.ts

@@ -1,7 +1,7 @@
 import { booleanAttribute, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Input, OnChanges, output, Renderer2, SimpleChanges } from '@angular/core';
 import '@luzmo/analytics-components-kit/ai-chat';
 import type { LuzmoAiChatEmptyState as LuzmoAiChatEmptyStateHostElement, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail } from '@luzmo/analytics-components-kit/ai-chat';
-export type { AgentStreamDefinition, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail, AiChatMessageSentEventDetail, AiChatRecognizedStepType, AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionControllerOptions, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionSeed, AiChatSessionState, AiChatSessionSubmitParams, AiChatStepBase, AiChatStepEvent, AiDictationCreateBody, AiDictationProperties, AiPromptCreateBody, AiPromptDeleteBody, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail, AssistantMessageFeedbackRating, BuildAiDictationRequestOptions, ChatMessageElicitation, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail, ProgressTreeNode, PromptBoxAttachment, PromptBoxFileIcons, RecognizedStepEvent, StreamAiDictationOptions, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState, StreamingRequestOptions, StreamingResponse, UnknownStepEvent, UploadAiPromptImagesOptions } from '@luzmo/analytics-components-kit/ai-chat';
+export type { AgentStreamDefinition, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail, AiChatMessageSentEventDetail, AiChatRecognizedStepType, AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionControllerOptions, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionSeed, AiChatSessionState, AiChatSessionSubmitParams, AiChatStepBase, AiChatStepEvent, AiDictationCreateBody, AiDictationProperties, AiPromptCreateBody, AiPromptDeleteBody, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail, AssistantMessageFeedbackRating, BuildAiDictationRequestOptions, ChatChoiceOption, ChatChoiceQuestion, ChatMessageElicitation, ChatMessageQuestion, ChatQuestionAnswers, ChatQuestionResponse, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail, ProgressTreeNode, PromptBoxAttachment, PromptBoxFileIcons, RecognizedStepEvent, StreamAiDictationOptions, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState, StreamingRequestOptions, StreamingResponse, UnknownStepEvent, UploadAiPromptImagesOptions } from '@luzmo/analytics-components-kit/ai-chat';
 
 @Component({
   selector: 'luzmo-ai-chat-empty-state',

package/angular/components/ai-chat.ts

@@ -1,8 +1,8 @@
 import { booleanAttribute, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Input, OnChanges, output, Renderer2, SimpleChanges } from '@angular/core';
 import '@luzmo/analytics-components-kit/ai-chat';
 import type { LuzmoAiChat as LuzmoAiChatHostElement, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatMessageSentEventDetail, AiChatSession, AiChatStepEvent, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail } from '@luzmo/analytics-components-kit/ai-chat';
-export type { AgentStreamDefinition, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail, AiChatMessageSentEventDetail, AiChatRecognizedStepType, AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionControllerOptions, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionSeed, AiChatSessionState, AiChatSessionSubmitParams, AiChatStepBase, AiChatStepEvent, AiDictationCreateBody, AiDictationProperties, AiPromptCreateBody, AiPromptDeleteBody, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail, AssistantMessageFeedbackRating, BuildAiDictationRequestOptions, ChatMessageElicitation, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail, ProgressTreeNode, PromptBoxAttachment, PromptBoxFileIcons, RecognizedStepEvent, StreamAiDictationOptions, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState, StreamingRequestOptions, StreamingResponse, UnknownStepEvent, UploadAiPromptImagesOptions } from '@luzmo/analytics-components-kit/ai-chat';
-import type { AiPromptAgent, AiPromptCustomItemInput, AiPromptItemTask, AiPromptScreenMode, DashboardStatePayload } from '@luzmo/analytics-components-kit/ai-chat';
+export type { AgentStreamDefinition, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail, AiChatMessageSentEventDetail, AiChatRecognizedStepType, AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionControllerOptions, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionSeed, AiChatSessionState, AiChatSessionSubmitParams, AiChatStepBase, AiChatStepEvent, AiDictationCreateBody, AiDictationProperties, AiPromptCreateBody, AiPromptDeleteBody, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail, AssistantMessageFeedbackRating, BuildAiDictationRequestOptions, ChatChoiceOption, ChatChoiceQuestion, ChatMessageElicitation, ChatMessageQuestion, ChatQuestionAnswers, ChatQuestionResponse, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail, ProgressTreeNode, PromptBoxAttachment, PromptBoxFileIcons, RecognizedStepEvent, StreamAiDictationOptions, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState, StreamingRequestOptions, StreamingResponse, UnknownStepEvent, UploadAiPromptImagesOptions } from '@luzmo/analytics-components-kit/ai-chat';
+import type { AiChatInteraction, AiPromptAgent, AiPromptCustomItemInput, AiPromptItemTask, AiPromptScreenMode, DashboardStatePayload } from '@luzmo/analytics-components-kit/ai-chat';
 import type { ChatMessage, Dataset, LuzmoChart } from '@luzmo/analytics-components-kit/types';
 
 @Component({
@@ -143,6 +143,10 @@ export class LuzmoAiChat implements OnChanges {
   @Input({ alias: 'modelPreference' })
   modelPreference?: 'performance' | 'quality';
 
+  /** Boxes the agent may show, declared on every request as `client_capabilities`. Defaults to none. Pass `['question']` once the aiprompt API accepts `client_capabilities`. Ignored with a host `chatSession`. */
+  @Input({ alias: 'interactions' })
+  interactions?: AiChatInteraction[];
+
   /** Host-owned AiChatSession. The component subscribes and renders; does not abort on disconnect. */
   @Input({ alias: 'chatSession' })
   chatSession?: AiChatSession | null;
@@ -217,7 +221,7 @@ export class LuzmoAiChat implements OnChanges {
   /** Fired when the selected datasets change */
   readonly luzmoDatasetsChanged = output<CustomEvent<AiChatDatasetsChangedEventDetail>>({ alias: 'luzmoDatasetsChanged' });
 
-  /** Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, custom-item, elicitation, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow. */
+  /** Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, custom-item, elicitation, question, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow. */
   readonly luzmoStep = output<CustomEvent<AiChatStepEvent>>({ alias: 'luzmoStep' });
 
   /** Fired exactly once per response with the authoritative final result (dashboard/chart/name/customItem) or an `error`. */
@@ -334,6 +338,9 @@ export class LuzmoAiChat implements OnChanges {
         case 'modelPreference':
           this.setHostProperty('modelPreference', changes['modelPreference'].currentValue);
           break;
+        case 'interactions':
+          this.setHostProperty('interactions', changes['interactions'].currentValue);
+          break;
         case 'chatSession':
           this.setHostProperty('chatSession', changes['chatSession'].currentValue);
           break;

package/angular/components/display-settings-period-over-period.ts

@@ -3,7 +3,7 @@ import '@luzmo/analytics-components-kit/display-settings-period-over-period';
 import type { LuzmoDisplaySettingsPeriodOverPeriod as LuzmoDisplaySettingsPeriodOverPeriodHostElement, DisplaySettingsSlotContentChangedEventDetail } from '@luzmo/analytics-components-kit/display-settings-period-over-period';
 export type { DisplaySettingsSlotContentChangedEventDetail } from '@luzmo/analytics-components-kit/display-settings-period-over-period';
 import type { PeriodOverPeriodCondition } from '@luzmo/analytics-components-kit/types';
-import type { Column } from '@luzmo/dashboard-contents-types';
+import type { Column, VizItemSlot, VizItemType } from '@luzmo/dashboard-contents-types';
 
 @Component({
   selector: 'luzmo-display-settings-period-over-period',
@@ -27,19 +27,31 @@ export class LuzmoDisplaySettingsPeriodOverPeriod implements OnChanges {
     return this.host;
   }
 
+  /** Full saved slots for deriving comparison levels and implicit datetime offsets. */
+  @Input({ alias: 'slotsContents' })
+  slotsContents?: VizItemSlot[];
+
+  /** Visualization type used to interpret comparison slot context. */
+  @Input({ alias: 'itemType' })
+  itemType?: VizItemType;
+
+  /** Whether a comparison filter currently applies to this item. Runtime only; never saved in slot contents. */
+  @Input({ alias: 'hasConnectedComparisonFilter', transform: booleanAttribute })
+  hasConnectedComparisonFilter?: boolean;
+
   /** The slotContent that is passed to the settings */
   @Input({ alias: 'slotContent' })
   slotContent?: any;
 
-  /** Which period-over-period UI variant to render, based on available datetime columns and comparison filters. */
+  /** Optional UI variant supplied by a parent. When absent, derive it from runtime slot and filter context. */
   @Input({ alias: 'periodOverPeriodType' })
   periodOverPeriodUiType?: PeriodOverPeriodCondition;
 
-  /** Offer the "Periods" offset when there is no datetime category (an offset date column is needed). The item then shifts by the length of the period selected by its date filters. */
+  /** Offer the "Periods" offset when there is no datetime category (an offset date column is needed). The item then shifts by the length of the period selected by its date filters. Defaults to true for KPIs, false otherwise. */
   @Input({ alias: 'allowPeriodsWithoutDatetimeColumn', transform: booleanAttribute })
   allowPeriodsWithoutDatetimeColumn?: boolean;
 
-  /** Hide the "Past value" comparison type, e.g. for items that only show the change. */
+  /** Hide the "Past value" comparison type. Defaults to true for KPIs, false otherwise; explicit booleans override the default. */
   @Input({ alias: 'hidePastValue', transform: booleanAttribute })
   hidePastValue?: boolean;
 
@@ -70,6 +82,15 @@ export class LuzmoDisplaySettingsPeriodOverPeriod implements OnChanges {
   ngOnChanges(changes: SimpleChanges): void {
     for (const key of Object.keys(changes)) {
       switch (key) {
+        case 'slotsContents':
+          this.setHostProperty('slotsContents', changes['slotsContents'].currentValue);
+          break;
+        case 'itemType':
+          this.setHostProperty('itemType', changes['itemType'].currentValue);
+          break;
+        case 'hasConnectedComparisonFilter':
+          this.setHostProperty('hasConnectedComparisonFilter', changes['hasConnectedComparisonFilter'].currentValue);
+          break;
         case 'slotContent':
           this.setHostProperty('slotContent', changes['slotContent'].currentValue);
           break;

package/angular/components/display-settings.ts

@@ -5,7 +5,7 @@ export type { DisplaySettingsRemoveSlotContentEventDetail, DisplaySettingsSlotCo
 import type { DatasetDataFields } from '@luzmo/analytics-components-kit/data-field-panel';
 import type { MeasureColumnsItem } from '@luzmo/analytics-components-kit/slot-menu';
 import type { PeriodOverPeriodCondition, SlotContent } from '@luzmo/analytics-components-kit/types';
-import type { SlotName } from '@luzmo/dashboard-contents-types';
+import type { SlotName, VizItemSlot, VizItemType } from '@luzmo/dashboard-contents-types';
 
 @Component({
   selector: 'luzmo-display-settings',
@@ -29,6 +29,18 @@ export class LuzmoDisplaySettings implements OnChanges {
     return this.host;
   }
 
+  /** Full saved slots for deriving comparison levels and implicit datetime offsets. */
+  @Input({ alias: 'slotsContents' })
+  slotsContents?: VizItemSlot[];
+
+  /** Visualization type used to interpret comparison slot context. */
+  @Input({ alias: 'itemType' })
+  itemType?: VizItemType;
+
+  /** Whether a comparison filter currently applies to this item. Runtime only; never saved in slot contents. */
+  @Input({ alias: 'hasConnectedComparisonFilter', transform: booleanAttribute })
+  hasConnectedComparisonFilter?: boolean;
+
   /** The language of the settings interface */
   @Input({ alias: 'language' })
   language?: string;
@@ -61,7 +73,7 @@ export class LuzmoDisplaySettings implements OnChanges {
   @Input({ alias: 'isCumulativeSumEnabled', transform: booleanAttribute })
   isCumulativeSumEnabled?: boolean;
 
-  /** Whether to show the period-over-period in numeric */
+  /** Optional comparison UI override for standalone use; null hides comparisons. Otherwise derived from slotsContents, itemType, filters, and datasetsDataFields. */
   @Input({ alias: 'periodOverPeriodUiType' })
   periodOverPeriodUiType?: PeriodOverPeriodCondition | null;
 
@@ -81,7 +93,7 @@ export class LuzmoDisplaySettings implements OnChanges {
   @Input({ alias: 'slotContent' })
   slotContent?: SlotContent;
 
-  /** Datasets used to resolve column names in ad-hoc calculation previews. */
+  /** Datasets used for calculation previews and standalone comparison offset date choices (columns or dataFields). */
   @Input({ alias: 'datasetsDataFields' })
   datasetsDataFields?: DatasetDataFields[];
 
@@ -126,6 +138,15 @@ export class LuzmoDisplaySettings implements OnChanges {
   ngOnChanges(changes: SimpleChanges): void {
     for (const key of Object.keys(changes)) {
       switch (key) {
+        case 'slotsContents':
+          this.setHostProperty('slotsContents', changes['slotsContents'].currentValue);
+          break;
+        case 'itemType':
+          this.setHostProperty('itemType', changes['itemType'].currentValue);
+          break;
+        case 'hasConnectedComparisonFilter':
+          this.setHostProperty('hasConnectedComparisonFilter', changes['hasConnectedComparisonFilter'].currentValue);
+          break;
         case 'language':
           this.setHostProperty('language', changes['language'].currentValue);
           break;

package/angular/components/item-slot-drop-panel.ts

@@ -27,6 +27,10 @@ export class LuzmoItemSlotDropPanel implements OnChanges {
     return this.host;
   }
 
+  /** Whether a comparison filter currently applies to this item. Runtime only; never saved in slot contents. */
+  @Input({ alias: 'hasConnectedComparisonFilter', transform: booleanAttribute })
+  hasConnectedComparisonFilter?: boolean;
+
   /** The type of the item (e.g., 'bar-chart', 'line-chart', 'area-chart') */
   @Input({ alias: 'itemType' })
   itemType?: VizItemType | string;
@@ -133,6 +137,9 @@ export class LuzmoItemSlotDropPanel implements OnChanges {
   ngOnChanges(changes: SimpleChanges): void {
     for (const key of Object.keys(changes)) {
       switch (key) {
+        case 'hasConnectedComparisonFilter':
+          this.setHostProperty('hasConnectedComparisonFilter', changes['hasConnectedComparisonFilter'].currentValue);
+          break;
         case 'itemType':
           this.setHostProperty('itemType', changes['itemType'].currentValue);
           break;

package/angular/components/item-slot-drop.ts

@@ -27,6 +27,10 @@ export class LuzmoItemSlotDrop implements OnChanges {
     return this.host;
   }
 
+  /** Whether a comparison filter currently applies to this item. Runtime only; never saved in slot contents. */
+  @Input({ alias: 'hasConnectedComparisonFilter', transform: booleanAttribute })
+  hasConnectedComparisonFilter?: boolean;
+
   /** The visualization item type that determines the available slots and their configuration. */
   @Input({ alias: 'itemType' })
   itemType?: VizItemType;
@@ -122,6 +126,9 @@ export class LuzmoItemSlotDrop implements OnChanges {
   ngOnChanges(changes: SimpleChanges): void {
     for (const key of Object.keys(changes)) {
       switch (key) {
+        case 'hasConnectedComparisonFilter':
+          this.setHostProperty('hasConnectedComparisonFilter', changes['hasConnectedComparisonFilter'].currentValue);
+          break;
         case 'itemType':
           this.setHostProperty('itemType', changes['itemType'].currentValue);
           break;

package/angular/components/item-slot-picker-panel.ts

@@ -28,6 +28,10 @@ export class LuzmoItemSlotPickerPanel implements OnChanges {
     return this.host;
   }
 
+  /** Whether a comparison filter currently applies to this item. Runtime only; never saved in slot contents. */
+  @Input({ alias: 'hasConnectedComparisonFilter', transform: booleanAttribute })
+  hasConnectedComparisonFilter?: boolean;
+
   /** The type of the item (e.g., 'bar-chart', 'line-chart', 'area-chart') */
   @Input({ alias: 'itemType' })
   itemType?: VizItemType | string;
@@ -168,6 +172,9 @@ export class LuzmoItemSlotPickerPanel implements OnChanges {
   ngOnChanges(changes: SimpleChanges): void {
     for (const key of Object.keys(changes)) {
       switch (key) {
+        case 'hasConnectedComparisonFilter':
+          this.setHostProperty('hasConnectedComparisonFilter', changes['hasConnectedComparisonFilter'].currentValue);
+          break;
         case 'itemType':
           this.setHostProperty('itemType', changes['itemType'].currentValue);
           break;

package/angular/components/item-slot-picker.ts

@@ -4,7 +4,7 @@ import type { LuzmoItemSlotPicker as LuzmoItemSlotPickerHostElement, SlotContent
 export type { SlotContentsChangedEventDetail } from '@luzmo/analytics-components-kit/item-slot-picker';
 import type { Placement } from '@floating-ui/dom';
 import type { DatasetsDataFields, SlotContent } from '@luzmo/analytics-components-kit/types';
-import type { SlotConfig, SlotName, VizItemType } from '@luzmo/dashboard-contents-types';
+import type { SlotConfig, SlotName, VizItemSlot, VizItemType } from '@luzmo/dashboard-contents-types';
 
 @Component({
   selector: 'luzmo-item-slot-picker',
@@ -28,6 +28,14 @@ export class LuzmoItemSlotPicker implements OnChanges {
     return this.host;
   }
 
+  /** Full saved slots for deriving comparison levels and implicit datetime offsets. */
+  @Input({ alias: 'slotsContents' })
+  slotsContents?: VizItemSlot[];
+
+  /** Whether a comparison filter currently applies to this item. Runtime only; never saved in slot contents. */
+  @Input({ alias: 'hasConnectedComparisonFilter', transform: booleanAttribute })
+  hasConnectedComparisonFilter?: boolean;
+
   /** The API URL for the databroker */
   @Input({ alias: 'apiUrl' })
   apiUrl?: string;
@@ -143,6 +151,12 @@ export class LuzmoItemSlotPicker implements OnChanges {
   ngOnChanges(changes: SimpleChanges): void {
     for (const key of Object.keys(changes)) {
       switch (key) {
+        case 'slotsContents':
+          this.setHostProperty('slotsContents', changes['slotsContents'].currentValue);
+          break;
+        case 'hasConnectedComparisonFilter':
+          this.setHostProperty('hasConnectedComparisonFilter', changes['hasConnectedComparisonFilter'].currentValue);
+          break;
         case 'apiUrl':
           this.setHostProperty('apiUrl', changes['apiUrl'].currentValue);
           break;

package/angular/components/slot-menu.ts

@@ -6,7 +6,7 @@ import type { DatasetDataFields } from '@luzmo/analytics-components-kit/data-fie
 import type { LuzmoDisplaySettings } from '@luzmo/analytics-components-kit/display-settings';
 import type { LuzmoSlotMenuList } from '@luzmo/analytics-components-kit/slot-menu-list';
 import type { SlotContent } from '@luzmo/analytics-components-kit/types';
-import type { SlotName, VizItemType } from '@luzmo/dashboard-contents-types';
+import type { SlotName, VizItemSlot, VizItemType } from '@luzmo/dashboard-contents-types';
 
 @Component({
   selector: 'luzmo-slot-menu',
@@ -30,6 +30,14 @@ export class LuzmoSlotMenu implements OnChanges {
     return this.host;
   }
 
+  /** Full saved slots for deriving comparison levels and implicit datetime offsets. */
+  @Input({ alias: 'slotsContents' })
+  slotsContents?: VizItemSlot[];
+
+  /** Whether a comparison filter currently applies to this item. Runtime only; never saved in slot contents. */
+  @Input({ alias: 'hasConnectedComparisonFilter', transform: booleanAttribute })
+  hasConnectedComparisonFilter?: boolean;
+
   /** The language of the settings interface */
   @Input({ alias: 'language' })
   language?: string;
@@ -164,6 +172,12 @@ export class LuzmoSlotMenu implements OnChanges {
   ngOnChanges(changes: SimpleChanges): void {
     for (const key of Object.keys(changes)) {
       switch (key) {
+        case 'slotsContents':
+          this.setHostProperty('slotsContents', changes['slotsContents'].currentValue);
+          break;
+        case 'hasConnectedComparisonFilter':
+          this.setHostProperty('hasConnectedComparisonFilter', changes['hasConnectedComparisonFilter'].currentValue);
+          break;
         case 'language':
           this.setHostProperty('language', changes['language'].currentValue);
           break;

package/angular/esm/components/ai-chat-empty-state.d.ts

@@ -2,7 +2,7 @@ import { OnChanges, SimpleChanges } from '@angular/core';
 import '@luzmo/analytics-components-kit/ai-chat';
 import type { LuzmoAiChatEmptyState as LuzmoAiChatEmptyStateHostElement, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail } from '@luzmo/analytics-components-kit/ai-chat';
 import * as i0 from "@angular/core";
-export type { AgentStreamDefinition, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail, AiChatMessageSentEventDetail, AiChatRecognizedStepType, AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionControllerOptions, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionSeed, AiChatSessionState, AiChatSessionSubmitParams, AiChatStepBase, AiChatStepEvent, AiDictationCreateBody, AiDictationProperties, AiPromptCreateBody, AiPromptDeleteBody, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail, AssistantMessageFeedbackRating, BuildAiDictationRequestOptions, ChatMessageElicitation, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail, ProgressTreeNode, PromptBoxAttachment, PromptBoxFileIcons, RecognizedStepEvent, StreamAiDictationOptions, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState, StreamingRequestOptions, StreamingResponse, UnknownStepEvent, UploadAiPromptImagesOptions } from '@luzmo/analytics-components-kit/ai-chat';
+export type { AgentStreamDefinition, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail, AiChatMessageSentEventDetail, AiChatRecognizedStepType, AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionControllerOptions, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionSeed, AiChatSessionState, AiChatSessionSubmitParams, AiChatStepBase, AiChatStepEvent, AiDictationCreateBody, AiDictationProperties, AiPromptCreateBody, AiPromptDeleteBody, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail, AssistantMessageFeedbackRating, BuildAiDictationRequestOptions, ChatChoiceOption, ChatChoiceQuestion, ChatMessageElicitation, ChatMessageQuestion, ChatQuestionAnswers, ChatQuestionResponse, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail, ProgressTreeNode, PromptBoxAttachment, PromptBoxFileIcons, RecognizedStepEvent, StreamAiDictationOptions, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState, StreamingRequestOptions, StreamingResponse, UnknownStepEvent, UploadAiPromptImagesOptions } from '@luzmo/analytics-components-kit/ai-chat';
 export declare class LuzmoAiChatEmptyState implements OnChanges {
     private readonly elementRef;
     private readonly renderer;

package/angular/esm/components/ai-chat.d.ts

@@ -1,10 +1,10 @@
 import { OnChanges, SimpleChanges } from '@angular/core';
 import '@luzmo/analytics-components-kit/ai-chat';
 import type { LuzmoAiChat as LuzmoAiChatHostElement, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatMessageSentEventDetail, AiChatSession, AiChatStepEvent, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail } from '@luzmo/analytics-components-kit/ai-chat';
-import type { AiPromptAgent, AiPromptCustomItemInput, AiPromptItemTask, AiPromptScreenMode, DashboardStatePayload } from '@luzmo/analytics-components-kit/ai-chat';
+import type { AiChatInteraction, AiPromptAgent, AiPromptCustomItemInput, AiPromptItemTask, AiPromptScreenMode, DashboardStatePayload } from '@luzmo/analytics-components-kit/ai-chat';
 import type { ChatMessage, Dataset, LuzmoChart } from '@luzmo/analytics-components-kit/types';
 import * as i0 from "@angular/core";
-export type { AgentStreamDefinition, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail, AiChatMessageSentEventDetail, AiChatRecognizedStepType, AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionControllerOptions, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionSeed, AiChatSessionState, AiChatSessionSubmitParams, AiChatStepBase, AiChatStepEvent, AiDictationCreateBody, AiDictationProperties, AiPromptCreateBody, AiPromptDeleteBody, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail, AssistantMessageFeedbackRating, BuildAiDictationRequestOptions, ChatMessageElicitation, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail, ProgressTreeNode, PromptBoxAttachment, PromptBoxFileIcons, RecognizedStepEvent, StreamAiDictationOptions, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState, StreamingRequestOptions, StreamingResponse, UnknownStepEvent, UploadAiPromptImagesOptions } from '@luzmo/analytics-components-kit/ai-chat';
+export type { AgentStreamDefinition, AiChatAgentConfig, AiChatCompleteEvent, AiChatConversationIdChangedEventDetail, AiChatDatasetsChangedEventDetail, AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail, AiChatMessageSentEventDetail, AiChatRecognizedStepType, AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionControllerOptions, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionSeed, AiChatSessionState, AiChatSessionSubmitParams, AiChatStepBase, AiChatStepEvent, AiDictationCreateBody, AiDictationProperties, AiPromptCreateBody, AiPromptDeleteBody, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AssistantMessageFeedbackEventDetail, AssistantMessageFeedbackRating, BuildAiDictationRequestOptions, ChatChoiceOption, ChatChoiceQuestion, ChatMessageElicitation, ChatMessageQuestion, ChatQuestionAnswers, ChatQuestionResponse, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail, ProgressTreeNode, PromptBoxAttachment, PromptBoxFileIcons, RecognizedStepEvent, StreamAiDictationOptions, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState, StreamingRequestOptions, StreamingResponse, UnknownStepEvent, UploadAiPromptImagesOptions } from '@luzmo/analytics-components-kit/ai-chat';
 export declare class LuzmoAiChat implements OnChanges {
     private readonly elementRef;
     private readonly renderer;
@@ -71,6 +71,8 @@ export declare class LuzmoAiChat implements OnChanges {
     task?: AiPromptItemTask;
     /** AI model preference for item agent chart generation */
     modelPreference?: 'performance' | 'quality';
+    /** Boxes the agent may show, declared on every request as `client_capabilities`. Defaults to none. Pass `['question']` once the aiprompt API accepts `client_capabilities`. Ignored with a host `chatSession`. */
+    interactions?: AiChatInteraction[];
     /** Host-owned AiChatSession. The component subscribes and renders; does not abort on disconnect. */
     chatSession?: AiChatSession | null;
     /** Conversation ID (synced into the session; updated when the API returns a new id). */
@@ -109,7 +111,7 @@ export declare class LuzmoAiChat implements OnChanges {
     readonly luzmoMessageSent: import("@angular/core").OutputEmitterRef<CustomEvent<AiChatMessageSentEventDetail>>;
     /** Fired when the selected datasets change */
     readonly luzmoDatasetsChanged: import("@angular/core").OutputEmitterRef<CustomEvent<AiChatDatasetsChangedEventDetail>>;
-    /** Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, custom-item, elicitation, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow. */
+    /** Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, custom-item, elicitation, question, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow. */
     readonly luzmoStep: import("@angular/core").OutputEmitterRef<CustomEvent<AiChatStepEvent>>;
     /** Fired exactly once per response with the authoritative final result (dashboard/chart/name/customItem) or an `error`. */
     readonly luzmoComplete: import("@angular/core").OutputEmitterRef<CustomEvent<AiChatCompleteEvent>>;
@@ -132,7 +134,7 @@ export declare class LuzmoAiChat implements OnChanges {
     private setHostProperty;
     private bindEvents;
     static ɵfac: i0.ɵɵFactoryDeclaration<LuzmoAiChat, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LuzmoAiChat, "luzmo-ai-chat", ["luzmoAiChat"], { "messages": { "alias": "messages"; "required": false; }; "selectedDatasets": { "alias": "selectedDatasets"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "stoppable": { "alias": "stoppable"; "required": false; }; "showAssistantContextMenu": { "alias": "showAssistantContextMenu"; "required": false; }; "showAssistantMessageFeedback": { "alias": "showAssistantMessageFeedback"; "required": false; }; "authKey": { "alias": "authKey"; "required": false; }; "authToken": { "alias": "authToken"; "required": false; }; "apiUrl": { "alias": "apiUrl"; "required": false; }; "appServer": { "alias": "appServer"; "required": false; }; "includePublicDatasets": { "alias": "includePublicDatasets"; "required": false; }; "flagOpendata": { "alias": "flagOpendata"; "required": false; }; "hideDatasetButton": { "alias": "hideDatasetButton"; "required": false; }; "hideDatasetIcons": { "alias": "hideDatasetIcons"; "required": false; }; "disableDatasetModification": { "alias": "disableDatasetModification"; "required": false; }; "hideSelectedDatasets": { "alias": "hideSelectedDatasets"; "required": false; }; "hideAgents": { "alias": "hideAgents"; "required": false; }; "disableColumnMentions": { "alias": "disableColumnMentions"; "required": false; }; "requireDataset": { "alias": "requireDataset"; "required": false; }; "allowImages": { "alias": "allowImages"; "required": false; }; "allowVoiceInput": { "alias": "allowVoiceInput"; "required": false; }; "acceptedFileTypes": { "alias": "acceptedFileTypes"; "required": false; }; "uploadAttachments": { "alias": "uploadAttachments"; "required": false; }; "agent": { "alias": "agent"; "required": false; }; "agentConfig": { "alias": "agentConfig"; "required": false; }; "agentId": { "alias": "agentId"; "required": false; }; "task": { "alias": "task"; "required": false; }; "modelPreference": { "alias": "modelPreference"; "required": false; }; "chatSession": { "alias": "chatSession"; "required": false; }; "conversationId": { "alias": "conversationId"; "required": false; }; "chart": { "alias": "chart"; "required": false; }; "dashboard": { "alias": "dashboard"; "required": false; }; "customItem": { "alias": "customItem"; "required": false; }; "currentScreenMode": { "alias": "currentScreenMode"; "required": false; }; "localeId": { "alias": "localeId"; "required": false; }; "timezoneId": { "alias": "timezoneId"; "required": false; }; "apiVersion": { "alias": "apiVersion"; "required": false; }; "stream": { "alias": "stream"; "required": false; }; "loadingMessage": { "alias": "loadingMessage"; "required": false; }; "cancelledMessage": { "alias": "cancelledMessage"; "required": false; }; "initialPrompt": { "alias": "initialPrompt"; "required": false; }; "emptyStateTitle": { "alias": "emptyStateTitle"; "required": false; }; "emptyStateSubtitle": { "alias": "emptyStateSubtitle"; "required": false; }; "emptyStateSuggestions": { "alias": "emptyStateSuggestions"; "required": false; }; "size": { "alias": "size"; "required": false; }; }, { "luzmoMessageSent": "luzmoMessageSent"; "luzmoDatasetsChanged": "luzmoDatasetsChanged"; "luzmoStep": "luzmoStep"; "luzmoComplete": "luzmoComplete"; "luzmoStop": "luzmoStop"; "luzmoConversationIdChanged": "luzmoConversationIdChanged"; "luzmoAssistantMessageAction": "luzmoAssistantMessageAction"; "luzmoAssistantMessageFeedback": "luzmoAssistantMessageFeedback"; }, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LuzmoAiChat, "luzmo-ai-chat", ["luzmoAiChat"], { "messages": { "alias": "messages"; "required": false; }; "selectedDatasets": { "alias": "selectedDatasets"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "stoppable": { "alias": "stoppable"; "required": false; }; "showAssistantContextMenu": { "alias": "showAssistantContextMenu"; "required": false; }; "showAssistantMessageFeedback": { "alias": "showAssistantMessageFeedback"; "required": false; }; "authKey": { "alias": "authKey"; "required": false; }; "authToken": { "alias": "authToken"; "required": false; }; "apiUrl": { "alias": "apiUrl"; "required": false; }; "appServer": { "alias": "appServer"; "required": false; }; "includePublicDatasets": { "alias": "includePublicDatasets"; "required": false; }; "flagOpendata": { "alias": "flagOpendata"; "required": false; }; "hideDatasetButton": { "alias": "hideDatasetButton"; "required": false; }; "hideDatasetIcons": { "alias": "hideDatasetIcons"; "required": false; }; "disableDatasetModification": { "alias": "disableDatasetModification"; "required": false; }; "hideSelectedDatasets": { "alias": "hideSelectedDatasets"; "required": false; }; "hideAgents": { "alias": "hideAgents"; "required": false; }; "disableColumnMentions": { "alias": "disableColumnMentions"; "required": false; }; "requireDataset": { "alias": "requireDataset"; "required": false; }; "allowImages": { "alias": "allowImages"; "required": false; }; "allowVoiceInput": { "alias": "allowVoiceInput"; "required": false; }; "acceptedFileTypes": { "alias": "acceptedFileTypes"; "required": false; }; "uploadAttachments": { "alias": "uploadAttachments"; "required": false; }; "agent": { "alias": "agent"; "required": false; }; "agentConfig": { "alias": "agentConfig"; "required": false; }; "agentId": { "alias": "agentId"; "required": false; }; "task": { "alias": "task"; "required": false; }; "modelPreference": { "alias": "modelPreference"; "required": false; }; "interactions": { "alias": "interactions"; "required": false; }; "chatSession": { "alias": "chatSession"; "required": false; }; "conversationId": { "alias": "conversationId"; "required": false; }; "chart": { "alias": "chart"; "required": false; }; "dashboard": { "alias": "dashboard"; "required": false; }; "customItem": { "alias": "customItem"; "required": false; }; "currentScreenMode": { "alias": "currentScreenMode"; "required": false; }; "localeId": { "alias": "localeId"; "required": false; }; "timezoneId": { "alias": "timezoneId"; "required": false; }; "apiVersion": { "alias": "apiVersion"; "required": false; }; "stream": { "alias": "stream"; "required": false; }; "loadingMessage": { "alias": "loadingMessage"; "required": false; }; "cancelledMessage": { "alias": "cancelledMessage"; "required": false; }; "initialPrompt": { "alias": "initialPrompt"; "required": false; }; "emptyStateTitle": { "alias": "emptyStateTitle"; "required": false; }; "emptyStateSubtitle": { "alias": "emptyStateSubtitle"; "required": false; }; "emptyStateSuggestions": { "alias": "emptyStateSuggestions"; "required": false; }; "size": { "alias": "size"; "required": false; }; }, { "luzmoMessageSent": "luzmoMessageSent"; "luzmoDatasetsChanged": "luzmoDatasetsChanged"; "luzmoStep": "luzmoStep"; "luzmoComplete": "luzmoComplete"; "luzmoStop": "luzmoStop"; "luzmoConversationIdChanged": "luzmoConversationIdChanged"; "luzmoAssistantMessageAction": "luzmoAssistantMessageAction"; "luzmoAssistantMessageFeedback": "luzmoAssistantMessageFeedback"; }, never, ["*"], true, never>;
     static ngAcceptInputType_disabled: unknown;
     static ngAcceptInputType_stoppable: unknown;
     static ngAcceptInputType_showAssistantContextMenu: unknown;

package/angular/esm/components/ai-chat.js

@@ -73,6 +73,8 @@ export class LuzmoAiChat {
     task;
     /** AI model preference for item agent chart generation */
     modelPreference;
+    /** Boxes the agent may show, declared on every request as `client_capabilities`. Defaults to none. Pass `['question']` once the aiprompt API accepts `client_capabilities`. Ignored with a host `chatSession`. */
+    interactions;
     /** Host-owned AiChatSession. The component subscribes and renders; does not abort on disconnect. */
     chatSession;
     /** Conversation ID (synced into the session; updated when the API returns a new id). */
@@ -111,7 +113,7 @@ export class LuzmoAiChat {
     luzmoMessageSent = output({ alias: 'luzmoMessageSent' });
     /** Fired when the selected datasets change */
     luzmoDatasetsChanged = output({ alias: 'luzmoDatasetsChanged' });
-    /** Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, custom-item, elicitation, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow. */
+    /** Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, custom-item, elicitation, question, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow. */
     luzmoStep = output({ alias: 'luzmoStep' });
     /** Fired exactly once per response with the authoritative final result (dashboard/chart/name/customItem) or an `error`. */
     luzmoComplete = output({ alias: 'luzmoComplete' });
@@ -221,6 +223,9 @@ export class LuzmoAiChat {
                 case 'modelPreference':
                     this.setHostProperty('modelPreference', changes['modelPreference'].currentValue);
                     break;
+                case 'interactions':
+                    this.setHostProperty('interactions', changes['interactions'].currentValue);
+                    break;
                 case 'chatSession':
                     this.setHostProperty('chatSession', changes['chatSession'].currentValue);
                     break;
@@ -321,7 +326,7 @@ export class LuzmoAiChat {
         }));
     }
     static ɵfac = function LuzmoAiChat_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || LuzmoAiChat)(); };
-    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: LuzmoAiChat, selectors: [["luzmo-ai-chat"]], inputs: { messages: "messages", selectedDatasets: "selectedDatasets", placeholder: "placeholder", disabled: [2, "disabled", "disabled", booleanAttribute], stoppable: [2, "stoppable", "stoppable", booleanAttribute], showAssistantContextMenu: [2, "showAssistantContextMenu", "showAssistantContextMenu", booleanAttribute], showAssistantMessageFeedback: [2, "showAssistantMessageFeedback", "showAssistantMessageFeedback", booleanAttribute], authKey: "authKey", authToken: "authToken", apiUrl: "apiUrl", appServer: "appServer", includePublicDatasets: [2, "includePublicDatasets", "includePublicDatasets", booleanAttribute], flagOpendata: [2, "flagOpendata", "flagOpendata", booleanAttribute], hideDatasetButton: [2, "hideDatasetButton", "hideDatasetButton", booleanAttribute], hideDatasetIcons: [2, "hideDatasetIcons", "hideDatasetIcons", booleanAttribute], disableDatasetModification: [2, "disableDatasetModification", "disableDatasetModification", booleanAttribute], hideSelectedDatasets: [2, "hideSelectedDatasets", "hideSelectedDatasets", booleanAttribute], hideAgents: [2, "hideAgents", "hideAgents", booleanAttribute], disableColumnMentions: [2, "disableColumnMentions", "disableColumnMentions", booleanAttribute], requireDataset: [2, "requireDataset", "requireDataset", booleanAttribute], allowImages: [2, "allowImages", "allowImages", booleanAttribute], allowVoiceInput: [2, "allowVoiceInput", "allowVoiceInput", booleanAttribute], acceptedFileTypes: "acceptedFileTypes", uploadAttachments: "uploadAttachments", agent: "agent", agentConfig: "agentConfig", agentId: "agentId", task: "task", modelPreference: "modelPreference", chatSession: "chatSession", conversationId: "conversationId", chart: "chart", dashboard: "dashboard", customItem: "customItem", currentScreenMode: "currentScreenMode", localeId: "localeId", timezoneId: "timezoneId", apiVersion: "apiVersion", stream: [2, "stream", "stream", booleanAttribute], loadingMessage: "loadingMessage", cancelledMessage: "cancelledMessage", initialPrompt: "initialPrompt", emptyStateTitle: "emptyStateTitle", emptyStateSubtitle: "emptyStateSubtitle", emptyStateSuggestions: "emptyStateSuggestions", size: "size" }, outputs: { luzmoMessageSent: "luzmoMessageSent", luzmoDatasetsChanged: "luzmoDatasetsChanged", luzmoStep: "luzmoStep", luzmoComplete: "luzmoComplete", luzmoStop: "luzmoStop", luzmoConversationIdChanged: "luzmoConversationIdChanged", luzmoAssistantMessageAction: "luzmoAssistantMessageAction", luzmoAssistantMessageFeedback: "luzmoAssistantMessageFeedback" }, exportAs: ["luzmoAiChat"], features: [i0.ɵɵNgOnChangesFeature], ngContentSelectors: _c0, decls: 1, vars: 0, template: function LuzmoAiChat_Template(rf, ctx) { if (rf & 1) {
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: LuzmoAiChat, selectors: [["luzmo-ai-chat"]], inputs: { messages: "messages", selectedDatasets: "selectedDatasets", placeholder: "placeholder", disabled: [2, "disabled", "disabled", booleanAttribute], stoppable: [2, "stoppable", "stoppable", booleanAttribute], showAssistantContextMenu: [2, "showAssistantContextMenu", "showAssistantContextMenu", booleanAttribute], showAssistantMessageFeedback: [2, "showAssistantMessageFeedback", "showAssistantMessageFeedback", booleanAttribute], authKey: "authKey", authToken: "authToken", apiUrl: "apiUrl", appServer: "appServer", includePublicDatasets: [2, "includePublicDatasets", "includePublicDatasets", booleanAttribute], flagOpendata: [2, "flagOpendata", "flagOpendata", booleanAttribute], hideDatasetButton: [2, "hideDatasetButton", "hideDatasetButton", booleanAttribute], hideDatasetIcons: [2, "hideDatasetIcons", "hideDatasetIcons", booleanAttribute], disableDatasetModification: [2, "disableDatasetModification", "disableDatasetModification", booleanAttribute], hideSelectedDatasets: [2, "hideSelectedDatasets", "hideSelectedDatasets", booleanAttribute], hideAgents: [2, "hideAgents", "hideAgents", booleanAttribute], disableColumnMentions: [2, "disableColumnMentions", "disableColumnMentions", booleanAttribute], requireDataset: [2, "requireDataset", "requireDataset", booleanAttribute], allowImages: [2, "allowImages", "allowImages", booleanAttribute], allowVoiceInput: [2, "allowVoiceInput", "allowVoiceInput", booleanAttribute], acceptedFileTypes: "acceptedFileTypes", uploadAttachments: "uploadAttachments", agent: "agent", agentConfig: "agentConfig", agentId: "agentId", task: "task", modelPreference: "modelPreference", interactions: "interactions", chatSession: "chatSession", conversationId: "conversationId", chart: "chart", dashboard: "dashboard", customItem: "customItem", currentScreenMode: "currentScreenMode", localeId: "localeId", timezoneId: "timezoneId", apiVersion: "apiVersion", stream: [2, "stream", "stream", booleanAttribute], loadingMessage: "loadingMessage", cancelledMessage: "cancelledMessage", initialPrompt: "initialPrompt", emptyStateTitle: "emptyStateTitle", emptyStateSubtitle: "emptyStateSubtitle", emptyStateSuggestions: "emptyStateSuggestions", size: "size" }, outputs: { luzmoMessageSent: "luzmoMessageSent", luzmoDatasetsChanged: "luzmoDatasetsChanged", luzmoStep: "luzmoStep", luzmoComplete: "luzmoComplete", luzmoStop: "luzmoStop", luzmoConversationIdChanged: "luzmoConversationIdChanged", luzmoAssistantMessageAction: "luzmoAssistantMessageAction", luzmoAssistantMessageFeedback: "luzmoAssistantMessageFeedback" }, exportAs: ["luzmoAiChat"], features: [i0.ɵɵNgOnChangesFeature], ngContentSelectors: _c0, decls: 1, vars: 0, template: function LuzmoAiChat_Template(rf, ctx) { if (rf & 1) {
             i0.ɵɵprojectionDef();
             i0.ɵɵprojection(0);
         } }, encapsulation: 2 });
@@ -422,6 +427,9 @@ export class LuzmoAiChat {
         }], modelPreference: [{
             type: Input,
             args: [{ alias: 'modelPreference' }]
+        }], interactions: [{
+            type: Input,
+            args: [{ alias: 'interactions' }]
         }], chatSession: [{
             type: Input,
             args: [{ alias: 'chatSession' }]

package/angular/esm/components/display-settings-period-over-period.d.ts

@@ -2,7 +2,7 @@ import { OnChanges, SimpleChanges } from '@angular/core';
 import '@luzmo/analytics-components-kit/display-settings-period-over-period';
 import type { LuzmoDisplaySettingsPeriodOverPeriod as LuzmoDisplaySettingsPeriodOverPeriodHostElement, DisplaySettingsSlotContentChangedEventDetail } from '@luzmo/analytics-components-kit/display-settings-period-over-period';
 import type { PeriodOverPeriodCondition } from '@luzmo/analytics-components-kit/types';
-import type { Column } from '@luzmo/dashboard-contents-types';
+import type { Column, VizItemSlot, VizItemType } from '@luzmo/dashboard-contents-types';
 import * as i0 from "@angular/core";
 export type { DisplaySettingsSlotContentChangedEventDetail } from '@luzmo/analytics-components-kit/display-settings-period-over-period';
 export declare class LuzmoDisplaySettingsPeriodOverPeriod implements OnChanges {
@@ -13,13 +13,19 @@ export declare class LuzmoDisplaySettingsPeriodOverPeriod implements OnChanges {
     private readonly listenerCleanup;
     /** The underlying custom element instance. Use to call imperative methods. */
     get nativeElement(): LuzmoDisplaySettingsPeriodOverPeriodHostElement;
+    /** Full saved slots for deriving comparison levels and implicit datetime offsets. */
+    slotsContents?: VizItemSlot[];
+    /** Visualization type used to interpret comparison slot context. */
+    itemType?: VizItemType;
+    /** Whether a comparison filter currently applies to this item. Runtime only; never saved in slot contents. */
+    hasConnectedComparisonFilter?: boolean;
     /** The slotContent that is passed to the settings */
     slotContent?: any;
-    /** Which period-over-period UI variant to render, based on available datetime columns and comparison filters. */
+    /** Optional UI variant supplied by a parent. When absent, derive it from runtime slot and filter context. */
     periodOverPeriodUiType?: PeriodOverPeriodCondition;
-    /** Offer the "Periods" offset when there is no datetime category (an offset date column is needed). The item then shifts by the length of the period selected by its date filters. */
+    /** Offer the "Periods" offset when there is no datetime category (an offset date column is needed). The item then shifts by the length of the period selected by its date filters. Defaults to true for KPIs, false otherwise. */
     allowPeriodsWithoutDatetimeColumn?: boolean;
-    /** Hide the "Past value" comparison type, e.g. for items that only show the change. */
+    /** Hide the "Past value" comparison type. Defaults to true for KPIs, false otherwise; explicit booleans override the default. */
     hidePastValue?: boolean;
     /** Datetime columns from the linked dataset available as offset/comparison date columns. */
     linkedDatasetDatetimeColumns?: (Column & {
@@ -42,7 +48,8 @@ export declare class LuzmoDisplaySettingsPeriodOverPeriod implements OnChanges {
     private setHostProperty;
     private bindEvents;
     static ɵfac: i0.ɵɵFactoryDeclaration<LuzmoDisplaySettingsPeriodOverPeriod, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LuzmoDisplaySettingsPeriodOverPeriod, "luzmo-display-settings-period-over-period", ["luzmoDisplaySettingsPeriodOverPeriod"], { "slotContent": { "alias": "slotContent"; "required": false; }; "periodOverPeriodUiType": { "alias": "periodOverPeriodType"; "required": false; }; "allowPeriodsWithoutDatetimeColumn": { "alias": "allowPeriodsWithoutDatetimeColumn"; "required": false; }; "hidePastValue": { "alias": "hidePastValue"; "required": false; }; "linkedDatasetDatetimeColumns": { "alias": "linkedDatasetDatetimeColumns"; "required": false; }; "language": { "alias": "language"; "required": false; }; "size": { "alias": "size"; "required": false; }; }, { "luzmoSlotContentChanged": "luzmoSlotContentChanged"; }, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LuzmoDisplaySettingsPeriodOverPeriod, "luzmo-display-settings-period-over-period", ["luzmoDisplaySettingsPeriodOverPeriod"], { "slotsContents": { "alias": "slotsContents"; "required": false; }; "itemType": { "alias": "itemType"; "required": false; }; "hasConnectedComparisonFilter": { "alias": "hasConnectedComparisonFilter"; "required": false; }; "slotContent": { "alias": "slotContent"; "required": false; }; "periodOverPeriodUiType": { "alias": "periodOverPeriodType"; "required": false; }; "allowPeriodsWithoutDatetimeColumn": { "alias": "allowPeriodsWithoutDatetimeColumn"; "required": false; }; "hidePastValue": { "alias": "hidePastValue"; "required": false; }; "linkedDatasetDatetimeColumns": { "alias": "linkedDatasetDatetimeColumns"; "required": false; }; "language": { "alias": "language"; "required": false; }; "size": { "alias": "size"; "required": false; }; }, { "luzmoSlotContentChanged": "luzmoSlotContentChanged"; }, never, ["*"], true, never>;
+    static ngAcceptInputType_hasConnectedComparisonFilter: unknown;
     static ngAcceptInputType_allowPeriodsWithoutDatetimeColumn: unknown;
     static ngAcceptInputType_hidePastValue: unknown;
 }