@taujs/create-taujs 0.3.1 → 0.4.0

package/dist/index.js

@@ -45,11 +45,15 @@ var PACKAGE_MANAGERS = {
   pnpm: "pnpm install",
   yarn: "yarn install"
 };
-var FRAMEWORKS = ["react", "vue"];
+var FRAMEWORKS = ["react", "vue", "solid"];
+var PACKAGE_MANAGER_NAMES = Object.keys(PACKAGE_MANAGERS);
 function parseArgs() {
   const rawArgs = process.argv.slice(2);
   let projectName;
   let framework;
+  let packageManager;
+  let sawInstall = false;
+  let sawNoInstall = false;
   for (let i = 0; i < rawArgs.length; i++) {
     const arg = rawArgs[i];
     if (arg === "--framework") {
@@ -60,12 +64,37 @@ function parseArgs() {
       framework = arg.slice("--framework=".length);
       continue;
     }
+    if (arg === "--package-manager") {
+      packageManager = rawArgs[++i];
+      continue;
+    }
+    if (arg.startsWith("--package-manager=")) {
+      packageManager = arg.slice("--package-manager=".length);
+      continue;
+    }
+    if (arg === "--install") {
+      sawInstall = true;
+      continue;
+    }
+    if (arg === "--no-install") {
+      sawNoInstall = true;
+      continue;
+    }
     if (!arg.startsWith("-") && !projectName) {
       projectName = arg;
       continue;
     }
   }
-  return { projectName, framework };
+  return {
+    projectName,
+    framework,
+    packageManager,
+    install: sawInstall && !sawNoInstall ? true : sawNoInstall && !sawInstall ? false : void 0,
+    installConflict: sawInstall && sawNoInstall
+  };
+}
+function validatePackageManager(value) {
+  return PACKAGE_MANAGER_NAMES.includes(value) ? true : `Package manager must be one of: ${PACKAGE_MANAGER_NAMES.join(", ")}`;
 }
 function validateProjectName(value) {
   if (!value) return "Project name is required";
@@ -79,7 +108,19 @@ function validateFramework(value) {
 }
 async function main() {
   console.log(pc.cyan("\nWelcome to \u03C4js (taujs)\n"));
-  const { projectName: argName, framework: argFramework } = parseArgs();
+  const { projectName: argName, framework: argFramework, packageManager: argPackageManager, install: argInstall, installConflict } = parseArgs();
+  if (installConflict) {
+    console.log(pc.red("\n\u2716 --install and --no-install are mutually exclusive"));
+    process.exit(1);
+  }
+  if (argPackageManager) {
+    const res = validatePackageManager(argPackageManager);
+    if (res !== true) {
+      console.log(pc.red(`
+\u2716 Invalid package manager "${argPackageManager}": ${res}`));
+      process.exit(1);
+    }
+  }
   if (argName) {
     const res = validateProjectName(argName);
     if (res !== true) {
@@ -110,12 +151,13 @@ async function main() {
       message: "Framework:",
       choices: [
         { title: "React", value: "react" },
-        { title: "Vue", value: "vue" }
+        { title: "Vue", value: "vue" },
+        { title: "Solid", value: "solid" }
       ],
       initial: 0
     },
     {
-      type: "select",
+      type: argPackageManager ? null : "select",
       name: "packageManager",
       message: "Package manager:",
       choices: [
@@ -126,7 +168,7 @@ async function main() {
       initial: 0
     },
     {
-      type: "confirm",
+      type: argInstall === void 0 ? "confirm" : null,
       name: "installDeps",
       message: "Install dependencies now?",
       initial: true
@@ -158,8 +200,8 @@ async function main() {
   }
   const config = {
     projectName,
-    packageManager: answers.packageManager,
-    installDeps: answers.installDeps,
+    packageManager: argPackageManager ?? answers.packageManager,
+    installDeps: argInstall ?? answers.installDeps,
     framework
   };
   await createProject(config);
@@ -236,9 +278,19 @@ function planFiles(config) {
     { path: "src/server/services/registry.ts", content: generateServiceRegistry() },
     { path: "src/server/services/example.service.ts", content: generateExampleService() },
     { path: "src/server/types.d.ts", content: generateServiceTypesAugmentation() },
-    { path: "src/client/public/favicon.svg", content: generateFavicon() }
+    { path: "src/client/public/favicon.svg", content: generateFavicon() },
+    // Solid's managed compiler owns a DISJOINT tsconfig project: it must claim the client TSX and
+    // nothing else. Pointing it at the root tsconfig would make it claim `src/server/**` too, which
+    // is not Solid TSX and is compiled by the server toolchain.
+    ...framework === "solid" ? [{ path: "tsconfig.solid.json", json: generateSolidCompilerTsConfig() }] : []
   ];
-  const client = framework === "vue" ? [
+  const client = framework === "solid" ? [
+    { path: "src/client/App.tsx", content: generateAppComponentSolid() },
+    { path: "src/client/renderId.ts", content: generateSolidRenderId() },
+    { path: "src/client/entry-client.tsx", content: generateEntryClientSolid() },
+    { path: "src/client/entry-server.tsx", content: generateEntryServerSolid() },
+    { path: "src/client/vite-env.d.ts", content: generateViteEnv() }
+  ] : framework === "vue" ? [
     { path: "src/client/App.vue", content: generateAppVue() },
     { path: "src/client/HomePage.vue", content: generateHomePageVue() },
     { path: "src/client/StreamingPage.vue", content: generateStreamingPageVue() },
@@ -273,10 +325,10 @@ function generatePackageJson(projectName, framework) {
       type: "module",
       scripts: {
         dev: "cross-env NODE_ENV=development tsx watch --ignore vite.config.ts --trace-warnings --tsconfig ./src/server/tsconfig.json ./src/server/index.ts --loglevel verbose",
-        "build:client": "tsx build.ts",
-        "build:entry-server": "cross-env BUILD_MODE=ssr tsx build.ts",
+        "build:client": "cross-env NODE_ENV=production tsx build.ts",
+        "build:entry-server": "cross-env NODE_ENV=production BUILD_MODE=ssr tsx build.ts",
         "build:server": "esbuild src/server/index.ts --bundle --platform=node --format=esm --outfile=dist/server/index.js --external:fastify --external:@taujs/server --external:@taujs/vue",
-        build: "tsx build.ts && cross-env BUILD_MODE=ssr tsx build.ts && esbuild src/server/index.ts --bundle --platform=node --format=esm --outfile=dist/server/index.js --external:fastify --external:@taujs/server --external:@taujs/vue",
+        build: "cross-env NODE_ENV=production tsx build.ts && cross-env NODE_ENV=production BUILD_MODE=ssr tsx build.ts && esbuild src/server/index.ts --bundle --platform=node --format=esm --outfile=dist/server/index.js --external:fastify --external:@taujs/server --external:@taujs/vue",
         start: "cross-env NODE_ENV=production node dist/server/index.js",
         lint: "vue-tsc --noEmit"
       },
@@ -292,6 +344,9 @@ function generatePackageJson(projectName, framework) {
         "@types/node": "^22.10.5",
         "@vitejs/plugin-vue": "^6.0.0",
         "cross-env": "^7.0.3",
+        // `build:server` invokes the esbuild BINARY directly, so it must be a declared dependency
+        // of the generated project - it is not inherited from vite's own copy.
+        esbuild: "^0.25.0",
         tsx: "^4.19.3",
         typescript: "^5.7.3",
         vite: "^7.1.11",
@@ -299,6 +354,43 @@ function generatePackageJson(projectName, framework) {
       }
     };
   }
+  if (framework === "solid") {
+    return {
+      name: projectName,
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: {
+        dev: "cross-env NODE_ENV=development tsx watch --ignore vite.config.ts --trace-warnings --tsconfig ./src/server/tsconfig.json ./src/server/index.ts --loglevel verbose",
+        "build:client": "cross-env NODE_ENV=production tsx build.ts",
+        "build:entry-server": "cross-env NODE_ENV=production BUILD_MODE=ssr tsx build.ts",
+        "build:server": "esbuild src/server/index.ts --bundle --platform=node --format=esm --outfile=dist/server/index.js --external:fastify --external:@taujs/server --external:@taujs/solid",
+        build: "cross-env NODE_ENV=production tsx build.ts && cross-env NODE_ENV=production BUILD_MODE=ssr tsx build.ts && esbuild src/server/index.ts --bundle --platform=node --format=esm --outfile=dist/server/index.js --external:fastify --external:@taujs/server --external:@taujs/solid",
+        start: "cross-env NODE_ENV=production node dist/server/index.js",
+        lint: "tsc --noEmit"
+      },
+      dependencies: {
+        "@taujs/server": "latest",
+        "@taujs/solid": "latest",
+        fastify: "^5.2.0",
+        "solid-js": "^1.9.0"
+      },
+      devDependencies: {
+        "@taujs/mcp": "latest",
+        "@types/node": "^22.10.5",
+        "cross-env": "^7.0.3",
+        // `build:server` invokes the esbuild BINARY directly, so it must be a declared dependency
+        // of the generated project - it is not inherited from vite's own copy.
+        esbuild: "^0.25.0",
+        tsx: "^4.19.3",
+        typescript: "^5.7.3",
+        vite: "^7.1.11",
+        // The managed compiler instantiates this internally with `ssr: true` forced; the app never
+        // adds it to `plugins` itself.
+        "vite-plugin-solid": "^2.11.0"
+      }
+    };
+  }
   return {
     name: projectName,
     version: "0.1.0",
@@ -306,10 +398,10 @@ function generatePackageJson(projectName, framework) {
     type: "module",
     scripts: {
       dev: "cross-env NODE_ENV=development tsx watch --ignore vite.config.ts --trace-warnings --tsconfig ./src/server/tsconfig.json ./src/server/index.ts --loglevel verbose",
-      "build:client": "tsx build.ts",
-      "build:entry-server": "cross-env BUILD_MODE=ssr tsx build.ts",
+      "build:client": "cross-env NODE_ENV=production tsx build.ts",
+      "build:entry-server": "cross-env NODE_ENV=production BUILD_MODE=ssr tsx build.ts",
       "build:server": "esbuild src/server/index.ts --bundle --platform=node --format=esm --outfile=dist/server/index.js --external:fastify --external:@taujs/server --external:@taujs/react",
-      build: "tsx build.ts && cross-env BUILD_MODE=ssr tsx build.ts && esbuild src/server/index.ts --bundle --platform=node --format=esm --outfile=dist/server/index.js --external:fastify --external:@taujs/server --external:@taujs/react",
+      build: "cross-env NODE_ENV=production tsx build.ts && cross-env NODE_ENV=production BUILD_MODE=ssr tsx build.ts && esbuild src/server/index.ts --bundle --platform=node --format=esm --outfile=dist/server/index.js --external:fastify --external:@taujs/server --external:@taujs/react",
       start: "cross-env NODE_ENV=production node dist/server/index.js",
       lint: "tsc --noEmit"
     },
@@ -327,6 +419,9 @@ function generatePackageJson(projectName, framework) {
       "@types/react-dom": "^19.0.2",
       "@vitejs/plugin-react": "^4.6.0",
       "cross-env": "^7.0.3",
+      // `build:server` invokes the esbuild BINARY directly, so it must be a declared dependency
+      // of the generated project - it is not inherited from vite's own copy.
+      esbuild: "^0.25.0",
       tsx: "^4.19.3",
       typescript: "^5.7.3",
       vite: "^7.1.11"
@@ -351,8 +446,10 @@ function generateTsConfig(framework) {
       target: "ES2022",
       module: "ESNext",
       lib: ["ES2022", "DOM", "DOM.Iterable"],
-      // Vue SFCs are typed by vue-tsc; React needs the automatic JSX runtime.
+      // Vue SFCs are typed by vue-tsc; React needs the automatic JSX runtime; Solid PRESERVES JSX
+      // for its own Babel transform and types it through `solid-js`.
       ...framework === "react" ? { jsx: "react-jsx" } : {},
+      ...framework === "solid" ? { jsx: "preserve", jsxImportSource: "solid-js" } : {},
       moduleResolution: "bundler",
       resolveJsonModule: true,
       allowImportingTsExtensions: true,
@@ -378,11 +475,15 @@ function generateServerTsConfig() {
   };
 }
 function generateTaujsConfig(framework) {
-  const pluginImport = framework === "vue" ? `
-import { pluginVue } from '@taujs/vue/plugin';` : "";
-  const pluginsLine = framework === "vue" ? `
-      plugins: [pluginVue()],` : "";
-  return `import { defineConfig } from '@taujs/server/config';${pluginImport}
+  const rendererImport = framework === "vue" ? `
+import { vueRenderer } from '@taujs/vue/renderer';` : framework === "solid" ? `
+import { solidRenderer } from '@taujs/solid/renderer';` : `
+import { reactRenderer } from '@taujs/react/renderer';`;
+  const rendererLine = framework === "vue" ? `
+      renderer: vueRenderer(),` : framework === "solid" ? `
+      renderer: solidRenderer({ project: './tsconfig.solid.json' }),` : `
+      renderer: reactRenderer({ project: './tsconfig.json' }),`;
+  return `import { defineConfig } from '@taujs/server/config';${rendererImport}
 
 export default defineConfig({
   server: {
@@ -390,10 +491,16 @@ export default defineConfig({
     host: 'localhost',
     hmrPort: 5174,
   },
+  // Declared Vite surface - applied to dev and build. See https://taujs.dev/reference/taujs-config/#vite-configuration
+  // vite: {
+  //   define: { __APP_VERSION__: JSON.stringify('0.0.0') },
+  //   plugins: [],
+  // },
+  // alias: { '@components': './src/client/shared/components' },
   apps: [
     {
       appId: 'main',
-      entryPoint: '',${pluginsLine}
+      entryPoint: '',${rendererLine}
       routes: [
         {
           path: '/',
@@ -1065,6 +1172,82 @@ export const { renderSSR, renderStream } = createRenderer({
 });
 `;
 }
+function generateSolidCompilerTsConfig() {
+  return {
+    compilerOptions: {
+      jsx: "preserve",
+      jsxImportSource: "solid-js"
+    },
+    include: ["src/client/**/*.tsx"]
+  };
+}
+function generateSolidRenderId() {
+  return `/**
+ * The renderId is a SHARED constant: the server renders Solid's markers and serialised data under
+ * this namespace, and the client must hydrate under the SAME one. It is imported by BOTH entries
+ * on purpose - a literal duplicated in two files is a hydration bug waiting to happen.
+ */
+export const RENDER_ID = 'app';
+`;
+}
+function generateAppComponentSolid() {
+  return `import { Show } from 'solid-js';
+import { useSSRStore } from '@taujs/solid';
+
+type RouteData = { message?: string };
+
+export function App() {
+  // Route data arrives through the store, which the renderer provides. On the server it is already
+  // committed before the render begins; on the client it is seeded from window.__INITIAL_DATA__.
+  const store = useSSRStore<RouteData>();
+
+  return (
+    <main>
+      <h1>\u03C4js + Solid</h1>
+      <Show when={store.data().message} fallback={<p>No route data.</p>}>
+        <p>{store.data().message}</p>
+      </Show>
+    </main>
+  );
+}
+`;
+}
+function generateEntryClientSolid() {
+  return `import { hydrateApp } from '@taujs/solid';
+
+import { App } from './App';
+import { RENDER_ID } from './renderId';
+
+hydrateApp({
+  app: () => <App />,
+  renderId: RENDER_ID,
+  rootElementId: 'root',
+  onHydrationError: (error) => {
+    console.error('Hydration failed:', error);
+  },
+});
+`;
+}
+function generateEntryServerSolid() {
+  return `import { createRenderer } from '@taujs/solid';
+
+import { App } from './App';
+import { RENDER_ID } from './renderId';
+
+export const { renderSSR, renderStream } = createRenderer({
+  appComponent: () => <App />,
+  renderId: RENDER_ID,
+  headContent: ({ data, meta }) => \`
+    <title>\${meta?.title || "\u03C4js - Composing systems, not just apps"}</title>
+    <meta name="description" content="\${
+      meta?.description ||
+      data?.message ||
+      "\u03C4js - Composing systems, not just apps"
+    }">
+  \`,
+});
+`;
+}
 function generateServerIndex() {
   return `import { createServer } from '@taujs/server';
 import config from '../../taujs.config.ts';
@@ -1098,7 +1281,9 @@ export type ServiceRegistry = typeof serviceRegistry;
 `;
 }
 function generateServiceTypesAugmentation() {
-  return `declare module '@taujs/server/config' {
+  return `import '@taujs/server/config';
+
+declare module '@taujs/server/config' {
   interface ServiceContext {
     tenantId?: string;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taujs/create-taujs",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Scaffold a new τjs application",
   "author": "Aoede <taujs@aoede.uk.net> (https://www.aoede.uk.net)",
   "homepage": "https://taujs.dev/",