@twobirds/microcomponents 0.2.2 → 0.2.4

package/dist/state/observables.d.ts

@@ -54,6 +54,7 @@ state.user.bind(document.querySelector('.model'));
 
 */
 /**
+@hidden
 A callback invoked with the current observable value when notified.
 
 @example
@@ -64,6 +65,7 @@ observable.subscribe(cb);
 */
 export type Callback<T = unknown> = (value: T) => void;
 /**
+@hidden
 Interface representing an observable object that supports subscription, notification, and DOM binding.
 
 Observable objects track registered callbacks and invoke them when their internal state changes.
@@ -85,6 +87,7 @@ export type Observable<T = unknown> = T & {
     callbacks: Array<Function>;
 };
 /**
+@hidden
 Every property of `T` mapped to an observable of its value.
 
 KNOWN LIMIT: the runtime property *setter* accepts a plain value
@@ -114,6 +117,7 @@ export type Observed<T> = {
     [K in keyof T]: Observable<T[K]>;
 };
 /**
+@hidden
 Only `K` of `T` mapped to an observable; other properties keep their type.
 Carries the same write limitation as {@link Observed} for the mapped key.
 
@@ -127,6 +131,7 @@ export type ObservedKey<T, K extends keyof T> = {
     [P in keyof T]: P extends K ? Observable<T[P]> : T[P];
 };
 /**
+@hidden
 The inverse of a hand-declared observable state interface: strips the
 `Observable` wrapper from every property, yielding the plain seed shape.
 `Unobserved<CounterState>` → `{ count: number }`.
@@ -154,6 +159,7 @@ export type Unobserved<S> = {
     } ? V : S[K];
 };
 /**
+@hidden
 Whether a value is already an observable wrapper — `subscribe` is reachable on its prototype chain.
 Used by {@link observe} to skip re-wrapping and to detect the "not yet observed" state on reassignment.
 
@@ -165,64 +171,6 @@ isAlreadyObserved(42);          // false
 ```
 */
 export declare function isAlreadyObserved(value: unknown): boolean;
-/**
-Makes a target object's properties observable by replacing them with wrapped values.
-
-Wraps each property of `target` that is not already observable (and meets criteria)
-in an observable wrapper. Also sets up deep change detection for objects and
-debounced notifications when the data changes.
-
-There are two sides to using it — pick per call site:
-
-**Declarative (typed class fields).** Declare the field as `Observable<T>` up
-front, then let `observe(this, 'field')` install the live wrapper in the
-constructor. The declaration needs the double cast once (`0 as unknown as
-Observable<number>`): the field starts life as a plain value and only becomes
-the wrapper when `observe()` runs. In exchange, every later use is fully typed —
-arithmetic, `subscribe`, `bind` — with no casts anywhere else.
-
-**Imperative (wrapping existing data).** Hand any object to `observe()` after
-the fact — no declarations, the return type is inferred: every property comes
-back as `Observable<PropertyType>`.
-
-@param target - The object whose properties should be made observable.
-@param propertyName - Optional specific property name to make one property observable instead of all properties.
-@returns The original target object, now with observable properties.
-
-@example Imperative usage — wrap an existing plain object:
-```ts
-const state = observe({ count: 0, label: 'hi' });
-state.count.subscribe((v) => console.log('count is now', v));
-state.count++; // triggers the callback
-```
-
-@example Declarative usage — typed class field with double cast:
-```ts
-class Counter {
-    clicks: Observable<number> = 0 as unknown as Observable<number>;
-
-    constructor() {
-        observe(this, 'clicks');
-    }
-
-    bump() {
-        this.clicks++; // plain arithmetic — the declaration carries the type
-    }
-}
-```
-
-@example Schema-first usage — divergent read/write types via hand-declared interface:
-```ts
-interface CounterState {
-    get count(): Observable<number>;
-    set count(v: number);
-}
-
-const state = observe<CounterState>({ count: 0 }); // seed validated against schema
-state.count.subscribe((v) => console.log(v)); // fully typed
-state.count = 5; // plain assignment — the declared setter type permits it
-```
-*/
 export declare function observe<T extends object, K extends keyof T>(target: T, propertyName: K): ObservedKey<T, K>;
 export declare function observe<T extends object>(target: T): Observed<T>;
 export declare function observe<S extends object>(target: Unobserved<S>): S;
