@ecopages/radiant 0.3.0-alpha.4 → 0.3.0-alpha.5

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

@@ -1,3 +1,3 @@
-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};
+var V=((f)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(f,{get:(L,C)=>(typeof require<"u"?require:L)[C]}):f)(function(f){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+f+'" is not supported')});function w(f){return f.replace(/&/g,"\\u0026").replace(/</g,"\\u003c").replace(/>/g,"\\u003e").replace(/\u2028/g,"\\u2028").replace(/\u2029/g,"\\u2029")}var Q="data-hydration",X="data-hydration-type",G="data-hydration-key";function z(f){let L=f.hydrationKey?` ${G}="${x(f.hydrationKey)}"`:"";return`<script type="application/json" ${Q} ${X}="${f.type}"${L}>${f.serializedValue}</script>`}function J(f){return w(f)}function O(f,L){let C=f.textContent;if(!C)return L;try{return JSON.parse(C)}catch{if(typeof console<"u")console.warn(`[@ecopages/radiant] Failed to parse hydration payload from <script ${Q}>:`,C.slice(0,120));return L}}function U(f,L,C){let P=f.children;if(!P||P.length===0){let g=f.childNodes;if(!g||g.length===0)return null;for(let j=0;j<g.length;j+=1){let m=g[j];if(m.nodeType!==1)continue;let q=m;if(W(q,L,C))return q}return null}for(let g=0;g<P.length;g+=1)if(W(P[g],L,C))return P[g];return null}function W(f,L,C){if(f.tagName!=="SCRIPT"||!f.hasAttribute(Q)||f.getAttribute(X)!==L)return!1;if(C!==void 0)return f.getAttribute(G)===C;return!f.hasAttribute(G)}function x(f){return f.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}var k;((g)=>{g.SUBSCRIPTION_REQUEST="context-subscription-request";g.CONTEXT_REQUEST="context-request";g.ON_MOUNT="context-on-mount";g.MOUNTED="context-mounted"})(k||={});class B extends Event{context;callback;subscribe;handled=!1;constructor(f,L,C){super("context-request",{bubbles:!0,composed:!0});this.context=f;this.callback=L;this.subscribe=C}markHandled(){this.handled=!0}}class F extends CustomEvent{constructor(f){super("context-on-mount",{detail:{context:f},bubbles:!0,composed:!0})}}class D extends Event{context;callback;select;subscribe;onSubscribe;handled=!1;constructor(f,L,C,P,g){super("context-subscription-request",{bubbles:!0,composed:!0});this.context=f;this.callback=L;this.select=C;this.subscribe=P;this.onSubscribe=g}markHandled(){this.handled=!0}}function E(f){return z({type:"context",...f})}function M(f){return J(f)}function S(f){if(f instanceof Element)return f;if("host"in f)return f.host;if("element"in f)return f.element;return null}function H(f){if(f instanceof Element)return f;if("host"in f)return f.host;if("element"in f)return f.element;return f}import{createMarkupNodeLike as K}from"@ecopages/jsx";class Z{host;context;hydrationKey;hydrate;serialize;pendingHostHydration;value;subscriptions=[];constructor(f,L){this.host=f,this.context=L.context,this.hydrationKey=L.hydrationKey,this.hydrate=L.hydrate,this.serialize=L.serialize,this.pendingHostHydration=Boolean(L.hydrate),this.value=L.initialValue,this.tryHydrateFromHost(),this.registerEvents(),this.host.dispatchEvent(new F(this.context))}setContext=(f,L)=>{if(this.tryHydrateFromHost(),this.pendingHostHydration=!1,typeof this.value>"u"&&this.isObject(f)){let C=this.value;if(this.value={...f},L)L(this.value);this.notifySubscribers(this.value,C);return}if(this.isObject(this.value)&&this.isObject(f)){let C={...this.value};if(this.value={...this.value,...f},L)L(this.value);this.notifySubscribers(this.value,C)}};getContext=()=>{return this.tryHydrateFromHost(),this.value};getContextKey=()=>{return this.context};serializeHydrationValue=()=>{if(this.tryHydrateFromHost(),!this.hydrate||typeof this.value>"u")return;let f=this.serialize?this.serialize(this.value):this.value;if(typeof f>"u")return;let L=JSON.stringify(f);if(typeof L!=="string")return;return M(L)};renderHydrationScriptTag=()=>{let f=this.serializeHydrationValue();if(!f)return;return E({hydrationKey:this.hydrationKey,serializedValue:f})};renderHydrationScript=()=>{let f=this.renderHydrationScriptTag();if(!f)return;return K(f)};subscribe=(f)=>{let L={hasChanged:(C,P)=>{if(typeof P>"u"||!f.select)return!0;return f.select(C)!==f.select(P)},notify:(C)=>{if(f.select){f.callback(f.select(C),L.unsubscribe);return}f.callback(C,L.unsubscribe)},unsubscribe:()=>{let C=this.subscriptions.indexOf(L);if(C!==-1)this.subscriptions.splice(C,1)}};return this.subscriptions.push(L),L.unsubscribe};tryHydrateFromHost(){if(!this.pendingHostHydration)return;let f=this.findHydrationScriptElement();if(!f)return;this.value=this.mergeHydrationValue(O(f,this.value)),this.pendingHostHydration=!1}mergeHydrationValue(f){if(this.hydrate===Object&&this.isObject(f)&&(this.isObject(this.value)||typeof this.value>"u"))return{...this.value??{},...f};return f}isObject(f){return typeof f==="object"&&!Array.isArray(f)&&f!==null}findHydrationScriptElement(){return U(H(this.host),"context",this.hydrationKey)}notifySubscribers=(f,L)=>{for(let C of this.subscriptions)if(C.hasChanged(f,L))C.notify(f)};handleSubscriptionRequest=(f,{subscribe:L,onSubscribe:C})=>{this.tryHydrateFromHost();let P=L?this.subscribe(f):void 0;if(P)C?.(P);if(typeof this.value>"u")return;if(f.select)f.callback(f.select(this.value),P);else f.callback(this.value,P)};onSubscriptionRequest=(f)=>{let{context:L,callback:C,subscribe:P,select:g,target:j,onSubscribe:m}=f;if(L!==this.context)return;if(f.markHandled(),f.stopPropagation(),j instanceof EventTarget)j.dispatchEvent(new F(this.context));if(g){this.handleSubscriptionRequest({select:g,callback:C},{subscribe:P,onSubscribe:m});return}this.handleSubscriptionRequest({callback:C},{subscribe:P,onSubscribe:m})};onContextRequest=(f)=>{let{context:L,callback:C}=f;if(L!==this.context)return;f.markHandled(),f.stopPropagation(),C(this)};registerEvents=()=>{this.host.addEventListener("context-subscription-request",this.onSubscriptionRequest),this.host.addEventListener("context-request",this.onContextRequest)}}function b({context:f,initialValue:L,hydrate:C,serialize:P}){return(g,j)=>{let m=String(j.name);j.addInitializer(function(){let q=this,$=new Z(this,{context:f,hydrationKey:m,initialValue:L,hydrate:C,serialize:P});q[m]=$,this.registerContextProvider(m,$),this.connectedContextCallback(f)})}}export{b as provideContext};
 
-//# debugId=5442E2BDB3C0B0F764756E2164756E21
+//# debugId=38CB6638F936059564756E2164756E21

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

