@ecopages/radiant 0.1.8 → 0.3.0-alpha.0

package/dist/chunk-zb7wh7w4.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/context/create-context.ts"],
+  "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": "F70C083484ED9C0564756E2164756E21",
+  "names": []
+}

package/dist/chunk-zj9ez73m.js

@@ -0,0 +1,4 @@
+import{Xa as f}from"./chunk-ms6a9zdt.js";function v(b,h){return function(k,j){j.addInitializer(function(){if(f(this,b),!window.customElements.get(b))customElements.define(b,this,h)})}}
+export{v as Ha};
+
+//# debugId=9FCE29F579B9006464756E2164756E21

package/dist/chunk-zj9ez73m.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/decorators/standard/custom-element.ts"],
+  "sourcesContent": [
+    "import { setCustomElementTagName } from '../../core/custom-element-metadata';\n\nexport function customElement(name: string, options?: ElementDefinitionOptions) {\n\treturn function <T extends CustomElementConstructor>(_: T, context: ClassDecoratorContext<T>) {\n\t\tcontext.addInitializer(function () {\n\t\t\tsetCustomElementTagName(this, name);\n\n\t\t\tif (!window.customElements.get(name)) {\n\t\t\t\tcustomElements.define(name, this, options);\n\t\t\t}\n\t\t});\n\t};\n}\n"
+  ],
+  "mappings": "yCAEO,SAAS,CAAa,CAAC,EAAc,EAAoC,CAC/E,OAAO,QAA6C,CAAC,EAAM,EAAmC,CAC7F,EAAQ,eAAe,QAAS,EAAG,CAGlC,GAFA,EAAwB,KAAM,CAAI,EAE9B,CAAC,OAAO,eAAe,IAAI,CAAI,EAClC,eAAe,OAAO,EAAM,KAAM,CAAO,EAE1C",
+  "debugId": "9FCE29F579B9006464756E2164756E21",
+  "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{u as a,v as b,w as c,x as d}from"../chunk-vpfm9yw8.js";import"../chunk-s4qgct1z.js";import"../chunk-1w1dm68j.js";import"../chunk-9gjmqxp2.js";import"../chunk-4cc2syf5.js";import"../chunk-8xy18qmz.js";export{d as connectContextSelection,c as connectConsumedContext,b as bootstrapSsrContextSelection,a as bootstrapSsrConsumedContext};
+
+//# debugId=D5DED9AA9551982564756E2164756E21

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

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "D5DED9AA9551982564756E2164756E21",
+  "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{A as c,B as d,y as a,z as b}from"../chunk-s4qgct1z.js";import"../chunk-1w1dm68j.js";import"../chunk-4cc2syf5.js";import"../chunk-8xy18qmz.js";export{d as requestContextSelection,b as requestConsumedContext,c as initializeContextSelection,a as initializeConsumedContext};
+
+//# debugId=73A59D70CC65EE3964756E2164756E21

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

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "73A59D70CC65EE3964756E2164756E21",
+  "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,280 +1,3 @@
-// src/utils/attribute-utils.ts
-function parseAttributeTypeConstant(constant) {
-  switch (constant) {
-    case Array:
-      return "array";
-    case Boolean:
-      return "boolean";
-    case Number:
-      return "number";
-    case Object:
-      return "object";
-    case String:
-      return "string";
-  }
-}
-function parseAttributeTypeDefault(defaultValue) {
-  switch (typeof defaultValue) {
-    case "boolean":
-      return "boolean";
-    case "number":
-      return "number";
-    case "string":
-      return "string";
-  }
-  if (Array.isArray(defaultValue))
-    return "array";
-  if (Object.prototype.toString.call(defaultValue) === "[object Object]")
-    return "object";
-}
-function defaultValueForType(type) {
-  switch (type) {
-    case Number:
-      return 0;
-    case String:
-      return "";
-    case Boolean:
-      return false;
-    default:
-      return null;
-  }
-}
-function parseJSON(value) {
-  try {
-    return JSON.parse(value);
-  } catch (error) {
-    throw new TypeError("Invalid JSON string");
-  }
-}
-function writeJSON(value) {
-  return JSON.stringify(value);
-}
-function writeString(value) {
-  return `${value}`;
-}
-function readAttributeValue(value, type) {
-  const readerType = parseAttributeTypeConstant(type);
-  if (!readerType)
-    throw new TypeError(`[radiant-element] Unknown type "${type}"`);
-  return readers[readerType](value);
-}
-function writeAttributeValue(value, type) {
-  const writerType = parseAttributeTypeConstant(type);
-  if (!writerType)
-    throw new TypeError(`[radiant-element] Unknown type "${type}"`);
-  return (writers[writerType] || writers.default)(value);
-}
-function isBoolean(value) {
-  return typeof value === "boolean";
-}
-function isNumber(value) {
-  return typeof value === "number";
-}
-function isString(value) {
-  return typeof value === "string";
-}
-function isArray(value) {
-  return Array.isArray(value);
-}
-function isObject(value) {
-  return typeof value === "object" && !Array.isArray(value) && value !== null;
-}
-function isValueOfType(type, defaultValue) {
-  switch (type) {
-    case Boolean:
-      return isBoolean(defaultValue);
-    case Number:
-      return isNumber(defaultValue);
-    case String:
-      return isString(defaultValue);
-    case Array:
-      return isArray(defaultValue);
-    case Object:
-      return isObject(defaultValue);
-    default:
-      return false;
-  }
-}
-var readers = {
-  array(value) {
-    const array = parseJSON(value);
-    if (!Array.isArray(array)) {
-      throw new TypeError(`Expected an array but got a value of type "${typeof array}"`);
-    }
-    return array;
-  },
-  boolean(value) {
-    return !(value === "0" || String(value).toLowerCase() === "false");
-  },
-  number(value) {
-    const number = Number(value.replace(/_/g, ""));
-    return number;
-  },
-  object(value) {
-    const object = JSON.parse(value);
-    if (object === null || typeof object !== "object" || Array.isArray(object)) {
-      throw new TypeError(`expected value of type "object" but instead got value "${value}" of type "${parseAttributeTypeDefault(object)}"`);
-    }
-    return object;
-  },
-  string(value) {
-    return value;
-  }
-};
-var writers = {
-  default: writeString,
-  array: writeJSON,
-  object: writeJSON
-};
+import{o as a}from"../chunk-jg20mzg8.js";import"../chunk-1w1dm68j.js";import"../chunk-6kdxrppw.js";import"../chunk-ksv01cey.js";import"../chunk-8n2dhx28.js";import"../chunk-8xy18qmz.js";export{a as ContextProvider};
 
