unknown-key | A key no sz table knows, likely a typo. | engine, runtime | settable |
canonical-key | An alias of a key, with the canonical spelling to write. | engine, runtime | settable |
removed-key | A key that was removed or replaced, with what to write instead. | engine, runtime | settable |
numeric-key | A numeric key, the mark of an array or spread passed as an sz object. | engine, runtime | settable |
closed-enum-value | A value a closed-enum key does not take. | engine, runtime | settable |
slash-opacity-string | A colour key given its opacity in a string, which emits nothing; the object form takes it. | engine, runtime | settable |
off-scale-value | A spacing value off Tailwind's quarter-step scale. | engine, runtime | settable |
numeric-font-weight | A font weight written as a numeric string. | engine, runtime | settable |
per-side-border-style | A border style on one side, which Tailwind cannot express. | engine, runtime | settable |
property-object | An object on a key that names a property, not a variant. | engine, runtime | settable |
non-variant-object | An object on a csszyx-owned key that is not a variant. | engine, runtime | settable |
unknown-field | A field a structured value (a mask layer) does not take. | engine, runtime | settable |
runtime-value | A runtime value on a key with no CSS-variable utility. | engine | settable |
unresolvable-spread | A spread in an sz object the build cannot resolve. | engine | settable |
style-override | A props spread that may override the style sz emits. | engine | settable |
szs-slot-map | An szs slot map the build cannot read, or one on a host element. | engine | settable |
sz-recover | An szRecover value the build cannot read. | engine | settable |
class-precedence | A runtime className beside sz, which sz overrides. | engine | settable |
duplicate-sz | An element with more than one sz attribute, merged in order. | engine | settable |
spread-split-class | Class names and sz on more than one side of a spread. | engine | settable |
moved-value | A value that moved to another key, with the key to write. | engine, runtime | settable |
global-before-group | A stand-alone keyword written before a group key that replaces it. | engine, runtime | settable |
runtime-family-conflict | A runtime value beside the other side of its key family. | engine | settable |
fallback-missing-css | A runtime fallback whose classes were never collected. | engine | settable |
fallback-nudge | A runtime fallback whose classes were still collected. | engine | settable |
merge-classifier-unavailable | A merge table this engine cannot read, so nothing merged. | engine | settable |
parse-error | A file the parser rejected, which contributes no classes. | engine, runtime, error | settable |
nesting-depth | A file nested deeper than the parser guard allows. | engine | settable |
unsupported-dynamic-sz | An sz attribute whose value the engine cannot read. | engine | settable |
ast-budget | A file over the AST budget, left unchanged. | engine, runtime | settable |
mangle-vars-hoist-skipped | A CSS variable mangleVars could not hoist to a component. | engine | settable |
color-slash-opacity | A colour object with a slash opacity in `color`; the object takes it in `op`. | engine, runtime | settable |
unsigned-value | A negative value on a key Tailwind serves no negative utility for. | check, runtime | settable |
dead-class | An emitted class this project's Tailwind generates no CSS for. | check, runtime | settable |
prefix-disagreement | Tailwind entries in one project that set different prefixes. | check, error | settable |
sibling-keyword | A value that emits a class setting another property than its key sets. | check | settable |
broken-opacity | An opacity modifier on a colour whose theme value color-mix() cannot dim. | check, runtime | settable |
unserved-variant | A bare variant name Tailwind serves no variant for, on a utility it serves. | check, runtime | settable |
theme-collision | A theme token whose name a built-in utility also uses. | check, runtime | settable |
merge-covered-key | An sz key the build removed because a later key in the same object covers it. | check, runtime | settable |
merge-covered-class | A className class the build removed because an sz class on the element covers it. | check, runtime | settable |
recovery-manifest-unreadable | A recovery manifest that is not valid JSON or not in the recovery format. | runtime, error | — |
mangle-map-unreadable | A mangle map on the page that is not a plain map of class names, so it is ignored. | runtime | — |
mangle-census-unreadable | A mangle census on the page that is not a valid map, so nothing was verified. | runtime | — |
mangle-checksum-mismatch | A mangle map whose hash differs from the checksum it was built with. | runtime | — |
mangle-map-unavailable | A page with a mangle checksum but no census or map to recompute it from. | runtime | — |
web-crypto-unavailable | A page without Web Crypto, so the mangle checksum cannot be recomputed. | runtime, error | — |
hydration-aborted | A hydration check that threw on an element and stopped. | runtime | — |
csr-recovery-unmarked | A hydration mismatch on an element without an szRecover directive. | runtime | — |
csr-recovery-dev-only | An szRecover="dev-only" element in a production build, where its recovery is off. | runtime | — |
csr-recovery-used | A hydration mismatch the runtime recovered by rendering on the client. | runtime | — |
merge-table-format-skew | A merge table in a format this runtime does not read, so szcn merges nothing. | runtime | — |
merge-table-missing | A run with no merge table, so szcn removes only exact repeats. | runtime | — |
uncompiled-sz | A raw sz object that reached the runtime because its file was not compiled. | runtime | — |
register-szcn-groups-ignored | A registerSzcnGroups call, which no longer changes what szcn merges. | runtime | — |
theme-token-ambiguous | A theme token defined under two namespaces that share one class prefix. | runtime | — |
split-box-selector-invalid | A has/pick/omit selector that can never match a token. | runtime | — |
split-box-unknown-category | A selector name that is no category or class prefix csszyx knows. | runtime | — |
split-box-placement-variant | A splitBox placement written with a variant or marker, which never matches. | runtime | — |
split-box-peer-on-frame | A peer class splitBox kept on the frame although its base belongs inside. | runtime | — |
split-box-unclassified | A class or raw CSS splitBox cannot classify, placed on the fallback node. | runtime | — |
split-box-unbounded-scroll | A scrolling content node whose height nothing bounds, so it grows instead. | runtime | — |
split-box-unclipped-corners | A rounded frame that does not clip its scrolling content. | runtime | — |
split-box-hidden-content | A hiding class placed on the content node, which leaves the frame visible. | runtime | — |
szv-config-invalid | A part of an szv config that does not have the shape szv reads. | runtime | — |
sz-object-depth | An sz object at runtime nested deeper than the depth limit. | runtime, error | — |
szv-forbidden-key | A key in an szv config that csszyx never reads, such as __proto__. | runtime | — |
szv-unknown-variant | A selection that names a variant the szv config does not declare. | runtime | — |
szv-unknown-variant-value | A selection that gives a variant a value it has no styles for. | runtime | — |
szv-object-as-string | An sz object from szv() used as a class string, which renders "[object Object]". | runtime | — |
dynamic-injection-growth | A session in which dynamic() has injected so many classes the CSSOM keeps growing. | runtime | — |
dynamic-unsafe-arbitrary | An arbitrary value dynamic() dropped because it could inject CSS. | runtime | — |
dynamic-non-boolean | A runtime value that is not a boolean on a key only a boolean can toggle. | runtime | — |
dynamic-unresolvable | A runtime value of a type no CSS value can be resolved from. | runtime | — |
dev-warnings-partial | A development warning with no source location; csszyx check names the file and key. | runtime | — |
diagnostics-capped | More findings of one kind than a run lists; the rest are counted, not printed. | runtime | — |
sz-attribute-syntax | An sz attribute string that does not parse. | runtime, error | — |
options-object-required | An options argument that is not the one object the call takes. | error | — |
lowering-not-loaded | An sz object passed to a string helper before the lowering module is loaded. | error | — |
lite-sz-object | An sz object passed to a lite-runtime helper, which cannot lower objects. | error | — |
split-box-sz-string | A class string passed to splitBoxSz, which takes sz objects. | error | — |
runtime-prefix-conflict | Two builds sharing one runtime that registered different Tailwind prefixes. | error | — |
dynamic-manifest-unreachable | A dynamic manifest the browser could not fetch. | error | — |
native-engine-unavailable | A native engine that is missing, cannot load, or predates this compiler. | runtime, error | — |
wasm-engine-unavailable | A wasm engine that failed to load. | error | — |
native-migrate-unavailable | A native engine csszyx migrate needs and cannot load; migrate has no wasm lane. | error | — |
engine-version-skew | An engine built from other source than the compiler that loads it. | error | — |
runtime-version-skew | A @csszyx/runtime at another version than the plugin that lowers for it. | error | — |
peer-module-unresolved | A peer package csszyx needs that does not resolve from the project. | error | — |
tailwind-v3-unavailable | A project where generate-types finds no loadable Tailwind CSS v3. | error | — |
explain-input-invalid | An input to csszyx explain that is not one sz expression the build lowers. | error | — |
template-sz-invalid | A Vue or Svelte file whose template sz has errors, each reported with its own code. | error | — |
template-runtime-value | A template sz value only known at runtime, which a template cannot resolve. | error | — |
template-unparsable | A Vue or Svelte file its own compiler cannot parse, so no sz in it gets a class. | error | — |
template-lang-unsupported | A Vue template in a language other than HTML, which csszyx does not read. | error | — |
svelte-version-unsupported | An installed Svelte older than 5, whose markup csszyx does not read. | error | — |
ignore-package-incompatible | An installed `ignore` package that no longer reads .gitignore the way csszyx needs. | error | — |
internal-error | A state csszyx should never reach: a csszyx bug to report. | error | — |
engine-call-failed | A call into the engine that threw. | runtime | — |
config-invalid | A csszyx.config with problems, each reported with its own code. | runtime | — |
unknown-rule-id | A rule id no diagnostic, kind or group has, likely a typo. | runtime | — |
config-id-not-settable | A rule id for a runtime line or a throw, whose level csszyx.config cannot set. | runtime | — |
removed-rule-id | A rule id csszyx no longer reports, with the id that replaced it. | runtime | — |
config-level-invalid | A rule set to something other than off, info, warn or error. | runtime | — |
config-preset-unknown | A diagnostics preset other than recommended or atomic. | runtime | — |
config-field-unknown | A field csszyx.config does not read. | runtime | — |
config-field-invalid | A csszyx.config field whose value does not have the shape it takes. | runtime | — |
config-glob-unmatchable | An override glob that is absolute or steps out of the root, so it never matches. | runtime | — |
config-file-duplicate | A second csszyx.config file beside the one csszyx reads. | runtime | — |
config-unloadable | A csszyx.config that could not be loaded, so the default levels apply. | runtime | — |
config-no-default-export | A csszyx.config with no default export. | runtime | — |
policy-state-format-skew | A saved diagnostic policy in a format this version does not read. | runtime | — |
safelist-shard-format-skew | A Next safelist shard in a format this version does not read. | runtime | — |
diagnostics-held | Findings at info a production build counted instead of listing. | runtime | — |
merge-covered-held | Classes a build removed by merging, counted instead of listed. | runtime | — |
removed-option | A plugin option that was removed and is no longer read. | runtime | — |
transform-cache-disabled | A build without its transform cache, because package versions did not resolve. | runtime | — |
active-parser | The parser a build runs, and whether it fell back from the native engine. | runtime | — |
project-reload | A project-wide input that changed, so a dev server recompiled every module. | runtime | — |
watch-prefix-changed | A Tailwind prefix that changed during a watch build, which needs a restart. | error | — |
watch-merge-groups-changed | A stylesheet edit during a watch build that changed which sz keys cover each other. | runtime | — |
safelist-unwritable | A generated safelist csszyx could not write, so Tailwind misses its classes. | runtime | — |
safelist-capped | A safelist that hit its class cap, so the classes past it were left out. | runtime | — |
utility-collision | An @utility whose name another utility also claims, so Tailwind merges both. | runtime | — |
theme-scan-without-typescript | Theme auto-scan turned on in a project without TypeScript configured. | runtime | — |
esbuild-mangle-unsupported | production.mangle on the esbuild adapter, which turns mangling off. | runtime | — |
mangle-selector-unparsable | A CSS selector the class mangler could not parse, left unmangled. | runtime | — |
mangle-preserve-invalid | A production.manglePreserve entry that is not a class name or a prefix. | error | — |
mangle-global-vars-options-invalid | production.mangleGlobalVars options csszyx cannot apply. | error | — |
mangle-global-vars-plan-invalid | A global-variable alias plan that renames a variable unsafely. | error | — |
mangle-map-too-large | A CSS variable mangle map larger than its safety cap. | error | — |
mangle-census-late | Classes that appeared after the mangle map was frozen. | error | — |
mangle-hybrid-hazard | A production mangle that collides with, or breaks, CSS csszyx did not write. | runtime | — |
merge-hook-late | A rule selecting on a class the build had already merged away. | error | — |
merge-origin-unreadable | A Tailwind stylesheet csszyx cannot recompile without its own classes, so the build merges no class. | runtime | — |
tailwind-stylesheet-missing | A configured Tailwind stylesheet that does not exist. | error | — |
tailwind-stylesheet-absent | A build that emitted classes for `sz` props and processed no Tailwind stylesheet. | runtime | — |
tailwind-stylesheet-broken | A stylesheet reaching Tailwind that does not compile, so the prefix is unknown. | error | — |
tailwind-config-missing | A Tailwind config path that does not exist, or a directory with no config. | error | — |
tailwind-config-unloadable | A Tailwind config that threw while loading. | error | — |
legacy-source-directive | An @source line naming the old safelist file, which csszyx no longer writes. | error | — |
postcss-plugin-order | The csszyx PostCSS plugin listed after Tailwind, which then never reads the safelist. | error | — |
postcss-plugin-missing | A Next.js PostCSS config that does not list the csszyx plugin, so Tailwind never reads the safelist. | runtime | — |
ignore-pattern-negated | A negated pattern in an ignore list, which can only add paths. | error | — |
compile-sources-unresolved | A `compileSources` path that does not resolve to a directory. | runtime | — |
compile-sources-skipped | Files under `packages/` that use csszyx and that the build skips, since `compileSources` does not list them. | runtime | — |
css-source-unstable | A CSS source that kept changing while csszyx read it. | error | — |
rsc-boundary-violation | A client-only csszyx export imported into a Server Component. | error | — |
next-prefix-unread | A Next lane that runs before the Tailwind prefix was read. | error | — |
next-safelist-locked | A Next safelist state another live process holds the lock on. | error | — |
next-mangle-vars-unsupported | production.mangleVars on a Next lane that cannot mangle CSS variables. | error | — |
next-turbo-cache-unseeded | A Turbopack production build whose safelist was not seeded by csszyx next prebuild. | error | — |
next-sz-untransformed | A Next module that still holds sz syntax after the csszyx transform. | error | — |
next-watcher-unclosed | A Next safelist watcher that threw while closing. | runtime | — |
no-source-files | A source pattern that matched no file under the root. | runtime, error | — |
cli-option-invalid | A CLI option value outside the values the command takes. | error | — |