@ecopages/radiant 0.2.0 → 0.3.0-alpha.1

package/dist/chunk-wwbjz9k4.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/helpers/create-query.ts"],
+  "sourcesContent": [
+    "type BaseQueryConfig = {\n\tall?: boolean;\n\tcache?: boolean;\n\tscope?: QueryScope;\n};\n\ntype QueryBySelector = { selector: string };\n\ntype QueryByRef = { ref: string };\n\n/**\n * Selects which DOM tree a query should read from.\n */\nexport type QueryScope = 'light' | 'shadow' | 'both';\n\nexport type QueryConfig = BaseQueryConfig & (QueryBySelector | QueryByRef);\n\ntype QueryRoot = Element | ShadowRoot;\n\ntype QueryResult<T extends Element | Element[]> = {\n\tget value(): T | null;\n};\n\nfunction getQueryRoots(host: HTMLElement, scope: QueryScope = 'light'): QueryRoot[] {\n\tif (scope === 'shadow') {\n\t\treturn host.shadowRoot ? [host.shadowRoot] : [];\n\t}\n\n\tif (scope === 'both') {\n\t\treturn host.shadowRoot ? [host, host.shadowRoot] : [host];\n\t}\n\n\treturn [host];\n}\n\n/**\n * Creates a lazy DOM query accessor bound to a host element.\n * Functional equivalent of the `@query` decorator for vanilla JS usage.\n * @param host The host element to query within.\n * @param options {@link QueryConfig} The query configuration.\n */\nexport function createQuery<T extends Element | Element[] = Element>(\n\thost: HTMLElement,\n\toptions: QueryConfig,\n): QueryResult<T> {\n\tconst selector = 'selector' in options ? options.selector : `[data-ref=\"${options.ref}\"]`;\n\tlet cached: T | null = null;\n\n\tconst executeQuery = (): T | null => {\n\t\tconst roots = getQueryRoots(host, options.scope);\n\n\t\tif (options?.all) {\n\t\t\treturn roots.flatMap((root) => Array.from(root.querySelectorAll(selector))) as T;\n\t\t}\n\n\t\tfor (const root of roots) {\n\t\t\tconst match = root.querySelector(selector);\n\t\t\tif (match) {\n\t\t\t\treturn match as T;\n\t\t\t}\n\t\t}\n\n\t\treturn null;\n\t};\n\n\treturn {\n\t\tget value(): T | null {\n\t\t\tif (options?.cache) {\n\t\t\t\tif (cached === null || (options?.all && Array.isArray(cached) && !cached.length)) {\n\t\t\t\t\tcached = executeQuery();\n\t\t\t\t}\n\t\t\t\treturn cached;\n\t\t\t}\n\t\t\treturn executeQuery();\n\t\t},\n\t};\n}\n"
+  ],
+  "mappings": "AAuBA,SAAS,CAAa,CAAC,EAAmB,EAAoB,QAAsB,CACnF,GAAI,IAAU,SACb,OAAO,EAAK,WAAa,CAAC,EAAK,UAAU,EAAI,CAAC,EAG/C,GAAI,IAAU,OACb,OAAO,EAAK,WAAa,CAAC,EAAM,EAAK,UAAU,EAAI,CAAC,CAAI,EAGzD,MAAO,CAAC,CAAI,EASN,SAAS,CAAoD,CACnE,EACA,EACiB,CACjB,IAAM,EAAW,aAAc,EAAU,EAAQ,SAAW,cAAc,EAAQ,QAC9E,EAAmB,KAEjB,EAAe,IAAgB,CACpC,IAAM,EAAQ,EAAc,EAAM,EAAQ,KAAK,EAE/C,GAAI,GAAS,IACZ,OAAO,EAAM,QAAQ,CAAC,IAAS,MAAM,KAAK,EAAK,iBAAiB,CAAQ,CAAC,CAAC,EAG3E,QAAW,KAAQ,EAAO,CACzB,IAAM,EAAQ,EAAK,cAAc,CAAQ,EACzC,GAAI,EACH,OAAO,EAIT,OAAO,MAGR,MAAO,IACF,MAAK,EAAa,CACrB,GAAI,GAAS,MAAO,CACnB,GAAI,IAAW,MAAS,GAAS,KAAO,MAAM,QAAQ,CAAM,GAAK,CAAC,EAAO,OACxE,EAAS,EAAa,EAEvB,OAAO,EAER,OAAO,EAAa,EAEtB",
+  "debugId": "1E0A21D80A81956B64756E2164756E21",
+  "names": []
+}

package/dist/chunk-x2k0ngpz.js

@@ -0,0 +1,4 @@
+import{G as B}from"./chunk-5bkat72n.js";import{I as z,K as A}from"./chunk-p8k4g99a.js";function L({context:f,select:j,subscribe:E=!0,requestUpdate:F=!0}){return function(G,H){H.addInitializer(function(){let k=B(this,(I)=>{G.call(this,I)},F);if(z(this,f,k,j))return;let w=()=>{A(this,f,k,{select:j,subscribe:E})};this.registerConnectedCallback(()=>{w()}),queueMicrotask(w)})}}
+export{L as E};
+
+//# debugId=998D5926E232DF2A64756E2164756E21

package/dist/chunk-x2k0ngpz.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/context/decorators/standard/context-selector.ts"],
+  "sourcesContent": [
+    "import type { Method } from '../../../types';\nimport type { RadiantElement } from '../../../core/radiant-element';\nimport { bootstrapSsrContextSelection, connectContextSelection } from '../../context-consumer-bootstrap';\nimport type { Context, ContextType } from '../../types';\nimport type { OnContextUpdateOptions } from '../on-context-update';\nimport { createContextSelectionDelivery } from '../context-selection-delivery';\n\nexport function contextSelector<T extends Context<unknown, unknown>, Selected = ContextType<T>>({\n\tcontext,\n\tselect,\n\tsubscribe = true,\n\trequestUpdate = true,\n}: OnContextUpdateOptions<T, Selected>) {\n\treturn function <Host extends RadiantElement, TMethod extends Method>(\n\t\toriginalMethod: TMethod,\n\t\ttargetContext: ClassMethodDecoratorContext<Host, TMethod>,\n\t): void {\n\t\ttargetContext.addInitializer(function (this: Host) {\n\t\t\tconst applySelectedContext = createContextSelectionDelivery(\n\t\t\t\tthis,\n\t\t\t\t(value) => {\n\t\t\t\t\toriginalMethod.call(this, value as never);\n\t\t\t\t},\n\t\t\t\trequestUpdate,\n\t\t\t);\n\n\t\t\tif (bootstrapSsrContextSelection(this, context, applySelectedContext, select)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst connectSelection = () => {\n\t\t\t\tconnectContextSelection(this, context, applySelectedContext, {\n\t\t\t\t\tselect,\n\t\t\t\t\tsubscribe,\n\t\t\t\t});\n\t\t\t};\n\n\t\t\tthis.registerConnectedCallback(() => {\n\t\t\t\tconnectSelection();\n\t\t\t});\n\n\t\t\tqueueMicrotask(connectSelection);\n\t\t});\n\t};\n}\n"
+  ],
+  "mappings": "6FAOO,GAAS,CAA+E,EAC9F,UACA,SACA,YAAY,GACZ,gBAAgB,IACuB,CACvC,OAAO,QAA8D,CACpE,EACA,EACO,CACP,EAAc,eAAe,QAAS,EAAa,CAClD,IAAM,EAAuB,EAC5B,KACA,CAAC,IAAU,CACV,EAAe,KAAK,KAAM,CAAc,GAEzC,CACD,EAEA,GAAI,EAA6B,KAAM,EAAS,EAAsB,CAAM,EAC3E,OAGD,IAAM,EAAmB,IAAM,CAC9B,EAAwB,KAAM,EAAS,EAAsB,CAC5D,SACA,WACD,CAAC,GAGF,KAAK,0BAA0B,IAAM,CACpC,EAAiB,EACjB,EAED,eAAe,CAAgB,EAC/B",
+  "debugId": "998D5926E232DF2A64756E2164756E21",
+  "names": []
+}

