@ecopages/radiant 0.2.0 → 0.3.0-alpha.1

package/dist/context/decorators/context-selector.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/decorators/context-selector.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type {\n  LegacyMethodDecoratorArgs,\n  StandardMethodDecoratorArgs,\n  StandardOrLegacyMethodDecoratorArgs,\n} from '../../types';\nimport type { Context, UnknownContext } from '../types';\nimport { contextSelector as legacyContextSelector } from './legacy/context-selector';\nimport { contextSelector as standardContextSelector } from './standard/context-selector';\n\nexport type SubscribeToContextOptions<T extends UnknownContext> = {\n  context: T;\n  select?: (context: T['__context__']) => unknown;\n  subscribe?: boolean;\n};\n\n/**\n * A decorator to subscribe to a context selector.\n * @param option {@link SubscribeToContextOptions}\n * @returns\n */\nexport function contextSelector<T extends Context<unknown, unknown>>(options: SubscribeToContextOptions<T>) {\n  return function (\n    protoOrTarget: StandardOrLegacyMethodDecoratorArgs['protoOrTarget'],\n    nameOrContext: StandardOrLegacyMethodDecoratorArgs['nameOrContext'],\n    descriptor?: StandardOrLegacyMethodDecoratorArgs['descriptor'],\n  ): any {\n    if (typeof nameOrContext === 'object') {\n      return standardContextSelector(options)(\n        protoOrTarget as StandardMethodDecoratorArgs['protoOrTarget'],\n        nameOrContext as StandardMethodDecoratorArgs['nameOrContext'],\n      );\n    }\n    return legacyContextSelector(options)(\n      protoOrTarget as LegacyMethodDecoratorArgs['protoOrTarget'],\n      nameOrContext as LegacyMethodDecoratorArgs['nameOrContext'],\n      descriptor as LegacyMethodDecoratorArgs['descriptor'],\n    );\n  };\n}\n"
   ],
-  "mappings": "mIAoBO,YAAS,ZAAoD,CAAC,EAAuC,CAC1G,eAAgB,CACd,EACA,EACA,EACK,CACL,UAAW,IAAkB,SAC3B,OAAO,EAAwB,CAAO,EACpC,EACA,CACF,EAEF,OAAO,EAAsB,CAAO,EAClC,EACA,EACA,CACF",
-  "debugId": "0C0E19D0A850DDF264756E2164756E21",
+  "mappings": "",
+  "debugId": "DACE64961DE0094664756E2164756E21",
   "names": []
 }

package/dist/context/decorators/legacy/consume-context.d.ts

@@ -1,3 +1,3 @@
 import type { RadiantElement } from '../../../core/radiant-element';
 import type { UnknownContext } from '../../types';
-export declare function consumeContext(contextToProvide: UnknownContext): (proto: RadiantElement, propertyKey: string) => void;
+export declare function consumeContext(context: UnknownContext): (proto: RadiantElement, propertyKey: string) => void;

package/dist/context/decorators/legacy/consume-context.js

@@ -1,4 +1,3 @@
-import{p as e}from"../../events.js";function l(t){return(n,a)=>{const o=n.connectedCallback;n.connectedCallback=function(){o.call(this),this.dispatchEvent(new e(t,(c)=>{this[a]=c,this.connectedContextCallback(t)}))}}}export{l as consumeContext};
-export{l as g};
+import{u as a}from"../../../chunk-nctznxyz.js";import"../../../chunk-p8k4g99a.js";import"../../../chunk-ek664x1c.js";import"../../../chunk-kmebacvv.js";import"../../../chunk-eyw14d6y.js";import"../../../chunk-cnyxrh9r.js";import"../../../chunk-t8xtvgyg.js";import"../../../chunk-vgtggzb6.js";export{a as consumeContext};
 
-//# debugId=AA1F233D69B2F67764756E2164756E21
+//# debugId=9B9AD8FB3D9B006D64756E2164756E21

package/dist/context/decorators/legacy/consume-context.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/decorators/legacy/consume-context.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '../../../core/radiant-element';\nimport { ContextRequestEvent } from '../../events';\nimport type { UnknownContext } from '../../types';\n\nexport function consumeContext(contextToProvide: UnknownContext) {\n  return (proto: RadiantElement, propertyKey: string) => {\n    const originalConnectedCallback = proto.connectedCallback;\n\n    proto.connectedCallback = function (this: RadiantElement) {\n      originalConnectedCallback.call(this);\n      this.dispatchEvent(\n        new ContextRequestEvent(contextToProvide, (context) => {\n          (this as any)[propertyKey] = context;\n          this.connectedContextCallback(contextToProvide);\n        }),\n      );\n    };\n  };\n}\n"
   ],
-  "mappings": "oCAIO,SAAS,CAAc,CAAC,EAAkC,CAC/D,MAAO,CAAC,EAAuB,IAAwB,CACrD,MAAM,EAA4B,EAAM,kBAExC,EAAM,0BAA6B,EAAuB,CACxD,EAA0B,KAAK,IAAI,EACnC,KAAK,cACH,IAAI,EAAoB,EAAkB,CAAC,IAAY,CACrD,AAAC,KAAa,GAAe,EAC7B,KAAK,yBAAyB,CAAgB,EAC/C,CACH",
-  "debugId": "AA1F233D69B2F67764756E2164756E21",
+  "mappings": "",
+  "debugId": "9B9AD8FB3D9B006D64756E2164756E21",
   "names": []
 }

