@flight-framework/core 0.1.0 → 0.2.1

package/dist/chunk-HAX5OAB6.js

@@ -0,0 +1,324 @@
+import { createServerChunk, createErrorChunk, toFlightElement, serialize, generateChunkId, createClientChunk } from './chunk-K2CQZPCG.js';
+import { isClientReference } from './chunk-PDW5WCMW.js';
+
+// src/rsc/renderer.ts
+var FlightRenderer = class {
+  constructor(adapter, options = {}) {
+    this.adapter = adapter;
+    this.options = options;
+  }
+  chunks = [];
+  clientRefs = [];
+  pendingPromises = /* @__PURE__ */ new Map();
+  depth = 0;
+  /**
+   * Render a component tree to Flight chunks
+   */
+  async render(element, ctx) {
+    const startTime = Date.now();
+    this.chunks = [];
+    this.clientRefs = [];
+    this.pendingPromises.clear();
+    this.depth = 0;
+    try {
+      const rootTree = await this.renderElement(element, ctx);
+      const root = createServerChunk("root", rootTree);
+      this.chunks.unshift(root);
+      await this.resolvePendingChunks(ctx);
+      const endTime = Date.now();
+      return {
+        chunks: this.chunks,
+        root,
+        clientRefs: this.clientRefs,
+        timing: {
+          startTime,
+          endTime,
+          duration: endTime - startTime
+        }
+      };
+    } catch (error) {
+      const errChunk = createErrorChunk("root", error, this.options.dev);
+      this.chunks.push(errChunk);
+      throw error;
+    }
+  }
+  /**
+   * Render as async generator (for streaming)
+   */
+  async *renderStreaming(element, ctx) {
+    this.chunks = [];
+    this.clientRefs = [];
+    this.pendingPromises.clear();
+    this.depth = 0;
+    try {
+      const rootTree = await this.renderElement(element, ctx);
+      const root = createServerChunk("root", rootTree);
+      yield root;
+      while (this.pendingPromises.size > 0) {
+        const entries = [...this.pendingPromises.entries()];
+        const promises = entries.map(async ([id, promise]) => {
+          const tree = await promise;
+          this.pendingPromises.delete(id);
+          return createServerChunk(id, tree);
+        });
+        const chunk = await Promise.race(promises);
+        yield chunk;
+      }
+      for (const clientRef of this.clientRefs) {
+        yield clientRef;
+      }
+    } catch (error) {
+      yield createErrorChunk("root", error, this.options.dev);
+    }
+  }
+  /**
+   * Render an element to FlightElement
+   */
+  async renderElement(element, ctx) {
+    this.depth++;
+    if (this.depth > (this.options.maxDepth ?? 100)) {
+      throw new Error("Maximum render depth exceeded. Check for infinite component loops.");
+    }
+    try {
+      if (element === null || element === void 0 || typeof element === "boolean") {
+        return { $$type: "null" };
+      }
+      if (typeof element === "string") {
+        return { $$type: "text", value: element };
+      }
+      if (typeof element === "number") {
+        return { $$type: "text", value: String(element) };
+      }
+      if (Array.isArray(element)) {
+        const children = await Promise.all(
+          element.map((child) => this.renderElement(child, ctx))
+        );
+        return { $$type: "fragment", children };
+      }
+      if (isClientReference(element)) {
+        return this.renderClientReference(element, ctx);
+      }
+      if (this.adapter.isElement(element)) {
+        return this.renderFrameworkElement(element, ctx);
+      }
+      return toFlightElement(element);
+    } finally {
+      this.depth--;
+    }
+  }
+  /**
+   * Render a framework-specific element
+   */
+  async renderFrameworkElement(element, ctx) {
+    const typeInfo = this.adapter.getElementType(element);
+    const props = this.adapter.getProps(element);
+    const key = this.adapter.getKey(element);
+    switch (typeInfo.kind) {
+      case "host":
+        return this.renderHostElement(typeInfo.tag, props, key, ctx);
+      case "component":
+        return this.renderComponent(typeInfo.fn, typeInfo.name, props, ctx);
+      case "fragment": {
+        const children = this.adapter.getChildren(element);
+        const renderedChildren = await Promise.all(
+          children.map((child) => this.renderElement(child, ctx))
+        );
+        return { $$type: "fragment", children: renderedChildren };
+      }
+      case "suspense": {
+        return this.renderSuspense(element, typeInfo.fallback, ctx);
+      }
+      case "text":
+        return { $$type: "text", value: typeInfo.value };
+      case "null":
+        return { $$type: "null" };
+      default:
+        return { $$type: "null" };
+    }
+  }
+  /**
+   * Render a host element (div, span, etc.)
+   */
+  async renderHostElement(tag, props, key, ctx) {
+    const { children: childrenProp, ...restProps } = props;
+    const serializedProps = {};
+    for (const [propKey, value] of Object.entries(restProps)) {
+      if (typeof value !== "function") {
+        serializedProps[propKey] = serialize(value);
+      }
+    }
+    const rawChildren = childrenProp ? Array.isArray(childrenProp) ? childrenProp : [childrenProp] : [];
+    const children = await Promise.all(
+      rawChildren.map((child) => this.renderElement(child, ctx))
+    );
+    return {
+      $$type: "host",
+      tag,
+      key,
+      props: serializedProps,
+      children
+    };
+  }
+  /**
+   * Render a component (server or client)
+   */
+  async renderComponent(component, name, props, ctx) {
+    if (this.adapter.isClientBoundary(component)) {
+      return this.renderClientBoundary(component, name, props, ctx);
+    }
+    try {
+      const result = await component(props, ctx);
+      return this.renderElement(result, ctx);
+    } catch (error) {
+      if (error instanceof Promise) {
+        return this.renderAsyncBoundary(error, name, props, ctx);
+      }
+      this.options.onError?.(error, name);
+      throw error;
+    }
+  }
+  /**
+   * Render a client boundary
+   */
+  async renderClientBoundary(component, name, props, _ctx) {
+    const chunkId = generateChunkId("c");
+    const moduleId = component.__flight_module ?? name;
+    const exportName = component.__flight_export ?? "default";
+    let fallback;
+    if (this.options.includeSSRFallbacks && this.adapter.renderToString) {
+      try {
+        fallback = await this.adapter.renderToString(props);
+      } catch {
+      }
+    }
+    const clientChunk = createClientChunk(chunkId, moduleId, exportName, props, fallback);
+    this.clientRefs.push(clientChunk);
+    this.chunks.push(clientChunk);
+    return {
+      $$type: "client",
+      ref: chunkId,
+      ssr: fallback
+    };
+  }
+  /**
+   * Render a Suspense boundary
+   */
+  async renderSuspense(element, fallbackElement, ctx) {
+    const boundaryId = generateChunkId("s");
+    const children = this.adapter.getChildren(element);
+    const fallback = fallbackElement ? await this.renderElement(fallbackElement, ctx) : { $$type: "null" };
+    const renderedChildren = [];
+    for (const child of children) {
+      try {
+        const rendered = await this.renderElement(child, ctx);
+        renderedChildren.push(rendered);
+      } catch (error) {
+        if (error instanceof Promise) {
+          this.pendingPromises.set(boundaryId, error.then(async () => {
+            const children2 = this.adapter.getChildren(element);
+            const rendered = await Promise.all(
+              children2.map((c) => this.renderElement(c, ctx))
+            );
+            return { $$type: "fragment", children: rendered };
+          }));
+          return {
+            $$type: "suspense",
+            id: boundaryId,
+            fallback,
+            children: [{ $$type: "lazy", id: boundaryId, fallback }]
+          };
+        }
+        throw error;
+      }
+    }
+    return {
+      $$type: "suspense",
+      id: boundaryId,
+      fallback,
+      children: renderedChildren
+    };
+  }
+  /**
+   * Render an async boundary (promise thrown from component)
+   */
+  renderAsyncBoundary(promise, name, props, ctx) {
+    const boundaryId = generateChunkId("a");
+    this.pendingPromises.set(
+      boundaryId,
+      promise.then(async () => {
+        const component = props.component;
+        if (component) {
+          const result = await component(props, ctx);
+          return this.renderElement(result, ctx);
+        }
+        return { $$type: "null" };
+      })
+    );
+    return {
+      $$type: "lazy",
+      id: boundaryId,
+      fallback: { $$type: "text", value: `Loading ${name}...` }
+    };
+  }
+  /**
+   * Render a Client Reference directly
+   */
+  async renderClientReference(ref, _ctx) {
+    const chunkId = generateChunkId("c");
+    const clientChunk = createClientChunk(
+      chunkId,
+      ref.__flight_module,
+      ref.__flight_export,
+      {}
+      // Props are embedded in the reference
+    );
+    this.clientRefs.push(clientChunk);
+    this.chunks.push(clientChunk);
+    return {
+      $$type: "client",
+      ref: chunkId
+    };
+  }
+  /**
+   * Resolve all pending async chunks
+   */
+  async resolvePendingChunks(_ctx) {
+    while (this.pendingPromises.size > 0) {
+      const entries = [...this.pendingPromises.entries()];
+      for (const [id, promise] of entries) {
+        try {
+          const tree = await promise;
+          this.chunks.push(createServerChunk(id, tree));
+        } catch (error) {
+          this.chunks.push(createErrorChunk(id, error, this.options.dev));
+        }
+        this.pendingPromises.delete(id);
+      }
+    }
+  }
+};
+function createRenderer(adapter, options) {
+  return new FlightRenderer(adapter, options);
+}
+async function renderServerComponent(component, props, ctx, adapter, options) {
+  const renderer = createRenderer(adapter, options);
+  const element = {
+    type: component,
+    props,
+    $$typeof: /* @__PURE__ */ Symbol.for("react.element")
+  };
+  return renderer.render(element, ctx);
+}
+async function* renderServerComponentStreaming(component, props, ctx, adapter, options) {
+  const renderer = createRenderer(adapter, options);
+  const element = {
+    type: component,
+    props,
+    $$typeof: /* @__PURE__ */ Symbol.for("react.element")
+  };
+  yield* renderer.renderStreaming(element, ctx);
+}
+
+export { FlightRenderer, createRenderer, renderServerComponent, renderServerComponentStreaming };
+//# sourceMappingURL=chunk-HAX5OAB6.js.map
+//# sourceMappingURL=chunk-HAX5OAB6.js.map

