@fluojs/cli 2.0.1 → 3.0.0

package/dist/new/published-internal-dependencies.d.ts

@@ -0,0 +1,20 @@
+/** Per-package release ranges for all published starter dependencies except the generator CLI itself. */
+export declare const PUBLISHED_INTERNAL_DEPENDENCIES: {
+    readonly "@fluojs/config": "^2.0.0";
+    readonly "@fluojs/core": "^2.0.0";
+    readonly "@fluojs/di": "^3.0.0";
+    readonly "@fluojs/http": "^3.0.0";
+    readonly "@fluojs/microservices": "^2.0.0";
+    readonly "@fluojs/platform-bun": "^3.0.0";
+    readonly "@fluojs/platform-cloudflare-workers": "^2.0.0";
+    readonly "@fluojs/platform-deno": "^2.0.0";
+    readonly "@fluojs/platform-express": "^2.0.0";
+    readonly "@fluojs/platform-fastify": "^2.0.0";
+    readonly "@fluojs/platform-nodejs": "^2.0.0";
+    readonly "@fluojs/react": "^0.2.0";
+    readonly "@fluojs/runtime": "^3.0.0";
+    readonly "@fluojs/testing": "^3.0.0";
+    readonly "@fluojs/validation": "^2.0.0";
+    readonly "@fluojs/vite": "^2.0.0";
+};
+//# sourceMappingURL=published-internal-dependencies.d.ts.map

package/dist/new/published-internal-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"published-internal-dependencies.d.ts","sourceRoot":"","sources":["../../src/new/published-internal-dependencies.ts"],"names":[],"mappings":"AACA,yGAAyG;AACzG,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;CAiBlC,CAAC"}

package/dist/new/published-internal-dependencies.js

@@ -0,0 +1,20 @@
+// Generated by scripts/generate-published-internal-dependencies.mjs during the CLI build.
+/** Per-package release ranges for all published starter dependencies except the generator CLI itself. */
+export const PUBLISHED_INTERNAL_DEPENDENCIES = {
+  "@fluojs/config": "^2.0.0",
+  "@fluojs/core": "^2.0.0",
+  "@fluojs/di": "^3.0.0",
+  "@fluojs/http": "^3.0.0",
+  "@fluojs/microservices": "^2.0.0",
+  "@fluojs/platform-bun": "^3.0.0",
+  "@fluojs/platform-cloudflare-workers": "^2.0.0",
+  "@fluojs/platform-deno": "^2.0.0",
+  "@fluojs/platform-express": "^2.0.0",
+  "@fluojs/platform-fastify": "^2.0.0",
+  "@fluojs/platform-nodejs": "^2.0.0",
+  "@fluojs/react": "^0.2.0",
+  "@fluojs/runtime": "^3.0.0",
+  "@fluojs/testing": "^3.0.0",
+  "@fluojs/validation": "^2.0.0",
+  "@fluojs/vite": "^2.0.0"
+};

package/dist/new/react-vite-ssr-scaffold.d.ts

@@ -0,0 +1,19 @@
+import type { PackageManager } from './types.js';
+type ReactViteSsrTemplateContext = {
+    readonly packageManager: PackageManager;
+    readonly projectName: string;
+};
+type ReactViteSsrScaffoldFile = {
+    content: string;
+    path: string;
+};
+/**
+ * Renders the React SSR + Vite starter template tree with explicit lifecycle commands.
+ *
+ * @param context Validated project and package-manager command values for template rendering.
+ * @param importMetaUrl Module URL used to locate packaged starter templates.
+ * @returns Generated scaffold files with rendered template content.
+ */
+export declare function createReactViteSsrScaffoldFiles(context: ReactViteSsrTemplateContext, importMetaUrl?: string): ReactViteSsrScaffoldFile[];
+export {};
+//# sourceMappingURL=react-vite-ssr-scaffold.d.ts.map

package/dist/new/react-vite-ssr-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-vite-ssr-scaffold.d.ts","sourceRoot":"","sources":["../../src/new/react-vite-ssr-scaffold.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjD,KAAK,2BAA2B,GAAG;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAmEF;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,2BAA2B,EACpC,aAAa,SAAkB,GAC9B,wBAAwB,EAAE,CAkB5B"}

