accessibility-checker 4.0.1 → 4.0.2

package/mjs/lib/common/config/ACConstants.d.ts

@@ -0,0 +1,17 @@
+/******************************************************************************
+     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.
+  *****************************************************************************/
+import { IConfigInternal } from "./IConfig.js";
+export declare const ACConstants: IConfigInternal;

package/mjs/lib/common/config/ACConstants.js

@@ -0,0 +1,75 @@
+/******************************************************************************
+     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.
+  *****************************************************************************/
+/*******************************************************************************
+ * NAME: ACConstants.js
+ * DESCRIPTION: Stores all the constants that are used by karma-ibma.
+ *******************************************************************************/
+// Load all the modules that are needed
+import { tmpdir } from "os";
+import * as pathLib from "path";
+import { eRuleLevel } from "./IConfig.js";
+// Used to specify all the constant
+export const ACConstants = {
+    DEBUG: process.env.DEBUG === "true",
+    maxTabs: 1,
+    policies: ["IBM_Accessibility"],
+    // Specify the default rule pack server to use. (Where to pull the rules and engine from).
+    // - JSDelivr CDN
+    ruleServer: "https://cdn.jsdelivr.net/npm/accessibility-checker-engine",
+    // - IBM Cloud hosting
+    // ruleServer: "https://able.ibm.com/rules",
+    //Specify the rule set to be use.
+    ruleArchive: "latest",
+    // Specify default violation levels on which to fail the test.
+    // i.e. If specified violation then the testcase will only fail if
+    //      a violation is found uring the scan.
+    failLevels: [eRuleLevel.violation, eRuleLevel.potentialviolation],
+    // Specify default violation levels which should be reported.
+    // i.e. If specified violation then in the report it would only contain
+    //      results which are level of violation.
+    reportLevels: [eRuleLevel.violation, eRuleLevel.potentialviolation],
+    // Specify default value if screenshoot should be captured of the current page that is being scanned.
+    captureScreenshots: false,
+    outputFilenameTimestamp: true,
+    // Specify default value for which type should the results be outputted to
+    outputFormat: ["json"],
+    // Specify default location where the results should be saved
+    outputFolder: "results",
+    // Specify default location where the baselines should be saved
+    baselineFolder: "baselines",
+    // Default cache folder (for ace-node.js / archives.json)
+    cacheFolder: `${tmpdir()}/accessibility-checker/`,
+    // Specify default value for Which file extensions should be checked
+    extensions: ["html", "htm", "svg"],
+    // List of files to look for in that order, in the case even one is found we stop and load that as the config.
+    // Theses files will be checked for in the working directory:
+    //  ./.achecker.yml
+    //  ./.achecker.yaml
+    //  ./achecker.js
+    //  ./achecker.json
+    //  ./.config/.achecker.yml
+    //  ./.config/.achecker.yaml
+    //  ./.config/achecker.js
+    //  ./.config/achecker.json
+    // The node module, require will load js or json depending on which one is present, in the case
+    // both json and js are present it loads js first.
+    configFiles: [".achecker.yml", ".achecker.yaml", "achecker", "aceconfig", pathLib.join(".config", ".achecker.yml"), pathLib.join(".config", ".achecker.yaml"), pathLib.join(".config", "achecker"), pathLib.join(".config", "aceconfig")],
+    ignoreHTTPSErrors: false,
+    headless: "shell",
+    perfMetrics: true,
+    engineMode: "DEFAULT"
+};
+//# sourceMappingURL=ACConstants.js.map