@@ -1,9 +1,16 @@
 {
   "version": 3,
-  "sources": [],
+  "sources": ["../src/tools/escape-script-json.ts", "../src/core/hydration-codec.ts", "../src/context/events.ts", "../src/context/hydration-script.ts", "../src/context/context-host.ts", "../src/context/context-provider.ts", "../src/context/decorators/standard/provide-context.ts"],
   "sourcesContent": [
+    "/**\n * Escapes serialized JSON so it remains safe when embedded inside an HTML\n * `<script>` tag.\n */\nexport function escapeScriptJson(value: string): string {\n\treturn value\n\t\t.replace(/&/g, '\\\\u0026')\n\t\t.replace(/</g, '\\\\u003c')\n\t\t.replace(/>/g, '\\\\u003e')\n\t\t.replace(/\\u2028/g, '\\\\u2028')\n\t\t.replace(/\\u2029/g, '\\\\u2029');\n}\n",
+    "import { escapeScriptJson } from '../tools/escape-script-json';\n\n/** Attribute marker used to identify hydration payloads inside a host. */\nexport const HYDRATION_ATTRIBUTE = 'data-hydration';\n/** Discriminator that scopes a hydration payload to a specific feature. */\nexport const HYDRATION_TYPE_ATTRIBUTE = 'data-hydration-type';\n/** Optional key that scopes a hydration payload to a specific decorated field. */\nexport const HYDRATION_KEY_ATTRIBUTE = 'data-hydration-key';\n\nexport type HydrationPayloadType = 'signal' | 'context';\n\ntype HydrationScriptHost = {\n\tchildren?: ArrayLike<Element> | undefined;\n\tchildNodes?: ArrayLike<{ nodeType: number }> | undefined;\n};\n\n/** Creates a `<script type=\"application/json\">` tag for a hydration payload. */\nexport function createHydrationScriptTag(options: {\n\ttype: HydrationPayloadType;\n\thydrationKey?: string;\n\tserializedValue: string;\n}): string {\n\tconst keyAttribute = options.hydrationKey\n\t\t? ` ${HYDRATION_KEY_ATTRIBUTE}=\"${escapeHtmlAttribute(options.hydrationKey)}\"`\n\t\t: '';\n\n\treturn `<script type=\"application/json\" ${HYDRATION_ATTRIBUTE} ${HYDRATION_TYPE_ATTRIBUTE}=\"${options.type}\"${keyAttribute}>${options.serializedValue}</script>`;\n}\n\n/** Escapes serialized JSON so it remains safe inside an HTML script tag. */\nexport function escapeHydrationJson(value: string): string {\n\treturn escapeScriptJson(value);\n}\n\n/** Parses JSON from a hydration script element, returning the fallback on failure. */\nexport function parseHydrationPayload<T>(element: Element, fallback: T): T {\n\tconst textContent = element.textContent;\n\n\tif (!textContent) {\n\t\treturn fallback;\n\t}\n\n\ttry {\n\t\treturn JSON.parse(textContent) as T;\n\t} catch {\n\t\tif (typeof console !== 'undefined') {\n\t\t\tconsole.warn(\n\t\t\t\t`[@ecopages/radiant] Failed to parse hydration payload from <script ${HYDRATION_ATTRIBUTE}>:`,\n\t\t\t\ttextContent.slice(0, 120),\n\t\t\t);\n\t\t}\n\t\treturn fallback;\n\t}\n}\n\n/**\n * Finds a hydration script element inside a host by type and optional key.\n *\n * When a key is provided, looks for an exact `data-hydration-key` match.\n * Otherwise, returns the first unkeyed script matching the type.\n */\nexport function findHydrationScript(\n\thost: HydrationScriptHost,\n\ttype: HydrationPayloadType,\n\thydrationKey?: string,\n): Element | null {\n\tconst children = host.children;\n\n\tif (!children || children.length === 0) {\n\t\tconst childNodes = (host as Partial<{ childNodes: ArrayLike<{ nodeType: number }> }>).childNodes;\n\n\t\tif (!childNodes || childNodes.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\tfor (let i = 0; i < childNodes.length; i += 1) {\n\t\t\tconst node = childNodes[i]!;\n\n\t\t\tif (node.nodeType !== 1) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst element = node as unknown as Element;\n\n\t\t\tif (matchesHydrationScript(element, type, hydrationKey)) {\n\t\t\t\treturn element;\n\t\t\t}\n\t\t}\n\n\t\treturn null;\n\t}\n\n\tfor (let i = 0; i < children.length; i += 1) {\n\t\tif (matchesHydrationScript(children[i]!, type, hydrationKey)) {\n\t\t\treturn children[i]!;\n\t\t}\n\t}\n\n\treturn null;\n}\n\nfunction matchesHydrationScript(element: Element, type: HydrationPayloadType, hydrationKey?: string): boolean {\n\tif (\n\t\telement.tagName !== 'SCRIPT' ||\n\t\t!element.hasAttribute(HYDRATION_ATTRIBUTE) ||\n\t\telement.getAttribute(HYDRATION_TYPE_ATTRIBUTE) !== type\n\t) {\n\t\treturn false;\n\t}\n\n\tif (hydrationKey !== undefined) {\n\t\treturn element.getAttribute(HYDRATION_KEY_ATTRIBUTE) === hydrationKey;\n\t}\n\n\treturn !element.hasAttribute(HYDRATION_KEY_ATTRIBUTE);\n}\n\nfunction escapeHtmlAttribute(value: string): string {\n\treturn value.replace(/&/g, '&amp;').replace(/\"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n}\n",
+    "import type { Context, ContextCallback, ContextType, UnknownContext } from './types';\n\n/**\n * List of events which can be emitted by a context provider or requester.\n */\nexport enum ContextEventsTypes {\n\tSUBSCRIPTION_REQUEST = 'context-subscription-request',\n\tCONTEXT_REQUEST = 'context-request',\n\tON_MOUNT = 'context-on-mount',\n\tMOUNTED = '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\tpublic handled = false;\n\n\tpublic constructor(\n\t\tpublic readonly context: T,\n\t\tpublic readonly callback: ContextCallback<ContextType<T>>,\n\t\tpublic readonly subscribe?: boolean,\n\t) {\n\t\tsuper(ContextEventsTypes.CONTEXT_REQUEST, { bubbles: true, composed: true });\n\t}\n\n\tpublic markHandled(): void {\n\t\tthis.handled = true;\n\t}\n}\n\n/**\n * A type which represents a subscription to a context value.\n */\ntype DirectContextSubscription<T extends UnknownContext> = {\n\tselect?: undefined;\n\tcallback: ContextCallback<ContextType<T>>;\n};\n\ntype SelectedContextSubscription<T extends UnknownContext, Selected> = {\n\tselect: (context: ContextType<T>) => Selected;\n\tcallback: ContextCallback<Selected>;\n};\n\nexport type ContextSubscription<T extends UnknownContext, Selected = ContextType<T>> =\n\t| DirectContextSubscription<T>\n\t| SelectedContextSubscription<T, Selected>;\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\tpublic constructor(context: UnknownContext) {\n\t\tsuper(ContextEventsTypes.ON_MOUNT, {\n\t\t\tdetail: { context },\n\t\t\tbubbles: true,\n\t\t\tcomposed: true,\n\t\t});\n\t}\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, Selected = ContextType<T>> extends Event {\n\tpublic handled = false;\n\n\tpublic constructor(\n\t\tpublic readonly context: T,\n\t\tpublic readonly callback: ContextCallback<Selected>,\n\t\tpublic readonly select?: (context: ContextType<T>) => Selected,\n\t\tpublic readonly subscribe?: boolean,\n\t\tpublic readonly onSubscribe?: (unsubscribe: () => void) => void,\n\t) {\n\t\tsuper(ContextEventsTypes.SUBSCRIPTION_REQUEST, {\n\t\t\tbubbles: true,\n\t\t\tcomposed: true,\n\t\t});\n\t}\n\n\tpublic markHandled(): void {\n\t\tthis.handled = true;\n\t}\n}\n\ndeclare global {\n\tinterface HTMLElementEventMap {\n\t\t/**\n\t\t * A 'context-request-subscription' event can be emitted by any element which desires\n\t\t * a context value to be injected by an external provider.\n\t\t */\n\t\t[ContextEventsTypes.SUBSCRIPTION_REQUEST]: ContextSubscriptionRequestEvent<UnknownContext>;\n\t\t/**\n\t\t * A context-request-provider event can be emitted by a context requester to signal\n\t\t * that it desires a context value to be provided by a context provider.\n\t\t */\n\t\t[ContextEventsTypes.CONTEXT_REQUEST]: ContextRequestEvent<Context<unknown, unknown>>;\n\t\t/**\n\t\t * A 'context-mount' event can be emitted by a context provider to signal\n\t\t * that a context value has been mounted and is available for consumption.\n\t\t */\n\t\t[ContextEventsTypes.ON_MOUNT]: ContextOnMountEvent;\n\t}\n}\n",
+    "import { createHydrationScriptTag, escapeHydrationJson } from '../core/hydration-codec';\n\n/**\n * Creates the raw `<script type=\"application/json\">` tag used to hydrate a\n * serialized context provider.\n */\nexport function createContextHydrationScriptTag(options: { hydrationKey?: string; serializedValue: string }): string {\n\treturn createHydrationScriptTag({ type: 'context', ...options });\n}\n\n/**\n * Escapes serialized JSON so it remains safe when embedded inside an HTML\n * script tag.\n */\nexport function escapeContextHydrationJson(value: string): string {\n\treturn escapeHydrationJson(value);\n}\n",
+    "import type { UnknownContext } from './types';\n\ntype ContextHostApi = {\n\taddEventListener(\n\t\ttype: string,\n\t\tlistener: EventListenerOrEventListenerObject,\n\t\toptions?: boolean | AddEventListenerOptions,\n\t): void;\n\tremoveEventListener(\n\t\ttype: string,\n\t\tlistener: EventListenerOrEventListenerObject,\n\t\toptions?: boolean | EventListenerOptions,\n\t): void;\n\tdispatchEvent(event: Event): boolean;\n\tregisterConnectedCallback(callback: () => void): void;\n\tregisterCleanupCallback(callback: () => void): void;\n\tconnectedContextCallback(context: UnknownContext): void;\n\tregisterContextProvider(name: string, provider: unknown): void;\n};\n\ntype SsrHydrationContainer = {\n\tchildren?: ArrayLike<Element> | undefined;\n\tchildNodes?: ArrayLike<{ nodeType: number }> | undefined;\n};\n\nexport type ContextHydrationHost = Element | SsrHydrationContainer;\n\nexport type ContextHostLike =\n\t| (ContextHostApi & Element)\n\t| (ContextHostApi & { host: Element })\n\t| (ContextHostApi & { element: Element })\n\t| (ContextHostApi & SsrHydrationContainer);\n\nexport function resolveContextHostElement(host: ContextHostLike): Element | null {\n\tif (host instanceof Element) {\n\t\treturn host;\n\t}\n\n\tif ('host' in host) {\n\t\treturn host.host;\n\t}\n\n\tif ('element' in host) {\n\t\treturn host.element;\n\t}\n\n\treturn null;\n}\n\nexport function resolveContextHydrationHost(host: ContextHostLike): ContextHydrationHost {\n\tif (host instanceof Element) {\n\t\treturn host;\n\t}\n\n\tif ('host' in host) {\n\t\treturn host.host;\n\t}\n\n\tif ('element' in host) {\n\t\treturn host.element;\n\t}\n\n\treturn host;\n}\n",
+    "import { createMarkupNodeLike, type JsxRenderable } from '@ecopages/jsx';\nimport type { SsrSerializableHydrationBinding } from '../core/ssr-hydration-binding';\nimport type { AttributeTypeConstant } from '../utils/attribute-utils';\nimport {\n\tContextEventsTypes,\n\tContextOnMountEvent,\n\ttype ContextRequestEvent,\n\ttype ContextSubscription,\n\ttype ContextSubscriptionRequestEvent,\n} from './events';\nimport { findHydrationScript, parseHydrationPayload } from '../core/hydration-codec';\nimport { createContextHydrationScriptTag, escapeContextHydrationJson } from './hydration-script';\nimport type { Context, ContextType, UnknownContext } from './types';\nimport { resolveContextHydrationHost, type ContextHostLike } from './context-host';\n\ntype ContextProviderOptions<T extends UnknownContext> = {\n\tcontext: UnknownContext;\n\thydrationKey?: string;\n\tinitialValue?: T['__context__'];\n\thydrate?: AttributeTypeConstant;\n\tserialize?: (value: ContextType<T>) => unknown;\n};\n\ntype ActiveContextSubscription<T extends UnknownContext> = {\n\thasChanged(newContext: ContextType<T>, prevContext: ContextType<T> | undefined): boolean;\n\tnotify(context: ContextType<T>): void;\n\tunsubscribe: () => void;\n};\n\nexport interface SsrSerializableContextProvider extends SsrSerializableHydrationBinding {\n\t/** Returns the current context payload that should be visible to descendants. */\n\tgetContext(): unknown;\n\t/** Returns the context token used to match nested SSR consumers and providers. */\n\tgetContextKey(): UnknownContext;\n}\n\n/**\n * Represents a context provider that allows setting and getting the context,\n * as well as subscribing to context updates.\n *\n * @template T - The type of the context.\n */\nexport interface IContextProvider<T extends Context<unknown, unknown>> {\n\t/**\n\t * Sets the context with the provided update and invokes the optional callback function.\n\t *\n\t * @param update - The partial update to be applied to the context.\n\t * @param callback - An optional callback function that receives the updated context.\n\t */\n\tsetContext: (update: Partial<ContextType<T>>, callback?: (context: ContextType<T>) => void) => void;\n\n\t/**\n\t * Gets the current context.\n\t *\n\t * @returns The current context.\n\t */\n\tgetContext: () => ContextType<T>;\n\n\t/**\n\t * Subscribes to context updates.\n\t *\n\t * @param subscription - The subscription object that defines the callback function to be invoked on context updates.\n\t */\n\tsubscribe: <Selected = ContextType<T>>(subscription: ContextSubscription<T, Selected>) => () => void;\n}\n\n/**\n * It creates a context provider that allows setting and getting the context,\n * It will also be in charge of notifying the subscribers when the context changes.\n *\n * @template T - The type of the context.\n * @implements IContextProvider\n *\n * @example\n * ```ts\n * export class MyElement extends RadiantElement {\n *  provider = new ContextProvider<typeof myContext>(this, {\n *    context: myContext,\n *    initialValue: {\n *      value: 'Hello World',\n *    },\n * });\n * ```\n */\nexport class ContextProvider<T extends Context<unknown, unknown>>\n\timplements IContextProvider<T>, SsrSerializableContextProvider\n{\n\tprivate host: ContextHostLike;\n\tprivate context: UnknownContext;\n\tprivate hydrationKey?: string;\n\tprivate hydrate?: AttributeTypeConstant;\n\tprivate serialize?: (value: ContextType<T>) => unknown;\n\tprivate pendingHostHydration: boolean;\n\tprivate value: ContextType<T> | undefined;\n\n\tsubscriptions: ActiveContextSubscription<T>[] = [];\n\n\t/**\n\t * Creates a new instance of the ContextProvider.\n\t *\n\t * @param host - The host element that will contain the context provider.\n\t * @param options - The options to configure the context provider.\n\t */\n\tconstructor(host: ContextHostLike, options: ContextProviderOptions<T>) {\n\t\tthis.host = host;\n\t\tthis.context = options.context;\n\t\tthis.hydrationKey = options.hydrationKey;\n\t\tthis.hydrate = options.hydrate;\n\t\tthis.serialize = options.serialize;\n\t\tthis.pendingHostHydration = Boolean(options.hydrate);\n\t\tthis.value = options.initialValue as ContextType<T>;\n\t\tthis.tryHydrateFromHost();\n\n\t\tthis.registerEvents();\n\t\tthis.host.dispatchEvent(new ContextOnMountEvent(this.context));\n\t}\n\n\tsetContext = (update: Partial<ContextType<T>>, callback?: (context: ContextType<T>) => void) => {\n\t\tthis.tryHydrateFromHost();\n\t\tthis.pendingHostHydration = false;\n\n\t\tif (typeof this.value === 'undefined' && this.isObject(update)) {\n\t\t\tconst oldContext = this.value;\n\t\t\tthis.value = { ...update } as ContextType<T>;\n\t\t\tif (callback) callback(this.value);\n\t\t\tthis.notifySubscribers(this.value, oldContext);\n\t\t\treturn;\n\t\t}\n\n\t\tif (this.isObject(this.value) && this.isObject(update)) {\n\t\t\tconst oldContext = { ...this.value };\n\t\t\tthis.value = { ...this.value, ...update };\n\t\t\tif (callback) callback(this.value);\n\t\t\tthis.notifySubscribers(this.value, oldContext);\n\t\t}\n\t};\n\n\tgetContext = () => {\n\t\tthis.tryHydrateFromHost();\n\t\treturn this.value as ContextType<T>;\n\t};\n\n\t/**\n\t * Returns the provider's logical context token.\n\t *\n\t * SSR helpers use this token to resolve the closest matching provider while a\n\t * host subtree is being serialized.\n\t */\n\tgetContextKey = () => {\n\t\treturn this.context;\n\t};\n\n\t/**\n\t * Serializes the current provider value for inclusion in a hydration script.\n\t *\n\t * The serialized payload is JSON-escaped so it can be embedded safely inside a\n\t * `<script type=\"application/json\">` tag.\n\t */\n\tserializeHydrationValue = (): string | undefined => {\n\t\tthis.tryHydrateFromHost();\n\n\t\tif (!this.hydrate || typeof this.value === 'undefined') {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst hydrationValue = this.serialize ? this.serialize(this.value) : this.value;\n\n\t\tif (typeof hydrationValue === 'undefined') {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst serializedValue = JSON.stringify(hydrationValue);\n\n\t\tif (typeof serializedValue !== 'string') {\n\t\t\treturn undefined;\n\t\t}\n\n\t\treturn escapeContextHydrationJson(serializedValue);\n\t};\n\n\t/**\n\t * Builds the raw HTML hydration script for this provider.\n\t *\n\t * When `hydrationKey` is present, the marker is scoped so sibling or nested\n\t * providers can recover their own payloads without accidentally reading a\n\t * descendant script.\n\t */\n\trenderHydrationScriptTag = (): string | undefined => {\n\t\tconst serializedValue = this.serializeHydrationValue();\n\n\t\tif (!serializedValue) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\treturn createContextHydrationScriptTag({\n\t\t\thydrationKey: this.hydrationKey,\n\t\t\tserializedValue,\n\t\t});\n\t};\n\n\t/**\n\t * Wraps the provider hydration script in a minimal JSX node-like value.\n\t *\n\t * This lets JSX-based host renderers append the script without needing a real\n\t * DOM element instance during SSR.\n\t */\n\trenderHydrationScript = (): JsxRenderable | undefined => {\n\t\tconst outerHTML = this.renderHydrationScriptTag();\n\n\t\tif (!outerHTML) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\treturn createMarkupNodeLike(outerHTML);\n\t};\n\n\tsubscribe = <Selected = ContextType<T>>(subscriptionSpec: ContextSubscription<T, Selected>) => {\n\t\tconst subscription: ActiveContextSubscription<T> = {\n\t\t\thasChanged: (newContext, prevContext) => {\n\t\t\t\tif (typeof prevContext === 'undefined' || !subscriptionSpec.select) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\n\t\t\t\treturn subscriptionSpec.select(newContext) !== subscriptionSpec.select(prevContext);\n\t\t\t},\n\t\t\tnotify: (context) => {\n\t\t\t\tif (subscriptionSpec.select) {\n\t\t\t\t\tsubscriptionSpec.callback(subscriptionSpec.select(context), subscription.unsubscribe);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tsubscriptionSpec.callback(context, subscription.unsubscribe);\n\t\t\t},\n\t\t\tunsubscribe: () => {\n\t\t\t\tconst index = this.subscriptions.indexOf(subscription);\n\n\t\t\t\tif (index !== -1) {\n\t\t\t\t\tthis.subscriptions.splice(index, 1);\n\t\t\t\t}\n\t\t\t},\n\t\t};\n\t\tthis.subscriptions.push(subscription);\n\n\t\treturn subscription.unsubscribe;\n\t};\n\n\tprivate tryHydrateFromHost(): void {\n\t\tif (!this.pendingHostHydration) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst hydrationScriptElement = this.findHydrationScriptElement();\n\n\t\tif (!hydrationScriptElement) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.value = this.mergeHydrationValue(\n\t\t\tparseHydrationPayload(hydrationScriptElement, this.value) as ContextType<T>,\n\t\t);\n\t\tthis.pendingHostHydration = false;\n\t}\n\n\tprivate mergeHydrationValue(parsedHydrationValue: ContextType<T>): ContextType<T> {\n\t\tif (\n\t\t\tthis.hydrate === Object &&\n\t\t\tthis.isObject(parsedHydrationValue) &&\n\t\t\t(this.isObject(this.value) || typeof this.value === 'undefined')\n\t\t) {\n\t\t\treturn {\n\t\t\t\t...(this.value ?? {}),\n\t\t\t\t...parsedHydrationValue,\n\t\t\t} as ContextType<T>;\n\t\t}\n\n\t\treturn parsedHydrationValue;\n\t}\n\n\tprivate isObject(value: unknown): value is Record<string, unknown> {\n\t\treturn typeof value === 'object' && !Array.isArray(value) && value !== null;\n\t}\n\n\tprivate findHydrationScriptElement(): Element | null {\n\t\treturn findHydrationScript(resolveContextHydrationHost(this.host), 'context', this.hydrationKey);\n\t}\n\n\tprivate notifySubscribers = (newContext: ContextType<T>, prevContext: ContextType<T> | undefined) => {\n\t\tfor (const sub of this.subscriptions) {\n\t\t\tif (sub.hasChanged(newContext, prevContext)) {\n\t\t\t\tsub.notify(newContext);\n\t\t\t}\n\t\t}\n\t};\n\n\tprivate handleSubscriptionRequest = (\n\t\tsubscription: ContextSubscription<T, unknown>,\n\t\t{\n\t\t\tsubscribe,\n\t\t\tonSubscribe,\n\t\t}: {\n\t\t\tsubscribe?: boolean;\n\t\t\tonSubscribe?: (unsubscribe: () => void) => void;\n\t\t},\n\t) => {\n\t\tthis.tryHydrateFromHost();\n\t\tconst unsubscribe = subscribe ? this.subscribe(subscription) : undefined;\n\n\t\tif (unsubscribe) {\n\t\t\tonSubscribe?.(unsubscribe);\n\t\t}\n\n\t\tif (typeof this.value === 'undefined') return;\n\n\t\tif (subscription.select) {\n\t\t\tsubscription.callback(subscription.select(this.value), unsubscribe);\n\t\t} else {\n\t\t\tsubscription.callback(this.value, unsubscribe);\n\t\t}\n\t};\n\n\tprivate onSubscriptionRequest = (event: ContextSubscriptionRequestEvent<UnknownContext>) => {\n\t\tconst { context, callback, subscribe, select, target, onSubscribe } = event;\n\t\tif (context !== this.context) return;\n\n\t\tevent.markHandled();\n\t\tevent.stopPropagation();\n\n\t\tif (target instanceof EventTarget) {\n\t\t\ttarget.dispatchEvent(new ContextOnMountEvent(this.context));\n\t\t}\n\n\t\tif (select) {\n\t\t\tthis.handleSubscriptionRequest({ select, callback }, { subscribe, onSubscribe });\n\t\t\treturn;\n\t\t}\n\n\t\tthis.handleSubscriptionRequest({ callback }, { subscribe, onSubscribe });\n\t};\n\n\tprivate onContextRequest = (event: ContextRequestEvent<UnknownContext>) => {\n\t\tconst { context, callback } = event;\n\t\tif (context !== this.context) return;\n\t\tevent.markHandled();\n\t\tevent.stopPropagation();\n\t\tcallback(this);\n\t};\n\n\tprivate registerEvents = () => {\n\t\tthis.host.addEventListener(\n\t\t\tContextEventsTypes.SUBSCRIPTION_REQUEST,\n\t\t\tthis.onSubscriptionRequest as EventListener,\n\t\t);\n\t\tthis.host.addEventListener(ContextEventsTypes.CONTEXT_REQUEST, this.onContextRequest as EventListener);\n\t};\n}\n",
+    "import type { ContextHostLike } from '../../context-host';\nimport { ContextProvider } from '../../context-provider';\nimport type { UnknownContext } from '../../types';\nimport type { ProvideContextOptions } from '../provide-context';\n\nexport function provideContext<T extends UnknownContext>({\n\tcontext,\n\tinitialValue,\n\thydrate,\n\tserialize,\n}: ProvideContextOptions<T>) {\n\treturn <C extends ContextHostLike, V>(target: undefined, targetContext: ClassFieldDecoratorContext<C, V>) => {\n\t\tvoid target;\n\t\tconst contextName = String(targetContext.name);\n\t\ttargetContext.addInitializer(function (this: C) {\n\t\t\tconst hostRecord = this as C & Record<string, unknown>;\n\t\t\tconst provider = new ContextProvider<T>(this, {\n\t\t\t\tcontext,\n\t\t\t\thydrationKey: contextName,\n\t\t\t\tinitialValue,\n\t\t\t\thydrate,\n\t\t\t\tserialize,\n\t\t\t});\n\t\t\thostRecord[contextName] = provider;\n\t\t\tthis.registerContextProvider(contextName, provider);\n\t\t\tthis.connectedContextCallback(context);\n\t\t});\n\t};\n}\n"
   ],
-  "mappings": "",
-  "debugId": "5442E2BDB3C0B0F764756E2164756E21",
+  "mappings": "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",
+  "debugId": "38CB6638F936059564756E2164756E21",
   "names": []
 }

