@ecopages/radiant 0.1.8 → 0.2.0

package/dist/context/events.js

@@ -1,54 +1,4 @@
-// src/context/events.ts
-var ContextEventsTypes;
-((ContextEventsTypes2) => {
-  ContextEventsTypes2["SUBSCRIPTION_REQUEST"] = "context--subscription-request";
-  ContextEventsTypes2["CONTEXT_REQUEST"] = "context-request";
-  ContextEventsTypes2["ON_MOUNT"] = "context--on-mount";
-})(ContextEventsTypes ||= {});
+var z;((j)=>{j.SUBSCRIPTION_REQUEST="context-subscription-request";j.CONTEXT_REQUEST="context-request";j.ON_MOUNT="context-on-mount";j.MOUNTED="context-mounted"})(z||={});class B extends Event{k;q;w;constructor(k,q,w){super("context-request",{bubbles:!0,composed:!0});this.context=k;this.callback=q;this.subscribe=w}}class D extends CustomEvent{constructor(k){super("context-on-mount",{detail:{context:k},bubbles:!0,composed:!0})}}class F extends Event{k;q;w;G;constructor(k,q,w,G){super("context-subscription-request",{bubbles:!0,composed:!0});this.context=k;this.callback=q;this.select=w;this.subscribe=G}}export{F as ContextSubscriptionRequestEvent,B as ContextRequestEvent,D as ContextOnMountEvent,z as ContextEventsTypes};
+export{B as p,D as q,F as r};
 
-class ContextRequestEvent extends Event {
-  context;
-  callback;
-  subscribe;
-  constructor(context, callback, subscribe) {
-    super("context-request" /* CONTEXT_REQUEST */, { bubbles: true, composed: true });
-    this.context = context;
-    this.callback = callback;
-    this.subscribe = subscribe;
-  }
-}
-
-class ContextOnMountEvent extends CustomEvent {
-  constructor(context) {
-    super("context--on-mount" /* ON_MOUNT */, {
-      detail: { context },
-      bubbles: true,
-      composed: true
-    });
-  }
-}
-
-class ContextSubscriptionRequestEvent extends Event {
-  context;
-  callback;
-  select;
-  subscribe;
-  constructor(context, callback, select, subscribe) {
-    super("context--subscription-request" /* SUBSCRIPTION_REQUEST */, {
-      bubbles: true,
-      composed: true
-    });
-    this.context = context;
-    this.callback = callback;
-    this.select = select;
-    this.subscribe = subscribe;
-  }
-}
-export {
-  ContextSubscriptionRequestEvent,
-  ContextRequestEvent,
-  ContextOnMountEvent,
-  ContextEventsTypes
-};
-
-//# debugId=85CDB913AD2268D764756E2164756E21
+//# debugId=CD57E830D3B70B5964756E2164756E21

package/dist/context/events.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/context/events.ts"],
   "sourcesContent": [
-    "import type { Context, ContextCallback, ContextType, UnknownContext } from './types';\n\n/**\n * List of events which can be emitted by a context provider or requester.\n */\nexport enum ContextEventsTypes {\n  SUBSCRIPTION_REQUEST = 'context--subscription-request',\n  CONTEXT_REQUEST = 'context-request',\n  ON_MOUNT = 'context--on-mount',\n}\n\n/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can\n * satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `subscribe` value, then a provider can call the callback\n * multiple times if the value is changed, if this is the case the provider should pass an `unsubscribe`\n * function to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n */\nexport class ContextRequestEvent<T extends UnknownContext> extends Event {\n  public constructor(\n    public readonly context: T,\n    public readonly callback: ContextCallback<ContextType<T>>,\n    public readonly subscribe?: boolean,\n  ) {\n    super(ContextEventsTypes.CONTEXT_REQUEST, { bubbles: true, composed: true });\n  }\n}\n\n/**\n * A type which represents a subscription to a context value.\n */\nexport type ContextSubscription<T extends UnknownContext> = {\n  select?: (context: ContextType<T>) => unknown;\n  callback: (value: unknown) => void;\n};\n\n/**\n * An event fired by a context provider to signal that a context value has been mounted and is available for consumption.\n */\nexport class ContextOnMountEvent extends CustomEvent<{ context: UnknownContext }> {\n  public constructor(context: UnknownContext) {\n    super(ContextEventsTypes.ON_MOUNT, {\n      detail: { context },\n      bubbles: true,\n      composed: true,\n    });\n  }\n}\n\n/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can\n * satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `subscribe` value, then a provider can call the callback\n * multiple times if the value is changed, if this is the case the provider should pass an `unsubscribe`\n * function to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n *\n * It accepts a `selector` property which can be used to request a specific property of the context value.\n */\nexport class ContextSubscriptionRequestEvent<T extends UnknownContext> extends Event {\n  public constructor(\n    public readonly context: T,\n    public readonly callback: (value: ContextType<T> | { [K in keyof ContextType<T>]: ContextType<T>[K] }) => void,\n    public readonly select?: (context: ContextType<T>) => unknown,\n    public readonly subscribe?: boolean,\n  ) {\n    super(ContextEventsTypes.SUBSCRIPTION_REQUEST, {\n      bubbles: true,\n      composed: true,\n    });\n  }\n}\n\ndeclare global {\n  interface HTMLElementEventMap {\n    /**\n     * A 'context-request-subscription' event can be emitted by any element which desires\n     * a context value to be injected by an external provider.\n     */\n    [ContextEventsTypes.SUBSCRIPTION_REQUEST]: ContextSubscriptionRequestEvent<UnknownContext>;\n    /**\n     * A context-request-provider event can be emitted by a context requester to signal\n     * that it desires a context value to be provided by a context provider.\n     */\n    [ContextEventsTypes.CONTEXT_REQUEST]: ContextRequestEvent<Context<unknown, unknown>>;\n    /**\n     * A 'context-mount' event can be emitted by a context provider to signal\n     * that a context value has been mounted and is available for consumption.\n     */\n    [ContextEventsTypes.ON_MOUNT]: ContextOnMountEvent;\n  }\n}\n"
+    "import type { Context, ContextCallback, ContextType, UnknownContext } from './types';\n\n/**\n * List of events which can be emitted by a context provider or requester.\n */\nexport enum ContextEventsTypes {\n  SUBSCRIPTION_REQUEST = 'context-subscription-request',\n  CONTEXT_REQUEST = 'context-request',\n  ON_MOUNT = 'context-on-mount',\n  MOUNTED = 'context-mounted',\n}\n\n/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can\n * satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `subscribe` value, then a provider can call the callback\n * multiple times if the value is changed, if this is the case the provider should pass an `unsubscribe`\n * function to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n */\nexport class ContextRequestEvent<T extends UnknownContext> extends Event {\n  public constructor(\n    public readonly context: T,\n    public readonly callback: ContextCallback<ContextType<T>>,\n    public readonly subscribe?: boolean,\n  ) {\n    super(ContextEventsTypes.CONTEXT_REQUEST, { bubbles: true, composed: true });\n  }\n}\n\n/**\n * A type which represents a subscription to a context value.\n */\nexport type ContextSubscription<T extends UnknownContext> = {\n  select?: (context: ContextType<T>) => unknown;\n  callback: (value: unknown) => void;\n};\n\n/**\n * An event fired by a context provider to signal that a context value has been mounted and is available for consumption.\n */\nexport class ContextOnMountEvent extends CustomEvent<{ context: UnknownContext }> {\n  public constructor(context: UnknownContext) {\n    super(ContextEventsTypes.ON_MOUNT, {\n      detail: { context },\n      bubbles: true,\n      composed: true,\n    });\n  }\n}\n\n/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can\n * satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `subscribe` value, then a provider can call the callback\n * multiple times if the value is changed, if this is the case the provider should pass an `unsubscribe`\n * function to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n *\n * It accepts a `selector` property which can be used to request a specific property of the context value.\n */\nexport class ContextSubscriptionRequestEvent<T extends UnknownContext> extends Event {\n  public constructor(\n    public readonly context: T,\n    public readonly callback: (value: ContextType<T> | { [K in keyof ContextType<T>]: ContextType<T>[K] }) => void,\n    public readonly select?: (context: ContextType<T>) => unknown,\n    public readonly subscribe?: boolean,\n  ) {\n    super(ContextEventsTypes.SUBSCRIPTION_REQUEST, {\n      bubbles: true,\n      composed: true,\n    });\n  }\n}\n\ndeclare global {\n  interface HTMLElementEventMap {\n    /**\n     * A 'context-request-subscription' event can be emitted by any element which desires\n     * a context value to be injected by an external provider.\n     */\n    [ContextEventsTypes.SUBSCRIPTION_REQUEST]: ContextSubscriptionRequestEvent<UnknownContext>;\n    /**\n     * A context-request-provider event can be emitted by a context requester to signal\n     * that it desires a context value to be provided by a context provider.\n     */\n    [ContextEventsTypes.CONTEXT_REQUEST]: ContextRequestEvent<Context<unknown, unknown>>;\n    /**\n     * A 'context-mount' event can be emitted by a context provider to signal\n     * that a context value has been mounted and is available for consumption.\n     */\n    [ContextEventsTypes.ON_MOUNT]: ContextOnMountEvent;\n  }\n}\n"
   ],
