@ecopages/radiant 0.1.8 → 0.3.0-alpha.0

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

@@ -1,65 +1,3 @@
-// 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 ||= {});
+import{h as a}from"../../chunk-d7hh3ze6.js";import"../../chunk-agjb2a3r.js";import"../../chunk-hkmm3dj9.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 consumeContext};
 
-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/decorators/consume-context.ts
-function consumeContext(contextToProvide) {
-  return (proto, propertyKey) => {
-    const originalConnectedCallback = proto.connectedCallback;
-    proto.connectedCallback = function() {
-      originalConnectedCallback.call(this);
-      this.dispatchEvent(new ContextRequestEvent(contextToProvide, (context) => {
-        this[propertyKey] = context;
-        this.connectedContextCallback(contextToProvide);
-      }));
-    };
-  };
-}
-export {
-  consumeContext
-};
-
-//# debugId=D00E7FCC029AE39264756E2164756E21
+//# debugId=222C6D8A2563DEE764756E2164756E21

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

@@ -1,11 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/events.ts", "../src/context/decorators/consume-context.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}\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 { ContextRequestEvent } from '@/context/events';\nimport type { UnknownContext } from '@/context/types';\nimport type { RadiantElement } from '@/core/radiant-element';\n\n/**\n * A decorator to provide a context to the target element.\n * @param contextToProvide\n * @returns\n */\nexport function consumeContext(contextToProvide: UnknownContext) {\n  return (proto: RadiantElement, propertyKey: string) => {\n    const originalConnectedCallback = proto.connectedCallback;\n\n    proto.connectedCallback = function (this: RadiantElement) {\n      originalConnectedCallback.call(this);\n      this.dispatchEvent(\n        new ContextRequestEvent(contextToProvide, (context) => {\n          (this as any)[propertyKey] = context;\n          this.connectedContextCallback(contextToProvide);\n        }),\n      );\n    };\n  };\n}\n"
   ],
-  "mappings": ";AAKO,IAAK;AAAL,EAAK,wBAAL;AACL,gDAAuB;AACvB,2CAAkB;AAClB,oCAAW;AAAA,GAHD;AAgBL;AAAA,MAAM,4BAAsD,MAAM;AAAA,EAErD;AAAA,EACA;AAAA,EACA;AAAA,EAHX,WAAW,CACA,SACA,UACA,WAChB;AACA,UAAM,yCAAoC,EAAE,SAAS,MAAM,UAAU,KAAK,CAAC;AAJ3D;AACA;AACA;AAAA;AAIpB;AAaO;AAAA,MAAM,4BAA4B,YAAyC;AAAA,EACzE,WAAW,CAAC,SAAyB;AAC1C,UAAM,oCAA6B;AAAA,MACjC,QAAQ,EAAE,QAAQ;AAAA,MAClB,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC;AAAA;AAEL;AAcO;AAAA,MAAM,wCAAkE,MAAM;AAAA,EAEjE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAJX,WAAW,CACA,SACA,UACA,QACA,WAChB;AACA,UAAM,4DAAyC;AAAA,MAC7C,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC;AARe;AACA;AACA;AACA;AAAA;AAOpB;;;ACnEO,SAAS,cAAc,CAAC,kBAAkC;AAC/D,SAAO,CAAC,OAAuB,gBAAwB;AACrD,UAAM,4BAA4B,MAAM;AAExC,UAAM,4BAA6B,GAAuB;AACxD,gCAA0B,KAAK,IAAI;AACnC,WAAK,cACH,IAAI,oBAAoB,kBAAkB,CAAC,YAAY;AACrD,QAAC,KAAa,eAAe;AAC7B,aAAK,yBAAyB,gBAAgB;AAAA,OAC/C,CACH;AAAA;AAAA;AAAA;",
-  "debugId": "D00E7FCC029AE39264756E2164756E21",
+  "mappings": "",
+  "debugId": "222C6D8A2563DEE764756E2164756E21",
   "names": []
 }

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

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

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

@@ -0,0 +1,3 @@
+import{t as a}from"../../chunk-5td6v9k3.js";import"../../chunk-9gjmqxp2.js";import"../../chunk-8xy18qmz.js";export{a as createContextSelectionDelivery};
+
+//# debugId=6E38F249E3AFECD164756E2164756E21

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

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

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

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

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

