zudojs-cli 2.1.3 → 2.2.0

package/dist/src/cliApplication/cliApplication.logger.d.ts

@@ -30,4 +30,3 @@ export interface CLILoggerOptions {
 export declare function formatCLILogLine(entry: LoggerEntry): string;
 /** Creates the logger handed to every command as `context.logger`. */
 export declare function createCLILogger(options?: CLILoggerOptions): Logger;
-//# sourceMappingURL=cliApplication.logger.d.ts.map

package/dist/src/cliApplication/cliApplication.logger.js

@@ -67,4 +67,3 @@ export function createCLILogger(options = {}) {
         ],
     });
 }
-//# sourceMappingURL=cliApplication.logger.js.map

package/dist/src/cliApplication/cliApplication.writer.d.ts

@@ -8,4 +8,3 @@ import type { CLIWriter } from "../cliType/cliType.type.js";
 export declare function createCLIWriter(): CLIWriter;
 /** Registers a SIGINT handler and returns an unsubscribe function. */
 export declare function registerCLIInterruptHandler(onInterrupt: () => void | Promise<void>): () => void;
-//# sourceMappingURL=cliApplication.writer.d.ts.map

package/dist/src/cliApplication/cliApplication.writer.js

@@ -42,4 +42,3 @@ export function registerCLIInterruptHandler(onInterrupt) {
         process.off("SIGINT", handler);
     };
 }
-//# sourceMappingURL=cliApplication.writer.js.map

package/dist/src/cliApplication/index.d.ts

@@ -4,4 +4,3 @@
 export { ZudojsCLI, createCLI } from "./cliApplication.core.js";
 export { createCLIWriter, registerCLIInterruptHandler, } from "./cliApplication.writer.js";
 export { createCLILogger, formatCLILogLine, type CLILoggerOptions, } from "./cliApplication.logger.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/cliApplication/index.js

@@ -4,4 +4,3 @@
 export { ZudojsCLI, createCLI } from "./cliApplication.core.js";
 export { createCLIWriter, registerCLIInterruptHandler, } from "./cliApplication.writer.js";
 export { createCLILogger, formatCLILogLine, } from "./cliApplication.logger.js";
-//# sourceMappingURL=index.js.map

package/dist/src/cliApplication/invocation/index.d.ts

@@ -9,4 +9,3 @@ export { CLI_BIN_NAMES, resolveInvokedName, localizeCommandName, } from "./invoc
 export { locateCommand, requireCommand, type CommandLocation, } from "./invocation.locate.js";
 export { escapeControlCharacters } from "./invocation.sanitize.js";
 export { suggestCommand, failureHints, type FailureHintInput, } from "./invocation.hint.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/cliApplication/invocation/index.js

@@ -9,4 +9,3 @@ export { CLI_BIN_NAMES, resolveInvokedName, localizeCommandName, } from "./invoc
 export { locateCommand, requireCommand, } from "./invocation.locate.js";
 export { escapeControlCharacters } from "./invocation.sanitize.js";
 export { suggestCommand, failureHints, } from "./invocation.hint.js";
-//# sourceMappingURL=index.js.map

package/dist/src/cliApplication/invocation/invocation.hint.d.ts

@@ -20,11 +20,4 @@ export interface FailureHintInput {
     readonly unknownCommand?: string;
     readonly commands: readonly CLICommand[];
 }
-/**
- * Returns the hint lines printed after an error message.
- *
- * Only usage errors get hints: a failure inside a command already says
- * what went wrong, and a help pointer would be noise there.
- */
 export declare function failureHints(input: FailureHintInput): readonly string[];
-//# sourceMappingURL=invocation.hint.d.ts.map

package/dist/src/cliApplication/invocation/invocation.hint.js

