@funnycode/myclaude 0.1.55 → 0.1.60

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