@cute-widgets/base 20.0.1 → 20.0.3

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@cute-widgets/base",
-  "version": "20.0.1",
+  "version": "20.0.3",
   "license": "Apache-2.0",
-  "homepage": "https://github.com/cute-widgets/base#README.md",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cute-widgets/base.git"
@@ -91,6 +90,10 @@
       "types": "./core/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-core.mjs"
     },
+    "./datepicker": {
+      "types": "./datepicker/index.d.ts",
+      "default": "./fesm2022/cute-widgets-base-datepicker.mjs"
+    },
     "./dialog": {
       "types": "./dialog/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-dialog.mjs"
@@ -175,9 +178,9 @@
       "types": "./stepper/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-stepper.mjs"
     },
-    "./datepicker": {
-      "types": "./datepicker/index.d.ts",
-      "default": "./fesm2022/cute-widgets-base-datepicker.mjs"
+    "./table": {
+      "types": "./table/index.d.ts",
+      "default": "./fesm2022/cute-widgets-base-table.mjs"
     },
     "./tabs": {
       "types": "./tabs/index.d.ts",
@@ -199,10 +202,6 @@
       "types": "./tree/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-tree.mjs"
     },
-    "./table": {
-      "types": "./table/index.d.ts",
-      "default": "./fesm2022/cute-widgets-base-table.mjs"
-    },
     "./core/animation": {
       "types": "./core/animation/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-core-animation.mjs"
@@ -227,26 +226,26 @@
       "types": "./core/layout/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-core-layout.mjs"
     },
-    "./core/line": {
-      "types": "./core/line/index.d.ts",
-      "default": "./fesm2022/cute-widgets-base-core-line.mjs"
-    },
     "./core/nav": {
       "types": "./core/nav/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-core-nav.mjs"
     },
+    "./core/line": {
+      "types": "./core/line/index.d.ts",
+      "default": "./fesm2022/cute-widgets-base-core-line.mjs"
+    },
     "./core/observers": {
       "types": "./core/observers/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-core-observers.mjs"
     },
-    "./core/pipes": {
-      "types": "./core/pipes/index.d.ts",
-      "default": "./fesm2022/cute-widgets-base-core-pipes.mjs"
-    },
     "./core/option": {
       "types": "./core/option/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-core-option.mjs"
     },
+    "./core/pipes": {
+      "types": "./core/pipes/index.d.ts",
+      "default": "./fesm2022/cute-widgets-base-core-pipes.mjs"
+    },
     "./core/ripple": {
       "types": "./core/ripple/index.d.ts",
       "default": "./fesm2022/cute-widgets-base-core-ripple.mjs"

package/select/index.d.ts

@@ -1,5 +1,5 @@
 import { FocusOrigin } from '@angular/cdk/a11y';
-import { ScrollStrategy, Overlay, ConnectedPosition, CdkOverlayOrigin, CdkConnectedOverlay } from '@angular/cdk/overlay';
+import { ScrollStrategy, ConnectedPosition, CdkOverlayOrigin, CdkConnectedOverlay } from '@angular/cdk/overlay';
 import { ViewportRuler } from '@angular/cdk/scrolling';
 import * as i0 from '@angular/core';
 import { InjectionToken, DoCheck, NgZone, QueryList, ElementRef, EventEmitter, SimpleChanges } from '@angular/core';
@@ -11,7 +11,6 @@ import { RelativeSize } from '@cute-widgets/base/core/types';
 import { CuteFormFieldControl, CuteFormField } from '@cute-widgets/base/form-field';
 import { ErrorStateMatcher } from '@cute-widgets/base/core/error';
 import { CuteInputDropdownControl } from '@cute-widgets/base/abstract';
-import { AnimationTriggerMetadata } from '@angular/animations';
 import * as i1 from '@angular/common';
 
 /**
@@ -28,8 +27,6 @@ import * as i1 from '@angular/common';
 
 /** Injection token that determines the scroll handling while a select is open. */
 declare const CUTE_SELECT_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
-/** @docs-private */
-declare function CUTE_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY(overlay: Overlay): () => ScrollStrategy;
 /** Object that can be used to configure the default options for the select module. */
 interface CuteSelectConfig {
     /** Whether option centering should be disabled. */
@@ -58,12 +55,6 @@ interface CuteSelectConfig {
 }
 /** Injection token that can be used to provide the default options the select module. */
 declare const CUTE_SELECT_CONFIG: InjectionToken<CuteSelectConfig>;
-/** @docs-private */
-declare const CUTE_SELECT_SCROLL_STRATEGY_PROVIDER: {
-    provide: InjectionToken<() => ScrollStrategy>;
-    deps: (typeof Overlay)[];
-    useFactory: typeof CUTE_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY;
-};
 /**
  * Injection token that can be used to reference instances of `CuteSelectTrigger`. It serves as
  * an alternative token to the actual `CuteSelectTrigger` class which could cause unnecessary
@@ -90,12 +81,16 @@ declare class CuteSelect extends CuteInputDropdownControl implements DoCheck, Cu
     ngControl: NgControl;
     private _liveAnnouncer;
     protected _defaultOptions: CuteSelectConfig | null;
+    protected _animationsDisabled: boolean;
+    private _initialized;
+    private _cleanupDetach;
     /** All the defined select options. */
     options: QueryList<CuteOption> | undefined;
     /** All of the defined groups of options. */
     optionGroups: QueryList<CuteOptgroup> | undefined;
     /** User-supplied override of the trigger element. */
     customTrigger: CuteSelectTrigger | undefined;
+    protected get bsColorVarName(): string;
     /**
      * This position config ensures that the top "start" corner of the overlay
      * is aligned with the top "start" of the origin by default (overlapping
@@ -222,7 +217,7 @@ declare class CuteSelect extends CuteInputDropdownControl implements DoCheck, Cu
      * By default, selecting an option with a `null` or `undefined` value will reset the select's
      * value. Enable this option if the reset behavior doesn't match your requirements and instead,
      * the nullable options should become selected. The value of this input can be controlled app-wide
-     * using the `MAT_SELECT_CONFIG` injection token.
+     * using the `CUTE_SELECT_CONFIG` injection token.
      */
     canSelectNullableOptions: boolean;
     /** Combined stream of all of the child options' change events. */
@@ -280,6 +275,10 @@ declare class CuteSelect extends CuteInputDropdownControl implements DoCheck, Cu
     private _clearFromModal;
     /** Closes the overlay panel and focuses the host element. */
     close(): void;
+    /** Triggers the exit animation and detaches the overlay at the end. */
+    private _exitAndDetach;
+    /** Detaches the current overlay directive. */
+    private _detachOverlay;
     /**
      * Sets the select' value. Part of the ControlValueAccessor interface
      * required to integrate with Angular core forms API.
@@ -303,16 +302,14 @@ declare class CuteSelect extends CuteInputDropdownControl implements DoCheck, Cu
     private _handleClosedKeydown;
     /** Handles keyboard events when the selected is open. */
     private _handleOpenKeydown;
+    /** Handles keyboard events coming from the overlay. */
+    protected _handleOverlayKeydown(event: KeyboardEvent): void;
     _onFocus(): void;
     /**
      * Calls the touched callback only if the panel is closed. Otherwise, the trigger will
      * "blur" to the panel when it opens, causing a false positive.
      */
     _onBlur(): void;
-    /**
-     * Callback that is invoked when the overlay panel has been attached.
-     */
-    _onAttached(): void;
     /** Returns the theme to be used on the panel. */
     _getPanelTheme(): string;
     /** Whether the select has a value. */
@@ -360,8 +357,11 @@ declare class CuteSelect extends CuteInputDropdownControl implements DoCheck, Cu
     protected _getAriaActiveDescendant(): string | null;
     /** Gets the aria-labelledby of the select component trigger. */
     private _getTriggerAriaLabelledby;
-    /** Called when the overlay panel is done animating. */
-    protected _panelDoneAnimating(isOpen: boolean): void;
+    /**
+     * Implemented as part of CuteFormFieldControl.
+     * @docs-private
+     */
+    get describedByIds(): string[];
     /**
      * Implemented as part of CuteFormFieldControl.
      */
@@ -369,11 +369,13 @@ declare class CuteSelect extends CuteInputDropdownControl implements DoCheck, Cu
     /**
      * Implemented as part of CuteFormFieldControl.
      */
-    onContainerClick(): void;
+    onContainerClick(event: MouseEvent): void;
     /**
      * Implemented as part of CuteFormFieldControl.
      */
     get shouldLabelFloat(): boolean;
+    /** `input` element gets focus. */
+    protected onInputFocus(event: FocusEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CuteSelect, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CuteSelect, "cute-select", ["cuteSelect"], { "userAriaDescribedBy": { "alias": "aria-describedby"; "required": false; }; "panelClass": { "alias": "panelClass"; "required": false; }; "disableRipple": { "alias": "disableRipple"; "required": false; }; "hideSingleSelectionIndicator": { "alias": "hideSingleSelectionIndicator"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "disableOptionCentering": { "alias": "disableOptionCentering"; "required": false; }; "compareWith": { "alias": "compareWith"; "required": false; }; "value": { "alias": "value"; "required": false; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; "magnitude": { "alias": "magnitude"; "required": false; }; "typeaheadDebounceInterval": { "alias": "typeaheadDebounceInterval"; "required": false; }; "sortComparator": { "alias": "sortComparator"; "required": false; }; "panelWidth": { "alias": "panelWidth"; "required": false; }; "panelHeight": { "alias": "panelHeight"; "required": false; }; "canSelectNullableOptions": { "alias": "canSelectNullableOptions"; "required": false; }; }, { "openedChange": "openedChange"; "_openedStream": "opened"; "_closedStream": "closed"; "selectionChange": "selectionChange"; "valueChange": "valueChange"; }, ["customTrigger", "options", "optionGroups"], ["cute-select-trigger", "*"], true, never>;
     static ngAcceptInputType_disableRipple: unknown;
@@ -391,36 +393,11 @@ declare class CuteSelectTrigger {
     static ɵdir: i0.ɵɵDirectiveDeclaration<CuteSelectTrigger, "cute-select-trigger", never, {}, {}, never, never, true, never>;
 }
 
-/**
- * @license Apache-2.0
- *
- * Copyright (c) 2025 CuteWidgets Team. All Rights Reserved.
- *
- * You may not use this file except in compliance with the License
- * that can be found at http://www.apache.org/licenses/LICENSE-2.0
- */
-
-/**
- * The following are all the animations for the mat-select component, with each
- * const containing the metadata for one animation.
- *
- * The values below match the implementation of the AngularJS Material mat-select animation.
- * @docs-private
- */
-declare const cuteSelectAnimations: {
-    /**
-     * @deprecated No longer being used. To be removed.
-     * @breaking-change 12.0.0
-     */
-    readonly transformPanelWrap: AnimationTriggerMetadata;
-    readonly transformPanel: AnimationTriggerMetadata;
-};
-
 declare class CuteSelectModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<CuteSelectModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<CuteSelectModule, never, [typeof i1.CommonModule, typeof CuteSelect, typeof CuteSelectTrigger, typeof i3.CuteOptgroup, typeof i3.CuteOption], [typeof CuteSelect, typeof CuteSelectTrigger, typeof i3.CuteOptgroup, typeof i3.CuteOption]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<CuteSelectModule>;
 }
 
-export { CUTE_SELECT_CONFIG, CUTE_SELECT_SCROLL_STRATEGY, CUTE_SELECT_SCROLL_STRATEGY_PROVIDER, CUTE_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY, CUTE_SELECT_TRIGGER, CuteSelect, CuteSelectChange, CuteSelectModule, CuteSelectTrigger, cuteSelectAnimations };
+export { CUTE_SELECT_CONFIG, CUTE_SELECT_SCROLL_STRATEGY, CUTE_SELECT_TRIGGER, CuteSelect, CuteSelectChange, CuteSelectModule, CuteSelectTrigger };
 export type { CuteSelectConfig };

package/sort/index.d.ts

@@ -21,7 +21,7 @@ type SortDirection = 'asc' | 'desc' | '';
 
 /** Position of the arrow that displays when sorted. */
 type SortHeaderArrowPosition = 'before' | 'after';
-/** Interface for a directive that holds sorting state consumed by `MatSortHeader`. */
+/** Interface for a directive that holds sorting state consumed by `CuteSortHeader`. */
 interface CuteSortable {
     /** The id of the column being sorted. */
     id: string;
@@ -46,7 +46,7 @@ interface CuteSortDefaultOptions {
 }
 /** Injection token to be used to override the default options for `mat-sort`. */
 declare const CUTE_SORT_DEFAULT_OPTIONS: InjectionToken<CuteSortDefaultOptions>;
-/** Container for MatSortables to manage the sort state and provide default sort parameters. */
+/** Container for CuteSortables to manage the sort state and provide default sort parameters. */
 declare class CuteSort implements OnChanges, OnDestroy, OnInit {
     private _defaultOptions?;
     private _initializedStream;
@@ -229,7 +229,7 @@ declare class CuteSortHeader implements CuteSortable, OnDestroy, OnInit, AfterVi
     /** whether the sort header is disabled. */
     disabled: boolean;
     /**
-     * Description applied to MatSortHeader's button element with aria-describedby. This text should
+     * Description applied to CuteSortHeader's button element with aria-describedby. This text should
      * describe the action that will occur when the user clicks the sort header.
      */
     get sortActionDescription(): string;
@@ -263,7 +263,7 @@ declare class CuteSortHeader implements CuteSortable, OnDestroy, OnInit, AfterVi
     _toggleOnInteraction(): void;
     _handleClick(): void;
     _handleKeydown(event: KeyboardEvent): void;
-    /** Whether this MatSortHeader is currently sorted in either ascending or descending order. */
+    /** Whether this CuteSortHeader is currently sorted in either ascending or descending order. */
     _isSorted(): boolean;
     /** Returns the animation state for the arrow direction (indicator and pointers). */
     _getArrowDirectionState(): string;

package/table/index.d.ts

@@ -38,6 +38,9 @@ declare class CuteRecycleRows {
     static ɵfac: i0.ɵɵFactoryDeclaration<CuteRecycleRows, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<CuteRecycleRows, "cute-table[recycleRows], table[cute-table][recycleRows]", never, {}, {}, never, never, true, never>;
 }
+/**
+ * @inheritDoc
+ */
 declare class CuteTable<T> extends CdkTable<T> implements OnInit {
     /** Overrides the sticky CSS class set by the `CdkTable`. */
     protected stickyCssClass: string;
@@ -227,10 +230,10 @@ declare class CuteNoDataRow extends CdkNoDataRow {
 
 /**
  * Data source that accepts a client-side data array and includes native support of filtering,
- * sorting (using CuteSort), and pagination (using CutePaginator).
+ * sorting (using `CuteSort`), and pagination (using `CutePaginator`).
  *
- * Allows for sort customization by overriding sortingDataAccessor, which defines how data
- * properties are accessed. It also allows for filter customization by overriding filterPredicate,
+ * Allows for sort customization by overriding `sortingDataAccessor`, which defines how data
+ * properties are accessed. It also allows for filter customization by overriding `filterPredicate`,
  * which defines how row data is converted to a string for filter matching.
  *
  * **Note:** This class is meant to be a simple data source to help you get started. As such,
@@ -269,8 +272,8 @@ declare class CuteTableDataSource<T, P extends CutePaginator = CutePaginator> ex
     get filter(): string;
     set filter(filter: string);
     /**
-     * Instance of the CuteSort directive used by the table to control its sorting. Sort changes
-     * emitted by the CuteSort will trigger an update to the table's rendered data.
+     * Instance of the `CuteSort` directive used by the table to control its sorting. Sort changes
+     * emitted by the `CuteSort` will trigger an update to the table's rendered data.
      */
     get sort(): CuteSort | null;
     set sort(sort: CuteSort | null);
@@ -299,13 +302,13 @@ declare class CuteTableDataSource<T, P extends CutePaginator = CutePaginator> ex
      */
     sortingDataAccessor: (data: T, sortHeaderId: string) => string | number;
     /**
-     * Gets a sorted copy of the data array based on the state of the CuteSort. Called
-     * after changes are made to the filtered data or when sort changes are emitted from CuteSort.
+     * Gets a sorted copy of the data array based on the state of the `CuteSort`. Called
+     * after changes are made to the filtered data or when sort changes are emitted from `CuteSort`.
      * By default, the function retrieves the active sort and its direction and compares data
-     * by retrieving data using the sortingDataAccessor. May be overridden for a custom implementation
+     * by retrieving data using the {@link sortingDataAccessor}. May be overridden for a custom implementation
      * of data ordering.
      * @param data The array of data that should be sorted.
-     * @param sort The connected CuteSort that holds the current sort state.
+     * @param sort The connected `CuteSort` that holds the current sort state.
      */
     sortData: (data: T[], sort: CuteSort) => T[];
     /**
@@ -328,12 +331,12 @@ declare class CuteTableDataSource<T, P extends CutePaginator = CutePaginator> ex
     protected _updateChangeSubscription(): void;
     /**
      * Returns a filtered data array where each filter object contains the filter string within
-     * the result of the filterPredicate function. If no filter is set, return the data array
+     * the result of the {@link filterPredicate} function. If no filter is set, return the data array
      * as provided.
      */
     protected _filterData(data: T[]): T[];
     /**
-     * Returns a sorted copy of the data if CuteSort has a sort applied, otherwise just returns the
+     * Returns a sorted copy of the data if `CuteSort` has a sort applied, otherwise just returns the
      * data array as provided. Uses the default data accessor for data lookup, unless a
      * sortDataAccessor function is defined.
      */
@@ -350,11 +353,11 @@ declare class CuteTableDataSource<T, P extends CutePaginator = CutePaginator> ex
      */
     protected _updatePaginator(filteredDataLength: number): void;
     /**
-     * Used by the CuteTable. Called when it connects to the data source.
+     * Used by the {@link CuteTable}. Called when it connects to the data source.
      */
     connect(): BehaviorSubject<T[]>;
     /**
-     * Used by the CuteTable. Called when it disconnects from the data source.
+     * Used by the {@link CuteTable}. Called when it disconnects from the data source.
      */
     disconnect(): void;
 }

package/tree/index.d.ts

@@ -241,6 +241,7 @@ declare class CuteTreeFlattener<T, F, K = F> {
     getLevel: (node: F) => number;
     isExpandable: (node: F) => boolean;
     getChildren: (node: T) => Observable<T[]> | T[] | undefined | null;
+    private _subscription;
     constructor(transformFunction: (node: T, level: number) => F, getLevel: (node: F) => number, isExpandable: (node: F) => boolean, getChildren: (node: T) => Observable<T[]> | T[] | undefined | null);
     private _flattenNode;
     private _flattenChildren;
@@ -255,6 +256,10 @@ declare class CuteTreeFlattener<T, F, K = F> {
      * The returned list may have different length.
      */
     expandFlattenedNodes(nodes: F[], treeControl: TreeControl<F, K>): F[];
+    /**
+     * Performs the final actions with the flattener before destroying it.
+     */
+    finalize(): void;
 }
 /**
  * Data source for a flat tree.