zudojs-cli 2.0.0 → 2.1.0

package/dist/src/adapters/frontend/fallback/framework/angular/angularWorkspace.fallback.js

@@ -0,0 +1,125 @@
+/**
+ * Workspace configuration (`angular.json`, tsconfigs) for the built-in
+ * Angular fallback.
+ *
+ * @module adapters/frontend/fallback/framework/angular/workspace
+ */
+import { renderJsonFile } from "../../fallback.helper.js";
+/**
+ * Renders the Angular CLI workspace file `ng new` 22 writes. Builds, the dev
+ * server and unit tests all go through `@angular/build`; the deprecated
+ * `@angular-devkit/build-angular` and its Karma/Jasmine test runner are no
+ * longer used.
+ *
+ * @param projectName - The normalised project name used as the project key.
+ * @param packageManager - Recorded as the CLI's package manager.
+ */
+export function renderAngularWorkspace(projectName, packageManager) {
+    return renderJsonFile({
+        $schema: "./node_modules/@angular/cli/lib/config/schema.json",
+        version: 1,
+        cli: { packageManager },
+        newProjectRoot: "projects",
+        projects: {
+            [projectName]: {
+                projectType: "application",
+                schematics: {},
+                root: "",
+                sourceRoot: "src",
+                prefix: "app",
+                architect: {
+                    build: {
+                        builder: "@angular/build:application",
+                        options: {
+                            browser: "src/main.ts",
+                            tsConfig: "tsconfig.app.json",
+                            assets: [{ glob: "**/*", input: "public" }],
+                            styles: ["src/styles.css"],
+                        },
+                        configurations: {
+                            production: {
+                                budgets: [
+                                    {
+                                        type: "initial",
+                                        maximumWarning: "500kB",
+                                        maximumError: "1MB",
+                                    },
+                                    {
+                                        type: "anyComponentStyle",
+                                        maximumWarning: "4kB",
+                                        maximumError: "8kB",
+                                    },
+                                ],
+                                outputHashing: "all",
+                            },
+                            development: {
+                                optimization: false,
+                                extractLicenses: false,
+                                sourceMap: true,
+                            },
+                        },
+                        defaultConfiguration: "production",
+                    },
+                    serve: {
+                        builder: "@angular/build:dev-server",
+                        configurations: {
+                            production: { buildTarget: `${projectName}:build:production` },
+                            development: { buildTarget: `${projectName}:build:development` },
+                        },
+                        defaultConfiguration: "development",
+                    },
+                    test: {
+                        builder: "@angular/build:unit-test",
+                    },
+                },
+            },
+        },
+    });
+}
+/**
+ * Renders the solution-style tsconfigs `ng new` 22 writes: a base config
+ * referencing an app config and a Vitest spec config.
+ */
+export function renderAngularTsconfigs() {
+    return {
+        "tsconfig.json": renderJsonFile({
+            compileOnSave: false,
+            compilerOptions: {
+                noImplicitOverride: true,
+                noPropertyAccessFromIndexSignature: true,
+                noImplicitReturns: true,
+                noFallthroughCasesInSwitch: true,
+                skipLibCheck: true,
+                isolatedModules: true,
+                experimentalDecorators: true,
+                importHelpers: true,
+                strict: true,
+                target: "ES2022",
+                module: "preserve",
+            },
+            angularCompilerOptions: {
+                enableI18nLegacyMessageIdFormat: false,
+                strictInjectionParameters: true,
+                strictInputAccessModifiers: true,
+                strictTemplates: true,
+            },
+            files: [],
+            references: [
+                { path: "./tsconfig.app.json" },
+                { path: "./tsconfig.spec.json" },
+            ],
+        }),
+        "tsconfig.app.json": renderJsonFile({
+            extends: "./tsconfig.json",
+            compilerOptions: { types: [] },
+            include: ["src/**/*.ts"],
+            exclude: ["src/**/*.spec.ts"],
+        }),
+        "tsconfig.spec.json": renderJsonFile({
+            extends: "./tsconfig.json",
+            compilerOptions: { types: ["vitest/globals"] },
+            include: ["src/**/*.d.ts", "src/**/*.spec.ts"],
+        }),
+    };
+}
+//# sourceMappingURL=angularWorkspace.fallback.js.map

