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

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

@@ -12,30 +12,30 @@ export declare class InputText implements LabelableComponent, FormComponent, Int
   /** Specifies the text alignment of the component's value. */
   alignment: Position;
   /**
-   * When true, the component is focused on page load.
+   * 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;
   /**
-   * When true, a clear button is displayed when the component has a value.
+   * When `true`, a clear button is displayed when the component has a value.
    */
   clearable: boolean;
   /**
-   * When true, interaction is prevented and the component is displayed with lower opacity.
+   * 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;
   /**
-   * 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 true, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.
+   * When `true`, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.
    */
   icon: string | boolean;
   /**
@@ -48,11 +48,11 @@ export declare class InputText implements LabelableComponent, FormComponent, Int
    * @default "Loading"
    */
   intlLoading?: string;
-  /** When true, the icon is flipped in RTL. */
+  /** When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`). */
   iconFlipRtl: boolean;
   /** Accessible name for the component's button or hyperlink. */
   label?: string;
-  /** When true, the component is in the loading state and `calcite-progress` is displayed. */
+  /** When `true`, the component is in the loading state and `calcite-progress` is displayed. */
   loading: boolean;
   /**
    * Specifies the maximum length of text for the component's value.
@@ -81,12 +81,12 @@ export declare class InputText implements LabelableComponent, FormComponent, Int
   /** Adds text to the start of the component. */
   prefixText?: string;
   /**
-   * When true, the value cannot be modified.
+   * When `true`, the component's value can be read, but cannot be modified.
    *
    * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
    */
   readOnly: boolean;
-  /** When true, the component must have a value in order for the form to submit. */
+  /** When `true`, the component must have a value in order for the form to submit. */
   required: boolean;
   /** Specifies the size of the component. */
   scale: Scale;
@@ -114,7 +114,7 @@ export declare class InputText implements LabelableComponent, FormComponent, Int
   private previousValueOrigin;
   /** the computed icon to render */
   private requestedIcon?;
-  mutationObserver: MutationObserver;
+  mutationObserver: import("../../utils/observers").ExtendedMutationObserver;
   private userChangedValue;
   connectedCallback(): void;
   disconnectedCallback(): void;

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

@@ -4,75 +4,81 @@ import { FloatingUIComponent, LogicalPlacement, OverlayPositioning } from "../..
 import { LabelableComponent } from "../../utils/label";
 import { FormComponent } from "../../utils/form";
 import { InteractiveComponent } from "../../utils/interactive";
