@surea11y/core 1.3.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,59 +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"]
-}