package/dist/src/adapters/frontend/fallback/framework/angular/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Built-in Angular fallback template, used when `ng new` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/angular
+ */
+export { renderAngularFallback } from "./angular.fallback.js";
+export { renderAngularTsconfigs, renderAngularWorkspace, } from "./angularWorkspace.fallback.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/adapters/frontend/fallback/framework/angular/index.js

@@ -0,0 +1,8 @@
+/**
+ * Built-in Angular fallback template, used when `ng new` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/angular
+ */
+export { renderAngularFallback } from "./angular.fallback.js";
+export { renderAngularTsconfigs, renderAngularWorkspace, } from "./angularWorkspace.fallback.js";
+//# sourceMappingURL=index.js.map

package/dist/src/adapters/frontend/fallback/framework/astro.fallback.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Built-in Astro template, written when `create-astro` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/astro
+ */
+import type { FrontendGenerationContext } from "../../frontendAdapter.type.js";
+import { type FallbackFileTree } from "../fallback.helper.js";
+/**
+ * Renders the Astro fallback project, matching `create-astro --template
+ * minimal` plus a layout. `astro check` needs `@astrojs/check` and a
+ * TypeScript 6 compiler.
+ */
+export declare function renderAstroFallback(context: FrontendGenerationContext): FallbackFileTree;
+//# sourceMappingURL=astro.fallback.d.ts.map

package/dist/src/adapters/frontend/fallback/framework/astro.fallback.js

@@ -0,0 +1,76 @@
+/**
+ * Built-in Astro template, written when `create-astro` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/astro
+ */
+import { DEPENDENCY_VERSION_RANGES as V, TYPESCRIPT_VERSION_RANGES, } from "../../../../resolvers/dependency/dependencyVersions.constant.js";
+import { renderJsonFile } from "../fallback.helper.js";
+/**
+ * Renders the Astro fallback project, matching `create-astro --template
+ * minimal` plus a layout. `astro check` needs `@astrojs/check` and a
+ * TypeScript 6 compiler.
+ */
+export function renderAstroFallback(context) {
+    return {
+        "package.json": renderJsonFile({
+            name: context.project.name,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: {
+                dev: "astro dev",
+                build: "astro build",
+                preview: "astro preview",
+                check: "astro check",
+                astro: "astro",
+            },
+            dependencies: {
+                astro: V.astro,
+            },
+            devDependencies: {
+                "@astrojs/check": V["@astrojs/check"],
+                typescript: TYPESCRIPT_VERSION_RANGES.frontend,
+            },
+        }),
+        "astro.config.mjs": `// @ts-check
+import { defineConfig } from "astro/config";
+
+export default defineConfig({});
+`,
+        "tsconfig.json": renderJsonFile({
+            extends: "astro/tsconfigs/strict",
+            include: [".astro/types.d.ts", "**/*"],
+            exclude: ["dist"],
+        }),
+        "src/layouts/Layout.astro": `---
+interface Props {
+  title: string;
+}
+
+const { title } = Astro.props;
+---
+
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width" />
+    <meta name="generator" content={Astro.generator} />
+    <title>{title}</title>
+  </head>
+  <body>
+    <slot />
+  </body>
+</html>
+`,
+        "src/pages/index.astro": `---
+import Layout from "../layouts/Layout.astro";
+---
+
+<Layout title=${JSON.stringify(context.project.name)}>
+  <h1>Hello from Zudojs</h1>
+</Layout>
+`,
+    };
+}
+//# sourceMappingURL=astro.fallback.js.map

package/dist/src/adapters/frontend/fallback/framework/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Built-in fallback templates for the frontends that ship their own
+ * toolchain (Next.js, Nuxt, SvelteKit, Astro, Angular), used when the
+ * official scaffolder cannot run.
+ *
+ * @module adapters/frontend/fallback/framework
+ */
+export { renderAngularFallback } from "./angular/index.js";
+export { renderAstroFallback } from "./astro.fallback.js";
+export { renderNextFallback } from "./next.fallback.js";
+export { renderNuxtFallback } from "./nuxt.fallback.js";
+export { renderSvelteKitFallback } from "./sveltekit.fallback.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/adapters/frontend/fallback/framework/index.js

