Function getZshCompletions

packages/cli/src/internal/options.ts:2164–2219

(
  self: Instruction,
  state: ZshCompletionState = { conflicts: Arr.empty(), multiple: false }
)

/** @internal */
export const getZshCompletions = (
  self: Instruction,
  state: ZshCompletionState = { conflicts: Arr.empty(), multiple: false }
): Array<string> => {
  switch (self._tag) {
    case "Empty": {
      return Arr.empty()
    }
    case "Single": {
      const names = getNames(self)
      const description = getShortDescription(self)
      const possibleValues = InternalPrimitive.getZshCompletions(
        self.primitiveType as InternalPrimitive.Instruction
      )
      const multiple = state.multiple ? "*" : ""
      const conflicts = Arr.isNonEmptyReadonlyArray(state.conflicts)
        ? `(${Arr.join(state.conflicts, " ")})`
        : ""
      return Arr.map(
        names,
        (name) => `${conflicts}${multiple}${name}[${escape(description)}]${possibleValues}`
      )
    }
    case "KeyValueMap": {
      return getZshCompletions(self.argumentOption as Instruction, { ...state, multiple: true })
    }
    case "Map":
    case "WithDefault":
    case "WithFallback": {
      return getZshCompletions(self.options as Instruction, state)
    }
    case "Both": {
      const left = getZshCompletions(self.left as Instruction, state)
      const right = getZshCompletions(self.right as Instruction, state)
      return Arr.appendAll(left, right)
    }
    case "OrElse": {
      const leftNames = getNames(self.left as Instruction)
      const rightNames = getNames(self.right as Instruction)
      const left = getZshCompletions(
        self.left as Instruction,
        { ...state, conflicts: Arr.appendAll(state.conflicts, rightNames) }
      )
      const right = getZshCompletions(
        self.right as Instruction,
        { ...state, conflicts: Arr.appendAll(state.conflicts, leftNames) }
      )
      return Arr.appendAll(left, right)
    }
    case "Variadic": {
      return Option.isSome(self.max) && self.max.value > 1
        ? getZshCompletions(self.argumentOption as Instruction, { ...state, multiple: true })
        : getZshCompletions(self.argumentOption as Instruction, state)
    }
  }
}