@muloka/figma-console-mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (443) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +898 -0
  3. package/dist/apps/design-system-dashboard/scoring/accessibility.d.ts +14 -0
  4. package/dist/apps/design-system-dashboard/scoring/accessibility.d.ts.map +1 -0
  5. package/dist/apps/design-system-dashboard/scoring/accessibility.js +278 -0
  6. package/dist/apps/design-system-dashboard/scoring/accessibility.js.map +1 -0
  7. package/dist/apps/design-system-dashboard/scoring/component-metadata.d.ts +29 -0
  8. package/dist/apps/design-system-dashboard/scoring/component-metadata.d.ts.map +1 -0
  9. package/dist/apps/design-system-dashboard/scoring/component-metadata.js +358 -0
  10. package/dist/apps/design-system-dashboard/scoring/component-metadata.js.map +1 -0
  11. package/dist/apps/design-system-dashboard/scoring/consistency.d.ts +14 -0
  12. package/dist/apps/design-system-dashboard/scoring/consistency.d.ts.map +1 -0
  13. package/dist/apps/design-system-dashboard/scoring/consistency.js +342 -0
  14. package/dist/apps/design-system-dashboard/scoring/consistency.js.map +1 -0
  15. package/dist/apps/design-system-dashboard/scoring/coverage.d.ts +14 -0
  16. package/dist/apps/design-system-dashboard/scoring/coverage.d.ts.map +1 -0
  17. package/dist/apps/design-system-dashboard/scoring/coverage.js +231 -0
  18. package/dist/apps/design-system-dashboard/scoring/coverage.js.map +1 -0
  19. package/dist/apps/design-system-dashboard/scoring/engine.d.ts +27 -0
  20. package/dist/apps/design-system-dashboard/scoring/engine.d.ts.map +1 -0
  21. package/dist/apps/design-system-dashboard/scoring/engine.js +93 -0
  22. package/dist/apps/design-system-dashboard/scoring/engine.js.map +1 -0
  23. package/dist/apps/design-system-dashboard/scoring/naming-semantics.d.ts +14 -0
  24. package/dist/apps/design-system-dashboard/scoring/naming-semantics.d.ts.map +1 -0
  25. package/dist/apps/design-system-dashboard/scoring/naming-semantics.js +309 -0
  26. package/dist/apps/design-system-dashboard/scoring/naming-semantics.js.map +1 -0
  27. package/dist/apps/design-system-dashboard/scoring/token-architecture.d.ts +14 -0
  28. package/dist/apps/design-system-dashboard/scoring/token-architecture.d.ts.map +1 -0
  29. package/dist/apps/design-system-dashboard/scoring/token-architecture.js +350 -0
  30. package/dist/apps/design-system-dashboard/scoring/token-architecture.js.map +1 -0
  31. package/dist/apps/design-system-dashboard/scoring/types.d.ts +89 -0
  32. package/dist/apps/design-system-dashboard/scoring/types.d.ts.map +1 -0
  33. package/dist/apps/design-system-dashboard/scoring/types.js +41 -0
  34. package/dist/apps/design-system-dashboard/scoring/types.js.map +1 -0
  35. package/dist/apps/design-system-dashboard/server.d.ts +24 -0
  36. package/dist/apps/design-system-dashboard/server.d.ts.map +1 -0
  37. package/dist/apps/design-system-dashboard/server.js +160 -0
  38. package/dist/apps/design-system-dashboard/server.js.map +1 -0
  39. package/dist/apps/token-browser/server.d.ts +26 -0
  40. package/dist/apps/token-browser/server.d.ts.map +1 -0
  41. package/dist/apps/token-browser/server.js +137 -0
  42. package/dist/apps/token-browser/server.js.map +1 -0
  43. package/dist/browser/base.d.ts +58 -0
  44. package/dist/browser/base.d.ts.map +1 -0
  45. package/dist/browser/base.js +6 -0
  46. package/dist/browser/base.js.map +1 -0
  47. package/dist/browser/local.d.ts +87 -0
  48. package/dist/browser/local.d.ts.map +1 -0
  49. package/dist/browser/local.js +318 -0
  50. package/dist/browser/local.js.map +1 -0
  51. package/dist/cloudflare/apps/design-system-dashboard/scoring/accessibility.js +277 -0
  52. package/dist/cloudflare/apps/design-system-dashboard/scoring/component-metadata.js +357 -0
  53. package/dist/cloudflare/apps/design-system-dashboard/scoring/consistency.js +341 -0
  54. package/dist/cloudflare/apps/design-system-dashboard/scoring/coverage.js +230 -0
  55. package/dist/cloudflare/apps/design-system-dashboard/scoring/engine.js +92 -0
  56. package/dist/cloudflare/apps/design-system-dashboard/scoring/naming-semantics.js +308 -0
  57. package/dist/cloudflare/apps/design-system-dashboard/scoring/token-architecture.js +349 -0
  58. package/dist/cloudflare/apps/design-system-dashboard/scoring/types.js +40 -0
  59. package/dist/cloudflare/apps/design-system-dashboard/server.js +159 -0
  60. package/dist/cloudflare/apps/token-browser/server.js +136 -0
  61. package/dist/cloudflare/browser-manager.js +157 -0
  62. package/dist/cloudflare/core/accessibility-tools.js +361 -0
  63. package/dist/cloudflare/core/annotation-tools.js +230 -0
  64. package/dist/cloudflare/core/cloud-websocket-connector.js +419 -0
  65. package/dist/cloudflare/core/cloud-websocket-relay.js +198 -0
  66. package/dist/cloudflare/core/comment-tools.js +292 -0
  67. package/dist/cloudflare/core/config.js +153 -0
  68. package/dist/cloudflare/core/console-monitor.js +427 -0
  69. package/dist/cloudflare/core/deep-component-tools.js +128 -0
  70. package/dist/cloudflare/core/design-code-tools.js +2793 -0
  71. package/dist/cloudflare/core/design-system-manifest.js +265 -0
  72. package/dist/cloudflare/core/design-system-tools.js +882 -0
  73. package/dist/cloudflare/core/diagnose-tool.js +100 -0
  74. package/dist/cloudflare/core/diff/changelog-formatter.js +275 -0
  75. package/dist/cloudflare/core/diff/diff-engine.js +334 -0
  76. package/dist/cloudflare/core/diff/property-compare.js +36 -0
  77. package/dist/cloudflare/core/diff/version-cache.js +74 -0
  78. package/dist/cloudflare/core/enrichment/enrichment-service.js +374 -0
  79. package/dist/cloudflare/core/enrichment/index.js +7 -0
  80. package/dist/cloudflare/core/enrichment/relationship-mapper.js +351 -0
  81. package/dist/cloudflare/core/enrichment/style-resolver.js +346 -0
  82. package/dist/cloudflare/core/figjam-tools.js +547 -0
  83. package/dist/cloudflare/core/figma-api.js +509 -0
  84. package/dist/cloudflare/core/figma-connector.js +7 -0
  85. package/dist/cloudflare/core/figma-reconstruction-spec.js +402 -0
  86. package/dist/cloudflare/core/figma-style-extractor.js +311 -0
  87. package/dist/cloudflare/core/figma-tools.js +3302 -0
  88. package/dist/cloudflare/core/identity.js +96 -0
  89. package/dist/cloudflare/core/library-tools.js +580 -0
  90. package/dist/cloudflare/core/logger.js +53 -0
  91. package/dist/cloudflare/core/port-discovery.js +935 -0
  92. package/dist/cloudflare/core/resolve-package-root.js +11 -0
  93. package/dist/cloudflare/core/slides-tools.js +714 -0
  94. package/dist/cloudflare/core/slot-tools.js +334 -0
  95. package/dist/cloudflare/core/snippet-injector.js +96 -0
  96. package/dist/cloudflare/core/tokens/alias-resolver.js +205 -0
  97. package/dist/cloudflare/core/tokens/config.js +294 -0
  98. package/dist/cloudflare/core/tokens/dialect.js +232 -0
  99. package/dist/cloudflare/core/tokens/figma-converter.js +323 -0
  100. package/dist/cloudflare/core/tokens/formatters/css-vars.js +338 -0
  101. package/dist/cloudflare/core/tokens/formatters/dtcg.js +376 -0
  102. package/dist/cloudflare/core/tokens/formatters/index.js +45 -0
  103. package/dist/cloudflare/core/tokens/formatters/json.js +205 -0
  104. package/dist/cloudflare/core/tokens/formatters/less.js +4 -0
  105. package/dist/cloudflare/core/tokens/formatters/scss.js +258 -0
  106. package/dist/cloudflare/core/tokens/formatters/stubs.js +13 -0
  107. package/dist/cloudflare/core/tokens/formatters/style-dictionary-v3.js +213 -0
  108. package/dist/cloudflare/core/tokens/formatters/tailwind-v3.js +237 -0
  109. package/dist/cloudflare/core/tokens/formatters/tailwind-v4.js +335 -0
  110. package/dist/cloudflare/core/tokens/formatters/tokens-studio.js +256 -0
  111. package/dist/cloudflare/core/tokens/formatters/ts-module.js +198 -0
  112. package/dist/cloudflare/core/tokens/index.js +16 -0
  113. package/dist/cloudflare/core/tokens/parsers/css-vars.js +4 -0
  114. package/dist/cloudflare/core/tokens/parsers/dtcg.js +280 -0
  115. package/dist/cloudflare/core/tokens/parsers/index.js +138 -0
  116. package/dist/cloudflare/core/tokens/parsers/json.js +7 -0
  117. package/dist/cloudflare/core/tokens/parsers/scss.js +4 -0
  118. package/dist/cloudflare/core/tokens/parsers/stubs.js +20 -0
  119. package/dist/cloudflare/core/tokens/parsers/style-dictionary-v3.js +4 -0
  120. package/dist/cloudflare/core/tokens/parsers/tailwind-v3.js +4 -0
  121. package/dist/cloudflare/core/tokens/parsers/tailwind-v4.js +4 -0
  122. package/dist/cloudflare/core/tokens/parsers/tokens-studio.js +4 -0
  123. package/dist/cloudflare/core/tokens/schemas.js +152 -0
  124. package/dist/cloudflare/core/tokens/transforms/color.js +12 -0
  125. package/dist/cloudflare/core/tokens/transforms/index.js +29 -0
  126. package/dist/cloudflare/core/tokens/transforms/size.js +7 -0
  127. package/dist/cloudflare/core/tokens/types.js +18 -0
  128. package/dist/cloudflare/core/tokens-tools.js +1788 -0
  129. package/dist/cloudflare/core/types/design-code.js +4 -0
  130. package/dist/cloudflare/core/types/enriched.js +5 -0
  131. package/dist/cloudflare/core/types/index.js +4 -0
  132. package/dist/cloudflare/core/variable-resolver.js +85 -0
  133. package/dist/cloudflare/core/version-tools.js +1199 -0
  134. package/dist/cloudflare/core/websocket-connector.js +436 -0
  135. package/dist/cloudflare/core/websocket-server.js +956 -0
  136. package/dist/cloudflare/core/write-tools.js +2506 -0
  137. package/dist/cloudflare/index.js +3010 -0
  138. package/dist/core/accessibility-tools.d.ts +21 -0
  139. package/dist/core/accessibility-tools.d.ts.map +1 -0
  140. package/dist/core/accessibility-tools.js +362 -0
  141. package/dist/core/accessibility-tools.js.map +1 -0
  142. package/dist/core/annotation-tools.d.ts +14 -0
  143. package/dist/core/annotation-tools.d.ts.map +1 -0
  144. package/dist/core/annotation-tools.js +231 -0
  145. package/dist/core/annotation-tools.js.map +1 -0
  146. package/dist/core/comment-tools.d.ts +11 -0
  147. package/dist/core/comment-tools.d.ts.map +1 -0
  148. package/dist/core/comment-tools.js +293 -0
  149. package/dist/core/comment-tools.js.map +1 -0
  150. package/dist/core/config.d.ts +17 -0
  151. package/dist/core/config.d.ts.map +1 -0
  152. package/dist/core/config.js +154 -0
  153. package/dist/core/config.js.map +1 -0
  154. package/dist/core/console-monitor.d.ts +82 -0
  155. package/dist/core/console-monitor.d.ts.map +1 -0
  156. package/dist/core/console-monitor.js +428 -0
  157. package/dist/core/console-monitor.js.map +1 -0
  158. package/dist/core/deep-component-tools.d.ts +14 -0
  159. package/dist/core/deep-component-tools.d.ts.map +1 -0
  160. package/dist/core/deep-component-tools.js +129 -0
  161. package/dist/core/deep-component-tools.js.map +1 -0
  162. package/dist/core/design-code-tools.d.ts +116 -0
  163. package/dist/core/design-code-tools.d.ts.map +1 -0
  164. package/dist/core/design-code-tools.js +2794 -0
  165. package/dist/core/design-code-tools.js.map +1 -0
  166. package/dist/core/design-system-manifest.d.ts +273 -0
  167. package/dist/core/design-system-manifest.d.ts.map +1 -0
  168. package/dist/core/design-system-manifest.js +266 -0
  169. package/dist/core/design-system-manifest.js.map +1 -0
  170. package/dist/core/design-system-tools.d.ts +67 -0
  171. package/dist/core/design-system-tools.d.ts.map +1 -0
  172. package/dist/core/design-system-tools.js +883 -0
  173. package/dist/core/design-system-tools.js.map +1 -0
  174. package/dist/core/diagnose-tool.d.ts +41 -0
  175. package/dist/core/diagnose-tool.d.ts.map +1 -0
  176. package/dist/core/diagnose-tool.js +101 -0
  177. package/dist/core/diagnose-tool.js.map +1 -0
  178. package/dist/core/diff/changelog-formatter.d.ts +35 -0
  179. package/dist/core/diff/changelog-formatter.d.ts.map +1 -0
  180. package/dist/core/diff/changelog-formatter.js +276 -0
  181. package/dist/core/diff/changelog-formatter.js.map +1 -0
  182. package/dist/core/diff/diff-engine.d.ts +127 -0
  183. package/dist/core/diff/diff-engine.d.ts.map +1 -0
  184. package/dist/core/diff/diff-engine.js +335 -0
  185. package/dist/core/diff/diff-engine.js.map +1 -0
  186. package/dist/core/diff/property-compare.d.ts +19 -0
  187. package/dist/core/diff/property-compare.d.ts.map +1 -0
  188. package/dist/core/diff/property-compare.js +37 -0
  189. package/dist/core/diff/property-compare.js.map +1 -0
  190. package/dist/core/diff/version-cache.d.ts +40 -0
  191. package/dist/core/diff/version-cache.d.ts.map +1 -0
  192. package/dist/core/diff/version-cache.js +75 -0
  193. package/dist/core/diff/version-cache.js.map +1 -0
  194. package/dist/core/enrichment/enrichment-service.d.ts +52 -0
  195. package/dist/core/enrichment/enrichment-service.d.ts.map +1 -0
  196. package/dist/core/enrichment/enrichment-service.js +375 -0
  197. package/dist/core/enrichment/enrichment-service.js.map +1 -0
  198. package/dist/core/enrichment/index.d.ts +8 -0
  199. package/dist/core/enrichment/index.d.ts.map +1 -0
  200. package/dist/core/enrichment/index.js +8 -0
  201. package/dist/core/enrichment/index.js.map +1 -0
  202. package/dist/core/enrichment/relationship-mapper.d.ts +106 -0
  203. package/dist/core/enrichment/relationship-mapper.d.ts.map +1 -0
  204. package/dist/core/enrichment/relationship-mapper.js +352 -0
  205. package/dist/core/enrichment/relationship-mapper.js.map +1 -0
  206. package/dist/core/enrichment/style-resolver.d.ts +85 -0
  207. package/dist/core/enrichment/style-resolver.d.ts.map +1 -0
  208. package/dist/core/enrichment/style-resolver.js +347 -0
  209. package/dist/core/enrichment/style-resolver.js.map +1 -0
  210. package/dist/core/figjam-tools.d.ts +8 -0
  211. package/dist/core/figjam-tools.d.ts.map +1 -0
  212. package/dist/core/figjam-tools.js +548 -0
  213. package/dist/core/figjam-tools.js.map +1 -0
  214. package/dist/core/figma-api.d.ts +254 -0
  215. package/dist/core/figma-api.d.ts.map +1 -0
  216. package/dist/core/figma-api.js +510 -0
  217. package/dist/core/figma-api.js.map +1 -0
  218. package/dist/core/figma-connector.d.ts +214 -0
  219. package/dist/core/figma-connector.d.ts.map +1 -0
  220. package/dist/core/figma-connector.js +8 -0
  221. package/dist/core/figma-connector.js.map +1 -0
  222. package/dist/core/figma-desktop-connector.d.ts +312 -0
  223. package/dist/core/figma-desktop-connector.d.ts.map +1 -0
  224. package/dist/core/figma-desktop-connector.js +1298 -0
  225. package/dist/core/figma-desktop-connector.js.map +1 -0
  226. package/dist/core/figma-reconstruction-spec.d.ts +166 -0
  227. package/dist/core/figma-reconstruction-spec.d.ts.map +1 -0
  228. package/dist/core/figma-reconstruction-spec.js +403 -0
  229. package/dist/core/figma-reconstruction-spec.js.map +1 -0
  230. package/dist/core/figma-style-extractor.d.ts +76 -0
  231. package/dist/core/figma-style-extractor.d.ts.map +1 -0
  232. package/dist/core/figma-style-extractor.js +312 -0
  233. package/dist/core/figma-style-extractor.js.map +1 -0
  234. package/dist/core/figma-tools.d.ts +22 -0
  235. package/dist/core/figma-tools.d.ts.map +1 -0
  236. package/dist/core/figma-tools.js +3303 -0
  237. package/dist/core/figma-tools.js.map +1 -0
  238. package/dist/core/identity.d.ts +41 -0
  239. package/dist/core/identity.d.ts.map +1 -0
  240. package/dist/core/identity.js +97 -0
  241. package/dist/core/identity.js.map +1 -0
  242. package/dist/core/library-tools.d.ts +17 -0
  243. package/dist/core/library-tools.d.ts.map +1 -0
  244. package/dist/core/library-tools.js +581 -0
  245. package/dist/core/library-tools.js.map +1 -0
  246. package/dist/core/logger.d.ts +22 -0
  247. package/dist/core/logger.d.ts.map +1 -0
  248. package/dist/core/logger.js +54 -0
  249. package/dist/core/logger.js.map +1 -0
  250. package/dist/core/port-discovery.d.ts +211 -0
  251. package/dist/core/port-discovery.d.ts.map +1 -0
  252. package/dist/core/port-discovery.js +936 -0
  253. package/dist/core/port-discovery.js.map +1 -0
  254. package/dist/core/resolve-package-root.d.ts +2 -0
  255. package/dist/core/resolve-package-root.d.ts.map +1 -0
  256. package/dist/core/resolve-package-root.js +12 -0
  257. package/dist/core/resolve-package-root.js.map +1 -0
  258. package/dist/core/slides-tools.d.ts +8 -0
  259. package/dist/core/slides-tools.d.ts.map +1 -0
  260. package/dist/core/slides-tools.js +715 -0
  261. package/dist/core/slides-tools.js.map +1 -0
  262. package/dist/core/slot-tools.d.ts +7 -0
  263. package/dist/core/slot-tools.d.ts.map +1 -0
  264. package/dist/core/slot-tools.js +335 -0
  265. package/dist/core/slot-tools.js.map +1 -0
  266. package/dist/core/snippet-injector.d.ts +24 -0
  267. package/dist/core/snippet-injector.d.ts.map +1 -0
  268. package/dist/core/snippet-injector.js +97 -0
  269. package/dist/core/snippet-injector.js.map +1 -0
  270. package/dist/core/tokens/alias-resolver.d.ts +97 -0
  271. package/dist/core/tokens/alias-resolver.d.ts.map +1 -0
  272. package/dist/core/tokens/alias-resolver.js +206 -0
  273. package/dist/core/tokens/alias-resolver.js.map +1 -0
  274. package/dist/core/tokens/config.d.ts +380 -0
  275. package/dist/core/tokens/config.d.ts.map +1 -0
  276. package/dist/core/tokens/config.js +295 -0
  277. package/dist/core/tokens/config.js.map +1 -0
  278. package/dist/core/tokens/dialect.d.ts +107 -0
  279. package/dist/core/tokens/dialect.d.ts.map +1 -0
  280. package/dist/core/tokens/dialect.js +233 -0
  281. package/dist/core/tokens/dialect.js.map +1 -0
  282. package/dist/core/tokens/figma-converter.d.ts +102 -0
  283. package/dist/core/tokens/figma-converter.d.ts.map +1 -0
  284. package/dist/core/tokens/figma-converter.js +324 -0
  285. package/dist/core/tokens/figma-converter.js.map +1 -0
  286. package/dist/core/tokens/formatters/css-vars.d.ts +24 -0
  287. package/dist/core/tokens/formatters/css-vars.d.ts.map +1 -0
  288. package/dist/core/tokens/formatters/css-vars.js +339 -0
  289. package/dist/core/tokens/formatters/css-vars.js.map +1 -0
  290. package/dist/core/tokens/formatters/dtcg.d.ts +28 -0
  291. package/dist/core/tokens/formatters/dtcg.d.ts.map +1 -0
  292. package/dist/core/tokens/formatters/dtcg.js +377 -0
  293. package/dist/core/tokens/formatters/dtcg.js.map +1 -0
  294. package/dist/core/tokens/formatters/index.d.ts +30 -0
  295. package/dist/core/tokens/formatters/index.d.ts.map +1 -0
  296. package/dist/core/tokens/formatters/index.js +46 -0
  297. package/dist/core/tokens/formatters/index.js.map +1 -0
  298. package/dist/core/tokens/formatters/json.d.ts +37 -0
  299. package/dist/core/tokens/formatters/json.d.ts.map +1 -0
  300. package/dist/core/tokens/formatters/json.js +206 -0
  301. package/dist/core/tokens/formatters/json.js.map +1 -0
  302. package/dist/core/tokens/formatters/less.d.ts +4 -0
  303. package/dist/core/tokens/formatters/less.d.ts.map +1 -0
  304. package/dist/core/tokens/formatters/less.js +5 -0
  305. package/dist/core/tokens/formatters/less.js.map +1 -0
  306. package/dist/core/tokens/formatters/scss.d.ts +26 -0
  307. package/dist/core/tokens/formatters/scss.d.ts.map +1 -0
  308. package/dist/core/tokens/formatters/scss.js +259 -0
  309. package/dist/core/tokens/formatters/scss.js.map +1 -0
  310. package/dist/core/tokens/formatters/stubs.d.ts +9 -0
  311. package/dist/core/tokens/formatters/stubs.d.ts.map +1 -0
  312. package/dist/core/tokens/formatters/stubs.js +14 -0
  313. package/dist/core/tokens/formatters/stubs.js.map +1 -0
  314. package/dist/core/tokens/formatters/style-dictionary-v3.d.ts +45 -0
  315. package/dist/core/tokens/formatters/style-dictionary-v3.d.ts.map +1 -0
  316. package/dist/core/tokens/formatters/style-dictionary-v3.js +214 -0
  317. package/dist/core/tokens/formatters/style-dictionary-v3.js.map +1 -0
  318. package/dist/core/tokens/formatters/tailwind-v3.d.ts +37 -0
  319. package/dist/core/tokens/formatters/tailwind-v3.d.ts.map +1 -0
  320. package/dist/core/tokens/formatters/tailwind-v3.js +238 -0
  321. package/dist/core/tokens/formatters/tailwind-v3.js.map +1 -0
  322. package/dist/core/tokens/formatters/tailwind-v4.d.ts +41 -0
  323. package/dist/core/tokens/formatters/tailwind-v4.d.ts.map +1 -0
  324. package/dist/core/tokens/formatters/tailwind-v4.js +336 -0
  325. package/dist/core/tokens/formatters/tailwind-v4.js.map +1 -0
  326. package/dist/core/tokens/formatters/tokens-studio.d.ts +44 -0
  327. package/dist/core/tokens/formatters/tokens-studio.d.ts.map +1 -0
  328. package/dist/core/tokens/formatters/tokens-studio.js +257 -0
  329. package/dist/core/tokens/formatters/tokens-studio.js.map +1 -0
  330. package/dist/core/tokens/formatters/ts-module.d.ts +35 -0
  331. package/dist/core/tokens/formatters/ts-module.d.ts.map +1 -0
  332. package/dist/core/tokens/formatters/ts-module.js +199 -0
  333. package/dist/core/tokens/formatters/ts-module.js.map +1 -0
  334. package/dist/core/tokens/index.d.ts +18 -0
  335. package/dist/core/tokens/index.d.ts.map +1 -0
  336. package/dist/core/tokens/index.js +17 -0
  337. package/dist/core/tokens/index.js.map +1 -0
  338. package/dist/core/tokens/parsers/css-vars.d.ts +3 -0
  339. package/dist/core/tokens/parsers/css-vars.d.ts.map +1 -0
  340. package/dist/core/tokens/parsers/css-vars.js +5 -0
  341. package/dist/core/tokens/parsers/css-vars.js.map +1 -0
  342. package/dist/core/tokens/parsers/dtcg.d.ts +21 -0
  343. package/dist/core/tokens/parsers/dtcg.d.ts.map +1 -0
  344. package/dist/core/tokens/parsers/dtcg.js +281 -0
  345. package/dist/core/tokens/parsers/dtcg.js.map +1 -0
  346. package/dist/core/tokens/parsers/index.d.ts +37 -0
  347. package/dist/core/tokens/parsers/index.d.ts.map +1 -0
  348. package/dist/core/tokens/parsers/index.js +139 -0
  349. package/dist/core/tokens/parsers/index.js.map +1 -0
  350. package/dist/core/tokens/parsers/json.d.ts +4 -0
  351. package/dist/core/tokens/parsers/json.d.ts.map +1 -0
  352. package/dist/core/tokens/parsers/json.js +8 -0
  353. package/dist/core/tokens/parsers/json.js.map +1 -0
  354. package/dist/core/tokens/parsers/scss.d.ts +3 -0
  355. package/dist/core/tokens/parsers/scss.d.ts.map +1 -0
  356. package/dist/core/tokens/parsers/scss.js +5 -0
  357. package/dist/core/tokens/parsers/scss.js.map +1 -0
  358. package/dist/core/tokens/parsers/stubs.d.ts +15 -0
  359. package/dist/core/tokens/parsers/stubs.d.ts.map +1 -0
  360. package/dist/core/tokens/parsers/stubs.js +21 -0
  361. package/dist/core/tokens/parsers/stubs.js.map +1 -0
  362. package/dist/core/tokens/parsers/style-dictionary-v3.d.ts +3 -0
  363. package/dist/core/tokens/parsers/style-dictionary-v3.d.ts.map +1 -0
  364. package/dist/core/tokens/parsers/style-dictionary-v3.js +5 -0
  365. package/dist/core/tokens/parsers/style-dictionary-v3.js.map +1 -0
  366. package/dist/core/tokens/parsers/tailwind-v3.d.ts +3 -0
  367. package/dist/core/tokens/parsers/tailwind-v3.d.ts.map +1 -0
  368. package/dist/core/tokens/parsers/tailwind-v3.js +5 -0
  369. package/dist/core/tokens/parsers/tailwind-v3.js.map +1 -0
  370. package/dist/core/tokens/parsers/tailwind-v4.d.ts +3 -0
  371. package/dist/core/tokens/parsers/tailwind-v4.d.ts.map +1 -0
  372. package/dist/core/tokens/parsers/tailwind-v4.js +5 -0
  373. package/dist/core/tokens/parsers/tailwind-v4.js.map +1 -0
  374. package/dist/core/tokens/parsers/tokens-studio.d.ts +3 -0
  375. package/dist/core/tokens/parsers/tokens-studio.d.ts.map +1 -0
  376. package/dist/core/tokens/parsers/tokens-studio.js +5 -0
  377. package/dist/core/tokens/parsers/tokens-studio.js.map +1 -0
  378. package/dist/core/tokens/schemas.d.ts +155 -0
  379. package/dist/core/tokens/schemas.d.ts.map +1 -0
  380. package/dist/core/tokens/schemas.js +153 -0
  381. package/dist/core/tokens/schemas.js.map +1 -0
  382. package/dist/core/tokens/transforms/color.d.ts +9 -0
  383. package/dist/core/tokens/transforms/color.d.ts.map +1 -0
  384. package/dist/core/tokens/transforms/color.js +13 -0
  385. package/dist/core/tokens/transforms/color.js.map +1 -0
  386. package/dist/core/tokens/transforms/index.d.ts +36 -0
  387. package/dist/core/tokens/transforms/index.d.ts.map +1 -0
  388. package/dist/core/tokens/transforms/index.js +30 -0
  389. package/dist/core/tokens/transforms/index.js.map +1 -0
  390. package/dist/core/tokens/transforms/size.d.ts +7 -0
  391. package/dist/core/tokens/transforms/size.d.ts.map +1 -0
  392. package/dist/core/tokens/transforms/size.js +8 -0
  393. package/dist/core/tokens/transforms/size.js.map +1 -0
  394. package/dist/core/tokens/types.d.ts +284 -0
  395. package/dist/core/tokens/types.d.ts.map +1 -0
  396. package/dist/core/tokens/types.js +19 -0
  397. package/dist/core/tokens/types.js.map +1 -0
  398. package/dist/core/tokens-tools.d.ts +285 -0
  399. package/dist/core/tokens-tools.d.ts.map +1 -0
  400. package/dist/core/tokens-tools.js +1789 -0
  401. package/dist/core/tokens-tools.js.map +1 -0
  402. package/dist/core/types/design-code.d.ts +271 -0
  403. package/dist/core/types/design-code.d.ts.map +1 -0
  404. package/dist/core/types/design-code.js +5 -0
  405. package/dist/core/types/design-code.js.map +1 -0
  406. package/dist/core/types/enriched.d.ts +213 -0
  407. package/dist/core/types/enriched.d.ts.map +1 -0
  408. package/dist/core/types/enriched.js +6 -0
  409. package/dist/core/types/enriched.js.map +1 -0
  410. package/dist/core/types/index.d.ts +104 -0
  411. package/dist/core/types/index.d.ts.map +1 -0
  412. package/dist/core/types/index.js +5 -0
  413. package/dist/core/types/index.js.map +1 -0
  414. package/dist/core/variable-resolver.d.ts +45 -0
  415. package/dist/core/variable-resolver.d.ts.map +1 -0
  416. package/dist/core/variable-resolver.js +86 -0
  417. package/dist/core/variable-resolver.js.map +1 -0
  418. package/dist/core/version-tools.d.ts +59 -0
  419. package/dist/core/version-tools.d.ts.map +1 -0
  420. package/dist/core/version-tools.js +1200 -0
  421. package/dist/core/version-tools.js.map +1 -0
  422. package/dist/core/websocket-connector.d.ts +247 -0
  423. package/dist/core/websocket-connector.d.ts.map +1 -0
  424. package/dist/core/websocket-connector.js +437 -0
  425. package/dist/core/websocket-connector.js.map +1 -0
  426. package/dist/core/websocket-server.d.ts +290 -0
  427. package/dist/core/websocket-server.d.ts.map +1 -0
  428. package/dist/core/websocket-server.js +957 -0
  429. package/dist/core/websocket-server.js.map +1 -0
  430. package/dist/core/write-tools.d.ts +7 -0
  431. package/dist/core/write-tools.d.ts.map +1 -0
  432. package/dist/core/write-tools.js +2507 -0
  433. package/dist/core/write-tools.js.map +1 -0
  434. package/dist/local.d.ts +105 -0
  435. package/dist/local.d.ts.map +1 -0
  436. package/dist/local.js +3314 -0
  437. package/dist/local.js.map +1 -0
  438. package/figma-desktop-bridge/README.md +365 -0
  439. package/figma-desktop-bridge/code.js +7359 -0
  440. package/figma-desktop-bridge/icon.png +0 -0
  441. package/figma-desktop-bridge/manifest.json +67 -0
  442. package/figma-desktop-bridge/ui.html +2783 -0
  443. package/package.json +103 -0
