@flightdev/ui 2.0.0 → 4.0.0

package/src/adapters/tier-1/angular.ts

@@ -1,223 +0,0 @@
-/**
- * @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
- */
-
-import { BaseUIAdapter } from '../../core/adapter.js';
-import type {
-    AdapterCapabilities,
-    Component,
-    RenderContext,
-    RenderResult,
-} from '../../core/types.js';
-
-// ============================================================================
-// Types
-// ============================================================================
-
-/**
- * Angular bootstrap function type
- */
-export type AngularBootstrapFn = (document: string, url: string) => Promise<unknown>;
-
-export 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[];
-}
-
-// ============================================================================
-// Angular Adapter
-// ============================================================================
-
-export class AngularAdapter extends BaseUIAdapter {
-    readonly id = 'angular';
-    readonly name = 'Angular';
-    readonly framework = 'angular';
-    readonly frameworkVersion = '17+';
-    readonly tier = 'tier-1' as const;
-
-    override readonly capabilities: AdapterCapabilities = {
-        streaming: true,
-        partialHydration: true,
-        islands: false, // Angular doesn't have traditional islands
-        resumable: false,
-        ssg: true,
-        csr: true,
-        serverComponents: false,
-    };
-
-    private documentTemplate: string;
-
-    constructor(private options: AngularAdapterOptions = {}) {
-        super();
-        this.documentTemplate = options.documentTemplate ?? this.getDefaultDocumentTemplate();
-    }
-
-    async renderToString(
-        component: Component,
-        context?: RenderContext
-    ): Promise<RenderResult> {
-        const startTime = performance.now();
-
-        try {
-            // Dynamic import of Angular platform-server
-            const { renderApplication } = await import('@angular/platform-server');
-            const { provideClientHydration, withIncrementalHydration, withEventReplay } =
-                await import('@angular/platform-browser');
-
-            // Build hydration providers based on options
-            const hydrationFeatures: unknown[] = [];
-
-            if (this.options.incrementalHydration) {
-                hydrationFeatures.push(withIncrementalHydration());
-            }
-
-            if (this.options.eventReplay) {
-                hydrationFeatures.push(withEventReplay());
-            }
-
-            // The component should be an Angular bootstrap function
-            const bootstrap = component.component as AngularBootstrapFn;
-            const url = context?.url ?? '/';
-
-            // Render the application
-            const html = await renderApplication(bootstrap, {
-                document: this.documentTemplate,
-                url,
-            });
-
-            return {
-                html,
-                hydrationData: {
-                    props: component.props,
-                    url,
-                    componentId: component.id ?? this.generateId(),
-                },
-                timing: this.createTiming(startTime),
-            };
-        } catch (error) {
-            // Handle missing Angular dependencies gracefully
-            const message = error instanceof Error ? error.message : String(error);
-
-            if (message.includes("Cannot find module '@angular/platform-server'")) {
-                throw new Error(
-                    '[Flight/Angular] Angular SSR dependencies not found.\n' +
-                    'Install required packages:\n' +
-                    '  npm install @angular/core @angular/platform-server @angular/platform-browser'
-                );
-            }
-
-            throw error;
-        }
-    }
-
-    override getHydrationScript(result: RenderResult): string {
-        const data = this.serializeProps(result.hydrationData);
-
-        // Angular handles hydration differently - it's built into the render output
-        // This script is for passing additional Flight-specific data
-        return `
-<script type="module">
-window.__FLIGHT_DATA__ = ${data};
-window.__FLIGHT_ADAPTER__ = 'angular';
-// Angular hydration is automatic when provideClientHydration is configured
-</script>
-        `.trim();
-    }
-
-    override getClientEntry(): string {
-        return `
-import { bootstrapApplication } from '@angular/platform-browser';
-import { provideClientHydration } from '@angular/platform-browser';
-
-export async function hydrate() {
-    const App = window.__FLIGHT_APP__;
-    const data = window.__FLIGHT_DATA__ ?? {};
-
-    if (!App) {
-        console.warn('[Flight/Angular] No App component found');
-        return;
-    }
-
-    try {
-        const appRef = await bootstrapApplication(App, {
-            providers: [
-                provideClientHydration(),
-                // Additional providers can be added here
-            ],
-        });
-        
-        console.log('[Flight/Angular] Application bootstrapped');
-        return appRef;
-    } catch (error) {
-        console.error('[Flight/Angular] Bootstrap failed:', error);
-        throw error;
-    }
-}
-
-export async function render(AppComponent, providers = []) {
-    return bootstrapApplication(AppComponent, {
-        providers: [
-            ...providers,
-        ],
-    });
-}
-        `.trim();
-    }
-
-    /**
-     * Get the default document template for SSR
-     */
-    private getDefaultDocumentTemplate(): string {
-        return `
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Flight App</title>
-</head>
-<body>
-    <app-root></app-root>
-</body>
-</html>
-        `.trim();
-    }
-}
-
-// ============================================================================
-// Factory Function
-// ============================================================================
-
-/**
- * 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,
- * }));
- * ```
- */
-export function angular(options?: AngularAdapterOptions): AngularAdapter {
-    return new AngularAdapter(options);
-}
-
-export default angular;

package/src/adapters/tier-1/index.ts

