@ecopages/radiant 0.2.0 → 0.3.0-alpha.0

package/dist/decorators/query.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/query.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type {\n  LegacyFieldDecoratorArgs,\n  StandardFieldDecoratorArgs,\n  StandardOrLegacyFieldDecoratorArgs,\n} from '../types';\nimport { query as legacyQuery } from './legacy/query';\nimport { query as standardQuery } from './standard/query';\n\ntype BaseQueryConfig = {\n  all?: boolean;\n  cache?: boolean;\n};\n\ntype QueryBySelector = { selector: string };\n\ntype QueryByRef = { ref: string };\n\nexport type QueryConfig = BaseQueryConfig & (QueryBySelector | QueryByRef);\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 * It cache the result by default, but it can be configured to not cache it.\n * @param options {@link QueryConfig} The options for the reactive property.\n */\nexport function query<T extends Element | Element[]>(options: QueryConfig) {\n  return function (\n    protoOrTarget: StandardOrLegacyFieldDecoratorArgs['protoOrTarget'],\n    nameOrContext: StandardOrLegacyFieldDecoratorArgs['nameOrContext'],\n  ): any {\n    if (typeof nameOrContext === 'object') {\n      return standardQuery(options)(\n        protoOrTarget as StandardFieldDecoratorArgs['protoOrTarget'],\n        nameOrContext as StandardFieldDecoratorArgs<HTMLElement, Element | Element[]>['nameOrContext'],\n      );\n    }\n    return legacyQuery<T>(options)(\n      protoOrTarget as LegacyFieldDecoratorArgs['protoOrTarget'],\n      nameOrContext as LegacyFieldDecoratorArgs['nameOrContext'],\n    );\n  };\n}\n"
   ],
-  "mappings": "oFAyBO,GAAS,CAAoC,CAAC,EAAsB,CACzE,eAAgB,CACd,EACA,EACK,CACL,UAAW,IAAkB,SAC3B,OAAO,EAAc,CAAO,EAC1B,EACA,CACF,EAEF,OAAO,EAAe,CAAO,EAC3B,EACA,CACF",
-  "debugId": "0DD98124DFF9C20D64756E2164756E21",
+  "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.js

@@ -1,4 +1,3 @@
-function o(i,t){const e=String(t.name);if(t.private)throw new Error(`'bound' cannot decorate private properties like ${e}.`);t.addInitializer(function(){this[e]=this[e].bind(this)})}export{o as bound};
-export{o as b};
+import{ya as a}from"../../chunk-xd1xn3vy.js";import"../../chunk-8xy18qmz.js";export{a as bound};
 
-//# debugId=5E969AAAFC48310564756E2164756E21
+//# debugId=7A69026E97B01CD464756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/standard/bound.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { Method } from '../../types';\n\nexport function bound<T extends Method>(_: T, context: ClassMethodDecoratorContext) {\n  const methodName = String(context.name);\n  if (context.private) {\n    throw new Error(`'bound' cannot decorate private properties like ${methodName as string}.`);\n  }\n  context.addInitializer(function (this: any) {\n    this[methodName] = this[methodName].bind(this);\n  });\n}\n"
   ],
-  "mappings": "AAEO,SAAS,CAAuB,CAAC,EAAM,EAAsC,CAClF,MAAM,EAAa,OAAO,EAAQ,IAAI,EACtC,GAAI,EAAQ,QACV,MAAM,IAAI,MAAM,mDAAmD,IAAuB,EAE5F,EAAQ,uBAAwB,EAAY,CAC1C,KAAK,GAAc,KAAK,GAAY,KAAK,IAAI,EAC9C",
-  "debugId": "5E969AAAFC48310564756E2164756E21",
+  "mappings": "",
+  "debugId": "7A69026E97B01CD464756E2164756E21",
   "names": []
 }

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

@@ -1,4 +1,3 @@
-function i(t,n){return function(o,e){e.addInitializer(function(){if(!window.customElements.get(t))customElements.define(t,this,n)})}}export{i as customElement};
-export{i as y};
+import{Ha as a}from"../../chunk-zj9ez73m.js";import"../../chunk-ms6a9zdt.js";import"../../chunk-8xy18qmz.js";export{a as customElement};
 