package/dist/context/events.d.ts

@@ -22,15 +22,22 @@ export declare class ContextRequestEvent<T extends UnknownContext> extends Event
     readonly context: T;
     readonly callback: ContextCallback<ContextType<T>>;
     readonly subscribe?: boolean | undefined;
+    handled: boolean;
     constructor(context: T, callback: ContextCallback<ContextType<T>>, subscribe?: boolean | undefined);
+    markHandled(): void;
 }
 /**
  * A type which represents a subscription to a context value.
  */
-export type ContextSubscription<T extends UnknownContext> = {
-    select?: (context: ContextType<T>) => unknown;
-    callback: (value: unknown) => void;
+type DirectContextSubscription<T extends UnknownContext> = {
+    select?: undefined;
+    callback: ContextCallback<ContextType<T>>;
 };
+type SelectedContextSubscription<T extends UnknownContext, Selected> = {
+    select: (context: ContextType<T>) => Selected;
+    callback: ContextCallback<Selected>;
+};
+export type ContextSubscription<T extends UnknownContext, Selected = ContextType<T>> = DirectContextSubscription<T> | SelectedContextSubscription<T, Selected>;
 /**
  * An event fired by a context provider to signal that a context value has been mounted and is available for consumption.
  */
@@ -51,16 +58,15 @@ export declare class ContextOnMountEvent extends CustomEvent<{
  *
  * It accepts a `selector` property which can be used to request a specific property of the context value.
  */
-export declare class ContextSubscriptionRequestEvent<T extends UnknownContext> extends Event {
+export declare class ContextSubscriptionRequestEvent<T extends UnknownContext, Selected = ContextType<T>> extends Event {
     readonly context: T;
-    readonly callback: (value: ContextType<T> | {
-        [K in keyof ContextType<T>]: ContextType<T>[K];
-    }) => void;
-    readonly select?: ((context: ContextType<T>) => unknown) | undefined;
+    readonly callback: ContextCallback<Selected>;
+    readonly select?: ((context: ContextType<T>) => Selected) | undefined;
     readonly subscribe?: boolean | undefined;
-    constructor(context: T, callback: (value: ContextType<T> | {
-        [K in keyof ContextType<T>]: ContextType<T>[K];
-    }) => void, select?: ((context: ContextType<T>) => unknown) | undefined, subscribe?: boolean | undefined);
+    readonly onSubscribe?: ((unsubscribe: () => void) => void) | undefined;
+    handled: boolean;
+    constructor(context: T, callback: ContextCallback<Selected>, select?: ((context: ContextType<T>) => Selected) | undefined, subscribe?: boolean | undefined, onSubscribe?: ((unsubscribe: () => void) => void) | undefined);
+    markHandled(): void;
 }
 declare global {
     interface HTMLElementEventMap {
@@ -81,3 +87,4 @@ declare global {
         [ContextEventsTypes.ON_MOUNT]: ContextOnMountEvent;
     }
 }
+export {};

package/dist/context/events.js

@@ -1,3 +1,3 @@
-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};
+var H=((j)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(j,{get:(q,w)=>(typeof require<"u"?require:q)[w]}):j)(function(j){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+j+'" is not supported')});var z;((k)=>{k.SUBSCRIPTION_REQUEST="context-subscription-request";k.CONTEXT_REQUEST="context-request";k.ON_MOUNT="context-on-mount";k.MOUNTED="context-mounted"})(z||={});class B extends Event{context;callback;subscribe;handled=!1;constructor(j,q,w){super("context-request",{bubbles:!0,composed:!0});this.context=j;this.callback=q;this.subscribe=w}markHandled(){this.handled=!0}}class D extends CustomEvent{constructor(j){super("context-on-mount",{detail:{context:j},bubbles:!0,composed:!0})}}class F extends Event{context;callback;select;subscribe;onSubscribe;handled=!1;constructor(j,q,w,G,k){super("context-subscription-request",{bubbles:!0,composed:!0});this.context=j;this.callback=q;this.select=w;this.subscribe=G;this.onSubscribe=k}markHandled(){this.handled=!0}}export{F as ContextSubscriptionRequestEvent,B as ContextRequestEvent,D as ContextOnMountEvent,z as ContextEventsTypes};
 
-//# debugId=762415F16C70E00764756E2164756E21
+//# debugId=770F94756FFF592164756E2164756E21

package/dist/context/events.js.map

@@ -1,9 +1,10 @@
 {
   "version": 3,
-  "sources": [],
+  "sources": ["../src/context/events.ts"],
   "sourcesContent": [
+    "import type { Context, ContextCallback, ContextType, UnknownContext } from './types';\n\n/**\n * List of events which can be emitted by a context provider or requester.\n */\nexport enum ContextEventsTypes {\n\tSUBSCRIPTION_REQUEST = 'context-subscription-request',\n\tCONTEXT_REQUEST = 'context-request',\n\tON_MOUNT = 'context-on-mount',\n\tMOUNTED = '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\tpublic handled = false;\n\n\tpublic constructor(\n\t\tpublic readonly context: T,\n\t\tpublic readonly callback: ContextCallback<ContextType<T>>,\n\t\tpublic readonly subscribe?: boolean,\n\t) {\n\t\tsuper(ContextEventsTypes.CONTEXT_REQUEST, { bubbles: true, composed: true });\n\t}\n\n\tpublic markHandled(): void {\n\t\tthis.handled = true;\n\t}\n}\n\n/**\n * A type which represents a subscription to a context value.\n */\ntype DirectContextSubscription<T extends UnknownContext> = {\n\tselect?: undefined;\n\tcallback: ContextCallback<ContextType<T>>;\n};\n\ntype SelectedContextSubscription<T extends UnknownContext, Selected> = {\n\tselect: (context: ContextType<T>) => Selected;\n\tcallback: ContextCallback<Selected>;\n};\n\nexport type ContextSubscription<T extends UnknownContext, Selected = ContextType<T>> =\n\t| DirectContextSubscription<T>\n\t| SelectedContextSubscription<T, Selected>;\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\tpublic constructor(context: UnknownContext) {\n\t\tsuper(ContextEventsTypes.ON_MOUNT, {\n\t\t\tdetail: { context },\n\t\t\tbubbles: true,\n\t\t\tcomposed: true,\n\t\t});\n\t}\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, Selected = ContextType<T>> extends Event {\n\tpublic handled = false;\n\n\tpublic constructor(\n\t\tpublic readonly context: T,\n\t\tpublic readonly callback: ContextCallback<Selected>,\n\t\tpublic readonly select?: (context: ContextType<T>) => Selected,\n\t\tpublic readonly subscribe?: boolean,\n\t\tpublic readonly onSubscribe?: (unsubscribe: () => void) => void,\n\t) {\n\t\tsuper(ContextEventsTypes.SUBSCRIPTION_REQUEST, {\n\t\t\tbubbles: true,\n\t\t\tcomposed: true,\n\t\t});\n\t}\n\n\tpublic markHandled(): void {\n\t\tthis.handled = true;\n\t}\n}\n\ndeclare global {\n\tinterface HTMLElementEventMap {\n\t\t/**\n\t\t * A 'context-request-subscription' event can be emitted by any element which desires\n\t\t * a context value to be injected by an external provider.\n\t\t */\n\t\t[ContextEventsTypes.SUBSCRIPTION_REQUEST]: ContextSubscriptionRequestEvent<UnknownContext>;\n\t\t/**\n\t\t * A context-request-provider event can be emitted by a context requester to signal\n\t\t * that it desires a context value to be provided by a context provider.\n\t\t */\n\t\t[ContextEventsTypes.CONTEXT_REQUEST]: ContextRequestEvent<Context<unknown, unknown>>;\n\t\t/**\n\t\t * A 'context-mount' event can be emitted by a context provider to signal\n\t\t * that a context value has been mounted and is available for consumption.\n\t\t */\n\t\t[ContextEventsTypes.ON_MOUNT]: ContextOnMountEvent;\n\t}\n}\n"
   ],
-  "mappings": "",
-  "debugId": "762415F16C70E00764756E2164756E21",
+  "mappings": "2PAKO,IAAK,GAAL,CAAK,IAAL,CACN,uBAAuB,+BACvB,kBAAkB,kBAClB,WAAW,mBACX,UAAU,oBAJC,QAiBL,MAAM,UAAsD,KAAM,CAIvD,QACA,SACA,UALV,QAAU,GAEV,WAAW,CACD,EACA,EACA,EACf,CACD,MAAM,kBAAoC,CAAE,QAAS,GAAM,SAAU,EAAK,CAAC,EAJ3D,eACA,gBACA,iBAKV,WAAW,EAAS,CAC1B,KAAK,QAAU,GAEjB,CAsBO,MAAM,UAA4B,WAAyC,CAC1E,WAAW,CAAC,EAAyB,CAC3C,MAAM,mBAA6B,CAClC,OAAQ,CAAE,SAAQ,EAClB,QAAS,GACT,SAAU,EACX,CAAC,EAEH,CAcO,MAAM,UAA6F,KAAM,CAI9F,QACA,SACA,OACA,UACA,YAPV,QAAU,GAEV,WAAW,CACD,EACA,EACA,EACA,EACA,EACf,CACD,MAAM,+BAAyC,CAC9C,QAAS,GACT,SAAU,EACX,CAAC,EATe,eACA,gBACA,cACA,iBACA,mBAQV,WAAW,EAAS,CAC1B,KAAK,QAAU,GAEjB",
+  "debugId": "770F94756FFF592164756E2164756E21",
   "names": []
 }

package/dist/context/hydration-script.js

@@ -1,3 +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};
+var W=((g)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(g,{get:(q,z)=>(typeof require<"u"?require:q)[z]}):g)(function(g){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+g+'" is not supported')});function $(g){return g.replace(/&/g,"\\u0026").replace(/</g,"\\u003c").replace(/>/g,"\\u003e").replace(/\u2028/g,"\\u2028").replace(/\u2029/g,"\\u2029")}var V="data-hydration",u="data-hydration-type",Q="data-hydration-key";function w(g){let q=g.hydrationKey?` ${Q}="${J(g.hydrationKey)}"`:"";return`<script type="application/json" ${V} ${u}="${g.type}"${q}>${g.serializedValue}</script>`}function F(g){return $(g)}function S(g,q){let z=g.textContent;if(!z)return q;try{return JSON.parse(z)}catch{if(typeof console<"u")console.warn(`[@ecopages/radiant] Failed to parse hydration payload from <script ${V}>:`,z.slice(0,120));return q}}function f(g,q,z){let L=g.children;if(!L||L.length===0){let G=g.childNodes;if(!G||G.length===0)return null;for(let M=0;M<G.length;M+=1){let X=G[M];if(X.nodeType!==1)continue;let Z=X;if(j(Z,q,z))return Z}return null}for(let G=0;G<L.length;G+=1)if(j(L[G],q,z))return L[G];return null}function j(g,q,z){if(g.tagName!=="SCRIPT"||!g.hasAttribute(V)||g.getAttribute(u)!==q)return!1;if(z!==void 0)return g.getAttribute(Q)===z;return!g.hasAttribute(Q)}function J(g){return g.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function B(g){return w({type:"context",...g})}function D(g){return F(g)}export{D as escapeContextHydrationJson,B as createContextHydrationScriptTag};
 
-//# debugId=204037B251BD0C8664756E2164756E21
+//# debugId=530D675E1503267864756E2164756E21

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

@@ -1,9 +1,12 @@
 {
   "version": 3,
-  "sources": [],
+  "sources": ["../src/tools/escape-script-json.ts", "../src/core/hydration-codec.ts", "../src/context/hydration-script.ts"],
   "sourcesContent": [
+    "/**\n * Escapes serialized JSON so it remains safe when embedded inside an HTML\n * `<script>` tag.\n */\nexport function escapeScriptJson(value: string): string {\n\treturn value\n\t\t.replace(/&/g, '\\\\u0026')\n\t\t.replace(/</g, '\\\\u003c')\n\t\t.replace(/>/g, '\\\\u003e')\n\t\t.replace(/\\u2028/g, '\\\\u2028')\n\t\t.replace(/\\u2029/g, '\\\\u2029');\n}\n",
+    "import { escapeScriptJson } from '../tools/escape-script-json';\n\n/** Attribute marker used to identify hydration payloads inside a host. */\nexport const HYDRATION_ATTRIBUTE = 'data-hydration';\n/** Discriminator that scopes a hydration payload to a specific feature. */\nexport const HYDRATION_TYPE_ATTRIBUTE = 'data-hydration-type';\n/** Optional key that scopes a hydration payload to a specific decorated field. */\nexport const HYDRATION_KEY_ATTRIBUTE = 'data-hydration-key';\n\nexport type HydrationPayloadType = 'signal' | 'context';\n\ntype HydrationScriptHost = {\n\tchildren?: ArrayLike<Element> | undefined;\n\tchildNodes?: ArrayLike<{ nodeType: number }> | undefined;\n};\n\n/** Creates a `<script type=\"application/json\">` tag for a hydration payload. */\nexport function createHydrationScriptTag(options: {\n\ttype: HydrationPayloadType;\n\thydrationKey?: string;\n\tserializedValue: string;\n}): string {\n\tconst keyAttribute = options.hydrationKey\n\t\t? ` ${HYDRATION_KEY_ATTRIBUTE}=\"${escapeHtmlAttribute(options.hydrationKey)}\"`\n\t\t: '';\n\n\treturn `<script type=\"application/json\" ${HYDRATION_ATTRIBUTE} ${HYDRATION_TYPE_ATTRIBUTE}=\"${options.type}\"${keyAttribute}>${options.serializedValue}</script>`;\n}\n\n/** Escapes serialized JSON so it remains safe inside an HTML script tag. */\nexport function escapeHydrationJson(value: string): string {\n\treturn escapeScriptJson(value);\n}\n\n/** Parses JSON from a hydration script element, returning the fallback on failure. */\nexport function parseHydrationPayload<T>(element: Element, fallback: T): T {\n\tconst textContent = element.textContent;\n\n\tif (!textContent) {\n\t\treturn fallback;\n\t}\n\n\ttry {\n\t\treturn JSON.parse(textContent) as T;\n\t} catch {\n\t\tif (typeof console !== 'undefined') {\n\t\t\tconsole.warn(\n\t\t\t\t`[@ecopages/radiant] Failed to parse hydration payload from <script ${HYDRATION_ATTRIBUTE}>:`,\n\t\t\t\ttextContent.slice(0, 120),\n\t\t\t);\n\t\t}\n\t\treturn fallback;\n\t}\n}\n\n/**\n * Finds a hydration script element inside a host by type and optional key.\n *\n * When a key is provided, looks for an exact `data-hydration-key` match.\n * Otherwise, returns the first unkeyed script matching the type.\n */\nexport function findHydrationScript(\n\thost: HydrationScriptHost,\n\ttype: HydrationPayloadType,\n\thydrationKey?: string,\n): Element | null {\n\tconst children = host.children;\n\n\tif (!children || children.length === 0) {\n\t\tconst childNodes = (host as Partial<{ childNodes: ArrayLike<{ nodeType: number }> }>).childNodes;\n\n\t\tif (!childNodes || childNodes.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\tfor (let i = 0; i < childNodes.length; i += 1) {\n\t\t\tconst node = childNodes[i]!;\n\n\t\t\tif (node.nodeType !== 1) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst element = node as unknown as Element;\n\n\t\t\tif (matchesHydrationScript(element, type, hydrationKey)) {\n\t\t\t\treturn element;\n\t\t\t}\n\t\t}\n\n\t\treturn null;\n\t}\n\n\tfor (let i = 0; i < children.length; i += 1) {\n\t\tif (matchesHydrationScript(children[i]!, type, hydrationKey)) {\n\t\t\treturn children[i]!;\n\t\t}\n\t}\n\n\treturn null;\n}\n\nfunction matchesHydrationScript(element: Element, type: HydrationPayloadType, hydrationKey?: string): boolean {\n\tif (\n\t\telement.tagName !== 'SCRIPT' ||\n\t\t!element.hasAttribute(HYDRATION_ATTRIBUTE) ||\n\t\telement.getAttribute(HYDRATION_TYPE_ATTRIBUTE) !== type\n\t) {\n\t\treturn false;\n\t}\n\n\tif (hydrationKey !== undefined) {\n\t\treturn element.getAttribute(HYDRATION_KEY_ATTRIBUTE) === hydrationKey;\n\t}\n\n\treturn !element.hasAttribute(HYDRATION_KEY_ATTRIBUTE);\n}\n\nfunction escapeHtmlAttribute(value: string): string {\n\treturn value.replace(/&/g, '&amp;').replace(/\"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n}\n",
+    "import { createHydrationScriptTag, escapeHydrationJson } from '../core/hydration-codec';\n\n/**\n * Creates the raw `<script type=\"application/json\">` tag used to hydrate a\n * serialized context provider.\n */\nexport function createContextHydrationScriptTag(options: { hydrationKey?: string; serializedValue: string }): string {\n\treturn createHydrationScriptTag({ type: 'context', ...options });\n}\n\n/**\n * Escapes serialized JSON so it remains safe when embedded inside an HTML\n * script tag.\n */\nexport function escapeContextHydrationJson(value: string): string {\n\treturn escapeHydrationJson(value);\n}\n"
   ],
-  "mappings": "",
-  "debugId": "204037B251BD0C8664756E2164756E21",
+  "mappings": "2PAIO,SAAS,CAAgB,CAAC,EAAuB,CACvD,OAAO,EACL,QAAQ,KAAM,SAAS,EACvB,QAAQ,KAAM,SAAS,EACvB,QAAQ,KAAM,SAAS,EACvB,QAAQ,UAAW,SAAS,EAC5B,QAAQ,UAAW,SAAS,ECPxB,IAAM,EAAsB,iBAEtB,EAA2B,sBAE3B,EAA0B,qBAUhC,SAAS,CAAwB,CAAC,EAI9B,CACV,IAAM,EAAe,EAAQ,aAC1B,IAAI,MAA4B,EAAoB,EAAQ,YAAY,KACxE,GAEH,MAAO,mCAAmC,KAAuB,MAA6B,EAAQ,QAAQ,KAAgB,EAAQ,2BAIhI,SAAS,CAAmB,CAAC,EAAuB,CAC1D,OAAO,EAAiB,CAAK,EAIvB,SAAS,CAAwB,CAAC,EAAkB,EAAgB,CAC1E,IAAM,EAAc,EAAQ,YAE5B,GAAI,CAAC,EACJ,OAAO,EAGR,GAAI,CACH,OAAO,KAAK,MAAM,CAAW,EAC5B,KAAM,CACP,GAAI,OAAO,QAAY,IACtB,QAAQ,KACP,sEAAsE,MACtE,EAAY,MAAM,EAAG,GAAG,CACzB,EAED,OAAO,GAUF,SAAS,CAAmB,CAClC,EACA,EACA,EACiB,CACjB,IAAM,EAAW,EAAK,SAEtB,GAAI,CAAC,GAAY,EAAS,SAAW,EAAG,CACvC,IAAM,EAAc,EAAkE,WAEtF,GAAI,CAAC,GAAc,EAAW,SAAW,EACxC,OAAO,KAGR,QAAS,EAAI,EAAG,EAAI,EAAW,OAAQ,GAAK,EAAG,CAC9C,IAAM,EAAO,EAAW,GAExB,GAAI,EAAK,WAAa,EACrB,SAGD,IAAM,EAAU,EAEhB,GAAI,EAAuB,EAAS,EAAM,CAAY,EACrD,OAAO,EAIT,OAAO,KAGR,QAAS,EAAI,EAAG,EAAI,EAAS,OAAQ,GAAK,EACzC,GAAI,EAAuB,EAAS,GAAK,EAAM,CAAY,EAC1D,OAAO,EAAS,GAIlB,OAAO,KAGR,SAAS,CAAsB,CAAC,EAAkB,EAA4B,EAAgC,CAC7G,GACC,EAAQ,UAAY,UACpB,CAAC,EAAQ,aAAa,CAAmB,GACzC,EAAQ,aAAa,CAAwB,IAAM,EAEnD,MAAO,GAGR,GAAI,IAAiB,OACpB,OAAO,EAAQ,aAAa,CAAuB,IAAM,EAG1D,MAAO,CAAC,EAAQ,aAAa,CAAuB,EAGrD,SAAS,CAAmB,CAAC,EAAuB,CACnD,OAAO,EAAM,QAAQ,KAAM,OAAO,EAAE,QAAQ,KAAM,QAAQ,EAAE,QAAQ,KAAM,MAAM,EAAE,QAAQ,KAAM,MAAM,EChHhG,SAAS,CAA+B,CAAC,EAAqE,CACpH,OAAO,EAAyB,CAAE,KAAM,aAAc,CAAQ,CAAC,EAOzD,SAAS,CAA0B,CAAC,EAAuB,CACjE,OAAO,EAAoB,CAAK",
+  "debugId": "530D675E1503267864756E2164756E21",
   "names": []
 }

package/dist/controller-registry.d.ts

@@ -0,0 +1,28 @@
+import type { RadiantController } from './core/radiant-controller';
+export declare const CONTROLLER_ATTRIBUTE = "data-controller";
+export type ControllerConstructor<TController extends RadiantController = RadiantController> = new (host: Element) => TController;
+export type ControllerRegistrationStrategy = 'keep-current' | 'replace';
+export declare class ControllerRegistryRuntime {
+    private readonly root;
+    private readonly controllersByElement;
+    private observer?;
+    private stopped;
+    constructor(root?: ParentNode);
+    stop(): void;
+    reconcileRegisteredController(identifier: string): void;
+    replaceRegisteredController(identifier: string): void;
+    private start;
+    private reconcileElement;
+    private connectController;
+    private disconnectController;
+    private disconnectElementControllers;
+}
+export declare function registerController<TController extends RadiantController, TConstructor extends ControllerConstructor<TController>>(identifier: string, controller: TConstructor): TConstructor;
+export declare function hasRegisteredController(identifier: string): boolean;
+export declare function replaceController<TController extends RadiantController, TConstructor extends ControllerConstructor<TController>>(identifier: string, controller: TConstructor): TConstructor;
+export declare function setControllerRegistrationStrategy(strategy: ControllerRegistrationStrategy): void;
+export declare function enableControllerReplacementForHmr(): void;
+export declare function disableControllerReplacementForHmr(): void;
+export declare function registerControllerWithConfiguredStrategy<TController extends RadiantController, TConstructor extends ControllerConstructor<TController>>(identifier: string, controller: TConstructor): TConstructor;
+export declare function startControllers(root?: ParentNode): ControllerRegistryRuntime;
+export declare function stopControllers(): void;

package/dist/controller-registry.js

@@ -0,0 +1,3 @@
+var z=((E)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(E,{get:(C,I)=>(typeof require<"u"?require:C)[I]}):E)(function(E){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+E+'" is not supported')});var F=Symbol.for("@ecopages/radiant.controllerIdentifier");function D(E,C){E[F]=C}function B(E){return E[F]}var M="data-controller",_=Symbol.for("@ecopages/radiant.controller-registry-state");function k(){let E=globalThis,C=E[_];if(C)return C;let I={activeRuntimes:new Set,controllerRegistrationStrategy:"keep-current",controllerRegistry:new Map};return E[_]=I,I}var W=k(),h=W.controllerRegistry,T=W.activeRuntimes;function p(E){let C=E.getAttribute(M);if(!C)return[];return C.split(/\s+/).map((I)=>I.trim()).filter((I)=>I.length>0)}function u(E,C){if(E instanceof Element&&E.hasAttribute(M))C(E);for(let I of Array.from(E.querySelectorAll(`[${M}]`)))C(I)}class R{root;controllersByElement=new Map;observer;stopped=!1;constructor(E=document){this.root=E;this.start()}stop(){if(this.stopped)return;this.stopped=!0,this.observer?.disconnect(),this.observer=void 0;for(let[E,C]of this.controllersByElement)for(let[I]of C)this.disconnectController(E,I);T.delete(this)}reconcileRegisteredController(E){u(this.root,(C)=>{if(!p(C).includes(E))return;this.connectController(C,E)})}replaceRegisteredController(E){for(let[C,I]of Array.from(this.controllersByElement.entries())){if(!I.has(E))continue;this.disconnectController(C,E)}this.reconcileRegisteredController(E)}start(){if(u(this.root,(C)=>{this.reconcileElement(C)}),typeof MutationObserver>"u"){T.add(this);return}this.observer=new MutationObserver((C)=>{for(let I of C){if(I.type==="attributes"&&I.target instanceof Element){this.reconcileElement(I.target);continue}for(let L of Array.from(I.removedNodes)){if(!(L instanceof Element))continue;u(L,(O)=>{this.disconnectElementControllers(O)})}for(let L of Array.from(I.addedNodes)){if(!(L instanceof Element))continue;u(L,(O)=>{this.reconcileElement(O)})}}});let E=this.root instanceof Document?this.root.documentElement:this.root;this.observer.observe(E,{attributeFilter:[M],attributes:!0,childList:!0,subtree:!0}),T.add(this)}reconcileElement(E){let C=new Set(p(E)),I=this.controllersByElement.get(E);if(I){for(let L of I.keys())if(!C.has(L))this.disconnectController(E,L)}for(let L of C)this.connectController(E,L)}connectController(E,C){let I=h.get(C);if(!I)return;let L=this.controllersByElement.get(E);if(!L)L=new Map,this.controllersByElement.set(E,L);if(L.has(C))return;let O=new I(E);L.set(C,O),O.connect()}disconnectController(E,C){let I=this.controllersByElement.get(E);if(!I)return;let L=I.get(C);if(!L)return;if(L.disconnect(),I.delete(C),I.size===0)this.controllersByElement.delete(E)}disconnectElementControllers(E){let C=this.controllersByElement.get(E);if(!C)return;for(let I of Array.from(C.keys()))this.disconnectController(E,I)}}function q(E,C){let I=h.get(E);if(I)return I;D(C,E),h.set(E,C);for(let L of Array.from(T))L.reconcileRegisteredController(E);return C}function J(E){return h.has(E)}function w(E,C){if(h.get(E)===C)return C;D(C,E),h.set(E,C);for(let L of Array.from(T))L.replaceRegisteredController(E);return C}function j(E){W.controllerRegistrationStrategy=E}function K(){j("replace")}function N(){j("keep-current")}function P(E,C){if(W.controllerRegistrationStrategy==="replace")return w(E,C);return q(E,C)}function Q(E=document){return new R(E)}function U(){for(let E of Array.from(T))E.stop()}export{U as stopControllers,Q as startControllers,j as setControllerRegistrationStrategy,w as replaceController,P as registerControllerWithConfiguredStrategy,q as registerController,J as hasRegisteredController,K as enableControllerReplacementForHmr,N as disableControllerReplacementForHmr,R as ControllerRegistryRuntime,M as CONTROLLER_ATTRIBUTE};
+
+//# debugId=0DF824DAB57E9F9764756E2164756E21