package/dist/chunk-x457d0ap.js

@@ -0,0 +1,4 @@
+import{Ea as C,Fa as x,Ga as D}from"./chunk-nnnb6pac.js";import{Ma as B}from"./chunk-cnyxrh9r.js";function M(j={}){return(E,k)=>{let F=(f)=>{let q=f[k];if(q instanceof x)return q;let A=typeof j.source==="function"?j.source(f):j.source??(C(q)?q:void 0),G=j.bind??f.shouldAutoBindReactiveMembers?.()??!1,H=A!==void 0?j.initial:q===void 0?j.initial:q;f.defineReactiveBinding(k,G);let w=D({host:f,hydrate:j.hydrate,hydrationKey:k,initialValue:H,property:k,source:A});if(f.registerConnectedCallback(()=>{w.hydrateFromHost(),w.connectToSource()}),f.registerCleanupCallback(()=>{w.disconnectFromSource()}),j.hydrate)f.registerHydrationBinding(k,w);return f[k]=w,w};B(E,(f)=>{let q=F(f);f.registerConnectedCallback(()=>{if(!(f[k]instanceof x))f[k]=q})})}}
+export{M as ba};
+
+//# debugId=3C6B2D52315006A564756E2164756E21

package/dist/chunk-x457d0ap.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/decorators/legacy/signal.ts"],
+  "sourcesContent": [
+    "import type { RadiantElement, ReactiveBindingOption } from '../../core/radiant-element';\nimport { createHostSignal, HostSignal, isWritableSignalLike } from '../../signals/host-signal';\nimport { registerLegacyInstanceInitializer } from './instance-initializers';\nimport type { AttributeTypeConstant } from '../../utils/attribute-utils';\nimport type { WritableSignal } from '@ecopages/signals';\n\nexport type SignalDecoratorOptions<Value = unknown> = {\n\tbind?: ReactiveBindingOption;\n\tinitial?: Value;\n\tsource?: WritableSignal<Value> | ((host: RadiantElement) => WritableSignal<Value>);\n\thydrate?: AttributeTypeConstant;\n};\n\nexport function signal<Value = unknown>(options: SignalDecoratorOptions<Value> = {}) {\n\treturn (target: RadiantElement, propertyName: string) => {\n\t\tconst initializeSignal = (element: RadiantElement): HostSignal<unknown> => {\n\t\t\tconst currentValue = element[propertyName as keyof typeof element] as unknown;\n\n\t\t\tif (currentValue instanceof HostSignal) {\n\t\t\t\treturn currentValue;\n\t\t\t}\n\n\t\t\tconst resolvedSource =\n\t\t\t\ttypeof options.source === 'function'\n\t\t\t\t\t? options.source(element)\n\t\t\t\t\t: (options.source ?? (isWritableSignalLike(currentValue) ? currentValue : undefined));\n\n\t\t\tconst bind =\n\t\t\t\toptions.bind ??\n\t\t\t\t(\n\t\t\t\t\telement as unknown as { shouldAutoBindReactiveMembers?: () => boolean }\n\t\t\t\t).shouldAutoBindReactiveMembers?.() ??\n\t\t\t\tfalse;\n\n\t\t\tconst resolvedInitialValue =\n\t\t\t\tresolvedSource !== undefined\n\t\t\t\t\t? options.initial\n\t\t\t\t\t: ((currentValue === undefined ? options.initial : currentValue) as Value);\n\t\t\telement.defineReactiveBinding(propertyName, bind);\n\n\t\t\tconst hostSignal = createHostSignal({\n\t\t\t\thost: element,\n\t\t\t\thydrate: options.hydrate,\n\t\t\t\thydrationKey: propertyName,\n\t\t\t\tinitialValue: resolvedInitialValue,\n\t\t\t\tproperty: propertyName,\n\t\t\t\tsource: resolvedSource,\n\t\t\t});\n\n\t\t\telement.registerConnectedCallback(() => {\n\t\t\t\thostSignal.hydrateFromHost();\n\t\t\t\thostSignal.connectToSource();\n\t\t\t});\n\t\t\telement.registerCleanupCallback(() => {\n\t\t\t\thostSignal.disconnectFromSource();\n\t\t\t});\n\n\t\t\tif (options.hydrate) {\n\t\t\t\telement.registerHydrationBinding(propertyName, hostSignal);\n\t\t\t}\n\n\t\t\t(element as unknown as Record<string, unknown>)[propertyName] = hostSignal;\n\t\t\treturn hostSignal as unknown as HostSignal<unknown>;\n\t\t};\n\n\t\tregisterLegacyInstanceInitializer(target, (element) => {\n\t\t\tconst hostSignal = initializeSignal(element);\n\t\t\telement.registerConnectedCallback(() => {\n\t\t\t\tif (!((element as any)[propertyName] instanceof HostSignal)) {\n\t\t\t\t\t(element as unknown as Record<string, unknown>)[propertyName] = hostSignal;\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t};\n}\n"
+  ],
+  "mappings": "wGAaO,GAAS,CAAuB,CAAC,EAAyC,CAAC,EAAG,CACpF,MAAO,CAAC,EAAwB,IAAyB,CACxD,IAAM,EAAmB,CAAC,IAAiD,CAC1E,IAAM,EAAe,EAAQ,GAE7B,GAAI,aAAwB,EAC3B,OAAO,EAGR,IAAM,EACL,OAAO,EAAQ,SAAW,WACvB,EAAQ,OAAO,CAAO,EACrB,EAAQ,SAAW,EAAqB,CAAY,EAAI,EAAe,QAEtE,EACL,EAAQ,MAEP,EACC,gCAAgC,GAClC,GAEK,EACL,IAAmB,OAChB,EAAQ,QACN,IAAiB,OAAY,EAAQ,QAAU,EACrD,EAAQ,sBAAsB,EAAc,CAAI,EAEhD,IAAM,EAAa,EAAiB,CACnC,KAAM,EACN,QAAS,EAAQ,QACjB,aAAc,EACd,aAAc,EACd,SAAU,EACV,OAAQ,CACT,CAAC,EAUD,GARA,EAAQ,0BAA0B,IAAM,CACvC,EAAW,gBAAgB,EAC3B,EAAW,gBAAgB,EAC3B,EACD,EAAQ,wBAAwB,IAAM,CACrC,EAAW,qBAAqB,EAChC,EAEG,EAAQ,QACX,EAAQ,yBAAyB,EAAc,CAAU,EAI1D,OADC,EAA+C,GAAgB,EACzD,GAGR,EAAkC,EAAQ,CAAC,IAAY,CACtD,IAAM,EAAa,EAAiB,CAAO,EAC3C,EAAQ,0BAA0B,IAAM,CACvC,GAAI,EAAG,EAAgB,aAAyB,GAC9C,EAA+C,GAAgB,EAEjE,EACD",
+  "debugId": "3C6B2D52315006A564756E2164756E21",
+  "names": []
+}

