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

package/dist/esm/infinite-scroller.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, Debounce, CustomElement, Watch, Utils, PropertyConverters, PacemEventTarget } from '@pacem/pacem-core';
 //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 PacemEventTarget {
     constructor() {
         super();
@@ -51,6 +52,7 @@ let PacemInfiniteScrollerElement = class PacemInfiniteScrollerElement extends Pa
                 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;

package/dist/esm/iterative.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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,21 +11,26 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { Watch, Utils, PropertyConverters, Components } from '@pacem/pacem-core';
 //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`). */
 export class PacemAdaptedIterativeElement extends 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 (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 (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 (Utils.isNull(this.datasource) || this.datasource.length == 0)
             return false;

package/dist/esm/lightbox-abstractions.js

@@ -1,9 +1,10 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (https://js.pacem.it)
+ * @pacem/pacem-ui v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
 //namespace Pacem.Components.UI {
+/** How a {@link Lightbox} reacts to a click outside its content. */
 export var LightboxBehavior;
 (function (LightboxBehavior) {
     LightboxBehavior["ClickOutsideClose"] = "clickOutsideClose";

package/dist/esm/lightbox.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (https://js.pacem.it)
+ * @pacem/pacem-ui v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
@@ -14,6 +14,7 @@ import { LightboxBehavior } from './lightbox-abstractions';
 import { PacemButtonElement } from './button';
 //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 Components.PacemElement {
     constructor() {
         super(...arguments);

package/dist/esm/loader.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, Components, Defaults } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Visual style of a {@link PacemLoaderElement}'s spinner. */
 export var LoaderType;
 (function (LoaderType) {
     LoaderType["Spinner"] = "spin";
@@ -18,6 +19,7 @@ export var LoaderType;
     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 Components.PacemElement {
     viewActivatedCallback() {
         super.viewActivatedCallback();

package/dist/esm/markdown-svc.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (https://js.pacem.it)
+ * @pacem/pacem-ui v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
@@ -205,6 +205,7 @@ const RULES_TO_HTML = (token) => {
             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)`). */
 export class MarkdownService {
     constructor() {
         const grammar = [
@@ -231,9 +232,11 @@ export class MarkdownService {
         // 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);
     }

package/dist/esm/markdown.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, PropertyConverters, Components } from '@pacem/pacem-core';
 import { MarkdownService } from './markdown-svc';
 //namespace Pacem.Components.UI {
+/** Renders its `value` property, interpreted as Markdown, as this element's inner HTML. */
 let PacemMarkdownElement = class PacemMarkdownElement extends Components.PacemElement {
     constructor(_md = new MarkdownService()) {
         super();
@@ -24,9 +25,11 @@ let PacemMarkdownElement = class PacemMarkdownElement extends Components.PacemEl
         }
     }
     // 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);
     }

package/dist/esm/marquee.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, Utils, CustomElement, Watch, ViewChild, PropertyConverters, Components, Defaults } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Continuously scrolls its content horizontally in a loop, like a classic marquee. */
 let PacemMarqueeElement = class PacemMarqueeElement extends Components.PacemElement {
     constructor() {
         super(...arguments);

package/dist/esm/media-query.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (https://js.pacem.it)
+ * @pacem/pacem-ui v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
@@ -30,6 +30,7 @@ export const MEDIAQUERY_PORTRAIT = `(orientation: portrait)`;
 export const MEDIAQUERY_LANDSCAPE = `(orientation: landscape)`;
 export const MEDIAQUERY_PREFERS_LIGHT = `(prefers-color-scheme: light)`;
 export 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 PacemEventTarget {
     constructor() {
         super(...arguments);

package/dist/esm/menu.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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,9 +12,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var PacemMenuCursorElement_1;
 import { P, PCSS, Utils, CustomElement, Watch, ViewChild, PropertyConverters, Components, Defaults, avoidHandler, stopPropagationHandler, CustomElementUtils, Logging } from '@pacem/pacem-core';
 //namespace Components.UI {
+/** Collapsible off-canvas/hamburger navigation menu, optionally synchronized with the enclosing shell's CSS classes. */
 let PacemMenuElement = class PacemMenuElement extends 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 (!Utils.isNull(this._container) && !Utils.isNull(this._base)) {
@@ -109,6 +111,7 @@ PacemMenuElement = __decorate([
     })
 ], PacemMenuElement);
 export { PacemMenuElement };
+/** Animated cursor/indicator that tracks the anchor matching the current path within an ancestor `PacemMenuElement`. */
 let PacemMenuCursorElement = PacemMenuCursorElement_1 = class PacemMenuCursorElement extends Components.PacemElement {
     constructor() {
         super(...arguments);

package/dist/esm/pager.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, Utils, CustomElement, Watch, ViewChild, PropertyConverters, Components, Defaults, Debounce } from '@pacem/pacem-core';
 //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 Components.PacemElement {
     propertyChangedCallback(name, old, val, first) {
         super.propertyChangedCallback(name, old, val, first);

package/dist/esm/picture.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, Utils, CustomElement, Watch, ViewChild, PropertyConverters, Components } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Declares a single `<source>` candidate (srcset/media/type) for an ancestor `PacemPictureElement`. */
 let PacemPictureSourceElement = class PacemPictureSourceElement extends Components.PacemItemElement {
     propertyChangedCallback(name, old, val, first) {
         super.propertyChangedCallback(name, old, val, first);
@@ -35,6 +36,7 @@ PacemPictureSourceElement = __decorate([
     })
 ], PacemPictureSourceElement);
 export { PacemPictureSourceElement };
+/** Responsive `<picture>` wrapper that builds its `<source>` elements from child `PacemPictureSourceElement` items. */
 let PacemPictureElement = class PacemPictureElement extends Components.PacemItemsContainerElement {
     constructor() {
         super('img', { 'label': 'picture' });
@@ -73,6 +75,7 @@ let PacemPictureElement = class PacemPictureElement extends Components.PacemItem
         }
         super.disconnectedCallback();
     }
+    /** Rebuilds the `<source>` elements from the current child `PacemPictureSourceElement` items. */
     refreshSources() {
         this._setSources();
     }

package/dist/esm/progressbar.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, Utils, CustomElement, Watch, ViewChild, PropertyConverters, Components, Defaults } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Horizontal progress bar with an optional textual caption. */
 let PacemProgressbarElement = class PacemProgressbarElement extends Components.PacemElement {
     constructor() {
         super('progressbar', { 'valuemin': '0%', 'valuemax': '100%', 'valuenow': '0%' });

package/dist/esm/sidebar.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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,10 +11,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { P, PCSS, Utils, CustomElement, Watch, PropertyConverters, Components, CustomElementUtils } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Collapsible off-canvas drawer/sidebar, optionally synchronized with the enclosing shell's CSS classes. */
 let PacemSidebarElement = class PacemSidebarElement extends 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) {

package/dist/esm/slideshow.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, Components } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Single slide item hosted within a `PacemSlideshowElement`. */
 let PacemSlideElement = class PacemSlideElement extends Components.PacemIterableElement {
 };
 PacemSlideElement = __decorate([
@@ -19,6 +20,7 @@ PacemSlideElement = __decorate([
     })
 ], PacemSlideElement);
 export { PacemSlideElement };
+/** Iterates over `PacemSlideElement` children, exposing them as a navigable slideshow. */
 let PacemSlideshowElement = class PacemSlideshowElement extends Components.PacemIterativeElement {
     validate(item) {
         return item instanceof PacemSlideElement;

package/dist/esm/social-twitter.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, CustomElementUtils, CustomElement, Watch, PropertyConverters, Components } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI.Social {
+/** Embeds a tweet, given its id, via Twitter's `widgets.js`. */
 let PacemTweetEmbedElement = class PacemTweetEmbedElement extends Components.PacemElement {
     constructor() {
         super(...arguments);

package/dist/esm/sticky-header.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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,11 +11,15 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { P, CustomElementUtils, CustomElement, Watch, PropertyConverters, PacemEventTarget, Components, Utils, Logging } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Determines how a `PacemStickyHeaderElement` behaves once the scroll offset passes its `threshold`. */
 export 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 PacemEventTarget {
     constructor() {
         super(...arguments);

package/dist/esm/tabs.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (https://js.pacem.it)
+ * @pacem/pacem-ui v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
@@ -22,6 +22,7 @@ const StringOrNodePropertyConverter = {
     },
     retryConversionWhenReady: true
 };
+/** Single tab item, pairing a `label` with its content, hosted within a `PacemTabsElement`. */
 let PacemTabElement = class PacemTabElement extends Components.PacemIterableElement {
     constructor() {
         super('tab');
@@ -43,6 +44,7 @@ let PacemTabElement = class PacemTabElement extends Components.PacemIterableElem
         super.disconnectedCallback();
     }
     #content;
+    /** @readonly Gets the nodes assigned to the `label` slot. */
     get content() {
         return this.querySelectorAll('*[slot=label]');
     }
@@ -62,6 +64,7 @@ PacemTabElement = __decorate([
     })
 ], PacemTabElement);
 export { 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 Components.PacemIterativeElement {
     constructor(_tweener = new Animations.TweenService()) {
         super("tablist");

package/dist/esm/ticker.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, ViewChild, Components, Utils } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Displays scrolling/ticking content, animating the swap whenever its `content` changes. */
 let PacemTickerElement = class PacemTickerElement extends Components.PacemSafeContentElement {
     constructor() {
         super(...arguments);

package/dist/esm/toast.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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,10 +13,13 @@ var PacemToastElement_1;
 import { P, PCSS, CustomElement, Watch, Components, Utils, PropertyConverters, CustomElementUtils, Transformer } from '@pacem/pacem-core';
 //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 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);
@@ -60,6 +63,7 @@ let PacemToastElement = PacemToastElement_1 = class PacemToastElement extends Co
             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();
@@ -139,6 +143,13 @@ let PacemToastElement = PacemToastElement_1 = class PacemToastElement extends Co
             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'];

package/dist/esm/toc.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, Components, Utils, PropertyConverters, Defaults, Animations, Debounce, avoidHandler } from '@pacem/pacem-core';
 //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 Components.PacemElement {
     constructor(_tweener = new Animations.TweenService()) {
         super();

package/dist/esm/tuner.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (https://js.pacem.it)
+ * @pacem/pacem-ui v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
@@ -19,11 +19,14 @@ function cartesian(cx, cy, r, theta) {
         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 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);

package/dist/esm/types.js

@@ -1,8 +1,9 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (https://js.pacem.it)
+ * @pacem/pacem-ui v1.0.0-binet (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
+/** Converts an attribute value into an `Element` (resolved via `querySelector`) or, failing that, a parsed `Point`/JSON value. */
 export const ElementOrPointPropertyConverter = {
     convert: (attr) => {
         let el = document.querySelector(attr);

package/dist/esm/vibration.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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,7 +11,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { P, CustomElement, Watch, PacemEventTarget, Utils } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
+/** Triggers the device's vibration hardware (via the Vibration API) with a configurable pattern. */
 let PacemVibrateElement = class PacemVibrateElement extends PacemEventTarget {
+    /** Triggers a vibration using the current `pattern`, if supported by the browser and not disabled. */
     vibrate() {
         if (this.disabled) {
             return;

package/dist/esm/view.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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,7 +9,7 @@ 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, CustomElement, Watch, PacemEventTarget, Components, Utils, PropertyConverters, Logging } from '@pacem/pacem-core';
+import { P, CustomElement, Watch, PacemEventTarget, Components, Utils, PropertyConverters, Logging, CustomElementUtils } from '@pacem/pacem-core';
 //namespace Pacem.Components.UI {
 const ANIM_TIMEOUT = 500;
 const ElementOrStringPropertyConverter = {
@@ -24,6 +24,7 @@ const ElementOrStringPropertyConverter = {
     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 PacemEventTarget {
     constructor() {
         super(...arguments);
@@ -31,6 +32,18 @@ let PacemViewElement = class PacemViewElement extends PacemEventTarget {
             const tmplProxy = evt.target;
             this._setTmpl(tmplProxy.target);
         };
+        this._debounceDispatchHandler = (e) => {
+            clearTimeout(this.#resizeHandle);
+            this.#resizeHandle = setTimeout(() => {
+                if (e) {
+                    const resizer = e.srcElement;
+                    resizer.removeEventListener(Components.ResizeEventName, this._debounceDispatchHandler);
+                    resizer.remove();
+                }
+                //
+                this.dispatchEvent(new CustomEvent("render"));
+            }, 100 /* tenth of a second limit */);
+        };
     }
     propertyChangedCallback(name, old, val, first) {
         super.propertyChangedCallback(name, old, val, first);
@@ -99,6 +112,7 @@ let PacemViewElement = class PacemViewElement extends PacemEventTarget {
         cancelAnimationFrame(this._renderHandle);
         // this way, `this._container.innerHTML = ''` instruction will eventually let the page "scroll up"...
         this.innerHTML = '';
+        this._dispatchPrerender();
         this._renderHandle = requestAnimationFrame(() => {
             if (Utils.isNull(tmpl)) {
                 this.log(Logging.LogLevel.Error, `Template element not found.`);
@@ -170,6 +184,7 @@ let PacemViewElement = class PacemViewElement extends PacemEventTarget {
         cancelAnimationFrame(this._renderHandle);
         this.scrollTo({ top: 0, left: 0, behavior: 'instant' });
         this.innerHTML = '';
+        this._dispatchPrerender();
         this._renderHandle = requestAnimationFrame(() => {
             this.innerHTML = result;
             this.fetching = false;
@@ -181,8 +196,16 @@ let PacemViewElement = class PacemViewElement extends PacemEventTarget {
             }, ANIM_TIMEOUT);
         });
     }
+    #resizeHandle;
     _dispatchRender() {
-        this.dispatchEvent(new CustomEvent("render"));
+        const resizer = new Components.PacemResizeElement();
+        resizer.target = this;
+        resizer.addEventListener(Components.ResizeEventName, this._debounceDispatchHandler);
+        CustomElementUtils.findAncestorShell(this).appendChild(resizer);
+        this._debounceDispatchHandler();
+    }
+    _dispatchPrerender() {
+        this.dispatchEvent(new CustomEvent("prerender"));
     }
 };
 __decorate([

package/dist/esm/window.js

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem-ui v1.0.0-bernoulli (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, Components, UI, Utils, PropertyConverter
 import { AdapterPageButtonRefreshEventName } from './adapter';
 //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 Components.PacemIterativeElement {
     constructor() {
         super(...arguments);
@@ -97,6 +98,7 @@ let PacemWindowAreaElement = class PacemWindowAreaElement extends Components.Pac
             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) {
@@ -111,6 +113,7 @@ let PacemWindowAreaElement = class PacemWindowAreaElement extends Components.Pac
         }
         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) {
@@ -145,6 +148,7 @@ PacemWindowAreaElement = __decorate([
     })
 ], PacemWindowAreaElement);
 export { PacemWindowAreaElement };
+/** Single draggable, resizable, and dockable window pane hosted within a `PacemWindowAreaElement`. */
 let PacemWindowElement = class PacemWindowElement extends Components.PacemIterableElement {
     propertyChangedCallback(name, old, val, first) {
         super.propertyChangedCallback(name, old, val, first);