@nexusts/cli 0.7.0 → 0.7.2

package/dist/core/fs.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Filesystem helpers for the CLI.
+ */
+export interface WriteOptions {
+    /** Skip writing if the file exists. Default `false` (overwrite OK). */
+    skipIfExists?: boolean;
+    /** Make the path absolute relative to this directory. Default cwd. */
+    base?: string;
+}
+/**
+ * Write a file, creating parent directories as needed.
+ * Throws if `skipIfExists` is `true` and the file already exists.
+ */
+export declare function writeFile(path: string, contents: string, opts?: WriteOptions): boolean;
+/**
+ * Read a file, or return `undefined` if missing.
+ */
+export declare function readFile(path: string): string | undefined;
+/** True if a file exists at the given path. */
+export declare function fileExists(path: string): boolean;
+/** True if a directory exists at the given path. */
+export declare function directoryExists(path: string): boolean;
+/** Compute a project-relative path. */
+export declare function relativePath(from: string, to: string): string;
+/**
+ * Convert a name like "User", "user", "users", "user_profile" into a
+ * consistent set of variants used by templates.
+ */
+export declare function nameVariants(input: string): {
+    pascal: string;
+    camel: string;
+    snake: string;
+    kebab: string;
+    plural: string;
+    pluralSnake: string;
+    pluralKebab: string;
+};

package/dist/core/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Re-exports for the CLI core.
+ */
+export * from "./args.js";
+export * from "./config.js";
+export * from "./fs.js";
+export * from "./logger.js";
+export * from "./loose-json.js";
+export * from "./prompts.js";
+export * from "./template.js";
+/**
+ * The CLI command contract. Every command module exports a default
+ * `Command` object that the entry point dispatches against.
+ */
+export interface Command {
+    /** Primary command name, e.g. `"make:controller"`. */
+    name: string;
+    /** Aliases (`"mc"` for `make:controller`). */
+    aliases?: string[];
+    /** One-line summary for `nx help`. */
+    summary: string;
+    /** Detailed description for `nx help <command>`. */
+    description?: string;
+    /** Example invocations. */
+    examples?: string[];
+    /** Flag schema (used for `nx help <command>` rendering). */
+    flags?: Array<{
+        name: string;
+        short?: string;
+        description: string;
+        default?: string | boolean;
+        required?: boolean;
+    }>;
+    /** The handler. Receives parsed args + cwd + loaded config. */
+    run(ctx: CommandContext): Promise<number>;
+}
+export interface CommandContext {
+    cwd: string;
+    config: import("./config.js").NxConfig;
+    positional: string[];
+    flags: Record<string, string | boolean | string[]>;
+}