package/dist/chunk-xbhtzkre.js

@@ -0,0 +1,4 @@
+import{Ca as z}from"./chunk-atms6yrh.js";import{Da as A}from"./chunk-n4p2542b.js";import{Oa as q}from"./chunk-q9z6tnzw.js";function Q(j){return function(F,G){return q(A(j),z(j),F,G)}}
+export{Q as Ba};
+
+//# debugId=76F879E1A58DFE1064756E2164756E21

package/dist/chunk-xbhtzkre.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/decorators/prop.ts"],
+  "sourcesContent": [
+    "import type { ReactivePropertyOptions } from '../core/radiant-element';\nimport type { StandardOrLegacyFieldDecoratorArgs } from '../types';\nimport { reactiveProp as legacyReactiveProp } from './legacy/reactive-prop';\nimport { reactiveProp as standardReactiveProp } from './standard/reactive-prop';\nimport { fieldDecoratorBridge } from './bridge';\n\n/**\n * Declares a reactive property backed by an HTML attribute.\n *\n * Every write triggers `notifyUpdate` so update callbacks, bindings, and\n * `RadiantComponent` renders stay in sync. When no explicit `bind` option\n * is supplied, `RadiantComponent` hosts expose a JSX companion binding\n * accessor automatically while plain `RadiantElement` hosts keep binding\n * opt-in.\n *\n * @param options {@link ReactivePropertyOptions} The options for the reactive property.\n */\nexport function prop<T = unknown>(options: ReactivePropertyOptions<T>) {\n\treturn function (\n\t\tprotoOrTarget: StandardOrLegacyFieldDecoratorArgs['protoOrTarget'],\n\t\tnameOrContext: StandardOrLegacyFieldDecoratorArgs['nameOrContext'],\n\t): any {\n\t\treturn fieldDecoratorBridge(\n\t\t\tstandardReactiveProp(options),\n\t\t\tlegacyReactiveProp(options),\n\t\t\tprotoOrTarget,\n\t\t\tnameOrContext,\n\t\t);\n\t};\n}\n"
+  ],
+  "mappings": "uIAiBO,GAAS,LAAiB,CAAC,EAAqC,CACtE,OAAO,QAAS,CACf,EACA,EACM,CACN,OAAO,EACN,EAAqB,CAAO,EAC5B,EAAmB,CAAO,EAC1B,EACA,CACD",
+  "debugId": "76F879E1A58DFE1064756E2164756E21",
+  "names": []
+}

package/dist/chunk-y139ycfm.js

@@ -0,0 +1,4 @@
+function x(v,f,w){let j=w.value;return{configurable:!0,get(){if(this===v.prototype||Object.hasOwn(this,f))return j;let q=j.bind(this);return Object.defineProperty(this,f,{value:q,configurable:!0,writable:!0}),q}}}
+export{x as ha};
+
+//# debugId=C086DD1604E1F86964756E2164756E21

package/dist/chunk-y139ycfm.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/decorators/legacy/bound.ts"],
+  "sourcesContent": [
+    "import type { RadiantElement } from '../../core/radiant-element';\n\n/**\n * A decorator to bind a method to the instance.\n * @param target {@link RadiantElement}\n * @param propertyKey string\n * @param descriptor {@link PropertyDescriptor}\n * @returns\n */\nexport function bound(target: RadiantElement, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor {\n\tconst originalMethod = descriptor.value;\n\n\treturn {\n\t\tconfigurable: true,\n\t\tget() {\n\t\t\tif (this === (target as any).prototype || Object.hasOwn(this, propertyKey)) {\n\t\t\t\treturn originalMethod;\n\t\t\t}\n\n\t\t\tconst boundMethod = originalMethod.bind(this);\n\t\t\tObject.defineProperty(this, propertyKey, {\n\t\t\t\tvalue: boundMethod,\n\t\t\t\tconfigurable: true,\n\t\t\t\twritable: true,\n\t\t\t});\n\t\t\treturn boundMethod;\n\t\t},\n\t};\n}\n"
+  ],
+  "mappings": "AASO,SAAS,CAAK,CAAC,EAAwB,EAAqB,EAAoD,CACtH,IAAM,EAAiB,EAAW,MAElC,MAAO,CACN,aAAc,GACd,GAAG,EAAG,CACL,GAAI,OAAU,EAAe,WAAa,OAAO,OAAO,KAAM,CAAW,EACxE,OAAO,EAGR,IAAM,EAAc,EAAe,KAAK,IAAI,EAM5C,OALA,OAAO,eAAe,KAAM,EAAa,CACxC,MAAO,EACP,aAAc,GACd,SAAU,EACX,CAAC,EACM,EAET",
+  "debugId": "C086DD1604E1F86964756E2164756E21",
+  "names": []
+}

package/dist/chunk-z9kxfckm.js

@@ -0,0 +1,4 @@
+function x(j,q){return j.bind(q)}
+export{x as Q};
+
+//# debugId=B7BD9676E1EDE2E164756E2164756E21

package/dist/chunk-z9kxfckm.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/reactive-jsx-value.ts"],
+  "sourcesContent": [
+    "import type { SubscribableJsxValue } from '@ecopages/jsx';\nimport type { RadiantElement, ReactiveBindingValue } from './radiant-element';\n\n/**\n * Creates a stable JSX child binding backed by a Radiant reactive property or field.\n *\n * The returned value resolves eagerly on the server and subscribes to the host's\n * update callbacks on the client so the mounted child range can patch directly\n * when the selected property changes.\n */\nexport function bindReactiveValue<\n\tBindings extends object,\n\tHost extends RadiantElement<Bindings>,\n\tProperty extends Extract<keyof Bindings, string>,\n>(host: Host, property: Property): SubscribableJsxValue<ReactiveBindingValue<Bindings, Property>> {\n\treturn host.bind(property);\n}\n"
+  ],
+  "mappings": "AAUO,SAAS,CAIf,CAAC,EAAY,EAAoF,CACjG,OAAO,EAAK,KAAK,CAAQ",
+  "debugId": "B7BD9676E1EDE2E164756E2164756E21",
+  "names": []
+}

package/dist/chunk-zx5txex8.js