package/dist/new/react-vite-ssr-scaffold.js

@@ -0,0 +1,108 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const INSTALL_COMMAND_BY_PACKAGE_MANAGER = {
+  bun: 'bun install',
+  npm: 'npm install',
+  pnpm: 'pnpm install',
+  yarn: 'yarn install'
+};
+const RUN_PREFIX_BY_PACKAGE_MANAGER = {
+  bun: 'bun run',
+  npm: 'npm run',
+  pnpm: 'pnpm',
+  yarn: 'yarn'
+};
+const REACT_VITE_SSR_TEMPLATES = [{
+  outputPath: 'README.md',
+  templatePath: 'README.md.ejs'
+}, {
+  outputPath: 'playwright.config.ts',
+  templatePath: 'playwright.config.ts.ejs'
+}, {
+  outputPath: 'tsconfig.json',
+  templatePath: 'tsconfig.json.ejs'
+}, {
+  outputPath: 'vite.client.config.ts',
+  templatePath: 'vite.client.config.ts.ejs'
+}, {
+  outputPath: 'vite.server.config.ts',
+  templatePath: 'vite.server.config.ts.ejs'
+}, {
+  outputPath: 'vitest.config.ts',
+  templatePath: 'vitest.config.ts.ejs'
+}, {
+  outputPath: 'src/app.test.ts',
+  templatePath: 'src/app.test.ts.ejs'
+}, {
+  outputPath: 'src/app.ts',
+  templatePath: 'src/app.ts.ejs'
+}, {
+  outputPath: 'src/entry-client.tsx',
+  templatePath: 'src/entry-client.tsx.ejs'
+}, {
+  outputPath: 'src/entry-server.tsx',
+  templatePath: 'src/entry-server.tsx.ejs'
+}, {
+  outputPath: 'src/load-manifest.test.ts',
+  templatePath: 'src/load-manifest.test.ts.ejs'
+}, {
+  outputPath: 'src/load-manifest.ts',
+  templatePath: 'src/load-manifest.ts.ejs'
+}, {
+  outputPath: 'src/main.ts',
+  templatePath: 'src/main.ts.ejs'
+}, {
+  outputPath: 'src/page.tsx',
+  templatePath: 'src/page.tsx.ejs'
+}, {
+  outputPath: 'src/react-app.test.tsx',
+  templatePath: 'src/react-app.test.tsx.ejs'
+}, {
+  outputPath: 'src/react-app.tsx',
+  templatePath: 'src/react-app.tsx.ejs'
+}, {
+  outputPath: 'src/styles.css',
+  templatePath: 'src/styles.css.ejs'
+}, {
+  outputPath: 'src/styles.d.ts',
+  templatePath: 'src/styles.d.ts.ejs'
+}, {
+  outputPath: 'tests/production-hydration.spec.ts',
+  templatePath: 'tests/production-hydration.spec.ts.ejs'
+}];
+function resolveTemplateDirectory(importMetaUrl) {
+  return join(dirname(fileURLToPath(importMetaUrl)), 'templates', 'react-vite-ssr');
+}
+function createLifecycleCommands(packageManager) {
+  const runPrefix = RUN_PREFIX_BY_PACKAGE_MANAGER[packageManager];
+  const run = script => `${runPrefix} ${script}`;
+  return {
+    build: run('build'),
+    dev: run('dev'),
+    install: INSTALL_COMMAND_BY_PACKAGE_MANAGER[packageManager],
+    start: run('start'),
+    test: run('test'),
+    testBrowser: run('test:browser'),
+    typecheck: run('typecheck')
+  };
+}
+
+/**
+ * Renders the React SSR + Vite starter template tree with explicit lifecycle commands.
+ *
+ * @param context Validated project and package-manager command values for template rendering.
+ * @param importMetaUrl Module URL used to locate packaged starter templates.
+ * @returns Generated scaffold files with rendered template content.
+ */
+export function createReactViteSsrScaffoldFiles(context, importMetaUrl = import.meta.url) {
+  const templateDirectory = resolveTemplateDirectory(importMetaUrl);
+  const commands = createLifecycleCommands(context.packageManager);
+  return REACT_VITE_SSR_TEMPLATES.map(({
+    outputPath,
+    templatePath
+  }) => ({
+    content: readFileSync(join(templateDirectory, templatePath), 'utf8').replaceAll('<%= projectName %>', context.projectName).replaceAll('<%= installCommand %>', commands.install).replaceAll('<%= devCommand %>', commands.dev).replaceAll('<%= buildCommand %>', commands.build).replaceAll('<%= startCommand %>', commands.start).replaceAll('<%= testCommand %>', commands.test).replaceAll('<%= testBrowserCommand %>', commands.testBrowser).replaceAll('<%= typecheckCommand %>', commands.typecheck).replaceAll('<%= devCommandJson %>', JSON.stringify(commands.dev)).replaceAll('<%= startCommandJson %>', JSON.stringify(commands.start)),
+    path: outputPath
+  }));
+}

