sdd-skills 1.1.3 → 1.1.5

package/node_modules/inquirer/lib/prompts/editor.js

@@ -0,0 +1,104 @@
+/**
+ * `editor` type prompt
+ */
+
+import colors from 'yoctocolors-cjs';
+import { editAsync } from '@inquirer/external-editor';
+import { Subject } from 'rxjs';
+import observe from '../utils/events.js';
+import Base from './base.js';
+
+export default class EditorPrompt extends Base {
+  /**
+   * Start the Inquiry session
+   * @param  {Function} cb      Callback when prompt is done
+   * @return {this}
+   */
+
+  _run(cb) {
+    this.done = cb;
+
+    this.editorResult = new Subject();
+
+    // Open Editor on "line" (Enter Key)
+    const events = observe(this.rl);
+    this.lineSubscription = events.line.subscribe(this.startExternalEditor.bind(this));
+    const waitUserInput =
+      this.opt.waitUserInput === undefined ? true : this.opt.waitUserInput;
+
+    // Trigger Validation when editor closes
+    const validation = this.handleSubmitEvents(this.editorResult);
+    validation.success.forEach(this.onEnd.bind(this));
+    validation.error.forEach(this.onError.bind(this));
+
+    // Prevents default from being printed on screen (can look weird with multiple lines)
+    this.currentText = this.opt.default;
+    this.opt.default = null;
+
+    // Init
+    if (waitUserInput) {
+      this.render();
+    } else {
+      this.startExternalEditor();
+    }
+
+    return this;
+  }
+
+  /**
+   * Render the prompt to screen
+   * @return {EditorPrompt} self
+   */
+
+  render(error) {
+    let bottomContent = '';
+    let message = this.getQuestion();
+
+    message +=
+      this.status === 'answered'
+        ? colors.dim('Received')
+        : colors.dim('Press <enter> to launch your preferred editor.');
+
+    if (error) {
+      bottomContent = colors.red('>> ') + error;
+    }
+
+    this.screen.render(message, bottomContent);
+  }
+
+  /**
+   * Launch $EDITOR on user press enter
+   */
+
+  startExternalEditor() {
+    // Pause Readline to prevent stdin and stdout from being modified while the editor is showing
+    this.rl.pause();
+    editAsync(this.currentText, this.endExternalEditor.bind(this), {
+      postfix: this.opt.postfix ?? '.txt',
+    });
+  }
+
+  endExternalEditor(error, result) {
+    this.rl.resume();
+    if (error) {
+      this.editorResult.error(error);
+    } else {
+      this.editorResult.next(result);
+    }
+  }
+
+  onEnd(state) {
+    this.editorResult.unsubscribe();
+    this.lineSubscription.unsubscribe();
+    this.answer = state.value;
+    this.status = 'answered';
+    // Re-render prompt
+    this.render();
+    this.screen.done();
+    this.done(this.answer);
+  }
+
+  onError(state) {
+    this.render(state.isValid);
+  }
+}

package/node_modules/inquirer/lib/prompts/expand.js

