@beeq/angular 1.14.0 → 1.16.0

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@beeq/angular",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "license": "Apache-2.0",
   "description": "Angular specific wrapper for BEEQ Design System components",
   "main": "dist/esm2015/index.js",
   "module": "fesm2022/beeq-angular.mjs",
   "types": "index.d.ts",
   "dependencies": {
-    "@beeq/core": "^1.12.0",
+    "@beeq/core": "^1.15.0",
     "tslib": "^2.3.0"
   },
   "peerDependencies": {

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,20 +639,17 @@ 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; }; "disableSearch": { "alias": "disableSearch"; "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 {
     /**
-     * Callback handler emitted when the Select input loses focus
+     * Emitted when focus leaves the entire Select, including its input, options, and controls.
      */
     bqBlur: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     /**
@@ -660,16 +657,13 @@ declare interface BqSelect extends Components.BqSelect {
      */
     bqClear: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     /**
-     * Callback handler emitted when the Select input has received focus
+     * Emitted when focus enters the Select from outside the component.
      */
     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 {
@@ -510,12 +510,11 @@ declare class BqDatePicker {
    */
     set firstDayOfWeek(_: Components.BqDatePicker['firstDayOfWeek']);
     /**
-   * Options used when formatting the displayed value.
+   * Numeric options used to derive the input mask's field order and separators.
 
-When omitted, sensible defaults are picked based on `precision`:
-- `day`   → `{ day: 'numeric', month: 'short', year: 'numeric' }`
-- `month` → `{ month: 'long', year: 'numeric' }`
-- `year`  → `{ year: 'numeric' }`
+The options must contain numeric or two-digit day/month fields and a
+numeric year. Textual or variable-length fields fall back to the locale
+numeric mask and emit a development warning.
    */
     set formatOptions(_: Components.BqDatePicker['formatOptions']);
     /**
@@ -571,7 +570,8 @@ the viewport and to preserve keyboard navigation semantics. @default 1
    */
     set panelHeight(_: Components.BqDatePicker['panelHeight']);
     /**
-   * Placeholder text shown when no value is selected.
+   *  @deprecated Locale-derived segment format hints always describe the
+expected entry layout, so this value no longer changes the rendered field.
    */
     set placeholder(_: Components.BqDatePicker['placeholder']);
     /**
@@ -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 {
     /**
@@ -1541,6 +1565,10 @@ In a future major release, `readonly` will prevent changing the selected value.
    */
     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']);
@@ -1563,20 +1591,17 @@ In a future major release, `readonly` will prevent changing the selected value.
     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; }; "disableSearch": { "alias": "disableSearch"; "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 {
     /**
-     * Callback handler emitted when the Select input loses focus
+     * Emitted when focus leaves the entire Select, including its input, options, and controls.
      */
     bqBlur: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     /**
@@ -1584,16 +1609,13 @@ declare interface BqSelect extends Components.BqSelect {
      */
     bqClear: EventEmitter<BqSelectCustomEvent<HTMLBqSelectElement>>;
     /**
-     * Callback handler emitted when the Select input has received focus
+     * Emitted when focus enters the Select from outside the component.
      */
     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
      */