omena-transform-passes

omena-transform-passes owns the transform pass registry and DAG planner for the post-v5 omena-css track. It consumes omena-transform-cst contracts instead of redefining pass metadata. Concrete mutation engines plug in behind this registry so transform execution cannot drift from the semantic/cascade proof obligations.

The first execution runtime surface is intentionally conservative. It executes lexer-backed commodity mutations, context-gated bundle/module rewrites, and the emission boundary only when the required resolver, evaluator, bridge, cascade, or source-map evidence is present.

Current safe mutations include whitespace normalization, comment stripping, numeric and color literal compression, zero-length unit normalization, URL and string quote normalization, specificity-preserving selector compression, adjacent exact rule deduplication, adjacent same-selector rule merging, adjacent selector merging with identical declaration blocks, top-level empty rule removal, conservative vendor prefixing, guarded color-function lowering, simple nesting unwrap, static media/supports evaluation, and same-unit calc() reduction.

Context-gated transforms include box-shorthand combining through the omena-cascade proof, scope/layer flattening through cascade witnesses, import inlining through explicit resolved CSS replacements, SCSS/Less module evaluation through evaluator output, CSS Modules class hashing and composes resolution through selector identity/export evidence, local @value resolution, custom-property substitution, simple reachability-based tree shaking, and design-token routing through bridge token routes.