@ecopages/radiant 0.1.8 → 0.3.0-alpha.0

package/dist/decorators/legacy/query-slot.d.ts

@@ -0,0 +1,3 @@
+import type { RadiantElement } from '../../core/radiant-element';
+import type { QuerySlotConfig } from '../query-slot';
+export declare function querySlot<T extends Element | Element[]>(options?: QuerySlotConfig): (proto: RadiantElement, propertyName: string | symbol) => void;

package/dist/decorators/legacy/query-slot.js

@@ -0,0 +1,3 @@
+import{Z as a}from"../../chunk-5bym7y1d.js";import"../../chunk-9gjmqxp2.js";import"../../chunk-8tvt04cm.js";import"../../chunk-qd28hvdx.js";import"../../chunk-8xy18qmz.js";export{a as querySlot};
+
+//# debugId=9D2A71B9D070933564756E2164756E21

package/dist/decorators/legacy/query-slot.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "9D2A71B9D070933564756E2164756E21",
+  "names": []
+}

package/dist/decorators/legacy/query.d.ts

@@ -0,0 +1,23 @@
+import type { RadiantElement } from '../../core/radiant-element';
+import type { QueryConfig } from '../query';
+/**
+ * A decorator to query by CSS selector or data-ref attribute.
+ * By default it queries for the first element that matches the selector, but it can be configured to query for all elements.
+ *
+ * @param {QueryConfig} options - The configuration object for the query.
+ * @param {boolean} [options.all] - A flag to query for all elements that match the selector. Defaults to `false`.
+ * @param {boolean} [options.cache] - A flag to cache the query result. Defaults to `true`.
+ * @param {string} [options.selector] - A CSS selector to match elements against. This property is mutually exclusive with `options.ref`.
+ * @param {string} [options.ref] - A reference to an element. This property is mutually exclusive with `options.selector`.
+ *
+ * @returns {Function} A decorator function that, when applied to a class property, will replace it with a getter. The getter will return the result of the query when accessed.
+ *
+ * @example
+ * class MyElement extends HTMLElement {
+ *   @query({ selector: '.my-class' })
+ *   myElement;
+ * }
+ *
+ * // Now, `myElement` will return the first element in the light DOM of `MyElement` that matches the selector '.my-class'.
+ */
+export declare function query<T extends Element | Element[]>({ cache: shouldBeCached, ...options }: QueryConfig): (proto: RadiantElement, propertyName: string | symbol) => void;

package/dist/decorators/legacy/query.js

@@ -0,0 +1,3 @@
+import{ia as a}from"../../chunk-qe6sjr27.js";import"../../chunk-8tvt04cm.js";import"../../chunk-g0gz7ypq.js";import"../../chunk-8xy18qmz.js";export{a as query};
+
+//# debugId=475828F254A6DFA964756E2164756E21

package/dist/decorators/legacy/query.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "475828F254A6DFA964756E2164756E21",
+  "names": []
+}

package/dist/decorators/{reactive-field.d.ts → legacy/reactive-field.d.ts}

@@ -1,4 +1,4 @@
-import type { RadiantElement } from '../core/radiant-element';
+import type { RadiantElement } from '../../core/radiant-element';
 /**
  * A decorator to define a reactive field.
  * Every time the property changes, the `updated` method will be called.
@@ -7,4 +7,4 @@ import type { RadiantElement } from '../core/radiant-element';
  * @param target The target element.
  * @param propertyKey The property key.
  */
-export declare function reactiveField(proto: RadiantElement, propertyKey: string): void;
+export declare function reactiveField(target: RadiantElement, propertyKey: string): void;

package/dist/decorators/legacy/reactive-field.js

@@ -0,0 +1,3 @@
+import{ua as a}from"../../chunk-t7a1bbxq.js";import"../../chunk-8tvt04cm.js";import"../../chunk-8xy18qmz.js";export{a as reactiveField};
+
+//# debugId=AF6C88A8564B58D164756E2164756E21

package/dist/decorators/legacy/reactive-field.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "AF6C88A8564B58D164756E2164756E21",
+  "names": []
+}

package/dist/decorators/{reactive-prop.d.ts → legacy/reactive-prop.d.ts}

@@ -1,10 +1,11 @@
-import type { RadiantElement } from '../core/radiant-element';
-import { type AttributeTypeConstant } from '../utils/attribute-utils';
+import type { RadiantElement } from '../../core/radiant-element';
+import { type AttributeTypeConstant } from '../../utils/attribute-utils';
 type ReactivePropertyOptions<T> = {
     type: AttributeTypeConstant;
     reflect?: boolean;
     attribute?: string;
     defaultValue?: T;
+    bind?: boolean | string;
 };
 /**
  * A decorator to define a reactive property.
@@ -15,5 +16,5 @@ type ReactivePropertyOptions<T> = {
  * @param options.attribute The name of the attribute.
  * @param options.defaultValue The default value of the property.
  */