@@ -0,0 +1,268 @@
+/**
+ * `rawlist` type prompt
+ */
+
+import colors from 'yoctocolors-cjs';
+import { map, takeUntil } from 'rxjs';
+import Separator from '../objects/separator.js';
+import observe from '../utils/events.js';
+import Paginator from '../utils/paginator.js';
+import Base from './base.js';
+
+export default class ExpandPrompt extends Base {
+  constructor(questions, rl, answers) {
+    super(questions, rl, answers);
+
+    if (!this.opt.choices) {
+      this.throwParamError('choices');
+    }
+
+    this.validateChoices(this.opt.choices);
+
+    // Add the default `help` (/expand) option
+    this.opt.choices.push({
+      key: 'h',
+      name: 'Help, list all options',
+      value: 'help',
+    });
+
+    this.opt.validate = (choice) => {
+      if (choice == null) {
+        return 'Please enter a valid command';
+      }
+
+      return choice !== 'help';
+    };
+
+    // Setup the default string (capitalize the default key)
+    this.opt.default = this.generateChoicesString(this.opt.choices, this.opt.default);
+
+    this.paginator = new Paginator(this.screen);
+  }
+
+  /**
+   * Start the Inquiry session
+   * @param  {Function} cb      Callback when prompt is done
+   * @return {this}
+   */
+
+  _run(cb) {
+    this.done = cb;
+
+    // Save user answer and update prompt to show selected option.
+    const events = observe(this.rl);
+    const validation = this.handleSubmitEvents(
+      events.line.pipe(map(this.getCurrentValue.bind(this))),
+    );
+    validation.success.forEach(this.onSubmit.bind(this));
+    validation.error.forEach(this.onError.bind(this));
+    this.keypressObs = events.keypress
+      .pipe(takeUntil(validation.success))
+      .forEach(this.onKeypress.bind(this));
+
+    // Init the prompt
+    this.render();
+
+    return this;
+  }
+
+  /**
+   * Render the prompt to screen
+   * @return {ExpandPrompt} self
+   */
+
+  render(error, hint) {
+    let message = this.getQuestion();
+    let bottomContent = '';
+
+    if (this.status === 'answered') {
+      message += colors.cyan(this.answer);
+    } else if (this.status === 'expanded') {
+      const choicesStr = renderChoices(this.opt.choices, this.selectedKey);
+      message += this.paginator.paginate(choicesStr, this.selectedKey, this.opt.pageSize);
+      message += '\n  Answer: ';
+    }
+
+    message += this.rl.line;
+
+    if (error) {
+      bottomContent = colors.red('>> ') + error;
+    }
+
+    if (hint) {
+      bottomContent = colors.cyan('>> ') + hint;
+    }
+
+    this.screen.render(message, bottomContent);
+  }
+
+  getCurrentValue(input) {
+    input ||= this.rawDefault;
+
+    const selected = this.opt.choices.where({ key: input.toLowerCase().trim() })[0];
+    if (!selected) {
+      return null;
+    }
+
+    return selected.value;
+  }
+
+  /**
+   * Generate the prompt choices string
+   * @return {String}  Choices string
+   */
+
+  getChoices() {
+    let output = '';
+
+    this.opt.choices.forEach((choice) => {
+      output += '\n  ';
+
+      if (choice.type === 'separator') {
+        output += ' ' + choice;
+        return;
+      }
+
+      let choiceStr = choice.key + ') ' + choice.name;
+      if (this.selectedKey === choice.key) {
+        choiceStr = colors.cyan(choiceStr);
+      }
+
+      output += choiceStr;
+    });
+
+    return output;
+  }
+
+  onError(state) {
+    if (state.value === 'help') {
+      this.selectedKey = '';
+      this.status = 'expanded';
+      this.render();
+      return;
+    }
+
+    this.render(state.isValid);
+  }
+
+  /**
+   * When user press `enter` key
+   */
+
+  onSubmit(state) {
+    this.status = 'answered';
+    const choice = this.opt.choices.where({ value: state.value })[0];
+    this.answer = choice.short || choice.name;
+
+    // Re-render prompt
+    this.render();
+    this.screen.done();
+    this.done(state.value);
+  }
+
+  /**
+   * When user press a key
+   */
+
+  onKeypress() {
+    this.selectedKey = this.rl.line.toLowerCase();
+    const selected = this.opt.choices.where({ key: this.selectedKey })[0];
+    if (this.status === 'expanded') {
+      this.render();
+    } else {
+      this.render(null, selected ? selected.name : null);
+    }
+  }
+
+  /**
+   * Validate the choices
+   * @param {Array} choices
+   */
+
+  validateChoices(choices) {
+    let formatError;
+    const errors = [];
+    const keymap = {};
+    choices.filter(Separator.exclude).forEach((choice) => {
+      if (!choice.key || choice.key.length !== 1) {
+        formatError = true;
+      }
+
+      choice.key = String(choice.key).toLowerCase();
+
+      if (keymap[choice.key]) {
+        errors.push(choice.key);
+      }
+
+      keymap[choice.key] = true;
+    });
+
+    if (formatError) {
+      throw new Error(
+        'Format error: `key` param must be a single letter and is required.',
+      );
+    }
+
+    if (keymap.h) {
+      throw new Error(
+        'Reserved key error: `key` param cannot be `h` - this value is reserved.',
+      );
+    }
+
+    if (errors.length > 0) {
+      throw new Error(
+        'Duplicate key error: `key` param must be unique. Duplicates: ' +
+          [...new Set(errors)].join(','),
+      );
+    }
+  }
+
+  /**
+   * Generate a string out of the choices keys
+   * @param  {Array}  choices
+   * @param  {Number|String} default - the choice index or name to capitalize
+   * @return {String} The rendered choices key string
+   */
+  generateChoicesString(choices, defaultChoice) {
+    let defIndex = choices.realLength - 1;
+    if (typeof defaultChoice === 'number' && this.opt.choices.getChoice(defaultChoice)) {
+      defIndex = defaultChoice;
+    } else if (typeof defaultChoice === 'string') {
+      const index = choices.realChoices.findIndex(({ value }) => value === defaultChoice);
+      defIndex = index === -1 ? defIndex : index;
+    }
+
+    const defStr = this.opt.choices.pluck('key');
+    this.rawDefault = defStr[defIndex];
+    defStr[defIndex] = String(defStr[defIndex]).toUpperCase();
+    return defStr.join('');
+  }
+}
+
+/**
+ * Function for rendering checkbox choices
+ * @param  {String} pointer Selected key
+ * @return {String}         Rendered content
+ */
+
+function renderChoices(choices, pointer) {
+  let output = '';
+
+  choices.forEach((choice) => {
+    output += '\n  ';
+
+    if (choice.type === 'separator') {
+      output += ' ' + choice;
+      return;
+    }
+
+    let choiceStr = choice.key + ') ' + choice.name;
+    if (pointer === choice.key) {
+      choiceStr = colors.cyan(choiceStr);
+    }
+
+    output += choiceStr;
+  });
+
+  return output;
+}

