@flightdev/ui 2.0.0 → 4.0.0

package/dist/core/index.d.ts

@@ -1,5 +1,425 @@
-import { U as UIAdapterV2, d as AdapterTier, A as AdapterCapabilities } from '../adapter-MMD-iHNx.js';
-export { B as BaseUIAdapter, C as Component, e as ComponentProps, D as DEFAULT_CAPABILITIES, H as HasCapability, i as Island, I as IslandHydrationStrategy, h as IslandOptions, R as RenderContext, c as RenderResult, f as RenderTiming, S as StreamingOptions, g as StreamingRenderResult, k as TIER_INFO, T as TierInfo, j as UIAdapter, a as UIAdapterV1, b as UIConfig, n as getCapabilities, m as hasCapability, l as isV2Adapter, w as wrapV1Adapter } from '../adapter-MMD-iHNx.js';
+/**
+ * @flightdev/ui - Core Type Definitions
+ *
+ * Universal type system for all UI framework adapters.
+ * Supports SSR, streaming, islands architecture, and resumable hydration.
+ *
+ * @module @flightdev/ui/core/types
+ * @version 2.0.0
+ */
+/**
+ * Adapter capabilities flags.
+ * Used for feature detection and optimization decisions.
+ */
+interface AdapterCapabilities {
+    /** Supports streaming SSR via renderToStream */
+    streaming: boolean;
+    /** Supports partial/selective hydration */
+    partialHydration: boolean;
+    /** Supports islands architecture */
+    islands: boolean;
+    /** Supports resumable hydration (Qwik-style serialization) */
+    resumable: boolean;
+    /** Supports Static Site Generation */
+    ssg: boolean;
+    /** Supports Client-Side Rendering only */
+    csr: boolean;
+    /** Supports Server Components (React Server Components, etc) */
+    serverComponents: boolean;
+}
+/**
+ * Default capabilities for adapters that don't specify their own
+ */
+declare const DEFAULT_CAPABILITIES: AdapterCapabilities;
+/**
+ * Adapter tier classification.
+ *
+ * - tier-1: Full support, first-class citizens (React, Vue, Angular, Svelte, Solid, Qwik)
+ * - tier-2: SSR + Hydration support (Preact, Lit, Marko, Stencil, Mithril, Inferno)
+ * - tier-3: HTML-first, minimal JS (HTMX, Alpine, Hotwire, Stimulus, Web Components)
+ */
+type AdapterTier = 'tier-1' | 'tier-2' | 'tier-3';
+/**
+ * Tier metadata for documentation and tooling
+ */
+interface TierInfo {
+    tier: AdapterTier;
+    name: string;
+    description: string;
+    features: string[];
+}
+declare const TIER_INFO: Record<AdapterTier, TierInfo>;
+/**
+ * Universal component wrapper type
+ */
+interface Component<P = Record<string, unknown>> {
+    /** The actual component (React element, Vue component, HTML string, etc) */
+    component: unknown;
+    /** Props to pass to the component */
+    props?: P;
+    /** Slots/children content */
+    children?: unknown;
+    /** Component identifier for hydration */
+    id?: string;
+}
+/**
+ * Render context passed to adapters
+ */
+interface RenderContext {
+    /** Current request URL */
+    url?: string;
+    /** Request headers */
+    headers?: Headers;
+    /** Server-side cookies */
+    cookies?: Map<string, string>;
+    /** Locale for i18n */
+    locale?: string;
+    /** Custom context data */
+    data?: Record<string, unknown>;
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Result of a render operation
+ */
+interface RenderResult {
+    /** The rendered HTML string */
+    html: string;
+    /** Head elements (meta, title, link, etc) */
+    head?: string;
+    /** Hydration data to pass to client */
+    hydrationData?: Record<string, unknown>;
+    /** CSS to inline in the document */
+    css?: string;
+    /** Scripts to inject */
+    scripts?: string[];
+    /** HTTP status code (for error pages, redirects) */
+    status?: number;
+    /** HTTP headers to set */
+    headers?: Record<string, string>;
+    /** Timing information for performance monitoring */
+    timing?: RenderTiming;
+}
+/**
+ * Render timing information
+ */
+interface RenderTiming {
+    /** Total render time in milliseconds */
+    total: number;
+    /** Time to first byte */
+    ttfb?: number;
+    /** Component render times */
+    components?: Map<string, number>;
+}
+/**
+ * Streaming render options
+ */
+interface StreamingOptions {
+    /** Emit shell HTML before async content resolves */
+    emitShellEarly?: boolean;
+    /** Timeout for streaming (ms) */
+    timeout?: number;
+    /** Callback when shell is ready */
+    onShellReady?: () => void;
+    /** Callback when shell errors */
+    onShellError?: (error: Error) => void;
+    /** Callback when all content is ready */
+    onAllReady?: () => void;
+    /** Callback for each error during streaming */
+    onError?: (error: Error, errorInfo?: unknown) => void;
+}
+/**
+ * Streaming render result
+ */
+interface StreamingRenderResult {
+    /** The readable stream of HTML chunks */
+    stream: ReadableStream<Uint8Array>;
+    /** Promise that resolves when streaming is complete */
+    done: Promise<void>;
+    /** Abort the stream */
+    abort: () => void;
+}
+/**
+ * Island hydration strategy
+ */
+type IslandHydrationStrategy = 'load' | 'idle' | 'visible' | 'media' | 'interaction' | 'none';
+/**
+ * Island configuration options
+ */
+interface IslandOptions {
+    /** Hydration strategy */
+    hydrate?: IslandHydrationStrategy;
+    /** For 'media' strategy: the media query */
+    media?: string;
+    /** For 'interaction' strategy: events to listen for */
+    on?: string[];
+    /** Island priority (higher = hydrate first) */
+    priority?: number;
+    /** Fallback content while loading */
+    fallback?: string;
+}
+/**
+ * Island definition
+ */
+interface Island {
+    /** Unique island identifier */
+    id: string;
+    /** The component to render */
+    component: unknown;
+    /** Component props */
+    props?: Record<string, unknown>;
+    /** Island options */
+    options?: IslandOptions;
+    /** Rendered HTML placeholder */
+    placeholder?: string;
+}
+/**
+ * Universal UI Adapter Interface (Version 2)
+ *
+ * All UI framework adapters must implement this interface.
+ * Optional methods are for advanced features (streaming, islands, etc).
+ */
+interface UIAdapterV2 {
+    /** Unique adapter identifier (e.g., 'react', 'vue', 'angular') */
+    readonly id: string;
+    /** Human-readable adapter name */
+    readonly name: string;
+    /** Framework name */
+    readonly framework: string;
+    /** Framework version compatibility */
+    readonly frameworkVersion?: string;
+    /** Adapter tier classification */
+    readonly tier: AdapterTier;
+    /** Supported capabilities */
+    readonly capabilities: AdapterCapabilities;
+    /**
+     * Render a component to an HTML string.
+     * This is the primary SSR method.
+     */
+    renderToString(component: Component, context?: RenderContext): Promise<RenderResult>;
+    /**
+     * Generate the hydration script for client-side hydration.
+     */
+    getHydrationScript(result: RenderResult): string;
+    /**
+     * Get the client-side entry point code.
+     */
+    getClientEntry(): string;
+    /**
+     * Render a component as a stream (for streaming SSR).
+     * Only available if capabilities.streaming is true.
+     */
+    renderToStream?(component: Component, context?: RenderContext, options?: StreamingOptions): StreamingRenderResult;
+    /**
+     * Create an island wrapper for partial hydration.
+     * Only available if capabilities.islands is true.
+     */
+    createIsland?(component: unknown, props?: Record<string, unknown>, options?: IslandOptions): Island;
+    /**
+     * Hydrate an island on the client.
+     */
+    hydrateIsland?(element: Element, island: Island): void;
+    /**
+     * Serialize component state for resumable hydration.
+     * Only available if capabilities.resumable is true.
+     */
+    serializeState?(state: unknown): string;
+    /**
+     * Resume from serialized state.
+     */
+    resumeFromState?(serialized: string): unknown;
+    /**
+     * Initialize the adapter (load dependencies, warm up caches, etc).
+     */
+    init?(): Promise<void>;
+    /**
+     * Clean up resources.
+     */
+    dispose?(): Promise<void>;
+    /**
+     * Transform a component for SSR if needed.
+     */
+    transformForSSR?(component: unknown): unknown;
+}
+/**
+ * Legacy V1 adapter interface for backward compatibility.
+ * @deprecated Use UIAdapterV2 instead
+ */
+interface UIAdapterV1 {
+    readonly name: string;
+    readonly framework: string;
+    renderToString(component: Component): Promise<RenderResult>;
+    getHydrationScript(result: RenderResult): string;
+    getClientEntry(): string;
+    transformForSSR?(component: unknown): unknown;
+}
+/**
+ * Type alias for backward compatibility
+ * @deprecated Use UIAdapterV2 instead
+ */
+type UIAdapter = UIAdapterV1;
+/**
+ * UI configuration for Flight
+ */
+interface UIConfig {
+    /** The UI adapter to use */
+    adapter: UIAdapterV2 | UIAdapterV1;
+    /** Enable streaming SSR */
+    streaming?: boolean;
+    /** Hydration strategy */
+    hydration?: 'full' | 'partial' | 'progressive' | 'none';
+    /** Islands mode */
+    islands?: boolean;
+    /** Default island hydration strategy */
+    defaultIslandStrategy?: IslandHydrationStrategy;
+}
+/**
+ * Extract props type from a component
+ */
+type ComponentProps<C> = C extends Component<infer P> ? P : never;
+/**
+ * Check if adapter supports a capability
+ */
+type HasCapability<A extends UIAdapterV2, C extends keyof AdapterCapabilities> = A['capabilities'][C] extends true ? true : false;
+
+/**
+ * @flightdev/ui - Base Adapter Class
+ *
+ * Abstract base class providing common functionality for all UI adapters.
+ * Extend this class to create new framework adapters.
+ *
+ * @module @flightdev/ui/core/adapter
+ * @version 2.0.0
+ */
+
+/**
+ * Abstract base class for UI adapters.
+ *
+ * Provides common functionality and sensible defaults.
+ * Subclasses must implement the abstract methods.
+ *
+ * @example
+ * ```typescript
+ * class MyAdapter extends BaseUIAdapter {
+ *   readonly id = 'my-framework';
+ *   readonly name = 'My Framework';
+ *   readonly framework = 'my-framework';
+ *   readonly tier = 'tier-2';
+ *
+ *   async renderToString(component: Component): Promise<RenderResult> {
+ *     // Implementation
+ *   }
+ * }
+ * ```
+ */
+declare abstract class BaseUIAdapter implements UIAdapterV2 {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly framework: string;
+    abstract readonly tier: AdapterTier;
+    readonly capabilities: AdapterCapabilities;
+    readonly frameworkVersion?: string;
+    abstract renderToString(component: Component, context?: RenderContext): Promise<RenderResult>;
+    /**
+     * Generate hydration script.
+     * Override for framework-specific hydration.
+     */
+    getHydrationScript(result: RenderResult): string;
+    /**
+     * Get client entry point code.
+     * Override for framework-specific client initialization.
+     */
+    getClientEntry(): string;
+    /**
+     * Escape HTML entities to prevent XSS
+     */
+    protected escapeHtml(str: string): string;
+    /**
+     * Serialize props to JSON for hydration
+     */
+    protected serializeProps(props: unknown): string;
+    /**
+     * JSON replacer for serialization
+     */
+    protected jsonReplacer(_key: string, value: unknown): unknown;
+    /**
+     * Create a hydration marker comment
+     */
+    protected createHydrationMarker(id: string, type?: 'start' | 'end'): string;
+    /**
+     * Wrap content with hydration markers
+     */
+    protected wrapWithMarkers(id: string, content: string): string;
+    /**
+     * Generate a unique component ID
+     */
+    protected generateId(): string;
+    /**
+     * Create timing information
+     */
+    protected createTiming(startTime: number): {
+        total: number;
+    };
+    /**
+     * Merge render context with defaults
+     */
+    protected mergeContext(context?: RenderContext): RenderContext;
+    /**
+     * Render to stream (override if capabilities.streaming is true)
+     */
+    renderToStream?(_component: Component, _context?: RenderContext, _options?: StreamingOptions): StreamingRenderResult;
+    /**
+     * Create an island (default implementation)
+     * Override for framework-specific island behavior.
+     */
+    createIsland(component: unknown, props?: Record<string, unknown>, options?: IslandOptions): Island;
+    /**
+     * Hydrate an island on the client
+     */
+    hydrateIsland?(_element: Element, _island: Island): void;
+    /**
+     * Serialize state for resumability
+     */
+    serializeState?(state: unknown): string;
+    /**
+     * Resume from serialized state
+     */
+    resumeFromState?(serialized: string): unknown;
+    /**
+     * JSON reviver for deserialization
+     */
+    protected jsonReviver(_key: string, value: unknown): unknown;
+    /**
+     * Initialize the adapter
+     */
+    init(): Promise<void>;
+    /**
+     * Clean up resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Wrap a V1 adapter to make it compatible with V2 interface.
+ *
+ * @example
+ * ```typescript
+ * const legacyAdapter = oldReact();
+ * const v2Adapter = wrapV1Adapter(legacyAdapter, 'tier-1');
+ * ```
+ */
+declare function wrapV1Adapter(v1Adapter: UIAdapterV1, tier?: AdapterTier): UIAdapterV2;
+/**
+ * Check if an adapter is V2 compatible
+ */
+declare function isV2Adapter(adapter: unknown): adapter is UIAdapterV2;
+/**
+ * Check if an adapter supports a specific capability
+ */
+declare function hasCapability(adapter: UIAdapterV2, capability: keyof AdapterCapabilities): boolean;
+/**
+ * Get all capabilities of an adapter as an array
+ */
+declare function getCapabilities(adapter: UIAdapterV2): (keyof AdapterCapabilities)[];
 
 /**
  * @flightdev/ui - Adapter Registry
@@ -158,4 +578,4 @@ declare const adapterRegistry: AdapterRegistry;
  */
 declare function registerBuiltinAdapters(): void;
 
-export { AdapterCapabilities, type AdapterLoader, type AdapterMetadata, AdapterTier, type RegistryQueryOptions, UIAdapterV2, adapterRegistry, registerBuiltinAdapters };
+export { type AdapterCapabilities, type AdapterLoader, type AdapterMetadata, type AdapterTier, BaseUIAdapter, type Component, type ComponentProps, DEFAULT_CAPABILITIES, type HasCapability, type Island, type IslandHydrationStrategy, type IslandOptions, type RegistryQueryOptions, type RenderContext, type RenderResult, type RenderTiming, type StreamingOptions, type StreamingRenderResult, TIER_INFO, type TierInfo, type UIAdapter, type UIAdapterV1, type UIAdapterV2, type UIConfig, adapterRegistry, getCapabilities, hasCapability, isV2Adapter, registerBuiltinAdapters, wrapV1Adapter };

package/dist/core/index.js

@@ -1,2 +1,23 @@
-export { DEFAULT_CAPABILITIES, TIER_INFO, adapterRegistry, registerBuiltinAdapters } from '../chunk-XTDK7ME5.js';
-export { BaseUIAdapter, getCapabilities, hasCapability, isV2Adapter, wrapV1Adapter } from '../chunk-2SNQ6PTM.js';
+import {
+  BaseUIAdapter,
+  DEFAULT_CAPABILITIES,
+  TIER_INFO,
+  adapterRegistry,
+  getCapabilities,
+  hasCapability,
+  isV2Adapter,
+  registerBuiltinAdapters,
+  wrapV1Adapter
+} from "../chunk-S4DTUQII.js";
+export {
+  BaseUIAdapter,
+  DEFAULT_CAPABILITIES,
+  TIER_INFO,
+  adapterRegistry,
+  getCapabilities,
+  hasCapability,
+  isV2Adapter,
+  registerBuiltinAdapters,
+  wrapV1Adapter
+};
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -1,6 +1,5 @@
-import { U as UIAdapterV2, a as UIAdapterV1, I as IslandHydrationStrategy, b as UIConfig, C as Component, R as RenderContext, c as RenderResult } from './adapter-MMD-iHNx.js';
-export { A as AdapterCapabilities, d as AdapterTier, B as BaseUIAdapter, e as ComponentProps, D as DEFAULT_CAPABILITIES, H as HasCapability, i as Island, h as IslandOptions, f as RenderTiming, S as StreamingOptions, g as StreamingRenderResult, k as TIER_INFO, T as TierInfo, j as UIAdapter, n as getCapabilities, m as hasCapability, l as isV2Adapter, w as wrapV1Adapter } from './adapter-MMD-iHNx.js';
-export { AdapterLoader, AdapterMetadata, RegistryQueryOptions, adapterRegistry, registerBuiltinAdapters } from './core/index.js';
+import { UIAdapterV2, UIAdapterV1, IslandHydrationStrategy, UIConfig, Component, RenderContext, RenderResult } from './core/index.js';
+export { AdapterCapabilities, AdapterLoader, AdapterMetadata, AdapterTier, BaseUIAdapter, ComponentProps, DEFAULT_CAPABILITIES, HasCapability, Island, IslandOptions, RegistryQueryOptions, RenderTiming, StreamingOptions, StreamingRenderResult, TIER_INFO, TierInfo, UIAdapter, adapterRegistry, getCapabilities, hasCapability, isV2Adapter, registerBuiltinAdapters, wrapV1Adapter } from './core/index.js';
 
 /**
  * @flightdev/ui - Universal UI Framework Layer

package/dist/index.js

@@ -1,6 +1,14 @@
-export { DEFAULT_CAPABILITIES, TIER_INFO, adapterRegistry, registerBuiltinAdapters } from './chunk-XTDK7ME5.js';
-import { isV2Adapter } from './chunk-2SNQ6PTM.js';
-export { BaseUIAdapter, getCapabilities, hasCapability, isV2Adapter, wrapV1Adapter } from './chunk-2SNQ6PTM.js';
+import {
+  BaseUIAdapter,
+  DEFAULT_CAPABILITIES,
+  TIER_INFO,
+  adapterRegistry,
+  getCapabilities,
+  hasCapability,
+  isV2Adapter,
+  registerBuiltinAdapters,
+  wrapV1Adapter
+} from "./chunk-S4DTUQII.js";
 
 // src/index.ts
 function defineUI(adapter, options = {}) {
@@ -67,5 +75,21 @@ function getPackageInfo() {
     totalAdapters: 18
   };
 }
-
-export { VERSION, defineUI, getPackageInfo, renderPage, renderPageStream, toHTML };
+export {
+  BaseUIAdapter,
+  DEFAULT_CAPABILITIES,
+  TIER_INFO,
+  VERSION,
+  adapterRegistry,
+  defineUI,
+  getCapabilities,
+  getPackageInfo,
+  hasCapability,
+  isV2Adapter,
+  registerBuiltinAdapters,
+  renderPage,
+  renderPageStream,
+  toHTML,
+  wrapV1Adapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\r\n * @flightdev/ui - Universal UI Framework Layer\r\n *\r\n * Universal SSR and hydration for 18+ UI frameworks.\r\n * From React to Angular, Vue to HTMX, Svelte to Web Components.\r\n *\r\n * @module @flightdev/ui\r\n * @version 2.0.0\r\n *\r\n * @example Basic Usage\r\n * ```typescript\r\n * import { defineUI } from '@flightdev/ui';\r\n * import { react } from '@flightdev/ui/react';\r\n *\r\n * export default defineUI(react());\r\n * ```\r\n *\r\n * @example With Streaming SSR\r\n * ```typescript\r\n * import { defineUI } from '@flightdev/ui';\r\n * import { react } from '@flightdev/ui/react';\r\n *\r\n * export default defineUI(react(), {\r\n *   streaming: true,\r\n *   hydration: 'progressive',\r\n * });\r\n * ```\r\n *\r\n * @example Using Adapter Registry\r\n * ```typescript\r\n * import { adapterRegistry } from '@flightdev/ui';\r\n *\r\n * // Get adapter dynamically\r\n * const adapter = await adapterRegistry.get('vue');\r\n *\r\n * // List all by tier\r\n * const tier1 = adapterRegistry.listByTier('tier-1');\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Core Types & Utilities\r\n// ============================================================================\r\n\r\nexport type {\r\n    // Capability System\r\n    AdapterCapabilities,\r\n    AdapterTier,\r\n    TierInfo,\r\n\r\n    // Component & Rendering\r\n    Component,\r\n    ComponentProps,\r\n    RenderContext,\r\n    RenderResult,\r\n    RenderTiming,\r\n\r\n    // Streaming\r\n    StreamingOptions,\r\n    StreamingRenderResult,\r\n\r\n    // Islands Architecture\r\n    IslandHydrationStrategy,\r\n    IslandOptions,\r\n    Island,\r\n\r\n    // Adapter Interfaces\r\n    UIAdapterV2,\r\n    UIAdapterV1,\r\n    UIAdapter,\r\n    UIConfig,\r\n\r\n    // Utility Types\r\n    HasCapability,\r\n} from './core/types.js';\r\n\r\nexport {\r\n    DEFAULT_CAPABILITIES,\r\n    TIER_INFO,\r\n} from './core/types.js';\r\n\r\n// Base Adapter & Utilities\r\nexport {\r\n    BaseUIAdapter,\r\n    wrapV1Adapter,\r\n    isV2Adapter,\r\n    hasCapability,\r\n    getCapabilities,\r\n} from './core/adapter.js';\r\n\r\n// Registry\r\nexport type {\r\n    AdapterLoader,\r\n    AdapterMetadata,\r\n    RegistryQueryOptions,\r\n} from './core/registry.js';\r\n\r\nexport {\r\n    adapterRegistry,\r\n    registerBuiltinAdapters,\r\n} from './core/registry.js';\r\n\r\n// ============================================================================\r\n// Factory Function\r\n// ============================================================================\r\n\r\nimport type { UIAdapterV2, UIAdapterV1, UIConfig, IslandHydrationStrategy } from './core/types.js';\r\n\r\n/**\r\n * Define UI configuration for Flight.\r\n *\r\n * @example\r\n * ```typescript\r\n * import { defineUI } from '@flightdev/ui';\r\n * import { react } from '@flightdev/ui/react';\r\n *\r\n * export const ui = defineUI(react(), {\r\n *   streaming: true,\r\n *   hydration: 'progressive',\r\n * });\r\n * ```\r\n */\r\nexport function defineUI(\r\n    adapter: UIAdapterV2 | UIAdapterV1,\r\n    options: {\r\n        streaming?: boolean;\r\n        hydration?: 'full' | 'partial' | 'progressive' | 'none';\r\n        islands?: boolean;\r\n        defaultIslandStrategy?: IslandHydrationStrategy;\r\n    } = {}\r\n): UIConfig {\r\n    return {\r\n        adapter,\r\n        streaming: options.streaming ?? false,\r\n        hydration: options.hydration ?? 'full',\r\n        islands: options.islands ?? false,\r\n        defaultIslandStrategy: options.defaultIslandStrategy ?? 'idle',\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Render Utilities\r\n// ============================================================================\r\n\r\nimport type { Component, RenderResult, RenderContext } from './core/types.js';\r\nimport { isV2Adapter } from './core/adapter.js';\r\n\r\n/**\r\n * Render a page with the configured UI adapter.\r\n */\r\nexport async function renderPage(\r\n    config: UIConfig,\r\n    component: Component,\r\n    context?: RenderContext\r\n): Promise<RenderResult> {\r\n    const result = await config.adapter.renderToString(component, context);\r\n\r\n    // Add hydration script if needed\r\n    if (config.hydration !== 'none') {\r\n        const hydrationScript = config.adapter.getHydrationScript(result);\r\n        result.scripts = [...(result.scripts ?? []), hydrationScript];\r\n    }\r\n\r\n    return result;\r\n}\r\n\r\n/**\r\n * Render a page as a stream (if adapter supports streaming).\r\n */\r\nexport function renderPageStream(\r\n    config: UIConfig,\r\n    component: Component,\r\n    context?: RenderContext\r\n): ReadableStream<Uint8Array> | null {\r\n    if (!isV2Adapter(config.adapter) || !config.adapter.capabilities.streaming) {\r\n        return null;\r\n    }\r\n\r\n    const streamResult = config.adapter.renderToStream?.(component, context);\r\n    return streamResult?.stream ?? null;\r\n}\r\n\r\n/**\r\n * Generate full HTML document from render result.\r\n */\r\nexport function toHTML(\r\n    result: RenderResult,\r\n    options: {\r\n        lang?: string;\r\n        title?: string;\r\n        meta?: Record<string, string>;\r\n        charset?: string;\r\n        viewport?: string;\r\n    } = {}\r\n): string {\r\n    const {\r\n        lang = 'en',\r\n        title = 'Flight App',\r\n        meta = {},\r\n        charset = 'UTF-8',\r\n        viewport = 'width=device-width, initial-scale=1.0',\r\n    } = options;\r\n\r\n    const metaTags = Object.entries(meta)\r\n        .map(([name, content]) => `<meta name=\"${name}\" content=\"${content}\">`)\r\n        .join('\\n    ');\r\n\r\n    const scripts = result.scripts\r\n        ?.map((s) => (s.startsWith('<script') ? s : `<script>${s}</script>`))\r\n        .join('\\n    ') ?? '';\r\n\r\n    return `<!DOCTYPE html>\r\n<html lang=\"${lang}\">\r\n  <head>\r\n    <meta charset=\"${charset}\">\r\n    <meta name=\"viewport\" content=\"${viewport}\">\r\n    <title>${title}</title>\r\n    ${metaTags}\r\n    ${result.head ?? ''}\r\n    ${result.css ? `<style>${result.css}</style>` : ''}\r\n  </head>\r\n  <body>\r\n    <div id=\"app\">${result.html}</div>\r\n    ${scripts}\r\n  </body>\r\n</html>`;\r\n}\r\n\r\n// ============================================================================\r\n// Convenience Re-exports (Backward Compatibility)\r\n// ============================================================================\r\n\r\n// These maintain backward compatibility with v1 imports\r\n// e.g., import { react } from '@flightdev/ui'\r\n\r\n// Note: For tree-shaking, prefer deep imports:\r\n// import { react } from '@flightdev/ui/react'\r\n\r\n// ============================================================================\r\n// Version & Info\r\n// ============================================================================\r\n\r\n/**\r\n * Package version\r\n */\r\nexport const VERSION = '2.0.0';\r\n\r\n/**\r\n * Get information about the UI package\r\n */\r\nexport function getPackageInfo() {\r\n    return {\r\n        name: '@flightdev/ui',\r\n        version: VERSION,\r\n        description: 'Universal UI Framework Layer - SSR/hydration for 18+ frameworks',\r\n        tiers: {\r\n            'tier-1': ['react', 'vue', 'angular', 'svelte', 'solid', 'qwik'],\r\n            'tier-2': ['preact', 'lit', 'marko', 'stencil', 'mithril', 'inferno'],\r\n            'tier-3': ['htmx', 'alpine', 'hotwire', 'stimulus', 'petite-vue', 'vanilla'],\r\n        },\r\n        totalAdapters: 18,\r\n    };\r\n}\r\n"],"mappings":";;;;;;;;;;;;;AA0HO,SAAS,SACZ,SACA,UAKI,CAAC,GACG;AACR,SAAO;AAAA,IACH;AAAA,IACA,WAAW,QAAQ,aAAa;AAAA,IAChC,WAAW,QAAQ,aAAa;AAAA,IAChC,SAAS,QAAQ,WAAW;AAAA,IAC5B,uBAAuB,QAAQ,yBAAyB;AAAA,EAC5D;AACJ;AAYA,eAAsB,WAClB,QACA,WACA,SACqB;AACrB,QAAM,SAAS,MAAM,OAAO,QAAQ,eAAe,WAAW,OAAO;AAGrE,MAAI,OAAO,cAAc,QAAQ;AAC7B,UAAM,kBAAkB,OAAO,QAAQ,mBAAmB,MAAM;AAChE,WAAO,UAAU,CAAC,GAAI,OAAO,WAAW,CAAC,GAAI,eAAe;AAAA,EAChE;AAEA,SAAO;AACX;AAKO,SAAS,iBACZ,QACA,WACA,SACiC;AACjC,MAAI,CAAC,YAAY,OAAO,OAAO,KAAK,CAAC,OAAO,QAAQ,aAAa,WAAW;AACxE,WAAO;AAAA,EACX;AAEA,QAAM,eAAe,OAAO,QAAQ,iBAAiB,WAAW,OAAO;AACvE,SAAO,cAAc,UAAU;AACnC;AAKO,SAAS,OACZ,QACA,UAMI,CAAC,GACC;AACN,QAAM;AAAA,IACF,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,OAAO,CAAC;AAAA,IACR,UAAU;AAAA,IACV,WAAW;AAAA,EACf,IAAI;AAEJ,QAAM,WAAW,OAAO,QAAQ,IAAI,EAC/B,IAAI,CAAC,CAAC,MAAM,OAAO,MAAM,eAAe,IAAI,cAAc,OAAO,IAAI,EACrE,KAAK,QAAQ;AAElB,QAAM,UAAU,OAAO,SACjB,IAAI,CAAC,MAAO,EAAE,WAAW,SAAS,IAAI,IAAI,WAAW,CAAC,WAAY,EACnE,KAAK,QAAQ,KAAK;AAEvB,SAAO;AAAA,cACG,IAAI;AAAA;AAAA,qBAEG,OAAO;AAAA,qCACS,QAAQ;AAAA,aAChC,KAAK;AAAA,MACZ,QAAQ;AAAA,MACR,OAAO,QAAQ,EAAE;AAAA,MACjB,OAAO,MAAM,UAAU,OAAO,GAAG,aAAa,EAAE;AAAA;AAAA;AAAA,oBAGlC,OAAO,IAAI;AAAA,MACzB,OAAO;AAAA;AAAA;AAGb;AAmBO,IAAM,UAAU;AAKhB,SAAS,iBAAiB;AAC7B,SAAO;AAAA,IACH,MAAM;AAAA,IACN,SAAS;AAAA,IACT,aAAa;AAAA,IACb,OAAO;AAAA,MACH,UAAU,CAAC,SAAS,OAAO,WAAW,UAAU,SAAS,MAAM;AAAA,MAC/D,UAAU,CAAC,UAAU,OAAO,SAAS,WAAW,WAAW,SAAS;AAAA,MACpE,UAAU,CAAC,QAAQ,UAAU,WAAW,YAAY,cAAc,SAAS;AAAA,IAC/E;AAAA,IACA,eAAe;AAAA,EACnB;AACJ;","names":[]}