-  "mappings": ";AAKO,IAAK;AAAL,EAAK,wBAAL;AACL,gDAAuB;AACvB,2CAAkB;AAClB,oCAAW;AAAA,GAHD;AAgBL;AAAA,MAAM,4BAAsD,MAAM;AAAA,EAErD;AAAA,EACA;AAAA,EACA;AAAA,EAHX,WAAW,CACA,SACA,UACA,WAChB;AACA,UAAM,yCAAoC,EAAE,SAAS,MAAM,UAAU,KAAK,CAAC;AAJ3D;AACA;AACA;AAAA;AAIpB;AAaO;AAAA,MAAM,4BAA4B,YAAyC;AAAA,EACzE,WAAW,CAAC,SAAyB;AAC1C,UAAM,oCAA6B;AAAA,MACjC,QAAQ,EAAE,QAAQ;AAAA,MAClB,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC;AAAA;AAEL;AAcO;AAAA,MAAM,wCAAkE,MAAM;AAAA,EAEjE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAJX,WAAW,CACA,SACA,UACA,QACA,WAChB;AACA,UAAM,4DAAyC;AAAA,MAC7C,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC;AARe;AACA;AACA;AACA;AAAA;AAOpB;",
-  "debugId": "85CDB913AD2268D764756E2164756E21",
+  "mappings": "AAKO,IAAK,EAAL,EAAK,IAAL,CACL,uBAAuB,+BACvB,kBAAkB,kBAClB,WAAW,mBACX,UAAU,oBAJA,QAiBL,MAAM,UAAsD,KAAM,CAErD,EACA,EACA,EAHX,WAAW,CACA,EACA,EACA,EAChB,CACA,MAAM,kBAAoC,CAAE,QAAS,GAAM,SAAU,EAAK,CAAC,EAJ3D,eACA,gBACA,iBAIpB,CAaO,MAAM,UAA4B,WAAyC,CACzE,WAAW,CAAC,EAAyB,CAC1C,MAAM,mBAA6B,CACjC,OAAQ,CAAE,SAAQ,EAClB,QAAS,GACT,SAAU,EACZ,CAAC,EAEL,CAcO,MAAM,UAAkE,KAAM,CAEjE,EACA,EACA,EACA,EAJX,WAAW,CACA,EACA,EACA,EACA,EAChB,CACA,MAAM,+BAAyC,CAC7C,QAAS,GACT,SAAU,EACZ,CAAC,EARe,eACA,gBACA,cACA,iBAOpB",
+  "debugId": "CD57E830D3B70B5964756E2164756E21",
   "names": []
 }

package/dist/core/radiant-element.d.ts

@@ -1,5 +1,6 @@
+import type { EventEmitter } from '../tools';
 import type { UnknownContext } from '../context/types';
-import type { AttributeTypeConstant, ReadAttributeValueReturnType, WriteAttributeValueReturnType } from '../utils';
+import { type AttributeTypeConstant, type ReadAttributeValueReturnType, type WriteAttributeValueReturnType } from '../utils/attribute-utils';
 /**
  * Possible positions to insert a rendered template.
  */
@@ -11,21 +12,36 @@ export type RadiantElementEventListener = {
     selector: string;
     type: string;
     listener: EventListener;
-    id: string;
     options?: AddEventListenerOptions;
 };
 /**
  * Represents a property metadata object.
  */
