@esri/calcite-components 1.0.0-beta.73 → 1.0.0-beta.74

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

@@ -0,0 +1,166 @@
+import { Scale, Status } from "../interfaces";
+import { EventEmitter, VNode } from "../../stencil-public-runtime";
+import { InputPlacement } from "./interfaces";
+import { Position } from "../interfaces";
+import { LabelableComponent } from "../../utils/label";
+import { FormComponent } from "../../utils/form";
+declare type NumberNudgeDirection = "up" | "down";
+/**
+ * @slot action - A slot for positioning a button next to an input
+ */
+export declare class CalciteInput implements LabelableComponent, FormComponent {
+  el: HTMLCalciteInputElement;
+  /** specify the alignment of the value of the input */
+  alignment: Position;
+  /** should the input 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" */
+  clearable: boolean;
+  /** is the input disabled  */
+  disabled: boolean;
+  disabledWatcher(): void;
+  /** for number values, displays the locale's group separator */
+  groupSeparator: boolean;
+  /** when true, the component will not be visible */
+  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 */
+  icon: string | boolean;
+  /**
+   * string to override English loading text
+   * @default "Loading"
+   */
+  intlLoading?: string;
+  /** flip the icon in rtl */
+  iconFlipRtl: boolean;
+  /** Applies to the aria-label attribute on the button or hyperlink */
+  label?: string;
+  /** specify if the input is in loading state */
+  loading: boolean;
+  /** BCP 47 language tag for desired language and country format */
+  locale?: string;
+  /**
+   * Toggles locale formatting for numbers.
+   * @internal
+   */
+  localeFormat: boolean;
+  /** input max */
+  max?: number;
+  /** watcher to update number-to-string for max */
+  maxWatcher(): void;
+  /** input min */
+  min?: number;
+  /** watcher to update number-to-string for min */
+  minWatcher(): void;
+  /**
+   * Maximum length of text input.
+   * @deprecated use maxLength instead
+   */
+  maxlength?: number;
+  /** Maximum length of the input value */
+  maxLength?: number;
+  /** Minimum length of the text input */
+  minLength?: number;
+  /** The name of the input */
+  name: string;
+  /** specify the placement of the number buttons */
+  numberButtonType?: InputPlacement;
+  /** explicitly whitelist placeholder attribute */
+  placeholder: string;
+  /** optionally add prefix  */
+  prefixText?: string;
+  /** When true, a field cannot be modified. */
+  readOnly: boolean;
+  /** is the input required */
+  required: boolean;
+  /** specify the scale of the input, defaults to m */
+  scale: Scale;
+  /** specify the status of the input field, determines message and icons */
+  status: Status;
+  /** input step */
+  step?: number | "any";
+  /** optionally add suffix  **/
+  suffixText?: string;
+  /** @internal adds inline styles for text input when slotted in calcite-inline-editable */
+  editingEnabled: boolean;
+  /**
+   * specify the input type
+   *
+   * 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 */
+  value: string;
+  valueWatcher(newValue: string): void;
+  updateRequestedIcon(): void;
+  labelEl: HTMLCalciteLabelElement;
+  formEl: HTMLFormElement;
+  defaultValue: CalciteInput["value"];
+  inlineEditableEl: HTMLCalciteInlineEditableElement;
+  /** keep track of the rendered child type */
+  private childEl?;
+  /** keep track of the rendered child type */
+  private childElType?;
+  /** number text input element for locale */
+  private childNumberEl?;
+  get isClearable(): boolean;
+  get isTextarea(): boolean;
+  private minString?;
+  private maxString?;
+  private preFocusValue;
+  /** the computed icon to render */
+  private requestedIcon?;
+  /** determine if there is a slotted action for styling purposes */
+  private slottedActionEl?;
+  private nudgeNumberValueIntervalId;
+  localizedValue: string;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  componentWillLoad(): void;
+  componentDidLoad(): void;
+  componentShouldUpdate(newValue: any, oldValue: any, property: string): boolean;
+  /**
+   * @internal
+   */
+  calciteInputFocus: EventEmitter;
+  /**
+   * @internal
+   */
+  calciteInputBlur: EventEmitter;
+  /**
+   * This event fires each time a new value is typed.
+   */
+  calciteInputInput: EventEmitter;
+  /**
+   * This event fires each time a new value is typed and committed.
+   */
+  calciteInputChange: EventEmitter<void>;
+  /** Sets focus on the component. */
+  setFocus(): Promise<void>;
+  keyDownHandler: (event: KeyboardEvent) => void;
+  onLabelClick(): void;
+  incrementOrDecrementNumberValue(direction: NumberNudgeDirection, inputMax: number | null, inputMin: number | null, nativeEvent: KeyboardEvent | MouseEvent): void;
+  private clearInputValue;
+  private inputBlurHandler;
+  private inputFocusHandler;
+  private inputInputHandler;
+  private inputKeyDownHandler;
+  private inputNumberInputHandler;
+  private inputNumberKeyDownHandler;
+  private nudgeNumberValue;
+  private numberButtonMouseUpAndMouseOutHandler;
+  private numberButtonMouseDownHandler;
+  onFormReset(): void;
+  syncHiddenFormInput(input: HTMLInputElement): void;
+  private setChildElRef;
+  private setChildNumberElRef;
+  private setDisabledAction;
+  private setLocalizedValue;
+  private setValue;
+  private inputKeyUpHandler;
+  render(): VNode;
+}
+export {};

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

