@esri/calcite-components 1.0.0-beta.95 → 1.0.0-beta.97

package/dist/types/components/combobox/combobox.d.ts

@@ -16,59 +16,61 @@ interface ItemData {
 export declare class Combobox implements LabelableComponent, FormComponent, InteractiveComponent, OpenCloseComponent, FloatingUIComponent {
   el: HTMLCalciteComboboxElement;
   /**
-   * When true, opens the combobox
+   * When `true`, displays and positions the component.
    *
-   * @deprecated use open instead
+   * @deprecated use `open` instead.
    */
   active: boolean;
   activeHandler(value: boolean): void;
-  /**When true, opens the combobox */
+  /**When `true`, displays and positions the component. */
   open: boolean;
   openHandler(value: boolean): void;
-  /** Disable combobox input */
+  /** When `true`, interaction is prevented and the component is displayed with lower opacity. */
   disabled: boolean;
   handleDisabledChange(value: boolean): void;
-  /** Aria label for combobox (required) */
+  /** Accessible name for the component. */
   label: string;
-  /** Placeholder text for input */
+  /** Specifies the placeholder text for the input. */
   placeholder?: string;
-  /** Placeholder icon for input  */
+  /** Specifies the placeholder icon for the input. */
   placeholderIcon?: string;
-  /** Specify the maximum number of combobox items (including nested children) to display before showing the scroller */
+  /** Specifies the maximum number of `calcite-combobox-item`s (including nested children) to display before displaying a scrollbar. */
   maxItems: number;
   maxItemsHandler(): void;
-  /** The name of the switch input */
+  /** Specifies the name of the component on form submission. */
   name: string;
-  /** Allow entry of custom values which are not in the original set of items */
+  /** When `true`, allows entry of custom values, which are not in the original set of items. */
   allowCustomValues: boolean;
   /**
    * Determines the type of positioning to use for the overlaid content.
    *
-   * Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+   * Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.
+   *
+   * `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
    *
    */
   overlayPositioning: OverlayPositioning;
   overlayPositioningHandler(): void;
   /**
-   * When true, makes the component required for form-submission.
+   * When `true`, the component must have a value in order for the form to submit.
    *
    * @internal
    */
   required: boolean;
   /**
-   * specify the selection mode
-   * - multi: allow any number of selected items (default)
-   * - single: only one selection)
-   * - ancestors: like multi, but show ancestors of selected items as selected, only deepest children shown in chips
+   * Specifies the selection mode -
+   * `"multi"` (allow any number of selected items),
+   * `"single"` (allow only one selection), or
+   * `"ancestors"` (like `"multi"`, but show ancestors of selected items as selected. Only the deepest children are shown in `calcite-chip`s).
    */
   selectionMode: ComboboxSelectionMode;
-  /** Specify the scale of the combobox, defaults to m */
+  /** Specifies the size of the component. */
   scale: Scale;
-  /** The value(s) of the selectedItem(s) */
+  /** The component's value(s) from the selected `calcite-combobox-item`(s). */
   value: string | string[];
   valueHandler(value: string | string[]): void;
   /**
-   * string to override the English "Remove tag" text for when an item is selected.
+   * Accessible name for the component's remove tag when a `calcite-combobox-item` is selected.
    *
    * @default "Remove tag"
    */
@@ -78,36 +80,40 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
    */
   flipPlacements?: EffectivePlacement[];
   flipPlacementsHandler(): void;
-  documentClickHandler(event: Event): void;
+  documentClickHandler(event: PointerEvent): void;
   calciteComboboxItemChangeHandler(event: CustomEvent<HTMLCalciteComboboxItemElement>): void;
-  /** Updates the position of the component. */
-  reposition(): Promise<void>;
+  /**
+   * Updates the position of the component.
+   *
+   * @param delayed
+   */
+  reposition(delayed?: boolean): Promise<void>;
   /** Sets focus on the component. */
   setFocus(): Promise<void>;
   /**
-   * Called when the selected items set changes
+   * Fires when the selected items set changes.
    *
-   * @deprecated use calciteComboboxChange instead
+   * @deprecated use `calciteComboboxChange` instead.
    */
   calciteLookupChange: EventEmitter<HTMLCalciteComboboxItemElement[]>;
   /**
-   * Called when the selected item(s) changes.
+   * Fires when the selected item(s) changes.
    */
   calciteComboboxChange: EventEmitter<{
     selectedItems: HTMLCalciteComboboxItemElement[];
   }>;
-  /** Called when the user has entered text to filter the options list */
+  /** Fires when text is added to filter the options list. */
   calciteComboboxFilterChange: EventEmitter<{
     visibleItems: HTMLCalciteComboboxItemElement[];
     text: string;
   }>;
   /**
-   * Called when a selected item in the combobox is dismissed via its chip
+   * Fires when a selected item in the component is dismissed via its `calcite-chip`.
    *
-   * **Note:**: The event payload is deprecated, please use the `value` property on the component to determine removed value instead
+   * **Note:**: The event payload is deprecated, please use the `value` property on the component to determine the removed value instead.
    */
   calciteComboboxChipDismiss: EventEmitter<DeprecatedEventPayload>;
-  /** Fires when the component is requested to be closed and before the closing transition begins. */
+  /** Fires when the component is requested to be closed, and before the closing transition begins. */
   calciteComboboxBeforeClose: EventEmitter<void>;
   /** Fires when the component is closed and animation is complete. */
   calciteComboboxClose: EventEmitter<void>;
@@ -140,7 +146,7 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
   textHandler(): void;
   textInput: HTMLInputElement;
   data: ItemData[];
-  mutationObserver: MutationObserver;
+  mutationObserver: import("../../utils/observers").ExtendedMutationObserver;
   resizeObserver: ResizeObserver;
   private guid;
   private inputHeight;
@@ -150,7 +156,6 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
   private ignoreSelectedEventsFlag;
   openTransitionProp: string;
   transitionEl: HTMLDivElement;
-  private debouncedReposition;
   setFilteredPlacements: () => void;
   getValue: () => string | string[];
   onLabelClick: () => void;

package/dist/types/components/combobox-item/combobox-item.d.ts

@@ -7,31 +7,33 @@ import { InteractiveComponent } from "../../utils/interactive";
  * @slot - A slot for adding nested `calcite-combobox-item`s.
  */
 export declare class ComboboxItem implements ConditionalSlotComponent, InteractiveComponent {
-  /** When true, the item cannot be clicked and is visually muted. */
+  /** When `true`, interaction is prevented and the component is displayed with lower opacity. */
   disabled: boolean;
-  /** Set this to true to pre-select an item. Toggles when an item is checked/unchecked. */
+  /**
+   * When `true`, the component is selected.
+   */
   selected: boolean;
-  /** True when item is highlighted either from keyboard or mouse hover */
+  /** When `true`, the component is active. */
   active: boolean;
-  /** Parent and grandparent combobox items, this is set internally for use from combobox */
+  /** Specifies the parent and grandparent items, which are set on `calcite-combobox`. */
   ancestors: ComboboxChildElement[];
-  /** Unique identifier, used for accessibility */
+  /** The `id` attribute of the component. When omitted, a globally unique identifier is used. */
   guid: string;
-  /** Custom icon to display both in combobox chips and next to combobox item text */
+  /** Specifies an icon to display. */
   icon?: string;
   selectedWatchHandler(): void;
-  /** The main label for this item. */
+  /** The component's text. */
   textLabel: string;
-  /** The item's associated value */
+  /** The component's value. */
   value: any;
   /**
-   * Don't filter this item based on the search text
+   * When `true`, omits the component from the `calcite-combobox` filtered search results.
    *
-   * @deprecated use filterDisabled instead
+   * @deprecated use `filterDisabled` instead.
    */
   constant: boolean;
   /**
-   * Do not filter this item based on the search text
+   * When `true`, omits the component from the `calcite-combobox` filtered search results.
    */
   filterDisabled: boolean;
   el: HTMLCalciteComboboxItemElement;
@@ -41,9 +43,9 @@ export declare class ComboboxItem implements ConditionalSlotComponent, Interacti
   disconnectedCallback(): void;
   componentDidRender(): void;
   /**
-   * Emitted whenever the item is selected or unselected.
+   * Emits whenever the component is selected or unselected.
    *
-   * **Note:**: The event's payload is deprecated, please use the event's target/currentTarget instead
+   * **Note:**: The event's payload is deprecated, please use the event's `target`/`currentTarget` instead
    */
   calciteComboboxItemChange: EventEmitter<DeprecatedEventPayload>;
   /**

package/dist/types/components/combobox-item-group/combobox-item-group.d.ts

@@ -5,9 +5,9 @@ import { Scale } from "../interfaces";
  * @slot - A slot for adding `calcite-combobox-item`s.
  */
 export declare class ComboboxItemGroup {
-  /** Parent and grandparent combobox items, this is set internally for use from combobox */
+  /** Specifies the parent and grandparent `calcite-combobox-item`s, which are set on `calcite-combobox`. */
   ancestors: ComboboxChildElement[];
-  /** Title of the group */
+  /** Specifies the title of the component. */
   label: string;
   connectedCallback(): void;
   el: HTMLCalciteComboboxItemGroupElement;

package/dist/types/components/date-picker/assets/date-picker/t9n/index.d.ts

@@ -0,0 +1,5 @@
+export type Messages = {
+  nextMonth: string;
+  prevMonth: string;
+  year: string;
+};

package/dist/types/components/date-picker/date-picker.d.ts

@@ -1,9 +1,8 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { HeadingLevel } from "../functional/Heading";
 import { DateRangeChange } from "./interfaces";
-import { GlobalAttrComponent } from "../../utils/globalAttributes";
-import { LangComponent } from "../../utils/locale";
-export declare class DatePicker implements GlobalAttrComponent, LangComponent {
+import { LocalizedComponent, NumberingSystem } from "../../utils/locale";
+export declare class DatePicker implements LocalizedComponent {
   el: HTMLCalciteDatePickerElement;
   /** Active range */
   activeRange?: "start" | "end";
@@ -58,12 +57,17 @@ export declare class DatePicker implements GlobalAttrComponent, LangComponent {
    */
   intlYear?: string;
   /**
-   * BCP 47 language tag for desired language and country format
+   * Specifies the BCP 47 language tag for the desired language and country format.
    *
    * @deprecated set the global `lang` attribute on the element instead.
    * @mdn [lang](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
    */
   locale?: string;
+  /**
+   * Specifies the Unicode numeral system used by the component for localization. This property cannot be dynamically changed.
+   *
+   */
+  numberingSystem?: NumberingSystem;
   /** specify the scale of the date picker */
   scale: "s" | "m" | "l";
   /** Range mode activation */
@@ -109,6 +113,7 @@ export declare class DatePicker implements GlobalAttrComponent, LangComponent {
   disconnectedCallback(): void;
   componentWillLoad(): Promise<void>;
   render(): VNode;
+  effectiveLocale: string;
   private localeData;
   private hoverRange;
   private mostRecentRangeValue?;

package/dist/types/components/date-picker-day/date-picker-day.d.ts

@@ -1,5 +1,4 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
-import { DateLocaleData } from "../date-picker/utils";
 import { Scale } from "../interfaces";
 import { InteractiveComponent } from "../../utils/interactive";
 export declare class DatePickerDay implements InteractiveComponent {
@@ -24,8 +23,6 @@ export declare class DatePickerDay implements InteractiveComponent {
   rangeHover: boolean;
   /** Date is actively in focus for keyboard navigation */
   active: boolean;
-  /** CLDR data for current locale */
-  localeData: DateLocaleData;
   /** specify the scale of the date picker */
   scale: Scale;
   /** Date value for the day. */
@@ -43,7 +40,9 @@ export declare class DatePickerDay implements InteractiveComponent {
    * @internal
    */
   calciteInternalDayHover: EventEmitter<void>;
+  componentWillLoad(): void;
   render(): VNode;
   componentDidRender(): void;
   isTabbable(): boolean;
+  private parentDatePickerEl;
 }

package/dist/types/components/date-picker-month-header/date-picker-month-header.d.ts

@@ -30,11 +30,13 @@ export declare class DatePickerMonthHeader {
    *  Changes to active date
    */
   calciteDatePickerSelect: EventEmitter<Date>;
+  componentWillLoad(): void;
   connectedCallback(): void;
   render(): VNode;
   renderContent(): VNode;
   globalAttributes: {};
   private yearInput;
+  private parentDatePickerEl;
   nextMonthDate: Date;
   prevMonthDate: Date;
   setNextPrevMonthDates(): void;

package/dist/types/components/dropdown/dropdown.d.ts

@@ -43,7 +43,9 @@ export declare class Dropdown implements InteractiveComponent, OpenCloseComponen
   /**
    * Determines the type of positioning to use for the overlaid content.
    *
-   * Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+   * Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.
+   *
+   * `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
    *
    */
   overlayPositioning: OverlayPositioning;
@@ -72,8 +74,12 @@ export declare class Dropdown implements InteractiveComponent, OpenCloseComponen
   componentDidRender(): void;
   disconnectedCallback(): void;
   render(): VNode;
-  /** Updates the position of the component. */
-  reposition(): Promise<void>;
+  /**
+   * Updates the position of the component.
+   *
+   * @param delayed
+   */
+  reposition(delayed?: boolean): Promise<void>;
   /** fires when a dropdown item has been selected or deselected */
   calciteDropdownSelect: EventEmitter<Selection>;
   /** Fires when the component is requested to be closed and before the closing transition begins. */
@@ -84,7 +90,7 @@ export declare class Dropdown implements InteractiveComponent, OpenCloseComponen
   calciteDropdownBeforeOpen: EventEmitter<void>;
   /** Fires when the component is open and animation is complete. */
   calciteDropdownOpen: EventEmitter<void>;
-  closeCalciteDropdownOnClick(event: Event): void;
+  closeCalciteDropdownOnClick(event: PointerEvent): void;
   closeCalciteDropdownOnEvent(event: Event): void;
   closeCalciteDropdownOnOpenEvent(event: Event): void;
   mouseEnterHandler(): void;
@@ -99,13 +105,12 @@ export declare class Dropdown implements InteractiveComponent, OpenCloseComponen
   floatingEl: HTMLDivElement;
   referenceEl: HTMLDivElement;
   private scrollerEl;
-  mutationObserver: MutationObserver;
+  mutationObserver: import("../../utils/observers").ExtendedMutationObserver;
   resizeObserver: ResizeObserver;
   openTransitionProp: string;
   transitionEl: HTMLDivElement;
   guid: string;
   defaultAssignedElements: Element[];
-  private debouncedReposition;
   slotChangeHandler: (event: Event) => void;
   setFilteredPlacements: () => void;
   updateTriggers: (event: Event) => void;

package/dist/types/components/dropdown-item/dropdown-item.d.ts

@@ -17,11 +17,11 @@ export declare class DropdownItem {
   /** When true, item is selected  */
   selected: boolean;
   selectedHandler(value: boolean): void;
-  /** flip the icon(s) in rtl */
+  /** When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`). */
   iconFlipRtl?: FlipContext;
-  /** optionally pass an icon to display at the start of an item - accepts calcite ui icon names  */
+  /** Specifies an icon to display at the start of the component. */
   iconStart?: string;
-  /** optionally pass an icon to display at the end of an item - accepts calcite ui icon names  */
+  /** Specifies an icon to display at the end of the component. */
   iconEnd?: string;
   /** optionally pass a href - used to determine if the component should render as anchor */
   href?: string;

package/dist/types/components/fab/fab.d.ts

@@ -16,7 +16,7 @@ export declare class Fab implements InteractiveComponent {
    */
   disabled: boolean;
   /**
-   * The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.
+   * Specifies an icon to display.
    *
    * @default "plus"
    */

package/dist/types/components/filter/assets/filter/t9n/index.d.ts

@@ -0,0 +1,4 @@
+export type Messages = {
+  filterLabel: string;
+  clear: string;
+};

package/dist/types/components/flow/flow.d.ts

@@ -12,7 +12,7 @@ export declare class Flow {
   flowDirection: FlowDirection;
   itemCount: number;
   items: HTMLCalciteFlowItemElement[];
-  itemMutationObserver: MutationObserver;
+  itemMutationObserver: import("../../utils/observers").ExtendedMutationObserver;
   connectedCallback(): void;
   disconnectedCallback(): void;
   handleItemBackClick(): void;

package/dist/types/components/flow-item/flow-item.d.ts

@@ -78,6 +78,10 @@ export declare class FlowItem implements InteractiveComponent {
    * @deprecated use calciteFlowItemBack instead.
    */
   calciteFlowItemBackClick: EventEmitter<void>;
+  /**
+   * Fires when the content is scrolled.
+   */
+  calciteFlowItemScroll: EventEmitter<void>;
   /**
    * Fires when the close button is clicked.
    */
@@ -92,20 +96,20 @@ export declare class FlowItem implements InteractiveComponent {
   /**
    * Scrolls the component's content to a specified set of coordinates.
    *
-   * ```
-   *   myCalciteFlowItem.scrollContentTo({
-   *     left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.
-   *     top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element
-   *     behavior: "auto" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).
-   *   });
-   * ```
-   *
+   * @example
+   * myCalciteFlowItem.scrollContentTo({
+   *   left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.
+   *   top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element
+   *   behavior: "auto" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).
+   * });
    * @param options
    */
   scrollContentTo(options?: ScrollToOptions): Promise<void>;
+  handlePanelScroll: (event: CustomEvent<void>) => void;
   handlePanelClose: (event: CustomEvent<void>) => void;
   backButtonClick: () => void;
   setBackRef: (node: HTMLCalciteActionElement) => void;
+  setContainerRef: (node: HTMLCalcitePanelElement) => void;
   getBackLabel: () => string;
   renderBackButton(): VNode;
   render(): VNode;

package/dist/types/components/handle/handle.d.ts

@@ -14,7 +14,7 @@ export declare class Handle {
   /**
    * Emitted when the handle is activated and the up or down arrow key is pressed.
    *
-   * **Note:**: The `handle` event payload prop is deprecated, please use the event's target/currentTarget instead
+   * **Note:**: The `handle` event payload prop is deprecated, please use the event's `target`/`currentTarget` instead
    */
   calciteHandleNudge: EventEmitter<DeprecatedEventPayload>;
   /** Sets focus on the component. */

package/dist/types/components/inline-editable/assets/inline-editable/t9n/index.d.ts

@@ -0,0 +1,5 @@
+export type Messages = {
+  enablingEditing: string;
+  cancelEditing: string;
+  confirmChanges: string;
+};

package/dist/types/components/inline-editable/inline-editable.d.ts

@@ -63,7 +63,7 @@ export declare class InlineEditable implements InteractiveComponent, LabelableCo
   private cancelEditingButton;
   private confirmEditingButton;
   labelEl: HTMLCalciteLabelElement;
-  mutationObserver: MutationObserver;
+  mutationObserver: import("../../utils/observers").ExtendedMutationObserver;
   setFocus(): Promise<void>;
   mutationObserverCallback(): void;
   onLabelClick(): void;

package/dist/types/components/input/assets/input/t9n/index.d.ts

@@ -0,0 +1,4 @@
+export type Messages = {
+  clear: string;
+  loading: string;
+};