@pacem/pacem 1.0.0-bessel → 1.0.0-binet

package/dist/browser/pacem-ui.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem v1.0.0-bessel (https://js.pacem.it)
+ * @pacem/pacem v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
@@ -14,17 +14,20 @@
     };
     const { PacemElement, RepeaterItemCreateEventName, ItemRegisterEventName, ItemUnregisterEventName } = pacemCore.Components;
     //namespace Pacem.Components.UI {
+    /** Orientation used by a {@link PacemAdapterElement} to interpret arrow-key navigation. */
     var AdapterOrientation;
     (function (AdapterOrientation) {
         AdapterOrientation["Vertical"] = "vertical";
         AdapterOrientation["Horizontal"] = "horizontal";
     })(AdapterOrientation || (AdapterOrientation = {}));
     const AdapterPageButtonRefreshEventName = 'pagerefresh';
+    /** Event dispatched by {@link PacemAdapterElement} whenever a page/dashboard button needs to (re)compute its visible state or content. */
     class AdapterPageButtonRefreshEvent extends CustomEvent {
         constructor(args) {
             super(AdapterPageButtonRefreshEventName, { detail: args, bubbles: false, cancelable: false });
         }
     }
+    /** Renders a dashboard of prev/next buttons and page indicators driving a {@link Components.PacemAdapter} (e.g. a `<pacem-slideshow>` master). */
     let PacemAdapterElement = class PacemAdapterElement extends pacemCore.Components.PacemAdapter {
         constructor() {
             super(...arguments);
@@ -34,10 +37,13 @@
                 this._fireAdapterPageRefreshCallback(index, evt.detail.item);
             };
             this._pageMap = new Map();
+            /** Gets or sets whether the dashboard responds to user interaction (keyboard, click, swipe). */
             this.interactive = true;
             /** Gets or sets whether swipe gesture is enabled for navigation (also depends on the 'interactive' flag being set to 'true') */
             this.swipeEnabled = true;
+            /** Gets or sets whether navigating past the last (or before the first) item wraps around. */
             this.loop = true;
+            /** Gets or sets the callback computing a page button's caption for a given item/index (defaults to the 1-based index). */
             this.labelCallback = (item, index) => (index + 1).toString();
             this._itemRegisterHandler = (evt) => {
                 let item = evt.detail;
@@ -154,10 +160,7 @@
             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;
@@ -165,13 +168,7 @@
                 // *careful here*: TODO: TO BE STUDIED
                 // if setting the property before it's connected
                 // the @Watch configuration and the get+set injection gets lost!
-                if (pager.isReady) {
-                    // does not work for properties(?)...
-                    fn();
-                }
-                else {
-                    pager.addEventListener('load', fn, false);
-                }
+                pacemCore.CustomElementUtils.whenReady(pager, fn);
             }
         }
         _tickVersion() {
@@ -372,12 +369,13 @@
     };
     //namespace Pacem.Components.UI {
     // TODO: shadow-ize and reuse native <a> element.
+    /** Anchor-like custom element, supporting routed navigation (via a {@link Components.PacemRouterElement}), OAuth-authenticated downloads and keyboard activation. */
     let PacemAnchorElement = class PacemAnchorElement extends pacemCore.Components.PacemElement {
         constructor() {
             super('link');
             this._fetching = false;
         }
-        ///
+        /** @readonly Gets whether a `download` fetch is currently in progress. */
         get fetching() {
             return this._fetching;
         }
@@ -512,6 +510,7 @@
         })
     ], PacemAnchorElement);
 