package/dist/context/decorators/legacy/context-selector-field.d.ts

@@ -0,0 +1,8 @@
+import type { RadiantElement } from '../../../core/radiant-element';
+import type { Context, ContextType } from '../../types';
+export type ContextSelectorFieldOptions<T extends Context<unknown, unknown>, Selected = ContextType<T>> = {
+    context: T;
+    select?: (context: ContextType<T>) => Selected;
+    subscribe?: boolean;
+};
+export declare function contextSelectorField<T extends Context<unknown, unknown>, Selected = ContextType<T>>(options: ContextSelectorFieldOptions<T, Selected>): (target: RadiantElement, propertyName: string) => void;

package/dist/context/decorators/legacy/context-selector-field.js

@@ -0,0 +1,3 @@
+import{C as a}from"../../../chunk-s09s5ayx.js";import"../../../chunk-5bkat72n.js";import"../../../chunk-p8k4g99a.js";import"../../../chunk-ek664x1c.js";import"../../../chunk-kmebacvv.js";import"../../../chunk-eyw14d6y.js";import"../../../chunk-cnyxrh9r.js";import"../../../chunk-t8xtvgyg.js";import"../../../chunk-vgtggzb6.js";export{a as contextSelectorField};
+
+//# debugId=54E81B6C02C1D00664756E2164756E21

package/dist/context/decorators/legacy/context-selector-field.js.map

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

package/dist/context/decorators/legacy/context-selector.d.ts

@@ -1,4 +1,4 @@
 import type { RadiantElement } from '../../../core/radiant-element';
-import type { Context } from '../../types';
-import type { SubscribeToContextOptions } from '../context-selector';
-export declare function contextSelector<T extends Context<unknown, unknown>>({ context, select, subscribe, }: SubscribeToContextOptions<T>): (proto: RadiantElement, _: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+import type { Context, ContextType } from '../../types';
+import type { OnContextUpdateOptions } from '../on-context-update';
+export declare function contextSelector<T extends Context<unknown, unknown>, Selected = ContextType<T>>({ context, select, subscribe, requestUpdate, }: OnContextUpdateOptions<T, Selected>): (proto: RadiantElement, _: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/context/decorators/legacy/context-selector.js

@@ -1,4 +1,3 @@
-import{r as o}from"../../events.js";function x({context:r,select:i,subscribe:s=!0}){return(e,l,t)=>{const n=t.value,c=e.connectedCallback;return e.connectedCallback=function(){c.call(this),this.dispatchEvent(new o(r,n.bind(this),i,s))},t.value=function(...a){return n.apply(this,a)},t}}export{x as contextSelector};
-export{x as j};
+import{F as a}from"../../../chunk-kakpjgzf.js";import"../../../chunk-5bkat72n.js";import"../../../chunk-p8k4g99a.js";import"../../../chunk-ek664x1c.js";import"../../../chunk-kmebacvv.js";import"../../../chunk-eyw14d6y.js";import"../../../chunk-cnyxrh9r.js";import"../../../chunk-t8xtvgyg.js";import"../../../chunk-vgtggzb6.js";export{a as contextSelector};
 
-//# debugId=FC57688C8413180A64756E2164756E21
+//# debugId=B0284AA5CC1BCEEA64756E2164756E21

package/dist/context/decorators/legacy/context-selector.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/decorators/legacy/context-selector.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '../../../core/radiant-element';\nimport { ContextSubscriptionRequestEvent } from '../../events';\nimport type { Context, ContextType, UnknownContext } from '../../types';\nimport type { SubscribeToContextOptions } from '../context-selector';\n\ntype ArgsType<T extends UnknownContext> = SubscribeToContextOptions<T>['select'] extends (...args: any[]) => infer R\n  ? R\n  : ContextType<T>;\n\nexport function contextSelector<T extends Context<unknown, unknown>>({\n  context,\n  select,\n  subscribe = true,\n}: SubscribeToContextOptions<T>) {\n  return (proto: RadiantElement, _: string, descriptor: PropertyDescriptor) => {\n    const originalMethod = descriptor.value;\n    const originalConnectedCallback = proto.connectedCallback;\n\n    proto.connectedCallback = function (this: RadiantElement) {\n      originalConnectedCallback.call(this);\n      this.dispatchEvent(new ContextSubscriptionRequestEvent(context, originalMethod.bind(this), select, subscribe));\n    };\n\n    descriptor.value = function (...args: ArgsType<T>[]) {\n      const result = originalMethod.apply(this, args);\n      return result;\n    };\n\n    return descriptor;\n  };\n}\n"
   ],
-  "mappings": "oCASO,SAAS,CAAoD,EAClE,UACA,SACA,YAAY,IACmB,CAC/B,MAAO,CAAC,EAAuB,EAAW,IAAmC,CAC3E,MAAM,EAAiB,EAAW,MAC5B,EAA4B,EAAM,kBAYxC,OAVA,EAAM,0BAA6B,EAAuB,CACxD,EAA0B,KAAK,IAAI,EACnC,KAAK,cAAc,IAAI,EAAgC,EAAS,EAAe,KAAK,IAAI,EAAG,EAAQ,CAAS,CAAC,GAG/G,EAAW,cAAiB,IAAI,EAAqB,CAEnD,OADe,EAAe,MAAM,KAAM,CAAI,GAIzC",
-  "debugId": "FC57688C8413180A64756E2164756E21",
+  "mappings": "",
+  "debugId": "B0284AA5CC1BCEEA64756E2164756E21",
   "names": []
 }

