zudojs-cli 2.0.1 → 2.1.0

package/dist/src/adapters/frontend/fallback/vite/react.fallback.js

@@ -0,0 +1,77 @@
+/**
+ * Built-in React + Vite template, written when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite/react
+ */
+import { DEPENDENCY_VERSION_RANGES as V, TYPESCRIPT_VERSION_RANGES, } from "../../../../resolvers/dependency/dependencyVersions.constant.js";
+import { renderJsonFile, renderViteIndexHtml, VITE_TSCONFIG_COMPILER_OPTIONS, } from "../fallback.helper.js";
+/**
+ * Renders the React fallback project, mirroring `create-vite`'s `react-ts`
+ * (or `react`) template.
+ */
+export function renderReactFallback(context) {
+    const useTypeScript = context.language === "typescript";
+    const ext = useTypeScript ? "tsx" : "jsx";
+    const files = {
+        "package.json": renderJsonFile({
+            name: context.project.name,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: {
+                dev: "vite",
+                build: useTypeScript ? "tsc --noEmit && vite build" : "vite build",
+                preview: "vite preview",
+            },
+            dependencies: {
+                react: V.react,
+                "react-dom": V["react-dom"],
+            },
+            devDependencies: {
+                vite: V.vite,
+                "@vitejs/plugin-react": V["@vitejs/plugin-react"],
+                ...(useTypeScript
+                    ? {
+                        typescript: TYPESCRIPT_VERSION_RANGES.frontend,
+                        "@types/react": V["@types/react"],
+                        "@types/react-dom": V["@types/react-dom"],
+                    }
+                    : {}),
+            },
+        }),
+        "vite.config.ts": `import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [react()],
+});
+`,
+        "index.html": renderViteIndexHtml(context.project.name, "root", `/src/main.${ext}`),
+        [`src/main.${ext}`]: `import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import App from "./App.${ext}";
+
+createRoot(document.getElementById("root")${useTypeScript ? "!" : ""}).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);
+`,
+        [`src/App.${ext}`]: `export default function App() {
+  return (
+    <div>
+      <h1>Hello from Zudojs</h1>
+    </div>
+  );
+}
+`,
+    };
+    if (useTypeScript) {
+        files["tsconfig.json"] = renderJsonFile({
+            compilerOptions: { ...VITE_TSCONFIG_COMPILER_OPTIONS, jsx: "react-jsx" },
+            include: ["src"],
+        });
+    }
+    return files;
+}
+//# sourceMappingURL=react.fallback.js.map

package/dist/src/adapters/frontend/fallback/vite/svelte.fallback.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Built-in Svelte + Vite template, written when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite/svelte
+ */
+import type { FrontendGenerationContext } from "../../frontendAdapter.type.js";
+import { type FallbackFileTree } from "../fallback.helper.js";
+/**
+ * Renders the Svelte 5 fallback project, mirroring `create-vite`'s
+ * `svelte-ts` (or `svelte`) template: components are mounted with
+ * `mount()`, since Svelte 5 removed `new App({ target })`.
+ */
+export declare function renderSvelteFallback(context: FrontendGenerationContext): FallbackFileTree;
+//# sourceMappingURL=svelte.fallback.d.ts.map

package/dist/src/adapters/frontend/fallback/vite/svelte.fallback.js