+    /** Converts an attribute value into an `Element` (resolved via `querySelector`) or, failing that, a parsed `Point`/JSON value. */
     const ElementOrPointPropertyConverter = {
         convert: (attr) => {
             let el = document.querySelector(attr);
@@ -527,12 +526,14 @@
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** How a {@link PacemBalloonElement} behaves once popped up: a dismissible menu, a tooltip, or non-interactive. */
     var BalloonBehavior;
     (function (BalloonBehavior) {
         BalloonBehavior["Menu"] = "menu";
         BalloonBehavior["Tooltip"] = "tooltip";
         BalloonBehavior["Inert"] = "inert";
     })(BalloonBehavior || (BalloonBehavior = {}));
+    /** The user interaction on `target` that pops a {@link PacemBalloonElement} up. */
     var BalloonTrigger;
     (function (BalloonTrigger) {
         BalloonTrigger["Hover"] = "hover";
@@ -540,6 +541,7 @@
         BalloonTrigger["ContextMenu"] = "contextmenu";
         BalloonTrigger["Focus"] = "focus";
     })(BalloonTrigger || (BalloonTrigger = {}));
+    /** Cross-axis alignment of a {@link PacemBalloonElement} relative to its `target`. */
     var BalloonAlignment;
     (function (BalloonAlignment) {
         BalloonAlignment["Start"] = "start";
@@ -547,6 +549,7 @@
         BalloonAlignment["End"] = "end";
         BalloonAlignment["Auto"] = "auto";
     })(BalloonAlignment || (BalloonAlignment = {}));
+    /** Side of `target` a {@link PacemBalloonElement} is anchored to (with automatic variants that pick the side with the most room). */
     var BalloonPosition;
     (function (BalloonPosition) {
         BalloonPosition["Top"] = "top";
@@ -557,12 +560,15 @@
         BalloonPosition["HorizontalAuto"] = "x";
         BalloonPosition["VerticalAuto"] = "y";
     })(BalloonPosition || (BalloonPosition = {}));
+    /** Whether a {@link PacemBalloonElement} sizes itself freely or matches its `target`'s size along the anchored axis. */
     var BalloonSizing;
     (function (BalloonSizing) {
         BalloonSizing["Auto"] = "auto";
         BalloonSizing["Match"] = "match";
     })(BalloonSizing || (BalloonSizing = {}));
+    /** Event name fired by {@link PacemBalloonElement} once it has finished popping up (after the show transition). */
     const BalloonPopupEventName = 'popup';
+    /** Event name fired by {@link PacemBalloonElement} once it has finished popping out (after the hide transition). */
     const BalloonPopoutEventName = 'popout';
     const BalloonConsts = {
         Defaults: {
@@ -580,6 +586,7 @@
     };
     const positioningStyles = 'balloon-right balloon-left balloon-bottom balloon-top balloon-start balloon-center balloon-end';
     const allStyles = pacemCore.PCSS + '-balloon ' + positioningStyles + ' balloon-out balloon-in balloon-on';
+    /** Positions its content as a floating popup (menu or tooltip) anchored to a `target` element or point; see {@link BalloonOptions}. */
     let PacemBalloonElement = class PacemBalloonElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
@@ -1106,6 +1113,7 @@
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     // namespace Pacem.Components.UI {
+    /** Edge (or center) of an element a {@link PacemBinderElement} curve attaches to. */
     var BinderAnchor;
     (function (BinderAnchor) {
         BinderAnchor["Auto"] = "auto";
@@ -1115,6 +1123,7 @@
         BinderAnchor["Bottom"] = "bottom";
         BinderAnchor["Center"] = "center";
     })(BinderAnchor || (BinderAnchor = {}));
+    /** Decoration drawn at either end of a {@link PacemBinderElement} curve. */
     var BinderEnd;
     (function (BinderEnd) {
         BinderEnd["Default"] = "default";
@@ -1122,18 +1131,22 @@
         BinderEnd["FatArrow"] = "fatarrow";
         BinderEnd["None"] = "none";
     })(BinderEnd || (BinderEnd = {}));
+    /** How a {@link PacemBinderElement} computes its Bezier control points: from the elements' mass (size) or from the path direction. */
     var BinderTension;
     (function (BinderTension) {
         BinderTension["Mass"] = "mass";
         BinderTension["Path"] = "path";
     })(BinderTension || (BinderTension = {}));
+    /** Event name fired by a {@link PacemBinderElement} when its connecting path is interacted with (click, hover, etc.). */
     const BinderInteractionEventName = 'interact';
+    /** Event dispatched by a {@link PacemBinderElement} wrapping the original user-interaction event on its path. */
     class BinderInteractionEvent extends pacemCore.CustomUIEvent {
         constructor(orig) {
             super(BinderInteractionEventName, null, orig);
         }
     }
     const UI_BINDERS = 'pacem:components:ui:binders';
+    /** Tracks the {@link PacemBinderElement} instances bound to a single endpoint element, refreshing them all on that element's resize/reposition. */
     class BindersCollector {
         constructor(element) {
             this.binders = [];
@@ -1151,6 +1164,7 @@
             this.resize.remove();
         }
     }
+    /** Static registry pairing endpoint elements with their {@link BindersCollector}, plus a page-wide resize listener keeping every registered {@link PacemBinderElement} in sync. */
     class BinderUtils {
         static { this._pageBinders = []; }
         static _updateResizeListener() {
@@ -1203,6 +1217,7 @@
         }
     }
     const STD_EVENTS = ['click', 'dblclick', 'mouseover', 'mouseout', 'mouseenter', 'mouseleave', 'mousedown', 'mouseup', 'mousemove', 'contextmenu'];
+    /** Draws an SVG Bezier curve connecting two elements (or points), following them as they move/resize; e.g. wires or diagram connectors. */
     let PacemBinderElement = class PacemBinderElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
@@ -1317,6 +1332,7 @@
                 });
             }
         }