package/dist/context/decorators/legacy/provide-context.d.ts

@@ -1,4 +1,4 @@
 import type { UnknownContext } from '../../../context/types';
 import type { RadiantElement } from '../../../core/radiant-element';
 import type { ProvideContextOptions } from '../provide-context';
-export declare function provideContext<T extends UnknownContext>({ context, initialValue, hydrate }: ProvideContextOptions<T>): (proto: RadiantElement, propertyKey: string) => void;
+export declare function provideContext<T extends UnknownContext>({ context, initialValue, hydrate, serialize, }: ProvideContextOptions<T>): (proto: RadiantElement, propertyKey: string) => void;

package/dist/context/decorators/legacy/provide-context.js

@@ -1,4 +1,3 @@
-import{n as m}from"../../context-provider.js";import"../../events.js";import"../../../utils/attribute-utils.js";function B({context:f,initialValue:q,hydrate:s}){return(j,w)=>{const z=j.connectedCallback;j.connectedCallback=function(){this[w]=new m(this,{context:f,initialValue:q,hydrate:s}),z.call(this),this.connectedContextCallback(f)}}}export{B as provideContext};
-export{B as m};
+import{w as a}from"../../../chunk-r33zvvda.js";import"../../../chunk-21a7jask.js";import"../../../chunk-kmebacvv.js";import"../../../chunk-c0qyz98c.js";import"../../../chunk-cnyxrh9r.js";import"../../../chunk-hpzgnxgq.js";import"../../../chunk-nssj2x13.js";import"../../../chunk-vgtggzb6.js";export{a as provideContext};
 
-//# debugId=9792C057CA5DDBEB64756E2164756E21
+//# debugId=42621FE8B649CF7764756E2164756E21

package/dist/context/decorators/legacy/provide-context.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/decorators/legacy/provide-context.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import { ContextProvider } from '../../../context/context-provider';\nimport type { UnknownContext } from '../../../context/types';\nimport type { RadiantElement } from '../../../core/radiant-element';\nimport type { ProvideContextOptions } from '../provide-context';\n\nexport function provideContext<T extends UnknownContext>({ context, initialValue, hydrate }: ProvideContextOptions<T>) {\n  return (proto: RadiantElement, propertyKey: string) => {\n    const originalConnectedCallback = proto.connectedCallback;\n\n    proto.connectedCallback = function (this: RadiantElement) {\n      (this as any)[propertyKey] = new ContextProvider<T>(this, { context, initialValue, hydrate });\n      originalConnectedCallback.call(this);\n      this.connectedContextCallback(context);\n    };\n  };\n}\n"
   ],
-  "mappings": "kHAKO,DAAS,SAAwC,EAAG,UAAS,eAAc,WAAqC,CACrH,MAAO,CAAC,EAAuB,IAAwB,CACrD,MAAM,EAA4B,EAAM,kBAExC,EAAM,0BAA6B,EAAuB,CACxD,AAAC,KAAa,GAAe,IAAI,EAAmB,KAAM,CAAE,UAAS,eAAc,SAAQ,CAAC,EAC5F,EAA0B,KAAK,IAAI,EACnC,KAAK,yBAAyB,CAAO",
-  "debugId": "9792C057CA5DDBEB64756E2164756E21",
+  "mappings": "",
+  "debugId": "42621FE8B649CF7764756E2164756E21",
   "names": []
 }

package/dist/context/decorators/on-context-update.d.ts