@@ -0,0 +1,4 @@
+import{Qa as f,Ra as j,Sa as k}from"./chunk-gg74gdpv.js";function q(){f()}function v(){j()}function z(){return k()}
+export{q as c,v as d,z as e};
+
+//# debugId=23B55101F5D3FF0B64756E2164756E21

package/dist/chunk-zx5txex8.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/client/hydrator.ts"],
+  "sourcesContent": [
+    "import {\n\tisRadiantHydratorInstalled,\n\tinstallRadiantHydratorState,\n\tuninstallRadiantHydratorState,\n} from '../core/radiant-hydrator-state';\n\n/**\n * Enables first-connect hydration for SSR-rendered RadiantComponent hosts.\n *\n * Import this from SSR pages before loading component modules so upgraded\n * custom elements hydrate their existing DOM instead of performing a fresh\n * client render on first connect.\n */\nexport function installRadiantHydrator(): void {\n\tinstallRadiantHydratorState();\n}\n\n/**\n * Disables the explicit Radiant hydrator gate.\n *\n * This is primarily useful for tests and controlled bootstrap scenarios where\n * SSR hosts should intentionally fall back to a fresh client render.\n */\nexport function uninstallRadiantHydrator(): void {\n\tuninstallRadiantHydratorState();\n}\n\n/**\n * Returns whether the explicit Radiant hydrator gate is currently enabled.\n */\nexport function hasRadiantHydrator(): boolean {\n\treturn isRadiantHydratorInstalled();\n}\n"
+  ],
+  "mappings": "yDAaO,SAAS,CAAsB,EAAS,CAC9C,EAA4B,EAStB,SAAS,CAAwB,EAAS,CAChD,EAA8B,EAMxB,SAAS,CAAkB,EAAY,CAC7C,OAAO,EAA2B",
+  "debugId": "23B55101F5D3FF0B64756E2164756E21",
+  "names": []
+}

package/dist/client/hydrator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Enables first-connect hydration for SSR-rendered RadiantComponent hosts.
+ *
+ * Import this from SSR pages before loading component modules so upgraded
+ * custom elements hydrate their existing DOM instead of performing a fresh
+ * client render on first connect.
+ */
+export declare function installRadiantHydrator(): void;
+/**
+ * Disables the explicit Radiant hydrator gate.
+ *
+ * This is primarily useful for tests and controlled bootstrap scenarios where
+ * SSR hosts should intentionally fall back to a fresh client render.
+ */
+export declare function uninstallRadiantHydrator(): void;
+/**
+ * Returns whether the explicit Radiant hydrator gate is currently enabled.
+ */
+export declare function hasRadiantHydrator(): boolean;

package/dist/client/hydrator.js

@@ -0,0 +1,3 @@
+import{c as a,d as b,e as c}from"../chunk-zx5txex8.js";import"../chunk-gg74gdpv.js";import"../chunk-vgtggzb6.js";export{b as uninstallRadiantHydrator,a as installRadiantHydrator,c as hasRadiantHydrator};
+
+//# debugId=268881E5493944E364756E2164756E21

package/dist/client/hydrator.js.map

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

package/dist/client/install-hydrator.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/client/install-hydrator.js

@@ -0,0 +1,3 @@
+import{c as a}from"../chunk-zx5txex8.js";import"../chunk-gg74gdpv.js";import"../chunk-vgtggzb6.js";a();
+
+//# debugId=A85090E87EADEFED64756E2164756E21

package/dist/client/install-hydrator.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/client/install-hydrator.ts"],
+  "sourcesContent": [
+    "import { installRadiantHydrator } from './hydrator';\n\ninstallRadiantHydrator();\n"
+  ],
+  "mappings": "6GAEA,HAAuB",
+  "debugId": "A85090E87EADEFED64756E2164756E21",
+  "names": []
+}

package/dist/context/context-consumer-bootstrap.d.ts

@@ -0,0 +1,41 @@
+import type { RadiantElement } from '../core/radiant-element';
+import type { ContextType, UnknownContext } from './types';
+type ConsumedContextAssignment = (provider: unknown) => void;
+/**
+ * Resolves a consumed context immediately and registers the same resolution to
+ * run again during the later SSR preparation phase.
+ *
+ * This keeps constructor-time state and pre-serialization state aligned after
+ * instance fields, props, or authored host content change during SSR setup.
+ */
+export declare function bootstrapSsrConsumedContext(host: RadiantElement, context: UnknownContext, assign: ConsumedContextAssignment, options?: {
+    emitMounted?: boolean;
+}): boolean;
+/**
+ * Resolves a selected context value immediately and registers the same
+ * selection for the later SSR preparation phase.
+ *
+ * This lets nested SSR renders recompute selector-backed state after the host
+ * has finished construction and any server-side configuration hooks have run.
+ */
+export declare function bootstrapSsrContextSelection<TContext extends UnknownContext>(host: object, context: TContext, callback: (value: unknown) => void, select?: (context: ContextType<TContext>) => unknown): boolean;
+/**
+ * Resolves a consumed context from SSR when available, otherwise requests it
+ * through the DOM event channel for the current client-side lifecycle pass.
+ *
+ * @returns `true` when the value was satisfied synchronously from SSR state.
+ */
+export declare function connectConsumedContext(host: RadiantElement, context: UnknownContext, assign: ConsumedContextAssignment, options?: {
+    emitMounted?: boolean;
+}): boolean;
+/**
+ * Resolves a selected context value from SSR when available, otherwise requests
+ * it through the DOM event channel for the current client-side lifecycle pass.
+ *
+ * @returns `true` when the value was satisfied synchronously from SSR state.
+ */
+export declare function connectContextSelection<TContext extends UnknownContext>(host: RadiantElement, context: TContext, callback: (value: unknown) => void, options?: {
+    select?: (context: ContextType<TContext>) => unknown;
+    subscribe?: boolean;
+}): boolean;
+export {};

package/dist/context/context-consumer-bootstrap.js

@@ -0,0 +1,3 @@
+import{H as a,I as b,J as c,K as d}from"../chunk-p8k4g99a.js";import"../chunk-ek664x1c.js";import"../chunk-kmebacvv.js";import"../chunk-eyw14d6y.js";import"../chunk-t8xtvgyg.js";import"../chunk-vgtggzb6.js";export{d as connectContextSelection,c as connectConsumedContext,b as bootstrapSsrContextSelection,a as bootstrapSsrConsumedContext};
+
+//# debugId=1FBE9D880DF6040F64756E2164756E21

package/dist/context/context-consumer-bootstrap.js.map

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

package/dist/context/context-consumer-runtime.d.ts