-export interface PropertyConfig {
+export interface ReactiveProperty<T = unknown> {
     type: AttributeTypeConstant;
-    propertyName: string;
-    attributeKey: string;
+    value?: T;
+    initialValue?: T;
+    name: string;
+    attribute: string;
     converter: {
         fromAttribute: (value: string) => ReadAttributeValueReturnType;
         toAttribute: (value: any) => WriteAttributeValueReturnType;
     };
 }
+/**
+ * Represents the options for a reactive property.
+ */
+export type ReactivePropertyOptions<T> = {
+    type: AttributeTypeConstant;
+    reflect?: boolean;
+    attribute?: string;
+    defaultValue?: T;
+};
+export type ReactiveField<T = unknown> = {
+    name: string;
+    value: T;
+    initialValue: T;
+};
 /**
  * Represents an interface for a Radiant element.
  */
@@ -36,7 +52,7 @@ export interface IRadiantElement {
      * @param oldValue - The old value of the property.
      * @param newValue - The new value of the property.
      */
-    updated(changedProperty: string, oldValue: unknown, newValue: unknown): void;
+    notifyUpdate(changedProperty: string, oldValue: unknown, newValue: unknown): void;
     /**
      * Subscribes to a Radiant element event.
      * @param event - The event listener to subscribe to.
@@ -48,14 +64,9 @@ export interface IRadiantElement {
      */
     subscribeEvents(events: RadiantElementEventListener[]): void;
     /**
-     * Unsubscribes from a Radiant element event.
-     * @param id - The ID of the event listener to unsubscribe from.
-     */
-    unsubscribeEvent(id: string): void;
-    /**
-     * Removes all subscribed events from the Radiant element.
+     * It adds a callback to be executed when the Radiant element is disconnected from the DOM.
      */
-    removeAllSubscribedEvents(): void;
+    registerCleanupCallback(callback: () => void): void;
     /**
      * Renders a template into the specified target element.
      * @param options - The rendering options.
@@ -73,6 +84,13 @@ export interface IRadiantElement {
      * @param context - The connected context.
      */
     connectedContextCallback(context: UnknownContext): void;
+    /**
+     * Gets a reference to a child element by its data-ref attribute.
+     * @param ref - The data-ref attribute value of the element to get.
+     * @param all - Whether to get all elements with the specified data-ref attribute value.
+     * @returns The element with the specified data-ref attribute value, an array of elements or null if no element was found.
+     */
+    getRef<T extends Element = Element>(ref: string, all: boolean): T | T[];
 }
 /**
  * A base class for creating custom elements with reactive properties and event subscriptions.
@@ -80,22 +98,56 @@ export interface IRadiantElement {
  * @implements IRadiantElement
  */
 export declare class RadiantElement extends HTMLElement implements IRadiantElement {
-    propertyConfigMap: Map<string, PropertyConfig>;
-    updatesRegistry: Map<string, Set<string>>;
+    /**
+     * A map of property metadata objects, it contains useful information about the properties configured via decorators.
+     */
+    private reactiveProperties;
+    /**
+     * A map of reactive fields, it contains the reactive fields configured via decorators.
+     */
+    private reactiveFields;
+    /**
+     * A map of property update callbacks. These callbacks are called when a property is updated.
+     */
+    private updateCallbacks;
+    /**
+     * A map of event subscriptions used to manage event listeners on the Radiant element.
+     */
     private eventSubscriptions;
+    /**
+     * A map for event emitters
+     */
+    private eventEmitters;
+    /**
+     * An array of cleanup callbacks to be executed when the Radiant element is disconnected from the DOM.
+     */
+    private onDisconnectedCallback;
+    /**
+     * A flag indicating whether the element has been connected to the DOM.
+     */
     private elementReady;
     connectedCallback(): void;
     connectedContextCallback(_contextName: UnknownContext): void;
     disconnectedCallback(): void;
-    updated(changedProperty: string, oldValue: unknown, value: unknown): void;
+    notifyUpdate(changedProperty: string, oldValue: unknown, value: unknown): void;
+    private transformAttributeValue;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     renderTemplate({ target, template, insert, }: {
         target: HTMLElement;
         template: string;
         insert?: RenderInsertPosition;
     }): void;
-    subscribeEvents(events: RadiantElementEventListener[]): void;
-    subscribeEvent(eventConfig: RadiantElementEventListener): void;
-    unsubscribeEvent(id: string): void;
-    removeAllSubscribedEvents(): void;
+    registerReactiveProperty(config: ReactiveProperty): void;
+    registerReactiveField<T>(config: ReactiveField<T>): void;
+    registerUpdateCallback(property: string, update: (...rest: any[]) => any): void;
+    subscribeEvents(events: RadiantElementEventListener[]): Array<() => void>;
+    subscribeEvent(eventConfig: RadiantElementEventListener): () => void;
+    private unsubscribeEvent;
+    private removeAllSubscribedEvents;
+    registerCleanupCallback(callback: () => void): void;
+    registerEventEmitter(name: string, emitter: EventEmitter): void;
+    getRef<T extends Element = Element>(ref: string, all: true): T[];
+    getRef<T extends Element = Element>(ref: string, all?: false): T;
+    createReactiveField<T>(propertyName: string, initialValue: T): void;
+    createReactiveProp<T = unknown>(propertyName: string, options: ReactivePropertyOptions<T>): void;
 }

package/dist/core/radiant-element.js

@@ -1,83 +1,4 @@
-// src/core/radiant-element.ts
-class RadiantElement extends HTMLElement {
-  eventSubscriptions = new Map;
-  elementReady = false;
-  connectedCallback() {
-    this.elementReady = true;
-  }
-  connectedContextCallback(_contextName) {
-  }
-  disconnectedCallback() {
-    this.removeAllSubscribedEvents();
-  }
-  updated(changedProperty, oldValue, value) {
-    if (!this.elementReady || !this.updatesRegistry || oldValue === value)
-      return;
-    const updates = this.updatesRegistry.get(changedProperty);
-    if (updates) {
-      for (const update of updates) {
-        this[update]();
-      }
-    }
-  }
-  attributeChangedCallback(name, oldValue, newValue) {
-    if (oldValue === newValue || !this.elementReady)
-      return;
-    if (name in this) {
-      const config = this.propertyConfigMap.get(name);
-      const transformedValue = newValue ? config?.converter.fromAttribute(newValue) : newValue;
-      const transformedOldValue = oldValue ? config?.converter.fromAttribute(oldValue) : oldValue;
-      this[name] = transformedValue;
-      this.updated(name, transformedOldValue, transformedValue);
-    }
-  }
-  renderTemplate({
-    target = this,
-    template,
-    insert = "replace"
-  }) {
-    switch (insert) {
-      case "replace":
-        target.innerHTML = template;
-        break;
-      case "beforeend":
-        target.insertAdjacentHTML("beforeend", template);
-        break;
-      case "afterbegin":
-        target.insertAdjacentHTML("afterbegin", template);
-        break;
-    }
-  }
-  subscribeEvents(events) {
-    for (const event of events) {
-      this.subscribeEvent(event);
-    }
-  }
-  subscribeEvent(eventConfig) {
-    const delegatedListener = (delegatedEvent) => {
-      if (delegatedEvent.target && delegatedEvent.target.matches(eventConfig.selector)) {
-        eventConfig.listener.call(this, delegatedEvent);
-      }
-    };
-    this.addEventListener(eventConfig.type, delegatedListener, eventConfig.options);
-    this.eventSubscriptions.set(eventConfig.id, { ...eventConfig, listener: delegatedListener });
-  }
-  unsubscribeEvent(id) {
-    const eventSubscription = this.eventSubscriptions.get(id);
-    if (eventSubscription) {
-      this.removeEventListener(eventSubscription.type, eventSubscription.listener, eventSubscription.options);
-      this.eventSubscriptions.delete(id);
-    }
-  }
-  removeAllSubscribedEvents() {
-    for (const eventSubscription of this.eventSubscriptions.values()) {
-      this.removeEventListener(eventSubscription.type, eventSubscription.listener, eventSubscription.options);
-    }
-    this.eventSubscriptions.clear();
-  }
-}
-export {
-  RadiantElement
-};
+import{J as Z,K as _,L as $,M as D}from"../utils/attribute-utils.js";class T extends HTMLElement{reactiveProperties=new Map;reactiveFields=new Map;updateCallbacks=new Map;eventSubscriptions=new Map;eventEmitters=new Map;onDisconnectedCallback=[];elementReady=!1;connectedCallback(){this.elementReady=!0}connectedContextCallback(j){}disconnectedCallback(){this.removeAllSubscribedEvents();for(let j of this.onDisconnectedCallback)j()}notifyUpdate(j,x,B){if(!this.updateCallbacks||x===B)return;const z=this.updateCallbacks.get(j);if(z)for(let G of z)G()}transformAttributeValue(j,x){return j?x?.converter.fromAttribute(j):j}attributeChangedCallback(j,x,B){if(x===B||!this.elementReady)return;if(this.reactiveProperties.has(j)){const z=this.reactiveProperties.get(j),G=this.transformAttributeValue(B,z),J=this.transformAttributeValue(x,z),Q=z?z.attribute:j;this[Q]=G,this.notifyUpdate(j,J,G)}}renderTemplate({target:j=this,template:x,insert:B="replace"}){switch(B){case"replace":j.innerHTML=x;break;case"beforeend":j.insertAdjacentHTML("beforeend",x);break;case"afterbegin":j.insertAdjacentHTML("afterbegin",x);break}}registerReactiveProperty(j){this.reactiveProperties.set(j.name,j)}registerReactiveField(j){this.reactiveFields.set(j.name,j)}registerUpdateCallback(j,x){if(!this.updateCallbacks.has(j))this.updateCallbacks.set(j,new Set);this.updateCallbacks.get(j)?.add(x)}subscribeEvents(j){const x=[];for(let B of j)x.push(this.subscribeEvent(B));return x}subscribeEvent(j){const x=(z)=>{if(z.target&&z.target.matches(j.selector))j.listener.call(this,z)},B=`${j.type}:${j.selector}`;return this.addEventListener(j.type,x,j.options),this.eventSubscriptions.set(B,{...j,listener:x}),this.unsubscribeEvent.bind(this,B)}unsubscribeEvent(j){const x=this.eventSubscriptions.get(j);if(x)this.removeEventListener(x.type,x.listener,x.options),this.eventSubscriptions.delete(j)}removeAllSubscribedEvents(){for(let j of this.eventSubscriptions.values())this.removeEventListener(j.type,j.listener,j.options);this.eventSubscriptions.clear()}registerCleanupCallback(j){this.onDisconnectedCallback.push(j)}registerEventEmitter(j,x){this.eventEmitters.set(j,x)}getRef(j,x=!1){const B=`[data-ref="${j}"]`;let z;if(x){if(z=Array.from(this.querySelectorAll(B)),z.length===0)z=[]}else if(z=this.querySelector(B),!z)z=document.createDocumentFragment();return z}createReactiveField(j,x){const B={name:j,value:x,initialValue:x};this.registerReactiveField(B),Object.defineProperty(this,j,{get(){return this.reactiveFields.get(j)?.value??void 0},set(z){const G=this.reactiveFields.get(j)?.value;if(G!==z)this.reactiveFields.set(j,{...B,value:z}),this.notifyUpdate(j,G,z)},enumerable:!0,configurable:!0}),this.notifyUpdate(j,void 0,x)}createReactiveProp(j,x){const{type:B,attribute:z,reflect:G,defaultValue:J}=x,Q=z??j;if(J!==void 0&&!$(B,J))throw new Error(`defaultValue does not match the expected type for ${B.name}`);const U=D(this,B,Q,J),X={type:B,name:j,value:U,initialValue:U,attribute:Q,converter:{fromAttribute:(H)=>Z(H,B),toAttribute:(H)=>_(H,B)}};this.registerReactiveProperty(X);const Y=(H)=>{if(G){const W=X.converter.toAttribute(H);this.setAttribute(Q,W)}};if(Object.defineProperty(this,j,{get:function(){return this.reactiveProperties.get(j)?.value??void 0},set:function(H){const W=this.reactiveProperties.get(j)?.value;if(W!==H)this.reactiveProperties.set(j,{...X,value:H}),Y(H),this.notifyUpdate(j,W,H)},enumerable:!0,configurable:!0}),U!==void 0)Y(U),queueMicrotask(()=>{this.notifyUpdate(j,void 0,U)})}}export{T as RadiantElement};
+export{T as s};
 
-//# debugId=494A682B938300F764756E2164756E21
+//# debugId=02C394B602FFC5B564756E2164756E21

package/dist/core/radiant-element.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/core/radiant-element.ts"],
   "sourcesContent": [
-    "import type { UnknownContext } from '@/context/types';\nimport type { AttributeTypeConstant, ReadAttributeValueReturnType, WriteAttributeValueReturnType } from '@/utils';\n\n/**\n * Possible positions to insert a rendered template.\n */\nexport type RenderInsertPosition = 'replace' | 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend';\n\n/**\n * Represents a Radiant element event listener.\n */\nexport type RadiantElementEventListener = {\n  selector: string;\n  type: string;\n  listener: EventListener;\n  id: string;\n  options?: AddEventListenerOptions;\n};\n\n/**\n * Represents a property metadata object.\n */\nexport interface PropertyConfig {\n  type: AttributeTypeConstant;\n  propertyName: string;\n  attributeKey: string;\n  converter: {\n    fromAttribute: (value: string) => ReadAttributeValueReturnType;\n    toAttribute: (value: any) => WriteAttributeValueReturnType;\n  };\n}\n\n/**\n * Represents an interface for a Radiant element.\n */\nexport interface IRadiantElement {\n  /**\n   * Called when a property of the element is updated.\n   * @param changedProperty - The name of the changed property.\n   * @param oldValue - The old value of the property.\n   * @param newValue - The new value of the property.\n   */\n  updated(changedProperty: string, oldValue: unknown, newValue: unknown): void;\n\n  /**\n   * Subscribes to a Radiant element event.\n   * @param event - The event listener to subscribe to.\n   */\n  subscribeEvent(event: RadiantElementEventListener): void;\n\n  /**\n   * Subscribes to multiple Radiant element events.\n   * @param events - The array of event listeners to subscribe to.\n   */\n  subscribeEvents(events: RadiantElementEventListener[]): void;\n\n  /**\n   * Unsubscribes from a Radiant element event.\n   * @param id - The ID of the event listener to unsubscribe from.\n   */\n  unsubscribeEvent(id: string): void;\n\n  /**\n   * Removes all subscribed events from the Radiant element.\n   */\n  removeAllSubscribedEvents(): void;\n\n  /**\n   * Renders a template into the specified target element.\n   * @param options - The rendering options.\n   * @param options.target - The target element to render the template into.\n   * @param options.template - The template string to render.\n   * @param options.insert - The position to insert the rendered template. (optional)\n   */\n  renderTemplate(options: {\n    target: HTMLElement;\n    template: string;\n    insert?: RenderInsertPosition;\n  }): void;\n\n  /**\n   * Called when the Radiant element is connected to a context.\n   * @param context - The connected context.\n   */\n  connectedContextCallback(context: UnknownContext): void;\n}\n\n/**\n * A base class for creating custom elements with reactive properties and event subscriptions.\n * @extends HTMLElement\n * @implements IRadiantElement\n */\nexport class RadiantElement extends HTMLElement implements IRadiantElement {\n  declare propertyConfigMap: Map<string, PropertyConfig>;\n  declare updatesRegistry: Map<string, Set<string>>;\n  private eventSubscriptions = new Map<string, RadiantElementEventListener>();\n  private elementReady = false;\n\n  connectedCallback() {\n    this.elementReady = true;\n  }\n\n  connectedContextCallback(_contextName: UnknownContext): void {}\n\n  disconnectedCallback() {\n    this.removeAllSubscribedEvents();\n  }\n\n  updated(changedProperty: string, oldValue: unknown, value: unknown) {\n    if (!this.elementReady || !this.updatesRegistry || oldValue === value) return;\n    const updates = this.updatesRegistry.get(changedProperty);\n    if (updates) {\n      for (const update of updates) {\n        (this as any)[update]();\n      }\n    }\n  }\n\n  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null) {\n    if (oldValue === newValue || !this.elementReady) return;\n\n    if (name in this) {\n      const config = this.propertyConfigMap.get(name);\n      const transformedValue = newValue ? config?.converter.fromAttribute(newValue) : newValue;\n      const transformedOldValue = oldValue ? config?.converter.fromAttribute(oldValue) : oldValue;\n      (this as RadiantElement & { [key: string]: any })[name] = transformedValue;\n      this.updated(name, transformedOldValue, transformedValue);\n    }\n  }\n\n  renderTemplate({\n    target = this,\n    template,\n    insert = 'replace',\n  }: {\n    target: HTMLElement;\n    template: string;\n    insert?: RenderInsertPosition;\n  }) {\n    switch (insert) {\n      case 'replace':\n        target.innerHTML = template;\n        break;\n      case 'beforeend':\n        target.insertAdjacentHTML('beforeend', template);\n        break;\n      case 'afterbegin':\n        target.insertAdjacentHTML('afterbegin', template);\n        break;\n    }\n  }\n\n  public subscribeEvents(events: RadiantElementEventListener[]): void {\n    for (const event of events) {\n      this.subscribeEvent(event);\n    }\n  }\n\n  public subscribeEvent(eventConfig: RadiantElementEventListener): void {\n    const delegatedListener = (delegatedEvent: Event) => {\n      if (delegatedEvent.target && (delegatedEvent.target as Element).matches(eventConfig.selector)) {\n        eventConfig.listener.call(this, delegatedEvent);\n      }\n    };\n\n    this.addEventListener(eventConfig.type, delegatedListener, eventConfig.options);\n    this.eventSubscriptions.set(eventConfig.id, { ...eventConfig, listener: delegatedListener });\n  }\n\n  public unsubscribeEvent(id: string): void {\n    const eventSubscription = this.eventSubscriptions.get(id);\n    if (eventSubscription) {\n      this.removeEventListener(eventSubscription.type, eventSubscription.listener, eventSubscription.options);\n      this.eventSubscriptions.delete(id);\n    }\n  }\n\n  public removeAllSubscribedEvents(): void {\n    for (const eventSubscription of this.eventSubscriptions.values()) {\n      this.removeEventListener(eventSubscription.type, eventSubscription.listener, eventSubscription.options);\n    }\n    this.eventSubscriptions.clear();\n  }\n}\n"
+    "import type { EventEmitter } from '@/tools';\nimport type { UnknownContext } from '../context/types';\nimport {\n  type AttributeTypeConstant,\n  type ReadAttributeValueReturnType,\n  type WriteAttributeValueReturnType,\n  getInitialValue,\n  isValueOfType,\n  readAttributeValue,\n  writeAttributeValue,\n} from '../utils/attribute-utils';\n\n/**\n * Possible positions to insert a rendered template.\n */\nexport type RenderInsertPosition = 'replace' | 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend';\n\n/**\n * Represents a Radiant element event listener.\n */\nexport type RadiantElementEventListener = {\n  selector: string;\n  type: string;\n  listener: EventListener;\n  options?: AddEventListenerOptions;\n};\n\n/**\n * Represents a property metadata object.\n */\nexport interface ReactiveProperty<T = unknown> {\n  type: AttributeTypeConstant;\n  value?: T;\n  initialValue?: T;\n  name: string;\n  attribute: string;\n  converter: {\n    fromAttribute: (value: string) => ReadAttributeValueReturnType;\n    toAttribute: (value: any) => WriteAttributeValueReturnType;\n  };\n}\n\n/**\n * Represents the options for a reactive property.\n */\nexport type ReactivePropertyOptions<T> = {\n  type: AttributeTypeConstant;\n  reflect?: boolean;\n  attribute?: string;\n  defaultValue?: T;\n};\n\nexport type ReactiveField<T = unknown> = {\n  name: string;\n  value: T;\n  initialValue: T;\n};\n\n/**\n * Represents an interface for a Radiant element.\n */\nexport interface IRadiantElement {\n  /**\n   * Called when a property of the element is updated.\n   * @param changedProperty - The name of the changed property.\n   * @param oldValue - The old value of the property.\n   * @param newValue - The new value of the property.\n   */\n  notifyUpdate(changedProperty: string, oldValue: unknown, newValue: unknown): void;\n\n  /**\n   * Subscribes to a Radiant element event.\n   * @param event - The event listener to subscribe to.\n   */\n  subscribeEvent(event: RadiantElementEventListener): void;\n\n  /**\n   * Subscribes to multiple Radiant element events.\n   * @param events - The array of event listeners to subscribe to.\n   */\n  subscribeEvents(events: RadiantElementEventListener[]): void;\n\n  /**\n   * It adds a callback to be executed when the Radiant element is disconnected from the DOM.\n   */\n  registerCleanupCallback(callback: () => void): void;\n\n  /**\n   * Renders a template into the specified target element.\n   * @param options - The rendering options.\n   * @param options.target - The target element to render the template into.\n   * @param options.template - The template string to render.\n   * @param options.insert - The position to insert the rendered template. (optional)\n   */\n  renderTemplate(options: {\n    target: HTMLElement;\n    template: string;\n    insert?: RenderInsertPosition;\n  }): void;\n\n  /**\n   * Called when the Radiant element is connected to a context.\n   * @param context - The connected context.\n   */\n  connectedContextCallback(context: UnknownContext): void;\n\n  /**\n   * Gets a reference to a child element by its data-ref attribute.\n   * @param ref - The data-ref attribute value of the element to get.\n   * @param all - Whether to get all elements with the specified data-ref attribute value.\n   * @returns The element with the specified data-ref attribute value, an array of elements or null if no element was found.\n   */\n  getRef<T extends Element = Element>(ref: string, all: boolean): T | T[];\n}\n\n/**\n * A base class for creating custom elements with reactive properties and event subscriptions.\n * @extends HTMLElement\n * @implements IRadiantElement\n */\nexport class RadiantElement extends HTMLElement implements IRadiantElement {\n  /**\n   * A map of property metadata objects, it contains useful information about the properties configured via decorators.\n   */\n  private reactiveProperties = new Map<string, ReactiveProperty>();\n\n  /**\n   * A map of reactive fields, it contains the reactive fields configured via decorators.\n   */\n  private reactiveFields = new Map<string, ReactiveField>();\n\n  /**\n   * A map of property update callbacks. These callbacks are called when a property is updated.\n   */\n  private updateCallbacks = new Map<string, Set<(...rest: any[]) => any>>();\n\n  /**\n   * A map of event subscriptions used to manage event listeners on the Radiant element.\n   */\n  private eventSubscriptions = new Map<string, RadiantElementEventListener>();\n\n  /**\n   * A map for event emitters\n   */\n  private eventEmitters = new Map<string, EventEmitter>();\n\n  /**\n   * An array of cleanup callbacks to be executed when the Radiant element is disconnected from the DOM.\n   */\n  private onDisconnectedCallback: (() => void)[] = [];\n\n  /**\n   * A flag indicating whether the element has been connected to the DOM.\n   */\n  private elementReady = false;\n\n  connectedCallback() {\n    this.elementReady = true;\n  }\n\n  connectedContextCallback(_contextName: UnknownContext): void {}\n\n  disconnectedCallback() {\n    this.removeAllSubscribedEvents();\n    for (const cleanup of this.onDisconnectedCallback) {\n      cleanup();\n    }\n  }\n\n  public notifyUpdate(changedProperty: string, oldValue: unknown, value: unknown) {\n    if (!this.updateCallbacks || oldValue === value) return;\n    const updates = this.updateCallbacks.get(changedProperty);\n\n    if (updates) {\n      for (const update of updates) {\n        update();\n      }\n    }\n  }\n\n  private transformAttributeValue(value: string | null, config: any): unknown {\n    return value ? config?.converter.fromAttribute(value) : value;\n  }\n\n  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null) {\n    if (oldValue === newValue || !this.elementReady) return;\n\n    if (this.reactiveProperties.has(name)) {\n      const config = this.reactiveProperties.get(name);\n\n      const transformedValue = this.transformAttributeValue(newValue, config);\n      const transformedOldValue = this.transformAttributeValue(oldValue, config);\n\n      const key = config ? config.attribute : name;\n      (this as any)[key] = transformedValue;\n      this.notifyUpdate(name, transformedOldValue, transformedValue);\n    }\n  }\n\n  public renderTemplate({\n    target = this,\n    template,\n    insert = 'replace',\n  }: {\n    target: HTMLElement;\n    template: string;\n    insert?: RenderInsertPosition;\n  }) {\n    switch (insert) {\n      case 'replace':\n        target.innerHTML = template;\n        break;\n      case 'beforeend':\n        target.insertAdjacentHTML('beforeend', template);\n        break;\n      case 'afterbegin':\n        target.insertAdjacentHTML('afterbegin', template);\n        break;\n    }\n  }\n\n  public registerReactiveProperty(config: ReactiveProperty) {\n    this.reactiveProperties.set(config.name, config);\n  }\n\n  public registerReactiveField<T>(config: ReactiveField<T>) {\n    this.reactiveFields.set(config.name, config);\n  }\n\n  public registerUpdateCallback(property: string, update: (...rest: any[]) => any) {\n    if (!this.updateCallbacks.has(property)) {\n      this.updateCallbacks.set(property, new Set());\n    }\n    this.updateCallbacks.get(property)?.add(update);\n  }\n\n  public subscribeEvents(events: RadiantElementEventListener[]): Array<() => void> {\n    const unsubscribers: Array<() => void> = [];\n    for (const event of events) {\n      unsubscribers.push(this.subscribeEvent(event));\n    }\n    return unsubscribers;\n  }\n\n  public subscribeEvent(eventConfig: RadiantElementEventListener): () => void {\n    const delegatedListener = (delegatedEvent: Event) => {\n      if (delegatedEvent.target && (delegatedEvent.target as Element).matches(eventConfig.selector)) {\n        eventConfig.listener.call(this, delegatedEvent);\n      }\n    };\n    const subscriptionId = `${eventConfig.type}:${eventConfig.selector}`;\n    this.addEventListener(eventConfig.type, delegatedListener, eventConfig.options);\n    this.eventSubscriptions.set(subscriptionId, {\n      ...eventConfig,\n      listener: delegatedListener,\n    });\n\n    return this.unsubscribeEvent.bind(this, subscriptionId);\n  }\n\n  private unsubscribeEvent(id: string): void {\n    const eventSubscription = this.eventSubscriptions.get(id);\n    if (eventSubscription) {\n      this.removeEventListener(eventSubscription.type, eventSubscription.listener, eventSubscription.options);\n      this.eventSubscriptions.delete(id);\n    }\n  }\n\n  private removeAllSubscribedEvents(): void {\n    for (const eventSubscription of this.eventSubscriptions.values()) {\n      this.removeEventListener(eventSubscription.type, eventSubscription.listener, eventSubscription.options);\n    }\n    this.eventSubscriptions.clear();\n  }\n\n  public registerCleanupCallback(callback: () => void): void {\n    this.onDisconnectedCallback.push(callback);\n  }\n\n  public registerEventEmitter(name: string, emitter: EventEmitter) {\n    this.eventEmitters.set(name, emitter);\n  }\n\n  public getRef<T extends Element = Element>(ref: string, all: true): T[];\n  public getRef<T extends Element = Element>(ref: string, all?: false): T;\n  public getRef<T extends Element = Element>(ref: string, all = false): T | T[] {\n    const selector = `[data-ref=\"${ref}\"]`;\n    let result: T | T[];\n    if (all) {\n      result = Array.from(this.querySelectorAll(selector)) as T[];\n      if (result.length === 0) result = [];\n    } else {\n      result = this.querySelector(selector) as T;\n      if (!result) {\n        const fragment = document.createDocumentFragment();\n        result = fragment as unknown as T;\n      }\n    }\n    return result;\n  }\n\n  public createReactiveField<T>(propertyName: string, initialValue: T): void {\n    const reactiveField: ReactiveField<T> = {\n      name: propertyName,\n      value: initialValue,\n      initialValue: initialValue,\n    };\n\n    this.registerReactiveField(reactiveField);\n\n    Object.defineProperty(this, propertyName, {\n      get(this: RadiantElement) {\n        return this.reactiveFields.get(propertyName)?.value ?? undefined;\n      },\n      set(this: RadiantElement, newValue: T) {\n        const oldValue = this.reactiveFields.get(propertyName)?.value;\n        if (oldValue !== newValue) {\n          this.reactiveFields.set(propertyName, { ...reactiveField, value: newValue });\n          this.notifyUpdate(propertyName, oldValue, newValue);\n        }\n      },\n      enumerable: true,\n      configurable: true,\n    });\n\n    this.notifyUpdate(propertyName, undefined, initialValue);\n  }\n\n  public createReactiveProp<T = unknown>(propertyName: string, options: ReactivePropertyOptions<T>): void {\n    const { type, attribute, reflect, defaultValue } = options;\n    const attributeKey = attribute ?? propertyName;\n\n    if (defaultValue !== undefined && !isValueOfType(type, defaultValue)) {\n      throw new Error(`defaultValue does not match the expected type for ${type.name}`);\n    }\n\n    const initialValue: T | undefined = getInitialValue(this, type, attributeKey, defaultValue) as T;\n\n    const propertyMapping: ReactiveProperty<T> = {\n      type,\n      name: propertyName,\n      value: initialValue,\n      initialValue,\n      attribute: attributeKey,\n      converter: {\n        fromAttribute: (value) => readAttributeValue(value, type),\n        toAttribute: (value) => writeAttributeValue(value, type),\n      },\n    };\n\n    this.registerReactiveProperty(propertyMapping);\n\n    const handleReflectRequest = (value: T) => {\n      if (reflect) {\n        const attributeValue = propertyMapping.converter.toAttribute(value);\n        this.setAttribute(attributeKey, attributeValue);\n      }\n    };\n\n    Object.defineProperty(this, propertyName, {\n      get: function (this: RadiantElement) {\n        return this.reactiveProperties.get(propertyName)?.value ?? undefined;\n      },\n      set: function (this: RadiantElement, newValue: T) {\n        const oldValue = this.reactiveProperties.get(propertyName)?.value;\n        if (oldValue !== newValue) {\n          this.reactiveProperties.set(propertyName, { ...propertyMapping, value: newValue });\n          handleReflectRequest(newValue);\n          this.notifyUpdate(propertyName, oldValue, newValue);\n        }\n      },\n      enumerable: true,\n      configurable: true,\n    });\n\n    if (initialValue !== undefined) {\n      handleReflectRequest(initialValue as T);\n      queueMicrotask(() => {\n        this.notifyUpdate(propertyName, undefined, initialValue);\n      });\n    }\n  }\n}\n"
   ],
-  "mappings": ";AA4FO,MAAM,uBAAuB,YAAuC;AAAA,EAGjE,qBAAqB,IAAI;AAAA,EACzB,eAAe;AAAA,EAEvB,iBAAiB,GAAG;AAClB,SAAK,eAAe;AAAA;AAAA,EAGtB,wBAAwB,CAAC,cAAoC;AAAA;AAAA,EAE7D,oBAAoB,GAAG;AACrB,SAAK,0BAA0B;AAAA;AAAA,EAGjC,OAAO,CAAC,iBAAyB,UAAmB,OAAgB;AAClE,SAAK,KAAK,iBAAiB,KAAK,mBAAmB,aAAa;AAAO;AACvE,UAAM,UAAU,KAAK,gBAAgB,IAAI,eAAe;AACxD,QAAI,SAAS;AACX,iBAAW,UAAU,SAAS;AAC5B,QAAC,KAAa,QAAQ;AAAA,MACxB;AAAA,IACF;AAAA;AAAA,EAGF,wBAAwB,CAAC,MAAc,UAAyB,UAAyB;AACvF,QAAI,aAAa,aAAa,KAAK;AAAc;AAEjD,QAAI,QAAQ,MAAM;AAChB,YAAM,SAAS,KAAK,kBAAkB,IAAI,IAAI;AAC9C,YAAM,mBAAmB,WAAW,QAAQ,UAAU,cAAc,QAAQ,IAAI;AAChF,YAAM,sBAAsB,WAAW,QAAQ,UAAU,cAAc,QAAQ,IAAI;AACnF,MAAC,KAAiD,QAAQ;AAC1D,WAAK,QAAQ,MAAM,qBAAqB,gBAAgB;AAAA,IAC1D;AAAA;AAAA,EAGF,cAAc;AAAA,IACZ,SAAS;AAAA,IACT;AAAA,IACA,SAAS;AAAA,KAKR;AACD,YAAQ;AAAA,WACD;AACH,eAAO,YAAY;AACnB;AAAA,WACG;AACH,eAAO,mBAAmB,aAAa,QAAQ;AAC/C;AAAA,WACG;AACH,eAAO,mBAAmB,cAAc,QAAQ;AAChD;AAAA;AAAA;AAAA,EAIC,eAAe,CAAC,QAA6C;AAClE,eAAW,SAAS,QAAQ;AAC1B,WAAK,eAAe,KAAK;AAAA,IAC3B;AAAA;AAAA,EAGK,cAAc,CAAC,aAAgD;AACpE,UAAM,oBAAoB,CAAC,mBAA0B;AACnD,UAAI,eAAe,UAAW,eAAe,OAAmB,QAAQ,YAAY,QAAQ,GAAG;AAC7F,oBAAY,SAAS,KAAK,MAAM,cAAc;AAAA,MAChD;AAAA;AAGF,SAAK,iBAAiB,YAAY,MAAM,mBAAmB,YAAY,OAAO;AAC9E,SAAK,mBAAmB,IAAI,YAAY,IAAI,KAAK,aAAa,UAAU,kBAAkB,CAAC;AAAA;AAAA,EAGtF,gBAAgB,CAAC,IAAkB;AACxC,UAAM,oBAAoB,KAAK,mBAAmB,IAAI,EAAE;AACxD,QAAI,mBAAmB;AACrB,WAAK,oBAAoB,kBAAkB,MAAM,kBAAkB,UAAU,kBAAkB,OAAO;AACtG,WAAK,mBAAmB,OAAO,EAAE;AAAA,IACnC;AAAA;AAAA,EAGK,yBAAyB,GAAS;AACvC,eAAW,qBAAqB,KAAK,mBAAmB,OAAO,GAAG;AAChE,WAAK,oBAAoB,kBAAkB,MAAM,kBAAkB,UAAU,kBAAkB,OAAO;AAAA,IACxG;AACA,SAAK,mBAAmB,MAAM;AAAA;AAElC;",
-  "debugId": "494A682B938300F764756E2164756E21",
+  "mappings": "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",
+  "debugId": "02C394B602FFC5B564756E2164756E21",
   "names": []
 }