@@ -0,0 +1,31 @@
+import type { RadiantElement } from '../../core/radiant-element';
+import type { Context, ContextType, UnknownContext } from '../types';
+type ContextUpdateMethod<Selected> = (value: Selected) => unknown;
+type OnContextUpdateDecorator<Selected> = {
+    <Host extends RadiantElement, TMethod extends ContextUpdateMethod<Selected>>(protoOrTarget: TMethod, nameOrContext: ClassMethodDecoratorContext<Host, TMethod>): void;
+    (protoOrTarget: RadiantElement, nameOrContext: string, descriptor: TypedPropertyDescriptor<ContextUpdateMethod<Selected>>): TypedPropertyDescriptor<ContextUpdateMethod<Selected>> | void;
+};
+export type OnContextUpdateOptions<T extends UnknownContext, Selected = ContextType<T>> = {
+    /** Context token to resolve from ancestor providers. */
+    context: T;
+    /** Optional projection that narrows the resolved context before delivery. */
+    select?: (context: ContextType<T>) => Selected;
+    /** Whether client-side event-channel subscriptions should stay active after the first value. */
+    subscribe?: boolean;
+    /** Whether RadiantComponent hosts should schedule `requestUpdate()` after delivery. */
+    requestUpdate?: boolean;
+};
+/**
+ * Subscribes a method to the current value, or a selected slice, of a context.
+ *
+ * The decorated method is invoked during SSR when an ambient provider is
+ * available, and on the client it keeps receiving updates according to the
+ * `subscribe` option.
+ *
+ * On `RadiantComponent` hosts, each delivery also schedules `requestUpdate()`
+ * unless `requestUpdate: false` is set explicitly.
+ *
+ * @param options Context subscription configuration.
+ */
+export declare function onContextUpdate<T extends Context<unknown, unknown>, Selected = ContextType<T>>(options: OnContextUpdateOptions<T, Selected>): OnContextUpdateDecorator<Selected>;
+export {};

package/dist/context/decorators/on-context-update.js

@@ -0,0 +1,3 @@
+import{A as a}from"../../chunk-qe0eww1n.js";import"../../chunk-x2k0ngpz.js";import"../../chunk-kakpjgzf.js";import"../../chunk-5bkat72n.js";import"../../chunk-p8k4g99a.js";import"../../chunk-ek664x1c.js";import"../../chunk-kmebacvv.js";import"../../chunk-eyw14d6y.js";import"../../chunk-cnyxrh9r.js";import"../../chunk-q9z6tnzw.js";import"../../chunk-t8xtvgyg.js";import"../../chunk-vgtggzb6.js";export{a as onContextUpdate};
+
+//# debugId=985FF9B3951D73E364756E2164756E21

package/dist/context/decorators/on-context-update.js.map

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

package/dist/context/decorators/provide-context.d.ts

@@ -2,9 +2,21 @@ import type { StandardOrLegacyFieldDecoratorArgs } from '../../types';
 import type { AttributeTypeConstant } from '../../utils';
 import type { UnknownContext } from '../types';
 export type ProvideContextOptions<T extends UnknownContext> = {
+    /** Context token made available to descendant consumers. */
     context: T;
+    /** Client-side default value installed before any SSR hydration is merged. */
     initialValue?: T['__context__'];
+    /** Attribute type used to opt the provider into SSR hydration. */
     hydrate?: AttributeTypeConstant;
+    /**
+     * Projects the current provider value into an SSR-safe hydration payload.
+     *
+     * Use this when the live client context includes instances or other values
+     * that should stay client-only. When `hydrate: Object` is active, the parsed
+     * payload merges back into `initialValue`, so omitted members keep their
+     * client-side defaults.
+     */
+    serialize?: (value: T['__context__']) => unknown;
 };
 /**
  * A decorator to provide a context to the target element.

package/dist/context/decorators/provide-context.js

@@ -1,4 +1,3 @@
-import{l as w}from"./standard/provide-context.js";import{m as q}from"./legacy/provide-context.js";import"../context-provider.js";import"../events.js";import"../../utils/attribute-utils.js";function D(f){return function(j,b){if(typeof b==="object")return w(f)(j,b);return q(f)(j,b)}}export{D as provideContext};
-export{D as k};
+import{v as a}from"../../chunk-wds4href.js";import"../../chunk-r33zvvda.js";import"../../chunk-5qeaq3tj.js";import"../../chunk-21a7jask.js";import"../../chunk-kmebacvv.js";import"../../chunk-c0qyz98c.js";import"../../chunk-cnyxrh9r.js";import"../../chunk-q9z6tnzw.js";import"../../chunk-hpzgnxgq.js";import"../../chunk-nssj2x13.js";import"../../chunk-vgtggzb6.js";export{a as provideContext};
 
-//# debugId=DAFE7A9740BFBCF864756E2164756E21
+//# debugId=A93A96A0D175B10664756E2164756E21

package/dist/context/decorators/provide-context.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/decorators/provide-context.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type {\n  LegacyFieldDecoratorArgs,\n  StandardFieldDecoratorArgs,\n  StandardOrLegacyFieldDecoratorArgs,\n} from '../../types';\nimport type { AttributeTypeConstant } from '../../utils';\nimport type { UnknownContext } from '../types';\nimport { provideContext as legacyProvideContext } from './legacy/provide-context';\nimport { provideContext as standardProvideContext } from './standard/provide-context';\n\nexport type ProvideContextOptions<T extends UnknownContext> = {\n  context: T;\n  initialValue?: T['__context__'];\n  hydrate?: AttributeTypeConstant;\n};\n\n/**\n * A decorator to provide a context to the target element.\n * @param options {@link ProvideContextOptions}\n * @returns\n */\nexport function provideContext<T extends UnknownContext>(options: ProvideContextOptions<T>) {\n  return function (\n    protoOrTarget: StandardOrLegacyFieldDecoratorArgs['protoOrTarget'],\n    nameOrContext: StandardOrLegacyFieldDecoratorArgs['nameOrContext'],\n  ): any {\n    if (typeof nameOrContext === 'object') {\n      return standardProvideContext(options)(\n        protoOrTarget as StandardFieldDecoratorArgs['protoOrTarget'],\n        nameOrContext as StandardFieldDecoratorArgs['nameOrContext'],\n      );\n    }\n    return legacyProvideContext(options)(\n      protoOrTarget as LegacyFieldDecoratorArgs['protoOrTarget'],\n      nameOrContext as LegacyFieldDecoratorArgs['nameOrContext'],\n    );\n  };\n}\n"
   ],
