Update docs

Author: fardjad

README.md

@@ -106,5 +106,57 @@ await program
 
 More examples can be found in the [examples](/examples/) directory.
 
+## Recipes
+
+### Interactive options for the root command
+
+Interactive options are not supported for the root command. However, you can
+mark a subcommand as the default command to achieve a similar effect.
+
+```typescript
+import { InteractiveCommand } from "interactive-commander";
+
+const program = new InteractiveCommand();
+
+program
+  .command("hello", { isDefault: true })
+  .requiredOption("-n, --name <name>", "your name")
+  .action((options) => {
+    console.log("Hello %s!", options.name);
+  });
+
+await program.interactive().parseAsync(process.argv);
+
+// Try the following commands:
+// default-subcommand
+// default-subcommand -n John
+// default-subcommand -i
+```
+
+### Enable interactive mode by default
+
+The interactive mode flags can be [negatable boolean options][3]
+(e.g. `--no-interactive`). Negatable boolean options are disabled by default.
+
+```typescript
+const program = new InteractiveCommand();
+
+program
+  .command("hello")
+  .option("-n, --name <name>", "your name")
+  .action((options) => {
+    console.log("Hello %s!", options.name);
+  });
+
+await program
+  .interactive("-I, --no-interactive", "disable interactive mode")
+  .parseAsync(process.argv);
+
+// Try the following commands:
+// no-interactive hello
+// no-interactive hello -I
+```
+
 [1]: https://github.com/tj/commander.js
 [2]: https://github.com/SBoudrias/Inquirer.js
+[3]: https://github.com/tj/commander.js#other-option-types-negatable-boolean-and-booleanvalue

examples/default-subcommand.ts

@@ -0,0 +1,17 @@
+import { InteractiveCommand } from "../src/index.ts";
+
+const program = new InteractiveCommand();
+
+program
+  .command("hello", { isDefault: true })
+  .requiredOption("-n, --name <name>", "your name")
+  .action((options) => {
+    console.log("Hello %s!", options.name);
+  });
+
+await program.interactive().parseAsync(process.argv);
+
+// Try the following commands:
+// default-subcommand
+// default-subcommand -n John
+// default-subcommand -i

examples/no-interactive.ts

@@ -0,0 +1,18 @@
+import { InteractiveCommand } from "../src/index.ts";
+
+const program = new InteractiveCommand();
+
+program
+  .command("hello")
+  .option("-n, --name <name>", "your name")
+  .action((options) => {
+    console.log("Hello %s!", options.name);
+  });
+
+await program
+  .interactive("-I, --no-interactive", "disable interactive mode")
+  .parseAsync(process.argv);
+
+// Try the following commands:
+// no-interactive hello
+// no-interactive hello -I

examples/order-pizza.ts

@@ -65,9 +65,9 @@ await program
   .parseAsync(process.argv);
 
 // Try the following commands:
-// command-name pizza
-// command-name pizza -i
-// command-name pizza -i --count 2
-// command-name pizza -i --count 2 --no-cheese
-// command-name pizza -i --name "John Doe"
-// command-name pizza -i --name "John Doe" --non-interactive-option abc
+// order-pizza pizza
+// order-pizza pizza -i
+// order-pizza pizza -i --count 2
+// order-pizza pizza -i --count 2 --no-cheese
+// order-pizza pizza -i --name "John Doe"
+// order-pizza pizza -i --name "John Doe" --non-interactive-option abc

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "interactive-commander",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Commander.js with integrated interactive prompts",
   "keywords": [
     "commander",