Extracts unique sorted category prefixes from a token list.

Examples

iex> Jetons.Parser.extract_categories([{"colors.red", "#f00"}, {"spacing.sm", "4px"}, {"colors.blue", "#00f"}])
["colors", "spacing"]

Parses a DTCG config map into a flat list of {path, value} tuples.

Examples

iex> Jetons.Parser.from_config(%{"colors" => %{"red" => %{"$value" => "#f00"}}})
[{"colors.red", "#f00"}]

@spec from_config_safe(map()) :: {:ok, [{String.t(), term()}]} | {:error, String.t()}

Non-raising variant of from_config/1.

Wraps from_config/1 and returns {:ok, tokens} on success, or {:error, message} when parsing raises an ArgumentError (e.g. invalid token names, circular $extends, or unresolvable references).

Examples

iex> Jetons.Parser.from_config_safe(%{"colors" => %{"red" => %{"$value" => "#f00"}}})
{:ok, [{"colors.red", "#f00"}]}

iex> {:error, msg} = Jetons.Parser.from_config_safe(%{"a" => %{"$extends" => "missing", "$value" => "x"}})
iex> is_binary(msg)
true

@spec from_config_safe(
  map(),
  keyword()
) :: {:ok, [{String.t(), term()}]} | {:error, String.t()}

Non-raising variant of from_config/2. See from_config_safe/1.

Parses multiple groups of JSON files, resolving references across all groups, and returns tokens grouped by label.

Each group is a {label, files} tuple where files is a list of file paths. References are resolved globally (e.g. tier 2 can reference tier 1 tokens), but the returned map preserves which group each token originated from.

Options

• :transforms - list of {type, fun} tuples to apply after resolution

Example

Jetons.from_files([
  {"tier1", Path.wildcard("tokens/01-definitions/**/*.json")},
  {"tier2", Path.wildcard("tokens/02-semantics/**/*.json")},
  {"tier3", Path.wildcard("tokens/03-components/**/*.json")}
])
#=> %{"tier1" => [{"color.palette.blue", "#308CE8"}, ...], ...}

See Jetons.Query.get_groups/2.

See Jetons.Query.get_in_group/3.

See Jetons.Query.group_by_path/3.