package/dist/controller-registry.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/controller-metadata.ts", "../src/controller-registry.ts"],
+  "sourcesContent": [
+    "export const CONTROLLER_IDENTIFIER = Symbol.for('@ecopages/radiant.controllerIdentifier');\n\ntype ControllerConstructorWithMetadata = CustomElementConstructor & {\n\t[CONTROLLER_IDENTIFIER]?: string;\n};\n\nexport function setControllerIdentifier(target: CustomElementConstructor, identifier: string): void {\n\t(target as ControllerConstructorWithMetadata)[CONTROLLER_IDENTIFIER] = identifier;\n}\n\nexport function getControllerIdentifier(target: CustomElementConstructor): string | undefined {\n\treturn (target as ControllerConstructorWithMetadata)[CONTROLLER_IDENTIFIER];\n}\n",
+    "import type { RadiantController } from './core/radiant-controller';\nimport { setControllerIdentifier } from './core/controller-metadata';\n\nexport const CONTROLLER_ATTRIBUTE = 'data-controller';\n\nexport type ControllerConstructor<TController extends RadiantController = RadiantController> = new (\n\thost: Element,\n) => TController;\n\nexport type ControllerRegistrationStrategy = 'keep-current' | 'replace';\n\ntype ControllerRegistryGlobalState = {\n\tactiveRuntimes: Set<ControllerRegistryRuntime>;\n\tcontrollerRegistrationStrategy: ControllerRegistrationStrategy;\n\tcontrollerRegistry: Map<string, ControllerConstructor>;\n};\n\nconst CONTROLLER_REGISTRY_STATE_KEY = Symbol.for('@ecopages/radiant.controller-registry-state');\n\nfunction getControllerRegistryGlobalState(): ControllerRegistryGlobalState {\n\tconst globalScope = globalThis as typeof globalThis & Record<PropertyKey, unknown>;\n\tconst existingState = globalScope[CONTROLLER_REGISTRY_STATE_KEY];\n\n\tif (existingState) {\n\t\treturn existingState as ControllerRegistryGlobalState;\n\t}\n\n\tconst nextState: ControllerRegistryGlobalState = {\n\t\tactiveRuntimes: new Set<ControllerRegistryRuntime>(),\n\t\tcontrollerRegistrationStrategy: 'keep-current',\n\t\tcontrollerRegistry: new Map<string, ControllerConstructor>(),\n\t};\n\n\tglobalScope[CONTROLLER_REGISTRY_STATE_KEY] = nextState;\n\n\treturn nextState;\n}\n\nconst controllerRegistryState = getControllerRegistryGlobalState();\nconst controllerRegistry = controllerRegistryState.controllerRegistry;\nconst activeRuntimes = controllerRegistryState.activeRuntimes;\n\nfunction parseControllerIdentifiers(element: Element): string[] {\n\tconst value = element.getAttribute(CONTROLLER_ATTRIBUTE);\n\n\tif (!value) {\n\t\treturn [];\n\t}\n\n\treturn value\n\t\t.split(/\\s+/)\n\t\t.map((identifier) => identifier.trim())\n\t\t.filter((identifier) => identifier.length > 0);\n}\n\nfunction visitControllerElements(root: ParentNode, visit: (element: Element) => void): void {\n\tif (root instanceof Element && root.hasAttribute(CONTROLLER_ATTRIBUTE)) {\n\t\tvisit(root);\n\t}\n\n\tfor (const element of Array.from(root.querySelectorAll(`[${CONTROLLER_ATTRIBUTE}]`))) {\n\t\tvisit(element);\n\t}\n}\n\nexport class ControllerRegistryRuntime {\n\tprivate readonly controllersByElement = new Map<Element, Map<string, RadiantController>>();\n\tprivate observer?: MutationObserver;\n\tprivate stopped = false;\n\n\tconstructor(private readonly root: ParentNode = document) {\n\t\tthis.start();\n\t}\n\n\tpublic stop(): void {\n\t\tif (this.stopped) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.stopped = true;\n\t\tthis.observer?.disconnect();\n\t\tthis.observer = undefined;\n\n\t\tfor (const [element, controllers] of this.controllersByElement) {\n\t\t\tfor (const [identifier] of controllers) {\n\t\t\t\tthis.disconnectController(element, identifier);\n\t\t\t}\n\t\t}\n\n\t\tactiveRuntimes.delete(this);\n\t}\n\n\tpublic reconcileRegisteredController(identifier: string): void {\n\t\tvisitControllerElements(this.root, (element) => {\n\t\t\tif (!parseControllerIdentifiers(element).includes(identifier)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthis.connectController(element, identifier);\n\t\t});\n\t}\n\n\tpublic replaceRegisteredController(identifier: string): void {\n\t\tfor (const [element, controllers] of Array.from(this.controllersByElement.entries())) {\n\t\t\tif (!controllers.has(identifier)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tthis.disconnectController(element, identifier);\n\t\t}\n\n\t\tthis.reconcileRegisteredController(identifier);\n\t}\n\n\tprivate start(): void {\n\t\tvisitControllerElements(this.root, (element) => {\n\t\t\tthis.reconcileElement(element);\n\t\t});\n\n\t\tif (typeof MutationObserver === 'undefined') {\n\t\t\tactiveRuntimes.add(this);\n\t\t\treturn;\n\t\t}\n\n\t\tthis.observer = new MutationObserver((records) => {\n\t\t\tfor (const record of records) {\n\t\t\t\tif (record.type === 'attributes' && record.target instanceof Element) {\n\t\t\t\t\tthis.reconcileElement(record.target);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tfor (const removedNode of Array.from(record.removedNodes)) {\n\t\t\t\t\tif (!(removedNode instanceof Element)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tvisitControllerElements(removedNode, (element) => {\n\t\t\t\t\t\tthis.disconnectElementControllers(element);\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tfor (const addedNode of Array.from(record.addedNodes)) {\n\t\t\t\t\tif (!(addedNode instanceof Element)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tvisitControllerElements(addedNode, (element) => {\n\t\t\t\t\t\tthis.reconcileElement(element);\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\n\t\tconst observerRoot = this.root instanceof Document ? this.root.documentElement : this.root;\n\n\t\tthis.observer.observe(observerRoot, {\n\t\t\tattributeFilter: [CONTROLLER_ATTRIBUTE],\n\t\t\tattributes: true,\n\t\t\tchildList: true,\n\t\t\tsubtree: true,\n\t\t});\n\n\t\tactiveRuntimes.add(this);\n\t}\n\n\tprivate reconcileElement(element: Element): void {\n\t\tconst nextIdentifiers = new Set(parseControllerIdentifiers(element));\n\t\tconst currentControllers = this.controllersByElement.get(element);\n\n\t\tif (currentControllers) {\n\t\t\tfor (const identifier of currentControllers.keys()) {\n\t\t\t\tif (!nextIdentifiers.has(identifier)) {\n\t\t\t\t\tthis.disconnectController(element, identifier);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tfor (const identifier of nextIdentifiers) {\n\t\t\tthis.connectController(element, identifier);\n\t\t}\n\t}\n\n\tprivate connectController(element: Element, identifier: string): void {\n\t\tconst controllerConstructor = controllerRegistry.get(identifier);\n\n\t\tif (!controllerConstructor) {\n\t\t\treturn;\n\t\t}\n\n\t\tlet controllers = this.controllersByElement.get(element);\n\n\t\tif (!controllers) {\n\t\t\tcontrollers = new Map();\n\t\t\tthis.controllersByElement.set(element, controllers);\n\t\t}\n\n\t\tif (controllers.has(identifier)) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst controller = new controllerConstructor(element);\n\t\tcontrollers.set(identifier, controller);\n\t\tcontroller.connect();\n\t}\n\n\tprivate disconnectController(element: Element, identifier: string): void {\n\t\tconst controllers = this.controllersByElement.get(element);\n\n\t\tif (!controllers) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst controller = controllers.get(identifier);\n\n\t\tif (!controller) {\n\t\t\treturn;\n\t\t}\n\n\t\tcontroller.disconnect();\n\t\tcontrollers.delete(identifier);\n\n\t\tif (controllers.size === 0) {\n\t\t\tthis.controllersByElement.delete(element);\n\t\t}\n\t}\n\n\tprivate disconnectElementControllers(element: Element): void {\n\t\tconst controllers = this.controllersByElement.get(element);\n\n\t\tif (!controllers) {\n\t\t\treturn;\n\t\t}\n\n\t\tfor (const identifier of Array.from(controllers.keys())) {\n\t\t\tthis.disconnectController(element, identifier);\n\t\t}\n\t}\n}\n\nexport function registerController<\n\tTController extends RadiantController,\n\tTConstructor extends ControllerConstructor<TController>,\n>(identifier: string, controller: TConstructor): TConstructor {\n\tconst existingController = controllerRegistry.get(identifier);\n\n\tif (existingController) {\n\t\treturn existingController as TConstructor;\n\t}\n\n\tsetControllerIdentifier(controller as unknown as CustomElementConstructor, identifier);\n\tcontrollerRegistry.set(identifier, controller);\n\n\tfor (const runtime of Array.from(activeRuntimes)) {\n\t\truntime.reconcileRegisteredController(identifier);\n\t}\n\n\treturn controller;\n}\n\nexport function hasRegisteredController(identifier: string): boolean {\n\treturn controllerRegistry.has(identifier);\n}\n\nexport function replaceController<\n\tTController extends RadiantController,\n\tTConstructor extends ControllerConstructor<TController>,\n>(identifier: string, controller: TConstructor): TConstructor {\n\tconst existingController = controllerRegistry.get(identifier);\n\n\tif (existingController === controller) {\n\t\treturn controller;\n\t}\n\n\tsetControllerIdentifier(controller as unknown as CustomElementConstructor, identifier);\n\tcontrollerRegistry.set(identifier, controller);\n\n\tfor (const runtime of Array.from(activeRuntimes)) {\n\t\truntime.replaceRegisteredController(identifier);\n\t}\n\n\treturn controller;\n}\n\nexport function setControllerRegistrationStrategy(strategy: ControllerRegistrationStrategy): void {\n\tcontrollerRegistryState.controllerRegistrationStrategy = strategy;\n}\n\nexport function enableControllerReplacementForHmr(): void {\n\tsetControllerRegistrationStrategy('replace');\n}\n\nexport function disableControllerReplacementForHmr(): void {\n\tsetControllerRegistrationStrategy('keep-current');\n}\n\nexport function registerControllerWithConfiguredStrategy<\n\tTController extends RadiantController,\n\tTConstructor extends ControllerConstructor<TController>,\n>(identifier: string, controller: TConstructor): TConstructor {\n\tif (controllerRegistryState.controllerRegistrationStrategy === 'replace') {\n\t\treturn replaceController(identifier, controller);\n\t}\n\n\treturn registerController(identifier, controller);\n}\n\nexport function startControllers(root: ParentNode = document): ControllerRegistryRuntime {\n\treturn new ControllerRegistryRuntime(root);\n}\n\nexport function stopControllers(): void {\n\tfor (const runtime of Array.from(activeRuntimes)) {\n\t\truntime.stop();\n\t}\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "0DF824DAB57E9F9764756E2164756E21",
+  "names": []
+}