@@ -1,72 +1,3 @@
-// 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 ||= {});
+import{f as a}from"../../chunk-r1cvaz1t.js";import"../../chunk-par0t822.js";import"../../chunk-chyn72n9.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-4cc2syf5.js";import"../../chunk-8xy18qmz.js";export{a as contextSelector};
 
-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/decorators/context-selector.ts
-function contextSelector({
-  context,
-  select,
-  subscribe = true
-}) {
-  return (proto, _, descriptor) => {
-    const originalMethod = descriptor.value;
-    const originalConnectedCallback = proto.connectedCallback;
-    proto.connectedCallback = function() {
-      originalConnectedCallback.call(this);
-      this.dispatchEvent(new ContextSubscriptionRequestEvent(context, originalMethod.bind(this), select, subscribe));
-    };
-    descriptor.value = function(...args) {
-      const result = originalMethod.apply(this, args);
-      return result;
-    };
-    return descriptor;
-  };
-}
-export {
-  contextSelector
-};
-
-//# debugId=BAE397795EE3704564756E2164756E21
+//# debugId=75B065CEA3D6614864756E2164756E21

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

@@ -1,11 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/context/events.ts", "../src/context/decorators/context-selector.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}\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 { ContextSubscriptionRequestEvent } from '@/context/events';\nimport type { Context, ContextType, UnknownContext } from '@/context/types';\nimport type { RadiantElement } from '@/core/radiant-element';\n\ntype ArgsType<T extends UnknownContext> = SubscribeToContextOptions<T>['select'] extends (...args: any[]) => infer R\n  ? R\n  : ContextType<T>;\n\ntype SubscribeToContextOptions<T extends UnknownContext> = {\n  context: T;\n  select?: (context: T['__context__']) => unknown;\n  subscribe?: boolean;\n};\n/**\n * A decorator to subscribe to a context selector.\n * @param context The context to subscribe to.\n * @param selector The selector to subscribe to. If not provided, the whole context will be subscribed to.\n * @param subscribe @default true Whether to subscribe or unsubscribe. Optional.\n * @returns\n */\nexport function contextSelector<T extends Context<unknown, unknown>>({\n  context,\n  select,\n  subscribe = true,\n}: SubscribeToContextOptions<T>) {\n  return (proto: RadiantElement, _: string, descriptor: PropertyDescriptor) => {\n    const originalMethod = descriptor.value;\n    const originalConnectedCallback = proto.connectedCallback;\n\n    proto.connectedCallback = function (this: RadiantElement) {\n      originalConnectedCallback.call(this);\n      this.dispatchEvent(new ContextSubscriptionRequestEvent(context, originalMethod.bind(this), select, subscribe));\n    };\n\n    descriptor.value = function (...args: ArgsType<T>[]) {\n      const result = originalMethod.apply(this, args);\n      return result;\n    };\n\n    return descriptor;\n  };\n}\n"
   ],
-  "mappings": ";AAKO,IAAK;AAAL,EAAK,wBAAL;AACL,gDAAuB;AACvB,2CAAkB;AAClB,oCAAW;AAAA,GAHD;AAgBL;AAAA,MAAM,4BAAsD,MAAM;AAAA,EAErD;AAAA,EACA;AAAA,EACA;AAAA,EAHX,WAAW,CACA,SACA,UACA,WAChB;AACA,UAAM,yCAAoC,EAAE,SAAS,MAAM,UAAU,KAAK,CAAC;AAJ3D;AACA;AACA;AAAA;AAIpB;AAaO;AAAA,MAAM,4BAA4B,YAAyC;AAAA,EACzE,WAAW,CAAC,SAAyB;AAC1C,UAAM,oCAA6B;AAAA,MACjC,QAAQ,EAAE,QAAQ;AAAA,MAClB,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC;AAAA;AAEL;AAcO;AAAA,MAAM,wCAAkE,MAAM;AAAA,EAEjE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAJX,WAAW,CACA,SACA,UACA,QACA,WAChB;AACA,UAAM,4DAAyC;AAAA,MAC7C,SAAS;AAAA,MACT,UAAU;AAAA,IACZ,CAAC;AARe;AACA;AACA;AACA;AAAA;AAOpB;;;ACxDO,SAAS,eAAoD;AAAA,EAClE;AAAA,EACA;AAAA,EACA,YAAY;AAAA,GACmB;AAC/B,SAAO,CAAC,OAAuB,GAAW,eAAmC;AAC3E,UAAM,iBAAiB,WAAW;AAClC,UAAM,4BAA4B,MAAM;AAExC,UAAM,4BAA6B,GAAuB;AACxD,gCAA0B,KAAK,IAAI;AACnC,WAAK,cAAc,IAAI,gCAAgC,SAAS,eAAe,KAAK,IAAI,GAAG,QAAQ,SAAS,CAAC;AAAA;AAG/G,eAAW,gBAAiB,IAAI,MAAqB;AACnD,YAAM,SAAS,eAAe,MAAM,MAAM,IAAI;AAC9C,aAAO;AAAA;AAGT,WAAO;AAAA;AAAA;",
-  "debugId": "BAE397795EE3704564756E2164756E21",
+  "mappings": "",
+  "debugId": "75B065CEA3D6614864756E2164756E21",
   "names": []
 }

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

