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

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

@@ -1,4 +1,3 @@
-/// <reference types="lodash" />
 import { VNode, EventEmitter } from "../../stencil-public-runtime";
 import { HeadingLevel } from "../functional/Heading";
 import { LabelableComponent } from "../../utils/label";
@@ -7,7 +6,9 @@ import { OverlayPositioning, FloatingUIComponent, EffectivePlacement, MenuPlacem
 import { DateRangeChange } from "../date-picker/interfaces";
 import { InteractiveComponent } from "../../utils/interactive";
 import { OpenCloseComponent } from "../../utils/openCloseComponent";
-export declare class InputDatePicker implements LabelableComponent, FormComponent, InteractiveComponent, OpenCloseComponent, FloatingUIComponent {
+import { GlobalAttrComponent } from "../../utils/globalAttributes";
+import { LangComponent } from "../../utils/locale";
+export declare class InputDatePicker implements LabelableComponent, FormComponent, GlobalAttrComponent, InteractiveComponent, OpenCloseComponent, FloatingUIComponent, LangComponent {
   el: HTMLCalciteInputDatePickerElement;
   /**
    * When false, the component won't be interactive.
@@ -88,7 +89,12 @@ export declare class InputDatePicker implements LabelableComponent, FormComponen
    * @default "Year"
    */
   intlYear?: string;
-  /** BCP 47 language tag for desired language and country format */
+  /**
+   * BCP 47 language tag for 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 */
   scale: "s" | "m" | "l";
@@ -172,6 +178,7 @@ export declare class InputDatePicker implements LabelableComponent, FormComponen
   formEl: HTMLFormElement;
   defaultValue: InputDatePicker["value"];
   focusedInput: "start" | "end";
+  globalAttributes: {};
   private localeData;
   private startInput;
   private endInput;
@@ -182,7 +189,7 @@ export declare class InputDatePicker implements LabelableComponent, FormComponen
   openTransitionProp: string;
   transitionEl: HTMLDivElement;
   setReferenceEl(): void;
-  debouncedReposition: import("lodash").DebouncedFunc<() => Promise<void>>;
+  private debouncedReposition;
   setFilteredPlacements: () => void;
   private setTransitionEl;
   onLabelClick(): void;

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

@@ -1,15 +1,16 @@
-import { DeprecatedEventPayload, Scale, Status } from "../interfaces";
+import { DeprecatedEventPayload, Position, Scale, Status } from "../interfaces";
 import { Event, EventEmitter, VNode } from "../../stencil-public-runtime";
 import { InputPlacement } from "./interfaces";
-import { Position } from "../interfaces";
 import { LabelableComponent } from "../../utils/label";
 import { FormComponent } from "../../utils/form";
+import { LangComponent } 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 {
+export declare class InputNumber implements LabelableComponent, FormComponent, InteractiveComponent, GlobalAttrComponent, LangComponent {
   el: HTMLCalciteInputNumberElement;
   /** Specifies the text alignment of the component's value. */
   alignment: Position;
@@ -60,7 +61,12 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
   label?: string;
   /** When true, the component is in the loading state and `calcite-progress` is displayed. */
   loading: boolean;
-  /** Specifies the BCP 47 language tag for the 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.
@@ -163,6 +169,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
   private nudgeNumberValueIntervalId;
   mutationObserver: MutationObserver;
   private userChangedValue;
+  globalAttributes: {};
   localizedValue: string;
   connectedCallback(): void;
   disconnectedCallback(): void;

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

@@ -1,10 +1,11 @@
-import { VNode, EventEmitter } from "../../stencil-public-runtime";
+import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { Scale } from "../interfaces";
 import { FloatingUIComponent, LogicalPlacement, OverlayPositioning } from "../../utils/floating-ui";
 import { LabelableComponent } from "../../utils/label";
 import { FormComponent } from "../../utils/form";
 import { InteractiveComponent } from "../../utils/interactive";
-export declare class InputTimePicker implements LabelableComponent, FormComponent, InteractiveComponent, FloatingUIComponent {
+import { GlobalAttrComponent } from "../../utils/globalAttributes";
+export declare class InputTimePicker implements LabelableComponent, FormComponent, InteractiveComponent, FloatingUIComponent, GlobalAttrComponent {
   el: HTMLCalciteInputTimePickerElement;
   /**
    * The active state of the time input
@@ -53,9 +54,11 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
    * 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(newLocale: string): void;
+  localeWatcher(): void;
   /** The name of the time input */
   name: string;
   /**
@@ -94,6 +97,7 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
   private previousValidValue;
   private referenceElementId;
   popoverEl: HTMLCalcitePopoverElement;
+  globalAttributes: {};
   localizedValue: string;
   /**
    * Fires when the time value is changed as a result of user input.

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

@@ -1,12 +1,13 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { Scale } from "../interfaces";
 import { GlobalAttrComponent } from "../../utils/globalAttributes";
+import { LangComponent } from "../../utils/locale";
 export interface PaginationDetail {
   start: number;
   total: number;
   num: number;
 }
-export declare class Pagination implements GlobalAttrComponent {
+export declare class Pagination implements GlobalAttrComponent, LangComponent {
   /**
    * When true, number values are displayed with a group separator corresponding to the language and country format.
    */

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

@@ -114,11 +114,17 @@ export declare class Panel implements InteractiveComponent {
   /**
    * Fires when the close button is clicked.
    */
+  calcitePanelClose: EventEmitter<void>;
+  /**
+   * Fires when the close button is clicked.
+   *
+   * @deprecated use calcitePanelClose instead.
+   */
   calcitePanelDismiss: EventEmitter<void>;
   /**
    * Fires when there is a change to the `dismissed` property value .
    *
-   * @deprecated use calcitePanelDismiss instead.
+   * @deprecated use calcitePanelClose instead.
    */
   calcitePanelDismissedChange: EventEmitter<void>;
   /**

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

@@ -1,4 +1,3 @@
-/// <reference types="lodash" />
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { OverlayPositioning, FloatingUIComponent, LogicalPlacement, EffectivePlacement, ReferenceElement } from "../../utils/floating-ui";
 import { OpenCloseComponent } from "../../utils/openCloseComponent";
@@ -131,7 +130,7 @@ export declare class Popover implements FloatingUIComponent, OpenCloseComponent
    * @param value
    */
   toggle(value?: boolean): Promise<void>;
-  debouncedReposition: import("lodash").DebouncedFunc<() => Promise<void>>;
+  private debouncedReposition;
   private setTransitionEl;
   setFilteredPlacements: () => void;
   setUpReferenceElement: (warn?: boolean) => void;

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

@@ -1,7 +1,9 @@
 import { VNode, EventEmitter } from "../../stencil-public-runtime";
 import { Scale } from "../interfaces";
 import { TimePart, HourCycle, Meridiem } from "../../utils/time";
-export declare class TimePicker {
+import { GlobalAttrComponent } from "../../utils/globalAttributes";
+import { LangComponent } from "../../utils/locale";
+export declare class TimePicker implements GlobalAttrComponent, LangComponent {
   el: HTMLCalciteTimePickerElement;
   /**
    * Accessible name for the component's hour input.
@@ -79,9 +81,11 @@ export declare class TimePicker {
    * 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(newLocale: string): void;
+  localeWatcher(): void;
   /** Specifies the size of the component. */
   scale: Scale;
   /** Specifies the granularity the "value" must adhere to (in seconds). */
@@ -95,6 +99,7 @@ export declare class TimePicker {
   private minuteEl;
   private secondEl;
   private meridiemOrder;
+  globalAttributes: {};
   hour: string;
   hourCycle: HourCycle;
   localizedHour: string;
@@ -160,6 +165,8 @@ export declare class TimePicker {
   private setValue;
   private setValuePart;
   private getMeridiemOrder;
+  private updateLocale;
   connectedCallback(): void;
+  disconnectedCallback(): void;
   render(): VNode;
 }

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

@@ -1,4 +1,3 @@
-/// <reference types="lodash" />
 import { VNode } from "../../stencil-public-runtime";
 import { OverlayPositioning, FloatingUIComponent, LogicalPlacement, ReferenceElement } from "../../utils/floating-ui";
 /**
@@ -56,7 +55,7 @@ export declare class Tooltip implements FloatingUIComponent {
   disconnectedCallback(): void;
   /** Updates the position of the component. */
   reposition(): Promise<void>;
-  debouncedReposition: import("lodash").DebouncedFunc<() => Promise<void>>;
+  private debouncedReposition;
   setUpReferenceElement: (warn?: boolean) => void;
   getId: () => string;
   addReferences: () => void;

package/dist/types/components.d.ts

@@ -823,8 +823,9 @@ export namespace Components {
          */
         "storageId": string;
         /**
-          * The color value.  This value can be either a {@link https ://developer.mozilla.org/en-US/docs/Web/CSS/color|CSS string} a RGB, HSL or HSV object.  The type will be preserved as the color is updated.
+          * The component's value.  This value can be either a CSS color string, a RGB, HSL or HSV object.  The type will be preserved as the color is updated.
           * @default "#007ac2"
+          * @see [CSS Color](https://developer.mozilla.org/en-US/docs/Web/CSS/color)
           * @see [ColorValue](https://github.com/Esri/calcite-components/blob/master/src/components/color-picker/interfaces.ts#L10)
          */
         "value": ColorValue | null;
@@ -1046,6 +1047,8 @@ export namespace Components {
         "intlYear"?: string;
         /**
           * BCP 47 language tag for 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;
         /**
@@ -1208,10 +1211,6 @@ export namespace Components {
           * Localized string for year.
          */
         "intlYear": string;
-        /**
-          * User's language and region as BCP 47 formatted string.
-         */
-        "locale": string;
         /**
           * CLDR locale data for translated calendar info
          */
@@ -1658,7 +1657,9 @@ export namespace Components {
          */
         "loading": boolean;
         /**
-          * Specifies the BCP 47 language tag for the desired language and country format.
+          * BCP 47 language tag for 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;
         /**
@@ -1820,6 +1821,8 @@ export namespace Components {
         "layout": "horizontal" | "vertical";
         /**
           * BCP 47 language tag for 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;
         /**
@@ -1982,6 +1985,8 @@ export namespace Components {
         "loading": boolean;
         /**
           * 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;
         /**
@@ -2238,6 +2243,8 @@ export namespace Components {
         "intlSecondUp"?: string;
         /**
           * BCP 47 language tag for 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;
         /**
@@ -3839,6 +3846,8 @@ export namespace Components {
         "intlSecondUp": string;
         /**
           * BCP 47 language tag for 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;
         /**
@@ -5840,8 +5849,9 @@ declare namespace LocalJSX {
          */
         "storageId"?: string;
         /**
-          * The color value.  This value can be either a {@link https ://developer.mozilla.org/en-US/docs/Web/CSS/color|CSS string} a RGB, HSL or HSV object.  The type will be preserved as the color is updated.
+          * The component's value.  This value can be either a CSS color string, a RGB, HSL or HSV object.  The type will be preserved as the color is updated.
           * @default "#007ac2"
+          * @see [CSS Color](https://developer.mozilla.org/en-US/docs/Web/CSS/color)
           * @see [ColorValue](https://github.com/Esri/calcite-components/blob/master/src/components/color-picker/interfaces.ts#L10)
          */
         "value"?: ColorValue | null;
@@ -6088,6 +6098,8 @@ declare namespace LocalJSX {
         "intlYear"?: string;
         /**
           * BCP 47 language tag for 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;
         /**
@@ -6267,10 +6279,6 @@ declare namespace LocalJSX {
           * Localized string for year.
          */
         "intlYear"?: string;
-        /**
-          * User's language and region as BCP 47 formatted string.
-         */
-        "locale"?: string;
         /**
           * CLDR locale data for translated calendar info
          */
@@ -6558,7 +6566,16 @@ declare namespace LocalJSX {
         /**
           * Fires when the back button is clicked.
          */
+        "onCalciteFlowItemBack"?: (event: CalciteFlowItemCustomEvent<void>) => void;
+        /**
+          * Fires when the back button is clicked.
+          * @deprecated use calciteFlowItemBack instead.
+         */
         "onCalciteFlowItemBackClick"?: (event: CalciteFlowItemCustomEvent<void>) => void;
+        /**
+          * Fires when the close button is clicked.
+         */
+        "onCalciteFlowItemClose"?: (event: CalciteFlowItemCustomEvent<void>) => void;
         /**
           * When true, displays a back button in the header.
          */
@@ -6725,7 +6742,9 @@ declare namespace LocalJSX {
          */
         "loading"?: boolean;
         /**
-          * Specifies the BCP 47 language tag for the desired language and country format.
+          * BCP 47 language tag for 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;
         /**
@@ -6883,6 +6902,8 @@ declare namespace LocalJSX {
         "layout"?: "horizontal" | "vertical";
         /**
           * BCP 47 language tag for 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;
         /**
@@ -7063,6 +7084,8 @@ declare namespace LocalJSX {
         "loading"?: boolean;
         /**
           * 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;
         /**
@@ -7768,10 +7791,15 @@ declare namespace LocalJSX {
         /**
           * Fires when the close button is clicked.
          */
+        "onCalcitePanelClose"?: (event: CalcitePanelCustomEvent<void>) => void;
+        /**
+          * Fires when the close button is clicked.
+          * @deprecated use calcitePanelClose instead.
+         */
         "onCalcitePanelDismiss"?: (event: CalcitePanelCustomEvent<void>) => void;
         /**
           * Fires when there is a change to the `dismissed` property value .
-          * @deprecated use calcitePanelDismiss instead.
+          * @deprecated use calcitePanelClose instead.
          */
         "onCalcitePanelDismissedChange"?: (event: CalcitePanelCustomEvent<void>) => void;
         /**

package/dist/types/preact.d.ts

@@ -145,8 +145,10 @@ declare module "preact/src/jsx" {
 
       "calcite-flow": JSX.CalciteFlow & JSXInternal.HTMLAttributes<HTMLCalciteFlowElement>
 
-      "calcite-flow-item": Omit<JSX.CalciteFlowItem, "onCalciteFlowItemBackClick"> & JSXInternal.HTMLAttributes<HTMLCalciteFlowItemElement> & {
+      "calcite-flow-item": Omit<JSX.CalciteFlowItem, "onCalciteFlowItemBack" | "onCalciteFlowItemBackClick" | "onCalciteFlowItemClose"> & JSXInternal.HTMLAttributes<HTMLCalciteFlowItemElement> & {
+        "oncalciteFlowItemBack"?: (event: CustomEvent<any>) => void;
         "oncalciteFlowItemBackClick"?: (event: CustomEvent<any>) => void;
+        "oncalciteFlowItemClose"?: (event: CustomEvent<any>) => void;
       }
 
       "calcite-graph": JSX.CalciteGraph & JSXInternal.HTMLAttributes<HTMLCalciteGraphElement>
@@ -239,7 +241,8 @@ declare module "preact/src/jsx" {
         "oncalcitePaginationChange"?: (event: CustomEvent<any>) => void;
       }
 
-      "calcite-panel": Omit<JSX.CalcitePanel, "onCalcitePanelDismiss" | "onCalcitePanelDismissedChange" | "onCalcitePanelScroll" | "onCalcitePanelBackClick"> & JSXInternal.HTMLAttributes<HTMLCalcitePanelElement> & {
+      "calcite-panel": Omit<JSX.CalcitePanel, "onCalcitePanelClose" | "onCalcitePanelDismiss" | "onCalcitePanelDismissedChange" | "onCalcitePanelScroll" | "onCalcitePanelBackClick"> & JSXInternal.HTMLAttributes<HTMLCalcitePanelElement> & {
+        "oncalcitePanelClose"?: (event: CustomEvent<any>) => void;
         "oncalcitePanelDismiss"?: (event: CustomEvent<any>) => void;
         "oncalcitePanelDismissedChange"?: (event: CustomEvent<any>) => void;
         "oncalcitePanelScroll"?: (event: CustomEvent<any>) => void;

package/dist/types/utils/locale.d.ts

@@ -1,3 +1,4 @@
+import { GlobalAttrComponent } from "./globalAttributes";
 export declare const locales: string[];
 export declare function createLocaleNumberFormatter(locale: string, numberingSystem?: string): Intl.NumberFormat;
 export declare function delocalizeNumberString(numberString: string, locale: string): string;
@@ -5,3 +6,24 @@ export declare function getGroupSeparator(locale: string): string;
 export declare function getDecimalSeparator(locale: string): string;
 export declare function getMinusSign(locale: string): string;
 export declare function localizeNumberString(numberString: string, locale: string, displayGroupSeparator?: boolean, numberingSystem?: string): string;
+/**
+ * This interface is for components that need to determine locale from the lang attribute.
+ */
+export interface LangComponent extends GlobalAttrComponent {
+  /**
+   * BCP 47 language tag for desired language and country format
+   *
+   * **Note**: this prop was added exclusively for backwards-compatibility
+   *
+   * @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;
+}
+/**
+ * This util helps resolve a component's locale.
+ * It will also fall back on the deprecated `locale` if a component implemented this previously.
+ *
+ * @param component
+ */
+export declare function getLocale(component: LangComponent): string;