@halogen-ui/tokens 0.1.0

package/LICENSE.md

@@ -0,0 +1,102 @@
+# Halogen License Agreement
+
+Copyright © 2026 Nick Jacoy. All rights reserved.
+
+Halogen is **source-available commercial software**. The source is published so
+that it can be read, evaluated and audited before purchase — publication is not
+a grant of the right to use it. Use in a project requires a valid license.
+
+## 1. Definitions
+
+- **"Software"** — the Halogen design system, comprising the `@halogen-ui/react`,
+  `@halogen-ui/tokens` and `@halogen-ui/eslint-config` packages and their source,
+  documentation and generated assets.
+- **"Licensee"** — the individual or single legal entity that has purchased a
+  license.
+- **"Product"** — an application, website or service built by the Licensee in
+  which the Software is used as a component of a larger work.
+
+## 2. Evaluation
+
+Without purchasing a license, you may download, read, run and evaluate the
+Software, including building and running it locally. You may not use it in a
+Product, whether or not that Product is distributed, sold or made public.
+
+## 3. Grant of license
+
+Upon purchase, the Licensee is granted a perpetual, worldwide, non-exclusive,
+non-transferable license to:
+
+a. use the Software in an unlimited number of Products;
+b. modify the Software and use the modified version in those Products;
+c. distribute the Software **as part of** a Product, in compiled or bundled
+   form, to that Product's end users;
+d. make copies as reasonably required for backup and development.
+
+The license covers the Licensee and its employees and contractors, acting on the
+Licensee's behalf.
+
+## 4. Restrictions
+
+The Licensee may not:
+
+a. redistribute, publish, sublicense, sell, rent or lend the Software on its
+   own, or in any form where the Software — rather than a Product built with
+   it — is the substance of what is conveyed;
+b. use the Software to create or contribute to a competing design system,
+   component library, UI kit or template that is distributed to third parties;
+c. remove or obscure copyright, license or attribution notices;
+d. share license credentials or a purchased copy outside the Licensee.
+
+Publishing a fork, a re-skin, or a repackaged subset of the Software to a public
+registry or repository is prohibited under (a) and (b), and this remains true
+however the files were obtained.
+
+## 5. Third-party components
+
+The Software depends on and, in the case of fonts, redistributes third-party
+material licensed separately by its authors — including Radix UI, `clsx`,
+`class-variance-authority`, `tailwind-merge` and `lucide-react` (MIT), and the
+Geist and Geist Mono typefaces (SIL Open Font License 1.1, whose text ships at
+`fonts/LICENSE-Geist-OFL-1.1.txt`). Nothing in this Agreement limits or replaces
+your rights and obligations under those licenses.
+
+## 6. Ownership
+
+The Software is licensed, not sold. All title and intellectual property rights
+in the Software remain with the copyright holder. Rights not expressly granted
+here are reserved.
+
+## 7. Warranty disclaimer
+
+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.
+
+Halogen makes strong accessibility and contrast claims and tests them
+extensively. Those tests are evidence, not a warranty: conformance of *your*
+Product is your responsibility.
+
+## 8. Limitation of liability
+
+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. Total liability shall not exceed the amount paid for
+the license.
+
+## 9. Termination
+
+This license terminates automatically if the Licensee materially breaches it and
+does not cure the breach within 30 days of notice. On termination the Licensee
+must cease using the Software in new Products; Products already distributed are
+unaffected.
+
+## 10. Governing law
+
+This Agreement is governed by the laws of the State of California, United
+States, without regard to its conflict-of-laws rules.
+
+---
+
+Licensing questions: https://github.com/njacoy/halogen-design-system

package/README.md

@@ -0,0 +1,43 @@
+# @halogen-ui/tokens
+
+The token layer for [Halogen](https://github.com/njacoy/halogen-design-system).
+OKLCH-derived, contrast-asserted, and two-layer: primitives hold the values,
+semantics name the jobs, and only the semantic layer is addressable from a
+component.
+
+```bash
+pnpm add @halogen-ui/tokens
+```
+
+## What it exports
+
+| Entry | What it is |
+| --- | --- |
+| `@halogen-ui/tokens` | typed const maps — `semanticTokens`, `primitiveTokens`, `resolved` |
+| `@halogen-ui/tokens/tokens.css` | the custom properties, both themes |
+| `@halogen-ui/tokens/theme.css` | maps them into Tailwind v4's namespaces |
+| `@halogen-ui/tokens/fonts.css` | self-hosted Geist and Geist Mono |
+| `@halogen-ui/tokens/figma` | Figma variables export |
+| `@halogen-ui/tokens/tokens-studio` | Tokens Studio format |
+| `@halogen-ui/tokens/classgroups` | tailwind-merge class groups for the custom namespaces |
+
+```css
+@import '@halogen-ui/tokens/fonts.css';
+@import '@halogen-ui/tokens/tokens.css';
+@import 'tailwindcss';
+@import '@halogen-ui/tokens/theme.css';
+```
+
+The TypeScript entry types each token name as a union, not as `string`, so a
+typo is a compile error at the call site:
+
+```ts
+import { semanticTokens, resolved } from '@halogen-ui/tokens';
+
+semanticTokens['surface-raised'];  // 'var(--halogen-surface-raised)'
+resolved.dark['ink-primary'];      // the resolved OKLCH value
+```
+
+Contrast is asserted, not hoped for: every foreground/background pair the system
+permits is checked against WCAG at build time, and the build fails on a
+regression. See the repository for the report and the reasoning.