@nexus-framework/cli 0.1.1

package/dist/generators/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../src/generators/structure.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE/E;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB,EAAE,CAmE7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAwCtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAqCjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CA0CjE"}

package/dist/generators/structure.js

@@ -0,0 +1,174 @@
+/**
+ * NEXUS CLI - Structure Generator
+ *
+ * Generates the folder structure and base files for a new project.
+ */
+/**
+ * Generate the base directory structure for any project type.
+ */
+export function generateDirectories(config) {
+    const dirs = [
+        { path: 'src' },
+        { path: 'public' },
+        { path: '.nexus' },
+        { path: '.nexus/docs' },
+        { path: '.nexus/ai' },
+    ];
+    // Test directories
+    if (config.testFramework !== 'none') {
+        dirs.push({ path: 'tests' }, { path: 'tests/unit' }, { path: 'tests/integration' }, { path: 'tests/e2e' }, { path: 'tests/utils' });
+    }
+    // CI/CD
+    dirs.push({ path: '.github' }, { path: '.github/workflows' });
+    // Framework-specific
+    switch (config.frontendFramework) {
+        case 'nextjs':
+            dirs.push({ path: 'src/app' }, { path: 'src/components' }, { path: 'src/lib' });
+            break;
+        case 'react-vite':
+            dirs.push({ path: 'src/components' }, { path: 'src/pages' }, { path: 'src/hooks' }, { path: 'src/lib' });
+            break;
+        case 'sveltekit':
+            dirs.push({ path: 'src/routes' }, { path: 'src/lib' }, { path: 'src/lib/components' }, { path: 'src/styles' });
+            break;
+        case 'nuxt':
+            dirs.push({ path: 'src/lib' }, { path: 'src/components' }, { path: 'pages' }, { path: 'assets' }, { path: 'assets/css' });
+            break;
+        case 'astro':
+            dirs.push({ path: 'src/pages' }, { path: 'src/layouts' }, { path: 'src/components' }, { path: 'src/styles' });
+            break;
+        default:
+            dirs.push({ path: 'src/lib' }, { path: 'src/components' });
+            break;
+    }
+    return dirs;
+}
+/**
+ * Generate the project's package.json content.
+ */
+export function generatePackageJson(config) {
+    const pkg = {
+        name: config.projectName,
+        version: '0.1.0',
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: 'echo "TODO: configure dev script"',
+            build: 'echo "TODO: configure build script"',
+            start: 'echo "TODO: configure start script"',
+            lint: 'eslint . --ext .ts,.tsx',
+            format: 'prettier --write .',
+            'type-check': 'tsc --noEmit',
+        },
+        dependencies: {},
+        devDependencies: {
+            typescript: '^5.7.0',
+            '@types/node': '^22.0.0',
+            eslint: '^8.57.0',
+            prettier: '^3.4.0',
+        },
+    };
+    // Add test scripts
+    if (config.testFramework === 'vitest') {
+        pkg.scripts.test = 'vitest run';
+        pkg.scripts['test:watch'] = 'vitest';
+        pkg.scripts['test:coverage'] = 'vitest run --coverage';
+        pkg.devDependencies.vitest = '^3.0.0';
+    }
+    else if (config.testFramework === 'jest') {
+        pkg.scripts.test = 'jest';
+        pkg.devDependencies.jest = '^29.0.0';
+        pkg.devDependencies['ts-jest'] = '^29.0.0';
+        pkg.devDependencies['@types/jest'] = '^29.0.0';
+    }
+    return {
+        path: 'package.json',
+        content: JSON.stringify(pkg, null, 2) + '\n',
+    };
+}
+/**
+ * Generate .gitignore file.
+ */
+export function generateGitignore() {
+    const content = `# Dependencies
+node_modules/
+
+# Build output
+dist/
+.next/
+.svelte-kit/
+.nuxt/
+.output/
+build/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/settings.json
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Coverage
+coverage/
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+`;
+    return { path: '.gitignore', content };
+}
+/**
+ * Generate a basic README for the created project.
+ */
+export function generateReadme(config) {
+    const content = `# ${config.projectName}
+
+> Generated with [NEXUS CLI](https://github.com/GDA-Africa/nexus-cli) 🔮
+
+## Getting Started
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+## Documentation
+
+This project uses the **NEXUS Documentation System** — 8 structured markdown files designed for both humans and AI coding tools.
+
+| Doc | Purpose |
+|-----|---------|
+| \`.nexus/docs/01_vision.md\` | Product requirements & user stories |
+| \`.nexus/docs/02_architecture.md\` | System design & tech stack |
+| \`.nexus/docs/03_data_contracts.md\` | Database schemas & validation |
+| \`.nexus/docs/04_api_contracts.md\` | Endpoints & interfaces |
+| \`.nexus/docs/05_business_logic.md\` | Rules, algorithms & flows |
+| \`.nexus/docs/06_test_strategy.md\` | Testing philosophy & coverage |
+| \`.nexus/docs/07_implementation.md\` | Build order & file structure |
+| \`.nexus/docs/08_deployment.md\` | Infrastructure & CI/CD |
+
+**Start here:** Open \`.nexus/docs/01_vision.md\` and describe what you're building.
+
+## Project Info
+
+- **Type:** ${config.projectType}
+- **Framework:** ${config.frontendFramework}
+- **Data Strategy:** ${config.dataStrategy}
+- **Testing:** ${config.testFramework}
+
+---
+
+*Built with ❤️ using NEXUS CLI by [GDA Africa](https://github.com/GDA-Africa)*
+`;
+    return { path: 'README.md', content };
+}
+//# sourceMappingURL=structure.js.map

