@sightmap/react 0.7.1 → 0.8.0

package/dist/cli/index.js

@@ -1,1149 +0,0 @@
-#!/usr/bin/env node
-
-// src/cli/index.ts
-import { Command } from "commander";
-
-// src/cli/commands/gen.ts
-import { relative as relative3 } from "path";
-import { createTwoFilesPatch } from "diff";
-
-// src/plugin/orchestrator.ts
-import { promises as fs5 } from "fs";
-import { dirname as dirname3, join as join4 } from "path";
-
-// src/plugin/adapters/index.ts
-import { promises as fs3 } from "fs";
-import { join as join3 } from "path";
-
-// src/plugin/adapters/rr7-declarative.ts
-import { promises as fs, existsSync } from "fs";
-import { dirname, join, relative, resolve } from "path";
-import { parse as parseAst } from "@swc/core";
-
-// src/plugin/router-adapter.ts
-function deriveFeatureName(pattern) {
-  const segments = pattern.split("/").filter(Boolean);
-  for (const seg of segments) {
-    if (!seg.startsWith(":") && !seg.startsWith("*")) return sanitize(seg);
-  }
-  return "home";
-}
-function deriveViewName(pattern) {
-  const segments = pattern.split("/").filter(Boolean);
-  if (segments.length === 0) return "Home";
-  const last = segments[segments.length - 1];
-  const lastIsParam = last.startsWith(":");
-  const lastIsWildcard = last.startsWith("*");
-  if (lastIsParam || lastIsWildcard) {
-    const suffix = lastIsWildcard ? "Catchall" : "Detail";
-    for (let i = segments.length - 2; i >= 0; i--) {
-      const seg = segments[i];
-      if (!seg.startsWith(":") && !seg.startsWith("*")) {
-        return capitalize(sanitize(seg)) + suffix;
-      }
-    }
-    return suffix;
-  }
-  return capitalize(sanitize(last));
-}
-function sanitize(s) {
-  return s.replace(/[^a-zA-Z0-9_-]/g, "-").toLowerCase();
-}
-function capitalize(s) {
-  return s.charAt(0).toUpperCase() + s.slice(1);
-}
-
-// src/plugin/diagnostics.ts
-var REACT_DYNAMIC_DATA_SIGHTMAP = "react.dynamic-data-sightmap";
-var REACT_DYNAMIC_ROUTE_PATH = "react.dynamic-route-path";
-var REACT_NO_ROUTES_DISCOVERED = "react.no-routes-discovered";
-var REACT_UNKNOWN_ROUTER = "react.unknown-router";
-var REACT_ROUTE_NO_VIEW_IN_YAML = "react.route-no-view-in-yaml";
-var REACT_VIEW_ALREADY_DEFINED = "react.view-already-defined";
-var REACT_LIVE_ONLY_VIEW = "react.live-only-view";
-
-// src/plugin/adapters/rr7-declarative.ts
-var ENTRY_CANDIDATES = ["src/main.tsx", "src/main.ts", "src/main.jsx", "src/main.js"];
-function rr7DeclarativeAdapter() {
-  return {
-    name: "react-router-7-declarative",
-    detect(_projectRoot) {
-      return true;
-    },
-    async discoverRoutes(ctx) {
-      const entry = await findEntry(ctx.projectRoot);
-      if (!entry) return [];
-      const visited = /* @__PURE__ */ new Set();
-      const routePatterns = [];
-      const sourceFilesPerRoute = /* @__PURE__ */ new Map();
-      const pathsConfig = await loadPathsConfig(ctx.projectRoot);
-      await walkModule(entry, ctx, pathsConfig, visited, routePatterns, sourceFilesPerRoute);
-      return routePatterns.map((pattern) => ({
-        pattern,
-        featureName: deriveFeatureName(pattern),
-        sourceFiles: Array.from(sourceFilesPerRoute.get(pattern) ?? /* @__PURE__ */ new Set())
-      }));
-    }
-  };
-}
-async function findEntry(projectRoot) {
-  for (const candidate of ENTRY_CANDIDATES) {
-    const path = join(projectRoot, candidate);
-    try {
-      await fs.access(path);
-      return path;
-    } catch {
-    }
-  }
-  return null;
-}
-async function walkModule(file, ctx, pathsConfig, visited, routePatterns, sourceFilesPerRoute) {
-  if (visited.has(file)) return;
-  visited.add(file);
-  let source;
-  try {
-    source = await fs.readFile(file, "utf-8");
-  } catch {
-    return;
-  }
-  const ast = await parseAst(source, { syntax: "typescript", tsx: true, target: "es2022" });
-  const localImports = /* @__PURE__ */ new Map();
-  collectImports(ast, file, pathsConfig, localImports);
-  const routesFound = [];
-  collectRoutes(
-    ast,
-    (path, elementSpecs) => {
-      routesFound.push({ path, elementSpecs });
-    },
-    ctx.diagnostics ? (diag) => ctx.diagnostics.push(diag) : void 0,
-    file,
-    ctx.projectRoot
-  );
-  for (const { path, elementSpecs } of routesFound) {
-    routePatterns.push(path);
-    if (!sourceFilesPerRoute.has(path)) sourceFilesPerRoute.set(path, /* @__PURE__ */ new Set());
-    sourceFilesPerRoute.get(path).add(file);
-    const visitedForRoute = /* @__PURE__ */ new Set();
-    for (const spec of elementSpecs) {
-      const resolved = localImports.get(spec) ?? null;
-      if (resolved) {
-        await walkComponentTree(resolved, pathsConfig, sourceFilesPerRoute.get(path), visitedForRoute);
-      }
-    }
-  }
-  for (const target of localImports.values()) {
-    await walkModule(target, ctx, pathsConfig, visited, routePatterns, sourceFilesPerRoute);
-  }
-}
-async function walkComponentTree(file, pathsConfig, sourceFiles, visited) {
-  if (visited.has(file)) return;
-  visited.add(file);
-  sourceFiles.add(file);
-  let source;
-  try {
-    source = await fs.readFile(file, "utf-8");
-  } catch {
-    return;
-  }
-  const ast = await parseAst(source, { syntax: "typescript", tsx: true, target: "es2022" });
-  const localImports = /* @__PURE__ */ new Map();
-  collectImports(ast, file, pathsConfig, localImports);
-  for (const target of localImports.values()) {
-    await walkComponentTree(target, pathsConfig, sourceFiles, visited);
-  }
-}
-function collectImports(ast, fromFile, pathsConfig, into) {
-  for (const stmt of ast.body ?? []) {
-    if (stmt.type === "ImportDeclaration") {
-      const sourcePath = stmt.source?.value;
-      if (!sourcePath) continue;
-      const resolved = resolveImport(fromFile, sourcePath, pathsConfig);
-      if (!resolved) continue;
-      for (const spec of stmt.specifiers ?? []) {
-        const local = spec.local?.value;
-        if (typeof local === "string") into.set(local, resolved);
-      }
-      continue;
-    }
-    if (stmt.type === "VariableDeclaration") {
-      for (const decl of stmt.declarations ?? []) {
-        const local = decl.id?.value;
-        if (typeof local !== "string" || !decl.init) continue;
-        const dynamicSpec = findFirstDynamicImportSpec(decl.init);
-        if (!dynamicSpec) continue;
-        const resolved = resolveImport(fromFile, dynamicSpec, pathsConfig);
-        if (!resolved) continue;
-        into.set(local, resolved);
-      }
-    }
-  }
-}
-function resolveImport(fromFile, importSpec, pathsConfig) {
-  if (importSpec.startsWith(".")) {
-    return resolveLocalImport(fromFile, importSpec);
-  }
-  if (!pathsConfig) return null;
-  const candidates = expandAlias(importSpec, pathsConfig);
-  if (!candidates) return null;
-  for (const candidate of candidates) {
-    const stripped = candidate.replace(/\.(js|jsx|mjs)$/, "");
-    for (const ext of [".tsx", ".ts", ".jsx", ".js"]) {
-      const p = `${stripped}${ext}`;
-      if (existsSync(p)) return p;
-    }
-    for (const indexBase of ["index.tsx", "index.ts", "index.jsx", "index.js"]) {
-      const p = resolve(stripped, indexBase);
-      if (existsSync(p)) return p;
-    }
-    if (stripped !== candidate && existsSync(candidate)) return candidate;
-  }
-  return null;
-}
-function findFirstDynamicImportSpec(node) {
-  if (!node || typeof node !== "object") return null;
-  if (node.type === "CallExpression" && node.callee?.type === "Import" && Array.isArray(node.arguments) && node.arguments[0]?.expression?.type === "StringLiteral") {
-    return node.arguments[0].expression.value;
-  }
-  for (const key of Object.keys(node)) {
-    const v = node[key];
-    if (Array.isArray(v)) {
-      for (const c of v) {
-        const found = findFirstDynamicImportSpec(c);
-        if (found) return found;
-      }
-    } else if (v && typeof v === "object") {
-      const found = findFirstDynamicImportSpec(v);
-      if (found) return found;
-    }
-  }
-  return null;
-}
-function resolveLocalImport(fromFile, importSpec) {
-  const dir = dirname(fromFile);
-  const stripped = importSpec.replace(/\.(js|jsx|mjs)$/, "");
-  for (const ext of [".tsx", ".ts", ".jsx", ".js"]) {
-    const candidate = resolve(dir, `${stripped}${ext}`);
-    if (existsSync(candidate)) return candidate;
-  }
-  for (const indexBase of ["index.tsx", "index.ts", "index.jsx", "index.js"]) {
-    const candidate = resolve(dir, stripped, indexBase);
-    if (existsSync(candidate)) return candidate;
-  }
-  if (stripped !== importSpec) {
-    const original = resolve(dir, importSpec);
-    if (existsSync(original)) return original;
-  }
-  return null;
-}
-function collectRoutes(ast, onRoute, onDiagnostic, fromFile, projectRoot) {
-  function visit(node, parentPath) {
-    if (!node || typeof node !== "object") return;
-    let here = parentPath;
-    if (node.type === "JSXElement" && node.opening?.name?.value === "Route") {
-      let pathValue = null;
-      let pathAttrIsNonLiteral = false;
-      let outerElementName = null;
-      const elementSpecs = [];
-      for (const attr of node.opening.attributes ?? []) {
-        if (attr.type !== "JSXAttribute") continue;
-        if (attr.name?.value === "path") {
-          if (attr.value?.type === "StringLiteral") {
-            pathValue = attr.value.value;
-          } else if (attr.value) {
-            pathAttrIsNonLiteral = true;
-          }
-        }
-        if (attr.name?.value === "element" && attr.value?.type === "JSXExpressionContainer") {
-          const inner = attr.value.expression;
-          if (inner?.type === "JSXElement") {
-            collectJsxElementNames(inner, elementSpecs);
-            outerElementName = inner.opening?.name?.value ?? null;
-          }
-        }
-        if (attr.name?.value === "Component" && attr.value?.type === "JSXExpressionContainer") {
-          const inner = attr.value.expression;
-          if (inner?.type === "Identifier" && typeof inner.value === "string") {
-            elementSpecs.push(inner.value);
-          }
-        }
-      }
-      if (pathValue) {
-        const joined = pathValue.startsWith("/") ? pathValue : `${parentPath.replace(/\/$/, "")}/${pathValue}`;
-        if (outerElementName !== "Navigate") {
-          onRoute(joined, elementSpecs);
-        }
-        here = joined;
-      } else if (pathAttrIsNonLiteral && onDiagnostic) {
-        const where = fromFile && projectRoot ? relative(projectRoot, fromFile) : fromFile ?? "<unknown>";
-        onDiagnostic({
-          severity: "info",
-          code: REACT_DYNAMIC_ROUTE_PATH,
-          message: `Route in ${where} uses a non-literal \`path\` (template literal / identifier / expression). Static AST discovery cannot resolve dynamic paths; hand-author this view in a feature YAML or refactor to a literal string.`
-        });
-      }
-    }
-    for (const key of Object.keys(node)) {
-      const v = node[key];
-      if (Array.isArray(v)) v.forEach((c) => visit(c, here));
-      else if (v && typeof v === "object") visit(v, here);
-    }
-  }
-  visit(ast, "");
-}
-function collectJsxElementNames(node, into) {
-  if (!node || typeof node !== "object") return;
-  if (node.type === "JSXElement") {
-    const name = node.opening?.name?.value;
-    if (typeof name === "string") into.push(name);
-  }
-  for (const key of Object.keys(node)) {
-    const v = node[key];
-    if (Array.isArray(v)) v.forEach((c) => collectJsxElementNames(c, into));
-    else if (v && typeof v === "object") collectJsxElementNames(v, into);
-  }
-}
-async function loadPathsConfig(projectRoot) {
-  const merged = {};
-  let baseUrl = null;
-  for (const name of ["tsconfig.json", "tsconfig.app.json"]) {
-    const fp = join(projectRoot, name);
-    let raw;
-    try {
-      raw = await fs.readFile(fp, "utf-8");
-    } catch {
-      continue;
-    }
-    const json = parseTsconfigJson(raw);
-    const co = json?.compilerOptions;
-    if (!co) continue;
-    if (!baseUrl && typeof co.baseUrl === "string") {
-      baseUrl = resolve(dirname(fp), co.baseUrl);
-    }
-    if (co.paths && typeof co.paths === "object") {
-      for (const [k, v] of Object.entries(co.paths)) {
-        if (Array.isArray(v)) merged[k] = v;
-      }
-    }
-  }
-  if (Object.keys(merged).length === 0) return null;
-  return { baseUrl: baseUrl ?? projectRoot, paths: merged };
-}
-function parseTsconfigJson(raw) {
-  const stripped = raw.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1").replace(/,(\s*[}\]])/g, "$1");
-  try {
-    return JSON.parse(stripped);
-  } catch {
-    return null;
-  }
-}
-function expandAlias(importSpec, cfg) {
-  for (const [alias, targets] of Object.entries(cfg.paths)) {
-    if (alias.endsWith("/*")) {
-      const prefix = alias.slice(0, -1);
-      if (importSpec.startsWith(prefix)) {
-        const rest = importSpec.slice(prefix.length);
-        return targets.map((t) => {
-          const tnorm = t.endsWith("/*") ? t.slice(0, -2) : t;
-          return resolve(cfg.baseUrl, tnorm, rest);
-        });
-      }
-    } else if (importSpec === alias) {
-      return targets.map((t) => resolve(cfg.baseUrl, t));
-    }
-  }
-  return null;
-}
-
-// src/plugin/adapters/rr7-framework.ts
-import { promises as fs2, existsSync as existsSync2 } from "fs";
-import { dirname as dirname2, join as join2, resolve as resolve2 } from "path";
-import { parse as parseAst2 } from "@swc/core";
-var ROUTES_CONFIG_CANDIDATES = [
-  "app/routes.ts",
-  "app/routes.tsx",
-  "app/routes.js",
-  "app/routes.jsx"
-];
-var APP_DIR = "app";
-function rr7FrameworkAdapter() {
-  return {
-    name: "react-router-7-framework",
-    detect(projectRoot) {
-      return findRoutesConfigSync(projectRoot) !== null;
-    },
-    async discoverRoutes(ctx) {
-      const routesFile = await findRoutesConfig(ctx.projectRoot);
-      if (!routesFile) return [];
-      const appDir = join2(ctx.projectRoot, APP_DIR);
-      const source = await fs2.readFile(routesFile, "utf-8");
-      const ast = await parseAst2(source, { syntax: "typescript", tsx: true, target: "es2022" });
-      const defaultArray = findDefaultExportArray(ast);
-      if (!defaultArray) return [];
-      const collected = [];
-      await walkRouteArray(defaultArray, { parentPattern: "", inheritedFiles: /* @__PURE__ */ new Set() }, appDir, collected);
-      return collected.map(({ pattern, sourceFiles }) => ({
-        pattern,
-        featureName: deriveFeatureName(pattern),
-        sourceFiles: Array.from(sourceFiles)
-      }));
-    }
-  };
-}
-function findRoutesConfigSync(projectRoot) {
-  for (const candidate of ROUTES_CONFIG_CANDIDATES) {
-    const path = join2(projectRoot, candidate);
-    if (existsSync2(path)) return path;
-  }
-  return null;
-}
-async function findRoutesConfig(projectRoot) {
-  for (const candidate of ROUTES_CONFIG_CANDIDATES) {
-    const path = join2(projectRoot, candidate);
-    try {
-      await fs2.access(path);
-      return path;
-    } catch {
-    }
-  }
-  return null;
-}
-function findDefaultExportArray(ast) {
-  for (const stmt of ast.body ?? []) {
-    if (stmt.type === "ExportDefaultExpression") {
-      return unwrapArray(stmt.expression);
-    }
-    if (stmt.type === "ExportDefaultDeclaration") {
-      const decl = stmt.decl ?? stmt.declaration;
-      if (decl) return unwrapArray(decl);
-    }
-  }
-  return null;
-}
-function unwrapArray(node) {
-  if (!node) return null;
-  if (node.type === "ArrayExpression") return node;
-  if (node.type === "TsSatisfiesExpression" || node.type === "TsAsExpression" || node.type === "TsTypeAssertion") {
-    return unwrapArray(node.expression);
-  }
-  if (node.type === "ParenthesisExpression") return unwrapArray(node.expression);
-  return null;
-}
-async function walkRouteArray(arrayNode, frame, appDir, out) {
-  for (const elem of arrayNode.elements ?? []) {
-    if (!elem) continue;
-    const expr = elem.expression ?? elem;
-    const isSpread = !!elem.spread;
-    if (isSpread) {
-      if (expr?.type === "CallExpression" && callName(expr) === "prefix") {
-        const args = expr.arguments ?? [];
-        const prefixArg = stringArg(args[0]);
-        const childrenArr = arrayArg(args[1]);
-        if (prefixArg !== null && childrenArr) {
-          const childFrame = {
-            parentPattern: joinPath(frame.parentPattern, prefixArg),
-            inheritedFiles: frame.inheritedFiles
-          };
-          await walkRouteArray(childrenArr, childFrame, appDir, out);
-        }
-      }
-      continue;
-    }
-    if (expr?.type !== "CallExpression") continue;
-    await processRouteCall(expr, frame, appDir, out);
-  }
-}
-async function processRouteCall(call, frame, appDir, out) {
-  const name = callName(call);
-  const args = call.arguments ?? [];
-  if (name === "route") {
-    const pathArg = stringArg(args[0]);
-    const fileArg = stringArg(args[1]);
-    if (pathArg === null || fileArg === null) return;
-    const pattern = joinPath(frame.parentPattern, pathArg);
-    const sourceFiles = new Set(frame.inheritedFiles);
-    const resolvedFile = resolveAppFile(appDir, fileArg);
-    if (resolvedFile) await walkComponentTree2(resolvedFile, sourceFiles, /* @__PURE__ */ new Set());
-    out.push({ pattern, sourceFiles });
-    const childrenArr = arrayArg(args[2]);
-    if (childrenArr) {
-      const childFrame = {
-        parentPattern: pattern,
-        inheritedFiles: union(frame.inheritedFiles, sourceFiles)
-      };
-      await walkRouteArray(childrenArr, childFrame, appDir, out);
-    }
-    return;
-  }
-  if (name === "index") {
-    const fileArg = stringArg(args[0]);
-    if (fileArg === null) return;
-    const pattern = frame.parentPattern || "/";
-    const sourceFiles = new Set(frame.inheritedFiles);
-    const resolvedFile = resolveAppFile(appDir, fileArg);
-    if (resolvedFile) await walkComponentTree2(resolvedFile, sourceFiles, /* @__PURE__ */ new Set());
-    out.push({ pattern, sourceFiles });
-    return;
-  }
-  if (name === "layout") {
-    const fileArg = stringArg(args[0]);
-    const childrenArr = arrayArg(args[1]);
-    if (fileArg === null || !childrenArr) return;
-    const layoutFiles = /* @__PURE__ */ new Set();
-    const resolvedFile = resolveAppFile(appDir, fileArg);
-    if (resolvedFile) await walkComponentTree2(resolvedFile, layoutFiles, /* @__PURE__ */ new Set());
-    const childFrame = {
-      parentPattern: frame.parentPattern,
-      inheritedFiles: union(frame.inheritedFiles, layoutFiles)
-    };
-    await walkRouteArray(childrenArr, childFrame, appDir, out);
-    return;
-  }
-}
-function callName(call) {
-  const callee = call?.callee;
-  if (!callee) return null;
-  if (callee.type === "Identifier") return callee.value ?? null;
-  return null;
-}
-function stringArg(arg) {
-  const expr = arg?.expression ?? arg;
-  if (expr?.type === "StringLiteral") return expr.value ?? null;
-  return null;
-}
-function arrayArg(arg) {
-  const expr = arg?.expression ?? arg;
-  if (expr?.type === "ArrayExpression") return expr;
-  return null;
-}
-function joinPath(parent, child) {
-  if (child.startsWith("/")) return child;
-  if (!child) return parent || "/";
-  const base = (parent || "").replace(/\/+$/, "");
-  const tail = child.replace(/^\/+/, "");
-  return base === "" ? `/${tail}` : `${base}/${tail}`;
-}
-function resolveAppFile(appDir, fileSpec) {
-  const base = resolve2(appDir, fileSpec);
-  if (existsSync2(base)) return base;
-  const stripped = base.replace(/\.(js|jsx|mjs)$/, "");
-  for (const ext of [".tsx", ".ts", ".jsx", ".js"]) {
-    const candidate = `${stripped}${ext}`;
-    if (existsSync2(candidate)) return candidate;
-  }
-  return null;
-}
-function union(a, b) {
-  const out = new Set(a);
-  for (const v of b) out.add(v);
-  return out;
-}
-async function walkComponentTree2(file, sourceFiles, visited) {
-  if (visited.has(file)) return;
-  visited.add(file);
-  sourceFiles.add(file);
-  let source;
-  try {
-    source = await fs2.readFile(file, "utf-8");
-  } catch {
-    return;
-  }
-  const ast = await parseAst2(source, { syntax: "typescript", tsx: true, target: "es2022" });
-  for (const stmt of ast.body ?? []) {
-    if (stmt.type !== "ImportDeclaration") continue;
-    const sourcePath = stmt.source?.value;
-    if (!sourcePath || !sourcePath.startsWith(".")) continue;
-    const resolved = resolveLocalImport2(file, sourcePath);
-    if (!resolved) continue;
-    await walkComponentTree2(resolved, sourceFiles, visited);
-  }
-}
-function resolveLocalImport2(fromFile, importSpec) {
-  const dir = dirname2(fromFile);
-  const stripped = importSpec.replace(/\.(js|jsx|mjs)$/, "");
-  for (const ext of [".tsx", ".ts", ".jsx", ".js"]) {
-    const candidate = resolve2(dir, `${stripped}${ext}`);
-    if (existsSync2(candidate)) return candidate;
-  }
-  if (stripped !== importSpec) {
-    const original = resolve2(dir, importSpec);
-    if (existsSync2(original)) return original;
-  }
-  return null;
-}
-
-// src/plugin/adapters/index.ts
-async function resolveAdapter(choice, projectRoot) {
-  if (typeof choice === "string") {
-    if (choice === "react-router-7") return rr7DeclarativeAdapter();
-    if (choice === "react-router-7-framework") return rr7FrameworkAdapter();
-    if (choice === "auto") {
-      if (projectRoot) {
-        const framework = rr7FrameworkAdapter();
-        if (framework.detect(projectRoot)) return framework;
-      }
-      const pkg = await readPackageJson(projectRoot);
-      if (pkg?.dependencies?.["react-router"] || pkg?.devDependencies?.["react-router"]) {
-        return rr7DeclarativeAdapter();
-      }
-      return null;
-    }
-  }
-  return choice;
-}
-async function readPackageJson(projectRoot) {
-  if (!projectRoot) return null;
-  try {
-    const raw = await fs3.readFile(join3(projectRoot, "package.json"), "utf-8");
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
-}
-
-// src/plugin/ast/scan.ts
-import { promises as fs4 } from "fs";
-import { parse } from "@swc/core";
-async function scanFile(file) {
-  const source = await fs4.readFile(file, "utf-8");
-  const ast = await parse(source, {
-    syntax: "typescript",
-    tsx: true,
-    target: "es2022"
-  });
-  const findings = [];
-  const diagnostics = [];
-  walk(ast, (node) => {
-    if (node?.type === "JSXOpeningElement" && Array.isArray(node.attributes)) {
-      for (const attr of node.attributes) {
-        if (attr?.type !== "JSXAttribute") continue;
-        const nameNode = attr.name;
-        if (!nameNode || nameNode.value !== "data-sightmap") continue;
-        const valueNode = attr.value;
-        if (valueNode?.type === "StringLiteral") {
-          findings.push({
-            name: valueNode.value,
-            file,
-            line: attr.span?.start ?? 0,
-            // SWC byte offset — converted to line in caller if needed
-            col: 0
-          });
-        } else if (valueNode?.type === "JSXExpressionContainer") {
-          diagnostics.push({
-            severity: "warning",
-            code: REACT_DYNAMIC_DATA_SIGHTMAP,
-            message: `data-sightmap value must be a static string. Skipping.
-  Consider one of:
-  - Split into separate components with static markers (e.g. LoginForm + SignupForm)
-  - Use a static marker on the parent and target via descendant selector:
-      [data-sightmap="LoginPage"] form
-  - If you genuinely need dynamic markers, hand-author the entries in extras.yaml`,
-            file
-          });
-        }
-      }
-    }
-  });
-  return { findings, diagnostics };
-}
-function walk(node, visit) {
-  if (!node || typeof node !== "object") return;
-  visit(node);
-  for (const key of Object.keys(node)) {
-    const v = node[key];
-    if (Array.isArray(v)) v.forEach((c) => walk(c, visit));
-    else if (v && typeof v === "object") walk(v, visit);
-  }
-}
-
-// src/plugin/merge/smart-merge.ts
-import { Document, parseDocument, isMap, isSeq, YAMLMap, YAMLSeq, Scalar } from "yaml";
-
-// src/plugin/merge/todo-scaffolding.ts
-var SCAFFOLDING = `#
-# Agent-authored fields below \u2014 uncomment and fill in.
-#
-# TODO: capture observed runtime behavior the agent should know about
-#       (one short sentence per entry; no marketing copy).
-# memory:
-#   - "Form auto-submits on Enter; verify disabled-button logic."
-#   - "Submit returns 401 on bad credentials."
-#
-# TODO: describe what this view is for in one sentence.
-# intent: "Authenticate the user before entering the dashboard."
-#
-# TODO: list HTTP requests this view fires (method + path).
-# requests:
-#   - method: POST
-#     path: /api/login
-#
-`;
-function renderTodoScaffolding() {
-  return SCAFFOLDING;
-}
-
-// src/plugin/merge/smart-merge.ts
-var HEADER = `# This file is co-maintained by @sightmap/react and your agent.
-# Plugin updates: name, route, selector, children.
-# Agent curates: memory, intent, requests, and any unknown fields.
-# See https://sightmap.org/react for the full convention.
-`;
-function smartMerge(input) {
-  const { existing, desired } = input;
-  const isNew = existing == null;
-  const doc = isNew ? new Document({ version: 1, views: [] }) : parseDocument(existing);
-  ensureScalar(doc, "version", 1);
-  const viewsSeq = ensureSeq(doc, "views");
-  reconcileView(viewsSeq, desired);
-  let yaml = doc.toString();
-  if (isNew) {
-    yaml = HEADER + yaml;
-    if (!yaml.endsWith("\n")) yaml += "\n";
-    yaml += "\n";
-    yaml += renderTodoScaffolding();
-  }
-  const changed = isNew || normalize(yaml) !== normalize(existing);
-  return { changed, yaml };
-}
-function ensureScalar(doc, key, value) {
-  doc.set(key, value);
-}
-function ensureSeq(doc, key) {
-  const node = doc.get(key, true);
-  if (node && isSeq(node)) return node;
-  const seq = new YAMLSeq();
-  doc.set(key, seq);
-  return seq;
-}
-function reconcileView(viewsSeq, desired) {
-  const { view, components } = desired;
-  let existingView = null;
-  let matchedBy = null;
-  for (const item of viewsSeq.items) {
-    if (isMap(item) && getString(item, "name") === view.name) {
-      existingView = item;
-      matchedBy = "name";
-      break;
-    }
-  }
-  if (!existingView) {
-    for (const item of viewsSeq.items) {
-      if (isMap(item) && getString(item, "route") === view.route) {
-        existingView = item;
-        matchedBy = "route";
-        break;
-      }
-    }
-  }
-  if (!existingView) {
-    existingView = new YAMLMap();
-    viewsSeq.add(existingView);
-  }
-  if (matchedBy !== "route") setMapEntry(existingView, "name", view.name);
-  setMapEntry(existingView, "route", view.route);
-  let componentsSeq = existingView.get("components", true);
-  if (!componentsSeq || !isSeq(componentsSeq)) {
-    componentsSeq = new YAMLSeq();
-    existingView.set("components", componentsSeq);
-  }
-  reconcileComponents(componentsSeq, components);
-}
-function reconcileComponents(seq, desired) {
-  for (const desiredComp of desired) {
-    let existing = null;
-    for (const item of seq.items) {
-      if (isMap(item) && getString(item, "name") === desiredComp.name) {
-        existing = item;
-        break;
-      }
-    }
-    if (!existing) {
-      existing = new YAMLMap();
-      seq.add(existing);
-    }
-    setMapEntry(existing, "name", desiredComp.name);
-    setMapEntry(existing, "selector", desiredComp.selector);
-    if (desiredComp.children && desiredComp.children.length > 0) {
-      let childSeq = existing.get("children", true);
-      if (!childSeq || !isSeq(childSeq)) {
-        childSeq = new YAMLSeq();
-        existing.set("children", childSeq);
-      }
-      reconcileComponents(childSeq, desiredComp.children);
-    }
-  }
-}
-function getString(map, key) {
-  const v = map.get(key, true);
-  if (v instanceof Scalar && typeof v.value === "string") return v.value;
-  return null;
-}
-function setMapEntry(map, key, value) {
-  map.set(key, value);
-}
-function normalize(s) {
-  return s.replace(/\s+$/, "");
-}
-
-// src/plugin/orchestrator.ts
-import { loadDirectory, canonicalize } from "@sightmap/sightmap";
-async function runOnce(opts) {
-  const adapter = await resolveAdapter(opts.router, opts.projectRoot);
-  if (!adapter) {
-    return {
-      written: [],
-      changes: [],
-      diagnostics: [
-        {
-          severity: "warning",
-          code: REACT_UNKNOWN_ROUTER,
-          message: `No supported router detected at ${opts.projectRoot}. Skipping sightmap generation.`
-        }
-      ]
-    };
-  }
-  const sightmapDir = join4(opts.projectRoot, opts.outputDir);
-  if (!opts.dryRun) await fs5.mkdir(sightmapDir, { recursive: true });
-  let existingViewNames = /* @__PURE__ */ new Set();
-  let existingViewRoutes = /* @__PURE__ */ new Set();
-  try {
-    const existing = await loadDirectory(sightmapDir);
-    for (const v of existing.views ?? []) {
-      existingViewNames.add(v.name);
-      existingViewRoutes.add(v.route);
-    }
-  } catch {
-  }
-  const written = [];
-  const changes = [];
-  const allDiagnostics = [];
-  const routes = await adapter.discoverRoutes({
-    projectRoot: opts.projectRoot,
-    resolveSource: (id) => join4(opts.projectRoot, id),
-    diagnostics: allDiagnostics
-  });
-  if (routes.length === 0) {
-    allDiagnostics.push({
-      severity: "warning",
-      code: REACT_NO_ROUTES_DISCOVERED,
-      message: `No routes discovered by the ${adapter.name} adapter. Common causes: the entry file isn't where the adapter looks (declarative: \`src/main.{tsx,ts,jsx,js}\`; framework: \`app/routes.ts\`); the project uses RR7 data-mode (\`createBrowserRouter\`), not yet supported; the framework project uses \`flatRoutes()\` filesystem routing, not yet supported; the entry imports the app via a path alias defined outside tsconfig (e.g. only in \`vite.config.ts\`) so the adapter can't resolve it; or no \`<Routes>\` JSX / programmatic \`route(...)\` config is reachable from the entry. If your routes are real, surface them via \`sightmap-react gen --live <url>\`.`
-    });
-  }
-  const componentsByRoute = /* @__PURE__ */ new Map();
-  const componentRouteCount = /* @__PURE__ */ new Map();
-  for (const route of routes) {
-    const findings = await collectFindings(route.sourceFiles, allDiagnostics);
-    componentsByRoute.set(route.pattern, findings.map(toComponent));
-    for (const f of findings) {
-      if (!componentRouteCount.has(f.name)) componentRouteCount.set(f.name, /* @__PURE__ */ new Set());
-      componentRouteCount.get(f.name).add(route.pattern);
-    }
-  }
-  const sharedComponents = [];
-  for (const [name, routesFor] of componentRouteCount) {
-    if (routesFor.size > 1) {
-      sharedComponents.push({
-        name,
-        selector: `[data-sightmap="${name}"]`
-      });
-      for (const r of routesFor) {
-        const list = componentsByRoute.get(r) ?? [];
-        const filtered = list.filter((c) => c.name !== name);
-        componentsByRoute.set(r, filtered);
-      }
-    }
-  }
-  const byFeature = /* @__PURE__ */ new Map();
-  for (const r of routes) {
-    if (!byFeature.has(r.featureName)) byFeature.set(r.featureName, []);
-    byFeature.get(r.featureName).push(r);
-  }
-  for (const [featureName, featureRoutes] of byFeature) {
-    const filePath = join4(sightmapDir, `${featureName}.yaml`);
-    const targetFileExists = await fs5.access(filePath).then(() => true).catch(() => false);
-    const before = await readIfExists(filePath);
-    let currentYaml = before;
-    let anyChanged = false;
-    let emittedAnyView = false;
-    for (const route of featureRoutes) {
-      const viewName = deriveViewName(route.pattern);
-      const components = componentsByRoute.get(route.pattern) ?? [];
-      const isAlreadyDefinedElsewhere = !targetFileExists && (existingViewNames.has(viewName) || existingViewRoutes.has(route.pattern));
-      if (isAlreadyDefinedElsewhere) {
-        allDiagnostics.push({
-          severity: "info",
-          code: REACT_VIEW_ALREADY_DEFINED,
-          message: `Route ${route.pattern} (view "${viewName}") is already defined in an existing YAML file outside the per-feature convention. Skipping stub emission. To migrate to the per-feature layout, move the view definition to ${featureName}.yaml.`
-        });
-        continue;
-      }
-      const merged = smartMerge({
-        existing: currentYaml,
-        desired: {
-          view: { name: viewName, route: route.pattern },
-          components
-        }
-      });
-      currentYaml = merged.yaml;
-      if (merged.changed) anyChanged = true;
-      emittedAnyView = true;
-    }
-    if (emittedAnyView && currentYaml !== null) {
-      const finalYaml = toCanonical(currentYaml, filePath);
-      const changed = anyChanged || finalYaml !== before;
-      changes.push({ path: filePath, before, after: finalYaml, changed });
-      if (changed && !opts.dryRun) {
-        await atomicWrite(filePath, finalYaml);
-        written.push(filePath);
-      }
-    }
-  }
-  if (sharedComponents.length > 0) {
-    const filePath = join4(sightmapDir, opts.sharedFile);
-    const existing = await readIfExists(filePath);
-    const merged = smartMerge({
-      existing,
-      desired: {
-        view: { name: "Shared", route: "/**" },
-        // sentinel — `Shared` is global, route matches any
-        components: sharedComponents
-      }
-    });
-    const finalYaml = toCanonical(merged.yaml, filePath);
-    const changed = merged.changed || finalYaml !== existing;
-    changes.push({ path: filePath, before: existing, after: finalYaml, changed });
-    if (changed && !opts.dryRun) {
-      await atomicWrite(filePath, finalYaml);
-      written.push(filePath);
-    }
-  }
-  if (opts.liveSightmap?.views?.length) {
-    const staticViewNames = /* @__PURE__ */ new Set();
-    const staticViewRoutes = /* @__PURE__ */ new Set();
-    for (const r of routes) staticViewNames.add(deriveViewName(r.pattern));
-    for (const n of existingViewNames) staticViewNames.add(n);
-    for (const rt of existingViewRoutes) staticViewRoutes.add(rt);
-    for (const c of changes) {
-      for (const m of c.after.matchAll(/^\s*-\s+name:\s*(\S+)/gm)) {
-        staticViewNames.add(m[1]);
-      }
-    }
-    for (const liveView of opts.liveSightmap.views) {
-      if (!liveView || typeof liveView.name !== "string") continue;
-      if (staticViewNames.has(liveView.name) || staticViewRoutes.has(liveView.route)) continue;
-      const safeFile = liveView.name.toLowerCase().replace(/[^a-z0-9-_]/g, "-");
-      allDiagnostics.push({
-        severity: "info",
-        code: REACT_LIVE_ONLY_VIEW,
-        message: `View "${liveView.name}" (route ${liveView.route}) appeared at runtime but was not discovered by the static AST scan. Add a data-sightmap attribute or hand-author a .sightmap/${safeFile}.yaml file.`
-      });
-    }
-  }
-  return { written, changes, diagnostics: allDiagnostics };
-}
-async function collectFindings(files, diagnostics) {
-  const out = [];
-  for (const f of files) {
-    const result = await scanFile(f);
-    out.push(...result.findings);
-    diagnostics.push(...result.diagnostics);
-  }
-  return out;
-}
-function toComponent(f) {
-  return { name: f.name, selector: `[data-sightmap="${f.name}"]` };
-}
-async function readIfExists(path) {
-  try {
-    return await fs5.readFile(path, "utf-8");
-  } catch (e) {
-    if (e.code === "ENOENT") return null;
-    throw e;
-  }
-}
-function toCanonical(yaml, file) {
-  const c = canonicalize(yaml, { file });
-  return c.kind === "canonical" ? c.text : yaml;
-}
-async function atomicWrite(path, contents) {
-  await fs5.mkdir(dirname3(path), { recursive: true });
-  const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
-  await fs5.writeFile(tmp, contents, "utf-8");
-  await fs5.rename(tmp, path);
-}
-
-// src/cli/commands/gen-summary.ts
-import { relative as relative2 } from "path";
-import { parse as yamlParse } from "yaml";
-var AUDIT_HINT = "Run /sightmap:audit (Claude Code plugin) to surface missing memory and broken selectors.";
-function formatSummary(input) {
-  const { cwd, changes, written } = input;
-  const allChanged = changes.filter((c) => c.changed);
-  const anyChanged = allChanged.length > 0;
-  const everyChangeIsNew = changes.length > 0 && changes.every((c) => c.before === null);
-  if (!anyChanged) {
-    return { kind: "up-to-date", lines: ["sightmap: up to date"] };
-  }
-  if (everyChangeIsNew) {
-    return formatFirstRun(input);
-  }
-  const lines = [];
-  lines.push(`sightmap: wrote ${written.length} file(s):`);
-  for (const c of allChanged) {
-    lines.push(`  - ${relative2(cwd, c.path)}`);
-  }
-  return { kind: "structural-update", lines };
-}
-function formatFirstRun(input) {
-  const { cwd, changes, written } = input;
-  const lines = [];
-  let viewCount = 0;
-  let componentCount = 0;
-  const viewNames = [];
-  for (const c of changes) {
-    try {
-      const parsed = yamlParse(c.after);
-      const views = parsed?.views ?? [];
-      for (const v of views) {
-        viewCount++;
-        if (typeof v.name === "string") viewNames.push(v.name);
-        const comps = Array.isArray(v.components) ? v.components : [];
-        componentCount += comps.length;
-      }
-    } catch {
-    }
-  }
-  const sortedForEdit = [...changes].sort(
-    (a, b) => relative2(cwd, a.path).localeCompare(relative2(cwd, b.path))
-  );
-  lines.push(`sightmap: wrote ${written.length} file(s) (first run on empty .sightmap/)`);
-  lines.push("");
-  lines.push(`Views (${viewCount} total)`);
-  lines.push(`  views: ${viewNames.join(", ")}`);
-  lines.push(`Components linked: ${componentCount}`);
-  lines.push("");
-  lines.push("Next steps \u2014 open these files and replace the TODO blocks with real values:");
-  const editTargets = sortedForEdit.filter((c) => !c.path.endsWith("shared.yaml"));
-  for (const c of editTargets) {
-    lines.push(`  - ${relative2(cwd, c.path)}`);
-  }
-  lines.push("");
-  lines.push(AUDIT_HINT);
-  return { kind: "first-run", lines };
-}
-
-// src/cli/commands/gen.ts
-async function genCommand(opts) {
-  const dryRun = !!(opts.check || opts.diff);
-  let liveSightmap;
-  if (opts.live) {
-    try {
-      const res = await fetch(opts.live);
-      if (!res.ok) {
-        console.error(
-          `sightmap: --live fetch failed with HTTP ${res.status}; continuing without live snapshot`
-        );
-      } else {
-        liveSightmap = await res.json();
-      }
-    } catch (err) {
-      console.error(
-        `sightmap: --live fetch failed (${err.message}); continuing without live snapshot`
-      );
-    }
-  }
-  const result = await runOnce({
-    projectRoot: opts.cwd,
-    router: opts.router,
-    outputDir: opts.output,
-    sharedFile: "shared.yaml",
-    prune: "warn",
-    dryRun,
-    ...liveSightmap ? { liveSightmap } : {}
-  });
-  const wouldChange = result.changes.filter((c) => c.changed);
-  if (opts.diff) {
-    for (const c of wouldChange) {
-      const rel = relative3(opts.cwd, c.path);
-      const oldName = c.before == null ? "/dev/null" : `a/${rel}`;
-      const newName = `b/${rel}`;
-      const patch = createTwoFilesPatch(oldName, newName, c.before ?? "", c.after);
-      process.stdout.write(patch);
-    }
-  }
-  if (opts.check) {
-    if (wouldChange.length > 0) {
-      console.error(
-        `sightmap: ${wouldChange.length} file(s) would change. Run \`sightmap-react gen\` to update.`
-      );
-      for (const c of wouldChange) console.error(`  - ${relative3(opts.cwd, c.path)}`);
-      reportDiagnostics(result.diagnostics);
-      process.exit(1);
-    }
-    console.log("sightmap: up to date");
-  } else if (opts.diff) {
-    if (wouldChange.length === 0) console.log("sightmap: no changes");
-  } else {
-    const summary = formatSummary({
-      cwd: opts.cwd,
-      changes: result.changes,
-      written: result.written
-    });
-    for (const line of summary.lines) console.log(line);
-  }
-  if (reportDiagnostics(result.diagnostics)) process.exit(1);
-}
-function reportDiagnostics(diagnostics) {
-  let hadError = false;
-  for (const d of diagnostics) {
-    const tag = d.severity.toUpperCase();
-    const loc = [d.file, d.path].filter(Boolean).join(" :: ");
-    console.error(`[${tag}] ${d.code}: ${d.message}${loc ? ` (${loc})` : ""}`);
-    if (d.severity === "error") hadError = true;
-  }
-  return hadError;
-}
-
-// src/cli/commands/validate.ts
-import { join as join5 } from "path";
-import { loadDirectory as loadDirectory2 } from "@sightmap/sightmap";
-async function validateCommand(opts) {
-  const dir = join5(opts.cwd, opts.output);
-  const sightmap = await loadDirectory2(dir);
-  let exitCode = 0;
-  for (const diag of sightmap.diagnostics) {
-    if (diag.severity === "error") {
-      console.error(`[ERROR] ${diag.code}: ${diag.message}${diag.path ? ` (${diag.path})` : ""}`);
-      exitCode = 1;
-    }
-  }
-  const adapter = await resolveAdapter(opts.router, opts.cwd);
-  if (!adapter) {
-    console.error(`[ERROR] react.unknown-router: No supported router detected at ${opts.cwd}. Cannot validate.`);
-    process.exit(1);
-  }
-  const routes = await adapter.discoverRoutes({
-    projectRoot: opts.cwd,
-    resolveSource: (id) => join5(opts.cwd, id)
-  });
-  const viewRoutes = /* @__PURE__ */ new Set();
-  for (const v of sightmap.views ?? []) viewRoutes.add(v.route);
-  for (const r of routes) {
-    if (!viewRoutes.has(r.pattern)) {
-      console.error(`[WARNING] ${REACT_ROUTE_NO_VIEW_IN_YAML}: route ${r.pattern} exists in router but no view in YAML`);
-    }
-  }
-  if (exitCode !== 0) process.exit(exitCode);
-}
-
-// src/cli/index.ts
-var program = new Command().name("sightmap-react").description("CLI for @sightmap/react: regenerate, validate, and inspect React sightmaps offline.").version("0.1.0");
-program.command("gen").description("Run the build pipeline once and write any changed feature files.").option("--cwd <path>", "project root", process.cwd()).option("--router <name>", "router adapter", "react-router-7").option("--output <dir>", "output dir", ".sightmap").option("--check", "dry-run; exit 1 if any .sightmap file would change").option("--diff", "dry-run; print unified diff of would-be changes to stdout").option(
-  "--live <url>",
-  "ALSO fetch a runtime sightmap from a running dev server at <url> (e.g. http://localhost:5173/__sightmap__/sightmap.json) and surface live-only views as info diagnostics. Optional; when omitted, only static AST discovery runs."
-).action(genCommand);
-program.command("validate").description("Validate the .sightmap/ directory; surface React-specific drift diagnostics.").option("--cwd <path>", "project root", process.cwd()).option("--output <dir>", "output dir", ".sightmap").option("--router <name>", "router adapter (used for drift checks)", "react-router-7").action(validateCommand);
-program.parseAsync(process.argv).catch((err) => {
-  console.error(err);
-  process.exit(1);
-});
-//# sourceMappingURL=index.js.map