Struct TokenConsumers 

pub struct TokenConsumers {
    pub token: String,
    pub namespace: String,
    pub definition_path: String,
    pub definition_line: u32,
    pub consumer_count: u32,
    pub consumers: Vec<TokenConsumerLocation>,
}

A location-aware reverse index of where one design token is consumed, so an agent editing the token can see its blast radius before changing or removing it. Covers TWO token origins. The always-available discriminator is the token SHAPE: a Tailwind token is the ---prefixed custom property (--color-brand), a CSS-in-JS token is a dotted access path with no -- prefix (vars.color.primary). The per-consumer kind also discriminates origin, but only when consumer_count > 0 (a consumer_count: 0 entry has an empty consumers array and thus no kind), so branch on the token prefix for the zero-consumer case. The two origins:

• Tailwind v4 @theme tokens (kinds theme-var / css-var / utility / apply), built from the same gated candidate set as unused_theme_tokens (v4 + non-plugin + non-published + whole-scope), so a consumer_count: 0 corroborates the unused_theme_tokens “nothing consumes this” finding.
• CSS-in-JS tokens (kind js-member / js-call) from StyleX defineVars, vanilla-extract createTheme family definitions, and PandaCSS defineTokens, consumed via cross-module member access or PandaCSS token('...') calls. NOTE: CSS-in-JS has NO corroborating dead-token finding (there is no unused_theme_tokens analogue), so a CSS-in-JS consumer_count: 0 is a weaker signal than the Tailwind case (and the cross-file scan is relative-import or generated-token-helper only, so alias / bare-package imports are not counted).

This is DESCRIPTIVE context (a blast-radius lookup), not a finding, so it deliberately carries no actions array (unlike the cleanup-candidate types in this module). consumer_count is always a STATIC lower bound (a computed class name like bg-${color}, or a CSS-in-JS access through an unresolved alias import, is not counted).

Fields

token: String

The token identity. For a Tailwind @theme token this is the full custom property as authored, INCLUDING the -- prefix (--color-brand). For a CSS-in-JS token (kind js-member) this is the binding-qualified dotted access path, NO -- prefix (vars.color.primary), matching how consumers read it. The presence of the -- prefix distinguishes the two origins.

namespace: String

For a Tailwind token, the v4 theme namespace (color, radius, font-weight, …). For a CSS-in-JS token (kind js-member), the defining export BINDING the token set is accessed through (vars), which identifies the token set, NOT a semantic group. (The field is thus overloaded by origin; branch on consumers[].kind or the token shape.)

definition_path: String

Project-root-relative, forward-slash path to the declaring stylesheet (Tailwind) or the JS/TS token-definition file (CSS-in-JS).

definition_line: u32

1-based line of the token’s definition (inside the @theme block for Tailwind; the token key inside the defineVars/createTheme object for CSS-in-JS).

consumer_count: u32

The FULL number of consumer locations found, a STATIC LOWER BOUND: a computed class name (bg-${color}) or a value read outside CSS/markup the scan never sees is not counted. This is the aggregate over every consumer, computed BEFORE consumers is capped to a sample.

consumers: Vec<TokenConsumerLocation>

A capped, deterministically-sorted sample of consumer locations (at most TOKEN_CONSUMER_SAMPLE_CAP). The full count lives in consumer_count; use this list to jump to representative consumers, not to enumerate every one.

Trait Implementations

impl Clone for TokenConsumers

fn clone(&self) -> TokenConsumers

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TokenConsumers

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for TokenConsumers

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.