package/dist/generators/structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../src/generators/structure.ts"],"names":[],"mappings":"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"}

package/dist/generators/tests.d.ts

@@ -0,0 +1,12 @@
+/**
+ * NEXUS CLI - Test Generator
+ *
+ * Generates test infrastructure for the new project.
+ */
+import type { NexusConfig } from '../types/config.js';
+import type { GeneratedFile } from '../types/templates.js';
+/**
+ * Generate test configuration and example tests.
+ */
+export declare function generateTests(config: NexusConfig): GeneratedFile[];
+//# sourceMappingURL=tests.d.ts.map

package/dist/generators/tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests.d.ts","sourceRoot":"","sources":["../../src/generators/tests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,EAAE,CAalE"}

package/dist/generators/tests.js

@@ -0,0 +1,97 @@
+/**
+ * NEXUS CLI - Test Generator
+ *
+ * Generates test infrastructure for the new project.
+ */
+/**
+ * Generate test configuration and example tests.
+ */
+export function generateTests(config) {
+    if (config.testFramework === 'none')
+        return [];
+    const files = [];
+    if (config.testFramework === 'vitest') {
+        files.push(generateVitestConfig());
+        files.push(generateExampleVitestTest(config));
+        files.push(generateTestSetup());
+        files.push(generateTestHelpers());
+    }
+    return files;
+}
+function generateVitestConfig() {
+    return {
+        path: 'vitest.config.ts',
+        content: `import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['tests/**/*.test.ts'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'lcov'],
+      include: ['src/**/*.ts'],
+    },
+  },
+});
+`,
+    };
+}
+function generateExampleVitestTest(config) {
+    return {
+        path: 'tests/unit/example.test.ts',
+        content: `import { describe, it, expect } from 'vitest';
+
+describe('${config.projectName}', () => {
+  it('should pass a basic sanity check', () => {
+    expect(true).toBe(true);
+  });
+
+  it('should perform basic arithmetic', () => {
+    expect(1 + 1).toBe(2);
+  });
+});
+`,
+    };
+}
+function generateTestSetup() {
+    return {
+        path: 'tests/setup.ts',
+        content: `/**
+ * Global test setup
+ *
+ * This file runs before all tests. Add global mocks, polyfills, or setup here.
+ */
+
+// Example: extend expect with custom matchers
+// import '@testing-library/jest-dom';
+`,
+    };
+}
+function generateTestHelpers() {
+    return {
+        path: 'tests/utils/test-helpers.ts',
+        content: `/**
+ * Shared test utilities and helpers.
+ *
+ * Add reusable test factories, mock builders, and assertion helpers here.
+ */
+
+/**
+ * Create a delay (useful for async testing).
+ */
+export function delay(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * Generate a random string for test data.
+ */
+export function randomString(length = 8): string {
+  return Math.random().toString(36).substring(2, 2 + length);
+}
+`,
+    };
+}
+//# sourceMappingURL=tests.js.map

