@flightdev/ui 2.0.1 → 4.0.0

package/dist/adapter-MMD-iHNx.d.ts

@@ -1,424 +0,0 @@
-/**
- * @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)[];
-
-export { type AdapterCapabilities as A, BaseUIAdapter as B, type Component as C, DEFAULT_CAPABILITIES as D, type HasCapability as H, type IslandHydrationStrategy as I, type RenderContext as R, type StreamingOptions as S, type TierInfo as T, type UIAdapterV2 as U, type UIAdapterV1 as a, type UIConfig as b, type RenderResult as c, type AdapterTier as d, type ComponentProps as e, type RenderTiming as f, type StreamingRenderResult as g, type IslandOptions as h, type Island as i, type UIAdapter as j, TIER_INFO as k, isV2Adapter as l, hasCapability as m, getCapabilities as n, wrapV1Adapter as w };

package/dist/adapters/tier-1/angular.d.ts

@@ -1,60 +0,0 @@
-import { B as BaseUIAdapter, A as AdapterCapabilities, C as Component, R as RenderContext, c as RenderResult } from '../../adapter-MMD-iHNx.js';
-
-/**
- * @flightdev/ui - Angular Adapter (Tier 1)
- *
- * Full-featured Angular 17+ SSR adapter with hydration and incremental hydration support.
- *
- * @module @flightdev/ui/angular
- * @version 2.0.0
- */
-
-/**
- * Angular bootstrap function type
- */
-type AngularBootstrapFn = (document: string, url: string) => Promise<unknown>;
-interface AngularAdapterOptions {
-    /** Enable incremental hydration (Angular 17+) */
-    incrementalHydration?: boolean;
-    /** Enable event replay during hydration */
-    eventReplay?: boolean;
-    /** Document template for SSR */
-    documentTemplate?: string;
-    /** Custom providers for SSR */
-    providers?: unknown[];
-}
-declare class AngularAdapter extends BaseUIAdapter {
-    private options;
-    readonly id = "angular";
-    readonly name = "Angular";
-    readonly framework = "angular";
-    readonly frameworkVersion = "17+";
-    readonly tier: "tier-1";
-    readonly capabilities: AdapterCapabilities;
-    private documentTemplate;
-    constructor(options?: AngularAdapterOptions);
-    renderToString(component: Component, context?: RenderContext): Promise<RenderResult>;
-    getHydrationScript(result: RenderResult): string;
-    getClientEntry(): string;
-    /**
-     * Get the default document template for SSR
-     */
-    private getDefaultDocumentTemplate;
-}
-/**
- * Create an Angular UI adapter.
- *
- * @example
- * ```typescript
- * import { angular } from '@flightdev/ui/angular';
- * import { defineUI } from '@flightdev/ui';
- *
- * export default defineUI(angular({
- *   incrementalHydration: true,
- *   eventReplay: true,
- * }));
- * ```
- */
-declare function angular(options?: AngularAdapterOptions): AngularAdapter;
-
-export { AngularAdapter, type AngularAdapterOptions, type AngularBootstrapFn, angular, angular as default };

package/dist/adapters/tier-1/angular.js

@@ -1,2 +0,0 @@
-export { AngularAdapter, angular, angular_default as default } from '../../chunk-3D4XMIZI.js';
-import '../../chunk-2SNQ6PTM.js';

package/dist/adapters/tier-1/index.d.ts

@@ -1,7 +0,0 @@
-export { ReactAdapter, ReactAdapterOptions, default as react } from './react.js';
-export { VueAdapter, VueAdapterOptions, default as vue } from './vue.js';
-export { AngularAdapter, AngularAdapterOptions, AngularBootstrapFn, default as angular } from './angular.js';
-export { SvelteAdapter, SvelteAdapterOptions, default as svelte } from './svelte.js';
-export { SolidAdapter, SolidAdapterOptions, default as solid } from './solid.js';
-export { QwikAdapter, QwikAdapterOptions, default as qwik } from './qwik.js';
-import '../../adapter-MMD-iHNx.js';