-  "mappings": "sMAqBO,WAAS,FAAwC,ZAAC,OAAmC,CAC1F,eAAgB,CACd,EACA,EACK,CACL,UAAW,IAAkB,SAC3B,OAAO,EAAuB,CAAO,EACnC,EACA,CACF,EAEF,OAAO,EAAqB,CAAO,EACjC,EACA,CACF",
-  "debugId": "DAFE7A9740BFBCF864756E2164756E21",
+  "mappings": "",
+  "debugId": "A93A96A0D175B10664756E2164756E21",
   "names": []
 }

package/dist/context/decorators/standard/consume-context.d.ts

@@ -1,3 +1,3 @@
 import type { RadiantElement } from '../../../core/radiant-element';
 import type { UnknownContext } from '../../types';
-export declare function consumeContext(contextToProvide: UnknownContext): <T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => void;
+export declare function consumeContext(consumedContext: UnknownContext): <T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => void;

package/dist/context/decorators/standard/consume-context.js

@@ -1,4 +1,3 @@
-import{p as i}from"../../events.js";function m(t){return(a,e)=>{const o=String(e.name);e.addInitializer(function(){this.dispatchEvent(new i(t,(n)=>{this[o]=n,this.connectedContextCallback(t),this.dispatchEvent(new CustomEvent("context-mounted",{detail:n}))}))})}}export{m as consumeContext};
-export{m as o};
+import{x as a}from"../../../chunk-fs4j94bk.js";import"../../../chunk-p8k4g99a.js";import"../../../chunk-ek664x1c.js";import"../../../chunk-kmebacvv.js";import"../../../chunk-eyw14d6y.js";import"../../../chunk-t8xtvgyg.js";import"../../../chunk-vgtggzb6.js";export{a as consumeContext};
 
-//# debugId=5EBC8BEA292801F164756E2164756E21
+//# debugId=398BFFE041CCB3A464756E2164756E21

package/dist/context/decorators/standard/consume-context.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/decorators/standard/consume-context.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '../../../core/radiant-element';\nimport { ContextEventsTypes, ContextRequestEvent } from '../../events';\nimport type { UnknownContext } from '../../types';\n\nexport function consumeContext(contextToProvide: UnknownContext) {\n  return <T extends RadiantElement, V>(_: undefined, context: ClassFieldDecoratorContext<T, V>) => {\n    const contextName = String(context.name);\n    context.addInitializer(function (this: T) {\n      this.dispatchEvent(\n        new ContextRequestEvent(contextToProvide, (context) => {\n          (this as any)[contextName] = context;\n          this.connectedContextCallback(contextToProvide);\n          this.dispatchEvent(new CustomEvent(ContextEventsTypes.MOUNTED, { detail: context }));\n        }),\n      );\n    });\n  };\n}\n"
   ],
-  "mappings": "oCAIO,SAAS,CAAc,CAAC,EAAkC,CAC/D,MAAO,CAA8B,EAAc,IAA8C,CAC/F,MAAM,EAAc,OAAO,EAAQ,IAAI,EACvC,EAAQ,uBAAwB,EAAU,CACxC,KAAK,cACH,IAAI,EAAoB,EAAkB,CAAC,IAAY,CACrD,AAAC,KAAa,GAAe,EAC7B,KAAK,yBAAyB,CAAgB,EAC9C,KAAK,cAAc,IAAI,8BAAwC,CAAE,OAAQ,CAAQ,CAAC,CAAC,EACpF,CACH,EACD",
-  "debugId": "5EBC8BEA292801F164756E2164756E21",
+  "mappings": "",
+  "debugId": "398BFFE041CCB3A464756E2164756E21",
   "names": []
 }

package/dist/context/decorators/standard/context-selector-field.d.ts

@@ -0,0 +1,8 @@
+import type { RadiantElement } from '../../../core/radiant-element';
+import type { Context, ContextType } from '../../types';
+export type ContextSelectorFieldOptions<T extends Context<unknown, unknown>, Selected = ContextType<T>> = {
+    context: T;
+    select?: (context: ContextType<T>) => Selected;
+    subscribe?: boolean;
+};
+export declare function contextSelectorField<T extends Context<unknown, unknown>, Selected = ContextType<T>>(options: ContextSelectorFieldOptions<T, Selected>): <Host extends RadiantElement>(_: undefined, fieldContext: ClassFieldDecoratorContext<Host, Selected>) => (this: Host, initialValue: Selected) => Selected;