package/dist/generators/tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests.js","sourceRoot":"","sources":["../../src/generators/tests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAmB;IAC/C,IAAI,MAAM,CAAC,aAAa,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,KAAK,GAAoB,EAAE,CAAC;IAElC,IAAI,MAAM,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE;;;;;;;;;;;;;;CAcZ;KACE,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAmB;IACpD,OAAO;QACL,IAAI,EAAE,4BAA4B;QAClC,OAAO,EAAE;;YAED,MAAM,CAAC,WAAW;;;;;;;;;CAS7B;KACE,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE;;;;;;;;CAQZ;KACE,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO;QACL,IAAI,EAAE,6BAA6B;QACnC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;CAmBZ;KACE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * NEXUS CLI - Main Export
+ *
+ * Public API for programmatic usage of NEXUS CLI.
+ */
+export { adoptCommand } from './commands/adopt.js';
+export { initCommand } from './commands/init.js';
+export { runPrompts } from './prompts/index.js';
+export { generateProject, adoptProject } from './generators/index.js';
+export { version } from './version.js';
+export type { NexusConfig, NexusManifest, PartialNexusConfig, } from './types/config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,YAAY,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * NEXUS CLI - Main Export
+ *
+ * Public API for programmatic usage of NEXUS CLI.
+ */
+export { adoptCommand } from './commands/adopt.js';
+export { initCommand } from './commands/init.js';
+export { runPrompts } from './prompts/index.js';
+export { generateProject, adoptProject } from './generators/index.js';
+export { version } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/prompts/data-strategy.d.ts

@@ -0,0 +1,8 @@
+/**
+ * NEXUS CLI - Data Strategy Prompt
+ *
+ * Asks the user about their data handling approach.
+ */
+import type { DataStrategy } from '../types/config.js';
+export declare function promptDataStrategy(): Promise<DataStrategy>;
+//# sourceMappingURL=data-strategy.d.ts.map

package/dist/prompts/data-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-strategy.d.ts","sourceRoot":"","sources":["../../src/prompts/data-strategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CA0BhE"}

package/dist/prompts/data-strategy.js

@@ -0,0 +1,34 @@
+/**
+ * NEXUS CLI - Data Strategy Prompt
+ *
+ * Asks the user about their data handling approach.
+ */
+import { select } from '@inquirer/prompts';
+export async function promptDataStrategy() {
+    return select({
+        message: 'How will your app handle data?',
+        choices: [
+            {
+                value: 'cloud-first',
+                name: '☁️  Cloud First',
+                description: 'Data lives on the server. Classic SaaS pattern — simple and proven.',
+            },
+            {
+                value: 'local-first',
+                name: '💾 Local First',
+                description: 'Data lives on device, syncs to cloud. Offline-capable, fast UX.',
+            },
+            {
+                value: 'local-only',
+                name: '📱 Local Only',
+                description: 'All data stays on the device. No server needed. Privacy-first.',
+            },
+            {
+                value: 'hybrid',
+                name: '🔄 Hybrid',
+                description: 'Mix of local and cloud. Some data cached, some server-only.',
+            },
+        ],
+    });
+}
+//# sourceMappingURL=data-strategy.js.map

package/dist/prompts/data-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-strategy.js","sourceRoot":"","sources":["../../src/prompts/data-strategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,OAAO,MAAM,CAAe;QAC1B,OAAO,EAAE,gCAAgC;QACzC,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,aAAa;gBACpB,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,qEAAqE;aACnF;YACD;gBACE,KAAK,EAAE,aAAa;gBACpB,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,iEAAiE;aAC/E;YACD;gBACE,KAAK,EAAE,YAAY;gBACnB,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,gEAAgE;aAC9E;YACD;gBACE,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,6DAA6D;aAC3E;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/prompts/features.d.ts

@@ -0,0 +1,14 @@
+/**
+ * NEXUS CLI - Features / Extras Prompt
+ *
+ * Asks about testing, package manager, git, and dependency installation.
+ */
+import type { TestFramework, PackageManager } from '../types/config.js';
+export interface FeaturesResult {
+    testFramework: TestFramework;
+    packageManager: PackageManager;
+    git: boolean;
+    installDeps: boolean;
+}
+export declare function promptFeatures(): Promise<FeaturesResult>;
+//# sourceMappingURL=features.d.ts.map

package/dist/prompts/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/prompts/features.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,GAAG,EAAE,OAAO,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,CA0C9D"}

package/dist/prompts/features.js