package/dist/decorators/bound.d.ts

@@ -1,9 +1,5 @@
-import type { RadiantElement } from '../core/radiant-element';
+import type { StandardOrLegacyMethodDecoratorArgs } from '../types';
 /**
  * A decorator to bind a method to the instance.
- * @param target {@link RadiantElement}
- * @param propertyKey string
- * @param descriptor {@link PropertyDescriptor}
- * @returns
  */
-export declare function bound(target: RadiantElement, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor;
+export declare function bound(protoOrTarget: StandardOrLegacyMethodDecoratorArgs['protoOrTarget'], nameOrContext: StandardOrLegacyMethodDecoratorArgs['nameOrContext'], descriptor?: StandardOrLegacyMethodDecoratorArgs['descriptor']): any;

package/dist/decorators/bound.js

@@ -1,24 +1,3 @@
-// src/decorators/bound.ts
-function bound(target, propertyKey, descriptor) {
-  const originalMethod = descriptor.value;
-  return {
-    configurable: true,
-    get() {
-      if (this === target.prototype || Object.hasOwn(this, propertyKey)) {
-        return originalMethod;
-      }
-      const boundMethod = originalMethod.bind(this);
-      Object.defineProperty(this, propertyKey, {
-        value: boundMethod,
-        configurable: true,
-        writable: true
-      });
-      return boundMethod;
-    }
-  };
-}
-export {
-  bound
-};
+import{a as k}from"./legacy/bound.js";import{b as q}from"./standard/bound.js";function D(j,f,v){if(typeof f==="object")return q(j,f);return k(j,f,v)}export{D as bound};
 
-//# debugId=90091E999EB96B5364756E2164756E21
+//# debugId=59B76D711A0E9E7C64756E2164756E21

package/dist/decorators/bound.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/decorators/bound.ts"],
   "sourcesContent": [
-    "import type { RadiantElement } from '@/core/radiant-element';\n\n/**\n * A decorator to bind a method to the instance.\n * @param target {@link RadiantElement}\n * @param propertyKey string\n * @param descriptor {@link PropertyDescriptor}\n * @returns\n */\nexport function bound(target: RadiantElement, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor {\n  const originalMethod = descriptor.value;\n\n  return {\n    configurable: true,\n    get() {\n      /**\n       * Check if the method is already bound to the instance.\n       */\n      if (this === (target as any).prototype || Object.hasOwn(this, propertyKey)) {\n        return originalMethod;\n      }\n\n      /**\n       * Bind the method to the instance.\n       */\n      const boundMethod = originalMethod.bind(this);\n      Object.defineProperty(this, propertyKey, {\n        value: boundMethod,\n        configurable: true,\n        writable: true,\n      });\n      return boundMethod;\n    },\n  };\n}\n"
+    "import type {\n  LegacyMethodDecoratorArgs,\n  StandardMethodDecoratorArgs,\n  StandardOrLegacyMethodDecoratorArgs,\n} from '../types';\nimport { bound as legacyBound } from './legacy/bound';\nimport { bound as standardBound } from './standard/bound';\n\n/**\n * A decorator to bind a method to the instance.\n */\nexport function bound(\n  protoOrTarget: StandardOrLegacyMethodDecoratorArgs['protoOrTarget'],\n  nameOrContext: StandardOrLegacyMethodDecoratorArgs['nameOrContext'],\n  descriptor?: StandardOrLegacyMethodDecoratorArgs['descriptor'],\n): any {\n  if (typeof nameOrContext === 'object') {\n    return standardBound(\n      protoOrTarget as StandardMethodDecoratorArgs['protoOrTarget'],\n      nameOrContext as StandardMethodDecoratorArgs['nameOrContext'],\n    );\n  }\n  return legacyBound(\n    protoOrTarget as LegacyMethodDecoratorArgs['protoOrTarget'],\n    nameOrContext as LegacyMethodDecoratorArgs['nameOrContext'],\n    descriptor as LegacyMethodDecoratorArgs['descriptor'],\n  );\n}\n"
   ],
-  "mappings": ";AASO,SAAS,KAAK,CAAC,QAAwB,aAAqB,YAAoD;AACrH,QAAM,iBAAiB,WAAW;AAElC,SAAO;AAAA,IACL,cAAc;AAAA,IACd,GAAG,GAAG;AAIJ,UAAI,SAAU,OAAe,aAAa,OAAO,OAAO,MAAM,WAAW,GAAG;AAC1E,eAAO;AAAA,MACT;AAKA,YAAM,cAAc,eAAe,KAAK,IAAI;AAC5C,aAAO,eAAe,MAAM,aAAa;AAAA,QACvC,OAAO;AAAA,QACP,cAAc;AAAA,QACd,UAAU;AAAA,MACZ,CAAC;AACD,aAAO;AAAA;AAAA,EAEX;AAAA;",
-  "debugId": "90091E999EB96B5364756E2164756E21",
+  "mappings": "oFAWO,GAAS,CAAK,CACnB,EACA,EACA,EACK,CACL,UAAW,IAAkB,SAC3B,OAAO,EACL,EACA,CACF,EAEF,OAAO,EACL,EACA,EACA,CACF",
+  "debugId": "59B76D711A0E9E7C64756E2164756E21",
   "names": []
 }

