@luzmo/analytics-components-kit 1.0.9-beta.7 → 1.0.9-beta.8

package/components/filter-parameter-picker/filter-parameter-picker.d.ts

@@ -0,0 +1,91 @@
+import type { ItemFilterParameterDefinition } from '@luzmo/dashboard-contents-types';
+import '@luzmo/lucero/action-button';
+import '@luzmo/lucero/button';
+import '@luzmo/lucero/divider';
+import '@luzmo/lucero/icon';
+import '@luzmo/lucero/options';
+import '@luzmo/lucero/overlay';
+import '@luzmo/lucero/popover';
+import '@luzmo/lucero/tags';
+import '@luzmo/lucero/text-field';
+import '@luzmo/lucero/tooltip';
+import { LuzmoElement } from '@luzmo/lucero/utils';
+import { CSSResultArray, TemplateResult } from 'lit';
+import type { FilterParameterType } from '../filters/types';
+declare const LuzmoFilterParameterPicker_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("@luzmo/lucero").SizedElementInterface;
+    prototype: import("@luzmo/lucero").SizedElementInterface;
+};
+/**
+ * @customElement luzmo-filter-parameter-picker
+ * @fires {CustomEvent<FilterParameterPickerEventDetail>} luzmo-parameter-selected - Fired when a parameter is selected.
+ * @fires {CustomEvent<FilterParameterPickerEventDetail>} luzmo-parameter-created - Fired when a parameter is created.
+ * @fires {CustomEvent<FilterParameterPickerEventDetail>} luzmo-parameter-removed - Fired when a parameter is detached from the filter.
+ */
+export declare class LuzmoFilterParameterPicker extends LuzmoFilterParameterPicker_base {
+    static get styles(): CSSResultArray;
+    /**
+     * Parameter definitions available for selection.
+     */
+    parameters: ItemFilterParameterDefinition[];
+    /**
+     * Parameter types compatible with the active field and expression.
+     */
+    allowedTypes: FilterParameterType[];
+    /**
+     * The parameter currently attached to the filter.
+     */
+    selectedParameter?: ItemFilterParameterDefinition;
+    /**
+     * The current literal filter value used as the default for a new parameter.
+     */
+    currentValue?: unknown;
+    /**
+     * Whether parameter selection is disabled.
+     */
+    disabled: boolean;
+    /** @internal */
+    readonly: boolean;
+    /** @internal */
+    quiet: boolean;
+    private _open;
+    private _newParameterName;
+    private _overlay?;
+    private _triggerElement?;
+    private _optionsElement?;
+    private _handleDocumentClick;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private get _selectableParameters();
+    private get _parameterOptions();
+    /**
+     * The type a parameter on this filter holds: the attached one, or the type a new parameter gets.
+     */
+    private get _parameterType();
+    private get _duplicateName();
+    private get _triggerIconSize();
+    private get _hasParameterName();
+    private _dispatchSelected;
+    private _dispatchCreated;
+    private _dispatchRemoved;
+    private _handleTriggerClick;
+    private _handleTriggerKeydown;
+    private _handleOpened;
+    private _handleClosed;
+    private _close;
+    private _handlePanelKeydown;
+    private _handleNameInput;
+    private _selectParameter;
+    private _handleOptionsChange;
+    /**
+     * Creating only makes a parameter available; the user attaches it by picking it from the list.
+     */
+    private _handleCreateParameter;
+    private _handleNameKeydown;
+    private _handleRemoveParameter;
+    private _renderParameterType;
+    protected render(): TemplateResult;
+}
+export {};

package/components/filter-parameter-picker/filter-parameter-picker.helpers.d.ts

