@flightdev/ui 2.0.0

package/dist/core/index.d.ts

@@ -0,0 +1,161 @@
+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 - Adapter Registry
+ *
+ * Global registry for dynamic adapter loading and discovery.
+ * Enables lazy loading of adapters to minimize bundle size.
+ *
+ * @module @flightdev/ui/core/registry
+ * @version 2.0.0
+ */
+
+/**
+ * Lazy loader function for an adapter
+ */
+type AdapterLoader = () => Promise<UIAdapterV2>;
+/**
+ * Adapter metadata for registry
+ */
+interface AdapterMetadata {
+    /** Unique adapter ID */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Framework name */
+    framework: string;
+    /** Tier classification */
+    tier: AdapterTier;
+    /** Capability hints (may be incomplete until loaded) */
+    capabilities?: Partial<AdapterCapabilities>;
+    /** Peer dependencies required */
+    peerDependencies?: string[];
+    /** Lazy loader function */
+    loader: AdapterLoader;
+}
+/**
+ * Registry query options
+ */
+interface RegistryQueryOptions {
+    /** Filter by tier */
+    tier?: AdapterTier;
+    /** Filter by capability */
+    capability?: keyof AdapterCapabilities;
+    /** Filter by framework name pattern */
+    framework?: string | RegExp;
+}
+/**
+ * Global adapter registry for dynamic loading and discovery.
+ *
+ * @example
+ * ```typescript
+ * import { adapterRegistry } from '@flightdev/ui';
+ *
+ * // Register an adapter
+ * adapterRegistry.register({
+ *   id: 'react',
+ *   name: 'React',
+ *   framework: 'react',
+ *   tier: 'tier-1',
+ *   loader: () => import('./adapters/tier-1/react.js').then(m => m.react()),
+ * });
+ *
+ * // Get an adapter
+ * const reactAdapter = await adapterRegistry.get('react');
+ *
+ * // List all adapters
+ * const allAdapters = adapterRegistry.list();
+ * ```
+ */
+declare class AdapterRegistry {
+    private metadata;
+    private instances;
+    private loading;
+    /**
+     * Register an adapter with the registry.
+     */
+    register(metadata: AdapterMetadata): void;
+    /**
+     * Register multiple adapters at once.
+     */
+    registerAll(adapters: AdapterMetadata[]): void;
+    /**
+     * Unregister an adapter.
+     */
+    unregister(id: string): boolean;
+    /**
+     * Check if an adapter is registered.
+     */
+    has(id: string): boolean;
+    /**
+     * Get an adapter by ID (lazy loads if not already loaded).
+     */
+    get(id: string): Promise<UIAdapterV2 | undefined>;
+    /**
+     * Get an adapter synchronously (only if already loaded).
+     */
+    getSync(id: string): UIAdapterV2 | undefined;
+    /**
+     * Get adapter metadata without loading.
+     */
+    getMetadata(id: string): AdapterMetadata | undefined;
+    /**
+     * List all registered adapter IDs.
+     */
+    list(): string[];
+    /**
+     * List adapters matching query options.
+     */
+    query(options: RegistryQueryOptions): AdapterMetadata[];
+    /**
+     * List adapters by tier.
+     */
+    listByTier(tier: AdapterTier): string[];
+    /**
+     * List adapters by capability.
+     */
+    listByCapability(capability: keyof AdapterCapabilities): string[];
+    /**
+     * Preload adapters for faster access later.
+     */
+    preload(ids: string[]): Promise<void>;
+    /**
+     * Get all loaded adapters.
+     */
+    getLoaded(): Map<string, UIAdapterV2>;
+    /**
+     * Clear all cached adapter instances (but keep registrations).
+     */
+    clearCache(): void;
+    /**
+     * Clear everything (registrations and cache).
+     */
+    clear(): void;
+    /**
+     * Get registry statistics.
+     */
+    stats(): {
+        registered: number;
+        loaded: number;
+        loading: number;
+        byTier: Record<AdapterTier, number>;
+    };
+    /**
+     * Load an adapter from metadata.
+     */
+    private loadAdapter;
+}
+/**
+ * Global adapter registry instance.
+ *
+ * Use this to register and retrieve UI adapters.
+ */
+declare const adapterRegistry: AdapterRegistry;
+/**
+ * Register all built-in adapters.
+ * Called automatically when the package is imported.
+ */
+declare function registerBuiltinAdapters(): void;
+
+export { AdapterCapabilities, type AdapterLoader, type AdapterMetadata, AdapterTier, type RegistryQueryOptions, UIAdapterV2, adapterRegistry, registerBuiltinAdapters };

package/dist/core/index.js