@@ -52,12 +52,26 @@ export function suggestCommand(input, commands) {
  * Only usage errors get hints: a failure inside a command already says
  * what went wrong, and a help pointer would be noise there.
  */
+/**
+ * Commands people expect from a framework CLI that are the project's own
+ * scripts instead. `zudojs migrate` used to exit 3 with nothing but "not
+ * found", while the migration scripts had been added by `zudojs add
+ * database` all along.
+ */
+const SCRIPT_HINTS = Object.freeze({
+    migrate: 'Migrations run through the project\'s scripts, added by "zudojs add database": ' +
+        '"<pm> run db:migrate" in development, "<pm> run db:deploy" in production (pm: pnpm, npm, yarn or bun).',
+    test: 'Tests run through the project\'s own script: "<pm> run test" (pm: pnpm, npm, yarn or bun).',
+    start: 'A built project starts with its own script: "<pm> run build", then "<pm> run start".',
+});
 export function failureHints(input) {
     if (input.exitCode === CLI_EXIT_CODES.COMMAND_NOT_FOUND) {
         const suggestion = input.unknownCommand === undefined
             ? undefined
             : suggestCommand(input.unknownCommand, input.commands);
+        const script = input.unknownCommand === undefined ? undefined : SCRIPT_HINTS[input.unknownCommand];
         return [
+            ...(script ? [script] : []),
             ...(suggestion ? [`Did you mean "${input.name} ${suggestion}"?`] : []),
             `Run "${input.name} --help" to see all commands.`,
         ];
@@ -71,4 +85,3 @@ export function failureHints(input) {
     }
     return [];
 }
-//# sourceMappingURL=invocation.hint.js.map

package/dist/src/cliApplication/invocation/invocation.locate.d.ts

@@ -31,4 +31,3 @@ export declare function requireCommand(args: CLIArguments, commands: readonly CL
     readonly index: number;
     readonly command: CLICommand;
 };
-//# sourceMappingURL=invocation.locate.d.ts.map

package/dist/src/cliApplication/invocation/invocation.locate.js

@@ -50,4 +50,3 @@ export function requireCommand(args, commands, name) {
     }
     return { index: location.index, command: location.command };
 }
-//# sourceMappingURL=invocation.locate.js.map

package/dist/src/cliApplication/invocation/invocation.name.d.ts

@@ -34,4 +34,3 @@ export declare function resolveInvokedName(scriptPath: string | undefined, known
  * @param commandWords - Registered command names and aliases.
  */
 export declare function localizeCommandName(text: string, displayName: string, commandWords: readonly string[]): string;
-//# sourceMappingURL=invocation.name.d.ts.map

package/dist/src/cliApplication/invocation/invocation.name.js

@@ -66,4 +66,3 @@ export function localizeCommandName(text, displayName, commandWords) {
     const pattern = new RegExp(`(?<![\\w@/.-])${CLI_NAME}(?=\\s+(?:${words.join("|")})(?![\\w-]))`, "g");
     return text.replace(pattern, displayName);
 }
-//# sourceMappingURL=invocation.name.js.map

package/dist/src/cliApplication/invocation/invocation.sanitize.d.ts

@@ -16,4 +16,3 @@
  * @param text - Text about to be written to the terminal.
  */
 export declare function escapeControlCharacters(text: string): string;
-//# sourceMappingURL=invocation.sanitize.d.ts.map

package/dist/src/cliApplication/invocation/invocation.sanitize.js

@@ -29,4 +29,3 @@ export function escapeControlCharacters(text) {
             : `\\u${code.toString(16).padStart(4, "0")}`;
     });
 }
-//# sourceMappingURL=invocation.sanitize.js.map

package/dist/src/cliCommand/cliCommand.builder.d.ts

@@ -26,4 +26,3 @@ export declare class CLICommandBuilder {
     /** Builds the CLI command. */
     build(): CLICommand;
 }
-//# sourceMappingURL=cliCommand.builder.d.ts.map

package/dist/src/cliCommand/cliCommand.builder.js

@@ -66,4 +66,3 @@ export class CLICommandBuilder {
         });
     }
 }
-//# sourceMappingURL=cliCommand.builder.js.map

package/dist/src/cliCommand/cliCommand.factory.d.ts

