srcdev-nuxt-components 9.4.11 → 9.5.0

package/.claude/component-ledger/build.mjs

@@ -1,164 +0,0 @@
-// Regenerates .claude/component-ledger/audit.json (raw data) and output.html (ready to
-// publish as the Component Ledger artifact) from the current state of the repo.
-//
-// Run from the repo root: node .claude/component-ledger/build.mjs
-//
-// Checked against the standard in memory (project_component_compliance_standard.md) and
-// CLAUDE.md's Development Workflow / Styling Methodology sections.
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import { execFileSync } from "child_process";
-
-const here = path.dirname(fileURLToPath(import.meta.url));
-const root = path.resolve(here, "../.."); // repo root
-const componentsRoot = path.join(root, "app/components");
-
-// ESLint diagnostics (errors AND warnings — e.g. a dead `const props = withDefaults(...)` that
-// nothing references, or a stray unused import) per .vue file, run once across the whole tree
-// rather than per group for speed. `execFileSync` throws when eslint exits non-zero (i.e. any
-// error-level finding), so the JSON is read from the error object's stdout in that case too.
-function collectEslintIssues() {
-  const args = ["eslint", componentsRoot, "--format", "json"];
-  let stdout;
-  try {
-    stdout = execFileSync("npx", args, { cwd: root, maxBuffer: 1024 * 1024 * 50 });
-  } catch (err) {
-    stdout = err.stdout;
-  }
-  if (!stdout) return new Map();
-  const results = JSON.parse(stdout.toString());
-  const byFile = new Map();
-  for (const r of results) {
-    if (r.messages.length > 0) byFile.set(r.filePath, r.messages.length);
-  }
-  return byFile;
-}
-const eslintIssuesByFile = collectEslintIssues();
-
-function walk(dir, out = []) {
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) walk(full, out);
-    else if (entry.name.endsWith(".vue")) out.push(full);
-  }
-  return out;
-}
-
-const vueFiles = walk(componentsRoot).filter(
-  (f) => !f.split(path.sep).includes("tests") && !f.split(path.sep).includes("stories")
-);
-
-function toKebab(name) {
-  return name.replace(/(?<!^)(?=[A-Z])/g, "-").toLowerCase();
-}
-
-const skillsDir = path.join(root, ".claude/skills/components");
-const skills = new Set(
-  fs.existsSync(skillsDir)
-    ? fs.readdirSync(skillsDir).filter((f) => f.endsWith(".md")).map((f) => f.slice(0, -3))
-    : []
-);
-const vscodeDir = path.join(root, ".vscode");
-const snippets = fs.existsSync(vscodeDir)
-  ? fs.readdirSync(vscodeDir).filter((f) => f.endsWith(".code-snippets"))
-  : [];
-
-const groups = new Map();
-for (const vf of vueFiles) {
-  const d = path.dirname(vf);
-  const base = path.basename(d);
-  const compdir = base === "variants" ? path.dirname(d) : d;
-  if (!groups.has(compdir)) groups.set(compdir, []);
-  groups.get(compdir).push(vf);
-}
-
-const rows = [];
-for (const [compdir, files] of [...groups.entries()].sort()) {
-  const relDir = path.relative(componentsRoot, compdir);
-  const tierMatch = compdir.match(/app\/components\/(0\d\.\w+)\//);
-  const tier = tierMatch ? tierMatch[1] : "NONE";
-  const hasConsumerStyling = fs.existsSync(path.join(compdir, "CONSUMER-STYLING.md"));
-  const hasTests =
-    fs.existsSync(path.join(compdir, "tests")) && fs.statSync(path.join(compdir, "tests")).isDirectory();
-  const hasStoriesDir =
-    fs.existsSync(path.join(compdir, "stories")) && fs.statSync(path.join(compdir, "stories")).isDirectory();
-  const hasStoriesFile = fs.readdirSync(compdir).some((f) => f.endsWith(".stories.ts"));
-  const vueNames = files.map((f) => toKebab(path.basename(f, ".vue")));
-  const kebabDir = path.basename(compdir);
-  const skillHit = skills.has(kebabDir) || vueNames.some((v) => skills.has(v));
-  const snippetHit = snippets.some((s) => s.includes(kebabDir) || vueNames.some((v) => s.includes(v)));
-  let privCount = 0;
-  for (const f of files) {
-    const content = fs.readFileSync(f, "utf-8");
-    const m = content.match(/--_[\w-]+/g);
-    privCount += m ? new Set(m).size : 0;
-  }
-  const hasVariants = files.some((f) => path.basename(path.dirname(f)) === "variants");
-  // Legacy options-style props: `defineProps({ ... })` rather than `defineProps<Props>(...)`.
-  // A plain regex on `defineProps<` is enough to clear a file — anything calling defineProps
-  // without that generic is assumed options-style.
-  const hasLegacyProps = files.some((f) => {
-    const content = fs.readFileSync(f, "utf-8");
-    return /defineProps\s*\(/.test(content) && !/defineProps\s*<.+?>\s*\(/s.test(content);
-  });
-  // Storybook Controls-panel reactivity bug: @storybook/vue3 mounts the story component ONCE
-  // and, on every Controls change, mutates the same reactive `args` object in place — it never
-  // re-runs setup(). A story that destructures/spreads `args` into local variables/a ref at
-  // setup-time (e.g. `const { modelValue, ...otherArgs } = args;`) takes a one-time snapshot, so
-  // most Controls silently stop updating the rendered story after first render. The fix wraps any
-  // such destructuring in a `computed(() => {...})` and keeps the template bound through the live
-  // `args` object (`args.x`) — so a spread-from-`args` assignment is only a bug when it is NOT
-  // inside a `computed()`.
-  const storySpreadFromArgsRe = /\{[^{}]*\.\.\.[A-Za-z0-9_]+[^{}]*\}\s*=\s*args;/g;
-  const computedWrapsIt = (before) => /computed\s*\(\s*\(\)\s*=>\s*\{[^{}]*$/.test(before);
-  const storyFiles = fs.existsSync(path.join(compdir, "stories"))
-    ? fs
-        .readdirSync(path.join(compdir, "stories"))
-        .filter((f) => f.endsWith(".stories.ts"))
-        .map((f) => path.join(compdir, "stories", f))
-    : fs.readdirSync(compdir).filter((f) => f.endsWith(".stories.ts")).map((f) => path.join(compdir, f));
-  const hasStoryArgsBug = storyFiles.some((f) => {
-    const content = fs.readFileSync(f, "utf-8");
-    let match;
-    storySpreadFromArgsRe.lastIndex = 0;
-    while ((match = storySpreadFromArgsRe.exec(content))) {
-      const before = content.slice(Math.max(0, match.index - 150), match.index);
-      if (!computedWrapsIt(before)) return true;
-    }
-    return false;
-  });
-  const hasEslintIssues = files.some((f) => eslintIssuesByFile.has(f));
-
-  rows.push({
-    compdir: relDir,
-    tier,
-    n_vue: files.length,
-    variants: hasVariants,
-    legacy_props: hasLegacyProps,
-    story_args_bug: hasStoryArgsBug,
-    eslint_issues: hasEslintIssues,
-    consumer_styling: hasConsumerStyling,
-    tests: hasTests,
-    stories: hasStoriesDir || hasStoriesFile,
-    skill: skillHit,
-    snippet: snippetHit,
-    priv_tokens: privCount,
-  });
-}
-
-rows.forEach((d) => {
-  d.score = ["consumer_styling", "tests", "stories", "skill", "snippet"].filter((k) => d[k]).length;
-});
-
-const auditedAt = new Date().toISOString().slice(0, 10);
-const payload = { auditedAt, rows };
-
-fs.writeFileSync(path.join(here, "audit.json"), JSON.stringify(payload));
-
-const template = fs.readFileSync(path.join(here, "template.html"), "utf-8");
-const output = template.replace("__PAYLOAD__", JSON.stringify(payload));
-fs.writeFileSync(path.join(here, "output.html"), output);
-
-console.log(`Component Ledger rebuilt: ${rows.length} groups, ${rows.reduce((s, d) => s + d.n_vue, 0)} .vue files.`);
-console.log(`Output: ${path.join(here, "output.html")}`);