[a11y] Copy third_party/accessibility

Author: swift-kim

flutter/third_party/accessibility/BUILD.gn

@@ -0,0 +1,125 @@
+# Copyright 2013 The Flutter Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+import("//flutter/common/config.gni")
+import("//flutter/testing/testing.gni")
+
+config("accessibility_config") {
+  visibility = [
+    "//flutter/shell/platform/common:common_cpp_accessibility",
+    "//flutter/third_party/accessibility/*",
+  ]
+  if (is_win) {
+    # TODO(cbracken): https://github.com/flutter/flutter/issues/92229
+    defines = [ "_SILENCE_CXX17_ITERATOR_BASE_CLASS_DEPRECATION_WARNING" ]
+  }
+  include_dirs = [ "//flutter/third_party/accessibility" ]
+  if (is_linux) {
+    include_dirs += [
+      "$custom_sysroot/usr/include/atk-1.0",
+      "$custom_sysroot/usr/include/at-spi2-atk/2.0",
+      "$custom_sysroot/usr/include/glib-2.0",
+    ]
+
+    if (target_cpu == "arm64") {
+      include_dirs += [ "$custom_sysroot/usr/lib64/glib-2.0/include" ]
+    } else {
+      include_dirs += [ "$custom_sysroot/usr/lib/glib-2.0/include" ]
+    }
+  }
+}
+
+source_set("accessibility") {
+  defines = []
+
+  public_deps = [
+    "ax",
+    "ax_build",
+    "base",
+    "gfx",
+  ]
+
+  public_configs = [ ":accessibility_config" ]
+
+  if (is_mac) {
+    frameworks = [
+      "AppKit.framework",
+      "CoreFoundation.framework",
+      "CoreGraphics.framework",
+      "CoreText.framework",
+      "IOSurface.framework",
+    ]
+  }
+}
+
+if (enable_unittests) {
+  test_fixtures("accessibility_fixtures") {
+    fixtures = []
+  }
+
+  executable("accessibility_unittests") {
+    testonly = true
+
+    public_configs = [ ":accessibility_config" ]
+
+    if (is_mac || is_win) {
+      sources = [
+        "ax/ax_enum_util_unittest.cc",
+        "ax/ax_event_generator_unittest.cc",
+        "ax/ax_node_data_unittest.cc",
+        "ax/ax_node_position_unittest.cc",
+        "ax/ax_range_unittest.cc",
+        "ax/ax_role_properties_unittest.cc",
+        "ax/ax_table_info_unittest.cc",
+        "ax/ax_tree_unittest.cc",
+        "ax/test_ax_node_helper.cc",
+        "ax/test_ax_node_helper.h",
+        "ax/test_ax_tree_manager.cc",
+        "ax/test_ax_tree_manager.h",
+      ]
+
+      sources += [
+        "ax/platform/ax_platform_node_base_unittest.cc",
+        "ax/platform/ax_platform_node_unittest.cc",
+        "ax/platform/ax_platform_node_unittest.h",
+        "ax/platform/ax_unique_id_unittest.cc",
+        "ax/platform/test_ax_node_wrapper.cc",
+        "ax/platform/test_ax_node_wrapper.h",
+      ]
+
+      if (is_win) {
+        sources += [
+          "ax/platform/ax_fragment_root_win_unittest.cc",
+          "ax/platform/ax_platform_node_win_unittest.cc",
+          "base/win/dispatch_stub.cc",
+          "base/win/dispatch_stub.h",
+          "base/win/display_unittest.cc",
+          "base/win/scoped_bstr_unittest.cc",
+          "base/win/scoped_safearray_unittest.cc",
+          "base/win/scoped_variant_unittest.cc",
+        ]
+      }
+
+      sources += [
+        "base/logging_unittests.cc",
+        "base/string_utils_unittest.cc",
+        "gfx/geometry/insets_unittest.cc",
+        "gfx/geometry/point_unittest.cc",
+        "gfx/geometry/rect_unittest.cc",
+        "gfx/geometry/size_unittest.cc",
+        "gfx/geometry/vector2d_unittest.cc",
+        "gfx/range/range_unittest.cc",
+        "gfx/test/gfx_util.cc",
+        "gfx/test/gfx_util.h",
+      ]
+
+      deps = [
+        ":accessibility",
+        ":accessibility_fixtures",
+        "//flutter/testing",
+        "//flutter/testing:dart",
+      ]
+    }
+  }
+}

flutter/third_party/accessibility/README.md

