@airframeui/tokens 0.0.1

package/LICENSE

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

@@ -0,0 +1,49 @@
+# @airframeui/tokens
+
+**CSS is the source of truth** for all @airframeui tokens. Tokens are defined in CSS source files and automatically generated into multiple formats.
+
+## Source Files (Edit These)
+
+All tokens are defined in CSS files in `src/`:
+
+- `tokens.base.css` - Base primitives (colors, spacing, typography, breakpoints)
+- `tokens.light.css` - Light theme semantic tokens
+- `tokens.dark.css` - Dark theme tokens
+- `tokens.high-contrast.css` - High contrast theme tokens
+
+## Generated Outputs (Auto-generated)
+
+Running `npm run build` generates:
+
+- `dist/tokens.css` - Combined CSS with all tokens (used by `@airframeui/core`)
+- `dist/tokens.json` - Machine-readable token map for docs/lint/migrate/tools
+- `dist/tokens.js` - JavaScript module export
+- `dist/index.d.ts` - TypeScript definitions
+
+## Token model (v1)
+
+- **Primitives**: literal values (hex colors, base sizes) - defined in `tokens.base.css`
+- **Semantic tokens**: meaningful aliases that components consume - defined in theme CSS files
+- **Interaction knobs**: global percentages for hover/active/soft generation
+
+Primitives are intentionally easy to override:
+
+```css
+:root {
+  --af-base-primary: #018183;
+}
+```
+
+## Building
+
+```bash
+npm run build      # Build once
+npm run dev        # Build and watch for changes
+```
+
+## License
+
+Airframe core libraries are licensed under the MIT License.
+
+Commercial tooling, premium themes, and hosted services
+may be offered under separate commercial licenses.

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export type AirframeTokens = {
+  meta: { version: string; generatedAt: string };
+  primitives: Record<string, string>;
+  breakpoints?: Record<string, string>;
+  knobs: Record<string, string>;
+  semantic: Record<string, string>;
+  components: Record<string, string>;
+  themes?: Record<string, {
+    primitives?: Record<string, string>;
+    semantic?: Record<string, string>;
+  }>;
+};
+export declare const tokens: AirframeTokens;

package/dist/index.js

@@ -0,0 +1 @@
+export * from './tokens.js';