@nebutra/tokens 0.1.0 → 0.1.2

package/.turbo/turbo-build.log

@@ -0,0 +1,8 @@
+
+> @nebutra/tokens@0.1.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/design/tokens
+> node scripts/sync-styles.mjs && node scripts/emit-skins.mjs
+
+Formatted 1 file in 9ms. No fixes applied.
+styles.css refreshed from @nebutra/design-tokens
+emit-skins: 7 skins from brand.json → skins/*.css
+  gsap, linear, notion, raycast, stripe, vanta, vercel

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @nebutra/tokens@0.1.2 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/design/tokens
+> tsc --noEmit
+

package/AGENTS.md

@@ -12,7 +12,7 @@ base semantic CSS variables and the light/dark theme-provider surface.
 ## Source Of Truth
 
 - Public package surface and exports: `package.json`, `src/index.ts`
-- Canonical runtime token definitions and semantic CSS variables: `styles.css`
+- Canonical runtime token definitions: `styles.css` (generated from `@nebutra/design-tokens` via `sync-styles.mjs`; keep `verify:parity` at 100%)
 
 ## Contract Boundaries
 
@@ -22,7 +22,10 @@ base semantic CSS variables and the light/dark theme-provider surface.
 - Keep `THEME_IDS` and `DEFAULT_THEME` in `src/index.ts` aligned with the
   actual light/dark behavior implemented in `styles.css`.
 - This package owns the base light/dark token system only. Do not move named
-  product-theme presets here; those belong in `@nebutra/theme`.
+  product-mood presets here. **Design-language catalog & global swap** belong in
+  `@nebutra/theme` (`languages.json`, `applyLanguage`, `skins.css`). Brand Package
+  *engine* (compile / emit / normalize) stays in this package (`brand-package/`).
+  Multi-mood oklch catalogs were deleted — never reintroduce a second root `@theme` primary.
 - Preserve the package boundary between CSS tokens and component usage.
   `@nebutra/ui` and apps should consume the exported CSS surface rather than
   importing token internals.

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# @nebutra/tokens
+
+## 0.1.2
+
+### Patch Changes
+
+- Ship the MIT LICENSE file these packages have always declared but never included.
+
+  Every one of these declares `"license": "MIT"` in its manifest, and npm shows
+  that on the registry page — but the tarball carried no licence text at all.
+  MIT's own terms require the notice to accompany "all copies or substantial
+  portions of the Software", so a consumer vendoring one of these packages had
+  nothing to comply with.
+
+  No code changes. This is the licence text only, published so the tarballs
+  match what the manifests have been claiming.
+
+  `tests/architecture/release-surface.test.ts` now asserts the LICENSE _file_
+  exists and is MIT, not just the manifest _field_ — the field-only check is how
+  this went unnoticed, and is also how `create-sailor` shipped the full AGPL-3.0
+  text under an MIT declaration for its entire published history.
+
+- Updated dependencies []:
+  - @nebutra/design-tokens@0.1.2
+
+## 0.1.1
+
+### Patch Changes
+
+- Publish registry package metadata under the MIT license.
+
+- Updated dependencies []:
+  - @nebutra/design-tokens@0.1.1

package/DESIGN.md

@@ -9,20 +9,36 @@
 | Status | **★ Source of truth for runtime apps** |
 | Source file | `packages/design/tokens/styles.css` |
 | Tailwind integration | Tailwind v4 `@theme inline` block in same file |
-| Re-exports | `ThemeProvider`, `useTheme` from `next-themes` |
+| Re-exports | Custom `ThemeProvider` / `useTheme` (cookie + class; not next-themes) |
 
 ---
 
 ## 1. Identity
 
-This package emits the **runtime CSS variables** consumed by every Nebutra app. Apps import via:
+This package emits the **runtime CSS variables** consumed by every Nebutra app.
+
+### App consumption contract (package-owned)
+
+Apps should **not** hand-roll monorepo `@source` paths. Import the UI entry:
 
 ```css
-/* apps/{app}/src/app/globals.css */
+/* Simple apps */
+@import "@nebutra/ui/styles/preset.css";
+
+/* Or: tokens yourself + package-owned source scan */
 @import "tailwindcss";
 @import "@nebutra/tokens/styles.css";
