@funnycode/myclaude 0.1.76 → 0.1.77

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/SKILL-r7zmg5v7.md +3 -0
  3. package/dist/cli-mvr5k580.md +3 -0
  4. package/dist/myclaude.js +1367 -1189
  5. package/dist/myclaude.mjs +1367 -1189
  6. package/dist/server-zyhc2a9z.md +3 -0
  7. package/package.json +129 -129
  8. package/seed/marketplaces/ecc/.opencode/package-lock.json +169 -169
  9. package/seed/marketplaces/ecc/commands/aside.md +164 -164
  10. package/seed/marketplaces/ecc/commands/auto-update.md +28 -28
  11. package/seed/marketplaces/ecc/commands/build-fix.md +66 -66
  12. package/seed/marketplaces/ecc/commands/checkpoint.md +78 -78
  13. package/seed/marketplaces/ecc/commands/code-review.md +289 -289
  14. package/seed/marketplaces/ecc/commands/cost-report.md +107 -107
  15. package/seed/marketplaces/ecc/commands/cpp-build.md +173 -173
  16. package/seed/marketplaces/ecc/commands/cpp-review.md +132 -132
  17. package/seed/marketplaces/ecc/commands/cpp-test.md +251 -251
  18. package/seed/marketplaces/ecc/commands/ecc-guide.md +93 -93
  19. package/seed/marketplaces/ecc/commands/evolve.md +178 -178
  20. package/seed/marketplaces/ecc/commands/fastapi-review.md +39 -39
  21. package/seed/marketplaces/ecc/commands/feature-dev.md +49 -49
  22. package/seed/marketplaces/ecc/commands/flutter-build.md +164 -164
  23. package/seed/marketplaces/ecc/commands/flutter-review.md +116 -116
  24. package/seed/marketplaces/ecc/commands/flutter-test.md +144 -144
  25. package/seed/marketplaces/ecc/commands/gan-build.md +103 -103
  26. package/seed/marketplaces/ecc/commands/gan-design.md +39 -39
  27. package/seed/marketplaces/ecc/commands/go-build.md +183 -183
  28. package/seed/marketplaces/ecc/commands/go-review.md +148 -148
  29. package/seed/marketplaces/ecc/commands/go-test.md +268 -268
  30. package/seed/marketplaces/ecc/commands/gradle-build.md +70 -70
  31. package/seed/marketplaces/ecc/commands/harness-audit.md +84 -84
  32. package/seed/marketplaces/ecc/commands/hookify-configure.md +14 -14
  33. package/seed/marketplaces/ecc/commands/hookify-help.md +46 -46
  34. package/seed/marketplaces/ecc/commands/hookify-list.md +21 -21
  35. package/seed/marketplaces/ecc/commands/hookify.md +50 -50
  36. package/seed/marketplaces/ecc/commands/instinct-export.md +66 -66
  37. package/seed/marketplaces/ecc/commands/instinct-import.md +114 -114
  38. package/seed/marketplaces/ecc/commands/instinct-status.md +59 -59
  39. package/seed/marketplaces/ecc/commands/jira.md +106 -106
  40. package/seed/marketplaces/ecc/commands/kotlin-build.md +174 -174
  41. package/seed/marketplaces/ecc/commands/kotlin-review.md +140 -140
  42. package/seed/marketplaces/ecc/commands/kotlin-test.md +312 -312
  43. package/seed/marketplaces/ecc/commands/learn-eval.md +116 -116
  44. package/seed/marketplaces/ecc/commands/learn.md +74 -74
  45. package/seed/marketplaces/ecc/commands/loop-start.md +36 -36
  46. package/seed/marketplaces/ecc/commands/loop-status.md +77 -77
  47. package/seed/marketplaces/ecc/commands/marketing-campaign.md +129 -129
  48. package/seed/marketplaces/ecc/commands/model-route.md +30 -30
  49. package/seed/marketplaces/ecc/commands/multi-backend.md +162 -162
  50. package/seed/marketplaces/ecc/commands/multi-execute.md +319 -319
  51. package/seed/marketplaces/ecc/commands/multi-frontend.md +162 -162
  52. package/seed/marketplaces/ecc/commands/multi-plan.md +272 -272
  53. package/seed/marketplaces/ecc/commands/multi-workflow.md +195 -195
  54. package/seed/marketplaces/ecc/commands/plan-prd.md +160 -160
  55. package/seed/marketplaces/ecc/commands/plan.md +200 -200
  56. package/seed/marketplaces/ecc/commands/pm2.md +276 -276
  57. package/seed/marketplaces/ecc/commands/pr.md +184 -184
  58. package/seed/marketplaces/ecc/commands/project-init.md +86 -86
  59. package/seed/marketplaces/ecc/commands/projects.md +39 -39
  60. package/seed/marketplaces/ecc/commands/promote.md +41 -41
  61. package/seed/marketplaces/ecc/commands/prp-commit.md +112 -112
  62. package/seed/marketplaces/ecc/commands/prp-implement.md +385 -385
  63. package/seed/marketplaces/ecc/commands/prp-plan.md +502 -502
  64. package/seed/marketplaces/ecc/commands/prp-pr.md +184 -184
  65. package/seed/marketplaces/ecc/commands/prp-prd.md +447 -447
  66. package/seed/marketplaces/ecc/commands/prune.md +31 -31
  67. package/seed/marketplaces/ecc/commands/python-review.md +297 -297
  68. package/seed/marketplaces/ecc/commands/quality-gate.md +33 -33
  69. package/seed/marketplaces/ecc/commands/refactor-clean.md +84 -84
  70. package/seed/marketplaces/ecc/commands/resume-session.md +156 -156
  71. package/seed/marketplaces/ecc/commands/review-pr.md +37 -37
  72. package/seed/marketplaces/ecc/commands/rust-build.md +187 -187
  73. package/seed/marketplaces/ecc/commands/rust-review.md +142 -142
  74. package/seed/marketplaces/ecc/commands/rust-test.md +308 -308
  75. package/seed/marketplaces/ecc/commands/santa-loop.md +175 -175
  76. package/seed/marketplaces/ecc/commands/save-session.md +275 -275
  77. package/seed/marketplaces/ecc/commands/security-scan.md +92 -92
  78. package/seed/marketplaces/ecc/commands/sessions.md +339 -339
  79. package/seed/marketplaces/ecc/commands/setup-pm.md +80 -80
  80. package/seed/marketplaces/ecc/commands/skill-create.md +174 -174
  81. package/seed/marketplaces/ecc/commands/skill-health.md +54 -54
  82. package/seed/marketplaces/ecc/commands/test-coverage.md +73 -73
  83. package/seed/marketplaces/ecc/commands/update-codemaps.md +76 -76
  84. package/seed/marketplaces/ecc/commands/update-docs.md +88 -88
  85. package/seed/marketplaces/ecc/skills/accessibility/SKILL.md +146 -146
  86. package/seed/marketplaces/ecc/skills/agent-architecture-audit/SKILL.md +256 -256
  87. package/seed/marketplaces/ecc/skills/agent-eval/SKILL.md +145 -145
  88. package/seed/marketplaces/ecc/skills/agent-harness-construction/SKILL.md +73 -73
  89. package/seed/marketplaces/ecc/skills/agent-introspection-debugging/SKILL.md +153 -153
  90. package/seed/marketplaces/ecc/skills/agent-payment-x402/SKILL.md +224 -224
  91. package/seed/marketplaces/ecc/skills/agent-sort/SKILL.md +215 -215
  92. package/seed/marketplaces/ecc/skills/agentic-engineering/SKILL.md +63 -63
  93. package/seed/marketplaces/ecc/skills/agentic-os/SKILL.md +387 -387
  94. package/seed/marketplaces/ecc/skills/ai-first-engineering/SKILL.md +51 -51
  95. package/seed/marketplaces/ecc/skills/ai-regression-testing/SKILL.md +385 -385
  96. package/seed/marketplaces/ecc/skills/android-clean-architecture/SKILL.md +339 -339
  97. package/seed/marketplaces/ecc/skills/angular-developer/SKILL.md +154 -154
  98. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-animations.md +160 -160
  99. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-aria.md +410 -410
  100. package/seed/marketplaces/ecc/skills/angular-developer/references/cli.md +86 -86
  101. package/seed/marketplaces/ecc/skills/angular-developer/references/component-harnesses.md +59 -59
  102. package/seed/marketplaces/ecc/skills/angular-developer/references/component-styling.md +91 -91
  103. package/seed/marketplaces/ecc/skills/angular-developer/references/components.md +117 -117
  104. package/seed/marketplaces/ecc/skills/angular-developer/references/creating-services.md +97 -97
  105. package/seed/marketplaces/ecc/skills/angular-developer/references/data-resolvers.md +69 -69
  106. package/seed/marketplaces/ecc/skills/angular-developer/references/define-routes.md +67 -67
  107. package/seed/marketplaces/ecc/skills/angular-developer/references/defining-providers.md +72 -72
  108. package/seed/marketplaces/ecc/skills/angular-developer/references/di-fundamentals.md +120 -120
  109. package/seed/marketplaces/ecc/skills/angular-developer/references/e2e-testing.md +56 -56
  110. package/seed/marketplaces/ecc/skills/angular-developer/references/effects.md +83 -83
  111. package/seed/marketplaces/ecc/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  112. package/seed/marketplaces/ecc/skills/angular-developer/references/host-elements.md +80 -80
  113. package/seed/marketplaces/ecc/skills/angular-developer/references/injection-context.md +63 -63
  114. package/seed/marketplaces/ecc/skills/angular-developer/references/inputs.md +101 -101
  115. package/seed/marketplaces/ecc/skills/angular-developer/references/linked-signal.md +59 -59
  116. package/seed/marketplaces/ecc/skills/angular-developer/references/loading-strategies.md +61 -61
  117. package/seed/marketplaces/ecc/skills/angular-developer/references/mcp.md +108 -108
  118. package/seed/marketplaces/ecc/skills/angular-developer/references/navigate-to-routes.md +69 -69
  119. package/seed/marketplaces/ecc/skills/angular-developer/references/outputs.md +86 -86
  120. package/seed/marketplaces/ecc/skills/angular-developer/references/reactive-forms.md +122 -122
  121. package/seed/marketplaces/ecc/skills/angular-developer/references/rendering-strategies.md +44 -44
  122. package/seed/marketplaces/ecc/skills/angular-developer/references/resource.md +77 -77
  123. package/seed/marketplaces/ecc/skills/angular-developer/references/route-animations.md +56 -56
  124. package/seed/marketplaces/ecc/skills/angular-developer/references/route-guards.md +52 -52
  125. package/seed/marketplaces/ecc/skills/angular-developer/references/router-lifecycle.md +45 -45
  126. package/seed/marketplaces/ecc/skills/angular-developer/references/router-testing.md +87 -87
  127. package/seed/marketplaces/ecc/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  128. package/seed/marketplaces/ecc/skills/angular-developer/references/signal-forms.md +795 -795
  129. package/seed/marketplaces/ecc/skills/angular-developer/references/signals-overview.md +94 -94
  130. package/seed/marketplaces/ecc/skills/angular-developer/references/tailwind-css.md +69 -69
  131. package/seed/marketplaces/ecc/skills/angular-developer/references/template-driven-forms.md +114 -114
  132. package/seed/marketplaces/ecc/skills/angular-developer/references/testing-fundamentals.md +65 -65
  133. package/seed/marketplaces/ecc/skills/api-connector-builder/SKILL.md +120 -120
  134. package/seed/marketplaces/ecc/skills/api-design/SKILL.md +523 -523
  135. package/seed/marketplaces/ecc/skills/architecture-decision-records/SKILL.md +179 -179
  136. package/seed/marketplaces/ecc/skills/article-writing/SKILL.md +79 -79
  137. package/seed/marketplaces/ecc/skills/automation-audit-ops/SKILL.md +142 -142
  138. package/seed/marketplaces/ecc/skills/autonomous-agent-harness/SKILL.md +273 -273
  139. package/seed/marketplaces/ecc/skills/autonomous-loops/SKILL.md +610 -610
  140. package/seed/marketplaces/ecc/skills/backend-patterns/SKILL.md +561 -561
  141. package/seed/marketplaces/ecc/skills/benchmark/SKILL.md +93 -93
  142. package/seed/marketplaces/ecc/skills/benchmark-optimization-loop/SKILL.md +69 -69
  143. package/seed/marketplaces/ecc/skills/blender-motion-state-inspection/SKILL.md +164 -164
  144. package/seed/marketplaces/ecc/skills/blueprint/SKILL.md +105 -105
  145. package/seed/marketplaces/ecc/skills/brand-voice/SKILL.md +97 -97
  146. package/seed/marketplaces/ecc/skills/brand-voice/references/voice-profile-schema.md +55 -55
  147. package/seed/marketplaces/ecc/skills/browser-qa/SKILL.md +87 -87
  148. package/seed/marketplaces/ecc/skills/bun-runtime/SKILL.md +84 -84
  149. package/seed/marketplaces/ecc/skills/canary-watch/SKILL.md +107 -107
  150. package/seed/marketplaces/ecc/skills/carrier-relationship-management/SKILL.md +212 -212
  151. package/seed/marketplaces/ecc/skills/cisco-ios-patterns/SKILL.md +163 -163
  152. package/seed/marketplaces/ecc/skills/ck/SKILL.md +147 -147
  153. package/seed/marketplaces/ecc/skills/ck/commands/forget.mjs +44 -44
  154. package/seed/marketplaces/ecc/skills/ck/commands/info.mjs +24 -24
  155. package/seed/marketplaces/ecc/skills/ck/commands/init.mjs +143 -143
  156. package/seed/marketplaces/ecc/skills/ck/commands/list.mjs +40 -40
  157. package/seed/marketplaces/ecc/skills/ck/commands/migrate.mjs +202 -202
  158. package/seed/marketplaces/ecc/skills/ck/commands/resume.mjs +36 -36
  159. package/seed/marketplaces/ecc/skills/ck/commands/save.mjs +210 -210
  160. package/seed/marketplaces/ecc/skills/ck/commands/shared.mjs +387 -387
  161. package/seed/marketplaces/ecc/skills/ck/hooks/session-start.mjs +224 -224
  162. package/seed/marketplaces/ecc/skills/claude-devfleet/SKILL.md +103 -103
  163. package/seed/marketplaces/ecc/skills/click-path-audit/SKILL.md +244 -244
  164. package/seed/marketplaces/ecc/skills/clickhouse-io/SKILL.md +439 -439
  165. package/seed/marketplaces/ecc/skills/code-tour/SKILL.md +236 -236
  166. package/seed/marketplaces/ecc/skills/codebase-onboarding/SKILL.md +233 -233
  167. package/seed/marketplaces/ecc/skills/coding-standards/SKILL.md +549 -549
  168. package/seed/marketplaces/ecc/skills/compose-multiplatform-patterns/SKILL.md +299 -299
  169. package/seed/marketplaces/ecc/skills/configure-ecc/SKILL.md +384 -384
  170. package/seed/marketplaces/ecc/skills/connections-optimizer/SKILL.md +189 -189
  171. package/seed/marketplaces/ecc/skills/content-engine/SKILL.md +131 -131
  172. package/seed/marketplaces/ecc/skills/content-hash-cache-pattern/SKILL.md +161 -161
  173. package/seed/marketplaces/ecc/skills/context-budget/SKILL.md +135 -135
  174. package/seed/marketplaces/ecc/skills/continuous-agent-loop/SKILL.md +45 -45
  175. package/seed/marketplaces/ecc/skills/continuous-learning/SKILL.md +131 -131
  176. package/seed/marketplaces/ecc/skills/continuous-learning/config.json +18 -18
  177. package/seed/marketplaces/ecc/skills/continuous-learning/evaluate-session.sh +69 -69
  178. package/seed/marketplaces/ecc/skills/continuous-learning-v2/SKILL.md +360 -360
  179. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer-loop.sh +322 -322
  180. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer.md +198 -198
  181. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/session-guardian.sh +150 -150
  182. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/start-observer.sh +248 -248
  183. package/seed/marketplaces/ecc/skills/continuous-learning-v2/config.json +8 -8
  184. package/seed/marketplaces/ecc/skills/continuous-learning-v2/hooks/observe.sh +498 -498
  185. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/detect-project.sh +322 -322
  186. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/instinct-cli.py +1826 -1826
  187. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/lib/homunculus-dir.sh +31 -31
  188. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/migrate-homunculus.sh +62 -62
  189. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/test_parse_instinct.py +1018 -1018
  190. package/seed/marketplaces/ecc/skills/cost-aware-llm-pipeline/SKILL.md +183 -183
  191. package/seed/marketplaces/ecc/skills/cost-tracking/SKILL.md +147 -147
  192. package/seed/marketplaces/ecc/skills/council/SKILL.md +203 -203
  193. package/seed/marketplaces/ecc/skills/cpp-coding-standards/SKILL.md +723 -723
  194. package/seed/marketplaces/ecc/skills/cpp-testing/SKILL.md +324 -324
  195. package/seed/marketplaces/ecc/skills/crosspost/SKILL.md +111 -111
  196. package/seed/marketplaces/ecc/skills/csharp-testing/SKILL.md +321 -321
  197. package/seed/marketplaces/ecc/skills/customer-billing-ops/SKILL.md +140 -140
  198. package/seed/marketplaces/ecc/skills/customs-trade-compliance/SKILL.md +263 -263
  199. package/seed/marketplaces/ecc/skills/dart-flutter-patterns/SKILL.md +563 -563
  200. package/seed/marketplaces/ecc/skills/dashboard-builder/SKILL.md +108 -108
  201. package/seed/marketplaces/ecc/skills/data-scraper-agent/SKILL.md +764 -764
  202. package/seed/marketplaces/ecc/skills/data-throughput-accelerator/SKILL.md +72 -72
  203. package/seed/marketplaces/ecc/skills/database-migrations/SKILL.md +429 -429
  204. package/seed/marketplaces/ecc/skills/deep-research/SKILL.md +159 -159
  205. package/seed/marketplaces/ecc/skills/defi-amm-security/SKILL.md +166 -166
  206. package/seed/marketplaces/ecc/skills/deployment-patterns/SKILL.md +427 -427
  207. package/seed/marketplaces/ecc/skills/design-system/SKILL.md +82 -82
  208. package/seed/marketplaces/ecc/skills/django-celery/SKILL.md +457 -457
  209. package/seed/marketplaces/ecc/skills/django-patterns/SKILL.md +734 -734
  210. package/seed/marketplaces/ecc/skills/django-security/SKILL.md +593 -593
  211. package/seed/marketplaces/ecc/skills/django-tdd/SKILL.md +729 -729
  212. package/seed/marketplaces/ecc/skills/django-verification/SKILL.md +469 -469
  213. package/seed/marketplaces/ecc/skills/dmux-workflows/SKILL.md +191 -191
  214. package/seed/marketplaces/ecc/skills/docker-patterns/SKILL.md +364 -364
  215. package/seed/marketplaces/ecc/skills/documentation-lookup/SKILL.md +90 -90
  216. package/seed/marketplaces/ecc/skills/dotnet-patterns/SKILL.md +321 -321
  217. package/seed/marketplaces/ecc/skills/e2e-testing/SKILL.md +326 -326
  218. package/seed/marketplaces/ecc/skills/ecc-guide/SKILL.md +189 -189
  219. package/seed/marketplaces/ecc/skills/ecc-tools-cost-audit/SKILL.md +160 -160
  220. package/seed/marketplaces/ecc/skills/email-ops/SKILL.md +121 -121
  221. package/seed/marketplaces/ecc/skills/energy-procurement/SKILL.md +228 -228
  222. package/seed/marketplaces/ecc/skills/enterprise-agent-ops/SKILL.md +50 -50
  223. package/seed/marketplaces/ecc/skills/error-handling/SKILL.md +376 -376
  224. package/seed/marketplaces/ecc/skills/eval-harness/SKILL.md +270 -270
  225. package/seed/marketplaces/ecc/skills/evm-token-decimals/SKILL.md +130 -130
  226. package/seed/marketplaces/ecc/skills/exa-search/SKILL.md +107 -107
  227. package/seed/marketplaces/ecc/skills/fal-ai-media/SKILL.md +288 -288
  228. package/seed/marketplaces/ecc/skills/fastapi-patterns/SKILL.md +327 -327
  229. package/seed/marketplaces/ecc/skills/finance-billing-ops/SKILL.md +127 -127
  230. package/seed/marketplaces/ecc/skills/flox-environments/SKILL.md +496 -496
  231. package/seed/marketplaces/ecc/skills/flutter-dart-code-review/SKILL.md +435 -435
  232. package/seed/marketplaces/ecc/skills/foundation-models-on-device/SKILL.md +243 -243
  233. package/seed/marketplaces/ecc/skills/frontend-a11y/SKILL.md +446 -446
  234. package/seed/marketplaces/ecc/skills/frontend-design-direction/SKILL.md +92 -92
  235. package/seed/marketplaces/ecc/skills/frontend-patterns/SKILL.md +642 -642
  236. package/seed/marketplaces/ecc/skills/frontend-slides/SKILL.md +184 -184
  237. package/seed/marketplaces/ecc/skills/frontend-slides/STYLE_PRESETS.md +330 -330
  238. package/seed/marketplaces/ecc/skills/frontend-slides/animation-patterns.md +122 -122
  239. package/seed/marketplaces/ecc/skills/frontend-slides/html-template.md +419 -419
  240. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/export-pdf.sh +418 -418
  241. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/extract-pptx.py +96 -96
  242. package/seed/marketplaces/ecc/skills/frontend-slides/viewport-base.css +153 -153
  243. package/seed/marketplaces/ecc/skills/fsharp-testing/SKILL.md +280 -280
  244. package/seed/marketplaces/ecc/skills/gan-style-harness/SKILL.md +278 -278
  245. package/seed/marketplaces/ecc/skills/gateguard/SKILL.md +125 -125
  246. package/seed/marketplaces/ecc/skills/git-workflow/SKILL.md +715 -715
  247. package/seed/marketplaces/ecc/skills/github-ops/SKILL.md +144 -144
  248. package/seed/marketplaces/ecc/skills/golang-patterns/SKILL.md +674 -674
  249. package/seed/marketplaces/ecc/skills/golang-testing/SKILL.md +720 -720
  250. package/seed/marketplaces/ecc/skills/google-workspace-ops/SKILL.md +95 -95
  251. package/seed/marketplaces/ecc/skills/healthcare-cdss-patterns/SKILL.md +245 -245
  252. package/seed/marketplaces/ecc/skills/healthcare-emr-patterns/SKILL.md +159 -159
  253. package/seed/marketplaces/ecc/skills/healthcare-eval-harness/SKILL.md +207 -207
  254. package/seed/marketplaces/ecc/skills/healthcare-phi-compliance/SKILL.md +145 -145
  255. package/seed/marketplaces/ecc/skills/hermes-imports/SKILL.md +88 -88
  256. package/seed/marketplaces/ecc/skills/hexagonal-architecture/SKILL.md +276 -276
  257. package/seed/marketplaces/ecc/skills/hipaa-compliance/SKILL.md +78 -78
  258. package/seed/marketplaces/ecc/skills/homelab-network-readiness/SKILL.md +169 -169
  259. package/seed/marketplaces/ecc/skills/homelab-network-setup/SKILL.md +129 -129
  260. package/seed/marketplaces/ecc/skills/homelab-pihole-dns/SKILL.md +274 -274
  261. package/seed/marketplaces/ecc/skills/homelab-vlan-segmentation/SKILL.md +311 -311
  262. package/seed/marketplaces/ecc/skills/homelab-wireguard-vpn/SKILL.md +305 -305
  263. package/seed/marketplaces/ecc/skills/hookify-rules/SKILL.md +128 -128
  264. package/seed/marketplaces/ecc/skills/inventory-demand-planning/SKILL.md +247 -247
  265. package/seed/marketplaces/ecc/skills/investor-materials/SKILL.md +96 -96
  266. package/seed/marketplaces/ecc/skills/investor-outreach/SKILL.md +91 -91
  267. package/seed/marketplaces/ecc/skills/ios-icon-gen/SKILL.md +157 -157
  268. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/generate_icons.swift +258 -258
  269. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/iconify_gen.sh +235 -235
  270. package/seed/marketplaces/ecc/skills/iterative-retrieval/SKILL.md +211 -211
  271. package/seed/marketplaces/ecc/skills/ito-basket-compare/SKILL.md +63 -63
  272. package/seed/marketplaces/ecc/skills/ito-data-atlas-agent/SKILL.md +63 -63
  273. package/seed/marketplaces/ecc/skills/ito-market-intelligence/SKILL.md +60 -60
  274. package/seed/marketplaces/ecc/skills/ito-trade-planner/SKILL.md +67 -67
  275. package/seed/marketplaces/ecc/skills/java-coding-standards/SKILL.md +383 -383
  276. package/seed/marketplaces/ecc/skills/jira-integration/SKILL.md +293 -293
  277. package/seed/marketplaces/ecc/skills/jpa-patterns/SKILL.md +151 -151
  278. package/seed/marketplaces/ecc/skills/knowledge-ops/SKILL.md +154 -154
  279. package/seed/marketplaces/ecc/skills/kotlin-coroutines-flows/SKILL.md +284 -284
  280. package/seed/marketplaces/ecc/skills/kotlin-exposed-patterns/SKILL.md +719 -719
  281. package/seed/marketplaces/ecc/skills/kotlin-ktor-patterns/SKILL.md +689 -689
  282. package/seed/marketplaces/ecc/skills/kotlin-patterns/SKILL.md +711 -711
  283. package/seed/marketplaces/ecc/skills/kotlin-testing/SKILL.md +824 -824
  284. package/seed/marketplaces/ecc/skills/laravel-patterns/SKILL.md +415 -415
  285. package/seed/marketplaces/ecc/skills/laravel-plugin-discovery/SKILL.md +229 -229
  286. package/seed/marketplaces/ecc/skills/laravel-security/SKILL.md +285 -285
  287. package/seed/marketplaces/ecc/skills/laravel-tdd/SKILL.md +283 -283
  288. package/seed/marketplaces/ecc/skills/laravel-verification/SKILL.md +179 -179
  289. package/seed/marketplaces/ecc/skills/latency-critical-systems/SKILL.md +73 -73
  290. package/seed/marketplaces/ecc/skills/lead-intelligence/SKILL.md +321 -321
  291. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/enrichment-agent.md +85 -85
  292. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/mutual-mapper.md +75 -75
  293. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/outreach-drafter.md +98 -98
  294. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/signal-scorer.md +60 -60
  295. package/seed/marketplaces/ecc/skills/liquid-glass-design/SKILL.md +279 -279
  296. package/seed/marketplaces/ecc/skills/llm-trading-agent-security/SKILL.md +146 -146
  297. package/seed/marketplaces/ecc/skills/logistics-exception-management/SKILL.md +222 -222
  298. package/seed/marketplaces/ecc/skills/make-interfaces-feel-better/SKILL.md +151 -151
  299. package/seed/marketplaces/ecc/skills/manim-video/SKILL.md +89 -89
  300. package/seed/marketplaces/ecc/skills/manim-video/assets/network_graph_scene.py +52 -52
  301. package/seed/marketplaces/ecc/skills/market-research/SKILL.md +75 -75
  302. package/seed/marketplaces/ecc/skills/marketing-campaign/SKILL.md +113 -113
  303. package/seed/marketplaces/ecc/skills/mcp-server-patterns/SKILL.md +69 -69
  304. package/seed/marketplaces/ecc/skills/messages-ops/SKILL.md +104 -104
  305. package/seed/marketplaces/ecc/skills/mle-workflow/SKILL.md +346 -346
  306. package/seed/marketplaces/ecc/skills/motion-advanced/SKILL.md +596 -596
  307. package/seed/marketplaces/ecc/skills/motion-foundations/SKILL.md +299 -299
  308. package/seed/marketplaces/ecc/skills/motion-patterns/SKILL.md +435 -435
  309. package/seed/marketplaces/ecc/skills/motion-ui/SKILL.md +575 -575
  310. package/seed/marketplaces/ecc/skills/mysql-patterns/SKILL.md +412 -412
  311. package/seed/marketplaces/ecc/skills/nanoclaw-repl/SKILL.md +33 -33
  312. package/seed/marketplaces/ecc/skills/nestjs-patterns/SKILL.md +230 -230
  313. package/seed/marketplaces/ecc/skills/netmiko-ssh-automation/SKILL.md +173 -173
  314. package/seed/marketplaces/ecc/skills/network-bgp-diagnostics/SKILL.md +167 -167
  315. package/seed/marketplaces/ecc/skills/network-config-validation/SKILL.md +210 -210
  316. package/seed/marketplaces/ecc/skills/network-interface-health/SKILL.md +152 -152
  317. package/seed/marketplaces/ecc/skills/nextjs-turbopack/SKILL.md +57 -57
  318. package/seed/marketplaces/ecc/skills/nodejs-keccak256/SKILL.md +102 -102
  319. package/seed/marketplaces/ecc/skills/nutrient-document-processing/SKILL.md +167 -167
  320. package/seed/marketplaces/ecc/skills/nuxt4-patterns/SKILL.md +100 -100
  321. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/SKILL.md +288 -288
  322. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.py +224 -224
  323. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.sh +5 -5
  324. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  325. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  326. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  327. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  328. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  329. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/output-template.md +166 -166
  330. package/seed/marketplaces/ecc/skills/opensource-pipeline/SKILL.md +255 -255
  331. package/seed/marketplaces/ecc/skills/parallel-execution-optimizer/SKILL.md +72 -72
  332. package/seed/marketplaces/ecc/skills/perl-patterns/SKILL.md +504 -504
  333. package/seed/marketplaces/ecc/skills/perl-security/SKILL.md +503 -503
  334. package/seed/marketplaces/ecc/skills/perl-testing/SKILL.md +475 -475
  335. package/seed/marketplaces/ecc/skills/plan-orchestrate/SKILL.md +262 -262
  336. package/seed/marketplaces/ecc/skills/plankton-code-quality/SKILL.md +236 -236
  337. package/seed/marketplaces/ecc/skills/postgres-patterns/SKILL.md +147 -147
  338. package/seed/marketplaces/ecc/skills/prediction-market-oracle-research/SKILL.md +63 -63
  339. package/seed/marketplaces/ecc/skills/prediction-market-risk-review/SKILL.md +60 -60
  340. package/seed/marketplaces/ecc/skills/prisma-patterns/SKILL.md +371 -371
  341. package/seed/marketplaces/ecc/skills/product-capability/SKILL.md +141 -141
  342. package/seed/marketplaces/ecc/skills/product-lens/SKILL.md +92 -92
  343. package/seed/marketplaces/ecc/skills/production-audit/SKILL.md +206 -206
  344. package/seed/marketplaces/ecc/skills/production-scheduling/SKILL.md +238 -238
  345. package/seed/marketplaces/ecc/skills/project-flow-ops/SKILL.md +111 -111
  346. package/seed/marketplaces/ecc/skills/prompt-optimizer/SKILL.md +398 -398
  347. package/seed/marketplaces/ecc/skills/python-patterns/SKILL.md +750 -750
  348. package/seed/marketplaces/ecc/skills/python-testing/SKILL.md +816 -816
  349. package/seed/marketplaces/ecc/skills/pytorch-patterns/SKILL.md +396 -396
  350. package/seed/marketplaces/ecc/skills/quality-nonconformance/SKILL.md +260 -260
  351. package/seed/marketplaces/ecc/skills/quarkus-patterns/SKILL.md +722 -722
  352. package/seed/marketplaces/ecc/skills/quarkus-security/SKILL.md +467 -467
  353. package/seed/marketplaces/ecc/skills/quarkus-tdd/SKILL.md +811 -811
  354. package/seed/marketplaces/ecc/skills/quarkus-verification/SKILL.md +479 -479
  355. package/seed/marketplaces/ecc/skills/ralphinho-rfc-pipeline/SKILL.md +67 -67
  356. package/seed/marketplaces/ecc/skills/recsys-pipeline-architect/SKILL.md +114 -114
  357. package/seed/marketplaces/ecc/skills/recursive-decision-ledger/SKILL.md +79 -79
  358. package/seed/marketplaces/ecc/skills/redis-patterns/SKILL.md +403 -403
  359. package/seed/marketplaces/ecc/skills/regex-vs-llm-structured-text/SKILL.md +220 -220
  360. package/seed/marketplaces/ecc/skills/remotion-video-creation/SKILL.md +43 -43
  361. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/3d.md +86 -86
  362. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/animations.md +29 -29
  363. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/charts-bar-chart.tsx +173 -173
  364. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-typewriter.tsx +100 -100
  365. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-word-highlight.tsx +108 -108
  366. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets.md +78 -78
  367. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/audio.md +172 -172
  368. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/calculate-metadata.md +104 -104
  369. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/can-decode.md +75 -75
  370. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/charts.md +58 -58
  371. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/compositions.md +146 -146
  372. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/display-captions.md +126 -126
  373. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/extract-frames.md +229 -229
  374. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/fonts.md +152 -152
  375. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-audio-duration.md +58 -58
  376. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-dimensions.md +68 -68
  377. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-duration.md +58 -58
  378. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/gifs.md +138 -138
  379. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/images.md +130 -130
  380. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/import-srt-captions.md +67 -67
  381. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/lottie.md +67 -67
  382. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-dom-nodes.md +34 -34
  383. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-text.md +143 -143
  384. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/sequencing.md +106 -106
  385. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/tailwind.md +11 -11
  386. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/text-animations.md +20 -20
  387. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/timing.md +179 -179
  388. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transcribe-captions.md +19 -19
  389. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transitions.md +122 -122
  390. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/trimming.md +52 -52
  391. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/videos.md +171 -171
  392. package/seed/marketplaces/ecc/skills/repo-scan/SKILL.md +78 -78
  393. package/seed/marketplaces/ecc/skills/research-ops/SKILL.md +112 -112
  394. package/seed/marketplaces/ecc/skills/returns-reverse-logistics/SKILL.md +240 -240
  395. package/seed/marketplaces/ecc/skills/rules-distill/SKILL.md +264 -264
  396. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-rules.sh +58 -58
  397. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-skills.sh +129 -129
  398. package/seed/marketplaces/ecc/skills/rust-patterns/SKILL.md +499 -499
  399. package/seed/marketplaces/ecc/skills/rust-testing/SKILL.md +500 -500
  400. package/seed/marketplaces/ecc/skills/safety-guard/SKILL.md +75 -75
  401. package/seed/marketplaces/ecc/skills/santa-method/SKILL.md +306 -306
  402. package/seed/marketplaces/ecc/skills/scientific-db-pubmed-database/SKILL.md +175 -175
  403. package/seed/marketplaces/ecc/skills/scientific-db-uspto-database/SKILL.md +177 -177
  404. package/seed/marketplaces/ecc/skills/scientific-pkg-gget/SKILL.md +166 -166
  405. package/seed/marketplaces/ecc/skills/scientific-thinking-literature-review/SKILL.md +192 -192
  406. package/seed/marketplaces/ecc/skills/scientific-thinking-scholar-evaluation/SKILL.md +160 -160
  407. package/seed/marketplaces/ecc/skills/search-first/SKILL.md +182 -182
  408. package/seed/marketplaces/ecc/skills/security-bounty-hunter/SKILL.md +99 -99
  409. package/seed/marketplaces/ecc/skills/security-review/SKILL.md +503 -503
  410. package/seed/marketplaces/ecc/skills/security-review/cloud-infrastructure-security.md +361 -361
  411. package/seed/marketplaces/ecc/skills/security-scan/SKILL.md +165 -165
  412. package/seed/marketplaces/ecc/skills/seo/SKILL.md +154 -154
  413. package/seed/marketplaces/ecc/skills/skill-comply/SKILL.md +58 -58
  414. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/compliant_trace.jsonl +5 -5
  415. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/noncompliant_trace.jsonl +3 -3
  416. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/tdd_spec.yaml +44 -44
  417. package/seed/marketplaces/ecc/skills/skill-comply/prompts/classifier.md +24 -24
  418. package/seed/marketplaces/ecc/skills/skill-comply/prompts/scenario_generator.md +62 -62
  419. package/seed/marketplaces/ecc/skills/skill-comply/prompts/spec_generator.md +42 -42
  420. package/seed/marketplaces/ecc/skills/skill-comply/pyproject.toml +15 -15
  421. package/seed/marketplaces/ecc/skills/skill-comply/scripts/classifier.py +85 -85
  422. package/seed/marketplaces/ecc/skills/skill-comply/scripts/grader.py +124 -124
  423. package/seed/marketplaces/ecc/skills/skill-comply/scripts/parser.py +107 -107
  424. package/seed/marketplaces/ecc/skills/skill-comply/scripts/report.py +170 -170
  425. package/seed/marketplaces/ecc/skills/skill-comply/scripts/run.py +127 -127
  426. package/seed/marketplaces/ecc/skills/skill-comply/scripts/runner.py +186 -186
  427. package/seed/marketplaces/ecc/skills/skill-comply/scripts/scenario_generator.py +70 -70
  428. package/seed/marketplaces/ecc/skills/skill-comply/scripts/spec_generator.py +72 -72
  429. package/seed/marketplaces/ecc/skills/skill-comply/scripts/utils.py +13 -13
  430. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_grader.py +197 -197
  431. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_parser.py +90 -90
  432. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_runner.py +172 -172
  433. package/seed/marketplaces/ecc/skills/skill-scout/SKILL.md +140 -140
  434. package/seed/marketplaces/ecc/skills/skill-stocktake/SKILL.md +194 -194
  435. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/quick-diff.sh +87 -87
  436. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/save-results.sh +56 -56
  437. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/scan.sh +170 -170
  438. package/seed/marketplaces/ecc/skills/social-graph-ranker/SKILL.md +154 -154
  439. package/seed/marketplaces/ecc/skills/social-publisher/SKILL.md +115 -115
  440. package/seed/marketplaces/ecc/skills/springboot-patterns/SKILL.md +314 -314
  441. package/seed/marketplaces/ecc/skills/springboot-security/SKILL.md +272 -272
  442. package/seed/marketplaces/ecc/skills/springboot-tdd/SKILL.md +158 -158
  443. package/seed/marketplaces/ecc/skills/springboot-verification/SKILL.md +231 -231
  444. package/seed/marketplaces/ecc/skills/strategic-compact/SKILL.md +131 -131
  445. package/seed/marketplaces/ecc/skills/swift-actor-persistence/SKILL.md +143 -143
  446. package/seed/marketplaces/ecc/skills/swift-concurrency-6-2/SKILL.md +216 -216
  447. package/seed/marketplaces/ecc/skills/swift-protocol-di-testing/SKILL.md +190 -190
  448. package/seed/marketplaces/ecc/skills/swiftui-patterns/SKILL.md +259 -259
  449. package/seed/marketplaces/ecc/skills/tdd-workflow/SKILL.md +463 -463
  450. package/seed/marketplaces/ecc/skills/team-builder/SKILL.md +168 -168
  451. package/seed/marketplaces/ecc/skills/terminal-ops/SKILL.md +109 -109
  452. package/seed/marketplaces/ecc/skills/tinystruct-patterns/SKILL.md +203 -203
  453. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/architecture.md +90 -90
  454. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/data-handling.md +60 -60
  455. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/database.md +99 -99
  456. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/routing.md +64 -64
  457. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/system-usage.md +97 -97
  458. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/testing.md +72 -72
  459. package/seed/marketplaces/ecc/skills/token-budget-advisor/SKILL.md +133 -133
  460. package/seed/marketplaces/ecc/skills/ui-demo/SKILL.md +465 -465
  461. package/seed/marketplaces/ecc/skills/ui-to-vue/SKILL.md +134 -134
  462. package/seed/marketplaces/ecc/skills/uncloud/SKILL.md +343 -343
  463. package/seed/marketplaces/ecc/skills/unified-notifications-ops/SKILL.md +187 -187
  464. package/seed/marketplaces/ecc/skills/verification-loop/SKILL.md +126 -126
  465. package/seed/marketplaces/ecc/skills/video-editing/SKILL.md +310 -310
  466. package/seed/marketplaces/ecc/skills/videodb/SKILL.md +374 -374
  467. package/seed/marketplaces/ecc/skills/videodb/reference/api-reference.md +550 -550
  468. package/seed/marketplaces/ecc/skills/videodb/reference/capture-reference.md +407 -407
  469. package/seed/marketplaces/ecc/skills/videodb/reference/capture.md +101 -101
  470. package/seed/marketplaces/ecc/skills/videodb/reference/editor.md +443 -443
  471. package/seed/marketplaces/ecc/skills/videodb/reference/generative.md +331 -331
  472. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream-reference.md +564 -564
  473. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream.md +65 -65
  474. package/seed/marketplaces/ecc/skills/videodb/reference/search.md +230 -230
  475. package/seed/marketplaces/ecc/skills/videodb/reference/streaming.md +406 -406
  476. package/seed/marketplaces/ecc/skills/videodb/reference/use-cases.md +118 -118
  477. package/seed/marketplaces/ecc/skills/videodb/scripts/ws_listener.py +282 -282
  478. package/seed/marketplaces/ecc/skills/visa-doc-translate/README.md +86 -86
  479. package/seed/marketplaces/ecc/skills/visa-doc-translate/SKILL.md +117 -117
  480. package/seed/marketplaces/ecc/skills/vite-patterns/SKILL.md +449 -449
  481. package/seed/marketplaces/ecc/skills/windows-desktop-e2e/SKILL.md +887 -887
  482. package/seed/marketplaces/ecc/skills/workspace-surface-audit/SKILL.md +125 -125
  483. package/seed/marketplaces/ecc/skills/x-api/SKILL.md +234 -234
  484. package/seed/marketplaces/ecc/.claude/commands/add-language-rules.md +0 -39
  485. package/seed/marketplaces/ecc/.claude/commands/database-migration.md +0 -36
  486. package/seed/marketplaces/ecc/.claude/commands/feature-development.md +0 -38
  487. package/seed/marketplaces/ecc/.claude/ecc-tools.json +0 -334
  488. package/seed/marketplaces/ecc/.claude/enterprise/controls.md +0 -15
  489. package/seed/marketplaces/ecc/.claude/homunculus/instincts/inherited/everything-claude-code-instincts.yaml +0 -162
  490. package/seed/marketplaces/ecc/.claude/identity.json +0 -14
  491. package/seed/marketplaces/ecc/.claude/package-manager.json +0 -4
  492. package/seed/marketplaces/ecc/.claude/research/everything-claude-code-research-playbook.md +0 -21
  493. package/seed/marketplaces/ecc/.claude/rules/everything-claude-code-guardrails.md +0 -43
  494. package/seed/marketplaces/ecc/.claude/rules/node.md +0 -56
  495. package/seed/marketplaces/ecc/.claude/skills/everything-claude-code/SKILL.md +0 -442
  496. package/seed/marketplaces/ecc/.claude/team/everything-claude-code-team-config.json +0 -15
  497. package/seed/marketplaces/ecc/.vscode/settings.json +0 -17
@@ -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.