package/dist/decorators/custom-element.d.ts

@@ -1,5 +1,7 @@
+import type { StandardOrLegacyClassDecoratorArgs } from '../types';
 /**
  * Registers a web component with the given name on the global `window.customElements` registry.
  * @param name selector name.
+ * @param options {@link ElementDefinitionOptions}
  */
-export declare function customElement(name: string): (target: CustomElementConstructor) => void;
+export declare function customElement(name: string, options?: ElementDefinitionOptions): (protoOrTarget: StandardOrLegacyClassDecoratorArgs["protoOrTarget"], nameOrContext?: StandardOrLegacyClassDecoratorArgs["nameOrContext"]) => any;

package/dist/decorators/custom-element.js

@@ -1,15 +1,4 @@
-// src/decorators/custom-element.ts
-function customElement(name) {
-  return (target) => {
-    if (!globalThis.window)
-      return;
-    if (!window.customElements.get(name)) {
-      window.customElements.define(name, target);
-    }
-  };
-}
-export {
-  customElement
-};
+import{x as B}from"./legacy/custom-element.js";import{y as F}from"./standard/custom-element.js";function I(j,q){return function(z,A){if(typeof A!=="undefined")return F(j,q)(z,A);return B(j,q)(z)}}export{I as customElement};
+export{I as w};
 
