@relax.js/core 1.0.4 → 1.0.5

package/dist/DependencyInjection.d.ts

@@ -141,8 +141,8 @@ declare class Registration {
     scope: ServiceScope;
     inject: (string | Constructor)[];
     properties: Record<string, string | Constructor>;
-    key?: string;
-    instance?: unknown;
+    key?: string | undefined;
+    instance?: unknown | undefined;
     /**
      * Creates a new registration record.
      *
@@ -153,7 +153,7 @@ declare class Registration {
      * @param key - Optional string identifier
      * @param instance - Optional pre-created instance
      */
-    constructor(classConstructor: Constructor, scope: ServiceScope, inject: (string | Constructor)[], properties?: Record<string, string | Constructor>, key?: string, instance?: unknown);
+    constructor(classConstructor: Constructor, scope: ServiceScope, inject: (string | Constructor)[], properties?: Record<string, string | Constructor>, key?: string | undefined, instance?: unknown | undefined);
 }
 /**
  * Registry that stores service registration metadata.

package/dist/collections/LinkedList.d.ts

@@ -27,8 +27,8 @@ export declare class Node<T> {
  * A trivial linked list implementation.
  */
 export declare class LinkedList<T> {
-    private _first?;
-    private _last?;
+    private _first;
+    private _last;
     private _length;
     /**
      * Add a value to the beginning of the list.
@@ -40,6 +40,7 @@ export declare class LinkedList<T> {
      * @param value Value that should be contained in a node.
      */
     addLast(value: T): void;
+    private createNode;
     /**
      * Remove a node from the beginning of the list.
      * @returns Value contained in the first node.
@@ -57,19 +58,19 @@ export declare class LinkedList<T> {
      */
     get length(): number;
     /**
-     * First ndoe.
+     * First node, or `null` if the list is empty.
      */
-    get first(): Node<T> | undefined;
+    get first(): Node<T> | null;
     /**
-     * Contained value of the first node.
+     * Contained value of the first node, or `undefined` if the list is empty.
      */
     get firstValue(): T | undefined;
     /**
-     * Last node.
+     * Last node, or `null` if the list is empty.
      */
-    get last(): Node<T> | undefined;
+    get last(): Node<T> | null;
     /**
-     * Contained value of the last node.
+     * Contained value of the last node, or `undefined` if the list is empty.
      */
     get lastValue(): T | undefined;
 }

package/dist/collections/index.js

@@ -1,2 +1,2 @@
-var u=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var v=(i,t)=>{for(var e in t)u(i,e,{get:t[e],enumerable:!0})},f=(i,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of d(t))!g.call(i,s)&&s!==e&&u(i,s,{get:()=>t[s],enumerable:!(r=p(t,s))||r.enumerable});return i};var _=i=>f(u({},"__esModule",{value:!0}),i);var m={};v(m,{LinkedList:()=>l,Node:()=>n,PageSelectedEvent:()=>a,Pager:()=>o});module.exports=_(m);var n=class{constructor(t,e){this.value=t;this.removeCallback=e;this.next=null;this.prev=null}remove(){this.prev.next=this.next,this.next.prev=this.prev,this.removeCallback()}},l=class{constructor(){this._length=0}addFirst(t){let e=new n(t,()=>this._length--);this._first?(e.next=this._first,this._first.prev=e,this._first=e):(this._first=e,this._last=this._first),this._length++}addLast(t){let e=new n(t,()=>this._length--);this._first?(e.prev=this._last,this._last.next=e,this._last=e):(this._first=e,this._last=this._first),this._length++}removeFirst(){if(!this.first)throw new Error("The list is empty.");let t=this._first.value;return this._first=this._first.next,this._length--,t}removeLast(){if(!this.last)throw new Error("The list is empty.");let t=this._last.value;return this._last=this._last.prev,this._length--,t}get length(){return this._length}get first(){return this._first}get firstValue(){return this._first?.value}get last(){return this._last}get lastValue(){return this._last?.value}};var a=class extends Event{constructor(e){super("pageselected",{bubbles:!0,composed:!0});this.page=e}},o=class{constructor(t,e,r){this.currentPage=1;this.container=t,this.totalCount=e,this.pageSize=r,this.render()}render(){this.container.innerHTML="";let t=Math.max(1,Math.ceil(this.totalCount/this.pageSize)),e=(r,s,c=!1)=>{let h=document.createElement("button");return h.textContent=r,h.disabled=c,h.addEventListener("click",()=>this.selectPage(s)),h};this.container.appendChild(e("Previous",this.currentPage-1,this.currentPage===1));for(let r=1;r<=t;r++){let s=e(r.toString(),r);r===this.currentPage&&s.classList.add("selected"),this.container.appendChild(s)}this.container.appendChild(e("Next",this.currentPage+1,this.currentPage===t))}selectPage(t){let e=Math.max(1,Math.ceil(this.totalCount/this.pageSize));t<1||t>e||t===this.currentPage||(this.currentPage=t,this.render(),this.container.dispatchEvent(new a(this.currentPage)))}update(t){this.totalCount=t;let e=Math.max(1,Math.ceil(this.totalCount/this.pageSize));this.currentPage>e&&(this.currentPage=e),this.render()}getCurrentPage(){return this.currentPage}};
+"use strict";var u=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var f=(s,e)=>{for(var t in e)u(s,t,{get:e[t],enumerable:!0})},g=(s,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of d(e))!_.call(s,r)&&r!==t&&u(s,r,{get:()=>e[r],enumerable:!(i=p(e,r))||i.enumerable});return s};var v=s=>g(u({},"__esModule",{value:!0}),s);var m={};f(m,{LinkedList:()=>h,Node:()=>n,PageSelectedEvent:()=>a,Pager:()=>o});module.exports=v(m);var n=class{constructor(e,t){this.value=e;this.removeCallback=t;this.next=null;this.prev=null}remove(){this.prev&&(this.prev.next=this.next),this.next&&(this.next.prev=this.prev),this.removeCallback()}},h=class{constructor(){this._first=null;this._last=null;this._length=0}addFirst(e){let t=this.createNode(e);this._first?(t.next=this._first,this._first.prev=t,this._first=t):(this._first=t,this._last=this._first),this._length++}addLast(e){let t=this.createNode(e);this._last?(t.prev=this._last,this._last.next=t,this._last=t):(this._first=t,this._last=t),this._length++}createNode(e){let t;return t=new n(e,()=>{this._first===t&&(this._first=t.next),this._last===t&&(this._last=t.prev),this._length--}),t}removeFirst(){if(!this._first)throw new Error("The list is empty.");let e=this._first.value;return this._first=this._first.next,this._first||(this._last=null),this._length--,e}removeLast(){if(!this._last)throw new Error("The list is empty.");let e=this._last.value;return this._last=this._last.prev,this._last||(this._first=null),this._length--,e}get length(){return this._length}get first(){return this._first}get firstValue(){return this._first?.value}get last(){return this._last}get lastValue(){return this._last?.value}};var a=class extends Event{constructor(t){super("pageselected",{bubbles:!0,composed:!0});this.page=t}},o=class{constructor(e,t,i){this.currentPage=1;this.container=e,this.totalCount=t,this.pageSize=i,this.render()}render(){this.container.innerHTML="";let e=Math.max(1,Math.ceil(this.totalCount/this.pageSize)),t=(i,r,c=!1)=>{let l=document.createElement("button");return l.textContent=i,l.disabled=c,l.addEventListener("click",()=>this.selectPage(r)),l};this.container.appendChild(t("Previous",this.currentPage-1,this.currentPage===1));for(let i=1;i<=e;i++){let r=t(i.toString(),i);i===this.currentPage&&r.classList.add("selected"),this.container.appendChild(r)}this.container.appendChild(t("Next",this.currentPage+1,this.currentPage===e))}selectPage(e){let t=Math.max(1,Math.ceil(this.totalCount/this.pageSize));e<1||e>t||e===this.currentPage||(this.currentPage=e,this.render(),this.container.dispatchEvent(new a(this.currentPage)))}update(e){this.totalCount=e;let t=Math.max(1,Math.ceil(this.totalCount/this.pageSize));this.currentPage>t&&(this.currentPage=t),this.render()}getCurrentPage(){return this.currentPage}};
 //# sourceMappingURL=index.js.map

package/dist/collections/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/collections/Index.ts", "../../src/collections/LinkedList.ts", "../../src/collections/Pager.ts"],
-  "sourcesContent": ["export {LinkedList, Node} from \"./LinkedList\";\nexport { Pager, PageSelectedEvent } from \"./Pager\";\nexport { type DataLoader } from \"./DataLoader\";", "/**\r\n * A node in the @see LinkedList.\r\n */\r\nexport class Node<T> {\r\n    /**\r\n     * Next node unless last one.\r\n     */\r\n    public next: Node<T> | null = null;\r\n    /**\r\n     * Previous node unless first one.\r\n     */\r\n    public prev: Node<T> | null = null;\r\n\r\n    /**\r\n     * Constructor.\r\n     * @param value Value contained in the node.\r\n     */\r\n    constructor(public value: T, private removeCallback: () => void) {}\r\n\r\n    /**\r\n     * Remove this node.\r\n     * Will notify the list of the update to ensure correct element count.\r\n     */\r\n    remove() {\r\n        this.prev.next = this.next;\r\n        this.next.prev = this.prev;\r\n        this.removeCallback();\r\n    }\r\n}\r\n\r\n/**\r\n * A trivial linked list implementation.\r\n */\r\nexport class LinkedList<T> {\r\n    private _first?: Node<T>;\r\n    private _last?: Node<T>;\r\n    private _length = 0;\r\n\r\n    /**\r\n     * Add a value to the beginning of the list.\r\n     * @param value Value that should be contained in the node.\r\n     */\r\n    addFirst(value: T) {\r\n        const newNode = new Node(value, () => this._length--);\r\n        if (!this._first) {\r\n            this._first = newNode;\r\n            this._last = this._first;\r\n        } else {\r\n            newNode.next = this._first;\r\n            this._first.prev = newNode;\r\n            this._first = newNode;\r\n        }\r\n\r\n        this._length++;\r\n    }\r\n\r\n    /**\r\n     * Add a value to the end of the list.\r\n     * @param value Value that should be contained in a node.\r\n     */\r\n    addLast(value: T) {\r\n        const newNode = new Node(value, () => this._length--);\r\n        if (!this._first) {\r\n            this._first = newNode;\r\n            this._last = this._first;\r\n        } else {\r\n            newNode.prev = this._last;\r\n            this._last.next = newNode;\r\n            this._last = newNode;\r\n        }\r\n\r\n        this._length++;\r\n    }\r\n\r\n    /**\r\n     * Remove a node from the beginning of the list.\r\n     * @returns Value contained in the first node.\r\n     */\r\n    removeFirst(): T {\r\n        if (!this.first) {\r\n            throw new Error('The list is empty.');\r\n        }\r\n\r\n        const value = this._first.value;\r\n        this._first = this._first.next;\r\n        this._length--;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Remove a node from the end of the list.\r\n     * @returns Value contained in the last node.\r\n     */\r\n    removeLast(): T {\r\n        if (!this.last) {\r\n            throw new Error('The list is empty.');\r\n        }\r\n\r\n        const value = this._last.value;\r\n        this._last = this._last.prev;\r\n        this._length--;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Number of nodes in the list.\r\n     *\r\n     * The count works as long as you do not manually remove nodes (by assigning next/prev to the neighbors).\r\n     */\r\n    get length(): number {\r\n        return this._length;\r\n    }\r\n\r\n    /**\r\n     * First ndoe.\r\n     */\r\n    get first(): Node<T> | undefined {\r\n        return this._first;\r\n    }\r\n\r\n    /**\r\n     * Contained value of the first node.\r\n     */\r\n    get firstValue(): T | undefined {\r\n        return this._first?.value;\r\n    }\r\n\r\n    /**\r\n     * Last node.\r\n     */\r\n    get last(): Node<T> | undefined {\r\n        return this._last;\r\n    }\r\n\r\n    /**\r\n     * Contained value of the last node.\r\n     */\r\n    get lastValue(): T | undefined {\r\n        return this._last?.value;\r\n    }\r\n}\r\n", "export class PageSelectedEvent extends Event {\r\n  constructor(public page: number) {\r\n    super('pageselected', {\r\n      bubbles: true,\r\n      composed: true,\r\n    });\r\n  }\r\n}\r\n\r\ndeclare global {\r\n  interface HTMLElementEventMap {\r\n    'pageselected': PageSelectedEvent;\r\n  }\r\n}\r\n\r\nexport class Pager {\r\n  private container: HTMLElement;\r\n  private totalCount: number;\r\n  private pageSize: number;\r\n  private currentPage: number = 1;\r\n\r\n  constructor(container: HTMLElement, totalCount: number, pageSize: number) {\r\n    this.container = container;\r\n    this.totalCount = totalCount;\r\n    this.pageSize = pageSize;\r\n\r\n    this.render();\r\n  }\r\n\r\n  private render() {\r\n    this.container.innerHTML = '';\r\n\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n\r\n    const createButton = (label: string, page: number, disabled: boolean = false) => {\r\n      const btn = document.createElement('button');\r\n      btn.textContent = label;\r\n      btn.disabled = disabled;\r\n      btn.addEventListener('click', () => this.selectPage(page));\r\n      return btn;\r\n    };\r\n\r\n    this.container.appendChild(\r\n      createButton('Previous', this.currentPage - 1, this.currentPage === 1)\r\n    );\r\n\r\n    for (let i = 1; i <= pageCount; i++) {\r\n      const btn = createButton(i.toString(), i);\r\n      if (i === this.currentPage) {\r\n        btn.classList.add('selected');\r\n      }\r\n      this.container.appendChild(btn);\r\n    }\r\n\r\n    this.container.appendChild(\r\n      createButton('Next', this.currentPage + 1, this.currentPage === pageCount)\r\n    );\r\n  }\r\n\r\n  private selectPage(page: number) {\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n    if (page < 1 || page > pageCount || page === this.currentPage) return;\r\n\r\n    this.currentPage = page;\r\n    this.render();\r\n\r\n    this.container.dispatchEvent(new PageSelectedEvent(this.currentPage));\r\n  }\r\n\r\n  public update(totalCount: number) {\r\n    this.totalCount = totalCount;\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n    if (this.currentPage > pageCount) {\r\n      this.currentPage = pageCount;\r\n    }\r\n    this.render();\r\n  }\r\n\r\n  public getCurrentPage(): number {\r\n    return this.currentPage;\r\n  }\r\n}\r\n"],
-  "mappings": "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",
-  "names": ["Index_exports", "__export", "LinkedList", "Node", "PageSelectedEvent", "Pager", "__toCommonJS", "Node", "value", "removeCallback", "LinkedList", "newNode", "PageSelectedEvent", "page", "Pager", "container", "totalCount", "pageSize", "pageCount", "createButton", "label", "disabled", "btn", "i"]
+  "sourcesContent": ["export {LinkedList, Node} from \"./LinkedList\";\nexport { Pager, PageSelectedEvent } from \"./Pager\";\nexport { type DataLoader } from \"./DataLoader\";", "/**\r\n * A node in the @see LinkedList.\r\n */\r\nexport class Node<T> {\r\n    /**\r\n     * Next node unless last one.\r\n     */\r\n    public next: Node<T> | null = null;\r\n    /**\r\n     * Previous node unless first one.\r\n     */\r\n    public prev: Node<T> | null = null;\r\n\r\n    /**\r\n     * Constructor.\r\n     * @param value Value contained in the node.\r\n     */\r\n    constructor(public value: T, private removeCallback: () => void) {}\r\n\r\n    /**\r\n     * Remove this node.\r\n     * Will notify the list of the update to ensure correct element count.\r\n     */\r\n    remove() {\r\n        if (this.prev) this.prev.next = this.next;\r\n        if (this.next) this.next.prev = this.prev;\r\n        this.removeCallback();\r\n    }\r\n}\r\n\r\n/**\r\n * A trivial linked list implementation.\r\n */\r\nexport class LinkedList<T> {\r\n    private _first: Node<T> | null = null;\r\n    private _last: Node<T> | null = null;\r\n    private _length = 0;\r\n\r\n    /**\r\n     * Add a value to the beginning of the list.\r\n     * @param value Value that should be contained in the node.\r\n     */\r\n    addFirst(value: T) {\r\n        const newNode = this.createNode(value);\r\n        if (!this._first) {\r\n            this._first = newNode;\r\n            this._last = this._first;\r\n        } else {\r\n            newNode.next = this._first;\r\n            this._first.prev = newNode;\r\n            this._first = newNode;\r\n        }\r\n\r\n        this._length++;\r\n    }\r\n\r\n    /**\r\n     * Add a value to the end of the list.\r\n     * @param value Value that should be contained in a node.\r\n     */\r\n    addLast(value: T) {\r\n        const newNode = this.createNode(value);\r\n        if (!this._last) {\r\n            this._first = newNode;\r\n            this._last = newNode;\r\n        } else {\r\n            newNode.prev = this._last;\r\n            this._last.next = newNode;\r\n            this._last = newNode;\r\n        }\r\n\r\n        this._length++;\r\n    }\r\n\r\n    private createNode(value: T): Node<T> {\r\n        let node: Node<T>;\r\n        node = new Node(value, () => {\r\n            if (this._first === node) this._first = node.next;\r\n            if (this._last === node) this._last = node.prev;\r\n            this._length--;\r\n        });\r\n        return node;\r\n    }\r\n\r\n    /**\r\n     * Remove a node from the beginning of the list.\r\n     * @returns Value contained in the first node.\r\n     */\r\n    removeFirst(): T {\r\n        if (!this._first) {\r\n            throw new Error('The list is empty.');\r\n        }\r\n\r\n        const value = this._first.value;\r\n        this._first = this._first.next;\r\n        if (!this._first) this._last = null;\r\n        this._length--;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Remove a node from the end of the list.\r\n     * @returns Value contained in the last node.\r\n     */\r\n    removeLast(): T {\r\n        if (!this._last) {\r\n            throw new Error('The list is empty.');\r\n        }\r\n\r\n        const value = this._last.value;\r\n        this._last = this._last.prev;\r\n        if (!this._last) this._first = null;\r\n        this._length--;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Number of nodes in the list.\r\n     *\r\n     * The count works as long as you do not manually remove nodes (by assigning next/prev to the neighbors).\r\n     */\r\n    get length(): number {\r\n        return this._length;\r\n    }\r\n\r\n    /**\r\n     * First node, or `null` if the list is empty.\r\n     */\r\n    get first(): Node<T> | null {\r\n        return this._first;\r\n    }\r\n\r\n    /**\r\n     * Contained value of the first node, or `undefined` if the list is empty.\r\n     */\r\n    get firstValue(): T | undefined {\r\n        return this._first?.value;\r\n    }\r\n\r\n    /**\r\n     * Last node, or `null` if the list is empty.\r\n     */\r\n    get last(): Node<T> | null {\r\n        return this._last;\r\n    }\r\n\r\n    /**\r\n     * Contained value of the last node, or `undefined` if the list is empty.\r\n     */\r\n    get lastValue(): T | undefined {\r\n        return this._last?.value;\r\n    }\r\n}\r\n", "export class PageSelectedEvent extends Event {\r\n  constructor(public page: number) {\r\n    super('pageselected', {\r\n      bubbles: true,\r\n      composed: true,\r\n    });\r\n  }\r\n}\r\n\r\ndeclare global {\r\n  interface HTMLElementEventMap {\r\n    'pageselected': PageSelectedEvent;\r\n  }\r\n}\r\n\r\nexport class Pager {\r\n  private container: HTMLElement;\r\n  private totalCount: number;\r\n  private pageSize: number;\r\n  private currentPage: number = 1;\r\n\r\n  constructor(container: HTMLElement, totalCount: number, pageSize: number) {\r\n    this.container = container;\r\n    this.totalCount = totalCount;\r\n    this.pageSize = pageSize;\r\n\r\n    this.render();\r\n  }\r\n\r\n  private render() {\r\n    this.container.innerHTML = '';\r\n\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n\r\n    const createButton = (label: string, page: number, disabled: boolean = false) => {\r\n      const btn = document.createElement('button');\r\n      btn.textContent = label;\r\n      btn.disabled = disabled;\r\n      btn.addEventListener('click', () => this.selectPage(page));\r\n      return btn;\r\n    };\r\n\r\n    this.container.appendChild(\r\n      createButton('Previous', this.currentPage - 1, this.currentPage === 1)\r\n    );\r\n\r\n    for (let i = 1; i <= pageCount; i++) {\r\n      const btn = createButton(i.toString(), i);\r\n      if (i === this.currentPage) {\r\n        btn.classList.add('selected');\r\n      }\r\n      this.container.appendChild(btn);\r\n    }\r\n\r\n    this.container.appendChild(\r\n      createButton('Next', this.currentPage + 1, this.currentPage === pageCount)\r\n    );\r\n  }\r\n\r\n  private selectPage(page: number) {\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n    if (page < 1 || page > pageCount || page === this.currentPage) return;\r\n\r\n    this.currentPage = page;\r\n    this.render();\r\n\r\n    this.container.dispatchEvent(new PageSelectedEvent(this.currentPage));\r\n  }\r\n\r\n  public update(totalCount: number) {\r\n    this.totalCount = totalCount;\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n    if (this.currentPage > pageCount) {\r\n      this.currentPage = pageCount;\r\n    }\r\n    this.render();\r\n  }\r\n\r\n  public getCurrentPage(): number {\r\n    return this.currentPage;\r\n  }\r\n}\r\n"],
+  "mappings": "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",
+  "names": ["Index_exports", "__export", "LinkedList", "Node", "PageSelectedEvent", "Pager", "__toCommonJS", "Node", "value", "removeCallback", "LinkedList", "newNode", "node", "PageSelectedEvent", "page", "Pager", "container", "totalCount", "pageSize", "pageCount", "createButton", "label", "disabled", "btn"]
 }