-// src/context/events.ts
-var ContextEventsTypes;
-((ContextEventsTypes2) => {
-  ContextEventsTypes2["SUBSCRIPTION_REQUEST"] = "context--subscription-request";
-  ContextEventsTypes2["CONTEXT_REQUEST"] = "context-request";
-  ContextEventsTypes2["ON_MOUNT"] = "context--on-mount";
-})(ContextEventsTypes ||= {});
-
-class ContextRequestEvent extends Event {
-  context;
-  callback;
-  subscribe;
-  constructor(context, callback, subscribe) {
-    super("context-request" /* CONTEXT_REQUEST */, { bubbles: true, composed: true });
-    this.context = context;
-    this.callback = callback;
-    this.subscribe = subscribe;
-  }
-}
-
-class ContextOnMountEvent extends CustomEvent {
-  constructor(context) {
-    super("context--on-mount" /* ON_MOUNT */, {
-      detail: { context },
-      bubbles: true,
-      composed: true
-    });
-  }
-}
-
-class ContextSubscriptionRequestEvent extends Event {
-  context;
-  callback;
-  select;
-  subscribe;
-  constructor(context, callback, select, subscribe) {
-    super("context--subscription-request" /* SUBSCRIPTION_REQUEST */, {
-      bubbles: true,
-      composed: true
-    });
-    this.context = context;
-    this.callback = callback;
-    this.select = select;
-    this.subscribe = subscribe;
-  }
-}
-
-// src/context/context-provider.ts
-class ContextProvider {
-  host;
-  context;
-  value;
-  subscriptions = [];
-  constructor(host, options) {
-    this.host = host;
-    this.context = options.context;
-    let contextValue = options.initialValue;
-    if (options.hydrate) {
-      const hydrationScriptElement = this.host.querySelector("script[data-hydration]");
-      if (hydrationScriptElement?.textContent) {
-        const hydrationValue = hydrationScriptElement.textContent;
-        const parsedHydrationValue = readAttributeValue(hydrationValue, options.hydrate);
-        if (options.hydrate === Object && this.isObject(parsedHydrationValue) && (this.isObject(contextValue) || typeof contextValue === "undefined")) {
-          contextValue = {
-            ...contextValue ?? {},
-            ...parsedHydrationValue
-          };
-        } else {
-          contextValue = parsedHydrationValue;
-        }
-      }
-    }
-    this.value = contextValue;
-    this.registerEvents();
-    this.host.dispatchEvent(new ContextOnMountEvent(this.context));
-  }
-  setContext = (update, callback) => {
-    if (typeof this.value === "object") {
-      const oldContext = { ...this.value };
-      this.value = { ...this.value, ...update };
-      if (callback)
-        callback(this.value);
-      this.notifySubscribers(this.value, oldContext);
-    }
-  };
-  getContext = () => {
-    return this.value;
-  };
-  subscribe = ({ select, callback }) => {
-    this.subscriptions.push({ select, callback });
-  };
-  isObject(value) {
-    return typeof value === "object" && !Array.isArray(value) && value !== null;
-  }
-  notifySubscribers = (newContext, prevContext) => {
-    for (const sub of this.subscriptions) {
-      if (!sub.select)
-        return this.sendSubscriptionUpdate(sub, newContext);
-      const newSelected = sub.select(newContext);
-      const prevSelected = sub.select(prevContext);
-      if (newSelected !== prevSelected) {
-        this.sendSubscriptionUpdate(sub, newContext);
-      }
-    }
-  };
-  sendSubscriptionUpdate = ({ select, callback }, context) => {
-    if (!select)
-      callback(context);
-    else
-      callback(select(context));
-  };
-  handleSubscriptionRequest = ({
-    select,
-    callback,
-    subscribe
-  }) => {
-    if (subscribe)
-      this.subscribe({ select, callback });
-    if (!this.value)
-      return;
-    if (select) {
-      callback(select(this.value));
-    } else {
-      callback(this.value);
-    }
-  };
-  onSubscriptionRequest = (event) => {
-    const { context, callback, subscribe, select, target } = event;
-    if (context !== this.context)
-      return;
-    event.stopPropagation();
-    target.dispatchEvent(new ContextOnMountEvent(this.context));
-    this.handleSubscriptionRequest({ select, callback, subscribe });
-  };
-  onContextRequest = (event) => {
-    const { context, callback } = event;
-    if (context !== this.context)
-      return;
-    event.stopPropagation();
-    callback(this);
-  };
-  registerEvents = () => {
-    this.host.addEventListener("context--subscription-request" /* SUBSCRIPTION_REQUEST */, this.onSubscriptionRequest);
-    this.host.addEventListener("context-request" /* CONTEXT_REQUEST */, this.onContextRequest);
-  };
-}
-export {
-  ContextProvider
-};
-
-//# debugId=19BF7CBFBD9F2B6364756E2164756E21
+//# debugId=4B4F943E8C68AC9964756E2164756E21

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