package/mjs/lib/common/config/ACConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ACConstants.js","sourceRoot":"","sources":["../../../../../src-ts/lib/common/config/ACConstants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;gFAcgF;AAEhF;;;iFAGiF;AAEjF,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,KAAK,OAAO,MAAM,MAAM,CAAC;AAChC,OAAO,EAAmB,UAAU,EAAE,MAAM,cAAc,CAAC;AAE3D,mCAAmC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAqB;IACzC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM;IACnC,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC,mBAAmB,CAAC;IAC/B,0FAA0F;IAC1F,iBAAiB;IACjB,UAAU,EAAE,2DAA2D;IACvE,sBAAsB;IACtB,4CAA4C;IAE5C,iCAAiC;IACjC,WAAW,EAAE,QAAQ;IAErB,8DAA8D;IAC9D,kEAAkE;IAClE,4CAA4C;IAC5C,UAAU,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,kBAAkB,CAAC;IAEjE,6DAA6D;IAC7D,uEAAuE;IACvE,6CAA6C;IAC7C,YAAY,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,kBAAkB,CAAC;IAEnE,qGAAqG;IACrG,kBAAkB,EAAE,KAAK;IAEzB,uBAAuB,EAAE,IAAI;IAE7B,0EAA0E;IAC1E,YAAY,EAAE,CAAE,MAAM,CAAE;IAExB,6DAA6D;IAC7D,YAAY,EAAE,SAAS;IAEvB,+DAA+D;IAC/D,cAAc,EAAE,WAAW;IAE3B,yDAAyD;IACzD,WAAW,EAAE,GAAG,MAAM,EAAE,yBAAyB;IAEjD,oEAAoE;IACpE,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;IAElC,8GAA8G;IAC9G,6DAA6D;IAC7D,mBAAmB;IACnB,oBAAoB;IACpB,iBAAiB;IACjB,mBAAmB;IACnB,2BAA2B;IAC3B,4BAA4B;IAC5B,yBAAyB;IACzB,2BAA2B;IAC3B,+FAA+F;IAC/F,kDAAkD;IAClD,WAAW,EAAE,CAAC,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAEzO,iBAAiB,EAAE,KAAK;IACxB,QAAQ,EAAE,OAAO;IACjB,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,SAAS;CACxB,CAAC"}

package/mjs/lib/common/config/IArchive.d.ts

@@ -0,0 +1,37 @@
+/******************************************************************************
+     Copyright:: 2023- 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.
+ *****************************************************************************/
+export interface IArchive {
+    id: "latest" | "preview" | "versioned" | string;
+    name: string;
+    path: string;
+    policies: Array<{
+        id: string;
+        name: string;
+        description: string;
+    }>;
+    rulesets: {
+        [key: string]: Array<{
+            id: string;
+            name: string;
+            description: string;
+        }>;
+    };
+    version: string;
+    latest?: boolean;
+    sunset?: boolean;
+    helpPath: string;
+    enginePath: string;
+}

package/mjs/lib/common/config/IArchive.js

@@ -0,0 +1,17 @@
+/******************************************************************************
+     Copyright:: 2023- 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.
+ *****************************************************************************/
+export {};
+//# sourceMappingURL=IArchive.js.map

package/mjs/lib/common/config/IArchive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IArchive.js","sourceRoot":"","sources":["../../../../../src-ts/lib/common/config/IArchive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;+EAc+E"}

package/mjs/lib/common/config/IConfig.d.ts