package/dist/collections/index.mjs

@@ -1,2 +1,2 @@
-var i=class{constructor(e,t){this.value=e;this.removeCallback=t;this.next=null;this.prev=null}remove(){this.prev.next=this.next,this.next.prev=this.prev,this.removeCallback()}},l=class{constructor(){this._length=0}addFirst(e){let t=new i(e,()=>this._length--);this._first?(t.next=this._first,this._first.prev=t,this._first=t):(this._first=t,this._last=this._first),this._length++}addLast(e){let t=new i(e,()=>this._length--);this._first?(t.prev=this._last,this._last.next=t,this._last=t):(this._first=t,this._last=this._first),this._length++}removeFirst(){if(!this.first)throw new Error("The list is empty.");let e=this._first.value;return this._first=this._first.next,this._length--,e}removeLast(){if(!this.last)throw new Error("The list is empty.");let e=this._last.value;return this._last=this._last.prev,this._length--,e}get length(){return this._length}get first(){return this._first}get firstValue(){return this._first?.value}get last(){return this._last}get lastValue(){return this._last?.value}};var a=class extends Event{constructor(t){super("pageselected",{bubbles:!0,composed:!0});this.page=t}},o=class{constructor(e,t,r){this.currentPage=1;this.container=e,this.totalCount=t,this.pageSize=r,this.render()}render(){this.container.innerHTML="";let e=Math.max(1,Math.ceil(this.totalCount/this.pageSize)),t=(r,s,u=!1)=>{let n=document.createElement("button");return n.textContent=r,n.disabled=u,n.addEventListener("click",()=>this.selectPage(s)),n};this.container.appendChild(t("Previous",this.currentPage-1,this.currentPage===1));for(let r=1;r<=e;r++){let s=t(r.toString(),r);r===this.currentPage&&s.classList.add("selected"),this.container.appendChild(s)}this.container.appendChild(t("Next",this.currentPage+1,this.currentPage===e))}selectPage(e){let t=Math.max(1,Math.ceil(this.totalCount/this.pageSize));e<1||e>t||e===this.currentPage||(this.currentPage=e,this.render(),this.container.dispatchEvent(new a(this.currentPage)))}update(e){this.totalCount=e;let t=Math.max(1,Math.ceil(this.totalCount/this.pageSize));this.currentPage>t&&(this.currentPage=t),this.render()}getCurrentPage(){return this.currentPage}};export{l as LinkedList,i as Node,a as PageSelectedEvent,o as Pager};
+var n=class{constructor(e,t){this.value=e;this.removeCallback=t;this.next=null;this.prev=null}remove(){this.prev&&(this.prev.next=this.next),this.next&&(this.next.prev=this.prev),this.removeCallback()}},h=class{constructor(){this._first=null;this._last=null;this._length=0}addFirst(e){let t=this.createNode(e);this._first?(t.next=this._first,this._first.prev=t,this._first=t):(this._first=t,this._last=this._first),this._length++}addLast(e){let t=this.createNode(e);this._last?(t.prev=this._last,this._last.next=t,this._last=t):(this._first=t,this._last=t),this._length++}createNode(e){let t;return t=new n(e,()=>{this._first===t&&(this._first=t.next),this._last===t&&(this._last=t.prev),this._length--}),t}removeFirst(){if(!this._first)throw new Error("The list is empty.");let e=this._first.value;return this._first=this._first.next,this._first||(this._last=null),this._length--,e}removeLast(){if(!this._last)throw new Error("The list is empty.");let e=this._last.value;return this._last=this._last.prev,this._last||(this._first=null),this._length--,e}get length(){return this._length}get first(){return this._first}get firstValue(){return this._first?.value}get last(){return this._last}get lastValue(){return this._last?.value}};var a=class extends Event{constructor(t){super("pageselected",{bubbles:!0,composed:!0});this.page=t}},o=class{constructor(e,t,i){this.currentPage=1;this.container=e,this.totalCount=t,this.pageSize=i,this.render()}render(){this.container.innerHTML="";let e=Math.max(1,Math.ceil(this.totalCount/this.pageSize)),t=(i,s,u=!1)=>{let r=document.createElement("button");return r.textContent=i,r.disabled=u,r.addEventListener("click",()=>this.selectPage(s)),r};this.container.appendChild(t("Previous",this.currentPage-1,this.currentPage===1));for(let i=1;i<=e;i++){let s=t(i.toString(),i);i===this.currentPage&&s.classList.add("selected"),this.container.appendChild(s)}this.container.appendChild(t("Next",this.currentPage+1,this.currentPage===e))}selectPage(e){let t=Math.max(1,Math.ceil(this.totalCount/this.pageSize));e<1||e>t||e===this.currentPage||(this.currentPage=e,this.render(),this.container.dispatchEvent(new a(this.currentPage)))}update(e){this.totalCount=e;let t=Math.max(1,Math.ceil(this.totalCount/this.pageSize));this.currentPage>t&&(this.currentPage=t),this.render()}getCurrentPage(){return this.currentPage}};export{h as LinkedList,n as Node,a as PageSelectedEvent,o as Pager};
 //# sourceMappingURL=index.mjs.map

package/dist/collections/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/collections/LinkedList.ts", "../../src/collections/Pager.ts"],
-  "sourcesContent": ["/**\r\n * A node in the @see LinkedList.\r\n */\r\nexport class Node<T> {\r\n    /**\r\n     * Next node unless last one.\r\n     */\r\n    public next: Node<T> | null = null;\r\n    /**\r\n     * Previous node unless first one.\r\n     */\r\n    public prev: Node<T> | null = null;\r\n\r\n    /**\r\n     * Constructor.\r\n     * @param value Value contained in the node.\r\n     */\r\n    constructor(public value: T, private removeCallback: () => void) {}\r\n\r\n    /**\r\n     * Remove this node.\r\n     * Will notify the list of the update to ensure correct element count.\r\n     */\r\n    remove() {\r\n        this.prev.next = this.next;\r\n        this.next.prev = this.prev;\r\n        this.removeCallback();\r\n    }\r\n}\r\n\r\n/**\r\n * A trivial linked list implementation.\r\n */\r\nexport class LinkedList<T> {\r\n    private _first?: Node<T>;\r\n    private _last?: Node<T>;\r\n    private _length = 0;\r\n\r\n    /**\r\n     * Add a value to the beginning of the list.\r\n     * @param value Value that should be contained in the node.\r\n     */\r\n    addFirst(value: T) {\r\n        const newNode = new Node(value, () => this._length--);\r\n        if (!this._first) {\r\n            this._first = newNode;\r\n            this._last = this._first;\r\n        } else {\r\n            newNode.next = this._first;\r\n            this._first.prev = newNode;\r\n            this._first = newNode;\r\n        }\r\n\r\n        this._length++;\r\n    }\r\n\r\n    /**\r\n     * Add a value to the end of the list.\r\n     * @param value Value that should be contained in a node.\r\n     */\r\n    addLast(value: T) {\r\n        const newNode = new Node(value, () => this._length--);\r\n        if (!this._first) {\r\n            this._first = newNode;\r\n            this._last = this._first;\r\n        } else {\r\n            newNode.prev = this._last;\r\n            this._last.next = newNode;\r\n            this._last = newNode;\r\n        }\r\n\r\n        this._length++;\r\n    }\r\n\r\n    /**\r\n     * Remove a node from the beginning of the list.\r\n     * @returns Value contained in the first node.\r\n     */\r\n    removeFirst(): T {\r\n        if (!this.first) {\r\n            throw new Error('The list is empty.');\r\n        }\r\n\r\n        const value = this._first.value;\r\n        this._first = this._first.next;\r\n        this._length--;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Remove a node from the end of the list.\r\n     * @returns Value contained in the last node.\r\n     */\r\n    removeLast(): T {\r\n        if (!this.last) {\r\n            throw new Error('The list is empty.');\r\n        }\r\n\r\n        const value = this._last.value;\r\n        this._last = this._last.prev;\r\n        this._length--;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Number of nodes in the list.\r\n     *\r\n     * The count works as long as you do not manually remove nodes (by assigning next/prev to the neighbors).\r\n     */\r\n    get length(): number {\r\n        return this._length;\r\n    }\r\n\r\n    /**\r\n     * First ndoe.\r\n     */\r\n    get first(): Node<T> | undefined {\r\n        return this._first;\r\n    }\r\n\r\n    /**\r\n     * Contained value of the first node.\r\n     */\r\n    get firstValue(): T | undefined {\r\n        return this._first?.value;\r\n    }\r\n\r\n    /**\r\n     * Last node.\r\n     */\r\n    get last(): Node<T> | undefined {\r\n        return this._last;\r\n    }\r\n\r\n    /**\r\n     * Contained value of the last node.\r\n     */\r\n    get lastValue(): T | undefined {\r\n        return this._last?.value;\r\n    }\r\n}\r\n", "export class PageSelectedEvent extends Event {\r\n  constructor(public page: number) {\r\n    super('pageselected', {\r\n      bubbles: true,\r\n      composed: true,\r\n    });\r\n  }\r\n}\r\n\r\ndeclare global {\r\n  interface HTMLElementEventMap {\r\n    'pageselected': PageSelectedEvent;\r\n  }\r\n}\r\n\r\nexport class Pager {\r\n  private container: HTMLElement;\r\n  private totalCount: number;\r\n  private pageSize: number;\r\n  private currentPage: number = 1;\r\n\r\n  constructor(container: HTMLElement, totalCount: number, pageSize: number) {\r\n    this.container = container;\r\n    this.totalCount = totalCount;\r\n    this.pageSize = pageSize;\r\n\r\n    this.render();\r\n  }\r\n\r\n  private render() {\r\n    this.container.innerHTML = '';\r\n\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n\r\n    const createButton = (label: string, page: number, disabled: boolean = false) => {\r\n      const btn = document.createElement('button');\r\n      btn.textContent = label;\r\n      btn.disabled = disabled;\r\n      btn.addEventListener('click', () => this.selectPage(page));\r\n      return btn;\r\n    };\r\n\r\n    this.container.appendChild(\r\n      createButton('Previous', this.currentPage - 1, this.currentPage === 1)\r\n    );\r\n\r\n    for (let i = 1; i <= pageCount; i++) {\r\n      const btn = createButton(i.toString(), i);\r\n      if (i === this.currentPage) {\r\n        btn.classList.add('selected');\r\n      }\r\n      this.container.appendChild(btn);\r\n    }\r\n\r\n    this.container.appendChild(\r\n      createButton('Next', this.currentPage + 1, this.currentPage === pageCount)\r\n    );\r\n  }\r\n\r\n  private selectPage(page: number) {\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n    if (page < 1 || page > pageCount || page === this.currentPage) return;\r\n\r\n    this.currentPage = page;\r\n    this.render();\r\n\r\n    this.container.dispatchEvent(new PageSelectedEvent(this.currentPage));\r\n  }\r\n\r\n  public update(totalCount: number) {\r\n    this.totalCount = totalCount;\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n    if (this.currentPage > pageCount) {\r\n      this.currentPage = pageCount;\r\n    }\r\n    this.render();\r\n  }\r\n\r\n  public getCurrentPage(): number {\r\n    return this.currentPage;\r\n  }\r\n}\r\n"],
-  "mappings": "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",
-  "names": ["Node", "value", "removeCallback", "LinkedList", "newNode", "PageSelectedEvent", "page", "Pager", "container", "totalCount", "pageSize", "pageCount", "createButton", "label", "disabled", "btn", "i"]
+  "sourcesContent": ["/**\r\n * A node in the @see LinkedList.\r\n */\r\nexport class Node<T> {\r\n    /**\r\n     * Next node unless last one.\r\n     */\r\n    public next: Node<T> | null = null;\r\n    /**\r\n     * Previous node unless first one.\r\n     */\r\n    public prev: Node<T> | null = null;\r\n\r\n    /**\r\n     * Constructor.\r\n     * @param value Value contained in the node.\r\n     */\r\n    constructor(public value: T, private removeCallback: () => void) {}\r\n\r\n    /**\r\n     * Remove this node.\r\n     * Will notify the list of the update to ensure correct element count.\r\n     */\r\n    remove() {\r\n        if (this.prev) this.prev.next = this.next;\r\n        if (this.next) this.next.prev = this.prev;\r\n        this.removeCallback();\r\n    }\r\n}\r\n\r\n/**\r\n * A trivial linked list implementation.\r\n */\r\nexport class LinkedList<T> {\r\n    private _first: Node<T> | null = null;\r\n    private _last: Node<T> | null = null;\r\n    private _length = 0;\r\n\r\n    /**\r\n     * Add a value to the beginning of the list.\r\n     * @param value Value that should be contained in the node.\r\n     */\r\n    addFirst(value: T) {\r\n        const newNode = this.createNode(value);\r\n        if (!this._first) {\r\n            this._first = newNode;\r\n            this._last = this._first;\r\n        } else {\r\n            newNode.next = this._first;\r\n            this._first.prev = newNode;\r\n            this._first = newNode;\r\n        }\r\n\r\n        this._length++;\r\n    }\r\n\r\n    /**\r\n     * Add a value to the end of the list.\r\n     * @param value Value that should be contained in a node.\r\n     */\r\n    addLast(value: T) {\r\n        const newNode = this.createNode(value);\r\n        if (!this._last) {\r\n            this._first = newNode;\r\n            this._last = newNode;\r\n        } else {\r\n            newNode.prev = this._last;\r\n            this._last.next = newNode;\r\n            this._last = newNode;\r\n        }\r\n\r\n        this._length++;\r\n    }\r\n\r\n    private createNode(value: T): Node<T> {\r\n        let node: Node<T>;\r\n        node = new Node(value, () => {\r\n            if (this._first === node) this._first = node.next;\r\n            if (this._last === node) this._last = node.prev;\r\n            this._length--;\r\n        });\r\n        return node;\r\n    }\r\n\r\n    /**\r\n     * Remove a node from the beginning of the list.\r\n     * @returns Value contained in the first node.\r\n     */\r\n    removeFirst(): T {\r\n        if (!this._first) {\r\n            throw new Error('The list is empty.');\r\n        }\r\n\r\n        const value = this._first.value;\r\n        this._first = this._first.next;\r\n        if (!this._first) this._last = null;\r\n        this._length--;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Remove a node from the end of the list.\r\n     * @returns Value contained in the last node.\r\n     */\r\n    removeLast(): T {\r\n        if (!this._last) {\r\n            throw new Error('The list is empty.');\r\n        }\r\n\r\n        const value = this._last.value;\r\n        this._last = this._last.prev;\r\n        if (!this._last) this._first = null;\r\n        this._length--;\r\n        return value;\r\n    }\r\n\r\n    /**\r\n     * Number of nodes in the list.\r\n     *\r\n     * The count works as long as you do not manually remove nodes (by assigning next/prev to the neighbors).\r\n     */\r\n    get length(): number {\r\n        return this._length;\r\n    }\r\n\r\n    /**\r\n     * First node, or `null` if the list is empty.\r\n     */\r\n    get first(): Node<T> | null {\r\n        return this._first;\r\n    }\r\n\r\n    /**\r\n     * Contained value of the first node, or `undefined` if the list is empty.\r\n     */\r\n    get firstValue(): T | undefined {\r\n        return this._first?.value;\r\n    }\r\n\r\n    /**\r\n     * Last node, or `null` if the list is empty.\r\n     */\r\n    get last(): Node<T> | null {\r\n        return this._last;\r\n    }\r\n\r\n    /**\r\n     * Contained value of the last node, or `undefined` if the list is empty.\r\n     */\r\n    get lastValue(): T | undefined {\r\n        return this._last?.value;\r\n    }\r\n}\r\n", "export class PageSelectedEvent extends Event {\r\n  constructor(public page: number) {\r\n    super('pageselected', {\r\n      bubbles: true,\r\n      composed: true,\r\n    });\r\n  }\r\n}\r\n\r\ndeclare global {\r\n  interface HTMLElementEventMap {\r\n    'pageselected': PageSelectedEvent;\r\n  }\r\n}\r\n\r\nexport class Pager {\r\n  private container: HTMLElement;\r\n  private totalCount: number;\r\n  private pageSize: number;\r\n  private currentPage: number = 1;\r\n\r\n  constructor(container: HTMLElement, totalCount: number, pageSize: number) {\r\n    this.container = container;\r\n    this.totalCount = totalCount;\r\n    this.pageSize = pageSize;\r\n\r\n    this.render();\r\n  }\r\n\r\n  private render() {\r\n    this.container.innerHTML = '';\r\n\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n\r\n    const createButton = (label: string, page: number, disabled: boolean = false) => {\r\n      const btn = document.createElement('button');\r\n      btn.textContent = label;\r\n      btn.disabled = disabled;\r\n      btn.addEventListener('click', () => this.selectPage(page));\r\n      return btn;\r\n    };\r\n\r\n    this.container.appendChild(\r\n      createButton('Previous', this.currentPage - 1, this.currentPage === 1)\r\n    );\r\n\r\n    for (let i = 1; i <= pageCount; i++) {\r\n      const btn = createButton(i.toString(), i);\r\n      if (i === this.currentPage) {\r\n        btn.classList.add('selected');\r\n      }\r\n      this.container.appendChild(btn);\r\n    }\r\n\r\n    this.container.appendChild(\r\n      createButton('Next', this.currentPage + 1, this.currentPage === pageCount)\r\n    );\r\n  }\r\n\r\n  private selectPage(page: number) {\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n    if (page < 1 || page > pageCount || page === this.currentPage) return;\r\n\r\n    this.currentPage = page;\r\n    this.render();\r\n\r\n    this.container.dispatchEvent(new PageSelectedEvent(this.currentPage));\r\n  }\r\n\r\n  public update(totalCount: number) {\r\n    this.totalCount = totalCount;\r\n    const pageCount = Math.max(1, Math.ceil(this.totalCount / this.pageSize));\r\n    if (this.currentPage > pageCount) {\r\n      this.currentPage = pageCount;\r\n    }\r\n    this.render();\r\n  }\r\n\r\n  public getCurrentPage(): number {\r\n    return this.currentPage;\r\n  }\r\n}\r\n"],
+  "mappings": "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",
+  "names": ["Node", "value", "removeCallback", "LinkedList", "newNode", "node", "PageSelectedEvent", "page", "Pager", "container", "totalCount", "pageSize", "pageCount", "createButton", "label", "disabled", "btn"]
 }