-//# debugId=E1F3CF85FE4BDE1464756E2164756E21
+//# debugId=0B86574B12B5327764756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/standard/custom-element.ts"],
+  "sources": [],
   "sourcesContent": [
-    "export function customElement(name: string, options?: ElementDefinitionOptions) {\n  return function <T extends CustomElementConstructor>(_: T, context: ClassDecoratorContext<T>) {\n    context.addInitializer(function () {\n      if (!window.customElements.get(name)) {\n        customElements.define(name, this, options);\n      }\n    });\n  };\n}\n"
   ],
-  "mappings": "AAAO,SAAS,CAAa,CAAC,EAAc,EAAoC,CAC9E,eAAoD,CAAC,EAAM,EAAmC,CAC5F,EAAQ,uBAAwB,EAAG,CACjC,IAAK,OAAO,eAAe,IAAI,CAAI,EACjC,eAAe,OAAO,EAAM,KAAM,CAAO,EAE5C",
-  "debugId": "E1F3CF85FE4BDE1464756E2164756E21",
+  "mappings": "",
+  "debugId": "0B86574B12B5327764756E2164756E21",
   "names": []
 }

package/dist/decorators/standard/debounce.js

@@ -1,4 +1,3 @@
-function o(n){let e=null;return(t)=>{return function(...u){if(e!==null)clearTimeout(e);return e=setTimeout(()=>{t.apply(this,u)},n),t}}}export{o as debounce};
-export{o as D};
+import{Ba as a}from"../../chunk-8vak8w5w.js";import"../../chunk-13ydx769.js";import"../../chunk-8xy18qmz.js";export{a as debounce};
 
-//# debugId=DF32024986E9C26864756E2164756E21
+//# debugId=55D1AF349670249964756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/standard/debounce.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { Method } from '../../types';\n\nexport function debounce(timeout: number): Method {\n  let timeoutRef: ReturnType<typeof setTimeout> | null = null;\n\n  return <T extends Method>(originalMethod: T): Method => {\n    return function (this: any, ...args: any[]): T {\n      if (timeoutRef !== null) {\n        clearTimeout(timeoutRef);\n      }\n\n      timeoutRef = setTimeout(() => {\n        originalMethod.apply(this, args);\n      }, timeout);\n\n      return originalMethod;\n    };\n  };\n}\n"
   ],
-  "mappings": "AAEO,SAAS,CAAQ,CAAC,EAAyB,CAChD,IAAI,EAAmD,KAEvD,MAAO,CAAmB,IAA8B,CACtD,eAAgB,IAAe,EAAgB,CAC7C,GAAI,IAAe,KACjB,aAAa,CAAU,EAOzB,OAJA,EAAa,WAAW,IAAM,CAC5B,EAAe,MAAM,KAAM,CAAI,GAC9B,CAAO,EAEH",
-  "debugId": "DF32024986E9C26864756E2164756E21",
+  "mappings": "",
+  "debugId": "55D1AF349670249964756E2164756E21",
   "names": []
 }

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

@@ -1,5 +1,5 @@
 import type { RadiantElement } from '../../core/radiant-element';
-import { type EventEmitterConfig } from '../../tools/event-emitter';
+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.

package/dist/decorators/standard/event.js

@@ -1,4 +1,3 @@
-import{U as z}from"../../tools/event-emitter.js";function F(j){return function(A,q){q.addInitializer(function(){this.registerEventEmitter(j.name,new z(this,j)),Object.defineProperty(this,q.name,{get(){return this.eventEmitters.get(j.name)},enumerable:!0,configurable:!0})})}}export{F as event};
-export{F as T};
+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=60C8B5654FFB2E2B64756E2164756E21
+//# debugId=44A9F99057647C9664756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/standard/event.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '../../core/radiant-element';\nimport { EventEmitter, type EventEmitterConfig } from '../../tools/event-emitter';\n\n/**\n * Decorator that attaches an EventEmitter to the class field property.\n * The EventEmitter can be used to dispatch custom events from the target element.\n * @param eventConfig Configuration for the event emitter.\n * @see {@link EventEmitter} for more details about how the EventEmitter works.\n */\nexport function event(eventConfig: EventEmitterConfig) {\n  return function <T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) {\n    context.addInitializer(function (this: T) {\n      this.registerEventEmitter(eventConfig.name, new EventEmitter(this, eventConfig));\n\n      Object.defineProperty(this, context.name, {\n        get() {\n          return this.eventEmitters.get(eventConfig.name);\n        },\n        enumerable: true,\n        configurable: true,\n      });\n    });\n  };\n}\n"
   ],
