feat: [Help] default help text format

Signed-off-by: Lexus Drumgold <[email protected]>

Author: unicornware

__fixtures__/commands/bun.mts

@@ -3,6 +3,7 @@
  * @module fixtures/commands/distinct
  */
 
+import chars from '#enums/chars'
 import unique from '#parsers/unique'
 import sfmt from '#tests/utils/sfmt'
 import c from '@flex-development/colors'
@@ -15,7 +16,10 @@ import type { SubcommandInfo as CommandInfo } from '@flex-development/kronk'
  */
 export default {
   arguments: {
-    default: { value: new Set() },
+    default: {
+      description: c.redBright('new') + chars.space + c.blueBright('Set()'),
+      value: new Set()
+    },
     description: 'the list of numbers',
     parser: unique,
     syntax: sfmt.optional({ id: 'numbers', variadic: true })
@@ -28,5 +32,6 @@ export default {
     { command: false as const, comment: '// 1 3', text: '3 1 3' },
     { command: false as const, comment: '// show help', text: '--help' }
   ].map(info => (info.text && (info.text = c.cyan(info.text)), info)),
-  name: 'distinct'
+  name: 'distinct',
+  usage: { options: null }
 }

__fixtures__/commands/distinct.mts

@@ -7,7 +7,10 @@ import chars from '#enums/chars'
 import integer from '#parsers/integer'
 import sfmt from '#tests/utils/sfmt'
 import c from '@flex-development/colors'
-import type { SubcommandInfo as CommandInfo } from '@flex-development/kronk'
+import type {
+  SubcommandInfo as CommandInfo,
+  ExampleInfo
+} from '@flex-development/kronk'
 
 /**
  * The program info for `factorial`.
@@ -29,7 +32,10 @@ export default {
     { comment: '// 6', text: '3' },
     { comment: '// 6227020800', text: '13' },
     { comment: '// show help and exit', text: '--help' }
-  ].map(info => (info.text && (info.text = c.yellow(info.text)), info)),
+  ].map((info: ExampleInfo) => {
+    if (info.text) info.text = c.yellow(info.text)
+    return info.command = c.bold('factorial'), info
+  }),
   name: 'factorial',
   usage: { options: null },
   version: chars.empty

__fixtures__/commands/factorial.mts

@@ -165,6 +165,7 @@ export default {
           syntax: sfmt.optional({ id: 'candidate' })
         },
         description: 'Get a version bump recommendation.',
+        examples: { text: [] },
         helpCommand: false,
         name: 'recommend',
         summary: 'get a recommended version bump'
@@ -256,6 +257,7 @@ export default {
     },
     manifest: {
       description: 'Manage the package manifest.',
+      help: { globalOptions: false },
       helpCommand: false,
       options: {
         description: 'the manifest path or url',
@@ -371,6 +373,7 @@ export default {
             syntax: sfmt.required({ id: 'tag' })
           },
           description: 'Create a release tag.',
+          help: { globalOptions: false },
           options: [
             {
               choices: bool.choices, // dprint-ignore-next

__fixtures__/commands/grease.mts

@@ -157,12 +157,15 @@
   "dependencies": {
     "@flex-development/colors": "2.0.0",
     "@flex-development/fsm-tokenizer": "1.0.0-alpha.1",
+    "@flex-development/string-wrap": "2.1.2",
+    "@flex-development/strip-ansi": "1.0.0",
     "@flex-development/tutils": "6.0.0-alpha.25",
     "@types/semver": "7.7.1",
     "devlop": "1.1.0",
     "eventemitter2": "6.4.9",
     "micromark-util-character": "2.1.1",
-    "plur": "6.0.0"
+    "plur": "6.0.0",
+    "string-width": "8.1.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.2",