@@ -235,7 +183,7 @@ All three methods return the component instance, so you can chain them fluently.
 Call it once at module level before defining any component classes. The plugin is idempotent —
 subsequent calls are no-ops.
 
-@param Class - A constructor function whose prototype chain includes {@link McBase}.
+@param Class - A constructor function whose prototype chain includes {@link Core.McBase}.
 
 @example
 ```ts

package/dist/state/observables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observables.d.ts","sourceRoot":"","sources":["../../src/state/observables.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"observables.d.ts","sourceRoot":"","sources":["../../src/state/observables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsDE;AAkBF;;;;;;;;;EASE;AACF,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEvD;;;;;;;;;;;;;EAaE;AACF,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG;IACzC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAChD,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACzE,cAAc;IACd,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;CAC3B,CAAC;AAyNF;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BE;AACF,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAE/D;;;;;;;;;;EAUE;AACF,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI;KAC9C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;EAsBE;AACF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,GAAG,OAAO,CAAA;KAAE,GACpF,CAAC,GACD,CAAC,CAAC,CAAC,CAAC;CACP,CAAC;AAKF;;;;;;;;;;;EAWE;AACF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAC1D,MAAM,EAAE,CAAC,EACT,YAAY,EAAE,CAAC,GACb,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACrB,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAClE,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAyIpE;;;;;;;;;;;;;;;;;;;;;;;EAuBE;AACF,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,QAoEvC;AAED,OAAO,QAAQ,YAAY,CAAC;IACxB,UAAiB,MAAM,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;QACnD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QACtD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;KAClE;CACJ"}

package/dist/state/observables.js

@@ -57,6 +57,7 @@ import { flattenObject, deepEqual, copyGettersSetters, isBrowser } from '../util
 import { makePlaceholders } from './placeholders.js';
 import { trigger } from '../utils/events.js';
 /**
+@hidden
 Determines if a value is an observable object.
 
 @param value - The value to check.
@@ -68,6 +69,7 @@ function isObservableObject(value) {
 // repository for observable class wrappers
 const classRepo = {};
 /**
+@hidden
 Creates a new observable wrapper class for the given value's constructor.
 
 Returns a subclass of the original constructor that implements the Observable interface,
@@ -254,6 +256,7 @@ function getConstructor(val) {
     return classRepo[key] || makeObservable(val);
 }
 /**
+@hidden
 Whether a value is already an observable wrapper — `subscribe` is reachable on its prototype chain.
 Used by {@link observe} to skip re-wrapping and to detect the "not yet observed" state on reassignment.
 
@@ -269,6 +272,65 @@ export function isAlreadyObserved(value) {
         value !== null &&
         'subscribe' in value);
 }
+/**
+@hidden
+Makes a target object's properties observable by replacing them with wrapped values.
+
+Wraps each property of `target` that is not already observable (and meets criteria)
+in an observable wrapper. Also sets up deep change detection for objects and
+debounced notifications when the data changes.
+
+There are two sides to using it — pick per call site:
+
+**Declarative (typed class fields).** Declare the field as `Observable<T>` up
+front, then let `observe(this, 'field')` install the live wrapper in the
+constructor. The declaration needs the double cast once (`0 as unknown as
+Observable<number>`): the field starts life as a plain value and only becomes
+the wrapper when `observe()` runs. In exchange, every later use is fully typed —
+arithmetic, `subscribe`, `bind` — with no casts anywhere else.
+
+**Imperative (wrapping existing data).** Hand any object to `observe()` after
+the fact — no declarations, the return type is inferred: every property comes
+back as `Observable<PropertyType>`.
+
+@param target - The object whose properties should be made observable.
+@param propertyName - Optional specific property name to make one property observable instead of all properties.
+@returns The original target object, now with observable properties.
+
+@example Imperative usage — wrap an existing plain object:
+```ts
+const state = observe({ count: 0, label: 'hi' });
+state.count.subscribe((v) => console.log('count is now', v));
+state.count++; // triggers the callback
+```
+
+@example Declarative usage — typed class field with double cast:
+```ts
+class Counter {
+    clicks: Observable<number> = 0 as unknown as Observable<number>;
+
+    constructor() {
+        observe(this, 'clicks');
+    }
+
+    bump() {
+        this.clicks++; // plain arithmetic — the declaration carries the type
+    }
+}
+```
+
+@example Schema-first usage — divergent read/write types via hand-declared interface:
+```ts
+interface CounterState {
+    get count(): Observable<number>;
+    set count(v: number);
+}
+
+const state = observe<CounterState>({ count: 0 }); // seed validated against schema
+state.count.subscribe((v) => console.log(v)); // fully typed
+state.count = 5; // plain assignment — the declared setter type permits it
+```
+*/
 export function observe(target, propertyName) {
     const source = target;
     const keys = propertyName ? [propertyName] : [...Object.getOwnPropertyNames(target)];
@@ -342,7 +404,7 @@ All three methods return the component instance, so you can chain them fluently.
 Call it once at module level before defining any component classes. The plugin is idempotent —
 subsequent calls are no-ops.
 
-@param Class - A constructor function whose prototype chain includes {@link McBase}.
+@param Class - A constructor function whose prototype chain includes {@link Core.McBase}.
 
 @example
 ```ts

