This release adds support for the component properties beta features and adds the the ability to read the fontWeight of text nodes.

Component Properties​

Exposed Instances

• isExposedInstance: indicates whether this InstanceNode has been marked as exposed to its containing ComponentNode or ComponentSetNode
• exposedInstances: all nested instances that have been exposed to this InstanceNode's level

Preferred Values

• componentPropertyDefinitions: updated to return InstanceSwapPreferredValue[] for 'INSTANCE_SWAP' component property definitions
• addComponentProperty: updated to accept InstanceSwapPreferredValue[] when adding an 'INSTANCE_SWAP' component property
• editComponentProperty: updated to accept InstanceSwapPreferredValue[] when editing an 'INSTANCE_SWAP' component property

Font Weight​

• fontWeight: The weight of the font (e.g. 400 for "Regular", 700 for "Bold"). This property is readonly and cannot be set directly.
• getRangeFontWeight: gets the fontWeight from characters in range start (inclusive) to end (exclusive).

New:

• You can now add a button with a custom action to the notifications created by notify. You can also add an onDequeue function that runs when the notification is removed. This function has a string parameter that represents the reason why the notification was removed.

New​

• You can now retrieve the author of a StampNode, with getAuthorAsync
• BASH is now a supported codeLanguage for CodeBlockNode
• A new absoluteBoundingBox property has been added to several nodes
• A new attachedConnectors property has been added to nodes that can have connectors

Bug fixes​

Previously, stuckNodes were not marked readonly in the typings. It was a runtime error to try to set this property, and the typings now reflect this.

Breaking interface rename​

LayerSublayerNode has been renamed to LabelSublayerNode. The previous name was a typo.

This release adds support for the component properties feature with new properties and functions on each of the following node types:

ComponentSetNode

• componentPropertyDefinitions
• addComponentProperty
• editComponentProperty
• deleteComponentProperty

ComponentNode (non-variants only)

• componentPropertyDefinitions
• addComponentProperty
• editComponentProperty
• deleteComponentProperty

SceneNode (must be a component sublayer and not nested within an instance node)

• componentPropertyReferences

InstanceNode

• componentProperties

The setProperties function on InstanceNode was also updated to work with component properties.

The variantGroupProperties property on ComponentSetNode is now deprecated. It will continue to the return the variant group properties but it is recommended to use the new componentPropertyDefinitions property.

The variantProperties property will continue to be supported on ComponentNode but is now deprecated on InstanceNodes. It will continue to return the variant properties on an instance but it is now recommended to the use the new componentProperties property.

This release adds support for the individual strokes feature with new properties for each side of a rectangle or frame-like node:

• strokeTopWeight
• strokeBottomWeight
• strokeLeftWeight
• strokeRightWeight

Assigning a value to the strokeWeight property will apply the same weight to all four sides.

New:

• Support for individual strokes
• Added figma.ungroup for ungrouping nodes, which is roughly equivalent to Ctrl-Shift-G/⌘⇧G in the editor.
• Added new autolayout properties:
  • layoutPositioning: Determines whether a layer's size and position should be determined by auto-layout settings or manually adjustable
  • strokesIncludedInLayout: Determines whether strokes are included in layout calculations
  • itemReverseZIndex: Determines the canvas stacking order of layers in this frame
• Updated autolayout properties:
  • counterAxisAlignItems: Added "BASELINE" option for aligning all children along the text baseline on horizontal auto-layout frames.
  • textAutoResize: Added "TRUNCATE" option for truncating overflowing text with an ellipse.

Fixes to the plugin typings:

• Add missing rotation property to ShapeWithTextNode and ConnectorNode
• Fix opacity and blendMode properties incorrectly marked as optional and readonly in CodeBlockNode, ConnectorNode, ShapeWithTextNode, and StickyNode.
• Add missing fills and fillStyleId properties to TextSublayer

New:

• New themeColors option in figma.showUI() to allow plugin UIs to support light and dark themes

New:

• Added new API method setWidgetSyncedState on widget nodes
• Added new API method findWidgetNodesByWidgetId to find all widget nodes by a specified node.widgetId

New:

• Added new CIRCLE_FILLED option to the ConnectorStrokeCap type.

New:

• New .stuckNodes and .stuckTo properties to read the nodes that are stuck on the reference node as well as the node current stuck to.
  • .stuckNodes is available on all SceneNode
  • .stuckTo is only available on “stickable” nodes (eg. StampNode, WidgetNode, HighlightNode)
• Added typings for HighlightNode and WashiTapeNode.

New:

• VectorRegions inside a VectorNetwork now have new fills and fillStyleId properties to let you get and set unique fills for each region in a vector network.