adevkit 0.1.0__py3-none-any.whl

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 (731) hide show
  1. adevkit-0.1.0.dist-info/METADATA +171 -0
  2. adevkit-0.1.0.dist-info/RECORD +731 -0
  3. adevkit-0.1.0.dist-info/WHEEL +5 -0
  4. adevkit-0.1.0.dist-info/entry_points.txt +3 -0
  5. adevkit-0.1.0.dist-info/top_level.txt +1 -0
  6. devkit/__init__.py +4 -0
  7. devkit/cli.py +442 -0
  8. devkit/config.py +21 -0
  9. devkit/prompts.py +197 -0
  10. devkit/scaffold/__init__.py +16 -0
  11. devkit/scaffold/agents_md.py +152 -0
  12. devkit/scaffold/env_setup.py +59 -0
  13. devkit/scaffold/git_setup.py +69 -0
  14. devkit/scaffold/prd_md.py +85 -0
  15. devkit/scaffold/vscode_setup.py +38 -0
  16. devkit/skills/__init__.py +10 -0
  17. devkit/skills/catalog.py +156 -0
  18. devkit/skills/embedded/SKILL.md +52 -0
  19. devkit/skills/embedded/animate/RECIPES.md +324 -0
  20. devkit/skills/embedded/animate/SKILL.md +207 -0
  21. devkit/skills/embedded/animate-expo/RECIPES.md +385 -0
  22. devkit/skills/embedded/animate-expo/SKILL.md +263 -0
  23. devkit/skills/embedded/animation-performance/SKILL.md +222 -0
  24. devkit/skills/embedded/animation-vocabulary/SKILL.md +181 -0
  25. devkit/skills/embedded/apple-design/SKILL.md +290 -0
  26. devkit/skills/embedded/ask-sonner/API.md +64 -0
  27. devkit/skills/embedded/ask-sonner/SKILL.md +88 -0
  28. devkit/skills/embedded/banner-design/SKILL.md +145 -0
  29. devkit/skills/embedded/banner-design/references/banner-sizes-and-styles.md +118 -0
  30. devkit/skills/embedded/brand/SKILL.md +108 -0
  31. devkit/skills/embedded/brand/references/approval-checklist.md +169 -0
  32. devkit/skills/embedded/brand/references/asset-organization.md +157 -0
  33. devkit/skills/embedded/brand/references/brand-guideline-template.md +140 -0
  34. devkit/skills/embedded/brand/references/color-palette-management.md +186 -0
  35. devkit/skills/embedded/brand/references/consistency-checklist.md +94 -0
  36. devkit/skills/embedded/brand/references/logo-usage-rules.md +185 -0
  37. devkit/skills/embedded/brand/references/messaging-framework.md +85 -0
  38. devkit/skills/embedded/brand/references/typography-specifications.md +214 -0
  39. devkit/skills/embedded/brand/references/update.md +129 -0
  40. devkit/skills/embedded/brand/references/visual-identity.md +96 -0
  41. devkit/skills/embedded/brand/references/voice-framework.md +88 -0
  42. devkit/skills/embedded/brand/scripts/extract-colors.cjs +337 -0
  43. devkit/skills/embedded/brand/scripts/inject-brand-context.cjs +349 -0
  44. devkit/skills/embedded/brand/scripts/sync-brand-to-tokens.cjs +415 -0
  45. devkit/skills/embedded/brand/scripts/tests/test_sync_brand_to_tokens.py +368 -0
  46. devkit/skills/embedded/brand/scripts/validate-asset.cjs +387 -0
  47. devkit/skills/embedded/brand/templates/brand-guidelines-starter.md +275 -0
  48. devkit/skills/embedded/break-ui/CATALOG.md +135 -0
  49. devkit/skills/embedded/break-ui/SKILL.md +175 -0
  50. devkit/skills/embedded/chrome-devtools/SKILL.md +74 -0
  51. devkit/skills/embedded/deploy-to-vercel/Archive.zip +0 -0
  52. devkit/skills/embedded/deploy-to-vercel/SKILL.md +296 -0
  53. devkit/skills/embedded/deploy-to-vercel/resources/deploy-codex.sh +301 -0
  54. devkit/skills/embedded/deploy-to-vercel/resources/deploy.sh +301 -0
  55. devkit/skills/embedded/design/SKILL.md +333 -0
  56. devkit/skills/embedded/design/data/cip/deliverables.csv +51 -0
  57. devkit/skills/embedded/design/data/cip/industries.csv +21 -0
  58. devkit/skills/embedded/design/data/cip/mockup-contexts.csv +21 -0
  59. devkit/skills/embedded/design/data/cip/styles.csv +21 -0
  60. devkit/skills/embedded/design/data/icon/styles.csv +16 -0
  61. devkit/skills/embedded/design/data/logo/colors.csv +56 -0
  62. devkit/skills/embedded/design/data/logo/industries.csv +56 -0
  63. devkit/skills/embedded/design/data/logo/styles.csv +56 -0
  64. devkit/skills/embedded/design/references/banner-sizes-and-styles.md +118 -0
  65. devkit/skills/embedded/design/references/cip-deliverable-guide.md +95 -0
  66. devkit/skills/embedded/design/references/cip-design.md +123 -0
  67. devkit/skills/embedded/design/references/cip-prompt-engineering.md +84 -0
  68. devkit/skills/embedded/design/references/cip-style-guide.md +68 -0
  69. devkit/skills/embedded/design/references/design-routing.md +207 -0
  70. devkit/skills/embedded/design/references/icon-design.md +122 -0
  71. devkit/skills/embedded/design/references/logo-color-psychology.md +101 -0
  72. devkit/skills/embedded/design/references/logo-design.md +110 -0
  73. devkit/skills/embedded/design/references/logo-prompt-engineering.md +158 -0
  74. devkit/skills/embedded/design/references/logo-style-guide.md +109 -0
  75. devkit/skills/embedded/design/references/slides-copywriting-formulas.md +84 -0
  76. devkit/skills/embedded/design/references/slides-create.md +4 -0
  77. devkit/skills/embedded/design/references/slides-html-template.md +295 -0
  78. devkit/skills/embedded/design/references/slides-layout-patterns.md +137 -0
  79. devkit/skills/embedded/design/references/slides-strategies.md +94 -0
  80. devkit/skills/embedded/design/references/slides.md +42 -0
  81. devkit/skills/embedded/design/references/social-photos-design.md +329 -0
  82. devkit/skills/embedded/design/scripts/cip/core.py +215 -0
  83. devkit/skills/embedded/design/scripts/cip/generate.py +504 -0
  84. devkit/skills/embedded/design/scripts/cip/render-html.py +424 -0
  85. devkit/skills/embedded/design/scripts/cip/search.py +127 -0
  86. devkit/skills/embedded/design/scripts/icon/generate.py +535 -0
  87. devkit/skills/embedded/design/scripts/logo/core.py +175 -0
  88. devkit/skills/embedded/design/scripts/logo/generate.py +812 -0
  89. devkit/skills/embedded/design/scripts/logo/search.py +114 -0
  90. devkit/skills/embedded/design/scripts/logo/tests/test_generate.py +454 -0
  91. devkit/skills/embedded/design/scripts/tests/test_cip_generate.py +134 -0
  92. devkit/skills/embedded/design/scripts/tests/test_icon_generate.py +178 -0
  93. devkit/skills/embedded/design-system/SKILL.md +248 -0
  94. devkit/skills/embedded/design-system/data/slide-backgrounds.csv +11 -0
  95. devkit/skills/embedded/design-system/data/slide-charts.csv +26 -0
  96. devkit/skills/embedded/design-system/data/slide-color-logic.csv +14 -0
  97. devkit/skills/embedded/design-system/data/slide-copy.csv +26 -0
  98. devkit/skills/embedded/design-system/data/slide-layout-logic.csv +16 -0
  99. devkit/skills/embedded/design-system/data/slide-layouts.csv +26 -0
  100. devkit/skills/embedded/design-system/data/slide-strategies.csv +16 -0
  101. devkit/skills/embedded/design-system/data/slide-typography.csv +15 -0
  102. devkit/skills/embedded/design-system/references/component-specs.md +236 -0
  103. devkit/skills/embedded/design-system/references/component-tokens.md +214 -0
  104. devkit/skills/embedded/design-system/references/primitive-tokens.md +203 -0
  105. devkit/skills/embedded/design-system/references/semantic-tokens.md +215 -0
  106. devkit/skills/embedded/design-system/references/states-and-variants.md +241 -0
  107. devkit/skills/embedded/design-system/references/tailwind-integration.md +251 -0
  108. devkit/skills/embedded/design-system/references/token-architecture.md +224 -0
  109. devkit/skills/embedded/design-system/scripts/embed-tokens.cjs +103 -0
  110. devkit/skills/embedded/design-system/scripts/fetch-background.py +339 -0
  111. devkit/skills/embedded/design-system/scripts/generate-slide.py +770 -0
  112. devkit/skills/embedded/design-system/scripts/generate-tokens.cjs +205 -0
  113. devkit/skills/embedded/design-system/scripts/html-token-validator.py +359 -0
  114. devkit/skills/embedded/design-system/scripts/search-slides.py +228 -0
  115. devkit/skills/embedded/design-system/scripts/slide-token-validator.py +35 -0
  116. devkit/skills/embedded/design-system/scripts/slide_search_core.py +453 -0
  117. devkit/skills/embedded/design-system/scripts/tests/test_validate_tokens.py +52 -0
  118. devkit/skills/embedded/design-system/scripts/validate-tokens.cjs +246 -0
  119. devkit/skills/embedded/design-system/templates/design-tokens-starter.json +143 -0
  120. devkit/skills/embedded/design-taste-frontend/README.md +81 -0
  121. devkit/skills/embedded/design-taste-frontend/SKILL.md +542 -0
  122. devkit/skills/embedded/design-taste-frontend/assets/app.css +216 -0
  123. devkit/skills/embedded/design-taste-frontend/assets/base.css +105 -0
  124. devkit/skills/embedded/design-taste-frontend/assets/base.js +37 -0
  125. devkit/skills/embedded/design-taste-frontend/assets/charts.js +619 -0
  126. devkit/skills/embedded/design-taste-frontend/assets/scenes/stage.css +28 -0
  127. devkit/skills/embedded/design-taste-frontend/assets/scenes/stage.js +134 -0
  128. devkit/skills/embedded/design-taste-frontend/evals/evals.json +76 -0
  129. devkit/skills/embedded/design-taste-frontend/library/app.json +1327 -0
  130. devkit/skills/embedded/design-taste-frontend/library/directions.json +1078 -0
  131. devkit/skills/embedded/design-taste-frontend/library/heroes.json +1086 -0
  132. devkit/skills/embedded/design-taste-frontend/library/motions.json +92 -0
  133. devkit/skills/embedded/design-taste-frontend/library/palettes.json +1485 -0
  134. devkit/skills/embedded/design-taste-frontend/library/photos.json +7240 -0
  135. devkit/skills/embedded/design-taste-frontend/library/sections.json +4429 -0
  136. devkit/skills/embedded/design-taste-frontend/library/sites.json +8350 -0
  137. devkit/skills/embedded/design-taste-frontend/library/type.json +2024 -0
  138. devkit/skills/embedded/design-taste-frontend/references/app-screens.md +1199 -0
  139. devkit/skills/embedded/design-taste-frontend/references/colour.md +141 -0
  140. devkit/skills/embedded/design-taste-frontend/references/copy.md +177 -0
  141. devkit/skills/embedded/design-taste-frontend/references/critique.md +182 -0
  142. devkit/skills/embedded/design-taste-frontend/references/imagery.md +791 -0
  143. devkit/skills/embedded/design-taste-frontend/references/layout.md +292 -0
  144. devkit/skills/embedded/design-taste-frontend/references/motion.md +980 -0
  145. devkit/skills/embedded/design-taste-frontend/references/research.md +356 -0
  146. devkit/skills/embedded/design-taste-frontend/references/scenes.md +174 -0
  147. devkit/skills/embedded/design-taste-frontend/references/tells.md +115 -0
  148. devkit/skills/embedded/design-taste-frontend/references/type.md +170 -0
  149. devkit/skills/embedded/design-taste-frontend/scripts/assets.mjs +865 -0
  150. devkit/skills/embedded/design-taste-frontend/scripts/draw.mjs +584 -0
  151. devkit/skills/embedded/design-taste-frontend/scripts/inspect.mjs +308 -0
  152. devkit/skills/embedded/design-taste-frontend/scripts/lib/app-draw.mjs +203 -0
  153. devkit/skills/embedded/design-taste-frontend/scripts/lib/cdp.mjs +248 -0
  154. devkit/skills/embedded/design-taste-frontend/scripts/lib/inspection-files.mjs +9 -0
  155. devkit/skills/embedded/design-taste-frontend/scripts/lib/probe.mjs +929 -0
  156. devkit/skills/embedded/design-taste-frontend/scripts/lib/rules.mjs +243 -0
  157. devkit/skills/embedded/design-taste-frontend/scripts/lint.mjs +119 -0
  158. devkit/skills/embedded/design-taste-frontend/scripts/scenes.mjs +124 -0
  159. devkit/skills/embedded/emil-design-eng/SKILL.md +674 -0
  160. devkit/skills/embedded/find-animation-opportunities/SKILL.md +140 -0
  161. devkit/skills/embedded/gemini-api-dev/SKILL.md +458 -0
  162. devkit/skills/embedded/gemini-api-dev/references/migration.md +180 -0
  163. devkit/skills/embedded/impeccable/SKILL.md +86 -0
  164. devkit/skills/embedded/impeccable/agents/impeccable_asset_producer.toml +47 -0
  165. devkit/skills/embedded/impeccable/agents/impeccable_documenter.toml +27 -0
  166. devkit/skills/embedded/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
  167. devkit/skills/embedded/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
  168. devkit/skills/embedded/impeccable/agents/openai.yaml +4 -0
  169. devkit/skills/embedded/impeccable/reference/adapt.md +318 -0
  170. devkit/skills/embedded/impeccable/reference/adapt.native.md +58 -0
  171. devkit/skills/embedded/impeccable/reference/android.md +46 -0
  172. devkit/skills/embedded/impeccable/reference/animate.md +89 -0
  173. devkit/skills/embedded/impeccable/reference/audit.md +139 -0
  174. devkit/skills/embedded/impeccable/reference/audit.native.md +139 -0
  175. devkit/skills/embedded/impeccable/reference/bolder.md +33 -0
  176. devkit/skills/embedded/impeccable/reference/clarify.md +94 -0
  177. devkit/skills/embedded/impeccable/reference/colorize.md +86 -0
  178. devkit/skills/embedded/impeccable/reference/component-review.md +63 -0
  179. devkit/skills/embedded/impeccable/reference/craft-floor.md +50 -0
  180. devkit/skills/embedded/impeccable/reference/craft.md +5 -0
  181. devkit/skills/embedded/impeccable/reference/critique.md +841 -0
  182. devkit/skills/embedded/impeccable/reference/degraded/asset-producer.md +44 -0
  183. devkit/skills/embedded/impeccable/reference/degraded/documenter.md +24 -0
  184. devkit/skills/embedded/impeccable/reference/degraded/finish-reviewer.md +38 -0
  185. devkit/skills/embedded/impeccable/reference/degraded/manual-edit-applier.md +92 -0
  186. devkit/skills/embedded/impeccable/reference/delight.md +70 -0
  187. devkit/skills/embedded/impeccable/reference/distill.md +111 -0
  188. devkit/skills/embedded/impeccable/reference/doctor.md +54 -0
  189. devkit/skills/embedded/impeccable/reference/document.md +416 -0
  190. devkit/skills/embedded/impeccable/reference/extract.md +69 -0
  191. devkit/skills/embedded/impeccable/reference/generate.md +101 -0
  192. devkit/skills/embedded/impeccable/reference/harden.md +362 -0
  193. devkit/skills/embedded/impeccable/reference/hooks.md +113 -0
  194. devkit/skills/embedded/impeccable/reference/init.md +131 -0
  195. devkit/skills/embedded/impeccable/reference/ios.md +51 -0
  196. devkit/skills/embedded/impeccable/reference/layout.md +84 -0
  197. devkit/skills/embedded/impeccable/reference/live-setup.md +104 -0
  198. devkit/skills/embedded/impeccable/reference/live.md +327 -0
  199. devkit/skills/embedded/impeccable/reference/mode-operate.md +21 -0
  200. devkit/skills/embedded/impeccable/reference/mode-persuade.md +19 -0
  201. devkit/skills/embedded/impeccable/reference/mode-read.md +21 -0
  202. devkit/skills/embedded/impeccable/reference/new-work.md +152 -0
  203. devkit/skills/embedded/impeccable/reference/onboard.md +234 -0
  204. devkit/skills/embedded/impeccable/reference/operate.md +61 -0
  205. devkit/skills/embedded/impeccable/reference/optimize.md +257 -0
  206. devkit/skills/embedded/impeccable/reference/overdrive.md +127 -0
  207. devkit/skills/embedded/impeccable/reference/polish.md +105 -0
  208. devkit/skills/embedded/impeccable/reference/quieter.md +99 -0
  209. devkit/skills/embedded/impeccable/reference/region-map.md +26 -0
  210. devkit/skills/embedded/impeccable/reference/routing.md +24 -0
  211. devkit/skills/embedded/impeccable/reference/shape.md +59 -0
  212. devkit/skills/embedded/impeccable/reference/typeset.md +90 -0
  213. devkit/skills/embedded/impeccable/reference/visualize.md +47 -0
  214. devkit/skills/embedded/impeccable/scripts/VERSION +1 -0
  215. devkit/skills/embedded/impeccable/scripts/command-metadata.json +98 -0
  216. devkit/skills/embedded/impeccable/scripts/data/font-index-failures.json +121 -0
  217. devkit/skills/embedded/impeccable/scripts/data/font-index.json +1 -0
  218. devkit/skills/embedded/impeccable/scripts/impeccable +213 -0
  219. devkit/skills/embedded/impeccable/scripts/impeccable.cmd +239 -0
  220. devkit/skills/embedded/impeccable/scripts/live-browser-dom.js +320 -0
  221. devkit/skills/embedded/impeccable/scripts/live-browser-ignores.js +246 -0
  222. devkit/skills/embedded/impeccable/scripts/live-browser-session.js +183 -0
  223. devkit/skills/embedded/impeccable/scripts/live-browser.js +13645 -0
  224. devkit/skills/embedded/impeccable/scripts/modern-screenshot.umd.js +14 -0
  225. devkit/skills/embedded/improve-animations/AUDIT.md +115 -0
  226. devkit/skills/embedded/improve-animations/PLAN-TEMPLATE.md +73 -0
  227. devkit/skills/embedded/improve-animations/SKILL.md +109 -0
  228. devkit/skills/embedded/mobile-native/SKILL.md +311 -0
  229. devkit/skills/embedded/modern-web-guidance/SKILL.md +135 -0
  230. devkit/skills/embedded/pick-ui-library/SKILL.md +85 -0
  231. devkit/skills/embedded/ponytail/SKILL.md +52 -0
  232. devkit/skills/embedded/ponytail-audit/SKILL.md +103 -0
  233. devkit/skills/embedded/ponytail-debt/SKILL.md +44 -0
  234. devkit/skills/embedded/ponytail-gain/SKILL.md +52 -0
  235. devkit/skills/embedded/ponytail-help/SKILL.md +76 -0
  236. devkit/skills/embedded/ponytail-review/SKILL.md +101 -0
  237. devkit/skills/embedded/prototype/PICKER.md +197 -0
  238. devkit/skills/embedded/prototype/SKILL.md +98 -0
  239. devkit/skills/embedded/review-animations/SKILL.md +120 -0
  240. devkit/skills/embedded/review-animations/STANDARDS.md +187 -0
  241. devkit/skills/embedded/skills-lock.json +239 -0
  242. devkit/skills/embedded/slides/SKILL.md +44 -0
  243. devkit/skills/embedded/slides/references/copywriting-formulas.md +84 -0
  244. devkit/skills/embedded/slides/references/create.md +4 -0
  245. devkit/skills/embedded/slides/references/html-template.md +295 -0
  246. devkit/skills/embedded/slides/references/layout-patterns.md +137 -0
  247. devkit/skills/embedded/slides/references/slide-strategies.md +94 -0
  248. devkit/skills/embedded/ui-styling/LICENSE.txt +202 -0
  249. devkit/skills/embedded/ui-styling/SKILL.md +336 -0
  250. devkit/skills/embedded/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -0
  251. devkit/skills/embedded/ui-styling/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
  252. devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-Bold.ttf +0 -0
  253. devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -0
  254. devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-Regular.ttf +0 -0
  255. devkit/skills/embedded/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -0
  256. devkit/skills/embedded/ui-styling/canvas-fonts/Boldonse-Regular.ttf +0 -0
  257. devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
  258. devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
  259. devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
  260. devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
  261. devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
  262. devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -0
  263. devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
  264. devkit/skills/embedded/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -0
  265. devkit/skills/embedded/ui-styling/canvas-fonts/DMMono-Regular.ttf +0 -0
  266. devkit/skills/embedded/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -0
  267. devkit/skills/embedded/ui-styling/canvas-fonts/EricaOne-Regular.ttf +0 -0
  268. devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-Bold.ttf +0 -0
  269. devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -0
  270. devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-Regular.ttf +0 -0
  271. devkit/skills/embedded/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -0
  272. devkit/skills/embedded/ui-styling/canvas-fonts/Gloock-Regular.ttf +0 -0
  273. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
  274. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
  275. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
  276. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
  277. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
  278. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
  279. devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
  280. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
  281. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
  282. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
  283. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -0
  284. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
  285. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
  286. devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
  287. devkit/skills/embedded/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -0
  288. devkit/skills/embedded/ui-styling/canvas-fonts/Italiana-Regular.ttf +0 -0
  289. devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
  290. devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
  291. devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
  292. devkit/skills/embedded/ui-styling/canvas-fonts/Jura-Light.ttf +0 -0
  293. devkit/skills/embedded/ui-styling/canvas-fonts/Jura-Medium.ttf +0 -0
  294. devkit/skills/embedded/ui-styling/canvas-fonts/Jura-OFL.txt +93 -0
  295. devkit/skills/embedded/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
  296. devkit/skills/embedded/ui-styling/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
  297. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Bold.ttf +0 -0
  298. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-BoldItalic.ttf +0 -0
  299. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Italic.ttf +0 -0
  300. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-OFL.txt +93 -0
  301. devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Regular.ttf +0 -0
  302. devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-Bold.ttf +0 -0
  303. devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -0
  304. devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-Regular.ttf +0 -0
  305. devkit/skills/embedded/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
  306. devkit/skills/embedded/ui-styling/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
  307. devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-Bold.ttf +0 -0
  308. devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -0
  309. devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-Regular.ttf +0 -0
  310. devkit/skills/embedded/ui-styling/canvas-fonts/PixelifySans-Medium.ttf +0 -0
  311. devkit/skills/embedded/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -0
  312. devkit/skills/embedded/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -0
  313. devkit/skills/embedded/ui-styling/canvas-fonts/PoiretOne-Regular.ttf +0 -0
  314. devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-Bold.ttf +0 -0
  315. devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -0
  316. devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-Regular.ttf +0 -0
  317. devkit/skills/embedded/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -0
  318. devkit/skills/embedded/ui-styling/canvas-fonts/Silkscreen-Regular.ttf +0 -0
  319. devkit/skills/embedded/ui-styling/canvas-fonts/SmoochSans-Medium.ttf +0 -0
  320. devkit/skills/embedded/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -0
  321. devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-Medium.ttf +0 -0
  322. devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -0
  323. devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-Regular.ttf +0 -0
  324. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Bold.ttf +0 -0
  325. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
  326. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Italic.ttf +0 -0
  327. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -0
  328. devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Regular.ttf +0 -0
  329. devkit/skills/embedded/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -0
  330. devkit/skills/embedded/ui-styling/canvas-fonts/YoungSerif-Regular.ttf +0 -0
  331. devkit/skills/embedded/ui-styling/references/canvas-design-system.md +320 -0
  332. devkit/skills/embedded/ui-styling/references/shadcn-accessibility.md +471 -0
  333. devkit/skills/embedded/ui-styling/references/shadcn-components.md +424 -0
  334. devkit/skills/embedded/ui-styling/references/shadcn-theming.md +373 -0
  335. devkit/skills/embedded/ui-styling/references/tailwind-customization.md +483 -0
  336. devkit/skills/embedded/ui-styling/references/tailwind-responsive.md +382 -0
  337. devkit/skills/embedded/ui-styling/references/tailwind-utilities.md +455 -0
  338. devkit/skills/embedded/ui-styling/scripts/.coverage +0 -0
  339. devkit/skills/embedded/ui-styling/scripts/requirements.txt +17 -0
  340. devkit/skills/embedded/ui-styling/scripts/shadcn_add.py +308 -0
  341. devkit/skills/embedded/ui-styling/scripts/tailwind_config_gen.py +508 -0
  342. devkit/skills/embedded/ui-styling/scripts/tests/coverage-ui.json +1 -0
  343. devkit/skills/embedded/ui-styling/scripts/tests/requirements.txt +3 -0
  344. devkit/skills/embedded/ui-styling/scripts/tests/test_shadcn_add.py +266 -0
  345. devkit/skills/embedded/ui-styling/scripts/tests/test_tailwind_config_gen.py +508 -0
  346. devkit/skills/embedded/ui-ux-pro-max/SKILL.md +214 -0
  347. devkit/skills/embedded/ui-ux-pro-max/data/app-interface.csv +33 -0
  348. devkit/skills/embedded/ui-ux-pro-max/data/catalog-summary.json +78 -0
  349. devkit/skills/embedded/ui-ux-pro-max/data/charts.csv +26 -0
  350. devkit/skills/embedded/ui-ux-pro-max/data/colors.csv +193 -0
  351. devkit/skills/embedded/ui-ux-pro-max/data/data-provenance.json +1348 -0
  352. devkit/skills/embedded/ui-ux-pro-max/data/google-font-licenses.json +20185 -0
  353. devkit/skills/embedded/ui-ux-pro-max/data/google-fonts.csv +1935 -0
  354. devkit/skills/embedded/ui-ux-pro-max/data/icons.csv +106 -0
  355. devkit/skills/embedded/ui-ux-pro-max/data/landing.csv +35 -0
  356. devkit/skills/embedded/ui-ux-pro-max/data/motion.csv +18 -0
  357. devkit/skills/embedded/ui-ux-pro-max/data/phosphor-icons-upstream.json +32582 -0
  358. devkit/skills/embedded/ui-ux-pro-max/data/products.csv +193 -0
  359. devkit/skills/embedded/ui-ux-pro-max/data/react-performance.csv +45 -0
  360. devkit/skills/embedded/ui-ux-pro-max/data/stacks/angular.csv +51 -0
  361. devkit/skills/embedded/ui-ux-pro-max/data/stacks/astro.csv +54 -0
  362. devkit/skills/embedded/ui-ux-pro-max/data/stacks/avalonia.csv +57 -0
  363. devkit/skills/embedded/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  364. devkit/skills/embedded/ui-ux-pro-max/data/stacks/html-tailwind.csv +60 -0
  365. devkit/skills/embedded/ui-ux-pro-max/data/stacks/javafx.csv +76 -0
  366. devkit/skills/embedded/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  367. devkit/skills/embedded/ui-ux-pro-max/data/stacks/laravel.csv +51 -0
  368. devkit/skills/embedded/ui-ux-pro-max/data/stacks/nextjs.csv +62 -0
  369. devkit/skills/embedded/ui-ux-pro-max/data/stacks/nuxt-ui.csv +77 -0
  370. devkit/skills/embedded/ui-ux-pro-max/data/stacks/nuxtjs.csv +68 -0
  371. devkit/skills/embedded/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  372. devkit/skills/embedded/ui-ux-pro-max/data/stacks/react.csv +67 -0
  373. devkit/skills/embedded/ui-ux-pro-max/data/stacks/shadcn.csv +69 -0
  374. devkit/skills/embedded/ui-ux-pro-max/data/stacks/svelte.csv +56 -0
  375. devkit/skills/embedded/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  376. devkit/skills/embedded/ui-ux-pro-max/data/stacks/threejs.csv +54 -0
  377. devkit/skills/embedded/ui-ux-pro-max/data/stacks/uno.csv +60 -0
  378. devkit/skills/embedded/ui-ux-pro-max/data/stacks/uwp.csv +56 -0
  379. devkit/skills/embedded/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  380. devkit/skills/embedded/ui-ux-pro-max/data/stacks/winui.csv +60 -0
  381. devkit/skills/embedded/ui-ux-pro-max/data/stacks/wpf.csv +57 -0
  382. devkit/skills/embedded/ui-ux-pro-max/data/styles.csv +89 -0
  383. devkit/skills/embedded/ui-ux-pro-max/data/typography.csv +75 -0
  384. devkit/skills/embedded/ui-ux-pro-max/data/ui-reasoning.csv +193 -0
  385. devkit/skills/embedded/ui-ux-pro-max/data/ux-guidelines.csv +120 -0
  386. devkit/skills/embedded/ui-ux-pro-max/references/pro-rules.md +117 -0
  387. devkit/skills/embedded/ui-ux-pro-max/references/quick-reference.md +256 -0
  388. devkit/skills/embedded/ui-ux-pro-max/scripts/core.py +993 -0
  389. devkit/skills/embedded/ui-ux-pro-max/scripts/design_system.py +1668 -0
  390. devkit/skills/embedded/ui-ux-pro-max/scripts/reasoning_contract.py +123 -0
  391. devkit/skills/embedded/ui-ux-pro-max/scripts/search.py +177 -0
  392. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json +36 -0
  393. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-catalog.json +33 -0
  394. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv +3 -0
  395. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json +17 -0
  396. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json +7 -0
  397. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv +4 -0
  398. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json +23 -0
  399. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json +13 -0
  400. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json +4 -0
  401. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json +5 -0
  402. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-baseline.json +3366 -0
  403. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-cases.json +111 -0
  404. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-thresholds.json +100 -0
  405. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_catalog_refresh.py +354 -0
  406. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_catalog_summary_line_endings.py +78 -0
  407. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_core.py +343 -0
  408. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_core_data_quality.py +198 -0
  409. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_data_contracts.py +421 -0
  410. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_design_system_mode.py +233 -0
  411. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_design_system_stack.py +61 -0
  412. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_native_desktop_stack_freshness.py +179 -0
  413. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_relevance_evaluator.py +182 -0
  414. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_skill_script_paths.py +82 -0
  415. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_style_taxonomy.py +175 -0
  416. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_text_layout_resilience.py +120 -0
  417. devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_web_stack_freshness.py +177 -0
  418. devkit/skills/embedded/ui-ux-pro-max/scripts/validate_data.py +1095 -0
  419. devkit/skills/embedded/vercel-cli-with-tokens/SKILL.md +353 -0
  420. devkit/skills/embedded/vercel-composition-patterns/AGENTS.md +946 -0
  421. devkit/skills/embedded/vercel-composition-patterns/README.md +60 -0
  422. devkit/skills/embedded/vercel-composition-patterns/SKILL.md +89 -0
  423. devkit/skills/embedded/vercel-composition-patterns/rules/_sections.md +29 -0
  424. devkit/skills/embedded/vercel-composition-patterns/rules/_template.md +24 -0
  425. devkit/skills/embedded/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  426. devkit/skills/embedded/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  427. devkit/skills/embedded/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  428. devkit/skills/embedded/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  429. devkit/skills/embedded/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
  430. devkit/skills/embedded/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  431. devkit/skills/embedded/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  432. devkit/skills/embedded/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  433. devkit/skills/embedded/vercel-optimize/AGENTS.md +48 -0
  434. devkit/skills/embedded/vercel-optimize/CONTRIBUTING.md +41 -0
  435. devkit/skills/embedded/vercel-optimize/README.md +91 -0
  436. devkit/skills/embedded/vercel-optimize/SKILL.md +322 -0
  437. devkit/skills/embedded/vercel-optimize/lib/auth-route.mjs +23 -0
  438. devkit/skills/embedded/vercel-optimize/lib/budget-summary.mjs +182 -0
  439. devkit/skills/embedded/vercel-optimize/lib/citations.mjs +139 -0
  440. devkit/skills/embedded/vercel-optimize/lib/cost-coverage.mjs +143 -0
  441. devkit/skills/embedded/vercel-optimize/lib/dedup-recs.mjs +325 -0
  442. devkit/skills/embedded/vercel-optimize/lib/deep-dive.mjs +350 -0
  443. devkit/skills/embedded/vercel-optimize/lib/display-labels.mjs +185 -0
  444. devkit/skills/embedded/vercel-optimize/lib/extract-claims.mjs +550 -0
  445. devkit/skills/embedded/vercel-optimize/lib/framework-support.mjs +67 -0
  446. devkit/skills/embedded/vercel-optimize/lib/gates/build-minutes-fanout.mjs +69 -0
  447. devkit/skills/embedded/vercel-optimize/lib/gates/cold-start.mjs +66 -0
  448. devkit/skills/embedded/vercel-optimize/lib/gates/contract.mjs +79 -0
  449. devkit/skills/embedded/vercel-optimize/lib/gates/cwv-poor.mjs +87 -0
  450. devkit/skills/embedded/vercel-optimize/lib/gates/external-api-slow.mjs +55 -0
  451. devkit/skills/embedded/vercel-optimize/lib/gates/hard-gates.mjs +73 -0
  452. devkit/skills/embedded/vercel-optimize/lib/gates/index.mjs +45 -0
  453. devkit/skills/embedded/vercel-optimize/lib/gates/isr-overrevalidation.mjs +62 -0
  454. devkit/skills/embedded/vercel-optimize/lib/gates/middleware-heavy.mjs +51 -0
  455. devkit/skills/embedded/vercel-optimize/lib/gates/observability-events-attribution.mjs +56 -0
  456. devkit/skills/embedded/vercel-optimize/lib/gates/platform-bot-protection.mjs +115 -0
  457. devkit/skills/embedded/vercel-optimize/lib/gates/platform-fluid-compute.mjs +83 -0
  458. devkit/skills/embedded/vercel-optimize/lib/gates/region-misconfig.mjs +64 -0
  459. devkit/skills/embedded/vercel-optimize/lib/gates/route-errors.mjs +80 -0
  460. devkit/skills/embedded/vercel-optimize/lib/gates/scanner-driven.mjs +122 -0
  461. devkit/skills/embedded/vercel-optimize/lib/gates/select-candidates.mjs +134 -0
  462. devkit/skills/embedded/vercel-optimize/lib/gates/slow-route.mjs +88 -0
  463. devkit/skills/embedded/vercel-optimize/lib/gates/types.d.ts +38 -0
  464. devkit/skills/embedded/vercel-optimize/lib/gates/uncached-route.mjs +93 -0
  465. devkit/skills/embedded/vercel-optimize/lib/gates/usage-spike-triage.mjs +121 -0
  466. devkit/skills/embedded/vercel-optimize/lib/grade-recommendation.mjs +155 -0
  467. devkit/skills/embedded/vercel-optimize/lib/impact-label.mjs +126 -0
  468. devkit/skills/embedded/vercel-optimize/lib/impact-magnitude.mjs +60 -0
  469. devkit/skills/embedded/vercel-optimize/lib/investigation-brief.mjs +610 -0
  470. devkit/skills/embedded/vercel-optimize/lib/observation-safety.mjs +174 -0
  471. devkit/skills/embedded/vercel-optimize/lib/project-facts.mjs +99 -0
  472. devkit/skills/embedded/vercel-optimize/lib/queries.mjs +315 -0
  473. devkit/skills/embedded/vercel-optimize/lib/reconcile-candidates.mjs +372 -0
  474. devkit/skills/embedded/vercel-optimize/lib/render-report.mjs +955 -0
  475. devkit/skills/embedded/vercel-optimize/lib/repo-root.mjs +86 -0
  476. devkit/skills/embedded/vercel-optimize/lib/route-normalize.mjs +220 -0
  477. devkit/skills/embedded/vercel-optimize/lib/sanitizers/bot-protection-certainty.mjs +38 -0
  478. devkit/skills/embedded/vercel-optimize/lib/sanitizers/cache-tag-invalidation-certainty.mjs +30 -0
  479. devkit/skills/embedded/vercel-optimize/lib/sanitizers/count-correct.mjs +52 -0
  480. devkit/skills/embedded/vercel-optimize/lib/sanitizers/function-duration-invocations.mjs +38 -0
  481. devkit/skills/embedded/vercel-optimize/lib/sanitizers/index.mjs +79 -0
  482. devkit/skills/embedded/vercel-optimize/lib/sanitizers/middleware-conflict.mjs +36 -0
  483. devkit/skills/embedded/vercel-optimize/lib/sanitizers/missing-citation.mjs +16 -0
  484. devkit/skills/embedded/vercel-optimize/lib/sanitizers/pre-release.mjs +74 -0
  485. devkit/skills/embedded/vercel-optimize/lib/sanitizers/rate-limit.mjs +67 -0
  486. devkit/skills/embedded/vercel-optimize/lib/sanitizers/rendering-mode-mislabel.mjs +38 -0
  487. devkit/skills/embedded/vercel-optimize/lib/sanitizers/undeclared-dep.mjs +78 -0
  488. devkit/skills/embedded/vercel-optimize/lib/sanitizers/vercel-directive-strip.mjs +37 -0
  489. devkit/skills/embedded/vercel-optimize/lib/sanitizers/window-units.mjs +32 -0
  490. devkit/skills/embedded/vercel-optimize/lib/scanners/cache-components-suspense-dedupe.mjs +109 -0
  491. devkit/skills/embedded/vercel-optimize/lib/scanners/edge-heavy-import.mjs +94 -0
  492. devkit/skills/embedded/vercel-optimize/lib/scanners/force-dynamic.mjs +42 -0
  493. devkit/skills/embedded/vercel-optimize/lib/scanners/headers-in-page.mjs +44 -0
  494. devkit/skills/embedded/vercel-optimize/lib/scanners/index.mjs +35 -0
  495. devkit/skills/embedded/vercel-optimize/lib/scanners/large-static-asset.mjs +92 -0
  496. devkit/skills/embedded/vercel-optimize/lib/scanners/max-age-without-s-maxage.mjs +42 -0
  497. devkit/skills/embedded/vercel-optimize/lib/scanners/middleware-broad-matcher.mjs +55 -0
  498. devkit/skills/embedded/vercel-optimize/lib/scanners/missing-cache-headers.mjs +90 -0
  499. devkit/skills/embedded/vercel-optimize/lib/scanners/prisma-include-tree.mjs +42 -0
  500. devkit/skills/embedded/vercel-optimize/lib/scanners/region-pin-in-config.mjs +88 -0
  501. devkit/skills/embedded/vercel-optimize/lib/scanners/source-maps-production.mjs +36 -0
  502. devkit/skills/embedded/vercel-optimize/lib/scanners/sveltekit-prerender-missing.mjs +43 -0
  503. devkit/skills/embedded/vercel-optimize/lib/scanners/turbo-force-bypass.mjs +129 -0
  504. devkit/skills/embedded/vercel-optimize/lib/scanners/unoptimized-image.mjs +113 -0
  505. devkit/skills/embedded/vercel-optimize/lib/scanners/use-cache-date-stamp.mjs +106 -0
  506. devkit/skills/embedded/vercel-optimize/lib/support-topics.mjs +355 -0
  507. devkit/skills/embedded/vercel-optimize/lib/throttle.mjs +273 -0
  508. devkit/skills/embedded/vercel-optimize/lib/util.mjs +17 -0
  509. devkit/skills/embedded/vercel-optimize/lib/vercel.mjs +864 -0
  510. devkit/skills/embedded/vercel-optimize/lib/verify-claim.mjs +1296 -0
  511. devkit/skills/embedded/vercel-optimize/lib/workspace-resolver.mjs +521 -0
  512. devkit/skills/embedded/vercel-optimize/references/candidates.md +176 -0
  513. devkit/skills/embedded/vercel-optimize/references/data-collection.md +218 -0
  514. devkit/skills/embedded/vercel-optimize/references/docs-library.json +683 -0
  515. devkit/skills/embedded/vercel-optimize/references/doctrine.md +105 -0
  516. devkit/skills/embedded/vercel-optimize/references/observability-plus.md +108 -0
  517. devkit/skills/embedded/vercel-optimize/references/playbooks/README.md +53 -0
  518. devkit/skills/embedded/vercel-optimize/references/playbooks/ai-application.md +32 -0
  519. devkit/skills/embedded/vercel-optimize/references/playbooks/api-service.md +30 -0
  520. devkit/skills/embedded/vercel-optimize/references/playbooks/content-site.md +30 -0
  521. devkit/skills/embedded/vercel-optimize/references/playbooks/ecommerce.md +30 -0
  522. devkit/skills/embedded/vercel-optimize/references/playbooks/marketing.md +30 -0
  523. devkit/skills/embedded/vercel-optimize/references/playbooks/saas.md +31 -0
  524. devkit/skills/embedded/vercel-optimize/references/playbooks/sveltekit.md +75 -0
  525. devkit/skills/embedded/vercel-optimize/references/recommendations.md +203 -0
  526. devkit/skills/embedded/vercel-optimize/references/scanner-patterns.md +251 -0
  527. devkit/skills/embedded/vercel-optimize/references/scoring.md +205 -0
  528. devkit/skills/embedded/vercel-optimize/references/support-topics/README.md +46 -0
  529. devkit/skills/embedded/vercel-optimize/references/support-topics/astro-edge-middleware-scope.md +22 -0
  530. devkit/skills/embedded/vercel-optimize/references/support-topics/astro-output-mode-and-isr.md +22 -0
  531. devkit/skills/embedded/vercel-optimize/references/support-topics/auth-preserving-parallelization.md +22 -0
  532. devkit/skills/embedded/vercel-optimize/references/support-topics/bot-protection-product-guardrails.md +22 -0
  533. devkit/skills/embedded/vercel-optimize/references/support-topics/build-minutes-monorepo-fanout.md +23 -0
  534. devkit/skills/embedded/vercel-optimize/references/support-topics/cache-components-static-shell-boundaries.md +22 -0
  535. devkit/skills/embedded/vercel-optimize/references/support-topics/cache-components-suspense-dedupe-pitfall.md +23 -0
  536. devkit/skills/embedded/vercel-optimize/references/support-topics/cdn-cache-auth-safety.md +22 -0
  537. devkit/skills/embedded/vercel-optimize/references/support-topics/cold-start-initialization-bundle.md +22 -0
  538. devkit/skills/embedded/vercel-optimize/references/support-topics/core-web-vitals-client-bottlenecks.md +22 -0
  539. devkit/skills/embedded/vercel-optimize/references/support-topics/database-egress-pooling-region.md +22 -0
  540. devkit/skills/embedded/vercel-optimize/references/support-topics/dynamic-rendering-traps.md +22 -0
  541. devkit/skills/embedded/vercel-optimize/references/support-topics/external-api-critical-path-platform.md +22 -0
  542. devkit/skills/embedded/vercel-optimize/references/support-topics/external-api-critical-path.md +22 -0
  543. devkit/skills/embedded/vercel-optimize/references/support-topics/fast-data-transfer-payloads.md +22 -0
  544. devkit/skills/embedded/vercel-optimize/references/support-topics/fluid-compute-caveats.md +22 -0
  545. devkit/skills/embedded/vercel-optimize/references/support-topics/function-duration-io-and-after.md +22 -0
  546. devkit/skills/embedded/vercel-optimize/references/support-topics/function-invocation-reduction.md +22 -0
  547. devkit/skills/embedded/vercel-optimize/references/support-topics/function-region-misconfiguration-ttfb.md +23 -0
  548. devkit/skills/embedded/vercel-optimize/references/support-topics/image-optimization-cost-control.md +22 -0
  549. devkit/skills/embedded/vercel-optimize/references/support-topics/isr-revalidation-static-generation.md +22 -0
  550. devkit/skills/embedded/vercel-optimize/references/support-topics/middleware-proxy-edge-cost.md +22 -0
  551. devkit/skills/embedded/vercel-optimize/references/support-topics/next-fetch-revalidate-floor.md +22 -0
  552. devkit/skills/embedded/vercel-optimize/references/support-topics/next-font-cls-self-hosting.md +23 -0
  553. devkit/skills/embedded/vercel-optimize/references/support-topics/next-heavy-ui-lazy-load-boundaries.md +23 -0
  554. devkit/skills/embedded/vercel-optimize/references/support-topics/next-image-lcp-preload-sizes.md +23 -0
  555. devkit/skills/embedded/vercel-optimize/references/support-topics/next-route-handler-get-cache-defaults.md +22 -0
  556. devkit/skills/embedded/vercel-optimize/references/support-topics/next-script-third-party-strategy.md +23 -0
  557. devkit/skills/embedded/vercel-optimize/references/support-topics/nextjs-version-cache-semantics.md +22 -0
  558. devkit/skills/embedded/vercel-optimize/references/support-topics/not-found-catchall-request-waste.md +23 -0
  559. devkit/skills/embedded/vercel-optimize/references/support-topics/nuxt-route-rules-cache-isr.md +22 -0
  560. devkit/skills/embedded/vercel-optimize/references/support-topics/observability-events-cost-attribution.md +22 -0
  561. devkit/skills/embedded/vercel-optimize/references/support-topics/post-response-work-waituntil.md +22 -0
  562. devkit/skills/embedded/vercel-optimize/references/support-topics/route-error-durable-offload.md +22 -0
  563. devkit/skills/embedded/vercel-optimize/references/support-topics/route-error-runtime-limits.md +22 -0
  564. devkit/skills/embedded/vercel-optimize/references/support-topics/runtime-cache-reusable-data.md +22 -0
  565. devkit/skills/embedded/vercel-optimize/references/support-topics/sveltekit-isr-prerender-safety.md +22 -0
  566. devkit/skills/embedded/vercel-optimize/references/support-topics/sveltekit-split-cold-start-tradeoff.md +22 -0
  567. devkit/skills/embedded/vercel-optimize/references/support-topics/usage-spike-triage.md +22 -0
  568. devkit/skills/embedded/vercel-optimize/references/support-topics/use-cache-date-stamp-isr-write-amplifier.md +23 -0
  569. devkit/skills/embedded/vercel-optimize/references/support-topics/use-cache-remote-shared-origin-data.md +22 -0
  570. devkit/skills/embedded/vercel-optimize/references/support-topics/workflow-resumable-stream-routes.md +23 -0
  571. devkit/skills/embedded/vercel-optimize/references/verification.md +102 -0
  572. devkit/skills/embedded/vercel-optimize/references/voice.md +76 -0
  573. devkit/skills/embedded/vercel-optimize/scripts/budget-summary.mjs +56 -0
  574. devkit/skills/embedded/vercel-optimize/scripts/build-docs.mjs +74 -0
  575. devkit/skills/embedded/vercel-optimize/scripts/check-citations.mjs +81 -0
  576. devkit/skills/embedded/vercel-optimize/scripts/check-docs-fresh.mjs +93 -0
  577. devkit/skills/embedded/vercel-optimize/scripts/collect-signals.mjs +576 -0
  578. devkit/skills/embedded/vercel-optimize/scripts/collect-sub-agent-outputs.mjs +296 -0
  579. devkit/skills/embedded/vercel-optimize/scripts/deep-dive.mjs +319 -0
  580. devkit/skills/embedded/vercel-optimize/scripts/gate-investigations.mjs +166 -0
  581. devkit/skills/embedded/vercel-optimize/scripts/merge-signals.mjs +192 -0
  582. devkit/skills/embedded/vercel-optimize/scripts/prepare-investigation-brief.mjs +231 -0
  583. devkit/skills/embedded/vercel-optimize/scripts/reconcile-candidates.mjs +62 -0
  584. devkit/skills/embedded/vercel-optimize/scripts/render-report.mjs +437 -0
  585. devkit/skills/embedded/vercel-optimize/scripts/scan-codebase.mjs +313 -0
  586. devkit/skills/embedded/vercel-optimize/scripts/verify-and-regen.mjs +346 -0
  587. devkit/skills/embedded/vercel-optimize/scripts/verify-finding.mjs +19 -0
  588. devkit/skills/embedded/vercel-react-best-practices/AGENTS.md +3810 -0
  589. devkit/skills/embedded/vercel-react-best-practices/README.md +123 -0
  590. devkit/skills/embedded/vercel-react-best-practices/SKILL.md +149 -0
  591. devkit/skills/embedded/vercel-react-best-practices/rules/_sections.md +46 -0
  592. devkit/skills/embedded/vercel-react-best-practices/rules/_template.md +28 -0
  593. devkit/skills/embedded/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  594. devkit/skills/embedded/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  595. devkit/skills/embedded/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  596. devkit/skills/embedded/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  597. devkit/skills/embedded/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  598. devkit/skills/embedded/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  599. devkit/skills/embedded/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  600. devkit/skills/embedded/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  601. devkit/skills/embedded/vercel-react-best-practices/rules/async-parallel.md +28 -0
  602. devkit/skills/embedded/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  603. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  604. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  605. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  606. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  607. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  608. devkit/skills/embedded/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  609. devkit/skills/embedded/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  610. devkit/skills/embedded/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  611. devkit/skills/embedded/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  612. devkit/skills/embedded/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  613. devkit/skills/embedded/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  614. devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  615. devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  616. devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  617. devkit/skills/embedded/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  618. devkit/skills/embedded/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  619. devkit/skills/embedded/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  620. devkit/skills/embedded/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  621. devkit/skills/embedded/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  622. devkit/skills/embedded/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  623. devkit/skills/embedded/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  624. devkit/skills/embedded/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  625. devkit/skills/embedded/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  626. devkit/skills/embedded/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  627. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  628. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  629. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  630. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  631. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  632. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  633. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  634. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  635. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  636. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  637. devkit/skills/embedded/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  638. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  639. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  640. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  641. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  642. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  643. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  644. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  645. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  646. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  647. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  648. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  649. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  650. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  651. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  652. devkit/skills/embedded/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  653. devkit/skills/embedded/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  654. devkit/skills/embedded/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  655. devkit/skills/embedded/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  656. devkit/skills/embedded/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  657. devkit/skills/embedded/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  658. devkit/skills/embedded/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  659. devkit/skills/embedded/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  660. devkit/skills/embedded/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  661. devkit/skills/embedded/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  662. devkit/skills/embedded/vercel-react-best-practices/rules/server-serialization.md +38 -0
  663. devkit/skills/embedded/vercel-react-native-skills/AGENTS.md +2897 -0
  664. devkit/skills/embedded/vercel-react-native-skills/README.md +165 -0
  665. devkit/skills/embedded/vercel-react-native-skills/SKILL.md +121 -0
  666. devkit/skills/embedded/vercel-react-native-skills/rules/_sections.md +86 -0
  667. devkit/skills/embedded/vercel-react-native-skills/rules/_template.md +28 -0
  668. devkit/skills/embedded/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
  669. devkit/skills/embedded/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
  670. devkit/skills/embedded/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
  671. devkit/skills/embedded/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
  672. devkit/skills/embedded/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
  673. devkit/skills/embedded/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
  674. devkit/skills/embedded/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
  675. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
  676. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
  677. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-images.md +53 -0
  678. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
  679. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
  680. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
  681. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
  682. devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
  683. devkit/skills/embedded/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
  684. devkit/skills/embedded/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
  685. devkit/skills/embedded/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
  686. devkit/skills/embedded/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
  687. devkit/skills/embedded/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
  688. devkit/skills/embedded/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
  689. devkit/skills/embedded/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
  690. devkit/skills/embedded/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
  691. devkit/skills/embedded/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
  692. devkit/skills/embedded/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
  693. devkit/skills/embedded/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
  694. devkit/skills/embedded/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
  695. devkit/skills/embedded/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
  696. devkit/skills/embedded/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
  697. devkit/skills/embedded/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
  698. devkit/skills/embedded/vercel-react-native-skills/rules/ui-menus.md +174 -0
  699. devkit/skills/embedded/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
  700. devkit/skills/embedded/vercel-react-native-skills/rules/ui-pressable.md +61 -0
  701. devkit/skills/embedded/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
  702. devkit/skills/embedded/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
  703. devkit/skills/embedded/vercel-react-native-skills/rules/ui-styling.md +87 -0
  704. devkit/skills/embedded/vercel-react-view-transitions/AGENTS.md +1380 -0
  705. devkit/skills/embedded/vercel-react-view-transitions/README.md +44 -0
  706. devkit/skills/embedded/vercel-react-view-transitions/SKILL.md +332 -0
  707. devkit/skills/embedded/vercel-react-view-transitions/references/css-recipes.md +312 -0
  708. devkit/skills/embedded/vercel-react-view-transitions/references/implementation.md +170 -0
  709. devkit/skills/embedded/vercel-react-view-transitions/references/nextjs.md +233 -0
  710. devkit/skills/embedded/vercel-react-view-transitions/references/patterns.md +274 -0
  711. devkit/skills/embedded/vercel-react-view-transitions/references/troubleshooting.md +47 -0
  712. devkit/skills/embedded/web-design-guidelines/SKILL.md +39 -0
  713. devkit/skills/embedded/write-swift/SKILL.md +396 -0
  714. devkit/skills/embedded/writing-guidelines/SKILL.md +39 -0
  715. devkit/skills/installer.py +110 -0
  716. devkit/templates/__init__.py +76 -0
  717. devkit/templates/ai_agents_python.py +160 -0
  718. devkit/templates/base.py +37 -0
  719. devkit/templates/content_site.py +117 -0
  720. devkit/templates/custom.py +129 -0
  721. devkit/templates/design_system.py +167 -0
  722. devkit/templates/expo_fullstack.py +278 -0
  723. devkit/templates/expo_mobile.py +127 -0
  724. devkit/templates/minimal_agentic.py +34 -0
  725. devkit/templates/nextjs.py +219 -0
  726. devkit/templates/python_fastapi.py +125 -0
  727. devkit/templates/saas_fullstack.py +212 -0
  728. devkit/templates/vite_react.py +176 -0
  729. devkit/ui.py +61 -0
  730. devkit/utils/__init__.py +15 -0
  731. devkit/utils/system.py +48 -0