@@ -0,0 +1,8 @@
+import type { ColumnType, ItemFilterParameterDefinition, ItemFilterParameterValue, ItemQueryFilterExpression } from '@luzmo/dashboard-contents-types';
+import type { FilterParameterType } from '../filters/types';
+export declare function getSelectableParameterTypes(columnType: ColumnType | undefined, expression: ItemQueryFilterExpression | undefined): FilterParameterType[];
+export declare function getParameterTypeLabel(type: FilterParameterType): string;
+export declare function isFilterParameterDefinition(value: unknown): value is ItemFilterParameterDefinition;
+export declare function normalizeParameterName(name: string): string;
+export declare function createFilterParameter(name: string, type: FilterParameterType, currentValue?: unknown): ItemFilterParameterDefinition;
+export declare function getDefaultLiteralValue(columnType: ColumnType | undefined, expression: ItemQueryFilterExpression | undefined): ItemFilterParameterValue | undefined;

package/components/filter-parameter-picker/index.d.ts

@@ -0,0 +1,9 @@
+import { LuzmoFilterParameterPicker } from './filter-parameter-picker';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-filter-parameter-picker': LuzmoFilterParameterPicker;
+    }
+}
+export { LuzmoFilterParameterPicker } from './filter-parameter-picker';
+export type { FilterParameterPickerEventDetail } from './types';
+export { createFilterParameter, getDefaultLiteralValue, getParameterTypeLabel, getSelectableParameterTypes, isFilterParameterDefinition, normalizeParameterName } from './filter-parameter-picker.helpers';

package/components/filter-parameter-picker/types.d.ts

@@ -0,0 +1,4 @@
+import type { ItemFilterParameterDefinition } from '@luzmo/dashboard-contents-types';
+export interface FilterParameterPickerEventDetail {
+    parameter: ItemFilterParameterDefinition;
+}

package/components/filter-value-picker/filter-value-picker.d.ts

@@ -0,0 +1,72 @@
+import '@luzmo/lucero/picker';
+import '@luzmo/lucero/text-field';
+import { CSSResultArray, TemplateResult } from 'lit';
+import { LuzmoElement } from '@luzmo/lucero/utils';
+import './../filter-value-picker-datetime';
+import './../filter-value-picker-hierarchy';
+import './../filter-value-picker-numeric';
+declare const LuzmoFilterValuePicker_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("@luzmo/lucero").SizedElementInterface;
+    prototype: import("@luzmo/lucero").SizedElementInterface;
+};
+/**
+ * @customElement luzmo-filter-value-picker
+ * @fires {CustomEvent} luzmo-filter-value-changed - Fired when the filter value changes; `detail.value` holds the new value.
+ * @cssprop --luzmo-filter-value-picker-control-min-width - Smallest width a value control may shrink to in a narrow filter row.
+ */
+export declare class LuzmoFilterValuePicker extends LuzmoFilterValuePicker_base {
+    static get styles(): CSSResultArray;
+    /**
+     * The API URL of the databroker
+     * @default https://api.luzmo.com
+     * @description The URL of the databroker API
+     */
+    apiUrl?: string;
+    /**
+     * The auth key of the databroker
+     */
+    authKey?: string;
+    /**
+     * The auth token of the databroker
+     */
+    authToken?: string;
+    /**
+     * The cache time of the databroker
+     * @default 30000
+     * @description The time to cache the data in milliseconds
+     */
+    cacheTime?: number;
+    /**
+     * The language to use for locale-aware formatting and labels
+     */
+    contentLanguage: string;
+    /**
+     * The time zone to use for the date picker
+     */
+    timeZone?: string;
+    /**
+     * The type value picker to render
+     */
+    valueType?: 'hierarchy' | 'numeric' | 'datetime';
+    /**
+     * The filter for which to render the value picker
+     */
+    filter?: any;
+    /** @internal */
+    quiet: boolean;
+    /** @internal */
+    readonly: boolean;
+    /** @internal */
+    disabled: boolean;
+    private _expressionsWithoutValuePicker;
+    private _sendChangeEvent;
+    private setFilterValue;
+    private renderNumericValuePicker;
+    private renderHierarchyValuePicker;
+    private renderDateTimeValuePicker;
+    private renderDisabledTextField;
+    protected render(): TemplateResult;
+}
+export {};

package/components/filter-value-picker/index.d.ts