@@ -0,0 +1,152 @@
+/******************************************************************************
+     Copyright:: 2023- 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.
+ *****************************************************************************/
+import { IArchive } from "./IArchive.js";
+export declare enum eAssertResult {
+    ERROR = -1,
+    PASS = 0,
+    BASELINE_MISMATCH = 1,
+    FAIL = 2
+}
+export declare enum eRuleLevel {
+    violation = "violation",
+    potentialviolation = "potentialviolation",
+    recommendation = "recommendation",
+    potentialrecommendation = "potentialrecommendation",
+    manual = "manual",
+    pass = "pass",
+    ignored = "ignored"
+}
+export interface IConfig {
+    /**
+     * (optional) Specify the rule archive
+     *
+     * Run `npx achecker archives` for a list of valid ruleArchive ids and policy ids
+     * Default: "latest"
+     */
+    ruleArchive?: "latest" | "preview" | "versioned" | string;
+    /**
+     * (optional) Specify one or many policies to scan.
+     *
+     * Run `npx achecker archives` for a list of valid ruleArchive ids and policy ids
+     * Default: ["IBM_Accessibility"]
+     */
+    policies?: Array<"IBM_Accessibility" | string>;
+    /**
+     * (optional) Specify one or many violation levels on which to fail the test
+     *
+     * i.e. If specified violation then the testcase will only fail if
+     * a violation is found during the scan.
+     * Default: ["violation", "review"]
+     */
+    failLevels?: eRuleLevel[];
+    /**
+     * (optional) Specify one or many violation levels which should be reported
+     *
+     * i.e. If specified violation then in the report it would only contain
+     * results which are level of violation.
+     * Default: ["violation", "review"]
+     */
+    reportLevels?: eRuleLevel[];
+    /**
+     * (optional) In which fornats should the results be output
+     * Default: ["json"]
+     */
+    outputFormat?: Array<"json" | "html" | "csv" | "disable" | "xlsx">;
+    /**
+     * (optional) Specify any labels that you would like associated to your scan
+     * Default: []
+     */
+    label?: string[];
+    /**
+     * (optional) Where the scan results should be saved.
+     * Default: "results"
+     */
+    outputFolder?: string;
+    /**
+     * (optional) Should the timestamp be included in the filename of the reports?
+     * Default: true
+     */
+    outputFilenameTimestamp?: boolean;
+    /**
+     * (optional) Where the baseline results should be loaded from
+     * Default: "baselines"
+     */
+    baselineFolder?: string;
+    /**
+     * (optional) Where the tool can read/write cached files (ace-node.js / archive.json)
+     * Default: `${os.tmpdir()}/accessibility-checker/`
+     */
+    cacheFolder?: string;
+    /**
+     * (optional) For tools that scan files, which extensions should we include
+     * Default: ["html", "htm", "svg"]
+     */
+    extensions?: string[];
+}
+export type IConfigInternal = IConfig & {
+    /**
+     * Run in debug mode
+     */
+    DEBUG?: boolean;
+    /**
+     * Spot to store parsed archive file
+     */
+    ruleArchiveSet?: IArchive[];
+    /**
+     * Label to expose to reports
+     */
+    ruleArchiveLabel?: string;
+    /**
+     * (optional) Rule server to pull the rules from and to use for help
+     * Default: "https://able.ibm.com/rules"
+     */
+    ruleServer?: string;
+    /**
+     * Path to the rule pack
+     */
+    rulePack?: string;
+    /**
+     * Path within the archive
+     */
+    ruleArchivePath?: string;
+    /**
+     * Version number of the selected archive
+     */
+    ruleArchiveVersion?: string;
+    /**
+     * (optional) If the tool allows, should we capture screenshots
+     */
+    captureScreenshots?: boolean;
+    /**
+     * (optional) If the tool allows, should we run headless
+     */
+    headless?: "shell" | boolean;
+    /**
+     * (optional) If the tool allows, set the maximum number of tabs to open
+     */
+    maxTabs?: number;
+    /**
+     * Configuration filenames to try loading
+     */
+    configFiles?: string[];
+    toolID?: string;
+    toolName?: string;
+    toolVersion?: string;
+    scanID?: string;
+    ignoreHTTPSErrors: boolean;
+    perfMetrics: boolean;
+    engineMode: "DEFAULT" | "REMOTE" | "INJECT";
+};

package/mjs/lib/common/config/IConfig.js

