@ecopages/radiant 0.2.0 → 0.3.0-alpha.1

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 RenderedComponentWithPreview = 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 renderComponentWithPreview<TComponent extends ServerRenderableComponent>(component: ServerRenderableComponentConstructor<TComponent>, options?: RenderComponentCallOptions<TComponent>): Promise<RenderedComponentWithPreview>;
+export declare function renderComponentWithPreview<TComponent extends ServerRenderableComponent>(options: RenderComponentOptions<TComponent>): Promise<RenderedComponentWithPreview>;
+/**
+ * Drops the preview renderable so the result can be sent through lightweight
+ * framework adapters or JSON/HTML fragment endpoints.
+ */
+export declare function toRenderedComponentPayload(render: RenderedComponentWithPreview | 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 | RenderedComponentWithPreview): Record<string, string>;
+export {};

package/dist/server/render-component.js

@@ -0,0 +1,3 @@
+import{f as V}from"../chunk-4e559cy5.js";import"../chunk-3ryr5wx2.js";import{h as W}from"../chunk-ssnnxzrj.js";import{l as x}from"../chunk-sf4a2gy5.js";import"../chunk-5b1en9vz.js";import{Ta as I}from"../chunk-e0r6ca2g.js";import{Xa as U}from"../chunk-hztr86b4.js";import"../chunk-9mqtp3js.js";import"../chunk-t8xtvgyg.js";import"../chunk-66e6s792.js";import"../chunk-vgtggzb6.js";var D="x-generated-at",H="x-radiant-tag-name",R="x-radiant-client-module",f="x-radiant-assets";V();function N(j,q="hydrate"){return{kind:"script-module",src:j,stage:q}}function d(j){return{kind:"modulepreload",href:j}}function s(j,q){return q?{kind:"style",href:j,media:q}:{kind:"style",href:j}}async function i(j,q){return(await K(Q(j,q))).markup}async function t(j,q){return K(Q(j,q))}async function o(j,q){return h(await K(Q(j,q)))}async function r(j,q){return M(await K(Q(j,q)))}async function K(j){V();let q=j.environment??x(),F=W(B(j.ssrContext));try{let G="component"in j?j.component:await j.load(),J=new G;v(q,J,j.authoredContent,j.prepareHost),j.initialize?.(J);let X=j.clientModuleSrc??await j.resolveClientModuleSrc?.(G),w=j.assets??await j.resolveAssets?.(G)??[],Y=S(w,X),T=u(Y)??X,A=j.tagName??O(G),P=(j.now??C)().toISOString(),Z=g(j.renderOptions),$=k(J),b=$?.renderHostToString?.(Z)??J.renderHostToString(Z),_=E(J,$,b);return{markup:b,metadata:{assets:Y,clientModuleUrl:T,generatedAt:P,tagName:A},preview:_}}finally{F()}}function k(j){return I()?.resolveRenderBridge(j)}function E(j,q,F){if(!q)return j.renderHost?.()??{nodeType:1,outerHTML:F};if(!q.renderHostToString&&q.renderHost)return{nodeType:1,outerHTML:F};return q.renderHost?.()??j.renderHost?.()??{nodeType:1,outerHTML:F}}function v(j,q,F,G){if(!z(q)){if(F===void 0&&G===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:F}),G?.(q,j)}function B(j){if(!j||j.length===0)return[];return j.map((q)=>({getContext:()=>q.value,getContextKey:()=>q.context,renderHydrationScript:()=>{return},renderHydrationScriptTag:()=>{return}}))}function h(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,...F}=j;return F}function n(j){let q=y(j);return{...q.assets.length>0?{[f]:JSON.stringify(q.assets)}:{},...q.clientModuleUrl?{[R]:q.clientModuleUrl}:{},[D]:q.generatedAt,[H]:q.tagName}}function y(j){if("metadata"in j)return j.metadata;if("markup"in j)return{assets:j.assets??L(j.clientModuleSrc),clientModuleUrl:j.clientModuleSrc,generatedAt:j.generatedAt,tagName:j.tagName};return j}function M(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 C(){return new Date}function L(j){if(!j)return[];return[N(j)]}function S(j,q){if(!q)return j;if(j.some((F)=>F.kind==="script-module"&&F.src===q))return j;return[...L(q),...j]}function u(j){return j.find((q)=>q.kind==="script-module")?.src}function Q(j,q){if(typeof j==="function")return{...q,component:j};return j}function g(j){if(j?.hydrate!==void 0)return j;return{...j,hydrate:!0}}function z(j){return"innerHTML"in j}function O(j){let q=U(j);if(!q)throw Error(`${j.name} is missing @customElement metadata.`);return q}export{h as toRenderedComponentPayload,s as styleAsset,N as scriptModuleAsset,r as renderComponentWithPreview,i as renderComponentToString,o as renderComponentToPayload,t as renderComponent,d as modulePreloadAsset,n as createRenderedComponentHeaders,H as RENDERED_COMPONENT_TAG_NAME_HEADER,D as RENDERED_COMPONENT_GENERATED_AT_HEADER,R as RENDERED_COMPONENT_CLIENT_MODULE_HEADER,f as RENDERED_COMPONENT_ASSETS_HEADER};
+
+//# debugId=D8CA00B6DC44E8E864756E2164756E21

package/dist/server/render-component.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/server/render-component.ts"],
+  "sourcesContent": [
+    "import type { JsxRenderable } from '@ecopages/jsx';\nimport type { RenderToStringOptions } from '@ecopages/jsx/server';\nimport type { SsrSerializableContextProvider } from '../context/context-provider';\nimport {\n\tgetRadiantComponentSsrRuntime,\n\ttype RadiantComponentRenderBridge,\n\ttype RadiantComponentSsrCapable,\n} from '../core/radiant-component-ssr-registry';\nimport { withSsrContextProviders } from './context-ssr';\nimport type { ContextType, UnknownContext } from '../context/types';\nimport { getCustomElementTagName } from '../core/custom-element-metadata';\nimport { createServerRenderEnvironment, type ServerRenderEnvironment } from './light-dom-shim';\nimport { ensureRadiantComponentSsrRuntimeRegistered } from './radiant-component-ssr-runtime';\n\n/** Default response header carrying the fragment render timestamp. */\nexport const RENDERED_COMPONENT_GENERATED_AT_HEADER = 'x-generated-at';\n\n/** Default response header carrying the custom-element tag name for the fragment. */\nexport const RENDERED_COMPONENT_TAG_NAME_HEADER = 'x-radiant-tag-name';\n\n/** Default response header carrying the client module URL for the fragment. */\nexport const RENDERED_COMPONENT_CLIENT_MODULE_HEADER = 'x-radiant-client-module';\n\n/** Default response header carrying serialized fragment asset metadata. */\nexport const RENDERED_COMPONENT_ASSETS_HEADER = 'x-radiant-assets';\n\nensureRadiantComponentSsrRuntimeRegistered();\n\n/** Asset dependency emitted by a rendered fragment. */\nexport type RenderedComponentAsset =\n\t| {\n\t\t\t/** Browser module specifier that must be loaded to activate the fragment. */\n\t\t\tkind: 'script-module';\n\t\t\t/** Runtime loading policy for the module. */\n\t\t\tstage?: 'hydrate' | 'idle' | 'immediate';\n\t\t\t/** Module specifier or browser-importable URL. */\n\t\t\tsrc: string;\n\t  }\n\t| {\n\t\t\t/** Module graph preload hint for adapters that control the document head. */\n\t\t\tkind: 'modulepreload';\n\t\t\t/** Module specifier or browser-importable URL. */\n\t\t\thref: string;\n\t  }\n\t| {\n\t\t\t/** Stylesheet dependency required by the rendered fragment. */\n\t\t\tkind: 'style';\n\t\t\t/** Browser-importable stylesheet URL. */\n\t\t\thref: string;\n\t\t\t/** Optional media query applied to the stylesheet link. */\n\t\t\tmedia?: string;\n\t  };\n\n/** Creates a module asset entry for a rendered fragment. */\nexport function scriptModuleAsset(\n\tsrc: string,\n\tstage: 'hydrate' | 'idle' | 'immediate' = 'hydrate',\n): RenderedComponentAsset {\n\treturn { kind: 'script-module', src, stage };\n}\n\n/** Creates a modulepreload hint for a rendered fragment. */\nexport function modulePreloadAsset(href: string): RenderedComponentAsset {\n\treturn { kind: 'modulepreload', href };\n}\n\n/** Creates a stylesheet asset entry for a rendered fragment. */\nexport function styleAsset(href: string, media?: string): RenderedComponentAsset {\n\treturn media ? { kind: 'style', href, media } : { kind: 'style', href };\n}\n\n/** Portable metadata for a server-rendered custom-element fragment. */\nexport type RenderedComponentMetadata = {\n\t/** Asset dependencies required by the rendered fragment. */\n\tassets: readonly RenderedComponentAsset[];\n\t/** Browser-importable client module URL used to register the component before hydration. */\n\tclientModuleUrl?: string;\n\t/** ISO timestamp describing when the fragment was rendered. */\n\tgeneratedAt: string;\n\t/** Custom-element tag name emitted at the fragment root. */\n\ttagName: string;\n};\n\n/** Canonical server render result returned by `renderComponent()`. */\nexport type RenderedComponent = {\n\t/** Serialized custom-element host markup. */\n\tmarkup: string;\n\t/** Transport-agnostic metadata that adapters can map onto headers or JSON. */\n\tmetadata: RenderedComponentMetadata;\n\t/** JSX-compatible preview value that can be embedded into a larger SSR shell. */\n\tpreview: JsxRenderable;\n};\n\n/** Serializable metadata for a server-rendered custom-element fragment. */\nexport type RenderedComponentPayload = {\n\t/** Asset dependencies required by the rendered fragment. */\n\tassets?: readonly RenderedComponentAsset[];\n\t/** Browser-importable client module URL used to register the component before hydration. */\n\tclientModuleSrc?: string;\n\t/** ISO timestamp describing when the fragment was rendered. */\n\tgeneratedAt: string;\n\t/** Serialized custom-element host markup. */\n\tmarkup: string;\n\t/** Custom-element tag name emitted at the fragment root. */\n\ttagName: string;\n};\n\n/** Full SSR result including a JSX-compatible preview value for shell composition. */\nexport type RenderedComponentWithPreview = RenderedComponentPayload & {\n\t/** JSX-compatible preview value that can be embedded into a larger SSR shell. */\n\tpreview: JsxRenderable;\n};\n\n/** Minimal component contract needed for framework-agnostic SSR helpers. */\nexport type ServerRenderableComponent = {\n\trenderHost?: () => JsxRenderable;\n\trenderHostToString: (options?: RenderToStringOptions) => string;\n};\n\n/** Constructor shape for a server-renderable component. */\nexport type ServerRenderableComponentConstructor<TComponent extends ServerRenderableComponent> =\n\tCustomElementConstructor & {\n\t\tnew (): TComponent;\n\t};\n\n/**\n * Resolves the browser-importable client module URL for a component constructor.\n *\n * Use this when the server adapter can derive the client entry lazily instead of\n * hardcoding `clientModuleSrc` for every render call.\n */\nexport type ResolveRenderedComponentClientModule<TComponent extends ServerRenderableComponent> = (\n\tcomponent: ServerRenderableComponentConstructor<TComponent>,\n) => string | undefined | Promise<string | undefined>;\n\n/**\n * Resolves fragment assets for a component constructor.\n *\n * Prefer this over `resolveClientModuleSrc(...)` for new adapters so assets can\n * describe scripts, styles, and preload hints through one transport-agnostic shape.\n */\nexport type ResolveRenderedComponentAssets<TComponent extends ServerRenderableComponent> = (\n\tcomponent: ServerRenderableComponentConstructor<TComponent>,\n) => readonly RenderedComponentAsset[] | undefined | Promise<readonly RenderedComponentAsset[] | undefined>;\n\n/**\n * Prepares a component host before SSR so slot-aware logic can observe authored\n * light-DOM content during render.\n */\nexport type PrepareRenderedComponentHost<TComponent extends ServerRenderableComponent> = (\n\thost: TComponent & HTMLElement,\n\tenvironment: ServerRenderEnvironment,\n) => void;\n\n/**\n * Ambient SSR context value visible while a standalone component render runs.\n *\n * This lets adapters provide ancestor-like context to `consumeContext(...)` and\n * `contextSelector(...)` without needing to instantiate a real provider host.\n */\nexport type RenderComponentSsrContextEntry<TContext extends UnknownContext = UnknownContext> = {\n\tcontext: TContext;\n\tvalue: ContextType<TContext>;\n};\n\ntype RenderComponentSharedOptions<TComponent extends ServerRenderableComponent> = {\n\t/** Asset dependencies required by the rendered fragment. */\n\tassets?: readonly RenderedComponentAsset[];\n\t/** Serialized authored light-DOM content to attach to the host before rendering. */\n\tauthoredContent?: string;\n\t/** Browser-importable client module URL used to register the component before hydration. */\n\tclientModuleSrc?: string;\n\t/** Initializes the component instance before the host is rendered. */\n\tinitialize?: (component: TComponent) => void;\n\t/** SSR environment responsible for preparing the host runtime and authored content. */\n\tenvironment?: ServerRenderEnvironment;\n\t/**\n\t * Dedicated host-preparation hook for slot-aware SSR.\n\t *\n\t * Use this when the server needs to append or mutate authored light-DOM\n\t * nodes directly instead of passing `authoredContent` as a string.\n\t */\n\tprepareHost?: PrepareRenderedComponentHost<TComponent>;\n\t/**\n\t * Ambient SSR context entries that should be visible while the component is\n\t * instantiated and rendered.\n\t *\n\t * This solves standalone fragment renders that need to consume context from a\n\t * parent-like server environment.\n\t */\n\tssrContext?: readonly RenderComponentSsrContextEntry[];\n\t/** Clock override used by tests and adapters that need deterministic timestamps. */\n\tnow?: () => Date;\n\t/** JSX server-renderer options forwarded to `renderHostToString()`. */\n\trenderOptions?: RenderToStringOptions;\n\t/** Lazy asset resolver used when `assets` are not provided directly. */\n\tresolveAssets?: ResolveRenderedComponentAssets<TComponent>;\n\t/** Lazy client-module resolver used when `clientModuleSrc` is not provided directly. */\n\tresolveClientModuleSrc?: ResolveRenderedComponentClientModule<TComponent>;\n\t/** Explicit tag-name override when `@customElement(...)` metadata is not desired. */\n\ttagName?: string;\n};\n\n/** Options accepted by the reusable SSR component rendering helpers. */\nexport type RenderComponentOptions<TComponent extends ServerRenderableComponent> =\n\tRenderComponentSharedOptions<TComponent> &\n\t\t(\n\t\t\t| {\n\t\t\t\t\tcomponent: ServerRenderableComponentConstructor<TComponent>;\n\t\t\t  }\n\t\t\t| {\n\t\t\t\t\tload: () => Promise<ServerRenderableComponentConstructor<TComponent>>;\n\t\t\t  }\n\t\t);\n\n/** Call-site options used when the component constructor is passed directly. */\nexport type RenderComponentCallOptions<TComponent extends ServerRenderableComponent> =\n\tRenderComponentSharedOptions<TComponent>;\n\n/**\n * Serializes a custom element into HTML, inferring its tag name from\n * `@customElement(...)` metadata when the caller does not provide one.\n */\nexport function renderComponentToString<TComponent extends ServerRenderableComponent>(\n\tcomponent: ServerRenderableComponentConstructor<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<string>;\n\nexport function renderComponentToString<TComponent extends ServerRenderableComponent>(\n\toptions: RenderComponentOptions<TComponent>,\n): Promise<string>;\n\nexport async function renderComponentToString<TComponent extends ServerRenderableComponent>(\n\tcomponentOrOptions: ServerRenderableComponentConstructor<TComponent> | RenderComponentOptions<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<string> {\n\treturn (await renderResolvedComponent(normalizeRenderComponentOptions(componentOrOptions, options))).markup;\n}\n\n/**\n * Renders a custom element into the canonical portable server-rendered shape,\n * separating transport-agnostic metadata from any HTTP-specific adapter.\n */\nexport function renderComponent<TComponent extends ServerRenderableComponent>(\n\tcomponent: ServerRenderableComponentConstructor<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<RenderedComponent>;\n\nexport function renderComponent<TComponent extends ServerRenderableComponent>(\n\toptions: RenderComponentOptions<TComponent>,\n): Promise<RenderedComponent>;\n\nexport async function renderComponent<TComponent extends ServerRenderableComponent>(\n\tcomponentOrOptions: ServerRenderableComponentConstructor<TComponent> | RenderComponentOptions<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<RenderedComponent> {\n\treturn renderResolvedComponent(normalizeRenderComponentOptions(componentOrOptions, options));\n}\n\n/**\n * Serializes a custom element into a fragment payload that frameworks can\n * attach to any response shape they prefer.\n */\nexport function renderComponentToPayload<TComponent extends ServerRenderableComponent>(\n\tcomponent: ServerRenderableComponentConstructor<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<RenderedComponentPayload>;\n\nexport function renderComponentToPayload<TComponent extends ServerRenderableComponent>(\n\toptions: RenderComponentOptions<TComponent>,\n): Promise<RenderedComponentPayload>;\n\nexport async function renderComponentToPayload<TComponent extends ServerRenderableComponent>(\n\tcomponentOrOptions: ServerRenderableComponentConstructor<TComponent> | RenderComponentOptions<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<RenderedComponentPayload> {\n\treturn toRenderedComponentPayload(\n\t\tawait renderResolvedComponent(normalizeRenderComponentOptions(componentOrOptions, options)),\n\t);\n}\n\n/**\n * Renders a component into both fragment metadata and a JSX-compatible preview\n * value that can be embedded into a larger server-rendered shell.\n */\nexport function renderComponentWithPreview<TComponent extends ServerRenderableComponent>(\n\tcomponent: ServerRenderableComponentConstructor<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<RenderedComponentWithPreview>;\n\nexport function renderComponentWithPreview<TComponent extends ServerRenderableComponent>(\n\toptions: RenderComponentOptions<TComponent>,\n): Promise<RenderedComponentWithPreview>;\n\nexport async function renderComponentWithPreview<TComponent extends ServerRenderableComponent>(\n\tcomponentOrOptions: ServerRenderableComponentConstructor<TComponent> | RenderComponentOptions<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<RenderedComponentWithPreview> {\n\treturn toRenderedComponentWithPreview(\n\t\tawait renderResolvedComponent(normalizeRenderComponentOptions(componentOrOptions, options)),\n\t);\n}\n\nasync function renderResolvedComponent<TComponent extends ServerRenderableComponent>(\n\tnormalizedOptions: RenderComponentOptions<TComponent>,\n): Promise<RenderedComponent> {\n\tensureRadiantComponentSsrRuntimeRegistered();\n\n\tconst environment = normalizedOptions.environment ?? createServerRenderEnvironment();\n\tconst restoreAmbientContext = withSsrContextProviders(\n\t\tcreateAmbientSsrContextProviders(normalizedOptions.ssrContext),\n\t);\n\n\ttry {\n\t\tconst Component =\n\t\t\t'component' in normalizedOptions ? normalizedOptions.component : await normalizedOptions.load();\n\t\tconst component = new Component();\n\t\tprepareRenderedComponentHost(\n\t\t\tenvironment,\n\t\t\tcomponent,\n\t\t\tnormalizedOptions.authoredContent,\n\t\t\tnormalizedOptions.prepareHost,\n\t\t);\n\t\tnormalizedOptions.initialize?.(component);\n\n\t\tconst legacyClientModuleSrc =\n\t\t\tnormalizedOptions.clientModuleSrc ?? (await normalizedOptions.resolveClientModuleSrc?.(Component));\n\t\tconst resolvedAssets = normalizedOptions.assets ?? (await normalizedOptions.resolveAssets?.(Component)) ?? [];\n\t\tconst assets = mergeRenderedComponentAssets(resolvedAssets, legacyClientModuleSrc);\n\t\tconst clientModuleSrc = resolvePrimaryClientModuleSrc(assets) ?? legacyClientModuleSrc;\n\t\tconst tagName = normalizedOptions.tagName ?? resolveRenderedComponentTagName(Component);\n\t\tconst generatedAt = (normalizedOptions.now ?? createDefaultRenderTimestamp)().toISOString();\n\t\tconst renderOptions = normalizeRenderOptions(normalizedOptions.renderOptions);\n\t\tconst radiantSsrBridge = getRadiantComponentRenderBridge(component as unknown as RadiantComponentSsrCapable);\n\t\tconst markup =\n\t\t\tradiantSsrBridge?.renderHostToString?.(renderOptions) ?? component.renderHostToString(renderOptions);\n\t\tconst preview = resolveRenderedComponentPreview(component, radiantSsrBridge, markup);\n\n\t\treturn {\n\t\t\tmarkup,\n\t\t\tmetadata: {\n\t\t\t\tassets,\n\t\t\t\tclientModuleUrl: clientModuleSrc,\n\t\t\t\tgeneratedAt,\n\t\t\t\ttagName,\n\t\t\t},\n\t\t\tpreview,\n\t\t};\n\t} finally {\n\t\trestoreAmbientContext();\n\t}\n}\n\nfunction getRadiantComponentRenderBridge(\n\tcomponent: RadiantComponentSsrCapable,\n): RadiantComponentRenderBridge | undefined {\n\treturn getRadiantComponentSsrRuntime()?.resolveRenderBridge(component);\n}\n\n/**\n * Chooses the preview renderable returned by `renderComponent()`.\n *\n * When a component overrides only `renderHostToString()`, the inherited\n * `renderHost()` implementation would otherwise generate a different preview\n * tree than the final serialized markup. In that case the preview falls back to\n * the already-computed markup so shell composition stays aligned with the real\n * SSR output.\n */\nfunction resolveRenderedComponentPreview<TComponent extends ServerRenderableComponent>(\n\tcomponent: TComponent,\n\tradiantSsrBridge: RadiantComponentRenderBridge | undefined,\n\tmarkup: string,\n): JsxRenderable {\n\tif (!radiantSsrBridge) {\n\t\treturn component.renderHost?.() ?? { nodeType: 1, outerHTML: markup };\n\t}\n\n\tif (!radiantSsrBridge.renderHostToString && radiantSsrBridge.renderHost) {\n\t\treturn { nodeType: 1, outerHTML: markup };\n\t}\n\n\treturn radiantSsrBridge.renderHost?.() ?? component.renderHost?.() ?? { nodeType: 1, outerHTML: markup };\n}\n\nfunction prepareRenderedComponentHost<TComponent extends ServerRenderableComponent>(\n\tenvironment: ServerRenderEnvironment,\n\tcomponent: TComponent,\n\tauthoredContent: string | undefined,\n\tprepareHost: PrepareRenderedComponentHost<TComponent> | undefined,\n): void {\n\tif (!canPrepareSsrHost(component)) {\n\t\tif (authoredContent === undefined && prepareHost === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tthrow new Error(\n\t\t\t`${component.constructor.name} cannot prepare SSR host content because it does not expose an innerHTML host surface.`,\n\t\t);\n\t}\n\n\tenvironment.prepareHost(component, { authoredContent });\n\tprepareHost?.(component, environment);\n}\n\n/**\n * Wraps ad-hoc `ssrContext` values in provider-like objects so the existing SSR\n * context stack can resolve them exactly like real ancestor providers.\n */\nfunction createAmbientSsrContextProviders(\n\tentries: readonly RenderComponentSsrContextEntry[] | undefined,\n): SsrSerializableContextProvider[] {\n\tif (!entries || entries.length === 0) {\n\t\treturn [];\n\t}\n\n\treturn entries.map((entry) => ({\n\t\tgetContext: () => entry.value,\n\t\tgetContextKey: () => entry.context,\n\t\trenderHydrationScript: () => undefined,\n\t\trenderHydrationScriptTag: () => undefined,\n\t}));\n}\n\n/**\n * Drops the preview renderable so the result can be sent through lightweight\n * framework adapters or JSON/HTML fragment endpoints.\n */\nexport function toRenderedComponentPayload(\n\trender: RenderedComponentWithPreview | RenderedComponent,\n): RenderedComponentPayload {\n\tif ('metadata' in render) {\n\t\treturn {\n\t\t\tassets: render.metadata.assets,\n\t\t\tclientModuleSrc: render.metadata.clientModuleUrl,\n\t\t\tgeneratedAt: render.metadata.generatedAt,\n\t\t\tmarkup: render.markup,\n\t\t\ttagName: render.metadata.tagName,\n\t\t};\n\t}\n\n\tconst { preview: _preview, ...payload } = render;\n\treturn payload;\n}\n\n/**\n * Converts a rendered fragment payload into the standard metadata headers used\n * by client-side fragment loaders.\n */\nexport function createRenderedComponentHeaders(\n\trender: RenderedComponent | RenderedComponentMetadata | RenderedComponentPayload | RenderedComponentWithPreview,\n): Record<string, string> {\n\tconst metadata = toRenderedComponentMetadata(render);\n\n\treturn {\n\t\t...(metadata.assets.length > 0 ? { [RENDERED_COMPONENT_ASSETS_HEADER]: JSON.stringify(metadata.assets) } : {}),\n\t\t...(metadata.clientModuleUrl ? { [RENDERED_COMPONENT_CLIENT_MODULE_HEADER]: metadata.clientModuleUrl } : {}),\n\t\t[RENDERED_COMPONENT_GENERATED_AT_HEADER]: metadata.generatedAt,\n\t\t[RENDERED_COMPONENT_TAG_NAME_HEADER]: metadata.tagName,\n\t};\n}\n\nfunction toRenderedComponentMetadata(\n\trender: RenderedComponent | RenderedComponentMetadata | RenderedComponentPayload | RenderedComponentWithPreview,\n): RenderedComponentMetadata {\n\tif ('metadata' in render) {\n\t\treturn render.metadata;\n\t}\n\n\tif ('markup' in render) {\n\t\treturn {\n\t\t\tassets: render.assets ?? createLegacyRenderedComponentAssets(render.clientModuleSrc),\n\t\t\tclientModuleUrl: render.clientModuleSrc,\n\t\t\tgeneratedAt: render.generatedAt,\n\t\t\ttagName: render.tagName,\n\t\t};\n\t}\n\n\treturn render;\n}\n\nfunction toRenderedComponentWithPreview(render: RenderedComponent): RenderedComponentWithPreview {\n\treturn {\n\t\tassets: render.metadata.assets,\n\t\tclientModuleSrc: render.metadata.clientModuleUrl,\n\t\tgeneratedAt: render.metadata.generatedAt,\n\t\tmarkup: render.markup,\n\t\tpreview: render.preview,\n\t\ttagName: render.metadata.tagName,\n\t};\n}\n\nfunction createDefaultRenderTimestamp(): Date {\n\treturn new Date();\n}\n\nfunction createLegacyRenderedComponentAssets(clientModuleSrc: string | undefined): readonly RenderedComponentAsset[] {\n\tif (!clientModuleSrc) {\n\t\treturn [];\n\t}\n\n\treturn [scriptModuleAsset(clientModuleSrc)];\n}\n\nfunction mergeRenderedComponentAssets(\n\tassets: readonly RenderedComponentAsset[],\n\tlegacyClientModuleSrc: string | undefined,\n): readonly RenderedComponentAsset[] {\n\tif (!legacyClientModuleSrc) {\n\t\treturn assets;\n\t}\n\n\tif (assets.some((asset) => asset.kind === 'script-module' && asset.src === legacyClientModuleSrc)) {\n\t\treturn assets;\n\t}\n\n\treturn [...createLegacyRenderedComponentAssets(legacyClientModuleSrc), ...assets];\n}\n\nfunction resolvePrimaryClientModuleSrc(assets: readonly RenderedComponentAsset[]): string | undefined {\n\treturn assets.find((asset) => asset.kind === 'script-module')?.src;\n}\n\nfunction normalizeRenderComponentOptions<TComponent extends ServerRenderableComponent>(\n\tcomponentOrOptions: ServerRenderableComponentConstructor<TComponent> | RenderComponentOptions<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): RenderComponentOptions<TComponent> {\n\tif (typeof componentOrOptions === 'function') {\n\t\treturn {\n\t\t\t...options,\n\t\t\tcomponent: componentOrOptions,\n\t\t};\n\t}\n\n\treturn componentOrOptions;\n}\n\nfunction normalizeRenderOptions(options: RenderToStringOptions | undefined): RenderToStringOptions {\n\tif (options?.hydrate !== undefined) {\n\t\treturn options;\n\t}\n\n\treturn {\n\t\t...options,\n\t\thydrate: true,\n\t};\n}\n\nfunction canPrepareSsrHost<TComponent extends ServerRenderableComponent>(\n\tcomponent: TComponent,\n): component is TComponent & HTMLElement {\n\treturn 'innerHTML' in component;\n}\n\nfunction resolveRenderedComponentTagName(target: CustomElementConstructor): string {\n\tconst tagName = getCustomElementTagName(target);\n\n\tif (!tagName) {\n\t\tthrow new Error(`${target.name} is missing @customElement metadata.`);\n\t}\n\n\treturn tagName;\n}\n"
+  ],
+  "mappings": "+aAeO,DAAM,HAAyC,YAGzC,HAAqC,gBAGrC,HAA0C,qBAG1C,HAAmC,cAEhD,HAA2C,EA4BpC,SAAS,CAAiB,CAChC,EACA,EAA0C,UACjB,CACzB,MAAO,CAAE,KAAM,gBAAiB,MAAK,OAAM,EAIrC,SAAS,CAAkB,CAAC,EAAsC,CACxE,MAAO,CAAE,KAAM,gBAAiB,MAAK,EAI/B,SAAS,CAAU,CAAC,EAAc,EAAwC,CAChF,OAAO,EAAQ,CAAE,KAAM,QAAS,OAAM,OAAM,EAAI,CAAE,KAAM,QAAS,MAAK,EAoKvE,eAAsB,CAAqE,CAC1F,EACA,EACkB,CAClB,OAAQ,MAAM,EAAwB,EAAgC,EAAoB,CAAO,CAAC,GAAG,OAgBtG,eAAsB,CAA6D,CAClF,EACA,EAC6B,CAC7B,OAAO,EAAwB,EAAgC,EAAoB,CAAO,CAAC,EAgB5F,eAAsB,CAAsE,CAC3F,EACA,EACoC,CACpC,OAAO,EACN,MAAM,EAAwB,EAAgC,EAAoB,CAAO,CAAC,CAC3F,EAgBD,eAAsB,CAAwE,CAC7F,EACA,EACwC,CACxC,OAAO,EACN,MAAM,EAAwB,EAAgC,EAAoB,CAAO,CAAC,CAC3F,EAGD,eAAe,CAAqE,CACnF,EAC6B,CAC7B,EAA2C,EAE3C,IAAM,EAAc,EAAkB,aAAe,EAA8B,EAC7E,EAAwB,EAC7B,EAAiC,EAAkB,UAAU,CAC9D,EAEA,GAAI,CACH,IAAM,EACL,cAAe,EAAoB,EAAkB,UAAY,MAAM,EAAkB,KAAK,EACzF,EAAY,IAAI,EACtB,EACC,EACA,EACA,EAAkB,gBAClB,EAAkB,WACnB,EACA,EAAkB,aAAa,CAAS,EAExC,IAAM,EACL,EAAkB,iBAAoB,MAAM,EAAkB,yBAAyB,CAAS,EAC3F,EAAiB,EAAkB,QAAW,MAAM,EAAkB,gBAAgB,CAAS,GAAM,CAAC,EACtG,EAAS,EAA6B,EAAgB,CAAqB,EAC3E,EAAkB,EAA8B,CAAM,GAAK,EAC3D,EAAU,EAAkB,SAAW,EAAgC,CAAS,EAChF,GAAe,EAAkB,KAAO,GAA8B,EAAE,YAAY,EACpF,EAAgB,EAAuB,EAAkB,aAAa,EACtE,EAAmB,EAAgC,CAAkD,EACrG,EACL,GAAkB,qBAAqB,CAAa,GAAK,EAAU,mBAAmB,CAAa,EAC9F,EAAU,EAAgC,EAAW,EAAkB,CAAM,EAEnF,MAAO,CACN,SACA,SAAU,CACT,SACA,gBAAiB,EACjB,cACA,SACD,EACA,SACD,SACC,CACD,EAAsB,GAIxB,SAAS,CAA+B,CACvC,EAC2C,CAC3C,OAAO,EAA8B,GAAG,oBAAoB,CAAS,EAYtE,SAAS,CAA6E,CACrF,EACA,EACA,EACgB,CAChB,GAAI,CAAC,EACJ,OAAO,EAAU,aAAa,GAAK,CAAE,SAAU,EAAG,UAAW,CAAO,EAGrE,GAAI,CAAC,EAAiB,oBAAsB,EAAiB,WAC5D,MAAO,CAAE,SAAU,EAAG,UAAW,CAAO,EAGzC,OAAO,EAAiB,aAAa,GAAK,EAAU,aAAa,GAAK,CAAE,SAAU,EAAG,UAAW,CAAO,EAGxG,SAAS,CAA0E,CAClF,EACA,EACA,EACA,EACO,CACP,GAAI,CAAC,EAAkB,CAAS,EAAG,CAClC,GAAI,IAAoB,QAAa,IAAgB,OACpD,OAGD,MAAU,MACT,GAAG,EAAU,YAAY,4FAC1B,EAGD,EAAY,YAAY,EAAW,CAAE,iBAAgB,CAAC,EACtD,IAAc,EAAW,CAAW,EAOrC,SAAS,CAAgC,CACxC,EACmC,CACnC,GAAI,CAAC,GAAW,EAAQ,SAAW,EAClC,MAAO,CAAC,EAGT,OAAO,EAAQ,IAAI,CAAC,KAAW,CAC9B,WAAY,IAAM,EAAM,MACxB,cAAe,IAAM,EAAM,QAC3B,sBAAuB,IAAG,CAAG,QAC7B,yBAA0B,IAAG,CAAG,OACjC,EAAE,EAOI,SAAS,CAA0B,CACzC,EAC2B,CAC3B,GAAI,aAAc,EACjB,MAAO,CACN,OAAQ,EAAO,SAAS,OACxB,gBAAiB,EAAO,SAAS,gBACjC,YAAa,EAAO,SAAS,YAC7B,OAAQ,EAAO,OACf,QAAS,EAAO,SAAS,OAC1B,EAGD,IAAQ,QAAS,KAAa,GAAY,EAC1C,OAAO,EAOD,SAAS,CAA8B,CAC7C,EACyB,CACzB,IAAM,EAAW,EAA4B,CAAM,EAEnD,MAAO,IACF,EAAS,OAAO,OAAS,EAAI,EAAG,GAAmC,KAAK,UAAU,EAAS,MAAM,CAAE,EAAI,CAAC,KACxG,EAAS,gBAAkB,EAAG,GAA0C,EAAS,eAAgB,EAAI,CAAC,GACzG,GAAyC,EAAS,aAClD,GAAqC,EAAS,OAChD,EAGD,SAAS,CAA2B,CACnC,EAC4B,CAC5B,GAAI,aAAc,EACjB,OAAO,EAAO,SAGf,GAAI,WAAY,EACf,MAAO,CACN,OAAQ,EAAO,QAAU,EAAoC,EAAO,eAAe,EACnF,gBAAiB,EAAO,gBACxB,YAAa,EAAO,YACpB,QAAS,EAAO,OACjB,EAGD,OAAO,EAGR,SAAS,CAA8B,CAAC,EAAyD,CAChG,MAAO,CACN,OAAQ,EAAO,SAAS,OACxB,gBAAiB,EAAO,SAAS,gBACjC,YAAa,EAAO,SAAS,YAC7B,OAAQ,EAAO,OACf,QAAS,EAAO,QAChB,QAAS,EAAO,SAAS,OAC1B,EAGD,SAAS,CAA4B,EAAS,CAC7C,OAAO,IAAI,KAGZ,SAAS,CAAmC,CAAC,EAAwE,CACpH,GAAI,CAAC,EACJ,MAAO,CAAC,EAGT,MAAO,CAAC,EAAkB,CAAe,CAAC,EAG3C,SAAS,CAA4B,CACpC,EACA,EACoC,CACpC,GAAI,CAAC,EACJ,OAAO,EAGR,GAAI,EAAO,KAAK,CAAC,IAAU,EAAM,OAAS,iBAAmB,EAAM,MAAQ,CAAqB,EAC/F,OAAO,EAGR,MAAO,CAAC,GAAG,EAAoC,CAAqB,EAAG,GAAG,CAAM,EAGjF,SAAS,CAA6B,CAAC,EAA+D,CACrG,OAAO,EAAO,KAAK,CAAC,IAAU,EAAM,OAAS,eAAe,GAAG,IAGhE,SAAS,CAA6E,CACrF,EACA,EACqC,CACrC,GAAI,OAAO,IAAuB,WACjC,MAAO,IACH,EACH,UAAW,CACZ,EAGD,OAAO,EAGR,SAAS,CAAsB,CAAC,EAAmE,CAClG,GAAI,GAAS,UAAY,OACxB,OAAO,EAGR,MAAO,IACH,EACH,QAAS,EACV,EAGD,SAAS,CAA+D,CACvE,EACwC,CACxC,MAAO,cAAe,EAGvB,SAAS,CAA+B,CAAC,EAA0C,CAClF,IAAM,EAAU,EAAwB,CAAM,EAE9C,GAAI,CAAC,EACJ,MAAU,MAAM,GAAG,EAAO,0CAA0C,EAGrE,OAAO",
+  "debugId": "D8CA00B6DC44E8E864756E2164756E21",
+  "names": []
+}