@@ -10,4 +10,3 @@ export declare function createCommand(definition: CLICommandDefinition): CLIComm
 export declare function command(name: string, execute: CLICommand["execute"]): CLICommand;
 /** Executes a CLI command with the given context. */
 export declare function executeCommand(command: CLICommand, context: CLIContext): Promise<void>;
-//# sourceMappingURL=cliCommand.factory.d.ts.map

package/dist/src/cliCommand/cliCommand.factory.js

@@ -27,4 +27,3 @@ export function command(name, execute) {
 export async function executeCommand(command, context) {
     await command.execute(context);
 }
-//# sourceMappingURL=cliCommand.factory.js.map

package/dist/src/cliCommand/cliCommand.registry.d.ts

@@ -31,4 +31,3 @@ export declare class CLICommandRegistry {
     /** Returns the number of registered commands. */
     get size(): number;
 }
-//# sourceMappingURL=cliCommand.registry.d.ts.map

package/dist/src/cliCommand/cliCommand.registry.js

@@ -89,4 +89,3 @@ export class CLICommandRegistry {
         return this.commands.size;
     }
 }
-//# sourceMappingURL=cliCommand.registry.js.map

package/dist/src/cliCommand/cliCommand.validator.d.ts

@@ -10,4 +10,3 @@ export declare function validateCommand(command: CLICommand): void;
 export declare function isCLICommand(value: unknown): value is CLICommand;
 /** Returns a sorted copy of the commands array. */
 export declare function sortCommands(commands: readonly CLICommand[]): CLICommand[];
-//# sourceMappingURL=cliCommand.validator.d.ts.map

package/dist/src/cliCommand/cliCommand.validator.js

@@ -79,4 +79,3 @@ export function isCLICommand(value) {
 export function sortCommands(commands) {
     return [...commands].sort((a, b) => a.name.localeCompare(b.name));
 }
-//# sourceMappingURL=cliCommand.validator.js.map

package/dist/src/cliCommand/index.d.ts

@@ -7,4 +7,3 @@ export { CLICommandRegistry } from "./cliCommand.registry.js";
 export { CLICommandBuilder } from "./cliCommand.builder.js";
 export { createCommand, command, executeCommand, } from "./cliCommand.factory.js";
 export { validateCommand, isCLICommand, sortCommands, } from "./cliCommand.validator.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/cliCommand/index.js

@@ -7,4 +7,3 @@ export { CLICommandRegistry } from "./cliCommand.registry.js";
 export { CLICommandBuilder } from "./cliCommand.builder.js";
 export { createCommand, command, executeCommand, } from "./cliCommand.factory.js";
 export { validateCommand, isCLICommand, sortCommands, } from "./cliCommand.validator.js";
-//# sourceMappingURL=index.js.map

package/dist/src/cliConstant/cliConstant.value.d.ts

@@ -117,4 +117,3 @@ export type CLIExitCode = (typeof CLI_EXIT_CODES)[keyof typeof CLI_EXIT_CODES];
 export type CLIErrorCode = (typeof CLI_ERROR_CODES)[keyof typeof CLI_ERROR_CODES];
 /** CLI command name type. */
 export type CLICommandName = (typeof CLI_COMMANDS)[keyof typeof CLI_COMMANDS];
-//# sourceMappingURL=cliConstant.value.d.ts.map

package/dist/src/cliConstant/cliConstant.value.js

@@ -142,4 +142,3 @@ export const CLI_EXIT_CODES = {
     PERMISSION_DENIED: 4,
     INTERRUPTED: 130,
 };
-//# sourceMappingURL=cliConstant.value.js.map

package/dist/src/cliConstant/cliVersion.d.ts

@@ -13,4 +13,3 @@
  */
 /** The CLI's version, matching its `package.json`. */
 export declare const CLI_VERSION: string;
-//# sourceMappingURL=cliVersion.d.ts.map

package/dist/src/cliConstant/cliVersion.js

@@ -54,4 +54,3 @@ function readOwnVersion() {
 }
 /** The CLI's version, matching its `package.json`. */
 export const CLI_VERSION = readOwnVersion();
-//# sourceMappingURL=cliVersion.js.map

package/dist/src/cliConstant/index.d.ts

@@ -4,4 +4,3 @@
  * Default values, limits, and magic strings used across the CLI package.
  */
 export * from "./cliConstant.value.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/cliConstant/index.js

@@ -4,4 +4,3 @@
  * Default values, limits, and magic strings used across the CLI package.
  */
 export * from "./cliConstant.value.js";
-//# sourceMappingURL=index.js.map

package/dist/src/cliError/cliError.argument.d.ts

@@ -17,4 +17,3 @@ export declare class InvalidArgumentsError extends CLIError {
 export declare class MissingArgumentError extends CLIError {
     constructor(argument: string, command?: string);
 }
-//# sourceMappingURL=cliError.argument.d.ts.map

package/dist/src/cliError/cliError.argument.js

@@ -38,4 +38,3 @@ export class MissingArgumentError extends CLIError {
         });
     }
 }
