@ecopages/radiant 0.2.0 → 0.3.0-alpha.0

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

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

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

@@ -0,0 +1,3 @@
+import{q as a}from"../../chunk-ak97hp4w.js";import"../../chunk-d98q3myg.js";import"../../chunk-qaagk55a.js";import"../../chunk-5td6v9k3.js";import"../../chunk-vpfm9yw8.js";import"../../chunk-s4qgct1z.js";import"../../chunk-1w1dm68j.js";import"../../chunk-9gjmqxp2.js";import"../../chunk-8tvt04cm.js";import"../../chunk-nerd6fmg.js";import"../../chunk-4cc2syf5.js";import"../../chunk-8xy18qmz.js";export{a as onContextUpdate};
+
+//# debugId=C4EDA5C49D35311E64756E2164756E21

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

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

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

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

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

@@ -1,4 +1,3 @@
-import{l as w}from"./standard/provide-context.js";import{m as q}from"./legacy/provide-context.js";import"../context-provider.js";import"../events.js";import"../../utils/attribute-utils.js";function D(f){return function(j,b){if(typeof b==="object")return w(f)(j,b);return q(f)(j,b)}}export{D as provideContext};
-export{D as k};
+import{j as a}from"../../chunk-147yvtsn.js";import"../../chunk-d0n7njdy.js";import"../../chunk-4srpf0y5.js";import"../../chunk-jg20mzg8.js";import"../../chunk-1w1dm68j.js";import"../../chunk-6kdxrppw.js";import"../../chunk-8tvt04cm.js";import"../../chunk-nerd6fmg.js";import"../../chunk-ksv01cey.js";import"../../chunk-8n2dhx28.js";import"../../chunk-8xy18qmz.js";export{a as provideContext};
 
-//# debugId=DAFE7A9740BFBCF864756E2164756E21
+//# debugId=8ED9BF853618769A64756E2164756E21

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

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

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

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

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

@@ -1,4 +1,3 @@
-import{p as i}from"../../events.js";function m(t){return(a,e)=>{const o=String(e.name);e.addInitializer(function(){this.dispatchEvent(new i(t,(n)=>{this[o]=n,this.connectedContextCallback(t),this.dispatchEvent(new CustomEvent("context-mounted",{detail:n}))}))})}}export{m as consumeContext};
-export{m as o};
+import{l as a}from"../../../chunk-hkmm3dj9.js";import"../../../chunk-vpfm9yw8.js";import"../../../chunk-s4qgct1z.js";import"../../../chunk-1w1dm68j.js";import"../../../chunk-9gjmqxp2.js";import"../../../chunk-4cc2syf5.js";import"../../../chunk-8xy18qmz.js";export{a as consumeContext};
 
-//# debugId=5EBC8BEA292801F164756E2164756E21
+//# debugId=08F0647FF1FC718B64756E2164756E21

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

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

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

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

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

@@ -0,0 +1,3 @@
+import{m as a}from"../../../chunk-chyn72n9.js";import"../../../chunk-5td6v9k3.js";import"../../../chunk-vpfm9yw8.js";import"../../../chunk-s4qgct1z.js";import"../../../chunk-1w1dm68j.js";import"../../../chunk-9gjmqxp2.js";import"../../../chunk-4cc2syf5.js";import"../../../chunk-8xy18qmz.js";export{a as contextSelectorField};
+
+//# debugId=E814C6039CFD693C64756E2164756E21

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

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

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

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

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

@@ -1,4 +1,3 @@
-import{r as t}from"../../events.js";function p({context:e,select:o,subscribe:n=!0}){return function(i,r){r.addInitializer(function(){queueMicrotask(()=>{this.dispatchEvent(new t(e,i.bind(this),o,n))})})}}export{p as contextSelector};
-export{p as i};
+import{s as a}from"../../../chunk-qaagk55a.js";import"../../../chunk-5td6v9k3.js";import"../../../chunk-vpfm9yw8.js";import"../../../chunk-s4qgct1z.js";import"../../../chunk-1w1dm68j.js";import"../../../chunk-9gjmqxp2.js";import"../../../chunk-4cc2syf5.js";import"../../../chunk-8xy18qmz.js";export{a as contextSelector};
 
