@ecopages/radiant 0.2.0 → 0.3.0-alpha.0

package/dist/helpers/debounce.d.ts

@@ -0,0 +1,39 @@
+import type { Method } from '../types';
+/**
+ * A debounced function with imperative helpers for controlling pending work.
+ *
+ * @typeParam T The wrapped callback type.
+ */
+export interface DebouncedFunction<T extends Method> {
+    (...args: Parameters<T>): void;
+    /**
+     * Cancels the pending callback invocation, if one exists.
+     */
+    cancel(): void;
+    /**
+     * Immediately invokes the latest pending callback invocation.
+     *
+     * @returns The callback result when a call is pending, or the last completed
+     * result when no call is pending.
+     */
+    flush(): ReturnType<T> | undefined;
+    /**
+     * Reports whether the callback currently has a scheduled invocation.
+     *
+     * @returns True when a call is pending.
+     */
+    pending(): boolean;
+}
+/**
+ * Creates a debounced wrapper around a function.
+ *
+ * The returned function delays invocation until the configured timeout has
+ * elapsed since the latest call. It also exposes helpers to cancel, flush,
+ * and inspect pending work.
+ *
+ * @typeParam T The wrapped callback type.
+ * @param callback The callback to debounce.
+ * @param timeout The debounce timeout in milliseconds.
+ * @returns A debounced wrapper around the callback.
+ */
+export declare function debounce<T extends Method>(callback: T, timeout: number): DebouncedFunction<T>;

package/dist/helpers/debounce.js

@@ -0,0 +1,3 @@
+import{qb as a}from"../chunk-13ydx769.js";import"../chunk-8xy18qmz.js";export{a as debounce};
+
+//# debugId=F389D09E6FA1B23464756E2164756E21

package/dist/helpers/debounce.js.map

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

package/dist/helpers/index.d.ts

@@ -0,0 +1,5 @@
+export * from './create-query';
+export * from './create-query-slot';
+export * from './create-event';
+export * from './create-event-listener';
+export * from './debounce';

package/dist/helpers/index.js

@@ -0,0 +1,3 @@
+import{ob as x}from"../chunk-42tyhfvh.js";import"../chunk-qbnedp0y.js";import{qb as t}from"../chunk-13ydx769.js";import{rb as c}from"../chunk-qd28hvdx.js";import{sb as b}from"../chunk-g0gz7ypq.js";import{tb as a}from"../chunk-nw171z6m.js";import"../chunk-8xy18qmz.js";export{t as debounce,c as createQuerySlot,b as createQuery,a as createEventListener,x as createEvent};
+
+//# debugId=1A8607ADDD869B3264756E2164756E21

package/dist/{mixins → helpers}/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "E2A408E081E6A67164756E2164756E21",
+  "debugId": "1A8607ADDD869B3264756E2164756E21",
   "names": []
 }

package/dist/index.d.ts

@@ -1,16 +1,24 @@
 export * from './core/radiant-element';
+export * from './core/radiant-component';
+export * from './core/reactive-jsx-value';
+export * from './decorators/bound';
 export * from './decorators/custom-element';
+export * from './decorators/debounce';
 export * from './decorators/event';
 export * from './decorators/on-event';
 export * from './decorators/on-updated';
+export * from './decorators/prop';
 export * from './decorators/query';
-export * from './decorators/reactive-prop';
-export * from './decorators/reactive-field';
+export * from './decorators/query-slot';
+export * from './decorators/signal';
+export * from './decorators/state';
 export * from './context/context-provider';
 export * from './context/create-context';
 export * from './context/decorators/consume-context';
 export * from './context/decorators/context-selector';
+export * from './context/decorators/on-context-update';
 export * from './context/decorators/provide-context';
-export * from './mixins/with-kita';
-export * from './tools';
-export * from './utils';
+export * from './helpers/create-query';
+export * from './helpers/create-query-slot';
+export * from './helpers/create-event';
+export * from './helpers/create-event-listener';

package/dist/index.js