-//# sourceMappingURL=cliError.argument.js.map

package/dist/src/cliError/cliError.base.d.ts

@@ -59,4 +59,3 @@ export declare function normalizeCLIError(error: unknown, fallbackMessage?: stri
 export declare function getCLIExitCode(error: unknown): number;
 /** Extracts the error code from an error. */
 export declare function getCLIErrorCode(error: unknown): CLIErrorCode;
-//# sourceMappingURL=cliError.base.d.ts.map

package/dist/src/cliError/cliError.base.js

@@ -109,4 +109,3 @@ export function getCLIErrorCode(error) {
     }
     return CLI_ERROR_CODES.UNKNOWN_ERROR;
 }
-//# sourceMappingURL=cliError.base.js.map

package/dist/src/cliError/cliError.command.d.ts

@@ -70,4 +70,3 @@ export declare class InvalidCommandNameError extends NotFoundError {
         exitCode: number;
     };
 }
-//# sourceMappingURL=cliError.command.d.ts.map

package/dist/src/cliError/cliError.command.js

@@ -83,4 +83,3 @@ export class InvalidCommandNameError extends NotFoundError {
         };
     }
 }
-//# sourceMappingURL=cliError.command.js.map

package/dist/src/cliError/cliError.execution.d.ts

@@ -64,4 +64,3 @@ export declare class CLIConfigurationError extends ConfigurationError {
         exitCode: number;
     };
 }
-//# sourceMappingURL=cliError.execution.d.ts.map

package/dist/src/cliError/cliError.execution.js

@@ -92,4 +92,3 @@ export class CLIConfigurationError extends ConfigurationError {
         };
     }
 }
-//# sourceMappingURL=cliError.execution.js.map

package/dist/src/cliError/cliError.option.d.ts

@@ -45,4 +45,3 @@ export declare class DuplicateOptionError extends ConflictError {
         exitCode: number;
     };
 }
-//# sourceMappingURL=cliError.option.d.ts.map

package/dist/src/cliError/cliError.option.js

@@ -81,4 +81,3 @@ export class DuplicateOptionError extends ConflictError {
         };
     }
 }
-//# sourceMappingURL=cliError.option.js.map

package/dist/src/cliError/index.d.ts

@@ -8,4 +8,3 @@ export { CommandNotFoundError, DuplicateCommandError, InvalidCommandNameError, }
 export { InvalidArgumentsError, MissingArgumentError, } from "./cliError.argument.js";
 export { InvalidOptionError, InvalidOptionNameError, MissingOptionValueError, DuplicateOptionError, } from "./cliError.option.js";
 export { CLIExecutionError, CLIPermissionError, CLIInterruptedError, CLIConfigurationError, } from "./cliError.execution.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/cliError/index.js

@@ -8,4 +8,3 @@ export { CommandNotFoundError, DuplicateCommandError, InvalidCommandNameError, }
 export { InvalidArgumentsError, MissingArgumentError, } from "./cliError.argument.js";
 export { InvalidOptionError, InvalidOptionNameError, MissingOptionValueError, DuplicateOptionError, } from "./cliError.option.js";
 export { CLIExecutionError, CLIPermissionError, CLIInterruptedError, CLIConfigurationError, } from "./cliError.execution.js";