package/node_modules/inquirer/lib/prompts/input.js

@@ -0,0 +1,103 @@
+/**
+ * `input` type prompt
+ */
+
+import colors from 'yoctocolors-cjs';
+import { map, takeUntil } from 'rxjs';
+import observe from '../utils/events.js';
+import Base from './base.js';
+
+export default class InputPrompt extends Base {
+  /**
+   * Start the Inquiry session
+   * @param  {Function} cb      Callback when prompt is done
+   * @return {this}
+   */
+
+  _run(cb) {
+    this.done = cb;
+
+    // Once user confirm (enter key)
+    const events = observe(this.rl);
+    const submit = events.line.pipe(map(this.filterInput.bind(this)));
+
+    const validation = this.handleSubmitEvents(submit);
+    validation.success.forEach(this.onEnd.bind(this));
+    validation.error.forEach(this.onError.bind(this));
+
+    events.keypress
+      .pipe(takeUntil(validation.success))
+      .forEach(this.onKeypress.bind(this));
+
+    // Init
+    this.render();
+
+    return this;
+  }
+
+  /**
+   * Render the prompt to screen
+   * @return {InputPrompt} self
+   */
+
+  render(error) {
+    let bottomContent = '';
+    let appendContent = '';
+    let message = this.getQuestion();
+    const { transformer } = this.opt;
+    const isFinal = this.status === 'answered';
+
+    appendContent = isFinal ? this.answer : this.rl.line;
+
+    if (transformer) {
+      message += transformer(appendContent, this.answers, { isFinal });
+    } else {
+      message += isFinal ? colors.cyan(appendContent) : appendContent;
+    }
+
+    if (error) {
+      bottomContent = colors.red('>> ') + error;
+    }
+
+    this.screen.render(message, bottomContent);
+  }
+
+  /**
+   * When user press `enter` key
+   */
+
+  filterInput(input) {
+    if (!input) {
+      return this.opt.default == null ? '' : this.opt.default;
+    }
+
+    return input;
+  }
+
+  onEnd(state) {
+    this.answer = state.value;
+    this.status = 'answered';
+
+    // Re-render prompt
+    this.render();
+
+    this.screen.done();
+    this.done(state.value);
+  }
+
+  onError({ value = '', isValid }) {
+    this.rl.line += value;
+    this.rl.cursor += value.length;
+    this.render(isValid);
+  }
+
+  /**
+   * When user press a key
+   */
+
+  onKeypress() {
+    this.status = 'touched';
+
+    this.render();
+  }
+}

package/node_modules/inquirer/lib/prompts/list.js

