@esri/calcite-components 5.1.0-next.5 → 5.1.0-next.50

package/dist/components/calcite-sort-handle/customElement.js

@@ -64,13 +64,42 @@ class SortHandle extends LitElement {
     return typeof this.setPosition === "number" && typeof this.setSize === "number";
   }
   get hasValidSetInfo() {
-    return this.hasSetInfo ? this.setPosition > 0 && this.setSize > 1 : true;
+    return this.hasSetInfo ? this.setPosition > 0 && this.setPosition <= this.setSize && this.setSize > 0 : true;
   }
   get hasReorderItems() {
     return !this.sortDisabled && this.hasValidSetInfo;
   }
+  get hasMoveToItems() {
+    return this.moveToItems.length > 0;
+  }
+  get hasAddToItems() {
+    return this.addToItems.length > 0;
+  }
+  get reorderGroupTitle() {
+    return this.hasMoveToItems || this.hasAddToItems ? this.messages.reorder : "";
+  }
   get hasNoItems() {
-    return !this.hasReorderItems && this.moveToItems.length < 1 && this.addToItems.length < 1;
+    return !this.hasReorderItems && !this.hasMoveToItems && !this.hasAddToItems;
+  }
+  get hasAllReorderItemsDisabled() {
+    return this.hasReorderItems && this.isTopReorderDisabled && this.isUpReorderDisabled && this.isDownReorderDisabled && this.isBottomReorderDisabled;
+  }
+  get hasOnlyDisabledReorderItems() {
+    return this.hasReorderItems && !this.hasMoveToItems && !this.hasAddToItems && this.hasAllReorderItemsDisabled;
+  }
+  get isTopReorderDisabled() {
+    const { setPosition } = this;
+    return setPosition === 1 || setPosition === 2;
+  }
+  get isUpReorderDisabled() {
+    return this.setPosition === 1;
+  }
+  get isDownReorderDisabled() {
+    return this.setPosition === this.setSize;
+  }
+  get isBottomReorderDisabled() {
+    const { setPosition, setSize } = this;
+    return setPosition === setSize || setPosition === setSize - 1;
   }
   async setFocus(options) {
     return this.focusSetter(() => this.dropdownEl, options);
@@ -139,9 +168,9 @@ class SortHandle extends LitElement {
     this.calciteSortHandleAdd.emit({ addTo });
   }
   render() {
-    const { disabled, flipPlacements, open, overlayPositioning, placement, scale, widthScale, hasNoItems } = this;
+    const { disabled, flipPlacements, hasOnlyDisabledReorderItems, open, overlayPositioning, placement, scale, widthScale, hasNoItems } = this;
     const text = this.getLabel();
-    const isDisabled = disabled || hasNoItems;
+    const isDisabled = disabled || hasNoItems || hasOnlyDisabledReorderItems;
     return this.interactiveContainer({ disabled, children: html`<calcite-dropdown class=${safeClassMap(CSS.dropdown)} .disabled=${isDisabled} .flipPlacements=${flipPlacements} @calciteDropdownBeforeClose=${this.handleBeforeClose} @calciteDropdownBeforeOpen=${this.handleBeforeOpen} @calciteDropdownClose=${this.handleClose} @calciteDropdownOpen=${this.handleOpen} .overlayPositioning=${overlayPositioning} .placement=${placement} .scale=${scale} .topLayerDisabled=${this.topLayerDisabled} .widthScale=${widthScale} ${ref(this.setDropdownEl)}><calcite-action .active=${open} .aria=${{ expanded: open }} class=${safeClassMap(CSS.handle)} .dragHandle=${true} .icon=${disabled ? ICONS.blank : ICONS.drag} .label=${text} .scale=${scale} slot=${SLOTS.trigger} .text=${text} title=${text ?? nothing}></calcite-action>${this.renderReorderGroup()}${this.renderMoveToGroup()}${this.renderAddToGroup()}</calcite-dropdown>` });
   }
   renderAddToItem(addToItem) {
@@ -151,32 +180,30 @@ class SortHandle extends LitElement {
     return keyed(moveToItem.id, html`<calcite-dropdown-item data-id=${moveToItem.id ?? nothing} .label=${moveToItem.label} @calciteDropdownItemSelect=${this.handleMoveTo}>${moveToItem.label}</calcite-dropdown-item>`);
   }
   renderReorderGroup() {
-    return this.hasReorderItems ? keyed("reorder", html`<calcite-dropdown-group .groupTitle=${this.messages.reorder} id=${IDS.reorder} .scale=${this.scale} selection-mode=none>${this.renderTop()}${this.renderUp()}${this.renderDown()}${this.renderBottom()}</calcite-dropdown-group>`) : null;
+    return this.hasReorderItems ? keyed("reorder", html`<calcite-dropdown-group .groupTitle=${this.reorderGroupTitle} id=${IDS.reorder} .scale=${this.scale} selection-mode=none>${this.renderTop()}${this.renderUp()}${this.renderDown()}${this.renderBottom()}</calcite-dropdown-group>`) : null;
   }
   renderAddToGroup() {
-    const { messages, addToItems, scale } = this;
-    return addToItems.length ? keyed("add-to-items", html`<calcite-dropdown-group .groupTitle=${messages.addTo} id=${IDS.add} .scale=${scale} selection-mode=none>${addToItems.map((addToItem) => this.renderAddToItem(addToItem))}</calcite-dropdown-group>`) : null;
+    const { messages, addToItems, scale, hasAddToItems } = this;
+    return hasAddToItems ? keyed("add-to-items", html`<calcite-dropdown-group .groupTitle=${messages.addTo} id=${IDS.add} .scale=${scale} selection-mode=none>${addToItems.map((addToItem) => this.renderAddToItem(addToItem))}</calcite-dropdown-group>`) : null;
   }
   renderMoveToGroup() {
-    const { messages, moveToItems, scale } = this;
-    return moveToItems.length ? keyed("move-to-items", html`<calcite-dropdown-group .groupTitle=${messages.moveTo} id=${IDS.move} .scale=${scale} selection-mode=none>${moveToItems.map((moveToItem) => this.renderMoveToItem(moveToItem))}</calcite-dropdown-group>`) : null;
+    const { messages, moveToItems, scale, hasMoveToItems } = this;
+    return hasMoveToItems ? keyed("move-to-items", html`<calcite-dropdown-group .groupTitle=${messages.moveTo} id=${IDS.move} .scale=${scale} selection-mode=none>${moveToItems.map((moveToItem) => this.renderMoveToItem(moveToItem))}</calcite-dropdown-group>`) : null;
   }
-  renderDropdownItem(positionIndex, label) {
-    return keyed(REORDER_VALUES[positionIndex], html`<calcite-dropdown-item data-value=${REORDER_VALUES[positionIndex] ?? nothing} .label=${label} @calciteDropdownItemSelect=${this.handleReorder}>${label}</calcite-dropdown-item>`);
+  renderDropdownItem(positionIndex, label, disabled = false) {
+    return keyed(REORDER_VALUES[positionIndex], html`<calcite-dropdown-item data-value=${REORDER_VALUES[positionIndex] ?? nothing} .disabled=${disabled} .label=${label} @calciteDropdownItemSelect=${this.handleReorder}>${label}</calcite-dropdown-item>`);
   }
   renderTop() {
-    const { setPosition } = this;
-    return setPosition !== 1 && setPosition !== 2 ? this.renderDropdownItem(0, this.messages.moveToTop) : null;
+    return this.renderDropdownItem(0, this.messages.moveToTop, this.isTopReorderDisabled);
   }
   renderUp() {
-    return this.setPosition !== 1 ? this.renderDropdownItem(1, this.messages.moveUp) : null;
+    return this.renderDropdownItem(1, this.messages.moveUp, this.isUpReorderDisabled);
   }
   renderDown() {
-    return this.setPosition !== this.setSize ? this.renderDropdownItem(2, this.messages.moveDown) : null;
+    return this.renderDropdownItem(2, this.messages.moveDown, this.isDownReorderDisabled);
   }
   renderBottom() {
-    const { setPosition, setSize } = this;
-    return setPosition !== setSize && setPosition !== setSize - 1 ? this.renderDropdownItem(3, this.messages.moveToBottom) : null;
+    return this.renderDropdownItem(3, this.messages.moveToBottom, this.isBottomReorderDisabled);
   }
 }
 customElement("calcite-sort-handle", SortHandle);

package/dist/components/calcite-sortable-list/customElement.d.ts

@@ -1,7 +1,7 @@
 /// <reference path="../../index.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { Layout } from "../interfaces.js";
-import type { DragDetail } from "../../utils/sortableComponent.js";
+import type { DragDetail } from "../../controllers/useSortable.js";
 
 /**
  * @deprecated Use the `calcite-block-group` component instead.

package/dist/components/calcite-sortable-list/customElement.js

@@ -3,10 +3,10 @@ import { c as customElement } from "../../chunks/runtime.js";
 import { css, html } from "lit";
 import { LitElement, createEvent, safeClassMap } from "@arcgis/lumina";
 import { c as createObserver } from "../../chunks/observers.js";
-import { d as disconnectSortableComponent, c as connectSortableComponent } from "../../chunks/sortableComponent.js";
 import { i as focusElement } from "../../chunks/dom.js";
 import { l as logger } from "../../chunks/logger.js";
 import { u as useInteractive } from "../../chunks/useInteractive.js";
+import { u as useSortable } from "../../chunks/useSortable.js";
 const CSS = {
   container: "container",
   containerHorizontal: "container--horizontal",
@@ -21,6 +21,7 @@ class SortableList extends LitElement {
     this.mutationObserver = createObserver("mutation", () => {
       this.setUpSorting();
     });
+    this.sortable = useSortable()(this);
     this.interactiveContainer = useInteractive(this);
     this.disabled = false;
     this.handleSelector = "calcite-handle";
@@ -50,7 +51,6 @@ class SortableList extends LitElement {
   }
   disconnectedCallback() {
     super.disconnectedCallback();
-    disconnectSortableComponent(this);
     this.endObserving();
   }
   calciteHandleNudgeNextHandler(event) {
@@ -110,7 +110,7 @@ class SortableList extends LitElement {
   }
   setUpSorting() {
     this.items = Array.from(this.el.children);
-    connectSortableComponent(this);
+    this.sortable.reset();
   }
   beginObserving() {
     this.mutationObserver?.observe(this.el, { childList: true, subtree: true });

package/dist/components/calcite-split-button/customElement.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="../../index.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { FlipPlacement, MenuPlacement, OverlayPositioning } from "../../utils/floating-ui.js";
+import type { FlipPlacement, LogicalPlacement, OverlayPositioning } from "../../utils/floating-ui.js";
 import type { DropdownIconType } from "../calcite-button/interfaces.js";
 import type { Appearance, FlipContext, Kind, Scale, Width } from "../interfaces.js";
 import type { IconName } from "../calcite-icon/interfaces.js";
@@ -42,7 +42,7 @@ export abstract class SplitButton extends LitElement {
    * Without a value, the browser will suggest a filename/extension.
    *
    * @default false
-   * @see [Global download attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download).
+   * @see [MDN - Global download attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download).
    */
   accessor download: string | boolean;
   /**
@@ -84,21 +84,21 @@ export abstract class SplitButton extends LitElement {
    *
    * @default "bottom-end"
    */
-  accessor placement: MenuPlacement;
+  accessor placement: LogicalPlacement;
   /** Specifies an icon to display at the end of the primary button. */
   accessor primaryIconEnd: IconName;
   /** Displays the `primaryIconStart` and/or `primaryIconEnd` as flipped when the element direction is right-to-left (`"rtl"`). */
   accessor primaryIconFlipRtl: FlipContext;
   /** Specifies an icon to display at the start of the primary button. */
   accessor primaryIconStart: IconName;
-  /** Speficies an accessible name for the primary button. */
+  /** Specifies an accessible name for the primary button. */
   accessor primaryLabel: string;
   /** Specifies the text displayed in the primary button. */
   accessor primaryText: string;
   /**
    * Defines the relationship between the `href` value and the current document.
    *
-   * @mdn [rel](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel)
+   * @see [MDN - rel](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel)
    */
   accessor rel: string;
   /**
@@ -110,7 +110,7 @@ export abstract class SplitButton extends LitElement {
   /**
    * Specifies where to open the linked document defined in the `href` property.
    *
-   * @mdn [target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-target)
+   * @see [MDN - target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-target)
    */
   accessor target: string;
   /**
@@ -119,7 +119,7 @@ export abstract class SplitButton extends LitElement {
    * Only set this if you need complex z-index control or if top layer placement causes conflicts with third-party components.
    *
    * @default false
-   * @mdn [Top Layer](https://developer.mozilla.org/en-US/docs/Glossary/Top_layer)
+   * @see [MDN - Top Layer](https://developer.mozilla.org/en-US/docs/Glossary/Top_layer)
    */
   accessor topLayerDisabled: boolean;
   /**
@@ -132,7 +132,7 @@ export abstract class SplitButton extends LitElement {
    * Sets focus on the component's first focusable element.
    *
    * @param options - When specified an optional object customizes the component's focusing process. When `preventScroll` is `true`, scrolling will not occur on the component.
-   * @mdn [focus(options)](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus#options)
+   * @see [MDN - focus(options)](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus#options)
    */
   setFocus(options?: FocusOptions): Promise<void>;
   /** Fires when the primary button is clicked. */

package/dist/components/calcite-stepper/customElement.d.ts

@@ -7,8 +7,8 @@ import type { StepperLayout } from "./interfaces.js";
 
 /**
  * @cssproperty [--calcite-stepper-bar-gap] - Specifies the space between the component's `calcite-stepper-item`s.
- * @cssproperty [--calcite-stepper-bar-inactive-fill-color] - Specifies the `calcite-stepper-item`s' bar fill color of the component's `calcite-stepper-item`s.
- * @cssproperty [--calcite-stepper-bar-active-fill-color] - Specifies the `calcite-stepper-item`s' bar fill color of the component's active `calcite-stepper-item`s.
+ * @cssproperty [--calcite-stepper-bar-inactive-fill-color] - [Deprecated] in 5.1.0, removal target v6.0.0 - Use `--calcite-stepper-bar-fill-color` instead. Specifies the `calcite-stepper-item`s' bar fill color of the component's `calcite-stepper-item`s.
+ * @cssproperty [--calcite-stepper-bar-active-fill-color] - [Deprecated] in 5.1.0, removal target v6.0.0 - Use `--calcite-stepper-bar-selected-fill-color` instead. Specifies the `calcite-stepper-item`s' bar fill color of the component's active `calcite-stepper-item`s.
  * @cssproperty [--calcite-stepper-bar-complete-fill-color] - When `calcite-stepper-item`s are `complete`, specifies the component's `calcite-stepper-item`s' bar fill color.
  * @cssproperty [--calcite-stepper-bar-error-fill-color] - When `calcite-stepper-item`s contain an `error`, specifies the component's `calcite-stepper-item`s' bar fill color.
  * @slot  - A slot for adding `calcite-stepper-item`s.

package/dist/components/calcite-stepper/customElement.js

@@ -7,7 +7,6 @@ import { f as focusElementInGroup, a as slotChangeGetAssignedElements } from "..
 import { c as createObserver } from "../../chunks/observers.js";
 import { g as guid } from "../../chunks/guid.js";
 import { u as useT9n } from "../../chunks/useT9n.js";
-import { i as isHidden } from "../../chunks/component.js";
 const CSS$1 = {
   actionIcon: "action-icon",
   actionContainer: "action-container",
@@ -44,9 +43,9 @@ class Stepper extends LitElement {
   constructor() {
     super();
     this.containerRef = createRef();
-    this.enabledItems = [];
+    this.visibleItems = [];
+    this.focusableItems = [];
     this.guid = guid();
-    this.itemMap = /* @__PURE__ */ new Map();
     this.items = [];
     this.multipleViewMode = false;
     this.mutationObserver = createObserver("mutation", () => this.updateItems());
@@ -61,7 +60,10 @@ class Stepper extends LitElement {
     });
     this.calciteStepperChange = createEvent({ cancelable: false });
     this.listen("calciteInternalStepperItemKeyEvent", this.calciteInternalStepperItemKeyEvent);
-    this.listen("calciteInternalStepperItemRegister", this.registerItem);
+    this.listen("calciteInternalStepperItemUpdate", (event) => {
+      event.stopPropagation();
+      this.updateItems();
+    });
     this.listen("calciteInternalStepperItemSelect", this.updateItem);
     this.listen("calciteStepperItemSelect", this.handleItemSelect);
   }
