@esri/calcite-components 1.0.0-next.416 → 1.0.0-next.419

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-03-14T20:02:04",
+  "timestamp": "2022-03-15T22:33:23",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.14.1",
@@ -1135,14 +1135,14 @@
         },
         {
           "name": "flipPlacements",
-          "type": "Placement[]",
+          "type": "ComputedPlacement[]",
           "mutable": false,
           "reflectToAttr": false,
           "docs": "Defines the available placements that can be used when a flip occurs.",
           "docsTags": [],
           "values": [
             {
-              "type": "Placement[]"
+              "type": "ComputedPlacement[]"
             }
           ],
           "optional": true,
@@ -4783,6 +4783,21 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "flipPlacements",
+          "type": "ComputedPlacement[]",
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "Defines the available placements that can be used when a flip occurs.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "ComputedPlacement[]"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "intlRemoveTag",
           "type": "string",
@@ -6561,6 +6576,21 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "flipPlacements",
+          "type": "ComputedPlacement[]",
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "Defines the available placements that can be used when a flip occurs.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "ComputedPlacement[]"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "maxItems",
           "type": "number",
@@ -6613,7 +6643,7 @@
               "text": "\"bottom-leading\""
             }
           ],
-          "default": "DefaultDropdownPlacement",
+          "default": "defaultMenuPlacement",
           "values": [
             {
               "value": "bottom",
@@ -9115,6 +9145,21 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "flipPlacements",
+          "type": "ComputedPlacement[]",
+          "mutable": false,
+          "reflectToAttr": false,
+          "docs": "Defines the available placements that can be used when a flip occurs.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "ComputedPlacement[]"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "headingLevel",
           "type": "1 | 2 | 3 | 4 | 5 | 6",
@@ -13323,14 +13368,14 @@
         },
         {
           "name": "flipPlacements",
-          "type": "Placement[]",
+          "type": "ComputedPlacement[]",
           "mutable": false,
           "reflectToAttr": false,
           "docs": "Defines the available placements that can be used when a flip occurs.",
           "docsTags": [],
           "values": [
             {
-              "type": "Placement[]"
+              "type": "ComputedPlacement[]"
             }
           ],
           "optional": true,
@@ -13518,7 +13563,7 @@
               "text": "[PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)"
             }
           ],
