@ecopages/radiant 0.1.8 → 0.3.0-alpha.0

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 { 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';\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\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 StreamableRenderedComponent = 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 renderStreamableComponent<TComponent extends ServerRenderableComponent>(\n\tcomponent: ServerRenderableComponentConstructor<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<StreamableRenderedComponent>;\n\nexport function renderStreamableComponent<TComponent extends ServerRenderableComponent>(\n\toptions: RenderComponentOptions<TComponent>,\n): Promise<StreamableRenderedComponent>;\n\nexport async function renderStreamableComponent<TComponent extends ServerRenderableComponent>(\n\tcomponentOrOptions: ServerRenderableComponentConstructor<TComponent> | RenderComponentOptions<TComponent>,\n\toptions?: RenderComponentCallOptions<TComponent>,\n): Promise<StreamableRenderedComponent> {\n\treturn toStreamableRenderedComponent(\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\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 markup = component.renderHostToString(renderOptions);\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: component.renderHost?.() ?? { nodeType: 1, outerHTML: markup },\n\t\t};\n\t} finally {\n\t\trestoreAmbientContext();\n\t}\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: StreamableRenderedComponent | 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 | StreamableRenderedComponent,\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 | StreamableRenderedComponent,\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 toStreamableRenderedComponent(render: RenderedComponent): StreamableRenderedComponent {\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": "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",
+  "debugId": "E62B78C0A966A7EC64756E2164756E21",
+  "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-8xy18qmz.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{qa as a,ra as b,sa as c}from"../chunk-57w3vmme.js";import"../chunk-6z34stya.js";import"../chunk-ksv01cey.js";import"../chunk-8n2dhx28.js";import"../chunk-8xy18qmz.js";export{a as isWritableSignalLike,c as createHostSignal,b as HostSignal};
+
+//# debugId=2AA2BC54FCAB364764756E2164756E21

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

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

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

@@ -0,0 +1,11 @@
+/** @deprecated Use `HYDRATION_ATTRIBUTE` from `hydration-codec` instead. */
+export declare const SIGNAL_HYDRATION_ATTRIBUTE = "data-hydration";
+/** @deprecated Use `HYDRATION_KEY_ATTRIBUTE` from `hydration-codec` instead. */
+export declare const SIGNAL_HYDRATION_KEY_ATTRIBUTE = "data-hydration-key";
+/** 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{cb as a,db as b,eb as c,fb as d}from"../chunk-6z34stya.js";import"../chunk-ksv01cey.js";import"../chunk-8n2dhx28.js";import"../chunk-8xy18qmz.js";export{d as escapeSignalHydrationJson,c as createSignalHydrationScriptTag,b as SIGNAL_HYDRATION_KEY_ATTRIBUTE,a as SIGNAL_HYDRATION_ATTRIBUTE};
+
+//# debugId=DA0DC63B2C1C6FBA64756E2164756E21

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

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "DA0DC63B2C1C6FBA64756E2164756E21",
+  "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{nb as a}from"../chunk-8n2dhx28.js";import"../chunk-8xy18qmz.js";export{a as escapeScriptJson};
+
+//# debugId=4BF5FF15BAECE12164756E2164756E21

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

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

package/dist/tools/event-emitter.d.ts

@@ -1,4 +1,4 @@
-import type { RadiantElement } from '..';
+import type { RadiantElement } from '../core/radiant-element';
 export interface EventEmitterConfig {
     name: string;
     bubbles?: boolean;

package/dist/tools/event-emitter.js

@@ -1,23 +1,3 @@
-// src/tools/event-emitter.ts
-class EventEmitter {
-  host;
-  eventConfig;
-  constructor(host, eventConfig) {
-    this.host = host;
-    this.eventConfig = eventConfig;
-  }
-  emit(detail) {
-    const event = new CustomEvent(this.eventConfig.name, {
-      detail,
-      bubbles: this.eventConfig.bubbles,
-      cancelable: this.eventConfig.cancelable,
-      composed: this.eventConfig.composed
-    });
-    this.host.dispatchEvent(event);
-  }
-}
-export {
-  EventEmitter
-};
+import{pb as a}from"../chunk-qbnedp0y.js";import"../chunk-8xy18qmz.js";export{a as EventEmitter};
 
-//# debugId=B011F9EC3CC948C064756E2164756E21
+//# debugId=B03DE8507783D08B64756E2164756E21

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 '..';\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,aAA0B;AAAA,EAC7B;AAAA,EACA;AAAA,EAQR,WAAW,CAAC,MAAsB,aAAiC;AACjE,SAAK,OAAO;AACZ,SAAK,cAAc;AAAA;AAAA,EAQrB,IAAI,CAAC,QAAY;AACf,UAAM,QAAQ,IAAI,YAAY,KAAK,YAAY,MAAM;AAAA,MACnD;AAAA,MACA,SAAS,KAAK,YAAY;AAAA,MAC1B,YAAY,KAAK,YAAY;AAAA,MAC7B,UAAU,KAAK,YAAY;AAAA,IAC7B,CAAC;AACD,SAAK,KAAK,cAAc,KAAK;AAAA;AAEjC;",
-  "debugId": "B011F9EC3CC948C064756E2164756E21",
+  "mappings": "",
+  "debugId": "B03DE8507783D08B64756E2164756E21",
   "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,29 +1,3 @@
-// src/tools/event-emitter.ts
-class EventEmitter {
-  host;
-  eventConfig;
-  constructor(host, eventConfig) {
-    this.host = host;
-    this.eventConfig = eventConfig;
-  }
-  emit(detail) {
-    const event = new CustomEvent(this.eventConfig.name, {
-      detail,
-      bubbles: this.eventConfig.bubbles,
-      cancelable: this.eventConfig.cancelable,
-      composed: this.eventConfig.composed
-    });
-    this.host.dispatchEvent(event);
-  }
-}
+import{a as x}from"../chunk-jkb2y7c8.js";import{b as a}from"../chunk-cvz9mrxa.js";import{nb as p}from"../chunk-8n2dhx28.js";import{pb as t}from"../chunk-qbnedp0y.js";import"../chunk-8xy18qmz.js";export{a as stringifyTyped,x as renderJsxTemplate,p as escapeScriptJson,t as EventEmitter};
 
-// src/tools/stringify-typed.ts
-function stringifyTyped(value) {
-  return JSON.stringify(value);
-}
-export {
-  stringifyTyped,
-  EventEmitter
-};
-
-//# debugId=A516128E55704E8064756E2164756E21
+//# debugId=0C1BEF13FC1B648864756E2164756E21

package/dist/tools/index.js.map

@@ -1,11 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/tools/event-emitter.ts", "../src/tools/stringify-typed.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { RadiantElement } from '..';\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",
-    "/**\n * Converts the given value to a JSON string representation or maintains the type based on the generic parameter.\n *\n * @param value - The value to be converted.\n * @returns The JSON string representation of the value or the value itself.\n * @template T - The type of the value.\n * @template R - The return type, defaults to T.\n *\n * @example\n * // For JSON string representation\n * <script type=\"application/json\" data-hydration>\n *  {stringifyTyped<Partial<MyContext>, string>({ value: 'Hello World' })}\n * </script>\n *\n * // For maintaining the type\n * <my-app my-complex-attribute={stringifyTyped<MyType>(myData)}> // myData is of type MyType\n */\nexport function stringifyTyped<T, R = T>(value: T): R extends string ? string : T {\n  return JSON.stringify(value) as unknown as R extends string ? string : T;\n}\n"
   ],
