From f3b2e0d7f3b8f3196169ffe79033c8a229afa9fe Mon Sep 17 00:00:00 2001 From: Willie Chalmers III Date: Wed, 23 Sep 2026 17:19:38 -0700 Subject: [PATCH 1/5] feat(site): Print a paper bingo card from the Bingo page People who don't use a smartphone, and partners who hand out cards at events, can now print the same card everyone plays on their phones. The Bingo page has a Print section under "Share your card" with "Include my marks", "Large print (2 pages)" and "Print a card". Both paper layouts are built into the page from the square list, so the printed text always matches the card on screen. The print styles show only the chosen layout: a one-page, black-and-white card on US Letter paper with every square's full text, or a two-page large-print list with rows 3 to 5 on the second page. With "Include my marks" ticked, marked squares print with a check mark and a thick border and the progress line prints under the dates. Without JavaScript, the browser's own Print still prints the blank card. The old /bingo/print page redirects to /bingo. The Bingo page now sends a `bingochange` event with the marks and the progress line after loading and after every change, which is all the Print section reads. The card's QR code opens lvwwd.org/bingo at error correction level M. The build-time QR encoder now splits longer codes into blocks as the standard says and picks the mask with the lowest penalty, so partner links can use level M too. A test decoder written apart from the encoder reads every code back and checks its error correction. Co-Authored-By: Claude Opus 5.5 --- apps/site/public/_redirects | 2 + apps/site/public/scripts/bingo-print.js | 70 +- apps/site/public/scripts/bingo.js | 17 +- .../site/src/components/BingoPrintSheet.astro | 350 ++++++++++ apps/site/src/lib/bingo.ts | 8 +- apps/site/src/lib/qrcode.ts | 649 ++++++++++-------- apps/site/src/pages/bingo.astro | 67 +- apps/site/src/pages/bingo/print.astro | 185 ----- apps/site/tests/e2e/bingo-print.spec.ts | 181 +++++ apps/site/tests/qrcode.test.ts | 252 +++++++ 10 files changed, 1288 insertions(+), 493 deletions(-) create mode 100644 apps/site/src/components/BingoPrintSheet.astro delete mode 100644 apps/site/src/pages/bingo/print.astro create mode 100644 apps/site/tests/e2e/bingo-print.spec.ts create mode 100644 apps/site/tests/qrcode.test.ts diff --git a/apps/site/public/_redirects b/apps/site/public/_redirects index 6ed0a7b..698c3b4 100644 --- a/apps/site/public/_redirects +++ b/apps/site/public/_redirects @@ -1,2 +1,4 @@ # Old participant kit pages, from before sign-up replaced the pledge. /pledged/* /my-week 301 +# The paper bingo card moved onto the Bingo page itself. +/bingo/print /bingo 301 diff --git a/apps/site/public/scripts/bingo-print.js b/apps/site/public/scripts/bingo-print.js index 55a58dd..c095142 100644 --- a/apps/site/public/scripts/bingo-print.js +++ b/apps/site/public/scripts/bingo-print.js @@ -1,9 +1,65 @@ -// Progressive enhancement for the "Print this card" button on -// /bingo/print. Printing already works from the browser's own menu with -// JavaScript off (Ctrl+P / Cmd+P on a computer, Share, then Print on an -// iPhone) — this button is a convenience, not a requirement. +/** + * The Bingo page's Print section: "Include my marks", "Large print + * (2 pages)" and "Print a card". The paper card itself is built into the + * page (src/components/BingoPrintSheet.astro) and printed by the print + * styles, so the browser's own Print menu prints the same card with the + * same choices, and prints the blank card with JavaScript off. + * + * It reads the card only from the `bingochange` event that /scripts/bingo.js + * sends on load and after every change, { marks, progress, locked }, so it + * must load before bingo.js. It makes no request and stores nothing. + */ (() => { - const button = document.querySelector('[data-bingo-print-button]'); - if (!button) return; - button.addEventListener('click', () => window.print()); + const FREE = 12; + const controls = document.querySelector('[data-bingo-print-controls]'); + const sheet = document.querySelector('[data-bingo-print-sheet]'); + if (!controls || !sheet) return; + + const marksField = controls.querySelector('[data-print-marks-field]'); + const marksBox = controls.querySelector('[data-print-marks]'); + const largeBox = controls.querySelector('[data-print-large]'); + const button = controls.querySelector('[data-print-button]'); + const squares = sheet.querySelectorAll('[data-print-square]'); + const progressLines = sheet.querySelectorAll('[data-print-progress]'); + + let latest = { marks: [], progress: '' }; + + function apply() { + const include = Boolean(marksBox?.checked) && !marksField?.hidden; + sheet.toggleAttribute('data-include-marks', include); + squares.forEach((square) => { + const marked = include && Boolean(latest.marks[Number(square.dataset.printSquare)]); + square.toggleAttribute('data-marked', marked); + }); + progressLines.forEach((line) => { + line.textContent = include ? latest.progress : ''; + }); + } + + document.addEventListener('bingochange', (event) => { + const detail = event.detail ?? {}; + latest = { + marks: Array.isArray(detail.marks) ? detail.marks : [], + progress: typeof detail.progress === 'string' ? detail.progress : '', + }; + const anyMarked = latest.marks.some((marked, i) => i !== FREE && marked); + if (marksField && marksBox) { + if (anyMarked && marksField.hidden) marksBox.checked = false; + if (!anyMarked) marksBox.checked = false; + marksField.hidden = !anyMarked; + } + apply(); + }); + + marksBox?.addEventListener('change', apply); + largeBox?.addEventListener('change', () => { + sheet.dataset.layout = largeBox.checked ? 'large' : 'card'; + }); + button?.addEventListener('click', () => window.print()); + + // A page restored from the back button may keep old ticks; start clean. + if (marksBox) marksBox.checked = false; + if (largeBox) largeBox.checked = false; + sheet.dataset.layout = 'card'; + controls.hidden = false; })(); diff --git a/apps/site/public/scripts/bingo.js b/apps/site/public/scripts/bingo.js index f625bb8..58ebf0c 100644 --- a/apps/site/public/scripts/bingo.js +++ b/apps/site/public/scripts/bingo.js @@ -1,8 +1,8 @@ // Digital Transit Bingo's interactivity: marking squares, detecting lines, // switching between Card view and List view, saving progress on the device, -// and the clear/share/print actions. Lives in public/scripts because the -// site's Content Security Policy is `script-src 'self'`, which blocks -// inline scripts — see the comment in bingo.astro. This file is served +// clearing the card, and sharing a link to it. +// Lives in public/scripts because the site's Content Security Policy is +// `script-src 'self'`, which blocks inline scripts. This file is served // as-is (no bundler), so it can't import from src/lib/bingo.ts; the square // layout below (5x5, free square at index 12) must stay in sync with that // file if the card ever changes. @@ -11,6 +11,11 @@ // /scripts/bingo-sync.js also keeps the card on their sign-up, so it // follows them to another phone; it talks to this file through // window.lvwwdBingo and the lvwwd:bingo-saved event. +// +// After loading and after every change, this file sends a `bingochange` +// event on the document with { marks, progress, locked }: the 25 marks, the +// progress line's text, and whether the week is over. The Print section +// (/scripts/bingo-print.js) listens to it, so that script loads first. (() => { const STORAGE_KEY = 'lvwwd_bingo_2026'; const VIEW_KEY = 'lvwwd_bingo_view'; @@ -68,7 +73,6 @@ const dialogShareBtn = document.querySelector('[data-bingo-dialog-share]'); const confettiEl = document.querySelector('[data-bingo-confetti]'); const viewButtons = Array.from(document.querySelectorAll('[data-bingo-view-btn]')); - // --- storage ------------------------------------------------------- function checkStorageAvailable() { try { @@ -212,6 +216,11 @@ function updateProgress(s) { if (progressEl) progressEl.textContent = progressText(s); + document.dispatchEvent( + new CustomEvent('bingochange', { + detail: { marks: s.slice(), progress: progressText(s), locked: isAfterWeek }, + }), + ); } function cellIndex(cell) { diff --git a/apps/site/src/components/BingoPrintSheet.astro b/apps/site/src/components/BingoPrintSheet.astro new file mode 100644 index 0000000..adae3d7 --- /dev/null +++ b/apps/site/src/components/BingoPrintSheet.astro @@ -0,0 +1,350 @@ +--- +import { Icon } from 'astro-icon/components'; +import { BINGO_SQUARES } from '../lib/bingo'; +import { encodeQr, qrPathData, QUIET_ZONE } from '../lib/qrcode'; + +// The paper bingo card. Both layouts are built from the same square list as +// the card on screen, so the printed text always matches it. They are +// hidden on screen and are the only thing on the Bingo page that prints: +// the one-page card on US Letter paper, or the two-page large-print list +// when "Large print (2 pages)" is ticked. /scripts/bingo-print.js switches +// the layout and, when "Include my marks" is ticked, marks the squares. +// Without JavaScript, the browser's own Print prints the blank card. + +const qr = encodeQr('https://lvwwd.org/bingo'); +const qrSide = qr.size + QUIET_ZONE * 2; +const qrPath = qrPathData(qr, QUIET_ZONE); + +const DATES = 'Week Without Driving Las Vegas · October 1 to 8, 2026'; +const HOW_TO_PLAY_CARD = + "Mark a square with a pen when you've done it. Five in a row, down a column, or corner to corner is a bingo. The middle square is free. Every way of getting around counts: by bus, walking or rolling, biking, or getting a ride. If you still have to drive, you haven't failed."; +const HOW_TO_PLAY_LARGE = + "Tick a box with a pen when you've done it. A bingo is all five squares in one row, or the same numbered square in all five rows, or a diagonal: square 1 in row 1, square 2 in row 2, and so on to square 5 in row 5, or square 5 in row 1, square 4 in row 2, and so on to square 1 in row 5. Square 3 in row 3 is free. Every way of getting around counts: by bus, walking or rolling, biking, or getting a ride. If you still have to drive, you haven't failed."; +const QR_CAPTION = 'Scan to play on a phone: lvwwd.org/bingo'; +const FOOTER = [ + 'Share your card, find bus stops near you, and read our guides at lvwwd.org.', + 'Giveaway: sign up free at lvwwd.org/giveaway with an email address or phone number. Share your trip to enter: post a photo of a trip you took without driving and tag @lasvegasfortransit, then send it on My week. Each day you share one is an entry, up to 8. No purchase or post necessary. No social media? You can enter by mail. Official Rules: lvwwd.org/giveaway/rules. Every square counts, prize or not.', + 'Week Without Driving Las Vegas is run by Las Vegans for Better Transit. Questions: wwd@lasvegasfortransit.org', +]; +const rows = [1, 2, 3, 4, 5].map((row) => + BINGO_SQUARES.map((square, index) => ({ ...square, index })).filter((s) => s.row === row), +); +--- + +
+
+
+

Digital Transit Bingo

+

Name:

+
+

{DATES}

+

+

How to play {HOW_TO_PLAY_CARD}

+
+ { + BINGO_SQUARES.map((square, index) => + square.free ? ( +
+ +

WEEK WITHOUT DRIVING

+

Free square

+
+ ) : ( +
+ +

{square.fullText}

+
+ ), + ) + } +
+
+
+ + + + +
{QR_CAPTION}
+
+
+ {FOOTER.map((line) =>

{line}

)} +
+
+
+ +
+
+

Digital Transit Bingo

+

Name:

+
+

{DATES}

+

+

How to play {HOW_TO_PLAY_LARGE}

