@sarjallab09/figma-intelligence 1.0.1 → 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.
- package/README.md +67 -36
- package/dist/bin/cli.js +2 -0
- package/dist/design-bridge/bridge.js +2 -0
- package/dist/figma-bridge-plugin/bridge-relay.js +2 -0
- package/dist/figma-bridge-plugin/code.js +1 -0
- package/{figma-bridge-plugin → dist/figma-bridge-plugin}/package-lock.json +0 -3
- package/dist/figma-bridge-plugin/ui.html +4970 -0
- package/dist/figma-intelligence-layer/dist/index.js +2 -0
- package/dist/scripts/clean-existing-chunks.js +2 -0
- package/dist/scripts/connect-ai-tool.js +2 -0
- package/dist/scripts/convert-hub-pdfs.js +2 -0
- package/dist/scripts/figma-mcp-status.js +2 -0
- package/dist/scripts/register-codex-mcp.js +2 -0
- package/dist/scripts/test-copilot-chat.js +2 -0
- package/package.json +11 -8
- package/bin/cli.js +0 -859
- package/design-bridge/bridge.js +0 -196
- package/design-bridge/lib/assets.js +0 -367
- package/design-bridge/lib/prompt.js +0 -85
- package/design-bridge/lib/server.js +0 -66
- package/design-bridge/lib/stitch.js +0 -37
- package/design-bridge/lib/tokens.js +0 -82
- package/design-bridge/package-lock.json +0 -579
- package/figma-bridge-plugin/README.md +0 -97
- package/figma-bridge-plugin/anthropic-chat-runner.js +0 -192
- package/figma-bridge-plugin/bridge-relay.js +0 -2363
- package/figma-bridge-plugin/chat-runner.js +0 -459
- package/figma-bridge-plugin/code.js +0 -1528
- package/figma-bridge-plugin/codex-runner.js +0 -505
- package/figma-bridge-plugin/component-schemas.js +0 -110
- package/figma-bridge-plugin/content-context.js +0 -869
- package/figma-bridge-plugin/create-button.js +0 -216
- package/figma-bridge-plugin/gemini-cli-runner.js +0 -291
- package/figma-bridge-plugin/gemini-runner.js +0 -187
- package/figma-bridge-plugin/html-to-figma.js +0 -927
- package/figma-bridge-plugin/knowledge-hub/.gitkeep +0 -0
- package/figma-bridge-plugin/knowledge-hub/uspec-references/anatomy-spec.md +0 -159
- package/figma-bridge-plugin/knowledge-hub/uspec-references/api-spec.md +0 -162
- package/figma-bridge-plugin/knowledge-hub/uspec-references/color-spec.md +0 -148
- package/figma-bridge-plugin/knowledge-hub/uspec-references/full-spec-template.md +0 -314
- package/figma-bridge-plugin/knowledge-hub/uspec-references/property-spec.md +0 -175
- package/figma-bridge-plugin/knowledge-hub/uspec-references/screen-reader-spec.md +0 -180
- package/figma-bridge-plugin/knowledge-hub/uspec-references/structure-spec.md +0 -165
- package/figma-bridge-plugin/perplexity-runner.js +0 -188
- package/figma-bridge-plugin/references/SKILL.md +0 -178
- package/figma-bridge-plugin/references/anatomy-spec.md +0 -159
- package/figma-bridge-plugin/references/api-spec.md +0 -162
- package/figma-bridge-plugin/references/color-spec.md +0 -148
- package/figma-bridge-plugin/references/full-spec-template.md +0 -314
- package/figma-bridge-plugin/references/property-spec.md +0 -175
- package/figma-bridge-plugin/references/screen-reader-spec.md +0 -180
- package/figma-bridge-plugin/references/structure-spec.md +0 -165
- package/figma-bridge-plugin/shared-prompt-config.js +0 -604
- package/figma-bridge-plugin/spec-helpers/build-table.js +0 -269
- package/figma-bridge-plugin/spec-helpers/classify-elements.js +0 -189
- package/figma-bridge-plugin/spec-helpers/index.js +0 -35
- package/figma-bridge-plugin/spec-helpers/parse-figma-link.js +0 -49
- package/figma-bridge-plugin/spec-helpers/position-markers.js +0 -158
- package/figma-bridge-plugin/stitch-auth.js +0 -322
- package/figma-bridge-plugin/stitch-runner.js +0 -1427
- package/figma-bridge-plugin/token-resolver.js +0 -107
- package/figma-bridge-plugin/ui.html +0 -4467
- package/figma-intelligence-layer/.env.example +0 -39
- package/figma-intelligence-layer/docs/local-image-generation.md +0 -60
- package/figma-intelligence-layer/examples/comfyui-workflow-template.example.json +0 -101
- package/figma-intelligence-layer/jest.config.js +0 -14
- package/figma-intelligence-layer/mcp-config.json +0 -19
- package/figma-intelligence-layer/package-lock.json +0 -5892
- package/figma-intelligence-layer/scripts/setup-comfyui-local.sh +0 -67
- package/figma-intelligence-layer/scripts/start-comfyui.sh +0 -33
- package/figma-intelligence-layer/src/index.ts +0 -2233
- package/figma-intelligence-layer/src/shared/auto-layout-validator.ts +0 -404
- package/figma-intelligence-layer/src/shared/cache.ts +0 -187
- package/figma-intelligence-layer/src/shared/color-operations.ts +0 -533
- package/figma-intelligence-layer/src/shared/color-utils.ts +0 -138
- package/figma-intelligence-layer/src/shared/component-script-builder.ts +0 -413
- package/figma-intelligence-layer/src/shared/component-templates.ts +0 -2767
- package/figma-intelligence-layer/src/shared/concept-taxonomy.ts +0 -694
- package/figma-intelligence-layer/src/shared/decision-log.ts +0 -128
- package/figma-intelligence-layer/src/shared/design-system-context.ts +0 -568
- package/figma-intelligence-layer/src/shared/design-system-intelligence.ts +0 -131
- package/figma-intelligence-layer/src/shared/design-system-matcher.ts +0 -184
- package/figma-intelligence-layer/src/shared/design-system-normalizers.ts +0 -196
- package/figma-intelligence-layer/src/shared/design-system-tokens.ts +0 -295
- package/figma-intelligence-layer/src/shared/dtcg-validator.ts +0 -530
- package/figma-intelligence-layer/src/shared/enrichment-pipeline.ts +0 -671
- package/figma-intelligence-layer/src/shared/figma-bridge.ts +0 -1408
- package/figma-intelligence-layer/src/shared/font-config.ts +0 -126
- package/figma-intelligence-layer/src/shared/icon-catalog.ts +0 -360
- package/figma-intelligence-layer/src/shared/icon-fetch.ts +0 -80
- package/figma-intelligence-layer/src/shared/prototype-script-builder.ts +0 -162
- package/figma-intelligence-layer/src/shared/response-compression.ts +0 -440
- package/figma-intelligence-layer/src/shared/semantic-token-catalog.ts +0 -324
- package/figma-intelligence-layer/src/shared/token-binder.ts +0 -505
- package/figma-intelligence-layer/src/shared/token-math.ts +0 -427
- package/figma-intelligence-layer/src/shared/token-naming.ts +0 -468
- package/figma-intelligence-layer/src/shared/token-utils.ts +0 -420
- package/figma-intelligence-layer/src/shared/types.ts +0 -346
- package/figma-intelligence-layer/src/shared/typography-presets.ts +0 -94
- package/figma-intelligence-layer/src/shared/unsplash.ts +0 -165
- package/figma-intelligence-layer/src/shared/vision-client.ts +0 -607
- package/figma-intelligence-layer/src/shared/vision-provider-anthropic.ts +0 -334
- package/figma-intelligence-layer/src/shared/vision-provider-openai.ts +0 -446
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/a11y-annotate-handler.ts +0 -782
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/a11y-annotate-renderer.ts +0 -496
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/a11y-annotation-kit.ts +0 -230
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/colorblind-sim.ts +0 -66
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/index.ts +0 -810
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/keyboard-sr-order-analyzer.ts +0 -1191
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/keyboard-sr-order-figma-page.ts +0 -1346
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/keyboard-sr-order-handler.ts +0 -148
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/vpat-figma-page.ts +0 -499
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/vpat-report.ts +0 -910
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/wcag-checker.ts +0 -989
- package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/wcag-criteria.ts +0 -1160
- package/figma-intelligence-layer/src/tools/phase1-vision/design-from-ref/index.ts +0 -424
- package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/component-recognizer.ts +0 -38
- package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/ds-matcher.ts +0 -111
- package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/font-matcher.ts +0 -114
- package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/icon-resolver.ts +0 -103
- package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/index.ts +0 -1060
- package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/layout-segmenter.ts +0 -18
- package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/token-inferencer.ts +0 -39
- package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/vision-pipeline.ts +0 -58
- package/figma-intelligence-layer/src/tools/phase1-vision/sketch-to-design/index.ts +0 -298
- package/figma-intelligence-layer/src/tools/phase1-vision/visual-audit/index.ts +0 -197
- package/figma-intelligence-layer/src/tools/phase2-accuracy/component-audit/index.ts +0 -494
- package/figma-intelligence-layer/src/tools/phase2-accuracy/intent-translator/index.ts +0 -356
- package/figma-intelligence-layer/src/tools/phase2-accuracy/layout-intelligence/container-patterns.ts +0 -123
- package/figma-intelligence-layer/src/tools/phase2-accuracy/layout-intelligence/index.ts +0 -663
- package/figma-intelligence-layer/src/tools/phase2-accuracy/lint-rules/built-in-rules.yaml +0 -56
- package/figma-intelligence-layer/src/tools/phase2-accuracy/lint-rules/index.ts +0 -614
- package/figma-intelligence-layer/src/tools/phase2-accuracy/lint-rules/rule-engine.ts +0 -113
- package/figma-intelligence-layer/src/tools/phase2-accuracy/theme-generator/color-theory.ts +0 -178
- package/figma-intelligence-layer/src/tools/phase2-accuracy/theme-generator/index.ts +0 -470
- package/figma-intelligence-layer/src/tools/phase2-accuracy/variant-expander/index.ts +0 -429
- package/figma-intelligence-layer/src/tools/phase2-accuracy/variant-expander/token-override-maps.ts +0 -226
- package/figma-intelligence-layer/src/tools/phase3-generation/ai-image-insert/index.ts +0 -535
- package/figma-intelligence-layer/src/tools/phase3-generation/component-archaeologist/index.ts +0 -660
- package/figma-intelligence-layer/src/tools/phase3-generation/component-archaeologist/pattern-fingerprints.ts +0 -209
- package/figma-intelligence-layer/src/tools/phase3-generation/composition-builder/index.ts +0 -540
- package/figma-intelligence-layer/src/tools/phase3-generation/figma-animated-build.ts +0 -391
- package/figma-intelligence-layer/src/tools/phase3-generation/page-architect/index.ts +0 -2019
- package/figma-intelligence-layer/src/tools/phase3-generation/page-architect/screen-templates.ts +0 -131
- package/figma-intelligence-layer/src/tools/phase3-generation/prototype-map/index.ts +0 -381
- package/figma-intelligence-layer/src/tools/phase3-generation/prototype-wire/index.ts +0 -565
- package/figma-intelligence-layer/src/tools/phase3-generation/swarm-build/index.ts +0 -764
- package/figma-intelligence-layer/src/tools/phase3-generation/system-drift/index.ts +0 -535
- package/figma-intelligence-layer/src/tools/phase3-generation/unsplash-search/index.ts +0 -84
- package/figma-intelligence-layer/src/tools/phase3-generation/url-to-frame/index.ts +0 -401
- package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/code-generators/css-animations.ts +0 -68
- package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/code-generators/framer-motion.ts +0 -78
- package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/code-generators/swift-animations.ts +0 -93
- package/figma-intelligence-layer/src/tools/phase4-sync/animation-specifier/index.ts +0 -596
- package/figma-intelligence-layer/src/tools/phase4-sync/ci-check/index.ts +0 -462
- package/figma-intelligence-layer/src/tools/phase4-sync/export-tokens/index.ts +0 -1470
- package/figma-intelligence-layer/src/tools/phase4-sync/generate-component-code/index.ts +0 -829
- package/figma-intelligence-layer/src/tools/phase4-sync/handoff-spec/index.ts +0 -702
- package/figma-intelligence-layer/src/tools/phase4-sync/icon-library-sync/index.ts +0 -483
- package/figma-intelligence-layer/src/tools/phase4-sync/sync-from-code/index.ts +0 -501
- package/figma-intelligence-layer/src/tools/phase4-sync/sync-from-code/storybook-parser.ts +0 -106
- package/figma-intelligence-layer/src/tools/phase4-sync/watch-docs/index.ts +0 -676
- package/figma-intelligence-layer/src/tools/phase4-sync/webhook-listener/index.ts +0 -560
- package/figma-intelligence-layer/src/tools/phase5-governance/apg-doc/index.ts +0 -1043
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/component-detection.ts +0 -620
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/anatomy.ts +0 -331
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/color-tokens.ts +0 -77
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/properties.ts +0 -54
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/snapshot.ts +0 -287
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/spacing.ts +0 -71
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/states.ts +0 -43
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/extractors/typography.ts +0 -71
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/index.ts +0 -221
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/_default.ts +0 -166
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/accordion.ts +0 -232
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/alert.ts +0 -234
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/avatar-group.ts +0 -270
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/avatar.ts +0 -249
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/badge.ts +0 -231
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/banner.ts +0 -293
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/breadcrumb.ts +0 -240
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/button.ts +0 -243
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/calendar.ts +0 -307
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/card.ts +0 -143
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/checkbox.ts +0 -227
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/chip.ts +0 -233
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/combobox.ts +0 -282
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/datepicker.ts +0 -276
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/divider.ts +0 -223
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/drawer.ts +0 -255
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/dropdown-menu.ts +0 -289
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/empty-state.ts +0 -261
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/file-uploader.ts +0 -290
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/form.ts +0 -265
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/grid.ts +0 -238
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/icon.ts +0 -255
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/index.ts +0 -128
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/inline-edit.ts +0 -286
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/inline-message.ts +0 -255
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/input.ts +0 -330
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/link.ts +0 -247
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/list.ts +0 -250
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/menu.ts +0 -247
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/modal.ts +0 -144
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/navbar.ts +0 -264
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/navigation.ts +0 -251
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/number-input.ts +0 -261
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/pagination.ts +0 -248
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/popover.ts +0 -270
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/progress.ts +0 -251
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/radio.ts +0 -142
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/range-slider.ts +0 -282
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/rating.ts +0 -250
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/search.ts +0 -258
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/segmented-control.ts +0 -265
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/select.ts +0 -319
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/skeleton.ts +0 -256
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/slider.ts +0 -232
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/spinner.ts +0 -239
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/status-dot.ts +0 -252
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/stepper.ts +0 -270
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/table.ts +0 -244
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/tabs.ts +0 -143
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/tag.ts +0 -243
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/textarea.ts +0 -259
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/time-picker.ts +0 -293
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/toast.ts +0 -144
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/toggle.ts +0 -289
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/toolbar.ts +0 -267
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/tooltip.ts +0 -232
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/treeview.ts +0 -257
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/knowledge/typography.ts +0 -319
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/legacy-compat.ts +0 -121
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/anatomy-diagram.ts +0 -430
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/figma-page.ts +0 -312
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/json.ts +0 -129
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/markdown.ts +0 -78
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/renderers/visual-doc.ts +0 -2333
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/accessibility.ts +0 -100
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/anatomy.ts +0 -32
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/color-tokens.ts +0 -59
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/content-guidance.ts +0 -18
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/design-tokens.ts +0 -53
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/interaction-rules.ts +0 -19
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/overview.ts +0 -91
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/properties-api.ts +0 -71
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/qa-criteria.ts +0 -19
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/related-components.ts +0 -110
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/responsive.ts +0 -19
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/size-specs.ts +0 -67
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/spacing-structure.ts +0 -58
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/state-specs.ts +0 -79
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/states.ts +0 -50
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/type-hierarchy.ts +0 -33
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/typography.ts +0 -55
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/usage-guidelines.ts +0 -73
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/sections/variants.ts +0 -81
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec/types.ts +0 -409
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec-sheet/index.ts +0 -198
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec-sheet/renderer.ts +0 -701
- package/figma-intelligence-layer/src/tools/phase5-governance/component-spec-sheet/types.ts +0 -88
- package/figma-intelligence-layer/src/tools/phase5-governance/decision-log/index.ts +0 -135
- package/figma-intelligence-layer/src/tools/phase5-governance/design-decision-log/index.ts +0 -491
- package/figma-intelligence-layer/src/tools/phase5-governance/ds-primitives/index.ts +0 -416
- package/figma-intelligence-layer/src/tools/phase5-governance/ds-scaffolder/index.ts +0 -722
- package/figma-intelligence-layer/src/tools/phase5-governance/ds-variables/index.ts +0 -449
- package/figma-intelligence-layer/src/tools/phase5-governance/health-report/index.ts +0 -393
- package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/index.ts +0 -406
- package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/figma-page.ts +0 -292
- package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/json.ts +0 -24
- package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/markdown.ts +0 -172
- package/figma-intelligence-layer/src/tools/phase5-governance/taxonomy-docs/renderers/naming-guide.ts +0 -409
- package/figma-intelligence-layer/src/tools/phase5-governance/token-analytics/index.ts +0 -594
- package/figma-intelligence-layer/src/tools/phase5-governance/token-docs/index.ts +0 -710
- package/figma-intelligence-layer/src/tools/phase5-governance/token-migrate/index.ts +0 -458
- package/figma-intelligence-layer/src/tools/phase5-governance/token-naming/index.ts +0 -134
- package/figma-intelligence-layer/tests/apg-doc.test.ts +0 -101
- package/figma-intelligence-layer/tests/design-system-context.test.ts +0 -152
- package/figma-intelligence-layer/tests/design-system-matcher.test.ts +0 -144
- package/figma-intelligence-layer/tests/figma-bridge.test.ts +0 -83
- package/figma-intelligence-layer/tests/generate-image-and-insert.test.ts +0 -56
- package/figma-intelligence-layer/tests/screen-cloner-regression.test.ts +0 -69
- package/figma-intelligence-layer/tests/smoke.test.ts +0 -174
- package/figma-intelligence-layer/tests/spec-generator.test.ts +0 -127
- package/figma-intelligence-layer/tests/token-migrate.test.ts +0 -21
- package/figma-intelligence-layer/tests/token-naming.test.ts +0 -30
- package/figma-intelligence-layer/tsconfig.json +0 -19
- package/scripts/clean-existing-chunks.js +0 -179
- package/scripts/connect-ai-tool.js +0 -490
- package/scripts/convert-hub-pdfs.js +0 -425
- package/scripts/figma-mcp-status.js +0 -349
- package/scripts/register-codex-mcp.js +0 -96
- /package/{design-bridge → dist/design-bridge}/.env.example +0 -0
- /package/{design-bridge → dist/design-bridge}/package.json +0 -0
- /package/{figma-bridge-plugin → dist/figma-bridge-plugin}/manifest.json +0 -0
- /package/{figma-bridge-plugin → dist/figma-bridge-plugin}/package.json +0 -0
- /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
|
-
}
|