package/dist/adapters/tier-1/index.js

@@ -1,7 +0,0 @@
-export { VueAdapter, vue } from '../../chunk-QH3LOWXU.js';
-export { AngularAdapter, angular } from '../../chunk-3D4XMIZI.js';
-export { QwikAdapter, qwik } from '../../chunk-NTASPOHG.js';
-export { ReactAdapter, react } from '../../chunk-VK7ZPMO7.js';
-export { SolidAdapter, solid } from '../../chunk-64JZJ7OK.js';
-export { SvelteAdapter, svelte } from '../../chunk-X6CNUW6T.js';
-import '../../chunk-2SNQ6PTM.js';

package/dist/adapters/tier-1/qwik.d.ts

@@ -1,55 +0,0 @@
-import { B as BaseUIAdapter, A as AdapterCapabilities, C as Component, R as RenderContext, c as RenderResult } from '../../adapter-MMD-iHNx.js';
-
-/**
- * @flightdev/ui - Qwik Adapter (Tier 1)
- *
- * Qwik adapter with resumable hydration - zero JavaScript until interaction.
- *
- * @module @flightdev/ui/qwik
- * @version 2.0.0
- */
-
-interface QwikAdapterOptions {
-    /** Enable prefetching */
-    prefetch?: boolean;
-    /** Prefetch strategy */
-    prefetchStrategy?: 'hover' | 'viewport' | 'idle';
-    /** Container tag name */
-    containerTagName?: string;
-}
-declare class QwikAdapter extends BaseUIAdapter {
-    private options;
-    readonly id = "qwik";
-    readonly name = "Qwik";
-    readonly framework = "qwik";
-    readonly frameworkVersion = "1.0+";
-    readonly tier: "tier-1";
-    readonly capabilities: AdapterCapabilities;
-    constructor(options?: QwikAdapterOptions);
-    renderToString(component: Component, _context?: RenderContext): Promise<RenderResult>;
-    /**
-     * Serialize state for resumability (Qwik's specialty)
-     */
-    serializeState(state: unknown): string;
-    /**
-     * Resume from serialized state
-     */
-    resumeFromState(_serialized: string): unknown;
-    getHydrationScript(_result: RenderResult): string;
-    getClientEntry(): string;
-}
-/**
- * Create a Qwik UI adapter.
- *
- * @example
- * ```typescript
- * import { qwik } from '@flightdev/ui/qwik';
- * import { defineUI } from '@flightdev/ui';
- *
- * // Qwik's resumability means zero JS until interaction!
- * export default defineUI(qwik({ prefetchStrategy: 'idle' }));
- * ```
- */
-declare function qwik(options?: QwikAdapterOptions): QwikAdapter;
-
-export { QwikAdapter, type QwikAdapterOptions, qwik as default, qwik };

package/dist/adapters/tier-1/qwik.js

@@ -1,2 +0,0 @@
-export { QwikAdapter, qwik_default as default, qwik } from '../../chunk-NTASPOHG.js';
-import '../../chunk-2SNQ6PTM.js';

package/dist/adapters/tier-1/react.d.ts

