uidex 0.2.1 → 0.3.0

package/dist/scripts/cli.cjs

@@ -1,1168 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
-// scripts/init.ts
-var fs = __toESM(require("fs"), 1);
-var path = __toESM(require("path"), 1);
-var readline = __toESM(require("readline"), 1);
-
-// scripts/cli-utils.ts
-var colors = {
-  reset: "\x1B[0m",
-  bold: "\x1B[1m",
-  dim: "\x1B[2m",
-  green: "\x1B[32m",
-  yellow: "\x1B[33m",
-  blue: "\x1B[34m",
-  cyan: "\x1B[36m",
-  red: "\x1B[31m"
-};
-function success(message) {
-  console.log(`${colors.green}\u2713${colors.reset} ${message}`);
-}
-function info(message) {
-  console.log(`${colors.blue}\u2139${colors.reset} ${message}`);
-}
-function warn(message) {
-  console.log(`${colors.yellow}\u26A0${colors.reset} ${message}`);
-}
-function error(message) {
-  console.log(`${colors.red}\u2717${colors.reset} ${message}`);
-}
-function heading(message) {
-  console.log(`
-${colors.bold}${colors.cyan}${message}${colors.reset}
-`);
-}
-
-// scripts/init.ts
-function log(message) {
-  console.log(message);
-}
-function detectProject() {
-  const cwd = process.cwd();
-  const packageJsonPath = path.join(cwd, "package.json");
-  let packageJson = {};
-  if (fs.existsSync(packageJsonPath)) {
-    packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
-  }
-  const deps = {
-    ...packageJson.dependencies,
-    ...packageJson.devDependencies
-  };
-  const name = packageJson.name || path.basename(cwd);
-  const usesTypeScript = fs.existsSync(path.join(cwd, "tsconfig.json")) || !!deps["typescript"];
-  const hasSrcDir = fs.existsSync(path.join(cwd, "src"));
-  const srcDir = hasSrcDir ? "src" : ".";
-  if (deps["next"]) {
-    const usesAppRouter = fs.existsSync(path.join(cwd, "src", "app")) || fs.existsSync(path.join(cwd, "app"));
-    return {
-      type: "nextjs",
-      name,
-      srcDir,
-      usesTypeScript,
-      usesAppRouter
-    };
-  }
-  if (deps["vite"] || fs.existsSync(path.join(cwd, "vite.config.ts")) || fs.existsSync(path.join(cwd, "vite.config.js"))) {
-    return {
-      type: "vite",
-      name,
-      srcDir,
-      usesTypeScript,
-      usesAppRouter: false
-    };
-  }
-  if (deps["react-scripts"]) {
-    return {
-      type: "cra",
-      name,
-      srcDir,
-      usesTypeScript,
-      usesAppRouter: false
-    };
-  }
-  return {
-    type: "unknown",
-    name,
-    srcDir,
-    usesTypeScript,
-    usesAppRouter: false
-  };
-}
-function createConfigContent(project) {
-  const config = {
-    $schema: "node_modules/uidex/uidex.schema.json",
-    defaults: {
-      color: "#3b82f6",
-      borderStyle: "solid",
-      borderWidth: 2,
-      showLabel: true,
-      labelPosition: "top-left"
-    },
-    colors: {
-      primary: "#3b82f6",
-      secondary: "#8b5cf6",
-      success: "#10b981",
-      warning: "#f59e0b",
-      error: "#ef4444",
-      info: "#0ea5e9"
-    },
-    scanner: {
-      rootDir: project.srcDir,
-      include: ["**/*.tsx", "**/*.jsx"],
-      exclude: ["**/*.test.*", "**/*.spec.*", "**/*.gen.ts"],
-      outputPath: `${project.srcDir}/uidex.gen.ts`
-    }
-  };
-  return JSON.stringify(config, null, 2);
-}
-function addToGitignore(entry) {
-  const cwd = process.cwd();
-  const gitignorePath = path.join(cwd, ".gitignore");
-  let content = "";
-  if (fs.existsSync(gitignorePath)) {
-    content = fs.readFileSync(gitignorePath, "utf-8");
-  }
-  const lines = content.split("\n");
-  if (lines.some((line) => line.trim() === entry)) {
-    return false;
-  }
-  const newContent = content.endsWith("\n") || content === "" ? `${content}${entry}
-` : `${content}
-${entry}
-`;
-  fs.writeFileSync(gitignorePath, newContent, "utf-8");
-  return true;
-}
-function createPrompt() {
-  return readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-}
-async function askYesNo(rl, question, defaultYes = true) {
-  const hint = defaultYes ? "[Y/n]" : "[y/N]";
-  return new Promise((resolve4) => {
-    rl.question(`${question} ${colors.dim}${hint}${colors.reset} `, (answer) => {
-      const normalized = answer.trim().toLowerCase();
-      if (normalized === "") {
-        resolve4(defaultYes);
-      } else {
-        resolve4(normalized === "y" || normalized === "yes");
-      }
-    });
-  });
-}
-function getEntryPointHint(project) {
-  if (project.type === "nextjs") {
-    if (project.usesAppRouter) {
-      return project.srcDir === "src" ? "src/app/layout.tsx" : "app/layout.tsx";
-    }
-    return project.srcDir === "src" ? "src/pages/_app.tsx" : "pages/_app.tsx";
-  }
-  return project.srcDir === "src" ? "src/main.tsx" : "main.tsx";
-}
-async function init() {
-  heading("uidex init");
-  const cwd = process.cwd();
-  const configPath = path.join(cwd, ".uidex.json");
-  if (fs.existsSync(configPath)) {
-    warn(".uidex.json already exists");
-    const rl = createPrompt();
-    const overwrite = await askYesNo(rl, "Overwrite existing config?", false);
-    rl.close();
-    if (!overwrite) {
-      info("Keeping existing configuration");
-      return;
-    }
-  }
-  const project = detectProject();
-  log(`Detected project: ${colors.bold}${project.name}${colors.reset}`);
-  log(`Project type: ${colors.bold}${project.type}${colors.reset}`);
-  log(
-    `Language: ${colors.bold}${project.usesTypeScript ? "TypeScript" : "JavaScript"}${colors.reset}`
-  );
-  if (project.type === "nextjs") {
-    log(
-      `Router: ${colors.bold}${project.usesAppRouter ? "App Router" : "Pages Router"}${colors.reset}`
-    );
-  }
-  heading("Creating configuration");
-  const configContent = createConfigContent(project);
-  fs.writeFileSync(configPath, configContent, "utf-8");
-  success("Created .uidex.json");
-  const genFile = "*.gen.ts";
-  if (addToGitignore(genFile)) {
-    success(`Added ${genFile} to .gitignore`);
-  } else {
-    info(`${genFile} already in .gitignore`);
-  }
-  heading("Next steps");
-  const entryPoint = getEntryPointHint(project);
-  log("1. Add data-uidex attributes to elements you want to track:");
-  log("");
-  log(`   ${colors.green}<button${colors.reset} data-uidex="submit-btn"${colors.green}>${colors.reset}Submit${colors.green}</button>${colors.reset}`);
-  log("");
-  log("2. Run the scanner to generate the components registry:");
-  log("");
-  log(`   ${colors.yellow}npx uidex-scan${colors.reset}`);
-  log("");
-  log("3. Import the generated file in your entry point:");
-  log("");
-  log(`   ${colors.dim}// ${entryPoint}${colors.reset}`);
-  log(`   ${colors.cyan}import${colors.reset} './${project.srcDir === "src" ? "" : "src/"}uidex.gen';`);
-  log("");
-  log("4. Add the UidexDevtools component anywhere in your app:");
-  log("");
-  log(`   ${colors.cyan}import${colors.reset} { UidexDevtools } ${colors.cyan}from${colors.reset} 'uidex';`);
-  log("");
-  log(`   ${colors.green}<UidexDevtools />${colors.reset}`);
-  log("");
-  success("Setup complete!");
-  log("");
-}
-
-// scripts/scan.ts
-var fs2 = __toESM(require("fs"), 1);
-var path2 = __toESM(require("path"), 1);
-
-// scripts/scanner-utils.ts
-var UIDEX_PAGE_FILENAME = "UIDEX_PAGE.md";
-var UIDEX_FEATURE_FILENAME = "UIDEX_FEATURE.md";
-function parseFrontmatter(content) {
-  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
-  if (!match) {
-    return { frontmatter: {}, body: content };
-  }
-  const raw = match[1];
-  const body = match[2];
-  const frontmatter = {};
-  const lines = raw.split("\n");
-  let inComponents = false;
-  const components = [];
-  for (const line of lines) {
-    if (/^components:\s*$/.test(line.trimEnd())) {
-      inComponents = true;
-      continue;
-    }
-    if (inComponents) {
-      const itemMatch = line.match(/^\s+-\s+(.+)$/);
-      if (itemMatch) {
-        components.push(itemMatch[1].trim());
-      } else if (line.trim() !== "") {
-        inComponents = false;
-      }
-    }
-  }
-  if (components.length > 0) {
-    frontmatter.components = components;
-  }
-  return { frontmatter, body };
-}
-function extractJSDocBlocks(content) {
-  const blocks = [];
-  const blockRegex = /\/\*\*[\s\S]*?\*\//g;
-  let match;
-  while ((match = blockRegex.exec(content)) !== null) {
-    const blockContent = match[0];
-    const uidexMatch = blockContent.match(/@uidex\s+(\S+)/);
-    if (!uidexMatch) continue;
-    const id = uidexMatch[1];
-    const description = extractJSDocDescription(blockContent, id);
-    if (!description) continue;
-    const blockStart = match.index;
-    const blockEnd = blockStart + blockContent.length;
-    const textBeforeEnd = content.substring(0, blockEnd);
-    const endLine = textBeforeEnd.split("\n").length;
-    blocks.push({ id, description, endLine });
-  }
-  return blocks;
-}
-function extractJSDocDescription(blockContent, id) {
-  const singleLineMatch = blockContent.match(
-    new RegExp(`@uidex\\s+${escapeRegex(id)}\\s+-\\s+(.+?)\\s*\\*\\/`)
-  );
-  if (singleLineMatch) {
-    return singleLineMatch[1].trim();
-  }
-  const lines = blockContent.split("\n");
-  const descriptionLines = [];
-  let foundUidex = false;
-  for (const line of lines) {
-    if (line.includes(`@uidex`) && line.includes(id)) {
-      foundUidex = true;
-      const inlineMatch = line.match(new RegExp(`@uidex\\s+${escapeRegex(id)}\\s+(.+)`));
-      if (inlineMatch) {
-        const inline = inlineMatch[1].replace(/\*\/$/, "").trim();
-        if (inline && !inline.startsWith("-")) {
-          descriptionLines.push(inline);
-        }
-      }
-      continue;
-    }
-    if (foundUidex) {
-      if (line.includes("@") && /^\s*\*\s*@/.test(line)) {
-        break;
-      }
-      if (line.includes("*/")) {
-        break;
-      }
-      const contentMatch = line.match(/^\s*\*\s*(.*)$/);
-      if (contentMatch) {
-        const content = contentMatch[1].trim();
-        if (content) {
-          descriptionLines.push(content);
-        }
-      }
-    }
-  }
-  return descriptionLines.join(" ").trim();
-}
-function formatRoute(dir) {
-  const stripped = dir.replace(/^src\/app\/?/, "").replace(/^src\/pages\/?/, "").replace(/^app\/?/, "").replace(/^pages\/?/, "");
-  return "/" + stripped;
-}
-function parseAcceptanceCriteria(content) {
-  const lines = content.split("\n");
-  const criteria = [];
-  let inAcceptance = false;
-  for (const line of lines) {
-    if (/^##\s+Acceptance/.test(line)) {
-      inAcceptance = true;
-      continue;
-    }
-    if (inAcceptance) {
-      if (/^##\s+/.test(line)) break;
-      const match = line.match(/^-\s+(.+)$/);
-      if (match) criteria.push(match[1].trim());
-    }
-  }
-  return criteria;
-}
-function parseMarkdownTitle(content) {
-  const match = content.match(/^#\s+(.+)$/m);
-  return match ? match[1].trim() : null;
-}
-function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function extractComponents(content) {
-  const results = [];
-  const jsDocBlocks = extractJSDocBlocks(content);
-  const regex = /data-uidex\s*=\s*(?:"([^"]+)"|'([^']+)'|\{["'`]([^"'`]+)["'`]\})/g;
-  const lines = content.split("\n");
-  lines.forEach((line, index) => {
-    let match;
-    regex.lastIndex = 0;
-    while ((match = regex.exec(line)) !== null) {
-      const id = match[1] || match[2] || match[3];
-      if (id) {
-        const lineNumber = index + 1;
-        const matchingBlocks = jsDocBlocks.filter(
-          (block) => block.id === id && block.endLine <= lineNumber && lineNumber - block.endLine <= 5
-        );
-        const matchingBlock = matchingBlocks.length > 0 ? matchingBlocks.reduce(
-          (closest, block) => block.endLine > closest.endLine ? block : closest
-        ) : void 0;
-        results.push({
-          id,
-          line: lineNumber,
-          ...matchingBlock?.description ? { doc: matchingBlock.description } : {}
-        });
-      }
-    }
-  });
-  return results;
-}
-
-// scripts/scan.ts
-var DEFAULT_SOURCE = {
-  rootDir: "src",
-  include: ["**/*.tsx", "**/*.jsx"]
-};
-var DEFAULT_CONFIG = {
-  sources: [DEFAULT_SOURCE],
-  exclude: ["**/*.test.*", "**/*.spec.*", "**/node_modules/**", "**/*.gen.ts"],
-  outputPath: "src/uidex.gen.ts"
-};
-function loadConfig() {
-  const configPath = path2.resolve(process.cwd(), ".uidex.json");
-  if (!fs2.existsSync(configPath)) {
-    console.log("No .uidex.json found, using defaults");
-    return DEFAULT_CONFIG;
-  }
-  try {
-    const content = fs2.readFileSync(configPath, "utf-8");
-    const config = JSON.parse(content);
-    if (!config.scanner) {
-      console.log("No scanner config in .uidex.json, using defaults");
-      return DEFAULT_CONFIG;
-    }
-    const scanner = config.scanner;
-    return {
-      sources: scanner.sources?.length ? scanner.sources.map((source) => ({
-        rootDir: source.rootDir,
-        include: source.include,
-        exclude: source.exclude,
-        prefix: source.prefix
-      })) : DEFAULT_CONFIG.sources,
-      exclude: scanner.exclude ?? DEFAULT_CONFIG.exclude,
-      outputPath: scanner.outputPath ?? DEFAULT_CONFIG.outputPath
-    };
-  } catch (error2) {
-    console.error("Error reading .uidex.json:", error2);
-    return DEFAULT_CONFIG;
-  }
-}
-function globToRegex(glob) {
-  const escaped = glob.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "{{GLOBSTAR}}").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(/{{GLOBSTAR}}/g, ".*");
-  return new RegExp(`^${escaped}$`);
-}
-function compilePatterns(patterns) {
-  return patterns.map(globToRegex);
-}
-function matchesPatterns(filePath, patterns) {
-  const normalizedPath = filePath.replace(/\\/g, "/");
-  return patterns.some((regex) => regex.test(normalizedPath));
-}
-function walkDir(dir, baseDir = dir) {
-  const result = { files: [], pageDocs: /* @__PURE__ */ new Map(), featureDocs: /* @__PURE__ */ new Map() };
-  if (!fs2.existsSync(dir)) {
-    return result;
-  }
-  const entries = fs2.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path2.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (entry.name === "node_modules") continue;
-      const sub = walkDir(fullPath, baseDir);
-      result.files.push(...sub.files);
-      for (const [k, v] of sub.pageDocs) {
-        result.pageDocs.set(k, v);
-      }
-      for (const [k, v] of sub.featureDocs) {
-        result.featureDocs.set(k, v);
-      }
-    } else if (entry.isFile()) {
-      if (entry.name === UIDEX_PAGE_FILENAME || entry.name === UIDEX_FEATURE_FILENAME) {
-        const relativeDir = path2.relative(baseDir, dir).replace(/\\/g, "/") || ".";
-        const content = fs2.readFileSync(fullPath, "utf-8");
-        if (entry.name === UIDEX_PAGE_FILENAME) {
-          result.pageDocs.set(relativeDir, content);
-        } else {
-          result.featureDocs.set(relativeDir, content);
-        }
-      } else {
-        const relativePath = path2.relative(baseDir, fullPath).replace(/\\/g, "/");
-        result.files.push(relativePath);
-      }
-    }
-  }
-  return result;
-}
-function findFilesForSource(source, globalExclude) {
-  const rootDir = path2.resolve(process.cwd(), source.rootDir);
-  const walkResult = walkDir(rootDir);
-  const includeRegexes = compilePatterns(source.include);
-  const excludeRegexes = compilePatterns([...globalExclude, ...source.exclude ?? []]);
-  const files = walkResult.files.filter((file) => {
-    const matchesInclude = matchesPatterns(file, includeRegexes);
-    const matchesExclude = matchesPatterns(file, excludeRegexes);
-    return matchesInclude && !matchesExclude;
-  }).map((relativePath) => {
-    const outputPath = source.prefix ? `${source.prefix}/${relativePath}` : relativePath;
-    return {
-      relativePath,
-      fullPath: path2.join(rootDir, relativePath),
-      outputPath
-    };
-  });
-  function applyPrefix(docs) {
-    const result = /* @__PURE__ */ new Map();
-    for (const [dir, content] of docs) {
-      const outputDir = source.prefix ? `${source.prefix}/${dir}` : dir;
-      result.set(outputDir, content);
-    }
-    return result;
-  }
-  return {
-    files,
-    pageDocs: applyPrefix(walkResult.pageDocs),
-    featureDocs: applyPrefix(walkResult.featureDocs)
-  };
-}
-function buildPages(docs, sourceComponentIds, sourceRootDir) {
-  if (docs.size === 0) return [];
-  const docDirs = [...docs.keys()].sort((a, b) => b.length - a.length);
-  const pageComponentSets = /* @__PURE__ */ new Map();
-  for (const dir of docDirs) {
-    pageComponentSets.set(dir, /* @__PURE__ */ new Set());
-  }
-  for (const [id, filePaths] of sourceComponentIds) {
-    for (const filePath of filePaths) {
-      const fileDir = filePath.includes("/") ? filePath.substring(0, filePath.lastIndexOf("/")) : ".";
-      const nearestDir = docDirs.find(
-        (dir) => dir === "." || fileDir === dir || fileDir.startsWith(dir + "/")
-      );
-      if (nearestDir) {
-        pageComponentSets.get(nearestDir).add(id);
-      }
-    }
-  }
-  return docDirs.map((dir) => {
-    const fullDir = dir === "." ? sourceRootDir : `${sourceRootDir}/${dir}`;
-    return {
-      dir: fullDir,
-      content: docs.get(dir),
-      componentIds: [...pageComponentSets.get(dir)].sort()
-    };
-  });
-}
-function buildFeatures(featureDocs, sourceRootDir) {
-  const features = [];
-  for (const [dir, { body, explicitComponents }] of featureDocs) {
-    const fullDir = dir === "." ? sourceRootDir : `${sourceRootDir}/${dir}`;
-    features.push({
-      dir: fullDir,
-      content: body,
-      componentIds: [...explicitComponents].sort()
-    });
-  }
-  return features;
-}
-function generateTestOutput(components, pages, features) {
-  const sortedIds = Object.keys(components).sort();
-  const idsArrayStr = sortedIds.map((id) => `"${id}"`).join(", ");
-  const pageRoutes = pages.map((p) => ({ ...p, route: formatRoute(p.dir) }));
-  const routesStr = pageRoutes.length > 0 ? `
-export const routes = {
-${pageRoutes.map((p) => `  "${p.dir}": "${p.route}"`).join(",\n")}
-} as const;
-
-export type Route = typeof routes[keyof typeof routes];
-` : "";
-  const pagesStr = pageRoutes.length > 0 ? `
-export const pages = [
-${pageRoutes.map((p) => {
-    const ids = p.componentIds.map((id) => `"${id}"`).join(", ");
-    return `  { dir: "${p.dir}", route: "${p.route}", componentIds: [${ids}] as const }`;
-  }).join(",\n")}
-] as const;
-` : "";
-  const featuresStr = features.length > 0 ? `
-export const features = [
-${features.map((f) => {
-    const ids = f.componentIds.map((id) => `"${id}"`).join(", ");
-    return `  { dir: "${f.dir}", componentIds: [${ids}] as const }`;
-  }).join(",\n")}
-] as const;
-` : "";
-  return `// Auto-generated by uidex scanner \u2014 safe for test imports (no side effects)
-// Do not edit this file manually
-
-export const componentIds = [${idsArrayStr}] as const;
-
-export type ComponentId = typeof componentIds[number];
-${routesStr}${pagesStr}${featuresStr}`;
-}
-function generateOutput(components, pages, features) {
-  const sortedIds = Object.keys(components).sort();
-  const entriesStr = sortedIds.map((id) => {
-    const locations = components[id].map((loc) => {
-      const parts = [`filePath: "${loc.filePath}"`, `line: ${loc.line}`];
-      if (loc.doc) {
-        const escapedDoc = loc.doc.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n");
-        parts.push(`doc: "${escapedDoc}"`);
-      }
-      return `{ ${parts.join(", ")} }`;
-    }).join(", ");
-    return `  "${id}": [${locations}]`;
-  }).join(",\n");
-  const idsArrayStr = sortedIds.map((id) => `"${id}"`).join(", ");
-  function serializeDocEntries(entries) {
-    return entries.map((entry) => {
-      const escaped = entry.content.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$/g, "\\$");
-      const ids = entry.componentIds.map((id) => `"${id}"`).join(", ");
-      return `  { dir: "${entry.dir}", content: \`${escaped}\`, componentIds: [${ids}] }`;
-    }).join(",\n");
-  }
-  const pagesStr = pages.length > 0 ? `
-export const pages = [
-${serializeDocEntries(pages)}
-];
-` : "";
-  const featuresStr = features.length > 0 ? `
-export const features = [
-${serializeDocEntries(features)}
-];
-` : "";
-  const hasPages = pages.length > 0;
-  const hasFeatures = features.length > 0;
-  const importParts = ["registerComponents"];
-  if (hasPages) importParts.push("registerPages");
-  if (hasFeatures) importParts.push("registerFeatures");
-  const imports = `import { ${importParts.join(", ")} } from 'uidex';`;
-  const regParts = ["registerComponents(components);"];
-  if (hasPages) regParts.push("registerPages(pages);");
-  if (hasFeatures) regParts.push("registerFeatures(features);");
-  const registrations = `// Auto-register
-${regParts.join("\n")}
-`;
-  return `"use client";
-// Auto-generated by uidex scanner
-// Do not edit this file manually
-
-${imports}
-
-export const components = {
-${entriesStr}
-};
-
-export const componentIds = [${idsArrayStr}] as const;
-
-export type ComponentId = typeof componentIds[number];
-${pagesStr}${featuresStr}
-${registrations}`;
-}
-function ensureOutputDir(outputPath) {
-  const dir = path2.dirname(outputPath);
-  if (!fs2.existsSync(dir)) {
-    fs2.mkdirSync(dir, { recursive: true });
-  }
-}
-function runScan(config) {
-  const components = {};
-  const pages = [];
-  const features = [];
-  let totalComponents = 0;
-  let totalFiles = 0;
-  for (const source of config.sources) {
-    const sourceResult = findFilesForSource(source, config.exclude);
-    totalFiles += sourceResult.files.length;
-    console.log(
-      `Scanning ${source.rootDir}: ${sourceResult.files.length} files${source.prefix ? ` (\u2192 ${source.prefix}/*)` : ""}`
-    );
-    const sourceComponentIds = /* @__PURE__ */ new Map();
-    for (const file of sourceResult.files) {
-      const content = fs2.readFileSync(file.fullPath, "utf-8");
-      const fileComponents = extractComponents(content);
-      for (const component of fileComponents) {
-        if (!components[component.id]) {
-          components[component.id] = [];
-        }
-        components[component.id].push({
-          filePath: file.outputPath,
-          line: component.line,
-          ...component.doc ? { doc: component.doc } : {}
-        });
-        if (!sourceComponentIds.has(component.id)) {
-          sourceComponentIds.set(component.id, []);
-        }
-        sourceComponentIds.get(component.id).push(file.relativePath);
-        totalComponents++;
-      }
-    }
-    const sourcePages = buildPages(
-      sourceResult.pageDocs,
-      sourceComponentIds,
-      source.rootDir
-    );
-    pages.push(...sourcePages);
-    const parsedFeatureDocs = /* @__PURE__ */ new Map();
-    for (const [dir, rawContent] of sourceResult.featureDocs) {
-      const { frontmatter, body } = parseFrontmatter(rawContent);
-      parsedFeatureDocs.set(dir, {
-        body,
-        explicitComponents: frontmatter.components ?? []
-      });
-    }
-    const sourceFeatures = buildFeatures(parsedFeatureDocs, source.rootDir);
-    features.push(...sourceFeatures);
-  }
-  return { components, pages, features, totalComponents, totalFiles };
-}
-function printSummary(result) {
-  console.log("");
-  const uniqueIds = Object.keys(result.components).length;
-  console.log(
-    `Found ${result.totalComponents} components with ${uniqueIds} unique IDs in ${result.totalFiles} files
-`
-  );
-  if (uniqueIds > 0) {
-    console.log("Components found:");
-    for (const [id, locations] of Object.entries(result.components)) {
-      for (const loc of locations) {
-        console.log(`  "${id}" at ${loc.filePath}:${loc.line}`);
-      }
-    }
-    console.log("");
-  }
-  if (result.pages.length > 0) {
-    console.log(`Pages found: ${result.pages.length}`);
-    for (const page of result.pages) {
-      console.log(`  ${page.dir}/ (${page.componentIds.length} components)`);
-    }
-    console.log("");
-  }
-  if (result.features.length > 0) {
-    console.log(`Features found: ${result.features.length}`);
-    for (const feature of result.features) {
-      console.log(`  ${feature.dir}/ (${feature.componentIds.length} components)`);
-    }
-    console.log("");
-  }
-}
-function checkCoverage(result) {
-  const allComponentIds = Object.keys(result.components);
-  const coveredIds = /* @__PURE__ */ new Set([
-    ...result.pages.flatMap((p) => p.componentIds),
-    ...result.features.flatMap((f) => f.componentIds)
-  ]);
-  const uncoveredIds = allComponentIds.filter((id) => !coveredIds.has(id));
-  const orphanedPages = result.pages.filter((p) => p.componentIds.length === 0);
-  let passed = true;
-  if (uncoveredIds.length > 0) {
-    passed = false;
-    console.log(`Components missing UIDEX_PAGE.md coverage (${uncoveredIds.length}):`);
-    for (const id of uncoveredIds.sort()) {
-      const locations = result.components[id];
-      for (const loc of locations) {
-        console.log(`  "${id}" at ${loc.filePath}:${loc.line}`);
-      }
-    }
-    console.log("");
-  }
-  if (orphanedPages.length > 0) {
-    passed = false;
-    console.log(`UIDEX_PAGE.md files with no components (${orphanedPages.length}):`);
-    for (const page of orphanedPages) {
-      console.log(`  ${page.dir}/UIDEX_PAGE.md`);
-    }
-    console.log("");
-  }
-  if (passed) {
-    const totalDocs = result.pages.length + result.features.length;
-    console.log(
-      `All ${allComponentIds.length} components covered by ${totalDocs} UIDEX docs (${result.pages.length} pages, ${result.features.length} features)`
-    );
-  }
-  return passed;
-}
-function printConfig(config) {
-  console.log("Configuration:");
-  console.log(`  Sources: ${config.sources.length}`);
-  for (const source of config.sources) {
-    const prefix = source.prefix ? ` (prefix: ${source.prefix})` : "";
-    console.log(`    - ${source.rootDir}${prefix}`);
-    console.log(`      Include: ${source.include.join(", ")}`);
-    if (source.exclude) {
-      console.log(`      Exclude: ${source.exclude.join(", ")}`);
-    }
-  }
-  console.log(`  Global exclude: ${config.exclude.join(", ")}`);
-  console.log(`  Output: ${config.outputPath}
-`);
-}
-function scan() {
-  const isCheck = process.argv.includes("--check");
-  console.log(`uidex scanner${isCheck ? " (check mode)" : ""} starting...
-`);
-  const config = loadConfig();
-  printConfig(config);
-  const result = runScan(config);
-  printSummary(result);
-  if (isCheck) {
-    const passed = checkCoverage(result);
-    process.exit(passed ? 0 : 1);
-  }
-  const outputPath = path2.resolve(process.cwd(), config.outputPath);
-  ensureOutputDir(outputPath);
-  const output = generateOutput(result.components, result.pages, result.features);
-  fs2.writeFileSync(outputPath, output, "utf-8");
-  console.log(`Generated: ${config.outputPath}`);
-  const testOutputPath = outputPath.replace(/\.ts$/, ".test.ts");
-  const testOutput = generateTestOutput(result.components, result.pages, result.features);
-  fs2.writeFileSync(testOutputPath, testOutput, "utf-8");
-  console.log(`Generated: ${config.outputPath.replace(/\.ts$/, ".test.ts")}`);
-}
-
-// scripts/scaffold.ts
-var fs3 = __toESM(require("fs"), 1);
-var path3 = __toESM(require("path"), 1);
-function toTestFileName(dir, title) {
-  if (title) {
-    return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-  }
-  const segments = dir.split("/").filter(Boolean);
-  return segments[segments.length - 1] || "unnamed";
-}
-function generateTestFile(entry, fixtureImport) {
-  const title = parseMarkdownTitle(entry.content) ?? entry.dir;
-  const criteria = parseAcceptanceCriteria(entry.content);
-  const componentList = entry.componentIds.map((id) => `"${id}"`).join(", ");
-  const docFile = entry.kind === "page" ? "UIDEX_PAGE.md" : "UIDEX_FEATURE.md";
-  let body = "";
-  body += `// Auto-generated by uidex scaffold from ${entry.dir}/${docFile}
-`;
-  body += `// Fill in test implementations below
-
-`;
-  body += `import { test, expect } from '${fixtureImport}';
-
-`;
-  body += `test.describe('${title}', () => {
-`;
-  if (entry.kind === "page") {
-    const route = formatRoute(entry.dir);
-    body += `  // Route: ${route}
-`;
-    body += `  // Components: ${componentList}
-
-`;
-    body += `  test.beforeEach(async ({ page }) => {
-`;
-    body += `    await page.goto('${route}');
-`;
-    body += `  });
-`;
-  } else {
-    body += `  // Components: ${componentList}
-`;
-  }
-  if (criteria.length > 0) {
-    body += "\n";
-    for (const criterion of criteria) {
-      const escaped = criterion.replace(/'/g, "\\'");
-      body += `  test.todo('${escaped}');
-`;
-    }
-  }
-  body += `});
-`;
-  return body;
-}
-function scaffold(outputDir) {
-  const dir = outputDir ?? "e2e";
-  heading("uidex scaffold");
-  info(`Output directory: ${dir}/`);
-  const config = loadConfig();
-  const result = runScan(config);
-  if (result.pages.length === 0 && result.features.length === 0) {
-    warn("No pages or features found. Create UIDEX_PAGE.md or UIDEX_FEATURE.md files first.");
-    return;
-  }
-  const absDir = path3.resolve(process.cwd(), dir);
-  if (!fs3.existsSync(absDir)) {
-    fs3.mkdirSync(absDir, { recursive: true });
-  }
-  const fixtureImport = "./fixtures";
-  let generated = 0;
-  let skipped = 0;
-  const entries = [
-    ...result.pages.map((p) => ({ kind: "page", ...p })),
-    ...result.features.map((f) => ({ kind: "feature", ...f }))
-  ];
-  for (const entry of entries) {
-    const title = parseMarkdownTitle(entry.content);
-    const fileName = `${entry.kind}-${toTestFileName(entry.dir, title)}.spec.ts`;
-    const filePath = path3.join(absDir, fileName);
-    if (fs3.existsSync(filePath)) {
-      info(`Skipped ${fileName} (already exists)`);
-      skipped++;
-      continue;
-    }
-    const content = generateTestFile(entry, fixtureImport);
-    fs3.writeFileSync(filePath, content, "utf-8");
-    success(`Generated ${fileName}`);
-    generated++;
-  }
-  const fixturesPath = path3.join(absDir, "fixtures.ts");
-  if (!fs3.existsSync(fixturesPath)) {
-    fs3.writeFileSync(
-      fixturesPath,
-      `export { test, expect } from 'uidex/playwright';
-`,
-      "utf-8"
-    );
-    success("Generated fixtures.ts");
-    generated++;
-  }
-  console.log("");
-  info(`${generated} file(s) generated, ${skipped} skipped`);
-  if (generated > 0) {
-    console.log("");
-    info("Next steps:");
-    console.log("  1. Replace test.todo() calls with test implementations");
-    console.log("  2. Use the uidex fixture for type-safe selectors:");
-    console.log("");
-    console.log("     test('add todo', async ({ uidex }) => {");
-    console.log("       await uidex('todo-input').fill('Buy milk');");
-    console.log("       await uidex('todo-add-button').click();");
-    console.log("     });");
-    console.log("");
-  }
-}
-
-// scripts/claude-setup.ts
-var fs4 = __toESM(require("fs"), 1);
-var path4 = __toESM(require("path"), 1);
-function readTemplate(filename) {
-  const candidates = [
-    // Built package: __dirname = <pkg>/dist/scripts → ../../claude/
-    path4.resolve(__dirname, "..", "..", "claude", filename),
-    // Dev mode: __dirname = <repo>/scripts → ../claude/
-    path4.resolve(__dirname, "..", "claude", filename)
-  ];
-  for (const candidate of candidates) {
-    try {
-      return fs4.readFileSync(candidate, "utf-8");
-    } catch {
-    }
-  }
-  throw new Error(
-    `Template not found: ${filename}. The uidex package may be corrupted \u2014 try reinstalling.`
-  );
-}
-function ensureDir(dirPath) {
-  fs4.mkdirSync(dirPath, { recursive: true });
-}
-function addRules() {
-  const cwd = process.cwd();
-  const targetDir = path4.join(cwd, ".claude", "rules");
-  const targetPath = path4.join(targetDir, "uidex.md");
-  const content = readTemplate("rules.md");
-  ensureDir(targetDir);
-  fs4.writeFileSync(targetPath, content, "utf-8");
-  success("Added .claude/rules/uidex.md");
-}
-function removeRules() {
-  const targetPath = path4.join(process.cwd(), ".claude", "rules", "uidex.md");
-  try {
-    fs4.unlinkSync(targetPath);
-    success("Removed .claude/rules/uidex.md");
-  } catch (e) {
-    if (e.code === "ENOENT") {
-      info(".claude/rules/uidex.md does not exist");
-    } else {
-      throw e;
-    }
-  }
-}
-function addSkill() {
-  const cwd = process.cwd();
-  const targetDir = path4.join(cwd, ".claude", "commands");
-  const targetPath = path4.join(targetDir, "uidex-audit.md");
-  const content = readTemplate("audit-command.md");
-  ensureDir(targetDir);
-  fs4.writeFileSync(targetPath, content, "utf-8");
-  success("Added .claude/commands/uidex-audit.md");
-}
-function removeSkill() {
-  const targetPath = path4.join(process.cwd(), ".claude", "commands", "uidex-audit.md");
-  try {
-    fs4.unlinkSync(targetPath);
-    success("Removed .claude/commands/uidex-audit.md");
-  } catch (e) {
-    if (e.code === "ENOENT") {
-      info(".claude/commands/uidex-audit.md does not exist");
-    } else {
-      throw e;
-    }
-  }
-}
-var UIDEX_HOOK_COMMAND = "npx uidex scan --check";
-function isUidexHookEntry(entry) {
-  return entry.hooks?.some((h) => h.command === UIDEX_HOOK_COMMAND) ?? false;
-}
-function readSettings(settingsPath) {
-  try {
-    return JSON.parse(fs4.readFileSync(settingsPath, "utf-8"));
-  } catch (e) {
-    if (e.code === "ENOENT") {
-      return {};
-    }
-    error(`Failed to parse .claude/settings.json: ${e.message}`);
-    process.exit(1);
-  }
-}
-function addHooks() {
-  const cwd = process.cwd();
-  const settingsDir = path4.join(cwd, ".claude");
-  const settingsPath = path4.join(settingsDir, "settings.json");
-  const settings = readSettings(settingsPath);
-  if (!settings.hooks) {
-    settings.hooks = {};
-  }
-  if (!Array.isArray(settings.hooks.PostToolUse)) {
-    settings.hooks.PostToolUse = [];
-  }
-  if (settings.hooks.PostToolUse.some(isUidexHookEntry)) {
-    info("uidex hook already configured in .claude/settings.json");
-    return;
-  }
-  settings.hooks.PostToolUse.push({
-    matcher: "Edit|Write",
-    hooks: [
-      {
-        type: "command",
-        command: UIDEX_HOOK_COMMAND,
-        timeout: 30
-      }
-    ]
-  });
-  ensureDir(settingsDir);
-  fs4.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
-  success("Added uidex hook to .claude/settings.json");
-}
-function removeHooks() {
-  const settingsPath = path4.join(process.cwd(), ".claude", "settings.json");
-  const settings = readSettings(settingsPath);
-  if (!Array.isArray(settings.hooks?.PostToolUse)) {
-    info("No PostToolUse hooks configured");
-    return;
-  }
-  const before = settings.hooks.PostToolUse.length;
-  settings.hooks.PostToolUse = settings.hooks.PostToolUse.filter(
-    (entry) => !isUidexHookEntry(entry)
-  );
-  const after = settings.hooks.PostToolUse.length;
-  if (before === after) {
-    info("No uidex hook found in .claude/settings.json");
-    return;
-  }
-  if (settings.hooks.PostToolUse.length === 0) {
-    delete settings.hooks.PostToolUse;
-  }
-  if (Object.keys(settings.hooks).length === 0) {
-    delete settings.hooks;
-  }
-  fs4.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
-  success("Removed uidex hook from .claude/settings.json");
-}
-function claudeInit() {
-  heading("uidex claude init");
-  addRules();
-  addSkill();
-  addHooks();
-  console.log("");
-  success("Claude Code integration ready");
-}
-function claudeTeardown() {
-  heading("uidex claude teardown");
-  removeRules();
-  removeSkill();
-  removeHooks();
-  console.log("");
-  success("Claude Code integration removed");
-}
-function printClaudeHelp() {
-  heading("uidex claude");
-  console.log("Manage Claude Code integration for uidex.\n");
-  console.log("Usage: uidex claude <command> [action]\n");
-  console.log("Commands:");
-  console.log("  init                Add rules, skill, and hooks");
-  console.log("  teardown            Remove rules, skill, and hooks");
-  console.log("  rules [add|remove]  Manage .claude/rules/uidex.md");
-  console.log("  skill [add|remove]  Manage .claude/commands/uidex-audit.md");
-  console.log("  hooks [add|remove]  Manage .claude/settings.json hook");
-  console.log("");
-}
-
-// scripts/cli.ts
-function printHelp() {
-  console.log(`
-${colors.bold}${colors.cyan}uidex${colors.reset}
-`);
-  console.log("Usage: uidex <command>\n");
-  console.log("Commands:");
-  console.log("  init              Initialize uidex in your project");
-  console.log("  scan              Run the component scanner");
-  console.log("  scan --check      Validate UIDEX_PAGE.md coverage");
-  console.log("  scaffold [dir]    Generate Playwright test stubs from pages/features");
-  console.log("  claude            Manage Claude Code integration");
-  console.log("");
-}
-function parseAction(raw) {
-  if (raw === void 0 || raw === "add") return "add";
-  if (raw === "remove") return "remove";
-  return null;
-}
-function handleClaude(args2) {
-  const subcommand = args2[0];
-  const action = parseAction(args2[1]);
-  if (action === null) {
-    console.error(`Unknown action: ${args2[1]}. Expected "add" or "remove".`);
-    process.exit(1);
-  }
-  switch (subcommand) {
-    case "init":
-      claudeInit();
-      break;
-    case "teardown":
-      claudeTeardown();
-      break;
-    case "rules":
-      action === "remove" ? removeRules() : addRules();
-      break;
-    case "skill":
-      action === "remove" ? removeSkill() : addSkill();
-      break;
-    case "hooks":
-      action === "remove" ? removeHooks() : addHooks();
-      break;
-    default:
-      printClaudeHelp();
-      break;
-  }
-}
-var args = process.argv.slice(2);
-var command = args[0];
-switch (command) {
-  case void 0:
-  case "init":
-    init().catch((err) => {
-      console.error("Error during initialization:", err);
-      process.exit(1);
-    });
-    break;
-  case "scan":
-    scan();
-    break;
-  case "scaffold":
-    scaffold(args[1]);
-    break;
-  case "claude":
-    handleClaude(args.slice(1));
-    break;
-  case "--help":
-  case "-h":
-    printHelp();
-    break;
-  default:
-    console.error(`Unknown command: ${command}`);
-    printHelp();
-    process.exit(1);
-}