@flightdev/helpers 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Flight Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# @flight-framework/helpers
+
+Optional helper utilities for Flight Framework. **Suggestions, not impositions.**
+
+## Philosophy
+
+This package provides utilities that **suggest** configurations based on your project. It never applies anything automatically. You decide whether to use the suggestions or not.
+
+## Installation
+
+```bash
+npm install @flight-framework/helpers
+```
+
+## Usage
+
+### Detect UI Framework
+
+```typescript
+import { detectFramework } from '@flight-framework/helpers/detect';
+
+const result = await detectFramework();
+
+console.log(result);
+// {
+//   framework: 'react',
+//   confidence: 'high',
+//   source: 'package.json',
+//   reasoning: 'Found react and react-dom in dependencies'
+// }
+
+// You decide what to do with this information
+if (result.framework) {
+  console.log(`Detected: ${result.framework}`);
+} else {
+  console.log('No framework detected, using vanilla');
+}
+```
+
+### Detect Deployment Target
+
+```typescript
+import { detectDeploymentTarget } from '@flight-framework/helpers/detect';
+
+const result = await detectDeploymentTarget();
+
+console.log(result);
+// {
+//   adapter: 'vercel',
+//   confidence: 'high',
+//   source: 'environment',
+//   reasoning: 'VERCEL environment variable detected'
+// }
+
+// You decide whether to use this
+console.log(`Suggested adapter: ${result.adapter}`);
+console.log(`To install: npm install @flight-framework/adapter-${result.adapter}`);
+```
+
+### Suggest Defaults
+
+```typescript
+import { suggestDefaults } from '@flight-framework/helpers/suggest';
+
+const suggestions = await suggestDefaults();
+
+console.log(suggestions);
+// {
+//   framework: 'react',
+//   adapter: 'vercel',
+//   rendering: 'ssr',
+//   bundler: 'vite',
+//   confidence: {
+//     framework: 'high',
+//     adapter: 'high'
+//   }
+// }
+
+// Use in your config if you want
+// flight.config.ts
+import { defineConfig } from '@flight-framework/core';
+
+export default defineConfig({
+  ui: {
+    // Use suggestion or override
+    framework: suggestions.framework ?? 'react',
+  },
+});
+```
+
+## API Reference
+
+### detectFramework(root?: string)
+
+Detects the UI framework used in the project.
+
+**Returns:**
+```typescript
+interface FrameworkDetection {
+  framework: 'react' | 'vue' | 'svelte' | 'solid' | 'preact' | 'qwik' | 'lit' | 'htmx' | 'angular' | null;
+  confidence: 'high' | 'medium' | 'low';
+  source: string;
+  reasoning: string;
+}
+```
+
+### detectDeploymentTarget(root?: string)
+
+Detects the deployment environment.
+
+**Returns:**
+```typescript
+interface DeploymentDetection {
+  adapter: 'node' | 'vercel' | 'netlify' | 'cloudflare' | 'aws' | 'docker' | 'fly' | 'deno' | 'bun' | null;
+  confidence: 'high' | 'medium' | 'low';
+  source: string;
+  reasoning: string;
+}
+```
+
+### suggestDefaults(root?: string)
+
+Returns suggested configuration based on detected context.
+
+**Returns:**
+```typescript
+interface SuggestedDefaults {
+  framework: string | null;
+  adapter: string | null;
+  rendering: 'ssr' | 'csr' | 'ssg';
+  bundler: 'vite' | 'esbuild' | 'rolldown';
+  confidence: {
+    framework: 'high' | 'medium' | 'low';
+    adapter: 'high' | 'medium' | 'low';
+  };
+}
+```
+
+## Important
+
+This package:
+- **Never** applies configuration automatically
+- **Never** installs packages
+- **Never** modifies files
+- Only **returns information** for you to use
+
+You are always in control.
+
+## License
+
+MIT

package/dist/detect/index.d.ts

@@ -0,0 +1,42 @@
+import { F as FrameworkDetection, D as DeploymentDetection } from '../types-0ONEhDBI.js';
+
+/**
+ * Detection utilities for Flight Framework
+ *
+ * These functions DETECT and REPORT. They never apply or install anything.
+ */
+
+/**
+ * Detect the UI framework used in the project.
+ *
+ * This function ONLY detects and reports. It never installs or configures anything.
+ *
+ * @param root - Project root directory (defaults to current working directory)
+ * @returns Detection result with framework, confidence, and reasoning
+ *
+ * @example
+ * ```typescript
+ * const result = await detectFramework();
+ * console.log(result.framework); // 'react' | 'vue' | null | ...
+ * console.log(result.reasoning); // 'Found react in package.json dependencies'
+ * ```
+ */
+declare function detectFramework(root?: string): Promise<FrameworkDetection>;
+/**
+ * Detect the deployment target/environment.
+ *
+ * This function ONLY detects and reports. It never installs or configures anything.
+ *
+ * @param root - Project root directory (defaults to current working directory)
+ * @returns Detection result with adapter, confidence, and reasoning
+ *
+ * @example
+ * ```typescript
+ * const result = await detectDeploymentTarget();
+ * console.log(result.adapter); // 'vercel' | 'node' | null | ...
+ * console.log(result.reasoning); // 'VERCEL environment variable detected'
+ * ```
+ */
+declare function detectDeploymentTarget(root?: string): Promise<DeploymentDetection>;
+
+export { detectDeploymentTarget, detectFramework };

package/dist/detect/index.js

