@nexus-framework/cli 0.1.1

package/dist/utils/package-manager.d.ts

@@ -0,0 +1,16 @@
+/**
+ * NEXUS CLI - Package Manager Utility
+ *
+ * Detect and interact with npm, yarn, or pnpm.
+ */
+import type { PackageManager } from '../types/config.js';
+/**
+ * Detect the package manager being used in the current environment.
+ * Checks for lockfiles and the npm_config_user_agent env variable.
+ */
+export declare function detectPackageManager(cwd?: string): PackageManager;
+/** Get the install command for a given package manager */
+export declare function getInstallCommand(pm: PackageManager): string;
+/** Get the run command for a given package manager */
+export declare function getRunCommand(pm: PackageManager, script: string): string;
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/utils/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAsB,GAAG,cAAc,CAchF;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAS5D;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASxE"}

package/dist/utils/package-manager.js

@@ -0,0 +1,51 @@
+/**
+ * NEXUS CLI - Package Manager Utility
+ *
+ * Detect and interact with npm, yarn, or pnpm.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Detect the package manager being used in the current environment.
+ * Checks for lockfiles and the npm_config_user_agent env variable.
+ */
+export function detectPackageManager(cwd = process.cwd()) {
+    // Check env variable (set by npm/yarn/pnpm when running scripts)
+    const userAgent = process.env.npm_config_user_agent;
+    if (userAgent) {
+        if (userAgent.startsWith('yarn'))
+            return 'yarn';
+        if (userAgent.startsWith('pnpm'))
+            return 'pnpm';
+        return 'npm';
+    }
+    // Check lockfiles
+    if (fs.existsSync(path.join(cwd, 'yarn.lock')))
+        return 'yarn';
+    if (fs.existsSync(path.join(cwd, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    return 'npm';
+}
+/** Get the install command for a given package manager */
+export function getInstallCommand(pm) {
+    switch (pm) {
+        case 'yarn':
+            return 'yarn';
+        case 'pnpm':
+            return 'pnpm install';
+        default:
+            return 'npm install';
+    }
+}
+/** Get the run command for a given package manager */
+export function getRunCommand(pm, script) {
+    switch (pm) {
+        case 'yarn':
+            return `yarn ${script}`;
+        case 'pnpm':
+            return `pnpm ${script}`;
+        default:
+            return `npm run ${script}`;
+    }
+}
+//# sourceMappingURL=package-manager.js.map

package/dist/utils/package-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC9D,iEAAiE;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAChD,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kBAAkB;IAClB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAEnE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,EAAkB;IAClD,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,cAAc,CAAC;QACxB;YACE,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,aAAa,CAAC,EAAkB,EAAE,MAAc;IAC9D,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,MAAM;YACT,OAAO,QAAQ,MAAM,EAAE,CAAC;QAC1B,KAAK,MAAM;YACT,OAAO,QAAQ,MAAM,EAAE,CAAC;QAC1B;YACE,OAAO,WAAW,MAAM,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/utils/project-detector.d.ts

@@ -0,0 +1,55 @@
+/**
+ * NEXUS CLI - Project Detector
+ *
+ * Detects whether a directory contains an existing project and
+ * extracts basic project information by inspecting well-known files.
+ *
+ * Used by `nexus init --adopt` to intelligently generate .nexus/
+ * documentation for projects that already exist.
+ */
+/** Signals that indicate an existing project */
+export interface ProjectSignals {
+    hasPackageJson: boolean;
+    hasGit: boolean;
+    hasSrc: boolean;
+    hasTsConfig: boolean;
+    hasNodeModules: boolean;
+}
+/** Information extracted from an existing project */
+export interface ProjectInfo {
+    /** Whether we detected a project at all */
+    detected: boolean;
+    /** Specific signals found */
+    signals: ProjectSignals;
+    /** Project name from package.json (if available) */
+    name: string | null;
+    /** Project description from package.json (if available) */
+    description: string | null;
+    /** Detected frontend framework (or null) */
+    framework: string | null;
+    /** Detected test framework (or null) */
+    testFramework: string | null;
+    /** Detected package manager */
+    packageManager: string | null;
+    /** Whether the project already has .nexus/ */
+    hasNexus: boolean;
+    /** List of detected dependencies (combined deps + devDeps) */
+    dependencies: string[];
+}
+/**
+ * Check whether a directory looks like it already contains a project.
+ *
+ * Returns `true` if a `package.json` exists at the target path.
+ * This is a fast check used to decide whether to show the
+ * "--adopt" suggestion before any heavier analysis.
+ */
+export declare function isExistingProject(targetDir: string): boolean;
+/**
+ * Inspect a directory and return detailed project information.
+ *
+ * This reads package.json (if present) and checks for common
+ * framework/tooling markers so the adopt generator can pre-fill
+ * as much of the NEXUS documentation as possible.
+ */
+export declare function detectProject(targetDir: string): Promise<ProjectInfo>;
+//# sourceMappingURL=project-detector.d.ts.map

package/dist/utils/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../src/utils/project-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,oDAAoD;IACpD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wCAAwC;IACxC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAiD3E"}

package/dist/utils/project-detector.js

@@ -0,0 +1,125 @@
+/**
+ * NEXUS CLI - Project Detector
+ *
+ * Detects whether a directory contains an existing project and
+ * extracts basic project information by inspecting well-known files.
+ *
+ * Used by `nexus init --adopt` to intelligently generate .nexus/
+ * documentation for projects that already exist.
+ */
+import path from 'node:path';
+import fs from 'fs-extra';
+/* ──────────────────────────────────────────────────────────────
+ * Detection — runs against a directory path
+ * ────────────────────────────────────────────────────────────── */
+/**
+ * Check whether a directory looks like it already contains a project.
+ *
+ * Returns `true` if a `package.json` exists at the target path.
+ * This is a fast check used to decide whether to show the
+ * "--adopt" suggestion before any heavier analysis.
+ */
+export function isExistingProject(targetDir) {
+    return fs.existsSync(path.join(targetDir, 'package.json'));
+}
+/**
+ * Inspect a directory and return detailed project information.
+ *
+ * This reads package.json (if present) and checks for common
+ * framework/tooling markers so the adopt generator can pre-fill
+ * as much of the NEXUS documentation as possible.
+ */
+export async function detectProject(targetDir) {
+    const signals = await detectSignals(targetDir);
+    // Default empty info
+    const info = {
+        detected: signals.hasPackageJson,
+        signals,
+        name: null,
+        description: null,
+        framework: null,
+        testFramework: null,
+        packageManager: null,
+        hasNexus: false,
+        dependencies: [],
+    };
+    if (!signals.hasPackageJson) {
+        return info;
+    }
+    // Read package.json
+    try {
+        const pkgPath = path.join(targetDir, 'package.json');
+        const pkg = (await fs.readJSON(pkgPath));
+        info.name = typeof pkg.name === 'string' ? pkg.name : null;
+        info.description = typeof pkg.description === 'string' ? pkg.description : null;
+        // Collect all dependency names
+        const deps = Object.keys(pkg.dependencies ?? {});
+        const devDeps = Object.keys(pkg.devDependencies ?? {});
+        info.dependencies = [...deps, ...devDeps];
+        // Detect framework
+        info.framework = detectFramework(info.dependencies);
+        // Detect test framework
+        info.testFramework = detectTestFramework(info.dependencies);
+        // Detect package manager
+        info.packageManager = await detectPM(targetDir);
+    }
+    catch {
+        // package.json unreadable — keep defaults
+    }
+    // Check for existing .nexus/
+    info.hasNexus = fs.existsSync(path.join(targetDir, '.nexus'));
+    return info;
+}
+/* ──────────────────────────────────────────────────────────────
+ * Internal helpers
+ * ────────────────────────────────────────────────────────────── */
+async function detectSignals(dir) {
+    const [hasPackageJson, hasGit, hasSrc, hasTsConfig, hasNodeModules] = await Promise.all([
+        fs.pathExists(path.join(dir, 'package.json')),
+        fs.pathExists(path.join(dir, '.git')),
+        fs.pathExists(path.join(dir, 'src')),
+        fs.pathExists(path.join(dir, 'tsconfig.json')),
+        fs.pathExists(path.join(dir, 'node_modules')),
+    ]);
+    return { hasPackageJson, hasGit, hasSrc, hasTsConfig, hasNodeModules };
+}
+function detectFramework(deps) {
+    if (deps.includes('next'))
+        return 'nextjs';
+    if (deps.includes('nuxt') || deps.includes('nuxt3'))
+        return 'nuxt';
+    if (deps.includes('@sveltejs/kit'))
+        return 'sveltekit';
+    if (deps.includes('astro'))
+        return 'astro';
+    if (deps.includes('remix') || deps.includes('@remix-run/react'))
+        return 'remix';
+    if (deps.includes('react') && deps.includes('vite'))
+        return 'react-vite';
+    if (deps.includes('react'))
+        return 'react-vite'; // React without Next is likely Vite/CRA
+    if (deps.includes('vue'))
+        return 'nuxt'; // Vue without Nuxt — closest match
+    if (deps.includes('svelte'))
+        return 'sveltekit'; // Svelte without kit — closest match
+    return null;
+}
+function detectTestFramework(deps) {
+    if (deps.includes('vitest'))
+        return 'vitest';
+    if (deps.includes('jest'))
+        return 'jest';
+    if (deps.includes('@jest/core'))
+        return 'jest';
+    return null;
+}
+async function detectPM(dir) {
+    if (await fs.pathExists(path.join(dir, 'yarn.lock')))
+        return 'yarn';
+    if (await fs.pathExists(path.join(dir, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (await fs.pathExists(path.join(dir, 'package-lock.json')))
+        return 'npm';
+    return null;
+}
+//# sourceMappingURL=project-detector.js.map

package/dist/utils/project-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.js","sourceRoot":"","sources":["../../src/utils/project-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAqC1B;;oEAEoE;AAEpE;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IAE/C,qBAAqB;IACrB,MAAM,IAAI,GAAgB;QACxB,QAAQ,EAAE,OAAO,CAAC,cAAc;QAChC,OAAO;QACP,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,EAAE;KACjB,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA4B,CAAC;QAEpE,IAAI,CAAC,IAAI,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,IAAI,CAAC,WAAW,GAAG,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QAEhF,+BAA+B;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAE,GAAG,CAAC,YAAuC,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAE,GAAG,CAAC,eAA0C,IAAI,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC;QAE1C,mBAAmB;QACnB,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEpD,wBAAwB;QACxB,IAAI,CAAC,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE5D,yBAAyB;QACzB,IAAI,CAAC,cAAc,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE9D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;oEAEoE;AAEpE,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtF,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC7C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACrC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC9C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;KAC9C,CAAC,CAAC;IAEH,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,eAAe,CAAC,IAAc;IACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IACnE,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,WAAW,CAAC;IACvD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,OAAO,CAAC;IAChF,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IACzE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,YAAY,CAAC,CAAC,wCAAwC;IACzF,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,mCAAmC;IAC5E,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC,CAAC,qCAAqC;IACtF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAc;IACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,MAAM,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAW;IACjC,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACpE,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACzE,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3E,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/validator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * NEXUS CLI - Validator Utility
+ *
+ * Input validation for project names and other user input.
+ */
+/** Result of a validation check */
+export interface ValidationResult {
+    valid: boolean;
+    message?: string;
+}
+/**
+ * Validate a project name.
+ * Must be a valid npm package name and the target directory must not already exist.
+ */
+export declare function validateProjectName(name: string, targetDir?: string): ValidationResult;
+/**
+ * Validate that a value is non-empty.
+ */
+export declare function validateNotEmpty(value: string, fieldName?: string): ValidationResult;
+/**
+ * Sanitize a project name for use as a directory name.
+ * Converts to lowercase, replaces spaces with hyphens, strips invalid chars.
+ */
+export declare function sanitizeProjectName(name: string): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/utils/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA2BtF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAU,GAAG,gBAAgB,CAKrF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQxD"}

package/dist/utils/validator.js

@@ -0,0 +1,59 @@
+/**
+ * NEXUS CLI - Validator Utility
+ *
+ * Input validation for project names and other user input.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import validateNpmPackageName from 'validate-npm-package-name';
+/**
+ * Validate a project name.
+ * Must be a valid npm package name and the target directory must not already exist.
+ */
+export function validateProjectName(name, targetDir) {
+    if (!name || name.trim().length === 0) {
+        return { valid: false, message: 'Project name cannot be empty.' };
+    }
+    const trimmed = name.trim();
+    // Check npm naming rules
+    const npmResult = validateNpmPackageName(trimmed);
+    if (!npmResult.validForNewPackages) {
+        const errors = [...(npmResult.errors ?? []), ...(npmResult.warnings ?? [])];
+        return {
+            valid: false,
+            message: `Invalid package name: ${errors.join(', ')}`,
+        };
+    }
+    // Check if directory already exists
+    const dir = targetDir ?? path.resolve(process.cwd(), trimmed);
+    if (fs.existsSync(dir)) {
+        return {
+            valid: false,
+            message: `Directory "${trimmed}" already exists. Choose a different name or delete the existing directory.`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate that a value is non-empty.
+ */
+export function validateNotEmpty(value, fieldName = 'Value') {
+    if (!value || value.trim().length === 0) {
+        return { valid: false, message: `${fieldName} cannot be empty.` };
+    }
+    return { valid: true };
+}
+/**
+ * Sanitize a project name for use as a directory name.
+ * Converts to lowercase, replaces spaces with hyphens, strips invalid chars.
+ */
+export function sanitizeProjectName(name) {
+    return name
+        .trim()
+        .toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9\-_.]/g, '')
+        .replace(/^[-_.]+/, '')
+        .replace(/[-_.]+$/, '');
+}
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,sBAAsB,MAAM,2BAA2B,CAAC;AAQ/D;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,SAAkB;IAClE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,yBAAyB;IACzB,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5E,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,yBAAyB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACtD,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,MAAM,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,cAAc,OAAO,6EAA6E;SAC5G,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,SAAS,GAAG,OAAO;IACjE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,SAAS,mBAAmB,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI;SACR,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * NEXUS CLI - Version
+ *
+ * Single source of truth for the CLI version.
+ */
+export declare const version = "0.1.1";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,7 @@
+/**
+ * NEXUS CLI - Version
+ *
+ * Single source of truth for the CLI version.
+ */
+export const version = '0.1.1';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@nexus-framework/cli",
+  "version": "0.1.1",
+  "description": "AI-Native Project Scaffolding for the Modern Era — generates production-ready, AI-optimized project structures",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "nexus": "./bin/nexus.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "bin"
+  ],
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ --ext .ts",
+    "lint:fix": "eslint src/ --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "type-check": "tsc --noEmit",
+    "pre-commit": "npm run lint && npm run type-check && npm run test",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "cli",
+    "scaffolding",
+    "project-generator",
+    "ai-native",
+    "nextjs",
+    "react",
+    "svelte",
+    "typescript",
+    "developer-tools",
+    "gda-africa",
+    "nexus"
+  ],
+  "author": "Glenhalton Takor <nexus@glenhalton.com>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GDA-Africa/nexus-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/GDA-Africa/nexus-cli/issues"
+  },
+  "homepage": "https://github.com/GDA-Africa/nexus-cli#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.3.2",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "execa": "^9.5.2",
+    "figlet": "^1.8.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^12.3.2",
+    "mustache": "^4.2.0",
+    "ora": "^8.1.1",
+    "update-notifier": "^7.3.1",
+    "validate-npm-package-name": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/figlet": "^1.7.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/mustache": "^4.2.5",
+    "@types/node": "^22.13.1",
+    "@types/update-notifier": "^6.0.8",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "@typescript-eslint/eslint-plugin": "^8.22.0",
+    "@typescript-eslint/parser": "^8.22.0",
+    "@vitest/coverage-v8": "^3.0.5",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.31.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}