package/dist/context/decorators/standard/context-selector-field.js

@@ -0,0 +1,3 @@
+import{D as a}from"../../../chunk-g2z3mm6b.js";import"../../../chunk-5bkat72n.js";import"../../../chunk-p8k4g99a.js";import"../../../chunk-ek664x1c.js";import"../../../chunk-kmebacvv.js";import"../../../chunk-eyw14d6y.js";import"../../../chunk-t8xtvgyg.js";import"../../../chunk-vgtggzb6.js";export{a as contextSelectorField};
+
+//# debugId=28981E6A4741D49664756E2164756E21

package/dist/context/decorators/standard/context-selector-field.js.map

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

package/dist/context/decorators/standard/context-selector.d.ts

@@ -1,4 +1,5 @@
 import type { Method } from '../../../types';
-import type { Context } from '../../types';
-import type { SubscribeToContextOptions } from '../context-selector';
-export declare function contextSelector<T extends Context<unknown, unknown>>({ context, select, subscribe, }: SubscribeToContextOptions<T>): <T_1 extends Method>(originalMethod: T_1, targetContext: ClassMethodDecoratorContext<T_1, T_1>) => void;
+import type { RadiantElement } from '../../../core/radiant-element';
+import type { Context, ContextType } from '../../types';
+import type { OnContextUpdateOptions } from '../on-context-update';
+export declare function contextSelector<T extends Context<unknown, unknown>, Selected = ContextType<T>>({ context, select, subscribe, requestUpdate, }: OnContextUpdateOptions<T, Selected>): <Host extends RadiantElement, TMethod extends Method>(originalMethod: TMethod, targetContext: ClassMethodDecoratorContext<Host, TMethod>) => void;

package/dist/context/decorators/standard/context-selector.js

@@ -1,4 +1,3 @@
-import{r as t}from"../../events.js";function p({context:e,select:o,subscribe:n=!0}){return function(i,r){r.addInitializer(function(){queueMicrotask(()=>{this.dispatchEvent(new t(e,i.bind(this),o,n))})})}}export{p as contextSelector};
-export{p as i};
+import{E as a}from"../../../chunk-x2k0ngpz.js";import"../../../chunk-5bkat72n.js";import"../../../chunk-p8k4g99a.js";import"../../../chunk-ek664x1c.js";import"../../../chunk-kmebacvv.js";import"../../../chunk-eyw14d6y.js";import"../../../chunk-t8xtvgyg.js";import"../../../chunk-vgtggzb6.js";export{a as contextSelector};
 
-//# debugId=63D2F9333044952264756E2164756E21
+//# debugId=D78E4F19FE74240B64756E2164756E21

package/dist/context/decorators/standard/context-selector.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/decorators/standard/context-selector.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { Method } from '../../../types';\nimport { ContextSubscriptionRequestEvent } from '../../events';\nimport type { Context } from '../../types';\nimport type { SubscribeToContextOptions } from '../context-selector';\n\nexport function contextSelector<T extends Context<unknown, unknown>>({\n  context,\n  select,\n  subscribe = true,\n}: SubscribeToContextOptions<T>) {\n  return function <T extends Method>(originalMethod: T, targetContext: ClassMethodDecoratorContext<T, T>): void {\n    targetContext.addInitializer(function (this: any) {\n      queueMicrotask(() => {\n        this.dispatchEvent(new ContextSubscriptionRequestEvent(context, originalMethod.bind(this), select, subscribe));\n      });\n    });\n  };\n}\n"
   ],
-  "mappings": "oCAKO,SAAS,CAAoD,EAClE,UACA,SACA,YAAY,IACmB,CAC/B,eAAkC,CAAC,EAAmB,EAAwD,CAC5G,EAAc,uBAAwB,EAAY,CAChD,eAAe,IAAM,CACnB,KAAK,cAAc,IAAI,EAAgC,EAAS,EAAe,KAAK,IAAI,EAAG,EAAQ,CAAS,CAAC,EAC9G,EACF",
-  "debugId": "63D2F9333044952264756E2164756E21",
+  "mappings": "",
+  "debugId": "D78E4F19FE74240B64756E2164756E21",
   "names": []
 }

package/dist/context/decorators/standard/provide-context.d.ts

@@ -1,4 +1,4 @@
 import type { RadiantElement } from '../../../core/radiant-element';
 import type { UnknownContext } from '../../types';
 import type { ProvideContextOptions } from '../provide-context';
-export declare function provideContext<T extends UnknownContext>({ context, initialValue, hydrate }: ProvideContextOptions<T>): <C extends RadiantElement, V>(_: undefined, targetContext: ClassFieldDecoratorContext<C, V>) => void;
+export declare function provideContext<T extends UnknownContext>({ context, initialValue, hydrate, serialize, }: ProvideContextOptions<T>): <C extends RadiantElement, V>(_: undefined, targetContext: ClassFieldDecoratorContext<C, V>) => void;

package/dist/context/decorators/standard/provide-context.js

