@sigx/server-renderer 0.1.5 → 0.1.7

package/dist/builtin-ssr-directives.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Initialize SSR support for all built-in directives.
+ *
+ * Must be called before any SSR rendering occurs.
+ * Safe to call multiple times — only patches once.
+ */
+export declare function initDirectivesForSSR(): void;
+//# sourceMappingURL=builtin-ssr-directives.d.ts.map

package/dist/builtin-ssr-directives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-ssr-directives.d.ts","sourceRoot":"","sources":["../src/builtin-ssr-directives.ts"],"names":[],"mappings":"AA4BA;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}

package/dist/client/hydrate-component.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Component hydration logic — strategy-agnostic
+ *
+ * Handles running component setup, creating reactive effects,
+ * and restoring server state for hydrated components.
+ * Does not depend on islands or any specific SSR strategy.
+ */
+import { VNode } from 'sigx';
+/**
+ * Minimal type for component factories used in hydration.
+ * Compatible with ComponentFactory from runtime-core.
+ */
+export interface ComponentFactory {
+    __setup: Function;
+    __name?: string;
+    __async?: boolean;
+}
+/**
+ * Hydrate a component - run setup and create reactive effect
+ *
+ * With trailing markers, the structure is: <content><!--$c:id-->
+ * - dom points to start of content
+ * - trailingMarker (if provided) is the anchor at the end
+ *
+ * @param vnode - The VNode to hydrate
+ * @param dom - The DOM node to start from (content starts here)
+ * @param parent - The parent node
+ * @param serverState - Optional state captured from server for async components
+ * @param trailingMarker - Optional trailing marker comment (the component anchor)
+ */
+export declare function hydrateComponent(vnode: VNode, dom: Node | null, parent: Node, serverState?: Record<string, any>, trailingMarker?: Comment | null): Node | null;
+//# sourceMappingURL=hydrate-component.d.ts.map

package/dist/client/hydrate-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate-component.d.ts","sourceRoot":"","sources":["../../src/client/hydrate-component.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACH,KAAK,EAiBR,MAAM,MAAM,CAAC;AAQd;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAwL9J"}

package/dist/client/hydrate-context.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Hydration context and state management
+ *
+ * Manages server state restoration, app context tracking,
+ * client plugin registration, and the SSR context extension for components.
+ *
+ * Strategy-specific concerns (island data, async hydration) are handled
+ * by plugins registered via `registerClientPlugin()`.
+ */
+import { VNode } from 'sigx';
+import type { AppContext } from 'sigx';
+import type { SSRPlugin } from '../plugin';
+import type { SSRSignalFn } from '../server/types';
+export interface InternalVNode extends VNode {
+    _subTree?: VNode;
+    _effect?: any;
+    _componentProps?: any;
+    _slots?: any;
+}
+export type { SSRSignalFn };
+/**
+ * Register a client-side SSR plugin.
+ * Plugins are called during hydration to intercept component processing,
+ * skip default hydration walk, or run post-hydration logic.
+ */
+export declare function registerClientPlugin(plugin: SSRPlugin): void;
+/**
+ * Get all registered client-side plugins.
+ */
+export declare function getClientPlugins(): SSRPlugin[];
+/**
+ * Clear all registered client plugins (useful for testing).
+ */
+export declare function clearClientPlugins(): void;
+/**
+ * Set server state that should be used for the next component mount.
+ * Used internally when mounting async components after streaming.
+ */
+export declare function setPendingServerState(state: Record<string, any> | null): void;
+/** Get the current app context for deferred hydration */
+export declare function getCurrentAppContext(): AppContext | null;
+/** Set the current app context during hydration */
+export declare function setCurrentAppContext(ctx: AppContext | null): void;
+/**
+ * Creates a signal function that restores state from server-captured values.
+ * Used during hydration of async components to avoid re-fetching data.
+ * Supports both primitive and object signals.
+ */
+export declare function createRestoringSignal(serverState: Record<string, any>): SSRSignalFn;
+/**
+ * Normalize any element to VNode
+ */
+export declare function normalizeElement(element: any): VNode | null;
+//# sourceMappingURL=hydrate-context.d.ts.map

package/dist/client/hydrate-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate-context.d.ts","sourceRoot":"","sources":["../../src/client/hydrate-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACH,KAAK,EAIR,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,MAAM,WAAW,aAAc,SAAQ,KAAK;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,MAAM,CAAC,EAAE,GAAG,CAAC;CAChB;AAGD,YAAY,EAAE,WAAW,EAAE,CAAC;AAgB5B;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAE9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAE7E;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,IAAI,UAAU,GAAG,IAAI,CAExD;AAED,mDAAmD;AACnD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAEjE;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,CA0BnF;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,KAAK,GAAG,IAAI,CAiB3D"}

package/dist/client/hydrate-core.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Core hydration logic — strategy-agnostic
+ *
+ * Walks existing server-rendered DOM and attaches event handlers,
+ * creates reactive effects, and delegates components to the component hydrator.
+ *
+ * Plugins registered via `registerClientPlugin()` can intercept component
+ * hydration (e.g., for deferred/island-based hydration strategies).
+ */
+import { VNode } from 'sigx';
+import type { AppContext } from 'sigx';
+/**
+ * Hydrate a server-rendered app.
+ *
+ * This walks the existing DOM to attach event handlers, runs component
+ * setup functions to establish reactivity, then uses runtime-dom for updates.
+ *
+ * Registered client plugins are called at appropriate points:
+ * - `beforeHydrate`: before the DOM walk (return false to skip it entirely)
+ * - `hydrateComponent`: for each component (return { next } to handle it)
+ * - `afterHydrate`: after the DOM walk completes
+ *
+ * @param element - The root element/VNode to hydrate
+ * @param container - The DOM container with SSR content
+ * @param appContext - The app context for DI (provides, etc.)
+ */
+export declare function hydrate(element: any, container: Element, appContext?: AppContext): void;
+/**
+ * Hydrate a VNode against existing DOM
+ * This only attaches event handlers and refs - no DOM creation
+ */
+export declare function hydrateNode(vnode: VNode, dom: Node | null, parent: Node): Node | null;
+//# sourceMappingURL=hydrate-core.d.ts.map

package/dist/client/hydrate-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate-core.d.ts","sourceRoot":"","sources":["../../src/client/hydrate-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACH,KAAK,EAOR,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAIvC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CA6BvF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CA+HrF"}

package/dist/client/index.d.ts

@@ -1,10 +1,15 @@
 /**
  * @sigx/server-renderer/client
  *
- * Client-side hydration with selective/islands hydration support.
+ * Client-side hydration — strategy-agnostic core.
+ * Plugin-based extension for islands, resumable SSR, etc.
  */
 import '../client-directives.js';
-export { hydrate, hydrateIslands } from './hydrate.js';
-export { HydrationRegistry, registerComponent } from './registry.js';
-export type { HydrationOptions } from './hydrate.js';
+import './hydrate-context';
+export { ssrClientPlugin, type HydrateFn } from './plugin.js';
+export { hydrate, hydrateNode } from './hydrate-core';
+export { hydrateComponent } from './hydrate-component';
+export type { ComponentFactory } from './hydrate-component';
+export { registerClientPlugin, getClientPlugins, clearClientPlugins, setPendingServerState, getCurrentAppContext, setCurrentAppContext, createRestoringSignal } from './hydrate-context';
+export type { SSRSignalFn, InternalVNode } from './hydrate-context';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}