+ { + rows.map((squares, r) => ( +
+

Row {r + 1}

+
    + {squares.map((square) => + square.free ? ( +
  • + + + + 3. Week Without Driving (free square) +
    • + ) : ( +
  • + + + + + {square.col}. {square.fullText} + +
    • + ), + )} +
+
+ )) + } +
+
+ + + + +
{QR_CAPTION}
+
+
+ {FOOTER.map((line) =>

{line}

)} +
+
+
+
+ + diff --git a/apps/site/src/lib/bingo.ts b/apps/site/src/lib/bingo.ts index 7a93b41..97543f4 100644 --- a/apps/site/src/lib/bingo.ts +++ b/apps/site/src/lib/bingo.ts @@ -1,8 +1,8 @@ // Digital Transit Bingo's one fixed card. Every visitor plays the same 25 -// squares, so this list is the single source of truth for the on-screen -// card (/bingo) and the printed card (/bingo/print). Copy is exact from -// the Feature "Let participants mark a Digital Transit Bingo card on their -// phone" (bingo/play-bingo.md) — do not paraphrase. +// squares, so this list is the single source of truth for the card on +// screen, the paper card printed from the Bingo page, and the share +// picture's short labels. Keep the wording exactly as it is: players on +// paper and on phones compare cards square by square. // // Squares are listed row-major, row 1 column 1 first, so `BINGO_SQUARES[i]` // sits at row `Math.floor(i / 5) + 1`, column `(i % 5) + 1`. The free diff --git a/apps/site/src/lib/qrcode.ts b/apps/site/src/lib/qrcode.ts index e086f96..0f53f61 100644 --- a/apps/site/src/lib/qrcode.ts +++ b/apps/site/src/lib/qrcode.ts @@ -1,362 +1,449 @@ -// A from-scratch, dependency-free QR Code encoder (ISO/IEC 18004), used only -// at build time (Astro's static render) to produce an inline SVG path — no -// client-side JavaScript, no npm dependency. There is no QR library in the -// pnpm catalog (see pnpm-workspace.yaml), and adding one there would touch a -// file every worktree shares, so this file is the "pre-render the code as an -// SVG at build time" fallback named in the partners build brief. +// A small QR Code encoder (ISO/IEC 18004) used only when the site is built, +// so no QR library ships to phones. It makes the printed bingo card's code +// and every partner's link code as vector paths, and the partner PNG files. // -// Scope: byte mode only, versions 1-5, and only the (version, error -// correction level) combinations that use a single Reed-Solomon block, so no -// codeword interleaving is needed. That covers every string this site draws -// a QR code for: lvwwd.org links, with or without a `?ref=` partner -// slug up to the roster's 40-character limit. A fixed mask pattern (0) is -// used instead of evaluating all eight masks for the lowest penalty score; -// any valid mask produces a fully scannable code, so this trades a little -// theoretical robustness for a much smaller, easier-to-verify implementation. +// Scope: byte mode, versions 1 to 10, any error correction level. The +// caller names the level, and every code the site prints uses level M (it +// still scans with about 15 percent of it damaged or covered), so a longer +// link gets a bigger code rather than a weaker one. Codewords are split into +// blocks and interleaved as the standard says, and the mask with the lowest +// penalty score is chosen, like any other encoder. // -// Verified against the `jsQR` decoder for several lvwwd.org URL lengths -// during development (see the build report for how); re-run that check if -// this file changes. +// tests/qrcode.test.ts reads every code back with its own small decoder and +// checks the error correction, so a change here that breaks a code fails +// the tests. -type EcLevel = 'L' | 'M' | 'Q' | 'H'; +export type EcLevel = 'L' | 'M' | 'Q' | 'H'; -/** Reads `arr[i]`, narrowing away `undefined`. Throws only on a real bug. */ -function idx(arr: readonly T[], i: number): T { - const value = arr[i]; - if (value === undefined) throw new Error(`qrcode: index ${i} out of range`); - return value; +export interface QrCode { + /** Modules along one side, without the quiet zone. */ + size: number; + /** `matrix[row][column]` is true for a dark module. */ + matrix: boolean[][]; + version: number; + level: EcLevel; + mask: number; } -function idx2(arr: readonly (readonly T[])[], row: number, col: number): T { - return idx(idx(arr, row), col); +/** The white border every code needs around it, in modules. */ +export const QUIET_ZONE = 4; + +const MAX_VERSION = 10; + +// Per version (index 1 to 10): error correction codewords in each block, and +// the number of blocks, for each level. From the standard's table 9. +const ECC_PER_BLOCK: Record = { + L: [0, 7, 10, 15, 20, 26, 18, 20, 24, 30, 18], + M: [0, 10, 16, 26, 18, 24, 16, 18, 22, 22, 26], + Q: [0, 13, 22, 18, 26, 18, 24, 18, 22, 20, 24], + H: [0, 17, 28, 22, 16, 22, 28, 26, 26, 24, 28], +}; +const BLOCKS: Record = { + L: [0, 1, 1, 1, 1, 1, 2, 2, 2, 2, 4], + M: [0, 1, 1, 1, 2, 2, 4, 4, 4, 5, 5], + Q: [0, 1, 1, 2, 2, 4, 4, 6, 6, 8, 8], + H: [0, 1, 1, 2, 4, 4, 4, 5, 6, 8, 8], +}; +const FORMAT_LEVEL_BITS: Record = { L: 1, M: 0, Q: 3, H: 2 }; + +/** Reads `list[i]`, which the tables above guarantee exists. */ +function at(list: readonly number[], i: number): number { + const value = list[i]; + if (value === undefined) throw new Error(`qrcode: no table entry ${i}`); + return value; } -const GF_EXP: number[] = new Array(256).fill(0); -const GF_LOG: number[] = new Array(256).fill(0); -(() => { - let x = 1; - for (let i = 0; i < 255; i++) { - GF_EXP[i] = x; - GF_LOG[x] = i; - x <<= 1; - if (x & 0x100) x ^= 0x11d; - } - GF_EXP[255] = idx(GF_EXP, 0); -})(); +// ---- Reed-Solomon over GF(256) with the polynomial 0x11d ---------------- -function gfMul(a: number, b: number): number { - if (a === 0 || b === 0) return 0; - return idx(GF_EXP, (idx(GF_LOG, a) + idx(GF_LOG, b)) % 255); +const EXP: number[] = []; +const LOG: number[] = new Array(256).fill(0); +for (let i = 0, x = 1; i < 255; i++) { + EXP.push(x); + LOG[x] = i; + x <<= 1; + if (x & 0x100) x ^= 0x11d; } -function multiplyPolys(a: number[], b: number[]): number[] { - const result: number[] = new Array(a.length + b.length - 1).fill(0); - for (let i = 0; i < a.length; i++) { - for (let j = 0; j < b.length; j++) { - result[i + j] = idx(result, i + j) ^ gfMul(idx(a, i), idx(b, j)); - } - } - return result; +function gfMultiply(a: number, b: number): number { + return a === 0 || b === 0 ? 0 : at(EXP, (at(LOG, a) + at(LOG, b)) % 255); } -function generatorPoly(degree: number): number[] { - let g = [1]; +/** The generator polynomial's coefficients, highest power first, without the leading 1. */ +function generator(degree: number): number[] { + let poly = [1]; for (let i = 0; i < degree; i++) { - g = multiplyPolys(g, [1, idx(GF_EXP, i)]); + const next = new Array(poly.length + 1).fill(0); + poly.forEach((c, j) => { + next[j] = at(next, j) ^ c; + next[j + 1] = at(next, j + 1) ^ gfMultiply(c, at(EXP, i)); + }); + poly = next; } - return g; + return poly.slice(1); } -function rsEncode(dataCodewords: number[], eccCount: number): number[] { - const gen = generatorPoly(eccCount); - const remainder: number[] = new Array(eccCount).fill(0); - for (const d of dataCodewords) { - const factor = d ^ idx(remainder, 0); - remainder.shift(); - remainder.push(0); - if (factor !== 0) { - for (let i = 0; i < gen.length - 1; i++) { - remainder[i] = idx(remainder, i) ^ gfMul(idx(gen, i + 1), factor); - } - } +function remainder(data: readonly number[], degree: number): number[] { + const gen = generator(degree); + const result = new Array(degree).fill(0); + for (const byte of data) { + const factor = byte ^ at(result, 0); + result.shift(); + result.push(0); + gen.forEach((c, i) => { + result[i] = at(result, i) ^ gfMultiply(c, factor); + }); } - return remainder; + return result; } -interface VersionInfo { - size: number; - total: number; - align: number | null; +// ---- Sizes ---------------------------------------------------------------- + +function alignmentCenters(version: number): number[] { + if (version === 1) return []; + const count = Math.floor(version / 7) + 2; + const size = version * 4 + 17; + const step = Math.ceil((version * 4 + 4) / (count * 2 - 2)) * 2; + const centers = [6]; + for (let pos = size - 7; centers.length < count; pos -= step) centers.splice(1, 0, pos); + return centers; } -// Versions 1-5 only. `align` is the single alignment pattern's center -// (versions 2-6 have exactly one, at (size-7, size-7)); version 1 has none. -const VERSION_INFO: Record = { - 1: { size: 21, total: 26, align: null }, - 2: { size: 25, total: 44, align: 18 }, - 3: { size: 29, total: 70, align: 22 }, - 4: { size: 33, total: 100, align: 26 }, - 5: { size: 37, total: 134, align: 30 }, -}; +/** Modules left for codewords once the patterns are drawn. */ +function rawDataModules(version: number): number { + let modules = (16 * version + 128) * version + 64; + if (version >= 2) { + const count = Math.floor(version / 7) + 2; + modules -= (25 * count - 10) * count - 55; + if (version >= 7) modules -= 36; + } + return modules; +} -// Error-correction codeword counts for the (version, level) pairs that use -// exactly one Reed-Solomon block. Versions/levels that split into multiple -// blocks (e.g. V3-Q, V4-M) are intentionally left out. -const ECC_COUNT: Record>> = { - 1: { L: 7, M: 10, Q: 13, H: 17 }, - 2: { L: 10, M: 16, Q: 22, H: 28 }, - 3: { L: 15, M: 26 }, - 4: { L: 20 }, - 5: { L: 26 }, -}; +function dataCodewords(version: number, level: EcLevel): number { + return ( + Math.floor(rawDataModules(version) / 8) - + at(ECC_PER_BLOCK[level], version) * at(BLOCKS[level], version) + ); +} -const EC_LEVEL_BITS: Record = { L: 0b01, M: 0b00, Q: 0b11, H: 0b10 }; +const countBits = (version: number) => (version <= 9 ? 8 : 16); -function getVersionInfo(version: number): VersionInfo { - const info = VERSION_INFO[version]; - if (!info) throw new Error(`qrcode: unsupported version ${version}`); - return info; +/** The smallest version that holds `bytes` bytes at `level`. */ +function chooseVersion(bytes: number, level: EcLevel): number { + for (let version = 1; version <= MAX_VERSION; version++) { + if (4 + countBits(version) + bytes * 8 <= dataCodewords(version, level) * 8) return version; + } + throw new Error(`qrcode: ${bytes} bytes is too long for a version ${MAX_VERSION} code`); } -// Tried smallest-and-strongest first: for each byte length we want the -// smallest code that still uses a good error correction level. -const CANDIDATES: Array<[number, EcLevel]> = [ - [1, 'M'], - [1, 'L'], - [2, 'M'], - [2, 'L'], - [3, 'M'], - [3, 'L'], - [4, 'L'], - [5, 'L'], -]; +// ---- Codewords ------------------------------------------------------------ -class BitBuffer { - bits: number[] = []; - put(value: number, length: number): void { - for (let i = length - 1; i >= 0; i--) { - this.bits.push((value >>> i) & 1); - } +function encodeData(bytes: readonly number[], version: number, level: EcLevel): number[] { + const bits: number[] = []; + const put = (value: number, length: number) => { + for (let i = length - 1; i >= 0; i--) bits.push((value >>> i) & 1); + }; + put(0b0100, 4); + put(bytes.length, countBits(version)); + bytes.forEach((byte) => put(byte, 8)); + const capacity = dataCodewords(version, level) * 8; + put(0, Math.min(4, capacity - bits.length)); + put(0, (8 - (bits.length % 8)) % 8); + for (let pad = 0xec; bits.length < capacity; pad ^= 0xec ^ 0x11) put(pad, 8); + + const words: number[] = []; + for (let i = 0; i < bits.length; i += 8) { + words.push(bits.slice(i, i + 8).reduce((byte, bit) => (byte << 1) | bit, 0)); } + return words; } -interface VersionChoice { - version: number; - level: EcLevel; - dataCodewords: number; - ecc: number; -} +/** Splits the data into blocks, adds each block's error correction, and interleaves them. */ +function interleave(data: readonly number[], version: number, level: EcLevel): number[] { + const blockCount = at(BLOCKS[level], version); + const eccLength = at(ECC_PER_BLOCK[level], version); + const shortLength = Math.floor(data.length / blockCount); + const longBlocks = data.length % blockCount; + const blocks: number[][] = []; + let offset = 0; + for (let b = 0; b < blockCount; b++) { + const length = shortLength + (b >= blockCount - longBlocks ? 1 : 0); + blocks.push(data.slice(offset, offset + length)); + offset += length; + } + const eccs = blocks.map((block) => remainder(block, eccLength)); -function chooseVersionLevel(byteLength: number): VersionChoice { - for (const [version, level] of CANDIDATES) { - const ecc = ECC_COUNT[version]?.[level]; - if (ecc == null) continue; - const dataCodewords = getVersionInfo(version).total - ecc; - // Byte mode overhead for versions 1-9: 4-bit mode indicator + 8-bit - // character count indicator = 12 bits, i.e. 1.5 bytes. - const capacity = Math.floor((dataCodewords * 8 - 12) / 8); - if (byteLength <= capacity) { - return { version, level, dataCodewords, ecc }; - } + const result: number[] = []; + for (let i = 0; i <= shortLength; i++) { + for (const block of blocks) if (i < block.length) result.push(at(block, i)); + } + for (let i = 0; i < eccLength; i++) { + for (const ecc of eccs) result.push(at(ecc, i)); } - throw new Error(`QR text too long for the supported versions (1-5): ${byteLength} bytes`); + return result; } -function getFormatBits(level: EcLevel, mask: number): number { - const data = (EC_LEVEL_BITS[level] << 3) | mask; // 5 bits - let d = data << 10; - const gen = 0b10100110111; // BCH(15,5) generator, degree 10 - for (let i = 4; i >= 0; i--) { - if ((d >> (10 + i)) & 1) { - d ^= gen << i; - } +// ---- The matrix ----------------------------------------------------------- + +class Grid { + readonly size: number; + readonly modules: boolean[][]; + readonly reserved: boolean[][]; + + constructor(size: number) { + this.size = size; + this.modules = Array.from({ length: size }, () => new Array(size).fill(false)); + this.reserved = Array.from({ length: size }, () => new Array(size).fill(false)); } - const bch = d & 0x3ff; - return ((data << 10) | bch) ^ 0b101010000010010; -} -function buildDataCodewords(text: string, dataCodewords: number, ecc: number): number[] { - const bytes = Array.from(new TextEncoder().encode(text)); - const bb = new BitBuffer(); - bb.put(0b0100, 4); // byte mode indicator - bb.put(bytes.length, 8); // character count indicator (versions 1-9) - for (const byte of bytes) bb.put(byte, 8); - - const totalDataBits = dataCodewords * 8; - const termLen = Math.max(0, Math.min(4, totalDataBits - bb.bits.length)); - bb.put(0, termLen); - while (bb.bits.length % 8 !== 0) bb.bits.push(0); - - const padBytes = [0xec, 0x11]; - let padIndex = 0; - while (bb.bits.length < totalDataBits) { - bb.put(idx(padBytes, padIndex % 2), 8); - padIndex++; + dark(row: number, col: number): boolean { + return this.modules[row]?.[col] ?? false; } - const dataCw: number[] = []; - for (let i = 0; i < bb.bits.length; i += 8) { - let byte = 0; - for (let j = 0; j < 8; j++) byte = (byte << 1) | idx(bb.bits, i + j); - dataCw.push(byte); + isReserved(row: number, col: number): boolean { + return this.reserved[row]?.[col] ?? false; } - return dataCw.concat(rsEncode(dataCw, ecc)); -} + set(row: number, col: number, dark: boolean): void { + const line = this.modules[row]; + if (line && col >= 0 && col < this.size) line[col] = dark; + } -function buildFinalBits(allCodewords: number[], version: number): BitBuffer { - // Remainder bits after the codewords: 0 for version 1, 7 for versions 2-6. - const remainderBits = version === 1 ? 0 : 7; - const finalBits = new BitBuffer(); - for (const cw of allCodewords) finalBits.put(cw, 8); - finalBits.put(0, remainderBits); - return finalBits; + /** Sets a pattern module, which the data and the mask never touch. */ + fix(row: number, col: number, dark: boolean): void { + if (row < 0 || row >= this.size || col < 0 || col >= this.size) return; + this.set(row, col, dark); + const line = this.reserved[row]; + if (line) line[col] = true; + } } -type SetModule = (row: number, col: number, dark: boolean) => void; +function drawPatterns(grid: Grid, version: number): void { + const { size } = grid; + for (let i = 0; i < size; i++) { + grid.fix(6, i, i % 2 === 0); + grid.fix(i, 6, i % 2 === 0); + } + for (const [top, left] of [ + [0, 0], + [0, size - 7], + [size - 7, 0], + ] as const) { + for (let r = -1; r <= 7; r++) { + for (let c = -1; c <= 7; c++) { + const ring = Math.max(Math.abs(r - 3), Math.abs(c - 3)); + grid.fix(top + r, left + c, ring !== 2 && ring !== 4); + } + } + } + const centers = alignmentCenters(version); + const last = centers.length - 1; + centers.forEach((row, i) => { + centers.forEach((col, j) => { + const nearFinder = (i === 0 && j === 0) || (i === 0 && j === last) || (i === last && j === 0); + if (nearFinder) return; + for (let r = -2; r <= 2; r++) { + for (let c = -2; c <= 2; c++) + grid.fix(row + r, col + c, Math.max(Math.abs(r), Math.abs(c)) !== 1); + } + }); + }); + drawFormat(grid, 'M', 0); // reserves the format areas; redrawn with the real values later + if (version >= 7) { + let rem = version; + for (let i = 0; i < 12; i++) rem = (rem << 1) ^ ((rem >>> 11) * 0x1f25); + const bits = (version << 12) | rem; + for (let i = 0; i < 18; i++) { + const dark = ((bits >>> i) & 1) === 1; + const a = size - 11 + (i % 3); + const b = Math.floor(i / 3); + grid.fix(b, a, dark); + grid.fix(a, b, dark); + } + } +} -function createGrids(size: number): { matrix: boolean[][]; isFn: boolean[][] } { - const matrix: boolean[][] = Array.from({ length: size }, () => - new Array(size).fill(false), - ); - const isFn: boolean[][] = Array.from({ length: size }, () => - new Array(size).fill(false), - ); - return { matrix, isFn }; +function formatBits(level: EcLevel, mask: number): number { + const data = (FORMAT_LEVEL_BITS[level] << 3) | mask; + let rem = data; + for (let i = 0; i < 10; i++) rem = (rem << 1) ^ ((rem >>> 9) * 0x537); + return ((data << 10) | rem) ^ 0x5412; } -function isFinderDark(r: number, c: number): boolean { - return ( - (r >= 0 && r <= 6 && (c === 0 || c === 6)) || - (c >= 0 && c <= 6 && (r === 0 || r === 6)) || - (r >= 2 && r <= 4 && c >= 2 && c <= 4) - ); +function drawFormat(grid: Grid, level: EcLevel, mask: number): void { + const { size } = grid; + const bits = formatBits(level, mask); + const bit = (i: number) => ((bits >>> i) & 1) === 1; + for (let i = 0; i <= 5; i++) grid.fix(i, 8, bit(i)); + grid.fix(7, 8, bit(6)); + grid.fix(8, 8, bit(7)); + grid.fix(8, 7, bit(8)); + for (let i = 9; i < 15; i++) grid.fix(8, 14 - i, bit(i)); + for (let i = 0; i < 8; i++) grid.fix(8, size - 1 - i, bit(i)); + for (let i = 8; i < 15; i++) grid.fix(size - 15 + i, 8, bit(i)); + grid.fix(size - 8, 8, true); } -function drawFinder(size: number, setFn: SetModule, row: number, col: number): void { - for (let r = -1; r <= 7; r++) { - for (let c = -1; c <= 7; c++) { - const rr = row + r; - const cc = col + c; - if (rr < 0 || rr >= size || cc < 0 || cc >= size) continue; - setFn(rr, cc, isFinderDark(r, c)); +/** Every module the codewords fill, in the standard's two-column zigzag order. */ +function dataModuleOrder(size: number, reserved: (row: number, col: number) => boolean) { + const order: Array<[number, number]> = []; + for (let right = size - 1; right >= 1; right -= 2) { + if (right === 6) right = 5; + const upward = ((right + 1) & 2) === 0; + for (let step = 0; step < size; step++) { + const row = upward ? size - 1 - step : step; + for (const col of [right, right - 1]) if (!reserved(row, col)) order.push([row, col]); } } + return order; } -function drawTimingPatterns(size: number, setFn: SetModule): void { - for (let i = 8; i <= size - 9; i++) { - const dark = i % 2 === 0; - setFn(6, i, dark); - setFn(i, 6, dark); - } -} +const MASKS: ReadonlyArray<(row: number, col: number) => boolean> = [ + (r, c) => (r + c) % 2 === 0, + (r) => r % 2 === 0, + (_r, c) => c % 3 === 0, + (r, c) => (r + c) % 3 === 0, + (r, c) => (Math.floor(r / 2) + Math.floor(c / 3)) % 2 === 0, + (r, c) => ((r * c) % 2) + ((r * c) % 3) === 0, + (r, c) => (((r * c) % 2) + ((r * c) % 3)) % 2 === 0, + (r, c) => (((r + c) % 2) + ((r * c) % 3)) % 2 === 0, +]; -function drawAlignmentPattern(align: number | null, setFn: SetModule): void { - if (align == null) return; - for (let r = -2; r <= 2; r++) { - for (let c = -2; c <= 2; c++) { - setFn(align + r, align + c, Math.max(Math.abs(r), Math.abs(c)) !== 1); +function applyMask(grid: Grid, mask: number): void { + const flip = MASKS[mask]; + if (!flip) return; + for (let r = 0; r < grid.size; r++) { + for (let c = 0; c < grid.size; c++) { + if (!grid.isReserved(r, c) && flip(r, c)) grid.set(r, c, !grid.dark(r, c)); } } } -function drawFunctionPatterns(size: number, align: number | null, setFn: SetModule): void { - drawFinder(size, setFn, 0, 0); - drawFinder(size, setFn, size - 7, 0); - drawFinder(size, setFn, 0, size - 7); - drawTimingPatterns(size, setFn); - drawAlignmentPattern(align, setFn); - setFn(size - 8, 8, true); // dark module, fixed position -} +const FINDER_LIKE = [true, false, true, true, true, false, true]; -function drawFormatInfo(size: number, level: EcLevel, mask: number, setFn: SetModule): void { - const fmt = getFormatBits(level, mask); - const bit = (i: number): boolean => ((fmt >> i) & 1) === 1; - for (let i = 0; i <= 5; i++) setFn(i, 8, bit(i)); - setFn(7, 8, bit(6)); - setFn(8, 8, bit(7)); - setFn(8, 7, bit(8)); - for (let i = 9; i <= 14; i++) setFn(8, 14 - i, bit(i)); - for (let i = 0; i <= 7; i++) setFn(8, size - 1 - i, bit(i)); - for (let i = 8; i <= 14; i++) setFn(size - 15 + i, 8, bit(i)); +/** Rows and columns of the grid, each as a list of dark or light modules. */ +function linesOf(grid: Grid): boolean[][] { + const lines: boolean[][] = []; + for (let i = 0; i < grid.size; i++) { + lines.push(Array.from({ length: grid.size }, (_, j) => grid.dark(i, j))); + lines.push(Array.from({ length: grid.size }, (_, j) => grid.dark(j, i))); + } + return lines; } -interface Grid { - matrix: boolean[][]; - isFn: boolean[][]; - size: number; +/** Runs of five or more modules of one color in a line. */ +function runPenalty(line: readonly boolean[]): number { + let score = 0; + let run = 1; + for (let i = 1; i <= line.length; i++) { + if (i < line.length && line[i] === line[i - 1]) { + run++; + } else { + if (run >= 5) score += 3 + (run - 5); + run = 1; + } + } + return score; } -interface PlacementCursor { - bitIndex: number; - col: number; - upward: boolean; +/** Patterns in a line that look like a finder, with light space on one side. */ +function finderPenalty(line: readonly boolean[]): number { + const light = new Array(4).fill(false); + const padded = [...light, ...line, ...light]; + let score = 0; + for (let i = 4; i + 11 <= padded.length; i++) { + if (!FINDER_LIKE.every((dark, k) => padded[i + k] === dark)) continue; + const clearBefore = padded.slice(i - 4, i).every((dark) => !dark); + const clearAfter = padded.slice(i + 7, i + 11).every((dark) => !dark); + if (clearBefore || clearAfter) score += 40; + } + return score; } -function placeDataColumn(grid: Grid, bits: number[], cursor: PlacementCursor): void { - const { matrix, isFn, size } = grid; - const { col, upward } = cursor; - for (let i = 0; i < size; i++) { - const row = upward ? size - 1 - i : i; - for (const c of [col, col - 1]) { - if (idx2(isFn, row, c)) continue; - const b = cursor.bitIndex < bits.length ? idx(bits, cursor.bitIndex) : 0; - cursor.bitIndex++; - const invert = (row + c) % 2 === 0; // mask 0 - idx(matrix, row)[c] = invert ? b === 0 : b === 1; +/** Two-by-two blocks of one color. */ +function blockPenalty(grid: Grid): number { + let score = 0; + for (let r = 0; r + 1 < grid.size; r++) { + for (let c = 0; c + 1 < grid.size; c++) { + const color = grid.dark(r, c); + const same = + grid.dark(r, c + 1) === color && + grid.dark(r + 1, c) === color && + grid.dark(r + 1, c + 1) === color; + if (same) score += 3; } } + return score; } -function placeDataBits(grid: Grid, bits: number[]): void { - const cursor: PlacementCursor = { bitIndex: 0, col: grid.size - 1, upward: true }; - while (cursor.col > 0) { - if (cursor.col === 6) cursor.col--; // skip the vertical timing column - placeDataColumn(grid, bits, cursor); - cursor.upward = !cursor.upward; - cursor.col -= 2; - } +/** How far the share of dark modules is from half. */ +function balancePenalty(grid: Grid): number { + const total = grid.size * grid.size; + const dark = grid.modules.flat().filter(Boolean).length; + return (Math.ceil(Math.abs(dark * 20 - total * 10) / total) - 1) * 10; } -export interface QrCode { - size: number; - matrix: boolean[][]; - version: number; - level: EcLevel; +/** The standard's penalty score; the mask with the lowest one is used. */ +function penalty(grid: Grid): number { + const lines = linesOf(grid); + const perLine = lines.reduce((sum, line) => sum + runPenalty(line) + finderPenalty(line), 0); + return perLine + blockPenalty(grid) + balancePenalty(grid); } -/** Encodes `text` (byte mode) into a QR code matrix, ready to render as SVG. */ -export function encodeQr(text: string): QrCode { +/** Encodes `text` as a QR code at the given error correction level (M unless told otherwise). */ +export function encodeQr(text: string, level: EcLevel = 'M'): QrCode { const bytes = Array.from(new TextEncoder().encode(text)); - const { version, level, dataCodewords, ecc } = chooseVersionLevel(bytes.length); - const { size, align } = getVersionInfo(version); - - const allCw = buildDataCodewords(text, dataCodewords, ecc); - const finalBits = buildFinalBits(allCw, version); - - const { matrix, isFn } = createGrids(size); - const setFn: SetModule = (row, col, dark) => { - if (row < 0 || row >= size || col < 0 || col >= size) return; - idx(matrix, row)[col] = dark; - idx(isFn, row)[col] = true; + const version = chooseVersion(bytes.length, level); + const codewords = interleave(encodeData(bytes, version, level), version, level); + const size = version * 4 + 17; + + const build = (mask: number) => { + const grid = new Grid(size); + drawPatterns(grid, version); + const order = dataModuleOrder(size, (r, c) => grid.isReserved(r, c)); + order.forEach(([row, col], i) => { + const byte = codewords[i >>> 3]; + if (byte !== undefined) grid.set(row, col, ((byte >>> (7 - (i & 7))) & 1) === 1); + }); + applyMask(grid, mask); + drawFormat(grid, level, mask); + return grid; }; - drawFunctionPatterns(size, align, setFn); - drawFormatInfo(size, level, 0, setFn); - placeDataBits({ matrix, isFn, size }, finalBits.bits); - - return { size, matrix, version, level }; + let best = { grid: build(0), mask: 0 }; + let bestScore = penalty(best.grid); + for (let mask = 1; mask < 8; mask++) { + const grid = build(mask); + const score = penalty(grid); + if (score < bestScore) { + best = { grid, mask }; + bestScore = score; + } + } + return { size, matrix: best.grid.modules, version, level, mask: best.mask }; } -/** Builds a single SVG `` `d` attribute for every dark module, one unit per module. */ -export function qrPathData(qr: QrCode): string { +/** One SVG path `d` for every dark module, one unit per module, offset by the quiet zone. */ +export function qrPathData(qr: QrCode, offset = 0): string { let d = ''; - for (let r = 0; r < qr.size; r++) { - const row = idx(qr.matrix, r); - for (let c = 0; c < qr.size; c++) { - if (idx(row, c)) d += `M${c} ${r}h1v1h-1z`; - } - } + qr.matrix.forEach((row, r) => { + row.forEach((dark, c) => { + if (dark) d += `M${c + offset} ${r + offset}h1v1h-1z`; + }); + }); return d; } + +/** A standalone SVG file of the code: black on white, with its quiet zone. */ +export function qrSvg(qr: QrCode, title: string): string { + const side = qr.size + QUIET_ZONE * 2; + const escaped = title.replace(/&/g, '&').replace(/`, + `${escaped}`, + ``, + ``, + '', + '', + ].join('\n'); +} diff --git a/apps/site/src/pages/bingo.astro b/apps/site/src/pages/bingo.astro index 2e5aebf..0101539 100644 --- a/apps/site/src/pages/bingo.astro +++ b/apps/site/src/pages/bingo.astro @@ -1,21 +1,19 @@ --- import BaseLayout from '../layouts/BaseLayout.astro'; import WinBand from '../components/WinBand.astro'; +import BingoPrintSheet from '../components/BingoPrintSheet.astro'; import { Icon } from 'astro-icon/components'; import { BINGO_SQUARES } from '../lib/bingo'; import { wwd, WWD_DATE_RANGE } from '../lib/wwd'; -// Digital Transit Bingo, /bingo. Copy and behavior are from the Feature -// "Let participants mark a Digital Transit Bingo card on their phone" -// (features/bingo/play-bingo.md) and "Let anyone print a paper bingo card" -// (features/bingo/print-bingo-card.md). The board's interactivity — marking, -// lines, List view, saving, printing — lives in /scripts/bingo.js because -// the site's Content Security Policy blocks inline scripts; this page must +// Digital Transit Bingo, /bingo. The board's interactivity (marking, +// lines, List view, saving, sharing and printing) lives in /scripts because +// the site's Content Security Policy blocks inline scripts; the page must // still be readable with JavaScript off, handled by the + + + + diff --git a/apps/site/tests/bingo-picture.test.ts b/apps/site/tests/bingo-picture.test.ts new file mode 100644 index 0000000..8ba2af8 --- /dev/null +++ b/apps/site/tests/bingo-picture.test.ts @@ -0,0 +1,174 @@ +import { readFileSync } from 'node:fs'; +import vm from 'node:vm'; + +import { describe, expect, it } from 'vitest'; + +import { BINGO_SQUARES } from '../src/lib/bingo'; + +/** + * Runs the real public/scripts/bingo-picture.js in a sandbox and checks the + * picture definition, the count line, the image description, how labels + * fit their tiles, and the contrast of every text color. The drawing itself + * is checked in a real browser by tests/e2e/bingo-share.spec.ts. + */ + +interface Fit { + size: number; + lines: string[]; + lineHeight: number; +} +interface Picture { + make( + marks: boolean[], + squares: Array<{ label: string }>, + ): { + heading: string; + fileName: string; + width: number; + height: number; + choices: unknown; + note: string; + describe(): string; + }; + countLine(marks: boolean[]): string; + fitLabel(measure: (text: string, size: number) => number, text: string, top?: number): Fit; + tileBox(i: number): { x: number; y: number; size: number }; + TEXT_PAIRS: Array<[string, string, string]>; + FREE_LABEL_TOP: number; +} + +function load(): Picture { + const source = readFileSync( + new URL('../public/scripts/bingo-picture.js', import.meta.url), + 'utf8', + ); + const window: { lvwwdBingoPicture?: Picture } = {}; + vm.runInNewContext(source, { window }); + if (!window.lvwwdBingoPicture) throw new Error('The script did not set window.lvwwdBingoPicture'); + return window.lvwwdBingoPicture; +} + +const picture = load(); +// The test's own copy of a square list in the documented shape: the real +// labels, so the example description reads exactly as written. +const squares = BINGO_SQUARES.map((square) => ({ + label: square.label, + free: Boolean(square.free), +})); + +function marks(indexes: number[]): boolean[] { + return Array.from({ length: 25 }, (_, i) => i === 12 || indexes.includes(i)); +} + +const ROW_THREE = [10, 11, 13, 14]; +const ALL = Array.from({ length: 25 }, (_, i) => i); + +describe('the bingo card picture', () => { + it('is a 1080 by 1920 picture with the share screen texts and no headline choices', () => { + const definition = picture.make(marks(ROW_THREE), squares); + expect(definition).toMatchObject({ + heading: 'Share your card', + fileName: 'lvwwd-bingo.png', + width: 1080, + height: 1920, + note: "A bingo card doesn't count as a trip. To enter, share a trip on My week.", + }); + expect(definition.choices).toBeFalsy(); + }); + + it('describes the four row-3 squares exactly as written', () => { + expect(picture.make(marks(ROW_THREE), squares).describe()).toBe( + "Graphic: my Digital Transit Bingo card for Week Without Driving Las Vegas, October 1 to 8, 2026. 4 squares marked and 1 bingo. Marked: Worked from home, Found my nearest stop, Asked a nondriver, One fix I'd make. Bingo lines: row 3. lvwwd.org. #WeekWithoutDriving", + ); + expect(picture.countLine(marks(ROW_THREE))).toBe('4 squares · 1 bingo'); + }); + + it('says "Ready to play" with only the free square', () => { + expect(picture.countLine(marks([]))).toBe('Ready to play'); + expect(picture.make(marks([]), squares).describe()).toBe( + 'Graphic: my Digital Transit Bingo card for Week Without Driving Las Vegas, October 1 to 8, 2026. No squares marked yet; the middle square is free. lvwwd.org. #WeekWithoutDriving', + ); + }); + + it('counts one square in the singular', () => { + expect(picture.countLine(marks([0]))).toBe('1 square'); + expect(picture.make(marks([0]), squares).describe()).toContain( + '1 square marked, no bingo yet.', + ); + }); + + it('counts several squares with no bingo', () => { + expect(picture.countLine(marks([0, 1, 2]))).toBe('3 squares'); + expect(picture.make(marks([0, 1, 2]), squares).describe()).toContain( + '3 squares marked, no bingo yet.', + ); + }); + + it('never counts the free square, even when it is passed in as unmarked', () => { + const withoutFree = marks([0]); + withoutFree[12] = false; + expect(picture.countLine(withoutFree)).toBe('1 square'); + }); + + it('describes a full card with no marked or bingo sentence', () => { + const full = marks(ALL); + expect(picture.countLine(full)).toBe('All 24 squares · 12 bingos'); + const text = picture.make(full, squares).describe(); + expect(text).toContain('All 24 squares marked and 12 bingos.'); + expect(text).not.toContain('Marked:'); + expect(text).not.toContain('Bingo lines:'); + }); + + it('names finished lines rows first, then columns, then diagonals, with a final "and"', () => { + const rowOneColumnOneDiagonal = marks([0, 1, 2, 3, 4, 5, 10, 15, 20, 6, 18, 24]); + const text = picture.make(rowOneColumnOneDiagonal, squares).describe(); + expect(text).toContain('Bingo lines: row 1, column 1 and the diagonal from top left.'); + expect(picture.countLine(rowOneColumnOneDiagonal)).toBe('12 squares · 3 bingos'); + }); + + it('lists marked squares in card order, whatever order they were marked in', () => { + const text = picture.make(marks([24, 0, 7]), squares).describe(); + expect(text).toContain('Marked: Bus instead of driving, New bus route, Helped plan a trip.'); + }); + + it('lays out 25 tiles of 188 pixels with 5-pixel gaps, from x 60 to 1020 and y 480 to 1440', () => { + const first = picture.tileBox(0); + const last = picture.tileBox(24); + expect(first).toEqual({ x: 60, y: 480, size: 188 }); + expect(last.x + last.size).toBe(1020); + expect(last.y + last.size).toBe(1440); + expect(picture.tileBox(1).x - (first.x + first.size)).toBe(5); + }); + + it('fits every label inside its tile, shrinking long ones but never below 20 pixels', () => { + // A generous stand-in for a real font: every character as wide as 0.6 of the size. + const measure = (text: string, size: number) => text.length * size * 0.6; + for (const square of squares) { + const top = square.free ? picture.FREE_LABEL_TOP : 56; + const fit = picture.fitLabel(measure, square.label, top); + expect(fit.size, square.label).toBeGreaterThanOrEqual(20); + expect(fit.size, square.label).toBeLessThanOrEqual(28); + expect(fit.lines.length, square.label).toBeLessThanOrEqual(4); + expect(fit.lines.join(' '), square.label).toBe(square.label); + for (const line of fit.lines) expect(measure(line, fit.size), line).toBeLessThanOrEqual(164); + expect(top + fit.lines.length * fit.lineHeight, square.label).toBeLessThanOrEqual(188); + } + }); + + it('keeps every text color at 4.5 to 1 or more against its background', () => { + const channel = (value: number) => { + const c = value / 255; + return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4; + }; + const luminance = (hex: string) => { + const [r, g, b] = [1, 3, 5].map((i) => channel(parseInt(hex.slice(i, i + 2), 16))); + return 0.2126 * (r ?? 0) + 0.7152 * (g ?? 0) + 0.0722 * (b ?? 0); + }; + expect(picture.TEXT_PAIRS.length).toBeGreaterThanOrEqual(5); + for (const [name, text, background] of picture.TEXT_PAIRS) { + const [light, dark] = [luminance(text), luminance(background)].sort((a, b) => b - a); + const ratio = ((light ?? 0) + 0.05) / ((dark ?? 0) + 0.05); + expect(ratio, name).toBeGreaterThanOrEqual(4.5); + } + }); +}); diff --git a/apps/site/tests/e2e/bingo-share.spec.ts b/apps/site/tests/e2e/bingo-share.spec.ts new file mode 100644 index 0000000..d3bb5ae --- /dev/null +++ b/apps/site/tests/e2e/bingo-share.spec.ts @@ -0,0 +1,306 @@ +import { expect, test, type Page } from '@playwright/test'; + +// The bingo card picture as the browser draws it, and the share screen that +// shows it. Pixel checks read the drawn canvas; they look for colors in +// places the layout fixes, not for an exact image. + +const ROW_THREE = [ + 'Worked from home', + 'Found my nearest stop', + 'Asked a nondriver', + "One fix I'd make", +]; + +async function mark(page: Page, labels: string[]) { + for (const label of labels) { + await page.getByRole('checkbox', { name: new RegExp(`^${label}`) }).click(); + } +} + +interface DrawnText { + text: string; + x: number; + y: number; + font: string; + width: number; +} +interface Box { + x: number; + y: number; + size: number; +} +interface PictureApi { + make: ( + marks: boolean[], + squares: unknown[], + ) => { width: number; height: number; fonts: string[]; draw: (c: HTMLCanvasElement) => void }; + tileBox: (i: number) => Box; +} +interface DrawnWindow { + lvwwdBingoPicture: PictureApi; + drawn?: { canvas: HTMLCanvasElement; context: CanvasRenderingContext2D }; +} + +function squaresOnPage(): unknown[] { + return JSON.parse(document.getElementById('bingo-squares')?.textContent ?? '[]') as unknown[]; +} + +/** + * Draws the picture for the given marks on a fresh canvas, keeps the canvas + * on the page for the checks below, and returns every text it drew. + */ +async function draw(page: Page, marked: number[]) { + await page.addScriptTag({ content: `window.squaresOnPage = ${squaresOnPage.toString()};` }); + return page.evaluate(async (indexes) => { + const w = window as unknown as DrawnWindow & { squaresOnPage: () => unknown[] }; + const marks = Array.from({ length: 25 }, (_, i) => i === 12 || indexes.includes(i)); + const definition = w.lvwwdBingoPicture.make(marks, w.squaresOnPage()); + await Promise.all(definition.fonts.map((font) => document.fonts.load(font))); + const canvas = document.createElement('canvas'); + canvas.width = definition.width; + canvas.height = definition.height; + const context = canvas.getContext('2d'); + if (!context) throw new Error('No canvas'); + const texts: DrawnText[] = []; + const fillText = context.fillText.bind(context); + context.fillText = (text: string, x: number, y: number) => { + texts.push({ text, x, y, font: context.font, width: context.measureText(text).width }); + fillText(text, x, y); + }; + Object.defineProperty(canvas, 'getContext', { value: () => context }); + definition.draw(canvas); + w.drawn = { canvas, context }; + return { width: canvas.width, height: canvas.height, texts }; + }, marked); +} + +/** The drawn canvas's colors at the given points, as #RRGGBB. */ +async function colorsAt(page: Page, points: Array<[number, number]>): Promise { + return page.evaluate((list) => { + const { context } = (window as unknown as DrawnWindow).drawn ?? {}; + if (!context) throw new Error('Nothing drawn'); + return list.map(([x, y]) => { + const [r = 0, g = 0, b = 0] = context.getImageData(x, y, 1, 1).data; + return `#${[r, g, b].map((v) => v.toString(16).padStart(2, '0')).join('')}`.toUpperCase(); + }); + }, points); +} + +/** How many pixels of `color` are in the rectangle, sampling every other pixel. */ +async function countColor(page: Page, rect: [number, number, number, number], color: string) { + return page.evaluate( + ([[x, y, width, height], hex]) => { + const { context } = (window as unknown as DrawnWindow).drawn ?? {}; + if (!context) throw new Error('Nothing drawn'); + const data = context.getImageData(x, y, width, height).data; + const want = [1, 3, 5].map((i) => parseInt(hex.slice(i, i + 2), 16)); + let count = 0; + for (let i = 0; i < data.length; i += 8) { + if (data[i] === want[0] && data[i + 1] === want[1] && data[i + 2] === want[2]) count++; + } + return count; + }, + [rect, color] as const, + ); +} + +/** Pixels that are not the background above y 250 or below y 1670. */ +async function strayPixels(page: Page): Promise { + const [top, bottom] = await Promise.all([ + countColor(page, [0, 0, 1080, 250], '#0F1115'), + countColor(page, [0, 1671, 1080, 249], '#0F1115'), + ]); + return (1080 * 250) / 2 - top + (1080 * 249) / 2 - bottom; +} + +async function tileBoxes(page: Page): Promise { + return page.evaluate(() => + Array.from({ length: 25 }, (_, i) => + (window as unknown as DrawnWindow).lvwwdBingoPicture.tileBox(i), + ), + ); +} + +/** For each tile: its fill low on the left, its left edge, and white pixels where a check goes. */ +async function readTiles(page: Page) { + const boxes = await tileBoxes(page); + const fills = await colorsAt( + page, + boxes.map((box) => [box.x + 20, box.y + box.size - 16]), + ); + const edges = await colorsAt( + page, + boxes.map((box) => [box.x + 4, box.y + box.size / 2]), + ); + const checks = await Promise.all( + boxes.map((box) => countColor(page, [box.x + box.size - 60, box.y + 12, 48, 48], '#FFFFFF')), + ); + return boxes.map((box, i) => ({ box, fill: fills[i], edge: edges[i], check: checks[i] ?? 0 })); +} + +test.beforeEach(async ({ page }) => { + await page.goto('/bingo'); + await page.evaluate(() => window.localStorage.clear()); + await page.reload(); +}); + +test('the picture for the row-3 squares shows their checks, the star and the finished line', async ({ + page, +}) => { + const requests: string[] = []; + page.on('request', (request) => requests.push(request.url())); + const drawn = await draw(page, [10, 11, 13, 14]); + + expect([drawn.width, drawn.height]).toEqual([1080, 1920]); + expect(drawn.texts.find((t) => t.y === 390)?.text).toBe('4 squares · 1 bingo'); + const tiles = await readTiles(page); + tiles.forEach((tile, i) => { + if (i === 12) return; + // A check is white on the marked tile's red; an unmarked tile is white + // all over, with no red and so no check. + const checked = [10, 11, 13, 14].includes(i); + expect(tile.fill, `fill of tile ${i}`).toBe(checked ? '#B8360F' : '#FFFFFF'); + if (checked) expect(tile.check, `check on tile ${i}`).toBeGreaterThan(20); + expect(tile.edge === '#FF8A5C', `outline on tile ${i}`).toBe(i >= 10 && i <= 14); + }); + const free = tiles[12]?.box; + if (!free) throw new Error('No free tile'); + expect(await colorsAt(page, [[free.x + free.size / 2, free.y + 40]])).toEqual(['#0F1115']); + expect(requests).toEqual([]); +}); + +test('every square shows its short label, inside its tile', async ({ page }) => { + const drawn = await draw(page, []); + const squares = (await page.evaluate(squaresOnPage)) as Array<{ label: string }>; + const boxes = await tileBoxes(page); + squares.forEach((square, i) => { + const box = boxes[i]; + if (!box) throw new Error(`No tile ${i}`); + const lines = drawn.texts.filter( + (t) => t.y >= box.y && t.y < box.y + box.size && Math.abs(t.x - (box.x + box.size / 2)) < 1, + ); + expect(lines.map((t) => t.text).join(' '), `tile ${i}`).toBe(square.label); + for (const line of lines) { + const size = Number(/(\d+)px/.exec(line.font)?.[1]); + expect(size, line.text).toBeGreaterThanOrEqual(20); + expect(line.width, line.text).toBeLessThanOrEqual(box.size - 16); + expect(line.y + size * 1.15, line.text).toBeLessThanOrEqual(box.y + box.size); + } + }); +}); + +test('nothing is drawn above y 250 or below y 1670, for an empty and a full card', async ({ + page, +}) => { + await draw(page, []); + expect(await strayPixels(page)).toBe(0); + const full = await draw( + page, + Array.from({ length: 25 }, (_, i) => i), + ); + expect(await strayPixels(page)).toBe(0); + expect(full.texts.find((t) => t.y === 390)?.text).toBe('All 24 squares · 12 bingos'); + const tiles = await readTiles(page); + tiles.forEach((tile, i) => { + if (i === 12) return; + expect(tile.fill, `fill of tile ${i}`).toBe('#B8360F'); + expect(tile.check, `check on tile ${i}`).toBeGreaterThan(20); + }); +}); + +test('the share screen shows the picture, its description and the two lines', async ({ page }) => { + await mark(page, ROW_THREE); + await page.getByRole('button', { name: 'Keep playing' }).click(); + const share = page.getByRole('button', { name: 'Share your card' }); + await share.click(); + + const screen = page.getByRole('dialog', { name: 'Share your card' }); + await expect(screen).toBeVisible(); + await expect(screen.getByRole('heading', { name: 'Share your card' })).toBeFocused(); + const description = + "Graphic: my Digital Transit Bingo card for Week Without Driving Las Vegas, October 1 to 8, 2026. 4 squares marked and 1 bingo. Marked: Worked from home, Found my nearest stop, Asked a nondriver, One fix I'd make. Bingo lines: row 3. lvwwd.org. #WeekWithoutDriving"; + await expect(screen.getByRole('img', { name: description })).toBeVisible(); + await expect(screen.getByText(description, { exact: true })).toBeVisible(); + await expect(screen.getByText('Image description', { exact: true })).toBeVisible(); + await expect( + screen.getByText('The image is made on your phone. Nothing is uploaded.'), + ).toBeVisible(); + await expect( + screen.getByText("A bingo card doesn't count as a trip. To enter, share a trip on My week."), + ).toBeVisible(); + const size = await screen + .getByRole('img', { name: description }) + .evaluate((img: HTMLImageElement) => [img.naturalWidth, img.naturalHeight]); + expect(size).toEqual([1080, 1920]); +}); + +test('Tab moves through Close, the share button and the copy button; Escape returns focus', async ({ + page, +}) => { + const share = page.getByRole('button', { name: 'Share your card' }); + await share.focus(); + await page.keyboard.press('Enter'); + const screen = page.getByRole('dialog', { name: 'Share your card' }); + await expect(screen.getByRole('img')).toBeVisible(); + await page.keyboard.press('Tab'); + await expect(screen.getByRole('button', { name: 'Close' })).toBeFocused(); + await page.keyboard.press('Tab'); + await expect(screen.getByRole('button', { name: /^(Share|Save) image$/ })).toBeFocused(); + await page.keyboard.press('Tab'); + await expect(screen.getByRole('button', { name: 'Copy image description' })).toBeFocused(); + await page.keyboard.press('Escape'); + await expect(screen).toBeHidden(); + await expect(share).toBeFocused(); + expect(new URL(page.url()).pathname).toBe('/bingo'); +}); + +test('the back button closes the share screen and leaves the Bingo page open', async ({ page }) => { + await page.getByRole('button', { name: 'Share your card' }).click(); + const screen = page.getByRole('dialog', { name: 'Share your card' }); + await expect(screen).toBeVisible(); + await page.goBack(); + await expect(screen).toBeHidden(); + expect(new URL(page.url()).pathname).toBe('/bingo'); +}); + +test('where files cannot be shared, the button saves lvwwd-bingo.png and says so', async ({ + page, +}) => { + await page.evaluate(() => { + Object.defineProperty(navigator, 'canShare', { value: () => false, configurable: true }); + }); + await page.getByRole('button', { name: 'Share your card' }).click(); + const screen = page.getByRole('dialog', { name: 'Share your card' }); + const save = screen.getByRole('button', { name: 'Save image' }); + await expect(save).toBeEnabled(); + const download = page.waitForEvent('download'); + await save.click(); + expect((await download).suggestedFilename()).toBe('lvwwd-bingo.png'); + await expect( + screen.getByText('Image saved. Look for lvwwd-bingo.png in your downloads.'), + ).toBeVisible(); +}); + +test('"Copy image description" copies the description and says so', async ({ page, context }) => { + await context.grantPermissions(['clipboard-read', 'clipboard-write']); + await page.getByRole('button', { name: 'Share your card' }).click(); + const screen = page.getByRole('dialog', { name: 'Share your card' }); + await screen.getByRole('button', { name: 'Copy image description' }).click(); + await expect(screen.getByText('Description copied.')).toBeVisible(); + const copied = await page.evaluate(() => navigator.clipboard.readText()); + expect(copied).toContain('No squares marked yet; the middle square is free.'); +}); + +test('the "Bingo!" message opens the share screen and focus comes back to the card', async ({ + page, +}) => { + await mark(page, ROW_THREE); + const message = page.getByRole('dialog', { name: 'Bingo!' }); + await expect(message).toBeVisible(); + await message.getByRole('button', { name: 'Share your card' }).click(); + await expect(message).toBeHidden(); + const screen = page.getByRole('dialog', { name: 'Share your card' }); + await expect(screen).toBeVisible(); + await screen.getByRole('button', { name: 'Close' }).click(); + await expect(page.getByRole('button', { name: 'Share your card' })).toBeFocused(); +}); From 350cd3abe3ebf39900e95d55a5ae4dadb39d37dd Mon Sep 17 00:00:00 2001 From: Willie Chalmers III Date: Wed, 23 Sep 2026 17:37:05 -0700 Subject: [PATCH 3/5] feat(site): List partners from one roster, with links and QR codes Every partner now lives in one list, src/data/partners.ts. A volunteer adds an organization by adding one item there and publishing the site; the Partners page, the home page's partner wall and the QR code files all follow. The build checks each item and stops with a message naming the organization when a field is missing, a slug is malformed, taken or "general", a website doesn't start with https://, a type isn't one of the six, or a sentence runs past 200 characters. The Partners page lists partners by name, ignoring capitals and a leading "The", each with its name linking to its website, its type and its sentence, in one column on a phone and two from 768 pixels. With no partner yet, the roster is left out and the page opens with "Bring your organization". "Copy email address" now announces "Copied" to screen readers. From 12:00 am October 9, by the phone's clock, the roster heading reads "Took part in 2026" and the join section gives way to a note about next year. For each partner, and for LVBT's general materials, the build writes QR code files at /partners/qr/.png (1024 pixels square) and .svg, each opening the partner's giveaway link at error correction level M. A small PNG writer uses Node's own zlib. The logo wall, the logo request, the sample posts and the staff email leave the page: partners are listed by name only, and the partner kit in the next change replaces the banner mockups. A how-to explains how to add, change or remove a partner. Co-Authored-By: Claude Opus 5.5 --- apps/site/public/scripts/partners.js | 139 +++--- apps/site/src/data/partners.ts | 26 + apps/site/src/lib/partners.ts | 145 +++++- apps/site/src/lib/png.ts | 58 +++ apps/site/src/lib/wwd.ts | 9 +- apps/site/src/pages/index.astro | 2 +- apps/site/src/pages/partners.astro | 545 +++++---------------- apps/site/src/pages/partners/flyer.astro | 12 +- apps/site/src/pages/partners/qr/[file].ts | 33 ++ apps/site/tests/api-partner-credit.test.ts | 10 +- apps/site/tests/e2e/partners.spec.ts | 89 ++++ apps/site/tests/partners.test.ts | 139 ++++++ docs/README.md | 1 + docs/operations/how-to/add-a-partner.md | 58 +++ 14 files changed, 737 insertions(+), 529 deletions(-) create mode 100644 apps/site/src/data/partners.ts create mode 100644 apps/site/src/lib/png.ts create mode 100644 apps/site/src/pages/partners/qr/[file].ts create mode 100644 apps/site/tests/e2e/partners.spec.ts create mode 100644 apps/site/tests/partners.test.ts create mode 100644 docs/operations/how-to/add-a-partner.md diff --git a/apps/site/public/scripts/partners.js b/apps/site/public/scripts/partners.js index 4644771..e64c49e 100644 --- a/apps/site/public/scripts/partners.js +++ b/apps/site/public/scripts/partners.js @@ -1,83 +1,106 @@ /** - * Partners page copy buttons: "Copy email address" and "Copy snippet". - * Both are progressive enhancement over plain visible text, so they are - * `hidden` in markup and only shown once this script confirms it can run - * (see the bottom of this file). A button copies `data-copy-text` directly, - * or the text content of the element `data-copy-target` points at. + * The Partners page: its copy buttons, and its text after the week. * - * No backend involved: this only touches the clipboard and the DOM. + * A copy button copies `data-copy-text`, or the text (or a text box's + * value) of the element `data-copy-target` points at. It then reads + * "Copied" for 3 seconds, and its status line (the element its + * aria-describedby names, a polite live region) says "Copied" so screen + * readers hear it. If the browser refuses, the text is selected instead, + * with a note on how to copy it. The buttons in markup that are `hidden` + * are shown only once this script runs. + * + * From 12:00 am October 9, 2026, Las Vegas time, by the phone's clock, the + * roster heading reads "Took part in 2026" and "Bring your organization" + * gives way to a note about next year. */ (() => { + const ENDED = Date.parse('2026-10-09T07:00:00Z'); const REVERT_MS = 3000; const timers = new WeakMap(); - function revertLater(button, originalLabel) { - const existing = timers.get(button); - if (existing) window.clearTimeout(existing); - timers.set( - button, - window.setTimeout(() => { - button.textContent = originalLabel; - timers.delete(button); - }, REVERT_MS), - ); + function showEnded() { + const heading = document.querySelector('[data-partners-roster-heading]'); + if (heading) heading.textContent = 'Took part in 2026'; + const join = document.querySelector('[data-partners-join]'); + const ended = document.querySelector('[data-partners-ended]'); + if (join) join.hidden = true; + if (ended) ended.hidden = false; } async function copyText(text) { - if (navigator.clipboard && window.isSecureContext) { - try { - await navigator.clipboard.writeText(text); - return true; - } catch { - return false; - } + if (!navigator.clipboard || !window.isSecureContext) return false; + try { + await navigator.clipboard.writeText(text); + return true; + } catch { + return false; } - return false; } - function selectText(el) { + function select(el) { + if (el instanceof HTMLTextAreaElement || el instanceof HTMLInputElement) { + el.focus(); + el.select(); + return; + } const range = document.createRange(); range.selectNodeContents(el); const selection = window.getSelection(); - if (!selection) return; - selection.removeAllRanges(); - selection.addRange(range); + selection?.removeAllRanges(); + selection?.addRange(range); } - document.addEventListener('click', (event) => { - const target = event.target; - const button = - target instanceof Element ? target.closest('[data-copy-text], [data-copy-target]') : null; - if (!(button instanceof HTMLButtonElement)) return; - - const originalLabel = button.dataset.copyOriginalLabel ?? button.textContent ?? ''; - button.dataset.copyOriginalLabel = originalLabel; + function textOf(button) { + const selector = button.getAttribute('data-copy-target'); + const source = selector ? document.querySelector(selector) : null; + if (source instanceof HTMLTextAreaElement || source instanceof HTMLInputElement) { + return { source, text: source.value }; + } + if (source) return { source, text: source.textContent ?? '' }; + return { source: null, text: button.getAttribute('data-copy-text') ?? '' }; + } - const statusId = button.getAttribute('aria-describedby'); - const statusEl = statusId ? document.getElementById(statusId) : null; + function statusFor(button) { + const id = button.getAttribute('aria-describedby'); + return id ? document.getElementById(id) : null; + } - const targetSelector = button.getAttribute('data-copy-target'); - const sourceEl = targetSelector ? document.querySelector(targetSelector) : null; - const text = sourceEl - ? (sourceEl.textContent ?? '') - : (button.getAttribute('data-copy-text') ?? ''); + async function copy(button) { + const { source, text } = textOf(button); if (!text) return; + const status = statusFor(button); + const label = button.querySelector('[data-copy-label]') ?? button; + button.dataset.copyLabel ??= label.textContent ?? ''; - copyText(text).then((ok) => { - if (ok) { - if (statusEl) statusEl.textContent = ''; - button.textContent = 'Copied'; - revertLater(button, originalLabel); - return; - } - if (sourceEl) selectText(sourceEl); - if (statusEl) { - statusEl.textContent = 'Press and hold, or use your keyboard, to copy the selected text.'; - } - }); - }); + if (await copyText(text)) { + label.textContent = 'Copied'; + if (status) status.textContent = 'Copied'; + window.clearTimeout(timers.get(button)); + timers.set( + button, + window.setTimeout(() => { + label.textContent = button.dataset.copyLabel ?? ''; + if (status?.textContent === 'Copied') status.textContent = ''; + }, REVERT_MS), + ); + return; + } + if (source) select(source); + if (status) { + status.textContent = 'Press and hold, or use your keyboard, to copy the selected text.'; + } + } - document.querySelectorAll('[data-copy-text], [data-copy-target]').forEach((el) => { - el.hidden = false; + document.addEventListener('click', (event) => { + const target = event.target instanceof Element ? event.target : null; + const button = target?.closest('[data-copy-text], [data-copy-target]'); + if (button instanceof HTMLButtonElement) void copy(button); }); + + document + .querySelectorAll('[data-copy-text][hidden], [data-copy-target][hidden]') + .forEach((el) => { + el.hidden = false; + }); + if (Date.now() >= ENDED) showEnded(); })(); diff --git a/apps/site/src/data/partners.ts b/apps/site/src/data/partners.ts new file mode 100644 index 0000000..c6ec0bf --- /dev/null +++ b/apps/site/src/data/partners.ts @@ -0,0 +1,26 @@ +import type { RosterItem } from '../lib/partners'; + +// The partner roster: every organization taking part in Week Without +// Driving Las Vegas 2026. It is the only place partner details live. The +// Partners page, each partner's link and QR code files, and the home page +// all read it, so adding a partner is adding one item here and publishing +// the site. docs/operations/how-to/add-a-partner.md walks through it. +// +// Add an organization only after it has confirmed its sentence and type by +// email. Once its link or QR code has been shared, never change its slug: +// printed codes and posted links carry it. +// +// Each item looks like this (a made-up partner, for the format only): +// +// { +// slug: 'example-club', +// name: 'Example Club', +// url: 'https://example.org', +// type: 'Student groups', +// sentence: 'Our members are taking the bus to class together on October 6.', +// }, +// +// `url` is optional. `type` is one of the six in PARTNER_TYPES in +// src/lib/partners.ts, spelled exactly. The build stops with a message +// naming the partner if an item breaks a rule. +export const roster: RosterItem[] = []; diff --git a/apps/site/src/lib/partners.ts b/apps/site/src/lib/partners.ts index 61a0731..4e6d0ea 100644 --- a/apps/site/src/lib/partners.ts +++ b/apps/site/src/lib/partners.ts @@ -1,34 +1,129 @@ -import { wwd } from './wwd'; - -// The partner roster, for the Partners page and for crediting sign-ups. -// It is driven by `wwd.partners` (apps/site/src/lib/wwd.ts), which stays -// an empty array until LVBT confirms its first partner by email. That -// array's declared shape only carries `name` and an optional `url`; a real -// roster entry also needs a slug (the short name in its `?ref=` -// link), a type and a one-sentence blurb. Rather than widen the shared -// `wwd.ts` type for a shape nothing uses yet, this file casts the (always -// empty, for now) array to the fuller shape a populated roster needs. When -// the roster gets its first real entry, `wwd.ts` should grow those fields -// directly and this cast can be dropped. -export type PartnerType = - | 'Community and neighborhood groups' - | 'Student groups' - | 'Environmental and justice groups' - | 'Disability and senior advocates' - | 'Employers and businesses' - | 'Public agencies'; - -export interface Partner { - name: string; +import { roster } from '../data/partners'; + +// Partners: the organizations bringing Week Without Driving to their +// members, and what the site makes for each of them. The roster itself is +// src/data/partners.ts; this file checks it, sorts it, and builds each +// partner's link and QR code addresses. + +export const PARTNER_TYPES = [ + 'Community and neighborhood groups', + 'Student groups', + 'Environmental and justice groups', + 'Disability and senior advocates', + 'Employers and businesses', + 'Public agencies', +] as const; + +export type PartnerType = (typeof PARTNER_TYPES)[number]; + +/** One organization, as a volunteer writes it in the roster. */ +export interface RosterItem { + /** Short, permanent name: lowercase letters, digits and single hyphens. */ slug: string; + /** The organization's name as it wants it shown. */ + name: string; + /** Its website or social media page, starting with https://. */ url?: string; - /** Logo image path or URL, once the partner has sent one in. */ - logoUrl?: string; type: PartnerType; + /** One sentence on how it is taking part, at most 200 characters. */ sentence: string; } -export const partners: Partner[] = wwd.partners as Partner[]; +export type Partner = RosterItem; + +/** The slug kept for LVBT's own materials, which no partner may use. */ +export const GENERAL = 'general'; + +const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/; +const MAX_SLUG = 40; +const MAX_SENTENCE = 200; + +/** A roster item as written, before it is checked: any field may be missing or wrong. */ +export type UncheckedItem = { [Field in keyof RosterItem]?: unknown }; + +const text = (value: unknown): string => (typeof value === 'string' ? value : ''); + +function slugProblems(slug: string): string[] { + const problems: string[] = []; + if (!SLUG.test(slug)) { + problems.push( + `its slug "${slug}" must be lowercase letters and digits, with single hyphens between them`, + ); + } + if (slug.length > MAX_SLUG) problems.push(`its slug is longer than ${MAX_SLUG} characters`); + if (slug === GENERAL) problems.push(`the slug "${GENERAL}" is kept for LVBT's own materials`); + return problems; +} + +function problemsWith(item: UncheckedItem): string[] { + const missing = (['slug', 'name', 'type', 'sentence'] as const) + .filter((field) => text(item[field]).trim() === '') + .map((field) => `it has no ${field}`); + const problems = [...missing]; + const slug = text(item.slug); + if (slug) problems.push(...slugProblems(slug)); + if (item.url !== undefined && !text(item.url).startsWith('https://')) { + problems.push(`its url "${text(item.url)}" must start with https://`); + } + const type = text(item.type); + if (type && !(PARTNER_TYPES as readonly string[]).includes(type)) { + problems.push(`its type "${type}" must be one of: ${PARTNER_TYPES.join('; ')}`); + } + const sentence = text(item.sentence); + if (sentence.length > MAX_SENTENCE) { + problems.push(`its sentence is ${sentence.length} characters, more than ${MAX_SENTENCE}`); + } + return problems; +} + +/** + * Checks every roster item and throws one error listing each problem with + * the partner's name, so the build stops before a broken link or QR code + * is published. + */ +export function checkRoster(items: readonly UncheckedItem[]): Partner[] { + const problems: string[] = []; + const seen = new Map(); + items.forEach((item, index) => { + const name = text(item.name); + const who = name ? `"${name}"` : `item ${index + 1}`; + for (const problem of problemsWith(item)) problems.push(`${who}: ${problem}`); + const slug = text(item.slug); + if (!slug) return; + const other = seen.get(slug); + if (other) problems.push(`${who}: its slug "${slug}" is already used by ${other}`); + seen.set(slug, who); + }); + if (problems.length > 0) { + throw new Error( + `The partner roster (src/data/partners.ts) has problems:\n- ${problems.join('\n- ')}`, + ); + } + return items as Partner[]; +} + +/** The name a partner is sorted by: no capitals, and no leading "The ". */ +function sortName(name: string): string { + return name.replace(/^the\s+/i, '').toLocaleLowerCase('en-US'); +} + +/** Partners in alphabetical order of name, ignoring capitals and a leading "The ". */ +export function sortPartners(items: readonly Partner[]): Partner[] { + return [...items].sort((a, b) => sortName(a.name).localeCompare(sortName(b.name), 'en-US')); +} + +/** The giveaway link that credits sign-ups to a partner, or LVBT's general one. */ +export function partnerLink(slug: string): string { + return slug === GENERAL ? 'https://lvwwd.org/giveaway' : `https://lvwwd.org/giveaway?ref=${slug}`; +} + +/** Where a partner's (or the general) QR code files are published. */ +export function qrFiles(slug: string): { png: string; svg: string } { + return { png: `/partners/qr/${slug}.png`, svg: `/partners/qr/${slug}.svg` }; +} + +/** Every partner, checked and sorted. Empty until the first partner confirms. */ +export const partners: Partner[] = sortPartners(checkRoster(roster)); /** * The partner a `?ref=` link names, or null when it names none on the diff --git a/apps/site/src/lib/png.ts b/apps/site/src/lib/png.ts new file mode 100644 index 0000000..7556542 --- /dev/null +++ b/apps/site/src/lib/png.ts @@ -0,0 +1,58 @@ +import { crc32, deflateSync } from 'node:zlib'; + +import { QUIET_ZONE, type QrCode } from './qrcode'; + +// Writes a QR code as a black-and-white PNG when the site is built, with +// Node's own zlib, so no image library is needed. One bit per pixel keeps +// the 1024-pixel files to a few kilobytes. + +function chunk(type: string, data: Uint8Array): Uint8Array { + const body = new Uint8Array(4 + data.length); + body.set(new TextEncoder().encode(type), 0); + body.set(data, 4); + const out = new Uint8Array(12 + data.length); + const view = new DataView(out.buffer); + view.setUint32(0, data.length); + out.set(body, 4); + view.setUint32(8 + data.length, crc32(body)); + return out; +} + +/** + * The code as a square PNG `pixels` wide, black modules on white, with its + * four-module quiet zone. Each module covers a whole number of pixels, give + * or take one, so the code stays sharp at any printed size. + */ +export function qrPng(qr: QrCode, pixels = 1024): Uint8Array { + const modules = qr.size + QUIET_ZONE * 2; + const rowBytes = Math.ceil(pixels / 8); + const raw = new Uint8Array((rowBytes + 1) * pixels); + const moduleAt = (p: number) => Math.floor((p * modules) / pixels) - QUIET_ZONE; + for (let y = 0; y < pixels; y++) { + const row = qr.matrix[moduleAt(y)]; + const start = y * (rowBytes + 1) + 1; // each row starts with filter type 0 + for (let x = 0; x < pixels; x++) { + const dark = row?.[moduleAt(x)] === true; + // In one-bit grayscale, 1 is white. + if (!dark) raw[start + (x >> 3)] = (raw[start + (x >> 3)] ?? 0) | (0x80 >> (x & 7)); + } + } + const header = new Uint8Array(13); + const view = new DataView(header.buffer); + view.setUint32(0, pixels); + view.setUint32(4, pixels); + header.set([1, 0, 0, 0, 0], 8); // bit depth 1, grayscale, no interlace + const parts = [ + new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]), + chunk('IHDR', header), + chunk('IDAT', deflateSync(raw, { level: 9 })), + chunk('IEND', new Uint8Array(0)), + ]; + const file = new Uint8Array(parts.reduce((sum, part) => sum + part.length, 0)); + let offset = 0; + for (const part of parts) { + file.set(part, offset); + offset += part.length; + } + return file; +} diff --git a/apps/site/src/lib/wwd.ts b/apps/site/src/lib/wwd.ts index 54ae153..49fdafc 100644 --- a/apps/site/src/lib/wwd.ts +++ b/apps/site/src/lib/wwd.ts @@ -1,6 +1,6 @@ -// Week Without Driving campaign data. One place for the dates, hashtag, -// giveaway rules, and partner roster that /wwd renders, so the yearly -// update is a few values here rather than a copy-edit of the page. Dates +// Week Without Driving campaign data. One place for the dates, hashtag and +// giveaway rules, so the yearly update is a few values here rather than a +// copy-edit of the pages. The partner roster is src/data/partners.ts. Dates // come from weekwithoutdriving.org and change every year. export const wwd = { year: 2026, @@ -15,9 +15,6 @@ export const wwd = { rtcTripPlannerUrl: 'https://www.rtcsnv.com/ways-to-travel/trip-planner/', hashtag: '#WeekWithoutDriving', maxEntries: 8, - // Organizations that have committed to take part. Rendered as a roster - // once non-empty; hidden until then so the page never shows an empty box. - partners: [] as Array<{ name: string; url?: string }>, } as const; // Links out to the national campaign and local tools, grouped by who they diff --git a/apps/site/src/pages/index.astro b/apps/site/src/pages/index.astro index 1bc0610..7b59079 100644 --- a/apps/site/src/pages/index.astro +++ b/apps/site/src/pages/index.astro @@ -14,7 +14,7 @@ import { partners } from '../lib/partners'; // it is, and one button. Below that, the three steps, why it matters, the // prizes, the daily Instagram hosts, the partners and the local leaders. // Hosts, partners and proclamations fill in from src/lib/campaign.ts and -// src/lib/partners.ts as LVBT confirms them. +// src/data/partners.ts as LVBT confirms them. const dateRange = `October 1 to 8, ${wwd.year}`; const canonical = `${site.url}/`; diff --git a/apps/site/src/pages/partners.astro b/apps/site/src/pages/partners.astro index 55d6e23..a2c78e6 100644 --- a/apps/site/src/pages/partners.astro +++ b/apps/site/src/pages/partners.astro @@ -1,66 +1,22 @@ --- import BaseLayout from '../layouts/BaseLayout.astro'; import { Icon } from 'astro-icon/components'; -import { wwd, WWD_DATE_RANGE } from '../lib/wwd'; -import { site, lvbt } from '../lib/site'; -import { handleFromUrl } from '../lib/social'; import { partners, contactEmail, joinMailto } from '../lib/partners'; -// Partners page: the roster (from "Show the organizations taking part on -// the Partners page"), the "Bring your organization" invitation, a -// simplified banners-and-embed section, and a link to the printable flyer -// at /partners/flyer. The full partner kit — an organization picker, per- -// partner QR codes and download buttons for real banner image files — is -// out of scope until the roster has its first confirmed partner; see the -// build report for the decisions made to reach this simplified version. +// Partners, /partners: the organizations taking part, and how another +// group can join. Every partner comes from the roster in +// src/data/partners.ts; with none yet, the roster is left out entirely and +// the page opens with "Bring your organization". +// +// After the week ends (12:00 am October 9, 2026, Las Vegas time, by the +// phone's clock), /scripts/partners.js changes the roster heading to "Took +// part in 2026" and swaps "Bring your organization" for a note about next +// year. Without JavaScript the page keeps its during-the-week text. const title = 'Partners · Week Without Driving Las Vegas'; const description = 'Organizations across the Las Vegas Valley taking part in Week Without Driving, and how your group can join.'; -const roster = partners.slice().sort((a, b) => a.name.localeCompare(b.name)); -const hasRoster = roster.length > 0; - -// The week ends 2026-10-09T07:00:00Z (12:00 am October 9, Las Vegas time); -// `wwd.end` already carries that instant. -const campaignOver = Date.now() > wwd.end.getTime(); - -// Groups taking part: a logo wall, not the detailed writeup below it. It -// appears once the roster has its first confirmed partner. - -const siteHost = site.url.replace(/^https?:\/\//, ''); -const igHandle = handleFromUrl(lvbt.instagramUrl) ?? '@lasvegasfortransit'; -const dateRangeWithYear = `${WWD_DATE_RANGE}, ${wwd.year}`; - -// Partner toolkit — sample social posts, ready to copy. Each includes the -// hashtag, the Instagram handle, and the site so a partner can post it -// as-is. Copy behavior reuses public/scripts/partners.js's existing -// data-copy-target handling. -const samplePosts = [ - `We're taking part in Week Without Driving, ${dateRangeWithYear}. Get around by bus, walking or rolling, biking, or getting a ride. Sign up to win a free month of bus rides at ${siteHost}. Tag ${igHandle} and use ${wwd.hashtag}.`, - `How would you get around Las Vegas without a car? Find out with us during Week Without Driving, ${dateRangeWithYear}. Sign up to win a free month of bus rides at ${siteHost}. ${wwd.hashtag} ${igHandle}`, - `Anyone can take part: Week Without Driving is ${dateRangeWithYear} in Las Vegas. Join us and sign up to win at ${siteHost}. ${wwd.hashtag} ${igHandle}`, -]; - -const staffEmailSubject = `Join us for Week Without Driving, ${dateRangeWithYear}`; -const staffEmailBody = [ - 'Hi everyone,', - '', - `Our group is taking part in Week Without Driving, ${dateRangeWithYear}. Try getting around without driving: by bus, walking or rolling, biking, or getting a ride. Anyone can take part, no sign-up needed.`, - '', - `Sign up to win a free month of bus rides at ${siteHost}.`, - '', - 'Thanks,', - '[Your name]', -].join('\n'); -const staffEmailTemplate = `Subject: ${staffEmailSubject}\n\n${staffEmailBody}`; - -const logoMailto = `mailto:${contactEmail}?subject=${encodeURIComponent( - 'Partner logo: [your group]', -)}&body=${encodeURIComponent( - ['Group name:', 'Website:', 'Logo attached as PNG or SVG? (yes/no):'].join('\n'), -)}`; - const weWantToHear = [ 'Disability and senior advocates', 'Student groups and school clubs', @@ -76,106 +32,26 @@ const whatPartnersDo = [ "Co-host a group walk, roll or ride during the week. We'll help plan the route.", 'Hand out flyers or paper bingo cards at your meetings and events.', ]; - -// Three of the four fixed banner sizes from "Give each partner banners, a -// link and an embed snippet" — the build brief asks for three simple -// mockups rather than the full four-banner, per-partner kit. -const banners = [ - { - name: 'Square post', - dims: '1080 × 1080', - purpose: 'For Instagram and Facebook posts.', - aspect: '1 / 1', - }, - { - name: 'Story', - dims: '1080 × 1920', - purpose: 'For Instagram and Facebook stories and WhatsApp status.', - aspect: '9 / 16', - }, - { - name: 'Website box', - dims: '300 × 250', - purpose: 'For a website sidebar or newsletter.', - aspect: '300 / 250', - }, -]; - -const embedSnippet = ` - Week Without Driving Las Vegas, October 1 to 8, 2026. Get around by bus, walking or rolling, biking, or getting a ride. Sign up to win at lvwwd.org. -`; --- -
+

