@esri/calcite-components 1.0.0-next.659 → 1.0.0-next.660

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

@@ -48,17 +48,17 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
   /**
    * A text label that will appear on the clear button for screen readers.
    */
-  intlClear?: string;
+  intlClear: string;
   /**
    * Accessible name that will appear while loading.
    *
    * @default "Loading"
    */
-  intlLoading?: string;
+  intlLoading: string;
   /** 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;
+  label: string;
   /** When `true`, the component is in the loading state and `calcite-progress` is displayed. */
   loading: boolean;
   /**
@@ -72,7 +72,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
   /**
    * Specifies the Unicode numeral system used by the component for localization.
    */
-  numberingSystem?: NumberingSystem;
+  numberingSystem: NumberingSystem;
   /**
    * Toggles locale formatting for numbers.
    *
@@ -84,7 +84,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
    *
    * @mdn [max](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#max)
    */
-  max?: number;
+  max: number;
   /** watcher to update number-to-string for max */
   maxWatcher(): void;
   /**
@@ -92,7 +92,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
    *
    * @mdn [min](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#min)
    */
-  min?: number;
+  min: number;
   /** watcher to update number-to-string for min */
   minWatcher(): void;
   /**
@@ -100,13 +100,13 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
    *
    * @mdn [maxlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength)
    */
-  maxLength?: number;
+  maxLength: number;
   /**
    * Specifies the minimum length of text for the component's value.
    *
    * @mdn [minlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#minlength)
    */
-  minLength?: number;
+  minLength: number;
   /**
    * Specifies the name of the component.
    *
@@ -114,7 +114,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
    */
   name: string;
   /** Specifies the placement of the buttons. */
-  numberButtonType?: InputPlacement;
+  numberButtonType: InputPlacement;
   /**
    * Specifies placeholder text for the component.
    *
@@ -122,7 +122,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
    */
   placeholder: string;
   /** Adds text to the start of the component. */
-  prefixText?: string;
+  prefixText: string;
   /**
    * When `true`, the component's value can be read, but cannot be modified.
    *
@@ -140,7 +140,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
    *
    * @mdn [step](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step)
    */
-  step?: number | "any";
+  step: number | "any";
   /**
    * Specifies the type of content to autocomplete, for use in forms.
    * Read the native attribute's documentation on MDN for more info.
@@ -149,7 +149,7 @@ export declare class InputNumber implements LabelableComponent, FormComponent, I
    */
   autocomplete: string;
   /** Adds text to the end of the component.  */
-  suffixText?: string;
+  suffixText: string;
   /**
    * @internal
    */

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

@@ -42,17 +42,17 @@ export declare class InputText implements LabelableComponent, FormComponent, Int
   /**
    * A text label that will appear on the clear button for screen readers.
    */
-  intlClear?: string;
+  intlClear: string;
   /**
    * Accessible name that will appear while loading.
    *
    * @default "Loading"
    */
-  intlLoading?: string;
+  intlLoading: string;
   /** 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;
+  label: string;
   /** When `true`, the component is in the loading state and `calcite-progress` is displayed. */
   loading: boolean;
   /**
@@ -60,13 +60,13 @@ export declare class InputText implements LabelableComponent, FormComponent, Int
    *
    * @mdn [maxlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength)
    */
-  maxLength?: number;
+  maxLength: number;
   /**
    * Specifies the minimum length of text for the component's value.
    *
    * @mdn [minlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#minlength)
    */
-  minLength?: number;
+  minLength: number;
   /**
    * Specifies the name of the component.
    *
@@ -80,7 +80,7 @@ export declare class InputText implements LabelableComponent, FormComponent, Int
    */
   placeholder: string;
   /** Adds text to the start of the component. */
-  prefixText?: string;
+  prefixText: string;
   /**
    * When `true`, the component's value can be read, but cannot be modified.
    *
@@ -108,7 +108,7 @@ export declare class InputText implements LabelableComponent, FormComponent, Int
    */
   pattern: string;
   /** Adds text to the end of the component.  */
-  suffixText?: string;
+  suffixText: string;
   /**
    * @internal
    */

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

@@ -28,29 +28,29 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
   readOnly: boolean;
   handleDisabledAndReadOnlyChange(value: boolean): void;
   /** Accessible name for the component's hour input. */
