zudojs-cli 2.0.1 → 2.1.0

package/dist/src/adapters/frontend/react.adapter.js

@@ -6,6 +6,8 @@
 import { execCommand } from "../../utils/utils.exec.js";
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
 import { scaffoldWithFallback } from "../../scaffolders/scaffolder.helper.js";
+import { renderReactFallback, versionFromRange } from "./fallback/index.js";
+import { DEPENDENCY_VERSION_RANGES as V } from "../../resolvers/dependency/dependencyVersions.constant.js";
 /**
  * React adapter using Vite as the build tool.
  */
@@ -22,10 +24,10 @@ export class ReactAdapter {
         }
     }
     async getLatestVersion() {
-        return "19.0.0";
+        return versionFromRange(V.react);
     }
     async scaffold(context) {
-        const files = this.getBaseFiles(context);
+        const files = renderReactFallback(context);
         await scaffoldWithFallback({
             command: "npm",
             args: [
@@ -49,7 +51,9 @@ export class ReactAdapter {
             deps.push({ name: "zustand", type: "dependency" });
         }
         if (context.features.testing) {
-            deps.push({ name: "vitest", type: "devDependency" }, { name: "@testing-library/react", type: "devDependency" }, { name: "@testing-library/jest-dom", type: "devDependency" }, { name: "@testing-library/user-event", type: "devDependency" }, { name: "jsdom", type: "devDependency" });
+            deps.push({ name: "vitest", type: "devDependency" }, { name: "@testing-library/react", type: "devDependency" }, 
+            // Peer dependency of @testing-library/react since v16.
+            { name: "@testing-library/dom", type: "devDependency" }, { name: "@testing-library/jest-dom", type: "devDependency" }, { name: "@testing-library/user-event", type: "devDependency" }, { name: "jsdom", type: "devDependency" });
         }
         if (context.features.linting) {
             deps.push({ name: "eslint", type: "devDependency" }, { name: "typescript-eslint", type: "devDependency" }, { name: "eslint-plugin-react-hooks", type: "devDependency" }, { name: "eslint-plugin-react-refresh", type: "devDependency" });
@@ -75,92 +79,6 @@ export class ReactAdapter {
         }
         return { valid: errors.length === 0, errors, warnings };
     }
-    getBaseFiles(context) {
-        const useTypeScript = context.language === "typescript";
-        const ext = useTypeScript ? "tsx" : "jsx";
-        return {
-            "package.json": JSON.stringify({
-                name: context.project.name,
-                version: "0.1.0",
-                private: true,
-                type: "module",
-                scripts: {
-                    dev: "vite",
-                    // Vite performs the build; tsc only typechecks (noEmit).
-                    build: useTypeScript ? "tsc --noEmit && vite build" : "vite build",
-                    preview: "vite preview",
-                },
-                dependencies: {
-                    react: "^19.0.0",
-                    "react-dom": "^19.0.0",
-                },
-                devDependencies: {
-                    vite: "^6.0.0",
-                    "@vitejs/plugin-react": "^4.3.0",
-                    ...(useTypeScript ? { typescript: "^5.0.0" } : {}),
-                },
-            }, null, 2),
-            "vite.config.ts": `import { defineConfig } from "vite";
-import react from "@vitejs/plugin-react";
-
-export default defineConfig({
-  plugins: [react()],
-});
-`,
-            ...(useTypeScript
-                ? {
-                    "tsconfig.json": JSON.stringify({
-                        compilerOptions: {
-                            target: "ES2020",
-                            useDefineForClassFields: true,
-                            lib: ["ES2020", "DOM", "DOM.Iterable"],
-                            module: "ESNext",
-                            skipLibCheck: true,
-                            moduleResolution: "bundler",
-                            allowImportingTsExtensions: true,
-                            resolveJsonModule: true,
-                            jsx: "react-jsx",
-                            noEmit: true,
-                        },
-                    }, null, 2),
-                }
-                : {}),
-            "index.html": `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>${context.project.name}</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.${ext}"></script>
-  </body>
-</html>
-`,
-            [`src/main.${ext}`]: `import { StrictMode } from "react";
-import { createRoot } from "react-dom/client";
-import App from "./App";
-
-createRoot(document.getElementById("root")${useTypeScript ? "!" : ""}).render(
-  <StrictMode>
-    <App />
-  </StrictMode>,
-);
-`,
-            [`src/App.${ext}`]: `export default function App() {
-  return (
-    <div>
-      <h1>Hello from Zudojs</h1>
-    </div>
-  );
-}
-`,
-            ...(useTypeScript
-                ? { "src/vite-env.d.ts": `/// <reference types="vite/client" />\n` }
-                : {}),
-        };
-    }
     getStructure(context) {
         const srcDir = "src";
         if (context.architecture === "feature-based") {

package/dist/src/adapters/frontend/svelte.adapter.d.ts

@@ -17,7 +17,6 @@ export declare class SvelteAdapter implements FrontendAdapter {
     applyZudojsStructure(context: FrontendGenerationContext): Promise<void>;
     generateIntegration(context: FrontendGenerationContext): Promise<void>;
     validate(context: FrontendGenerationContext): Promise<ValidationResult>;
-    private getBaseFiles;
     private getStructure;
     private getZudojsStandardStructure;
     private getFeatureBasedStructure;

package/dist/src/adapters/frontend/svelte.adapter.js

@@ -5,6 +5,8 @@
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
 import { scaffoldWithFallback } from "../../scaffolders/scaffolder.helper.js";
+import { renderSvelteFallback, versionFromRange } from "./fallback/index.js";
+import { DEPENDENCY_VERSION_RANGES as V } from "../../resolvers/dependency/dependencyVersions.constant.js";
 /**
  * Svelte adapter using Vite as the build tool.
  */
@@ -15,10 +17,10 @@ export class SvelteAdapter {
         return true;
     }
     async getLatestVersion() {
-        return "5.0.0";
+        return versionFromRange(V.svelte);
     }
     async scaffold(context) {
-        const files = this.getBaseFiles(context);
+        const files = renderSvelteFallback(context);
         await scaffoldWithFallback({
             command: "npm",
             args: [
@@ -65,90 +67,6 @@ export class SvelteAdapter {
         }
         return { valid: errors.length === 0, errors, warnings };
     }
-    getBaseFiles(context) {
-        const useTypeScript = context.language === "typescript";
-        return {
-            "package.json": JSON.stringify({
-                name: context.project.name,
-                version: "0.1.0",
-                private: true,
-                type: "module",
-                scripts: {
-                    dev: "vite dev",
-                    build: "vite build",
-                    preview: "vite preview",
-                },
-                dependencies: {
-                    svelte: "^5.0.0",
-                },
-                devDependencies: {
-                    vite: "^6.0.0",
-                    "@sveltejs/vite-plugin-svelte": "^4.0.0",
-                    ...(useTypeScript ? { typescript: "^5.0.0" } : {}),
-                },
-            }, null, 2),
-            "vite.config.ts": `import { defineConfig } from "vite";
-import { svelte } from "@sveltejs/vite-plugin-svelte";
-
-export default defineConfig({
-  plugins: [svelte()],
-});
-`,
-            "tsconfig.json": JSON.stringify({
-                compilerOptions: {
-                    target: "ES2020",
-                    lib: ["ES2020", "DOM", "DOM.Iterable"],
-                    module: "ESNext",
-                    skipLibCheck: true,
-                    moduleResolution: "bundler",
-                    allowImportingTsExtensions: true,
-                    resolveJsonModule: true,
-                    strict: true,
-                },
-            }, null, 2),
-            "index.html": `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>${context.project.name}</title>
-  </head>
-  <body>
-    <div id="app"></div>
-    <script type="module" src="/src/main.ts"></script>
-  </body>
-</html>
-`,
-            "src/main.ts": `import App from "./App.svelte";
-
-const app = new App({
-  target: document.getElementById("app")!,
-});
-
-export default app;
-`,
-            "src/App.svelte": `<script${useTypeScript ? ' lang="ts"' : ""}>
-</script>
-
-<template>
-  <div>
-    <h1>Hello from Zudojs</h1>
-  </div>
-</template>
-
-<style>
-  div {
-    font-family: system-ui, -apple-system, sans-serif;
-  }
-</style>
-`,
-            ...(useTypeScript
-                ? {
-                    "src/vite-env.d.ts": `/// <reference types="svelte" />\n/// <reference types="vite/client" />\n`,
-                }
-                : {}),
-        };
-    }
     getStructure(context) {
         const srcDir = "src";
         if (context.architecture === "feature-based") {

package/dist/src/adapters/frontend/sveltekit.adapter.d.ts

@@ -17,7 +17,6 @@ export declare class SvelteKitAdapter implements FrontendAdapter {
     applyZudojsStructure(context: FrontendGenerationContext): Promise<void>;
     generateIntegration(context: FrontendGenerationContext): Promise<void>;
     validate(context: FrontendGenerationContext): Promise<ValidationResult>;
-    private getBaseFiles;
     private getStructure;
     private getIntegrationFiles;
 }

package/dist/src/adapters/frontend/sveltekit.adapter.js

@@ -5,6 +5,8 @@
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
 import { scaffoldWithFallback } from "../../scaffolders/scaffolder.helper.js";
+import { renderSvelteKitFallback, versionFromRange } from "./fallback/index.js";
+import { DEPENDENCY_VERSION_RANGES as V } from "../../resolvers/dependency/dependencyVersions.constant.js";
 /**
  * SvelteKit adapter with SSR support.
  */
@@ -15,10 +17,10 @@ export class SvelteKitAdapter {
         return true;
     }
     async getLatestVersion() {
-        return "2.15.0";
+        return versionFromRange(V["@sveltejs/kit"]);
     }
     async scaffold(context) {
-        const files = this.getBaseFiles(context);
+        const files = renderSvelteKitFallback(context);
         await scaffoldWithFallback({
             command: "npx",
             args: [
@@ -59,61 +61,6 @@ export class SvelteKitAdapter {
         }
         return { valid: errors.length === 0, errors, warnings };
     }
-    getBaseFiles(context) {
-        return {
-            "package.json": JSON.stringify({
-                name: context.project.name,
-                version: "0.1.0",
-                private: true,
-                type: "module",
-                scripts: {
-                    dev: "vite dev",
-                    build: "vite build",
-                    preview: "vite preview",
-                },
-                dependencies: {
-                    "@sveltejs/kit": "^2.15.0",
-                    svelte: "^5.0.0",
-                },
-                devDependencies: {
-                    "@sveltejs/vite-plugin-svelte": "^4.0.0",
-                    vite: "^6.0.0",
-                },
-            }, null, 2),
-            "svelte.config.js": `import adapter from "@sveltejs/adapter-auto";
-
-export default {
-  kit: {
-    adapter: adapter(),
-  },
-};
-`,
-            "vite.config.ts": `import { sveltekit } from "@sveltejs/kit/vite";
-import { defineConfig } from "vite";
-
-export default defineConfig({
-  plugins: [sveltekit()],
-});
-`,
-            "src/routes/+page.svelte": `<h1>Hello from Zudojs</h1>
-`,
-            "src/routes/+layout.svelte": `<slot />
-`,
-            "src/app.html": `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>${context.project.name}</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    {% include 'src/app.html' %}
-  </body>
-</html>
-`,
-        };
-    }
     getStructure(context) {
         return {
             "src/lib/.gitkeep": "",

package/dist/src/adapters/frontend/vanilla.adapter.d.ts

@@ -17,7 +17,6 @@ export declare class VanillaAdapter implements FrontendAdapter {
     applyZudojsStructure(context: FrontendGenerationContext): Promise<void>;
     generateIntegration(context: FrontendGenerationContext): Promise<void>;
     validate(context: FrontendGenerationContext): Promise<ValidationResult>;
-    private getBaseFiles;
     private getStructure;
     private getIntegrationFiles;
 }

package/dist/src/adapters/frontend/vanilla.adapter.js

@@ -5,6 +5,8 @@
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
 import { scaffoldWithFallback } from "../../scaffolders/scaffolder.helper.js";
+import { renderVanillaFallback, versionFromRange } from "./fallback/index.js";
+import { DEPENDENCY_VERSION_RANGES as V } from "../../resolvers/dependency/dependencyVersions.constant.js";
 /**
  * Vanilla HTML/CSS/JS adapter with no framework.
  */
@@ -15,10 +17,10 @@ export class VanillaAdapter {
         return true;
     }
     async getLatestVersion() {
-        return "1.0.0";
+        return versionFromRange(V.vite);
     }
     async scaffold(context) {
-        const files = this.getBaseFiles(context);
+        const files = renderVanillaFallback(context);
         await scaffoldWithFallback({
             command: "npm",
             args: ["create", "vite@latest", ".", "--", "--template", "vanilla-ts"],
@@ -55,51 +57,6 @@ export class VanillaAdapter {
         }
         return { valid: errors.length === 0, errors, warnings };
     }
-    getBaseFiles(context) {
-        return {
-            "index.html": `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${context.project.name}</title>
-  <link rel="stylesheet" href="/src/styles/main.css">
-</head>
-<body>
-  <div id="app"></div>
-  <script type="module" src="/src/main.js"></script>
-</body>
-</html>
-`,
-            "src/main.js": `import { createApp } from "./app.js";
-
-const app = createApp();
-app.mount("#app");
-`,
-            "src/app.js": `export function createApp() {
-  return {
-    mount(selector) {
-      const root = document.querySelector(selector);
-      if (root) {
-        root.innerHTML = "<h1>Hello from Zudojs</h1>";
-      }
-    },
-  };
-}
-`,
-            "src/styles/main.css": `* {
-  margin: 0;
-  padding: 0;
-  box-sizing: border-box;
-}
-
-body {
-  font-family: system-ui, -apple-system, sans-serif;
-  line-height: 1.6;
-}
-`,
-        };
-    }
     getStructure(context) {
         return {
             "src/components/.gitkeep": "",

package/dist/src/adapters/frontend/vue.adapter.d.ts

@@ -17,7 +17,6 @@ export declare class VueAdapter implements FrontendAdapter {
     applyZudojsStructure(context: FrontendGenerationContext): Promise<void>;
     generateIntegration(context: FrontendGenerationContext): Promise<void>;
     validate(context: FrontendGenerationContext): Promise<ValidationResult>;
-    private getBaseFiles;
     private getStructure;
     private getZudojsStandardStructure;
     private getFeatureBasedStructure;

package/dist/src/adapters/frontend/vue.adapter.js

@@ -5,6 +5,8 @@
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
 import { scaffoldWithFallback } from "../../scaffolders/scaffolder.helper.js";
+import { renderVueFallback, versionFromRange } from "./fallback/index.js";
+import { DEPENDENCY_VERSION_RANGES as V } from "../../resolvers/dependency/dependencyVersions.constant.js";
 /**
  * Vue adapter using Vite as the build tool.
  */
@@ -15,10 +17,10 @@ export class VueAdapter {
         return true;
     }
     async getLatestVersion() {
-        return "3.5.0";
+        return versionFromRange(V.vue);
     }
     async scaffold(context) {
-        const files = this.getBaseFiles(context);
+        const files = renderVueFallback(context);
         await scaffoldWithFallback({
             command: "npm",
             args: [
@@ -62,80 +64,6 @@ export class VueAdapter {
         }
         return { valid: errors.length === 0, errors, warnings };
     }
-    getBaseFiles(context) {
-        const useTypeScript = context.language === "typescript";
-        return {
-            "package.json": JSON.stringify({
-                name: context.project.name,
-                version: "0.1.0",
-                private: true,
-                type: "module",
-                scripts: {
-                    dev: "vite",
-                    build: "vite build",
-                    preview: "vite preview",
-                },
-                dependencies: {
-                    vue: "^3.5.0",
-                },
-                devDependencies: {
-                    vite: "^6.0.0",
-                    "@vitejs/plugin-vue": "^4.5.0",
-                    ...(useTypeScript ? { typescript: "^5.0.0" } : {}),
-                },
-            }, null, 2),
-            "vite.config.ts": `import { defineConfig } from "vite";
-import vue from "@vitejs/plugin-vue";
-
-export default defineConfig({
-  plugins: [vue()],
-});
-`,
-            "tsconfig.json": JSON.stringify({
-                compilerOptions: {
-                    target: "ES2020",
-                    useDefineForClassFields: true,
-                    lib: ["ES2020", "DOM", "DOM.Iterable"],
-                    module: "ESNext",
-                    skipLibCheck: true,
-                    moduleResolution: "bundler",
-                    allowImportingTsExtensions: true,
-                    resolveJsonModule: true,
-                    strict: true,
-                },
-            }, null, 2),
-            "index.html": `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>${context.project.name}</title>
-  </head>
-  <body>
-    <div id="app"></div>
-    <script type="module" src="/src/main.ts"></script>
-  </body>
-</html>
-`,
-            "src/main.ts": `import { createApp } from "vue";
-import App from "./App.vue";
-
-createApp(App).mount("#app");
-`,
-            "src/App.vue": `<template>
-  <div>
-    <h1>Hello from Zudojs</h1>
-  </div>
-</template>
-
-<script setup lang="ts">
-</script>
-`,
-            ...(useTypeScript
-                ? { "src/vite-env.d.ts": `/// <reference types="vite/client" />\n` }
-                : {}),
-        };
-    }
     getStructure(context) {
         const srcDir = "src";
         if (context.architecture === "feature-based") {

package/dist/src/bin/bin.menu.d.ts

@@ -0,0 +1,22 @@
+/**
+ * zudojs-cli — Binary Menu
+ *
+ * Opens the interactive menu with the real terminal, project detection
+ * and the schematic and feature lists `generate` and `add` accept.
+ */
+import { type MenuOutcome, type MenuProjectScope } from "../prompts/menu/index.js";
+/**
+ * Detects a project the way the entry's command will.
+ *
+ * `dev` and `add` read only the current directory; `build` and `generate`
+ * walk up to the nearest project root.
+ */
+export declare function isZudojsProject(cwd: string, scope: MenuProjectScope): boolean;
+/**
+ * Shows the menu on the process's terminal.
+ *
+ * @param name - The executable name the user typed.
+ * @param cwd - The directory commands will run in.
+ */
+export declare function openMainMenu(name: string, cwd: string): Promise<MenuOutcome>;
+//# sourceMappingURL=bin.menu.d.ts.map

package/dist/src/bin/bin.menu.js

@@ -0,0 +1,40 @@
+/**
+ * zudojs-cli — Binary Menu
+ *
+ * Opens the interactive menu with the real terminal, project detection
+ * and the schematic and feature lists `generate` and `add` accept.
+ */
+import * as p from "@clack/prompts";
+import { CLI_VERSION, FEATURE_CHOICES, SCHEMA_CHOICES, } from "../constants/index.js";
+import { createTerminalMenuPrompter, runMenuFlow, } from "../prompts/menu/index.js";
+import { findProjectRoot } from "../resolvers/project.resolver.js";
+import { resolveProjectLayout } from "../resolvers/layout/projectLayout.core.js";
+/**
+ * Detects a project the way the entry's command will.
+ *
+ * `dev` and `add` read only the current directory; `build` and `generate`
+ * walk up to the nearest project root.
+ */
+export function isZudojsProject(cwd, scope) {
+    return scope === "cwd"
+        ? resolveProjectLayout(cwd) !== null
+        : findProjectRoot(cwd) !== null;
+}
+/**
+ * Shows the menu on the process's terminal.
+ *
+ * @param name - The executable name the user typed.
+ * @param cwd - The directory commands will run in.
+ */
+export async function openMainMenu(name, cwd) {
+    p.intro(`${name} v${CLI_VERSION}`);
+    return runMenuFlow({
+        prompter: createTerminalMenuPrompter(),
+        cwd,
+        name,
+        isProject: isZudojsProject,
+        schematics: SCHEMA_CHOICES,
+        features: FEATURE_CHOICES,
+    });
+}
+//# sourceMappingURL=bin.menu.js.map

package/dist/src/bin/bin.runner.d.ts

@@ -0,0 +1,38 @@
+/**
+ * zudojs-cli — Binary Runner
+ *
+ * What the `zudojs` / `zudo` executable does with its arguments: open the
+ * interactive menu for a bare invocation on a terminal, otherwise hand the
+ * arguments straight to the application.
+ */
+import type { CLIApplication } from "../cliType/cliType.type.js";
+import type { MenuOutcome } from "../prompts/menu/index.js";
+/** The parts of the process the runner looks at, injectable for tests. */
+export interface BinaryEnvironment {
+    /** Arguments after the script path (`process.argv.slice(2)`). */
+    readonly argv: readonly string[];
+    readonly stdin: {
+        readonly isTTY?: boolean;
+    };
+    readonly stdout: {
+        readonly isTTY?: boolean;
+    };
+    readonly env: Readonly<Record<string, string | undefined>>;
+}
+/**
+ * Whether a bare invocation should open the interactive menu.
+ *
+ * Only with no arguments at all, both stdin and stdout attached to a
+ * terminal, and not under CI. Piped, redirected and CI runs keep printing
+ * the help text and exiting 0, so scripts that call `zudojs` are unchanged.
+ */
+export declare function shouldShowMenu(environment: BinaryEnvironment): boolean;
+/**
+ * Runs the binary and resolves with the process exit code.
+ *
+ * @param app - The application with every command registered.
+ * @param environment - The process's arguments, streams and variables.
+ * @param openMenu - Shows the menu; only called when `shouldShowMenu`.
+ */
+export declare function runBinary(app: Pick<CLIApplication, "run">, environment: BinaryEnvironment, openMenu: () => Promise<MenuOutcome>): Promise<number>;
+//# sourceMappingURL=bin.runner.d.ts.map