@ecopages/radiant 0.3.0-alpha.2 → 0.3.0-alpha.21

package/README.md

@@ -1,8 +1,8 @@
 # Radiant
 
-Radiant is a light-DOM custom element library.
+Radiant is a light-DOM platform for custom elements and DOM-attached controllers.
 
-It keeps browser primitives visible instead of wrapping them in a synthetic component model. You work with real custom elements, real DOM events, real attributes, and real light-DOM children. When you want JSX-backed rendering, SSR host serialization, and hydration, use `RadiantComponent`. When you want a more imperative base without JSX, use `RadiantElement`.
+It keeps browser primitives visible instead of wrapping them in a synthetic component model. You work with real custom elements, real DOM events, real attributes, and real light-DOM children. Use `RadiantElement` when you want reactive fields, JSX-backed rendering, SSR host serialization, and hydration on a real custom element. Use `RadiantController` when you want behavior attached to existing DOM instead of defining a custom element.
 
 Radiant deliberately does not use shadow DOM by default. That makes styling, DOM inspection, and authored child content simpler, while giving up some of the encapsulation that conventional custom-element guidance usually prefers.
 
@@ -10,19 +10,21 @@ For the full docs site, see [radiant.ecopages.app](https://radiant.ecopages.app/
 
 ## Installation
 
-`@ecopages/radiant` currently expects both `@ecopages/signals` and `@ecopages/jsx` as peer dependencies.
+`@ecopages/radiant` is the core package. `@ecopages/jsx` and `@ecopages/signals` are companion packages for TSX rendering and standalone signals.
+
+`@ecopages/radiant` currently declares both companion packages as peer dependencies.
 
 Install all three packages:
 
 ```sh
-bun install @ecopages/radiant @ecopages/signals @ecopages/jsx
+bun add @ecopages/radiant @ecopages/signals @ecopages/jsx
 ```
 
-Important: even if you are starting from `RadiantElement`, the current package surface still depends on `@ecopages/jsx`.
+Application code does not need to import JSX helpers or Signals primitives directly for every feature, but the current published Radiant surface expects both companion packages to be installed alongside it.
 
-## RadiantComponent Mental Model
+## RadiantElement Mental Model
 
-`RadiantComponent` is the structured JSX-first base class.
+`RadiantElement` is the structured base class for reactive custom elements.
 
 - `render()` returns the current JSX view.
 - First connect automatically chooses between hydration and a fresh client render.
@@ -39,17 +41,17 @@ The key distinction is this:
 - Use bindings such as `this.$.count` when the shape of the view stays the same and only child values need to change.
 - Use `update()` or `requestUpdate()` when a reactive change affects the structure of the JSX tree.
 
-Signal and store reads performed directly inside `render()` also participate in rerender invalidation, so shared reactive data can drive `RadiantComponent` views without an extra wrapper layer.
+Signal and store reads performed directly inside `render()` also participate in rerender invalidation, so shared reactive data can drive `RadiantElement` views without an extra wrapper layer.
 
 ## Counter Example
 
-This counter shows the intended `RadiantComponent` style for stable templates: public props stay explicit, internal state stays local, and bound child values update without forcing a full rerender of the whole template.
+This counter shows the intended `RadiantElement` style for stable templates: public props stay explicit, internal state stays local, and bound child values update without forcing a full rerender of the whole template.
 
 ```tsx
 /** @jsxImportSource @ecopages/jsx */
 
 import type { JsxCustomElementAttributes } from '@ecopages/jsx';
-import { RadiantComponent, customElement, prop, state } from '@ecopages/radiant';
+import { RadiantElement, customElement, prop, state } from '@ecopages/radiant';
 
 type CounterCardBindings = {
 	count: number;
@@ -61,7 +63,7 @@ type CounterCardAttributes = {
 };
 
 @customElement('counter-card')
-export class CounterCard extends RadiantComponent<CounterCardBindings> {
+export class CounterCard extends RadiantElement<CounterCardBindings> {
 	@prop({ type: String, defaultValue: 'Clicks' }) label!: string;
 	@state count = 0;
 
@@ -104,9 +106,9 @@ If the same type truly represents both internal bindings and public JSX attribut
 Call `update()` or `requestUpdate()` when a reactive change affects which elements should exist, not just their child values.
 
 ```ts
-import { RadiantComponent, onUpdated, state } from '@ecopages/radiant';
+import { RadiantElement, onUpdated, state } from '@ecopages/radiant';
 
-export class ResultsPanel extends RadiantComponent<{ expanded: boolean }> {
+export class ResultsPanel extends RadiantElement<{ expanded: boolean }> {
 	@state expanded = false;
 
 	@onUpdated('expanded')
@@ -122,7 +124,7 @@ Use `update()` when you want the rerender immediately. Use `requestUpdate()` whe
 
 Bindings are the non-obvious part of the API, and they are worth being explicit about.
 
-`RadiantComponent<Bindings>` and `RadiantElement<Bindings>` take a dedicated binding shape, not the full class type. That keeps the binding namespace limited to the reactive props or fields you want JSX to consume.
+`RadiantElement<Bindings>` takes a dedicated binding shape, not the full class type. That keeps the binding namespace limited to the reactive props or fields you want JSX to consume.
 
 These three forms are equivalent:
 
@@ -142,16 +144,16 @@ Use `@onUpdated(...)` with `update()` or `requestUpdate()` when the reactive cha
 
 ## SSR And Hydration
 
-`RadiantComponent` has two SSR surfaces:
+`RadiantElement` has two SSR surfaces:
 
 - `renderToString()` serializes the component view only.
 - `renderHostToString()` serializes the custom-element host together with the current view.
 
 In practice, `renderHostToString()` is the right default for full component SSR because it emits `<my-element>...</my-element>` instead of only the view fragment.
 
-`hydrate: true` adds hydration markers for the component view. First-connect hydration is now explicit: SSR pages should import `@ecopages/radiant/client/install-hydrator` before loading component modules, or call `installRadiantHydrator()` from `@ecopages/radiant/client/hydrator` before custom elements upgrade. Without that client hydrator gate, SSR hosts fall back to a fresh client render on first connect.
+`mode: 'hydrate'` adds hydration markers for the component view. First-connect hydration is now explicit: SSR pages should import `@ecopages/radiant/client/install-hydrator` before loading component modules, or call `installRadiantHydrator()` from `@ecopages/radiant/client/hydrator` before custom elements upgrade. Without that client hydrator gate, SSR hosts fall back to a fresh client render on first connect.
 
-For component-owned SSR, the instance methods still work. For adapters, fragment responses, and shared server utilities, prefer the explicit helpers under `@ecopages/radiant/server/render-component`.
+For element-owned SSR, the instance methods still work. For adapters, fragment responses, and shared server utilities, prefer the explicit helpers under `@ecopages/radiant/server/render-component`.
 
 Server runtime setup, fragment rendering helpers, and SSR-specific import guidance now live in [src/server/README.md](src/server/README.md).
 
@@ -161,12 +163,12 @@ For the client lifecycle and hydration flow diagram, see [src/core/README.md](sr
 
 Radiant does not invent a synthetic event layer. JSX handlers and decorators work with the native browser event object directly.
 
-| Use this             | When you want                                                     | Runtime shape                                                                                    |
-| -------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
-| `on:*` in JSX        | The normal event API                                              | Auto-delegates a fixed allowlist of bubbling events and falls back to direct listeners otherwise |
-| `on-native:*` in JSX | Exact element-level browser listener semantics                    | Always calls `addEventListener(...)` on that element                                             |
-| `@onEvent(...)`      | Class-level listening from `RadiantElement` or `RadiantComponent` | Supports `selector`, `ref`, `window`, and `document` targets                                     |
-| `@event(...)`        | A typed custom event emitter owned by the component               | Dispatches a real `CustomEvent` from the host element                                            |
+| Use this             | When you want                                       | Runtime shape                                                                                    |
+| -------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| `on:*` in JSX        | The normal event API                                | Auto-delegates a fixed allowlist of bubbling events and falls back to direct listeners otherwise |
+| `on-native:*` in JSX | Exact element-level browser listener semantics      | Always calls `addEventListener(...)` on that element                                             |
+| `@onEvent(...)`      | Class-level listening from `RadiantElement`         | Supports `selector`, `ref`, `window`, and `document` targets                                     |
+| `@event(...)`        | A typed custom event emitter owned by the component | Dispatches a real `CustomEvent` from the host element                                            |
 
 ### How JSX Event Binding Works
 
@@ -211,10 +213,10 @@ At the class level, `@onEvent(...)` is the main decorator for incoming DOM event
 ```tsx
 /** @jsxImportSource @ecopages/jsx */
 
-import { RadiantComponent, customElement, onEvent, state } from '@ecopages/radiant';
+import { RadiantElement, customElement, onEvent, state } from '@ecopages/radiant';
 
 @customElement('keyboard-panel')
-export class KeyboardPanel extends RadiantComponent<{ lastKey: string }> {
+export class KeyboardPanel extends RadiantElement<{ lastKey: string }> {
 	@state lastKey = 'none';
 
 	@onEvent({ document: true, type: 'keydown' })
@@ -265,40 +267,49 @@ The mental model stays simple:
 
 These are the documented public import paths exposed by the package.
 
-| Path                                          | Use for                                                                                                         |
-| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
-| `@ecopages/radiant`                           | Main client entrypoint. Re-exports `RadiantElement`, `RadiantComponent`, common decorators, and context helpers |
-| `@ecopages/radiant/context`                   | Context-related exports as a grouped entrypoint                                                                 |
-| `@ecopages/radiant/context/create-context`    | Creating context keys                                                                                           |
-| `@ecopages/radiant/context/context-provider`  | Low-level context provider class                                                                                |
-| `@ecopages/radiant/context/consume-context`   | `@consumeContext(...)` decorator                                                                                |
-| `@ecopages/radiant/context/provide-context`   | `@provideContext(...)` decorator                                                                                |
-| `@ecopages/radiant/context/context-selector`  | `@contextSelector(...)` decorator — bind a field to context                                                     |
-| `@ecopages/radiant/context/on-context-update` | `@onContextUpdate(...)` decorator — run a method on context change                                              |
-| `@ecopages/radiant/core/radiant-element`      | Non-JSX reactive custom-element base                                                                            |
-| `@ecopages/radiant/core/radiant-component`    | JSX-first component base                                                                                        |
-| `@ecopages/radiant/client/hydrator`           | Explicit client hydrator installer and status helpers for SSR pages                                             |
-| `@ecopages/radiant/client/install-hydrator`   | Side-effect entrypoint that enables first-connect hydration before component modules load                       |
-| `@ecopages/radiant/signals/host-resource`     | Low-level `HostResource`, `createHostResource(...)`, and `createResource(...)` helpers                          |
-| `@ecopages/radiant/server/light-dom-shim`     | Minimal SSR window and host-preparation helpers                                                                 |
-| `@ecopages/radiant/server/render-component`   | Canonical component SSR helpers and metadata utilities                                                          |
-| `@ecopages/radiant/server/project-root`       | Project-root resolution helper for server adapters                                                              |
-| `@ecopages/radiant/decorators/bound`          | `@bound`                                                                                                        |
-| `@ecopages/radiant/decorators/custom-element` | `@customElement(...)`                                                                                           |
-| `@ecopages/radiant/decorators/debounce`       | `@debounce(...)`                                                                                                |
-| `@ecopages/radiant/decorators/event`          | `@event(...)`                                                                                                   |
-| `@ecopages/radiant/decorators/on-event`       | `@onEvent(...)`                                                                                                 |
-| `@ecopages/radiant/decorators/on-updated`     | `@onUpdated(...)`                                                                                               |
-| `@ecopages/radiant/decorators/prop`           | `@prop(...)`                                                                                                    |
-| `@ecopages/radiant/decorators/query`          | `@query(...)`                                                                                                   |
-| `@ecopages/radiant/decorators/query-slot`     | `@querySlot(...)`                                                                                               |
-| `@ecopages/radiant/decorators/signal`         | `@signal(...)`                                                                                                  |
-| `@ecopages/radiant/decorators/state`          | `@state`                                                                                                        |
-| `@ecopages/radiant/tools/stringify-typed`     | Typed attribute serialization helper                                                                            |
-| `@ecopages/radiant/tools/render-jsx-template` | Render a JSX template result into an existing host                                                              |
-| `@ecopages/radiant/tools/escape-script-json`  | Safe JSON-for-script serialization helper                                                                       |
-| `@ecopages/radiant/tools/event-emitter`       | Low-level `EventEmitter` helper                                                                                 |
-
-Import component bases, decorators, and context helpers from the root entrypoint. Import server and low-level tool helpers from their explicit public subpaths.
+| Path                                              | Use for                                                                                                                                                                             |
+| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@ecopages/radiant`                               | Main client entrypoint. Re-exports `RadiantElement`, `RadiantController`, reactive JSX bindings, common decorators, and controller-registry helpers such as `startControllers(...)` |
+| `@ecopages/radiant/context`                       | Context-related exports as a grouped entrypoint                                                                                                                                     |
+| `@ecopages/radiant/context/create-context`        | Creating context keys                                                                                                                                                               |
+| `@ecopages/radiant/context/context-provider`      | Low-level context provider class                                                                                                                                                    |
+| `@ecopages/radiant/context/consume-context`       | `@consumeContext(...)` decorator                                                                                                                                                    |
+| `@ecopages/radiant/context/provide-context`       | `@provideContext(...)` decorator                                                                                                                                                    |
+| `@ecopages/radiant/context/context-selector`      | `@contextSelector(...)` decorator — bind a field to context                                                                                                                         |
+| `@ecopages/radiant/context/on-context-update`     | `@onContextUpdate(...)` decorator — run a method on context change                                                                                                                  |
+| `@ecopages/radiant/controller-registry`           | Controller registration and activation helpers                                                                                                                                      |
+| `@ecopages/radiant/core/radiant-element`          | Non-JSX reactive custom-element base                                                                                                                                                |
+| `@ecopages/radiant/core/radiant-controller`       | DOM-attached controller base                                                                                                                                                        |
+| `@ecopages/radiant/helpers/create-query`          | Low-level query helper for component fields                                                                                                                                         |
+| `@ecopages/radiant/helpers/create-query-slot`     | Low-level slot query helper for component fields                                                                                                                                    |
+| `@ecopages/radiant/helpers/create-event`          | Low-level typed custom-event helper                                                                                                                                                 |
+| `@ecopages/radiant/helpers/create-event-listener` | Low-level DOM event-listener helper                                                                                                                                                 |
+| `@ecopages/radiant/client/hydrator`               | Explicit client hydrator installer and status helpers for SSR pages                                                                                                                 |
+| `@ecopages/radiant/client/install-hydrator`       | Side-effect entrypoint that enables first-connect hydration before component modules load                                                                                           |
+| `@ecopages/radiant/signals/host-resource`         | Low-level `HostResource`, `createHostResource(...)`, and `createResource(...)` helpers                                                                                              |
+| `@ecopages/radiant/server/light-dom-shim`         | Minimal SSR window and host-preparation helpers                                                                                                                                     |
+| `@ecopages/radiant/server/render-component`       | Canonical component SSR helpers and shared fragment metadata utilities                                                                                                              |
+| `@ecopages/radiant/server/render-controller`      | Controller-host SSR helpers and controller-specific host option types                                                                                                               |
+| `@ecopages/radiant/server/project-root`           | Project-root resolution helper for server adapters                                                                                                                                  |
+| `@ecopages/radiant/decorators/bound`              | `@bound`                                                                                                                                                                            |
+| `@ecopages/radiant/decorators/custom-element`     | `@customElement(...)`                                                                                                                                                               |
+| `@ecopages/radiant/decorators/debounce`           | `@debounce(...)`                                                                                                                                                                    |
+| `@ecopages/radiant/decorators/event`              | `@event(...)`                                                                                                                                                                       |
+| `@ecopages/radiant/decorators/on-event`           | `@onEvent(...)`                                                                                                                                                                     |
+| `@ecopages/radiant/decorators/on-updated`         | `@onUpdated(...)`                                                                                                                                                                   |
+| `@ecopages/radiant/decorators/prop`               | `@prop(...)`                                                                                                                                                                        |
+| `@ecopages/radiant/decorators/query`              | `@query(...)`                                                                                                                                                                       |
+| `@ecopages/radiant/decorators/query-slot`         | `@querySlot(...)`                                                                                                                                                                   |
+| `@ecopages/radiant/decorators/signal`             | `@signal(...)`                                                                                                                                                                      |
+| `@ecopages/radiant/decorators/state`              | `@state`                                                                                                                                                                            |
+| `@ecopages/radiant/tools/render-jsx-template`     | Render a JSX template result into an existing host                                                                                                                                  |
+| `@ecopages/radiant/tools/escape-script-json`      | Safe JSON-for-script serialization helper                                                                                                                                           |
+| `@ecopages/radiant/tools/event-emitter`           | Low-level `EventEmitter` helper                                                                                                                                                     |
+
+Prefer focused public subpaths when bundle size matters or when a module only needs one narrow runtime surface. The root entrypoint remains the ergonomic default for common app code, but context, registry, helper, server, signal-resource, and low-level tool imports are better taken from their explicit public subpaths.
+
+For controller authoring, prefer a single import surface per module. If a file mixes `RadiantController`, `@controller(...)`, `@state`, `@attr(...)`, or `startControllers(...)`, default to `@ecopages/radiant` so controller registration and startup come from the same entrypoint.
+
+Important: context APIs, controller registry helpers, helper factories, server APIs, and low-level tools have explicit public subpaths. Prefer those focused paths for library and adapter code, or when a module intentionally wants only the registry runtime without the broader client surface; the root entrypoint remains the ergonomic app entrypoint for the common client surface.
 
 For SSR-specific guidance and examples, see [src/server/README.md](src/server/README.md).

package/client/app-bootstrap.d.ts

@@ -0,0 +1,19 @@
+import type { JsxRenderable } from '@ecopages/jsx';
+export type RadiantAppBootstrapContext = {
+    documentRoot: Document;
+    rootElement: HTMLElement;
+    shouldHydrate: boolean;
+};
+export type RadiantAppBootstrapResult<AppProps> = {
+    appProps: AppProps;
+    onStarted?: () => void | Promise<void>;
+};
+export type RadiantAppBootstrap<AppProps> = (context: RadiantAppBootstrapContext) => void | RadiantAppBootstrapResult<AppProps> | Promise<void | RadiantAppBootstrapResult<AppProps>>;
+export declare function prepareRadiantApp<AppProps = void>({ app, bootstrap, context, }: {
+    app: (props: AppProps) => JsxRenderable;
+    bootstrap?: RadiantAppBootstrap<AppProps>;
+    context: RadiantAppBootstrapContext;
+}): Promise<{
+    app: JsxRenderable;
+    onStarted?: () => void | Promise<void>;
+}>;

package/client/app-bootstrap.js

@@ -0,0 +1,3 @@
+var a=((p)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(p,{get:(t,o)=>(typeof require<"u"?require:t)[o]}):p)(function(p){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+p+'" is not supported')});async function s({app:p,bootstrap:t,context:o}){let e=await t?.(o);return{app:p(e?.appProps??void 0),onStarted:e?.onStarted}}export{s as prepareRadiantApp};
+
+//# debugId=CED638BAFDDA666064756E2164756E21

package/client/app-bootstrap.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/client/app-bootstrap.ts"],
+  "sourcesContent": [
+    "import type { JsxRenderable } from '@ecopages/jsx';\n\nexport type RadiantAppBootstrapContext = {\n\tdocumentRoot: Document;\n\trootElement: HTMLElement;\n\tshouldHydrate: boolean;\n};\n\nexport type RadiantAppBootstrapResult<AppProps> = {\n\tappProps: AppProps;\n\tonStarted?: () => void | Promise<void>;\n};\n\nexport type RadiantAppBootstrap<AppProps> = (\n\tcontext: RadiantAppBootstrapContext,\n) => void | RadiantAppBootstrapResult<AppProps> | Promise<void | RadiantAppBootstrapResult<AppProps>>;\n\nexport async function prepareRadiantApp<AppProps = void>({\n\tapp,\n\tbootstrap,\n\tcontext,\n}: {\n\tapp: (props: AppProps) => JsxRenderable;\n\tbootstrap?: RadiantAppBootstrap<AppProps>;\n\tcontext: RadiantAppBootstrapContext;\n}): Promise<{ app: JsxRenderable; onStarted?: () => void | Promise<void> }> {\n\tconst bootstrapResult = await bootstrap?.(context);\n\n\treturn {\n\t\tapp: app((bootstrapResult?.appProps ?? undefined) as AppProps),\n\t\tonStarted: bootstrapResult?.onStarted,\n\t};\n}\n"
+  ],
+  "mappings": "2PAiBA,eAAsB,CAAkC,EACvD,MACA,YACA,WAK2E,CAC3E,IAAM,EAAkB,MAAM,IAAY,CAAO,EAEjD,MAAO,CACN,IAAK,EAAK,GAAiB,UAAY,MAAsB,EAC7D,UAAW,GAAiB,SAC7B",
+  "debugId": "CED638BAFDDA666064756E2164756E21",
+  "names": []
+}

package/{dist/client → client}/hydrator.d.ts

@@ -1,5 +1,5 @@
 /**
- * Enables first-connect hydration for SSR-rendered RadiantComponent hosts.
+ * Enables first-connect hydration for SSR-rendered RadiantElement hosts.
  *
  * Import this from SSR pages before loading component modules so upgraded
  * custom elements hydrate their existing DOM instead of performing a fresh

package/client/hydrator.js

@@ -0,0 +1,3 @@
+var C=((f)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(f,{get:(v,z)=>(typeof require<"u"?require:v)[z]}):f)(function(f){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+f+'" is not supported')});var j=Symbol.for("@ecopages/radiant.hydrator-installed");function k(){globalThis[j]=!0}function m(){delete globalThis[j]}function q(){return globalThis[j]===!0}function K(){k()}function P(){m()}function Q(){return q()}export{P as uninstallRadiantHydrator,K as installRadiantHydrator,Q as hasRadiantHydrator};
+
+//# debugId=44CC84C7C166F16C64756E2164756E21

package/client/hydrator.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/radiant-hydrator-state.ts", "../src/client/hydrator.ts"],
+  "sourcesContent": [
+    "const RADIANT_HYDRATOR_INSTALLED_SYMBOL = Symbol.for('@ecopages/radiant.hydrator-installed');\n\ntype GlobalHydratorState = typeof globalThis & Record<PropertyKey, unknown>;\n\n/**\n * Marks the current JavaScript environment as hydration-enabled for first\n * custom-element connect.\n *\n * `RadiantElement` reads this flag before deciding whether SSR markup should\n * hydrate in place or be replaced by a fresh client render.\n */\nexport function installRadiantHydratorState(): void {\n\t(globalThis as GlobalHydratorState)[RADIANT_HYDRATOR_INSTALLED_SYMBOL] = true;\n}\n\n/**\n * Clears the explicit hydration-enabled flag from `globalThis`.\n *\n * This is mainly used by tests so they can assert both hydrated and non-\n * hydrated first-connect behavior deterministically.\n */\nexport function uninstallRadiantHydratorState(): void {\n\tdelete (globalThis as GlobalHydratorState)[RADIANT_HYDRATOR_INSTALLED_SYMBOL];\n}\n\n/**\n * Returns whether first-connect hydration is currently enabled for this\n * JavaScript environment.\n */\nexport function isRadiantHydratorInstalled(): boolean {\n\treturn (globalThis as GlobalHydratorState)[RADIANT_HYDRATOR_INSTALLED_SYMBOL] === true;\n}\n",
+    "import {\n\tisRadiantHydratorInstalled,\n\tinstallRadiantHydratorState,\n\tuninstallRadiantHydratorState,\n} from '../core/radiant-hydrator-state';\n\n/**\n * Enables first-connect hydration for SSR-rendered RadiantElement 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": "2PAAA,IAAM,EAAoC,OAAO,IAAI,sCAAsC,EAWpF,SAAS,CAA2B,EAAS,CAClD,WAAmC,GAAqC,GASnE,SAAS,CAA6B,EAAS,CACrD,OAAQ,WAAmC,GAOrC,SAAS,CAA0B,EAAY,CACrD,OAAQ,WAAmC,KAAuC,GCjB5E,SAAS,CAAsB,EAAS,CAC9C,EAA4B,EAStB,SAAS,CAAwB,EAAS,CAChD,EAA8B,EAMxB,SAAS,CAAkB,EAAY,CAC7C,OAAO,EAA2B",
+  "debugId": "44CC84C7C166F16C64756E2164756E21",
+  "names": []
+}

package/client/install-hydrator.js

@@ -0,0 +1,3 @@
+var C=((m)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(m,{get:(v,z)=>(typeof require<"u"?require:v)[z]}):m)(function(m){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+m+'" is not supported')});var f=Symbol.for("@ecopages/radiant.hydrator-installed");function j(){globalThis[f]=!0}function k(){delete globalThis[f]}function p(){return globalThis[f]===!0}function q(){j()}function K(){k()}function P(){return p()}q();
+
+//# debugId=AE046A6617778EC864756E2164756E21

