chadtmiller.com/monolith
An atproto PDS
0
0
// The pages' colours, held to WCAG 2.2's AA contrast (1.4.3): text and
// what it is drawn on at least 4.5:1, in light and in dark
// (spec/OAUTH-PAGES.md, "Every page"). A colour is only ever text on some
// surfaces, which web/src/lib/contrast.json names; a surface with alpha is
// drawn over --bg, as the browser would. A new colour that is text goes
// there.
//
// node harness/contrast.mjs
//
// Prints each pair that falls short as `scheme: text on surface ratio`,
// failing if any.
import { readFileSync } from 'node:fs'
import { dirname, join, resolve } from 'node:path'
import { fileURLToPath } from 'node:url'
const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
const css = readFileSync(join(root, 'web/src/tokens.css'), 'utf8')
const { pairs } = JSON.parse(readFileSync(join(root, 'web/src/lib/contrast.json'), 'utf8'))
const AA = 4.5
/// The declarations of the block opening at the first `opener`, by name.
function block(opener) {
const at = css.indexOf(opener)
if (at < 0) throw new Error(`tokens.css has no ${opener.trim()}`)
let depth = 0
let i = css.indexOf('{', at)
const start = i
for (; i < css.length; i++) {
if (css[i] === '{') depth++
else if (css[i] === '}' && --depth === 0) break
}
const body = css.slice(start, i)
return Object.fromEntries([...body.matchAll(/^\s*--([\w-]+):\s*([^;]+);/gm)].map((m) => [m[1], m[2].trim()]))
}
const light = block(':root {')
const dark = { ...light, ...block('@media (prefers-color-scheme: dark) {') }
function colour(env, value) {
value = value.trim()
let m
if ((m = value.match(/^var\(--([\w-]+)\)$/))) {
if (!(m[1] in env)) throw new Error(`no token --${m[1]}`)
return colour(env, env[m[1]])
}
if ((m = value.match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/i))) {
const h = m[1].length === 3 ? [...m[1]].map((c) => c + c).join('') : m[1]
return [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16)).concat(1)
}
if ((m = value.match(/^rgb\((\d+) (\d+) (\d+)(?: \/ ([\d.]+))?\)$/))) return [+m[1], +m[2], +m[3], m[4] === undefined ? 1 : +m[4]]
throw new Error(`cannot read ${value}`)
}
const over = (top, under) => [0, 1, 2].map((i) => top[i] * top[3] + under[i] * (1 - top[3])).concat(1)
const luminance = ([r, g, b]) => {
const [lr, lg, lb] = [r, g, b].map((c) => ((c /= 255) <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4))
return 0.2126 * lr + 0.7152 * lg + 0.0722 * lb
}
const ratio = (a, b) => {
const [x, y] = [luminance(a), luminance(b)].sort((p, q) => q - p)
return (x + 0.05) / (y + 0.05)
}
const problems = []
let n = 0
for (const [scheme, env] of Object.entries({ light, dark })) {
const bg = colour(env, 'var(--bg)')
for (const { texts, on } of pairs)
for (const text of texts)
for (const surface of on) {
n++
const under = over(colour(env, `var(--${surface})`), bg)
const r = ratio(over(colour(env, `var(--${text})`), under), under)
if (r < AA) problems.push(`${scheme}: --${text} on --${surface} ${r.toFixed(2)}:1, under ${AA}:1`)
}
}
for (const p of problems) console.log(p)
if (problems.length) process.exit(1)
console.log(`contrast: light and dark, ${n} pairs, every text at least ${AA}:1 on what it is drawn on`)