package/dist/di/index.js

@@ -1,2 +1,2 @@
-var d=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var h=Object.prototype.hasOwnProperty;var x=(n,t)=>{for(var e in t)d(n,e,{get:t[e],enumerable:!0})},C=(n,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of f(t))!h.call(n,s)&&s!==e&&d(n,s,{get:()=>t[s],enumerable:!(r=y(t,s))||r.enumerable});return n};var T=n=>C(d({},"__esModule",{value:!0}),n);var b={};x(b,{ContainerService:()=>j,Inject:()=>m,ServiceCollection:()=>a,ServiceContainer:()=>l,container:()=>v,serviceCollection:()=>g});module.exports=T(b);var u=class extends Error{constructor(e,r){super(e);this.context=r}},p=null;function o(n,t){let e=new u(n,t);if(p){let r=!1;if(p(e,{suppress(){r=!0}}),r)return null}return e}function m(n){return(t,e)=>function(){return v.resolve(n)}}function j(n){return t=>{let e=n??{inject:[]};e.key?g.register(t,e):g.registerByType(t,e)}}var c=class{constructor(t,e,r,s={},i,w){this.classConstructor=t;this.scope=e;this.inject=r;this.properties=s;this.key=i;this.instance=w}},a=class{constructor(){this.servicesByKey=new Map;this.servicesByClassName=new Map}register(t,e){this.validateRegistration(t,e);let r=new c(t,e.scope??"global",e.inject,e.properties??{},e.key,e.instance);e.key&&this.servicesByKey.set(e.key,r),this.servicesByClassName.set(t.name,r)}registerByType(t,e){this.checkNameCollision(t),e&&this.validateRegistration(t,e);let r=new c(t,e?.scope,e?.inject??[],e?.properties,e?.key,e?.instance);e?.key&&this.servicesByKey.set(e.key,r),this.servicesByClassName.set(t.name,r)}checkNameCollision(t){let e=this.servicesByClassName.get(t.name);if(e&&e.classConstructor!==t){let r=o("Service name collision: different class registered with same name",{service:t.name});if(r)throw r}}validateRegistration(t,e){if(this.checkNameCollision(t),e.key){let r=this.servicesByKey.get(e.key);if(r&&r.classConstructor!==t){let s=o("Service key already registered to a different class",{key:e.key,existingClass:r.classConstructor.name,newClass:t.name});if(s)throw s}}if(e.instance&&e.inject.length>0){let r=o("Service has both instance and inject (inject will be ignored)",{service:t.name});if(r)throw r}}tryGet(t){return typeof t=="string"?this.servicesByKey.get(t):this.servicesByClassName.get(t.name)}get(t){let e=this.tryGet(t);if(!e){let r=typeof t=="string"?t:t.name,s=o(`Failed to resolve service '${r}'`,{service:r,registeredTypes:Array.from(this.servicesByClassName.keys()),registeredKeys:Array.from(this.servicesByKey.keys())});if(s)throw s}return e}};var l=class{constructor(t){this.serviceCollection=t;this.instances=new Map}resolve(t){let e=typeof t=="string"?t:t.name;if(this.instances.has(e))return this.instances.get(e);let r=this.serviceCollection.get(t);if(!r){let i=o(`Failed to resolve service '${e}'`,{service:e});if(i)throw i;return}if(r.instance){let i=r.instance;return this.injectFields(i,r),this.instances.set(e,i),i}let s=this.createInstance(r);return r.scope==="global"&&this.instances.set(e,s),this.injectFields(s,r),s}createInstance(t){let e=t.classConstructor,r=t.inject.map(s=>this.resolve(s));return new e(...r)}injectFields(t,e){for(let[r,s]of Object.entries(e.properties))t[r]=this.resolve(s)}},g=new a,v=new l(g);
+"use strict";var d=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var h=Object.prototype.hasOwnProperty;var x=(n,t)=>{for(var e in t)d(n,e,{get:t[e],enumerable:!0})},C=(n,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of f(t))!h.call(n,s)&&s!==e&&d(n,s,{get:()=>t[s],enumerable:!(r=y(t,s))||r.enumerable});return n};var T=n=>C(d({},"__esModule",{value:!0}),n);var j={};x(j,{ContainerService:()=>b,Inject:()=>m,ServiceCollection:()=>a,ServiceContainer:()=>l,container:()=>v,serviceCollection:()=>g});module.exports=T(j);var u=class extends Error{constructor(e,r){super(e);this.context=r}},p=null;function o(n,t){let e=new u(n,t);if(p){let r=!1;if(p(e,{suppress(){r=!0}}),r)return null}return e}function m(n){return(t,e)=>function(){return v.resolve(n)}}function b(n){return t=>{let e=n??{inject:[]};e.key?g.register(t,e):g.registerByType(t,e)}}var c=class{constructor(t,e,r,s={},i,w){this.classConstructor=t;this.scope=e;this.inject=r;this.properties=s;this.key=i;this.instance=w}},a=class{constructor(){this.servicesByKey=new Map;this.servicesByClassName=new Map}register(t,e){this.validateRegistration(t,e);let r=new c(t,e.scope??"global",e.inject,e.properties??{},e.key,e.instance);e.key&&this.servicesByKey.set(e.key,r),this.servicesByClassName.set(t.name,r)}registerByType(t,e){this.checkNameCollision(t),e&&this.validateRegistration(t,e);let r=new c(t,e?.scope??"global",e?.inject??[],e?.properties,e?.key,e?.instance);e?.key&&this.servicesByKey.set(e.key,r),this.servicesByClassName.set(t.name,r)}checkNameCollision(t){let e=this.servicesByClassName.get(t.name);if(e&&e.classConstructor!==t){let r=o("Service name collision: different class registered with same name",{service:t.name});if(r)throw r}}validateRegistration(t,e){if(this.checkNameCollision(t),e.key){let r=this.servicesByKey.get(e.key);if(r&&r.classConstructor!==t){let s=o("Service key already registered to a different class",{key:e.key,existingClass:r.classConstructor.name,newClass:t.name});if(s)throw s}}if(e.instance&&e.inject.length>0){let r=o("Service has both instance and inject (inject will be ignored)",{service:t.name});if(r)throw r}}tryGet(t){return typeof t=="string"?this.servicesByKey.get(t):this.servicesByClassName.get(t.name)}get(t){let e=this.tryGet(t);if(!e){let r=typeof t=="string"?t:t.name,s=o(`Failed to resolve service '${r}'`,{service:r,registeredTypes:Array.from(this.servicesByClassName.keys()),registeredKeys:Array.from(this.servicesByKey.keys())});if(s)throw s}return e}};var l=class{constructor(t){this.serviceCollection=t;this.instances=new Map}resolve(t){let e=typeof t=="string"?t:t.name;if(this.instances.has(e))return this.instances.get(e);let r=this.serviceCollection.get(t);if(!r){let i=o(`Failed to resolve service '${e}'`,{service:e});if(i)throw i;return}if(r.instance){let i=r.instance;return this.injectFields(i,r),this.instances.set(e,i),i}let s=this.createInstance(r);return r.scope==="global"&&this.instances.set(e,s),this.injectFields(s,r),s}createInstance(t){let e=t.classConstructor,r=t.inject.map(s=>this.resolve(s));return new e(...r)}injectFields(t,e){for(let[r,s]of Object.entries(e.properties))t[r]=this.resolve(s)}},g=new a,v=new l(g);
 //# sourceMappingURL=index.js.map

