@amplitude/wizard 1.0.0-beta.0

package/dist/src/frameworks/go/go-wizard-agent.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GO_AGENT_CONFIG = void 0;
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const utils_1 = require("./utils");
+exports.GO_AGENT_CONFIG = {
+    metadata: {
+        name: 'Go',
+        integration: constants_1.Integration.go,
+        beta: true,
+        docsUrl: 'https://amplitude.com/docs/sdks/analytics/go/go-sdk',
+    },
+    detection: {
+        packageName: 'github.com/amplitude/analytics-go',
+        packageDisplayName: 'Go',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        detect: utils_1.detectGoProject,
+        detectPackageManager: package_manager_detection_1.goPackageManager,
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, host) => ({
+            AMPLITUDE_API_KEY: apiKey,
+            AMPLITUDE_SERVER_URL: host,
+        }),
+    },
+    analytics: {
+        getTags: () => ({}),
+    },
+    prompts: {
+        projectTypeDetection: 'This is a Go project. Look for go.mod and go.sum to confirm.',
+        packageInstallation: 'Use Go modules: run `go get github.com/amplitude/analytics-go` to add the dependency (go.mod and go.sum are updated automatically).',
+        getAdditionalContextLines: () => [
+            'Framework docs ID: go (use amplitude://docs/frameworks/go for documentation)',
+            'SDK: github.com/amplitude/analytics-go',
+            'Initialization: config := amplitude.NewConfig(os.Getenv("AMPLITUDE_API_KEY")); client := amplitude.NewClient(config)',
+            'Always call client.Shutdown() on application exit to flush queued events',
+        ],
+    },
+    ui: {
+        successMessage: 'Amplitude integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: () => [
+            'Analyzed your Go project structure',
+            'Added github.com/amplitude/analytics-go to go.mod',
+            'Configured Amplitude client initialization',
+        ],
+        getOutroNextSteps: () => [
+            'Run your application to verify the integration',
+            'Visit your Amplitude dashboard to see incoming events',
+            'Use client.Track(amplitude.Event{...}) for custom events',
+            'Ensure client.Shutdown() is called on exit to flush queued events',
+        ],
+    },
+};

package/dist/src/frameworks/go/utils.d.ts

@@ -0,0 +1,5 @@
+import type { WizardOptions } from '../../utils/types';
+/**
+ * Returns true when the directory contains a Go module project (go.mod present).
+ */
+export declare function detectGoProject(options: Pick<WizardOptions, 'installDir'>): Promise<boolean>;

package/dist/src/frameworks/go/utils.js

@@ -0,0 +1,44 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectGoProject = detectGoProject;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * Returns true when the directory contains a Go module project (go.mod present).
+ */
+function detectGoProject(options) {
+    return Promise.resolve(fs.existsSync(path.join(options.installDir, 'go.mod')));
+}

package/dist/src/frameworks/java/java-wizard-agent.d.ts

@@ -0,0 +1,7 @@
+import type { FrameworkConfig } from '../../lib/framework-config';
+import type { JavaBuildTool } from './utils';
+type JavaContext = {
+    buildTool?: JavaBuildTool;
+};
+export declare const JAVA_AGENT_CONFIG: FrameworkConfig<JavaContext>;
+export {};

