@funnycode/myclaude 0.1.71 → 0.1.73

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 (497) hide show
  1. package/LICENSE +21 -21
  2. package/dist/myclaude.js +14145 -9008
  3. package/dist/myclaude.mjs +14145 -9008
  4. package/package.json +125 -125
  5. package/seed/marketplaces/ecc/.claude/commands/add-language-rules.md +39 -0
  6. package/seed/marketplaces/ecc/.claude/commands/database-migration.md +36 -0
  7. package/seed/marketplaces/ecc/.claude/commands/feature-development.md +38 -0
  8. package/seed/marketplaces/ecc/.claude/ecc-tools.json +334 -0
  9. package/seed/marketplaces/ecc/.claude/enterprise/controls.md +15 -0
  10. package/seed/marketplaces/ecc/.claude/homunculus/instincts/inherited/everything-claude-code-instincts.yaml +162 -0
  11. package/seed/marketplaces/ecc/.claude/identity.json +14 -0
  12. package/seed/marketplaces/ecc/.claude/package-manager.json +4 -0
  13. package/seed/marketplaces/ecc/.claude/research/everything-claude-code-research-playbook.md +21 -0
  14. package/seed/marketplaces/ecc/.claude/rules/everything-claude-code-guardrails.md +43 -0
  15. package/seed/marketplaces/ecc/.claude/rules/node.md +56 -0
  16. package/seed/marketplaces/ecc/.claude/skills/everything-claude-code/SKILL.md +442 -0
  17. package/seed/marketplaces/ecc/.claude/team/everything-claude-code-team-config.json +15 -0
  18. package/seed/marketplaces/ecc/.opencode/package-lock.json +169 -169
  19. package/seed/marketplaces/ecc/.vscode/settings.json +17 -0
  20. package/seed/marketplaces/ecc/commands/aside.md +164 -164
  21. package/seed/marketplaces/ecc/commands/auto-update.md +28 -28
  22. package/seed/marketplaces/ecc/commands/build-fix.md +66 -66
  23. package/seed/marketplaces/ecc/commands/checkpoint.md +78 -78
  24. package/seed/marketplaces/ecc/commands/code-review.md +289 -289
  25. package/seed/marketplaces/ecc/commands/cost-report.md +107 -107
  26. package/seed/marketplaces/ecc/commands/cpp-build.md +173 -173
  27. package/seed/marketplaces/ecc/commands/cpp-review.md +132 -132
  28. package/seed/marketplaces/ecc/commands/cpp-test.md +251 -251
  29. package/seed/marketplaces/ecc/commands/ecc-guide.md +93 -93
  30. package/seed/marketplaces/ecc/commands/evolve.md +178 -178
  31. package/seed/marketplaces/ecc/commands/fastapi-review.md +39 -39
  32. package/seed/marketplaces/ecc/commands/feature-dev.md +49 -49
  33. package/seed/marketplaces/ecc/commands/flutter-build.md +164 -164
  34. package/seed/marketplaces/ecc/commands/flutter-review.md +116 -116
  35. package/seed/marketplaces/ecc/commands/flutter-test.md +144 -144
  36. package/seed/marketplaces/ecc/commands/gan-build.md +103 -103
  37. package/seed/marketplaces/ecc/commands/gan-design.md +39 -39
  38. package/seed/marketplaces/ecc/commands/go-build.md +183 -183
  39. package/seed/marketplaces/ecc/commands/go-review.md +148 -148
  40. package/seed/marketplaces/ecc/commands/go-test.md +268 -268
  41. package/seed/marketplaces/ecc/commands/gradle-build.md +70 -70
  42. package/seed/marketplaces/ecc/commands/harness-audit.md +84 -84
  43. package/seed/marketplaces/ecc/commands/hookify-configure.md +14 -14
  44. package/seed/marketplaces/ecc/commands/hookify-help.md +46 -46
  45. package/seed/marketplaces/ecc/commands/hookify-list.md +21 -21
  46. package/seed/marketplaces/ecc/commands/hookify.md +50 -50
  47. package/seed/marketplaces/ecc/commands/instinct-export.md +66 -66
  48. package/seed/marketplaces/ecc/commands/instinct-import.md +114 -114
  49. package/seed/marketplaces/ecc/commands/instinct-status.md +59 -59
  50. package/seed/marketplaces/ecc/commands/jira.md +106 -106
  51. package/seed/marketplaces/ecc/commands/kotlin-build.md +174 -174
  52. package/seed/marketplaces/ecc/commands/kotlin-review.md +140 -140
  53. package/seed/marketplaces/ecc/commands/kotlin-test.md +312 -312
  54. package/seed/marketplaces/ecc/commands/learn-eval.md +116 -116
  55. package/seed/marketplaces/ecc/commands/learn.md +74 -74
  56. package/seed/marketplaces/ecc/commands/loop-start.md +36 -36
  57. package/seed/marketplaces/ecc/commands/loop-status.md +77 -77
  58. package/seed/marketplaces/ecc/commands/marketing-campaign.md +129 -129
  59. package/seed/marketplaces/ecc/commands/model-route.md +30 -30
  60. package/seed/marketplaces/ecc/commands/multi-backend.md +162 -162
  61. package/seed/marketplaces/ecc/commands/multi-execute.md +319 -319
  62. package/seed/marketplaces/ecc/commands/multi-frontend.md +162 -162
  63. package/seed/marketplaces/ecc/commands/multi-plan.md +272 -272
  64. package/seed/marketplaces/ecc/commands/multi-workflow.md +195 -195
  65. package/seed/marketplaces/ecc/commands/plan-prd.md +160 -160
  66. package/seed/marketplaces/ecc/commands/plan.md +200 -200
  67. package/seed/marketplaces/ecc/commands/pm2.md +276 -276
  68. package/seed/marketplaces/ecc/commands/pr.md +184 -184
  69. package/seed/marketplaces/ecc/commands/project-init.md +86 -86
  70. package/seed/marketplaces/ecc/commands/projects.md +39 -39
  71. package/seed/marketplaces/ecc/commands/promote.md +41 -41
  72. package/seed/marketplaces/ecc/commands/prp-commit.md +112 -112
  73. package/seed/marketplaces/ecc/commands/prp-implement.md +385 -385
  74. package/seed/marketplaces/ecc/commands/prp-plan.md +502 -502
  75. package/seed/marketplaces/ecc/commands/prp-pr.md +184 -184
  76. package/seed/marketplaces/ecc/commands/prp-prd.md +447 -447
  77. package/seed/marketplaces/ecc/commands/prune.md +31 -31
  78. package/seed/marketplaces/ecc/commands/python-review.md +297 -297
  79. package/seed/marketplaces/ecc/commands/quality-gate.md +33 -33
  80. package/seed/marketplaces/ecc/commands/refactor-clean.md +84 -84
  81. package/seed/marketplaces/ecc/commands/resume-session.md +156 -156
  82. package/seed/marketplaces/ecc/commands/review-pr.md +37 -37
  83. package/seed/marketplaces/ecc/commands/rust-build.md +187 -187
  84. package/seed/marketplaces/ecc/commands/rust-review.md +142 -142
  85. package/seed/marketplaces/ecc/commands/rust-test.md +308 -308
  86. package/seed/marketplaces/ecc/commands/santa-loop.md +175 -175
  87. package/seed/marketplaces/ecc/commands/save-session.md +275 -275
  88. package/seed/marketplaces/ecc/commands/security-scan.md +92 -92
  89. package/seed/marketplaces/ecc/commands/sessions.md +339 -339
  90. package/seed/marketplaces/ecc/commands/setup-pm.md +80 -80
  91. package/seed/marketplaces/ecc/commands/skill-create.md +174 -174
  92. package/seed/marketplaces/ecc/commands/skill-health.md +54 -54
  93. package/seed/marketplaces/ecc/commands/test-coverage.md +73 -73
  94. package/seed/marketplaces/ecc/commands/update-codemaps.md +76 -76
  95. package/seed/marketplaces/ecc/commands/update-docs.md +88 -88
  96. package/seed/marketplaces/ecc/skills/accessibility/SKILL.md +146 -146
  97. package/seed/marketplaces/ecc/skills/agent-architecture-audit/SKILL.md +256 -256
  98. package/seed/marketplaces/ecc/skills/agent-eval/SKILL.md +145 -145
  99. package/seed/marketplaces/ecc/skills/agent-harness-construction/SKILL.md +73 -73
  100. package/seed/marketplaces/ecc/skills/agent-introspection-debugging/SKILL.md +153 -153
  101. package/seed/marketplaces/ecc/skills/agent-payment-x402/SKILL.md +224 -224
  102. package/seed/marketplaces/ecc/skills/agent-sort/SKILL.md +215 -215
  103. package/seed/marketplaces/ecc/skills/agentic-engineering/SKILL.md +63 -63
  104. package/seed/marketplaces/ecc/skills/agentic-os/SKILL.md +387 -387
  105. package/seed/marketplaces/ecc/skills/ai-first-engineering/SKILL.md +51 -51
  106. package/seed/marketplaces/ecc/skills/ai-regression-testing/SKILL.md +385 -385
  107. package/seed/marketplaces/ecc/skills/android-clean-architecture/SKILL.md +339 -339
  108. package/seed/marketplaces/ecc/skills/angular-developer/SKILL.md +154 -154
  109. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-animations.md +160 -160
  110. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-aria.md +410 -410
  111. package/seed/marketplaces/ecc/skills/angular-developer/references/cli.md +86 -86
  112. package/seed/marketplaces/ecc/skills/angular-developer/references/component-harnesses.md +59 -59
  113. package/seed/marketplaces/ecc/skills/angular-developer/references/component-styling.md +91 -91
  114. package/seed/marketplaces/ecc/skills/angular-developer/references/components.md +117 -117
  115. package/seed/marketplaces/ecc/skills/angular-developer/references/creating-services.md +97 -97
  116. package/seed/marketplaces/ecc/skills/angular-developer/references/data-resolvers.md +69 -69
  117. package/seed/marketplaces/ecc/skills/angular-developer/references/define-routes.md +67 -67
  118. package/seed/marketplaces/ecc/skills/angular-developer/references/defining-providers.md +72 -72
  119. package/seed/marketplaces/ecc/skills/angular-developer/references/di-fundamentals.md +120 -120
  120. package/seed/marketplaces/ecc/skills/angular-developer/references/e2e-testing.md +56 -56
  121. package/seed/marketplaces/ecc/skills/angular-developer/references/effects.md +83 -83
  122. package/seed/marketplaces/ecc/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  123. package/seed/marketplaces/ecc/skills/angular-developer/references/host-elements.md +80 -80
  124. package/seed/marketplaces/ecc/skills/angular-developer/references/injection-context.md +63 -63
  125. package/seed/marketplaces/ecc/skills/angular-developer/references/inputs.md +101 -101
  126. package/seed/marketplaces/ecc/skills/angular-developer/references/linked-signal.md +59 -59
  127. package/seed/marketplaces/ecc/skills/angular-developer/references/loading-strategies.md +61 -61
  128. package/seed/marketplaces/ecc/skills/angular-developer/references/mcp.md +108 -108
  129. package/seed/marketplaces/ecc/skills/angular-developer/references/navigate-to-routes.md +69 -69
  130. package/seed/marketplaces/ecc/skills/angular-developer/references/outputs.md +86 -86
  131. package/seed/marketplaces/ecc/skills/angular-developer/references/reactive-forms.md +122 -122
  132. package/seed/marketplaces/ecc/skills/angular-developer/references/rendering-strategies.md +44 -44
  133. package/seed/marketplaces/ecc/skills/angular-developer/references/resource.md +77 -77
  134. package/seed/marketplaces/ecc/skills/angular-developer/references/route-animations.md +56 -56
  135. package/seed/marketplaces/ecc/skills/angular-developer/references/route-guards.md +52 -52
  136. package/seed/marketplaces/ecc/skills/angular-developer/references/router-lifecycle.md +45 -45
  137. package/seed/marketplaces/ecc/skills/angular-developer/references/router-testing.md +87 -87
  138. package/seed/marketplaces/ecc/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  139. package/seed/marketplaces/ecc/skills/angular-developer/references/signal-forms.md +795 -795
  140. package/seed/marketplaces/ecc/skills/angular-developer/references/signals-overview.md +94 -94
  141. package/seed/marketplaces/ecc/skills/angular-developer/references/tailwind-css.md +69 -69
  142. package/seed/marketplaces/ecc/skills/angular-developer/references/template-driven-forms.md +114 -114
  143. package/seed/marketplaces/ecc/skills/angular-developer/references/testing-fundamentals.md +65 -65
  144. package/seed/marketplaces/ecc/skills/api-connector-builder/SKILL.md +120 -120
  145. package/seed/marketplaces/ecc/skills/api-design/SKILL.md +523 -523
  146. package/seed/marketplaces/ecc/skills/architecture-decision-records/SKILL.md +179 -179
  147. package/seed/marketplaces/ecc/skills/article-writing/SKILL.md +79 -79
  148. package/seed/marketplaces/ecc/skills/automation-audit-ops/SKILL.md +142 -142
  149. package/seed/marketplaces/ecc/skills/autonomous-agent-harness/SKILL.md +273 -273
  150. package/seed/marketplaces/ecc/skills/autonomous-loops/SKILL.md +610 -610
  151. package/seed/marketplaces/ecc/skills/backend-patterns/SKILL.md +561 -561
  152. package/seed/marketplaces/ecc/skills/benchmark/SKILL.md +93 -93
  153. package/seed/marketplaces/ecc/skills/benchmark-optimization-loop/SKILL.md +69 -69
  154. package/seed/marketplaces/ecc/skills/blender-motion-state-inspection/SKILL.md +164 -164
  155. package/seed/marketplaces/ecc/skills/blueprint/SKILL.md +105 -105
  156. package/seed/marketplaces/ecc/skills/brand-voice/SKILL.md +97 -97
  157. package/seed/marketplaces/ecc/skills/brand-voice/references/voice-profile-schema.md +55 -55
  158. package/seed/marketplaces/ecc/skills/browser-qa/SKILL.md +87 -87
  159. package/seed/marketplaces/ecc/skills/bun-runtime/SKILL.md +84 -84
  160. package/seed/marketplaces/ecc/skills/canary-watch/SKILL.md +107 -107
  161. package/seed/marketplaces/ecc/skills/carrier-relationship-management/SKILL.md +212 -212
  162. package/seed/marketplaces/ecc/skills/cisco-ios-patterns/SKILL.md +163 -163
  163. package/seed/marketplaces/ecc/skills/ck/SKILL.md +147 -147
  164. package/seed/marketplaces/ecc/skills/ck/commands/forget.mjs +44 -44
  165. package/seed/marketplaces/ecc/skills/ck/commands/info.mjs +24 -24
  166. package/seed/marketplaces/ecc/skills/ck/commands/init.mjs +143 -143
  167. package/seed/marketplaces/ecc/skills/ck/commands/list.mjs +40 -40
  168. package/seed/marketplaces/ecc/skills/ck/commands/migrate.mjs +202 -202
  169. package/seed/marketplaces/ecc/skills/ck/commands/resume.mjs +36 -36
  170. package/seed/marketplaces/ecc/skills/ck/commands/save.mjs +210 -210
  171. package/seed/marketplaces/ecc/skills/ck/commands/shared.mjs +387 -387
  172. package/seed/marketplaces/ecc/skills/ck/hooks/session-start.mjs +224 -224
  173. package/seed/marketplaces/ecc/skills/claude-devfleet/SKILL.md +103 -103
  174. package/seed/marketplaces/ecc/skills/click-path-audit/SKILL.md +244 -244
  175. package/seed/marketplaces/ecc/skills/clickhouse-io/SKILL.md +439 -439
  176. package/seed/marketplaces/ecc/skills/code-tour/SKILL.md +236 -236
  177. package/seed/marketplaces/ecc/skills/codebase-onboarding/SKILL.md +233 -233
  178. package/seed/marketplaces/ecc/skills/coding-standards/SKILL.md +549 -549
  179. package/seed/marketplaces/ecc/skills/compose-multiplatform-patterns/SKILL.md +299 -299
  180. package/seed/marketplaces/ecc/skills/configure-ecc/SKILL.md +384 -384
  181. package/seed/marketplaces/ecc/skills/connections-optimizer/SKILL.md +189 -189
  182. package/seed/marketplaces/ecc/skills/content-engine/SKILL.md +131 -131
  183. package/seed/marketplaces/ecc/skills/content-hash-cache-pattern/SKILL.md +161 -161
  184. package/seed/marketplaces/ecc/skills/context-budget/SKILL.md +135 -135
  185. package/seed/marketplaces/ecc/skills/continuous-agent-loop/SKILL.md +45 -45
  186. package/seed/marketplaces/ecc/skills/continuous-learning/SKILL.md +131 -131
  187. package/seed/marketplaces/ecc/skills/continuous-learning/config.json +18 -18
  188. package/seed/marketplaces/ecc/skills/continuous-learning/evaluate-session.sh +69 -69
  189. package/seed/marketplaces/ecc/skills/continuous-learning-v2/SKILL.md +360 -360
  190. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer-loop.sh +322 -322
  191. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer.md +198 -198
  192. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/session-guardian.sh +150 -150
  193. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/start-observer.sh +248 -248
  194. package/seed/marketplaces/ecc/skills/continuous-learning-v2/config.json +8 -8
  195. package/seed/marketplaces/ecc/skills/continuous-learning-v2/hooks/observe.sh +498 -498
  196. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/detect-project.sh +322 -322
  197. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/instinct-cli.py +1826 -1826
  198. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/lib/homunculus-dir.sh +31 -31
  199. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/migrate-homunculus.sh +62 -62
  200. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/test_parse_instinct.py +1018 -1018
  201. package/seed/marketplaces/ecc/skills/cost-aware-llm-pipeline/SKILL.md +183 -183
  202. package/seed/marketplaces/ecc/skills/cost-tracking/SKILL.md +147 -147
  203. package/seed/marketplaces/ecc/skills/council/SKILL.md +203 -203
  204. package/seed/marketplaces/ecc/skills/cpp-coding-standards/SKILL.md +723 -723
  205. package/seed/marketplaces/ecc/skills/cpp-testing/SKILL.md +324 -324
  206. package/seed/marketplaces/ecc/skills/crosspost/SKILL.md +111 -111
  207. package/seed/marketplaces/ecc/skills/csharp-testing/SKILL.md +321 -321
  208. package/seed/marketplaces/ecc/skills/customer-billing-ops/SKILL.md +140 -140
  209. package/seed/marketplaces/ecc/skills/customs-trade-compliance/SKILL.md +263 -263
  210. package/seed/marketplaces/ecc/skills/dart-flutter-patterns/SKILL.md +563 -563
  211. package/seed/marketplaces/ecc/skills/dashboard-builder/SKILL.md +108 -108
  212. package/seed/marketplaces/ecc/skills/data-scraper-agent/SKILL.md +764 -764
  213. package/seed/marketplaces/ecc/skills/data-throughput-accelerator/SKILL.md +72 -72
  214. package/seed/marketplaces/ecc/skills/database-migrations/SKILL.md +429 -429
  215. package/seed/marketplaces/ecc/skills/deep-research/SKILL.md +159 -159
  216. package/seed/marketplaces/ecc/skills/defi-amm-security/SKILL.md +166 -166
  217. package/seed/marketplaces/ecc/skills/deployment-patterns/SKILL.md +427 -427
  218. package/seed/marketplaces/ecc/skills/design-system/SKILL.md +82 -82
  219. package/seed/marketplaces/ecc/skills/django-celery/SKILL.md +457 -457
  220. package/seed/marketplaces/ecc/skills/django-patterns/SKILL.md +734 -734
  221. package/seed/marketplaces/ecc/skills/django-security/SKILL.md +593 -593
  222. package/seed/marketplaces/ecc/skills/django-tdd/SKILL.md +729 -729
  223. package/seed/marketplaces/ecc/skills/django-verification/SKILL.md +469 -469
  224. package/seed/marketplaces/ecc/skills/dmux-workflows/SKILL.md +191 -191
  225. package/seed/marketplaces/ecc/skills/docker-patterns/SKILL.md +364 -364
  226. package/seed/marketplaces/ecc/skills/documentation-lookup/SKILL.md +90 -90
  227. package/seed/marketplaces/ecc/skills/dotnet-patterns/SKILL.md +321 -321
  228. package/seed/marketplaces/ecc/skills/e2e-testing/SKILL.md +326 -326
  229. package/seed/marketplaces/ecc/skills/ecc-guide/SKILL.md +189 -189
  230. package/seed/marketplaces/ecc/skills/ecc-tools-cost-audit/SKILL.md +160 -160
  231. package/seed/marketplaces/ecc/skills/email-ops/SKILL.md +121 -121
  232. package/seed/marketplaces/ecc/skills/energy-procurement/SKILL.md +228 -228
  233. package/seed/marketplaces/ecc/skills/enterprise-agent-ops/SKILL.md +50 -50
  234. package/seed/marketplaces/ecc/skills/error-handling/SKILL.md +376 -376
  235. package/seed/marketplaces/ecc/skills/eval-harness/SKILL.md +270 -270
  236. package/seed/marketplaces/ecc/skills/evm-token-decimals/SKILL.md +130 -130
  237. package/seed/marketplaces/ecc/skills/exa-search/SKILL.md +107 -107
  238. package/seed/marketplaces/ecc/skills/fal-ai-media/SKILL.md +288 -288
  239. package/seed/marketplaces/ecc/skills/fastapi-patterns/SKILL.md +327 -327
  240. package/seed/marketplaces/ecc/skills/finance-billing-ops/SKILL.md +127 -127
  241. package/seed/marketplaces/ecc/skills/flox-environments/SKILL.md +496 -496
  242. package/seed/marketplaces/ecc/skills/flutter-dart-code-review/SKILL.md +435 -435
  243. package/seed/marketplaces/ecc/skills/foundation-models-on-device/SKILL.md +243 -243
  244. package/seed/marketplaces/ecc/skills/frontend-a11y/SKILL.md +446 -446
  245. package/seed/marketplaces/ecc/skills/frontend-design-direction/SKILL.md +92 -92
  246. package/seed/marketplaces/ecc/skills/frontend-patterns/SKILL.md +642 -642
  247. package/seed/marketplaces/ecc/skills/frontend-slides/SKILL.md +184 -184
  248. package/seed/marketplaces/ecc/skills/frontend-slides/STYLE_PRESETS.md +330 -330
  249. package/seed/marketplaces/ecc/skills/frontend-slides/animation-patterns.md +122 -122
  250. package/seed/marketplaces/ecc/skills/frontend-slides/html-template.md +419 -419
  251. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/export-pdf.sh +418 -418
  252. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/extract-pptx.py +96 -96
  253. package/seed/marketplaces/ecc/skills/frontend-slides/viewport-base.css +153 -153
  254. package/seed/marketplaces/ecc/skills/fsharp-testing/SKILL.md +280 -280
  255. package/seed/marketplaces/ecc/skills/gan-style-harness/SKILL.md +278 -278
  256. package/seed/marketplaces/ecc/skills/gateguard/SKILL.md +125 -125
  257. package/seed/marketplaces/ecc/skills/git-workflow/SKILL.md +715 -715
  258. package/seed/marketplaces/ecc/skills/github-ops/SKILL.md +144 -144
  259. package/seed/marketplaces/ecc/skills/golang-patterns/SKILL.md +674 -674
  260. package/seed/marketplaces/ecc/skills/golang-testing/SKILL.md +720 -720
  261. package/seed/marketplaces/ecc/skills/google-workspace-ops/SKILL.md +95 -95
  262. package/seed/marketplaces/ecc/skills/healthcare-cdss-patterns/SKILL.md +245 -245
  263. package/seed/marketplaces/ecc/skills/healthcare-emr-patterns/SKILL.md +159 -159
  264. package/seed/marketplaces/ecc/skills/healthcare-eval-harness/SKILL.md +207 -207
  265. package/seed/marketplaces/ecc/skills/healthcare-phi-compliance/SKILL.md +145 -145
  266. package/seed/marketplaces/ecc/skills/hermes-imports/SKILL.md +88 -88
  267. package/seed/marketplaces/ecc/skills/hexagonal-architecture/SKILL.md +276 -276
  268. package/seed/marketplaces/ecc/skills/hipaa-compliance/SKILL.md +78 -78
  269. package/seed/marketplaces/ecc/skills/homelab-network-readiness/SKILL.md +169 -169
  270. package/seed/marketplaces/ecc/skills/homelab-network-setup/SKILL.md +129 -129
  271. package/seed/marketplaces/ecc/skills/homelab-pihole-dns/SKILL.md +274 -274
  272. package/seed/marketplaces/ecc/skills/homelab-vlan-segmentation/SKILL.md +311 -311
  273. package/seed/marketplaces/ecc/skills/homelab-wireguard-vpn/SKILL.md +305 -305
  274. package/seed/marketplaces/ecc/skills/hookify-rules/SKILL.md +128 -128
  275. package/seed/marketplaces/ecc/skills/inventory-demand-planning/SKILL.md +247 -247
  276. package/seed/marketplaces/ecc/skills/investor-materials/SKILL.md +96 -96
  277. package/seed/marketplaces/ecc/skills/investor-outreach/SKILL.md +91 -91
  278. package/seed/marketplaces/ecc/skills/ios-icon-gen/SKILL.md +157 -157
  279. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/generate_icons.swift +258 -258
  280. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/iconify_gen.sh +235 -235
  281. package/seed/marketplaces/ecc/skills/iterative-retrieval/SKILL.md +211 -211
  282. package/seed/marketplaces/ecc/skills/ito-basket-compare/SKILL.md +63 -63
  283. package/seed/marketplaces/ecc/skills/ito-data-atlas-agent/SKILL.md +63 -63
  284. package/seed/marketplaces/ecc/skills/ito-market-intelligence/SKILL.md +60 -60
  285. package/seed/marketplaces/ecc/skills/ito-trade-planner/SKILL.md +67 -67
  286. package/seed/marketplaces/ecc/skills/java-coding-standards/SKILL.md +383 -383
  287. package/seed/marketplaces/ecc/skills/jira-integration/SKILL.md +293 -293
  288. package/seed/marketplaces/ecc/skills/jpa-patterns/SKILL.md +151 -151
  289. package/seed/marketplaces/ecc/skills/knowledge-ops/SKILL.md +154 -154
  290. package/seed/marketplaces/ecc/skills/kotlin-coroutines-flows/SKILL.md +284 -284
  291. package/seed/marketplaces/ecc/skills/kotlin-exposed-patterns/SKILL.md +719 -719
  292. package/seed/marketplaces/ecc/skills/kotlin-ktor-patterns/SKILL.md +689 -689
  293. package/seed/marketplaces/ecc/skills/kotlin-patterns/SKILL.md +711 -711
  294. package/seed/marketplaces/ecc/skills/kotlin-testing/SKILL.md +824 -824
  295. package/seed/marketplaces/ecc/skills/laravel-patterns/SKILL.md +415 -415
  296. package/seed/marketplaces/ecc/skills/laravel-plugin-discovery/SKILL.md +229 -229
  297. package/seed/marketplaces/ecc/skills/laravel-security/SKILL.md +285 -285
  298. package/seed/marketplaces/ecc/skills/laravel-tdd/SKILL.md +283 -283
  299. package/seed/marketplaces/ecc/skills/laravel-verification/SKILL.md +179 -179
  300. package/seed/marketplaces/ecc/skills/latency-critical-systems/SKILL.md +73 -73
  301. package/seed/marketplaces/ecc/skills/lead-intelligence/SKILL.md +321 -321
  302. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/enrichment-agent.md +85 -85
  303. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/mutual-mapper.md +75 -75
  304. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/outreach-drafter.md +98 -98
  305. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/signal-scorer.md +60 -60
  306. package/seed/marketplaces/ecc/skills/liquid-glass-design/SKILL.md +279 -279
  307. package/seed/marketplaces/ecc/skills/llm-trading-agent-security/SKILL.md +146 -146
  308. package/seed/marketplaces/ecc/skills/logistics-exception-management/SKILL.md +222 -222
  309. package/seed/marketplaces/ecc/skills/make-interfaces-feel-better/SKILL.md +151 -151
  310. package/seed/marketplaces/ecc/skills/manim-video/SKILL.md +89 -89
  311. package/seed/marketplaces/ecc/skills/manim-video/assets/network_graph_scene.py +52 -52
  312. package/seed/marketplaces/ecc/skills/market-research/SKILL.md +75 -75
  313. package/seed/marketplaces/ecc/skills/marketing-campaign/SKILL.md +113 -113
  314. package/seed/marketplaces/ecc/skills/mcp-server-patterns/SKILL.md +69 -69
  315. package/seed/marketplaces/ecc/skills/messages-ops/SKILL.md +104 -104
  316. package/seed/marketplaces/ecc/skills/mle-workflow/SKILL.md +346 -346
  317. package/seed/marketplaces/ecc/skills/motion-advanced/SKILL.md +596 -596
  318. package/seed/marketplaces/ecc/skills/motion-foundations/SKILL.md +299 -299
  319. package/seed/marketplaces/ecc/skills/motion-patterns/SKILL.md +435 -435
  320. package/seed/marketplaces/ecc/skills/motion-ui/SKILL.md +575 -575
  321. package/seed/marketplaces/ecc/skills/mysql-patterns/SKILL.md +412 -412
  322. package/seed/marketplaces/ecc/skills/nanoclaw-repl/SKILL.md +33 -33
  323. package/seed/marketplaces/ecc/skills/nestjs-patterns/SKILL.md +230 -230
  324. package/seed/marketplaces/ecc/skills/netmiko-ssh-automation/SKILL.md +173 -173
  325. package/seed/marketplaces/ecc/skills/network-bgp-diagnostics/SKILL.md +167 -167
  326. package/seed/marketplaces/ecc/skills/network-config-validation/SKILL.md +210 -210
  327. package/seed/marketplaces/ecc/skills/network-interface-health/SKILL.md +152 -152
  328. package/seed/marketplaces/ecc/skills/nextjs-turbopack/SKILL.md +57 -57
  329. package/seed/marketplaces/ecc/skills/nodejs-keccak256/SKILL.md +102 -102
  330. package/seed/marketplaces/ecc/skills/nutrient-document-processing/SKILL.md +167 -167
  331. package/seed/marketplaces/ecc/skills/nuxt4-patterns/SKILL.md +100 -100
  332. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/SKILL.md +288 -288
  333. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.py +224 -224
  334. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.sh +5 -5
  335. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  336. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  337. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  338. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  339. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  340. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/output-template.md +166 -166
  341. package/seed/marketplaces/ecc/skills/opensource-pipeline/SKILL.md +255 -255
  342. package/seed/marketplaces/ecc/skills/parallel-execution-optimizer/SKILL.md +72 -72
  343. package/seed/marketplaces/ecc/skills/perl-patterns/SKILL.md +504 -504
  344. package/seed/marketplaces/ecc/skills/perl-security/SKILL.md +503 -503
  345. package/seed/marketplaces/ecc/skills/perl-testing/SKILL.md +475 -475
  346. package/seed/marketplaces/ecc/skills/plan-orchestrate/SKILL.md +262 -262
  347. package/seed/marketplaces/ecc/skills/plankton-code-quality/SKILL.md +236 -236
  348. package/seed/marketplaces/ecc/skills/postgres-patterns/SKILL.md +147 -147
  349. package/seed/marketplaces/ecc/skills/prediction-market-oracle-research/SKILL.md +63 -63
  350. package/seed/marketplaces/ecc/skills/prediction-market-risk-review/SKILL.md +60 -60
  351. package/seed/marketplaces/ecc/skills/prisma-patterns/SKILL.md +371 -371
  352. package/seed/marketplaces/ecc/skills/product-capability/SKILL.md +141 -141
  353. package/seed/marketplaces/ecc/skills/product-lens/SKILL.md +92 -92
  354. package/seed/marketplaces/ecc/skills/production-audit/SKILL.md +206 -206
  355. package/seed/marketplaces/ecc/skills/production-scheduling/SKILL.md +238 -238
  356. package/seed/marketplaces/ecc/skills/project-flow-ops/SKILL.md +111 -111
  357. package/seed/marketplaces/ecc/skills/prompt-optimizer/SKILL.md +398 -398
  358. package/seed/marketplaces/ecc/skills/python-patterns/SKILL.md +750 -750
  359. package/seed/marketplaces/ecc/skills/python-testing/SKILL.md +816 -816
  360. package/seed/marketplaces/ecc/skills/pytorch-patterns/SKILL.md +396 -396
  361. package/seed/marketplaces/ecc/skills/quality-nonconformance/SKILL.md +260 -260
  362. package/seed/marketplaces/ecc/skills/quarkus-patterns/SKILL.md +722 -722
  363. package/seed/marketplaces/ecc/skills/quarkus-security/SKILL.md +467 -467
  364. package/seed/marketplaces/ecc/skills/quarkus-tdd/SKILL.md +811 -811
  365. package/seed/marketplaces/ecc/skills/quarkus-verification/SKILL.md +479 -479
  366. package/seed/marketplaces/ecc/skills/ralphinho-rfc-pipeline/SKILL.md +67 -67
  367. package/seed/marketplaces/ecc/skills/recsys-pipeline-architect/SKILL.md +114 -114
  368. package/seed/marketplaces/ecc/skills/recursive-decision-ledger/SKILL.md +79 -79
  369. package/seed/marketplaces/ecc/skills/redis-patterns/SKILL.md +403 -403
  370. package/seed/marketplaces/ecc/skills/regex-vs-llm-structured-text/SKILL.md +220 -220
  371. package/seed/marketplaces/ecc/skills/remotion-video-creation/SKILL.md +43 -43
  372. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/3d.md +86 -86
  373. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/animations.md +29 -29
  374. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/charts-bar-chart.tsx +173 -173
  375. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-typewriter.tsx +100 -100
  376. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-word-highlight.tsx +108 -108
  377. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets.md +78 -78
  378. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/audio.md +172 -172
  379. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/calculate-metadata.md +104 -104
  380. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/can-decode.md +75 -75
  381. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/charts.md +58 -58
  382. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/compositions.md +146 -146
  383. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/display-captions.md +126 -126
  384. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/extract-frames.md +229 -229
  385. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/fonts.md +152 -152
  386. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-audio-duration.md +58 -58
  387. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-dimensions.md +68 -68
  388. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-duration.md +58 -58
  389. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/gifs.md +138 -138
  390. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/images.md +130 -130
  391. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/import-srt-captions.md +67 -67
  392. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/lottie.md +67 -67
  393. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-dom-nodes.md +34 -34
  394. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-text.md +143 -143
  395. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/sequencing.md +106 -106
  396. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/tailwind.md +11 -11
  397. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/text-animations.md +20 -20
  398. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/timing.md +179 -179
  399. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transcribe-captions.md +19 -19
  400. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transitions.md +122 -122
  401. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/trimming.md +52 -52
  402. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/videos.md +171 -171
  403. package/seed/marketplaces/ecc/skills/repo-scan/SKILL.md +78 -78
  404. package/seed/marketplaces/ecc/skills/research-ops/SKILL.md +112 -112
  405. package/seed/marketplaces/ecc/skills/returns-reverse-logistics/SKILL.md +240 -240
  406. package/seed/marketplaces/ecc/skills/rules-distill/SKILL.md +264 -264
  407. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-rules.sh +58 -58
  408. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-skills.sh +129 -129
  409. package/seed/marketplaces/ecc/skills/rust-patterns/SKILL.md +499 -499
  410. package/seed/marketplaces/ecc/skills/rust-testing/SKILL.md +500 -500
  411. package/seed/marketplaces/ecc/skills/safety-guard/SKILL.md +75 -75
  412. package/seed/marketplaces/ecc/skills/santa-method/SKILL.md +306 -306
  413. package/seed/marketplaces/ecc/skills/scientific-db-pubmed-database/SKILL.md +175 -175
  414. package/seed/marketplaces/ecc/skills/scientific-db-uspto-database/SKILL.md +177 -177
  415. package/seed/marketplaces/ecc/skills/scientific-pkg-gget/SKILL.md +166 -166
  416. package/seed/marketplaces/ecc/skills/scientific-thinking-literature-review/SKILL.md +192 -192
  417. package/seed/marketplaces/ecc/skills/scientific-thinking-scholar-evaluation/SKILL.md +160 -160
  418. package/seed/marketplaces/ecc/skills/search-first/SKILL.md +182 -182
  419. package/seed/marketplaces/ecc/skills/security-bounty-hunter/SKILL.md +99 -99
  420. package/seed/marketplaces/ecc/skills/security-review/SKILL.md +503 -503
  421. package/seed/marketplaces/ecc/skills/security-review/cloud-infrastructure-security.md +361 -361
  422. package/seed/marketplaces/ecc/skills/security-scan/SKILL.md +165 -165
  423. package/seed/marketplaces/ecc/skills/seo/SKILL.md +154 -154
  424. package/seed/marketplaces/ecc/skills/skill-comply/SKILL.md +58 -58
  425. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/compliant_trace.jsonl +5 -5
  426. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/noncompliant_trace.jsonl +3 -3
  427. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/tdd_spec.yaml +44 -44
  428. package/seed/marketplaces/ecc/skills/skill-comply/prompts/classifier.md +24 -24
  429. package/seed/marketplaces/ecc/skills/skill-comply/prompts/scenario_generator.md +62 -62
  430. package/seed/marketplaces/ecc/skills/skill-comply/prompts/spec_generator.md +42 -42
  431. package/seed/marketplaces/ecc/skills/skill-comply/pyproject.toml +15 -15
  432. package/seed/marketplaces/ecc/skills/skill-comply/scripts/classifier.py +85 -85
  433. package/seed/marketplaces/ecc/skills/skill-comply/scripts/grader.py +124 -124
  434. package/seed/marketplaces/ecc/skills/skill-comply/scripts/parser.py +107 -107
  435. package/seed/marketplaces/ecc/skills/skill-comply/scripts/report.py +170 -170
  436. package/seed/marketplaces/ecc/skills/skill-comply/scripts/run.py +127 -127
  437. package/seed/marketplaces/ecc/skills/skill-comply/scripts/runner.py +186 -186
  438. package/seed/marketplaces/ecc/skills/skill-comply/scripts/scenario_generator.py +70 -70
  439. package/seed/marketplaces/ecc/skills/skill-comply/scripts/spec_generator.py +72 -72
  440. package/seed/marketplaces/ecc/skills/skill-comply/scripts/utils.py +13 -13
  441. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_grader.py +197 -197
  442. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_parser.py +90 -90
  443. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_runner.py +172 -172
  444. package/seed/marketplaces/ecc/skills/skill-scout/SKILL.md +140 -140
  445. package/seed/marketplaces/ecc/skills/skill-stocktake/SKILL.md +194 -194
  446. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/quick-diff.sh +87 -87
  447. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/save-results.sh +56 -56
  448. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/scan.sh +170 -170
  449. package/seed/marketplaces/ecc/skills/social-graph-ranker/SKILL.md +154 -154
  450. package/seed/marketplaces/ecc/skills/social-publisher/SKILL.md +115 -115
  451. package/seed/marketplaces/ecc/skills/springboot-patterns/SKILL.md +314 -314
  452. package/seed/marketplaces/ecc/skills/springboot-security/SKILL.md +272 -272
  453. package/seed/marketplaces/ecc/skills/springboot-tdd/SKILL.md +158 -158
  454. package/seed/marketplaces/ecc/skills/springboot-verification/SKILL.md +231 -231
  455. package/seed/marketplaces/ecc/skills/strategic-compact/SKILL.md +131 -131
  456. package/seed/marketplaces/ecc/skills/swift-actor-persistence/SKILL.md +143 -143
  457. package/seed/marketplaces/ecc/skills/swift-concurrency-6-2/SKILL.md +216 -216
  458. package/seed/marketplaces/ecc/skills/swift-protocol-di-testing/SKILL.md +190 -190
  459. package/seed/marketplaces/ecc/skills/swiftui-patterns/SKILL.md +259 -259
  460. package/seed/marketplaces/ecc/skills/tdd-workflow/SKILL.md +463 -463
  461. package/seed/marketplaces/ecc/skills/team-builder/SKILL.md +168 -168
  462. package/seed/marketplaces/ecc/skills/terminal-ops/SKILL.md +109 -109
  463. package/seed/marketplaces/ecc/skills/tinystruct-patterns/SKILL.md +203 -203
  464. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/architecture.md +90 -90
  465. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/data-handling.md +60 -60
  466. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/database.md +99 -99
  467. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/routing.md +64 -64
  468. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/system-usage.md +97 -97
  469. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/testing.md +72 -72
  470. package/seed/marketplaces/ecc/skills/token-budget-advisor/SKILL.md +133 -133
  471. package/seed/marketplaces/ecc/skills/ui-demo/SKILL.md +465 -465
  472. package/seed/marketplaces/ecc/skills/ui-to-vue/SKILL.md +134 -134
  473. package/seed/marketplaces/ecc/skills/uncloud/SKILL.md +343 -343
  474. package/seed/marketplaces/ecc/skills/unified-notifications-ops/SKILL.md +187 -187
  475. package/seed/marketplaces/ecc/skills/verification-loop/SKILL.md +126 -126
  476. package/seed/marketplaces/ecc/skills/video-editing/SKILL.md +310 -310
  477. package/seed/marketplaces/ecc/skills/videodb/SKILL.md +374 -374
  478. package/seed/marketplaces/ecc/skills/videodb/reference/api-reference.md +550 -550
  479. package/seed/marketplaces/ecc/skills/videodb/reference/capture-reference.md +407 -407
  480. package/seed/marketplaces/ecc/skills/videodb/reference/capture.md +101 -101
  481. package/seed/marketplaces/ecc/skills/videodb/reference/editor.md +443 -443
  482. package/seed/marketplaces/ecc/skills/videodb/reference/generative.md +331 -331
  483. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream-reference.md +564 -564
  484. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream.md +65 -65
  485. package/seed/marketplaces/ecc/skills/videodb/reference/search.md +230 -230
  486. package/seed/marketplaces/ecc/skills/videodb/reference/streaming.md +406 -406
  487. package/seed/marketplaces/ecc/skills/videodb/reference/use-cases.md +118 -118
  488. package/seed/marketplaces/ecc/skills/videodb/scripts/ws_listener.py +282 -282
  489. package/seed/marketplaces/ecc/skills/visa-doc-translate/README.md +86 -86
  490. package/seed/marketplaces/ecc/skills/visa-doc-translate/SKILL.md +117 -117
  491. package/seed/marketplaces/ecc/skills/vite-patterns/SKILL.md +449 -449
  492. package/seed/marketplaces/ecc/skills/windows-desktop-e2e/SKILL.md +887 -887
  493. package/seed/marketplaces/ecc/skills/workspace-surface-audit/SKILL.md +125 -125
  494. package/seed/marketplaces/ecc/skills/x-api/SKILL.md +234 -234
  495. package/dist/SKILL-r7zmg5v7.md +0 -3
  496. package/dist/cli-mvr5k580.md +0 -3
  497. package/dist/server-zyhc2a9z.md +0 -3
