Function getPathCompletion

cli/src/utils/path-completion.ts:17–111

(inputPath: string)

 * - Hidden directories are skipped unless user typed a dot
 */
export function getPathCompletion(inputPath: string): string | null {
  if (!inputPath) return null

  // Expand ~ to home directory
  let expandedPath = inputPath
  const homeDir = os.homedir()
  if (expandedPath.startsWith('~')) {
    expandedPath = path.join(homeDir, expandedPath.slice(1))
  }

  // If the path ends with /, we're completing inside that directory
  // Otherwise, we're completing the last component
  let parentDir: string
  let partial: string

  if (expandedPath.endsWith(path.sep)) {
    parentDir = expandedPath
    partial = ''
  } else {
    parentDir = path.dirname(expandedPath)
    partial = path.basename(expandedPath).toLowerCase()
  }

  // Check if parent directory exists
  try {
    if (!existsSync(parentDir) || !statSync(parentDir).isDirectory()) {
      return null
    }
  } catch {
    return null
  }

  // List directories in parent that match the partial
  try {
    const items = readdirSync(parentDir)
    const matches: string[] = []

    for (const item of items) {
      // Skip hidden files unless user typed a dot
      if (item.startsWith('.') && !partial.startsWith('.')) continue

      const fullPath = path.join(parentDir, item)
      try {
        if (!statSync(fullPath).isDirectory()) continue
      } catch {
        continue
      }

      if (item.toLowerCase().startsWith(partial)) {
        matches.push(item)
      }
    }

    if (matches.length === 0) return null

    // If exactly one match, complete to it with trailing slash
    if (matches.length === 1) {
      let completed = path.join(parentDir, matches[0]) + path.sep