package/dist/server/slot-projection-html.d.ts

@@ -0,0 +1,3 @@
+import { type JsxRenderable } from '@ecopages/jsx';
+export declare function parseProjectedSlotRenderablesFromHtml(html: string): Map<string, JsxRenderable[]>;
+export declare function collectAuthoredHydrationScriptMarkupFromHtml(html: string): string | undefined;

package/dist/server/slot-projection-html.js

@@ -0,0 +1,3 @@
+import{o as z}from"../chunk-5b1en9vz.js";import{hb as y,ib as B}from"../chunk-3xxvmd5c.js";import{pb as A}from"../chunk-hpzgnxgq.js";import"../chunk-nssj2x13.js";import"../chunk-vgtggzb6.js";import{createMarkupNodeLike as G}from"@ecopages/jsx";function W(q){let k=new Map;for(let v of z(q)){if(K(v))continue;I(k,J(v),G(v))}return k}function X(q){let k=z(q).filter((v)=>D(v));return k.length>0?k.join(""):void 0}function I(q,k,v){let w=q.get(k);if(w){w.push(v);return}q.set(k,[v])}function J(q){let k=/^<([A-Za-z][^\s/>]*)([^>]*)>/s.exec(q);if(!k)return y;let v=k[2]??"",w=/\sslot\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/i.exec(v);return w?.[1]??w?.[2]??w?.[3]??y}function K(q){return L(q)||D(q)}function L(q){let k=/^<script\b([^>]*)>/i.exec(q);if(!k)return!1;return E(k[1]??"",B)}function D(q){let k=/^<script\b([^>]*)>/i.exec(q);if(!k)return!1;return E(k[1]??"",A)}function E(q,k){return new RegExp(`(?:^|\\s)${k}(?:\\s*=\\s*(?:"[^"]*"|'[^']*'|[^\\s>]+))?`,"i").test(q)}export{W as parseProjectedSlotRenderablesFromHtml,X as collectAuthoredHydrationScriptMarkupFromHtml};
+
+//# debugId=26A47F455E55CA6F64756E2164756E21