-export declare function reactiveProp<T = unknown>({ type, attribute, reflect, defaultValue }: ReactivePropertyOptions<T>): (target: RadiantElement, propertyName: string) => void;
+export declare function reactiveProp<T = unknown>({ type, attribute, reflect, defaultValue, bind, }: ReactivePropertyOptions<T>): (target: RadiantElement, propertyName: string) => void;
 export {};

package/dist/decorators/legacy/reactive-prop.js

@@ -0,0 +1,3 @@
+import{da as a}from"../../chunk-x0522ksh.js";import"../../chunk-8dexhy6c.js";import"../../chunk-8tvt04cm.js";import"../../chunk-73x7jpdd.js";import"../../chunk-8xy18qmz.js";export{a as reactiveProp};
+
+//# debugId=BD4CA5D82CB1344F64756E2164756E21

package/dist/decorators/legacy/reactive-prop.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "BD4CA5D82CB1344F64756E2164756E21",
+  "names": []
+}

package/dist/decorators/legacy/signal.d.ts

@@ -0,0 +1,10 @@
+import type { RadiantElement, ReactiveBindingOption } from '../../core/radiant-element';
+import type { AttributeTypeConstant } from '../../utils/attribute-utils';
+import type { WritableSignal } from '@ecopages/signals';
+export type SignalDecoratorOptions<Value = unknown> = {
+    bind?: ReactiveBindingOption;
+    initial?: Value;
+    source?: WritableSignal<Value> | ((host: RadiantElement) => WritableSignal<Value>);
+    hydrate?: AttributeTypeConstant;
+};
+export declare function signal<Value = unknown>(options?: SignalDecoratorOptions<Value>): (target: RadiantElement, propertyName: string) => void;

package/dist/decorators/legacy/signal.js

@@ -0,0 +1,3 @@
+import{la as a}from"../../chunk-t6x9e177.js";import"../../chunk-57w3vmme.js";import"../../chunk-8tvt04cm.js";import"../../chunk-6z34stya.js";import"../../chunk-ksv01cey.js";import"../../chunk-8n2dhx28.js";import"../../chunk-8xy18qmz.js";export{a as signal};
+
+//# debugId=2942703D6CD9888164756E2164756E21

package/dist/decorators/legacy/signal.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "2942703D6CD9888164756E2164756E21",
+  "names": []
+}

package/dist/decorators/on-event.d.ts

@@ -1,13 +1,6 @@
-import type { RadiantElement, RadiantElementEventListener } from '../core/radiant-element';
-type OnEventConfig = Pick<RadiantElementEventListener, 'type' | 'options'> & ({
-    selector: string;
-} | {
-    ref: string;
-} | {
-    window: boolean;
-} | {
-    document: boolean;
-});
+import type { StandardOrLegacyMethodDecoratorArgs } from '../types';
+import type { OnEventConfig, OnEventScope } from '../helpers/create-event-listener';
+export type { OnEventConfig, OnEventScope };
 /**
  * A decorator to subscribe to an event on the target element.
  * The event listener will be automatically unsubscribed when the element is disconnected.
@@ -15,12 +8,8 @@ type OnEventConfig = Pick<RadiantElementEventListener, 'type' | 'options'> & ({
  * Note: This decorator uses event delegation, which means it relies on event bubbling.
  * Therefore, it will not work with events that do not bubble, such as `focus`, `blur`, `load`, `unload`, `scroll`, etc.
  * For focus and blur events, consider using `focusin` and `focusout` which are similar but do bubble.
+ * Delegated listeners observe the host light DOM by default, and can optionally observe the shadow root or both trees.
  *
- * @param eventConfig The event configuration.
- * @param eventConfig.selectors The CSS selector(s) of the target element(s).
- * @param eventConfig.ref The data-ref attribute of the target element.
- * @param eventConfig.type The type of the event to listen for.
- * @param eventConfig.options Optional. An options object that specifies characteristics about the event listener.
+ * @param options {@link OnEventConfig} The event configuration.
  */