package/dist/di/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/di/index.ts", "../../src/errors.ts", "../../src/DependencyInjection.ts"],
-  "sourcesContent": ["export * from '../DependencyInjection';\r\n", "/**\r\n * Global error handling for Relaxjs.\r\n * Register a handler with `onError()` to intercept errors before they throw.\r\n * Call `ctx.suppress()` in the handler to prevent the error from being thrown.\r\n *\r\n * @example\r\n * import { onError } from 'relaxjs';\r\n *\r\n * onError((error, ctx) => {\r\n *     logToService(error.message, error.context);\r\n *     showToast(error.message);\r\n *     ctx.suppress();\r\n * });\r\n */\r\n\r\n/**\r\n * Passed to error handlers to control error behavior.\r\n * Call `suppress()` to prevent the error from being thrown.\r\n */\r\nexport interface ErrorContext {\r\n    suppress(): void;\r\n}\r\n\r\n/**\r\n * Error with structured context for debugging.\r\n * The `context` record contains details like route name, component tag, route data.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     console.log(error.context.route);\r\n *     console.log(error.context.componentTagName);\r\n * });\r\n */\r\nexport class RelaxError extends Error {\r\n    constructor(\r\n        message: string,\r\n        public context: Record<string, unknown>,\r\n    ) {\r\n        super(message);\r\n    }\r\n}\r\n\r\n/** @internal */\r\ntype ErrorHandler = (error: RelaxError, ctx: ErrorContext) => void;\r\n\r\nlet handler: ErrorHandler | null = null;\r\n\r\n/**\r\n * Registers a global error handler for Relaxjs errors.\r\n * The handler receives the error and an `ErrorContext`.\r\n * Call `ctx.suppress()` to prevent the error from being thrown.\r\n * Only one handler can be active at a time; subsequent calls replace the previous handler.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     if (error.context.route === 'optional-panel') {\r\n *         ctx.suppress();\r\n *         return;\r\n *     }\r\n *     showErrorDialog(error.message);\r\n * });\r\n */\r\nexport function onError(fn: ErrorHandler) {\r\n    handler = fn;\r\n}\r\n\r\n/**\r\n * Reports an error through the global handler.\r\n * Returns the `RelaxError` if it should be thrown, or `null` if the handler suppressed it.\r\n * The caller is responsible for throwing the returned error.\r\n *\r\n * @param message - Human-readable error description\r\n * @param context - Structured data for debugging (route, component, params, cause, etc.)\r\n * @returns The error to throw, or `null` if suppressed\r\n *\r\n * @example\r\n * const error = reportError('Failed to load route component', {\r\n *     route: 'user',\r\n *     componentTagName: 'user-profile',\r\n *     routeData: { id: 123 },\r\n * });\r\n * if (error) throw error;\r\n */\r\nexport function reportError(message: string, context: Record<string, unknown>): RelaxError | null {\r\n    const error = new RelaxError(message, context);\r\n    if (handler) {\r\n        let suppressed = false;\r\n        const ctx: ErrorContext = {\r\n            suppress() { suppressed = true; },\r\n        };\r\n        handler(error, ctx);\r\n        if (suppressed) {\r\n            return null;\r\n        }\r\n    }\r\n    return error;\r\n}\r\n\r\n/**\r\n * Wraps an async function into a synchronous callback suitable for addEventListener.\r\n * Catches promise rejections and reports them through the global error handler.\r\n *\r\n * @param fn - Async function to wrap\r\n * @returns Synchronous function that can be passed to addEventListener\r\n *\r\n * @example\r\n * button.addEventListener('click', asyncHandler(async (e) => {\r\n *     await saveData();\r\n * }));\r\n *\r\n * @example\r\n * form.addEventListener('submit', asyncHandler(async (e) => {\r\n *     e.preventDefault();\r\n *     await submitForm();\r\n * }));\r\n */\r\nexport function asyncHandler<TArgs extends unknown[]>(\r\n    fn: (...args: TArgs) => Promise<void>,\r\n): (...args: TArgs) => void {\r\n    return function (this: any, ...args: TArgs) {\r\n        fn.call(this, ...args).catch((cause: unknown) => {\r\n            const error = reportError('Async callback failed', { cause });\r\n            if (error) throw error;\r\n        });\r\n    };\r\n}\r\n", "import { reportError } from './errors';\r\n\r\n/**\r\n * Generic constructor type used for dependency registration and injection.\r\n * Represents any class constructor that can be used with the DI container.\r\n *\r\n * @template T - The type of object the constructor creates\r\n *\r\n * @example\r\n * // Use with service registration\r\n * class UserService {}\r\n * const ctor: Constructor<UserService> = UserService;\r\n * serviceCollection.registerByType(ctor, { inject: [] });\r\n */\r\nexport type Constructor<T extends object = object> = new (...args: any[]) => T;\r\n\r\n/**\r\n * Controls how service instances are shared across the container hierarchy.\r\n * Used when registering services to define their lifetime behavior.\r\n *\r\n * - `global`: Single instance shared everywhere (singleton pattern)\r\n * - `closest`: New instance per container scope (scoped lifetime)\r\n *\r\n * @example\r\n * // Singleton service - same instance everywhere\r\n * serviceCollection.register(LoggerService, { scope: 'global', inject: [] });\r\n *\r\n * // Scoped service - new instance per scope\r\n * serviceCollection.register(RequestContext, { scope: 'closest', inject: [] });\r\n */\r\nexport type ServiceScope = 'global' | 'closest';\r\n\r\n/**\r\n * Configuration options for registering a service in the DI container.\r\n * Controls identification, lifetime, and dependency resolution.\r\n *\r\n * @example\r\n * // Register with constructor injection\r\n * const options: RegistrationOptions = {\r\n *     scope: 'global',\r\n *     inject: [DatabaseConnection, ConfigService]\r\n * };\r\n * serviceCollection.register(UserRepository, options);\r\n *\r\n * @example\r\n * // Register with property injection\r\n * const options: RegistrationOptions = {\r\n *     inject: [],\r\n *     properties: { logger: Logger, config: 'appConfig' }\r\n * };\r\n *\r\n * @example\r\n * // Register with a pre-created instance\r\n * const options: RegistrationOptions = {\r\n *     inject: [],\r\n *     instance: existingService\r\n * };\r\n */\r\nexport interface RegistrationOptions {\r\n    /** Service lifetime - 'global' for singleton, 'closest' for scoped */\r\n    scope?: ServiceScope;\r\n    /** Optional string key for resolving by name instead of type */\r\n    key?: string;\r\n    /** Pre-existing instance to use instead of creating new one */\r\n    instance?: unknown;\r\n    /** Types or keys for constructor parameters, in order */\r\n    inject: (string | Constructor)[];\r\n    /** Map of property names to their injection types/keys */\r\n    properties?: Record<string, string | Constructor>;\r\n}\r\n\r\n/**\r\n * Field decorator that injects a service from the global DI container.\r\n * The service is resolved when the class instance is created (not at class definition time),\r\n * so services must be registered before the first instance is created.\r\n *\r\n * Works with web components regardless of how they are created:\r\n * - By the browser (HTML parsing): services are resolved during construction\r\n * - By application code (`document.createElement` or `new`): same behavior\r\n * - Injected fields are available in `connectedCallback` and all lifecycle methods\r\n *\r\n * @example\r\n * // Using `@Inject` in a web component\r\n * class UserPanel extends HTMLElement {\r\n *     @Inject(UserService)\r\n *     private userService!: UserService;\r\n *\r\n *     connectedCallback() {\r\n *         // userService is already resolved and ready to use\r\n *         const user = this.userService.getCurrentUser();\r\n *         this.render(user);\r\n *     }\r\n * }\r\n *\r\n * @example\r\n * // Services must be registered before components are created.\r\n * // In your app entry point (e.g. main.ts):\r\n * serviceCollection.registerByType(UserService, { inject: [ApiClient] });\r\n * serviceCollection.registerByType(ApiClient, { inject: [] });\r\n *\r\n * // Now components can be created (by browser or code)\r\n * customElements.define('user-panel', UserPanel);\r\n */\r\nexport function Inject<T extends object>(typeOrKey: Constructor<T> | string) {\r\n    return (_: undefined, context: ClassFieldDecoratorContext) => {\r\n        return function(this: any) {\r\n            return container.resolve(typeOrKey);\r\n        };\r\n    };\r\n}\r\n\r\n// Temporary collector of property injections - cleared after registration\r\n//const propertyCollector = new WeakMap<object, Record<string, string>>();\r\n\r\n/**\r\n * Class decorator that registers a service in the global DI container.\r\n * Registration happens at class definition time (when the module loads),\r\n * so import the module before creating instances that depend on this service.\r\n *\r\n * For web components: use `@ContainerService` on services, not on the\r\n * components themselves. Components use `@Inject` to consume services.\r\n *\r\n * @param options - Registration configuration including scope and dependencies\r\n *\r\n * @example\r\n * // Register a service that components can inject\r\n * @ContainerService({ inject: [ApiClient] })\r\n * class UserService {\r\n *     constructor(private api: ApiClient) {}\r\n *     getCurrentUser() { return this.api.get('/user'); }\r\n * }\r\n *\r\n * // Component consumes the service\r\n * class UserPanel extends HTMLElement {\r\n *     @Inject(UserService)\r\n *     private userService!: UserService;\r\n * }\r\n *\r\n * @example\r\n * // Service with custom key for named resolution\r\n * @ContainerService({ key: 'primaryCache', scope: 'global', inject: [] })\r\n * class CacheService {}\r\n *\r\n * // Later resolve by key\r\n * const cache = container.resolve('primaryCache');\r\n */\r\nexport function ContainerService<T extends object>(\r\n    options?: RegistrationOptions\r\n) {\r\n    return (target: Constructor<T>) => {\r\n        const opts = options ?? {inject: []};\r\n\r\n        if (opts.key) {\r\n            serviceCollection.register(target, opts);\r\n        } else {\r\n            serviceCollection.registerByType(target, opts);\r\n        }\r\n    };\r\n}\r\n\r\n/**\r\n * Internal class representing a registered service's metadata.\r\n * Holds all information needed to create and configure service instances.\r\n *\r\n * @internal This is an implementation detail and should not be used directly.\r\n */\r\nclass Registration {\r\n    /**\r\n     * Creates a new registration record.\r\n     *\r\n     * @param classConstructor - The class constructor function\r\n     * @param scope - Instance sharing behavior\r\n     * @param inject - Constructor parameter dependencies\r\n     * @param properties - Property injection mappings\r\n     * @param key - Optional string identifier\r\n     * @param instance - Optional pre-created instance\r\n     */\r\n    constructor(\r\n        public classConstructor: Constructor,\r\n        public scope: ServiceScope,\r\n        public inject: (string | Constructor)[],\r\n        public properties: Record<string, string | Constructor> = {},\r\n        public key?: string,\r\n        public instance?: unknown\r\n    ) {}\r\n}\r\n\r\n/**\r\n * Registry that stores service registration metadata.\r\n * Use this to register services before they can be resolved by a ServiceContainer.\r\n *\r\n * Typically you'll use the global `serviceCollection` instance rather than creating your own.\r\n *\r\n * @example\r\n * // Register a service by type\r\n * serviceCollection.registerByType(LoggerService, { inject: [] });\r\n *\r\n * // Register with a string key\r\n * serviceCollection.register(CacheService, { key: 'cache', inject: [] });\r\n *\r\n * // Check if service is registered\r\n * const reg = serviceCollection.tryGet(LoggerService);\r\n * if (reg) {\r\n *     console.log('Logger is registered');\r\n * }\r\n */\r\nexport class ServiceCollection {\r\n    private servicesByKey = new Map<string, Registration>();\r\n    private servicesByClassName = new Map<string, Registration>();\r\n\r\n    /**\r\n     * Registers a service with full configuration options.\r\n     * The service will be resolvable by both its class name and optional key.\r\n     *\r\n     * @param constructor - The service class constructor\r\n     * @param options - Registration configuration\r\n     */\r\n    register<T extends object>(constructor: Constructor<T>, options: RegistrationOptions): void {\r\n        this.validateRegistration(constructor, options);\r\n\r\n        const reg = new Registration(\r\n            constructor,\r\n            options.scope ?? 'global',\r\n            options.inject,\r\n            options.properties ?? {},\r\n            options.key,\r\n            options.instance\r\n        );\r\n\r\n        if (options.key) {\r\n            this.servicesByKey.set(options.key, reg);\r\n        }\r\n        this.servicesByClassName.set(constructor.name, reg);\r\n    }\r\n\r\n    /**\r\n     * Registers a service by its class type.\r\n     * The service will be resolvable by its class constructor.\r\n     *\r\n     * @param constructor - The service class constructor\r\n     * @param options - Optional registration configuration\r\n     */\r\n    registerByType<T extends object>(\r\n        constructor: Constructor<T>,\r\n        options?: RegistrationOptions\r\n    ): void {\r\n        this.checkNameCollision(constructor);\r\n        if (options) this.validateRegistration(constructor, options);\r\n\r\n        const reg = new Registration(constructor, options?.scope, options?.inject ?? [], options?.properties, options?.key, options?.instance);\r\n        if (options?.key) {\r\n            this.servicesByKey.set(options.key, reg);\r\n        }\r\n        this.servicesByClassName.set(constructor.name, reg);\r\n    }\r\n\r\n    private checkNameCollision<T extends object>(constructor: Constructor<T>): void {\r\n        const existing = this.servicesByClassName.get(constructor.name);\r\n        if (existing && existing.classConstructor !== constructor) {\r\n            const error = reportError('Service name collision: different class registered with same name', {\r\n                service: constructor.name,\r\n            });\r\n            if (error) throw error;\r\n        }\r\n    }\r\n\r\n    private validateRegistration<T extends object>(constructor: Constructor<T>, options: RegistrationOptions): void {\r\n        this.checkNameCollision(constructor);\r\n\r\n        if (options.key) {\r\n            const existingByKey = this.servicesByKey.get(options.key);\r\n            if (existingByKey && existingByKey.classConstructor !== constructor) {\r\n                const error = reportError('Service key already registered to a different class', {\r\n                    key: options.key,\r\n                    existingClass: existingByKey.classConstructor.name,\r\n                    newClass: constructor.name,\r\n                });\r\n                if (error) throw error;\r\n            }\r\n        }\r\n\r\n        if (options.instance && options.inject.length > 0) {\r\n            const error = reportError('Service has both instance and inject (inject will be ignored)', {\r\n                service: constructor.name,\r\n            });\r\n            if (error) throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Attempts to retrieve a service registration.\r\n     * Returns undefined if the service is not registered.\r\n     *\r\n     * @param key - Either a string key or class constructor\r\n     * @returns The registration or undefined\r\n     */\r\n    tryGet<T extends object>(key: string | Constructor<T>): Registration | undefined {\r\n        if (typeof key === 'string') {\r\n            return this.servicesByKey.get(key);\r\n        }\r\n        return this.servicesByClassName.get(key.name);\r\n    }\r\n\r\n    /**\r\n     * Retrieves a service registration or throws if not found.\r\n     *\r\n     * @param key - Either a string key or class constructor\r\n     * @returns The registration\r\n     * @throws Error if the service is not registered\r\n     */\r\n    get<T extends object>(key: string | Constructor<T>): Registration {\r\n        const reg = this.tryGet(key);\r\n        if (!reg) {\r\n            const service = typeof key === 'string' ? key : key.name;\r\n            const error = reportError(`Failed to resolve service '${service}'`, {\r\n                service,\r\n                registeredTypes: Array.from(this.servicesByClassName.keys()),\r\n                registeredKeys: Array.from(this.servicesByKey.keys()),\r\n            });\r\n            if (error) throw error;\r\n        }\r\n        return reg!;\r\n    }\r\n}\r\n\r\n/**\r\n * Internal storage for tracking injected fields during service resolution.\r\n * @internal\r\n */\r\nconst injectedFields = new WeakMap<object, Map<string, string>>();\r\n\r\n/**\r\n * IoC container that resolves and manages service instances.\r\n * Creates instances based on registrations in a ServiceCollection,\r\n * handling constructor injection, property injection, and lifetime management.\r\n *\r\n * Typically you'll use the global `container` instance rather than creating your own.\r\n *\r\n * @example\r\n * // Resolve a service by class\r\n * const logger = container.resolve(LoggerService);\r\n *\r\n * // Resolve by string key\r\n * const cache = container.resolve<CacheService>('primaryCache');\r\n *\r\n * @example\r\n * // Full setup workflow\r\n * serviceCollection.register(UserService, {\r\n *     inject: [DatabaseConnection],\r\n *     scope: 'global'\r\n * });\r\n *\r\n * const userService = container.resolve(UserService);\r\n */\r\nexport class ServiceContainer {\r\n    private instances = new Map<string, any>();\r\n\r\n    /**\r\n     * Creates a new container backed by the given service collection.\r\n     *\r\n     * @param serviceCollection - The registry containing service registrations\r\n     */\r\n    constructor(private serviceCollection: ServiceCollection) {}\r\n\r\n    /**\r\n     * Resolves a service instance by class type or string key.\r\n     * Creates the instance if not already cached (for global scope).\r\n     * Handles constructor and property injection automatically.\r\n     *\r\n     * @param keyOrType - Either a string key or class constructor\r\n     * @returns The resolved service instance\r\n     * @throws Error if the service is not registered\r\n     *\r\n     * @example\r\n     * const service = container.resolve(MyService);\r\n     */\r\n    resolve<T extends object>(keyOrType: string | Constructor<T>): T {\r\n        const key = typeof keyOrType === 'string' ? keyOrType : keyOrType.name;\r\n\r\n        if (this.instances.has(key)) {\r\n            return this.instances.get(key);\r\n        }\r\n\r\n        const registration = this.serviceCollection.get(keyOrType);\r\n        if (!registration) {\r\n            const error = reportError(`Failed to resolve service '${key}'`, { service: key });\r\n            if (error) throw error;\r\n            return undefined as unknown as T;\r\n        }\r\n\r\n        if (registration.instance) {\r\n            const inst = registration.instance as T;\r\n            this.injectFields(inst, registration);\r\n            this.instances.set(key, inst);\r\n            return inst;\r\n        }\r\n\r\n        const instance = this.createInstance<T>(registration);\r\n        if (registration.scope === 'global') {\r\n            this.instances.set(key, instance);\r\n        }\r\n        this.injectFields(instance, registration);\r\n\r\n        return instance;\r\n    }\r\n\r\n    /**\r\n     * Creates a new instance of a service, resolving all constructor dependencies.\r\n     */\r\n    private createInstance<T extends object>(registration: Registration): T {\r\n        const constructor = registration.classConstructor as Constructor<T>;\r\n\r\n        const dependencies = registration.inject.map(dep => this.resolve(dep));\r\n        return new constructor(...dependencies);\r\n    }\r\n\r\n    /**\r\n     * Injects dependencies into instance properties based on registration config.\r\n     */\r\n    private injectFields<T extends object>(instance: T, registration: Registration): void {\r\n        for (const [fieldName, keyOrType] of Object.entries(registration.properties)) {\r\n            (instance as any)[fieldName] = this.resolve(keyOrType);\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Global service collection instance for registering services.\r\n * Use this to register services that can later be resolved by the container.\r\n *\r\n * @example\r\n * import { serviceCollection } from 'relaxjs';\r\n *\r\n * serviceCollection.register(MyService, { inject: [Dependency] });\r\n */\r\nexport const serviceCollection = new ServiceCollection();\r\n\r\n/**\r\n * Global service container instance for resolving dependencies.\r\n * Use this to obtain service instances with all dependencies injected.\r\n *\r\n * @example\r\n * import { container } from 'relaxjs';\r\n *\r\n * const service = container.resolve(MyService);\r\n */\r\nexport const container = new ServiceContainer(serviceCollection);"],
-  "mappings": "4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,sBAAAE,EAAA,WAAAC,EAAA,sBAAAC,EAAA,qBAAAC,EAAA,cAAAC,EAAA,sBAAAC,IAAA,eAAAC,EAAAR,GCiCO,IAAMS,EAAN,cAAyB,KAAM,CAClC,YACIC,EACOC,EACT,CACE,MAAMD,CAAO,EAFN,aAAAC,CAGX,CACJ,EAKIC,EAA+B,KAsC5B,SAASC,EAAYC,EAAiBC,EAAqD,CAC9F,IAAMC,EAAQ,IAAIC,EAAWH,EAASC,CAAO,EAC7C,GAAIG,EAAS,CACT,IAAIC,EAAa,GAKjB,GADAD,EAAQF,EAHkB,CACtB,UAAW,CAAEG,EAAa,EAAM,CACpC,CACkB,EACdA,EACA,OAAO,IAEf,CACA,OAAOH,CACX,CCOO,SAASI,EAAyBC,EAAoC,CACzE,MAAO,CAACC,EAAcC,IACX,UAAoB,CACvB,OAAOC,EAAU,QAAQH,CAAS,CACtC,CAER,CAqCO,SAASI,EACZC,EACF,CACE,OAAQC,GAA2B,CAC/B,IAAMC,EAAOF,GAAW,CAAC,OAAQ,CAAC,CAAC,EAE/BE,EAAK,IACLC,EAAkB,SAASF,EAAQC,CAAI,EAEvCC,EAAkB,eAAeF,EAAQC,CAAI,CAErD,CACJ,CAQA,IAAME,EAAN,KAAmB,CAWf,YACWC,EACAC,EACAC,EACAC,EAAmD,CAAC,EACpDC,EACAC,EACT,CANS,sBAAAL,EACA,WAAAC,EACA,YAAAC,EACA,gBAAAC,EACA,SAAAC,EACA,cAAAC,CACR,CACP,EAqBaC,EAAN,KAAwB,CAAxB,cACH,KAAQ,cAAgB,IAAI,IAC5B,KAAQ,oBAAsB,IAAI,IASlC,SAA2BC,EAA6BZ,EAAoC,CACxF,KAAK,qBAAqBY,EAAaZ,CAAO,EAE9C,IAAMa,EAAM,IAAIT,EACZQ,EACAZ,EAAQ,OAAS,SACjBA,EAAQ,OACRA,EAAQ,YAAc,CAAC,EACvBA,EAAQ,IACRA,EAAQ,QACZ,EAEIA,EAAQ,KACR,KAAK,cAAc,IAAIA,EAAQ,IAAKa,CAAG,EAE3C,KAAK,oBAAoB,IAAID,EAAY,KAAMC,CAAG,CACtD,CASA,eACID,EACAZ,EACI,CACJ,KAAK,mBAAmBY,CAAW,EAC/BZ,GAAS,KAAK,qBAAqBY,EAAaZ,CAAO,EAE3D,IAAMa,EAAM,IAAIT,EAAaQ,EAAaZ,GAAS,MAAOA,GAAS,QAAU,CAAC,EAAGA,GAAS,WAAYA,GAAS,IAAKA,GAAS,QAAQ,EACjIA,GAAS,KACT,KAAK,cAAc,IAAIA,EAAQ,IAAKa,CAAG,EAE3C,KAAK,oBAAoB,IAAID,EAAY,KAAMC,CAAG,CACtD,CAEQ,mBAAqCD,EAAmC,CAC5E,IAAME,EAAW,KAAK,oBAAoB,IAAIF,EAAY,IAAI,EAC9D,GAAIE,GAAYA,EAAS,mBAAqBF,EAAa,CACvD,IAAMG,EAAQC,EAAY,oEAAqE,CAC3F,QAASJ,EAAY,IACzB,CAAC,EACD,GAAIG,EAAO,MAAMA,CACrB,CACJ,CAEQ,qBAAuCH,EAA6BZ,EAAoC,CAG5G,GAFA,KAAK,mBAAmBY,CAAW,EAE/BZ,EAAQ,IAAK,CACb,IAAMiB,EAAgB,KAAK,cAAc,IAAIjB,EAAQ,GAAG,EACxD,GAAIiB,GAAiBA,EAAc,mBAAqBL,EAAa,CACjE,IAAMG,EAAQC,EAAY,sDAAuD,CAC7E,IAAKhB,EAAQ,IACb,cAAeiB,EAAc,iBAAiB,KAC9C,SAAUL,EAAY,IAC1B,CAAC,EACD,GAAIG,EAAO,MAAMA,CACrB,CACJ,CAEA,GAAIf,EAAQ,UAAYA,EAAQ,OAAO,OAAS,EAAG,CAC/C,IAAMe,EAAQC,EAAY,gEAAiE,CACvF,QAASJ,EAAY,IACzB,CAAC,EACD,GAAIG,EAAO,MAAMA,CACrB,CACJ,CASA,OAAyBN,EAAwD,CAC7E,OAAI,OAAOA,GAAQ,SACR,KAAK,cAAc,IAAIA,CAAG,EAE9B,KAAK,oBAAoB,IAAIA,EAAI,IAAI,CAChD,CASA,IAAsBA,EAA4C,CAC9D,IAAMI,EAAM,KAAK,OAAOJ,CAAG,EAC3B,GAAI,CAACI,EAAK,CACN,IAAMK,EAAU,OAAOT,GAAQ,SAAWA,EAAMA,EAAI,KAC9CM,EAAQC,EAAY,8BAA8BE,CAAO,IAAK,CAChE,QAAAA,EACA,gBAAiB,MAAM,KAAK,KAAK,oBAAoB,KAAK,CAAC,EAC3D,eAAgB,MAAM,KAAK,KAAK,cAAc,KAAK,CAAC,CACxD,CAAC,EACD,GAAIH,EAAO,MAAMA,CACrB,CACA,OAAOF,CACX,CACJ,EA+BO,IAAMM,EAAN,KAAuB,CAQ1B,YAAoBC,EAAsC,CAAtC,uBAAAA,EAPpB,KAAQ,UAAY,IAAI,GAOmC,CAc3D,QAA0BC,EAAuC,CAC7D,IAAMC,EAAM,OAAOD,GAAc,SAAWA,EAAYA,EAAU,KAElE,GAAI,KAAK,UAAU,IAAIC,CAAG,EACtB,OAAO,KAAK,UAAU,IAAIA,CAAG,EAGjC,IAAMC,EAAe,KAAK,kBAAkB,IAAIF,CAAS,EACzD,GAAI,CAACE,EAAc,CACf,IAAMC,EAAQC,EAAY,8BAA8BH,CAAG,IAAK,CAAE,QAASA,CAAI,CAAC,EAChF,GAAIE,EAAO,MAAMA,EACjB,MACJ,CAEA,GAAID,EAAa,SAAU,CACvB,IAAMG,EAAOH,EAAa,SAC1B,YAAK,aAAaG,EAAMH,CAAY,EACpC,KAAK,UAAU,IAAID,EAAKI,CAAI,EACrBA,CACX,CAEA,IAAMC,EAAW,KAAK,eAAkBJ,CAAY,EACpD,OAAIA,EAAa,QAAU,UACvB,KAAK,UAAU,IAAID,EAAKK,CAAQ,EAEpC,KAAK,aAAaA,EAAUJ,CAAY,EAEjCI,CACX,CAKQ,eAAiCJ,EAA+B,CACpE,IAAMK,EAAcL,EAAa,iBAE3BM,EAAeN,EAAa,OAAO,IAAIO,GAAO,KAAK,QAAQA,CAAG,CAAC,EACrE,OAAO,IAAIF,EAAY,GAAGC,CAAY,CAC1C,CAKQ,aAA+BF,EAAaJ,EAAkC,CAClF,OAAW,CAACQ,EAAWV,CAAS,IAAK,OAAO,QAAQE,EAAa,UAAU,EACtEI,EAAiBI,CAAS,EAAI,KAAK,QAAQV,CAAS,CAE7D,CACJ,EAWaD,EAAoB,IAAIY,EAWxBC,EAAY,IAAId,EAAiBC,CAAiB",
+  "sourcesContent": ["export * from '../DependencyInjection';\r\n", "/**\r\n * Global error handling for Relaxjs.\r\n * Register a handler with `onError()` to intercept errors before they throw.\r\n * Call `ctx.suppress()` in the handler to prevent the error from being thrown.\r\n *\r\n * @example\r\n * import { onError } from 'relaxjs';\r\n *\r\n * onError((error, ctx) => {\r\n *     logToService(error.message, error.context);\r\n *     showToast(error.message);\r\n *     ctx.suppress();\r\n * });\r\n */\r\n\r\n/**\r\n * Passed to error handlers to control error behavior.\r\n * Call `suppress()` to prevent the error from being thrown.\r\n */\r\nexport interface ErrorContext {\r\n    suppress(): void;\r\n}\r\n\r\n/**\r\n * Error with structured context for debugging.\r\n * The `context` record contains details like route name, component tag, route data.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     console.log(error.context.route);\r\n *     console.log(error.context.componentTagName);\r\n * });\r\n */\r\nexport class RelaxError extends Error {\r\n    constructor(\r\n        message: string,\r\n        public context: Record<string, unknown>,\r\n    ) {\r\n        super(message);\r\n    }\r\n}\r\n\r\n/** @internal */\r\ntype ErrorHandler = (error: RelaxError, ctx: ErrorContext) => void;\r\n\r\nlet handler: ErrorHandler | null = null;\r\n\r\n/**\r\n * Registers a global error handler for Relaxjs errors.\r\n * The handler receives the error and an `ErrorContext`.\r\n * Call `ctx.suppress()` to prevent the error from being thrown.\r\n * Only one handler can be active at a time; subsequent calls replace the previous handler.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     if (error.context.route === 'optional-panel') {\r\n *         ctx.suppress();\r\n *         return;\r\n *     }\r\n *     showErrorDialog(error.message);\r\n * });\r\n */\r\nexport function onError(fn: ErrorHandler) {\r\n    handler = fn;\r\n}\r\n\r\n/**\r\n * Reports an error through the global handler.\r\n * Returns the `RelaxError` if it should be thrown, or `null` if the handler suppressed it.\r\n * The caller is responsible for throwing the returned error.\r\n *\r\n * @param message - Human-readable error description\r\n * @param context - Structured data for debugging (route, component, params, cause, etc.)\r\n * @returns The error to throw, or `null` if suppressed\r\n *\r\n * @example\r\n * const error = reportError('Failed to load route component', {\r\n *     route: 'user',\r\n *     componentTagName: 'user-profile',\r\n *     routeData: { id: 123 },\r\n * });\r\n * if (error) throw error;\r\n */\r\nexport function reportError(message: string, context: Record<string, unknown>): RelaxError | null {\r\n    const error = new RelaxError(message, context);\r\n    if (handler) {\r\n        let suppressed = false;\r\n        const ctx: ErrorContext = {\r\n            suppress() { suppressed = true; },\r\n        };\r\n        handler(error, ctx);\r\n        if (suppressed) {\r\n            return null;\r\n        }\r\n    }\r\n    return error;\r\n}\r\n\r\n/**\r\n * Wraps an async function into a synchronous callback suitable for addEventListener.\r\n * Catches promise rejections and reports them through the global error handler.\r\n *\r\n * @param fn - Async function to wrap\r\n * @returns Synchronous function that can be passed to addEventListener\r\n *\r\n * @example\r\n * button.addEventListener('click', asyncHandler(async (e) => {\r\n *     await saveData();\r\n * }));\r\n *\r\n * @example\r\n * form.addEventListener('submit', asyncHandler(async (e) => {\r\n *     e.preventDefault();\r\n *     await submitForm();\r\n * }));\r\n */\r\nexport function asyncHandler<TArgs extends unknown[]>(\r\n    fn: (...args: TArgs) => Promise<void>,\r\n): (...args: TArgs) => void {\r\n    return function (this: any, ...args: TArgs) {\r\n        fn.call(this, ...args).catch((cause: unknown) => {\r\n            const error = reportError('Async callback failed', { cause });\r\n            if (error) throw error;\r\n        });\r\n    };\r\n}\r\n", "import { reportError } from './errors';\r\n\r\n/**\r\n * Generic constructor type used for dependency registration and injection.\r\n * Represents any class constructor that can be used with the DI container.\r\n *\r\n * @template T - The type of object the constructor creates\r\n *\r\n * @example\r\n * // Use with service registration\r\n * class UserService {}\r\n * const ctor: Constructor<UserService> = UserService;\r\n * serviceCollection.registerByType(ctor, { inject: [] });\r\n */\r\nexport type Constructor<T extends object = object> = new (...args: any[]) => T;\r\n\r\n/**\r\n * Controls how service instances are shared across the container hierarchy.\r\n * Used when registering services to define their lifetime behavior.\r\n *\r\n * - `global`: Single instance shared everywhere (singleton pattern)\r\n * - `closest`: New instance per container scope (scoped lifetime)\r\n *\r\n * @example\r\n * // Singleton service - same instance everywhere\r\n * serviceCollection.register(LoggerService, { scope: 'global', inject: [] });\r\n *\r\n * // Scoped service - new instance per scope\r\n * serviceCollection.register(RequestContext, { scope: 'closest', inject: [] });\r\n */\r\nexport type ServiceScope = 'global' | 'closest';\r\n\r\n/**\r\n * Configuration options for registering a service in the DI container.\r\n * Controls identification, lifetime, and dependency resolution.\r\n *\r\n * @example\r\n * // Register with constructor injection\r\n * const options: RegistrationOptions = {\r\n *     scope: 'global',\r\n *     inject: [DatabaseConnection, ConfigService]\r\n * };\r\n * serviceCollection.register(UserRepository, options);\r\n *\r\n * @example\r\n * // Register with property injection\r\n * const options: RegistrationOptions = {\r\n *     inject: [],\r\n *     properties: { logger: Logger, config: 'appConfig' }\r\n * };\r\n *\r\n * @example\r\n * // Register with a pre-created instance\r\n * const options: RegistrationOptions = {\r\n *     inject: [],\r\n *     instance: existingService\r\n * };\r\n */\r\nexport interface RegistrationOptions {\r\n    /** Service lifetime - 'global' for singleton, 'closest' for scoped */\r\n    scope?: ServiceScope;\r\n    /** Optional string key for resolving by name instead of type */\r\n    key?: string;\r\n    /** Pre-existing instance to use instead of creating new one */\r\n    instance?: unknown;\r\n    /** Types or keys for constructor parameters, in order */\r\n    inject: (string | Constructor)[];\r\n    /** Map of property names to their injection types/keys */\r\n    properties?: Record<string, string | Constructor>;\r\n}\r\n\r\n/**\r\n * Field decorator that injects a service from the global DI container.\r\n * The service is resolved when the class instance is created (not at class definition time),\r\n * so services must be registered before the first instance is created.\r\n *\r\n * Works with web components regardless of how they are created:\r\n * - By the browser (HTML parsing): services are resolved during construction\r\n * - By application code (`document.createElement` or `new`): same behavior\r\n * - Injected fields are available in `connectedCallback` and all lifecycle methods\r\n *\r\n * @example\r\n * // Using `@Inject` in a web component\r\n * class UserPanel extends HTMLElement {\r\n *     @Inject(UserService)\r\n *     private userService!: UserService;\r\n *\r\n *     connectedCallback() {\r\n *         // userService is already resolved and ready to use\r\n *         const user = this.userService.getCurrentUser();\r\n *         this.render(user);\r\n *     }\r\n * }\r\n *\r\n * @example\r\n * // Services must be registered before components are created.\r\n * // In your app entry point (e.g. main.ts):\r\n * serviceCollection.registerByType(UserService, { inject: [ApiClient] });\r\n * serviceCollection.registerByType(ApiClient, { inject: [] });\r\n *\r\n * // Now components can be created (by browser or code)\r\n * customElements.define('user-panel', UserPanel);\r\n */\r\nexport function Inject<T extends object>(typeOrKey: Constructor<T> | string) {\r\n    return (_: undefined, context: ClassFieldDecoratorContext) => {\r\n        return function(this: any) {\r\n            return container.resolve(typeOrKey);\r\n        };\r\n    };\r\n}\r\n\r\n// Temporary collector of property injections - cleared after registration\r\n//const propertyCollector = new WeakMap<object, Record<string, string>>();\r\n\r\n/**\r\n * Class decorator that registers a service in the global DI container.\r\n * Registration happens at class definition time (when the module loads),\r\n * so import the module before creating instances that depend on this service.\r\n *\r\n * For web components: use `@ContainerService` on services, not on the\r\n * components themselves. Components use `@Inject` to consume services.\r\n *\r\n * @param options - Registration configuration including scope and dependencies\r\n *\r\n * @example\r\n * // Register a service that components can inject\r\n * @ContainerService({ inject: [ApiClient] })\r\n * class UserService {\r\n *     constructor(private api: ApiClient) {}\r\n *     getCurrentUser() { return this.api.get('/user'); }\r\n * }\r\n *\r\n * // Component consumes the service\r\n * class UserPanel extends HTMLElement {\r\n *     @Inject(UserService)\r\n *     private userService!: UserService;\r\n * }\r\n *\r\n * @example\r\n * // Service with custom key for named resolution\r\n * @ContainerService({ key: 'primaryCache', scope: 'global', inject: [] })\r\n * class CacheService {}\r\n *\r\n * // Later resolve by key\r\n * const cache = container.resolve('primaryCache');\r\n */\r\nexport function ContainerService<T extends object>(\r\n    options?: RegistrationOptions\r\n) {\r\n    return (target: Constructor<T>) => {\r\n        const opts = options ?? {inject: []};\r\n\r\n        if (opts.key) {\r\n            serviceCollection.register(target, opts);\r\n        } else {\r\n            serviceCollection.registerByType(target, opts);\r\n        }\r\n    };\r\n}\r\n\r\n/**\r\n * Internal class representing a registered service's metadata.\r\n * Holds all information needed to create and configure service instances.\r\n *\r\n * @internal This is an implementation detail and should not be used directly.\r\n */\r\nclass Registration {\r\n    /**\r\n     * Creates a new registration record.\r\n     *\r\n     * @param classConstructor - The class constructor function\r\n     * @param scope - Instance sharing behavior\r\n     * @param inject - Constructor parameter dependencies\r\n     * @param properties - Property injection mappings\r\n     * @param key - Optional string identifier\r\n     * @param instance - Optional pre-created instance\r\n     */\r\n    constructor(\r\n        public classConstructor: Constructor,\r\n        public scope: ServiceScope,\r\n        public inject: (string | Constructor)[],\r\n        public properties: Record<string, string | Constructor> = {},\r\n        public key?: string,\r\n        public instance?: unknown\r\n    ) {}\r\n}\r\n\r\n/**\r\n * Registry that stores service registration metadata.\r\n * Use this to register services before they can be resolved by a ServiceContainer.\r\n *\r\n * Typically you'll use the global `serviceCollection` instance rather than creating your own.\r\n *\r\n * @example\r\n * // Register a service by type\r\n * serviceCollection.registerByType(LoggerService, { inject: [] });\r\n *\r\n * // Register with a string key\r\n * serviceCollection.register(CacheService, { key: 'cache', inject: [] });\r\n *\r\n * // Check if service is registered\r\n * const reg = serviceCollection.tryGet(LoggerService);\r\n * if (reg) {\r\n *     console.log('Logger is registered');\r\n * }\r\n */\r\nexport class ServiceCollection {\r\n    private servicesByKey = new Map<string, Registration>();\r\n    private servicesByClassName = new Map<string, Registration>();\r\n\r\n    /**\r\n     * Registers a service with full configuration options.\r\n     * The service will be resolvable by both its class name and optional key.\r\n     *\r\n     * @param constructor - The service class constructor\r\n     * @param options - Registration configuration\r\n     */\r\n    register<T extends object>(constructor: Constructor<T>, options: RegistrationOptions): void {\r\n        this.validateRegistration(constructor, options);\r\n\r\n        const reg = new Registration(\r\n            constructor,\r\n            options.scope ?? 'global',\r\n            options.inject,\r\n            options.properties ?? {},\r\n            options.key,\r\n            options.instance\r\n        );\r\n\r\n        if (options.key) {\r\n            this.servicesByKey.set(options.key, reg);\r\n        }\r\n        this.servicesByClassName.set(constructor.name, reg);\r\n    }\r\n\r\n    /**\r\n     * Registers a service by its class type.\r\n     * The service will be resolvable by its class constructor.\r\n     *\r\n     * @param constructor - The service class constructor\r\n     * @param options - Optional registration configuration\r\n     */\r\n    registerByType<T extends object>(\r\n        constructor: Constructor<T>,\r\n        options?: RegistrationOptions\r\n    ): void {\r\n        this.checkNameCollision(constructor);\r\n        if (options) this.validateRegistration(constructor, options);\r\n\r\n        const reg = new Registration(constructor, options?.scope ?? 'global', options?.inject ?? [], options?.properties, options?.key, options?.instance);\r\n        if (options?.key) {\r\n            this.servicesByKey.set(options.key, reg);\r\n        }\r\n        this.servicesByClassName.set(constructor.name, reg);\r\n    }\r\n\r\n    private checkNameCollision<T extends object>(constructor: Constructor<T>): void {\r\n        const existing = this.servicesByClassName.get(constructor.name);\r\n        if (existing && existing.classConstructor !== constructor) {\r\n            const error = reportError('Service name collision: different class registered with same name', {\r\n                service: constructor.name,\r\n            });\r\n            if (error) throw error;\r\n        }\r\n    }\r\n\r\n    private validateRegistration<T extends object>(constructor: Constructor<T>, options: RegistrationOptions): void {\r\n        this.checkNameCollision(constructor);\r\n\r\n        if (options.key) {\r\n            const existingByKey = this.servicesByKey.get(options.key);\r\n            if (existingByKey && existingByKey.classConstructor !== constructor) {\r\n                const error = reportError('Service key already registered to a different class', {\r\n                    key: options.key,\r\n                    existingClass: existingByKey.classConstructor.name,\r\n                    newClass: constructor.name,\r\n                });\r\n                if (error) throw error;\r\n            }\r\n        }\r\n\r\n        if (options.instance && options.inject.length > 0) {\r\n            const error = reportError('Service has both instance and inject (inject will be ignored)', {\r\n                service: constructor.name,\r\n            });\r\n            if (error) throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Attempts to retrieve a service registration.\r\n     * Returns undefined if the service is not registered.\r\n     *\r\n     * @param key - Either a string key or class constructor\r\n     * @returns The registration or undefined\r\n     */\r\n    tryGet<T extends object>(key: string | Constructor<T>): Registration | undefined {\r\n        if (typeof key === 'string') {\r\n            return this.servicesByKey.get(key);\r\n        }\r\n        return this.servicesByClassName.get(key.name);\r\n    }\r\n\r\n    /**\r\n     * Retrieves a service registration or throws if not found.\r\n     *\r\n     * @param key - Either a string key or class constructor\r\n     * @returns The registration\r\n     * @throws Error if the service is not registered\r\n     */\r\n    get<T extends object>(key: string | Constructor<T>): Registration {\r\n        const reg = this.tryGet(key);\r\n        if (!reg) {\r\n            const service = typeof key === 'string' ? key : key.name;\r\n            const error = reportError(`Failed to resolve service '${service}'`, {\r\n                service,\r\n                registeredTypes: Array.from(this.servicesByClassName.keys()),\r\n                registeredKeys: Array.from(this.servicesByKey.keys()),\r\n            });\r\n            if (error) throw error;\r\n        }\r\n        return reg!;\r\n    }\r\n}\r\n\r\n/**\r\n * Internal storage for tracking injected fields during service resolution.\r\n * @internal\r\n */\r\nconst injectedFields = new WeakMap<object, Map<string, string>>();\r\n\r\n/**\r\n * IoC container that resolves and manages service instances.\r\n * Creates instances based on registrations in a ServiceCollection,\r\n * handling constructor injection, property injection, and lifetime management.\r\n *\r\n * Typically you'll use the global `container` instance rather than creating your own.\r\n *\r\n * @example\r\n * // Resolve a service by class\r\n * const logger = container.resolve(LoggerService);\r\n *\r\n * // Resolve by string key\r\n * const cache = container.resolve<CacheService>('primaryCache');\r\n *\r\n * @example\r\n * // Full setup workflow\r\n * serviceCollection.register(UserService, {\r\n *     inject: [DatabaseConnection],\r\n *     scope: 'global'\r\n * });\r\n *\r\n * const userService = container.resolve(UserService);\r\n */\r\nexport class ServiceContainer {\r\n    private instances = new Map<string, any>();\r\n\r\n    /**\r\n     * Creates a new container backed by the given service collection.\r\n     *\r\n     * @param serviceCollection - The registry containing service registrations\r\n     */\r\n    constructor(private serviceCollection: ServiceCollection) {}\r\n\r\n    /**\r\n     * Resolves a service instance by class type or string key.\r\n     * Creates the instance if not already cached (for global scope).\r\n     * Handles constructor and property injection automatically.\r\n     *\r\n     * @param keyOrType - Either a string key or class constructor\r\n     * @returns The resolved service instance\r\n     * @throws Error if the service is not registered\r\n     *\r\n     * @example\r\n     * const service = container.resolve(MyService);\r\n     */\r\n    resolve<T extends object>(keyOrType: string | Constructor<T>): T {\r\n        const key = typeof keyOrType === 'string' ? keyOrType : keyOrType.name;\r\n\r\n        if (this.instances.has(key)) {\r\n            return this.instances.get(key);\r\n        }\r\n\r\n        const registration = this.serviceCollection.get(keyOrType);\r\n        if (!registration) {\r\n            const error = reportError(`Failed to resolve service '${key}'`, { service: key });\r\n            if (error) throw error;\r\n            return undefined as unknown as T;\r\n        }\r\n\r\n        if (registration.instance) {\r\n            const inst = registration.instance as T;\r\n            this.injectFields(inst, registration);\r\n            this.instances.set(key, inst);\r\n            return inst;\r\n        }\r\n\r\n        const instance = this.createInstance<T>(registration);\r\n        if (registration.scope === 'global') {\r\n            this.instances.set(key, instance);\r\n        }\r\n        this.injectFields(instance, registration);\r\n\r\n        return instance;\r\n    }\r\n\r\n    /**\r\n     * Creates a new instance of a service, resolving all constructor dependencies.\r\n     */\r\n    private createInstance<T extends object>(registration: Registration): T {\r\n        const constructor = registration.classConstructor as Constructor<T>;\r\n\r\n        const dependencies = registration.inject.map(dep => this.resolve(dep));\r\n        return new constructor(...dependencies);\r\n    }\r\n\r\n    /**\r\n     * Injects dependencies into instance properties based on registration config.\r\n     */\r\n    private injectFields<T extends object>(instance: T, registration: Registration): void {\r\n        for (const [fieldName, keyOrType] of Object.entries(registration.properties)) {\r\n            (instance as any)[fieldName] = this.resolve(keyOrType);\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Global service collection instance for registering services.\r\n * Use this to register services that can later be resolved by the container.\r\n *\r\n * @example\r\n * import { serviceCollection } from 'relaxjs';\r\n *\r\n * serviceCollection.register(MyService, { inject: [Dependency] });\r\n */\r\nexport const serviceCollection = new ServiceCollection();\r\n\r\n/**\r\n * Global service container instance for resolving dependencies.\r\n * Use this to obtain service instances with all dependencies injected.\r\n *\r\n * @example\r\n * import { container } from 'relaxjs';\r\n *\r\n * const service = container.resolve(MyService);\r\n */\r\nexport const container = new ServiceContainer(serviceCollection);"],
+  "mappings": "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",
   "names": ["index_exports", "__export", "ContainerService", "Inject", "ServiceCollection", "ServiceContainer", "container", "serviceCollection", "__toCommonJS", "RelaxError", "message", "context", "handler", "reportError", "message", "context", "error", "RelaxError", "handler", "suppressed", "Inject", "typeOrKey", "_", "context", "container", "ContainerService", "options", "target", "opts", "serviceCollection", "Registration", "classConstructor", "scope", "inject", "properties", "key", "instance", "ServiceCollection", "constructor", "reg", "existing", "error", "reportError", "existingByKey", "service", "ServiceContainer", "serviceCollection", "keyOrType", "key", "registration", "error", "reportError", "inst", "instance", "constructor", "dependencies", "dep", "fieldName", "ServiceCollection", "container"]
 }