-//# debugId=63D2F9333044952264756E2164756E21
+//# debugId=BA0B5A74478EA67E64756E2164756E21

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

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

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

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

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

@@ -1,4 +1,3 @@
-import{n}from"../../context-provider.js";import"../../events.js";import"../../../utils/attribute-utils.js";function m({context:t,initialValue:o,hydrate:i}){return(d,e)=>{const r=String(e.name);e.addInitializer(function(){this[r]=new n(this,{context:t,initialValue:o,hydrate:i}),this.connectedContextCallback(t)})}}export{m as provideContext};
-export{m as l};
+import{n as a}from"../../../chunk-4srpf0y5.js";import"../../../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 provideContext};
 
-//# debugId=C46D919C46727B7364756E2164756E21
+//# debugId=C51D0E8422BFEA3264756E2164756E21

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

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

package/dist/context/events.js

@@ -1,4 +1,3 @@
-var z;((j)=>{j.SUBSCRIPTION_REQUEST="context-subscription-request";j.CONTEXT_REQUEST="context-request";j.ON_MOUNT="context-on-mount";j.MOUNTED="context-mounted"})(z||={});class B extends Event{k;q;w;constructor(k,q,w){super("context-request",{bubbles:!0,composed:!0});this.context=k;this.callback=q;this.subscribe=w}}class D extends CustomEvent{constructor(k){super("context-on-mount",{detail:{context:k},bubbles:!0,composed:!0})}}class F extends Event{k;q;w;G;constructor(k,q,w,G){super("context-subscription-request",{bubbles:!0,composed:!0});this.context=k;this.callback=q;this.select=w;this.subscribe=G}}export{F as ContextSubscriptionRequestEvent,B as ContextRequestEvent,D as ContextOnMountEvent,z as ContextEventsTypes};
-export{B as p,D as q,F as r};
+import{C as a,D as b,E as c,F as d}from"../chunk-1w1dm68j.js";import"../chunk-8xy18qmz.js";export{d as ContextSubscriptionRequestEvent,b as ContextRequestEvent,c as ContextOnMountEvent,a as ContextEventsTypes};
 
-//# debugId=CD57E830D3B70B5964756E2164756E21
+//# debugId=56C1E59567ECA83164756E2164756E21

package/dist/context/events.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/events.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { Context, ContextCallback, ContextType, UnknownContext } from './types';\n\n/**\n * List of events which can be emitted by a context provider or requester.\n */\nexport enum ContextEventsTypes {\n  SUBSCRIPTION_REQUEST = 'context-subscription-request',\n  CONTEXT_REQUEST = 'context-request',\n  ON_MOUNT = 'context-on-mount',\n  MOUNTED = 'context-mounted',\n}\n\n/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can\n * satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `subscribe` value, then a provider can call the callback\n * multiple times if the value is changed, if this is the case the provider should pass an `unsubscribe`\n * function to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n */\nexport class ContextRequestEvent<T extends UnknownContext> extends Event {\n  public constructor(\n    public readonly context: T,\n    public readonly callback: ContextCallback<ContextType<T>>,\n    public readonly subscribe?: boolean,\n  ) {\n    super(ContextEventsTypes.CONTEXT_REQUEST, { bubbles: true, composed: true });\n  }\n}\n\n/**\n * A type which represents a subscription to a context value.\n */\nexport type ContextSubscription<T extends UnknownContext> = {\n  select?: (context: ContextType<T>) => unknown;\n  callback: (value: unknown) => void;\n};\n\n/**\n * An event fired by a context provider to signal that a context value has been mounted and is available for consumption.\n */\nexport class ContextOnMountEvent extends CustomEvent<{ context: UnknownContext }> {\n  public constructor(context: UnknownContext) {\n    super(ContextEventsTypes.ON_MOUNT, {\n      detail: { context },\n      bubbles: true,\n      composed: true,\n    });\n  }\n}\n\n/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can\n * satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `subscribe` value, then a provider can call the callback\n * multiple times if the value is changed, if this is the case the provider should pass an `unsubscribe`\n * function to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n *\n * It accepts a `selector` property which can be used to request a specific property of the context value.\n */\nexport class ContextSubscriptionRequestEvent<T extends UnknownContext> extends Event {\n  public constructor(\n    public readonly context: T,\n    public readonly callback: (value: ContextType<T> | { [K in keyof ContextType<T>]: ContextType<T>[K] }) => void,\n    public readonly select?: (context: ContextType<T>) => unknown,\n    public readonly subscribe?: boolean,\n  ) {\n    super(ContextEventsTypes.SUBSCRIPTION_REQUEST, {\n      bubbles: true,\n      composed: true,\n    });\n  }\n}\n\ndeclare global {\n  interface HTMLElementEventMap {\n    /**\n     * A 'context-request-subscription' event can be emitted by any element which desires\n     * a context value to be injected by an external provider.\n     */\n    [ContextEventsTypes.SUBSCRIPTION_REQUEST]: ContextSubscriptionRequestEvent<UnknownContext>;\n    /**\n     * A context-request-provider event can be emitted by a context requester to signal\n     * that it desires a context value to be provided by a context provider.\n     */\n    [ContextEventsTypes.CONTEXT_REQUEST]: ContextRequestEvent<Context<unknown, unknown>>;\n    /**\n     * A 'context-mount' event can be emitted by a context provider to signal\n     * that a context value has been mounted and is available for consumption.\n     */\n    [ContextEventsTypes.ON_MOUNT]: ContextOnMountEvent;\n  }\n}\n"
   ],