@@ -0,0 +1,33 @@
+/******************************************************************************
+     Copyright:: 2023- 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.
+ *****************************************************************************/
+export var eAssertResult;
+(function (eAssertResult) {
+    eAssertResult[eAssertResult["ERROR"] = -1] = "ERROR";
+    eAssertResult[eAssertResult["PASS"] = 0] = "PASS";
+    eAssertResult[eAssertResult["BASELINE_MISMATCH"] = 1] = "BASELINE_MISMATCH";
+    eAssertResult[eAssertResult["FAIL"] = 2] = "FAIL";
+})(eAssertResult || (eAssertResult = {}));
+export var eRuleLevel;
+(function (eRuleLevel) {
+    eRuleLevel["violation"] = "violation";
+    eRuleLevel["potentialviolation"] = "potentialviolation";
+    eRuleLevel["recommendation"] = "recommendation";
+    eRuleLevel["potentialrecommendation"] = "potentialrecommendation";
+    eRuleLevel["manual"] = "manual";
+    eRuleLevel["pass"] = "pass";
+    eRuleLevel["ignored"] = "ignored";
+})(eRuleLevel || (eRuleLevel = {}));
+//# sourceMappingURL=IConfig.js.map

package/mjs/lib/common/config/IConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConfig.js","sourceRoot":"","sources":["../../../../../src-ts/lib/common/config/IConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;+EAc+E;AAI/E,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,oDAAU,CAAA;IACV,iDAAQ,CAAA;IACR,2EAAqB,CAAA;IACrB,iDAAQ,CAAA;AACZ,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAGD,MAAM,CAAN,IAAY,UAQX;AARD,WAAY,UAAU;IAClB,qCAAuB,CAAA;IACvB,uDAAyC,CAAA;IACzC,+CAAiC,CAAA;IACjC,iEAAmD,CAAA;IACnD,+BAAiB,CAAA;IACjB,2BAAa,CAAA;IACb,iCAAmB,CAAA;AACvB,CAAC,EARW,UAAU,KAAV,UAAU,QAQrB"}

package/mjs/lib/common/engine/IBounds.d.ts

@@ -0,0 +1,21 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+export type Bounds = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};

package/mjs/lib/common/engine/IBounds.js

@@ -0,0 +1,17 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+export {};
+//# sourceMappingURL=IBounds.js.map

package/mjs/lib/common/engine/IBounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBounds.js","sourceRoot":"","sources":["../../../../../src-ts/lib/common/engine/IBounds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;+EAc+E"}

package/mjs/lib/common/engine/IChecker.d.ts

@@ -0,0 +1,23 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+import { Guideline } from "./IGuideline.js";
+import { IEngineReport } from "./IReport.js";
+export interface IChecker {
+    addGuideline(guideline: Guideline): any;
+    getGuidelines(): Guideline[];
+    getGuidelineIds(): string[];
+    check(node: Node | Document, guidelineIds?: string | string[]): Promise<IEngineReport>;
+}

package/mjs/lib/common/engine/IChecker.js

@@ -0,0 +1,17 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+export {};
+//# sourceMappingURL=IChecker.js.map

package/mjs/lib/common/engine/IChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IChecker.js","sourceRoot":"","sources":["../../../../../src-ts/lib/common/engine/IChecker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;+EAc+E"}

package/mjs/lib/common/engine/IEngine.d.ts

@@ -0,0 +1,39 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+import { Rule } from "./IRule.js";
+export interface IEngine {
+    /**
+     * Perform a scan on a document or subtree
+     * @param rulesetIds Array of ruleset ids of rulesets to use for this scan
+     * @param root Document or subtree to scan
+     */
+    run(root: Document | Node, options?: {}): Promise<Report>;
+    enableRules(ruleIds: string[]): any;
+    getRule(ruleId: string): Rule;
+    getRulesIds(): string[];
+    getMessage(ruleId: string, ruleIdx: number | string, msgArgs?: string[]): string;
+    getHelp(ruleId: string, ruleIdx: number | string): string;
+    addRules(rule: Rule[]): any;
+    addRule(rule: Rule): any;
+    addNlsMap(map: NlsMap): any;
+    addHelpMap(map: NlsMap): any;
+}
+export type NlsMap = {
+    [key: string]: string[];
+};
+export type HelpMap = {
+    [key: string]: string[];
+};

package/mjs/lib/common/engine/IEngine.js

@@ -0,0 +1,17 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+export {};
+//# sourceMappingURL=IEngine.js.map

package/mjs/lib/common/engine/IEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEngine.js","sourceRoot":"","sources":["../../../../../src-ts/lib/common/engine/IEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;+EAc+E"}

