v0.24.0

0.24.0 (2026-10-20)

Features

• sync fork with upstream (9f9e1c6)

Bug Fixes

• use cache: pnpm instead of unsupported package-manager-cache in setup-node@v4 (b30abf3)
• use canonical style comparison and guard aspect-ratio divide-by-zero (#402) (c083d65)

v0.23.0

0.23.0 (2026-06-23)

Features

• switch to npm OIDC trusted publishing, remove NPM_ACCESS_TOKEN (7631a9d)

v0.22.0

0.22.0 (2026-06-23)

Features

• CSS Grid layout support (#347) (5c1da79)
• extractors: deduplicate repeated styles and subtrees to shrink output (#389) (a43e465)
• fills: flatten all-solid fill stacks into a single resolved color (#390) (dcf11d2)
• format: default output to tree instead of yaml (#394) (4e3a08b)
• layout: emit the requested root as contextual sizing with a designed reference (#393) (ef888b5)
• serialize: add experimental tree output format for better token efficiency (#370) (9ecbc5a)
• strokes: include strokeAlign in simplified stroke output (#386) (c807a27)
• support per-request Figma API keys (#365) (fe3b504)
• support request bearer oauth tokens over HTTP (#384) (22426e6)
• sync fork with upstream - merged upstream v0.12.0-v0.13.2 changes (c25ef7c)

Bug Fixes

• apply paint-level opacity to gradient fills (#399) (7fc8829)
• drop redundant and auto-generated node names from serialized output (#397) (b53727a)
• effects: halve Figma blur radius for CSS and omit zero-radius blur (#392) (49a0c73)
• guide LLMs to fix bad node-id errors (proto/branch/figjam URLs) (#371) (c6697bc)
• images: omit null imageRef so foreign-pasted images render via nodeId (#368) (166f87d)
• images: report real SVG dimensions instead of 0x0 (#396) (3c7524c)
• layout: include positions for children of SECTION nodes (#381) (5088fba)
• layout: respect parent axis for dimensions (#379) (a54cbc2)
• mcp: prevent late progress notifications from crashing stdio clients (#366) (b97585c)
• reject ambiguous localPath inputs in download_figma_images (#367) (eaeec68)
• resolve duplicate imports and handle undefined children in convertAlignItems (900128e)
• stop collapsing auto-layout frames to a single IMAGE-SVG (#380) (c036111)
• text: emit letterSpacing and relative lineHeight as em, not % (#391) (0cb97d0)

v0.21.0

0.21.0 (2026-04-22)

Miscellaneous Chores

• align server manifest version metadata (27b60a8)

v0.20.0

0.20.0 (2026-04-22)

Features

• replace node cache mode with subtree seeding (dd700e7)

Bug Fixes

• clarify subtree caching README docs (de80cf4)
• handle missing frame children in alignItems (4f5e0d5)

v0.19.0

0.19.0 (2026-04-21)

Features

• add node-level cache granularity via cacheType option (4ac5758)

v0.18.0

0.18.0 (2026-04-21)

⚠ BREAKING CHANGES

• switch to stateless HTTP transport (#304)
• getServerConfig() no longer takes an isStdioMode parameter. It now detects stdio mode internally and returns it as part of ServerConfig.

Features

• add --image-dir config for image download path control (#297) (0417766)
• add anonymous PostHog telemetry (#342) (6c0666a)
• add component property support (BOOLEAN & TEXT) (#340) (b0f9efc)
• add progress notifications and async tree walker (#305) (b5724ad)
• add proxy support for managed networks (#338) (32d5779)
• add support for using as a CLI via fetch subcommand to retrieve design data directly (#331) (dd237c8)
• replace yargs with cleye for CLI flag parsing (#285) (0092ee7)
• rich text styling (#351) (759d0e4)
• support gifRef for downloading animated GIF embeds (#286) (f1ec913)

Bug Fixes

• add actionable 403 error message with troubleshooting link (9230bd0)
• disambiguate named styles with duplicate names (#319) (a077ace)
• handle drive root paths in image directory security check (#301) (9f32616)
• include BOOLEAN_OPERATION in SVG container collapse (354679e)
• include BOOLEAN_OPERATION in SVG container collapse (19c50b3)
• layout: suppress computed gap values when using SPACE_BETWEEN (#341) (309c60e), closes #169
• remove inline release-type so release-please reads config file (a03cd68)
• replace jimp with selective @jimp/* imports to fix ESM crash (#333) (dd47ebf), closes #329
• replace sharp dependency with js-native jimp for image manipulation (#289) (62b9f94)
• skip jimp processing for SVGs and prevent image-fill collapse (#298) (a4a4b13)
• stop routing all traffic through EnvHttpProxyAgent by default (#359) (a22f28f)
• surface Figma 403 response body to help LLMs self-heal based on actual error (#360) (12280ba)
• throw actionable error for missing nodes, add error_category to telemetry (#344) (334ae2b)

Performance Improvements

• fix O(n²) bottlenecks in simplification and YAML serialization (#307) (29cff0c)

Code Refactoring

• switch to stateless HTTP transport (#304) (9dfb1cb)

v0.17.1

0.17.1 (2026-03-11)

Bug Fixes

• upgrade MCP SDK to 1.27.1 and modernize tool registration (#282) (4153e5f)
• use Node 24 in release workflow for npm OIDC support (11ba7c6)

v0.17.0

0.17.0 (2026-02-26)

Features

• Extracting global variables (bb52df2)
• Extracting global variables (03143b8)
• Include component and component set names to help LLMs find pre-existing components in code (#122) (60c663e)
• security: add input validation to download images tool (#207) (651974e)
• security: add path sanitization to prevent directory traversal (#206) (5a18eef)
• sync fork with upstream - release-please migration, vitest, repo cleanup (2124f43)

Bug Fixes

• add NODE_AUTH_TOKEN to npm publish step in release workflow (f82d614)
• Cannot find module '~/transformers/layout' (7432d6c)
• Cannot find module '~/transformers/layout' (82a52f7)
• configure pnpm npmrc for npm registry auth in release workflow (355ddcb)
• enhance fetchWithRetry to handle error statuses in response body (803a479)
• Fix bug where MCP cannot be invoked by cursor 0.45.11 (dbea364)
• Make sure LLM provides a filename extension when calling download_figma_images (00bad7d)
• README.zh-tw typo (#236) (c65c25c)
• Remove empty keys from simplified design output (#106) (4237a53)
• Replaced the NODE_ENV setting with cross-env to improve cross-platform compatibility. (#19) (a0eeed5)
• update Node ID regex to support additional formats in download i… (#227) (68fbc87)
• use correct secret name NPM_ACCESS_TOKEN in release workflow (6800cbe)
• use npm publish instead of pnpm publish for registry auth (69cdcc2)
• write project-level .npmrc for pnpm publish auth (c93f485)

v0.9.0

Minor Changes

• #261 c730417 Thanks @jnhyperion! - Add configurable --host CLI option for remote deployments. Use --host CLI argument or FRAMELINK_HOST environment variable to bind to addresses other than localhost (e.g., 0.0.0.0 for network access).

  Also adds FRAMELINK_PORT environment variable (with backwards-compatible fallback to PORT).