-  "mappings": "AAKO,IAAK,EAAL,EAAK,IAAL,CACL,uBAAuB,+BACvB,kBAAkB,kBAClB,WAAW,mBACX,UAAU,oBAJA,QAiBL,MAAM,UAAsD,KAAM,CAErD,EACA,EACA,EAHX,WAAW,CACA,EACA,EACA,EAChB,CACA,MAAM,kBAAoC,CAAE,QAAS,GAAM,SAAU,EAAK,CAAC,EAJ3D,eACA,gBACA,iBAIpB,CAaO,MAAM,UAA4B,WAAyC,CACzE,WAAW,CAAC,EAAyB,CAC1C,MAAM,mBAA6B,CACjC,OAAQ,CAAE,SAAQ,EAClB,QAAS,GACT,SAAU,EACZ,CAAC,EAEL,CAcO,MAAM,UAAkE,KAAM,CAEjE,EACA,EACA,EACA,EAJX,WAAW,CACA,EACA,EACA,EACA,EAChB,CACA,MAAM,+BAAyC,CAC7C,QAAS,GACT,SAAU,EACZ,CAAC,EARe,eACA,gBACA,cACA,iBAOpB",
-  "debugId": "CD57E830D3B70B5964756E2164756E21",
+  "mappings": "",
+  "debugId": "56C1E59567ECA83164756E2164756E21",
   "names": []
 }

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

@@ -0,0 +1,17 @@
+/** @deprecated Use `HYDRATION_ATTRIBUTE` from `hydration-codec` instead. */
+export declare const CONTEXT_HYDRATION_ATTRIBUTE = "data-hydration";
+/** @deprecated Use `HYDRATION_KEY_ATTRIBUTE` from `hydration-codec` instead. */
+export declare const CONTEXT_HYDRATION_KEY_ATTRIBUTE = "data-hydration-key";
+/**
+ * Creates the raw `<script type="application/json">` tag used to hydrate a
+ * serialized context provider.
+ */
+export declare function createContextHydrationScriptTag(options: {
+    hydrationKey?: string;
+    serializedValue: string;
+}): string;
+/**
+ * Escapes serialized JSON so it remains safe when embedded inside an HTML
+ * script tag.
+ */
+export declare function escapeContextHydrationJson(value: string): string;

package/dist/context/hydration-script.js