-import { GlobalAttrComponent } from "../../utils/globalAttributes";
-export declare class InputTimePicker implements LabelableComponent, FormComponent, InteractiveComponent, FloatingUIComponent, GlobalAttrComponent {
+import { LocalizedComponent, NumberingSystem } from "../../utils/locale";
+export declare class InputTimePicker implements LabelableComponent, FormComponent, InteractiveComponent, FloatingUIComponent, LocalizedComponent {
   el: HTMLCalciteInputTimePickerElement;
   /**
-   * The active state of the time input
+   * When `true`, the component is active.
    *
-   * @deprecated Use open instead.
+   * @deprecated Use `open` instead.
    */
   active: boolean;
   activeHandler(value: boolean): void;
-  /** When true, displays the `calcite-time-picker` component.*/
+  /** When `true`, displays the `calcite-time-picker` component. */
   open: boolean;
   openHandler(value: boolean): void;
-  /** The disabled state of the time input */
+  /** When `true`, interaction is prevented and the component is displayed with lower opacity. */
   disabled: boolean;
   /**
-   * When true, still focusable but controls are gone and the value cannot be modified.
+   * When `true`, the component's value can be read, but controls are not accessible and the value cannot be modified.
    *
    * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
    */
   readOnly: boolean;
   handleDisabledAndReadOnlyChange(value: boolean): void;
-  /** aria-label for the hour input */
+  /** Accessible name for the component's hour input. */
   intlHour?: string;
-  /** aria-label for the hour down button */
+  /** Accessible name for the component's hour down button. */
   intlHourDown?: string;
-  /** aria-label for the hour up button */
+  /** Accessible name for the component's hour up button. */
   intlHourUp?: string;
-  /** aria-label for the meridiem (am/pm) input */
+  /** Accessible name for the component's meridiem (am/pm) input. */
   intlMeridiem?: string;
-  /** aria-label for the meridiem (am/pm) down button */
+  /** Accessible name for the component's meridiem (am/pm) down button. */
   intlMeridiemDown?: string;
-  /** aria-label for the meridiem (am/pm) up button */
+  /** Accessible name for the component's meridiem (am/pm) up button. */
   intlMeridiemUp?: string;
-  /** aria-label for the minute input */
+  /** Accessible name for the component's minute input. */
   intlMinute?: string;
-  /** aria-label for the minute down button */
+  /** Accessible name for the component's minute down button. */
   intlMinuteDown?: string;
-  /** aria-label for the minute up button */
+  /** Accessible name for the component's minute up button. */
   intlMinuteUp?: string;
-  /** aria-label for the second input */
+  /** Accessible name for the component's second input. */
   intlSecond?: string;
-  /** aria-label for the second down button */
+  /** Accessible name for the component's second down button. */
   intlSecondDown?: string;
-  /** aria-label for the second up button */
+  /** Accessible name for the component's second up button. */
   intlSecondUp?: string;
   /**
-   * BCP 47 language tag for desired language and country format
+   * BCP 47 language tag for desired language and country format.
    *
    * @internal
    * @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;
-  localeWatcher(): void;
-  /** The name of the time input */
+  localeChanged(): void;
+  /** Specifies the name of the component on form submission. */
   name: string;
   /**
-   * When true, makes the component required for form-submission.
+   * Specifies the Unicode numeral system used by the component for localization.
+   */
+  numberingSystem?: NumberingSystem;
+  /**
+   * When `true`, the component must have a value in order for the form to submit.
    *
    * @internal
    */
   required: boolean;
-  /** The scale (size) of the time input */
+  /** Specifies the size of the component. */
   scale: Scale;
   /**
    * 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;
@@ -82,9 +88,9 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
    * @see [LogicalPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/floating-ui.ts#L25)
    */
   placement: LogicalPlacement;
-  /** number (seconds) that specifies the granularity that the value must adhere to */
+  /** Specifies the granularity the component's `value` must adhere to (in seconds). */
   step: number;
-  /** The selected time in UTC (always 24-hour format) */
+  /** The component's value in UTC (always 24-hour format). */
   value: string;
   valueWatcher(newValue: string): void;
   labelEl: HTMLCalciteLabelElement;
@@ -97,7 +103,8 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
   private previousValidValue;
   private referenceElementId;
   popoverEl: HTMLCalcitePopoverElement;
-  globalAttributes: {};
+  effectiveLocale: string;
+  effectiveLocaleWatcher(): void;
   localizedValue: string;
   /**
    * Fires when the time value is changed as a result of user input.
@@ -112,8 +119,12 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
   timePickerFocusHandler(event: CustomEvent): void;
   /** Sets focus on the component. */
   setFocus(): Promise<void>;
-  /** Updates the position of the component. */
-  reposition(): Promise<void>;
+  /**
+   * Updates the position of the component.
+   *
+   * @param delayed
+   */
+  reposition(delayed?: boolean): Promise<void>;
   keyDownHandler: (event: KeyboardEvent) => void;
   onLabelClick(): void;
   private shouldIncludeSeconds;

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

@@ -5,30 +5,30 @@ import { Alignment, Scale, Status } from "../interfaces";
  */
 export declare class Label {
   el: HTMLCalciteLabelElement;
-  /** specify the text alignment of the label */
+  /** Specifies the text alignment of the component. */
   alignment: Alignment;
   /**
-   * specify the status of the label and any child input / input messages
+   * Specifies the status of the component and any child input, or input messages.
    *
-   * @deprecated set directly on child element instead
+   * @deprecated Set directly on the component the label is bound to instead.
    */
   status: Status;
-  /** The id of the input associated with the label */
+  /** Specifies the `id` of the component the label is bound to. Use when the component the label is bound to does not reside within the component. */
   for: string;
-  /** specify the scale of the label, defaults to m */
+  /** Specifies the size of the component. */
   scale: Scale;
-  /** is the wrapped element positioned inline with the label slotted text */
+  /** Defines the layout of the label in relation to the component. Use `"inline"` positions to wrap the label and component on the same line. */
   layout: "inline" | "inline-space-between" | "default";
   /**
-   * is the label disabled
+   * When `true`, interaction is prevented and the component is displayed with lower opacity.
    *
-   * @deprecated use the `disabled` property on the interactive components instead
+   * @deprecated Use the `disabled` property on the component the label is bound to instead.
    */
   disabled: boolean;
   /**
-   * eliminates any space around the label
+   * When `true`, disables the component's spacing.
    *
-   * @deprecated set the --calcite-label-margin-bottom css variable to 0 instead
+   * @deprecated Set the `--calcite-label-margin-bottom` css variable to `0` instead.
    */
   disableSpacing: boolean;
   /**

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

@@ -7,25 +7,25 @@ import { InteractiveComponent } from "../../utils/interactive";
 /** @slot - A slot for adding text. */
 export declare class Link implements InteractiveComponent {
   el: HTMLCalciteLinkElement;
-  /** is the link disabled  */
+  /** When `true`, interaction is prevented and the component is displayed with lower opacity. */
   disabled: boolean;
   /**
    * Prompts the user to save the linked URL instead of navigating to it. Can be used with or without a value:
    * Without a value, the browser will suggest a filename/extension
-   * See: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-download
+   * See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-download.
    */
   download: string | boolean;
-  /** optionally pass a href - used to determine if the component should render as a link or an anchor */
+  /** Specifies the URL of the linked resource, which can be set as an absolute or relative path. */
   href?: string;
-  /** optionally pass an icon to display at the end of a button - accepts calcite ui icon names  */
+  /** Specifies an icon to display at the end of the component. */
   iconEnd?: string;
-  /** 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 a button - accepts calcite ui icon names  */
+  /** Specifies an icon to display at the start of the component. */
   iconStart?: string;
-  /** The rel attribute to apply to the hyperlink */
+  /** Specifies the relationship to the linked document defined in `href`. */
   rel?: string;
-  /** The target attribute to apply to the hyperlink */
+  /** Specifies the frame or window to open the linked document. */
   target?: string;
   componentDidRender(): void;
   render(): VNode;

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

@@ -8,7 +8,7 @@ import { InteractiveComponent } from "../../utils/interactive";
  */
 export declare class List implements InteractiveComponent {
   /**
-   * When true, interaction is prevented and the component is displayed with lower opacity.
+   * When `true`, interaction is prevented and the component is displayed with lower opacity.
    */
   disabled: boolean;
   /**

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

@@ -10,7 +10,7 @@ import { InteractiveComponent } from "../../utils/interactive";
  */
 export declare class ListItem implements ConditionalSlotComponent, InteractiveComponent {
   /**
-   * When true, prevents the content of the component from user interaction.
+   * When `true`, prevents the content of the component from user interaction.
    */
   nonInteractive: boolean;
   /**
@@ -18,7 +18,7 @@ export declare class ListItem implements ConditionalSlotComponent, InteractiveCo
    */
   description?: string;
   /**
-   * When true, interaction is prevented and the component is displayed with lower opacity.
+   * When `true`, interaction is prevented and the component is displayed with lower opacity.
    */
   disabled: boolean;
   /**

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

@@ -2,17 +2,22 @@ import { VNode } from "../../stencil-public-runtime";
 import { Scale } from "../interfaces";
 export declare class Loader {
   el: HTMLCalciteLoaderElement;
-  /** When true, the component is active. */
+  /** When `true`, the component is active. */
   active: boolean;
-  /** When true, displays smaller and appears to the left of the text. */
+  /** When `true`, displays smaller and appears to the left of the text. */
   inline: boolean;
   /** Accessible name for the component. */
   label: string;
   /** Specifies the size of the component. */
   scale: Scale;
-  /** Use indeterminate if finding actual progress value is impossible. */
+  /**
+   * Specifies the component type.
+   *
+   * Use `"indeterminate"` if finding actual progress value is impossible.
+   *
+   */
   type: "indeterminate" | "determinate";
-  /** The component's value. Valid only for determinate indicators. Percent complete of 100. */
+  /** The component's value. Valid only for `"determinate"` indicators. Percent complete of 100. */
   value: number;
   /** Text that displays under the component's indicator. */
   text?: string;

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

@@ -0,0 +1,3 @@
+export type Messages = {
+  close: string;
+};

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

@@ -13,30 +13,30 @@ import { OpenCloseComponent } from "../../utils/openCloseComponent";
 export declare class Modal implements ConditionalSlotComponent, OpenCloseComponent {
   el: HTMLCalciteModalElement;
   /**
-   * When true, the `calcite-modal` is active.
+   * When `true`, the component is active.
    *
-   * @deprecated use open instead
+   * @deprecated use `open` instead.
    */
   active: boolean;
-  /** When true,`calcite-modal`  opens  */
+  /** When `true`, displays and positions the component.  */
   open: boolean;
-  /** Passes a function to run before the `calcite-modal` closes. */
+  /** Passes a function to run before the component closes. */
   beforeClose?: (el: HTMLElement) => Promise<void>;
-  /** When true, disables the component's close button. */
+  /** When `true`, disables the component's close button. */
   disableCloseButton: boolean;
-  /** When true, disables the closing of the component when clicked outside. */
+  /** When `true`, disables the closing of the component when clicked outside. */
   disableOutsideClose: boolean;
   /** Accessible name for the component's close button. */
   intlClose: string;
-  /** When true, prevents the component from expanding to the entire screen on mobile devices. */
+  /** When `true`, prevents the component from expanding to the entire screen on mobile devices. */
   docked: boolean;
-  /** When true, disables the default close on escape behavior. */
+  /** When `true`, disables the default close on escape behavior. */
   disableEscape: boolean;
   /** Specifies the size of the component. */
   scale: Scale;
   /** Specifies the width of the component. Can use scale sizes or pass a number (displays in pixels). */
   width: Scale | number;
-  /** Sets the component to always be fullscreen (overrides width). */
+  /** Sets the component to always be fullscreen (overrides `width`). */
   fullscreen: boolean;
   /**
    * Adds a color bar to the top of component for visual impact.
@@ -46,7 +46,7 @@ export declare class Modal implements ConditionalSlotComponent, OpenCloseCompone
   /** Sets the background color of the component's content. */
   backgroundColor: ModalBackgroundColor;
   /**
-   * When true, disables spacing to the content area slot.
+   * When `true`, disables spacing to the content area slot.
    *
    * @deprecated  Use `--calcite-modal-padding` CSS variable instead.
    */

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

@@ -0,0 +1,3 @@
+export type Messages = {
+  close: string;
+};

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

@@ -17,30 +17,29 @@ import { ConditionalSlotComponent } from "../../utils/conditionalSlot";
 export declare class Notice implements ConditionalSlotComponent {
   el: HTMLCalciteNoticeElement;
   /**
-   * When true, the component is active.
+   * When `true`, the component is active.
    *
-   * @deprecated Use open instead.
+   * @deprecated Use `open` instead.
    */
   active: boolean;
   activeHandler(value: boolean): void;
-  /** When true, the component is visible */
+  /** When `true`, the component is visible. */
   open: boolean;
   openHandler(value: boolean): void;
   /** The color for the component's top border and icon. */
   color: StatusColor;
   /**
-   * When true, a close button is added to the component.
+   * When `true`, a close button is added to the component.
    *
-   * @deprecated use closable instead
+   * @deprecated use `closable` instead.
    */
   dismissible?: boolean;
   handleDismissible(value: boolean): void;
-  /** When true, displays a button user can click to dismiss the `calcite-notice` */
+  /** When `true`, a close button is added to the component. */
   closable?: boolean;
   handleClosable(value: boolean): void;
   /**
-   * When present, shows a default recommended icon. You can
-   * also pass a calcite-ui-icon name to display a requested icon.
+   * When `true`, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.
    */
   icon: string | boolean;
   /**

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

@@ -1,7 +1,7 @@
 import { VNode } from "../../stencil-public-runtime";
 export declare class Option {
   /**
-   * When true, interaction is prevented and the component is displayed with lower opacity.
+   * When `true`, interaction is prevented and the component is displayed with lower opacity.
    */
   disabled: boolean;
   /**
@@ -9,7 +9,7 @@ export declare class Option {
    */
   label: string;
   /**
-   * When true, the component is selected.
+   * When `true`, the component is selected.
    */
   selected: boolean;
   /**

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

@@ -4,7 +4,7 @@ import { VNode } from "../../stencil-public-runtime";
  */
 export declare class OptionGroup {
   /**
-   * When true, interaction is prevented and the component is displayed with lower opacity.
+   * When `true`, interaction is prevented and the component is displayed with lower opacity.
    */
   disabled: boolean;
   /**

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

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

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

@@ -1,25 +1,22 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { Scale } from "../interfaces";
-import { GlobalAttrComponent } from "../../utils/globalAttributes";
-import { LangComponent } from "../../utils/locale";
+import { LocalizedComponent, NumberingSystem } from "../../utils/locale";
 export interface PaginationDetail {
   start: number;
   total: number;
   num: number;
 }
-export declare class Pagination implements GlobalAttrComponent, LangComponent {
+export declare class Pagination implements LocalizedComponent {
   /**
-   * When true, number values are displayed with a group separator corresponding to the language and country format.
+   * When `true`, number values are displayed with a group separator corresponding to the language and country format.
    */
   groupSeparator: boolean;
   /** Specifies the number of items per page. */
   num: number;
   /**
    * 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;
+  numberingSystem?: NumberingSystem;
   /** Specifies the starting item number. */
   start: number;
   /** Specifies the total number of items. */
@@ -39,7 +36,7 @@ export declare class Pagination implements GlobalAttrComponent, LangComponent {
   /** Specifies the size of the component. */
   scale: Scale;
   el: HTMLCalcitePaginationElement;
-  globalAttributes: {};
+  effectiveLocale: string;
   /**
    * Emits when the selected page changes.
    *

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

@@ -0,0 +1,6 @@
+export type Messages = {
+  back: string;
+  close: string;
+  open: string;
+  options: string;
+};