@sarjallab09/figma-intelligence 1.1.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 -2505
- package/figma-bridge-plugin/chat-runner.js +0 -485
- package/figma-bridge-plugin/code.js +0 -1534
- 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 -645
- 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 -4542
- 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 -1418
- 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,424 +0,0 @@
|
|
|
1
|
-
import fs from "fs/promises";
|
|
2
|
-
import { VisionClient } from "../../../shared/vision-client.js";
|
|
3
|
-
import { getBridge } from "../../../shared/figma-bridge.js";
|
|
4
|
-
import { decisionLog } from "../../../shared/decision-log.js";
|
|
5
|
-
import { Token } from "../../../shared/types.js";
|
|
6
|
-
import { snapToColorToken, snapToSpacingToken } from "../../../shared/token-utils.js";
|
|
7
|
-
|
|
8
|
-
// ─────────────────────────────────────────────────────────────────────────────
|
|
9
|
-
// Types
|
|
10
|
-
// ─────────────────────────────────────────────────────────────────────────────
|
|
11
|
-
|
|
12
|
-
export interface DesignFromRefArgs {
|
|
13
|
-
references: string[];
|
|
14
|
-
prompt: string;
|
|
15
|
-
extractOnly?: string[];
|
|
16
|
-
designSystemContext?: string;
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
export interface DesignFromRefResult {
|
|
20
|
-
frameId: string;
|
|
21
|
-
extractedPatterns: DesignLanguage;
|
|
22
|
-
appliedTokens: AppliedToken[];
|
|
23
|
-
generatedFrame: { nodeId: string };
|
|
24
|
-
prompt: string;
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
interface ColorEntry {
|
|
28
|
-
role: string;
|
|
29
|
-
hex: string;
|
|
30
|
-
frequency: string;
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
interface DesignLanguage {
|
|
34
|
-
layout: {
|
|
35
|
-
gridStructure: string;
|
|
36
|
-
zoneProportions: string;
|
|
37
|
-
hierarchy: string;
|
|
38
|
-
};
|
|
39
|
-
spacing: {
|
|
40
|
-
density: "compact" | "comfortable" | "spacious";
|
|
41
|
-
paddingPattern: string;
|
|
42
|
-
dominantGap: number;
|
|
43
|
-
};
|
|
44
|
-
colorPalette: ColorEntry[];
|
|
45
|
-
typography: {
|
|
46
|
-
scalePattern: string;
|
|
47
|
-
dominantWeights: number[];
|
|
48
|
-
hierarchyLevels: number;
|
|
49
|
-
};
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
interface AppliedToken {
|
|
53
|
-
pattern: string;
|
|
54
|
-
rawValue: string | number;
|
|
55
|
-
mappedToken: string;
|
|
56
|
-
tokenValue: string | number;
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
// ─────────────────────────────────────────────────────────────────────────────
|
|
60
|
-
// Helpers
|
|
61
|
-
// ─────────────────────────────────────────────────────────────────────────────
|
|
62
|
-
|
|
63
|
-
async function resolveReference(ref: string): Promise<string> {
|
|
64
|
-
if (ref.startsWith("data:image") || ref.startsWith("http")) return ref;
|
|
65
|
-
const buf = await fs.readFile(ref);
|
|
66
|
-
return `data:image/png;base64,${buf.toString("base64")}`;
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
function parseDesignLanguage(raw: Record<string, unknown>): DesignLanguage {
|
|
70
|
-
const layout = (raw.layout as Record<string, unknown>) ?? {};
|
|
71
|
-
const spacing = (raw.spacing as Record<string, unknown>) ?? {};
|
|
72
|
-
const colorPalette = Array.isArray(raw.colorPalette)
|
|
73
|
-
? (raw.colorPalette as ColorEntry[])
|
|
74
|
-
: [];
|
|
75
|
-
const typography = (raw.typography as Record<string, unknown>) ?? {};
|
|
76
|
-
|
|
77
|
-
return {
|
|
78
|
-
layout: {
|
|
79
|
-
gridStructure: String(layout.gridStructure ?? "12-column"),
|
|
80
|
-
zoneProportions: String(layout.zoneProportions ?? "balanced"),
|
|
81
|
-
hierarchy: String(layout.hierarchy ?? "standard"),
|
|
82
|
-
},
|
|
83
|
-
spacing: {
|
|
84
|
-
density:
|
|
85
|
-
spacing.density === "compact" ||
|
|
86
|
-
spacing.density === "comfortable" ||
|
|
87
|
-
spacing.density === "spacious"
|
|
88
|
-
? spacing.density
|
|
89
|
-
: "comfortable",
|
|
90
|
-
paddingPattern: String(spacing.paddingPattern ?? "16px"),
|
|
91
|
-
dominantGap: typeof spacing.dominantGap === "number" ? spacing.dominantGap : 16,
|
|
92
|
-
},
|
|
93
|
-
colorPalette: colorPalette.map((c) => ({
|
|
94
|
-
role: String(c.role ?? "accent"),
|
|
95
|
-
hex: String(c.hex ?? "#000000"),
|
|
96
|
-
frequency: String(c.frequency ?? "minimal"),
|
|
97
|
-
})),
|
|
98
|
-
typography: {
|
|
99
|
-
scalePattern: String(typography.scalePattern ?? "modular"),
|
|
100
|
-
dominantWeights: Array.isArray(typography.dominantWeights)
|
|
101
|
-
? (typography.dominantWeights as number[])
|
|
102
|
-
: [400, 600],
|
|
103
|
-
hierarchyLevels:
|
|
104
|
-
typeof typography.hierarchyLevels === "number" ? typography.hierarchyLevels : 3,
|
|
105
|
-
},
|
|
106
|
-
};
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
function mapDesignLanguageToTokens(
|
|
110
|
-
lang: DesignLanguage,
|
|
111
|
-
dsTokens: Token[]
|
|
112
|
-
): AppliedToken[] {
|
|
113
|
-
const applied: AppliedToken[] = [];
|
|
114
|
-
|
|
115
|
-
// Map spacing
|
|
116
|
-
const gapToken = snapToSpacingToken(lang.spacing.dominantGap);
|
|
117
|
-
applied.push({
|
|
118
|
-
pattern: "dominantGap",
|
|
119
|
-
rawValue: lang.spacing.dominantGap,
|
|
120
|
-
mappedToken: gapToken.tokenName,
|
|
121
|
-
tokenValue: gapToken.tokenValue,
|
|
122
|
-
});
|
|
123
|
-
|
|
124
|
-
// Infer padding from density
|
|
125
|
-
const densityPaddingMap: Record<string, number> = {
|
|
126
|
-
compact: 8,
|
|
127
|
-
comfortable: 16,
|
|
128
|
-
spacious: 32,
|
|
129
|
-
};
|
|
130
|
-
const inferredPadding = densityPaddingMap[lang.spacing.density];
|
|
131
|
-
const paddingToken = snapToSpacingToken(inferredPadding);
|
|
132
|
-
applied.push({
|
|
133
|
-
pattern: "framePadding",
|
|
134
|
-
rawValue: inferredPadding,
|
|
135
|
-
mappedToken: paddingToken.tokenName,
|
|
136
|
-
tokenValue: paddingToken.tokenValue,
|
|
137
|
-
});
|
|
138
|
-
|
|
139
|
-
// Map colors from palette to DS tokens
|
|
140
|
-
if (dsTokens.length > 0) {
|
|
141
|
-
for (const color of lang.colorPalette) {
|
|
142
|
-
const matched = snapToColorToken(color.hex, dsTokens);
|
|
143
|
-
applied.push({
|
|
144
|
-
pattern: `color.${color.role}`,
|
|
145
|
-
rawValue: color.hex,
|
|
146
|
-
mappedToken: matched.tokenName,
|
|
147
|
-
tokenValue: String(matched.tokenValue),
|
|
148
|
-
});
|
|
149
|
-
}
|
|
150
|
-
} else {
|
|
151
|
-
for (const color of lang.colorPalette) {
|
|
152
|
-
applied.push({
|
|
153
|
-
pattern: `color.${color.role}`,
|
|
154
|
-
rawValue: color.hex,
|
|
155
|
-
mappedToken: `--color-${color.role}`,
|
|
156
|
-
tokenValue: color.hex,
|
|
157
|
-
});
|
|
158
|
-
}
|
|
159
|
-
}
|
|
160
|
-
|
|
161
|
-
return applied;
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
function buildFrameScript(
|
|
165
|
-
lang: DesignLanguage,
|
|
166
|
-
appliedTokens: AppliedToken[],
|
|
167
|
-
frameName: string,
|
|
168
|
-
prompt: string
|
|
169
|
-
): string {
|
|
170
|
-
// Extract resolved token values for use in the script
|
|
171
|
-
const gapToken = appliedTokens.find((t) => t.pattern === "dominantGap");
|
|
172
|
-
const paddingToken = appliedTokens.find((t) => t.pattern === "framePadding");
|
|
173
|
-
const primaryColorToken = appliedTokens.find((t) => t.pattern === "color.primary");
|
|
174
|
-
const surfaceColorToken = appliedTokens.find((t) => t.pattern === "color.surface");
|
|
175
|
-
|
|
176
|
-
const gap = typeof gapToken?.tokenValue === "number" ? gapToken.tokenValue : 16;
|
|
177
|
-
const padding = typeof paddingToken?.tokenValue === "number" ? paddingToken.tokenValue : 16;
|
|
178
|
-
|
|
179
|
-
// Parse primary color (hex → Figma 0-1 range)
|
|
180
|
-
const primaryHex = String(primaryColorToken?.rawValue ?? "#2563EB").replace("#", "");
|
|
181
|
-
const surfaceHex = String(surfaceColorToken?.rawValue ?? "#FFFFFF").replace("#", "");
|
|
182
|
-
|
|
183
|
-
function hexToFigmaRgb(hex: string): { r: number; g: number; b: number } {
|
|
184
|
-
const full = hex.length === 3
|
|
185
|
-
? hex.split("").map((c) => c + c).join("")
|
|
186
|
-
: hex.padEnd(6, "0").slice(0, 6);
|
|
187
|
-
const n = parseInt(full, 16);
|
|
188
|
-
return {
|
|
189
|
-
r: ((n >> 16) & 255) / 255,
|
|
190
|
-
g: ((n >> 8) & 255) / 255,
|
|
191
|
-
b: (n & 255) / 255,
|
|
192
|
-
};
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
const primaryRgb = hexToFigmaRgb(primaryHex);
|
|
196
|
-
const surfaceRgb = hexToFigmaRgb(surfaceHex);
|
|
197
|
-
const hierarchyLevels = lang.typography.hierarchyLevels;
|
|
198
|
-
|
|
199
|
-
return `
|
|
200
|
-
(async () => {
|
|
201
|
-
const frameName = ${JSON.stringify(frameName)};
|
|
202
|
-
const prompt = ${JSON.stringify(prompt)};
|
|
203
|
-
const gap = ${gap};
|
|
204
|
-
const padding = ${padding};
|
|
205
|
-
const primaryColor = ${JSON.stringify(primaryRgb)};
|
|
206
|
-
const surfaceColor = ${JSON.stringify(surfaceRgb)};
|
|
207
|
-
const hierarchyLevels = ${hierarchyLevels};
|
|
208
|
-
const gridStructure = ${JSON.stringify(lang.layout.gridStructure)};
|
|
209
|
-
const density = ${JSON.stringify(lang.spacing.density)};
|
|
210
|
-
|
|
211
|
-
// Create root frame re-interpreting the reference design language
|
|
212
|
-
const outerFrame = figma.createFrame();
|
|
213
|
-
outerFrame.name = frameName;
|
|
214
|
-
outerFrame.resize(1440, 900);
|
|
215
|
-
outerFrame.layoutMode = "VERTICAL";
|
|
216
|
-
outerFrame.primaryAxisSizingMode = "AUTO";
|
|
217
|
-
outerFrame.counterAxisSizingMode = "FIXED";
|
|
218
|
-
outerFrame.itemSpacing = gap;
|
|
219
|
-
outerFrame.paddingLeft = padding;
|
|
220
|
-
outerFrame.paddingRight = padding;
|
|
221
|
-
outerFrame.paddingTop = padding;
|
|
222
|
-
outerFrame.paddingBottom = padding;
|
|
223
|
-
outerFrame.fills = [{ type: "SOLID", color: surfaceColor }];
|
|
224
|
-
figma.currentPage.appendChild(outerFrame);
|
|
225
|
-
|
|
226
|
-
await figma.loadFontAsync({ family: "Inter", style: "Regular" });
|
|
227
|
-
await figma.loadFontAsync({ family: "Inter", style: "Bold" });
|
|
228
|
-
await figma.loadFontAsync({ family: "Inter", style: "SemiBold" });
|
|
229
|
-
|
|
230
|
-
// Header zone — reflects the extracted hierarchy
|
|
231
|
-
const headerFrame = figma.createFrame();
|
|
232
|
-
headerFrame.name = "Header";
|
|
233
|
-
headerFrame.resize(1440 - padding * 2, 72);
|
|
234
|
-
headerFrame.layoutMode = "HORIZONTAL";
|
|
235
|
-
headerFrame.primaryAxisSizingMode = "FIXED";
|
|
236
|
-
headerFrame.counterAxisSizingMode = "AUTO";
|
|
237
|
-
headerFrame.counterAxisAlignItems = "CENTER";
|
|
238
|
-
headerFrame.paddingLeft = 0;
|
|
239
|
-
headerFrame.paddingRight = 0;
|
|
240
|
-
headerFrame.itemSpacing = gap;
|
|
241
|
-
headerFrame.fills = [];
|
|
242
|
-
headerFrame.layoutSizingHorizontal = "FILL";
|
|
243
|
-
outerFrame.appendChild(headerFrame);
|
|
244
|
-
|
|
245
|
-
// Page title text
|
|
246
|
-
const titleText = figma.createText();
|
|
247
|
-
titleText.characters = prompt.slice(0, 60);
|
|
248
|
-
titleText.fontName = { family: "Inter", style: "Bold" };
|
|
249
|
-
titleText.fontSize = hierarchyLevels >= 3 ? 32 : 24;
|
|
250
|
-
titleText.fills = [{ type: "SOLID", color: { r: 0.07, g: 0.07, b: 0.07 } }];
|
|
251
|
-
titleText.layoutSizingHorizontal = "FILL";
|
|
252
|
-
headerFrame.appendChild(titleText);
|
|
253
|
-
|
|
254
|
-
// Primary action button placeholder
|
|
255
|
-
const actionBtn = figma.createFrame();
|
|
256
|
-
actionBtn.name = "Primary Action";
|
|
257
|
-
actionBtn.resize(140, 44);
|
|
258
|
-
actionBtn.cornerRadius = 8;
|
|
259
|
-
actionBtn.fills = [{ type: "SOLID", color: primaryColor }];
|
|
260
|
-
actionBtn.layoutMode = "HORIZONTAL";
|
|
261
|
-
actionBtn.primaryAxisAlignItems = "CENTER";
|
|
262
|
-
actionBtn.counterAxisAlignItems = "CENTER";
|
|
263
|
-
headerFrame.appendChild(actionBtn);
|
|
264
|
-
|
|
265
|
-
const btnLabel = figma.createText();
|
|
266
|
-
btnLabel.characters = "Primary Action";
|
|
267
|
-
btnLabel.fontName = { family: "Inter", style: "SemiBold" };
|
|
268
|
-
btnLabel.fontSize = 14;
|
|
269
|
-
btnLabel.fills = [{ type: "SOLID", color: { r: 1, g: 1, b: 1 } }];
|
|
270
|
-
actionBtn.appendChild(btnLabel);
|
|
271
|
-
|
|
272
|
-
// Content zone — grid based on extracted grid structure
|
|
273
|
-
const contentRow = figma.createFrame();
|
|
274
|
-
contentRow.name = "Content Grid";
|
|
275
|
-
contentRow.resize(1440 - padding * 2, 500);
|
|
276
|
-
contentRow.layoutMode = "HORIZONTAL";
|
|
277
|
-
contentRow.primaryAxisSizingMode = "FIXED";
|
|
278
|
-
contentRow.counterAxisSizingMode = "AUTO";
|
|
279
|
-
contentRow.itemSpacing = gap;
|
|
280
|
-
contentRow.fills = [];
|
|
281
|
-
contentRow.layoutSizingHorizontal = "FILL";
|
|
282
|
-
outerFrame.appendChild(contentRow);
|
|
283
|
-
|
|
284
|
-
// Determine column count from grid structure
|
|
285
|
-
const colCount = gridStructure.includes("12") ? 3 : gridStructure.includes("8") ? 2 : 3;
|
|
286
|
-
const colWidth = Math.floor((1440 - padding * 2 - gap * (colCount - 1)) / colCount);
|
|
287
|
-
|
|
288
|
-
for (let col = 0; col < colCount; col++) {
|
|
289
|
-
const card = figma.createFrame();
|
|
290
|
-
card.name = "Content Card " + (col + 1);
|
|
291
|
-
card.resize(colWidth, 240);
|
|
292
|
-
card.cornerRadius = 12;
|
|
293
|
-
card.fills = [{ type: "SOLID", color: { r: 0.97, g: 0.97, b: 0.97 } }];
|
|
294
|
-
card.strokes = [{ type: "SOLID", color: { r: 0.9, g: 0.9, b: 0.9 } }];
|
|
295
|
-
card.strokeWeight = 1;
|
|
296
|
-
card.layoutMode = "VERTICAL";
|
|
297
|
-
card.primaryAxisSizingMode = "FIXED";
|
|
298
|
-
card.paddingLeft = padding;
|
|
299
|
-
card.paddingRight = padding;
|
|
300
|
-
card.paddingTop = padding;
|
|
301
|
-
card.paddingBottom = padding;
|
|
302
|
-
card.itemSpacing = gap / 2;
|
|
303
|
-
|
|
304
|
-
const cardTitle = figma.createText();
|
|
305
|
-
cardTitle.characters = "Section " + (col + 1);
|
|
306
|
-
cardTitle.fontName = { family: "Inter", style: "SemiBold" };
|
|
307
|
-
cardTitle.fontSize = 16;
|
|
308
|
-
cardTitle.fills = [{ type: "SOLID", color: { r: 0.1, g: 0.1, b: 0.1 } }];
|
|
309
|
-
card.appendChild(cardTitle);
|
|
310
|
-
|
|
311
|
-
const cardBody = figma.createText();
|
|
312
|
-
cardBody.characters = "Content re-interpreted from reference design using design system tokens.";
|
|
313
|
-
cardBody.fontName = { family: "Inter", style: "Regular" };
|
|
314
|
-
cardBody.fontSize = 14;
|
|
315
|
-
cardBody.fills = [{ type: "SOLID", color: { r: 0.45, g: 0.45, b: 0.45 } }];
|
|
316
|
-
cardBody.layoutSizingHorizontal = "FILL";
|
|
317
|
-
card.appendChild(cardBody);
|
|
318
|
-
|
|
319
|
-
contentRow.appendChild(card);
|
|
320
|
-
}
|
|
321
|
-
|
|
322
|
-
// Attach description note about the design language extraction
|
|
323
|
-
const noteSticky = figma.createSticky();
|
|
324
|
-
noteSticky.text.characters =
|
|
325
|
-
"Generated from reference design language\\n" +
|
|
326
|
-
"Grid: " + gridStructure + " | Density: " + density + "\\n" +
|
|
327
|
-
"Prompt: " + prompt.slice(0, 120);
|
|
328
|
-
noteSticky.x = outerFrame.x + 1440 + 32;
|
|
329
|
-
noteSticky.y = outerFrame.y;
|
|
330
|
-
figma.currentPage.appendChild(noteSticky);
|
|
331
|
-
|
|
332
|
-
figma.viewport.scrollAndZoomIntoView([outerFrame]);
|
|
333
|
-
return { frameId: outerFrame.id, nodeId: outerFrame.id };
|
|
334
|
-
})();
|
|
335
|
-
`;
|
|
336
|
-
}
|
|
337
|
-
|
|
338
|
-
// ─────────────────────────────────────────────────────────────────────────────
|
|
339
|
-
// Handler
|
|
340
|
-
// ─────────────────────────────────────────────────────────────────────────────
|
|
341
|
-
|
|
342
|
-
export async function designFromRefHandler(
|
|
343
|
-
args: DesignFromRefArgs
|
|
344
|
-
): Promise<DesignFromRefResult> {
|
|
345
|
-
const {
|
|
346
|
-
references,
|
|
347
|
-
prompt,
|
|
348
|
-
extractOnly,
|
|
349
|
-
designSystemContext = "",
|
|
350
|
-
} = args;
|
|
351
|
-
|
|
352
|
-
if (references.length === 0) {
|
|
353
|
-
throw new Error("designFromRefHandler: at least one reference image is required");
|
|
354
|
-
}
|
|
355
|
-
|
|
356
|
-
// 1. Resolve all references to base64 / URLs
|
|
357
|
-
const resolvedRefs = await Promise.all(references.map(resolveReference));
|
|
358
|
-
|
|
359
|
-
// 2. Determine what to extract
|
|
360
|
-
const defaultExtractTypes = ["layout", "spacing", "colorPalette", "typography"];
|
|
361
|
-
const extractTypes =
|
|
362
|
-
extractOnly && extractOnly.length > 0 ? extractOnly : defaultExtractTypes;
|
|
363
|
-
|
|
364
|
-
// 3. Extract design language from all references
|
|
365
|
-
const vision = new VisionClient();
|
|
366
|
-
const rawLang = await vision.extractDesignLanguage(resolvedRefs, extractTypes);
|
|
367
|
-
|
|
368
|
-
// 4. Parse and normalise the extracted design language
|
|
369
|
-
const lang = parseDesignLanguage(rawLang);
|
|
370
|
-
|
|
371
|
-
// 5. Load DS tokens to map extracted patterns onto real tokens
|
|
372
|
-
const bridge = await getBridge();
|
|
373
|
-
const dsId = bridge.getActiveDesignSystemId();
|
|
374
|
-
let dsTokens: Token[];
|
|
375
|
-
if (dsId) {
|
|
376
|
-
// When a DS is selected, use its authoritative tokens
|
|
377
|
-
const { getDesignSystemTokens } = await import("../../../shared/design-system-tokens.js");
|
|
378
|
-
dsTokens = getDesignSystemTokens(dsId);
|
|
379
|
-
} else {
|
|
380
|
-
dsTokens = await bridge.getTokens();
|
|
381
|
-
}
|
|
382
|
-
|
|
383
|
-
// 6. Map extracted design language to DS tokens
|
|
384
|
-
const appliedTokens = mapDesignLanguageToTokens(lang, dsTokens);
|
|
385
|
-
|
|
386
|
-
// 7. Build and execute Figma frame script
|
|
387
|
-
const contextSuffix = designSystemContext ? ` — ${designSystemContext.slice(0, 30)}` : "";
|
|
388
|
-
const frameName = `[Design from Ref] ${new Date().toLocaleDateString("en-US")}${contextSuffix}`;
|
|
389
|
-
const script = buildFrameScript(lang, appliedTokens, frameName, prompt);
|
|
390
|
-
|
|
391
|
-
const execResult = await bridge.execute(script);
|
|
392
|
-
if (!execResult.success) {
|
|
393
|
-
throw new Error(
|
|
394
|
-
`designFromRefHandler: Figma execution failed — ${execResult.error}`
|
|
395
|
-
);
|
|
396
|
-
}
|
|
397
|
-
|
|
398
|
-
const execData = execResult.result as { frameId: string; nodeId: string };
|
|
399
|
-
|
|
400
|
-
// 8. Log action
|
|
401
|
-
await decisionLog.log({
|
|
402
|
-
tool: "figma_design_from_ref",
|
|
403
|
-
nodeIds: [execData.frameId],
|
|
404
|
-
rationale: `Created design frame from ${references.length} reference image(s). Extracted ${extractTypes.join(", ")}. Mapped ${appliedTokens.length} design patterns to DS tokens. Prompt: "${prompt.slice(0, 100)}".`,
|
|
405
|
-
tokens: appliedTokens.map((t) => t.mappedToken),
|
|
406
|
-
reversible: true,
|
|
407
|
-
metadata: {
|
|
408
|
-
referenceCount: references.length,
|
|
409
|
-
extractTypes,
|
|
410
|
-
designSystemContext,
|
|
411
|
-
appliedTokenCount: appliedTokens.length,
|
|
412
|
-
colorPaletteSize: lang.colorPalette.length,
|
|
413
|
-
spacingDensity: lang.spacing.density,
|
|
414
|
-
},
|
|
415
|
-
});
|
|
416
|
-
|
|
417
|
-
return {
|
|
418
|
-
frameId: execData.frameId,
|
|
419
|
-
extractedPatterns: lang,
|
|
420
|
-
appliedTokens,
|
|
421
|
-
generatedFrame: { nodeId: execData.nodeId },
|
|
422
|
-
prompt,
|
|
423
|
-
};
|
|
424
|
-
}
|
package/figma-intelligence-layer/src/tools/phase1-vision/screen-cloner/component-recognizer.ts
DELETED
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
// ─────────────────────────────────────────────────────────────────────────────
|
|
2
|
-
// Component Recognizer (Vision Pass 2)
|
|
3
|
-
// Identifies the UI component type, variants, and properties of a single zone.
|
|
4
|
-
// ─────────────────────────────────────────────────────────────────────────────
|
|
5
|
-
|
|
6
|
-
import { VisionClient } from "../../../shared/vision-client.js";
|
|
7
|
-
import { ComponentManifest } from "../../../shared/types.js";
|
|
8
|
-
|
|
9
|
-
const RECOGNIZE_PROMPT = `Analyze this UI region and identify the component. Return JSON with:
|
|
10
|
-
- componentType: specific UI component name (e.g. "PrimaryButton", "TextInput", "NavigationBar")
|
|
11
|
-
- variants: object of detected variants {size, state, theme, type}
|
|
12
|
-
- textContent: visible text content (null if none)
|
|
13
|
-
- iconPresent: boolean
|
|
14
|
-
- iconName: best guess for the icon or logo name (null if none)
|
|
15
|
-
- iconKind: "system" | "brand" | "illustration" | "unknown"
|
|
16
|
-
- preferredIconLibrary: best open-source icon family for this region, prefer "material-symbols" for standard UI and "simple-icons" for brands
|
|
17
|
-
- openSourceIconName: exact open-source icon slug if recognizable (examples: "menu", "search", "close", "shopping_cart")
|
|
18
|
-
- interactiveElement: boolean (is this clickable/focusable?)
|
|
19
|
-
- estimatedSpacing: measured padding/gap in pixels, prefer exact visual estimate over assumptions
|
|
20
|
-
- estimatedRadius: border radius in pixels if visible
|
|
21
|
-
- estimatedFontSize: visible text size in pixels if text is present
|
|
22
|
-
- fontFamilyGuess: closest visible font family name if text is present
|
|
23
|
-
- fontStyleGuess: closest visible font style name if text is present
|
|
24
|
-
- fontWeightGuess: closest visible font weight number if text is present
|
|
25
|
-
- confidence: 0-1 how confident you are in this identification
|
|
26
|
-
|
|
27
|
-
Return ONLY valid JSON.`;
|
|
28
|
-
|
|
29
|
-
/**
|
|
30
|
-
* Run Vision Pass 2 on a single zone image to produce a ComponentManifest.
|
|
31
|
-
*/
|
|
32
|
-
export async function recognizeComponent(
|
|
33
|
-
zoneImage: string,
|
|
34
|
-
vision: VisionClient
|
|
35
|
-
): Promise<ComponentManifest> {
|
|
36
|
-
void RECOGNIZE_PROMPT;
|
|
37
|
-
return vision.identify(zoneImage);
|
|
38
|
-
}
|
|
@@ -1,111 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
DesignSystemContext,
|
|
3
|
-
DSComponentSet,
|
|
4
|
-
} from "../../../shared/design-system-context.js";
|
|
5
|
-
import {
|
|
6
|
-
manifestToDSMatchRequest,
|
|
7
|
-
matchComponentInContext,
|
|
8
|
-
} from "../../../shared/design-system-matcher.js";
|
|
9
|
-
import { inferComponentIntents, inferVariantSchema, normalizeName } from "../../../shared/design-system-normalizers.js";
|
|
10
|
-
import { ComponentManifest, ComponentSet } from "../../../shared/types.js";
|
|
11
|
-
|
|
12
|
-
export interface DSMatchResult {
|
|
13
|
-
component: DSComponentSet | null;
|
|
14
|
-
confidence: number;
|
|
15
|
-
fallbackSuggestion: string | null;
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
const DEFAULT_CONFIDENCE_THRESHOLD = 0.75;
|
|
19
|
-
|
|
20
|
-
/**
|
|
21
|
-
* Match a ComponentManifest to the nearest design-system component.
|
|
22
|
-
*
|
|
23
|
-
* @param manifest Recognised component manifest from Vision Pass 2
|
|
24
|
-
* @param context Shared design-system context
|
|
25
|
-
* @param threshold Minimum confidence (0–1) to accept the match
|
|
26
|
-
* @returns Matched ComponentSet (or null) with confidence score
|
|
27
|
-
*/
|
|
28
|
-
export function matchToDesignSystem(
|
|
29
|
-
manifest: ComponentManifest,
|
|
30
|
-
contextOrSets: DesignSystemContext | ComponentSet[],
|
|
31
|
-
threshold = DEFAULT_CONFIDENCE_THRESHOLD
|
|
32
|
-
): DSMatchResult {
|
|
33
|
-
const context = Array.isArray(contextOrSets) ? createAdHocContext(contextOrSets) : contextOrSets;
|
|
34
|
-
const result = matchComponentInContext(manifestToDSMatchRequest(manifest), context, threshold);
|
|
35
|
-
return {
|
|
36
|
-
component: result.component,
|
|
37
|
-
confidence: result.confidence,
|
|
38
|
-
fallbackSuggestion: result.fallbackSuggestion,
|
|
39
|
-
};
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
function createAdHocContext(componentSets: ComponentSet[]): DesignSystemContext {
|
|
43
|
-
const normalizedSets = componentSets.map((set) => ({
|
|
44
|
-
id: set.id,
|
|
45
|
-
name: set.name,
|
|
46
|
-
normalizedName: normalizeName(set.name),
|
|
47
|
-
description: set.description,
|
|
48
|
-
childComponentIds: set.children.map((child) => child.id),
|
|
49
|
-
variantSchema: inferVariantSchema(set),
|
|
50
|
-
intents: Array.from(
|
|
51
|
-
new Set([
|
|
52
|
-
...inferComponentIntents(set.name, set.description),
|
|
53
|
-
...set.children.flatMap((child) => inferComponentIntents(child.name, child.description)),
|
|
54
|
-
])
|
|
55
|
-
),
|
|
56
|
-
}));
|
|
57
|
-
|
|
58
|
-
const components = componentSets.flatMap((set) =>
|
|
59
|
-
set.children.map((child) => ({
|
|
60
|
-
id: child.id,
|
|
61
|
-
setId: set.id,
|
|
62
|
-
name: child.name,
|
|
63
|
-
normalizedName: normalizeName(child.name),
|
|
64
|
-
description: child.description,
|
|
65
|
-
variantProps: {},
|
|
66
|
-
intents: inferComponentIntents(child.name, child.description),
|
|
67
|
-
}))
|
|
68
|
-
);
|
|
69
|
-
|
|
70
|
-
return {
|
|
71
|
-
file: {
|
|
72
|
-
lastSyncedAt: Date.now(),
|
|
73
|
-
source: "mixed",
|
|
74
|
-
},
|
|
75
|
-
inventory: {
|
|
76
|
-
componentSets: normalizedSets,
|
|
77
|
-
components,
|
|
78
|
-
variables: [],
|
|
79
|
-
styles: [],
|
|
80
|
-
pages: [],
|
|
81
|
-
instances: [],
|
|
82
|
-
},
|
|
83
|
-
indexes: {
|
|
84
|
-
componentById: new Map(components.map((component) => [component.id, component])),
|
|
85
|
-
componentSetById: new Map(normalizedSets.map((componentSet) => [componentSet.id, componentSet])),
|
|
86
|
-
tokenById: new Map(),
|
|
87
|
-
styleById: new Map(),
|
|
88
|
-
componentsByNormalizedName: new Map(),
|
|
89
|
-
tokensByNormalizedName: new Map(),
|
|
90
|
-
componentsByIntent: new Map(),
|
|
91
|
-
},
|
|
92
|
-
intelligence: {
|
|
93
|
-
aliases: {},
|
|
94
|
-
variantSchemas: Object.fromEntries(
|
|
95
|
-
normalizedSets
|
|
96
|
-
.filter((set) => set.variantSchema)
|
|
97
|
-
.map((set) => [set.id, set.variantSchema!])
|
|
98
|
-
),
|
|
99
|
-
semanticTokenGroups: {},
|
|
100
|
-
preferredComponentsByIntent: {},
|
|
101
|
-
namingRules: [],
|
|
102
|
-
},
|
|
103
|
-
freshness: {
|
|
104
|
-
componentSets: Date.now(),
|
|
105
|
-
variables: 0,
|
|
106
|
-
styles: 0,
|
|
107
|
-
pages: 0,
|
|
108
|
-
instances: 0,
|
|
109
|
-
},
|
|
110
|
-
};
|
|
111
|
-
}
|
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
import { ComponentManifest } from "../../../shared/types.js";
|
|
2
|
-
|
|
3
|
-
interface FontName {
|
|
4
|
-
family: string;
|
|
5
|
-
style: string;
|
|
6
|
-
}
|
|
7
|
-
|
|
8
|
-
interface RawTextStyle {
|
|
9
|
-
id: string;
|
|
10
|
-
name: string;
|
|
11
|
-
fontName?: FontName;
|
|
12
|
-
fontSize?: number;
|
|
13
|
-
lineHeight?: { unit?: string; value?: number };
|
|
14
|
-
}
|
|
15
|
-
|
|
16
|
-
export interface FontStyleMatch {
|
|
17
|
-
styleId: string;
|
|
18
|
-
styleName: string;
|
|
19
|
-
fontFamily: string;
|
|
20
|
-
fontStyle: string;
|
|
21
|
-
fontSize: number;
|
|
22
|
-
lineHeightPx?: number;
|
|
23
|
-
confidence: number;
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
function normalize(value: string | undefined): string {
|
|
27
|
-
return (value ?? "").trim().toLowerCase();
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
function scoreStringMatch(a: string | undefined, b: string | undefined): number {
|
|
31
|
-
const left = normalize(a);
|
|
32
|
-
const right = normalize(b);
|
|
33
|
-
if (!left || !right) return 0;
|
|
34
|
-
if (left === right) return 1;
|
|
35
|
-
if (left.includes(right) || right.includes(left)) return 0.8;
|
|
36
|
-
|
|
37
|
-
const leftTokens = new Set(left.split(/[\s/_-]+/).filter(Boolean));
|
|
38
|
-
const rightTokens = right.split(/[\s/_-]+/).filter(Boolean);
|
|
39
|
-
if (!leftTokens.size || !rightTokens.length) return 0;
|
|
40
|
-
|
|
41
|
-
const overlap = rightTokens.filter((token) => leftTokens.has(token)).length;
|
|
42
|
-
return overlap / Math.max(leftTokens.size, rightTokens.length);
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
function scoreNumericProximity(actual: number | undefined, expected: number | undefined, maxDelta: number): number {
|
|
46
|
-
if (actual == null || expected == null) return 0;
|
|
47
|
-
const delta = Math.abs(actual - expected);
|
|
48
|
-
return Math.max(0, 1 - delta / maxDelta);
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
function normalizeTextStyles(styles: Record<string, unknown> | undefined): RawTextStyle[] {
|
|
52
|
-
if (!styles || !Array.isArray(styles.text)) return [];
|
|
53
|
-
return styles.text.filter((style): style is RawTextStyle => {
|
|
54
|
-
return typeof style === "object" && style !== null && "id" in style && "name" in style;
|
|
55
|
-
});
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
export function resolveFontStyleMatch(
|
|
59
|
-
manifest: ComponentManifest,
|
|
60
|
-
styles: Record<string, unknown> | undefined
|
|
61
|
-
): FontStyleMatch | null {
|
|
62
|
-
const candidates = normalizeTextStyles(styles);
|
|
63
|
-
if (candidates.length === 0) return null;
|
|
64
|
-
|
|
65
|
-
const scored = candidates
|
|
66
|
-
.map((style) => {
|
|
67
|
-
const familyScore = scoreStringMatch(style.fontName?.family, manifest.fontFamilyGuess);
|
|
68
|
-
const styleScore = scoreStringMatch(style.fontName?.style ?? style.name, manifest.fontStyleGuess);
|
|
69
|
-
const sizeScore = scoreNumericProximity(style.fontSize, manifest.estimatedFontSize, 16);
|
|
70
|
-
const weightScore = scoreNumericProximity(
|
|
71
|
-
inferWeight(style.fontName?.style),
|
|
72
|
-
manifest.fontWeightGuess,
|
|
73
|
-
500
|
|
74
|
-
);
|
|
75
|
-
|
|
76
|
-
const confidence = familyScore * 0.45 + styleScore * 0.2 + sizeScore * 0.2 + weightScore * 0.15;
|
|
77
|
-
|
|
78
|
-
return {
|
|
79
|
-
style,
|
|
80
|
-
confidence,
|
|
81
|
-
};
|
|
82
|
-
})
|
|
83
|
-
.sort((a, b) => b.confidence - a.confidence);
|
|
84
|
-
|
|
85
|
-
const best = scored[0];
|
|
86
|
-
if (!best || best.confidence < 0.35 || !best.style.fontName || best.style.fontSize == null) {
|
|
87
|
-
return null;
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
return {
|
|
91
|
-
styleId: best.style.id,
|
|
92
|
-
styleName: best.style.name,
|
|
93
|
-
fontFamily: best.style.fontName.family,
|
|
94
|
-
fontStyle: best.style.fontName.style,
|
|
95
|
-
fontSize: best.style.fontSize,
|
|
96
|
-
lineHeightPx: best.style.lineHeight?.unit === "PIXELS" ? best.style.lineHeight.value : undefined,
|
|
97
|
-
confidence: best.confidence,
|
|
98
|
-
};
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
function inferWeight(fontStyle: string | undefined): number | undefined {
|
|
102
|
-
const value = normalize(fontStyle);
|
|
103
|
-
if (!value) return undefined;
|
|
104
|
-
if (value.includes("thin")) return 100;
|
|
105
|
-
if (value.includes("extralight") || value.includes("ultralight")) return 200;
|
|
106
|
-
if (value.includes("light")) return 300;
|
|
107
|
-
if (value.includes("regular") || value.includes("book")) return 400;
|
|
108
|
-
if (value.includes("medium")) return 500;
|
|
109
|
-
if (value.includes("semibold") || value.includes("demibold")) return 600;
|
|
110
|
-
if (value.includes("bold")) return 700;
|
|
111
|
-
if (value.includes("extrabold") || value.includes("ultrabold")) return 800;
|
|
112
|
-
if (value.includes("black") || value.includes("heavy")) return 900;
|
|
113
|
-
return undefined;
|
|
114
|
-
}
|