@@ -1,3 +1,3 @@
-import"./tools/index.js";import{c as u}from"./tools/stringify-typed.js";import{d as p}from"./mixins/with-kita.js";import{e as $}from"./context/create-context.js";import{f as h}from"./context/decorators/consume-context.js";import"./context/decorators/legacy/consume-context.js";import{h as k}from"./context/decorators/context-selector.js";import"./context/decorators/standard/context-selector.js";import"./context/decorators/legacy/context-selector.js";import{k as m}from"./context/decorators/provide-context.js";import"./context/decorators/standard/provide-context.js";import"./context/decorators/legacy/provide-context.js";import{n as _}from"./context/context-provider.js";import"./context/decorators/standard/consume-context.js";import"./context/events.js";import"./utils/index.js";import{s as R}from"./core/radiant-element.js";import{t as X}from"./decorators/query.js";import"./decorators/legacy/query.js";import"./decorators/standard/query.js";import{w as S}from"./decorators/custom-element.js";import"./decorators/legacy/custom-element.js";import"./decorators/standard/custom-element.js";import{z as Z}from"./decorators/reactive-field.js";import"./decorators/legacy/reactive-field.js";import"./decorators/standard/reactive-field.js";import{E as Y}from"./decorators/reactive-prop.js";import"./decorators/legacy/reactive-prop.js";import{G as K,H as L,I as M,J as N,K as O,L as P,M as Q}from"./utils/attribute-utils.js";import"./decorators/standard/reactive-prop.js";import{O as V}from"./decorators/on-event.js";import"./decorators/legacy/on-event.js";import"./decorators/standard/on-event.js";import{R as U}from"./decorators/event.js";import"./decorators/legacy/event.js";import"./decorators/standard/event.js";import{U as T}from"./tools/event-emitter.js";import{V as W}from"./decorators/on-updated.js";import"./decorators/legacy/on-updated.js";import"./decorators/standard/on-updated.js";export{O as writeAttributeValue,u as stringifyTyped,N as readAttributeValue,Y as reactiveProp,Z as reactiveField,X as query,m as provideContext,L as parseAttributeTypeDefault,K as parseAttributeTypeConstant,W as onUpdated,V as onEvent,P as isValueOfType,Q as getInitialValue,U as event,M as defaultValueForType,S as customElement,$ as createContext,k as contextSelector,h as consumeContext,p as WithKita,R as RadiantElement,T as EventEmitter,_ as ContextProvider};
+import{f as p}from"./chunk-r1cvaz1t.js";import"./chunk-par0t822.js";import{h as n}from"./chunk-d7hh3ze6.js";import"./chunk-agjb2a3r.js";import{j as o}from"./chunk-147yvtsn.js";import"./chunk-d0n7njdy.js";import"./chunk-hkmm3dj9.js";import"./chunk-chyn72n9.js";import"./chunk-4srpf0y5.js";import{o as h}from"./chunk-jg20mzg8.js";import{p as a}from"./chunk-zb7wh7w4.js";import{q as l}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{G as S}from"./chunk-17earqbr.js";import{H as R}from"./chunk-84fc8cz9.js";import"./chunk-9ascmjk3.js";import{S as T}from"./chunk-mpjnqmbq.js";import"./chunk-6kdxrppw.js";import"./chunk-9554n9t4.js";import{Y as x}from"./chunk-0y78f8hj.js";import"./chunk-5bym7y1d.js";import"./chunk-9gjmqxp2.js";import"./chunk-bmhn4nbp.js";import{ca as d}from"./chunk-p6pxdvkk.js";import"./chunk-x0522ksh.js";import"./chunk-dscj0sk9.js";import"./chunk-8dexhy6c.js";import{ha as q}from"./chunk-2tgrfv09.js";import"./chunk-qe6sjr27.js";import"./chunk-scfk041e.js";import{ka as y}from"./chunk-c8vqg7r1.js";import"./chunk-t6x9e177.js";import"./chunk-5a2xez36.js";import{na as Y}from"./chunk-r75y7ydb.js";import"./chunk-a7hzs37s.js";import"./chunk-k5hr781q.js";import"./chunk-57w3vmme.js";import{ta as v}from"./chunk-4fqkmpra.js";import"./chunk-t7a1bbxq.js";import"./chunk-paehjz94.js";import{wa as U}from"./chunk-w50v38rv.js";import"./chunk-cbvd18v1.js";import"./chunk-xd1xn3vy.js";import{za as W}from"./chunk-mqxmfvyp.js";import"./chunk-hn4j8rt5.js";import"./chunk-8vak8w5w.js";import{Ca as $}from"./chunk-0zq7e1ne.js";import"./chunk-tyysm4gk.js";import"./chunk-qdj6r8jn.js";import{Fa as V}from"./chunk-60015zxq.js";import"./chunk-60q4y3k5.js";import"./chunk-zj9ez73m.js";import{Ia as _}from"./chunk-d4v5qpxa.js";import"./chunk-3b033cgq.js";import"./chunk-aajhkdmn.js";import"./chunk-8tvt04cm.js";import"./chunk-nerd6fmg.js";import"./chunk-73x7jpdd.js";import"./chunk-ms6a9zdt.js";import"./chunk-dx1wqc00.js";import"./chunk-4cc2syf5.js";import"./chunk-6z34stya.js";import"./chunk-ksv01cey.js";import"./chunk-8n2dhx28.js";import{ob as X}from"./chunk-42tyhfvh.js";import"./chunk-qbnedp0y.js";import"./chunk-13ydx769.js";import{rb as u}from"./chunk-qd28hvdx.js";import{sb as i}from"./chunk-g0gz7ypq.js";import{tb as Z}from"./chunk-nw171z6m.js";import"./chunk-8xy18qmz.js";export{v as state,y as signal,x as querySlot,q as query,o as provideContext,d as prop,$ as onUpdated,_ as onEvent,l as onContextUpdate,Y as event,W as debounce,V as customElement,u as createQuerySlot,i as createQuery,Z as createEventListener,X as createEvent,a as createContext,p as contextSelector,n as consumeContext,U as bound,T as bindReactiveValue,R as RadiantElement,S as RadiantComponent,h as ContextProvider};
 
-//# debugId=7864EB68120F7AAF64756E2164756E21
+//# debugId=B6A1B7EED2B4CACB64756E2164756E21

package/dist/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "7864EB68120F7AAF64756E2164756E21",
+  "debugId": "B6A1B7EED2B4CACB64756E2164756E21",
   "names": []
 }

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

@@ -0,0 +1,27 @@
+import type { SsrSerializableContextProvider } from '../context/context-provider';
+import type { ContextType, UnknownContext } from '../context/types';
+/**
+ * Pushes a temporary provider frame onto the SSR context stack.
+ *
+ * On the server, each call creates an isolated `AsyncLocalStorage` context so
+ * concurrent renders cannot corrupt each other.
+ *
+ * In browser test environments where `AsyncLocalStorage` is unavailable, a
+ * synchronous global stack is used as a fallback.
+ */
+export declare function withSsrContextProviders(providers: readonly SsrSerializableContextProvider[]): () => void;
+/**
+ * Resolves the nearest SSR-visible provider for a given context token.
+ *
+ * Lookup walks the provider frames from innermost to outermost so nested host
+ * serialization behaves the same way as runtime context resolution in the DOM.
+ */
+export declare function resolveSsrContextProvider<T extends UnknownContext>(context: T): SsrSerializableContextProvider | undefined;
+/**
+ * Resolves the current SSR-visible value for a given context token.
+ *
+ * This is the ergonomic helper consumed by SSR-aware decorators and component
+ * render paths when they only need the context payload instead of the full
+ * provider instance.
+ */
+export declare function resolveSsrContextValue<T extends UnknownContext>(context: T): ContextType<T> | undefined;

package/dist/server/context-ssr.js

@@ -0,0 +1,3 @@
+import{$a as c,Za as a,_a as b}from"../chunk-dx1wqc00.js";import"../chunk-4cc2syf5.js";import"../chunk-8xy18qmz.js";export{a as withSsrContextProviders,c as resolveSsrContextValue,b as resolveSsrContextProvider};
+
+//# debugId=184F6DD07BB92CDB64756E2164756E21

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

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

package/dist/server/install-light-dom-shim.d.ts

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

package/dist/server/install-light-dom-shim.js

@@ -0,0 +1,3 @@
+import{e as i}from"../chunk-jce9gqqw.js";import"../chunk-8xy18qmz.js";i();
+
+//# debugId=C4400E1D9340C2EC64756E2164756E21

package/dist/server/install-light-dom-shim.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/server/install-light-dom-shim.ts"],
+  "sourcesContent": [
+    "import { installLightDomShim } from './light-dom-shim';\n\ninstallLightDomShim();\n"
+  ],
+  "mappings": "2EAEA,HAAoB",
+  "debugId": "C4400E1D9340C2EC64756E2164756E21",
+  "names": []
+}

package/dist/server/light-dom-shim.d.ts

