@esri/calcite-components 5.2.0-next.1 → 5.2.0-next.100

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

@@ -3,14 +3,22 @@ import { c as customElement } from "../../chunks/runtime.js";
 import { keyed } from "lit/directives/keyed.js";
 import { css, html } from "lit";
 import { LitElement, safeClassMap } from "@arcgis/lumina";
-import { s as slotChangeHasAssignedElement, a as slotChangeGetAssignedElements } from "../../chunks/dom.js";
-const styles = css`:host{box-sizing:border-box;background-color:var(--calcite-color-foreground-1);color:var(--calcite-color-text-2);font-size:var(--calcite-font-size--1)}:host *{box-sizing:border-box}:host{position:absolute;inset:0;display:flex;block-size:100%;inline-size:100%;flex-direction:column;overflow:hidden}.main{position:relative;display:flex;block-size:100%;inline-size:100%;flex:1 1 auto;flex-direction:row;justify-content:space-between;overflow:hidden}.content{display:flex;block-size:100%;inline-size:100%;flex-direction:column;flex-wrap:nowrap;overflow:auto;justify-content:space-between}.content ::slotted(calcite-panel),.content ::slotted(calcite-flow){flex:1 1 auto;align-self:stretch;max-block-size:unset}.content--behind{position:absolute;inset:0;border-width:0px;z-index:calc(var(--calcite-z-index) - 1);display:initial}.content--non-interactive{pointer-events:none;display:flex;block-size:100%;inline-size:100%;flex-direction:column;flex-wrap:nowrap}::slotted(calcite-shell-panel){inline-size:unset}::slotted(.header .heading){font-size:var(--calcite-font-size-relative-sm);line-height:var(--calcite-font-line-height-relative-snug);font-weight:var(--calcite-font-weight-normal)}slot[name=panel-start]::slotted(calcite-shell-panel),slot[name=panel-end]::slotted(calcite-shell-panel){position:relative;z-index:calc(var(--calcite-z-index) + 1)}slot[name=panel-end]::slotted(calcite-shell-panel){margin-inline-start:auto}::slotted(calcite-panel),::slotted(calcite-flow){border-width:var(--calcite-border-width-sm);border-color:var(--calcite-shell-border-color, var(--calcite-color-border-3));border-inline-start-width:var(--calcite-border-width-none);border-inline-end-width:var(--calcite-border-width-none);border-style:solid}slot[name=panel-top]::slotted(calcite-shell-panel:not([display-mode^=float])),slot[name=panel-bottom]::slotted(calcite-shell-panel:not([display-mode^=float])){border-color:var(--calcite-shell-border-color, var(--calcite-color-border-3));border-inline-start-width:var(--calcite-border-width-sm);border-inline-end-width:var(--calcite-border-width-sm)}.center-content{display:flex;flex-direction:column;justify-content:space-between;block-size:100%;inline-size:100%;min-inline-size:0}.content-bottom{justify-content:flex-end}::slotted(calcite-shell-panel){flex:none;align-self:stretch}::slotted(calcite-tip-manager){position:absolute;z-index:var(--calcite-z-index-toast);box-sizing:border-box}@keyframes in-up{0%{opacity:0;transform:translate3D(0,5px,0)}to{opacity:1;transform:translateZ(0)}}::slotted(calcite-tip-manager){animation:in-up var(--calcite-internal-animation-timing-slow) ease-in-out;border-radius:.25rem;--tw-shadow: 0 6px 20px -4px rgba(0, 0, 0, .1), 0 4px 12px -2px rgba(0, 0, 0, .08);--tw-shadow-colored: 0 6px 20px -4px var(--tw-shadow-color), 0 4px 12px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow);inset-block-end:.5rem;inset-inline:var(--calcite-shell-tip-spacing, 26vw)}slot[name=panel-bottom]::slotted(calcite-shell-panel){margin-block-start:auto}slot[name=panel-top]::slotted(calcite-shell-panel){margin-block-end:auto}.position-wrapper{position:absolute;pointer-events:none;inset:0}:host([hidden]){display:none}[hidden]{display:none}`;
+import { createRef, ref } from "lit/directives/ref.js";
+import { s as slotChangeHasAssignedElement, b as slotChangeGetAssignedElements, l as getStylePixelValue } from "../../chunks/dom.js";
+import { i as isAlert } from "../../chunks/resources13.js";
+import { b as isDialog } from "../../chunks/resources15.js";
+import { i as isSheet } from "../../chunks/resources24.js";
+import { i as isShellPanel } from "../../chunks/resources25.js";
+const styles = css`:host{box-sizing:border-box;background-color:var(--calcite-theme-color-surface-2, var(--calcite-color-foreground-1));color:var(--calcite-color-text-2);font-size:var(--calcite-font-size--1)}:host *{box-sizing:border-box}:host{position:absolute;inset:0;display:flex;block-size:100%;inline-size:100%;flex-direction:column;overflow:hidden;border-radius:var(--calcite-shell-corner-radius);box-shadow:var(--calcite-shell-shadow)}.main{position:relative;display:flex;block-size:100%;inline-size:100%;flex:1 1 auto;flex-direction:row;justify-content:space-between;overflow:hidden}.content{display:flex;block-size:100%;inline-size:100%;flex-direction:column;flex-wrap:nowrap;overflow:auto;justify-content:space-between}.content ::slotted(calcite-panel),.content ::slotted(calcite-flow){flex:1 1 auto;align-self:stretch;max-block-size:unset}.content--behind{position:absolute;inset:0;border-width:0px;z-index:calc(var(--calcite-z-index) - 1);display:initial}.content--non-interactive{pointer-events:none;display:flex;block-size:100%;inline-size:100%;flex-direction:column;flex-wrap:nowrap}::slotted(calcite-shell-panel){inline-size:unset}::slotted(.header .heading){font-size:var(--calcite-font-size-relative-sm);line-height:var(--calcite-font-line-height-relative-snug);font-weight:var(--calcite-font-weight-normal)}slot[name=panel-start]::slotted(calcite-shell-panel),slot[name=panel-end]::slotted(calcite-shell-panel){position:relative;z-index:calc(var(--calcite-z-index) + 1)}slot[name=panel-end]::slotted(calcite-shell-panel){margin-inline-start:auto}::slotted(calcite-panel),::slotted(calcite-flow){border-width:var(--calcite-border-width-sm);border-color:var(--calcite-shell-border-color, var(--calcite-color-border-3));border-inline-start-width:var(--calcite-border-width-none);border-inline-end-width:var(--calcite-border-width-none);border-style:solid}slot[name=panel-top]::slotted(calcite-shell-panel:not([display-mode^=float])),slot[name=panel-bottom]::slotted(calcite-shell-panel:not([display-mode^=float])){border-color:var(--calcite-shell-border-color, var(--calcite-color-border-3));border-inline-start-width:var(--calcite-border-width-sm);border-inline-end-width:var(--calcite-border-width-sm)}.center-content{display:flex;flex-direction:column;justify-content:space-between;block-size:100%;inline-size:100%;min-inline-size:0}.content-bottom{justify-content:flex-end}::slotted(calcite-shell-panel){flex:none;align-self:stretch}::slotted(calcite-tip-manager){position:absolute;z-index:var(--calcite-z-index-toast);box-sizing:border-box}@keyframes in-up{0%{opacity:0;transform:translate3D(0,5px,0)}to{opacity:1;transform:translateZ(0)}}::slotted(calcite-tip-manager){animation:in-up var(--calcite-internal-animation-timing-slow) ease-in-out;border-radius:.25rem;--tw-shadow: 0 6px 20px -4px rgba(0, 0, 0, .1), 0 4px 12px -2px rgba(0, 0, 0, .08);--tw-shadow-colored: 0 6px 20px -4px var(--tw-shadow-color), 0 4px 12px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow);inset-block-end:.5rem;inset-inline:var(--calcite-shell-tip-spacing, 26vw)}slot[name=panel-bottom]::slotted(calcite-shell-panel){margin-block-start:auto}slot[name=panel-top]::slotted(calcite-shell-panel){margin-block-end:auto}.position-wrapper{position:absolute;pointer-events:none;inset:0}.main.has-resizable-panel-top ::slotted(calcite-panel){border-block-start:none}.main.has-resizable-panel-bottom ::slotted(calcite-panel){border-block-end:none}.main.has-action-bar-position-panel ::slotted(calcite-panel){border:0}:host([hidden]){display:none}[hidden]{display:none}`;
 const CSS = {
   main: "main",
   content: "content",
   contentBehind: "content--behind",
   contentBottom: "content-bottom",
   contentNonInteractive: "content--non-interactive",
+  hasActionBarPositionPanel: "has-action-bar-position-panel",
+  hasResizablePanelBottom: "has-resizable-panel-bottom",
+  hasResizablePanelTop: "has-resizable-panel-top",
   footer: "footer",
   positionedSlotWrapper: "positioned-slot-wrapper",
   contentBehindCenterContent: "center-content"
@@ -24,28 +32,43 @@ const SLOTS = {
   footer: "footer",
   alerts: "alerts",
   sheets: "sheets",
-  modals: "modals",
   dialogs: "dialogs"
 };
+const panelSlots = ["panel-start", "panel-end", "panel-top", "panel-bottom"];
 class Shell extends LitElement {
   constructor() {
     super();
+    this.defaultSlotRef = createRef();
+    this.panelBottomSlotRef = createRef();
+    this.panelEndSlotRef = createRef();
+    this.panelStartSlotRef = createRef();
+    this.panelTopSlotRef = createRef();
+    this.panelSlotState = {
+      "panel-start": { elements: [], resizable: false },
+      "panel-end": { elements: [], resizable: false },
+      "panel-top": { elements: [], resizable: false },
+      "panel-bottom": { elements: [], resizable: false }
+    };
     this.hasAlerts = false;
     this.hasDialogs = false;
     this.hasFooter = false;
     this.hasHeader = false;
-    this.hasModals = false;
+    this.hasActionBarPositionPanel = false;
     this.hasOnlyPanelBottom = false;
     this.hasPanelBottom = false;
     this.hasPanelTop = false;
+    this.hasResizablePanelBottom = false;
+    this.hasResizablePanelTop = false;
     this.hasSheets = false;
     this.panelIsResizing = false;
     this.contentBehind = false;
     this.listen("calciteInternalShellPanelResizeStart", this.handleCalciteInternalShellPanelResizeStart);
     this.listen("calciteInternalShellPanelResizeEnd", this.handleCalciteInternalShellPanelResizeEnd);
+    this.listen("calciteInternalShellPanelResizableChange", this.handleCalciteInternalShellPanelResizableChange);
+    this.listen("calciteInternalShellPanelActionBarPositionChange", this.handleCalciteInternalShellPanelActionBarPositionChange);
   }
   static {
-    this.properties = { hasAlerts: [16, {}, { state: true }], hasDialogs: [16, {}, { state: true }], hasFooter: [16, {}, { state: true }], hasHeader: [16, {}, { state: true }], hasModals: [16, {}, { state: true }], hasOnlyPanelBottom: [16, {}, { state: true }], hasPanelBottom: [16, {}, { state: true }], hasPanelTop: [16, {}, { state: true }], hasSheets: [16, {}, { state: true }], panelIsResizing: [16, {}, { state: true }], contentBehind: [7, {}, { reflect: true, type: Boolean }] };
+    this.properties = { hasAlerts: [16, {}, { state: true }], hasDialogs: [16, {}, { state: true }], hasFooter: [16, {}, { state: true }], hasHeader: [16, {}, { state: true }], hasActionBarPositionPanel: [16, {}, { state: true }], hasOnlyPanelBottom: [16, {}, { state: true }], hasPanelBottom: [16, {}, { state: true }], hasPanelTop: [16, {}, { state: true }], hasResizablePanelBottom: [16, {}, { state: true }], hasResizablePanelTop: [16, {}, { state: true }], hasSheets: [16, {}, { state: true }], panelIsResizing: [16, {}, { state: true }], contentBehind: [7, {}, { reflect: true, type: Boolean }] };
   }
   static {
     this.styles = styles;
@@ -55,6 +78,20 @@ class Shell extends LitElement {
       this.hasOnlyPanelBottom = !this.hasPanelTop && this.hasPanelBottom;
     }
   }
+  handleCalciteInternalShellPanelResizableChange(event) {
+    const panel = event.composedPath().find(isShellPanel);
+    if (panel?.slot && panelSlots.includes(panel.slot)) {
+      this.updateResizableSlotState(panel.slot);
+    }
+    event.stopPropagation();
+  }
+  handleCalciteInternalShellPanelActionBarPositionChange(event) {
+    const panel = event.composedPath().find(isShellPanel);
+    if (panel?.slot && panelSlots.includes(panel.slot)) {
+      this.updateResizableSlotState(panel.slot);
+    }
+    event.stopPropagation();
+  }
   handleCalciteInternalShellPanelResizeStart(event) {
     this.panelIsResizing = true;
     event.stopPropagation();
@@ -71,54 +108,135 @@ class Shell extends LitElement {
   }
   handleAlertsSlotChange(event) {
     this.hasAlerts = !!slotChangeHasAssignedElement(event);
-    slotChangeGetAssignedElements(event).filter((el) => el?.matches("calcite-alert")).forEach((el) => {
+    slotChangeGetAssignedElements(event).filter(isAlert).forEach((el) => {
       el.embedded = true;
     });
   }
   handleSheetsSlotChange(event) {
     this.hasSheets = !!slotChangeHasAssignedElement(event);
-    slotChangeGetAssignedElements(event).filter((el) => el?.matches("calcite-sheet")).forEach((el) => {
+    slotChangeGetAssignedElements(event).filter(isSheet).forEach((el) => {
       el.embedded = true;
     });
   }
-  handleModalsSlotChange(event) {
-    this.hasModals = !!slotChangeHasAssignedElement(event);
-    slotChangeGetAssignedElements(event)?.filter((el) => el?.matches("calcite-modal")).forEach((el) => {
-      el.embedded = true;
+  configurePanels(panels, layout, position) {
+    panels.forEach((panel) => {
+      const sizingPanel = panel;
+      panel.layout = layout;
+      panel.position = position;
+      sizingPanel.shellSizingDataProvider = (axis) => this.getShellPanelSizingData(panel, axis);
     });
   }
+  getDefaultSlotMinSize(axis) {
+    return this.defaultSlotRef.value?.assignedElements({ flatten: true }).reduce((total, element) => {
+      const computedStyle = window.getComputedStyle(element);
+      return axis === "inline" ? total + getStylePixelValue(computedStyle.borderInlineStartWidth) + getStylePixelValue(computedStyle.borderInlineEndWidth) : total + getStylePixelValue(computedStyle.borderBlockStartWidth) + getStylePixelValue(computedStyle.borderBlockEndWidth);
+    }, 0) ?? 0;
+  }
+  getDefaultSlotBounds() {
+    const defaultSlotElements = this.defaultSlotRef.value?.assignedElements({ flatten: true }) ?? [];
+    if (!defaultSlotElements.length) {
+      return null;
+    }
+    return defaultSlotElements.reduce((bounds, element) => {
+      const rect = element.getBoundingClientRect();
+      return bounds ? {
+        bottom: Math.max(bounds.bottom, rect.bottom),
+        left: Math.min(bounds.left, rect.left),
+        right: Math.max(bounds.right, rect.right),
+        top: Math.min(bounds.top, rect.top)
+      } : {
+        bottom: rect.bottom,
+        left: rect.left,
+        right: rect.right,
+        top: rect.top
+      };
+    }, null);
+  }
+  getShellPanelSizingData(panel, axis) {
+    const panelLayoutContainer = panel.assignedSlot?.parentElement;
+    if (!panelLayoutContainer) {
+      return null;
+    }
+    const containerRect = panelLayoutContainer.getBoundingClientRect();
+    const defaultSlotRect = this.getDefaultSlotBounds();
+    if (!defaultSlotRect) {
+      return {
+        availableSize: axis === "inline" ? containerRect.width : containerRect.height
+      };
+    }
+    const defaultSlotMinSize = this.getDefaultSlotMinSize(axis);
+    const isRTL = window.getComputedStyle(this).direction === "rtl";
+    let availableOccupiedSize;
+    if (axis === "inline") {
+      const isStart = panel.position === "start";
+      availableOccupiedSize = isRTL ? isStart ? containerRect.right - defaultSlotRect.left : defaultSlotRect.right - containerRect.left : isStart ? defaultSlotRect.right - containerRect.left : containerRect.right - defaultSlotRect.left;
+    } else {
+      availableOccupiedSize = panel.position === "start" ? defaultSlotRect.bottom - containerRect.top : containerRect.bottom - defaultSlotRect.top;
+    }
+    const availableSize = Math.max(Math.floor(availableOccupiedSize) - Math.ceil(defaultSlotMinSize), 0);
+    return {
+      availableSize
+    };
+  }
   handlePanelTopChange(event) {
+    const panelElements = slotChangeGetAssignedElements(event).filter(isShellPanel);
     this.hasPanelTop = slotChangeHasAssignedElement(event);
-    slotChangeGetAssignedElements(event).filter((el) => el?.matches("calcite-shell-panel")).forEach((el) => {
+    this.configurePanels(panelElements, "horizontal", "start");
+    panelElements.forEach((el) => {
       el.layout = "horizontal";
       el.position = "start";
     });
+    this.updateResizableSlotState("panel-top", panelElements);
   }
   handlePanelBottomChange(event) {
+    const panelElements = slotChangeGetAssignedElements(event).filter(isShellPanel);
     this.hasPanelBottom = slotChangeHasAssignedElement(event);
-    slotChangeGetAssignedElements(event).filter((el) => el?.matches("calcite-shell-panel")).forEach((el) => {
+    this.configurePanels(panelElements, "horizontal", "end");
+    panelElements.forEach((el) => {
       el.layout = "horizontal";
       el.position = "end";
     });
+    this.updateResizableSlotState("panel-bottom", panelElements);
   }
   handlePanelStartChange(event) {
-    slotChangeGetAssignedElements(event).filter((el) => el?.matches("calcite-shell-panel")).forEach((el) => {
+    const panelElements = slotChangeGetAssignedElements(event).filter(isShellPanel);
+    this.configurePanels(panelElements, "vertical", "start");
+    panelElements.forEach((el) => {
       el.layout = "vertical";
       el.position = "start";
     });
+    this.updateResizableSlotState("panel-start", panelElements);
   }
   handlePanelEndChange(event) {
-    slotChangeGetAssignedElements(event).filter((el) => el?.matches("calcite-shell-panel")).forEach((el) => {
+    const panelElements = slotChangeGetAssignedElements(event).filter(isShellPanel);
+    this.configurePanels(panelElements, "vertical", "end");
+    panelElements.forEach((el) => {
       el.layout = "vertical";
       el.position = "end";
     });
+    this.updateResizableSlotState("panel-end", panelElements);
   }
   handleDialogsSlotChange(event) {
     this.hasDialogs = !!slotChangeHasAssignedElement(event);
-    slotChangeGetAssignedElements(event).filter((el) => el?.matches("calcite-dialog")).forEach((el) => {
+    slotChangeGetAssignedElements(event).filter(isDialog).forEach((el) => {
       el.embedded = true;
     });
   }
+  updateResizableSlotState(slot, panelElements = this.panelSlotState[slot].elements) {
+    this.panelSlotState[slot] = {
+      elements: panelElements,
+      resizable: panelElements.some((panel) => panel.resizable)
+    };
+    this.syncResizableState();
+    this.syncActionBarPositionPanelState();
+  }
+  syncActionBarPositionPanelState() {
+    this.hasActionBarPositionPanel = panelSlots.some((slot) => this.panelSlotState[slot].elements.some((panel) => !!panel.actionBarPosition));
+  }
+  syncResizableState() {
+    this.hasResizablePanelBottom = this.panelSlotState["panel-bottom"].resizable;
+    this.hasResizablePanelTop = this.panelSlotState["panel-top"].resizable;
+  }
   renderHeader() {
     return html`<div .hidden=${!this.hasHeader}>${keyed("header", html`<slot name=${SLOTS.header} @slotchange=${this.handleHeaderSlotChange}></slot>`)}</div>`;
   }
@@ -131,18 +249,15 @@ class Shell extends LitElement {
   renderSheets() {
     return html`<div .hidden=${!this.hasSheets}>${keyed("sheets", html`<slot name=${SLOTS.sheets} @slotchange=${this.handleSheetsSlotChange}></slot>`)}</div>`;
   }
-  renderModals() {
-    return html`<div .hidden=${!this.hasModals}>${keyed("modals", html`<slot name=${SLOTS.modals} @slotchange=${this.handleModalsSlotChange}></slot>`)}</div>`;
-  }
   renderDialogs() {
     return html`<div .hidden=${!this.hasDialogs}>${keyed("dialogs", html`<slot name=${SLOTS.dialogs} @slotchange=${this.handleDialogsSlotChange}></slot>`)}</div>`;
   }
   renderContent() {
     const { panelIsResizing } = this;
-    const defaultSlotNode = keyed("default-slot", html`<slot></slot>`);
+    const defaultSlotNode = keyed("default-slot", html`<slot ${ref(this.defaultSlotRef)}></slot>`);
     const defaultSlotContainerNode = panelIsResizing ? html`<div class=${safeClassMap(CSS.contentNonInteractive)}>${defaultSlotNode}</div>` : defaultSlotNode;
-    const panelBottomSlotNode = keyed("panel-bottom-slot", html`<slot name=${SLOTS.panelBottom} @slotchange=${this.handlePanelBottomChange}></slot>`);
-    const panelTopSlotNode = keyed("panel-top-slot", html`<slot name=${SLOTS.panelTop} @slotchange=${this.handlePanelTopChange}></slot>`);
+    const panelBottomSlotNode = keyed("panel-bottom-slot", html`<slot name=${SLOTS.panelBottom} @slotchange=${this.handlePanelBottomChange} ${ref(this.panelBottomSlotRef)}></slot>`);
+    const panelTopSlotNode = keyed("panel-top-slot", html`<slot name=${SLOTS.panelTop} @slotchange=${this.handlePanelTopChange} ${ref(this.panelTopSlotRef)}></slot>`);
     const contentContainerKey = "content-container";
     const content = this.contentBehind ? [
       keyed(contentContainerKey, html`<div class=${safeClassMap({
@@ -159,10 +274,15 @@ class Shell extends LitElement {
     return content;
   }
   renderMain() {
-    return html`<div class=${safeClassMap(CSS.main)}><slot name=${SLOTS.panelStart} @slotchange=${this.handlePanelStartChange}></slot>${this.renderContent()}<slot name=${SLOTS.panelEnd} @slotchange=${this.handlePanelEndChange}></slot></div>`;
+    return html`<div class=${safeClassMap({
+      [CSS.main]: true,
+      [CSS.hasActionBarPositionPanel]: this.hasActionBarPositionPanel,
+      [CSS.hasResizablePanelBottom]: this.hasResizablePanelBottom,
+      [CSS.hasResizablePanelTop]: this.hasResizablePanelTop
+    })}><slot name=${SLOTS.panelStart} @slotchange=${this.handlePanelStartChange} ${ref(this.panelStartSlotRef)}></slot>${this.renderContent()}<slot name=${SLOTS.panelEnd} @slotchange=${this.handlePanelEndChange} ${ref(this.panelEndSlotRef)}></slot></div>`;
   }
   renderPositionedSlots() {
-    return html`<div class=${safeClassMap(CSS.positionedSlotWrapper)}>${this.renderAlerts()}${this.renderModals()}${this.renderDialogs()}${this.renderSheets()}</div>`;
+    return html`<div class=${safeClassMap(CSS.positionedSlotWrapper)}>${this.renderAlerts()}${this.renderDialogs()}${this.renderSheets()}</div>`;
   }
   render() {
     return html`${this.renderHeader()}${this.renderMain()}${this.renderFooter()}${this.renderPositionedSlots()}`;

package/dist/components/calcite-shell-panel/customElement.d.ts

@@ -1,25 +1,44 @@
 /// <reference path="../../index.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { Height, Layout, Position, Scale, Width } from "../interfaces.js";
-import type { DisplayMode } from "./interfaces.js";
+import type { Height, Layout, Position, Scale, Width } from "../types.js";
+import type { DisplayMode } from "./types.js";
+
+declare module "@arcgis/lumina" {
+export interface DeclareCssProperties {
+  /** Specifies the component's background color. */
+  "--calcite-shell-panel-background-color": "*";
+  /** When `displayMode` is `"float-all"`, specifies the component's border color. */
+  "--calcite-shell-panel-border-color": "*";
+  /** When `displayMode` is `"float-all"`, specifies the component's corner radius. */
+  "--calcite-shell-panel-corner-radius": "*";
+  /** When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float` or `float-all`, specifies the component's height. */
+  "--calcite-shell-panel-height": "*";
+  /** When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the component's maximum height. */
+  "--calcite-shell-panel-max-height": "*";
+  /** When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the component's minimum height. */
+  "--calcite-shell-panel-min-height": "*";
+  /** Specifies the component's maximum width. */
+  "--calcite-shell-panel-max-width": "*";
+  /** Specifies the resize handle's text color. */
+  "--calcite-shell-panel-resize-icon-color": "*";
+  /** When `displayMode` is `float-all`, `float-content`, or `overlay`, specifies the component's shadow. */
+  "--calcite-shell-panel-shadow": "*";
+  /** Specifies the component's text color. */
+  "--calcite-shell-panel-text-color": "*";
+  /** Specifies the component's width. */
+  "--calcite-shell-panel-width": "*";
+  /** Specifies the component's z-index value. */
+  "--calcite-shell-panel-z-index": "*";
+}
+}
 
 /**
- * @cssproperty [--calcite-shell-panel-background-color] - Specifies the component's background color.
- * @cssproperty [--calcite-shell-panel-border-color] - When `displayMode` is `"float-all"`, specifies the component's border color.
- * @cssproperty [--calcite-shell-panel-corner-radius] - When `displayMode` is `"float-all"`, specifies the component's corner radius.
- * @cssproperty [--calcite-shell-panel-height] - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float` or `float-all`, specifies the component's height.
- * @cssproperty [--calcite-shell-panel-max-height] - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the component's maximum height.
- * @cssproperty [--calcite-shell-panel-min-height] - When `layout` is `horizontal`, or `layout` is `vertical` and `displayMode` is `float-content` or `float`, specifies the component's minimum height.
- * @cssproperty [--calcite-shell-panel-max-width] - Specifies the component's maximum width.
- * @cssproperty [--calcite-shell-panel-resize-icon-color] - Specifies the resize handle's text color.
- * @cssproperty [--calcite-shell-panel-shadow] - When `displayMode` is `float-all`, `float-content`, or `overlay`, specifies the component's shadow.
- * @cssproperty [--calcite-shell-panel-text-color] - Specifies the component's text color.
- * @cssproperty [--calcite-shell-panel-width] - Specifies the component's width.
- * @cssproperty [--calcite-shell-panel-z-index] - Specifies the component's z-index value.
  * @slot  - A slot for adding custom content.
  * @slot [action-bar] - A slot for adding a `calcite-action-bar` to the component.
  */
 export abstract class ShellPanel extends LitElement {
+  /** Specifies the placement of the `calcite-action-bar` (when slotted). */
+  accessor actionBarPosition: Position | undefined;
   /**
    * When `true`, hides the component's content area.
    *
@@ -27,29 +46,25 @@ export abstract class ShellPanel extends LitElement {
    */
   accessor collapsed: boolean;
   /**
-   * Specifies the component's display mode, where:
-   *
-   * `"dock"` displays at full height adjacent to center content,
-   *
-   * `"overlay"` displays at full height on top of center content, and
-   *
-   * `"float"` [Deprecated] does not display at full height with content separately detached from `calcite-action-bar` on top of center content.
-   *
-   * `"float-content"` does not display at full height with content separately detached from `calcite-action-bar` on top of center content.
+   * Specifies the component's display mode.
    *
-   * `"float-all"` detaches the `calcite-panel` and `calcite-action-bar` on top of center content.
+   * - `"dock"` displays at full height adjacent to center content.
+   * - `"overlay"` displays at full height on top of center content.
+   * - `"float-content"` does not display at full height with content separately detached from `calcite-action-bar` on top of center content.
+   * - `"float-all"` detaches the `calcite-panel` and `calcite-action-bar` on top of center content.
+   * - `"float"` does not display at full height with content separately detached from `calcite-action-bar` on top of center content. [Deprecated] in v2.11.0, removal target v6.0.0 - use `"float-content"` instead.
    *
    * @default "dock"
    */
   accessor displayMode: DisplayMode;
   /** Specifies the component's height. */
-  accessor height: Height;
+  accessor height: Height | undefined;
   /**
    * When `layout` is `horizontal`, specifies the component's maximum height.
    *
    * @deprecated in v3.0.0, removal target v6.0.0 - Use the `height` property instead.
    */
-  accessor heightScale: Scale;
+  accessor heightScale: Scale | undefined;
   /**
    * Specifies the component's direction.
    *
@@ -57,8 +72,12 @@ export abstract class ShellPanel extends LitElement {
    * @default "vertical"
    */
   accessor layout: Extract<"horizontal" | "vertical", Layout>;
-  /** Overrides individual strings used by the component. */
-  accessor messageOverrides: { resize?: string; };
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
+  accessor messageOverrides: { resize?: string | undefined; };
   /**
    * Specifies the component's position. Will be flipped when the element direction is right-to-left (`"rtl"`).
    *
@@ -72,8 +91,10 @@ export abstract class ShellPanel extends LitElement {
    * @default false
    */
   accessor resizable: boolean;
+  /** @internal */
+  accessor shellSizingDataProvider: ShellSizingDataProvider | undefined;
   /** Specifies the component's width. */
-  accessor width: Extract<Width, Scale>;
+  accessor width: Extract<Width, Scale> | undefined;
   /**
    * When `layout` is `vertical`, specifies the component's width.
    *
@@ -101,4 +122,11 @@ export abstract class ShellPanel extends LitElement {
     calciteShellPanelCollapse: ShellPanel["calciteShellPanelCollapse"]["detail"];
     calciteShellPanelExpand: ShellPanel["calciteShellPanelExpand"]["detail"];
   };
-}
+}
+
+/** @param axis */
+export type ShellSizingDataProvider = (axis: "inline" | "block") => ShellPanelSizingData | null;
+
+export type ShellPanelSizingData = {
+  availableSize: number;
+};