+@import "@nebutra/ui/styles/sources.css";
 ```
 
+| Layer | Entry | Role |
+|-------|-------|------|
+| Tokens | `@nebutra/tokens/styles.css` | CSS variables + `@theme` only |
+| UI sources | `@nebutra/ui/styles/sources.css` | Tailwind `@source` for CVA classes (owned by UI package) |
+| UI preset | `@nebutra/ui/styles/preset.css` | tailwind + tokens + sources + fonts |
+
+Tokens alone never style `Input`/`Button` — utilities come from scanning UI.
+
 Tokens are organized in three concentric rings:
 
 ```
@@ -109,7 +125,14 @@ Scales: `--neutral-{1..12}`, `--blue-{1..12}`, `--cyan-{1..12}`. Light values ar
 | `--brand-primary` | `var(--blue-9)` → `#0033FE` | Primary brand |
 | `--brand-accent` | `var(--cyan-9)` → `#0BF1C3` | Accent |
 | `--brand-tertiary` | `#8B5CF6` | Data viz / infra tags only |
-| `--brand-gradient` | `linear-gradient(135deg, blue-500 → cyan-500)` | CTAs, hero text |
+| `--primary` | `228 85% 56%` → soft blue for UI | **Canonical product CTA** (`bg-primary`, `Button` default) |
+| `--brand-primary` | `#0033FE` | VI 云毓蓝 — logo / identity |
+| `--brand-gradient` | `hsl(var(--primary))` | **Legacy alias of `--primary`**, not a separate color. Prefer `Button` / `bg-primary`. |
+| `--brand-gradient-logo` | `linear-gradient(135deg, #0033FE → #00A2E9 → #0BF1C3)` | Logo/VI only (OKLab mid stop) |
+
+**CTA rule:** use existing `@nebutra/ui` `Button` (`bg-primary`). Do not invent parallel “action” colors. `#0033FE` is identity; UI softens via `--primary` already defined in `themes/light.json`.
+
+**Logo gradient / dirty-mid rule:** `--brand-gradient-logo` must keep **three hex stops** ending in `#0033fe` → `#00a2e9` → `#0bf1c3` (see `semantic.json` + `verify-brand-token-sync`). Mid `#00a2e9` is the OKLab midpoint — prevents soft/gray mids on large VI surfaces. Product chrome must not reintroduce multi-stop blue→cyan as button fills. Full guidance: [`packages/design/brand/DESIGN.md` §2.2](../brand/DESIGN.md#22-brand-gradient).
 
 ### 2.4 Semantic theme tokens (HSL triplets — Tailwind compatible)
 
@@ -293,9 +316,9 @@ import { colors } from "@nebutra/ui/theme";  // deprecated
 
 ## 5. Theming
 
-Light/dark switching: handled by `next-themes` via the `class` attribute. The `.dark` selector inside `styles.css` overrides every semantic token plus inverts the 12-step scales (step 1 = darkest, step 12 = lightest in dark mode).
+Light/dark switching: handled by `@nebutra/tokens` `ThemeProvider` via the `class` attribute (`class="dark"`). The `.dark` selector inside `styles.css` (generated from design-tokens) overrides every semantic token plus inverts the 12-step scales (step 1 = darkest, step 12 = lightest in dark mode).
 
-For the **multi-theme product feature** (6 oklch presets), see [`packages/design/theme/DESIGN.md`](../theme/DESIGN.md).
+For **design-language swap** (Brand Packages / `applyLanguage`), see [`packages/design/theme/DESIGN.md`](../theme/DESIGN.md).
 
 ---
 
@@ -304,6 +327,7 @@ For the **multi-theme product feature** (6 oklch presets), see [`packages/design
 | Surface | Status |
 |--------|--------|
 | Brand color hex anchors (`#0033FE`, `#0BF1C3`, `--nebutra-neutral-{50..950}`) | **Locked** |
+| UI CTA color | Use `--primary` / `Button`; `--brand-gradient` is a legacy alias of `--primary` |
 | 12-step semantic ladder positions (1–12 meaning) | **Locked** |
 | Container widths | **Locked** |
 | Radius scale values | **Locked** |