@qualweb/util 0.0.0-develop-20231124154536 → 0.0.0-develop-20241204121833

package/dist/accessibilityUtils/getImplicitRole.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const implicitRoles_1 = require("./implicitRoles");
+function getImplicitRole(element, accessibleName) {
+    const name = element.getElementTagName();
+    let attributes;
+    let role = null;
+    if (name) {
+        const roleValues = implicitRoles_1.implicitRoles[name.toLocaleLowerCase()];
+        if (roleValues !== undefined) {
+            for (const roleValue of roleValues) {
+                const special = roleValue['special'];
+                attributes = roleValue['attributes'];
+                if (attributes.length === 0 || isInList(attributes, element)) {
+                    if (!special) {
+                        role = roleValue['role'];
+                    }
+                    else {
+                        const heading = new RegExp('h[1-6]');
+                        if (name === 'footer' || name === 'header') {
+                            role = getRoleHeaderFooter(element, roleValue);
+                        }
+                        else if (name === 'form' || name === 'section') {
+                            if (accessibleName !== undefined) {
+                                role = roleValue['role'];
+                            }
+                        }
+                        else if (heading.test(name)) {
+                            role = getRoleHeading(element, roleValue);
+                        }
+                        else if (name === 'img') {
+                            role = getRoleImg(element, roleValue);
+                        }
+                        else if (name === 'a') {
+                            role = getRoleA(element, roleValue);
+                        }
+                        else if (name === 'input') {
+                            role = getRoleInput(element, roleValue);
+                        }
+                        else if (name === 'li') {
+                            role = getRoleLi(element, roleValue);
+                        }
+                        else if (name === 'option') {
+                            role = getRoleOption(element, roleValue);
+                        }
+                        else if (name === 'select') {
+                            role = getRoleSelect(element, roleValue);
+                        }
+                        else if (name === 'td') {
+                            if (window.DomUtils.isElementADescendantOfExplicitRole(element, ['table'], [])) {
+                                role = roleValue['role'];
+                            }
+                            else if (window.DomUtils.isElementADescendantOfExplicitRole(element, ['grid', 'treegrid'], [])) {
+                                role = 'gridcell';
+                            }
+                        }
+                        else if (name === 'th') {
+                            if (window.DomUtils.isElementADescendantOfExplicitRole(element, ['table', 'grid', 'treegrid'], [])) {
+                                role = roleValue['role'];
+                            }
+                        }
+                        else if (name === 'area') {
+                            if (attributes.length === 0) {
+                                role = 'generic';
+                            }
+                            else if (isInList(attributes, element)) {
+                                role = roleValue['role'];
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return role;
+}
+function getRoleHeading(element, roleValue) {
+    const ariaLevel = element.getElementAttribute('aria-level');
+    if (ariaLevel === null || parseInt(ariaLevel) > 0) {
+        return roleValue.role;
+    }
+    return null;
+}
+function getRoleSelect(element, roleValue) {
+    const size = element.getElementAttribute('size');
+    const multiple = element.getElementAttribute('multiple');
+    let role;
+    if (multiple !== null && size !== null && parseInt(size, 10) > 1) {
+        role = 'listbox';
+    }
+    else {
+        role = roleValue.role;
+    }
+    return role;
+}
+function getRoleHeaderFooter(element, roleValue) {
+    let role;
+    if (!window.DomUtils.isElementADescendantOfExplicitRole(element, ['article', 'aside', 'main', 'nav', 'section'], ['article', 'complementary', 'main', 'navigation', 'region'])) {
+        role = roleValue['role'];
+    }
+    else {
+        role = 'generic';
+    }
+    return role;
+}
+function getRoleInput(element, roleValue) {
+    const list = element.getElementAttribute('list');
+    const type = element.getElementAttribute('type');
+    let role;
+    if (list !== null) {
+        role = roleValue['role'];
+    }
+    else if (type === 'search') {
+        role = 'searchbox';
+    }
+    else {
+        role = 'textbox';
+    }
+    return role;
+}
+function getRoleOption(element, roleValue) {
+    const parent = element.getElementParent();
+    let parentName;
+    if (parent !== null)
+        parentName = parent.getElementTagName();
+    if (parentName === 'datalist') {
+        return roleValue.role;
+    }
+    return null;
+}
+function getRoleImg(element, roleValue) {
+    const alt = element.getElementAttribute('alt');
+    const ariaLabelledBy = element.getElementAttribute('aria-labelledby');
+    const id = element.getElementAttribute('id');
+    let role = '';
+    if (alt !== '' || (ariaLabelledBy !== null && verifyAriaLabel(ariaLabelledBy, id))) {
+        role = roleValue.role;
+    }
+    else if (element.elementHasAttribute('alt') &&
+        !(window.AccessibilityUtils.isElementFocusable(element) ||
+            window.AccessibilityUtils.elementHasGlobalARIAPropertyOrAttribute(element))) {
+        role = 'presentation';
+    }
+    return role;
+}
+function getRoleA(element, roleValue) {
+    let role;
+    if (element.elementHasAttribute('href')) {
+        role = roleValue['role'];
+    }
+    else {
+        role = 'generic';
+    }
+    return role;
+}
+function getRoleLi(element, roleValue) {
+    const parent = element.getElementParent();
+    const parentNames = ['ol', 'ul', 'menu'];
+    const parentName = parent === null || parent === void 0 ? void 0 : parent.getElementTagName();
+    if (parentName && parentNames.includes(parentName)) {
+        return roleValue.role;
+    }
+    return null;
+}
+function isInList(attributes, element) {
+    let result;
+    for (let i = 0; i < attributes.length; i++) {
+        const attribute = attributes[i];
+        const key = attribute[0];
+        const value = attribute[1];
+        const roleSpecificATT = element.getElementAttribute(key);
+        if (roleSpecificATT === value || (value === '' && roleSpecificATT !== null))
+            result = true;
+    }
+    return result;
+}
+function verifyAriaLabel(ariaLabelBy, elementID) {
+    const elementIds = ariaLabelBy.split(' ');
+    let result = false;
+    for (const id of elementIds) {
+        if (!result && id !== '' && elementID !== id) {
+            result = window.qwPage.getElementByID(id) !== null;
+        }
+    }
+    return result;
+}
+exports.default = getImplicitRole;

package/dist/accessibilityUtils/getLinkContext.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"getLinkContext.d.ts","sourceRoot":"","sources":["../../src/accessibilityUtils/getLinkContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,iBAAS,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAwBzD;AAuBD,eAAe,cAAc,CAAC"}

package/dist/accessibilityUtils/getLinkContext.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function getLinkContext(element) {
+    const context = new Array();
+    const parent = element.getElementParent();
+    const ariaDescribedByATT = element.getElementAttribute('aria-describedby');
+    let ariaDescribedBy = new Array();
+    if (ariaDescribedByATT)
+        ariaDescribedBy = ariaDescribedByATT.split(' ');
+    if (parent) {
+        const role = window.AccessibilityUtils.getElementRole(parent);
+        const inAT = window.AccessibilityUtils.isElementInAT(parent);
+        const tagName = parent.getElementTagName();
+        const id = parent.getElementAttribute('id');
+        if (inAT &&
+            (tagName === 'p' ||
+                role === 'cell' ||
+                role === 'gridcell' ||
+                role === 'listitem' ||
+                (id && ariaDescribedBy.includes(id)))) {
+            context.push(parent.getElementSelector());
+        }
+        getLinkContextAux(parent, ariaDescribedBy, context);
+    }
+    return context;
+}
+function getLinkContextAux(element, ariaDescribedBy, context) {
+    const parent = element.getElementParent();
+    if (parent) {
+        const role = window.AccessibilityUtils.getElementRole(parent);
+        const inAT = window.AccessibilityUtils.isElementInAT(parent);
+        const tagName = parent.getElementTagName();
+        const id = parent.getElementAttribute('id');
+        if (inAT &&
+            (tagName === 'p' ||
+                role === 'cell' ||
+                role === 'gridcell' ||
+                role === 'listitem' ||
+                (id && ariaDescribedBy.includes(id)))) {
+            context.push(parent.getElementSelector());
+        }
+        getLinkContextAux(parent, ariaDescribedBy, context);
+    }
+}
+exports.default = getLinkContext;

package/dist/accessibilityUtils/getOwnedElements.d.ts

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

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

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

package/dist/accessibilityUtils/getOwnedElements.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function getOwnedElements(element) {
+    const children = element.getElementChildren();
+    const result = new Array();
+    const ariaOwnedElements = getAriaOwnedElements(element);
+    result.push(...ariaOwnedElements);
+    for (const child of children !== null && children !== void 0 ? children : []) {
+        result.push(...getOwnedElementsAux(child, element.getElementSelector()));
+    }
+    return result;
+}
+function getOwnedElementsAux(element, ownerSelector) {
+    let ariaOwner = window.AccessibilityUtils.getAriaOwner(element);
+    if (window.AccessibilityUtils.isElementInAT(element) &&
+        (!ariaOwner || (!!ariaOwner && ariaOwner.getElementSelector() === ownerSelector))) {
+        return [element];
+    }
+    else {
+        let children = element.getElementChildren();
+        let result = new Array();
+        for (const child of children !== null && children !== void 0 ? children : []) {
+            result.push(...getOwnedElementsAux(child, ownerSelector));
+        }
+        return result;
+    }
+}
+function getAriaOwnedElements(element) {
+    const ariaOwns = element.getElementAttribute('aria-owns');
+    const elements = new Array();
+    if (ariaOwns) {
+        const splitted = ariaOwns.split(',');
+        for (const id of splitted !== null && splitted !== void 0 ? splitted : []) {
+            const elem = window.qwPage.getElementByID(id);
+            if (!!elem) {
+                elements.push(elem);
+            }
+        }
+    }
+    return elements;
+}
+exports.default = getOwnedElements;

package/dist/accessibilityUtils/getOwnerElement.d.ts

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

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

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

package/dist/accessibilityUtils/getOwnerElement.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function getOwnerElement(element) {
+    const ariaOwner = window.AccessibilityUtils.getAriaOwner(element);
+    let ownerElement;
+    if (ariaOwner) {
+        ownerElement = ariaOwner;
+    }
+    else {
+        let parent = element.getElementParent();
+        while (!!parent && !ownerElement) {
+            if (window.AccessibilityUtils.isElementInAT(parent))
+                ownerElement = parent;
+            parent = parent.getElementParent();
+        }
+    }
+    return ownerElement || null;
+}
+exports.default = getOwnerElement;

package/dist/accessibilityUtils/getTextFromCss.d.ts

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

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

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

package/dist/accessibilityUtils/getTextFromCss.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function getTextFromCss(element, textContent) {
+    const before = element.getElementStyleProperty('computed-style-before', 'content');
+    const after = element.getElementStyleProperty('computed-style-after', 'content');
+    return before + textContent + after;
+}
+exports.default = getTextFromCss;

package/dist/accessibilityUtils/getValueFromEmbeddedControl.d.ts

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

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

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

package/dist/accessibilityUtils/getValueFromEmbeddedControl.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function getValueFromEmbeddedControl(element) {
+    var _a;
+    const role = window.AccessibilityUtils.getElementRoleAName(element, '');
+    const name = (_a = element.getElementTagName()) !== null && _a !== void 0 ? _a : '';
+    let value = '';
+    if (role === 'textbox') {
+        const valueAT = element.getElementAttribute('value');
+        value = valueAT ? valueAT : '';
+    }
+    else if (role === 'combobox') {
+        const referencedByLabel = element.getElement(`[aria-activedescendant]`);
+        let aria_descendant, selectedElement, optionSelected;
+        if (referencedByLabel) {
+            aria_descendant = referencedByLabel.getElementAttribute('role');
+            selectedElement = element.getElement(`[id="${aria_descendant}"]`);
+        }
+        if (name === 'select') {
+            optionSelected = element.getElement(`[selected]`);
+        }
+        const aria_owns = element.getElementAttribute('[aria-owns]');
+        const elementsToSelect = window.qwPage.getElement(`[id="${aria_owns}"]`);
+        let elementWithAriaSelected = null;
+        if (elementsToSelect) {
+            elementWithAriaSelected = elementsToSelect.getElement(`[aria-selected="true"]`);
+        }
+        if (optionSelected) {
+            value = window.DomUtils.getTrimmedText(optionSelected);
+        }
+        else if (selectedElement) {
+            value = window.DomUtils.getTrimmedText(selectedElement);
+        }
+        else if (elementWithAriaSelected) {
+            value = window.DomUtils.getTrimmedText(elementWithAriaSelected);
+        }
+    }
+    else if (role === 'listbox') {
+        const elementsWithId = element.getElements(`[id]`);
+        const elementWithAriaSelected = element.getElement(`[aria-selected="true"]`);
+        let selectedElement;
+        let optionSelected;
+        for (const elementWithId of elementsWithId) {
+            if (selectedElement) {
+                const id = elementWithId.getElementAttribute('id');
+                selectedElement = element.getElement(`[aria-activedescendant="${id}"]`);
+            }
+        }
+        if (name === 'select') {
+            optionSelected = element.getElement(`[selected]`);
+        }
+        if (selectedElement)
+            value = window.DomUtils.getTrimmedText(elementsWithId[0]);
+        else if (elementWithAriaSelected) {
+            value = window.DomUtils.getTrimmedText(elementWithAriaSelected);
+        }
+        else if (optionSelected) {
+            value = window.DomUtils.getTrimmedText(optionSelected);
+        }
+    }
+    else if (role === 'range' ||
+        role === 'progressbar' ||
+        role === 'scrollbar' ||
+        role === 'slider' ||
+        role === 'spinbutton') {
+        const valueTextVar = element.getElementAttribute('aria-valuetext');
+        const valuenowVar = element.getElementAttribute('aria-valuenow');
+        if (valueTextVar)
+            value = valueTextVar;
+        else if (valuenowVar)
+            value = valuenowVar;
+    }
+    return value;
+}
+exports.default = getValueFromEmbeddedControl;

package/dist/accessibilityUtils/implicitRoles.d.ts

@@ -0,0 +1,10 @@
+export type ImplicitRoleInfo = {
+    attributes: (string | null)[][];
+    role: string;
+    special?: boolean;
+};
+export type ImplicitRoles = {
+    [element: string]: ImplicitRoleInfo[];
+};
+export declare const implicitRoles: ImplicitRoles;
+//# sourceMappingURL=implicitRoles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"implicitRoles.d.ts","sourceRoot":"","sources":["../../src/accessibilityUtils/implicitRoles.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,aA0e3B,CAAC"}