@@ -1,642 +1,642 @@
1
- ---
2
- name: frontend-patterns
3
- description: Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.
4
- origin: ECC
5
- ---
6
-
7
- # Frontend Development Patterns
8
-
9
- Modern frontend patterns for React, Next.js, and performant user interfaces.
10
-
11
- ## When to Activate
12
-
13
- - Building React components (composition, props, rendering)
14
- - Managing state (useState, useReducer, Zustand, Context)
15
- - Implementing data fetching (SWR, React Query, server components)
16
- - Optimizing performance (memoization, virtualization, code splitting)
17
- - Working with forms (validation, controlled inputs, Zod schemas)
18
- - Handling client-side routing and navigation
19
- - Building accessible, responsive UI patterns
20
-
21
- ## Component Patterns
22
-
23
- ### Composition Over Inheritance
24
-
25
- ```typescript
26
- // PASS: GOOD: Component composition
27
- interface CardProps {
28
- children: React.ReactNode
29
- variant?: 'default' | 'outlined'
30
- }
31
-
32
- export function Card({ children, variant = 'default' }: CardProps) {
33
- return <div className={`card card-${variant}`}>{children}</div>
34
- }
35
-
36
- export function CardHeader({ children }: { children: React.ReactNode }) {
37
- return <div className="card-header">{children}</div>
38
- }
39
-
40
- export function CardBody({ children }: { children: React.ReactNode }) {
41
- return <div className="card-body">{children}</div>
42
- }
43
-
44
- // Usage
45
- <Card>
46
- <CardHeader>Title</CardHeader>
47
- <CardBody>Content</CardBody>
48
- </Card>
49
- ```
50
-
51
- ### Compound Components
52
-
53
- ```typescript
54
- interface TabsContextValue {
55
- activeTab: string
56
- setActiveTab: (tab: string) => void
57
- }
58
-
59
- const TabsContext = createContext<TabsContextValue | undefined>(undefined)
60
-
61
- export function Tabs({ children, defaultTab }: {
62
- children: React.ReactNode
63
- defaultTab: string
64
- }) {
65
- const [activeTab, setActiveTab] = useState(defaultTab)
66
-
67
- return (
68
- <TabsContext.Provider value={{ activeTab, setActiveTab }}>
69
- {children}
70
- </TabsContext.Provider>
71
- )
72
- }
73
-
74
- export function TabList({ children }: { children: React.ReactNode }) {
75
- return <div className="tab-list">{children}</div>
76
- }
77
-
78
- export function Tab({ id, children }: { id: string, children: React.ReactNode }) {
79
- const context = useContext(TabsContext)
80
- if (!context) throw new Error('Tab must be used within Tabs')
81
-
82
- return (
83
- <button
84
- className={context.activeTab === id ? 'active' : ''}
85
- onClick={() => context.setActiveTab(id)}
86
- >
87
- {children}
88
- </button>
89
- )
90
- }
91
-
92
- // Usage
93
- <Tabs defaultTab="overview">
94
- <TabList>
95
- <Tab id="overview">Overview</Tab>
96
- <Tab id="details">Details</Tab>
97
- </TabList>
98
- </Tabs>
99
- ```
100
-
101
- ### Render Props Pattern
102
-
103
- ```typescript
104
- interface DataLoaderProps<T> {
105
- url: string
106
- children: (data: T | null, loading: boolean, error: Error | null) => React.ReactNode
107
- }
108
-
109
- export function DataLoader<T>({ url, children }: DataLoaderProps<T>) {
110
- const [data, setData] = useState<T | null>(null)
111
- const [loading, setLoading] = useState(true)
112
- const [error, setError] = useState<Error | null>(null)
113
-
114
- useEffect(() => {
115
- fetch(url)
116
- .then(res => res.json())
117
- .then(setData)
118
- .catch(setError)
119
- .finally(() => setLoading(false))
120
- }, [url])
121
-
122
- return <>{children(data, loading, error)}</>
123
- }
124
-
125
- // Usage
126
- <DataLoader<Market[]> url="/api/markets">
127
- {(markets, loading, error) => {
128
- if (loading) return <Spinner />
129
- if (error) return <Error error={error} />
130
- return <MarketList markets={markets!} />
131
- }}
132
- </DataLoader>
133
- ```
134
-
135
- ## Custom Hooks Patterns
136
-
137
- ### State Management Hook
138
-
139
- ```typescript
140
- export function useToggle(initialValue = false): [boolean, () => void] {
141
- const [value, setValue] = useState(initialValue)
142
-
143
- const toggle = useCallback(() => {
144
- setValue(v => !v)
145
- }, [])
146
-
147
- return [value, toggle]
148
- }
149
-
150
- // Usage
151
- const [isOpen, toggleOpen] = useToggle()
152
- ```
153
-
154
- ### Async Data Fetching Hook
155
-
156
- ```typescript
157
- interface UseQueryOptions<T> {
158
- onSuccess?: (data: T) => void
159
- onError?: (error: Error) => void
160
- enabled?: boolean
161
- }
162
-
163
- export function useQuery<T>(
164
- key: string,
165
- fetcher: () => Promise<T>,
166
- options?: UseQueryOptions<T>
167
- ) {
168
- const [data, setData] = useState<T | null>(null)
169
- const [error, setError] = useState<Error | null>(null)
170
- const [loading, setLoading] = useState(false)
171
-
172
- const refetch = useCallback(async () => {
173
- setLoading(true)
174
- setError(null)
175
-
176
- try {
177
- const result = await fetcher()
178
- setData(result)
179
- options?.onSuccess?.(result)
180
- } catch (err) {
181
- const error = err as Error
182
- setError(error)
183
- options?.onError?.(error)
184
- } finally {
185
- setLoading(false)
186
- }
187
- }, [fetcher, options])
188
-
189
- useEffect(() => {
190
- if (options?.enabled !== false) {
191
- refetch()
192
- }
193
- }, [key, refetch, options?.enabled])
194
-
195
- return { data, error, loading, refetch }
196
- }
197
-
198
- // Usage
199
- const { data: markets, loading, error, refetch } = useQuery(
200
- 'markets',
201
- () => fetch('/api/markets').then(r => r.json()),
202
- {
203
- onSuccess: data => console.log('Fetched', data.length, 'markets'),
204
- onError: err => console.error('Failed:', err)
205
- }
206
- )
207
- ```
208
-
209
- ### Debounce Hook
210
-
211
- ```typescript
212
- export function useDebounce<T>(value: T, delay: number): T {
213
- const [debouncedValue, setDebouncedValue] = useState<T>(value)
214
-
215
- useEffect(() => {
216
- const handler = setTimeout(() => {
217
- setDebouncedValue(value)
218
- }, delay)
219
-
220
- return () => clearTimeout(handler)
221
- }, [value, delay])
222
-
223
- return debouncedValue
224
- }
225
-
226
- // Usage
227
- const [searchQuery, setSearchQuery] = useState('')
228
- const debouncedQuery = useDebounce(searchQuery, 500)
229
-
230
- useEffect(() => {
231
- if (debouncedQuery) {
232
- performSearch(debouncedQuery)
233
- }
234
- }, [debouncedQuery])
235
- ```
236
-
237
- ## State Management Patterns
238
-
239
- ### Context + Reducer Pattern
240
-
241
- ```typescript
242
- interface State {
243
- markets: Market[]
244
- selectedMarket: Market | null
245
- loading: boolean
246
- }
247
-
248
- type Action =
249
- | { type: 'SET_MARKETS'; payload: Market[] }
250
- | { type: 'SELECT_MARKET'; payload: Market }
251
- | { type: 'SET_LOADING'; payload: boolean }
252
-
253
- function reducer(state: State, action: Action): State {
254
- switch (action.type) {
255
- case 'SET_MARKETS':
256
- return { ...state, markets: action.payload }
257
- case 'SELECT_MARKET':
258
- return { ...state, selectedMarket: action.payload }
259
- case 'SET_LOADING':
260
- return { ...state, loading: action.payload }
261
- default:
262
- return state
263
- }
264
- }
265
-
266
- const MarketContext = createContext<{
267
- state: State
268
- dispatch: Dispatch<Action>
269
- } | undefined>(undefined)
270
-
271
- export function MarketProvider({ children }: { children: React.ReactNode }) {
272
- const [state, dispatch] = useReducer(reducer, {
273
- markets: [],
274
- selectedMarket: null,
275
- loading: false
276
- })
277
-
278
- return (
279
- <MarketContext.Provider value={{ state, dispatch }}>
280
- {children}
281
- </MarketContext.Provider>
282
- )
283
- }
284
-
285
- export function useMarkets() {
286
- const context = useContext(MarketContext)
287
- if (!context) throw new Error('useMarkets must be used within MarketProvider')
288
- return context
289
- }
290
- ```
291
-
292
- ## Performance Optimization
293
-
294
- ### Memoization
295
-
296
- ```typescript
297
- // PASS: useMemo for expensive computations
298
- const sortedMarkets = useMemo(() => {
299
- return markets.sort((a, b) => b.volume - a.volume)
300
- }, [markets])
301
-
302
- // PASS: useCallback for functions passed to children
303
- const handleSearch = useCallback((query: string) => {
304
- setSearchQuery(query)
305
- }, [])
306
-
307
- // PASS: React.memo for pure components
308
- export const MarketCard = React.memo<MarketCardProps>(({ market }) => {
309
- return (
310
- <div className="market-card">
311
- <h3>{market.name}</h3>
312
- <p>{market.description}</p>
313
- </div>
314
- )
315
- })
316
- ```
317
-
318
- ### Code Splitting & Lazy Loading
319
-
320
- ```typescript
321
- import { lazy, Suspense } from 'react'
322
-
323
- // PASS: Lazy load heavy components
324
- const HeavyChart = lazy(() => import('./HeavyChart'))
325
- const ThreeJsBackground = lazy(() => import('./ThreeJsBackground'))
326
-
327
- export function Dashboard() {
328
- return (
329
- <div>
330
- <Suspense fallback={<ChartSkeleton />}>
331
- <HeavyChart data={data} />
332
- </Suspense>
333
-
334
- <Suspense fallback={null}>
335
- <ThreeJsBackground />
336
- </Suspense>
337
- </div>
338
- )
339
- }
340
- ```
341
-
342
- ### Virtualization for Long Lists
343
-
344
- ```typescript
345
- import { useVirtualizer } from '@tanstack/react-virtual'
346
-
347
- export function VirtualMarketList({ markets }: { markets: Market[] }) {
348
- const parentRef = useRef<HTMLDivElement>(null)
349
-
350
- const virtualizer = useVirtualizer({
351
- count: markets.length,
352
- getScrollElement: () => parentRef.current,
353
- estimateSize: () => 100, // Estimated row height
354
- overscan: 5 // Extra items to render
355
- })
356
-
357
- return (
358
- <div ref={parentRef} style={{ height: '600px', overflow: 'auto' }}>
359
- <div
360
- style={{
361
- height: `${virtualizer.getTotalSize()}px`,
362
- position: 'relative'
363
- }}
364
- >
365
- {virtualizer.getVirtualItems().map(virtualRow => (
366
- <div
367
- key={virtualRow.index}
368
- style={{
369
- position: 'absolute',
370
- top: 0,
371
- left: 0,
372
- width: '100%',
373
- height: `${virtualRow.size}px`,
374
- transform: `translateY(${virtualRow.start}px)`
375
- }}
376
- >
377
- <MarketCard market={markets[virtualRow.index]} />
378
- </div>
379
- ))}
380
- </div>
381
- </div>
382
- )
383
- }
384
- ```
385
-
386
- ## Form Handling Patterns
387
-
388
- ### Controlled Form with Validation
389
-
390
- ```typescript
391
- interface FormData {
392
- name: string
393
- description: string
394
- endDate: string
395
- }
396
-
397
- interface FormErrors {
398
- name?: string
399
- description?: string
400
- endDate?: string
401
- }
402
-
403
- export function CreateMarketForm() {
404
- const [formData, setFormData] = useState<FormData>({
405
- name: '',
406
- description: '',
407
- endDate: ''
408
- })
409
-
410
- const [errors, setErrors] = useState<FormErrors>({})
411
-
412
- const validate = (): boolean => {
413
- const newErrors: FormErrors = {}
414
-
415
- if (!formData.name.trim()) {
416
- newErrors.name = 'Name is required'
417
- } else if (formData.name.length > 200) {
418
- newErrors.name = 'Name must be under 200 characters'
419
- }
420
-
421
- if (!formData.description.trim()) {
422
- newErrors.description = 'Description is required'
423
- }
424
-
425
- if (!formData.endDate) {
426
- newErrors.endDate = 'End date is required'
427
- }
428
-
429
- setErrors(newErrors)
430
- return Object.keys(newErrors).length === 0
431
- }
432
-
433
- const handleSubmit = async (e: React.FormEvent) => {
434
- e.preventDefault()
435
-
436
- if (!validate()) return
437
-
438
- try {
439
- await createMarket(formData)
440
- // Success handling
441
- } catch (error) {
442
- // Error handling
443
- }
444
- }
445
-
446
- return (
447
- <form onSubmit={handleSubmit}>
448
- <input
449
- value={formData.name}
450
- onChange={e => setFormData(prev => ({ ...prev, name: e.target.value }))}
451
- placeholder="Market name"
452
- />
453
- {errors.name && <span className="error">{errors.name}</span>}
454
-
455
- {/* Other fields */}
456
-
457
- <button type="submit">Create Market</button>
458
- </form>
459
- )
460
- }
461
- ```
462
-
463
- ## Error Boundary Pattern
464
-
465
- ```typescript
466
- interface ErrorBoundaryState {
467
- hasError: boolean
468
- error: Error | null
469
- }
470
-
471
- export class ErrorBoundary extends React.Component<
472
- { children: React.ReactNode },
473
- ErrorBoundaryState
474
- > {
475
- state: ErrorBoundaryState = {
476
- hasError: false,
477
- error: null
478
- }
479
-
480
- static getDerivedStateFromError(error: Error): ErrorBoundaryState {
481
- return { hasError: true, error }
482
- }
483
-
484
- componentDidCatch(error: Error, errorInfo: React.ErrorInfo) {
485
- console.error('Error boundary caught:', error, errorInfo)
486
- }
487
-
488
- render() {
489
- if (this.state.hasError) {
490
- return (
491
- <div className="error-fallback">
492
- <h2>Something went wrong</h2>
493
- <p>{this.state.error?.message}</p>
494
- <button onClick={() => this.setState({ hasError: false })}>
495
- Try again
496
- </button>
497
- </div>
498
- )
499
- }
500
-
501
- return this.props.children
502
- }
503
- }
504
-
505
- // Usage
506
- <ErrorBoundary>
507
- <App />
508
- </ErrorBoundary>
509
- ```
510
-
511
- ## Animation Patterns
512
-
513
- ### Framer Motion Animations
514
-
515
- ```typescript
516
- import { motion, AnimatePresence } from 'framer-motion'
517
-
518
- // PASS: List animations
519
- export function AnimatedMarketList({ markets }: { markets: Market[] }) {
520
- return (
521
- <AnimatePresence>
522
- {markets.map(market => (
523
- <motion.div
524
- key={market.id}
525
- initial={{ opacity: 0, y: 20 }}
526
- animate={{ opacity: 1, y: 0 }}
527
- exit={{ opacity: 0, y: -20 }}
528
- transition={{ duration: 0.3 }}
529
- >
530
- <MarketCard market={market} />
531
- </motion.div>
532
- ))}
533
- </AnimatePresence>
534
- )
535
- }
536
-
537
- // PASS: Modal animations
538
- export function Modal({ isOpen, onClose, children }: ModalProps) {
539
- return (
540
- <AnimatePresence>
541
- {isOpen && (
542
- <>
543
- <motion.div
544
- className="modal-overlay"
545
- initial={{ opacity: 0 }}
546
- animate={{ opacity: 1 }}
547
- exit={{ opacity: 0 }}
548
- onClick={onClose}
549
- />
550
- <motion.div
551
- className="modal-content"
552
- initial={{ opacity: 0, scale: 0.9, y: 20 }}
553
- animate={{ opacity: 1, scale: 1, y: 0 }}
554
- exit={{ opacity: 0, scale: 0.9, y: 20 }}
555
- >
556
- {children}
557
- </motion.div>
558
- </>
559
- )}
560
- </AnimatePresence>
561
- )
562
- }
563
- ```
564
-
565
- ## Accessibility Patterns
566
-
567
- ### Keyboard Navigation
568
-
569
- ```typescript
570
- export function Dropdown({ options, onSelect }: DropdownProps) {
571
- const [isOpen, setIsOpen] = useState(false)
572
- const [activeIndex, setActiveIndex] = useState(0)
573
-
574
- const handleKeyDown = (e: React.KeyboardEvent) => {
575
- switch (e.key) {
576
- case 'ArrowDown':
577
- e.preventDefault()
578
- setActiveIndex(i => Math.min(i + 1, options.length - 1))
579
- break
580
- case 'ArrowUp':
581
- e.preventDefault()
582
- setActiveIndex(i => Math.max(i - 1, 0))
583
- break
584
- case 'Enter':
585
- e.preventDefault()
586
- onSelect(options[activeIndex])
587
- setIsOpen(false)
588
- break
589
- case 'Escape':
590
- setIsOpen(false)
591
- break
592
- }
593
- }
594
-
595
- return (
596
- <div
597
- role="combobox"
598
- aria-expanded={isOpen}
599
- aria-haspopup="listbox"
600
- onKeyDown={handleKeyDown}
601
- >
602
- {/* Dropdown implementation */}
603
- </div>
604
- )
605
- }
606
- ```
607
-
608
- ### Focus Management
609
-
610
- ```typescript
611
- export function Modal({ isOpen, onClose, children }: ModalProps) {
612
- const modalRef = useRef<HTMLDivElement>(null)
613
- const previousFocusRef = useRef<HTMLElement | null>(null)
614
-
615
- useEffect(() => {
616
- if (isOpen) {
617
- // Save currently focused element
618
- previousFocusRef.current = document.activeElement as HTMLElement
619
-
620
- // Focus modal
621
- modalRef.current?.focus()
622
- } else {
623
- // Restore focus when closing
624
- previousFocusRef.current?.focus()
625
- }
626
- }, [isOpen])
627
-
628
- return isOpen ? (
629
- <div
630
- ref={modalRef}
631
- role="dialog"
632
- aria-modal="true"
633
- tabIndex={-1}
634
- onKeyDown={e => e.key === 'Escape' && onClose()}
635
- >
636
- {children}
637
- </div>
638
- ) : null
639
- }
640
- ```
641
-
642
- **Remember**: Modern frontend patterns enable maintainable, performant user interfaces. Choose patterns that fit your project complexity.
1
+ ---
2
+ name: frontend-patterns
3
+ description: Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.
4
+ origin: ECC
5
+ ---
6
+
7
+ # Frontend Development Patterns
8
+
9
+ Modern frontend patterns for React, Next.js, and performant user interfaces.
10
+
11
+ ## When to Activate
12
+
13
+ - Building React components (composition, props, rendering)
14
+ - Managing state (useState, useReducer, Zustand, Context)
15
+ - Implementing data fetching (SWR, React Query, server components)
16
+ - Optimizing performance (memoization, virtualization, code splitting)
17
+ - Working with forms (validation, controlled inputs, Zod schemas)
18
+ - Handling client-side routing and navigation
19
+ - Building accessible, responsive UI patterns
20
+
21
+ ## Component Patterns
22
+
23
+ ### Composition Over Inheritance
24
+
25
+ ```typescript
26
+ // PASS: GOOD: Component composition
27
+ interface CardProps {
28
+ children: React.ReactNode
29
+ variant?: 'default' | 'outlined'
30
+ }
31
+
32
+ export function Card({ children, variant = 'default' }: CardProps) {
33
+ return <div className={`card card-${variant}`}>{children}</div>
34
+ }
35
+
36
+ export function CardHeader({ children }: { children: React.ReactNode }) {
37
+ return <div className="card-header">{children}</div>
38
+ }
39
+
40
+ export function CardBody({ children }: { children: React.ReactNode }) {
41
+ return <div className="card-body">{children}</div>
42
+ }
43
+
44
+ // Usage
45
+ <Card>
46
+ <CardHeader>Title</CardHeader>
47
+ <CardBody>Content</CardBody>
48
+ </Card>
49
+ ```
50
+
51
+ ### Compound Components
52
+
53
+ ```typescript
54
+ interface TabsContextValue {
55
+ activeTab: string
56
+ setActiveTab: (tab: string) => void
57
+ }
58
+
59
+ const TabsContext = createContext<TabsContextValue | undefined>(undefined)
60
+
61
+ export function Tabs({ children, defaultTab }: {
62
+ children: React.ReactNode
63
+ defaultTab: string
64
+ }) {
65
+ const [activeTab, setActiveTab] = useState(defaultTab)
66
+
67
+ return (
68
+ <TabsContext.Provider value={{ activeTab, setActiveTab }}>
69
+ {children}
70
+ </TabsContext.Provider>
71
+ )
72
+ }
73
+
74
+ export function TabList({ children }: { children: React.ReactNode }) {
75
+ return <div className="tab-list">{children}</div>
76
+ }
77
+
78
+ export function Tab({ id, children }: { id: string, children: React.ReactNode }) {
79
+ const context = useContext(TabsContext)
80
+ if (!context) throw new Error('Tab must be used within Tabs')
81
+
82
+ return (
83
+ <button
84
+ className={context.activeTab === id ? 'active' : ''}
85
+ onClick={() => context.setActiveTab(id)}
86
+ >
87
+ {children}
88
+ </button>
89
+ )
90
+ }
91
+
92
+ // Usage
93
+ <Tabs defaultTab="overview">
94
+ <TabList>
95
+ <Tab id="overview">Overview</Tab>
96
+ <Tab id="details">Details</Tab>
97
+ </TabList>
98
+ </Tabs>
99
+ ```
100
+
101
+ ### Render Props Pattern
102
+
103
+ ```typescript
104
+ interface DataLoaderProps<T> {
105
+ url: string
106
+ children: (data: T | null, loading: boolean, error: Error | null) => React.ReactNode
107
+ }
108
+
109
+ export function DataLoader<T>({ url, children }: DataLoaderProps<T>) {
110
+ const [data, setData] = useState<T | null>(null)
111
+ const [loading, setLoading] = useState(true)
112
+ const [error, setError] = useState<Error | null>(null)
113
+
114
+ useEffect(() => {
115
+ fetch(url)
116
+ .then(res => res.json())
117
+ .then(setData)
118
+ .catch(setError)
119
+ .finally(() => setLoading(false))
120
+ }, [url])
121
+
122
+ return <>{children(data, loading, error)}</>
123
+ }
124
+
125
+ // Usage
126
+ <DataLoader<Market[]> url="/api/markets">
127
+ {(markets, loading, error) => {
128
+ if (loading) return <Spinner />
129
+ if (error) return <Error error={error} />
130
+ return <MarketList markets={markets!} />
131
+ }}
132
+ </DataLoader>
133
+ ```
134
+
135
+ ## Custom Hooks Patterns
136
+
137
+ ### State Management Hook
138
+
139
+ ```typescript
140
+ export function useToggle(initialValue = false): [boolean, () => void] {
141
+ const [value, setValue] = useState(initialValue)
142
+
143
+ const toggle = useCallback(() => {
144
+ setValue(v => !v)
145
+ }, [])
146
+
147
+ return [value, toggle]
148
+ }
149
+
150
+ // Usage
151
+ const [isOpen, toggleOpen] = useToggle()
152
+ ```
153
+
154
+ ### Async Data Fetching Hook
155
+
156
+ ```typescript
157
+ interface UseQueryOptions<T> {
158
+ onSuccess?: (data: T) => void
159
+ onError?: (error: Error) => void
160
+ enabled?: boolean
161
+ }
162
+
163
+ export function useQuery<T>(
164
+ key: string,
165
+ fetcher: () => Promise<T>,
166
+ options?: UseQueryOptions<T>
167
+ ) {
168
+ const [data, setData] = useState<T | null>(null)
169
+ const [error, setError] = useState<Error | null>(null)
170
+ const [loading, setLoading] = useState(false)
171
+
172
+ const refetch = useCallback(async () => {
173
+ setLoading(true)
174
+ setError(null)
175
+
176
+ try {
177
+ const result = await fetcher()
178
+ setData(result)
179
+ options?.onSuccess?.(result)
180
+ } catch (err) {
181
+ const error = err as Error
182
+ setError(error)
183
+ options?.onError?.(error)
184
+ } finally {
185
+ setLoading(false)
186
+ }
187
+ }, [fetcher, options])
188
+
189
+ useEffect(() => {
190
+ if (options?.enabled !== false) {
191
+ refetch()
192
+ }
193
+ }, [key, refetch, options?.enabled])
194
+
195
+ return { data, error, loading, refetch }
196
+ }
197
+
198
+ // Usage
199
+ const { data: markets, loading, error, refetch } = useQuery(
200
+ 'markets',
201
+ () => fetch('/api/markets').then(r => r.json()),
202
+ {
203
+ onSuccess: data => console.log('Fetched', data.length, 'markets'),
204
+ onError: err => console.error('Failed:', err)
205
+ }
206
+ )
207
+ ```
208
+
209
+ ### Debounce Hook
210
+
211
+ ```typescript
212
+ export function useDebounce<T>(value: T, delay: number): T {
213
+ const [debouncedValue, setDebouncedValue] = useState<T>(value)
214
+
215
+ useEffect(() => {
216
+ const handler = setTimeout(() => {
217
+ setDebouncedValue(value)
218
+ }, delay)
219
+
220
+ return () => clearTimeout(handler)
221
+ }, [value, delay])
222
+
223
+ return debouncedValue
224
+ }
225
+
226
+ // Usage
227
+ const [searchQuery, setSearchQuery] = useState('')
228
+ const debouncedQuery = useDebounce(searchQuery, 500)
229
+
230
+ useEffect(() => {
231
+ if (debouncedQuery) {
232
+ performSearch(debouncedQuery)
233
+ }
234
+ }, [debouncedQuery])
235
+ ```
236
+
237
+ ## State Management Patterns
238
+
239
+ ### Context + Reducer Pattern
240
+
241
+ ```typescript
242
+ interface State {
243
+ markets: Market[]
244
+ selectedMarket: Market | null
245
+ loading: boolean
246
+ }
247
+
248
+ type Action =
249
+ | { type: 'SET_MARKETS'; payload: Market[] }
250
+ | { type: 'SELECT_MARKET'; payload: Market }
251
+ | { type: 'SET_LOADING'; payload: boolean }
252
+
253
+ function reducer(state: State, action: Action): State {
254
+ switch (action.type) {
255
+ case 'SET_MARKETS':
256
+ return { ...state, markets: action.payload }
257
+ case 'SELECT_MARKET':
258
+ return { ...state, selectedMarket: action.payload }
259
+ case 'SET_LOADING':
260
+ return { ...state, loading: action.payload }
261
+ default:
262
+ return state
263
+ }
264
+ }
265
+
266
+ const MarketContext = createContext<{
267
+ state: State
268
+ dispatch: Dispatch<Action>
269
+ } | undefined>(undefined)
270
+
271
+ export function MarketProvider({ children }: { children: React.ReactNode }) {
272
+ const [state, dispatch] = useReducer(reducer, {
273
+ markets: [],
274
+ selectedMarket: null,
275
+ loading: false
276
+ })
277
+
278
+ return (
279
+ <MarketContext.Provider value={{ state, dispatch }}>
280
+ {children}
281
+ </MarketContext.Provider>
282
+ )
283
+ }
284
+
285
+ export function useMarkets() {
286
+ const context = useContext(MarketContext)
287
+ if (!context) throw new Error('useMarkets must be used within MarketProvider')
288
+ return context
289
+ }
290
+ ```
291
+
292
+ ## Performance Optimization
293
+
294
+ ### Memoization
295
+
296
+ ```typescript
297
+ // PASS: useMemo for expensive computations
298
+ const sortedMarkets = useMemo(() => {
299
+ return markets.sort((a, b) => b.volume - a.volume)
300
+ }, [markets])
301
+
302
+ // PASS: useCallback for functions passed to children
303
+ const handleSearch = useCallback((query: string) => {
304
+ setSearchQuery(query)
305
+ }, [])
306
+
307
+ // PASS: React.memo for pure components
308
+ export const MarketCard = React.memo<MarketCardProps>(({ market }) => {
309
+ return (
310
+ <div className="market-card">
311
+ <h3>{market.name}</h3>
312
+ <p>{market.description}</p>
313
+ </div>
314
+ )
315
+ })
316
+ ```
317
+
318
+ ### Code Splitting & Lazy Loading
319
+
320
+ ```typescript
321
+ import { lazy, Suspense } from 'react'
322
+
323
+ // PASS: Lazy load heavy components
324
+ const HeavyChart = lazy(() => import('./HeavyChart'))
325
+ const ThreeJsBackground = lazy(() => import('./ThreeJsBackground'))
326
+
327
+ export function Dashboard() {
328
+ return (
329
+ <div>
330
+ <Suspense fallback={<ChartSkeleton />}>
331
+ <HeavyChart data={data} />
332
+ </Suspense>
333
+
334
+ <Suspense fallback={null}>
335
+ <ThreeJsBackground />
336
+ </Suspense>
337
+ </div>
338
+ )
339
+ }
340
+ ```
341
+
342
+ ### Virtualization for Long Lists
343
+
344
+ ```typescript
345
+ import { useVirtualizer } from '@tanstack/react-virtual'
346
+
347
+ export function VirtualMarketList({ markets }: { markets: Market[] }) {
348
+ const parentRef = useRef<HTMLDivElement>(null)
349
+
350
+ const virtualizer = useVirtualizer({
351
+ count: markets.length,
352
+ getScrollElement: () => parentRef.current,
353
+ estimateSize: () => 100, // Estimated row height
354
+ overscan: 5 // Extra items to render
355
+ })
356
+
357
+ return (
358
+ <div ref={parentRef} style={{ height: '600px', overflow: 'auto' }}>
359
+ <div
360
+ style={{
361
+ height: `${virtualizer.getTotalSize()}px`,
362
+ position: 'relative'
363
+ }}
364
+ >
365
+ {virtualizer.getVirtualItems().map(virtualRow => (
366
+ <div
367
+ key={virtualRow.index}
368
+ style={{
369
+ position: 'absolute',
370
+ top: 0,
371
+ left: 0,
372
+ width: '100%',
373
+ height: `${virtualRow.size}px`,
374
+ transform: `translateY(${virtualRow.start}px)`
375
+ }}
376
+ >
377
+ <MarketCard market={markets[virtualRow.index]} />
378
+ </div>
379
+ ))}
380
+ </div>
381
+ </div>
382
+ )
383
+ }
384
+ ```
385
+
386
+ ## Form Handling Patterns
387
+
388
+ ### Controlled Form with Validation
389
+
390
+ ```typescript
391
+ interface FormData {
392
+ name: string
393
+ description: string
394
+ endDate: string
395
+ }
396
+
397
+ interface FormErrors {
398
+ name?: string
399
+ description?: string
400
+ endDate?: string
401
+ }
402
+
403
+ export function CreateMarketForm() {
404
+ const [formData, setFormData] = useState<FormData>({
405
+ name: '',
406
+ description: '',
407
+ endDate: ''
408
+ })
409
+
410
+ const [errors, setErrors] = useState<FormErrors>({})
411
+
412
+ const validate = (): boolean => {
413
+ const newErrors: FormErrors = {}
414
+
415
+ if (!formData.name.trim()) {
416
+ newErrors.name = 'Name is required'
417
+ } else if (formData.name.length > 200) {
418
+ newErrors.name = 'Name must be under 200 characters'
419
+ }
420
+
421
+ if (!formData.description.trim()) {
422
+ newErrors.description = 'Description is required'
423
+ }
424
+
425
+ if (!formData.endDate) {
426
+ newErrors.endDate = 'End date is required'
427
+ }
428
+
429
+ setErrors(newErrors)
430
+ return Object.keys(newErrors).length === 0
431
+ }
432
+
433
+ const handleSubmit = async (e: React.FormEvent) => {
434
+ e.preventDefault()
435
+
436
+ if (!validate()) return
437
+
438
+ try {
439
+ await createMarket(formData)
440
+ // Success handling
441
+ } catch (error) {
442
+ // Error handling
443
+ }
444
+ }
445
+
446
+ return (
447
+ <form onSubmit={handleSubmit}>
448
+ <input
449
+ value={formData.name}
450
+ onChange={e => setFormData(prev => ({ ...prev, name: e.target.value }))}
451
+ placeholder="Market name"
452
+ />
453
+ {errors.name && <span className="error">{errors.name}</span>}
454
+
455
+ {/* Other fields */}
456
+
457
+ <button type="submit">Create Market</button>
458
+ </form>
459
+ )
460
+ }
461
+ ```
462
+
463
+ ## Error Boundary Pattern
464
+
465
+ ```typescript
466
+ interface ErrorBoundaryState {
467
+ hasError: boolean
468
+ error: Error | null
469
+ }
470
+
471
+ export class ErrorBoundary extends React.Component<
472
+ { children: React.ReactNode },
473
+ ErrorBoundaryState
474
+ > {
475
+ state: ErrorBoundaryState = {
476
+ hasError: false,
477
+ error: null
478
+ }
479
+
480
+ static getDerivedStateFromError(error: Error): ErrorBoundaryState {
481
+ return { hasError: true, error }
482
+ }
483
+
484
+ componentDidCatch(error: Error, errorInfo: React.ErrorInfo) {
485
+ console.error('Error boundary caught:', error, errorInfo)
486
+ }
487
+
488
+ render() {
489
+ if (this.state.hasError) {
490
+ return (
491
+ <div className="error-fallback">
492
+ <h2>Something went wrong</h2>
493
+ <p>{this.state.error?.message}</p>
494
+ <button onClick={() => this.setState({ hasError: false })}>
495
+ Try again
496
+ </button>
497
+ </div>
498
+ )
499
+ }
500
+
501
+ return this.props.children
502
+ }
503
+ }
504
+
505
+ // Usage
506
+ <ErrorBoundary>
507
+ <App />
508
+ </ErrorBoundary>
509
+ ```
510
+
511
+ ## Animation Patterns
512
+
513
+ ### Framer Motion Animations
514
+
515
+ ```typescript
516
+ import { motion, AnimatePresence } from 'framer-motion'
517
+
518
+ // PASS: List animations
519
+ export function AnimatedMarketList({ markets }: { markets: Market[] }) {
520
+ return (
521
+ <AnimatePresence>
522
+ {markets.map(market => (
523
+ <motion.div
524
+ key={market.id}
525
+ initial={{ opacity: 0, y: 20 }}
526
+ animate={{ opacity: 1, y: 0 }}
527
+ exit={{ opacity: 0, y: -20 }}
528
+ transition={{ duration: 0.3 }}
529
+ >
530
+ <MarketCard market={market} />
531
+ </motion.div>
532
+ ))}
533
+ </AnimatePresence>
534
+ )
535
+ }
536
+
537
+ // PASS: Modal animations
538
+ export function Modal({ isOpen, onClose, children }: ModalProps) {
539
+ return (
540
+ <AnimatePresence>
541
+ {isOpen && (
542
+ <>
543
+ <motion.div
544
+ className="modal-overlay"
545
+ initial={{ opacity: 0 }}
546
+ animate={{ opacity: 1 }}
547
+ exit={{ opacity: 0 }}
548
+ onClick={onClose}
549
+ />
550
+ <motion.div
551
+ className="modal-content"
552
+ initial={{ opacity: 0, scale: 0.9, y: 20 }}
553
+ animate={{ opacity: 1, scale: 1, y: 0 }}
554
+ exit={{ opacity: 0, scale: 0.9, y: 20 }}
555
+ >
556
+ {children}
557
+ </motion.div>
558
+ </>
559
+ )}
560
+ </AnimatePresence>
561
+ )
562
+ }
563
+ ```
564
+
565
+ ## Accessibility Patterns
566
+
567
+ ### Keyboard Navigation
568
+
569
+ ```typescript
570
+ export function Dropdown({ options, onSelect }: DropdownProps) {
571
+ const [isOpen, setIsOpen] = useState(false)
572
+ const [activeIndex, setActiveIndex] = useState(0)
573
+
574
+ const handleKeyDown = (e: React.KeyboardEvent) => {
575
+ switch (e.key) {
576
+ case 'ArrowDown':
577
+ e.preventDefault()
578
+ setActiveIndex(i => Math.min(i + 1, options.length - 1))
579
+ break
580
+ case 'ArrowUp':
581
+ e.preventDefault()
582
+ setActiveIndex(i => Math.max(i - 1, 0))
583
+ break
584
+ case 'Enter':
585
+ e.preventDefault()
586
+ onSelect(options[activeIndex])
587
+ setIsOpen(false)
588
+ break
589
+ case 'Escape':
590
+ setIsOpen(false)
591
+ break
592
+ }
593
+ }
594
+
595
+ return (
596
+ <div
597
+ role="combobox"
598
+ aria-expanded={isOpen}
599
+ aria-haspopup="listbox"
600
+ onKeyDown={handleKeyDown}
601
+ >
602
+ {/* Dropdown implementation */}
603
+ </div>
604
+ )
605
+ }
606
+ ```
607
+
608
+ ### Focus Management
609
+
610
+ ```typescript
611
+ export function Modal({ isOpen, onClose, children }: ModalProps) {
612
+ const modalRef = useRef<HTMLDivElement>(null)
613
+ const previousFocusRef = useRef<HTMLElement | null>(null)
614
+
615
+ useEffect(() => {
616
+ if (isOpen) {
617
+ // Save currently focused element
618
+ previousFocusRef.current = document.activeElement as HTMLElement
619
+
620
+ // Focus modal
621
+ modalRef.current?.focus()
622
+ } else {
623
+ // Restore focus when closing
624
+ previousFocusRef.current?.focus()
625
+ }
626
+ }, [isOpen])
627
+
628
+ return isOpen ? (
629
+ <div
630
+ ref={modalRef}
631
+ role="dialog"
632
+ aria-modal="true"
633
+ tabIndex={-1}
634
+ onKeyDown={e => e.key === 'Escape' && onClose()}
635
+ >
636
+ {children}
637
+ </div>
638
+ ) : null
639
+ }
640
+ ```
641
+
642
+ **Remember**: Modern frontend patterns enable maintainable, performant user interfaces. Choose patterns that fit your project complexity.