@fluojs/cli 2.0.1 → 3.0.0

package/dist/typegen-contract.d.ts

@@ -0,0 +1,10 @@
+/** Stable process exit codes returned by `fluo typegen`. */
+export declare const TYPEGEN_EXIT_CODES: {
+    readonly ERROR: 1;
+    readonly MALFORMED: 4;
+    readonly MISSING: 2;
+    readonly STALE: 3;
+    readonly SUCCESS: 0;
+    readonly UNSUPPORTED_VERSION: 5;
+};
+//# sourceMappingURL=typegen-contract.d.ts.map

package/dist/typegen-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typegen-contract.d.ts","sourceRoot":"","sources":["../src/typegen-contract.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC"}

package/dist/typegen-contract.js

@@ -0,0 +1,9 @@
+/** Stable process exit codes returned by `fluo typegen`. */
+export const TYPEGEN_EXIT_CODES = {
+  ERROR: 1,
+  MALFORMED: 4,
+  MISSING: 2,
+  STALE: 3,
+  SUCCESS: 0,
+  UNSUPPORTED_VERSION: 5
+};

package/dist/usage.d.ts

@@ -10,4 +10,10 @@ export declare function newUsage(): string;
  * @returns Formatted help text including usage and options.
  */
 export declare function inspectUsage(): string;
+/**
+ * Returns the usage information string for React page type generation.
+ *
+ * @returns Formatted help text including required output and optional export arguments.
+ */
+export declare function typegenUsage(): string;
 //# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAiIA;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CA0BjC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAuKA;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CA0BjC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC"}

package/dist/usage.js

@@ -1,5 +1,9 @@
 import { renderAliasList, renderHelpTable } from './help.js';
 const NEW_OPTION_HELP = [{
+  aliases: [],
+  description: 'Select a named starter (standard backend or the React SSR + Vite application).',
+  option: '--starter <standard|react-vite-ssr>'
+}, {
   aliases: [],
   description: 'Provide the project name without using the positional argument.',
   option: '--name <project-name>'
@@ -68,6 +72,10 @@ const INSPECT_OPTION_HELP = [{
   aliases: [],
   description: 'Emit the runtime platform snapshot/diagnostics payload as JSON (default when no output mode is selected).',
   option: '--json'
+}, {
+  aliases: [],
+  description: 'Select JSON output explicitly; equivalent to --json.',
+  option: '--format <json>'
 }, {
   aliases: [],
   description: 'Emit a Mermaid graph through the optional @fluojs/studio rendering contract.',
@@ -93,6 +101,27 @@ const INSPECT_OPTION_HELP = [{
   description: 'Show help for the inspect command.',
   option: '--help'
 }];
+const TYPEGEN_OPTION_HELP = [{
+  aliases: [],
+  description: 'Check that the target exactly matches the compiled React page catalog without writing it.',
+  option: '--check'
+}, {
+  aliases: [],
+  description: 'Write the generated React page route types to this file.',
+  option: '--output <path>'
+}, {
+  aliases: [],
+  description: 'Select the exported module symbol name (default: AppModule).',
+  option: '--export <name>'
+}, {
+  aliases: [],
+  description: 'Regenerate after coalesced changes under the application module directory.',
+  option: '--watch'
+}, {
+  aliases: ['-h'],
+  description: 'Show help for the typegen command.',
+  option: '--help'
+}];
 
 /**
  * Renders CLI help text for `fluo new` without importing the scaffold implementation.
@@ -128,4 +157,22 @@ export function inspectUsage() {
     header: 'Description',
     render: entry => entry.description
   }]), '', 'Docs: https://github.com/fluojs/fluo/tree/main/docs/getting-started/quick-start.md'].join('\n');
+}
+
+/**
+ * Returns the usage information string for React page type generation.
+ *
+ * @returns Formatted help text including required output and optional export arguments.
+ */
+export function typegenUsage() {
+  return ['Usage: fluo typegen <module-path> --output <path> [options]', '', 'Options', renderHelpTable(TYPEGEN_OPTION_HELP, [{
+    header: 'Option',
+    render: entry => entry.option
+  }, {
+    header: 'Aliases',
+    render: entry => renderAliasList(entry.aliases)
+  }, {
+    header: 'Description',
+    render: entry => entry.description
+  }]), '', 'Docs: https://github.com/fluojs/fluo/tree/main/packages/react#path-only-page-type-generation'].join('\n');
 }

package/package.json

@@ -9,7 +9,7 @@
     "migration",
     "diagnostics"
   ],
-  "version": "2.0.1",
+  "version": "3.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -18,7 +18,7 @@
     "directory": "packages/cli"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=24.0.0 <27"
   },
   "publishConfig": {
     "access": "public"
@@ -40,27 +40,36 @@
     "bin"
   ],
   "dependencies": {
-    "@clack/prompts": "^1.2.0",
     "ejs": "^3.1.10",
-    "tsx": "^4.20.4",
-    "typescript": "^6.0.2",
-    "@fluojs/runtime": "^2.0.1"
+    "tsx": "^4.23.1",
+    "typescript": "^6.0.2"
   },
   "peerDependencies": {
-    "@fluojs/studio": "^1.0.8"
+    "@clack/prompts": "^1.3.0",
+    "@fluojs/runtime": "^3.0.0",
+    "@fluojs/studio": "^2.0.0"
   },
   "peerDependenciesMeta": {
+    "@clack/prompts": {
+      "optional": true
+    },
+    "@fluojs/runtime": {
+      "optional": true
+    },
     "@fluojs/studio": {
       "optional": true
     }
   },
   "devDependencies": {
+    "@clack/prompts": "^1.7.0",
     "@types/ejs": "^3.1.5",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.11",
+    "@fluojs/react": "^0.2.0",
+    "@fluojs/runtime": "^3.0.0"
   },
   "scripts": {
-    "prebuild": "node ../../tooling/scripts/clean-dist.mjs",
-    "build": "pnpm exec babel src --extensions .ts --ignore 'src/**/*.test.ts' --out-dir dist --config-file ../../tooling/babel/babel.config.cjs && pnpm exec tsc -p tsconfig.build.json && node -e \"require('fs').cpSync('src/generators/templates', 'dist/generators/templates', {recursive: true})\"",
+    "prebuild": "node ./scripts/generate-published-internal-dependencies.mjs && node ../../tooling/scripts/clean-dist.mjs",
+    "build": "pnpm exec babel src --extensions .ts --ignore 'src/**/*.test.ts' --out-dir dist --config-file ../../tooling/babel/babel.config.cjs && pnpm exec tsc -p tsconfig.build.json && node -e \"const fs=require('fs'); fs.cpSync('src/generators/templates', 'dist/generators/templates', {recursive: true}); fs.cpSync('src/new/templates', 'dist/new/templates', {recursive: true})\"",
     "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
     "test": "pnpm exec vitest run -c vitest.config.ts",
     "test:watch": "pnpm exec vitest -c vitest.config.ts",