@luzmo/analytics-components-kit 1.0.1-alpha.124 → 1.0.1-alpha.127

package/README.md

@@ -26,6 +26,7 @@ npm install @luzmo/analytics-components-kit
   - [Layout Components](#layout-components)
   - [Edit Components](#edit-components)
 - [Utilities](#utilities)
+- [Types](#types)
 - [Usage: Drag & Drop Data Flow](#usage-drag-drop-data-flow)
   - [Concept](#concept)
   - [Example Implementation](#example-implementation)
@@ -134,6 +135,20 @@ const chartFilters = transformFilters(filterGroup);
 const chartOptions = itemTypes.map((item) => ({ label: item.label, value: item.type }));
 ```
 
+## Types
+
+Import TypeScript types from the dedicated entrypoint:
+
+```typescript
+import type { DatasetDataField, SlotConfiguration, SlotContentsChangedEventDetail } from '@luzmo/analytics-components-kit/types';
+```
+
+Runtime values are exported from the main package (or via `@luzmo/analytics-components-kit/utils`):
+
+```typescript
+import { PeriodOverPeriodCondition } from '@luzmo/analytics-components-kit';
+```
+
 ## Usage: Drag & Drop Data Flow
 
 This library provides a complete drag-and-drop system for building Luzmo chart configurations. The flow consists of loading dataset columns/formulas as draggable items and dropping them into chart slots.

package/angular/README.md

@@ -16,15 +16,12 @@ pnpm add @luzmo/analytics-components-kit @luzmo/analytics-components-kit-angular
 
 ```ts
 import { bootstrapApplication } from '@angular/platform-browser';
-import { AiChatMessageAssistantComponent } from '@luzmo/analytics-components-kit-angular';
+import { AiInteractionTextareaComponent } from '@luzmo/analytics-components-kit-angular';
 
-bootstrapApplication(AiChatMessageAssistantComponent);
+bootstrapApplication(AiInteractionTextareaComponent);
 ```
 
 ## Available components
-- `AiChatMessageAssistantComponent` → <luzmo-ai-chat-message-assistant>
-- `AiChatMessageUserComponent` → <luzmo-ai-chat-message-user>
-- `AiChatMessagesContainerComponent` → <luzmo-ai-chat-messages-container>
 - `AiInteractionTextareaComponent` → <luzmo-ai-interaction-textarea>
 - `DatasetIconComponent` → <luzmo-dataset-icon>
 - `DatasetSelectorListComponent` → <luzmo-dataset-selector-list>

package/angular/components/dataset-icon/types.ts

@@ -0,0 +1,8 @@
+export interface DatasetIcon {
+  subtype: string;
+  account?: {
+    plugin?: {
+      thumbnails?: { url: string; size: string }[];
+    };
+  };
+}

package/angular/components/draggable-data-field/types.ts

@@ -1,4 +1,4 @@
-import type { DatasetDataField } from '../../types/dataset-data-field';
+import type { DatasetDataField } from '../../types/dataset-data-field.types';
 
 export type DatasetDataFieldWithSublevel = DatasetDataField & {
   sublevelLabel?: string;

package/angular/components/draggable-data-fields-panel/types.ts

@@ -1,4 +1,4 @@
-import type { DatasetDataField } from '../../types/dataset-data-field';
+import type { DatasetDataField } from '../../types/dataset-data-field.types';
 
 /**
  * Dataset with data fields (columns and formulas) for the panel.
@@ -19,20 +19,6 @@ export interface DatasetDataFields {
   dataFields?: DatasetDataField[];
 }
 
-/**
- * Event detail emitted when a data field is dropped from the panel
- */
-export interface DataFieldDroppedEventDetail {
-  data: DatasetDataField;
-}
-
-/**
- * Event detail emitted when a data field drag starts from the panel
- */
-export interface DataFieldDragStartedEventDetail {
-  data: DatasetDataField;
-}
-
 /**
  * Event detail emitted when the selected dataset changes
  */

package/angular/components/droppable-slot/types.ts

@@ -1 +1,6 @@
-export type { SlotConfiguration, SlotContentsChangedEventDetail } from '../../types';
+import type { GenericSlotContent } from '@luzmo/dashboard-contents-types';
+
+export interface SlotContentsChangedEventDetail {
+  slotContents: GenericSlotContent[];
+  linkedDatasetsIds: string[];
+}

package/angular/components/edit-filters/types.ts

@@ -1,6 +1,6 @@
 export interface FilterCondition {
   expression?: string;
-  parameters?: any[];
+  parameters?: unknown[];
 }
 
 export interface FilterGroup {

package/angular/components/grid/types.ts

@@ -0,0 +1,46 @@
+import type { IconDefinition } from '@luzmo/icons';
+import type { Placement } from '@luzmo/lucero';
+import type { TemplateResult } from 'lit';
+import type { VizItemType } from '@luzmo/dashboard-contents-types';
+
+export type DefaultActionType = 'lock' | 'filters' | 'edit' | 'edit-data' | 'edit-options' | 'edit-filters' | 'delete' | 'clone';
+
+export interface Action {
+  icon?: IconDefinition;
+  label?: string;
+  action?: string | DefaultActionType;
+  type?: 'toggle' | 'button';
+  active?: boolean;
+  tooltip?: string;
+}
+
+export interface InputActionGroup {
+  type: 'group';
+  actions: (string | Action)[];
+}
+
+export interface ActionGroup {
+  type: 'group';
+  actions?: Action[];
+}
+
+export interface GridItemData {
+  id?: string;
+  type: VizItemType | string;
+  placementActionsMenu?: Placement;
+  actionsMenu?: InputActionGroup[];
+  position?: {
+    sizeX: number;
+    sizeY: number;
+    row: number;
+    col: number;
+  };
+  options?: Record<string, unknown>;
+  slots?: unknown;
+  filters?: unknown[];
+  contextId?: string;
+  canFilter?: string | string[];
+  renderer?: string;
+}
+
+export type GridItemRenderer = (item: GridItemData, index: number) => TemplateResult;

package/angular/components/item-data-picker-panel.component.ts

@@ -1,5 +1,5 @@
 import { Component, Input, Output, EventEmitter, ChangeDetectionStrategy } from '@angular/core';
-import type { VizItemType, SlotConfiguration, VizItemSlots, Placement } from '../types';
+import type { VizItemType, SlotConfiguration, VizItemSlots, DatasetsDataFields, DatasetMetadata, Placement } from '../types';
 
 @Component({
   selector: 'luzmo-item-data-picker-panel',
@@ -45,13 +45,7 @@ export class ItemDataPickerPanelComponent {
   @Input() dataFieldsSearch?: 'on' | 'off' | 'auto';
   @Input() datasetSearch?: 'on' | 'off' | 'auto';
   @Input() icons?: 'none' | 'menu-only' | 'all';
-  @Input() datasetsDataFields?: {
-    id: string;
-    name: { [key: string]: string };
-    description?: { [key: string]: string };
-    columns: any[];
-    formulas: any[];
-  }[];
+  @Input() datasetsDataFields?: Array<DatasetsDataFields & Pick<DatasetMetadata, 'description'>>;
   @Input() datasetIds?: string[];
   @Input() selectedDatasetId?: string;
   @Input() datasetPicker?: boolean;

package/angular/components/slot-menu/types.ts

@@ -2,8 +2,6 @@ import { GenericSlotContent } from '@luzmo/dashboard-contents-types';
 import { DatasetColumnMetadata } from '@utils/data-broker';
 import type { SlotContentsChangedEventDetail } from '../droppable-slot/types';
 
-export type { SlotContentsChangedEventDetail } from '../droppable-slot/types';
-
 export interface MeasureColumnsItem {
   datasetId: string;
   datasetName: Record<string, string>;

package/angular/components/viz-item-menu/types.ts

@@ -0,0 +1 @@
+export type VizItemMenuButton = 'clone' | 'edit' | 'delete';

package/angular/esm/components/dataset-icon/types.d.ts

@@ -0,0 +1,11 @@
+export interface DatasetIcon {
+    subtype: string;
+    account?: {
+        plugin?: {
+            thumbnails?: {
+                url: string;
+                size: string;
+            }[];
+        };
+    };
+}

package/angular/esm/components/draggable-data-field/types.d.ts

@@ -1,4 +1,4 @@
-import type { DatasetDataField } from '../../types/dataset-data-field';
+import type { DatasetDataField } from '../../types/dataset-data-field.types';
 export type DatasetDataFieldWithSublevel = DatasetDataField & {
     sublevelLabel?: string;
 };

package/angular/esm/components/draggable-data-fields-panel/types.d.ts

@@ -1,4 +1,4 @@
-import type { DatasetDataField } from '../../types/dataset-data-field';
+import type { DatasetDataField } from '../../types/dataset-data-field.types';
 /**
  * Dataset with data fields (columns and formulas) for the panel.
  * Supports two formats:
@@ -19,18 +19,6 @@ export interface DatasetDataFields {
     /** Combined data fields (from loadDataFieldsForDatasets) */
     dataFields?: DatasetDataField[];
 }
-/**
- * Event detail emitted when a data field is dropped from the panel
- */
-export interface DataFieldDroppedEventDetail {
-    data: DatasetDataField;
-}
-/**
- * Event detail emitted when a data field drag starts from the panel
- */
-export interface DataFieldDragStartedEventDetail {
-    data: DatasetDataField;
-}
 /**
  * Event detail emitted when the selected dataset changes
  */

package/angular/esm/components/droppable-slot/types.d.ts

@@ -1 +1,5 @@
-export type { SlotConfiguration, SlotContentsChangedEventDetail } from '../../types';
+import type { GenericSlotContent } from '@luzmo/dashboard-contents-types';
+export interface SlotContentsChangedEventDetail {
+    slotContents: GenericSlotContent[];
+    linkedDatasetsIds: string[];
+}

package/angular/esm/components/edit-filters/types.d.ts

@@ -1,6 +1,6 @@
 export interface FilterCondition {
     expression?: string;
-    parameters?: any[];
+    parameters?: unknown[];
 }
 export interface FilterGroup {
     condition: 'AND' | 'OR';

package/angular/esm/components/grid/index.js

@@ -0,0 +1 @@
+export * from './types';

package/angular/esm/components/grid/types.d.ts

@@ -0,0 +1,40 @@
+import type { IconDefinition } from '@luzmo/icons';
+import type { Placement } from '@luzmo/lucero';
+import type { TemplateResult } from 'lit';
+import type { VizItemType } from '@luzmo/dashboard-contents-types';
+export type DefaultActionType = 'lock' | 'filters' | 'edit' | 'edit-data' | 'edit-options' | 'edit-filters' | 'delete' | 'clone';
+export interface Action {
+    icon?: IconDefinition;
+    label?: string;
+    action?: string | DefaultActionType;
+    type?: 'toggle' | 'button';
+    active?: boolean;
+    tooltip?: string;
+}
+export interface InputActionGroup {
+    type: 'group';
+    actions: (string | Action)[];
+}
+export interface ActionGroup {
+    type: 'group';
+    actions?: Action[];
+}
+export interface GridItemData {
+    id?: string;
+    type: VizItemType | string;
+    placementActionsMenu?: Placement;
+    actionsMenu?: InputActionGroup[];
+    position?: {
+        sizeX: number;
+        sizeY: number;
+        row: number;
+        col: number;
+    };
+    options?: Record<string, unknown>;
+    slots?: unknown;
+    filters?: unknown[];
+    contextId?: string;
+    canFilter?: string | string[];
+    renderer?: string;
+}
+export type GridItemRenderer = (item: GridItemData, index: number) => TemplateResult;

package/angular/esm/components/item-data-picker-panel.component.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from '@angular/core';
-import type { VizItemType, SlotConfiguration, VizItemSlots, Placement } from '../types';
+import type { VizItemType, SlotConfiguration, VizItemSlots, DatasetsDataFields, DatasetMetadata, Placement } from '../types';
 import * as i0 from "@angular/core";
 export declare class ItemDataPickerPanelComponent {
     itemType?: VizItemType | string;
@@ -11,17 +11,7 @@ export declare class ItemDataPickerPanelComponent {
     dataFieldsSearch?: 'on' | 'off' | 'auto';
     datasetSearch?: 'on' | 'off' | 'auto';
     icons?: 'none' | 'menu-only' | 'all';
-    datasetsDataFields?: {
-        id: string;
-        name: {
-            [key: string]: string;
-        };
-        description?: {
-            [key: string]: string;
-        };
-        columns: any[];
-        formulas: any[];
-    }[];
+    datasetsDataFields?: Array<DatasetsDataFields & Pick<DatasetMetadata, 'description'>>;
     datasetIds?: string[];
     selectedDatasetId?: string;
     datasetPicker?: boolean;

package/angular/esm/components/slot-menu/types.d.ts

@@ -1,7 +1,6 @@
 import { GenericSlotContent } from '@luzmo/dashboard-contents-types';
 import { DatasetColumnMetadata } from '@utils/data-broker';
 import type { SlotContentsChangedEventDetail } from '../droppable-slot/types';
-export type { SlotContentsChangedEventDetail } from '../droppable-slot/types';
 export interface MeasureColumnsItem {
     datasetId: string;
     datasetName: Record<string, string>;

package/angular/esm/components/viz-item-menu/index.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/angular/esm/components/viz-item-menu/index.js

@@ -0,0 +1 @@
+export * from './types';

package/angular/esm/components/viz-item-menu/types.d.ts

@@ -0,0 +1 @@
+export type VizItemMenuButton = 'clone' | 'edit' | 'delete';

package/angular/esm/index.d.ts

@@ -1,6 +1,3 @@
-import { AiChatMessageAssistantComponent } from './components/ai-chat-message-assistant.component';
-import { AiChatMessageUserComponent } from './components/ai-chat-message-user.component';
-import { AiChatMessagesContainerComponent } from './components/ai-chat-messages-container.component';
 import { AiInteractionTextareaComponent } from './components/ai-interaction-textarea.component';
 import { DatasetIconComponent } from './components/dataset-icon.component';
 import { DatasetSelectorListComponent } from './components/dataset-selector-list.component';
@@ -44,9 +41,6 @@ import { SlotContentsPickerComponent } from './components/slot-contents-picker.c
 import { SlotMenuComponent } from './components/slot-menu.component';
 import { SlotMenuListComponent } from './components/slot-menu-list.component';
 import { VizItemMenuComponent } from './components/viz-item-menu.component';
-export { AiChatMessageAssistantComponent } from './components/ai-chat-message-assistant.component';
-export { AiChatMessageUserComponent } from './components/ai-chat-message-user.component';
-export { AiChatMessagesContainerComponent } from './components/ai-chat-messages-container.component';
 export { AiInteractionTextareaComponent } from './components/ai-interaction-textarea.component';
 export { DatasetIconComponent } from './components/dataset-icon.component';
 export { DatasetSelectorListComponent } from './components/dataset-selector-list.component';
@@ -90,4 +84,4 @@ export { SlotContentsPickerComponent } from './components/slot-contents-picker.c
 export { SlotMenuComponent } from './components/slot-menu.component';
 export { SlotMenuListComponent } from './components/slot-menu-list.component';
 export { VizItemMenuComponent } from './components/viz-item-menu.component';
-export declare const LUZMO_COMPONENTS: readonly [typeof AiChatMessageAssistantComponent, typeof AiChatMessageUserComponent, typeof AiChatMessagesContainerComponent, typeof AiInteractionTextareaComponent, typeof DatasetIconComponent, typeof DatasetSelectorListComponent, typeof DatasetSelectorRowComponent, typeof DisplaySettingsComponent, typeof DisplaySettingsBinningComponent, typeof DisplaySettingsDatetimeComponent, typeof DisplaySettingsGrandTotalsComponent, typeof DisplaySettingsNumericComponent, typeof DisplaySettingsPeriodOverPeriodComponent, typeof DraggableDataFieldsPanelComponent, typeof DroppableSlotComponent, typeof EditFiltersComponent, typeof EditItemComponent, typeof EditOptionComponent, typeof EditOptionActionButtonGroupComponent, typeof EditOptionColorPalettePickerComponent, typeof EditOptionColorPickerComponent, typeof EditOptionColorRangeComponent, typeof EditOptionMultiLanguageFieldComponent, typeof EditOptionNumberFieldComponent, typeof EditOptionPickerComponent, typeof EditOptionPositionPickerComponent, typeof EditOptionPositionsNumberFieldComponent, typeof EditOptionRadioButtonGroupComponent, typeof EditOptionSliderComponent, typeof EditOptionSwitchComponent, typeof EditOptionTextFieldComponent, typeof FilterExpressionPickerComponent, typeof FilterItemComponent, typeof FilterParameterPickerComponent, typeof FilterValuePickerComponent, typeof FilterValuePickerDatetimeComponent, typeof FilterValuePickerHierarchyComponent, typeof FilterValuePickerNumericComponent, typeof GridComponent, typeof GridItemActionsMenuComponent, typeof ItemDataDropPanelComponent, typeof ItemDataPickerPanelComponent, typeof SlotContentsPickerComponent, typeof SlotMenuComponent, typeof SlotMenuListComponent, typeof VizItemMenuComponent];
+export declare const LUZMO_COMPONENTS: readonly [typeof AiInteractionTextareaComponent, typeof DatasetIconComponent, typeof DatasetSelectorListComponent, typeof DatasetSelectorRowComponent, typeof DisplaySettingsComponent, typeof DisplaySettingsBinningComponent, typeof DisplaySettingsDatetimeComponent, typeof DisplaySettingsGrandTotalsComponent, typeof DisplaySettingsNumericComponent, typeof DisplaySettingsPeriodOverPeriodComponent, typeof DraggableDataFieldsPanelComponent, typeof DroppableSlotComponent, typeof EditFiltersComponent, typeof EditItemComponent, typeof EditOptionComponent, typeof EditOptionActionButtonGroupComponent, typeof EditOptionColorPalettePickerComponent, typeof EditOptionColorPickerComponent, typeof EditOptionColorRangeComponent, typeof EditOptionMultiLanguageFieldComponent, typeof EditOptionNumberFieldComponent, typeof EditOptionPickerComponent, typeof EditOptionPositionPickerComponent, typeof EditOptionPositionsNumberFieldComponent, typeof EditOptionRadioButtonGroupComponent, typeof EditOptionSliderComponent, typeof EditOptionSwitchComponent, typeof EditOptionTextFieldComponent, typeof FilterExpressionPickerComponent, typeof FilterItemComponent, typeof FilterParameterPickerComponent, typeof FilterValuePickerComponent, typeof FilterValuePickerDatetimeComponent, typeof FilterValuePickerHierarchyComponent, typeof FilterValuePickerNumericComponent, typeof GridComponent, typeof GridItemActionsMenuComponent, typeof ItemDataDropPanelComponent, typeof ItemDataPickerPanelComponent, typeof SlotContentsPickerComponent, typeof SlotMenuComponent, typeof SlotMenuListComponent, typeof VizItemMenuComponent];

package/angular/esm/index.js

@@ -1,6 +1,3 @@
-import { AiChatMessageAssistantComponent } from './components/ai-chat-message-assistant.component';
-import { AiChatMessageUserComponent } from './components/ai-chat-message-user.component';
-import { AiChatMessagesContainerComponent } from './components/ai-chat-messages-container.component';
 import { AiInteractionTextareaComponent } from './components/ai-interaction-textarea.component';
 import { DatasetIconComponent } from './components/dataset-icon.component';
 import { DatasetSelectorListComponent } from './components/dataset-selector-list.component';
@@ -44,9 +41,6 @@ import { SlotContentsPickerComponent } from './components/slot-contents-picker.c
 import { SlotMenuComponent } from './components/slot-menu.component';
 import { SlotMenuListComponent } from './components/slot-menu-list.component';
 import { VizItemMenuComponent } from './components/viz-item-menu.component';
-export { AiChatMessageAssistantComponent } from './components/ai-chat-message-assistant.component';
-export { AiChatMessageUserComponent } from './components/ai-chat-message-user.component';
-export { AiChatMessagesContainerComponent } from './components/ai-chat-messages-container.component';
 export { AiInteractionTextareaComponent } from './components/ai-interaction-textarea.component';
 export { DatasetIconComponent } from './components/dataset-icon.component';
 export { DatasetSelectorListComponent } from './components/dataset-selector-list.component';
@@ -91,9 +85,6 @@ export { SlotMenuComponent } from './components/slot-menu.component';
 export { SlotMenuListComponent } from './components/slot-menu-list.component';
 export { VizItemMenuComponent } from './components/viz-item-menu.component';
 export const LUZMO_COMPONENTS = [
-    AiChatMessageAssistantComponent,
-    AiChatMessageUserComponent,
-    AiChatMessagesContainerComponent,
     AiInteractionTextareaComponent,
     DatasetIconComponent,
     DatasetSelectorListComponent,

package/angular/esm/types/data-field-events.types.d.ts

@@ -0,0 +1,7 @@
+import type { DatasetDataField } from './dataset-data-field.types';
+export interface DataFieldDroppedEventDetail {
+    data: DatasetDataField;
+}
+export interface DataFieldDragStartedEventDetail {
+    data: DatasetDataField;
+}

package/angular/esm/types/data-field-events.types.js

@@ -0,0 +1 @@
+export {};

package/angular/esm/types/dataset-data-field.types.js

@@ -0,0 +1 @@
+export {};

package/angular/esm/types/dataset.types.d.ts

@@ -0,0 +1,24 @@
+import type { DatasetMetadata } from '../utils/data-broker';
+export interface Dataset {
+    id: string;
+    name: string | Record<string, string>;
+    subtype?: string;
+    updated_at?: string;
+    collections?: {
+        id: string;
+        favorite: boolean;
+    }[];
+    account?: {
+        id: string;
+        provider: string;
+        name: string;
+        plugin?: {
+            id: string;
+            thumbnails?: {
+                url: string;
+                size: string;
+            }[];
+        };
+    };
+}
+export type DatasetsDataFields = Pick<DatasetMetadata, 'id' | 'name' | 'columns' | 'formulas'>;

package/angular/esm/types/dataset.types.js

@@ -0,0 +1 @@
+export {};

package/angular/esm/types/positioning.types.d.ts

@@ -0,0 +1,21 @@
+export interface GridConfig {
+    columns: number;
+    rows: number;
+    columnSizes?: string[];
+    rowSizes?: string[];
+    gap?: string;
+}
+export interface SlotPosition {
+    column: number;
+    row: number;
+    columnSpan?: number;
+    rowSpan?: number;
+    align?: 'start' | 'center' | 'end';
+    justify?: 'start' | 'center' | 'end';
+    rotate?: boolean;
+    padding?: string;
+}
+export interface SlotPositioningConfig {
+    grid: GridConfig;
+    slots: Record<string, SlotPosition>;
+}

package/angular/esm/types/positioning.types.js

@@ -0,0 +1 @@
+export {};

package/angular/esm/types/slot.types.d.ts

@@ -0,0 +1,23 @@
+import type { ColumnType, FormulaType, GenericSlotContent, SlotConfig, SlotName, VizItemSlots } from '@luzmo/dashboard-contents-types';
+export type SlotContent = GenericSlotContent;
+export type SlotConfiguration = Omit<SlotConfig, 'acceptableColumnTypes' | 'canAcceptMultipleColumns'> & {
+    acceptableDataFieldTypes?: (ColumnType | FormulaType)[];
+    canAcceptMultipleDataFields?: boolean;
+    keepOnlyFirstWhenOtherSlotFilled?: SlotConfig['name'][];
+    clearWhenOtherSlotHasMultipleItems?: SlotConfig['name'][];
+    canAcceptDataIndependentOf?: SlotConfig['name'][];
+    activeWhenSubtype?: string[];
+};
+export type SlotConstraintType = 'keepOnlyFirstWhenOtherSlotFilled' | 'clearWhenOtherSlotHasMultipleItems' | 'clearSlotsWhenUnlinkedDataset';
+export interface SlotConstraint {
+    type: SlotConstraintType;
+    affectedSlotName: string;
+    triggeredBySlotName: string;
+}
+export interface SlotConstraintTriggeredEventDetail {
+    triggerSlotName: SlotName;
+    proposedTriggerContents: SlotContent[];
+    originalSlotsContents: VizItemSlots;
+    proposedSlotsContents: VizItemSlots;
+    constraints: SlotConstraint[];
+}

package/angular/esm/types/slot.types.js

@@ -0,0 +1 @@
+export {};