@twobirds/microcomponents 0.3.0 → 0.4.1

package/dist/state/placeholders.js

@@ -21,7 +21,6 @@ and returns them as an array of unique names (without braces).
 @param target - The HTMLElement to scan for placeholders.
 @returns An array of placeholder names found within the element's attributes and text content.
 */
-/* v8 ignore start */
 function getPlaceholders(target) {
     const placeholders = new Set(), regEx = /\{[^\{\}]*\}/g;
     // scan attributes
@@ -39,13 +38,14 @@ function getPlaceholders(target) {
         childNode.nodeType === 3 && (childNode.nodeValue || '').match(regEx));
     })
         .forEach((childNode) => {
+        /* v8 ignore next -- the filter above matched nodeValue against the placeholder
+           pattern, so it is non-null and non-empty by the time we get here */
         const textContent = childNode?.nodeValue || '';
         const contentPlaceholders = textContent.match(regEx);
         contentPlaceholders.forEach((textNodePlaceholder) => placeholders.add(textNodePlaceholder.replace(/[\{\}]/g, '')));
     });
     return [...placeholders];
 }
-/* v8 ignore end */
 // Tag names instead of constructor references (HTMLInputElement etc.):
 // evaluating those globals at module scope crashes any DOM-less import
 // of the package (e.g. server-side use of MC).
@@ -80,10 +80,16 @@ class Placeholders extends DC {
         const target = this.target;
         let hide = false;
         // scan attributes
-        (target.getAttributeNames ? target.getAttributeNames() : [])
+        /* v8 ignore next -- Placeholders is only ever constructed with an HTMLElement
+           (DC's constructor reads target.tagName), so the fragment/shadow-root guard
+           that getPlaceholders needs is dead here. */
+        const attrNames = target.getAttributeNames ? target.getAttributeNames() : [];
+        attrNames
             .filter((attr) => target.getAttribute(attr)?.match(/\{[^\{\}]*\}/g)) // extract placeholder(s)
             .forEach((attr) => {
             const placeholders = new Set(target.getAttribute(attr)?.match(/\{[^\{\}]*\}/g));
+            /* v8 ignore next -- attr passed the filter above, so its value is a non-null string */
+            const attrTemplate = target.getAttribute(attr) ?? '';
             // attach callback
             this.data.subscribe(((template) => (data) => {
                 let result = template;
@@ -93,7 +99,7 @@ class Placeholders extends DC {
                     String(data[placeholder.replace(/[\{\}]/g, '')]));
                 });
                 target.setAttribute(attr, result);
-            })(target.getAttribute(attr) ?? ''));
+            })(attrTemplate));
         });
         // scan children text nodes
         [...target.childNodes]
