youiyoux 0.1.19 → 0.1.20

package/README.md

@@ -16,6 +16,8 @@ No config, no account. You get:
 - `youiyoux-card.png`: a 1200×630 card with the headline numbers.
 - `youiyoux-summary.md`: paste it into a PR or issue.
 
+New to it? [Getting started](https://github.com/ap9000/youiyoux/blob/main/docs/getting-started.md): the report, the top fix, your agent and CI, in five steps.
+
 ## For your agent
 
 ```sh

package/dist/chunks/{chunk-75LXBAYB.js → chunk-3SXAQHHJ.js}

@@ -1224,13 +1224,16 @@ var Theme = class {
   /** Project declarations only: excludes implicit Tailwind defaults. */
   declared;
   forms;
+  /** Declared variables Tailwind makes utilities from (`--color-muted` → `text-muted`): an `@theme` block's, or the Tailwind config's. */
+  utilities;
   vars;
-  constructor(vars, tailwind, warnings, declared = /* @__PURE__ */ new Map(), forms = null) {
+  constructor(vars, tailwind, warnings, declared = /* @__PURE__ */ new Map(), forms = null, utilities = /* @__PURE__ */ new Set()) {
     this.vars = vars;
     this.declared = declared;
     this.tailwind = tailwind;
     this.warnings = warnings;
     this.forms = forms;
+    this.utilities = utilities;
   }
   variable(name) {
     return this.vars.get(name);
@@ -1399,17 +1402,20 @@ async function buildTheme(root, sheets, usesTailwindPackage) {
   const version = v4 ? 4 : v3 || usesTailwindPackage ? 3 : null;
   const vars = version ? defaults(version) : /* @__PURE__ */ new Map();
   const declared = new Map(config.vars);
+  const utilities = new Set(version ? config.vars.keys() : []);
   for (const [name, value] of config.vars) vars.set(name, value);
   for (const sheet of sheets) {
     for (const rule of sheet.rules) {
-      if (rule.preludes.length !== 1 || !THEME_SCOPES.has(rule.preludes[0].replace(/\s+/g, " "))) continue;
+      const scope = rule.preludes.length === 1 ? rule.preludes[0].replace(/\s+/g, " ") : null;
+      if (!scope || !THEME_SCOPES.has(scope)) continue;
       for (const declaration of rule.declarations) if (declaration.property.startsWith("--")) {
         vars.set(declaration.property, declaration.value);
         declared.set(declaration.property, declaration.value);
+        if (version === 4 && scope.startsWith("@theme")) utilities.add(declaration.property);
       }
     }
   }
-  return new Theme(vars, version, config.warnings, declared, version ? await formsPluginOf(root, sheets, config.file) : null);
+  return new Theme(vars, version, config.warnings, declared, version ? await formsPluginOf(root, sheets, config.file) : null, utilities);
 }
 
 // ../scanner/src/inventory/style.ts
@@ -1900,7 +1906,6 @@ function nearDuplicates(input) {
   const { inventory, added, importOf } = input;
   const definitions = new Map(inventory.definitions.map((d) => [d.id, d]));
   const fresh = inventory.definitions.filter((d) => added(d.file, d.line));
-  if (fresh.length === 0) return [];
   const freshIds = new Set(fresh.map((d) => d.id));
   const ends = /* @__PURE__ */ new Map();
   for (const definition of fresh) {
@@ -1921,7 +1926,8 @@ function nearDuplicates(input) {
     if (root?.kind === "primitive" || root?.kind === "definition" && definitions.has(root.id) && !freshIds.has(root.id)) continue;
     const own = inventory.looks.filter((l) => hasShape(l.shape) && inside(l, definition) && l.definition !== definition.id);
     const roots = inventory.looks.filter((l) => hasShape(l.shape) && inside(l, definition) && l.definition === definition.id);
-    const looks = roots.length > 0 ? roots : own.length > 0 ? own : inventory.looks.filter((l) => hasShape(l.shape) && l.definition === definition.id);
+    if (roots.length === 0 && own.length > 0) continue;
+    const looks = roots.length > 0 ? roots : inventory.looks.filter((l) => hasShape(l.shape) && l.definition === definition.id);
     let best = null;
     for (const mine of looks) {
       const shape = clusterShapeOf(mine);
@@ -1944,6 +1950,39 @@ function nearDuplicates(input) {
       fix: reuse.fix
     });
   }
+  const reported = fresh.filter((d) => findings.some((f) => f.file === d.file && f.line === d.line));
+  const componentOf = (look) => look.recipe?.kind === "component" ? `${look.recipe.file}#${look.recipe.export}` : null;
+  const uses = /* @__PURE__ */ new Map();
+  for (const look of inventory.looks) if (look.recipe?.kind === "component" && look.file !== look.recipe.file && !look.story) uses.set(componentOf(look), (uses.get(componentOf(look)) ?? 0) + 1);
+  const components = inventory.looks.filter((l) => hasShape(l.shape) && uses.has(componentOf(l) ?? "") && !(l.definition !== null && freshIds.has(l.definition)));
+  const linkRoot = (look) => {
+    const root = definitions.get(look.definition ?? "")?.root;
+    return root?.kind === "intrinsic" ? root.tag === "a" : root?.kind === "primitive" ? /link/i.test(root.name === "default" ? root.module : root.name) : false;
+  };
+  for (const mine of inventory.looks) {
+    if (mine.source !== "intrinsic" || mine.definition !== null || mine.story || !hasShape(mine.shape) || !added(mine.file, mine.line)) continue;
+    if ([mine.shape.height, mine.shape.paddingX || null, mine.shape.radius, mine.shape.fontSize].filter((v) => v !== null).length < 3) continue;
+    if (reported.some((d) => inside(mine, d))) continue;
+    const shape = clusterShapeOf(mine);
+    const mineClasses = classesOf(mine.recipe);
+    let best = null;
+    for (const other of components) {
+      if (other.role !== mine.role || mine.tag === "a" !== linkRoot(other) || !compatible(shape, clusterShapeOf(other))) continue;
+      const rank = [shapeDistance(shape, clusterShapeOf(other)), -uses.get(componentOf(other)), -overlap(mineClasses, classesOf(other.recipe))];
+      if (!best || before(rank, best.rank)) best = { look: other, rank };
+    }
+    if (!best) continue;
+    const reuse = reuseOf(best.look, definitions, importOf, mine.file);
+    findings.push({
+      kind: "near-duplicate",
+      file: mine.file,
+      line: mine.line,
+      column: mine.column,
+      text: `<${mine.tag}>`,
+      message: `A hand-styled <${mine.tag}> that looks like the existing ${reuse.name} (${best.look.file}:${best.look.line}): ${describeShape(mine)}. Confirm it is the same role; if so, render ${reuse.name} instead.`,
+      fix: reuse.fix
+    });
+  }
   return findings.sort(byPosition);
 }
 function importedNames(statement) {

package/dist/chunks/{chunk-AFEQZT2N.js → chunk-6UHSXSS6.js}

@@ -4,7 +4,7 @@ import {
   loadPackage,
   readTryIndex,
   send
-} from "./chunk-NG73FB4O.js";
+} from "./chunk-WBU7YJGZ.js";
 import {
   writeFileAtomic
 } from "./chunk-M56633DV.js";

