help() — tailwindcss Function Reference

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

Function typescript UpgradeToolkit TemplateAnalysis calls 5

Entity Profile

UpgradeToolkit→ TemplateAnalysis→ help() — tailwindcss Function Reference

Dependency Diagram

graph TD
  b6b270fc_e10a_fdad_5886_38f731667d67["help()"]
  c2db3112_cd69_dad3_1ec1_c1fb9b72a560["index.ts"]
  b6b270fc_e10a_fdad_5886_38f731667d67 -->|defined in| c2db3112_cd69_dad3_1ec1_c1fb9b72a560
  29800e0d_041f_9aaf_e641_3569e35221f6["println()"]
  b6b270fc_e10a_fdad_5886_38f731667d67 -->|calls| 29800e0d_041f_9aaf_e641_3569e35221f6
  19af1556_b46b_c92f_5197_2a29af9d42a2["header()"]
  b6b270fc_e10a_fdad_5886_38f731667d67 -->|calls| 19af1556_b46b_c92f_5197_2a29af9d42a2
  fc3d860f_324c_425a_d170_9245800aea98["wordWrap()"]
  b6b270fc_e10a_fdad_5886_38f731667d67 -->|calls| fc3d860f_324c_425a_d170_9245800aea98
  9383215e_0eb6_1914_b650_236ad8ecef8e["indent()"]
  b6b270fc_e10a_fdad_5886_38f731667d67 -->|calls| 9383215e_0eb6_1914_b650_236ad8ecef8e
  a81de696_6bb5_40db_26ca_1d707ccebed9["highlight()"]
  b6b270fc_e10a_fdad_5886_38f731667d67 -->|calls| a81de696_6bb5_40db_26ca_1d707ccebed9
  style b6b270fc_e10a_fdad_5886_38f731667d67 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...]