@sarjallab09/figma-intelligence 1.1.0 → 1.2.1

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 +69 -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,607 +0,0 @@
1
- import {
2
- VisionResult,
3
- LayoutZone,
4
- LayoutNode,
5
- LayoutNodeAlignment,
6
- LayoutNodeType,
7
- ComponentManifest,
8
- } from "./types.js";
9
- import { OpenAIVisionProvider } from "./vision-provider-openai.js";
10
- import { AnthropicVisionProvider } from "./vision-provider-anthropic.js";
11
-
12
- const DEFAULT_MANIFEST: ComponentManifest = {
13
- componentType: "Unknown",
14
- variants: {},
15
- iconPresent: false,
16
- iconKind: "unknown",
17
- preferredIconLibrary: "material-symbols",
18
- interactiveElement: false,
19
- estimatedSpacing: 8,
20
- confidence: 0.3,
21
- };
22
-
23
- function clampConfidence(value: unknown, fallback = 0.5): number {
24
- if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
25
- return Math.min(1, Math.max(0, value));
26
- }
27
-
28
- function coerceOptionalConfidence(value: unknown): number | undefined {
29
- if (typeof value !== "number" || !Number.isFinite(value)) return undefined;
30
- return Math.min(1, Math.max(0, value));
31
- }
32
-
33
- function coerceOptionalString(value: unknown): string | undefined {
34
- return typeof value === "string" && value.trim() ? value.trim() : undefined;
35
- }
36
-
37
- function coerceOptionalNumber(value: unknown): number | undefined {
38
- return typeof value === "number" && Number.isFinite(value) ? value : undefined;
39
- }
40
-
41
- function coerceStringArray(value: unknown): string[] | undefined {
42
- if (!Array.isArray(value)) return undefined;
43
- const strings = value.filter((item): item is string => typeof item === "string" && item.trim().length > 0);
44
- return strings.length > 0 ? strings : undefined;
45
- }
46
-
47
- function normalizeLayoutType(value: unknown): LayoutNodeType {
48
- switch (value) {
49
- case "page":
50
- case "sidebar":
51
- case "header":
52
- case "toolbar":
53
- case "content":
54
- case "footer":
55
- case "drawer":
56
- case "modal":
57
- case "card":
58
- case "form":
59
- case "form-row":
60
- case "nav":
61
- case "button-group":
62
- case "tab-bar":
63
- case "table":
64
- case "table-row":
65
- case "list":
66
- case "list-item":
67
- case "section":
68
- case "overlay":
69
- return value;
70
- default:
71
- return "content";
72
- }
73
- }
74
-
75
- function normalizeLayoutAlignment(raw: unknown): LayoutNodeAlignment | undefined {
76
- if (!raw || typeof raw !== "object") return undefined;
77
- const candidate = raw as Record<string, unknown>;
78
- const padding =
79
- candidate.padding && typeof candidate.padding === "object"
80
- ? (candidate.padding as Record<string, unknown>)
81
- : null;
82
-
83
- const direction =
84
- candidate.direction === "horizontal" ||
85
- candidate.direction === "vertical" ||
86
- candidate.direction === "none"
87
- ? candidate.direction
88
- : undefined;
89
-
90
- const distribution =
91
- candidate.distribution === "start" ||
92
- candidate.distribution === "center" ||
93
- candidate.distribution === "end" ||
94
- candidate.distribution === "space-between"
95
- ? candidate.distribution
96
- : undefined;
97
-
98
- const crossAlignment =
99
- candidate.crossAlignment === "start" ||
100
- candidate.crossAlignment === "center" ||
101
- candidate.crossAlignment === "end" ||
102
- candidate.crossAlignment === "stretch"
103
- ? candidate.crossAlignment
104
- : undefined;
105
-
106
- const stackingOrder =
107
- candidate.stackingOrder === "normal" ||
108
- candidate.stackingOrder === "reverse" ||
109
- candidate.stackingOrder === "overlay"
110
- ? candidate.stackingOrder
111
- : undefined;
112
-
113
- const normalizedPadding =
114
- padding &&
115
- [padding.top, padding.right, padding.bottom, padding.left].some((value) => coerceOptionalNumber(value) != null)
116
- ? {
117
- top: coerceOptionalNumber(padding.top),
118
- right: coerceOptionalNumber(padding.right),
119
- bottom: coerceOptionalNumber(padding.bottom),
120
- left: coerceOptionalNumber(padding.left),
121
- }
122
- : undefined;
123
-
124
- if (
125
- direction == null &&
126
- distribution == null &&
127
- crossAlignment == null &&
128
- coerceOptionalNumber(candidate.gap) == null &&
129
- normalizedPadding == null &&
130
- coerceOptionalNumber(candidate.columns) == null &&
131
- stackingOrder == null
132
- ) {
133
- return undefined;
134
- }
135
-
136
- return {
137
- direction,
138
- distribution,
139
- crossAlignment,
140
- gap: coerceOptionalNumber(candidate.gap),
141
- padding: normalizedPadding,
142
- columns: coerceOptionalNumber(candidate.columns),
143
- stackingOrder,
144
- };
145
- }
146
-
147
- function normalizeLayoutNode(
148
- raw: unknown,
149
- path: string,
150
- fallbackType: LayoutNodeType = "content"
151
- ): LayoutNode | null {
152
- if (!raw || typeof raw !== "object") return null;
153
- const candidate = raw as Record<string, unknown>;
154
- const boundingBox =
155
- candidate.boundingBox && typeof candidate.boundingBox === "object"
156
- ? (candidate.boundingBox as Record<string, unknown>)
157
- : null;
158
-
159
- if (!boundingBox) return null;
160
-
161
- const x = coerceOptionalNumber(boundingBox.x);
162
- const y = coerceOptionalNumber(boundingBox.y);
163
- const width = coerceOptionalNumber(boundingBox.width);
164
- const height = coerceOptionalNumber(boundingBox.height);
165
-
166
- if ([x, y, width, height].some((value) => value == null)) return null;
167
-
168
- const children = Array.isArray(candidate.children)
169
- ? candidate.children
170
- .map((child, index) => normalizeLayoutNode(child, `${path}.${index}`))
171
- .filter((child): child is LayoutNode => child !== null)
172
- : undefined;
173
-
174
- const normalizedChildCount = Math.max(
175
- 0,
176
- Math.round(
177
- coerceOptionalNumber(candidate.childCount) ??
178
- children?.length ??
179
- 0
180
- )
181
- );
182
-
183
- const alignedLeftWith = coerceStringArray((candidate.siblingHints as Record<string, unknown> | undefined)?.alignedLeftWith);
184
- const equalSpacingWith = coerceStringArray((candidate.siblingHints as Record<string, unknown> | undefined)?.equalSpacingWith);
185
- const repeatedChildren = coerceStringArray((candidate.siblingHints as Record<string, unknown> | undefined)?.repeatedChildren);
186
- const anchored =
187
- (candidate.siblingHints as Record<string, unknown> | undefined)?.anchored === "left" ||
188
- (candidate.siblingHints as Record<string, unknown> | undefined)?.anchored === "right" ||
189
- (candidate.siblingHints as Record<string, unknown> | undefined)?.anchored === "top" ||
190
- (candidate.siblingHints as Record<string, unknown> | undefined)?.anchored === "bottom" ||
191
- (candidate.siblingHints as Record<string, unknown> | undefined)?.anchored === "center"
192
- ? ((candidate.siblingHints as Record<string, unknown>).anchored as "left" | "right" | "top" | "bottom" | "center")
193
- : undefined;
194
-
195
- const repetitionCandidate =
196
- candidate.repetition && typeof candidate.repetition === "object"
197
- ? (candidate.repetition as Record<string, unknown>)
198
- : null;
199
-
200
- return {
201
- id: coerceOptionalString(candidate.id) ?? path,
202
- label: coerceOptionalString(candidate.label) ?? "Zone",
203
- boundingBox: { x: x!, y: y!, width: width!, height: height! },
204
- layoutType: normalizeLayoutType(candidate.layoutType ?? fallbackType),
205
- childCount: normalizedChildCount,
206
- children: children && children.length > 0 ? children : undefined,
207
- layout: normalizeLayoutAlignment(candidate.layout),
208
- siblingHints:
209
- alignedLeftWith || equalSpacingWith || repeatedChildren || anchored || candidate.overlay === true
210
- ? {
211
- alignedLeftWith,
212
- equalSpacingWith,
213
- repeatedChildren,
214
- anchored,
215
- overlay: candidate.overlay === true || (candidate.siblingHints as Record<string, unknown> | undefined)?.overlay === true,
216
- }
217
- : undefined,
218
- repetition:
219
- repetitionCandidate && repetitionCandidate.isRepeated === true
220
- ? {
221
- isRepeated: true,
222
- pattern:
223
- repetitionCandidate.pattern === "row" ||
224
- repetitionCandidate.pattern === "column" ||
225
- repetitionCandidate.pattern === "grid" ||
226
- repetitionCandidate.pattern === "tabs" ||
227
- repetitionCandidate.pattern === "menu" ||
228
- repetitionCandidate.pattern === "list"
229
- ? repetitionCandidate.pattern
230
- : undefined,
231
- itemCount: coerceOptionalNumber(repetitionCandidate.itemCount),
232
- canonicalChildId: coerceOptionalString(repetitionCandidate.canonicalChildId),
233
- repeatedChildIds: coerceStringArray(repetitionCandidate.repeatedChildIds),
234
- repeatAxis:
235
- repetitionCandidate.repeatAxis === "horizontal" || repetitionCandidate.repeatAxis === "vertical"
236
- ? repetitionCandidate.repeatAxis
237
- : undefined,
238
- }
239
- : undefined,
240
- zoneImage: coerceOptionalString(candidate.zoneImage),
241
- };
242
- }
243
-
244
- function inferDirectionFromChildren(children: LayoutNode[]): "horizontal" | "vertical" | "none" {
245
- if (children.length < 2) return "none";
246
-
247
- const xSpread =
248
- Math.max(...children.map((child) => child.boundingBox.x + child.boundingBox.width / 2)) -
249
- Math.min(...children.map((child) => child.boundingBox.x + child.boundingBox.width / 2));
250
- const ySpread =
251
- Math.max(...children.map((child) => child.boundingBox.y + child.boundingBox.height / 2)) -
252
- Math.min(...children.map((child) => child.boundingBox.y + child.boundingBox.height / 2));
253
-
254
- return xSpread > ySpread ? "horizontal" : "vertical";
255
- }
256
-
257
- function enrichRepeatedPatterns(nodes: LayoutNode[]): LayoutNode[] {
258
- return nodes.map((node) => {
259
- const children = node.children ? enrichRepeatedPatterns(node.children) : undefined;
260
- const nextNode: LayoutNode = { ...node, children };
261
-
262
- if (!children || children.length < 2 || nextNode.repetition?.isRepeated) {
263
- return nextNode;
264
- }
265
-
266
- const repeated = children.filter((child) => child.layoutType === children[0].layoutType);
267
- const aligned =
268
- repeated.length >= 2 &&
269
- repeated.every((child) => {
270
- const widthDelta = Math.abs(child.boundingBox.width - repeated[0].boundingBox.width);
271
- const heightDelta = Math.abs(child.boundingBox.height - repeated[0].boundingBox.height);
272
- return widthDelta <= 6 || heightDelta <= 6;
273
- });
274
-
275
- if (!aligned) return nextNode;
276
-
277
- const repeatAxis =
278
- nextNode.layout?.direction && nextNode.layout.direction !== "none"
279
- ? nextNode.layout.direction
280
- : inferDirectionFromChildren(children);
281
-
282
- const pattern =
283
- repeated[0].layoutType === "table-row"
284
- ? "row"
285
- : repeated[0].layoutType === "tab-bar"
286
- ? "tabs"
287
- : repeated[0].layoutType === "list-item"
288
- ? "list"
289
- : repeatAxis === "horizontal"
290
- ? "row"
291
- : "list";
292
-
293
- nextNode.repetition = {
294
- isRepeated: true,
295
- pattern,
296
- itemCount: repeated.length,
297
- canonicalChildId: repeated[0].id,
298
- repeatedChildIds: repeated.map((child) => child.id),
299
- repeatAxis: repeatAxis === "none" ? "vertical" : repeatAxis,
300
- };
301
-
302
- return nextNode;
303
- });
304
- }
305
-
306
- function normalizeManifest(raw: unknown): ComponentManifest {
307
- if (!raw || typeof raw !== "object") return { ...DEFAULT_MANIFEST };
308
-
309
- const candidate = raw as Record<string, unknown>;
310
- const iconPresent = Boolean(candidate.iconPresent ?? candidate.iconName);
311
- const normalized: ComponentManifest = {
312
- componentType: coerceOptionalString(candidate.componentType) ?? DEFAULT_MANIFEST.componentType,
313
- variants:
314
- candidate.variants && typeof candidate.variants === "object"
315
- ? Object.fromEntries(
316
- Object.entries(candidate.variants as Record<string, unknown>).filter(
317
- (entry): entry is [string, string] => typeof entry[1] === "string"
318
- )
319
- )
320
- : {},
321
- textContent: coerceOptionalString(candidate.textContent),
322
- textContentConfidence: coerceOptionalConfidence(candidate.textContentConfidence),
323
- iconPresent,
324
- iconName: coerceOptionalString(candidate.iconName),
325
- iconNameConfidence: coerceOptionalConfidence(candidate.iconNameConfidence),
326
- iconKind:
327
- candidate.iconKind === "system" ||
328
- candidate.iconKind === "brand" ||
329
- candidate.iconKind === "illustration" ||
330
- candidate.iconKind === "unknown"
331
- ? candidate.iconKind
332
- : "unknown",
333
- preferredIconLibrary: coerceOptionalString(candidate.preferredIconLibrary),
334
- openSourceIconName: coerceOptionalString(candidate.openSourceIconName),
335
- interactiveElement: Boolean(candidate.interactiveElement),
336
- estimatedSpacing: coerceOptionalNumber(candidate.estimatedSpacing) ?? DEFAULT_MANIFEST.estimatedSpacing,
337
- estimatedSpacingConfidence: coerceOptionalConfidence(candidate.estimatedSpacingConfidence),
338
- estimatedRadius: coerceOptionalNumber(candidate.estimatedRadius),
339
- estimatedRadiusConfidence: coerceOptionalConfidence(candidate.estimatedRadiusConfidence),
340
- estimatedFontSize: coerceOptionalNumber(candidate.estimatedFontSize),
341
- estimatedFontSizeConfidence: coerceOptionalConfidence(candidate.estimatedFontSizeConfidence),
342
- fontFamilyGuess: coerceOptionalString(candidate.fontFamilyGuess),
343
- fontFamilyGuessConfidence: coerceOptionalConfidence(candidate.fontFamilyGuessConfidence),
344
- fontStyleGuess: coerceOptionalString(candidate.fontStyleGuess),
345
- fontStyleGuessConfidence: coerceOptionalConfidence(candidate.fontStyleGuessConfidence),
346
- fontWeightGuess: coerceOptionalNumber(candidate.fontWeightGuess),
347
- fontWeightGuessConfidence: coerceOptionalConfidence(candidate.fontWeightGuessConfidence),
348
- confidence: clampConfidence(candidate.confidence, DEFAULT_MANIFEST.confidence),
349
- dsBestMatch: coerceOptionalString(candidate.dsBestMatch),
350
- dsNodeId: coerceOptionalString(candidate.dsNodeId),
351
- };
352
-
353
- if (!normalized.iconPresent) {
354
- normalized.iconName = undefined;
355
- normalized.iconNameConfidence = undefined;
356
- }
357
-
358
- return normalized;
359
- }
360
-
361
- function normalizeZones(raw: unknown): LayoutZone[] | undefined {
362
- if (!Array.isArray(raw)) return undefined;
363
-
364
- const zones = raw
365
- .map((zone, index) => normalizeLayoutNode(zone, `zone-${index}`))
366
- .filter((zone): zone is LayoutZone => zone !== null);
367
-
368
- return zones.length > 0 ? enrichRepeatedPatterns(zones) : undefined;
369
- }
370
-
371
- function normalizeVisionResult(raw: unknown): VisionResult {
372
- const candidate = raw && typeof raw === "object" ? (raw as Record<string, unknown>) : {};
373
- const layoutTree = normalizeZones(candidate.layoutTree ?? candidate.zones);
374
- return {
375
- rawAnalysis:
376
- typeof candidate.rawAnalysis === "string" && candidate.rawAnalysis.trim()
377
- ? candidate.rawAnalysis
378
- : "[Vision analysis unavailable]",
379
- confidence: clampConfidence(candidate.confidence, 0.5),
380
- layoutTree,
381
- zones: layoutTree,
382
- manifest: candidate.manifest ? normalizeManifest(candidate.manifest) : undefined,
383
- };
384
- }
385
-
386
- /**
387
- * VisionClient — local heuristic image analysis utility.
388
- *
389
- * No external API key required. Returns reasonable defaults.
390
- * The MCP client AI provides actual vision intelligence by
391
- * seeing images returned in tool responses.
392
- */
393
- export class VisionClient {
394
- private readonly providerName: string;
395
- private readonly openaiProvider: OpenAIVisionProvider;
396
- private readonly anthropicProvider: AnthropicVisionProvider;
397
-
398
- constructor() {
399
- const explicit = (process.env.VISION_PROVIDER || "").toLowerCase();
400
- // Auto-detect a real vision provider when none is explicitly configured.
401
- // Priority: explicit env → anthropic (if API key present) → openai (if API key present) → offline
402
- if (explicit) {
403
- this.providerName = explicit;
404
- } else if (process.env.ANTHROPIC_API_KEY) {
405
- this.providerName = "anthropic";
406
- } else if (process.env.OPENAI_API_KEY) {
407
- this.providerName = "openai";
408
- } else {
409
- this.providerName = "offline";
410
- }
411
- this.openaiProvider = new OpenAIVisionProvider();
412
- this.anthropicProvider = new AnthropicVisionProvider();
413
- }
414
-
415
- private isOfflineProvider(): boolean {
416
- return (
417
- this.providerName === "offline" ||
418
- this.providerName === "local" ||
419
- this.providerName === "heuristic" ||
420
- this.providerName === "none"
421
- );
422
- }
423
-
424
- async analyze(image: string, prompt: string): Promise<VisionResult> {
425
- if (this.providerName === "openai") {
426
- const result = await this.openaiProvider.analyze(image, prompt);
427
- return normalizeVisionResult(result);
428
- }
429
-
430
- if (this.providerName === "anthropic") {
431
- const result = await this.anthropicProvider.analyze(image, prompt);
432
- return normalizeVisionResult(result);
433
- }
434
-
435
- if (this.isOfflineProvider()) {
436
- return {
437
- rawAnalysis:
438
- "[Offline heuristic analysis] Remote vision is disabled, so the cloner is using a local fallback summary.",
439
- confidence: 0.25,
440
- };
441
- }
442
-
443
- return {
444
- rawAnalysis: `[Vision provider "${this.providerName}" is not supported]`,
445
- confidence: 0,
446
- };
447
- }
448
-
449
- async segment(_image: string): Promise<LayoutNode[]> {
450
- const prompt = `Identify the UI layout as a nested hierarchy, not a flat zone list. Return strict JSON with:
451
- - rawAnalysis: short machine-readable summary string
452
- - confidence: overall confidence from 0 to 1
453
- - layoutTree: array of root layout nodes
454
- - each layout node must include:
455
- - id: stable node id string
456
- - label: descriptive name of the region
457
- - boundingBox: {x, y, width, height} as percentages (0-100) of total image size
458
- - layoutType: one of "page"|"sidebar"|"header"|"toolbar"|"content"|"footer"|"drawer"|"modal"|"card"|"form"|"form-row"|"nav"|"button-group"|"tab-bar"|"table"|"table-row"|"list"|"list-item"|"section"|"overlay"
459
- - childCount: estimated number of direct child elements
460
- - children: nested layout nodes
461
- - layout: { direction, distribution, crossAlignment, gap, padding, columns, stackingOrder }
462
- - siblingHints: { alignedLeftWith, equalSpacingWith, repeatedChildren, anchored, overlay }
463
- - repetition: { isRepeated, pattern, itemCount, canonicalChildId, repeatedChildIds, repeatAxis } when a repeated row/list/tab/menu structure exists
464
-
465
- Prefer a single "page" root when the whole screen is one page. Include repeated row/list hints whenever items visually repeat. Only use overlays for floating drawers, modals, popovers, badges, or absolute-positioned elements.
466
-
467
- Return ONLY valid JSON.`;
468
-
469
- if (this.providerName === "openai") {
470
- const result = await this.openaiProvider.segment(_image, prompt);
471
- return normalizeVisionResult(result).layoutTree ?? [];
472
- }
473
-
474
- if (this.providerName === "anthropic") {
475
- const result = await this.anthropicProvider.segment(_image, prompt);
476
- return normalizeVisionResult(result).layoutTree ?? [];
477
- }
478
-
479
- if (this.isOfflineProvider()) {
480
- return [
481
- {
482
- id: "page-root",
483
- label: "Page",
484
- boundingBox: { x: 0, y: 0, width: 100, height: 100 },
485
- layoutType: "page",
486
- childCount: 0,
487
- layout: {
488
- direction: "vertical",
489
- distribution: "start",
490
- crossAlignment: "stretch",
491
- gap: 0,
492
- padding: { top: 0, right: 0, bottom: 0, left: 0 },
493
- stackingOrder: "normal",
494
- },
495
- },
496
- ];
497
- }
498
-
499
- return [];
500
- }
501
-
502
- async identify(zoneImage: string): Promise<ComponentManifest> {
503
- const prompt = `Analyze this UI region and identify the component. Return JSON with:
504
- - componentType: specific UI component name (e.g. "PrimaryButton", "TextInput", "NavigationBar")
505
- - variants: object of detected variants {size, state, theme, type}
506
- - textContent: visible text content (null if none)
507
- - iconPresent: boolean
508
- - iconName: best guess for the icon or logo name (null if none)
509
- - iconKind: "system" | "brand" | "illustration" | "unknown"
510
- - preferredIconLibrary: best open-source icon family for this region, prefer "material-symbols" for common UI icons and "simple-icons" for brands
511
- - openSourceIconName: exact open-source icon slug if recognizable (examples: "menu", "search", "close", "shopping_cart")
512
- - interactiveElement: boolean (is this clickable/focusable?)
513
- - estimatedSpacing: measured padding/gap in pixels, prefer exact visual estimate over assumptions
514
- - estimatedRadius: border radius in pixels if visible
515
- - estimatedFontSize: visible text size in pixels if text is present
516
- - fontFamilyGuess: closest visible font family name if text is present
517
- - fontStyleGuess: closest visible font style name if text is present
518
- - fontWeightGuess: closest visible font weight number if text is present
519
- - confidence: 0-1 how confident you are in this identification
520
-
521
- Return ONLY valid JSON.`;
522
-
523
- if (this.providerName === "openai") {
524
- const result = await this.openaiProvider.identify(zoneImage, prompt);
525
- return normalizeVisionResult(result).manifest ?? { ...DEFAULT_MANIFEST };
526
- }
527
-
528
- if (this.providerName === "anthropic") {
529
- const result = await this.anthropicProvider.identify(zoneImage, prompt);
530
- return normalizeVisionResult(result).manifest ?? { ...DEFAULT_MANIFEST };
531
- }
532
-
533
- if (this.isOfflineProvider()) {
534
- return {
535
- ...DEFAULT_MANIFEST,
536
- componentType: "ScreenshotRegion",
537
- interactiveElement: false,
538
- estimatedSpacing: 0,
539
- confidence: 0.2,
540
- };
541
- }
542
-
543
- return { ...DEFAULT_MANIFEST };
544
- }
545
-
546
- async describeComponent(image: string): Promise<string> {
547
- const prompt = `Describe this UI component in one concise sentence focusing on its purpose, visual style, and key properties. Be specific about size, color, state, and interactive behavior.`;
548
- const result = await this.analyze(image, prompt);
549
- return result.rawAnalysis;
550
- }
551
-
552
- async auditVisualQuality(
553
- image: string,
554
- areas: string[]
555
- ): Promise<Record<string, unknown>> {
556
- const prompt = `Perform a professional UX quality audit of this UI screenshot. Analyze: ${areas.join(", ")}.
557
-
558
- Return JSON with:
559
- {
560
- "hierarchyScore": 0-100,
561
- "cognitiveLoadRating": "low"|"medium"|"high",
562
- "brandAlignmentNotes": "...",
563
- "consistencyIssues": ["..."],
564
- "overallScore": 0-100,
565
- "topIssues": [{"severity":"error"|"warning"|"suggestion","description":"...","area":"..."}],
566
- "estimatedFixTimeMinutes": N
567
- }
568
-
569
- Return ONLY valid JSON.`;
570
-
571
- const result = await this.analyze(image, prompt);
572
- try {
573
- const jsonMatch = result.rawAnalysis.match(/```json\n?([\s\S]*?)\n?```/);
574
- if (jsonMatch) return JSON.parse(jsonMatch[1]);
575
- return JSON.parse(result.rawAnalysis);
576
- } catch {
577
- return { rawAnalysis: result.rawAnalysis };
578
- }
579
- }
580
-
581
- async interpretSketch(
582
- _image: string,
583
- _productContext: string
584
- ): Promise<LayoutZone[]> {
585
- return [
586
- { id: "sketch-header", label: "Top Section", boundingBox: { x: 0, y: 0, width: 100, height: 20 }, layoutType: "header", childCount: 2 },
587
- { id: "sketch-content", label: "Content Area", boundingBox: { x: 0, y: 20, width: 100, height: 60 }, layoutType: "content", childCount: 4 },
588
- { id: "sketch-footer", label: "Action Area", boundingBox: { x: 0, y: 80, width: 100, height: 20 }, layoutType: "footer", childCount: 2 },
589
- ];
590
- }
591
-
592
- async extractDesignLanguage(
593
- _references: string[],
594
- _extractTypes: string[]
595
- ): Promise<Record<string, unknown>> {
596
- return {
597
- layout: { gridStructure: "12-column", zoneProportions: "balanced", hierarchy: "standard" },
598
- spacing: { density: "comfortable", paddingPattern: "16px", dominantGap: 16 },
599
- colorPalette: [
600
- { role: "primary", hex: "#2563EB", frequency: "dominant" },
601
- { role: "surface", hex: "#FFFFFF", frequency: "dominant" },
602
- { role: "text", hex: "#1E293B", frequency: "dominant" },
603
- ],
604
- typography: { scalePattern: "modular", dominantWeights: [400, 600], hierarchyLevels: 3 },
605
- };
606
- }
607
- }