@@ -1,4 +1,3 @@
-import{n}from"../../context-provider.js";import"../../events.js";import"../../../utils/attribute-utils.js";function m({context:t,initialValue:o,hydrate:i}){return(d,e)=>{const r=String(e.name);e.addInitializer(function(){this[r]=new n(this,{context:t,initialValue:o,hydrate:i}),this.connectedContextCallback(t)})}}export{m as provideContext};
-export{m as l};
+import{y as a}from"../../../chunk-5qeaq3tj.js";import"../../../chunk-21a7jask.js";import"../../../chunk-kmebacvv.js";import"../../../chunk-c0qyz98c.js";import"../../../chunk-hpzgnxgq.js";import"../../../chunk-nssj2x13.js";import"../../../chunk-vgtggzb6.js";export{a as provideContext};
 
-//# debugId=C46D919C46727B7364756E2164756E21
+//# debugId=5442E2BDB3C0B0F764756E2164756E21

package/dist/context/decorators/standard/provide-context.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/decorators/standard/provide-context.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '../../../core/radiant-element';\nimport { ContextProvider } from '../../context-provider';\nimport type { UnknownContext } from '../../types';\nimport type { ProvideContextOptions } from '../provide-context';\n\nexport function provideContext<T extends UnknownContext>({ context, initialValue, hydrate }: ProvideContextOptions<T>) {\n  return <C extends RadiantElement, V>(_: undefined, targetContext: ClassFieldDecoratorContext<C, V>) => {\n    const contextName = String(targetContext.name);\n    targetContext.addInitializer(function (this: C) {\n      (this as any)[contextName] = new ContextProvider<T>(this, { context, initialValue, hydrate });\n      this.connectedContextCallback(context);\n    });\n  };\n}\n"
   ],
-  "mappings": "6GAKO,DAAS,SAAwC,EAAG,UAAS,eAAc,WAAqC,CACrH,MAAO,CAA8B,EAAc,IAAoD,CACrG,MAAM,EAAc,OAAO,EAAc,IAAI,EAC7C,EAAc,uBAAwB,EAAU,CAC9C,AAAC,KAAa,GAAe,IAAI,EAAmB,KAAM,CAAE,UAAS,eAAc,SAAQ,CAAC,EAC5F,KAAK,yBAAyB,CAAO,EACtC",
-  "debugId": "C46D919C46727B7364756E2164756E21",
+  "mappings": "",
+  "debugId": "5442E2BDB3C0B0F764756E2164756E21",
   "names": []
 }

package/dist/context/events.js

@@ -1,4 +1,3 @@
-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};
+import{S as a,T as b,U as c,V as d}from"../chunk-kmebacvv.js";import"../chunk-vgtggzb6.js";export{d as ContextSubscriptionRequestEvent,b as ContextRequestEvent,c as ContextOnMountEvent,a as ContextEventsTypes};
 
-//# debugId=CD57E830D3B70B5964756E2164756E21
+//# debugId=762415F16C70E00764756E2164756E21

package/dist/context/events.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/events.ts"],
+  "sources": [],
   "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  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,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",
+  "mappings": "",
+  "debugId": "762415F16C70E00764756E2164756E21",
   "names": []
 }

package/dist/context/hydration-script.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Creates the raw `<script type="application/json">` tag used to hydrate a
+ * serialized context provider.
+ */
+export declare function createContextHydrationScriptTag(options: {
+    hydrationKey?: string;
+    serializedValue: string;
+}): string;
+/**
+ * Escapes serialized JSON so it remains safe when embedded inside an HTML
+ * script tag.
+ */
+export declare function escapeContextHydrationJson(value: string): string;

package/dist/context/hydration-script.js

@@ -0,0 +1,3 @@
+import{W as a,X as b}from"../chunk-c0qyz98c.js";import"../chunk-hpzgnxgq.js";import"../chunk-nssj2x13.js";import"../chunk-vgtggzb6.js";export{b as escapeContextHydrationJson,a as createContextHydrationScriptTag};
+
+//# debugId=204037B251BD0C8664756E2164756E21

package/dist/context/hydration-script.js.map

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

package/dist/core/custom-element-metadata.d.ts

@@ -0,0 +1,3 @@
+export declare const CUSTOM_ELEMENT_TAG_NAME: unique symbol;
+export declare function setCustomElementTagName(target: CustomElementConstructor, tagName: string): void;
+export declare function getCustomElementTagName(target: CustomElementConstructor): string | undefined;

package/dist/core/custom-element-metadata.js

@@ -0,0 +1,3 @@
+import{Va as a,Wa as b,Xa as c}from"../chunk-hztr86b4.js";import"../chunk-vgtggzb6.js";export{b as setCustomElementTagName,c as getCustomElementTagName,a as CUSTOM_ELEMENT_TAG_NAME};
+
+//# debugId=A10222618D77E92E64756E2164756E21

package/dist/core/custom-element-metadata.js.map

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

package/dist/core/hydration-codec.d.ts

