npm.io
2.9.0 • Published 9h ago

@holmdigital/standards

Licence
MIT
Version
2.9.0
Deps
1
Size
4.2 MB
Vulns
0
Weekly
0
Stars
9
SummaryDependencyVersions

@holmdigital/standards

npm version License: MIT TypeScript Downloads

Full documentation: holmdigital.se/wcag-verktyg/standards

Machine-readable regulatory database for WCAG, EN 301 549, DOS-lagen, EU Legal Frameworks (WAD/EAA), Australian DDA, U.S. ADA (Title II / Title III / Section 508), and U.S. HHS Section 504 (Rehabilitation Act, healthcare/HHS-funded private sector).

Why this package?

This package serves as the Single Source of Truth for accessibility compliance mapping in the HolmDigital ecosystem. It eliminates the need to manually cross-reference standard documents by providing:

  1. WCAG 2.1 AA + WCAG 2.2 Phase 1 Criteria (Technical Base). The database covers WCAG 2.1 AA (the level required by EN 301 549 V3.2.1) plus the first WCAG 2.2 criteria (2.5.8 Target Size, 2.5.7 Dragging Movements, 2.4.11 Focus Not Obscured). Note: the legal floor in the EU stays WCAG 2.1 AA via EN 301 549 V3.2.1; the WCAG 2.2 criteria are forward-looking coverage, not a current legal requirement.
  2. EN 301 549 (EU Standard Mapping)
  3. National Laws (Specific legal references for SE, NL, DE, IT, PT, PL, AU, etc.)
  4. Legal Frameworks (WAD 2016/2102, EAA 2019/882, DDA 1992 Australia, ADA 1990 USA, REHAB 1973 USA / Section 504)
  5. Nordic Authority Data (Digg, PTS, UU-tilsynet, etc.)

It allows developers to query: "Which law mandates WCAG 1.4.3 in Sweden?" and get the exact legal paragraph (Lag (2018:1937) 12 §).

For the full regulatory database details, API reference, and legal framework mappings (WAD/EAA), see the Standards Library Catalog.

Installation

npm install @holmdigital/standards

Features

  • WCAG 2.2 Phase 1: 2.5.8 Target Size (axe-mapped, automatically detectable) plus 2.5.7 Dragging Movements and 2.4.11 Focus Not Obscured (manual checks). 49 convergence rules in total. These three criteria are forward-looking documentation, not a legal requirement: the legal floor stays WCAG 2.1 AA via EN 301 549 V3.2.1, and they carry dosLagenApplies false with no WAD or EAA legal context.
  • Multi-Language Support (12 rule locale databases):
    • en (Generic / EU baseline)
    • en-gb (UK / PSBAR)
    • en-us (USA / Section 508 & ADA)
    • en-ca (Canada / AODA + ACA)
    • sv (Sweden / DOS-lagen)
    • no (Norway / Forskrift om universell utforming av IKT)
    • fi (Finland / 306/2019)
    • da (Denmark / Tilgængelighed)
    • de (Germany / BITV 2.0)
    • fr (France / RGAA)
    • es (Spain / UNE 139803)
    • nl (Netherlands / Digitoegankelijk)
    • it, pt, pl, au — national law metadata only; rule text uses en
  • Risk Assessment: DIGG-aligned risk levels (critical, high, medium, low).
  • Remediation: Maps issues to @holmdigital/components for fixing.
  • Legal Frameworks: WAD (EU public sector), EAA (EU private sector), DDA (Australia — both sectors), ADA (USA — Title II public, Title III private; Section 508 remains separate for federal agencies), and REHAB (USA — Section 504 of the Rehabilitation Act for HHS-funded private organisations).
  • Sector-Aware Enforcement: getEnforcementBody(country, 'public'|'private') returns the correct authority based on WAD, EAA, DDA, ADA, or REHAB sector.
  • Compliance Deadlines: Optional NationalLaw.complianceDeadlines field captures entity-size-based deadlines via a discriminated union (populationThreshold for ADA Title II, employeeThreshold for HHS Section 504). Populated for ADA Title II (2026-04-24 for 50k+ populations, 2027-04-24 otherwise) and HHS Section 504 (2026-05-11 for 15+ employees, 2027-05-10 otherwise).
  • Statutory Exemptions: New NationalLaw.exemptions.microbusiness field encodes the EAA Article 4(5) exemption (services-providing organisations with <10 employees AND ≤2M EUR turnover) on all 7 EAA private-sector entries.
  • Schema Validation: schema/national-laws-schema.json (JSON Schema Draft-07) provides structural validation for the national-laws data file; the test suite validates on every run via ajv.
  • Authorities & Enforcement: Shared database of regulatory bodies (ENFORCEMENT_BODIES) covering 16 countries + EU (17 jurisdictions total) — Nordic, UK, US, CA, AU, and the EU Commission (DG CNECT / DG JUST).

Usage

Basic Mapping
import { 
  getEN301549Mapping, 
  getDOSLagenReference 
} from '@holmdigital/standards';

// Get EN 301 549 Mapping
const mapping = getEN301549Mapping('1.4.3');
// { en301549Criteria: "9.1.4.3", ... }

// Get Swedish Law Reference
const ref = getDOSLagenReference('1.4.3', 'sv');
// "EN 301 549 V3.2.1, WCAG 2.1 Level AA required"
EU Legal Framework Queries
import { 
  getRulesByFramework,
  getRulesBySector,
  getLegalFramework,
  getNordicAuthorities,
  getEAADeadlineRules
} from '@holmdigital/standards';

// Get all rules applicable to WAD (Web Accessibility Directive)
const wadRules = getRulesByFramework('WAD');

