@qualweb/util 0.6.0-alpha5 → 0.6.0

package/dist/accessibilityUtils/implicitRoles.js

@@ -0,0 +1,494 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.implicitRoles = void 0;
+exports.implicitRoles = {
+    a: [
+        {
+            attributes: [['href', '']],
+            role: 'link',
+            special: true
+        }
+    ],
+    address: [
+        {
+            attributes: [],
+            role: 'group'
+        }
+    ],
+    area: [
+        {
+            attributes: [['href', '']],
+            role: 'link',
+            special: true
+        }
+    ],
+    article: [
+        {
+            attributes: [],
+            role: 'article'
+        }
+    ],
+    aside: [
+        {
+            attributes: [],
+            role: 'complementary'
+        }
+    ],
+    b: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    bdi: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    bdo: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    blockquote: [
+        {
+            attributes: [],
+            role: 'blockquote'
+        }
+    ],
+    body: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    button: [
+        {
+            attributes: [],
+            role: 'button'
+        }
+    ],
+    caption: [
+        {
+            attributes: [],
+            role: 'caption'
+        }
+    ],
+    code: [
+        {
+            attributes: [],
+            role: 'code'
+        }
+    ],
+    data: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    datalist: [
+        {
+            attributes: [],
+            role: 'listbox'
+        }
+    ],
+    del: [
+        {
+            attributes: [],
+            role: 'deletion'
+        }
+    ],
+    details: [
+        {
+            attributes: [],
+            role: 'group'
+        }
+    ],
+    dfn: [
+        {
+            attributes: [],
+            role: 'term'
+        }
+    ],
+    dialog: [
+        {
+            attributes: [],
+            role: 'dialog'
+        }
+    ],
+    div: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    em: [
+        {
+            attributes: [],
+            role: 'emphasis'
+        }
+    ],
+    fieldset: [
+        {
+            attributes: [],
+            role: 'group'
+        }
+    ],
+    figure: [
+        {
+            attributes: [],
+            role: 'figure'
+        }
+    ],
+    footer: [
+        {
+            attributes: [],
+            role: 'contentinfo',
+            special: true
+        }
+    ],
+    form: [
+        {
+            attributes: [],
+            role: 'form',
+            special: true
+        }
+    ],
+    h1: [
+        {
+            attributes: [],
+            role: 'heading',
+            special: true
+        }
+    ],
+    h2: [
+        {
+            attributes: [],
+            role: 'heading',
+            special: true
+        }
+    ],
+    h3: [
+        {
+            attributes: [],
+            role: 'heading',
+            special: true
+        }
+    ],
+    h4: [
+        {
+            attributes: [],
+            role: 'heading',
+            special: true
+        }
+    ],
+    h5: [
+        {
+            attributes: [],
+            role: 'heading',
+            special: true
+        }
+    ],
+    h6: [
+        {
+            attributes: [],
+            role: 'heading',
+            special: true
+        }
+    ],
+    header: [
+        {
+            attributes: [],
+            role: 'banner',
+            special: true
+        }
+    ],
+    hgroup: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    hr: [
+        {
+            attributes: [],
+            role: 'separator'
+        }
+    ],
+    html: [
+        {
+            attributes: [],
+            role: 'document'
+        }
+    ],
+    i: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    img: [
+        {
+            attributes: [],
+            role: 'img',
+            special: true
+        }
+    ],
+    input: [
+        {
+            attributes: [
+                ['type', 'button'],
+                ['type', 'image'],
+                ['type', 'reset'],
+                ['type', 'submit']
+            ],
+            role: 'button'
+        },
+        {
+            attributes: [['type', 'checkbox']],
+            role: 'checkbox'
+        },
+        {
+            attributes: [['type', 'number']],
+            role: 'spinbutton'
+        },
+        {
+            attributes: [['type', 'radio']],
+            role: 'radio'
+        },
+        {
+            attributes: [['type', 'range']],
+            role: 'slider'
+        },
+        {
+            attributes: [
+                ['type', null],
+                ['type', 'text'],
+                ['type', 'search'],
+                ['type', 'tel'],
+                ['type', 'url'],
+                ['type', 'email']
+            ],
+            role: 'combobox',
+            special: true
+        }
+    ],
+    ins: [
+        {
+            attributes: [],
+            role: 'insertion'
+        }
+    ],
+    li: [
+        {
+            attributes: [],
+            role: 'listitem',
+            special: true
+        }
+    ],
+    main: [
+        {
+            attributes: [],
+            role: 'main'
+        }
+    ],
+    math: [
+        {
+            attributes: [],
+            role: 'math'
+        }
+    ],
+    menu: [
+        {
+            attributes: [],
+            role: 'list'
+        }
+    ],
+    meter: [
+        {
+            attributes: [],
+            role: 'meter'
+        }
+    ],
+    nav: [
+        {
+            attributes: [],
+            role: 'navigation'
+        }
+    ],
+    ol: [
+        {
+            attributes: [],
+            role: 'list'
+        }
+    ],
+    optgroup: [
+        {
+            attributes: [],
+            role: 'group'
+        }
+    ],
+    option: [
+        {
+            attributes: [],
+            role: 'option',
+            special: true
+        }
+    ],
+    output: [
+        {
+            attributes: [],
+            role: 'status'
+        }
+    ],
+    p: [
+        {
+            attributes: [],
+            role: 'paragraph'
+        }
+    ],
+    pre: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    progress: [
+        {
+            attributes: [],
+            role: 'progressbar'
+        }
+    ],
+    q: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    samp: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    section: [
+        {
+            attributes: [],
+            role: 'region',
+            special: true
+        }
+    ],
+    select: [
+        {
+            attributes: [],
+            role: 'combobox',
+            special: true
+        }
+    ],
+    small: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    span: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    strong: [
+        {
+            attributes: [],
+            role: 'strong'
+        }
+    ],
+    sub: [
+        {
+            attributes: [],
+            role: 'subscript'
+        }
+    ],
+    sup: [
+        {
+            attributes: [],
+            role: 'superscript'
+        }
+    ],
+    svg: [
+        {
+            attributes: [],
+            role: 'graphics-document'
+        }
+    ],
+    table: [
+        {
+            attributes: [],
+            role: 'table'
+        }
+    ],
+    tbody: [
+        {
+            attributes: [],
+            role: 'rowgroup'
+        }
+    ],
+    textarea: [
+        {
+            attributes: [],
+            role: 'textbox'
+        }
+    ],
+    tfoot: [
+        {
+            attributes: [],
+            role: 'rowgroup'
+        }
+    ],
+    thead: [
+        {
+            attributes: [],
+            role: 'rowgroup'
+        }
+    ],
+    time: [
+        {
+            attributes: [],
+            role: 'time'
+        }
+    ],
+    td: [
+        {
+            attributes: [],
+            role: 'cell',
+            special: true
+        }
+    ],
+    th: [
+        {
+            attributes: [],
+            role: 'columnheader',
+            special: true
+        }
+    ],
+    tr: [
+        {
+            attributes: [],
+            role: 'row'
+        }
+    ],
+    u: [
+        {
+            attributes: [],
+            role: 'generic'
+        }
+    ],
+    ul: [
+        {
+            attributes: [],
+            role: 'list'
+        }
+    ]
+};

