@flight-framework/bundler-flightpack 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -3,247 +3,23 @@ import { CSSOptions, BundlerAdapter } from '@flight-framework/bundler';
 /**
  * @flight-framework/bundler-flightpack - Types
  *
- * Comprehensive type definitions for the FlightPack bundler adapter.
- * Exposes ALL native Rust capabilities via TypeScript interfaces.
- *
- * @packageDocumentation
+ * Type definitions for the FlightPack bundler adapter.
  */
 
 /**
- * Build platform target
- * Determines externals handling and resolve conditions
+ * Platform target for builds
  */
 type Platform = 'browser' | 'node' | 'edge' | 'neutral';
 /**
- * Environment-specific build configuration
- * Follows Turbopack's unified graph approach
+ * Output format for bundles
  */
-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;
-}
+type OutputFormat = 'esm' | 'cjs' | 'iife';
 /**
- * Cache configuration for incremental builds
- * Mirrors Turbopack's filesystem cache functionality
+ * Target environment for transpilation
  */
-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;
-    };
-}
+type TargetEnvironment = 'es2020' | 'es2021' | 'es2022' | 'es2023' | 'es2024' | 'esnext';
 /**
- * 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
+ * Options for the FlightPack bundler adapter
  */
 interface FlightPackAdapterOptions {
     /**
@@ -253,124 +29,216 @@ interface FlightPackAdapterOptions {
     minify?: boolean;
     /**
      * Generate source maps
-     * Uses native VLQ concatenation for multi-module maps
      * @default true
      */
     sourcemap?: boolean | 'inline' | 'hidden';
     /**
-     * Target environment for transpilation
-     * @default 'es2022'
+     * Target environment
+     * @default 'es2024'
      */
-    target?: 'es2020' | 'es2021' | 'es2022' | 'es2023' | 'es2024' | 'esnext';
+    target?: TargetEnvironment;
     /**
-     * Enable React Server Components support
-     * Generates client/server manifests for 'use client'/'use server' directives
+     * Enable tree shaking
      * @default true
      */
-    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;
+    treeshake?: boolean;
     /**
      * Maximum chunk size in KB before warning
      * @default 500
      */
     chunkSizeLimit?: number;
     /**
-     * Enable build caching for incremental builds
-     * Uses TurboCache (function-level memoization) + ArtifactStore
+     * Enable React Server Components support
      * @default true
      */
-    cache?: boolean | CacheConfig;
+    rsc?: boolean;
     /**
-     * Cache directory for persistent builds
-     * @default '.flightpack_cache'
+     * Enable Hot Module Replacement in dev mode
+     * @default true
      */
-    cacheDir?: string;
+    hmr?: boolean;
     /**
-     * Primary build platform
-     * @default 'browser' for client, 'node' for server
+     * CSS configuration
      */
-    platform?: Platform;
+    css?: CSSOptions;
     /**
-     * Multi-environment build configuration
-     * Following Turbopack's unified graph approach
+     * Resolve aliases (similar to webpack resolve.alias)
      */
-    environments?: {
-        client?: EnvironmentConfig;
-        server?: EnvironmentConfig;
-        edge?: EnvironmentConfig;
-    };
+    resolveAlias?: Record<string, string>;
     /**
-     * External packages (not bundled)
-     * Automatically includes Node.js builtins for server builds
+     * File extensions to resolve
+     * @default ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']
      */
-    external?: string[];
+    resolveExtensions?: string[];
     /**
-     * Force bundle packages (override auto-external)
+     * External packages (not bundled)
      */
-    noExternal?: string[];
+    external?: string[];
     /**
-     * Module Federation configuration
-     * Rspack-compatible micro-frontend support
+     * Define global constants (replaced at compile time)
      */
-    federation?: FederationConfig;
+    define?: Record<string, string>;
     /**
-     * Static Site Generation configuration
-     * With ISR (Incremental Static Regeneration) support
+     * Auto-register adapter on import
+     * @default true
      */
-    ssg?: SSGConfig;
+    autoRegister?: boolean;
     /**
-     * CSS processing configuration
-     * Uses Lightning CSS for high-performance transforms
+     * Enable code splitting for dynamic imports
+     * @default true
      */
-    css?: CSSOptions | CssTransformConfig;
+    splitting?: boolean;
     /**
-     * Enable Hot Module Replacement in dev mode
-     * Uses native Axum WebSocket server
-     * @default true
+     * Platform target for the build
+     * Determines module resolution, externals behavior, and runtime features
+     * @default 'browser'
      */
-    hmr?: boolean | HmrConfig;
+    platform?: Platform;
     /**
-     * File watcher configuration
+     * Output format
+     * @default 'esm'
      */
-    watcher?: WatcherConfig;
+    format?: OutputFormat;
     /**
-     * Resolve aliases (similar to webpack resolve.alias)
+     * Force bundle packages (override external/auto-external)
+     * Takes precedence over external
      */
-    resolveAlias?: Record<string, string>;
+    noExternal?: string[];
     /**
-     * File extensions to resolve
-     * @default ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']
+     * Enable Server Actions support
+     * @default true
      */
-    resolveExtensions?: string[];
+    serverActions?: boolean;
     /**
      * Resolve conditions for package.json exports
+     * Auto-set based on platform if not specified
      */
     conditions?: string[];
     /**
-     * Define global constants (replaced at compile time)
+     * Node.js target version (for Node platform)
+     * e.g., "node20", "node22"
      */
-    define?: Record<string, string>;
+    nodeTarget?: string;
     /**
-     * Auto-register adapter on import
-     * @default true
+     * Multi-environment build configuration
+     * When set, builds for multiple platforms simultaneously
      */
-    autoRegister?: boolean;
+    environments?: EnvironmentsConfig;
     /**
-     * Additional options passed directly to FlightPack native
+     * Additional options passed directly to FlightPack
      */
     [key: string]: unknown;
 }
