zeus-css 1.0.12 → 1.0.13

package/scss/zeus.tokens.json

@@ -345,207 +345,187 @@
   },
   "typography": {
     "display-xl": {
-      "$value": "800 clamp(3.5rem, round(2.9rem + 2.8cqi, 0.1rem), 6rem)/1.1 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "800 clamp(3.5rem, round(2.908rem + 2.761cqi, 0.01rem), 6rem)/1.1 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-display-xl"
     },
     "display-lg": {
-      "$value": "800 clamp(3rem, round(2.5rem + 2.2cqi, 0.1rem), 5rem)/1.1 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "800 clamp(3rem, round(2.527rem + 2.208cqi, 0.01rem), 5rem)/1.1 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-display-lg"
     },
     "display-md": {
-      "$value": "700 clamp(2.5rem, round(2.1rem + 1.7cqi, 0.1rem), 4rem)/1.15 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "700 clamp(2.5rem, round(2.145rem + 1.656cqi, 0.01rem), 4rem)/1.15 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-display-md"
     },
     "h1": {
-      "$value": "700 clamp(2.25rem, round(2rem + 1.1cqi, 0.1rem), 3.25rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "700 clamp(2.25rem, round(2.013rem + 1.104cqi, 0.01rem), 3.25rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h1"
     },
     "h1-light": {
-      "$value": "300 clamp(2.25rem, round(2rem + 1.1cqi, 0.1rem), 3.25rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "300 clamp(2.25rem, round(2.013rem + 1.104cqi, 0.01rem), 3.25rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h1-light"
     },
     "h2": {
-      "$value": "600 clamp(1.88rem, round(1.7rem + 1cqi, 0.1rem), 2.75rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(1.88rem, round(1.674rem + 0.961cqi, 0.01rem), 2.75rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h2"
     },
     "h2-light": {
-      "$value": "300 clamp(1.88rem, round(1.7rem + 1cqi, 0.1rem), 2.75rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "300 clamp(1.88rem, round(1.674rem + 0.961cqi, 0.01rem), 2.75rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h2-light"
     },
     "h3": {
-      "$value": "600 clamp(1.63rem, round(1.4rem + 1cqi, 0.1rem), 2.5rem)/1.25 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(1.63rem, round(1.424rem + 0.961cqi, 0.01rem), 2.5rem)/1.25 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h3"
     },
     "h3-light": {
-      "$value": "300 clamp(1.63rem, round(1.4rem + 1cqi, 0.1rem), 2.5rem)/1.25 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "300 clamp(1.63rem, round(1.424rem + 0.961cqi, 0.01rem), 2.5rem)/1.25 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h3-light"
     },
     "h4": {
-      "$value": "600 clamp(1.5rem, round(1.4rem + 0.6cqi, 0.1rem), 2rem)/1.3 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(1.5rem, round(1.382rem + 0.552cqi, 0.01rem), 2rem)/1.3 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h4"
     },
     "h4-light": {
-      "$value": "300 clamp(1.5rem, round(1.4rem + 0.6cqi, 0.1rem), 2rem)/1.3 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "300 clamp(1.5rem, round(1.382rem + 0.552cqi, 0.01rem), 2rem)/1.3 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h4-light"
     },
     "h5": {
-      "$value": "500 clamp(1.25rem, round(1.2rem + 0.3cqi, 0.1rem), 1.5rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "500 clamp(1.25rem, round(1.191rem + 0.276cqi, 0.01rem), 1.5rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h5"
     },
     "h5-light": {
-      "$value": "300 clamp(1.25rem, round(1.2rem + 0.3cqi, 0.1rem), 1.5rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "300 clamp(1.25rem, round(1.191rem + 0.276cqi, 0.01rem), 1.5rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h5-light"
     },
     "h6": {
-      "$value": "500 clamp(1.13rem, round(1.1rem + 0.1cqi, 0.1rem), 1.25rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "500 clamp(1.13rem, round(1.101rem + 0.133cqi, 0.01rem), 1.25rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h6"
     },
     "h6-light": {
-      "$value": "300 clamp(1.13rem, round(1.1rem + 0.1cqi, 0.1rem), 1.25rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "300 clamp(1.13rem, round(1.101rem + 0.133cqi, 0.01rem), 1.25rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-h6-light"
     },
     "body-xl": {
-      "$value": "400 clamp(1.25rem, round(1.2rem + 0.3cqi, 0.1rem), 1.5rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "400 clamp(1.25rem, round(1.191rem + 0.276cqi, 0.01rem), 1.5rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body-xl"
     },
     "body-lg": {
-      "$value": "400 clamp(1.13rem, round(1.1rem + 0.1cqi, 0.1rem), 1.25rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "400 clamp(1.13rem, round(1.101rem + 0.133cqi, 0.01rem), 1.25rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body-lg"
     },
     "body": {
-      "$value": "400 clamp(1rem, round(1rem + 0.1cqi, 0.1rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "400 clamp(1rem, round(0.969rem + 0.144cqi, 0.01rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body"
     },
-    "body-md": {
-      "$value": "400 clamp(1rem, round(1rem + 0.1cqi, 0.1rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
-      "$type": "typography",
-      "$description": "--text-body-md"
-    },
     "body-bold": {
-      "$value": "700 clamp(1rem, round(1rem + 0.1cqi, 0.1rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "700 clamp(1rem, round(0.969rem + 0.144cqi, 0.01rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body-bold"
     },
-    "body-md-bold": {
-      "$value": "700 clamp(1rem, round(1rem + 0.1cqi, 0.1rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
-      "$type": "typography",
-      "$description": "--text-body-md-bold"
-    },
     "body-semibold": {
-      "$value": "600 clamp(1rem, round(1rem + 0.1cqi, 0.1rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(1rem, round(0.969rem + 0.144cqi, 0.01rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body-semibold"
     },
-    "body-md-semibold": {
-      "$value": "600 clamp(1rem, round(1rem + 0.1cqi, 0.1rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
-      "$type": "typography",
-      "$description": "--text-body-md-semibold"
-    },
     "body-medium": {
-      "$value": "500 clamp(1rem, round(1rem + 0.1cqi, 0.1rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "500 clamp(1rem, round(0.969rem + 0.144cqi, 0.01rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body-medium"
     },
-    "body-md-medium": {
-      "$value": "500 clamp(1rem, round(1rem + 0.1cqi, 0.1rem), 1.13rem)/1.6 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
-      "$type": "typography",
-      "$description": "--text-body-md-medium"
-    },
     "body-sm": {
-      "$value": "400 clamp(0.88rem, round(0.9rem + 0.1cqi, 0.1rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "400 clamp(0.88rem, round(0.851rem + 0.133cqi, 0.01rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body-sm"
     },
     "body-sm-bold": {
-      "$value": "700 clamp(0.88rem, round(0.9rem + 0.1cqi, 0.1rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "700 clamp(0.88rem, round(0.851rem + 0.133cqi, 0.01rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body-sm-bold"
     },
     "body-sm-semibold": {
-      "$value": "600 clamp(0.88rem, round(0.9rem + 0.1cqi, 0.1rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(0.88rem, round(0.851rem + 0.133cqi, 0.01rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body-sm-semibold"
     },
     "body-xs": {
-      "$value": "400 clamp(0.75rem, round(0.7rem + 0.1cqi, 0.1rem), 0.88rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "400 clamp(0.75rem, round(0.719rem + 0.144cqi, 0.01rem), 0.88rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-body-xs"
     },
     "label": {
-      "$value": "500 clamp(0.75rem, round(0.7rem + 0.1cqi, 0.1rem), 0.88rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "500 clamp(0.75rem, round(0.719rem + 0.144cqi, 0.01rem), 0.88rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-label"
     },
     "label-bold": {
-      "$value": "700 clamp(0.75rem, round(0.7rem + 0.1cqi, 0.1rem), 0.88rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "700 clamp(0.75rem, round(0.719rem + 0.144cqi, 0.01rem), 0.88rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-label-bold"
     },
     "caption": {
-      "$value": "400 clamp(0.69rem, round(0.7rem + 0.1cqi, 0.1rem), 0.75rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "400 clamp(0.69rem, round(0.676rem + 0.066cqi, 0.01rem), 0.75rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-caption"
     },
     "caption-bold": {
-      "$value": "600 clamp(0.69rem, round(0.7rem + 0.1cqi, 0.1rem), 0.75rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(0.69rem, round(0.676rem + 0.066cqi, 0.01rem), 0.75rem)/1.4 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-caption-bold"
     },
     "overline": {
-      "$value": "600 clamp(0.88rem, round(0.9rem + 0.1cqi, 0.1rem), 1rem)/1.3 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(0.88rem, round(0.851rem + 0.133cqi, 0.01rem), 1rem)/1.3 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-overline"
     },
     "link": {
-      "$value": "500 clamp(0.94rem, round(0.9rem + 0.1cqi, 0.1rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "500 clamp(0.94rem, round(0.926rem + 0.066cqi, 0.01rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-link"
     },
     "link-bold": {
-      "$value": "700 clamp(0.94rem, round(0.9rem + 0.1cqi, 0.1rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "700 clamp(0.94rem, round(0.926rem + 0.066cqi, 0.01rem), 1rem)/1.5 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-link-bold"
     },
     "button": {
-      "$value": "600 clamp(0.88rem, round(0.9rem + 0.1cqi, 0.1rem), 1rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(0.88rem, round(0.851rem + 0.133cqi, 0.01rem), 1rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-button"
     },
     "button-lg": {
-      "$value": "600 clamp(1rem, round(1rem + 0.1cqi, 0.1rem), 1.13rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(1rem, round(0.969rem + 0.144cqi, 0.01rem), 1.13rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-button-lg"
     },
     "button-sm": {
-      "$value": "600 clamp(0.75rem, round(0.7rem + 0.1cqi, 0.1rem), 0.88rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
+      "$value": "600 clamp(0.75rem, round(0.719rem + 0.144cqi, 0.01rem), 0.88rem)/1.2 Inter, -apple-system, BlinkMacSystemFont, Segoe UI, system-ui, sans-serif",
       "$type": "typography",
       "$description": "--text-button-sm"
     },
     "code": {
-      "$value": "400 clamp(0.88rem, round(0.9rem + 0.1cqi, 0.1rem), 1rem)/1.6 JetBrains Mono, Fira Code, Cascadia Code, Courier New, monospace",
+      "$value": "400 clamp(0.88rem, round(0.851rem + 0.133cqi, 0.01rem), 1rem)/1.6 JetBrains Mono, Fira Code, Cascadia Code, Courier New, monospace",
       "$type": "typography",
       "$description": "--text-code"
     },
     "code-sm": {
-      "$value": "400 clamp(0.75rem, round(0.7rem + 0.1cqi, 0.1rem), 0.88rem)/1.6 JetBrains Mono, Fira Code, Cascadia Code, Courier New, monospace",
+      "$value": "400 clamp(0.75rem, round(0.719rem + 0.144cqi, 0.01rem), 0.88rem)/1.6 JetBrains Mono, Fira Code, Cascadia Code, Courier New, monospace",
       "$type": "typography",
       "$description": "--text-code-sm"
     }

package/bin/postinstall.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-try {
-  if (process.env.CI) {
-    process.exit(0);
-  }
-  console.log('');
-  console.log('⚡ Zeus CSS installed.');
-  console.log('   Run `npx zeus-css init` to get local zeus.config.scss / zeus.customize.scss files you can edit.');
-  console.log('   (Skip this if you only want the default theme via zeus-css/dist/zeus.css.)');
-  console.log('');
-} catch (e) {
-  // Never fail an install just because the reminder couldn't print.
-}

package/scss/.stylelintrc.json

@@ -1,41 +0,0 @@
-{
-  "extends": "stylelint-config-standard-scss",
-  "ignoreFiles": ["zeus.token.sets.example.scss"],
-  "rules": {
-    "no-empty-source": null,
-    "scss/at-rule-no-unknown": true,
-
-    "selector-class-pattern": null,
-    "custom-property-pattern": null,
-    "scss/dollar-variable-pattern": null,
-    "scss/at-function-pattern": null,
-
-    "alpha-value-notation": null,
-    "color-function-notation": null,
-    "hue-degree-notation": null,
-    "value-keyword-case": null,
-
-    "no-descending-specificity": null,
-    "declaration-block-single-line-max-declarations": null,
-    "shorthand-property-no-redundant-values": null,
-    "font-family-name-quotes": null,
-    "property-no-vendor-prefix": null,
-
-    "scss/at-mixin-argumentless-call-parentheses": null,
-    "scss/at-mixin-pattern": null,
-    "scss/at-if-closing-brace-newline-after": null,
-    "scss/at-if-closing-brace-space-after": null,
-    "scss/at-if-no-null": null,
-    "scss/at-else-empty-line-before": null,
-    "scss/double-slash-comment-empty-line-before": null,
-    "scss/double-slash-comment-whitespace-inside": null,
-    "scss/dollar-variable-empty-line-before": null,
-    "scss/dollar-variable-colon-space-after": null,
-    "scss/operator-no-unspaced": null,
-    "declaration-empty-line-before": null,
-    "rule-empty-line-before": null,
-    "at-rule-empty-line-before": null,
-    "comment-empty-line-before": null,
-    "scss/comment-no-empty": null
-  }
-}

package/scss/API.md

@@ -1,175 +0,0 @@
-# Zeus CSS — Public API Surface (v1.0.0)
-
-This document is the semver contract. Everything listed here is **public and
-stable**: it will not change or be removed except in a major version bump
-(`2.0.0`), following [Semantic Versioning](https://semver.org/). Everything
-*not* listed here — including anything explicitly marked "internal" below —
-is free to change in a minor or patch release without notice.
-
-Generated references (`llms.txt`, `cheatsheet.md`, `zeus.tokens.json`) are
-regenerated from source on every `npm run prepack` and always reflect the
-current public surface described here. If they ever disagree with this file,
-this file wins.
-
-## 1. Entry points
-
-| Import | Emits CSS? | Use in |
-|---|---|---|
-| `import "zeus-css/css";` | Yes — precompiled, default tokens only, not customizable | App root, no Sass pipeline |
-| `import "zeus-css/min";` | Yes — same as above, minified | App root, no Sass pipeline, production |
-| `@use "zeus-css/foundation";` | Yes — full compiled framework | App root, once, Sass pipeline |
-| `@use "zeus-css/zeus" as *;` | No — mixins/functions only | Every `.module.scss` |
-| `@use "zeus-css/config";` | No | Only if you need raw access to `$zeus-*` config variables |
-| `@use "zeus-css/customize";` | No | Only if you need raw access to `$zeus-colors` etc. without the rest of config |
-
-`zeus-css/css` and `zeus-css/min` are static builds of `foundation.scss` with
-default tokens baked in at publish time (`npm run build:css`) — they cannot
-reflect `zeus.customize.scss` overrides. Use one of the two SCSS entry points
-below instead if you need custom tokens.
-
-`package.json` → `files` is the authoritative list of what ships: the
-`foundation/**/*.scss` tree, the six entry points above (plus their compiled
-`dist/` output), `zeus.tokens.json`, `llms.txt`, `cheatsheet.md`, `LICENSE`,
-`README.md`, `CHANGELOG.md`. Anything under `foundation/` not reachable
-through `foundation` or `zeus` (see §6) is an implementation detail even
-though the file ships.
-
-## 2. Config variables (`zeus.config.scss`, `zeus.customize.scss`)
-
-Every `!default` variable in these two files is public: name, accepted
-values/shape, and default value are all part of the contract.
-
-**Feature toggles** — `$zeus-enable-responsive-classes`, `$zeus-enable-animation-classes`,
-`$zeus-enable-grid-system`, `$zeus-enable-shadow-classes`,
-`$zeus-enable-color-utilities`, `$zeus-enable-property-registration`.
-
-**Naming & compile strategy** — `$zeus-use-prefix`, `$zeus-class-prefix`,
-`$zeus-version`. All responsive utilities are mobile-first (`min-width`);
-there is no desktop-first mode and no config knob for one — see CHANGELOG
-for the removal rationale.
-
-**Fluid engine bounds** — `$zeus-container-bounds`, `$zeus-root-font-size`,
-`$zeus-focus-ring`.
-
-**Layout** — `$zeus-outer-max-width`, `$zeus-breakpoints`, `$zeus-outer-padding`,
-`$zeus-column-gaps`.
-
-**Design tokens** (`zeus.customize.scss`, forwarded through `zeus.config.scss`)
-— `$zeus-colors`, and every other token map documented inline in that file
-(typography, spacing, radii, border widths, icon sizes, shadows, z-index).
-Reference values for every key: `zeus.token.sets.example.scss`.
-
-Any Sass map above may have individual keys overridden without providing the
-whole map — that merge behavior is itself part of the contract.
-
-## 3. Public mixins & functions
-
-Everything forwarded by `foundation/core/design`, `foundation/core/engine`,
-and `foundation/core/api` — i.e. everything reachable via
-`@use "zeus" as *`. The full catalog with signatures lives in
-[`llms.txt`](llms.txt) / [`cheatsheet.md`](cheatsheet.md) (auto-generated, do
-not hand-edit). Highlights: `padding()`, `margin()`, `gap()`, `border-radius()`,
-`border-line()`, `box-size()`, `text()`, `color()`, `zeus-theme()`,
-`apply-shadow()` / `elevation()` / `hover-shadow()` / `card-shadow()` / the
-rest of the shadow mixin family, `screen-above()` / `screen-below()` /
-`screen-between()` / `suppress-on()`, `fade-in()` / `slide-in()` / `scale()` /
-`bounce()` / `pulse()` / `rotate()`, the `btn-*` mixin family, and the `p()` /
-`m()` / `g()` / `r()` / `t()` / `sz()` shorthand aliases.
-
-**Internal, not public** — anything whose name starts with `_` (e.g.
-`_z-control-base`, `_emit-static-color-vars`, `_register-color-tokens`),
-and every function/mixin in `foundation/core/engine/_fluid-core.scss`, whose
-file header explicitly states it is private. `gen-cheatsheet.mjs` already
-excludes these from the generated catalog for the same reason.
-
-## 4. Public utility class families
-
-Every class family listed in [`llms.txt`](llms.txt) / [`cheatsheet.md`](cheatsheet.md)
-under "Utility Class Families" — layout (`flex-*`, `grid-*`, `d-*`), spacing
-(`gap-*`), color (`bg-*`, `color-*`, `border-color-*`), typography (`text-*`),
-shadows (`shadow-*`), borders (`border-radius-*`, `border-line-*`), sizing
-(`w-*`, `h-*`, `min-w-*`, `max-w-*`, `box-*`, `icon-*`), position (`static`,
-`relative`, `absolute`, `fixed`, `sticky`, `inset-*`, `top-*`, `bottom-*`,
-`inset-inline-start-*`, `inset-inline-end-*`), z-index (`layer-*`), animation
-(`animate-*`, `delay-*`, `duration-*`), aspect ratio (`aspect-*`), opacity
-(`opacity-*`), flex-grow/shrink/order, overflow/object-fit, responsive
-visibility (`hidden-*`), the compound utility classes (`surface`,
-`surface-flat`, `section-wrap`, `section-wrap-narrow`, `glass`, `divider`,
-`sr-only`, `truncate`, `line-clamp-*`, `highlight`, `article`), `.container`,
-and the `btn-*` button classes. (Renamed from the `zeus-*` prefix —
-`.z-*` is reserved exclusively for the framework's fixed BEM components —
-card, modal, form controls — which do NOT participate in
-`$zeus-use-prefix`.)
-
-When `$zeus-use-prefix: true`, every class in this list is emitted with
-`$zeus-class-prefix` prepended — the prefixing behavior itself is part of the
-contract, not just the unprefixed names.
-
-## 5. Public components (`foundation/views/components/`)
-
-These class-based components and their documented modifiers:
-
-- **`.z-card`**, `.z-card__media` and the modifiers documented in `_card.scss`
-- **`.z-modal-backdrop`**, `.z-modal`
-- **`.z-field`**, `.z-field--invalid`, `.z-field-group`, `.z-field__helper`,
-  `.z-field__error`, `.z-label`, `.z-label--required`, `.z-input`,
-  `.z-textarea`, `.z-select`, `.z-checkbox`, `.z-radio`
-- **`.z-badge`** — variants `--primary/--secondary/--accent/--success/
-  --warning/--error`, modifier `--solid`, element `.z-badge__dot`
-- **`.z-alert`**, **`.z-avatar`** (+ `.z-avatar-group`), **`.z-table`**,
-  **`.z-breadcrumb`**, **`.z-pagination`** — variants/elements as documented
-  in their respective partials
-- **`.z-tabs`** — `.z-tabs__list`, `.z-tabs__tab`, `.z-tabs__panel`. State is
-  driven by the native `aria-selected` / `hidden` attributes; which tab is
-  selected is the consumer's to manage (Zeus ships no JS).
-- **`.z-tooltip`**, **`.z-dropdown`** (+ `.z-dropdown__list/__item/__divider`,
-  `__item--danger`) — built on the native `popover` attribute and CSS anchor
-  positioning. See README "Browser support": absence of anchor positioning
-  degrades placement only. Hover-triggered tooltips need consumer JS;
-  `popovertarget` alone gives click-to-toggle.
-- **`.z-toast-region`** + **`.z-toast`** (+ `__icon/__body/__title/__message/
-  __close`, variants `--success/--warning/--danger/--info`) — the region is
-  `popover="manual"`; auto-dismiss timing is the consumer's.
-- **`.z-skeleton`** — modifiers `--text/--title/--avatar/--block`
-
-The private `_z-control-base()` mixin these share is an implementation
-detail (§3) — only the class names and their documented states (default,
-hover, `:focus-visible`, `:disabled`, invalid) are guaranteed.
-
-## 6. Public design tokens (CSS custom properties)
-
-Every CSS custom property emitted by `foundation` (the `--color-*`,
-`--space-*`, `--text-*`, `--shadow-*`, `--border-radius-*`, `--border-line-*`,
-`--size-icon-*`, `--z-*`, and responsive `--*` vars declared in
-`zeus.customize.scss`) is public. The canonical, always-current list — name,
-value, and type — is generated straight from the compiled CSS into
-[`zeus.tokens.json`](zeus.tokens.json) (W3C Design Tokens format) by
-`npm run gen:tokens`; nothing in that file is hand-maintained, so it cannot
-drift from what actually ships.
-
-## 7. What is explicitly NOT public
-
-- Anything under `foundation/views/render/` other than the class names listed
-  in §4 — the internal `load-*` mixins, file layout, and forward chain are
-  free to change.
-- `foundation/core/engine/_fluid-core.scss` and any `_`-prefixed
-  mixin/function anywhere in the tree (§3).
-- The internal cascade-layer wiring (`_layer-order.scss`) and the fact that
-  it must forward first — an implementation detail of how layers get their
-  order, not something consumers should depend on directly.
-- `scripts/*.mjs` (token/cheatsheet generators, and the compile-matrix test
-  suite) — tooling, not shipped API.
-- File/folder structure inside `foundation/` beyond the two entry points —
-  files may be split, merged, or moved as long as the public mixins,
-  functions, classes, and tokens above keep working identically.
-
-## 8. Versioning commitment
-
-Starting at `1.0.0`: no breaking change to anything in §1–§6 without a major
-version bump. A breaking change is any of — a public mixin/function being
-renamed, removed, or changing its required arguments; a public class being
-renamed or removed; a public CSS custom property being renamed, removed, or
-changing what it resolves to for the same config; a config variable's name,
-accepted values, or default changing. Adding new mixins, functions, classes,
-tokens, or config keys is a minor release. Bug fixes that don't change the
-above are patch releases.

package/scss/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Stavros Kosmas Lazaris
-
-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.