@@ -0,0 +1,24 @@
+/** Attribute marker used to identify hydration payloads inside a host. */
+export declare const HYDRATION_ATTRIBUTE = "data-hydration";
+/** Discriminator that scopes a hydration payload to a specific feature. */
+export declare const HYDRATION_TYPE_ATTRIBUTE = "data-hydration-type";
+/** Optional key that scopes a hydration payload to a specific decorated field. */
+export declare const HYDRATION_KEY_ATTRIBUTE = "data-hydration-key";
+export type HydrationPayloadType = 'signal' | 'context';
+/** Creates a `<script type="application/json">` tag for a hydration payload. */
+export declare function createHydrationScriptTag(options: {
+    type: HydrationPayloadType;
+    hydrationKey?: string;
+    serializedValue: string;
+}): string;
+/** Escapes serialized JSON so it remains safe inside an HTML script tag. */
+export declare function escapeHydrationJson(value: string): string;
+/** Parses JSON from a hydration script element, returning the fallback on failure. */
+export declare function parseHydrationPayload<T>(element: Element, fallback: T): T;
+/**
+ * Finds a hydration script element inside a host by type and optional key.
+ *
+ * When a key is provided, looks for an exact `data-hydration-key` match.
+ * Otherwise, returns the first unkeyed script matching the type.
+ */
+export declare function findHydrationScript(host: Element, type: HydrationPayloadType, hydrationKey?: string): Element | null;

package/dist/core/hydration-codec.js

@@ -0,0 +1,3 @@
+import{pb as a,qb as b,rb as c,sb as d,tb as e,ub as f,vb as g}from"../chunk-hpzgnxgq.js";import"../chunk-nssj2x13.js";import"../chunk-vgtggzb6.js";export{f as parseHydrationPayload,g as findHydrationScript,e as escapeHydrationJson,d as createHydrationScriptTag,b as HYDRATION_TYPE_ATTRIBUTE,c as HYDRATION_KEY_ATTRIBUTE,a as HYDRATION_ATTRIBUTE};
+
+//# debugId=35B99D921CD92DC764756E2164756E21

package/dist/core/hydration-codec.js.map

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

package/dist/core/radiant-component-ssr-registry.d.ts

@@ -0,0 +1,54 @@
+import type { JsxRenderable } from '@ecopages/jsx';
+import type { RenderToStringOptions } from '@ecopages/jsx/server';
+/**
+ * Optional SSR hooks exposed by `RadiantComponent` instances to the shared
+ * server runtime.
+ *
+ * The bridge lets the runtime detect whether a component is still using the
+ * inherited host SSR implementation or has taken ownership of host rendering
+ * through explicit overrides.
+ */
+export type RadiantComponentRenderBridge = {
+    renderHost?: () => JsxRenderable;
+    renderHostToString?: (options?: RenderToStringOptions) => string;
+};
+/**
+ * Runtime shape required by the shared Radiant SSR helpers.
+ *
+ * This is intentionally narrower than `RadiantComponent` itself so the server
+ * runtime can stay decoupled from the full client base-class implementation.
+ */
+export type RadiantComponentSsrCapable = HTMLElement & {
+    resolveSsrRenderBridge?: () => RadiantComponentRenderBridge;
+    getHostSsrAttributes?: () => Record<string, string>;
+    renderToString(options?: RenderToStringOptions): string;
+    renderHost?(): JsxRenderable;
+    renderHostToString(options?: RenderToStringOptions): string;
+};
+/**
+ * Shared SSR runtime contract registered on `globalThis`.
+ *
+ * Server entrypoints install one implementation that both direct component SSR
+ * and nested JSX custom-element SSR can reuse without importing client-only
+ * internals into every call site.
+ */
+export type RadiantComponentSsrRuntime = {
+    getHostAttributes(component: RadiantComponentSsrCapable): Record<string, string>;
+    renderHost(component: RadiantComponentSsrCapable): JsxRenderable;
+    renderHostToString(component: RadiantComponentSsrCapable, options?: RenderToStringOptions): string;
+    resolveRenderBridge(component: RadiantComponentSsrCapable): RadiantComponentRenderBridge | undefined;
+    renderView(component: RadiantComponentSsrCapable, options?: RenderToStringOptions): string;
+};
+/**
+ * Reads the currently registered Radiant SSR runtime from `globalThis`.
+ *
+ * Returns `undefined` when no server entrypoint has installed the runtime yet.
+ */
+export declare function getRadiantComponentSsrRuntime(): RadiantComponentSsrRuntime | undefined;
+/**
+ * Registers the shared Radiant SSR runtime on `globalThis`.
+ *
+ * The latest registration wins, which keeps server adapters free to install
+ * the runtime eagerly from their own explicit entrypoint.
+ */
+export declare function registerRadiantComponentSsrRuntime(runtime: RadiantComponentSsrRuntime): void;

package/dist/core/radiant-component-ssr-registry.js

@@ -0,0 +1,3 @@
+import{Ta as a,Ua as b}from"../chunk-e0r6ca2g.js";import"../chunk-vgtggzb6.js";export{b as registerRadiantComponentSsrRuntime,a as getRadiantComponentSsrRuntime};
+
+//# debugId=0DE7ED0BDBAD0C8D64756E2164756E21

package/dist/core/radiant-component-ssr-registry.js.map

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