@@ -0,0 +1,20 @@
+Flutter Accessibility Library
+==============
+
+This accessibility library is a fork of the [chromium](https://www.chromium.org) accessibility code at commit
+[4579d5538f06c5ef615a15bc67ebb9ac0523a973](https://chromium.googlesource.com/chromium/src/+/4579d5538f06c5ef615a15bc67ebb9ac0523a973).
+
+For the main ax code, the following parts were not imported:
+`fuzz_corpus`, `extensions` and `DEPS` files.
+
+`ax/`: https://source.chromium.org/chromium/chromium/src/+/master:ui/accessibility/
+`ax_build/`: https://source.chromium.org/chromium/chromium/src/+/master:build/
+`base/`: https://source.chromium.org/chromium/chromium/src/+/master:base/
+`gfx/`: https://source.chromium.org/chromium/chromium/src/+/master:ui/gfx/
+
+Update to this Library
+==============
+Bug fixes to the forked files in the four directories should proceed as usual.
+New features or changes that change the behaviors of these classes are discouraged.
+
+If you do need to make such change, please log the change at the end of this file.

flutter/third_party/accessibility/ax/BUILD.gn

@@ -0,0 +1,131 @@
+# Copyright 2013 The Flutter Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+import("//flutter/common/config.gni")
+
+source_set("ax") {
+  visibility = [ "//flutter/third_party/accessibility/*" ]
+  public_configs =
+      [ "//flutter/third_party/accessibility:accessibility_config" ]
+
+  configs -= [ "//build/config/compiler:no_rtti" ]
+
+  sources = [
+    "platform/ax_platform_node.cc",
+    "platform/ax_platform_node.h",
+    "platform/ax_platform_node_base.cc",
+    "platform/ax_platform_node_base.h",
+    "platform/ax_platform_node_delegate.h",
+    "platform/ax_platform_node_delegate_base.cc",
+    "platform/ax_platform_node_delegate_base.h",
+    "platform/ax_platform_text_boundary.cc",
+    "platform/ax_platform_text_boundary.h",
+    "platform/ax_unique_id.cc",
+    "platform/ax_unique_id.h",
+    "platform/compute_attributes.cc",
+    "platform/compute_attributes.h",
+  ]
+
+  sources += [
+    "ax_action_data.cc",
+    "ax_action_data.h",
+    "ax_action_handler.cc",
+    "ax_action_handler.h",
+    "ax_action_handler_base.cc",
+    "ax_action_handler_base.h",
+    "ax_active_popup.cc",
+    "ax_active_popup.h",
+    "ax_base_export.h",
+    "ax_clipping_behavior.h",
+    "ax_constants.h",
+    "ax_coordinate_system.h",
+    "ax_enum_util.cc",
+    "ax_enum_util.h",
+    "ax_enums.h",
+    "ax_event_generator.cc",
+    "ax_event_generator.h",
+    "ax_event_intent.cc",
+    "ax_event_intent.h",
+    "ax_export.h",
+    "ax_mode.cc",
+    "ax_mode.h",
+    "ax_mode_observer.h",
+    "ax_node.cc",
+    "ax_node.h",
+    "ax_node_data.cc",
+    "ax_node_data.h",
+    "ax_node_position.cc",
+    "ax_node_position.h",
+    "ax_node_text_styles.cc",
+    "ax_node_text_styles.h",
+    "ax_offscreen_result.h",
+    "ax_position.h",
+    "ax_range.h",
+    "ax_relative_bounds.cc",
+    "ax_relative_bounds.h",
+    "ax_role_properties.cc",
+    "ax_role_properties.h",
+    "ax_table_info.cc",
+    "ax_table_info.h",
+    "ax_tree.cc",
+    "ax_tree.h",
+    "ax_tree_data.cc",
+    "ax_tree_data.h",
+    "ax_tree_id.cc",
+    "ax_tree_id.h",
+    "ax_tree_id_registry.cc",
+    "ax_tree_id_registry.h",
+    "ax_tree_manager.h",
+    "ax_tree_manager_map.cc",
+    "ax_tree_manager_map.h",
+    "ax_tree_observer.cc",
+    "ax_tree_observer.h",
+    "ax_tree_update.h",
+  ]
+
+  if (is_mac) {
+    sources += [
+      "platform/ax_platform_node_mac.h",
+      "platform/ax_platform_node_mac.mm",
+    ]
+  } else if (is_win) {
+    sources += [
+      "platform/ax_fragment_root_delegate_win.h",
+      "platform/ax_fragment_root_win.cc",
+      "platform/ax_fragment_root_win.h",
+      "platform/ax_platform_node_delegate_utils_win.cc",
+      "platform/ax_platform_node_delegate_utils_win.h",
+      "platform/ax_platform_node_win.cc",
+      "platform/ax_platform_node_win.h",
+      "platform/uia_registrar_win.cc",
+      "platform/uia_registrar_win.h",
+    ]
+    libs = [
+      "oleacc.lib",
+      "uiautomationcore.lib",
+    ]
+  } else if (is_linux) {
+    sources += [
+      "platform/atk_util_auralinux.cc",
+      "platform/atk_util_auralinux.h",
+      "platform/atk_util_auralinux_gtk.cc",
+      "platform/ax_platform_atk_hyperlink.cc",
+      "platform/ax_platform_atk_hyperlink.h",
+      "platform/ax_platform_node_auralinux.cc",
+      "platform/ax_platform_node_auralinux.h",
+    ]
+    libs = [
+      "atk-1.0",
+      "atk-bridge-2.0",
+      "glib-2.0",
+      "gobject-2.0",
+    ]
+  }
+
+  public_deps = [
+    "//flutter/third_party/accessibility/ax_build",
+    "//flutter/third_party/accessibility/base",
+    "//flutter/third_party/accessibility/gfx",
+  ]
+}

flutter/third_party/accessibility/ax/ax_action_data.cc

@@ -0,0 +1,21 @@
+// Copyright 2016 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#include "ax_action_data.h"
+
+#include "ax_enums.h"
+
+namespace ui {
+
+AXActionData::AXActionData()
+    : action(ax::mojom::Action::kNone),
+      hit_test_event_to_fire(ax::mojom::Event::kNone),
+      horizontal_scroll_alignment(ax::mojom::ScrollAlignment::kNone),
+      vertical_scroll_alignment(ax::mojom::ScrollAlignment::kNone),
+      scroll_behavior(ax::mojom::ScrollBehavior::kNone) {}
+
+AXActionData::AXActionData(const AXActionData& other) = default;
+AXActionData::~AXActionData() = default;
+
+}  // namespace ui

flutter/third_party/accessibility/ax/ax_action_data.h

@@ -0,0 +1,88 @@
+// Copyright 2016 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef UI_ACCESSIBILITY_AX_ACTION_DATA_H_
+#define UI_ACCESSIBILITY_AX_ACTION_DATA_H_
+
+#include "ax_enums.h"
+#include "ax_export.h"
+#include "ax_tree_id.h"
+#include "gfx/geometry/point.h"
+#include "gfx/geometry/rect.h"
+
+namespace ui {
+
+// A compact representation of an accessibility action and the arguments
+// associated with that action.
+struct AX_EXPORT AXActionData {
+  AXActionData();
+  AXActionData(const AXActionData& other);
+  ~AXActionData();
+
+  // This is a simple serializable struct. All member variables should be
+  // public and copyable.
+
+  // See the ax::mojom::Action enums in ax_enums.mojom for explanations of which
+  // parameters apply.
+
+  // The action to take.
+  ax::mojom::Action action;
+
+  // The ID of the tree that this action should be performed on.
+  ui::AXTreeID target_tree_id = ui::AXTreeIDUnknown();
+
+  // The source extension id (if any) of this action.
+  std::string source_extension_id;
+
+  // The ID of the node that this action should be performed on.
+  int target_node_id = -1;
+
+  // The request id of this action tracked by the client.
+  int request_id = -1;
+
+  // Use enums from ax::mojom::ActionFlags
+  int flags = 0;
+
+  // For an action that creates a selection, the selection anchor and focus
+  // (see ax_tree_data.h for definitions).
+  int anchor_node_id = -1;
+  int anchor_offset = -1;
+
+  int focus_node_id = -1;
+  int focus_offset = -1;
+
+  // Start index of the text which should be queried for.
+  int32_t start_index = -1;
+
+  // End index of the text which should be queried for.
+  int32_t end_index = -1;
+
+  // For custom action.
+  int custom_action_id = -1;
+
+  // The target rect for the action.
+  gfx::Rect target_rect;
+
+  // The target point for the action.
+  gfx::Point target_point;
+
+  // The new value for a node, for the SET_VALUE action. UTF-8 encoded.
+  std::string value;
+
+  // The event to fire in response to a HIT_TEST action.
+  ax::mojom::Event hit_test_event_to_fire;
+
+  // The scroll alignment to use for a SCROLL_TO_MAKE_VISIBLE action. The
+  // scroll alignment controls where a node is scrolled within the viewport.
+  ax::mojom::ScrollAlignment horizontal_scroll_alignment;
+  ax::mojom::ScrollAlignment vertical_scroll_alignment;
+
+  // The behavior to use for a SCROLL_TO_MAKE_VISIBLE. This controls whether or
+  // not the viewport is scrolled when the node is already visible.
+  ax::mojom::ScrollBehavior scroll_behavior;
+};
+
+}  // namespace ui
+
+#endif  // UI_ACCESSIBILITY_AX_ACTION_DATA_H_