@luzmo/analytics-components-kit 1.0.8-beta.1 → 1.0.8-beta.3

package/custom-elements.json

@@ -634,12 +634,23 @@
             },
             {
               "kind": "field",
-              "name": "flagOpendata",
+              "name": "includePublicDatasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "attribute": "include-public-datasets",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "flagOpendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "attribute": "flag-opendata"
             },
             {
@@ -1495,12 +1506,21 @@
               "fieldName": "appServer"
             },
             {
-              "name": "flag-opendata",
+              "name": "include-public-datasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "fieldName": "includePublicDatasets"
+            },
+            {
+              "name": "flag-opendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "fieldName": "flagOpendata"
             },
             {
@@ -3126,12 +3146,23 @@
             },
             {
               "kind": "field",
-              "name": "flagOpendata",
+              "name": "includePublicDatasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "attribute": "include-public-datasets",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "flagOpendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "attribute": "flag-opendata"
             },
             {
@@ -3621,12 +3652,21 @@
               "fieldName": "appServer"
             },
             {
-              "name": "flag-opendata",
+              "name": "include-public-datasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "fieldName": "includePublicDatasets"
+            },
+            {
+              "name": "flag-opendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "fieldName": "flagOpendata"
             },
             {
@@ -5558,12 +5598,23 @@
             },
             {
               "kind": "field",
-              "name": "flagOpendata",
+              "name": "includePublicDatasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "attribute": "include-public-datasets",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "flagOpendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "attribute": "flag-opendata"
             },
             {
@@ -5786,12 +5837,21 @@
               "fieldName": "appServer"
             },
             {
-              "name": "flag-opendata",
+              "name": "include-public-datasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "fieldName": "includePublicDatasets"
+            },
+            {
+              "name": "flag-opendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "fieldName": "flagOpendata"
             }
           ],
@@ -5891,12 +5951,23 @@
             },
             {
               "kind": "field",
-              "name": "flagOpendata",
+              "name": "includePublicDatasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "attribute": "include-public-datasets",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "flagOpendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "attribute": "flag-opendata"
             },
             {
@@ -6090,12 +6161,21 @@
               "fieldName": "appServer"
             },
             {
-              "name": "flag-opendata",
+              "name": "include-public-datasets",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When true, restricts results to public datasets (opendata parity)",
+              "description": "When true, shows public datasets alongside the user's other datasets.",
+              "fieldName": "includePublicDatasets"
+            },
+            {
+              "name": "flag-opendata",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Alias for includePublicDatasets.",
+              "deprecated": "Use includePublicDatasets instead.",
               "fieldName": "flagOpendata"
             },
             {
@@ -8102,6 +8182,22 @@
               "description": "Gap between the field, expression and value controls of a filter row.",
               "name": "--luzmo-filter-item-gap"
             },
+            {
+              "description": "Width of the data field column. Defaults to its content width.",
+              "name": "--luzmo-filter-item-field-width"
+            },
+            {
+              "description": "Width of the expression column. Defaults to its content width.",
+              "name": "--luzmo-filter-item-expression-width"
+            },
+            {
+              "description": "Width of the value and parameter button cell. Defaults to its content width.",
+              "name": "--luzmo-filter-item-value-width"
+            },
+            {
+              "description": "Whether the value cell absorbs remaining row width. Set to `1` to grow; defaults to `0`.",
+              "name": "--luzmo-filter-item-value-grow"
+            },
             {
               "description": "Smallest width the data field select may shrink to in a narrow filter row.",
               "name": "--luzmo-filter-item-field-min-width"
@@ -9066,8 +9162,12 @@
               "name": "--luzmo-filter-value-picker-datetime-gap"
             },
             {
-              "description": "Wrap floor for each control of a relative range before they move onto separate lines.",
+              "description": "Width the unit picker of a relative range asks for before it has to shrink.",
               "name": "--luzmo-filter-value-picker-datetime-control-min-width"
+            },
+            {
+              "description": "Width the quantity field of a relative range asks for before it has to shrink.",
+              "name": "--luzmo-filter-value-picker-datetime-quantity-width"
             }
           ],
           "members": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luzmo/analytics-components-kit",