package/dist/src/frameworks/java/java-wizard-agent.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JAVA_AGENT_CONFIG = void 0;
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const utils_1 = require("./utils");
+exports.JAVA_AGENT_CONFIG = {
+    metadata: {
+        name: 'Java',
+        integration: constants_1.Integration.java,
+        beta: true,
+        docsUrl: 'https://amplitude.com/docs/sdks/analytics/java/jre-java-sdk',
+        gatherContext: (options) => {
+            const buildTool = (0, utils_1.detectJavaBuildTool)(options);
+            return Promise.resolve({ buildTool });
+        },
+    },
+    detection: {
+        packageName: 'com.amplitude:java-sdk',
+        packageDisplayName: 'Java',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        detect: utils_1.detectJavaProject,
+        detectPackageManager: package_manager_detection_1.detectJavaPackageManagers,
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, host) => ({
+            AMPLITUDE_API_KEY: apiKey,
+            AMPLITUDE_SERVER_URL: host,
+        }),
+    },
+    analytics: {
+        getTags: (context) => ({
+            buildTool: context.buildTool ?? 'unknown',
+        }),
+    },
+    prompts: {
+        projectTypeDetection: 'This is a Java JRE project. Look for pom.xml (Maven), build.gradle / build.gradle.kts (Gradle), or src/main/java to confirm.',
+        getAdditionalContextLines: (context) => {
+            const buildTool = context.buildTool ?? 'maven';
+            const depSnippet = buildTool === 'maven'
+                ? `<dependency><groupId>com.amplitude</groupId><artifactId>java-sdk</artifactId><version>1.13.0</version></dependency>`
+                : `implementation 'com.amplitude:java-sdk:1.13.0'`;
+            return [
+                `Build tool: ${buildTool === 'maven' ? 'Maven' : 'Gradle'}`,
+                `Framework docs ID: java (use amplitude://docs/frameworks/java for documentation)`,
+                `SDK: com.amplitude:java-sdk — add to ${buildTool === 'maven' ? 'pom.xml' : 'build.gradle'}: ${depSnippet}`,
+                `Also add org.json:json:20231013 as a runtime dependency`,
+                `Initialization: Amplitude client = Amplitude.getInstance(); client.init(System.getenv("AMPLITUDE_API_KEY"));`,
+                `Always call client.shutdown() on application exit to flush queued events`,
+            ];
+        },
+    },
+    ui: {
+        successMessage: 'Amplitude integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: (context) => {
+            const tool = context.buildTool === 'gradle' ? 'Gradle' : 'Maven';
+            return [
+                `Analyzed your Java project structure`,
+                `Added com.amplitude:java-sdk to ${tool} build file`,
+                `Configured Amplitude client initialization`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Build and run your application to verify the integration',
+            'Visit your Amplitude dashboard to see incoming events',
+            'Use client.logEvent(new Event("Event Name", userId)) for custom events',
+            'Ensure client.shutdown() is called on exit to flush queued events',
+        ],
+    },
+};

package/dist/src/frameworks/java/utils.d.ts

@@ -0,0 +1,15 @@
+import type { WizardOptions } from '../../utils/types';
+export type JavaBuildTool = 'maven' | 'gradle';
+/**
+ * Returns true when the directory contains a JVM Java project.
+ * Signals: pom.xml (Maven), build.gradle / build.gradle.kts (Gradle),
+ * or a src/main/java directory (standard Maven/Gradle layout).
+ *
+ * Note: Android projects also use build.gradle, but they are detected
+ * earlier in the registry and will never reach this detector.
+ */
+export declare function detectJavaProject(options: Pick<WizardOptions, 'installDir'>): Promise<boolean>;
+/**
+ * Returns the detected build tool for the Java project.
+ */
+export declare function detectJavaBuildTool(options: Pick<WizardOptions, 'installDir'>): JavaBuildTool;

package/dist/src/frameworks/java/utils.js

@@ -0,0 +1,64 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectJavaProject = detectJavaProject;
+exports.detectJavaBuildTool = detectJavaBuildTool;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * Returns true when the directory contains a JVM Java project.
+ * Signals: pom.xml (Maven), build.gradle / build.gradle.kts (Gradle),
+ * or a src/main/java directory (standard Maven/Gradle layout).
+ *
+ * Note: Android projects also use build.gradle, but they are detected
+ * earlier in the registry and will never reach this detector.
+ */
+function detectJavaProject(options) {
+    const { installDir } = options;
+    const hasPom = fs.existsSync(path.join(installDir, 'pom.xml'));
+    const hasGradle = fs.existsSync(path.join(installDir, 'build.gradle')) ||
+        fs.existsSync(path.join(installDir, 'build.gradle.kts'));
+    const hasSrcMainJava = fs.existsSync(path.join(installDir, 'src', 'main', 'java'));
+    return Promise.resolve(hasPom || hasGradle || hasSrcMainJava);
+}
+/**
+ * Returns the detected build tool for the Java project.
+ */
+function detectJavaBuildTool(options) {
+    const { installDir } = options;
+    if (fs.existsSync(path.join(installDir, 'pom.xml')))
+        return 'maven';
+    return 'gradle';
+}

