@pacem/pacem-ui 1.0.0-bessel → 1.0.0-binet

package/dist/bundle/pacem-ui.mjs

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bessel (https://js.pacem.it)
+ * @pacem/pacem-ui v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
@@ -115,7 +115,7 @@ __export(index_components_ui_exports, {
 });
 
 // packages/ui/dist/esm/adapter.js
-import { P, PCSS, Defaults, CustomElement, ViewChild, Watch, Utils, PropertyConverters, Debounce, avoidHandler, Throttle } from "@pacem/pacem-core";
+import { P, PCSS, Defaults, CustomElement, ViewChild, Watch, Utils, PropertyConverters, Debounce, avoidHandler, Throttle, CustomElementUtils } from "@pacem/pacem-core";
 import { Components, UI } from "@pacem/pacem-core";
 var __decorate = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -257,19 +257,12 @@ var PacemAdapterElement = class PacemAdapterElement2 extends Components.PacemAda
     const pagers = this._pageMap;
     if (pagers.has(index)) {
       const pager = pagers.get(index), span = pager.firstElementChild;
-      let fn = (e) => {
-        if (e) {
-          pager.removeEventListener("load", fn, false);
-        }
+      const fn = () => {
         pager.hide = hide;
         pager.disabled = disable;
         span.content = caption;
       };
-      if (pager.isReady) {
-        fn();
-      } else {
-        pager.addEventListener("load", fn, false);
-      }
+      CustomElementUtils.whenReady(pager, fn);
     }
   }
   _tickVersion() {
@@ -468,7 +461,7 @@ var PacemAnchorElement = class PacemAnchorElement2 extends Components2.PacemElem
     super("link");
     this._fetching = false;
   }
-  ///
+  /** @readonly Gets whether a `download` fetch is currently in progress. */
   get fetching() {
     return this._fetching;
   }
@@ -1154,7 +1147,7 @@ PacemBalloonElement = __decorate3([
 ], PacemBalloonElement);
 
 // packages/ui/dist/esm/binder.js
-import { P as P4, PCSS as PCSS4, CustomElement as CustomElement4, Watch as Watch4, Utils as Utils4, PropertyConverters as PropertyConverters4, Components as Components4, CustomUIEvent, CustomElementUtils } from "@pacem/pacem-core";
+import { P as P4, PCSS as PCSS4, CustomElement as CustomElement4, Watch as Watch4, Utils as Utils4, PropertyConverters as PropertyConverters4, Components as Components4, CustomUIEvent, CustomElementUtils as CustomElementUtils2 } from "@pacem/pacem-core";
 import { Point } from "@pacem/pacem-foundation";
 var __decorate4 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -1226,10 +1219,10 @@ var BinderUtils = class {
     this._bodyResizeListener.disabled = binders.length === 0;
   }
   static register(element, binder) {
-    var collector = CustomElementUtils.getAttachedPropertyValue(element, UI_BINDERS), binders = this._pageBinders;
+    var collector = CustomElementUtils2.getAttachedPropertyValue(element, UI_BINDERS), binders = this._pageBinders;
     if (Utils4.isNull(collector)) {
       collector = new BindersCollector(element);
-      CustomElementUtils.setAttachedPropertyValue(element, UI_BINDERS, collector);
+      CustomElementUtils2.setAttachedPropertyValue(element, UI_BINDERS, collector);
     }
     if (collector.binders.indexOf(binder) == -1) {
       if (collector.binders.length === 0) {
@@ -1244,13 +1237,13 @@ var BinderUtils = class {
     }
   }
   static unregister(element, binder) {
-    var collector = CustomElementUtils.getAttachedPropertyValue(element, UI_BINDERS), ndx, binders = this._pageBinders, ndx2;
+    var collector = CustomElementUtils2.getAttachedPropertyValue(element, UI_BINDERS), ndx, binders = this._pageBinders, ndx2;
     if (!Utils4.isNull(collector) && (ndx = collector.binders.indexOf(binder)) > -1) {
       collector.binders.splice(ndx, 1);
       if (collector.binders.length === 0) {
         collector.resize.removeEventListener(Components4.ResizeEventName, collector.fire, false);
         collector.dispose();
-        CustomElementUtils.deleteAttachedPropertyValue(element, UI_BINDERS);
+        CustomElementUtils2.deleteAttachedPropertyValue(element, UI_BINDERS);
       }
     }
     if ((ndx2 = binders.indexOf(binder)) >= 0) {
@@ -1370,6 +1363,7 @@ var PacemBinderElement = class PacemBinderElement2 extends Components4.PacemElem
       });
     }
   }
+  /** Resizes the shared full-page SVG overlay to match the current document size; call after layout changes that may affect `document.body`'s scroll size. */
   invalidateSize() {
     const svg = this._svg;
     if (!Utils4.isNull(svg)) {
@@ -1665,6 +1659,7 @@ var PacemBinderElement = class PacemBinderElement2 extends Components4.PacemElem
     }
     return { points: [p1, c1, p2, c2], anchors: [anchor, refAnchor] };
   }
+  /** Updates the cached position/size for the given endpoint (`from` or `to`) and redraws the curve if both ends are known. @param args Pre-computed layout, or omitted to reuse the last known/cached value. */
   refresh(element, args) {
     var path;
     if (Utils4.isNull(element) || Utils4.isNull(path = this._path)) {
@@ -1837,7 +1832,7 @@ PacemBladeElement = __decorate5([
 ], PacemBladeElement);
 
 // packages/ui/dist/esm/bottom-sheet.js
-import { P as P6, PCSS as PCSS5, CustomElement as CustomElement6, Watch as Watch6, Utils as Utils6, PropertyConverters as PropertyConverters6, Components as Components6, preventDefaultHandler as preventDefaultHandler2, ViewChild as ViewChild3, CustomElementUtils as CustomElementUtils2, UI as UI2 } from "@pacem/pacem-core";
+import { P as P6, PCSS as PCSS5, CustomElement as CustomElement6, Watch as Watch6, Utils as Utils6, PropertyConverters as PropertyConverters6, Components as Components6, preventDefaultHandler as preventDefaultHandler2, ViewChild as ViewChild3, CustomElementUtils as CustomElementUtils3, UI as UI2 } from "@pacem/pacem-core";
 var __decorate6 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -1857,7 +1852,7 @@ var PacemBottomSheetHandleElement = class PacemBottomSheetHandleElement2 extends
     super.viewActivatedCallback();
     this._setIcon();
     this._toggleHandle();
-    this.#bottomSheet = CustomElementUtils2.findAncestorOfType(this, PacemBottomSheetElement);
+    this.#bottomSheet = CustomElementUtils3.findAncestorOfType(this, PacemBottomSheetElement);
     this._bindToBottomSheet();
   }
   propertyChangedCallback(name, old, val, first) {
@@ -1877,7 +1872,7 @@ var PacemBottomSheetHandleElement = class PacemBottomSheetHandleElement2 extends
   disconnectedCallback() {
     this.removeEventListener("click", this._clickHandler);
     const bs = this.#bottomSheet;
-    if (!Utils6.isNull(bs)) {
+    if (!Utils6.isNull(bs) && bs.isReady) {
       bs._setHandle(null);
     }
     this.#bottomSheet = null;
@@ -1889,9 +1884,13 @@ var PacemBottomSheetHandleElement = class PacemBottomSheetHandleElement2 extends
     if (Utils6.isNull(bs)) {
       return;
     }
-    const id = Utils6.isNullOrEmpty(this.id) ? this.id = "handle_" + Utils6.uniqueCode() : this.id;
-    bs._setHandle(this);
-    this.addEventListener("click", this._clickHandler, false);
+    if (Utils6.isNullOrEmpty(this.id)) {
+      this.id = "handle_" + Utils6.uniqueCode();
+    }
+    CustomElementUtils3.whenReady(bs, () => {
+      bs._setHandle(this);
+      this.addEventListener("click", this._clickHandler, false);
+    });
   }
   _toggleHandle(disabled = this.disabled) {
     this.style.pointerEvents = disabled ? "none" : "";
@@ -1975,7 +1974,7 @@ var PacemBottomSheetElement = class PacemBottomSheetElement2 extends Components6
       swiper.disabled = disabled;
     }
   }
-  /** @internal */
+  /** @internal Wires (or clears) the swiper's drag handle selector to the given {@link PacemBottomSheetHandleElement}. */
   _setHandle(handle) {
     if (Utils6.isNull(handle)) {
       this._swiper.handleSelector = null;
@@ -2141,6 +2140,7 @@ var DialogResultEvent = class extends CustomTypedEvent {
 };
 var PacemDialogBase = class extends Components7.PacemElement {
   #deferred;
+  /** Opens the dialog, optionally seeding its `state`. @returns A promise resolved with the {@link DialogResultEventArgs} once the dialog is committed. */
   open(state) {
     const lb = this.lightbox;
     if (!Utils7.isNull(this.#deferred)) {
@@ -2157,6 +2157,7 @@ var PacemDialogBase = class extends Components7.PacemElement {
     }
     return deferred.promise;
   }
+  /** Closes the dialog with the given button outcome, resolving the pending `open()` promise and dispatching a {@link DialogResultEvent}. */
   commit(btn, evt) {
     avoidHandler2(evt);
     this.log(Logging.LogLevel.Debug, `Committing dialog by clicking '${btn}'.`);
@@ -2306,7 +2307,7 @@ PacemButtonsetElement = __decorate9([
 ], PacemButtonsetElement);
 
 // packages/ui/dist/esm/calendar.js
-import { P as P9, PCSS as PCSS7, CustomElement as CustomElement9, Watch as Watch9, ViewChild as ViewChild4, Utils as Utils9, PropertyConverters as PropertyConverters8, Components as Components10, CustomTypedEvent as CustomTypedEvent2, PropertyChangeEvent as PropertyChangeEvent3, Defaults as Defaults2, CustomElementUtils as CustomElementUtils3, Debounce as Debounce2, PropertyChangeEventName } from "@pacem/pacem-core";
+import { P as P9, PCSS as PCSS7, CustomElement as CustomElement9, Watch as Watch9, ViewChild as ViewChild4, Utils as Utils9, PropertyConverters as PropertyConverters8, Components as Components10, CustomTypedEvent as CustomTypedEvent2, PropertyChangeEvent as PropertyChangeEvent3, Defaults as Defaults2, CustomElementUtils as CustomElementUtils4, Debounce as Debounce2, PropertyChangeEventName } from "@pacem/pacem-core";
 var __decorate10 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -2591,6 +2592,7 @@ var PacemCalendarWithEventsBaseElement = class extends PacemCalendarBaseElement
     super(...arguments);
     this._datasource = [];
   }
+  /** @readonly Gets the computed, per-row (week or day) grid of positioned event items ready for rendering. */
   get datasource() {
     return this._datasource;
   }
@@ -2722,6 +2724,7 @@ var PacemAgendaElement = class PacemAgendaElement2 extends PacemCalendarWithEven
     }
     return ds;
   }
+  /** @readonly Gets the computed all-day row of positioned event items ready for rendering. */
   get allDayDatasource() {
     return this._allDayDatasource;
   }
@@ -2910,7 +2913,7 @@ var PacemCalendarRuleBaseElement = class extends HTMLElement {
     this._disabledRanges = [];
   }
   viewActivatedCallback() {
-    if (!Utils9.isNull(this._target = CustomElementUtils3.findAncestor(this, (node) => node instanceof PacemCalendarBaseElement))) {
+    if (!Utils9.isNull(this._target = CustomElementUtils4.findAncestor(this, (node) => node instanceof PacemCalendarBaseElement))) {
       this.refreshDisabledRanges();
     } else {
       throw `Missing ancestor calendar element for ${this.constructor.name}.`;
@@ -2919,6 +2922,7 @@ var PacemCalendarRuleBaseElement = class extends HTMLElement {
   disconnectedCallback() {
     this._target = void 0;
   }
+  /** @readonly Gets the ancestor calendar element this rule applies its disabled ranges to. */
   get target() {
     return this._target;
   }
@@ -3095,7 +3099,7 @@ var PacemDialogElement = class PacemDialogElement2 extends PacemDialogBase {
   viewActivatedCallback() {
     super.viewActivatedCallback();
   }
-  /** Gets the 'ok', 'yes', 'no' and 'cancel' dialog buttons. */
+  /** @readonly Gets the 'ok', 'yes', 'no' and 'cancel' dialog buttons. */
   get dialogButtons() {
     const btns = this._buttons;
     return {
@@ -3194,7 +3198,7 @@ PacemDividerElement = __decorate13([
 ], PacemDividerElement);
 
 // packages/ui/dist/esm/icon.js
-import { P as P13, PCSS as PCSS10, CustomElement as CustomElement13, Watch as Watch13, Utils as Utils12, PropertyConverters as PropertyConverters12, Components as Components13, CustomElementUtils as CustomElementUtils4 } from "@pacem/pacem-core";
+import { P as P13, PCSS as PCSS10, CustomElement as CustomElement13, Watch as Watch13, Utils as Utils12, PropertyConverters as PropertyConverters12, Components as Components13, CustomElementUtils as CustomElementUtils5 } from "@pacem/pacem-core";
 var __decorate14 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -3221,7 +3225,7 @@ function importConditionally(cssClassName, url, sha, crossOrigin, js) {
   if (Utils12.Css.isClassDefined(cssClassName)) {
     return Promise.resolve();
   }
-  return js ? CustomElementUtils4.importjs(url, sha, crossOrigin) : CustomElementUtils4.importcss(url, sha, crossOrigin);
+  return js ? CustomElementUtils5.importjs(url, sha, crossOrigin) : CustomElementUtils5.importcss(url, sha, crossOrigin);
 }
 function getIconMarkup(icon) {
   return new Promise((resolve, reject) => {
@@ -3454,6 +3458,7 @@ var PacemInfiniteScrollerElement = class PacemInfiniteScrollerElement2 extends P
         break;
     }
   }
+  /** Re-targets the watched scroll container/viewport/scroll-event-source. @param v An element, a CSS selector, or `'$document'` for the whole page. */
   setInfiniteScrollContainer(v = "$document") {
     var cont = v;
     var isDoc = this._isDocument = cont === "$document" || cont === document.body || cont === document.documentElement;
@@ -3546,6 +3551,7 @@ var PacemAdaptedIterativeElement = class extends Components15.PacemElement {
     super(...arguments);
     this.index = 0;
   }
+  /** Gets whether `ndx` is the focused item itself, or immediately adjacent (previous/next, wrapping around) to `focusndx`. */
   isCloseTo(ndx, focusndx) {
     if (Utils15.isNull(this.datasource) || this.datasource.length == 0)
       return false;
@@ -3554,6 +3560,7 @@ var PacemAdaptedIterativeElement = class extends Components15.PacemElement {
       this._isCloseToCore(ndx, focusndx, this.datasource.length)
     );
   }
+  /** Gets whether `ndx` is the item immediately preceding `focusndx` (wrapping around the datasource). */
   isPrevious(ndx, focusndx) {
     if (Utils15.isNull(this.datasource) || this.datasource.length == 0)
       return false;
@@ -3562,6 +3569,7 @@ var PacemAdaptedIterativeElement = class extends Components15.PacemElement {
       this._isPreviousCore(ndx, focusndx, this.datasource.length)
     );
   }
+  /** Gets whether `ndx` is the item immediately following `focusndx` (wrapping around the datasource). */
   isNext(ndx, focusndx) {
     if (Utils15.isNull(this.datasource) || this.datasource.length == 0)
       return false;
@@ -4192,9 +4200,11 @@ var MarkdownService = class {
   _escape(md) {
     return (md ?? "").replace(/</g, "&lt;");
   }
+  /** Converts the given Markdown source into an HTML string. */
   toHtml(md) {
     return this.#md.toHtml(this._escape(md), this.#grammar, RULES_TO_HTML);
   }
+  /** Tokenizes the given Markdown source, without rendering it to HTML. */
   tokenize(md) {
     return this.#md.tokenize(this._escape(md), this.#grammar);
   }
@@ -4219,9 +4229,11 @@ var PacemMarkdownElement = class PacemMarkdownElement2 extends Components18.Pace
     }
   }
   // IDEA: allow extensible parsing (grammar components?...)
+  /** Tokenizes the given (or current `value`) Markdown source. */
   tokens(md = this.value) {
     return this._md.tokenize(md);
   }
+  /** Converts the given (or current `value`) Markdown source to an HTML string. */
   html(md = this.value) {
     return this._md.toHtml(md);
   }
@@ -4405,7 +4417,7 @@ PacemMediaQueryElement = __decorate22([
 ], PacemMediaQueryElement);
 
 // packages/ui/dist/esm/menu.js
-import { P as P22, PCSS as PCSS14, Utils as Utils20, CustomElement as CustomElement21, Watch as Watch22, ViewChild as ViewChild10, PropertyConverters as PropertyConverters21, Components as Components20, Defaults as Defaults6, avoidHandler as avoidHandler4, stopPropagationHandler as stopPropagationHandler3, CustomElementUtils as CustomElementUtils5, Logging as Logging2 } from "@pacem/pacem-core";
+import { P as P22, PCSS as PCSS14, Utils as Utils20, CustomElement as CustomElement21, Watch as Watch22, ViewChild as ViewChild10, PropertyConverters as PropertyConverters21, Components as Components20, Defaults as Defaults6, avoidHandler as avoidHandler4, stopPropagationHandler as stopPropagationHandler3, CustomElementUtils as CustomElementUtils6, Logging as Logging2 } from "@pacem/pacem-core";
 var __decorate23 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -4445,7 +4457,7 @@ var PacemMenuElement = class PacemMenuElement2 extends Components20.PacemElement
   connectedCallback() {
     super.connectedCallback();
     window.addEventListener("navigate", this._stopPropagationHandlerConditional, false);
-    this._shell = CustomElementUtils5.findAncestorShell(this);
+    this._shell = CustomElementUtils6.findAncestorShell(this);
   }
   _toggle(evt) {
     avoidHandler4(evt);
@@ -4543,7 +4555,7 @@ var PacemMenuCursorElement = PacemMenuCursorElement_1 = class PacemMenuCursorEle
   }
   viewActivatedCallback() {
     super.viewActivatedCallback();
-    this._menu = CustomElementUtils5.findAncestorOfType(this, PacemMenuElement);
+    this._menu = CustomElementUtils6.findAncestorOfType(this, PacemMenuElement);
     this._onPathChange();
   }
   connectedCallback() {
@@ -4746,6 +4758,7 @@ var PacemPictureElement = class PacemPictureElement2 extends Components22.PacemI
     }
     super.disconnectedCallback();
   }
+  /** Rebuilds the `<source>` elements from the current child `PacemPictureSourceElement` items. */
   refreshSources() {
     this._setSources();
   }
@@ -4882,7 +4895,7 @@ PacemProgressbarElement = __decorate26([
 ], PacemProgressbarElement);
 
 // packages/ui/dist/esm/sidebar.js
-import { P as P26, PCSS as PCSS16, Utils as Utils24, CustomElement as CustomElement25, Watch as Watch26, PropertyConverters as PropertyConverters25, Components as Components24, CustomElementUtils as CustomElementUtils6 } from "@pacem/pacem-core";
+import { P as P26, PCSS as PCSS16, Utils as Utils24, CustomElement as CustomElement25, Watch as Watch26, PropertyConverters as PropertyConverters25, Components as Components24, CustomElementUtils as CustomElementUtils7 } from "@pacem/pacem-core";
 var __decorate27 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -4922,7 +4935,7 @@ var PacemSidebarElement = class PacemSidebarElement2 extends Components24.PacemE
   #shell;
   connectedCallback() {
     super.connectedCallback();
-    this.#shell = CustomElementUtils6.findAncestorShell(this);
+    this.#shell = CustomElementUtils7.findAncestorShell(this);
   }
 };
 __decorate27([
@@ -4968,7 +4981,7 @@ PacemSlideshowElement = __decorate28([
 ], PacemSlideshowElement);
 
 // packages/ui/dist/esm/social-twitter.js
-import { P as P28, CustomElementUtils as CustomElementUtils7, CustomElement as CustomElement27, Watch as Watch27, PropertyConverters as PropertyConverters26, Components as Components26 } from "@pacem/pacem-core";
+import { P as P28, CustomElementUtils as CustomElementUtils8, CustomElement as CustomElement27, Watch as Watch27, PropertyConverters as PropertyConverters26, Components as Components26 } from "@pacem/pacem-core";
 var __decorate29 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -4987,7 +5000,7 @@ var PacemTweetEmbedElement = class PacemTweetEmbedElement2 extends Components26.
   }
   viewActivatedCallback() {
     super.viewActivatedCallback();
-    CustomElementUtils7.importjs("https://platform.twitter.com/widgets.js").then(() => {
+    CustomElementUtils8.importjs("https://platform.twitter.com/widgets.js").then(() => {
       this._scriptsLoaded = true;
       this._render();
     });
@@ -5006,7 +5019,7 @@ PacemTweetEmbedElement = __decorate29([
 ], PacemTweetEmbedElement);
 
 // packages/ui/dist/esm/sticky-header.js
-import { P as P29, CustomElementUtils as CustomElementUtils8, CustomElement as CustomElement28, Watch as Watch28, PropertyConverters as PropertyConverters27, PacemEventTarget as PacemEventTarget4, Components as Components27, Utils as Utils25, Logging as Logging3 } from "@pacem/pacem-core";
+import { P as P29, CustomElementUtils as CustomElementUtils9, CustomElement as CustomElement28, Watch as Watch28, PropertyConverters as PropertyConverters27, PacemEventTarget as PacemEventTarget4, Components as Components27, Utils as Utils25, Logging as Logging3 } from "@pacem/pacem-core";
 var __decorate30 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -5034,7 +5047,7 @@ var PacemStickyHeaderElement = class PacemStickyHeaderElement2 extends PacemEven
     if (Utils25.isNull(this.#scroller)) {
       const scroller = this.#scroller = new Components27.PacemScrollAwareElement();
       this.log(Logging3.LogLevel.Debug, "creating scroll aware " + this.#id);
-      const shell = this.#shell = CustomElementUtils8.findAncestorShell(this);
+      const shell = this.#shell = CustomElementUtils9.findAncestorShell(this);
       shell.appendChild(scroller);
       scroller.dataset["target"] = this.#id;
       scroller.addEventListener(Components27.ScrollEventName, this._scrollHandler, false);
@@ -5150,6 +5163,7 @@ var PacemTabElement = class PacemTabElement2 extends Components28.PacemIterableE
     super.disconnectedCallback();
   }
   #content;
+  /** @readonly Gets the nodes assigned to the `label` slot. */
   get content() {
     return this.querySelectorAll("*[slot=label]");
   }
@@ -5368,7 +5382,7 @@ PacemTickerElement = __decorate32([
 ], PacemTickerElement);
 
 // packages/ui/dist/esm/toast.js
-import { P as P32, PCSS as PCSS18, CustomElement as CustomElement31, Watch as Watch30, Components as Components30, Utils as Utils28, PropertyConverters as PropertyConverters29, CustomElementUtils as CustomElementUtils9, Transformer } from "@pacem/pacem-core";
+import { P as P32, PCSS as PCSS18, CustomElement as CustomElement31, Watch as Watch30, Components as Components30, Utils as Utils28, PropertyConverters as PropertyConverters29, CustomElementUtils as CustomElementUtils10, Transformer } from "@pacem/pacem-core";
 var __decorate33 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -5402,8 +5416,8 @@ var PacemToastElement = PacemToastElement_1 = class PacemToastElement2 extends C
           Utils28.removeClass(this, "toast-hide");
         });
       } else {
-        let order = CustomElementUtils9.getAttachedPropertyValue(PacemToastElement_1, PACEM_TOAST_POPS, 0) - 1;
-        CustomElementUtils9.setAttachedPropertyValue(PacemToastElement_1, PACEM_TOAST_POPS, order);
+        let order = CustomElementUtils10.getAttachedPropertyValue(PacemToastElement_1, PACEM_TOAST_POPS, 0) - 1;
+        CustomElementUtils10.setAttachedPropertyValue(PacemToastElement_1, PACEM_TOAST_POPS, order);
         this.style.order = "" + order;
         Utils28.addClass(this, "toast-show");
         this._show();
@@ -5425,6 +5439,7 @@ var PacemToastElement = PacemToastElement_1 = class PacemToastElement2 extends C
       }, this.timeout);
     }
   }
+  /** Shows the toast, (re)starting the autohide timer if applicable. */
   popup() {
     if (this.show) {
       this._show();
@@ -5501,6 +5516,13 @@ var PacemToastElement = PacemToastElement_1 = class PacemToastElement2 extends C
       toast.addEventListener("close", callback, false);
     });
   }
+  /**
+   * Like `toast`, but renders the message inside a filled/bordered container for extra emphasis.
+   * @param toaster Toast container
+   * @param level Message criticity level
+   * @param message The message
+   * @param options Further options object
+   */
   static toast2(toaster, level, message, options) {
     let cssClass = options?.cssClass;
     let cssArray = ["fill-" + level + "-container", "fill-glass", "border-solid", "border-size--2", "border-round", "border-radius--6"];
@@ -5901,6 +5923,7 @@ var __decorate36 = function(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 var PacemVibrateElement = class PacemVibrateElement2 extends PacemEventTarget5 {
+  /** Triggers a vibration using the current `pattern`, if supported by the browser and not disabled. */
   vibrate() {
     if (this.disabled) {
       return;
@@ -5927,7 +5950,7 @@ PacemVibrateElement = __decorate36([
 ], PacemVibrateElement);
 
 // packages/ui/dist/esm/view.js
-import { P as P36, CustomElement as CustomElement35, Watch as Watch34, PacemEventTarget as PacemEventTarget6, Components as Components33, Utils as Utils32, PropertyConverters as PropertyConverters32, Logging as Logging4, CustomElementUtils as CustomElementUtils10 } from "@pacem/pacem-core";
+import { P as P36, CustomElement as CustomElement35, Watch as Watch34, PacemEventTarget as PacemEventTarget6, Components as Components33, Utils as Utils32, PropertyConverters as PropertyConverters32, Logging as Logging4, CustomElementUtils as CustomElementUtils11 } from "@pacem/pacem-core";
 var __decorate37 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -6104,7 +6127,7 @@ var PacemViewElement = class PacemViewElement2 extends PacemEventTarget6 {
     const resizer = new Components33.PacemResizeElement();
     resizer.target = this;
     resizer.addEventListener(Components33.ResizeEventName, this._debounceDispatchHandler);
-    CustomElementUtils10.findAncestorShell(this).appendChild(resizer);
+    CustomElementUtils11.findAncestorShell(this).appendChild(resizer);
     this._debounceDispatchHandler();
   }
   _dispatchPrerender() {
@@ -6136,7 +6159,7 @@ PacemViewElement = __decorate37([
 ], PacemViewElement);
 
 // packages/ui/dist/esm/window.js
-import { P as P37, PCSS as PCSS21, CustomElement as CustomElement36, Watch as Watch35, Components as Components34, UI as UI4, Utils as Utils33, PropertyConverters as PropertyConverters33, Defaults as Defaults10, CustomElementUtils as CustomElementUtils11, PropertyChangeEventName as PropertyChangeEventName2 } from "@pacem/pacem-core";
+import { P as P37, PCSS as PCSS21, CustomElement as CustomElement36, Watch as Watch35, Components as Components34, UI as UI4, Utils as Utils33, PropertyConverters as PropertyConverters33, Defaults as Defaults10, CustomElementUtils as CustomElementUtils12, PropertyChangeEventName as PropertyChangeEventName2 } from "@pacem/pacem-core";
 var __decorate38 = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -6183,7 +6206,7 @@ var PacemWindowAreaElement = class PacemWindowAreaElement2 extends Components34.
   }
   connectedCallback() {
     super.connectedCallback();
-    let shell = CustomElementUtils11.findAncestorShell(this);
+    let shell = CustomElementUtils12.findAncestorShell(this);
     this._behaviors = [
       shell.appendChild(this._dragDrop = document.createElement(P37 + "-drag-drop")),
       shell.appendChild(this._rescale = document.createElement(P37 + "-rescale"))
@@ -6225,6 +6248,7 @@ var PacemWindowAreaElement = class PacemWindowAreaElement2 extends Components34.
       this._syncVisibility();
     }
   }
+  /** Registers a window item, wiring drag/resize behaviors and focus tracking; returns whether it was newly added. */
   register(item) {
     const retval = super.register(item);
     if (retval) {
@@ -6239,6 +6263,7 @@ var PacemWindowAreaElement = class PacemWindowAreaElement2 extends Components34.
     }
     return retval;
   }
+  /** Unregisters a window item, tearing down its drag/resize behaviors; returns whether it was found and removed. */
   unregister(item) {
     const retval = super.unregister(item);
     if (retval) {