-  "mappings": "iDASO,SAAS,CAAK,CAAC,EAAiC,CACrD,eAA6C,CAAC,EAAc,EAA2C,CACrG,EAAQ,uBAAwB,EAAU,CACxC,KAAK,qBAAqB,EAAY,KAAM,IAAI,EAAa,KAAM,CAAW,CAAC,EAE/E,OAAO,eAAe,KAAM,EAAQ,KAAM,CACxC,GAAG,EAAG,CACJ,OAAO,KAAK,cAAc,IAAI,EAAY,IAAI,GAEhD,WAAY,GACZ,aAAc,EAChB,CAAC,EACF",
-  "debugId": "60C8B5654FFB2E2B64756E2164756E21",
+  "mappings": "",
+  "debugId": "44A9F99057647C9664756E2164756E21",
   "names": []
 }

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

@@ -1,14 +1,5 @@
-import type { RadiantElementEventListener } from '../../core/radiant-element';
+import type { OnEventConfig } from '../on-event';
 import type { Method } from '../../types';
-type OnEventConfig = Pick<RadiantElementEventListener, 'type' | 'options'> & ({
-    selector: string;
-} | {
-    ref: string;
-} | {
-    window: boolean;
-} | {
-    document: boolean;
-});
 /**
  * A decorator to subscribe to an event on the target element.
  * The event listener will be automatically unsubscribed when the element is disconnected.
@@ -24,4 +15,3 @@ type OnEventConfig = Pick<RadiantElementEventListener, 'type' | 'options'> & ({
  * @param eventConfig.options Optional. An options object that specifies characteristics about the event listener.
  */
 export declare function onEvent(eventConfig: OnEventConfig): <T extends Method>(originalMethod: T, context: ClassMethodDecoratorContext) => void;
-export {};

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

@@ -1,4 +1,3 @@
-function G(q){return function(D,E){E.addInitializer(function(){const z=D.bind(this);if("window"in q)window.addEventListener(q.type,z,q.options),this.registerCleanupCallback(()=>{window.removeEventListener(q.type,z,q.options)});if("document"in q)document.addEventListener(q.type,z,q.options),this.registerCleanupCallback(()=>{document.removeEventListener(q.type,z,q.options)});const B="selector"in q?q.selector:("ref"in q)&&`[data-ref="${q.ref}"]`;if(B)this.subscribeEvent({selector:B,type:q.type,listener:z,options:q?.options??void 0})})}}export{G as onEvent};
-export{G as Q};
+import{Ka as a}from"../../chunk-aajhkdmn.js";import"../../chunk-nw171z6m.js";import"../../chunk-8xy18qmz.js";export{a as onEvent};
 
-//# debugId=5CF41968C454A83F64756E2164756E21
+//# debugId=1CE0D0BAC2B43DEF64756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/standard/on-event.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement, RadiantElementEventListener } from '../../core/radiant-element';\nimport type { Method } from '../../types';\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 function <T extends Method>(originalMethod: T, context: ClassMethodDecoratorContext): void {\n    context.addInitializer(function (this: any) {\n      const boundMethod = originalMethod.bind(this);\n\n      if ('window' in eventConfig) {\n        window.addEventListener(eventConfig.type, boundMethod, eventConfig.options);\n        (this as RadiantElement).registerCleanupCallback(() => {\n          window.removeEventListener(eventConfig.type, boundMethod, eventConfig.options);\n        });\n      }\n\n      if ('document' in eventConfig) {\n        document.addEventListener(eventConfig.type, boundMethod, eventConfig.options);\n        (this as RadiantElement).registerCleanupCallback(() => {\n          document.removeEventListener(eventConfig.type, boundMethod, eventConfig.options);\n        });\n      }\n\n      const selector =\n        'selector' in eventConfig ? eventConfig.selector : 'ref' in eventConfig && `[data-ref=\"${eventConfig.ref}\"]`;\n\n      if (selector) {\n        (this as RadiantElement).subscribeEvent({\n          selector: selector,\n          type: eventConfig.type,\n          listener: boundMethod,\n          options: eventConfig?.options ?? undefined,\n        });\n      }\n    });\n  };\n}\n"
   ],