-  "mappings": ";AAcO,MAAM,aAA0B;AAAA,EAC7B;AAAA,EACA;AAAA,EAQR,WAAW,CAAC,MAAsB,aAAiC;AACjE,SAAK,OAAO;AACZ,SAAK,cAAc;AAAA;AAAA,EAQrB,IAAI,CAAC,QAAY;AACf,UAAM,QAAQ,IAAI,YAAY,KAAK,YAAY,MAAM;AAAA,MACnD;AAAA,MACA,SAAS,KAAK,YAAY;AAAA,MAC1B,YAAY,KAAK,YAAY;AAAA,MAC7B,UAAU,KAAK,YAAY;AAAA,IAC7B,CAAC;AACD,SAAK,KAAK,cAAc,KAAK;AAAA;AAEjC;;;AC1BO,SAAS,cAAwB,CAAC,OAAyC;AAChF,SAAO,KAAK,UAAU,KAAK;AAAA;",
-  "debugId": "A516128E55704E8064756E2164756E21",
+  "mappings": "",
+  "debugId": "0C1BEF13FC1B648864756E2164756E21",
   "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-8xy18qmz.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,9 +1,3 @@
-// src/tools/stringify-typed.ts
-function stringifyTyped(value) {
-  return JSON.stringify(value);
-}
-export {
-  stringifyTyped
-};
+import{b as a}from"../chunk-cvz9mrxa.js";import"../chunk-8xy18qmz.js";export{a as stringifyTyped};
 