@@ -0,0 +1,34 @@
+import type { RadiantElement } from '../core/radiant-element';
+import type { ContextType, UnknownContext } from './types';
+type ConsumedContextAssignment = (provider: unknown) => void;
+/**
+ * Resolves a consumed context from the active SSR provider stack when one is available.
+ *
+ * This keeps SSR-specific lookup outside decorator implementations while preserving
+ * the same consumer initialization contract for both standard and legacy decorators.
+ *
+ * @returns `true` when the context was resolved synchronously from SSR state.
+ */
+export declare function initializeConsumedContext(host: RadiantElement, context: UnknownContext, assign: ConsumedContextAssignment, options?: {
+    emitMounted?: boolean;
+}): boolean;
+/**
+ * Requests a context provider through the DOM event channel when SSR state is not active.
+ */
+export declare function requestConsumedContext(host: RadiantElement, context: UnknownContext, assign: ConsumedContextAssignment, options?: {
+    emitMounted?: boolean;
+}): void;
+/**
+ * Resolves a selected context value from the active SSR provider stack when available.
+ *
+ * @returns `true` when the selection callback was satisfied synchronously from SSR state.
+ */
+export declare function initializeContextSelection<TContext extends UnknownContext>(context: TContext, callback: (value: unknown) => void, select?: (context: ContextType<TContext>) => unknown): boolean;
+/**
+ * Requests a selected context value through the DOM event channel.
+ */
+export declare function requestContextSelection<TContext extends UnknownContext>(host: RadiantElement, context: TContext, callback: (value: unknown) => void, options: {
+    select?: (context: ContextType<TContext>) => unknown;
+    subscribe?: boolean;
+}): void;
+export {};

package/dist/context/context-consumer-runtime.js

@@ -0,0 +1,3 @@
+import{L as a,M as b,N as c,O as d}from"../chunk-ek664x1c.js";import"../chunk-kmebacvv.js";import"../chunk-t8xtvgyg.js";import"../chunk-vgtggzb6.js";export{d as requestContextSelection,b as requestConsumedContext,c as initializeContextSelection,a as initializeConsumedContext};
+
+//# debugId=C4052F528A37966464756E2164756E21

package/dist/context/context-consumer-runtime.js.map

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

package/dist/context/context-provider.d.ts

@@ -1,12 +1,22 @@
+import { type JsxRenderable } from '@ecopages/jsx';
 import type { RadiantElement } from '../core/radiant-element';
-import { type AttributeTypeConstant } from '../utils/attribute-utils';
+import type { SsrSerializableHydrationBinding } from '../core/ssr-hydration-binding';
+import type { AttributeTypeConstant } from '../utils/attribute-utils';
 import { type ContextSubscription } from './events';
 import type { Context, ContextType, UnknownContext } from './types';
 type ContextProviderOptions<T extends UnknownContext> = {
     context: UnknownContext;
+    hydrationKey?: string;
     initialValue?: T['__context__'];
     hydrate?: AttributeTypeConstant;
+    serialize?: (value: ContextType<T>) => unknown;
 };
+export interface SsrSerializableContextProvider extends SsrSerializableHydrationBinding {
+    /** Returns the current context payload that should be visible to descendants. */
+    getContext(): unknown;
+    /** Returns the context token used to match nested SSR consumers and providers. */
+    getContextKey(): UnknownContext;
+}
 /**
  * Represents a context provider that allows setting and getting the context,
  * as well as subscribing to context updates.
@@ -52,9 +62,13 @@ export interface IContextProvider<T extends Context<unknown, unknown>> {
  * });
  * ```
  */