@@ -0,0 +1,13 @@
+/**
+ * Built-in fallback templates for the frontends that ship their own
+ * toolchain (Next.js, Nuxt, SvelteKit, Astro, Angular), used when the
+ * official scaffolder cannot run.
+ *
+ * @module adapters/frontend/fallback/framework
+ */
+export { renderAngularFallback } from "./angular/index.js";
+export { renderAstroFallback } from "./astro.fallback.js";
+export { renderNextFallback } from "./next.fallback.js";
+export { renderNuxtFallback } from "./nuxt.fallback.js";
+export { renderSvelteKitFallback } from "./sveltekit.fallback.js";
+//# sourceMappingURL=index.js.map

package/dist/src/adapters/frontend/fallback/framework/next.fallback.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Built-in Next.js template, written when `create-next-app` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/next
+ */
+import type { FrontendGenerationContext } from "../../frontendAdapter.type.js";
+import { type FallbackFileTree } from "../fallback.helper.js";
+/**
+ * Renders the Next.js 16 App Router fallback project under `src/`, matching
+ * `create-next-app --typescript --app --src-dir`.
+ */
+export declare function renderNextFallback(context: FrontendGenerationContext): FallbackFileTree;
+//# sourceMappingURL=next.fallback.d.ts.map

package/dist/src/adapters/frontend/fallback/framework/next.fallback.js

@@ -0,0 +1,105 @@
+/**
+ * Built-in Next.js template, written when `create-next-app` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/next
+ */
+import { DEPENDENCY_VERSION_RANGES as V, TYPESCRIPT_VERSION_RANGES, } from "../../../../resolvers/dependency/dependencyVersions.constant.js";
+import { renderJsonFile } from "../fallback.helper.js";
+/**
+ * Renders the Next.js 16 App Router fallback project under `src/`, matching
+ * `create-next-app --typescript --app --src-dir`.
+ */
+export function renderNextFallback(context) {
+    return {
+        "package.json": renderJsonFile({
+            name: context.project.name,
+            version: "0.1.0",
+            private: true,
+            scripts: {
+                dev: "next dev",
+                build: "next build",
+                start: "next start",
+            },
+            dependencies: {
+                next: V.next,
+                react: V.react,
+                "react-dom": V["react-dom"],
+            },
+            devDependencies: {
+                typescript: TYPESCRIPT_VERSION_RANGES.frontend,
+                "@types/node": V["@types/node"],
+                "@types/react": V["@types/react"],
+                "@types/react-dom": V["@types/react-dom"],
+            },
+        }),
+        "next.config.ts": `import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+};
+
+export default nextConfig;
+`,
+        "tsconfig.json": renderJsonFile({
+            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: "react-jsx",
+                incremental: true,
+                plugins: [{ name: "next" }],
+                paths: { "@/*": ["./src/*"] },
+            },
+            include: [
+                "next-env.d.ts",
+                "**/*.ts",
+                "**/*.tsx",
+                ".next/types/**/*.ts",
+                ".next/dev/types/**/*.ts",
+                "**/*.mts",
+            ],
+            exclude: ["node_modules"],
+        }),
+        "src/app/layout.tsx": `import type { Metadata } from "next";
+import type { ReactNode } from "react";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: ${JSON.stringify(context.project.name)},
+  description: "Generated by Zudojs",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{ children: 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;
+}
+`,
+    };
+}
+//# sourceMappingURL=next.fallback.js.map

package/dist/src/adapters/frontend/fallback/framework/nuxt.fallback.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Built-in Nuxt template, written when `nuxi init` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/nuxt
+ */
+import type { FrontendGenerationContext } from "../../frontendAdapter.type.js";
+import { type FallbackFileTree } from "../fallback.helper.js";
+/**
+ * Renders the Nuxt 4 fallback project, matching `nuxi init --template
+ * minimal`: application code lives in `app/`, and the TypeScript project
+ * references point at the configs `nuxt prepare` generates in `.nuxt/`.
+ */
+export declare function renderNuxtFallback(context: FrontendGenerationContext): FallbackFileTree;
+//# sourceMappingURL=nuxt.fallback.d.ts.map

package/dist/src/adapters/frontend/fallback/framework/nuxt.fallback.js