-  "version": "1.0.8-beta.1",
+  "version": "1.0.8-beta.3",
   "type": "module",
   "main": "./components/index.js",
   "module": "./components/index.js",
@@ -349,7 +349,7 @@
     "@codemirror/commands": "^6.10.3",
     "@codemirror/state": "^6.6.0",
     "@codemirror/view": "^6.43.1",
-    "@luzmo/dashboard-contents-types": "1.0.39",
+    "@luzmo/dashboard-contents-types": "1.0.42",
     "@tanstack/query-core": "^5.90.5",
     "dompurify": "^3.4.12",
     "gridstack": "^12.3.3",

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.8-beta.1"
+    "@luzmo/analytics-components-kit": "^1.0.8-beta.3"
   },
-  "version": "1.0.8-beta.1"
+  "version": "1.0.8-beta.3"
 }

package/utils/data-broker/index.d.ts

@@ -112,6 +112,21 @@ export interface PerformanceMetrics {
     processing: number;
     rows: number;
 }
+type DataQuery = {
+    dimensions?: any[];
+    measures?: any[];
+    where?: any[];
+    order?: any[];
+    limit?: {
+        by: number;
+        offset: number;
+    };
+    options?: any;
+};
+type DataResult = {
+    data: any[][];
+    performance: PerformanceMetrics;
+};
 /**
  * DataBroker service for Luzmo API
  * Provides methods to fetch and manipulate data from Luzmo REST API
@@ -197,20 +212,11 @@ export declare class DataBroker {
      * @param queryParams - Query parameters (filters, sort, etc.)
      * @returns Dataset data
      */
-    fetchData(query: {
-        dimensions?: any[];
-        measures?: any[];
-        where?: any[];
-        order?: any[];
-        limit?: {
-            by: number;
-            offset: number;
-        };
-        options?: any;
-    }): Promise<{
-        data: any[][];
-        performance: PerformanceMetrics;
-    }>;
+    fetchData(query: DataQuery): Promise<DataResult>;
+    /**
+     * Returns fresh data already held by the query cache without starting a request.
+     */
+    getCachedData(query: DataQuery): DataResult | undefined;
     /**
      * Validates a column or formula expression against the Luzmo API.
      *

package/utils/set-nested-value.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Immutably set a value at a dot-delimited object path.
+ * Numeric path segments preserve or create arrays; missing, primitive, and null
+ * intermediate values are replaced with the container needed by the next segment.
+ */
+export declare const setNestedValue: (object: Record<string, unknown>, path: string, value: unknown) => Record<string, unknown>;

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

