@h3ravel/musket 0.3.12 → 0.5.0

package/README.md

@@ -73,6 +73,32 @@ Kernel.init(app, {
 });
 ```
 
+### Advanced Initialization
+
+You can also initialize **Musket CLI** with precise controls
+
+```ts
+import { Kernel } from 'h3ravel/musket';
+
+const app = new Application();
+
+const instance = new Kernel(app)
+  .setCwd(process.cwd())
+  .setConfig({
+    cliName: 'musket-cli',
+    discoveryPaths: [path.join(process.cwd(), 'tests/Commands/*.ts')],
+  })
+  .setPackages([
+    { name: '@h3ravel/shared', alias: 'Shared PKG' },
+    '@h3ravel/support',
+  ])
+  .bootstrap();
+
+return await instance.run();
+```
+
+> NB: Packages in the config will be ignored when initializing in this way, as a work around, chain the `setPackages` method to the Kernel intance and pass your options
+
 ## Creating Commands
 
 Commands in Musket extend the base `Command` class and define a **signature** and **handle()** method.

package/dist/index.d.ts

@@ -116,8 +116,8 @@ interface InitConfig {
 }
 //#endregion
 //#region src/Core/Kernel.d.ts
-declare class Kernel {
-  app: Application;
+declare class Kernel<A extends Application = Application> {
+  app: A;
   cwd: string;
   output: "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function";
   modules: XGeneric<{
@@ -127,18 +127,18 @@ declare class Kernel {
   basePath: string;
   packages: NonNullable<InitConfig['packages']>;
   config: InitConfig;
-  constructor(app: Application);
+  constructor(app: A);
   ensureDirectoryExists(dir: string): Promise<void>;
-  static init(app: Application, config?: InitConfig): Promise<commander0.Command>;
+  static init<A extends Application>(app: A, config?: InitConfig): Promise<commander0.Command>;
   private run;
   private loadRequirements;
 }
 //#endregion
 //#region src/Core/Command.d.ts
-declare class Command {
-  protected app: Application;
-  protected kernel: Kernel;
-  constructor(app: Application, kernel: Kernel);
+declare class Command<A extends Application = Application> {
+  protected app: A;
+  protected kernel: Kernel<A>;
+  constructor(app: A, kernel: Kernel<A>);
   /**
    * The underlying commander instance.
    *
@@ -173,7 +173,7 @@ declare class Command {
    * Execute the console command.
    */
   handle(..._args: any[]): Promise<void>;
-  setApplication(app: Application): void;
+  setApplication(app: A): void;
   setInput(options: XGeneric, args: string[], regArgs: readonly Argument[], dictionary: Record<string, any>, program: Command$1): this;
   setOption(key: string, value: unknown): this;
   setProgram(program: Command$1): this;
@@ -366,6 +366,7 @@ declare class Musket {
 //#endregion
 //#region src/Contracts/Application.d.ts
 declare class Application {
+  [key: string]: any;
   /**
    * The current musket CLI Instance
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h3ravel/musket",
-  "version": "0.3.12",
+  "version": "0.5.0",
   "description": "Musket CLI is a framework-agnostic CLI framework designed to allow you build artisan-like CLI apps and for use in the H3ravel framework.",
   "type": "module",
   "main": "./dist/index.cjs",