+/**
+ * Environment-specific build options
+ */
+interface EnvironmentOptions {
+    /** Platform target */
+    platform?: Platform;
+    /** Node.js target version (e.g., "node22") */
+    nodeTarget?: string;
+    /** Resolve conditions */
+    conditions?: string[];
+    /** External packages */
+    external?: string[];
+    /** Force bundle packages */
+    noExternal?: string[];
+    /** Output directory for this environment */
+    outDir?: string;
+    /** Entry points for this environment */
+    entry?: string[];
+    /** Enable minification */
+    minify?: boolean;
+    /** Generate source maps */
+    sourcemap?: boolean;
+}
+/**
+ * Multi-environment configuration
+ * Based on Vite 7+ Environment API
+ */
+interface EnvironmentsConfig {
+    /** Client (browser) environment - always present */
+    client: EnvironmentOptions;
+    /** SSR (Node.js server) environment - optional */
+    ssr?: EnvironmentOptions;
+    /** Edge environment (Cloudflare Workers, etc.) - optional */
+    edge?: EnvironmentOptions;
+}
+/**
+ * Multi-environment build result
+ */
+interface MultiEnvironmentBuildResult {
+    /** Client build result */
+    client: FlightPackBuildResult;
+    /** SSR build result (if configured) */
+    ssr?: FlightPackBuildResult;
+    /** Edge build result (if configured) */
+    edge?: FlightPackBuildResult;
+    /** Total duration in milliseconds */
+    totalDurationMs: number;
+}
+/**
+ * Fallback behavior for dynamic routes
+ */
+type SSGFallback = 'false' | 'true' | 'blocking';
+/**
+ * SSG page configuration
+ */
+interface SSGPageConfig {
+    /** Route path pattern (e.g., "/blog/[slug]") */
+    path: string;
+    /** Static params for dynamic routes */
+    params?: Record<string, string>[];
+    /** Fallback behavior for paths not generated at build time */
+    fallback?: SSGFallback;
+    /** Revalidation time in seconds (ISR) */
+    revalidate?: number;
+}
+/**
+ * SSG generation options
+ */
+interface SSGOptions {
+    /** Pages to pre-render */
+    pages: SSGPageConfig[];
+    /** Output directory */
+    outDir?: string;
+    /** SSR bundle path (for rendering) */
+    ssrBundle?: string;
+    /** Default revalidation time in seconds */
+    defaultRevalidate?: number;
+    /** Maximum concurrent page generations */
+    concurrency?: number;
+    /** Generate trailing slashes in URLs */
+    trailingSlash?: boolean;
+}
+/**
+ * Generated page information
+ */
+interface SSGGeneratedPage {
+    /** Route path */
+    path: string;
+    /** Output file path */
+    filePath: string;
+    /** Revalidation time (for ISR) */
+    revalidate?: number;
+    /** Page size in bytes */
+    size: number;
+}
+/**
+ * SSG generation result
+ */
+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[];
+}
 /**
  * Options for the FlightPack dev server
  */
