Tailwind Contract

“Tailwind token” is ambiguous. Use these four terms instead.

Tailwind 3 is a zero-runtime compiler. Do not infer runtime behavior from a utility name; inspect the emitted declaration.

Runtime semantic utilities

The generated utility catalogue is the authority for exact mappings. It classifies current primary, surface, severity, text, content, highlight, and radius utilities by their emitted CSS and public variable dependency.

Examples of the intended categories include semantic colors, content borders, muted text, and rounded-border when the generated source confirms its mapping. An entry appears here only when generated from the selected preset and package versions.

Compile-time baseline

The generated catalogue separately records spacing, sizing, default radii, font sizes, shadows, transition durations, and timing functions that compile to constants.

Build-time baseline. This value is embedded in the module bundle and does not react to a facade theme change.

Compile-time values are valid for properties classified platform-invariant. They are insufficient for a property required to track a PrimeVue sibling under another facade theme.

rounded-md and rounded-border are not equivalent contracts even if they currently resolve to the same number: one is a compiled default and the other is runtime-backed. Equal current values also do not prove equal semantic roles.

Protected mappings

Modules may extend the shared preset. They must not redefine protected Wippy meanings for:

• Primary and surface families.
• Severity families.
• Text, content, and highlight semantics.
• Published portable-control semantics.

Compliance resolves the actual module Tailwind configuration and rejects incompatible replacement of protected mappings.

Custom siblings

A portable custom sibling may use:

• Runtime-backed semantic utilities listed in the generated catalogue.
• Direct public variables listed in the selected token manifest.
• Compile-time utilities for properties explicitly classified platform-invariant.
• Module-local utilities for genuinely novel structure.

It may not copy fixed dimensions, radii, or durations for properties expected to track its PrimeVue sibling. If no public runtime semantic exists, record a theme-contract gap; do not invent a utility or token.

Generated utility catalogue

The checked-in snapshot is generated from:

• The exact Tailwind version selected by @wippy-fe/theme.
• The exact tailwindcss-primeui version.
• Wippy’s shared tailwind.config.ts.
• Wippy extensions.

Each generated row contains the utility, emitted property, resolved value, runtime dependency, intended use, allowed consumer, stability, package compatibility tuple, and source hashes.

Generated from @wippy-fe/theme 0.0.46. Every representative mapping below is checked against CSS compiled by Tailwind 3.4.19 with tailwindcss-primeui 0.6.1.

Source hashes: theme contract 853a01257988861e208b6f7523de25cd329717763d064e4f2c5920cff7f7778a; theme config 129f1591fd657416b75e913f554329924bade319c38e62f5b72dcc5f72bd8295; Tailwind config f1e862105254f082a78823ea685e3c6dc3ff5822516b7434a1e1141c976adc1d; reference theme sources aura/index.mjs=d1a1a574cf1a15aad8aee4cb3fa169aa97bf4029e9f858b84245e7f0b933d5ca; aura/base/index.mjs=9fec80a7ffbd5fb0229da666c1472c27c9a0a6a7ef3bb0a84bd7b070601e4198; aura/inputtext/index.mjs=5c5a4af9bacf0d585120b119bb7bfb02c7deedd9714b131d7009ff6e95f818e8; aura/toggleswitch/index.mjs=1e068fd0ede48eeeca4d10571940d65dadb3450b2ee51a39d09b33dda9da6e66; aura/button/index.mjs=44d8fd7f7ae163ce2653de8c6eb8af097fc453b4c60f702fcf76845be6ec9393.

Runtime-backed semantic utilities

Compile-time baselines

Build-time baseline. This value is embedded in the module bundle and does not react to a facade theme change.

Internal or transient utilities

Compiled representative probes