@@ -0,0 +1,3 @@
+import{T as a,U as b,V as c,W as d}from"../chunk-6kdxrppw.js";import"../chunk-ksv01cey.js";import"../chunk-8n2dhx28.js";import"../chunk-8xy18qmz.js";export{d as escapeContextHydrationJson,c as createContextHydrationScriptTag,b as CONTEXT_HYDRATION_KEY_ATTRIBUTE,a as CONTEXT_HYDRATION_ATTRIBUTE};
+
+//# debugId=5CA2574D57006D2964756E2164756E21

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

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

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

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

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

@@ -0,0 +1,3 @@
+import{Wa as a,Xa as b,Ya as c}from"../chunk-ms6a9zdt.js";import"../chunk-8xy18qmz.js";export{b as setCustomElementTagName,c as getCustomElementTagName,a as CUSTOM_ELEMENT_TAG_NAME};
+
+//# debugId=1802C65B35438D8C64756E2164756E21

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

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

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

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

package/dist/core/hydration-codec.js

@@ -0,0 +1,3 @@
+import{gb as a,hb as b,ib as c,jb as d,kb as e,lb as f,mb as g}from"../chunk-ksv01cey.js";import"../chunk-8n2dhx28.js";import"../chunk-8xy18qmz.js";export{f as parseHydrationPayload,g as findHydrationScript,e as escapeHydrationJson,d as createHydrationScriptTag,b as HYDRATION_TYPE_ATTRIBUTE,c as HYDRATION_KEY_ATTRIBUTE,a as HYDRATION_ATTRIBUTE};
+
+//# debugId=75E5841D1A59F47064756E2164756E21

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

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

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

@@ -0,0 +1,29 @@
+import type { JsxRenderable } from '@ecopages/jsx';
+import type { RenderToStringOptions } from '@ecopages/jsx/server';
+import type { SsrSerializableContextProvider } from '../context/context-provider';
+import type { ReactiveProperty } from './radiant-element';
+import type { ReactivePropDefinition } from './reactive-prop-metadata';
+import type { SsrSerializableHydrationBinding } from './ssr-hydration-binding';
+type RadiantComponentSsrHost = {
+    constructor: CustomElementConstructor;
+    getAuthoredHydrationScriptMarkup?: () => string | undefined;
+    getContextProviders: () => SsrSerializableContextProvider[];
+    getHydrationBindings: () => SsrSerializableHydrationBinding[];
+    getSlotProjectionScriptTag?: () => string | undefined;
+    renderToString: (options?: RenderToStringOptions) => string;
+    getReactiveProperties: () => ReactiveProperty[];
+    getReactivePropDefinitions: () => ReactivePropDefinition[];
+    getPropertyValue: (name: string) => unknown;
+    listAttributeNames: () => string[];
+    getAttributeValue: (name: string) => string | null;
+};
+export declare class RadiantComponentSsrService {
+    private readonly host;
+    constructor(host: RadiantComponentSsrHost);
+    renderHost(): JsxRenderable;
+    renderHostToString(options?: RenderToStringOptions, attributes?: Record<string, string>): string;
+    private renderHostContent;
+    getHostAttributes(): Record<string, string>;
+    private getTagName;
+}
+export {};

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

@@ -0,0 +1,3 @@
+import{X as a}from"../chunk-9554n9t4.js";import"../chunk-73x7jpdd.js";import"../chunk-ms6a9zdt.js";import"../chunk-dx1wqc00.js";import"../chunk-4cc2syf5.js";import"../chunk-8xy18qmz.js";export{a as RadiantComponentSsrService};
+
+//# debugId=96387B8B5ABCCFB864756E2164756E21

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

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

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