package/client/install-hydrator.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/core/radiant-hydrator-state.ts", "../src/client/hydrator.ts", "../src/client/install-hydrator.ts"],
+  "sourcesContent": [
+    "const RADIANT_HYDRATOR_INSTALLED_SYMBOL = Symbol.for('@ecopages/radiant.hydrator-installed');\n\ntype GlobalHydratorState = typeof globalThis & Record<PropertyKey, unknown>;\n\n/**\n * Marks the current JavaScript environment as hydration-enabled for first\n * custom-element connect.\n *\n * `RadiantElement` reads this flag before deciding whether SSR markup should\n * hydrate in place or be replaced by a fresh client render.\n */\nexport function installRadiantHydratorState(): void {\n\t(globalThis as GlobalHydratorState)[RADIANT_HYDRATOR_INSTALLED_SYMBOL] = true;\n}\n\n/**\n * Clears the explicit hydration-enabled flag from `globalThis`.\n *\n * This is mainly used by tests so they can assert both hydrated and non-\n * hydrated first-connect behavior deterministically.\n */\nexport function uninstallRadiantHydratorState(): void {\n\tdelete (globalThis as GlobalHydratorState)[RADIANT_HYDRATOR_INSTALLED_SYMBOL];\n}\n\n/**\n * Returns whether first-connect hydration is currently enabled for this\n * JavaScript environment.\n */\nexport function isRadiantHydratorInstalled(): boolean {\n\treturn (globalThis as GlobalHydratorState)[RADIANT_HYDRATOR_INSTALLED_SYMBOL] === true;\n}\n",
+    "import {\n\tisRadiantHydratorInstalled,\n\tinstallRadiantHydratorState,\n\tuninstallRadiantHydratorState,\n} from '../core/radiant-hydrator-state';\n\n/**\n * Enables first-connect hydration for SSR-rendered RadiantElement 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",
+    "import { installRadiantHydrator } from './hydrator';\n\ninstallRadiantHydrator();\n"
+  ],
+  "mappings": "2PAAA,IAAM,EAAoC,OAAO,IAAI,sCAAsC,EAWpF,SAAS,CAA2B,EAAS,CAClD,WAAmC,GAAqC,GASnE,SAAS,CAA6B,EAAS,CACrD,OAAQ,WAAmC,GAOrC,SAAS,CAA0B,EAAY,CACrD,OAAQ,WAAmC,KAAuC,GCjB5E,SAAS,CAAsB,EAAS,CAC9C,EAA4B,EAStB,SAAS,CAAwB,EAAS,CAChD,EAA8B,EAMxB,SAAS,CAAkB,EAAY,CAC7C,OAAO,EAA2B,EC7BnC,EAAuB",
+  "debugId": "AE046A6617778EC864756E2164756E21",
+  "names": []
+}