package/dist/src/frameworks/javascript-node/javascript-node-wizard-agent.d.ts

@@ -0,0 +1,4 @@
+import type { FrameworkConfig } from '../../lib/framework-config';
+type JavaScriptNodeContext = Record<string, unknown>;
+export declare const JAVASCRIPT_NODE_AGENT_CONFIG: FrameworkConfig<JavaScriptNodeContext>;
+export {};

package/dist/src/frameworks/javascript-node/javascript-node-wizard-agent.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JAVASCRIPT_NODE_AGENT_CONFIG = void 0;
+const constants_1 = require("../../lib/constants");
+const setup_utils_1 = require("../../utils/setup-utils");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+exports.JAVASCRIPT_NODE_AGENT_CONFIG = {
+    metadata: {
+        name: 'Node.js',
+        integration: constants_1.Integration.javascriptNode,
+        beta: true,
+        docsUrl: 'https://amplitude.com/docs/sdks/analytics/browser/browser-sdk-2',
+    },
+    detection: {
+        packageName: '@amplitude/analytics-node',
+        packageDisplayName: 'Node.js',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        detectPackageManager: package_manager_detection_1.detectNodePackageManagers,
+        detect: async (options) => {
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return !!packageJson;
+        },
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, _host) => ({
+            AMPLITUDE_API_KEY: apiKey,
+        }),
+    },
+    analytics: {
+        getTags: () => ({}),
+    },
+    prompts: {
+        projectTypeDetection: 'This is a server-side Node.js project. Look for package.json and lockfiles to confirm.',
+        packageInstallation: 'Use npm, yarn, pnpm, or bun based on the existing lockfile (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb). Install @amplitude/analytics-node as a regular dependency.',
+        getAdditionalContextLines: () => [
+            `Framework docs ID: javascript_node (use amplitude://docs/frameworks/javascript_node for documentation)`,
+        ],
+    },
+    ui: {
+        successMessage: 'Amplitude integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: () => [
+            `Analyzed your Node.js project structure`,
+            `Installed the @amplitude/analytics-node package`,
+            `Created Amplitude initialization with proper configuration`,
+            `Added example code for events and user identification`,
+        ],
+        getOutroNextSteps: () => [
+            'Use the Amplitude client instance for all tracking calls',
+            'NEVER send PII in event properties (no emails, names, or user content)',
+            'Use amplitude.track() for events and amplitude.identify() for users',
+            'Visit your Amplitude dashboard to see incoming events',
+        ],
+    },
+};

package/dist/src/frameworks/javascript-web/javascript-web-wizard-agent.d.ts

@@ -0,0 +1,3 @@
+import type { FrameworkConfig } from '../../lib/framework-config';
+import { type JavaScriptContext } from './utils';
+export declare const JAVASCRIPT_WEB_AGENT_CONFIG: FrameworkConfig<JavaScriptContext>;

package/dist/src/frameworks/javascript-web/javascript-web-wizard-agent.js

