inray 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. package/LICENSE.md +28 -27
  2. package/README.md +158 -52
  3. package/dist/async/abortable.d.ts +2 -2
  4. package/dist/async/abortable.d.ts.map +1 -1
  5. package/dist/async/abortable.js.map +1 -1
  6. package/dist/cli/mod.d.ts +2 -0
  7. package/dist/cli/mod.d.ts.map +1 -0
  8. package/dist/cli/mod.js +2 -0
  9. package/dist/cli/mod.js.map +1 -0
  10. package/dist/cli/src/index.d.ts +25 -0
  11. package/dist/cli/src/index.d.ts.map +1 -0
  12. package/dist/cli/src/index.js +25 -0
  13. package/dist/cli/src/index.js.map +1 -0
  14. package/dist/cli/src/lib/argument.d.ts +82 -0
  15. package/dist/cli/src/lib/argument.d.ts.map +1 -0
  16. package/dist/cli/src/lib/argument.js +143 -0
  17. package/dist/cli/src/lib/argument.js.map +1 -0
  18. package/dist/cli/src/lib/command.d.ts +1051 -0
  19. package/dist/cli/src/lib/command.d.ts.map +1 -0
  20. package/dist/cli/src/lib/command.js +2208 -0
  21. package/dist/cli/src/lib/command.js.map +1 -0
  22. package/dist/cli/src/lib/error.d.ts +35 -0
  23. package/dist/cli/src/lib/error.d.ts.map +1 -0
  24. package/dist/cli/src/lib/error.js +49 -0
  25. package/dist/cli/src/lib/error.js.map +1 -0
  26. package/dist/cli/src/lib/help.d.ts +250 -0
  27. package/dist/cli/src/lib/help.d.ts.map +1 -0
  28. package/dist/cli/src/lib/help.js +583 -0
  29. package/dist/cli/src/lib/help.js.map +1 -0
  30. package/dist/cli/src/lib/option.d.ts +189 -0
  31. package/dist/cli/src/lib/option.d.ts.map +1 -0
  32. package/dist/cli/src/lib/option.js +364 -0
  33. package/dist/cli/src/lib/option.js.map +1 -0
  34. package/dist/cli/src/lib/suggestSimilar.d.ts +18 -0
  35. package/dist/cli/src/lib/suggestSimilar.d.ts.map +1 -0
  36. package/dist/cli/src/lib/suggestSimilar.js +99 -0
  37. package/dist/cli/src/lib/suggestSimilar.js.map +1 -0
  38. package/dist/logtape/logtape/level.d.ts +1 -2
  39. package/dist/logtape/logtape/level.d.ts.map +1 -1
  40. package/dist/logtape/logtape/level.js +1 -1
  41. package/dist/logtape/logtape/level.js.map +1 -1
  42. package/dist/logtape/logtape/mod.d.ts +1 -1
  43. package/dist/logtape/logtape/mod.d.ts.map +1 -1
  44. package/dist/logtape/logtape/mod.js +1 -1
  45. package/dist/logtape/logtape/mod.js.map +1 -1
  46. package/dist/utils/mod.d.ts +1 -1
  47. package/dist/utils/mod.d.ts.map +1 -1
  48. package/dist/utils/mod.js.map +1 -1
  49. package/dist/utils/validation/inRangeOfMaxInt32.d.ts +2 -0
  50. package/dist/utils/validation/inRangeOfMaxInt32.d.ts.map +1 -0
  51. package/dist/utils/validation/inRangeOfMaxInt32.js +4 -0
  52. package/dist/utils/validation/inRangeOfMaxInt32.js.map +1 -0
  53. package/dist/utils/validation/isEmail.d.ts +2 -0
  54. package/dist/utils/validation/isEmail.d.ts.map +1 -0
  55. package/dist/utils/validation/isEmail.js +7 -0
  56. package/dist/utils/validation/isEmail.js.map +1 -0
  57. package/dist/utils/validation/isEmptyObject.d.ts +9 -0
  58. package/dist/utils/validation/isEmptyObject.d.ts.map +1 -0
  59. package/dist/utils/validation/isEmptyObject.js +16 -0
  60. package/dist/utils/validation/isEmptyObject.js.map +1 -0
  61. package/dist/utils/validation/isNotEmptyString.d.ts +7 -0
  62. package/dist/utils/validation/isNotEmptyString.d.ts.map +1 -0
  63. package/dist/utils/validation/isNotEmptyString.js +17 -0
  64. package/dist/utils/validation/isNotEmptyString.js.map +1 -0
  65. package/dist/utils/validation/isPositiveInteger.d.ts +2 -0
  66. package/dist/utils/validation/isPositiveInteger.d.ts.map +1 -0
  67. package/dist/utils/validation/isPositiveInteger.js +7 -0
  68. package/dist/utils/validation/isPositiveInteger.js.map +1 -0
  69. package/dist/utils/validation/isUuid.d.ts +2 -0
  70. package/dist/utils/validation/isUuid.d.ts.map +1 -0
  71. package/dist/utils/validation/isUuid.js +7 -0
  72. package/dist/utils/validation/isUuid.js.map +1 -0
  73. package/dist/utils/validation/isUuidArray.d.ts +2 -0
  74. package/dist/utils/validation/isUuidArray.d.ts.map +1 -0
  75. package/dist/utils/validation/isUuidArray.js +7 -0
  76. package/dist/utils/validation/isUuidArray.js.map +1 -0
  77. package/dist/utils/validation/isValidFileName.d.ts +2 -0
  78. package/dist/utils/validation/isValidFileName.d.ts.map +1 -0
  79. package/dist/utils/validation/isValidFileName.js +33 -0
  80. package/dist/utils/validation/isValidFileName.js.map +1 -0
  81. package/dist/utils/validation/isValidUrlLike.d.ts +6 -0
  82. package/dist/utils/validation/isValidUrlLike.d.ts.map +1 -0
  83. package/dist/utils/validation/isValidUrlLike.js +8 -0
  84. package/dist/utils/validation/isValidUrlLike.js.map +1 -0
  85. package/dist/utils/validation/mod.d.ts +21 -0
  86. package/dist/utils/validation/mod.d.ts.map +1 -0
  87. package/dist/utils/validation/mod.js +21 -0
  88. package/dist/utils/validation/mod.js.map +1 -0
  89. package/dist/utils/validation/vEnvBoolean.d.ts +3 -0
  90. package/dist/utils/validation/vEnvBoolean.d.ts.map +1 -0
  91. package/dist/utils/validation/vEnvBoolean.js +5 -0
  92. package/dist/utils/validation/vEnvBoolean.js.map +1 -0
  93. package/dist/utils/validation/vEnvBooleanOrUndefined.d.ts +3 -0
  94. package/dist/utils/validation/vEnvBooleanOrUndefined.d.ts.map +1 -0
  95. package/dist/utils/validation/vEnvBooleanOrUndefined.js +5 -0
  96. package/dist/utils/validation/vEnvBooleanOrUndefined.js.map +1 -0
  97. package/dist/utils/validation/vEnvLogLevel.d.ts +4 -0
  98. package/dist/utils/validation/vEnvLogLevel.d.ts.map +1 -0
  99. package/dist/utils/validation/vEnvLogLevel.js +6 -0
  100. package/dist/utils/validation/vEnvLogLevel.js.map +1 -0
  101. package/dist/utils/validation/vFileName.d.ts +4 -0
  102. package/dist/utils/validation/vFileName.d.ts.map +1 -0
  103. package/dist/utils/validation/vFileName.js +21 -0
  104. package/dist/utils/validation/vFileName.js.map +1 -0
  105. package/dist/utils/validation/vISO8601DateTime.d.ts +5 -0
  106. package/dist/utils/validation/vISO8601DateTime.d.ts.map +1 -0
  107. package/dist/utils/validation/vISO8601DateTime.js +37 -0
  108. package/dist/utils/validation/vISO8601DateTime.js.map +1 -0
  109. package/dist/utils/validation/vLatinInput.d.ts +3 -0
  110. package/dist/utils/validation/vLatinInput.d.ts.map +1 -0
  111. package/dist/utils/validation/vLatinInput.js +3 -0
  112. package/dist/utils/validation/vLatinInput.js.map +1 -0
  113. package/dist/utils/validation/vOmniBoolean.d.ts +3 -0
  114. package/dist/utils/validation/vOmniBoolean.d.ts.map +1 -0
  115. package/dist/utils/validation/vOmniBoolean.js +10 -0
  116. package/dist/utils/validation/vOmniBoolean.js.map +1 -0
  117. package/dist/utils/validation/vQueryBoolean.d.ts +3 -0
  118. package/dist/utils/validation/vQueryBoolean.d.ts.map +1 -0
  119. package/dist/utils/validation/vQueryBoolean.js +7 -0
  120. package/dist/utils/validation/vQueryBoolean.js.map +1 -0
  121. package/dist/utils/validation/vQueryEmailArray.d.ts +9 -0
  122. package/dist/utils/validation/vQueryEmailArray.d.ts.map +1 -0
  123. package/dist/utils/validation/vQueryEmailArray.js +29 -0
  124. package/dist/utils/validation/vQueryEmailArray.js.map +1 -0
  125. package/dist/utils/validation/vQueryNumberArray.d.ts +10 -0
  126. package/dist/utils/validation/vQueryNumberArray.d.ts.map +1 -0
  127. package/dist/utils/validation/vQueryNumberArray.js +32 -0
  128. package/dist/utils/validation/vQueryNumberArray.js.map +1 -0
  129. package/dist/utils/validation/vQueryStringifiedEnumArray.d.ts +3 -0
  130. package/dist/utils/validation/vQueryStringifiedEnumArray.d.ts.map +1 -0
  131. package/dist/utils/validation/vQueryStringifiedEnumArray.js +25 -0
  132. package/dist/utils/validation/vQueryStringifiedEnumArray.js.map +1 -0
  133. package/dist/utils/validation/vQueryUuidArray.d.ts +9 -0
  134. package/dist/utils/validation/vQueryUuidArray.d.ts.map +1 -0
  135. package/dist/utils/validation/vQueryUuidArray.js +27 -0
  136. package/dist/utils/validation/vQueryUuidArray.js.map +1 -0
  137. package/package.json +15 -2