@@ -0,0 +1,179 @@
+import { VNode, EventEmitter } from "../../stencil-public-runtime";
+import { HeadingLevel } from "../functional/CalciteHeading";
+import { LabelableComponent } from "../../utils/label";
+import { FormComponent } from "../../utils/form";
+import { OverlayPositioning } from "../../utils/popper";
+import { StrictModifiers } from "@popperjs/core";
+import { DateRangeChange } from "../calcite-date-picker/interfaces";
+export declare class CalciteInputDatePicker implements LabelableComponent, FormComponent {
+  el: HTMLCalciteInputDatePickerElement;
+  /**
+   * When false, the component won't be interactive.
+   */
+  disabled: boolean;
+  /** Selected date */
+  value: string | string[];
+  valueHandler(value: string | string[]): void;
+  /**
+   * Number at which section headings should start for this component.
+   */
+  headingLevel: HeadingLevel;
+  /** Selected date as full date object*/
+  valueAsDate?: Date | Date[];
+  /**
+   * 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;
+  /** Earliest allowed date as full date object */
+  minAsDate?: Date;
+  /** Latest allowed date as full date object */
+  maxAsDate?: Date;
+  /** Earliest allowed date ("yyyy-mm-dd") */
+  min?: string;
+  onMinChanged(min: string): void;
+  /** Latest allowed date ("yyyy-mm-dd") */
+  max?: string;
+  onMaxChanged(max: string): void;
+  /** Expand or collapse when calendar does not have input */
+  active: boolean;
+  activeHandler(): void;
+  /**
+   * The picker's name. Gets submitted with the form.
+   */
+  name: string;
+  /** Localized string for "previous month" (used for aria label)
+   * @default "Previous month"
+   */
+  intlPrevMonth?: string;
+  /** Localized string for "next month" (used for aria label)
+   * @default "Next month"
+   */
+  intlNextMonth?: string;
+  /** Localized string for "year" (used for aria label)
+   * @default "Year"
+   */
+  intlYear?: string;
+  /** BCP 47 language tag for desired language and country format */
+  locale?: string;
+  /** specify the scale of the date picker */
+  scale: "s" | "m" | "l";
+  /** Range mode activation */
+  range: boolean;
+  /**
+   * When true, makes the component required for form-submission.
+   *
+   * @internal
+   */
+  required: boolean;
+  /**
+   * Selected start date
+   * @deprecated use value instead
+   */
+  start?: string;
+  /**
+   * Selected end date
+   * @deprecated use value instead
+   */
+  end?: string;
+  /** 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;
+  /** Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range. */
+  proximitySelectionDisabled: boolean;
+  /** Layout */
+  layout: "horizontal" | "vertical";
+  handleDateOrRangeChange(): void;
+  calciteDaySelectHandler(): void;
+  /**
+   * Trigger calcite date change when a user changes the date.
+   *
+   * @deprecated use `calciteInputDatePickerChange` instead.
+   */
+  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/calcite-date-picker/interfaces.ts#L1)
+   *
+   * @deprecated use `calciteInputDatePickerChange` instead.
+   */
+  calciteDatePickerRangeChange: EventEmitter<DateRangeChange>;
+  /**
+   * This event fires when the input date picker value changes.
+   */
+  calciteInputDatePickerChange: EventEmitter<void>;
+  /**
+   * @internal
+   */
+  calciteInputDatePickerOpen: EventEmitter;
+  /**
+   * @internal
+   */
+  calciteInputDatePickerClose: EventEmitter;
+  /** Updates the position of the component. */
+  setFocus(): Promise<void>;
+  /** Updates the position of the component. */
+  reposition(): Promise<void>;
+  connectedCallback(): void;
+  componentWillLoad(): Promise<void>;
+  disconnectedCallback(): void;
+  render(): VNode;
+  labelEl: HTMLCalciteLabelElement;
+  formEl: HTMLFormElement;
+  defaultValue: CalciteInputDatePicker["value"];
+  focusedInput: "start" | "end";
+  private localeData;
+  private startInput;
+  private endInput;
+  private popper;
+  private menuEl;
+  private referenceEl;
+  private startWrapper;
+  private endWrapper;
+  private activeTransitionProp;
+  setReferenceEl(): void;
+  onLabelClick(): void;
+  transitionEnd: (event: TransitionEvent) => void;
+  setStartInput: (el: HTMLCalciteInputElement) => void;
+  setEndInput: (el: HTMLCalciteInputElement) => void;
+  deactivate: () => void;
+  keyUpHandler: (e: KeyboardEvent) => void;
+  inputBlur: (e: CustomEvent<any>) => void;
+  startInputFocus: () => void;
+  endInputFocus: () => void;
+  inputInput: (e: CustomEvent<any>) => void;
+  setMenuEl: (el: HTMLDivElement) => void;
+  setStartWrapper: (el: HTMLDivElement) => void;
+  setEndWrapper: (el: HTMLDivElement) => void;
+  getModifiers(): Partial<StrictModifiers>[];
+  createPopper(): void;
+  destroyPopper(): void;
+  startWatcher(start: string): void;
+  endWatcher(end: string): void;
+  private loadLocaleData;
+  private clearCurrentValue;
+  /**
+   * If inputted string is a valid date, update value/active
+   */
+  private input;
+  /**
+   * Clean up invalid date from input on blur
+   */
+  private blur;
+  /**
+   * Event handler for when the selected date changes
+   */
+  handleDateChange: (event: CustomEvent<Date>) => void;
+  private shouldFocusRangeStart;
+  private shouldFocusRangeEnd;
+  private handleDateRangeChange;
+  /**
+   * Find a date from input string
+   * return false if date is invalid, or out of range
+   */
+  private getDateFromInput;
+}