-  "mappings": "AAiCO,SAAS,CAAO,CAAC,EAA4B,CAClD,eAAkC,CAAC,EAAmB,EAA4C,CAChG,EAAQ,uBAAwB,EAAY,CAC1C,MAAM,EAAc,EAAe,KAAK,IAAI,EAE5C,GAAI,WAAY,EACd,OAAO,iBAAiB,EAAY,KAAM,EAAa,EAAY,OAAO,EACzE,KAAwB,wBAAwB,IAAM,CACrD,OAAO,oBAAoB,EAAY,KAAM,EAAa,EAAY,OAAO,EAC9E,EAGH,GAAI,aAAc,EAChB,SAAS,iBAAiB,EAAY,KAAM,EAAa,EAAY,OAAO,EAC3E,KAAwB,wBAAwB,IAAM,CACrD,SAAS,oBAAoB,EAAY,KAAM,EAAa,EAAY,OAAO,EAChF,EAGH,MAAM,EACJ,aAAc,EAAc,EAAY,UAAW,QAAS,IAAe,cAAc,EAAY,QAEvG,GAAI,EACF,AAAC,KAAwB,eAAe,CACtC,SAAU,EACV,KAAM,EAAY,KAClB,SAAU,EACV,QAAS,GAAa,SAAW,MACnC,CAAC,EAEJ",
-  "debugId": "5CF41968C454A83F64756E2164756E21",
+  "mappings": "",
+  "debugId": "1CE0D0BAC2B43DEF64756E2164756E21",
   "names": []
 }

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

@@ -1,4 +1,3 @@
-function n(i){return function(e,t){t.addInitializer(function(){if(this[t.name]=this[t.name].bind(this),Array.isArray(i))for(let a of i)this.registerUpdateCallback(a,this[t.name]);else if(typeof i==="string")this.registerUpdateCallback(i,this[t.name])})}}export{n as onUpdated};
-export{n as X};
+import{Ea as a}from"../../chunk-qdj6r8jn.js";import"../../chunk-8xy18qmz.js";export{a as onUpdated};
 
-//# debugId=1B72F69206926A9C64756E2164756E21
+//# debugId=6E66A90072456F1164756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/standard/on-updated.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '../../core/radiant-element';\nimport type { Method } from '../../types';\n\nexport function onUpdated(keyOrKeys: string | string[]) {\n  return function <T extends Method>(_: T, context: ClassMethodDecoratorContext): void {\n    context.addInitializer(function (this: any) {\n      this[context.name] = this[context.name].bind(this);\n      if (Array.isArray(keyOrKeys)) {\n        for (const key of keyOrKeys) {\n          (this as RadiantElement).registerUpdateCallback(key, this[context.name]);\n        }\n      } else if (typeof keyOrKeys === 'string') {\n        (this as RadiantElement).registerUpdateCallback(keyOrKeys, this[context.name]);\n      }\n    });\n  };\n}\n"
   ],
-  "mappings": "AAGO,SAAS,CAAS,CAAC,EAA8B,CACtD,eAAkC,CAAC,EAAM,EAA4C,CACnF,EAAQ,uBAAwB,EAAY,CAE1C,GADA,KAAK,EAAQ,MAAQ,KAAK,EAAQ,MAAM,KAAK,IAAI,EAC7C,MAAM,QAAQ,CAAS,EACzB,QAAW,KAAO,EAChB,AAAC,KAAwB,uBAAuB,EAAK,KAAK,EAAQ,KAAK,iBAEzD,IAAc,SAC9B,AAAC,KAAwB,uBAAuB,EAAW,KAAK,EAAQ,KAAK,EAEhF",
-  "debugId": "1B72F69206926A9C64756E2164756E21",
+  "mappings": "",
+  "debugId": "6E66A90072456F1164756E2164756E21",
   "names": []
 }

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

@@ -0,0 +1,8 @@
+import type { QuerySlotConfig } from '../query-slot';
+type SlotQueryHost = HTMLElement & {
+    getSlotElement<T extends Element = Element>(name?: string): T | null;
+    getSlotElements<T extends Element = Element>(name?: string): T[];
+    slotProjectionVersion?: number;
+};
+export declare function querySlot(options?: QuerySlotConfig): <T extends SlotQueryHost, V extends Element | Element[]>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => void;
+export {};

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

@@ -0,0 +1,3 @@
+import{ba as a}from"../../chunk-bmhn4nbp.js";import"../../chunk-qd28hvdx.js";import"../../chunk-8xy18qmz.js";export{a as querySlot};
+
+//# debugId=ECBF886B4487E02764756E2164756E21

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

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

