@birdycom/omniacss 0.0.0-stage → 0.11.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Serge Cools (Birdycom)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,44 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @birdycom/omniacss
+
+OmniaCSS utilities — modern CSS (anchor positioning, container queries, view transitions, scroll-driven animations, `light-dark()`, gradients, logical properties …) as utility classes, **generated on demand**.
+
+```bash
+npm install -D @birdycom/omniacss
+```
+
+**PostCSS / Vite / Laravel** — put `@omnia;` in your CSS:
+
+```js
+// postcss.config.js
+import omniacss from "@birdycom/omniacss/postcss";
+export default { plugins: [omniacss({ content: ["src/**/*.{html,js,vue,tsx}"] })] };
+```
+
+**Engine API**
+
+```js
+import { buildCss } from "@birdycom/omniacss/engine";
+const { css, stats } = await buildCss({ content: ["src/**/*.html"], layer: "omnia" });
+```
+
+Full build (prototyping): `import "@birdycom/omniacss"` · palette tokens: `@birdycom/omniacss/tokens` · theme tokens: `@birdycom/omniacss/theme` · SCSS: `@birdycom/omniacss/scss/*`.
+
+## Theme tokens (web and desktop)
+
+`tokens/semantic.json` is the single source of the semantic theme: `--oc-background`, `--oc-foreground`,
+`--oc-primary`, `--oc-border`, the interaction states `--oc-row-alt`, `--oc-hover`, `--oc-pressed`,
+`--oc-selected`, `--oc-disabled-foreground`, plus `--oc-radius`, `--oc-focus-width`, fonts and shadows.
+Every color is an Omnia palette token, light first, dark second.
+
+- **Web:** `dist/oc-theme.css` (load after `oc-colors.css`) — `light-dark()` custom properties. OmniaUI builds on it.
+- **Desktop apps** (Tkinter, Qt, WinUI …): `dist/tokens/` holds the same tokens resolved per mode, with no
+  `var()` left, as sRGB hex (gamut mapped the CSS Color 4 way, not clipped), the source `oklch` and alpha apart,
+  and the OmniaCSS version on top:
+  - `omnia.tokens.json` — `{ omniacss, tokens: { background: { light: { hex, oklch }, dark: { … } }, radius: { px }, … } }`
+  - `omnia.dtcg.json` — W3C Design Tokens (light as `$value`, dark in `$extensions`)
+  - `omnia_tokens.py` — `PALETTES = {"light": {…}, "dark": {…}}`, `SIZES`, `TEXT`, `FONTS`, `SHADOWS`, `font()`
+
+  No Node in your app? Download them from the CDN: `https://unpkg.com/@birdycom/omniacss@<version>/dist/tokens/omnia_tokens.py`.
+  With your own theme: `npx omniacss tokens --source my-semantic.json --format python` (see `@birdycom/omniacss-cli`).
+
+Docs: https://github.com/Birdycom/OmniaCSS#readme — MIT