-//# debugId=5286B58DE50049BA64756E2164756E21
+//# debugId=09A2FAA985EB9AE564756E2164756E21

package/dist/decorators/custom-element.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/decorators/custom-element.ts"],
   "sourcesContent": [
-    "/**\n * Registers a web component with the given name on the global `window.customElements` registry.\n * @param name selector name.\n */\nexport function customElement(name: string) {\n  return (target: CustomElementConstructor) => {\n    if (!globalThis.window) return;\n    if (!window.customElements.get(name)) {\n      window.customElements.define(name, target);\n    }\n  };\n}\n"
+    "import type {\n  LegacyClassDecoratorArgs,\n  StandardClassDecoratorArgs,\n  StandardOrLegacyClassDecoratorArgs,\n} from '../types';\nimport { customElement as legacyCustomElement } from './legacy/custom-element';\nimport { customElement as standardCustomElement } from './standard/custom-element';\n\n/**\n * Registers a web component with the given name on the global `window.customElements` registry.\n * @param name selector name.\n * @param options {@link ElementDefinitionOptions}\n */\nexport function customElement(name: string, options?: ElementDefinitionOptions) {\n  return function (\n    protoOrTarget: StandardOrLegacyClassDecoratorArgs['protoOrTarget'],\n    nameOrContext?: StandardOrLegacyClassDecoratorArgs['nameOrContext'],\n  ): any {\n    if (typeof nameOrContext !== 'undefined') {\n      return standardCustomElement(name, options)(\n        protoOrTarget as StandardClassDecoratorArgs['protoOrTarget'],\n        nameOrContext as StandardClassDecoratorArgs['nameOrContext'],\n      );\n    }\n    return legacyCustomElement(name, options)(protoOrTarget as LegacyClassDecoratorArgs['protoOrTarget']);\n  };\n}\n"
   ],