package/dist/di/index.mjs

@@ -1,2 +1,2 @@
-var a=class extends Error{constructor(e,r){super(e);this.context=r}},u=null;function o(n,t){let e=new a(n,t);if(u){let r=!1;if(u(e,{suppress(){r=!0}}),r)return null}return e}function h(n){return(t,e)=>function(){return p.resolve(n)}}function x(n){return t=>{let e=n??{inject:[]};e.key?d.register(t,e):d.registerByType(t,e)}}var c=class{constructor(t,e,r,s={},i,v){this.classConstructor=t;this.scope=e;this.inject=r;this.properties=s;this.key=i;this.instance=v}},l=class{constructor(){this.servicesByKey=new Map;this.servicesByClassName=new Map}register(t,e){this.validateRegistration(t,e);let r=new c(t,e.scope??"global",e.inject,e.properties??{},e.key,e.instance);e.key&&this.servicesByKey.set(e.key,r),this.servicesByClassName.set(t.name,r)}registerByType(t,e){this.checkNameCollision(t),e&&this.validateRegistration(t,e);let r=new c(t,e?.scope,e?.inject??[],e?.properties,e?.key,e?.instance);e?.key&&this.servicesByKey.set(e.key,r),this.servicesByClassName.set(t.name,r)}checkNameCollision(t){let e=this.servicesByClassName.get(t.name);if(e&&e.classConstructor!==t){let r=o("Service name collision: different class registered with same name",{service:t.name});if(r)throw r}}validateRegistration(t,e){if(this.checkNameCollision(t),e.key){let r=this.servicesByKey.get(e.key);if(r&&r.classConstructor!==t){let s=o("Service key already registered to a different class",{key:e.key,existingClass:r.classConstructor.name,newClass:t.name});if(s)throw s}}if(e.instance&&e.inject.length>0){let r=o("Service has both instance and inject (inject will be ignored)",{service:t.name});if(r)throw r}}tryGet(t){return typeof t=="string"?this.servicesByKey.get(t):this.servicesByClassName.get(t.name)}get(t){let e=this.tryGet(t);if(!e){let r=typeof t=="string"?t:t.name,s=o(`Failed to resolve service '${r}'`,{service:r,registeredTypes:Array.from(this.servicesByClassName.keys()),registeredKeys:Array.from(this.servicesByKey.keys())});if(s)throw s}return e}};var g=class{constructor(t){this.serviceCollection=t;this.instances=new Map}resolve(t){let e=typeof t=="string"?t:t.name;if(this.instances.has(e))return this.instances.get(e);let r=this.serviceCollection.get(t);if(!r){let i=o(`Failed to resolve service '${e}'`,{service:e});if(i)throw i;return}if(r.instance){let i=r.instance;return this.injectFields(i,r),this.instances.set(e,i),i}let s=this.createInstance(r);return r.scope==="global"&&this.instances.set(e,s),this.injectFields(s,r),s}createInstance(t){let e=t.classConstructor,r=t.inject.map(s=>this.resolve(s));return new e(...r)}injectFields(t,e){for(let[r,s]of Object.entries(e.properties))t[r]=this.resolve(s)}},d=new l,p=new g(d);export{x as ContainerService,h as Inject,l as ServiceCollection,g as ServiceContainer,p as container,d as serviceCollection};
+var a=class extends Error{constructor(e,r){super(e);this.context=r}},u=null;function o(n,t){let e=new a(n,t);if(u){let r=!1;if(u(e,{suppress(){r=!0}}),r)return null}return e}function h(n){return(t,e)=>function(){return p.resolve(n)}}function x(n){return t=>{let e=n??{inject:[]};e.key?d.register(t,e):d.registerByType(t,e)}}var c=class{constructor(t,e,r,s={},i,v){this.classConstructor=t;this.scope=e;this.inject=r;this.properties=s;this.key=i;this.instance=v}},l=class{constructor(){this.servicesByKey=new Map;this.servicesByClassName=new Map}register(t,e){this.validateRegistration(t,e);let r=new c(t,e.scope??"global",e.inject,e.properties??{},e.key,e.instance);e.key&&this.servicesByKey.set(e.key,r),this.servicesByClassName.set(t.name,r)}registerByType(t,e){this.checkNameCollision(t),e&&this.validateRegistration(t,e);let r=new c(t,e?.scope??"global",e?.inject??[],e?.properties,e?.key,e?.instance);e?.key&&this.servicesByKey.set(e.key,r),this.servicesByClassName.set(t.name,r)}checkNameCollision(t){let e=this.servicesByClassName.get(t.name);if(e&&e.classConstructor!==t){let r=o("Service name collision: different class registered with same name",{service:t.name});if(r)throw r}}validateRegistration(t,e){if(this.checkNameCollision(t),e.key){let r=this.servicesByKey.get(e.key);if(r&&r.classConstructor!==t){let s=o("Service key already registered to a different class",{key:e.key,existingClass:r.classConstructor.name,newClass:t.name});if(s)throw s}}if(e.instance&&e.inject.length>0){let r=o("Service has both instance and inject (inject will be ignored)",{service:t.name});if(r)throw r}}tryGet(t){return typeof t=="string"?this.servicesByKey.get(t):this.servicesByClassName.get(t.name)}get(t){let e=this.tryGet(t);if(!e){let r=typeof t=="string"?t:t.name,s=o(`Failed to resolve service '${r}'`,{service:r,registeredTypes:Array.from(this.servicesByClassName.keys()),registeredKeys:Array.from(this.servicesByKey.keys())});if(s)throw s}return e}};var g=class{constructor(t){this.serviceCollection=t;this.instances=new Map}resolve(t){let e=typeof t=="string"?t:t.name;if(this.instances.has(e))return this.instances.get(e);let r=this.serviceCollection.get(t);if(!r){let i=o(`Failed to resolve service '${e}'`,{service:e});if(i)throw i;return}if(r.instance){let i=r.instance;return this.injectFields(i,r),this.instances.set(e,i),i}let s=this.createInstance(r);return r.scope==="global"&&this.instances.set(e,s),this.injectFields(s,r),s}createInstance(t){let e=t.classConstructor,r=t.inject.map(s=>this.resolve(s));return new e(...r)}injectFields(t,e){for(let[r,s]of Object.entries(e.properties))t[r]=this.resolve(s)}},d=new l,p=new g(d);export{x as ContainerService,h as Inject,l as ServiceCollection,g as ServiceContainer,p as container,d as serviceCollection};
 //# sourceMappingURL=index.mjs.map

