@yuva-devlab/tokens 1.0.0 → 1.1.1

package/README.md

@@ -1,48 +1,21 @@
-# 🎨 @yuva-devlab/tokens
+# @yuva-devlab/tokens
 
-[![npm version](https://img.shields.io/npm/v/@yuva-devlab/tokens.svg)](https://www.npmjs.com/package/@yuva-devlab/tokens)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-
-> Tailwind CSS 4 preset and design token theme bridge for the Yuva DevLab Design System.
-
-## Features
-
-- 🎨 **Tailwind CSS 4 Preset** - Native `@theme inline` mappings bridging tokens to Tailwind utilities
-- 🌓 **Modern OKLCH Color Tokens** - Clean, perceptual contrast in light and dark modes
-- 🚀 **Zero-Config Theming** - Drop-in theme presets for applications (FinAI, OrchestrAI)
-- 🎯 **Pure CSS** - Zero runtime overhead and zero JS dependencies
+Design tokens, color themes, and Tailwind CSS 4 preset bridge for the Yuva DevLab ecosystem.
 
 ## Installation
 
 ```bash
-# npm
-npm install @yuva-devlab/tokens
-
-# yarn
-yarn add @yuva-devlab/tokens
-
-# pnpm
 pnpm add @yuva-devlab/tokens
 ```
 
-## Usage with Tailwind CSS 4
+## Usage
+
+### Tailwind CSS 4 Preset
 
-In your application's global CSS (e.g. `globals.css`):
+In your root stylesheet:
 
 ```css
 @import "tailwindcss";
 @import "@yuva-devlab/tokens/preset.css";
-
-/* Include your target app theme */
-@import "@yuva-devlab/tokens/themes/finai.css";
-/* or @import "@yuva-devlab/tokens/themes/orchestrai.css"; */
+@import "@yuva-devlab/tokens/themes/orchestrai.css";
 ```
-
-## Available Themes
-
-- `@yuva-devlab/tokens/themes/finai.css`: Emerald & forest-green palette optimized for financial clarity and trust.
-- `@yuva-devlab/tokens/themes/orchestrai.css`: Modern high-contrast tech palette for orchestration dashboards.
-
-## License
-
-MIT © Yuva Devlab

package/dist/index.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+// src/index.ts
+var THEMES = ["orchestrai", "finai"];
+var BRAND_MODES = ["light", "dark"];
+var THEME_CONFIGS = {
+  orchestrai: {
+    name: "orchestrai",
+    defaultMode: "dark",
+    label: "OrchestrAI"
+  },
+  finai: {
+    name: "finai",
+    defaultMode: "dark",
+    label: "FinAI"
+  }
+};
+
+exports.BRAND_MODES = BRAND_MODES;
+exports.THEMES = THEMES;
+exports.THEME_CONFIGS = THEME_CONFIGS;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAKO,IAAM,MAAA,GAAS,CAAC,YAAA,EAAc,OAAO;AAGrC,IAAM,WAAA,GAAc,CAAC,OAAA,EAAS,MAAM;AASpC,IAAM,aAAA,GAAgD;AAAA,EAC3D,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,YAAA;AAAA,IACN,WAAA,EAAa,MAAA;AAAA,IACb,KAAA,EAAO;AAAA,GACT;AAAA,EACA,KAAA,EAAO;AAAA,IACL,IAAA,EAAM,OAAA;AAAA,IACN,WAAA,EAAa,MAAA;AAAA,IACb,KAAA,EAAO;AAAA;AAEX","file":"index.cjs","sourcesContent":["/**\n * @file src/index.ts\n * @description Yuva DevLab Design System — Design Tokens & Theme Definitions.\n */\n\nexport const THEMES = [\"orchestrai\", \"finai\"] as const;\nexport type ThemeName = (typeof THEMES)[number];\n\nexport const BRAND_MODES = [\"light\", \"dark\"] as const;\nexport type BrandMode = (typeof BRAND_MODES)[number];\n\nexport interface ThemeConfig {\n  readonly name: ThemeName;\n  readonly defaultMode: BrandMode;\n  readonly label: string;\n}\n\nexport const THEME_CONFIGS: Record<ThemeName, ThemeConfig> = {\n  orchestrai: {\n    name: \"orchestrai\",\n    defaultMode: \"dark\",\n    label: \"OrchestrAI\",\n  },\n  finai: {\n    name: \"finai\",\n    defaultMode: \"dark\",\n    label: \"FinAI\",\n  },\n} as const;\n"]}

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+/**
+ * @file src/index.ts
+ * @description Yuva DevLab Design System — Design Tokens & Theme Definitions.
+ */
+declare const THEMES: readonly ["orchestrai", "finai"];
+type ThemeName = (typeof THEMES)[number];
+declare const BRAND_MODES: readonly ["light", "dark"];
+type BrandMode = (typeof BRAND_MODES)[number];
+interface ThemeConfig {
+    readonly name: ThemeName;
+    readonly defaultMode: BrandMode;
+    readonly label: string;
+}
+declare const THEME_CONFIGS: Record<ThemeName, ThemeConfig>;
+
+export { BRAND_MODES, type BrandMode, THEMES, THEME_CONFIGS, type ThemeConfig, type ThemeName };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file src/index.ts
+ * @description Yuva DevLab Design System — Design Tokens & Theme Definitions.
+ */
+declare const THEMES: readonly ["orchestrai", "finai"];
+type ThemeName = (typeof THEMES)[number];
+declare const BRAND_MODES: readonly ["light", "dark"];
+type BrandMode = (typeof BRAND_MODES)[number];
+interface ThemeConfig {
+    readonly name: ThemeName;
+    readonly defaultMode: BrandMode;
+    readonly label: string;
+}
+declare const THEME_CONFIGS: Record<ThemeName, ThemeConfig>;
+
+export { BRAND_MODES, type BrandMode, THEMES, THEME_CONFIGS, type ThemeConfig, type ThemeName };

package/dist/index.js

@@ -0,0 +1,19 @@
+// src/index.ts
+var THEMES = ["orchestrai", "finai"];
+var BRAND_MODES = ["light", "dark"];
+var THEME_CONFIGS = {
+  orchestrai: {
+    name: "orchestrai",
+    defaultMode: "dark",
+    label: "OrchestrAI"
+  },
+  finai: {
+    name: "finai",
+    defaultMode: "dark",
+    label: "FinAI"
+  }
+};
+
+export { BRAND_MODES, THEMES, THEME_CONFIGS };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAKO,IAAM,MAAA,GAAS,CAAC,YAAA,EAAc,OAAO;AAGrC,IAAM,WAAA,GAAc,CAAC,OAAA,EAAS,MAAM;AASpC,IAAM,aAAA,GAAgD;AAAA,EAC3D,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,YAAA;AAAA,IACN,WAAA,EAAa,MAAA;AAAA,IACb,KAAA,EAAO;AAAA,GACT;AAAA,EACA,KAAA,EAAO;AAAA,IACL,IAAA,EAAM,OAAA;AAAA,IACN,WAAA,EAAa,MAAA;AAAA,IACb,KAAA,EAAO;AAAA;AAEX","file":"index.js","sourcesContent":["/**\n * @file src/index.ts\n * @description Yuva DevLab Design System — Design Tokens & Theme Definitions.\n */\n\nexport const THEMES = [\"orchestrai\", \"finai\"] as const;\nexport type ThemeName = (typeof THEMES)[number];\n\nexport const BRAND_MODES = [\"light\", \"dark\"] as const;\nexport type BrandMode = (typeof BRAND_MODES)[number];\n\nexport interface ThemeConfig {\n  readonly name: ThemeName;\n  readonly defaultMode: BrandMode;\n  readonly label: string;\n}\n\nexport const THEME_CONFIGS: Record<ThemeName, ThemeConfig> = {\n  orchestrai: {\n    name: \"orchestrai\",\n    defaultMode: \"dark\",\n    label: \"OrchestrAI\",\n  },\n  finai: {\n    name: \"finai\",\n    defaultMode: \"dark\",\n    label: \"FinAI\",\n  },\n} as const;\n"]}

