help() — tailwindcss Function Reference

Architecture documentation for the help() function in index.ts from the tailwindcss codebase.

Function typescript CommandLineInterface Renderer calls 5

Entity Profile

CommandLineInterface→ Renderer→ help() — tailwindcss Function Reference

Dependency Diagram

graph TD
  b1bbf167_50da_cc65_0ade_524a7e4023cb["help()"]
  e757210f_6e73_5a13_a52e_f9675256ec53["index.ts"]
  b1bbf167_50da_cc65_0ade_524a7e4023cb -->|defined in| e757210f_6e73_5a13_a52e_f9675256ec53
  cba5c7c8_f044_d5aa_baf9_2a68fd6d7294["println()"]
  b1bbf167_50da_cc65_0ade_524a7e4023cb -->|calls| cba5c7c8_f044_d5aa_baf9_2a68fd6d7294
  d51344bd_5caa_9aed_19fd_55a5425e524b["header()"]
  b1bbf167_50da_cc65_0ade_524a7e4023cb -->|calls| d51344bd_5caa_9aed_19fd_55a5425e524b
  c31510dc_31ef_7448_58a7_0d6f18e31e8d["wordWrap()"]
  b1bbf167_50da_cc65_0ade_524a7e4023cb -->|calls| c31510dc_31ef_7448_58a7_0d6f18e31e8d
  bc8f7bac_f1dc_50a4_9353_2ff3d403d524["indent()"]
  b1bbf167_50da_cc65_0ade_524a7e4023cb -->|calls| bc8f7bac_f1dc_50a4_9353_2ff3d403d524
  d3ccc5ce_e370_63df_a97d_a2f004fd83ca["highlight()"]
  b1bbf167_50da_cc65_0ade_524a7e4023cb -->|calls| d3ccc5ce_e370_63df_a97d_a2f004fd83ca
  style b1bbf167_50da_cc65_0ade_524a7e4023cb fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/@tailwindcss-upgrade/src/commands/help/index.ts lines 5–170

export function help({
  invalid,
  usage,
  options,
}: {
  invalid?: string
  usage?: string[]
  options?: Arg
}) {
  // Available terminal width
  let width = process.stdout.columns

  // Render header
  println(header())

  // Render the invalid command
  if (invalid) {
    println()
    println(`${pc.dim('Invalid command:')} ${invalid}`)
  }

  // Render usage
  if (usage && usage.length > 0) {
    println()
    println(pc.dim('Usage:'))
    for (let [idx, example] of usage.entries()) {
      // Split the usage example into the command and its options. This allows
      // us to wrap the options based on the available width of the terminal.
      let command = example.slice(0, example.indexOf('['))
      let options = example.slice(example.indexOf('['))

      // Make the options dimmed, to make them stand out less than the command
      // itself.
      options = options.replace(/\[.*?\]/g, (option) => pc.dim(option))

      // The space between the command and the options.
      let space = 1

      // Wrap the options based on the available width of the terminal.
      let lines = wordWrap(options, width - UI.indent - command.length - space)

      // Print an empty line between the usage examples if we need to split due
      // to width constraints. This ensures that the usage examples are visually
      // separated.
      //
      // E.g.: when enough space is available
      //
      // ```
      //   Usage:
      //     tailwindcss build [--input input.css] [--output output.css] [--watch] [options...]
      //     tailwindcss other [--watch] [options...]
      // ```
      //
      // E.g.: when not enough space is available
      //
      // ```
      //   Usage:
      //     tailwindcss build [--input input.css] [--output output.css]
      //                       [--watch] [options...]
      //
      //     tailwindcss other [--watch] [options...]
      // ```
      if (lines.length > 1 && idx !== 0) {
        println()
      }

      // Print the usage examples based on available width of the terminal.
      //
      // E.g.: when enough space is available
      //
      // ```
      //   Usage:
      //     tailwindcss [--input input.css] [--output output.css] [--watch] [options...]
      // ```
      //
      // E.g.: when not enough space is available
      //
      // ```
      //   Usage:
      //     tailwindcss [--input input.css] [--output output.css]
      //                 [--watch] [options...]