@esri/calcite-components 1.0.0-next.596 → 1.0.0-next.597

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

@@ -4,14 +4,13 @@ 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;
@@ -22,7 +21,7 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
    */
   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;
   /**
@@ -47,20 +46,20 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
    */
   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,7 +131,7 @@ 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)
    */
@@ -144,12 +143,12 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
   /** 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. */

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

@@ -6,22 +6,21 @@ import { OverlayPositioning, FloatingUIComponent, EffectivePlacement, MenuPlacem
 import { DateRangeChange } from "../date-picker/interfaces";
 import { InteractiveComponent } from "../../utils/interactive";
 import { OpenCloseComponent } from "../../utils/openCloseComponent";
-import { GlobalAttrComponent } from "../../utils/globalAttributes";
-import { LangComponent } from "../../utils/locale";
-export declare class InputDatePicker implements LabelableComponent, FormComponent, GlobalAttrComponent, InteractiveComponent, OpenCloseComponent, FloatingUIComponent, LangComponent {
+import { LocalizedComponent } from "../../utils/locale";
+export declare class InputDatePicker implements LabelableComponent, FormComponent, InteractiveComponent, OpenCloseComponent, FloatingUIComponent, LocalizedComponent {
   el: HTMLCalciteInputDatePickerElement;
   /**
-   * When false, the component won't be interactive.
+   * 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;
-  /** Selected date */
+  /** The component's value. */
   value: string | string[];
   valueHandler(value: string | string[]): void;
   /**
@@ -30,129 +29,134 @@ export declare class InputDatePicker implements LabelableComponent, FormComponen
   flipPlacements?: EffectivePlacement[];
   flipPlacementsHandler(): void;
   /**
-   * Number at which section headings should start for this component.
+   * Specifies the number at which section headings should start.
    */
   headingLevel: HeadingLevel;
-  /** Selected date as full date object*/
+  /** The component's value as a full date object. */
   valueAsDate?: Date | Date[];
   /**
-   * Selected start date as full date object
+   * The component's start date as a full date object.
    *
-   * @deprecated use valueAsDate instead
+   * @deprecated use `valueAsDate` instead.
    */
   startAsDate?: Date;
   /**
-   * Selected end date as full date object
+   * The component's end date as a full date object.
    *
-   * @deprecated use valueAsDate instead
+   * @deprecated use `valueAsDate` instead.
    */
   endAsDate?: Date;
-  /** Earliest allowed date as full date object */
+  /** Specifies the earliest allowed date as a full date object. */
   minAsDate?: Date;
-  /** Latest allowed date as full date object */
+  /** Specifies the latest allowed date as a full date object. */
   maxAsDate?: Date;
-  /** Earliest allowed date ("yyyy-mm-dd") */
+  /** Specifies the earliest allowed date ("yyyy-mm-dd"). */
   min?: string;
   onMinChanged(min: string): void;
-  /** Latest allowed date ("yyyy-mm-dd") */
+  /** Specifies the latest allowed date ("yyyy-mm-dd"). */
   max?: string;
   onMaxChanged(max: string): void;
   /**
-   * Expand or collapse when calendar does not have input
+   * When true, the component is active.
    *
-   * @deprecated use open instead
+   * @deprecated use `open` instead.
    */
   active: boolean;
   activeHandler(value: boolean): void;
-  /** Expand or collapse when calendar does not have input */
+  /** When true, displays the `calcite-date-picker` component. */
   open: boolean;
   openHandler(value: boolean): void;
   /**
-   * The picker's name. Gets submitted with the form.
+   * Specifies the name of the component on form submission.
    */
   name: string;
   /**
-   * Localized string for "previous month" (used for aria label)
+   * Accessible name for the component's previous month button.
    *
    * @default "Previous month"
    */
   intlPrevMonth?: string;
   /**
-   * Localized string for "next month" (used for aria label)
+   * Accessible name for the component's next month button.
    *
    * @default "Next month"
    */
   intlNextMonth?: string;
   /**
-   * Localized string for "year" (used for aria label)
+   * Accessible name for the component's year input.
    *
    * @default "Year"
    */
   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;
-  /** specify the scale of the date picker */
+  /** Specifies the size of the component. */
   scale: "s" | "m" | "l";
   /**
-   * Determines where the date-picker component will be positioned relative to the input.
+   * Specifies the placement of the `calcite-date-picker` relative to the component.
    *
    * @default "bottom-start"
    */
   placement: MenuPlacement;
-  /** Range mode activation */
+  /** When true, activates a range for the component. */
   range: boolean;
   /**
-   * 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;
   /**
-   * Selected start date
+   * The component's start date.
    *
-   * @deprecated use value instead
+   * @deprecated use `value` instead.
    */
   start?: string;
   /**
-   * Selected end date
+   * The component's end date.
    *
-   * @deprecated use value instead
+   * @deprecated use `value` instead.
    */
   end?: string;
   /**
    * 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;
-  /** Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range. */
+  /**
+   * When true, disables the default behavior on the third click of narrowing or extending the range.
+   * Instead starts a new range.
+   */
   proximitySelectionDisabled: boolean;
-  /** Layout */
+  /** Defines the layout of the component. */
   layout: "horizontal" | "vertical";
   handleDateOrRangeChange(): void;
   calciteDaySelectHandler(): void;
   /**
-   * Trigger calcite date change when a user changes the date.
+   * Fires when a user changes the date.
    *
    * @deprecated use `calciteInputDatePickerChange` instead.
    */
   calciteDatePickerChange: EventEmitter<Date>;
   /**
-   * Trigger calcite date change when a user changes the date range.
+   * Fires 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)
+   * @see [DateRangeChange](https://github.com/Esri/calcite-components/blob/master/src/components/date-picker/interfaces.ts#L1)
    * @deprecated use `calciteInputDatePickerChange` instead.
    */
   calciteDatePickerRangeChange: EventEmitter<DateRangeChange>;
   /**
-   * This event fires when the input date picker value changes.
+   * Fires when the component's value changes.
    */
   calciteInputDatePickerChange: EventEmitter<void>;
   /** Fires when the component is requested to be closed and before the closing transition begins. */
@@ -163,7 +167,7 @@ export declare class InputDatePicker implements LabelableComponent, FormComponen
   calciteInputDatePickerBeforeOpen: EventEmitter<void>;
   /** Fires when the component is open and animation is complete. */
   calciteInputDatePickerOpen: EventEmitter<void>;
-  /** Updates the position of the component. */
+  /** Sets focus on the component. */
   setFocus(): Promise<void>;
   /** Updates the position of the component. */
   reposition(): Promise<void>;
@@ -177,6 +181,7 @@ export declare class InputDatePicker implements LabelableComponent, FormComponen
   labelEl: HTMLCalciteLabelElement;
   formEl: HTMLFormElement;
   defaultValue: InputDatePicker["value"];
+  effectiveLocale: string;
   focusedInput: "start" | "end";
   globalAttributes: {};
   private localeData;

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

@@ -5,21 +5,18 @@ import { Scale, Status } from "../interfaces";
  */
 export declare class InputMessage {
   el: HTMLCalciteInputMessageElement;
-  /** Indicates whether the message is displayed. */
+  /** When true, the component is active. */
   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
-   */
+  /** Specifies an icon to display. */
   icon: boolean | string;
-  /** specify the scale of the input, defaults to m */
+  /** Specifies the size of the component. */
   scale: Scale;
-  /** specify the status of the input field, determines message and icons */
+  /** Specifies the status of the input field, which determines message and icons. */
   status: Status;
   /**
-   * specify the appearance of any slotted message - default (displayed under input), or floating (positioned absolutely under input)
+   * Specifies the appearance of a slotted message - `"default"` (displayed under the component), or `"floating"` (positioned absolutely under the component).
    *
-   * @deprecated "floating" type is no longer supported
+   * @deprecated The `"floating"` type is no longer supported.
    */
   type: "default";
   handleIconEl(): void;

package/dist/types/components/input-number/assets/input-number/t9n/index.d.ts

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

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

@@ -3,14 +3,13 @@ import { Event, EventEmitter, VNode } from "../../stencil-public-runtime";
 import { InputPlacement } 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.
  */
-export declare class InputNumber implements LabelableComponent, FormComponent, InteractiveComponent, GlobalAttrComponent, LangComponent {
+export declare class InputNumber implements LabelableComponent, FormComponent, InteractiveComponent, LocalizedComponent {
   el: HTMLCalciteInputNumberElement;
   /** Specifies the text alignment of the component's value. */
   alignment: Position;
@@ -55,7 +54,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
    * @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;
@@ -68,12 +67,11 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
    * @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.
    *
@@ -125,7 +123,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
   /** 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)
    */
@@ -167,9 +165,9 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
   /** 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;
@@ -187,7 +185,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
   /**
    * 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 props are deprecated, please use the event's `target`/`currentTarget` instead
    */
   calciteInputNumberInput: EventEmitter<DeprecatedEventPayload>;
   /**

package/dist/types/components/input-text/assets/input-text/t9n/index.d.ts

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

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

@@ -48,7 +48,7 @@ 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;
@@ -81,7 +81,7 @@ 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)
    */
@@ -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,77 @@ 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 } 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.
+   * 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 +84,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 +99,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.