@@ -0,0 +1,7 @@
+import { LuzmoFilterValuePicker } from './filter-value-picker';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-filter-value-picker': LuzmoFilterValuePicker;
+    }
+}
+export { LuzmoFilterValuePicker } from './filter-value-picker';

package/components/filter-value-picker-datetime/filter-value-picker-datetime.d.ts

@@ -0,0 +1,51 @@
+import '@luzmo/lucero/date-time-picker';
+import '@luzmo/lucero/number-field';
+import '@luzmo/lucero/picker';
+import '@luzmo/lucero/text-field';
+import { CSSResultArray, PropertyValues, TemplateResult } from 'lit';
+import { LuzmoElement } from '@luzmo/lucero/utils';
+declare const LuzmoFilterValuePickerDatetime_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("@luzmo/lucero").SizedElementInterface;
+    prototype: import("@luzmo/lucero").SizedElementInterface;
+};
+/**
+ * @customElement luzmo-filter-value-picker-datetime
+ * @fires {CustomEvent} luzmo-filter-value-changed - Fired when the datetime filter value changes; `detail.value` holds the new value (ISO date or relative range).
+ * @cssprop --luzmo-filter-value-picker-datetime-gap - Gap between the controls of a relative range value.
+ * @cssprop --luzmo-filter-value-picker-datetime-control-min-width - Width the unit picker of a relative range asks for before it has to shrink.
+ * @cssprop --luzmo-filter-value-picker-datetime-quantity-width - Width the quantity field of a relative range asks for before it has to shrink.
+ */
+export declare class LuzmoFilterValuePickerDatetime extends LuzmoFilterValuePickerDatetime_base {
+    static get styles(): CSSResultArray;
+    /**
+     * The language to use for locale-aware formatting and column/formula labels
+     */
+    contentLanguage: string;
+    /**
+     * The time zone to use for the date picker
+     */
+    timeZone?: string;
+    /**
+     * The filter used to retrieve the value
+     */
+    filter?: any;
+    /** @internal */
+    quiet: boolean;
+    /** @internal */
+    readonly: boolean;
+    /** @internal */
+    disabled: boolean;
+    private _value;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    private _sendChangeEvent;
+    setDate(event: CustomEvent): void;
+    setUnit(event: CustomEvent): void;
+    setQuantity(event: CustomEvent): void;
+    private renderDatePicker;
+    private renderQuantityField;
+    private renderUnitPicker;
+    protected render(): TemplateResult;
+}
+export {};

package/components/filter-value-picker-datetime/index.d.ts

@@ -0,0 +1,7 @@
+import { LuzmoFilterValuePickerDatetime } from './filter-value-picker-datetime';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-filter-value-picker-datetime': LuzmoFilterValuePickerDatetime;
+    }
+}
+export { LuzmoFilterValuePickerDatetime } from './filter-value-picker-datetime';

package/components/filter-value-picker-hierarchy/filter-value-picker-hierarchy.d.ts

