@sentry/warden 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (580) hide show
  1. package/dist/cli/commands/init.d.ts.map +1 -1
  2. package/dist/cli/commands/init.js +3 -1
  3. package/dist/cli/commands/init.js.map +1 -1
  4. package/dist/cli/commands/setup-app/manifest.d.ts.map +1 -1
  5. package/dist/cli/commands/setup-app/manifest.js +3 -1
  6. package/dist/cli/commands/setup-app/manifest.js.map +1 -1
  7. package/dist/cli/commands/setup-app.js +1 -1
  8. package/dist/cli/commands/setup-app.js.map +1 -1
  9. package/dist/cli/files.d.ts +11 -1
  10. package/dist/cli/files.d.ts.map +1 -1
  11. package/dist/cli/files.js +145 -4
  12. package/dist/cli/files.js.map +1 -1
  13. package/dist/cli/git.d.ts.map +1 -1
  14. package/dist/cli/git.js +5 -9
  15. package/dist/cli/git.js.map +1 -1
  16. package/dist/cli/index.js +0 -0
  17. package/dist/cli/output/tasks.d.ts.map +1 -1
  18. package/dist/cli/output/tasks.js +5 -1
  19. package/dist/cli/output/tasks.js.map +1 -1
  20. package/dist/config/schema.d.ts.map +1 -1
  21. package/dist/config/schema.js +15 -1
  22. package/dist/config/schema.js.map +1 -1
  23. package/dist/diff/coalesce.d.ts +32 -2
  24. package/dist/diff/coalesce.d.ts.map +1 -1
  25. package/dist/diff/coalesce.js +174 -2
  26. package/dist/diff/coalesce.js.map +1 -1
  27. package/dist/output/dedup.d.ts.map +1 -1
  28. package/dist/output/dedup.js +8 -3
  29. package/dist/output/dedup.js.map +1 -1
  30. package/dist/output/renderer.d.ts.map +1 -1
  31. package/dist/output/renderer.js +49 -5
  32. package/dist/output/renderer.js.map +1 -1
  33. package/dist/output/stale.d.ts.map +1 -1
  34. package/dist/output/stale.js +7 -0
  35. package/dist/output/stale.js.map +1 -1
  36. package/dist/output/types.d.ts +15 -1
  37. package/dist/output/types.d.ts.map +1 -1
  38. package/dist/sdk/analyze.d.ts +18 -0
  39. package/dist/sdk/analyze.d.ts.map +1 -0
  40. package/dist/sdk/analyze.js +425 -0
  41. package/dist/sdk/analyze.js.map +1 -0
  42. package/dist/sdk/errors.d.ts +23 -0
  43. package/dist/sdk/errors.d.ts.map +1 -0
  44. package/dist/sdk/errors.js +72 -0
  45. package/dist/sdk/errors.js.map +1 -0
  46. package/dist/sdk/extract.d.ts +44 -0
  47. package/dist/sdk/extract.d.ts.map +1 -0
  48. package/dist/sdk/extract.js +224 -0
  49. package/dist/sdk/extract.js.map +1 -0
  50. package/dist/sdk/prepare.d.ts +13 -0
  51. package/dist/sdk/prepare.d.ts.map +1 -0
  52. package/dist/sdk/prepare.js +73 -0
  53. package/dist/sdk/prepare.js.map +1 -0
  54. package/dist/sdk/prompt.d.ts +30 -0
  55. package/dist/sdk/prompt.d.ts.map +1 -0
  56. package/dist/sdk/prompt.js +109 -0
  57. package/dist/sdk/prompt.js.map +1 -0
  58. package/dist/sdk/retry.d.ts +12 -0
  59. package/dist/sdk/retry.d.ts.map +1 -0
  60. package/dist/sdk/retry.js +31 -0
  61. package/dist/sdk/retry.js.map +1 -0
  62. package/dist/sdk/runner.d.ts +22 -199
  63. package/dist/sdk/runner.d.ts.map +1 -1
  64. package/dist/sdk/runner.js +26 -884
  65. package/dist/sdk/runner.js.map +1 -1
  66. package/dist/sdk/types.d.ts +127 -0
  67. package/dist/sdk/types.d.ts.map +1 -0
  68. package/dist/sdk/types.js +5 -0
  69. package/dist/sdk/types.js.map +1 -0
  70. package/dist/sdk/usage.d.ts +20 -0
  71. package/dist/sdk/usage.d.ts.map +1 -0
  72. package/dist/sdk/usage.js +44 -0
  73. package/dist/sdk/usage.js.map +1 -0
  74. package/dist/skills/remote.d.ts.map +1 -1
  75. package/dist/skills/remote.js +3 -7
  76. package/dist/skills/remote.js.map +1 -1
  77. package/dist/types/index.d.ts +1 -0
  78. package/dist/types/index.d.ts.map +1 -1
  79. package/dist/types/index.js +2 -0
  80. package/dist/types/index.js.map +1 -1
  81. package/dist/utils/exec.d.ts +61 -0
  82. package/dist/utils/exec.d.ts.map +1 -0
  83. package/dist/utils/exec.js +111 -0
  84. package/dist/utils/exec.js.map +1 -0
  85. package/dist/utils/index.d.ts +2 -0
  86. package/dist/utils/index.d.ts.map +1 -1
  87. package/dist/utils/index.js +1 -0
  88. package/dist/utils/index.js.map +1 -1
  89. package/package.json +15 -16
  90. package/.agents/skills/find-bugs/SKILL.md +0 -75
  91. package/.agents/skills/vercel-react-best-practices/AGENTS.md +0 -2934
  92. package/.agents/skills/vercel-react-best-practices/SKILL.md +0 -136
  93. package/.agents/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +0 -55
  94. package/.agents/skills/vercel-react-best-practices/rules/advanced-init-once.md +0 -42
  95. package/.agents/skills/vercel-react-best-practices/rules/advanced-use-latest.md +0 -39
  96. package/.agents/skills/vercel-react-best-practices/rules/async-api-routes.md +0 -38
  97. package/.agents/skills/vercel-react-best-practices/rules/async-defer-await.md +0 -80
  98. package/.agents/skills/vercel-react-best-practices/rules/async-dependencies.md +0 -51
  99. package/.agents/skills/vercel-react-best-practices/rules/async-parallel.md +0 -28
  100. package/.agents/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +0 -99
  101. package/.agents/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +0 -59
  102. package/.agents/skills/vercel-react-best-practices/rules/bundle-conditional.md +0 -31
  103. package/.agents/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +0 -49
  104. package/.agents/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +0 -35
  105. package/.agents/skills/vercel-react-best-practices/rules/bundle-preload.md +0 -50
  106. package/.agents/skills/vercel-react-best-practices/rules/client-event-listeners.md +0 -74
  107. package/.agents/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +0 -71
  108. package/.agents/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +0 -48
  109. package/.agents/skills/vercel-react-best-practices/rules/client-swr-dedup.md +0 -56
  110. package/.agents/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +0 -107
  111. package/.agents/skills/vercel-react-best-practices/rules/js-cache-function-results.md +0 -80
  112. package/.agents/skills/vercel-react-best-practices/rules/js-cache-property-access.md +0 -28
  113. package/.agents/skills/vercel-react-best-practices/rules/js-cache-storage.md +0 -70
  114. package/.agents/skills/vercel-react-best-practices/rules/js-combine-iterations.md +0 -32
  115. package/.agents/skills/vercel-react-best-practices/rules/js-early-exit.md +0 -50
  116. package/.agents/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +0 -45
  117. package/.agents/skills/vercel-react-best-practices/rules/js-index-maps.md +0 -37
  118. package/.agents/skills/vercel-react-best-practices/rules/js-length-check-first.md +0 -49
  119. package/.agents/skills/vercel-react-best-practices/rules/js-min-max-loop.md +0 -82
  120. package/.agents/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +0 -24
  121. package/.agents/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +0 -57
  122. package/.agents/skills/vercel-react-best-practices/rules/rendering-activity.md +0 -26
  123. package/.agents/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +0 -47
  124. package/.agents/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +0 -40
  125. package/.agents/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +0 -38
  126. package/.agents/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +0 -46
  127. package/.agents/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +0 -82
  128. package/.agents/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +0 -30
  129. package/.agents/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +0 -28
  130. package/.agents/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +0 -75
  131. package/.agents/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +0 -39
  132. package/.agents/skills/vercel-react-best-practices/rules/rerender-dependencies.md +0 -45
  133. package/.agents/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +0 -40
  134. package/.agents/skills/vercel-react-best-practices/rules/rerender-derived-state.md +0 -29
  135. package/.agents/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +0 -74
  136. package/.agents/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +0 -58
  137. package/.agents/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +0 -38
  138. package/.agents/skills/vercel-react-best-practices/rules/rerender-memo.md +0 -44
  139. package/.agents/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +0 -45
  140. package/.agents/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +0 -35
  141. package/.agents/skills/vercel-react-best-practices/rules/rerender-transitions.md +0 -40
  142. package/.agents/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +0 -73
  143. package/.agents/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +0 -73
  144. package/.agents/skills/vercel-react-best-practices/rules/server-auth-actions.md +0 -96
  145. package/.agents/skills/vercel-react-best-practices/rules/server-cache-lru.md +0 -41
  146. package/.agents/skills/vercel-react-best-practices/rules/server-cache-react.md +0 -76
  147. package/.agents/skills/vercel-react-best-practices/rules/server-dedup-props.md +0 -65
  148. package/.agents/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +0 -83
  149. package/.agents/skills/vercel-react-best-practices/rules/server-serialization.md +0 -38
  150. package/.claude/settings.json +0 -57
  151. package/.claude/skills/agent-prompt/SKILL.md +0 -54
  152. package/.claude/skills/agent-prompt/references/agentic-patterns.md +0 -94
  153. package/.claude/skills/agent-prompt/references/anti-patterns.md +0 -140
  154. package/.claude/skills/agent-prompt/references/context-design.md +0 -124
  155. package/.claude/skills/agent-prompt/references/core-principles.md +0 -75
  156. package/.claude/skills/agent-prompt/references/model-guidance.md +0 -118
  157. package/.claude/skills/agent-prompt/references/output-formats.md +0 -98
  158. package/.claude/skills/agent-prompt/references/skill-structure.md +0 -115
  159. package/.claude/skills/agent-prompt/references/system-prompts.md +0 -115
  160. package/.claude/skills/notseer/SKILL.md +0 -131
  161. package/.claude/skills/skill-writer/SKILL.md +0 -140
  162. package/.claude/skills/testing-guidelines/SKILL.md +0 -132
  163. package/.claude/skills/warden-skill/SKILL.md +0 -226
  164. package/.claude/skills/warden-skill/references/config-schema.md +0 -116
  165. package/.dex/config.toml +0 -2
  166. package/.github/workflows/ci.yml +0 -33
  167. package/.github/workflows/release.yml +0 -59
  168. package/.github/workflows/warden.yml +0 -40
  169. package/AGENTS.md +0 -89
  170. package/CONTRIBUTING.md +0 -60
  171. package/SPEC.md +0 -263
  172. package/action.yml +0 -87
  173. package/assets/favicon.png +0 -0
  174. package/assets/warden-icon-bw.svg +0 -5
  175. package/assets/warden-icon-purple.png +0 -0
  176. package/assets/warden-icon-purple.svg +0 -5
  177. package/dist/action/159.index.js +0 -523
  178. package/dist/action/159.index.js.map +0 -1
  179. package/dist/action/action/index.d.ts +0 -2
  180. package/dist/action/action/index.d.ts.map +0 -1
  181. package/dist/action/action/main.d.ts +0 -2
  182. package/dist/action/action/main.d.ts.map +0 -1
  183. package/dist/action/cli/args.d.ts +0 -74
  184. package/dist/action/cli/args.d.ts.map +0 -1
  185. package/dist/action/cli/args.test.d.ts +0 -2
  186. package/dist/action/cli/args.test.d.ts.map +0 -1
  187. package/dist/action/cli/commands/add.d.ts +0 -7
  188. package/dist/action/cli/commands/add.d.ts.map +0 -1
  189. package/dist/action/cli/commands/init.d.ts +0 -10
  190. package/dist/action/cli/commands/init.d.ts.map +0 -1
  191. package/dist/action/cli/commands/init.test.d.ts +0 -2
  192. package/dist/action/cli/commands/init.test.d.ts.map +0 -1
  193. package/dist/action/cli/commands/setup-app/browser.d.ts +0 -9
  194. package/dist/action/cli/commands/setup-app/browser.d.ts.map +0 -1
  195. package/dist/action/cli/commands/setup-app/credentials.d.ts +0 -15
  196. package/dist/action/cli/commands/setup-app/credentials.d.ts.map +0 -1
  197. package/dist/action/cli/commands/setup-app/manifest.d.ts +0 -24
  198. package/dist/action/cli/commands/setup-app/manifest.d.ts.map +0 -1
  199. package/dist/action/cli/commands/setup-app/server.d.ts +0 -28
  200. package/dist/action/cli/commands/setup-app/server.d.ts.map +0 -1
  201. package/dist/action/cli/commands/setup-app.d.ts +0 -11
  202. package/dist/action/cli/commands/setup-app.d.ts.map +0 -1
  203. package/dist/action/cli/commands/sync.d.ts +0 -9
  204. package/dist/action/cli/commands/sync.d.ts.map +0 -1
  205. package/dist/action/cli/context.d.ts +0 -27
  206. package/dist/action/cli/context.d.ts.map +0 -1
  207. package/dist/action/cli/files.d.ts +0 -22
  208. package/dist/action/cli/files.d.ts.map +0 -1
  209. package/dist/action/cli/files.test.d.ts +0 -2
  210. package/dist/action/cli/files.test.d.ts.map +0 -1
  211. package/dist/action/cli/fix.d.ts +0 -41
  212. package/dist/action/cli/fix.d.ts.map +0 -1
  213. package/dist/action/cli/fix.test.d.ts +0 -2
  214. package/dist/action/cli/fix.test.d.ts.map +0 -1
  215. package/dist/action/cli/git.d.ts +0 -73
  216. package/dist/action/cli/git.d.ts.map +0 -1
  217. package/dist/action/cli/git.test.d.ts +0 -2
  218. package/dist/action/cli/git.test.d.ts.map +0 -1
  219. package/dist/action/cli/index.d.ts +0 -3
  220. package/dist/action/cli/index.d.ts.map +0 -1
  221. package/dist/action/cli/main.d.ts +0 -7
  222. package/dist/action/cli/main.d.ts.map +0 -1
  223. package/dist/action/cli/output/box.d.ts +0 -75
  224. package/dist/action/cli/output/box.d.ts.map +0 -1
  225. package/dist/action/cli/output/formatters.d.ts +0 -90
  226. package/dist/action/cli/output/formatters.d.ts.map +0 -1
  227. package/dist/action/cli/output/formatters.test.d.ts +0 -2
  228. package/dist/action/cli/output/formatters.test.d.ts.map +0 -1
  229. package/dist/action/cli/output/icons.d.ts +0 -15
  230. package/dist/action/cli/output/icons.d.ts.map +0 -1
  231. package/dist/action/cli/output/index.d.ts +0 -10
  232. package/dist/action/cli/output/index.d.ts.map +0 -1
  233. package/dist/action/cli/output/ink-runner.d.ts +0 -29
  234. package/dist/action/cli/output/ink-runner.d.ts.map +0 -1
  235. package/dist/action/cli/output/jsonl.d.ts +0 -43
  236. package/dist/action/cli/output/jsonl.d.ts.map +0 -1
  237. package/dist/action/cli/output/jsonl.test.d.ts +0 -2
  238. package/dist/action/cli/output/jsonl.test.d.ts.map +0 -1
  239. package/dist/action/cli/output/reporter.d.ts +0 -108
  240. package/dist/action/cli/output/reporter.d.ts.map +0 -1
  241. package/dist/action/cli/output/tasks.d.ts +0 -89
  242. package/dist/action/cli/output/tasks.d.ts.map +0 -1
  243. package/dist/action/cli/output/tty.d.ts +0 -21
  244. package/dist/action/cli/output/tty.d.ts.map +0 -1
  245. package/dist/action/cli/output/tty.test.d.ts +0 -2
  246. package/dist/action/cli/output/tty.test.d.ts.map +0 -1
  247. package/dist/action/cli/output/verbosity.d.ts +0 -20
  248. package/dist/action/cli/output/verbosity.d.ts.map +0 -1
  249. package/dist/action/cli/output/verbosity.test.d.ts +0 -2
  250. package/dist/action/cli/output/verbosity.test.d.ts.map +0 -1
  251. package/dist/action/cli/terminal.d.ts +0 -19
  252. package/dist/action/cli/terminal.d.ts.map +0 -1
  253. package/dist/action/cli/terminal.test.d.ts +0 -2
  254. package/dist/action/cli/terminal.test.d.ts.map +0 -1
  255. package/dist/action/config/index.d.ts +0 -4
  256. package/dist/action/config/index.d.ts.map +0 -1
  257. package/dist/action/config/loader.d.ts +0 -27
  258. package/dist/action/config/loader.d.ts.map +0 -1
  259. package/dist/action/config/loader.test.d.ts +0 -2
  260. package/dist/action/config/loader.test.d.ts.map +0 -1
  261. package/dist/action/config/schema.d.ts +0 -318
  262. package/dist/action/config/schema.d.ts.map +0 -1
  263. package/dist/action/config/writer.d.ts +0 -11
  264. package/dist/action/config/writer.d.ts.map +0 -1
  265. package/dist/action/config/writer.test.d.ts +0 -2
  266. package/dist/action/config/writer.test.d.ts.map +0 -1
  267. package/dist/action/diff/classify.d.ts +0 -29
  268. package/dist/action/diff/classify.d.ts.map +0 -1
  269. package/dist/action/diff/classify.test.d.ts +0 -2
  270. package/dist/action/diff/classify.test.d.ts.map +0 -1
  271. package/dist/action/diff/coalesce.d.ts +0 -42
  272. package/dist/action/diff/coalesce.d.ts.map +0 -1
  273. package/dist/action/diff/coalesce.test.d.ts +0 -2
  274. package/dist/action/diff/coalesce.test.d.ts.map +0 -1
  275. package/dist/action/diff/context.d.ts +0 -30
  276. package/dist/action/diff/context.d.ts.map +0 -1
  277. package/dist/action/diff/context.test.d.ts +0 -2
  278. package/dist/action/diff/context.test.d.ts.map +0 -1
  279. package/dist/action/diff/index.d.ts +0 -5
  280. package/dist/action/diff/index.d.ts.map +0 -1
  281. package/dist/action/diff/parser.d.ts +0 -52
  282. package/dist/action/diff/parser.d.ts.map +0 -1
  283. package/dist/action/diff/parser.test.d.ts +0 -2
  284. package/dist/action/diff/parser.test.d.ts.map +0 -1
  285. package/dist/action/event/context.d.ts +0 -9
  286. package/dist/action/event/context.d.ts.map +0 -1
  287. package/dist/action/event/index.d.ts +0 -3
  288. package/dist/action/event/index.d.ts.map +0 -1
  289. package/dist/action/event/schedule-context.d.ts +0 -30
  290. package/dist/action/event/schedule-context.d.ts.map +0 -1
  291. package/dist/action/examples/examples.integration.test.d.ts +0 -2
  292. package/dist/action/examples/examples.integration.test.d.ts.map +0 -1
  293. package/dist/action/examples/index.d.ts +0 -50
  294. package/dist/action/examples/index.d.ts.map +0 -1
  295. package/dist/action/examples/index.test.d.ts +0 -2
  296. package/dist/action/examples/index.test.d.ts.map +0 -1
  297. package/dist/action/examples/setup.d.ts +0 -2
  298. package/dist/action/examples/setup.d.ts.map +0 -1
  299. package/dist/action/index.d.ts +0 -11
  300. package/dist/action/index.d.ts.map +0 -1
  301. package/dist/action/index.js +0 -38231
  302. package/dist/action/index.js.map +0 -1
  303. package/dist/action/licenses.txt +0 -992
  304. package/dist/action/main.d.ts +0 -2
  305. package/dist/action/main.d.ts.map +0 -1
  306. package/dist/action/main.js +0 -707
  307. package/dist/action/main.js.map +0 -1
  308. package/dist/action/output/dedup.d.ts +0 -153
  309. package/dist/action/output/dedup.d.ts.map +0 -1
  310. package/dist/action/output/dedup.test.d.ts +0 -2
  311. package/dist/action/output/dedup.test.d.ts.map +0 -1
  312. package/dist/action/output/github-checks.d.ts +0 -106
  313. package/dist/action/output/github-checks.d.ts.map +0 -1
  314. package/dist/action/output/github-checks.test.d.ts +0 -2
  315. package/dist/action/output/github-checks.test.d.ts.map +0 -1
  316. package/dist/action/output/github-issues.d.ts +0 -35
  317. package/dist/action/output/github-issues.d.ts.map +0 -1
  318. package/dist/action/output/index.d.ts +0 -6
  319. package/dist/action/output/index.d.ts.map +0 -1
  320. package/dist/action/output/issue-renderer.d.ts +0 -20
  321. package/dist/action/output/issue-renderer.d.ts.map +0 -1
  322. package/dist/action/output/renderer.d.ts +0 -4
  323. package/dist/action/output/renderer.d.ts.map +0 -1
  324. package/dist/action/output/renderer.test.d.ts +0 -2
  325. package/dist/action/output/renderer.test.d.ts.map +0 -1
  326. package/dist/action/output/stale.d.ts +0 -31
  327. package/dist/action/output/stale.d.ts.map +0 -1
  328. package/dist/action/output/stale.test.d.ts +0 -2
  329. package/dist/action/output/stale.test.d.ts.map +0 -1
  330. package/dist/action/output/types.d.ts +0 -31
  331. package/dist/action/output/types.d.ts.map +0 -1
  332. package/dist/action/package.json +0 -3
  333. package/dist/action/sdk/index.d.ts +0 -2
  334. package/dist/action/sdk/index.d.ts.map +0 -1
  335. package/dist/action/sdk/runner.d.ts +0 -202
  336. package/dist/action/sdk/runner.d.ts.map +0 -1
  337. package/dist/action/sdk/runner.test.d.ts +0 -2
  338. package/dist/action/sdk/runner.test.d.ts.map +0 -1
  339. package/dist/action/skills/index.d.ts +0 -5
  340. package/dist/action/skills/index.d.ts.map +0 -1
  341. package/dist/action/skills/loader.d.ts +0 -111
  342. package/dist/action/skills/loader.d.ts.map +0 -1
  343. package/dist/action/skills/loader.test.d.ts +0 -2
  344. package/dist/action/skills/loader.test.d.ts.map +0 -1
  345. package/dist/action/skills/remote.d.ts +0 -117
  346. package/dist/action/skills/remote.d.ts.map +0 -1
  347. package/dist/action/skills/remote.test.d.ts +0 -2
  348. package/dist/action/skills/remote.test.d.ts.map +0 -1
  349. package/dist/action/sourcemap-register.cjs +0 -1
  350. package/dist/action/triggers/matcher.d.ts +0 -30
  351. package/dist/action/triggers/matcher.d.ts.map +0 -1
  352. package/dist/action/triggers/matcher.test.d.ts +0 -2
  353. package/dist/action/triggers/matcher.test.d.ts.map +0 -1
  354. package/dist/action/types/index.d.ts +0 -269
  355. package/dist/action/types/index.d.ts.map +0 -1
  356. package/dist/action/utils/async.d.ts +0 -5
  357. package/dist/action/utils/async.d.ts.map +0 -1
  358. package/dist/action/utils/index.d.ts +0 -16
  359. package/dist/action/utils/index.d.ts.map +0 -1
  360. package/dist/action/utils/index.test.d.ts +0 -2
  361. package/dist/action/utils/index.test.d.ts.map +0 -1
  362. package/dist/action/utils/version.d.ts +0 -3
  363. package/dist/action/utils/version.d.ts.map +0 -1
  364. package/dist/cli/args.test.d.ts +0 -2
  365. package/dist/cli/args.test.d.ts.map +0 -1
  366. package/dist/cli/args.test.js +0 -392
  367. package/dist/cli/args.test.js.map +0 -1
  368. package/dist/cli/commands/init.test.d.ts +0 -2
  369. package/dist/cli/commands/init.test.d.ts.map +0 -1
  370. package/dist/cli/commands/init.test.js +0 -117
  371. package/dist/cli/commands/init.test.js.map +0 -1
  372. package/dist/cli/files.test.d.ts +0 -2
  373. package/dist/cli/files.test.d.ts.map +0 -1
  374. package/dist/cli/files.test.js +0 -117
  375. package/dist/cli/files.test.js.map +0 -1
  376. package/dist/cli/fix.test.d.ts +0 -2
  377. package/dist/cli/fix.test.d.ts.map +0 -1
  378. package/dist/cli/fix.test.js +0 -251
  379. package/dist/cli/fix.test.js.map +0 -1
  380. package/dist/cli/git.test.d.ts +0 -2
  381. package/dist/cli/git.test.d.ts.map +0 -1
  382. package/dist/cli/git.test.js +0 -96
  383. package/dist/cli/git.test.js.map +0 -1
  384. package/dist/cli/output/formatters.test.d.ts +0 -2
  385. package/dist/cli/output/formatters.test.d.ts.map +0 -1
  386. package/dist/cli/output/formatters.test.js +0 -152
  387. package/dist/cli/output/formatters.test.js.map +0 -1
  388. package/dist/cli/output/jsonl.test.d.ts +0 -2
  389. package/dist/cli/output/jsonl.test.d.ts.map +0 -1
  390. package/dist/cli/output/jsonl.test.js +0 -284
  391. package/dist/cli/output/jsonl.test.js.map +0 -1
  392. package/dist/cli/output/tty.test.d.ts +0 -2
  393. package/dist/cli/output/tty.test.d.ts.map +0 -1
  394. package/dist/cli/output/tty.test.js +0 -105
  395. package/dist/cli/output/tty.test.js.map +0 -1
  396. package/dist/cli/output/verbosity.test.d.ts +0 -2
  397. package/dist/cli/output/verbosity.test.d.ts.map +0 -1
  398. package/dist/cli/output/verbosity.test.js +0 -35
  399. package/dist/cli/output/verbosity.test.js.map +0 -1
  400. package/dist/cli/terminal.test.d.ts +0 -2
  401. package/dist/cli/terminal.test.d.ts.map +0 -1
  402. package/dist/cli/terminal.test.js +0 -123
  403. package/dist/cli/terminal.test.js.map +0 -1
  404. package/dist/config/loader.test.d.ts +0 -2
  405. package/dist/config/loader.test.d.ts.map +0 -1
  406. package/dist/config/loader.test.js +0 -263
  407. package/dist/config/loader.test.js.map +0 -1
  408. package/dist/config/writer.test.d.ts +0 -2
  409. package/dist/config/writer.test.d.ts.map +0 -1
  410. package/dist/config/writer.test.js +0 -98
  411. package/dist/config/writer.test.js.map +0 -1
  412. package/dist/diff/classify.test.d.ts +0 -2
  413. package/dist/diff/classify.test.d.ts.map +0 -1
  414. package/dist/diff/classify.test.js +0 -140
  415. package/dist/diff/classify.test.js.map +0 -1
  416. package/dist/diff/coalesce.test.d.ts +0 -2
  417. package/dist/diff/coalesce.test.d.ts.map +0 -1
  418. package/dist/diff/coalesce.test.js +0 -159
  419. package/dist/diff/coalesce.test.js.map +0 -1
  420. package/dist/diff/context.test.d.ts +0 -2
  421. package/dist/diff/context.test.d.ts.map +0 -1
  422. package/dist/diff/context.test.js +0 -190
  423. package/dist/diff/context.test.js.map +0 -1
  424. package/dist/diff/parser.test.d.ts +0 -2
  425. package/dist/diff/parser.test.d.ts.map +0 -1
  426. package/dist/diff/parser.test.js +0 -178
  427. package/dist/diff/parser.test.js.map +0 -1
  428. package/dist/examples/examples.integration.test.d.ts +0 -2
  429. package/dist/examples/examples.integration.test.d.ts.map +0 -1
  430. package/dist/examples/examples.integration.test.js +0 -55
  431. package/dist/examples/examples.integration.test.js.map +0 -1
  432. package/dist/examples/index.test.d.ts +0 -2
  433. package/dist/examples/index.test.d.ts.map +0 -1
  434. package/dist/examples/index.test.js +0 -88
  435. package/dist/examples/index.test.js.map +0 -1
  436. package/dist/output/dedup.test.d.ts +0 -2
  437. package/dist/output/dedup.test.d.ts.map +0 -1
  438. package/dist/output/dedup.test.js +0 -357
  439. package/dist/output/dedup.test.js.map +0 -1
  440. package/dist/output/github-checks.test.d.ts +0 -2
  441. package/dist/output/github-checks.test.d.ts.map +0 -1
  442. package/dist/output/github-checks.test.js +0 -255
  443. package/dist/output/github-checks.test.js.map +0 -1
  444. package/dist/output/renderer.test.d.ts +0 -2
  445. package/dist/output/renderer.test.d.ts.map +0 -1
  446. package/dist/output/renderer.test.js +0 -645
  447. package/dist/output/renderer.test.js.map +0 -1
  448. package/dist/output/stale.test.d.ts +0 -2
  449. package/dist/output/stale.test.d.ts.map +0 -1
  450. package/dist/output/stale.test.js +0 -330
  451. package/dist/output/stale.test.js.map +0 -1
  452. package/dist/sdk/runner.test.d.ts +0 -2
  453. package/dist/sdk/runner.test.d.ts.map +0 -1
  454. package/dist/sdk/runner.test.js +0 -677
  455. package/dist/sdk/runner.test.js.map +0 -1
  456. package/dist/skills/loader.test.d.ts +0 -2
  457. package/dist/skills/loader.test.d.ts.map +0 -1
  458. package/dist/skills/loader.test.js +0 -241
  459. package/dist/skills/loader.test.js.map +0 -1
  460. package/dist/skills/remote.test.d.ts +0 -2
  461. package/dist/skills/remote.test.d.ts.map +0 -1
  462. package/dist/skills/remote.test.js +0 -582
  463. package/dist/skills/remote.test.js.map +0 -1
  464. package/dist/triggers/matcher.test.d.ts +0 -2
  465. package/dist/triggers/matcher.test.d.ts.map +0 -1
  466. package/dist/triggers/matcher.test.js +0 -234
  467. package/dist/triggers/matcher.test.js.map +0 -1
  468. package/dist/utils/index.test.d.ts +0 -2
  469. package/dist/utils/index.test.d.ts.map +0 -1
  470. package/dist/utils/index.test.js +0 -68
  471. package/dist/utils/index.test.js.map +0 -1
  472. package/docs/astro.config.mjs +0 -43
  473. package/docs/package.json +0 -19
  474. package/docs/pnpm-lock.yaml +0 -4000
  475. package/docs/public/favicon.svg +0 -5
  476. package/docs/src/components/Code.astro +0 -141
  477. package/docs/src/components/PackageManagerTabs.astro +0 -183
  478. package/docs/src/components/Terminal.astro +0 -212
  479. package/docs/src/layouts/Base.astro +0 -380
  480. package/docs/src/pages/cli.astro +0 -167
  481. package/docs/src/pages/config.astro +0 -395
  482. package/docs/src/pages/guide.astro +0 -450
  483. package/docs/src/pages/index.astro +0 -490
  484. package/docs/src/styles/global.css +0 -551
  485. package/docs/src/utils/version.ts +0 -6
  486. package/docs/tsconfig.json +0 -3
  487. package/docs/vercel.json +0 -5
  488. package/eslint.config.js +0 -33
  489. package/src/action/index.ts +0 -1
  490. package/src/action/main.ts +0 -868
  491. package/src/cli/args.test.ts +0 -477
  492. package/src/cli/args.ts +0 -414
  493. package/src/cli/commands/add.ts +0 -447
  494. package/src/cli/commands/init.test.ts +0 -137
  495. package/src/cli/commands/init.ts +0 -134
  496. package/src/cli/commands/setup-app/browser.ts +0 -38
  497. package/src/cli/commands/setup-app/credentials.ts +0 -45
  498. package/src/cli/commands/setup-app/manifest.ts +0 -48
  499. package/src/cli/commands/setup-app/server.ts +0 -172
  500. package/src/cli/commands/setup-app.ts +0 -156
  501. package/src/cli/commands/sync.ts +0 -114
  502. package/src/cli/context.ts +0 -131
  503. package/src/cli/files.test.ts +0 -155
  504. package/src/cli/files.ts +0 -89
  505. package/src/cli/fix.test.ts +0 -310
  506. package/src/cli/fix.ts +0 -387
  507. package/src/cli/git.test.ts +0 -119
  508. package/src/cli/git.ts +0 -318
  509. package/src/cli/index.ts +0 -14
  510. package/src/cli/main.ts +0 -672
  511. package/src/cli/output/box.ts +0 -235
  512. package/src/cli/output/formatters.test.ts +0 -187
  513. package/src/cli/output/formatters.ts +0 -269
  514. package/src/cli/output/icons.ts +0 -19
  515. package/src/cli/output/index.ts +0 -44
  516. package/src/cli/output/ink-runner.tsx +0 -366
  517. package/src/cli/output/jsonl.test.ts +0 -347
  518. package/src/cli/output/jsonl.ts +0 -126
  519. package/src/cli/output/reporter.ts +0 -434
  520. package/src/cli/output/tasks.ts +0 -374
  521. package/src/cli/output/tty.test.ts +0 -117
  522. package/src/cli/output/tty.ts +0 -60
  523. package/src/cli/output/verbosity.test.ts +0 -40
  524. package/src/cli/output/verbosity.ts +0 -31
  525. package/src/cli/terminal.test.ts +0 -148
  526. package/src/cli/terminal.ts +0 -301
  527. package/src/config/index.ts +0 -3
  528. package/src/config/loader.test.ts +0 -313
  529. package/src/config/loader.ts +0 -103
  530. package/src/config/schema.ts +0 -168
  531. package/src/config/writer.test.ts +0 -119
  532. package/src/config/writer.ts +0 -84
  533. package/src/diff/classify.test.ts +0 -162
  534. package/src/diff/classify.ts +0 -92
  535. package/src/diff/coalesce.test.ts +0 -208
  536. package/src/diff/coalesce.ts +0 -133
  537. package/src/diff/context.test.ts +0 -226
  538. package/src/diff/context.ts +0 -201
  539. package/src/diff/index.ts +0 -4
  540. package/src/diff/parser.test.ts +0 -212
  541. package/src/diff/parser.ts +0 -149
  542. package/src/event/context.ts +0 -132
  543. package/src/event/index.ts +0 -2
  544. package/src/event/schedule-context.ts +0 -101
  545. package/src/examples/examples.integration.test.ts +0 -66
  546. package/src/examples/index.test.ts +0 -101
  547. package/src/examples/index.ts +0 -122
  548. package/src/examples/setup.ts +0 -25
  549. package/src/index.ts +0 -115
  550. package/src/output/dedup.test.ts +0 -419
  551. package/src/output/dedup.ts +0 -607
  552. package/src/output/github-checks.test.ts +0 -300
  553. package/src/output/github-checks.ts +0 -476
  554. package/src/output/github-issues.ts +0 -329
  555. package/src/output/index.ts +0 -5
  556. package/src/output/issue-renderer.ts +0 -197
  557. package/src/output/renderer.test.ts +0 -727
  558. package/src/output/renderer.ts +0 -217
  559. package/src/output/stale.test.ts +0 -375
  560. package/src/output/stale.ts +0 -155
  561. package/src/output/types.ts +0 -34
  562. package/src/sdk/index.ts +0 -1
  563. package/src/sdk/runner.test.ts +0 -806
  564. package/src/sdk/runner.ts +0 -1232
  565. package/src/skills/index.ts +0 -36
  566. package/src/skills/loader.test.ts +0 -300
  567. package/src/skills/loader.ts +0 -423
  568. package/src/skills/remote.test.ts +0 -704
  569. package/src/skills/remote.ts +0 -604
  570. package/src/triggers/matcher.test.ts +0 -277
  571. package/src/triggers/matcher.ts +0 -152
  572. package/src/types/index.ts +0 -194
  573. package/src/utils/async.ts +0 -18
  574. package/src/utils/index.test.ts +0 -84
  575. package/src/utils/index.ts +0 -51
  576. package/src/utils/version.ts +0 -17
  577. package/tsconfig.json +0 -25
  578. package/vitest.config.ts +0 -8
  579. package/vitest.integration.config.ts +0 -11
  580. package/warden.toml +0 -19