-export declare function onEvent(eventConfig: OnEventConfig): (proto: RadiantElement, _: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-export {};
+export declare function onEvent(options: OnEventConfig): (protoOrTarget: StandardOrLegacyMethodDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyMethodDecoratorArgs["nameOrContext"], descriptor?: StandardOrLegacyMethodDecoratorArgs["descriptor"]) => any;

package/dist/decorators/on-event.js

@@ -1,48 +1,3 @@
-// src/decorators/on-event.ts
-function onEvent(eventConfig) {
-  return (proto, _, descriptor) => {
-    const originalConnectedCallback = proto.connectedCallback;
-    const originalDisconnectedCallback = proto.disconnectedCallback;
-    if ("window" in eventConfig) {
-      proto.connectedCallback = function() {
-        window.addEventListener(eventConfig.type, descriptor.value.bind(this), eventConfig.options);
-        originalConnectedCallback.call(this);
-      };
-      proto.disconnectedCallback = function() {
-        window.removeEventListener(eventConfig.type, descriptor.value.bind(this), eventConfig.options);
-        originalDisconnectedCallback.call(this);
-      };
-      return descriptor;
-    }
-    if ("document" in eventConfig) {
-      proto.connectedCallback = function() {
-        document.addEventListener(eventConfig.type, descriptor.value.bind(this), eventConfig.options);
-        originalConnectedCallback.call(this);
-      };
-      proto.disconnectedCallback = function() {
-        document.removeEventListener(eventConfig.type, descriptor.value.bind(this), eventConfig.options);
-        originalDisconnectedCallback.call(this);
-      };
-      return descriptor;
-    }
-    const selector = "selector" in eventConfig ? eventConfig.selector : `[data-ref="${eventConfig.ref}"]`;
-    const originalMethod = descriptor.value;
-    const subscriptionId = `${eventConfig.type}-${selector}`;
-    proto.connectedCallback = function() {
-      this.subscribeEvent({
-        id: subscriptionId,
-        selector,
-        type: eventConfig.type,
-        listener: originalMethod.bind(this),
-        options: eventConfig?.options ?? undefined
-      });
-      originalConnectedCallback.call(this);
-    };
-    return descriptor;
-  };
-}
-export {
-  onEvent
-};
+import{Ia as a}from"../chunk-d4v5qpxa.js";import"../chunk-3b033cgq.js";import"../chunk-aajhkdmn.js";import"../chunk-8tvt04cm.js";import"../chunk-nerd6fmg.js";import"../chunk-nw171z6m.js";import"../chunk-8xy18qmz.js";export{a as onEvent};
 
-//# debugId=49814E8BB4043A1364756E2164756E21
+//# debugId=2318DA2E353CA55564756E2164756E21

package/dist/decorators/on-event.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/on-event.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement, RadiantElementEventListener } from '@/core/radiant-element';\n\ntype OnEventConfig = Pick<RadiantElementEventListener, 'type' | 'options'> &\n  (\n    | {\n        selector: string;\n      }\n    | {\n        ref: string;\n      }\n    | {\n        window: boolean;\n      }\n    | {\n        document: boolean;\n      }\n  );\n\n/**\n * A decorator to subscribe to an event on the target element.\n * The event listener will be automatically unsubscribed when the element is disconnected.\n *\n * Note: This decorator uses event delegation, which means it relies on event bubbling.\n * Therefore, it will not work with events that do not bubble, such as `focus`, `blur`, `load`, `unload`, `scroll`, etc.\n * For focus and blur events, consider using `focusin` and `focusout` which are similar but do bubble.\n *\n * @param eventConfig The event configuration.\n * @param eventConfig.selectors The CSS selector(s) of the target element(s).\n * @param eventConfig.ref The data-ref attribute of the target element.\n * @param eventConfig.type The type of the event to listen for.\n * @param eventConfig.options Optional. An options object that specifies characteristics about the event listener.\n */\nexport function onEvent(eventConfig: OnEventConfig) {\n  return (proto: RadiantElement, _: string, descriptor: PropertyDescriptor) => {\n    const originalConnectedCallback = proto.connectedCallback;\n    const originalDisconnectedCallback = proto.disconnectedCallback;\n\n    if ('window' in eventConfig) {\n      proto.connectedCallback = function (this: RadiantElement) {\n        window.addEventListener(eventConfig.type, descriptor.value.bind(this), eventConfig.options);\n        originalConnectedCallback.call(this);\n      };\n\n      proto.disconnectedCallback = function (this: RadiantElement) {\n        window.removeEventListener(eventConfig.type, descriptor.value.bind(this), eventConfig.options);\n        originalDisconnectedCallback.call(this);\n      };\n\n      return descriptor;\n    }\n\n    if ('document' in eventConfig) {\n      proto.connectedCallback = function (this: RadiantElement) {\n        document.addEventListener(eventConfig.type, descriptor.value.bind(this), eventConfig.options);\n        originalConnectedCallback.call(this);\n      };\n\n      proto.disconnectedCallback = function (this: RadiantElement) {\n        document.removeEventListener(eventConfig.type, descriptor.value.bind(this), eventConfig.options);\n        originalDisconnectedCallback.call(this);\n      };\n\n      return descriptor;\n    }\n\n    const selector = 'selector' in eventConfig ? eventConfig.selector : `[data-ref=\"${eventConfig.ref}\"]`;\n\n    const originalMethod = descriptor.value;\n    const subscriptionId = `${eventConfig.type}-${selector}`;\n\n    proto.connectedCallback = function (this: RadiantElement) {\n      this.subscribeEvent({\n        id: subscriptionId,\n        selector: selector,\n        type: eventConfig.type,\n        listener: originalMethod.bind(this),\n        options: eventConfig?.options ?? undefined,\n      });\n\n      originalConnectedCallback.call(this);\n    };\n\n    return descriptor;\n  };\n}\n"
   ],
