accessibility-checker 4.0.1 → 4.0.2

package/cjs/index.js

@@ -0,0 +1,402 @@
+"use strict";
+/******************************************************************************
+    Copyright:: 2020- IBM, Inc
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+ *****************************************************************************/
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ruleIdToLegacyId = void 0;
+exports.getCompliance = getCompliance;
+exports.assertCompliance = assertCompliance;
+exports.stringifyResults = stringifyResults;
+exports.getConfig = getConfig;
+exports.getConfigUnsupported = getConfigUnsupported;
+exports.close = close;
+exports.getDiffResults = getDiffResults;
+exports.getBaseline = getBaseline;
+exports.diffResultsWithExpected = diffResultsWithExpected;
+exports.cleanComplianceObjectBeforeCompare = cleanComplianceObjectBeforeCompare;
+exports.addRuleset = addRuleset;
+exports.getRuleset = getRuleset;
+exports.getRulesets = getRulesets;
+exports.getRules = getRules;
+const ACBrowserManager_js_1 = require("./lib/ACBrowserManager.js");
+const ACEngineManager_js_1 = require("./lib/ACEngineManager.js");
+const ACHelper_js_1 = require("./lib/ACHelper.js");
+const ACConfigManager_js_1 = require("./lib/common/config/ACConfigManager.js");
+const BaselineManager_js_1 = require("./lib/common/report/BaselineManager.js");
+const ReporterManager_js_1 = require("./lib/common/report/ReporterManager.js");
+/**
+ * This function is responsible performing a scan based on the context that is provided, following are
+ * the supported context type:
+ *    Single node (HTMLElement)
+ *    Local file path (String)
+ *    URL (String)
+ *    document node
+ *    data stream for html content (String)
+ *
+ *  Future Items
+ *    Multiple node (Array of HTMLElements) ---> FUTURE
+ *
+ * @param {(String|HTMLElement|DocumentNode|Puppeteer Page |)} content - Provide the context to scan, which includes the items from above.
+ * @param {String} label - Provide a label for the scan that is being performed
+ * @param {Function} callback - (optional) Provide callback function which will be executed once the results are extracted.
+ * @return Promise with the ICheckerResult
+ */
+function getCompliance(content, label, callback) {
+    if (callback) {
+        (0, ACHelper_js_1.getComplianceHelper)(content, label)
+            .then((result) => {
+            callback(result.report, result.webdriver);
+        });
+    }
+    else {
+        return (0, ACHelper_js_1.getComplianceHelper)(content, label);
+    }
+}
+/**
+ * This function is responsible for comparing the scan results with baseline or checking that there are
+ * no violations which fall into the failsLevels levels. In the case a baseline is found then baseline will
+ * be used to perform the check, in the case no baseline is provided then we comply with only failing if
+ * there is a sinble violation which falls into failLevels.
+ *
+ * @param {ReportResult} actual - the actual results object provided by the user, this object should follow the
+ *                          same format as outlined in the return of aChecker.buildReport function.
+ *
+ * @return {int} - return 0 in the case actual matches baseline or no violations fall into failsLevels,
+ *                 return 1 in the case actual results does not match baseline results,
+ *                 return 2 in the case that there is a failure based on failLevels (this means no baseline found).
+ *                 return -1 in the case that there is an exception that occured in the results object which came from the scan engine.
+ */
+function assertCompliance(report) {
+    return BaselineManager_js_1.BaselineManager.assertCompliance(report);
+}
+/**
+ * This function is responsible for printing the scan results to console.
+ *
+ * @param {Object} results - Provide the results from the scan.
+ *
+ * @return {String} resultsString - String representation of the results/violations.
+ *
+ * PUBLIC API
+ *
+ * @memberOf this
+ */
+function stringifyResults(report) {
+    return ReporterManager_js_1.ReporterManager.stringifyResults(report);
+}
+function getConfig() {
+    return ACConfigManager_js_1.ACConfigManager.getConfig();
+}
+function getConfigUnsupported() {
+    return ACConfigManager_js_1.ACConfigManager.getConfigUnsupported();
+}
+function close() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield ReporterManager_js_1.ReporterManager.generateSummaries();
+        }
+        catch (err) {
+            console.error(err);
+        }
+        return ACBrowserManager_js_1.ACBrowserManager.close();
+    });
+}
+/**
+ * This function is responsible for getting the diff results based on label for a scan that was already performed.
+ *
+ * @param {String} label - Provide a lable for which to get the diff results for.
+ *
+ * @return {Object} - return the diff results object from global space based on label provided, the object will be
+ *                    in the same format as outlined in the return of aChecker.diffResultsWithExpected function.
+ */
+function getDiffResults(label) {
+    return BaselineManager_js_1.BaselineManager.getDiffResults(label);
+}
+/**
+ * This function is responsible for getting the baseline object for a label that was provided.
+ *
+ * @param {String} label - Provide a lable for which to get the baseline for.
+ *
+ * @return {Object} - return the baseline object from global space based on label provided, the object will be
+ *                    in the same format as outlined in the return of aChecker.buildReport function.
+ */
+function getBaseline(label) {
+    return BaselineManager_js_1.BaselineManager.getBaseline(label);
+}
+/**
+ * This function is responsible for comparing actual with expected and returning all the differences as an array.
+ *
+ * @param {Object} actual - Provide the actual object to be used for compare
+ * @param {Object} expected - Provide the expected object to be used for compare
+ * @param {boolean} clean - Provide a boolean if both the actual and expected objects need to be cleaned
+ *                          cleaning refers to converting the objects to match with a basic compliance
+ *                          compare of xpath and ruleId.
+ *
+ * @return {Object} differences - return an array of diff objects that were found, following is the format of the object:
+ * [
+ *     {
+ *         "kind": "E",
+ *         "path": [
+ *             "reports",
+ *             0,
+ *             "issues",
+ *             10,
+ *             "xpath"
+ *         ],
+ *         "lhs": "/html[1]/body[1]/div[2]/table[5]",
+ *         "rhs": "/html[1]/body[1]/div[2]/table[5]d",
+ *     },
+ *     {
+ *         "kind": "E",
+ *         "path": [
+ *             "label"
+ *         ],
+ *         "lhs": "Table-layoutMultiple",
+ *         "rhs": "dependencies/tools-rules-html/v2/a11y/test/g471/Table-layoutMultiple.html",
+ *     }
+ * ]
+ */
+function diffResultsWithExpected(actual, expected, clean) {
+    return BaselineManager_js_1.BaselineManager.diffResultsWithExpected(actual, expected, clean);
+}
+/**
+ * This function is responsible for cleaning up the compliance baseline or actual results, based on
+ * a pre-defined set of criterias, such as the following:
+ *      1. No need to compare summary object
+ *      2. Only need to compare the ruleId and xpath in for each of the issues
+ *
+ * @param {Object} objectToClean - Provide either an baseline or actual results object which would be in the
+ *                                 the same format as outlined in the return of aChecker.buildReport function.
+ *
+ * @return {Object} objectToClean - return an object that was cleaned to only contain the information that is
+ *                                  needed for compare. Following is a sample of how the cleaned object will look like:
+ * {
+ *     "label": "unitTestContent",
+ *     "reports": [
+ *         {
+ *             "frameIdx": "0",
+ *             "frameTitle": "Frame 0",
+ *             "issues": [
+ *                 {
+ *                     "ruleId": "1",
+ *                     "xpath": "/html[1]/head[1]/style[1]"
+ *                 }
+ *                 ....
+ *             ]
+ *         },
+ *         {
+ *             "frameIdx": "1",
+ *             "frameTitle": "Frame 1",
+ *             "issues": [
+ *                 {
+ *                     "ruleId": "471",
+ *                     "xpath": "/html[1]/body[1]/div[2]/table[3]"
+ *                 }
+ *                 ....
+ *             ]
+ *         }
+ *     ]
+ * }
+ */
+function cleanComplianceObjectBeforeCompare(objectToClean) {
+    return BaselineManager_js_1.BaselineManager.cleanComplianceObjectBeforeCompare(objectToClean);
+}
+function addRuleset(ruleset) {
+    ACEngineManager_js_1.ACEngineManager.addRuleset(ruleset);
+}
+function getRuleset(rsId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return ACEngineManager_js_1.ACEngineManager.getRuleset(rsId);
+    });
+}
+;
+function getRulesets() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return ACEngineManager_js_1.ACEngineManager.getRulesets();
+    });
+}
+;
+function getRules() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return ACEngineManager_js_1.ACEngineManager.getRules();
+    });
+}
+exports.ruleIdToLegacyId = {
+    "list_structure_proper": "3",
+    "marquee_elem_avoid": "5",
+    "heading_markup_misuse": "7",
+    "imagebutton_alt_exists": "10",
+    "img_ismap_misuse": "11",
+    "object_text_exists": "20",
+    "applet_alt_exists": "21",
+    "media_audio_transcribed": "24",
+    "blockquote_cite_exists": "25",
+    "meta_refresh_delay": "33",
+    "frame_title_exists": "39",
+    "input_label_exists": "41",
+    "media_alt_brief": "99",
+    "a_target_warning": "112",
+    "area_alt_exists": "240",
+    "RPT_Media_ImgColorUsage": "245",
+    "meta_redirect_optional": "254",
+    "element_attribute_deprecated": "256",
+    "text_quoted_correctly": "263",
+    "element_mouseevent_keyboard": "269",
+    "page_title_exists": "273",
+    "text_block_heading": "322",
+    "form_submit_button_exists": "324",
+    "element_id_unique": "377",
+    "form_font_color": "394",
+    "form_label_unique": "398",
+    "img_alt_misuse": "453",
+    "img_longdesc_misuse": "454",
+    "img_alt_valid": "455",
+    "style_background_decorative": "456",
+    "asciiart_alt_exists": "458",
+    "media_track_available": "511",
+    "media_alt_exists": "460",
+    "style_color_misuse": "466",
+    "select_options_grouped": "467",
+    "list_markup_review": "468",
+    "script_onclick_misuse": "470",
+    "table_structure_misuse": "471",
+    "WCAG20_Img_AltTriggerNonDecorative": "473",
+    "blink_elem_deprecated": "478",
+    "blink_css_review": "479",
+    "html_skipnav_exists": "481",
+    "page_title_valid": "484",
+    "heading_content_exists": "488",
+    "html_lang_exists": "490",
+    "form_interaction_review": "491",
+    "a_text_purpose": "495",
+    "fieldset_legend_valid": "497",
+    "media_live_captioned": "501",
+    "text_sensory_misuse": "502",
+    "media_autostart_controllable": "503",
+    "style_focus_visible": "506",
+    "img_alt_redundant": "1000",
+    "RPT_Style_ExternalStyleSheet": "1073",
+    // "RPT_Header_Trigger": "1002",
+    "script_onclick_avoid": "1007",
+    "table_summary_redundant": "1011",
+    "input_label_before": "1017",
+    "input_label_after": "1018",
+    "embed_noembed_exists": "1020",
+    "table_scope_valid": "1025",
+    "img_alt_null": "1027",
+    "input_fields_grouped": "1028",
+    "input_checkboxes_grouped": "1029",
+    "script_select_review": "1035",
+    "input_onchange_review": "1050",
+    "embed_alt_exists": "1051",
+    "noembed_content_exists": "1052",
+    "table_caption_empty": "1053",
+    "table_caption_nested": "1054",
+    "label_content_exists": "1055",
+    "dir_attribute_valid": "1056",
+    "frame_src_valid": "1057",
+    "table_headers_related": "1059",
+    "table_layout_linearized": "1060",
+    "table_headers_exists": "1061",
+    "label_ref_valid": "1062",
+    "element_accesskey_unique": "1063",
+    "script_focus_blur_review": "1064",
+    "imagemap_alt_exists": "1067",
+    "emoticons_alt_exists": "1068",
+    "style_before_after_review": "1069",
+    "text_whitespace_valid": "1070",
+    "aria_role_allowed": "1074",
+    "aria_attribute_value_valid": "1076",
+    "aria_id_unique": "1077",
+    "aria_attribute_required": "1079",
+    "aria_attribute_exists": "1082",
+    "aria_attribute_allowed": "1083",
+    "aria_activedescendant_tabindex_valid": "1084",
+    "aria_child_tabbable": "1086",
+    "aria_keyboard_handler_exists": "1087",
+    "img_alt_decorative": "1090",
+    "aria_search_label_unique": "1097",
+    "aria_application_label_unique": "1099",
+    "aria_application_labelled": "1100",
+    "aria_document_label_unique": "1101",
+    "WCAG20_Label_TargetInvisible": "1112",
+    "caption_track_exists": "1117",
+    "media_keyboard_controllable": "1119",
+    "HAAC_Input_HasRequired": "1124",
+    "aria_img_labelled": "1128",
+    "img_alt_background": "1132",
+    "element_accesskey_labelled": "1140",
+    "aria_attribute_conflict": "1141",
+    "canvas_content_described": "1143",
+    "figure_label_exists": "1144",
+    "input_placeholder_label_visible": "1145",
+    "form_submit_review": "1147",
+    "text_contrast_sufficient": "1148",
+    "text_contrast_sufficient_PV": "1149",
+    "skip_main_exists": "1150",
+    "skip_main_described": "1151",
+    "aria_child_valid": "1152",
+    "aria_parent_required": "1153",
+    "aria_eventhandler_role_valid": "1154",
+    "aria_widget_labelled": "1156",
+    "aria_content_in_landmark": "1157",
+    "aria_region_labelled": "1158",
+    "aria_main_label_visible": "1159",
+    "aria_banner_label_unique": "1160",
+    "aria_complementary_label_unique": "1161",
+    "aria_contentinfo_label_unique": "1162",
+    "aria_form_label_unique": "1163",
+    "aria_navigation_label_unique": "1164",
+    "aria_complementary_label_visible": "1165",
+    "aria_article_label_unique": "1166",
+    "Rpt_Aria_ArticleRoleLabel_Implicit": "1167",
+    "Rpt_Aria_MultipleGroupRoles_Implicit": "1168",
+    "Rpt_Aria_GroupRoleLabel_Implicit": "1169",
+    "aria_contentinfo_single": "1170",
+    "aria_banner_single": "1172",
+    "aria_contentinfo_misuse": "1173",
+    "aria_complementary_labelled": "1174",
+    "aria_region_label_unique": "1176",
+    "widget_tabbable_exists": "1177",
+    "widget_tabbable_single": "1178",
+    "style_highcontrast_visible": "1180",
+    "aria_main_label_unique": "1182",
+    "download_keyboard_controllable": "1183",
+    "error_message_exists": "1184",
+    "list_children_valid": "1185",
+    "aria_activedescendant_valid": "1186",
+    "application_content_accessible": "1187",
+    "aria_toolbar_label_unique": "1188",
+    "HAAC_Combobox_ARIA_11_Guideline": "1193",
+    "HAAC_Combobox_Must_Have_Text_Input": "1194",
+    "HAAC_Combobox_DOM_Focus": "1195",
+    "HAAC_Combobox_Autocomplete": "1196",
+    "HAAC_Combobox_Autocomplete_Invalid": "1197",
+    "HAAC_Combobox_Expanded": "1198",
+    "HAAC_Combobox_Popup": "1199",
+    "style_viewport_resizable": "1200",
+    "label_name_visible": "1202",
+    "input_autocomplete_valid": "1203",
+    "input_label_visible": "1204"
+};
+//# sourceMappingURL=index.js.map