@@ -0,0 +1,127 @@
1
+ /**
2
+ * Diff engine — pure functions for comparing Figma file/node snapshots
3
+ * across two versions.
4
+ *
5
+ * Scope (v1):
6
+ * - Page-structure diff (added/removed/renamed pages) from depth=1 file fetches
7
+ * - Per-node diff for scoped fetches: name, description, children added/removed,
8
+ * componentPropertyDefinitions changes (for COMPONENT_SET), boundVariables changes
9
+ *
10
+ * NOT in scope (deferred):
11
+ * - Variable VALUE history (Figma REST does not expose this; planned forward
12
+ * ledger will fill the gap going forward, never retroactively)
13
+ * - Style-content diffs (only style add/remove via reachable styles map)
14
+ * - Inside-fills/strokes binding diffs (top-level boundVariables only for v1)
15
+ */
16
+ export type DiffMode = "summary" | "standard" | "detailed";
17
+ export interface PageEntry {
18
+ id: string;
19
+ name: string;
20
+ }
21
+ export interface PageStructureDiff {
22
+ pages_added: PageEntry[];
23
+ pages_removed: PageEntry[];
24
+ pages_renamed: Array<{
25
+ id: string;
26
+ old_name: string;
27
+ new_name: string;
28
+ }>;
29
+ summary: {
30
+ added: number;
31
+ removed: number;
32
+ renamed: number;
33
+ };
34
+ }
35
+ /**
36
+ * Compare two file documents (from /v1/files/:key?version=X with depth=1 or higher).
37
+ * Both arguments should be the `document` field of a Figma file response.
38
+ */
39
+ export declare function diffPageStructure(fromDoc: any, toDoc: any): PageStructureDiff;
40
+ export interface PropertyDefSummary {
41
+ name: string;
42
+ type: string;
43
+ default_value: any;
44
+ }
45
+ export interface ComponentPropertyDefDiff {
46
+ added: PropertyDefSummary[];
47
+ removed: PropertyDefSummary[];
48
+ type_changed: Array<{
49
+ name: string;
50
+ from_type: string;
51
+ to_type: string;
52
+ }>;
53
+ default_changed: Array<{
54
+ name: string;
55
+ from_default: any;
56
+ to_default: any;
57
+ }>;
58
+ summary: {
59
+ added: number;
60
+ removed: number;
61
+ type_changed: number;
62
+ default_changed: number;
63
+ };
64
+ }
65
+ /**
66
+ * Diff a COMPONENT_SET's componentPropertyDefinitions map.
67
+ * Each definition is keyed by `propName#nodeId` in Figma's response.
68
+ */
69
+ export declare function diffComponentPropertyDefinitions(fromDefs: Record<string, any> | undefined, toDefs: Record<string, any> | undefined): ComponentPropertyDefDiff;
70
+ export interface BindingChange {
71
+ node_id: string;
72
+ node_name: string;
73
+ property: string;
74
+ from_variable_id: string | null;
75
+ to_variable_id: string | null;
76
+ change_kind: "added" | "removed" | "rebound";
77
+ }
78
+ /**
79
+ * Walk both node trees in parallel (matched by node id), comparing top-level
80
+ * boundVariables. Inside-fills/strokes binding diffs are explicitly NOT included
81
+ * in v1 — they add complexity for marginal additional value over node-level deltas.
82
+ */
83
+ export declare function collectBindingChanges(fromNode: any, toNode: any): BindingChange[];
84
+ export interface NodeChildSummary {
85
+ id: string;
86
+ name: string;
87
+ type: string;
88
+ }
89
+ /**
90
+ * v1.25.0: a metadata-only change captured via the Plugin API session buffer.
91
+ * Surfaces description/annotation edits that Figma REST doesn't expose in
92
+ * version snapshots. Populated when the diff time window overlaps with
93
+ * buffered plugin events; absent/empty otherwise.
94
+ */
95
+ export interface MetadataChange {
96
+ field: "description" | "annotations";
97
+ new_value: any;
98
+ timestamp: number;
99
+ source: "plugin_buffer";
100
+ }
101
+ export interface NodeDiff {
102
+ node_id: string;
103
+ node_name: string;
104
+ node_type: string;
105
+ name_changed: {
106
+ from: string;
107
+ to: string;
108
+ } | null;
109
+ description_changed: {
110
+ from: string;
111
+ to: string;
112
+ } | null;
113
+ children_added: NodeChildSummary[];
114
+ children_removed: NodeChildSummary[];
115
+ component_properties: ComponentPropertyDefDiff | null;
116
+ binding_changes: BindingChange[];
117
+ /** v1.25.0: description/annotation changes captured via plugin session buffer */
118
+ metadata_changes?: MetadataChange[];
119
+ change_count: number;
120
+ notes: string[];
121
+ }
122
+ /**
123
+ * Diff a single node (typically a COMPONENT_SET) at depth=2. Either side may be
124
+ * null/undefined to represent "newly added" or "removed entirely."
125
+ */
126
+ export declare function diffNode(fromNode: any, toNode: any, mode?: DiffMode): NodeDiff;
127
+ //# sourceMappingURL=diff-engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diff-engine.d.ts","sourceRoot":"","sources":["../../../src/core/diff/diff-engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,335 @@
1
+ /**
2
+ * Diff engine — pure functions for comparing Figma file/node snapshots
3
+ * across two versions.
4
+ *
5
+ * Scope (v1):
6
+ * - Page-structure diff (added/removed/renamed pages) from depth=1 file fetches
7
+ * - Per-node diff for scoped fetches: name, description, children added/removed,
8
+ * componentPropertyDefinitions changes (for COMPONENT_SET), boundVariables changes
9
+ *
10
+ * NOT in scope (deferred):
11
+ * - Variable VALUE history (Figma REST does not expose this; planned forward
12
+ * ledger will fill the gap going forward, never retroactively)
13
+ * - Style-content diffs (only style add/remove via reachable styles map)
14
+ * - Inside-fills/strokes binding diffs (top-level boundVariables only for v1)
15
+ */
16
+ /**
17
+ * Compare two file documents (from /v1/files/:key?version=X with depth=1 or higher).
18
+ * Both arguments should be the `document` field of a Figma file response.
19
+ */
20
+ export function diffPageStructure(fromDoc, toDoc) {
21
+ const fromPages = extractPages(fromDoc);
22
+ const toPages = extractPages(toDoc);
23
+ const fromById = new Map(fromPages.map((p) => [p.id, p]));
24
+ const toById = new Map(toPages.map((p) => [p.id, p]));
25
+ const added = [];
26
+ const removed = [];
27
+ const renamed = [];
28
+ for (const p of toPages) {
29
+ if (!fromById.has(p.id)) {
30
+ added.push(p);
31
+ }
32
+ else {
33
+ const old = fromById.get(p.id);
34
+ if (old.name !== p.name) {
35
+ renamed.push({ id: p.id, old_name: old.name, new_name: p.name });
36
+ }
37
+ }
38
+ }
39
+ for (const p of fromPages) {
40
+ if (!toById.has(p.id))
41
+ removed.push(p);
42
+ }
43
+ return {
44
+ pages_added: added,
45
+ pages_removed: removed,
46
+ pages_renamed: renamed,
47
+ summary: {
48
+ added: added.length,
49
+ removed: removed.length,
50
+ renamed: renamed.length,
51
+ },
52
+ };
53
+ }
54
+ function extractPages(doc) {
55
+ const children = doc?.children;
56
+ if (!Array.isArray(children))
57
+ return [];
58
+ return children
59
+ .filter((c) => c && typeof c.id === "string" && typeof c.name === "string")
60
+ .map((c) => ({ id: c.id, name: c.name }));
61
+ }
62
+ /**
63
+ * Diff a COMPONENT_SET's componentPropertyDefinitions map.
64
+ * Each definition is keyed by `propName#nodeId` in Figma's response.
65
+ */
66
+ export function diffComponentPropertyDefinitions(fromDefs, toDefs) {
67
+ const from = fromDefs ?? {};
68
+ const to = toDefs ?? {};
69
+ const added = [];
70
+ const removed = [];
71
+ const typeChanged = [];
72
+ const defaultChanged = [];
73
+ for (const key of Object.keys(to)) {
74
+ const toDef = to[key];
75
+ if (!(key in from)) {
76
+ added.push({ name: key, type: toDef.type, default_value: toDef.defaultValue });
77
+ }
78
+ else {
79
+ const fromDef = from[key];
80
+ if (fromDef.type !== toDef.type) {
81
+ typeChanged.push({ name: key, from_type: fromDef.type, to_type: toDef.type });
82
+ }
83
+ if (!deepEqual(fromDef.defaultValue, toDef.defaultValue)) {
84
+ defaultChanged.push({
85
+ name: key,
86
+ from_default: fromDef.defaultValue,
87
+ to_default: toDef.defaultValue,
88
+ });
89
+ }
90
+ }
91
+ }
92
+ for (const key of Object.keys(from)) {
93
+ if (!(key in to)) {
94
+ const fromDef = from[key];
95
+ removed.push({ name: key, type: fromDef.type, default_value: fromDef.defaultValue });
96
+ }
97
+ }
98
+ return {
99
+ added,
100
+ removed,
101
+ type_changed: typeChanged,
102
+ default_changed: defaultChanged,
103
+ summary: {
104
+ added: added.length,
105
+ removed: removed.length,
106
+ type_changed: typeChanged.length,
107
+ default_changed: defaultChanged.length,
108
+ },
109
+ };
110
+ }
111
+ /**
112
+ * Walk both node trees in parallel (matched by node id), comparing top-level
113
+ * boundVariables. Inside-fills/strokes binding diffs are explicitly NOT included
114
+ * in v1 — they add complexity for marginal additional value over node-level deltas.
115
+ */
116
+ export function collectBindingChanges(fromNode, toNode) {
117
+ const changes = [];
118
+ walkBoth(fromNode, toNode, (a, b) => {
119
+ const aBindings = extractTopLevelBindings(a);
120
+ const bBindings = extractTopLevelBindings(b);
121
+ const allKeys = new Set([...Object.keys(aBindings), ...Object.keys(bBindings)]);
122
+ for (const key of allKeys) {
123
+ const fromId = aBindings[key] ?? null;
124
+ const toId = bBindings[key] ?? null;
125
+ if (fromId === toId)
126
+ continue;
127
+ let kind;
128
+ if (fromId === null)
129
+ kind = "added";
130
+ else if (toId === null)
131
+ kind = "removed";
132
+ else
133
+ kind = "rebound";
134
+ changes.push({
135
+ node_id: (b ?? a).id,
136
+ node_name: (b ?? a).name ?? "",
137
+ property: key,
138
+ from_variable_id: fromId,
139
+ to_variable_id: toId,
140
+ change_kind: kind,
141
+ });
142
+ }
143
+ });
144
+ return changes;
145
+ }
146
+ function extractTopLevelBindings(node) {
147
+ const out = {};
148
+ const bv = node?.boundVariables;
149
+ if (!bv || typeof bv !== "object")
150
+ return out;
151
+ for (const [prop, ref] of Object.entries(bv)) {
152
+ if (ref && typeof ref === "object") {
153
+ // Single VARIABLE_ALIAS reference
154
+ if (ref.type === "VARIABLE_ALIAS" && typeof ref.id === "string") {
155
+ out[prop] = ref.id;
156
+ continue;
157
+ }
158
+ // Array of refs (e.g., fills binding can be an array — surface first match for v1)
159
+ if (Array.isArray(ref)) {
160
+ const first = ref.find((r) => r && r.type === "VARIABLE_ALIAS" && typeof r.id === "string");
161
+ if (first)
162
+ out[`${prop}[0]`] = first.id;
163
+ }
164
+ }
165
+ }
166
+ return out;
167
+ }
168
+ function walkBoth(fromNode, toNode, visit) {
169
+ if (!fromNode && !toNode)
170
+ return;
171
+ visit(fromNode, toNode);
172
+ const fromChildren = Array.isArray(fromNode?.children) ? fromNode.children : [];
173
+ const toChildren = Array.isArray(toNode?.children) ? toNode.children : [];
174
+ const byIdFrom = new Map();
175
+ for (const c of fromChildren)
176
+ if (c?.id)
177
+ byIdFrom.set(c.id, c);
178
+ const byIdTo = new Map();
179
+ for (const c of toChildren)
180
+ if (c?.id)
181
+ byIdTo.set(c.id, c);
182
+ const allIds = new Set([...byIdFrom.keys(), ...byIdTo.keys()]);
183
+ for (const id of allIds) {
184
+ walkBoth(byIdFrom.get(id), byIdTo.get(id), visit);
185
+ }
186
+ }
187
+ /**
188
+ * Diff a single node (typically a COMPONENT_SET) at depth=2. Either side may be
189
+ * null/undefined to represent "newly added" or "removed entirely."
190
+ */
191
+ export function diffNode(fromNode, toNode, mode = "standard") {
192
+ const id = (toNode ?? fromNode)?.id ?? "";
193
+ const name = (toNode ?? fromNode)?.name ?? "";
194
+ const type = (toNode ?? fromNode)?.type ?? "";
195
+ const out = {
196
+ node_id: id,
197
+ node_name: name,
198
+ node_type: type,
199
+ name_changed: null,
200
+ description_changed: null,
201
+ children_added: [],
202
+ children_removed: [],
203
+ component_properties: null,
204
+ binding_changes: [],
205
+ change_count: 0,
206
+ notes: [],
207
+ };
208
+ if (!fromNode && toNode) {
209
+ out.notes.push("Node was added in the target version (no prior state to compare).");
210
+ out.change_count = 1;
211
+ return out;
212
+ }
213
+ if (fromNode && !toNode) {
214
+ out.notes.push("Node was removed in the target version (no later state to compare).");
215
+ out.change_count = 1;
216
+ return out;
217
+ }
218
+ if (!fromNode && !toNode) {
219
+ out.notes.push("Node not found in either version.");
220
+ return out;
221
+ }
222
+ if (fromNode.name !== toNode.name) {
223
+ out.name_changed = { from: fromNode.name, to: toNode.name };
224
+ }
225
+ if ((fromNode.description ?? "") !== (toNode.description ?? "")) {
226
+ out.description_changed = {
227
+ from: fromNode.description ?? "",
228
+ to: toNode.description ?? "",
229
+ };
230
+ }
231
+ const fromChildIds = new Set((fromNode.children ?? []).filter((c) => c?.id).map((c) => c.id));
232
+ const toChildIds = new Set((toNode.children ?? []).filter((c) => c?.id).map((c) => c.id));
233
+ for (const c of toNode.children ?? []) {
234
+ if (c?.id && !fromChildIds.has(c.id)) {
235
+ out.children_added.push({ id: c.id, name: c.name ?? "", type: c.type ?? "" });
236
+ }
237
+ }
238
+ for (const c of fromNode.children ?? []) {
239
+ if (c?.id && !toChildIds.has(c.id)) {
240
+ out.children_removed.push({ id: c.id, name: c.name ?? "", type: c.type ?? "" });
241
+ }
242
+ }
243
+ if (fromNode.type === "COMPONENT_SET" || toNode.type === "COMPONENT_SET") {
244
+ const propDiff = diffComponentPropertyDefinitions(fromNode.componentPropertyDefinitions, toNode.componentPropertyDefinitions);
245
+ const hasAny = propDiff.summary.added > 0 ||
246
+ propDiff.summary.removed > 0 ||
247
+ propDiff.summary.type_changed > 0 ||
248
+ propDiff.summary.default_changed > 0;
249
+ if (hasAny)
250
+ out.component_properties = propDiff;
251
+ }
252
+ out.binding_changes = collectBindingChanges(fromNode, toNode);
253
+ out.change_count =
254
+ (out.name_changed ? 1 : 0) +
255
+ (out.description_changed ? 1 : 0) +
256
+ out.children_added.length +
257
+ out.children_removed.length +
258
+ (out.component_properties
259
+ ? out.component_properties.summary.added +
260
+ out.component_properties.summary.removed +
261
+ out.component_properties.summary.type_changed +
262
+ out.component_properties.summary.default_changed
263
+ : 0) +
264
+ out.binding_changes.length;
265
+ if (mode === "summary") {
266
+ // Strip detail arrays, keep counts only
267
+ out.children_added = [];
268
+ out.children_removed = [];
269
+ if (out.component_properties) {
270
+ out.component_properties = {
271
+ added: [],
272
+ removed: [],
273
+ type_changed: [],
274
+ default_changed: [],
275
+ summary: out.component_properties.summary,
276
+ };
277
+ }
278
+ out.binding_changes = [];
279
+ }
280
+ else if (mode === "standard") {
281
+ // Keep the lightweight summaries (children_added, children_removed,
282
+ // component_properties.summary). Strip the heavy detail arrays.
283
+ if (out.component_properties) {
284
+ out.component_properties = {
285
+ added: out.component_properties.added.map((p) => ({ ...p, default_value: undefined })),
286
+ removed: out.component_properties.removed.map((p) => ({
287
+ ...p,
288
+ default_value: undefined,
289
+ })),
290
+ type_changed: out.component_properties.type_changed,
291
+ default_changed: out.component_properties.default_changed.map((d) => ({
292
+ name: d.name,
293
+ from_default: undefined,
294
+ to_default: undefined,
295
+ })),
296
+ summary: out.component_properties.summary,
297
+ };
298
+ }
299
+ // Bindings: keep as-is, they're already compact.
300
+ }
301
+ // mode === "detailed" → keep everything
302
+ return out;
303
+ }
304
+ // ============================================================================
305
+ // Helpers
306
+ // ============================================================================
307
+ function deepEqual(a, b) {
308
+ if (a === b)
309
+ return true;
310
+ if (a === null || b === null)
311
+ return false;
312
+ if (typeof a !== typeof b)
313
+ return false;
314
+ if (typeof a !== "object")
315
+ return false;
316
+ if (Array.isArray(a) !== Array.isArray(b))
317
+ return false;
318
+ if (Array.isArray(a)) {
319
+ if (a.length !== b.length)
320
+ return false;
321
+ for (let i = 0; i < a.length; i++)
322
+ if (!deepEqual(a[i], b[i]))
323
+ return false;
324
+ return true;
325
+ }
326
+ const aKeys = Object.keys(a);
327
+ const bKeys = Object.keys(b);
328
+ if (aKeys.length !== bKeys.length)
329
+ return false;
330
+ for (const k of aKeys)
331
+ if (!deepEqual(a[k], b[k]))
332
+ return false;
333
+ return true;
334
+ }
335
+ //# sourceMappingURL=diff-engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diff-engine.js","sourceRoot":"","sources":["../../../src/core/diff/diff-engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Property comparison primitives.
3
+ *
4
+ * Pure helper functions used by both the design-code parity tools and
5
+ * the version diff engine. Moved here from src/core/design-code-tools.ts
6
+ * so multiple consumers can share without circular dependencies.
7
+ */
8
+ /** Convert Figma RGBA (0-1 floats) to hex string */
9
+ export declare function figmaRGBAToHex(color: {
10
+ r: number;
11
+ g: number;
12
+ b: number;
13
+ a?: number;
14
+ }): string;
15
+ /** Normalize a color string for comparison (uppercase hex without alpha if fully opaque) */
16
+ export declare function normalizeColor(color: string): string;
17
+ /** Compare numeric values with a tolerance */
18
+ export declare function numericClose(a: number, b: number, tolerance?: number): boolean;
19
+ //# sourceMappingURL=property-compare.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"property-compare.d.ts","sourceRoot":"","sources":["../../../src/core/diff/property-compare.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAU7F;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWpD;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,OAAO,CAEjF"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Property comparison primitives.
3
+ *
4
+ * Pure helper functions used by both the design-code parity tools and
5
+ * the version diff engine. Moved here from src/core/design-code-tools.ts
6
+ * so multiple consumers can share without circular dependencies.
7
+ */
8
+ /** Convert Figma RGBA (0-1 floats) to hex string */
9
+ export function figmaRGBAToHex(color) {
10
+ const r = Math.round(color.r * 255);
11
+ const g = Math.round(color.g * 255);
12
+ const b = Math.round(color.b * 255);
13
+ const hex = `#${r.toString(16).padStart(2, "0")}${g.toString(16).padStart(2, "0")}${b.toString(16).padStart(2, "0")}`.toUpperCase();
14
+ if (color.a !== undefined && color.a < 1) {
15
+ const a = Math.round(color.a * 255);
16
+ return `${hex}${a.toString(16).padStart(2, "0")}`;
17
+ }
18
+ return hex;
19
+ }
20
+ /** Normalize a color string for comparison (uppercase hex without alpha if fully opaque) */
21
+ export function normalizeColor(color) {
22
+ let c = color.trim().toUpperCase();
23
+ // Strip alpha if fully opaque (FF)
24
+ if (c.length === 9 && c.endsWith("FF")) {
25
+ c = c.slice(0, 7);
26
+ }
27
+ // Expand shorthand (#RGB -> #RRGGBB)
28
+ if (/^#[0-9A-F]{3}$/.test(c)) {
29
+ c = `#${c[1]}${c[1]}${c[2]}${c[2]}${c[3]}${c[3]}`;
30
+ }
31
+ return c;
32
+ }
33
+ /** Compare numeric values with a tolerance */
34
+ export function numericClose(a, b, tolerance = 1) {
35
+ return Math.abs(a - b) <= tolerance;
36
+ }
37
+ //# sourceMappingURL=property-compare.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"property-compare.js","sourceRoot":"","sources":["../../../src/core/diff/property-compare.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oDAAoD;AACpD,MAAM,UAAU,cAAc,CAAC,KAAsD;IACpF,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IACpI,IAAI,KAAK,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACpC,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,KAAa;IAC3C,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,mCAAmC;IACnC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,qCAAqC;IACrC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9B,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS,EAAE,YAAoB,CAAC;IACvE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;AACrC,CAAC"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * In-memory LRU cache for Figma file snapshots at past versions.
3
+ *
4
+ * Past versions are immutable, so a cached snapshot for `${fileKey}:${versionId}`
5
+ * never goes stale. The cache is process-scoped (no persistence) and bounded by
6
+ * a max-entries cap rather than a byte budget — keeps the implementation simple
7
+ * and avoids assumptions about JSON serialization size.
8
+ *
9
+ * HEAD ("current") is intentionally NOT cached because it changes on every save.
10
+ * Callers should pass `null` as the versionId for HEAD requests; the cache
11
+ * methods short-circuit on null.
12
+ *
13
+ * Usage:
14
+ * const cache = new VersionSnapshotCache();
15
+ * const key = cache.makeKey(fileKey, versionId, depth, nodeIds);
16
+ * let snapshot = cache.get(key);
17
+ * if (!snapshot) {
18
+ * snapshot = await api.getFile(fileKey, { version: versionId, depth });
19
+ * cache.set(key, snapshot);
20
+ * }
21
+ */
22
+ export interface VersionSnapshotCacheOptions {
23
+ maxEntries?: number;
24
+ }
25
+ export declare class VersionSnapshotCache {
26
+ private readonly maxEntries;
27
+ private readonly store;
28
+ constructor(options?: VersionSnapshotCacheOptions);
29
+ /**
30
+ * Build a stable cache key from the request parameters.
31
+ * Returns null for HEAD requests (versionId is null/undefined/empty).
32
+ */
33
+ makeKey(fileKey: string, versionId: string | null | undefined, depth: number | undefined, nodeIds?: string[]): string | null;
34
+ get<T = unknown>(key: string | null): T | undefined;
35
+ set(key: string | null, value: unknown): void;
36
+ has(key: string | null): boolean;
37
+ get size(): number;
38
+ clear(): void;
39
+ }
40
+ //# sourceMappingURL=version-cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version-cache.d.ts","sourceRoot":"","sources":["../../../src/core/diff/version-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,2BAA2B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;gBAExC,OAAO,GAAE,2BAAgC;IAIrD;;;OAGG;IACH,OAAO,CACN,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,CAAC,EAAE,MAAM,EAAE,GAChB,MAAM,GAAG,IAAI;IAShB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,SAAS;IAUnD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAW7C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAIhC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;CAGb"}