package/dist/di/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/errors.ts", "../../src/DependencyInjection.ts"],
-  "sourcesContent": ["/**\r\n * Global error handling for Relaxjs.\r\n * Register a handler with `onError()` to intercept errors before they throw.\r\n * Call `ctx.suppress()` in the handler to prevent the error from being thrown.\r\n *\r\n * @example\r\n * import { onError } from 'relaxjs';\r\n *\r\n * onError((error, ctx) => {\r\n *     logToService(error.message, error.context);\r\n *     showToast(error.message);\r\n *     ctx.suppress();\r\n * });\r\n */\r\n\r\n/**\r\n * Passed to error handlers to control error behavior.\r\n * Call `suppress()` to prevent the error from being thrown.\r\n */\r\nexport interface ErrorContext {\r\n    suppress(): void;\r\n}\r\n\r\n/**\r\n * Error with structured context for debugging.\r\n * The `context` record contains details like route name, component tag, route data.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     console.log(error.context.route);\r\n *     console.log(error.context.componentTagName);\r\n * });\r\n */\r\nexport class RelaxError extends Error {\r\n    constructor(\r\n        message: string,\r\n        public context: Record<string, unknown>,\r\n    ) {\r\n        super(message);\r\n    }\r\n}\r\n\r\n/** @internal */\r\ntype ErrorHandler = (error: RelaxError, ctx: ErrorContext) => void;\r\n\r\nlet handler: ErrorHandler | null = null;\r\n\r\n/**\r\n * Registers a global error handler for Relaxjs errors.\r\n * The handler receives the error and an `ErrorContext`.\r\n * Call `ctx.suppress()` to prevent the error from being thrown.\r\n * Only one handler can be active at a time; subsequent calls replace the previous handler.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     if (error.context.route === 'optional-panel') {\r\n *         ctx.suppress();\r\n *         return;\r\n *     }\r\n *     showErrorDialog(error.message);\r\n * });\r\n */\r\nexport function onError(fn: ErrorHandler) {\r\n    handler = fn;\r\n}\r\n\r\n/**\r\n * Reports an error through the global handler.\r\n * Returns the `RelaxError` if it should be thrown, or `null` if the handler suppressed it.\r\n * The caller is responsible for throwing the returned error.\r\n *\r\n * @param message - Human-readable error description\r\n * @param context - Structured data for debugging (route, component, params, cause, etc.)\r\n * @returns The error to throw, or `null` if suppressed\r\n *\r\n * @example\r\n * const error = reportError('Failed to load route component', {\r\n *     route: 'user',\r\n *     componentTagName: 'user-profile',\r\n *     routeData: { id: 123 },\r\n * });\r\n * if (error) throw error;\r\n */\r\nexport function reportError(message: string, context: Record<string, unknown>): RelaxError | null {\r\n    const error = new RelaxError(message, context);\r\n    if (handler) {\r\n        let suppressed = false;\r\n        const ctx: ErrorContext = {\r\n            suppress() { suppressed = true; },\r\n        };\r\n        handler(error, ctx);\r\n        if (suppressed) {\r\n            return null;\r\n        }\r\n    }\r\n    return error;\r\n}\r\n\r\n/**\r\n * Wraps an async function into a synchronous callback suitable for addEventListener.\r\n * Catches promise rejections and reports them through the global error handler.\r\n *\r\n * @param fn - Async function to wrap\r\n * @returns Synchronous function that can be passed to addEventListener\r\n *\r\n * @example\r\n * button.addEventListener('click', asyncHandler(async (e) => {\r\n *     await saveData();\r\n * }));\r\n *\r\n * @example\r\n * form.addEventListener('submit', asyncHandler(async (e) => {\r\n *     e.preventDefault();\r\n *     await submitForm();\r\n * }));\r\n */\r\nexport function asyncHandler<TArgs extends unknown[]>(\r\n    fn: (...args: TArgs) => Promise<void>,\r\n): (...args: TArgs) => void {\r\n    return function (this: any, ...args: TArgs) {\r\n        fn.call(this, ...args).catch((cause: unknown) => {\r\n            const error = reportError('Async callback failed', { cause });\r\n            if (error) throw error;\r\n        });\r\n    };\r\n}\r\n", "import { reportError } from './errors';\r\n\r\n/**\r\n * Generic constructor type used for dependency registration and injection.\r\n * Represents any class constructor that can be used with the DI container.\r\n *\r\n * @template T - The type of object the constructor creates\r\n *\r\n * @example\r\n * // Use with service registration\r\n * class UserService {}\r\n * const ctor: Constructor<UserService> = UserService;\r\n * serviceCollection.registerByType(ctor, { inject: [] });\r\n */\r\nexport type Constructor<T extends object = object> = new (...args: any[]) => T;\r\n\r\n/**\r\n * Controls how service instances are shared across the container hierarchy.\r\n * Used when registering services to define their lifetime behavior.\r\n *\r\n * - `global`: Single instance shared everywhere (singleton pattern)\r\n * - `closest`: New instance per container scope (scoped lifetime)\r\n *\r\n * @example\r\n * // Singleton service - same instance everywhere\r\n * serviceCollection.register(LoggerService, { scope: 'global', inject: [] });\r\n *\r\n * // Scoped service - new instance per scope\r\n * serviceCollection.register(RequestContext, { scope: 'closest', inject: [] });\r\n */\r\nexport type ServiceScope = 'global' | 'closest';\r\n\r\n/**\r\n * Configuration options for registering a service in the DI container.\r\n * Controls identification, lifetime, and dependency resolution.\r\n *\r\n * @example\r\n * // Register with constructor injection\r\n * const options: RegistrationOptions = {\r\n *     scope: 'global',\r\n *     inject: [DatabaseConnection, ConfigService]\r\n * };\r\n * serviceCollection.register(UserRepository, options);\r\n *\r\n * @example\r\n * // Register with property injection\r\n * const options: RegistrationOptions = {\r\n *     inject: [],\r\n *     properties: { logger: Logger, config: 'appConfig' }\r\n * };\r\n *\r\n * @example\r\n * // Register with a pre-created instance\r\n * const options: RegistrationOptions = {\r\n *     inject: [],\r\n *     instance: existingService\r\n * };\r\n */\r\nexport interface RegistrationOptions {\r\n    /** Service lifetime - 'global' for singleton, 'closest' for scoped */\r\n    scope?: ServiceScope;\r\n    /** Optional string key for resolving by name instead of type */\r\n    key?: string;\r\n    /** Pre-existing instance to use instead of creating new one */\r\n    instance?: unknown;\r\n    /** Types or keys for constructor parameters, in order */\r\n    inject: (string | Constructor)[];\r\n    /** Map of property names to their injection types/keys */\r\n    properties?: Record<string, string | Constructor>;\r\n}\r\n\r\n/**\r\n * Field decorator that injects a service from the global DI container.\r\n * The service is resolved when the class instance is created (not at class definition time),\r\n * so services must be registered before the first instance is created.\r\n *\r\n * Works with web components regardless of how they are created:\r\n * - By the browser (HTML parsing): services are resolved during construction\r\n * - By application code (`document.createElement` or `new`): same behavior\r\n * - Injected fields are available in `connectedCallback` and all lifecycle methods\r\n *\r\n * @example\r\n * // Using `@Inject` in a web component\r\n * class UserPanel extends HTMLElement {\r\n *     @Inject(UserService)\r\n *     private userService!: UserService;\r\n *\r\n *     connectedCallback() {\r\n *         // userService is already resolved and ready to use\r\n *         const user = this.userService.getCurrentUser();\r\n *         this.render(user);\r\n *     }\r\n * }\r\n *\r\n * @example\r\n * // Services must be registered before components are created.\r\n * // In your app entry point (e.g. main.ts):\r\n * serviceCollection.registerByType(UserService, { inject: [ApiClient] });\r\n * serviceCollection.registerByType(ApiClient, { inject: [] });\r\n *\r\n * // Now components can be created (by browser or code)\r\n * customElements.define('user-panel', UserPanel);\r\n */\r\nexport function Inject<T extends object>(typeOrKey: Constructor<T> | string) {\r\n    return (_: undefined, context: ClassFieldDecoratorContext) => {\r\n        return function(this: any) {\r\n            return container.resolve(typeOrKey);\r\n        };\r\n    };\r\n}\r\n\r\n// Temporary collector of property injections - cleared after registration\r\n//const propertyCollector = new WeakMap<object, Record<string, string>>();\r\n\r\n/**\r\n * Class decorator that registers a service in the global DI container.\r\n * Registration happens at class definition time (when the module loads),\r\n * so import the module before creating instances that depend on this service.\r\n *\r\n * For web components: use `@ContainerService` on services, not on the\r\n * components themselves. Components use `@Inject` to consume services.\r\n *\r\n * @param options - Registration configuration including scope and dependencies\r\n *\r\n * @example\r\n * // Register a service that components can inject\r\n * @ContainerService({ inject: [ApiClient] })\r\n * class UserService {\r\n *     constructor(private api: ApiClient) {}\r\n *     getCurrentUser() { return this.api.get('/user'); }\r\n * }\r\n *\r\n * // Component consumes the service\r\n * class UserPanel extends HTMLElement {\r\n *     @Inject(UserService)\r\n *     private userService!: UserService;\r\n * }\r\n *\r\n * @example\r\n * // Service with custom key for named resolution\r\n * @ContainerService({ key: 'primaryCache', scope: 'global', inject: [] })\r\n * class CacheService {}\r\n *\r\n * // Later resolve by key\r\n * const cache = container.resolve('primaryCache');\r\n */\r\nexport function ContainerService<T extends object>(\r\n    options?: RegistrationOptions\r\n) {\r\n    return (target: Constructor<T>) => {\r\n        const opts = options ?? {inject: []};\r\n\r\n        if (opts.key) {\r\n            serviceCollection.register(target, opts);\r\n        } else {\r\n            serviceCollection.registerByType(target, opts);\r\n        }\r\n    };\r\n}\r\n\r\n/**\r\n * Internal class representing a registered service's metadata.\r\n * Holds all information needed to create and configure service instances.\r\n *\r\n * @internal This is an implementation detail and should not be used directly.\r\n */\r\nclass Registration {\r\n    /**\r\n     * Creates a new registration record.\r\n     *\r\n     * @param classConstructor - The class constructor function\r\n     * @param scope - Instance sharing behavior\r\n     * @param inject - Constructor parameter dependencies\r\n     * @param properties - Property injection mappings\r\n     * @param key - Optional string identifier\r\n     * @param instance - Optional pre-created instance\r\n     */\r\n    constructor(\r\n        public classConstructor: Constructor,\r\n        public scope: ServiceScope,\r\n        public inject: (string | Constructor)[],\r\n        public properties: Record<string, string | Constructor> = {},\r\n        public key?: string,\r\n        public instance?: unknown\r\n    ) {}\r\n}\r\n\r\n/**\r\n * Registry that stores service registration metadata.\r\n * Use this to register services before they can be resolved by a ServiceContainer.\r\n *\r\n * Typically you'll use the global `serviceCollection` instance rather than creating your own.\r\n *\r\n * @example\r\n * // Register a service by type\r\n * serviceCollection.registerByType(LoggerService, { inject: [] });\r\n *\r\n * // Register with a string key\r\n * serviceCollection.register(CacheService, { key: 'cache', inject: [] });\r\n *\r\n * // Check if service is registered\r\n * const reg = serviceCollection.tryGet(LoggerService);\r\n * if (reg) {\r\n *     console.log('Logger is registered');\r\n * }\r\n */\r\nexport class ServiceCollection {\r\n    private servicesByKey = new Map<string, Registration>();\r\n    private servicesByClassName = new Map<string, Registration>();\r\n\r\n    /**\r\n     * Registers a service with full configuration options.\r\n     * The service will be resolvable by both its class name and optional key.\r\n     *\r\n     * @param constructor - The service class constructor\r\n     * @param options - Registration configuration\r\n     */\r\n    register<T extends object>(constructor: Constructor<T>, options: RegistrationOptions): void {\r\n        this.validateRegistration(constructor, options);\r\n\r\n        const reg = new Registration(\r\n            constructor,\r\n            options.scope ?? 'global',\r\n            options.inject,\r\n            options.properties ?? {},\r\n            options.key,\r\n            options.instance\r\n        );\r\n\r\n        if (options.key) {\r\n            this.servicesByKey.set(options.key, reg);\r\n        }\r\n        this.servicesByClassName.set(constructor.name, reg);\r\n    }\r\n\r\n    /**\r\n     * Registers a service by its class type.\r\n     * The service will be resolvable by its class constructor.\r\n     *\r\n     * @param constructor - The service class constructor\r\n     * @param options - Optional registration configuration\r\n     */\r\n    registerByType<T extends object>(\r\n        constructor: Constructor<T>,\r\n        options?: RegistrationOptions\r\n    ): void {\r\n        this.checkNameCollision(constructor);\r\n        if (options) this.validateRegistration(constructor, options);\r\n\r\n        const reg = new Registration(constructor, options?.scope, options?.inject ?? [], options?.properties, options?.key, options?.instance);\r\n        if (options?.key) {\r\n            this.servicesByKey.set(options.key, reg);\r\n        }\r\n        this.servicesByClassName.set(constructor.name, reg);\r\n    }\r\n\r\n    private checkNameCollision<T extends object>(constructor: Constructor<T>): void {\r\n        const existing = this.servicesByClassName.get(constructor.name);\r\n        if (existing && existing.classConstructor !== constructor) {\r\n            const error = reportError('Service name collision: different class registered with same name', {\r\n                service: constructor.name,\r\n            });\r\n            if (error) throw error;\r\n        }\r\n    }\r\n\r\n    private validateRegistration<T extends object>(constructor: Constructor<T>, options: RegistrationOptions): void {\r\n        this.checkNameCollision(constructor);\r\n\r\n        if (options.key) {\r\n            const existingByKey = this.servicesByKey.get(options.key);\r\n            if (existingByKey && existingByKey.classConstructor !== constructor) {\r\n                const error = reportError('Service key already registered to a different class', {\r\n                    key: options.key,\r\n                    existingClass: existingByKey.classConstructor.name,\r\n                    newClass: constructor.name,\r\n                });\r\n                if (error) throw error;\r\n            }\r\n        }\r\n\r\n        if (options.instance && options.inject.length > 0) {\r\n            const error = reportError('Service has both instance and inject (inject will be ignored)', {\r\n                service: constructor.name,\r\n            });\r\n            if (error) throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Attempts to retrieve a service registration.\r\n     * Returns undefined if the service is not registered.\r\n     *\r\n     * @param key - Either a string key or class constructor\r\n     * @returns The registration or undefined\r\n     */\r\n    tryGet<T extends object>(key: string | Constructor<T>): Registration | undefined {\r\n        if (typeof key === 'string') {\r\n            return this.servicesByKey.get(key);\r\n        }\r\n        return this.servicesByClassName.get(key.name);\r\n    }\r\n\r\n    /**\r\n     * Retrieves a service registration or throws if not found.\r\n     *\r\n     * @param key - Either a string key or class constructor\r\n     * @returns The registration\r\n     * @throws Error if the service is not registered\r\n     */\r\n    get<T extends object>(key: string | Constructor<T>): Registration {\r\n        const reg = this.tryGet(key);\r\n        if (!reg) {\r\n            const service = typeof key === 'string' ? key : key.name;\r\n            const error = reportError(`Failed to resolve service '${service}'`, {\r\n                service,\r\n                registeredTypes: Array.from(this.servicesByClassName.keys()),\r\n                registeredKeys: Array.from(this.servicesByKey.keys()),\r\n            });\r\n            if (error) throw error;\r\n        }\r\n        return reg!;\r\n    }\r\n}\r\n\r\n/**\r\n * Internal storage for tracking injected fields during service resolution.\r\n * @internal\r\n */\r\nconst injectedFields = new WeakMap<object, Map<string, string>>();\r\n\r\n/**\r\n * IoC container that resolves and manages service instances.\r\n * Creates instances based on registrations in a ServiceCollection,\r\n * handling constructor injection, property injection, and lifetime management.\r\n *\r\n * Typically you'll use the global `container` instance rather than creating your own.\r\n *\r\n * @example\r\n * // Resolve a service by class\r\n * const logger = container.resolve(LoggerService);\r\n *\r\n * // Resolve by string key\r\n * const cache = container.resolve<CacheService>('primaryCache');\r\n *\r\n * @example\r\n * // Full setup workflow\r\n * serviceCollection.register(UserService, {\r\n *     inject: [DatabaseConnection],\r\n *     scope: 'global'\r\n * });\r\n *\r\n * const userService = container.resolve(UserService);\r\n */\r\nexport class ServiceContainer {\r\n    private instances = new Map<string, any>();\r\n\r\n    /**\r\n     * Creates a new container backed by the given service collection.\r\n     *\r\n     * @param serviceCollection - The registry containing service registrations\r\n     */\r\n    constructor(private serviceCollection: ServiceCollection) {}\r\n\r\n    /**\r\n     * Resolves a service instance by class type or string key.\r\n     * Creates the instance if not already cached (for global scope).\r\n     * Handles constructor and property injection automatically.\r\n     *\r\n     * @param keyOrType - Either a string key or class constructor\r\n     * @returns The resolved service instance\r\n     * @throws Error if the service is not registered\r\n     *\r\n     * @example\r\n     * const service = container.resolve(MyService);\r\n     */\r\n    resolve<T extends object>(keyOrType: string | Constructor<T>): T {\r\n        const key = typeof keyOrType === 'string' ? keyOrType : keyOrType.name;\r\n\r\n        if (this.instances.has(key)) {\r\n            return this.instances.get(key);\r\n        }\r\n\r\n        const registration = this.serviceCollection.get(keyOrType);\r\n        if (!registration) {\r\n            const error = reportError(`Failed to resolve service '${key}'`, { service: key });\r\n            if (error) throw error;\r\n            return undefined as unknown as T;\r\n        }\r\n\r\n        if (registration.instance) {\r\n            const inst = registration.instance as T;\r\n            this.injectFields(inst, registration);\r\n            this.instances.set(key, inst);\r\n            return inst;\r\n        }\r\n\r\n        const instance = this.createInstance<T>(registration);\r\n        if (registration.scope === 'global') {\r\n            this.instances.set(key, instance);\r\n        }\r\n        this.injectFields(instance, registration);\r\n\r\n        return instance;\r\n    }\r\n\r\n    /**\r\n     * Creates a new instance of a service, resolving all constructor dependencies.\r\n     */\r\n    private createInstance<T extends object>(registration: Registration): T {\r\n        const constructor = registration.classConstructor as Constructor<T>;\r\n\r\n        const dependencies = registration.inject.map(dep => this.resolve(dep));\r\n        return new constructor(...dependencies);\r\n    }\r\n\r\n    /**\r\n     * Injects dependencies into instance properties based on registration config.\r\n     */\r\n    private injectFields<T extends object>(instance: T, registration: Registration): void {\r\n        for (const [fieldName, keyOrType] of Object.entries(registration.properties)) {\r\n            (instance as any)[fieldName] = this.resolve(keyOrType);\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Global service collection instance for registering services.\r\n * Use this to register services that can later be resolved by the container.\r\n *\r\n * @example\r\n * import { serviceCollection } from 'relaxjs';\r\n *\r\n * serviceCollection.register(MyService, { inject: [Dependency] });\r\n */\r\nexport const serviceCollection = new ServiceCollection();\r\n\r\n/**\r\n * Global service container instance for resolving dependencies.\r\n * Use this to obtain service instances with all dependencies injected.\r\n *\r\n * @example\r\n * import { container } from 'relaxjs';\r\n *\r\n * const service = container.resolve(MyService);\r\n */\r\nexport const container = new ServiceContainer(serviceCollection);"],
-  "mappings": "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",
+  "sourcesContent": ["/**\r\n * Global error handling for Relaxjs.\r\n * Register a handler with `onError()` to intercept errors before they throw.\r\n * Call `ctx.suppress()` in the handler to prevent the error from being thrown.\r\n *\r\n * @example\r\n * import { onError } from 'relaxjs';\r\n *\r\n * onError((error, ctx) => {\r\n *     logToService(error.message, error.context);\r\n *     showToast(error.message);\r\n *     ctx.suppress();\r\n * });\r\n */\r\n\r\n/**\r\n * Passed to error handlers to control error behavior.\r\n * Call `suppress()` to prevent the error from being thrown.\r\n */\r\nexport interface ErrorContext {\r\n    suppress(): void;\r\n}\r\n\r\n/**\r\n * Error with structured context for debugging.\r\n * The `context` record contains details like route name, component tag, route data.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     console.log(error.context.route);\r\n *     console.log(error.context.componentTagName);\r\n * });\r\n */\r\nexport class RelaxError extends Error {\r\n    constructor(\r\n        message: string,\r\n        public context: Record<string, unknown>,\r\n    ) {\r\n        super(message);\r\n    }\r\n}\r\n\r\n/** @internal */\r\ntype ErrorHandler = (error: RelaxError, ctx: ErrorContext) => void;\r\n\r\nlet handler: ErrorHandler | null = null;\r\n\r\n/**\r\n * Registers a global error handler for Relaxjs errors.\r\n * The handler receives the error and an `ErrorContext`.\r\n * Call `ctx.suppress()` to prevent the error from being thrown.\r\n * Only one handler can be active at a time; subsequent calls replace the previous handler.\r\n *\r\n * @example\r\n * onError((error, ctx) => {\r\n *     if (error.context.route === 'optional-panel') {\r\n *         ctx.suppress();\r\n *         return;\r\n *     }\r\n *     showErrorDialog(error.message);\r\n * });\r\n */\r\nexport function onError(fn: ErrorHandler) {\r\n    handler = fn;\r\n}\r\n\r\n/**\r\n * Reports an error through the global handler.\r\n * Returns the `RelaxError` if it should be thrown, or `null` if the handler suppressed it.\r\n * The caller is responsible for throwing the returned error.\r\n *\r\n * @param message - Human-readable error description\r\n * @param context - Structured data for debugging (route, component, params, cause, etc.)\r\n * @returns The error to throw, or `null` if suppressed\r\n *\r\n * @example\r\n * const error = reportError('Failed to load route component', {\r\n *     route: 'user',\r\n *     componentTagName: 'user-profile',\r\n *     routeData: { id: 123 },\r\n * });\r\n * if (error) throw error;\r\n */\r\nexport function reportError(message: string, context: Record<string, unknown>): RelaxError | null {\r\n    const error = new RelaxError(message, context);\r\n    if (handler) {\r\n        let suppressed = false;\r\n        const ctx: ErrorContext = {\r\n            suppress() { suppressed = true; },\r\n        };\r\n        handler(error, ctx);\r\n        if (suppressed) {\r\n            return null;\r\n        }\r\n    }\r\n    return error;\r\n}\r\n\r\n/**\r\n * Wraps an async function into a synchronous callback suitable for addEventListener.\r\n * Catches promise rejections and reports them through the global error handler.\r\n *\r\n * @param fn - Async function to wrap\r\n * @returns Synchronous function that can be passed to addEventListener\r\n *\r\n * @example\r\n * button.addEventListener('click', asyncHandler(async (e) => {\r\n *     await saveData();\r\n * }));\r\n *\r\n * @example\r\n * form.addEventListener('submit', asyncHandler(async (e) => {\r\n *     e.preventDefault();\r\n *     await submitForm();\r\n * }));\r\n */\r\nexport function asyncHandler<TArgs extends unknown[]>(\r\n    fn: (...args: TArgs) => Promise<void>,\r\n): (...args: TArgs) => void {\r\n    return function (this: any, ...args: TArgs) {\r\n        fn.call(this, ...args).catch((cause: unknown) => {\r\n            const error = reportError('Async callback failed', { cause });\r\n            if (error) throw error;\r\n        });\r\n    };\r\n}\r\n", "import { reportError } from './errors';\r\n\r\n/**\r\n * Generic constructor type used for dependency registration and injection.\r\n * Represents any class constructor that can be used with the DI container.\r\n *\r\n * @template T - The type of object the constructor creates\r\n *\r\n * @example\r\n * // Use with service registration\r\n * class UserService {}\r\n * const ctor: Constructor<UserService> = UserService;\r\n * serviceCollection.registerByType(ctor, { inject: [] });\r\n */\r\nexport type Constructor<T extends object = object> = new (...args: any[]) => T;\r\n\r\n/**\r\n * Controls how service instances are shared across the container hierarchy.\r\n * Used when registering services to define their lifetime behavior.\r\n *\r\n * - `global`: Single instance shared everywhere (singleton pattern)\r\n * - `closest`: New instance per container scope (scoped lifetime)\r\n *\r\n * @example\r\n * // Singleton service - same instance everywhere\r\n * serviceCollection.register(LoggerService, { scope: 'global', inject: [] });\r\n *\r\n * // Scoped service - new instance per scope\r\n * serviceCollection.register(RequestContext, { scope: 'closest', inject: [] });\r\n */\r\nexport type ServiceScope = 'global' | 'closest';\r\n\r\n/**\r\n * Configuration options for registering a service in the DI container.\r\n * Controls identification, lifetime, and dependency resolution.\r\n *\r\n * @example\r\n * // Register with constructor injection\r\n * const options: RegistrationOptions = {\r\n *     scope: 'global',\r\n *     inject: [DatabaseConnection, ConfigService]\r\n * };\r\n * serviceCollection.register(UserRepository, options);\r\n *\r\n * @example\r\n * // Register with property injection\r\n * const options: RegistrationOptions = {\r\n *     inject: [],\r\n *     properties: { logger: Logger, config: 'appConfig' }\r\n * };\r\n *\r\n * @example\r\n * // Register with a pre-created instance\r\n * const options: RegistrationOptions = {\r\n *     inject: [],\r\n *     instance: existingService\r\n * };\r\n */\r\nexport interface RegistrationOptions {\r\n    /** Service lifetime - 'global' for singleton, 'closest' for scoped */\r\n    scope?: ServiceScope;\r\n    /** Optional string key for resolving by name instead of type */\r\n    key?: string;\r\n    /** Pre-existing instance to use instead of creating new one */\r\n    instance?: unknown;\r\n    /** Types or keys for constructor parameters, in order */\r\n    inject: (string | Constructor)[];\r\n    /** Map of property names to their injection types/keys */\r\n    properties?: Record<string, string | Constructor>;\r\n}\r\n\r\n/**\r\n * Field decorator that injects a service from the global DI container.\r\n * The service is resolved when the class instance is created (not at class definition time),\r\n * so services must be registered before the first instance is created.\r\n *\r\n * Works with web components regardless of how they are created:\r\n * - By the browser (HTML parsing): services are resolved during construction\r\n * - By application code (`document.createElement` or `new`): same behavior\r\n * - Injected fields are available in `connectedCallback` and all lifecycle methods\r\n *\r\n * @example\r\n * // Using `@Inject` in a web component\r\n * class UserPanel extends HTMLElement {\r\n *     @Inject(UserService)\r\n *     private userService!: UserService;\r\n *\r\n *     connectedCallback() {\r\n *         // userService is already resolved and ready to use\r\n *         const user = this.userService.getCurrentUser();\r\n *         this.render(user);\r\n *     }\r\n * }\r\n *\r\n * @example\r\n * // Services must be registered before components are created.\r\n * // In your app entry point (e.g. main.ts):\r\n * serviceCollection.registerByType(UserService, { inject: [ApiClient] });\r\n * serviceCollection.registerByType(ApiClient, { inject: [] });\r\n *\r\n * // Now components can be created (by browser or code)\r\n * customElements.define('user-panel', UserPanel);\r\n */\r\nexport function Inject<T extends object>(typeOrKey: Constructor<T> | string) {\r\n    return (_: undefined, context: ClassFieldDecoratorContext) => {\r\n        return function(this: any) {\r\n            return container.resolve(typeOrKey);\r\n        };\r\n    };\r\n}\r\n\r\n// Temporary collector of property injections - cleared after registration\r\n//const propertyCollector = new WeakMap<object, Record<string, string>>();\r\n\r\n/**\r\n * Class decorator that registers a service in the global DI container.\r\n * Registration happens at class definition time (when the module loads),\r\n * so import the module before creating instances that depend on this service.\r\n *\r\n * For web components: use `@ContainerService` on services, not on the\r\n * components themselves. Components use `@Inject` to consume services.\r\n *\r\n * @param options - Registration configuration including scope and dependencies\r\n *\r\n * @example\r\n * // Register a service that components can inject\r\n * @ContainerService({ inject: [ApiClient] })\r\n * class UserService {\r\n *     constructor(private api: ApiClient) {}\r\n *     getCurrentUser() { return this.api.get('/user'); }\r\n * }\r\n *\r\n * // Component consumes the service\r\n * class UserPanel extends HTMLElement {\r\n *     @Inject(UserService)\r\n *     private userService!: UserService;\r\n * }\r\n *\r\n * @example\r\n * // Service with custom key for named resolution\r\n * @ContainerService({ key: 'primaryCache', scope: 'global', inject: [] })\r\n * class CacheService {}\r\n *\r\n * // Later resolve by key\r\n * const cache = container.resolve('primaryCache');\r\n */\r\nexport function ContainerService<T extends object>(\r\n    options?: RegistrationOptions\r\n) {\r\n    return (target: Constructor<T>) => {\r\n        const opts = options ?? {inject: []};\r\n\r\n        if (opts.key) {\r\n            serviceCollection.register(target, opts);\r\n        } else {\r\n            serviceCollection.registerByType(target, opts);\r\n        }\r\n    };\r\n}\r\n\r\n/**\r\n * Internal class representing a registered service's metadata.\r\n * Holds all information needed to create and configure service instances.\r\n *\r\n * @internal This is an implementation detail and should not be used directly.\r\n */\r\nclass Registration {\r\n    /**\r\n     * Creates a new registration record.\r\n     *\r\n     * @param classConstructor - The class constructor function\r\n     * @param scope - Instance sharing behavior\r\n     * @param inject - Constructor parameter dependencies\r\n     * @param properties - Property injection mappings\r\n     * @param key - Optional string identifier\r\n     * @param instance - Optional pre-created instance\r\n     */\r\n    constructor(\r\n        public classConstructor: Constructor,\r\n        public scope: ServiceScope,\r\n        public inject: (string | Constructor)[],\r\n        public properties: Record<string, string | Constructor> = {},\r\n        public key?: string,\r\n        public instance?: unknown\r\n    ) {}\r\n}\r\n\r\n/**\r\n * Registry that stores service registration metadata.\r\n * Use this to register services before they can be resolved by a ServiceContainer.\r\n *\r\n * Typically you'll use the global `serviceCollection` instance rather than creating your own.\r\n *\r\n * @example\r\n * // Register a service by type\r\n * serviceCollection.registerByType(LoggerService, { inject: [] });\r\n *\r\n * // Register with a string key\r\n * serviceCollection.register(CacheService, { key: 'cache', inject: [] });\r\n *\r\n * // Check if service is registered\r\n * const reg = serviceCollection.tryGet(LoggerService);\r\n * if (reg) {\r\n *     console.log('Logger is registered');\r\n * }\r\n */\r\nexport class ServiceCollection {\r\n    private servicesByKey = new Map<string, Registration>();\r\n    private servicesByClassName = new Map<string, Registration>();\r\n\r\n    /**\r\n     * Registers a service with full configuration options.\r\n     * The service will be resolvable by both its class name and optional key.\r\n     *\r\n     * @param constructor - The service class constructor\r\n     * @param options - Registration configuration\r\n     */\r\n    register<T extends object>(constructor: Constructor<T>, options: RegistrationOptions): void {\r\n        this.validateRegistration(constructor, options);\r\n\r\n        const reg = new Registration(\r\n            constructor,\r\n            options.scope ?? 'global',\r\n            options.inject,\r\n            options.properties ?? {},\r\n            options.key,\r\n            options.instance\r\n        );\r\n\r\n        if (options.key) {\r\n            this.servicesByKey.set(options.key, reg);\r\n        }\r\n        this.servicesByClassName.set(constructor.name, reg);\r\n    }\r\n\r\n    /**\r\n     * Registers a service by its class type.\r\n     * The service will be resolvable by its class constructor.\r\n     *\r\n     * @param constructor - The service class constructor\r\n     * @param options - Optional registration configuration\r\n     */\r\n    registerByType<T extends object>(\r\n        constructor: Constructor<T>,\r\n        options?: RegistrationOptions\r\n    ): void {\r\n        this.checkNameCollision(constructor);\r\n        if (options) this.validateRegistration(constructor, options);\r\n\r\n        const reg = new Registration(constructor, options?.scope ?? 'global', options?.inject ?? [], options?.properties, options?.key, options?.instance);\r\n        if (options?.key) {\r\n            this.servicesByKey.set(options.key, reg);\r\n        }\r\n        this.servicesByClassName.set(constructor.name, reg);\r\n    }\r\n\r\n    private checkNameCollision<T extends object>(constructor: Constructor<T>): void {\r\n        const existing = this.servicesByClassName.get(constructor.name);\r\n        if (existing && existing.classConstructor !== constructor) {\r\n            const error = reportError('Service name collision: different class registered with same name', {\r\n                service: constructor.name,\r\n            });\r\n            if (error) throw error;\r\n        }\r\n    }\r\n\r\n    private validateRegistration<T extends object>(constructor: Constructor<T>, options: RegistrationOptions): void {\r\n        this.checkNameCollision(constructor);\r\n\r\n        if (options.key) {\r\n            const existingByKey = this.servicesByKey.get(options.key);\r\n            if (existingByKey && existingByKey.classConstructor !== constructor) {\r\n                const error = reportError('Service key already registered to a different class', {\r\n                    key: options.key,\r\n                    existingClass: existingByKey.classConstructor.name,\r\n                    newClass: constructor.name,\r\n                });\r\n                if (error) throw error;\r\n            }\r\n        }\r\n\r\n        if (options.instance && options.inject.length > 0) {\r\n            const error = reportError('Service has both instance and inject (inject will be ignored)', {\r\n                service: constructor.name,\r\n            });\r\n            if (error) throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Attempts to retrieve a service registration.\r\n     * Returns undefined if the service is not registered.\r\n     *\r\n     * @param key - Either a string key or class constructor\r\n     * @returns The registration or undefined\r\n     */\r\n    tryGet<T extends object>(key: string | Constructor<T>): Registration | undefined {\r\n        if (typeof key === 'string') {\r\n            return this.servicesByKey.get(key);\r\n        }\r\n        return this.servicesByClassName.get(key.name);\r\n    }\r\n\r\n    /**\r\n     * Retrieves a service registration or throws if not found.\r\n     *\r\n     * @param key - Either a string key or class constructor\r\n     * @returns The registration\r\n     * @throws Error if the service is not registered\r\n     */\r\n    get<T extends object>(key: string | Constructor<T>): Registration {\r\n        const reg = this.tryGet(key);\r\n        if (!reg) {\r\n            const service = typeof key === 'string' ? key : key.name;\r\n            const error = reportError(`Failed to resolve service '${service}'`, {\r\n                service,\r\n                registeredTypes: Array.from(this.servicesByClassName.keys()),\r\n                registeredKeys: Array.from(this.servicesByKey.keys()),\r\n            });\r\n            if (error) throw error;\r\n        }\r\n        return reg!;\r\n    }\r\n}\r\n\r\n/**\r\n * Internal storage for tracking injected fields during service resolution.\r\n * @internal\r\n */\r\nconst injectedFields = new WeakMap<object, Map<string, string>>();\r\n\r\n/**\r\n * IoC container that resolves and manages service instances.\r\n * Creates instances based on registrations in a ServiceCollection,\r\n * handling constructor injection, property injection, and lifetime management.\r\n *\r\n * Typically you'll use the global `container` instance rather than creating your own.\r\n *\r\n * @example\r\n * // Resolve a service by class\r\n * const logger = container.resolve(LoggerService);\r\n *\r\n * // Resolve by string key\r\n * const cache = container.resolve<CacheService>('primaryCache');\r\n *\r\n * @example\r\n * // Full setup workflow\r\n * serviceCollection.register(UserService, {\r\n *     inject: [DatabaseConnection],\r\n *     scope: 'global'\r\n * });\r\n *\r\n * const userService = container.resolve(UserService);\r\n */\r\nexport class ServiceContainer {\r\n    private instances = new Map<string, any>();\r\n\r\n    /**\r\n     * Creates a new container backed by the given service collection.\r\n     *\r\n     * @param serviceCollection - The registry containing service registrations\r\n     */\r\n    constructor(private serviceCollection: ServiceCollection) {}\r\n\r\n    /**\r\n     * Resolves a service instance by class type or string key.\r\n     * Creates the instance if not already cached (for global scope).\r\n     * Handles constructor and property injection automatically.\r\n     *\r\n     * @param keyOrType - Either a string key or class constructor\r\n     * @returns The resolved service instance\r\n     * @throws Error if the service is not registered\r\n     *\r\n     * @example\r\n     * const service = container.resolve(MyService);\r\n     */\r\n    resolve<T extends object>(keyOrType: string | Constructor<T>): T {\r\n        const key = typeof keyOrType === 'string' ? keyOrType : keyOrType.name;\r\n\r\n        if (this.instances.has(key)) {\r\n            return this.instances.get(key);\r\n        }\r\n\r\n        const registration = this.serviceCollection.get(keyOrType);\r\n        if (!registration) {\r\n            const error = reportError(`Failed to resolve service '${key}'`, { service: key });\r\n            if (error) throw error;\r\n            return undefined as unknown as T;\r\n        }\r\n\r\n        if (registration.instance) {\r\n            const inst = registration.instance as T;\r\n            this.injectFields(inst, registration);\r\n            this.instances.set(key, inst);\r\n            return inst;\r\n        }\r\n\r\n        const instance = this.createInstance<T>(registration);\r\n        if (registration.scope === 'global') {\r\n            this.instances.set(key, instance);\r\n        }\r\n        this.injectFields(instance, registration);\r\n\r\n        return instance;\r\n    }\r\n\r\n    /**\r\n     * Creates a new instance of a service, resolving all constructor dependencies.\r\n     */\r\n    private createInstance<T extends object>(registration: Registration): T {\r\n        const constructor = registration.classConstructor as Constructor<T>;\r\n\r\n        const dependencies = registration.inject.map(dep => this.resolve(dep));\r\n        return new constructor(...dependencies);\r\n    }\r\n\r\n    /**\r\n     * Injects dependencies into instance properties based on registration config.\r\n     */\r\n    private injectFields<T extends object>(instance: T, registration: Registration): void {\r\n        for (const [fieldName, keyOrType] of Object.entries(registration.properties)) {\r\n            (instance as any)[fieldName] = this.resolve(keyOrType);\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Global service collection instance for registering services.\r\n * Use this to register services that can later be resolved by the container.\r\n *\r\n * @example\r\n * import { serviceCollection } from 'relaxjs';\r\n *\r\n * serviceCollection.register(MyService, { inject: [Dependency] });\r\n */\r\nexport const serviceCollection = new ServiceCollection();\r\n\r\n/**\r\n * Global service container instance for resolving dependencies.\r\n * Use this to obtain service instances with all dependencies injected.\r\n *\r\n * @example\r\n * import { container } from 'relaxjs';\r\n *\r\n * const service = container.resolve(MyService);\r\n */\r\nexport const container = new ServiceContainer(serviceCollection);"],
+  "mappings": "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",
   "names": ["RelaxError", "message", "context", "handler", "reportError", "message", "context", "error", "RelaxError", "handler", "suppressed", "Inject", "typeOrKey", "_", "context", "container", "ContainerService", "options", "target", "opts", "serviceCollection", "Registration", "classConstructor", "scope", "inject", "properties", "key", "instance", "ServiceCollection", "constructor", "reg", "existing", "error", "reportError", "existingByKey", "service", "ServiceContainer", "serviceCollection", "keyOrType", "key", "registration", "error", "reportError", "inst", "instance", "constructor", "dependencies", "dep", "fieldName", "ServiceCollection", "container"]
 }