@@ -0,0 +1,105 @@
+import '@luzmo/lucero/select';
+import '@luzmo/lucero/text-field';
+import { CSSResultArray, PropertyValues, TemplateResult } from 'lit';
+import { LuzmoElement } from '@luzmo/lucero/utils';
+declare const LuzmoFilterValuePickerHierarchy_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("@luzmo/lucero").SizedElementInterface;
+    prototype: import("@luzmo/lucero").SizedElementInterface;
+};
+/**
+ * @customElement luzmo-filter-value-picker-hierarchy
+ * @fires {CustomEvent} luzmo-filter-value-changed - Fired when the hierarchy filter value changes; `detail.value` holds the selected value(s).
+ * @cssprop --luzmo-filter-value-picker-hierarchy-missing-value-color - Color of the label shown when the stored value is no longer available.
+ * @cssprop --luzmo-filter-value-picker-hierarchy-control-min-width - Smallest width a value control may shrink to in a narrow filter row.
+ */
+export declare class LuzmoFilterValuePickerHierarchy extends LuzmoFilterValuePickerHierarchy_base {
+    static get styles(): CSSResultArray;
+    /**
+     * The API URL of the databroker
+     * @default https://api.luzmo.com
+     * @description The URL of the databroker API
+     */
+    apiUrl?: string;
+    /**
+     * The auth key of the databroker
+     */
+    authKey?: string;
+    /**
+     * The auth token of the databroker
+     */
+    authToken?: string;
+    /**
+     * The cache time of the databroker
+     * @default 30000
+     * @description The time to cache the data in milliseconds
+     */
+    cacheTime?: number;
+    /**
+     * The language to use for locale-aware formatting and labels
+     */
+    contentLanguage: string;
+    /**
+     * The filter used to retrieve the value
+     */
+    filter?: any;
+    /** @internal */
+    quiet: boolean;
+    /** @internal */
+    readonly: boolean;
+    /** @internal */
+    disabled: boolean;
+    /**
+     * Stores the hierarchy values fetched from the databroker
+     */
+    private _hierarchyValues;
+    /**
+     * Loading state for hierarchy values
+     */
+    private _retrieving;
+    /**
+     * Search state for hierarchy values
+     */
+    private _search;
+    /**
+     * Error state for hierarchy values fetching
+     */
+    private _error;
+    /**
+     * Pending state while a text operator resolves to a hierarchy member
+     */
+    private _pending;
+    private _value;
+    private _searchQueryTimeout;
+    private _allValuesRetrieved;
+    private _lastResolutionKey?;
+    private _lastResolvedOutput?;
+    private _hierarchyRequestGeneration;
+    private _runningQueries;
+    connectedCallback(): void;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    protected updated(changedProperties: PropertyValues): void;
+    private _buildHierarchyQuery;
+    private _getValues;
+    private _applyHierarchyResult;
+    private _restoreCachedFirstPage;
+    private _getMemberLabel;
+    private _findExactMember;
+    private _resolveSingleSelectValue;
+    /**
+     * Fetches hierarchy values from the databroker
+     */
+    private _fetchHierarchyValues;
+    private _sendChangeEvent;
+    private setHierarchy;
+    private onScrolled;
+    private renderTextField;
+    private setSearchString;
+    private resetSearchString;
+    private onOpened;
+    private _getSelectedOptionValue;
+    private renderHierarchyPicker;
+    protected render(): TemplateResult;
+}
+export {};

package/components/filter-value-picker-hierarchy/index.d.ts

@@ -0,0 +1,7 @@
+import { LuzmoFilterValuePickerHierarchy } from './filter-value-picker-hierarchy';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-filter-value-picker-hierarchy': LuzmoFilterValuePickerHierarchy;
+    }
+}
+export { LuzmoFilterValuePickerHierarchy } from './filter-value-picker-hierarchy';

package/components/filter-value-picker-numeric/filter-value-picker-numeric.d.ts