@@ -0,0 +1,46 @@
+/**
+ * NEXUS CLI - Features / Extras Prompt
+ *
+ * Asks about testing, package manager, git, and dependency installation.
+ */
+import { select, confirm } from '@inquirer/prompts';
+export async function promptFeatures() {
+    const testFramework = await select({
+        message: 'Testing framework?',
+        choices: [
+            {
+                value: 'vitest',
+                name: '⚡ Vitest',
+                description: 'Fast, Vite-native. Recommended for modern projects.',
+            },
+            {
+                value: 'jest',
+                name: '🃏 Jest',
+                description: 'Battle-tested. Largest ecosystem.',
+            },
+            {
+                value: 'none',
+                name: '⏭️  Skip for now',
+                description: 'No test framework (you can add one later).',
+            },
+        ],
+    });
+    const packageManager = await select({
+        message: 'Package manager?',
+        choices: [
+            { value: 'npm', name: '📦 npm' },
+            { value: 'yarn', name: '🧶 yarn' },
+            { value: 'pnpm', name: '⚡ pnpm' },
+        ],
+    });
+    const git = await confirm({
+        message: 'Initialize a git repository?',
+        default: true,
+    });
+    const installDeps = await confirm({
+        message: 'Install dependencies now?',
+        default: true,
+    });
+    return { testFramework, packageManager, git, installDeps };
+}
+//# sourceMappingURL=features.js.map

package/dist/prompts/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../src/prompts/features.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAWpD,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,aAAa,GAAG,MAAM,MAAM,CAAgB;QAChD,OAAO,EAAE,oBAAoB;QAC7B,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,qDAAqD;aACnE;YACD;gBACE,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,mCAAmC;aACjD;YACD;gBACE,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EAAE,4CAA4C;aAC1D;SACF;KACF,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,MAAM,MAAM,CAAiB;QAClD,OAAO,EAAE,kBAAkB;QAC3B,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;SAClC;KACF,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACxB,OAAO,EAAE,8BAA8B;QACvC,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC;QAChC,OAAO,EAAE,2BAA2B;QACpC,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;AAC7D,CAAC"}

package/dist/prompts/frameworks.d.ts

@@ -0,0 +1,9 @@
+/**
+ * NEXUS CLI - Framework Prompt
+ *
+ * Asks the user which frontend framework to use.
+ * Options are filtered based on project type.
+ */
+import type { FrontendFramework, ProjectType } from '../types/config.js';
+export declare function promptFramework(projectType: ProjectType): Promise<FrontendFramework>;
+//# sourceMappingURL=frameworks.d.ts.map

package/dist/prompts/frameworks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks.d.ts","sourceRoot":"","sources":["../../src/prompts/frameworks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE1E,wBAAsB,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoC1F"}

package/dist/prompts/frameworks.js

@@ -0,0 +1,44 @@
+/**
+ * NEXUS CLI - Framework Prompt
+ *
+ * Asks the user which frontend framework to use.
+ * Options are filtered based on project type.
+ */
+import { select } from '@inquirer/prompts';
+export async function promptFramework(projectType) {
+    if (projectType === 'api') {
+        // API projects don't need a frontend framework — we return a sentinel
+        return 'nextjs'; // will be ignored; backend prompt handles this
+    }
+    return select({
+        message: 'Which frontend framework?',
+        choices: [
+            {
+                value: 'nextjs',
+                name: '▲ Next.js 15 (App Router)',
+                description: 'React meta-framework with SSR, Server Actions, and API routes built in.',
+            },
+            {
+                value: 'react-vite',
+                name: '⚡ React + Vite',
+                description: 'Lightweight SPA. Lightning-fast dev server. Pair with a separate API.',
+            },
+            {
+                value: 'sveltekit',
+                name: '🔥 SvelteKit',
+                description: 'Svelte meta-framework with SSR, filesystem routing, and adapters.',
+            },
+            {
+                value: 'nuxt',
+                name: '💚 Nuxt 3',
+                description: 'Vue 3 meta-framework with auto-imports and Nitro server engine.',
+            },
+            {
+                value: 'astro',
+                name: '🚀 Astro',
+                description: 'Content-focused framework. Ships zero JS by default. Island architecture.',
+            },
+        ],
+    });
+}
+//# sourceMappingURL=frameworks.js.map

package/dist/prompts/frameworks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks.js","sourceRoot":"","sources":["../../src/prompts/frameworks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAwB;IAC5D,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;QAC1B,sEAAsE;QACtE,OAAO,QAAQ,CAAC,CAAC,+CAA+C;IAClE,CAAC;IAED,OAAO,MAAM,CAAoB;QAC/B,OAAO,EAAE,2BAA2B;QACpC,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,2BAA2B;gBACjC,WAAW,EAAE,yEAAyE;aACvF;YACD;gBACE,KAAK,EAAE,YAAY;gBACnB,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,uEAAuE;aACrF;YACD;gBACE,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,mEAAmE;aACjF;YACD;gBACE,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,iEAAiE;aAC/E;YACD;gBACE,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,2EAA2E;aACzF;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * NEXUS CLI - Prompt Orchestrator
+ *
+ * Runs all prompts in order and assembles the final NexusConfig.
+ */
+import type { NexusConfig } from '../types/config.js';
+/**
+ * Run the full interactive prompt flow and return a complete NexusConfig.
+ *
+ * @param initialName - Optional project name passed via CLI argument
+ */
+export declare function runPrompts(initialName?: string): Promise<NexusConfig>;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAUtD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAsD3E"}

