@selenium/atoms 4.52.0 → 4.53.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/README.md +56 -0
  2. package/dist/index.d.ts +4 -0
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +2 -0
  5. package/dist/index.js.map +1 -1
  6. package/dist/typescript/accessibility-snapshot-wire.d.ts +4 -0
  7. package/dist/typescript/accessibility-snapshot-wire.d.ts.map +1 -0
  8. package/dist/typescript/accessibility-snapshot-wire.js +18 -0
  9. package/dist/typescript/accessibility-snapshot-wire.js.map +1 -0
  10. package/dist/typescript/accessibility-snapshot.d.ts +3 -0
  11. package/dist/typescript/accessibility-snapshot.d.ts.map +1 -0
  12. package/dist/typescript/accessibility-snapshot.js +18 -0
  13. package/dist/typescript/accessibility-snapshot.js.map +1 -0
  14. package/dist/typescript/core/accessibility/accname.d.ts +6 -0
  15. package/dist/typescript/core/accessibility/accname.d.ts.map +1 -0
  16. package/dist/typescript/core/accessibility/accname.js +537 -0
  17. package/dist/typescript/core/accessibility/accname.js.map +1 -0
  18. package/dist/typescript/core/accessibility/context.d.ts +43 -0
  19. package/dist/typescript/core/accessibility/context.d.ts.map +1 -0
  20. package/dist/typescript/core/accessibility/context.js +49 -0
  21. package/dist/typescript/core/accessibility/context.js.map +1 -0
  22. package/dist/typescript/core/accessibility/hidden.d.ts +39 -0
  23. package/dist/typescript/core/accessibility/hidden.d.ts.map +1 -0
  24. package/dist/typescript/core/accessibility/hidden.js +216 -0
  25. package/dist/typescript/core/accessibility/hidden.js.map +1 -0
  26. package/dist/typescript/core/accessibility/roles.d.ts +28 -0
  27. package/dist/typescript/core/accessibility/roles.d.ts.map +1 -0
  28. package/dist/typescript/core/accessibility/roles.js +381 -0
  29. package/dist/typescript/core/accessibility/roles.js.map +1 -0
  30. package/dist/typescript/core/accessibility/snapshot.d.ts +13 -0
  31. package/dist/typescript/core/accessibility/snapshot.d.ts.map +1 -0
  32. package/dist/typescript/core/accessibility/snapshot.js +55 -0
  33. package/dist/typescript/core/accessibility/snapshot.js.map +1 -0
  34. package/dist/typescript/core/accessibility/states.d.ts +18 -0
  35. package/dist/typescript/core/accessibility/states.d.ts.map +1 -0
  36. package/dist/typescript/core/accessibility/states.js +215 -0
  37. package/dist/typescript/core/accessibility/states.js.map +1 -0
  38. package/dist/typescript/core/accessibility/tree.d.ts +10 -0
  39. package/dist/typescript/core/accessibility/tree.d.ts.map +1 -0
  40. package/dist/typescript/core/accessibility/tree.js +261 -0
  41. package/dist/typescript/core/accessibility/tree.js.map +1 -0
  42. package/dist/typescript/core/accessibility/types.d.ts +30 -0
  43. package/dist/typescript/core/accessibility/types.d.ts.map +1 -0
  44. package/dist/typescript/core/accessibility/types.js +18 -0
  45. package/dist/typescript/core/accessibility/types.js.map +1 -0
  46. package/dist/typescript/core/accessibility/value.d.ts +4 -0
  47. package/dist/typescript/core/accessibility/value.d.ts.map +1 -0
  48. package/dist/typescript/core/accessibility/value.js +83 -0
  49. package/dist/typescript/core/accessibility/value.js.map +1 -0
  50. package/dist/typescript/core/accessibility/wire.d.ts +57 -0
  51. package/dist/typescript/core/accessibility/wire.d.ts.map +1 -0
  52. package/dist/typescript/core/accessibility/wire.js +72 -0
  53. package/dist/typescript/core/accessibility/wire.js.map +1 -0
  54. package/index.ts +4 -0
  55. package/package.json +15 -1
  56. package/typescript/accessibility-snapshot-wire.ts +20 -0
  57. package/typescript/accessibility-snapshot.ts +21 -0
  58. package/typescript/core/accessibility/accname.ts +587 -0
  59. package/typescript/core/accessibility/context.ts +116 -0
  60. package/typescript/core/accessibility/hidden.ts +242 -0
  61. package/typescript/core/accessibility/roles.ts +410 -0
  62. package/typescript/core/accessibility/snapshot.ts +61 -0
  63. package/typescript/core/accessibility/states.ts +233 -0
  64. package/typescript/core/accessibility/tree.ts +306 -0
  65. package/typescript/core/accessibility/types.ts +52 -0
  66. package/typescript/core/accessibility/value.ts +89 -0
  67. package/typescript/core/accessibility/wire.ts +123 -0