package/{dist/context → context}/context-consumer-bootstrap.d.ts

@@ -1,4 +1,4 @@
-import type { RadiantElement } from '../core/radiant-element';
+import type { ContextHostLike } from './context-host';
 import type { ContextType, UnknownContext } from './types';
 type ConsumedContextAssignment = (provider: unknown) => void;
 /**
@@ -8,7 +8,7 @@ type ConsumedContextAssignment = (provider: unknown) => void;
  * 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?: {
+export declare function bootstrapSsrConsumedContext(host: ContextHostLike, context: UnknownContext, assign: ConsumedContextAssignment, options?: {
     emitMounted?: boolean;
 }): boolean;
 /**
@@ -18,14 +18,14 @@ export declare function bootstrapSsrConsumedContext(host: RadiantElement, contex
  * 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;
+export declare function bootstrapSsrContextSelection<TContext extends UnknownContext, Selected = ContextType<TContext>>(host: object, context: TContext, callback: (value: Selected) => void, select?: (context: ContextType<TContext>) => Selected): 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?: {
+export declare function connectConsumedContext(host: ContextHostLike, context: UnknownContext, assign: ConsumedContextAssignment, options?: {
     emitMounted?: boolean;
 }): boolean;
 /**
@@ -34,8 +34,9 @@ export declare function connectConsumedContext(host: RadiantElement, context: Un
  *
  * @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;
+export declare function connectContextSelection<TContext extends UnknownContext, Selected = ContextType<TContext>>(host: ContextHostLike, context: TContext, callback: (value: Selected) => void, options?: {
+    select?: (context: ContextType<TContext>) => Selected;
     subscribe?: boolean;
+    onSubscribe?: (unsubscribe: () => void) => void;
 }): boolean;
 export {};

package/context/context-consumer-bootstrap.js

@@ -0,0 +1,3 @@
+var y=((j)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(j,{get:(w,H)=>(typeof require<"u"?require:w)[H]}):j)(function(j){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+j+'" is not supported')});var Z=Symbol.for("@ecopages/radiant.ssr-preparation-callbacks"),Y=Symbol.for("@ecopages/radiant.ssr-preparation-running");function f(j,w){let F=j[Z];if(Array.isArray(F)){F.push(w);return}Object.defineProperty(j,Z,{value:[w],configurable:!0})}function m(j){let w=j,H=w[Z];if(!Array.isArray(H))return;w[Y]=!0;try{for(let F of H)F()}finally{delete w[Y]}}var z=Symbol.for("@ecopages/radiant.ssr-context-provider-resolver");function K(){return globalThis}function O(j){K()[z]=j}function $(j){return K()[z]?.(j)}var G;((J)=>{J.SUBSCRIPTION_REQUEST="context-subscription-request";J.CONTEXT_REQUEST="context-request";J.ON_MOUNT="context-on-mount";J.MOUNTED="context-mounted"})(G||={});class D extends Event{context;callback;subscribe;handled=!1;constructor(j,w,H){super("context-request",{bubbles:!0,composed:!0});this.context=j;this.callback=w;this.subscribe=H}markHandled(){this.handled=!0}}class I extends CustomEvent{constructor(j){super("context-on-mount",{detail:{context:j},bubbles:!0,composed:!0})}}class M extends Event{context;callback;select;subscribe;onSubscribe;handled=!1;constructor(j,w,H,F,J){super("context-subscription-request",{bubbles:!0,composed:!0});this.context=j;this.callback=w;this.select=H;this.subscribe=F;this.onSubscribe=J}markHandled(){this.handled=!0}}function U(j,w,H,F={}){let J=$(w);if(!J)return!1;if(H(J),j.connectedContextCallback(w),F.emitMounted)j.dispatchEvent(new CustomEvent("context-mounted",{detail:J}));return!0}function V(j,w,H,F={}){let J=new D(w,(Q)=>{if(H(Q),j.connectedContextCallback(w),F.emitMounted)j.dispatchEvent(new CustomEvent("context-mounted",{detail:Q}))});return j.dispatchEvent(J),J.handled}function W(j,w){let H=$(j);if(!H)return!1;let F=H.getContext();if(w.select)return w.callback(w.select(F)),!0;return w.callback(F),!0}function X(j,w,H,F){let J=new M(w,H.callback,H.select,F.subscribe,F.onSubscribe);return j.dispatchEvent(J),J.handled}function g(j,w,H,F={}){return B(j,()=>U(j,w,H,F))}function b(j,w,H,F){return B(j,()=>{if(F)return W(w,{callback:H,select:F});return W(w,{callback:H})})}function d(j,w,H,F={}){if(U(j,w,H,F))return!0;return V(j,w,H,F)}function u(j,w,H,F={}){if(F.select){let Q={callback:H,select:F.select};if(W(w,Q))return!0;return X(j,w,Q,{subscribe:F.subscribe,onSubscribe:F.onSubscribe})}let J={callback:H};if(W(w,J))return!0;return X(j,w,J,{subscribe:F.subscribe,onSubscribe:F.onSubscribe})}function B(j,w){return f(j,w),w()}export{u as connectContextSelection,d as connectConsumedContext,b as bootstrapSsrContextSelection,g as bootstrapSsrConsumedContext};
+
+//# debugId=916174640860D2F664756E2164756E21

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

@@ -0,0 +1,14 @@
+{
+  "version": 3,
+  "sources": ["../src/core/ssr-preparation.ts", "../src/context/context-ssr-bridge.ts", "../src/context/events.ts", "../src/context/context-consumer-runtime.ts", "../src/context/context-consumer-bootstrap.ts"],
+  "sourcesContent": [
+    "type SsrPreparationCallback = () => void;\n\nconst SSR_PREPARATION_CALLBACKS = Symbol.for('@ecopages/radiant.ssr-preparation-callbacks');\nexport const SSR_PREPARATION_RUNNING = Symbol.for('@ecopages/radiant.ssr-preparation-running');\n\n/**\n * Registers instance-local SSR preparation work that should run immediately\n * before a Radiant host serializes its first server render.\n *\n * Decorators use this to defer SSR-only setup until after class fields,\n * reactive props, and authored host content have all been applied.\n */\nexport function registerSsrPreparationCallback(host: object, callback: SsrPreparationCallback): void {\n\tconst target = host as Record<PropertyKey, unknown>;\n\tconst existingCallbacks = target[SSR_PREPARATION_CALLBACKS];\n\n\tif (Array.isArray(existingCallbacks)) {\n\t\texistingCallbacks.push(callback);\n\t\treturn;\n\t}\n\n\tObject.defineProperty(host, SSR_PREPARATION_CALLBACKS, {\n\t\tvalue: [callback],\n\t\tconfigurable: true,\n\t});\n}\n\n/**\n * Runs all registered SSR preparation callbacks for the provided host.\n *\n * The callbacks are intentionally retained so repeated SSR serializations stay\n * deterministic after later host mutations.\n */\nexport function runSsrPreparationCallbacks(host: object): void {\n\tconst target = host as Record<PropertyKey, unknown>;\n\tconst callbacks = target[SSR_PREPARATION_CALLBACKS];\n\n\tif (!Array.isArray(callbacks)) {\n\t\treturn;\n\t}\n\n\ttarget[SSR_PREPARATION_RUNNING] = true;\n\n\ttry {\n\t\tfor (const callback of callbacks as SsrPreparationCallback[]) {\n\t\t\tcallback();\n\t\t}\n\t} finally {\n\t\tdelete target[SSR_PREPARATION_RUNNING];\n\t}\n}\n",
+    "import type { SsrSerializableContextProvider } from './context-provider';\nimport type { UnknownContext } from './types';\n\ntype SsrContextProviderResolver = (context: UnknownContext) => SsrSerializableContextProvider | undefined;\n\nconst SSR_CONTEXT_PROVIDER_RESOLVER_SYMBOL = Symbol.for('@ecopages/radiant.ssr-context-provider-resolver');\n\ntype GlobalResolverScope = typeof globalThis & {\n\t[SSR_CONTEXT_PROVIDER_RESOLVER_SYMBOL]?: SsrContextProviderResolver;\n};\n\nfunction getGlobalResolverScope(): GlobalResolverScope {\n\treturn globalThis as GlobalResolverScope;\n}\n\n/**\n * Installs the ambient SSR provider resolver used by shared context runtime helpers.\n *\n * Server-side rendering infrastructure owns the actual provider stack storage and\n * publishes a lookup function here so client/runtime code does not need to import\n * server-oriented modules.\n */\nexport function installSsrContextProviderResolver(resolver: SsrContextProviderResolver): void {\n\tgetGlobalResolverScope()[SSR_CONTEXT_PROVIDER_RESOLVER_SYMBOL] = resolver;\n}\n\n/**\n * Resolves an ambient SSR provider when a server render has published one.\n */\nexport function resolveAmbientSsrContextProvider(context: UnknownContext): SsrSerializableContextProvider | undefined {\n\treturn getGlobalResolverScope()[SSR_CONTEXT_PROVIDER_RESOLVER_SYMBOL]?.(context);\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 type { ContextHostLike } from './context-host';\nimport { resolveAmbientSsrContextProvider } from './context-ssr-bridge';\nimport { ContextEventsTypes, ContextRequestEvent, ContextSubscriptionRequestEvent } from './events';\nimport type { ContextCallback, ContextType, UnknownContext } from './types';\n\ntype ConsumedContextAssignment = (provider: unknown) => void;\n\ntype DirectContextSelectionRequest<TContext extends UnknownContext> = {\n\tcallback: (value: ContextType<TContext>) => void;\n\tselect?: undefined;\n};\n\ntype SelectedContextSelectionRequest<TContext extends UnknownContext, Selected> = {\n\tcallback: (value: Selected) => void;\n\tselect: (context: ContextType<TContext>) => Selected;\n};\n\ntype ContextSelectionRequest<TContext extends UnknownContext, Selected = ContextType<TContext>> =\n\t| DirectContextSelectionRequest<TContext>\n\t| SelectedContextSelectionRequest<TContext, Selected>;\n\n/**\n * Resolves a consumed context from the active SSR provider stack when one is available.\n *\n * This keeps SSR-specific lookup outside decorator implementations while preserving\n * the same consumer initialization contract for both standard and legacy decorators.\n *\n * @returns `true` when the context was resolved synchronously from SSR state.\n */\nexport function initializeConsumedContext(\n\thost: ContextHostLike,\n\tcontext: UnknownContext,\n\tassign: ConsumedContextAssignment,\n\toptions: { emitMounted?: boolean } = {},\n): boolean {\n\tconst provider = resolveAmbientSsrContextProvider(context);\n\n\tif (!provider) {\n\t\treturn false;\n\t}\n\n\tassign(provider);\n\thost.connectedContextCallback(context);\n\n\tif (options.emitMounted) {\n\t\thost.dispatchEvent(new CustomEvent(ContextEventsTypes.MOUNTED, { detail: provider }));\n\t}\n\n\treturn true;\n}\n\n/**\n * Requests a context provider through the DOM event channel when SSR state is not active.\n */\nexport function requestConsumedContext(\n\thost: ContextHostLike,\n\tcontext: UnknownContext,\n\tassign: ConsumedContextAssignment,\n\toptions: { emitMounted?: boolean } = {},\n): boolean {\n\tconst event = new ContextRequestEvent(context, (provider) => {\n\t\tassign(provider);\n\t\thost.connectedContextCallback(context);\n\n\t\tif (options.emitMounted) {\n\t\t\thost.dispatchEvent(new CustomEvent(ContextEventsTypes.MOUNTED, { detail: provider }));\n\t\t}\n\t});\n\n\thost.dispatchEvent(event);\n\treturn event.handled;\n}\n\n/**\n * Resolves a selected context value from the active SSR provider stack when available.\n *\n * @returns `true` when the selection callback was satisfied synchronously from SSR state.\n */\nexport function initializeContextSelection<TContext extends UnknownContext>(\n\tcontext: TContext,\n\trequest: DirectContextSelectionRequest<TContext>,\n): boolean;\nexport function initializeContextSelection<TContext extends UnknownContext, Selected>(\n\tcontext: TContext,\n\trequest: SelectedContextSelectionRequest<TContext, Selected>,\n): boolean;\nexport function initializeContextSelection<TContext extends UnknownContext, Selected = ContextType<TContext>>(\n\tcontext: TContext,\n\trequest: ContextSelectionRequest<TContext, Selected>,\n): boolean {\n\tconst provider = resolveAmbientSsrContextProvider(context);\n\n\tif (!provider) {\n\t\treturn false;\n\t}\n\n\tconst resolvedContext = provider.getContext() as ContextType<TContext>;\n\n\tif (request.select) {\n\t\trequest.callback(request.select(resolvedContext));\n\t\treturn true;\n\t}\n\n\trequest.callback(resolvedContext);\n\treturn true;\n}\n\n/**\n * Requests a selected context value through the DOM event channel.\n */\nexport function requestContextSelection<TContext extends UnknownContext>(\n\thost: ContextHostLike,\n\tcontext: TContext,\n\trequest: DirectContextSelectionRequest<TContext>,\n\toptions: {\n\t\tsubscribe?: boolean;\n\t\tonSubscribe?: (unsubscribe: () => void) => void;\n\t},\n): boolean;\nexport function requestContextSelection<TContext extends UnknownContext, Selected>(\n\thost: ContextHostLike,\n\tcontext: TContext,\n\trequest: SelectedContextSelectionRequest<TContext, Selected>,\n\toptions: {\n\t\tsubscribe?: boolean;\n\t\tonSubscribe?: (unsubscribe: () => void) => void;\n\t},\n): boolean;\nexport function requestContextSelection<TContext extends UnknownContext, Selected = ContextType<TContext>>(\n\thost: ContextHostLike,\n\tcontext: TContext,\n\trequest: ContextSelectionRequest<TContext, Selected>,\n\toptions: {\n\t\tsubscribe?: boolean;\n\t\tonSubscribe?: (unsubscribe: () => void) => void;\n\t},\n): boolean {\n\tconst event = new ContextSubscriptionRequestEvent(\n\t\tcontext,\n\t\trequest.callback as ContextCallback<Selected>,\n\t\trequest.select,\n\t\toptions.subscribe,\n\t\toptions.onSubscribe,\n\t);\n\n\thost.dispatchEvent(event);\n\treturn event.handled;\n}\n",
+    "import type { ContextHostLike } from './context-host';\nimport { registerSsrPreparationCallback } from '../core/ssr-preparation';\nimport {\n\tinitializeConsumedContext,\n\tinitializeContextSelection,\n\trequestConsumedContext,\n\trequestContextSelection,\n} from './context-consumer-runtime';\nimport type { ContextType, UnknownContext } from './types';\n\ntype ConsumedContextAssignment = (provider: unknown) => void;\n\n/**\n * Resolves a consumed context immediately and registers the same resolution to\n * run again during the later SSR preparation phase.\n *\n * This keeps constructor-time state and pre-serialization state aligned after\n * instance fields, props, or authored host content change during SSR setup.\n */\nexport function bootstrapSsrConsumedContext(\n\thost: ContextHostLike,\n\tcontext: UnknownContext,\n\tassign: ConsumedContextAssignment,\n\toptions: { emitMounted?: boolean } = {},\n): boolean {\n\treturn registerAndResolveConsumerBootstrap(host, () => initializeConsumedContext(host, context, assign, options));\n}\n\n/**\n * Resolves a selected context value immediately and registers the same\n * selection for the later SSR preparation phase.\n *\n * This lets nested SSR renders recompute selector-backed state after the host\n * has finished construction and any server-side configuration hooks have run.\n */\nexport function bootstrapSsrContextSelection<TContext extends UnknownContext, Selected = ContextType<TContext>>(\n\thost: object,\n\tcontext: TContext,\n\tcallback: (value: Selected) => void,\n\tselect?: (context: ContextType<TContext>) => Selected,\n): boolean {\n\treturn registerAndResolveConsumerBootstrap(host, () => {\n\t\tif (select) {\n\t\t\treturn initializeContextSelection(context, { callback, select });\n\t\t}\n\n\t\treturn initializeContextSelection(context, {\n\t\t\tcallback: callback as (value: ContextType<TContext>) => void,\n\t\t});\n\t});\n}\n\n/**\n * Resolves a consumed context from SSR when available, otherwise requests it\n * through the DOM event channel for the current client-side lifecycle pass.\n *\n * @returns `true` when the value was satisfied synchronously from SSR state.\n */\nexport function connectConsumedContext(\n\thost: ContextHostLike,\n\tcontext: UnknownContext,\n\tassign: ConsumedContextAssignment,\n\toptions: { emitMounted?: boolean } = {},\n): boolean {\n\tif (initializeConsumedContext(host, context, assign, options)) {\n\t\treturn true;\n\t}\n\n\treturn requestConsumedContext(host, context, assign, options);\n}\n\n/**\n * Resolves a selected context value from SSR when available, otherwise requests\n * it through the DOM event channel for the current client-side lifecycle pass.\n *\n * @returns `true` when the value was satisfied synchronously from SSR state.\n */\nexport function connectContextSelection<TContext extends UnknownContext, Selected = ContextType<TContext>>(\n\thost: ContextHostLike,\n\tcontext: TContext,\n\tcallback: (value: Selected) => void,\n\toptions: {\n\t\tselect?: (context: ContextType<TContext>) => Selected;\n\t\tsubscribe?: boolean;\n\t\tonSubscribe?: (unsubscribe: () => void) => void;\n\t} = {},\n): boolean {\n\tif (options.select) {\n\t\tconst request = { callback, select: options.select };\n\n\t\tif (initializeContextSelection(context, request)) {\n\t\t\treturn true;\n\t\t}\n\n\t\treturn requestContextSelection(host, context, request, {\n\t\t\tsubscribe: options.subscribe,\n\t\t\tonSubscribe: options.onSubscribe,\n\t\t});\n\t}\n\n\tconst request = {\n\t\tcallback: callback as (value: ContextType<TContext>) => void,\n\t};\n\n\tif (initializeContextSelection(context, request)) {\n\t\treturn true;\n\t}\n\n\treturn requestContextSelection(host, context, request, {\n\t\tsubscribe: options.subscribe,\n\t\tonSubscribe: options.onSubscribe,\n\t});\n}\n\nfunction registerAndResolveConsumerBootstrap<TResult>(host: object, resolve: () => TResult): TResult {\n\tregisterSsrPreparationCallback(host, resolve);\n\treturn resolve();\n}\n"
+  ],
+  "mappings": "2PAEA,IAAM,EAA4B,OAAO,IAAI,6CAA6C,EAC7E,EAA0B,OAAO,IAAI,2CAA2C,EAStF,SAAS,CAA8B,CAAC,EAAc,EAAwC,CAEpG,IAAM,EADS,EACkB,GAEjC,GAAI,MAAM,QAAQ,CAAiB,EAAG,CACrC,EAAkB,KAAK,CAAQ,EAC/B,OAGD,OAAO,eAAe,EAAM,EAA2B,CACtD,MAAO,CAAC,CAAQ,EAChB,aAAc,EACf,CAAC,EASK,SAAS,CAA0B,CAAC,EAAoB,CAC9D,IAAM,EAAS,EACT,EAAY,EAAO,GAEzB,GAAI,CAAC,MAAM,QAAQ,CAAS,EAC3B,OAGD,EAAO,GAA2B,GAElC,GAAI,CACH,QAAW,KAAY,EACtB,EAAS,SAET,CACD,OAAO,EAAO,IC3ChB,IAAM,EAAuC,OAAO,IAAI,iDAAiD,EAMzG,SAAS,CAAsB,EAAwB,CACtD,OAAO,WAUD,SAAS,CAAiC,CAAC,EAA4C,CAC7F,EAAuB,EAAE,GAAwC,EAM3D,SAAS,CAAgC,CAAC,EAAqE,CACrH,OAAO,EAAuB,EAAE,KAAwC,CAAO,ECzBzE,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,CCtEO,SAAS,CAAyB,CACxC,EACA,EACA,EACA,EAAqC,CAAC,EAC5B,CACV,IAAM,EAAW,EAAiC,CAAO,EAEzD,GAAI,CAAC,EACJ,MAAO,GAMR,GAHA,EAAO,CAAQ,EACf,EAAK,yBAAyB,CAAO,EAEjC,EAAQ,YACX,EAAK,cAAc,IAAI,8BAAwC,CAAE,OAAQ,CAAS,CAAC,CAAC,EAGrF,MAAO,GAMD,SAAS,CAAsB,CACrC,EACA,EACA,EACA,EAAqC,CAAC,EAC5B,CACV,IAAM,EAAQ,IAAI,EAAoB,EAAS,CAAC,IAAa,CAI5D,GAHA,EAAO,CAAQ,EACf,EAAK,yBAAyB,CAAO,EAEjC,EAAQ,YACX,EAAK,cAAc,IAAI,8BAAwC,CAAE,OAAQ,CAAS,CAAC,CAAC,EAErF,EAGD,OADA,EAAK,cAAc,CAAK,EACjB,EAAM,QAgBP,SAAS,CAA6F,CAC5G,EACA,EACU,CACV,IAAM,EAAW,EAAiC,CAAO,EAEzD,GAAI,CAAC,EACJ,MAAO,GAGR,IAAM,EAAkB,EAAS,WAAW,EAE5C,GAAI,EAAQ,OAEX,OADA,EAAQ,SAAS,EAAQ,OAAO,CAAe,CAAC,EACzC,GAIR,OADA,EAAQ,SAAS,CAAe,EACzB,GAwBD,SAAS,CAA0F,CACzG,EACA,EACA,EACA,EAIU,CACV,IAAM,EAAQ,IAAI,EACjB,EACA,EAAQ,SACR,EAAQ,OACR,EAAQ,UACR,EAAQ,WACT,EAGA,OADA,EAAK,cAAc,CAAK,EACjB,EAAM,QC/HP,SAAS,CAA2B,CAC1C,EACA,EACA,EACA,EAAqC,CAAC,EAC5B,CACV,OAAO,EAAoC,EAAM,IAAM,EAA0B,EAAM,EAAS,EAAQ,CAAO,CAAC,EAU1G,SAAS,CAA+F,CAC9G,EACA,EACA,EACA,EACU,CACV,OAAO,EAAoC,EAAM,IAAM,CACtD,GAAI,EACH,OAAO,EAA2B,EAAS,CAAE,WAAU,QAAO,CAAC,EAGhE,OAAO,EAA2B,EAAS,CAC1C,SAAU,CACX,CAAC,EACD,EASK,SAAS,CAAsB,CACrC,EACA,EACA,EACA,EAAqC,CAAC,EAC5B,CACV,GAAI,EAA0B,EAAM,EAAS,EAAQ,CAAO,EAC3D,MAAO,GAGR,OAAO,EAAuB,EAAM,EAAS,EAAQ,CAAO,EAStD,SAAS,CAA0F,CACzG,EACA,EACA,EACA,EAII,CAAC,EACK,CACV,GAAI,EAAQ,OAAQ,CACnB,IAAM,EAAU,CAAE,WAAU,OAAQ,EAAQ,MAAO,EAEnD,GAAI,EAA2B,EAAS,CAAO,EAC9C,MAAO,GAGR,OAAO,EAAwB,EAAM,EAAS,EAAS,CACtD,UAAW,EAAQ,UACnB,YAAa,EAAQ,WACtB,CAAC,EAGF,IAAM,EAAU,CACf,SAAU,CACX,EAEA,GAAI,EAA2B,EAAS,CAAO,EAC9C,MAAO,GAGR,OAAO,EAAwB,EAAM,EAAS,EAAS,CACtD,UAAW,EAAQ,UACnB,YAAa,EAAQ,WACtB,CAAC,EAGF,SAAS,CAA4C,CAAC,EAAc,EAAiC,CAEpG,OADA,EAA+B,EAAM,CAAO,EACrC,EAAQ",
+  "debugId": "916174640860D2F664756E2164756E21",
+  "names": []
+}

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