@@ -0,0 +1,257 @@
+// src/detect/index.ts
+import { readFile, access } from "fs/promises";
+import { join } from "path";
+async function exists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readPackageJson(root) {
+  try {
+    const content = await readFile(join(root, "package.json"), "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function getDependencies(pkg) {
+  const deps = pkg["dependencies"] ?? {};
+  const devDeps = pkg["devDependencies"] ?? {};
+  return { ...deps, ...devDeps };
+}
+async function detectFramework(root = process.cwd()) {
+  const pkg = await readPackageJson(root);
+  if (pkg) {
+    const deps = getDependencies(pkg);
+    if (deps["react"] && deps["react-dom"]) {
+      return {
+        framework: "react",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found react and react-dom in dependencies"
+      };
+    }
+    if (deps["vue"]) {
+      return {
+        framework: "vue",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found vue in dependencies"
+      };
+    }
+    if (deps["svelte"]) {
+      return {
+        framework: "svelte",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found svelte in dependencies"
+      };
+    }
+    if (deps["solid-js"]) {
+      return {
+        framework: "solid",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found solid-js in dependencies"
+      };
+    }
+    if (deps["preact"]) {
+      return {
+        framework: "preact",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found preact in dependencies"
+      };
+    }
+    if (deps["@builder.io/qwik"]) {
+      return {
+        framework: "qwik",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found @builder.io/qwik in dependencies"
+      };
+    }
+    if (deps["@angular/core"]) {
+      return {
+        framework: "angular",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found @angular/core in dependencies"
+      };
+    }
+    if (deps["lit"]) {
+      return {
+        framework: "lit",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found lit in dependencies"
+      };
+    }
+    if (deps["htmx.org"]) {
+      return {
+        framework: "htmx",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found htmx.org in dependencies"
+      };
+    }
+  }
+  if (await exists(join(root, "svelte.config.js")) || await exists(join(root, "svelte.config.ts"))) {
+    return {
+      framework: "svelte",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found svelte.config.js/ts"
+    };
+  }
+  if (await exists(join(root, "angular.json"))) {
+    return {
+      framework: "angular",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found angular.json"
+    };
+  }
+  if (await exists(join(root, "vue.config.js"))) {
+    return {
+      framework: "vue",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found vue.config.js"
+    };
+  }
+  return {
+    framework: null,
+    confidence: "low",
+    source: "none",
+    reasoning: "No UI framework detected. This is fine - Flight works with vanilla JS/HTML too."
+  };
+}
+async function detectDeploymentTarget(root = process.cwd()) {
+  if (process.env["VERCEL"]) {
+    return {
+      adapter: "vercel",
+      confidence: "high",
+      source: "environment",
+      reasoning: "VERCEL environment variable detected"
+    };
+  }
+  if (process.env["NETLIFY"]) {
+    return {
+      adapter: "netlify",
+      confidence: "high",
+      source: "environment",
+      reasoning: "NETLIFY environment variable detected"
+    };
+  }
+  if (process.env["CF_PAGES"] || process.env["CLOUDFLARE_WORKERS"]) {
+    return {
+      adapter: "cloudflare",
+      confidence: "high",
+      source: "environment",
+      reasoning: "Cloudflare environment variable detected"
+    };
+  }
+  if (process.env["AWS_LAMBDA_FUNCTION_NAME"]) {
+    return {
+      adapter: "aws",
+      confidence: "high",
+      source: "environment",
+      reasoning: "AWS Lambda environment detected"
+    };
+  }
+  if (process.env["FLY_APP_NAME"]) {
+    return {
+      adapter: "fly",
+      confidence: "high",
+      source: "environment",
+      reasoning: "Fly.io environment detected"
+    };
+  }
+  if (process.env["DENO_DEPLOYMENT_ID"]) {
+    return {
+      adapter: "deno",
+      confidence: "high",
+      source: "environment",
+      reasoning: "Deno Deploy environment detected"
+    };
+  }
+  if (await exists(join(root, "vercel.json"))) {
+    return {
+      adapter: "vercel",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found vercel.json"
+    };
+  }
+  if (await exists(join(root, "netlify.toml"))) {
+    return {
+      adapter: "netlify",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found netlify.toml"
+    };
+  }
+  if (await exists(join(root, "wrangler.toml"))) {
+    return {
+      adapter: "cloudflare",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found wrangler.toml"
+    };
+  }
+  if (await exists(join(root, "fly.toml"))) {
+    return {
+      adapter: "fly",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found fly.toml"
+    };
+  }
+  if (await exists(join(root, "Dockerfile"))) {
+    return {
+      adapter: "docker",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found Dockerfile"
+    };
+  }
+  if (await exists(join(root, "serverless.yml")) || await exists(join(root, "serverless.yaml"))) {
+    return {
+      adapter: "aws",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found serverless.yml"
+    };
+  }
+  if (typeof Bun !== "undefined") {
+    return {
+      adapter: "bun",
+      confidence: "high",
+      source: "runtime",
+      reasoning: "Running in Bun runtime"
+    };
+  }
+  if (typeof Deno !== "undefined") {
+    return {
+      adapter: "deno",
+      confidence: "high",
+      source: "runtime",
+      reasoning: "Running in Deno runtime"
+    };
+  }
+  return {
+    adapter: "node",
+    confidence: "low",
+    source: "default",
+    reasoning: "No specific deployment target detected. Defaulting to Node.js (works everywhere)."
+  };
+}
+export {
+  detectDeploymentTarget,
+  detectFramework
+};
+//# sourceMappingURL=index.js.map

package/dist/detect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/detect/index.ts"],"sourcesContent":["/**\r\n * Detection utilities for Flight Framework\r\n * \r\n * These functions DETECT and REPORT. They never apply or install anything.\r\n */\r\n\r\nimport { readFile, access } from 'node:fs/promises';\r\nimport { join } from 'node:path';\r\nimport type {\r\n    FrameworkDetection,\r\n    DeploymentDetection,\r\n    UIFramework,\r\n    DeploymentAdapter,\r\n} from '../types.js';\r\n\r\n/**\r\n * Check if a file exists\r\n */\r\nasync function exists(path: string): Promise<boolean> {\r\n    try {\r\n        await access(path);\r\n        return true;\r\n    } catch {\r\n        return false;\r\n    }\r\n}\r\n\r\n/**\r\n * Read and parse package.json\r\n */\r\nasync function readPackageJson(root: string): Promise<Record<string, unknown> | null> {\r\n    try {\r\n        const content = await readFile(join(root, 'package.json'), 'utf-8');\r\n        return JSON.parse(content) as Record<string, unknown>;\r\n    } catch {\r\n        return null;\r\n    }\r\n}\r\n\r\n/**\r\n * Get all dependencies from package.json\r\n */\r\nfunction getDependencies(pkg: Record<string, unknown>): Record<string, string> {\r\n    const deps = (pkg['dependencies'] ?? {}) as Record<string, string>;\r\n    const devDeps = (pkg['devDependencies'] ?? {}) as Record<string, string>;\r\n    return { ...deps, ...devDeps };\r\n}\r\n\r\n/**\r\n * Detect the UI framework used in the project.\r\n * \r\n * This function ONLY detects and reports. It never installs or configures anything.\r\n * \r\n * @param root - Project root directory (defaults to current working directory)\r\n * @returns Detection result with framework, confidence, and reasoning\r\n * \r\n * @example\r\n * ```typescript\r\n * const result = await detectFramework();\r\n * console.log(result.framework); // 'react' | 'vue' | null | ...\r\n * console.log(result.reasoning); // 'Found react in package.json dependencies'\r\n * ```\r\n */\r\nexport async function detectFramework(root: string = process.cwd()): Promise<FrameworkDetection> {\r\n    // Check 1: package.json dependencies (highest confidence)\r\n    const pkg = await readPackageJson(root);\r\n    if (pkg) {\r\n        const deps = getDependencies(pkg);\r\n\r\n        // React\r\n        if (deps['react'] && deps['react-dom']) {\r\n            return {\r\n                framework: 'react',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found react and react-dom in dependencies',\r\n            };\r\n        }\r\n\r\n        // Vue\r\n        if (deps['vue']) {\r\n            return {\r\n                framework: 'vue',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found vue in dependencies',\r\n            };\r\n        }\r\n\r\n        // Svelte\r\n        if (deps['svelte']) {\r\n            return {\r\n                framework: 'svelte',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found svelte in dependencies',\r\n            };\r\n        }\r\n\r\n        // Solid\r\n        if (deps['solid-js']) {\r\n            return {\r\n                framework: 'solid',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found solid-js in dependencies',\r\n            };\r\n        }\r\n\r\n        // Preact\r\n        if (deps['preact']) {\r\n            return {\r\n                framework: 'preact',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found preact in dependencies',\r\n            };\r\n        }\r\n\r\n        // Qwik\r\n        if (deps['@builder.io/qwik']) {\r\n            return {\r\n                framework: 'qwik',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found @builder.io/qwik in dependencies',\r\n            };\r\n        }\r\n\r\n        // Angular\r\n        if (deps['@angular/core']) {\r\n            return {\r\n                framework: 'angular',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found @angular/core in dependencies',\r\n            };\r\n        }\r\n\r\n        // Lit\r\n        if (deps['lit']) {\r\n            return {\r\n                framework: 'lit',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found lit in dependencies',\r\n            };\r\n        }\r\n\r\n        // HTMX\r\n        if (deps['htmx.org']) {\r\n            return {\r\n                framework: 'htmx',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found htmx.org in dependencies',\r\n            };\r\n        }\r\n    }\r\n\r\n    // Check 2: Config files (medium confidence)\r\n    if (await exists(join(root, 'svelte.config.js')) || await exists(join(root, 'svelte.config.ts'))) {\r\n        return {\r\n            framework: 'svelte',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found svelte.config.js/ts',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'angular.json'))) {\r\n        return {\r\n            framework: 'angular',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found angular.json',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'vue.config.js'))) {\r\n        return {\r\n            framework: 'vue',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found vue.config.js',\r\n        };\r\n    }\r\n\r\n    // No framework detected\r\n    return {\r\n        framework: null,\r\n        confidence: 'low',\r\n        source: 'none',\r\n        reasoning: 'No UI framework detected. This is fine - Flight works with vanilla JS/HTML too.',\r\n    };\r\n}\r\n\r\n/**\r\n * Detect the deployment target/environment.\r\n * \r\n * This function ONLY detects and reports. It never installs or configures anything.\r\n * \r\n * @param root - Project root directory (defaults to current working directory)\r\n * @returns Detection result with adapter, confidence, and reasoning\r\n * \r\n * @example\r\n * ```typescript\r\n * const result = await detectDeploymentTarget();\r\n * console.log(result.adapter); // 'vercel' | 'node' | null | ...\r\n * console.log(result.reasoning); // 'VERCEL environment variable detected'\r\n * ```\r\n */\r\nexport async function detectDeploymentTarget(root: string = process.cwd()): Promise<DeploymentDetection> {\r\n    // Check 1: Environment variables (highest confidence - we're running in the environment)\r\n    if (process.env['VERCEL']) {\r\n        return {\r\n            adapter: 'vercel',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'VERCEL environment variable detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['NETLIFY']) {\r\n        return {\r\n            adapter: 'netlify',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'NETLIFY environment variable detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['CF_PAGES'] || process.env['CLOUDFLARE_WORKERS']) {\r\n        return {\r\n            adapter: 'cloudflare',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'Cloudflare environment variable detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['AWS_LAMBDA_FUNCTION_NAME']) {\r\n        return {\r\n            adapter: 'aws',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'AWS Lambda environment detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['FLY_APP_NAME']) {\r\n        return {\r\n            adapter: 'fly',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'Fly.io environment detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['DENO_DEPLOYMENT_ID']) {\r\n        return {\r\n            adapter: 'deno',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'Deno Deploy environment detected',\r\n        };\r\n    }\r\n\r\n    // Check 2: Config files (medium confidence - user intent)\r\n    if (await exists(join(root, 'vercel.json'))) {\r\n        return {\r\n            adapter: 'vercel',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found vercel.json',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'netlify.toml'))) {\r\n        return {\r\n            adapter: 'netlify',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found netlify.toml',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'wrangler.toml'))) {\r\n        return {\r\n            adapter: 'cloudflare',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found wrangler.toml',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'fly.toml'))) {\r\n        return {\r\n            adapter: 'fly',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found fly.toml',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'Dockerfile'))) {\r\n        return {\r\n            adapter: 'docker',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found Dockerfile',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'serverless.yml')) || await exists(join(root, 'serverless.yaml'))) {\r\n        return {\r\n            adapter: 'aws',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found serverless.yml',\r\n        };\r\n    }\r\n\r\n    // Check 3: Runtime detection\r\n    // @ts-expect-error - Bun global\r\n    if (typeof Bun !== 'undefined') {\r\n        return {\r\n            adapter: 'bun',\r\n            confidence: 'high',\r\n            source: 'runtime',\r\n            reasoning: 'Running in Bun runtime',\r\n        };\r\n    }\r\n\r\n    // @ts-expect-error - Deno global\r\n    if (typeof Deno !== 'undefined') {\r\n        return {\r\n            adapter: 'deno',\r\n            confidence: 'high',\r\n            source: 'runtime',\r\n            reasoning: 'Running in Deno runtime',\r\n        };\r\n    }\r\n\r\n    // Default: Node.js (always available)\r\n    return {\r\n        adapter: 'node',\r\n        confidence: 'low',\r\n        source: 'default',\r\n        reasoning: 'No specific deployment target detected. Defaulting to Node.js (works everywhere).',\r\n    };\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { detectDeploymentTarget, detectFramework } from './detect/index.js';
+export { suggestDefaults } from './suggest/index.js';
+export { C as ConfidenceLevel, D as DeploymentDetection, F as FrameworkDetection, S as SuggestedDefaults } from './types-0ONEhDBI.js';

package/dist/index.js

@@ -0,0 +1,287 @@
+// src/detect/index.ts
+import { readFile, access } from "fs/promises";
+import { join } from "path";
+async function exists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readPackageJson(root) {
+  try {
+    const content = await readFile(join(root, "package.json"), "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function getDependencies(pkg) {
+  const deps = pkg["dependencies"] ?? {};
+  const devDeps = pkg["devDependencies"] ?? {};
+  return { ...deps, ...devDeps };
+}
+async function detectFramework(root = process.cwd()) {
+  const pkg = await readPackageJson(root);
+  if (pkg) {
+    const deps = getDependencies(pkg);
+    if (deps["react"] && deps["react-dom"]) {
+      return {
+        framework: "react",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found react and react-dom in dependencies"
+      };
+    }
+    if (deps["vue"]) {
+      return {
+        framework: "vue",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found vue in dependencies"
+      };
+    }
+    if (deps["svelte"]) {
+      return {
+        framework: "svelte",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found svelte in dependencies"
+      };
+    }
+    if (deps["solid-js"]) {
+      return {
+        framework: "solid",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found solid-js in dependencies"
+      };
+    }
+    if (deps["preact"]) {
+      return {
+        framework: "preact",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found preact in dependencies"
+      };
+    }
+    if (deps["@builder.io/qwik"]) {
+      return {
+        framework: "qwik",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found @builder.io/qwik in dependencies"
+      };
+    }
+    if (deps["@angular/core"]) {
+      return {
+        framework: "angular",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found @angular/core in dependencies"
+      };
+    }
+    if (deps["lit"]) {
+      return {
+        framework: "lit",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found lit in dependencies"
+      };
+    }
+    if (deps["htmx.org"]) {
+      return {
+        framework: "htmx",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found htmx.org in dependencies"
+      };
+    }
+  }
+  if (await exists(join(root, "svelte.config.js")) || await exists(join(root, "svelte.config.ts"))) {
+    return {
+      framework: "svelte",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found svelte.config.js/ts"
+    };
+  }
+  if (await exists(join(root, "angular.json"))) {
+    return {
+      framework: "angular",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found angular.json"
+    };
+  }
+  if (await exists(join(root, "vue.config.js"))) {
+    return {
+      framework: "vue",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found vue.config.js"
+    };
+  }
+  return {
+    framework: null,
+    confidence: "low",
+    source: "none",
+    reasoning: "No UI framework detected. This is fine - Flight works with vanilla JS/HTML too."
+  };
+}
+async function detectDeploymentTarget(root = process.cwd()) {
+  if (process.env["VERCEL"]) {
+    return {
+      adapter: "vercel",
+      confidence: "high",
+      source: "environment",
+      reasoning: "VERCEL environment variable detected"
+    };
+  }
+  if (process.env["NETLIFY"]) {
+    return {
+      adapter: "netlify",
+      confidence: "high",
+      source: "environment",
+      reasoning: "NETLIFY environment variable detected"
+    };
+  }
+  if (process.env["CF_PAGES"] || process.env["CLOUDFLARE_WORKERS"]) {
+    return {
+      adapter: "cloudflare",
+      confidence: "high",
+      source: "environment",
+      reasoning: "Cloudflare environment variable detected"
+    };
+  }
+  if (process.env["AWS_LAMBDA_FUNCTION_NAME"]) {
+    return {
+      adapter: "aws",
+      confidence: "high",
+      source: "environment",
+      reasoning: "AWS Lambda environment detected"
+    };
+  }
+  if (process.env["FLY_APP_NAME"]) {
+    return {
+      adapter: "fly",
+      confidence: "high",
+      source: "environment",
+      reasoning: "Fly.io environment detected"
+    };
+  }
+  if (process.env["DENO_DEPLOYMENT_ID"]) {
+    return {
+      adapter: "deno",
+      confidence: "high",
+      source: "environment",
+      reasoning: "Deno Deploy environment detected"
+    };
+  }
+  if (await exists(join(root, "vercel.json"))) {
+    return {
+      adapter: "vercel",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found vercel.json"
+    };
+  }
+  if (await exists(join(root, "netlify.toml"))) {
+    return {
+      adapter: "netlify",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found netlify.toml"
+    };
+  }
+  if (await exists(join(root, "wrangler.toml"))) {
+    return {
+      adapter: "cloudflare",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found wrangler.toml"
+    };
+  }
+  if (await exists(join(root, "fly.toml"))) {
+    return {
+      adapter: "fly",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found fly.toml"
+    };
+  }
+  if (await exists(join(root, "Dockerfile"))) {
+    return {
+      adapter: "docker",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found Dockerfile"
+    };
+  }
+  if (await exists(join(root, "serverless.yml")) || await exists(join(root, "serverless.yaml"))) {
+    return {
+      adapter: "aws",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found serverless.yml"
+    };
+  }
+  if (typeof Bun !== "undefined") {
+    return {
+      adapter: "bun",
+      confidence: "high",
+      source: "runtime",
+      reasoning: "Running in Bun runtime"
+    };
+  }
+  if (typeof Deno !== "undefined") {
+    return {
+      adapter: "deno",
+      confidence: "high",
+      source: "runtime",
+      reasoning: "Running in Deno runtime"
+    };
+  }
+  return {
+    adapter: "node",
+    confidence: "low",
+    source: "default",
+    reasoning: "No specific deployment target detected. Defaulting to Node.js (works everywhere)."
+  };
+}
+
+// src/suggest/index.ts
+async function suggestDefaults(root = process.cwd()) {
+  const [frameworkResult, adapterResult] = await Promise.all([
+    detectFramework(root),
+    detectDeploymentTarget(root)
+  ]);
+  let rendering = "ssr";
+  if (frameworkResult.framework === "htmx") {
+    rendering = "ssr";
+  }
+  if (frameworkResult.framework === "qwik") {
+    rendering = "ssr";
+  }
+  if (adapterResult.adapter === "static") {
+    rendering = "ssg";
+  }
+  const bundler = "vite";
+  return {
+    framework: frameworkResult.framework,
+    adapter: adapterResult.adapter,
+    rendering,
+    bundler,
+    confidence: {
+      framework: frameworkResult.confidence,
+      adapter: adapterResult.confidence
+    }
+  };
+}
+export {
+  detectDeploymentTarget,
+  detectFramework,
+  suggestDefaults
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/detect/index.ts","../src/suggest/index.ts"],"sourcesContent":["/**\r\n * Detection utilities for Flight Framework\r\n * \r\n * These functions DETECT and REPORT. They never apply or install anything.\r\n */\r\n\r\nimport { readFile, access } from 'node:fs/promises';\r\nimport { join } from 'node:path';\r\nimport type {\r\n    FrameworkDetection,\r\n    DeploymentDetection,\r\n    UIFramework,\r\n    DeploymentAdapter,\r\n} from '../types.js';\r\n\r\n/**\r\n * Check if a file exists\r\n */\r\nasync function exists(path: string): Promise<boolean> {\r\n    try {\r\n        await access(path);\r\n        return true;\r\n    } catch {\r\n        return false;\r\n    }\r\n}\r\n\r\n/**\r\n * Read and parse package.json\r\n */\r\nasync function readPackageJson(root: string): Promise<Record<string, unknown> | null> {\r\n    try {\r\n        const content = await readFile(join(root, 'package.json'), 'utf-8');\r\n        return JSON.parse(content) as Record<string, unknown>;\r\n    } catch {\r\n        return null;\r\n    }\r\n}\r\n\r\n/**\r\n * Get all dependencies from package.json\r\n */\r\nfunction getDependencies(pkg: Record<string, unknown>): Record<string, string> {\r\n    const deps = (pkg['dependencies'] ?? {}) as Record<string, string>;\r\n    const devDeps = (pkg['devDependencies'] ?? {}) as Record<string, string>;\r\n    return { ...deps, ...devDeps };\r\n}\r\n\r\n/**\r\n * Detect the UI framework used in the project.\r\n * \r\n * This function ONLY detects and reports. It never installs or configures anything.\r\n * \r\n * @param root - Project root directory (defaults to current working directory)\r\n * @returns Detection result with framework, confidence, and reasoning\r\n * \r\n * @example\r\n * ```typescript\r\n * const result = await detectFramework();\r\n * console.log(result.framework); // 'react' | 'vue' | null | ...\r\n * console.log(result.reasoning); // 'Found react in package.json dependencies'\r\n * ```\r\n */\r\nexport async function detectFramework(root: string = process.cwd()): Promise<FrameworkDetection> {\r\n    // Check 1: package.json dependencies (highest confidence)\r\n    const pkg = await readPackageJson(root);\r\n    if (pkg) {\r\n        const deps = getDependencies(pkg);\r\n\r\n        // React\r\n        if (deps['react'] && deps['react-dom']) {\r\n            return {\r\n                framework: 'react',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found react and react-dom in dependencies',\r\n            };\r\n        }\r\n\r\n        // Vue\r\n        if (deps['vue']) {\r\n            return {\r\n                framework: 'vue',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found vue in dependencies',\r\n            };\r\n        }\r\n\r\n        // Svelte\r\n        if (deps['svelte']) {\r\n            return {\r\n                framework: 'svelte',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found svelte in dependencies',\r\n            };\r\n        }\r\n\r\n        // Solid\r\n        if (deps['solid-js']) {\r\n            return {\r\n                framework: 'solid',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found solid-js in dependencies',\r\n            };\r\n        }\r\n\r\n        // Preact\r\n        if (deps['preact']) {\r\n            return {\r\n                framework: 'preact',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found preact in dependencies',\r\n            };\r\n        }\r\n\r\n        // Qwik\r\n        if (deps['@builder.io/qwik']) {\r\n            return {\r\n                framework: 'qwik',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found @builder.io/qwik in dependencies',\r\n            };\r\n        }\r\n\r\n        // Angular\r\n        if (deps['@angular/core']) {\r\n            return {\r\n                framework: 'angular',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found @angular/core in dependencies',\r\n            };\r\n        }\r\n\r\n        // Lit\r\n        if (deps['lit']) {\r\n            return {\r\n                framework: 'lit',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found lit in dependencies',\r\n            };\r\n        }\r\n\r\n        // HTMX\r\n        if (deps['htmx.org']) {\r\n            return {\r\n                framework: 'htmx',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found htmx.org in dependencies',\r\n            };\r\n        }\r\n    }\r\n\r\n    // Check 2: Config files (medium confidence)\r\n    if (await exists(join(root, 'svelte.config.js')) || await exists(join(root, 'svelte.config.ts'))) {\r\n        return {\r\n            framework: 'svelte',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found svelte.config.js/ts',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'angular.json'))) {\r\n        return {\r\n            framework: 'angular',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found angular.json',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'vue.config.js'))) {\r\n        return {\r\n            framework: 'vue',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found vue.config.js',\r\n        };\r\n    }\r\n\r\n    // No framework detected\r\n    return {\r\n        framework: null,\r\n        confidence: 'low',\r\n        source: 'none',\r\n        reasoning: 'No UI framework detected. This is fine - Flight works with vanilla JS/HTML too.',\r\n    };\r\n}\r\n\r\n/**\r\n * Detect the deployment target/environment.\r\n * \r\n * This function ONLY detects and reports. It never installs or configures anything.\r\n * \r\n * @param root - Project root directory (defaults to current working directory)\r\n * @returns Detection result with adapter, confidence, and reasoning\r\n * \r\n * @example\r\n * ```typescript\r\n * const result = await detectDeploymentTarget();\r\n * console.log(result.adapter); // 'vercel' | 'node' | null | ...\r\n * console.log(result.reasoning); // 'VERCEL environment variable detected'\r\n * ```\r\n */\r\nexport async function detectDeploymentTarget(root: string = process.cwd()): Promise<DeploymentDetection> {\r\n    // Check 1: Environment variables (highest confidence - we're running in the environment)\r\n    if (process.env['VERCEL']) {\r\n        return {\r\n            adapter: 'vercel',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'VERCEL environment variable detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['NETLIFY']) {\r\n        return {\r\n            adapter: 'netlify',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'NETLIFY environment variable detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['CF_PAGES'] || process.env['CLOUDFLARE_WORKERS']) {\r\n        return {\r\n            adapter: 'cloudflare',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'Cloudflare environment variable detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['AWS_LAMBDA_FUNCTION_NAME']) {\r\n        return {\r\n            adapter: 'aws',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'AWS Lambda environment detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['FLY_APP_NAME']) {\r\n        return {\r\n            adapter: 'fly',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'Fly.io environment detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['DENO_DEPLOYMENT_ID']) {\r\n        return {\r\n            adapter: 'deno',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'Deno Deploy environment detected',\r\n        };\r\n    }\r\n\r\n    // Check 2: Config files (medium confidence - user intent)\r\n    if (await exists(join(root, 'vercel.json'))) {\r\n        return {\r\n            adapter: 'vercel',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found vercel.json',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'netlify.toml'))) {\r\n        return {\r\n            adapter: 'netlify',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found netlify.toml',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'wrangler.toml'))) {\r\n        return {\r\n            adapter: 'cloudflare',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found wrangler.toml',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'fly.toml'))) {\r\n        return {\r\n            adapter: 'fly',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found fly.toml',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'Dockerfile'))) {\r\n        return {\r\n            adapter: 'docker',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found Dockerfile',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'serverless.yml')) || await exists(join(root, 'serverless.yaml'))) {\r\n        return {\r\n            adapter: 'aws',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found serverless.yml',\r\n        };\r\n    }\r\n\r\n    // Check 3: Runtime detection\r\n    // @ts-expect-error - Bun global\r\n    if (typeof Bun !== 'undefined') {\r\n        return {\r\n            adapter: 'bun',\r\n            confidence: 'high',\r\n            source: 'runtime',\r\n            reasoning: 'Running in Bun runtime',\r\n        };\r\n    }\r\n\r\n    // @ts-expect-error - Deno global\r\n    if (typeof Deno !== 'undefined') {\r\n        return {\r\n            adapter: 'deno',\r\n            confidence: 'high',\r\n            source: 'runtime',\r\n            reasoning: 'Running in Deno runtime',\r\n        };\r\n    }\r\n\r\n    // Default: Node.js (always available)\r\n    return {\r\n        adapter: 'node',\r\n        confidence: 'low',\r\n        source: 'default',\r\n        reasoning: 'No specific deployment target detected. Defaulting to Node.js (works everywhere).',\r\n    };\r\n}\r\n","/**\r\n * Suggestion utilities for Flight Framework\r\n * \r\n * These functions SUGGEST configurations based on detected context.\r\n * They never apply anything automatically. You decide.\r\n */\r\n\r\nimport { detectFramework, detectDeploymentTarget } from '../detect/index.js';\r\nimport type { SuggestedDefaults } from '../types.js';\r\n\r\n/**\r\n * Suggest default configuration based on project analysis.\r\n * \r\n * This function ONLY suggests. It never applies, installs, or modifies anything.\r\n * You are free to use these suggestions, modify them, or ignore them entirely.\r\n * \r\n * @param root - Project root directory (defaults to current working directory)\r\n * @returns Suggested defaults with confidence levels\r\n * \r\n * @example\r\n * ```typescript\r\n * const suggestions = await suggestDefaults();\r\n * \r\n * // Use suggestions in your config (optional)\r\n * export default {\r\n *   ui: { framework: suggestions.framework ?? 'react' },\r\n * };\r\n * \r\n * // Or ignore them entirely\r\n * export default {\r\n *   ui: { framework: 'vue' },\r\n * };\r\n * ```\r\n */\r\nexport async function suggestDefaults(root: string = process.cwd()): Promise<SuggestedDefaults> {\r\n    // Detect context\r\n    const [frameworkResult, adapterResult] = await Promise.all([\r\n        detectFramework(root),\r\n        detectDeploymentTarget(root),\r\n    ]);\r\n\r\n    // Determine rendering mode based on framework\r\n    let rendering: 'ssr' | 'csr' | 'ssg' = 'ssr';\r\n\r\n    // HTMX and static sites are typically SSR/SSG\r\n    if (frameworkResult.framework === 'htmx') {\r\n        rendering = 'ssr';\r\n    }\r\n\r\n    // Qwik uses resumability, SSR is recommended\r\n    if (frameworkResult.framework === 'qwik') {\r\n        rendering = 'ssr';\r\n    }\r\n\r\n    // Static adapters should use SSG\r\n    if (adapterResult.adapter === 'static') {\r\n        rendering = 'ssg';\r\n    }\r\n\r\n    // Determine bundler\r\n    // Vite is the most universal choice\r\n    const bundler = 'vite' as const;\r\n\r\n    return {\r\n        framework: frameworkResult.framework,\r\n        adapter: adapterResult.adapter,\r\n        rendering,\r\n        bundler,\r\n        confidence: {\r\n            framework: frameworkResult.confidence,\r\n            adapter: adapterResult.confidence,\r\n        },\r\n    };\r\n}\r\n\r\n/**\r\n * Log suggestions to console in a helpful format.\r\n * Useful for CLI tools.\r\n * \r\n * @param suggestions - Suggested defaults from suggestDefaults()\r\n */\r\nexport function logSuggestions(suggestions: SuggestedDefaults): void {\r\n    console.log('\\n📋 Flight Suggestions (optional)\\n');\r\n\r\n    if (suggestions.framework) {\r\n        console.log(`  UI Framework: ${suggestions.framework} (${suggestions.confidence.framework} confidence)`);\r\n    } else {\r\n        console.log('  UI Framework: none detected (vanilla JS/HTML works fine)');\r\n    }\r\n\r\n    if (suggestions.adapter) {\r\n        console.log(`  Deployment:   ${suggestions.adapter} (${suggestions.confidence.adapter} confidence)`);\r\n    }\r\n\r\n    console.log(`  Rendering:    ${suggestions.rendering}`);\r\n    console.log(`  Bundler:      ${suggestions.bundler}`);\r\n\r\n    console.log('\\n💡 These are suggestions only. You can override any of these in flight.config.ts\\n');\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/suggest/index.d.ts

@@ -0,0 +1,43 @@
+import { S as SuggestedDefaults } from '../types-0ONEhDBI.js';
+
+/**
+ * Suggestion utilities for Flight Framework
+ *
+ * These functions SUGGEST configurations based on detected context.
+ * They never apply anything automatically. You decide.
+ */
+
+/**
+ * Suggest default configuration based on project analysis.
+ *
+ * This function ONLY suggests. It never applies, installs, or modifies anything.
+ * You are free to use these suggestions, modify them, or ignore them entirely.
+ *
+ * @param root - Project root directory (defaults to current working directory)
+ * @returns Suggested defaults with confidence levels
+ *
+ * @example
+ * ```typescript
+ * const suggestions = await suggestDefaults();
+ *
+ * // Use suggestions in your config (optional)
+ * export default {
+ *   ui: { framework: suggestions.framework ?? 'react' },
+ * };
+ *
+ * // Or ignore them entirely
+ * export default {
+ *   ui: { framework: 'vue' },
+ * };
+ * ```
+ */
+declare function suggestDefaults(root?: string): Promise<SuggestedDefaults>;
+/**
+ * Log suggestions to console in a helpful format.
+ * Useful for CLI tools.
+ *
+ * @param suggestions - Suggested defaults from suggestDefaults()
+ */
+declare function logSuggestions(suggestions: SuggestedDefaults): void;
+
+export { logSuggestions, suggestDefaults };

package/dist/suggest/index.js

@@ -0,0 +1,300 @@
+// src/detect/index.ts
+import { readFile, access } from "fs/promises";
+import { join } from "path";
+async function exists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readPackageJson(root) {
+  try {
+    const content = await readFile(join(root, "package.json"), "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function getDependencies(pkg) {
+  const deps = pkg["dependencies"] ?? {};
+  const devDeps = pkg["devDependencies"] ?? {};
+  return { ...deps, ...devDeps };
+}
+async function detectFramework(root = process.cwd()) {
+  const pkg = await readPackageJson(root);
+  if (pkg) {
+    const deps = getDependencies(pkg);
+    if (deps["react"] && deps["react-dom"]) {
+      return {
+        framework: "react",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found react and react-dom in dependencies"
+      };
+    }
+    if (deps["vue"]) {
+      return {
+        framework: "vue",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found vue in dependencies"
+      };
+    }
+    if (deps["svelte"]) {
+      return {
+        framework: "svelte",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found svelte in dependencies"
+      };
+    }
+    if (deps["solid-js"]) {
+      return {
+        framework: "solid",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found solid-js in dependencies"
+      };
+    }
+    if (deps["preact"]) {
+      return {
+        framework: "preact",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found preact in dependencies"
+      };
+    }
+    if (deps["@builder.io/qwik"]) {
+      return {
+        framework: "qwik",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found @builder.io/qwik in dependencies"
+      };
+    }
+    if (deps["@angular/core"]) {
+      return {
+        framework: "angular",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found @angular/core in dependencies"
+      };
+    }
+    if (deps["lit"]) {
+      return {
+        framework: "lit",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found lit in dependencies"
+      };
+    }
+    if (deps["htmx.org"]) {
+      return {
+        framework: "htmx",
+        confidence: "high",
+        source: "package.json",
+        reasoning: "Found htmx.org in dependencies"
+      };
+    }
+  }
+  if (await exists(join(root, "svelte.config.js")) || await exists(join(root, "svelte.config.ts"))) {
+    return {
+      framework: "svelte",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found svelte.config.js/ts"
+    };
+  }
+  if (await exists(join(root, "angular.json"))) {
+    return {
+      framework: "angular",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found angular.json"
+    };
+  }
+  if (await exists(join(root, "vue.config.js"))) {
+    return {
+      framework: "vue",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found vue.config.js"
+    };
+  }
+  return {
+    framework: null,
+    confidence: "low",
+    source: "none",
+    reasoning: "No UI framework detected. This is fine - Flight works with vanilla JS/HTML too."
+  };
+}
+async function detectDeploymentTarget(root = process.cwd()) {
+  if (process.env["VERCEL"]) {
+    return {
+      adapter: "vercel",
+      confidence: "high",
+      source: "environment",
+      reasoning: "VERCEL environment variable detected"
+    };
+  }
+  if (process.env["NETLIFY"]) {
+    return {
+      adapter: "netlify",
+      confidence: "high",
+      source: "environment",
+      reasoning: "NETLIFY environment variable detected"
+    };
+  }
+  if (process.env["CF_PAGES"] || process.env["CLOUDFLARE_WORKERS"]) {
+    return {
+      adapter: "cloudflare",
+      confidence: "high",
+      source: "environment",
+      reasoning: "Cloudflare environment variable detected"
+    };
+  }
+  if (process.env["AWS_LAMBDA_FUNCTION_NAME"]) {
+    return {
+      adapter: "aws",
+      confidence: "high",
+      source: "environment",
+      reasoning: "AWS Lambda environment detected"
+    };
+  }
+  if (process.env["FLY_APP_NAME"]) {
+    return {
+      adapter: "fly",
+      confidence: "high",
+      source: "environment",
+      reasoning: "Fly.io environment detected"
+    };
+  }
+  if (process.env["DENO_DEPLOYMENT_ID"]) {
+    return {
+      adapter: "deno",
+      confidence: "high",
+      source: "environment",
+      reasoning: "Deno Deploy environment detected"
+    };
+  }
+  if (await exists(join(root, "vercel.json"))) {
+    return {
+      adapter: "vercel",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found vercel.json"
+    };
+  }
+  if (await exists(join(root, "netlify.toml"))) {
+    return {
+      adapter: "netlify",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found netlify.toml"
+    };
+  }
+  if (await exists(join(root, "wrangler.toml"))) {
+    return {
+      adapter: "cloudflare",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found wrangler.toml"
+    };
+  }
+  if (await exists(join(root, "fly.toml"))) {
+    return {
+      adapter: "fly",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found fly.toml"
+    };
+  }
+  if (await exists(join(root, "Dockerfile"))) {
+    return {
+      adapter: "docker",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found Dockerfile"
+    };
+  }
+  if (await exists(join(root, "serverless.yml")) || await exists(join(root, "serverless.yaml"))) {
+    return {
+      adapter: "aws",
+      confidence: "medium",
+      source: "config file",
+      reasoning: "Found serverless.yml"
+    };
+  }
+  if (typeof Bun !== "undefined") {
+    return {
+      adapter: "bun",
+      confidence: "high",
+      source: "runtime",
+      reasoning: "Running in Bun runtime"
+    };
+  }
+  if (typeof Deno !== "undefined") {
+    return {
+      adapter: "deno",
+      confidence: "high",
+      source: "runtime",
+      reasoning: "Running in Deno runtime"
+    };
+  }
+  return {
+    adapter: "node",
+    confidence: "low",
+    source: "default",
+    reasoning: "No specific deployment target detected. Defaulting to Node.js (works everywhere)."
+  };
+}
+
+// src/suggest/index.ts
+async function suggestDefaults(root = process.cwd()) {
+  const [frameworkResult, adapterResult] = await Promise.all([
+    detectFramework(root),
+    detectDeploymentTarget(root)
+  ]);
+  let rendering = "ssr";
+  if (frameworkResult.framework === "htmx") {
+    rendering = "ssr";
+  }
+  if (frameworkResult.framework === "qwik") {
+    rendering = "ssr";
+  }
+  if (adapterResult.adapter === "static") {
+    rendering = "ssg";
+  }
+  const bundler = "vite";
+  return {
+    framework: frameworkResult.framework,
+    adapter: adapterResult.adapter,
+    rendering,
+    bundler,
+    confidence: {
+      framework: frameworkResult.confidence,
+      adapter: adapterResult.confidence
+    }
+  };
+}
+function logSuggestions(suggestions) {
+  console.log("\n\u{1F4CB} Flight Suggestions (optional)\n");
+  if (suggestions.framework) {
+    console.log(`  UI Framework: ${suggestions.framework} (${suggestions.confidence.framework} confidence)`);
+  } else {
+    console.log("  UI Framework: none detected (vanilla JS/HTML works fine)");
+  }
+  if (suggestions.adapter) {
+    console.log(`  Deployment:   ${suggestions.adapter} (${suggestions.confidence.adapter} confidence)`);
+  }
+  console.log(`  Rendering:    ${suggestions.rendering}`);
+  console.log(`  Bundler:      ${suggestions.bundler}`);
+  console.log("\n\u{1F4A1} These are suggestions only. You can override any of these in flight.config.ts\n");
+}
+export {
+  logSuggestions,
+  suggestDefaults
+};
+//# sourceMappingURL=index.js.map

package/dist/suggest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/detect/index.ts","../../src/suggest/index.ts"],"sourcesContent":["/**\r\n * Detection utilities for Flight Framework\r\n * \r\n * These functions DETECT and REPORT. They never apply or install anything.\r\n */\r\n\r\nimport { readFile, access } from 'node:fs/promises';\r\nimport { join } from 'node:path';\r\nimport type {\r\n    FrameworkDetection,\r\n    DeploymentDetection,\r\n    UIFramework,\r\n    DeploymentAdapter,\r\n} from '../types.js';\r\n\r\n/**\r\n * Check if a file exists\r\n */\r\nasync function exists(path: string): Promise<boolean> {\r\n    try {\r\n        await access(path);\r\n        return true;\r\n    } catch {\r\n        return false;\r\n    }\r\n}\r\n\r\n/**\r\n * Read and parse package.json\r\n */\r\nasync function readPackageJson(root: string): Promise<Record<string, unknown> | null> {\r\n    try {\r\n        const content = await readFile(join(root, 'package.json'), 'utf-8');\r\n        return JSON.parse(content) as Record<string, unknown>;\r\n    } catch {\r\n        return null;\r\n    }\r\n}\r\n\r\n/**\r\n * Get all dependencies from package.json\r\n */\r\nfunction getDependencies(pkg: Record<string, unknown>): Record<string, string> {\r\n    const deps = (pkg['dependencies'] ?? {}) as Record<string, string>;\r\n    const devDeps = (pkg['devDependencies'] ?? {}) as Record<string, string>;\r\n    return { ...deps, ...devDeps };\r\n}\r\n\r\n/**\r\n * Detect the UI framework used in the project.\r\n * \r\n * This function ONLY detects and reports. It never installs or configures anything.\r\n * \r\n * @param root - Project root directory (defaults to current working directory)\r\n * @returns Detection result with framework, confidence, and reasoning\r\n * \r\n * @example\r\n * ```typescript\r\n * const result = await detectFramework();\r\n * console.log(result.framework); // 'react' | 'vue' | null | ...\r\n * console.log(result.reasoning); // 'Found react in package.json dependencies'\r\n * ```\r\n */\r\nexport async function detectFramework(root: string = process.cwd()): Promise<FrameworkDetection> {\r\n    // Check 1: package.json dependencies (highest confidence)\r\n    const pkg = await readPackageJson(root);\r\n    if (pkg) {\r\n        const deps = getDependencies(pkg);\r\n\r\n        // React\r\n        if (deps['react'] && deps['react-dom']) {\r\n            return {\r\n                framework: 'react',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found react and react-dom in dependencies',\r\n            };\r\n        }\r\n\r\n        // Vue\r\n        if (deps['vue']) {\r\n            return {\r\n                framework: 'vue',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found vue in dependencies',\r\n            };\r\n        }\r\n\r\n        // Svelte\r\n        if (deps['svelte']) {\r\n            return {\r\n                framework: 'svelte',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found svelte in dependencies',\r\n            };\r\n        }\r\n\r\n        // Solid\r\n        if (deps['solid-js']) {\r\n            return {\r\n                framework: 'solid',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found solid-js in dependencies',\r\n            };\r\n        }\r\n\r\n        // Preact\r\n        if (deps['preact']) {\r\n            return {\r\n                framework: 'preact',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found preact in dependencies',\r\n            };\r\n        }\r\n\r\n        // Qwik\r\n        if (deps['@builder.io/qwik']) {\r\n            return {\r\n                framework: 'qwik',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found @builder.io/qwik in dependencies',\r\n            };\r\n        }\r\n\r\n        // Angular\r\n        if (deps['@angular/core']) {\r\n            return {\r\n                framework: 'angular',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found @angular/core in dependencies',\r\n            };\r\n        }\r\n\r\n        // Lit\r\n        if (deps['lit']) {\r\n            return {\r\n                framework: 'lit',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found lit in dependencies',\r\n            };\r\n        }\r\n\r\n        // HTMX\r\n        if (deps['htmx.org']) {\r\n            return {\r\n                framework: 'htmx',\r\n                confidence: 'high',\r\n                source: 'package.json',\r\n                reasoning: 'Found htmx.org in dependencies',\r\n            };\r\n        }\r\n    }\r\n\r\n    // Check 2: Config files (medium confidence)\r\n    if (await exists(join(root, 'svelte.config.js')) || await exists(join(root, 'svelte.config.ts'))) {\r\n        return {\r\n            framework: 'svelte',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found svelte.config.js/ts',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'angular.json'))) {\r\n        return {\r\n            framework: 'angular',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found angular.json',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'vue.config.js'))) {\r\n        return {\r\n            framework: 'vue',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found vue.config.js',\r\n        };\r\n    }\r\n\r\n    // No framework detected\r\n    return {\r\n        framework: null,\r\n        confidence: 'low',\r\n        source: 'none',\r\n        reasoning: 'No UI framework detected. This is fine - Flight works with vanilla JS/HTML too.',\r\n    };\r\n}\r\n\r\n/**\r\n * Detect the deployment target/environment.\r\n * \r\n * This function ONLY detects and reports. It never installs or configures anything.\r\n * \r\n * @param root - Project root directory (defaults to current working directory)\r\n * @returns Detection result with adapter, confidence, and reasoning\r\n * \r\n * @example\r\n * ```typescript\r\n * const result = await detectDeploymentTarget();\r\n * console.log(result.adapter); // 'vercel' | 'node' | null | ...\r\n * console.log(result.reasoning); // 'VERCEL environment variable detected'\r\n * ```\r\n */\r\nexport async function detectDeploymentTarget(root: string = process.cwd()): Promise<DeploymentDetection> {\r\n    // Check 1: Environment variables (highest confidence - we're running in the environment)\r\n    if (process.env['VERCEL']) {\r\n        return {\r\n            adapter: 'vercel',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'VERCEL environment variable detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['NETLIFY']) {\r\n        return {\r\n            adapter: 'netlify',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'NETLIFY environment variable detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['CF_PAGES'] || process.env['CLOUDFLARE_WORKERS']) {\r\n        return {\r\n            adapter: 'cloudflare',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'Cloudflare environment variable detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['AWS_LAMBDA_FUNCTION_NAME']) {\r\n        return {\r\n            adapter: 'aws',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'AWS Lambda environment detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['FLY_APP_NAME']) {\r\n        return {\r\n            adapter: 'fly',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'Fly.io environment detected',\r\n        };\r\n    }\r\n\r\n    if (process.env['DENO_DEPLOYMENT_ID']) {\r\n        return {\r\n            adapter: 'deno',\r\n            confidence: 'high',\r\n            source: 'environment',\r\n            reasoning: 'Deno Deploy environment detected',\r\n        };\r\n    }\r\n\r\n    // Check 2: Config files (medium confidence - user intent)\r\n    if (await exists(join(root, 'vercel.json'))) {\r\n        return {\r\n            adapter: 'vercel',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found vercel.json',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'netlify.toml'))) {\r\n        return {\r\n            adapter: 'netlify',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found netlify.toml',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'wrangler.toml'))) {\r\n        return {\r\n            adapter: 'cloudflare',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found wrangler.toml',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'fly.toml'))) {\r\n        return {\r\n            adapter: 'fly',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found fly.toml',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'Dockerfile'))) {\r\n        return {\r\n            adapter: 'docker',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found Dockerfile',\r\n        };\r\n    }\r\n\r\n    if (await exists(join(root, 'serverless.yml')) || await exists(join(root, 'serverless.yaml'))) {\r\n        return {\r\n            adapter: 'aws',\r\n            confidence: 'medium',\r\n            source: 'config file',\r\n            reasoning: 'Found serverless.yml',\r\n        };\r\n    }\r\n\r\n    // Check 3: Runtime detection\r\n    // @ts-expect-error - Bun global\r\n    if (typeof Bun !== 'undefined') {\r\n        return {\r\n            adapter: 'bun',\r\n            confidence: 'high',\r\n            source: 'runtime',\r\n            reasoning: 'Running in Bun runtime',\r\n        };\r\n    }\r\n\r\n    // @ts-expect-error - Deno global\r\n    if (typeof Deno !== 'undefined') {\r\n        return {\r\n            adapter: 'deno',\r\n            confidence: 'high',\r\n            source: 'runtime',\r\n            reasoning: 'Running in Deno runtime',\r\n        };\r\n    }\r\n\r\n    // Default: Node.js (always available)\r\n    return {\r\n        adapter: 'node',\r\n        confidence: 'low',\r\n        source: 'default',\r\n        reasoning: 'No specific deployment target detected. Defaulting to Node.js (works everywhere).',\r\n    };\r\n}\r\n","/**\r\n * Suggestion utilities for Flight Framework\r\n * \r\n * These functions SUGGEST configurations based on detected context.\r\n * They never apply anything automatically. You decide.\r\n */\r\n\r\nimport { detectFramework, detectDeploymentTarget } from '../detect/index.js';\r\nimport type { SuggestedDefaults } from '../types.js';\r\n\r\n/**\r\n * Suggest default configuration based on project analysis.\r\n * \r\n * This function ONLY suggests. It never applies, installs, or modifies anything.\r\n * You are free to use these suggestions, modify them, or ignore them entirely.\r\n * \r\n * @param root - Project root directory (defaults to current working directory)\r\n * @returns Suggested defaults with confidence levels\r\n * \r\n * @example\r\n * ```typescript\r\n * const suggestions = await suggestDefaults();\r\n * \r\n * // Use suggestions in your config (optional)\r\n * export default {\r\n *   ui: { framework: suggestions.framework ?? 'react' },\r\n * };\r\n * \r\n * // Or ignore them entirely\r\n * export default {\r\n *   ui: { framework: 'vue' },\r\n * };\r\n * ```\r\n */\r\nexport async function suggestDefaults(root: string = process.cwd()): Promise<SuggestedDefaults> {\r\n    // Detect context\r\n    const [frameworkResult, adapterResult] = await Promise.all([\r\n        detectFramework(root),\r\n        detectDeploymentTarget(root),\r\n    ]);\r\n\r\n    // Determine rendering mode based on framework\r\n    let rendering: 'ssr' | 'csr' | 'ssg' = 'ssr';\r\n\r\n    // HTMX and static sites are typically SSR/SSG\r\n    if (frameworkResult.framework === 'htmx') {\r\n        rendering = 'ssr';\r\n    }\r\n\r\n    // Qwik uses resumability, SSR is recommended\r\n    if (frameworkResult.framework === 'qwik') {\r\n        rendering = 'ssr';\r\n    }\r\n\r\n    // Static adapters should use SSG\r\n    if (adapterResult.adapter === 'static') {\r\n        rendering = 'ssg';\r\n    }\r\n\r\n    // Determine bundler\r\n    // Vite is the most universal choice\r\n    const bundler = 'vite' as const;\r\n\r\n    return {\r\n        framework: frameworkResult.framework,\r\n        adapter: adapterResult.adapter,\r\n        rendering,\r\n        bundler,\r\n        confidence: {\r\n            framework: frameworkResult.confidence,\r\n            adapter: adapterResult.confidence,\r\n        },\r\n    };\r\n}\r\n\r\n/**\r\n * Log suggestions to console in a helpful format.\r\n * Useful for CLI tools.\r\n * \r\n * @param suggestions - Suggested defaults from suggestDefaults()\r\n */\r\nexport function logSuggestions(suggestions: SuggestedDefaults): void {\r\n    console.log('\\n📋 Flight Suggestions (optional)\\n');\r\n\r\n    if (suggestions.framework) {\r\n        console.log(`  UI Framework: ${suggestions.framework} (${suggestions.confidence.framework} confidence)`);\r\n    } else {\r\n        console.log('  UI Framework: none detected (vanilla JS/HTML works fine)');\r\n    }\r\n\r\n    if (suggestions.adapter) {\r\n        console.log(`  Deployment:   ${suggestions.adapter} (${suggestions.confidence.adapter} confidence)`);\r\n    }\r\n\r\n    console.log(`  Rendering:    ${suggestions.rendering}`);\r\n    console.log(`  Bundler:      ${suggestions.bundler}`);\r\n\r\n    console.log('\\n💡 These are suggestions only. You can override any of these in flight.config.ts\\n');\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/types-0ONEhDBI.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared types for detection utilities
+ */
+type ConfidenceLevel = 'high' | 'medium' | 'low';
+type UIFramework = 'react' | 'vue' | 'svelte' | 'solid' | 'preact' | 'qwik' | 'lit' | 'htmx' | 'angular' | 'vanilla';
+type DeploymentAdapter = 'node' | 'vercel' | 'netlify' | 'cloudflare' | 'aws' | 'docker' | 'fly' | 'deno' | 'bun' | 'static';
+interface FrameworkDetection {
+    /** Detected framework, null if none found */
+    framework: UIFramework | null;
+    /** Confidence level of detection */
+    confidence: ConfidenceLevel;
+    /** Where the detection came from */
+    source: string;
+    /** Human-readable explanation */
+    reasoning: string;
+}
+interface DeploymentDetection {
+    /** Detected deployment target, null if none found */
+    adapter: DeploymentAdapter | null;
+    /** Confidence level of detection */
+    confidence: ConfidenceLevel;
+    /** Where the detection came from */
+    source: string;
+    /** Human-readable explanation */
+    reasoning: string;
+}
+interface SuggestedDefaults {
+    /** Suggested UI framework */
+    framework: UIFramework | null;
+    /** Suggested deployment adapter */
+    adapter: DeploymentAdapter | null;
+    /** Suggested rendering mode */
+    rendering: 'ssr' | 'csr' | 'ssg';
+    /** Suggested bundler */
+    bundler: 'vite' | 'esbuild' | 'rolldown';
+    /** Confidence levels for each suggestion */
+    confidence: {
+        framework: ConfidenceLevel;
+        adapter: ConfidenceLevel;
+    };
+}
+
+export type { ConfidenceLevel as C, DeploymentDetection as D, FrameworkDetection as F, SuggestedDefaults as S };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@flightdev/helpers",
+  "version": "0.1.0",
+  "description": "Optional helper utilities for Flight Framework. Suggestions, not impositions.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./detect": {
+      "types": "./dist/detect/index.d.ts",
+      "import": "./dist/detect/index.js"
+    },
+    "./suggest": {
+      "types": "./dist/suggest/index.d.ts",
+      "import": "./dist/suggest/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "flight",
+    "framework",
+    "helpers",
+    "utilities",
+    "detection"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {},
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}