package/dist/decorators/standard/query.js

@@ -1,4 +1,3 @@
-function o(e){return function(s,t){const n=String(t.name),r=Symbol(`__${String(n)}__cache`),l="selector"in e?e.selector:`[data-ref="${e.ref}"]`,i=(u)=>{let c=[];if(e?.all){const a=u.querySelectorAll(l);return c=a.length?Array.from(a):[],c}return u.querySelector(l)};t.addInitializer(function(){Object.defineProperty(this,n,{get(){if(e?.cache){if(!this[r]||e?.all&&!this[r].length)this[r]=i(this);return this[r]}return i(this)},enumerable:!0,configurable:!0})})}}export{o as query};
-export{o as v};
+import{ja as a}from"../../chunk-scfk041e.js";import"../../chunk-g0gz7ypq.js";import"../../chunk-8xy18qmz.js";export{a as query};
 
-//# debugId=D06D9FAD60782C4364756E2164756E21
+//# debugId=6E6550A38865ECFB64756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/standard/query.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { QueryConfig } from '../query';\n\nexport function query(options: QueryConfig) {\n  return function <T extends HTMLElement, V extends Element | Element[]>(\n    _: undefined,\n    context: ClassFieldDecoratorContext<T, V>,\n  ) {\n    const propertyName = String(context.name);\n    const privatePropertyKey = Symbol(`__${String(propertyName)}__cache`);\n\n    const selector = 'selector' in options ? options.selector : `[data-ref=\"${options.ref}\"]`;\n\n    const executeQuery = (instance: T) => {\n      let result: V | V[] = [];\n      if (options?.all) {\n        const queried = instance.querySelectorAll(selector);\n        result = queried.length ? (Array.from(queried) as V) : [];\n        return result;\n      }\n\n      return instance.querySelector(selector);\n    };\n\n    context.addInitializer(function (this: T) {\n      Object.defineProperty(this, propertyName, {\n        get() {\n          if (options?.cache) {\n            if (!this[privatePropertyKey] || (options?.all && !this[privatePropertyKey].length)) {\n              this[privatePropertyKey] = executeQuery(this);\n            }\n            return this[privatePropertyKey];\n          }\n          return executeQuery(this) as V;\n        },\n        enumerable: true,\n        configurable: true,\n      });\n    });\n  };\n}\n"
   ],
-  "mappings": "AAEO,SAAS,CAAK,CAAC,EAAsB,CAC1C,eAAsE,CACpE,EACA,EACA,CACA,MAAM,EAAe,OAAO,EAAQ,IAAI,EAClC,EAAqB,OAAO,KAAK,OAAO,CAAY,UAAU,EAE9D,EAAW,aAAc,EAAU,EAAQ,SAAW,cAAc,EAAQ,QAE5E,EAAe,CAAC,IAAgB,CACpC,IAAI,EAAkB,CAAC,EACvB,GAAI,GAAS,IAAK,CAChB,MAAM,EAAU,EAAS,iBAAiB,CAAQ,EAElD,OADA,EAAS,EAAQ,OAAU,MAAM,KAAK,CAAO,EAAU,CAAC,EACjD,EAGT,OAAO,EAAS,cAAc,CAAQ,GAGxC,EAAQ,uBAAwB,EAAU,CACxC,OAAO,eAAe,KAAM,EAAc,CACxC,GAAG,EAAG,CACJ,GAAI,GAAS,MAAO,CAClB,IAAK,KAAK,IAAwB,GAAS,MAAQ,KAAK,GAAoB,OAC1E,KAAK,GAAsB,EAAa,IAAI,EAE9C,OAAO,KAAK,GAEd,OAAO,EAAa,IAAI,GAE1B,WAAY,GACZ,aAAc,EAChB,CAAC,EACF",
-  "debugId": "D06D9FAD60782C4364756E2164756E21",
+  "mappings": "",
+  "debugId": "6E6550A38865ECFB64756E2164756E21",
   "names": []
 }

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

@@ -1,4 +1,3 @@
-function o(a,e){const n=Symbol(`__${String(e.name)}__value`),r=String(e.name);return e.addInitializer(function(){Object.defineProperty(this,e.name,{get(){return this[n]},set(t){const i=this[n];if(i!==t)this[n]=t,this.notifyUpdate(r,i,t)},enumerable:!0,configurable:!0})}),function(t){return this[n]=t,t}}export{o as reactiveField};
-export{o as B};
+import{va as a}from"../../chunk-paehjz94.js";import"../../chunk-8xy18qmz.js";export{a as reactiveField};
 