package/dist/elements/index.js

@@ -1,2 +1,2 @@
-var i=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var f=(t,n)=>{for(var r in n)i(t,r,{get:n[r],enumerable:!0})},E=(t,n,r,e)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of u(n))!c.call(t,o)&&o!==r&&i(t,o,{get:()=>n[o],enumerable:!(e=s(n,o))||e.enumerable});return t};var T=t=>E(i({},"__esModule",{value:!0}),t);var d={};f(d,{formError:()=>m,getParentComponent:()=>a,selectOne:()=>l});module.exports=T(d);function l(t,n){let r=n??document,e;if(t.startsWith("#")){let o=t.slice(1);e=r.querySelector(`#${CSS.escape(o)}`)??r.querySelector(`[name="${o}"]`)}else e=r.querySelector(t);if(!e)throw new Error(`No element found matching '${t}'`);return e}function m(t,n,r){let e=l(t,r);if(e instanceof HTMLInputElement||e instanceof HTMLSelectElement||e instanceof HTMLTextAreaElement||e instanceof HTMLButtonElement){e.setCustomValidity(n),e.reportValidity();return}if(e.constructor.formAssociated===!0&&"setCustomValidity"in e){e.setCustomValidity(n),e.reportValidity();return}throw new Error(`Element matching '${t}' is not a form field`)}function a(t,n){let r=t.parentElement;for(;r;){if(r instanceof n)return r;r=r.parentElement}return null}
+"use strict";var i=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var f=(t,n)=>{for(var r in n)i(t,r,{get:n[r],enumerable:!0})},E=(t,n,r,e)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of u(n))!c.call(t,o)&&o!==r&&i(t,o,{get:()=>n[o],enumerable:!(e=s(n,o))||e.enumerable});return t};var T=t=>E(i({},"__esModule",{value:!0}),t);var d={};f(d,{formError:()=>m,getParentComponent:()=>a,selectOne:()=>l});module.exports=T(d);function l(t,n){let r=n??document,e;if(t.startsWith("#")){let o=t.slice(1);e=r.querySelector(`#${CSS.escape(o)}`)??r.querySelector(`[name="${o}"]`)}else e=r.querySelector(t);if(!e)throw new Error(`No element found matching '${t}'`);return e}function m(t,n,r){let e=l(t,r);if(e instanceof HTMLInputElement||e instanceof HTMLSelectElement||e instanceof HTMLTextAreaElement||e instanceof HTMLButtonElement){e.setCustomValidity(n),e.reportValidity();return}if(e.constructor.formAssociated===!0&&"setCustomValidity"in e){e.setCustomValidity(n),e.reportValidity();return}throw new Error(`Element matching '${t}' is not a form field`)}function a(t,n){let r=t.parentElement;for(;r;){if(r instanceof n)return r;r=r.parentElement}return null}
 //# sourceMappingURL=index.js.map

