[APC] Document/test actor hit-test coordinate spaces

APC geometry and actor tool targets use different coordinate spaces.
This CL documents the contract and adds coverage to prevent HiDPI
TOCTOU mismatches.

Viewport terminology:
- Layout viewport: viewport used for layout/scrolling.
- Visual viewport: what the user actually sees; can be offset from the
  layout viewport (e.g. when the mobile toolbar shows/hides during
  scrolling, or during pinch-zoom).

Pixel terminology:
- DIPs: device-independent pixels, aka CSS/logical pixels used
  by layout/JS APIs like getBoundingClientRect(). Example:
  DSF=2 means (1,1) DIP corresponds to (2,2) device pixels.
- Blink space: device pixels in the local root; sometimes
  referred to as "Blink pixels" in variable names.

Who uses what:
- APC node geometry (AIPageContentGeometry.*_bounding_box) is expressed
  in the local root's Blink space in visual-viewport coordinates.
- Tool coordinate targets (actor.mojom.ToolTarget.coordinate_dip) are
  expressed in DIPs in the local root's layout-viewport coordinates.
  DOM getBoundingClientRect() also uses CSS pixels (DIPs).

Callers comparing a DIP coordinate to APC geometry must convert from
layout-viewport DIPs to visual-viewport Blink space (e.g. apply the
appropriate device scale factor and any layout-vs-visual viewport
offset).

This clarifies expectations across actor tooling, optimization_guide
hit testing, and Blink APC geometry docs, and adds a regression test to
catch future coordinate-space mixups that can cause TOCTOU failures
(e.g. kObservedTargetElementChanged).

Bug: 464034559

Change-Id: I4c68bf4f02b13730f56a7667482948cfd9484aeb
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/7510297
Reviewed-by: Abigail Klein <abigailbklein@google.com>
Commit-Queue: Aaron Leventhal <aleventhal@google.com>
Reviewed-by: David Bokan <bokan@chromium.org>
Reviewed-by: Giovanni Ortuno Urquidi <ortuno@chromium.org>
Cr-Commit-Position: refs/heads/main@{#1584293}
11 files changed
tree: 6f057497bc39c033252619c68090b11b0e42d1ac
  1. .claude/
  2. .gemini/
  3. .github/
  4. agents/
  5. android_webview/
  6. apps/
  7. ash/
  8. base/
  9. build/
  10. build_overrides/
  11. buildtools/
  12. cc/
  13. chrome/
  14. chromecast/
  15. chromeos/
  16. codelabs/
  17. components/
  18. content/
  19. crypto/
  20. dbus/
  21. device/
  22. docs/
  23. extensions/
  24. fuchsia_web/
  25. gin/
  26. google_apis/
  27. gpu/
  28. headless/
  29. infra/
  30. ios/
  31. ipc/
  32. media/
  33. mojo/
  34. net/
  35. pdf/
  36. printing/
  37. remoting/
  38. rlz/
  39. sandbox/
  40. services/
  41. skia/
  42. sql/
  43. storage/
  44. styleguide/
  45. testing/
  46. third_party/
  47. tools/
  48. ui/
  49. url/
  50. webkit/
  51. .clang-format
  52. .clang-tidy
  53. .clangd
  54. .cursorignore
  55. .geminiignore
  56. .git-blame-ignore-revs
  57. .gitallowed
  58. .gitattributes
  59. .gitignore
  60. .gitmodules
  61. .gn
  62. .mailmap
  63. .rustfmt.toml
  64. .vpython3
  65. .yapfignore
  66. ATL_OWNERS
  67. AUTHORS
  68. BUILD.gn
  69. CODE_OF_CONDUCT.md
  70. codereview.settings
  71. CPPLINT.cfg
  72. CRYPTO_OWNERS
  73. DEPS
  74. DIR_METADATA
  75. LICENSE
  76. LICENSE.chromium_os
  77. OWNERS
  78. package.json
  79. PRESUBMIT.py
  80. PRESUBMIT_test.py
  81. PRESUBMIT_test_mocks.py
  82. README.md
  83. SECURITY_OWNERS
  84. WATCHLISTS
README.md

Logo Chromium

Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all users to experience the web.

The project's web site is https://www.chromium.org.

To check out the source code locally, don't use git clone! Instead, follow the instructions on how to get the code.

Documentation in the source is rooted in docs/README.md.

Learn how to Get Around the Chromium Source Code Directory Structure.

For historical reasons, there are some small top level directories. Now the guidance is that new top level directories are for product (e.g. Chrome, Android WebView, Ash). Even if these products have multiple executables, the code should be in subdirectories of the product.

If you found a bug, please file it at https://crbug.com/new.