@nebutra/tokens 0.1.0 → 0.1.1

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+> @nebutra/tokens@0.1.1 build /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/design/tokens
+> node -e "const fs=require('node:fs'),src='../design-tokens/build/css/styles.generated.css';if(fs.existsSync(src)){fs.copyFileSync(src,'./styles.css');console.log('styles.css refreshed from @nebutra/design-tokens')}else{console.log('styles.css kept (committed copy used; design-tokens build/ absent — likely Turbo cache restore without files)')}"
+
+styles.css refreshed from @nebutra/design-tokens

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @nebutra/tokens@0.1.1 typecheck /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/design/tokens
+> tsc --noEmit
+

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @nebutra/tokens
+
+## 0.1.1
+
+### Patch Changes
+
+- Publish registry package metadata under the MIT license.
+
+- Updated dependencies []:
+  - @nebutra/design-tokens@0.1.1

package/DESIGN.md

@@ -109,7 +109,8 @@ 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 |
+| `--brand-gradient` | `linear-gradient(135deg, #254BFA → #057963)` | UI usage gradient for CTAs, badges, hero text |
+| `--brand-gradient-logo` | `linear-gradient(135deg, #0033FE → #0BF1C3)` | VI/logo assets only |
 
 ### 2.4 Semantic theme tokens (HSL triplets — Tailwind compatible)
 
@@ -304,6 +305,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 brand gradient (`--brand-gradient`) | Extensible — may tune saturation/contrast while preserving locked brand anchors |
 | 12-step semantic ladder positions (1–12 meaning) | **Locked** |
 | Container widths | **Locked** |
 | Radius scale values | **Locked** |

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@nebutra/tokens",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Unified theme tokens and theme-provider entry for Nebutra apps",
   "private": false,
-  "license": "AGPL-3.0",
+  "license": "MIT",
   "type": "module",
   "sideEffects": [
     "./styles.css"
@@ -16,7 +16,7 @@
   },
   "dependencies": {
     "next-themes": "^0.4.6",
-    "@nebutra/design-tokens": "0.1.0"
+    "@nebutra/design-tokens": "0.1.1"
   },
   "peerDependencies": {
     "react": "^19"
@@ -39,7 +39,7 @@
   },
   "scripts": {
     "build": "node -e \"const fs=require('node:fs'),src='../design-tokens/build/css/styles.generated.css';if(fs.existsSync(src)){fs.copyFileSync(src,'./styles.css');console.log('styles.css refreshed from @nebutra/design-tokens')}else{console.log('styles.css kept (committed copy used; design-tokens build/ absent — likely Turbo cache restore without files)')}\"",
-    "sync": "pnpm --filter @nebutra/design-tokens build && node -e \"require('node:fs').copyFileSync('../design-tokens/build/css/styles.generated.css', './styles.css')\"",
+    "sync": "corepack pnpm --filter @nebutra/design-tokens build && node -e \"require('node:fs').copyFileSync('../design-tokens/build/css/styles.generated.css', './styles.css')\"",
     "typecheck": "tsc --noEmit"
   }
 }

package/src/theme-provider.tsx