-  "mappings": ";AAgCO,SAAS,OAAO,CAAC,aAA4B;AAClD,SAAO,CAAC,OAAuB,GAAW,eAAmC;AAC3E,UAAM,4BAA4B,MAAM;AACxC,UAAM,+BAA+B,MAAM;AAE3C,QAAI,YAAY,aAAa;AAC3B,YAAM,4BAA6B,GAAuB;AACxD,eAAO,iBAAiB,YAAY,MAAM,WAAW,MAAM,KAAK,IAAI,GAAG,YAAY,OAAO;AAC1F,kCAA0B,KAAK,IAAI;AAAA;AAGrC,YAAM,+BAAgC,GAAuB;AAC3D,eAAO,oBAAoB,YAAY,MAAM,WAAW,MAAM,KAAK,IAAI,GAAG,YAAY,OAAO;AAC7F,qCAA6B,KAAK,IAAI;AAAA;AAGxC,aAAO;AAAA,IACT;AAEA,QAAI,cAAc,aAAa;AAC7B,YAAM,4BAA6B,GAAuB;AACxD,iBAAS,iBAAiB,YAAY,MAAM,WAAW,MAAM,KAAK,IAAI,GAAG,YAAY,OAAO;AAC5F,kCAA0B,KAAK,IAAI;AAAA;AAGrC,YAAM,+BAAgC,GAAuB;AAC3D,iBAAS,oBAAoB,YAAY,MAAM,WAAW,MAAM,KAAK,IAAI,GAAG,YAAY,OAAO;AAC/F,qCAA6B,KAAK,IAAI;AAAA;AAGxC,aAAO;AAAA,IACT;AAEA,UAAM,WAAW,cAAc,cAAc,YAAY,WAAW,cAAc,YAAY;AAE9F,UAAM,iBAAiB,WAAW;AAClC,UAAM,iBAAiB,GAAG,YAAY,QAAQ;AAE9C,UAAM,4BAA6B,GAAuB;AACxD,WAAK,eAAe;AAAA,QAClB,IAAI;AAAA,QACJ;AAAA,QACA,MAAM,YAAY;AAAA,QAClB,UAAU,eAAe,KAAK,IAAI;AAAA,QAClC,SAAS,aAAa,WAAW;AAAA,MACnC,CAAC;AAED,gCAA0B,KAAK,IAAI;AAAA;AAGrC,WAAO;AAAA;AAAA;",
-  "debugId": "49814E8BB4043A1364756E2164756E21",
+  "mappings": "",
+  "debugId": "2318DA2E353CA55564756E2164756E21",
   "names": []
 }

package/dist/decorators/on-updated.d.ts

@@ -1,6 +1,5 @@
-import type { RadiantElement } from '../core/radiant-element';
+import type { StandardOrLegacyMethodDecoratorArgs } from '../types';
 /**
- * A decorator to subscribe to an updated callback when a reactive field or property changes.
- * @param eventConfig The event configuration.
+ * A decorator to bind a method to the instance.
  */
-export declare function onUpdated(keyOrKeys: string | string[]): (proto: RadiantElement, methodName: string) => void;
+export declare function onUpdated(keyOrKeys: string | string[]): (protoOrTarget: StandardOrLegacyMethodDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyMethodDecoratorArgs["nameOrContext"], descriptor?: StandardOrLegacyMethodDecoratorArgs["descriptor"]) => any;

package/dist/decorators/on-updated.js

@@ -1,30 +1,3 @@
-// src/decorators/on-updated.ts
-function onUpdated(keyOrKeys) {
-  return (proto, methodName) => {
-    if (!("updatesRegistry" in proto)) {
-      Object.defineProperty(proto, "updatesRegistry", {
-        value: new Map,
-        configurable: true
-      });
-    }
-    const updatesRegistry = proto.updatesRegistry;
-    if (Array.isArray(keyOrKeys)) {
-      for (const key of keyOrKeys) {
-        if (!updatesRegistry.has(key)) {
-          updatesRegistry.set(key, new Set);
-        }
-        updatesRegistry.get(key)?.add(methodName);
-      }
-    } else if (typeof keyOrKeys === "string") {
-      if (!updatesRegistry.has(keyOrKeys)) {
-        updatesRegistry.set(keyOrKeys, new Set);
-      }
-      updatesRegistry.get(keyOrKeys)?.add(methodName);
-    }
-  };
-}
-export {
-  onUpdated
-};
+import{Ca as a}from"../chunk-0zq7e1ne.js";import"../chunk-tyysm4gk.js";import"../chunk-qdj6r8jn.js";import"../chunk-8tvt04cm.js";import"../chunk-nerd6fmg.js";import"../chunk-8xy18qmz.js";export{a as onUpdated};
 