@@ -1,67 +0,0 @@
-import { B as BaseUIAdapter, A as AdapterCapabilities, C as Component, R as RenderContext, c as RenderResult, S as StreamingOptions, g as StreamingRenderResult } from '../../adapter-MMD-iHNx.js';
-
-/**
- * @flightdev/ui - React Adapter (Tier 1)
- *
- * Full-featured React 18+ SSR adapter with streaming and hydration support.
- *
- * @module @flightdev/ui/react
- * @version 2.0.0
- */
-
-interface ReactAdapterOptions {
-    /** Enable streaming SSR with renderToPipeableStream */
-    streaming?: boolean;
-    /** Enable React Server Components support */
-    serverComponents?: boolean;
-    /** Custom error handler for streaming */
-    onError?: (error: Error) => void;
-    /** Custom shell ready handler */
-    onShellReady?: () => void;
-}
-declare class ReactAdapter extends BaseUIAdapter {
-    private options;
-    readonly id = "react";
-    readonly name = "React";
-    readonly framework = "react";
-    readonly frameworkVersion = "18+";
-    readonly tier: "tier-1";
-    readonly capabilities: AdapterCapabilities;
-    constructor(options?: ReactAdapterOptions);
-    renderToString(component: Component, _context?: RenderContext): Promise<RenderResult>;
-    /**
-     * Render to stream using React 18+ streaming SSR.
-     *
-     * Uses `renderToReadableStream` (Web Streams API) which works in:
-     * - Node.js 18+ (with Web Streams support)
-     * - Deno
-     * - Cloudflare Workers
-     * - Vercel Edge Runtime
-     * - Other edge runtimes
-     *
-     * Falls back to `renderToPipeableStream` for Node.js environments
-     * that require traditional streams.
-     */
-    renderToStream(component: Component, _context?: RenderContext, options?: StreamingOptions): StreamingRenderResult;
-    /**
-     * Fallback render for environments without Web Streams support.
-     * Uses renderToString and emits as a single chunk.
-     */
-    private fallbackStreamRender;
-    getHydrationScript(result: RenderResult): string;
-    getClientEntry(): string;
-}
-/**
- * Create a React UI adapter.
- *
- * @example
- * ```typescript
- * import { react } from '@flightdev/ui/react';
- * import { defineUI } from '@flightdev/ui';
- *
- * export default defineUI(react({ streaming: true }));
- * ```
- */
-declare function react(options?: ReactAdapterOptions): ReactAdapter;
-
-export { ReactAdapter, type ReactAdapterOptions, react as default, react };

package/dist/adapters/tier-1/react.js

@@ -1,2 +0,0 @@
-export { ReactAdapter, react_default as default, react } from '../../chunk-VK7ZPMO7.js';
-import '../../chunk-2SNQ6PTM.js';

package/dist/adapters/tier-1/solid.d.ts

@@ -1,45 +0,0 @@
-import { B as BaseUIAdapter, A as AdapterCapabilities, C as Component, R as RenderContext, c as RenderResult, S as StreamingOptions, g as StreamingRenderResult } from '../../adapter-MMD-iHNx.js';
-
-/**
- * @flightdev/ui - Solid Adapter (Tier 1)
- *
- * Full-featured SolidJS SSR adapter with streaming and hydration support.
- *
- * @module @flightdev/ui/solid
- * @version 2.0.0
- */
-
-interface SolidAdapterOptions {
-    /** Enable streaming SSR */
-    streaming?: boolean;
-    /** Render timeout in milliseconds */
-    timeout?: number;
-}
-declare class SolidAdapter extends BaseUIAdapter {
-    private options;
-    readonly id = "solid";
-    readonly name = "Solid";
-    readonly framework = "solid";
-    readonly frameworkVersion = "1.8+";
-    readonly tier: "tier-1";
-    readonly capabilities: AdapterCapabilities;
-    constructor(options?: SolidAdapterOptions);
-    renderToString(component: Component, _context?: RenderContext): Promise<RenderResult>;
-    renderToStream(component: Component, _context?: RenderContext, options?: StreamingOptions): StreamingRenderResult;
-    getHydrationScript(result: RenderResult): string;
-    getClientEntry(): string;
-}
-/**
- * Create a Solid UI adapter.
- *
- * @example
- * ```typescript
- * import { solid } from '@flightdev/ui/solid';
- * import { defineUI } from '@flightdev/ui';
- *
- * export default defineUI(solid({ streaming: true }));
- * ```
- */
-declare function solid(options?: SolidAdapterOptions): SolidAdapter;
-
-export { SolidAdapter, type SolidAdapterOptions, solid as default, solid };

package/dist/adapters/tier-1/solid.js

@@ -1,2 +0,0 @@
-export { SolidAdapter, solid_default as default, solid } from '../../chunk-64JZJ7OK.js';
-import '../../chunk-2SNQ6PTM.js';