@@ -0,0 +1,202 @@
+/**
+ * `list` type prompt
+ */
+
+import ansiEscapes from 'ansi-escapes';
+import colors from 'yoctocolors-cjs';
+import figures from '@inquirer/figures';
+import runAsync from 'run-async';
+import { flatMap, map, take, takeUntil } from 'rxjs';
+import observe from '../utils/events.js';
+import Paginator from '../utils/paginator.js';
+import incrementListIndex from '../utils/incrementListIndex.js';
+import Base from './base.js';
+
+export default class ListPrompt extends Base {
+  constructor(questions, rl, answers) {
+    super(questions, rl, answers);
+
+    if (!this.opt.choices) {
+      this.throwParamError('choices');
+    }
+
+    this.firstRender = true;
+    this.selected = 0;
+
+    const def = this.opt.default;
+
+    // If def is a Number, then use as index. Otherwise, check for value.
+    if (typeof def === 'number' && def >= 0 && def < this.opt.choices.realLength) {
+      this.selected = def;
+    } else if (typeof def !== 'number' && def != null) {
+      const index = this.opt.choices.realChoices.findIndex(({ value }) => value === def);
+      this.selected = Math.max(index, 0);
+    }
+
+    // Make sure no default is set (so it won't be printed)
+    this.opt.default = null;
+
+    const shouldLoop = this.opt.loop === undefined ? true : this.opt.loop;
+    this.paginator = new Paginator(this.screen, { isInfinite: shouldLoop });
+  }
+
+  /**
+   * Start the Inquiry session
+   * @param  {Function} cb      Callback when prompt is done
+   * @return {this}
+   */
+
+  _run(cb) {
+    this.done = cb;
+
+    const events = observe(this.rl);
+    events.normalizedUpKey.pipe(takeUntil(events.line)).forEach(this.onUpKey.bind(this));
+    events.normalizedDownKey
+      .pipe(takeUntil(events.line))
+      .forEach(this.onDownKey.bind(this));
+    events.numberKey.pipe(takeUntil(events.line)).forEach(this.onNumberKey.bind(this));
+    events.line
+      .pipe(
+        take(1),
+        map(this.getCurrentValue.bind(this)),
+        flatMap((value) =>
+          runAsync(this.opt.filter)(value, this.answers).catch((error) => error),
+        ),
+      )
+      .forEach(this.onSubmit.bind(this));
+
+    // Init the prompt
+    this.render();
+
+    return this;
+  }
+
+  /**
+   * Render the prompt to screen
+   * @return {ListPrompt} self
+   */
+
+  render() {
+    // Render question
+    let message = this.getQuestion();
+
+    if (this.firstRender) {
+      message += colors.dim('(Use arrow keys)');
+    }
+
+    // Render choices or answer depending on the state
+    if (this.status === 'answered') {
+      message += colors.cyan(this.opt.choices.getChoice(this.selected).short);
+    } else {
+      const choicesStr = listRender(this.opt.choices, this.selected);
+      const indexPosition = this.opt.choices.indexOf(
+        this.opt.choices.getChoice(this.selected),
+      );
+      const realIndexPosition =
+        this.opt.choices.reduce((acc, value, i) => {
+          // Dont count lines past the choice we are looking at
+          if (i > indexPosition) {
+            return acc;
+          }
+          // Add line if it's a separator
+          if (value.type === 'separator') {
+            return acc + 1;
+          }
+
+          let l = value.name;
+          // Non-strings take up one line
+          if (typeof l !== 'string') {
+            return acc + 1;
+          }
+
+          // Calculate lines taken up by string
+          l = l.split('\n');
+          return acc + l.length;
+        }, 0) - 1;
+      message +=
+        '\n' + this.paginator.paginate(choicesStr, realIndexPosition, this.opt.pageSize);
+    }
+
+    message += ansiEscapes.cursorHide;
+    this.firstRender = false;
+
+    this.screen.render(message);
+  }
+
+  /**
+   * When user press `enter` key
+   */
+
+  onSubmit(value) {
+    this.status = 'answered';
+
+    // Rerender prompt
+    this.render();
+
+    this.screen.done();
+    this.done(value);
+  }
+
+  getCurrentValue() {
+    return this.opt.choices.getChoice(this.selected).value;
+  }
+
+  /**
+   * When user press a key
+   */
+  onUpKey() {
+    this.selected = incrementListIndex(this.selected, 'up', this.opt);
+    this.render();
+  }
+
+  onDownKey() {
+    this.selected = incrementListIndex(this.selected, 'down', this.opt);
+    this.render();
+  }
+
+  onNumberKey(input) {
+    if (input <= this.opt.choices.realLength) {
+      this.selected = input - 1;
+    }
+
+    this.render();
+  }
+}
+
+/**
+ * Function for rendering list choices
+ * @param  {Number} pointer Position of the pointer
+ * @return {String}         Rendered content
+ */
+function listRender(choices, pointer) {
+  let output = '';
+  let separatorOffset = 0;
+
+  choices.forEach((choice, i) => {
+    if (choice.type === 'separator') {
+      separatorOffset++;
+      output += '  ' + choice + '\n';
+      return;
+    }
+
+    if (choice.disabled) {
+      separatorOffset++;
+      output += '  - ' + choice.name;
+      output += ` (${
+        typeof choice.disabled === 'string' ? choice.disabled : 'Disabled'
+      })`;
+      output += '\n';
+      return;
+    }
+
+    const isSelected = i - separatorOffset === pointer;
+    let line = (isSelected ? figures.pointer + ' ' : '  ') + choice.name;
+    if (isSelected) {
+      line = colors.cyan(line);
+    }
+
+    output += line + ' \n';
+  });
+
+  return output.replaceAll(/\n$/g, '');
+}

package/node_modules/inquirer/lib/prompts/number.js

@@ -0,0 +1,26 @@
+/**
+ * `input` type prompt
+ */
+
+import Input from './input.js';
+
+/**
+ * Extention of the Input prompt specifically for use with number inputs.
+ */
+
+export default class NumberPrompt extends Input {
+  filterInput(input) {
+    if (input && typeof input === 'string') {
+      input = input.trim();
+      // Match a number in the input
+      const numberMatch = input.match(/(^-?\d+|^-?\d+\.\d*|^\d*\.\d+)(e\d+)?$/);
+      // If a number is found, return that input.
+      if (numberMatch) {
+        return Number(numberMatch[0]);
+      }
+    }
+
+    // If the input was invalid return the default value.
+    return this.opt.default == null ? Number.NaN : this.opt.default;
+  }
+}