+        /** 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 (!pacemCore.Utils.isNull(svg)) {
@@ -1628,6 +1644,7 @@
             }
             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 (pacemCore.Utils.isNull(element) || pacemCore.Utils.isNull(path = this._path)) {
@@ -1782,6 +1799,7 @@
     };
     // namespace Pacem.Components.UI {
     const OPEN_CSSCLASS$1 = 'blade-open';
+    /** Slide-in panel toggled via its `open` property, dispatching `open`/`close` events as it transitions. */
     let PacemBladeElement = class PacemBladeElement extends pacemCore.Components.PacemElement {
         propertyChangedCallback(name, old, val, first) {
             super.propertyChangedCallback(name, old, val, first);
@@ -1812,6 +1830,7 @@
     };
     // namespace Pacem.Components.UI {
     const OPEN_CSSCLASS = 'bottom-sheet-open';
+    /** Drag handle for an ancestor {@link PacemBottomSheetElement}: renders a small grip icon, toggles the sheet on click and drives its swipe-to-drag behavior. */
     let PacemBottomSheetHandleElement = class PacemBottomSheetHandleElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
@@ -1844,7 +1863,7 @@
         disconnectedCallback() {
             this.removeEventListener('click', this._clickHandler);
             const bs = this.#bottomSheet;
-            if (!pacemCore.Utils.isNull(bs)) {
+            if (!pacemCore.Utils.isNull(bs) && bs.isReady) {
                 bs._setHandle(null);
             }
             this.#bottomSheet = null;
@@ -1856,9 +1875,13 @@
             if (pacemCore.Utils.isNull(bs)) {
                 return;
             }
-            pacemCore.Utils.isNullOrEmpty(this.id) ? (this.id = ('handle_' + pacemCore.Utils.uniqueCode())) : this.id;
-            bs._setHandle(this);
-            this.addEventListener('click', this._clickHandler, false);
+            if (pacemCore.Utils.isNullOrEmpty(this.id)) {
+                this.id = ('handle_' + pacemCore.Utils.uniqueCode());
+            }
+            pacemCore.CustomElementUtils.whenReady(bs, () => {
+                bs._setHandle(this);
+                this.addEventListener('click', this._clickHandler, false);
+            });
         }
         _toggleHandle(disabled = this.disabled) {
             this.style.pointerEvents = disabled ? 'none' : '';
@@ -1883,6 +1906,7 @@
         </div>`
         })
     ], PacemBottomSheetHandleElement);
+    /** Mobile-style panel anchored to the bottom of the viewport, draggable (via its {@link PacemBottomSheetHandleElement}) and swipeable open/closed. */
     let PacemBottomSheetElement = class PacemBottomSheetElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
@@ -1941,7 +1965,7 @@
                 swiper.disabled = disabled;
             }
         }
-        /** @internal */
+        /** @internal Wires (or clears) the swiper's drag handle selector to the given {@link PacemBottomSheetHandleElement}. */
         _setHandle(handle) {
             if (pacemCore.Utils.isNull(handle)) {
                 this._swiper.handleSelector = null;
@@ -2086,6 +2110,7 @@
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Set of buttons shown by a dialog (e.g. {@link PacemDialogBase}), controlling which {@link DialogButton}s are visible. */
     var DialogButtons;
     (function (DialogButtons) {
         DialogButtons["YesNo"] = "yesno";
@@ -2093,6 +2118,7 @@
         DialogButtons["Ok"] = "ok";
         DialogButtons["OkCancel"] = "okcancel";
     })(DialogButtons || (DialogButtons = {}));
+    /** Single button a dialog can be committed/closed with. */
     var DialogButton;
     (function (DialogButton) {
         DialogButton["Yes"] = "yes";
@@ -2100,14 +2126,18 @@
         DialogButton["Cancel"] = "cancel";
         DialogButton["Ok"] = "ok";
     })(DialogButton || (DialogButton = {}));
+    /** Event name dispatched by a {@link PacemDialogBase} when it is committed/closed via one of its buttons. */
     const DialogResultEventName = 'commit';
+    /** Event dispatched by a {@link PacemDialogBase} when it is committed/closed via one of its buttons; also the resolution value of `open()`'s promise. */
     class DialogResultEvent extends pacemCore.CustomTypedEvent {
         constructor(args) {
             super(DialogResultEventName, args);
         }
     }
+    /** Base class for modal dialog elements (see {@link PacemDialogElement}): wraps a {@link Lightbox} with an open/commit lifecycle resolved through a promise. */
     class PacemDialogBase extends pacemCore.Components.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 (!pacemCore.Utils.isNull(this.#deferred)) {
@@ -2125,6 +2155,7 @@
             }
             return deferred.promise;
         }
+        /** Closes the dialog with the given button outcome, resolving the pending `open()` promise and dispatching a {@link DialogResultEvent}. */
         commit(btn, evt) {
             pacemCore.avoidHandler(evt);
             this.log(pacemCore.Logging.LogLevel.Debug, `Committing dialog by clicking '${btn}'.`);
@@ -2147,6 +2178,7 @@
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Clickable button element with optional icon, command dispatching (via {@link CommandEvent}) and an optional confirmation dialog gate. */
     let PacemButtonElement = class PacemButtonElement extends pacemCore.Components.PacemIterableElement {
         constructor() {
             super('button');
@@ -2245,6 +2277,7 @@
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Groups {@link PacemButtonElement} children into a single iterable/selectable set, focusing the item matching `index`. */
     let PacemButtonsetElement = class PacemButtonsetElement extends pacemCore.Components.PacemIterativeElement {
         connectedCallback() {
             super.connectedCallback();
@@ -2284,22 +2317,26 @@
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Granularity of a calendar/schedule/agenda view. */
     var CalendarZoom;
     (function (CalendarZoom) {
         CalendarZoom["Month"] = "month";
         CalendarZoom["Week"] = "week";
         CalendarZoom["Day"] = "day";
     })(CalendarZoom || (CalendarZoom = {}));
+    /** Event dispatched by a {@link PacemCalendarBaseElement} whenever its `viewDate` changes, carrying the new date. */
     class ViewDateChangeEvent extends pacemCore.CustomTypedEvent {
         constructor(date) {
             super('viewdatechange', date);
         }
     }
+    /** Event dispatched (and bubbling) when a day is selected on a {@link PacemCalendarElement}, carrying the selected date. */
     class DateSelectEvent extends pacemCore.CustomTypedEvent {
         constructor(date) {
             super('dateselect', date, { bubbles: true });
         }
     }
+    /** Event dispatched (and bubbling) when a time slot is selected on a {@link PacemAgendaElement}, carrying the selected date/time. */
     class TimeSelectEvent extends pacemCore.CustomTypedEvent {
         constructor(date) {
             super('timeselect', date, { bubbles: true });
@@ -2312,6 +2349,7 @@
     let now = new Date();
     const DUMMY_DATE = pacemCore.Utils.Dates.dateOnly(now).valueOf();
     const DAYS_OF_WEEK = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
+    /** A single event/appointment item, meant as a child of a {@link PacemCalendarWithEventsBaseElement} (e.g. {@link PacemCalendarElement} or {@link PacemAgendaElement}). */
     let PacemCalendarEventElement = class PacemCalendarEventElement extends pacemCore.Components.PacemItemElement {
         propertyChangedCallback(name, old, val, first) {
             super.propertyChangedCallback(name, old, val, first);
@@ -2345,16 +2383,19 @@
             tagName: pacemCore.P + '-calendar-event'
         })
     ], PacemCalendarEventElement);
+    /** Event dispatched when a {@link PacemCalendarEventElement} rendering gains focus/selection within its host calendar. */
     class CalendarEventSelectEvent extends pacemCore.CustomTypedEvent {
         constructor(args) {
             super("eventselect", args, { bubbles: false, cancelable: true });
         }
     }
+    /** Event dispatched when a {@link PacemCalendarEventElement} rendering loses focus/selection within its host calendar. */
     class CalendarEventUnselectEvent extends pacemCore.CustomTypedEvent {
         constructor(args) {
             super("eventunselect", args, { bubbles: false, cancelable: true });
         }
     }
+    /** Base class shared by the calendar-family elements ({@link PacemCalendarElement}, {@link PacemAgendaElement}, {@link PacemScheduleElement}): holds the current view date/zoom/week/month grids and the {@link PacemCalendarEventElement} items collection. */
     class PacemCalendarBaseElement extends pacemCore.Components.PacemItemsContainerElement {
         validate(item) {
             return item instanceof PacemCalendarEventElement;
@@ -2512,11 +2553,13 @@
     __decorate$s([
         pacemCore.Watch({ converter: pacemCore.PropertyConverters.Eval })
     ], PacemCalendarBaseElement.prototype, "disabledRanges", void 0);
+    /** Base class for calendar-family elements that render their {@link PacemCalendarEventElement} items into a positioned grid (see {@link PacemCalendarElement}, {@link PacemAgendaElement}); subclasses supply the grid-building logic via `buildDataSource`. */
     class PacemCalendarWithEventsBaseElement extends PacemCalendarBaseElement {
         constructor() {
             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;
         }
@@ -2595,6 +2638,7 @@
         }
         return grid;
     }
+    /** Renders a day/week hourly grid ("agenda" view) with an all-day row, placing {@link PacemCalendarEventElement} items on the timeline and dispatching {@link TimeSelectEvent} on slot click. */
     let PacemAgendaElement = class PacemAgendaElement extends PacemCalendarWithEventsBaseElement {
         constructor() {
             super(...arguments);
@@ -2656,6 +2700,7 @@
             }
             return ds;
         }
+        /** @readonly Gets the computed all-day row of positioned event items ready for rendering. */
         get allDayDatasource() {
             return this._allDayDatasource;
         }
@@ -2725,6 +2770,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         }
         return grid;
     }
+    /** Renders a classic month grid, placing {@link PacemCalendarEventElement} items on their spanning day cells and dispatching {@link DateSelectEvent} on day click. */
     let PacemCalendarElement = class PacemCalendarElement extends PacemCalendarWithEventsBaseElement {
         buildDataSource(items) {
             const month = this.month;
@@ -2795,6 +2841,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
     ], PacemCalendarElement);
     // #endregion
     // #region CLOCK (to be worked on: many possibilities ahead)
+    /** Displays (and CSS-classes itself by) the current hour/minute; typically overlaid on a {@link PacemAgendaElement} to mark the current-time line. */
     let PacemClockElement = class PacemClockElement extends pacemCore.Components.PacemElement {
     };
     __decorate$s([
@@ -2813,6 +2860,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         "dock_" + pacemCore.Utils.uniqueCode();
         return `<div class="schedule-header schedule-grid"><div class="heading-left"></div>${header}</div>`;
     }
+    /** Combines a {@link PacemCalendarElement} (month view) and a {@link PacemAgendaElement} (day/week view) into a single scheduler, switching between them based on `zoom`. */
     let PacemScheduleElement = class PacemScheduleElement extends PacemCalendarBaseElement {
         viewActivatedCallback() {
             super.viewActivatedCallback();
@@ -2849,6 +2897,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
     ], PacemScheduleElement);
     // #endregion
     // #region RULES
+    /** Base class for declarative rule elements that compute and inject {@link DateRange}s into an ancestor {@link PacemCalendarBaseElement}'s `disabledRanges` (e.g. {@link PacemCalendarDayOfWeekRuleElement}). */
     class PacemCalendarRuleBaseElement extends HTMLElement {
         constructor() {
             super(...arguments);
@@ -2865,6 +2914,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         disconnectedCallback() {
             this._target = undefined;
         }
+        /** @readonly Gets the ancestor calendar element this rule applies its disabled ranges to. */
         get target() {
             return this._target;
         }
@@ -2892,6 +2942,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
     __decorate$s([
         pacemCore.Debounce(true)
     ], PacemCalendarRuleBaseElement.prototype, "refreshDisabledRanges", null);
+    /** Declarative {@link PacemCalendarRuleBaseElement} that disables every day of the ancestor calendar not listed in `days` (e.g. weekends). */
     let PacemCalendarDayOfWeekRuleElement = class PacemCalendarDayOfWeekRuleElement extends PacemCalendarRuleBaseElement {
         constructor() {
             super(...arguments);
@@ -2940,6 +2991,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Animates its content's height (or width, if `horizontal`) between 0 and its natural size, toggled via the `collapse` property. */
     let PacemCollapseElement = class PacemCollapseElement extends pacemCore.PacemEventTarget {
         constructor() {
             super(...arguments);
@@ -3011,13 +3063,19 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Modal dialog built on top of a {@link PacemLightboxElement}, with a configurable Ok/Yes/No/Cancel button set (see {@link DialogButtons}). */
     let PacemDialogElement = class PacemDialogElement extends PacemDialogBase {
         constructor() {
             super(...arguments);
+            /** Gets or sets which button set is shown (Ok, OkCancel, YesNo, YesNoCancel). */
             this.buttons = DialogButtons.Ok;
+            /** Gets or sets the caption of the Ok button. */
             this.okCaption = 'OK';
+            /** Gets or sets the caption of the Yes button. */
             this.yesCaption = 'Yes';
+            /** Gets or sets the caption of the No button. */
             this.noCaption = 'No';
+            /** Gets or sets the caption of the Cancel button. */
             this.cancelCaption = 'Cancel';
         }
         propertyChangedCallback(name, old, val, first) {
@@ -3049,7 +3107,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             //    }
             //});
         }
-        /** 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 {
@@ -3106,6 +3164,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** ARIA-`separator` element drawing a horizontal or vertical divider line, with optional `prepend`/`append` slotted content. */
     let PacemDividerElement = class PacemDividerElement extends pacemCore.Components.PacemElement {
         constructor() {
             super('separator');
@@ -3233,6 +3292,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             }
         });
     }
+    /** Renders an icon from a wide range of notations (inline SVG, Font Awesome, Material Symbols/Icons, LineIcons, CoreUI, or a plain image URL), lazily importing the matching stylesheet/script on demand. */
     let PacemIconElement = class PacemIconElement extends pacemCore.Components.PacemElement {
         constructor() {
             super('', { hidden: 'true' });
@@ -3283,6 +3343,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Renders an image as a CSS background (rather than an `<img>` src), enabling `cover`/`contain`/`auto` fitting and reporting its natural/decoded size. */
     let PacemImageElement = class PacemImageElement extends pacemCore.Components.PacemElement {
         constructor() {
             super('img');
@@ -3391,6 +3452,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Watches a scrollable `container` and dispatches a `fetchmore` event whenever the user scrolls within `threshold` pixels of the bottom. */
     let PacemInfiniteScrollerElement = class PacemInfiniteScrollerElement extends pacemCore.PacemEventTarget {
         constructor() {
             super();
@@ -3431,6 +3493,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
                     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;
@@ -3526,21 +3589,26 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Base class for elements iterating a `datasource` under the control of a {@link PacemAdapterElement} (e.g. a slideshow), exposing `index`-relative helpers (`isPrevious`, `isNext`, `isCloseTo`). */
     class PacemAdaptedIterativeElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
+            /** Gets or sets the currently focused item's index within `datasource`. */
             this.index = 0;
         }
+        /** Gets whether `ndx` is the focused item itself, or immediately adjacent (previous/next, wrapping around) to `focusndx`. */
         isCloseTo(ndx, focusndx) {
             if (pacemCore.Utils.isNull(this.datasource) || this.datasource.length == 0)
                 return false;
             return /*this.adapter.isClose(ndx) ||*/ this._isCloseToCore(ndx, focusndx, this.datasource.length);
         }
+        /** Gets whether `ndx` is the item immediately preceding `focusndx` (wrapping around the datasource). */
         isPrevious(ndx, focusndx) {
             if (pacemCore.Utils.isNull(this.datasource) || this.datasource.length == 0)
                 return false;
             return /*this.adapter.isPrevious(ndx) ||*/ this._isPreviousCore(ndx, focusndx, this.datasource.length);
         }
+        /** Gets whether `ndx` is the item immediately following `focusndx` (wrapping around the datasource). */
         isNext(ndx, focusndx) {
             if (pacemCore.Utils.isNull(this.datasource) || this.datasource.length == 0)
                 return false;
@@ -3565,6 +3633,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
     ], PacemAdaptedIterativeElement.prototype, "datasource", void 0);
 
     //namespace Pacem.Components.UI {
+    /** How a {@link Lightbox} reacts to a click outside its content. */
     var LightboxBehavior;
     (function (LightboxBehavior) {
         LightboxBehavior["ClickOutsideClose"] = "clickOutsideClose";
@@ -3579,6 +3648,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
     };
     //namespace Pacem.Components.UI {
     // TODO: shadow-ize lightbox (slots, parts, ...) in the next version 0.5x.x.
+    /** Full-viewport overlay ("lightbox") element showing its slotted content above a backdrop, with an auto-injected close button and optional modal (non-dismissible) behavior. */
     let PacemLightboxElement = class PacemLightboxElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
@@ -3789,12 +3859,14 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Visual style of a {@link PacemLoaderElement}'s spinner. */
     var LoaderType;
     (function (LoaderType) {
         LoaderType["Spinner"] = "spin";
         LoaderType["Pacem"] = "pacem";
         LoaderType["Custom"] = "custom";
     })(LoaderType || (LoaderType = {}));
+    /** Shows a spinner (plain CSS or the branded Pacem gear/SVG animation) while `active`, typically overlaid on content being loaded. */
     let PacemLoaderElement = class PacemLoaderElement extends pacemCore.Components.PacemElement {
         viewActivatedCallback() {
             super.viewActivatedCallback();
@@ -4080,6 +4152,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
                 return `<span class="${token.type}">${token.text}</span>`;
         }
     };
+    /** Parses Markdown into HTML, extended with C-like/script/markup code-fence highlighting and Pacem-specific inline embeds (`{tweet}(id)`, `{yt}(id)`). */
     class MarkdownService {
         constructor() {
             const grammar = [
@@ -4106,9 +4179,11 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             // no html allowed
             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);
         }
@@ -4121,6 +4196,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Renders its `value` property, interpreted as Markdown, as this element's inner HTML. */
     let PacemMarkdownElement = class PacemMarkdownElement extends pacemCore.Components.PacemElement {
         constructor(_md = new MarkdownService()) {
             super();
@@ -4133,9 +4209,11 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             }
         }
         // 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);
         }
@@ -4154,6 +4232,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Continuously scrolls its content horizontally in a loop, like a classic marquee. */
     let PacemMarqueeElement = class PacemMarqueeElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
@@ -4259,6 +4338,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
     const MEDIAQUERY_LANDSCAPE = `(orientation: landscape)`;
     const MEDIAQUERY_PREFERS_LIGHT = `(prefers-color-scheme: light)`;
     const MEDIAQUERY_PREFERS_DARK = `(prefers-color-scheme: dark)`;
+    /** Evaluates a CSS media query and reflects its match state, dispatching `change`/`match`/`unmatch` events as it changes. */
     let PacemMediaQueryElement = class PacemMediaQueryElement extends pacemCore.PacemEventTarget {
         constructor() {
             super(...arguments);
@@ -4325,9 +4405,11 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
     };
     var PacemMenuCursorElement_1;
     //namespace Components.UI {
+    /** Collapsible off-canvas/hamburger navigation menu, optionally synchronized with the enclosing shell's CSS classes. */
     let PacemMenuElement = class PacemMenuElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
+            /** Gets or sets whether the open/close and outset state toggle CSS classes on the ancestor shell. */
             this.synchronizeShell = true;
             this._stopPropagationHandlerConditional = (_) => {
                 if (!pacemCore.Utils.isNull(this._container) && !pacemCore.Utils.isNull(this._base)) {
@@ -4421,6 +4503,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             shadow: pacemCore.Defaults.USE_SHADOW_ROOT
         })
     ], PacemMenuElement);
+    /** Animated cursor/indicator that tracks the anchor matching the current path within an ancestor `PacemMenuElement`. */
     let PacemMenuCursorElement = PacemMenuCursorElement_1 = class PacemMenuCursorElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
@@ -4487,6 +4570,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Renders pagination buttons (first/previous/numbers/next/last, or a numeric-only strip) for a paged collection. */
     let PacemPagerElement = class PacemPagerElement extends pacemCore.Components.PacemElement {
         propertyChangedCallback(name, old, val, first) {
             super.propertyChangedCallback(name, old, val, first);
@@ -4597,6 +4681,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Declares a single `<source>` candidate (srcset/media/type) for an ancestor `PacemPictureElement`. */
     let PacemPictureSourceElement = class PacemPictureSourceElement extends pacemCore.Components.PacemItemElement {
         propertyChangedCallback(name, old, val, first) {
             super.propertyChangedCallback(name, old, val, first);
@@ -4620,6 +4705,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             tagName: pacemCore.P + '-picture-source'
         })
     ], PacemPictureSourceElement);
+    /** Responsive `<picture>` wrapper that builds its `<source>` elements from child `PacemPictureSourceElement` items. */
     let PacemPictureElement = class PacemPictureElement extends pacemCore.Components.PacemItemsContainerElement {
         constructor() {
             super('img', { 'label': 'picture' });
@@ -4658,6 +4744,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             }
             super.disconnectedCallback();
         }
+        /** Rebuilds the `<source>` elements from the current child `PacemPictureSourceElement` items. */
         refreshSources() {
             this._setSources();
         }
@@ -4752,6 +4839,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Horizontal progress bar with an optional textual caption. */
     let PacemProgressbarElement = class PacemProgressbarElement extends pacemCore.Components.PacemElement {
         constructor() {
             super('progressbar', { 'valuemin': '0%', 'valuemax': '100%', 'valuenow': '0%' });
@@ -4805,10 +4893,13 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Collapsible off-canvas drawer/sidebar, optionally synchronized with the enclosing shell's CSS classes. */
     let PacemSidebarElement = class PacemSidebarElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
+            /** Gets or sets whether the sidebar is open. */
             this.open = false;
+            /** Gets or sets whether the open/close state toggles CSS classes on the ancestor shell. */
             this.synchronizeShell = true;
         }
         propertyChangedCallback(name, old, val, first) {
@@ -4864,6 +4955,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Single slide item hosted within a `PacemSlideshowElement`. */
     let PacemSlideElement = class PacemSlideElement extends pacemCore.Components.PacemIterableElement {
     };
     PacemSlideElement = __decorate$a([
@@ -4871,6 +4963,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             tagName: pacemCore.P + '-slide'
         })
     ], PacemSlideElement);
+    /** Iterates over `PacemSlideElement` children, exposing them as a navigable slideshow. */
     let PacemSlideshowElement = class PacemSlideshowElement extends pacemCore.Components.PacemIterativeElement {
         validate(item) {
             return item instanceof PacemSlideElement;
@@ -4889,6 +4982,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI.Social {
+    /** Embeds a tweet, given its id, via Twitter's `widgets.js`. */
     let PacemTweetEmbedElement = class PacemTweetEmbedElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
@@ -4927,11 +5021,15 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Determines how a `PacemStickyHeaderElement` behaves once the scroll offset passes its `threshold`. */
     var StickyHeaderVisibility;
     (function (StickyHeaderVisibility) {
+        /** Stays pinned/visible once past the threshold. */
         StickyHeaderVisibility["Persistent"] = "persistent";
+        /** Hides while scrolling down and reappears while scrolling up. */
         StickyHeaderVisibility["QuickReturn"] = "quickreturn";
     })(StickyHeaderVisibility || (StickyHeaderVisibility = {}));
+    /** Header that reacts to page scroll, either staying pinned to the top of the shell or hiding/showing on scroll direction. */
     let PacemStickyHeaderElement = class PacemStickyHeaderElement extends pacemCore.PacemEventTarget {
         constructor() {
             super(...arguments);
@@ -5049,6 +5147,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         },
         retryConversionWhenReady: true
     };
+    /** Single tab item, pairing a `label` with its content, hosted within a `PacemTabsElement`. */
     let PacemTabElement = class PacemTabElement extends pacemCore.Components.PacemIterableElement {
         constructor() {
             super('tab');
@@ -5070,6 +5169,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             super.disconnectedCallback();
         }
         #content;
+        /** @readonly Gets the nodes assigned to the `label` slot. */
         get content() {
             return this.querySelectorAll('*[slot=label]');
         }
@@ -5088,6 +5188,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             tagName: pacemCore.P + '-tab', shadow: true, template: `<slot name="label" part="label"></slot><slot></slot>`
         })
     ], PacemTabElement);
+    /** Iterates over `PacemTabElement` children, rendering a tab strip (via an adapter) and animating the transition between the active tab's content. */
     let PacemTabsElement = class PacemTabsElement extends pacemCore.Components.PacemIterativeElement {
         constructor(_tweener = new pacemCore.Animations.TweenService()) {
             super("tablist");
@@ -5223,6 +5324,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Displays scrolling/ticking content, animating the swap whenever its `content` changes. */
     let PacemTickerElement = class PacemTickerElement extends pacemCore.Components.PacemSafeContentElement {
         constructor() {
             super(...arguments);
@@ -5302,10 +5404,13 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
     var PacemToastElement_1;
     //namespace Pacem.Components.UI {
     const PACEM_TOAST_POPS = "pacem:toast:pops";
+    /** Dismissible toast/snackbar notification, with optional autohide. */
     let PacemToastElement = PacemToastElement_1 = class PacemToastElement extends pacemCore.Components.PacemElement {
         constructor() {
             super(...arguments);
+            /** Gets or sets whether the toast automatically hides itself after `timeout` milliseconds. */
             this.autohide = true;
+            /** Gets or sets the autohide delay, in milliseconds. */
             this.timeout = 3000;
             this._doHide = (evt) => {
                 window.clearTimeout(this._handle);
@@ -5349,6 +5454,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
                 this._handle = window.setTimeout(() => { this.show = false; }, this.timeout);
             }
         }
+        /** Shows the toast, (re)starting the autohide timer if applicable. */
         popup() {
             if (this.show) {
                 this._show();
@@ -5428,6 +5534,13 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
                 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'];
@@ -5470,6 +5583,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Components.UI {
+    /** Table-of-contents that lists the headings/elements matched by `selector`, highlighting and scrolling to the currently focused one. */
     let PacemTocElement = class PacemTocElement extends pacemCore.Components.PacemElement {
         constructor(_tweener = new pacemCore.Animations.TweenService()) {
             super();
@@ -5647,11 +5761,14 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             y: cy + (r * Math.sin(theta))
         };
     }
+    /** Circular dial/knob control for picking a numeric value between `min` and `max` by rotating a handle. */
     let PacemTunerElement = class PacemTunerElement extends pacemCore.Components.PacemElement {
         constructor() {
             super();
             //#region INTERACTIVE
+            /** Gets or sets the minimum selectable value. */
             this.min = 0.0;
+            /** Gets or sets the maximum selectable value. */
             this.max = 100.0;
             this._rotateStartHandler = (evt) => {
                 const angle = this.#angle = this._getAngle(evt);
@@ -5838,7 +5955,9 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         return c > 3 && r && Object.defineProperty(target, key, r), r;
     };
     //namespace Pacem.Components.UI {
+    /** Triggers the device's vibration hardware (via the Vibration API) with a configurable pattern. */
     let PacemVibrateElement = class PacemVibrateElement extends pacemCore.PacemEventTarget {
+        /** Triggers a vibration using the current `pattern`, if supported by the browser and not disabled. */
         vibrate() {
             if (this.disabled) {
                 return;
@@ -5883,6 +6002,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
         convertBack: (prop) => (prop instanceof Element && prop.id) ? ('#' + prop.id) : prop,
         retryConversionWhenReady: true
     };
+    /** Fetches and renders remote HTML (or a local `<template>`'s content) as its own inner content, dispatching `prerender`/`render` lifecycle events. */
     let PacemViewElement = class PacemViewElement extends pacemCore.PacemEventTarget {
         constructor() {
             super(...arguments);
@@ -6097,6 +6217,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
     };
     //namespace Pacem.Components.UI {
     const HANDLE_CSS = 'window-title';
+    /** Container that arranges `PacemWindowElement` children as draggable/resizable floating windows, or docks them one at a time via an adapter. */
     let PacemWindowAreaElement = class PacemWindowAreaElement extends pacemCore.Components.PacemIterativeElement {
         constructor() {
             super(...arguments);
@@ -6181,6 +6302,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
                 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) {
@@ -6195,6 +6317,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             }
             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) {
@@ -6228,6 +6351,7 @@ css-class="{{ ['hour-start-'+ (^item.hour + 1), 'hour-end-'+ (^item.hour + ^item
             tagName: pacemCore.P + '-window-area'
         })
     ], PacemWindowAreaElement);
+    /** Single draggable, resizable, and dockable window pane hosted within a `PacemWindowAreaElement`. */
     let PacemWindowElement = class PacemWindowElement extends pacemCore.Components.PacemIterableElement {
         propertyChangedCallback(name, old, val, first) {
             super.propertyChangedCallback(name, old, val, first);