@sentry/warden 0.1.0 → 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 (588) 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/icons.d.ts +4 -0
  18. package/dist/cli/output/icons.d.ts.map +1 -1
  19. package/dist/cli/output/icons.js +4 -0
  20. package/dist/cli/output/icons.js.map +1 -1
  21. package/dist/cli/output/ink-runner.d.ts +20 -0
  22. package/dist/cli/output/ink-runner.d.ts.map +1 -1
  23. package/dist/cli/output/ink-runner.js +53 -19
  24. package/dist/cli/output/ink-runner.js.map +1 -1
  25. package/dist/cli/output/tasks.d.ts.map +1 -1
  26. package/dist/cli/output/tasks.js +5 -1
  27. package/dist/cli/output/tasks.js.map +1 -1
  28. package/dist/config/schema.d.ts.map +1 -1
  29. package/dist/config/schema.js +15 -1
  30. package/dist/config/schema.js.map +1 -1
  31. package/dist/diff/coalesce.d.ts +32 -2
  32. package/dist/diff/coalesce.d.ts.map +1 -1
  33. package/dist/diff/coalesce.js +174 -2
  34. package/dist/diff/coalesce.js.map +1 -1
  35. package/dist/output/dedup.d.ts.map +1 -1
  36. package/dist/output/dedup.js +8 -3
  37. package/dist/output/dedup.js.map +1 -1
  38. package/dist/output/renderer.d.ts.map +1 -1
  39. package/dist/output/renderer.js +49 -5
  40. package/dist/output/renderer.js.map +1 -1
  41. package/dist/output/stale.d.ts.map +1 -1
  42. package/dist/output/stale.js +7 -0
  43. package/dist/output/stale.js.map +1 -1
  44. package/dist/output/types.d.ts +15 -1
  45. package/dist/output/types.d.ts.map +1 -1
  46. package/dist/sdk/analyze.d.ts +18 -0
  47. package/dist/sdk/analyze.d.ts.map +1 -0
  48. package/dist/sdk/analyze.js +425 -0
  49. package/dist/sdk/analyze.js.map +1 -0
  50. package/dist/sdk/errors.d.ts +23 -0
  51. package/dist/sdk/errors.d.ts.map +1 -0
  52. package/dist/sdk/errors.js +72 -0
  53. package/dist/sdk/errors.js.map +1 -0
  54. package/dist/sdk/extract.d.ts +44 -0
  55. package/dist/sdk/extract.d.ts.map +1 -0
  56. package/dist/sdk/extract.js +224 -0
  57. package/dist/sdk/extract.js.map +1 -0
  58. package/dist/sdk/prepare.d.ts +13 -0
  59. package/dist/sdk/prepare.d.ts.map +1 -0
  60. package/dist/sdk/prepare.js +73 -0
  61. package/dist/sdk/prepare.js.map +1 -0
  62. package/dist/sdk/prompt.d.ts +30 -0
  63. package/dist/sdk/prompt.d.ts.map +1 -0
  64. package/dist/sdk/prompt.js +109 -0
  65. package/dist/sdk/prompt.js.map +1 -0
  66. package/dist/sdk/retry.d.ts +12 -0
  67. package/dist/sdk/retry.d.ts.map +1 -0
  68. package/dist/sdk/retry.js +31 -0
  69. package/dist/sdk/retry.js.map +1 -0
  70. package/dist/sdk/runner.d.ts +22 -199
  71. package/dist/sdk/runner.d.ts.map +1 -1
  72. package/dist/sdk/runner.js +26 -884
  73. package/dist/sdk/runner.js.map +1 -1
  74. package/dist/sdk/types.d.ts +127 -0
  75. package/dist/sdk/types.d.ts.map +1 -0
  76. package/dist/sdk/types.js +5 -0
  77. package/dist/sdk/types.js.map +1 -0
  78. package/dist/sdk/usage.d.ts +20 -0
  79. package/dist/sdk/usage.d.ts.map +1 -0
  80. package/dist/sdk/usage.js +44 -0
  81. package/dist/sdk/usage.js.map +1 -0
  82. package/dist/skills/remote.d.ts.map +1 -1
  83. package/dist/skills/remote.js +3 -7
  84. package/dist/skills/remote.js.map +1 -1
  85. package/dist/types/index.d.ts +1 -0
  86. package/dist/types/index.d.ts.map +1 -1
  87. package/dist/types/index.js +2 -0
  88. package/dist/types/index.js.map +1 -1
  89. package/dist/utils/exec.d.ts +61 -0
  90. package/dist/utils/exec.d.ts.map +1 -0
  91. package/dist/utils/exec.js +111 -0
  92. package/dist/utils/exec.js.map +1 -0
  93. package/dist/utils/index.d.ts +2 -0
  94. package/dist/utils/index.d.ts.map +1 -1
  95. package/dist/utils/index.js +1 -0
  96. package/dist/utils/index.js.map +1 -1
  97. package/package.json +15 -16
  98. package/.agents/skills/find-bugs/SKILL.md +0 -75
  99. package/.agents/skills/vercel-react-best-practices/AGENTS.md +0 -2934
  100. package/.agents/skills/vercel-react-best-practices/SKILL.md +0 -136
  101. package/.agents/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +0 -55
  102. package/.agents/skills/vercel-react-best-practices/rules/advanced-init-once.md +0 -42
  103. package/.agents/skills/vercel-react-best-practices/rules/advanced-use-latest.md +0 -39
  104. package/.agents/skills/vercel-react-best-practices/rules/async-api-routes.md +0 -38
  105. package/.agents/skills/vercel-react-best-practices/rules/async-defer-await.md +0 -80
  106. package/.agents/skills/vercel-react-best-practices/rules/async-dependencies.md +0 -51
  107. package/.agents/skills/vercel-react-best-practices/rules/async-parallel.md +0 -28
  108. package/.agents/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +0 -99
  109. package/.agents/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +0 -59
  110. package/.agents/skills/vercel-react-best-practices/rules/bundle-conditional.md +0 -31
  111. package/.agents/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +0 -49
  112. package/.agents/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +0 -35
  113. package/.agents/skills/vercel-react-best-practices/rules/bundle-preload.md +0 -50
  114. package/.agents/skills/vercel-react-best-practices/rules/client-event-listeners.md +0 -74
  115. package/.agents/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +0 -71
  116. package/.agents/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +0 -48
  117. package/.agents/skills/vercel-react-best-practices/rules/client-swr-dedup.md +0 -56
  118. package/.agents/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +0 -107
  119. package/.agents/skills/vercel-react-best-practices/rules/js-cache-function-results.md +0 -80
  120. package/.agents/skills/vercel-react-best-practices/rules/js-cache-property-access.md +0 -28
  121. package/.agents/skills/vercel-react-best-practices/rules/js-cache-storage.md +0 -70
  122. package/.agents/skills/vercel-react-best-practices/rules/js-combine-iterations.md +0 -32
  123. package/.agents/skills/vercel-react-best-practices/rules/js-early-exit.md +0 -50
  124. package/.agents/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +0 -45
  125. package/.agents/skills/vercel-react-best-practices/rules/js-index-maps.md +0 -37
  126. package/.agents/skills/vercel-react-best-practices/rules/js-length-check-first.md +0 -49
  127. package/.agents/skills/vercel-react-best-practices/rules/js-min-max-loop.md +0 -82
  128. package/.agents/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +0 -24
  129. package/.agents/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +0 -57
  130. package/.agents/skills/vercel-react-best-practices/rules/rendering-activity.md +0 -26
  131. package/.agents/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +0 -47
  132. package/.agents/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +0 -40
  133. package/.agents/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +0 -38
  134. package/.agents/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +0 -46
  135. package/.agents/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +0 -82
  136. package/.agents/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +0 -30
  137. package/.agents/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +0 -28
  138. package/.agents/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +0 -75
  139. package/.agents/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +0 -39
  140. package/.agents/skills/vercel-react-best-practices/rules/rerender-dependencies.md +0 -45
  141. package/.agents/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +0 -40
  142. package/.agents/skills/vercel-react-best-practices/rules/rerender-derived-state.md +0 -29
  143. package/.agents/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +0 -74
  144. package/.agents/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +0 -58
  145. package/.agents/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +0 -38
  146. package/.agents/skills/vercel-react-best-practices/rules/rerender-memo.md +0 -44
  147. package/.agents/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +0 -45
  148. package/.agents/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +0 -35
  149. package/.agents/skills/vercel-react-best-practices/rules/rerender-transitions.md +0 -40
  150. package/.agents/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +0 -73
  151. package/.agents/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +0 -73
  152. package/.agents/skills/vercel-react-best-practices/rules/server-auth-actions.md +0 -96
  153. package/.agents/skills/vercel-react-best-practices/rules/server-cache-lru.md +0 -41
  154. package/.agents/skills/vercel-react-best-practices/rules/server-cache-react.md +0 -76
  155. package/.agents/skills/vercel-react-best-practices/rules/server-dedup-props.md +0 -65
  156. package/.agents/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +0 -83
  157. package/.agents/skills/vercel-react-best-practices/rules/server-serialization.md +0 -38
  158. package/.claude/settings.json +0 -57
  159. package/.claude/skills/agent-prompt/SKILL.md +0 -54
  160. package/.claude/skills/agent-prompt/references/agentic-patterns.md +0 -94
  161. package/.claude/skills/agent-prompt/references/anti-patterns.md +0 -140
  162. package/.claude/skills/agent-prompt/references/context-design.md +0 -124
  163. package/.claude/skills/agent-prompt/references/core-principles.md +0 -75
  164. package/.claude/skills/agent-prompt/references/model-guidance.md +0 -118
  165. package/.claude/skills/agent-prompt/references/output-formats.md +0 -98
  166. package/.claude/skills/agent-prompt/references/skill-structure.md +0 -115
  167. package/.claude/skills/agent-prompt/references/system-prompts.md +0 -115
  168. package/.claude/skills/notseer/SKILL.md +0 -131
  169. package/.claude/skills/skill-writer/SKILL.md +0 -140
  170. package/.claude/skills/testing-guidelines/SKILL.md +0 -132
  171. package/.claude/skills/warden-skill/SKILL.md +0 -250
  172. package/.claude/skills/warden-skill/references/config-schema.md +0 -133
  173. package/.dex/config.toml +0 -2
  174. package/.github/workflows/ci.yml +0 -33
  175. package/.github/workflows/release.yml +0 -59
  176. package/.github/workflows/warden.yml +0 -40
  177. package/AGENTS.md +0 -89
  178. package/CONTRIBUTING.md +0 -60
  179. package/SPEC.md +0 -263
  180. package/action.yml +0 -87
  181. package/assets/favicon.png +0 -0
  182. package/assets/warden-icon-bw.svg +0 -5
  183. package/assets/warden-icon-purple.png +0 -0
  184. package/assets/warden-icon-purple.svg +0 -5
  185. package/dist/action/159.index.js +0 -523
  186. package/dist/action/159.index.js.map +0 -1
  187. package/dist/action/action/index.d.ts +0 -2
  188. package/dist/action/action/index.d.ts.map +0 -1
  189. package/dist/action/action/main.d.ts +0 -2
  190. package/dist/action/action/main.d.ts.map +0 -1
  191. package/dist/action/cli/args.d.ts +0 -74
  192. package/dist/action/cli/args.d.ts.map +0 -1
  193. package/dist/action/cli/args.test.d.ts +0 -2
  194. package/dist/action/cli/args.test.d.ts.map +0 -1
  195. package/dist/action/cli/commands/add.d.ts +0 -7
  196. package/dist/action/cli/commands/add.d.ts.map +0 -1
  197. package/dist/action/cli/commands/init.d.ts +0 -10
  198. package/dist/action/cli/commands/init.d.ts.map +0 -1
  199. package/dist/action/cli/commands/init.test.d.ts +0 -2
  200. package/dist/action/cli/commands/init.test.d.ts.map +0 -1
  201. package/dist/action/cli/commands/setup-app/browser.d.ts +0 -9
  202. package/dist/action/cli/commands/setup-app/browser.d.ts.map +0 -1
  203. package/dist/action/cli/commands/setup-app/credentials.d.ts +0 -15
  204. package/dist/action/cli/commands/setup-app/credentials.d.ts.map +0 -1
  205. package/dist/action/cli/commands/setup-app/manifest.d.ts +0 -24
  206. package/dist/action/cli/commands/setup-app/manifest.d.ts.map +0 -1
  207. package/dist/action/cli/commands/setup-app/server.d.ts +0 -28
  208. package/dist/action/cli/commands/setup-app/server.d.ts.map +0 -1
  209. package/dist/action/cli/commands/setup-app.d.ts +0 -11
  210. package/dist/action/cli/commands/setup-app.d.ts.map +0 -1
  211. package/dist/action/cli/commands/sync.d.ts +0 -9
  212. package/dist/action/cli/commands/sync.d.ts.map +0 -1
  213. package/dist/action/cli/context.d.ts +0 -27
  214. package/dist/action/cli/context.d.ts.map +0 -1
  215. package/dist/action/cli/files.d.ts +0 -22
  216. package/dist/action/cli/files.d.ts.map +0 -1
  217. package/dist/action/cli/files.test.d.ts +0 -2
  218. package/dist/action/cli/files.test.d.ts.map +0 -1
  219. package/dist/action/cli/fix.d.ts +0 -41
  220. package/dist/action/cli/fix.d.ts.map +0 -1
  221. package/dist/action/cli/fix.test.d.ts +0 -2
  222. package/dist/action/cli/fix.test.d.ts.map +0 -1
  223. package/dist/action/cli/git.d.ts +0 -73
  224. package/dist/action/cli/git.d.ts.map +0 -1
  225. package/dist/action/cli/git.test.d.ts +0 -2
  226. package/dist/action/cli/git.test.d.ts.map +0 -1
  227. package/dist/action/cli/index.d.ts +0 -3
  228. package/dist/action/cli/index.d.ts.map +0 -1
  229. package/dist/action/cli/main.d.ts +0 -7
  230. package/dist/action/cli/main.d.ts.map +0 -1
  231. package/dist/action/cli/output/box.d.ts +0 -75
  232. package/dist/action/cli/output/box.d.ts.map +0 -1
  233. package/dist/action/cli/output/formatters.d.ts +0 -90
  234. package/dist/action/cli/output/formatters.d.ts.map +0 -1
  235. package/dist/action/cli/output/formatters.test.d.ts +0 -2
  236. package/dist/action/cli/output/formatters.test.d.ts.map +0 -1
  237. package/dist/action/cli/output/icons.d.ts +0 -11
  238. package/dist/action/cli/output/icons.d.ts.map +0 -1
  239. package/dist/action/cli/output/index.d.ts +0 -10
  240. package/dist/action/cli/output/index.d.ts.map +0 -1
  241. package/dist/action/cli/output/ink-runner.d.ts +0 -9
  242. package/dist/action/cli/output/ink-runner.d.ts.map +0 -1
  243. package/dist/action/cli/output/jsonl.d.ts +0 -43
  244. package/dist/action/cli/output/jsonl.d.ts.map +0 -1
  245. package/dist/action/cli/output/jsonl.test.d.ts +0 -2
  246. package/dist/action/cli/output/jsonl.test.d.ts.map +0 -1
  247. package/dist/action/cli/output/reporter.d.ts +0 -108
  248. package/dist/action/cli/output/reporter.d.ts.map +0 -1
  249. package/dist/action/cli/output/tasks.d.ts +0 -89
  250. package/dist/action/cli/output/tasks.d.ts.map +0 -1
  251. package/dist/action/cli/output/tty.d.ts +0 -21
  252. package/dist/action/cli/output/tty.d.ts.map +0 -1
  253. package/dist/action/cli/output/tty.test.d.ts +0 -2
  254. package/dist/action/cli/output/tty.test.d.ts.map +0 -1
  255. package/dist/action/cli/output/verbosity.d.ts +0 -20
  256. package/dist/action/cli/output/verbosity.d.ts.map +0 -1
  257. package/dist/action/cli/output/verbosity.test.d.ts +0 -2
  258. package/dist/action/cli/output/verbosity.test.d.ts.map +0 -1
  259. package/dist/action/cli/terminal.d.ts +0 -19
  260. package/dist/action/cli/terminal.d.ts.map +0 -1
  261. package/dist/action/cli/terminal.test.d.ts +0 -2
  262. package/dist/action/cli/terminal.test.d.ts.map +0 -1
  263. package/dist/action/config/index.d.ts +0 -4
  264. package/dist/action/config/index.d.ts.map +0 -1
  265. package/dist/action/config/loader.d.ts +0 -27
  266. package/dist/action/config/loader.d.ts.map +0 -1
  267. package/dist/action/config/loader.test.d.ts +0 -2
  268. package/dist/action/config/loader.test.d.ts.map +0 -1
  269. package/dist/action/config/schema.d.ts +0 -318
  270. package/dist/action/config/schema.d.ts.map +0 -1
  271. package/dist/action/config/writer.d.ts +0 -11
  272. package/dist/action/config/writer.d.ts.map +0 -1
  273. package/dist/action/config/writer.test.d.ts +0 -2
  274. package/dist/action/config/writer.test.d.ts.map +0 -1
  275. package/dist/action/diff/classify.d.ts +0 -29
  276. package/dist/action/diff/classify.d.ts.map +0 -1
  277. package/dist/action/diff/classify.test.d.ts +0 -2
  278. package/dist/action/diff/classify.test.d.ts.map +0 -1
  279. package/dist/action/diff/coalesce.d.ts +0 -42
  280. package/dist/action/diff/coalesce.d.ts.map +0 -1
  281. package/dist/action/diff/coalesce.test.d.ts +0 -2
  282. package/dist/action/diff/coalesce.test.d.ts.map +0 -1
  283. package/dist/action/diff/context.d.ts +0 -30
  284. package/dist/action/diff/context.d.ts.map +0 -1
  285. package/dist/action/diff/context.test.d.ts +0 -2
  286. package/dist/action/diff/context.test.d.ts.map +0 -1
  287. package/dist/action/diff/index.d.ts +0 -5
  288. package/dist/action/diff/index.d.ts.map +0 -1
  289. package/dist/action/diff/parser.d.ts +0 -52
  290. package/dist/action/diff/parser.d.ts.map +0 -1
  291. package/dist/action/diff/parser.test.d.ts +0 -2
  292. package/dist/action/diff/parser.test.d.ts.map +0 -1
  293. package/dist/action/event/context.d.ts +0 -9
  294. package/dist/action/event/context.d.ts.map +0 -1
  295. package/dist/action/event/index.d.ts +0 -3
  296. package/dist/action/event/index.d.ts.map +0 -1
  297. package/dist/action/event/schedule-context.d.ts +0 -30
  298. package/dist/action/event/schedule-context.d.ts.map +0 -1
  299. package/dist/action/examples/examples.integration.test.d.ts +0 -2
  300. package/dist/action/examples/examples.integration.test.d.ts.map +0 -1
  301. package/dist/action/examples/index.d.ts +0 -50
  302. package/dist/action/examples/index.d.ts.map +0 -1
  303. package/dist/action/examples/index.test.d.ts +0 -2
  304. package/dist/action/examples/index.test.d.ts.map +0 -1
  305. package/dist/action/examples/setup.d.ts +0 -2
  306. package/dist/action/examples/setup.d.ts.map +0 -1
  307. package/dist/action/index.d.ts +0 -11
  308. package/dist/action/index.d.ts.map +0 -1
  309. package/dist/action/index.js +0 -38231
  310. package/dist/action/index.js.map +0 -1
  311. package/dist/action/licenses.txt +0 -992
  312. package/dist/action/main.d.ts +0 -2
  313. package/dist/action/main.d.ts.map +0 -1
  314. package/dist/action/main.js +0 -707
  315. package/dist/action/main.js.map +0 -1
  316. package/dist/action/output/dedup.d.ts +0 -153
  317. package/dist/action/output/dedup.d.ts.map +0 -1
  318. package/dist/action/output/dedup.test.d.ts +0 -2
  319. package/dist/action/output/dedup.test.d.ts.map +0 -1
  320. package/dist/action/output/github-checks.d.ts +0 -106
  321. package/dist/action/output/github-checks.d.ts.map +0 -1
  322. package/dist/action/output/github-checks.test.d.ts +0 -2
  323. package/dist/action/output/github-checks.test.d.ts.map +0 -1
  324. package/dist/action/output/github-issues.d.ts +0 -35
  325. package/dist/action/output/github-issues.d.ts.map +0 -1
  326. package/dist/action/output/index.d.ts +0 -6
  327. package/dist/action/output/index.d.ts.map +0 -1
  328. package/dist/action/output/issue-renderer.d.ts +0 -20
  329. package/dist/action/output/issue-renderer.d.ts.map +0 -1
  330. package/dist/action/output/renderer.d.ts +0 -4
  331. package/dist/action/output/renderer.d.ts.map +0 -1
  332. package/dist/action/output/renderer.test.d.ts +0 -2
  333. package/dist/action/output/renderer.test.d.ts.map +0 -1
  334. package/dist/action/output/stale.d.ts +0 -31
  335. package/dist/action/output/stale.d.ts.map +0 -1
  336. package/dist/action/output/stale.test.d.ts +0 -2
  337. package/dist/action/output/stale.test.d.ts.map +0 -1
  338. package/dist/action/output/types.d.ts +0 -31
  339. package/dist/action/output/types.d.ts.map +0 -1
  340. package/dist/action/package.json +0 -3
  341. package/dist/action/sdk/index.d.ts +0 -2
  342. package/dist/action/sdk/index.d.ts.map +0 -1
  343. package/dist/action/sdk/runner.d.ts +0 -202
  344. package/dist/action/sdk/runner.d.ts.map +0 -1
  345. package/dist/action/sdk/runner.test.d.ts +0 -2
  346. package/dist/action/sdk/runner.test.d.ts.map +0 -1
  347. package/dist/action/skills/index.d.ts +0 -5
  348. package/dist/action/skills/index.d.ts.map +0 -1
  349. package/dist/action/skills/loader.d.ts +0 -111
  350. package/dist/action/skills/loader.d.ts.map +0 -1
  351. package/dist/action/skills/loader.test.d.ts +0 -2
  352. package/dist/action/skills/loader.test.d.ts.map +0 -1
  353. package/dist/action/skills/remote.d.ts +0 -117
  354. package/dist/action/skills/remote.d.ts.map +0 -1
  355. package/dist/action/skills/remote.test.d.ts +0 -2
  356. package/dist/action/skills/remote.test.d.ts.map +0 -1
  357. package/dist/action/sourcemap-register.cjs +0 -1
  358. package/dist/action/triggers/matcher.d.ts +0 -30
  359. package/dist/action/triggers/matcher.d.ts.map +0 -1
  360. package/dist/action/triggers/matcher.test.d.ts +0 -2
  361. package/dist/action/triggers/matcher.test.d.ts.map +0 -1
  362. package/dist/action/types/index.d.ts +0 -269
  363. package/dist/action/types/index.d.ts.map +0 -1
  364. package/dist/action/utils/async.d.ts +0 -5
  365. package/dist/action/utils/async.d.ts.map +0 -1
  366. package/dist/action/utils/index.d.ts +0 -16
  367. package/dist/action/utils/index.d.ts.map +0 -1
  368. package/dist/action/utils/index.test.d.ts +0 -2
  369. package/dist/action/utils/index.test.d.ts.map +0 -1
  370. package/dist/action/utils/version.d.ts +0 -3
  371. package/dist/action/utils/version.d.ts.map +0 -1
  372. package/dist/cli/args.test.d.ts +0 -2
  373. package/dist/cli/args.test.d.ts.map +0 -1
  374. package/dist/cli/args.test.js +0 -392
  375. package/dist/cli/args.test.js.map +0 -1
  376. package/dist/cli/commands/init.test.d.ts +0 -2
  377. package/dist/cli/commands/init.test.d.ts.map +0 -1
  378. package/dist/cli/commands/init.test.js +0 -117
  379. package/dist/cli/commands/init.test.js.map +0 -1
  380. package/dist/cli/files.test.d.ts +0 -2
  381. package/dist/cli/files.test.d.ts.map +0 -1
  382. package/dist/cli/files.test.js +0 -117
  383. package/dist/cli/files.test.js.map +0 -1
  384. package/dist/cli/fix.test.d.ts +0 -2
  385. package/dist/cli/fix.test.d.ts.map +0 -1
  386. package/dist/cli/fix.test.js +0 -251
  387. package/dist/cli/fix.test.js.map +0 -1
  388. package/dist/cli/git.test.d.ts +0 -2
  389. package/dist/cli/git.test.d.ts.map +0 -1
  390. package/dist/cli/git.test.js +0 -96
  391. package/dist/cli/git.test.js.map +0 -1
  392. package/dist/cli/output/formatters.test.d.ts +0 -2
  393. package/dist/cli/output/formatters.test.d.ts.map +0 -1
  394. package/dist/cli/output/formatters.test.js +0 -152
  395. package/dist/cli/output/formatters.test.js.map +0 -1
  396. package/dist/cli/output/jsonl.test.d.ts +0 -2
  397. package/dist/cli/output/jsonl.test.d.ts.map +0 -1
  398. package/dist/cli/output/jsonl.test.js +0 -284
  399. package/dist/cli/output/jsonl.test.js.map +0 -1
  400. package/dist/cli/output/tty.test.d.ts +0 -2
  401. package/dist/cli/output/tty.test.d.ts.map +0 -1
  402. package/dist/cli/output/tty.test.js +0 -105
  403. package/dist/cli/output/tty.test.js.map +0 -1
  404. package/dist/cli/output/verbosity.test.d.ts +0 -2
  405. package/dist/cli/output/verbosity.test.d.ts.map +0 -1
  406. package/dist/cli/output/verbosity.test.js +0 -35
  407. package/dist/cli/output/verbosity.test.js.map +0 -1
  408. package/dist/cli/terminal.test.d.ts +0 -2
  409. package/dist/cli/terminal.test.d.ts.map +0 -1
  410. package/dist/cli/terminal.test.js +0 -123
  411. package/dist/cli/terminal.test.js.map +0 -1
  412. package/dist/config/loader.test.d.ts +0 -2
  413. package/dist/config/loader.test.d.ts.map +0 -1
  414. package/dist/config/loader.test.js +0 -263
  415. package/dist/config/loader.test.js.map +0 -1
  416. package/dist/config/writer.test.d.ts +0 -2
  417. package/dist/config/writer.test.d.ts.map +0 -1
  418. package/dist/config/writer.test.js +0 -98
  419. package/dist/config/writer.test.js.map +0 -1
  420. package/dist/diff/classify.test.d.ts +0 -2
  421. package/dist/diff/classify.test.d.ts.map +0 -1
  422. package/dist/diff/classify.test.js +0 -140
  423. package/dist/diff/classify.test.js.map +0 -1
  424. package/dist/diff/coalesce.test.d.ts +0 -2
  425. package/dist/diff/coalesce.test.d.ts.map +0 -1
  426. package/dist/diff/coalesce.test.js +0 -159
  427. package/dist/diff/coalesce.test.js.map +0 -1
  428. package/dist/diff/context.test.d.ts +0 -2
  429. package/dist/diff/context.test.d.ts.map +0 -1
  430. package/dist/diff/context.test.js +0 -190
  431. package/dist/diff/context.test.js.map +0 -1
  432. package/dist/diff/parser.test.d.ts +0 -2
  433. package/dist/diff/parser.test.d.ts.map +0 -1
  434. package/dist/diff/parser.test.js +0 -178
  435. package/dist/diff/parser.test.js.map +0 -1
  436. package/dist/examples/examples.integration.test.d.ts +0 -2
  437. package/dist/examples/examples.integration.test.d.ts.map +0 -1
  438. package/dist/examples/examples.integration.test.js +0 -55
  439. package/dist/examples/examples.integration.test.js.map +0 -1
  440. package/dist/examples/index.test.d.ts +0 -2
  441. package/dist/examples/index.test.d.ts.map +0 -1
  442. package/dist/examples/index.test.js +0 -88
  443. package/dist/examples/index.test.js.map +0 -1
  444. package/dist/output/dedup.test.d.ts +0 -2
  445. package/dist/output/dedup.test.d.ts.map +0 -1
  446. package/dist/output/dedup.test.js +0 -357
  447. package/dist/output/dedup.test.js.map +0 -1
  448. package/dist/output/github-checks.test.d.ts +0 -2
  449. package/dist/output/github-checks.test.d.ts.map +0 -1
  450. package/dist/output/github-checks.test.js +0 -255
  451. package/dist/output/github-checks.test.js.map +0 -1
  452. package/dist/output/renderer.test.d.ts +0 -2
  453. package/dist/output/renderer.test.d.ts.map +0 -1
  454. package/dist/output/renderer.test.js +0 -645
  455. package/dist/output/renderer.test.js.map +0 -1
  456. package/dist/output/stale.test.d.ts +0 -2
  457. package/dist/output/stale.test.d.ts.map +0 -1
  458. package/dist/output/stale.test.js +0 -330
  459. package/dist/output/stale.test.js.map +0 -1
  460. package/dist/sdk/runner.test.d.ts +0 -2
  461. package/dist/sdk/runner.test.d.ts.map +0 -1
  462. package/dist/sdk/runner.test.js +0 -677
  463. package/dist/sdk/runner.test.js.map +0 -1
  464. package/dist/skills/loader.test.d.ts +0 -2
  465. package/dist/skills/loader.test.d.ts.map +0 -1
  466. package/dist/skills/loader.test.js +0 -241
  467. package/dist/skills/loader.test.js.map +0 -1
  468. package/dist/skills/remote.test.d.ts +0 -2
  469. package/dist/skills/remote.test.d.ts.map +0 -1
  470. package/dist/skills/remote.test.js +0 -582
  471. package/dist/skills/remote.test.js.map +0 -1
  472. package/dist/triggers/matcher.test.d.ts +0 -2
  473. package/dist/triggers/matcher.test.d.ts.map +0 -1
  474. package/dist/triggers/matcher.test.js +0 -234
  475. package/dist/triggers/matcher.test.js.map +0 -1
  476. package/dist/utils/index.test.d.ts +0 -2
  477. package/dist/utils/index.test.d.ts.map +0 -1
  478. package/dist/utils/index.test.js +0 -68
  479. package/dist/utils/index.test.js.map +0 -1
  480. package/docs/astro.config.mjs +0 -43
  481. package/docs/package.json +0 -19
  482. package/docs/pnpm-lock.yaml +0 -4000
  483. package/docs/public/favicon.svg +0 -5
  484. package/docs/src/components/Code.astro +0 -141
  485. package/docs/src/components/PackageManagerTabs.astro +0 -183
  486. package/docs/src/components/Terminal.astro +0 -212
  487. package/docs/src/layouts/Base.astro +0 -380
  488. package/docs/src/pages/cli.astro +0 -167
  489. package/docs/src/pages/config.astro +0 -395
  490. package/docs/src/pages/guide.astro +0 -450
  491. package/docs/src/pages/index.astro +0 -490
  492. package/docs/src/styles/global.css +0 -551
  493. package/docs/src/utils/version.ts +0 -6
  494. package/docs/tsconfig.json +0 -3
  495. package/docs/vercel.json +0 -5
  496. package/eslint.config.js +0 -33
  497. package/src/action/index.ts +0 -1
  498. package/src/action/main.ts +0 -868
  499. package/src/cli/args.test.ts +0 -477
  500. package/src/cli/args.ts +0 -414
  501. package/src/cli/commands/add.ts +0 -447
  502. package/src/cli/commands/init.test.ts +0 -137
  503. package/src/cli/commands/init.ts +0 -134
  504. package/src/cli/commands/setup-app/browser.ts +0 -38
  505. package/src/cli/commands/setup-app/credentials.ts +0 -45
  506. package/src/cli/commands/setup-app/manifest.ts +0 -48
  507. package/src/cli/commands/setup-app/server.ts +0 -172
  508. package/src/cli/commands/setup-app.ts +0 -156
  509. package/src/cli/commands/sync.ts +0 -114
  510. package/src/cli/context.ts +0 -131
  511. package/src/cli/files.test.ts +0 -155
  512. package/src/cli/files.ts +0 -89
  513. package/src/cli/fix.test.ts +0 -310
  514. package/src/cli/fix.ts +0 -387
  515. package/src/cli/git.test.ts +0 -119
  516. package/src/cli/git.ts +0 -318
  517. package/src/cli/index.ts +0 -14
  518. package/src/cli/main.ts +0 -672
  519. package/src/cli/output/box.ts +0 -235
  520. package/src/cli/output/formatters.test.ts +0 -187
  521. package/src/cli/output/formatters.ts +0 -269
  522. package/src/cli/output/icons.ts +0 -13
  523. package/src/cli/output/index.ts +0 -44
  524. package/src/cli/output/ink-runner.tsx +0 -337
  525. package/src/cli/output/jsonl.test.ts +0 -347
  526. package/src/cli/output/jsonl.ts +0 -126
  527. package/src/cli/output/reporter.ts +0 -434
  528. package/src/cli/output/tasks.ts +0 -374
  529. package/src/cli/output/tty.test.ts +0 -117
  530. package/src/cli/output/tty.ts +0 -60
  531. package/src/cli/output/verbosity.test.ts +0 -40
  532. package/src/cli/output/verbosity.ts +0 -31
  533. package/src/cli/terminal.test.ts +0 -148
  534. package/src/cli/terminal.ts +0 -301
  535. package/src/config/index.ts +0 -3
  536. package/src/config/loader.test.ts +0 -313
  537. package/src/config/loader.ts +0 -103
  538. package/src/config/schema.ts +0 -168
  539. package/src/config/writer.test.ts +0 -119
  540. package/src/config/writer.ts +0 -84
  541. package/src/diff/classify.test.ts +0 -162
  542. package/src/diff/classify.ts +0 -92
  543. package/src/diff/coalesce.test.ts +0 -208
  544. package/src/diff/coalesce.ts +0 -133
  545. package/src/diff/context.test.ts +0 -226
  546. package/src/diff/context.ts +0 -201
  547. package/src/diff/index.ts +0 -4
  548. package/src/diff/parser.test.ts +0 -212
  549. package/src/diff/parser.ts +0 -149
  550. package/src/event/context.ts +0 -132
  551. package/src/event/index.ts +0 -2
  552. package/src/event/schedule-context.ts +0 -101
  553. package/src/examples/examples.integration.test.ts +0 -66
  554. package/src/examples/index.test.ts +0 -101
  555. package/src/examples/index.ts +0 -122
  556. package/src/examples/setup.ts +0 -25
  557. package/src/index.ts +0 -115
  558. package/src/output/dedup.test.ts +0 -419
  559. package/src/output/dedup.ts +0 -607
  560. package/src/output/github-checks.test.ts +0 -300
  561. package/src/output/github-checks.ts +0 -476
  562. package/src/output/github-issues.ts +0 -329
  563. package/src/output/index.ts +0 -5
  564. package/src/output/issue-renderer.ts +0 -197
  565. package/src/output/renderer.test.ts +0 -727
  566. package/src/output/renderer.ts +0 -217
  567. package/src/output/stale.test.ts +0 -375
  568. package/src/output/stale.ts +0 -155
  569. package/src/output/types.ts +0 -34
  570. package/src/sdk/index.ts +0 -1
  571. package/src/sdk/runner.test.ts +0 -806
  572. package/src/sdk/runner.ts +0 -1232
  573. package/src/skills/index.ts +0 -36
  574. package/src/skills/loader.test.ts +0 -300
  575. package/src/skills/loader.ts +0 -423
  576. package/src/skills/remote.test.ts +0 -704
  577. package/src/skills/remote.ts +0 -604
  578. package/src/triggers/matcher.test.ts +0 -277
  579. package/src/triggers/matcher.ts +0 -152
  580. package/src/types/index.ts +0 -194
  581. package/src/utils/async.ts +0 -18
  582. package/src/utils/index.test.ts +0 -84
  583. package/src/utils/index.ts +0 -51
  584. package/src/utils/version.ts +0 -17
  585. package/tsconfig.json +0 -25
  586. package/vitest.config.ts +0 -8
  587. package/vitest.integration.config.ts +0 -11
  588. 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
- ```