chrome/browser/ui/startup/focus/focus_handler.h

// Copyright 2025 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROME_BROWSER_UI_STARTUP_FOCUS_FOCUS_HANDLER_H_
#define CHROME_BROWSER_UI_STARTUP_FOCUS_FOCUS_HANDLER_H_

#include <optional>
#include <string>
#include <vector>

#include "base/time/time.h"
#include "chrome/browser/ui/startup/focus/match_candidate.h"
#include "chrome/browser/ui/startup/focus/selector.h"

class Profile;

namespace base {
class CommandLine;
}  // namespace base

namespace focus {

enum class FocusStatus {
  kFocused,     // Successfully focused an existing tab/window
  kNoMatch,     // No matching tab/window found for the selectors
  kParseError,  // Failed to parse the selector string
};

struct FocusResult {
  enum class Error {
    kNone,           // No error occurred
    kEmptySelector,  // Selector string was empty
    kInvalidFormat,  // Selector format was invalid
  };

  explicit FocusResult(FocusStatus status);
  FocusResult(FocusStatus status,
              const std::string& matched_selector,
              const std::string& matched_url);
  FocusResult(FocusStatus status, Error error_type);
  FocusResult(const FocusResult& other);
  FocusResult(FocusResult&& other) noexcept;
  FocusResult& operator=(const FocusResult& other);
  FocusResult& operator=(FocusResult&& other) noexcept;
  ~FocusResult();

  bool IsSuccess() const;
  bool HasMatch() const;

  FocusStatus status;
  std::optional<std::string> matched_selector;
  std::optional<std::string> matched_url;
  Error error_type;
};

// Converts FocusResult to appropriate exit code for command line usage.
int FocusResultToExitCode(const FocusResult& result);

// Converts FocusResult to a human-readable string representation.
std::string FocusResultToString(const FocusResult& result);

// Main entry point for processing focus requests from command line arguments.
FocusResult ProcessFocusRequest(const base::CommandLine& command_line,
                                Profile& profile);

}  // namespace focus

#endif  // CHROME_BROWSER_UI_STARTUP_FOCUS_FOCUS_HANDLER_H_