@surea11y/core 1.2.0 → 1.4.0

package/src/policy/contracts.js

@@ -1,18 +0,0 @@
-'use strict';
-
-module.exports = {
-    POLICY_CONTRACTS: {
-        a11y: {
-            id: 'a11y',
-            allowedOutcomes: ['fail', 'pass', 'cantTell', 'notApplicable'],
-            allowedConfidence: ['high', 'medium', 'low'],
-            coerceManualFailToCantTell: true
-        },
-        generic: {
-            id: 'generic',
-            allowedOutcomes: ['fail', 'pass', 'cantTell', 'notApplicable'],
-            allowedConfidence: ['high', 'medium', 'low'],
-            coerceManualFailToCantTell: false
-        }
-    }
-};

package/src/policy/resolvePolicy.js

@@ -1,55 +0,0 @@
-'use strict';
-
-function resolvePolicy(POLICY_CONTRACTS, engineOptions) {
-    function normalizePolicyContract(POLICY_CONTRACTS, contract, fallbackId) {
-        const fallback = POLICY_CONTRACTS[fallbackId] || POLICY_CONTRACTS.a11y;
-        if (typeof contract === 'string') return POLICY_CONTRACTS[contract] || fallback;
-
-        if (contract && typeof contract === 'object') {
-            const allowedOutcomes = Array.isArray(contract.allowedOutcomes)
-                ? contract.allowedOutcomes.slice()
-                : fallback.allowedOutcomes.slice();
-
-            const allowedConfidence = Array.isArray(contract.allowedConfidence)
-                ? contract.allowedConfidence.slice()
-                : fallback.allowedConfidence.slice();
-
-            return {
-                id: (typeof contract.id === 'string' && contract.id.trim())
-                    ? contract.id.trim()
-                    : (fallback.id || fallbackId || 'custom'),
-                allowedOutcomes,
-                allowedConfidence,
-                coerceManualFailToCantTell:
-                    typeof contract.coerceManualFailToCantTell === 'boolean'
-                        ? contract.coerceManualFailToCantTell
-                        : !!fallback.coerceManualFailToCantTell
-            };
-        }
-
-        return fallback;
-    }
-
-    function normalizePolicyOverrides(policy) {
-        const p = (policy && typeof policy === 'object') ? policy : {};
-        return {
-            allowedOutcomes: Array.isArray(p.allowedOutcomes) ? p.allowedOutcomes.slice() : null,
-            allowedConfidence: Array.isArray(p.allowedConfidence) ? p.allowedConfidence.slice() : null,
-            coerceManualFailToCantTell: typeof p.coerceManualFailToCantTell === 'boolean' ? p.coerceManualFailToCantTell : null
-        };
-    }
-
-    const opts = (engineOptions && typeof engineOptions === 'object') ? engineOptions : {};
-    const contract = normalizePolicyContract(POLICY_CONTRACTS, opts.policyContract, 'a11y');
-    const ov = normalizePolicyOverrides(opts.policy);
-
-    return {
-        contractId: contract.id,
-        allowedOutcomes: ov.allowedOutcomes || contract.allowedOutcomes.slice(),
-        allowedConfidence: ov.allowedConfidence || contract.allowedConfidence.slice(),
-        coerceManualFailToCantTell:
-            ov.coerceManualFailToCantTell !== null ? ov.coerceManualFailToCantTell : !!contract.coerceManualFailToCantTell
-    };
-}
-
-module.exports = { resolvePolicy };

package/src/policy/schemas/engine-options.schema.json

@@ -1,103 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://a11ycore.dev/schemas/engine-options.schema.json",
-  "title": "EngineOptions",
-  "description": "Top-level configuration object for the engine runtime (v1).",
-  "type": "object",
-  "additionalProperties": true,
-  "properties": {
-    "locale": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Requested locale for i18n resolution (fallback to 'en' if missing)."
-    },
-    "includeShadowDom": {
-      "type": "boolean",
-      "description": "When true, queries traverse open shadow roots via helpers.queryAllSmart."
-    },
-    "excludeSelectors": {
-      "description": "CSS selector(s) that define subtrees to exclude from scanning.",
-      "oneOf": [
-        { "type": "string", "minLength": 1 },
-        { "type": "array", "items": { "type": "string", "minLength": 1 } }
-      ]
-    },
-
-    "contrast": {
-      "type": "object",
-      "additionalProperties": false,
-      "description": "Options that control contrast-related computations and assumptions.",
-      "properties": {
-        "mode": {
-          "type": "string",
-          "enum": ["strictConformance", "auditorAssist"],
-          "default": "strictConformance",
-          "description": "Controls whether the engine may apply explicit assumptions to reduce cantTell for contrast checks."
-        },
-        "rootCanvasFallback": {
-          "type": "string",
-          "minLength": 1,
-          "default": "#ffffff",
-          "description": "Used only when the effective root/canvas background is not computable and contrast.mode allows assumptions."
-        }
-      }
-    },
-
-    "rules": {
-      "type": "object",
-      "description": "Per-rule configuration. Keys are canonical ruleIds (e.g. 'img-alt-attr-present').",
-      "additionalProperties": {
-        "type": "object",
-        "additionalProperties": true
-      }
-    },
-    "policyContract": {
-      "oneOf": [
-        { "type": "string", "minLength": 1 },
-        { "$ref": "policy-contract.schema.json" }
-      ],
-      "description": "Policy contract identifier or inline policy contract object."
-    },
-    "policy": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "allowedOutcomes": {
-          "type": ["array", "null"],
-          "uniqueItems": true,
-          "items": {
-            "type": "string",
-            "enum": ["fail", "pass", "cantTell", "notApplicable"]
-          }
-        },
-        "allowedConfidence": {
-          "type": ["array", "null"],
-          "uniqueItems": true,
-          "items": {
-            "type": "string",
-            "enum": ["high", "medium", "low"]
-          }
-        },
-        "coerceManualFailToCantTell": {
-          "type": ["boolean", "null"]
-        }
-      },
-      "description": "Optional policy overrides applied on top of the resolved policy contract."
-    },
-    "output": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "includeSelector": {
-          "type": ["boolean", "null"],
-          "description": "When false, the engine will not populate occurrence.selector (kept as empty string)."
-        },
-        "includeHtml": {
-          "type": ["boolean", "null"],
-          "description": "When false, the engine will not populate occurrence.html (kept as empty string)."
-        }
-      },
-      "description": "Output shaping options for reporting/performance."
-    }
-  }
-}

package/src/policy/schemas/policy-contract.schema.json

@@ -1,40 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://a11ycore.dev/schemas/policy-contract.schema.json",
-  "title": "PolicyContract",
-  "description": "Defines the enforcement policy for rule outcomes and confidence handling (v1).",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "id": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Identifier for the policy contract."
-    },
-    "allowedOutcomes": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "items": {
-        "type": "string",
-        "enum": ["fail", "pass", "cantTell", "notApplicable"]
-      },
-      "description": "Allowed normalized outcomes for rules."
-    },
-    "allowedConfidence": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "items": {
-        "type": "string",
-        "enum": ["high", "medium", "low"]
-      },
-      "description": "Allowed confidence levels for rule results."
-    },
-    "coerceManualFailToCantTell": {
-      "type": "boolean",
-      "description": "Whether manual rules are prevented from producing a fail outcome (coerced to cantTell)."
-    }
-  },
-  "required": ["id", "allowedOutcomes", "allowedConfidence", "coerceManualFailToCantTell"]
-}