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

package/dist/esm/adapter.js

@@ -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
  */
@@ -9,21 +9,24 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-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';
 const { PacemElement, RepeaterItemCreateEventName, ItemRegisterEventName, ItemUnregisterEventName } = Components;
 //namespace Pacem.Components.UI {
+/** Orientation used by a {@link PacemAdapterElement} to interpret arrow-key navigation. */
 export var AdapterOrientation;
 (function (AdapterOrientation) {
     AdapterOrientation["Vertical"] = "vertical";
     AdapterOrientation["Horizontal"] = "horizontal";
 })(AdapterOrientation || (AdapterOrientation = {}));
 export const AdapterPageButtonRefreshEventName = 'pagerefresh';
+/** Event dispatched by {@link PacemAdapterElement} whenever a page/dashboard button needs to (re)compute its visible state or content. */
 export 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 Components.PacemAdapter {
     constructor() {
         super(...arguments);
@@ -33,10 +36,13 @@ let PacemAdapterElement = class PacemAdapterElement extends Components.PacemAdap
             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;
@@ -153,10 +159,7 @@ let PacemAdapterElement = class PacemAdapterElement extends Components.PacemAdap
         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;
@@ -164,13 +167,7 @@ let PacemAdapterElement = class PacemAdapterElement extends Components.PacemAdap
             // *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);
-            }
+            CustomElementUtils.whenReady(pager, fn);
         }
     }
     _tickVersion() {

package/dist/esm/anchor.js

@@ -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
  */
@@ -12,12 +12,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { P, PCSS, CustomElement, Watch, Utils, PropertyConverters, Components, PropertyChangeEvent } from '@pacem/pacem-core';
 //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 Components.PacemElement {
     constructor() {
         super('link');
         this._fetching = false;
     }
-    ///
+    /** @readonly Gets whether a `download` fetch is currently in progress. */
     get fetching() {
         return this._fetching;
     }

package/dist/esm/balloon.js

@@ -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
  */
@@ -12,12 +12,14 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { P, PCSS, CustomElement, Watch, Utils, PropertyConverters, Components, PropertyChangeEvent, ViewChild, stopPropagationHandler, preventDefaultHandler } from '@pacem/pacem-core';
 import { ElementOrPointPropertyConverter } from './types';
 //namespace Pacem.Components.UI {
+/** How a {@link PacemBalloonElement} behaves once popped up: a dismissible menu, a tooltip, or non-interactive. */
 export 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. */
 export var BalloonTrigger;
 (function (BalloonTrigger) {
     BalloonTrigger["Hover"] = "hover";
@@ -25,6 +27,7 @@ export var BalloonTrigger;
     BalloonTrigger["ContextMenu"] = "contextmenu";
     BalloonTrigger["Focus"] = "focus";
 })(BalloonTrigger || (BalloonTrigger = {}));
+/** Cross-axis alignment of a {@link PacemBalloonElement} relative to its `target`. */
 export var BalloonAlignment;
 (function (BalloonAlignment) {
     BalloonAlignment["Start"] = "start";
@@ -32,6 +35,7 @@ export var BalloonAlignment;
     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). */
 export var BalloonPosition;
 (function (BalloonPosition) {
     BalloonPosition["Top"] = "top";
@@ -42,12 +46,15 @@ export var BalloonPosition;
     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. */
 export 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). */
 export const BalloonPopupEventName = 'popup';
+/** Event name fired by {@link PacemBalloonElement} once it has finished popping out (after the hide transition). */
 export const BalloonPopoutEventName = 'popout';
 const BalloonConsts = {
     Defaults: {
@@ -65,6 +72,7 @@ const BalloonConsts = {
 };
 const positioningStyles = 'balloon-right balloon-left balloon-bottom balloon-top balloon-start balloon-center balloon-end';
 const allStyles = 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 Components.PacemElement {
     constructor() {
         super(...arguments);

package/dist/esm/binder.js

@@ -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
  */
@@ -13,6 +13,7 @@ import { P, PCSS, CustomElement, Watch, Utils, PropertyConverters, Components, C
 import { Point } from '@pacem/pacem-foundation';
 import { ElementOrPointPropertyConverter } from './types';
 // namespace Pacem.Components.UI {
+/** Edge (or center) of an element a {@link PacemBinderElement} curve attaches to. */
 export var BinderAnchor;
 (function (BinderAnchor) {
     BinderAnchor["Auto"] = "auto";
@@ -22,6 +23,7 @@ export var BinderAnchor;
     BinderAnchor["Bottom"] = "bottom";
     BinderAnchor["Center"] = "center";
 })(BinderAnchor || (BinderAnchor = {}));
+/** Decoration drawn at either end of a {@link PacemBinderElement} curve. */
 export var BinderEnd;
 (function (BinderEnd) {
     BinderEnd["Default"] = "default";
@@ -29,18 +31,22 @@ export var BinderEnd;
     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. */
 export 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.). */
 export const BinderInteractionEventName = 'interact';
+/** Event dispatched by a {@link PacemBinderElement} wrapping the original user-interaction event on its path. */
 export class BinderInteractionEvent extends 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 = [];
@@ -58,6 +64,7 @@ class BindersCollector {
         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() {
@@ -110,6 +117,7 @@ class BinderUtils {
     }
 }
 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 Components.PacemElement {
     constructor() {
         super(...arguments);
@@ -224,6 +232,7 @@ let PacemBinderElement = class PacemBinderElement extends Components.PacemElemen
             });
         }
     }
+    /** 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 (!Utils.isNull(svg)) {
@@ -535,6 +544,7 @@ let PacemBinderElement = class PacemBinderElement extends Components.PacemElemen
         }
         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 (Utils.isNull(element) || Utils.isNull(path = this._path)) {

package/dist/esm/blade.js

@@ -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
  */
@@ -12,6 +12,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { P, CustomElement, Watch, Utils, PropertyConverters, Components } from '@pacem/pacem-core';
 // namespace Pacem.Components.UI {
 const OPEN_CSSCLASS = 'blade-open';
+/** Slide-in panel toggled via its `open` property, dispatching `open`/`close` events as it transitions. */
 let PacemBladeElement = class PacemBladeElement extends Components.PacemElement {
     propertyChangedCallback(name, old, val, first) {
         super.propertyChangedCallback(name, old, val, first);

package/dist/esm/bottom-sheet.js

@@ -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
  */
@@ -12,6 +12,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { P, PCSS, CustomElement, Watch, Utils, PropertyConverters, Components, preventDefaultHandler, ViewChild, CustomElementUtils, UI } from '@pacem/pacem-core';
 // 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 Components.PacemElement {
     constructor() {
         super(...arguments);
@@ -44,7 +45,7 @@ let PacemBottomSheetHandleElement = class PacemBottomSheetHandleElement extends
     disconnectedCallback() {
         this.removeEventListener('click', this._clickHandler);
         const bs = this.#bottomSheet;
-        if (!Utils.isNull(bs)) {
+        if (!Utils.isNull(bs) && bs.isReady) {
             bs._setHandle(null);
         }
         this.#bottomSheet = null;
@@ -56,9 +57,13 @@ let PacemBottomSheetHandleElement = class PacemBottomSheetHandleElement extends
         if (Utils.isNull(bs)) {
             return;
         }
-        const id = Utils.isNullOrEmpty(this.id) ? (this.id = ('handle_' + Utils.uniqueCode())) : this.id;
-        bs._setHandle(this);
-        this.addEventListener('click', this._clickHandler, false);
+        if (Utils.isNullOrEmpty(this.id)) {
+            this.id = ('handle_' + Utils.uniqueCode());
+        }
+        CustomElementUtils.whenReady(bs, () => {
+            bs._setHandle(this);
+            this.addEventListener('click', this._clickHandler, false);
+        });
     }
     _toggleHandle(disabled = this.disabled) {
         this.style.pointerEvents = disabled ? 'none' : '';
@@ -84,6 +89,7 @@ PacemBottomSheetHandleElement = __decorate([
     })
 ], PacemBottomSheetHandleElement);
 export { 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 Components.PacemElement {
     constructor() {
         super(...arguments);
@@ -142,7 +148,7 @@ let PacemBottomSheetElement = class PacemBottomSheetElement extends Components.P
             swiper.disabled = disabled;
         }
     }
-    /** @internal */
+    /** @internal Wires (or clears) the swiper's drag handle selector to the given {@link PacemBottomSheetHandleElement}. */
     _setHandle(handle) {
         if (Utils.isNull(handle)) {
             this._swiper.handleSelector = null;

package/dist/esm/button.js

@@ -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
  */
@@ -12,6 +12,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { P, PCSS, CustomElement, Watch, Utils, PropertyConverters, Components, CommandEvent } from '@pacem/pacem-core';
 import { DialogButton } from './dialog-abstractions';
 //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 Components.PacemIterableElement {
     constructor() {
         super('button');

package/dist/esm/buttonset.js

@@ -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
  */
@@ -12,6 +12,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { P, CustomElement, Components } from '@pacem/pacem-core';
 import { PacemButtonElement } from './button';
 //namespace Pacem.Components.UI {
+/** Groups {@link PacemButtonElement} children into a single iterable/selectable set, focusing the item matching `index`. */
 let PacemButtonsetElement = class PacemButtonsetElement extends Components.PacemIterativeElement {
     connectedCallback() {
         super.connectedCallback();

package/dist/esm/calendar.js

@@ -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
  */
@@ -11,22 +11,26 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { P, PCSS, CustomElement, Watch, ViewChild, Utils, PropertyConverters, Components, CustomTypedEvent, PropertyChangeEvent, Defaults, CustomElementUtils, Debounce, PropertyChangeEventName } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Granularity of a calendar/schedule/agenda view. */
 export 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. */
 export class ViewDateChangeEvent extends CustomTypedEvent {
     constructor(date) {
         super('viewdatechange', date);
     }
 }
+/** Event dispatched (and bubbling) when a day is selected on a {@link PacemCalendarElement}, carrying the selected date. */
 export class DateSelectEvent extends 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. */
 export class TimeSelectEvent extends CustomTypedEvent {
     constructor(date) {
         super('timeselect', date, { bubbles: true });
@@ -39,6 +43,7 @@ const DAY_HOURS = [0, 0.5, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 5.5, 6, 6.5, 7, 7.
 let now = new Date();
 const DUMMY_DATE = 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 Components.PacemItemElement {
     propertyChangedCallback(name, old, val, first) {
         super.propertyChangedCallback(name, old, val, first);
@@ -73,16 +78,19 @@ PacemCalendarEventElement = __decorate([
     })
 ], PacemCalendarEventElement);
 export { PacemCalendarEventElement };
+/** Event dispatched when a {@link PacemCalendarEventElement} rendering gains focus/selection within its host calendar. */
 export class CalendarEventSelectEvent extends CustomTypedEvent {
     constructor(args) {
         super("eventselect", args, { bubbles: false, cancelable: true });
     }
 }
+/** Event dispatched when a {@link PacemCalendarEventElement} rendering loses focus/selection within its host calendar. */
 export class CalendarEventUnselectEvent extends 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. */
 export class PacemCalendarBaseElement extends Components.PacemItemsContainerElement {
     validate(item) {
         return item instanceof PacemCalendarEventElement;
@@ -240,11 +248,13 @@ __decorate([
 __decorate([
     Watch({ converter: 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`. */
 export 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;
     }
@@ -323,6 +333,7 @@ function buildAgendaGrid() {
     }
     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);
@@ -384,6 +395,7 @@ let PacemAgendaElement = class PacemAgendaElement extends PacemCalendarWithEvent
         }
         return ds;
     }
+    /** @readonly Gets the computed all-day row of positioned event items ready for rendering. */
     get allDayDatasource() {
         return this._allDayDatasource;
     }
@@ -454,6 +466,7 @@ function buildCalendarGrid() {
     }
     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;
@@ -525,6 +538,7 @@ PacemCalendarElement = __decorate([
 export { 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 Components.PacemElement {
 };
 __decorate([
@@ -544,6 +558,7 @@ function buildCalendarHeader() {
     const id = "dock_" + 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();
@@ -581,6 +596,7 @@ PacemScheduleElement = __decorate([
 export { 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}). */
 export class PacemCalendarRuleBaseElement extends HTMLElement {
     constructor() {
         super(...arguments);
@@ -597,6 +613,7 @@ export class PacemCalendarRuleBaseElement extends HTMLElement {
     disconnectedCallback() {
         this._target = undefined;
     }
+    /** @readonly Gets the ancestor calendar element this rule applies its disabled ranges to. */
     get target() {
         return this._target;
     }
@@ -624,6 +641,7 @@ export class PacemCalendarRuleBaseElement extends HTMLElement {
 __decorate([
     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);

package/dist/esm/collapse.js

@@ -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
  */
@@ -11,6 +11,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { P, PCSS, CustomElement, Watch, ViewChild, Utils, PropertyConverters, PacemEventTarget, Components } from '@pacem/pacem-core';
 //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 PacemEventTarget {
     constructor() {
         super(...arguments);

package/dist/esm/dialog-abstractions.js

@@ -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
  */
@@ -11,6 +11,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { Watch, Utils, Components, CustomTypedEvent, Logging, avoidHandler } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Set of buttons shown by a dialog (e.g. {@link PacemDialogBase}), controlling which {@link DialogButton}s are visible. */
 export var DialogButtons;
 (function (DialogButtons) {
     DialogButtons["YesNo"] = "yesno";
@@ -18,6 +19,7 @@ export var DialogButtons;
     DialogButtons["Ok"] = "ok";
     DialogButtons["OkCancel"] = "okcancel";
 })(DialogButtons || (DialogButtons = {}));
+/** Single button a dialog can be committed/closed with. */
 export var DialogButton;
 (function (DialogButton) {
     DialogButton["Yes"] = "yes";
@@ -25,14 +27,18 @@ export var DialogButton;
     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. */
 export 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. */
 export class DialogResultEvent extends 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. */
 export class PacemDialogBase extends 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 (!Utils.isNull(this.#deferred)) {
@@ -50,6 +56,7 @@ export class PacemDialogBase extends Components.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) {
         avoidHandler(evt);
         this.log(Logging.LogLevel.Debug, `Committing dialog by clicking '${btn}'.`);

package/dist/esm/dialog.js

@@ -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
  */
@@ -12,13 +12,19 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { P, PCSS, Defaults, CustomElement, ViewChild, Watch, PropertyConverters } from '@pacem/pacem-core';
 import { PacemDialogBase, DialogButtons } from './dialog-abstractions';
 //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) {
@@ -55,7 +61,7 @@ let PacemDialogElement = class PacemDialogElement extends PacemDialogBase {
         //    }
         //});
     }
-    /** 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 {

package/dist/esm/divider.js

@@ -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
  */
@@ -11,6 +11,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { P, CustomElement, Watch, Utils, PropertyConverters, Components } from '@pacem/pacem-core';
 //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 Components.PacemElement {
     constructor() {
         super('separator');

package/dist/esm/icon.js

@@ -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
  */
@@ -91,6 +91,7 @@ function getIconMarkup(icon) {
         }
     });
 }
+/** 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 Components.PacemElement {
     constructor() {
         super('', { hidden: 'true' });

package/dist/esm/image.js

@@ -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
  */
@@ -11,6 +11,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { P, CustomElement, Watch, Utils, PropertyConverters, Components } from '@pacem/pacem-core';
 //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 Components.PacemElement {
     constructor() {
         super('img');

package/dist/esm/index-components-ui.js

@@ -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
  */

package/dist/esm/index-components.js

@@ -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
  */

package/dist/esm/index-iife.js

@@ -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
  */

package/dist/esm/index.js

@@ -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
  */