-  "mappings": ";AAIO,SAAS,aAAa,CAAC,MAAc;AAC1C,SAAO,CAAC,WAAqC;AAC3C,SAAK,WAAW;AAAQ;AACxB,SAAK,OAAO,eAAe,IAAI,IAAI,GAAG;AACpC,aAAO,eAAe,OAAO,MAAM,MAAM;AAAA,IAC3C;AAAA;AAAA;",
-  "debugId": "5286B58DE50049BA64756E2164756E21",
+  "mappings": "6FAaO,YAAS,CAAa,CAAC,EAAc,EAAoC,CAC9E,eAAgB,CACd,EACA,EACK,CACL,UAAW,IAAkB,YAC3B,OAAO,EAAsB,EAAM,CAAO,EACxC,EACA,CACF,EAEF,OAAO,EAAoB,EAAM,CAAO,EAAE,CAA0D",
+  "debugId": "09A2FAA985EB9AE564756E2164756E21",
   "names": []
 }

package/dist/decorators/debounce.d.ts

@@ -1 +1,6 @@
-export declare function debounce(timeout: number): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+import type { StandardOrLegacyMethodDecoratorArgs } from '../types';
+/**
+ * A decorator to debounce a method.
+ * @param timeout The debounce timeout in milliseconds.
+ */
+export declare function debounce(timeout: number): (protoOrTarget: StandardOrLegacyMethodDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyMethodDecoratorArgs["nameOrContext"], descriptor?: StandardOrLegacyMethodDecoratorArgs["descriptor"]) => any;