-//# sourceMappingURL=index.js.map

package/dist/src/cliParser/cliParser.core.d.ts

@@ -23,4 +23,3 @@ export declare class CLIParser {
     parse(args: CLIArguments, command?: CLICommand): ParsedCLIInput;
     private parseArguments;
 }
-//# sourceMappingURL=cliParser.core.d.ts.map

package/dist/src/cliParser/cliParser.core.js

@@ -127,4 +127,3 @@ export class CLIParser {
         return result;
     }
 }
-//# sourceMappingURL=cliParser.core.js.map

package/dist/src/cliParser/cliParser.helper.d.ts

@@ -39,4 +39,3 @@ export declare function isShortOption(token: string): boolean;
 export declare function resolveCommand(commands: readonly CLICommand[], name: string): CLICommand | undefined;
 /** Normalizes an unknown value into a CLIValue. */
 export declare function normalizeCLIValue(value: unknown): CLIValue;
-//# sourceMappingURL=cliParser.helper.d.ts.map

package/dist/src/cliParser/cliParser.helper.js

@@ -117,4 +117,3 @@ export function normalizeCLIValue(value) {
     }
     return String(value);
 }
-//# sourceMappingURL=cliParser.helper.js.map

package/dist/src/cliParser/cliParser.longOption.d.ts

@@ -10,4 +10,3 @@ export declare function parseLongOption(tokens: readonly string[], index: number
 export declare function findOption(name: string, definitions: readonly CLIOption[]): CLIOption | undefined;
 /** Assigns a parsed value to the option, handling multiples. */
 export declare function assignOptionValue(definition: CLIOption, rawValue: string, values: Record<string, unknown>): void;
-//# sourceMappingURL=cliParser.longOption.d.ts.map

package/dist/src/cliParser/cliParser.longOption.js

@@ -83,4 +83,3 @@ export function assignOptionValue(definition, rawValue, values) {
         values[definition.name] = value;
     }
 }
-//# sourceMappingURL=cliParser.longOption.js.map

package/dist/src/cliParser/cliParser.shortOption.d.ts

@@ -6,4 +6,3 @@
 import type { CLIOption } from "../cliType/cliType.type.js";
 /** Parses a short option token from the token stream. */
 export declare function parseShortOption(tokens: readonly string[], index: number, definitions: readonly CLIOption[], values: Record<string, unknown>, allowUnknownOptions: boolean): number;
-//# sourceMappingURL=cliParser.shortOption.d.ts.map

package/dist/src/cliParser/cliParser.shortOption.js

