@fluojs/cli 1.1.0 → 3.0.0

package/dist/new/prompt.js

@@ -1,14 +1,13 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
-import * as clack from '@clack/prompts';
+import { CliPromptCancelledError } from '../prompt-cancel.js';
 import { resolveBootstrapSchema } from './resolver.js';
 import { DOCUMENTED_MICROSERVICE_TRANSPORTS, getApplicationStarterProfiles } from './starter-profiles.js';
-import { CliPromptCancelledError } from '../prompt-cancel.js';
-
 /** Default package manager used when detection has no signal. */
 export const DEFAULT_PACKAGE_MANAGER = 'pnpm';
 const DEFAULT_INSTALL_DEPENDENCIES = true;
 const DEFAULT_INITIALIZE_GIT = false;
+const CLACK_MISSING_MESSAGE = ['Interactive CLI commands require @clack/prompts, but it is not resolvable from this installation.', 'Install a version whose Node.js engine supports your current Node.js version and rerun the command.'].join('\n');
 const STARTER_SHAPE_CHOICES = [{
   label: 'Application',
   value: 'application'
@@ -19,6 +18,13 @@ const STARTER_SHAPE_CHOICES = [{
   label: 'Mixed',
   value: 'mixed'
 }];
+const STARTER_CHOICES = [{
+  label: 'Standard backend',
+  value: 'standard'
+}, {
+  label: 'React SSR + Vite',
+  value: 'react-vite-ssr'
+}];
 
 /** Prompt contract used by the interactive `fluo new` wizard. */
 
@@ -33,7 +39,18 @@ function resolveCompletionMessage(completionMessage, answers) {
 function hasOwnValue(partial, key) {
   return partial[key] !== undefined;
 }
-function createBootstrapPrompter() {
+async function loadClackPrompts() {
+  try {
+    return await import('@clack/prompts');
+  } catch (error) {
+    const code = typeof error === 'object' && error !== null && 'code' in error ? error.code : undefined;
+    if (code === 'MODULE_NOT_FOUND' || code === 'ERR_MODULE_NOT_FOUND') {
+      throw new Error(CLACK_MISSING_MESSAGE);
+    }
+    throw error;
+  }
+}
+async function createBootstrapPrompter(clack) {
   return {
     async confirm(message, defaultValue) {
       const result = await clack.confirm({
@@ -80,7 +97,8 @@ function createBootstrapPrompter() {
 }
 function shouldPromptForAnswers(partial, interactive) {
   const selectedRuntime = partial.runtime;
-  return interactive && (!hasOwnValue(partial, 'projectName') || !hasOwnValue(partial, 'shape') || !hasOwnValue(partial, 'tooling') || !hasOwnValue(partial, 'packageManager') || !hasOwnValue(partial, 'installDependencies') || !hasOwnValue(partial, 'initializeGit') || partial.shape === 'application' && !hasOwnValue(partial, 'runtime') || partial.shape === 'application' && selectedRuntime === 'node' && !hasOwnValue(partial, 'platform') || partial.shape === 'microservice' && !hasOwnValue(partial, 'transport'));
+  const needsStarterSelection = !hasOwnValue(partial, 'starter') && !hasOwnValue(partial, 'shape') && !hasOwnValue(partial, 'runtime') && !hasOwnValue(partial, 'platform') && !hasOwnValue(partial, 'transport');
+  return interactive && (!hasOwnValue(partial, 'projectName') || needsStarterSelection || !hasOwnValue(partial, 'shape') || !hasOwnValue(partial, 'tooling') || !hasOwnValue(partial, 'packageManager') || !hasOwnValue(partial, 'installDependencies') || !hasOwnValue(partial, 'initializeGit') || partial.shape === 'application' && !hasOwnValue(partial, 'runtime') || partial.shape === 'application' && selectedRuntime === 'node' && !hasOwnValue(partial, 'platform') || partial.shape === 'microservice' && !hasOwnValue(partial, 'transport'));
 }
 async function resolveInteractiveBootstrapAnswers(partial, cwd, userAgent, prompt) {
   const answers = {
@@ -90,10 +108,17 @@ async function resolveInteractiveBootstrapAnswers(partial, cwd, userAgent, promp
   if (!answers.projectName) {
     answers.projectName = assertValidProjectName(await prompt.text('Project name'));
   }
-  if (!answers.shape) {
+  if (!answers.starter) {
+    const hasSchemaSelection = answers.shape !== undefined || answers.runtime !== undefined || answers.platform !== undefined || answers.transport !== undefined;
+    answers.starter = hasSchemaSelection ? 'standard' : await prompt.select('Starter', STARTER_CHOICES, 'standard');
+  }
+  if (answers.starter === 'react-vite-ssr') {
+    Object.assign(answers, resolveBootstrapSchema(answers));
+  }
+  if (answers.starter === 'standard' && !answers.shape) {
     answers.shape = await prompt.select('Starter shape', STARTER_SHAPE_CHOICES, 'application');
   }
-  if (answers.shape === 'application' && !answers.runtime) {
+  if (answers.starter === 'standard' && answers.shape === 'application' && !answers.runtime) {
     answers.runtime = await prompt.select('Runtime', [{
       label: 'Bun',
       value: 'bun'
@@ -108,7 +133,7 @@ async function resolveInteractiveBootstrapAnswers(partial, cwd, userAgent, promp
       value: 'node'
     }], 'node');
   }
-  if (answers.shape === 'application' && !answers.platform) {
+  if (answers.starter === 'standard' && answers.shape === 'application' && !answers.platform) {
     if (answers.runtime === 'node') {
       const applicationProfiles = getApplicationStarterProfiles('node');
       answers.platform = await prompt.select('HTTP platform', applicationProfiles.map(profile => ({
@@ -119,7 +144,7 @@ async function resolveInteractiveBootstrapAnswers(partial, cwd, userAgent, promp
       answers.platform = answers.runtime;
     }
   }
-  if (answers.shape === 'microservice' && !answers.transport) {
+  if (answers.starter === 'standard' && answers.shape === 'microservice' && !answers.transport) {
     answers.transport = await prompt.select('Microservice transport', DOCUMENTED_MICROSERVICE_TRANSPORTS.map(transport => ({
       label: transport,
       value: transport
@@ -251,6 +276,7 @@ export function resolveBootstrapAnswers(partial, cwd, userAgent) {
     packageManager: partial.packageManager ?? detectPackageManager(cwd, userAgent),
     ...schema,
     projectName,
+    starter: partial.starter ?? 'standard',
     targetDirectory: partial.targetDirectory ?? `./${projectName}`
   };
 }
@@ -269,15 +295,17 @@ export async function collectBootstrapAnswers(partial, cwd, userAgent, options =
   if (!shouldPromptForAnswers(partial, interactive)) {
     return resolveBootstrapAnswers(partial, cwd, userAgent);
   }
-  const prompt = options.prompt ?? createBootstrapPrompter();
   const isInteractiveShell = options.prompt === undefined;
+  options.onInteractivePrompt?.();
+  const clack = isInteractiveShell ? await loadClackPrompts() : undefined;
+  const prompt = options.prompt ?? (await createBootstrapPrompter(clack ?? (await loadClackPrompts())));
   try {
     if (isInteractiveShell) {
-      clack.intro('fluo new');
+      clack?.intro('fluo new');
     }
     const answers = await resolveInteractiveBootstrapAnswers(partial, cwd, userAgent, prompt);
     if (isInteractiveShell) {
-      clack.outro(resolveCompletionMessage(options.completionMessage, answers));
+      clack?.outro(resolveCompletionMessage(options.completionMessage, answers));
     }
     return answers;
   } finally {

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;AA8xEnE;;;;;;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"}