snoop-ui 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Snoop UI Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+<div align=center>
+<img width="763" height="237" alt="snoop_banner" src="https://github.com/user-attachments/assets/d15a6912-95fe-44d7-98e9-079a25636374" />
+</div>
+<br>
+
+**Swagger UI for your React components.** Install it, open `/ui`, and see what
+you shipped and what is wrong with it.
+
+Snoop is a local, no-AI inspector for React apps. It scans a project, lists every
+component with its real geometry and style sources, flags style problems with
+deterministic rules, and serves the result from a Vite dev plugin.
+
+> **Status: pre-release, M4 style provenance.** The package is not
+> installable yet. The scanner discovers exported components and writes a
+> deterministic manifest, `snoop init` / `snoop scan` work from the repository,
+> and the Vite plugin serves the read-only dashboard at `/ui` with a live
+> manifest API and WebSocket bridge. The runtime agent measures the running app,
+> draws the overlay, and maps a click back to the component that rendered it.
+> The detail panel now labels each computed style with its source file, line,
+> selector, and exact-or-inferred confidence for inline, global CSS, CSS
+> Modules, and Tailwind.
+
+## What the MVP will do
+
+- Scan a React project and build a deterministic component manifest.
+- Serve `/ui` with a component tree, geometry, and style provenance.
+- Measure real boxes and matched CSS in the running app.
+- Jump from a click in the app to the component that rendered the element.
+- Flag token matches, near matches, and undefined CSS variables with severity
+  and confidence.
+- Keep known issues quiet with a baseline.
+- Stay local: no telemetry, no network calls, no AI.
+
+## Documentation
+
+- [Documentation index](docs/README.md)
+- [Quickstart](docs/quickstart.md)
+- [Concepts](docs/concepts.md)
+- [Product and strategy handbook](handbook.md)
+- [Engineering instructions for agents](AGENTS.md)
+
+## Development
+
+```bash
+pnpm install
+pnpm check
+```
+
+Individual commands:
+
+```bash
+pnpm build
+pnpm test
+pnpm typecheck
+pnpm lint
+pnpm docs:links
+pnpm pack:smoke
+```
+
+The package remains private with an unresolved license until the publishing
+decision is recorded. See [CONTRIBUTING.md](CONTRIBUTING.md).

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "snoop-ui",
+  "version": "0.0.1",
+  "license": "MIT",
+  "type": "module",
+  "packageManager": "pnpm@11.10.0",
+  "engines": { "node": ">=22.18.0" },
+  "description": "A local, no-AI inspector for React apps: component geometry, style sources, and deterministic diagnostics.",
+  "keywords": [
+    "react",
+    "vite",
+    "devtools",
+    "css",
+    "tailwind",
+    "inspector"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/snoop-ui/snoop-ui.git"
+  },
+  "homepage": "https://github.com/snoop-ui/snoop-ui#readme",
+  "bin": {
+    "snoop": "./packages/cli/dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./packages/core/dist/index.d.ts",
+      "import": "./packages/core/dist/index.js"
+    },
+    "./vite": {
+      "types": "./packages/adapter-vite/dist/vite.d.ts",
+      "import": "./packages/adapter-vite/dist/vite.js"
+    },
+    "./schemas/*": "./schemas/*"
+  },
+  "files": [
+    "packages/core/dist",
+    "packages/runtime/dist",
+    "packages/adapter-vite/dist",
+    "packages/cli/dist",
+    "schemas",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "pnpm -r run build",
+    "build:core": "pnpm --filter @snoop-ui/core run build",
+    "build:runtime": "pnpm --filter @snoop-ui/runtime run build",
+    "build:unplugin": "pnpm --filter @snoop-ui/unplugin run build",
+    "build:adapter-vite": "pnpm --filter @snoop-ui/adapter-vite run build",
+    "build:adapter-next": "pnpm --filter @snoop-ui/adapter-next run build",
+    "build:adapter-remix": "pnpm --filter @snoop-ui/adapter-remix run build",
+    "build:adapter-tanstack": "pnpm --filter @snoop-ui/adapter-tanstack run build",
+    "build:cli": "pnpm --filter @snoop-ui/cli run build",
+    "dev": "pnpm --filter @snoop-ui/core run dev & pnpm --filter @snoop-ui/adapter-vite run dev",
+    "test": "pnpm -r run test",
+    "test:watch": "pnpm -r run test:watch",
+    "test:browser": "pnpm --filter @snoop-ui/core run test:browser",
+    "typecheck": "pnpm -r run typecheck",
+    "lint": "pnpm -r run lint",
+    "format": "pnpm -r run format",
+    "format:check": "pnpm -r run format:check",
+    "schemas": "pnpm -r run schemas",
+    "bundle:size": "pnpm -r run bundle:size",
+    "docs:links": "pnpm -r run docs:links",
+    "licenses:check": "pnpm -r run licenses:check",
+    "pack:smoke": "pnpm --filter @snoop-ui/cli run pack:smoke",
+    "publint": "npx publint",
+    "attw": "npx attw --pack . --profile esm-only",
+    "check": "pnpm run format:check && pnpm run lint && pnpm run typecheck && pnpm run test && pnpm run build && pnpm run bundle:size && pnpm run test:browser && pnpm run schemas && pnpm run publint && pnpm run docs:links && pnpm run licenses:check"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@changesets/cli": "^3.0.3",
+    "@eslint/js": "^10.0.1",
+    "@preact/preset-vite": "^2.10.6",
+    "@types/babel__traverse": "7.28.0",
+    "@types/node": "^22.20.5",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@types/ws": "^8.18.2",
+    "eslint": "^10.14.0",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^16.5.0",
+    "prettier": "^3.10.0",
+    "publint": "^0.3.25",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "tsup": "^9.0.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.72.2",
+    "vite": "^8.3.8",
+    "vitest": "^5.1.0"
+  }
+}