@@ -1,12 +0,0 @@
-/**
- * @flightdev/ui - Tier 1 Adapters Index
- *
- * Re-exports all Tier 1 (Full Support) adapters.
- */
-
-export { react, ReactAdapter, type ReactAdapterOptions } from './react.js';
-export { vue, VueAdapter, type VueAdapterOptions } from './vue.js';
-export { angular, AngularAdapter, type AngularAdapterOptions, type AngularBootstrapFn } from './angular.js';
-export { svelte, SvelteAdapter, type SvelteAdapterOptions } from './svelte.js';
-export { solid, SolidAdapter, type SolidAdapterOptions } from './solid.js';
-export { qwik, QwikAdapter, type QwikAdapterOptions } from './qwik.js';

package/src/adapters/tier-1/qwik.ts

@@ -1,177 +0,0 @@
-/**
- * @flightdev/ui - Qwik Adapter (Tier 1)
- *
- * Qwik adapter with resumable hydration - zero JavaScript until interaction.
- *
- * @module @flightdev/ui/qwik
- * @version 2.0.0
- */
-
-import { BaseUIAdapter } from '../../core/adapter.js';
-import type {
-    AdapterCapabilities,
-    Component,
-    RenderContext,
-    RenderResult,
-} from '../../core/types.js';
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export interface QwikAdapterOptions {
-    /** Enable prefetching */
-    prefetch?: boolean;
-
-    /** Prefetch strategy */
-    prefetchStrategy?: 'hover' | 'viewport' | 'idle';
-
-    /** Container tag name */
-    containerTagName?: string;
-}
-
-// ============================================================================
-// Qwik Adapter
-// ============================================================================
-
-export class QwikAdapter extends BaseUIAdapter {
-    readonly id = 'qwik';
-    readonly name = 'Qwik';
-    readonly framework = 'qwik';
-    readonly frameworkVersion = '1.0+';
-    readonly tier = 'tier-1' as const;
-
-    override readonly capabilities: AdapterCapabilities = {
-        streaming: true,
-        partialHydration: true,
-        islands: true,
-        resumable: true, // Qwik's killer feature!
-        ssg: true,
-        csr: true,
-        serverComponents: false,
-    };
-
-    constructor(private options: QwikAdapterOptions = {}) {
-        super();
-    }
-
-    async renderToString(
-        component: Component,
-        _context?: RenderContext
-    ): Promise<RenderResult> {
-        const startTime = performance.now();
-
-        try {
-            const { renderToString } = await import('@builder.io/qwik/server');
-
-            const QwikComponent = component.component as () => unknown;
-            const containerTagName = this.options.containerTagName ?? 'div';
-
-            const result = await renderToString(QwikComponent, {
-                containerTagName,
-                // Qwik serializes state automatically
-            });
-
-            return {
-                html: result.html,
-                hydrationData: {
-                    // Qwik doesn't need explicit hydration data
-                    // State is serialized in the HTML
-                    componentId: component.id ?? this.generateId(),
-                },
-                timing: this.createTiming(startTime),
-            };
-        } catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-
-            if (message.includes("Cannot find module '@builder.io/qwik/server'")) {
-                throw new Error(
-                    '[Flight/Qwik] Qwik dependencies not found.\n' +
-                    'Install required packages:\n' +
-                    '  npm install @builder.io/qwik'
-                );
-            }
-
-            throw error;
-        }
-    }
-
-    /**
-     * Serialize state for resumability (Qwik's specialty)
-     */
-    override serializeState(state: unknown): string {
-        // Qwik handles serialization internally via qwik/serialization
-        return JSON.stringify(state);
-    }
-
-    /**
-     * Resume from serialized state
-     */
-    override resumeFromState(_serialized: string): unknown {
-        // Qwik automatically resumes from HTML-embedded state
-        // This is called by the client-side Qwik runtime
-        return null;
-    }
-
-    override getHydrationScript(_result: RenderResult): string {
-        // Qwik doesn't need traditional hydration scripts
-        // It uses resumability - the state is in the HTML
-        const prefetchStrategy = this.options.prefetchStrategy ?? 'idle';
-
-        return `
-<script type="module">
-window.__FLIGHT_ADAPTER__ = 'qwik';
-// Qwik handles resumability automatically
-// No hydration script needed - Qwik resumes from HTML state
-// Prefetch strategy: ${prefetchStrategy}
-</script>
-        `.trim();
-    }
-
-    override getClientEntry(): string {
-        return `
-// Qwik Client Entry
-// Qwik uses resumability - no traditional hydration needed
-
-export function hydrate() {
-    // Qwik automatically resumes from HTML-serialized state
-    // This function is a no-op for Qwik
-    console.log('[Flight/Qwik] Resumability enabled - no hydration needed');
-}
-
-export function prefetch() {
-    // Trigger Qwik prefetching
-    if ('requestIdleCallback' in window) {
-        requestIdleCallback(() => {
-            const qwikLoader = document.querySelector('[q\\\\:container]');
-            if (qwikLoader) {
-                // Qwik prefetches automatically based on container attributes
-            }
-        });
-    }
-}
-        `.trim();
-    }
-}
-
-// ============================================================================
-// Factory Function
-// ============================================================================
-
-/**
- * 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' }));
- * ```
- */
-export function qwik(options?: QwikAdapterOptions): QwikAdapter {
-    return new QwikAdapter(options);
-}
-
-export default qwik;