package/dist/server/slot-projection-html.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/server/slot-projection-html.ts"],
+  "sourcesContent": [
+    "import { createMarkupNodeLike, type JsxRenderable } from '@ecopages/jsx';\n\nimport { HYDRATION_ATTRIBUTE } from '../core/hydration-codec';\nimport { DEFAULT_SLOT_NAME, SLOT_PROJECTION_SCRIPT_ATTRIBUTE } from '../core/slot-projection-runtime';\nimport { collectTopLevelHtmlFragments } from './html-parser';\n\nexport function parseProjectedSlotRenderablesFromHtml(html: string): Map<string, JsxRenderable[]> {\n\tconst projectedContent = new Map<string, JsxRenderable[]>();\n\n\tfor (const fragment of collectTopLevelHtmlFragments(html)) {\n\t\tif (isIgnoredProjectedHtmlFragment(fragment)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tappendProjectedRenderable(\n\t\t\tprojectedContent,\n\t\t\tgetSlotNameFromHtmlFragment(fragment),\n\t\t\tcreateMarkupNodeLike(fragment),\n\t\t);\n\t}\n\n\treturn projectedContent;\n}\n\nexport function collectAuthoredHydrationScriptMarkupFromHtml(html: string): string | undefined {\n\tconst fragments = collectTopLevelHtmlFragments(html).filter((fragment) => isHydrationScriptHtmlFragment(fragment));\n\n\treturn fragments.length > 0 ? fragments.join('') : undefined;\n}\n\nfunction appendProjectedRenderable(\n\tprojectedContent: Map<string, JsxRenderable[]>,\n\tslotName: string,\n\trenderable: JsxRenderable,\n): void {\n\tconst existingRenderables = projectedContent.get(slotName);\n\n\tif (existingRenderables) {\n\t\texistingRenderables.push(renderable);\n\t\treturn;\n\t}\n\n\tprojectedContent.set(slotName, [renderable]);\n}\n\nfunction getSlotNameFromHtmlFragment(fragment: string): string {\n\tconst openingTagMatch = /^<([A-Za-z][^\\s/>]*)([^>]*)>/s.exec(fragment);\n\n\tif (!openingTagMatch) {\n\t\treturn DEFAULT_SLOT_NAME;\n\t}\n\n\tconst attributes = openingTagMatch[2] ?? '';\n\tconst slotMatch = /\\sslot\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)'|([^\\s>]+))/i.exec(attributes);\n\n\treturn slotMatch?.[1] ?? slotMatch?.[2] ?? slotMatch?.[3] ?? DEFAULT_SLOT_NAME;\n}\n\nfunction isIgnoredProjectedHtmlFragment(fragment: string): boolean {\n\treturn isSlotProjectionScriptHtmlFragment(fragment) || isHydrationScriptHtmlFragment(fragment);\n}\n\nfunction isSlotProjectionScriptHtmlFragment(fragment: string): boolean {\n\tconst openingTagMatch = /^<script\\b([^>]*)>/i.exec(fragment);\n\n\tif (!openingTagMatch) {\n\t\treturn false;\n\t}\n\n\treturn hasScriptAttribute(openingTagMatch[1] ?? '', SLOT_PROJECTION_SCRIPT_ATTRIBUTE);\n}\n\nfunction isHydrationScriptHtmlFragment(fragment: string): boolean {\n\tconst openingTagMatch = /^<script\\b([^>]*)>/i.exec(fragment);\n\n\tif (!openingTagMatch) {\n\t\treturn false;\n\t}\n\n\treturn hasScriptAttribute(openingTagMatch[1] ?? '', HYDRATION_ATTRIBUTE);\n}\n\nfunction hasScriptAttribute(attributes: string, attributeName: string): boolean {\n\treturn new RegExp(`(?:^|\\\\s)${attributeName}(?:\\\\s*=\\\\s*(?:\"[^\"]*\"|'[^']*'|[^\\\\s>]+))?`, 'i').test(attributes);\n}\n"
+  ],
+  "mappings": "mNAAA,0BAAS,iBAMF,IAAS,JAAqC,CAAC,EAA4C,CACjG,IAAM,EAAmB,IAAI,IAE7B,QAAW,KAAY,EAA6B,CAAI,EAAG,CAC1D,GAAI,EAA+B,CAAQ,EAC1C,SAGD,EACC,EACA,EAA4B,CAAQ,EACpC,EAAqB,CAAQ,CAC9B,EAGD,OAAO,EAGD,SAAS,CAA4C,CAAC,EAAkC,CAC9F,IAAM,EAAY,EAA6B,CAAI,EAAE,OAAO,CAAC,IAAa,EAA8B,CAAQ,CAAC,EAEjH,OAAO,EAAU,OAAS,EAAI,EAAU,KAAK,EAAE,EAAI,OAGpD,SAAS,CAAyB,CACjC,EACA,EACA,EACO,CACP,IAAM,EAAsB,EAAiB,IAAI,CAAQ,EAEzD,GAAI,EAAqB,CACxB,EAAoB,KAAK,CAAU,EACnC,OAGD,EAAiB,IAAI,EAAU,CAAC,CAAU,CAAC,EAG5C,SAAS,CAA2B,CAAC,EAA0B,CAC9D,IAAM,EAAkB,gCAAgC,KAAK,CAAQ,EAErE,GAAI,CAAC,EACJ,OAAO,EAGR,IAAM,EAAa,EAAgB,IAAM,GACnC,EAAY,kDAAkD,KAAK,CAAU,EAEnF,OAAO,IAAY,IAAM,IAAY,IAAM,IAAY,IAAM,EAG9D,SAAS,CAA8B,CAAC,EAA2B,CAClE,OAAO,EAAmC,CAAQ,GAAK,EAA8B,CAAQ,EAG9F,SAAS,CAAkC,CAAC,EAA2B,CACtE,IAAM,EAAkB,sBAAsB,KAAK,CAAQ,EAE3D,GAAI,CAAC,EACJ,MAAO,GAGR,OAAO,EAAmB,EAAgB,IAAM,GAAI,CAAgC,EAGrF,SAAS,CAA6B,CAAC,EAA2B,CACjE,IAAM,EAAkB,sBAAsB,KAAK,CAAQ,EAE3D,GAAI,CAAC,EACJ,MAAO,GAGR,OAAO,EAAmB,EAAgB,IAAM,GAAI,CAAmB,EAGxE,SAAS,CAAkB,CAAC,EAAoB,EAAgC,CAC/E,OAAO,IAAI,OAAO,YAAY,8CAA2D,GAAG,EAAE,KAAK,CAAU",
+  "debugId": "26A47F455E55CA6F64756E2164756E21",
+  "names": []
+}