package/dist/accessibilityUtils/isDataTable.d.ts

@@ -0,0 +1,4 @@
+import type { QWElement } from '@qualweb/qw-element';
+declare function isDataTable(element: QWElement): boolean;
+export default isDataTable;
+//# sourceMappingURL=isDataTable.d.ts.map

package/dist/accessibilityUtils/isDataTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDataTable.d.ts","sourceRoot":"","sources":["../../src/accessibilityUtils/isDataTable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,iBAAS,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAchD;AAED,eAAe,WAAW,CAAC"}

package/dist/accessibilityUtils/isDataTable.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function isDataTable(element) {
+    const accessibleName = window.AccessibilityUtils.getAccessibleName(element);
+    const thElem = element.getElements('th');
+    const tdHeaders = element.getElements('td[scope]');
+    const tdWithHeaders = element.getElements('td[headers]');
+    const presentation = element.getElementAttribute('role') === 'presentation';
+    const describedBy = Boolean(element.getElementAttribute('aria-describedby'));
+    return presentation
+        ? false
+        : !!accessibleName || thElem.length > 0 || tdHeaders.length > 0 || tdWithHeaders.length > 0 || describedBy;
+}
+exports.default = isDataTable;

package/dist/accessibilityUtils/isElementChildPresentational.d.ts