@@ -0,0 +1,47 @@
+import type { ContextHostLike } from './context-host';
+import type { ContextType, UnknownContext } from './types';
+type ConsumedContextAssignment = (provider: unknown) => void;
+type DirectContextSelectionRequest<TContext extends UnknownContext> = {
+    callback: (value: ContextType<TContext>) => void;
+    select?: undefined;
+};
+type SelectedContextSelectionRequest<TContext extends UnknownContext, Selected> = {
+    callback: (value: Selected) => void;
+    select: (context: ContextType<TContext>) => Selected;
+};
+/**
+ * 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: ContextHostLike, 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: ContextHostLike, context: UnknownContext, assign: ConsumedContextAssignment, options?: {
+    emitMounted?: boolean;
+}): boolean;
+/**
+ * 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, request: DirectContextSelectionRequest<TContext>): boolean;
+export declare function initializeContextSelection<TContext extends UnknownContext, Selected>(context: TContext, request: SelectedContextSelectionRequest<TContext, Selected>): boolean;
+/**
+ * Requests a selected context value through the DOM event channel.
+ */
+export declare function requestContextSelection<TContext extends UnknownContext>(host: ContextHostLike, context: TContext, request: DirectContextSelectionRequest<TContext>, options: {
+    subscribe?: boolean;
+    onSubscribe?: (unsubscribe: () => void) => void;
+}): boolean;
+export declare function requestContextSelection<TContext extends UnknownContext, Selected>(host: ContextHostLike, context: TContext, request: SelectedContextSelectionRequest<TContext, Selected>, options: {
+    subscribe?: boolean;
+    onSubscribe?: (unsubscribe: () => void) => void;
+}): boolean;
+export {};