-//# debugId=AF5929F6BACB358464756E2164756E21
+//# debugId=83AB63167809D83E64756E2164756E21

package/dist/decorators/on-updated.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/on-updated.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '@/core/radiant-element';\n\n/**\n * A decorator to subscribe to an updated callback when a reactive field or property changes.\n * @param eventConfig The event configuration.\n */\nexport function onUpdated(keyOrKeys: string | string[]) {\n  return (proto: RadiantElement, methodName: string) => {\n    if (!('updatesRegistry' in proto)) {\n      Object.defineProperty(proto, 'updatesRegistry', {\n        value: new Map<string, Set<string>>(),\n        configurable: true,\n      });\n    }\n\n    const updatesRegistry = proto.updatesRegistry;\n\n    if (Array.isArray(keyOrKeys)) {\n      for (const key of keyOrKeys) {\n        if (!updatesRegistry.has(key)) {\n          updatesRegistry.set(key, new Set());\n        }\n        updatesRegistry.get(key)?.add(methodName);\n      }\n    } else if (typeof keyOrKeys === 'string') {\n      if (!updatesRegistry.has(keyOrKeys)) {\n        updatesRegistry.set(keyOrKeys, new Set());\n      }\n      updatesRegistry.get(keyOrKeys)?.add(methodName);\n    }\n  };\n}\n"
   ],
-  "mappings": ";AAMO,SAAS,SAAS,CAAC,WAA8B;AACtD,SAAO,CAAC,OAAuB,eAAuB;AACpD,UAAM,qBAAqB,QAAQ;AACjC,aAAO,eAAe,OAAO,mBAAmB;AAAA,QAC9C,OAAO,IAAI;AAAA,QACX,cAAc;AAAA,MAChB,CAAC;AAAA,IACH;AAEA,UAAM,kBAAkB,MAAM;AAE9B,QAAI,MAAM,QAAQ,SAAS,GAAG;AAC5B,iBAAW,OAAO,WAAW;AAC3B,aAAK,gBAAgB,IAAI,GAAG,GAAG;AAC7B,0BAAgB,IAAI,KAAK,IAAI,GAAK;AAAA,QACpC;AACA,wBAAgB,IAAI,GAAG,GAAG,IAAI,UAAU;AAAA,MAC1C;AAAA,IACF,kBAAkB,cAAc,UAAU;AACxC,WAAK,gBAAgB,IAAI,SAAS,GAAG;AACnC,wBAAgB,IAAI,WAAW,IAAI,GAAK;AAAA,MAC1C;AACA,sBAAgB,IAAI,SAAS,GAAG,IAAI,UAAU;AAAA,IAChD;AAAA;AAAA;",
-  "debugId": "AF5929F6BACB358464756E2164756E21",
+  "mappings": "",
+  "debugId": "83AB63167809D83E64756E2164756E21",
   "names": []
 }

package/dist/decorators/prop.d.ts

@@ -0,0 +1,14 @@
+import type { ReactivePropertyOptions } from '../core/radiant-element';
+import type { StandardOrLegacyFieldDecoratorArgs } from '../types';
+/**
+ * Declares a reactive property backed by an HTML attribute.
+ *
+ * Every write triggers `notifyUpdate` so update callbacks, bindings, and
+ * `RadiantComponent` renders stay in sync. When no explicit `bind` option
+ * is supplied, `RadiantComponent` hosts expose a JSX companion binding
+ * accessor automatically while plain `RadiantElement` hosts keep binding
+ * opt-in.
+ *
+ * @param options {@link ReactivePropertyOptions} The options for the reactive property.
+ */
+export declare function prop<T = unknown>(options: ReactivePropertyOptions<T>): (protoOrTarget: StandardOrLegacyFieldDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyFieldDecoratorArgs["nameOrContext"]) => any;

package/dist/decorators/prop.js

@@ -0,0 +1,3 @@
+import{ca as a}from"../chunk-p6pxdvkk.js";import"../chunk-x0522ksh.js";import"../chunk-dscj0sk9.js";import"../chunk-8dexhy6c.js";import"../chunk-8tvt04cm.js";import"../chunk-nerd6fmg.js";import"../chunk-73x7jpdd.js";import"../chunk-8xy18qmz.js";export{a as prop};
+
+//# debugId=E51C4954548A2BB464756E2164756E21