@@ -0,0 +1,89 @@
+import '@luzmo/lucero/number-field';
+import '@luzmo/lucero/select';
+import { CSSResultArray, PropertyValues, TemplateResult } from 'lit';
+import { LuzmoElement } from '@luzmo/lucero/utils';
+declare const LuzmoFilterValuePickerNumeric_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("@luzmo/lucero").SizedElementInterface;
+    prototype: import("@luzmo/lucero").SizedElementInterface;
+};
+/**
+ * @customElement luzmo-filter-value-picker-numeric
+ * @fires {CustomEvent} luzmo-filter-value-changed - Fired when the numeric filter value changes; `detail.value` holds the new number or range.
+ * @cssprop --luzmo-filter-value-picker-numeric-control-min-width - Smallest width a value control may shrink to in a narrow filter row.
+ */
+export declare class LuzmoFilterValuePickerNumeric extends LuzmoFilterValuePickerNumeric_base {
+    static get styles(): CSSResultArray;
+    /**
+     * The API URL of the databroker
+     * @default https://api.luzmo.com
+     * @description The URL of the databroker API
+     */
+    apiUrl?: string;
+    /**
+     * The auth key of the databroker
+     */
+    authKey?: string;
+    /**
+     * The auth token of the databroker
+     */
+    authToken?: string;
+    /**
+     * The cache time of the databroker
+     * @default 30000
+     * @description The time to cache the data in milliseconds
+     */
+    cacheTime?: number;
+    /**
+     * The language to use for locale-aware formatting and labels
+     */
+    contentLanguage: string;
+    /**
+     * The filter used to retrieve the value
+     */
+    filter?: any;
+    /** @internal */
+    quiet: boolean;
+    /** @internal */
+    readonly: boolean;
+    /** @internal */
+    disabled: boolean;
+    /**
+     * Stores the hierarchy values fetched from the databroker
+     */
+    private _numericValues;
+    /**
+     * Loading state for hierarchy values
+     */
+    private _retrieving;
+    /**
+     * Search state for hierarchy values
+     */
+    private _search;
+    /**
+     * Error state for hierarchy values fetching
+     */
+    private _error;
+    private _value;
+    private _searchQueryTimeout;
+    private _allValuesRetrieved;
+    private _runningQueries;
+    connectedCallback(): void;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    /**
+     * Fetches numeric values from the databroker
+     */
+    private _fetchNumericValues;
+    private _sendChangeEvent;
+    private setValue;
+    private selectValue;
+    private onScrolled;
+    private renderNumberField;
+    private setSearchString;
+    private resetSearchString;
+    private onOpened;
+    private renderValuePicker;
+    protected render(): TemplateResult;
+}
+export {};

package/components/filter-value-picker-numeric/index.d.ts

@@ -0,0 +1,7 @@
+import { LuzmoFilterValuePickerNumeric } from './filter-value-picker-numeric';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-filter-value-picker-numeric': LuzmoFilterValuePickerNumeric;
+    }
+}
+export { LuzmoFilterValuePickerNumeric } from './filter-value-picker-numeric';

package/components/filters/filters.d.ts