package/context/context-consumer-runtime.js

@@ -0,0 +1,3 @@
+var f=((j)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(j,{get:(k,z)=>(typeof require<"u"?require:k)[z]}):j)(function(j){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+j+'" is not supported')});var U=Symbol.for("@ecopages/radiant.ssr-context-provider-resolver");function W(){return globalThis}function D(j){W()[U]=j}function H(j){return W()[U]?.(j)}var Z;((w)=>{w.SUBSCRIPTION_REQUEST="context-subscription-request";w.CONTEXT_REQUEST="context-request";w.ON_MOUNT="context-on-mount";w.MOUNTED="context-mounted"})(Z||={});class J extends Event{context;callback;subscribe;handled=!1;constructor(j,k,z){super("context-request",{bubbles:!0,composed:!0});this.context=j;this.callback=k;this.subscribe=z}markHandled(){this.handled=!0}}class $ extends CustomEvent{constructor(j){super("context-on-mount",{detail:{context:j},bubbles:!0,composed:!0})}}class K extends Event{context;callback;select;subscribe;onSubscribe;handled=!1;constructor(j,k,z,F,w){super("context-subscription-request",{bubbles:!0,composed:!0});this.context=j;this.callback=k;this.select=z;this.subscribe=F;this.onSubscribe=w}markHandled(){this.handled=!0}}function X(j,k,z,F={}){let w=H(k);if(!w)return!1;if(z(w),j.connectedContextCallback(k),F.emitMounted)j.dispatchEvent(new CustomEvent("context-mounted",{detail:w}));return!0}function Y(j,k,z,F={}){let w=new J(k,(Q)=>{if(z(Q),j.connectedContextCallback(k),F.emitMounted)j.dispatchEvent(new CustomEvent("context-mounted",{detail:Q}))});return j.dispatchEvent(w),w.handled}function A(j,k){let z=H(j);if(!z)return!1;let F=z.getContext();if(k.select)return k.callback(k.select(F)),!0;return k.callback(F),!0}function L(j,k,z,F){let w=new K(k,z.callback,z.select,F.subscribe,F.onSubscribe);return j.dispatchEvent(w),w.handled}export{L as requestContextSelection,Y as requestConsumedContext,A as initializeContextSelection,X as initializeConsumedContext};
+
+//# debugId=A42C1D7F427BF19B64756E2164756E21

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

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/context/context-ssr-bridge.ts", "../src/context/events.ts", "../src/context/context-consumer-runtime.ts"],
+  "sourcesContent": [
+    "import type { SsrSerializableContextProvider } from './context-provider';\nimport type { UnknownContext } from './types';\n\ntype SsrContextProviderResolver = (context: UnknownContext) => SsrSerializableContextProvider | undefined;\n\nconst SSR_CONTEXT_PROVIDER_RESOLVER_SYMBOL = Symbol.for('@ecopages/radiant.ssr-context-provider-resolver');\n\ntype GlobalResolverScope = typeof globalThis & {\n\t[SSR_CONTEXT_PROVIDER_RESOLVER_SYMBOL]?: SsrContextProviderResolver;\n};\n\nfunction getGlobalResolverScope(): GlobalResolverScope {\n\treturn globalThis as GlobalResolverScope;\n}\n\n/**\n * Installs the ambient SSR provider resolver used by shared context runtime helpers.\n *\n * Server-side rendering infrastructure owns the actual provider stack storage and\n * publishes a lookup function here so client/runtime code does not need to import\n * server-oriented modules.\n */\nexport function installSsrContextProviderResolver(resolver: SsrContextProviderResolver): void {\n\tgetGlobalResolverScope()[SSR_CONTEXT_PROVIDER_RESOLVER_SYMBOL] = resolver;\n}\n\n/**\n * Resolves an ambient SSR provider when a server render has published one.\n */\nexport function resolveAmbientSsrContextProvider(context: UnknownContext): SsrSerializableContextProvider | undefined {\n\treturn getGlobalResolverScope()[SSR_CONTEXT_PROVIDER_RESOLVER_SYMBOL]?.(context);\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 type { ContextHostLike } from './context-host';\nimport { resolveAmbientSsrContextProvider } from './context-ssr-bridge';\nimport { ContextEventsTypes, ContextRequestEvent, ContextSubscriptionRequestEvent } from './events';\nimport type { ContextCallback, ContextType, UnknownContext } from './types';\n\ntype ConsumedContextAssignment = (provider: unknown) => void;\n\ntype DirectContextSelectionRequest<TContext extends UnknownContext> = {\n\tcallback: (value: ContextType<TContext>) => void;\n\tselect?: undefined;\n};\n\ntype SelectedContextSelectionRequest<TContext extends UnknownContext, Selected> = {\n\tcallback: (value: Selected) => void;\n\tselect: (context: ContextType<TContext>) => Selected;\n};\n\ntype ContextSelectionRequest<TContext extends UnknownContext, Selected = ContextType<TContext>> =\n\t| DirectContextSelectionRequest<TContext>\n\t| SelectedContextSelectionRequest<TContext, Selected>;\n\n/**\n * Resolves a consumed context from the active SSR provider stack when one is available.\n *\n * This keeps SSR-specific lookup outside decorator implementations while preserving\n * the same consumer initialization contract for both standard and legacy decorators.\n *\n * @returns `true` when the context was resolved synchronously from SSR state.\n */\nexport function initializeConsumedContext(\n\thost: ContextHostLike,\n\tcontext: UnknownContext,\n\tassign: ConsumedContextAssignment,\n\toptions: { emitMounted?: boolean } = {},\n): boolean {\n\tconst provider = resolveAmbientSsrContextProvider(context);\n\n\tif (!provider) {\n\t\treturn false;\n\t}\n\n\tassign(provider);\n\thost.connectedContextCallback(context);\n\n\tif (options.emitMounted) {\n\t\thost.dispatchEvent(new CustomEvent(ContextEventsTypes.MOUNTED, { detail: provider }));\n\t}\n\n\treturn true;\n}\n\n/**\n * Requests a context provider through the DOM event channel when SSR state is not active.\n */\nexport function requestConsumedContext(\n\thost: ContextHostLike,\n\tcontext: UnknownContext,\n\tassign: ConsumedContextAssignment,\n\toptions: { emitMounted?: boolean } = {},\n): boolean {\n\tconst event = new ContextRequestEvent(context, (provider) => {\n\t\tassign(provider);\n\t\thost.connectedContextCallback(context);\n\n\t\tif (options.emitMounted) {\n\t\t\thost.dispatchEvent(new CustomEvent(ContextEventsTypes.MOUNTED, { detail: provider }));\n\t\t}\n\t});\n\n\thost.dispatchEvent(event);\n\treturn event.handled;\n}\n\n/**\n * Resolves a selected context value from the active SSR provider stack when available.\n *\n * @returns `true` when the selection callback was satisfied synchronously from SSR state.\n */\nexport function initializeContextSelection<TContext extends UnknownContext>(\n\tcontext: TContext,\n\trequest: DirectContextSelectionRequest<TContext>,\n): boolean;\nexport function initializeContextSelection<TContext extends UnknownContext, Selected>(\n\tcontext: TContext,\n\trequest: SelectedContextSelectionRequest<TContext, Selected>,\n): boolean;\nexport function initializeContextSelection<TContext extends UnknownContext, Selected = ContextType<TContext>>(\n\tcontext: TContext,\n\trequest: ContextSelectionRequest<TContext, Selected>,\n): boolean {\n\tconst provider = resolveAmbientSsrContextProvider(context);\n\n\tif (!provider) {\n\t\treturn false;\n\t}\n\n\tconst resolvedContext = provider.getContext() as ContextType<TContext>;\n\n\tif (request.select) {\n\t\trequest.callback(request.select(resolvedContext));\n\t\treturn true;\n\t}\n\n\trequest.callback(resolvedContext);\n\treturn true;\n}\n\n/**\n * Requests a selected context value through the DOM event channel.\n */\nexport function requestContextSelection<TContext extends UnknownContext>(\n\thost: ContextHostLike,\n\tcontext: TContext,\n\trequest: DirectContextSelectionRequest<TContext>,\n\toptions: {\n\t\tsubscribe?: boolean;\n\t\tonSubscribe?: (unsubscribe: () => void) => void;\n\t},\n): boolean;\nexport function requestContextSelection<TContext extends UnknownContext, Selected>(\n\thost: ContextHostLike,\n\tcontext: TContext,\n\trequest: SelectedContextSelectionRequest<TContext, Selected>,\n\toptions: {\n\t\tsubscribe?: boolean;\n\t\tonSubscribe?: (unsubscribe: () => void) => void;\n\t},\n): boolean;\nexport function requestContextSelection<TContext extends UnknownContext, Selected = ContextType<TContext>>(\n\thost: ContextHostLike,\n\tcontext: TContext,\n\trequest: ContextSelectionRequest<TContext, Selected>,\n\toptions: {\n\t\tsubscribe?: boolean;\n\t\tonSubscribe?: (unsubscribe: () => void) => void;\n\t},\n): boolean {\n\tconst event = new ContextSubscriptionRequestEvent(\n\t\tcontext,\n\t\trequest.callback as ContextCallback<Selected>,\n\t\trequest.select,\n\t\toptions.subscribe,\n\t\toptions.onSubscribe,\n\t);\n\n\thost.dispatchEvent(event);\n\treturn event.handled;\n}\n"
+  ],
+  "mappings": "2PAKA,IAAM,EAAuC,OAAO,IAAI,iDAAiD,EAMzG,SAAS,CAAsB,EAAwB,CACtD,OAAO,WAUD,SAAS,CAAiC,CAAC,EAA4C,CAC7F,EAAuB,EAAE,GAAwC,EAM3D,SAAS,CAAgC,CAAC,EAAqE,CACrH,OAAO,EAAuB,EAAE,KAAwC,CAAO,ECzBzE,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,CCtEO,SAAS,CAAyB,CACxC,EACA,EACA,EACA,EAAqC,CAAC,EAC5B,CACV,IAAM,EAAW,EAAiC,CAAO,EAEzD,GAAI,CAAC,EACJ,MAAO,GAMR,GAHA,EAAO,CAAQ,EACf,EAAK,yBAAyB,CAAO,EAEjC,EAAQ,YACX,EAAK,cAAc,IAAI,8BAAwC,CAAE,OAAQ,CAAS,CAAC,CAAC,EAGrF,MAAO,GAMD,SAAS,CAAsB,CACrC,EACA,EACA,EACA,EAAqC,CAAC,EAC5B,CACV,IAAM,EAAQ,IAAI,EAAoB,EAAS,CAAC,IAAa,CAI5D,GAHA,EAAO,CAAQ,EACf,EAAK,yBAAyB,CAAO,EAEjC,EAAQ,YACX,EAAK,cAAc,IAAI,8BAAwC,CAAE,OAAQ,CAAS,CAAC,CAAC,EAErF,EAGD,OADA,EAAK,cAAc,CAAK,EACjB,EAAM,QAgBP,SAAS,CAA6F,CAC5G,EACA,EACU,CACV,IAAM,EAAW,EAAiC,CAAO,EAEzD,GAAI,CAAC,EACJ,MAAO,GAGR,IAAM,EAAkB,EAAS,WAAW,EAE5C,GAAI,EAAQ,OAEX,OADA,EAAQ,SAAS,EAAQ,OAAO,CAAe,CAAC,EACzC,GAIR,OADA,EAAQ,SAAS,CAAe,EACzB,GAwBD,SAAS,CAA0F,CACzG,EACA,EACA,EACA,EAIU,CACV,IAAM,EAAQ,IAAI,EACjB,EACA,EAAQ,SACR,EAAQ,OACR,EAAQ,UACR,EAAQ,WACT,EAGA,OADA,EAAK,cAAc,CAAK,EACjB,EAAM",
+  "debugId": "A42C1D7F427BF19B64756E2164756E21",
+  "names": []
+}