package/dist/signals/host-resource.d.ts

@@ -0,0 +1,59 @@
+import { type AsyncStateFetcherOptions, type AsyncStateResult } from '@ecopages/signals';
+import type { RadiantElement } from '../core/radiant-element';
+export type ResourceContext<Host extends RadiantElement> = {
+    host: Host;
+};
+export type ResourceRequestContext<Host extends RadiantElement> = ResourceContext<Host> & AsyncStateFetcherOptions;
+type HostResourceBaseConfig<Host extends RadiantElement, Value> = {
+    /** Seed value exposed from `data` before the first successful resolution. */
+    initialValue?: Value;
+    /** Milliseconds a successful response stays fresh in the per-instance cache. */
+    staleTime?: number;
+    /** Milliseconds to wait before transitioning `status` to `'pending'`. */
+    pendingDelay?: number;
+    /** Called after each successful resolution, including cache hits. */
+    onSuccess?: (data: Value, ctx: ResourceContext<Host>) => void;
+    /** Called after each failed resolution. Not called for aborted requests. */
+    onError?: (error: unknown, ctx: ResourceContext<Host>) => void;
+    /** Called after each resolution, whether successful or failed. */
+    onSettled?: (data: Value | undefined, error: unknown, ctx: ResourceContext<Host>) => void;
+};
+/** Configuration for a host-owned resource that fetches on connect. */
+export interface HostResourceConfig<Host extends RadiantElement, Value> extends HostResourceBaseConfig<Host, Value> {
+    fetcher: (ctx: ResourceRequestContext<Host>) => Promise<Value>;
+    source?: undefined;
+}
+/** Configuration for a host-owned resource driven by a reactive source. */
+export interface HostResourceSourcedConfig<Host extends RadiantElement, Source, Value> extends HostResourceBaseConfig<Host, Value> {
+    /**
+     * Returns the current source value while the host is connected.
+     *
+     * Falsy values (`false`, `null`, `undefined`) disable fetching and preserve
+     * the current resource state.
+     */
+    source: (ctx: ResourceContext<Host>) => Source | false | null | undefined;
+    fetcher: (sourceValue: Source, ctx: ResourceRequestContext<Host>) => Promise<Value>;
+}
+export declare class HostResource<Host extends RadiantElement, Value, Source = never> implements AsyncStateResult<Value> {
+    readonly data: AsyncStateResult<Value>['data'];
+    readonly status: AsyncStateResult<Value>['status'];
+    readonly error: AsyncStateResult<Value>['error'];
+    private readonly connected;
+    private readonly resource;
+    private disposed;
+    constructor(host: Host, config: HostResourceConfig<Host, Value> | HostResourceSourcedConfig<Host, Source, Value>);
+    connect(): void;
+    disconnect(): void;
+    refetch(): void;
+    abort(): void;
+    dispose(): void;
+}
+export declare function createHostResource<Host extends RadiantElement, Value>(host: Host, config: HostResourceConfig<Host, Value>): HostResource<Host, Value>;
+export declare function createHostResource<Host extends RadiantElement, Source, Value>(host: Host, config: HostResourceSourcedConfig<Host, Source, Value>): HostResource<Host, Value, Source>;
+/**
+ * Creates a host-owned resource and registers connect/disconnect lifecycle
+ * hooks on the provided host.
+ */
+export declare function createResource<Host extends RadiantElement, Value>(host: Host, config: HostResourceConfig<Host, Value>): HostResource<Host, Value>;
+export declare function createResource<Host extends RadiantElement, Source, Value>(host: Host, config: HostResourceSourcedConfig<Host, Source, Value>): HostResource<Host, Value, Source>;
+export {};

