@esri/calcite-components 1.0.0-beta.82 → 1.0.0-beta.85

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

@@ -32,9 +32,10 @@ export declare class DatePickerMonth {
   calciteDatePickerSelect: EventEmitter;
   /**
    * Event emitted when user hovers the date.
+   *
    * @internal
    */
-  calciteDatePickerHover: EventEmitter;
+  calciteInternalDatePickerHover: EventEmitter;
   /**
    * Active date for the user keyboard access.
    */
@@ -42,7 +43,7 @@ export declare class DatePickerMonth {
   /**
    * @internal
    */
-  calciteDatePickerMouseOut: EventEmitter;
+  calciteInternalDatePickerMouseOut: EventEmitter;
   keyDownHandler: (e: KeyboardEvent) => void;
   /**
    * Once user is not interacting via keyboard,
@@ -54,34 +55,55 @@ export declare class DatePickerMonth {
   private activeFocus;
   /**
    * Add n months to the current month
+   *
+   * @param step
    */
   private addMonths;
   /**
    * Add n days to the current date
+   *
+   * @param step
    */
   private addDays;
   /**
    * Get dates for last days of the previous month
+   *
+   * @param month
+   * @param year
+   * @param startOfWeek
    */
   private getPrevMonthdays;
   /**
    * Get dates for the current month
+   *
+   * @param month
+   * @param year
    */
   private getCurrentMonthDays;
   /**
    * Get dates for first days of the next month
+   *
+   * @param month
+   * @param year
+   * @param startOfWeek
    */
   private getNextMonthDays;
   /**
    * Determine if the date is in between the start and end dates
+   *
+   * @param date
    */
   private betweenSelectedRange;
   /**
    * Determine if the date should be in selected state
+   *
+   * @param date
    */
   private isSelected;
   /**
    * Determine if the date is the start of the date range
+   *
+   * @param date
    */
   private isStartOfRange;
   private isEndOfRange;
@@ -89,6 +111,12 @@ export declare class DatePickerMonth {
   daySelect: (e: CustomEvent) => void;
   /**
    * Render calcite-date-picker-day
+   *
+   * @param active
+   * @param day
+   * @param date
+   * @param currentMonth
+   * @param ref
    */
   private renderDateDay;
   private isFocusedOnStart;

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

@@ -41,8 +41,12 @@ export declare class DatePickerMonthHeader {
   setNextPrevMonthDates(): void;
   /**
    * Increment year on UP/DOWN keys
+   *
+   * @param e
    */
   private onYearKey;
+  private formatCalendarYear;
+  private parseCalendarYear;
   private onYearChange;
   private onYearInput;
   private prevMonthClick;
@@ -54,6 +58,11 @@ export declare class DatePickerMonthHeader {
   /**
    * Parse localized year string from input,
    * set to active if in range
+   *
+   * @param root0
+   * @param root0.localizedYear
+   * @param root0.commit
+   * @param root0.offset
    */
   private setYear;
 }

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

@@ -0,0 +1 @@
+export declare const BUDDHIST_CALENDAR_YEAR_OFFSET = 543;

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

@@ -10,8 +10,14 @@ import { InteractiveComponent } from "../../utils/interactive";
  */
 export declare class Dropdown implements InteractiveComponent {
   el: HTMLCalciteDropdownElement;
-  /** Opens or closes the dropdown */
+  /**
+   * Opens or closes the dropdown
+   *
+   * @deprecated use open instead.
+   */
   active: boolean;
+  /** When true, opens the dropdown */
+  open: boolean;
   activeHandler(): void;
   /**
    allow the dropdown to remain open after a selection is made
@@ -29,13 +35,14 @@ export declare class Dropdown implements InteractiveComponent {
   /**
    specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 -
    this value does not include groupTitles passed to calcite-dropdown-group
-  */
+   */
   maxItems: number;
   maxItemsHandler(): void;
   /** Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value. */
   overlayPositioning: OverlayPositioning;
   /**
    * Determines where the dropdown will be positioned relative to the button.
+   *
    * @default "bottom-leading"
    */
   placement: MenuPlacement;
@@ -50,8 +57,8 @@ export declare class Dropdown implements InteractiveComponent {
   selectedItems: HTMLCalciteDropdownItemElement[];
   /** specify whether the dropdown is opened by hover or click of a trigger element */
   type: "hover" | "click";
-  /** specify the width of dropdown, defaults to m */
-  width: Scale;
+  /** specify the width of dropdown */
+  width?: Scale;
   connectedCallback(): void;
   componentDidLoad(): void;
   componentDidRender(): void;
@@ -59,18 +66,26 @@ export declare class Dropdown implements InteractiveComponent {
   render(): VNode;
   /** Updates the position of the component. */
   reposition(): Promise<void>;
-  /** fires when a dropdown item has been selected or deselected **/
+  /** fires when a dropdown item has been selected or deselected */
   calciteDropdownSelect: EventEmitter<void>;
-  /** fires when a dropdown has been opened **/
-  calciteDropdownOpen: EventEmitter<void>;
-  /** fires when a dropdown has been closed **/
-  calciteDropdownClose: EventEmitter<void>;
+  calciteDropdownBeforeOpen: EventEmitter<{
+    el: HTMLCalciteDropdownElement;
+  }>;
+  calciteDropdownOpen: EventEmitter<{
+    el: HTMLCalciteDropdownElement;
+  }>;
+  calciteDropdownBeforeClose: EventEmitter<{
+    el: HTMLCalciteDropdownElement;
+  }>;
+  calciteDropdownClose: EventEmitter<{
+    el: HTMLCalciteDropdownElement;
+  }>;
   closeCalciteDropdownOnClick(e: Event): void;
-  closeCalciteDropdownOnEvent(): void;
+  closeCalciteDropdownOnEvent(e: Event): void;
   closeCalciteDropdownOnOpenEvent(e: Event): void;
   mouseEnterHandler(): void;
   mouseLeaveHandler(): void;
-  calciteDropdownItemKeyEvent(e: CustomEvent<ItemKeyboardEvent>): void;
+  calciteInternalDropdownItemKeyEvent(e: CustomEvent<ItemKeyboardEvent>): void;
   handleItemSelect(event: CustomEvent): void;
   filteredFlipPlacements: ComputedPlacement[];
   private items;
@@ -88,9 +103,13 @@ export declare class Dropdown implements InteractiveComponent {
   updateTriggers: (event: Event) => void;
   updateItems: () => void;
   updateGroups: (event: Event) => void;
+  resizeObserverCallback: (entries: ResizeObserverEntry[]) => void;
+  setDropdownWidth: () => void;
   setMaxScrollerHeight: () => void;
   setScrollerEl: (scrollerEl: HTMLDivElement) => void;
   transitionEnd: (event: TransitionEvent) => void;
+  transitionRunHandler: (event: TransitionEvent) => void;
+  private emitOpenCloseEvent;
   setReferenceEl: (el: HTMLDivElement) => void;
   setMenuEl: (el: HTMLDivElement) => void;
   getModifiers(): Partial<StrictModifiers>[];

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

@@ -1,3 +1,6 @@
 export declare const SLOTS: {
   dropdownTrigger: string;
 };
+export declare const CSS: {
+  calciteDropdownContent: string;
+};

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

@@ -8,8 +8,10 @@ export declare class DropdownGroup {
   el: HTMLCalciteDropdownGroupElement;
   /** optionally set a group title for display */
   groupTitle?: string;
-  /** specify the selection mode - multi (allow any number of (or no) active items), single (allow and require one active item),
-   none (no active items), defaults to single */
+  /**
+    specify the selection mode - multi (allow any number of (or no) active items), single (allow and require one active item),
+   none (no active items), defaults to single
+   */
   selectionMode: SelectionMode;
   /**
    * Specifies the size of the action.
@@ -18,7 +20,7 @@ export declare class DropdownGroup {
   /**
    * @internal
    */
-  calciteDropdownItemChange: EventEmitter;
+  calciteInternalDropdownItemChange: EventEmitter;
   componentWillLoad(): void;
   render(): VNode;
   updateActiveItemOnChange(event: CustomEvent): void;

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

@@ -25,11 +25,11 @@ export declare class DropdownItem {
   /**
    * @internal
    */
-  calciteDropdownItemSelect: EventEmitter;
+  calciteInternalDropdownItemSelect: EventEmitter;
   /** @internal */
-  calciteDropdownItemKeyEvent: EventEmitter<ItemKeyboardEvent>;
+  calciteInternalDropdownItemKeyEvent: EventEmitter<ItemKeyboardEvent>;
   /** @internal */
-  calciteDropdownCloseRequest: EventEmitter;
+  calciteInternalDropdownCloseRequest: EventEmitter;
   /** Sets focus on the component. */
   setFocus(): Promise<void>;
   componentWillLoad(): void;

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

@@ -17,6 +17,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/.
+   *
    * @default "plus"
    */
   icon?: string;

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

@@ -12,11 +12,11 @@ export declare class Flow {
   panelCount: number;
   flowDirection: FlowDirection;
   panels: HTMLCalcitePanelElement[];
+  panelItemMutationObserver: MutationObserver;
   connectedCallback(): void;
   disconnectedCallback(): void;
   handleCalcitePanelBackClick(): void;
   getFlowDirection: (oldPanelCount: number, newPanelCount: number) => FlowDirection | null;
   updateFlowProps: () => void;
-  panelItemMutationObserver: MutationObserver;
   render(): VNode;
 }

package/dist/types/components/graph/util.d.ts

@@ -2,14 +2,28 @@ import { DataSeries, Graph, TranslateOptions, Translator, Extent } from "../grap
 /**
  * Generate a function which will translate a point
  * from the data coordinate space to svg viewbox oriented pixels
+ *
+ * @param root0
+ * @param root0.width
+ * @param root0.height
+ * @param root0.min
+ * @param root0.max
  */
 export declare function translate({ width, height, min, max }: TranslateOptions): Translator;
 /**
  * Get the min and max values from the dataset
+ *
+ * @param data
  */
 export declare function range(data: DataSeries): Extent;
 /**
  * Generate drawing commands for an area graph
  * returns a string can can be passed directly to a path element's `d` attribute
+ *
+ * @param root0
+ * @param root0.data
+ * @param root0.min
+ * @param root0.max
+ * @param root0.t
  */
 export declare function area({ data, min, max, t }: Graph): string;

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

@@ -1,7 +1,7 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
 export declare class Handle {
   /**
-   * @internal - stores the activated state of the drag handle.
+   * @internal
    */
   activated: boolean;
   /**

package/dist/types/components/icon/utils.d.ts

@@ -7,12 +7,14 @@ export interface FetchIconProps {
 /**
  * Icon data cache.
  * Exported for testing purposes.
+ *
  * @private
  */
 export declare const iconCache: Record<string, CalciteIconPath>;
 /**
  * Icon request cache.
  * Exported for testing purposes.
+ *
  * @private
  */
 export declare const requestCache: Record<string, Promise<CalciteIconPath>>;
@@ -21,6 +23,8 @@ export declare function fetchIcon({ icon, scale }: FetchIconProps): Promise<Calc
 /**
  * Normalize the icon name to match the path data module exports.
  * Exported for testing purposes.
+ *
+ * @param name
  * @private
  */
 export declare function normalizeIconName(name: string): string;

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

@@ -17,15 +17,21 @@ export declare class InlineEditable implements InteractiveComponent, LabelableCo
   loading: boolean;
   /** specify whether save/cancel controls should be displayed when editingEnabled is true, defaults to false */
   controls: boolean;
-  /** specify text to be user for the enable editing button's aria-label, defaults to `Click to edit`
+  /**
+   * specify text to be user for the enable editing button's aria-label, defaults to `Click to edit`
+   *
    * @default "Click to edit"
    */
   intlEnableEditing: string;
-  /** specify text to be user for the cancel editing button's aria-label, defaults to `Cancel`
+  /**
+   * specify text to be user for the cancel editing button's aria-label, defaults to `Cancel`
+   *
    * @default "Cancel"
    */
   intlCancelEditing: string;
-  /** specify text to be user for the confirm changes button's aria-label, defaults to `Save`
+  /**
+   * specify text to be user for the confirm changes button's aria-label, defaults to `Save`
+   *
    * @default "Save"
    */
   intlConfirmChanges: string;
@@ -48,7 +54,7 @@ export declare class InlineEditable implements InteractiveComponent, LabelableCo
   /**
    * @internal
    */
-  calciteInlineEditableEnableEditingChange: EventEmitter;
+  calciteInternalInlineEditableEnableEditingChange: EventEmitter;
   blurHandler(): void;
   private inputElement;
   private valuePriorToEditing;

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

@@ -7,97 +7,154 @@ import { FormComponent } from "../../utils/form";
 import { InteractiveComponent } from "../../utils/interactive";
 declare type NumberNudgeDirection = "up" | "down";
 /**
- * @slot action - A slot for positioning a button next to an input
+ * @slot action - A slot for positioning a button next to the component.
  */
 export declare class Input implements LabelableComponent, FormComponent, InteractiveComponent {
   el: HTMLCalciteInputElement;
-  /** specify the alignment of the value of the input */
+  /** Specifies the text alignment of the component's value. */
   alignment: Position;
-  /** should the input autofocus */
+  /**
+   * When true, the component is focused on page load.
+   *
+   * @mdn [autofocus](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)
+   */
   autofocus: boolean;
-  /** optionally display a clear button that displays when field has a value
-   * shows by default for search, time, date
-   * will not display for type="textarea" */
+  /**
+   * When true, a clear button is displayed when the component has a value. The clear button shows by default for "search", "time", and "date" types, and will not display for the "textarea" type.
+   */
   clearable: boolean;
-  /** is the input disabled  */
+  /**
+   * When true, interaction is prevented and the component is displayed with lower opacity.
+   *
+   * @mdn [disabled](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled)
+   */
   disabled: boolean;
   disabledWatcher(): void;
-  /** for number values, displays the locale's group separator */
+  /**
+   * When true, number values are displayed with the locale's group separator.
+   */
   groupSeparator: boolean;
-  /** when true, the component will not be visible */
+  /**
+   * When true, the component will not be visible.
+   *
+   * @mdn [hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
+   */
   hidden: boolean;
-  /** when used as a boolean set to true, show a default recommended icon for certain
-   * input types (tel, password, email, date, time, search). You can also pass a
-   * calcite-ui-icon name to this prop to display a requested icon for any input type */
+  /**
+   * When true, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.
+   */
   icon: string | boolean;
   /**
    * A text label that will appear on the clear button for screen readers.
    */
   intlClear?: string;
   /**
-   * string to override English loading text
+   * Accessible name that will appear while loading.
+   *
    * @default "Loading"
    */
   intlLoading?: string;
-  /** flip the icon in rtl */
+  /** When true, the icon is flipped in RTL. */
   iconFlipRtl: boolean;
-  /** Applies to the aria-label attribute on the button or hyperlink */
+  /** Accessible name for the component's button or hyperlink. */
   label?: string;
-  /** specify if the input is in loading state */
+  /** When true, the component is in the loading state and `calcite-progress` is displayed. */
   loading: boolean;
-  /** BCP 47 language tag for desired language and country format */
-  locale?: string;
+  /** Specifies the BCP 47 language tag for the desired language and country format. */
+  locale: string;
+  /**
+   * Specifies the Unicode numeral system used by the component for localization.
+   *
+   * @mdn [numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)
+   */
+  numberingSystem?: string;
   /**
    * Toggles locale formatting for numbers.
+   *
    * @internal
    */
   localeFormat: boolean;
-  /** input max */
+  /**
+   * Specifies the maximum value for type "number".
+   *
+   * @mdn [max](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#max)
+   */
   max?: number;
   /** watcher to update number-to-string for max */
   maxWatcher(): void;
-  /** input min */
+  /**
+   * Specifies the minimum value for type "number".
+   *
+   * @mdn [min](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#min)
+   */
   min?: number;
   /** watcher to update number-to-string for min */
   minWatcher(): void;
   /**
-   * Maximum length of text input.
+   * Specifies the maximum length of text for the component's value.
+   *
    * @deprecated use maxLength instead
    */
   maxlength?: number;
-  /** Maximum length of the input value */
+  /**
+   * Specifies the maximum length of text for the component's value.
+   *
+   * @mdn [maxlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength)
+   */
   maxLength?: number;
-  /** Minimum length of the text input */
+  /**
+   * Specifies the minimum length of text for the component's value.
+   *
+   * @mdn [minlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#minlength)
+   */
   minLength?: number;
-  /** The name of the input */
+  /**
+   * Specifies the name of the component.
+   *
+   * @mdn [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name)
+   */
   name: string;
-  /** specify the placement of the number buttons */
+  /** Specifies the placement of the buttons for type "number". */
   numberButtonType?: InputPlacement;
-  /** explicitly whitelist placeholder attribute */
+  /**
+   * Specifies placeholder text for the component.
+   *
+   * @mdn [placeholder](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder)
+   */
   placeholder: string;
-  /** optionally add prefix  */
+  /** Adds text to the start of the component. */
   prefixText?: string;
-  /** When true, a field cannot be modified. */
+  /**
+   * When true, the value cannot be modified.
+   *
+   * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
+   */
   readOnly: boolean;
-  /** is the input required */
+  /** When true, the component must have a value in order for the form to submit. */
   required: boolean;
-  /** specify the scale of the input, defaults to m */
+  /** Specifies the size of the component. */
   scale: Scale;
-  /** specify the status of the input field, determines message and icons */
+  /** Specifies the status of the input field, which determines message and icons. */
   status: Status;
-  /** input step */
+  /**
+   * Specifies the granularity that the component's value must adhere to.
+   *
+   * @mdn [step](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step)
+   */
   step?: number | "any";
-  /** optionally add suffix  **/
+  /** Adds text to the end of the component.  */
   suffixText?: string;
-  /** @internal adds inline styles for text input when slotted in calcite-inline-editable */
+  /**
+   * @internal
+   */
   editingEnabled: boolean;
   /**
-   * specify the input type
+   * Specifies the component type.
    *
-   * Note that the following types add type-specific icons by default: `date`, `email`, `password`, `search`, `tel`, `time`
+   * Note that the following types add type-specific icons by default: "date", "email", "password", "search", "tel", "time".
    */
   type: "color" | "date" | "datetime-local" | "email" | "file" | "image" | "month" | "number" | "password" | "search" | "tel" | "text" | "textarea" | "time" | "url" | "week";
-  /** input value */
+  /** The component's value. */
   value: string;
   valueWatcher(newValue: string, previousValue: string): void;
   updateRequestedIcon(): void;
@@ -132,21 +189,23 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
   /**
    * @internal
    */
-  calciteInputFocus: EventEmitter;
+  calciteInternalInputFocus: EventEmitter;
   /**
    * @internal
    */
-  calciteInputBlur: EventEmitter;
+  calciteInternalInputBlur: EventEmitter;
   /**
-   * This event fires each time a new value is typed.
+   * Fires each time a new value is typed.
    */
   calciteInputInput: EventEmitter;
   /**
-   * This event fires each time a new value is typed and committed.
+   * Fires each time a new value is typed and committed.
    */
   calciteInputChange: EventEmitter<void>;
   /** Sets focus on the component. */
   setFocus(): Promise<void>;
+  /** Selects all text of the component's `value`. */
+  selectText(): Promise<void>;
   keyDownHandler: (event: KeyboardEvent) => void;
   onLabelClick(): void;
   incrementOrDecrementNumberValue(direction: NumberNudgeDirection, inputMax: number | null, inputMin: number | null, nativeEvent: KeyboardEvent | MouseEvent): void;
@@ -159,8 +218,8 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
   private inputNumberInputHandler;
   private inputNumberKeyDownHandler;
   private nudgeNumberValue;
-  private numberButtonMouseUpAndMouseOutHandler;
-  private numberButtonMouseDownHandler;
+  private numberButtonPointerUpAndOutHandler;
+  private numberButtonPointerDownHandler;
   onFormReset(): void;
   syncHiddenFormInput(input: HTMLInputElement): void;
   private setChildElRef;