package/dist/state/placeholders.d.ts

@@ -1,4 +1,5 @@
 /**
+@hidden
 DOM placeholder binding: `{name}` templates in attributes and text nodes,
 kept up to date from observable data.
 

package/dist/state/placeholders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"placeholders.d.ts","sourceRoot":"","sources":["../../src/state/placeholders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;EASE;AAEF,OAAO,EAAE,EAAE,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAoD5D;;;;;;EAME;AACF,cAAM,YAAa,SAAQ,EAAE;;IAE5B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAwD;IACjG,UAAU,CAAC,EAAE,MAAM,CAAM;IAEzB;;;;;;;;MAQE;gBACU,MAAM,EAAE,WAAW;IAkF/B;;;;;;;MAOE;IACF,MAAM,CAAC,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAOzD;AAmBD;;;;;;;EAOE;AACF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,gBAAgB,GAAG,UAAU,GAAG,IAAI,CAK3F;AAED;;;;EAIE;AACF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE;IAAE,aAAa,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC"}
+{"version":3,"file":"placeholders.d.ts","sourceRoot":"","sources":["../../src/state/placeholders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,EAAE,EAAE,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAoD5D;;;;;;EAME;AACF,cAAM,YAAa,SAAQ,EAAE;;IAE5B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAwD;IACjG,UAAU,CAAC,EAAE,MAAM,CAAM;IAEzB;;;;;;;;MAQE;gBACU,MAAM,EAAE,WAAW;IAkF/B;;;;;;;MAOE;IACF,MAAM,CAAC,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAOzD;AAmBD;;;;;;;EAOE;AACF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,gBAAgB,GAAG,UAAU,GAAG,IAAI,CAK3F;AAED;;;;EAIE;AACF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE;IAAE,aAAa,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC"}

package/dist/state/placeholders.js

@@ -1,4 +1,5 @@
 /**
+@hidden
 DOM placeholder binding: `{name}` templates in attributes and text nodes,
 kept up to date from observable data.
 

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+Types module — pure type layer for the microcomponent system.
+
+@module Types
+*/
+export type { McBubbleController, BubbleDirection, BubbleDirections, McDetail, McEventHandler, McEvent, McPayloadOf, McController, McNativeEventHandlers, McHost, McHostOf, McEntriesOf, McMerged, McRemoved, } from './mcTypes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;EAIE;AACF,YAAY,EACX,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,OAAO,EACP,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,MAAM,EACN,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,SAAS,GACT,MAAM,cAAc,CAAC"}

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/types/mcTypes.d.ts