package/dist/signals/host-resource.js

@@ -0,0 +1,3 @@
+import"../chunk-vgtggzb6.js";import{asyncState as E,state as F}from"@ecopages/signals";class B{data;status;error;connected=F(!1);resource;disposed=!1;constructor(z,j){let m={host:z},D={initialValue:j.initialValue,pendingDelay:j.pendingDelay,staleTime:j.staleTime,onError:(q)=>{j.onError?.(q,m)},onSettled:(q,A)=>{j.onSettled?.(q,A,m)},onSuccess:(q)=>{j.onSuccess?.(q,m)}};if(j.source)this.resource=E({...D,source:()=>{if(this.disposed||!this.connected.get())return!1;return j.source(m)},fetcher:(q,A)=>j.fetcher(q,{...m,...A})});else this.resource=E({...D,source:()=>{if(this.disposed||!this.connected.get())return!1;return!0},fetcher:(q,A)=>j.fetcher({...m,...A})});this.data=this.resource.data,this.status=this.resource.status,this.error=this.resource.error}connect(){if(this.disposed||this.connected.get())return;this.connected.set(!0)}disconnect(){if(this.disposed||!this.connected.get())return;this.connected.set(!1),this.resource.abort()}refetch(){if(this.disposed||!this.connected.get())return;this.resource.refetch()}abort(){if(this.disposed)return;this.resource.abort()}dispose(){if(this.disposed)return;this.disposed=!0,this.connected.set(!1),this.resource.dispose()}}function I(z,j){return new B(z,j)}function J(z,j){let m=new B(z,j);return z.registerConnectedCallback(()=>{m.connect()}),z.registerCleanupCallback(()=>{m.disconnect()}),m}export{J as createResource,I as createHostResource,B as HostResource};
+
+//# debugId=BAFAE3A89A400A8364756E2164756E21