@@ -0,0 +1,53 @@
+type MinimalCustomElementRegistry = {
+    define(name: string, constructor: CustomElementConstructor, options?: ElementDefinitionOptions): void;
+    get(name: string): CustomElementConstructor | undefined;
+};
+/**
+ * Minimal window-like runtime surface exposed by the SSR light-DOM shim.
+ *
+ * This is intentionally much smaller than a browser `window`; it only includes
+ * the constructors and registry access that Radiant SSR currently needs.
+ */
+export type LightDomShimWindow = {
+    /** Event constructor exposed to SSR-created components. */
+    CustomEvent: typeof CustomEvent;
+    /** Element constructor exposed to SSR-created components. */
+    Element: typeof Element;
+    /** Event constructor exposed to SSR-created components. */
+    Event: typeof Event;
+    /** EventTarget constructor exposed to SSR-created components. */
+    EventTarget: typeof EventTarget;
+    /** HTMLScriptElement constructor used by slot projection payload parsing. */
+    HTMLScriptElement: typeof HTMLScriptElement;
+    /** HTMLElement constructor exposed to SSR-created components. */
+    HTMLElement: typeof HTMLElement;
+    /** Node constructor exposed to SSR-created components. */
+    Node: typeof Node;
+    /** Custom element registry used while rendering in SSR. */
+    customElements: MinimalCustomElementRegistry;
+};
+/** Host preparation options accepted by the server render environment. */
+export type PrepareServerRenderHostOptions = {
+    /** Serialized light-DOM content to attach to the host before SSR. */
+    authoredContent?: string;
+};
+/** Reusable SSR environment used to prepare component hosts before rendering. */
+export type ServerRenderEnvironment = {
+    /** Prepares the host instance for rendering, including authored light-DOM content. */
+    prepareHost(host: HTMLElement, options?: PrepareServerRenderHostOptions): void;
+};
+/** Ensures that a minimal window-like SSR runtime is available and returns it. */
+export declare function ensureLightDomShim(): LightDomShimWindow;
+/**
+ * Creates a reusable SSR environment that can prepare a component host with
+ * authored light-DOM content before rendering.
+ *
+ * Adapters can reuse a single environment across multiple render calls when
+ * they want a single host-preparation entrypoint backed by the installed shim.
+ */
+export declare function createServerRenderEnvironment(): ServerRenderEnvironment;
+/**
+ * Installs the smallest global surface needed to instantiate Radiant custom elements during SSR.
+ */
+export declare function installLightDomShim(): LightDomShimWindow;
+export {};

package/dist/server/light-dom-shim.js

@@ -0,0 +1,3 @@
+import{c as a,d as b,e as c}from"../chunk-jce9gqqw.js";import"../chunk-8xy18qmz.js";export{c as installLightDomShim,a as ensureLightDomShim,b as createServerRenderEnvironment};
+
+//# debugId=CCDE1A164E531EEB64756E2164756E21

package/dist/server/light-dom-shim.js.map

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

package/dist/server/project-root.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Options that constrain how {@link resolveProjectRoot} searches ancestor
+ * directories.
+ */
+export type ResolveProjectRootOptions = {
+    /** Expected `package.json#name` value for the resolved project root. */
+    packageName?: string;
+    /** Additional relative paths that must exist inside the resolved directory. */
+    requiredPaths?: string[];
+    /** Starting directories to search upward from before giving up. */
+    startDirectories?: string[];
+    /** Absolute or relative directory where the upward search must stop. */
+    stopAt?: string;
+};
+/**
+ * Resolves the nearest ancestor directory that matches the provided package and
+ * path markers. Framework adapters can use this to find their project root
+ * without hardcoding a fixed number of parent-directory guesses.
+ */
+export declare function resolveProjectRoot(options?: ResolveProjectRootOptions): string;

package/dist/server/project-root.js