package/packages/adapter-vite/dist/vite.d.ts

@@ -0,0 +1,29 @@
+import { Plugin } from 'vite';
+
+interface SnoopPluginOptions {
+    /**
+     * Where the dashboard is served. Defaults to the config value (`/ui`).
+     */
+    basePath?: string;
+    /**
+     * The app URL loaded inside the dashboard preview iframe. Defaults to `/`.
+     */
+    appUrl?: string;
+    /** Override content-hash caching. Enabled by default. */
+    cache?: boolean;
+    /**
+     * Inject the runtime agent into the app. Enabled by default.
+     */
+    runtime?: boolean;
+    /**
+     * Override the built dashboard directory. Used by tests and unusual installs.
+     * @internal
+     */
+    clientDir?: string;
+}
+declare function snoop(options?: SnoopPluginOptions): Plugin;
+/** Read original -> generated class names from Vite's CSS Modules JS output. */
+declare function parseCssModuleExports(code: string): Record<string, string> | undefined;
+
+export { parseCssModuleExports, snoop };
+export type { SnoopPluginOptions };

package/packages/adapter-vite/dist/vite.js

@@ -0,0 +1,281 @@
+// src/vite.ts
+import { existsSync, readFileSync } from "fs";
+import { basename, dirname, extname, join, relative, resolve, sep } from "path";
+import { fileURLToPath } from "url";
+import { loadConfig } from "@snoop-ui/core/config.js";
+import { createSnoopMiddleware, normalizeBasePath } from "@snoop-ui/core/server/http.js";
+import { createScanService } from "@snoop-ui/core/server/service.js";
+import { createSnoopWebSocket } from "@snoop-ui/core/server/ws.js";
+import { shouldTagFile, tagSource } from "@snoop-ui/core/runtime/tagging.js";
+import { toPosixPath } from "@snoop-ui/core/utils/paths.js";
+var LOCAL_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "::1"]);
+var VIRTUAL_AGENT_ID = "virtual:snoop-agent";
+var RESOLVED_AGENT_ID = `\0${VIRTUAL_AGENT_ID}`;
+var MISSING_AGENT_MODULE = `console.warn('[snoop] The runtime agent bundle is missing. Run \`pnpm build\` in the Snoop package.');`;
+function snoop(options = {}) {
+  let dispose;
+  let root = process.cwd();
+  return {
+    name: "snoop-ui",
+    apply: "serve",
+    // The tagging transform has to see the original JSX, before the React
+    // plugin compiles it away.
+    enforce: "pre",
+    configResolved(config) {
+      root = config.root;
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_AGENT_ID || id === RESOLVED_AGENT_ID) {
+        return RESOLVED_AGENT_ID;
+      }
+      return void 0;
+    },
+    load(id) {
+      if (id === RESOLVED_AGENT_ID) {
+        return loadAgentModule();
+      }
+      return void 0;
+    },
+    transform: {
+      order: "pre",
+      handler(code, id) {
+        return transformSource(code, id, root);
+      }
+    },
+    // The agent script has to be injected before Vite's own HTML transform
+    // runs. Only then does Vite rewrite the inline module into a proxied
+    // module request, which is what makes `virtual:snoop-agent` resolve.
+    transformIndexHtml: {
+      order: "pre",
+      handler() {
+        if (options.runtime === false) {
+          return [];
+        }
+        return [
+          {
+            tag: "script",
+            attrs: { type: "module" },
+            children: `import '${VIRTUAL_AGENT_ID}';`,
+            injectTo: "body"
+          }
+        ];
+      }
+    },
+    async configureServer(server) {
+      const cwd = server.config.root;
+      const config = await loadConfig({ cwd });
+      const basePath = normalizeBasePath(options.basePath ?? config.basePath);
+      const appUrl = options.appUrl ?? config.appUrl;
+      const clientDir = options.clientDir ?? findClientDir();
+      const service = createScanService({
+        cwd,
+        include: config.include,
+        exclude: config.exclude,
+        tokens: config.tokens,
+        ...options.cache !== void 0 ? { cache: options.cache } : {},
+        resolveCssModules: (files) => resolveCssModules(server, files),
+        onError(error) {
+          server.config.logger.error(
+            `[snoop] scan failed: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      });
+      const bridge = createSnoopWebSocket({ service });
+      server.middlewares.use(
+        createSnoopMiddleware({
+          service,
+          clientDir,
+          basePath,
+          appUrl,
+          ...config.editor ? { editor: config.editor } : {},
+          agents: bridge
+        })
+      );
+      const onUpgrade = (req, socket, head) => {
+        bridge.handleUpgrade(req, socket, head);
+      };
+      server.httpServer?.on("upgrade", onUpgrade);
+      let timer;
+      const scheduleRefresh = () => {
+        if (timer) {
+          clearTimeout(timer);
+        }
+        timer = setTimeout(() => {
+          timer = void 0;
+          void service.refresh();
+        }, 120);
+      };
+      const onFileChange = (_event, file) => {
+        if (shouldRefresh(file, cwd)) {
+          scheduleRefresh();
+        }
+      };
+      server.watcher.on("all", onFileChange);
+      dispose = () => {
+        if (timer) {
+          clearTimeout(timer);
+          timer = void 0;
+        }
+        server.watcher.off("all", onFileChange);
+        server.httpServer?.off("upgrade", onUpgrade);
+        bridge.close();
+        service.dispose();
+      };
+      server.httpServer?.once("close", () => {
+        dispose?.();
+        dispose = void 0;
+      });
+      warnIfExposed(server);
+      if (server.httpServer?.listening) {
+        void service.refresh();
+      } else if (server.httpServer) {
+        server.httpServer.once("listening", () => void service.refresh());
+      } else {
+        void service.refresh();
+      }
+    },
+    closeBundle() {
+      dispose?.();
+      dispose = void 0;
+    }
+  };
+}
+function transformSource(code, id, root) {
+  const [filePath] = id.split("?");
+  if (!filePath || !filePath.startsWith("/") || filePath.includes("/node_modules/")) {
+    return void 0;
+  }
+  if (!shouldTagFile(filePath)) {
+    return void 0;
+  }
+  const relativePath = relative(root, filePath);
+  if (!relativePath || relativePath.startsWith("..")) {
+    return void 0;
+  }
+  const file = toPosixPath(relativePath);
+  const result = tagSource(code, { file, extension: extname(filePath) });
+  if (result.tags.length === 0) {
+    return void 0;
+  }
+  return { code: result.code, map: null };
+}
+async function resolveCssModules(server, files) {
+  const maps = {};
+  await Promise.all(
+    files.map(async (file) => {
+      try {
+        const result = await server.transformRequest(`/${file}`);
+        const map = parseCssModuleExports(result?.code ?? "");
+        if (map) {
+          maps[file] = map;
+        }
+      } catch {
+      }
+    })
+  );
+  return maps;
+}
+function parseCssModuleExports(code) {
+  const named = /* @__PURE__ */ new Map();
+  const namedPattern = /export const (\w+) = ("(?:[^"\\]|\\.)*");/g;
+  for (const match of code.matchAll(namedPattern)) {
+    const name = match[1];
+    const value = match[2];
+    if (name && value) {
+      named.set(name, decodeStringLiteral(value));
+    }
+  }
+  const defaultMatch = /export default\s*(\{[\s\S]*?\});?\s*(?:import\.meta|$)/.exec(code);
+  if (!defaultMatch?.[1]) {
+    return named.size > 0 ? Object.fromEntries(named) : void 0;
+  }
+  const body = defaultMatch[1];
+  const map = {};
+  const entryPattern = /(?:"((?:[^"\\]|\\.)*)"|'((?:[^'\\]|\\.)*)'|(\w+))\s*:\s*(?:"((?:[^"\\]|\\.)*)"|'((?:[^'\\]|\\.)*)'|(\w+))/g;
+  for (const match of body.matchAll(entryPattern)) {
+    const key = match[1] ?? match[2] ?? match[3];
+    const quotedValue = match[4] ?? match[5];
+    const reference = match[6];
+    if (!key) {
+      continue;
+    }
+    const value = quotedValue !== void 0 ? decodeStringLiteral(quotedValue) : named.get(reference ?? "");
+    if (value) {
+      map[key] = value;
+    }
+  }
+  return Object.keys(map).length > 0 ? map : named.size > 0 ? Object.fromEntries(named) : void 0;
+}
+function decodeStringLiteral(value) {
+  const unquoted = /^(['"]).*\1$/s.test(value) ? value.slice(1, -1) : value;
+  return unquoted.replace(/\\(.)/g, "$1");
+}
+function loadAgentModule() {
+  const file = findAgentFile();
+  if (!file) {
+    return MISSING_AGENT_MODULE;
+  }
+  return readFileSync(file, "utf8");
+}
+function findAgentFile() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    // Bundled: dist/vite.js -> dist/runtime/agent.js.
+    resolve(here, "runtime", "agent.js"),
+    // Source layout: packages/adapter-vite/src/vite.ts -> packages/runtime/src/agent.ts
+    resolve(here, "..", "..", "runtime", "src", "agent.ts"),
+    // Monorepo root: packages/runtime/dist/agent.js
+    resolve(here, "..", "..", "..", "runtime", "dist", "agent.js")
+  ];
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return void 0;
+}
+function findClientDir() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    // Bundled: dist/vite.js -> dist/client.
+    resolve(here, "client"),
+    // Source layout: packages/adapter-vite/src/vite.ts -> packages/adapter-vite/src/client
+    resolve(here, "..", "client")
+  ];
+  for (const candidate of candidates) {
+    if (existsSync(join(candidate, "index.html"))) {
+      return candidate;
+    }
+  }
+  return candidates[0] ?? resolve(here, "client");
+}
+function shouldRefresh(file, cwd) {
+  const relativePath = relative(cwd, file).split(sep).join("/");
+  if (!relativePath || relativePath.startsWith("../")) {
+    return false;
+  }
+  if (/(^|\/)(node_modules|dist|build|coverage|\.git|\.snoop)(\/|$)/.test(relativePath)) {
+    return false;
+  }
+  if (basename(relativePath).startsWith("snoop.config.")) {
+    return true;
+  }
+  if (basename(relativePath).startsWith("tailwind.config.")) {
+    return true;
+  }
+  return /\.(jsx?|tsx?|mjs|cjs|mts|cts|css)$/.test(relativePath);
+}
+function warnIfExposed(server) {
+  const host = server.config.server.host;
+  const exposed = host === true || typeof host === "string" && host.length > 0 && !LOCAL_HOSTS.has(host);
+  if (exposed) {
+    server.config.logger.warn(
+      "[snoop] The Vite dev server is exposed beyond localhost. The dashboard is read-only, but keep it on a trusted network."
+    );
+  }
+}
+export {
+  parseCssModuleExports,
+  snoop
+};
+//# sourceMappingURL=vite.js.map

package/packages/adapter-vite/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { basename, dirname, extname, join, relative, resolve, sep } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { Plugin, ViteDevServer } from 'vite';\nimport { loadConfig } from '@snoop-ui/core/config.js';\nimport { createSnoopMiddleware, normalizeBasePath } from '@snoop-ui/core/server/http.js';\nimport { createScanService } from '@snoop-ui/core/server/service.js';\nimport { createSnoopWebSocket } from '@snoop-ui/core/server/ws.js';\nimport { shouldTagFile, tagSource } from '@snoop-ui/core/runtime/tagging.js';\nimport { toPosixPath } from '@snoop-ui/core/utils/paths.js';\n\nexport interface SnoopPluginOptions {\n  /**\n   * Where the dashboard is served. Defaults to the config value (`/ui`).\n   */\n  basePath?: string;\n  /**\n   * The app URL loaded inside the dashboard preview iframe. Defaults to `/`.\n   */\n  appUrl?: string;\n  /** Override content-hash caching. Enabled by default. */\n  cache?: boolean;\n  /**\n   * Inject the runtime agent into the app. Enabled by default.\n   */\n  runtime?: boolean;\n  /**\n   * Override the built dashboard directory. Used by tests and unusual installs.\n   * @internal\n   */\n  clientDir?: string;\n}\n\nconst LOCAL_HOSTS = new Set(['localhost', '127.0.0.1', '::1']);\nconst VIRTUAL_AGENT_ID = 'virtual:snoop-agent';\nconst RESOLVED_AGENT_ID = `\\0${VIRTUAL_AGENT_ID}`;\nconst MISSING_AGENT_MODULE = `console.warn('[snoop] The runtime agent bundle is missing. Run \\`pnpm build\\` in the Snoop package.');`;\n\nexport function snoop(options: SnoopPluginOptions = {}): Plugin {\n  let dispose: (() => void) | undefined;\n  let root = process.cwd();\n\n  return {\n    name: 'snoop-ui',\n    apply: 'serve',\n    // The tagging transform has to see the original JSX, before the React\n    // plugin compiles it away.\n    enforce: 'pre',\n\n    configResolved(config) {\n      root = config.root;\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_AGENT_ID || id === RESOLVED_AGENT_ID) {\n        return RESOLVED_AGENT_ID;\n      }\n\n      return undefined;\n    },\n\n    load(id) {\n      if (id === RESOLVED_AGENT_ID) {\n        return loadAgentModule();\n      }\n\n      return undefined;\n    },\n\n    transform: {\n      order: 'pre',\n      handler(code, id) {\n        return transformSource(code, id, root);\n      },\n    },\n\n    // The agent script has to be injected before Vite's own HTML transform\n    // runs. Only then does Vite rewrite the inline module into a proxied\n    // module request, which is what makes `virtual:snoop-agent` resolve.\n    transformIndexHtml: {\n      order: 'pre',\n      handler() {\n        if (options.runtime === false) {\n          return [];\n        }\n\n        return [\n          {\n            tag: 'script',\n            attrs: { type: 'module' },\n            children: `import '${VIRTUAL_AGENT_ID}';`,\n            injectTo: 'body' as const,\n          },\n        ];\n      },\n    },\n\n    async configureServer(server) {\n      const cwd = server.config.root;\n      const config = await loadConfig({ cwd });\n      const basePath = normalizeBasePath(options.basePath ?? config.basePath);\n      const appUrl = options.appUrl ?? config.appUrl;\n      const clientDir = options.clientDir ?? findClientDir();\n\n      const service = createScanService({\n        cwd,\n        include: config.include,\n        exclude: config.exclude,\n        tokens: config.tokens,\n        ...(options.cache !== undefined ? { cache: options.cache } : {}),\n        resolveCssModules: (files) => resolveCssModules(server, files),\n        onError(error) {\n          server.config.logger.error(\n            `[snoop] scan failed: ${error instanceof Error ? error.message : String(error)}`,\n          );\n        },\n      });\n\n      const bridge = createSnoopWebSocket({ service });\n\n      server.middlewares.use(\n        createSnoopMiddleware({\n          service,\n          clientDir,\n          basePath,\n          appUrl,\n          ...(config.editor ? { editor: config.editor } : {}),\n          agents: bridge,\n        }),\n      );\n\n      const onUpgrade = (\n        req: Parameters<typeof bridge.handleUpgrade>[0],\n        socket: Parameters<typeof bridge.handleUpgrade>[1],\n        head: Buffer,\n      ) => {\n        bridge.handleUpgrade(req, socket, head);\n      };\n\n      server.httpServer?.on('upgrade', onUpgrade);\n\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const scheduleRefresh = () => {\n        if (timer) {\n          clearTimeout(timer);\n        }\n\n        timer = setTimeout(() => {\n          timer = undefined;\n          void service.refresh();\n        }, 120);\n      };\n\n      const onFileChange = (_event: string, file: string) => {\n        if (shouldRefresh(file, cwd)) {\n          scheduleRefresh();\n        }\n      };\n\n      server.watcher.on('all', onFileChange);\n\n      dispose = () => {\n        if (timer) {\n          clearTimeout(timer);\n          timer = undefined;\n        }\n\n        server.watcher.off('all', onFileChange);\n        server.httpServer?.off('upgrade', onUpgrade);\n        bridge.close();\n        service.dispose();\n      };\n\n      server.httpServer?.once('close', () => {\n        dispose?.();\n        dispose = undefined;\n      });\n\n      warnIfExposed(server);\n\n      // `transformRequest` (used for CSS Modules) needs the plugin container to\n      // be fully ready. Defer the first scan until the server is listening.\n      if (server.httpServer?.listening) {\n        void service.refresh();\n      } else if (server.httpServer) {\n        server.httpServer.once('listening', () => void service.refresh());\n      } else {\n        void service.refresh();\n      }\n    },\n\n    closeBundle() {\n      dispose?.();\n      dispose = undefined;\n    },\n  };\n}\n\nfunction transformSource(code: string, id: string, root: string) {\n  const [filePath] = id.split('?');\n\n  if (!filePath || !filePath.startsWith('/') || filePath.includes('/node_modules/')) {\n    return undefined;\n  }\n\n  if (!shouldTagFile(filePath)) {\n    return undefined;\n  }\n\n  const relativePath = relative(root, filePath);\n  if (!relativePath || relativePath.startsWith('..')) {\n    return undefined;\n  }\n\n  const file = toPosixPath(relativePath);\n  const result = tagSource(code, { file, extension: extname(filePath) });\n\n  if (result.tags.length === 0) {\n    return undefined;\n  }\n\n  return { code: result.code, map: null };\n}\n\n/**\n * Ask Vite for each CSS Module's generated class mapping. The dev server's own\n * transform owns the naming scheme, so Snoop never reimplements it.\n */\nasync function resolveCssModules(\n  server: ViteDevServer,\n  files: string[],\n): Promise<Record<string, Record<string, string>>> {\n  const maps: Record<string, Record<string, string>> = {};\n\n  await Promise.all(\n    files.map(async (file) => {\n      try {\n        const result = await server.transformRequest(`/${file}`);\n        const map = parseCssModuleExports(result?.code ?? '');\n\n        if (map) {\n          maps[file] = map;\n        }\n      } catch {\n        // A module that Vite cannot transform simply keeps its original\n        // selectors. The resolver labels those matches INFERRED.\n      }\n    }),\n  );\n\n  return maps;\n}\n\n/** Read original -> generated class names from Vite's CSS Modules JS output. */\nexport function parseCssModuleExports(code: string): Record<string, string> | undefined {\n  const named = new Map<string, string>();\n  const namedPattern = /export const (\\w+) = (\"(?:[^\"\\\\]|\\\\.)*\");/g;\n\n  for (const match of code.matchAll(namedPattern)) {\n    const name = match[1];\n    const value = match[2];\n    if (name && value) {\n      named.set(name, decodeStringLiteral(value));\n    }\n  }\n\n  const defaultMatch = /export default\\s*(\\{[\\s\\S]*?\\});?\\s*(?:import\\.meta|$)/.exec(code);\n\n  if (!defaultMatch?.[1]) {\n    return named.size > 0 ? Object.fromEntries(named) : undefined;\n  }\n\n  const body = defaultMatch[1];\n  const map: Record<string, string> = {};\n  const entryPattern =\n    /(?:\"((?:[^\"\\\\]|\\\\.)*)\"|'((?:[^'\\\\]|\\\\.)*)'|(\\w+))\\s*:\\s*(?:\"((?:[^\"\\\\]|\\\\.)*)\"|'((?:[^'\\\\]|\\\\.)*)'|(\\w+))/g;\n\n  for (const match of body.matchAll(entryPattern)) {\n    const key = match[1] ?? match[2] ?? match[3];\n    const quotedValue = match[4] ?? match[5];\n    const reference = match[6];\n\n    if (!key) {\n      continue;\n    }\n\n    const value =\n      quotedValue !== undefined ? decodeStringLiteral(quotedValue) : named.get(reference ?? '');\n    if (value) {\n      map[key] = value;\n    }\n  }\n\n  return Object.keys(map).length > 0 ? map : named.size > 0 ? Object.fromEntries(named) : undefined;\n}\n\nfunction decodeStringLiteral(value: string): string {\n  const unquoted = /^(['\"]).*\\1$/s.test(value) ? value.slice(1, -1) : value;\n  return unquoted.replace(/\\\\(.)/g, '$1');\n}\n\nfunction loadAgentModule(): string {\n  const file = findAgentFile();\n\n  if (!file) {\n    return MISSING_AGENT_MODULE;\n  }\n\n  return readFileSync(file, 'utf8');\n}\n\nfunction findAgentFile(): string | undefined {\n  const here = dirname(fileURLToPath(import.meta.url));\n  const candidates = [\n    // Bundled: dist/vite.js -> dist/runtime/agent.js.\n    resolve(here, 'runtime', 'agent.js'),\n    // Source layout: packages/adapter-vite/src/vite.ts -> packages/runtime/src/agent.ts\n    resolve(here, '..', '..', 'runtime', 'src', 'agent.ts'),\n    // Monorepo root: packages/runtime/dist/agent.js\n    resolve(here, '..', '..', '..', 'runtime', 'dist', 'agent.js'),\n  ];\n\n  for (const candidate of candidates) {\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  return undefined;\n}\n\nfunction findClientDir(): string {\n  const here = dirname(fileURLToPath(import.meta.url));\n  const candidates = [\n    // Bundled: dist/vite.js -> dist/client.\n    resolve(here, 'client'),\n    // Source layout: packages/adapter-vite/src/vite.ts -> packages/adapter-vite/src/client\n    resolve(here, '..', 'client'),\n  ];\n\n  for (const candidate of candidates) {\n    if (existsSync(join(candidate, 'index.html'))) {\n      return candidate;\n    }\n  }\n\n  return candidates[0] ?? resolve(here, 'client');\n}\n\nfunction shouldRefresh(file: string, cwd: string): boolean {\n  const relativePath = relative(cwd, file).split(sep).join('/');\n\n  if (!relativePath || relativePath.startsWith('../')) {\n    return false;\n  }\n\n  if (/(^|\\/)(node_modules|dist|build|coverage|\\.git|\\.snoop)(\\/|$)/.test(relativePath)) {\n    return false;\n  }\n\n  if (basename(relativePath).startsWith('snoop.config.')) {\n    return true;\n  }\n\n  if (basename(relativePath).startsWith('tailwind.config.')) {\n    return true;\n  }\n\n  return /\\.(jsx?|tsx?|mjs|cjs|mts|cts|css)$/.test(relativePath);\n}\n\nfunction warnIfExposed(server: ViteDevServer): void {\n  const host = server.config.server.host;\n  const exposed =\n    host === true || (typeof host === 'string' && host.length > 0 && !LOCAL_HOSTS.has(host));\n\n  if (exposed) {\n    server.config.logger.warn(\n      '[snoop] The Vite dev server is exposed beyond localhost. The dashboard is read-only, but keep it on a trusted network.',\n    );\n  }\n}\n"],"mappings":";AAAA,SAAS,YAAY,oBAAoB;AACzC,SAAS,UAAU,SAAS,SAAS,MAAM,UAAU,SAAS,WAAW;AACzE,SAAS,qBAAqB;AAE9B,SAAS,kBAAkB;AAC3B,SAAS,uBAAuB,yBAAyB;AACzD,SAAS,yBAAyB;AAClC,SAAS,4BAA4B;AACrC,SAAS,eAAe,iBAAiB;AACzC,SAAS,mBAAmB;AAwB5B,IAAM,cAAc,oBAAI,IAAI,CAAC,aAAa,aAAa,KAAK,CAAC;AAC7D,IAAM,mBAAmB;AACzB,IAAM,oBAAoB,KAAK,gBAAgB;AAC/C,IAAM,uBAAuB;AAEtB,SAAS,MAAM,UAA8B,CAAC,GAAW;AAC9D,MAAI;AACJ,MAAI,OAAO,QAAQ,IAAI;AAEvB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA;AAAA;AAAA,IAGP,SAAS;AAAA,IAET,eAAe,QAAQ;AACrB,aAAO,OAAO;AAAA,IAChB;AAAA,IAEA,UAAU,IAAI;AACZ,UAAI,OAAO,oBAAoB,OAAO,mBAAmB;AACvD,eAAO;AAAA,MACT;AAEA,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,IAAI;AACP,UAAI,OAAO,mBAAmB;AAC5B,eAAO,gBAAgB;AAAA,MACzB;AAEA,aAAO;AAAA,IACT;AAAA,IAEA,WAAW;AAAA,MACT,OAAO;AAAA,MACP,QAAQ,MAAM,IAAI;AAChB,eAAO,gBAAgB,MAAM,IAAI,IAAI;AAAA,MACvC;AAAA,IACF;AAAA;AAAA;AAAA;AAAA,IAKA,oBAAoB;AAAA,MAClB,OAAO;AAAA,MACP,UAAU;AACR,YAAI,QAAQ,YAAY,OAAO;AAC7B,iBAAO,CAAC;AAAA,QACV;AAEA,eAAO;AAAA,UACL;AAAA,YACE,KAAK;AAAA,YACL,OAAO,EAAE,MAAM,SAAS;AAAA,YACxB,UAAU,WAAW,gBAAgB;AAAA,YACrC,UAAU;AAAA,UACZ;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,gBAAgB,QAAQ;AAC5B,YAAM,MAAM,OAAO,OAAO;AAC1B,YAAM,SAAS,MAAM,WAAW,EAAE,IAAI,CAAC;AACvC,YAAM,WAAW,kBAAkB,QAAQ,YAAY,OAAO,QAAQ;AACtE,YAAM,SAAS,QAAQ,UAAU,OAAO;AACxC,YAAM,YAAY,QAAQ,aAAa,cAAc;AAErD,YAAM,UAAU,kBAAkB;AAAA,QAChC;AAAA,QACA,SAAS,OAAO;AAAA,QAChB,SAAS,OAAO;AAAA,QAChB,QAAQ,OAAO;AAAA,QACf,GAAI,QAAQ,UAAU,SAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,QAC9D,mBAAmB,CAAC,UAAU,kBAAkB,QAAQ,KAAK;AAAA,QAC7D,QAAQ,OAAO;AACb,iBAAO,OAAO,OAAO;AAAA,YACnB,wBAAwB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,UAChF;AAAA,QACF;AAAA,MACF,CAAC;AAED,YAAM,SAAS,qBAAqB,EAAE,QAAQ,CAAC;AAE/C,aAAO,YAAY;AAAA,QACjB,sBAAsB;AAAA,UACpB;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;AAAA,UACjD,QAAQ;AAAA,QACV,CAAC;AAAA,MACH;AAEA,YAAM,YAAY,CAChB,KACA,QACA,SACG;AACH,eAAO,cAAc,KAAK,QAAQ,IAAI;AAAA,MACxC;AAEA,aAAO,YAAY,GAAG,WAAW,SAAS;AAE1C,UAAI;AACJ,YAAM,kBAAkB,MAAM;AAC5B,YAAI,OAAO;AACT,uBAAa,KAAK;AAAA,QACpB;AAEA,gBAAQ,WAAW,MAAM;AACvB,kBAAQ;AACR,eAAK,QAAQ,QAAQ;AAAA,QACvB,GAAG,GAAG;AAAA,MACR;AAEA,YAAM,eAAe,CAAC,QAAgB,SAAiB;AACrD,YAAI,cAAc,MAAM,GAAG,GAAG;AAC5B,0BAAgB;AAAA,QAClB;AAAA,MACF;AAEA,aAAO,QAAQ,GAAG,OAAO,YAAY;AAErC,gBAAU,MAAM;AACd,YAAI,OAAO;AACT,uBAAa,KAAK;AAClB,kBAAQ;AAAA,QACV;AAEA,eAAO,QAAQ,IAAI,OAAO,YAAY;AACtC,eAAO,YAAY,IAAI,WAAW,SAAS;AAC3C,eAAO,MAAM;AACb,gBAAQ,QAAQ;AAAA,MAClB;AAEA,aAAO,YAAY,KAAK,SAAS,MAAM;AACrC,kBAAU;AACV,kBAAU;AAAA,MACZ,CAAC;AAED,oBAAc,MAAM;AAIpB,UAAI,OAAO,YAAY,WAAW;AAChC,aAAK,QAAQ,QAAQ;AAAA,MACvB,WAAW,OAAO,YAAY;AAC5B,eAAO,WAAW,KAAK,aAAa,MAAM,KAAK,QAAQ,QAAQ,CAAC;AAAA,MAClE,OAAO;AACL,aAAK,QAAQ,QAAQ;AAAA,MACvB;AAAA,IACF;AAAA,IAEA,cAAc;AACZ,gBAAU;AACV,gBAAU;AAAA,IACZ;AAAA,EACF;AACF;AAEA,SAAS,gBAAgB,MAAc,IAAY,MAAc;AAC/D,QAAM,CAAC,QAAQ,IAAI,GAAG,MAAM,GAAG;AAE/B,MAAI,CAAC,YAAY,CAAC,SAAS,WAAW,GAAG,KAAK,SAAS,SAAS,gBAAgB,GAAG;AACjF,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,cAAc,QAAQ,GAAG;AAC5B,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,SAAS,MAAM,QAAQ;AAC5C,MAAI,CAAC,gBAAgB,aAAa,WAAW,IAAI,GAAG;AAClD,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,YAAY,YAAY;AACrC,QAAM,SAAS,UAAU,MAAM,EAAE,MAAM,WAAW,QAAQ,QAAQ,EAAE,CAAC;AAErE,MAAI,OAAO,KAAK,WAAW,GAAG;AAC5B,WAAO;AAAA,EACT;AAEA,SAAO,EAAE,MAAM,OAAO,MAAM,KAAK,KAAK;AACxC;AAMA,eAAe,kBACb,QACA,OACiD;AACjD,QAAM,OAA+C,CAAC;AAEtD,QAAM,QAAQ;AAAA,IACZ,MAAM,IAAI,OAAO,SAAS;AACxB,UAAI;AACF,cAAM,SAAS,MAAM,OAAO,iBAAiB,IAAI,IAAI,EAAE;AACvD,cAAM,MAAM,sBAAsB,QAAQ,QAAQ,EAAE;AAEpD,YAAI,KAAK;AACP,eAAK,IAAI,IAAI;AAAA,QACf;AAAA,MACF,QAAQ;AAAA,MAGR;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAGO,SAAS,sBAAsB,MAAkD;AACtF,QAAM,QAAQ,oBAAI,IAAoB;AACtC,QAAM,eAAe;AAErB,aAAW,SAAS,KAAK,SAAS,YAAY,GAAG;AAC/C,UAAM,OAAO,MAAM,CAAC;AACpB,UAAM,QAAQ,MAAM,CAAC;AACrB,QAAI,QAAQ,OAAO;AACjB,YAAM,IAAI,MAAM,oBAAoB,KAAK,CAAC;AAAA,IAC5C;AAAA,EACF;AAEA,QAAM,eAAe,yDAAyD,KAAK,IAAI;AAEvF,MAAI,CAAC,eAAe,CAAC,GAAG;AACtB,WAAO,MAAM,OAAO,IAAI,OAAO,YAAY,KAAK,IAAI;AAAA,EACtD;AAEA,QAAM,OAAO,aAAa,CAAC;AAC3B,QAAM,MAA8B,CAAC;AACrC,QAAM,eACJ;AAEF,aAAW,SAAS,KAAK,SAAS,YAAY,GAAG;AAC/C,UAAM,MAAM,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,CAAC;AAC3C,UAAM,cAAc,MAAM,CAAC,KAAK,MAAM,CAAC;AACvC,UAAM,YAAY,MAAM,CAAC;AAEzB,QAAI,CAAC,KAAK;AACR;AAAA,IACF;AAEA,UAAM,QACJ,gBAAgB,SAAY,oBAAoB,WAAW,IAAI,MAAM,IAAI,aAAa,EAAE;AAC1F,QAAI,OAAO;AACT,UAAI,GAAG,IAAI;AAAA,IACb;AAAA,EACF;AAEA,SAAO,OAAO,KAAK,GAAG,EAAE,SAAS,IAAI,MAAM,MAAM,OAAO,IAAI,OAAO,YAAY,KAAK,IAAI;AAC1F;AAEA,SAAS,oBAAoB,OAAuB;AAClD,QAAM,WAAW,gBAAgB,KAAK,KAAK,IAAI,MAAM,MAAM,GAAG,EAAE,IAAI;AACpE,SAAO,SAAS,QAAQ,UAAU,IAAI;AACxC;AAEA,SAAS,kBAA0B;AACjC,QAAM,OAAO,cAAc;AAE3B,MAAI,CAAC,MAAM;AACT,WAAO;AAAA,EACT;AAEA,SAAO,aAAa,MAAM,MAAM;AAClC;AAEA,SAAS,gBAAoC;AAC3C,QAAM,OAAO,QAAQ,cAAc,YAAY,GAAG,CAAC;AACnD,QAAM,aAAa;AAAA;AAAA,IAEjB,QAAQ,MAAM,WAAW,UAAU;AAAA;AAAA,IAEnC,QAAQ,MAAM,MAAM,MAAM,WAAW,OAAO,UAAU;AAAA;AAAA,IAEtD,QAAQ,MAAM,MAAM,MAAM,MAAM,WAAW,QAAQ,UAAU;AAAA,EAC/D;AAEA,aAAW,aAAa,YAAY;AAClC,QAAI,WAAW,SAAS,GAAG;AACzB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,gBAAwB;AAC/B,QAAM,OAAO,QAAQ,cAAc,YAAY,GAAG,CAAC;AACnD,QAAM,aAAa;AAAA;AAAA,IAEjB,QAAQ,MAAM,QAAQ;AAAA;AAAA,IAEtB,QAAQ,MAAM,MAAM,QAAQ;AAAA,EAC9B;AAEA,aAAW,aAAa,YAAY;AAClC,QAAI,WAAW,KAAK,WAAW,YAAY,CAAC,GAAG;AAC7C,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO,WAAW,CAAC,KAAK,QAAQ,MAAM,QAAQ;AAChD;AAEA,SAAS,cAAc,MAAc,KAAsB;AACzD,QAAM,eAAe,SAAS,KAAK,IAAI,EAAE,MAAM,GAAG,EAAE,KAAK,GAAG;AAE5D,MAAI,CAAC,gBAAgB,aAAa,WAAW,KAAK,GAAG;AACnD,WAAO;AAAA,EACT;AAEA,MAAI,+DAA+D,KAAK,YAAY,GAAG;AACrF,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,YAAY,EAAE,WAAW,eAAe,GAAG;AACtD,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,YAAY,EAAE,WAAW,kBAAkB,GAAG;AACzD,WAAO;AAAA,EACT;AAEA,SAAO,qCAAqC,KAAK,YAAY;AAC/D;AAEA,SAAS,cAAc,QAA6B;AAClD,QAAM,OAAO,OAAO,OAAO,OAAO;AAClC,QAAM,UACJ,SAAS,QAAS,OAAO,SAAS,YAAY,KAAK,SAAS,KAAK,CAAC,YAAY,IAAI,IAAI;AAExF,MAAI,SAAS;AACX,WAAO,OAAO,OAAO;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/packages/cli/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/packages/cli/dist/cli.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+
+// src/cli/index.ts
+import { resolve as resolve3 } from "path";
+import { cac } from "cac";
+import { readFileSync } from "fs";
+import { relativePosix } from "@snoop-ui/core/utils/paths.js";
+
+// src/cli/init.ts
+import { access, writeFile } from "fs/promises";
+import { resolve } from "path";
+var CONFIG_TEMPLATE = `import { defineConfig } from 'snoop-ui';
+
+export default defineConfig({
+  // include: ['src/**/*.{jsx,tsx}'],
+  // exclude: ['**/*.stories.{js,jsx,ts,tsx}'],
+  // tokens: ['src/styles/tokens.css'],
+});
+`;
+async function initConfig(options = {}) {
+  const cwd = resolve(options.cwd ?? process.cwd());
+  const path = resolve(cwd, "snoop.config.ts");
+  if (!options.force && await exists(path)) {
+    throw new Error(`A Snoop config already exists at ${path}. Use --force to overwrite it.`);
+  }
+  try {
+    await writeFile(path, CONFIG_TEMPLATE, {
+      encoding: "utf8",
+      flag: options.force ? "w" : "wx"
+    });
+  } catch (error) {
+    if (!options.force && isAlreadyExists(error)) {
+      throw new Error(`A Snoop config already exists at ${path}. Use --force to overwrite it.`, {
+        cause: error
+      });
+    }
+    throw error;
+  }
+  return { path };
+}
+async function exists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isAlreadyExists(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "EEXIST";
+}
+
+// src/cli/scan.ts
+import { resolve as resolve2 } from "path";
+import { loadConfig } from "@snoop-ui/core/config.js";
+import { scanProject, writeManifest } from "@snoop-ui/core/scanner/index.js";
+var DEFAULT_MANIFEST_PATH = ".snoop/manifest.json";
+async function runScan(options = {}) {
+  const cwd = resolve2(options.cwd ?? process.cwd());
+  const config = await loadConfig({
+    cwd,
+    ...options.configFile ? { configFile: options.configFile } : {}
+  });
+  const result = await scanProject({
+    cwd,
+    include: config.include,
+    exclude: config.exclude,
+    tokens: config.tokens,
+    cache: options.cache
+  });
+  const outPath = resolve2(cwd, options.out ?? DEFAULT_MANIFEST_PATH);
+  await writeManifest(outPath, result.manifest);
+  return { result, outPath };
+}
+
+// src/cli/index.ts
+var pkg = JSON.parse(readFileSync(resolve3(import.meta.dirname, "package.json"), "utf8"));
+var cli = cac("snoop");
+cli.command("init", "Create a snoop.config.ts file").option("--force", "Overwrite an existing config").option("--cwd <path>", "Project directory").action(async (options) => {
+  const cwd = resolve3(options.cwd ?? process.cwd());
+  const result = await initConfig({ cwd, force: options.force });
+  console.log(`Created ${displayPath(cwd, result.path)}.`);
+});
+cli.command("scan", "Scan the project and write .snoop/manifest.json").option("--out <path>", "Output path", { default: DEFAULT_MANIFEST_PATH }).option("--cwd <path>", "Project directory").option("--config <path>", "Config file to load").option("--no-cache", "Disable the content-hash scan cache").action(async (options) => {
+  const cwd = resolve3(options.cwd ?? process.cwd());
+  const { result, outPath } = await runScan({
+    cwd,
+    out: options.out,
+    ...options.config ? { configFile: options.config } : {},
+    cache: options.cache
+  });
+  const { stats } = result;
+  const output = displayPath(cwd, outPath);
+  if (stats.components === 0) {
+    console.log(`No components found in ${stats.files} file(s).`);
+  } else {
+    console.log(`Scanned ${stats.components} component(s) in ${stats.files} file(s).`);
+  }
+  if (stats.cachedFiles > 0) {
+    console.log(`Reused ${stats.cachedFiles} cached file(s).`);
+  }
+  if (stats.errors > 0) {
+    console.log(`${stats.errors} file(s) had warnings; see ${output}.`);
+  }
+  console.log(`Wrote ${output}.`);
+});
+cli.help();
+cli.version(pkg.version);
+async function main() {
+  if (process.argv.slice(2).length === 0) {
+    cli.outputHelp();
+    return;
+  }
+  const wantsHelp = process.argv.includes("--help") || process.argv.includes("-h");
+  const wantsVersion = process.argv.includes("--version") || process.argv.includes("-v");
+  cli.parse(process.argv, { run: false });
+  if (!cli.matchedCommand) {
+    if (!wantsHelp && !wantsVersion && cli.args[0]) {
+      console.error(`Unknown command: ${cli.args[0]}`);
+      cli.outputHelp();
+      process.exitCode = 1;
+    }
+    return;
+  }
+  try {
+    await cli.runMatchedCommand();
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+}
+function displayPath(cwd, path) {
+  return relativePosix(cwd, path) || ".";
+}
+await main();
+//# sourceMappingURL=cli.js.map