omena-css

omena-css is a CSS-family semantic engine with CLI, LSP, SDK, build, and editor surfaces.

Install

VS Code:

Install Omena CSS Modules from the Marketplace.

CLI:

cargo install omena-cli --locked

Node and browser bindings:

npm install @omena/napi
npm install @omena/wasm

60-Second Check

Create path/to/file.module.css with no local @keyframes pulse declaration:

.button {
  animation: pulse 1s ease;
}

Run the zero-config single-file lint path:

omena lint path/to/file.module.css

The report includes this finding:

2:14 missing-keyframes @keyframes 'pulse' not found in this file.

The documentation gate executes this fixture with the Rust CLI and compares the captured finding, so the example changes when product behavior changes.

What You Get

• CSS, SCSS, Sass, Less, CSS Modules, and source-language fact production.
• Shared diagnostics, navigation, references, rename, explain, and code actions.
• Cascade-, value-, provenance-, and target-aware transform decisions.
• Lint, format, minify, bundle, module, Sass, intelligence, and migration commands.
• NAPI, WASM, CLI, and LSP workflows over snapshot-bound contracts.
• Vite, PostCSS, ESLint, Stylelint, and VS Code integration surfaces.

Product Guides

Area	Guide
CLI	Command guide
SDK	NAPI, WASM, CLI, and LSP workflows
LSP	Rust API docs, Zed, Neovim
Bundler	Rust bundler, Vite host
Lint plugins	ESLint, Stylelint
Sass and SIF	Compatibility and provenance
Codemods	Using omena migrate
VS Code	Extension behavior and settings
Positioning	Claims and non-claims
Architecture	Current codemap
Performance	Reproduction and evidence
Releases	Changelog
Contributing	Contributor guide
Reference	Generated CLI, config, persona, and LSP tables

Runtime Shape

The packaged VS Code extension starts the Rust omena-lsp-server; the extension host handles process supervision, UI, configuration, and file events. NAPI, WASM, CLI, and LSP expose the same snapshot-bound query and typed-outcome contracts. TypeScript adapters and shadow checks protect compatibility without becoming a second CSS semantic authority.

The architecture, product-path matrix, generated IDL, and public reference surfaces are checked in CI. Unknown, unresolved, and unsupported cases remain typed outcomes rather than guessed successes.

Development

pnpm install
pnpm check
pnpm test
pnpm build

Contributor recipes and the complete generated command inventory live in CONTRIBUTING.md and docs/reference/.

License

MIT