-          "default": "\"auto\"",
+          "default": "defaultPopoverPlacement",
           "values": [
             {
               "type": "Placement"

package/dist/types/components/action-menu/action-menu.d.ts

@@ -1,7 +1,6 @@
 import { EventEmitter } from "../../stencil-public-runtime";
 import { VNode } from "../../stencil-public-runtime";
-import { PopperPlacement, OverlayPositioning } from "../../utils/popper";
-import { Placement } from "@popperjs/core";
+import { PopperPlacement, OverlayPositioning, ComputedPlacement } from "../../utils/popper";
 import { Scale } from "../interfaces";
 import { ConditionalSlotComponent } from "../../utils/conditionalSlot";
 /**
@@ -20,7 +19,7 @@ export declare class ActionMenu implements ConditionalSlotComponent {
   /**
    * Defines the available placements that can be used when a flip occurs.
    */
-  flipPlacements?: Placement[];
+  flipPlacements?: ComputedPlacement[];
   /**
    *  Text string for the actions menu.
    */

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

@@ -1,6 +1,6 @@
 /// <reference types="lodash" />
 import { Event, EventEmitter, VNode } from "../../stencil-public-runtime";
-import { OverlayPositioning } from "../../utils/popper";
+import { OverlayPositioning, ComputedPlacement } from "../../utils/popper";
 import { StrictModifiers } from "@popperjs/core";
 import { Scale } from "../interfaces";
 import { ComboboxSelectionMode, ComboboxChildElement } from "./interfaces";
@@ -56,6 +56,10 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
    * @default "Remove tag"
    */
   intlRemoveTag: string;
+  /**
+   * Defines the available placements that can be used when a flip occurs.
+   */
+  flipPlacements?: ComputedPlacement[];
   documentClickHandler(event: Event): void;
   calciteComboboxItemChangeHandler(event: CustomEvent<HTMLCalciteComboboxItemElement>): void;
   /** Updates the position of the component. */

package/dist/types/components/combobox/resources.d.ts

@@ -1,7 +1,6 @@
 export declare const ComboboxItem = "CALCITE-COMBOBOX-ITEM";
 export declare const ComboboxItemGroup = "CALCITE-COMBOBOX-ITEM-GROUP";
 export declare const ComboboxChildSelector: string;
-export declare const ComboboxDefaultPlacement = "bottom-leading";
 export declare const TEXT: {
   removeTag: string;
 };

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

@@ -1,6 +1,6 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
-import { DropdownPlacement, ItemKeyboardEvent } from "./interfaces";
-import { OverlayPositioning } from "../../utils/popper";
+import { ItemKeyboardEvent } from "./interfaces";
+import { ComputedPlacement, OverlayPositioning, MenuPlacement } from "../../utils/popper";
 import { StrictModifiers } from "@popperjs/core";
 import { Scale } from "../interfaces";
 import { InteractiveComponent } from "../../utils/interactive";
@@ -21,6 +21,10 @@ export declare class Dropdown implements InteractiveComponent {
   /** is the dropdown disabled  */
   disabled: boolean;
   handleDisabledChange(value: boolean): void;
+  /**
+   * Defines the available placements that can be used when a flip occurs.
+   */
+  flipPlacements?: ComputedPlacement[];
   /**
    specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 -
    this value does not include groupTitles passed to calcite-dropdown-group
@@ -33,7 +37,7 @@ export declare class Dropdown implements InteractiveComponent {
    * Determines where the dropdown will be positioned relative to the button.
    * @default "bottom-leading"
    */
-  placement: DropdownPlacement;
+  placement: MenuPlacement;
   placementHandler(): void;
   /** specify the scale of dropdown, defaults to m */
   scale: Scale;

package/dist/types/components/dropdown/interfaces.d.ts

@@ -1,5 +1,3 @@
-import { PopperPlacement } from "../../utils/popper";
 export interface ItemKeyboardEvent {
   keyboardEvent: KeyboardEvent;
 }
-export declare type DropdownPlacement = Extract<PopperPlacement, "top-start" | "top" | "top-end" | "bottom-start" | "bottom" | "bottom-end" | "top-leading" | "top-trailing" | "bottom-leading" | "bottom-trailing">;

package/dist/types/components/dropdown/resources.d.ts

@@ -1,4 +1,3 @@
-export declare const DefaultDropdownPlacement = "bottom-leading";
 export declare const SLOTS: {
   dropdownTrigger: string;
 };

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

@@ -2,7 +2,7 @@ import { VNode, EventEmitter } from "../../stencil-public-runtime";
 import { HeadingLevel } from "../functional/Heading";
 import { LabelableComponent } from "../../utils/label";
 import { FormComponent } from "../../utils/form";
-import { OverlayPositioning } from "../../utils/popper";
+import { OverlayPositioning, ComputedPlacement } from "../../utils/popper";
 import { StrictModifiers } from "@popperjs/core";
 import { DateRangeChange } from "../date-picker/interfaces";
 import { InteractiveComponent } from "../../utils/interactive";
@@ -16,6 +16,10 @@ export declare class InputDatePicker implements LabelableComponent, FormComponen
   /** Selected date */
   value: string | string[];
   valueHandler(value: string | string[]): void;
+  /**
+   * Defines the available placements that can be used when a flip occurs.
+   */
+  flipPlacements?: ComputedPlacement[];
   /**
    * Number at which section headings should start for this component.
    */

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

@@ -1,6 +1,6 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
-import { PopperPlacement, OverlayPositioning } from "../../utils/popper";
-import { StrictModifiers, Placement, Instance as Popper } from "@popperjs/core";
+import { PopperPlacement, OverlayPositioning, ComputedPlacement } from "../../utils/popper";
+import { StrictModifiers, Instance as Popper } from "@popperjs/core";
 import { HeadingLevel } from "../functional/Heading";
 /**
  * @slot - A slot for adding custom content.
@@ -26,7 +26,7 @@ export declare class Popover {
   /**
    * Defines the available placements that can be used when a flip occurs.
    */
-  flipPlacements?: Placement[];
+  flipPlacements?: ComputedPlacement[];
   /**
    * Heading text.
    */

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

@@ -13,6 +13,7 @@ export declare const CSS: {
 export declare const TEXT: {
   close: string;
 };
+export declare const defaultPopoverPlacement = "auto";
 export declare const POPOVER_REFERENCE = "data-calcite-popover-reference";
 export declare const ARIA_CONTROLS = "aria-controls";
 export declare const ARIA_EXPANDED = "aria-expanded";

package/dist/types/components.d.ts

@@ -7,8 +7,7 @@
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { AccordionAppearance } from "./components/accordion/interfaces";
 import { Alignment, Appearance, Columns, FlipContext, Layout, Position, Scale, Status, Width } from "./components/interfaces";
-import { Placement } from "@popperjs/core";
-import { OverlayPositioning, PopperPlacement } from "./utils/popper";
+import { ComputedPlacement, MenuPlacement, OverlayPositioning, PopperPlacement } from "./utils/popper";
 import { AlertDuration, AlertPlacement, StatusColor } from "./components/alert/interfaces";
 import { HeadingLevel } from "./components/functional/Heading";
 import { BlockSectionToggleDisplay } from "./components/block-section/interfaces";
@@ -20,8 +19,8 @@ import { ComboboxChildElement, ComboboxSelectionMode } from "./components/combob
 import { DateRangeChange } from "./components/date-picker/interfaces";
 import { DateLocaleData } from "./components/date-picker/utils";
 import { HoverRange } from "./utils/date";
-import { DropdownPlacement, ItemKeyboardEvent } from "./components/dropdown/interfaces";
 import { SelectionMode } from "./components/dropdown-group/interfaces";
+import { ItemKeyboardEvent } from "./components/dropdown/interfaces";
 import { ColorStop, DataSeries } from "./components/graph/interfaces";
 import { InputPlacement } from "./components/input/interfaces";
 import { ModalBackgroundColor } from "./components/modal/interfaces";
@@ -208,7 +207,7 @@ export namespace Components {
         /**
           * Defines the available placements that can be used when a flip occurs.
          */
-        "flipPlacements"?: Placement[];
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Text string for the actions menu.
          */
@@ -822,6 +821,10 @@ export namespace Components {
           * Disable combobox input
          */
         "disabled": boolean;
+        /**
+          * Defines the available placements that can be used when a flip occurs.
+         */
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * string to override the English "Remove tag" text for when an item is selected.
           * @default "Remove tag"
@@ -1160,6 +1163,10 @@ export namespace Components {
           * is the dropdown disabled
          */
         "disabled": boolean;
+        /**
+          * Defines the available placements that can be used when a flip occurs.
+         */
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 - this value does not include groupTitles passed to calcite-dropdown-group
          */
@@ -1172,7 +1179,7 @@ export namespace Components {
           * Determines where the dropdown will be positioned relative to the button.
           * @default "bottom-leading"
          */
-        "placement": DropdownPlacement;
+        "placement": MenuPlacement;
         /**
           * Updates the position of the component.
          */
@@ -1595,6 +1602,10 @@ export namespace Components {
           * @deprecated use valueAsDate instead
          */
         "endAsDate"?: Date;
+        /**
+          * Defines the available placements that can be used when a flip occurs.
+         */
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Number at which section headings should start for this component.
          */
@@ -2310,7 +2321,7 @@ export namespace Components {
         /**
           * Defines the available placements that can be used when a flip occurs.
          */
-        "flipPlacements"?: Placement[];
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Heading text.
          */
@@ -4303,7 +4314,7 @@ declare namespace LocalJSX {
         /**
           * Defines the available placements that can be used when a flip occurs.
          */
-        "flipPlacements"?: Placement[];
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Text string for the actions menu.
          */
@@ -4917,6 +4928,10 @@ declare namespace LocalJSX {
           * Disable combobox input
          */
         "disabled"?: boolean;
+        /**
+          * Defines the available placements that can be used when a flip occurs.
+         */
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * string to override the English "Remove tag" text for when an item is selected.
           * @default "Remove tag"
@@ -5284,6 +5299,10 @@ declare namespace LocalJSX {
           * is the dropdown disabled
          */
         "disabled"?: boolean;
+        /**
+          * Defines the available placements that can be used when a flip occurs.
+         */
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 - this value does not include groupTitles passed to calcite-dropdown-group
          */
@@ -5308,7 +5327,7 @@ declare namespace LocalJSX {
           * Determines where the dropdown will be positioned relative to the button.
           * @default "bottom-leading"
          */
-        "placement"?: DropdownPlacement;
+        "placement"?: MenuPlacement;
         /**
           * specify the scale of dropdown, defaults to m
          */
@@ -5720,6 +5739,10 @@ declare namespace LocalJSX {
           * @deprecated use valueAsDate instead
          */
         "endAsDate"?: Date;
+        /**
+          * Defines the available placements that can be used when a flip occurs.
+         */
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Number at which section headings should start for this component.
          */
@@ -6423,7 +6446,7 @@ declare namespace LocalJSX {
         /**
           * Defines the available placements that can be used when a flip occurs.
          */
-        "flipPlacements"?: Placement[];
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Heading text.
          */

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

@@ -1,8 +1,15 @@
-import { Placement, Instance as Popper, StrictModifiers, PositioningStrategy } from "@popperjs/core";
+import { Placement, ComputedPlacement as PopperComputedPlacement, Instance as Popper, StrictModifiers, PositioningStrategy } from "@popperjs/core";
 declare type PlacementRtl = "leading-start" | "leading" | "leading-end" | "trailing-end" | "trailing" | "trailing-start";
 declare type VariationRtl = "leading-leading" | "leading-trailing" | "trailing-leading" | "trailing-trailing" | "top-leading" | "top-trailing" | "bottom-leading" | "bottom-trailing" | "right-leading" | "right-trailing" | "left-leading" | "left-trailing";
+export declare type ComputedPlacement = PopperComputedPlacement;
 export declare type PopperPlacement = Placement | PlacementRtl | VariationRtl;
 export declare type OverlayPositioning = PositioningStrategy;
+export declare const popperPlacements: PopperPlacement[];
+export declare const popperFlipPlacements: ComputedPlacement[];
+export declare type MenuPlacement = Extract<PopperPlacement, "top-start" | "top" | "top-end" | "bottom-start" | "bottom" | "bottom-end" | "top-leading" | "top-trailing" | "bottom-leading" | "bottom-trailing">;
+export declare const defaultMenuPlacement: MenuPlacement;
+export declare const popperMenuPlacements: MenuPlacement[];
+export declare const popperMenuFlipPlacements: ComputedPlacement[];
 export declare const CSS: {
   animation: string;
   animationActive: string;