mirror of
https://github.com/garrytan/gstack.git
synced 2026-11-02 23:14:33 +01:00
garrytanandcapy-ai[bot]
df6cd725c2
Waivers settle once per page after both tiers, so a blocking rule only the render tier suspects is waivable and one it measures is refused; a claim in a stylesheet answers for that stylesheet on every page that links it (no shared-word check), so a sheet shared by two pages is no longer waived on one and refused on the other. Every printed field is one line with control characters stripped; the waiver regex is linear and ends at a carriage return; a root-relative href cannot climb out of the lint root. The ancestor map closes optional end tags implicitly and pops to the matching open tag, so unclosed <li> no longer makes it quadratic. The static tier reports outline: none with no ring anywhere as missing-focus-visible at its line; literal-outside-tokens needs a --color-* or --font-* token to exist; the banned gradient includes indigo-to-violet; a new banned-font rule reads gstack's BANNED_FONTS; MONO_FACE matches whole words; bold keywords and tokens count as weight 700 for the contrast threshold. stylesFor reads only the entries that can match; glOcclusion memoises the pinned walk; the confirm screenshot is taken at 1x; a page that throws in the render tier is a render finding and the CLI exits 3 on an internal error. Docs name the token conventions and what the lint does not cover. Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
56 lines
3.1 KiB
TypeScript
Executable File
56 lines
3.1 KiB
TypeScript
Executable File
#!/usr/bin/env -S bun --no-env-file --config=/dev/null
|
|
// gstack-design-lint — the free, deterministic design lint behind /design-html
|
|
// and /design-review. Static tier over .html .css .jsx .tsx .vue .svelte .astro
|
|
// (Tailwind class strings included); --render measures the page in gstack's own
|
|
// browser (Aside first, the browse daemon otherwise).
|
|
//
|
|
// Usage: gstack-design-lint <file-or-dir ...> [--render] [--url <http://…>]
|
|
// [--scope page|component] [--job <job>] [--json] [--rules]
|
|
//
|
|
// Prints one "LINT: <blocks|ask|polish|waived> <rule-id> <file>:<line> <evidence> | fix: <fix>"
|
|
// line per finding, then "LINT_SUMMARY: blocks=N ask=N waived=N polish=N render=<ran|skipped: reason>".
|
|
// Exit 2 on blocks, 1 on unanswered asks, 0 otherwise; 3 on a usage error.
|
|
// docs/design-lint.md is the contract.
|
|
|
|
import { formatResult, lint, type LintOptions } from '../lib/design-lint/index';
|
|
import { ruleTable } from '../lib/design-lint/report';
|
|
|
|
const USAGE = 'usage: gstack-design-lint <file-or-dir ...> [--render] [--url <http://…>] [--scope page|component] [--job <job>] [--json] [--rules]';
|
|
|
|
const args = process.argv.slice(2);
|
|
const opts: LintOptions & { json: boolean; rules: boolean } = { render: false, urls: [], scope: 'page', job: null, json: false, rules: false };
|
|
const paths: string[] = [];
|
|
const take = (flag: string): string => {
|
|
const v = args[++i];
|
|
if (v === undefined) { console.error(`${flag} needs a value`); console.error(USAGE); process.exit(3); }
|
|
return v;
|
|
};
|
|
let i = 0;
|
|
for (; i < args.length; i++) {
|
|
const a = args[i];
|
|
if (a === '--render') opts.render = true;
|
|
else if (a === '--url') { opts.urls!.push(take(a)); opts.render = true; }
|
|
else if (a === '--scope') { const s = take(a); if (s !== 'page' && s !== 'component') { console.error('--scope must be page or component'); process.exit(3); } opts.scope = s; }
|
|
else if (a === '--job') opts.job = take(a).trim().toLowerCase();
|
|
else if (a === '--json') opts.json = true;
|
|
else if (a === '--rules') opts.rules = true;
|
|
else if (a === '--help' || a === '-h') { console.log(USAGE); process.exit(0); }
|
|
else if (a.startsWith('--')) { console.error(`unknown flag ${a}`); console.error(USAGE); process.exit(3); }
|
|
else paths.push(a);
|
|
}
|
|
if (opts.rules) {
|
|
for (const r of ruleTable()) console.log(`${r.tier.padEnd(6)} ${r.id.padEnd(26)} ${r.gate.padEnd(7)} ${r.title}`);
|
|
process.exit(0);
|
|
}
|
|
if (!paths.length && !opts.urls!.length) { console.error(USAGE); process.exit(3); }
|
|
if (opts.urls!.some((u) => !/^https?:\/\//.test(u))) { console.error('--url takes an http or https address'); process.exit(3); }
|
|
|
|
const result = await lint(paths, opts).catch((e: Error) => { console.error(`gstack-design-lint: ${e.message}`); process.exit(3); });
|
|
if (!result.files.length && !opts.urls!.length) {
|
|
console.error('gstack-design-lint: no .html, .css, .jsx, .tsx, .vue, .svelte or .astro files found');
|
|
process.exit(3);
|
|
}
|
|
if (opts.json) console.log(JSON.stringify({ summary: result.summary, files: result.files.length, findings: result.findings }, null, 2));
|
|
else console.log(formatResult(result));
|
|
process.exit(result.exitCode);
|