@aponiajs/cli 0.0.0 → 0.2.1

package/README.md

@@ -1,15 +1,46 @@
 # @aponiajs/cli
 
+[![npm](https://img.shields.io/npm/v/%40aponiajs%2Fcli)](https://www.npmjs.com/package/@aponiajs/cli)
+
 The Bun-native Aponia command-line interface.
 
-## Create a project
+## Install
+
+```bash
+bun add --dev @aponiajs/cli
+```
+
+## Commands
+
+```bash
+bunx aponia new my-api
+bunx aponia n my-api --dry-run
+bunx aponia new my-api --skip-install
+bunx aponia generate controller users
+bunx aponia g s users
+bunx aponia g resource users --type rest
+bunx aponia g router health --no-spec
+bunx aponia --version
+```
+
+The generate command supports the complete built-in Nest schematic catalog:
+application, library, class, controller, decorator, filter, gateway, guard,
+interface, interceptor, middleware, module, pipe, provider, resolver, resource,
+and service. Nest aliases are supported, and `router`, `routers`, and `route`
+map to Aponia controllers.
+
+Generated controllers, providers, services, modules, and resources are
+registered in the nearest Aponia module unless `--skip-import` is used.
+Resource transports include REST, GraphQL code-first, GraphQL schema-first,
+microservices, and WebSockets.
+
+For one-command project creation, use the separately published
+[`create-aponia`](https://www.npmjs.com/package/create-aponia) entrypoint:
 
 ```bash
-aponia new my-api
-aponia n my-api --dry-run
-aponia new my-api --skip-install
+bun create aponia my-api
 ```
 
-The initial CLI implements the standard application generator. Component and
-resource schematics will be added behind the same command architecture after
-their module-registration transforms are safe and testable.
+[npm package](https://www.npmjs.com/package/@aponiajs/cli) ·
+[complete CLI guide](../../docs/cli.md) ·
+[complete package catalog](../../docs/packages.md)

package/dist/index.d.mts

@@ -5,7 +5,24 @@ interface NewCommandOptions {
   readonly dryRun: boolean;
   readonly skipInstall: boolean;
 }
-type CliCommand = NewCommandOptions | {
+declare const generateSchematics: readonly ["app", "library", "class", "controller", "decorator", "filter", "gateway", "guard", "interface", "interceptor", "middleware", "module", "pipe", "provider", "resolver", "resource", "service"];
+type GenerateSchematic = (typeof generateSchematics)[number];
+type ResourceTransport = "rest" | "graphql-code-first" | "graphql-schema-first" | "microservice" | "ws";
+interface GenerateCommandOptions {
+  readonly command: "generate";
+  readonly schematic: GenerateSchematic;
+  readonly name: string;
+  readonly dryRun: boolean;
+  readonly flat?: boolean;
+  readonly spec?: boolean;
+  readonly skipImport: boolean;
+  readonly path?: string;
+  readonly module?: string;
+  readonly project?: string;
+  readonly crud: boolean;
+  readonly type: ResourceTransport;
+}
+type CliCommand = NewCommandOptions | GenerateCommandOptions | {
   readonly command: "help";
 } | {
   readonly command: "version";
@@ -27,7 +44,21 @@ interface GenerateProjectResult {
 }
 declare function generateProject(options: GenerateProjectOptions): Promise<GenerateProjectResult>;
 //#endregion
+//#region src/schematic-generator.d.ts
+interface GenerateSchematicOptions extends GenerateCommandOptions {
+  readonly cwd?: string;
+}
+interface SchematicChange {
+  readonly kind: "CREATE" | "UPDATE";
+  readonly path: string;
+}
+interface GenerateSchematicResult {
+  readonly changes: readonly SchematicChange[];
+  readonly dryRun: boolean;
+}
+declare function generateSchematic(options: GenerateSchematicOptions): Promise<GenerateSchematicResult>;
+//#endregion
 //#region src/index.d.ts
 declare function runCli(arguments_: readonly string[]): Promise<number>;
 //#endregion
-export { type CliCommand, type GenerateProjectOptions, type GenerateProjectResult, generateProject, parseArguments, runCli };
+export { type CliCommand, type GenerateCommandOptions, type GenerateProjectOptions, type GenerateProjectResult, type GenerateSchematic, type GenerateSchematicOptions, type GenerateSchematicResult, type ResourceTransport, type SchematicChange, generateProject, generateSchematic, generateSchematics, parseArguments, runCli };