@flight-framework/bundler-flightpack 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -3,11 +3,247 @@ import { CSSOptions, BundlerAdapter } from '@flight-framework/bundler';
 /**
  * @flight-framework/bundler-flightpack - Types
  *
- * Type definitions for the FlightPack bundler adapter.
+ * Comprehensive type definitions for the FlightPack bundler adapter.
+ * Exposes ALL native Rust capabilities via TypeScript interfaces.
+ *
+ * @packageDocumentation
  */
 
 /**
- * Options for the FlightPack bundler adapter
+ * Build platform target
+ * Determines externals handling and resolve conditions
+ */
+type Platform = 'browser' | 'node' | 'edge' | 'neutral';
+/**
+ * Environment-specific build configuration
+ * Follows Turbopack's unified graph approach
+ */
+interface EnvironmentConfig {
+    /** Target platform for this environment */
+    platform: Platform;
+    /** Entry points for this environment */
+    entry?: string[];
+    /** Output directory (relative to base outDir) */
+    outDir?: string;
+    /** External packages (not bundled) */
+    external?: string[];
+    /** Force bundle packages (override auto-external) */
+    noExternal?: string[];
+    /** Enable minification for this environment */
+    minify?: boolean;
+    /** Generate source maps */
+    sourcemap?: boolean;
+    /** Resolve conditions (e.g., ['import', 'module', 'browser']) */
+    conditions?: string[];
+    /** Node.js target version for node platform (e.g., 'node22') */
+    nodeTarget?: string;
+}
+/**
+ * Cache configuration for incremental builds
+ * Mirrors Turbopack's filesystem cache functionality
+ */
+interface CacheConfig {
+    /** Enable build caching */
+    enabled: boolean;
+    /** Cache directory path (default: .flightpack_cache) */
+    directory?: string;
+    /** Enable disk persistence for cache */
+    persistent?: boolean;
+    /** Maximum cache size in MB before pruning */
+    maxSize?: number;
+    /** Cache TTL in seconds */
+    ttl?: number;
+}
+/**
+ * Cache statistics for monitoring
+ */
+interface CacheStats {
+    /** Number of cache hits */
+    hits: number;
+    /** Number of cache misses */
+    misses: number;
+    /** Cache hit ratio (0-1) */
+    hitRatio: number;
+    /** Total cached entries */
+    entries: number;
+    /** Cache size in bytes */
+    size: number;
+}
+/**
+ * Tree shaking configuration
+ * Uses InnerGraph for statement-level dead code elimination
+ */
+interface TreeShakeConfig {
+    /** Enable tree shaking */
+    enabled: boolean;
+    /** Enable statement-level DCE via InnerGraph */
+    innerGraph?: boolean;
+    /** Modules to preserve (no tree shaking) */
+    preserve?: string[];
+    /** Side effects configuration by package */
+    sideEffects?: Record<string, boolean | string[]>;
+}
+/**
+ * Code splitting configuration
+ * Controls chunk generation via ChunkSplitter
+ */
+interface SplittingConfig {
+    /** Enable code splitting */
+    enabled: boolean;
+    /** Minimum shared chunk size in bytes */
+    minSize?: number;
+    /** Maximum chunk size in bytes before warning */
+    maxSize?: number;
+    /** Minimum references for vendor chunk extraction */
+    minChunks?: number;
+    /** Manual chunk configuration */
+    manualChunks?: Record<string, string[]>;
+    /** Enable vendor chunk extraction */
+    vendorChunk?: boolean;
+    /** Enable common chunk optimization */
+    commonChunk?: boolean;
+}
+/**
+ * Shared dependency configuration for Module Federation
+ */
+interface SharedConfig {
+    /** Singleton instance across all remotes */
+    singleton?: boolean;
+    /** Required version constraint */
+    requiredVersion?: string;
+    /** Eagerly load shared module */
+    eager?: boolean;
+    /** Strict version matching */
+    strictVersion?: boolean;
+}
+/**
+ * Exposed module configuration for Module Federation container
+ */
+interface ExposeConfig {
+    /** Module path to expose */
+    import: string;
+    /** Export name (optional, defaults to import) */
+    name?: string;
+}
+/**
+ * Remote container configuration for Module Federation
+ */
+interface RemoteConfig {
+    /** Remote entry URL or path */
+    entry: string;
+    /** Remote type (default: 'script') */
+    type?: 'script' | 'module';
+}
+/**
+ * Module Federation configuration
+ * Rspack-compatible federation setup
+ */
+interface FederationConfig {
+    /** Container name */
+    name: string;
+    /** Remote entry filename */
+    filename?: string;
+    /** Exposed modules */
+    exposes?: Record<string, string | ExposeConfig>;
+    /** Remote containers */
+    remotes?: Record<string, string | RemoteConfig>;
+    /** Shared dependencies */
+    shared?: Record<string, boolean | SharedConfig>;
+    /** Library configuration */
+    library?: {
+        type: 'var' | 'module' | 'system' | 'umd';
+        name?: string;
+    };
+}
+/**
+ * Static page configuration for SSG
+ */
+interface SSGPageConfig {
+    /** Route path pattern */
+    path: string;
+    /** Static params for dynamic routes */
+    params?: Record<string, string>[];
+    /** Fallback behavior */
+    fallback?: 'false' | 'true' | 'blocking';
+    /** Revalidation time in seconds (ISR) */
+    revalidate?: number;
+}
+/**
+ * SSG (Static Site Generation) configuration
+ */
+interface SSGConfig {
+    /** Enable SSG */
+    enabled: boolean;
+    /** Pages to pre-render */
+    pages?: SSGPageConfig[];
+    /** Default revalidation time for ISR */
+    defaultRevalidate?: number;
+    /** Maximum concurrent page generation */
+    concurrency?: number;
+    /** Generate trailing slashes in URLs */
+    trailingSlash?: boolean;
+}
+/**
+ * Browser targets for CSS autoprefixer
+ */
+interface CssBrowserTargets {
+    chrome?: number;
+    firefox?: number;
+    safari?: number;
+    edge?: number;
+}
+/**
+ * CSS transformation options
+ * Uses Lightning CSS for high-performance processing
+ */
+interface CssTransformConfig {
+    /** Enable CSS minification */
+    minify?: boolean;
+    /** Enable CSS modules */
+    modules?: boolean;
+    /** Custom pattern for CSS module class names ([name], [hash], [local]) */
+    modulesPattern?: string;
+    /** Enable dashed ident scoping (CSS variables) */
+    dashedIdents?: boolean;
+    /** Generate source maps */
+    sourcemap?: boolean;
+    /** Browser targets for autoprefixer */
+    targets?: CssBrowserTargets;
+}
+/**
+ * HMR (Hot Module Replacement) configuration
+ */
+interface HmrConfig {
+    /** Enable HMR */
+    enabled: boolean;
+    /** WebSocket port (default: same as dev server) */
+    port?: number;
+    /** WebSocket host */
+    host?: string;
+    /** Full page reload fallback */
+    fullReloadFallback?: boolean;
+    /** Overlay for errors */
+    overlay?: boolean | {
+        errors?: boolean;
+        warnings?: boolean;
+    };
+}
+/**
+ * File watcher configuration
+ */
+interface WatcherConfig {
+    /** Paths to watch */
+    paths?: string[];
+    /** File extensions to watch */
+    extensions?: string[];
+    /** Debounce delay in milliseconds */
+    debounceMs?: number;
+    /** Ignore patterns (glob) */
+    ignore?: string[];
+}
+/**
+ * Complete options for the FlightPack bundler adapter
+ * Exposes ALL native Rust capabilities
  */
 interface FlightPackAdapterOptions {
     /**
@@ -17,38 +253,97 @@ interface FlightPackAdapterOptions {
     minify?: boolean;
     /**
      * Generate source maps
+     * Uses native VLQ concatenation for multi-module maps
      * @default true
      */
     sourcemap?: boolean | 'inline' | 'hidden';
     /**
-     * Target environment
+     * Target environment for transpilation
      * @default 'es2022'
      */
-    target?: 'es2020' | 'es2021' | 'es2022' | 'es2023' | 'esnext';
+    target?: 'es2020' | 'es2021' | 'es2022' | 'es2023' | 'es2024' | 'esnext';
     /**
-     * Enable tree shaking
+     * Enable React Server Components support
+     * Generates client/server manifests for 'use client'/'use server' directives
      * @default true
      */
-    treeshake?: boolean;
+    rsc?: boolean;
+    /**
+     * Enable tree shaking with InnerGraph (statement-level DCE)
+     * More aggressive than module-level tree shaking
+     * @default true
+     */
+    treeshake?: boolean | TreeShakeConfig;
+    /**
+     * Enable code splitting
+     * Uses ChunkSplitter for optimal chunking
+     * @default true
+     */
+    splitting?: boolean | SplittingConfig;
     /**
      * Maximum chunk size in KB before warning
      * @default 500
      */
     chunkSizeLimit?: number;
     /**
-     * Enable React Server Components support
+     * Enable build caching for incremental builds
+     * Uses TurboCache (function-level memoization) + ArtifactStore
      * @default true
      */
-    rsc?: boolean;
+    cache?: boolean | CacheConfig;
+    /**
+     * Cache directory for persistent builds
+     * @default '.flightpack_cache'
+     */
+    cacheDir?: string;
+    /**
+     * Primary build platform
+     * @default 'browser' for client, 'node' for server
+     */
+    platform?: Platform;
+    /**
+     * Multi-environment build configuration
+     * Following Turbopack's unified graph approach
+     */
+    environments?: {
+        client?: EnvironmentConfig;
+        server?: EnvironmentConfig;
+        edge?: EnvironmentConfig;
+    };
+    /**
+     * External packages (not bundled)
+     * Automatically includes Node.js builtins for server builds
+     */
+    external?: string[];
+    /**
+     * Force bundle packages (override auto-external)
+     */
+    noExternal?: string[];
+    /**
+     * Module Federation configuration
+     * Rspack-compatible micro-frontend support
+     */
+    federation?: FederationConfig;
+    /**
+     * Static Site Generation configuration
+     * With ISR (Incremental Static Regeneration) support
+     */
+    ssg?: SSGConfig;
+    /**
+     * CSS processing configuration
+     * Uses Lightning CSS for high-performance transforms
+     */
+    css?: CSSOptions | CssTransformConfig;
     /**
      * Enable Hot Module Replacement in dev mode
+     * Uses native Axum WebSocket server
      * @default true
      */
-    hmr?: boolean;
+    hmr?: boolean | HmrConfig;
     /**
-     * CSS configuration
+     * File watcher configuration
      */
-    css?: CSSOptions;
+    watcher?: WatcherConfig;
     /**
      * Resolve aliases (similar to webpack resolve.alias)
      */
@@ -59,9 +354,9 @@ interface FlightPackAdapterOptions {
      */
     resolveExtensions?: string[];
     /**
-     * External packages (not bundled)
+     * Resolve conditions for package.json exports
      */
-    external?: string[];
+    conditions?: string[];
     /**
      * Define global constants (replaced at compile time)
      */
@@ -72,7 +367,7 @@ interface FlightPackAdapterOptions {
      */
     autoRegister?: boolean;
     /**
-     * Additional options passed directly to FlightPack
+     * Additional options passed directly to FlightPack native
      */
     [key: string]: unknown;
 }
@@ -111,6 +406,14 @@ interface FlightPackDevServerOptions {
         changeOrigin?: boolean;
         rewrite?: (path: string) => string;
     }>;
+    /**
+     * HMR configuration
+     */
+    hmr?: boolean | HmrConfig;
+    /**
+     * Cache configuration for dev builds
+     */
+    cache?: boolean | CacheConfig;
 }
 /**
  * Result from FlightPack native build
@@ -124,6 +427,27 @@ interface FlightPackBuildResult {
     totalSize: number;
     /** Information about each generated chunk */
     chunks: FlightPackChunkInfo[];
+    /** Cache statistics (if caching enabled) */
+    cacheStats?: CacheStats;
+    /** Tree shaking statistics */
+    treeShakeStats?: {
+        modulesAnalyzed: number;
+        deadModulesRemoved: number;
+        unusedExportsRemoved: number;
+    };
+}
+/**
+ * Multi-environment build result
+ */
+interface MultiEnvironmentBuildResult {
+    /** Client build result */
+    client: FlightPackBuildResult;
+    /** Server/SSR build result */
+    server?: FlightPackBuildResult;
+    /** Edge build result */
+    edge?: FlightPackBuildResult;
+    /** Total duration in milliseconds */
+    totalDurationMs: number;
 }
 /**
  * Information about a generated chunk
@@ -135,6 +459,10 @@ interface FlightPackChunkInfo {
     chunkType: 'entry' | 'chunk' | 'asset';
     /** Size in bytes */
     size: number;