package/dist/decorators/prop.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "E51C4954548A2BB464756E2164756E21",
+  "names": []
+}

package/dist/decorators/query-slot.d.ts

@@ -0,0 +1,13 @@
+import type { StandardOrLegacyFieldDecoratorArgs } from '../types';
+import type { QuerySlotConfig } from '../helpers/create-query-slot';
+export type { QuerySlotConfig };
+/**
+ * Queries projected light-DOM content assigned to a RadiantComponent slot.
+ *
+ * The decorator returns assigned elements from the default slot when `name` is
+ * omitted, or from the named slot when `name` is provided. Results are cached
+ * by default and automatically invalidated when slot projection changes.
+ *
+ * @param options Slot query options.
+ */
+export declare function querySlot<T extends Element | Element[]>(options?: QuerySlotConfig): (protoOrTarget: StandardOrLegacyFieldDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyFieldDecoratorArgs["nameOrContext"]) => any;

package/dist/decorators/query-slot.js

@@ -0,0 +1,3 @@
+import{Y as a}from"../chunk-0y78f8hj.js";import"../chunk-5bym7y1d.js";import"../chunk-9gjmqxp2.js";import"../chunk-bmhn4nbp.js";import"../chunk-8tvt04cm.js";import"../chunk-nerd6fmg.js";import"../chunk-qd28hvdx.js";import"../chunk-8xy18qmz.js";export{a as querySlot};
+
+//# debugId=8CBFFD924AFC8B2564756E2164756E21

package/dist/decorators/query-slot.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "8CBFFD924AFC8B2564756E2164756E21",
+  "names": []
+}

package/dist/decorators/query.d.ts

@@ -1,39 +1,11 @@
-import type { RadiantElement } from '../core';
-/**
- * The base configuration object for the query.
- */
-type BaseQueryConfig = {
-    all?: boolean;
-    cache?: boolean;
-};
-/**
- * The configuration object for the query.
- * It can be configured to query by CSS selector or data-ref attribute.
- */
-export type QueryConfig = BaseQueryConfig & ({
-    selector: string;
-} | {
-    ref: string;
-});
+import type { StandardOrLegacyFieldDecoratorArgs } from '../types';
+import type { QueryConfig, QueryScope } from '../helpers/create-query';
+export type { QueryConfig, QueryScope };
 /**
  * A decorator to query by CSS selector or data-ref attribute.
  * By default it queries for the first element that matches the selector, but it can be configured to query for all elements.
- *
- * @param {QueryConfig} options - The configuration object for the query.
- * @param {boolean} [options.all] - A flag to query for all elements that match the selector. Defaults to `false`.
- * @param {boolean} [options.cache] - A flag to cache the query result. Defaults to `true`.
- * @param {string} [options.selector] - A CSS selector to match elements against. This property is mutually exclusive with `options.ref`.
- * @param {string} [options.ref] - A reference to an element. This property is mutually exclusive with `options.selector`.
- *
- * @returns {Function} A decorator function that, when applied to a class property, will replace it with a getter. The getter will return the result of the query when accessed.
- *
- * @example
- * class MyElement extends HTMLElement {
- *   @query({ selector: '.my-class' })
- *   myElement;
- * }
- *
- * // Now, `myElement` will return the first element in the light DOM of `MyElement` that matches the selector '.my-class'.
+ * It caches the result only when `cache` is enabled.
+ * Queries run against the host light DOM by default, but can be directed to the shadow root or both trees.
+ * @param options {@link QueryConfig} The options for the reactive property.
  */
-export declare function query({ cache: shouldBeCached, ...options }: QueryConfig): (proto: RadiantElement, propertyKey: string | symbol) => void;
-export {};
+export declare function query<T extends Element | Element[]>(options: QueryConfig): (protoOrTarget: StandardOrLegacyFieldDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyFieldDecoratorArgs["nameOrContext"]) => any;

package/dist/decorators/query.js

@@ -1,37 +1,3 @@
-// src/decorators/query.ts
-function query({
-  cache: shouldBeCached = true,
-  ...options
-}) {
-  const cache = new WeakMap;
-  return (proto, propertyKey) => {
-    const doQuery = function() {
-      if (shouldBeCached) {
-        const cachedResult = cache.get(this);
-        if (cachedResult !== undefined) {
-          return cachedResult;
-        }
-      }
-      const selector = "selector" in options ? options.selector : `[data-ref="${options.ref}"]`;
-      const queryResult = options.all ? this.querySelectorAll(selector) : this.querySelector(selector);
-      if (shouldBeCached) {
-        cache.set(this, queryResult);
-      }
-      return queryResult;
-    };
-    const originalConnectedCallback = proto.connectedCallback;
-    proto.connectedCallback = function() {
-      Object.defineProperty(this, propertyKey, {
-        get: doQuery,
-        enumerable: true,
-        configurable: true
-      });
-      originalConnectedCallback.call(this);
-    };
-  };
-}
-export {
-  query
-};
+import{ha as a}from"../chunk-2tgrfv09.js";import"../chunk-qe6sjr27.js";import"../chunk-scfk041e.js";import"../chunk-8tvt04cm.js";import"../chunk-nerd6fmg.js";import"../chunk-g0gz7ypq.js";import"../chunk-8xy18qmz.js";export{a as query};
 