package/dist/types/components/calcite-input-message/calcite-input-message.d.ts

@@ -0,0 +1,27 @@
+import { VNode } from "../../stencil-public-runtime";
+import { Scale, Status } from "../interfaces";
+/**
+ * @slot - A slot for adding text.
+ */
+export declare class CalciteInputMessage {
+  el: HTMLCalciteInputMessageElement;
+  /** Indicates whether the message is displayed. */
+  active: boolean;
+  /** when used as a boolean set to true, show a default icon based on status. You can
+   * also pass a calcite-ui-icon name to this prop to display a custom icon */
+  icon: boolean | string;
+  /** specify the scale of the input, defaults to m */
+  scale: Scale;
+  /** specify the status of the input field, determines message and icons */
+  status: Status;
+  /** specify the appearance of any slotted message - default (displayed under input), or floating (positioned absolutely under input)
+   * @deprecated "floating" type is no longer supported
+   */
+  type: "default";
+  handleIconEl(): void;
+  connectedCallback(): void;
+  render(): VNode;
+  /** the computed icon to render */
+  private requestedIcon?;
+  private renderIcon;
+}

package/dist/types/components/calcite-input-time-picker/calcite-input-time-picker.d.ts

@@ -0,0 +1,90 @@
+import { VNode, EventEmitter } from "../../stencil-public-runtime";
+import { Scale } from "../interfaces";
+import { LabelableComponent } from "../../utils/label";
+import { FormComponent } from "../../utils/form";
+export declare class CalciteInputTimePicker implements LabelableComponent, FormComponent {
+  el: HTMLCalciteInputTimePickerElement;
+  /** The active state of the time input */
+  active: boolean;
+  /** The disabled state of the time input */
+  disabled: boolean;
+  /** aria-label for the hour input */
+  intlHour?: string;
+  /** aria-label for the hour down button */
+  intlHourDown?: string;
+  /** aria-label for the hour up button */
+  intlHourUp?: string;
+  /** aria-label for the meridiem (am/pm) input */
+  intlMeridiem?: string;
+  /** aria-label for the meridiem (am/pm) down button */
+  intlMeridiemDown?: string;
+  /** aria-label for the meridiem (am/pm) up button */
+  intlMeridiemUp?: string;
+  /** aria-label for the minute input */
+  intlMinute?: string;
+  /** aria-label for the minute down button */
+  intlMinuteDown?: string;
+  /** aria-label for the minute up button */
+  intlMinuteUp?: string;
+  /** aria-label for the second input */
+  intlSecond?: string;
+  /** aria-label for the second down button */
+  intlSecondDown?: string;
+  /** aria-label for the second up button */
+  intlSecondUp?: string;
+  /**
+   * BCP 47 language tag for desired language and country format
+   * @internal
+   */
+  locale: string;
+  localeWatcher(newLocale: string): void;
+  /** The name of the time input */
+  name: string;
+  /**
+   * When true, makes the component required for form-submission.
+   *
+   * @internal
+   */
+  required: boolean;
+  /** The scale (size) of the time input */
+  scale: Scale;
+  /** number (seconds) that specifies the granularity that the value must adhere to */
+  step: number;
+  /** The selected time in UTC (always 24-hour format) */
+  value: string;
+  valueWatcher(newValue: string): void;
+  labelEl: HTMLCalciteLabelElement;
+  formEl: HTMLFormElement;
+  defaultValue: CalciteInputTimePicker["value"];
+  private calciteInputEl;
+  private calciteTimePickerEl;
+  /** whether the value of the input was changed as a result of user typing or not */
+  private internalValueChange;
+  private previousValidValue;
+  private referenceElementId;
+  localizedValue: string;
+  /**
+   * Fires when the time value is changed as a result of user input.
+   */
+  calciteInputTimePickerChange: EventEmitter<string>;
+  private calciteInputBlurHandler;
+  private calciteInputFocusHandler;
+  private calciteInputInputHandler;
+  clickHandler(event: MouseEvent): void;
+  keyUpHandler(event: KeyboardEvent): void;
+  timePickerBlurHandler(event: CustomEvent): void;
+  private timePickerChangeHandler;
+  timePickerFocusHandler(event: CustomEvent): void;
+  /** Sets focus on the component. */
+  setFocus(): Promise<void>;
+  onLabelClick(): void;
+  private shouldIncludeSeconds;
+  private setCalciteInputEl;
+  private setCalciteTimePickerEl;
+  private setInputValue;
+  private setValue;
+  connectedCallback(): void;
+  componentDidLoad(): void;
+  disconnectedCallback(): void;
+  render(): VNode;
+}

