Expand composite tokens into individual variables during export

[Copilot]

Composite tokens (typography, border, boxShadow, composition) were being filtered out during variable export because the system only recognized atomic token types.

Changes

• New expansion utility (expandCompositeTokensForVariables): Breaks composite tokens into constituent properties before variable creation. Each property becomes an individually exportable variable with correct type mapping.

• Integration point: Modified generateTokensToCreate to expand composites before filtering by tokenTypesToCreateVariable.

• Type-safe mapping: Added explicit property-to-TokenType mapping to handle conversions from convertToDefaultProperty output to enum values (e.g., fontFamily → FONT_FAMILIES, borderWidth → BORDER_WIDTH).

Example

A typography token:

{
  "heading.large": {
    "type": "typography",
    "value": {
      "fontFamily": "Inter",
      "fontSize": "24px",
      "fontWeight": "700"
    }
  }
}

Now exports as three separate variables:

• heading.large.fontFamily (string)
• heading.large.fontSize (number)
• heading.large.fontWeight (number)

Border and boxShadow tokens expand similarly (e.g., border.color, shadow.blur).

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Composite tokens are skipped during variable export</issue_title>
<issue_description>Describe the bug
Complex tokens (typography, border, shadows) are skipped during variable export
Note: This issue is reproducible with both exporting as themes and sets.
To Reproduce

1. Create tokens with complex values:
   • Typography token with fontFamily, fontSize, lineHeight, etc.
   • Border token with multiple values
   • Box shadow token with multiple shadow properties
2. Navigate to export functionality
3. Select "Export as Variables" or a similar export option
4. Attempt to export the token sets containing these complex tokens
5. Review the exported output

Screenshots or Screencasts

https://github.com/user-attachments/assets/066bf68c-7341-42c1-8305-b9bbeded1bde
</issue_description>

Comments on the Issue (you are @copilot in this section)

@six7 @NuthanHyma what did you have in mind with `Expanded using the appropriate conversion utilities` ?

• Fixes Composite tokens are skipped during variable export #3524

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[changeset-bot]

🦋 Changeset detected

Latest commit: d45a004

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@tokens-studio/figma-plugin	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR