--- /** * A frame lifted out of a real recording. * * Some surfaces do not survive being watched. Guided Review puts a chapter's argument beside the * code it argues about, and a reader meeting that for the first time needs to stop on it — played * at demo speed it registers as motion rather than as information. So these come from the same * captures the demos do, cut with `scripts/cast-still.py`, and there is still one source of truth * for what luxe looks like. * * A recording bakes its colors in, and the site is drawn in the same theme it was recorded in. * * The markup is inlined for the reason `Shot` documents: an SVG behind `` is its own * document, cannot see this page's `@font-face`, and would draw every Nerd Font icon as tofu for * everyone who does not already have the face installed. */ interface Props { /** Capture basename, e.g. `palette`. */ name: string; /** * Where the picture comes from: a frame cut out of a recording (the default), or a fixture * `scripts/site-assets.sh` generates from the production view path. * * Either way it is luxe's own theme, so a fixture and a recording beside it are one product. */ from?: "captures" | "generated"; /** * A cropped cut of the same moment, for phones. * * The same arithmetic that governs the demos: a 150-column capture shrunk to a 340px column is * about two pixels a character, which is a picture of a screenshot rather than a screenshot. A * *crop* keeps the type readable by showing less — the guide pane without the diff beside it, * the comment box without the surface around it — which is the right trade on a phone, where * nobody was going to read three panes anyway. */ narrow?: string; /** What the picture shows. Also the accessible name, so it has to say something. */ caption: string; /** * Cap on how wide the plate draws, in rem. * * A 150-column capture wants roughly 74rem to stay legible; a cropped detail wants far less and * looks like a mistake blown up to full width. */ width?: number; class?: string; } const { name, narrow, caption, from = "captures", width = 74, class: className = "" } = Astro.props; const recorded = import.meta.glob("../assets/captures/*.svg", { query: "?raw", import: "default", eager: true, }); const generated = import.meta.glob("../assets/generated/*.luxe.svg", { query: "?raw", import: "default", eager: true, }); const source = (basename: string) => { const key = from === "generated" ? `../assets/generated/${basename}.luxe.svg` : `../assets/captures/${basename}.svg`; return { key, svg: from === "generated" ? generated[key] : recorded[key] }; }; const escapeXml = (value: string) => value.replace(/&/g, "&").replace(//g, ">").replace(/"/g, """); // `role="img"` and the label are the whole accessibility story: without them a screen reader walks // the `` rows and reads a terminal dump aloud. With them it is announced once, by its // caption, while the text inside stays selectable for anyone who wants to copy a line out of it. // // Only one of the two cuts is ever exposed: the hidden one is `aria-hidden`, or a reader meets the // same picture twice. const label = escapeXml(caption); /** * The wide cut's aspect, read out of its own viewBox. * * A still obeys the same rule a demo does — as large as fits, never wider than the page — and * fitting is a question about height. Without this a short laptop drew a 1184px still beside a * 993px demo in the same section, which is two answers to one question. */ const wideBox = (source(name).svg ?? "").match(/viewBox="0 0 ([\d.]+) ([\d.]+)"/); const aspect = wideBox ? Number(wideBox[1]) / Number(wideBox[2]) : 4; const capture = (basename: string, variant: string) => { const { key, svg } = source(basename); if (!svg) { const how = from === "generated" ? "add it to SHOTS in scripts/site-assets.sh" : "cut one with scripts/cast-still.py"; throw new Error(`no still called ${basename} — ${how}`); } const root = svg.match(/^]*>/)?.[0]; if (!root) throw new Error(`${key} has no root to annotate`); const described = variant === "wide" ? `role="img" aria-label="${label}"` : 'aria-hidden="true"'; return svg.replace( root, `${root.slice(0, -1)} class="still__img still__img--${variant}" ${described}>` + (variant === "wide" ? `${label}` : ""), ); }; ---
{narrow && }
{caption}