@sarjallab09/figma-intelligence 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (297) hide show
  1. package/README.md +67 -36
  2. package/dist/bin/cli.js +2 -0
  3. package/dist/design-bridge/bridge.js +2 -0
  4. package/dist/figma-bridge-plugin/bridge-relay.js +2 -0
  5. package/dist/figma-bridge-plugin/code.js +1 -0
  6. package/{figma-bridge-plugin → dist/figma-bridge-plugin}/package-lock.json +0 -3
  7. package/dist/figma-bridge-plugin/ui.html +4970 -0
  8. package/dist/figma-intelligence-layer/dist/index.js +2 -0
  9. package/dist/scripts/clean-existing-chunks.js +2 -0
  10. package/dist/scripts/connect-ai-tool.js +2 -0
  11. package/dist/scripts/convert-hub-pdfs.js +2 -0
  12. package/dist/scripts/figma-mcp-status.js +2 -0
  13. package/dist/scripts/register-codex-mcp.js +2 -0
  14. package/dist/scripts/test-copilot-chat.js +2 -0
  15. package/package.json +11 -8
  16. package/bin/cli.js +0 -859
  17. package/design-bridge/bridge.js +0 -196
  18. package/design-bridge/lib/assets.js +0 -367
  19. package/design-bridge/lib/prompt.js +0 -85
  20. package/design-bridge/lib/server.js +0 -66
  21. package/design-bridge/lib/stitch.js +0 -37
  22. package/design-bridge/lib/tokens.js +0 -82
  23. package/design-bridge/package-lock.json +0 -579
  24. package/figma-bridge-plugin/README.md +0 -97
  25. package/figma-bridge-plugin/anthropic-chat-runner.js +0 -192
  26. package/figma-bridge-plugin/bridge-relay.js +0 -2505
  27. package/figma-bridge-plugin/chat-runner.js +0 -485
  28. package/figma-bridge-plugin/code.js +0 -1534
  29. package/figma-bridge-plugin/codex-runner.js +0 -505
  30. package/figma-bridge-plugin/component-schemas.js +0 -110
  31. package/figma-bridge-plugin/content-context.js +0 -869
  32. package/figma-bridge-plugin/create-button.js +0 -216
  33. package/figma-bridge-plugin/gemini-cli-runner.js +0 -291
  34. package/figma-bridge-plugin/gemini-runner.js +0 -187
  35. package/figma-bridge-plugin/html-to-figma.js +0 -927
  36. package/figma-bridge-plugin/knowledge-hub/.gitkeep +0 -0
  37. package/figma-bridge-plugin/knowledge-hub/uspec-references/anatomy-spec.md +0 -159
  38. package/figma-bridge-plugin/knowledge-hub/uspec-references/api-spec.md +0 -162
  39. package/figma-bridge-plugin/knowledge-hub/uspec-references/color-spec.md +0 -148
  40. package/figma-bridge-plugin/knowledge-hub/uspec-references/full-spec-template.md +0 -314
  41. package/figma-bridge-plugin/knowledge-hub/uspec-references/property-spec.md +0 -175
  42. package/figma-bridge-plugin/knowledge-hub/uspec-references/screen-reader-spec.md +0 -180
  43. package/figma-bridge-plugin/knowledge-hub/uspec-references/structure-spec.md +0 -165
  44. package/figma-bridge-plugin/perplexity-runner.js +0 -188
  45. package/figma-bridge-plugin/references/SKILL.md +0 -178
  46. package/figma-bridge-plugin/references/anatomy-spec.md +0 -159
  47. package/figma-bridge-plugin/references/api-spec.md +0 -162
  48. package/figma-bridge-plugin/references/color-spec.md +0 -148
  49. package/figma-bridge-plugin/references/full-spec-template.md +0 -314
  50. package/figma-bridge-plugin/references/property-spec.md +0 -175
  51. package/figma-bridge-plugin/references/screen-reader-spec.md +0 -180
  52. package/figma-bridge-plugin/references/structure-spec.md +0 -165
  53. package/figma-bridge-plugin/shared-prompt-config.js +0 -645
  54. package/figma-bridge-plugin/spec-helpers/build-table.js +0 -269
  55. package/figma-bridge-plugin/spec-helpers/classify-elements.js +0 -189
  56. package/figma-bridge-plugin/spec-helpers/index.js +0 -35
  57. package/figma-bridge-plugin/spec-helpers/parse-figma-link.js +0 -49
  58. package/figma-bridge-plugin/spec-helpers/position-markers.js +0 -158
  59. package/figma-bridge-plugin/stitch-auth.js +0 -322
  60. package/figma-bridge-plugin/stitch-runner.js +0 -1427
  61. package/figma-bridge-plugin/token-resolver.js +0 -107
  62. package/figma-bridge-plugin/ui.html +0 -4542
  63. package/figma-intelligence-layer/.env.example +0 -39
  64. package/figma-intelligence-layer/docs/local-image-generation.md +0 -60
  65. package/figma-intelligence-layer/examples/comfyui-workflow-template.example.json +0 -101
  66. package/figma-intelligence-layer/jest.config.js +0 -14
  67. package/figma-intelligence-layer/mcp-config.json +0 -19
  68. package/figma-intelligence-layer/package-lock.json +0 -5892
  69. package/figma-intelligence-layer/scripts/setup-comfyui-local.sh +0 -67
  70. package/figma-intelligence-layer/scripts/start-comfyui.sh +0 -33
  71. package/figma-intelligence-layer/src/index.ts +0 -2233
  72. package/figma-intelligence-layer/src/shared/auto-layout-validator.ts +0 -404
  73. package/figma-intelligence-layer/src/shared/cache.ts +0 -187
  74. package/figma-intelligence-layer/src/shared/color-operations.ts +0 -533
  75. package/figma-intelligence-layer/src/shared/color-utils.ts +0 -138
  76. package/figma-intelligence-layer/src/shared/component-script-builder.ts +0 -413
  77. package/figma-intelligence-layer/src/shared/component-templates.ts +0 -2767
  78. package/figma-intelligence-layer/src/shared/concept-taxonomy.ts +0 -694
  79. package/figma-intelligence-layer/src/shared/decision-log.ts +0 -128
  80. package/figma-intelligence-layer/src/shared/design-system-context.ts +0 -568
  81. package/figma-intelligence-layer/src/shared/design-system-intelligence.ts +0 -131
  82. package/figma-intelligence-layer/src/shared/design-system-matcher.ts +0 -184
  83. package/figma-intelligence-layer/src/shared/design-system-normalizers.ts +0 -196
  84. package/figma-intelligence-layer/src/shared/design-system-tokens.ts +0 -295
  85. package/figma-intelligence-layer/src/shared/dtcg-validator.ts +0 -530
  86. package/figma-intelligence-layer/src/shared/enrichment-pipeline.ts +0 -671
  87. package/figma-intelligence-layer/src/shared/figma-bridge.ts +0 -1418
  88. package/figma-intelligence-layer/src/shared/font-config.ts +0 -126
  89. package/figma-intelligence-layer/src/shared/icon-catalog.ts +0 -360
  90. package/figma-intelligence-layer/src/shared/icon-fetch.ts +0 -80
  91. package/figma-intelligence-layer/src/shared/prototype-script-builder.ts +0 -162
  92. package/figma-intelligence-layer/src/shared/response-compression.ts +0 -440
  93. package/figma-intelligence-layer/src/shared/semantic-token-catalog.ts +0 -324
  94. package/figma-intelligence-layer/src/shared/token-binder.ts +0 -505
  95. package/figma-intelligence-layer/src/shared/token-math.ts +0 -427
  96. package/figma-intelligence-layer/src/shared/token-naming.ts +0 -468
  97. package/figma-intelligence-layer/src/shared/token-utils.ts +0 -420
  98. package/figma-intelligence-layer/src/shared/types.ts +0 -346
  99. package/figma-intelligence-layer/src/shared/typography-presets.ts +0 -94
  100. package/figma-intelligence-layer/src/shared/unsplash.ts +0 -165
  101. package/figma-intelligence-layer/src/shared/vision-client.ts +0 -607
  102. package/figma-intelligence-layer/src/shared/vision-provider-anthropic.ts +0 -334
  103. package/figma-intelligence-layer/src/shared/vision-provider-openai.ts +0 -446
  104. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/a11y-annotate-handler.ts +0 -782
  105. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/a11y-annotate-renderer.ts +0 -496
  106. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/a11y-annotation-kit.ts +0 -230
  107. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/colorblind-sim.ts +0 -66
  108. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/index.ts +0 -810
  109. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/keyboard-sr-order-analyzer.ts +0 -1191
  110. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/keyboard-sr-order-figma-page.ts +0 -1346
  111. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/keyboard-sr-order-handler.ts +0 -148
  112. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/vpat-figma-page.ts +0 -499
  113. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/vpat-report.ts +0 -910
  114. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/wcag-checker.ts +0 -989
  115. package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/wcag-criteria.ts +0 -1160
  116. package/figma-intelligence-layer/src/tools/phase1-vision/design-from-ref/index.ts +0 -424
  117. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/component-recognizer.ts +0 -38
  118. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/ds-matcher.ts +0 -111
  119. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/font-matcher.ts +0 -114
  120. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/icon-resolver.ts +0 -103
  121. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/index.ts +0 -1060
  122. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/layout-segmenter.ts +0 -18
  123. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/token-inferencer.ts +0 -39
  124. package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/vision-pipeline.ts +0 -58
  125. package/figma-intelligence-layer/src/tools/phase1-vision/sketch-to-design/index.ts +0 -298
  126. package/figma-intelligence-layer/src/tools/phase1-vision/visual-audit/index.ts +0 -197
  127. package/figma-intelligence-layer/src/tools/phase2-accuracy/component-audit/index.ts +0 -494
  128. package/figma-intelligence-layer/src/tools/phase2-accuracy/intent-translator/index.ts +0 -356
  129. package/figma-intelligence-layer/src/tools/phase2-accuracy/layout-intelligence/container-patterns.ts +0 -123
  130. package/figma-intelligence-layer/src/tools/phase2-accuracy/layout-intelligence/index.ts +0 -663
  131. package/figma-intelligence-layer/src/tools/phase2-accuracy/lint-rules/built-in-rules.yaml +0 -56
  132. package/figma-intelligence-layer/src/tools/phase2-accuracy/lint-rules/index.ts +0 -614
  133. package/figma-intelligence-layer/src/tools/phase2-accuracy/lint-rules/rule-engine.ts +0 -113
  134. package/figma-intelligence-layer/src/tools/phase2-accuracy/theme-generator/color-theory.ts +0 -178
  135. package/figma-intelligence-layer/src/tools/phase2-accuracy/theme-generator/index.ts +0 -470
  136. package/figma-intelligence-layer/src/tools/phase2-accuracy/variant-expander/index.ts +0 -429
  137. package/figma-intelligence-layer/src/tools/phase2-accuracy/variant-expander/token-override-maps.ts +0 -226
  138. package/figma-intelligence-layer/src/tools/phase3-generation/ai-image-insert/index.ts +0 -535
  139. package/figma-intelligence-layer/src/tools/phase3-generation/component-archaeologist/index.ts +0 -660
  140. package/figma-intelligence-layer/src/tools/phase3-generation/component-archaeologist/pattern-fingerprints.ts +0 -209
  141. package/figma-intelligence-layer/src/tools/phase3-generation/composition-builder/index.ts +0 -540
  142. package/figma-intelligence-layer/src/tools/phase3-generation/figma-animated-build.ts +0 -391
  143. package/figma-intelligence-layer/src/tools/phase3-generation/page-architect/index.ts +0 -2019
  144. package/figma-intelligence-layer/src/tools/phase3-generation/page-architect/screen-templates.ts +0 -131
  145. package/figma-intelligence-layer/src/tools/phase3-generation/prototype-map/index.ts +0 -381
  146. package/figma-intelligence-layer/src/tools/phase3-generation/prototype-wire/index.ts +0 -565
  147. package/figma-intelligence-layer/src/tools/phase3-generation/swarm-build/index.ts +0 -764
  148. package/figma-intelligence-layer/src/tools/phase3-generation/system-drift/index.ts +0 -535
  149. package/figma-intelligence-layer/src/tools/phase3-generation/unsplash-search/index.ts +0 -84
  150. package/figma-intelligence-layer/src/tools/phase3-generation/url-to-frame/index.ts +0 -401
  151. package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/code-generators/css-animations.ts +0 -68
  152. package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/code-generators/framer-motion.ts +0 -78
  153. package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/code-generators/swift-animations.ts +0 -93
  154. package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/index.ts +0 -596
  155. package/figma-intelligence-layer/src/tools/phase4-sync/ci-check/index.ts +0 -462
  156. package/figma-intelligence-layer/src/tools/phase4-sync/export-tokens/index.ts +0 -1470
  157. package/figma-intelligence-layer/src/tools/phase4-sync/generate-component-code/index.ts +0 -829
  158. package/figma-intelligence-layer/src/tools/phase4-sync/handoff-spec/index.ts +0 -702
  159. package/figma-intelligence-layer/src/tools/phase4-sync/icon-library-sync/index.ts +0 -483
  160. package/figma-intelligence-layer/src/tools/phase4-sync/sync-from-code/index.ts +0 -501
  161. package/figma-intelligence-layer/src/tools/phase4-sync/sync-from-code/storybook-parser.ts +0 -106
  162. package/figma-intelligence-layer/src/tools/phase4-sync/watch-docs/index.ts +0 -676
  163. package/figma-intelligence-layer/src/tools/phase4-sync/webhook-listener/index.ts +0 -560
  164. package/figma-intelligence-layer/src/tools/phase5-governance/apg-doc/index.ts +0 -1043
  165. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/component-detection.ts +0 -620
  166. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/anatomy.ts +0 -331
  167. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/color-tokens.ts +0 -77
  168. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/properties.ts +0 -54
  169. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/snapshot.ts +0 -287
  170. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/spacing.ts +0 -71
  171. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/states.ts +0 -43
  172. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/typography.ts +0 -71
  173. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/index.ts +0 -221
  174. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/_default.ts +0 -166
  175. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/accordion.ts +0 -232
  176. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/alert.ts +0 -234
  177. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/avatar-group.ts +0 -270
  178. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/avatar.ts +0 -249
  179. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/badge.ts +0 -231
  180. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/banner.ts +0 -293
  181. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/breadcrumb.ts +0 -240
  182. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/button.ts +0 -243
  183. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/calendar.ts +0 -307
  184. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/card.ts +0 -143
  185. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/checkbox.ts +0 -227
  186. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/chip.ts +0 -233
  187. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/combobox.ts +0 -282
  188. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/datepicker.ts +0 -276
  189. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/divider.ts +0 -223
  190. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/drawer.ts +0 -255
  191. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/dropdown-menu.ts +0 -289
  192. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/empty-state.ts +0 -261
  193. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/file-uploader.ts +0 -290
  194. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/form.ts +0 -265
  195. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/grid.ts +0 -238
  196. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/icon.ts +0 -255
  197. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/index.ts +0 -128
  198. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/inline-edit.ts +0 -286
  199. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/inline-message.ts +0 -255
  200. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/input.ts +0 -330
  201. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/link.ts +0 -247
  202. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/list.ts +0 -250
  203. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/menu.ts +0 -247
  204. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/modal.ts +0 -144
  205. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/navbar.ts +0 -264
  206. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/navigation.ts +0 -251
  207. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/number-input.ts +0 -261
  208. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/pagination.ts +0 -248
  209. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/popover.ts +0 -270
  210. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/progress.ts +0 -251
  211. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/radio.ts +0 -142
  212. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/range-slider.ts +0 -282
  213. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/rating.ts +0 -250
  214. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/search.ts +0 -258
  215. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/segmented-control.ts +0 -265
  216. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/select.ts +0 -319
  217. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/skeleton.ts +0 -256
  218. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/slider.ts +0 -232
  219. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/spinner.ts +0 -239
  220. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/status-dot.ts +0 -252
  221. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/stepper.ts +0 -270
  222. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/table.ts +0 -244
  223. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/tabs.ts +0 -143
  224. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/tag.ts +0 -243
  225. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/textarea.ts +0 -259
  226. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/time-picker.ts +0 -293
  227. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/toast.ts +0 -144
  228. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/toggle.ts +0 -289
  229. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/toolbar.ts +0 -267
  230. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/tooltip.ts +0 -232
  231. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/treeview.ts +0 -257
  232. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/typography.ts +0 -319
  233. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/legacy-compat.ts +0 -121
  234. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/anatomy-diagram.ts +0 -430
  235. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/figma-page.ts +0 -312
  236. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/json.ts +0 -129
  237. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/markdown.ts +0 -78
  238. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/visual-doc.ts +0 -2333
  239. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/accessibility.ts +0 -100
  240. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/anatomy.ts +0 -32
  241. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/color-tokens.ts +0 -59
  242. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/content-guidance.ts +0 -18
  243. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/design-tokens.ts +0 -53
  244. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/interaction-rules.ts +0 -19
  245. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/overview.ts +0 -91
  246. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/properties-api.ts +0 -71
  247. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/qa-criteria.ts +0 -19
  248. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/related-components.ts +0 -110
  249. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/responsive.ts +0 -19
  250. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/size-specs.ts +0 -67
  251. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/spacing-structure.ts +0 -58
  252. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/state-specs.ts +0 -79
  253. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/states.ts +0 -50
  254. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/type-hierarchy.ts +0 -33
  255. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/typography.ts +0 -55
  256. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/usage-guidelines.ts +0 -73
  257. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/variants.ts +0 -81
  258. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/types.ts +0 -409
  259. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec-sheet/index.ts +0 -198
  260. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec-sheet/renderer.ts +0 -701
  261. package/figma-intelligence-layer/src/tools/phase5-governance/component-spec-sheet/types.ts +0 -88
  262. package/figma-intelligence-layer/src/tools/phase5-governance/decision-log/index.ts +0 -135
  263. package/figma-intelligence-layer/src/tools/phase5-governance/design-decision-log/index.ts +0 -491
  264. package/figma-intelligence-layer/src/tools/phase5-governance/ds-primitives/index.ts +0 -416
  265. package/figma-intelligence-layer/src/tools/phase5-governance/ds-scaffolder/index.ts +0 -722
  266. package/figma-intelligence-layer/src/tools/phase5-governance/ds-variables/index.ts +0 -449
  267. package/figma-intelligence-layer/src/tools/phase5-governance/health-report/index.ts +0 -393
  268. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/index.ts +0 -406
  269. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/figma-page.ts +0 -292
  270. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/json.ts +0 -24
  271. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/markdown.ts +0 -172
  272. package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/naming-guide.ts +0 -409
  273. package/figma-intelligence-layer/src/tools/phase5-governance/token-analytics/index.ts +0 -594
  274. package/figma-intelligence-layer/src/tools/phase5-governance/token-docs/index.ts +0 -710
  275. package/figma-intelligence-layer/src/tools/phase5-governance/token-migrate/index.ts +0 -458
  276. package/figma-intelligence-layer/src/tools/phase5-governance/token-naming/index.ts +0 -134
  277. package/figma-intelligence-layer/tests/apg-doc.test.ts +0 -101
  278. package/figma-intelligence-layer/tests/design-system-context.test.ts +0 -152
  279. package/figma-intelligence-layer/tests/design-system-matcher.test.ts +0 -144
  280. package/figma-intelligence-layer/tests/figma-bridge.test.ts +0 -83
  281. package/figma-intelligence-layer/tests/generate-image-and-insert.test.ts +0 -56
  282. package/figma-intelligence-layer/tests/screen-cloner-regression.test.ts +0 -69
  283. package/figma-intelligence-layer/tests/smoke.test.ts +0 -174
  284. package/figma-intelligence-layer/tests/spec-generator.test.ts +0 -127
  285. package/figma-intelligence-layer/tests/token-migrate.test.ts +0 -21
  286. package/figma-intelligence-layer/tests/token-naming.test.ts +0 -30
  287. package/figma-intelligence-layer/tsconfig.json +0 -19
  288. package/scripts/clean-existing-chunks.js +0 -179
  289. package/scripts/connect-ai-tool.js +0 -490
  290. package/scripts/convert-hub-pdfs.js +0 -425
  291. package/scripts/figma-mcp-status.js +0 -349
  292. package/scripts/register-codex-mcp.js +0 -96
  293. /package/{design-bridge → dist/design-bridge}/.env.example +0 -0
  294. /package/{design-bridge → dist/design-bridge}/package.json +0 -0
  295. /package/{figma-bridge-plugin → dist/figma-bridge-plugin}/manifest.json +0 -0
  296. /package/{figma-bridge-plugin → dist/figma-bridge-plugin}/package.json +0 -0
  297. /package/{figma-intelligence-layer → dist/figma-intelligence-layer}/package.json +0 -0