@@ -0,0 +1,95 @@
+/**
+ * Built-in Svelte + Vite template, written when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite/svelte
+ */
+import { DEPENDENCY_VERSION_RANGES as V, TYPESCRIPT_VERSION_RANGES, } from "../../../../resolvers/dependency/dependencyVersions.constant.js";
+import { renderJsonFile, renderViteIndexHtml, } from "../fallback.helper.js";
+/**
+ * Renders the Svelte 5 fallback project, mirroring `create-vite`'s
+ * `svelte-ts` (or `svelte`) template: components are mounted with
+ * `mount()`, since Svelte 5 removed `new App({ target })`.
+ */
+export function renderSvelteFallback(context) {
+    const useTypeScript = context.language === "typescript";
+    const ext = useTypeScript ? "ts" : "js";
+    const files = {
+        "package.json": renderJsonFile({
+            name: context.project.name,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: {
+                dev: "vite",
+                build: "vite build",
+                preview: "vite preview",
+                ...(useTypeScript
+                    ? { check: "svelte-check --tsconfig ./tsconfig.json" }
+                    : {}),
+            },
+            dependencies: {
+                svelte: V.svelte,
+            },
+            devDependencies: {
+                vite: V.vite,
+                "@sveltejs/vite-plugin-svelte": V["@sveltejs/vite-plugin-svelte"],
+                ...(useTypeScript
+                    ? {
+                        typescript: TYPESCRIPT_VERSION_RANGES.frontend,
+                        "svelte-check": V["svelte-check"],
+                        "@tsconfig/svelte": V["@tsconfig/svelte"],
+                    }
+                    : {}),
+            },
+        }),
+        "svelte.config.js": `/** @type {import("@sveltejs/vite-plugin-svelte").SvelteConfig} */
+export default {};
+`,
+        "vite.config.ts": `import { svelte } from "@sveltejs/vite-plugin-svelte";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [svelte()],
+});
+`,
+        "index.html": renderViteIndexHtml(context.project.name, "app", `/src/main.${ext}`),
+        [`src/main.${ext}`]: `import { mount } from "svelte";
+import App from "./App.svelte";
+
+const app = mount(App, {
+  target: document.getElementById("app")${useTypeScript ? "!" : ""},
+});
+
+export default app;
+`,
+        "src/App.svelte": `<script${useTypeScript ? ' lang="ts"' : ""}>
+  const title = "Hello from Zudojs";
+</script>
+
+<main>
+  <h1>{title}</h1>
+</main>
+
+<style>
+  main {
+    font-family: system-ui, -apple-system, sans-serif;
+  }
+</style>
+`,
+    };
+    if (useTypeScript) {
+        files["tsconfig.json"] = renderJsonFile({
+            extends: "@tsconfig/svelte/tsconfig.json",
+            compilerOptions: {
+                target: "ES2023",
+                module: "ESNext",
+                types: ["svelte", "vite/client"],
+                noEmit: true,
+                moduleDetection: "force",
+            },
+            include: ["src/**/*.ts", "src/**/*.js", "src/**/*.svelte"],
+        });
+    }
+    return files;
+}
+//# sourceMappingURL=svelte.fallback.js.map

package/dist/src/adapters/frontend/fallback/vite/vanilla.fallback.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Built-in vanilla + Vite template, written when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite/vanilla
+ */
+import type { FrontendGenerationContext } from "../../frontendAdapter.type.js";
+import { type FallbackFileTree } from "../fallback.helper.js";
+/**
+ * Renders the vanilla fallback project. It used to ship no `package.json`
+ * at all, so neither `install` nor `build` could run in it.
+ */
+export declare function renderVanillaFallback(context: FrontendGenerationContext): FallbackFileTree;
+//# sourceMappingURL=vanilla.fallback.d.ts.map

package/dist/src/adapters/frontend/fallback/vite/vanilla.fallback.js