-  intlHour?: string;
+  intlHour: string;
   /** Accessible name for the component's hour down button. */
-  intlHourDown?: string;
+  intlHourDown: string;
   /** Accessible name for the component's hour up button. */
-  intlHourUp?: string;
+  intlHourUp: string;
   /** Accessible name for the component's meridiem (am/pm) input. */
-  intlMeridiem?: string;
+  intlMeridiem: string;
   /** Accessible name for the component's meridiem (am/pm) down button. */
-  intlMeridiemDown?: string;
+  intlMeridiemDown: string;
   /** Accessible name for the component's meridiem (am/pm) up button. */
-  intlMeridiemUp?: string;
+  intlMeridiemUp: string;
   /** Accessible name for the component's minute input. */
-  intlMinute?: string;
+  intlMinute: string;
   /** Accessible name for the component's minute down button. */
-  intlMinuteDown?: string;
+  intlMinuteDown: string;
   /** Accessible name for the component's minute up button. */
-  intlMinuteUp?: string;
+  intlMinuteUp: string;
   /** Accessible name for the component's second input. */
-  intlSecond?: string;
+  intlSecond: string;
   /** Accessible name for the component's second down button. */
-  intlSecondDown?: string;
+  intlSecondDown: string;
   /** Accessible name for the component's second up button. */
-  intlSecondUp?: string;
+  intlSecondUp: string;
   /**
    * BCP 47 language tag for desired language and country format.
    *
@@ -65,7 +65,7 @@ export declare class InputTimePicker implements LabelableComponent, FormComponen
   /**
    * Specifies the Unicode numeral system used by the component for localization.
    */
-  numberingSystem?: NumberingSystem;
+  numberingSystem: NumberingSystem;
   /**
    * When `true`, the component must have a value in order for the form to submit.
    *

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

@@ -1,5 +1,5 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
-import { Alignment, Scale, Status } from "../interfaces";
+import { Alignment, Scale } from "../interfaces";
 /**
  * @slot - A slot for adding text and a component that can be labeled.
  */