package/dist/chunk-HAX5OAB6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rsc/renderer.ts"],"names":["children"],"mappings":"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","file":"chunk-HAX5OAB6.js","sourcesContent":["/**\r\n * @flight-framework/core - Server Component Renderer\r\n * \r\n * Renders Server Components to FlightChunks.\r\n * Framework-agnostic rendering engine that works with adapters.\r\n * \r\n * @module @flight-framework/core/rsc/renderer\r\n */\r\n\r\nimport type {\r\n    FlightChunk,\r\n    FlightElement,\r\n    ServerComponentChunk,\r\n    ClientReferenceChunk,\r\n} from './payload.js';\r\nimport {\r\n    generateChunkId,\r\n    createServerChunk,\r\n    createClientChunk,\r\n    createErrorChunk,\r\n    toFlightElement,\r\n    serialize,\r\n} from './payload.js';\r\nimport {\r\n    isClientReference,\r\n    type ClientReference,\r\n} from './boundaries.js';\r\nimport type { ServerContext } from './context.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * UI Framework adapter for rendering\r\n */\r\nexport interface UIAdapter {\r\n    /** Adapter name */\r\n    name: string;\r\n\r\n    /** Check if value is a framework element */\r\n    isElement(value: unknown): boolean;\r\n\r\n    /** Get element type info */\r\n    getElementType(element: unknown): ElementTypeInfo;\r\n\r\n    /** Get element props */\r\n    getProps(element: unknown): Record<string, unknown>;\r\n\r\n    /** Get element children */\r\n    getChildren(element: unknown): unknown[];\r\n\r\n    /** Get element key */\r\n    getKey(element: unknown): string | number | undefined;\r\n\r\n    /** Check if component is a client boundary */\r\n    isClientBoundary(component: unknown): boolean;\r\n\r\n    /** Render element to HTML string (for SSR fallback) */\r\n    renderToString?(element: unknown): Promise<string>;\r\n}\r\n\r\nexport type ElementTypeInfo =\r\n    | { kind: 'host'; tag: string }\r\n    | { kind: 'component'; fn: ComponentFn; name: string }\r\n    | { kind: 'fragment' }\r\n    | { kind: 'suspense'; fallback?: unknown }\r\n    | { kind: 'provider'; value?: unknown }\r\n    | { kind: 'context' }\r\n    | { kind: 'text'; value: string }\r\n    | { kind: 'null' };\r\n\r\n/**\r\n * Component function type\r\n */\r\nexport type ComponentFn = (\r\n    props: Record<string, unknown>,\r\n    ctx?: ServerContext\r\n) => unknown | Promise<unknown>;\r\n\r\n/**\r\n * Render options\r\n */\r\nexport interface RenderOptions {\r\n    /** Include SSR fallbacks for client components */\r\n    includeSSRFallbacks?: boolean;\r\n\r\n    /** Error handler */\r\n    onError?: (error: Error, componentName?: string) => void;\r\n\r\n    /** Dev mode (include extra debug info) */\r\n    dev?: boolean;\r\n\r\n    /** Max render depth to prevent infinite loops */\r\n    maxDepth?: number;\r\n}\r\n\r\n/**\r\n * Render result with metadata\r\n */\r\nexport interface RenderResult {\r\n    /** All chunks generated */\r\n    chunks: FlightChunk[];\r\n\r\n    /** Root chunk */\r\n    root: ServerComponentChunk;\r\n\r\n    /** Client references found */\r\n    clientRefs: ClientReferenceChunk[];\r\n\r\n    /** Timing info */\r\n    timing: {\r\n        startTime: number;\r\n        endTime: number;\r\n        duration: number;\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Renderer Implementation\r\n// ============================================================================\r\n\r\n/**\r\n * Flight Server Component Renderer\r\n */\r\nexport class FlightRenderer {\r\n    private chunks: FlightChunk[] = [];\r\n    private clientRefs: ClientReferenceChunk[] = [];\r\n    private pendingPromises = new Map<string, Promise<FlightElement>>();\r\n    private depth = 0;\r\n\r\n    constructor(\r\n        private adapter: UIAdapter,\r\n        private options: RenderOptions = {}\r\n    ) { }\r\n\r\n    /**\r\n     * Render a component tree to Flight chunks\r\n     */\r\n    async render(\r\n        element: unknown,\r\n        ctx: ServerContext\r\n    ): Promise<RenderResult> {\r\n        const startTime = Date.now();\r\n\r\n        this.chunks = [];\r\n        this.clientRefs = [];\r\n        this.pendingPromises.clear();\r\n        this.depth = 0;\r\n\r\n        try {\r\n            // Render the root element\r\n            const rootTree = await this.renderElement(element, ctx);\r\n            const root = createServerChunk('root', rootTree);\r\n            this.chunks.unshift(root);\r\n\r\n            // Wait for any pending async boundaries\r\n            await this.resolvePendingChunks(ctx);\r\n\r\n            const endTime = Date.now();\r\n\r\n            return {\r\n                chunks: this.chunks,\r\n                root,\r\n                clientRefs: this.clientRefs,\r\n                timing: {\r\n                    startTime,\r\n                    endTime,\r\n                    duration: endTime - startTime,\r\n                },\r\n            };\r\n        } catch (error) {\r\n            const errChunk = createErrorChunk('root', error as Error, this.options.dev);\r\n            this.chunks.push(errChunk);\r\n\r\n            throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render as async generator (for streaming)\r\n     */\r\n    async *renderStreaming(\r\n        element: unknown,\r\n        ctx: ServerContext\r\n    ): AsyncGenerator<FlightChunk> {\r\n        // Note: startTime available for future timing features\r\n        this.chunks = [];\r\n        this.clientRefs = [];\r\n        this.pendingPromises.clear();\r\n        this.depth = 0;\r\n\r\n        try {\r\n            // Render root synchronously\r\n            const rootTree = await this.renderElement(element, ctx);\r\n            const root = createServerChunk('root', rootTree);\r\n            yield root;\r\n\r\n            // Yield pending chunks as they resolve\r\n            while (this.pendingPromises.size > 0) {\r\n                const entries = [...this.pendingPromises.entries()];\r\n\r\n                // Race all pending promises\r\n                const promises = entries.map(async ([id, promise]) => {\r\n                    const tree = await promise;\r\n                    this.pendingPromises.delete(id);\r\n                    return createServerChunk(id, tree);\r\n                });\r\n\r\n                // Yield first to complete\r\n                const chunk = await Promise.race(promises);\r\n                yield chunk;\r\n            }\r\n\r\n            // Yield all client refs\r\n            for (const clientRef of this.clientRefs) {\r\n                yield clientRef;\r\n            }\r\n\r\n        } catch (error) {\r\n            yield createErrorChunk('root', error as Error, this.options.dev);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render an element to FlightElement\r\n     */\r\n    private async renderElement(\r\n        element: unknown,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        // Check depth limit\r\n        this.depth++;\r\n        if (this.depth > (this.options.maxDepth ?? 100)) {\r\n            throw new Error('Maximum render depth exceeded. Check for infinite component loops.');\r\n        }\r\n\r\n        try {\r\n            // Handle null/undefined/boolean\r\n            if (element === null || element === undefined || typeof element === 'boolean') {\r\n                return { $$type: 'null' };\r\n            }\r\n\r\n            // Handle primitives\r\n            if (typeof element === 'string') {\r\n                return { $$type: 'text', value: element };\r\n            }\r\n            if (typeof element === 'number') {\r\n                return { $$type: 'text', value: String(element) };\r\n            }\r\n\r\n            // Handle arrays (fragments)\r\n            if (Array.isArray(element)) {\r\n                const children = await Promise.all(\r\n                    element.map(child => this.renderElement(child, ctx))\r\n                );\r\n                return { $$type: 'fragment', children };\r\n            }\r\n\r\n            // Handle Client References\r\n            if (isClientReference(element)) {\r\n                return this.renderClientReference(element, ctx);\r\n            }\r\n\r\n            // Handle framework elements\r\n            if (this.adapter.isElement(element)) {\r\n                return this.renderFrameworkElement(element, ctx);\r\n            }\r\n\r\n            // Unknown - try to convert\r\n            return toFlightElement(element);\r\n\r\n        } finally {\r\n            this.depth--;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render a framework-specific element\r\n     */\r\n    private async renderFrameworkElement(\r\n        element: unknown,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        const typeInfo = this.adapter.getElementType(element);\r\n        const props = this.adapter.getProps(element);\r\n        const key = this.adapter.getKey(element);\r\n\r\n        switch (typeInfo.kind) {\r\n            case 'host':\r\n                return this.renderHostElement(typeInfo.tag, props, key, ctx);\r\n\r\n            case 'component':\r\n                return this.renderComponent(typeInfo.fn, typeInfo.name, props, ctx);\r\n\r\n            case 'fragment': {\r\n                const children = this.adapter.getChildren(element);\r\n                const renderedChildren = await Promise.all(\r\n                    children.map(child => this.renderElement(child, ctx))\r\n                );\r\n                return { $$type: 'fragment', children: renderedChildren };\r\n            }\r\n\r\n            case 'suspense': {\r\n                return this.renderSuspense(element, typeInfo.fallback, ctx);\r\n            }\r\n\r\n            case 'text':\r\n                return { $$type: 'text', value: typeInfo.value };\r\n\r\n            case 'null':\r\n                return { $$type: 'null' };\r\n\r\n            default:\r\n                return { $$type: 'null' };\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render a host element (div, span, etc.)\r\n     */\r\n    private async renderHostElement(\r\n        tag: string,\r\n        props: Record<string, unknown>,\r\n        key: string | number | undefined,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        // Extract children\r\n        const { children: childrenProp, ...restProps } = props;\r\n\r\n        // Serialize props (excluding functions and children)\r\n        const serializedProps: Record<string, unknown> = {};\r\n        for (const [propKey, value] of Object.entries(restProps)) {\r\n            if (typeof value !== 'function') {\r\n                serializedProps[propKey] = serialize(value);\r\n            }\r\n        }\r\n\r\n        // Render children\r\n        const rawChildren = childrenProp ?\r\n            (Array.isArray(childrenProp) ? childrenProp : [childrenProp]) :\r\n            [];\r\n\r\n        const children = await Promise.all(\r\n            rawChildren.map(child => this.renderElement(child, ctx))\r\n        );\r\n\r\n        return {\r\n            $$type: 'host',\r\n            tag,\r\n            key,\r\n            props: serializedProps as Record<string, import('./payload.js').SerializedValue>,\r\n            children,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Render a component (server or client)\r\n     */\r\n    private async renderComponent(\r\n        component: ComponentFn,\r\n        name: string,\r\n        props: Record<string, unknown>,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        // Check if this is a client component\r\n        if (this.adapter.isClientBoundary(component)) {\r\n            return this.renderClientBoundary(component, name, props, ctx);\r\n        }\r\n\r\n        // Execute server component\r\n        try {\r\n            const result = await component(props, ctx);\r\n            return this.renderElement(result, ctx);\r\n        } catch (error) {\r\n            // Check for Suspense promise\r\n            if (error instanceof Promise) {\r\n                return this.renderAsyncBoundary(error, name, props, ctx);\r\n            }\r\n\r\n            this.options.onError?.(error as Error, name);\r\n            throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render a client boundary\r\n     */\r\n    private async renderClientBoundary(\r\n        component: ComponentFn,\r\n        name: string,\r\n        props: Record<string, unknown>,\r\n        _ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        const chunkId = generateChunkId('c');\r\n\r\n        // Get module info from component\r\n        const moduleId = (component as unknown as { __flight_module?: string }).__flight_module ?? name;\r\n        const exportName = (component as unknown as { __flight_export?: string }).__flight_export ?? 'default';\r\n\r\n        // Generate SSR fallback if enabled\r\n        let fallback: string | undefined;\r\n        if (this.options.includeSSRFallbacks && this.adapter.renderToString) {\r\n            try {\r\n                // Create element with props for SSR\r\n                fallback = await this.adapter.renderToString(props);\r\n            } catch {\r\n                // SSR failed, continue without fallback\r\n            }\r\n        }\r\n\r\n        // Create client reference chunk\r\n        const clientChunk = createClientChunk(chunkId, moduleId, exportName, props, fallback);\r\n        this.clientRefs.push(clientChunk);\r\n        this.chunks.push(clientChunk);\r\n\r\n        return {\r\n            $$type: 'client',\r\n            ref: chunkId,\r\n            ssr: fallback,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Render a Suspense boundary\r\n     */\r\n    private async renderSuspense(\r\n        element: unknown,\r\n        fallbackElement: unknown,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        const boundaryId = generateChunkId('s');\r\n        const children = this.adapter.getChildren(element);\r\n\r\n        // Render fallback\r\n        const fallback = fallbackElement ?\r\n            await this.renderElement(fallbackElement, ctx) :\r\n            { $$type: 'null' as const };\r\n\r\n        // Render children\r\n        const renderedChildren: FlightElement[] = [];\r\n        for (const child of children) {\r\n            try {\r\n                const rendered = await this.renderElement(child, ctx);\r\n                renderedChildren.push(rendered);\r\n            } catch (error) {\r\n                if (error instanceof Promise) {\r\n                    // This is a suspended promise\r\n                    this.pendingPromises.set(boundaryId, error.then(async () => {\r\n                        const children = this.adapter.getChildren(element);\r\n                        const rendered = await Promise.all(\r\n                            children.map(c => this.renderElement(c, ctx))\r\n                        );\r\n                        return { $$type: 'fragment' as const, children: rendered };\r\n                    }));\r\n\r\n                    // Return suspense with fallback for now\r\n                    return {\r\n                        $$type: 'suspense',\r\n                        id: boundaryId,\r\n                        fallback,\r\n                        children: [{ $$type: 'lazy', id: boundaryId, fallback }],\r\n                    };\r\n                }\r\n                throw error;\r\n            }\r\n        }\r\n\r\n        return {\r\n            $$type: 'suspense',\r\n            id: boundaryId,\r\n            fallback,\r\n            children: renderedChildren,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Render an async boundary (promise thrown from component)\r\n     */\r\n    private renderAsyncBoundary(\r\n        promise: Promise<unknown>,\r\n        name: string,\r\n        props: Record<string, unknown>,\r\n        ctx: ServerContext\r\n    ): FlightElement {\r\n        const boundaryId = generateChunkId('a');\r\n\r\n        // Track this promise\r\n        this.pendingPromises.set(boundaryId,\r\n            promise.then(async () => {\r\n                // Re-render the component after promise resolves\r\n                const component = (props as unknown as { component: ComponentFn }).component;\r\n                if (component) {\r\n                    const result = await component(props, ctx);\r\n                    return this.renderElement(result, ctx);\r\n                }\r\n                return { $$type: 'null' as const };\r\n            })\r\n        );\r\n\r\n        return {\r\n            $$type: 'lazy',\r\n            id: boundaryId,\r\n            fallback: { $$type: 'text', value: `Loading ${name}...` },\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Render a Client Reference directly\r\n     */\r\n    private async renderClientReference(\r\n        ref: ClientReference,\r\n        _ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        const chunkId = generateChunkId('c');\r\n\r\n        const clientChunk = createClientChunk(\r\n            chunkId,\r\n            ref.__flight_module,\r\n            ref.__flight_export,\r\n            {} // Props are embedded in the reference\r\n        );\r\n\r\n        this.clientRefs.push(clientChunk);\r\n        this.chunks.push(clientChunk);\r\n\r\n        return {\r\n            $$type: 'client',\r\n            ref: chunkId,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Resolve all pending async chunks\r\n     */\r\n    private async resolvePendingChunks(_ctx: ServerContext): Promise<void> {\r\n        while (this.pendingPromises.size > 0) {\r\n            const entries = [...this.pendingPromises.entries()];\r\n\r\n            for (const [id, promise] of entries) {\r\n                try {\r\n                    const tree = await promise;\r\n                    this.chunks.push(createServerChunk(id, tree));\r\n                } catch (error) {\r\n                    this.chunks.push(createErrorChunk(id, error as Error, this.options.dev));\r\n                }\r\n                this.pendingPromises.delete(id);\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// Helper Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Create a renderer with adapter\r\n */\r\nexport function createRenderer(\r\n    adapter: UIAdapter,\r\n    options?: RenderOptions\r\n): FlightRenderer {\r\n    return new FlightRenderer(adapter, options);\r\n}\r\n\r\n/**\r\n * Render a server component tree\r\n */\r\nexport async function renderServerComponent<P>(\r\n    component: ComponentFn,\r\n    props: P,\r\n    ctx: ServerContext,\r\n    adapter: UIAdapter,\r\n    options?: RenderOptions\r\n): Promise<RenderResult> {\r\n    const renderer = createRenderer(adapter, options);\r\n\r\n    // Create root element\r\n    const element = {\r\n        type: component,\r\n        props: props as Record<string, unknown>,\r\n        $$typeof: Symbol.for('react.element')\r\n    };\r\n\r\n    return renderer.render(element, ctx);\r\n}\r\n\r\n/**\r\n * Render server component as streaming chunks\r\n */\r\nexport async function* renderServerComponentStreaming<P>(\r\n    component: ComponentFn,\r\n    props: P,\r\n    ctx: ServerContext,\r\n    adapter: UIAdapter,\r\n    options?: RenderOptions\r\n): AsyncGenerator<FlightChunk> {\r\n    const renderer = createRenderer(adapter, options);\r\n\r\n    const element = {\r\n        type: component,\r\n        props: props as Record<string, unknown>,\r\n        $$typeof: Symbol.for('react.element')\r\n    };\r\n\r\n    yield* renderer.renderStreaming(element, ctx);\r\n}\r\n"]}