@@ -406,14 +274,6 @@ 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
@@ -427,27 +287,6 @@ 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
@@ -459,10 +298,6 @@ 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
@@ -474,10 +309,6 @@ interface FlightPackTransformResult {
     map: string | null;
     /** Whether transformation succeeded */
     success: boolean;
-    /** Dependencies detected */
-    dependencies?: string[];
-    /** Exports detected */
-    exports?: string[];
 }
 /**
  * Options for single file transformation
@@ -493,79 +324,6 @@ 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;
 }
 
 /**
@@ -617,6 +375,105 @@ declare function flightpack(options?: FlightPackAdapterOptions): BundlerAdapter;
 /**
  * Package version
  */
-declare const VERSION = "0.1.4";
+declare const VERSION = "0.0.1";
+/**
+ * FlightPack utility functions for advanced usage
+ *
+ * @example
+ * ```typescript
+ * import { utils } from '@flight-framework/bundler-flightpack';
+ *
+ * utils.isNodeBuiltin('fs');      // true
+ * utils.isEdgeCompatible('fs');   // false
+ * utils.isBareImport('react');    // true
+ * ```
+ */
+declare const utils: {
+    /**
+     * Check if a module is a Node.js builtin
+     * Handles both 'fs' and 'node:fs' formats
+     */
+    isNodeBuiltin(moduleId: string): Promise<boolean>;
+    /**
+     * Get list of all Node.js builtin modules
+     */
+    getNodeBuiltins(): Promise<string[]>;
+    /**
+     * Get list of all Node.js builtins with node: prefix
+     */
+    getNodeBuiltinsPrefixed(): Promise<string[]>;
+    /**
+     * Check if a module is a bare import (from node_modules)
+     * Returns false for relative/absolute paths
+     */
+    isBareImport(moduleId: string): Promise<boolean>;
+    /**
+     * Check if a module is compatible with Edge runtimes
+     * Returns false for modules like 'fs', 'child_process', etc.
+     */
+    isEdgeCompatible(moduleId: string): Promise<boolean>;
+    /**
+     * Get list of Edge-incompatible modules
+     */
+    getEdgeIncompatibleModules(): Promise<string[]>;
+    /**
+     * Get default resolve conditions for a platform
+     */
+    getPlatformConditions(platform: "browser" | "node" | "edge" | "neutral"): Promise<string[]>;
+};
+
+/**
+ * Generate static pages (SSG/ISR)
+ *
+ * Pre-renders pages at build time with optional Incremental Static Regeneration.
+ *
+ * @example
+ * ```typescript
+ * import { generateSSG } from '@flight-framework/bundler-flightpack';
+ *
+ * const result = await generateSSG({
+ *     pages: [
+ *         { path: '/' },
+ *         { path: '/about' },
+ *         { path: '/blog/[slug]', params: [{ slug: 'hello' }, { slug: 'world' }] },
+ *     ],
+ *     outDir: './dist',
+ *     ssrBundle: './dist/server/entry-server.js',
+ * });
+ * ```
+ */
+declare function generateSSG(options: SSGOptions): Promise<SSGResult>;
+
+/**
+ * Build for multiple environments simultaneously
+ *
+ * Builds client, SSR, and edge bundles in parallel for maximum performance.
+ * Follows Vite 7+ Environment API patterns.
+ *
+ * @example
+ * ```typescript
+ * import { buildMultiEnvironment } from '@flight-framework/bundler-flightpack';
+ *
+ * const result = await buildMultiEnvironment({
+ *     entry: ['src/index.tsx'],
+ *     outDir: './dist',
+ * }, {
+ *     client: { platform: 'browser', outDir: './dist/client' },
+ *     ssr: { platform: 'node', outDir: './dist/server', external: ['express'] },
+ *     edge: { platform: 'edge', outDir: './dist/edge' },
+ * });
+ * ```
+ */
+declare function buildMultiEnvironment(baseOptions: {
+    entry: string[];
+    outDir: string;
+    root?: string;
+    minify?: boolean;
+    sourcemap?: boolean;
+    rsc?: boolean;
+    treeshake?: boolean;
+    target?: string;
+    define?: Record<string, string>;
+}, environments: EnvironmentsConfig): Promise<MultiEnvironmentBuildResult>;
 
-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 };
+export { type EnvironmentOptions, type EnvironmentsConfig, type FlightPackAdapterOptions, type FlightPackBuildResult, type FlightPackChunkInfo, type FlightPackDevServerOptions, type FlightPackTransformOptions, type FlightPackTransformResult, type MultiEnvironmentBuildResult, type OutputFormat, type Platform, type SSGFallback, type SSGGeneratedPage, type SSGOptions, type SSGPageConfig, type SSGResult, type TargetEnvironment, VERSION, buildMultiEnvironment, flightpack as createFlightPackAdapter, flightpack as default, flightpack, generateSSG, utils };