package/dist/new/resolver.d.ts

@@ -1,6 +1,6 @@
-import type { BootstrapOptions, BootstrapSchema } from './types.js';
 import { type StarterProfile } from './starter-profiles.js';
-type BootstrapResolutionInput = Partial<BootstrapSchema> & Pick<Partial<BootstrapOptions>, 'packageManager'>;
+import type { BootstrapOptions, BootstrapSchema } from './types.js';
+type BootstrapResolutionInput = Partial<BootstrapSchema> & Pick<Partial<BootstrapOptions>, 'packageManager' | 'starter'>;
 /**
  * Shape-first compatibility baseline for `fluo new` until additional starter variants ship.
  */

package/dist/new/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/new/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAGhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAYL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAE/B,KAAK,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAE7G;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAA6C,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAC7C,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;CACzB;AAyBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAe9F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,gBAAgB,GAAG,qBAAqB,CAkFhH"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/new/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EAOpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAEpB,KAAK,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAEzH;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAA6C,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAC7C,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;CACzB;AAyBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAe9F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,gBAAgB,GAAG,qBAAqB,CA0FhH"}

package/dist/new/resolver.js

@@ -52,7 +52,8 @@ export function resolveBootstrapSchema(partial = {}) {
  */
 export function resolveBootstrapPlan(options) {
   const schema = resolveBootstrapSchema(options);
-  const starterProfile = getStarterProfileFromSchema(schema);
+  const starter = options.starter ?? 'standard';
+  const starterProfile = getStarterProfileFromSchema(schema, starter);
   if (starterProfile) {
     return {
       dependencies: starterProfile.dependencies,
@@ -62,6 +63,9 @@ export function resolveBootstrapPlan(options) {
     };
   }
   const defaultProfile = getStarterProfileForShape(schema.shape);
+  if (starter === 'react-vite-ssr') {
+    throw new Error(`Unsupported react-vite-ssr starter schema "${schema.shape}/${schema.runtime}/${schema.transport}/${schema.platform}/${schema.tooling}/${schema.topology.mode}". ` + 'The React SSR + Vite starter requires application/node/http/fastify/standard/single-package.');
+  }
   if (schema.shape === 'microservice' && schema.transport === 'http') {
     throw new Error('Unsupported bootstrap schema "microservice/node/http/' + schema.platform + '/standard/single-package". ' + 'Microservice starters require a transport-aware microservice transport such as tcp, redis-streams, mqtt, grpc, nats, kafka, or rabbitmq.');
   }

package/dist/new/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/new/scaffold.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AA03EnE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,6BAAuB,CAAC"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/new/scaffold.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAq5EnE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,6BAAuB,CAAC"}

package/dist/new/scaffold.js

@@ -3,6 +3,8 @@ import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { initializeGitRepository, installDependencies } from './install.js';
 import { resolvePackageSpecs } from './package-spec-resolver.js';
+import { PUBLISHED_INTERNAL_DEPENDENCIES } from './published-internal-dependencies.js';
+import { createReactViteSsrScaffoldFiles } from './react-vite-ssr-scaffold.js';
 import { resolveBootstrapPlan } from './resolver.js';
 const PUBLISHED_DEV_DEPENDENCIES = {
   '@babel/cli': '^7.26.4',
@@ -11,39 +13,29 @@ const PUBLISHED_DEV_DEPENDENCIES = {
   '@babel/preset-typescript': '^7.27.1',
   '@types/babel__core': '^7.20.5',
   '@types/node': '^22.13.10',
-  '@vitest/coverage-v8': '^3.0.8',
-  tsx: '^4.20.4',
+  '@vitest/coverage-v8': '^4.1.11',
+  tsx: '^4.23.1',
   typescript: '^6.0.2',
-  vite: '^6.2.1',
-  vitest: '^3.0.8'
+  vite: '^8.2.2',
+  vitest: '^4.1.11'
 };
 const PUBLISHED_RUNTIME_DEPENDENCIES = {
+  '@playwright/test': '^1.51.1',
+  '@types/react': '^19.2.14',
+  '@types/react-dom': '^19.2.3',
   '@types/amqplib': '^0.10.7',
-  '@grpc/grpc-js': '^1.0.0',
+  '@grpc/grpc-js': '^1.14.4',
   '@grpc/proto-loader': '^0.8.0',
   amqplib: '^0.10.5',
   ioredis: '^5.0.0',
   kafkajs: '^2.2.4',
   mqtt: '^5.0.0',
-  nats: '^2.29.3'
-};
-const PUBLISHED_INTERNAL_DEPENDENCIES = {
-  '@fluojs/config': '^1.0.0',
-  '@fluojs/core': '^1.0.0',
-  '@fluojs/di': '^1.0.0',
-  '@fluojs/http': '^1.0.0',
-  '@fluojs/microservices': '^1.0.0',
-  '@fluojs/platform-bun': '^1.0.0',
-  '@fluojs/platform-cloudflare-workers': '^1.0.0',
-  '@fluojs/platform-deno': '^1.0.0',
-  '@fluojs/platform-express': '^1.0.0',
-  '@fluojs/platform-fastify': '^1.0.0',
-  '@fluojs/platform-nodejs': '^1.0.0',
-  '@fluojs/runtime': '^1.0.0',
-  '@fluojs/testing': '^1.0.0',
-  '@fluojs/validation': '^1.0.0',
-  '@fluojs/vite': '^1.0.0'
+  nats: '^2.29.3',
+  'happy-dom': '^20.9.0',
+  react: '^19.2.6',
+  'react-dom': '^19.2.6'
 };
+const NODE_HTTP_LISTENER_ENGINE = '>=24.0.0 <27';
 function describeApplicationStarter(options) {
   if (options.runtime === 'bun') {
     return {
@@ -153,6 +145,16 @@ function createExecCommand(packageManager, command) {
 }
 function createProjectScripts(bootstrapPlan) {
   switch (bootstrapPlan.profile.id) {
+    case 'application-node-fastify-react-vite-ssr':
+      return {
+        build: 'vite build --config vite.client.config.ts && vite build --config vite.server.config.ts',
+        dev: 'vite build --config vite.client.config.ts && vite build --config vite.server.config.ts && node dist/server/main.js',
+        start: 'node dist/server/main.js',
+        test: 'vitest run',
+        'test:browser': 'playwright test --config playwright.config.ts',
+        'test:watch': 'vitest',
+        typecheck: 'tsc -p tsconfig.json --noEmit'
+      };
     case 'application-bun-bun-http':
       return {
         build: 'bun build ./src/main.ts --outdir ./dist --target bun',
@@ -210,9 +212,17 @@ function createProjectEngines(bootstrapPlan) {
       return {
         deno: '>=2.0.0'
       };
+    case 'application-node-fastify-http':
+    case 'application-node-fastify-react-vite-ssr':
+    case 'application-node-express-http':
+    case 'application-node-nodejs-http':
+    case 'mixed-node-fastify-tcp':
+      return {
+        node: NODE_HTTP_LISTENER_ENGINE
+      };
     default:
       return {
-        node: '>=20.0.0'
+        node: NODE_HTTP_LISTENER_ENGINE
       };
   }
 }
@@ -233,7 +243,8 @@ function createPublishedDevDependencies(bootstrapPlan) {
     };
   }
   return {
-    ...PUBLISHED_DEV_DEPENDENCIES
+    ...PUBLISHED_DEV_DEPENDENCIES,
+    '@types/node': '^24.0.0'
   };
 }
 function createProjectPackageJson(options, bootstrapPlan, releaseVersion, packageSpecs) {
@@ -302,13 +313,12 @@ function createProjectTsconfigBuild() {
 }
 function createBabelConfig() {
   return `module.exports = {
-  ignore: ['src/**/*.test.ts'],
   presets: [['@babel/preset-typescript', { allowDeclareFields: true }]],
   plugins: [['@babel/plugin-proposal-decorators', { version: '2023-11' }]],
 };
 `;
 }
-function createViteConfig() {
+function createViteConfig(bootstrapPlan) {
   return `import { fluoDecoratorsPlugin } from '@fluojs/vite';
 import { defineConfig } from 'vite';
 
@@ -317,13 +327,13 @@ export default defineConfig({
   build: {
     emptyOutDir: true,
     outDir: 'dist',
-    rollupOptions: {
+    rolldownOptions: {
       output: {
         entryFileNames: 'main.js',
       },
     },
     ssr: 'src/main.ts',
-    target: 'node20',
+    target: '${bootstrapPlan.schema.runtime === 'node' ? 'node24' : 'node20'}',
   },
   server: {
     port: 5173,
@@ -2085,11 +2095,29 @@ function createWranglerConfig(projectName) {
 }
 function emitSharedScaffoldFiles(options, bootstrapPlan, releaseVersion, packageSpecs) {
   const envFile = createEnvFile(bootstrapPlan);
+  if (bootstrapPlan.profile.id === 'application-node-fastify-react-vite-ssr') {
+    return [{
+      content: createProjectPackageJson(options, bootstrapPlan, releaseVersion, packageSpecs),
+      path: 'package.json'
+    }, ...createReactViteSsrScaffoldFiles({
+      packageManager: options.packageManager,
+      projectName: options.projectName
+    }), {
+      content: createBabelConfig(),
+      path: 'babel.config.cjs'
+    }, {
+      content: createGitignore(),
+      path: '.gitignore'
+    }, ...(envFile ? [{
+      content: envFile,
+      path: '.env'
+    }] : [])];
+  }
   const sharedFiles = [{
     content: createProjectPackageJson(options, bootstrapPlan, releaseVersion, packageSpecs),
     path: 'package.json'
   }, {
-    content: createProjectReadme(options, bootstrapPlan),
+    content: createProjectReadme(options, bootstrapPlan) + (bootstrapPlan.schema.runtime === 'node' ? '\n## Node.js support\n\nRequires Node.js `>=24.0.0 <27`. Use Node 24 LTS for local development, CI, and container images. Node builds target `node24` and use `@types/node@^24.0.0`.\n' : ''),
     path: 'README.md'
   }, {
     content: createGitignore(),
@@ -2106,7 +2134,7 @@ function emitSharedScaffoldFiles(options, bootstrapPlan, releaseVersion, package
       content: createBabelConfig(),
       path: 'babel.config.cjs'
     }, {
-      content: createViteConfig(),
+      content: createViteConfig(bootstrapPlan),
       path: 'vite.config.ts'
     }, {
       content: createVitestConfig(),
@@ -2181,6 +2209,9 @@ function emitApplicationScaffoldFiles(options) {
   return files;
 }
 function emitScaffoldFilesForRecipe(options, recipeId) {
+  if (recipeId === 'application-node-fastify-react-vite-ssr') {
+    return [];
+  }
   if (recipeId === 'application-bun-bun-http' || recipeId === 'application-cloudflare-workers-cloudflare-workers-http' || recipeId === 'application-deno-deno-http' || recipeId === 'application-node-fastify-http' || recipeId === 'application-node-express-http' || recipeId === 'application-node-nodejs-http') {
     return emitApplicationScaffoldFiles(options);
   }

package/dist/new/starter-profiles.d.ts

@@ -1,8 +1,8 @@
-import type { BootstrapPlatform, BootstrapRuntime, BootstrapSchema, BootstrapShape, BootstrapToolingPreset, BootstrapTopology, BootstrapTransport } from './types.js';
+import type { BootstrapPlatform, BootstrapRuntime, BootstrapSchema, BootstrapShape, BootstrapStarter, BootstrapToolingPreset, BootstrapTopology, BootstrapTransport } from './types.js';
 /** Emitter families that decide which scaffold template tree renders the starter. */
-export type StarterEmitterType = 'http' | 'microservice' | 'mixed';
+export type StarterEmitterType = 'http' | 'microservice' | 'mixed' | 'react-vite-ssr';
 /** Stable IDs for the scaffold recipes currently shipped by `fluo new`. */
-export type StarterScaffoldRecipeId = 'application-bun-bun-http' | 'application-cloudflare-workers-cloudflare-workers-http' | 'application-deno-deno-http' | 'application-node-express-http' | 'application-node-fastify-http' | 'application-node-nodejs-http' | 'microservice-node-none-grpc' | 'microservice-node-none-kafka' | 'microservice-node-none-mqtt' | 'microservice-node-none-nats' | 'microservice-node-none-rabbitmq' | 'microservice-node-none-redis-streams' | 'microservice-node-none-tcp' | 'mixed-node-fastify-tcp';
+export type StarterScaffoldRecipeId = 'application-bun-bun-http' | 'application-cloudflare-workers-cloudflare-workers-http' | 'application-deno-deno-http' | 'application-node-express-http' | 'application-node-fastify-http' | 'application-node-fastify-react-vite-ssr' | 'application-node-nodejs-http' | 'microservice-node-none-grpc' | 'microservice-node-none-kafka' | 'microservice-node-none-mqtt' | 'microservice-node-none-nats' | 'microservice-node-none-rabbitmq' | 'microservice-node-none-redis-streams' | 'microservice-node-none-tcp' | 'mixed-node-fastify-tcp';
 type StarterDependencies = {
     dependencies: readonly string[];
     devDependencies: readonly string[];
@@ -21,6 +21,7 @@ export interface StarterProfile {
     platformPromptLabel?: string;
     promptLabel: string;
     schema: BootstrapSchema;
+    starter: BootstrapStarter;
 }
 /** Supported microservice starter transports recognized by `fluo new`. */
 export declare const SUPPORTED_MICROSERVICE_STARTER_TRANSPORTS: readonly BootstrapTransport[];
@@ -40,6 +41,8 @@ export declare const SUPPORTED_BOOTSTRAP_TRANSPORTS: readonly BootstrapTransport
 export declare const SUPPORTED_BOOTSTRAP_TOOLING_PRESETS: readonly BootstrapToolingPreset[];
 /** Supported topology modes accepted by the current starter matrix. */
 export declare const SUPPORTED_BOOTSTRAP_TOPOLOGY_MODES: readonly BootstrapTopology['mode'][];
+/** Named starter variants accepted by `fluo new`. */
+export declare const SUPPORTED_BOOTSTRAP_STARTERS: readonly BootstrapStarter[];
 /** Default starter profile used for shape-less `fluo new` invocations. */
 export declare const DEFAULT_BOOTSTRAP_PROFILE: StarterProfile;
 /**
@@ -75,9 +78,10 @@ export declare function getDefaultBootstrapSchema(): BootstrapSchema;
  * Finds the starter profile that exactly matches a resolved bootstrap schema.
  *
  * @param schema Fully resolved bootstrap schema.
+ * @param starter Named starter variant selected by the caller.
  * @returns The matching starter profile, or `undefined` when the schema is validation-only.
  */
-export declare function getStarterProfileFromSchema(schema: BootstrapSchema): StarterProfile | undefined;
+export declare function getStarterProfileFromSchema(schema: BootstrapSchema, starter?: BootstrapStarter): StarterProfile | undefined;
 /**
  * Checks whether one transport belongs to the supported microservice starter transport family.
  *

package/dist/new/starter-profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"starter-profiles.d.ts","sourceRoot":"","sources":["../../src/new/starter-profiles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"starter-profiles.d.ts","sourceRoot":"","sources":["../../src/new/starter-profiles.ts"],"names":[],"mappings":"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"}