@@ -0,0 +1,3 @@
+import"../chunk-8xy18qmz.js";var{existsSync:T,readFileSync:U}=(()=>({}));function C(e){if(typeof e!=="string")throw TypeError("Path must be a string. Received "+JSON.stringify(e))}function w(e,f){var l="",n=0,i=-1,r=0,g;for(var u=0;u<=e.length;++u){if(u<e.length)g=e.charCodeAt(u);else if(g===47)break;else g=47;if(g===47){if(i===u-1||r===1);else if(i!==u-1&&r===2){if(l.length<2||n!==2||l.charCodeAt(l.length-1)!==46||l.charCodeAt(l.length-2)!==46){if(l.length>2){var v=l.lastIndexOf("/");if(v!==l.length-1){if(v===-1)l="",n=0;else l=l.slice(0,v),n=l.length-1-l.lastIndexOf("/");i=u,r=0;continue}}else if(l.length===2||l.length===1){l="",n=0,i=u,r=0;continue}}if(f){if(l.length>0)l+="/..";else l="..";n=2}}else{if(l.length>0)l+="/"+e.slice(i+1,u);else l=e.slice(i+1,u);n=u-i-1}i=u,r=0}else if(g===46&&r!==-1)++r;else r=-1}return l}function m(e,f){var l=f.dir||f.root,n=f.base||(f.name||"")+(f.ext||"");if(!l)return n;if(l===f.root)return l+n;return l+e+n}function b(){var e="",f=!1,l;for(var n=arguments.length-1;n>=-1&&!f;n--){var i;if(n>=0)i=arguments[n];else{if(l===void 0)l=process.cwd();i=l}if(C(i),i.length===0)continue;e=i+"/"+e,f=i.charCodeAt(0)===47}if(e=w(e,!f),f)if(e.length>0)return"/"+e;else return"/";else if(e.length>0)return e;else return"."}function L(e){if(C(e),e.length===0)return".";var f=e.charCodeAt(0)===47,l=e.charCodeAt(e.length-1)===47;if(e=w(e,!f),e.length===0&&!f)e=".";if(e.length>0&&l)e+="/";if(f)return"/"+e;return e}function _(e){return C(e),e.length>0&&e.charCodeAt(0)===47}function z(){if(arguments.length===0)return".";var e;for(var f=0;f<arguments.length;++f){var l=arguments[f];if(C(l),l.length>0)if(e===void 0)e=l;else e+="/"+l}if(e===void 0)return".";return L(e)}function S(e,f){if(C(e),C(f),e===f)return"";if(e=b(e),f=b(f),e===f)return"";var l=1;for(;l<e.length;++l)if(e.charCodeAt(l)!==47)break;var n=e.length,i=n-l,r=1;for(;r<f.length;++r)if(f.charCodeAt(r)!==47)break;var g=f.length,u=g-r,v=i<u?i:u,A=-1,s=0;for(;s<=v;++s){if(s===v){if(u>v){if(f.charCodeAt(r+s)===47)return f.slice(r+s+1);else if(s===0)return f.slice(r+s)}else if(i>v){if(e.charCodeAt(l+s)===47)A=s;else if(s===0)A=0}break}var t=e.charCodeAt(l+s),h=f.charCodeAt(r+s);if(t!==h)break;else if(t===47)A=s}var d="";for(s=l+A+1;s<=n;++s)if(s===n||e.charCodeAt(s)===47)if(d.length===0)d+="..";else d+="/..";if(d.length>0)return d+f.slice(r+A);else{if(r+=A,f.charCodeAt(r)===47)++r;return f.slice(r)}}function E(e){return e}function c(e){if(C(e),e.length===0)return".";var f=e.charCodeAt(0),l=f===47,n=-1,i=!0;for(var r=e.length-1;r>=1;--r)if(f=e.charCodeAt(r),f===47){if(!i){n=r;break}}else i=!1;if(n===-1)return l?"/":".";if(l&&n===1)return"//";return e.slice(0,n)}function B(e,f){if(f!==void 0&&typeof f!=="string")throw TypeError('"ext" argument must be a string');C(e);var l=0,n=-1,i=!0,r;if(f!==void 0&&f.length>0&&f.length<=e.length){if(f.length===e.length&&f===e)return"";var g=f.length-1,u=-1;for(r=e.length-1;r>=0;--r){var v=e.charCodeAt(r);if(v===47){if(!i){l=r+1;break}}else{if(u===-1)i=!1,u=r+1;if(g>=0)if(v===f.charCodeAt(g)){if(--g===-1)n=r}else g=-1,n=u}}if(l===n)n=u;else if(n===-1)n=e.length;return e.slice(l,n)}else{for(r=e.length-1;r>=0;--r)if(e.charCodeAt(r)===47){if(!i){l=r+1;break}}else if(n===-1)i=!1,n=r+1;if(n===-1)return"";return e.slice(l,n)}}function G(e){C(e);var f=-1,l=0,n=-1,i=!0,r=0;for(var g=e.length-1;g>=0;--g){var u=e.charCodeAt(g);if(u===47){if(!i){l=g+1;break}continue}if(n===-1)i=!1,n=g+1;if(u===46){if(f===-1)f=g;else if(r!==1)r=1}else if(f!==-1)r=-1}if(f===-1||n===-1||r===0||r===1&&f===n-1&&f===l+1)return"";return e.slice(f,n)}function H(e){if(e===null||typeof e!=="object")throw TypeError('The "pathObject" argument must be of type Object. Received type '+typeof e);return m("/",e)}function K(e){C(e);var f={root:"",dir:"",base:"",ext:"",name:""};if(e.length===0)return f;var l=e.charCodeAt(0),n=l===47,i;if(n)f.root="/",i=1;else i=0;var r=-1,g=0,u=-1,v=!0,A=e.length-1,s=0;for(;A>=i;--A){if(l=e.charCodeAt(A),l===47){if(!v){g=A+1;break}continue}if(u===-1)v=!1,u=A+1;if(l===46){if(r===-1)r=A;else if(s!==1)s=1}else if(r!==-1)s=-1}if(r===-1||u===-1||s===0||s===1&&r===u-1&&r===g+1){if(u!==-1)if(g===0&&n)f.base=f.name=e.slice(1,u);else f.base=f.name=e.slice(g,u)}else{if(g===0&&n)f.name=e.slice(1,r),f.base=e.slice(1,u);else f.name=e.slice(g,r),f.base=e.slice(g,u);f.ext=e.slice(r,u)}if(g>0)f.dir=e.slice(0,g-1);else if(n)f.dir="/";return f}var M="/",Q=":",$=((e)=>(e.posix=e,e))({resolve:b,normalize:L,isAbsolute:_,join:z,relative:S,_makeLong:E,dirname:c,basename:B,extname:G,format:H,parse:K,sep:M,delimiter:Q,win32:null,posix:null});function k(e={}){let f=Y(e.startDirectories?.length?e.startDirectories:[process.cwd(),import.meta.dirname]),l=b(e.stopAt??"/");for(let n of f){let i=V(n,l,e);if(i)return i}throw Error(Z(e,f))}function V(e,f,l){let n=b(e);for(;;){if(W(n,l))return n;if(n===f)return;let i=c(n);if(i===n)return;n=i}}function W(e,f){if(!X(e,f.packageName))return!1;return(f.requiredPaths??[]).every((l)=>T(b(e,l)))}function X(e,f){if(!f)return!0;let l=b(e,"package.json");if(!T(l))return!1;try{return JSON.parse(U(l,"utf8")).name===f}catch{return!1}}function Y(e){return Array.from(new Set(e.map((f)=>b(f))))}function Z(e,f){let l=[e.packageName?`package name ${JSON.stringify(e.packageName)}`:void 0,e.requiredPaths?.length?`paths ${e.requiredPaths.map((n)=>JSON.stringify(n)).join(", ")}`:void 0].filter((n)=>typeof n==="string").join(" and ");return`Unable to resolve a project root${l?` matching ${l}`:""} from ${f.join(", ")}.`}export{k as resolveProjectRoot};
+
+//# debugId=092C65A79F3C884364756E2164756E21

