@afokapu/atdd-bun 0.1.4 → 0.3.0

package/detectors/bun_design_system_detector/checks/design_token_color.mjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env bun
+// Detector: coder.bun.design-token-color
+// Outside the tokens layer, UI files (.tsx/.jsx/.html/.css) take colors from tokens
+// (`var(--…)`), never raw hex, rgb(), or hsl() literals. Defining a custom
+// property (`--danger: #b91c1c`) is defining a token, not using a raw value.
+import { readRoots, readExcludes, readText, emit, locate } from "../../../lib/scan.mjs";
+import { scope, designOf, isUi, declarations } from "./_design.mjs";
+
+const RULE_ID = "coder.bun.design-token-color";
+const COLOR_RE = /#[0-9a-fA-F]{3,8}\b|\b(?:rgba?|hsla?)\s*\(/;
+const violations = [];
+for (const file of scope(readRoots(), readExcludes())) {
+  if (!isUi(file) || designOf(file)?.layer === 0) continue;
+  const text = readText(file);
+  for (const d of declarations(file, text ?? "")) {
+    if (d.prop.startsWith("--")) continue;
+    const hit = d.value.match(COLOR_RE);
+    if (hit) violations.push({ rule_id: RULE_ID, file, ...locate(text, d.index), evidence: `${d.prop} uses the raw color ${hit[0].replace(/\s*\($/, "()")}; reference a color token (var(--…)) instead` });
+  }
+}
+process.stderr.write(`bun-detector[design-token-color]: ${violations.length} violation(s)\n`);
+emit(violations);

package/detectors/bun_design_system_detector/checks/design_token_hardcoded.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env bun
+// Detector: coder.bun.design-token-hardcoded
+// Outside the tokens layer, spacing, radii, and durations come from foundations.
+// 0 and 1px (hairline borders) are not design decisions and are allowed. Custom
+// property definitions (`--space-3: 12px`) define tokens and are never judged.
+import { readRoots, readExcludes, readText, emit, locate } from "../../../lib/scan.mjs";
+import { scope, designOf, isUi, declarations } from "./_design.mjs";
+
+const RULE_ID = "coder.bun.design-token-hardcoded";
+const LENGTH_PROP = /^(margin|padding|gap|row-gap|column-gap|inset|top|right|bottom|left|border-radius)(-|$)/;
+const DURATION_PROP = /^(transition|animation)(-|$)/;
+const violations = [];
+const report = (file, text, d, value) => violations.push({ rule_id: RULE_ID, file, ...locate(text, d.index), evidence: `${d.prop}: ${value} is hardcoded; use a foundations token (var(--…))` });
+for (const file of scope(readRoots(), readExcludes())) {
+  if (!isUi(file) || designOf(file)?.layer === 0) continue;
+  const text = readText(file);
+  for (const d of declarations(file, text ?? "")) {
+    if (LENGTH_PROP.test(d.prop)) {
+      if (d.numeric) { if (Math.abs(Number(d.value)) > 1) report(file, text, d, d.value); continue; }
+      const px = [...d.value.matchAll(/(-?\d*\.?\d+)px\b/g)].find((m) => Math.abs(Number(m[1])) > 1);
+      if (px) report(file, text, d, px[0]);
+    } else if (DURATION_PROP.test(d.prop)) {
+      const time = [...d.value.matchAll(/(\d*\.?\d+)(ms|s)\b/g)].find((m) => Number(m[1]) > 0);
+      if (time) report(file, text, d, time[0]);
+    }
+  }
+}
+process.stderr.write(`bun-detector[design-token-hardcoded]: ${violations.length} violation(s)\n`);
+emit(violations);