package/dist/elements/index.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../src/elements/index.ts", "../../src/elements/dom.ts", "../../src/getParentComponent.ts"],
   "sourcesContent": ["export { selectOne, formError } from './dom';\r\nexport { getParentComponent } from '../getParentComponent';\r\n", "/**\r\n * Finds exactly one element matching the selector. When the selector starts\r\n * with `#`, both `id` and `name` attributes are tried.\r\n *\r\n * @example\r\n *     const input = selectOne<HTMLInputElement>('#email');\r\n *     const btn = selectOne<HTMLButtonElement>('.submit', form);\r\n */\r\nexport function selectOne<T extends Element = HTMLElement>(\r\n    selector: string,\r\n    parent?: Element | Document,\r\n): T {\r\n    const root = parent ?? document;\r\n\r\n    let el: Element | null;\r\n    if (selector.startsWith('#')) {\r\n        const name = selector.slice(1);\r\n        el = root.querySelector(`#${CSS.escape(name)}`)\r\n            ?? root.querySelector(`[name=\"${name}\"]`);\r\n    } else {\r\n        el = root.querySelector(selector);\r\n    }\r\n\r\n    if (!el) {\r\n        throw new Error(`No element found matching '${selector}'`);\r\n    }\r\n\r\n    return el as T;\r\n}\r\n\r\n/**\r\n * Sets a validation error on a form field found by selector. Supports native\r\n * form elements and form-associated custom elements using `ElementInternals`.\r\n *\r\n * @example\r\n *     formError('#email', 'Please enter a valid email');\r\n *     formError('#email', ''); // clears the error\r\n */\r\nexport function formError(\r\n    selector: string,\r\n    message: string,\r\n    parent?: Element | Document,\r\n): void {\r\n    const el = selectOne<HTMLElement>(selector, parent);\r\n\r\n    if (\r\n        el instanceof HTMLInputElement\r\n        || el instanceof HTMLSelectElement\r\n        || el instanceof HTMLTextAreaElement\r\n        || el instanceof HTMLButtonElement\r\n    ) {\r\n        el.setCustomValidity(message);\r\n        el.reportValidity();\r\n        return;\r\n    }\r\n\r\n    if (\r\n        (el.constructor as any).formAssociated === true\r\n        && 'setCustomValidity' in el\r\n    ) {\r\n        (el as any).setCustomValidity(message);\r\n        (el as any).reportValidity();\r\n        return;\r\n    }\r\n\r\n    throw new Error(\r\n        `Element matching '${selector}' is not a form field`,\r\n    );\r\n}\r\n", "/**\r\n * Finds the closest parent element of a specific Web Component type.\r\n * Traverses up the DOM tree looking for an ancestor matching the constructor.\r\n *\r\n * Useful for child components that need to communicate with or access\r\n * their parent container component, common in composite component patterns.\r\n *\r\n * @template T - The type of HTMLElement to find\r\n * @param node - The starting node to search from\r\n * @param constructor - The class constructor of the desired element type\r\n * @returns The matching parent element or null if not found\r\n *\r\n * @example\r\n * // Inside a child component, find the parent container\r\n * class ListItem extends HTMLElement {\r\n *     connectedCallback() {\r\n *         const list = getParentComponent(this, ListContainer);\r\n *         if (list) {\r\n *             list.registerItem(this);\r\n *         }\r\n *     }\r\n * }\r\n *\r\n * @example\r\n * // Access parent component's methods\r\n * class TabPanel extends HTMLElement {\r\n *     activate() {\r\n *         const tabs = getParentComponent(this, TabContainer);\r\n *         tabs?.selectPanel(this);\r\n *     }\r\n * }\r\n *\r\n * @example\r\n * // Handle case where parent might not exist\r\n * const form = getParentComponent(input, FormContainer);\r\n * if (!form) {\r\n *     console.warn('Input must be inside a FormContainer');\r\n *     return;\r\n * }\r\n */\r\nexport function getParentComponent<T extends HTMLElement>(\r\n    node: Node,\r\n    constructor: { new (...args: any[]): T }\r\n): T | null {\r\n    let current = node.parentElement;\r\n\r\n    while (current) {\r\n        if (current instanceof constructor) {\r\n            return current;\r\n        }\r\n        current = current.parentElement;\r\n    }\r\n\r\n    return null;\r\n}   "],
-  "mappings": "4ZAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,eAAAE,EAAA,uBAAAC,EAAA,cAAAC,IAAA,eAAAC,EAAAL,GCQO,SAASM,EACZC,EACAC,EACC,CACD,IAAMC,EAAOD,GAAU,SAEnBE,EACJ,GAAIH,EAAS,WAAW,GAAG,EAAG,CAC1B,IAAMI,EAAOJ,EAAS,MAAM,CAAC,EAC7BG,EAAKD,EAAK,cAAc,IAAI,IAAI,OAAOE,CAAI,CAAC,EAAE,GACvCF,EAAK,cAAc,UAAUE,CAAI,IAAI,CAChD,MACID,EAAKD,EAAK,cAAcF,CAAQ,EAGpC,GAAI,CAACG,EACD,MAAM,IAAI,MAAM,8BAA8BH,CAAQ,GAAG,EAG7D,OAAOG,CACX,CAUO,SAASE,EACZL,EACAM,EACAL,EACI,CACJ,IAAME,EAAKJ,EAAuBC,EAAUC,CAAM,EAElD,GACIE,aAAc,kBACXA,aAAc,mBACdA,aAAc,qBACdA,aAAc,kBACnB,CACEA,EAAG,kBAAkBG,CAAO,EAC5BH,EAAG,eAAe,EAClB,MACJ,CAEA,GACKA,EAAG,YAAoB,iBAAmB,IACxC,sBAAuBA,EAC5B,CACGA,EAAW,kBAAkBG,CAAO,EACpCH,EAAW,eAAe,EAC3B,MACJ,CAEA,MAAM,IAAI,MACN,qBAAqBH,CAAQ,uBACjC,CACJ,CC5BO,SAASO,EACZC,EACAC,EACQ,CACR,IAAIC,EAAUF,EAAK,cAEnB,KAAOE,GAAS,CACZ,GAAIA,aAAmBD,EACnB,OAAOC,EAEXA,EAAUA,EAAQ,aACtB,CAEA,OAAO,IACX",
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,eAAAE,EAAA,uBAAAC,EAAA,cAAAC,IAAA,eAAAC,EAAAL,GCQO,SAASM,EACZC,EACAC,EACC,CACD,IAAMC,EAAOD,GAAU,SAEnBE,EACJ,GAAIH,EAAS,WAAW,GAAG,EAAG,CAC1B,IAAMI,EAAOJ,EAAS,MAAM,CAAC,EAC7BG,EAAKD,EAAK,cAAc,IAAI,IAAI,OAAOE,CAAI,CAAC,EAAE,GACvCF,EAAK,cAAc,UAAUE,CAAI,IAAI,CAChD,MACID,EAAKD,EAAK,cAAcF,CAAQ,EAGpC,GAAI,CAACG,EACD,MAAM,IAAI,MAAM,8BAA8BH,CAAQ,GAAG,EAG7D,OAAOG,CACX,CAUO,SAASE,EACZL,EACAM,EACAL,EACI,CACJ,IAAME,EAAKJ,EAAuBC,EAAUC,CAAM,EAElD,GACIE,aAAc,kBACXA,aAAc,mBACdA,aAAc,qBACdA,aAAc,kBACnB,CACEA,EAAG,kBAAkBG,CAAO,EAC5BH,EAAG,eAAe,EAClB,MACJ,CAEA,GACKA,EAAG,YAAoB,iBAAmB,IACxC,sBAAuBA,EAC5B,CACGA,EAAW,kBAAkBG,CAAO,EACpCH,EAAW,eAAe,EAC3B,MACJ,CAEA,MAAM,IAAI,MACN,qBAAqBH,CAAQ,uBACjC,CACJ,CC5BO,SAASO,EACZC,EACAC,EACQ,CACR,IAAIC,EAAUF,EAAK,cAEnB,KAAOE,GAAS,CACZ,GAAIA,aAAmBD,EACnB,OAAOC,EAEXA,EAAUA,EAAQ,aACtB,CAEA,OAAO,IACX",
   "names": ["index_exports", "__export", "formError", "getParentComponent", "selectOne", "__toCommonJS", "selectOne", "selector", "parent", "root", "el", "name", "formError", "message", "getParentComponent", "node", "constructor", "current"]
 }

package/dist/forms/FormValidator.d.ts

@@ -47,8 +47,8 @@ export interface ValidatorOptions {
 export declare class FormValidator {
     private form;
     private options?;
-    private errorSummary;
-    constructor(form: HTMLFormElement, options?: ValidatorOptions);
+    private errorSummary?;
+    constructor(form: HTMLFormElement, options?: ValidatorOptions | undefined);
     /**
      * Validates all form fields.
      * Uses native HTML5 validation and optionally displays an error summary.

package/dist/forms/ValidationRules.d.ts

@@ -38,9 +38,7 @@ interface Validator {
 }
 /** @internal */
 interface ValidatorRegistryEntry {
-    validator: {
-        new (): Validator;
-    };
+    validator: new (...args: any[]) => Validator;
     validInputTypes: string[];
 }
 /**
@@ -59,9 +57,7 @@ interface ValidatorRegistryEntry {
  *     }
  * }
  */
-export declare function RegisterValidator(validationName: string, validInputTypes?: string[]): (target: {
-    new (...args: unknown[]): Validator;
-}) => void;
+export declare function RegisterValidator(validationName: string, validInputTypes?: string[]): (target: new (...args: any[]) => Validator) => void;
 /**
  * Looks up a registered validator by name.
  *