Modify tokens updater to support color aliases

[c4rlosviteri]

Updates the token updater script to properly handle color aliases by implementing support for color references and options prefix management.

Main changes

• Added detection for color tokens by checking $type property and parent type inheritance
• Added support for color references and maintaining their structure
• Added loading and tracking of options tokens for proper prefix management
• Implemented reference normalization to handle options prefix based on token location

Technical details

• Added isColorToken function to detect color tokens based on:

  • Direct $type: "color" declaration
  • Inheritance from parent type

• Added normalizeReference function to:

  • Clean reference paths
  • Check if the reference points to an options token
  • Add/maintain the "options." prefix when needed

• Added options token loading with:

  • Scanning of _options folder
  • Storage of valid color tokens
  • Path matching for nested tokens

Testing

The script has been tested with:

• Direct color values
• Color references
• Nested color tokens
• Options and non-options references

Example

From

{
  "color": {
    "icon": {
      "default": {
        "$value": "{color.warm-grey-600}",
        "$type": "color",
        "filePath": "tokens/global/color.json5"
      }
    }
  }
}

To

{
  "color": {
    "icon": {
      "default": {
        "$value": "{options.color.warm-grey-600}",
        "$type": "color",
        "docs": {}
      }
    }
  }
}