@@ -0,0 +1,151 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JAVASCRIPT_WEB_AGENT_CONFIG = void 0;
+const constants_1 = require("../../lib/constants");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const package_json_1 = require("../../utils/package-json");
+const setup_utils_1 = require("../../utils/setup-utils");
+const utils_1 = require("./utils");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+exports.JAVASCRIPT_WEB_AGENT_CONFIG = {
+    metadata: {
+        name: 'JavaScript (Web)',
+        integration: constants_1.Integration.javascript_web,
+        beta: true,
+        docsUrl: 'https://amplitude.com/docs/sdks/analytics/browser/browser-sdk-2',
+        gatherContext: (options) => {
+            const packageManagerName = (0, utils_1.detectJsPackageManager)(options);
+            const hasTypeScript = fs.existsSync(path.join(options.installDir, 'tsconfig.json'));
+            const hasBundler = (0, utils_1.detectBundler)(options);
+            return Promise.resolve({ packageManagerName, hasTypeScript, hasBundler });
+        },
+    },
+    detection: {
+        packageName: '@amplitude/analytics-browser',
+        packageDisplayName: 'JavaScript (Web)',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        detectPackageManager: package_manager_detection_1.detectNodePackageManagers,
+        detect: async (options) => {
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            if (!packageJson) {
+                return false;
+            }
+            // Exclude projects with known framework packages
+            for (const frameworkPkg of utils_1.FRAMEWORK_PACKAGES) {
+                if ((0, package_json_1.hasPackageInstalled)(frameworkPkg, packageJson)) {
+                    return false;
+                }
+            }
+            const { installDir } = options;
+            // Has (index.html OR has a bundler) AND is a JavaScript project
+            const hasIndexHtmlFlag = (0, utils_1.hasIndexHtml)(options);
+            const bundler = (0, utils_1.detectBundler)(options);
+            const hasBundler = !!bundler;
+            const hasLockfile = [
+                'package-lock.json',
+                'yarn.lock',
+                'pnpm-lock.yaml',
+                'bun.lockb',
+                'bun.lock',
+                'deno.lock',
+            ].some((lockfile) => fs.existsSync(path.join(installDir, lockfile)));
+            // We only treat this as JS Web if there's BOTH:
+            // - a lockfile, and
+            // - at least one frontend signal (index.html or bundler)
+            if (hasLockfile && (hasIndexHtmlFlag || hasBundler)) {
+                return true;
+            }
+            // Otherwise → Node/Backend (handled by javascriptNode fallback)
+            return false;
+        },
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, _host) => ({
+            AMPLITUDE_API_KEY: apiKey,
+        }),
+    },
+    analytics: {
+        getTags: (context) => {
+            const tags = {
+                packageManager: context.packageManagerName ?? 'unknown',
+            };
+            if (context.hasBundler) {
+                tags.bundler = context.hasBundler;
+            }
+            return tags;
+        },
+    },
+    prompts: {
+        projectTypeDetection: 'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',
+        packageInstallation: 'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',
+        getAdditionalContextLines: (context) => {
+            const lines = [
+                `Package manager: ${context.packageManagerName ?? 'unknown'}`,
+                `Has TypeScript: ${context.hasTypeScript ? 'yes' : 'no'}`,
+                `Framework docs ID: js (use amplitude://docs/frameworks/js for documentation if available)`,
+                `Project type: Generic JavaScript/TypeScript application (no specific framework detected)`,
+                `Preferred Amplitude SDK: @amplitude/unified (prefer over @amplitude/analytics-browser for new browser integrations)`,
+            ];
+            if (context.hasBundler) {
+                lines.unshift(`Bundler: ${context.hasBundler}`);
+            }
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'Amplitude integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: (context) => {
+            const packageManagerName = context.packageManagerName ?? 'package manager';
+            return [
+                `Analyzed your JavaScript project structure`,
+                `Installed the @amplitude/unified package using ${packageManagerName}`,
+                `Created Amplitude initialization code`,
+                `Configured autocapture and event tracking`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Ensure amplitude.init() is called before any track calls',
+            'Autocapture tracks clicks, form submissions, and pageviews automatically',
+            'Use amplitude.track() for custom events and amplitude.setUserId() for users',
+            'NEVER send PII in event properties (no emails, names, or user content)',
+            'Visit your Amplitude dashboard to see incoming events',
+        ],
+    },
+};

package/dist/src/frameworks/javascript-web/utils.d.ts

