@sigx/server-renderer 0.1.4 → 0.1.6

package/dist/client/hydrate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Client-side hydration for SSR'd content
+ *
+ * Hydration attaches the app to existing server-rendered DOM,
+ * then delegates all updates to the runtime-dom renderer.
+ */
+import { AppContext } from 'sigx';
+export type { HydrationOptions } from './types.js';
+/**
+ * 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.
+ *
+ * @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 islands based on their strategies (selective hydration)
+ */
+export declare function hydrateIslands(): void;
+//# sourceMappingURL=hydrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../src/client/hydrate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAuBH,UAAU,EAEb,MAAM,MAAM,CAAC;AAKd,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA0FnD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAYvF;AA+gBD;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAkBrC"}

package/dist/client/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @sigx/server-renderer/client
+ *
+ * Client-side hydration with selective/islands hydration support.
+ */
+import '../client-directives.js';
+export { ssrClientPlugin, type HydrateFn } from './plugin.js';
+export { hydrateIslands } from './hydrate.js';
+export { HydrationRegistry, registerComponent } from './registry.js';
+export type { HydrationOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,2 @@
+import { i as registerComponent, n as hydrateIslands, r as HydrationRegistry, t as ssrClientPlugin } from "../client-DiLwBAD-.js";
+export { HydrationRegistry, hydrateIslands, registerComponent, ssrClientPlugin };

package/dist/client/plugin.d.ts

@@ -0,0 +1,52 @@
+/**
+ * SSR Client Plugin
+ *
+ * Provides app.hydrate() method for client-side hydration of server-rendered HTML.
+ * This plugin follows the same pattern as the router plugin.
+ */
+import type { Plugin, AppContext } from '@sigx/runtime-core';
+/**
+ * Hydrate function signature - matches MountFn pattern
+ */
+export type HydrateFn<TContainer = any> = (element: any, container: TContainer, appContext: AppContext) => (() => void) | void;
+declare module '@sigx/runtime-core' {
+    interface App<TContainer = any> {
+        /**
+         * Hydrate the app from server-rendered HTML.
+         *
+         * Unlike mount() which creates new DOM, hydrate() attaches to existing
+         * server-rendered DOM, adding event handlers and establishing reactivity.
+         *
+         * @example
+         * ```tsx
+         * import { defineApp } from 'sigx';
+         * import { ssrClientPlugin } from '@sigx/server-renderer/client';
+         *
+         * const app = defineApp(<App />);
+         * app.use(router)
+         *    .use(ssrClientPlugin)
+         *    .hydrate(document.getElementById('app')!);
+         * ```
+         */
+        hydrate(container: TContainer): App<TContainer>;
+    }
+}
+/**
+ * SSR Client Plugin
+ *
+ * Adds the hydrate() method to the app instance for client-side hydration.
+ * Also registers the SSR context extension for all components.
+ *
+ * @example
+ * ```tsx
+ * import { defineApp } from 'sigx';
+ * import { ssrClientPlugin } from '@sigx/server-renderer/client';
+ *
+ * const app = defineApp(<App />);
+ * app.use(ssrClientPlugin)
+ *    .use(router)
+ *    .hydrate('#app');
+ * ```
+ */
+export declare const ssrClientPlugin: Plugin;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/client/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAO,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQlE;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,UAAU,GAAG,GAAG,IAAI,CACtC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,UAAU,EACrB,UAAU,EAAE,UAAU,KACrB,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;AAEzB,OAAO,QAAQ,oBAAoB,CAAC;IAChC,UAAU,GAAG,CAAC,UAAU,GAAG,GAAG;QAC1B;;;;;;;;;;;;;;;;WAgBG;QACH,OAAO,CAAC,SAAS,EAAE,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;KACnD;CACJ;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,EAAE,MAmD7B,CAAC"}

package/dist/client/registry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Component Registry for Island Hydration
+ *
+ * Components must be registered before they can be hydrated as islands.
+ */
+/**
+ * Minimal type for component factories used in hydration registry.
+ * Compatible with ComponentFactory from runtime-core.
+ */
+export interface ComponentFactory {
+    __setup: Function;
+    __name?: string;
+    __async?: boolean;
+}
+/**
+ * Register a component for island hydration.
+ * Components must be registered before hydrateIslands() is called.
+ *
+ * @example
+ * ```ts
+ * import { registerComponent } from '@sigx/server-renderer/client';
+ * import { Counter } from './components/Counter';
+ *
+ * registerComponent('Counter', Counter);
+ * ```
+ */
+export declare function registerComponent(name: string, component: ComponentFactory): void;
+/**
+ * Register multiple components at once
+ *
+ * @example
+ * ```ts
+ * import { registerComponents } from '@sigx/server-renderer/client';
+ * import * as Components from './components';
+ *
+ * registerComponents(Components);
+ * ```
+ */
+export declare function registerComponents(components: Record<string, ComponentFactory>): void;
+/**
+ * Get a registered component by name
+ */
+export declare function getComponent(name: string): ComponentFactory | undefined;
+/**
+ * Hydration Registry class for more advanced use cases
+ */
+export declare class HydrationRegistry {
+    private components;
+    register(name: string, component: ComponentFactory): this;
+    registerAll(components: Record<string, ComponentFactory>): this;
+    get(name: string): ComponentFactory | undefined;
+    has(name: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/client/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAEjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,IAAI,CAMrF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEvE;AAID;;GAEG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,UAAU,CAAuC;IAEzD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAKzD,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,IAAI;IAS/D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG7B"}

package/dist/client/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared types for client-side hydration
+ */
+export type { VNode } from 'sigx';
+/**
+ * Hydration options
+ */
+export interface HydrationOptions {
+    recover?: boolean;
+    onMismatch?: (message: string, node: Node | null, vnode: any) => void;
+}
+/**
+ * Island information serialized from server
+ */
+export interface IslandInfo {
+    strategy: 'load' | 'idle' | 'visible' | 'media' | 'only';
+    media?: string;
+    props?: Record<string, any>;
+    componentId?: string;
+    /** Captured signal state from async setup for client hydration */
+    state?: Record<string, any>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B"}