// Get rules for public sector
const publicRules = getRulesBySector('public');

// Get rules with EAA 2025 deadline
const eaaRules = getEAADeadlineRules();

// Get WAD directive details
const wad = getLegalFramework('WAD');
// { id: "2016/2102", name: "Web Accessibility Directive", ... }

// Get Nordic authorities
const authorities = getNordicAuthorities();
// [{ id: "se-digg", name: "Myndigheten för digital förvaltning (Digg)", ... }]
Statement Tools
import { getStatementTools } from '@holmdigital/standards';

// Get accessibility statement generators
const tools = getStatementTools();
// [{ id: "digg-generator", url: "https://webbriktlinjer.se/...", ... }]
National Laws & Sanctions
import { 
  getNationalLaws,
  getNationalLaw,
  getSanctions,
  getMaxSanction,
  getSectorAuthorities
} from '@holmdigital/standards';

// Get all laws for Sweden
const seLaws = getNationalLaws('SE');
// [{ id: "dos-lagen", law: "DOS-lagen", ... }, { id: "lptt", law: "LPTT", ... }]

// Get sanctions for a specific law
const sanctions = getSanctions('lptt', 'SE');
// { type: "Sanktionsavgift", maxAmount: 10000000, currency: "SEK" }

// Get maximum sanction for a country
const maxSanction = getMaxSanction('DE');
// { law: "BFSG", amount: 500000, currency: "EUR" }

// Get sector-specific EAA authorities
const sectors = getSectorAuthorities('SE');
// [{ authority: "Konsumentverket", responsibility: "Transport" }, ...]

Supported Countries & Maximum Sanctions

Country WAD Law EAA Law Max Sanction
SE DOS-lagen LPTT 1M SEK (Vite) / 10M SEK (EAA)
NL Digitoegankelijk Warenwet 900k EUR
DE BITV 2.0 BFSG 500k EUR
FR RGAA - 300k EUR
ES Real Decreto - 1M EUR
IE S.I. 358/2020 - 60k EUR
NO IKT-forskrift - Daily fines
FI 306/2019 EAA Vite
DK Tilgængelighed - Fines
IT Legge 4/2004 D.Lgs. 82/2024 Up to 5% of turnover
PT DL 83/2018 DL 101-D/2023 44k EUR
PL Ustawa o dostępności cyfrowej Ustawa o dostępności produktów i usług 100k PLN
GB PSBAR - Unlawful Act Notice
US Section 508 (federal, GSA) / ADA Title II (state+local, DOJ) ADA Title III (private, DOJ) + Section 504 HHS (healthcare/HHS-funded, OCR) Up to $150k/violation (Title III) + funding suspension (Section 504) + civil rights lawsuits
CA AODA (Ontario) ACA (federal) $100k per day
AU DDA 1992 — (DDA covers both sectors) Court-determined (AHRC complaint)

API Reference

Core Functions
Function Description
getEN301549Mapping(criteria, lang?) Get EN 301 549 mapping for WCAG criteria
getDOSLagenReference(criteria, lang?) Get DOS-lagen reference for criteria
getAllConvergenceRules(lang?) Get all convergence rules
getConvergenceRule(ruleId, lang?) Get specific rule by ID
searchRulesByTags(tags, lang?) Search rules by tags
Type Exports
Type Description
EnrichedReport Extended RegulatoryReport with failingNodes and legalContext
FailingNode Target selector, HTML snippet, and failure summary for a single failing element
LegalContext WAD/EAA applicability, sectors, articles, and EAA deadline
RegulatoryReport Core scan result with WCAG criteria, EN 301 549, remediation, and insight
HolmDigitalInsight DIGG risk, EAA impact, Swedish interpretation, and common mistakes
ConvergenceRule Full convergence rule with remediation, testability, and legal context
DiggRisk 'low' | 'medium' | 'high' | 'critical'
EAAImpact 'none' | 'low' | 'medium' | 'high' | 'critical'
EU Legal Framework Functions
Function Description
getRulesByFramework(framework, lang?) Get rules by WAD, EAA, or DDA
getRulesBySector(sector, lang?) Get rules by public/private sector
getLegalFrameworks() Get all legal frameworks
getLegalFramework(id) Get specific framework (WAD/EAA/DDA)
getNordicAuthorities() Get all Nordic authorities
getNordicAuthority(id) Get authority by ID
getNordicAuthoritiesByCountry(country) Get authorities by country
getStatementTools() Get all registered statement generator tools
getStatementToolsByCountry(country) Get statement generator tools for a specific country
getEAADeadlineRules(lang?) Get rules with EAA deadlines
National Laws & Sanctions Functions
Function Description
getNationalLaws(country) Get all laws for a country
getNationalLaw(id, country?) Get specific law by ID
getNationalLawByFramework(framework, country?) Get law by WAD/EAA/DDA
getEnforcementBody(country, sector?) Get enforcement authority name
getSanctions(lawId, country?) Get sanctions for a law
getMaxSanction(country?) Get maximum sanction amount
getSectorAuthorities(country?) Get EAA sector authorities
getDatabaseStats(lang?) Get rule counts and coverage stats
Constants
Export Type Description
ENFORCEMENT_BODIES Record<Country, string> WAD (public sector) enforcement authority per jurisdiction (17 entries incl. EU)
ENFORCEMENT_BODIES_DETAILED Record<Country, { wad: string; eaa: string }> Sector-split enforcement bodies — .wad for public, .eaa for private/EAA

License

MIT Holm Digital AB

Keywords

accessibilitya11ywcagen-301-549en301549eaados-lagenstandardsregulatorycompliancelegislationregulationsection508adaaodabitvrgaadigitoegankelijk