@@ -0,0 +1,583 @@
1
+ /**
2
+ * Original library: commander.js (v15.0.0)
3
+ * - Copyright (c) 2011 TJ Holowaychuk
4
+ * - Copyright (c) John Gee and "commander.js" authors
5
+ *
6
+ * Modified and integrated in "Inray":
7
+ * - Evgeniy Bushin
8
+ */
9
+ /***/
10
+ import { stripVTControlCharacters } from 'node:util';
11
+ import { Argument, humanReadableArgName } from "./argument.js";
12
+ // Although this is a class, methods are static in style to allow override using subclass or just functions.
13
+ export class Help {
14
+ helpWidth;
15
+ minWidthToWrap;
16
+ sortSubcommands;
17
+ sortOptions;
18
+ showGlobalOptions;
19
+ constructor() {
20
+ this.helpWidth = undefined;
21
+ this.minWidthToWrap = 40;
22
+ this.sortSubcommands = false;
23
+ this.sortOptions = false;
24
+ this.showGlobalOptions = false;
25
+ }
26
+ /**
27
+ * prepareContext is called by Commander after applying overrides from `Command.configureHelp()`
28
+ * and just before calling `formatHelp()`.
29
+ *
30
+ * Commander just uses the helpWidth and the rest is provided for optional use by more complex subclasses.
31
+ *
32
+ * @param {{ error?: boolean, helpWidth?: number, outputHasColors?: boolean }} contextOptions
33
+ */
34
+ prepareContext(contextOptions) {
35
+ this.helpWidth = this.helpWidth ?? contextOptions.helpWidth ?? 80;
36
+ }
37
+ /**
38
+ * Get an array of the visible subcommands. Includes a placeholder for the implicit help command, if there is one.
39
+ *
40
+ * @param {Command} cmd
41
+ * @returns {Command[]}
42
+ */
43
+ visibleCommands(cmd) {
44
+ const visibleCommands = cmd.commands.filter((cmd) => !cmd._hidden);
45
+ const helpCommand = cmd._getHelpCommand();
46
+ if (helpCommand && !helpCommand._hidden) {
47
+ visibleCommands.push(helpCommand);
48
+ }
49
+ if (this.sortSubcommands) {
50
+ visibleCommands.sort((a, b) => {
51
+ // @ts-ignore: because overloaded return type
52
+ return a.name().localeCompare(b.name());
53
+ });
54
+ }
55
+ return visibleCommands;
56
+ }
57
+ /**
58
+ * Compare options for sort.
59
+ *
60
+ * @param {Option} a
61
+ * @param {Option} b
62
+ * @returns {number}
63
+ */
64
+ compareOptions(a, b) {
65
+ const getSortKey = (option) => {
66
+ // WYSIWYG for order displayed in help. Short used for comparison if present. No special handling for negated.
67
+ return option.short ? option.short.replace(/^-/, '') : option.long ? option.long.replace(/^--/, '') : '';
68
+ };
69
+ return getSortKey(a).localeCompare(getSortKey(b));
70
+ }
71
+ /**
72
+ * Get an array of the visible options. Includes a placeholder for the implicit help option, if there is one.
73
+ *
74
+ * @param {Command} cmd
75
+ * @returns {Option[]}
76
+ */
77
+ visibleOptions(cmd) {
78
+ const visibleOptions = cmd.options.filter((option) => !option.hidden);
79
+ // Built-in help option.
80
+ const helpOption = cmd._getHelpOption();
81
+ if (helpOption && !helpOption.hidden) {
82
+ // Automatically hide conflicting flags. Bit dubious but a historical behaviour that is convenient for single-command programs.
83
+ const removeShort = helpOption.short && cmd._findOption(helpOption.short);
84
+ const removeLong = helpOption.long && cmd._findOption(helpOption.long);
85
+ if (!removeShort && !removeLong) {
86
+ visibleOptions.push(helpOption); // no changes needed
87
+ }
88
+ else if (helpOption.long && !removeLong) {
89
+ visibleOptions.push(cmd.createOption(helpOption.long, helpOption.description));
90
+ }
91
+ else if (helpOption.short && !removeShort) {
92
+ visibleOptions.push(cmd.createOption(helpOption.short, helpOption.description));
93
+ }
94
+ }
95
+ if (this.sortOptions) {
96
+ visibleOptions.sort(this.compareOptions);
97
+ }
98
+ return visibleOptions;
99
+ }
100
+ /**
101
+ * Get an array of the visible global options. (Not including help.)
102
+ *
103
+ * @param {Command} cmd
104
+ * @returns {Option[]}
105
+ */
106
+ visibleGlobalOptions(cmd) {
107
+ if (!this.showGlobalOptions)
108
+ return [];
109
+ const globalOptions = [];
110
+ for (let ancestorCmd = cmd.parent; ancestorCmd; ancestorCmd = ancestorCmd.parent) {
111
+ const visibleOptions = ancestorCmd.options.filter((option) => !option.hidden);
112
+ globalOptions.push(...visibleOptions);
113
+ }
114
+ if (this.sortOptions) {
115
+ globalOptions.sort(this.compareOptions);
116
+ }
117
+ return globalOptions;
118
+ }
119
+ /**
120
+ * Get an array of the arguments if any have a description.
121
+ *
122
+ * @param {Command} cmd
123
+ * @returns {Argument[]}
124
+ */
125
+ visibleArguments(cmd) {
126
+ // Side effect! Apply the legacy descriptions before the arguments are displayed.
127
+ if (cmd._argsDescription) {
128
+ cmd.registeredArguments.forEach((argument) => {
129
+ argument.description = argument.description || cmd._argsDescription[argument.name()] || '';
130
+ });
131
+ }
132
+ // If there are any arguments with a description then return all the arguments.
133
+ if (cmd.registeredArguments.find((argument) => argument.description)) {
134
+ return cmd.registeredArguments;
135
+ }
136
+ return [];
137
+ }
138
+ /**
139
+ * Get the command term to show in the list of subcommands.
140
+ *
141
+ * @param {Command} cmd
142
+ * @returns {string}
143
+ */
144
+ subcommandTerm(cmd) {
145
+ // Legacy. Ignores custom usage string, and nested commands.
146
+ const args = cmd.registeredArguments.map((arg) => humanReadableArgName(arg)).join(' ');
147
+ return (cmd._name +
148
+ (cmd._aliases[0] ? '|' + cmd._aliases[0] : '') +
149
+ (cmd.options.length ? ' [options]' : '') + // simplistic check for non-help option
150
+ (args ? ' ' + args : ''));
151
+ }
152
+ /**
153
+ * Get the option term to show in the list of options.
154
+ *
155
+ * @param {Option} option
156
+ * @returns {string}
157
+ */
158
+ optionTerm(option) {
159
+ return option.flags;
160
+ }
161
+ /**
162
+ * Get the argument term to show in the list of arguments.
163
+ *
164
+ * @param {Argument} argument
165
+ * @returns {string}
166
+ */
167
+ argumentTerm(argument) {
168
+ return argument.name();
169
+ }
170
+ /**
171
+ * Get the longest command term length.
172
+ *
173
+ * @param {Command} cmd
174
+ * @param {Help} helper
175
+ * @returns {number}
176
+ */
177
+ longestSubcommandTermLength(cmd, helper) {
178
+ return helper.visibleCommands(cmd).reduce((max, command) => {
179
+ return Math.max(max, this.displayWidth(helper.styleSubcommandTerm(helper.subcommandTerm(command))));
180
+ }, 0);
181
+ }
182
+ /**
183
+ * Get the longest option term length.
184
+ *
185
+ * @param {Command} cmd
186
+ * @param {Help} helper
187
+ * @returns {number}
188
+ */
189
+ longestOptionTermLength(cmd, helper) {
190
+ return helper.visibleOptions(cmd).reduce((max, option) => {
191
+ return Math.max(max, this.displayWidth(helper.styleOptionTerm(helper.optionTerm(option))));
192
+ }, 0);
193
+ }
194
+ /**
195
+ * Get the longest global option term length.
196
+ *
197
+ * @param {Command} cmd
198
+ * @param {Help} helper
199
+ * @returns {number}
200
+ */
201
+ longestGlobalOptionTermLength(cmd, helper) {
202
+ return helper.visibleGlobalOptions(cmd).reduce((max, option) => {
203
+ return Math.max(max, this.displayWidth(helper.styleOptionTerm(helper.optionTerm(option))));
204
+ }, 0);
205
+ }
206
+ /**
207
+ * Get the longest argument term length.
208
+ *
209
+ * @param {Command} cmd
210
+ * @param {Help} helper
211
+ * @returns {number}
212
+ */
213
+ longestArgumentTermLength(cmd, helper) {
214
+ return helper.visibleArguments(cmd).reduce((max, argument) => {
215
+ return Math.max(max, this.displayWidth(helper.styleArgumentTerm(helper.argumentTerm(argument))));
216
+ }, 0);
217
+ }
218
+ /**
219
+ * Get the command usage to be displayed at the top of the built-in help.
220
+ *
221
+ * @param {Command} cmd
222
+ * @returns {string}
223
+ */
224
+ commandUsage(cmd) {
225
+ // Usage
226
+ let cmdName = cmd._name;
227
+ if (cmd._aliases[0]) {
228
+ cmdName = cmdName + '|' + cmd._aliases[0];
229
+ }
230
+ let ancestorCmdNames = '';
231
+ for (let ancestorCmd = cmd.parent; ancestorCmd; ancestorCmd = ancestorCmd.parent) {
232
+ ancestorCmdNames = ancestorCmd.name() + ' ' + ancestorCmdNames;
233
+ }
234
+ return ancestorCmdNames + cmdName + ' ' + cmd.usage();
235
+ }
236
+ /**
237
+ * Get the description for the command.
238
+ *
239
+ * @param {Command} cmd
240
+ * @returns {string}
241
+ */
242
+ commandDescription(cmd) {
243
+ // @ts-ignore: because overloaded return type
244
+ return cmd.description();
245
+ }
246
+ /**
247
+ * Get the subcommand summary to show in the list of subcommands.
248
+ * (Fallback to description for backwards compatibility.)
249
+ *
250
+ * @param {Command} cmd
251
+ * @returns {string}
252
+ */
253
+ subcommandDescription(cmd) {
254
+ // @ts-ignore: because overloaded return type
255
+ return cmd.summary() || cmd.description();
256
+ }
257
+ /**
258
+ * Get the option description to show in the list of options.
259
+ *
260
+ * @param {Option} option
261
+ * @return {string}
262
+ */
263
+ optionDescription(option) {
264
+ const extraInfo = [];
265
+ if (option.argChoices) {
266
+ extraInfo.push(
267
+ // use stringify to match the display of the default value
268
+ `choices: ${option.argChoices.map((choice) => JSON.stringify(choice)).join(', ')}`);
269
+ }
270
+ if (option.defaultValue !== undefined) {
271
+ // default for boolean and negated more for programmer than end user,
272
+ // but show true/false for boolean option as may be for hand-rolled env or config processing.
273
+ const showDefault = option.required || option.optional || (option.isBoolean() && typeof option.defaultValue === 'boolean');
274
+ if (showDefault) {
275
+ extraInfo.push(`default: ${option.defaultValueDescription || JSON.stringify(option.defaultValue)}`);
276
+ }
277
+ }
278
+ // preset for boolean and negated are more for programmer than end user
279
+ if (option.presetArg !== undefined && option.optional) {
280
+ extraInfo.push(`preset: ${JSON.stringify(option.presetArg)}`);
281
+ }
282
+ if (option.envVar !== undefined) {
283
+ extraInfo.push(`env: ${option.envVar}`);
284
+ }
285
+ if (extraInfo.length > 0) {
286
+ const extraDescription = `(${extraInfo.join(', ')})`;
287
+ if (option.description) {
288
+ return `${option.description} ${extraDescription}`;
289
+ }
290
+ return extraDescription;
291
+ }
292
+ return option.description;
293
+ }
294
+ /**
295
+ * Get the argument description to show in the list of arguments.
296
+ *
297
+ * @param {Argument} argument
298
+ * @return {string}
299
+ */
300
+ argumentDescription(argument) {
301
+ const extraInfo = [];
302
+ if (argument.argChoices) {
303
+ extraInfo.push(
304
+ // use stringify to match the display of the default value
305
+ `choices: ${argument.argChoices.map((choice) => JSON.stringify(choice)).join(', ')}`);
306
+ }
307
+ if (argument.defaultValue !== undefined) {
308
+ extraInfo.push(`default: ${argument.defaultValueDescription || JSON.stringify(argument.defaultValue)}`);
309
+ }
310
+ if (extraInfo.length > 0) {
311
+ const extraDescription = `(${extraInfo.join(', ')})`;
312
+ if (argument.description) {
313
+ return `${argument.description} ${extraDescription}`;
314
+ }
315
+ return extraDescription;
316
+ }
317
+ return argument.description;
318
+ }
319
+ /**
320
+ * Format a list of items, given a heading and an array of formatted items.
321
+ *
322
+ * @param {string} heading
323
+ * @param {string[]} items
324
+ * @param {Help} helper
325
+ * @returns string[]
326
+ */
327
+ formatItemList(heading, items, helper) {
328
+ if (items.length === 0)
329
+ return [];
330
+ return [helper.styleTitle(heading), ...items, ''];
331
+ }
332
+ /**
333
+ * Group items by their help group heading.
334
+ *
335
+ * @param {Command[] | Option[]} unsortedItems
336
+ * @param {Command[] | Option[]} visibleItems
337
+ * @param {Function} getGroup
338
+ * @returns {Map<string, Command[] | Option[]>}
339
+ */
340
+ groupItems(unsortedItems, visibleItems, getGroup) {
341
+ const result = new Map();
342
+ // Add groups in order of appearance in unsortedItems.
343
+ unsortedItems.forEach((item) => {
344
+ const group = getGroup(item);
345
+ if (!result.has(group))
346
+ result.set(group, []);
347
+ });
348
+ // Add items in order of appearance in visibleItems.
349
+ visibleItems.forEach((item) => {
350
+ const group = getGroup(item);
351
+ if (!result.has(group)) {
352
+ result.set(group, []);
353
+ }
354
+ result.get(group).push(item);
355
+ });
356
+ return result;
357
+ }
358
+ /**
359
+ * Generate the built-in help text.
360
+ *
361
+ * @param {Command} cmd
362
+ * @param {Help} helper
363
+ * @returns {string}
364
+ */
365
+ formatHelp(cmd, helper) {
366
+ const termWidth = helper.padWidth(cmd, helper);
367
+ const helpWidth = helper.helpWidth ?? 80; // in case prepareContext() was not called
368
+ function callFormatItem(term, description) {
369
+ return helper.formatItem(term, termWidth, description, helper);
370
+ }
371
+ // Usage
372
+ let output = [`${helper.styleTitle('Usage:')} ${helper.styleUsage(helper.commandUsage(cmd))}`, ''];
373
+ // Description
374
+ const commandDescription = helper.commandDescription(cmd);
375
+ if (commandDescription.length > 0) {
376
+ output = output.concat([helper.boxWrap(helper.styleCommandDescription(commandDescription), helpWidth), '']);
377
+ }
378
+ // Arguments
379
+ const argumentList = helper.visibleArguments(cmd).map((argument) => {
380
+ return callFormatItem(helper.styleArgumentTerm(helper.argumentTerm(argument)), helper.styleArgumentDescription(helper.argumentDescription(argument)));
381
+ });
382
+ output = output.concat(this.formatItemList('Arguments:', argumentList, helper));
383
+ // Options
384
+ const optionGroups = this.groupItems(cmd.options, helper.visibleOptions(cmd), (option) => option.helpGroupHeading ?? 'Options:');
385
+ optionGroups.forEach((options, group) => {
386
+ const optionList = options.map((option) => {
387
+ return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
388
+ });
389
+ output = output.concat(this.formatItemList(group, optionList, helper));
390
+ });
391
+ if (helper.showGlobalOptions) {
392
+ const globalOptionList = helper.visibleGlobalOptions(cmd).map((option) => {
393
+ return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
394
+ });
395
+ output = output.concat(this.formatItemList('Global Options:', globalOptionList, helper));
396
+ }
397
+ // Commands
398
+ const commandGroups = this.groupItems(cmd.commands, helper.visibleCommands(cmd), (sub) => sub.helpGroup() || 'Commands:');
399
+ commandGroups.forEach((commands, group) => {
400
+ const commandList = commands.map((sub) => {
401
+ return callFormatItem(helper.styleSubcommandTerm(helper.subcommandTerm(sub)), helper.styleSubcommandDescription(helper.subcommandDescription(sub)));
402
+ });
403
+ output = output.concat(this.formatItemList(group, commandList, helper));
404
+ });
405
+ return output.join('\n');
406
+ }
407
+ /**
408
+ * Return display width of string, ignoring ANSI escape sequences. Used in padding and wrapping calculations.
409
+ *
410
+ * @param {string} str
411
+ * @returns {number}
412
+ */
413
+ displayWidth(str) {
414
+ return stripVTControlCharacters(str).length;
415
+ }
416
+ /**
417
+ * Style the title for displaying in the help. Called with 'Usage:', 'Options:', etc.
418
+ *
419
+ * @param {string} str
420
+ * @returns {string}
421
+ */
422
+ styleTitle(str) {
423
+ return str;
424
+ }
425
+ styleUsage(str) {
426
+ // Usage has lots of parts the user might like to color separately! Assume default usage string which is formed like:
427
+ // command subcommand [options] [command] <foo> [bar]
428
+ return str
429
+ .split(' ')
430
+ .map((word) => {
431
+ if (word === '[options]')
432
+ return this.styleOptionText(word);
433
+ if (word === '[command]')
434
+ return this.styleSubcommandText(word);
435
+ if (word[0] === '[' || word[0] === '<')
436
+ return this.styleArgumentText(word);
437
+ return this.styleCommandText(word); // Restrict to initial words?
438
+ })
439
+ .join(' ');
440
+ }
441
+ styleCommandDescription(str) {
442
+ return this.styleDescriptionText(str);
443
+ }
444
+ styleOptionDescription(str) {
445
+ return this.styleDescriptionText(str);
446
+ }
447
+ styleSubcommandDescription(str) {
448
+ return this.styleDescriptionText(str);
449
+ }
450
+ styleArgumentDescription(str) {
451
+ return this.styleDescriptionText(str);
452
+ }
453
+ styleDescriptionText(str) {
454
+ return str;
455
+ }
456
+ styleOptionTerm(str) {
457
+ return this.styleOptionText(str);
458
+ }
459
+ styleSubcommandTerm(str) {
460
+ // This is very like usage with lots of parts! Assume default string which is formed like:
461
+ // subcommand [options] <foo> [bar]
462
+ return str
463
+ .split(' ')
464
+ .map((word) => {
465
+ if (word === '[options]')
466
+ return this.styleOptionText(word);
467
+ if (word[0] === '[' || word[0] === '<')
468
+ return this.styleArgumentText(word);
469
+ return this.styleSubcommandText(word); // Restrict to initial words?
470
+ })
471
+ .join(' ');
472
+ }
473
+ styleArgumentTerm(str) {
474
+ return this.styleArgumentText(str);
475
+ }
476
+ styleOptionText(str) {
477
+ return str;
478
+ }
479
+ styleArgumentText(str) {
480
+ return str;
481
+ }
482
+ styleSubcommandText(str) {
483
+ return str;
484
+ }
485
+ styleCommandText(str) {
486
+ return str;
487
+ }
488
+ /**
489
+ * Calculate the pad width from the maximum term length.
490
+ *
491
+ * @param {Command} cmd
492
+ * @param {Help} helper
493
+ * @returns {number}
494
+ */
495
+ padWidth(cmd, helper) {
496
+ return Math.max(helper.longestOptionTermLength(cmd, helper), helper.longestGlobalOptionTermLength(cmd, helper), helper.longestSubcommandTermLength(cmd, helper), helper.longestArgumentTermLength(cmd, helper));
497
+ }
498
+ /**
499
+ * Detect manually wrapped and indented strings by checking for line break followed by whitespace.
500
+ *
501
+ * @param {string} str
502
+ * @returns {boolean}
503
+ */
504
+ preformatted(str) {
505
+ return /\n[^\S\r\n]/.test(str);
506
+ }
507
+ /**
508
+ * Format the "item", which consists of a term and description. Pad the term and wrap the description, indenting the following lines.
509
+ *
510
+ * So "TTT", 5, "DDD DDDD DD DDD" might be formatted for this.helpWidth=17 like so:
511
+ * TTT DDD DDDD
512
+ * DD DDD
513
+ *
514
+ * @param {string} term
515
+ * @param {number} termWidth
516
+ * @param {string} description
517
+ * @param {Help} helper
518
+ * @returns {string}
519
+ */
520
+ formatItem(term, termWidth, description, helper) {
521
+ const itemIndent = 2;
522
+ const itemIndentStr = ' '.repeat(itemIndent);
523
+ if (!description)
524
+ return itemIndentStr + term;
525
+ // Pad the term out to a consistent width, so descriptions are aligned.
526
+ const paddedTerm = term.padEnd(termWidth + term.length - helper.displayWidth(term));
527
+ // Format the description.
528
+ const spacerWidth = 2; // between term and description
529
+ const helpWidth = this.helpWidth ?? 80; // in case prepareContext() was not called
530
+ const remainingWidth = helpWidth - termWidth - spacerWidth - itemIndent;
531
+ let formattedDescription;
532
+ if (remainingWidth < this.minWidthToWrap || helper.preformatted(description)) {
533
+ formattedDescription = description;
534
+ }
535
+ else {
536
+ const wrappedDescription = helper.boxWrap(description, remainingWidth);
537
+ formattedDescription = wrappedDescription.replace(/\n/g, '\n' + ' '.repeat(termWidth + spacerWidth));
538
+ }
539
+ // Construct and overall indent.
540
+ return (itemIndentStr + paddedTerm + ' '.repeat(spacerWidth) + formattedDescription.replace(/\n/g, `\n${itemIndentStr}`));
541
+ }
542
+ /**
543
+ * Wrap a string at whitespace, preserving existing line breaks.
544
+ * Wrapping is skipped if the width is less than `minWidthToWrap`.
545
+ *
546
+ * @param {string} str
547
+ * @param {number} width
548
+ * @returns {string}
549
+ */
550
+ boxWrap(str, width) {
551
+ if (width < this.minWidthToWrap)
552
+ return str;
553
+ const rawLines = str.split(/\r\n|\n/);
554
+ // split up text by whitespace
555
+ const chunkPattern = /[\s]*[^\s]+/g;
556
+ const wrappedLines = [];
557
+ rawLines.forEach((line) => {
558
+ const chunks = line.match(chunkPattern);
559
+ if (chunks === null) {
560
+ wrappedLines.push('');
561
+ return;
562
+ }
563
+ let sumChunks = [chunks.shift() ?? ''];
564
+ let sumWidth = this.displayWidth(sumChunks[0]);
565
+ chunks.forEach((chunk) => {
566
+ const visibleWidth = this.displayWidth(chunk);
567
+ // Accumulate chunks while they fit into width.
568
+ if (sumWidth + visibleWidth <= width) {
569
+ sumChunks.push(chunk);
570
+ sumWidth += visibleWidth;
571
+ return;
572
+ }
573
+ wrappedLines.push(sumChunks.join(''));
574
+ const nextChunk = chunk.trimStart(); // trim space at line break
575
+ sumChunks = [nextChunk];
576
+ sumWidth = this.displayWidth(nextChunk);
577
+ });
578
+ wrappedLines.push(sumChunks.join(''));
579
+ });
580
+ return wrappedLines.join('\n');
581
+ }
582
+ }
583
+ //# sourceMappingURL=help.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"help.js","sourceRoot":"","sources":["../../../../src/cli/src/lib/help.ts"],"names":[],"mappings":"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"}