beaver-build 1.0.0

package/dist/index.js

@@ -0,0 +1,1920 @@
+#!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/constants/index.ts
+var MENU_OPTIONS_LEVEL_1;
+var init_constants = __esm({
+  "src/constants/index.ts"() {
+    "use strict";
+    MENU_OPTIONS_LEVEL_1 = {
+      ReactVite: {
+        display: "React + Vite",
+        value: "REACT_VITE",
+        description: "React 19 + Vite",
+        disabled: false
+      },
+      NextJS: {
+        display: "Next.js",
+        value: "NEXTJS",
+        description: "Next 15",
+        disabled: true
+      },
+      ChromeExtension: {
+        display: "Chrome Extension",
+        value: "CHROME_EXTENSION",
+        description: "React 19 + Vite (Manifest v3)",
+        disabled: false
+      },
+      Nuxt: {
+        display: "Nuxt",
+        value: "NUXT",
+        description: "Upcoming...",
+        disabled: true
+      }
+    };
+  }
+});
+
+// src/options/react-vite/constants/index.ts
+var REACT_MENU_LAYOUT, REACT_MENU_ROUTER, REACT_MENU_STATE_MANAGEMENT, REACT_MENU_QUERY, REACT_MENU_CSS, REACT_MENU_LINTER;
+var init_constants2 = __esm({
+  "src/options/react-vite/constants/index.ts"() {
+    "use strict";
+    REACT_MENU_LAYOUT = {
+      FSD: {
+        display: "FSD",
+        value: "FSD",
+        description: "Feature slice design",
+        disabled: false
+      },
+      BPR: {
+        display: "BPR",
+        value: "BPR",
+        description: "Bulletproof React",
+        disabled: false
+      }
+    };
+    REACT_MENU_ROUTER = {
+      notUsing: {
+        display: "Not Using",
+        value: "NOT_USING",
+        description: "Not using any router",
+        disabled: false
+      },
+      tanstack: {
+        display: "TanStack Router",
+        value: "TANSTACK_ROUTER",
+        description: "TanStack Router v1.144.0",
+        disabled: false
+      }
+    };
+    REACT_MENU_STATE_MANAGEMENT = {
+      notUsing: {
+        display: "Not Using",
+        value: "NOT_USING",
+        description: "Not using any state management",
+        disabled: false
+      },
+      zustand: {
+        display: "Zustand",
+        value: "ZUSTAND",
+        description: "Zustand state management",
+        disabled: false
+      }
+    };
+    REACT_MENU_QUERY = {
+      notUsing: {
+        display: "Not Using",
+        value: "NOT_USING",
+        description: "No data fetching library",
+        disabled: false
+      },
+      tanstackQuery: {
+        display: "TanStack Query",
+        value: "TANSTACK_QUERY",
+        description: "Server state management (v5.74.4)",
+        disabled: false
+      }
+    };
+    REACT_MENU_CSS = {
+      notUsing: {
+        display: "Not Using",
+        value: "NOT_USING",
+        description: "No CSS framework",
+        disabled: false
+      },
+      tailwind: {
+        display: "Tailwind CSS",
+        value: "TAILWIND",
+        description: "Tailwind CSS v4.1.3 (Vite plugin, zero-config)",
+        disabled: false
+      }
+    };
+    REACT_MENU_LINTER = {
+      notUsing: {
+        display: "Not Using",
+        value: "NOT_USING",
+        description: "No linter/formatter",
+        disabled: false
+      },
+      biome: {
+        display: "Biome",
+        value: "BIOME",
+        description: "Fast all-in-one: lint + format (v1.9.4)",
+        disabled: false
+      },
+      eslint: {
+        display: "ESLint",
+        value: "ESLINT",
+        description: "ESLint v9 (flat config) + typescript-eslint",
+        disabled: false
+      }
+    };
+  }
+});
+
+// src/scaffold/utils.ts
+import fs from "fs/promises";
+import path from "path";
+var dirExists, writeProjectFile;
+var init_utils = __esm({
+  "src/scaffold/utils.ts"() {
+    "use strict";
+    dirExists = async (dirPath) => {
+      try {
+        const stat = await fs.stat(dirPath);
+        return stat.isDirectory();
+      } catch {
+        return false;
+      }
+    };
+    writeProjectFile = async (projectRoot, relativePath, content) => {
+      const fullPath = path.join(projectRoot, relativePath);
+      await fs.mkdir(path.dirname(fullPath), { recursive: true });
+      await fs.writeFile(fullPath, content, "utf-8");
+    };
+  }
+});
+
+// src/scaffold/errors.ts
+var ScaffoldError, isNodeError;
+var init_errors = __esm({
+  "src/scaffold/errors.ts"() {
+    "use strict";
+    ScaffoldError = class extends Error {
+      constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = "ScaffoldError";
+      }
+    };
+    isNodeError = (e) => e instanceof Error && "code" in e;
+  }
+});
+
+// src/scaffold/react-vite/templates/package-json.ts
+var packageJsonTemplate;
+var init_package_json = __esm({
+  "src/scaffold/react-vite/templates/package-json.ts"() {
+    "use strict";
+    packageJsonTemplate = (cart) => {
+      const deps = {
+        react: "19.1.0",
+        "react-dom": "19.1.0"
+      };
+      if (cart.router === "TANSTACK_ROUTER") {
+        deps["@tanstack/react-router"] = "1.144.0";
+      }
+      if (cart.stateManagement === "ZUSTAND") {
+        deps["zustand"] = "5.0.5";
+      }
+      if (cart.query === "TANSTACK_QUERY") {
+        deps["@tanstack/react-query"] = "5.74.4";
+        deps["@tanstack/react-query-devtools"] = "5.74.4";
+      }
+      const devDeps = {
+        "@types/react": "19.1.1",
+        "@types/react-dom": "19.1.1",
+        "@vitejs/plugin-react": "4.4.1",
+        typescript: "5.8.3",
+        vite: "6.3.1"
+      };
+      if (cart.router === "TANSTACK_ROUTER") {
+        devDeps["@tanstack/router-devtools"] = "1.144.0";
+        devDeps["@tanstack/router-vite-plugin"] = "1.144.0";
+      }
+      if (cart.css === "TAILWIND") {
+        devDeps["@tailwindcss/vite"] = "4.1.3";
+        devDeps["tailwindcss"] = "4.1.3";
+      }
+      if (cart.linter === "BIOME") {
+        devDeps["@biomejs/biome"] = "1.9.4";
+      } else if (cart.linter === "ESLINT") {
+        devDeps["@eslint/js"] = "9.22.0";
+        devDeps["eslint"] = "9.22.0";
+        devDeps["eslint-plugin-react-hooks"] = "5.2.0";
+        devDeps["eslint-plugin-react-refresh"] = "0.4.19";
+        devDeps["globals"] = "15.15.0";
+        devDeps["typescript-eslint"] = "8.26.0";
+      }
+      const scripts = {
+        dev: "vite",
+        build: "tsc && vite build",
+        preview: "vite preview"
+      };
+      if (cart.linter === "BIOME") {
+        scripts["lint"] = "biome check .";
+        scripts["format"] = "biome format --write .";
+      } else if (cart.linter === "ESLINT") {
+        scripts["lint"] = "eslint .";
+      }
+      return JSON.stringify(
+        {
+          name: cart.projectName,
+          private: true,
+          version: "0.0.0",
+          type: "module",
+          scripts,
+          dependencies: deps,
+          devDependencies: devDeps
+        },
+        null,
+        2
+      );
+    };
+  }
+});
+
+// src/scaffold/react-vite/templates/vite-config.ts
+var viteConfigTemplate;
+var init_vite_config = __esm({
+  "src/scaffold/react-vite/templates/vite-config.ts"() {
+    "use strict";
+    viteConfigTemplate = (cart) => {
+      const hasTanstack = cart.router === "TANSTACK_ROUTER";
+      const hasTailwind = cart.css === "TAILWIND";
+      const tailwindImport = hasTailwind ? `import tailwindcss from '@tailwindcss/vite';
+` : "";
+      const tanstackImport = hasTanstack ? `import { TanStackRouterVite } from '@tanstack/router-vite-plugin';
+` : "";
+      const tailwindPlugin = hasTailwind ? `
+    tailwindcss(),` : "";
+      const tanstackPlugin = hasTanstack ? `
+    TanStackRouterVite({ routesDirectory: './src/routes' }),` : "";
+      return `import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+${tailwindImport}${tanstackImport}
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [
+    react(),${tailwindPlugin}${tanstackPlugin}
+  ],
+});
+`;
+    };
+  }
+});
+
+// src/scaffold/react-vite/templates/tsconfig.ts
+var tsconfigTemplate, tsconfigNodeTemplate;
+var init_tsconfig = __esm({
+  "src/scaffold/react-vite/templates/tsconfig.ts"() {
+    "use strict";
+    tsconfigTemplate = () => JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2020",
+          useDefineForClassFields: true,
+          lib: ["ES2020", "DOM", "DOM.Iterable"],
+          module: "ESNext",
+          skipLibCheck: true,
+          moduleResolution: "bundler",
+          allowImportingTsExtensions: true,
+          resolveJsonModule: true,
+          isolatedModules: true,
+          noEmit: true,
+          jsx: "react-jsx",
+          strict: true,
+          noUnusedLocals: true,
+          noUnusedParameters: true,
+          noFallthroughCasesInSwitch: true
+        },
+        include: ["src"],
+        references: [{ path: "./tsconfig.node.json" }]
+      },
+      null,
+      2
+    );
+    tsconfigNodeTemplate = () => JSON.stringify(
+      {
+        compilerOptions: {
+          composite: true,
+          skipLibCheck: true,
+          module: "ESNext",
+          moduleResolution: "bundler",
+          allowSyntheticDefaultImports: true,
+          strict: true
+        },
+        include: ["vite.config.ts"]
+      },
+      null,
+      2
+    );
+  }
+});
+
+// src/scaffold/react-vite/templates/index-html.ts
+var indexHtmlTemplate;
+var init_index_html = __esm({
+  "src/scaffold/react-vite/templates/index-html.ts"() {
+    "use strict";
+    indexHtmlTemplate = (projectName) => `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${projectName}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`;
+  }
+});
+
+// src/scaffold/react-vite/templates/main-tsx.ts
+var mainTsxFsd, mainTsxBpr, mainTsxTemplate;
+var init_main_tsx = __esm({
+  "src/scaffold/react-vite/templates/main-tsx.ts"() {
+    "use strict";
+    mainTsxFsd = (hasTailwind) => `import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+${hasTailwind ? "import './index.css';\n" : ""}import { App } from './app';
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);
+`;
+    mainTsxBpr = (hasTailwind) => `import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+${hasTailwind ? "import './index.css';\n" : ""}import App from './App';
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);
+`;
+    mainTsxTemplate = (cart) => {
+      const hasTailwind = cart.css === "TAILWIND";
+      return cart.layout === "FSD" ? mainTsxFsd(hasTailwind) : mainTsxBpr(hasTailwind);
+    };
+  }
+});
+
+// src/scaffold/react-vite/templates/app-tsx.ts
+var appTsxFsdTemplate, appTsxBprTemplate;
+var init_app_tsx = __esm({
+  "src/scaffold/react-vite/templates/app-tsx.ts"() {
+    "use strict";
+    appTsxFsdTemplate = (hasRouter, hasQuery) => {
+      const queryImports = hasQuery ? `import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { ReactQueryDevtools } from '@tanstack/react-query-devtools';
+` : "";
+      const queryClientDef = hasQuery ? `
+const queryClient = new QueryClient();
+` : "";
+      const routerImports = hasRouter ? `import { RouterProvider, createRouter } from '@tanstack/react-router';
+import { routeTree } from '../routes/routeTree.gen';
+
+const router = createRouter({ routeTree });
+
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: typeof router;
+  }
+}
+` : "";
+      const inner = hasRouter ? `<RouterProvider router={router} />` : `<div>
+      <h1>Hello from FSD</h1>
+    </div>`;
+      if (hasQuery) {
+        return `${queryImports}${routerImports}${queryClientDef}
+export const App = () => {
+  return (
+    <QueryClientProvider client={queryClient}>
+      ${inner}
+      <ReactQueryDevtools initialIsOpen={false} />
+    </QueryClientProvider>
+  );
+};
+`;
+      }
+      if (hasRouter) {
+        return `${routerImports}
+export const App = () => {
+  return <RouterProvider router={router} />;
+};
+`;
+      }
+      return `export const App = () => {
+  return (
+    <div>
+      <h1>Hello from FSD</h1>
+    </div>
+  );
+};
+`;
+    };
+    appTsxBprTemplate = (hasRouter, hasQuery) => {
+      const providerImport = hasQuery ? `import { AppProvider } from './providers';
+` : "";
+      const routerImports = hasRouter ? `import { RouterProvider, createRouter } from '@tanstack/react-router';
+import { routeTree } from './routes/routeTree.gen';
+
+const router = createRouter({ routeTree });
+
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: typeof router;
+  }
+}
+` : "";
+      const inner = hasRouter ? `<RouterProvider router={router} />` : `<div>
+      <h1>Hello from Bulletproof React</h1>
+    </div>`;
+      const body = hasQuery ? `<AppProvider>
+      ${inner}
+    </AppProvider>` : inner;
+      return `${providerImport}${routerImports}
+const App = () => {
+  return (
+    ${body}
+  );
+};
+
+export default App;
+`;
+    };
+  }
+});
+
+// src/scaffold/react-vite/templates/router.ts
+var rootRouteTemplate, indexRouteTemplate;
+var init_router = __esm({
+  "src/scaffold/react-vite/templates/router.ts"() {
+    "use strict";
+    rootRouteTemplate = () => `import { createRootRoute, Outlet } from '@tanstack/react-router';
+import { TanStackRouterDevtools } from '@tanstack/router-devtools';
+
+export const Route = createRootRoute({
+  component: () => (
+    <>
+      <Outlet />
+      <TanStackRouterDevtools />
+    </>
+  ),
+});
+`;
+    indexRouteTemplate = () => `import { createFileRoute } from '@tanstack/react-router';
+
+export const Route = createFileRoute('/')({
+  component: Index,
+});
+
+function Index() {
+  return (
+    <div>
+      <h3>Welcome Home!</h3>
+    </div>
+  );
+}
+`;
+  }
+});
+
+// src/scaffold/react-vite/templates/zustand.ts
+var zustandStoreTemplate;
+var init_zustand = __esm({
+  "src/scaffold/react-vite/templates/zustand.ts"() {
+    "use strict";
+    zustandStoreTemplate = () => `import { create } from 'zustand';
+
+interface AppState {
+  count: number;
+  increment: () => void;
+  decrement: () => void;
+  reset: () => void;
+}
+
+export const useAppStore = create<AppState>((set) => ({
+  count: 0,
+  increment: () => set((state) => ({ count: state.count + 1 })),
+  decrement: () => set((state) => ({ count: state.count - 1 })),
+  reset: () => set({ count: 0 }),
+}));
+`;
+  }
+});
+
+// src/scaffold/react-vite/templates/linter.ts
+var biomeConfigTemplate, eslintConfigTemplate;
+var init_linter = __esm({
+  "src/scaffold/react-vite/templates/linter.ts"() {
+    "use strict";
+    biomeConfigTemplate = () => JSON.stringify(
+      {
+        $schema: "https://biomejs.dev/schemas/1.9.4/schema.json",
+        organizeImports: { enabled: true },
+        linter: {
+          enabled: true,
+          rules: { recommended: true }
+        },
+        formatter: {
+          enabled: true,
+          indentStyle: "space",
+          indentWidth: 2
+        },
+        javascript: {
+          formatter: { quoteStyle: "single" }
+        }
+      },
+      null,
+      2
+    );
+    eslintConfigTemplate = () => `import js from '@eslint/js';
+import globals from 'globals';
+import reactHooks from 'eslint-plugin-react-hooks';
+import reactRefresh from 'eslint-plugin-react-refresh';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  { ignores: ['dist'] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+    plugins: {
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': ['warn', { allowConstantExport: true }],
+    },
+  },
+);
+`;
+  }
+});
+
+// src/scaffold/react-vite/templates/gitignore.ts
+var gitignoreTemplate;
+var init_gitignore = __esm({
+  "src/scaffold/react-vite/templates/gitignore.ts"() {
+    "use strict";
+    gitignoreTemplate = () => `# Logs
+logs
+*.log
+npm-debug.log*
+
+# Dependencies
+node_modules/
+dist/
+dist-ssr/
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+`;
+  }
+});
+
+// src/scaffold/react-vite/templates/styles.ts
+var stylesCssTemplate;
+var init_styles = __esm({
+  "src/scaffold/react-vite/templates/styles.ts"() {
+    "use strict";
+    stylesCssTemplate = () => `@import "tailwindcss";
+`;
+  }
+});
+
+// src/scaffold/react-vite/templates/vite-env-d-ts.ts
+var viteEnvDtsTemplate;
+var init_vite_env_d_ts = __esm({
+  "src/scaffold/react-vite/templates/vite-env-d-ts.ts"() {
+    "use strict";
+    viteEnvDtsTemplate = () => `/// <reference types="vite/client" />
+
+declare module '*.css' {
+  const content: string;
+  export default content;
+}
+`;
+  }
+});
+
+// src/scaffold/react-vite/templates/copilot-instructions.ts
+var FSD_PATHS, BPR_PATHS, frontmatter, generalTemplate, componentsTemplate, hooksTemplate, routerTemplate, zustandTemplate, queryTemplate, tailwindTemplate, linterTemplate, getCopilotInstructionFiles;
+var init_copilot_instructions = __esm({
+  "src/scaffold/react-vite/templates/copilot-instructions.ts"() {
+    "use strict";
+    FSD_PATHS = {
+      components: "src/**/ui/**/*.tsx,src/shared/ui/**/*.tsx",
+      hooks: "src/**/model/**/*.ts,src/**/lib/**/*.ts",
+      stores: "src/shared/lib/store.ts,src/**/model/**/*.ts",
+      apis: "src/**/api/**/*.ts",
+      routes: "src/routes/**/*.tsx"
+    };
+    BPR_PATHS = {
+      components: "src/components/**/*.tsx,src/features/*/components/**/*.tsx",
+      hooks: "src/hooks/**/*.ts,src/features/*/hooks/**/*.ts",
+      stores: "src/stores/**/*.ts,src/features/*/stores/**/*.ts",
+      apis: "src/features/*/api/**/*.ts,src/lib/**/*.ts",
+      routes: "src/routes/**/*.tsx"
+    };
+    frontmatter = (applyTo) => `---
+applyTo: "${applyTo}"
+---
+
+`;
+    generalTemplate = (cart) => {
+      const isFsd = cart.layout === "FSD";
+      const stackLines = [
+        "- React 19 + Vite 6 + TypeScript 5",
+        `- Architecture: ${isFsd ? "Feature-Sliced Design (FSD)" : "Bulletproof React (BPR)"}`,
+        cart.router === "TANSTACK_ROUTER" ? "- Routing: TanStack Router (file-based)" : "- Routing: none",
+        cart.stateManagement === "ZUSTAND" ? "- State: Zustand" : "- State: local React state only",
+        cart.query === "TANSTACK_QUERY" ? "- Server state: TanStack Query" : "- Server state: none",
+        cart.css === "TAILWIND" ? "- CSS: Tailwind CSS v4.1.3 (Vite plugin, `src/index.css`)" : "- CSS: plain CSS",
+        cart.linter === "BIOME" ? "- Linter/formatter: Biome (`biome.json`)" : cart.linter === "ESLINT" ? "- Linter: ESLint (`eslint.config.js`)" : "- Linter: none"
+      ].join("\n");
+      const layoutBlock = isFsd ? `## Architecture \u2014 Feature-Sliced Design
+
+Layer order (top \u2192 bottom): \`app \u2192 pages \u2192 widgets \u2192 features \u2192 entities \u2192 shared\`.
+A layer may only import from layers **below** it. Never import from \`features\` inside \`shared\`, never import from \`pages\` inside \`widgets\`, and so on.
+
+Inside every slice, only these segments are allowed \u2014 do not invent new ones:
+
+- \`ui/\` \u2014 React components for the slice
+- \`model/\` \u2014 state, hooks, selectors, slice-local types
+- \`api/\` \u2014 network calls, request/response types
+- \`lib/\` \u2014 pure helpers specific to the slice
+- \`config/\` \u2014 constants, enums
+
+Where new code belongs:
+
+- Reusable primitive (Button, Input) \u2192 \`src/shared/ui/<Name>/\`
+- Cross-cutting helper \u2192 \`src/shared/lib/\`
+- Domain model (User, Post) \u2192 \`src/entities/<name>/\`
+- User-facing interaction (LoginForm) \u2192 \`src/features/<name>/\`
+- Composition of features \u2192 \`src/widgets/<name>/\`
+- Page-level composition \u2192 \`src/pages/<name>/ui/<Name>Page.tsx\` with \`src/pages/<name>/index.ts\` barrel
+
+Pages **compose** widgets/features \u2014 no business logic inside \`pages/*/ui\`.
+` : `## Architecture \u2014 Bulletproof React
+
+Global, cross-feature folders directly under \`src/\`:
+
+- \`components/\` \u2014 app-wide reusable UI primitives. No feature-specific UI.
+- \`hooks/\` \u2014 hooks used by more than one feature.
+- \`utils/\` \u2014 pure, framework-agnostic helpers.
+- \`lib/\` \u2014 configured third-party clients (axios, dayjs).
+- \`types/\` \u2014 types shared across features.
+- \`config/\` \u2014 env readers, constants, feature flags.
+- \`stores/\` \u2014 global stores.
+- \`providers/\` \u2014 root-level providers. \`providers/index.tsx\` wraps the tree \u2014 compose new providers there.
+
+Feature-scoped code lives under \`src/features/<feature>/\` with its own \`components/\`, \`hooks/\`, \`api/\`, \`stores/\`, \`types/\`, \`utils/\`.
+
+Rule of thumb: if only one feature uses it, it stays inside that feature. Promote to \`src/\` only when a second feature needs it.
+`;
+      return `# Copilot Instructions \u2014 ${cart.projectName}
+
+These are the project-wide conventions GitHub Copilot must follow. Match the structure below exactly \u2014 do not invent new top-level folders.
+
+Path-specific rules live in \`.github/instructions/*.instructions.md\` \u2014 those files apply automatically to the files their \`applyTo\` glob matches.
+
+## Stack
+${stackLines}
+
+## Naming conventions
+
+- **Components**: \`PascalCase.tsx\`, one component per file, named export (no default).
+- **Hooks**: \`useXxx.ts\`, camelCase, named export, must start with \`use\`.
+- **Stores** (Zustand): camelCase ending in \`Store.ts\` (e.g. \`authStore.ts\`). Export a typed hook, never the raw store.
+- **Types / interfaces**: PascalCase, in \`*.types.ts\` or inline when used in one file only.
+- **Constants**: \`UPPER_SNAKE_CASE\`, grouped in \`constants.ts\` per slice/feature.
+- **Utility functions**: camelCase, one concern per file, named exports.
+
+${layoutBlock}
+## When unsure
+
+Open the closest existing file of the same kind and match its location, casing, and export style.
+`;
+    };
+    componentsTemplate = (cart) => {
+      const paths = cart.layout === "FSD" ? FSD_PATHS : BPR_PATHS;
+      const placement = cart.layout === "FSD" ? `- Reusable primitives (Button, Input, Modal) \u2192 \`src/shared/ui/<Name>/<Name>.tsx\`.
+- Slice-specific components \u2192 \`src/<layer>/<slice>/ui/<Name>.tsx\`.
+- Never put a component directly under \`src/pages/<name>/\` \u2014 use \`src/pages/<name>/ui/\`.` : `- App-wide reusable UI \u2192 \`src/components/<Name>/<Name>.tsx\`.
+- Feature-specific UI \u2192 \`src/features/<feature>/components/<Name>.tsx\`.
+- Do **not** put feature-specific components under \`src/components\`.`;
+      return frontmatter(paths.components) + `# React components
+
+- File name matches the component name exactly: \`UserCard.tsx\` exports \`UserCard\`.
+- One component per file. Named export only \u2014 never \`export default\`.
+- Functional components with TypeScript props interface named \`<Name>Props\`, defined in the same file unless reused.
+- Keep JSX return focused. Extract sub-trees into smaller components when the return exceeds ~60 lines.
+- Hooks run at the top of the component body, before any conditional return.
+- No business logic in components \u2014 delegate to hooks, stores, or query functions.
+- Co-locate component-scoped styles, stories, and tests next to the component file.
+
+## Where to place a new component
+
+${placement}
+`;
+    };
+    hooksTemplate = (cart) => {
+      const paths = cart.layout === "FSD" ? FSD_PATHS : BPR_PATHS;
+      const placement = cart.layout === "FSD" ? `- Slice-specific hook \u2192 \`src/<layer>/<slice>/model/useXxx.ts\` (stateful) or \`src/<layer>/<slice>/lib/useXxx.ts\` (pure helper).
+- Reusable across slices \u2192 \`src/shared/lib/useXxx.ts\`.` : `- Cross-feature hook \u2192 \`src/hooks/useXxx.ts\`.
+- Feature-specific hook \u2192 \`src/features/<feature>/hooks/useXxx.ts\`.`;
+      return frontmatter(paths.hooks) + `# Custom hooks
+
+- File name starts with \`use\` and matches the exported hook: \`useDebouncedValue.ts\` exports \`useDebouncedValue\`.
+- One hook per file. Named export only.
+- Must call other hooks \u2014 if a function does not use any hook, it is a utility, not a hook.
+- Return either a tuple \`[value, setter]\` or an object with named fields. Do not mix patterns within one hook.
+- Keep hooks focused on one concern. Compose multiple hooks rather than building a single large one.
+- Do not call hooks conditionally. Do not rename destructured return values unless renaming makes usage clearer.
+
+## Where to place a new hook
+
+${placement}
+`;
+    };
+    routerTemplate = (cart) => {
+      const paths = cart.layout === "FSD" ? FSD_PATHS : BPR_PATHS;
+      return frontmatter(paths.routes) + `# TanStack Router (file-based)
+
+- Every file in \`src/routes/\` is a route. Do not create unrelated helper files here.
+- Root layout lives in \`src/routes/__root.tsx\` \u2014 wrap \`<Outlet />\` with app-wide chrome (header, devtools, providers that need router context).
+- Leaf routes use \`createFileRoute('/path')\` and export \`Route\`. File name matches the URL segment.
+- Dynamic segments use \`$param\` file names: \`src/routes/posts/$postId.tsx\`.
+- Co-locate the route's \`loader\`, \`beforeLoad\`, and \`component\` in the same file. Push heavy logic into hooks / query functions imported from the feature folder.
+- **Never edit \`src/routes/routeTree.gen.ts\`** \u2014 it is regenerated on dev/build.
+- Internal navigation uses \`<Link to="..." />\` from \`@tanstack/react-router\`. Do not use \`<a href>\` for in-app links.
+- Type-safe search params: declare them in the route's \`validateSearch\` and read via \`Route.useSearch()\`.
+`;
+    };
+    zustandTemplate = (cart) => {
+      const paths = cart.layout === "FSD" ? FSD_PATHS : BPR_PATHS;
+      const initialPath = cart.layout === "FSD" ? "src/shared/lib/store.ts" : "src/stores/appStore.ts";
+      const newStorePath = cart.layout === "FSD" ? "- New global store \u2192 `src/shared/lib/<name>Store.ts`.\n- Entity-owned store \u2192 `src/entities/<name>/model/store.ts`." : "- New global store \u2192 `src/stores/<name>Store.ts`.\n- Feature-scoped store \u2192 `src/features/<feature>/stores/<name>Store.ts`.";
+      return frontmatter(paths.stores) + `# Zustand stores
+
+- Initial store lives at \`${initialPath}\`.
+- One slice per concern \u2014 never pile unrelated state into a single store.
+- Export a **typed hook** (e.g. \`useAuthStore\`). Never export the raw store object or the \`create\` result directly.
+- Use selectors at call sites to read only what you need: \`const user = useAuthStore(s => s.user)\`. This avoids re-rendering on unrelated state changes.
+- Derived values belong in selectors, not inside the store.
+- Async actions go inside the store definition. They read/write state via \`set\` / \`get\`.
+- Shape a store as \`{ ...state, ...actions }\`. Actions are methods, not separate exports.
+- For cross-slice reads, use individual selectors \u2014 do not merge stores.
+
+## Where to place a new store
+
+${newStorePath}
+`;
+    };
+    queryTemplate = (cart) => {
+      const paths = cart.layout === "FSD" ? FSD_PATHS : BPR_PATHS;
+      const keysPath = cart.layout === "FSD" ? `- Query keys, query functions, and hooks live in \`src/<layer>/<slice>/api/\`:
+  - \`keys.ts\` \u2014 exported query key factories
+  - \`queries.ts\` \u2014 \`useXxxQuery\` / \`useXxxMutation\` hooks wrapping \`useQuery\` / \`useMutation\`` : `- Query keys, query functions, and hooks live in \`src/features/<feature>/api/\`:
+  - \`keys.ts\` \u2014 exported query key factories
+  - \`queries.ts\` \u2014 \`useXxxQuery\` / \`useXxxMutation\` hooks wrapping \`useQuery\` / \`useMutation\``;
+      return frontmatter(paths.apis) + `# TanStack Query
+
+- A single \`QueryClient\` is already instantiated in the root provider. Do **not** create additional clients.
+- Do not call \`useQuery\` / \`useMutation\` directly in leaf components unless the component is a page-level container. Wrap them in a hook inside the feature/slice.
+
+## Query keys
+
+- Use a **query key factory** per feature/slice \u2014 do not scatter string literals.
+- Factory shape: \`export const postKeys = { all: ['posts'] as const, list: (f) => [...postKeys.all, 'list', f] as const, detail: (id) => [...postKeys.all, 'detail', id] as const };\`
+- Invalidate via the factory: \`queryClient.invalidateQueries({ queryKey: postKeys.all })\`.
+
+## Query functions
+
+- Query functions return parsed, typed data \u2014 no raw \`Response\`. Throw on non-2xx.
+- Mutations invalidate relevant keys in \`onSuccess\`; never manually refetch by calling queries.
+- Prefer \`select\` for view-model transforms so the cached data stays normalized.
+
+## Where to place queries
+
+${keysPath}
+`;
+    };
+    tailwindTemplate = (cart) => {
+      const paths = cart.layout === "FSD" ? FSD_PATHS : BPR_PATHS;
+      return frontmatter(paths.components) + `# Tailwind CSS v4
+
+> **This project uses Tailwind CSS v4.** v4 removes \`tailwind.config.js\` entirely.
+> All theme customization is done inside \`src/index.css\` using the \`@theme\` directive.
+> Do NOT create or reference \`tailwind.config.js\`, \`tailwind.config.ts\`, or \`postcss.config.*\`.
+
+## Entry point
+
+\`src/index.css\` is the single Tailwind entry point \u2014 the only file that contains \`@import "tailwindcss"\`.
+Import it once in \`src/main.tsx\`. Do not add additional Tailwind imports elsewhere.
+
+## Using utilities
+
+- Use Tailwind utility classes directly in JSX \`className\`. Do not write custom CSS for layout or spacing that a utility already covers.
+- Prefer composing utilities over \`@apply\`. Only use \`@apply\` inside \`@layer components\` or \`@layer base\` in \`src/index.css\`, never in component files.
+- Do not use inline \`style={{}}\` for values that a Tailwind utility can express.
+- Responsive variants go smallest \u2192 largest: \`sm:\`, \`md:\`, \`lg:\`, \`xl:\`, \`2xl:\`.
+- Dark mode: use the \`dark:\` variant. Do not add a separate CSS file or a manual class toggle.
+
+## Theme customization \u2014 colors, spacing, and CSS variables
+
+All design tokens live in \`src/index.css\` under the \`@theme\` block, **not** in a config file.
+
+### Adding custom colors
+
+\`\`\`css
+@import "tailwindcss";
+
+@theme {
+  --color-brand: oklch(0.55 0.22 265);
+  --color-brand-light: oklch(0.72 0.14 265);
+  --color-brand-dark: oklch(0.38 0.22 265);
+}
+\`\`\`
+
+This generates \`bg-brand\`, \`text-brand\`, \`border-brand\`, \`fill-brand\`, etc. automatically.
+
+### Namespace \u2192 utility mapping (do not invent names outside these namespaces)
+
+| CSS variable | Generated utilities |
+|---|---|
+| \`--color-*\` | \`bg-*\`, \`text-*\`, \`border-*\`, \`fill-*\`, \`stroke-*\` |
+| \`--font-*\` | \`font-*\` (font family) |
+| \`--text-*\` | \`text-*\` (font size) |
+| \`--font-weight-*\` | \`font-*\` (weight) |
+| \`--spacing-*\` | \`p-*\`, \`m-*\`, \`w-*\`, \`h-*\`, \`gap-*\`, etc. |
+| \`--radius-*\` | \`rounded-*\` |
+| \`--shadow-*\` | \`shadow-*\` |
+| \`--breakpoint-*\` | responsive variants (\`sm:\`, \`md:\`, \u2026) |
+| \`--animate-*\` | \`animate-*\` |
+
+### Extending vs. replacing defaults
+
+**Extend** (keep defaults, add yours):
+\`\`\`css
+@theme {
+  --color-tahiti: #3ab7bf;   /* new color, defaults kept */
+}
+\`\`\`
+
+**Replace an entire namespace** (remove all defaults in that group):
+\`\`\`css
+@theme {
+  --color-*: initial;        /* wipe default palette */
+  --color-white: #fff;
+  --color-primary: oklch(0.55 0.22 265);
+}
+\`\`\`
+
+**Replace everything** (no defaults at all):
+\`\`\`css
+@theme {
+  --*: initial;
+  --spacing: 4px;
+  --color-primary: oklch(0.55 0.22 265);
+}
+\`\`\`
+
+### Variables that reference other variables
+
+Use \`@theme inline\` when a token references another CSS variable:
+\`\`\`css
+@theme inline {
+  --font-sans: var(--font-inter);   /* resolves the value, not the reference */
+}
+\`\`\`
+
+### Regular CSS variables vs. theme tokens
+
+- \`@theme { --color-brand: \u2026 }\` \u2192 creates utility classes (\`bg-brand\`, etc.)
+- \`:root { --brand-opacity: 0.9; }\` \u2192 plain CSS variable, no utility generated
+
+Use \`:root\` for runtime values (e.g., animation targets, JS-readable tokens) that must **not** produce utility classes.
+
+### Defining custom animations
+
+\`\`\`css
+@theme {
+  --animate-slide-in: slide-in 0.3s ease-out;
+
+  @keyframes slide-in {
+    from { transform: translateY(-8px); opacity: 0; }
+    to   { transform: translateY(0);    opacity: 1; }
+  }
+}
+\`\`\`
+`;
+    };
+    linterTemplate = (cart) => {
+      if (cart.linter === "BIOME") {
+        return frontmatter("**") + `# Biome
+
+- Configuration: \`biome.json\` at the repo root. Respect the rules it enforces.
+- Run \`npm run lint\` and \`npm run format\` before committing.
+- Do not disable rules inline (\`// biome-ignore\`) without a comment explaining why.
+- Import order, formatting, and unused imports are enforced by Biome \u2014 do not manually format differently.
+`;
+      }
+      if (cart.linter === "ESLINT") {
+        return frontmatter("**") + `# ESLint
+
+- Configuration: \`eslint.config.js\` (flat config) at the repo root.
+- Run \`npm run lint\` before committing; fix all errors and warnings.
+- Do not add \`// eslint-disable\` or \`/* eslint-disable */\` without a short comment explaining why.
+- React hooks rules are enforced \u2014 never call hooks conditionally or in loops.
+- Unused variables must be prefixed with \`_\` or removed.
+`;
+      }
+      return "";
+    };
+    getCopilotInstructionFiles = (cart) => {
+      const hasRouter = cart.router === "TANSTACK_ROUTER";
+      const hasZustand = cart.stateManagement === "ZUSTAND";
+      const hasQuery = cart.query === "TANSTACK_QUERY";
+      const hasLinter = cart.linter !== "NOT_USING";
+      const files = [
+        { relativePath: ".github/copilot-instructions.md", content: generalTemplate(cart) },
+        { relativePath: ".github/instructions/components.instructions.md", content: componentsTemplate(cart) },
+        { relativePath: ".github/instructions/hooks.instructions.md", content: hooksTemplate(cart) }
+      ];
+      if (hasRouter) {
+        files.push({
+          relativePath: ".github/instructions/tanstack-router.instructions.md",
+          content: routerTemplate(cart)
+        });
+      }
+      if (hasZustand) {
+        files.push({
+          relativePath: ".github/instructions/zustand.instructions.md",
+          content: zustandTemplate(cart)
+        });
+      }
+      if (hasQuery) {
+        files.push({
+          relativePath: ".github/instructions/tanstack-query.instructions.md",
+          content: queryTemplate(cart)
+        });
+      }
+      if (cart.css === "TAILWIND") {
+        files.push({
+          relativePath: ".github/instructions/tailwind.instructions.md",
+          content: tailwindTemplate(cart)
+        });
+      }
+      if (hasLinter) {
+        files.push({
+          relativePath: `.github/instructions/${cart.linter === "BIOME" ? "biome" : "eslint"}.instructions.md`,
+          content: linterTemplate(cart)
+        });
+      }
+      return files;
+    };
+  }
+});
+
+// src/scaffold/react-vite/templates/fsd-layout.ts
+var getFsdFileMap;
+var init_fsd_layout = __esm({
+  "src/scaffold/react-vite/templates/fsd-layout.ts"() {
+    "use strict";
+    init_package_json();
+    init_vite_config();
+    init_tsconfig();
+    init_index_html();
+    init_main_tsx();
+    init_app_tsx();
+    init_router();
+    init_zustand();
+    init_linter();
+    init_gitignore();
+    init_styles();
+    init_vite_env_d_ts();
+    init_copilot_instructions();
+    getFsdFileMap = (cart) => {
+      const hasRouter = cart.router === "TANSTACK_ROUTER";
+      const hasZustand = cart.stateManagement === "ZUSTAND";
+      const hasQuery = cart.query === "TANSTACK_QUERY";
+      const files = [
+        { relativePath: "package.json", content: packageJsonTemplate(cart) },
+        { relativePath: "vite.config.ts", content: viteConfigTemplate(cart) },
+        { relativePath: "tsconfig.json", content: tsconfigTemplate() },
+        { relativePath: "tsconfig.node.json", content: tsconfigNodeTemplate() },
+        { relativePath: "index.html", content: indexHtmlTemplate(cart.projectName) },
+        { relativePath: ".gitignore", content: gitignoreTemplate() },
+        ...getCopilotInstructionFiles(cart),
+        { relativePath: "src/vite-env.d.ts", content: viteEnvDtsTemplate() },
+        { relativePath: "src/main.tsx", content: mainTsxTemplate(cart) },
+        { relativePath: "src/app/index.tsx", content: appTsxFsdTemplate(hasRouter, hasQuery) },
+        {
+          relativePath: "src/pages/home/ui/HomePage.tsx",
+          content: `export const HomePage = () => <div>Home Page</div>;
+`
+        },
+        {
+          relativePath: "src/pages/home/index.ts",
+          content: `export { HomePage } from './ui/HomePage';
+`
+        },
+        { relativePath: "src/widgets/.gitkeep", content: "" },
+        { relativePath: "src/features/.gitkeep", content: "" },
+        { relativePath: "src/entities/.gitkeep", content: "" },
+        { relativePath: "src/shared/ui/.gitkeep", content: "" },
+        { relativePath: "src/shared/lib/.gitkeep", content: "" },
+        { relativePath: "src/shared/api/.gitkeep", content: "" },
+        { relativePath: "src/shared/config/.gitkeep", content: "" }
+      ];
+      if (hasRouter) {
+        files.push(
+          { relativePath: "src/routes/__root.tsx", content: rootRouteTemplate() },
+          { relativePath: "src/routes/index.tsx", content: indexRouteTemplate() }
+        );
+      }
+      if (hasZustand) {
+        files.push({
+          relativePath: "src/shared/lib/store.ts",
+          content: zustandStoreTemplate()
+        });
+      }
+      if (cart.css === "TAILWIND") {
+        files.push({ relativePath: "src/index.css", content: stylesCssTemplate() });
+      }
+      if (cart.linter === "BIOME") {
+        files.push({ relativePath: "biome.json", content: biomeConfigTemplate() });
+      } else if (cart.linter === "ESLINT") {
+        files.push({ relativePath: "eslint.config.js", content: eslintConfigTemplate() });
+      }
+      return files;
+    };
+  }
+});
+
+// src/scaffold/react-vite/templates/query.ts
+var queryProviderBprTemplate, simpleProviderBprTemplate;
+var init_query = __esm({
+  "src/scaffold/react-vite/templates/query.ts"() {
+    "use strict";
+    queryProviderBprTemplate = () => `import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { ReactQueryDevtools } from '@tanstack/react-query-devtools';
+
+const queryClient = new QueryClient();
+
+export const AppProvider = ({ children }: { children: React.ReactNode }) => {
+  return (
+    <QueryClientProvider client={queryClient}>
+      {children}
+      <ReactQueryDevtools initialIsOpen={false} />
+    </QueryClientProvider>
+  );
+};
+`;
+    simpleProviderBprTemplate = () => `export const AppProvider = ({ children }: { children: React.ReactNode }) => {
+  return <>{children}</>;
+};
+`;
+  }
+});
+
+// src/scaffold/react-vite/templates/bpr-layout.ts
+var getBprFileMap;
+var init_bpr_layout = __esm({
+  "src/scaffold/react-vite/templates/bpr-layout.ts"() {
+    "use strict";
+    init_package_json();
+    init_vite_config();
+    init_tsconfig();
+    init_index_html();
+    init_main_tsx();
+    init_app_tsx();
+    init_router();
+    init_zustand();
+    init_query();
+    init_linter();
+    init_gitignore();
+    init_styles();
+    init_vite_env_d_ts();
+    init_copilot_instructions();
+    getBprFileMap = (cart) => {
+      const hasRouter = cart.router === "TANSTACK_ROUTER";
+      const hasZustand = cart.stateManagement === "ZUSTAND";
+      const hasQuery = cart.query === "TANSTACK_QUERY";
+      const files = [
+        { relativePath: "package.json", content: packageJsonTemplate(cart) },
+        { relativePath: "vite.config.ts", content: viteConfigTemplate(cart) },
+        { relativePath: "tsconfig.json", content: tsconfigTemplate() },
+        { relativePath: "tsconfig.node.json", content: tsconfigNodeTemplate() },
+        { relativePath: "index.html", content: indexHtmlTemplate(cart.projectName) },
+        { relativePath: ".gitignore", content: gitignoreTemplate() },
+        ...getCopilotInstructionFiles(cart),
+        { relativePath: "src/vite-env.d.ts", content: viteEnvDtsTemplate() },
+        { relativePath: "src/main.tsx", content: mainTsxTemplate(cart) },
+        { relativePath: "src/App.tsx", content: appTsxBprTemplate(hasRouter, hasQuery) },
+        {
+          relativePath: "src/providers/index.tsx",
+          content: hasQuery ? queryProviderBprTemplate() : simpleProviderBprTemplate()
+        },
+        { relativePath: "src/assets/.gitkeep", content: "" },
+        { relativePath: "src/components/.gitkeep", content: "" },
+        { relativePath: "src/config/.gitkeep", content: "" },
+        { relativePath: "src/features/.gitkeep", content: "" },
+        { relativePath: "src/hooks/.gitkeep", content: "" },
+        { relativePath: "src/lib/.gitkeep", content: "" },
+        { relativePath: "src/stores/.gitkeep", content: "" },
+        { relativePath: "src/types/.gitkeep", content: "" },
+        { relativePath: "src/utils/.gitkeep", content: "" }
+      ];
+      if (hasRouter) {
+        files.push(
+          { relativePath: "src/routes/__root.tsx", content: rootRouteTemplate() },
+          { relativePath: "src/routes/index.tsx", content: indexRouteTemplate() }
+        );
+      }
+      if (hasZustand) {
+        files.push({
+          relativePath: "src/stores/appStore.ts",
+          content: zustandStoreTemplate()
+        });
+      }
+      if (cart.css === "TAILWIND") {
+        files.push({ relativePath: "src/index.css", content: stylesCssTemplate() });
+      }
+      if (cart.linter === "BIOME") {
+        files.push({ relativePath: "biome.json", content: biomeConfigTemplate() });
+      } else if (cart.linter === "ESLINT") {
+        files.push({ relativePath: "eslint.config.js", content: eslintConfigTemplate() });
+      }
+      return files;
+    };
+  }
+});
+
+// src/scaffold/react-vite/index.ts
+var react_vite_exports = {};
+__export(react_vite_exports, {
+  scaffoldReactVite: () => scaffoldReactVite
+});
+import path2 from "path";
+import chalk from "chalk";
+import { createSpinner } from "nanospinner";
+var scaffoldReactVite;
+var init_react_vite = __esm({
+  "src/scaffold/react-vite/index.ts"() {
+    "use strict";
+    init_constants();
+    init_utils();
+    init_errors();
+    init_fsd_layout();
+    init_bpr_layout();
+    scaffoldReactVite = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ReactVite.value) return;
+      const { projectName } = cart;
+      const projectRoot = path2.resolve(process.cwd(), projectName);
+      if (await dirExists(projectRoot)) {
+        throw new ScaffoldError(
+          `Directory "${projectName}" already exists. Please choose a different project name or remove the existing directory.`
+        );
+      }
+      const spinner = createSpinner(`Scaffolding ${chalk.cyan(projectName)}...`).start();
+      try {
+        const fileMap = cart.layout === "FSD" ? getFsdFileMap(cart) : getBprFileMap(cart);
+        for (const { relativePath, content } of fileMap) {
+          await writeProjectFile(projectRoot, relativePath, content);
+        }
+        spinner.success({
+          text: chalk.green(`Project ${chalk.bold(projectName)} created successfully!`)
+        });
+        console.log("");
+        console.log(chalk.whiteBright("Next steps:"));
+        console.log(chalk.cyan(`  cd ${projectName}`));
+        console.log(chalk.cyan("  npm install"));
+        console.log(chalk.cyan("  npm run dev"));
+        if (cart.router === "TANSTACK_ROUTER") {
+          console.log("");
+          console.log(chalk.gray("  Note: TanStack Router will auto-generate routeTree.gen.ts on first dev run."));
+        }
+        console.log("");
+      } catch (err) {
+        spinner.error({ text: chalk.red("Scaffolding failed.") });
+        if (err instanceof ScaffoldError) {
+          console.error(chalk.red(err.message));
+        } else if (isNodeError(err)) {
+          console.error(chalk.red(`File system error (${err.code}): ${err.message}`));
+        } else {
+          console.error(chalk.red("An unexpected error occurred."), err);
+        }
+        try {
+          const { rm } = await import("fs/promises");
+          await rm(projectRoot, { recursive: true, force: true });
+        } catch {
+        }
+        process.exit(1);
+      }
+    };
+  }
+});
+
+// src/options/react-vite/index.ts
+var react_vite_exports2 = {};
+__export(react_vite_exports2, {
+  flowReactVite: () => flowReactVite,
+  menuCss: () => menuCss,
+  menuLayout: () => menuLayout,
+  menuLinter: () => menuLinter,
+  menuQuery: () => menuQuery,
+  menuRouter: () => menuRouter,
+  menuStateManagement: () => menuStateManagement
+});
+import { select, input, Separator } from "@inquirer/prompts";
+import chalk2 from "chalk";
+var selectFromMenu, menuProjectName, menuLayout, menuRouter, menuStateManagement, menuQuery, menuCss, menuLinter, flowReactVite;
+var init_react_vite2 = __esm({
+  "src/options/react-vite/index.ts"() {
+    "use strict";
+    init_constants();
+    init_constants2();
+    selectFromMenu = async (menuOptions, message) => {
+      const keys = Object.keys(menuOptions);
+      const enabledKeys = keys.filter((key) => !menuOptions[key].disabled);
+      const choices = enabledKeys.map((key) => ({
+        name: menuOptions[key].display,
+        value: menuOptions[key].value,
+        description: menuOptions[key].description
+      }));
+      const answer = await select({
+        message: chalk2.whiteBright(message),
+        choices: [...choices, new Separator()]
+      });
+      return answer;
+    };
+    menuProjectName = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ReactVite.value) return;
+      cart.projectName = await input({
+        message: chalk2.whiteBright("Project name:"),
+        validate: (value) => {
+          if (!value.trim()) return "Project name cannot be empty";
+          if (!/^[a-zA-Z0-9_-]+$/.test(value.trim()))
+            return "Only letters, numbers, hyphens, and underscores allowed";
+          return true;
+        },
+        transformer: (value) => value.trim()
+      });
+    };
+    menuLayout = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ReactVite.value) return;
+      cart.layout = await selectFromMenu(REACT_MENU_LAYOUT, "Choose a layout");
+    };
+    menuRouter = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ReactVite.value) return;
+      cart.router = await selectFromMenu(REACT_MENU_ROUTER, "Choose a Router");
+    };
+    menuStateManagement = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ReactVite.value) return;
+      cart.stateManagement = await selectFromMenu(
+        REACT_MENU_STATE_MANAGEMENT,
+        "Choose a State Management"
+      );
+    };
+    menuQuery = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ReactVite.value) return;
+      cart.query = await selectFromMenu(
+        REACT_MENU_QUERY,
+        "Choose a Data Fetching library"
+      );
+    };
+    menuCss = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ReactVite.value) return;
+      cart.css = await selectFromMenu(REACT_MENU_CSS, "Choose a CSS framework");
+    };
+    menuLinter = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ReactVite.value) return;
+      cart.linter = await selectFromMenu(
+        REACT_MENU_LINTER,
+        "Choose a Linter / Formatter"
+      );
+    };
+    flowReactVite = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ReactVite.value) return;
+      await menuProjectName(cart);
+      await menuLayout(cart);
+      await menuRouter(cart);
+      await menuStateManagement(cart);
+      await menuQuery(cart);
+      await menuCss(cart);
+      await menuLinter(cart);
+      const { scaffoldReactVite: scaffoldReactVite2 } = await Promise.resolve().then(() => (init_react_vite(), react_vite_exports));
+      await scaffoldReactVite2(cart);
+    };
+  }
+});
+
+// src/options/chrome-extension/constants/index.ts
+var CHROME_MENU_STATE_MANAGEMENT, CHROME_MENU_QUERY, CHROME_MENU_CSS, CHROME_MENU_LINTER;
+var init_constants3 = __esm({
+  "src/options/chrome-extension/constants/index.ts"() {
+    "use strict";
+    CHROME_MENU_STATE_MANAGEMENT = {
+      notUsing: {
+        display: "Not Using",
+        value: "NOT_USING",
+        description: "Not using any state management",
+        disabled: false
+      },
+      zustand: {
+        display: "Zustand",
+        value: "ZUSTAND",
+        description: "Zustand state management",
+        disabled: false
+      }
+    };
+    CHROME_MENU_QUERY = {
+      notUsing: {
+        display: "Not Using",
+        value: "NOT_USING",
+        description: "No data fetching library",
+        disabled: false
+      },
+      tanstackQuery: {
+        display: "TanStack Query",
+        value: "TANSTACK_QUERY",
+        description: "Server state management (v5.74.4)",
+        disabled: false
+      }
+    };
+    CHROME_MENU_CSS = {
+      notUsing: {
+        display: "Not Using",
+        value: "NOT_USING",
+        description: "No CSS framework",
+        disabled: false
+      },
+      tailwind: {
+        display: "Tailwind CSS",
+        value: "TAILWIND",
+        description: "Tailwind CSS v4.1.3 (Vite plugin, zero-config)",
+        disabled: false
+      }
+    };
+    CHROME_MENU_LINTER = {
+      notUsing: {
+        display: "Not Using",
+        value: "NOT_USING",
+        description: "No linter/formatter",
+        disabled: false
+      },
+      biome: {
+        display: "Biome",
+        value: "BIOME",
+        description: "Fast all-in-one: lint + format (v1.9.4)",
+        disabled: false
+      },
+      eslint: {
+        display: "ESLint",
+        value: "ESLINT",
+        description: "ESLint v9 (flat config) + typescript-eslint",
+        disabled: false
+      }
+    };
+  }
+});
+
+// src/scaffold/chrome-extension/templates/package-json.ts
+var packageJsonTemplate2;
+var init_package_json2 = __esm({
+  "src/scaffold/chrome-extension/templates/package-json.ts"() {
+    "use strict";
+    packageJsonTemplate2 = (cart) => {
+      const deps = {
+        react: "19.1.0",
+        "react-dom": "19.1.0"
+      };
+      if (cart.stateManagement === "ZUSTAND") {
+        deps["zustand"] = "5.0.5";
+      }
+      if (cart.query === "TANSTACK_QUERY") {
+        deps["@tanstack/react-query"] = "5.74.4";
+        deps["@tanstack/react-query-devtools"] = "5.74.4";
+      }
+      const devDeps = {
+        "@types/react": "19.1.1",
+        "@types/react-dom": "19.1.1",
+        "@vitejs/plugin-react": "4.4.1",
+        typescript: "5.8.3",
+        vite: "6.3.1"
+      };
+      if (cart.css === "TAILWIND") {
+        devDeps["@tailwindcss/vite"] = "4.1.3";
+        devDeps["tailwindcss"] = "4.1.3";
+      }
+      if (cart.linter === "BIOME") {
+        devDeps["@biomejs/biome"] = "1.9.4";
+      } else if (cart.linter === "ESLINT") {
+        devDeps["@eslint/js"] = "9.22.0";
+        devDeps["eslint"] = "9.22.0";
+        devDeps["eslint-plugin-react-hooks"] = "5.2.0";
+        devDeps["eslint-plugin-react-refresh"] = "0.4.19";
+        devDeps["globals"] = "15.15.0";
+        devDeps["typescript-eslint"] = "8.26.0";
+      }
+      const scripts = {
+        dev: "vite",
+        build: "tsc && vite build",
+        "build-extension": "node scripts/build-extension.js",
+        preview: "vite preview"
+      };
+      if (cart.linter === "BIOME") {
+        scripts["lint"] = "biome check .";
+        scripts["format"] = "biome format --write .";
+      } else if (cart.linter === "ESLINT") {
+        scripts["lint"] = "eslint .";
+      }
+      return JSON.stringify(
+        {
+          name: cart.projectName,
+          private: true,
+          version: "0.0.0",
+          type: "module",
+          scripts,
+          dependencies: deps,
+          devDependencies: devDeps
+        },
+        null,
+        2
+      );
+    };
+  }
+});
+
+// src/scaffold/chrome-extension/templates/vite-config.ts
+var viteConfigTemplate2;
+var init_vite_config2 = __esm({
+  "src/scaffold/chrome-extension/templates/vite-config.ts"() {
+    "use strict";
+    viteConfigTemplate2 = (cart) => {
+      const hasTailwind = cart.css === "TAILWIND";
+      const imports = [
+        `import { defineConfig } from 'vite';`,
+        `import react from '@vitejs/plugin-react';`,
+        hasTailwind ? `import tailwindcss from '@tailwindcss/vite';` : ""
+      ].filter(Boolean).join("\n");
+      const plugins = ["react()", hasTailwind ? "tailwindcss()" : ""].filter(Boolean).join(",\n    ");
+      return `${imports}
+
+export default defineConfig({
+  plugins: [
+    ${plugins},
+  ],
+  build: {
+    outDir: 'dist',
+    rollupOptions: {
+      input: {
+        main: 'index.html',
+      },
+    },
+  },
+});
+`;
+    };
+  }
+});
+
+// src/scaffold/chrome-extension/templates/manifest-json.ts
+var manifestJsonTemplate;
+var init_manifest_json = __esm({
+  "src/scaffold/chrome-extension/templates/manifest-json.ts"() {
+    "use strict";
+    manifestJsonTemplate = (projectName) => JSON.stringify(
+      {
+        manifest_version: 3,
+        name: projectName,
+        description: "",
+        version: "1.0.0",
+        action: {
+          default_popup: "index.html"
+        },
+        permissions: []
+      },
+      null,
+      2
+    );
+  }
+});
+
+// src/scaffold/chrome-extension/templates/build-extension-script.ts
+var buildExtensionScriptTemplate;
+var init_build_extension_script = __esm({
+  "src/scaffold/chrome-extension/templates/build-extension-script.ts"() {
+    "use strict";
+    buildExtensionScriptTemplate = () => `import { execSync } from 'child_process';
+import { copyFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = join(__dirname, '..');
+
+execSync('npm run build', { stdio: 'inherit' });
+
+copyFileSync(join(root, 'manifest.json'), join(root, 'dist', 'manifest.json'));
+
+console.log('Build extension completed');
+`;
+  }
+});
+
+// src/scaffold/chrome-extension/templates/main-tsx.ts
+var mainTsxTemplate2;
+var init_main_tsx2 = __esm({
+  "src/scaffold/chrome-extension/templates/main-tsx.ts"() {
+    "use strict";
+    mainTsxTemplate2 = (cart) => {
+      const hasTailwind = cart.css === "TAILWIND";
+      return `import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+${hasTailwind ? "import './index.css';\n" : ""}import App from './App';
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);
+`;
+    };
+  }
+});
+
+// src/scaffold/chrome-extension/templates/app-tsx.ts
+var appTsxTemplate;
+var init_app_tsx2 = __esm({
+  "src/scaffold/chrome-extension/templates/app-tsx.ts"() {
+    "use strict";
+    appTsxTemplate = (cart) => {
+      const hasQuery = cart.query === "TANSTACK_QUERY";
+      if (hasQuery) {
+        return `import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { ReactQueryDevtools } from '@tanstack/react-query-devtools';
+
+const queryClient = new QueryClient();
+
+const App = () => {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <div>
+        <h1>${"${cart.projectName}"}</h1>
+      </div>
+      <ReactQueryDevtools initialIsOpen={false} />
+    </QueryClientProvider>
+  );
+};
+
+export default App;
+`.replace("${cart.projectName}", cart.projectName);
+      }
+      return `const App = () => {
+  return (
+    <div>
+      <h1>${cart.projectName}</h1>
+    </div>
+  );
+};
+
+export default App;
+`;
+    };
+  }
+});
+
+// src/scaffold/chrome-extension/templates/layout.ts
+var getChromeExtensionFileMap;
+var init_layout = __esm({
+  "src/scaffold/chrome-extension/templates/layout.ts"() {
+    "use strict";
+    init_package_json2();
+    init_vite_config2();
+    init_manifest_json();
+    init_build_extension_script();
+    init_main_tsx2();
+    init_app_tsx2();
+    init_vite_env_d_ts();
+    init_tsconfig();
+    init_index_html();
+    init_gitignore();
+    init_styles();
+    init_zustand();
+    init_linter();
+    getChromeExtensionFileMap = (cart) => {
+      const hasZustand = cart.stateManagement === "ZUSTAND";
+      const files = [
+        { relativePath: "package.json", content: packageJsonTemplate2(cart) },
+        { relativePath: "vite.config.ts", content: viteConfigTemplate2(cart) },
+        { relativePath: "tsconfig.json", content: tsconfigTemplate() },
+        { relativePath: "tsconfig.node.json", content: tsconfigNodeTemplate() },
+        { relativePath: "index.html", content: indexHtmlTemplate(cart.projectName) },
+        { relativePath: "manifest.json", content: manifestJsonTemplate(cart.projectName) },
+        { relativePath: ".gitignore", content: gitignoreTemplate() },
+        { relativePath: "scripts/build-extension.js", content: buildExtensionScriptTemplate() },
+        { relativePath: "src/vite-env.d.ts", content: viteEnvDtsTemplate() },
+        { relativePath: "src/main.tsx", content: mainTsxTemplate2(cart) },
+        { relativePath: "src/App.tsx", content: appTsxTemplate(cart) },
+        { relativePath: "src/components/.gitkeep", content: "" },
+        { relativePath: "src/hooks/.gitkeep", content: "" },
+        { relativePath: "src/lib/.gitkeep", content: "" },
+        { relativePath: "src/types/.gitkeep", content: "" },
+        { relativePath: "src/utils/.gitkeep", content: "" }
+      ];
+      if (hasZustand) {
+        files.push({ relativePath: "src/stores/appStore.ts", content: zustandStoreTemplate() });
+      }
+      if (cart.css === "TAILWIND") {
+        files.push({ relativePath: "src/index.css", content: stylesCssTemplate() });
+      }
+      if (cart.linter === "BIOME") {
+        files.push({ relativePath: "biome.json", content: biomeConfigTemplate() });
+      } else if (cart.linter === "ESLINT") {
+        files.push({ relativePath: "eslint.config.js", content: eslintConfigTemplate() });
+      }
+      return files;
+    };
+  }
+});
+
+// src/scaffold/chrome-extension/index.ts
+var chrome_extension_exports = {};
+__export(chrome_extension_exports, {
+  scaffoldChromeExtension: () => scaffoldChromeExtension
+});
+import path3 from "path";
+import chalk3 from "chalk";
+import { createSpinner as createSpinner2 } from "nanospinner";
+var scaffoldChromeExtension;
+var init_chrome_extension = __esm({
+  "src/scaffold/chrome-extension/index.ts"() {
+    "use strict";
+    init_constants();
+    init_utils();
+    init_errors();
+    init_layout();
+    scaffoldChromeExtension = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ChromeExtension.value) return;
+      const { projectName } = cart;
+      const projectRoot = path3.resolve(process.cwd(), projectName);
+      if (await dirExists(projectRoot)) {
+        throw new ScaffoldError(
+          `Directory "${projectName}" already exists. Please choose a different project name or remove the existing directory.`
+        );
+      }
+      const spinner = createSpinner2(`Scaffolding ${chalk3.cyan(projectName)}...`).start();
+      try {
+        const fileMap = getChromeExtensionFileMap(cart);
+        for (const { relativePath, content } of fileMap) {
+          await writeProjectFile(projectRoot, relativePath, content);
+        }
+        spinner.success({
+          text: chalk3.green(`Project ${chalk3.bold(projectName)} created successfully!`)
+        });
+        console.log("");
+        console.log(chalk3.whiteBright("Next steps:"));
+        console.log(chalk3.cyan(`  cd ${projectName}`));
+        console.log(chalk3.cyan("  npm install"));
+        console.log(chalk3.cyan("  npm run dev"));
+        console.log("");
+        console.log(chalk3.whiteBright("To build the extension:"));
+        console.log(chalk3.cyan("  npm run build-extension"));
+        console.log(chalk3.gray("  Then load the dist/ folder in Chrome at chrome://extensions"));
+        console.log("");
+      } catch (err) {
+        spinner.error({ text: chalk3.red("Scaffolding failed.") });
+        if (err instanceof ScaffoldError) {
+          console.error(chalk3.red(err.message));
+        } else if (isNodeError(err)) {
+          console.error(chalk3.red(`File system error (${err.code}): ${err.message}`));
+        } else {
+          console.error(chalk3.red("An unexpected error occurred."), err);
+        }
+        try {
+          const { rm } = await import("fs/promises");
+          await rm(projectRoot, { recursive: true, force: true });
+        } catch {
+        }
+        process.exit(1);
+      }
+    };
+  }
+});
+
+// src/options/chrome-extension/index.ts
+var chrome_extension_exports2 = {};
+__export(chrome_extension_exports2, {
+  flowChromeExtension: () => flowChromeExtension
+});
+import { select as select2, input as input2, Separator as Separator2 } from "@inquirer/prompts";
+import chalk4 from "chalk";
+var selectFromMenu2, menuProjectName2, menuStateManagement2, menuQuery2, menuCss2, menuLinter2, flowChromeExtension;
+var init_chrome_extension2 = __esm({
+  "src/options/chrome-extension/index.ts"() {
+    "use strict";
+    init_constants();
+    init_constants3();
+    selectFromMenu2 = async (menuOptions, message) => {
+      const keys = Object.keys(menuOptions);
+      const enabledKeys = keys.filter((key) => !menuOptions[key].disabled);
+      const choices = enabledKeys.map((key) => ({
+        name: menuOptions[key].display,
+        value: menuOptions[key].value,
+        description: menuOptions[key].description
+      }));
+      const answer = await select2({
+        message: chalk4.whiteBright(message),
+        choices: [...choices, new Separator2()]
+      });
+      return answer;
+    };
+    menuProjectName2 = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ChromeExtension.value) return;
+      cart.projectName = await input2({
+        message: chalk4.whiteBright("Project name:"),
+        validate: (value) => {
+          if (!value.trim()) return "Project name cannot be empty";
+          if (!/^[a-zA-Z0-9_-]+$/.test(value.trim()))
+            return "Only letters, numbers, hyphens, and underscores allowed";
+          return true;
+        },
+        transformer: (value) => value.trim()
+      });
+    };
+    menuStateManagement2 = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ChromeExtension.value) return;
+      cart.stateManagement = await selectFromMenu2(
+        CHROME_MENU_STATE_MANAGEMENT,
+        "Choose a State Management"
+      );
+    };
+    menuQuery2 = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ChromeExtension.value) return;
+      cart.query = await selectFromMenu2(CHROME_MENU_QUERY, "Choose a Data Fetching library");
+    };
+    menuCss2 = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ChromeExtension.value) return;
+      cart.css = await selectFromMenu2(CHROME_MENU_CSS, "Choose a CSS framework");
+    };
+    menuLinter2 = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ChromeExtension.value) return;
+      cart.linter = await selectFromMenu2(CHROME_MENU_LINTER, "Choose a Linter / Formatter");
+    };
+    flowChromeExtension = async (cart) => {
+      if (!cart || cart.type !== MENU_OPTIONS_LEVEL_1.ChromeExtension.value) return;
+      await menuProjectName2(cart);
+      await menuStateManagement2(cart);
+      await menuQuery2(cart);
+      await menuCss2(cart);
+      await menuLinter2(cart);
+      const { scaffoldChromeExtension: scaffoldChromeExtension2 } = await Promise.resolve().then(() => (init_chrome_extension(), chrome_extension_exports));
+      await scaffoldChromeExtension2(cart);
+    };
+  }
+});
+
+// src/options/index.ts
+init_constants();
+import { select as select3, Separator as Separator3 } from "@inquirer/prompts";
+import chalk5 from "chalk";
+var menu = async () => {
+  const keys = Object.keys(MENU_OPTIONS_LEVEL_1);
+  const enabledKeys = keys.filter((key) => !MENU_OPTIONS_LEVEL_1[key].disabled);
+  const choices = [
+    ...enabledKeys.map((key) => ({
+      name: MENU_OPTIONS_LEVEL_1[key].display,
+      value: MENU_OPTIONS_LEVEL_1[key].value,
+      description: MENU_OPTIONS_LEVEL_1[key].description
+    })),
+    new Separator3(),
+    {
+      name: MENU_OPTIONS_LEVEL_1.Nuxt.display,
+      value: MENU_OPTIONS_LEVEL_1.Nuxt.value,
+      disabled: MENU_OPTIONS_LEVEL_1.Nuxt.description
+    }
+  ];
+  const answer = await select3({
+    message: chalk5.whiteBright("How can I help you \u{1F468}\u200D\u{1F373}"),
+    choices
+  });
+  const cart = { type: answer };
+  if (answer === MENU_OPTIONS_LEVEL_1.ReactVite.value) {
+    const { flowReactVite: flowReactVite2 } = await Promise.resolve().then(() => (init_react_vite2(), react_vite_exports2));
+    await flowReactVite2(cart);
+  } else if (answer === MENU_OPTIONS_LEVEL_1.ChromeExtension.value) {
+    const { flowChromeExtension: flowChromeExtension2 } = await Promise.resolve().then(() => (init_chrome_extension2(), chrome_extension_exports2));
+    await flowChromeExtension2(cart);
+  }
+  return cart;
+};
+
+// src/utils/index.ts
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+// src/utils/animation.ts
+var typeWriter = async (text, colorFunc, speed = 50) => {
+  for (const char of text) {
+    process.stdout.write(colorFunc(char));
+    await sleep(speed);
+  }
+  process.stdout.write("\n");
+};
+
+// src/utils/user.ts
+import { execSync } from "child_process";
+var getUserName = () => {
+  const username = execSync("git config --global user.name").toString().trim();
+  return username || process.env.USER || process.env.USERNAME || "Guest";
+};
+
+// src/index.ts
+import chalk6 from "chalk";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var getVersion = () => {
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
+    return pkg.version;
+  } catch {
+    return "unknown";
+  }
+};
+var main = async () => {
+  const args = process.argv.slice(2);
+  if (args.includes("--version") || args.includes("-v")) {
+    console.log(`bver-build v${getVersion()}`);
+    process.exit(0);
+  }
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(`
+bver-build - Interactive CLI for scaffolding modern web projects
+
+Usage:
+  beaver [options]
+
+Options:
+  -v, --version     Show version
+  -h, --help        Show help
+    `);
+    process.exit(0);
+  }
+  await typeWriter(`Hi! ${getUserName()} \u{1F646}`, chalk6.whiteBright, 50);
+  await sleep(500);
+  try {
+    await menu();
+  } catch (err) {
+    if (err instanceof Error) {
+      console.error(chalk6.red(err.message));
+    }
+    process.exit(1);
+  }
+};
+main();