package/detectors/bun_design_system_detector/checks/design_tokens_pure.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env bun
+// Detector: coder.bun.design-tokens-pure
+// Files in the tokens/foundations layer hold values only: no JSX runtime import,
+// no rendered markup, no control flow.
+import { readRoots, readExcludes, readText, emit, locate } from "../../../lib/scan.mjs";
+import { extname } from "node:path";
+import { scope, designOf, importsOf, masked, CODE_EXT } from "./_design.mjs";
+
+const RULE_ID = "coder.bun.design-tokens-pure";
+const RENDERERS = /^(react|react-dom|preact|hono\/jsx|hono\/jsx\/.*|@kitajs\/html)$/;
+const violations = [];
+const report = (file, text, index, evidence) => violations.push({ rule_id: RULE_ID, file, ...locate(text, index), evidence });
+for (const file of scope(readRoots(), readExcludes())) {
+  if (designOf(file)?.layer !== 0 || !CODE_EXT.has(extname(file))) continue;
+  const m = masked(file);
+  if (!m) continue;
+  for (const imp of importsOf(m.text)) if (RENDERERS.test(imp.specifier)) report(file, m.text, imp.index, `token file imports the renderer "${imp.specifier}"; tokens are values, not widgets`);
+  const jsx = m.code.search(/<\/[A-Za-z]|\/>/);
+  if (jsx !== -1) report(file, m.text, jsx, "token file renders markup; move it to primitives");
+  for (const c of m.code.matchAll(/\b(if|for|while|switch)\s*\(/g)) report(file, m.text, c.index, `token file branches with ${c[1]}; tokens are pure values`);
+}
+process.stderr.write(`bun-detector[design-tokens-pure]: ${violations.length} violation(s)\n`);
+emit(violations);

package/detectors/bun_design_system_detector/checks/design_wagons_import.mjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env bun
+// Detector: coder.bun.design-wagons-import
+// The design system is wagon-agnostic: a file under a design root never imports
+// application or wagon code. Wagons import FROM the design system, never the reverse.
+import { readRoots, readExcludes, readText, emit, locate } from "../../../lib/scan.mjs";
+import { scope, designOf, importsOf, target, designTarget } from "./_design.mjs";
+
+const RULE_ID = "coder.bun.design-wagons-import";
+const violations = [];
+for (const file of scope(readRoots(), readExcludes())) {
+  if (!designOf(file)) continue;
+  const text = readText(file);
+  for (const imp of importsOf(text ?? "")) {
+    if (target(file, imp.specifier)?.path && !designTarget(file, imp.specifier)) violations.push({ rule_id: RULE_ID, file, ...locate(text, imp.index), evidence: `design-system file imports "${imp.specifier}", outside the design root; the design system must not depend on app code` });
+  }
+}
+process.stderr.write(`bun-detector[design-wagons-import]: ${violations.length} violation(s)\n`);
+emit(violations);

package/detectors/bun_design_system_detector/detect.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env bun
+// FAMILY validator: bun_design_system_detector
+// Runs each member check (checks/*.mjs) VERBATIM as a subprocess and merges their
+// RAW v1.1 reports into one — ONE implementation realizing a family of rule_ids
+// (the Core pattern; see frontend.workspace.runtime's families).
+//
+// Members are spawned with `process.execPath`, which under this provider IS the
+// bun binary, so a member may be authored as .mjs OR .ts with no build step.
+// Files whose name begins with `_` are skipped: they are shared helpers, not
+// checks. (The node-runtime families have no such convention because each of
+// their checks re-implements its own walker; this provider factors the walk into
+// lib/scan.mjs instead.)
+import { execFileSync } from "node:child_process";
+import { readFileSync, writeFileSync, mkdtempSync, readdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const reportPath = process.env.ATDD_VIOLATIONS_REPORT;
+if (!reportPath) {
+  process.stderr.write("family: ATDD_VIOLATIONS_REPORT not set\n");
+  process.exit(2);
+}
+const checks = readdirSync(join(here, "checks"))
+  .filter((f) => (f.endsWith(".mjs") || f.endsWith(".ts")) && !f.startsWith("_"))
+  .sort();
+const td = mkdtempSync(join(tmpdir(), "atdd-bun-fam-"));
+const out = [];
+for (const c of checks) {
+  const rep = join(td, c + ".json");
+  try {
+    execFileSync(process.execPath, [join(here, "checks", c)], {
+      env: { ...process.env, ATDD_VIOLATIONS_REPORT: rep },
+      stdio: ["ignore", "ignore", "inherit"],
+    });
+  } catch {
+    /* a member may exit non-zero; still try to read its report */
+  }
+  try {
+    out.push(...JSON.parse(readFileSync(rep, "utf8")).violations);
+  } catch {}
+}
+writeFileSync(reportPath, JSON.stringify({ violations: out }, null, 2), "utf8");
+process.stderr.write("family bun_design_system_detector: " + out.length + " violation(s)\n");
+process.exit(0);

package/detectors/bun_design_system_detector/fixtures/clean/app/public/index.html

@@ -0,0 +1,6 @@
+<!doctype html>
+<html>
+  <body style="margin: 0; color: var(--ink)">
+    <div id="app" hx-get="/orders" hx-trigger="load"></div>
+  </body>
+</html>

package/detectors/bun_design_system_detector/fixtures/clean/app/public/site.css

@@ -0,0 +1,9 @@
+/* A standalone sheet may define tokens; it must not use raw values. */
+:root {
+  --accent: #0ea5e9;
+  --gutter: 24px;
+}
+.hero {
+  color: var(--accent);
+  padding: var(--gutter);
+}

package/detectors/bun_design_system_detector/fixtures/clean/app/src/design/components/Card.tsx

@@ -0,0 +1,6 @@
+import { Text } from "../primitives/Text";
+import { space } from "../tokens/spacing";
+
+export function Card(props: { title: string; children: unknown }) {
+  return <section class="card" style={{ padding: space[4], borderRadius: "var(--radius)" }}><Text>{props.title}</Text>{props.children}</section>;
+}

package/detectors/bun_design_system_detector/fixtures/clean/app/src/design/primitives/Button.tsx

@@ -0,0 +1,6 @@
+import { colors } from "../tokens/colors";
+import { space } from "../tokens/spacing";
+
+export function Button(props: { children: unknown; [attr: string]: unknown }) {
+  return <button class="btn" style={{ color: colors.ink, padding: space[2] }} {...props}>{props.children}</button>;
+}

package/detectors/bun_design_system_detector/fixtures/clean/app/src/design/primitives/Text.tsx

@@ -0,0 +1,5 @@
+import { colors } from "../tokens/colors";
+
+export function Text(props: { children: unknown }) {
+  return <span style={{ color: colors.ink }}>{props.children}</span>;
+}

package/detectors/bun_design_system_detector/fixtures/clean/app/src/design/primitives/index.ts

@@ -0,0 +1,2 @@
+export { Button } from "./Button";
+export { Text } from "./Text";

package/detectors/bun_design_system_detector/fixtures/clean/app/src/design/templates/Page.tsx

@@ -0,0 +1,5 @@
+import { Card } from "../components/Card";
+
+export function Page(props: { title: string; children: unknown }) {
+  return <main><Card title={props.title}>{props.children}</Card></main>;
+}

package/detectors/bun_design_system_detector/fixtures/clean/app/src/design/tokens/colors.ts

@@ -0,0 +1 @@
+export const colors = { ink: "var(--ink)", line: "var(--line)" } as const;

package/detectors/bun_design_system_detector/fixtures/clean/app/src/design/tokens/spacing.ts

@@ -0,0 +1 @@
+export const space = { 2: "var(--space-2)", 4: "var(--space-4)" } as const;

package/detectors/bun_design_system_detector/fixtures/clean/app/src/design/tokens/theme.css

@@ -0,0 +1,8 @@
+:root {
+  --ink: #1f2937;
+  --line: rgba(15, 23, 42, 0.12);
+  --space-2: 8px;
+  --space-4: 16px;
+  --radius: 6px;
+  --fast: 120ms;
+}

package/detectors/bun_design_system_detector/fixtures/clean/app/src/wagons/orders/presentation/orders-view.tsx

@@ -0,0 +1,6 @@
+import { Button, Text } from "../../../design/primitives";
+import { Page } from "../../../design/templates/Page";
+
+export function OrdersView() {
+  return <Page title="Orders"><Text>Open orders</Text><Button hx-post="/orders">Place order</Button></Page>;
+}

package/detectors/bun_design_system_detector/fixtures/clean/app/src/wagons/orders/presentation/orders.css

@@ -0,0 +1,8 @@
+/* #fade is a selector, not a color */
+#fade:hover { color: var(--ink); }
+.orders {
+  padding: var(--space-2);
+  border: 1px solid var(--line);
+  margin: 0;
+  transition: opacity var(--fast);
+}

package/detectors/bun_design_system_detector/fixtures/dirty/connected/src/design/tokens/colors.ts

@@ -0,0 +1 @@
+export const colors = { ink: "var(--ink)" } as const;

package/detectors/bun_design_system_detector/fixtures/dirty/connected/src/views/plain.tsx

@@ -0,0 +1,3 @@
+export function Plain() {
+  return <div class="plain">Not connected to the design system</div>;
+}

package/detectors/bun_design_system_detector/fixtures/dirty/dependency_flow/src/design/components/Card.tsx

@@ -0,0 +1,3 @@
+export function Card(props: { children: unknown }) {
+  return <section>{props.children}</section>;
+}

package/detectors/bun_design_system_detector/fixtures/dirty/dependency_flow/src/design/primitives/Badge.tsx

@@ -0,0 +1,5 @@
+import { Card } from "../components/Card";
+
+export function Badge() {
+  return <Card>badge</Card>;
+}

package/detectors/bun_design_system_detector/fixtures/dirty/orphan_export/src/design/primitives/Unused.tsx

@@ -0,0 +1,3 @@
+export function Unused() {
+  return <span>never imported</span>;
+}

package/detectors/bun_design_system_detector/fixtures/dirty/primitives/src/design/primitives/Button.tsx

@@ -0,0 +1,3 @@
+export function Button(props: { children: unknown }) {
+  return <button class="btn">{props.children}</button>;
+}

package/detectors/bun_design_system_detector/fixtures/dirty/primitives/src/views/form.tsx

@@ -0,0 +1,5 @@
+import { Button } from "../design/primitives/Button";
+
+export function Form() {
+  return <form><input name="q" /><button type="submit">Go</button><Button>Reset</Button></form>;
+}

package/detectors/bun_design_system_detector/fixtures/dirty/token_color/src/app.css

@@ -0,0 +1,4 @@
+.alert {
+  color: #b91c1c;
+  background: rgba(0, 0, 0, 0.1);
+}

package/detectors/bun_design_system_detector/fixtures/dirty/token_color/src/design/tokens/colors.css

@@ -0,0 +1 @@
+:root { --danger: #b91c1c; }

package/detectors/bun_design_system_detector/fixtures/dirty/token_color/src/views/alert.tsx

@@ -0,0 +1,3 @@
+export function Alert() {
+  return <p style={{ color: "#b91c1c" }}>Failed</p>;
+}

package/detectors/bun_design_system_detector/fixtures/dirty/token_hardcoded/public/list.html

@@ -0,0 +1 @@
+<ul style="margin: 16px; border-radius: 6px"><li>row</li></ul>

package/detectors/bun_design_system_detector/fixtures/dirty/token_hardcoded/src/design/tokens/spacing.css

@@ -0,0 +1 @@
+:root { --space-3: 12px; }

package/detectors/bun_design_system_detector/fixtures/dirty/token_hardcoded/src/views/list.tsx

@@ -0,0 +1,3 @@
+export function List() {
+  return <ul style={{ padding: 12, transition: "opacity 200ms" }}><li>row</li></ul>;
+}

package/detectors/bun_design_system_detector/fixtures/dirty/tokens_pure/src/design/tokens/swatch.tsx

@@ -0,0 +1,9 @@
+import { jsx } from "hono/jsx";
+
+export const dark = process.env.THEME === "dark";
+export function tone(level: number) {
+  if (level > 2) return "var(--ink)";
+  return "var(--ink-2)";
+}
+export const Swatch = () => <div class="swatch" />;
+void jsx;

package/detectors/bun_design_system_detector/fixtures/dirty/wagons_import/src/design/components/OrderBadge.tsx

@@ -0,0 +1,5 @@
+import { orderStatus } from "../../wagons/orders/order-status";
+
+export function OrderBadge() {
+  return <span>{orderStatus[0]}</span>;
+}

package/detectors/bun_design_system_detector/fixtures/dirty/wagons_import/src/wagons/orders/order-status.ts

@@ -0,0 +1 @@
+export const orderStatus = ["open", "closed"] as const;