package/dist/core/controller-metadata.d.ts

@@ -0,0 +1,3 @@
+export declare const CONTROLLER_IDENTIFIER: unique symbol;
+export declare function setControllerIdentifier(target: CustomElementConstructor, identifier: string): void;
+export declare function getControllerIdentifier(target: CustomElementConstructor): string | undefined;

package/dist/core/controller-metadata.js

@@ -0,0 +1,3 @@
+var n=((t)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(t,{get:(o,e)=>(typeof require<"u"?require:o)[e]}):t)(function(t){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+t+'" is not supported')});var r=Symbol.for("@ecopages/radiant.controllerIdentifier");function s(t,o){t[r]=o}function l(t){return t[r]}export{s as setControllerIdentifier,l as getControllerIdentifier,r as CONTROLLER_IDENTIFIER};
+
+//# debugId=240DEA62DF81F58264756E2164756E21

package/dist/core/controller-metadata.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/controller-metadata.ts"],
+  "sourcesContent": [
+    "export const CONTROLLER_IDENTIFIER = Symbol.for('@ecopages/radiant.controllerIdentifier');\n\ntype ControllerConstructorWithMetadata = CustomElementConstructor & {\n\t[CONTROLLER_IDENTIFIER]?: string;\n};\n\nexport function setControllerIdentifier(target: CustomElementConstructor, identifier: string): void {\n\t(target as ControllerConstructorWithMetadata)[CONTROLLER_IDENTIFIER] = identifier;\n}\n\nexport function getControllerIdentifier(target: CustomElementConstructor): string | undefined {\n\treturn (target as ControllerConstructorWithMetadata)[CONTROLLER_IDENTIFIER];\n}\n"
+  ],
+  "mappings": "2PAAO,IAAM,EAAwB,OAAO,IAAI,wCAAwC,EAMjF,SAAS,CAAuB,CAAC,EAAkC,EAA0B,CAClG,EAA6C,GAAyB,EAGjE,SAAS,CAAuB,CAAC,EAAsD,CAC7F,OAAQ,EAA6C",
+  "debugId": "240DEA62DF81F58264756E2164756E21",
+  "names": []
+}

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