package/mjs/lib/common/engine/IGuideline.d.ts

@@ -0,0 +1,53 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+import { eRulePolicy } from "./IRule.js";
+export declare enum eToolkitLevel {
+    LEVEL_ONE = "1",
+    LEVEL_TWO = "2",
+    LEVEL_THREE = "3",
+    LEVEL_FOUR = "4"
+}
+export declare enum eGuidelineCategory {
+    ACCESSIBILITY = "Accessibility",
+    DESIGN = "Design",
+    OTHER = "Other"
+}
+export declare enum eGuidelineType {
+    DEFAULT = "default",
+    EXTENSION = "extension"
+}
+export type Checkpoint = {
+    num: string;
+    scId?: string;
+    name: string;
+    wcagLevel: string;
+    summary: string;
+    rules?: Array<{
+        id: string;
+        reasonCodes?: string[];
+        level: eRulePolicy;
+        toolkitLevel: eToolkitLevel;
+        enabled?: boolean;
+    }>;
+};
+export type Guideline = {
+    id: string;
+    name: string;
+    category: eGuidelineCategory;
+    description: string;
+    type?: eGuidelineType;
+    checkpoints: Array<Checkpoint>;
+};

package/mjs/lib/common/engine/IGuideline.js

@@ -0,0 +1,34 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+export var eToolkitLevel;
+(function (eToolkitLevel) {
+    eToolkitLevel["LEVEL_ONE"] = "1";
+    eToolkitLevel["LEVEL_TWO"] = "2";
+    eToolkitLevel["LEVEL_THREE"] = "3";
+    eToolkitLevel["LEVEL_FOUR"] = "4";
+})(eToolkitLevel || (eToolkitLevel = {}));
+export var eGuidelineCategory;
+(function (eGuidelineCategory) {
+    eGuidelineCategory["ACCESSIBILITY"] = "Accessibility";
+    eGuidelineCategory["DESIGN"] = "Design";
+    eGuidelineCategory["OTHER"] = "Other";
+})(eGuidelineCategory || (eGuidelineCategory = {}));
+export var eGuidelineType;
+(function (eGuidelineType) {
+    eGuidelineType["DEFAULT"] = "default";
+    eGuidelineType["EXTENSION"] = "extension";
+})(eGuidelineType || (eGuidelineType = {}));
+//# sourceMappingURL=IGuideline.js.map

package/mjs/lib/common/engine/IGuideline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGuideline.js","sourceRoot":"","sources":["../../../../../src-ts/lib/common/engine/IGuideline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;+EAc+E;AAI/E,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACrB,gCAAe,CAAA;IACf,gCAAe,CAAA;IACf,kCAAiB,CAAA;IACjB,iCAAgB,CAAA;AACpB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,qDAA+B,CAAA;IAC/B,uCAAiB,CAAA;IACjB,qCAAe,CAAA;AACnB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACtB,qCAAmB,CAAA;IACnB,yCAAuB,CAAA;AAC3B,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}

package/mjs/lib/common/engine/IMapper.d.ts

@@ -0,0 +1,32 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+import { Bounds } from "./IBounds.js";
+export type IMapResult = {
+    node: Node;
+    namespace: string;
+    role: string;
+    rolePath: string;
+    attributes: {
+        [key: string]: string;
+    };
+    bounds?: Bounds;
+};
+export interface IMapper {
+    reset(node: Node): void;
+    openScope(node: Node): IMapResult[];
+    closeScope(node: Node): IMapResult[];
+    getNamespace(): string;
+}

package/mjs/lib/common/engine/IMapper.js

@@ -0,0 +1,17 @@
+/******************************************************************************
+     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.
+ *****************************************************************************/
+export {};
+//# sourceMappingURL=IMapper.js.map

package/mjs/lib/common/engine/IMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMapper.js","sourceRoot":"","sources":["../../../../../src-ts/lib/common/engine/IMapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;+EAc+E"}