package/dist/signals/host-resource.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/signals/host-resource.ts"],
+  "sourcesContent": [
+    "import { asyncState, state, type AsyncStateFetcherOptions, type AsyncStateResult } from '@ecopages/signals';\nimport type { RadiantElement } from '../core/radiant-element';\n\nexport type ResourceContext<Host extends RadiantElement> = {\n\thost: Host;\n};\n\nexport type ResourceRequestContext<Host extends RadiantElement> = ResourceContext<Host> & AsyncStateFetcherOptions;\n\ntype HostResourceBaseConfig<Host extends RadiantElement, Value> = {\n\t/** Seed value exposed from `data` before the first successful resolution. */\n\tinitialValue?: Value;\n\n\t/** Milliseconds a successful response stays fresh in the per-instance cache. */\n\tstaleTime?: number;\n\n\t/** Milliseconds to wait before transitioning `status` to `'pending'`. */\n\tpendingDelay?: number;\n\n\t/** Called after each successful resolution, including cache hits. */\n\tonSuccess?: (data: Value, ctx: ResourceContext<Host>) => void;\n\n\t/** Called after each failed resolution. Not called for aborted requests. */\n\tonError?: (error: unknown, ctx: ResourceContext<Host>) => void;\n\n\t/** Called after each resolution, whether successful or failed. */\n\tonSettled?: (data: Value | undefined, error: unknown, ctx: ResourceContext<Host>) => void;\n};\n\n/** Configuration for a host-owned resource that fetches on connect. */\nexport interface HostResourceConfig<Host extends RadiantElement, Value> extends HostResourceBaseConfig<Host, Value> {\n\tfetcher: (ctx: ResourceRequestContext<Host>) => Promise<Value>;\n\tsource?: undefined;\n}\n\n/** Configuration for a host-owned resource driven by a reactive source. */\nexport interface HostResourceSourcedConfig<Host extends RadiantElement, Source, Value> extends HostResourceBaseConfig<\n\tHost,\n\tValue\n> {\n\t/**\n\t * Returns the current source value while the host is connected.\n\t *\n\t * Falsy values (`false`, `null`, `undefined`) disable fetching and preserve\n\t * the current resource state.\n\t */\n\tsource: (ctx: ResourceContext<Host>) => Source | false | null | undefined;\n\n\tfetcher: (sourceValue: Source, ctx: ResourceRequestContext<Host>) => Promise<Value>;\n}\n\nexport class HostResource<Host extends RadiantElement, Value, Source = never> implements AsyncStateResult<Value> {\n\treadonly data: AsyncStateResult<Value>['data'];\n\treadonly status: AsyncStateResult<Value>['status'];\n\treadonly error: AsyncStateResult<Value>['error'];\n\n\tprivate readonly connected = state(false);\n\tprivate readonly resource: AsyncStateResult<Value>;\n\tprivate disposed = false;\n\n\tconstructor(host: Host, config: HostResourceConfig<Host, Value> | HostResourceSourcedConfig<Host, Source, Value>) {\n\t\tconst context: ResourceContext<Host> = { host };\n\t\tconst baseConfig = {\n\t\t\tinitialValue: config.initialValue,\n\t\t\tpendingDelay: config.pendingDelay,\n\t\t\tstaleTime: config.staleTime,\n\t\t\tonError: (error: unknown) => {\n\t\t\t\tconfig.onError?.(error, context);\n\t\t\t},\n\t\t\tonSettled: (data: Value | undefined, error: unknown) => {\n\t\t\t\tconfig.onSettled?.(data, error, context);\n\t\t\t},\n\t\t\tonSuccess: (data: Value) => {\n\t\t\t\tconfig.onSuccess?.(data, context);\n\t\t\t},\n\t\t};\n\n\t\tif (config.source) {\n\t\t\tthis.resource = asyncState({\n\t\t\t\t...baseConfig,\n\t\t\t\tsource: () => {\n\t\t\t\t\tif (this.disposed || !this.connected.get()) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\n\t\t\t\t\treturn config.source(context);\n\t\t\t\t},\n\t\t\t\tfetcher: (sourceValue, options) => config.fetcher(sourceValue as Source, { ...context, ...options }),\n\t\t\t});\n\t\t} else {\n\t\t\tthis.resource = asyncState({\n\t\t\t\t...baseConfig,\n\t\t\t\tsource: () => {\n\t\t\t\t\tif (this.disposed || !this.connected.get()) {\n\t\t\t\t\t\treturn false;\n\t\t\t\t\t}\n\n\t\t\t\t\treturn true;\n\t\t\t\t},\n\t\t\t\tfetcher: (_connected, options) => config.fetcher({ ...context, ...options }),\n\t\t\t});\n\t\t}\n\n\t\tthis.data = this.resource.data;\n\t\tthis.status = this.resource.status;\n\t\tthis.error = this.resource.error;\n\t}\n\n\tpublic connect(): void {\n\t\tif (this.disposed || this.connected.get()) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.connected.set(true);\n\t}\n\n\tpublic disconnect(): void {\n\t\tif (this.disposed || !this.connected.get()) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.connected.set(false);\n\t\tthis.resource.abort();\n\t}\n\n\tpublic refetch(): void {\n\t\tif (this.disposed || !this.connected.get()) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.resource.refetch();\n\t}\n\n\tpublic abort(): void {\n\t\tif (this.disposed) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.resource.abort();\n\t}\n\n\tpublic dispose(): void {\n\t\tif (this.disposed) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.disposed = true;\n\t\tthis.connected.set(false);\n\t\tthis.resource.dispose();\n\t}\n}\n\nexport function createHostResource<Host extends RadiantElement, Value>(\n\thost: Host,\n\tconfig: HostResourceConfig<Host, Value>,\n): HostResource<Host, Value>;\nexport function createHostResource<Host extends RadiantElement, Source, Value>(\n\thost: Host,\n\tconfig: HostResourceSourcedConfig<Host, Source, Value>,\n): HostResource<Host, Value, Source>;\nexport function createHostResource<Host extends RadiantElement, Source, Value>(\n\thost: Host,\n\tconfig: HostResourceConfig<Host, Value> | HostResourceSourcedConfig<Host, Source, Value>,\n): HostResource<Host, Value, Source> {\n\treturn new HostResource<Host, Value, Source>(host, config);\n}\n\n/**\n * Creates a host-owned resource and registers connect/disconnect lifecycle\n * hooks on the provided host.\n */\nexport function createResource<Host extends RadiantElement, Value>(\n\thost: Host,\n\tconfig: HostResourceConfig<Host, Value>,\n): HostResource<Host, Value>;\nexport function createResource<Host extends RadiantElement, Source, Value>(\n\thost: Host,\n\tconfig: HostResourceSourcedConfig<Host, Source, Value>,\n): HostResource<Host, Value, Source>;\nexport function createResource<Host extends RadiantElement, Source, Value>(\n\thost: Host,\n\tconfig: HostResourceConfig<Host, Value> | HostResourceSourcedConfig<Host, Source, Value>,\n): HostResource<Host, Value, Source> {\n\tconst hostResource = new HostResource<Host, Value, Source>(host, config);\n\n\thost.registerConnectedCallback(() => {\n\t\thostResource.connect();\n\t});\n\n\thost.registerCleanupCallback(() => {\n\t\thostResource.disconnect();\n\t});\n\n\treturn hostResource;\n}\n"
+  ],
+  "mappings": "6BAAA,qBAAS,WAAY,0BAmDd,MAAM,CAAoG,CACvG,KACA,OACA,MAEQ,UAAY,EAAM,EAAK,EACvB,SACT,SAAW,GAEnB,WAAW,CAAC,EAAY,EAA0F,CACjH,IAAM,EAAiC,CAAE,MAAK,EACxC,EAAa,CAClB,aAAc,EAAO,aACrB,aAAc,EAAO,aACrB,UAAW,EAAO,UAClB,QAAS,CAAC,IAAmB,CAC5B,EAAO,UAAU,EAAO,CAAO,GAEhC,UAAW,CAAC,EAAyB,IAAmB,CACvD,EAAO,YAAY,EAAM,EAAO,CAAO,GAExC,UAAW,CAAC,IAAgB,CAC3B,EAAO,YAAY,EAAM,CAAO,EAElC,EAEA,GAAI,EAAO,OACV,KAAK,SAAW,EAAW,IACvB,EACH,OAAQ,IAAM,CACb,GAAI,KAAK,UAAY,CAAC,KAAK,UAAU,IAAI,EACxC,MAAO,GAGR,OAAO,EAAO,OAAO,CAAO,GAE7B,QAAS,CAAC,EAAa,IAAY,EAAO,QAAQ,EAAuB,IAAK,KAAY,CAAQ,CAAC,CACpG,CAAC,EAED,UAAK,SAAW,EAAW,IACvB,EACH,OAAQ,IAAM,CACb,GAAI,KAAK,UAAY,CAAC,KAAK,UAAU,IAAI,EACxC,MAAO,GAGR,MAAO,IAER,QAAS,CAAC,EAAY,IAAY,EAAO,QAAQ,IAAK,KAAY,CAAQ,CAAC,CAC5E,CAAC,EAGF,KAAK,KAAO,KAAK,SAAS,KAC1B,KAAK,OAAS,KAAK,SAAS,OAC5B,KAAK,MAAQ,KAAK,SAAS,MAGrB,OAAO,EAAS,CACtB,GAAI,KAAK,UAAY,KAAK,UAAU,IAAI,EACvC,OAGD,KAAK,UAAU,IAAI,EAAI,EAGjB,UAAU,EAAS,CACzB,GAAI,KAAK,UAAY,CAAC,KAAK,UAAU,IAAI,EACxC,OAGD,KAAK,UAAU,IAAI,EAAK,EACxB,KAAK,SAAS,MAAM,EAGd,OAAO,EAAS,CACtB,GAAI,KAAK,UAAY,CAAC,KAAK,UAAU,IAAI,EACxC,OAGD,KAAK,SAAS,QAAQ,EAGhB,KAAK,EAAS,CACpB,GAAI,KAAK,SACR,OAGD,KAAK,SAAS,MAAM,EAGd,OAAO,EAAS,CACtB,GAAI,KAAK,SACR,OAGD,KAAK,SAAW,GAChB,KAAK,UAAU,IAAI,EAAK,EACxB,KAAK,SAAS,QAAQ,EAExB,CAUO,SAAS,CAA8D,CAC7E,EACA,EACoC,CACpC,OAAO,IAAI,EAAkC,EAAM,CAAM,EAenD,SAAS,CAA0D,CACzE,EACA,EACoC,CACpC,IAAM,EAAe,IAAI,EAAkC,EAAM,CAAM,EAUvE,OARA,EAAK,0BAA0B,IAAM,CACpC,EAAa,QAAQ,EACrB,EAED,EAAK,wBAAwB,IAAM,CAClC,EAAa,WAAW,EACxB,EAEM",
+  "debugId": "BAFAE3A89A400A8364756E2164756E21",
+  "names": []
+}