package/dist/server/project-root.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/server/project-root.ts", "node:path"],
+  "sourcesContent": [
+    "import { existsSync, readFileSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\n\n/**\n * Options that constrain how {@link resolveProjectRoot} searches ancestor\n * directories.\n */\nexport type ResolveProjectRootOptions = {\n\t/** Expected `package.json#name` value for the resolved project root. */\n\tpackageName?: string;\n\t/** Additional relative paths that must exist inside the resolved directory. */\n\trequiredPaths?: string[];\n\t/** Starting directories to search upward from before giving up. */\n\tstartDirectories?: string[];\n\t/** Absolute or relative directory where the upward search must stop. */\n\tstopAt?: string;\n};\n\n/**\n * Resolves the nearest ancestor directory that matches the provided package and\n * path markers. Framework adapters can use this to find their project root\n * without hardcoding a fixed number of parent-directory guesses.\n */\nexport function resolveProjectRoot(options: ResolveProjectRootOptions = {}): string {\n\tconst candidateStarts = dedupeDirectories(\n\t\toptions.startDirectories?.length ? options.startDirectories : [process.cwd(), import.meta.dirname],\n\t);\n\tconst stopAt = resolve(options.stopAt ?? '/');\n\n\tfor (const startDirectory of candidateStarts) {\n\t\tconst resolvedRoot = resolveProjectRootFrom(startDirectory, stopAt, options);\n\n\t\tif (resolvedRoot) {\n\t\t\treturn resolvedRoot;\n\t\t}\n\t}\n\n\tthrow new Error(createResolveProjectRootError(options, candidateStarts));\n}\n\nfunction resolveProjectRootFrom(\n\tstartDirectory: string,\n\tstopAt: string,\n\toptions: ResolveProjectRootOptions,\n): string | undefined {\n\tlet currentDirectory = resolve(startDirectory);\n\n\tfor (;;) {\n\t\tif (matchesProjectRoot(currentDirectory, options)) {\n\t\t\treturn currentDirectory;\n\t\t}\n\n\t\tif (currentDirectory === stopAt) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst parentDirectory = dirname(currentDirectory);\n\n\t\tif (parentDirectory === currentDirectory) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tcurrentDirectory = parentDirectory;\n\t}\n}\n\nfunction matchesProjectRoot(directory: string, options: ResolveProjectRootOptions): boolean {\n\tif (!matchesPackageName(directory, options.packageName)) {\n\t\treturn false;\n\t}\n\n\treturn (options.requiredPaths ?? []).every((requiredPath) => existsSync(resolve(directory, requiredPath)));\n}\n\nfunction matchesPackageName(directory: string, packageName: string | undefined): boolean {\n\tif (!packageName) {\n\t\treturn true;\n\t}\n\n\tconst packageJsonPath = resolve(directory, 'package.json');\n\n\tif (!existsSync(packageJsonPath)) {\n\t\treturn false;\n\t}\n\n\ttry {\n\t\tconst packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8')) as { name?: string };\n\t\treturn packageJson.name === packageName;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction dedupeDirectories(directories: string[]): string[] {\n\treturn Array.from(new Set(directories.map((directory) => resolve(directory))));\n}\n\nfunction createResolveProjectRootError(options: ResolveProjectRootOptions, startDirectories: string[]): string {\n\tconst markerSummary = [\n\t\toptions.packageName ? `package name ${JSON.stringify(options.packageName)}` : undefined,\n\t\toptions.requiredPaths?.length\n\t\t\t? `paths ${options.requiredPaths.map((path) => JSON.stringify(path)).join(', ')}`\n\t\t\t: undefined,\n\t]\n\t\t.filter((marker): marker is string => typeof marker === 'string')\n\t\t.join(' and ');\n\n\treturn `Unable to resolve a project root${markerSummary ? ` matching ${markerSummary}` : ''} from ${startDirectories.join(', ')}.`;\n}\n",
+    "function assertPath(path){if(typeof path!==\"string\")throw TypeError(\"Path must be a string. Received \"+JSON.stringify(path))}function normalizeStringPosix(path,allowAboveRoot){var res=\"\",lastSegmentLength=0,lastSlash=-1,dots=0,code;for(var i=0;i<=path.length;++i){if(i<path.length)code=path.charCodeAt(i);else if(code===47)break;else code=47;if(code===47){if(lastSlash===i-1||dots===1);else if(lastSlash!==i-1&&dots===2){if(res.length<2||lastSegmentLength!==2||res.charCodeAt(res.length-1)!==46||res.charCodeAt(res.length-2)!==46){if(res.length>2){var lastSlashIndex=res.lastIndexOf(\"/\");if(lastSlashIndex!==res.length-1){if(lastSlashIndex===-1)res=\"\",lastSegmentLength=0;else res=res.slice(0,lastSlashIndex),lastSegmentLength=res.length-1-res.lastIndexOf(\"/\");lastSlash=i,dots=0;continue}}else if(res.length===2||res.length===1){res=\"\",lastSegmentLength=0,lastSlash=i,dots=0;continue}}if(allowAboveRoot){if(res.length>0)res+=\"/..\";else res=\"..\";lastSegmentLength=2}}else{if(res.length>0)res+=\"/\"+path.slice(lastSlash+1,i);else res=path.slice(lastSlash+1,i);lastSegmentLength=i-lastSlash-1}lastSlash=i,dots=0}else if(code===46&&dots!==-1)++dots;else dots=-1}return res}function _format(sep,pathObject){var dir=pathObject.dir||pathObject.root,base=pathObject.base||(pathObject.name||\"\")+(pathObject.ext||\"\");if(!dir)return base;if(dir===pathObject.root)return dir+base;return dir+sep+base}function resolve(){var resolvedPath=\"\",resolvedAbsolute=!1,cwd;for(var i=arguments.length-1;i>=-1&&!resolvedAbsolute;i--){var path;if(i>=0)path=arguments[i];else{if(cwd===void 0)cwd=process.cwd();path=cwd}if(assertPath(path),path.length===0)continue;resolvedPath=path+\"/\"+resolvedPath,resolvedAbsolute=path.charCodeAt(0)===47}if(resolvedPath=normalizeStringPosix(resolvedPath,!resolvedAbsolute),resolvedAbsolute)if(resolvedPath.length>0)return\"/\"+resolvedPath;else return\"/\";else if(resolvedPath.length>0)return resolvedPath;else return\".\"}function normalize(path){if(assertPath(path),path.length===0)return\".\";var isAbsolute=path.charCodeAt(0)===47,trailingSeparator=path.charCodeAt(path.length-1)===47;if(path=normalizeStringPosix(path,!isAbsolute),path.length===0&&!isAbsolute)path=\".\";if(path.length>0&&trailingSeparator)path+=\"/\";if(isAbsolute)return\"/\"+path;return path}function isAbsolute(path){return assertPath(path),path.length>0&&path.charCodeAt(0)===47}function join(){if(arguments.length===0)return\".\";var joined;for(var i=0;i<arguments.length;++i){var arg=arguments[i];if(assertPath(arg),arg.length>0)if(joined===void 0)joined=arg;else joined+=\"/\"+arg}if(joined===void 0)return\".\";return normalize(joined)}function relative(from,to){if(assertPath(from),assertPath(to),from===to)return\"\";if(from=resolve(from),to=resolve(to),from===to)return\"\";var fromStart=1;for(;fromStart<from.length;++fromStart)if(from.charCodeAt(fromStart)!==47)break;var fromEnd=from.length,fromLen=fromEnd-fromStart,toStart=1;for(;toStart<to.length;++toStart)if(to.charCodeAt(toStart)!==47)break;var toEnd=to.length,toLen=toEnd-toStart,length=fromLen<toLen?fromLen:toLen,lastCommonSep=-1,i=0;for(;i<=length;++i){if(i===length){if(toLen>length){if(to.charCodeAt(toStart+i)===47)return to.slice(toStart+i+1);else if(i===0)return to.slice(toStart+i)}else if(fromLen>length){if(from.charCodeAt(fromStart+i)===47)lastCommonSep=i;else if(i===0)lastCommonSep=0}break}var fromCode=from.charCodeAt(fromStart+i),toCode=to.charCodeAt(toStart+i);if(fromCode!==toCode)break;else if(fromCode===47)lastCommonSep=i}var out=\"\";for(i=fromStart+lastCommonSep+1;i<=fromEnd;++i)if(i===fromEnd||from.charCodeAt(i)===47)if(out.length===0)out+=\"..\";else out+=\"/..\";if(out.length>0)return out+to.slice(toStart+lastCommonSep);else{if(toStart+=lastCommonSep,to.charCodeAt(toStart)===47)++toStart;return to.slice(toStart)}}function _makeLong(path){return path}function dirname(path){if(assertPath(path),path.length===0)return\".\";var code=path.charCodeAt(0),hasRoot=code===47,end=-1,matchedSlash=!0;for(var i=path.length-1;i>=1;--i)if(code=path.charCodeAt(i),code===47){if(!matchedSlash){end=i;break}}else matchedSlash=!1;if(end===-1)return hasRoot?\"/\":\".\";if(hasRoot&&end===1)return\"//\";return path.slice(0,end)}function basename(path,ext){if(ext!==void 0&&typeof ext!==\"string\")throw TypeError('\"ext\" argument must be a string');assertPath(path);var start=0,end=-1,matchedSlash=!0,i;if(ext!==void 0&&ext.length>0&&ext.length<=path.length){if(ext.length===path.length&&ext===path)return\"\";var extIdx=ext.length-1,firstNonSlashEnd=-1;for(i=path.length-1;i>=0;--i){var code=path.charCodeAt(i);if(code===47){if(!matchedSlash){start=i+1;break}}else{if(firstNonSlashEnd===-1)matchedSlash=!1,firstNonSlashEnd=i+1;if(extIdx>=0)if(code===ext.charCodeAt(extIdx)){if(--extIdx===-1)end=i}else extIdx=-1,end=firstNonSlashEnd}}if(start===end)end=firstNonSlashEnd;else if(end===-1)end=path.length;return path.slice(start,end)}else{for(i=path.length-1;i>=0;--i)if(path.charCodeAt(i)===47){if(!matchedSlash){start=i+1;break}}else if(end===-1)matchedSlash=!1,end=i+1;if(end===-1)return\"\";return path.slice(start,end)}}function extname(path){assertPath(path);var startDot=-1,startPart=0,end=-1,matchedSlash=!0,preDotState=0;for(var i=path.length-1;i>=0;--i){var code=path.charCodeAt(i);if(code===47){if(!matchedSlash){startPart=i+1;break}continue}if(end===-1)matchedSlash=!1,end=i+1;if(code===46){if(startDot===-1)startDot=i;else if(preDotState!==1)preDotState=1}else if(startDot!==-1)preDotState=-1}if(startDot===-1||end===-1||preDotState===0||preDotState===1&&startDot===end-1&&startDot===startPart+1)return\"\";return path.slice(startDot,end)}function format(pathObject){if(pathObject===null||typeof pathObject!==\"object\")throw TypeError('The \"pathObject\" argument must be of type Object. Received type '+typeof pathObject);return _format(\"/\",pathObject)}function parse(path){assertPath(path);var ret={root:\"\",dir:\"\",base:\"\",ext:\"\",name:\"\"};if(path.length===0)return ret;var code=path.charCodeAt(0),isAbsolute2=code===47,start;if(isAbsolute2)ret.root=\"/\",start=1;else start=0;var startDot=-1,startPart=0,end=-1,matchedSlash=!0,i=path.length-1,preDotState=0;for(;i>=start;--i){if(code=path.charCodeAt(i),code===47){if(!matchedSlash){startPart=i+1;break}continue}if(end===-1)matchedSlash=!1,end=i+1;if(code===46){if(startDot===-1)startDot=i;else if(preDotState!==1)preDotState=1}else if(startDot!==-1)preDotState=-1}if(startDot===-1||end===-1||preDotState===0||preDotState===1&&startDot===end-1&&startDot===startPart+1){if(end!==-1)if(startPart===0&&isAbsolute2)ret.base=ret.name=path.slice(1,end);else ret.base=ret.name=path.slice(startPart,end)}else{if(startPart===0&&isAbsolute2)ret.name=path.slice(1,startDot),ret.base=path.slice(1,end);else ret.name=path.slice(startPart,startDot),ret.base=path.slice(startPart,end);ret.ext=path.slice(startDot,end)}if(startPart>0)ret.dir=path.slice(0,startPart-1);else if(isAbsolute2)ret.dir=\"/\";return ret}var sep=\"/\",delimiter=\":\",posix=((p)=>(p.posix=p,p))({resolve,normalize,isAbsolute,join,relative,_makeLong,dirname,basename,extname,format,parse,sep,delimiter,win32:null,posix:null});var path_default=posix;export{sep,resolve,relative,posix,parse,normalize,join,isAbsolute,format,extname,dirname,delimiter,path_default as default,basename,_makeLong};"
+  ],
+  "mappings": "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",
+  "debugId": "092C65A79F3C884364756E2164756E21",
+  "names": []
+}