@@ -104,11 +110,12 @@ class Placeholders extends DC {
         })
             .forEach((childNode) => {
             hide = true;
-            const placeholders = new Set((childNode.nodeValue ?? '').match(/\{[^\{\}]*\}/g));
+            /* v8 ignore next -- the filter above only admits text nodes with a non-empty
+               nodeValue, so the ?? fallback is unreachable */
+            const textTemplate = childNode.nodeValue ?? '';
+            const placeholders = new Set(textTemplate.match(/\{[^\{\}]*\}/g));
             // attach callback
-            this.data.subscribe(
-            /* v8 ignore start */
-            ((template) => (data) => {
+            this.data.subscribe(((template) => (data) => {
                 let result = template;
                 placeholders.forEach((placeholder) => {
                     result = result.replace(placeholder, 
@@ -123,9 +130,7 @@ class Placeholders extends DC {
                 }
                 delete this.oldDisplay;
                 childNode.nodeValue = result;
-            })(childNode.nodeValue ?? '')
-            /* v8 ignore end */
-            );
+            })(textTemplate));
             // hide for now
             this.oldDisplay = target.getAttribute('style') || ''; // TBD allow null to indicate there was no old style attribute
             if (hide && !inputTags.includes(target.tagName) && target.tagName !== 'FIELDSET') {

package/dist/types/mcTypes.d.ts

@@ -46,11 +46,13 @@ is in the component's event map (`EM` on `DC`) and let it be inferred.
 @example
 ```ts
 cart.on('CartUpdate', (ev: McEvent<{ count: number }>) => {
-    ev.detail.data.count; // number
-    ev.detail.control.stop(); // stop bubbling
+    console.log(ev.detail.data.count);
+    ev.detail.control.stop();
 });
 ```
 
+`ev.detail.data.count` is typed `number`; `ev.detail.control.stop()` halts further bubbling.
+
 @template D - The payload type under `ev.detail.data`.
 */
 export type McEvent<D = unknown> = CustomEvent<McDetail<D>>;
@@ -82,9 +84,12 @@ declare global {
 
     const el = document.querySelector('form');
     if (el && isMcHost(el, 'cart')) {
-        el._mc.cart.addItem(item); // Cart
+        el._mc.cart.addItem(item);
     }
     ```
+
+Inside the guard, `el._mc.cart` is typed as `Cart`.
+
     */
     interface McRegistry {
     }
@@ -127,10 +132,12 @@ Type-only — nothing exists at runtime.
 @example
 ```ts
 class Panel extends DC implements McNativeEventHandlers {
-    onClick(ev: MouseEvent) {}       // ✓ checked against 'click'
-    // onClick(ev: KeyboardEvent) {} // ✗ wrong event type
+    onClick(ev: MouseEvent) {}
 }
 ```
+
+`onClick` is checked against the native `'click'` event type. Declaring
+`onClick(ev: KeyboardEvent)` instead is a compile error.
 */
 export type McNativeEventHandlers = {
     [K in keyof GlobalEventHandlersEventMap as `on${Capitalize<K>}` | `one${Capitalize<K>}`]?: (ev: GlobalEventHandlersEventMap[K]) => void;
@@ -146,9 +153,11 @@ their entries into `R`.
 @example
 ```ts
 const withA = DC.add(form, 'a', { a: 0 });
-withA._mc.a.a; // number
-withA._mc.b;   // ✗ never registered
+console.log(withA._mc.a.a);
 ```
+
+`withA._mc.a.a` is typed `number`. Accessing `withA._mc.b` is a compile error
+because that key was never registered.
 */
 export type McHost<T extends HTMLElement = HTMLElement, R extends Record<string, unknown> = Record<never, never>> = T & {
     /** The hosted microcomponents: the controller API plus one entry per `add()` key. */

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

@@ -1 +1 @@
-{"version":3,"file":"mcTypes.d.ts","sourceRoot":"","sources":["../../src/types/mcTypes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcTypes.d.ts","sourceRoot":"","sources":["../../src/types/mcTypes.ts"],"names":[],"mappings":"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"}

package/dist/utils/autoload.d.ts

@@ -16,10 +16,13 @@ set of microcomponent names currently loading via its `state` property.
 ```ts
 import { autoload } from '@twobirds/microcomponents';
 
-autoload(true);  // enable auto-loading
-console.log(autoload.state); // Set of component names currently loading
-autoload(false); // disable
+autoload(true);
+console.log(autoload.state);
+autoload(false);
 ```
+
+`autoload(true)` enables auto-loading, `autoload.state` is the set of component
+names currently loading, and `autoload(false)` disables it again.
 @group Autoload
 */
 export interface Autoload {

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;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"}
+{"version":3,"file":"autoload.d.ts","sourceRoot":"","sources":["../../src/utils/autoload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;EASE;AAsJF;;;;;;;;;;;;;;;;EAgBE;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

@@ -10,6 +10,7 @@ importing `DC`/`MC` never pulls a DOM observer into the bundle unless
 */
 import { DC } from '../core/MC.js';
 import { isMcHost } from '../core/mcGuards.js';
+import { resolveComponentPath } from './resolveComponentPath.js';
 const loadingDCs = new Set();
 /**
 Creates a closure that attaches DOM elements with the specified tag name to
@@ -75,7 +76,7 @@ function makeLoadScript(element) {
     if (loadingDCs.has(element))
         return; // already loading
     loadingDCs.add(element);
-    const fileName = './' + element.split('-').join('/') + '.js';
+    const fileName = resolveComponentPath(element);
     const scriptElement = document.createElement('script');
     scriptElement.setAttribute('src', fileName);
     scriptElement.setAttribute('blocking', 'render');
@@ -156,5 +157,4 @@ export function autoload(enable = true) {
     window.autoload ??= autoload;
     return true;
 }
-;
 autoload.state = loadingDCs;

package/dist/utils/events.d.ts

@@ -29,32 +29,24 @@ javascript:
 ```javascript
 import { on, one, trigger, off } from '@twobirds/microcomponents/events';
 
-// Attach listeners (querySelector may return null — guard first)
 const grandParent = document.querySelector('.grandparent');
 const parent = document.querySelector('.parent');
 const child = document.querySelector('.child');
 if (!grandParent || !parent || !child) throw new Error('example markup missing');
 
-const grandParentHandler = on(
-    grandParent,
-    'dataReady',
-    (ev) => console.log(ev.detail.data)
-);
+const grandParentHandler = on(grandParent, 'dataReady', (ev) => console.log(ev.detail.data));
 
-const parentHandler = on(
-    parent,
-    'dataReady',
-    (ev) => ev.detail.control.stop()
-);
+const parentHandler = on(parent, 'dataReady', (ev) => ev.detail.control.stop());
 
-// this event bubbles toward root from the innermost div ..
-trigger( child, 'dataReady', { value: 42 }, 'u');
-// ...but the 'dataReady' handler on grandParent will never be reached !!!
+trigger(child, 'dataReady', { value: 42 }, 'u');
 
-// Clean up handlers when done
-off( parent, 'dataReady', parentHandler );
-off( grandParent, 'dataReady', grandParentHandler );
+off(parent, 'dataReady', parentHandler);
+off(grandParent, 'dataReady', grandParentHandler);
 ```
+
+The `dataReady` event bubbles upward from the innermost `div`, but `parentHandler`
+calls `ev.detail.control.stop()`, so the `grandParent` handler is never reached.
+Handlers are detached with `off()` once they are no longer needed.
 */
 import type { BubbleDirections, McBubbleController, McEventHandler } from '../types/mcTypes.js';
 export type { BubbleDirections } from '../types/mcTypes.js';
@@ -68,7 +60,7 @@ export type { BubbleDirections } from '../types/mcTypes.js';
  *
  * @example
  * ```ts
- * getMcEventName('update'); // '_mcUpdate'
+ * console.log(getMcEventName('update'));
  * ```
  */
 export declare function getMcEventName(eventName: string): string;
@@ -88,9 +80,13 @@ export declare function getMcEventName(eventName: string): string;
  * @example
  * ```ts
  * const btn = document.createElement('button');
- * trueEventName(btn, 'Click');   // 'click'  — native handler exists
- * trueEventName(btn, 'Update');  // '_mcUpdate' — custom event
+ * console.log(trueEventName(btn, 'Click'));
+ * console.log(trueEventName(btn, 'Update'));
  * ```
+ *
+ * `'Click'` resolves to the native `'click'` because the button has an `onclick` handler
+ * property; `'Update'` has no native counterpart, so it becomes the `_mc`-prefixed custom
+ * event name.
  */
 export declare function trueEventName(target: HTMLElement, eventName: string): string;
 /**
@@ -109,12 +105,12 @@ 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';
 ```
+
+A `TargetSelect` accepts an `HTMLElement` directly, or a selector string that matches
+multiple elements.
 @group Events
 */
 export type TargetSelect = HTMLElement | QuerySelectorString | undefined | null;
@@ -137,7 +133,6 @@ export declare function one(target: TargetSelect, eventName: string, handler: Ev
  * ```ts
  * trigger(myElement, 'update', { value: 42 }, 'u');
  *
- * // inside a handler you can call ev.detail.control.stop() to halt propagation
  * onUpdate(ev) {
  *     ev.detail.control.stop();
  * }
@@ -156,7 +151,6 @@ export declare class BubbleController implements McBubbleController {
      * ```ts
      * trigger(myElement, 'update', { value: 42 }, 'u');
      *
-     * // inside a handler you can call ev.detail.control.stop() to halt propagation
      * onUpdate(ev) {
      *     ev.detail.control.stop();
      * }
@@ -184,12 +178,11 @@ export declare class BubbleController implements McBubbleController {
  *
  * @example
  * ```ts
- * // Trigger a local event with data
  * trigger(myElement, 'update', { value: 42 }, 'l');
- *
- * // Bubble up to ancestors
  * trigger(myElement, 'dataReady', { ready: true }, 'u');
  * ```
+ *
+ * The first dispatch fires locally only; the second bubbles upward to ancestor components.
  */
 export declare function trigger<D = unknown>(target: HTMLElement | string | undefined | null, event: string, data?: D, bubble?: BubbleDirections, // direction of bubbling
 controller?: BubbleController): void;

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;;;;;;;;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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDE;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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;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;AA2CtC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IAC1D,OAAO,UAAS;;IAEhB;;;;;;;;;;;;;;OAcG;IACH,IAAI;CAGJ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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

@@ -29,32 +29,24 @@ javascript:
 ```javascript
 import { on, one, trigger, off } from '@twobirds/microcomponents/events';
 
-// Attach listeners (querySelector may return null — guard first)
 const grandParent = document.querySelector('.grandparent');
 const parent = document.querySelector('.parent');
 const child = document.querySelector('.child');
 if (!grandParent || !parent || !child) throw new Error('example markup missing');
 
-const grandParentHandler = on(
-    grandParent,
-    'dataReady',
-    (ev) => console.log(ev.detail.data)
-);
+const grandParentHandler = on(grandParent, 'dataReady', (ev) => console.log(ev.detail.data));
 
-const parentHandler = on(
-    parent,
-    'dataReady',
-    (ev) => ev.detail.control.stop()
-);
+const parentHandler = on(parent, 'dataReady', (ev) => ev.detail.control.stop());
 
-// this event bubbles toward root from the innermost div ..
-trigger( child, 'dataReady', { value: 42 }, 'u');
-// ...but the 'dataReady' handler on grandParent will never be reached !!!
+trigger(child, 'dataReady', { value: 42 }, 'u');
 
-// Clean up handlers when done
-off( parent, 'dataReady', parentHandler );
-off( grandParent, 'dataReady', grandParentHandler );
+off(parent, 'dataReady', parentHandler);
+off(grandParent, 'dataReady', grandParentHandler);
 ```
+
+The `dataReady` event bubbles upward from the innermost `div`, but `parentHandler`
+calls `ev.detail.control.stop()`, so the `grandParent` handler is never reached.
+Handlers are detached with `off()` once they are no longer needed.
 */
 'use strict';
 /**
@@ -67,7 +59,7 @@ off( grandParent, 'dataReady', grandParentHandler );
  *
  * @example
  * ```ts
- * getMcEventName('update'); // '_mcUpdate'
+ * console.log(getMcEventName('update'));
  * ```
  */
 export function getMcEventName(eventName) {
@@ -89,9 +81,13 @@ export function getMcEventName(eventName) {
  * @example
  * ```ts
  * const btn = document.createElement('button');
- * trueEventName(btn, 'Click');   // 'click'  — native handler exists
- * trueEventName(btn, 'Update');  // '_mcUpdate' — custom event
+ * console.log(trueEventName(btn, 'Click'));
+ * console.log(trueEventName(btn, 'Update'));
  * ```
+ *
+ * `'Click'` resolves to the native `'click'` because the button has an `onclick` handler
+ * property; `'Update'` has no native counterpart, so it becomes the `_mc`-prefixed custom
+ * event name.
  */
 export function trueEventName(target, eventName) {
     const lower = eventName.toLowerCase();
@@ -113,7 +109,7 @@ For communication between frontend microcomponents, use the `DC.off()` method in
 @example
 ```ts
 const handler = on(myElement, 'click', () => console.log('clicked'));
-off(myElement, 'click', handler); // removes the listener
+off(myElement, 'click', handler);
 ```
 @group Events
 */
@@ -149,9 +145,9 @@ The handler receives a `CustomEvent<McDetail<D>>`: the payload sits under
 @example
 ```ts
 const handler = on<{ value: number }>(myElement, 'update', (ev) => {
-    console.log(ev.detail.data.value); // number
+    console.log(ev.detail.data.value);
 });
-// to remove: off(myElement, 'update', handler);
+off(myElement, 'update', handler);
 ```
 @group Events
 */
@@ -187,8 +183,9 @@ For communication between frontend microcomponents, use the `DC.one()` method in
 @example
 ```ts
 one<{ ready: boolean }>(myElement, 'dataReady', (ev) => console.log('received:', ev.detail.data));
-// fires only once then detaches automatically
 ```
+
+The listener fires only once and detaches automatically.
 @group Events
 */
 export function one(target, eventName, handler) {
@@ -217,7 +214,6 @@ export function one(target, eventName, handler) {
  * ```ts
  * trigger(myElement, 'update', { value: 42 }, 'u');
  *
- * // inside a handler you can call ev.detail.control.stop() to halt propagation
  * onUpdate(ev) {
  *     ev.detail.control.stop();
  * }
@@ -236,7 +232,6 @@ export class BubbleController {
      * ```ts
      * trigger(myElement, 'update', { value: 42 }, 'u');
      *
-     * // inside a handler you can call ev.detail.control.stop() to halt propagation
      * onUpdate(ev) {
      *     ev.detail.control.stop();
      * }
@@ -266,12 +261,11 @@ export class BubbleController {
  *
  * @example
  * ```ts
- * // Trigger a local event with data
  * trigger(myElement, 'update', { value: 42 }, 'l');
- *
- * // Bubble up to ancestors
  * trigger(myElement, 'dataReady', { ready: true }, 'u');
  * ```
+ *
+ * The first dispatch fires locally only; the second bubbles upward to ancestor components.
  */
 export function trigger(target, event, data = {}, bubble = 'l', // direction of bubbling
 controller) {

package/dist/utils/helpers.d.ts

@@ -34,10 +34,10 @@ export declare function isBrowser(): boolean;
  *
  * @example
  * ```ts
- * isNativeObject({});        // true
- * isNativeObject(new Object()); // true
- * isNativeObject([]);        // false
- * isNativeObject(null);      // false
+ * console.log(isNativeObject({}));
+ * console.log(isNativeObject(new Object()));
+ * console.log(isNativeObject([]));
+ * console.log(isNativeObject(null));
  * ```
  */
 export declare function isNativeObject(value: unknown): value is Record<string, unknown>;
@@ -49,7 +49,7 @@ export declare function isNativeObject(value: unknown): value is Record<string,
  * @example
  * ```ts
  * const obj = { z: 1, a: { y: 2, b: 3 } };
- * sortObject(obj); // { a: { b: 3, y: 2 }, z: 1 }
+ * console.log(JSON.stringify(sortObject(obj)));
  * ```
  */
 export declare function sortObject<T extends Record<string, unknown>>(source: T): T;
@@ -63,7 +63,7 @@ export declare function sortObject<T extends Record<string, unknown>>(source: T)
  * @example
  * ```ts
  * const obj = { user: { name: 'Alice', age: 30 } };
- * flattenObject(obj); // { 'user.age': 30, 'user.name': 'Alice' }
+ * console.log(JSON.stringify(flattenObject(obj)));
  * ```
  */
 export declare function flattenObject(source: object, doSort?: boolean): Record<string, unknown>;
@@ -80,10 +80,10 @@ export declare function flattenObject(source: object, doSort?: boolean): Record<
  *
  * @example
  * ```ts
- * deepEqual({ a: 1 }, { a: 1 });          // true
- * deepEqual({ a: { b: 2 } }, { a: {} });  // false
- * deepEqual({ a: NaN }, { a: NaN });      // true  (SameValueZero)
- * deepEqual({ a: NaN }, { a: null });     // false
+ * console.log(deepEqual({ a: 1 }, { a: 1 }));
+ * console.log(deepEqual({ a: { b: 2 } }, { a: {} }));
+ * console.log(deepEqual({ a: NaN }, { a: NaN }));
+ * console.log(deepEqual({ a: NaN }, { a: null }));
  * ```
  */
 export declare function deepEqual(a: unknown, b: unknown): boolean;
@@ -96,8 +96,8 @@ export declare function deepEqual(a: unknown, b: unknown): boolean;
  * @example
  * ```ts
  * const data = { user: { profile: { name: 'Alice' } } };
- * nameSpace('user.profile.name', data); // 'Alice'
- * nameSpace(['user', 'profile'], data);  // { name: 'Alice' }
+ * console.log(nameSpace('user.profile.name', data));
+ * console.log(nameSpace(['user', 'profile'], data));
  * ```
  */
 export declare function nameSpace(ns: string | string[], obj?: object): unknown;
@@ -112,9 +112,8 @@ export declare function nameSpace(ns: string | string[], obj?: object): unknown;
  * @example
  * ```ts
  * const data = { user: { name: 'Alice' } };
- * parse('Hello {user.name}!', data); // 'Hello Alice!'
- *
- * parse(['Hi {user.name}', 'Bye {user.name}'], data); // ['Hi Alice', 'Bye Alice']
+ * console.log(parse('Hello {user.name}!', data));
+ * console.log(parse(['Hi {user.name}', 'Bye {user.name}'], data));
  * ```
  */
 export declare function parse<T = string | object | unknown[]>(template: T, parseThis: object, ...rest: unknown[]): T;
@@ -126,7 +125,7 @@ export declare function parse<T = string | object | unknown[]>(template: T, pars
  *
  * @example
  * ```ts
- * kebabToPascal('my-element'); // 'MyElement'
+ * console.log(kebabToPascal('my-element'));
  * ```
  */
 export declare function kebabToPascal(str: string): string;
@@ -141,7 +140,8 @@ export declare function kebabToPascal(str: string): string;
  * @example
  * ```ts
  * const log = debounce(() => console.log('called'), 300);
- * log(); // will only execute once after 300ms of inactivity
+ * log();
+ * log();
  * ```
  */
 export declare function debounce<A extends unknown[]>(func: (...args: A) => unknown, milliseconds: number): (...args: A) => void;
@@ -155,7 +155,7 @@ export declare function debounce<A extends unknown[]>(func: (...args: A) => unkn
  * @example
  * ```ts
  * const elems = htmlToElements('<div>Hello</div><span>World</span>');
- * // [HTMLElement<div>, HTMLElement<span>]
+ * console.log(elems.map((el) => el.tagName));
  * ```
  */
 export declare function htmlToElements(html: string): HTMLElement[];
@@ -171,7 +171,7 @@ export declare function htmlToElements(html: string): HTMLElement[];
  * const src = { get name() { return 'Alice'; } };
  * const tgt = {};
  * copyGettersSetters(src, tgt);
- * console.log(tgt.name); // 'Alice'
+ * console.log(tgt.name);
  * ```
  */
 export declare function copyGettersSetters(source: object, target: object): void;

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,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;AAmCD,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAanF;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"}
+{"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;;;;;;;;;;;;;;GAcG;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;;;;;;;;;;;;;;GAcG;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;AAmCD,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAanF;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,CAmC9E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CACjC,WAAW,EAAE,WAAW,GAAG,UAAU,EACrC,QAAQ,EAAE,YAAY,GACpB,IAAI,CA2CN"}