0.5.0

.changeset/remove-monitoring-cleanup.md

@@ -0,0 +1,12 @@
+---
+"react-scan": minor
+---
+
+Remove monitoring module, replace Playwright CLI with interactive init command, clean up dead code
+
+- Removed the entire monitoring system (`packages/scan/src/core/monitor/`) and all related exports, types, and build entries
+- Replaced the Playwright-based proxy CLI (`npx react-scan <url>`) with an interactive `npx react-scan init` command that auto-detects your framework and sets up React Scan
+- Removed unused code: old outline system, LRU cache, lazy refs, commented-out code blocks, and unused exports
+- Consolidated duplicate utilities (safeGetValue, RenderPhase types)
+- Simplified README to focus on the new init command
+- Added CLI quick-start command to the website homepage

.gitignore

@@ -10,3 +10,7 @@ playgrounds
 # SSL Certificates
 bin/certs/*.pem
 bin/certs/*.key
+.cursor
+# Playwright
+test-results/
+playwright-report/

.oxlintrc.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["typescript", "react", "import"],
+  "ignorePatterns": [
+    "dist",
+    "build",
+    "node_modules",
+    "**/*.css",
+    "**/*.astro"
+  ],
+  "categories": {},
+  "rules": {
+    "no-unused-vars": [
+      "warn",
+      {
+        "vars": "all",
+        "args": "all",
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_",
+        "caughtErrors": "none"
+      }
+    ],
+    "no-unused-labels": "warn",
+    "no-unused-private-class-members": "warn",
+    "no-console": "warn",
+    "typescript/no-explicit-any": "warn",
+    "typescript/no-non-null-assertion": "warn",
+    "react/no-danger": "error",
+    "react-hooks/exhaustive-deps": "warn"
+  }
+}

.vscode/settings.json

@@ -1,28 +1,12 @@
 {
-  "editor.defaultFormatter": "biomejs.biome",
   "editor.formatOnSave": true,
-  "editor.codeActionsOnSave": {
-    "source.organizeImports.biome": "always",
-    "quickfix.biome": "always"
-  },
   "css.lint.unknownAtRules": "ignore",
-  "[typescript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[javascript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[json]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
+  "oxc.lint.enable": true,
   "[markdown]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
   "[html]": {
     "editor.defaultFormatter": "esbenp.prettier-vscode"
   },
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "[css]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  }
+  "typescript.tsdk": "node_modules/typescript/lib"
 }

AGENTS.md

@@ -0,0 +1,28 @@
+## General Rules
+
+- MUST: Use TypeScript interfaces over types.
+- MUST: Keep all types in the global scope.
+- MUST: Use arrow functions over function declarations
+- MUST: Never comment unless absolutely necessary.
+  - If the code is a hack (like a setTimeout or potentially confusing code), it must be prefixed with // HACK: reason for hack
+- MUST: Use kebab-case for files
+- MUST: Use descriptive names for variables (avoid shorthands, or 1-2 character names).
+  - Example: for .map(), you can use `innerX` instead of `x`
+  - Example: instead of `moved` use `didPositionChange`
+- MUST: Frequently re-evaluate and refactor variable names to be more accurate and descriptive.
+- MUST: Do not type cast ("as") unless absolutely necessary
+- MUST: Remove unused code and don't repeat yourself.
+- MUST: Always search the codebase, think of many solutions, then implement the most _elegant_ solution.
+- MUST: Put all magic numbers in `constants.ts` using `SCREAMING_SNAKE_CASE` with unit suffixes (`_MS`, `_PX`).
+- MUST: Put small, focused utility functions in `utils/` with one utility per file.
+- MUST: Use Boolean over !!.
+
+## Testing
+
+Run checks always before committing with:
+
+```bash
+pnpm build
+pnpm lint
+pnpm format
+```