@@ -0,0 +1,215 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+ import { isEnabled } from '../enabled.js';
18
+ import { canTakeFocus } from './roles.js';
19
+ import { embeddedValue } from './value.js';
20
+ // The `states` map and `value` field of ADR 18205 §2. Which keys appear:
21
+ //
22
+ // checked whenever the role supports it; "mixed" where the role allows it
23
+ // pressed when the element sets aria-pressed: a button without it is not
24
+ // a toggle button, so reporting pressed=false would mislead
25
+ // expanded when the element sets aria-expanded, and on a summary from its
26
+ // details' open state
27
+ // selected always for option, tab and treeitem, where selection is part of
28
+ // the role; for gridcell, row and headers only when the element
29
+ // sets aria-selected, since most grids are not selectable
30
+ // level always for headings (tag, aria-level, or ARIA's default of 2);
31
+ // elsewhere when the element sets aria-level
32
+ // disabled true only when disabled, natively or through aria-disabled on
33
+ // the element, or on an ancestor when the element can take focus
34
+ // (WAI-ARIA 1.2: the state reaches focusable descendants)
35
+ // focused true only on the focused element
36
+ //
37
+ // For pressed, expanded and the grid parts' selected, "undefined" and an
38
+ // empty value mean the attribute is not set: ARIA defines undefined as "not
39
+ // a toggle", "not expandable", "not selectable".
40
+ //
41
+ // Adding a key is additive under the ADR's compatibility rule; the states
42
+ // page pins the current set.
43
+ const CHECKED_ROLES = new Set(['checkbox', 'menuitemcheckbox', 'menuitemradio', 'radio', 'switch']);
44
+ const MIXED_ALLOWED = new Set(['checkbox', 'menuitemcheckbox']);
45
+ const ALWAYS_SELECTED_ROLES = new Set(['option', 'tab', 'treeitem']);
46
+ const SELECTABLE_ROLES = new Set(['columnheader', 'gridcell', 'row', 'rowheader']);
47
+ const LEVEL_ROLES = new Set(['comment', 'listitem', 'row', 'tablist', 'treeitem']);
48
+ const VALUE_ROLES = new Set([
49
+ 'combobox', 'meter', 'progressbar', 'scrollbar', 'searchbox', 'slider', 'spinbutton', 'textbox',
50
+ ]);
51
+ // The elements core/enabled.ts can report as disabled; for anything else it
52
+ // answers enabled without looking, so it is not asked.
53
+ const DISABLEABLE_ELEMENTS = new Set(['button', 'input', 'optgroup', 'option', 'select', 'textarea']);
54
+ function token(element, name) {
55
+ const value = element.getAttribute(name);
56
+ return value === null ? null : value.trim().toLowerCase();
57
+ }
58
+ // A token whose "undefined" and empty values count as the attribute being absent.
59
+ function optionalToken(element, name) {
60
+ const value = token(element, name);
61
+ return value === '' || value === 'undefined' ? null : value;
62
+ }
63
+ function tristate(element, name, allowMixed) {
64
+ const value = token(element, name);
65
+ if (value === 'true') {
66
+ return true;
67
+ }
68
+ if (value === 'mixed' && allowMixed) {
69
+ return 'mixed';
70
+ }
71
+ return false;
72
+ }
73
+ function checked(element, role) {
74
+ if (element.localName === 'input') {
75
+ const input = element;
76
+ if (input.type === 'checkbox' || input.type === 'radio') {
77
+ return input.indeterminate && MIXED_ALLOWED.has(role) ? 'mixed' : input.checked;
78
+ }
79
+ }
80
+ return tristate(element, 'aria-checked', MIXED_ALLOWED.has(role));
81
+ }
82
+ function expanded(element) {
83
+ const value = optionalToken(element, 'aria-expanded');
84
+ if (value !== null) {
85
+ return value === 'true';
86
+ }
87
+ if (element.localName === 'summary') {
88
+ const details = element.parentElement;
89
+ if (details && details.localName === 'details') {
90
+ return details.hasAttribute('open');
91
+ }
92
+ }
93
+ return null;
94
+ }
95
+ function selected(element, role) {
96
+ if (element.localName === 'option' && role === 'option') {
97
+ return element.selected;
98
+ }
99
+ if (ALWAYS_SELECTED_ROLES.has(role)) {
100
+ return token(element, 'aria-selected') === 'true';
101
+ }
102
+ if (SELECTABLE_ROLES.has(role)) {
103
+ const value = optionalToken(element, 'aria-selected');
104
+ return value === null ? null : value === 'true';
105
+ }
106
+ return null;
107
+ }
108
+ function ariaLevel(element) {
109
+ const value = element.getAttribute('aria-level');
110
+ if (value === null || !/^\s*\d+\s*$/.test(value)) {
111
+ return null;
112
+ }
113
+ const level = parseInt(value, 10);
114
+ return level >= 1 ? level : null;
115
+ }
116
+ function level(element, role) {
117
+ if (role === 'heading') {
118
+ const explicit = ariaLevel(element);
119
+ if (explicit !== null) {
120
+ return explicit;
121
+ }
122
+ const tag = /^h([1-6])$/.exec(element.localName);
123
+ return tag ? Number(tag[1]) : 2;
124
+ }
125
+ return LEVEL_ROLES.has(role) ? ariaLevel(element) : null;
126
+ }
127
+ /** Whether the element itself sets aria-disabled=true. */
128
+ export function setsAriaDisabled(element) {
129
+ return token(element, 'aria-disabled') === 'true';
130
+ }
131
+ // The DOM parent, or the host for a shadow root's child: aria-disabled on
132
+ // a host reaches into its shadow tree.
133
+ function parentOrHost(element) {
134
+ if (element.parentElement) {
135
+ return element.parentElement;
136
+ }
137
+ return element.getRootNode().host || null;
138
+ }
139
+ /**
140
+ * Whether an ancestor sets aria-disabled. The walk threads that down, so
141
+ * this check is only for a root or an owned element, whose ancestors the
142
+ * walk has not seen.
143
+ */
144
+ export function isDisabledByAncestor(element) {
145
+ for (let current = parentOrHost(element); current; current = parentOrHost(current)) {
146
+ if (setsAriaDisabled(current)) {
147
+ return true;
148
+ }
149
+ }
150
+ return false;
151
+ }
152
+ // An ancestor's aria-disabled reaches the descendants that can take focus
153
+ // (WAI-ARIA 1.2), not the headings and paragraphs between them.
154
+ function disabled(element, disabledByAncestor) {
155
+ if (setsAriaDisabled(element) || (disabledByAncestor && canTakeFocus(element))) {
156
+ return true;
157
+ }
158
+ return DISABLEABLE_ELEMENTS.has(element.localName) && !isEnabled(element);
159
+ }
160
+ // The body is the default active element and is not "focused" in any sense a
161
+ // user would recognise. Focus inside a shadow tree is known to that tree's
162
+ // root; the document only knows the host, which is not itself focused while
163
+ // something it can see inside its shadow root is.
164
+ function focused(element) {
165
+ const doc = element.ownerDocument;
166
+ if (element === doc.body || element === doc.documentElement) {
167
+ return false;
168
+ }
169
+ const root = element.getRootNode();
170
+ if (root.activeElement !== element) {
171
+ return false;
172
+ }
173
+ return !(element.shadowRoot && element.shadowRoot.activeElement);
174
+ }
175
+ /**
176
+ * The states map for an element with the given role; {} when there are none.
177
+ * `disabledByAncestor` is whether an ancestor sets aria-disabled, which the
178
+ * walk knows without climbing.
179
+ */
180
+ export function computeStates(element, role, disabledByAncestor) {
181
+ const states = {};
182
+ if (CHECKED_ROLES.has(role)) {
183
+ states.checked = checked(element, role);
184
+ }
185
+ if (role === 'button') {
186
+ const pressed = optionalToken(element, 'aria-pressed');
187
+ if (pressed !== null) {
188
+ states.pressed = tristate(element, 'aria-pressed', true);
189
+ }
190
+ }
191
+ const isExpanded = expanded(element);
192
+ if (isExpanded !== null) {
193
+ states.expanded = isExpanded;
194
+ }
195
+ const isSelected = selected(element, role);
196
+ if (isSelected !== null) {
197
+ states.selected = isSelected;
198
+ }
199
+ const headingLevel = level(element, role);
200
+ if (headingLevel !== null) {
201
+ states.level = headingLevel;
202
+ }
203
+ if (disabled(element, disabledByAncestor)) {
204
+ states.disabled = true;
205
+ }
206
+ if (focused(element)) {
207
+ states.focused = true;
208
+ }
209
+ return states;
210
+ }
211
+ /** The current value for textbox, searchbox, combobox and range roles; null when the field is absent. */
212
+ export function computeValue(element, role) {
213
+ return VALUE_ROLES.has(role) ? embeddedValue(element, role) : null;
214
+ }
215
+ //# sourceMappingURL=states.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"states.js","sourceRoot":"","sources":["../../../../typescript/core/accessibility/states.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { SnapshotContext } from './context.js';
2
+ import type { AccessibilityNode } from './types.js';
3
+ /**
4
+ * The snapshot rooted at `root`. The root always produces a node, whatever
5
+ * its role or hidden state, so a subtree snapshot of a plain div is still
6
+ * deterministic; a root whose subtree is hidden, by itself or by an
7
+ * ancestor, has no children.
8
+ */
9
+ export declare function buildTree(root: Element, context: SnapshotContext): AccessibilityNode;
10
+ //# sourceMappingURL=tree.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../../typescript/core/accessibility/tree.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAU,eAAe,EAAE,MAAM,cAAc,CAAA;AAItD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AA8PnD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,iBAAiB,CAuBpF"}
@@ -0,0 +1,261 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+ import { computeDescription, computeName } from './accname.js';
18
+ import { roleOf } from './context.js';
19
+ import { flatTreeChildren, hiddenState, isClosedDetails, isCollapsedDetailsContent, isHiddenByAncestor } from './hidden.js';
20
+ import { isPresentational } from './roles.js';
21
+ import { computeStates, computeValue, isDisabledByAncestor, setsAriaDisabled } from './states.js';
22
+ const ELEMENT_NODE = 1;
23
+ const TEXT_NODE = 3;
24
+ // WAI-ARIA 1.2 roles with "Children Presentational: True" (plus the graphics
25
+ // module's symbol). Their content only contributes to their name, never to
26
+ // the tree.
27
+ const CHILDREN_PRESENTATIONAL = new Set([
28
+ 'button', 'checkbox', 'graphics-symbol', 'img', 'menuitemcheckbox', 'menuitemradio', 'meter',
29
+ 'option', 'progressbar', 'radio', 'scrollbar', 'separator', 'slider', 'switch', 'tab',
30
+ ]);
31
+ // Elements whose DOM children are not rendered content, whatever role they
32
+ // end up with: a frame's children are fallback for a browsing context only
33
+ // the bindings can reach (the ADR's iframe leaf), a textarea's text child is
34
+ // its default value, and media fallback shows only when the media cannot.
35
+ const LEAF_ELEMENTS = new Set(['audio', 'frame', 'iframe', 'textarea', 'video']);
36
+ function textLeaf(text) {
37
+ // No `element` or `value` key at all rather than undefined, so the
38
+ // serialized shape matches the schema literally.
39
+ return { role: 'text', name: text, description: '', states: {}, children: [] };
40
+ }
41
+ function elementNode(element, role, name, context, disabledByAncestor) {
42
+ const node = {
43
+ role,
44
+ name,
45
+ description: computeDescription(element, context),
46
+ states: computeStates(element, role, disabledByAncestor),
47
+ element,
48
+ children: [],
49
+ };
50
+ const value = computeValue(element, role);
51
+ if (value !== null) {
52
+ node.value = value;
53
+ }
54
+ const url = linkUrl(element, role);
55
+ if (url !== null) {
56
+ node.url = url;
57
+ }
58
+ return node;
59
+ }
60
+ const HTML_NAMESPACE = 'http://www.w3.org/1999/xhtml';
61
+ // ADR 18205 §2: a link node carries the resolved href of an `a` or `area`
62
+ // element, as CDP's accessibility tree exposes it; an element made a link by
63
+ // role alone has nothing to resolve. The href property, not the attribute,
64
+ // so the URL is absolute. Checked by namespace and name rather than
65
+ // instanceof, which fails across realms when the atom runs in a sandbox.
66
+ function linkUrl(element, role) {
67
+ if (role !== 'link' || element.namespaceURI !== HTML_NAMESPACE) {
68
+ return null;
69
+ }
70
+ const local = element.localName;
71
+ if ((local !== 'a' && local !== 'area') || !element.hasAttribute('href')) {
72
+ return null;
73
+ }
74
+ return element.href;
75
+ }
76
+ function normalizeText(text) {
77
+ return text.replace(/\s+/g, ' ').trim();
78
+ }
79
+ // ADR 18205 §2: an element produces a node when its role is not generic,
80
+ // none or presentation, or it has a name. With interestingOnly off every
81
+ // element does, and the container nodes stay in place.
82
+ function producesNode(role, name, context) {
83
+ return !context.interestingOnly || !(role === 'generic' || isPresentational(role)) || name !== '';
84
+ }
85
+ function isLeaf(element, role) {
86
+ return LEAF_ELEMENTS.has(element.localName) || CHILDREN_PRESENTATIONAL.has(role);
87
+ }
88
+ /**
89
+ * Appends the node(s) for one element to `out`: its own node with its
90
+ * children, or, when it produces no node (pruned role, visibility-hidden),
91
+ * its children in its place so hoisting keeps order.
92
+ *
93
+ * `textHidden` is true while inside an element whose visibility hides its
94
+ * text: visibility is inherited, so the text of such an element and of
95
+ * descendants that do not set themselves visible again is not rendered.
96
+ * `textConsumed` is true below a node whose name was computed from its
97
+ * content: that text already appears as the name and is not repeated as
98
+ * leaves, while the element structure below is still reported. `disabled`
99
+ * is true below an element that sets aria-disabled, which the states module
100
+ * applies to the descendants that can take focus.
101
+ */
102
+ function visitElement(element, context, above, out) {
103
+ if (context.placed.has(element)) {
104
+ return;
105
+ }
106
+ context.placed.add(element);
107
+ const inherited = above.disabled || !setsAriaDisabled(element) ? above : Object.assign(Object.assign({}, above), { disabled: true });
108
+ const domParent = element.parentElement;
109
+ if (domParent && isCollapsedDetailsContent(element, domParent)) {
110
+ return;
111
+ }
112
+ const hidden = hiddenState(element, context);
113
+ if (hidden === 'subtree') {
114
+ return;
115
+ }
116
+ if (hidden === 'self') {
117
+ collectChildren(element, context, Object.assign(Object.assign({}, inherited), { textHidden: true }), out);
118
+ return;
119
+ }
120
+ const role = roleOf(element, context);
121
+ const name = computeName(element, context);
122
+ const descend = hidden !== 'contents' && !isLeaf(element, role);
123
+ if (!producesNode(role, name.text, context)) {
124
+ // The element is rendered, so its own visibility is visible even under
125
+ // an invisible ancestor: its text shows.
126
+ if (descend) {
127
+ collectChildren(element, context, Object.assign(Object.assign({}, inherited), { textHidden: false }), out);
128
+ }
129
+ return;
130
+ }
131
+ const node = elementNode(element, role, name.text, context, above.disabled);
132
+ if (descend) {
133
+ collectChildren(element, context, Object.assign(Object.assign({}, inherited), { textHidden: false, textConsumed: inherited.textConsumed || name.source === 'content' }), node.children);
134
+ }
135
+ out.push(node);
136
+ }
137
+ /**
138
+ * Appends the nodes for `parent`'s children to `out`: its flat-tree children
139
+ * in render order, then the elements it owns through aria-owns. An element
140
+ * some owner in the walked subtree claims is skipped at its DOM position and
141
+ * placed under that owner instead (ADR 18205 §3).
142
+ */
143
+ function collectChildren(parent, context, inherited, out) {
144
+ // Text directly inside a closed details is collapsed content like any
145
+ // element other than its summary.
146
+ const textCollapsed = isClosedDetails(parent);
147
+ const children = flatTreeChildren(parent);
148
+ for (let i = 0; i < children.length; i++) {
149
+ const child = children[i];
150
+ if (child.nodeType === TEXT_NODE) {
151
+ if (!inherited.textHidden && !inherited.textConsumed && !textCollapsed) {
152
+ const text = normalizeText(child.nodeValue || '');
153
+ if (text !== '') {
154
+ out.push(textLeaf(text));
155
+ }
156
+ }
157
+ continue;
158
+ }
159
+ if (child.nodeType === ELEMENT_NODE && !context.claimed.has(child)) {
160
+ visitElement(child, context, inherited, out);
161
+ }
162
+ }
163
+ const owned = context.owned.get(parent);
164
+ if (owned) {
165
+ for (const element of owned) {
166
+ // Hidden-ness still follows DOM ancestry: the walk never reaches the
167
+ // owned element's DOM ancestors on its way here, so they are checked
168
+ // now. So does aria-disabled, which an owned element does not share
169
+ // with its owner.
170
+ if (isHiddenByAncestor(element, context)) {
171
+ continue;
172
+ }
173
+ visitElement(element, context, Object.assign(Object.assign({}, inherited), { disabled: isDisabledByAncestor(element) }), out);
174
+ }
175
+ }
176
+ }
177
+ // Whether placing `target` under `owner` would make the tree circular: the
178
+ // target is, or contains, the owner or one of the owner's accessibility
179
+ // ancestors, following the ownership recorded so far and DOM parentage
180
+ // otherwise.
181
+ function wouldCycle(target, owner, ownerOf) {
182
+ for (let current = owner; current; current = ownerOf.get(current) || current.parentElement) {
183
+ if (target.contains(current)) {
184
+ return true;
185
+ }
186
+ }
187
+ return false;
188
+ }
189
+ // The elements with aria-owns under `root`, in the flat tree the walk itself
190
+ // visits: an owner inside an open shadow root is found, and a light-DOM
191
+ // owner no slot takes is not, since it is never rendered and must not take
192
+ // a rendered element away from its place.
193
+ function collectOwners(element, out) {
194
+ if (element.hasAttribute('aria-owns')) {
195
+ out.push(element);
196
+ }
197
+ const children = flatTreeChildren(element);
198
+ for (let i = 0; i < children.length; i++) {
199
+ const child = children[i];
200
+ if (child.nodeType === ELEMENT_NODE) {
201
+ collectOwners(child, out);
202
+ }
203
+ }
204
+ }
205
+ /**
206
+ * Records every aria-owns relation whose owner is in the flat tree under
207
+ * `root`, so owned elements can be skipped where they sit and placed under
208
+ * their owner. An element is owned by the first owner in flat-tree order
209
+ * that can take it: a relation that would make the tree circular (owning
210
+ * yourself, an ancestor, or something that already owns you) is dropped, as
211
+ * is one whose owner has presentational children and so no children to own,
212
+ * and an id that resolves to nothing is ignored.
213
+ */
214
+ function recordOwnership(root, context) {
215
+ const owners = [];
216
+ collectOwners(root, owners);
217
+ const ownerOf = new Map();
218
+ for (const owner of owners) {
219
+ if (isLeaf(owner, roleOf(owner, context))) {
220
+ continue;
221
+ }
222
+ const scope = owner.getRootNode();
223
+ const targets = [];
224
+ for (const id of (owner.getAttribute('aria-owns') || '').trim().split(/\s+/)) {
225
+ const target = id ? scope.getElementById(id) : null;
226
+ if (target && !context.claimed.has(target) && !wouldCycle(target, owner, ownerOf)) {
227
+ targets.push(target);
228
+ context.claimed.add(target);
229
+ ownerOf.set(target, owner);
230
+ }
231
+ }
232
+ if (targets.length) {
233
+ context.owned.set(owner, targets);
234
+ }
235
+ }
236
+ }
237
+ /**
238
+ * The snapshot rooted at `root`. The root always produces a node, whatever
239
+ * its role or hidden state, so a subtree snapshot of a plain div is still
240
+ * deterministic; a root whose subtree is hidden, by itself or by an
241
+ * ancestor, has no children.
242
+ */
243
+ export function buildTree(root, context) {
244
+ recordOwnership(root, context);
245
+ context.placed.add(root);
246
+ const role = roleOf(root, context);
247
+ const name = computeName(root, context);
248
+ const disabledByAncestor = isDisabledByAncestor(root);
249
+ const node = elementNode(root, role, name.text, context, disabledByAncestor);
250
+ const hidden = hiddenState(root, context);
251
+ const descend = hidden !== 'subtree' && hidden !== 'contents' && !isLeaf(root, role) && !isHiddenByAncestor(root, context);
252
+ if (descend) {
253
+ collectChildren(root, context, {
254
+ textHidden: hidden === 'self',
255
+ textConsumed: name.source === 'content',
256
+ disabled: disabledByAncestor || setsAriaDisabled(root),
257
+ }, node.children);
258
+ }
259
+ return node;
260
+ }
261
+ //# sourceMappingURL=tree.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../../typescript/core/accessibility/tree.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ export type StateValue = boolean | number | 'mixed';
2
+ /** What a snapshot leaves out; every option has a default, so `{}` is the default snapshot. */
3
+ export interface SnapshotOptions {
4
+ /**
5
+ * With the default `true`, elements of role generic, none or presentation with
6
+ * no name produce no node and their children take their place (ADR 18205 §2).
7
+ * With `false` every rendered element produces a node, as Puppeteer's
8
+ * `accessibility.snapshot({ interestingOnly: false })` does.
9
+ */
10
+ interestingOnly?: boolean;
11
+ }
12
+ export interface AccessibilityNode {
13
+ /** WAI-ARIA role token; "text" for text leaves, "iframe" for frame leaves. */
14
+ role: string;
15
+ /** Computed accessible name; "" when there is none. */
16
+ name: string;
17
+ /** Computed accessible description; "" when there is none. */
18
+ description: string;
19
+ /** Current value, present only for textbox, combobox, searchbox and range roles. */
20
+ value?: string;
21
+ /** The resolved href of a link, present only on role link whose element has one. */
22
+ url?: string;
23
+ /** States the role supports or the element sets; {} when there are none. */
24
+ states: Record<string, StateValue>;
25
+ /** The backing element; absent for text leaves and synthesized nodes. */
26
+ element?: Element;
27
+ /** [] for leaves. */
28
+ children: AccessibilityNode[];
29
+ }
30
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../typescript/core/accessibility/types.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;AAEnD,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAA;IACnB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAClC,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qBAAqB;IACrB,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAC9B"}
@@ -0,0 +1,18 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+ export {};
18
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../typescript/core/accessibility/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,wDAAwD;AACxD,6DAA6D;AAC7D,oDAAoD;AACpD,6DAA6D;AAC7D,6DAA6D;AAC7D,EAAE;AACF,+CAA+C;AAC/C,EAAE;AACF,6DAA6D;AAC7D,8DAA8D;AAC9D,yDAAyD;AACzD,4DAA4D;AAC5D,0DAA0D;AAC1D,qBAAqB"}
@@ -0,0 +1,4 @@
1
+ export declare function isEmbeddedControl(role: string): boolean;
2
+ /** The current value of an embedded control, or null when the role has none. */
3
+ export declare function embeddedValue(element: Element, role: string): string | null;
4
+ //# sourceMappingURL=value.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../../../typescript/core/accessibility/value.ts"],"names":[],"mappings":"AAyBA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AA8BD,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8B3E"}