@@ -79,4 +79,3 @@ export function parseShortOption(tokens, index, definitions, values, allowUnknow
 function findShortOption(short, definitions) {
     return definitions.find((d) => d.short === short);
 }
-//# sourceMappingURL=cliParser.shortOption.js.map

package/dist/src/cliParser/index.d.ts

@@ -7,4 +7,3 @@ export { CLIParser, type CLIParserOptions } from "./cliParser.core.js";
 export { parseLongOption, findOption, assignOptionValue, } from "./cliParser.longOption.js";
 export { parseShortOption } from "./cliParser.shortOption.js";
 export { parseCLIArguments, parseOptionValue, parseBoolean, isOption, isLongOption, isShortOption, resolveCommand, normalizeCLIValue, } from "./cliParser.helper.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/cliParser/index.js

@@ -7,4 +7,3 @@ export { CLIParser } from "./cliParser.core.js";
 export { parseLongOption, findOption, assignOptionValue, } from "./cliParser.longOption.js";
 export { parseShortOption } from "./cliParser.shortOption.js";
 export { parseCLIArguments, parseOptionValue, parseBoolean, isOption, isLongOption, isShortOption, resolveCommand, normalizeCLIValue, } from "./cliParser.helper.js";
-//# sourceMappingURL=index.js.map

package/dist/src/cliType/cliType.type.d.ts

@@ -118,4 +118,3 @@ export interface CLIHooks {
     afterRun?: (context: CLIContext, exitCode: number) => void | Promise<void>;
     onError?: (error: unknown, context?: CLIContext) => void | Promise<void>;
 }
-//# sourceMappingURL=cliType.type.d.ts.map

package/dist/src/cliType/cliType.type.js

@@ -4,4 +4,3 @@
  * Core types, interfaces, and type aliases for the CLI package.
  */
 export {};
-//# sourceMappingURL=cliType.type.js.map

package/dist/src/cliType/index.d.ts

@@ -4,4 +4,3 @@
  * Core types, interfaces, and type aliases for the CLI package.
  */
 export * from "./cliType.type.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/cliType/index.js

@@ -4,4 +4,3 @@
  * Core types, interfaces, and type aliases for the CLI package.
  */
 export * from "./cliType.type.js";
-//# sourceMappingURL=index.js.map

package/dist/src/cliVersion/cliVersion.core.d.ts

@@ -23,4 +23,3 @@ export declare function compareVersions(first: string, second: string): number;
 export declare function parseVersion(version: string): readonly [number, number, number];
 /** Returns whether `version` satisfies `minimumVersion`. */
 export declare function isCompatibleVersion(version: string, minimumVersion: string): boolean;
-//# sourceMappingURL=cliVersion.core.d.ts.map

package/dist/src/cliVersion/cliVersion.core.js

@@ -51,4 +51,3 @@ export function parseVersion(version) {
 export function isCompatibleVersion(version, minimumVersion) {
     return compareVersions(version, minimumVersion) >= 0;
 }
-//# sourceMappingURL=cliVersion.core.js.map

package/dist/src/cliVersion/cliVersion.update.d.ts

@@ -35,4 +35,3 @@ export interface UpdateCheckResult {
 export declare function isUpdateCheckDisabled(env?: NodeJS.ProcessEnv): boolean;
 /** Looks up the latest published version and compares it with `current`. */
 export declare function checkForNewerVersion(current: string, options?: UpdateCheckOptions): Promise<UpdateCheckResult>;
-//# sourceMappingURL=cliVersion.update.d.ts.map

package/dist/src/cliVersion/cliVersion.update.js

@@ -62,4 +62,3 @@ export async function checkForNewerVersion(current, options = {}) {
         clearTimeout(timer);
     }
 }
-//# sourceMappingURL=cliVersion.update.js.map

package/dist/src/cliVersion/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { getCLIVersion, formatCLIVersion, getVersionString, isValidVersion, compareVersions, parseVersion, isCompatibleVersion, type CLIVersionInfo, } from "./cliVersion.core.js";
 export { checkForNewerVersion, isUpdateCheckDisabled, type UpdateCheckOptions, type UpdateCheckResult, } from "./cliVersion.update.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/cliVersion/index.js

@@ -5,4 +5,3 @@
  */
 export { getCLIVersion, formatCLIVersion, getVersionString, isValidVersion, compareVersions, parseVersion, isCompatibleVersion, } from "./cliVersion.core.js";
 export { checkForNewerVersion, isUpdateCheckDisabled, } from "./cliVersion.update.js";
-//# sourceMappingURL=index.js.map

package/dist/src/commands/add.command.d.ts

@@ -38,4 +38,3 @@ export declare function selectAddTargets(layout: ProjectLayout, service: string
 export declare function versionForNewDependency(pkg: PackageJsonShape, name?: string): string;
 export declare function runAddCommand(context: CLIContext): Promise<void>;
 export {};
-//# sourceMappingURL=add.command.d.ts.map

package/dist/src/commands/add.command.js

@@ -127,7 +127,7 @@ export async function runAddCommand(context) {
                     gitignore.add(line);
                 nextSteps.push(...(recipe.nextSteps?.(recipeContext) ?? []));
             }
-            const settings = await applyProjectSettings(layout.root, [...gitignore], recipe.allowBuilds ?? []);
+            const settings = await applyProjectSettings(layout.root, [...gitignore], recipe.allowBuilds ?? [], recipe.overrides ?? {});
             // A Dockerfile written before Prisma was added cannot build the app.
             const dockerfiles = await refreshGeneratedDockerfiles(projectRecipeContext(layout, feature, []));
             outcomes.push({ written: [], kept: [], edited: [...settings, ...dockerfiles], manualSteps: [] });
@@ -183,4 +183,3 @@ export async function runAddCommand(context) {
     for (const step of new Set(nextSteps))
         context.logger.info(`Next: ${step}`);
 }
-//# sourceMappingURL=add.command.js.map

package/dist/src/commands/build.command.d.ts

@@ -13,4 +13,3 @@ export declare function runBuildCommand(context: CLIContext): Promise<void>;
  * root `build` script is the whole build.
  */
 export declare function getBuildArgs(packageManager: PackageManager, isWorkspace: boolean): string[];
-//# sourceMappingURL=build.command.d.ts.map

package/dist/src/commands/build.command.js

@@ -48,4 +48,3 @@ export function getBuildArgs(packageManager, isWorkspace) {
             return ["run", "build"];
     }
 }
-//# sourceMappingURL=build.command.js.map

package/dist/src/commands/commandError.helper.d.ts

@@ -12,4 +12,3 @@
  * (ENOTDIR, EACCES) without anything ever printing it.
  */
 export declare function describeError(error: unknown): string;
-//# sourceMappingURL=commandError.helper.d.ts.map

package/dist/src/commands/commandError.helper.js

@@ -25,4 +25,3 @@ export function describeError(error) {
     }
     return parts.length > 0 ? parts.join(": ") : String(error);
 }
-//# sourceMappingURL=commandError.helper.js.map

package/dist/src/commands/create.command.d.ts

@@ -5,4 +5,3 @@
  */
 import type { CLIContext } from "../cliType/cliType.type.js";
 export declare function runCreateCommand(context: CLIContext): Promise<void>;
-//# sourceMappingURL=create.command.d.ts.map

package/dist/src/commands/create.command.js

@@ -761,4 +761,3 @@ async function generateFrontendProject(options, projectPath) {
         throw new CLIGenerationError(`Frontend generation failed:\n${result.errors.join("\n")}`);
     }
 }