@@ -0,0 +1,205 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Generate CSS variables from design tokens JSON
4
+ *
5
+ * Usage:
6
+ * node generate-tokens.cjs --config tokens.json -o tokens.css
7
+ * node generate-tokens.cjs --config tokens.json --format tailwind
8
+ */
9
+
10
+ const fs = require('fs');
11
+ const path = require('path');
12
+
13
+ /**
14
+ * Parse command line arguments
15
+ */
16
+ function parseArgs() {
17
+ const args = process.argv.slice(2);
18
+ const options = {
19
+ config: null,
20
+ output: null,
21
+ format: 'css' // css | tailwind
22
+ };
23
+
24
+ for (let i = 0; i < args.length; i++) {
25
+ if (args[i] === '--config' || args[i] === '-c') {
26
+ options.config = args[++i];
27
+ } else if (args[i] === '--output' || args[i] === '-o') {
28
+ options.output = args[++i];
29
+ } else if (args[i] === '--format' || args[i] === '-f') {
30
+ options.format = args[++i];
31
+ } else if (args[i] === '--help' || args[i] === '-h') {
32
+ console.log(`
33
+ Usage: node generate-tokens.cjs [options]
34
+
35
+ Options:
36
+ -c, --config <file> Input JSON token file (required)
37
+ -o, --output <file> Output file (default: stdout)
38
+ -f, --format <type> Output format: css | tailwind (default: css)
39
+ -h, --help Show this help
40
+ `);
41
+ process.exit(0);
42
+ }
43
+ }
44
+
45
+ return options;
46
+ }
47
+
48
+ /**
49
+ * Resolve token references like {primitive.color.blue.600}
50
+ */
51
+ function resolveReference(value, tokens) {
52
+ if (typeof value !== 'string' || !value.startsWith('{')) {
53
+ return value;
54
+ }
55
+
56
+ const path = value.slice(1, -1).split('.');
57
+ let result = tokens;
58
+
59
+ for (const key of path) {
60
+ result = result?.[key];
61
+ }
62
+
63
+ if (result?.$value) {
64
+ return resolveReference(result.$value, tokens);
65
+ }
66
+
67
+ return result || value;
68
+ }
69
+
70
+ /**
71
+ * Convert token name to CSS variable name
72
+ */
73
+ function toCssVarName(path) {
74
+ return '--' + path.join('-').replace(/\./g, '-');
75
+ }
76
+
77
+ /**
78
+ * Flatten tokens into CSS variables
79
+ */
80
+ function flattenTokens(obj, tokens, prefix = [], result = {}) {
81
+ for (const [key, value] of Object.entries(obj)) {
82
+ const currentPath = [...prefix, key];
83
+
84
+ if (value && typeof value === 'object') {
85
+ if (value.$value !== undefined) {
86
+ // This is a token
87
+ const cssVar = toCssVarName(currentPath);
88
+ const resolvedValue = resolveReference(value.$value, tokens);
89
+ result[cssVar] = resolvedValue;
90
+ } else {
91
+ // Recurse into nested object
92
+ flattenTokens(value, tokens, currentPath, result);
93
+ }
94
+ }
95
+ }
96
+
97
+ return result;
98
+ }
99
+
100
+ /**
101
+ * Generate CSS output
102
+ */
103
+ function generateCSS(tokens) {
104
+ const primitive = flattenTokens(tokens.primitive || {}, tokens, ['primitive']);
105
+ const semantic = flattenTokens(tokens.semantic || {}, tokens, []);
106
+ const component = flattenTokens(tokens.component || {}, tokens, []);
107
+ const darkSemantic = flattenTokens(tokens.dark?.semantic || {}, tokens, []);
108
+
109
+ let css = `/* Design Tokens - Auto-generated */
110
+ /* Do not edit directly - modify tokens.json instead */
111
+
112
+ /* === PRIMITIVES === */
113
+ :root {
114
+ ${Object.entries(primitive).map(([k, v]) => ` ${k}: ${v};`).join('\n')}
115
+ }
116
+
117
+ /* === SEMANTIC === */
118
+ :root {
119
+ ${Object.entries(semantic).map(([k, v]) => ` ${k}: ${v};`).join('\n')}
120
+ }
121
+
122
+ /* === COMPONENTS === */
123
+ :root {
124
+ ${Object.entries(component).map(([k, v]) => ` ${k}: ${v};`).join('\n')}
125
+ }
126
+ `;
127
+
128
+ if (Object.keys(darkSemantic).length > 0) {
129
+ css += `
130
+ /* === DARK MODE === */
131
+ .dark {
132
+ ${Object.entries(darkSemantic).map(([k, v]) => ` ${k}: ${v};`).join('\n')}
133
+ }
134
+ `;
135
+ }
136
+
137
+ return css;
138
+ }
139
+
140
+ /**
141
+ * Generate Tailwind config output
142
+ */
143
+ function generateTailwind(tokens) {
144
+ const semantic = flattenTokens(tokens.semantic || {}, tokens, []);
145
+
146
+ // Extract colors for Tailwind
147
+ const colors = {};
148
+ for (const [key, value] of Object.entries(semantic)) {
149
+ if (key.includes('color')) {
150
+ const name = key.replace('--color-', '').replace(/-/g, '.');
151
+ colors[name] = `var(${key})`;
152
+ }
153
+ }
154
+
155
+ return `// Tailwind color config - Auto-generated
156
+ // Add to tailwind.config.ts theme.extend.colors
157
+
158
+ module.exports = {
159
+ colors: ${JSON.stringify(colors, null, 2).replace(/"/g, "'")}
160
+ };
161
+ `;
162
+ }
163
+
164
+ /**
165
+ * Main
166
+ */
167
+ function main() {
168
+ const options = parseArgs();
169
+
170
+ if (!options.config) {
171
+ console.error('Error: --config is required');
172
+ process.exit(1);
173
+ }
174
+
175
+ // Resolve config path
176
+ const configPath = path.resolve(process.cwd(), options.config);
177
+
178
+ if (!fs.existsSync(configPath)) {
179
+ console.error(`Error: Config file not found: ${configPath}`);
180
+ process.exit(1);
181
+ }
182
+
183
+ // Read and parse tokens
184
+ const tokens = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
185
+
186
+ // Generate output
187
+ let output;
188
+ if (options.format === 'tailwind') {
189
+ output = generateTailwind(tokens);
190
+ } else {
191
+ output = generateCSS(tokens);
192
+ }
193
+
194
+ // Write output
195
+ if (options.output) {
196
+ const outputPath = path.resolve(process.cwd(), options.output);
197
+ fs.mkdirSync(path.dirname(outputPath), { recursive: true });
198
+ fs.writeFileSync(outputPath, output);
199
+ console.log(`Generated: ${outputPath}`);
200
+ } else {
201
+ console.log(output);
202
+ }
203
+ }
204
+
205
+ main();
@@ -0,0 +1,359 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ HTML Design Token Validator
4
+ Ensures all HTML assets (slides, infographics, etc.) use design tokens.
5
+ Source of truth: assets/design-tokens.css
6
+
7
+ Usage:
8
+ python html-token-validator.py # Validate all HTML assets
9
+ python html-token-validator.py --type slides # Validate only slides
10
+ python html-token-validator.py --type infographics # Validate only infographics
11
+ python html-token-validator.py path/to/file.html # Validate specific file
12
+ python html-token-validator.py --fix # Auto-fix issues (WIP)
13
+ """
14
+
15
+ import re
16
+ import json
17
+ import sys
18
+ import os
19
+ from pathlib import Path
20
+ from typing import Dict, List, Tuple, Optional
21
+
22
+ # The skill can be installed outside the project it operates on (user-level
23
+ # ~/.claude/skills/, or as a plugin), so the project root cannot be derived from
24
+ # this file's location. Resolve it from the working directory instead -- the same
25
+ # convention generate-tokens.cjs and validate-tokens.cjs already use via
26
+ # process.cwd(). DESIGN_SYSTEM_PROJECT_ROOT overrides it explicitly.
27
+ def _find_project_root():
28
+ override = os.environ.get('DESIGN_SYSTEM_PROJECT_ROOT')
29
+ if override:
30
+ return Path(override).resolve()
31
+ start = Path.cwd().resolve()
32
+ markers = (
33
+ Path('assets') / 'design-tokens.json',
34
+ Path('assets') / 'design-tokens.css',
35
+ Path('package.json'),
36
+ Path('.git'),
37
+ )
38
+ for candidate in (start, *start.parents):
39
+ if any((candidate / marker).exists() for marker in markers):
40
+ return candidate
41
+ return start
42
+
43
+
44
+ PROJECT_ROOT = _find_project_root()
45
+
46
+ # Force UTF-8 on stdout/stderr: this script prints emoji, which raises
47
+ # UnicodeEncodeError on a Windows console (cp1252). Same guard as
48
+ # src/ui-ux-pro-max/scripts/search.py.
49
+ import io
50
+
51
+ if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
52
+ sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
53
+ if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
54
+ sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
55
+ TOKENS_JSON_PATH = PROJECT_ROOT / 'assets' / 'design-tokens.json'
56
+ TOKENS_CSS_PATH = PROJECT_ROOT / 'assets' / 'design-tokens.css'
57
+
58
+ # Asset directories to validate
59
+ ASSET_DIRS = {
60
+ 'slides': PROJECT_ROOT / 'assets' / 'designs' / 'slides',
61
+ 'infographics': PROJECT_ROOT / 'assets' / 'infographics',
62
+ }
63
+
64
+ # Patterns that indicate hardcoded values (should use tokens)
65
+ FORBIDDEN_PATTERNS = [
66
+ (r'#[0-9A-Fa-f]{3,8}\b', 'hex color'),
67
+ (r'rgb\(\s*\d+\s*,\s*\d+\s*,\s*\d+\s*\)', 'rgb color'),
68
+ (r'rgba\(\s*\d+\s*,\s*\d+\s*,\s*\d+\s*,\s*[\d.]+\s*\)', 'rgba color'),
69
+ (r'hsl\([^)]+\)', 'hsl color'),
70
+ (r"font-family:\s*'[^v][^a][^r][^']*',", 'hardcoded font'), # Exclude var()
71
+ (r'font-family:\s*"[^v][^a][^r][^"]*",', 'hardcoded font'),
72
+ ]
73
+
74
+ # Allowed rgba patterns (brand colors with transparency - CSS limitation)
75
+ # These are derived from brand tokens but need rgba for transparency
76
+ ALLOWED_RGBA_PATTERNS = [
77
+ r'rgba\(\s*59\s*,\s*130\s*,\s*246', # --color-primary (#3B82F6)
78
+ r'rgba\(\s*245\s*,\s*158\s*,\s*11', # --color-secondary (#F59E0B)
79
+ r'rgba\(\s*16\s*,\s*185\s*,\s*129', # --color-accent (#10B981)
80
+ r'rgba\(\s*20\s*,\s*184\s*,\s*166', # --color-accent alt (#14B8A6)
81
+ r'rgba\(\s*0\s*,\s*0\s*,\s*0', # black transparency (common)
82
+ r'rgba\(\s*255\s*,\s*255\s*,\s*255', # white transparency (common)
83
+ r'rgba\(\s*15\s*,\s*23\s*,\s*42', # --color-surface (#0F172A)
84
+ r'rgba\(\s*7\s*,\s*11\s*,\s*20', # --color-background (#070B14)
85
+ ]
86
+
87
+ # Allowed exceptions (external images, etc.)
88
+ ALLOWED_EXCEPTIONS = [
89
+ 'pexels.com', 'unsplash.com', 'youtube.com', 'ytimg.com',
90
+ 'googlefonts', 'fonts.googleapis.com', 'fonts.gstatic.com',
91
+ ]
92
+
93
+
94
+ class ValidationResult:
95
+ """Validation result for a single file."""
96
+ def __init__(self, file_path: Path):
97
+ self.file_path = file_path
98
+ self.errors: List[str] = []
99
+ self.warnings: List[str] = []
100
+ self.passed = True
101
+
102
+ def add_error(self, msg: str):
103
+ self.errors.append(msg)
104
+ self.passed = False
105
+
106
+ def add_warning(self, msg: str):
107
+ self.warnings.append(msg)
108
+
109
+
110
+ def load_css_variables() -> Dict[str, str]:
111
+ """Load CSS variables from design-tokens.css."""
112
+ variables = {}
113
+ if TOKENS_CSS_PATH.exists():
114
+ content = TOKENS_CSS_PATH.read_text()
115
+ # Extract --var-name: value patterns
116
+ for match in re.finditer(r'(--[\w-]+):\s*([^;]+);', content):
117
+ variables[match.group(1)] = match.group(2).strip()
118
+ return variables
119
+
120
+
121
+ def is_inside_block(content: str, match_pos: int, open_tag: str, close_tag: str) -> bool:
122
+ """Check if position is inside a specific HTML block."""
123
+ pre = content[:match_pos]
124
+ tag_open = pre.rfind(open_tag)
125
+ tag_close = pre.rfind(close_tag)
126
+ return tag_open > tag_close
127
+
128
+
129
+ def is_allowed_exception(context: str) -> bool:
130
+ """Check if the hardcoded value is in an allowed exception context."""
131
+ context_lower = context.lower()
132
+ return any(exc in context_lower for exc in ALLOWED_EXCEPTIONS)
133
+
134
+
135
+ def is_allowed_rgba(match_text: str) -> bool:
136
+ """Check if rgba pattern uses brand colors (allowed for transparency)."""
137
+ return any(re.match(pattern, match_text) for pattern in ALLOWED_RGBA_PATTERNS)
138
+
139
+
140
+ def get_context(content: str, pos: int, chars: int = 100) -> str:
141
+ """Get surrounding context for a match position."""
142
+ start = max(0, pos - chars)
143
+ end = min(len(content), pos + chars)
144
+ return content[start:end]
145
+
146
+
147
+ def validate_html(content: str, file_path: Path, verbose: bool = False) -> ValidationResult:
148
+ """
149
+ Validate HTML content for design token compliance.
150
+
151
+ Checks:
152
+ 1. design-tokens.css import present
153
+ 2. No hardcoded colors in CSS (except in <script> for Chart.js)
154
+ 3. No hardcoded fonts
155
+ 4. Uses var(--token-name) pattern
156
+ """
157
+ result = ValidationResult(file_path)
158
+
159
+ # 1. Check for design-tokens.css import
160
+ if 'design-tokens.css' not in content:
161
+ result.add_error("Missing design-tokens.css import")
162
+
163
+ # 2. Check for forbidden patterns in CSS
164
+ for pattern, description in FORBIDDEN_PATTERNS:
165
+ for match in re.finditer(pattern, content):
166
+ match_text = match.group()
167
+ match_pos = match.start()
168
+ context = get_context(content, match_pos)
169
+
170
+ # Skip if in <script> block (Chart.js allowed)
171
+ if is_inside_block(content, match_pos, '<script', '</script>'):
172
+ if verbose:
173
+ result.add_warning(f"Allowed in <script>: {match_text}")
174
+ continue
175
+
176
+ # Skip if in allowed exception context (external URLs)
177
+ if is_allowed_exception(context):
178
+ if verbose:
179
+ result.add_warning(f"Allowed external: {match_text}")
180
+ continue
181
+
182
+ # Skip rgba using brand colors (needed for transparency effects)
183
+ if description == 'rgba color' and is_allowed_rgba(match_text):
184
+ if verbose:
185
+ result.add_warning(f"Allowed brand rgba: {match_text}")
186
+ continue
187
+
188
+ # Skip if part of var() reference (false positive)
189
+ if 'var(' in context and match_text in context:
190
+ # Check if it's a fallback value in var()
191
+ var_pattern = rf'var\([^)]*{re.escape(match_text)}[^)]*\)'
192
+ if re.search(var_pattern, context):
193
+ continue
194
+
195
+ # Error if in <style> or inline style
196
+ if is_inside_block(content, match_pos, '<style', '</style>'):
197
+ result.add_error(f"Hardcoded {description} in <style>: {match_text}")
198
+ elif 'style="' in context:
199
+ result.add_error(f"Hardcoded {description} in inline style: {match_text}")
200
+
201
+ # 3. Check for required var() usage indicators
202
+ token_patterns = [
203
+ r'var\(--color-',
204
+ r'var\(--primitive-',
205
+ r'var\(--typography-',
206
+ r'var\(--card-',
207
+ r'var\(--button-',
208
+ ]
209
+ token_count = sum(len(re.findall(p, content)) for p in token_patterns)
210
+
211
+ if token_count < 5:
212
+ result.add_warning(f"Low token usage ({token_count} var() references). Consider using more design tokens.")
213
+
214
+ return result
215
+
216
+
217
+ def validate_file(file_path: Path, verbose: bool = False) -> ValidationResult:
218
+ """Validate a single HTML file."""
219
+ if not file_path.exists():
220
+ result = ValidationResult(file_path)
221
+ result.add_error("File not found")
222
+ return result
223
+
224
+ content = file_path.read_text()
225
+ return validate_html(content, file_path, verbose)
226
+
227
+
228
+ def validate_directory(dir_path: Path, verbose: bool = False) -> List[ValidationResult]:
229
+ """Validate all HTML files in a directory."""
230
+ results = []
231
+ if dir_path.exists():
232
+ for html_file in sorted(dir_path.glob('*.html')):
233
+ results.append(validate_file(html_file, verbose))
234
+ return results
235
+
236
+
237
+ def print_result(result: ValidationResult, verbose: bool = False):
238
+ """Print validation result for a file."""
239
+ status = "✓" if result.passed else "✗"
240
+ print(f" {status} {result.file_path.name}")
241
+
242
+ if result.errors:
243
+ for error in result.errors[:5]: # Limit output
244
+ print(f" ├─ {error}")
245
+ if len(result.errors) > 5:
246
+ print(f" └─ ... and {len(result.errors) - 5} more errors")
247
+
248
+ if verbose and result.warnings:
249
+ for warning in result.warnings[:3]:
250
+ print(f" [warn] {warning}")
251
+
252
+
253
+ def print_summary(all_results: Dict[str, List[ValidationResult]]):
254
+ """Print summary of all validation results."""
255
+ total_files = 0
256
+ total_passed = 0
257
+ total_errors = 0
258
+
259
+ print("\n" + "=" * 60)
260
+ print("HTML DESIGN TOKEN VALIDATION SUMMARY")
261
+ print("=" * 60)
262
+
263
+ for asset_type, results in all_results.items():
264
+ if not results:
265
+ continue
266
+
267
+ passed = sum(1 for r in results if r.passed)
268
+ failed = len(results) - passed
269
+ errors = sum(len(r.errors) for r in results)
270
+
271
+ total_files += len(results)
272
+ total_passed += passed
273
+ total_errors += errors
274
+
275
+ status = "✓" if failed == 0 else "✗"
276
+ print(f"\n{status} {asset_type.upper()}: {passed}/{len(results)} passed")
277
+
278
+ for result in results:
279
+ if not result.passed:
280
+ print_result(result)
281
+
282
+ print("\n" + "-" * 60)
283
+ if total_errors == 0:
284
+ print(f"✓ ALL PASSED: {total_passed}/{total_files} files valid")
285
+ else:
286
+ print(f"✗ FAILED: {total_files - total_passed}/{total_files} files have issues ({total_errors} total errors)")
287
+ print("-" * 60)
288
+
289
+ return total_errors == 0
290
+
291
+
292
+ def main():
293
+ """CLI entry point."""
294
+ import argparse
295
+
296
+ parser = argparse.ArgumentParser(
297
+ description='Validate HTML assets for design token compliance',
298
+ formatter_class=argparse.RawDescriptionHelpFormatter,
299
+ epilog="""
300
+ Examples:
301
+ %(prog)s # Validate all HTML assets
302
+ %(prog)s --type slides # Validate only slides
303
+ %(prog)s --type infographics # Validate only infographics
304
+ %(prog)s path/to/file.html # Validate specific file
305
+ %(prog)s --colors # Show brand colors from tokens
306
+ """
307
+ )
308
+ parser.add_argument('files', nargs='*', help='Specific HTML files to validate')
309
+ parser.add_argument('-t', '--type', choices=['slides', 'infographics', 'all'],
310
+ default='all', help='Asset type to validate')
311
+ parser.add_argument('-v', '--verbose', action='store_true', help='Show warnings')
312
+ parser.add_argument('--colors', action='store_true', help='Print CSS variables from tokens')
313
+ parser.add_argument('--fix', action='store_true', help='Auto-fix issues (experimental)')
314
+
315
+ args = parser.parse_args()
316
+
317
+ # Show colors mode
318
+ if args.colors:
319
+ variables = load_css_variables()
320
+ print("\nDesign Tokens (from design-tokens.css):")
321
+ print("-" * 40)
322
+ for name, value in sorted(variables.items())[:30]:
323
+ print(f" {name}: {value}")
324
+ if len(variables) > 30:
325
+ print(f" ... and {len(variables) - 30} more")
326
+ return
327
+
328
+ all_results: Dict[str, List[ValidationResult]] = {}
329
+
330
+ # Validate specific files
331
+ if args.files:
332
+ results = []
333
+ for file_path in args.files:
334
+ path = Path(file_path)
335
+ if path.exists():
336
+ results.append(validate_file(path, args.verbose))
337
+ else:
338
+ result = ValidationResult(path)
339
+ result.add_error("File not found")
340
+ results.append(result)
341
+ all_results['specified'] = results
342
+ else:
343
+ # Validate by type
344
+ types_to_check = ASSET_DIRS.keys() if args.type == 'all' else [args.type]
345
+
346
+ for asset_type in types_to_check:
347
+ if asset_type in ASSET_DIRS:
348
+ results = validate_directory(ASSET_DIRS[asset_type], args.verbose)
349
+ all_results[asset_type] = results
350
+
351
+ # Print results
352
+ success = print_summary(all_results)
353
+
354
+ if not success:
355
+ sys.exit(1)
356
+
357
+
358
+ if __name__ == '__main__':
359
+ main()