Bow Tie Kreative WCAG Grammar

Example rules

LAKA-WCAG-PRIMARY-TARGET-POLICY

product_policy change level: Minor Change execution: NOT_TESTED

Object

primary touch control — A concrete authorized component instance; bind before execution.

States: default focused

Applicability — IF

  • control.is_primary_touch_action

Requirement — THEN REQUIRE

  • AND
    • target.width_css_px_at_least {"value":44}
    • target.height_css_px_at_least {"value":44}

WCAG references

    Implementation

    Adopt a 44px minimum hit-area policy for this control category; record policy waivers separately.

    LAKA instantiation

    Object
    primary touch control in the declared test scope.
    Conditions
    Use the listed states with a recorded role, fixture and environment.
    Actions
    Execute the named task and its relevant recovery transitions.
    Tools
    Use repository test adapters and qualified manual review where needed.
    Resources
    Synthetic fixtures, a test environment, accountable owner and evidence store.
    Outcomes
    The primary control meets this product-specific 44px hit-area policy.
    Feedback
    Preserve observations and create a linked regression check after repair.
    Constraints
    Do not weaken security, erase information or reduce task functionality.
    Value
    Support independent operation of this task without the recorded barrier.
    Failure mode
    An assertion fails, remains unknown or regresses in a relevant state.

    Measurement lenses: Scope Detectability Propagation Reversibility

    Full record

    examples/laka-wcag-primary-target-policy.json
    {
      "id": "LAKA-WCAG-PRIMARY-TARGET-POLICY",
      "version": "1.0.0",
      "authority": "product_policy",
      "source_refs": [
        "S-TARGET-ENHANCED"
      ],
      "wcag_refs": [],
      "covers_full_criteria": false,
      "object": {
        "type": "primary touch control",
        "scope": "A concrete authorized component instance; bind before execution.",
        "states": [
          "default",
          "focused"
        ]
      },
      "applicability": {
        "predicate": "control.is_primary_touch_action"
      },
      "require": {
        "all": [
          {
            "predicate": "target.width_css_px_at_least",
            "parameters": {
              "value": 44
            }
          },
          {
            "predicate": "target.height_css_px_at_least",
            "parameters": {
              "value": 44
            }
          }
        ]
      },
      "exceptions": [],
      "implementation": "Adopt a 44px minimum hit-area policy for this control category; record policy waivers separately.",
      "laka": {
        "change_level": "Minor Change",
        "internal_variables": {
          "Object": "primary touch control in the declared test scope.",
          "Conditions": "Use the listed states with a recorded role, fixture and environment.",
          "Actions": "Execute the named task and its relevant recovery transitions.",
          "Tools": "Use repository test adapters and qualified manual review where needed.",
          "Resources": "Synthetic fixtures, a test environment, accountable owner and evidence store.",
          "Outcomes": "The primary control meets this product-specific 44px hit-area policy.",
          "Feedback": "Preserve observations and create a linked regression check after repair.",
          "Constraints": "Do not weaken security, erase information or reduce task functionality.",
          "Value": "Support independent operation of this task without the recorded barrier.",
          "Failure mode": "An assertion fails, remains unknown or regresses in a relevant state."
        },
        "meta_variables": [
          "Scope",
          "Detectability",
          "Propagation",
          "Reversibility"
        ]
      },
      "tests": [
        {
          "method": "mixed",
          "steps": [
            "Measure the actual hit region in CSS pixels.",
            "Check overlap and activation at the chosen viewport."
          ],
          "expected": "The primary control meets this product-specific 44px hit-area policy.",
          "evidence_required": [
            "build and test fixture",
            "rendered interaction observations",
            "reviewed manual evidence where required"
          ]
        }
      ],
      "metrics": [
        {
          "measure": "supported required assertions",
          "unit": "count",
          "decision": "No false or unresolved required assertions.",
          "denominator": "All applicable planned assertions for this bound instance."
        }
      ],
      "guardrails": [
        "Do not call this the universal AA minimum.",
        "Do not claim full AAA conformance."
      ],
      "owner": "Assigned accessibility implementation owner",
      "execution_status": "NOT_TESTED"
    }

    This rule as JSON →