-//# sourceMappingURL=create.command.js.map

package/dist/src/commands/dev/dev.plan.d.ts

@@ -0,0 +1,39 @@
+/**
+ * zudojs-cli — Which development servers `zudojs dev` starts.
+ *
+ * Servers are started through the project's package manager (`pnpm run
+ * dev`, `npm run dev`, …) rather than by spawning `tsx` or `ng` directly:
+ * those binaries are devDependencies of the generated project and are not
+ * on the user's PATH, so the direct spawn failed with ENOENT for everyone
+ * who had not installed them globally. Running the script also means the
+ * project's own `dev` script is what runs — `tsx watch src` used to be
+ * hard-coded here, which watched `src/index.ts`, a file that only exports
+ * `createApp` and never starts the server.
+ */
+import type { ProjectLayout } from "../../resolvers/layout/projectLayout.core.js";
+/** One development server to start. */
+export interface DevServerSpec {
+    readonly label: string;
+    readonly cwd: string;
+    readonly file: string;
+    readonly args: readonly string[];
+    readonly env?: NodeJS.ProcessEnv;
+}
+/** Which apps `zudojs dev` is asked to start. */
+export interface DevSelection {
+    readonly frontendOnly?: boolean;
+    readonly backendOnly?: boolean;
+    readonly port?: number;
+}
+/**
+ * Computes the servers `zudojs dev` starts for a project layout.
+ *
+ * Exported so the selection can be tested without spawning anything.
+ */
+export declare function planDevServers(layout: ProjectLayout, options?: DevSelection): DevServerSpec[];
+/**
+ * Why {@link planDevServers} found nothing to start. `--frontend-only` in a
+ * backend project used to warn and exit 0, which a script or CI step read
+ * as "the dev server is up".
+ */
+export declare function describeNothingToStart(layout: ProjectLayout, options: DevSelection): string;