package/dist/decorators/debounce.js

@@ -1,21 +1,3 @@
-// src/decorators/debounce.ts
-function debounce(timeout) {
-  let timeoutRef = null;
-  return (_target, _propertyKey, descriptor) => {
-    const originalMethod = descriptor.value;
-    descriptor.value = function debounce(...args) {
-      if (timeoutRef !== null) {
-        clearTimeout(timeoutRef);
-      }
-      timeoutRef = setTimeout(() => {
-        originalMethod.apply(this, args);
-      }, timeout);
-    };
-    return descriptor;
-  };
-}
-export {
-  debounce
-};
+import{C as q}from"./legacy/debounce.js";import{D as v}from"./standard/debounce.js";function E(j){return function(k,f,w){if(typeof f==="object")return v(j)(k,f);return q(j)(k,f,w)}}export{E as debounce};
 
-//# debugId=30A0CC4182AD504664756E2164756E21
+//# debugId=7989BE13E335452D64756E2164756E21

package/dist/decorators/debounce.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/decorators/debounce.ts"],
   "sourcesContent": [
-    "import type { RadiantElement } from '@/core/radiant-element';\n\nexport function debounce(\n  timeout: number,\n): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor {\n  let timeoutRef: ReturnType<typeof setTimeout> | null = null;\n\n  return (_target: RadiantElement, _propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor => {\n    const originalMethod = descriptor.value;\n\n    descriptor.value = function debounce(...args: any[]) {\n      if (timeoutRef !== null) {\n        clearTimeout(timeoutRef);\n      }\n\n      timeoutRef = setTimeout(() => {\n        originalMethod.apply(this, args);\n      }, timeout);\n    };\n\n    return descriptor;\n  };\n}\n"
+    "import type {\n  LegacyMethodDecoratorArgs,\n  StandardMethodDecoratorArgs,\n  StandardOrLegacyMethodDecoratorArgs,\n} from '../types';\nimport { debounce as legacyDebounce } from './legacy/debounce';\nimport { debounce as standardDebounce } from './standard/debounce';\n\n/**\n * A decorator to debounce a method.\n * @param timeout The debounce timeout in milliseconds.\n */\nexport function debounce(timeout: number) {\n  return function (\n    protoOrTarget: StandardOrLegacyMethodDecoratorArgs['protoOrTarget'],\n    nameOrContext: StandardOrLegacyMethodDecoratorArgs['nameOrContext'],\n    descriptor?: StandardOrLegacyMethodDecoratorArgs['descriptor'],\n  ): any {\n    if (typeof nameOrContext === 'object') {\n      return standardDebounce(timeout)(\n        protoOrTarget as StandardMethodDecoratorArgs['protoOrTarget'],\n        nameOrContext as StandardMethodDecoratorArgs['nameOrContext'],\n      );\n    }\n    return legacyDebounce(timeout)(\n      protoOrTarget as LegacyMethodDecoratorArgs['protoOrTarget'],\n      nameOrContext as LegacyMethodDecoratorArgs['nameOrContext'],\n      descriptor as LegacyMethodDecoratorArgs['descriptor'],\n    );\n  };\n}\n"
   ],
-  "mappings": ";AAEO,SAAS,QAAQ,CACtB,SAC0F;AAC1F,MAAI,aAAmD;AAEvD,SAAO,CAAC,SAAyB,cAAsB,eAAuD;AAC5G,UAAM,iBAAiB,WAAW;AAElC,eAAW,iBAAiB,QAAQ,IAAI,MAAa;AACnD,UAAI,eAAe,MAAM;AACvB,qBAAa,UAAU;AAAA,MACzB;AAEA,mBAAa,WAAW,MAAM;AAC5B,uBAAe,MAAM,MAAM,IAAI;AAAA,SAC9B,OAAO;AAAA;AAGZ,WAAO;AAAA;AAAA;",
-  "debugId": "30A0CC4182AD504664756E2164756E21",
+  "mappings": "uFAYO,MAAS,CAAQ,CAAC,EAAiB,CACxC,eAAgB,CACd,EACA,EACA,EACK,CACL,UAAW,IAAkB,SAC3B,OAAO,EAAiB,CAAO,EAC7B,EACA,CACF,EAEF,OAAO,EAAe,CAAO,EAC3B,EACA,EACA,CACF",
+  "debugId": "7989BE13E335452D64756E2164756E21",
   "names": []
 }

package/dist/decorators/event.d.ts

@@ -1,8 +1,9 @@
 import { type EventEmitterConfig } from '../tools/event-emitter';
+import type { StandardOrLegacyFieldDecoratorArgs } from '../types';
 /**
  * Decorator that attaches an EventEmitter to the class field property.
  * The EventEmitter can be used to dispatch custom events from the target element.
- * @param eventConfig Configuration for the event emitter.
+ * @param eventConfig {@link EventEmitterConfig}  Configuration for the event emitter.
  * @see {@link EventEmitter} for more details about how the EventEmitter works.
  */
-export declare function event(eventConfig: EventEmitterConfig): (target: any, propertyKey: string) => void;
+export declare function event(eventConfig: EventEmitterConfig): (protoOrTarget: StandardOrLegacyFieldDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyFieldDecoratorArgs["nameOrContext"]) => any;