@esri/calcite-components 1.0.0-next.631 → 1.0.0-next.633

package/dist/types/components/tip/resources.d.ts

@@ -1,4 +1,3 @@
-import { HeadingLevel } from "../functional/Heading";
 export declare const CSS: {
   container: string;
   header: string;
@@ -17,4 +16,3 @@ export declare const SLOTS: {
 export declare const TEXT: {
   close: string;
 };
-export declare const HEADING_LEVEL: HeadingLevel;

package/dist/types/components/tip-manager/resources.d.ts

@@ -23,4 +23,3 @@ export declare const TEXT: {
   previous: string;
   next: string;
 };
-export declare const HEADING_LEVEL = 2;

package/dist/types/components/value-list/value-list.d.ts

@@ -16,6 +16,18 @@ export declare class ValueList<ItemElement extends HTMLCalciteValueListItemEleme
    * When `true`, `calcite-value-list-item`s are sortable via a draggable button.
    */
   dragEnabled: boolean;
+  /**
+   * **read-only** The currently filtered items
+   *
+   * @readonly
+   */
+  filteredItems: HTMLCalciteValueListItemElement[];
+  /**
+   * **read-only** The currently filtered items
+   *
+   * @readonly
+   */
+  filteredData: ItemData;
   /**
    * When `true`, an input appears at the top of the component that can be used by end users to filter list items.
    */
@@ -24,6 +36,10 @@ export declare class ValueList<ItemElement extends HTMLCalciteValueListItemEleme
    * Placeholder text for the filter's input field.
    */
   filterPlaceholder: string;
+  /**
+   * Text for the filter input field.
+   */
+  filterText: string;
   /**
    * The component's group identifier.
    *
@@ -77,6 +93,7 @@ export declare class ValueList<ItemElement extends HTMLCalciteValueListItemEleme
   sortable: Sortable;
   el: HTMLCalciteValueListElement;
   emitCalciteListChange: () => void;
+  emitCalciteListFilter: () => void;
   filterEl: HTMLCalciteFilterElement;
   assistiveTextEl: HTMLSpanElement;
   connectedCallback(): void;
@@ -91,6 +108,10 @@ export declare class ValueList<ItemElement extends HTMLCalciteValueListItemEleme
    * Emits when the order of the list has changed.
    */
   calciteListOrderChange: EventEmitter<any[]>;
+  /**
+   * Emits when a filter has changed.
+   */
+  calciteListFilter: EventEmitter<void>;
   calciteListFocusOutHandler(event: FocusEvent): void;
   calciteListItemRemoveHandler(event: CustomEvent<void>): void;
   calciteListItemChangeHandler(event: CustomEvent): void;
@@ -100,12 +121,14 @@ export declare class ValueList<ItemElement extends HTMLCalciteValueListItemEleme
   setUpItems(): void;
   setUpFilter(): void;
   setFilterEl: (el: HTMLCalciteFilterElement) => void;
+  setFilteredItems: (filteredItems: HTMLCalciteValueListItemElement[]) => void;
   setUpDragAndDrop(): void;
   cleanUpDragAndDrop(): void;
   deselectRemovedItems: any;
   deselectSiblingItems: any;
   selectSiblings: any;
   handleFilter: any;
+  handleFilterEvent: any;
   getItemData: any;
   keyDownHandler: (event: KeyboardEvent) => void;
   handleBlur(): void;

package/dist/types/components.d.ts

@@ -28,7 +28,7 @@ import { InputPlacement } from "./components/input/interfaces";
 import { InputPlacement as InputPlacement1 } from "./components/input-number/interfaces";
 import { ModalBackgroundColor } from "./components/modal/interfaces";
 import { PaginationDetail } from "./components/pagination/pagination";
-import { ListFocusId } from "./components/pick-list/shared-list-logic";
+import { ItemData, ListFocusId } from "./components/pick-list/shared-list-logic";
 import { ICON_TYPES } from "./components/pick-list/resources";
 import { RadioAppearance } from "./components/radio-group/interfaces";
 import { StepperItemChangeEventDetail, StepperItemEventDetail, StepperItemKeyEventDetail } from "./components/stepper/interfaces";
@@ -2771,6 +2771,20 @@ export namespace Components {
           * Placeholder text for the filter input field.
          */
         "filterPlaceholder": string;
+        /**
+          * Text for the filter input field.
+         */
+        "filterText": string;
+        /**
+          * **read-only** The currently filtered items
+          * @readonly
+         */
+        "filteredData": ItemData;
+        /**
+          * **read-only** The currently filtered items
+          * @readonly
+         */
+        "filteredItems": HTMLCalcitePickListItemElement[];
         /**
           * Returns the component's selected `calcite-pick-list-item`s.
          */
@@ -4093,6 +4107,20 @@ export namespace Components {
           * Placeholder text for the filter's input field.
          */
         "filterPlaceholder": string;
+        /**
+          * Text for the filter input field.
+         */
+        "filterText": string;
+        /**
+          * **read-only** The currently filtered items
+          * @readonly
+         */
+        "filteredData": ItemData;
+        /**
+          * **read-only** The currently filtered items
+          * @readonly
+         */
+        "filteredItems": HTMLCalciteValueListItemElement[];
         /**
           * Returns the currently selected items
          */
@@ -7902,6 +7930,20 @@ declare namespace LocalJSX {
           * Placeholder text for the filter input field.
          */
         "filterPlaceholder"?: string;
+        /**
+          * Text for the filter input field.
+         */
+        "filterText"?: string;
+        /**
+          * **read-only** The currently filtered items
+          * @readonly
+         */
+        "filteredData"?: ItemData;
+        /**
+          * **read-only** The currently filtered items
+          * @readonly
+         */
+        "filteredItems"?: HTMLCalcitePickListItemElement[];
         /**
           * Specifies the number at which section headings should start.
          */
@@ -7918,6 +7960,10 @@ declare namespace LocalJSX {
           * Emits when any of the `calcite-pick-list-item` selections have changed.
          */
         "onCalciteListChange"?: (event: CalcitePickListCustomEvent<Map<string, HTMLCalcitePickListItemElement>>) => void;
+        /**
+          * Emits when a filter has changed.
+         */
+        "onCalciteListFilter"?: (event: CalcitePickListCustomEvent<void>) => void;
         /**
           * When `true` and single selection is enabled, the selection changes when navigating `calcite-pick-list-item`s via keyboard.
          */
@@ -9156,6 +9202,20 @@ declare namespace LocalJSX {
           * Placeholder text for the filter's input field.
          */
         "filterPlaceholder"?: string;
+        /**
+          * Text for the filter input field.
+         */
+        "filterText"?: string;
+        /**
+          * **read-only** The currently filtered items
+          * @readonly
+         */
+        "filteredData"?: ItemData;
+        /**
+          * **read-only** The currently filtered items
+          * @readonly
+         */
+        "filteredItems"?: HTMLCalciteValueListItemElement[];
         /**
           * The component's group identifier.  To drag elements from one list into another, both lists must have the same group value.
          */
@@ -9188,6 +9248,10 @@ declare namespace LocalJSX {
           * Emits when any of the list item selections have changed.
          */
         "onCalciteListChange"?: (event: CalciteValueListCustomEvent<Map<string, HTMLCalciteValueListItemElement>>) => void;
+        /**
+          * Emits when a filter has changed.
+         */
+        "onCalciteListFilter"?: (event: CalciteValueListCustomEvent<void>) => void;
         /**
           * Emits when the order of the list has changed.
          */

package/dist/types/preact.d.ts

@@ -250,8 +250,9 @@ declare module "preact/src/jsx" {
         "oncalcitePanelBackClick"?: (event: CustomEvent<any>) => void;
       }
 
-      "calcite-pick-list": Omit<JSX.CalcitePickList, "onCalciteListChange"> & JSXInternal.HTMLAttributes<HTMLCalcitePickListElement> & {
+      "calcite-pick-list": Omit<JSX.CalcitePickList, "onCalciteListChange" | "onCalciteListFilter"> & JSXInternal.HTMLAttributes<HTMLCalcitePickListElement> & {
         "oncalciteListChange"?: (event: CustomEvent<any>) => void;
+        "oncalciteListFilter"?: (event: CustomEvent<any>) => void;
       }
 
       "calcite-pick-list-group": JSX.CalcitePickListGroup & JSXInternal.HTMLAttributes<HTMLCalcitePickListGroupElement>
@@ -401,9 +402,10 @@ declare module "preact/src/jsx" {
         "oncalciteInternalTreeItemSelect"?: (event: CustomEvent<any>) => void;
       }
 
-      "calcite-value-list": Omit<JSX.CalciteValueList, "onCalciteListChange" | "onCalciteListOrderChange"> & JSXInternal.HTMLAttributes<HTMLCalciteValueListElement> & {
+      "calcite-value-list": Omit<JSX.CalciteValueList, "onCalciteListChange" | "onCalciteListOrderChange" | "onCalciteListFilter"> & JSXInternal.HTMLAttributes<HTMLCalciteValueListElement> & {
         "oncalciteListChange"?: (event: CustomEvent<any>) => void;
         "oncalciteListOrderChange"?: (event: CustomEvent<any>) => void;
+        "oncalciteListFilter"?: (event: CustomEvent<any>) => void;
       }
 
       "calcite-value-list-item": Omit<JSX.CalciteValueListItem, "onCalciteListItemRemove"> & JSXInternal.HTMLAttributes<HTMLCalciteValueListItemElement> & {

package/dist/types/utils/conditionalSlot.d.ts

@@ -1,5 +1,11 @@
 /**
  * Defines interface for components with a dynamically changing slot.
+ *
+ * @deprecated Use `onSlotchange` event with `slotChangeHasAssignedElement` DOM utility instead.
+ *
+ * ```
+ * <slot onSlotchange={(event) => this.mySlotHasElement = slotChangeHasAssignedElement(event)} />}
+ * ```
  */
 export interface ConditionalSlotComponent {
   /**
@@ -11,11 +17,21 @@ export interface ConditionalSlotComponent {
  * Helper to set up a conditional slot component on connectedCallback.
  *
  * @param component
+ * @deprecated Use `onSlotchange` event with `slotChangeHasAssignedElement` DOM utility instead.
+ *
+ * ```
+ * <slot onSlotchange={(event) => this.mySlotHasElement = slotChangeHasAssignedElement(event)} />}
+ * ```
  */
 export declare function connectConditionalSlotComponent(component: ConditionalSlotComponent): void;
 /**
  * Helper to tear down a conditional slot component on disconnectedCallback.
  *
  * @param component
+ * @deprecated Use `onSlotchange` event with `slotChangeHasAssignedElement` DOM utility instead.
+ *
+ * ```
+ * <slot onSlotchange={(event) => this.mySlotHasElement = slotChangeHasAssignedElement(event)} />}
+ * ```
  */
 export declare function disconnectConditionalSlotComponent(component: ConditionalSlotComponent): void;

package/dist/types/utils/dom.d.ts

@@ -51,6 +51,18 @@ interface GetSlottedOptions {
   matches?: string;
   selector?: string;
 }
+/**
+ * Gets slotted elements for a named slot.
+ *
+ * @param element
+ * @param slotName
+ * @param options
+ * @deprecated Use `onSlotchange` event instead.
+ *
+ * ```
+ * <slot onSlotchange={(event) => this.myElements = slotChangeGetAssignedElements(event)} />}
+ * ```
+ */
 export declare function getSlotted<T extends Element = Element>(element: Element, slotName: string | string[] | (GetSlottedOptions & {
   all: true;
 }), options: GetSlottedOptions & {
@@ -69,6 +81,28 @@ export declare function intersects(rect1: DOMRect, rect2: DOMRect): boolean;
  * @returns {string} The string conversion of a boolean value ("true" | "false").
  */
 export declare function toAriaBoolean(value: boolean): string;
+/**
+ * This helper returns `true` if the target `slot` element from the `onSlotchange` event has an assigned element.
+ *
+ * ```
+ * <slot onSlotchange={(event) => this.mySlotHasElement = slotChangeHasAssignedElement(event)} />}
+ * ```
+ *
+ * @param event
+ * @returns {boolean} Whether the slot has any assigned elements.
+ */
+export declare function slotChangeHasAssignedElement(event: Event): boolean;
+/**
+ * This helper returns the assigned elements on a `slot` element from the `onSlotchange` event.
+ *
+ * ```
+ * <slot onSlotchange={(event) => this.mySlotElements = slotChangeGetAssignedElements(event)} />}
+ * ```
+ *
+ * @param event
+ * @returns {boolean} Whether the slot has any assigned elements.
+ */
+export declare function slotChangeGetAssignedElements(event: Event): Element[];
 /**
  * This helper returns true if the pointer event fired from the primary button of the device.
  *

package/dist/types/utils/focusTrapComponent.d.ts

@@ -0,0 +1,33 @@
+import { FocusTrap as _FocusTrap } from "focus-trap";
+/**
+ * Defines interface for components with a focus trap.
+ */
+export interface FocusTrapComponent {
+  /**
+   * The focus trap instance.
+   */
+  focusTrap: FocusTrap;
+  /**
+   * The focus trap element.
+   */
+  focusTrapEl: HTMLElement;
+}
+export declare type FocusTrap = _FocusTrap;
+/**
+ * Helper to set up focus trap component.
+ *
+ * @param component
+ */
+export declare function connectFocusTrap(component: FocusTrapComponent): void;
+/**
+ * Helper to activate focus trap component.
+ *
+ * @param component
+ */
+export declare function activateFocusTrap(component: FocusTrapComponent): void;
+/**
+ * Helper to tear deactivate focus trap component.
+ *
+ * @param component
+ */
+export declare function deactivateFocusTrap(component: FocusTrapComponent): void;

package/dist/types/utils/locale.d.ts

@@ -67,7 +67,7 @@ export interface NumberStringFormatOptions extends Intl.NumberFormatOptions {
 /**
  * This util formats and parses numbers for localization
  */
-declare class NumberStringFormat {
+export declare class NumberStringFormat {
   /**
    * The actual group separator for the specified locale.
    * Some white space group separators don't render correctly in the browser,
@@ -96,4 +96,3 @@ declare class NumberStringFormat {
   localize: (numberString: string) => string;
 }
 export declare const numberStringFormatter: NumberStringFormat;
-export {};

package/dist/types/utils/number.d.ts

@@ -1,3 +1,4 @@
+import { NumberStringFormat } from "./locale";
 export declare class BigDecimal {
   value: bigint;
   isNegative: boolean;
@@ -5,15 +6,19 @@ export declare class BigDecimal {
   static ROUNDED: boolean;
   static SHIFT: bigint;
   constructor(input: string | BigDecimal);
-  static _divRound(dividend: bigint, divisor: bigint): bigint;
-  static fromBigInt(bigint: bigint): bigint;
+  static _divRound: (dividend: bigint, divisor: bigint) => bigint;
+  static fromBigInt: (bigint: bigint) => bigint;
+  getIntegersAndDecimals(): {
+    integers: string;
+    decimals: string;
+  };
   toString(): string;
-  formatToParts(formatter: Intl.NumberFormat): Intl.NumberFormatPart[];
-  format(formatter: Intl.NumberFormat): string;
-  add(num: string): bigint;
-  subtract(num: string): bigint;
-  multiply(num: string): bigint;
-  divide(num: string): bigint;
+  formatToParts(formatter: NumberStringFormat): Intl.NumberFormatPart[];
+  format(formatter: NumberStringFormat): string;
+  add: (num: string) => bigint;
+  subtract: (num: string) => bigint;
+  multiply: (num: string) => bigint;
+  divide: (num: string) => bigint;
 }
 export declare function isValidNumber(numberString: string): boolean;
 export declare function parseNumberString(numberString?: string): string;