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

package/angular/components/item-option-slider.ts

@@ -1,126 +0,0 @@
-import { ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Input, OnChanges, output, Renderer2, SimpleChanges } from '@angular/core';
-import '@luzmo/analytics-components-kit/item-option-slider';
-import type { LuzmoItemOptionSlider as LuzmoItemOptionSliderHostElement, ItemOptionChangedEventDetail } from '@luzmo/analytics-components-kit/item-option-slider';
-export type { ItemOptionChangedEventDetail } from '@luzmo/analytics-components-kit/item-option-slider';
-
-@Component({
-  selector: 'luzmo-item-option-slider',
-  exportAs: 'luzmoItemOptionSlider',
-  standalone: true,
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  template: '<ng-content />'
-})
-/**
- * Angular wrapper component for <luzmo-item-option-slider>
- */
-export class LuzmoItemOptionSlider implements OnChanges {
-  private readonly elementRef = inject<ElementRef<LuzmoItemOptionSliderHostElement>>(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(): LuzmoItemOptionSliderHostElement {
-    return this.host;
-  }
-
-  /** The current slider value. */
-  @Input({ alias: 'value' })
-  value?: number;
-
-  /** The default slider value used when no value is set. */
-  @Input({ alias: 'default' })
-  default?: number;
-
-  /** The minimum slider value. */
-  @Input({ alias: 'min' })
-  min?: number;
-
-  /** The maximum slider value. */
-  @Input({ alias: 'max' })
-  max?: number;
-
-  /** The increment between slider values. */
-  @Input({ alias: 'step' })
-  step?: number;
-
-  /** Delay in milliseconds before the change event is emitted after the user stops interacting. */
-  @Input({ alias: 'debounce' })
-  debounce?: number;
-
-  /** Optional transform applied to the stored value before it is displayed in the control. */
-  @Input({ alias: 'parseValue' })
-  parseValue?: unknown;
-
-  /** Optional transform applied to the control's value before it is emitted in the change event. */
-  @Input({ alias: 'toValue' })
-  toValue?: unknown;
-
-  /** Emitted when the option value changes. */
-  readonly luzmoOptionChanged = output<CustomEvent<ItemOptionChangedEventDetail>>({ alias: 'luzmoOptionChanged' });
-
-  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 'value':
-          this.setHostProperty('value', changes['value'].currentValue);
-          break;
-        case 'default':
-          this.setHostProperty('default', changes['default'].currentValue);
-          break;
-        case 'min':
-          this.setHostProperty('min', changes['min'].currentValue);
-          break;
-        case 'max':
-          this.setHostProperty('max', changes['max'].currentValue);
-          break;
-        case 'step':
-          this.setHostProperty('step', changes['step'].currentValue);
-          break;
-        case 'debounce':
-          this.setHostProperty('debounce', changes['debounce'].currentValue);
-          break;
-        case 'parseValue':
-          this.setHostProperty('parseValue', changes['parseValue'].currentValue);
-          break;
-        case 'toValue':
-          this.setHostProperty('toValue', changes['toValue'].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-option-changed', (event: Event) => {
-        const typed = event as CustomEvent<ItemOptionChangedEventDetail>;
-        this.luzmoOptionChanged.emit(typed);
-      })
-    );
-  }
-}
-
-/** The underlying custom element type for LuzmoItemOptionSlider */
-export type LuzmoItemOptionSliderElement = LuzmoItemOptionSliderHostElement;

package/angular/components/item-option-switch.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/item-option-switch';
-import type { LuzmoItemOptionSwitch as LuzmoItemOptionSwitchHostElement, ItemOptionChangedEventDetail } from '@luzmo/analytics-components-kit/item-option-switch';
-export type { ItemOptionChangedEventDetail } from '@luzmo/analytics-components-kit/item-option-switch';
-
-@Component({
-  selector: 'luzmo-item-option-switch',
-  exportAs: 'luzmoItemOptionSwitch',
-  standalone: true,
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  template: '<ng-content />'
-})
-/**
- * Angular wrapper component for <luzmo-item-option-switch>
- */
-export class LuzmoItemOptionSwitch implements OnChanges {
-  private readonly elementRef = inject<ElementRef<LuzmoItemOptionSwitchHostElement>>(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(): LuzmoItemOptionSwitchHostElement {
-    return this.host;
-  }
-
-  /** The current on/off state of the switch. */
-  @Input({ alias: 'value', transform: booleanAttribute })
-  value?: boolean;
-
-  /** The default on/off state used when no value is set. */
-  @Input({ alias: 'default', transform: booleanAttribute })
-  default?: boolean;
-
-  /** Optional transform applied to the stored value before it is displayed in the control. */
-  @Input({ alias: 'parseValue' })
-  parseValue?: unknown;
-
-  /** Optional transform applied to the control's value before it is emitted in the change event. */
-  @Input({ alias: 'toValue' })
-  toValue?: unknown;
-
-  /** Emitted when the option value changes. */
-  readonly luzmoOptionChanged = output<CustomEvent<ItemOptionChangedEventDetail>>({ alias: 'luzmoOptionChanged' });
-
-  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 'value':
-          this.setHostProperty('value', changes['value'].currentValue);
-          break;
-        case 'default':
-          this.setHostProperty('default', changes['default'].currentValue);
-          break;
-        case 'parseValue':
-          this.setHostProperty('parseValue', changes['parseValue'].currentValue);
-          break;
-        case 'toValue':
-          this.setHostProperty('toValue', changes['toValue'].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-option-changed', (event: Event) => {
-        const typed = event as CustomEvent<ItemOptionChangedEventDetail>;
-        this.luzmoOptionChanged.emit(typed);
-      })
-    );
-  }
-}
-
-/** The underlying custom element type for LuzmoItemOptionSwitch */
-export type LuzmoItemOptionSwitchElement = LuzmoItemOptionSwitchHostElement;

