Function buildOptionEntries

scripts/docs/src/generate-cli-docs.ts:306–335

({
  options,
  commandPath,
  depth,
}: BuildOptionEntriesArgs)

};

function buildOptionEntries({
  options,
  commandPath,
  depth,
}: BuildOptionEntriesArgs): Content[] {
  const nodes: Content[] = [];
  const headingDepth = Math.min(depth + 1, 6);

  options.forEach((option) => {
    const signature = formatOptionSignature(option);
    nodes.push(createHeading(headingDepth, [createInlineCode(signature)]));

    nodes.push({
      type: "code",
      lang: "bash",
      value: buildOptionUsage(commandPath, option),
    });

    if (option.description) {
      nodes.push(createParagraph(option.description));
    }

    const details = buildOptionDetails(option);
    if (details.length > 0) {
      nodes.push(createParagraph(details.join(" ")));
    }
  });

  return nodes;
}

function buildArgumentListItems(args: readonly Argument[]): ListItem[] {
  return args.map((arg) => {