-//# debugId=E7593899A4A7CB9A64756E2164756E21
+//# debugId=20008E9E16D5D5FB64756E2164756E21

package/dist/decorators/query.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/query.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '@/core';\n\n/**\n * The base configuration object for the query.\n */\ntype BaseQueryConfig = {\n  all?: boolean;\n  cache?: boolean;\n};\n\n/**\n * The configuration object for the query.\n * It can be configured to query by CSS selector or data-ref attribute.\n */\nexport type QueryConfig = BaseQueryConfig &\n  (\n    | {\n        selector: string;\n      }\n    | {\n        ref: string;\n      }\n  );\n\n/**\n * A decorator to query by CSS selector or data-ref attribute.\n * By default it queries for the first element that matches the selector, but it can be configured to query for all elements.\n *\n * @param {QueryConfig} options - The configuration object for the query.\n * @param {boolean} [options.all] - A flag to query for all elements that match the selector. Defaults to `false`.\n * @param {boolean} [options.cache] - A flag to cache the query result. Defaults to `true`.\n * @param {string} [options.selector] - A CSS selector to match elements against. This property is mutually exclusive with `options.ref`.\n * @param {string} [options.ref] - A reference to an element. This property is mutually exclusive with `options.selector`.\n *\n * @returns {Function} A decorator function that, when applied to a class property, will replace it with a getter. The getter will return the result of the query when accessed.\n *\n * @example\n * class MyElement extends HTMLElement {\n *   @query({ selector: '.my-class' })\n *   myElement;\n * }\n *\n * // Now, `myElement` will return the first element in the light DOM of `MyElement` that matches the selector '.my-class'.\n */\nexport function query({\n  cache: shouldBeCached = true,\n  ...options\n}: QueryConfig): (proto: RadiantElement, propertyKey: string | symbol) => void {\n  const cache = new WeakMap<Element, Element | NodeList | null>();\n\n  return (proto: RadiantElement, propertyKey: string | symbol) => {\n    const doQuery = function (this: Element) {\n      if (shouldBeCached) {\n        const cachedResult = cache.get(this);\n        if (cachedResult !== undefined) {\n          return cachedResult;\n        }\n      }\n\n      const selector = 'selector' in options ? options.selector : `[data-ref=\"${options.ref}\"]`;\n      const queryResult = options.all ? this.querySelectorAll(selector) : this.querySelector(selector);\n\n      if (shouldBeCached) {\n        cache.set(this, queryResult);\n      }\n\n      return queryResult;\n    };\n\n    const originalConnectedCallback = proto.connectedCallback;\n\n    proto.connectedCallback = function (this: RadiantElement) {\n      Object.defineProperty(this, propertyKey, {\n        get: doQuery,\n        enumerable: true,\n        configurable: true,\n      });\n\n      originalConnectedCallback.call(this);\n    };\n  };\n}\n"
   ],
-  "mappings": ";AA4CO,SAAS,KAAK;AAAA,EACnB,OAAO,iBAAiB;AAAA,KACrB;AAAA,GAC0E;AAC7E,QAAM,QAAQ,IAAI;AAElB,SAAO,CAAC,OAAuB,gBAAiC;AAC9D,UAAM,kBAAmB,GAAgB;AACvC,UAAI,gBAAgB;AAClB,cAAM,eAAe,MAAM,IAAI,IAAI;AACnC,YAAI,iBAAiB,WAAW;AAC9B,iBAAO;AAAA,QACT;AAAA,MACF;AAEA,YAAM,WAAW,cAAc,UAAU,QAAQ,WAAW,cAAc,QAAQ;AAClF,YAAM,cAAc,QAAQ,MAAM,KAAK,iBAAiB,QAAQ,IAAI,KAAK,cAAc,QAAQ;AAE/F,UAAI,gBAAgB;AAClB,cAAM,IAAI,MAAM,WAAW;AAAA,MAC7B;AAEA,aAAO;AAAA;AAGT,UAAM,4BAA4B,MAAM;AAExC,UAAM,4BAA6B,GAAuB;AACxD,aAAO,eAAe,MAAM,aAAa;AAAA,QACvC,KAAK;AAAA,QACL,YAAY;AAAA,QACZ,cAAc;AAAA,MAChB,CAAC;AAED,gCAA0B,KAAK,IAAI;AAAA;AAAA;AAAA;",
-  "debugId": "E7593899A4A7CB9A64756E2164756E21",
+  "mappings": "",
+  "debugId": "20008E9E16D5D5FB64756E2164756E21",
   "names": []
 }

