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

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. */

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;
+};

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

@@ -4,63 +4,62 @@ import { InputPlacement } from "./interfaces";
 import { Position } from "../interfaces";
 import { LabelableComponent } from "../../utils/label";
 import { FormComponent } from "../../utils/form";
-import { LangComponent } from "../../utils/locale";
+import { NumberingSystem, LocalizedComponent } from "../../utils/locale";
 import { InteractiveComponent } from "../../utils/interactive";
-import { GlobalAttrComponent } from "../../utils/globalAttributes";
 declare type NumberNudgeDirection = "up" | "down";
 /**
- * @slot action - A slot for positioning a button next to the component.
+ * @slot action - A slot for positioning a `calcite-button` next to the component.
  */
-export declare class Input implements LabelableComponent, FormComponent, InteractiveComponent, GlobalAttrComponent, LangComponent {
+export declare class Input implements LabelableComponent, FormComponent, InteractiveComponent, LocalizedComponent {
   el: HTMLCalciteInputElement;
   /** 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. The clear button shows by default for "search", "time", and "date" types, and will not display for the "textarea" type.
+   * 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;
   /**
-   * 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, number values are displayed with the locale's group separator.
+   * When `true`, number values are displayed with a group separator corresponding to the language and country format.
    */
   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 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;
   /**
-   * A text label that will appear on the clear button for screen readers.
+   * Accessible name for the component's clear button.
    */
   intlClear?: string;
   /**
-   * Accessible name that will appear while loading.
+   * Accessible name when the component is loading.
    *
    * @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. */
+  /** Accessible name for the component. */
   label?: string;
-  /** When true, the component is in the loading state and `calcite-progress` is displayed. */
+  /** When `true`, a busy indicator is displayed. */
   loading: boolean;
   /**
    * BCP 47 language tag for desired language and country format
@@ -69,14 +68,14 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
    * @mdn [lang](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
    */
   locale: string;
+  localeChanged(): void;
   /**
    * 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;
   /**
-   * Toggles locale formatting for numbers.
+   * When `true`, uses locale formatting for numbers.
    *
    * @internal
    */
@@ -90,7 +89,7 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
   /** watcher to update number-to-string for max */
   maxWatcher(): void;
   /**
-   * Specifies the minimum value for type "number".
+   * Specifies the minimum value for `type="number"`.
    *
    * @mdn [min](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#min)
    */
@@ -100,7 +99,7 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
   /**
    * Specifies the maximum length of text for the component's value.
    *
-   * @deprecated use maxLength instead
+   * @deprecated use `maxLength` instead.
    */
   maxlength?: number;
   /**
@@ -116,12 +115,12 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
    */
   minLength?: number;
   /**
-   * Specifies the name of the component.
+   * Specifies the name of the component on form submission.
    *
    * @mdn [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name)
    */
   name: string;
-  /** Specifies the placement of the buttons for type "number". */
+  /** Specifies the placement of the buttons for `type="number"`. */
   numberButtonType?: InputPlacement;
   /**
    * Specifies placeholder text for the component.
@@ -132,24 +131,24 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
   /** 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;
   /** Specifies the status of the input field, which determines message and icons. */
   status: Status;
   /**
-   * Specifies the granularity that the component's value must adhere to.
+   * Specifies the granularity the component's value must adhere to.
    *
    * @mdn [step](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step)
    */
   step?: number | "any";
-  /** Adds text to the end of the component.  */
+  /** Adds text to the end of the component. */
   suffixText?: string;
   /**
    * @internal
@@ -158,7 +157,7 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
   /**
    * 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 `type`s 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";
   /** The component's value. */
@@ -185,9 +184,9 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
   /** the computed icon to render */
   private requestedIcon?;
   private nudgeNumberValueIntervalId;
-  mutationObserver: MutationObserver;
+  mutationObserver: import("../../utils/observers").ExtendedMutationObserver;
   private userChangedValue;
-  globalAttributes: {};
+  effectiveLocale: string;
   localizedValue: string;
   connectedCallback(): void;
   disconnectedCallback(): void;
@@ -203,13 +202,13 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
    */
   calciteInternalInputBlur: EventEmitter<void>;
   /**
-   * Fires each time a new value is typed.
+   * Fires each time a new `value` is typed.
    *
-   * **Note:**: The `el` and `value` event payload props are deprecated, please use the event's target/currentTarget instead
+   * **Note:**: The `el` and `value` event payload properties are deprecated, use the event's `target`/`currentTarget` instead.
    */
   calciteInputInput: EventEmitter<DeprecatedEventPayload>;
   /**
-   * 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. */