Partners

-
-

- { - hasRoster - ? 'Groups across the Las Vegas Valley are bringing Week Without Driving to their members, neighbors, students and staff.' - : 'Workplaces, schools, churches, clubs and neighborhood groups can bring the week to their people. Join, and your logo goes on this wall.' - } -

- { - hasRoster && ( - <> -

- {hasRoster - ? campaignOver - ? 'Took part in 2026' - : 'Taking part in 2026' - : 'Groups taking part'} -

- - - ) - } - - { - hasRoster && ( -
    - {roster.map((partner) => ( + { + partners.length > 0 && ( +
    +

    + Groups across the Las Vegas Valley are bringing Week Without Driving to their members, + neighbors, students and staff. +

    +

    + Taking part in 2026 +

    + - ) - } -
    - - { - campaignOver ? ( -
    -

    Bring your organization

    -

    - Week Without Driving 2026 has ended. Want to take part next year? Email{' '} - - {contactEmail} - {' '} - and we'll let you know when planning starts. -

    -
    - ) : ( -
    -

    Bring your organization

    -

    - Week Without Driving is for everyone who gets around Las Vegas without driving, and for - the groups that stand with them. Partnering is free, and any size of group can join, - from a block club to a big employer. -

    - -
    -
    -

    We'd love to hear from:

    -
      - {weWantToHear.map((item) => ( -
    • {item}
      • - ))} -
    -
    -
    -

    - What partners do. Pick any of these. There's no minimum. -

    -
      - {whatPartnersDo.map((item) => ( -
    • {item}
      • - ))} -
    -
    -
    - -

    - You get your group's name on this page, your own link and QR code, banners and flyers to - print, and an email after the week telling you how many people signed up through your - link. -

    - -
    -

    How to join

    -

    - Email {contactEmail} with your group's name, a link to your website or social media - page if you have one, which kind of group you are, and one sentence on how you'll take - part. We reply within 3 days and add you to this page. -

    -
    - - -
    - {contactEmail} - {/* Progressive enhancement: hidden until public/scripts/partners.js - confirms the clipboard API can run; the address above always - stays visible as plain text either way. */} - -
    -
    -

    -

    ) } - { - !campaignOver && ( -
    -

    Partner toolkit

    -

    - Ready-to-use posts, an email for your staff or members, and how to send us your logo. -

    - -
    -

    Sample posts

    -

    - Copy one and post it on Instagram or Facebook, as is or in your own words. -

    -
      - {samplePosts.map((post, index) => ( -
    • -

      - {post} -

      -
      - -
      -

      -

      • - ))} -
    -
    + -
    -

    Email to your staff or members

    -

    - Copy this and paste it into an email, or edit it first. -

    -
    -

    - {staffEmailTemplate} -

    -
    - -
    -

    -

    -
    +
    +

    Bring your organization

    +

    + Week Without Driving is for everyone who gets around Las Vegas without driving, and for the + groups that stand with them. Partnering is free, and any size of group can join, from a + block club to a big employer. +

    -
    -

    Send us your logo

    -
    -

    - Partner groups appear on lvwwd.org with their logo. For now, email us your group's - name, website, and your logo attached as a PNG or SVG, and we'll add it. -

    -
    - - -
    -
    -
    +
    +
    +

    We'd love to hear from:

    +
      + {weWantToHear.map((item) =>
    • {item}
      • )} +
    - ) - } - - { - !campaignOver && ( -
    -

    Banners and embed

    -

    - These are LVBT's general materials, for now. These don't credit any organization — once - your group joins as a partner, we'll set you up with your own link, QR code and banners - that credit it instead. -

    - -
      - {banners.map((banner) => ( -
    • - -

      - {banner.name}, {banner.dims} -

      -

      {banner.purpose}

      -
      • - ))} +
      +

      What partners do. Pick any of these. There's no minimum.

      +
        + {whatPartnersDo.map((item) =>
      • {item}
        • )}
      - -
      -

      Embed snippet

      -

      - For your website. Copy this and paste it into your site's HTML where you want the - banner. It shows the banner with its image description built in, links to lvwwd.org, - and loads no scripts or cookies. -

      - 
      -              {embedSnippet}
-
      -
      - -
      -

      -

      - ) - } +
    - { - !campaignOver && ( -
    -

    Flyers

    -

    - Print these for tables, meetings and noticeboards. They work in black and white, and - they carry a QR code and link so anyone without a smartphone can still get to lvwwd.org. -

    -
    - + You get your group's name on this page, your own link and QR code, banners and flyers to + print, and an email after the week telling you how many people signed up through your link. +

    + +
    +

    How to join

    +

    + Email {contactEmail} with your group's name, a link to your website or social media page if + you have one, which kind of group you are, and one sentence on how you'll take part. We reply + within 3 days and add you to this page. +

    +
    + + +
    + {contactEmail} + {/* Shown by /scripts/partners.js; the address stays visible as text without it. */} +
    - {/* A one-page, print-ready flyer at /partners/flyer, built with the - site's own print styles — a real page, not a generated PDF. Real - per-partner PDF downloads (full-page and 4-per-page handout) are - built by "Publish partner banners and an embed snippet". */}
    - ) - } +

    +
    +
diff --git a/apps/site/src/pages/partners/flyer.astro b/apps/site/src/pages/partners/flyer.astro index 509b6bf..9b63e29 100644 --- a/apps/site/src/pages/partners/flyer.astro +++ b/apps/site/src/pages/partners/flyer.astro @@ -3,15 +3,9 @@ import BaseLayout from '../../layouts/BaseLayout.astro'; import { encodeQr, qrPathData } from '../../lib/qrcode'; import { contactEmail } from '../../lib/partners'; -// The printable flyer's real print view (see "Give each partner a -// printable flyer with its QR code"). This is LVBT's general-materials -// flyer — no partner slug, so no "Shared by" line — since the roster has -// no confirmed partners yet. It is a normal page styled to print as one -// US Letter sheet, not a generated PDF: /partners.astro links here as its -// "View the printable flyer" download-link placeholder. Real per-partner -// PDF downloads (full-page and 4-per-page handout, with the partner's own -// QR code) are built by "Publish partner banners and an embed snippet" -//. +// LVBT's printable flyer: a normal page styled to print as one US Letter +// sheet, not a generated PDF. The partner kit on /partners links here. Its +// QR code opens lvwwd.org, so it credits no organization. const title = 'Printable flyer · Week Without Driving Las Vegas'; const description = 'A printable Week Without Driving Las Vegas flyer with a QR code to lvwwd.org.'; diff --git a/apps/site/src/pages/partners/qr/[file].ts b/apps/site/src/pages/partners/qr/[file].ts new file mode 100644 index 0000000..ace0283 --- /dev/null +++ b/apps/site/src/pages/partners/qr/[file].ts @@ -0,0 +1,33 @@ +import type { APIRoute, GetStaticPaths } from 'astro'; + +import { GENERAL, partnerLink, partners } from '../../../lib/partners'; +import { qrPng } from '../../../lib/png'; +import { encodeQr, qrSvg } from '../../../lib/qrcode'; + +// Every partner's QR code, and LVBT's general one, as files the partner kit +// offers for download and the flyers print: /partners/qr/.png (1024 +// pixels square) and /partners/qr/.svg, each opening the partner's +// giveaway link exactly. + +export const getStaticPaths = (() => + [GENERAL, ...partners.map((partner) => partner.slug)].flatMap((slug) => + (['png', 'svg'] as const).map((kind) => ({ + params: { file: `${slug}.${kind}` }, + props: { slug, kind }, + })), + )) satisfies GetStaticPaths; + +interface Props { + slug: string; + kind: 'png' | 'svg'; +} + +export const GET: APIRoute = ({ props }) => { + const link = partnerLink(props.slug); + const qr = encodeQr(link); + if (props.kind === 'png') { + return new Response(qrPng(qr), { headers: { 'Content-Type': 'image/png' } }); + } + const title = `QR code for ${link.replace(/^https:\/\//, '')}`; + return new Response(qrSvg(qr, title), { headers: { 'Content-Type': 'image/svg+xml' } }); +}; diff --git a/apps/site/tests/api-partner-credit.test.ts b/apps/site/tests/api-partner-credit.test.ts index 1b9ec98..2b44e93 100644 --- a/apps/site/tests/api-partner-credit.test.ts +++ b/apps/site/tests/api-partner-credit.test.ts @@ -1,6 +1,6 @@ import { afterAll, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest'; -import type * as WwdModule from '../src/lib/wwd'; +import type * as PartnersDataModule from '../src/data/partners'; import { ACCESS_ENV, @@ -20,9 +20,9 @@ import { // Two partners on the roster, for these tests only; the real roster fills // in as LVBT confirms each group. -vi.mock('../src/lib/wwd', async (importOriginal) => { - const real = await importOriginal(); - const partners = [ +vi.mock('../src/data/partners', async (importOriginal) => { + const real = await importOriginal(); + const roster = [ { name: 'East Las Vegas Neighbors', slug: 'east-las-vegas-neighbors', @@ -36,7 +36,7 @@ vi.mock('../src/lib/wwd', async (importOriginal) => { sentence: 'Students who ride.', }, ]; - return { ...real, wwd: { ...real.wwd, partners } }; + return { ...real, roster }; }); const EAST = 'east-las-vegas-neighbors'; diff --git a/apps/site/tests/e2e/partners.spec.ts b/apps/site/tests/e2e/partners.spec.ts new file mode 100644 index 0000000..6a05f8b --- /dev/null +++ b/apps/site/tests/e2e/partners.spec.ts @@ -0,0 +1,89 @@ +import { expect, test } from '@playwright/test'; + +// The Partners page as the site ships it today, with no partner in the +// roster yet. + +test('before the first partner, the page has no roster and opens with how to join', async ({ + page, +}) => { + await page.goto('/partners'); + await expect(page.getByRole('heading', { level: 1, name: 'Partners' })).toBeVisible(); + await expect(page.getByRole('heading', { name: 'Taking part in 2026' })).toHaveCount(0); + await expect(page.getByRole('heading', { name: 'Bring your organization' })).toBeVisible(); + await expect(page.getByText('Partnering is free, and any size of group can join')).toBeVisible(); + await expect(page.getByText('Neighborhood and community groups')).toBeVisible(); +}); + +test('"Email us to join" opens an email with the subject and the five lines', async ({ page }) => { + await page.goto('/partners'); + const href = await page.getByRole('link', { name: 'Email us to join' }).getAttribute('href'); + const url = new URL(href ?? ''); + expect(url.protocol + url.pathname).toBe('mailto:wwd@lasvegasfortransit.org'); + expect(url.searchParams.get('subject')).toBe('Week Without Driving partnership'); + expect(url.searchParams.get('body')?.split('\n')).toEqual([ + 'Group name:', + 'Website or social media page (if you have one):', + 'Kind of group:', + "How we'll take part:", + 'Contact name:', + ]); +}); + +test('"Copy email address" copies the address and reads "Copied"', async ({ page, context }) => { + await context.grantPermissions(['clipboard-read', 'clipboard-write']); + await page.goto('/partners'); + const button = page.getByRole('button', { name: 'Copy email address' }); + await button.click(); + await expect(page.getByRole('button', { name: 'Copied' })).toBeVisible(); + await expect(page.locator('#join-copy-status')).toHaveText('Copied'); + expect(await page.evaluate(() => navigator.clipboard.readText())).toBe( + 'wwd@lasvegasfortransit.org', + ); +}); + +test("LVBT's general QR code files exist at their addresses", async ({ request }) => { + for (const path of ['/partners/qr/general.png', '/partners/qr/general.svg']) { + expect((await request.get(path)).status(), path).toBe(200); + } +}); + +test('after the week, "Bring your organization" gives way to a note about next year', async ({ + page, +}) => { + await page.clock.setFixedTime(new Date('2026-10-09T07:00:00Z')); + await page.goto('/partners'); + await expect(page.getByRole('heading', { name: 'Bring your organization' })).toBeHidden(); + await expect( + page.getByText('Week Without Driving 2026 has ended. Want to take part next year?'), + ).toBeVisible(); +}); + +test('one moment before the week ends, the page is unchanged', async ({ page }) => { + await page.clock.setFixedTime(new Date('2026-10-09T06:59:59.999Z')); + await page.goto('/partners'); + await expect(page.getByRole('heading', { name: 'Bring your organization' })).toBeVisible(); +}); + +test('the page never scrolls sideways on a phone or a tablet', async ({ page }) => { + for (const width of [375, 768]) { + await page.setViewportSize({ width, height: 900 }); + await page.goto('/partners'); + const overflow = await page.evaluate( + () => document.documentElement.scrollWidth - document.documentElement.clientWidth, + ); + expect(overflow, `at ${width} pixels`).toBeLessThanOrEqual(0); + } +}); + +test.describe('with JavaScript off', () => { + test.use({ javaScriptEnabled: false }); + + test('the address stays visible without its copy button', async ({ page }) => { + await page.goto('/partners'); + await expect(page.getByRole('button', { name: 'Copy email address' })).toBeHidden(); + await expect( + page.locator('[data-partners-join]').getByText('wwd@lasvegasfortransit.org', { exact: true }), + ).toBeVisible(); + await expect(page.getByRole('heading', { name: 'Bring your organization' })).toBeVisible(); + }); +}); diff --git a/apps/site/tests/partners.test.ts b/apps/site/tests/partners.test.ts new file mode 100644 index 0000000..767c0c0 --- /dev/null +++ b/apps/site/tests/partners.test.ts @@ -0,0 +1,139 @@ +import { inflateSync } from 'node:zlib'; + +import { describe, expect, it } from 'vitest'; + +import { + checkRoster, + GENERAL, + PARTNER_TYPES, + partnerLink, + qrFiles, + sortPartners, + type RosterItem, + type UncheckedItem, +} from '../src/lib/partners'; +import { qrPng } from '../src/lib/png'; +import { encodeQr, QUIET_ZONE } from '../src/lib/qrcode'; + +const example: RosterItem = { + slug: 'example-club', + name: 'Example Club', + url: 'https://example.org', + type: 'Student groups', + sentence: 'Our members are taking the bus to class together on October 6.', +}; + +function problemsFor(item: UncheckedItem, others: RosterItem[] = []): string { + try { + checkRoster([...others, item]); + return ''; + } catch (error) { + return (error as Error).message; + } +} + +describe('the partner roster', () => { + it('accepts a correct item, and an item with no website', () => { + const { url: _url, ...noWebsite } = example; + expect(checkRoster([example, { ...noWebsite, slug: 'no-site', name: 'No Site' }])).toHaveLength( + 2, + ); + }); + + const cases: Array<[string, UncheckedItem, string]> = [ + ['a missing name', { name: '' }, 'item 1: it has no name'], + ['a missing sentence', { sentence: undefined }, 'it has no sentence'], + ['capitals in the slug', { slug: 'Example-Club' }, 'its slug "Example-Club" must be lowercase'], + ['a double hyphen', { slug: 'example--club' }, 'must be lowercase letters and digits'], + ['a slug over 40 characters', { slug: 'a'.repeat(41) }, 'longer than 40 characters'], + ['the slug general', { slug: GENERAL }, 'is kept for LVBT'], + ['a website without https', { url: 'http://example.org' }, 'must start with https://'], + ['a type spelled differently', { type: 'Student Groups' }, 'its type "Student Groups"'], + ['a sentence over 200 characters', { sentence: 'a'.repeat(201) }, 'more than 200'], + ]; + it.each(cases)('stops the build, naming the partner, for %s', (_case, change, problem) => { + const message = problemsFor({ ...example, ...change }); + expect(message).toContain(problem); + if (change.name !== '') expect(message).toContain('"Example Club"'); + }); + + it('stops the build when two partners share a slug', () => { + const message = problemsFor({ ...example, name: 'Example Club Two' }, [example]); + expect(message).toContain( + '"Example Club Two": its slug "example-club" is already used by "Example Club"', + ); + }); + + it('knows exactly the six types', () => { + expect(PARTNER_TYPES).toEqual([ + 'Community and neighborhood groups', + 'Student groups', + 'Environmental and justice groups', + 'Disability and senior advocates', + 'Employers and businesses', + 'Public agencies', + ]); + }); + + it('sorts by name, ignoring capitals and a leading "The "', () => { + const names = ['Zeta Riders', 'The Example Club', 'alpha walkers', 'Bus Buddies']; + const sorted = sortPartners(names.map((name, i) => ({ ...example, slug: `p${i}`, name }))); + expect(sorted.map((p) => p.name)).toEqual([ + 'alpha walkers', + 'Bus Buddies', + 'The Example Club', + 'Zeta Riders', + ]); + }); + + it('gives each partner a giveaway link and QR files, and LVBT a general pair', () => { + expect(partnerLink('example-club')).toBe('https://lvwwd.org/giveaway?ref=example-club'); + expect(partnerLink(GENERAL)).toBe('https://lvwwd.org/giveaway'); + expect(qrFiles('example-club')).toEqual({ + png: '/partners/qr/example-club.png', + svg: '/partners/qr/example-club.svg', + }); + }); +}); + +/** Reads a one-bit grayscale PNG back into rows of dark (true) and light pixels. */ +function readPng(file: Uint8Array) { + const view = new DataView(file.buffer, file.byteOffset, file.byteLength); + const width = view.getUint32(16); + const height = view.getUint32(20); + const idat: Uint8Array[] = []; + for (let offset = 8; offset < file.length;) { + const length = view.getUint32(offset); + const type = new TextDecoder().decode(file.subarray(offset + 4, offset + 8)); + if (type === 'IDAT') idat.push(file.subarray(offset + 8, offset + 8 + length)); + offset += 12 + length; + } + const joined = new Uint8Array(idat.reduce((sum, part) => sum + part.length, 0)); + idat.reduce((offset, part) => { + joined.set(part, offset); + return offset + part.length; + }, 0); + const raw = inflateSync(joined); + const rowBytes = Math.ceil(width / 8) + 1; + const darkAt = (x: number, y: number) => + ((raw[y * rowBytes + 1 + (x >> 3)] ?? 0) & (0x80 >> (x & 7))) === 0; + return { width, height, bitDepth: file[24], darkAt }; +} + +describe('the QR code PNG files', () => { + it('are 1024 pixels square, black modules on white with the quiet zone, matching the code', () => { + const qr = encodeQr(partnerLink('example-club')); + const png = readPng(qrPng(qr)); + expect([png.width, png.height, png.bitDepth]).toEqual([1024, 1024, 1]); + const modules = qr.size + QUIET_ZONE * 2; + const center = (module: number) => Math.floor(((module + 0.5) * 1024) / modules); + for (let r = -QUIET_ZONE; r < qr.size + QUIET_ZONE; r++) { + for (let c = -QUIET_ZONE; c < qr.size + QUIET_ZONE; c++) { + const expected = qr.matrix[r]?.[c] === true; + expect(png.darkAt(center(c + QUIET_ZONE), center(r + QUIET_ZONE)), `module ${r},${c}`).toBe( + expected, + ); + } + } + }); +}); diff --git a/docs/README.md b/docs/README.md index d0e68d3..b21113a 100644 --- a/docs/README.md +++ b/docs/README.md @@ -12,6 +12,7 @@ for), and `security`. Every document is listed here so it can be found. ## How-to guides - [Set up lvwwd.org's production](operations/how-to/set-up-production.md) +- [Add a partner organization](operations/how-to/add-a-partner.md) ## Reference diff --git a/docs/operations/how-to/add-a-partner.md b/docs/operations/how-to/add-a-partner.md new file mode 100644 index 0000000..a784f0c --- /dev/null +++ b/docs/operations/how-to/add-a-partner.md @@ -0,0 +1,58 @@ +# Add a partner organization + +This guide puts an organization on the [Partners page](https://lvwwd.org/partners) and gives it its +own link and QR code. Do it once the organization has confirmed, by email, the sentence and type you +proposed. + +## Before you start + +- You can open a pull request on `LasVegasForTransit/week-without-driving`. +- You have the organization's name as it wants it shown, its website or social media page (if it has + one), its type, and its one sentence. + +## 1. Choose its slug + +The slug is the organization's short name in its link, such as `example-club` in +`https://lvwwd.org/giveaway?ref=example-club`. Use lowercase letters and digits, with single hyphens +between words, at most 40 characters. `general` is kept for LVBT's own materials. + +Once the organization has shared its link or printed its QR code, never change its slug. + +## 2. Add one item to the roster + +Open [`apps/site/src/data/partners.ts`](../../../apps/site/src/data/partners.ts) and add one item to +the `roster` list: + +```ts +{ + slug: 'example-club', + name: 'Example Club', + url: 'https://example.org', + type: 'Student groups', + sentence: 'Our members are taking the bus to class together on October 6.', +}, +``` + +- `url` is optional. When there is one, it starts with `https://`. +- `type` is exactly one of: `Community and neighborhood groups`, `Student groups`, + `Environmental and justice groups`, `Disability and senior advocates`, `Employers and businesses`, + `Public agencies`. +- `sentence` is at most 200 characters. + +The order of the list does not matter. The page sorts partners by name. + +## 3. Check it and publish + +```bash +pnpm build +``` + +If an item breaks a rule, the build stops and names the organization and the problem. Fix it and +build again. Then open a pull request. Once it merges, the site deploys, and the organization +appears on the Partners page, in the partner kit's list, and on the home page. Its QR code files are +at `/partners/qr/.png` and `/partners/qr/.svg`. + +## Change or remove a partner + +Edit or delete its item in the same file within 3 days of the organization's email, and publish the +same way. Keep the slug of a partner that stays. From 2dac3376d22a4acae4c8c02ed1d490f2d3d771dc Mon Sep 17 00:00:00 2001 From: Willie Chalmers III Date: Wed, 23 Sep 2026 17:38:13 -0700 Subject: [PATCH 4/5] feat(site): Give partners banners, their link and an embed snippet The Partners page now ends with the partner kit. A partner picks its name under "Your organization" and gets its giveaway link with "Copy link", its QR code with PNG and SVG downloads, the four banners with "Download" and "Copy image description", a posting tip, and an embed snippet for its website in two sizes with a live preview. The page address becomes /partners#kit-, so the choice can be bookmarked or sent on, and opening that address picks it again. "None (general materials)" gives LVBT's own link, which credits no one; with no partner in the roster yet, it is the only choice. The flyer link sits at the end of the kit. The four banners are real images at lvwwd.org/partners/banners/: a square post, a story, a website box and a website strip. Each shows "Week Without Driving Las Vegas", "October 1 to 8, 2026" and "Sign up to win at lvwwd.org" in the site's own fonts and colors, every text at 4.5 to 1 or more, and weighs under 45 KB. scripts/build-banners.mjs draws them with the Chromium the tests already use, so a new design is one command away, and LVBT's media committee can replace any file with its own at the same address. The embed snippet is only a link and an image, so partners' pages load no script and set no cookie. The Worker sends the banners with Access-Control-Allow-Origin, Cross-Origin-Resource-Policy and a day of caching, so any site can show them. The kit shows only a closing note from 12:00 am October 9, and asks for an email with JavaScript off. Co-Authored-By: Claude Opus 5.5 --- .../public/partners/banners/1080x1080.png | Bin 0 -> 30596 bytes .../public/partners/banners/1080x1920.png | Bin 0 -> 42539 bytes apps/site/public/partners/banners/300x250.png | Bin 0 -> 7966 bytes apps/site/public/partners/banners/728x90.png | Bin 0 -> 6665 bytes apps/site/public/scripts/partner-kit.js | 109 ++++++ apps/site/scripts/build-banners.mjs | 108 ++++++ apps/site/src/components/PartnerKit.astro | 349 ++++++++++++++++++ apps/site/src/lib/banners.ts | 80 ++++ apps/site/src/pages/partners.astro | 8 +- apps/site/tests/e2e/partners.spec.ts | 210 ++++++++++- apps/site/tests/partners.test.ts | 72 ++++ apps/site/worker/banners.ts | 29 ++ apps/site/worker/index.ts | 10 +- 13 files changed, 961 insertions(+), 14 deletions(-) create mode 100644 apps/site/public/partners/banners/1080x1080.png create mode 100644 apps/site/public/partners/banners/1080x1920.png create mode 100644 apps/site/public/partners/banners/300x250.png create mode 100644 apps/site/public/partners/banners/728x90.png create mode 100644 apps/site/public/scripts/partner-kit.js create mode 100644 apps/site/scripts/build-banners.mjs create mode 100644 apps/site/src/components/PartnerKit.astro create mode 100644 apps/site/src/lib/banners.ts create mode 100644 apps/site/worker/banners.ts diff --git a/apps/site/public/partners/banners/1080x1080.png b/apps/site/public/partners/banners/1080x1080.png new file mode 100644 index 0000000000000000000000000000000000000000..4b4fb7dda6faa29409a9046272c8ff7d7bb50a98 GIT binary patch literal 30596 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%0ADg`XAtW@=Q^gZFXOeEPbX@L8@864l7|x0jte3 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%0Af0spMVA($E1F5VnLsJJ!3iL|Nl%t l@!xKi{qM&A`5I8Aotmc63CD!2fBY+q9>h?q?12OFzW{XYLvR29 literal 0 HcmV?d00001 diff --git a/apps/site/public/partners/banners/300x250.png b/apps/site/public/partners/banners/300x250.png new file mode 100644 index 0000000000000000000000000000000000000000..db366eaa9b83689aedf5a9d691b76890691e0e71 GIT binary patch literal 7966 zcma)>bxa%%?C4<(hT9lAh8^z1-QAsoG3;=6cXxNU!J*@@;VuUpez?017%&+6zQ5$< z<^A{GCu!5a+B9v`CXG>7mBT_OMMpqDz*3Nx)jQk9Nhlh95|I#kmBP$-W=eVSiRXPKHVNpAMIcN-kCbwyT9K1d%Z_sZtIwzOJ?mz zVe3pw_>slcb7Ftz_Hq~B%tkaMVqj+U@Mx`Rq<3s#Tq`dA>~!Pue4E75KJjPG!QpD} z^l$|D$H>l>GVSM!vrU`q%-PlHidJNWwCz~a|&3nyIJh`)zm4qOtwXt`7wMd53uDG;j z3g%x|FB=yAYka^gx4^v;ytFaL@9iHi!eUuaY@Cu>JJ6*V9@Q~1I6ODTl zgB+Vm{k4?i@bXuROf4@p(R6s?kWO($hvE+?~ z%#xv~A0GpmF=*Ucy}&{zzP-I|5iUhVs!m4^8R>!P33GiW9Mu*|6=$V&^cdF>3K3v5 zV4^T)q57%J6JK9lr^s!RldqAK7W}iZN}gLMB_q74sZEtH*+N&(%t${mF{HA5NJ~&Q zDlSio!|^Mv2`lxvjdG2pRzZ7nr92luIT5>wX1m7(jO3P>T zM6B6qfo%%5#ulqKs?*kL0;VQCRvH^NDt%TOS=oOX{~HN3XL+C- z0s;p9{|MsTM&L670@;v)w1l?z>cuxNac#L*ip(~rt)IX82Fwr$_``DPq5)=OY!Y2a1s@DGw3%>tL& z1CCCZ7UvYZ#}(~|50%zJgU+c-WJ)f`Ys+N*lLrgZ3{Bde=M!3G9A6Oh0=^>bl_!m9 zrEP0hey8K=N zEWNTc%WoZMg9o38odknnYQ=T@Z_>5~KZBfGNcYUbM`U+crAH=P%RjQD|px3r11{YRJ#y}3gG0Ogy3*s3!(`|!zyxKB^I^w6<@y( z@rzP8O|jJ5@)Pkl`iH~Jv!r*L#22@Fz$V%pqA@>qG%1bWZd`PPWF-H1xV`QtHd^UJY?@F$ z;=G+8c(ryu3g|+|Nd>-ED^Z@0{&`p>(}ziZ)n&u2kY{f}IX!&hHC{r#A5T?z@X);Y z@Zpz#Xxyq1PL%`hojqJ>nUJO?z3cqr!)KnWuqxL>r0PA7#jTjyz5RiVF1V%HwUSHy z9;aVOjr|q638kK?r-BQhJXlcu!I3{anUq>r8u^Bv6+43TJ`e?#XAy>iej3~ zZ`K2JInv)Nj*+bG7bs^m2Y~hQhoOJ7<3yBnk;84Qzl7(BGo9hvQ-jh=t{5!aNWT`L zL+)A76eqGj(AE<{b*>z%zou+$qrowOx@Urn0qyfrN{|((xhrf~Iv(EQgVqvc2-~UG zv*^sFZ*O%y!&6EgA&&ETTKldum7Ndt%&~t4HWYR92O1F#OtroK_HzrZ zt$d$&f!9;LJ$fyVXQzui^?)YGmU}=&7NNV@^$QFl2BOSypY< z`1hCY_dN^HB$a^-wt@{8q2UX@XD%UZ7MCl^UrvwHPb*>vUM$i+71ojnqKTgf3Y?TP zq`V;lCqKKUkjqfa#awXfnnh1}I2H{zB`#W1|Gj~xUTVen&@&s(Drm8HeC%(jV0=^? zBdt#Rp>N=*c8K+ z=|zy|rL|mt3FwVhRd^WH65y9|pE`r-Uol9IzC~vRw)krS^lUVY0|ij`Z1YcN7DTjXXNcqIh3XtyXznNydb+Xu=@MWUuJm+##e!5HVR= zJHzNoN6(c8JAAX;(>q*#lSq1lx*^ zK~RNTGf z0M0J-y5rF9aVz&?Zp0j_r(J^L25eAw2>Y2az(fvAol)?aND6CQ>iMW!4#>y`H_+WX z>i&^*9V>OXi?2-;$GN*y^vWW@if;FsExLKRIC73`fE&rFgw7^GsU3sBC_QiT&f}Uj z<<9T%cWKKEZ{m{k3ptG)6^_&GtS2IQq{&ygqN3&98Q(B(h{S!-mi}$O|%LgE$QBEeJ)vfhK<@F`9r5H?Eu|uMpnNw zQXcU>&!tV2Mj1xnuMwBs?fF%^X zF(hJhEVLwyz^+hP`^;J*B!0eMbg&V82Q%vyS;M7Yl1RFq#TXAC_^NFV%$h;jvFudW z{TB8hdJZG*94zKtBQ5*uMX=_~Am+|Ew~mc?N@@S*XxImMEJ*xY->`P^QnYDpt z(|_a7I;)Uq!^>x6cNjtzVB!x&l67ZFv&Yy{iLAe@QUitU`d1n2?%@YWkp%AJ_1B>q zb(c9BRh@vUgLIAhdFzeuF?V^F6aRaEog#Y+;;Lc)Ni1IcepD#}z(J;S4-hGH@O}&6 zsgQ2In=FmmFF_avY;rX<))zEJSs~hir}(_{e&AG7KxC{2FlS|*uoUnrU5(`0zDVu>Cq%ZX`GN#hXH`hcy8E_BO!CNe&e=a#lReiN}*c2=5AuhkGBAhMV`xl zp`O$FmB}AHc8HO6T8L}B>@NwjlgTn8rUW$#NTY(Ot@=$4YXv|o%evwFEe?G~j^>-e zSm{Z-b$V%0lxRB@>R$ncGIAf5u79%p;V5cRr_K|y03ag(uhGfqFQ6z{E88T` z<>57nAv^_PZrP`@&5Y;Z`6SUE5UDma6Std>@)s$h7Q|z}%gCX(Vz2cvqgI}k43AEv zDc=$S-0g=1j!!(iDRF37>Awq+)$Oo#@*V(5cX0YNCbDEIwTGamQVkc>PDRsGrtR3U!B-I5X>1f?V8p4F=_b@*NHfq9Og=z5W;TDC_RqbURq(&O8h)_((Z|Kc zaSExn8wdff7mNX3)M)+*G#Vx;GRPCZie(}Cf_kN9@eKtmY*GL9@hiJtK1(60uC;Ug zwGVxqm1(>LpM);=Z4vz_z>*a!8eRg*lxk6zy>4{Bot{}Mu}{p-D>R6{6|iNe$=WX= zA&sbO`Tf8J*eidl>eH9Ei+rqWNV#`f<(P2Iu&U>-SO7!CV}!*tiFEl>qrRKTw4}_w z*w^R@$)Q-v`yNU5TGjT73b58Y$R@uIlBv`!fQoTnSB#>~#Wz!ghn|*`5r;^=V$W8( zA(qf+1ca|wFgzXBW1`Q}PgzkRUXF1vV0AQ*)CV5Hl{t3Fhn!R?$uiNPt5zoO3MEGT z9w|rV4yZ!$FNy2VL`JJNB@ujz#uCqZoDbuH(qpUA7>c%i$^~5Ze)3luhShE(xrLnO ziy(sLkDy}ToFb1JMqR=eGfmtDp+$emJ4&&d3D%AKP|q!bmfp!Ff60)dqKf8UE$^eQ z6W~wQQ4JpxW~GQwI=*-=Hmtj09G4gmMFu{38S_>X{R5V?1sZp0WJyUbu`MUP2Uh*a zXp29++Rk1jlp*Dz<94_1rj0w~>@&cL4oX`q8>xvq-rju;1}Fs<--{HTVFE#C@zZfL zb0lMTWiRe37;@e~3G@U824egkBfjF6UkB;6j)}^~6R+WnMi%WpL~no^0g7OVOFNo5 zg>@^3ATsfznwI$kOX(WA=7+rN>(eYq9+NC_b*~GBT6|9t7FSeLf8Go(?Ft3-RB9lU z#}3D?hBlSK*3ZnaOo@8(ebmoB>AxuZrpRDxNT~LjlT9fMe)Ut--Y0d()XBOC=`!rz zjQ{h;0Ya2NVi2=szCL%GVE$HZYNHX#*PpG?6t4TOvw)nOb1lcEPvys=47Oc=3;f-B zRKKXOp9~&-f|kqcAwgMg#UPUZm}0cWHJ4*$9lT=`v@{u%aL%RZAvT1WXXu(-3oEi6 zg<42CX+sU=R-`orQTjo|rC#(kj73yN)ALF;gTDAr8>5HPi-9e@NO2a=!NRqa8MT3G zCK`GG5||qW{sKEJ#(mYm@K{>QO$<=8_6Uumb_ZP?k>?HRr{iC~y1ak{!K5cP$lwc> z9hB=FeSLM1i`m{R#x1DM{Ko3!9#kg!`q>H$f}%JuMx_*XD5g+Kz>=drmE&>($5|Y5 z66CX5T5`{pVy@yqs8$ezkDYkk9NjiZQqj2w31&R4@mvMJH)L@{kuVl5C~=tO8`$N|j~?S(Wr|zg&^DoOrM)h8Zi*(8 z0Nkv4Lf5SNm;#*%-y8zHd^hZH%~QoPr&2Ar@{SHf{47R=;jL%|9*J}3Wsb}#xE5I_ zs$rf>Lg;9qME*B^3UZg{V|}Zso3fN);?4ce$@JUmulnU@V3fjNUmA}Cy8kYRYT*hy zJ2aX~f1{q@`u~D$E9_C;(^+aL{XW44$LuiyakXw!;h$c1e|y%KQY>YL<)+CS5$n{= zNV!?6&%?WQh|7PFpf6Nt(Fj}YR6Xvsh7w#L4~5%s3E9h>T2Xgurq0h3r64=3HScMh zZoFDdAK3P4!OO^?C@bW8e>2LqzzSEzwFhz|0VfgCO-Iob#Sv_Ekx&B_RqqgG&5}HmUO*2n| zJIiJX;q#FXO<|2DdcQi#)kR1XG!Tuo5w|>fJiwA0zGfwhm=Y!MVenv}Mr)uI+SV1S z9r~&=l=4JGpd3THQ(0j_c)=gFA^wDI!P13yd}G~G8m(XMG+HHP!15xG;A5zi9AP9w z!dtP)@)jKEi4P-wA>Ay(Q0+29ogUB`)C-fxmf*2^WrS)OG^iXa^xzc&h{1>fq$l{D zc?4*Zwj=qQB9Vzc?zfS(lKm0E|AV-QHEfE%*4;Bc)8Ac^bbs^WX@X#;hT$ z`MdIdI-0)uK2U+=ZTB$V^JU7PxOQhSnDPwR1)VKdc~IiB1N{IT`tm4z)aySkOEK1ZZJJtT+Qb-o#DH%+8$%G{LFNm(4&6G zJLLJqs84%Mzpb=NBLzGoWhxeMAc=v6;Bry#Ci9nSGG7-_qiTi5Ikp{Zps?; zJ#-ATp~H@?SK91mh%za-y-=hP3Oy-AMTO)$H$;hJJ`f+?y~1%T9R9jf3y-(&S6w}d z6K1pIlU@c2cd+oit+!lFZdchBAFj4PuYc{%af&vY;h-EFC+{=hqFkZ@j=JEFjBe1t z!5Z`9vGY?FWiU8{pN@gcN^=z$Qdqm*9so~$nu1|rLVlD?0_I8qBq}%3i-e!Q#h0yz zPDy|PmN;TRGm<@cvlv!}n$bmoxU9++Ae9JyYL2l-)Dk3aUCCpb=UTt_P9p)V6~9Y$ z3`YFF<0sP|H97vhW)cDZ`(#m#o~g6{;T_Q2Wp&$Zv2?fJ<{>+Z-yfsh_UGAkb9YxK zx0l-;?PP}(^ZdIt%M!DIu&ItBig<}O>UAj73)k5jEwo5`?4NQ#SlfGkATuXgFIucf zWI+X>^;Ue5a?xnLE91GaV(?SuH~PGT^)pOVNFVvseD0AWWPme5^ZzD9*FHd>X{!*BEVZ1EbA$8>i4{BOdMx3FRFVTbEz_x@Wtf?A$3 zQpF0nQ%q7+kMHOcbR7SLaoS4I|4xT?%~wCw@l=8waH7X&2%h!_M@-P3bpJU?b>9F9 zy4@~@Tb129Vp)ye-ME$(0X(kAfgZI{Q!ayEsqUmhXXz(GoiCir*-imhDo^h7oqw6< z>zdl_{q46bzFssNbHdt!Oxprq=!AS%n1C0Rt|*0BmSQmL!1+L`qv(yE_1l(!qz%Vj z?4`>_rJLz1xq#=wy8*pQ3PE;-qX`~J&(G-w?u4ebEy&t*b|6H|!guxcuekT-pn9H# z=TnLnS)I>i4Jg6y-p_6`BT>C`W1c-X)4268fO8{oNWizs5K`#I^h~ah`|_8lm`F`2 z6@L3eTEomY*?|Mk+t7C!l*|4yH-v4FL&HF|)~PomB?iWKwoC$a2fcsY*%l8B_~JK* zt>CMi`u%0uMTE*OA8^4bLJMS`RuWQGnp2&(w;7d6ZJ|l;JnsOJ^W|koK*t;BFGAFX zyfw(#AX*azt2f^^QV;C6gnAT<^b6inSqxc2%d60EL7KTdP%_ zX`1Z>I0a^&qjC`GsL>DgPb*XJGDl!v&Fl-!KzH+Fr{ZHDU=@Na-CpReUbu4-JD#B) z=ibOwA#L;pV1JLJUrDrQc)KZybE_d9EMhlgdXVq;7RLxWSyP5FsJM_!qXo>aL>6o9 z!i*GJSZj4A=J#gM#XS%AEYrdD7#iubjM$vK7bJQ=eGpbDp&Fg|5lI{#lr*HgiEf5j zm#!fBsNsxCrXsi9m-O={Z*_U)%2 z#LAP2;)Rw@^J-z8lV}a9j=&7wMFAGjMZ}0+;pwsGlL|^x#zdg5*C}ev#_W9aQ5m!O zdY=X0*tvR|Cg_(4xs5>P{wztak@7bh#&0Q#8z4F!t zzbjD+kE32p`h9a+v#931c|{S*x%XnFX!hzq^I~k~Co{owuW4j}-rHGT&f**PP|Cs9 zqa_n&y#Kb!)pOFN<<;B2dxX56wIT8O~ egmm=3AuSoF)+m$dgZ_K+At=bGO4m!8g#Ira&~SwS literal 0 HcmV?d00001 diff --git a/apps/site/public/partners/banners/728x90.png b/apps/site/public/partners/banners/728x90.png new file mode 100644 index 0000000000000000000000000000000000000000..e45acb3276d872fb510dfaa30e9e5c86a2a599db GIT binary patch literal 6665 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 Yt0bu>@y!?ics7=zoT}_kX>j in the page address so the choice can + * be bookmarked or sent to a colleague. "None (general materials)" gives + * LVBT's own link, which credits no one. + * + * From 12:00 am October 9, 2026, Las Vegas time, by the phone's clock, the + * kit shows only its closing message. The copy buttons are run by + * /scripts/partners.js. Nothing is fetched or stored. + */ +(() => { + const ENDED = Date.parse('2026-10-09T07:00:00Z'); + const GENERAL = 'general'; + const SIZES = { + '300x250': { width: 300, height: 250 }, + '728x90': { width: 728, height: 90 }, + }; + + const kit = document.querySelector('[data-partner-kit]'); + if (!kit) return; + const part = (name) => kit.querySelector(`[data-kit-${name}]`); + const body = part('body'); + const ended = part('ended'); + if (Date.now() >= ENDED) { + if (ended) ended.hidden = false; + return; + } + if (body) body.hidden = false; + + const picker = part('picker'); + const hint = part('hint'); + const materials = part('materials'); + const link = part('link'); + const general = part('general'); + const qr = part('qr'); + const qrPng = part('qr-png'); + const qrSvg = part('qr-svg'); + const snippet = part('snippet'); + const preview = part('preview'); + const description = kit.dataset.description ?? ''; + if (!(picker instanceof HTMLSelectElement)) return; + + const slugs = new Set(Array.from(picker.options, (option) => option.value).filter(Boolean)); + const linkFor = (slug) => + slug === GENERAL ? 'https://lvwwd.org/giveaway' : `https://lvwwd.org/giveaway?ref=${slug}`; + const chosenSize = () => kit.querySelector('[data-kit-size]:checked')?.value ?? '300x250'; + + function snippetFor(href, size) { + const { width, height } = SIZES[size]; + return [ + ``, + ` ${description}`, + '', + ].join('\n'); + } + + function showSnippet(href) { + const size = chosenSize(); + if (snippet) snippet.value = snippetFor(href, size); + if (!preview) return; + const { width, height } = SIZES[size]; + const anchor = document.createElement('a'); + anchor.href = href; + const image = document.createElement('img'); + image.src = `/partners/banners/${size}.png`; + image.width = width; + image.height = height; + image.alt = description; + image.style.maxWidth = '100%'; + image.style.height = 'auto'; + anchor.append(image); + preview.replaceChildren(anchor); + } + + function show(slug) { + const known = slugs.has(slug); + if (hint) hint.hidden = known; + if (materials) materials.hidden = !known; + if (!known) return; + const href = linkFor(slug); + if (link) link.textContent = href; + if (general) general.hidden = slug !== GENERAL; + if (qr) { + qr.src = `/partners/qr/${slug}.svg`; + qr.alt = `QR code for ${href.replace('https://', '')}`; + } + qrPng?.setAttribute('href', `/partners/qr/${slug}.png`); + qrSvg?.setAttribute('href', `/partners/qr/${slug}.svg`); + showSnippet(href); + } + + function fromAddress() { + const slug = /^#kit-([a-z0-9-]+)$/.exec(window.location.hash)?.[1] ?? ''; + picker.value = slugs.has(slug) ? slug : ''; + show(picker.value); + } + + picker.addEventListener('change', () => { + const slug = picker.value; + if (slugs.has(slug)) window.history.replaceState(null, '', `#kit-${slug}`); + show(slug); + }); + kit.querySelectorAll('[data-kit-size]').forEach((radio) => { + radio.addEventListener('change', () => show(picker.value)); + }); + window.addEventListener('hashchange', fromAddress); + fromAddress(); +})(); diff --git a/apps/site/scripts/build-banners.mjs b/apps/site/scripts/build-banners.mjs new file mode 100644 index 0000000..f978fe8 --- /dev/null +++ b/apps/site/scripts/build-banners.mjs @@ -0,0 +1,108 @@ +#!/usr/bin/env node +// Draws the four partner banners in public/partners/banners from the site's +// own fonts and colors, at their exact pixel sizes. Run it again after the +// banners in src/lib/banners.ts or the drawing below change: +// +// node scripts/build-banners.mjs +// +// Each banner shows "Week Without Driving Las Vegas", "October 1 to 8, +// 2026" and "Sign up to win at lvwwd.org", with the four ways of getting +// around as icons. Partners' websites show these files by their fixed +// addresses, so a new design keeps the same file names. LVBT's media +// committee can also replace any file with its own design of the same size. +// +// Chromium comes with the Playwright the tests already use, and sharp with +// Astro, so the script adds no dependency. Node reads the TypeScript list +// directly. + +import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'; +import { createRequire } from 'node:module'; +import { fileURLToPath } from 'node:url'; + +import { chromium } from '@playwright/test'; + +import { BANNER_COLORS as COLORS, BANNER_LINES as LINES, BANNERS } from '../src/lib/banners.ts'; + +const site = new URL('../', import.meta.url); +const require = createRequire(import.meta.url); +const sharp = createRequire(import.meta.resolve('astro'))('sharp'); +const icons = require('@iconify-json/mdi/icons.json'); + +const font = (file) => + `url(data:font/woff2;base64,${readFileSync(new URL(`public/fonts/${file}`, site)).toString('base64')}) format('woff2')`; +const icon = (name) => + ``; + +// Sizes in each banner's own pixels: [date, headline, button, icon, padding]. +const SCALE = { + '1080x1080': { date: 44, headline: 128, button: 52, icon: 84, pad: 96 }, + '1080x1920': { date: 60, headline: 172, button: 64, icon: 120, pad: 110 }, + '300x250': { date: 14, headline: 31, button: 15, icon: 22, pad: 18 }, + '728x90': { date: 15, headline: 25, button: 17, icon: 0, pad: 20 }, +}; + +function page(banner) { + const s = SCALE[`${banner.width}x${banner.height}`]; + const ways = ['bus', 'walk', 'bike', 'car'].map((name) => icon(name)).join(''); + const body = + banner.layout === 'strip' + ? `
+

${LINES.name}

${LINES.dates}

+

${LINES.signUp}

+
` + : `
+

${LINES.dates}

+

Week Without Driving
Las Vegas

+

${ways}

+

${LINES.signUp}

+
`; + return `${body}`; +} + +const out = fileURLToPath(new URL('public/partners/banners/', site)); +mkdirSync(out, { recursive: true }); +const browser = await chromium.launch(); +try { + for (const banner of BANNERS) { + const context = await browser.newContext({ + viewport: { width: banner.width, height: banner.height }, + deviceScaleFactor: 1, + }); + const tab = await context.newPage(); + await tab.setContent(page(banner)); + await tab.evaluate(() => document.fonts.ready); + const shot = await tab.screenshot({ type: 'png' }); + const png = await sharp(shot) + .png({ palette: true, quality: 100, compressionLevel: 9 }) + .toBuffer(); + writeFileSync(`${out}${banner.file}`, png); + console.log( + `${banner.file}: ${banner.width} × ${banner.height}, ${png.length.toLocaleString()} bytes`, + ); + await context.close(); + } +} finally { + await browser.close(); +} diff --git a/apps/site/src/components/PartnerKit.astro b/apps/site/src/components/PartnerKit.astro new file mode 100644 index 0000000..1bab5ba --- /dev/null +++ b/apps/site/src/components/PartnerKit.astro @@ -0,0 +1,349 @@ +--- +import { Icon } from 'astro-icon/components'; +import { BANNER_DESCRIPTION as DESCRIPTION, BANNERS } from '../lib/banners'; +import { contactEmail, GENERAL, partners } from '../lib/partners'; + +// The partner kit: pick an organization, then get its link, QR code, the +// four banners and an embed snippet for its website. It needs JavaScript +// (/scripts/partner-kit.js fills in the chosen organization's link), so +// without it the kit shows only its heading and a way to ask by email. +// The copy buttons are run by /scripts/partners.js. + +const bannerCards = BANNERS.map((banner) => ({ + ...banner, + size: `${banner.width}x${banner.height}`, + src: `/partners/banners/${banner.file}`, +})); +--- + +
+

Partner kit

+ + + + + + +
+ + diff --git a/apps/site/src/lib/banners.ts b/apps/site/src/lib/banners.ts new file mode 100644 index 0000000..9cd96f7 --- /dev/null +++ b/apps/site/src/lib/banners.ts @@ -0,0 +1,80 @@ +// The partner banners: their sizes, colors and words. The Partners page's +// kit offers them, and scripts/build-banners.mjs draws the PNG files in +// public/partners/banners from this list. + +/** The site's own palette (src/styles/global.css). */ +export const BANNER_COLORS = { + background: '#0e5f66', // --teal-deep, the slab + text: '#fbf4e6', // --sand + quiet: '#cfe7e4', // --slab-mist + button: '#ff6b4a', // --coral-bright + onButton: '#1a1210', // --on-coral +} as const; + +/** Every text on a banner and the color behind it; each must reach 4.5 to 1. */ +export const BANNER_TEXT_PAIRS: ReadonlyArray = [ + ['headline', BANNER_COLORS.text, BANNER_COLORS.background], + ['dates', BANNER_COLORS.quiet, BANNER_COLORS.background], + ['sign-up line', BANNER_COLORS.onButton, BANNER_COLORS.button], +]; + +/** The three lines every banner shows. */ +export const BANNER_LINES = { + name: 'Week Without Driving Las Vegas', + dates: 'October 1 to 8, 2026', + signUp: 'Sign up to win at lvwwd.org', +} as const; + +/** The image description of every banner, and the alt text in the embed snippet. */ +export const BANNER_DESCRIPTION = + 'Week Without Driving Las Vegas, October 1 to 8, 2026. Sign up to win at lvwwd.org.'; + +export interface Banner { + file: string; + width: number; + height: number; + /** The most the file may weigh, so it loads quickly on partners' pages. */ + maxBytes: number; + name: string; + purpose: string; + layout: 'stack' | 'strip'; +} + +export const BANNERS: readonly Banner[] = [ + { + file: '1080x1080.png', + width: 1080, + height: 1080, + maxBytes: 1_000_000, + name: 'Square post', + purpose: 'For Instagram and Facebook posts.', + layout: 'stack', + }, + { + file: '1080x1920.png', + width: 1080, + height: 1920, + maxBytes: 1_500_000, + name: 'Story', + purpose: 'For Instagram and Facebook stories and WhatsApp status.', + layout: 'stack', + }, + { + file: '300x250.png', + width: 300, + height: 250, + maxBytes: 150_000, + name: 'Website box', + purpose: 'For a website sidebar or newsletter.', + layout: 'stack', + }, + { + file: '728x90.png', + width: 728, + height: 90, + maxBytes: 100_000, + name: 'Website strip', + purpose: 'For the top of a web page on a computer.', + layout: 'strip', + }, +]; diff --git a/apps/site/src/pages/partners.astro b/apps/site/src/pages/partners.astro index a2c78e6..b73bb8f 100644 --- a/apps/site/src/pages/partners.astro +++ b/apps/site/src/pages/partners.astro @@ -1,10 +1,11 @@ --- import BaseLayout from '../layouts/BaseLayout.astro'; +import PartnerKit from '../components/PartnerKit.astro'; import { Icon } from 'astro-icon/components'; import { partners, contactEmail, joinMailto } from '../lib/partners'; -// Partners, /partners: the organizations taking part, and how another -// group can join. Every partner comes from the roster in +// Partners, /partners: the organizations taking part, how another group +// can join, and the partner kit. Every partner comes from the roster in // src/data/partners.ts; with none yet, the roster is left out entirely and // the page opens with "Bring your organization". // @@ -141,9 +142,12 @@ const whatPartnersDo = [

+ +
+ diff --git a/apps/site/src/lib/newsletter.ts b/apps/site/src/lib/newsletter.ts new file mode 100644 index 0000000..8d99c79 --- /dev/null +++ b/apps/site/src/lib/newsletter.ts @@ -0,0 +1,27 @@ +// LVBT's newsletter, as the "Keep going after the week" card on My week and +// Home's "Stay involved with LVBT" section offer it. + +/** + * Whether the card can add someone to LVBT's newsletter in one tap, through + * the Worker's POST /api/newsletter. That route, and the Beehiiv key it + * needs in production, are not built yet, so the card links to LVBT's own + * newsletter page instead; the one-tap sign-up is built and tested, and + * turning this on is the only change the card needs once the route works. + */ +export const ONE_TAP_NEWSLETTER = false; + +/** LVBT's newsletter sign-up page, for anyone the one-tap sign-up can't serve. */ +export const NEWSLETTER_PAGE = 'https://mail.lasvegasfortransit.org/'; + +/** 12:00 am October 9, 2026, Las Vegas time: the giveaway closes and Home changes. */ +export const GIVEAWAY_CLOSES = '2026-10-09T07:00:00Z'; + +export const KEEP_GOING = { + heading: 'Keep going after the week', + text: 'Week Without Driving lasts eight days, but Las Vegans for Better Transit works all year for better buses and safer streets across the valley. Keep going with us.', +} as const; + +export const STAY_INVOLVED = { + heading: 'Stay involved with LVBT', + text: 'Week Without Driving 2026 is over. Thank you for taking part. Keep going after the week with Las Vegans for Better Transit: we work all year for better buses and safer streets across the valley.', +} as const; diff --git a/apps/site/src/pages/index.astro b/apps/site/src/pages/index.astro index 7b59079..8f846fb 100644 --- a/apps/site/src/pages/index.astro +++ b/apps/site/src/pages/index.astro @@ -9,6 +9,8 @@ import { lvbt, site } from '../lib/site'; import { wwd } from '../lib/wwd'; import { days, prizes, proclamations } from '../lib/campaign'; import { partners } from '../lib/partners'; +import KeepGoingCard from '../components/KeepGoingCard.astro'; +import { STAY_INVOLVED } from '../lib/newsletter'; // The Home page, for someone who has five seconds: what the week is, when // it is, and one button. Below that, the three steps, why it matters, the @@ -120,10 +122,21 @@ const leaderMailto = `mailto:wwd@lasvegasfortransit.org?subject=${encodeURICompo Take the bus, walk, bike or get a ride. Anyone can take part. Sign up with us to win a free month of bus rides.

+ {/* From October 9, /scripts/keep-going.js swaps "Sign up to win" for these. */} +
- + Sign up to win + How it works
@@ -308,11 +321,23 @@ const leaderMailto = `mailto:wwd@lasvegasfortransit.org?subject=${encodeURICompo + {/* STAY INVOLVED: from October 9, in place of the last call to sign up. */} + + {/* LAST CALL */}
-

Try it this October.

- +

Try it this October.

+ Sign up to win

@@ -320,9 +345,14 @@ const leaderMailto = `mailto:wwd@lasvegasfortransit.org?subject=${encodeURICompo

+