@@ -0,0 +1,4 @@
+import type { QWElement } from '@qualweb/qw-element';
+declare function isElementChildPresentational(element: QWElement): boolean;
+export default isElementChildPresentational;
+//# sourceMappingURL=isElementChildPresentational.d.ts.map

package/dist/accessibilityUtils/isElementChildPresentational.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isElementChildPresentational.d.ts","sourceRoot":"","sources":["../../src/accessibilityUtils/isElementChildPresentational.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,iBAAS,4BAA4B,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAWjE;AA6BD,eAAe,4BAA4B,CAAC"}

package/dist/accessibilityUtils/isElementChildPresentational.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const isElementChildPresentationalAux_1 = __importDefault(require("./isElementChildPresentationalAux"));
+function isElementChildPresentational(element) {
+    const focusable = window.AccessibilityUtils.isElementFocusable(element);
+    const hasGlobalARIA = window.AccessibilityUtils.elementHasGlobalARIAPropertyOrAttribute(element);
+    const parent = element.getElementParent();
+    let childPresentational = false;
+    if (parent && !focusable && !hasGlobalARIA) {
+        childPresentational = (0, isElementChildPresentationalAux_1.default)(parent);
+    }
+    return !focusable && !hasGlobalARIA && childPresentational;
+}
+exports.default = isElementChildPresentational;

package/dist/accessibilityUtils/isElementChildPresentationalAux.d.ts

@@ -0,0 +1,4 @@
+import type { QWElement } from '@qualweb/qw-element';
+declare function isElementChildPresentationalAux(element: QWElement): boolean;
+export default isElementChildPresentationalAux;
+//# sourceMappingURL=isElementChildPresentationalAux.d.ts.map

package/dist/accessibilityUtils/isElementChildPresentationalAux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isElementChildPresentationalAux.d.ts","sourceRoot":"","sources":["../../src/accessibilityUtils/isElementChildPresentationalAux.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,iBAAS,+BAA+B,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAgBpE;AACD,eAAe,+BAA+B,CAAC"}

package/dist/accessibilityUtils/isElementChildPresentationalAux.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("../accessibilityUtils/constants");
+function isElementChildPresentationalAux(element) {
+    const role = window.AccessibilityUtils.getElementRole(element);
+    let childPresentational = false;
+    if (role !== null) {
+        childPresentational = constants_1.childPresentationalRole.includes(role);
+    }
+    const parent = element.getElementParent();
+    let isParentChildPresentationalVar = false;
+    if (parent && !childPresentational) {
+        isParentChildPresentationalVar = isElementChildPresentationalAux(parent);
+    }
+    return childPresentational || isParentChildPresentationalVar;
+}
+exports.default = isElementChildPresentationalAux;

package/dist/accessibilityUtils/isElementControl.d.ts

@@ -0,0 +1,4 @@
+import type { QWElement } from '@qualweb/qw-element';
+declare function isElementControl(element: QWElement): boolean;
+export default isElementControl;
+//# sourceMappingURL=isElementControl.d.ts.map

package/dist/accessibilityUtils/isElementControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isElementControl.d.ts","sourceRoot":"","sources":["../../src/accessibilityUtils/isElementControl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,iBAAS,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAGrD;AAED,eAAe,gBAAgB,CAAC"}

package/dist/accessibilityUtils/isElementControl.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("./constants");
+function isElementControl(element) {
+    const role = window.AccessibilityUtils.getElementRoleAName(element, '');
+    return role !== null && constants_1.controlRoles.indexOf(role) >= 0;
+}
+exports.default = isElementControl;