package/dist/prompts/index.js

@@ -0,0 +1,67 @@
+/**
+ * NEXUS CLI - Prompt Orchestrator
+ *
+ * Runs all prompts in order and assembles the final NexusConfig.
+ */
+import { input } from '@inquirer/prompts';
+import { detectPackageManager } from '../utils/package-manager.js';
+import { validateProjectName, sanitizeProjectName } from '../utils/validator.js';
+import { promptDataStrategy } from './data-strategy.js';
+import { promptFeatures } from './features.js';
+import { promptFramework } from './frameworks.js';
+import { promptPatterns } from './patterns.js';
+import { promptProjectType } from './project-type.js';
+/**
+ * Run the full interactive prompt flow and return a complete NexusConfig.
+ *
+ * @param initialName - Optional project name passed via CLI argument
+ */
+export async function runPrompts(initialName) {
+    // 1. Project name
+    let projectName;
+    if (!initialName) {
+        projectName = await input({
+            message: 'Project name:',
+            default: 'my-nexus-app',
+            validate: (val) => {
+                const result = validateProjectName(val);
+                return result.valid ? true : (result.message ?? 'Invalid name');
+            },
+        });
+    }
+    else {
+        // Validate the provided name
+        const validation = validateProjectName(initialName);
+        if (!validation.valid) {
+            throw new Error(validation.message ?? 'Invalid project name.');
+        }
+        projectName = initialName;
+    }
+    projectName = sanitizeProjectName(projectName);
+    // 2. Project type
+    const projectType = await promptProjectType();
+    // 3. Data strategy
+    const dataStrategy = await promptDataStrategy();
+    // 4. Application patterns
+    const appPatterns = await promptPatterns();
+    // 5. Framework
+    const frontendFramework = await promptFramework(projectType);
+    // 6. Features & extras
+    const { testFramework, packageManager, git, installDeps } = await promptFeatures();
+    // Assemble config
+    const config = {
+        projectName,
+        projectType,
+        dataStrategy,
+        appPatterns,
+        frontendFramework,
+        backendStrategy: projectType === 'api' ? 'separate' : 'integrated',
+        backendFramework: projectType === 'api' ? 'express' : 'none',
+        testFramework,
+        packageManager: packageManager ?? detectPackageManager(),
+        git,
+        installDeps,
+    };
+    return config;
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAoB;IACnD,kBAAkB;IAClB,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,MAAM,KAAK,CAAC;YACxB,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,CAAC,GAAW,EAAE,EAAE;gBACxB,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;gBACxC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC;YAClE,CAAC;SACF,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,6BAA6B;QAC7B,MAAM,UAAU,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC;QACjE,CAAC;QACD,WAAW,GAAG,WAAW,CAAC;IAC5B,CAAC;IAED,WAAW,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAE/C,kBAAkB;IAClB,MAAM,WAAW,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAE9C,mBAAmB;IACnB,MAAM,YAAY,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAEhD,0BAA0B;IAC1B,MAAM,WAAW,GAAG,MAAM,cAAc,EAAE,CAAC;IAE3C,eAAe;IACf,MAAM,iBAAiB,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IAE7D,uBAAuB;IACvB,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;IAEnF,kBAAkB;IAClB,MAAM,MAAM,GAAgB;QAC1B,WAAW;QACX,WAAW;QACX,YAAY;QACZ,WAAW;QACX,iBAAiB;QACjB,eAAe,EAAE,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY;QAClE,gBAAgB,EAAE,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QAC5D,aAAa;QACb,cAAc,EAAE,cAAc,IAAI,oBAAoB,EAAE;QACxD,GAAG;QACH,WAAW;KACZ,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/prompts/patterns.d.ts

@@ -0,0 +1,8 @@
+/**
+ * NEXUS CLI - Application Patterns Prompt
+ *
+ * Asks the user which application patterns to include.
+ */
+import type { AppPattern } from '../types/config.js';
+export declare function promptPatterns(): Promise<AppPattern[]>;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/prompts/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/prompts/patterns.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAoC5D"}