@esri/calcite-components 1.0.0-next.466 → 1.0.0-next.469

package/dist/loader/cdn.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.466
+ * v1.0.0-next.469
  */
 module.exports = require('../cjs/loader.cjs.js');
 module.exports.applyPolyfills = function() { return Promise.resolve() };

package/dist/loader/index.cjs.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.466
+ * v1.0.0-next.469
  */
 module.exports = require('../cjs/loader.cjs.js');
 module.exports.applyPolyfills = function() { return Promise.resolve() };

package/dist/loader/index.es2017.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.466
+ * v1.0.0-next.469
  */
 export * from '../esm/polyfills/index.js';
 export * from '../esm/loader.js';

package/dist/loader/index.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.466
+ * v1.0.0-next.469
  */
 (function(){if("undefined"!==typeof window&&void 0!==window.Reflect&&void 0!==window.customElements){var a=HTMLElement;window.HTMLElement=function(){return Reflect.construct(a,[],this.constructor)};HTMLElement.prototype=a.prototype;HTMLElement.prototype.constructor=HTMLElement;Object.setPrototypeOf(HTMLElement,a)}})();
 export * from '../esm/polyfills/index.js';

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

@@ -14,16 +14,18 @@ export declare class Accordion {
   iconType: "chevron" | "caret" | "plus-minus";
   /** specify the scale of accordion, defaults to m */
   scale: Scale;
-  /** specify the selection mode - multi (allow any number of open items), single (allow one open item),
-   * or single-persist (allow and require one open item), defaults to multi */
+  /**
+   * specify the selection mode - multi (allow any number of open items), single (allow one open item),
+   * or single-persist (allow and require one open item), defaults to multi
+   */
   selectionMode: "multi" | "single" | "single-persist";
   /**
    * @internal
    */
-  calciteAccordionChange: EventEmitter;
+  calciteInternalAccordionChange: EventEmitter;
   componentDidLoad(): void;
   render(): VNode;
-  calciteAccordionItemKeyEvent(e: CustomEvent): void;
+  calciteInternalAccordionItemKeyEvent(e: CustomEvent): void;
   registerCalciteAccordionItem(e: CustomEvent): void;
   updateActiveItemOnChange(event: CustomEvent): void;
   /** created list of Accordion items */

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

@@ -15,19 +15,19 @@ export declare class AccordionItem {
   /**
    * @internal
    */
-  calciteAccordionItemKeyEvent: EventEmitter;
+  calciteInternalAccordionItemKeyEvent: EventEmitter;
   /**
    * @internal
    */
-  calciteAccordionItemSelect: EventEmitter;
+  calciteInternalAccordionItemSelect: EventEmitter;
   /**
    * @internal
    */
-  calciteAccordionItemClose: EventEmitter;
+  calciteInternalAccordionItemClose: EventEmitter;
   /**
    * @internal
    */
-  calciteAccordionItemRegister: EventEmitter;
+  calciteInternalAccordionItemRegister: EventEmitter;
   connectedCallback(): void;
   componentDidLoad(): void;
   render(): VNode;

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

@@ -31,7 +31,9 @@ export declare class Action implements InteractiveComponent {
    * Indicates unread changes.
    */
   indicator: boolean;
-  /** string to override English loading text
+  /**
+   * string to override English loading text
+   *
    * @default "Loading"
    */
   intlLoading?: string;
@@ -57,6 +59,7 @@ export declare class Action implements InteractiveComponent {
   textEnabled: boolean;
   /**
    * Emitted when the action has been clicked.
+   *
    * @deprecated use onClick instead.
    */
   calciteActionClick: EventEmitter;

package/dist/types/components/action-bar/action-bar.d.ts

@@ -52,10 +52,15 @@ export declare class ActionBar implements ConditionalSlotComponent {
   disconnectedCallback(): void;
   /**
    * Overflows actions that won't fit into menus.
+   *
    * @internal
    */
   overflowActions(): Promise<void>;
-  /** Sets focus on the component. */
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
   setFocus(focusId?: "expand-toggle"): Promise<void>;
   actionMenuOpenChangeHandler: (event: CustomEvent<boolean>) => void;
   resizeHandlerEntries: (entries: ResizeObserverEntry[]) => void;

package/dist/types/components/action-menu/action-menu.d.ts

@@ -33,6 +33,7 @@ export declare class ActionMenu implements ConditionalSlotComponent {
   overlayPositioning: OverlayPositioning;
   /**
    * Determines where the component will be positioned relative to the referenceElement.
+   *
    * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
    */
   placement: PopperPlacement;

package/dist/types/components/action-pad/action-pad.d.ts

@@ -44,7 +44,11 @@ export declare class ActionPad implements ConditionalSlotComponent {
   connectedCallback(): void;
   disconnectedCallback(): void;
   componentWillLoad(): void;
-  /** Sets focus on the component. */
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
   setFocus(focusId?: "expand-toggle"): Promise<void>;
   actionMenuOpenChangeHandler: (event: CustomEvent<boolean>) => void;
   toggleExpand: () => void;

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

@@ -1,7 +1,8 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { Scale } from "../interfaces";
 import { AlertDuration, AlertPlacement, StatusColor } from "./interfaces";
-/** Alerts are meant to provide a way to communicate urgent or important information to users, frequently as a result of an action they took in your app. Alerts are positioned
+/**
+ * Alerts are meant to provide a way to communicate urgent or important information to users, frequently as a result of an action they took in your app. Alerts are positioned
  * at the bottom of the page. Multiple opened alerts will be added to a queue, allowing users to dismiss them in the order they are provided.
  */
 /**
@@ -20,10 +21,14 @@ export declare class Alert {
   autoDismissDuration: AlertDuration;
   /** Color for the alert (will apply to top border and icon) */
   color: StatusColor;
-  /** when used as a boolean set to true, show a default recommended icon. You can
-   * also pass a calcite-ui-icon name to this prop to display a requested icon */
+  /**
+   * when used as a boolean set to true, show a default recommended icon. You can
+   * also pass a calcite-ui-icon name to this prop to display a requested icon
+   */
   icon: string | boolean;
-  /** string to override English close text
+  /**
+   * string to override English close text
+   *
    * @default "Close"
    */
   intlClose: string;
@@ -48,13 +53,13 @@ export declare class Alert {
    *
    * @internal
    */
-  calciteAlertSync: EventEmitter;
+  calciteInternalAlertSync: EventEmitter;
   /**
    * Fired when an alert is added to dom - used to receive initial queue
    *
    * @internal
    */
-  calciteAlertRegister: EventEmitter;
+  calciteInternalAlertRegister: EventEmitter;
   alertSync(event: CustomEvent): void;
   alertRegister(): void;
   /** Sets focus on the component. */

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

@@ -2,14 +2,19 @@ import { RGB } from "../color-picker/interfaces";
 /**
  * Convert a string to a valid hex by hashing its contents
  * and using the hash as a seed for three distinct color values
+ *
+ * @param str
  */
 export declare function stringToHex(str: string): string;
 /**
  * Find the hue of a color given the separate RGB color channels
+ *
+ * @param rgb
  */
 export declare function rgbToHue(rgb: RGB): number;
 /**
  * For a hex color, find the hue
+ *
  * @param hex {string} - form of "#------"
  */
 export declare function hexToHue(hex: string): number;

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

@@ -32,17 +32,25 @@ export declare class Block implements ConditionalSlotComponent, InteractiveCompo
   headingLevel: HeadingLevel;
   /**
    * Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.
+   *
+   * @default "Collapse"
    */
   intlCollapse?: string;
   /**
    * Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.
+   *
+   * @default "Expand"
    */
   intlExpand?: string;
-  /** string to override English loading text
+  /**
+   * string to override English loading text
+   *
    * @default "Loading"
    */
   intlLoading?: string;
-  /** Text string used for the actions menu
+  /**
+   * Text string used for the actions menu
+   *
    * @default "Options"
    */
   intlOptions?: string;

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

@@ -28,7 +28,9 @@ export declare class Button implements LabelableComponent, InteractiveComponent,
   iconFlipRtl?: FlipContext;
   /** optionally pass an icon to display at the start of a button - accepts calcite ui icon names  */
   iconStart?: string;
-  /** string to override English loading text
+  /**
+   * string to override English loading text
+   *
    * @default "Loading"
    */
   intlLoading?: string;
@@ -66,7 +68,7 @@ export declare class Button implements LabelableComponent, InteractiveComponent,
   setFocus(): Promise<void>;
   formEl: HTMLFormElement;
   labelEl: HTMLCalciteLabelElement;
-  /** watches for changing text content **/
+  /** watches for changing text content */
   private mutationObserver;
   /** the rendered child element */
   private childEl?;

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

@@ -1,6 +1,7 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { ConditionalSlotComponent } from "../../utils/conditionalSlot";
-/** Cards do not include a grid or bounding container
+/**
+ * Cards do not include a grid or bounding container
  * - cards will expand to fit the width of their container
  */
 /**
@@ -19,15 +20,21 @@ export declare class Card implements ConditionalSlotComponent {
   selected: boolean;
   /** Indicates whether the card is selectable. */
   selectable: boolean;
-  /** string to override English loading text
+  /**
+   * string to override English loading text
+   *
    * @default "Loading"
    */
   intlLoading?: string;
-  /** string to override English select text for checkbox when selectable is true
+  /**
+   * string to override English select text for checkbox when selectable is true
+   *
    * @default "Select"
    */
   intlSelect: string;
-  /** string to override English deselect text for checkbox when selectable is true
+  /**
+   * string to override English deselect text for checkbox when selectable is true
+   *
    * @default "Deselect"
    */
   intlDeselect: string;

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

@@ -13,6 +13,7 @@ export declare class Checkbox implements LabelableComponent, CheckableFormCompom
   guid: string;
   /**
    * The hovered state of the checkbox.
+   *
    * @internal
    */
   hovered: boolean;
@@ -20,10 +21,11 @@ export declare class Checkbox implements LabelableComponent, CheckableFormCompom
    * True if the checkbox is initially indeterminate,
    * which is independent from its checked state
    * https://css-tricks.com/indeterminate-checkboxes/
-   * */
+   */
   indeterminate: boolean;
   /**
    * The label of the checkbox input
+   *
    * @internal
    */
   label?: string;

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

@@ -13,7 +13,9 @@ export declare class Chip implements ConditionalSlotComponent {
   color: ChipColor;
   /** Optionally show a button the user can click to dismiss the chip */
   dismissible: boolean;
-  /** Aria label for the "x" button
+  /**
+   * Aria label for the "x" button
+   *
    * @default "Close"
    */
   dismissLabel?: string;

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

@@ -29,6 +29,7 @@ export declare class ColorPicker implements InteractiveComponent {
    * The format of the value property.
    *
    * When "auto", the format will be inferred from `value` when set.
+   *
    * @default "auto"
    */
   format: Format;
@@ -39,80 +40,117 @@ export declare class ColorPicker implements InteractiveComponent {
   hideChannels: boolean;
   /** When true, hides the saved colors section */
   hideSaved: boolean;
-  /** Label used for the blue channel
+  /**
+   * Label used for the blue channel
+   *
    * @default "B"
    */
   intlB: string;
-  /** Label used for the blue channel description
+  /**
+   * Label used for the blue channel description
+   *
    * @default "Blue"
    */
   intlBlue: string;
-  /** Label used for the delete color button.
+  /**
+   * Label used for the delete color button.
+   *
    * @default "Delete color"
    */
   intlDeleteColor: string;
-  /** Label used for the green channel
+  /**
+   * Label used for the green channel
+   *
    * @default "G"
    */
   intlG: string;
-  /** Label used for the green channel description
+  /**
+   * Label used for the green channel description
+   *
    * @default "Green"
    */
   intlGreen: string;
-  /** Label used for the hue channel
+  /**
+   * Label used for the hue channel
+   *
    * @default "H"
    */
   intlH: string;
-  /** Label used for the HSV mode
+  /**
+   * Label used for the HSV mode
+   *
    * @default "HSV"
    */
   intlHsv: string;
-  /** Label used for the hex input
+  /**
+   * Label used for the hex input
+   *
    * @default "Hex"
    */
   intlHex: string;
-  /** Label used for the hue channel description
+  /**
+   * Label used for the hue channel description
+   *
    * @default "Hue"
    */
   intlHue: string;
   /**
    * Label used for the hex input when there is no color selected.
+   *
    * @default "No color"
    */
   intlNoColor: string;
-  /** Label used for the red channel
+  /**
+   * Label used for the red channel
+   *
    * @default "R"
    */
   intlR: string;
-  /** Label used for the red channel description
+  /**
+   * Label used for the red channel description
+   *
    * @default "Red"
    */
   intlRed: string;
-  /** Label used for the RGB mode
+  /**
+   * Label used for the RGB mode
+   *
    * @default "RGB"
    */
   intlRgb: string;
-  /** Label used for the saturation channel
+  /**
+   * Label used for the saturation channel
+   *
    * @default "S"
    */
   intlS: string;
-  /** Label used for the saturation channel description
+  /**
+   * Label used for the saturation channel description
+   *
    * @default "Saturation"
    */
   intlSaturation: string;
-  /** Label used for the save color button.
+  /**
+   * Label used for the save color button.
+   *
    * @default "Save color"
    */
   intlSaveColor: string;
-  /** Label used for the saved colors section
+  /**
+   * Label used for the saved colors section
+   *
    * @default "Saved"
    */
   intlSaved: string;
-  /** Label used for the value channel
+  /**
+   * Label used for the value channel
+   *
    * @default "V"
    */
   intlV: string;
-  /** Label used for the
+  /**
+   * Label used for the
+   *
    * @default "Value"
    */
   intlValue: string;
@@ -132,6 +170,7 @@ export declare class ColorPicker implements InteractiveComponent {
    * a RGB, HSL or HSV object.
    *
    * The type will be preserved as the color is updated.
+   *
    * @default "#007ac2"
    * @see [ColorValue](https://github.com/Esri/calcite-components/blob/master/src/components/color-picker/interfaces.ts#L10)
    */

package/dist/types/components/color-picker-hex-input/color-picker-hex-input.d.ts

@@ -12,11 +12,13 @@ export declare class ColorPickerHexInput {
   allowEmpty: boolean;
   /**
    * Label used for the hex input.
+   *
    * @default "Hex"
    */
   intlHex: string;
   /**
    * Label used for the hex input when there is no color selected.
+   *
    * @default "No color"
    */
   intlNoColor: string;
@@ -33,7 +35,7 @@ export declare class ColorPickerHexInput {
    * Emitted when the hex value changes.
    */
   calciteColorPickerHexInputChange: EventEmitter;
-  private onCalciteInputBlur;
+  private onCalciteInternalInputBlur;
   private onInputChange;
   protected onInputKeyDown(event: KeyboardEvent): void;
   private inputNode;

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

@@ -41,7 +41,8 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
    * @internal
    */
   required: boolean;
-  /** specify the selection mode
+  /**
+   * 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
@@ -52,7 +53,9 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
   /** The value(s) of the selectedItem(s) */
   value: string | string[];
   valueHandler(value: string | string[]): void;
-  /** string to override the English "Remove tag" text for when an item is selected.
+  /**
+   * string to override the English "Remove tag" text for when an item is selected.
+   *
    * @default "Remove tag"
    */
   intlRemoveTag: string;
@@ -69,6 +72,7 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
   setFocus(): Promise<void>;
   /**
    * Called when the selected items set changes
+   *
    * @deprecated use calciteComboboxChange instead
    */
   calciteLookupChange: EventEmitter<HTMLCalciteComboboxItemElement[]>;
@@ -83,15 +87,17 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
     visibleItems: HTMLCalciteComboboxItemElement[];
     text: string;
   }>;
-  /** Called when a selected item in the combobox is dismissed via its chip **/
+  /** Called when a selected item in the combobox is dismissed via its chip */
   calciteComboboxChipDismiss: EventEmitter;
   /**
    * Fired when the combobox is opened
+   *
    * @internal
    */
   calciteComboboxOpen: EventEmitter;
   /**
    *  Fired when the combobox is closed
+   *
    * @internal
    */
   calciteComboboxClose: EventEmitter;

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

@@ -39,6 +39,8 @@ export declare class ComboboxItem implements ConditionalSlotComponent, Interacti
   /**
    * Used to toggle the selection state. By default this won't trigger an event.
    * The first argument allows the value to be coerced, rather than swapping values.
+   *
+   * @param coerce
    */
   toggleSelected(coerce?: boolean): Promise<void>;
   itemClickHandler: (event: MouseEvent) => void;

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

@@ -16,11 +16,13 @@ export declare class DatePicker {
   handleValueAsDate(date: Date | Date[]): void;
   /**
    * Selected start date as full date object
+   *
    * @deprecated use valueAsDate instead
    */
   startAsDate?: Date;
   /**
    * Selected end date as full date object
+   *
    * @deprecated use valueAsDate instead
    */
   endAsDate?: Date;
@@ -35,15 +37,21 @@ export declare class DatePicker {
   /** Latest allowed date ("yyyy-mm-dd") */
   max?: string;
   onMaxChanged(max: string): void;
-  /** Localized string for "previous month" (used for aria label)
+  /**
+   * Localized string for "previous month" (used for aria label)
+   *
    * @default "Previous month"
    */
   intlPrevMonth?: string;
-  /** Localized string for "next month" (used for aria label)
+  /**
+   * Localized string for "next month" (used for aria label)
+   *
    * @default "Next month"
    */
   intlNextMonth?: string;
-  /** Localized string for "year" (used for aria label)
+  /**
+   * Localized string for "year" (used for aria label)
+   *
    * @default "Year"
    */
   intlYear?: string;
@@ -55,11 +63,13 @@ export declare class DatePicker {
   range: boolean;
   /**
    * Selected start date
+   *
    * @deprecated use value instead
    */
   start?: string;
   /**
    * Selected end date
+   *
    * @deprecated use value instead
    */
   end?: string;
@@ -71,6 +81,7 @@ export declare class DatePicker {
   calciteDatePickerChange: EventEmitter<Date>;
   /**
    * Trigger calcite date change when a user changes the date range.
+   *
    * @see [DateRangeChange](https://github.com/Esri/calcite-components/blob/master/src/components/date-picker/interfaces.ts#L1)
    */
   calciteDatePickerRangeChange: EventEmitter<DateRangeChange>;
@@ -103,14 +114,26 @@ export declare class DatePicker {
   monthMouseOutChange: () => void;
   /**
    * Render calcite-date-picker-month-header and calcite-date-picker-month
+   *
+   * @param activeDate
+   * @param maxDate
+   * @param minDate
+   * @param date
+   * @param endDate
    */
   private renderCalendar;
   /**
    * Update date instance of start if valid
+   *
+   * @param startDate
+   * @param emit
    */
   private setStartAsDate;
   /**
    * Update date instance of end if valid
+   *
+   * @param endDate
+   * @param emit
    */
   private setEndAsDate;
   /**
@@ -121,10 +144,16 @@ export declare class DatePicker {
   private setStartDate;
   /**
    * Event handler for when the selected date changes
+   *
+   * @param e
    */
   private monthDateChange;
   /**
    * Get an active date using the value, or current date as default
+   *
+   * @param value
+   * @param min
+   * @param max
    */
   private getActiveDate;
   private getActiveStartDate;