package/dist/accessibilityUtils/isElementFocusable.d.ts

@@ -0,0 +1,4 @@
+import type { QWElement } from '@qualweb/qw-element';
+declare function isElementFocusable(element: QWElement): boolean;
+export default isElementFocusable;
+//# sourceMappingURL=isElementFocusable.d.ts.map

package/dist/accessibilityUtils/isElementFocusable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isElementFocusable.d.ts","sourceRoot":"","sources":["../../src/accessibilityUtils/isElementFocusable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,iBAAS,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAiBvD;AAED,eAAe,kBAAkB,CAAC"}

package/dist/accessibilityUtils/isElementFocusable.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function isElementFocusable(element) {
+    const disabled = element.getElementAttribute('disabled') !== null;
+    if (disabled || window.DomUtils.isElementHiddenByCSS(element)) {
+        return false;
+    }
+    else if (window.AccessibilityUtils.isElementFocusableByDefault(element)) {
+        return true;
+    }
+    else {
+        let tabIndexLessThanZero = false;
+        const tabindex = element.getElementAttribute('tabindex');
+        const tabIndexExistsAndIsNumber = tabindex !== null && !isNaN(parseInt(tabindex, 10));
+        if (tabindex && tabIndexExistsAndIsNumber) {
+            tabIndexLessThanZero = parseInt(tabindex, 10) < 0;
+        }
+        return tabIndexExistsAndIsNumber && !tabIndexLessThanZero;
+    }
+}
+exports.default = isElementFocusable;

package/dist/accessibilityUtils/isElementFocusableByDefault.d.ts

@@ -0,0 +1,4 @@
+import type { QWElement } from '@qualweb/qw-element';
+declare function isElementFocusableByDefault(element: QWElement): boolean;
+export default isElementFocusableByDefault;
+//# sourceMappingURL=isElementFocusableByDefault.d.ts.map

package/dist/accessibilityUtils/isElementFocusableByDefault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isElementFocusableByDefault.d.ts","sourceRoot":"","sources":["../../src/accessibilityUtils/isElementFocusableByDefault.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,iBAAS,2BAA2B,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAgDhE;AAED,eAAe,2BAA2B,CAAC"}

package/dist/accessibilityUtils/isElementFocusableByDefault.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function isElementFocusableByDefault(element) {
+    const draggableAttribute = element.getElementAttribute('draggable');
+    if (draggableAttribute && draggableAttribute === 'true') {
+        return true;
+    }
+    else {
+        const elementName = element.getElementTagName();
+        const hasHref = element.elementHasAttribute('href');
+        const elementAttributeType = element.getElementAttribute('type');
+        const parent = element.getElementParent();
+        let parentName;
+        let parentChildren;
+        if (parent) {
+            parentName = parent.getElementTagName();
+            parentChildren = parent.getElementChildren();
+        }
+        switch (elementName) {
+            case 'a':
+                if (hasHref) {
+                    return true;
+                }
+                break;
+            case 'area':
+            case 'link':
+                if (hasHref) {
+                    return true;
+                }
+                break;
+            case 'input':
+                return !(elementAttributeType && elementAttributeType === 'hidden');
+            case 'summary':
+                return !!(parent &&
+                    parentName === 'details' &&
+                    parentChildren &&
+                    element.getElementSelector() === parentChildren[0].getElementSelector());
+            case 'textarea':
+            case 'select':
+            case 'button':
+            case 'iframe':
+                return true;
+        }
+        return false;
+    }
+}
+exports.default = isElementFocusableByDefault;

package/dist/accessibilityUtils/isElementInAT.d.ts

@@ -0,0 +1,4 @@
+import type { QWElement } from '@qualweb/qw-element';
+declare function isElementInAT(element: QWElement): boolean;
+export default isElementInAT;
+//# sourceMappingURL=isElementInAT.d.ts.map

package/dist/accessibilityUtils/isElementInAT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isElementInAT.d.ts","sourceRoot":"","sources":["../../src/accessibilityUtils/isElementInAT.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,iBAAS,aAAa,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAmElD;AAED,eAAe,aAAa,CAAC"}