@@ -0,0 +1,71 @@
+/**
+ * Built-in vanilla + Vite template, written when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite/vanilla
+ */
+import { DEPENDENCY_VERSION_RANGES as V } from "../../../../resolvers/dependency/dependencyVersions.constant.js";
+import { renderJsonFile } from "../fallback.helper.js";
+/**
+ * Renders the vanilla fallback project. It used to ship no `package.json`
+ * at all, so neither `install` nor `build` could run in it.
+ */
+export function renderVanillaFallback(context) {
+    return {
+        "package.json": renderJsonFile({
+            name: context.project.name,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: {
+                dev: "vite",
+                build: "vite build",
+                preview: "vite preview",
+            },
+            devDependencies: {
+                vite: V.vite,
+            },
+        }),
+        "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;
+}
+`,
+    };
+}
+//# sourceMappingURL=vanilla.fallback.js.map

package/dist/src/adapters/frontend/fallback/vite/vue.fallback.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Built-in Vue + Vite template, written when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite/vue
+ */
+import type { FrontendGenerationContext } from "../../frontendAdapter.type.js";
+import { type FallbackFileTree } from "../fallback.helper.js";
+/**
+ * Renders the Vue fallback project, mirroring `create-vite`'s `vue-ts`
+ * (or `vue`) template. TypeScript projects typecheck with `vue-tsc`, which
+ * understands `.vue` files, before Vite builds.
+ */
+export declare function renderVueFallback(context: FrontendGenerationContext): FallbackFileTree;
+//# sourceMappingURL=vue.fallback.d.ts.map

package/dist/src/adapters/frontend/fallback/vite/vue.fallback.js

@@ -0,0 +1,78 @@
+/**
+ * Built-in Vue + Vite template, written when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite/vue
+ */
+import { DEPENDENCY_VERSION_RANGES as V, TYPESCRIPT_VERSION_RANGES, } from "../../../../resolvers/dependency/dependencyVersions.constant.js";
+import { renderJsonFile, renderViteIndexHtml, } from "../fallback.helper.js";
+/**
+ * Renders the Vue fallback project, mirroring `create-vite`'s `vue-ts`
+ * (or `vue`) template. TypeScript projects typecheck with `vue-tsc`, which
+ * understands `.vue` files, before Vite builds.
+ */
+export function renderVueFallback(context) {
+    const useTypeScript = context.language === "typescript";
+    const ext = useTypeScript ? "ts" : "js";
+    const files = {
+        "package.json": renderJsonFile({
+            name: context.project.name,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: {
+                dev: "vite",
+                build: useTypeScript ? "vue-tsc --noEmit && vite build" : "vite build",
+                preview: "vite preview",
+            },
+            dependencies: {
+                vue: V.vue,
+            },
+            devDependencies: {
+                vite: V.vite,
+                "@vitejs/plugin-vue": V["@vitejs/plugin-vue"],
+                ...(useTypeScript
+                    ? {
+                        typescript: TYPESCRIPT_VERSION_RANGES.frontend,
+                        "vue-tsc": V["vue-tsc"],
+                        "@vue/tsconfig": V["@vue/tsconfig"],
+                    }
+                    : {}),
+            },
+        }),
+        "vite.config.ts": `import vue from "@vitejs/plugin-vue";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [vue()],
+});
+`,
+        "index.html": renderViteIndexHtml(context.project.name, "app", `/src/main.${ext}`),
+        [`src/main.${ext}`]: `import { createApp } from "vue";
+import App from "./App.vue";
+
+createApp(App).mount("#app");
+`,
+        "src/App.vue": `<script setup${useTypeScript ? ' lang="ts"' : ""}>
+const title = "Hello from Zudojs";
+</script>
+
+<template>
+  <div>
+    <h1>{{ title }}</h1>
+  </div>
+</template>
+`,
+    };
+    if (useTypeScript) {
+        files["tsconfig.json"] = renderJsonFile({
+            extends: "@vue/tsconfig/tsconfig.dom.json",
+            compilerOptions: {
+                types: ["vite/client"],
+                noFallthroughCasesInSwitch: true,
+            },
+            include: ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"],
+        });
+    }
+    return files;
+}
+//# sourceMappingURL=vue.fallback.js.map

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

@@ -17,7 +17,6 @@ export declare class NextAdapter 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/next.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 { renderNextFallback, versionFromRange } from "./fallback/index.js";
+import { DEPENDENCY_VERSION_RANGES as V } from "../../resolvers/dependency/dependencyVersions.constant.js";
 /**
  * Next.js adapter with App Router support.
  */
@@ -22,10 +24,10 @@ export class NextAdapter {
         }
     }
     async getLatestVersion() {
-        return "15.0.0";
+        return versionFromRange(V.next);
     }
     async scaffold(context) {
-        const files = this.getBaseFiles(context);
+        const files = renderNextFallback(context);
         await scaffoldWithFallback({
             command: "npx",
             args: [
@@ -34,10 +36,16 @@ export class NextAdapter {
                 "--typescript",
                 "--no-eslint",
                 "--no-tailwind",
-                "--no-src-dir",
+                // The Zudojs structure and the fallback both live under src/.
+                "--src-dir",
                 "--app",
-                "--no-import-alias",
-                "--no-turbopack",
+                "--import-alias",
+                "@/*",
+                // The pipeline installs with the project's package manager, and a
+                // fullstack project's apps/web must not become a nested git repo.
+                `--use-${context.packageManager}`,
+                "--skip-install",
+                "--disable-git",
             ],
             targetPath: context.projectPath,
             fallbackFiles: files,
@@ -49,7 +57,9 @@ export class NextAdapter {
             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" });
         }
         return deps;
     }
@@ -69,95 +79,6 @@ export class NextAdapter {
         }
         return { valid: errors.length === 0, errors, warnings };
     }
-    getBaseFiles(context) {
-        return {
-            "package.json": JSON.stringify({
-                name: context.project.name,
-                version: "0.1.0",
-                private: true,
-                scripts: {
-                    dev: "next dev",
-                    build: "next build",
-                    start: "next start",
-                },
-                dependencies: {
-                    next: "^15.0.0",
-                    react: "^19.0.0",
-                    "react-dom": "^19.0.0",
-                },
-                devDependencies: {
-                    typescript: "^5.0.0",
-                    "@types/react": "^19.0.0",
-                    "@types/node": "^20.0.0",
-                },
-            }, null, 2),
-            "next.config.ts": `/** @type {import("next").NextConfig} */
-const nextConfig = {
-  reactStrictMode: true,
-};
-
-export default nextConfig;
-`,
-            "tsconfig.json": JSON.stringify({
-                compilerOptions: {
-                    target: "ES2017",
-                    lib: ["dom", "dom.iterable", "esnext"],
-                    allowJs: true,
-                    skipLibCheck: true,
-                    strict: true,
-                    noEmit: true,
-                    esModuleInterop: true,
-                    module: "esnext",
-                    moduleResolution: "bundler",
-                    resolveJsonModule: true,
-                    isolatedModules: true,
-                    jsx: "preserve",
-                    incremental: true,
-                    plugins: [{ name: "next" }],
-                    paths: { "@/*": ["./src/*"] },
-                },
-                include: [
-                    "next-env.d.ts",
-                    "**/*.ts",
-                    "**/*.tsx",
-                    ".next/types/**/*.ts",
-                ],
-                exclude: ["node_modules"],
-            }, null, 2),
-            "src/app/layout.tsx": `import type { Metadata } from "next";
-
-export const metadata: Metadata = {
-  title: "${context.project.name}",
-  description: "Generated by Zudojs",
-};
-
-export default function RootLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <html lang="en">
-      <body>{children}</body>
-    </html>
-  );
-}
-`,
-            "src/app/page.tsx": `export default function Home() {
-  return (
-    <main>
-      <h1>Hello from Zudojs</h1>
-    </main>
-  );
-}
-`,
-            "src/app/globals.css": `body {
-  margin: 0;
-  font-family: system-ui, -apple-system, sans-serif;
-}
-`,
-        };
-    }
     getStructure(context) {
         const srcDir = "src";
         return {

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

@@ -5,7 +5,7 @@
  */
 import type { FrontendAdapter, FrontendGenerationContext, DependencyRequirement, ValidationResult } from "./frontendAdapter.type.js";
 /**
- * Nuxt adapter with Nuxt 3 support.
+ * Nuxt adapter targeting Nuxt 4 (application code under app/).
  */
 export declare class NuxtAdapter implements FrontendAdapter {
     readonly name = "nuxt";
@@ -17,7 +17,6 @@ export declare class NuxtAdapter 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/nuxt.adapter.js

@@ -5,8 +5,10 @@
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
 import { scaffoldWithFallback } from "../../scaffolders/scaffolder.helper.js";
+import { renderNuxtFallback, versionFromRange } from "./fallback/index.js";
+import { DEPENDENCY_VERSION_RANGES as V } from "../../resolvers/dependency/dependencyVersions.constant.js";
 /**
- * Nuxt adapter with Nuxt 3 support.
+ * Nuxt adapter targeting Nuxt 4 (application code under app/).
  */
 export class NuxtAdapter {
     name = "nuxt";
@@ -15,13 +17,29 @@ export class NuxtAdapter {
         return true;
     }
     async getLatestVersion() {
-        return "3.15.0";
+        return versionFromRange(V.nuxt);
     }
     async scaffold(context) {
-        const files = this.getBaseFiles(context);
+        const files = renderNuxtFallback(context);
         await scaffoldWithFallback({
             command: "npx",
-            args: ["nuxi@latest", "init", "."],
+            // Without --template, --packageManager and --gitInit nuxi exits with
+            // "Missing required arguments" in a non-interactive shell, so every
+            // Nuxt project used to get the fallback. --force lets it write into
+            // the existing (empty or pnpm-workspace-only) directory without
+            // removing what is there.
+            args: [
+                "nuxi@latest",
+                "init",
+                ".",
+                "--template",
+                "minimal",
+                "--packageManager",
+                context.packageManager,
+                "--no-gitInit",
+                "--no-install",
+                "--force",
+            ],
             targetPath: context.projectPath,
             fallbackFiles: files,
         });
@@ -52,54 +70,25 @@ export class NuxtAdapter {
         }
         return { valid: errors.length === 0, errors, warnings };
     }
-    getBaseFiles(context) {
-        return {
-            "package.json": JSON.stringify({
-                name: context.project.name,
-                version: "0.1.0",
-                private: true,
-                scripts: {
-                    dev: "nuxt dev",
-                    build: "nuxt build",
-                    preview: "nuxt preview",
-                },
-                dependencies: {
-                    nuxt: "^3.15.0",
-                },
-                devDependencies: {
-                    "@nuxt/devtools": "latest",
-                },
-            }, null, 2),
-            "nuxt.config.ts": `export default defineNuxtConfig({
-  compatibilityDate: "2024-11-01",
-  devtools: { enabled: true },
-});
-`,
-            "app.vue": `<template>
-  <div>
-    <h1>Hello from Zudojs</h1>
-  </div>
-</template>
-`,
-        };
-    }
     getStructure(context) {
+        // Nuxt 4 resolves application code from app/ (its srcDir); server/
+        // and shared/ stay at the project root.
         return {
-            "components/.gitkeep": "",
-            "composables/.gitkeep": "",
-            "layouts/.gitkeep": "",
-            "pages/.gitkeep": "",
+            "app/components/.gitkeep": "",
+            "app/composables/.gitkeep": "",
+            "app/layouts/.gitkeep": "",
+            "app/pages/.gitkeep": "",
+            "app/stores/.gitkeep": "",
+            "app/utils/.gitkeep": "",
             "server/.gitkeep": "",
-            "stores/.gitkeep": "",
-            "types/index.ts": "// Types\nexport {};\n",
-            "utils/.gitkeep": "",
+            "shared/types/index.ts": "// Types\nexport {};\n",
         };
     }
     getIntegrationFiles(context) {
         const files = {};
         if (context.project.type === "fullstack") {
             files[".env.example"] = `NUXT_PUBLIC_API_URL=http://localhost:3000\n`;
-            files["composables/useApi.ts"] = `/**
+            files["app/composables/useApi.ts"] = `/**
  * API Client for backend communication.
  */
 

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

@@ -22,7 +22,7 @@ export class ReactNativeAdapter {
         }
     }
     async getLatestVersion() {
-        return "52";
+        return "57";
     }
     async scaffold(context) {
         await scaffoldWithFallback({

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

@@ -17,7 +17,6 @@ export declare class ReactAdapter 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;