-export declare class ContextProvider<T extends Context<unknown, unknown>> implements IContextProvider<T> {
+export declare class ContextProvider<T extends Context<unknown, unknown>> implements IContextProvider<T>, SsrSerializableContextProvider {
     private host;
     private context;
+    private hydrationKey?;
+    private hydrate?;
+    private serialize?;
+    private pendingHostHydration;
     private value;
     subscriptions: ContextSubscription<T>[];
     /**
@@ -66,8 +80,42 @@ export declare class ContextProvider<T extends Context<unknown, unknown>> implem
     constructor(host: RadiantElement, options: ContextProviderOptions<T>);
     setContext: (update: Partial<ContextType<T>>, callback?: (context: ContextType<T>) => void) => void;
     getContext: () => ContextType<T>;
+    /**
+     * Returns the provider's logical context token.
+     *
+     * SSR helpers use this token to resolve the closest matching provider while a
+     * host subtree is being serialized.
+     */
+    getContextKey: () => {
+        __context__: unknown;
+    };
+    /**
+     * Serializes the current provider value for inclusion in a hydration script.
+     *
+     * The serialized payload is JSON-escaped so it can be embedded safely inside a
+     * `<script type="application/json">` tag.
+     */
+    serializeHydrationValue: () => string | undefined;
+    /**
+     * Builds the raw HTML hydration script for this provider.
+     *
+     * When `hydrationKey` is present, the marker is scoped so sibling or nested
+     * providers can recover their own payloads without accidentally reading a
+     * descendant script.
+     */
+    renderHydrationScriptTag: () => string | undefined;
+    /**
+     * Wraps the provider hydration script in a minimal JSX node-like value.
+     *
+     * This lets JSX-based host renderers append the script without needing a real
+     * DOM element instance during SSR.
+     */
+    renderHydrationScript: () => JsxRenderable | undefined;
     subscribe: ({ select, callback }: ContextSubscription<T>) => void;
+    private tryHydrateFromHost;
+    private mergeHydrationValue;
     private isObject;
+    private findHydrationScriptElement;
     private notifySubscribers;
     private sendSubscriptionUpdate;
     private handleSubscriptionRequest;

package/dist/context/context-provider.js

@@ -1,4 +1,3 @@
-import{q as G}from"./events.js";import{J as I}from"../utils/attribute-utils.js";class J{host;context;value;subscriptions=[];constructor(j,q){this.host=j,this.context=q.context;let z=q.initialValue;if(q.hydrate){const B=this.host.querySelector("script[data-hydration]");if(B?.textContent){const D=B.textContent,F=I(D,q.hydrate);if(q.hydrate===Object&&this.isObject(F)&&(this.isObject(z)||typeof z==="undefined"))z={...z??{},...F};else z=F}}this.value=z,this.registerEvents(),this.host.dispatchEvent(new G(this.context))}setContext=(j,q)=>{if(typeof this.value==="object"){const z={...this.value};if(this.value={...this.value,...j},q)q(this.value);this.notifySubscribers(this.value,z)}};getContext=()=>{return this.value};subscribe=({select:j,callback:q})=>{this.subscriptions.push({select:j,callback:q})};isObject(j){return typeof j==="object"&&!Array.isArray(j)&&j!==null}notifySubscribers=(j,q)=>{for(let z of this.subscriptions){if(!z.select)return this.sendSubscriptionUpdate(z,j);const B=z.select(j),D=z.select(q);if(B!==D)this.sendSubscriptionUpdate(z,j)}};sendSubscriptionUpdate=({select:j,callback:q},z)=>{if(!j)q(z);else q(j(z))};handleSubscriptionRequest=({select:j,callback:q,subscribe:z})=>{if(z)this.subscribe({select:j,callback:q});if(!this.value)return;if(j)q(j(this.value));else q(this.value)};onSubscriptionRequest=(j)=>{const{context:q,callback:z,subscribe:B,select:D,target:F}=j;if(q!==this.context)return;j.stopPropagation(),F.dispatchEvent(new G(this.context)),this.handleSubscriptionRequest({select:D,callback:z,subscribe:B})};onContextRequest=(j)=>{const{context:q,callback:z}=j;if(q!==this.context)return;j.stopPropagation(),z(this)};registerEvents=()=>{this.host.addEventListener("context-subscription-request",this.onSubscriptionRequest),this.host.addEventListener("context-request",this.onContextRequest)}}export{J as ContextProvider};
-export{J as n};
+import{R as a}from"../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 ContextProvider};
 
-//# debugId=1E45EE002AF157AF64756E2164756E21
+//# debugId=F4CC6018A262DC2E64756E2164756E21

package/dist/context/context-provider.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/context-provider.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '../core/radiant-element';\nimport { type AttributeTypeConstant, readAttributeValue } from '../utils/attribute-utils';\nimport {\n  ContextEventsTypes,\n  ContextOnMountEvent,\n  type ContextRequestEvent,\n  type ContextSubscription,\n  type ContextSubscriptionRequestEvent,\n} from './events';\nimport type { Context, ContextType, UnknownContext } from './types';\n\ntype ContextProviderOptions<T extends UnknownContext> = {\n  context: UnknownContext;\n  initialValue?: T['__context__'];\n  hydrate?: AttributeTypeConstant;\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  /**\n   * Sets the context with the provided update and invokes the optional callback function.\n   *\n   * @param update - The partial update to be applied to the context.\n   * @param callback - An optional callback function that receives the updated context.\n   */\n  setContext: (update: Partial<ContextType<T>>, callback?: (context: ContextType<T>) => void) => void;\n\n  /**\n   * Gets the current context.\n   *\n   * @returns The current context.\n   */\n  getContext: () => ContextType<T>;\n\n  /**\n   * Subscribes to context updates.\n   *\n   * @param subscription - The subscription object that defines the callback function to be invoked on context updates.\n   */\n  subscribe: (subscription: ContextSubscription<T>) => 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>> implements IContextProvider<T> {\n  private host: RadiantElement;\n  private context: UnknownContext;\n  private value: ContextType<T> | undefined;\n\n  subscriptions: ContextSubscription<T>[] = [];\n\n  /**\n   * Creates a new instance of the ContextProvider.\n   *\n   * @param host - The host element that will contain the context provider.\n   * @param options - The options to configure the context provider.\n   */\n  constructor(host: RadiantElement, options: ContextProviderOptions<T>) {\n    this.host = host;\n    this.context = options.context;\n    let contextValue: T['__context__'] | undefined = options.initialValue;\n\n    if (options.hydrate) {\n      const hydrationScriptElement = this.host.querySelector('script[data-hydration]');\n      if (hydrationScriptElement?.textContent) {\n        const hydrationValue = hydrationScriptElement.textContent;\n        const parsedHydrationValue = readAttributeValue(hydrationValue, options.hydrate) as ContextType<T>;\n\n        if (\n          options.hydrate === Object &&\n          this.isObject(parsedHydrationValue) &&\n          (this.isObject(contextValue) || typeof contextValue === 'undefined')\n        ) {\n          contextValue = {\n            ...(contextValue ?? {}),\n            ...parsedHydrationValue,\n          };\n        } else {\n          contextValue = parsedHydrationValue;\n        }\n      }\n    }\n\n    this.value = contextValue as ContextType<T>;\n\n    this.registerEvents();\n    this.host.dispatchEvent(new ContextOnMountEvent(this.context));\n  }\n\n  setContext = (update: Partial<ContextType<T>>, callback?: (context: ContextType<T>) => void) => {\n    if (typeof this.value === 'object') {\n      const oldContext = { ...this.value };\n      this.value = { ...this.value, ...update };\n      if (callback) callback(this.value);\n      this.notifySubscribers(this.value, oldContext);\n    }\n  };\n\n  getContext = () => {\n    return this.value as ContextType<T>;\n  };\n\n  subscribe = ({ select, callback }: ContextSubscription<T>) => {\n    this.subscriptions.push({ select, callback });\n  };\n\n  private isObject(value: unknown): value is Record<string, unknown> {\n    return typeof value === 'object' && !Array.isArray(value) && value !== null;\n  }\n\n  private notifySubscribers = (newContext: ContextType<T>, prevContext: ContextType<T>) => {\n    for (const sub of this.subscriptions) {\n      if (!sub.select) return this.sendSubscriptionUpdate(sub, newContext);\n      const newSelected = sub.select(newContext);\n      const prevSelected = sub.select(prevContext);\n      if (newSelected !== prevSelected) {\n        this.sendSubscriptionUpdate(sub, newContext);\n      }\n    }\n  };\n\n  private sendSubscriptionUpdate = ({ select, callback }: ContextSubscription<T>, context: ContextType<T>) => {\n    if (!select) callback(context);\n    else callback(select(context));\n  };\n\n  private handleSubscriptionRequest = ({\n    select,\n    callback,\n    subscribe,\n  }: {\n    select?: ContextSubscription<T>['select'];\n    callback: ContextSubscription<T>['callback'];\n    subscribe?: boolean;\n  }) => {\n    if (subscribe) this.subscribe({ select, callback });\n\n    if (!this.value) return;\n\n    if (select) {\n      callback(select(this.value));\n    } else {\n      callback(this.value as ContextType<T>);\n    }\n  };\n\n  private onSubscriptionRequest = (event: ContextSubscriptionRequestEvent<UnknownContext>) => {\n    const { context, callback, subscribe, select, target } = event;\n    if (context !== this.context) return;\n\n    event.stopPropagation();\n\n    (target as HTMLElement).dispatchEvent(new ContextOnMountEvent(this.context));\n\n    this.handleSubscriptionRequest({ select, callback, subscribe });\n  };\n\n  private onContextRequest = (event: ContextRequestEvent<UnknownContext>) => {\n    const { context, callback } = event;\n    if (context !== this.context) return;\n    event.stopPropagation();\n    callback(this);\n  };\n\n  private registerEvents = () => {\n    this.host.addEventListener(ContextEventsTypes.SUBSCRIPTION_REQUEST, this.onSubscriptionRequest);\n    this.host.addEventListener(ContextEventsTypes.CONTEXT_REQUEST, this.onContextRequest);\n  };\n}\n"
   ],
-  "mappings": "8EAiEO,QAAM,CAAoF,CACvF,KACA,QACA,MAER,cAA0C,CAAC,EAQ3C,WAAW,CAAC,EAAsB,EAAoC,CACpE,KAAK,KAAO,EACZ,KAAK,QAAU,EAAQ,QACvB,IAAI,EAA6C,EAAQ,aAEzD,GAAI,EAAQ,QAAS,CACnB,MAAM,EAAyB,KAAK,KAAK,cAAc,wBAAwB,EAC/E,GAAI,GAAwB,YAAa,CACvC,MAAM,EAAiB,EAAuB,YACxC,EAAuB,EAAmB,EAAgB,EAAQ,OAAO,EAE/E,GACE,EAAQ,UAAY,QACpB,KAAK,SAAS,CAAoB,IACjC,KAAK,SAAS,CAAY,UAAY,IAAiB,aAExD,EAAe,IACT,GAAgB,CAAC,KAClB,CACL,MAEA,GAAe,GAKrB,KAAK,MAAQ,EAEb,KAAK,eAAe,EACpB,KAAK,KAAK,cAAc,IAAI,EAAoB,KAAK,OAAO,CAAC,EAG/D,WAAa,CAAC,EAAiC,IAAiD,CAC9F,UAAW,KAAK,QAAU,SAAU,CAClC,MAAM,EAAa,IAAK,KAAK,KAAM,EAEnC,GADA,KAAK,MAAQ,IAAK,KAAK,SAAU,CAAO,EACpC,EAAU,EAAS,KAAK,KAAK,EACjC,KAAK,kBAAkB,KAAK,MAAO,CAAU,IAIjD,WAAa,IAAM,CACjB,OAAO,KAAK,OAGd,UAAY,EAAG,SAAQ,cAAuC,CAC5D,KAAK,cAAc,KAAK,CAAE,SAAQ,UAAS,CAAC,GAGtC,QAAQ,CAAC,EAAkD,CACjE,cAAc,IAAU,WAAa,MAAM,QAAQ,CAAK,GAAK,IAAU,KAGjE,kBAAoB,CAAC,EAA4B,IAAgC,CACvF,QAAW,KAAO,KAAK,cAAe,CACpC,IAAK,EAAI,OAAQ,OAAO,KAAK,uBAAuB,EAAK,CAAU,EACnE,MAAM,EAAc,EAAI,OAAO,CAAU,EACnC,EAAe,EAAI,OAAO,CAAW,EAC3C,GAAI,IAAgB,EAClB,KAAK,uBAAuB,EAAK,CAAU,IAKzC,uBAAyB,EAAG,SAAQ,YAAoC,IAA4B,CAC1G,IAAK,EAAQ,EAAS,CAAO,MACxB,GAAS,EAAO,CAAO,CAAC,GAGvB,0BAA4B,EAClC,SACA,WACA,eAKI,CACJ,GAAI,EAAW,KAAK,UAAU,CAAE,SAAQ,UAAS,CAAC,EAElD,IAAK,KAAK,MAAO,OAEjB,GAAI,EACF,EAAS,EAAO,KAAK,KAAK,CAAC,MAE3B,GAAS,KAAK,KAAuB,GAIjC,sBAAwB,CAAC,IAA2D,CAC1F,MAAQ,UAAS,WAAU,YAAW,SAAQ,UAAW,EACzD,GAAI,IAAY,KAAK,QAAS,OAE9B,EAAM,gBAAgB,EAErB,EAAuB,cAAc,IAAI,EAAoB,KAAK,OAAO,CAAC,EAE3E,KAAK,0BAA0B,CAAE,SAAQ,WAAU,WAAU,CAAC,GAGxD,iBAAmB,CAAC,IAA+C,CACzE,MAAQ,UAAS,YAAa,EAC9B,GAAI,IAAY,KAAK,QAAS,OAC9B,EAAM,gBAAgB,EACtB,EAAS,IAAI,GAGP,eAAiB,IAAM,CAC7B,KAAK,KAAK,gDAA0D,KAAK,qBAAqB,EAC9F,KAAK,KAAK,mCAAqD,KAAK,gBAAgB,EAExF",
-  "debugId": "1E45EE002AF157AF64756E2164756E21",
+  "mappings": "",
+  "debugId": "F4CC6018A262DC2E64756E2164756E21",
   "names": []
 }

package/dist/context/context-ssr-bridge.d.ts

@@ -0,0 +1,16 @@
+import type { SsrSerializableContextProvider } from './context-provider';
+import type { UnknownContext } from './types';
+type SsrContextProviderResolver = (context: UnknownContext) => SsrSerializableContextProvider | undefined;
+/**
+ * Installs the ambient SSR provider resolver used by shared context runtime helpers.
+ *
+ * Server-side rendering infrastructure owns the actual provider stack storage and
+ * publishes a lookup function here so client/runtime code does not need to import
+ * server-oriented modules.
+ */
+export declare function installSsrContextProviderResolver(resolver: SsrContextProviderResolver): void;
+/**
+ * Resolves an ambient SSR provider when a server render has published one.
+ */
+export declare function resolveAmbientSsrContextProvider(context: UnknownContext): SsrSerializableContextProvider | undefined;
+export {};

package/dist/context/context-ssr-bridge.js

@@ -0,0 +1,3 @@
+import{$a as b,_a as a}from"../chunk-t8xtvgyg.js";import"../chunk-vgtggzb6.js";export{b as resolveAmbientSsrContextProvider,a as installSsrContextProviderResolver};
+
+//# debugId=98ACA3630CA1796564756E2164756E21

package/dist/context/context-ssr-bridge.js.map

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

package/dist/context/create-context.js

@@ -1,4 +1,3 @@
-var g=(d)=>d;export{g as createContext};
-export{g as e};
+import{z as a}from"../chunk-30x4hggg.js";import"../chunk-vgtggzb6.js";export{a as createContext};
 
-//# debugId=B8BB9E641176DF6864756E2164756E21
+//# debugId=8A2E70A2EE9132AF64756E2164756E21

package/dist/context/create-context.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/create-context.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { Context } from './types';\n\n/**\n * A function which creates a Context value object\n */\nexport const createContext = <ValueType>(key: unknown) => key as Context<typeof key, ValueType>;\n"
   ],