package/angular/components/item-option-text-field.ts

@@ -1,112 +0,0 @@
-import { booleanAttribute, ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Input, OnChanges, output, Renderer2, SimpleChanges } from '@angular/core';
-import '@luzmo/analytics-components-kit/item-option-text-field';
-import type { LuzmoItemOptionTextField as LuzmoItemOptionTextFieldHostElement, ItemOptionChangedEventDetail } from '@luzmo/analytics-components-kit/item-option-text-field';
-export type { ItemOptionChangedEventDetail } from '@luzmo/analytics-components-kit/item-option-text-field';
-
-@Component({
-  selector: 'luzmo-item-option-text-field',
-  exportAs: 'luzmoItemOptionTextField',
-  standalone: true,
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  template: '<ng-content />'
-})
-/**
- * Angular wrapper component for <luzmo-item-option-text-field>
- */
-export class LuzmoItemOptionTextField implements OnChanges {
-  private readonly elementRef = inject<ElementRef<LuzmoItemOptionTextFieldHostElement>>(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(): LuzmoItemOptionTextFieldHostElement {
-    return this.host;
-  }
-
-  /** Internal timer handle used to debounce change events. */
-  @Input({ alias: 'debounceTimeout' })
-  debounceTimeout?: any;
-
-  /** The current text value. */
-  @Input({ alias: 'value' })
-  value?: string;
-
-  /** Whether the control is shown in an invalid state. */
-  @Input({ alias: 'invalid', transform: booleanAttribute })
-  invalid?: boolean;
-
-  /** Whether the control is read-only. */
-  @Input({ alias: 'readonly', transform: booleanAttribute })
-  readonly?: boolean;
-
-  /** Placeholder text shown when the field is empty. */
-  @Input({ alias: 'placeholder' })
-  placeholder?: string;
-
-  /** Delay in milliseconds before the change event is emitted after the user stops interacting. */
-  @Input({ alias: 'debounce' })
-  debounce?: number;
-
-  /** Emitted when the option value changes. */
-  readonly luzmoOptionChanged = output<CustomEvent<ItemOptionChangedEventDetail>>({ alias: 'luzmoOptionChanged' });
-
-  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 'debounceTimeout':
-          this.setHostProperty('debounceTimeout', changes['debounceTimeout'].currentValue);
-          break;
-        case 'value':
-          this.setHostProperty('value', changes['value'].currentValue);
-          break;
-        case 'invalid':
-          this.setHostProperty('invalid', changes['invalid'].currentValue);
-          break;
-        case 'readonly':
-          this.setHostProperty('readonly', changes['readonly'].currentValue);
-          break;
-        case 'placeholder':
-          this.setHostProperty('placeholder', changes['placeholder'].currentValue);
-          break;
-        case 'debounce':
-          this.setHostProperty('debounce', changes['debounce'].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-option-changed', (event: Event) => {
-        const typed = event as CustomEvent<ItemOptionChangedEventDetail>;
-        this.luzmoOptionChanged.emit(typed);
-      })
-    );
-  }
-}
-
-/** The underlying custom element type for LuzmoItemOptionTextField */
-export type LuzmoItemOptionTextFieldElement = LuzmoItemOptionTextFieldHostElement;

package/angular/components/item-option.ts