package/dist/signals/host-signal.d.ts

@@ -0,0 +1,45 @@
+import { type JsxRenderable } from '@ecopages/jsx';
+import { type WritableSignal } from '@ecopages/signals';
+import type { SsrSerializableHydrationBinding } from '../core/ssr-hydration-binding';
+import type { RadiantElement } from '../core/radiant-element';
+import type { AttributeTypeConstant } from '../utils/attribute-utils';
+type HostSignalOptions<Value> = {
+    host: RadiantElement;
+    hydrate?: AttributeTypeConstant;
+    hydrationKey?: string;
+    initialValue?: Value;
+    property: string;
+    source?: WritableSignal<Value>;
+};
+export declare function isWritableSignalLike<Value>(value: unknown): value is WritableSignal<Value>;
+/**
+ * Host-owned writable signal that bridges signal updates back into Radiant's
+ * update callback channel and optional SSR hydration pipeline.
+ */
+export declare class HostSignal<Value> implements WritableSignal<Value>, SsrSerializableHydrationBinding {
+    private readonly host;
+    private readonly hydrate?;
+    private readonly hydrationKey?;
+    private readonly property;
+    private readonly source;
+    private currentValue;
+    private hasAppliedHostHydration;
+    private sourceUnsubscribe?;
+    constructor(options: HostSignalOptions<Value>);
+    get(): Value;
+    set(nextValue: Value): void;
+    subscribe(notify: (value: Value) => void): () => void;
+    update(updater: (value: Value) => Value): void;
+    connectToSource(): void;
+    disconnectFromSource(): void;
+    hydrateFromHost(): void;
+    renderHydrationScript(): JsxRenderable | undefined;
+    renderHydrationScriptTag(): string | undefined;
+    private findHydrationScriptElement;
+    private isObject;
+    private resolveInitialValue;
+    private serializeHydrationValue;
+    private handleSourceChange;
+}
+export declare function createHostSignal<Value>(options: HostSignalOptions<Value>): HostSignal<Value>;
+export {};

