@flywheel-io/vision 19.4.1 → 19.5.0

package/components/menu/menu-container/menu-container.component.d.ts

@@ -7,6 +7,7 @@ import { FwMenuItemGroupComponent } from '../menu-item-group/menu-item-group.com
 import { FwMenuSeparatorComponent } from '../menu-separator/menu-separator.component';
 import * as i0 from "@angular/core";
 import * as i1 from "@angular/cdk/coercion";
+export type MenuFilterFn = (filter: string, menuItems: readonly FwMenuItemComponent[]) => FwMenuItemComponent[];
 export declare class FwMenuContainerComponent implements AfterViewInit {
     private sanitizer;
     width?: string;
@@ -22,7 +23,7 @@ export declare class FwMenuContainerComponent implements AfterViewInit {
     filteredMenuItems: FwMenuItemComponent[];
     filteredMenuItemChange: import("@angular/core").OutputEmitterRef<FwMenuItemComponent[]>;
     private defaultFilterFn;
-    filterFn: import("@angular/core").InputSignal<(filter: string, menuItems: FwMenuItemComponent[]) => FwMenuItemComponent[]>;
+    filterFn: import("@angular/core").InputSignal<MenuFilterFn>;
     filterChanged: import("@angular/core").OutputEmitterRef<string>;
     filterRef: FwTextInputComponent;
     menu: FwMenuComponent;

package/components/menu/menu-item/menu-item.component.d.ts

@@ -22,25 +22,25 @@ export declare class FwMenuItemComponent implements OnChanges, OnDestroy, AfterC
     subItemsOpen: boolean;
     mouseEnterHandler: import("@angular/core").ModelSignal<MouseEnterHandler>;
     click: EventEmitter<string>;
-    focused?: boolean;
+    focused: import("@angular/core").ModelSignal<boolean>;
     selected?: boolean;
     subItems: QueryList<FwMenuSubItemComponent>;
     private subscriptions;
     constructor(elementRef: ElementRef<HTMLElement>);
-    scrollIntoView(): void;
+    scrollIntoView(options?: ScrollIntoViewOptions): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     ngAfterContentInit(): void;
     onMouseEnter(event: PointerEvent): void;
     updateLayout(): void;
     toggleSubItemsView(): void;
-    handleClick(evt?: Event): void;
+    handleClick(evt: Event): void;
     /**
      * stops the browser built-in tooltip from showing up
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/title
     */
     get attrTitle(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<FwMenuItemComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FwMenuItemComponent, "fw-menu-item", never, { "value": { "alias": "value"; "required": false; }; "size": { "alias": "size"; "required": false; }; "title": { "alias": "title"; "required": false; }; "description": { "alias": "description"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "iconColor": { "alias": "iconColor"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; }; "checkboxColor": { "alias": "checkboxColor"; "required": false; }; "multiSelect": { "alias": "multiSelect"; "required": false; }; "hidden": { "alias": "hidden"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; "href": { "alias": "href"; "required": false; }; "target": { "alias": "target"; "required": false; }; "subItemsOpen": { "alias": "subItemsOpen"; "required": false; }; "mouseEnterHandler": { "alias": "mouseEnterHandler"; "required": false; "isSignal": true; }; "focused": { "alias": "focused"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; }, { "mouseEnterHandler": "mouseEnterHandlerChange"; "click": "click"; }, ["subItems"], ["fw-avatar", "p", "fw-badge", "fw-icon", "fw-icon-button", "fw-menu-sub-item"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FwMenuItemComponent, "fw-menu-item", never, { "value": { "alias": "value"; "required": false; }; "size": { "alias": "size"; "required": false; }; "title": { "alias": "title"; "required": false; }; "description": { "alias": "description"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "iconColor": { "alias": "iconColor"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; }; "checkboxColor": { "alias": "checkboxColor"; "required": false; }; "multiSelect": { "alias": "multiSelect"; "required": false; }; "hidden": { "alias": "hidden"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; "href": { "alias": "href"; "required": false; }; "target": { "alias": "target"; "required": false; }; "subItemsOpen": { "alias": "subItemsOpen"; "required": false; }; "mouseEnterHandler": { "alias": "mouseEnterHandler"; "required": false; "isSignal": true; }; "focused": { "alias": "focused"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; }; }, { "mouseEnterHandler": "mouseEnterHandlerChange"; "click": "click"; "focused": "focusedChange"; }, ["subItems"], ["fw-avatar", "p", "fw-badge", "fw-icon", "fw-icon-button", "fw-menu-sub-item"], true, never>;
 }
 export {};

package/components/select-menu/select-menu.component.d.ts

@@ -1,18 +1,20 @@
 import { CdkMenuTrigger } from '@angular/cdk/menu';
-import { EventEmitter, OnDestroy } from '@angular/core';
+import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
 import { ControlValueAccessor, NgControl } from '@angular/forms';
 import { IconType } from '../icon/icon.types';
 import { FwMenuComponent } from '../menu/menu.component';
+import { MenuFilterFn } from '../menu/menu-container/menu-container.component';
 import { FwMenuItemComponent } from '../menu/menu-item/menu-item.component';
 import { FwMenuItemGroupComponent } from '../menu/menu-item-group/menu-item-group.component';
 import { FwMenuSeparatorComponent } from '../menu/menu-separator/menu-separator.component';
 import { FwTextInputComponent } from '../text-input/text-input.component';
 import * as i0 from "@angular/core";
-export declare class FwSelectMenuComponent implements OnDestroy, ControlValueAccessor {
+type DisplayFn = (menuItem: FwMenuItemComponent) => string;
+export declare class FwSelectMenuComponent implements OnInit, OnDestroy, ControlValueAccessor {
     private ngControl;
     outsideClick(evt: any): void;
     get disabledClass(): boolean;
-    options: import("@angular/core").InputSignal<object[]>;
+    options: import("@angular/core").InputSignal<Object[]>;
     valueProperty: import("@angular/core").InputSignal<string>;
     useFullOptionAsValue: import("@angular/core").InputSignal<boolean>;
     titleProperty: import("@angular/core").InputSignal<string>;
@@ -37,35 +39,45 @@ export declare class FwSelectMenuComponent implements OnDestroy, ControlValueAcc
     menuSeparators: import("@angular/core").Signal<readonly FwMenuSeparatorComponent[]>;
     change: EventEmitter<any>;
     readonly filterChanged: EventEmitter<string>;
-    selectValue: string;
-    selectTitle: import("@angular/core").WritableSignal<string>;
-    selectIcon: IconType | '';
+    selectValue: import("@angular/core").WritableSignal<string>;
+    selectIcon: IconType | undefined;
     filterValue: import("@angular/core").WritableSignal<string>;
+    private menuItemClickSubscriptions;
     private subscriptions;
     private _isOpen;
     focused: number;
     inFocusOpen: boolean;
     preFocusValue: any;
     isTyping: import("@angular/core").WritableSignal<boolean>;
+    valueDisplayFn: import("@angular/core").InputSignal<DisplayFn>;
+    custom(menuItem: FwMenuItemComponent): string;
+    private defaultFilterFn;
+    /**
+     * function for customizing the filter behavior of the select
+     * ! WARNING ! only works with content-projected menu items, does not work with the `options` input
+     */
+    filterFn: import("@angular/core").InputSignal<MenuFilterFn>;
     inputDisplayValue: import("@angular/core").Signal<string>;
     get value(): any;
     set value(newValue: any);
     private _value;
     constructor(ngControl: NgControl);
+    ngOnInit(): void;
+    selectTitle: import("@angular/core").WritableSignal<string>;
     private subscribeToMenuItems;
     private menuItemsWatcher;
     ngOnDestroy(): void;
     get invalid(): boolean;
     get touched(): boolean;
-    filteredOptions: import("@angular/core").Signal<object[]>;
+    filteredOptions: import("@angular/core").Signal<Object[]>;
     optionsWithValues: import("@angular/core").Signal<{
-        raw: object;
+        raw: Object;
         trackingId: any;
         value: any;
     }[]>;
     onChange(newValue: any): void;
     onTouched: () => void;
-    externalOnChange: any;
+    externalOnChange: (_val: unknown) => void;
     registerOnChange(fn: (value: any) => void): void;
     registerOnTouched(fn: () => {}): void;
     setDisabledState(isDisabled: boolean): void;
@@ -94,5 +106,6 @@ export declare class FwSelectMenuComponent implements OnDestroy, ControlValueAcc
     onFilterChanged(value: string): void;
     onInputChange(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<FwSelectMenuComponent, [{ optional: true; self: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FwSelectMenuComponent, "fw-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "valueProperty": { "alias": "valueProperty"; "required": false; "isSignal": true; }; "useFullOptionAsValue": { "alias": "useFullOptionAsValue"; "required": false; "isSignal": true; }; "titleProperty": { "alias": "titleProperty"; "required": false; "isSignal": true; }; "iconProperty": { "alias": "iconProperty"; "required": false; "isSignal": true; }; "staticIcon": { "alias": "staticIcon"; "required": false; "isSignal": true; }; "descriptionProperty": { "alias": "descriptionProperty"; "required": false; "isSignal": true; }; "showFilter": { "alias": "showFilter"; "required": false; "isSignal": true; }; "showReset": { "alias": "showReset"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "errored": { "alias": "errored"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "optionsWidth": { "alias": "optionsWidth"; "required": false; "isSignal": true; }; "minOptionsHeight": { "alias": "minOptionsHeight"; "required": false; "isSignal": true; }; "maxOptionsHeight": { "alias": "maxOptionsHeight"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; }; }, { "disabled": "disabledChange"; "change": "change"; "filterChanged": "filterChanged"; }, ["menuItems", "menuItemGroups", "menuSeparators"], ["[fw-menu-item, fw-menu-separator, fw-menu-item-group]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FwSelectMenuComponent, "fw-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "valueProperty": { "alias": "valueProperty"; "required": false; "isSignal": true; }; "useFullOptionAsValue": { "alias": "useFullOptionAsValue"; "required": false; "isSignal": true; }; "titleProperty": { "alias": "titleProperty"; "required": false; "isSignal": true; }; "iconProperty": { "alias": "iconProperty"; "required": false; "isSignal": true; }; "staticIcon": { "alias": "staticIcon"; "required": false; "isSignal": true; }; "descriptionProperty": { "alias": "descriptionProperty"; "required": false; "isSignal": true; }; "showFilter": { "alias": "showFilter"; "required": false; "isSignal": true; }; "showReset": { "alias": "showReset"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "errored": { "alias": "errored"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "optionsWidth": { "alias": "optionsWidth"; "required": false; "isSignal": true; }; "minOptionsHeight": { "alias": "minOptionsHeight"; "required": false; "isSignal": true; }; "maxOptionsHeight": { "alias": "maxOptionsHeight"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "valueDisplayFn": { "alias": "valueDisplayFn"; "required": false; "isSignal": true; }; "filterFn": { "alias": "filterFn"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; }; }, { "disabled": "disabledChange"; "change": "change"; "filterChanged": "filterChanged"; }, ["menuItems", "menuItemGroups", "menuSeparators"], ["[fw-menu-item, fw-menu-separator, fw-menu-item-group]"], true, never>;
 }
+export {};

package/components/timezone-select/time-zone-select.component.d.ts

@@ -0,0 +1,38 @@
+import { OnInit } from '@angular/core';
+import { FormControl, NgControl } from '@angular/forms';
+import { FwMenuItemComponent, MenuFilterFn } from '../../public-api';
+import * as i0 from "@angular/core";
+import * as i1 from "../../directives/NoopValueAccessor.directive";
+interface TimeZoneOption {
+    name: string;
+    fullTZ: string;
+    description: string;
+}
+interface TimeZoneOptionsByRegion {
+    [region: string]: TimeZoneOption[];
+}
+/**
+ *  Form control for selecting a time zone, based on fw-select
+ *  @see [Vision Docs](https://cdn.flywheel.io/docs/vision/latest/?path=/docs/form-controls-timezone-select--docs)
+ */
+export declare class FwTimeZoneSelectComponent implements OnInit {
+    protected ngControl: NgControl;
+    protected internalControl: FormControl<string>;
+    /**
+     * whether the control pre-populates the user's timezone on init
+     */
+    prefillTimeZone: import("@angular/core").InputSignal<boolean>;
+    protected timezonesByRegion: import("@angular/core").WritableSignal<TimeZoneOptionsByRegion>;
+    protected regions: import("@angular/core").WritableSignal<string[]>;
+    protected usersTimezone: import("@angular/core").WritableSignal<string>;
+    ngOnInit(): void;
+    protected readonly filterFn: MenuFilterFn;
+    protected readonly displayFn: (menuItem: FwMenuItemComponent) => string;
+    private buildTimezoneList;
+    private parseTimeZoneName;
+    private getTimeZoneOffset;
+    private getTimeZoneAcronym;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FwTimeZoneSelectComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FwTimeZoneSelectComponent, "fw-time-zone-select", never, { "prefillTimeZone": { "alias": "prefillTimeZone"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.NoopValueAccessorDirective; inputs: {}; outputs: {}; }]>;
+}
+export {};

package/components/wrapped-input/wrapped-input.component.d.ts

@@ -9,5 +9,5 @@ export declare class FwWrappedInputComponent {
     required?: boolean;
     class: boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<FwWrappedInputComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FwWrappedInputComponent, "fw-wrapped-input", never, { "title": { "alias": "title"; "required": false; }; "status": { "alias": "status"; "required": false; }; "statusColor": { "alias": "statusColor"; "required": false; }; "description": { "alias": "description"; "required": false; }; "helperText": { "alias": "helperText"; "required": false; }; "errorText": { "alias": "errorText"; "required": false; }; "required": { "alias": "required"; "required": false; }; }, {}, never, ["fw-form-heading", "fw-button-toggle, fw-date-input, fw-text-input, fw-number-input, fw-phone-input, fw-textarea-input, fw-select, fw-multi-select, fw-checkbox, fw-typeahead"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FwWrappedInputComponent, "fw-wrapped-input", never, { "title": { "alias": "title"; "required": false; }; "status": { "alias": "status"; "required": false; }; "statusColor": { "alias": "statusColor"; "required": false; }; "description": { "alias": "description"; "required": false; }; "helperText": { "alias": "helperText"; "required": false; }; "errorText": { "alias": "errorText"; "required": false; }; "required": { "alias": "required"; "required": false; }; }, {}, never, ["fw-form-heading", "fw-button-toggle, fw-date-input, fw-text-input, fw-number-input, fw-phone-input, fw-textarea-input, fw-select, fw-multi-select, fw-checkbox, fw-typeahead, fw-time-zone-select"], true, never>;
 }

package/directives/NoopValueAccessor.directive.d.ts

@@ -0,0 +1,15 @@
+import { ControlValueAccessor } from '@angular/forms';
+import * as i0 from "@angular/core";
+/**
+ * Directive for forwarding an ngControl to a child component
+ *
+ * Intended to be used as a host directive
+ * @see [Medium Article on the approach](https://medium.com/netanelbasal/forwarding-form-controls-to-custom-control-components-in-angular-701e8406cc55)
+ */
+export declare class NoopValueAccessorDirective implements ControlValueAccessor {
+    writeValue(_obj: any): void;
+    registerOnChange(_fn: any): void;
+    registerOnTouched(_fn: any): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NoopValueAccessorDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NoopValueAccessorDirective, never, never, {}, {}, never, never, true, never>;
+}