package/dist/chunk-K2CQZPCG.js

@@ -0,0 +1,257 @@
+// src/rsc/payload.ts
+function serialize(value) {
+  return serializeValue(value, /* @__PURE__ */ new WeakSet());
+}
+function serializeValue(value, seen) {
+  if (value === null) return null;
+  if (value === void 0) return { $$flight: "undefined", value: "" };
+  if (typeof value === "string") return value;
+  if (typeof value === "number") {
+    if (Number.isNaN(value)) return { $$flight: "undefined", value: "NaN" };
+    if (!Number.isFinite(value)) return { $$flight: "undefined", value: value > 0 ? "Infinity" : "-Infinity" };
+    return value;
+  }
+  if (typeof value === "boolean") return value;
+  if (typeof value === "bigint") return { $$flight: "bigint", value: value.toString() };
+  if (typeof value === "symbol") return { $$flight: "symbol", value: value.description ?? "" };
+  if (typeof value === "function") {
+    throw new FlightSerializationError(
+      "Functions cannot be passed from Server to Client Components. If you need to pass a function, use a Server Action instead."
+    );
+  }
+  if (typeof value === "object") {
+    if (seen.has(value)) {
+      throw new FlightSerializationError("Circular references are not supported in Flight payloads.");
+    }
+    seen.add(value);
+  }
+  if (value instanceof Date) {
+    return { $$flight: "date", value: value.toISOString() };
+  }
+  if (value instanceof RegExp) {
+    return { $$flight: "regexp", value: value.toString() };
+  }
+  if (value instanceof URL) {
+    return { $$flight: "url", value: value.href };
+  }
+  if (value instanceof Map) {
+    const entries = [];
+    for (const [k, v] of value) {
+      entries.push([serializeValue(k, seen), serializeValue(v, seen)]);
+    }
+    return { $$flight: "map", value: entries };
+  }
+  if (value instanceof Set) {
+    const items = [];
+    for (const v of value) {
+      items.push(serializeValue(v, seen));
+    }
+    return { $$flight: "set", value: items };
+  }
+  if (value instanceof Error) {
+    return {
+      $$flight: "error",
+      value: JSON.stringify({ name: value.name, message: value.message })
+    };
+  }
+  if (Array.isArray(value)) {
+    return value.map((v) => serializeValue(v, seen));
+  }
+  if (isPlainObject(value)) {
+    const result = {};
+    for (const [k, v] of Object.entries(value)) {
+      result[k] = serializeValue(v, seen);
+    }
+    return result;
+  }
+  try {
+    return JSON.parse(JSON.stringify(value));
+  } catch {
+    throw new FlightSerializationError(
+      `Cannot serialize value of type ${value?.constructor?.name ?? typeof value}. Only serializable values can be passed to Client Components.`
+    );
+  }
+}
+function deserialize(value) {
+  return deserializeValue(value);
+}
+function deserializeValue(value) {
+  if (value === null || value === void 0) return value;
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (isSpecialValue(value)) {
+    switch (value.$$flight) {
+      case "undefined":
+        if (value.value === "NaN") return NaN;
+        if (value.value === "Infinity") return Infinity;
+        if (value.value === "-Infinity") return -Infinity;
+        return void 0;
+      case "date":
+        return new Date(value.value);
+      case "bigint":
+        return BigInt(value.value);
+      case "symbol":
+        return Symbol(value.value);
+      case "regexp": {
+        const match = value.value.match(/^\/(.*)\/([gimsuy]*)$/);
+        if (match) return new RegExp(match[1], match[2]);
+        return new RegExp(value.value);
+      }
+      case "url":
+        return new URL(value.value);
+      case "map":
+        return new Map(value.value.map(([k, v]) => [deserializeValue(k), deserializeValue(v)]));
+      case "set":
+        return new Set(value.value.map((v) => deserializeValue(v)));
+      case "error": {
+        const { name, message } = JSON.parse(value.value);
+        const error = new Error(message);
+        error.name = name;
+        return error;
+      }
+    }
+  }
+  if (Array.isArray(value)) {
+    return value.map(deserializeValue);
+  }
+  if (typeof value === "object") {
+    const result = {};
+    for (const [k, v] of Object.entries(value)) {
+      result[k] = deserializeValue(v);
+    }
+    return result;
+  }
+  return value;
+}
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === null || proto === Object.prototype;
+}
+function isSpecialValue(value) {
+  return typeof value === "object" && value !== null && "$$flight" in value;
+}
+function h(tag, props, ...children) {
+  const serializedProps = {};
+  if (props) {
+    for (const [key, value] of Object.entries(props)) {
+      if (key !== "children") {
+        serializedProps[key] = serialize(value);
+      }
+    }
+  }
+  return {
+    $$type: "host",
+    tag,
+    props: serializedProps,
+    children: children.flat().map((child) => toFlightElement(child))
+  };
+}
+function text(value) {
+  return { $$type: "text", value };
+}
+function fragment(...children) {
+  return {
+    $$type: "fragment",
+    children: children.flat().map((child) => toFlightElement(child))
+  };
+}
+function suspense(id, fallback, children) {
+  return { $$type: "suspense", id, fallback, children };
+}
+function clientRef(refId, ssrHtml) {
+  return { $$type: "client", ref: refId, ssr: ssrHtml };
+}
+function toFlightElement(value) {
+  if (value === null || value === void 0 || typeof value === "boolean") {
+    return { $$type: "null" };
+  }
+  if (typeof value === "string" || typeof value === "number") {
+    return { $$type: "text", value: String(value) };
+  }
+  if (isFlightElement(value)) {
+    return value;
+  }
+  return { $$type: "null" };
+}
+function isFlightElement(value) {
+  return typeof value === "object" && value !== null && "$$type" in value;
+}
+var chunkIdCounter = 0;
+function generateChunkId(prefix = "c") {
+  return `${prefix}${chunkIdCounter++}`;
+}
+function resetChunkIdCounter() {
+  chunkIdCounter = 0;
+}
+function createServerChunk(id, tree, awaiting) {
+  return {
+    type: "S",
+    id,
+    tree,
+    awaiting,
+    ts: Date.now()
+  };
+}
+function createClientChunk(id, module, exportName, props, fallback) {
+  return {
+    type: "C",
+    id,
+    module,
+    export: exportName,
+    props: serialize(props),
+    fallback
+  };
+}
+function createActionChunk(id, boundArgs) {
+  return {
+    type: "A",
+    id,
+    bound: boundArgs?.map(serialize)
+  };
+}
+function createErrorChunk(boundary, error, includeStack = false) {
+  return {
+    type: "E",
+    boundary,
+    message: error.message,
+    digest: generateErrorDigest(error),
+    stack: includeStack ? error.stack : void 0
+  };
+}
+function createHintChunk(hint, href, options) {
+  return {
+    type: "H",
+    hint,
+    href,
+    ...options
+  };
+}
+function generateErrorDigest(error) {
+  const str = `${error.name}:${error.message}:${Date.now()}`;
+  let hash = 0;
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i);
+    hash = (hash << 5) - hash + char;
+    hash = hash & hash;
+  }
+  return Math.abs(hash).toString(36);
+}
+var FlightSerializationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FlightSerializationError";
+  }
+};
+var FlightPayloadError = class extends Error {
+  constructor(message, chunk) {
+    super(message);
+    this.chunk = chunk;
+    this.name = "FlightPayloadError";
+  }
+};
+
+export { FlightPayloadError, FlightSerializationError, clientRef, createActionChunk, createClientChunk, createErrorChunk, createHintChunk, createServerChunk, deserialize, fragment, generateChunkId, h, isFlightElement, resetChunkIdCounter, serialize, suspense, text, toFlightElement };
+//# sourceMappingURL=chunk-K2CQZPCG.js.map
+//# sourceMappingURL=chunk-K2CQZPCG.js.map