@@ -1,3 +1,14 @@
 export declare const CUSTOM_ELEMENT_TAG_NAME: unique symbol;
+/**
+ * Sets the custom element tag name for a given constructor.
+ * This is used internally to associate a class with its custom element tag, which is necessary for features like hydration and SSR support.
+ * @param target The constructor of the custom element.
+ * @param tagName The tag name to associate with the custom element.
+ */
 export declare function setCustomElementTagName(target: CustomElementConstructor, tagName: string): void;
+/**
+ * Retrieves the custom element tag name associated with a given constructor.
+ * @param target The constructor of the custom element.
+ * @returns The tag name associated with the custom element, or `undefined` if not set.
+ */
 export declare function getCustomElementTagName(target: CustomElementConstructor): string | undefined;

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

@@ -1,3 +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};
+var x=((b)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(b,{get:(j,q)=>(typeof require<"u"?require:j)[q]}):b)(function(b){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+b+'" is not supported')});var k=Symbol.for("@ecopages/radiant.customElementTagName");function z(b,j){b[k]=j}function B(b){return b[k]}export{z as setCustomElementTagName,B as getCustomElementTagName,k as CUSTOM_ELEMENT_TAG_NAME};
 
-//# debugId=A10222618D77E92E64756E2164756E21
+//# debugId=6FF28EF8DF0051FA64756E2164756E21

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

@@ -1,9 +1,10 @@
 {
   "version": 3,
-  "sources": [],
+  "sources": ["../src/core/custom-element-metadata.ts"],
   "sourcesContent": [
+    "export const CUSTOM_ELEMENT_TAG_NAME = Symbol.for('@ecopages/radiant.customElementTagName');\n\ntype CustomElementConstructorWithMetadata = CustomElementConstructor & {\n\t[CUSTOM_ELEMENT_TAG_NAME]?: string;\n};\n\n/**\n * Sets the custom element tag name for a given constructor.\n * This is used internally to associate a class with its custom element tag, which is necessary for features like hydration and SSR support.\n * @param target The constructor of the custom element.\n * @param tagName The tag name to associate with the custom element.\n */\nexport function setCustomElementTagName(target: CustomElementConstructor, tagName: string): void {\n\t(target as CustomElementConstructorWithMetadata)[CUSTOM_ELEMENT_TAG_NAME] = tagName;\n}\n\n/**\n * Retrieves the custom element tag name associated with a given constructor.\n * @param target The constructor of the custom element.\n * @returns The tag name associated with the custom element, or `undefined` if not set.\n */\nexport function getCustomElementTagName(target: CustomElementConstructor): string | undefined {\n\treturn (target as CustomElementConstructorWithMetadata)[CUSTOM_ELEMENT_TAG_NAME];\n}\n"
   ],
-  "mappings": "",
-  "debugId": "A10222618D77E92E64756E2164756E21",
+  "mappings": "2PAAO,IAAM,EAA0B,OAAO,IAAI,wCAAwC,EAYnF,SAAS,CAAuB,CAAC,EAAkC,EAAuB,CAC/F,EAAgD,GAA2B,EAQtE,SAAS,CAAuB,CAAC,EAAsD,CAC7F,OAAQ,EAAgD",
+  "debugId": "6FF28EF8DF0051FA64756E2164756E21",
   "names": []
 }

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