package/dist/preset.css

@@ -0,0 +1,408 @@
+/**
+ * Yuva DevLab Design System — Tailwind CSS 4 Preset Bridge
+ *
+ * Maps standard design tokens and CSS custom properties to Tailwind utility classes.
+ * Acts as the universal preset and neutral baseline when no brands are mapped.
+ * Zero individual brand tokens are declared here.
+ * Can be consumed downstream via: `@import "@yuva-devlab/tokens/preset.css";`
+ */
+
+/* ── Neutral Fallback Baseline (Active when no brands are mapped) ─────────── */
+:root {
+  --radius: 0.75rem;
+
+  /* Surfaces */
+  --background: oklch(0.985 0 0);
+  --foreground: oklch(0.18 0.01 260);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.18 0.01 260);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.18 0.01 260);
+
+  /* Core Neutral Action */
+  --primary: oklch(0.35 0.04 260);
+  --primary-foreground: oklch(0.99 0 0);
+  --secondary: oklch(0.96 0.005 260);
+  --secondary-foreground: oklch(0.2 0.01 260);
+
+  /* Muted / Accent */
+  --muted: oklch(0.96 0.005 260);
+  --muted-foreground: oklch(0.5 0.01 260);
+  --accent: oklch(0.94 0.01 260);
+  --accent-foreground: oklch(0.2 0.01 260);
+
+  /* System Status Feedback */
+  --destructive: oklch(0.6 0.22 25);
+  --destructive-foreground: oklch(0.99 0 0);
+  --warning: oklch(0.75 0.14 80);
+  --warning-foreground: oklch(0.2 0.02 80);
+  --success: oklch(0.65 0.15 150);
+  --success-foreground: oklch(0.99 0 0);
+  --info: oklch(0.68 0.13 245);
+  --info-foreground: oklch(0.99 0 0);
+
+  /* Form & Interactive */
+  --border: oklch(0.92 0.005 260);
+  --input: oklch(0.92 0.005 260);
+  --ring: oklch(0.35 0.04 260);
+
+  /* Surfaces & Overlay */
+  --surface: oklch(1 0 0 / 70%);
+  --surface-2: oklch(0.975 0.005 260);
+  --overlay: oklch(0.985 0 0 / 80%);
+
+  /* Navigation & Sidebar */
+  --sidebar: oklch(1 0 0);
+  --sidebar-foreground: oklch(0.18 0.01 260);
+  --sidebar-primary: oklch(0.35 0.04 260);
+  --sidebar-primary-foreground: oklch(0.99 0 0);
+  --sidebar-accent: oklch(0.95 0.01 260);
+  --sidebar-accent-foreground: oklch(0.2 0.01 260);
+  --sidebar-border: oklch(0.92 0.005 260);
+  --sidebar-ring: oklch(0.35 0.04 260);
+
+  /* Charts */
+  --chart-1: oklch(0.6 0.15 250);
+  --chart-2: oklch(0.65 0.15 150);
+  --chart-3: oklch(0.7 0.12 70);
+  --chart-4: oklch(0.75 0.14 80);
+  --chart-5: oklch(0.6 0.18 25);
+
+  /* Sizing, Spacing & Layout */
+  --control-height-xs: 1.75rem;
+  --control-height-sm: 2rem;
+  --control-height-md: 2.25rem;
+  --control-height-lg: 2.5rem;
+  --control-height-xl: 3rem;
+
+  --icon-xs: 0.875rem;
+  --icon-sm: 1rem;
+  --icon-md: 1.25rem;
+  --icon-lg: 1.5rem;
+  --icon-xl: 2rem;
+
+  --space-1: 0.25rem;
+  --space-2: 0.5rem;
+  --space-3: 0.75rem;
+  --space-4: 1rem;
+  --space-5: 1.25rem;
+  --space-6: 1.5rem;
+  --space-8: 2rem;
+  --space-10: 2.5rem;
+
+  --card-padding: var(--space-4);
+  --dialog-padding: var(--space-5);
+  --form-field-gap: var(--space-3);
+  --section-gap: var(--space-5);
+  --table-row-padding-x: var(--space-4);
+  --table-row-padding-y: var(--space-3);
+}
+
+.dark,
+[data-theme="dark"] {
+  --radius: 0.75rem;
+
+  /* Surfaces */
+  --background: oklch(0.16 0.01 260);
+  --foreground: oklch(0.97 0.003 260);
+  --card: oklch(0.2 0.01 260);
+  --card-foreground: oklch(0.97 0.003 260);
+  --popover: oklch(0.2 0.01 260);
+  --popover-foreground: oklch(0.97 0.003 260);
+
+  /* Core Neutral Action */
+  --primary: oklch(0.75 0.05 260);
+  --primary-foreground: oklch(0.15 0.01 260);
+  --secondary: oklch(0.25 0.01 260);
+  --secondary-foreground: oklch(0.97 0.003 260);
+
+  /* Muted / Accent */
+  --muted: oklch(0.25 0.01 260);
+  --muted-foreground: oklch(0.7 0.01 260);
+  --accent: oklch(0.3 0.02 260);
+  --accent-foreground: oklch(0.95 0.005 260);
+
+  /* System Status Feedback */
+  --destructive: oklch(0.65 0.2 25);
+  --destructive-foreground: oklch(0.97 0.003 0);
+  --warning: oklch(0.75 0.14 80);
+  --warning-foreground: oklch(0.15 0.02 80);
+  --success: oklch(0.7 0.15 150);
+  --success-foreground: oklch(0.15 0.01 260);
+  --info: oklch(0.72 0.12 245);
+  --info-foreground: oklch(0.15 0.01 260);
+
+  /* Form & Interactive */
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 14%);
+  --ring: oklch(0.75 0.05 260);
+
+  /* Surfaces & Overlay */
+  --surface: oklch(0.22 0.01 260 / 70%);
+  --surface-2: oklch(0.235 0.01 260);
+  --overlay: oklch(0.11 0.01 260 / 80%);
+
+  /* Navigation & Sidebar */
+  --sidebar: oklch(0.18 0.01 260);
+  --sidebar-foreground: oklch(0.97 0.003 260);
+  --sidebar-primary: oklch(0.75 0.05 260);
+  --sidebar-primary-foreground: oklch(0.15 0.01 260);
+  --sidebar-accent: oklch(0.26 0.01 260);
+  --sidebar-accent-foreground: oklch(0.97 0.003 260);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.75 0.05 260);
+
+  /* Charts */
+  --chart-1: oklch(0.7 0.15 250);
+  --chart-2: oklch(0.72 0.15 150);
+  --chart-3: oklch(0.75 0.12 70);
+  --chart-4: oklch(0.8 0.14 80);
+  --chart-5: oklch(0.65 0.18 25);
+}
+
+@theme inline {
+  /* ── Radii Mappings ─────────────────────────────────────────────── */
+  --radius-sm: calc(var(--radius, 0.5rem) - 4px);
+  --radius-md: calc(var(--radius, 0.5rem) - 2px);
+  --radius-lg: var(--radius, 0.5rem);
+  --radius-xl: calc(var(--radius, 0.5rem) + 4px);
+  --radius-2xl: calc(var(--radius, 0.5rem) + 8px);
+  --radius-3xl: calc(var(--radius, 0.5rem) + 12px);
+  --radius-4xl: calc(var(--radius, 0.5rem) + 16px);
+
+  /* ── Semantic Color Tokens ─────────────────────────────────────── */
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+
+  /* ── Contextual System Colors ──────────────────────────────────── */
+  --color-success: var(--success);
+  --color-success-foreground: var(--success-foreground);
+  --color-warning: var(--warning);
+  --color-warning-foreground: var(--warning-foreground);
+  --color-info: var(--info);
+  --color-info-foreground: var(--info-foreground);
+  --color-overlay: var(--overlay);
+
+  /* ── Glass / Surface Tokens ───────────────────────────────────── */
+  --color-surface: var(--surface);
+  --color-surface-2: var(--surface-2);
+
+  /* ── Navigation & Sidebar ──────────────────────────────────────── */
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+
+  /* ── Visual Data Telemetry (Charts) ──────────────────────────────── */
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+
+  /* ── Component Control Dimensions ─────────────────────────────────── */
+  --height-control-xs: var(--control-height-xs, 1.75rem);
+  --height-control-sm: var(--control-height-sm, 2rem);
+  --height-control-md: var(--control-height-md, 2.25rem);
+  --height-control-lg: var(--control-height-lg, 2.5rem);
+  --height-control-xl: var(--control-height-xl, 3rem);
+
+  /* ── Icon Sizing Tokens ───────────────────────────────────────────── */
+  --size-icon-xs: var(--icon-xs, 0.875rem);
+  --size-icon-sm: var(--icon-sm, 1rem);
+  --size-icon-md: var(--icon-md, 1.25rem);
+  --size-icon-lg: var(--icon-lg, 1.5rem);
+  --size-icon-xl: var(--icon-xl, 2rem);
+}
+
+/* ── Cybernetic Grid & Graph Topologies ──────────────────────────────────── */
+@utility execution-grid {
+  background-image:
+    linear-gradient(var(--border) 1px, transparent 1px),
+    linear-gradient(90deg, var(--border) 1px, transparent 1px);
+  background-size: 36px 36px;
+  mask-image: linear-gradient(to bottom, black, transparent 72%);
+}
+
+@utility topology-grid {
+  background-image: radial-gradient(
+    circle at center,
+    var(--border) 1px,
+    transparent 1px
+  );
+  background-size: 18px 18px;
+  mask-image: linear-gradient(
+    90deg,
+    transparent,
+    black 15%,
+    black 85%,
+    transparent
+  );
+}
+
+/* ── Glass Morphism Utility ────────────────────────────────────────────── */
+@utility glass {
+  background-color: var(--surface);
+  backdrop-filter: blur(16px) saturate(140%);
+  -webkit-backdrop-filter: blur(16px) saturate(140%);
+  border: 1px solid var(--border);
+}
+
+/* ── Mesh Background Gradient ─────────────────────────────────────────── */
+@utility mesh-bg {
+  background-image:
+    radial-gradient(
+      60rem 30rem at 12% -10%,
+      color-mix(in oklch, var(--primary) 16%, transparent),
+      transparent 70%
+    ),
+    radial-gradient(
+      50rem 26rem at 95% 0%,
+      color-mix(in oklch, var(--info) 14%, transparent),
+      transparent 70%
+    );
+}
+
+/* ── Text Gradient Utility ─────────────────────────────────────────────── */
+@utility text-gradient {
+  background-image: linear-gradient(
+    100deg,
+    var(--foreground) 10%,
+    color-mix(in oklch, var(--primary) 85%, var(--foreground)) 60%
+  );
+  background-clip: text;
+  color: transparent;
+}
+
+/* ── Live Agent Telemetry Animations ─────────────────────────────────────── */
+@utility animate-agent-pulse {
+  animation: agent-pulse 1.8s ease-in-out infinite;
+}
+
+@utility animate-signal-travel {
+  animation: signal-travel 1.5s linear infinite;
+}
+
+@utility animate-progress-flow {
+  animation: progress-flow 1.8s ease-in-out infinite;
+}
+
+@utility runner-enter {
+  animation: runner-enter 260ms ease-out both;
+}
+
+/* ── Pulse Ring Animation (status indicator) ───────────────────────────── */
+@utility pulse-dot {
+  animation: pulse-ring 1.8s ease-out infinite;
+}
+
+@keyframes pulse-ring {
+  0% {
+    box-shadow: 0 0 0 0 color-mix(in oklch, var(--primary) 45%, transparent);
+  }
+  100% {
+    box-shadow: 0 0 0 8px transparent;
+  }
+}
+
+@keyframes agent-pulse {
+  0%,
+  100% {
+    opacity: 0.55;
+    transform: scale(0.9);
+  }
+  50% {
+    opacity: 1;
+    transform: scale(1.15);
+  }
+}
+
+@keyframes signal-travel {
+  from {
+    left: 0;
+  }
+  to {
+    left: calc(100% - 0.5rem);
+  }
+}
+
+@keyframes progress-flow {
+  0%,
+  100% {
+    opacity: 0.55;
+  }
+  50% {
+    opacity: 1;
+  }
+}
+
+@keyframes runner-enter {
+  from {
+    opacity: 0;
+    transform: translateY(6px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+/* ── Sonner Toast Semantic Feedback Styles ────────────────────────────────── */
+[data-sonner-toaster] [data-sonner-toast] {
+  border-radius: var(--radius-md, 0.375rem);
+}
+
+[data-sonner-toaster] [data-sonner-toast][data-type="success"] {
+  border-color: color-mix(in oklch, var(--success) 35%, transparent);
+}
+
+[data-sonner-toaster] [data-sonner-toast][data-type="success"] [data-icon] {
+  color: var(--success);
+}
+
+[data-sonner-toaster] [data-sonner-toast][data-type="error"],
+[data-sonner-toaster] [data-sonner-toast][data-type="destructive"] {
+  border-color: color-mix(in oklch, var(--destructive) 35%, transparent);
+}
+
+[data-sonner-toaster] [data-sonner-toast][data-type="error"] [data-icon],
+[data-sonner-toaster] [data-sonner-toast][data-type="destructive"] [data-icon] {
+  color: var(--destructive);
+}
+
+[data-sonner-toaster] [data-sonner-toast][data-type="warning"] {
+  border-color: color-mix(in oklch, var(--warning) 35%, transparent);
+}
+
+[data-sonner-toaster] [data-sonner-toast][data-type="warning"] [data-icon] {
+  color: var(--warning);
+}
+
+[data-sonner-toaster] [data-sonner-toast][data-type="info"] {
+  border-color: color-mix(in oklch, var(--info) 35%, transparent);
+}
+
+[data-sonner-toaster] [data-sonner-toast][data-type="info"] [data-icon] {
+  color: var(--info);
+}

package/dist/root.css

@@ -0,0 +1,91 @@
+/**
+ * @file src/styles/root.css
+ * @description Baseline normalizations, CSS variables, and interactive element resets.
+ * Pure CSS — zero Tailwind dependency.
+ */
+
+@layer dl-base {
+  /* ── Interactive Cursors ───────────────────────────────────────────── */
+  button,
+  a,
+  select,
+  summary,
+  [role="button"],
+  [role="tab"],
+  [type="button"],
+  [type="submit"],
+  [type="reset"] {
+    cursor: pointer;
+  }
+
+  button:disabled,
+  a[aria-disabled="true"],
+  [aria-disabled="true"],
+  [type="button"]:disabled,
+  [type="submit"]:disabled {
+    cursor: not-allowed;
+  }
+
+  /* ── Interactive Focus Normalization ───────────────────────────────── */
+  :focus:not(:focus-visible) {
+    outline: none;
+  }
+
+  /* ── Text Selection ────────────────────────────────────────────────── */
+  ::selection {
+    background: color-mix(in oklab, var(--primary) 28%, transparent);
+  }
+
+  /* ── Scrollbars ────────────────────────────────────────────────────── */
+  * {
+    scrollbar-width: thin;
+    scrollbar-color: var(--border) transparent;
+  }
+  ::-webkit-scrollbar {
+    width: 6px;
+    height: 6px;
+  }
+  ::-webkit-scrollbar-track {
+    background: transparent;
+  }
+  ::-webkit-scrollbar-thumb {
+    background: var(--border);
+    border-radius: 9999px;
+  }
+
+  /* ── Form Typography Inheritance ───────────────────────────────────── */
+  button,
+  input,
+  select,
+  textarea {
+    letter-spacing: 0;
+    font-family: inherit;
+  }
+
+  /*
+   * Radix Select — Item relative positioning anchor.
+   * Ensures stacking context for the indicator (absolute right-2).
+   */
+  [role="option"] {
+    position: relative;
+  }
+
+  /*
+   * Breadcrumb Separator SVG Sizing
+   */
+  [data-slot="breadcrumb-separator"] svg {
+    width: 0.875rem;
+    height: 0.875rem;
+  }
+
+  /* ── Reduced Motion ────────────────────────────────────────────────── */
+  @media (prefers-reduced-motion: reduce) {
+    *,
+    *::before,
+    *::after {
+      animation-duration: 0.01ms !important;
+      animation-iteration-count: 1 !important;
+      scroll-behavior: auto !important;
+    }
+  }
+}

package/dist/styles.css

@@ -0,0 +1,12 @@
+/**
+ * @file src/styles/styles.css
+ * @description Master stylesheet for @yuva-devlab/tokens.
+ * Contains base CSS custom properties, theme definitions, and design tokens.
+ */
+
+/* ── Base Normalization & Design Tokens ──────────────────────────────────── */
+@import "./root.css";
+
+/* ── Brand Scoped Themes ─────────────────────────────────────────────────── */
+@import "./themes/finai.css";
+@import "./themes/orchestrai.css";