create-vitnode-app 1.2.0-canary.9 → 2.0.0-canary.2

package/copy-of-vitnode-app/root/tsconfig.json

@@ -1,21 +1,29 @@
 {
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "extends": "eslint-config-typescript-vitnode/tsconfig",
+  "include": ["**/*.ts", "**/*.tsx", "eslint.config.js", "prettier.config.js", "vite.config.js"],
+  
   "compilerOptions": {
-    "target": "ESNext",
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "noEmit": true,
-    "baseUrl": ".",
-    "plugins": [
-      {
-        "name": "next"
-      }
-    ],
+    "target": "ES2022",
+    "jsx": "react-jsx",
+    "module": "ESNext",
     "paths": {
+      "#/*": ["./src/*"],
       "@/*": ["./src/*"]
-    }
-  },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
+    },
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": ["vite/client", "node"],
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    /* Linting */
+    "skipLibCheck": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  }
 }

package/copy-of-vitnode-app/root/tsr.config.json

@@ -0,0 +1,3 @@
+{
+  "target": "react"
+}

package/copy-of-vitnode-app/root/vite.config.ts

@@ -0,0 +1,106 @@
+import tailwindcss from "@tailwindcss/vite";
+import { devtools } from "@tanstack/devtools-vite";
+import { tanstackStart } from "@tanstack/react-start/plugin/vite";
+import viteReact from "@vitejs/plugin-react";
+import { vitnode } from "@vitnode/core/framework/vite";
+import { nitro } from "nitro/vite";
+import { defineConfig } from "vite";
+
+const config = defineConfig({
+  resolve: { tsconfigPaths: true },
+  /**
+   * A second dev server has to fail rather than quietly move.
+   *
+   * `tanstackStart()` runs the route generator and *writes*
+   * `src/routeTree.gen.ts`. Two servers means two generators owning one file: if
+   * their route lists ever differ - which is precisely what happens when one was
+   * started before a route file existed - they overwrite each other forever, and
+   * every write is a full page reload. Without `strictPort` the second `pnpm dev`
+   * says "Port 3000 is in use, trying another one" and succeeds, so the fight
+   * starts silently and looks like an inexplicable refresh loop on the first
+   * server.
+   */
+  server: { strictPort: true },
+  ssr: {
+    /**
+     * The VitNode API packages mounted at `/api/*`, kept out of the SSR pass.
+     *
+     * They are Node libraries rather than app source: `@vitnode/core` loads its
+     * locale files with a runtime `import("./en.json", { with: { type: "json" } })`
+     * relative to its own `dist`. Bundling them in this pass moves that chunk
+     * and the JSON stops resolving, which fails the build outright. Left
+     * external here, Nitro resolves them from the package itself.
+     *
+     * Every VitNode package the app installs belongs on this list - add a
+     * plugin's package name here when you install one.
+     *
+     * This is also what decides the shape of `@vitnode/core/tanstack/*`, so it is
+     * worth naming the consequence rather than leaving it to be rediscovered.
+     * Externalised here, the package skips this pass entirely and Nitro's own
+     * Rollup run inlines its `dist` afterwards - and nothing in that path runs
+     * the TanStack Start compiler. The *client* build has no such gap: it inlines
+     * the package, so the compiler transforms it there. So package code reaches
+     * the browser compiled and the server un-compiled, which is exactly why the
+     * package may declare `createIsomorphicFn` (its stub falls back to the
+     * `.server()` branch, which is what a server wants) and may never declare
+     * `createServerFn` (un-compiled, its handler resolves to `undefined` with no
+     * error at all). `packages/vitnode/src/tanstack/boundary.test.ts` holds the
+     * package to that.
+     *
+     * Removing `@vitnode/core` from this list to close the gap was measured and
+     * does not work: the SSR pass then reaches the locale barrel above and the
+     * build fails on `Could not resolve './en.json'`.
+     *
+     * ## `tslib` is here for an entirely different reason
+     *
+     * It is not a VitNode package and it is not a Node library. It is here
+     * because bundling it is broken, in a way that only appears in a production
+     * build and only once a page renders.
+     *
+     * The Radix scroll-lock stack that every modal in a VitNode page pulls in -
+     * `react-remove-scroll`, `use-sidecar`, `aria-hidden` - does
+     * `import { __extends } from "tslib"`. Under the `node` condition that
+     * resolves to `tslib/modules/index.js`, a two-line ESM shim around the
+     * **CommonJS** `tslib.js`:
+     *
+     *     import tslib from "../tslib.js";
+     *     const { __extends, … } = tslib;
+     *
+     * `tslib.js` defines `__esModule` on its exports, so Rolldown's CJS interop
+     * helper does not synthesise a `default` - while the call site it generated
+     * still reads `.default`. Every page that renders a dialog then throws
+     * `Cannot destructure property '__extends' of undefined`.
+     *
+     * Externalised, the file is never bundled: Nitro traces the package into the
+     * output and Node loads it with Node's own interop, which is correct. An
+     * alias to `tslib/tslib.es6.mjs` was tried first and is worse - it fixes
+     * Vite's copy and not Nitro's, because Nitro re-resolves externals itself,
+     * and the tracer then copies only the file the alias named.
+     */
+    external: ["@vitnode/core", "tslib"],
+  },
+  plugins: [
+    /**
+     * Environment handling, the dev server's dependency pre-bundling and the
+     * plugin route registry, in the order they have to run.
+     *
+     * `appRoot` is `import.meta.dirname` because a Vite config is loaded with
+     * the working directory set to wherever the command ran, which in a
+     * monorepo is regularly the repository root.
+     *
+     * `clientEnv` is not passed: this app publishes nothing to the browser
+     * beyond the two keys VitNode inlines for every install
+     * (`NEXT_PUBLIC_API_URL`, `NEXT_PUBLIC_WEB_URL`). Anything named there is
+     * compiled into JavaScript anyone can read, so a key is added only when
+     * something in the browser genuinely reads it.
+     */
+    vitnode({ appRoot: import.meta.dirname }),
+    devtools(),
+    nitro({ rollupConfig: { external: [/^@sentry\//] } }),
+    tailwindcss(),
+    tanstackStart(),
+    viteReact(),
+  ],
+});
+
+export default config;

package/copy-of-vitnode-plugin/root/.swcrc

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://swc.rs/schema.json",
+  "exclude": ["\\.test\\.tsx?$"],
+  "minify": true,
+  "jsc": {
+    "baseUrl": "./",
+    "target": "esnext",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "parser": {
+      "syntax": "typescript",
+      "tsx": true
+    },
+    "transform": {
+      "react": {
+        "runtime": "automatic"
+      }
+    }
+  },
+  "module": {
+    "type": "nodenext",
+    "strict": true,
+    "resolveFully": true
+  }
+}

package/copy-of-vitnode-plugin/root/global.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="use-intl" />
+
+import coreApi from "@vitnode/core/locales/api/en.json" with { type: "json" };
+import core from "@vitnode/core/locales/en.json" with { type: "json" };
+import plugin from "./src/locales/en.json" with { type: "json" };
+
+// Augmenting `use-intl`, not `next-intl`. `AppConfig` is declared by `use-intl`,
+// which is what VitNode renders every string through on every host, and a plugin
+// is compiled into its own `dist` and imported by whichever app installed it -
+// so a type-level dependency on one host's framework is one every installing app
+// inherits. `use-intl` must be a direct dependency of this package for the
+// reference above to resolve under pnpm's strict `node_modules`.
+//
+// A plugin can render on both sides (UI components and, e.g., emails), so it
+// types keys against both of core's trees. Add your own server tree here too
+// (`./src/locales/api/en.json`) once your plugin sends email.
+declare module "use-intl" {
+  interface AppConfig {
+    Messages: typeof plugin & typeof core & typeof coreApi;
+  }
+}

package/copy-of-vitnode-plugin/root/npmignore.template

@@ -0,0 +1,17 @@
+/src/*
+!/src/routes
+!/src/routes/**
+!/src/locales
+!/src/locales/**
+
+/node_modules
+/.turbo
+/tsconfig.json
+/.swcrc
+/components.json
+/global.d.ts
+/tsup.config.ts
+/vitest.config.ts
+/tsconfig.json
+/scripts
+/config

package/copy-of-vitnode-plugin/root/tsconfig.build.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "**/*.test.ts", "**/*.test.tsx"]
+}

package/copy-of-vitnode-plugin/root/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@vitnode/config/tsconfig",
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "rootDir": "./",
+    "outDir": "./dist",
+    "jsx": "react-jsx",
+    "emitDeclarationOnly": true,
+    "declaration": true,
+    "declarationMap": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "exclude": ["node_modules"],
+  "include": ["src", "global.d.ts"]
+}

package/dist/src/create/create-package-json.js

@@ -1,66 +1,276 @@
-import { readFile, writeFile } from 'fs/promises';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-export const createPackageJSON = async ({ appName, packageManager, root, eslint, }) => {
-    const pkg = JSON.parse(await readFile(join(__dirname, '..', '..', '..', 'package.json'), 'utf-8'));
-    const packageJson = {
-        name: appName,
-        version: '0.1.0',
+import { writeFile } from "fs/promises";
+import { join } from "path";
+import { getAvailablePackageManagers } from "../helpers/get-available-package-managers.js";
+import { getVitnodePackageVersion } from "../helpers/get-vitnode-package-version.js";
+import { withIf } from "../helpers/with-If.js";
+import { versionsPackageJson } from "./package-versions.js";
+const writeJson = async (path, data) => writeFile(path, JSON.stringify(data, null, 2));
+const paths = (root) => ({
+    root,
+    api: join(root, "apps", "api"),
+    web: join(root, "apps", "web"),
+});
+const eslintScripts = {
+    lint: "eslint .",
+    "lint:fix": "eslint . --fix",
+};
+const i18nScripts = {
+    "i18n:create": "vitnode i18n:create",
+    "i18n:check": "vitnode i18n:check",
+    "i18n:delete": "vitnode i18n:delete",
+    "i18n:update": "vitnode i18n:update",
+    "i18n:update:ai": "vitnode i18n:update:ai",
+};
+const dockerDevScript = (appName) => `docker compose -f ./docker-compose.yml -p ${appName}-vitnode-dev up -d`;
+export const rootScripts = (enableEslint, enableDocker, appName) => ({
+    "db:migrate": "turbo db:migrate",
+    "db:prepare": "turbo db:prepare",
+    dev: "turbo db:prepare && turbo dev",
+    build: "turbo build",
+    start: "turbo start",
+    "i18n:create": "turbo i18n:create",
+    "i18n:check": "turbo i18n:check",
+    "i18n:delete": "turbo i18n:delete",
+    "i18n:update": "turbo i18n:update",
+    "i18n:update:ai": "turbo i18n:update:ai",
+    ...withIf(enableEslint, {
+        lint: "turbo lint",
+        "lint:fix": "turbo lint:fix",
+    }),
+    ...withIf(enableDocker, { "docker:dev": dockerDevScript(appName) }),
+});
+export const apiScripts = (pm, eslint, docker, onlyApi, appName) => {
+    return {
+        "db:migrate": "vitnode migrate",
+        "db:prepare": "vitnode db:prepare",
+        ...(pm === "bun"
+            ? {
+                dev: "vitnode db:prepare && bun run --hot src/index.ts",
+                start: "NODE_ENV=production bun run src/index.ts",
+            }
+            : {
+                dev: "vitnode db:prepare && tsx watch src/index.ts",
+                build: "tsc && tsc-alias -p tsconfig.json",
+                start: "node dist/index.js",
+            }),
+        "dev:email": "email dev --dir src/emails",
+        ...i18nScripts,
+        ...withIf(eslint, eslintScripts),
+        ...withIf(docker && onlyApi, { "docker:dev": dockerDevScript(appName) }),
+        "drizzle-kit": "drizzle-kit",
+    };
+};
+export const singleAppScripts = (eslint, docker, appName) => ({
+    "db:migrate": "vitnode migrate",
+    "db:prepare": "vitnode db:prepare",
+    dev: "vitnode db:prepare && vite dev --port 3000",
+    "dev:email": "email dev --dir src/emails",
+    build: "vite build",
+    start: "node .output/server/index.mjs",
+    ...i18nScripts,
+    ...withIf(eslint, eslintScripts),
+    ...withIf(docker, { "docker:dev": dockerDevScript(appName) }),
+    "drizzle-kit": "drizzle-kit",
+});
+export const webScripts = (eslint) => ({
+    dev: "vite dev --port 3000",
+    build: "vite build",
+    start: "node .output/server/index.mjs",
+    ...i18nScripts,
+    ...withIf(eslint, eslintScripts),
+});
+const baseDevDeps = (eslint, includePrettier) => ({
+    "@types/node": versionsPackageJson.typesNode,
+    "@vitnode/config": "",
+    ...withIf(eslint, {
+        eslint: versionsPackageJson.eslint,
+        ...withIf(includePrettier, {
+            prettier: versionsPackageJson.prettier,
+            "prettier-plugin-tailwindcss": versionsPackageJson.prettierTailwind,
+        }),
+    }),
+});
+const rootDevDeps = (eslint) => ({
+    ...baseDevDeps(eslint, true),
+    turbo: versionsPackageJson.turbo,
+    typescript: versionsPackageJson.typescript,
+    zod: versionsPackageJson.zod,
+});
+const apiDeps = {
+    "@hono/zod-openapi": versionsPackageJson.honoZodOpenapi,
+    "@hono/zod-validator": versionsPackageJson.honoZodValidator,
+    "@vitnode/core": "",
+    "drizzle-kit": versionsPackageJson.drizzleKit,
+    "drizzle-orm": versionsPackageJson.drizzleOrm,
+    hono: versionsPackageJson.hono,
+    react: versionsPackageJson.react,
+    "react-dom": versionsPackageJson.reactDom,
+    "react-email": versionsPackageJson.reactEmail,
+    ws: versionsPackageJson.ws,
+    zod: versionsPackageJson.zod,
+};
+const apiDevDeps = (pm, eslint) => ({
+    "@hono/node-server": "^2.0",
+    "@react-email/ui": versionsPackageJson.reactEmailUi,
+    ...(pm === "bun" ? { "@types/bun": versionsPackageJson.typesBun } : {}),
+    "@types/node": versionsPackageJson.typesNode,
+    "@types/react": versionsPackageJson.typesReact,
+    "@types/react-dom": versionsPackageJson.typesReactDom,
+    "@vitnode/config": "",
+    dotenv: versionsPackageJson.dotenv,
+    ...withIf(eslint, {
+        eslint: versionsPackageJson.eslint,
+    }),
+    "tsc-alias": versionsPackageJson.tscAlias,
+    tsx: versionsPackageJson.tsx,
+    typescript: versionsPackageJson.typescript,
+});
+const tanstackWebDeps = {
+    "@tailwindcss/vite": versionsPackageJson.tailwindVite,
+    "@tanstack/react-query": versionsPackageJson.tanstackReactQuery,
+    "@tanstack/react-router": versionsPackageJson.tanstackReactRouter,
+    "@tanstack/react-router-ssr-query": versionsPackageJson.tanstackRouterSsrQuery,
+    "@tanstack/react-start": versionsPackageJson.tanstackReactStart,
+    "@vitnode/core": "",
+    "lucide-react": versionsPackageJson.lucide,
+    nitro: versionsPackageJson.nitro,
+    react: versionsPackageJson.react,
+    "react-dom": versionsPackageJson.reactDom,
+    "react-hook-form": versionsPackageJson.rhf,
+    sonner: versionsPackageJson.sonner,
+    tailwindcss: versionsPackageJson.tailwind,
+    tslib: versionsPackageJson.tslib,
+    "use-intl": versionsPackageJson.useIntl,
+    zod: versionsPackageJson.zod,
+};
+const singleAppDeps = {
+    ...tanstackWebDeps,
+    "@hono/zod-openapi": versionsPackageJson.honoZodOpenapi,
+    "@hono/zod-validator": versionsPackageJson.honoZodValidator,
+    "@hookform/resolvers": versionsPackageJson.rhfResolvers,
+    "drizzle-kit": versionsPackageJson.drizzleKit,
+    "drizzle-orm": versionsPackageJson.drizzleOrm,
+    hono: versionsPackageJson.hono,
+    "react-email": versionsPackageJson.reactEmail,
+    shadcn: versionsPackageJson.shadcn,
+};
+const tanstackWebDevDeps = {
+    "@tanstack/devtools-vite": versionsPackageJson.tanstackDevtoolsVite,
+    "@tanstack/react-devtools": versionsPackageJson.tanstackReactDevtools,
+    "@tanstack/react-query-devtools": versionsPackageJson.tanstackQueryDevtools,
+    "@tanstack/react-router-devtools": versionsPackageJson.tanstackRouterDevtools,
+    "@types/node": versionsPackageJson.typesNode,
+    "@types/react": versionsPackageJson.typesReact,
+    "@types/react-dom": versionsPackageJson.typesReactDom,
+    "@vitejs/plugin-react": versionsPackageJson.viteReact,
+    "@vitnode/config": "",
+    "tw-animate-css": versionsPackageJson.twAnimateCss,
+    typescript: versionsPackageJson.typescript,
+    vite: versionsPackageJson.vite,
+};
+const singleAppDevDeps = (eslint) => ({
+    ...tanstackWebDevDeps,
+    "@react-email/ui": versionsPackageJson.reactEmailUi,
+    ...withIf(eslint, {
+        eslint: versionsPackageJson.eslint,
+        prettier: versionsPackageJson.prettier,
+        "prettier-plugin-tailwindcss": versionsPackageJson.prettierTailwind,
+    }),
+    turbo: versionsPackageJson.turbo,
+});
+const webDeps = {
+    ...tanstackWebDeps,
+    shadcn: versionsPackageJson.shadcn,
+};
+const webDevDeps = (eslint) => ({
+    ...tanstackWebDevDeps,
+    "@hookform/resolvers": versionsPackageJson.rhfResolvers,
+    "class-variance-authority": versionsPackageJson.cva,
+    ...withIf(eslint, { eslint: versionsPackageJson.eslint }),
+});
+export const createPackageJSON = async ({ appName, packageManager, root, eslint, docker, mode, monorepo, }) => {
+    const vitnodeVersionRange = await getVitnodePackageVersion();
+    const pmVersions = await getAvailablePackageManagers();
+    const pmSpec = `${packageManager}@${pmVersions[packageManager]}`;
+    const p = paths(root);
+    const isApiMonorepo = mode === "apiMonorepo" || !!monorepo;
+    const isOnlyApi = mode === "onlyApi";
+    const isSingleApp = mode === "singleApp";
+    if (isApiMonorepo) {
+        const rootPkg = {
+            name: appName,
+            private: true,
+            scripts: rootScripts(eslint, !!docker, appName),
+            devDependencies: {
+                ...rootDevDeps(eslint),
+                "@vitnode/config": vitnodeVersionRange,
+            },
+            packageManager: pmSpec,
+            workspaces: ["apps/*", "plugins/*"],
+        };
+        await writeJson(join(p.root, "package.json"), rootPkg);
+    }
+    const apiPkg = {
+        name: isApiMonorepo ? "api" : appName,
+        version: "0.1.0",
         private: true,
-        type: 'module',
-        scripts: {
-            'drizzle-kit': 'drizzle-kit',
-            'db:push': 'drizzle-kit push',
-            'db:migrate': 'drizzle-kit up && drizzle-kit generate && drizzle-kit migrate',
-            dev: 'vitnode init && next dev --turbopack',
-            build: 'next build --turbopack',
-            start: 'next start',
-            ...(eslint
-                ? {
-                    lint: 'eslint .',
-                    'lint:fix': 'eslint . --fix',
-                }
-                : {}),
-        },
+        type: "module",
+        scripts: apiScripts(packageManager, eslint, !!docker, mode === "onlyApi", appName),
         dependencies: {
-            '@hono/zod-openapi': '^0.19.8',
-            '@hono/zod-validator': '^0.7.0',
-            '@hookform/resolvers': '^5.0.1',
-            '@react-email/components': '^0.0.41',
-            '@vitnode/core': `^${pkg.version}`,
-            'babel-plugin-react-compiler': '19.1.0-rc.2',
-            'drizzle-kit': '^0.31.1',
-            'drizzle-orm': '^0.44.1',
-            hono: '^4.7.10',
-            'lucide-react': '^0.513.0',
-            next: '^15.3.3',
-            'next-intl': '^4.1.0',
-            react: '^19.1.0',
-            'react-dom': '^19.1.0',
-            'react-hook-form': '^7.56.4',
-            sonner: '^2.0.3',
-            zod: '^3.25.42',
+            ...apiDeps,
+            "@vitnode/core": vitnodeVersionRange,
         },
         devDependencies: {
-            '@tailwindcss/postcss': '^4.1.8',
-            '@types/node': '^22.15.29',
-            '@types/react': '^19.1.6',
-            '@types/react-dom': '^19.1.5',
-            ...(eslint
+            ...apiDevDeps(packageManager, eslint),
+            "@vitnode/config": vitnodeVersionRange,
+            ...(eslint && mode === "onlyApi"
                 ? {
-                    eslint: '^9.27.0',
-                    'eslint-config-typescript-vitnode': `^${pkg.version}`,
-                    prettier: '^3.5.3',
+                    prettier: versionsPackageJson.prettier,
+                    "prettier-plugin-tailwindcss": versionsPackageJson.prettierTailwind,
                 }
                 : {}),
-            'react-email': '^4.0.15',
-            tailwindcss: '^4.1.8',
-            'tw-animate-css': '^1.3.2',
-            typescript: '^5.8.3',
+            ...(packageManager === "bun" ? {} : {}),
         },
-        packageManager,
     };
-    await writeFile(join(root, 'package.json'), JSON.stringify(packageJson, null, 2));
+    if (isSingleApp) {
+        const singlePkg = {
+            name: monorepo ? "web" : appName,
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: singleAppScripts(eslint, !!docker, appName),
+            dependencies: {
+                ...singleAppDeps,
+                "@vitnode/core": vitnodeVersionRange,
+            },
+            devDependencies: {
+                ...singleAppDevDeps(eslint),
+                "@vitnode/config": vitnodeVersionRange,
+            },
+            packageManager: pmSpec,
+        };
+        await writeJson(join(monorepo ? p.web : p.root, "package.json"), singlePkg);
+    }
+    if (mode === "apiMonorepo") {
+        await writeJson(join(p.api, "package.json"), apiPkg);
+        const webPkg = {
+            name: "web",
+            version: "0.1.0",
+            private: true,
+            type: "module",
+            scripts: webScripts(eslint),
+            dependencies: {
+                ...webDeps,
+                "@vitnode/core": vitnodeVersionRange,
+            },
+            devDependencies: {
+                ...webDevDeps(eslint),
+                "@vitnode/config": vitnodeVersionRange,
+            },
+        };
+        await writeJson(join(p.web, "package.json"), webPkg);
+    }
+    if (isOnlyApi) {
+        await writeJson(join(monorepo ? p.api : p.root, "package.json"), apiPkg);
+    }
 };