@@ -72,7 +74,7 @@ class Stepper extends LitElement {
     this.styles = styles;
   }
   async endStep() {
-    const enabledStepIndex = this.getEnabledStepIndex(this.items.length - 1, "previous");
+    const enabledStepIndex = this.getEnabledStepIndex(this.visibleItems.length - 1, "previous");
     if (typeof enabledStepIndex !== "number") {
       return;
     }
@@ -111,12 +113,8 @@ class Stepper extends LitElement {
     this.updateItems();
   }
   willUpdate(changes) {
-    if (changes.has("icon") && (this.hasUpdated || this.icon !== false) || changes.has("layout") && (this.hasUpdated || this.layout !== "horizontal") || changes.has("numbered") && (this.hasUpdated || this.numbered !== false) || changes.has("scale") && (this.hasUpdated || this.scale !== "m")) {
+    if (changes.has("layout") && (this.hasUpdated || this.layout !== "horizontal") || changes.has("icon") && (this.hasUpdated || this.icon !== false) || changes.has("numbered") && (this.hasUpdated || this.numbered !== false) || changes.has("scale") && (this.hasUpdated || this.scale !== "m") || changes.has("numberingSystem") && (this.hasUpdated || this.numberingSystem !== void 0)) {
       this.updateItems();
-      this.determineActiveStepper();
-    }
-    if (changes.has("numberingSystem")) {
-      this.setStepperItemNumberingSystem();
     }
     if (changes.has("currentActivePosition")) {
       requestAnimationFrame(() => {
@@ -145,28 +143,21 @@ class Stepper extends LitElement {
     switch (item.key) {
       case "ArrowDown":
       case "ArrowRight":
-        focusElementInGroup(this.enabledItems, itemToFocus, "next");
+        focusElementInGroup(this.focusableItems, itemToFocus, "next");
         break;
       case "ArrowUp":
       case "ArrowLeft":
-        focusElementInGroup(this.enabledItems, itemToFocus, "previous");
+        focusElementInGroup(this.focusableItems, itemToFocus, "previous");
         break;
       case "Home":
-        focusElementInGroup(this.enabledItems, itemToFocus, "first");
+        focusElementInGroup(this.focusableItems, itemToFocus, "first");
         break;
       case "End":
-        focusElementInGroup(this.enabledItems, itemToFocus, "last");
+        focusElementInGroup(this.focusableItems, itemToFocus, "last");
         break;
     }
     event.stopPropagation();
   }
-  registerItem(event) {
-    const item = event.target;
-    const { content, position } = event.detail;
-    this.itemMap.set(item, { position, content });
-    this.enabledItems = this.filterItems();
-    event.stopPropagation();
-  }
   updateItem(event) {
     const { position } = event.detail;
     if (typeof position === "number") {
@@ -184,31 +175,35 @@ class Stepper extends LitElement {
     this.calciteStepperChange.emit();
   }
   updateItems() {
-    this.el.querySelectorAll("calcite-stepper-item").forEach((item) => {
+    this.visibleItems = this.items.filter((item) => !item.hidden);
+    this.determineActiveStepper();
+    this.focusableItems = this.visibleItems.filter((item) => !item.disabled && !item.itemHidden);
+    this.items.forEach((item) => {
       item.icon = this.icon;
       item.numbered = this.numbered;
       item.layout = this.layout;
       item.scale = this.scale;
+      item.numberingSystem = this.numberingSystem;
     });
   }
   determineActiveStepper() {
-    const { items } = this;
-    if (items.length < 2) {
+    const { visibleItems } = this;
+    if (visibleItems.length < 2) {
       return;
     }
     const { currentActivePosition, layout } = this;
     this.multipleViewMode = layout !== "horizontal-single";
-    items.forEach((item, index) => {
+    visibleItems.forEach((item, index) => {
       item.itemHidden = layout === "horizontal-single" && index !== (currentActivePosition || 0);
     });
   }
   getEnabledStepIndex(startIndex, direction = "next") {
-    const { items, currentActivePosition } = this;
+    const { visibleItems, currentActivePosition } = this;
     let newIndex = startIndex;
-    while (newIndex >= 0 && newIndex < items.length && items[newIndex]?.disabled) {
+    while (newIndex >= 0 && newIndex < visibleItems.length && visibleItems[newIndex]?.disabled) {
       newIndex = newIndex + (direction === "previous" ? -1 : 1);
     }
-    return newIndex !== currentActivePosition && newIndex < items.length && newIndex >= 0 ? newIndex : null;
+    return newIndex !== currentActivePosition && newIndex < visibleItems.length && newIndex >= 0 ? newIndex : null;
   }
   updateStep(position) {
     this.currentActivePosition = position;
@@ -216,14 +211,6 @@ class Stepper extends LitElement {
       position
     });
   }
-  filterItems() {
-    return this.items.filter((item) => !item.disabled && !isHidden(item));
-  }
-  setStepperItemNumberingSystem() {
-    this.items.forEach((item) => {
-      item.numberingSystem = this.numberingSystem;
-    });
-  }
   handleActionClick(event) {
     const currentActivePosition = this.currentActivePosition;
     const target = event.target;
@@ -232,29 +219,29 @@ class Stepper extends LitElement {
     } else {
       this.nextStep();
     }
-    if (typeof this.currentActivePosition === "number" && currentActivePosition !== this.currentActivePosition && !this.items[this.currentActivePosition].disabled) {
+    if (typeof this.currentActivePosition === "number" && currentActivePosition !== this.currentActivePosition && this.visibleItems[this.currentActivePosition] && !this.visibleItems[this.currentActivePosition].disabled) {
       this.emitItemSelect();
     }
   }
   getFirstEnabledStepperPosition() {
-    const enabledStepIndex = this.items.findIndex((item) => !item.disabled);
+    const enabledStepIndex = this.visibleItems.findIndex((item) => !item.disabled);
     if (enabledStepIndex > -1) {
       return enabledStepIndex;
     }
     return 0;
   }
   handleDefaultSlotChange(event) {
-    const items = slotChangeGetAssignedElements(event).filter((el) => el?.tagName === "CALCITE-STEPPER-ITEM" && !isHidden(el));
+    const items = slotChangeGetAssignedElements(event).filter((el) => el?.tagName === "CALCITE-STEPPER-ITEM");
     this.items = items;
-    const spacing = Array(items.length).fill("1fr").join(" ");
+    this.updateItems();
+    const spacing = Array(this.visibleItems.length).fill("1fr").join(" ");
     this.containerRef.value.style.gridTemplateAreas = spacing;
     this.containerRef.value.style.gridTemplateColumns = spacing;
-    this.setStepperItemNumberingSystem();
   }
   render() {
     this.el.ariaLabel = this.messages.label;
     this.el.role = "region";
-    return html`<div class=${safeClassMap({ container: true, [CSS$1.singleView]: this.layout === "horizontal-single" })} ${ref(this.containerRef)}>${this.layout === "horizontal-single" && html`<div class=${safeClassMap({ [CSS$1.stepBarContainer]: true })}>${this.items.map((item, index) => StepBar({ active: index === this.currentActivePosition, complete: item.complete && index !== this.currentActivePosition && !item.error, disabled: item.disabled && index !== this.currentActivePosition, error: item.error && index !== this.currentActivePosition }))}</div>` || ""}${this.layout === "horizontal-single" && html`<div class=${safeClassMap({ [CSS$1.actionContainer]: true })}>${this.renderAction("start")}${this.renderAction("end")}</div>` || ""}<slot @slotchange=${this.handleDefaultSlotChange}></slot></div>`;
+    return html`<div class=${safeClassMap({ container: true, [CSS$1.singleView]: this.layout === "horizontal-single" })} ${ref(this.containerRef)}>${this.layout === "horizontal-single" && html`<div class=${safeClassMap({ [CSS$1.stepBarContainer]: true })}>${this.visibleItems.map((item, index) => StepBar({ active: index === this.currentActivePosition, complete: item.complete && index !== this.currentActivePosition && !item.error, disabled: item.disabled && index !== this.currentActivePosition, error: item.error && index !== this.currentActivePosition }))}</div>` || ""}${this.layout === "horizontal-single" && html`<div class=${safeClassMap({ [CSS$1.actionContainer]: true })}>${this.renderAction("start")}${this.renderAction("end")}</div>` || ""}<slot @slotchange=${this.handleDefaultSlotChange}></slot></div>`;
   }
   renderAction(position) {
     const isPositionStart = position === "start";

package/dist/components/calcite-stepper-item/customElement.d.ts

@@ -67,7 +67,7 @@ export abstract class StepperItem extends LitElement {
    * Sets focus on the component.
    *
    * @param options - When specified an optional object customizes the component's focusing process. When `preventScroll` is `true`, scrolling will not occur on the component.
-   * @mdn [focus(options)](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus#options)
+   * @see [MDN - focus(options)](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus#options)
    */
   setFocus(options?: FocusOptions): Promise<void>;
   /** Fires when the active `calcite-stepper-item` changes. */

package/dist/components/calcite-stepper-item/customElement.js

@@ -47,7 +47,7 @@ class StepperItem extends LitElement {
     this.calciteInternalStepperItemKeyEvent = createEvent({
       cancelable: false
     });
-    this.calciteInternalStepperItemRegister = createEvent({ cancelable: false });
+    this.calciteInternalStepperItemUpdate = createEvent({ cancelable: false });
     this.calciteInternalStepperItemSelect = createEvent({ cancelable: false });
     this.calciteStepperItemSelect = createEvent({ cancelable: false });
     this.listenOn(document.body, "calciteInternalStepperItemChange", this.updateActiveItemOnChange);
@@ -66,7 +66,6 @@ class StepperItem extends LitElement {
   async load() {
     this.parentStepperEl = this.el.parentElement;
     this.itemPosition = this.getItemPosition();
-    this.registerStepperItem();
     if (this.selected) {
       this.emitRequestedItem();
     }
@@ -76,7 +75,7 @@ class StepperItem extends LitElement {
       this.selectedHandler();
     }
     if (changes.has("disabled") && (this.hasUpdated || this.disabled !== false)) {
-      this.registerStepperItem();
+      this.calciteInternalStepperItemUpdate.emit();
     }
     if (changes.has("messages")) {
       this.effectiveLocaleWatcher(this.messages._lang);
@@ -126,11 +125,6 @@ class StepperItem extends LitElement {
   determineSelectedItem() {
     this.selected = !this.disabled && this.itemPosition === this.selectedPosition;
   }
-  registerStepperItem() {
-    this.calciteInternalStepperItemRegister.emit({
-      position: this.itemPosition
-    });
-  }
   handleItemClick(event) {
     if (this.disabled || isHidden(this.el) || this.layout === "horizontal" && event.composedPath().some((el) => el.classList?.contains("stepper-item-content"))) {
       return;

package/dist/components/calcite-swatch/customElement.d.ts

@@ -10,7 +10,7 @@ export abstract class Swatch extends LitElement {
   /**
    * Specifies the component's color
    *
-   * @see https://developer.mozilla.org/en-US/docs/Web/CSS/color_value
+   * @see [MDN - CSS color value](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value)
    */
   accessor color: string;
   /**

package/dist/components/calcite-switch/customElement.d.ts

@@ -5,11 +5,11 @@ import type { Scale } from "../interfaces.js";
 /**
  * @cssproperty [--calcite-switch-background-color] - Specifies the component's background color.
  * @cssproperty [--calcite-switch-background-color-hover] - Specifies the component's background color when hovered or pressed.
- * @cssproperty [--calcite-switch-border-color] - [Deprecated] No longer necessary. Specifies the component's border color.
+ * @cssproperty [--calcite-switch-border-color] - [Deprecated] in v3.2.0, removal target v6.0.0 - No longer necessary. Specifies the component's border color.
  * @cssproperty [--calcite-switch-corner-radius] - Specifies the component's corner radius.
  * @cssproperty [--calcite-switch-handle-background-color] - Specifies the handle's background color.
- * @cssproperty [--calcite-switch-handle-border-color] - [Deprecated] No longer necessary. Specifies the handle's border color.
- * @cssproperty [--calcite-switch-handle-shadow] - [Deprecated] No longer necessary. Specifies the handle's shadow.
+ * @cssproperty [--calcite-switch-handle-border-color] - [Deprecated] in v3.2.0, removal target v6.0.0 - No longer necessary. Specifies the handle's border color.
+ * @cssproperty [--calcite-switch-handle-shadow] - [Deprecated] in v3.2.0, removal target v6.0.0 - No longer necessary. Specifies the handle's shadow.
  */
 export abstract class Switch extends LitElement {
   /**
@@ -50,7 +50,7 @@ export abstract class Switch extends LitElement {
    * Sets focus on the component.
    *
    * @param options - When specified an optional object customizes the component's focusing process. When `preventScroll` is `true`, scrolling will not occur on the component.
-   * @mdn [focus(options)](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus#options)
+   * @see [MDN - focus(options)](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus#options)
    */
   setFocus(options?: FocusOptions): Promise<void>;
   /** Fires when the `checked` value has changed. */

package/dist/components/calcite-switch/customElement.js

@@ -3,21 +3,24 @@ import { c as customElement } from "../../chunks/runtime.js";
 import { css, html } from "lit";
 import { LitElement, createEvent, safeClassMap } from "@arcgis/lumina";
 import { createRef, ref } from "lit/directives/ref.js";
-import { c as connectForm, d as disconnectForm, H as HiddenFormInputSlot } from "../../chunks/form.js";
 import { i as isActivationKey } from "../../chunks/key.js";
 import { c as connectLabel, d as disconnectLabel, g as getLabelText } from "../../chunks/label.js";
 import { I as InternalLabel } from "../../chunks/InternalLabel.js";
 import { u as useSetFocus } from "../../chunks/useSetFocus.js";
 import { u as useInteractive } from "../../chunks/useInteractive.js";
+import { u as useForm } from "../../chunks/useForm.js";
 const CSS = {
   container: "container",
   track: "track",
   handle: "handle"
 };
-const styles = css`:host([disabled]){cursor:default;-webkit-user-select:none;user-select:none;opacity:var(--calcite-opacity-disabled)}:host([disabled]) *,:host([disabled]) ::slotted(*){pointer-events:none}:host([scale=s]) .container{block-size:.75rem}:host([scale=s]) .track{block-size:.75rem;inline-size:1.5rem}:host([scale=s]) .handle{block-size:.5rem;inline-size:.5rem}:host([scale=m]) .container{block-size:1rem}:host([scale=m]) .track{block-size:1rem;inline-size:2rem}:host([scale=m]) .handle{block-size:.75rem;inline-size:.75rem}:host([scale=l]) .container{block-size:1.5rem}:host([scale=l]) .track{block-size:1.5rem;inline-size:3rem}:host([scale=l]) .handle{block-size:1.25rem;inline-size:1.25rem}:host{position:relative;display:inline-block;inline-size:auto;cursor:pointer;-webkit-user-select:none;user-select:none;vertical-align:middle;tap-highlight-color:transparent}:host([disabled]) ::slotted([calcite-hydrated][disabled]),:host([disabled]) [calcite-hydrated][disabled]{opacity:1}.interaction-container{display:contents}.container{outline-width:0px;display:flex}.track{pointer-events:none;position:relative;box-sizing:border-box;display:inline-block;vertical-align:top;outline-color:transparent;border-radius:var(--calcite-switch-corner-radius, 9999px);border-color:var(--calcite-switch-border-color);background-color:var(--calcite-switch-background-color, var(--calcite-color-border-input))}.container:focus .track{outline:var(--calcite-border-width-md) solid var(--calcite-color-focus, var(--calcite-ui-focus-color, var(--calcite-color-brand)));outline-offset:calc(var(--calcite-spacing-base) * calc(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}.container:hover .track{background-color:var(--calcite-switch-background-color-hover, var(--calcite-color-text-3))}.handle{pointer-events:none;position:absolute;display:block;transition-property:all;transition-duration:var(--calcite-animation-timing);transition-timing-function:cubic-bezier(.4,0,.2,1);inset-block-start:var(--calcite-spacing-base);inset-inline:var(--calcite-spacing-base) auto;background-color:var(--calcite-switch-handle-background-color, var(--calcite-color-foreground-1));border-color:var(--calcite-switch-handle-border-color);border-radius:var(--calcite-switch-corner-radius, 9999px);box-shadow:var(--calcite-switch-handle-shadow)}:host([checked]) .track{background-color:var(--calcite-switch-background-color, var(--calcite-color-brand))}:host([checked]) .handle{inset-inline:auto var(--calcite-spacing-base)}:host([checked]):host(:hover:not([disabled])) .track{background-color:var(--calcite-switch-background-color-hover, var(--calcite-color-brand-hover))}@media(forced-colors:active){:host([checked]) .track{background-color:canvasText}}.internal-label-alignment--center{align-items:center}.internal-label-alignment--end{align-items:end}.internal-label--container{display:flex;justify-content:space-between;color:var(--calcite-color-text-1)}.internal-label-required--indicator{font-weight:var(--calcite-font-weight-medium);color:var(--calcite-color-status-danger);padding-inline:var(--calcite-spacing-base)}.internal-label-required--indicator:hover{cursor:help}.internal-label--text{line-height:1}:host([scale=s]) .internal-label-spacing--bottom{margin-block-end:var(--calcite-spacing-xxs)}:host([scale=s]) .internal-label-spacing-inline--end{margin-inline-end:var(--calcite-spacing-sm)}:host([scale=s]) .internal-label-spacing-inline--start{margin-inline-start:var(--calcite-spacing-sm)}:host([scale=s]) .internal-label--text{font-size:var(--calcite-font-size--2)}:host([scale=m]) .internal-label-spacing--bottom{margin-block-end:var(--calcite-spacing-sm)}:host([scale=m]) .internal-label-spacing-inline--end{margin-inline-end:var(--calcite-spacing-sm)}:host([scale=m]) .internal-label-spacing-inline--start{margin-inline-start:var(--calcite-spacing-sm)}:host([scale=m]) .internal-label--text{font-size:var(--calcite-font-size--1)}:host([scale=l]) .internal-label-spacing--bottom{margin-block-end:var(--calcite-spacing-sm)}:host([scale=l]) .internal-label-spacing-inline--end{margin-inline-end:var(--calcite-spacing-md)}:host([scale=l]) .internal-label-spacing-inline--start{margin-inline-start:var(--calcite-spacing-md)}:host([scale=l]) .internal-label--text{font-size:var(--calcite-font-size-0)}::slotted(input[slot=hidden-form-input]){margin:0!important;opacity:0!important;outline:none!important;padding:0!important;position:absolute!important;inset:0!important;transform:none!important;-webkit-appearance:none!important;z-index:-1!important}:host([hidden]){display:none}[hidden]{display:none}`;
+const styles = css`:host([disabled]){cursor:default;-webkit-user-select:none;user-select:none;opacity:var(--calcite-opacity-disabled)}:host([disabled]) *,:host([disabled]) ::slotted(*){pointer-events:none}:host([scale=s]) .container{block-size:.75rem}:host([scale=s]) .track{block-size:.75rem;inline-size:1.5rem}:host([scale=s]) .handle{block-size:.5rem;inline-size:.5rem}:host([scale=m]) .container{block-size:1rem}:host([scale=m]) .track{block-size:1rem;inline-size:2rem}:host([scale=m]) .handle{block-size:.75rem;inline-size:.75rem}:host([scale=l]) .container{block-size:1.5rem}:host([scale=l]) .track{block-size:1.5rem;inline-size:3rem}:host([scale=l]) .handle{block-size:1.25rem;inline-size:1.25rem}:host{position:relative;display:inline-block;inline-size:auto;cursor:pointer;-webkit-user-select:none;user-select:none;vertical-align:middle;tap-highlight-color:transparent}:host([disabled]) ::slotted([calcite-hydrated][disabled]),:host([disabled]) [calcite-hydrated][disabled]{opacity:1}.interaction-container{display:contents}.container{outline:none;display:flex}.track{pointer-events:none;position:relative;box-sizing:border-box;display:inline-block;vertical-align:top;outline-color:transparent;border-radius:var(--calcite-switch-corner-radius, 9999px);border-color:var(--calcite-switch-border-color);background-color:var(--calcite-switch-background-color, var(--calcite-color-border-input))}.container:focus .track{outline:var(--calcite-border-width-md) solid var(--calcite-color-focus, var(--calcite-ui-focus-color, var(--calcite-color-brand)));outline-offset:calc(var(--calcite-spacing-base) * calc(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}.container:hover .track{background-color:var(--calcite-switch-background-color-hover, var(--calcite-color-text-3))}.handle{pointer-events:none;position:absolute;display:block;transition-property:all;transition-duration:var(--calcite-animation-timing);transition-timing-function:cubic-bezier(.4,0,.2,1);inset-block-start:var(--calcite-spacing-base);inset-inline:var(--calcite-spacing-base) auto;background-color:var(--calcite-switch-handle-background-color, var(--calcite-color-foreground-1));border-color:var(--calcite-switch-handle-border-color);border-radius:var(--calcite-switch-corner-radius, 9999px);box-shadow:var(--calcite-switch-handle-shadow)}:host([checked]) .track{background-color:var(--calcite-switch-background-color, var(--calcite-color-brand))}:host([checked]) .handle{inset-inline:auto var(--calcite-spacing-base)}:host([checked]):host(:hover:not([disabled])) .track{background-color:var(--calcite-switch-background-color-hover, var(--calcite-color-brand-hover))}@media(forced-colors:active){:host([checked]) .track{background-color:canvasText}}.internal-label-alignment--center{align-items:center}.internal-label-alignment--end{align-items:end}.internal-label--container{display:flex;justify-content:space-between;color:var(--calcite-color-text-1)}.internal-label-required--indicator{font-weight:var(--calcite-font-weight-medium);color:var(--calcite-color-status-danger);padding-inline:var(--calcite-spacing-base)}.internal-label-required--indicator:hover{cursor:help}.internal-label--text{line-height:1}:host([scale=s]) .internal-label-spacing--bottom{margin-block-end:var(--calcite-spacing-xxs)}:host([scale=s]) .internal-label-spacing-inline--end{margin-inline-end:var(--calcite-spacing-sm)}:host([scale=s]) .internal-label-spacing-inline--start{margin-inline-start:var(--calcite-spacing-sm)}:host([scale=s]) .internal-label--text{font-size:var(--calcite-font-size--2)}:host([scale=m]) .internal-label-spacing--bottom{margin-block-end:var(--calcite-spacing-sm)}:host([scale=m]) .internal-label-spacing-inline--end{margin-inline-end:var(--calcite-spacing-sm)}:host([scale=m]) .internal-label-spacing-inline--start{margin-inline-start:var(--calcite-spacing-sm)}:host([scale=m]) .internal-label--text{font-size:var(--calcite-font-size--1)}:host([scale=l]) .internal-label-spacing--bottom{margin-block-end:var(--calcite-spacing-sm)}:host([scale=l]) .internal-label-spacing-inline--end{margin-inline-end:var(--calcite-spacing-md)}:host([scale=l]) .internal-label-spacing-inline--start{margin-inline-start:var(--calcite-spacing-md)}:host([scale=l]) .internal-label--text{font-size:var(--calcite-font-size-0)}::slotted(input[slot=hidden-form-input]){margin:0!important;opacity:0!important;outline:none!important;padding:0!important;position:absolute!important;inset:0!important;transform:none!important;-webkit-appearance:none!important;z-index:-1!important}:host([hidden]){display:none}[hidden]{display:none}`;
 class Switch extends LitElement {
   constructor() {
     super();
+    this.formSupport = useForm({
+      inputType: "checkbox"
+    })(this);
     this.switchRef = createRef();
     this.focusSetter = useSetFocus()(this);
     this.interactiveContainer = useInteractive(this);
@@ -31,6 +34,9 @@ class Switch extends LitElement {
   static {
     this.properties = { checked: [7, {}, { reflect: true, type: Boolean }], disabled: [7, {}, { reflect: true, type: Boolean }], form: [3, {}, { reflect: true }], label: 1, labelTextEnd: 1, labelTextStart: 1, name: [3, {}, { reflect: true }], scale: [3, {}, { reflect: true }], value: 1 };
   }
+  static {
+    this.formAssociated = true;
+  }
   static {
     this.styles = styles;
   }
@@ -40,15 +46,10 @@ class Switch extends LitElement {
   connectedCallback() {
     super.connectedCallback();
     connectLabel(this);
-    connectForm(this);
   }
   disconnectedCallback() {
     super.disconnectedCallback();
     disconnectLabel(this);
-    disconnectForm(this);
-  }
-  syncHiddenFormInput(input) {
-    input.type = "checkbox";
   }
   keyDownHandler(event) {
     if (!this.disabled && isActivationKey(event.key)) {
@@ -73,7 +74,7 @@ class Switch extends LitElement {
     this.toggle();
   }
   render() {
-    return this.interactiveContainer({ disabled: this.disabled, children: html`<div .ariaChecked=${this.checked} .ariaLabel=${getLabelText(this)} class=${safeClassMap(CSS.container)} role=switch tabindex=0 ${ref(this.switchRef)}>${this.labelTextStart && InternalLabel({ alignmentCenter: true, bottomSpacingDisabled: true, labelText: this.labelTextStart, spacingInlineEnd: true }) || ""}<div class=${safeClassMap(CSS.track)}><div class=${safeClassMap(CSS.handle)}></div></div>${this.labelTextEnd && InternalLabel({ alignmentCenter: true, bottomSpacingDisabled: true, labelText: this.labelTextEnd, spacingInlineStart: true }) || ""}${HiddenFormInputSlot({ component: this })}</div>` });
+    return this.interactiveContainer({ disabled: this.disabled, children: html`<div .ariaChecked=${this.checked} .ariaLabel=${getLabelText(this)} class=${safeClassMap(CSS.container)} role=switch tabindex=0 ${ref(this.switchRef)}>${this.labelTextStart && InternalLabel({ alignmentCenter: true, bottomSpacingDisabled: true, labelText: this.labelTextStart, spacingInlineEnd: true }) || ""}<div class=${safeClassMap(CSS.track)}><div class=${safeClassMap(CSS.handle)}></div></div>${this.labelTextEnd && InternalLabel({ alignmentCenter: true, bottomSpacingDisabled: true, labelText: this.labelTextEnd, spacingInlineStart: true }) || ""}</div>` });
   }
 }
 customElement("calcite-switch", Switch);

package/dist/components/calcite-tab/customElement.d.ts

@@ -3,7 +3,7 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 
 /**
  * @cssproperty [--calcite-tab-content-space-y] - Specifies the vertical space between the component's content in the `default` slot.
- * @cssproperty [--calcite-tab-content-block-padding] - [Deprecated] Use `--calcite-tab-content-space-y` instead. Specifies the block padding of the component's content in the `default` slot.
+ * @cssproperty [--calcite-tab-content-block-padding] - [Deprecated] in v3.2.0, removal target v6.0.0 - Use `--calcite-tab-content-space-y` instead. Specifies the block padding of the component's content in the `default` slot.
  * @slot  - A slot for adding custom content.
  */
 export abstract class Tab extends LitElement {

package/dist/components/calcite-tab/customElement.js

@@ -12,7 +12,7 @@ const CSS = {
 const IDS = {
   tabTitleId: (id) => `calcite-tab-title-${id}`
 };
-const styles = css`:host{display:none}:host,.container,.content{block-size:100%;inline-size:100%}:host([selected]),:host([selected]) .container{display:flex;flex-direction:column}.content{box-sizing:border-box;padding-block:var(--calcite-tab-content-space-y, var(--calcite-tab-content-block-padding, var(--calcite-internal-tab-content-space-y)))}.scale-s{--calcite-internal-tab-content-space-y: .25rem;font-size:var(--calcite-font-size-sm);line-height:1rem}.scale-m{--calcite-internal-tab-content-space-y: .5rem;font-size:var(--calcite-font-size);line-height:1rem}.scale-l{--calcite-internal-tab-content-space-y: .625rem;font-size:var(--calcite-font-size-md);line-height:1.25rem}.container{display:none;block-size:100%;inline-size:100%;overflow:auto;outline-color:transparent}.container:focus{outline:var(--calcite-border-width-md) solid var(--calcite-color-focus, var(--calcite-ui-focus-color, var(--calcite-color-brand)));outline-offset:calc(calc(-1 * var(--calcite-spacing-base)) * calc(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}:host([hidden]){display:none}[hidden]{display:none}`;
+const styles = css`:host{display:none}:host,.container,.content{block-size:100%;inline-size:100%}:host([selected]),:host([selected]) .container{display:flex;flex-direction:column}.content{box-sizing:border-box;padding-block:var(--calcite-tab-content-space-y, var(--calcite-tab-content-block-padding, var(--calcite-internal-tab-content-space-y)))}.scale-s{--calcite-internal-tab-content-space-y: .25rem;font-size:var(--calcite-font-size-sm);line-height:1rem}.scale-m{--calcite-internal-tab-content-space-y: .5rem;font-size:var(--calcite-font-size);line-height:1rem}.scale-l{--calcite-internal-tab-content-space-y: var(--calcite-space-sm-plus);font-size:var(--calcite-font-size-md);line-height:1.25rem}.container{display:none;block-size:100%;inline-size:100%;overflow:auto;outline-color:transparent}.container:focus{outline:var(--calcite-border-width-md) solid var(--calcite-color-focus, var(--calcite-ui-focus-color, var(--calcite-color-brand)));outline-offset:calc(calc(-1 * var(--calcite-spacing-base)) * calc(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}:host([hidden]){display:none}[hidden]{display:none}`;
 class Tab extends LitElement {
   constructor() {
     super();

package/dist/components/calcite-tab-nav/customElement.js

@@ -6,7 +6,7 @@ import { a as calciteSize24, b as calciteSize32, d as calciteSize44 } from "../.
 import { css, html } from "lit";
 import { LitElement, createEvent, safeClassMap } from "@arcgis/lumina";
 import { useDirection } from "@arcgis/lumina/controllers";
-import { z as filterDirectChildren, f as focusElementInGroup, i as focusElement } from "../../chunks/dom.js";
+import { C as filterDirectChildren, f as focusElementInGroup, i as focusElement } from "../../chunks/dom.js";
 import { c as createObserver } from "../../chunks/observers.js";
 import { u as useT9n } from "../../chunks/useT9n.js";
 const ICON = {