@@ -1,12 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/utils/attribute-utils.ts", "../src/context/events.ts", "../src/context/context-provider.ts"],
+  "sources": [],
   "sourcesContent": [
-    "export type AttributeTypeConstant = typeof Array | typeof Boolean | typeof Number | typeof Object | typeof String;\n\nexport type AttributeTypeDefault = Array<unknown> | boolean | number | Record<string, unknown> | string;\n\n/**\n * Parses the given attribute type constant and returns its corresponding string representation.\n *\n * @param constant - The attribute type constant to parse.\n * @returns The string representation of the attribute type constant.\n */\nexport function parseAttributeTypeConstant(constant?: AttributeTypeConstant) {\n  switch (constant) {\n    case Array:\n      return 'array';\n    case Boolean:\n      return 'boolean';\n    case Number:\n      return 'number';\n    case Object:\n      return 'object';\n    case String:\n      return 'string';\n  }\n}\n\n/**\n * Parses the attribute type default value and returns its type as a string.\n *\n * @param defaultValue - The default value of the attribute type.\n * @returns The type of the default value as a string.\n */\nexport function parseAttributeTypeDefault(defaultValue?: AttributeTypeDefault) {\n  switch (typeof defaultValue) {\n    case 'boolean':\n      return 'boolean';\n    case 'number':\n      return 'number';\n    case 'string':\n      return 'string';\n  }\n\n  if (Array.isArray(defaultValue)) return 'array';\n  if (Object.prototype.toString.call(defaultValue) === '[object Object]') return 'object';\n}\n\n/**\n * Returns the default value for a given attribute type.\n *\n * @param type - The attribute type constant.\n * @returns The default value for the specified attribute type.\n */\nexport function defaultValueForType(type: AttributeTypeConstant): unknown {\n  switch (type) {\n    case Number:\n      return 0;\n    case String:\n      return '';\n    case Boolean:\n      return false;\n    default:\n      return null;\n  }\n}\n\ntype Reader = (value: string) => number | string | boolean | object | unknown[];\n\n/**\n * Utility function to parse a JSON string safely\n */\nfunction parseJSON<T>(value: string): T {\n  try {\n    return JSON.parse(value);\n  } catch (error) {\n    throw new TypeError('Invalid JSON string');\n  }\n}\n\n/**\n * Object that maps attribute types to reader functions.\n * @type {Object.<string, Reader>}\n */\nconst readers: { [type: string]: Reader } = {\n  array(value: string): unknown[] {\n    const array = parseJSON<unknown[]>(value);\n    if (!Array.isArray(array)) {\n      throw new TypeError(`Expected an array but got a value of type \"${typeof array}\"`);\n    }\n    return array;\n  },\n\n  boolean(value: string): boolean {\n    return !(value === '0' || String(value).toLowerCase() === 'false');\n  },\n\n  number(value: string): number {\n    const number = Number(value.replace(/_/g, ''));\n    return number;\n  },\n\n  object(value: string): object {\n    const object = JSON.parse(value);\n    if (object === null || typeof object !== 'object' || Array.isArray(object)) {\n      throw new TypeError(\n        `expected value of type \"object\" but instead got value \"${value}\" of type \"${parseAttributeTypeDefault(\n          object,\n        )}\"`,\n      );\n    }\n    return object;\n  },\n\n  string(value: string): string {\n    return value;\n  },\n};\n\ntype Writer = (value: unknown) => string;\n\n/**\n * Object that maps attribute types to writer functions.\n * @type {Object.<string, Writer>}\n */\nconst writers: { [type: string]: Writer } = {\n  default: writeString,\n  array: writeJSON,\n  object: writeJSON,\n};\n\nfunction writeJSON(value: unknown) {\n  return JSON.stringify(value);\n}\n\nfunction writeString(value: unknown) {\n  return `${value}`;\n}\n\n/**\n * Reads the attribute value based on the provided type.\n * @param value - The attribute value to be read.\n * @param type - The type of the attribute.\n * @returns The parsed attribute value.\n * @throws {TypeError} If the provided type is unknown.\n */\nexport function readAttributeValue(value: string, type: AttributeTypeConstant) {\n  const readerType = parseAttributeTypeConstant(type);\n  if (!readerType) throw new TypeError(`[radiant-element] Unknown type \"${type}\"`);\n  return readers[readerType](value);\n}\n\nexport type ReadAttributeValueReturnType = ReturnType<typeof readAttributeValue>;\n\n/**\n * Writes the attribute value based on the provided type.\n *\n * @param value - The value to be written.\n * @param type - The type of the attribute.\n * @returns The written attribute value.\n * @throws {TypeError} If the provided type is unknown.\n */\nexport function writeAttributeValue(value: unknown, type: AttributeTypeConstant) {\n  const writerType = parseAttributeTypeConstant(type);\n  if (!writerType) throw new TypeError(`[radiant-element] Unknown type \"${type}\"`);\n  return (writers[writerType] || writers.default)(value);\n}\n\nexport type WriteAttributeValueReturnType = ReturnType<typeof writeAttributeValue>;\n\n/*\n * Type guard functions for each type in AttributeTypeConstant\n */\nfunction isBoolean(value: unknown): value is boolean {\n  return typeof value === 'boolean';\n}\n\nfunction isNumber(value: unknown): value is number {\n  return typeof value === 'number';\n}\n\nfunction isString(value: unknown): value is string {\n  return typeof value === 'string';\n}\n\nfunction isArray(value: unknown): value is Array<unknown> {\n  return Array.isArray(value);\n}\n\nfunction isObject(value: unknown): value is object {\n  return typeof value === 'object' && !Array.isArray(value) && value !== null;\n}\n\n/*\n * Check function to ensure defaultValue matches the type\n */\nexport function isValueOfType(type: AttributeTypeConstant, defaultValue: unknown): boolean {\n  switch (type) {\n    case Boolean:\n      return isBoolean(defaultValue);\n    case Number:\n      return isNumber(defaultValue);\n    case String:\n      return isString(defaultValue);\n    case Array:\n      return isArray(defaultValue);\n    case Object:\n      return isObject(defaultValue);\n    default:\n      return false;\n  }\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  SUBSCRIPTION_REQUEST = 'context--subscription-request',\n  CONTEXT_REQUEST = 'context-request',\n  ON_MOUNT = 'context--on-mount',\n}\n\n/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can\n * satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `subscribe` value, then a provider can call the callback\n * multiple times if the value is changed, if this is the case the provider should pass an `unsubscribe`\n * function to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n */\nexport class ContextRequestEvent<T extends UnknownContext> extends Event {\n  public constructor(\n    public readonly context: T,\n    public readonly callback: ContextCallback<ContextType<T>>,\n    public readonly subscribe?: boolean,\n  ) {\n    super(ContextEventsTypes.CONTEXT_REQUEST, { bubbles: true, composed: true });\n  }\n}\n\n/**\n * A type which represents a subscription to a context value.\n */\nexport type ContextSubscription<T extends UnknownContext> = {\n  select?: (context: ContextType<T>) => unknown;\n  callback: (value: unknown) => void;\n};\n\n/**\n * An event fired by a context provider to signal that a context value has been mounted and is available for consumption.\n */\nexport class ContextOnMountEvent extends CustomEvent<{ context: UnknownContext }> {\n  public constructor(context: UnknownContext) {\n    super(ContextEventsTypes.ON_MOUNT, {\n      detail: { context },\n      bubbles: true,\n      composed: true,\n    });\n  }\n}\n\n/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can\n * satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `subscribe` value, then a provider can call the callback\n * multiple times if the value is changed, if this is the case the provider should pass an `unsubscribe`\n * function to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n *\n * It accepts a `selector` property which can be used to request a specific property of the context value.\n */\nexport class ContextSubscriptionRequestEvent<T extends UnknownContext> extends Event {\n  public constructor(\n    public readonly context: T,\n    public readonly callback: (value: ContextType<T> | { [K in keyof ContextType<T>]: ContextType<T>[K] }) => void,\n    public readonly select?: (context: ContextType<T>) => unknown,\n    public readonly subscribe?: boolean,\n  ) {\n    super(ContextEventsTypes.SUBSCRIPTION_REQUEST, {\n      bubbles: true,\n      composed: true,\n    });\n  }\n}\n\ndeclare global {\n  interface HTMLElementEventMap {\n    /**\n     * A 'context-request-subscription' event can be emitted by any element which desires\n     * a context value to be injected by an external provider.\n     */\n    [ContextEventsTypes.SUBSCRIPTION_REQUEST]: ContextSubscriptionRequestEvent<UnknownContext>;\n    /**\n     * A context-request-provider event can be emitted by a context requester to signal\n     * that it desires a context value to be provided by a context provider.\n     */\n    [ContextEventsTypes.CONTEXT_REQUEST]: ContextRequestEvent<Context<unknown, unknown>>;\n    /**\n     * A 'context-mount' event can be emitted by a context provider to signal\n     * that a context value has been mounted and is available for consumption.\n     */\n    [ContextEventsTypes.ON_MOUNT]: ContextOnMountEvent;\n  }\n}\n",
-    "import type { RadiantElement } from '@/core/radiant-element';\nimport { type AttributeTypeConstant, readAttributeValue } from '@/utils/attribute-utils';\nimport { query } from '..';\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": "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",
-  "debugId": "19BF7CBFBD9F2B6364756E2164756E21",
+  "mappings": "",
+  "debugId": "4B4F943E8C68AC9964756E2164756E21",
   "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{ab as a,bb as b}from"../chunk-4cc2syf5.js";import"../chunk-8xy18qmz.js";export{b as resolveAmbientSsrContextProvider,a as installSsrContextProviderResolver};
+
+//# debugId=8BEFCC2C4D3285E064756E2164756E21

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

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

package/dist/context/create-context.js

@@ -1,7 +1,3 @@
-// src/context/create-context.ts
-var createContext = (key) => key;
-export {
-  createContext
-};
+import{p as a}from"../chunk-zb7wh7w4.js";import"../chunk-8xy18qmz.js";export{a as createContext};
 
-//# debugId=4C205EEF470D369264756E2164756E21
+//# debugId=87DC73B8114B789864756E2164756E21

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,gBAAgB,CAAY,QAAiB;",
-  "debugId": "4C205EEF470D369264756E2164756E21",
+  "mappings": "",
+  "debugId": "87DC73B8114B789864756E2164756E21",
   "names": []
 }

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

@@ -1,8 +1,12 @@
-import type { UnknownContext } from '../../context/types';
-import type { RadiantElement } from '../../core/radiant-element';
+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): (proto: RadiantElement, propertyKey: string) => void;
+export declare function consumeContext(context: UnknownContext): (protoOrTarget: StandardOrLegacyFieldDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyFieldDecoratorArgs["nameOrContext"]) => any;