@@ -0,0 +1,106 @@
+import { type JsxRenderable } from '@ecopages/jsx';
+import { type RenderToStringOptions } from '@ecopages/jsx/server';
+import { RadiantElement } from './radiant-element';
+/**
+ * A structured JSX-first Radiant base class.
+ * @typeParam Bindings - Explicit internal bindable shape. Include only the
+ * prop/state keys that JSX bindings should accept.
+ *
+ * Treat this as the component's internal reactive/bindable surface, not as the
+ * default public custom-element attribute contract. When a component exposes a
+ * narrower external API than its internal state, declare a separate public
+ * props type for the JSX intrinsic element and keep internal-only state out of
+ * that contract.
+ *
+ * Reusing the same type for both is fine only when the public props and the
+ * bindable reactive members are intentionally the same surface.
+ *
+ * - `render()` describes the view.
+ * - `update()` commits the current view into the host.
+ * - first render happens automatically on connect.
+ * - plain `@prop`, `@state`, and `@signal` reads performed during `render()`
+ *   participate in tracked rerender invalidation.
+ * - `update()` and `requestUpdate()` remain available when a rerender should be
+ *   scheduled from imperative work outside those tracked reads.
+ */
+export declare class RadiantComponent<Bindings extends object = {}> extends RadiantElement<Bindings> {
+    private isRendering;
+    private isFirstConnectPending;
+    private isRenderScheduled;
+    private needsRender;
+    private projectedSlotContent;
+    private renderSignal?;
+    private readonly renderWatcher;
+    private slotProjectionObserver?;
+    private slotProjectionVersion;
+    private readonly ssr;
+    connectedCallback(): void;
+    /**
+     * Returns the current component view.
+     *
+     * The base implementation behaves like `<slot />`, so authored host children
+     * pass through unchanged when a subclass does not override `render()`.
+     */
+    render(): JsxRenderable;
+    /**
+     * Serializes the current component view into HTML.
+     */
+    renderToString(options?: RenderToStringOptions): string;
+    /**
+     * Returns the component host and current view as a JSX element.
+     */
+    renderHost(): JsxRenderable;
+    /**
+     * Serializes the component host and current view into HTML.
+     */
+    renderHostToString(options?: RenderToStringOptions): string;
+    /**
+     * Hydrates an SSR-rendered component view in place.
+     */
+    hydrate(): void;
+    /**
+     * Queues a component rerender and coalesces repeated requests into the same
+     * microtask.
+     *
+     * Use this when reactive state may change multiple times in the same turn and
+     * the current view should refresh once with the final values.
+     */
+    requestUpdate(): void;
+    /**
+     * Explicitly rerenders the component into its host.
+     */
+    update(): void;
+    disconnectedCallback(): void;
+    /**
+     * Returns the first projected element assigned to the default or named slot.
+     *
+     * Use this when component logic needs direct access to authored light-DOM
+     * content after projection.
+     *
+     * @param name Optional slot name. Omit for the default slot.
+     */
+    getSlotElement<T extends Element = Element>(name?: string): T | null;
+    /**
+     * Returns all projected elements assigned to the default or named slot.
+     *
+     * Text nodes are intentionally excluded so the result matches the element-
+     * oriented query semantics used by Radiant decorators.
+     *
+     * @param name Optional slot name. Omit for the default slot.
+     */
+    getSlotElements<T extends Element = Element>(name?: string): T[];
+    protected shouldAutoBindReactiveMembers(): boolean;
+    protected getHostSsrAttributes(): Record<string, string>;
+    private ensureSlotProjectionState;
+    private getHostChildNodeCount;
+    private getSlotProjectionScriptTag;
+    private getAuthoredHydrationScriptMarkup;
+    private handleSlotProjectionMutations;
+    private addProjectedSlotNode;
+    private removeProjectedSlotNode;
+    private observeSlotProjection;
+    private disconnectSlotProjectionObserver;
+    private disconnectRenderWatcher;
+    private resolveTrackedRenderOutput;
+    private resolveRenderOutput;
+}

package/dist/core/radiant-component.js

@@ -0,0 +1,3 @@
+import{G as a}from"../chunk-17earqbr.js";import"../chunk-84fc8cz9.js";import"../chunk-9ascmjk3.js";import"../chunk-9554n9t4.js";import"../chunk-9gjmqxp2.js";import"../chunk-8dexhy6c.js";import"../chunk-8tvt04cm.js";import"../chunk-73x7jpdd.js";import"../chunk-ms6a9zdt.js";import"../chunk-dx1wqc00.js";import"../chunk-4cc2syf5.js";import"../chunk-ksv01cey.js";import"../chunk-8n2dhx28.js";import"../chunk-8xy18qmz.js";export{a as RadiantComponent};
+
+//# debugId=591CEE5AF32145BA64756E2164756E21

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

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