package/dist/server/render-component.d.ts

@@ -0,0 +1,195 @@
+import type { JsxRenderable } from '@ecopages/jsx';
+import type { RenderToStringOptions } from '@ecopages/jsx/server';
+import type { ContextType, UnknownContext } from '../context/types';
+import { type ServerRenderEnvironment } from './light-dom-shim';
+/** Default response header carrying the fragment render timestamp. */
+export declare const RENDERED_COMPONENT_GENERATED_AT_HEADER = "x-generated-at";
+/** Default response header carrying the custom-element tag name for the fragment. */
+export declare const RENDERED_COMPONENT_TAG_NAME_HEADER = "x-radiant-tag-name";
+/** Default response header carrying the client module URL for the fragment. */
+export declare const RENDERED_COMPONENT_CLIENT_MODULE_HEADER = "x-radiant-client-module";
+/** Default response header carrying serialized fragment asset metadata. */
+export declare const RENDERED_COMPONENT_ASSETS_HEADER = "x-radiant-assets";
+/** Asset dependency emitted by a rendered fragment. */
+export type RenderedComponentAsset = {
+    /** Browser module specifier that must be loaded to activate the fragment. */
+    kind: 'script-module';
+    /** Runtime loading policy for the module. */
+    stage?: 'hydrate' | 'idle' | 'immediate';
+    /** Module specifier or browser-importable URL. */
+    src: string;
+} | {
+    /** Module graph preload hint for adapters that control the document head. */
+    kind: 'modulepreload';
+    /** Module specifier or browser-importable URL. */
+    href: string;
+} | {
+    /** Stylesheet dependency required by the rendered fragment. */
+    kind: 'style';
+    /** Browser-importable stylesheet URL. */
+    href: string;
+    /** Optional media query applied to the stylesheet link. */
+    media?: string;
+};
+/** Creates a module asset entry for a rendered fragment. */
+export declare function scriptModuleAsset(src: string, stage?: 'hydrate' | 'idle' | 'immediate'): RenderedComponentAsset;
+/** Creates a modulepreload hint for a rendered fragment. */
+export declare function modulePreloadAsset(href: string): RenderedComponentAsset;
+/** Creates a stylesheet asset entry for a rendered fragment. */
+export declare function styleAsset(href: string, media?: string): RenderedComponentAsset;
+/** Portable metadata for a server-rendered custom-element fragment. */
+export type RenderedComponentMetadata = {
+    /** Asset dependencies required by the rendered fragment. */
+    assets: readonly RenderedComponentAsset[];
+    /** Browser-importable client module URL used to register the component before hydration. */
+    clientModuleUrl?: string;
+    /** ISO timestamp describing when the fragment was rendered. */
+    generatedAt: string;
+    /** Custom-element tag name emitted at the fragment root. */
+    tagName: string;
+};
+/** Canonical server render result returned by `renderComponent()`. */
+export type RenderedComponent = {
+    /** Serialized custom-element host markup. */
+    markup: string;
+    /** Transport-agnostic metadata that adapters can map onto headers or JSON. */
+    metadata: RenderedComponentMetadata;
+    /** JSX-compatible preview value that can be embedded into a larger SSR shell. */
+    preview: JsxRenderable;
+};
+/** Serializable metadata for a server-rendered custom-element fragment. */
+export type RenderedComponentPayload = {
+    /** Asset dependencies required by the rendered fragment. */
+    assets?: readonly RenderedComponentAsset[];
+    /** Browser-importable client module URL used to register the component before hydration. */
+    clientModuleSrc?: string;
+    /** ISO timestamp describing when the fragment was rendered. */
+    generatedAt: string;
+    /** Serialized custom-element host markup. */
+    markup: string;
+    /** Custom-element tag name emitted at the fragment root. */
+    tagName: string;
+};
+/** Full SSR result including a JSX-compatible preview value for shell composition. */
+export type StreamableRenderedComponent = RenderedComponentPayload & {
+    /** JSX-compatible preview value that can be embedded into a larger SSR shell. */
+    preview: JsxRenderable;
+};
+/** Minimal component contract needed for framework-agnostic SSR helpers. */
+export type ServerRenderableComponent = {
+    renderHost?: () => JsxRenderable;
+    renderHostToString: (options?: RenderToStringOptions) => string;
+};
+/** Constructor shape for a server-renderable component. */
+export type ServerRenderableComponentConstructor<TComponent extends ServerRenderableComponent> = CustomElementConstructor & {
+    new (): TComponent;
+};
+/**
+ * Resolves the browser-importable client module URL for a component constructor.
+ *
+ * Use this when the server adapter can derive the client entry lazily instead of
+ * hardcoding `clientModuleSrc` for every render call.
+ */
+export type ResolveRenderedComponentClientModule<TComponent extends ServerRenderableComponent> = (component: ServerRenderableComponentConstructor<TComponent>) => string | undefined | Promise<string | undefined>;
+/**
+ * Resolves fragment assets for a component constructor.
+ *
+ * Prefer this over `resolveClientModuleSrc(...)` for new adapters so assets can
+ * describe scripts, styles, and preload hints through one transport-agnostic shape.
+ */
+export type ResolveRenderedComponentAssets<TComponent extends ServerRenderableComponent> = (component: ServerRenderableComponentConstructor<TComponent>) => readonly RenderedComponentAsset[] | undefined | Promise<readonly RenderedComponentAsset[] | undefined>;
+/**
+ * Prepares a component host before SSR so slot-aware logic can observe authored
+ * light-DOM content during render.
+ */
+export type PrepareRenderedComponentHost<TComponent extends ServerRenderableComponent> = (host: TComponent & HTMLElement, environment: ServerRenderEnvironment) => void;
+/**
+ * Ambient SSR context value visible while a standalone component render runs.
+ *
+ * This lets adapters provide ancestor-like context to `consumeContext(...)` and
+ * `contextSelector(...)` without needing to instantiate a real provider host.
+ */
+export type RenderComponentSsrContextEntry<TContext extends UnknownContext = UnknownContext> = {
+    context: TContext;
+    value: ContextType<TContext>;
+};
+type RenderComponentSharedOptions<TComponent extends ServerRenderableComponent> = {
+    /** Asset dependencies required by the rendered fragment. */
+    assets?: readonly RenderedComponentAsset[];
+    /** Serialized authored light-DOM content to attach to the host before rendering. */
+    authoredContent?: string;
+    /** Browser-importable client module URL used to register the component before hydration. */
+    clientModuleSrc?: string;
+    /** Initializes the component instance before the host is rendered. */
+    initialize?: (component: TComponent) => void;
+    /** SSR environment responsible for preparing the host runtime and authored content. */
+    environment?: ServerRenderEnvironment;
+    /**
+     * Dedicated host-preparation hook for slot-aware SSR.
+     *
+     * Use this when the server needs to append or mutate authored light-DOM
+     * nodes directly instead of passing `authoredContent` as a string.
+     */
+    prepareHost?: PrepareRenderedComponentHost<TComponent>;
+    /**
+     * Ambient SSR context entries that should be visible while the component is
+     * instantiated and rendered.
+     *
+     * This solves standalone fragment renders that need to consume context from a
+     * parent-like server environment.
+     */
+    ssrContext?: readonly RenderComponentSsrContextEntry[];
+    /** Clock override used by tests and adapters that need deterministic timestamps. */
+    now?: () => Date;
+    /** JSX server-renderer options forwarded to `renderHostToString()`. */
+    renderOptions?: RenderToStringOptions;
+    /** Lazy asset resolver used when `assets` are not provided directly. */
+    resolveAssets?: ResolveRenderedComponentAssets<TComponent>;
+    /** Lazy client-module resolver used when `clientModuleSrc` is not provided directly. */
+    resolveClientModuleSrc?: ResolveRenderedComponentClientModule<TComponent>;
+    /** Explicit tag-name override when `@customElement(...)` metadata is not desired. */
+    tagName?: string;
+};
+/** Options accepted by the reusable SSR component rendering helpers. */
+export type RenderComponentOptions<TComponent extends ServerRenderableComponent> = RenderComponentSharedOptions<TComponent> & ({
+    component: ServerRenderableComponentConstructor<TComponent>;
+} | {
+    load: () => Promise<ServerRenderableComponentConstructor<TComponent>>;
+});
+/** Call-site options used when the component constructor is passed directly. */
+export type RenderComponentCallOptions<TComponent extends ServerRenderableComponent> = RenderComponentSharedOptions<TComponent>;
+/**
+ * Serializes a custom element into HTML, inferring its tag name from
+ * `@customElement(...)` metadata when the caller does not provide one.
+ */
+export declare function renderComponentToString<TComponent extends ServerRenderableComponent>(component: ServerRenderableComponentConstructor<TComponent>, options?: RenderComponentCallOptions<TComponent>): Promise<string>;
+export declare function renderComponentToString<TComponent extends ServerRenderableComponent>(options: RenderComponentOptions<TComponent>): Promise<string>;
+/**
+ * Renders a custom element into the canonical portable server-rendered shape,
+ * separating transport-agnostic metadata from any HTTP-specific adapter.
+ */
+export declare function renderComponent<TComponent extends ServerRenderableComponent>(component: ServerRenderableComponentConstructor<TComponent>, options?: RenderComponentCallOptions<TComponent>): Promise<RenderedComponent>;
+export declare function renderComponent<TComponent extends ServerRenderableComponent>(options: RenderComponentOptions<TComponent>): Promise<RenderedComponent>;
+/**
+ * Serializes a custom element into a fragment payload that frameworks can
+ * attach to any response shape they prefer.
+ */
+export declare function renderComponentToPayload<TComponent extends ServerRenderableComponent>(component: ServerRenderableComponentConstructor<TComponent>, options?: RenderComponentCallOptions<TComponent>): Promise<RenderedComponentPayload>;
+export declare function renderComponentToPayload<TComponent extends ServerRenderableComponent>(options: RenderComponentOptions<TComponent>): Promise<RenderedComponentPayload>;
+/**
+ * Renders a component into both fragment metadata and a JSX-compatible preview
+ * value that can be embedded into a larger server-rendered shell.
+ */
+export declare function renderStreamableComponent<TComponent extends ServerRenderableComponent>(component: ServerRenderableComponentConstructor<TComponent>, options?: RenderComponentCallOptions<TComponent>): Promise<StreamableRenderedComponent>;
+export declare function renderStreamableComponent<TComponent extends ServerRenderableComponent>(options: RenderComponentOptions<TComponent>): Promise<StreamableRenderedComponent>;
+/**
+ * Drops the preview renderable so the result can be sent through lightweight
+ * framework adapters or JSON/HTML fragment endpoints.
+ */
+export declare function toRenderedComponentPayload(render: StreamableRenderedComponent | RenderedComponent): RenderedComponentPayload;
+/**
+ * Converts a rendered fragment payload into the standard metadata headers used
+ * by client-side fragment loaders.
+ */
+export declare function createRenderedComponentHeaders(render: RenderedComponent | RenderedComponentMetadata | RenderedComponentPayload | StreamableRenderedComponent): Record<string, string>;
+export {};