@@ -5,6 +5,12 @@ 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';
+type HydrationScriptHost = {
+    children?: ArrayLike<Element> | undefined;
+    childNodes?: ArrayLike<{
+        nodeType: number;
+    }> | undefined;
+};
 /** Creates a `<script type="application/json">` tag for a hydration payload. */
 export declare function createHydrationScriptTag(options: {
     type: HydrationPayloadType;
@@ -21,4 +27,5 @@ export declare function parseHydrationPayload<T>(element: Element, fallback: T):
  * 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;
+export declare function findHydrationScript(host: HydrationScriptHost, type: HydrationPayloadType, hydrationKey?: string): Element | null;
+export {};

package/dist/core/hydration-codec.js

@@ -1,3 +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};
+var j=((g)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(g,{get:(u,z)=>(typeof require<"u"?require:u)[z]}):g)(function(g){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+g+'" is not supported')});function V(g){return g.replace(/&/g,"\\u0026").replace(/</g,"\\u003c").replace(/>/g,"\\u003e").replace(/\u2028/g,"\\u2028").replace(/\u2029/g,"\\u2029")}var w="data-hydration",Z="data-hydration-type",q="data-hydration-key";function P(g){let u=g.hydrationKey?` ${q}="${$(g.hydrationKey)}"`:"";return`<script type="application/json" ${w} ${Z}="${g.type}"${u}>${g.serializedValue}</script>`}function x(g){return V(g)}function C(g,u){let z=g.textContent;if(!z)return u;try{return JSON.parse(z)}catch{if(typeof console<"u")console.warn(`[@ecopages/radiant] Failed to parse hydration payload from <script ${w}>:`,z.slice(0,120));return u}}function f(g,u,z){let L=g.children;if(!L||L.length===0){let J=g.childNodes;if(!J||J.length===0)return null;for(let M=0;M<J.length;M+=1){let G=J[M];if(G.nodeType!==1)continue;let Q=G;if(X(Q,u,z))return Q}return null}for(let J=0;J<L.length;J+=1)if(X(L[J],u,z))return L[J];return null}function X(g,u,z){if(g.tagName!=="SCRIPT"||!g.hasAttribute(w)||g.getAttribute(Z)!==u)return!1;if(z!==void 0)return g.getAttribute(q)===z;return!g.hasAttribute(q)}function $(g){return g.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}export{C as parseHydrationPayload,f as findHydrationScript,x as escapeHydrationJson,P as createHydrationScriptTag,Z as HYDRATION_TYPE_ATTRIBUTE,q as HYDRATION_KEY_ATTRIBUTE,w as HYDRATION_ATTRIBUTE};
 
-//# debugId=35B99D921CD92DC764756E2164756E21
+//# debugId=ADF85B332FA3E82264756E2164756E21

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

@@ -1,9 +1,11 @@
 {
   "version": 3,
-  "sources": [],
+  "sources": ["../src/tools/escape-script-json.ts", "../src/core/hydration-codec.ts"],
   "sourcesContent": [
+    "/**\n * Escapes serialized JSON so it remains safe when embedded inside an HTML\n * `<script>` tag.\n */\nexport function escapeScriptJson(value: string): string {\n\treturn value\n\t\t.replace(/&/g, '\\\\u0026')\n\t\t.replace(/</g, '\\\\u003c')\n\t\t.replace(/>/g, '\\\\u003e')\n\t\t.replace(/\\u2028/g, '\\\\u2028')\n\t\t.replace(/\\u2029/g, '\\\\u2029');\n}\n",
+    "import { escapeScriptJson } from '../tools/escape-script-json';\n\n/** Attribute marker used to identify hydration payloads inside a host. */\nexport const HYDRATION_ATTRIBUTE = 'data-hydration';\n/** Discriminator that scopes a hydration payload to a specific feature. */\nexport const HYDRATION_TYPE_ATTRIBUTE = 'data-hydration-type';\n/** Optional key that scopes a hydration payload to a specific decorated field. */\nexport const HYDRATION_KEY_ATTRIBUTE = 'data-hydration-key';\n\nexport type HydrationPayloadType = 'signal' | 'context';\n\ntype HydrationScriptHost = {\n\tchildren?: ArrayLike<Element> | undefined;\n\tchildNodes?: ArrayLike<{ nodeType: number }> | undefined;\n};\n\n/** Creates a `<script type=\"application/json\">` tag for a hydration payload. */\nexport function createHydrationScriptTag(options: {\n\ttype: HydrationPayloadType;\n\thydrationKey?: string;\n\tserializedValue: string;\n}): string {\n\tconst keyAttribute = options.hydrationKey\n\t\t? ` ${HYDRATION_KEY_ATTRIBUTE}=\"${escapeHtmlAttribute(options.hydrationKey)}\"`\n\t\t: '';\n\n\treturn `<script type=\"application/json\" ${HYDRATION_ATTRIBUTE} ${HYDRATION_TYPE_ATTRIBUTE}=\"${options.type}\"${keyAttribute}>${options.serializedValue}</script>`;\n}\n\n/** Escapes serialized JSON so it remains safe inside an HTML script tag. */\nexport function escapeHydrationJson(value: string): string {\n\treturn escapeScriptJson(value);\n}\n\n/** Parses JSON from a hydration script element, returning the fallback on failure. */\nexport function parseHydrationPayload<T>(element: Element, fallback: T): T {\n\tconst textContent = element.textContent;\n\n\tif (!textContent) {\n\t\treturn fallback;\n\t}\n\n\ttry {\n\t\treturn JSON.parse(textContent) as T;\n\t} catch {\n\t\tif (typeof console !== 'undefined') {\n\t\t\tconsole.warn(\n\t\t\t\t`[@ecopages/radiant] Failed to parse hydration payload from <script ${HYDRATION_ATTRIBUTE}>:`,\n\t\t\t\ttextContent.slice(0, 120),\n\t\t\t);\n\t\t}\n\t\treturn fallback;\n\t}\n}\n\n/**\n * Finds a hydration script element inside a host by type and optional key.\n *\n * When a key is provided, looks for an exact `data-hydration-key` match.\n * Otherwise, returns the first unkeyed script matching the type.\n */\nexport function findHydrationScript(\n\thost: HydrationScriptHost,\n\ttype: HydrationPayloadType,\n\thydrationKey?: string,\n): Element | null {\n\tconst children = host.children;\n\n\tif (!children || children.length === 0) {\n\t\tconst childNodes = (host as Partial<{ childNodes: ArrayLike<{ nodeType: number }> }>).childNodes;\n\n\t\tif (!childNodes || childNodes.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\tfor (let i = 0; i < childNodes.length; i += 1) {\n\t\t\tconst node = childNodes[i]!;\n\n\t\t\tif (node.nodeType !== 1) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst element = node as unknown as Element;\n\n\t\t\tif (matchesHydrationScript(element, type, hydrationKey)) {\n\t\t\t\treturn element;\n\t\t\t}\n\t\t}\n\n\t\treturn null;\n\t}\n\n\tfor (let i = 0; i < children.length; i += 1) {\n\t\tif (matchesHydrationScript(children[i]!, type, hydrationKey)) {\n\t\t\treturn children[i]!;\n\t\t}\n\t}\n\n\treturn null;\n}\n\nfunction matchesHydrationScript(element: Element, type: HydrationPayloadType, hydrationKey?: string): boolean {\n\tif (\n\t\telement.tagName !== 'SCRIPT' ||\n\t\t!element.hasAttribute(HYDRATION_ATTRIBUTE) ||\n\t\telement.getAttribute(HYDRATION_TYPE_ATTRIBUTE) !== type\n\t) {\n\t\treturn false;\n\t}\n\n\tif (hydrationKey !== undefined) {\n\t\treturn element.getAttribute(HYDRATION_KEY_ATTRIBUTE) === hydrationKey;\n\t}\n\n\treturn !element.hasAttribute(HYDRATION_KEY_ATTRIBUTE);\n}\n\nfunction escapeHtmlAttribute(value: string): string {\n\treturn value.replace(/&/g, '&amp;').replace(/\"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n}\n"
   ],
-  "mappings": "",
-  "debugId": "35B99D921CD92DC764756E2164756E21",
+  "mappings": "2PAIO,SAAS,CAAgB,CAAC,EAAuB,CACvD,OAAO,EACL,QAAQ,KAAM,SAAS,EACvB,QAAQ,KAAM,SAAS,EACvB,QAAQ,KAAM,SAAS,EACvB,QAAQ,UAAW,SAAS,EAC5B,QAAQ,UAAW,SAAS,ECPxB,IAAM,EAAsB,iBAEtB,EAA2B,sBAE3B,EAA0B,qBAUhC,SAAS,CAAwB,CAAC,EAI9B,CACV,IAAM,EAAe,EAAQ,aAC1B,IAAI,MAA4B,EAAoB,EAAQ,YAAY,KACxE,GAEH,MAAO,mCAAmC,KAAuB,MAA6B,EAAQ,QAAQ,KAAgB,EAAQ,2BAIhI,SAAS,CAAmB,CAAC,EAAuB,CAC1D,OAAO,EAAiB,CAAK,EAIvB,SAAS,CAAwB,CAAC,EAAkB,EAAgB,CAC1E,IAAM,EAAc,EAAQ,YAE5B,GAAI,CAAC,EACJ,OAAO,EAGR,GAAI,CACH,OAAO,KAAK,MAAM,CAAW,EAC5B,KAAM,CACP,GAAI,OAAO,QAAY,IACtB,QAAQ,KACP,sEAAsE,MACtE,EAAY,MAAM,EAAG,GAAG,CACzB,EAED,OAAO,GAUF,SAAS,CAAmB,CAClC,EACA,EACA,EACiB,CACjB,IAAM,EAAW,EAAK,SAEtB,GAAI,CAAC,GAAY,EAAS,SAAW,EAAG,CACvC,IAAM,EAAc,EAAkE,WAEtF,GAAI,CAAC,GAAc,EAAW,SAAW,EACxC,OAAO,KAGR,QAAS,EAAI,EAAG,EAAI,EAAW,OAAQ,GAAK,EAAG,CAC9C,IAAM,EAAO,EAAW,GAExB,GAAI,EAAK,WAAa,EACrB,SAGD,IAAM,EAAU,EAEhB,GAAI,EAAuB,EAAS,EAAM,CAAY,EACrD,OAAO,EAIT,OAAO,KAGR,QAAS,EAAI,EAAG,EAAI,EAAS,OAAQ,GAAK,EACzC,GAAI,EAAuB,EAAS,GAAK,EAAM,CAAY,EAC1D,OAAO,EAAS,GAIlB,OAAO,KAGR,SAAS,CAAsB,CAAC,EAAkB,EAA4B,EAAgC,CAC7G,GACC,EAAQ,UAAY,UACpB,CAAC,EAAQ,aAAa,CAAmB,GACzC,EAAQ,aAAa,CAAwB,IAAM,EAEnD,MAAO,GAGR,GAAI,IAAiB,OACpB,OAAO,EAAQ,aAAa,CAAuB,IAAM,EAG1D,MAAO,CAAC,EAAQ,aAAa,CAAuB,EAGrD,SAAS,CAAmB,CAAC,EAAuB,CACnD,OAAO,EAAM,QAAQ,KAAM,OAAO,EAAE,QAAQ,KAAM,QAAQ,EAAE,QAAQ,KAAM,MAAM,EAAE,QAAQ,KAAM,MAAM",
+  "debugId": "ADF85B332FA3E82264756E2164756E21",
   "names": []
 }

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

@@ -1,25 +1,25 @@
 import type { JsxRenderable } from '@ecopages/jsx';
 import type { RenderToStringOptions } from '@ecopages/jsx/server';
 /**
- * Optional SSR hooks exposed by `RadiantComponent` instances to the shared
+ * Optional SSR hooks exposed by `RadiantElement` 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 = {
+export type RadiantElementRenderBridge = {
     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
+ * This is intentionally narrower than `RadiantElement` itself so the server
  * runtime can stay decoupled from the full client base-class implementation.
  */