package/dist/decorators/signal.d.ts

@@ -0,0 +1,23 @@
+import type { StandardOrLegacyFieldDecoratorArgs } from '../types';
+import { type SignalDecoratorOptions } from './legacy/signal';
+export type { SignalDecoratorOptions } from './standard/signal';
+/**
+ * Declares a host-aware writable signal field.
+ *
+ * The decorated member becomes a real `WritableSignal` instance that JSX can
+ * consume directly in child or attribute positions. By default the decorator
+ * creates a host-owned signal, but it can also connect an existing shared
+ * signal through the `source` option or a signal-valued field initializer.
+ *
+ * Connected signals still flow through Radiant's update callback channel so
+ * `@onUpdated(...)` and `this.$.name` bindings continue to work. On
+ * `RadiantComponent`, any signal or store reads performed during `render()`
+ * now participate in rerender invalidation directly, which makes module-level
+ * shared stores a natural fit without prop-bridging them through a second
+ * reactive layer.
+ *
+ * When `hydrate` is provided, SSR host output appends a keyed JSON script so
+ * the client can restore the signal's initial value during hydration.
+ */
+export declare function signal(protoOrTarget: StandardOrLegacyFieldDecoratorArgs['protoOrTarget'], nameOrContext: StandardOrLegacyFieldDecoratorArgs['nameOrContext']): any;
+export declare function signal(options?: SignalDecoratorOptions): any;

package/dist/decorators/signal.js

@@ -0,0 +1,3 @@
+import{ka as a}from"../chunk-c8vqg7r1.js";import"../chunk-t6x9e177.js";import"../chunk-5a2xez36.js";import"../chunk-57w3vmme.js";import"../chunk-8tvt04cm.js";import"../chunk-6z34stya.js";import"../chunk-ksv01cey.js";import"../chunk-8n2dhx28.js";import"../chunk-8xy18qmz.js";export{a as signal};
+
+//# debugId=6DA7522CFED013A964756E2164756E21

package/dist/decorators/signal.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "6DA7522CFED013A964756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/bound.d.ts

@@ -0,0 +1,2 @@
+import type { Method } from '../../types';
+export declare function bound<T extends Method>(_: T, context: ClassMethodDecoratorContext): void;

package/dist/decorators/standard/bound.js

@@ -0,0 +1,3 @@
+import{ya as a}from"../../chunk-xd1xn3vy.js";import"../../chunk-8xy18qmz.js";export{a as bound};
+
+//# debugId=7A69026E97B01CD464756E2164756E21

package/dist/decorators/standard/bound.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "7A69026E97B01CD464756E2164756E21",
+  "names": []
+}

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

@@ -0,0 +1 @@
+export declare function customElement(name: string, options?: ElementDefinitionOptions): <T extends CustomElementConstructor>(_: T, context: ClassDecoratorContext<T>) => void;

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

@@ -0,0 +1,3 @@
+import{Ha as a}from"../../chunk-zj9ez73m.js";import"../../chunk-ms6a9zdt.js";import"../../chunk-8xy18qmz.js";export{a as customElement};
+
+//# debugId=0B86574B12B5327764756E2164756E21

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

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "0B86574B12B5327764756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/debounce.d.ts

@@ -0,0 +1,2 @@
+import type { Method } from '../../types';
+export declare function debounce(timeout: number): Method;

package/dist/decorators/standard/debounce.js

@@ -0,0 +1,3 @@
+import{Ba as a}from"../../chunk-8vak8w5w.js";import"../../chunk-13ydx769.js";import"../../chunk-8xy18qmz.js";export{a as debounce};
+
+//# debugId=55D1AF349670249964756E2164756E21

package/dist/decorators/standard/debounce.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "55D1AF349670249964756E2164756E21",
+  "names": []
+}

package/dist/decorators/standard/event.d.ts

@@ -0,0 +1,9 @@
+import type { RadiantElement } from '../../core/radiant-element';
+import type { EventEmitterConfig } from '../../tools/event-emitter';
+/**
+ * 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.
+ * @see {@link EventEmitter} for more details about how the EventEmitter works.
+ */
+export declare function event(eventConfig: EventEmitterConfig): <T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => void;

package/dist/decorators/standard/event.js

@@ -0,0 +1,3 @@
+import{pa as a}from"../../chunk-k5hr781q.js";import"../../chunk-42tyhfvh.js";import"../../chunk-qbnedp0y.js";import"../../chunk-8xy18qmz.js";export{a as event};
+
+//# debugId=44A9F99057647C9664756E2164756E21