@beeq/angular 1.13.1 → 1.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beeq/angular",
-  "version": "1.13.1",
+  "version": "1.15.0",
   "license": "Apache-2.0",
   "description": "Angular specific wrapper for BEEQ Design System components",
   "main": "dist/esm2015/index.js",

package/types/beeq-angular-standalone.d.ts

@@ -1,7 +1,7 @@
 import * as i0 from '@angular/core';
 import { ElementRef, NgZone, EventEmitter, ChangeDetectorRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
-import { BqAccordionCustomEvent, Components, BqAlertCustomEvent, BqBreadcrumbItemCustomEvent, BqButtonCustomEvent, BqCheckboxCustomEvent, BqDatePickerCustomEvent, TCalendarView, BqDialogCustomEvent, BqDrawerCustomEvent, BqDropdownCustomEvent, BqIconCustomEvent, BqInputCustomEvent, BqNotificationCustomEvent, BqOptionCustomEvent, BqOptionListCustomEvent, BqRadioCustomEvent, BqRadioGroupCustomEvent, BqSelectCustomEvent, BqSideMenuCustomEvent, BqSideMenuItemCustomEvent, BqSliderCustomEvent, TSliderValue, BqStepItemCustomEvent, BqSwitchCustomEvent, BqTabCustomEvent, BqTabGroupCustomEvent, BqTagCustomEvent, BqTextareaCustomEvent, BqToastCustomEvent, BqTooltipCustomEvent } from '@beeq/core/dist/components';
+import { BqAccordionCustomEvent, Components, BqAlertCustomEvent, BqBreadcrumbItemCustomEvent, BqButtonCustomEvent, BqCheckboxCustomEvent, BqDatePickerCustomEvent, TCalendarView, BqDialogCustomEvent, BqDrawerCustomEvent, BqDropdownCustomEvent, BqIconCustomEvent, BqInputCustomEvent, BqNotificationCustomEvent, BqOptionCustomEvent, BqOptionListCustomEvent, BqRadioCustomEvent, BqRadioGroupCustomEvent, BqSelectCustomEvent, TSelectChangeDetail, BqSideMenuCustomEvent, BqSideMenuItemCustomEvent, BqSliderCustomEvent, TSliderValue, BqStepItemCustomEvent, BqSwitchCustomEvent, BqTabCustomEvent, BqTabGroupCustomEvent, BqTagCustomEvent, BqTextareaCustomEvent, BqToastCustomEvent, BqTooltipCustomEvent } from '@beeq/core/dist/components';
 
 declare class ValueAccessor implements ControlValueAccessor {
     protected el: ElementRef;
@@ -491,7 +491,7 @@ declare class BqOption {
     bqEnter: EventEmitter<BqOptionCustomEvent<HTMLBqOptionElement>>;
     constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
     static ɵfac: i0.ɵɵFactoryDeclaration<BqOption, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BqOption, "bq-option", never, { "disabled": { "alias": "disabled"; "required": false; }; "displayValue": { "alias": "displayValue"; "required": false; }; "hidden": { "alias": "hidden"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "bqBlur": "bqBlur"; "bqFocus": "bqFocus"; "bqClick": "bqClick"; "bqEnter": "bqEnter"; }, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BqOption, "bq-option", never, { "allSelectedLabel": { "alias": "allSelectedLabel"; "required": false; }; "checkbox": { "alias": "checkbox"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "displayValue": { "alias": "displayValue"; "required": false; }; "expanded": { "alias": "expanded"; "required": false; }; "hidden": { "alias": "hidden"; "required": false; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "selectedCountLabel": { "alias": "selectedCountLabel"; "required": false; }; "showSelectionSummary": { "alias": "showSelectionSummary"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "bqBlur": "bqBlur"; "bqFocus": "bqFocus"; "bqClick": "bqClick"; "bqEnter": "bqEnter"; }, never, ["*"], true, never>;
 }
 declare interface BqOption extends Components.BqOption {
     /**
@@ -639,16 +639,13 @@ declare class BqSelect {
     bqBlur: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     bqClear: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     bqFocus: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
-    bqSelect: EventEmitter<BqSelectCustomEvent<{
-        value: string | number | string[];
-        item: HTMLBqOptionElement;
-    }>>;
+    bqSelect: EventEmitter<BqSelectCustomEvent<TSelectChangeDetail>>;
     bqInput: EventEmitter<BqSelectCustomEvent<{
         value: string | number | string[];
     }>>;
     constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
     static ɵfac: i0.ɵɵFactoryDeclaration<BqSelect, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BqSelect, "bq-select", never, { "autofocus": { "alias": "autofocus"; "required": false; }; "clearButtonLabel": { "alias": "clearButtonLabel"; "required": false; }; "debounceTime": { "alias": "debounceTime"; "required": false; }; "disableClear": { "alias": "disableClear"; "required": false; }; "disableScrollLock": { "alias": "disableScrollLock"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "distance": { "alias": "distance"; "required": false; }; "form": { "alias": "form"; "required": false; }; "formValidationMessage": { "alias": "formValidationMessage"; "required": false; }; "keepOpenOnSelect": { "alias": "keepOpenOnSelect"; "required": false; }; "maxTagsVisible": { "alias": "maxTagsVisible"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "name": { "alias": "name"; "required": true; }; "open": { "alias": "open"; "required": false; }; "panelHeight": { "alias": "panelHeight"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "required": { "alias": "required"; "required": false; }; "sameWidth": { "alias": "sameWidth"; "required": false; }; "skidding": { "alias": "skidding"; "required": false; }; "strategy": { "alias": "strategy"; "required": false; }; "validationStatus": { "alias": "validationStatus"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "bqBlur": "bqBlur"; "bqClear": "bqClear"; "bqFocus": "bqFocus"; "bqSelect": "bqSelect"; "bqInput": "bqInput"; }, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BqSelect, "bq-select", never, { "autofocus": { "alias": "autofocus"; "required": false; }; "clearButtonLabel": { "alias": "clearButtonLabel"; "required": false; }; "debounceTime": { "alias": "debounceTime"; "required": false; }; "disableClear": { "alias": "disableClear"; "required": false; }; "disableScrollLock": { "alias": "disableScrollLock"; "required": false; }; "disableSearch": { "alias": "disableSearch"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "distance": { "alias": "distance"; "required": false; }; "enableCheckboxes": { "alias": "enableCheckboxes"; "required": false; }; "form": { "alias": "form"; "required": false; }; "formValidationMessage": { "alias": "formValidationMessage"; "required": false; }; "keepOpenOnSelect": { "alias": "keepOpenOnSelect"; "required": false; }; "maxTagsVisible": { "alias": "maxTagsVisible"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "name": { "alias": "name"; "required": true; }; "open": { "alias": "open"; "required": false; }; "panelHeight": { "alias": "panelHeight"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "required": { "alias": "required"; "required": false; }; "sameWidth": { "alias": "sameWidth"; "required": false; }; "skidding": { "alias": "skidding"; "required": false; }; "strategy": { "alias": "strategy"; "required": false; }; "validationStatus": { "alias": "validationStatus"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "bqBlur": "bqBlur"; "bqClear": "bqClear"; "bqFocus": "bqFocus"; "bqSelect": "bqSelect"; "bqInput": "bqInput"; }, never, ["*"], true, never>;
 }
 declare interface BqSelect extends Components.BqSelect {
     /**
@@ -664,12 +661,9 @@ declare interface BqSelect extends Components.BqSelect {
      */
     bqFocus: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     /**
-     * Callback handler emitted when the selected value has changed
+     * Callback handler emitted when the selected value has changed. Nested multi-select also includes selected paths in `selectionTree`.
      */
-    bqSelect: EventEmitter<BqSelectCustomEvent<{
-        value: string | number | string[];
-        item: HTMLBqOptionElement;
-    }>>;
+    bqSelect: EventEmitter<BqSelectCustomEvent<TSelectChangeDetail>>;
     /**
      * Callback handler emitted when the Select input changes its value while typing
      */

package/types/beeq-angular.d.ts

@@ -1,7 +1,7 @@
 import * as i0 from '@angular/core';
 import { ElementRef, NgZone, EventEmitter, ChangeDetectorRef, ModuleWithProviders } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
-import { Components, BqAccordionCustomEvent, BqAlertCustomEvent, BqBreadcrumbItemCustomEvent, BqButtonCustomEvent, BqCheckboxCustomEvent, BqDatePickerCustomEvent, TCalendarView, BqDialogCustomEvent, BqDrawerCustomEvent, BqDropdownCustomEvent, BqIconCustomEvent, BqInputCustomEvent, BqNotificationCustomEvent, BqOptionCustomEvent, BqOptionListCustomEvent, BqRadioCustomEvent, BqRadioGroupCustomEvent, BqSelectCustomEvent, BqSideMenuCustomEvent, BqSideMenuItemCustomEvent, BqSliderCustomEvent, TSliderValue, BqStepItemCustomEvent, BqSwitchCustomEvent, BqTabCustomEvent, BqTabGroupCustomEvent, BqTagCustomEvent, BqTextareaCustomEvent, BqToastCustomEvent, BqTooltipCustomEvent } from '@beeq/core';
+import { Components, BqAccordionCustomEvent, BqAlertCustomEvent, BqBreadcrumbItemCustomEvent, BqButtonCustomEvent, BqCheckboxCustomEvent, BqDatePickerCustomEvent, TCalendarView, BqDialogCustomEvent, BqDrawerCustomEvent, BqDropdownCustomEvent, BqIconCustomEvent, BqInputCustomEvent, BqNotificationCustomEvent, BqOptionCustomEvent, BqOptionListCustomEvent, BqRadioCustomEvent, BqRadioGroupCustomEvent, BqSelectCustomEvent, TSelectChangeDetail, BqSideMenuCustomEvent, BqSideMenuItemCustomEvent, BqSliderCustomEvent, TSliderValue, BqStepItemCustomEvent, BqSwitchCustomEvent, BqTabCustomEvent, BqTabGroupCustomEvent, BqTagCustomEvent, BqTextareaCustomEvent, BqToastCustomEvent, BqTooltipCustomEvent } from '@beeq/core';
 import * as i7 from '@angular/common';
 
 declare class ValueAccessor implements ControlValueAccessor {
@@ -1167,10 +1167,34 @@ declare class BqOption {
    */
     set disabled(_: Components.BqOption['disabled']);
     /**
+   * If true, the option renders as a checkbox option. @default false
+   */
+    set checkbox(_: Components.BqOption['checkbox']);
+    /**
    * The display value of the option. It can be used to override the default displayed value.
    */
     set displayValue(_: Components.BqOption['displayValue']);
     /**
+   * If true, nested options are displayed. @default false
+   */
+    set expanded(_: Components.BqOption['expanded']);
+    /**
+   * If true, the option checkbox represents a partial nested selection. @default false
+   */
+    set indeterminate(_: Components.BqOption['indeterminate']);
+    /**
+   * Text displayed when all selectable nested options are selected. @default 'All selected'
+   */
+    set allSelectedLabel(_: Components.BqOption['allSelectedLabel']);
+    /**
+   * Text displayed when some selectable nested options are selected. Use `{count}` as the selected option count placeholder. @default '{count} selected'
+   */
+    set selectedCountLabel(_: Components.BqOption['selectedCountLabel']);
+    /**
+   * If true, displays the nested selection summary beside the expand control. @default true
+   */
+    set showSelectionSummary(_: Components.BqOption['showSelectionSummary']);
+    /**
    * If true, the option is selected and active. @default false
    */
     set selected(_: Components.BqOption['selected']);
@@ -1184,7 +1208,7 @@ declare class BqOption {
     bqEnter: EventEmitter<BqOptionCustomEvent<HTMLBqOptionElement>>;
     constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
     static ɵfac: i0.ɵɵFactoryDeclaration<BqOption, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BqOption, "bq-option", never, { "disabled": { "alias": "disabled"; "required": false; }; "displayValue": { "alias": "displayValue"; "required": false; }; "hidden": { "alias": "hidden"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "bqBlur": "bqBlur"; "bqFocus": "bqFocus"; "bqClick": "bqClick"; "bqEnter": "bqEnter"; }, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BqOption, "bq-option", never, { "allSelectedLabel": { "alias": "allSelectedLabel"; "required": false; }; "checkbox": { "alias": "checkbox"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "displayValue": { "alias": "displayValue"; "required": false; }; "expanded": { "alias": "expanded"; "required": false; }; "hidden": { "alias": "hidden"; "required": false; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "selectedCountLabel": { "alias": "selectedCountLabel"; "required": false; }; "showSelectionSummary": { "alias": "showSelectionSummary"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "bqBlur": "bqBlur"; "bqFocus": "bqFocus"; "bqClick": "bqClick"; "bqEnter": "bqEnter"; }, never, ["*"], false, never>;
 }
 declare interface BqOption extends Components.BqOption {
     /**
@@ -1480,6 +1504,10 @@ If `true`, the Select is disabled and cannot be interacted with. @default false
    */
     set disableClear(_: Components.BqSelect['disableClear']);
     /**
+   * If true, the search functionality within the Select panel will be disabled. No typing will be allowed @default false
+   */
+    set disableSearch(_: Components.BqSelect['disableSearch']);
+    /**
    * Represents the distance (gutter or margin) between the Select panel and the input element. @default 8
    */
     set distance(_: Components.BqSelect['distance']);
@@ -1524,7 +1552,8 @@ If `true`, the Select is disabled and cannot be interacted with. @default false
    */
     set placement(_: Components.BqSelect['placement']);
     /**
-   * If true, the list of options cannot be filtered (searching won't be available)
+   *  @deprecated Use `disableSearch` to allow selection without text filtering.
+In a future major release, `readonly` will prevent changing the selected value.
    */
     set readonly(_: Components.BqSelect['readonly']);
     /**
@@ -1536,6 +1565,10 @@ If `true`, the Select is disabled and cannot be interacted with. @default false
    */
     set sameWidth(_: Components.BqSelect['sameWidth']);
     /**
+   * If true, flat options render with checkboxes when multiple selection is enabled. Nested multi-select options always render with checkboxes.
+   */
+    set enableCheckboxes(_: Components.BqSelect['enableCheckboxes']);
+    /**
    * Represents the skidding between the Select panel and the input element. @default 0
    */
     set skidding(_: Components.BqSelect['skidding']);
@@ -1558,16 +1591,13 @@ If `true`, the Select is disabled and cannot be interacted with. @default false
     bqBlur: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     bqClear: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     bqFocus: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
-    bqSelect: EventEmitter<BqSelectCustomEvent<{
-        value: string | number | string[];
-        item: HTMLBqOptionElement;
-    }>>;
+    bqSelect: EventEmitter<BqSelectCustomEvent<TSelectChangeDetail>>;
     bqInput: EventEmitter<BqSelectCustomEvent<{
         value: string | number | string[];
     }>>;
     constructor(c: ChangeDetectorRef, r: ElementRef, z: NgZone);
     static ɵfac: i0.ɵɵFactoryDeclaration<BqSelect, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BqSelect, "bq-select", never, { "autofocus": { "alias": "autofocus"; "required": false; }; "clearButtonLabel": { "alias": "clearButtonLabel"; "required": false; }; "debounceTime": { "alias": "debounceTime"; "required": false; }; "disableClear": { "alias": "disableClear"; "required": false; }; "disableScrollLock": { "alias": "disableScrollLock"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "distance": { "alias": "distance"; "required": false; }; "form": { "alias": "form"; "required": false; }; "formValidationMessage": { "alias": "formValidationMessage"; "required": false; }; "keepOpenOnSelect": { "alias": "keepOpenOnSelect"; "required": false; }; "maxTagsVisible": { "alias": "maxTagsVisible"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "name": { "alias": "name"; "required": true; }; "open": { "alias": "open"; "required": false; }; "panelHeight": { "alias": "panelHeight"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "required": { "alias": "required"; "required": false; }; "sameWidth": { "alias": "sameWidth"; "required": false; }; "skidding": { "alias": "skidding"; "required": false; }; "strategy": { "alias": "strategy"; "required": false; }; "validationStatus": { "alias": "validationStatus"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "bqBlur": "bqBlur"; "bqClear": "bqClear"; "bqFocus": "bqFocus"; "bqSelect": "bqSelect"; "bqInput": "bqInput"; }, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BqSelect, "bq-select", never, { "autofocus": { "alias": "autofocus"; "required": false; }; "clearButtonLabel": { "alias": "clearButtonLabel"; "required": false; }; "debounceTime": { "alias": "debounceTime"; "required": false; }; "disableClear": { "alias": "disableClear"; "required": false; }; "disableScrollLock": { "alias": "disableScrollLock"; "required": false; }; "disableSearch": { "alias": "disableSearch"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "distance": { "alias": "distance"; "required": false; }; "enableCheckboxes": { "alias": "enableCheckboxes"; "required": false; }; "form": { "alias": "form"; "required": false; }; "formValidationMessage": { "alias": "formValidationMessage"; "required": false; }; "keepOpenOnSelect": { "alias": "keepOpenOnSelect"; "required": false; }; "maxTagsVisible": { "alias": "maxTagsVisible"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "name": { "alias": "name"; "required": true; }; "open": { "alias": "open"; "required": false; }; "panelHeight": { "alias": "panelHeight"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "required": { "alias": "required"; "required": false; }; "sameWidth": { "alias": "sameWidth"; "required": false; }; "skidding": { "alias": "skidding"; "required": false; }; "strategy": { "alias": "strategy"; "required": false; }; "validationStatus": { "alias": "validationStatus"; "required": false; }; "value": { "alias": "value"; "required": false; }; }, { "bqBlur": "bqBlur"; "bqClear": "bqClear"; "bqFocus": "bqFocus"; "bqSelect": "bqSelect"; "bqInput": "bqInput"; }, never, ["*"], false, never>;
 }
 declare interface BqSelect extends Components.BqSelect {
     /**
@@ -1583,12 +1613,9 @@ declare interface BqSelect extends Components.BqSelect {
      */
     bqFocus: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     /**
-     * Callback handler emitted when the selected value has changed
+     * Callback handler emitted when the selected value has changed. Nested multi-select also includes selected paths in `selectionTree`.
      */
-    bqSelect: EventEmitter<BqSelectCustomEvent<{
-        value: string | number | string[];
-        item: HTMLBqOptionElement;
-    }>>;
+    bqSelect: EventEmitter<BqSelectCustomEvent<TSelectChangeDetail>>;
     /**
      * Callback handler emitted when the Select input changes its value while typing
      */