hadars 0.1.40 → 0.2.1

package/dist/slim-react/index.d.cts

@@ -96,9 +96,26 @@ interface RenderOptions {
  */
 declare function renderToStream(element: SlimNode, options?: RenderOptions): ReadableStream<Uint8Array>;
 /**
- * Convenience: render to a complete HTML string.
- * Retries the full tree when a component throws a Promise (Suspense protocol),
- * so useServerData and similar hooks work without requiring explicit <Suspense>.
+ * Pass-1 preflight render.
+ *
+ * Walks the component tree with a NullWriter (discards all HTML output) so
+ * that all `useServerData` promises are resolved into the `__hadarsUnsuspend`
+ * cache and all `context.head` mutations are applied.
+ *
+ * Components self-retry on suspension at the component level (see
+ * `renderComponent` catch block), so a single tree walk is sufficient.
+ *
+ * Call this before `renderToString` / `renderToStream` to guarantee a
+ * suspension-free, fully-synchronous second pass.
+ */
+declare function renderPreflight(element: SlimNode, options?: RenderOptions): Promise<void>;
+/**
+ * Render a component tree to a complete HTML string.
+ *
+ * Components self-retry on suspension at the component level (see
+ * `renderComponent` catch block), so a single tree walk is sufficient
+ * even when `useServerData` or similar hooks are used without an explicit
+ * `<Suspense>` wrapper.
  */
 declare function renderToString(element: SlimNode, options?: RenderOptions): Promise<string>;
 
@@ -115,10 +132,8 @@ declare const Suspense: symbol;
 
 declare function isValidElement(obj: unknown): obj is SlimElement;
 declare function cloneElement(element: SlimElement, overrideProps?: Record<string, any>, ...children: SlimNode[]): SlimElement;
-declare function forwardRef<P = any>(render: (props: P, ref: any) => SlimNode): (props: P & {
-    ref?: any;
-}) => SlimNode;
-declare function memo<P = any>(component: (props: P) => SlimNode): (props: P) => SlimNode;
+declare function forwardRef<P = any>(render: (props: P, ref: any) => SlimNode): any;
+declare function memo<P = any>(component: (props: P) => SlimNode, compare?: (prevProps: P, nextProps: P) => boolean): any;
 declare function lazy<P = any>(factory: () => Promise<{
     default: (props: P) => SlimNode;
 }>): (props: P) => SlimNode;
@@ -184,7 +199,8 @@ declare const React: {
     renderToStream: typeof renderToStream;
     renderToString: typeof renderToString;
     renderToReadableStream: typeof renderToStream;
+    renderPreflight: typeof renderPreflight;
     version: string;
 };
 
-export { Children, Component, type Context, PureComponent, type RenderOptions, SlimElement, SlimNode, Suspense, cloneElement, createContext, createElement, React as default, forwardRef, isValidElement, lazy, memo, renderToStream as renderToReadableStream, renderToStream, renderToString, startTransition, use, useActionState, useCallback, useContext, useDebugValue, useDeferredValue, useEffect, useFormStatus, useId, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useOptimistic, useReducer, useRef, useState, useSyncExternalStore, useTransition, version };
+export { Children, Component, type Context, PureComponent, type RenderOptions, SlimElement, SlimNode, Suspense, cloneElement, createContext, createElement, React as default, forwardRef, isValidElement, lazy, memo, renderPreflight, renderToStream as renderToReadableStream, renderToStream, renderToString, startTransition, use, useActionState, useCallback, useContext, useDebugValue, useDeferredValue, useEffect, useFormStatus, useId, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useOptimistic, useReducer, useRef, useState, useSyncExternalStore, useTransition, version };

package/dist/slim-react/index.d.ts

@@ -96,9 +96,26 @@ interface RenderOptions {
  */
 declare function renderToStream(element: SlimNode, options?: RenderOptions): ReadableStream<Uint8Array>;
 /**
- * Convenience: render to a complete HTML string.
- * Retries the full tree when a component throws a Promise (Suspense protocol),
- * so useServerData and similar hooks work without requiring explicit <Suspense>.
+ * Pass-1 preflight render.
+ *
+ * Walks the component tree with a NullWriter (discards all HTML output) so
+ * that all `useServerData` promises are resolved into the `__hadarsUnsuspend`
+ * cache and all `context.head` mutations are applied.
+ *
+ * Components self-retry on suspension at the component level (see
+ * `renderComponent` catch block), so a single tree walk is sufficient.
+ *
+ * Call this before `renderToString` / `renderToStream` to guarantee a
+ * suspension-free, fully-synchronous second pass.
+ */
+declare function renderPreflight(element: SlimNode, options?: RenderOptions): Promise<void>;
+/**
+ * Render a component tree to a complete HTML string.
+ *
+ * Components self-retry on suspension at the component level (see
+ * `renderComponent` catch block), so a single tree walk is sufficient
+ * even when `useServerData` or similar hooks are used without an explicit
+ * `<Suspense>` wrapper.
  */
 declare function renderToString(element: SlimNode, options?: RenderOptions): Promise<string>;
 
@@ -115,10 +132,8 @@ declare const Suspense: symbol;
 
 declare function isValidElement(obj: unknown): obj is SlimElement;
 declare function cloneElement(element: SlimElement, overrideProps?: Record<string, any>, ...children: SlimNode[]): SlimElement;
-declare function forwardRef<P = any>(render: (props: P, ref: any) => SlimNode): (props: P & {
-    ref?: any;
-}) => SlimNode;
-declare function memo<P = any>(component: (props: P) => SlimNode): (props: P) => SlimNode;
+declare function forwardRef<P = any>(render: (props: P, ref: any) => SlimNode): any;
+declare function memo<P = any>(component: (props: P) => SlimNode, compare?: (prevProps: P, nextProps: P) => boolean): any;
 declare function lazy<P = any>(factory: () => Promise<{
     default: (props: P) => SlimNode;
 }>): (props: P) => SlimNode;
@@ -184,7 +199,8 @@ declare const React: {
     renderToStream: typeof renderToStream;
     renderToString: typeof renderToString;
     renderToReadableStream: typeof renderToStream;
+    renderPreflight: typeof renderPreflight;
     version: string;
 };
 
-export { Children, Component, type Context, PureComponent, type RenderOptions, SlimElement, SlimNode, Suspense, cloneElement, createContext, createElement, React as default, forwardRef, isValidElement, lazy, memo, renderToStream as renderToReadableStream, renderToStream, renderToString, startTransition, use, useActionState, useCallback, useContext, useDebugValue, useDeferredValue, useEffect, useFormStatus, useId, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useOptimistic, useReducer, useRef, useState, useSyncExternalStore, useTransition, version };
+export { Children, Component, type Context, PureComponent, type RenderOptions, SlimElement, SlimNode, Suspense, cloneElement, createContext, createElement, React as default, forwardRef, isValidElement, lazy, memo, renderPreflight, renderToStream as renderToReadableStream, renderToStream, renderToString, startTransition, use, useActionState, useCallback, useContext, useDebugValue, useDeferredValue, useEffect, useFormStatus, useId, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useOptimistic, useReducer, useRef, useState, useSyncExternalStore, useTransition, version };

package/dist/slim-react/index.js

@@ -9,6 +9,7 @@ import {
   isValidElement,
   lazy,
   memo,
+  renderPreflight,
   renderToStream,
   renderToString,
   slim_react_default,
@@ -33,7 +34,7 @@ import {
   useSyncExternalStore,
   useTransition,
   version
-} from "../chunk-2ENP7IAW.js";
+} from "../chunk-LY5MTHFV.js";
 import {
   FRAGMENT_TYPE,
   Fragment,
@@ -62,6 +63,7 @@ export {
   jsx as jsxs,
   lazy,
   memo,
+  renderPreflight,
   renderToStream as renderToReadableStream,
   renderToStream,
   renderToString,