-  "mappings": "AAKO,IAAM,EAAgB,CAAY,IAAiB",
-  "debugId": "B8BB9E641176DF6864756E2164756E21",
+  "mappings": "",
+  "debugId": "8A2E70A2EE9132AF64756E2164756E21",
   "names": []
 }

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

@@ -1,8 +1,12 @@
 import type { StandardOrLegacyFieldDecoratorArgs } from '../../types';
 import type { UnknownContext } from '../types';
 /**
- * A decorator to provide a context to the target element.
- * @param contextToProvide
- * @returns
+ * Injects the nearest matching context provider onto a decorated field.
+ *
+ * During SSR the field can be resolved from the active SSR context stack; on
+ * the client it falls back to the DOM event-based context channel.
+ *
+ * @param context Context token to consume from ancestor providers.
+ * @returns A standard-or-legacy decorator implementation for the target field.
  */
-export declare function consumeContext(contextToProvide: UnknownContext): (protoOrTarget: StandardOrLegacyFieldDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyFieldDecoratorArgs["nameOrContext"]) => any;
+export declare function consumeContext(context: UnknownContext): (protoOrTarget: StandardOrLegacyFieldDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyFieldDecoratorArgs["nameOrContext"]) => any;

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

@@ -1,4 +1,3 @@
-import{g as k}from"./legacy/consume-context.js";import{o as q}from"./standard/consume-context.js";import"../events.js";function B(f){return function(j,b){if(typeof b==="object")return q(f)(j,b);return k(f)(j,b)}}export{B as consumeContext};
-export{B as f};
+import{t as a}from"../../chunk-3ynk7e1e.js";import"../../chunk-nctznxyz.js";import"../../chunk-fs4j94bk.js";import"../../chunk-p8k4g99a.js";import"../../chunk-ek664x1c.js";import"../../chunk-kmebacvv.js";import"../../chunk-eyw14d6y.js";import"../../chunk-cnyxrh9r.js";import"../../chunk-q9z6tnzw.js";import"../../chunk-t8xtvgyg.js";import"../../chunk-vgtggzb6.js";export{a as consumeContext};
 