package/dist/server/render-component.js

@@ -0,0 +1,3 @@
+import{d as Z}from"../chunk-jce9gqqw.js";import{Ya as Y}from"../chunk-ms6a9zdt.js";import{Za as X}from"../chunk-dx1wqc00.js";import"../chunk-4cc2syf5.js";import"../chunk-8xy18qmz.js";var x="x-generated-at",L="x-radiant-tag-name",P="x-radiant-client-module",T="x-radiant-assets";function A(j,q="hydrate"){return{kind:"script-module",src:j,stage:q}}function C(j){return{kind:"modulepreload",href:j}}function z(j,q){return q?{kind:"style",href:j,media:q}:{kind:"style",href:j}}async function c(j,q){return(await J(K(j,q))).markup}async function O(j,q){return J(K(j,q))}async function l(j,q){return D(await J(K(j,q)))}async function m(j,q){return f(await J(K(j,q)))}async function J(j){let q=j.environment??Z(),B=X(_(j.ssrContext));try{let F="component"in j?j.component:await j.load(),G=new F;R(q,G,j.authoredContent,j.prepareHost),j.initialize?.(G);let Q=j.clientModuleSrc??await j.resolveClientModuleSrc?.(F),b=j.assets??await j.resolveAssets?.(F)??[],V=v(b,Q),w=E(V)??Q,I=j.tagName??S(F),U=(j.now??N)().toISOString(),k=h(j.renderOptions),W=G.renderHostToString(k);return{markup:W,metadata:{assets:V,clientModuleUrl:w,generatedAt:U,tagName:I},preview:G.renderHost?.()??{nodeType:1,outerHTML:W}}}finally{B()}}function R(j,q,B,F){if(!y(q)){if(B===void 0&&F===void 0)return;throw Error(`${q.constructor.name} cannot prepare SSR host content because it does not expose an innerHTML host surface.`)}j.prepareHost(q,{authoredContent:B}),F?.(q,j)}function _(j){if(!j||j.length===0)return[];return j.map((q)=>({getContext:()=>q.value,getContextKey:()=>q.context,renderHydrationScript:()=>{return},renderHydrationScriptTag:()=>{return}}))}function D(j){if("metadata"in j)return{assets:j.metadata.assets,clientModuleSrc:j.metadata.clientModuleUrl,generatedAt:j.metadata.generatedAt,markup:j.markup,tagName:j.metadata.tagName};let{preview:q,...B}=j;return B}function p(j){let q=H(j);return{...q.assets.length>0?{[T]:JSON.stringify(q.assets)}:{},...q.clientModuleUrl?{[P]:q.clientModuleUrl}:{},[x]:q.generatedAt,[L]:q.tagName}}function H(j){if("metadata"in j)return j.metadata;if("markup"in j)return{assets:j.assets??$(j.clientModuleSrc),clientModuleUrl:j.clientModuleSrc,generatedAt:j.generatedAt,tagName:j.tagName};return j}function f(j){return{assets:j.metadata.assets,clientModuleSrc:j.metadata.clientModuleUrl,generatedAt:j.metadata.generatedAt,markup:j.markup,preview:j.preview,tagName:j.metadata.tagName}}function N(){return new Date}function $(j){if(!j)return[];return[A(j)]}function v(j,q){if(!q)return j;if(j.some((B)=>B.kind==="script-module"&&B.src===q))return j;return[...$(q),...j]}function E(j){return j.find((q)=>q.kind==="script-module")?.src}function K(j,q){if(typeof j==="function")return{...q,component:j};return j}function h(j){if(j?.hydrate!==void 0)return j;return{...j,hydrate:!0}}function y(j){return"innerHTML"in j}function S(j){let q=Y(j);if(!q)throw Error(`${j.name} is missing @customElement metadata.`);return q}export{D as toRenderedComponentPayload,z as styleAsset,A as scriptModuleAsset,m as renderStreamableComponent,c as renderComponentToString,l as renderComponentToPayload,O as renderComponent,C as modulePreloadAsset,p as createRenderedComponentHeaders,L as RENDERED_COMPONENT_TAG_NAME_HEADER,x as RENDERED_COMPONENT_GENERATED_AT_HEADER,P as RENDERED_COMPONENT_CLIENT_MODULE_HEADER,T as RENDERED_COMPONENT_ASSETS_HEADER};
+
+//# debugId=E62B78C0A966A7EC64756E2164756E21