Jetons.TokenStudio (jetons v0.2.0)

Copy Markdown View Source

Reads Token Studio folder structure and converts to DTCG resolver format.

Token Studio exports tokens as a folder with:

  • $metadata.json - contains tokenSetOrder for merge precedence
  • $themes.json - array of theme definitions with selectedTokenSets
  • Individual token set files in subdirectories

Summary

Functions

Loads the complete Token Studio structure from a directory.

Extracts theme definitions from loaded Token Studio data.

Converts loaded Token Studio data to a DTCG resolver document.

Returns the token set order from metadata, or empty list if not defined.

Functions

load(dir)

Loads the complete Token Studio structure from a directory.

Returns a map with:

  • :metadata - parsed $metadata.json content
  • :themes - parsed $themes.json content (list of theme definitions)
  • :token_sets - map of set_name => relative_path for all discovered token files

themes(map)

Extracts theme definitions from loaded Token Studio data.

Returns a list of maps, each with:

  • :name - theme name
  • :enabled_sets - list of enabled token set names

to_resolver(data, opts \\ [])

Converts loaded Token Studio data to a DTCG resolver document.

Options

  • :modifier_name - Name for the theme modifier (default: "theme")
  • :token_dir - Directory containing token files (for path computation)
  • :output_dir - Directory where resolver will be written (for relative paths)

token_set_order(map)

Returns the token set order from metadata, or empty list if not defined.