package/dist/core/logger.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Colored logger for the `nx` CLI.
+ *
+ * Mirrors the look-and-feel of Adonis ACE / Rails:
+ *   - info    → cyan
+ *   - success → green
+ *   - warn    → yellow
+ *   - error   → red
+ *   - debug   → dim gray
+ *
+ * Honors the `NO_COLOR` env var and disables color when stdout is not a
+ * TTY (so logs piped into a file don't contain escape codes).
+ */
+export type LoggerLevel = "info" | "success" | "warn" | "error" | "debug";
+export declare class Logger {
+    private verbose;
+    setVerbose(v: boolean): void;
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    finger(message: string): void;
+    /**
+     * Render a small table. `rows` is an array of `[label, value]`
+     * tuples; the label column is dimmed.
+     */
+    table(rows: Array<[string, string]>): void;
+    heading(text: string): void;
+    blank(): void;
+}
+export declare const logger: Logger;
+/** ANSI helpers (exported for templates that want colored output). */
+export declare const colors: {
+    reset: (s: string) => string;
+    bold: (s: string) => string;
+    dim: (s: string) => string;
+    red: (s: string) => string;
+    green: (s: string) => string;
+    yellow: (s: string) => string;
+    blue: (s: string) => string;
+    magenta: (s: string) => string;
+    cyan: (s: string) => string;
+    gray: (s: string) => string;
+};

package/dist/core/loose-json.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Lenient JSON parser.
+ *
+ * Standard `JSON.parse` rejects three things that show up regularly
+ * in hand-edited `package.json` / `tsconfig.json` files:
+ *
+ *   1. Line comments:    `// like this`
+ *   2. Block comments:   `/* like this *\/`
+ *   3. Trailing commas:  `\{ "a": 1, \}` or `[ 1, 2, ]`
+ *
+ * `bun init` and several other generators emit files with at least
+ * some of these (the user's `package.json` had `//` comments and
+ * tripped the CLI with `Unrecognized token '/'`).
+ *
+ * Bun has full JSON5 support built in (`Bun.JSON5.parse()`,
+ * `Bun.JSON5.stringify()` — see
+ * https://bun.sh/docs/runtime/json5#bun-json5-parse), so this
+ * module is a thin pass-through rather than a reimplementation.
+ * The CLI runs in Bun >= 1.1.0 (see `engines` in package.json).
+ *
+ * Use this anywhere the CLI reads a user-owned `package.json` or
+ * `tsconfig.json`. For framework-owned files (like the templates
+ * we render), use plain `JSON.parse` — they're always strict.
+ */
+export declare function parseJsonLoose<T = Record<string, unknown>>(text: string): T;

package/dist/core/prompts.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Lightweight interactive prompts.
+ *
+ * Avoids a runtime dependency on a TTY prompt library — we only need
+ * confirm / select / text prompts, all of which can be done with
+ * `readline` and a fallback to defaults when stdin is not a TTY.
+ *
+ * Every prompt can be skipped with `--no-interaction` or by passing the
+ * answer via flags. This mirrors Adonis ACE and Symfony Console.
+ */
+export interface PromptOptions {
+    /** Default value when the user just presses enter. */
+    default?: string;
+    /** Choices for select. The first one is the default. */
+    choices?: string[];
+    /** When false, stdin must be a TTY — otherwise the default is used. */
+    interactive?: boolean;
+}
+export declare function prompt(message: string, options?: PromptOptions): Promise<string>;
+export declare function confirm(message: string, defaultYes?: boolean, options?: PromptOptions): Promise<boolean>;
+export declare function select(message: string, choices: string[], options?: PromptOptions): Promise<string>;

package/dist/core/template.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Minimal template engine for code generation.
+ *
+ * Supports:
+ *   - `{{ key }}` substitution
+ *   - `{{ key | filter }}` filters (upper/lower/pascal/camel/snake/kebab/plural/singular)
+ *   - `{{# flag }} ... {{/ flag }}` truthy sections (include if `flag` is truthy)
+ *   - `{{^ flag }} ... {{/ flag }}` falsy sections (include if `flag` is falsy)
+ *   - dotted lookup (`{{ user.name }}`)
+ *
+ * Multi-line templates are fine; placeholders can span any whitespace.
+ */
+export type Filter = "raw" | "upper" | "lower" | "pascal" | "camel" | "snake" | "kebab" | "plural" | "singular";
+export interface RenderObject {
+    [key: string]: RenderValue;
+}
+export type RenderValue = string | number | boolean | undefined | null | RenderObject | RenderValue[];
+export type RenderContext = RenderObject;
+export declare function render(template: string, context: RenderContext): string;
+export declare function toPascal(s: string): string;
+export declare function toCamel(s: string): string;
+export declare function toSnake(s: string): string;
+export declare function toKebab(s: string): string;
+export declare function pluralize(s: string): string;
+export declare function singularize(s: string): string;

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env bun
+/**
+ * `nx` — the Nexus CLI entry point.
+ *
+ * Invocation:
+ *   bunx nx <command> [args...]
+ *   bunx nx help
+ *   bunx nx help <command>
+ *
+ * Resembles Adonis ACE / Rails generators:
+ *   nx make:controller User
+ *   nx make:crud Post --no-views
+ *   nx make:migration create_users_table --columns "name:text,email:text"
+ *   nx info
+ *   nx route:list
+ *   nx init --style nest --view inertia --orm drizzle
+ *
+ * The CLI loads `nx.config.ts` (or `nx.config.js` / `.nxrc.json`) and
+ * passes the resolved config + parsed flags to each command.
+ */
+export {};