-//# debugId=4776E3D8D4175B4F64756E2164756E21
+//# debugId=3F8DDB103AAD885E64756E2164756E21

package/dist/tools/stringify-typed.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/tools/stringify-typed.ts"],
+  "sources": [],
   "sourcesContent": [
-    "/**\n * Converts the given value to a JSON string representation or maintains the type based on the generic parameter.\n *\n * @param value - The value to be converted.\n * @returns The JSON string representation of the value or the value itself.\n * @template T - The type of the value.\n * @template R - The return type, defaults to T.\n *\n * @example\n * // For JSON string representation\n * <script type=\"application/json\" data-hydration>\n *  {stringifyTyped<Partial<MyContext>, string>({ value: 'Hello World' })}\n * </script>\n *\n * // For maintaining the type\n * <my-app my-complex-attribute={stringifyTyped<MyType>(myData)}> // myData is of type MyType\n */\nexport function stringifyTyped<T, R = T>(value: T): R extends string ? string : T {\n  return JSON.stringify(value) as unknown as R extends string ? string : T;\n}\n"
   ],
-  "mappings": ";AAiBO,SAAS,cAAwB,CAAC,OAAyC;AAChF,SAAO,KAAK,UAAU,KAAK;AAAA;",
-  "debugId": "4776E3D8D4175B4F64756E2164756E21",
+  "mappings": "",
+  "debugId": "3F8DDB103AAD885E64756E2164756E21",
   "names": []
 }

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+import type { RadiantElement } from './core/radiant-element';
+export type Constructor<T = unknown> = {
+    new (...args: any[]): NonNullable<T>;
+};
+export type ConstructorParams<T extends Constructor> = ConstructorParameters<T>;
+export type Context = {
+    kind: string;
+    name: string | symbol;
+    access: {
+        get?(): unknown;
+        set?(value: unknown): void;
+        has?(value: unknown): boolean;
+    };
+    private?: boolean;
+    static?: boolean;
+    addInitializer?(initializer: () => void): void;
+};
+export type ClassDecorator = <T extends Constructor>(target: T, context: Context) => T | void;
+export type Method = (...args: any[]) => any;
+/**
+ * @deprecated
+ */
+export type StanderOrLegacyClassDecorator = {
+    (target: Constructor): typeof target | void;
+    (target: CustomElementConstructor, context: ClassDecoratorContext): void;
+};
+export type LegacyClassDecoratorArgs = {
+    protoOrTarget: CustomElementConstructor;
+    nameOrContext: string;
+    descriptor: PropertyDescriptor;
+};
+export type StandardClassDecoratorArgs = {
+    protoOrTarget: CustomElementConstructor;
+    nameOrContext: ClassDecoratorContext;
+};
+export type StandardOrLegacyClassDecoratorArgs = LegacyClassDecoratorArgs | StandardClassDecoratorArgs;
+/**
+ * @deprecated
+ */
+export type StandardOrLegacMethodDecorator = {
+    (proto: Constructor<HTMLElement>): PropertyDescriptor;
+    (target: Method, context: ClassMethodDecoratorContext): void;
+};
+export type LegacyMethodDecoratorArgs = {
+    protoOrTarget: RadiantElement;
+    nameOrContext: string;
+    descriptor: PropertyDescriptor;
+};
+export type StandardMethodDecoratorArgs = {
+    protoOrTarget: Method;
+    nameOrContext: ClassMethodDecoratorContext;
+    descriptor: undefined;
+};
+export type StandardOrLegacyMethodDecoratorArgs = LegacyMethodDecoratorArgs | StandardMethodDecoratorArgs;
+/**
+ * @deprecated
+ */
+export type StandardOrLegacyClassFieldDecorator = {
+    (proto: RadiantElement, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor;
+    (target: undefined, context: ClassFieldDecoratorContext): void;
+};
+export type LegacyFieldDecoratorArgs = {
+    protoOrTarget: RadiantElement;
+    nameOrContext: string;
+    descriptor: PropertyDescriptor;
+};
+export type StandardFieldDecoratorArgs<T = unknown, V = unknown> = {
+    protoOrTarget: undefined;
+    nameOrContext: ClassFieldDecoratorContext<T, V>;
+};
+export type StandardOrLegacyFieldDecoratorArgs = LegacyFieldDecoratorArgs | StandardFieldDecoratorArgs;
+export type CustomElementClass = Omit<typeof HTMLElement, 'new'>;
+export declare const guards: {
+    isStandard: {
+        ClassDecorator: (args: any) => args is [CustomElementConstructor, ClassDecoratorContext<CustomElementConstructor>];
+        MethodDecorator: (args: any) => args is [Method, ClassMethodDecoratorContext];
+        FieldDecorator: (args: any) => args is [undefined, ClassFieldDecoratorContext];
+    };
+};

package/dist/types.js

@@ -0,0 +1,3 @@
+import"./chunk-8xy18qmz.js";var r={isStandard:{ClassDecorator:function(t){return typeof t[1]<"u"},MethodDecorator:function(t){return typeof t[1]==="object"},FieldDecorator:function(t){return typeof t[1]==="object"}}};export{r as guards};
+
+//# debugId=91D7439E7D31B5DD64756E2164756E21

package/dist/types.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/types.ts"],
+  "sourcesContent": [
+    "import type { RadiantElement } from './core/radiant-element';\n\nexport type Constructor<T = unknown> = { new (...args: any[]): NonNullable<T> };\n\nexport type ConstructorParams<T extends Constructor> = ConstructorParameters<T>;\n\nexport type Context = {\n\tkind: string;\n\tname: string | symbol;\n\taccess: {\n\t\tget?(): unknown;\n\t\tset?(value: unknown): void;\n\t\thas?(value: unknown): boolean;\n\t};\n\tprivate?: boolean;\n\tstatic?: boolean;\n\taddInitializer?(initializer: () => void): void;\n};\n\nexport type ClassDecorator = <T extends Constructor>(target: T, context: Context) => T | void;\n\nexport type Method = (...args: any[]) => any;\n\n/**\n * @deprecated\n */\nexport type StanderOrLegacyClassDecorator = {\n\t(target: Constructor): typeof target | void;\n\t(target: CustomElementConstructor, context: ClassDecoratorContext): void;\n};\n\nexport type LegacyClassDecoratorArgs = {\n\tprotoOrTarget: CustomElementConstructor;\n\tnameOrContext: string;\n\tdescriptor: PropertyDescriptor;\n};\n\nexport type StandardClassDecoratorArgs = {\n\tprotoOrTarget: CustomElementConstructor;\n\tnameOrContext: ClassDecoratorContext;\n};\n\nexport type StandardOrLegacyClassDecoratorArgs = LegacyClassDecoratorArgs | StandardClassDecoratorArgs;\n\n/**\n * @deprecated\n */\nexport type StandardOrLegacMethodDecorator = {\n\t(proto: Constructor<HTMLElement>): PropertyDescriptor;\n\t(target: Method, context: ClassMethodDecoratorContext): void;\n};\n\nexport type LegacyMethodDecoratorArgs = {\n\tprotoOrTarget: RadiantElement;\n\tnameOrContext: string;\n\tdescriptor: PropertyDescriptor;\n};\n\nexport type StandardMethodDecoratorArgs = {\n\tprotoOrTarget: Method;\n\tnameOrContext: ClassMethodDecoratorContext;\n\tdescriptor: undefined;\n};\n\nexport type StandardOrLegacyMethodDecoratorArgs = LegacyMethodDecoratorArgs | StandardMethodDecoratorArgs;\n\n/**\n * @deprecated\n */\nexport type StandardOrLegacyClassFieldDecorator = {\n\t(proto: RadiantElement, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor;\n\t(target: undefined, context: ClassFieldDecoratorContext): void;\n};\n\nexport type LegacyFieldDecoratorArgs = {\n\tprotoOrTarget: RadiantElement;\n\tnameOrContext: string;\n\tdescriptor: PropertyDescriptor;\n};\n\nexport type StandardFieldDecoratorArgs<T = unknown, V = unknown> = {\n\tprotoOrTarget: undefined;\n\tnameOrContext: ClassFieldDecoratorContext<T, V>;\n};\n\nexport type StandardOrLegacyFieldDecoratorArgs = LegacyFieldDecoratorArgs | StandardFieldDecoratorArgs;\n\nexport type CustomElementClass = Omit<typeof HTMLElement, 'new'>;\n\nexport const guards = {\n\tisStandard: {\n\t\tClassDecorator: function (\n\t\t\targs: any,\n\t\t): args is [CustomElementConstructor, ClassDecoratorContext<CustomElementConstructor>] {\n\t\t\treturn typeof args[1] !== 'undefined';\n\t\t},\n\t\tMethodDecorator: function (args: any): args is [Method, ClassMethodDecoratorContext] {\n\t\t\treturn typeof args[1] === 'object';\n\t\t},\n\t\tFieldDecorator: function (args: any): args is [undefined, ClassFieldDecoratorContext] {\n\t\t\treturn typeof args[1] === 'object';\n\t\t},\n\t},\n};\n"
+  ],
+  "mappings": "4BAyFO,IAAM,EAAS,CACrB,WAAY,CACX,eAAgB,QAAS,CACxB,EACsF,CACtF,OAAO,OAAO,EAAK,GAAO,KAE3B,gBAAiB,QAAS,CAAC,EAA0D,CACpF,OAAO,OAAO,EAAK,KAAO,UAE3B,eAAgB,QAAS,CAAC,EAA4D,CACrF,OAAO,OAAO,EAAK,KAAO,SAE5B,CACD",
+  "debugId": "91D7439E7D31B5DD64756E2164756E21",
+  "names": []
+}

package/dist/utils/attribute-utils.d.ts

@@ -1,3 +1,4 @@
+import type { RadiantElement } from '../core/radiant-element';
 export type AttributeTypeConstant = typeof Array | typeof Boolean | typeof Number | typeof Object | typeof String;
 export type AttributeTypeDefault = Array<unknown> | boolean | number | Record<string, unknown> | string;
 /**
@@ -41,3 +42,4 @@ export type ReadAttributeValueReturnType = ReturnType<typeof readAttributeValue>
 export declare function writeAttributeValue(value: unknown, type: AttributeTypeConstant): string;
 export type WriteAttributeValueReturnType = ReturnType<typeof writeAttributeValue>;
 export declare function isValueOfType(type: AttributeTypeConstant, defaultValue: unknown): boolean;
+export declare const getInitialValue: (target: RadiantElement, type: AttributeTypeConstant, attributeKey: string, defaultValue: unknown) => unknown;