@@ -1,10 +1,10 @@
 /**
-@module Type layer
 
 Pure type layer of the microcomponent system.
 
 RULE: types only — no runtime exports, no imports. It sits at the bottom of the
 dependency graph so every other module can import from it without cycles.
+@module Types
 */
 /** The bubble control handle passed to event handlers; `BubbleController` in events.ts implements it. */
 export interface McBubbleController {
@@ -66,7 +66,7 @@ export type McPayloadOf<EM, K extends string, D = unknown> = K extends keyof EM
 declare global {
     /**
     App-wide map of registry key names to component types. Augment it next to a
-    component definition and keyed lookups (`isMcDOM(el, 'cart')`, `closest('cart')`,
+    component definition and keyed lookups (`isMcHost(el, 'cart')`, `closest('cart')`,
     `ancestors` / `children` / `descendants`) type themselves from it.
 
     Presence is checked at runtime; the key → type mapping is a convention. Where
@@ -81,7 +81,7 @@ declare global {
     }
 
     const el = document.querySelector('form');
-    if (el && isMcDOM(el, 'cart')) {
+    if (el && isMcHost(el, 'cart')) {
         el._mc.cart.addItem(item); // Cart
     }
     ```

package/dist/types/mcTypes.js

@@ -1,9 +1,9 @@
 /**
-@module Type layer
 
 Pure type layer of the microcomponent system.
 
 RULE: types only — no runtime exports, no imports. It sits at the bottom of the
 dependency graph so every other module can import from it without cycles.
+@module Types
 */
 export {};

package/dist/utils/autoload.d.ts

@@ -1,5 +1,5 @@
 /**
-@module
+@module Autoload
 
 The {@linkcode autoload} function enables automatic detection and instantiation of microcomponents in the DOM via a `MutationObserver`. When enabled, newly added elements with undefined custom tags or `data-mc` references will trigger dynamic script loading and component attachment.
 
@@ -20,6 +20,7 @@ autoload(true);  // enable auto-loading
 console.log(autoload.state); // Set of component names currently loading
 autoload(false); // disable
 ```
+@group Autoload
 */
 export interface Autoload {
     /**
@@ -50,5 +51,8 @@ declare global {
         autoload?: Autoload;
     }
 }
-export declare const autoload: Autoload;
+export declare function autoload(enable?: boolean): boolean;
+export declare namespace autoload {
+    var state: Set<string>;
+}
 //# sourceMappingURL=autoload.d.ts.map

package/dist/utils/autoload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoload.d.ts","sourceRoot":"","sources":["../../src/utils/autoload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;EASE;AAoJF;;;;;;;;;;;;EAYE;AACF,MAAM,WAAW,QAAQ;IACxB;;;;;;;;;;;;;IAaG;IACH,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B;;;;;IAKG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnB;AAED,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACpB;CACD;AAID,eAAO,MAAM,QAAQ,EAAE,QAuBtB,CAAC"}
+{"version":3,"file":"autoload.d.ts","sourceRoot":"","sources":["../../src/utils/autoload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;EASE;AAqJF;;;;;;;;;;;;;EAaE;AACF,MAAM,WAAW,QAAQ;IACxB;;;;;;;;;;;;;IAaG;IACH,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B;;;;;IAKG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnB;AAED,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACpB;CACD;AAID,wBAAgB,QAAQ,CAAC,MAAM,GAAE,OAAc,GAAG,OAAO,CAuBxD;yBAvBe,QAAQ"}

package/dist/utils/autoload.js

@@ -1,5 +1,5 @@
 /**
-@module
+@module Autoload
 
 The {@linkcode autoload} function enables automatic detection and instantiation of microcomponents in the DOM via a `MutationObserver`. When enabled, newly added elements with undefined custom tags or `data-mc` references will trigger dynamic script loading and component attachment.
 
@@ -9,7 +9,7 @@ importing `DC`/`MC` never pulls a DOM observer into the bundle unless
 {@link autoload} itself is imported.
 */
 import { DC } from '../core/MC.js';
-import { isMcDOM } from '../core/mcGuards.js';
+import { isMcHost } from '../core/mcGuards.js';
 const loadingDCs = new Set();
 /**
 Creates a closure that attaches DOM elements with the specified tag name to
@@ -24,6 +24,7 @@ element definition becomes available, and performs:
 
 @param element - The tag name (custom element name) of the microcomponent to instantiate.
 @returns A closure that performs the attachment logic when invoked.
+@group Autoload
 */
 function attachDC(element) {
     return () => {
@@ -39,7 +40,7 @@ function attachDC(element) {
                 /* v8 ignore start */
                 if ('create' in customElementClass && typeof customElementClass.create === 'function') {
                     const customElement = customElementClass.create(node);
-                    if (!isMcDOM(customElement))
+                    if (!isMcHost(customElement))
                         throw `create() of Class ${customElementClass.name} did not return a McHost.`;
                     customElement.setAttribute('data-mc', node.getAttribute('data-mc') ?? '');
                     node.replaceWith(customElement);
@@ -135,7 +136,7 @@ function loadUndefinedMCs() {
     });
 }
 let observer = null;
-export const autoload = function (enable = true) {
+export function autoload(enable = true) {
     if (!enable) {
         if (observer) {
             observer.disconnect();
@@ -154,5 +155,6 @@ export const autoload = function (enable = true) {
     }, 5);
     window.autoload ??= autoload;
     return true;
-};
+}
+;
 autoload.state = loadingDCs;

package/dist/utils/events.d.ts

@@ -1,5 +1,5 @@
 /**
-@module
+@module Events
 
 This module provides event utilities for interfacing **between microcomponents and external
 frameworks or native DOM/JS environments**. It is not intended for communication between
@@ -94,91 +94,34 @@ export declare function getMcEventName(eventName: string): string;
  */
 export declare function trueEventName(target: HTMLElement, eventName: string): string;
 /**
- * A query selector string used to match one or more DOM elements.
- *
- * @example
- * ```ts
- * const selector: QuerySelectorString = '.my-component';
- * ```
- */
+A query selector string used to match one or more DOM elements.
+
+@example
+```ts
+const selector: QuerySelectorString = '.my-component';
+```
+@group Events
+*/
 export type QuerySelectorString = string;
 /**
- * Represents the target of an event operation — either a concrete element,
- * a CSS selector string, or `undefined` (which is silently ignored).
- *
- * @example
- * ```ts
- * // Pass an HTMLElement directly
- * const el: TargetSelect = document.getElementById('root');
- *
- * // Or pass a selector string to match multiple elements
- * const allCards: TargetSelect = '.card';
- * ```
- */
+Represents the target of an event operation — either a concrete element,
+a CSS selector string, or `undefined` (which is silently ignored).
+
+@example
+```ts
+// Pass an HTMLElement directly
+const el: TargetSelect = document.getElementById('root');
+
+// Or pass a selector string to match multiple elements
+const allCards: TargetSelect = '.card';
+```
+@group Events
+*/
 export type TargetSelect = HTMLElement | QuerySelectorString | undefined | null;
-/**
- * Removes a previously attached event handler from the DOM node. See {@link on} and {@link one}.
- *
- * Uses internal microcomponent-prefixed naming for event handlers.
- * This is primarily used to interface with external frameworks or vanilla JS environments.
- * For communication between frontend microcomponents, use the `DC.off()` method instead.
- *
- * @param target - The DOM element from which to remove the listener.
- * @param eventName - The name of the event (e.g., 'click', 'update').
- * @param handler - The listener function or object to detach.
- *
- * @example
- * ```ts
- * const handler = on(myElement, 'click', () => console.log('clicked'));
- * off(myElement, 'click', handler); // removes the listener
- * ```
- */
 export declare function off<D = unknown>(target: TargetSelect, eventName: string, handler: McEventHandler<D>): void;
 export declare function off(target: TargetSelect, eventName: string, handler: EventListenerOrEventListenerObject): void;
-/**
- * Attaches a persistent event listener that will fire every time the specified event occurs.
- *
- * This is primarily used to interface with external frameworks or vanilla JS environments.
- * For communication between frontend microcomponents, use the `DC.on()` method instead.
- *
- * The handler receives a `CustomEvent<McDetail<D>>`: the payload sits under
- * `ev.detail.data`, the bubble-control handle under `ev.detail.control`.
- *
- * @param target - The DOM element to attach the listener to.
- * @param eventName - The name of the event (e.g., 'click', 'update').
- * @param handler - The callback function or object to invoke on each event.
- * @param once - If true, remove the listener after first invocation.
- * @returns The attached handler reference. Useful for later deletion with {@link off}.
- *
- * @example
- * ```ts
- * const handler = on<{ value: number }>(myElement, 'update', (ev) => {
- *     console.log(ev.detail.data.value); // number
- * });
- * // to remove: off(myElement, 'update', handler);
- * ```
- */
 export declare function on<D = unknown>(target: TargetSelect, eventName: string, handler: McEventHandler<D>, once?: boolean): McEventHandler<D>;
 export declare function on(target: TargetSelect, eventName: string, handler: EventListenerOrEventListenerObject, once?: boolean): EventListenerOrEventListenerObject;
-/**
- * Attaches an event listener that will fire only once.
- *
- * Internally calls {@link on} with the `once` flag set to true. The handler
- * is automatically removed after its first invocation.
- * This is primarily used to interface with external frameworks or vanilla JS environments.
- * For communication between frontend microcomponents, use the `DC.one()` method instead.
- *
- * @param target - The DOM element to attach the listener to.
- * @param eventName - The name of the event (e.g., 'click', 'update').
- * @param handler - The callback function or object to invoke once.
- * @returns The attached one-time handler reference. Useful for later deletion with {@link off}.
- *
- * @example
- * ```ts
- * one<{ ready: boolean }>(myElement, 'dataReady', (ev) => console.log('received:', ev.detail.data));
- * // fires only once then detaches automatically
- * ```
- */
 export declare function one<D = unknown>(target: TargetSelect, eventName: string, handler: McEventHandler<D>): McEventHandler<D>;
 export declare function one(target: TargetSelect, eventName: string, handler: EventListenerOrEventListenerObject): EventListenerOrEventListenerObject;
 /**

package/dist/utils/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyDE;AAIF,OAAO,KAAK,EACX,gBAAgB,EAChB,kBAAkB,EAElB,cAAc,EACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAAC;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,GAAG,CAAC,CAAC,GAAG,OAAO,EAC9B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,IAAI,CAAC;AACR,wBAAgB,GAAG,CAClB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kCAAkC,GACzC,IAAI,CAAC;AA0BR;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,EAAE,CAAC,CAAC,GAAG,OAAO,EAC7B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,IAAI,CAAC,EAAE,OAAO,GACZ,cAAc,CAAC,CAAC,CAAC,CAAC;AACrB,wBAAgB,EAAE,CACjB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kCAAkC,EAC3C,IAAI,CAAC,EAAE,OAAO,GACZ,kCAAkC,CAAC;AA8BtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,GAAG,CAAC,CAAC,GAAG,OAAO,EAC9B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,cAAc,CAAC,CAAC,CAAC,CAAC;AACrB,wBAAgB,GAAG,CAClB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kCAAkC,GACzC,kCAAkC,CAAC;AAsBtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IAC1D,OAAO,UAAS;;IAEhB;;;;;;;;;;;;;;;OAeG;IACH,IAAI;CAGJ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAClC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EAC/C,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,CAAW,EACjB,MAAM,GAAE,gBAAsB,EAAE,wBAAwB;AACxD,UAAU,CAAC,EAAE,gBAAgB,QA+C7B"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyDE;AAIF,OAAO,KAAK,EACX,gBAAgB,EAChB,kBAAkB,EAElB,cAAc,EACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED;;;;;;;;EAQE;AACF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC;;;;;;;;;;;;;EAaE;AACF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAAC;AAEhF,wBAAgB,GAAG,CAAC,CAAC,GAAG,OAAO,EAC9B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,IAAI,CAAC;AACR,wBAAgB,GAAG,CAClB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kCAAkC,GACzC,IAAI,CAAC;AA4CR,wBAAgB,EAAE,CAAC,CAAC,GAAG,OAAO,EAC7B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,IAAI,CAAC,EAAE,OAAO,GACZ,cAAc,CAAC,CAAC,CAAC,CAAC;AACrB,wBAAgB,EAAE,CACjB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kCAAkC,EAC3C,IAAI,CAAC,EAAE,OAAO,GACZ,kCAAkC,CAAC;AAsDtC,wBAAgB,GAAG,CAAC,CAAC,GAAG,OAAO,EAC9B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,cAAc,CAAC,CAAC,CAAC,CAAC;AACrB,wBAAgB,GAAG,CAClB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kCAAkC,GACzC,kCAAkC,CAAC;AA0CtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IAC1D,OAAO,UAAS;;IAEhB;;;;;;;;;;;;;;;OAeG;IACH,IAAI;CAGJ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAClC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EAC/C,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,CAAW,EACjB,MAAM,GAAE,gBAAsB,EAAE,wBAAwB;AACxD,UAAU,CAAC,EAAE,gBAAgB,QA+C7B"}

package/dist/utils/events.js

@@ -1,5 +1,5 @@
 /**
-@module
+@module Events
 
 This module provides event utilities for interfacing **between microcomponents and external
 frameworks or native DOM/JS environments**. It is not intended for communication between
@@ -99,6 +99,24 @@ export function trueEventName(target, eventName) {
         return lower;
     return '_mc' + eventName[0].toUpperCase() + eventName.substring(1);
 }
+/**
+Removes a previously attached event handler from the DOM node. See {@link on} and {@link one}.
+
+Uses internal microcomponent-prefixed naming for event handlers.
+This is primarily used to interface with external frameworks or vanilla JS environments.
+For communication between frontend microcomponents, use the `DC.off()` method instead.
+
+@param target - The DOM element from which to remove the listener.
+@param eventName - The name of the event (e.g., 'click', 'update').
+@param handler - The listener function or object to detach.
+
+@example
+```ts
+const handler = on(myElement, 'click', () => console.log('clicked'));
+off(myElement, 'click', handler); // removes the listener
+```
+@group Events
+*/
 export function off(target, eventName, handler) {
     /* v8 ignore next */
     if (!target)
@@ -113,6 +131,30 @@ export function off(target, eventName, handler) {
     // the cast re-widens it at the DOM boundary.
     target.removeEventListener(trueEventName(target, eventName), handler);
 }
+/**
+Attaches a persistent event listener that will fire every time the specified event occurs.
+
+This is primarily used to interface with external frameworks or vanilla JS environments.
+For communication between frontend microcomponents, use the `DC.on()` method instead.
+
+The handler receives a `CustomEvent<McDetail<D>>`: the payload sits under
+`ev.detail.data`, the bubble-control handle under `ev.detail.control`.
+
+@param target - The DOM element to attach the listener to.
+@param eventName - The name of the event (e.g., 'click', 'update').
+@param handler - The callback function or object to invoke on each event.
+@param once - If true, remove the listener after first invocation.
+@returns The attached handler reference. Useful for later deletion with {@link off}.
+
+@example
+```ts
+const handler = on<{ value: number }>(myElement, 'update', (ev) => {
+    console.log(ev.detail.data.value); // number
+});
+// to remove: off(myElement, 'update', handler);
+```
+@group Events
+*/
 export function on(target, eventName, handler, once = false) {
     /* v8 ignore next */
     if (!target)
@@ -129,6 +171,26 @@ export function on(target, eventName, handler, once = false) {
     });
     return handler;
 }
+/**
+Attaches an event listener that will fire only once.
+
+Internally calls {@link on} with the `once` flag set to true. The handler
+is automatically removed after its first invocation.
+This is primarily used to interface with external frameworks or vanilla JS environments.
+For communication between frontend microcomponents, use the `DC.one()` method instead.
+
+@param target - The DOM element to attach the listener to.
+@param eventName - The name of the event (e.g., 'click', 'update').
+@param handler - The callback function or object to invoke once.
+@returns The attached one-time handler reference. Useful for later deletion with {@link off}.
+
+@example
+```ts
+one<{ ready: boolean }>(myElement, 'dataReady', (ev) => console.log('received:', ev.detail.data));
+// fires only once then detaches automatically
+```
+@group Events
+*/
 export function one(target, eventName, handler) {
     /* v8 ignore next */
     if (!target)

package/dist/utils/helpers.d.ts

@@ -216,7 +216,7 @@ export declare function injectCSS(target: Document | ShadowRoot, css: string): C
  * Recognized keys: `'css'`, `'targetCss'` (document-level styles), `'shadowCss'`
  * (shadow-root styles), `'shadowHtml'` (shadow innerHTML), `'targetHtml'` (target innerHTML).
  *
- * @param target - The HTMLElement to apply assets onto.
+ * @param instance - The micro component to apply assets onto.
  * @param assets - A record mapping asset type keys to their string content.
  *
  * @example
@@ -268,7 +268,8 @@ export declare function loadAssets(name: string, assets: string[]): Promise<Arra
  * An optional sibling `payload` attribute supplies the data argument for `trigger()`.
  * After binding, both the event attribute and the payload attribute are removed from the DOM.
  *
- * @param root - The container element whose descendants should be scanned for bindings.
+ * @param rootElement - The container element whose descendants should be scanned for bindings.
+ * @param instance - The instance to trigger events on.
  *
  * @example
  * ```html

package/dist/utils/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EAAE,YAAY,EAAU,MAAM,qBAAqB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAiB1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqB7F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAiCzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,GAAG,GAAE,MAAW,GAAG,OAAO,CAe1E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,EACpD,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,MAAM,EACjB,GAAG,IAAI,EAAE,OAAO,EAAE,GAChB,CAAC,CAgCH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,UAKxC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAC3C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,EAC7B,YAAY,EAAE,MAAM,GAClB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAStB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAU1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAOnF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA4B1F;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAiC9E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CA2CtG"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAiB1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqB7F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAiCzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,GAAG,GAAE,MAAW,GAAG,OAAO,CAe1E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,EACpD,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,MAAM,EACjB,GAAG,IAAI,EAAE,OAAO,EAAE,GAChB,CAAC,CAgCH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,UAKxC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAC3C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,EAC7B,YAAY,EAAE,MAAM,GAClB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAStB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAU1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAOnF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA2B1F;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAiC9E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CA2CtG"}

package/dist/utils/helpers.js

@@ -362,7 +362,7 @@ export function injectCSS(target, css) {
  * Recognized keys: `'css'`, `'targetCss'` (document-level styles), `'shadowCss'`
  * (shadow-root styles), `'shadowHtml'` (shadow innerHTML), `'targetHtml'` (target innerHTML).
  *
- * @param target - The HTMLElement to apply assets onto.
+ * @param instance - The micro component to apply assets onto.
  * @param assets - A record mapping asset type keys to their string content.
  *
  * @example
@@ -475,7 +475,8 @@ export function loadAssets(name, assets) {
  * An optional sibling `payload` attribute supplies the data argument for `trigger()`.
  * After binding, both the event attribute and the payload attribute are removed from the DOM.
  *
- * @param root - The container element whose descendants should be scanned for bindings.
+ * @param rootElement - The container element whose descendants should be scanned for bindings.
+ * @param instance - The instance to trigger events on.
  *
  * @example
  * ```html