@@ -7,30 +7,12 @@ export declare class Label {
   el: HTMLCalciteLabelElement;
   /** Specifies the text alignment of the component. */
   alignment: Alignment;
-  /**
-   * Specifies the status of the component and any child input, or input messages.
-   *
-   * @deprecated Set directly on the component the label is bound to instead.
-   */
-  status: Status;
   /** 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;
   /** Specifies the size of the component. */
   scale: Scale;
   /** 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";
-  /**
-   * When `true`, interaction is prevented and the component is displayed with lower opacity.
-   *
-   * @deprecated Use the `disabled` property on the component the label is bound to instead.
-   */
-  disabled: boolean;
-  /**
-   * When `true`, disables the component's spacing.
-   *
-   * @deprecated Set the `--calcite-label-margin-bottom` css variable to `0` instead.
-   */
-  disableSpacing: boolean;
   /**
    * @internal
    */

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

@@ -17,17 +17,17 @@ export declare class Link implements InteractiveComponent, LoadableComponent {
    */
   download: string | boolean;
   /** Specifies the URL of the linked resource, which can be set as an absolute or relative path. */
-  href?: string;
+  href: string;
   /** Specifies an icon to display at the end of the component. */
-  iconEnd?: string;
+  iconEnd: string;
   /** When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`). */
-  iconFlipRtl?: FlipContext;
+  iconFlipRtl: FlipContext;
   /** Specifies an icon to display at the start of the component. */
-  iconStart?: string;
+  iconStart: string;
   /** Specifies the relationship to the linked document defined in `href`. */
-  rel?: string;
+  rel: string;
   /** Specifies the frame or window to open the linked document. */
-  target?: string;
+  target: string;
   componentWillLoad(): void;
   componentDidLoad(): void;
   componentDidRender(): void;

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

@@ -14,36 +14,36 @@ export declare class List implements InteractiveComponent, LoadableComponent {
    */
   disabled: boolean;
   /**
-   * When true, an input appears at the top of the list that can be used by end users to filter items in the list.
+   * When `true`, an input appears at the top of the component that can be used by end users to filter `calcite-list-item`s.
    */
   filterEnabled: boolean;
   handleFilterEnabledChange(): void;
   /**
-   * **read-only** The currently filtered items
+   * The currently filtered `calcite-list-item`s.
    *
    * @readonly
    */
   filteredItems: HTMLCalciteListItemElement[];
   /**
-   * **read-only** The currently filtered items
+   * The currently filtered `calcite-list-item` data.
    *
    * @readonly
    */
   filteredData: ItemData;
   /**
-   * Placeholder text for the filter input field.
+   * Placeholder text for the component's filter input field.
    */
   filterPlaceholder: string;
   /**
-   * Text for the filter input field.
+   * Text for the component's filter input field.
    */
   filterText: string;
   /**
    * Specifies an accessible name for the component.
    */
-  label?: string;
+  label: string;
   /**
-   * When true, content is waiting to be loaded. This state shows a busy indicator.
+   * When `true`, a busy indicator is displayed.
    */
   loading: boolean;
   /**
@@ -59,16 +59,16 @@ export declare class List implements InteractiveComponent, LoadableComponent {
    */
   selectedItems: HTMLCalciteListItemElement[];
   /**
-   * specify the selection mode - multiple (allow any number of (or no) selected items), single (allow and require one selected item), none (no selected items), defaults to single
+   * Specifies the selection mode - `"multiple"` (allow any number of selected items), `"single"` (allows and require one selected item), `"none"` (no selected items).
    */
   selectionMode: SelectionMode;
   /**
-   * specify the selection appearance - icon (displays a checkmark or dot), border (displays a border), defaults to icon
+   * Specifies the selection appearance - `"icon"` (displays a checkmark or dot) or `"border"` (displays a border).
    */
   selectionAppearance: SelectionAppearance;
   handleSelectionAppearanceChange(): void;
   /**
-   * Emits when a filter has changed.
+   * Emits when the component's filter has changed.
    */
   calciteListFilter: EventEmitter<void>;
   handleCalciteInternalFocusPreviousItem(event: CustomEvent): void;

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

@@ -21,7 +21,7 @@ export declare class ListItem implements InteractiveComponent, LoadableComponent
   /**
    * A description for the component. Displays below the label text.
    */
-  description?: string;
+  description: string;
   /**
    * When `true`, interaction is prevented and the component is displayed with lower opacity.
    */
@@ -31,11 +31,11 @@ export declare class ListItem implements InteractiveComponent, LoadableComponent
    */
   label: string;
   /**
-   * Provides additional metadata to the component. Primary use is for a filter on the parent list.
+   * Provides additional metadata to the component. Primary use is for a filter on the parent `calcite-list`.
    */
-  metadata?: Record<string, unknown>;
+  metadata: Record<string, unknown>;
   /**
-   * When true, item is open to show child components.
+   * When `true`, the item is open to show child components.
    */
   open: boolean;
   /**
@@ -51,7 +51,7 @@ export declare class ListItem implements InteractiveComponent, LoadableComponent
    */
   setPosition: number;
   /**
-   * When true, the component is selected.
+   * When `true`, the component is selected.
    */
   selected: boolean;
   handleSelectedChange(value: boolean): void;
@@ -60,19 +60,19 @@ export declare class ListItem implements InteractiveComponent, LoadableComponent
    */
   value: any;
   /**
-   * specify the selection mode - multiple (allow any number of (or no) selected items), single (allow and require one selected item), none (no selected items), defaults to single
+   * Specifies the selection mode - `"multiple"` (allow any number of selected items), `"single"` (allows and require one selected item), `"none"` (no selected items).
    *
    * @internal
    */
   selectionMode: SelectionMode;
   /**
-   * specify the selection appearance - icon (displays a checkmark or dot), border (displays a border), defaults to icon
+   * Specifies the selection appearance - `"icon"` (displays a checkmark or dot) or `"border"` (displays a border).
    *
    * @internal
    */
   selectionAppearance: SelectionAppearance;
   /**
-   * Emitted whenever the list item content is selected.
+   * Emits when the item's content is selected.
    */
   calciteListItemSelect: EventEmitter<void>;
   /**

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

@@ -5,7 +5,7 @@ import { InteractiveComponent } from "../../utils/interactive";
  */
 export declare class ListItemGroup 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/loader/loader.d.ts

@@ -25,7 +25,7 @@ export declare class Loader {
   /** 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;
+  text: string;
   /**
    * Disables spacing around the component.
    *

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

@@ -23,7 +23,7 @@ export declare class Modal implements ConditionalSlotComponent, OpenCloseCompone
   /** When `true`, displays and positions the component.  */
   open: boolean;
   /** Passes a function to run before the component closes. */
-  beforeClose?: (el: HTMLElement) => Promise<void>;
+  beforeClose: (el: HTMLElement) => Promise<void>;
   /** When `true`, disables the component's close button. */
   disableCloseButton: boolean;
   /** When `true`, disables the closing of the component when clicked outside. */
@@ -44,7 +44,7 @@ export declare class Modal implements ConditionalSlotComponent, OpenCloseCompone
    * Adds a color bar to the top of component for visual impact.
    * Use color to add importance to destructive or workflow dialogs.
    */
-  color?: "red" | "blue";
+  color: "red" | "blue";
   /** Sets the background color of the component's content. */
   backgroundColor: ModalBackgroundColor;
   /**

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

@@ -34,10 +34,10 @@ export declare class Notice implements ConditionalSlotComponent, LoadableCompone
    *
    * @deprecated use `closable` instead.
    */
-  dismissible?: boolean;
+  dismissible: boolean;
   handleDismissible(value: boolean): void;
   /** When `true`, a close button is added to the component. */
-  closable?: boolean;
+  closable: boolean;
   handleClosable(value: boolean): void;
   /**
    * When `true`, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.

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

@@ -16,7 +16,7 @@ export declare class Pagination implements LocalizedComponent {
   /**
    * Specifies the Unicode numeral system used by the component for localization.
    */
-  numberingSystem?: NumberingSystem;
+  numberingSystem: NumberingSystem;
   /** Specifies the starting item number. */
   start: number;
   /** Specifies the total number of items. */

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

@@ -1,5 +1,4 @@
 export type Messages = {
-  back: string;
   close: string;
   options: string;
 };

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

@@ -29,11 +29,11 @@ export declare class Panel implements InteractiveComponent, LoadableComponent {
   /**
    * Specifies the maximum height of the component.
    */
-  heightScale?: Scale;
+  heightScale: Scale;
   /**
    * Specifies the width of the component.
    */
-  widthScale?: Scale;
+  widthScale: Scale;
   /**
    * When `true`, a busy indicator is displayed.
    */
@@ -41,15 +41,15 @@ export declare class Panel implements InteractiveComponent, LoadableComponent {
   /**
    * Accessible name for the component's close button. The close button will only be shown when `closeable` is `true`.
    */
-  intlClose?: string;
+  intlClose: string;
   /**
    * Accessible name for the component's actions menu.
    */
-  intlOptions?: string;
+  intlOptions: string;
   /**
    * The component header text.
    */
-  heading?: string;
+  heading: string;
   /** A description for the component. */
   description: string;
   /**

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

@@ -11,7 +11,7 @@ export declare class PickListItem implements ConditionalSlotComponent, Interacti
   /**
    * A description for the component that displays below the label text.
    */
-  description?: string;
+  description: string;
   descriptionWatchHandler(): void;
   /**
    * When `true`, interaction is prevented and the component is displayed with lower opacity.
@@ -30,7 +30,7 @@ export declare class PickListItem implements ConditionalSlotComponent, Interacti
    *
    * @see [ICON_TYPES](https://github.com/Esri/calcite-components/blob/master/src/components/pick-list/resources.ts#L5)
    */
-  icon?: ICON_TYPES | null;
+  icon: ICON_TYPES | null;
   /**
    * Label and accessible name for the component. Appears next to the icon.
    */
@@ -39,12 +39,12 @@ export declare class PickListItem implements ConditionalSlotComponent, Interacti
   /**
    * Provides additional metadata to the component. Primary use is for a filter on the parent list.
    */
-  metadata?: Record<string, unknown>;
+  metadata: Record<string, unknown>;
   metadataWatchHandler(): void;
   /**
    * When `true`, displays a remove action that removes the item from the list.
    */
-  removable?: boolean;
+  removable: boolean;
   /**
    * When `true`, selects an item. Toggles when an item is checked/unchecked.
    */

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

@@ -30,12 +30,12 @@ export declare class Popover implements FloatingUIComponent, OpenCloseComponent,
   /**
    * Defines the available placements that can be used when a flip occurs.
    */
-  flipPlacements?: EffectivePlacement[];
+  flipPlacements: EffectivePlacement[];
   flipPlacementsHandler(): void;
   /**
    * The component header text.
    */
-  heading?: string;
+  heading: string;
   /**
    * Specifies the number at which section headings should start.
    */

package/dist/types/components/radio-group-item/radio-group-item.d.ts

@@ -7,9 +7,9 @@ export declare class RadioGroupItem {
   /** When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`). */
   iconFlipRtl: boolean;
   /** Specifies an icon to display at the start of the component. */
-  iconStart?: string;
+  iconStart: string;
   /** Specifies an icon to display at the end of the component. */
-  iconEnd?: string;
+  iconEnd: string;
   /**
    * The component's value.
    */

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

@@ -17,9 +17,9 @@ export declare class Rating implements LabelableComponent, FormComponent, Intera
   /** When `true`, and if available, displays the `average` and/or `count` data summary in a `calcite-chip`. */
   showChip: boolean;
   /** Specifies the number of previous ratings to display. */
-  count?: number;
+  count: number;
   /** Specifies a cumulative average from previous ratings to display. */
-  average?: number;
+  average: number;
   /** Specifies the name of the component on form submission. */
   name: string;
   /**
@@ -27,13 +27,13 @@ export declare class Rating implements LabelableComponent, FormComponent, Intera
    *
    * @default "Rating"
    */
-  intlRating?: string;
+  intlRating: string;
   /**
    * Accessible name for each star. The `${num}` in the string will be replaced by the number.
    *
    * @default "Stars: ${num}"
    */
-  intlStars?: string;
+  intlStars: string;
   /**
    * When `true`, the component must have a value in order for the form to submit.
    *

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

@@ -8,7 +8,7 @@ export declare class Scrim {
    *
    * @default "Loading"
    */
-  intlLoading?: string;
+  intlLoading: string;
   /**
    * When `true`, a busy indicator is displayed.
    */

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

@@ -21,7 +21,7 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
    *
    * @see [DataSeries](https://github.com/Esri/calcite-components/blob/master/src/components/graph/interfaces.ts#L5)
    */
-  histogram?: DataSeries;
+  histogram: DataSeries;
   histogramWatcher(newHistogram: DataSeries): void;
   /**
    * A set of single color stops for a histogram, sorted by offset ascending.
@@ -34,15 +34,15 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   /** The component's maximum selectable value. */
   max: number;
   /** For multiple selections, the accessible name for the second handle, such as `"Temperature, upper bound"`. */
-  maxLabel?: string;
+  maxLabel: string;
   /** For multiple selections, the component's upper value. */
-  maxValue?: number;
+  maxValue: number;
   /** The component's minimum selectable value. */
   min: number;
   /** Accessible name for first (or only) handle, such as `"Temperature, lower bound"`. */
   minLabel: string;
   /** For multiple selections, the component's lower value. */
-  minValue?: number;
+  minValue: number;
   /**
    * When `true`, the slider will display values from high to low.
    *
@@ -54,9 +54,9 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   /**
    * Specifies the Unicode numeral system used by the component for localization.
    */
-  numberingSystem?: NumberingSystem;
+  numberingSystem: NumberingSystem;
   /** Specifies the interval to move with the page up, or page down keys. */
-  pageStep?: number;
+  pageStep: number;
   /** When `true`, sets a finer point for handles. */
   precise: boolean;
   /**
@@ -66,9 +66,9 @@ export declare class Slider implements LabelableComponent, FormComponent, Intera
   /** When `true`, enables snap selection in coordination with `step` via a mouse. */
   snap: boolean;
   /** Specifies the interval to move with the up, or down keys. */
-  step?: number;
+  step: number;
   /** Displays tick marks on the number line at a specified interval. */
-  ticks?: number;
+  ticks: number;
   /** The component's value. */
   value: null | number | number[];
   valueHandler(): void;