@@ -405,7 +406,7 @@
diff --git a/package-lock.json b/package-lock.json
index 9a6ee33..a5e584c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -40,6 +40,7 @@
"@types/express": "^4.17.0",
"@types/multer": "^1.4.0",
"@types/node": "^22.20.5",
+ "axe-core": "^4.14.0",
"cohere-ai": "^8.0.0",
"electron": "^42.3.0",
"electron-builder": "^26.8.1",
@@ -3296,6 +3297,16 @@
"node": ">= 4.0.0"
}
},
+ "node_modules/axe-core": {
+ "version": "4.14.0",
+ "resolved": "https://registry.npmjs.org/axe-core/-/axe-core-4.14.0.tgz",
+ "integrity": "sha512-9WTZxEjsZ7b13TH8JPmbV2z8CHbl80/2hm3XPEG4JgNdQLK81IBRXmSxHfMAOkSqQeRxT/0dwNDz2GOm3zzpcQ==",
+ "dev": true,
+ "license": "MPL-2.0",
+ "engines": {
+ "node": ">=4"
+ }
+ },
"node_modules/balanced-match": {
"version": "4.0.4",
"resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz",
diff --git a/package.json b/package.json
index fac56df..b9cbe6d 100644
--- a/package.json
+++ b/package.json
@@ -38,7 +38,8 @@
"electron:build": "npm run build && electron-builder --mac --linux --win",
"electron:build:mac": "npm run build && electron-builder --mac",
"icons": "node scripts/build-icons.mjs",
- "bench": "node scripts/bench.mjs"
+ "bench": "node scripts/bench.mjs",
+ "a11y": "electron scripts/a11y-electron.cjs"
},
"build": {
"appId": "com.docfide.duct",
@@ -135,6 +136,7 @@
"@types/express": "^4.17.0",
"@types/multer": "^1.4.0",
"@types/node": "^22.20.5",
+ "axe-core": "^4.14.0",
"cohere-ai": "^8.0.0",
"electron": "^42.3.0",
"electron-builder": "^26.8.1",
diff --git a/scripts/a11y-electron.cjs b/scripts/a11y-electron.cjs
new file mode 100644
index 0000000..2160bc6
--- /dev/null
+++ b/scripts/a11y-electron.cjs
@@ -0,0 +1,92 @@
+// Accessibility check: starts Duct with a small sample library, opens every main screen in Chromium and runs axe-core
+// with the WCAG 2.2 A and AA rules. Exits 1 if any screen has a violation. Runs inside Electron, as the desktop app
+// does, so the pages are checked in the browser that shows them.
+//
+// npm run build && npm run a11y # also writes a11y-report.json
+//
+// What it can't check (the screen reader experience, whether the wording makes sense, keyboard flows end to end) is
+// in docs/accessibility.md, with how we test those by hand.
+const { app, BrowserWindow } = require('electron')
+const { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } = require('node:fs')
+const { tmpdir } = require('node:os')
+const { join } = require('node:path')
+
+const root = join(__dirname, '..')
+const TAGS = ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'wcag22a', 'wcag22aa']
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+async function main() {
+ const { Duct } = await import(join(root, 'dist/index.js'))
+ const { createServer } = await import(join(root, 'dist/server.js'))
+ const { default: JSZip } = await import('jszip')
+ const work = mkdtempSync(join(tmpdir(), 'duct-a11y-'))
+ const lib = join(work, 'Contracts')
+ mkdirSync(lib, { recursive: true })
+ writeFileSync(join(lib, 'Lease renewal.md'), '# Lease renewal\n\nThe tenant may terminate the lease on 90 days notice.\n\nRent is reviewed every two years.\n')
+ writeFileSync(join(lib, 'Board minutes.txt'), 'The board approved the lease renewal and the tax holiday application.')
+ const zip = new JSZip()
+ zip.file('[Content_Types].xml', 'Supply agreement. The supplier may terminate on 30 days notice.
Send feedback
Tell us what worked, what didn’t, or what you expected. It goes to the Duct team at Tensflare.
- +