@flight-framework/flightpack 0.1.1

package/index.d.ts

@@ -0,0 +1,368 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** FlightPack configuration options */
+export interface FlightPackOptions {
+  /** Entry points */
+  entry: Array<string>
+  /** Output directory */
+  outDir: string
+  /** Root directory */
+  root?: string
+  /** Enable minification */
+  minify?: boolean
+  /** Generate source maps */
+  sourcemap?: boolean
+  /** Enable RSC support */
+  rsc?: boolean
+}
+/** Build result */
+export interface BuildResult {
+  /** Output directory */
+  outputDir: string
+  /** Build duration in milliseconds */
+  durationMs: number
+  /** Total output size in bytes */
+  totalSize: number
+  /** Generated chunks */
+  chunks: Array<ChunkInfo>
+}
+/** Chunk information */
+export interface ChunkInfo {
+  /** File name */
+  fileName: string
+  /** Chunk type (entry, chunk, asset) */
+  chunkType: string
+  /** Size in bytes */
+  size: number
+}
+/** Transform result */
+export interface TransformResult {
+  /** Transformed code */
+  code: string
+  /** Source map (if generated) */
+  map?: string | null
+  /** Whether transformation succeeded */
+  success: boolean
+}
+/** Transform options */
+export interface TransformOptions {
+  /** Generate source maps */
+  sourcemap?: boolean
+  /** Enable minification */
+  minify?: boolean
+  /** Target environment */
+  target?: string
+  /** JSX pragma */
+  jsxFactory?: string
+  /** JSX fragment pragma */
+  jsxFragment?: string
+}
+/** Standalone build function */
+export declare function build(options: FlightPackOptions): Promise<BuildResult>
+/** Transform a single TypeScript/TSX file */
+export declare function transform(code: string, filename: string, options?: TransformOptions | undefined | null): Promise<TransformResult>
+/** FlightPack version */
+export declare function version(): string
+/** FlightPack bundler instance */
+export declare class FlightPack {
+  /** Create a new FlightPack instance */
+  constructor(options?: FlightPackOptions | undefined | null)
+  /** Run a production build */
+  build(): Promise<BuildResult>
+}
+
+// ============================================================================
+// Dev Server
+// ============================================================================
+
+/** Dev server options */
+export interface DevServerOptions {
+  /** Server port (default: 3000) */
+  port?: number
+  /** Public directory for static files */
+  publicDir?: string
+  /** Output directory (bundled files) */
+  outDir?: string
+  /** Enable HMR (default: true) */
+  hmr?: boolean
+  /** Root directory */
+  root?: string
+}
+
+/** Dev server result */
+export interface DevServerResult {
+  /** Server URL */
+  url: string
+  /** Port number */
+  port: number
+  /** Whether HMR is enabled */
+  hmr: boolean
+}
+
+/** Start the FlightPack development server */
+export declare function startDevServer(options?: DevServerOptions | undefined | null): Promise<DevServerResult>
+
+/** Stop the development server */
+export declare function stopDevServer(): Promise<boolean>
+
+/** Check if dev server is running */
+export declare function isDevServerRunning(): boolean
+
+// ============================================================================
+// HMR
+// ============================================================================
+
+/** HMR module update info */
+export interface HMRModuleUpdate {
+  /** Module ID */
+  id: string
+  /** Module path */
+  path: string
+  /** Updated code */
+  code: string
+  /** Dependencies */
+  deps?: Array<string> | null
+  /** Whether module accepts HMR */
+  accept: boolean
+}
+
+/** Send HMR update to connected clients */
+export declare function sendHmrUpdate(modules: Array<HMRModuleUpdate>): boolean
+
+/** Send HMR error to connected clients */
+export declare function sendHmrError(message: string): boolean
+
+// ============================================================================
+// File Watcher
+// ============================================================================
+
+/** File watcher options */
+export interface WatcherOptions {
+  /** Paths to watch */
+  paths: Array<string>
+  /** File extensions to include (e.g., ["ts", "tsx", "js"]) */
+  extensions?: Array<string> | null
+  /** Debounce delay in milliseconds */
+  debounceMs?: number | null
+}
+
+/** Watch event */
+export interface WatchEvent {
+  /** Changed file paths */
+  paths: Array<string>
+  /** Event type (change, add, remove) */
+  eventType: string
+}
+
+/** Watch handle for stopping file watching */
+export declare class WatchHandle {
+  /** Stop watching files */
+  stop(): boolean
+}
+
+/** Start watching files for changes */
+export declare function watchFiles(options: WatcherOptions, callback: (event: WatchEvent) => void): WatchHandle
+
+// ============================================================================
+// CSS Processing
+// ============================================================================
+
+/** CSS transformation options */
+export interface CssTransformOptions {
+  /** Enable minification */
+  minify?: boolean
+  /** Enable CSS modules (class name hashing) */
+  cssModules?: boolean
+  /** Custom pattern for CSS module class names */
+  cssModulesPattern?: string
+  /** Enable dashed ident scoping (CSS variables) */
+  dashedIdents?: boolean
+  /** Generate source maps */
+  sourcemap?: boolean
+  /** Target browser versions for autoprefixer */
+  browserTargets?: CssBrowserTargets
+}
+
+/** Browser targets for CSS autoprefixer */
+export interface CssBrowserTargets {
+  chrome?: number
+  firefox?: number
+  safari?: number
+  edge?: number
+}
+
+/** CSS module export information */
+export interface CssModuleExport {
+  /** Original class name */
+  original: string
+  /** Hashed class name */
+  hashed: string
+  /** Whether it's referenced by other modules */
+  isReferenced: boolean
+  /** Composed classes */
+  composes: Array<string>
+}
+
+/** CSS transformation result */
+export interface CssTransformResult {
+  /** Transformed CSS code */
+  code: string
+  /** Source map (if generated) */
+  map?: string | null
+  /** CSS module exports (class name mappings) */
+  exports: Array<CssModuleExport>
+  /** Whether transformation succeeded */
+  success: boolean
+}
+
+/** Transform CSS code */
+export declare function transformCss(code: string, filename: string, options?: CssTransformOptions | undefined | null): CssTransformResult
+
+/** Minify CSS quickly */
+export declare function minifyCss(code: string, filename: string): string
+
+/** CSS module result */
+export interface CssModuleResult {
+  /** Minified CSS code with hashed class names */
+  code: string
+  /** Mapping of original class names to hashed names */
+  classMap: Array<CssClassMapping>
+}
+
+/** CSS class name mapping */
+export interface CssClassMapping {
+  /** Original class name */
+  original: string
+  /** Hashed class name */
+  hashed: string
+}
+
+/** Transform CSS module file */
+export declare function transformCssModule(code: string, filename: string): CssModuleResult
+
+// ============================================================================
+// Universal / Multi-Environment Support
+// ============================================================================
+
+/** Platform target for builds */
+export type Platform = 'Browser' | 'Node' | 'Edge' | 'Neutral'
+
+/** Environment configuration options */
+export interface EnvironmentOptions {
+  /** Platform: "browser", "node", "edge", "neutral" */
+  platform?: string
+  /** Node.js target version (e.g., "node22") */
+  nodeTarget?: string
+  /** Resolve conditions */
+  conditions?: string[]
+  /** External packages (not bundled) */
+  external?: string[]
+  /** Force bundle packages (override auto-external) */
+  noExternal?: string[]
+  /** Output directory */
+  outDir?: string
+  /** Entry points for this environment */
+  entry?: string[]
+  /** Enable minification */
+  minify?: boolean
+  /** Generate source maps */
+  sourcemap?: boolean
+}
+
+/** Multi-environment build result */
+export interface MultiEnvironmentResult {
+  /** Client build result */
+  client: BuildResult
+  /** SSR build result (if configured) */
+  ssr?: BuildResult | null
+  /** Edge build result (if configured) */
+  edge?: BuildResult | null
+  /** Total duration in milliseconds */
+  totalDurationMs: number
+}
+
+// ============================================================================
+// Externals Detection
+// ============================================================================
+
+/** Check if a module is a Node.js builtin */
+export declare function isNodeBuiltin(moduleId: string): boolean
+
+/** Get list of all Node.js builtin modules */
+export declare function getNodeBuiltins(): string[]
+
+/** Get list of all Node.js builtins with node: prefix */
+export declare function getNodeBuiltinsPrefixed(): string[]
+
+/** Check if a module is a bare import (from node_modules) */
+export declare function isBareImport(moduleId: string): boolean
+
+/** Check if a module is compatible with Edge runtimes */
+export declare function isEdgeCompatible(moduleId: string): boolean
+
+/** Get list of Edge-incompatible modules */
+export declare function getEdgeIncompatibleModules(): string[]
+
+/** Get default resolve conditions for a platform */
+export declare function getPlatformConditions(platform: string): string[]
+
+// ============================================================================
+// SSG (Static Site Generation)
+// ============================================================================
+
+/** SSG page configuration */
+export interface SSGPageConfig {
+  /** Route path pattern */
+  path: string
+  /** Static params for dynamic routes */
+  params?: Array<Record<string, string>>
+  /** Fallback behavior: "false", "true", "blocking" */
+  fallback?: string
+  /** Revalidation time in seconds (ISR) */
+  revalidate?: number
+}
+
+/** SSG configuration */
+export interface SSGOptions {
+  /** Pages to pre-render */
+  pages: SSGPageConfig[]
+  /** Output directory */
+  outDir?: string
+  /** SSR bundle path */
+  ssrBundle?: string
+  /** Default revalidation time */
+  defaultRevalidate?: number
+  /** Maximum concurrency */
+  concurrency?: number
+  /** Generate trailing slashes */
+  trailingSlash?: boolean
+}
+
+/** SSG generated page result */
+export interface SSGGeneratedPage {
+  /** Route path */
+  path: string
+  /** Output file path */
+  filePath: string
+  /** Revalidation time (for ISR) */
+  revalidate?: number | null
+  /** Page size in bytes */
+  size: number
+}
+
+/** SSG generation result */
+export interface SSGResult {
+  /** All generated pages */
+  pages: SSGGeneratedPage[]
+  /** Total duration in milliseconds */
+  durationMs: number
+  /** Total size of all pages */
+  totalSize: number
+  /** Pages that require ISR */
+  isrPages: string[]
+  /** Errors encountered */
+  errors: string[]
+}