@@ -1,424 +0,0 @@
1
- import fs from "fs/promises";
2
- import { VisionClient } from "../../../shared/vision-client.js";
3
- import { getBridge } from "../../../shared/figma-bridge.js";
4
- import { decisionLog } from "../../../shared/decision-log.js";
5
- import { Token } from "../../../shared/types.js";
6
- import { snapToColorToken, snapToSpacingToken } from "../../../shared/token-utils.js";
7
-
8
- // ─────────────────────────────────────────────────────────────────────────────
9
- // Types
10
- // ─────────────────────────────────────────────────────────────────────────────
11
-
12
- export interface DesignFromRefArgs {
13
- references: string[];
14
- prompt: string;
15
- extractOnly?: string[];
16
- designSystemContext?: string;
17
- }
18
-
19
- export interface DesignFromRefResult {
20
- frameId: string;
21
- extractedPatterns: DesignLanguage;
22
- appliedTokens: AppliedToken[];
23
- generatedFrame: { nodeId: string };
24
- prompt: string;
25
- }
26
-
27
- interface ColorEntry {
28
- role: string;
29
- hex: string;
30
- frequency: string;
31
- }
32
-
33
- interface DesignLanguage {
34
- layout: {
35
- gridStructure: string;
36
- zoneProportions: string;
37
- hierarchy: string;
38
- };
39
- spacing: {
40
- density: "compact" | "comfortable" | "spacious";
41
- paddingPattern: string;
42
- dominantGap: number;
43
- };
44
- colorPalette: ColorEntry[];
45
- typography: {
46
- scalePattern: string;
47
- dominantWeights: number[];
48
- hierarchyLevels: number;
49
- };
50
- }
51
-
52
- interface AppliedToken {
53
- pattern: string;
54
- rawValue: string | number;
55
- mappedToken: string;
56
- tokenValue: string | number;
57
- }
58
-
59
- // ─────────────────────────────────────────────────────────────────────────────
60
- // Helpers
61
- // ─────────────────────────────────────────────────────────────────────────────
62
-
63
- async function resolveReference(ref: string): Promise<string> {
64
- if (ref.startsWith("data:image") || ref.startsWith("http")) return ref;
65
- const buf = await fs.readFile(ref);
66
- return `data:image/png;base64,${buf.toString("base64")}`;
67
- }
68
-
69
- function parseDesignLanguage(raw: Record<string, unknown>): DesignLanguage {
70
- const layout = (raw.layout as Record<string, unknown>) ?? {};
71
- const spacing = (raw.spacing as Record<string, unknown>) ?? {};
72
- const colorPalette = Array.isArray(raw.colorPalette)
73
- ? (raw.colorPalette as ColorEntry[])
74
- : [];
75
- const typography = (raw.typography as Record<string, unknown>) ?? {};
76
-
77
- return {
78
- layout: {
79
- gridStructure: String(layout.gridStructure ?? "12-column"),
80
- zoneProportions: String(layout.zoneProportions ?? "balanced"),
81
- hierarchy: String(layout.hierarchy ?? "standard"),
82
- },
83
- spacing: {
84
- density:
85
- spacing.density === "compact" ||
86
- spacing.density === "comfortable" ||
87
- spacing.density === "spacious"
88
- ? spacing.density
89
- : "comfortable",
90
- paddingPattern: String(spacing.paddingPattern ?? "16px"),
91
- dominantGap: typeof spacing.dominantGap === "number" ? spacing.dominantGap : 16,
92
- },
93
- colorPalette: colorPalette.map((c) => ({
94
- role: String(c.role ?? "accent"),
95
- hex: String(c.hex ?? "#000000"),
96
- frequency: String(c.frequency ?? "minimal"),
97
- })),
98
- typography: {
99
- scalePattern: String(typography.scalePattern ?? "modular"),
100
- dominantWeights: Array.isArray(typography.dominantWeights)
101
- ? (typography.dominantWeights as number[])
102
- : [400, 600],
103
- hierarchyLevels:
104
- typeof typography.hierarchyLevels === "number" ? typography.hierarchyLevels : 3,
105
- },
106
- };
107
- }
108
-
109
- function mapDesignLanguageToTokens(
110
- lang: DesignLanguage,
111
- dsTokens: Token[]
112
- ): AppliedToken[] {
113
- const applied: AppliedToken[] = [];
114
-
115
- // Map spacing
116
- const gapToken = snapToSpacingToken(lang.spacing.dominantGap);
117
- applied.push({
118
- pattern: "dominantGap",
119
- rawValue: lang.spacing.dominantGap,
120
- mappedToken: gapToken.tokenName,
121
- tokenValue: gapToken.tokenValue,
122
- });
123
-
124
- // Infer padding from density
125
- const densityPaddingMap: Record<string, number> = {
126
- compact: 8,
127
- comfortable: 16,
128
- spacious: 32,
129
- };
130
- const inferredPadding = densityPaddingMap[lang.spacing.density];
131
- const paddingToken = snapToSpacingToken(inferredPadding);
132
- applied.push({
133
- pattern: "framePadding",
134
- rawValue: inferredPadding,
135
- mappedToken: paddingToken.tokenName,
136
- tokenValue: paddingToken.tokenValue,
137
- });
138
-
139
- // Map colors from palette to DS tokens
140
- if (dsTokens.length > 0) {
141
- for (const color of lang.colorPalette) {
142
- const matched = snapToColorToken(color.hex, dsTokens);
143
- applied.push({
144
- pattern: `color.${color.role}`,
145
- rawValue: color.hex,
146
- mappedToken: matched.tokenName,
147
- tokenValue: String(matched.tokenValue),
148
- });
149
- }
150
- } else {
151
- for (const color of lang.colorPalette) {
152
- applied.push({
153
- pattern: `color.${color.role}`,
154
- rawValue: color.hex,
155
- mappedToken: `--color-${color.role}`,
156
- tokenValue: color.hex,
157
- });
158
- }
159
- }
160
-
161
- return applied;
162
- }
163
-
164
- function buildFrameScript(
165
- lang: DesignLanguage,
166
- appliedTokens: AppliedToken[],
167
- frameName: string,
168
- prompt: string
169
- ): string {
170
- // Extract resolved token values for use in the script
171
- const gapToken = appliedTokens.find((t) => t.pattern === "dominantGap");
172
- const paddingToken = appliedTokens.find((t) => t.pattern === "framePadding");
173
- const primaryColorToken = appliedTokens.find((t) => t.pattern === "color.primary");
174
- const surfaceColorToken = appliedTokens.find((t) => t.pattern === "color.surface");
175
-
176
- const gap = typeof gapToken?.tokenValue === "number" ? gapToken.tokenValue : 16;
177
- const padding = typeof paddingToken?.tokenValue === "number" ? paddingToken.tokenValue : 16;
178
-
179
- // Parse primary color (hex → Figma 0-1 range)
180
- const primaryHex = String(primaryColorToken?.rawValue ?? "#2563EB").replace("#", "");
181
- const surfaceHex = String(surfaceColorToken?.rawValue ?? "#FFFFFF").replace("#", "");
182
-
183
- function hexToFigmaRgb(hex: string): { r: number; g: number; b: number } {
184
- const full = hex.length === 3
185
- ? hex.split("").map((c) => c + c).join("")
186
- : hex.padEnd(6, "0").slice(0, 6);
187
- const n = parseInt(full, 16);
188
- return {
189
- r: ((n >> 16) & 255) / 255,
190
- g: ((n >> 8) & 255) / 255,
191
- b: (n & 255) / 255,
192
- };
193
- }
194
-
195
- const primaryRgb = hexToFigmaRgb(primaryHex);
196
- const surfaceRgb = hexToFigmaRgb(surfaceHex);
197
- const hierarchyLevels = lang.typography.hierarchyLevels;
198
-
199
- return `
200
- (async () => {
201
- const frameName = ${JSON.stringify(frameName)};
202
- const prompt = ${JSON.stringify(prompt)};
203
- const gap = ${gap};
204
- const padding = ${padding};
205
- const primaryColor = ${JSON.stringify(primaryRgb)};
206
- const surfaceColor = ${JSON.stringify(surfaceRgb)};
207
- const hierarchyLevels = ${hierarchyLevels};
208
- const gridStructure = ${JSON.stringify(lang.layout.gridStructure)};
209
- const density = ${JSON.stringify(lang.spacing.density)};
210
-
211
- // Create root frame re-interpreting the reference design language
212
- const outerFrame = figma.createFrame();
213
- outerFrame.name = frameName;
214
- outerFrame.resize(1440, 900);
215
- outerFrame.layoutMode = "VERTICAL";
216
- outerFrame.primaryAxisSizingMode = "AUTO";
217
- outerFrame.counterAxisSizingMode = "FIXED";
218
- outerFrame.itemSpacing = gap;
219
- outerFrame.paddingLeft = padding;
220
- outerFrame.paddingRight = padding;
221
- outerFrame.paddingTop = padding;
222
- outerFrame.paddingBottom = padding;
223
- outerFrame.fills = [{ type: "SOLID", color: surfaceColor }];
224
- figma.currentPage.appendChild(outerFrame);
225
-
226
- await figma.loadFontAsync({ family: "Inter", style: "Regular" });
227
- await figma.loadFontAsync({ family: "Inter", style: "Bold" });
228
- await figma.loadFontAsync({ family: "Inter", style: "SemiBold" });
229
-
230
- // Header zone — reflects the extracted hierarchy
231
- const headerFrame = figma.createFrame();
232
- headerFrame.name = "Header";
233
- headerFrame.resize(1440 - padding * 2, 72);
234
- headerFrame.layoutMode = "HORIZONTAL";
235
- headerFrame.primaryAxisSizingMode = "FIXED";
236
- headerFrame.counterAxisSizingMode = "AUTO";
237
- headerFrame.counterAxisAlignItems = "CENTER";
238
- headerFrame.paddingLeft = 0;
239
- headerFrame.paddingRight = 0;
240
- headerFrame.itemSpacing = gap;
241
- headerFrame.fills = [];
242
- headerFrame.layoutSizingHorizontal = "FILL";
243
- outerFrame.appendChild(headerFrame);
244
-
245
- // Page title text
246
- const titleText = figma.createText();
247
- titleText.characters = prompt.slice(0, 60);
248
- titleText.fontName = { family: "Inter", style: "Bold" };
249
- titleText.fontSize = hierarchyLevels >= 3 ? 32 : 24;
250
- titleText.fills = [{ type: "SOLID", color: { r: 0.07, g: 0.07, b: 0.07 } }];
251
- titleText.layoutSizingHorizontal = "FILL";
252
- headerFrame.appendChild(titleText);
253
-
254
- // Primary action button placeholder
255
- const actionBtn = figma.createFrame();
256
- actionBtn.name = "Primary Action";
257
- actionBtn.resize(140, 44);
258
- actionBtn.cornerRadius = 8;
259
- actionBtn.fills = [{ type: "SOLID", color: primaryColor }];
260
- actionBtn.layoutMode = "HORIZONTAL";
261
- actionBtn.primaryAxisAlignItems = "CENTER";
262
- actionBtn.counterAxisAlignItems = "CENTER";
263
- headerFrame.appendChild(actionBtn);
264
-
265
- const btnLabel = figma.createText();
266
- btnLabel.characters = "Primary Action";
267
- btnLabel.fontName = { family: "Inter", style: "SemiBold" };
268
- btnLabel.fontSize = 14;
269
- btnLabel.fills = [{ type: "SOLID", color: { r: 1, g: 1, b: 1 } }];
270
- actionBtn.appendChild(btnLabel);
271
-
272
- // Content zone — grid based on extracted grid structure
273
- const contentRow = figma.createFrame();
274
- contentRow.name = "Content Grid";
275
- contentRow.resize(1440 - padding * 2, 500);
276
- contentRow.layoutMode = "HORIZONTAL";
277
- contentRow.primaryAxisSizingMode = "FIXED";
278
- contentRow.counterAxisSizingMode = "AUTO";
279
- contentRow.itemSpacing = gap;
280
- contentRow.fills = [];
281
- contentRow.layoutSizingHorizontal = "FILL";
282
- outerFrame.appendChild(contentRow);
283
-
284
- // Determine column count from grid structure
285
- const colCount = gridStructure.includes("12") ? 3 : gridStructure.includes("8") ? 2 : 3;
286
- const colWidth = Math.floor((1440 - padding * 2 - gap * (colCount - 1)) / colCount);
287
-
288
- for (let col = 0; col < colCount; col++) {
289
- const card = figma.createFrame();
290
- card.name = "Content Card " + (col + 1);
291
- card.resize(colWidth, 240);
292
- card.cornerRadius = 12;
293
- card.fills = [{ type: "SOLID", color: { r: 0.97, g: 0.97, b: 0.97 } }];
294
- card.strokes = [{ type: "SOLID", color: { r: 0.9, g: 0.9, b: 0.9 } }];
295
- card.strokeWeight = 1;
296
- card.layoutMode = "VERTICAL";
297
- card.primaryAxisSizingMode = "FIXED";
298
- card.paddingLeft = padding;
299
- card.paddingRight = padding;
300
- card.paddingTop = padding;
301
- card.paddingBottom = padding;
302
- card.itemSpacing = gap / 2;
303
-
304
- const cardTitle = figma.createText();
305
- cardTitle.characters = "Section " + (col + 1);
306
- cardTitle.fontName = { family: "Inter", style: "SemiBold" };
307
- cardTitle.fontSize = 16;
308
- cardTitle.fills = [{ type: "SOLID", color: { r: 0.1, g: 0.1, b: 0.1 } }];
309
- card.appendChild(cardTitle);
310
-
311
- const cardBody = figma.createText();
312
- cardBody.characters = "Content re-interpreted from reference design using design system tokens.";
313
- cardBody.fontName = { family: "Inter", style: "Regular" };
314
- cardBody.fontSize = 14;
315
- cardBody.fills = [{ type: "SOLID", color: { r: 0.45, g: 0.45, b: 0.45 } }];
316
- cardBody.layoutSizingHorizontal = "FILL";
317
- card.appendChild(cardBody);
318
-
319
- contentRow.appendChild(card);
320
- }
321
-
322
- // Attach description note about the design language extraction
323
- const noteSticky = figma.createSticky();
324
- noteSticky.text.characters =
325
- "Generated from reference design language\\n" +
326
- "Grid: " + gridStructure + " | Density: " + density + "\\n" +
327
- "Prompt: " + prompt.slice(0, 120);
328
- noteSticky.x = outerFrame.x + 1440 + 32;
329
- noteSticky.y = outerFrame.y;
330
- figma.currentPage.appendChild(noteSticky);
331
-
332
- figma.viewport.scrollAndZoomIntoView([outerFrame]);
333
- return { frameId: outerFrame.id, nodeId: outerFrame.id };
334
- })();
335
- `;
336
- }
337
-
338
- // ─────────────────────────────────────────────────────────────────────────────
339
- // Handler
340
- // ─────────────────────────────────────────────────────────────────────────────
341
-
342
- export async function designFromRefHandler(
343
- args: DesignFromRefArgs
344
- ): Promise<DesignFromRefResult> {
345
- const {
346
- references,
347
- prompt,
348
- extractOnly,
349
- designSystemContext = "",
350
- } = args;
351
-
352
- if (references.length === 0) {
353
- throw new Error("designFromRefHandler: at least one reference image is required");
354
- }
355
-
356
- // 1. Resolve all references to base64 / URLs
357
- const resolvedRefs = await Promise.all(references.map(resolveReference));
358
-
359
- // 2. Determine what to extract
360
- const defaultExtractTypes = ["layout", "spacing", "colorPalette", "typography"];
361
- const extractTypes =
362
- extractOnly && extractOnly.length > 0 ? extractOnly : defaultExtractTypes;
363
-
364
- // 3. Extract design language from all references
365
- const vision = new VisionClient();
366
- const rawLang = await vision.extractDesignLanguage(resolvedRefs, extractTypes);
367
-
368
- // 4. Parse and normalise the extracted design language
369
- const lang = parseDesignLanguage(rawLang);
370
-
371
- // 5. Load DS tokens to map extracted patterns onto real tokens
372
- const bridge = await getBridge();
373
- const dsId = bridge.getActiveDesignSystemId();
374
- let dsTokens: Token[];
375
- if (dsId) {
376
- // When a DS is selected, use its authoritative tokens
377
- const { getDesignSystemTokens } = await import("../../../shared/design-system-tokens.js");
378
- dsTokens = getDesignSystemTokens(dsId);
379
- } else {
380
- dsTokens = await bridge.getTokens();
381
- }
382
-
383
- // 6. Map extracted design language to DS tokens
384
- const appliedTokens = mapDesignLanguageToTokens(lang, dsTokens);
385
-
386
- // 7. Build and execute Figma frame script
387
- const contextSuffix = designSystemContext ? ` — ${designSystemContext.slice(0, 30)}` : "";
388
- const frameName = `[Design from Ref] ${new Date().toLocaleDateString("en-US")}${contextSuffix}`;
389
- const script = buildFrameScript(lang, appliedTokens, frameName, prompt);
390
-
391
- const execResult = await bridge.execute(script);
392
- if (!execResult.success) {
393
- throw new Error(
394
- `designFromRefHandler: Figma execution failed — ${execResult.error}`
395
- );
396
- }
397
-
398
- const execData = execResult.result as { frameId: string; nodeId: string };
399
-
400
- // 8. Log action
401
- await decisionLog.log({
402
- tool: "figma_design_from_ref",
403
- nodeIds: [execData.frameId],
404
- rationale: `Created design frame from ${references.length} reference image(s). Extracted ${extractTypes.join(", ")}. Mapped ${appliedTokens.length} design patterns to DS tokens. Prompt: "${prompt.slice(0, 100)}".`,
405
- tokens: appliedTokens.map((t) => t.mappedToken),
406
- reversible: true,
407
- metadata: {
408
- referenceCount: references.length,
409
- extractTypes,
410
- designSystemContext,
411
- appliedTokenCount: appliedTokens.length,
412
- colorPaletteSize: lang.colorPalette.length,
413
- spacingDensity: lang.spacing.density,
414
- },
415
- });
416
-
417
- return {
418
- frameId: execData.frameId,
419
- extractedPatterns: lang,
420
- appliedTokens,
421
- generatedFrame: { nodeId: execData.nodeId },
422
- prompt,
423
- };
424
- }
@@ -1,38 +0,0 @@
1
- // ─────────────────────────────────────────────────────────────────────────────
2
- // Component Recognizer (Vision Pass 2)
3
- // Identifies the UI component type, variants, and properties of a single zone.
4
- // ─────────────────────────────────────────────────────────────────────────────
5
-
6
- import { VisionClient } from "../../../shared/vision-client.js";
7
- import { ComponentManifest } from "../../../shared/types.js";
8
-
9
- const RECOGNIZE_PROMPT = `Analyze this UI region and identify the component. Return JSON with:
10
- - componentType: specific UI component name (e.g. "PrimaryButton", "TextInput", "NavigationBar")
11
- - variants: object of detected variants {size, state, theme, type}
12
- - textContent: visible text content (null if none)
13
- - iconPresent: boolean
14
- - iconName: best guess for the icon or logo name (null if none)
15
- - iconKind: "system" | "brand" | "illustration" | "unknown"
16
- - preferredIconLibrary: best open-source icon family for this region, prefer "material-symbols" for standard UI and "simple-icons" for brands
17
- - openSourceIconName: exact open-source icon slug if recognizable (examples: "menu", "search", "close", "shopping_cart")
18
- - interactiveElement: boolean (is this clickable/focusable?)
19
- - estimatedSpacing: measured padding/gap in pixels, prefer exact visual estimate over assumptions
20
- - estimatedRadius: border radius in pixels if visible
21
- - estimatedFontSize: visible text size in pixels if text is present
22
- - fontFamilyGuess: closest visible font family name if text is present
23
- - fontStyleGuess: closest visible font style name if text is present
24
- - fontWeightGuess: closest visible font weight number if text is present
25
- - confidence: 0-1 how confident you are in this identification
26
-
27
- Return ONLY valid JSON.`;
28
-
29
- /**
30
- * Run Vision Pass 2 on a single zone image to produce a ComponentManifest.
31
- */
32
- export async function recognizeComponent(
33
- zoneImage: string,
34
- vision: VisionClient
35
- ): Promise<ComponentManifest> {
36
- void RECOGNIZE_PROMPT;
37
- return vision.identify(zoneImage);
38
- }
@@ -1,111 +0,0 @@
1
- import {
2
- DesignSystemContext,
3
- DSComponentSet,
4
- } from "../../../shared/design-system-context.js";
5
- import {
6
- manifestToDSMatchRequest,
7
- matchComponentInContext,
8
- } from "../../../shared/design-system-matcher.js";
9
- import { inferComponentIntents, inferVariantSchema, normalizeName } from "../../../shared/design-system-normalizers.js";
10
- import { ComponentManifest, ComponentSet } from "../../../shared/types.js";
11
-
12
- export interface DSMatchResult {
13
- component: DSComponentSet | null;
14
- confidence: number;
15
- fallbackSuggestion: string | null;
16
- }
17
-
18
- const DEFAULT_CONFIDENCE_THRESHOLD = 0.75;
19
-
20
- /**
21
- * Match a ComponentManifest to the nearest design-system component.
22
- *
23
- * @param manifest Recognised component manifest from Vision Pass 2
24
- * @param context Shared design-system context
25
- * @param threshold Minimum confidence (0–1) to accept the match
26
- * @returns Matched ComponentSet (or null) with confidence score
27
- */
28
- export function matchToDesignSystem(
29
- manifest: ComponentManifest,
30
- contextOrSets: DesignSystemContext | ComponentSet[],
31
- threshold = DEFAULT_CONFIDENCE_THRESHOLD
32
- ): DSMatchResult {
33
- const context = Array.isArray(contextOrSets) ? createAdHocContext(contextOrSets) : contextOrSets;
34
- const result = matchComponentInContext(manifestToDSMatchRequest(manifest), context, threshold);
35
- return {
36
- component: result.component,
37
- confidence: result.confidence,
38
- fallbackSuggestion: result.fallbackSuggestion,
39
- };
40
- }
41
-
42
- function createAdHocContext(componentSets: ComponentSet[]): DesignSystemContext {
43
- const normalizedSets = componentSets.map((set) => ({
44
- id: set.id,
45
- name: set.name,
46
- normalizedName: normalizeName(set.name),
47
- description: set.description,
48
- childComponentIds: set.children.map((child) => child.id),
49
- variantSchema: inferVariantSchema(set),
50
- intents: Array.from(
51
- new Set([
52
- ...inferComponentIntents(set.name, set.description),
53
- ...set.children.flatMap((child) => inferComponentIntents(child.name, child.description)),
54
- ])
55
- ),
56
- }));
57
-
58
- const components = componentSets.flatMap((set) =>
59
- set.children.map((child) => ({
60
- id: child.id,
61
- setId: set.id,
62
- name: child.name,
63
- normalizedName: normalizeName(child.name),
64
- description: child.description,
65
- variantProps: {},
66
- intents: inferComponentIntents(child.name, child.description),
67
- }))
68
- );
69
-
70
- return {
71
- file: {
72
- lastSyncedAt: Date.now(),
73
- source: "mixed",
74
- },
75
- inventory: {
76
- componentSets: normalizedSets,
77
- components,
78
- variables: [],
79
- styles: [],
80
- pages: [],
81
- instances: [],
82
- },
83
- indexes: {
84
- componentById: new Map(components.map((component) => [component.id, component])),
85
- componentSetById: new Map(normalizedSets.map((componentSet) => [componentSet.id, componentSet])),
86
- tokenById: new Map(),
87
- styleById: new Map(),
88
- componentsByNormalizedName: new Map(),
89
- tokensByNormalizedName: new Map(),
90
- componentsByIntent: new Map(),
91
- },
92
- intelligence: {
93
- aliases: {},
94
- variantSchemas: Object.fromEntries(
95
- normalizedSets
96
- .filter((set) => set.variantSchema)
97
- .map((set) => [set.id, set.variantSchema!])
98
- ),
99
- semanticTokenGroups: {},
100
- preferredComponentsByIntent: {},
101
- namingRules: [],
102
- },
103
- freshness: {
104
- componentSets: Date.now(),
105
- variables: 0,
106
- styles: 0,
107
- pages: 0,
108
- instances: 0,
109
- },
110
- };
111
- }
@@ -1,114 +0,0 @@
1
- import { ComponentManifest } from "../../../shared/types.js";
2
-
3
- interface FontName {
4
- family: string;
5
- style: string;
6
- }
7
-
8
- interface RawTextStyle {
9
- id: string;
10
- name: string;
11
- fontName?: FontName;
12
- fontSize?: number;
13
- lineHeight?: { unit?: string; value?: number };
14
- }
15
-
16
- export interface FontStyleMatch {
17
- styleId: string;
18
- styleName: string;
19
- fontFamily: string;
20
- fontStyle: string;
21
- fontSize: number;
22
- lineHeightPx?: number;
23
- confidence: number;
24
- }
25
-
26
- function normalize(value: string | undefined): string {
27
- return (value ?? "").trim().toLowerCase();
28
- }
29
-
30
- function scoreStringMatch(a: string | undefined, b: string | undefined): number {
31
- const left = normalize(a);
32
- const right = normalize(b);
33
- if (!left || !right) return 0;
34
- if (left === right) return 1;
35
- if (left.includes(right) || right.includes(left)) return 0.8;
36
-
37
- const leftTokens = new Set(left.split(/[\s/_-]+/).filter(Boolean));
38
- const rightTokens = right.split(/[\s/_-]+/).filter(Boolean);
39
- if (!leftTokens.size || !rightTokens.length) return 0;
40
-
41
- const overlap = rightTokens.filter((token) => leftTokens.has(token)).length;
42
- return overlap / Math.max(leftTokens.size, rightTokens.length);
43
- }
44
-
45
- function scoreNumericProximity(actual: number | undefined, expected: number | undefined, maxDelta: number): number {
46
- if (actual == null || expected == null) return 0;
47
- const delta = Math.abs(actual - expected);
48
- return Math.max(0, 1 - delta / maxDelta);
49
- }
50
-
51
- function normalizeTextStyles(styles: Record<string, unknown> | undefined): RawTextStyle[] {
52
- if (!styles || !Array.isArray(styles.text)) return [];
53
- return styles.text.filter((style): style is RawTextStyle => {
54
- return typeof style === "object" && style !== null && "id" in style && "name" in style;
55
- });
56
- }
57
-
58
- export function resolveFontStyleMatch(
59
- manifest: ComponentManifest,
60
- styles: Record<string, unknown> | undefined
61
- ): FontStyleMatch | null {
62
- const candidates = normalizeTextStyles(styles);
63
- if (candidates.length === 0) return null;
64
-
65
- const scored = candidates
66
- .map((style) => {
67
- const familyScore = scoreStringMatch(style.fontName?.family, manifest.fontFamilyGuess);
68
- const styleScore = scoreStringMatch(style.fontName?.style ?? style.name, manifest.fontStyleGuess);
69
- const sizeScore = scoreNumericProximity(style.fontSize, manifest.estimatedFontSize, 16);
70
- const weightScore = scoreNumericProximity(
71
- inferWeight(style.fontName?.style),
72
- manifest.fontWeightGuess,
73
- 500
74
- );
75
-
76
- const confidence = familyScore * 0.45 + styleScore * 0.2 + sizeScore * 0.2 + weightScore * 0.15;
77
-
78
- return {
79
- style,
80
- confidence,
81
- };
82
- })
83
- .sort((a, b) => b.confidence - a.confidence);
84
-
85
- const best = scored[0];
86
- if (!best || best.confidence < 0.35 || !best.style.fontName || best.style.fontSize == null) {
87
- return null;
88
- }
89
-
90
- return {
91
- styleId: best.style.id,
92
- styleName: best.style.name,
93
- fontFamily: best.style.fontName.family,
94
- fontStyle: best.style.fontName.style,
95
- fontSize: best.style.fontSize,
96
- lineHeightPx: best.style.lineHeight?.unit === "PIXELS" ? best.style.lineHeight.value : undefined,
97
- confidence: best.confidence,
98
- };
99
- }
100
-
101
- function inferWeight(fontStyle: string | undefined): number | undefined {
102
- const value = normalize(fontStyle);
103
- if (!value) return undefined;
104
- if (value.includes("thin")) return 100;
105
- if (value.includes("extralight") || value.includes("ultralight")) return 200;
106
- if (value.includes("light")) return 300;
107
- if (value.includes("regular") || value.includes("book")) return 400;
108
- if (value.includes("medium")) return 500;
109
- if (value.includes("semibold") || value.includes("demibold")) return 600;
110
- if (value.includes("bold")) return 700;
111
- if (value.includes("extrabold") || value.includes("ultrabold")) return 800;
112
- if (value.includes("black") || value.includes("heavy")) return 900;
113
- return undefined;
114
- }