@@ -42,8 +42,12 @@ const THEMES = ["light", "dark", "system"] as const satisfies readonly Theme[];
 export const THEME_STORAGE_KEY = "theme";
 
 interface ThemeContextValue {
+  /** Whether a real ThemeProvider is present above the consumer. */
+  isProviderBound: boolean;
   /** The raw user preference. May be "system". */
   theme: Theme;
+  /** Provider-level override for demos, locked routes, or embedded previews. */
+  forcedTheme?: Theme | undefined;
   /** The concretely-applied theme — always "light" or "dark". */
   resolvedTheme: ResolvedTheme;
   /** The OS-level preference (always concrete). */
@@ -62,7 +66,9 @@ export function useTheme(): ThemeContextValue {
   const ctx = useContext(ThemeContext);
   if (ctx) return ctx;
   return {
+    isProviderBound: false,
     theme: "system",
+    forcedTheme: undefined,
     resolvedTheme: "light",
     systemTheme: "light",
     setTheme: () => {
@@ -145,6 +151,8 @@ export interface ThemeProviderProps {
   defaultTheme?: Theme;
   /** Whether `"system"` is a valid theme that tracks `prefers-color-scheme`. */
   enableSystem?: boolean;
+  /** Lock the rendered theme and expose read-only state to controls. */
+  forcedTheme?: Theme | undefined;
   /** Suppress CSS transitions during the swap. Default: `true`. */
   disableTransitionOnChange?: boolean;
   /** Storage key under which the preference is persisted. */
@@ -158,17 +166,20 @@ export function ThemeProvider({
   attribute = "class",
   defaultTheme = "system",
   enableSystem = true,
+  forcedTheme,
   disableTransitionOnChange = true,
   storageKey = THEME_STORAGE_KEY,
 }: ThemeProviderProps) {
   const [theme, setThemeState] = useState<Theme>(() => readStoredTheme(storageKey, defaultTheme));
   const [systemTheme, setSystemTheme] = useState<ResolvedTheme>(() => resolveSystemTheme());
 
+  const effectiveTheme = forcedTheme ?? theme;
   const resolvedTheme: ResolvedTheme =
-    theme === "system" ? (enableSystem ? systemTheme : "light") : theme;
+    effectiveTheme === "system" ? (enableSystem ? systemTheme : "light") : effectiveTheme;
 
   const setTheme = useCallback(
     (next: Theme) => {
+      if (forcedTheme !== undefined) return;
       setThemeState(next);
       try {
         if (next === "system") {
@@ -180,7 +191,7 @@ export function ThemeProvider({
         // localStorage may be disabled — accept the loss
       }
     },
-    [storageKey],
+    [forcedTheme, storageKey],
   );
 
   // Apply the resolved theme to the DOM AND sync the cookie so the next
@@ -218,13 +229,15 @@ export function ThemeProvider({
 
   const value = useMemo<ThemeContextValue>(
     () => ({
+      isProviderBound: true,
       theme,
+      forcedTheme,
       resolvedTheme,
       systemTheme,
       setTheme,
       themes: THEMES,
     }),
-    [theme, resolvedTheme, systemTheme, setTheme],
+    [theme, forcedTheme, resolvedTheme, systemTheme, setTheme],
   );
 
   return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;

package/styles.css

@@ -69,13 +69,6 @@
   --nebutra-gray-800: #262626;
   --nebutra-gray-900: #171717;
   --nebutra-gray-950: #0a0a0a;
-  --brand-tertiary: #8b5cf6; /** Tertiary accent — data viz, infrastructure tags */
-  --status-danger: #ef4444;
-  --status-warning: #f59e0b;
-  --status-success: #22c55e; /** Tailwind green-500 — VI manual canonical success color (replaces drifted #10b981 emerald). */
-  --container-text: 896px; /** Reading-focused (hero copy, FAQ) */
-  --container-content: 1152px; /** Pricing, blog */
-  --container-wide: 1400px; /** Feature bento, navbar */
   --radius-none: 0;
   --radius-sm: 0.25rem;
   --radius-md: 0.375rem;
@@ -112,10 +105,12 @@
   --brand-primary: #0033fe; /** Brand primary — 云毓蓝 */
   --brand-accent: #0bf1c3; /** Brand accent — 云毓青 */
   --brand-tertiary: #8b5cf6;
-  --brand-gradient: linear-gradient(135deg, #0033fe 0%, #0bf1c3 100%); /** Brand gradient — Logo standard 135° */
-  --brand-gradient-reverse: linear-gradient(135deg, #0bf1c3 0%, #0033fe 100%);
-  --brand-gradient-vertical: linear-gradient(180deg, #0033fe 0%, #0bf1c3 100%);
-  --brand-gradient-radial: radial-gradient(circle, #0bf1c3 0%, #0033fe 100%);
+  --brand-gradient: linear-gradient(135deg, #254bfa 0%, #057963 100%); /** UI brand gradient — usage-adjusted from the locked VI blue/cyan anchors to reduce saturation and preserve white-text contrast. */
+  --brand-gradient-reverse: linear-gradient(135deg, #057963 0%, #254bfa 100%);
+  --brand-gradient-vertical: linear-gradient(180deg, #254bfa 0%, #057963 100%);
+  --brand-gradient-radial: radial-gradient(circle, #057963 0%, #254bfa 100%);
+  --brand-gradient-logo: linear-gradient(135deg, #0033fe 0%, #0bf1c3 100%); /** Logo/VI standard gradient. Use for brand assets only; product UI should use --brand-gradient. */
+  --brand-gradient-logo-reverse: linear-gradient(135deg, #0bf1c3 0%, #0033fe 100%);
   --status-danger: #ef4444;
   --status-warning: #f59e0b;
   --status-success: #22c55e;
@@ -259,6 +254,8 @@
   --gradient-brand-reverse: var(--brand-gradient-reverse);
   --gradient-brand-radial: var(--brand-gradient-radial);
   --gradient-brand-glow: var(--brand-gradient-radial);
+  --gradient-brand-logo: var(--brand-gradient-logo);
+  --gradient-brand-logo-reverse: var(--brand-gradient-logo-reverse);
   --gradient-section: var(--brand-gradient-vertical);
   --gradient-glow: var(--brand-gradient-radial);
 }
@@ -342,13 +339,6 @@
   --nebutra-gray-800: #262626;
   --nebutra-gray-900: #171717;
   --nebutra-gray-950: #0a0a0a;
-  --brand-tertiary: #8b5cf6; /** Tertiary accent — data viz, infrastructure tags */
-  --status-danger: #ef4444;
-  --status-warning: #f59e0b;
-  --status-success: #22c55e; /** Tailwind green-500 — VI manual canonical success color (replaces drifted #10b981 emerald). */
-  --container-text: 896px; /** Reading-focused (hero copy, FAQ) */
-  --container-content: 1152px; /** Pricing, blog */
-  --container-wide: 1400px; /** Feature bento, navbar */
   --radius-none: 0;
   --radius-sm: 0.25rem;
   --radius-md: 0.375rem;
@@ -385,10 +375,12 @@
   --brand-primary: #5c7cfa; /** Dark-mode brand primary — visible against dark surfaces (uses --blue-9 = nebutra-blue-400). */
   --brand-accent: #1af7c8; /** Dark-mode brand accent — visible against dark surfaces (uses --cyan-9 = nebutra-cyan-400). */
   --brand-tertiary: #8b5cf6;
-  --brand-gradient: linear-gradient(135deg, #0033fe 0%, #0bf1c3 100%); /** Brand gradient — Logo standard 135° */
-  --brand-gradient-reverse: linear-gradient(135deg, #0bf1c3 0%, #0033fe 100%);
-  --brand-gradient-vertical: linear-gradient(180deg, #0033fe 0%, #0bf1c3 100%);
-  --brand-gradient-radial: radial-gradient(circle, #0bf1c3 0%, #0033fe 100%);
+  --brand-gradient: linear-gradient(135deg, #254bfa 0%, #057963 100%); /** UI brand gradient — usage-adjusted from the locked VI blue/cyan anchors to reduce saturation and preserve white-text contrast. */
+  --brand-gradient-reverse: linear-gradient(135deg, #057963 0%, #254bfa 100%);
+  --brand-gradient-vertical: linear-gradient(180deg, #254bfa 0%, #057963 100%);
+  --brand-gradient-radial: radial-gradient(circle, #057963 0%, #254bfa 100%);
+  --brand-gradient-logo: linear-gradient(135deg, #0033fe 0%, #0bf1c3 100%); /** Logo/VI standard gradient. Use for brand assets only; product UI should use --brand-gradient. */
+  --brand-gradient-logo-reverse: linear-gradient(135deg, #0bf1c3 0%, #0033fe 100%);
   --status-danger: #ef4444;
   --status-warning: #f59e0b;
   --status-success: #22c55e;
@@ -526,6 +518,8 @@
   --gradient-brand-reverse: var(--brand-gradient-reverse);
   --gradient-brand-radial: var(--brand-gradient-radial);
   --gradient-brand-glow: var(--brand-gradient-radial);
+  --gradient-brand-logo: var(--brand-gradient-logo);
+  --gradient-brand-logo-reverse: var(--brand-gradient-logo-reverse);
   --gradient-section: var(--brand-gradient-vertical);
   --gradient-glow: var(--brand-gradient-radial);
 }