package/.agents/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md DELETED
@@ -1,49 +0,0 @@
1
- ---
2
- title: Defer Non-Critical Third-Party Libraries
3
- impact: MEDIUM
4
- impactDescription: loads after hydration
5
- tags: bundle, third-party, analytics, defer
6
- ---
7
-
8
- ## Defer Non-Critical Third-Party Libraries
9
-
10
- Analytics, logging, and error tracking don't block user interaction. Load them after hydration.
11
-
12
- **Incorrect (blocks initial bundle):**
13
-
14
- ```tsx
15
- import { Analytics } from '@vercel/analytics/react'
16
-
17
- export default function RootLayout({ children }) {
18
- return (
19
- <html>
20
- <body>
21
- {children}
22
- <Analytics />
23
- </body>
24
- </html>
25
- )
26
- }
27
- ```
28
-
29
- **Correct (loads after hydration):**
30
-
31
- ```tsx
32
- import dynamic from 'next/dynamic'
33
-
34
- const Analytics = dynamic(
35
- () => import('@vercel/analytics/react').then(m => m.Analytics),
36
- { ssr: false }
37
- )
38
-
39
- export default function RootLayout({ children }) {
40
- return (
41
- <html>
42
- <body>
43
- {children}
44
- <Analytics />
45
- </body>
46
- </html>
47
- )
48
- }
49
- ```
package/.agents/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md DELETED
@@ -1,35 +0,0 @@
1
- ---
2
- title: Dynamic Imports for Heavy Components
3
- impact: CRITICAL
4
- impactDescription: directly affects TTI and LCP
5
- tags: bundle, dynamic-import, code-splitting, next-dynamic
6
- ---
7
-
8
- ## Dynamic Imports for Heavy Components
9
-
10
- Use `next/dynamic` to lazy-load large components not needed on initial render.
11
-
12
- **Incorrect (Monaco bundles with main chunk ~300KB):**
13
-
14
- ```tsx
15
- import { MonacoEditor } from './monaco-editor'
16
-
17
- function CodePanel({ code }: { code: string }) {
18
- return <MonacoEditor value={code} />
19
- }
20
- ```
21
-
22
- **Correct (Monaco loads on demand):**
23
-
24
- ```tsx
25
- import dynamic from 'next/dynamic'
26
-
27
- const MonacoEditor = dynamic(
28
- () => import('./monaco-editor').then(m => m.MonacoEditor),
29
- { ssr: false }
30
- )
31
-
32
- function CodePanel({ code }: { code: string }) {
33
- return <MonacoEditor value={code} />
34
- }
35
- ```
package/.agents/skills/vercel-react-best-practices/rules/bundle-preload.md DELETED
@@ -1,50 +0,0 @@
1
- ---
2
- title: Preload Based on User Intent
3
- impact: MEDIUM
4
- impactDescription: reduces perceived latency
5
- tags: bundle, preload, user-intent, hover
6
- ---
7
-
8
- ## Preload Based on User Intent
9
-
10
- Preload heavy bundles before they're needed to reduce perceived latency.
11
-
12
- **Example (preload on hover/focus):**
13
-
14
- ```tsx
15
- function EditorButton({ onClick }: { onClick: () => void }) {
16
- const preload = () => {
17
- if (typeof window !== 'undefined') {
18
- void import('./monaco-editor')
19
- }
20
- }
21
-
22
- return (
23
- <button
24
- onMouseEnter={preload}
25
- onFocus={preload}
26
- onClick={onClick}
27
- >
28
- Open Editor
29
- </button>
30
- )
31
- }
32
- ```
33
-
34
- **Example (preload when feature flag is enabled):**
35
-
36
- ```tsx
37
- function FlagsProvider({ children, flags }: Props) {
38
- useEffect(() => {
39
- if (flags.editorEnabled && typeof window !== 'undefined') {
40
- void import('./monaco-editor').then(mod => mod.init())
41
- }
42
- }, [flags.editorEnabled])
43
-
44
- return <FlagsContext.Provider value={flags}>
45
- {children}
46
- </FlagsContext.Provider>
47
- }
48
- ```
49
-
50
- The `typeof window !== 'undefined'` check prevents bundling preloaded modules for SSR, optimizing server bundle size and build speed.
package/.agents/skills/vercel-react-best-practices/rules/client-event-listeners.md DELETED
@@ -1,74 +0,0 @@
1
- ---
2
- title: Deduplicate Global Event Listeners
3
- impact: LOW
4
- impactDescription: single listener for N components
5
- tags: client, swr, event-listeners, subscription
6
- ---
7
-
8
- ## Deduplicate Global Event Listeners
9
-
10
- Use `useSWRSubscription()` to share global event listeners across component instances.
11
-
12
- **Incorrect (N instances = N listeners):**
13
-
14
- ```tsx
15
- function useKeyboardShortcut(key: string, callback: () => void) {
16
- useEffect(() => {
17
- const handler = (e: KeyboardEvent) => {
18
- if (e.metaKey && e.key === key) {
19
- callback()
20
- }
21
- }
22
- window.addEventListener('keydown', handler)
23
- return () => window.removeEventListener('keydown', handler)
24
- }, [key, callback])
25
- }
26
- ```
27
-
28
- When using the `useKeyboardShortcut` hook multiple times, each instance will register a new listener.
29
-
30
- **Correct (N instances = 1 listener):**
31
-
32
- ```tsx
33
- import useSWRSubscription from 'swr/subscription'
34
-
35
- // Module-level Map to track callbacks per key
36
- const keyCallbacks = new Map<string, Set<() => void>>()
37
-
38
- function useKeyboardShortcut(key: string, callback: () => void) {
39
- // Register this callback in the Map
40
- useEffect(() => {
41
- if (!keyCallbacks.has(key)) {
42
- keyCallbacks.set(key, new Set())
43
- }
44
- keyCallbacks.get(key)!.add(callback)
45
-
46
- return () => {
47
- const set = keyCallbacks.get(key)
48
- if (set) {
49
- set.delete(callback)
50
- if (set.size === 0) {
51
- keyCallbacks.delete(key)
52
- }
53
- }
54
- }
55
- }, [key, callback])
56
-
57
- useSWRSubscription('global-keydown', () => {
58
- const handler = (e: KeyboardEvent) => {
59
- if (e.metaKey && keyCallbacks.has(e.key)) {
60
- keyCallbacks.get(e.key)!.forEach(cb => cb())
61
- }
62
- }
63
- window.addEventListener('keydown', handler)
64
- return () => window.removeEventListener('keydown', handler)
65
- })
66
- }
67
-
68
- function Profile() {
69
- // Multiple shortcuts will share the same listener
70
- useKeyboardShortcut('p', () => { /* ... */ })
71
- useKeyboardShortcut('k', () => { /* ... */ })
72
- // ...
73
- }
74
- ```
package/.agents/skills/vercel-react-best-practices/rules/client-localstorage-schema.md DELETED
@@ -1,71 +0,0 @@
1
- ---
2
- title: Version and Minimize localStorage Data
3
- impact: MEDIUM
4
- impactDescription: prevents schema conflicts, reduces storage size
5
- tags: client, localStorage, storage, versioning, data-minimization
6
- ---
7
-
8
- ## Version and Minimize localStorage Data
9
-
10
- Add version prefix to keys and store only needed fields. Prevents schema conflicts and accidental storage of sensitive data.
11
-
12
- **Incorrect:**
13
-
14
- ```typescript
15
- // No version, stores everything, no error handling
16
- localStorage.setItem('userConfig', JSON.stringify(fullUserObject))
17
- const data = localStorage.getItem('userConfig')
18
- ```
19
-
20
- **Correct:**
21
-
22
- ```typescript
23
- const VERSION = 'v2'
24
-
25
- function saveConfig(config: { theme: string; language: string }) {
26
- try {
27
- localStorage.setItem(`userConfig:${VERSION}`, JSON.stringify(config))
28
- } catch {
29
- // Throws in incognito/private browsing, quota exceeded, or disabled
30
- }
31
- }
32
-
33
- function loadConfig() {
34
- try {
35
- const data = localStorage.getItem(`userConfig:${VERSION}`)
36
- return data ? JSON.parse(data) : null
37
- } catch {
38
- return null
39
- }
40
- }
41
-
42
- // Migration from v1 to v2
43
- function migrate() {
44
- try {
45
- const v1 = localStorage.getItem('userConfig:v1')
46
- if (v1) {
47
- const old = JSON.parse(v1)
48
- saveConfig({ theme: old.darkMode ? 'dark' : 'light', language: old.lang })
49
- localStorage.removeItem('userConfig:v1')
50
- }
51
- } catch {}
52
- }
53
- ```
54
-
55
- **Store minimal fields from server responses:**
56
-
57
- ```typescript
58
- // User object has 20+ fields, only store what UI needs
59
- function cachePrefs(user: FullUser) {
60
- try {
61
- localStorage.setItem('prefs:v1', JSON.stringify({
62
- theme: user.preferences.theme,
63
- notifications: user.preferences.notifications
64
- }))
65
- } catch {}
66
- }
67
- ```
68
-
69
- **Always wrap in try-catch:** `getItem()` and `setItem()` throw in incognito/private browsing (Safari, Firefox), when quota exceeded, or when disabled.
70
-
71
- **Benefits:** Schema evolution via versioning, reduced storage size, prevents storing tokens/PII/internal flags.
package/.agents/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md DELETED
@@ -1,48 +0,0 @@
1
- ---
2
- title: Use Passive Event Listeners for Scrolling Performance
3
- impact: MEDIUM
4
- impactDescription: eliminates scroll delay caused by event listeners
5
- tags: client, event-listeners, scrolling, performance, touch, wheel
6
- ---
7
-
8
- ## Use Passive Event Listeners for Scrolling Performance
9
-
10
- Add `{ passive: true }` to touch and wheel event listeners to enable immediate scrolling. Browsers normally wait for listeners to finish to check if `preventDefault()` is called, causing scroll delay.
11
-
12
- **Incorrect:**
13
-
14
- ```typescript
15
- useEffect(() => {
16
- const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
17
- const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
18
-
19
- document.addEventListener('touchstart', handleTouch)
20
- document.addEventListener('wheel', handleWheel)
21
-
22
- return () => {
23
- document.removeEventListener('touchstart', handleTouch)
24
- document.removeEventListener('wheel', handleWheel)
25
- }
26
- }, [])
27
- ```
28
-
29
- **Correct:**
30
-
31
- ```typescript
32
- useEffect(() => {
33
- const handleTouch = (e: TouchEvent) => console.log(e.touches[0].clientX)
34
- const handleWheel = (e: WheelEvent) => console.log(e.deltaY)
35
-
36
- document.addEventListener('touchstart', handleTouch, { passive: true })
37
- document.addEventListener('wheel', handleWheel, { passive: true })
38
-
39
- return () => {
40
- document.removeEventListener('touchstart', handleTouch)
41
- document.removeEventListener('wheel', handleWheel)
42
- }
43
- }, [])
44
- ```
45
-
46
- **Use passive when:** tracking/analytics, logging, any listener that doesn't call `preventDefault()`.
47
-
48
- **Don't use passive when:** implementing custom swipe gestures, custom zoom controls, or any listener that needs `preventDefault()`.
package/.agents/skills/vercel-react-best-practices/rules/client-swr-dedup.md DELETED
@@ -1,56 +0,0 @@
1
- ---
2
- title: Use SWR for Automatic Deduplication
3
- impact: MEDIUM-HIGH
4
- impactDescription: automatic deduplication
5
- tags: client, swr, deduplication, data-fetching
6
- ---
7
-
8
- ## Use SWR for Automatic Deduplication
9
-
10
- SWR enables request deduplication, caching, and revalidation across component instances.
11
-
12
- **Incorrect (no deduplication, each instance fetches):**
13
-
14
- ```tsx
15
- function UserList() {
16
- const [users, setUsers] = useState([])
17
- useEffect(() => {
18
- fetch('/api/users')
19
- .then(r => r.json())
20
- .then(setUsers)
21
- }, [])
22
- }
23
- ```
24
-
25
- **Correct (multiple instances share one request):**
26
-
27
- ```tsx
28
- import useSWR from 'swr'
29
-
30
- function UserList() {
31
- const { data: users } = useSWR('/api/users', fetcher)
32
- }
33
- ```
34
-
35
- **For immutable data:**
36
-
37
- ```tsx
38
- import { useImmutableSWR } from '@/lib/swr'
39
-
40
- function StaticContent() {
41
- const { data } = useImmutableSWR('/api/config', fetcher)
42
- }
43
- ```
44
-
45
- **For mutations:**
46
-
47
- ```tsx
48
- import { useSWRMutation } from 'swr/mutation'
49
-
50
- function UpdateButton() {
51
- const { trigger } = useSWRMutation('/api/user', updateUser)
52
- return <button onClick={() => trigger()}>Update</button>
53
- }
54
- ```
55
-
56
- Reference: [https://swr.vercel.app](https://swr.vercel.app)
package/.agents/skills/vercel-react-best-practices/rules/js-batch-dom-css.md DELETED
@@ -1,107 +0,0 @@
1
- ---
2
- title: Avoid Layout Thrashing
3
- impact: MEDIUM
4
- impactDescription: prevents forced synchronous layouts and reduces performance bottlenecks
5
- tags: javascript, dom, css, performance, reflow, layout-thrashing
6
- ---
7
-
8
- ## Avoid Layout Thrashing
9
-
10
- Avoid interleaving style writes with layout reads. When you read a layout property (like `offsetWidth`, `getBoundingClientRect()`, or `getComputedStyle()`) between style changes, the browser is forced to trigger a synchronous reflow.
11
-
12
- **This is OK (browser batches style changes):**
13
- ```typescript
14
- function updateElementStyles(element: HTMLElement) {
15
- // Each line invalidates style, but browser batches the recalculation
16
- element.style.width = '100px'
17
- element.style.height = '200px'
18
- element.style.backgroundColor = 'blue'
19
- element.style.border = '1px solid black'
20
- }
21
- ```
22
-
23
- **Incorrect (interleaved reads and writes force reflows):**
24
- ```typescript
25
- function layoutThrashing(element: HTMLElement) {
26
- element.style.width = '100px'
27
- const width = element.offsetWidth // Forces reflow
28
- element.style.height = '200px'
29
- const height = element.offsetHeight // Forces another reflow
30
- }
31
- ```
32
-
33
- **Correct (batch writes, then read once):**
34
- ```typescript
35
- function updateElementStyles(element: HTMLElement) {
36
- // Batch all writes together
37
- element.style.width = '100px'
38
- element.style.height = '200px'
39
- element.style.backgroundColor = 'blue'
40
- element.style.border = '1px solid black'
41
-
42
- // Read after all writes are done (single reflow)
43
- const { width, height } = element.getBoundingClientRect()
44
- }
45
- ```
46
-
47
- **Correct (batch reads, then writes):**
48
- ```typescript
49
- function avoidThrashing(element: HTMLElement) {
50
- // Read phase - all layout queries first
51
- const rect1 = element.getBoundingClientRect()
52
- const offsetWidth = element.offsetWidth
53
- const offsetHeight = element.offsetHeight
54
-
55
- // Write phase - all style changes after
56
- element.style.width = '100px'
57
- element.style.height = '200px'
58
- }
59
- ```
60
-
61
- **Better: use CSS classes**
62
- ```css
63
- .highlighted-box {
64
- width: 100px;
65
- height: 200px;
66
- background-color: blue;
67
- border: 1px solid black;
68
- }
69
- ```
70
- ```typescript
71
- function updateElementStyles(element: HTMLElement) {
72
- element.classList.add('highlighted-box')
73
-
74
- const { width, height } = element.getBoundingClientRect()
75
- }
76
- ```
77
-
78
- **React example:**
79
- ```tsx
80
- // Incorrect: interleaving style changes with layout queries
81
- function Box({ isHighlighted }: { isHighlighted: boolean }) {
82
- const ref = useRef<HTMLDivElement>(null)
83
-
84
- useEffect(() => {
85
- if (ref.current && isHighlighted) {
86
- ref.current.style.width = '100px'
87
- const width = ref.current.offsetWidth // Forces layout
88
- ref.current.style.height = '200px'
89
- }
90
- }, [isHighlighted])
91
-
92
- return <div ref={ref}>Content</div>
93
- }
94
-
95
- // Correct: toggle class
96
- function Box({ isHighlighted }: { isHighlighted: boolean }) {
97
- return (
98
- <div className={isHighlighted ? 'highlighted-box' : ''}>
99
- Content
100
- </div>
101
- )
102
- }
103
- ```
104
-
105
- Prefer CSS classes over inline styles when possible. CSS files are cached by the browser, and classes provide better separation of concerns and are easier to maintain.
106
-
107
- See [this gist](https://gist.github.com/paulirish/5d52fb081b3570c81e3a) and [CSS Triggers](https://csstriggers.com/) for more information on layout-forcing operations.
package/.agents/skills/vercel-react-best-practices/rules/js-cache-function-results.md DELETED
@@ -1,80 +0,0 @@
1
- ---
2
- title: Cache Repeated Function Calls
3
- impact: MEDIUM
4
- impactDescription: avoid redundant computation
5
- tags: javascript, cache, memoization, performance
6
- ---
7
-
8
- ## Cache Repeated Function Calls
9
-
10
- Use a module-level Map to cache function results when the same function is called repeatedly with the same inputs during render.
11
-
12
- **Incorrect (redundant computation):**
13
-
14
- ```typescript
15
- function ProjectList({ projects }: { projects: Project[] }) {
16
- return (
17
- <div>
18
- {projects.map(project => {
19
- // slugify() called 100+ times for same project names
20
- const slug = slugify(project.name)
21
-
22
- return <ProjectCard key={project.id} slug={slug} />
23
- })}
24
- </div>
25
- )
26
- }
27
- ```
28
-
29
- **Correct (cached results):**
30
-
31
- ```typescript
32
- // Module-level cache
33
- const slugifyCache = new Map<string, string>()
34
-
35
- function cachedSlugify(text: string): string {
36
- if (slugifyCache.has(text)) {
37
- return slugifyCache.get(text)!
38
- }
39
- const result = slugify(text)
40
- slugifyCache.set(text, result)
41
- return result
42
- }
43
-
44
- function ProjectList({ projects }: { projects: Project[] }) {
45
- return (
46
- <div>
47
- {projects.map(project => {
48
- // Computed only once per unique project name
49
- const slug = cachedSlugify(project.name)
50
-
51
- return <ProjectCard key={project.id} slug={slug} />
52
- })}
53
- </div>
54
- )
55
- }
56
- ```
57
-
58
- **Simpler pattern for single-value functions:**
59
-
60
- ```typescript
61
- let isLoggedInCache: boolean | null = null
62
-
63
- function isLoggedIn(): boolean {
64
- if (isLoggedInCache !== null) {
65
- return isLoggedInCache
66
- }
67
-
68
- isLoggedInCache = document.cookie.includes('auth=')
69
- return isLoggedInCache
70
- }
71
-
72
- // Clear cache when auth changes
73
- function onAuthChange() {
74
- isLoggedInCache = null
75
- }
76
- ```
77
-
78
- Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
79
-
80
- Reference: [How we made the Vercel Dashboard twice as fast](https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast)
package/.agents/skills/vercel-react-best-practices/rules/js-cache-property-access.md DELETED
@@ -1,28 +0,0 @@
1
- ---
2
- title: Cache Property Access in Loops
3
- impact: LOW-MEDIUM
4
- impactDescription: reduces lookups
5
- tags: javascript, loops, optimization, caching
6
- ---
7
-
8
- ## Cache Property Access in Loops
9
-
10
- Cache object property lookups in hot paths.
11
-
12
- **Incorrect (3 lookups × N iterations):**
13
-
14
- ```typescript
15
- for (let i = 0; i < arr.length; i++) {
16
- process(obj.config.settings.value)
17
- }
18
- ```
19
-
20
- **Correct (1 lookup total):**
21
-
22
- ```typescript
23
- const value = obj.config.settings.value
24
- const len = arr.length
25
- for (let i = 0; i < len; i++) {
26
- process(value)
27
- }
28
- ```
package/.agents/skills/vercel-react-best-practices/rules/js-cache-storage.md DELETED
@@ -1,70 +0,0 @@
1
- ---
2
- title: Cache Storage API Calls
3
- impact: LOW-MEDIUM
4
- impactDescription: reduces expensive I/O
5
- tags: javascript, localStorage, storage, caching, performance
6
- ---
7
-
8
- ## Cache Storage API Calls
9
-
10
- `localStorage`, `sessionStorage`, and `document.cookie` are synchronous and expensive. Cache reads in memory.
11
-
12
- **Incorrect (reads storage on every call):**
13
-
14
- ```typescript
15
- function getTheme() {
16
- return localStorage.getItem('theme') ?? 'light'
17
- }
18
- // Called 10 times = 10 storage reads
19
- ```
20
-
21
- **Correct (Map cache):**
22
-
23
- ```typescript
24
- const storageCache = new Map<string, string | null>()
25
-
26
- function getLocalStorage(key: string) {
27
- if (!storageCache.has(key)) {
28
- storageCache.set(key, localStorage.getItem(key))
29
- }
30
- return storageCache.get(key)
31
- }
32
-
33
- function setLocalStorage(key: string, value: string) {
34
- localStorage.setItem(key, value)
35
- storageCache.set(key, value) // keep cache in sync
36
- }
37
- ```
38
-
39
- Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.
40
-
41
- **Cookie caching:**
42
-
43
- ```typescript
44
- let cookieCache: Record<string, string> | null = null
45
-
46
- function getCookie(name: string) {
47
- if (!cookieCache) {
48
- cookieCache = Object.fromEntries(
49
- document.cookie.split('; ').map(c => c.split('='))
50
- )
51
- }
52
- return cookieCache[name]
53
- }
54
- ```
55
-
56
- **Important (invalidate on external changes):**
57
-
58
- If storage can change externally (another tab, server-set cookies), invalidate cache:
59
-
60
- ```typescript
61
- window.addEventListener('storage', (e) => {
62
- if (e.key) storageCache.delete(e.key)
63
- })
64
-
65
- document.addEventListener('visibilitychange', () => {
66
- if (document.visibilityState === 'visible') {
67
- storageCache.clear()
68
- }
69
- })
70
- ```