@newtonedev/components 0.1.5 → 0.1.7

package/src/theme/types.ts

@@ -15,11 +15,6 @@ export interface FontConfig {
   readonly fallback: string;     // CSS fallback stack
 }
 
-/**
- * Theme names for different UI contexts
- */
-export type ThemeName = 'neutral' | 'primary' | 'secondary' | 'strong';
-
 /**
  * Elevation levels for surfaces (internal)
  * 0 = sunken, 1 = default, 2 = elevated
@@ -33,16 +28,6 @@ export type ElevationLevel = 0 | 1 | 2;
  */
 export type FrameElevation = -2 | -1 | 0 | 1 | 2;
 
-/**
- * Theme mapping: which palette and normalizedValue to use for backgrounds/text
- * Based on playground theme preview logic
- */
-export interface ThemeMapping {
-  readonly paletteIndex: number;    // Index into ColorSystemConfig.palettes
-  readonly lightModeNv: number;     // normalizedValue for light mode background
-  readonly darkModeNv: number;      // normalizedValue for dark mode background
-}
-
 /**
  * Complete color system configuration
  */
@@ -51,20 +36,63 @@ export interface ColorSystemConfig {
   readonly palettes: ReadonlyArray<PaletteConfig>;
 }
 
+/**
+ * Overrides for hardcoded token computation constants.
+ * All values are optional — omitted fields fall back to engine defaults.
+ *
+ * All values are NV (normalized value / luminosity) offsets on a unified scale.
+ * 0.10 means the same 10% luminosity shift whether applied to borders, text,
+ * or interactive components. Direction auto-inverts per effective mode
+ * (darker in light mode, lighter in dark mode) unless noted otherwise.
+ */
+export interface TokenOverrides {
+  // --- Offset fields (all magnitudes, direction auto-inverts per effective mode) ---
+  // Light mode
+  readonly interactiveComponentOffset?: number;      // default: 0.04 (auto-inverts)
+  readonly hoverShift?: number;                      // default: 0.06 (auto-inverts)
+  readonly activeShift?: number;                     // default: 0.08 (auto-inverts)
+  readonly borderOffset?: number;                    // default: 0.08 (auto-inverts)
+  // Dark mode
+  readonly interactiveComponentOffsetDark?: number;  // default: 0.04 (auto-inverts)
+  readonly hoverShiftDark?: number;                  // default: 0.06 (auto-inverts)
+  readonly activeShiftDark?: number;                 // default: 0.08 (auto-inverts)
+  readonly borderOffsetDark?: number;                // default: 0.08 (auto-inverts)
+  readonly borderFocusedOffset?: number;             // default: 0.16 (auto-inverts)
+  readonly borderFocusedOffsetDark?: number;          // default: 0.16 (auto-inverts)
+  readonly borderFilledOffset?: number;              // default: 0.24 (auto-inverts)
+  readonly borderFilledOffsetDark?: number;           // default: 0.24 (auto-inverts)
+
+  // --- Normalized tokens (light mode: 0 = lightest, 1 = darkest) ---
+  // When present, computeTokens uses absolute positions instead of baseNv + offset.
+  // All themes share the same lightness positions; palette (hue/sat) varies per theme.
+  // Background: absolute positions — ground is Background/01 (elevated)
+  readonly backgroundElevated?: number;              // default: 0    (ground — lightest)
+  readonly backgroundDefault?: number;               // default: 0.03
+  readonly backgroundSunken?: number;                // default: 0.06
+  // Text: absolute positions at bg01 — elevation-compensated by computeTokens on deeper surfaces
+  readonly textPrimaryNormalized?: number;            // default: 0.9  (max contrast)
+  readonly textSecondaryNormalized?: number;          // default: 0.7
+  readonly textTertiaryNormalized?: number;           // default: 0.5
+  readonly textDisabledNormalized?: number;           // default: 0.3
+
+  // --- Normalized tokens (dark mode: 0 = darkest, 1 = lightest) ---
+  // Same semantics as light mode but scale direction is inverted.
+  // Background: ground is Background/01 (elevated = lightest dark surface)
+  readonly backgroundElevatedDark?: number;           // default: 0.24 (ground — lightest dark surface)
+  readonly backgroundDefaultDark?: number;            // default: 0.20
+  readonly backgroundSunkenDark?: number;             // default: 0.16
+  // Text: absolute positions at bg01 — elevation-compensated by computeTokens on deeper surfaces
+  readonly textPrimaryNormalizedDark?: number;         // default: 1.0  (max contrast — lightest)
+  readonly textSecondaryNormalizedDark?: number;       // default: 0.8
+  readonly textTertiaryNormalizedDark?: number;        // default: 0.6
+  readonly textDisabledNormalizedDark?: number;        // default: 0.4
+}
+
 /**
  * Newtone theme configuration
  */
 export interface NewtoneThemeConfig {
   readonly colorSystem: ColorSystemConfig;
-  readonly themes: {
-    readonly neutral: ThemeMapping;
-    readonly primary: ThemeMapping;
-    readonly secondary: ThemeMapping;
-    readonly strong: ThemeMapping;
-  };
-  readonly elevation: {
-    readonly offsets: readonly [number, number, number]; // NV offsets for [sunken, default, elevated]
-  };
   readonly spacing: {
     readonly '00': number;  // base * 0
     readonly '02': number;  // base * 0.25
@@ -120,6 +148,7 @@ export interface NewtoneThemeConfig {
     readonly weight: 100 | 200 | 300 | 400 | 500 | 600 | 700;
     readonly autoGrade: boolean;  // true = mode-aware grade (light=-25, dark=200)
   };
+  readonly tokenOverrides?: TokenOverrides;
 }
 
 /**
@@ -128,7 +157,5 @@ export interface NewtoneThemeConfig {
 export interface NewtoneThemeContext {
   readonly config: NewtoneThemeConfig;
   readonly mode: ColorMode;
-  readonly theme: ThemeName;
   readonly setMode: (mode: ColorMode) => void;
-  readonly setTheme: (theme: ThemeName) => void;
 }