@fluojs/cli 1.1.0 → 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

@@ -0,0 +1,19 @@
+/**
+ * Renders CLI help text for `fluo new` without importing the scaffold implementation.
+ *
+ * @returns Stable help output for the scaffolding command.
+ */
+export declare function newUsage(): string;
+/**
+ * Returns the usage information string for the inspect command without importing runtime inspection logic.
+ *
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,178 @@
+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>'
+}, {
+  aliases: [],
+  description: 'Select the scaffold shape explicitly (application for HTTP, microservice for the transport-driven starter path, mixed for the API + microservice starter).',
+  option: '--shape <application|microservice|mixed>'
+}, {
+  aliases: [],
+  description: 'Select the transport path explicitly (http for applications, tcp for the runnable microservice starter, plus shipped microservice starter transports).',
+  option: '--transport <http|tcp|redis-streams|nats|kafka|rabbitmq|mqtt|grpc>'
+}, {
+  aliases: [],
+  description: 'Select the runtime explicitly (node, bun, deno, or cloudflare-workers for application starters; node for microservice and mixed starters).',
+  option: '--runtime <node|bun|deno|cloudflare-workers>'
+}, {
+  aliases: [],
+  description: 'Select the platform adapter explicitly (fastify, express, or nodejs on node; bun/deno/cloudflare-workers on their native runtimes; none for microservices).',
+  option: '--platform <fastify|express|nodejs|bun|deno|cloudflare-workers|none>'
+}, {
+  aliases: [],
+  description: 'Select the starter tooling preset explicitly (currently only standard).',
+  option: '--tooling <standard>'
+}, {
+  aliases: [],
+  description: 'Select the starter topology mode explicitly (currently only single-package).',
+  option: '--topology <single-package>'
+}, {
+  aliases: [],
+  description: 'Choose which package manager installs the starter dependencies.',
+  option: '--package-manager <pnpm|npm|yarn|bun>'
+}, {
+  aliases: [],
+  description: 'Write the new app to a custom target directory (always overrides positional name path).',
+  option: '--target-directory <path>'
+}, {
+  aliases: [],
+  description: 'Overwrite files in a non-empty target directory without prompting.',
+  option: '--force'
+}, {
+  aliases: [],
+  description: 'Install starter dependencies after writing files.',
+  option: '--install'
+}, {
+  aliases: [],
+  description: 'Skip starter dependency installation.',
+  option: '--no-install'
+}, {
+  aliases: [],
+  description: 'Initialize a git repository in the generated starter.',
+  option: '--git'
+}, {
+  aliases: [],
+  description: 'Skip git repository initialization in the generated starter.',
+  option: '--no-git'
+}, {
+  aliases: [],
+  description: 'Print the resolved scaffold plan without writing files, installing dependencies, or initializing git.',
+  option: '--print-plan'
+}, {
+  aliases: ['-h'],
+  description: 'Show help for the new command.',
+  option: '--help'
+}];
+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.',
+  option: '--mermaid'
+}, {
+  aliases: [],
+  description: 'Include bootstrap timing diagnostics next to JSON inspect output.',
+  option: '--timing'
+}, {
+  aliases: [],
+  description: 'Emit a CI-friendly JSON report with summary, snapshot, diagnostics, and timing.',
+  option: '--report'
+}, {
+  aliases: [],
+  description: 'Write the selected inspect payload to a file instead of stdout.',
+  option: '--output <path>'
+}, {
+  aliases: [],
+  description: 'Select the exported module symbol name (default: AppModule).',
+  option: '--export <name>'
+}, {
+  aliases: ['-h'],
+  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.
+ *
+ * @returns Stable help output for the scaffolding command.
+ */
+export function newUsage() {
+  return ['Usage: fluo new|create [project-name] [options]', '', 'Options', renderHelpTable(NEW_OPTION_HELP, [{
+    header: 'Option',
+    render: entry => entry.option
+  }, {
+    header: 'Aliases',
+    render: entry => renderAliasList(entry.aliases)
+  }, {
+    header: 'Description',
+    render: entry => entry.description
+  }]), '', 'Next steps:', '  cd <app-name>', '  pnpm dev  # runs fluo dev from the generated package.json script', '', 'Docs: https://github.com/fluojs/fluo/tree/main/docs/getting-started/quick-start.md'].join('\n');
+}
+
+/**
+ * Returns the usage information string for the inspect command without importing runtime inspection logic.
+ *
+ * @returns Formatted help text including usage and options.
+ */
+export function inspectUsage() {
+  return ['Usage: fluo inspect <module-path> [options]', '', 'Options', renderHelpTable(INSPECT_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/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": "1.1.0",
+  "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": "^1.1.8"
+    "tsx": "^4.23.1",
+    "typescript": "^6.0.2"
   },
   "peerDependencies": {
-    "@fluojs/studio": "^1.0.7"
+    "@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",