package/dist/signals/host-signal.js

@@ -0,0 +1,3 @@
+import{Ea as a,Fa as b,Ga as c}from"../chunk-nnnb6pac.js";import"../chunk-dabagjk6.js";import"../chunk-hpzgnxgq.js";import"../chunk-nssj2x13.js";import"../chunk-vgtggzb6.js";export{a as isWritableSignalLike,c as createHostSignal,b as HostSignal};
+
+//# debugId=8C425FB12C13013F64756E2164756E21

package/dist/signals/host-signal.js.map

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

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

@@ -0,0 +1,7 @@
+/** Creates the raw `<script type="application/json">` tag used to hydrate a signal field. */
+export declare function createSignalHydrationScriptTag(options: {
+    hydrationKey?: string;
+    serializedValue: string;
+}): string;
+/** Escapes serialized JSON so it remains safe inside an HTML script tag. */
+export declare function escapeSignalHydrationJson(value: string): string;

package/dist/signals/hydration-script.js

@@ -0,0 +1,3 @@
+import{Ha as a,Ia as b}from"../chunk-dabagjk6.js";import"../chunk-hpzgnxgq.js";import"../chunk-nssj2x13.js";import"../chunk-vgtggzb6.js";export{b as escapeSignalHydrationJson,a as createSignalHydrationScriptTag};
+
+//# debugId=5F47A97415912E6864756E2164756E21

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

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

package/dist/tools/escape-script-json.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Escapes serialized JSON so it remains safe when embedded inside an HTML
+ * `<script>` tag.
+ */
+export declare function escapeScriptJson(value: string): string;

package/dist/tools/escape-script-json.js

@@ -0,0 +1,3 @@
+import{wb as a}from"../chunk-nssj2x13.js";import"../chunk-vgtggzb6.js";export{a as escapeScriptJson};
+
+//# debugId=41664B185705318B64756E2164756E21

package/dist/tools/escape-script-json.js.map

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

package/dist/tools/event-emitter.js

@@ -1,4 +1,3 @@
-class x{host;eventConfig;constructor(k,q){this.host=k,this.eventConfig=q}emit(k){const q=new CustomEvent(this.eventConfig.name,{detail:k,bubbles:this.eventConfig.bubbles,cancelable:this.eventConfig.cancelable,composed:this.eventConfig.composed});this.host.dispatchEvent(q)}}export{x as EventEmitter};
-export{x as U};
+import{yb as a}from"../chunk-wvd1ffe4.js";import"../chunk-vgtggzb6.js";export{a as EventEmitter};
 
-//# debugId=6E8CC678827C651864756E2164756E21
+//# debugId=139B84C5FD630AF664756E2164756E21

package/dist/tools/event-emitter.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/tools/event-emitter.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '../core/radiant-element';\n\nexport interface EventEmitterConfig {\n  name: string;\n  bubbles?: boolean;\n  cancelable?: boolean;\n  composed?: boolean;\n}\n\n/**\n * A generic event emitter class that allows emitting custom events.\n *\n * @template T - The type of the event detail.\n */\nexport class EventEmitter<T = unknown> {\n  private host: RadiantElement;\n  private eventConfig: EventEmitterConfig;\n\n  /**\n   * Constructs a new instance of the EventEmitter class.\n   *\n   * @param host - The host element on which the events will be dispatched.\n   * @param eventConfig - The configuration for the event.\n   */\n  constructor(host: RadiantElement, eventConfig: EventEmitterConfig) {\n    this.host = host;\n    this.eventConfig = eventConfig;\n  }\n\n  /**\n   * Emits a custom event with the specified detail.\n   *\n   * @param detail - The detail object to be passed along with the event.\n   */\n  emit(detail?: T) {\n    const event = new CustomEvent(this.eventConfig.name, {\n      detail: detail,\n      bubbles: this.eventConfig.bubbles,\n      cancelable: this.eventConfig.cancelable,\n      composed: this.eventConfig.composed,\n    });\n    this.host.dispatchEvent(event);\n  }\n}\n"
   ],
-  "mappings": "AAcO,MAAM,CAA0B,CAC7B,KACA,YAQR,WAAW,CAAC,EAAsB,EAAiC,CACjE,KAAK,KAAO,EACZ,KAAK,YAAc,EAQrB,IAAI,CAAC,EAAY,CACf,MAAM,EAAQ,IAAI,YAAY,KAAK,YAAY,KAAM,CACnD,OAAQ,EACR,QAAS,KAAK,YAAY,QAC1B,WAAY,KAAK,YAAY,WAC7B,SAAU,KAAK,YAAY,QAC7B,CAAC,EACD,KAAK,KAAK,cAAc,CAAK,EAEjC",
-  "debugId": "6E8CC678827C651864756E2164756E21",
+  "mappings": "",
+  "debugId": "139B84C5FD630AF664756E2164756E21",
   "names": []
 }

package/dist/tools/index.d.ts

@@ -1,2 +1,4 @@
 export * from './stringify-typed';
 export * from './event-emitter';
+export * from './render-jsx-template';
+export * from './escape-script-json';

package/dist/tools/index.js

@@ -1,3 +1,3 @@
-import{c as m}from"./stringify-typed.js";import{U as f}from"./event-emitter.js";export{m as stringifyTyped,f as EventEmitter};
+import{a as x}from"../chunk-jkb2y7c8.js";import{b as a}from"../chunk-cvz9mrxa.js";import{wb as p}from"../chunk-nssj2x13.js";import{yb as t}from"../chunk-wvd1ffe4.js";import"../chunk-vgtggzb6.js";export{a as stringifyTyped,x as renderJsxTemplate,p as escapeScriptJson,t as EventEmitter};
 
-//# debugId=05F38D407380E35D64756E2164756E21
+//# debugId=328891D7088CB96064756E2164756E21

package/dist/tools/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "05F38D407380E35D64756E2164756E21",
+  "debugId": "328891D7088CB96064756E2164756E21",
   "names": []
 }

package/dist/tools/render-jsx-template.d.ts

@@ -0,0 +1,5 @@
+import { type TemplateResultLike } from '@ecopages/jsx';
+/**
+ * Renders a JSX template result into a target element by replacing its children.
+ */
+export declare function renderJsxTemplate(template: TemplateResultLike, target: HTMLElement): void;

package/dist/tools/render-jsx-template.js

@@ -0,0 +1,3 @@
+import{a}from"../chunk-jkb2y7c8.js";import"../chunk-vgtggzb6.js";export{a as renderJsxTemplate};
+
+//# debugId=33BF6AD35B27EB1564756E2164756E21

package/dist/tools/render-jsx-template.js.map

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

package/dist/tools/stringify-typed.d.ts

@@ -7,12 +7,10 @@
  * @template R - The return type, defaults to T.
  *
  * @example
- * // For JSON string representation
- * <script type="application/json" data-hydration>
- *  {stringifyTyped<Partial<MyContext>, string>({ value: 'Hello World' })}
- * </script>
- *
- * // For maintaining the type
+ * // For maintaining the type in JSX attributes
  * <my-app my-complex-attribute={stringifyTyped<MyType>(myData)}> // myData is of type MyType
+ *
+ * // For lower-level JSON string generation outside JSX text children
+ * const hydrationPayload = stringifyTyped<Partial<MyContext>, string>({ value: 'Hello World' });
  */
 export declare function stringifyTyped<T, R = T>(value: T): R extends string ? string : T;

package/dist/tools/stringify-typed.js

@@ -1,4 +1,3 @@
-function t(e){return JSON.stringify(e)}export{t as stringifyTyped};
-export{t as c};
+import{b as a}from"../chunk-cvz9mrxa.js";import"../chunk-vgtggzb6.js";export{a as stringifyTyped};
 
-//# debugId=EC5CECAE80ACC8C364756E2164756E21
+//# debugId=3F8DDB103AAD885E64756E2164756E21