package/dist/types/components/calcite-label/calcite-label.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter, VNode } from "../../stencil-public-runtime";
+import { Alignment, Scale, Status } from "../interfaces";
+/**
+ * @slot - A slot for adding text and a component that can be labeled.
+ */
+export declare class CalciteLabel {
+  el: HTMLCalciteLabelElement;
+  /** specify the text alignment of the label */
+  alignment: Alignment;
+  /** specify the status of the label and any child input / input messages */
+  status: Status;
+  /** The id of the input associated with the label */
+  for: string;
+  /** specify the scale of the label, defaults to m */
+  scale: Scale;
+  /** is the wrapped element positioned inline with the label slotted text */
+  layout: "inline" | "inline-space-between" | "default";
+  /** eliminates any space around the label */
+  disableSpacing: boolean;
+  /** is the label disabled  */
+  disabled: boolean;
+  /**
+   * @internal
+   */
+  calciteInternalLabelClick: EventEmitter<{
+    sourceEvent: MouseEvent;
+  }>;
+  labelClickHandler: (event: MouseEvent) => void;
+  render(): VNode;
+}

package/dist/types/components/calcite-link/calcite-link.d.ts

@@ -0,0 +1,33 @@
+import { VNode } from "../../stencil-public-runtime";
+import { FlipContext } from "../interfaces";
+/** Any attributes placed on <calcite-link> component will propagate to the rendered child */
+/** Passing a 'href' will render an anchor link, instead of a span. Role will be set to link, or link, depending on this. */
+/** It is the consumers responsibility to add aria information, rel, target, for links, and any link attributes for form submission */
+/** @slot - A slot for adding text. */
+export declare class CalciteLink {
+  el: HTMLCalciteLinkElement;
+  /** is the link disabled  */
+  disabled: boolean;
+  /** optionally pass a href - used to determine if the component should render as a link or an anchor */
+  href?: string;
+  hrefHandler(href: string): void;
+  /** optionally pass an icon to display at the end of a button - accepts calcite ui icon names  */
+  iconEnd?: string;
+  /** flip the icon(s) in rtl */
+  iconFlipRtl?: FlipContext;
+  /** optionally pass an icon to display at the start of a button - accepts calcite ui icon names  */
+  iconStart?: string;
+  /** The rel attribute to apply to the hyperlink */
+  rel?: string;
+  /** The target attribute to apply to the hyperlink */
+  target?: string;
+  connectedCallback(): void;
+  render(): VNode;
+  /** Sets focus on the component. */
+  setFocus(): Promise<void>;
+  /** the rendered child element */
+  private childEl;
+  /** the node type of the rendered child element */
+  childElType: "a" | "span";
+  private storeTagRef;
+}

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

