variable_graph.ts

Overlays a theme's variables onto a resolved variable set, last-wins by name.

This is how a theme is baked in at build time: the overlaid values flow through the dependency graph like any other, so the variables a theme references are pulled in transitively and the output stays tree-shaken. A stanced theme's scheme_mirror applies first, matching the renderer's order

• and a stanced theme arriving without its mirror computed is resolved

through resolve_theme_stance here, so a hand-rolled theme bakes the same as the shipped exemplars (build time has no bundle-weight concern). A theme slot the stylesheet can't hold is dropped before it overlays, as render_theme_style drops it, so the value beneath it stays.

Builds a dependency graph from an array of style variables.

The graph is what the bundled theme CSS renders from, verbatim, so it applies the containment checks render_theme_style does: a slot whose value could end its own declaration (or is blank), or a variable whose name isn't a plain identifier, is left out and reported as an uncontained_theme_value error rather than written into the stylesheet.

Builds a variable dependency graph from a variables option. Handles all option forms: undefined (defaults), null (disabled), array, or callback.

Finds the most similar variable in the graph to the given name. Returns null if no variable exceeds the similarity threshold.

Generates theme CSS for the resolved variables.

Gets all variable names from the graph.

Resolves variables transitively using DFS with cycle detection. When a variable is requested, all variables it depends on are included. Both light and dark dependencies are always resolved together.

An excluded variable is left out along with the dependencies only it pulls in - whatever defines it in its place defines those too.

Result from transitive variable resolution.

Information about a single style variable and its dependencies.

Dependency graph for style variables.