-//# debugId=6D2C82AC75BF57FA64756E2164756E21
+//# debugId=60DDF85D2820FBCB64756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/standard/reactive-field.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '../../core/radiant-element';\n\nexport function reactiveField<T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) {\n  const privatePropertyKey = Symbol(`__${String(context.name)}__value`);\n\n  const contextName = String(context.name);\n\n  context.addInitializer(function (this: T) {\n    Object.defineProperty(this, context.name, {\n      get() {\n        return this[privatePropertyKey];\n      },\n      set(newValue: unknown) {\n        const oldValue = this[privatePropertyKey];\n        if (oldValue !== newValue) {\n          this[privatePropertyKey] = newValue;\n          (this as RadiantElement).notifyUpdate(contextName, oldValue, newValue);\n        }\n      },\n      enumerable: true,\n      configurable: true,\n    });\n  });\n\n  return function (this: T, value: V) {\n    (this as any)[privatePropertyKey] = value;\n    return value;\n  };\n}\n"
   ],
-  "mappings": "AAEO,SAAS,CAA0C,CAAC,EAAc,EAA2C,CAClH,MAAM,EAAqB,OAAO,KAAK,OAAO,EAAQ,IAAI,UAAU,EAE9D,EAAc,OAAO,EAAQ,IAAI,EAmBvC,OAjBA,EAAQ,uBAAwB,EAAU,CACxC,OAAO,eAAe,KAAM,EAAQ,KAAM,CACxC,GAAG,EAAG,CACJ,OAAO,KAAK,IAEd,GAAG,CAAC,EAAmB,CACrB,MAAM,EAAW,KAAK,GACtB,GAAI,IAAa,EACf,KAAK,GAAsB,EAC1B,KAAwB,aAAa,EAAa,EAAU,CAAQ,GAGzE,WAAY,GACZ,aAAc,EAChB,CAAC,EACF,UAEe,CAAU,EAAU,CAElC,OADC,KAAa,GAAsB,EAC7B",
-  "debugId": "6D2C82AC75BF57FA64756E2164756E21",
+  "mappings": "",
+  "debugId": "60DDF85D2820FBCB64756E2164756E21",
   "names": []
 }

package/dist/decorators/standard/reactive-prop.d.ts

@@ -1,2 +1,2 @@
 import type { RadiantElement, ReactivePropertyOptions } from '../../core/radiant-element.js';
-export declare function reactiveProp<P = unknown>({ type, attribute, reflect, defaultValue }: ReactivePropertyOptions<P>): <T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => void;
+export declare function reactiveProp<P = unknown>({ type, attribute, reflect, defaultValue, bind, }: ReactivePropertyOptions<P>): <T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => (this: T, value: V) => V;

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

@@ -1,4 +1,3 @@
-function p({type:n,attribute:i,reflect:r,defaultValue:a}){return function(c,t){const e=String(t.name),o=i??e;t.addInitializer(function(){this.createReactiveProp(e,{type:n,reflect:r,attribute:o,defaultValue:a})})}}export{p as reactiveProp};
-export{p as N};
+import{ea as a}from"../../chunk-dscj0sk9.js";import"../../chunk-8dexhy6c.js";import"../../chunk-73x7jpdd.js";import"../../chunk-8xy18qmz.js";export{a as reactiveProp};
 
-//# debugId=BFD78D04A8E9585464756E2164756E21
+//# debugId=0EABDF8EE7B254AC64756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/decorators/standard/reactive-prop.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement, ReactivePropertyOptions } from '../../core/radiant-element.js';\n\nexport function reactiveProp<P = unknown>({ type, attribute, reflect, defaultValue }: ReactivePropertyOptions<P>) {\n  return function <T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) {\n    const propertyName = String(context.name);\n    const attributeKey = attribute ?? propertyName;\n\n    context.addInitializer(function (this: T) {\n      this.createReactiveProp(propertyName, { type, reflect, attribute: attributeKey, defaultValue });\n    });\n  };\n}\n"
   ],