-export type RadiantComponentSsrCapable = HTMLElement & {
-    resolveSsrRenderBridge?: () => RadiantComponentRenderBridge;
+export type RadiantElementSsrCapable = HTMLElement & {
+    resolveSsrRenderBridge?: () => RadiantElementRenderBridge;
     getHostSsrAttributes?: () => Record<string, string>;
     renderToString(options?: RenderToStringOptions): string;
     renderHost?(): JsxRenderable;
@@ -32,23 +32,23 @@ export type RadiantComponentSsrCapable = HTMLElement & {
  * 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;
+export type RadiantElementSsrRuntime = {
+    getHostAttributes(component: RadiantElementSsrCapable): Record<string, string>;
+    renderHost(component: RadiantElementSsrCapable): JsxRenderable;
+    renderHostToString(component: RadiantElementSsrCapable, options?: RenderToStringOptions): string;
+    resolveRenderBridge(component: RadiantElementSsrCapable): RadiantElementRenderBridge | undefined;
+    renderView(component: RadiantElementSsrCapable, 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;
+export declare function getRadiantElementSsrRuntime(): RadiantElementSsrRuntime | 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;
+export declare function registerRadiantElementSsrRuntime(runtime: RadiantElementSsrRuntime): void;

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

@@ -1,3 +1,3 @@
-import{Ta as a,Ua as b}from"../chunk-e0r6ca2g.js";import"../chunk-vgtggzb6.js";export{b as registerRadiantComponentSsrRuntime,a as getRadiantComponentSsrRuntime};
+var f=((a)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(a,{get:(c,d)=>(typeof require<"u"?require:c)[d]}):a)(function(a){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+a+'" is not supported')});var b=Symbol.for("@ecopages/radiant.component-ssr-runtime");function h(){return globalThis[b]}function j(a){globalThis[b]=a}export{j as registerRadiantElementSsrRuntime,h as getRadiantElementSsrRuntime};
 
-//# debugId=0DE7ED0BDBAD0C8D64756E2164756E21
+//# debugId=7A43EF7E4BF0DC2964756E2164756E21

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

@@ -1,9 +1,10 @@
 {
   "version": 3,
-  "sources": [],
+  "sources": ["../src/core/radiant-component-ssr-registry.ts"],
   "sourcesContent": [
+    "import type { JsxRenderable } from '@ecopages/jsx';\nimport type { RenderToStringOptions } from '@ecopages/jsx/server';\n\n/**\n * Optional SSR hooks exposed by `RadiantElement` instances to the shared\n * server runtime.\n *\n * The bridge lets the runtime detect whether a component is still using the\n * inherited host SSR implementation or has taken ownership of host rendering\n * through explicit overrides.\n */\nexport type RadiantElementRenderBridge = {\n\trenderHost?: () => JsxRenderable;\n\trenderHostToString?: (options?: RenderToStringOptions) => string;\n};\n\n/**\n * Runtime shape required by the shared Radiant SSR helpers.\n *\n * This is intentionally narrower than `RadiantElement` itself so the server\n * runtime can stay decoupled from the full client base-class implementation.\n */\nexport type RadiantElementSsrCapable = HTMLElement & {\n\tresolveSsrRenderBridge?: () => RadiantElementRenderBridge;\n\tgetHostSsrAttributes?: () => Record<string, string>;\n\trenderToString(options?: RenderToStringOptions): string;\n\trenderHost?(): JsxRenderable;\n\trenderHostToString(options?: RenderToStringOptions): string;\n};\n\n/**\n * Shared SSR runtime contract registered on `globalThis`.\n *\n * Server entrypoints install one implementation that both direct component SSR\n * and nested JSX custom-element SSR can reuse without importing client-only\n * internals into every call site.\n */\nexport type RadiantElementSsrRuntime = {\n\tgetHostAttributes(component: RadiantElementSsrCapable): Record<string, string>;\n\trenderHost(component: RadiantElementSsrCapable): JsxRenderable;\n\trenderHostToString(component: RadiantElementSsrCapable, options?: RenderToStringOptions): string;\n\tresolveRenderBridge(component: RadiantElementSsrCapable): RadiantElementRenderBridge | undefined;\n\trenderView(component: RadiantElementSsrCapable, options?: RenderToStringOptions): string;\n};\n\nconst RADIANT_COMPONENT_SSR_RUNTIME_SYMBOL = Symbol.for('@ecopages/radiant.component-ssr-runtime');\n\ntype GlobalSsrRuntimeState = typeof globalThis & {\n\t[RADIANT_COMPONENT_SSR_RUNTIME_SYMBOL]?: RadiantElementSsrRuntime;\n};\n\n/**\n * Reads the currently registered Radiant SSR runtime from `globalThis`.\n *\n * Returns `undefined` when no server entrypoint has installed the runtime yet.\n */\nexport function getRadiantElementSsrRuntime(): RadiantElementSsrRuntime | undefined {\n\treturn (globalThis as GlobalSsrRuntimeState)[RADIANT_COMPONENT_SSR_RUNTIME_SYMBOL];\n}\n\n/**\n * Registers the shared Radiant SSR runtime on `globalThis`.\n *\n * The latest registration wins, which keeps server adapters free to install\n * the runtime eagerly from their own explicit entrypoint.\n */\nexport function registerRadiantElementSsrRuntime(runtime: RadiantElementSsrRuntime): void {\n\t(globalThis as GlobalSsrRuntimeState)[RADIANT_COMPONENT_SSR_RUNTIME_SYMBOL] = runtime;\n}\n"
   ],
-  "mappings": "",
-  "debugId": "0DE7ED0BDBAD0C8D64756E2164756E21",
+  "mappings": "2PA6CA,IAAM,EAAuC,OAAO,IAAI,yCAAyC,EAW1F,SAAS,CAA2B,EAAyC,CACnF,OAAQ,WAAqC,GASvC,SAAS,CAAgC,CAAC,EAAyC,CACxF,WAAqC,GAAwC",
+  "debugId": "7A43EF7E4BF0DC2964756E2164756E21",
   "names": []
 }

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

@@ -4,7 +4,7 @@ import type { SsrSerializableContextProvider } from '../context/context-provider
 import type { ReactiveProperty } from './radiant-element';
 import type { ReactivePropDefinition } from './reactive-prop-metadata';
 import type { SsrSerializableHydrationBinding } from './ssr-hydration-binding';
-type RadiantComponentSsrHost = {
+type RadiantElementSsrHost = {
     constructor: CustomElementConstructor;
     getAuthoredHydrationScriptMarkup?: () => string | undefined;
     getContextProviders: () => SsrSerializableContextProvider[];
@@ -17,9 +17,9 @@ type RadiantComponentSsrHost = {
     listAttributeNames: () => string[];
     getAttributeValue: (name: string) => string | null;
 };
-export declare class RadiantComponentSsrService {
+export declare class RadiantElementSsrService {
     private readonly host;
-    constructor(host: RadiantComponentSsrHost);
+    constructor(host: RadiantElementSsrHost);
     renderHost(): JsxRenderable;
     renderHostToString(options?: RenderToStringOptions, attributes?: Record<string, string>): string;
     private renderHostContent;

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

@@ -1,3 +1,3 @@
-import{g as a}from"../chunk-zygdebw8.js";import"../chunk-ssnnxzrj.js";import"../chunk-hztr86b4.js";import"../chunk-t8xtvgyg.js";import"../chunk-66e6s792.js";import"../chunk-vgtggzb6.js";export{a as RadiantComponentSsrService};
+var x=((t)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(t,{get:(n,i)=>(typeof require<"u"?require:n)[i]}):t)(function(t){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+t+'" is not supported')});function p(t){switch(t){case Array:return"array";case Boolean:return"boolean";case Number:return"number";case Object:return"object";case String:return"string"}}function Q(t){switch(typeof t){case"boolean":return"boolean";case"number":return"number";case"string":return"string"}if(Array.isArray(t))return"array";if(Object.prototype.toString.call(t)==="[object Object]")return"object"}function W(t){switch(t){case Number:return 0;case String:return"";case Boolean:return!1;default:return null}}function Z(t){try{return JSON.parse(t)}catch{throw TypeError("Invalid JSON string")}}var C={array(t){let n=Z(t);if(!Array.isArray(n))throw TypeError(`Expected an array but got a value of type "${typeof n}"`);return n},boolean(t){return!(t==="0"||String(t).toLowerCase()==="false")},number(t){return Number(t.replace(/_/g,""))},object(t){let n=JSON.parse(t);if(n===null||typeof n!=="object"||Array.isArray(n))throw TypeError(`expected value of type "object" but instead got value "${t}" of type "${Q(n)}"`);return n},string(t){return t}},c={default:H,array:h,object:h};function h(t){return JSON.stringify(t)}function H(t){return`${t}`}function d(t,n){let i=p(n);if(!i)throw TypeError(`[radiant-element] Unknown type "${n}"`);return C[i](t)}function P(t,n){let i=p(n);if(!i)throw TypeError(`[radiant-element] Unknown type "${n}"`);return(c[i]??c.default??H)(t)}function J(t){return typeof t==="boolean"}function k(t){return typeof t==="number"}function I(t){return typeof t==="string"}function U(t){return Array.isArray(t)}function y(t){return typeof t==="object"&&!Array.isArray(t)&&t!==null}function G(t,n){switch(t){case Boolean:return J(n);case Number:return k(n);case String:return I(n);case Array:return U(n);case Object:return y(n);default:return!1}}var X=(t,n,i,r)=>{if(n===Boolean){let s=t.getAttribute(i);if(s===null)return r;return s===""?!0:d(s,n)}let o=t.getAttribute(i);return o!==null?d(o,n):r??W(n)};var e=Symbol.for("@ecopages/radiant.ssr-context-provider-resolver");function $(){return globalThis}function f(t){$()[e]=t}function N(t){return $()[e]?.(t)}var b=Symbol.for("@ecopages/radiant.customElementTagName");function K(t,n){t[b]=n}function z(t){return t[b]}var g;function S(){if(g!==void 0)return g;try{let{AsyncLocalStorage:t}=(()=>{throw new Error("Cannot require module "+"node:async_hooks");})();return g=new t,g}catch{return g=null,null}}var R=Symbol.for("@ecopages/radiant.ssr-context-fallback-stack");function j(){let t=globalThis;return t[R]??=[],t[R]}function q(t){if(t.length===0)return()=>{return};let n=new Map;for(let o of t)n.set(o.getContextKey(),o);let i=S();if(i){let o=i.getStore()??[],s=[...o,n];return i.enterWith(s),()=>{i.enterWith(o)}}let r=j();return r.push(n),()=>{let o=r.lastIndexOf(n);if(o>=0)r.splice(o,1)}}function D(t){let n=S()?.getStore()??j();for(let i=n.length-1;i>=0;i-=1){let r=n[i]?.get(t);if(r)return r}return}function L(t){let n=D(t);if(!n)return;return n.getContext()}f((t)=>D(t));class B{host;constructor(t){this.host=t}renderHost(){return{nodeType:1,outerHTML:this.renderHostToString({mode:"hydrate"})}}renderHostToString(t={},n=this.getHostAttributes()){let i=this.getTagName(),r=q(this.host.getContextProviders());try{return`<${i}${F(n)}>${this.renderHostContent(t)}</${i}>`}finally{r()}}renderHostContent(t){let n=this.host.renderToString(t),i=this.host.getAuthoredHydrationScriptMarkup?.()??"",r=this.host.getSlotProjectionScriptTag?.()??"";if(!(t.mode==="hydrate"||t.mode===void 0&&t.hydrate===!0))return`${n}${i}${r}`;let s=this.host.getHydrationBindings().map((m)=>m.renderHydrationScriptTag()).filter((m)=>typeof m==="string").join("");return`${n}${r}${s}`}getHostAttributes(){let t={},n=new Set;for(let i of this.host.getReactiveProperties()){let r=this.host.getPropertyValue(i.name);if(r===void 0||r===null||r===!1)continue;t[i.attribute]=String(i.converter.toAttribute(r)),n.add(i.attribute)}for(let i of this.host.getReactivePropDefinitions()){let r=i.options.attribute??i.name;if(n.has(r))continue;let o=this.host.getPropertyValue(i.name);if(o===void 0||o===null||o===!1)continue;t[r]=String(P(o,i.options.type)),n.add(r)}for(let i of this.host.listAttributeNames()){let r=this.host.getAttributeValue(i);if(r!==null)t[i]=r}return t}getTagName(){let t=z(this.host.constructor);if(!t)throw Error(`${this.host.constructor.name} is missing @customElement metadata.`);return t}}function F(t){return Object.entries(t).map(([n,i])=>` ${n}="${w(i)}"`).join("")}function w(t){return t.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}export{B as RadiantElementSsrService};
 
-//# debugId=F6B36BC49A26138E64756E2164756E21
+//# debugId=16B2C294F53D386064756E2164756E21