package/context/context-host.d.ts

@@ -0,0 +1,25 @@
+import type { UnknownContext } from './types';
+type ContextHostApi = {
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    dispatchEvent(event: Event): boolean;
+    registerConnectedCallback(callback: () => void): void;
+    registerCleanupCallback(callback: () => void): void;
+    connectedContextCallback(context: UnknownContext): void;
+    registerContextProvider(name: string, provider: unknown): void;
+};
+type SsrHydrationContainer = {
+    children?: ArrayLike<Element> | undefined;
+    childNodes?: ArrayLike<{
+        nodeType: number;
+    }> | undefined;
+};
+export type ContextHydrationHost = Element | SsrHydrationContainer;
+export type ContextHostLike = (ContextHostApi & Element) | (ContextHostApi & {
+    host: Element;
+}) | (ContextHostApi & {
+    element: Element;
+}) | (ContextHostApi & SsrHydrationContainer);
+export declare function resolveContextHostElement(host: ContextHostLike): Element | null;
+export declare function resolveContextHydrationHost(host: ContextHostLike): ContextHydrationHost;
+export {};

package/context/context-host.js

@@ -0,0 +1,3 @@
+var o=((e)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(e,{get:(t,n)=>(typeof require<"u"?require:t)[n]}):e)(function(e){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+e+'" is not supported')});function r(e){if(e instanceof Element)return e;if("host"in e)return e.host;if("element"in e)return e.element;return null}function l(e){if(e instanceof Element)return e;if("host"in e)return e.host;if("element"in e)return e.element;return e}export{l as resolveContextHydrationHost,r as resolveContextHostElement};
+
+//# debugId=1756919FA3B4A60064756E2164756E21