-  "mappings": "AAEO,SAAS,CAAyB,EAAG,OAAM,YAAW,UAAS,gBAA4C,CAChH,eAA6C,CAAC,EAAc,EAA2C,CACrG,MAAM,EAAe,OAAO,EAAQ,IAAI,EAClC,EAAe,GAAa,EAElC,EAAQ,uBAAwB,EAAU,CACxC,KAAK,mBAAmB,EAAc,CAAE,OAAM,UAAS,UAAW,EAAc,cAAa,CAAC,EAC/F",
-  "debugId": "BFD78D04A8E9585464756E2164756E21",
+  "mappings": "",
+  "debugId": "0EABDF8EE7B254AC64756E2164756E21",
   "names": []
 }

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

@@ -0,0 +1,33 @@
+import type { WritableSignal } from '@ecopages/signals';
+import type { RadiantElement, ReactiveBindingOption } from '../../core/radiant-element';
+import type { AttributeTypeConstant } from '../../utils/attribute-utils';
+/** Options for the `@signal` decorator. */
+export type SignalDecoratorOptions<Value = unknown> = {
+    /**
+     * Exposes a JSX binding companion for the decorated signal.
+     *
+     * - `true` creates a `$propertyName` accessor.
+     * - a string creates a custom accessor with that name.
+     * - `undefined` defers to the host default.
+     */
+    bind?: ReactiveBindingOption;
+    /**
+     * Optional initial value used when the field does not provide one directly.
+     *
+     * This is primarily useful with `declare field: WritableSignal<T>` syntax,
+     * which keeps the component surface clean while still letting the decorator
+     * own signal construction.
+     */
+    initial?: Value;
+    /**
+     * Connects an existing writable signal to the host instead of creating a
+     * host-owned one.
+     */
+    source?: WritableSignal<Value> | ((host: RadiantElement) => WritableSignal<Value>);
+    /**
+     * Serializes the current signal value into a keyed hydration script during
+     * SSR and restores it on the client.
+     */
+    hydrate?: AttributeTypeConstant;
+};
+export declare function signal<Value = unknown>(options?: SignalDecoratorOptions<Value>): <T extends RadiantElement, Value_1>(_: undefined, context: ClassFieldDecoratorContext<T, unknown>) => (this: T, initialValue: Value_1) => WritableSignal<Value_1>;

package/dist/decorators/standard/signal.js

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

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

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

package/dist/decorators/state.d.ts

@@ -0,0 +1,11 @@
+import type { StandardOrLegacyFieldDecoratorArgs } from '../types';
+/**
+ * Declares internal mutable component state.
+ *
+ * Each write triggers `notifyUpdate` so update callbacks, bindings, and
+ * `RadiantComponent` renders stay in sync. When no explicit binding option
+ * is supplied, `RadiantComponent` hosts expose a JSX companion binding
+ * accessor automatically while plain `RadiantElement` hosts keep binding
+ * opt-in.
+ */
+export declare function state(protoOrTarget: StandardOrLegacyFieldDecoratorArgs['protoOrTarget'], nameOrContext: StandardOrLegacyFieldDecoratorArgs['nameOrContext']): any;

package/dist/decorators/state.js

@@ -0,0 +1,3 @@
+import{ta as a}from"../chunk-4fqkmpra.js";import"../chunk-t7a1bbxq.js";import"../chunk-paehjz94.js";import"../chunk-8tvt04cm.js";import"../chunk-nerd6fmg.js";import"../chunk-8xy18qmz.js";export{a as state};
+
+//# debugId=376024D3AC8A771964756E2164756E21

package/dist/decorators/state.js.map

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

package/dist/helpers/create-event-listener.d.ts

@@ -0,0 +1,28 @@
+import type { RadiantElement } from '../core/radiant-element';
+import type { RadiantElementEventListener } from '../core/radiant-element';
+/**
+ * Selects which DOM tree delegated event listeners should observe.
+ */
+export type OnEventScope = 'light' | 'shadow' | 'both';
+type BaseOnEventConfig = Pick<RadiantElementEventListener, 'type' | 'options'> & {
+    scope?: OnEventScope;
+};
+export type OnEventConfig = BaseOnEventConfig & ({
+    selector: string;
+} | {
+    ref: string;
+} | {
+    window: true;
+} | {
+    document: true;
+});
+/**
+ * Subscribes to a DOM event with delegation, window, or document targeting.
+ * Functional equivalent of the `@onEvent` decorator for vanilla JS usage.
+ * Returns a cleanup function to remove the listener.
+ * @param host The host RadiantElement.
+ * @param config The event listener configuration.
+ * @param callback The event handler function.
+ */
+export declare function createEventListener(host: RadiantElement, config: OnEventConfig, callback: (event: Event) => void): () => void;
+export {};