@@ -0,0 +1,56 @@
+/**
+ * Built-in Nuxt template, written when `nuxi init` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/nuxt
+ */
+import { DEPENDENCY_VERSION_RANGES as V } from "../../../../resolvers/dependency/dependencyVersions.constant.js";
+import { renderJsonFile } from "../fallback.helper.js";
+/**
+ * Renders the Nuxt 4 fallback project, matching `nuxi init --template
+ * minimal`: application code lives in `app/`, and the TypeScript project
+ * references point at the configs `nuxt prepare` generates in `.nuxt/`.
+ */
+export function renderNuxtFallback(context) {
+    return {
+        "package.json": renderJsonFile({
+            name: context.project.name,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: {
+                build: "nuxt build",
+                dev: "nuxt dev",
+                generate: "nuxt generate",
+                preview: "nuxt preview",
+                postinstall: "nuxt prepare",
+            },
+            dependencies: {
+                nuxt: V.nuxt,
+                vue: V.vue,
+                "vue-router": V["vue-router"],
+            },
+        }),
+        "nuxt.config.ts": `// https://nuxt.com/docs/api/configuration/nuxt-config
+export default defineNuxtConfig({
+  compatibilityDate: "2025-07-15",
+  devtools: { enabled: true },
+});
+`,
+        "tsconfig.json": renderJsonFile({
+            files: [],
+            references: [
+                { path: "./.nuxt/tsconfig.app.json" },
+                { path: "./.nuxt/tsconfig.server.json" },
+                { path: "./.nuxt/tsconfig.shared.json" },
+                { path: "./.nuxt/tsconfig.node.json" },
+            ],
+        }),
+        "app/app.vue": `<template>
+  <div>
+    <h1>Hello from Zudojs</h1>
+  </div>
+</template>
+`,
+    };
+}
+//# sourceMappingURL=nuxt.fallback.js.map

package/dist/src/adapters/frontend/fallback/framework/sveltekit.fallback.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in SvelteKit template, written when `sv create` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/sveltekit
+ */
+import type { FrontendGenerationContext } from "../../frontendAdapter.type.js";
+import { type FallbackFileTree } from "../fallback.helper.js";
+/**
+ * Renders the SvelteKit fallback project, matching `sv create --template
+ * minimal --types ts`. The previous fallback had an `app.html` without the
+ * `%sveltekit.head%`/`%sveltekit.body%` placeholders and imported
+ * `@sveltejs/adapter-auto` without depending on it, so it could not build.
+ */
+export declare function renderSvelteKitFallback(context: FrontendGenerationContext): FallbackFileTree;
+//# sourceMappingURL=sveltekit.fallback.d.ts.map

package/dist/src/adapters/frontend/fallback/framework/sveltekit.fallback.js