-//# debugId=D0E540181126F79564756E2164756E21
+//# debugId=5FDC6FAAF7FA86CA64756E2164756E21

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

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/decorators/consume-context.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type {\n  LegacyFieldDecoratorArgs,\n  StandardFieldDecoratorArgs,\n  StandardOrLegacyFieldDecoratorArgs,\n} from '../../types';\nimport type { UnknownContext } from '../types';\nimport { consumeContext as legacyConsumeContext } from './legacy/consume-context';\nimport { consumeContext as standardConsumeContext } from './standard/consume-context';\n\n/**\n * A decorator to provide a context to the target element.\n * @param contextToProvide\n * @returns\n */\nexport function consumeContext(contextToProvide: UnknownContext) {\n  return function (\n    protoOrTarget: StandardOrLegacyFieldDecoratorArgs['protoOrTarget'],\n    nameOrContext: StandardOrLegacyFieldDecoratorArgs['nameOrContext'],\n  ): any {\n    if (typeof nameOrContext === 'object') {\n      return standardConsumeContext(contextToProvide)(\n        protoOrTarget as StandardFieldDecoratorArgs['protoOrTarget'],\n        nameOrContext as StandardFieldDecoratorArgs['nameOrContext'],\n      );\n    }\n    return legacyConsumeContext(contextToProvide)(\n      protoOrTarget as LegacyFieldDecoratorArgs['protoOrTarget'],\n      nameOrContext as LegacyFieldDecoratorArgs['nameOrContext'],\n    );\n  };\n}\n"
   ],
-  "mappings": "gIAcO,aAAS,ZAAc,CAAC,EAAkC,CAC/D,eAAgB,CACd,EACA,EACK,CACL,UAAW,IAAkB,SAC3B,OAAO,EAAuB,CAAgB,EAC5C,EACA,CACF,EAEF,OAAO,EAAqB,CAAgB,EAC1C,EACA,CACF",
-  "debugId": "D0E540181126F79564756E2164756E21",
+  "mappings": "",
+  "debugId": "5FDC6FAAF7FA86CA64756E2164756E21",
   "names": []
 }

package/dist/context/decorators/context-selection-delivery.d.ts

@@ -0,0 +1 @@
+export declare function createContextSelectionDelivery(host: object, apply: (value: unknown) => void, requestUpdate: boolean): (value: unknown) => void;

package/dist/context/decorators/context-selection-delivery.js

@@ -0,0 +1,3 @@
+import{G as a}from"../../chunk-5bkat72n.js";import"../../chunk-eyw14d6y.js";import"../../chunk-vgtggzb6.js";export{a as createContextSelectionDelivery};
+
+//# debugId=9AF538A050F3E1AC64756E2164756E21

package/dist/context/decorators/context-selection-delivery.js.map

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

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

@@ -1,13 +1,31 @@
-import type { StandardOrLegacyMethodDecoratorArgs } from '../../types';
-import type { Context, UnknownContext } from '../types';
-export type SubscribeToContextOptions<T extends UnknownContext> = {
+import type { RadiantElement } from '../../core/radiant-element';
+import type { Context, ContextType, UnknownContext } from '../types';
+export type ContextSelectorOptions<T extends UnknownContext, Selected = ContextType<T>> = {
+    /** Context token to resolve from ancestor providers. */
     context: T;
-    select?: (context: T['__context__']) => unknown;
+    /** Optional projection that narrows the resolved context before delivery. */
+    select?: (context: ContextType<T>) => Selected;
+    /** Whether client-side event-channel subscriptions should stay active after the first value. */
     subscribe?: boolean;
 };
+type ContextUpdateMethod<Selected> = (value: Selected) => unknown;
+type ContextSelectorDecorator<Selected> = {
+    <Host extends RadiantElement>(protoOrTarget: undefined, nameOrContext: ClassFieldDecoratorContext<Host, Selected>): (this: Host, initialValue: Selected) => Selected;
+    <Host extends RadiantElement, TMethod extends ContextUpdateMethod<Selected>>(protoOrTarget: TMethod, nameOrContext: ClassMethodDecoratorContext<Host, TMethod>): void;
+    (protoOrTarget: RadiantElement, nameOrContext: string): void;
+    (protoOrTarget: RadiantElement, nameOrContext: string, descriptor: TypedPropertyDescriptor<ContextUpdateMethod<Selected>>): TypedPropertyDescriptor<ContextUpdateMethod<Selected>> | void;
+};
 /**
- * A decorator to subscribe to a context selector.
- * @param option {@link SubscribeToContextOptions}
- * @returns
+ * Subscribes a field or method to the current value, or a selected slice, of a context.
+ *
+ * **Field form (preferred):** The field holds the latest context value and is
+ * updated whenever the provider changes. On `RadiantComponent` hosts, each
+ * update schedules `requestUpdate()` automatically so `render()` stays in sync.
+ *
+ * **Method form (deprecated — use `@onContextUpdate`):** The method is called
+ * with the new value on each change.
+ *
+ * @param options Context subscription configuration.
  */
-export declare function contextSelector<T extends Context<unknown, unknown>>(options: SubscribeToContextOptions<T>): (protoOrTarget: StandardOrLegacyMethodDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyMethodDecoratorArgs["nameOrContext"], descriptor?: StandardOrLegacyMethodDecoratorArgs["descriptor"]) => any;
+export declare function contextSelector<T extends Context<unknown, unknown>, Selected = ContextType<T>>(options: ContextSelectorOptions<T, Selected>): ContextSelectorDecorator<Selected>;
+export {};

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

@@ -1,4 +1,3 @@
-import{i as v}from"./standard/context-selector.js";import{j as q}from"./legacy/context-selector.js";import"../events.js";function D(h){return function(j,f,w){if(typeof f==="object")return v(h)(j,f);return q(h)(j,f,w)}}export{D as contextSelector};
-export{D as h};
+import{B as a}from"../../chunk-g5n3m11h.js";import"../../chunk-s09s5ayx.js";import"../../chunk-g2z3mm6b.js";import"../../chunk-x2k0ngpz.js";import"../../chunk-kakpjgzf.js";import"../../chunk-5bkat72n.js";import"../../chunk-p8k4g99a.js";import"../../chunk-ek664x1c.js";import"../../chunk-kmebacvv.js";import"../../chunk-eyw14d6y.js";import"../../chunk-cnyxrh9r.js";import"../../chunk-t8xtvgyg.js";import"../../chunk-vgtggzb6.js";export{a as contextSelector};
 
-//# debugId=0C0E19D0A850DDF264756E2164756E21
+//# debugId=DACE64961DE0094664756E2164756E21