@@ -0,0 +1,2 @@
+export { DEFAULT_CAPABILITIES, TIER_INFO, adapterRegistry, registerBuiltinAdapters } from '../chunk-XTDK7ME5.js';
+export { BaseUIAdapter, getCapabilities, hasCapability, isV2Adapter, wrapV1Adapter } from '../chunk-2SNQ6PTM.js';

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+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';
+
+/**
+ * @flightdev/ui - Universal UI Framework Layer
+ *
+ * Universal SSR and hydration for 18+ UI frameworks.
+ * From React to Angular, Vue to HTMX, Svelte to Web Components.
+ *
+ * @module @flightdev/ui
+ * @version 2.0.0
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { defineUI } from '@flightdev/ui';
+ * import { react } from '@flightdev/ui/react';
+ *
+ * export default defineUI(react());
+ * ```
+ *
+ * @example With Streaming SSR
+ * ```typescript
+ * import { defineUI } from '@flightdev/ui';
+ * import { react } from '@flightdev/ui/react';
+ *
+ * export default defineUI(react(), {
+ *   streaming: true,
+ *   hydration: 'progressive',
+ * });
+ * ```
+ *
+ * @example Using Adapter Registry
+ * ```typescript
+ * import { adapterRegistry } from '@flightdev/ui';
+ *
+ * // Get adapter dynamically
+ * const adapter = await adapterRegistry.get('vue');
+ *
+ * // List all by tier
+ * const tier1 = adapterRegistry.listByTier('tier-1');
+ * ```
+ */
+
+/**
+ * Define UI configuration for Flight.
+ *
+ * @example
+ * ```typescript
+ * import { defineUI } from '@flightdev/ui';
+ * import { react } from '@flightdev/ui/react';
+ *
+ * export const ui = defineUI(react(), {
+ *   streaming: true,
+ *   hydration: 'progressive',
+ * });
+ * ```
+ */
+declare function defineUI(adapter: UIAdapterV2 | UIAdapterV1, options?: {
+    streaming?: boolean;
+    hydration?: 'full' | 'partial' | 'progressive' | 'none';
+    islands?: boolean;
+    defaultIslandStrategy?: IslandHydrationStrategy;
+}): UIConfig;
+
+/**
+ * Render a page with the configured UI adapter.
+ */
+declare function renderPage(config: UIConfig, component: Component, context?: RenderContext): Promise<RenderResult>;
+/**
+ * Render a page as a stream (if adapter supports streaming).
+ */
+declare function renderPageStream(config: UIConfig, component: Component, context?: RenderContext): ReadableStream<Uint8Array> | null;
+/**
+ * Generate full HTML document from render result.
+ */
+declare function toHTML(result: RenderResult, options?: {
+    lang?: string;
+    title?: string;
+    meta?: Record<string, string>;
+    charset?: string;
+    viewport?: string;
+}): string;
+/**
+ * Package version
+ */
+declare const VERSION = "2.0.0";
+/**
+ * Get information about the UI package
+ */
+declare function getPackageInfo(): {
+    name: string;
+    version: string;
+    description: string;
+    tiers: {
+        'tier-1': string[];
+        'tier-2': string[];
+        'tier-3': string[];
+    };
+    totalAdapters: number;
+};
+
+export { Component, IslandHydrationStrategy, RenderContext, RenderResult, UIAdapterV1, UIAdapterV2, UIConfig, VERSION, defineUI, getPackageInfo, renderPage, renderPageStream, toHTML };

package/dist/index.js

@@ -0,0 +1,71 @@
+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';
+
+// src/index.ts
+function defineUI(adapter, options = {}) {
+  return {
+    adapter,
+    streaming: options.streaming ?? false,
+    hydration: options.hydration ?? "full",
+    islands: options.islands ?? false,
+    defaultIslandStrategy: options.defaultIslandStrategy ?? "idle"
+  };
+}
+async function renderPage(config, component, context) {
+  const result = await config.adapter.renderToString(component, context);
+  if (config.hydration !== "none") {
+    const hydrationScript = config.adapter.getHydrationScript(result);
+    result.scripts = [...result.scripts ?? [], hydrationScript];
+  }
+  return result;
+}
+function renderPageStream(config, component, context) {
+  if (!isV2Adapter(config.adapter) || !config.adapter.capabilities.streaming) {
+    return null;
+  }
+  const streamResult = config.adapter.renderToStream?.(component, context);
+  return streamResult?.stream ?? null;
+}
+function toHTML(result, options = {}) {
+  const {
+    lang = "en",
+    title = "Flight App",
+    meta = {},
+    charset = "UTF-8",
+    viewport = "width=device-width, initial-scale=1.0"
+  } = options;
+  const metaTags = Object.entries(meta).map(([name, content]) => `<meta name="${name}" content="${content}">`).join("\n    ");
+  const scripts = result.scripts?.map((s) => s.startsWith("<script") ? s : `<script>${s}</script>`).join("\n    ") ?? "";
+  return `<!DOCTYPE html>
+<html lang="${lang}">
+  <head>
+    <meta charset="${charset}">
+    <meta name="viewport" content="${viewport}">
+    <title>${title}</title>
+    ${metaTags}
+    ${result.head ?? ""}
+    ${result.css ? `<style>${result.css}</style>` : ""}
+  </head>
+  <body>
+    <div id="app">${result.html}</div>
+    ${scripts}
+  </body>
+</html>`;
+}
+var VERSION = "2.0.0";
+function getPackageInfo() {
+  return {
+    name: "@flightdev/ui",
+    version: VERSION,
+    description: "Universal UI Framework Layer - SSR/hydration for 18+ frameworks",
+    tiers: {
+      "tier-1": ["react", "vue", "angular", "svelte", "solid", "qwik"],
+      "tier-2": ["preact", "lit", "marko", "stencil", "mithril", "inferno"],
+      "tier-3": ["htmx", "alpine", "hotwire", "stimulus", "petite-vue", "vanilla"]
+    },
+    totalAdapters: 18
+  };
+}
+
+export { VERSION, defineUI, getPackageInfo, renderPage, renderPageStream, toHTML };