@@ -0,0 +1,16 @@
+import { VNode } from "../../stencil-public-runtime";
+import { HeadingLevel } from "../functional/CalciteHeading";
+/**
+ * A general purpose list that enables users to construct list items that conform to Calcite styling.
+ * @slot - A slot for adding `calcite-list-item` elements.
+ */
+export declare class CalciteList {
+  /**
+   * Number at which section headings should start for this component.
+   */
+  headingLevel: HeadingLevel;
+  el: HTMLCalciteListElement;
+  /** Sets focus on the component. */
+  setFocus(): Promise<void>;
+  render(): VNode;
+}

package/dist/types/components/calcite-list-item/calcite-list-item.d.ts

@@ -0,0 +1,37 @@
+import { VNode } from "../../stencil-public-runtime";
+/**
+ * @slot - A slot for adding `calcite-list-item` and `calcite-list-item-group` elements.
+ * @slot actions-start - A slot for adding actionable `calcite-action` elements before the content of the list item.
+ * @slot content-start - A slot for adding non-actionable elements before the label and description of the list item.
+ * @slot content-end - A slot for adding non-actionable elements after the label and description of the list item.
+ * @slot actions-end - A slot for adding actionable `calcite-action` elements after the content of the list item.
+ */
+export declare class CalciteListItem {
+  /**
+   * When true, prevents the content of the list item from user interaction.
+   */
+  nonInteractive: boolean;
+  /**
+   * An optional description for this item.  This will appear below the label text.
+   */
+  description: string;
+  /**
+   * When true, disabled prevents interaction.
+   */
+  disabled: boolean;
+  /**
+   * The label text of the list item. This will appear above the description text.
+   */
+  label: string;
+  el: HTMLCalciteListItemElement;
+  focusEl: HTMLButtonElement;
+  /** Sets focus on the component. */
+  setFocus(): Promise<void>;
+  renderActionsStart(): VNode;
+  renderActionsEnd(): VNode;
+  renderContentStart(): VNode;
+  renderContentEnd(): VNode;
+  renderContent(): VNode;
+  renderContentContainer(): VNode;
+  render(): VNode;
+}

package/dist/types/components/calcite-list-item-group/calcite-list-item-group.d.ts

@@ -0,0 +1,18 @@
+import { VNode } from "../../stencil-public-runtime";
+import { HeadingLevel } from "../functional/CalciteHeading";
+/**
+ * @slot - A slot for adding `calcite-list-item` and `calcite-list-item-group` elements.
+ */
+export declare class CalciteListItemGroup {
+  /**
+   * The title used for all nested `calcite-list-item` rows.
+   *
+   */
+  heading: string;
+  /**
+   * Number at which section headings should start for this component.
+   */
+  headingLevel: HeadingLevel;
+  el: HTMLCalciteListItemGroupElement;
+  render(): VNode;
+}

package/dist/types/components/calcite-loader/calcite-loader.d.ts

@@ -0,0 +1,27 @@
+import { VNode } from "../../stencil-public-runtime";
+import { Scale } from "../interfaces";
+export declare class CalciteLoader {
+  el: HTMLCalciteLoaderElement;
+  /** Show the loader */
+  active: boolean;
+  /** Inline loaders are smaller and will appear to the left of the text */
+  inline: boolean;
+  /** Accessible name for the component */
+  label: string;
+  /** Speficy the scale of the loader. Defaults to "m" */
+  scale: Scale;
+  /** Use indeterminate if finding actual progress value is impossible */
+  type: "indeterminate" | "determinate";
+  /** Percent complete of 100, only valid for determinate indicators */
+  value: number;
+  /** Text which should appear under the loading indicator (optional) */
+  text: string;
+  /** Turn off spacing around the loader */
+  noPadding: boolean;
+  render(): VNode;
+  /**
+   * Return the proper sizes based on the scale property
+   */
+  private getSize;
+  private getInlineSize;
+}