package/dist/chunks/{chunk-DHZDMZXE.js → chunk-K2W23VI3.js}

@@ -9,7 +9,7 @@ import {
   startRuleEditor,
   style,
   truncate
-} from "./chunk-2F2HM7FE.js";
+} from "./chunk-YQS2VF65.js";
 import {
   BASELINE_FILE,
   DEFAULT_EXCLUDE,
@@ -64,7 +64,7 @@ import {
   vendoredPath,
   whereUsed,
   withFile
-} from "./chunk-75LXBAYB.js";
+} from "./chunk-3SXAQHHJ.js";
 import {
   escapingLinks,
   within
@@ -1382,6 +1382,8 @@ async function themeTokens(root, modules) {
   const theme = await buildTheme(root, sheets, false);
   const tokens = [];
   const byVar = /* @__PURE__ */ new Map();
+  const themeKeys = /* @__PURE__ */ new Map();
+  const ids = /* @__PURE__ */ new Set();
   for (const [name, raw] of theme.declared) {
     const value = substituteVars(raw, (key2) => theme.variable(key2));
     if (value === null) continue;
@@ -1390,11 +1392,16 @@ async function themeTokens(root, modules) {
     const px = kind ? theme.length(value) : null;
     if (!color && px === null) continue;
     const light = color ?? { value: px, unit: "px" };
-    const token = { id: `${color ? "color" : kind}.${name.slice(2)}`, type: color ? "color" : "dimension", cssName: name.slice(2), light, dark: light };
+    const group = color ? "color" : kind;
+    const short = `${group}.${name.slice(2).replace(new RegExp(`^${group}-`), "")}`;
+    const id = ids.has(short) ? `${group}.${name.slice(2)}` : short;
+    ids.add(id);
+    const token = { id, type: color ? "color" : "dimension", cssName: name.slice(2), light, dark: light };
     tokens.push(token);
     byVar.set(name, token);
+    if (theme.utilities.has(name)) themeKeys.set(id, [name.slice(2)]);
   }
-  return { prefix: "", tokens, byVar, themeKeys: /* @__PURE__ */ new Map() };
+  return { prefix: "", tokens, byVar, themeKeys };
 }
 async function runRepoCheck(project2, change) {
   const target = await loadInventoryTarget(project2.root);
@@ -3409,7 +3416,7 @@ async function projectStatus(project2, cwd = process.cwd()) {
   const comparison = check.baseline?.comparison;
   const counted = comparison ? [...comparison.new, ...comparison.regressed] : check.violations;
   const usages = check.scan.report.usages;
-  const { RequestStore } = await import("./src-VSWKGVFT.js");
+  const { RequestStore } = await import("./src-LESGEHOC.js");
   const requests = await new RequestStore(project2.root, project2.config.id).list();
   const status = {
     id: project2.config.id,
@@ -4735,17 +4742,23 @@ async function modulesOf(project2, target, failed3) {
   }
   return modules;
 }
+function groupKey(finding3) {
+  if (finding3.kind === "off-library") return finding3.message;
+  if (finding3.kind !== "hardcoded-value") return finding3.fix;
+  const { word, value, tokens } = hardcodedValue(finding3);
+  return `${word}\0${value}\0${tokens}`;
+}
 async function grouped(project2, found, lines, describe) {
   const groups = /* @__PURE__ */ new Map();
   for (const finding3 of found) {
-    const key2 = `${finding3.kind}\0${finding3.kind === "off-library" ? finding3.message : finding3.fix}`;
+    const key2 = `${finding3.kind}\0${groupKey(finding3)}`;
     groups.set(key2, [...groups.get(key2) ?? [], finding3]);
   }
   const findings2 = [];
   for (const list of groups.values()) {
     const first = list[0];
     const sites = await Promise.all(list.slice(0, SITES_PER_FINDING).map((f) => lines.site(`${repoPath(project2.dir, f.file)}:${f.line}`, repoPath(project2.dir, f.file), f.line)));
-    const { title, next: next2 } = describe(first, list.length);
+    const { title, next: next2 } = describe(first, list.length, list);
     findings2.push({ kind: first.kind, project: project2.dir, count: list.length, sites, title, detail: null, next: next2 });
   }
   return findings2.sort((a, b) => b.count - a.count || a.title.localeCompare(b.title));
@@ -4812,9 +4825,14 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
       if (tokens.tokens.length === 0) notes.push("No theme variables (CSS custom properties or Tailwind @theme) were found, so hardcoded values had nothing to be compared with");
       const usage = tokenUsage(modules);
       const found = (await Promise.all(modules.map((module) => reportTokens(module, tokens, usage)))).flat();
-      hardcoded = await grouped(project2, found, lines, (first, count) => {
+      hardcoded = await grouped(project2, found, lines, (first, count, list) => {
         const { word, value, tokens: names } = hardcodedValue(first);
-        return { title: `${sentence(word)} ${value} is hardcoded in ${plural(count, "place")}; the theme already has it as ${names}`, next: `${sentence(first.fix)} in each place` };
+        const fixes = [...new Map(list.map((f) => [f.fix, f.text]))];
+        const tail = / \([^()]*\)$/.exec(first.fix)?.[0] ?? "";
+        const shared = tail !== "" && fixes.every(([fix]) => fix.endsWith(tail));
+        const each = fixes.slice(0, 3).map(([fix, text], i) => `${(shared ? fix.slice(0, -tail.length) : fix).replace(i > 0 ? /^use / : /^$/, "")} for ${text}`);
+        const next2 = fixes.length === 1 ? `${sentence(first.fix)} in each place` : `${sentence(each.join(", "))}${fixes.length > 3 ? ", \u2026" : ""}${shared ? tail : ""}`;
+        return { title: `${sentence(word)} ${value} is hardcoded in ${plural(count, "place")}; the theme already has it as ${names}`, next: next2 };
       });
     } catch (error) {
       incomplete.push(`Hardcoded values were not checked (${errorText(error)}); run ${NPX} check --diff to see why`);
@@ -6048,7 +6066,7 @@ async function cmdLibrary(values, positionals) {
     return 0;
   }
   if (action === "ingest" && query && positionals.length === 2) {
-    const { fileIngestDraft, readLink, renderIngest } = await import("./ingest-X4MIF5F6.js");
+    const { fileIngestDraft, readLink, renderIngest } = await import("./ingest-IOFHL5VG.js");
     const p = values.draft ? await project(values) : null;
     const reading = await readLink(query, { allowLocal: true });
     const filed = p ? await fileIngestDraft(p, reading, values.state) : null;
@@ -6507,7 +6525,7 @@ async function cmdRequests(values, positionals) {
   const usage = "youiyoux requests [--status open|addressed|closed|all] [--route r]   or   youiyoux requests show <id> | reply <id> --message <text> | addressed <id> --message <what you changed>";
   const [action, id, ...rest] = positionals;
   if (rest.length > 0) throw new UsageError(usage);
-  const { RequestStore, requestBrief } = await import("./src-VSWKGVFT.js");
+  const { RequestStore, requestBrief } = await import("./src-LESGEHOC.js");
   const { project: project2, root } = await product(values);
   const store = new RequestStore(root, project2?.config.id ?? basename5(root));
   const agent = { kind: "agent", name: "youiyoux CLI" };
@@ -6606,7 +6624,7 @@ async function cmdReport(values, positionals, io) {
   return result.code;
 }
 async function cmdMcp(values) {
-  const { startStdioServer } = await import("./src-LGHUKRL2.js");
+  const { startStdioServer } = await import("./src-Z3LZMTHC.js");
   await startStdioServer({ projectRoot: values.project ?? process.cwd(), ...loadOptions(values), ...values.cache ? { discoverCache: values.cache } : {} });
   return -1;
 }

package/dist/chunks/{chunk-OE4RYJOS.js → chunk-TI3G57PX.js}

@@ -9,7 +9,7 @@ import {
   scanProject,
   screenSlug,
   tokenImpact
-} from "./chunk-75LXBAYB.js";
+} from "./chunk-3SXAQHHJ.js";
 import {
   buildTokens,
   contrastText,

package/dist/chunks/{chunk-NG73FB4O.js → chunk-WBU7YJGZ.js}

@@ -3,7 +3,7 @@ import { createRequire as __youiRequire } from "node:module"; import { dirname a
 // src/hub-packages.js
 var PACKAGES = {
   core: () => import("./src-AXF5XUQE.js"),
-  scanner: () => import("./src-Q3ZJHEUQ.js"),
+  scanner: () => import("./src-CCB3D7EM.js"),
   discover: () => import("./src-ULAQV67E.js"),
   tokens: () => import("./src-HBKEBCH6.js")
 };

package/dist/chunks/{chunk-2F2HM7FE.js → chunk-YQS2VF65.js}

@@ -1,7 +1,7 @@
 import { createRequire as __youiRequire } from "node:module"; import { dirname as __youiDir } from "node:path"; import { fileURLToPath as __youiPath } from "node:url"; const require = __youiRequire(import.meta.url); const __youiDirname = __youiDir(__youiPath(import.meta.url));
 import {
   loadProject
-} from "./chunk-75LXBAYB.js";
+} from "./chunk-3SXAQHHJ.js";
 import {
   shortHash
 } from "./chunk-M56633DV.js";
@@ -79,11 +79,11 @@ function workflowStateDir(project, state) {
   return resolve(state ?? join(homedir(), ".youi", "workflow", shortHash(`${project.repo.root}\0${project.root}`)));
 }
 async function ingest(link) {
-  const { readLink } = await import("./ingest-X4MIF5F6.js");
+  const { readLink } = await import("./ingest-IOFHL5VG.js");
   return readLink(link, { allowLocal: false });
 }
 async function startRuleEditor(options) {
-  const { FileStore, RuleWorkflow, serveWorkflow } = await import("./src-VSWKGVFT.js");
+  const { FileStore, RuleWorkflow, serveWorkflow } = await import("./src-LESGEHOC.js");
   const projectRoot = resolve(options.project);
   const load = { ...options.config ? { configPath: resolve(options.config) } : {}, ...options.design ? { designRoot: resolve(options.design) } : {}, ...options.root ? { productRoot: resolve(options.root) } : {} };
   const project = await loadProject(projectRoot, load);

package/dist/chunks/{ingest-X4MIF5F6.js → ingest-IOFHL5VG.js}

@@ -4,8 +4,8 @@ import {
   plural,
   style,
   workflowStateDir
-} from "./chunk-2F2HM7FE.js";
-import "./chunk-75LXBAYB.js";
+} from "./chunk-YQS2VF65.js";
+import "./chunk-3SXAQHHJ.js";
 import "./chunk-42YJX3W5.js";
 import "./chunk-4BQPCZLL.js";
 import "./chunk-M56633DV.js";
@@ -23,7 +23,7 @@ async function readLink(link, options) {
   return { link: result.link, source: result.source, license: result.license, fetchedAt: result.fetchedAt, entries: result.entries, skipped: result.skipped, notes: result.notes };
 }
 async function fileIngestDraft(project, reading, state) {
-  const { FileStore, RuleWorkflow } = await import("./src-VSWKGVFT.js");
+  const { FileStore, RuleWorkflow } = await import("./src-LESGEHOC.js");
   const workflow = new RuleWorkflow({ projectRoot: project.root, store: new FileStore(workflowStateDir(project, state)), ...project.configFile ? { configPath: project.configFile } : {}, ...project.designOverride ? { designRoot: project.repo.root } : {}, ...project.rootOverride ? { productRoot: project.root } : {}, ingest: async () => reading });
   const draft = await workflow.create({ kind: "person", name: userInfo().username }, { kind: "ingest", link: reading.link });
   return { id: draft.id, problems: draft.problems };

package/dist/chunks/{src-Q3ZJHEUQ.js → src-CCB3D7EM.js}

@@ -188,7 +188,7 @@ import {
   whyNoLines,
   withFile,
   withoutCredentials
-} from "./chunk-75LXBAYB.js";
+} from "./chunk-3SXAQHHJ.js";
 import {
   escapingLinks,
   relativeInside,

package/dist/chunks/{src-VSWKGVFT.js → src-LESGEHOC.js}

@@ -64,8 +64,8 @@ import {
   validateIngestContent,
   validateLibraryContent,
   validateStyleContent
-} from "./chunk-OE4RYJOS.js";
-import "./chunk-75LXBAYB.js";
+} from "./chunk-TI3G57PX.js";
+import "./chunk-3SXAQHHJ.js";
 import "./chunk-42YJX3W5.js";
 import "./chunk-4BQPCZLL.js";
 import "./chunk-M56633DV.js";

package/dist/chunks/{src-LGHUKRL2.js → src-Z3LZMTHC.js}

@@ -2,7 +2,7 @@ import { createRequire as __youiRequire } from "node:module"; import { dirname a
 import {
   RequestStore,
   requestBrief
-} from "./chunk-OE4RYJOS.js";
+} from "./chunk-TI3G57PX.js";
 import {
   PROJECT_FILE,
   ScanCache,
@@ -30,7 +30,7 @@ import {
   shotsText,
   tokenRows,
   whereUsed
-} from "./chunk-75LXBAYB.js";
+} from "./chunk-3SXAQHHJ.js";
 import "./chunk-42YJX3W5.js";
 import {
   SHADCN_SLOTS,

package/dist/hub-previews.js

@@ -17,8 +17,8 @@ import {
   selectCandidates,
   thumbsDir,
   writeThumbIndex
-} from "./chunks/chunk-AFEQZT2N.js";
-import "./chunks/chunk-NG73FB4O.js";
+} from "./chunks/chunk-6UHSXSS6.js";
+import "./chunks/chunk-WBU7YJGZ.js";
 import "./chunks/chunk-FVVL5JCY.js";
 import "./chunks/chunk-M56633DV.js";
 import "./chunks/chunk-WNTS7ZO4.js";

package/dist/hub-server.js

@@ -2,7 +2,7 @@
 import { createRequire as __youiRequire } from "node:module"; import { dirname as __youiDir } from "node:path"; import { fileURLToPath as __youiPath } from "node:url"; const require = __youiRequire(import.meta.url); const __youiDirname = __youiDir(__youiPath(import.meta.url));
 import {
   discoverThumbsMiddleware
-} from "./chunks/chunk-AFEQZT2N.js";
+} from "./chunks/chunk-6UHSXSS6.js";
 import {
   isLocalHost,
   loadPackage,
@@ -10,7 +10,7 @@ import {
   readTryIndex,
   send,
   tryMiddleware
-} from "./chunks/chunk-NG73FB4O.js";
+} from "./chunks/chunk-WBU7YJGZ.js";
 import "./chunks/chunk-FVVL5JCY.js";
 import "./chunks/chunk-M56633DV.js";
 import "./chunks/chunk-WNTS7ZO4.js";

package/dist/hub-snapshot.js

@@ -3,7 +3,7 @@ import { createRequire as __youiRequire } from "node:module"; import { dirname a
 import {
   loadPackage,
   tryProject
-} from "./chunks/chunk-NG73FB4O.js";
+} from "./chunks/chunk-WBU7YJGZ.js";
 import "./chunks/chunk-FVVL5JCY.js";
 import "./chunks/chunk-WNTS7ZO4.js";
 

package/dist/youi.js

@@ -2,9 +2,9 @@
 import { createRequire as __youiRequire } from "node:module"; import { dirname as __youiDir } from "node:path"; import { fileURLToPath as __youiPath } from "node:url"; const require = __youiRequire(import.meta.url); const __youiDirname = __youiDir(__youiPath(import.meta.url));
 import {
   main
-} from "./chunks/chunk-DHZDMZXE.js";
-import "./chunks/chunk-2F2HM7FE.js";
-import "./chunks/chunk-75LXBAYB.js";
+} from "./chunks/chunk-K2W23VI3.js";
+import "./chunks/chunk-YQS2VF65.js";
+import "./chunks/chunk-3SXAQHHJ.js";
 import "./chunks/chunk-42YJX3W5.js";
 import "./chunks/chunk-5D7PLY7A.js";
 import "./chunks/chunk-UJMXSTUF.js";

package/dist/youiyoux.js

@@ -3,9 +3,9 @@ import { createRequire as __youiRequire } from "node:module"; import { dirname a
 import {
   COMMAND_NAMES,
   main
-} from "./chunks/chunk-DHZDMZXE.js";
-import "./chunks/chunk-2F2HM7FE.js";
-import "./chunks/chunk-75LXBAYB.js";
+} from "./chunks/chunk-K2W23VI3.js";
+import "./chunks/chunk-YQS2VF65.js";
+import "./chunks/chunk-3SXAQHHJ.js";
 import "./chunks/chunk-42YJX3W5.js";
 import "./chunks/chunk-5D7PLY7A.js";
 import "./chunks/chunk-UJMXSTUF.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "youiyoux",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "Your agent rebuilds components you already have. youiyoux catches it: npx youiyoux turns any repo into a shareable report of near-duplicate components, hardcoded token values and off-library imports, with the fixes.",
   "license": "MIT",
   "repository": {
@@ -46,9 +46,9 @@
     "typescript": "6.0.3"
   },
   "devDependencies": {
-    "@youiyoux/cli": "0.1.19",
-    "@youiyoux/core": "0.1.19",
-    "@youiyoux/scanner": "0.1.19"
+    "@youiyoux/cli": "0.1.20",
+    "@youiyoux/core": "0.1.20",
+    "@youiyoux/scanner": "0.1.20"
   },
   "exports": {
     "./package.json": "./package.json"