@@ -0,0 +1,182 @@
+import '@luzmo/lucero/action-button';
+import '@luzmo/lucero/button';
+import '@luzmo/lucero/icon';
+import '@luzmo/lucero/progress-circle';
+import '@luzmo/lucero/tooltip';
+import { LuzmoElement } from '@luzmo/lucero/utils';
+import { CSSResultArray, PropertyValues, TemplateResult } from 'lit';
+import type { FilterColumnDisplay } from '../../utils/filters/presentation';
+import '../filter-item';
+import type { FilterParameter, FiltersDisplay, FiltersFormat, FiltersInput } from './types';
+declare const LuzmoFilters_base: (new (...args: any[]) => {
+    language: string;
+}) & typeof LuzmoElement & {
+    new (...args: any[]): import("@luzmo/lucero").SizedElementInterface;
+    prototype: import("@luzmo/lucero").SizedElementInterface;
+};
+/**
+ * @customElement luzmo-filters
+ * @attr column-display - Visual treatment of column and formula references in text and outline displays.
+ * @csspart filters-text - The inline sentence shown when `display` is `text`.
+ * @csspart filters-outline - The bracket layout shown when `display` is `outline`.
+ * @csspart filters-outline-row - One filter row in the outline, including its delete button when shown.
+ * @cssprop --luzmo-filters-text-font-size - Font size of the text and outline displays. Defaults follow `size` (`--luzmo-font-size-s` through `--luzmo-font-size-xl`).
+ * @cssprop --luzmo-filters-text-part-gap - Space between the parts of an outline filter. Defaults follow `size` (`--luzmo-spacing-1` through `--luzmo-spacing-4`). The text display uses word spacing instead.
+ * @cssprop --luzmo-filters-text-icon-gap - Space between a field icon and its name in the text display. Defaults to `--luzmo-spacing-1` at `s` and `m`, and `--luzmo-spacing-2` at `l` and `xl`.
+ * @cssprop --luzmo-filters-outline-children-margin-inline-start - Indent of a nested outline group. Defaults follow `size` from `--luzmo-spacing-1` to `--luzmo-spacing-4`.
+ * @cssprop --luzmo-filters-outline-children-padding-inline-start - Padding inside an outline bracket. Sizes `s` and `m` use `--luzmo-spacing-3`, `l` uses `--luzmo-spacing-4`, and `xl` uses `--luzmo-spacing-5`.
+ * @cssprop --luzmo-filters-outline-bracket-inset - Inset of the outline bracket from the start edge of its children. Size `s` uses `--luzmo-spacing-1`, `m` and `l` use `--luzmo-spacing-2`, and `xl` uses `--luzmo-spacing-3`.
+ * @cssprop --luzmo-filters-expression-color - Color of an expression such as "is in" or ">". Defaults to the sentence color. Set it to `var(--luzmo-primary)` to use the primary color. An empty value uses the sentence color.
+ * @cssprop --luzmo-filters-expression-font-weight - Weight of an expression such as "is in" or ">". Defaults to normal (`--luzmo-font-weight`). Set it to `var(--luzmo-font-weight-bold)` for bold. An empty value uses normal.
+ * @cssprop --luzmo-filters-condition-color - Color of an AND/OR label. Defaults to the sentence color. Set it to `var(--luzmo-primary)` to use the primary color. An empty value uses the sentence color.
+ * @cssprop --luzmo-filters-condition-font-weight - Weight of an AND/OR label. The outline defaults to bold and the text sentence defaults to normal. Set the token to apply one weight to both. An empty value uses normal.
+ * @cssprop --luzmo-filters-outline-condition-font-size - Font size of the AND/OR label in the outline. Defaults one step below the sentence for the current `size`.
+ * @cssprop --luzmo-filters-column-badge-color - Border for outline badges, tint for subtle badges, and background for filled badges.
+ * @cssprop --luzmo-filters-column-badge-font-color - Label and icon color for column badges.
+ * @fires {CustomEvent<FiltersChangedEventDetail>} luzmo-filters-changed - Announces that the filters have changed,
+ * carrying the emitted groups and the format they are in. `display="text"` never fires this.
+ * Outline fires it after a filter is deleted.
+ * @fires {CustomEvent<{ parameter: FilterParameter }>} luzmo-parameter-created - Announces that a parameter was created and added to `parameters`.
+ * @fires {CustomEvent<{ parameter: FilterParameter }>} luzmo-parameter-removed - Announces that a parameter was detached from a filter.
+ */
+export declare class LuzmoFilters extends LuzmoFilters_base {
+    static get styles(): CSSResultArray;
+    /**
+     * The API URL of the databroker
+     * @default https://api.luzmo.com
+     */
+    apiUrl?: string;
+    /**
+     * The auth key of the databroker
+     */
+    authKey?: string;
+    /**
+     * The auth token of the databroker
+     */
+    authToken?: string;
+    /**
+     * The cache time of the databroker
+     */
+    cacheTime?: number;
+    /**
+     * The language to use for locale-aware formatting and labels
+     */
+    contentLanguage: string;
+    /**
+     * The time zone to use for the date picker
+     */
+    timeZone?: string;
+    /**
+     * The dataset ids to fetch columns & formulas
+     */
+    datasetIds?: string[];
+    /**
+     * The filter groups to display.
+     *
+     * Accepts both halves of the public `ItemFilterOutput` / `DashboardFilterOutput`
+     * unions: canonical `ItemFilterGroup[]` and clean clause groups with flattened
+     * leaves. Nested `and` / `or` groups are preserved either way.
+     */
+    filters: FiltersInput;
+    /**
+     * Output format for the `luzmo-filters-changed` event.
+     *
+     * `canonical` emits `ItemFilterGroup[]`; `clean` emits the clean clause groups
+     * that aligned hosts consume. A tree that cannot be represented cleanly falls
+     * back to canonical output, and the event says which format it carries.
+     * @default canonical
+     */
+    format: FiltersFormat;
+    /**
+     * How the filters are presented. `rich` is the editable group editor. `text` is a read-only
+     * sentence, with parentheses around nested AND/OR groups. `outline` is one wrapping filter per
+     * line inside bracket rails, and can delete a filter unless `readonly` is set.
+     * @default rich
+     */
+    display: FiltersDisplay;
+    /** Presentation of column and formula references in text and outline displays. */
+    columnDisplay: FilterColumnDisplay;
+    /**
+     * Removes rich-editor control chrome while keeping the filters editable.
+     * @default false
+     */
+    quiet: boolean;
+    /**
+     * Prevents changes while preserving the selected display and visual treatment.
+     * In `outline`, this hides the delete buttons.
+     * @default false
+     */
+    readonly: boolean;
+    /**
+     * Whether parameter-backed filter values can be created and selected.
+     * @default false
+     */
+    allowParameters: boolean;
+    /**
+     * Consumer-owned parameter definitions available to filter rows.
+     */
+    parameters: FilterParameter[];
+    /**
+     * Debounce time in milliseconds for the filters-changed event
+     * @default 300
+     */
+    debounce: number;
+    private _internalFilterGroup;
+    private _datasets;
+    private _datasetsLoading;
+    private _hierarchyLabels;
+    private _hierarchyLabelsLoading;
+    private _hasSyntheticRoot;
+    private _datasetRequest;
+    private _hierarchyRequest;
+    private _debounceTimeout;
+    /**
+     * Get a smaller size for the condition badges
+     */
+    private get _oneSizeSmaller();
+    /**
+     * Check if datasetIds is empty or undefined
+     */
+    private get _isDatasetIdsEmpty();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    private _loadDatasetsForDisplay;
+    private _configureDataBroker;
+    private _loadHierarchyLabelsForDisplay;
+    private _filterTextContext;
+    private _generateEmptyGroup;
+    private _generateEmptyFilter;
+    /**
+     * The root groups to export: either the wrapped children or the single group.
+     */
+    private _rootGroupsForExport;
+    private _getFiltersForExport;
+    private _sendChangeEvent;
+    private _isGroup;
+    /**
+     * A parameter created in one row becomes selectable in every row.
+     */
+    private _handleParameterCreated;
+    private _toggleCondition;
+    private _addFilter;
+    private _addSubGroup;
+    private _removeFilter;
+    private _updateFilter;
+    private _addGroup;
+    private _renderFilterItem;
+    private _renderGroup;
+    private _findParentGroup;
+    private _collapseIfNeeded;
+    private _collapseGroupsAfterDelete;
+    private _renderTextLeaf;
+    private _renderTextGroup;
+    private _renderDatasetLoading;
+    private _renderTextDisplay;
+    private _deleteOutlineFilter;
+    private _renderOutlineRow;
+    private _renderOutlineGroup;
+    private _renderOutlineDisplay;
+    protected render(): TemplateResult;
+}
+export {};

package/components/filters/index.d.ts

@@ -0,0 +1,12 @@
+import { LuzmoFilters } from './filters';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-filters': LuzmoFilters;
+    }
+}
+export { LuzmoFilters } from './filters';
+export { detectFiltersFormat, FilterUnrepresentableError, MAX_FILTER_NESTING_DEPTH } from './transformations/filter-format';
+export { reverseTransformFilters, toLogicalCondition, transformFilters } from './transformations/transform-filters';
+export type { DetectedFiltersFormat, TransformFiltersOptions } from './transformations/transform-filters';
+export type { CleanFilter, CleanFilterClauseGroup, CleanFilterGroup, CleanRetrievedFilterGroup, DashboardFilterOutput, FilterClause, FilterCondition, FilterGroup, FilterParameter, FilterParameterEventDetail, FilterParameterType, FiltersChangedEventDetail, FiltersDisplay, FiltersFormat, FiltersInput, FiltersOutput, ItemFilterOutput } from './types';
+export type { FilterColumnDisplay } from '../../utils/filters/presentation';