package/index.js

@@ -0,0 +1,367 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'flightpack.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./flightpack.android-arm64.node')
+          } else {
+            nativeBinding = require('@flight-framework/flightpack-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'flightpack.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./flightpack.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@flight-framework/flightpack-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'flightpack.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./flightpack.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@flight-framework/flightpack-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'flightpack.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./flightpack.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@flight-framework/flightpack-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'flightpack.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./flightpack.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@flight-framework/flightpack-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'flightpack.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./flightpack.darwin-universal.node')
+      } else {
+        nativeBinding = require('@flight-framework/flightpack-darwin-universal')
+      }
+      break
+    } catch { }
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'flightpack.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./flightpack.darwin-x64.node')
+          } else {
+            nativeBinding = require('@flight-framework/flightpack-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'flightpack.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./flightpack.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@flight-framework/flightpack-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'flightpack.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./flightpack.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@flight-framework/flightpack-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'flightpack.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./flightpack.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@flight-framework/flightpack-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'flightpack.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./flightpack.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@flight-framework/flightpack-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'flightpack.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./flightpack.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@flight-framework/flightpack-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'flightpack.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./flightpack.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@flight-framework/flightpack-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'flightpack.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./flightpack.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@flight-framework/flightpack-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'flightpack.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./flightpack.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@flight-framework/flightpack-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'flightpack.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./flightpack.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@flight-framework/flightpack-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'flightpack.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./flightpack.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@flight-framework/flightpack-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'flightpack.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./flightpack.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@flight-framework/flightpack-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const {
+  FlightPack,
+  build,
+  transform,
+  version,
+  // Dev Server
+  startDevServer,
+  stopDevServer,
+  isDevServerRunning,
+  // HMR
+  sendHmrUpdate,
+  sendHmrError,
+  // File Watcher
+  watchFiles,
+  WatchHandle,
+  // CSS Processing
+  transformCss,
+  minifyCss,
+  transformCssModule,
+  // Universal / Externals
+  isNodeBuiltin,
+  getNodeBuiltins,
+  getNodeBuiltinsPrefixed,
+  isBareImport,
+  isEdgeCompatible,
+  getEdgeIncompatibleModules,
+  getPlatformConditions
+} = nativeBinding
+
+module.exports.FlightPack = FlightPack
+module.exports.build = build
+module.exports.transform = transform
+module.exports.version = version
+// Dev Server
+module.exports.startDevServer = startDevServer
+module.exports.stopDevServer = stopDevServer
+module.exports.isDevServerRunning = isDevServerRunning
+// HMR
+module.exports.sendHmrUpdate = sendHmrUpdate
+module.exports.sendHmrError = sendHmrError
+// File Watcher
+module.exports.watchFiles = watchFiles
+module.exports.WatchHandle = WatchHandle
+// CSS Processing
+module.exports.transformCss = transformCss
+module.exports.minifyCss = minifyCss
+module.exports.transformCssModule = transformCssModule
+// Universal / Externals
+module.exports.isNodeBuiltin = isNodeBuiltin
+module.exports.getNodeBuiltins = getNodeBuiltins
+module.exports.getNodeBuiltinsPrefixed = getNodeBuiltinsPrefixed
+module.exports.isBareImport = isBareImport
+module.exports.isEdgeCompatible = isEdgeCompatible
+module.exports.getEdgeIncompatibleModules = getEdgeIncompatibleModules
+module.exports.getPlatformConditions = getPlatformConditions

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@flight-framework/flightpack",
+  "version": "0.1.1",
+  "description": "FlightPack - Native Rust bundler for Flight Framework",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "napi": {
+    "binaryName": "flightpack",
+    "targets": [
+      "x86_64-pc-windows-msvc"
+    ]
+  },
+  "scripts": {
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "prepublishOnly": "napi prepublish -t npm"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.5.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flight-framework/flight.git",
+    "directory": "packages/flightpack"
+  },
+  "keywords": [
+    "bundler",
+    "rust",
+    "flight",
+    "build",
+    "napi"
+  ],
+  "engines": {
+    "node": ">= 20"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/flight-framework/flight/tree/main/packages/flightpack",
+  "bugs": {
+    "url": "https://github.com/flight-framework/flight/issues"
+  },
+  "optionalDependencies": {
+    "@flight-framework/flightpack-win32-x64-msvc": "0.1.1"
+  }
+}