package/dist/helpers/create-event-listener.js

@@ -0,0 +1,3 @@
+import{tb as a}from"../chunk-nw171z6m.js";import"../chunk-8xy18qmz.js";export{a as createEventListener};
+
+//# debugId=01C2154F53A8DE8F64756E2164756E21

package/dist/helpers/create-event-listener.js.map

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

package/dist/helpers/create-event.d.ts

@@ -0,0 +1,9 @@
+import type { RadiantElement } from '../core/radiant-element';
+import { EventEmitter, type EventEmitterConfig } from '../tools/event-emitter';
+/**
+ * Creates an EventEmitter bound to a host element and registers it on the host.
+ * Functional equivalent of the `@event` decorator for vanilla JS usage.
+ * @param host The host element that will dispatch the events.
+ * @param config {@link EventEmitterConfig} The event emitter configuration.
+ */
+export declare function createEvent<T = unknown>(host: RadiantElement, config: EventEmitterConfig): EventEmitter<T>;

package/dist/helpers/create-event.js

@@ -0,0 +1,3 @@
+import{ob as a}from"../chunk-42tyhfvh.js";import"../chunk-qbnedp0y.js";import"../chunk-8xy18qmz.js";export{a as createEvent};
+
+//# debugId=1463A20FBFE4872164756E2164756E21

package/dist/helpers/create-event.js.map

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

package/dist/helpers/create-query-slot.d.ts

@@ -0,0 +1,20 @@
+export type QuerySlotConfig = {
+    all?: boolean;
+    cache?: boolean;
+    name?: string;
+};
+type SlotQueryHost = HTMLElement & {
+    getSlotElement<T extends Element = Element>(name?: string): T | null;
+    getSlotElements<T extends Element = Element>(name?: string): T[];
+};
+type QuerySlotResult<T extends Element | Element[]> = {
+    get value(): T | null;
+};
+/**
+ * Creates a lazy slot query accessor bound to a host element.
+ * Functional equivalent of the `@querySlot` decorator for vanilla JS usage.
+ * @param host The host element to query slots within.
+ * @param options {@link QuerySlotConfig} The slot query configuration.
+ */
+export declare function createQuerySlot<T extends Element | Element[] = Element>(host: SlotQueryHost, options?: QuerySlotConfig): QuerySlotResult<T>;
+export {};

package/dist/helpers/create-query-slot.js

@@ -0,0 +1,3 @@
+import{rb as a}from"../chunk-qd28hvdx.js";import"../chunk-8xy18qmz.js";export{a as createQuerySlot};
+
+//# debugId=B3214DFAE4E3C8F564756E2164756E21

package/dist/helpers/create-query-slot.js.map

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

package/dist/helpers/create-query.d.ts

@@ -0,0 +1,27 @@
+type BaseQueryConfig = {
+    all?: boolean;
+    cache?: boolean;
+    scope?: QueryScope;
+};
+type QueryBySelector = {
+    selector: string;
+};
+type QueryByRef = {
+    ref: string;
+};
+/**
+ * Selects which DOM tree a query should read from.
+ */
+export type QueryScope = 'light' | 'shadow' | 'both';
+export type QueryConfig = BaseQueryConfig & (QueryBySelector | QueryByRef);
+type QueryResult<T extends Element | Element[]> = {
+    get value(): T | null;
+};
+/**
+ * Creates a lazy DOM query accessor bound to a host element.
+ * Functional equivalent of the `@query` decorator for vanilla JS usage.
+ * @param host The host element to query within.
+ * @param options {@link QueryConfig} The query configuration.
+ */
+export declare function createQuery<T extends Element | Element[] = Element>(host: HTMLElement, options: QueryConfig): QueryResult<T>;
+export {};

package/dist/helpers/create-query.js

@@ -0,0 +1,3 @@
+import{sb as a}from"../chunk-g0gz7ypq.js";import"../chunk-8xy18qmz.js";export{a as createQuery};
+
+//# debugId=3C84805D88DEA21764756E2164756E21

package/dist/helpers/create-query.js.map

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