@@ -0,0 +1,94 @@
+/**
+ * Built-in SvelteKit template, written when `sv create` cannot run.
+ *
+ * @module adapters/frontend/fallback/framework/sveltekit
+ */
+import { DEPENDENCY_VERSION_RANGES as V, TYPESCRIPT_VERSION_RANGES, } from "../../../../resolvers/dependency/dependencyVersions.constant.js";
+import { renderJsonFile } from "../fallback.helper.js";
+/**
+ * Renders the SvelteKit fallback project, matching `sv create --template
+ * minimal --types ts`. The previous fallback had an `app.html` without the
+ * `%sveltekit.head%`/`%sveltekit.body%` placeholders and imported
+ * `@sveltejs/adapter-auto` without depending on it, so it could not build.
+ */
+export function renderSvelteKitFallback(context) {
+    return {
+        "package.json": renderJsonFile({
+            name: context.project.name,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: {
+                dev: "vite dev",
+                build: "vite build",
+                preview: "vite preview",
+                prepare: "svelte-kit sync || echo ''",
+                check: "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+            },
+            devDependencies: {
+                "@sveltejs/adapter-auto": V["@sveltejs/adapter-auto"],
+                "@sveltejs/kit": V["@sveltejs/kit"],
+                "@sveltejs/vite-plugin-svelte": V["@sveltejs/vite-plugin-svelte"],
+                svelte: V.svelte,
+                "svelte-check": V["svelte-check"],
+                typescript: TYPESCRIPT_VERSION_RANGES.frontend,
+                vite: V.vite,
+            },
+        }),
+        "vite.config.ts": `import adapter from "@sveltejs/adapter-auto";
+import { sveltekit } from "@sveltejs/kit/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [sveltekit({ adapter: adapter() })],
+});
+`,
+        "tsconfig.json": renderJsonFile({
+            extends: "./.svelte-kit/tsconfig.json",
+            compilerOptions: {
+                rewriteRelativeImportExtensions: true,
+                allowJs: true,
+                checkJs: true,
+                esModuleInterop: true,
+                forceConsistentCasingInFileNames: true,
+                resolveJsonModule: true,
+                skipLibCheck: true,
+                sourceMap: true,
+                strict: true,
+                moduleResolution: "bundler",
+            },
+        }),
+        "src/app.html": `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>
+`,
+        "src/app.d.ts": `// See https://svelte.dev/docs/kit/types#app.d.ts
+declare global {
+  namespace App {}
+}
+
+export {};
+`,
+        "src/routes/+layout.svelte": `<script lang="ts">
+  let { children } = $props();
+</script>
+
+<svelte:head>
+  <title>${context.project.name}</title>
+</svelte:head>
+
+{@render children()}
+`,
+        "src/routes/+page.svelte": `<h1>Hello from Zudojs</h1>
+`,
+    };
+}
+//# sourceMappingURL=sveltekit.fallback.js.map

package/dist/src/adapters/frontend/fallback/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Built-in fallback templates the frontend adapters write when the
+ * framework's official scaffolder cannot run (offline, registry errors,
+ * timeouts). Every dependency range they write comes from
+ * `resolvers/dependency/dependencyVersions.constant.ts`.
+ *
+ * @module adapters/frontend/fallback
+ */
+export { renderJsonFile, renderViteIndexHtml, versionFromRange, VITE_TSCONFIG_COMPILER_OPTIONS, type FallbackFileTree, } from "./fallback.helper.js";
+export { renderAngularFallback, renderAstroFallback, renderNextFallback, renderNuxtFallback, renderSvelteKitFallback, } from "./framework/index.js";
+export { renderReactFallback, renderSvelteFallback, renderVanillaFallback, renderVueFallback, } from "./vite/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/adapters/frontend/fallback/index.js

@@ -0,0 +1,12 @@
+/**
+ * Built-in fallback templates the frontend adapters write when the
+ * framework's official scaffolder cannot run (offline, registry errors,
+ * timeouts). Every dependency range they write comes from
+ * `resolvers/dependency/dependencyVersions.constant.ts`.
+ *
+ * @module adapters/frontend/fallback
+ */
+export { renderJsonFile, renderViteIndexHtml, versionFromRange, VITE_TSCONFIG_COMPILER_OPTIONS, } from "./fallback.helper.js";
+export { renderAngularFallback, renderAstroFallback, renderNextFallback, renderNuxtFallback, renderSvelteKitFallback, } from "./framework/index.js";
+export { renderReactFallback, renderSvelteFallback, renderVanillaFallback, renderVueFallback, } from "./vite/index.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,11 @@
+/**
+ * Built-in fallback templates for the Vite-based frontends (React, Vue,
+ * Svelte, vanilla), used when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite
+ */
+export { renderReactFallback } from "./react.fallback.js";
+export { renderSvelteFallback } from "./svelte.fallback.js";
+export { renderVanillaFallback } from "./vanilla.fallback.js";
+export { renderVueFallback } from "./vue.fallback.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,11 @@
+/**
+ * Built-in fallback templates for the Vite-based frontends (React, Vue,
+ * Svelte, vanilla), used when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite
+ */
+export { renderReactFallback } from "./react.fallback.js";
+export { renderSvelteFallback } from "./svelte.fallback.js";
+export { renderVanillaFallback } from "./vanilla.fallback.js";
+export { renderVueFallback } from "./vue.fallback.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,13 @@
+/**
+ * Built-in React + Vite template, written when `create-vite` cannot run.
+ *
+ * @module adapters/frontend/fallback/vite/react
+ */
+import type { FrontendGenerationContext } from "../../frontendAdapter.type.js";
+import { type FallbackFileTree } from "../fallback.helper.js";
+/**
+ * Renders the React fallback project, mirroring `create-vite`'s `react-ts`
+ * (or `react`) template.
+ */
+export declare function renderReactFallback(context: FrontendGenerationContext): FallbackFileTree;
+//# sourceMappingURL=react.fallback.d.ts.map