@@ -150,10 +150,6 @@ export declare abstract class BaseStore<TState> {
      * Deep clone a value using structuredClone
      */
     protected clone<T>(value: T): T;
-    /**
-     * Set a nested value in an object using dot notation path
-     */
-    protected setNestedValue(obj: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>;
     /**
      * Execute a function within a transaction with local origin
      * This ensures changes are tracked by the undo manager

package/angular/README.md

@@ -1,40 +0,0 @@
-# Luzmo Analytics Components Kit - Angular Wrappers
-
-> Standalone Angular wrapper components for the Luzmo Analytics Components Kit web components
-
-This package provides Angular wrappers for the Luzmo Analytics Components Kit web components.
-
-## Installation
-
-```bash
-npm install @luzmo/ngx-analytics-components-kit @luzmo/analytics-components-kit @angular/core @angular/forms
-```
-
-## Requirements
-
-- Angular `>= 17.3` (the wrappers use the functional `output()` API).
-- The peer package `@luzmo/analytics-components-kit` provides the underlying
-  custom-element classes that the wrappers register at import time.
-
-## Usage
-
-```ts
-import { Component } from '@angular/core';
-import { LuzmoDataField } from '@luzmo/ngx-analytics-components-kit';
-
-@Component({
-  selector: 'app-root',
-  standalone: true,
-  imports: [LuzmoDataField],
-  template: `<luzmo-data-field></luzmo-data-field>`
-})
-export class AppComponent {}
-```
-
-The wrapper class name mirrors the host element (`LuzmoDataField`); the
-underlying `HTMLElement` subclass type is re-exported as
-`LuzmoDataFieldElement` for `@ViewChild` / `ElementRef<T>` use cases.
-
-## Notes
-
-- This package depends on `@luzmo/analytics-components-kit` for the underlying custom elements.

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

@@ -1,98 +0,0 @@
-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, 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, BuildAiDictationRequestOptions, 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',
-  exportAs: 'luzmoAiChatEmptyState',
-  standalone: true,
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  template: '<ng-content />'
-})
-/**
- * Angular wrapper component for <luzmo-ai-chat-empty-state>
- */
-export class LuzmoAiChatEmptyState implements OnChanges {
-  private readonly elementRef = inject<ElementRef<LuzmoAiChatEmptyStateHostElement>>(ElementRef);
-  private readonly renderer = inject<Renderer2>(Renderer2);
-  private readonly destroyRef = inject<DestroyRef>(DestroyRef);
-  private readonly host = this.elementRef.nativeElement;
-  private readonly listenerCleanup: Array<() => void> = [];
-
-  /** The underlying custom element instance. Use to call imperative methods. */
-  get nativeElement(): LuzmoAiChatEmptyStateHostElement {
-    return this.host;
-  }
-
-  /** Heading shown above the suggestions. */
-  @Input({ alias: 'title' })
-  title?: string;
-
-  /** Supporting text shown above suggestion chips when `suggestions` is non-empty. */
-  @Input({ alias: 'subtitle' })
-  subtitle?: string;
-
-  /** Suggestion chips rendered with https://lucero.luzmo.com/ | Lucero `luzmo-action-button` (`variant="accent"`). */
-  @Input({ alias: 'suggestions' })
-  suggestions?: AiChatEmptyStateSuggestion[];
-
-  /** When true, suggestion chips cannot be activated. */
-  @Input({ alias: 'disabled', transform: booleanAttribute })
-  disabled?: boolean;
-
-  /** Fired when the user selects a suggestion chip */
-  readonly luzmoSuggestionSelected = output<CustomEvent<AiChatEmptyStateSuggestionSelectedDetail>>({ alias: 'luzmoSuggestionSelected' });
-
-  constructor() {
-    this.bindEvents();
-    this.destroyRef.onDestroy(() => {
-      for (const cleanup of this.listenerCleanup) {
-        cleanup();
-      }
-    });
-  }
-
-  ngOnChanges(changes: SimpleChanges): void {
-    for (const key of Object.keys(changes)) {
-      switch (key) {
-        case 'title':
-          this.setHostProperty('title', changes['title'].currentValue);
-          break;
-        case 'subtitle':
-          this.setHostProperty('subtitle', changes['subtitle'].currentValue);
-          break;
-        case 'suggestions':
-          this.setHostProperty('suggestions', changes['suggestions'].currentValue);
-          break;
-        case 'disabled':
-          this.setHostProperty('disabled', changes['disabled'].currentValue);
-          break;
-        default:
-          break;
-      }
-    }
-  }
-
-  /**
-   * Forward a wrapper @Input to the underlying host element via Renderer2 so
-   * the wrapper stays compatible with non-DOM Angular platforms (SSR, tests).
-   * Unlike a "skip undefined" guard, this lets consumers reset values back to
-   * undefined / null by clearing their bindings.
-   */
-  private setHostProperty(key: string, value: unknown): void {
-    this.renderer.setProperty(this.host, key, value);
-  }
-
-  private bindEvents(): void {
-    this.listenerCleanup.push(
-      this.renderer.listen(this.host, 'luzmo-suggestion-selected', (event: Event) => {
-        const typed = event as CustomEvent<AiChatEmptyStateSuggestionSelectedDetail>;
-        this.luzmoSuggestionSelected.emit(typed);
-      })
-    );
-  }
-}
-
-/** The underlying custom element type for LuzmoAiChatEmptyState */
-export type LuzmoAiChatEmptyStateElement = LuzmoAiChatEmptyStateHostElement;