+    /** Modules included in this chunk */
+    modules?: string[];
+    /** Whether this chunk was loaded from cache */
+    fromCache?: boolean;
 }
 /**
  * Result from single file transformation
@@ -146,6 +474,10 @@ interface FlightPackTransformResult {
     map: string | null;
     /** Whether transformation succeeded */
     success: boolean;
+    /** Dependencies detected */
+    dependencies?: string[];
+    /** Exports detected */
+    exports?: string[];
 }
 /**
  * Options for single file transformation
@@ -161,6 +493,79 @@ interface FlightPackTransformOptions {
     jsxFactory?: string;
     /** JSX fragment function */
     jsxFragment?: string;
+    /** Automatic JSX runtime */
+    jsxRuntime?: 'classic' | 'automatic';
+}
+/**
+ * Native options passed to FlightPack Rust core
+ * Maps to Rust FlightPackOptions struct
+ */
+interface FlightPackNativeOptions {
+    /** Entry points */
+    entry: string[];
+    /** Output directory */
+    outDir: string;
+    /** Root directory */
+    root?: string;
+    /** Enable minification */
+    minify?: boolean;
+    /** Generate source maps */
+    sourcemap?: boolean;
+    /** Enable RSC support */
+    rsc?: boolean;
+    /** Enable tree shaking */
+    treeshake?: boolean;
+    /** Enable code splitting */
+    splitting?: boolean;
+    /** Platform target */
+    platform?: Platform;
+    /** Enable caching */
+    cache?: boolean;
+    /** Cache directory */
+    cacheDir?: string;
+    /** External packages */
+    external?: string[];
+}
+/**
+ * Native CSS transform options
+ */
+interface NativeCssTransformOptions {
+    minify?: boolean;
+    cssModules?: boolean;
+    cssModulesPattern?: string;
+    dashedIdents?: boolean;
+    sourcemap?: boolean;
+    browserTargets?: CssBrowserTargets;
+}
+/**
+ * Native dev server options
+ */
+interface NativeDevServerOptions {
+    port?: number;
+    publicDir?: string;
+    outDir?: string;
+    hmr?: boolean;
+    root?: string;
+    cache?: boolean;
+    cacheDir?: string;
+}
+/**
+ * Native watcher options
+ */
+interface NativeWatcherOptions {
+    paths: string[];
+    extensions?: string[];
+    debounceMs?: number;
+}
+/**
+ * Native HMR update
+ */
+interface NativeHMRModuleUpdate {
+    id: string;
+    path: string;
+    code: string;
+    deps?: string[];
+    accept: boolean;
 }
 
 /**
@@ -212,6 +617,6 @@ declare function flightpack(options?: FlightPackAdapterOptions): BundlerAdapter;
 /**
  * Package version
  */
-declare const VERSION = "0.0.1";
+declare const VERSION = "0.1.4";
 
-export { type FlightPackAdapterOptions, type FlightPackBuildResult, type FlightPackChunkInfo, type FlightPackDevServerOptions, type FlightPackTransformOptions, type FlightPackTransformResult, VERSION, flightpack as createFlightPackAdapter, flightpack as default, flightpack };
+export { type CacheConfig, type CacheStats, type CssBrowserTargets, type CssTransformConfig, type EnvironmentConfig, type ExposeConfig, type FederationConfig, type FlightPackAdapterOptions, type FlightPackBuildResult, type FlightPackChunkInfo, type FlightPackDevServerOptions, type FlightPackNativeOptions, type FlightPackTransformOptions, type FlightPackTransformResult, type HmrConfig, type MultiEnvironmentBuildResult, type NativeCssTransformOptions, type NativeDevServerOptions, type NativeHMRModuleUpdate, type NativeWatcherOptions, type Platform, type RemoteConfig, type SSGConfig, type SSGPageConfig, type SharedConfig, type SplittingConfig, type TreeShakeConfig, VERSION, type WatcherConfig, flightpack as createFlightPackAdapter, flightpack as default, flightpack };