@@ -0,0 +1,28 @@
+import type { WizardOptions } from '../../utils/types';
+export type JavaScriptContext = {
+    packageManagerName?: string;
+    hasTypeScript?: boolean;
+    hasBundler?: string;
+};
+/**
+ * Packages that indicate a specific framework integration exists.
+ * If any of these are in package.json, we should NOT match as generic JavaScript.
+ *
+ * When adding a new JS framework integration to the wizard,
+ * add its detection package here too.
+ */
+export declare const FRAMEWORK_PACKAGES: readonly ["next", "nuxt", "vue", "react-router", "@tanstack/react-start", "@tanstack/react-router", "react-native", "@angular/core", "astro", "@sveltejs/kit"];
+/**
+ * Detect the JS package manager for the project by checking lockfiles.
+ * Reuses the existing package manager detection infrastructure.
+ */
+export declare function detectJsPackageManager(options: Pick<WizardOptions, 'installDir'>): string;
+/**
+ * Detect the bundler used in the project by checking package.json dependencies.
+ */
+export declare function detectBundler(options: Pick<WizardOptions, 'installDir'>): string | undefined;
+/**
+ * Heuristic: check if there is an index.html anywhere in the project,
+ * ignoring common build and dependency directories.
+ */
+export declare function hasIndexHtml(options: Pick<WizardOptions, 'installDir'>): boolean;

package/dist/src/frameworks/javascript-web/utils.js

@@ -0,0 +1,153 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FRAMEWORK_PACKAGES = void 0;
+exports.detectJsPackageManager = detectJsPackageManager;
+exports.detectBundler = detectBundler;
+exports.hasIndexHtml = hasIndexHtml;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const zod_1 = require("zod");
+const package_manager_1 = require("../../utils/package-manager");
+const INDEX_HTML_MAX_DEPTH = 6;
+const INDEX_HTML_IGNORE_DIRS = new Set([
+    'node_modules',
+    '.git',
+    '.next',
+    'dist',
+    'build',
+    '.turbo',
+    '.cache',
+]);
+/**
+ * Packages that indicate a specific framework integration exists.
+ * If any of these are in package.json, we should NOT match as generic JavaScript.
+ *
+ * When adding a new JS framework integration to the wizard,
+ * add its detection package here too.
+ */
+exports.FRAMEWORK_PACKAGES = [
+    'next',
+    'nuxt',
+    'vue',
+    'react-router',
+    '@tanstack/react-start',
+    '@tanstack/react-router',
+    'react-native',
+    '@angular/core',
+    'astro',
+    '@sveltejs/kit',
+];
+/**
+ * Detect the JS package manager for the project by checking lockfiles.
+ * Reuses the existing package manager detection infrastructure.
+ */
+function detectJsPackageManager(options) {
+    const detected = (0, package_manager_1.detectAllPackageManagers)(options);
+    if (detected.length > 0) {
+        return detected[0].label;
+    }
+    return 'unknown';
+}
+/**
+ * Detect the bundler used in the project by checking package.json dependencies.
+ */
+function detectBundler(options) {
+    try {
+        const content = fs.readFileSync(path.join(options.installDir, 'package.json'), 'utf-8');
+        const pkg = zod_1.z
+            .object({
+            dependencies: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+            devDependencies: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+        })
+            .passthrough()
+            .parse(JSON.parse(content));
+        const allDeps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        if (allDeps['vite'])
+            return 'vite';
+        if (allDeps['webpack'])
+            return 'webpack';
+        if (allDeps['esbuild'])
+            return 'esbuild';
+        if (allDeps['parcel'])
+            return 'parcel';
+        if (allDeps['rollup'])
+            return 'rollup';
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Heuristic: check if there is an index.html anywhere in the project,
+ * ignoring common build and dependency directories.
+ */
+function hasIndexHtml(options) {
+    const root = options.installDir;
+    function search(dir, depth) {
+        if (depth > INDEX_HTML_MAX_DEPTH) {
+            return false;
+        }
+        const base = path.basename(dir);
+        if (INDEX_HTML_IGNORE_DIRS.has(base)) {
+            return false;
+        }
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return false;
+        }
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.toLowerCase() === 'index.html') {
+                return true;
+            }
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (search(path.join(dir, entry.name), depth + 1)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    return search(root, 0);
+}