@@ -1,163 +0,0 @@
-import { ChangeDetectionStrategy, Component, DestroyRef, ElementRef, inject, Input, OnChanges, output, Renderer2, SimpleChanges } from '@angular/core';
-import '@luzmo/analytics-components-kit/item-option';
-import type { LuzmoItemOption as LuzmoItemOptionHostElement, ItemOptionsChangedEventDetail } from '@luzmo/analytics-components-kit/item-option';
-export type { ItemOptionChangedEventDetail, ItemOptionsChangedEventDetail } from '@luzmo/analytics-components-kit/item-option';
-import type { ElementSize } from '@luzmo/analytics-components-kit/types';
-import type { OptionConfig, OptionTranslation, ThemeConfig, TranslationOverrides, VizItemType } from '@luzmo/dashboard-contents-types';
-
-@Component({
-  selector: 'luzmo-item-option',
-  exportAs: 'luzmoItemOption',
-  standalone: true,
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  template: '<ng-content />'
-})
-/**
- * Angular wrapper component for <luzmo-item-option>
- */
-export class LuzmoItemOption implements OnChanges {
-  private readonly elementRef = inject<ElementRef<LuzmoItemOptionHostElement>>(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(): LuzmoItemOptionHostElement {
-    return this.host;
-  }
-
-  /** The language in which to display the option control. */
-  @Input({ alias: 'language' })
-  language?: string;
-
-  /** The visualization item type whose options config and translations are loaded. */
-  @Input({ alias: 'itemType' })
-  itemType?: VizItemType | string;
-
-  /** The key of the option (within the item type's options config) to render. */
-  @Input({ alias: 'optionKey' })
-  optionKey?: string;
-
-  /** A custom option configuration to render instead of resolving one from `itemType`/`optionKey`. */
-  @Input({ alias: 'customOptionConfiguration' })
-  customOptionConfiguration?: OptionConfig;
-
-  /** Translation overrides for the option label, tooltip, and enum values. */
-  @Input({ alias: 'customTranslations' })
-  customTranslations?: OptionTranslation | TranslationOverrides;
-
-  /** The current option values for the item. */
-  @Input({ alias: 'options' })
-  options?: Record<string, unknown>;
-
-  /** The item's data slots, used by options that depend on slot contents. */
-  @Input({ alias: 'slots' })
-  slots?: unknown[];
-
-  /** The theme configuration applied to the option control. */
-  @Input({ alias: 'theme' })
-  theme?: ThemeConfig & Record<string, any>;
-
-  /** The API URL of the databroker */
-  @Input({ alias: 'apiUrl' })
-  apiUrl?: string;
-
-  /** The auth key of the databroker */
-  @Input({ alias: 'authKey' })
-  authKey?: string;
-
-  /** The auth token of the databroker */
-  @Input({ alias: 'authToken' })
-  authToken?: string;
-
-  /** The size variant of the option control (`s`, `m`, `l`, `xl`). */
-  @Input({ alias: 'size' })
-  size?: ElementSize;
-
-  /** Callback that updates `options` and emits `luzmo-options-changed`; used internally by the rendered control. */
-  @Input({ alias: 'changedOptions' })
-  changedOptions?: unknown;
-
-  /** Announces that the `options` of the element have changed */
-  readonly luzmoOptionsChanged = output<CustomEvent<ItemOptionsChangedEventDetail>>({ alias: 'luzmoOptionsChanged' });
-
-  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 'language':
-          this.setHostProperty('language', changes['language'].currentValue);
-          break;
-        case 'itemType':
-          this.setHostProperty('itemType', changes['itemType'].currentValue);
-          break;
-        case 'optionKey':
-          this.setHostProperty('optionKey', changes['optionKey'].currentValue);
-          break;
-        case 'customOptionConfiguration':
-          this.setHostProperty('customOptionConfiguration', changes['customOptionConfiguration'].currentValue);
-          break;
-        case 'customTranslations':
-          this.setHostProperty('customTranslations', changes['customTranslations'].currentValue);
-          break;
-        case 'options':
-          this.setHostProperty('options', changes['options'].currentValue);
-          break;
-        case 'slots':
-          this.setHostProperty('slots', changes['slots'].currentValue);
-          break;
-        case 'theme':
-          this.setHostProperty('theme', changes['theme'].currentValue);
-          break;
-        case 'apiUrl':
-          this.setHostProperty('apiUrl', changes['apiUrl'].currentValue);
-          break;
-        case 'authKey':
-          this.setHostProperty('authKey', changes['authKey'].currentValue);
-          break;
-        case 'authToken':
-          this.setHostProperty('authToken', changes['authToken'].currentValue);
-          break;
-        case 'size':
-          this.setHostProperty('size', changes['size'].currentValue);
-          break;
-        case 'changedOptions':
-          this.setHostProperty('changedOptions', changes['changedOptions'].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-options-changed', (event: Event) => {
-        const typed = event as CustomEvent<ItemOptionsChangedEventDetail>;
-        this.luzmoOptionsChanged.emit(typed);
-      })
-    );
-  }
-}
-
-/** The underlying custom element type for LuzmoItemOption */
-export type LuzmoItemOptionElement = LuzmoItemOptionHostElement;