Move Context.invokeCommands to State.fork

notes/notes.md

@@ -8,6 +8,8 @@
 - [x] Filesystem based command router
 - [x] Param routes
 - [x] Options getter
+  - [ ] Custom option types (e.g., "bigint", "number-string", "hex") with custom
+        validation and input masking
   - [x] Options config
   - [x] Option parsing
     - [x] string

packages/clide-js/src/cli/commands/bar.ts

@@ -0,0 +1,42 @@
+import { command } from 'src/core/command';
+
+/**
+ * Test Cases:
+ *
+ *   // Defaults passed to invoked command?
+ * - DEFAULT, no value, no prompt, no passed value -> no option
+ *
+ *   // Defaults passed to invoked command?
+ * - DEFAULT, no value, no prompt, no passed value -> no default
+ *
+ *   // Parsed values passed to invoked command?
+ * - No default, VALUE, no prompt, no passed value -> no default
+ *
+ *   // Prompt updates AND passed to invoked command?
+ * - No default, no value, PROMPT, no passed value -> no default
+ *
+ *   // Override passed to invoked command?
+ * - No default, no value, no prompt, PASSED_VALUE -> no default
+ *
+ *
+ *   // Values updated from invoked default?
+ * - no default, no value, no prompt, no passed value -> DEFAULT
+ *
+ *   // Default priority?
+ * - DEFAULT, no value, no prompt, no passed value -> DEFAULT
+ */
+
+export default command({
+  description: 'Get a greeting',
+  options: {
+    foo: {
+      type: 'string',
+      default: 'default bar',
+    },
+  },
+  handler: async ({ options, end }) => {
+    console.log('------\nBar Values:', options.values, '\n------');
+
+    end();
+  },
+});

packages/clide-js/src/cli/commands/foo.ts

@@ -0,0 +1,45 @@
+import { command } from 'src/core/command';
+import bar from './bar';
+
+/**
+ * Test Cases:
+ *
+ *   // Defaults passed to invoked command? ✅
+ * - DEFAULT, no value, no prompt, no passed value -> no default
+ *
+ *   // Parsed values passed to invoked command?
+ * - No default, VALUE, no prompt, no passed value -> no default
+ *
+ *   // Prompt updates AND passed to invoked command?
+ * - No default, no value, PROMPT, no passed value -> no default
+ *
+ *   // Override passed to invoked command?
+ * - No default, no value, no prompt, PASSED_VALUE -> no default
+ *
+ *
+ *   // Values updated from invoked default?
+ * - no default, no value, no prompt, no passed value -> DEFAULT
+ *
+ *   // Default priority?
+ * - DEFAULT, no value, no prompt, no passed value -> DEFAULT
+ */
+
+export default command({
+  description: 'Get a greeting',
+  options: {
+    foo: {
+      type: 'string',
+      default: 'default foo',
+    },
+  },
+  handler: async ({ next, fork, options }) => {
+    console.log('------\nFoo Values:', options.values, '\n------');
+
+    const res = await fork({
+      commands: [bar],
+      optionValues: options.values,
+    });
+
+    next(res);
+  },
+});