@pacem/pacem 1.0.5 → 1.0.6-mersenne

package/dist/typings/index.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @pacem/pacem v1.0.5 (https://js.pacem.it)
+ * @pacem/pacem v1.0.6-mersenne (https://js.pacem.it)
  * Pacem (https://pacem.it)
  * Licensed under Apache-2.0
  */
@@ -9935,6 +9935,7 @@ declare class PacemRepeaterElement extends PacemEventTarget implements Repeater
     private _fragment;
     /** Removes the rendered item at the given index. */
     removeItem(index: number): void;
+    /** Builds (or rebuilds) the item at `index` into `frag`; the relevant `RepeaterItemCreateEvent` gets dispatched by the caller, once the fragment is in the DOM. */
     private _setItem;
     private _removeItems;
     private _setupItem;
@@ -14869,6 +14870,60 @@ declare type WGSLModifierDelegates = {
 /** Which pipeline stage a {@link Pacem3DWgslScriptElement}/{@link WGSLModifierDelegates} snippet customizes. */
 declare type WGSLModifierScriptType = 'vertex-input' | 'vertex-output' | 'fragment';
 
+declare global {
+    interface Array<T> {
+        /**
+         * Moves an item within the array, shifting the other items accordingly.
+         * @param from Index of the item to move.
+         * @param to Destination index.
+         */
+        moveWithin(from: number, to: number): void;
+        /** Checks content equality between arrays. */
+        equalsContent(other: T[]): boolean;
+        /**
+         * Mutates this array in-place so its content matches `other`, only touching indexes whose value actually changed (and trimming/growing length as needed).
+         * @param other Array whose content is to be cloned into this one.
+         */
+        cloneFrom(other: T[]): void;
+        /**
+         * Returns the union (set union, duplicates removed) of this array and `other`.
+         * @param other Array to union with.
+         * @returns A new array with the distinct items of both arrays.
+         */
+        union(other: T[]): T[];
+        /** Returns a new array with duplicate items removed, preserving the first occurrence's order. */
+        distinct(): T[];
+    }
+}
+
+declare global {
+    interface Number {
+        /**
+         * Checks whether this number is close enough to `other`, within a given decimal precision.
+         * @param other Number to compare against.
+         * @param precision Number of decimal digits of tolerance (defaults to 14).
+         * @returns Whether the two numbers are close to each other.
+         */
+        isCloseTo(other: number, precision?: number): boolean;
+        /**
+         * Rounds this number to a given number of decimal digits.
+         * @param precision Number of decimal digits to keep (defaults to 14).
+         * @returns The rounded value.
+         */
+        roundoff(precision?: number): number;
+        /**
+         * Clamps this number between a minimum and a maximum value.
+         * @param min Lower bound (ignored if `null`/`NaN`).
+         * @param max Upper bound (ignored if `null`/`NaN`).
+         * @returns The clamped value.
+         */
+        clamp(min: number, max: number): any;
+        /** Converts this number into its base-62 string representation (digits + uppercase + lowercase letters). */
+        toBase62(): string;
+        /** Converts this number into its base-36 string representation. */
+        toBase36(): string;
+    }
+}
 
 
 declare global {

package/dist/vscode.html-custom.json

@@ -939,7 +939,7 @@
       "name": "pacem-binder",
       "description": {
         "kind": "markdown",
-        "value": "**@pacem/pacem-ui**\n\nEdge (or center) of an element a {@link PacemBinderElement} curve attaches to. */ export enum BinderAnchor { Auto = 'auto', Left = 'left', Top = 'top', Right = 'right', Bottom = 'bottom', Center = 'center' } /** Decoration drawn at either end of a {@link PacemBinderElement} curve. */ export enum BinderEnd { Default = 'default', Arrow = 'arrow', FatArrow = 'fatarrow', None = 'none', } /** How a {@link PacemBinderElement} computes its Bezier control points: from the elements' mass (size) or from the path direction. */ export enum BinderTension { Mass = 'mass', Path = 'path' } /** 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<null> { constructor(orig: MouseEvent | KeyboardEvent | TouchEvent) { super(BinderInteractionEventName, null, orig); } } const UI_BINDERS: string = '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: Element) { const watcher = this.resize = new Components.PacemResizeElement(); watcher.target = element; watcher.watchPosition = true; document.body.appendChild(watcher); } resize: Components.PacemResizeElement; binders: PacemBinderElement[] = []; dispose() { this.resize.remove(); } fire = (evt: Components.ResizeEvent) => { for (var binder of this.binders) { binder.refresh(this.resize.target, evt.detail); } } } /** Static registry pairing endpoint elements with their {@link BindersCollector}, plus a page-wide resize listener keeping every registered {@link PacemBinderElement} in sync. */ class BinderUtils { private static _pageBinders: PacemBinderElement[] = []; private static _bodyResizeListener: Components.PacemResizeElement; private static _updateResizeListener() { const binders = this._pageBinders; if (Utils.isNull(this._bodyResizeListener)) { const resize = this._bodyResizeListener = new Components.PacemResizeElement(); resize.target = document.body; document.body.appendChild(resize); document.addEventListener(Components.ResizeEventName, () => { for (let binder of binders) { binder.invalidateSize(); } }, false); } this._bodyResizeListener.disabled = binders.length === 0; } static register(element: Element, binder: PacemBinderElement) { var collector: BindersCollector = CustomElementUtils.getAttachedPropertyValue(element, UI_BINDERS), binders = this._pageBinders; if (Utils.isNull(collector)) { collector = new BindersCollector(element); CustomElementUtils.setAttachedPropertyValue(element, UI_BINDERS, collector); } if (collector.binders.indexOf(binder) == -1) { if (collector.binders.length === 0) { collector.resize.addEventListener(Components.ResizeEventName, collector.fire, false); } //else { binder.refresh(element, collector.resize.currentSize); //} collector.binders.push(binder); } if (binders.indexOf(binder) === -1) { binders.push(binder); this._updateResizeListener(); } } static unregister(element: Element, binder: PacemBinderElement) { var collector: BindersCollector = CustomElementUtils.getAttachedPropertyValue(element, UI_BINDERS), ndx: number, binders = this._pageBinders, ndx2: number; if (!Utils.isNull(collector) && (ndx = collector.binders.indexOf(binder)) > -1) { collector.binders.splice(ndx, 1); if (collector.binders.length === 0) { collector.resize.removeEventListener(Components.ResizeEventName, collector.fire, false); collector.dispose(); CustomElementUtils.deleteAttachedPropertyValue(element, UI_BINDERS); } } if ((ndx2 = binders.indexOf(binder)) >= 0) { binders.splice(ndx2, 1); this._updateResizeListener(); } } } type PacemBinderTarget = ElementOrPoint; 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."
+        "value": "**@pacem/pacem-ui**\n\nEdge (or center) of an element a {@link PacemBinderElement} curve attaches to. */ export enum BinderAnchor { Auto = 'auto', Left = 'left', Top = 'top', Right = 'right', Bottom = 'bottom', Center = 'center' } /** Decoration drawn at either end of a {@link PacemBinderElement} curve. */ export enum BinderEnd { Default = 'default', Arrow = 'arrow', FatArrow = 'fatarrow', None = 'none', } /** How a {@link PacemBinderElement} computes its Bezier control points: from the elements' mass (size) or from the path direction. */ export enum BinderTension { Mass = 'mass', Path = 'path' } /** 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<null> { constructor(orig: MouseEvent | KeyboardEvent | TouchEvent) { super(BinderInteractionEventName, null, orig); } } const UI_BINDERS: string = 'pacem:components:ui:binders'; /** Tracks the {@link PacemBinderElement} instances bound to a single endpoint element, refreshing them all on that element's resize/reposition (or as soon as it stops animating). */ class BindersCollector { constructor(element: Element) { const watcher = this.resize = new Components.PacemResizeElement(); watcher.target = element; watcher.watchPosition = true; document.body.appendChild(watcher); // an element might turn visible leaving its size and position untouched - e.g. while fading in - // and binders skip invisible endpoints (see `_draw`): they need a nudge once the animation is over. if (element instanceof HTMLElement || element instanceof SVGElement) { Utils.addAnimationEndCallback(element, this.refresh); } } resize: Components.PacemResizeElement; binders: PacemBinderElement[] = []; dispose() { this.resize.remove(); } /** Refreshes the bound binders against the target's latest known size. */ refresh = () => { for (var binder of this.binders) { binder.refresh(this.resize.target, this.resize.currentSize); } } fire = (evt: Components.ResizeEvent) => { for (var binder of this.binders) { binder.refresh(this.resize.target, evt.detail); } } } /** Static registry pairing endpoint elements with their {@link BindersCollector}, plus a page-wide resize listener keeping every registered {@link PacemBinderElement} in sync. */ class BinderUtils { private static _pageBinders: PacemBinderElement[] = []; private static _bodyResizeListener: Components.PacemResizeElement; private static _updateResizeListener() { const binders = this._pageBinders; if (Utils.isNull(this._bodyResizeListener)) { const resize = this._bodyResizeListener = new Components.PacemResizeElement(); resize.target = document.body; document.body.appendChild(resize); document.addEventListener(Components.ResizeEventName, () => { for (let binder of binders) { binder.invalidateSize(); } }, false); } this._bodyResizeListener.disabled = binders.length === 0; } static register(element: Element, binder: PacemBinderElement) { var collector: BindersCollector = CustomElementUtils.getAttachedPropertyValue(element, UI_BINDERS), binders = this._pageBinders; if (Utils.isNull(collector)) { collector = new BindersCollector(element); CustomElementUtils.setAttachedPropertyValue(element, UI_BINDERS, collector); } if (collector.binders.indexOf(binder) == -1) { if (collector.binders.length === 0) { collector.resize.addEventListener(Components.ResizeEventName, collector.fire, false); } //else { binder.refresh(element, collector.resize.currentSize); //} collector.binders.push(binder); } if (binders.indexOf(binder) === -1) { binders.push(binder); this._updateResizeListener(); } } static unregister(element: Element, binder: PacemBinderElement) { var collector: BindersCollector = CustomElementUtils.getAttachedPropertyValue(element, UI_BINDERS), ndx: number, binders = this._pageBinders, ndx2: number; if (!Utils.isNull(collector) && (ndx = collector.binders.indexOf(binder)) > -1) { collector.binders.splice(ndx, 1); if (collector.binders.length === 0) { collector.resize.removeEventListener(Components.ResizeEventName, collector.fire, false); collector.dispose(); CustomElementUtils.deleteAttachedPropertyValue(element, UI_BINDERS); } } if ((ndx2 = binders.indexOf(binder)) >= 0) { binders.splice(ndx2, 1); this._updateResizeListener(); } } } type PacemBinderTarget = ElementOrPoint; 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."
       },
       "attributes": [
         {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.5",
+  "version": "1.0.6-mersenne",
   "name": "@pacem/pacem",
   "workspaces": [
     "packages/*"
@@ -118,6 +118,7 @@
     "copyfiles": "2.4.1",
     "esbuild": "0.28.1",
     "jasmine": "6.1.0",
+    "jsdom": "29.1.1",
     "less": "4.6.4",
     "less-plugin-clean-css": "1.6.0",
     "node-fetch": "^2.6.1",