@@ -0,0 +1,3 @@
+import type { RadiantElement } from '../../../core/radiant-element';
+import type { UnknownContext } from '../../types';
+export declare function consumeContext(context: UnknownContext): (proto: RadiantElement, propertyKey: string) => void;

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

@@ -0,0 +1,3 @@
+import{i as a}from"../../../chunk-agjb2a3r.js";import"../../../chunk-vpfm9yw8.js";import"../../../chunk-s4qgct1z.js";import"../../../chunk-1w1dm68j.js";import"../../../chunk-9gjmqxp2.js";import"../../../chunk-8tvt04cm.js";import"../../../chunk-4cc2syf5.js";import"../../../chunk-8xy18qmz.js";export{a as consumeContext};
+
+//# debugId=5DC694E5EC760C2B64756E2164756E21

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

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

package/dist/context/decorators/legacy/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>): (target: RadiantElement, propertyName: string) => void;

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

@@ -0,0 +1,3 @@
+import{g as a}from"../../../chunk-par0t822.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-4cc2syf5.js";import"../../../chunk-8xy18qmz.js";export{a as contextSelectorField};
+
+//# debugId=C13E724F5284FFE864756E2164756E21

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

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

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

@@ -0,0 +1,4 @@
+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>): (proto: RadiantElement, _: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

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

@@ -0,0 +1,3 @@
+import{r as a}from"../../../chunk-d98q3myg.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-4cc2syf5.js";import"../../../chunk-8xy18qmz.js";export{a as contextSelector};
+
+//# debugId=A48F14032A04624164756E2164756E21

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

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

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

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

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

@@ -0,0 +1,3 @@
+import{k as a}from"../../../chunk-d0n7njdy.js";import"../../../chunk-jg20mzg8.js";import"../../../chunk-1w1dm68j.js";import"../../../chunk-6kdxrppw.js";import"../../../chunk-8tvt04cm.js";import"../../../chunk-ksv01cey.js";import"../../../chunk-8n2dhx28.js";import"../../../chunk-8xy18qmz.js";export{a as provideContext};
+
+//# debugId=DFA116F2E7CD93F564756E2164756E21

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

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

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

@@ -1,15 +1,26 @@
-import type { UnknownContext } from '../../context/types';
-import type { RadiantElement } from '../../core/radiant-element';
-import type { AttributeTypeConstant } from '../../utils/attribute-utils';
-type CreateContextOptions<T extends UnknownContext> = {
+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.
- * @param contextToProvide
+ * @param options {@link ProvideContextOptions}
  * @returns
  */
-export declare function provideContext<T extends UnknownContext>({ context, initialValue, hydrate }: CreateContextOptions<T>): (proto: RadiantElement, propertyKey: string) => void;
-export {};
+export declare function provideContext<T extends UnknownContext>(options: ProvideContextOptions<T>): (protoOrTarget: StandardOrLegacyFieldDecoratorArgs["protoOrTarget"], nameOrContext: StandardOrLegacyFieldDecoratorArgs["nameOrContext"]) => any;