@sigx/server-renderer 0.1.6 → 0.1.7

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

@@ -0,0 +1,46 @@
+/**
+ * Core rendering logic for SSR
+ *
+ * The async generator `renderToChunks` walks a VNode tree and yields HTML strings.
+ * Handles text, fragments, host elements, and delegates components to the
+ * component renderer.
+ *
+ * This module is strategy-agnostic. Island-specific logic (signal tracking,
+ * hydration directives, async streaming) lives in @sigx/ssr-islands and is
+ * injected through the SSRPlugin hooks.
+ */
+import { JSXElement, ComponentSetupContext } from 'sigx';
+import type { AppContext } from 'sigx';
+import type { SSRContext } from './context';
+export declare function escapeHtml(s: string): string;
+export declare function camelToKebab(str: string): string;
+export declare function parseStringStyle(cssText: string): Record<string, string>;
+/**
+ * Serialize a style object to a CSS string.
+ *
+ * Uses for...in + string concat (avoids Object.entries/map/join allocations)
+ * and cached kebab-case conversion.
+ */
+export declare function stringifyStyle(style: Record<string, any>): string;
+/**
+ * Render element to string chunks (generator for streaming)
+ * @param element - The JSX element to render
+ * @param ctx - The SSR context for tracking state
+ * @param parentCtx - The parent component context for provide/inject
+ * @param appContext - The app context for app-level provides (from defineApp)
+ */
+export declare function renderToChunks(element: JSXElement, ctx: SSRContext, parentCtx?: ComponentSetupContext | null, appContext?: AppContext | null): AsyncGenerator<string>;
+/**
+ * Helper to render a VNode to string (for deferred async content)
+ */
+export declare function renderVNodeToString(element: JSXElement, ctx: SSRContext, appContext?: AppContext | null): Promise<string>;
+/**
+ * Synchronous render-to-string that avoids async generator overhead.
+ * Returns null if any async operation is encountered (caller should fall back
+ * to the async generator path).
+ *
+ * For purely synchronous component trees this eliminates thousands of
+ * microtask/Promise allocations from the AsyncGenerator protocol.
+ */
+export declare function renderToStringSync(element: JSXElement, ctx: SSRContext, parentCtx: ComponentSetupContext | null, appContext: AppContext | null, buf: string[]): boolean;
+//# sourceMappingURL=render-core.d.ts.map

package/dist/server/render-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-core.d.ts","sourceRoot":"","sources":["../../src/server/render-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAGH,UAAU,EACV,qBAAqB,EASxB,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAY5C,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAQD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAiBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CASjE;AA4BD;;;;;;GAMG;AACH,wBAAuB,cAAc,CACjC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,UAAU,EACf,SAAS,GAAE,qBAAqB,GAAG,IAAW,EAC9C,UAAU,GAAE,UAAU,GAAG,IAAW,GACrC,cAAc,CAAC,MAAM,CAAC,CAiWxB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,GAAE,UAAU,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAMrI;AAID;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,qBAAqB,GAAG,IAAI,EACvC,UAAU,EAAE,UAAU,GAAG,IAAI,EAC7B,GAAG,EAAE,MAAM,EAAE,GACd,OAAO,CAmQT"}

package/dist/server/streaming.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Core streaming utilities for async SSR
+ *
+ * Provides the client-side `$SIGX_REPLACE` function and replacement script
+ * generation used by core async streaming. These are strategy-agnostic —
+ * any async component with `ssr.load()` gets streamed without needing a plugin.
+ *
+ * Plugins (e.g., islands) can augment replacements via `onAsyncComponentResolved`.
+ */
+/**
+ * Escape a JSON string for safe embedding inside <script> tags.
+ * Prevents XSS by replacing characters that could break out of the script context.
+ */
+export declare function escapeJsonForScript(json: string): string;
+/**
+ * Generate the streaming bootstrap script (injected once before any replacements).
+ * Defines `window.$SIGX_REPLACE` which swaps async placeholders with rendered HTML.
+ */
+export declare function generateStreamingScript(): string;
+/**
+ * Generate a replacement script for a resolved async component.
+ */
+export declare function generateReplacementScript(id: number, html: string, extraScript?: string): string;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/server/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/server/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAgBhD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAQhG"}

package/dist/server/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared types for server rendering APIs.
+ *
+ * Kept separate to avoid circular imports between ssr.ts and render-api.ts.
+ */
+import type { Signal, PrimitiveSignal, Primitive } from 'sigx';
+/**
+ * SSR-enhanced signal function type.
+ * Extends the base signal() with an optional `name` parameter used as the
+ * serialization key for hydration state transfer.
+ *
+ * Both `createTrackingSignal` (server/islands) and `createRestoringSignal` (client/hydration)
+ * use this type and share the same key-generation contract via `generateSignalKey`.
+ */
+export type SSRSignalFn = {
+    <T extends Primitive>(initial: T, name?: string): PrimitiveSignal<T>;
+    <T extends object>(initial: T, name?: string): Signal<T>;
+};
+/**
+ * Generate a stable key for a signal during SSR state tracking/restoration.
+ *
+ * Named signals use the provided name; unnamed signals use a positional key (`$0`, `$1`, ...).
+ * Both server-side tracking (`createTrackingSignal`) and client-side restoration
+ * (`createRestoringSignal`) MUST use this function to guarantee key parity.
+ */
+export declare function generateSignalKey(name: string | undefined, index: number): string;
+/**
+ * Streaming callbacks interface
+ */
+export interface StreamCallbacks {
+    /** Called when the initial shell (synchronous content) is ready */
+    onShellReady: (html: string) => void;
+    /** Called for each async chunk (replacement scripts, hydration data) */
+    onAsyncChunk: (chunk: string) => void;
+    /** Called when all streaming is complete */
+    onComplete: () => void;
+    /** Called on error */
+    onError: (error: Error) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,CAAC,CAAC,SAAS,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;CAC5D,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,mEAAmE;IACnE,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,wEAAwE;IACxE,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,4CAA4C;IAC5C,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,sBAAsB;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACnC"}