package/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src-ts/index.ts"],"names":[],"mappings":"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"}

package/cjs/lib/ACBrowserManager.d.ts

@@ -0,0 +1,22 @@
+import { IConfigInternal } from "./common/config/IConfig.js";
+export declare class ACBrowserManager {
+    static browserP: any;
+    static config: IConfigInternal;
+    static numInits: 0;
+    static pages: any[];
+    static getBrowserChrome(force: boolean): Promise<any>;
+    static close(): Promise<void>;
+    /**
+     * This function is responsible for building an iframe object with the provided URL or local file.
+     *
+     * @param {String} URLorLocalFile - Provide a URL or local file to scan.
+     *
+     * @return {Object} content - return an object which contains the iframeDoc and also the URL or
+     *                               local file name.
+     *
+     * PRIVATE METHOD
+     *
+     * @memberOf this
+     */
+    static buildIframeAndGetDoc(URLorLocalFileorContent: any): Promise<any>;
+}

package/cjs/lib/ACBrowserManager.js

@@ -0,0 +1,172 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACBrowserManager = void 0;
+const puppeteer = __importStar(require("puppeteer"));
+const ACConfigManager_js_1 = require("./common/config/ACConfigManager.js");
+class ACBrowserManager {
+    static getBrowserChrome(force) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!ACBrowserManager.config) {
+                ACBrowserManager.config = yield ACConfigManager_js_1.ACConfigManager.getConfigUnsupported();
+            }
+            if (force || !ACBrowserManager.browserP) {
+                return ACBrowserManager.browserP = puppeteer.launch({ headless: ACBrowserManager.config.headless, ignoreHTTPSErrors: ACBrowserManager.config.ignoreHTTPSErrors || false });
+            }
+            else {
+                return ACBrowserManager.browserP;
+            }
+        });
+    }
+    static close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (ACBrowserManager.browserP) {
+                let browser = yield ACBrowserManager.browserP;
+                yield browser.close();
+                ACBrowserManager.browserP = null;
+                ACBrowserManager.pages = [];
+            }
+        });
+    }
+    /**
+     * This function is responsible for building an iframe object with the provided URL or local file.
+     *
+     * @param {String} URLorLocalFile - Provide a URL or local file to scan.
+     *
+     * @return {Object} content - return an object which contains the iframeDoc and also the URL or
+     *                               local file name.
+     *
+     * PRIVATE METHOD
+     *
+     * @memberOf this
+     */
+    static buildIframeAndGetDoc(URLorLocalFileorContent) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!ACBrowserManager.config) {
+                ACBrowserManager.config = yield ACConfigManager_js_1.ACConfigManager.getConfigUnsupported();
+            }
+            const MAX_TABS = ACBrowserManager.config.maxTabs;
+            const browser = yield ACBrowserManager.getBrowserChrome(false);
+            // Clear out any pages that are already closed
+            ACBrowserManager.pages = ACBrowserManager.pages.filter((page) => page && !page.isClosed());
+            // If there's an existing, ready page, use it
+            let availPage;
+            for (const page of ACBrowserManager.pages) {
+                if (!availPage) {
+                    if (!page.aceBusy) {
+                        availPage = page;
+                        page.aceBusy = true;
+                    }
+                }
+            }
+            if (!availPage) {
+                // All pages are busy. Should we create a new one?
+                if (ACBrowserManager.pages.length + ACBrowserManager.numInits >= MAX_TABS) {
+                    // Too many pages, restart
+                    return new Promise((resolve, reject) => {
+                        setTimeout(() => __awaiter(this, void 0, void 0, function* () {
+                            resolve(yield ACBrowserManager.buildIframeAndGetDoc(URLorLocalFileorContent));
+                        }), 500);
+                    });
+                }
+                else {
+                    // Let's create a new page
+                    ++ACBrowserManager.numInits;
+                    let newPage = yield browser.newPage();
+                    newPage.on('console', msg => {
+                        for (let i = 0; i < msg.args.length; ++i)
+                            console.log(`${i}: ${msg.args[i]}`);
+                    });
+                    newPage.aceBusy = true;
+                    availPage = newPage;
+                    ACBrowserManager.pages.push(newPage);
+                    --ACBrowserManager.numInits;
+                }
+            }
+            let err = null, retVal = null;
+            function nav() {
+                return __awaiter(this, void 0, void 0, function* () {
+                    try {
+                        if (URLorLocalFileorContent.toLowerCase().includes("<html")) {
+                            // await page.goto(`data:text/html,encodeURIComponent(${URLorLocalFileorContent})`, { waitUntil: 'networkidle0' });
+                            let urlStr = "data:text/html;charset=utf-8," + encodeURIComponent(URLorLocalFileorContent);
+                            yield availPage.goto(urlStr);
+                        }
+                        else {
+                            yield availPage.goto(URLorLocalFileorContent);
+                        }
+                    }
+                    catch (e) {
+                        err = `${e.message} ${URLorLocalFileorContent}`;
+                        console.error(err);
+                        return null;
+                    }
+                    return availPage;
+                });
+            }
+            try {
+                retVal = yield nav();
+            }
+            catch (e) {
+            }
+            if (!retVal) {
+                // Page bad or unable to navigate, start over
+                availPage.close();
+                return new Promise((resolve, reject) => {
+                    setTimeout(() => __awaiter(this, void 0, void 0, function* () {
+                        resolve(yield ACBrowserManager.buildIframeAndGetDoc(URLorLocalFileorContent));
+                    }), 0);
+                });
+            }
+            if (retVal === null) {
+                console.log("[Internal Error:load content]", err);
+            }
+            return retVal;
+        });
+    }
+    ;
+}
+exports.ACBrowserManager = ACBrowserManager;
+ACBrowserManager.pages = [];
+//# sourceMappingURL=ACBrowserManager.js.map

package/cjs/lib/ACBrowserManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ACBrowserManager.js","sourceRoot":"","sources":["../../../src-ts/lib/ACBrowserManager.ts"],"names":[],"mappings":"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"}

package/cjs/lib/ACEngineManager.d.ts

@@ -0,0 +1,19 @@
+import { IChecker } from "./common/engine/IChecker.js";
+export declare class ACEngineManager {
+    static customRulesets: any[];
+    static engineContent: any;
+    static loadEngine(content: any): Promise<any>;
+    static localLoadPromise: any;
+    static loadEngineLocal(): Promise<any>;
+    static isPuppeteer(content: any): any;
+    static isPlaywright(content: any): boolean;
+    static isSelenium(content: any): boolean;
+    static isWebDriverIO(content: any): boolean;
+    static addRuleset: (ruleset: any) => void;
+    static getRuleset: (rsId: any) => Promise<any>;
+    static getRulesets: () => Promise<any[]>;
+    static getChecker(): IChecker;
+    static loadChecker(): Promise<IChecker>;
+    static getRules: () => Promise<any[]>;
+    static getRulesSync: () => any[];
+}