refactor(themes): improve Sunset and Terracotta theme accuracy

Update Sunset theme colors to match name and Coana branding:
- Change from azure blue to warm orange/purple gradient
- Primary: #FF8C64 (warm orange)
- Secondary: #C864B4 (purple/pink)
- Add purple-to-orange shimmer effect
- Update link and step colors to use warm palette

Rename Brick theme to Terracotta:
- More descriptive name matching the actual terracotta color
- Update theme name from 'brick' to 'terracotta'
- Update BRICK_THEME constant to TERRACOTTA_THEME
- Update all references in docs, tests, and examples

Author: jdalton

CHANGELOG.md

@@ -54,7 +54,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Theme system with 5 built-in themes: `socket`, `sunset`, `brick`, `lush`, `ultra`
+- Theme system with 5 built-in themes: `socket`, `sunset`, `terracotta`, `lush`, `ultra`
 - `setTheme()`, `getTheme()`, `withTheme()`, `withThemeSync()` for theme management
 - `createTheme()`, `extendTheme()`, `resolveColor()` helper functions
 - `onThemeChange()` event listener for theme reactivity

docs/themes.md

@@ -6,20 +6,20 @@ Socket Lib provides a comprehensive theming system for consistent branding acros
 
 | Theme | Use Case | Primary Color | Special Effects |
 |-------|----------|---------------|-----------------|
-| **`socket`** (default) | Socket Security | Purple `#8C52FF` | Subtle shimmer |
-| **`coana`** | Coana analysis | Azure blue | Clean dots |
-| **`socket-firewall`** | Firewall security | Orange/Ember | Security warnings |
-| **`socket-cli-python`** | Python CLI | Steel blue + Gold | Python branding |
-| **`ultra`** | Celebrations 🎉 | 🌈 Rainbow | Maximum flair |
+| **`socket`** (default) | Socket Security | Violet `#8C52FF` | Subtle shimmer |
+| **`sunset`** | Vibrant twilight | Orange `#FF8C64` + Pink `#C864B4` | Purple-to-orange gradient |
+| **`terracotta`** | Solid warmth | Terracotta `#FF6432` | Rich shimmer |
+| **`lush`** | Steel elegance | Steel blue `#4682B4` + Gold `#FFD700` | Elegant harmony |
+| **`ultra`** | Premium intensity | 🌈 Prismatic | Rainbow shimmer |
 
 ### Quick Start
 
 ```typescript
 import { setTheme, Spinner } from '@socketsecurity/lib'
 
-setTheme('socket-firewall')  // Set once at startup
+setTheme('terracotta')  // Set once at startup
 const spinner = Spinner({ text: 'Scanning...' })
-spinner.start()              // Uses firewall theme automatically
+spinner.start()         // Uses terracotta theme automatically
 ```
 
 ---
@@ -71,15 +71,15 @@ Themes use a stack model for temporary changes:
 // ┌──────────┐
 // │  ultra   │ ← popTheme() removes this
 // ├──────────┤
-// │  coana   │ ← pushTheme() adds here
+// │  sunset  │ ← pushTheme() adds here
 // ├──────────┤
 // │  socket  │ ← Base theme
 // └──────────┘
 
-pushTheme('coana')        // Add to stack
+pushTheme('sunset')       // Add to stack
 pushTheme('ultra')        // Add another
-popTheme()                // Remove ultra → back to coana
-popTheme()                // Remove coana → back to socket
+popTheme()                // Remove ultra → back to sunset
+popTheme()                // Remove sunset → back to socket
 ```
 
 ### 🎯 Scoped Themes (Recommended)
@@ -89,22 +89,22 @@ Use `withTheme()` for automatic cleanup:
 ```typescript
 import { withTheme } from '@socketsecurity/lib/themes'
 
-// Before: coana theme
+// Before: sunset theme
 await withTheme('ultra', async () => {
   // Inside: ultra theme 🌈
   const spinner = Spinner({ text: 'MAXIMUM POWER!' })
   await epicOperation()
 })
-// After: coana theme (auto-restored)
+// After: sunset theme (auto-restored)
 ```
 
 **Visual Flow:**
 ```
-Normal Flow    → [coana] → [coana] → [coana]
+Normal Flow    → [sunset] → [sunset] → [sunset]
                     ↓
-withTheme()    → [coana] → [ultra] → [coana]
-                          ↑─────────↑
-                          Auto-restore
+withTheme()    → [sunset] → [ultra] → [sunset]
+                           ↑─────────↑
+                           Auto-restore
 ```
 
 ---
@@ -119,10 +119,10 @@ setTheme('socket')
 
 | Attribute | Value |
 |-----------|-------|
-| **Primary Color** | `#8C52FF` (Purple) |
+| **Primary Color** | `#8C52FF` (Refined violet) |
 | **Best For** | Socket.dev tools, security scanning |
 | **Spinner** | Socket style with subtle shimmer |
-| **Visual Style** | Professional, focused, elegant |
+| **Visual Style** | Signature theme designed for focus and elegance |
 
 **Preview:**
 ```
@@ -132,44 +132,48 @@ setTheme('socket')
 → Installing dependencies...    # Cyan
 ```
 
-### 🔵 Coana
+### 🌅 Sunset
 
 ```typescript
-setTheme('coana')
+setTheme('sunset')
 ```
 
 | Attribute | Value |
 |-----------|-------|
-| **Primary Color** | `#64C8FF` (Azure blue) |
-| **Best For** | Code analysis, static analysis tools |
+| **Primary Color** | `#FF8C64` (Warm orange) |
+| **Secondary Color** | `#C864B4` (Purple/pink) |
+| **Best For** | Coana branding, warm interfaces, twilight aesthetics |
 | **Spinner** | Dots style, clean animations |
-| **Visual Style** | Analytical, precise, professional |
+| **Effects** | Purple-to-orange gradient shimmer |
+| **Visual Style** | Vibrant twilight gradient with warm sunset tones |
 
-### 🟠 Socket Firewall
+### 🟠 Terracotta
 
 ```typescript
-setTheme('socket-firewall')
+setTheme('terracotta')
 ```
 
 | Attribute | Value |
 |-----------|-------|
-| **Primary Color** | `#FF6432` (Ember orange) |
-| **Best For** | Security tools, threat detection |
-| **Spinner** | Socket style with emphasis |
-| **Visual Style** | Vigilant, protective, alert |
+| **Primary Color** | `#FF6432` (Terracotta) |
+| **Secondary Color** | `#FF9664` (Light terracotta) |
+| **Best For** | Grounded confidence, warm interfaces |
+| **Spinner** | Socket style with rich shimmer |
+| **Visual Style** | Solid theme with rich terracotta and ember warmth |
 
-### 🔷 Socket CLI Python
+### 🔷 Lush
 
 ```typescript
-setTheme('socket-cli-python')
+setTheme('lush')
 ```
 
 | Attribute | Value |
 |-----------|-------|
 | **Primary Color** | `#4682B4` (Steel blue) |
 | **Secondary Color** | `#FFD700` (Gold) |
-| **Best For** | Python package management |
-| **Visual Style** | Python-inspired elegance |
+| **Best For** | Elegant interfaces, harmonious design |
+| **Spinner** | Dots style, clean animations |
+| **Visual Style** | Elegant theme with steel blue and golden harmony |
 
 ### 🌈 Ultra
 
@@ -179,16 +183,17 @@ setTheme('ultra')
 
 | Attribute | Value |
 |-----------|-------|
-| **Primary Color** | Rainbow gradient |
-| **Best For** | Celebrations, special moments 🎉 |
-| **Effects** | Maximum shimmer, rainbow everything |
-| **Visual Style** | Exciting, joyful, maximum flair |
+| **Primary Color** | `#8C52FF` with rainbow shimmer |
+| **Best For** | Deep analysis, premium experiences |
+| **Effects** | Prismatic shimmer, bidirectional rainbow |
+| **Spinner** | Socket style with rainbow effects |
+| **Visual Style** | Premium intensity where complexity meets elegance |
 
 **When to use Ultra:**
-- Successful completion of long operations
-- Milestone celebrations
-- Demo/presentation mode
-- April Fools' Day 😄
+- Complex analysis operations
+- Premium feature demonstrations
+- Deep diagnostic sessions
+- Maximum visual impact needed
 
 ---
 
@@ -203,7 +208,7 @@ Set global theme (use at app startup)
 import { setTheme } from '@socketsecurity/lib/themes'
 
 // By name
-setTheme('socket-firewall')
+setTheme('terracotta')
 
 // By custom object
 setTheme(myCustomTheme)
@@ -241,7 +246,7 @@ Auto-managed theme scope (async)
 ```typescript
 import { withTheme } from '@socketsecurity/lib/themes'
 
-await withTheme('coana', async () => {
+await withTheme('sunset', async () => {
   await doAnalysis()
 })
 // Theme auto-restored
@@ -253,7 +258,7 @@ Auto-managed theme scope (sync)
 ```typescript
 import { withThemeSync } from '@socketsecurity/lib/themes'
 
-const result = withThemeSync('socket-firewall', () => {
+const result = withThemeSync('terracotta', () => {
   return processSecurity()
 })
 ```
@@ -346,18 +351,18 @@ Logger symbols use theme colors:
 ```typescript
 import { logger, setTheme } from '@socketsecurity/lib'
 
-setTheme('socket-firewall')
+setTheme('terracotta')
 
-logger.success('Firewall enabled')   // ✓ in green
-logger.error('Threat detected')      // ✗ in red
+logger.success('Build complete')     // ✓ in green
+logger.error('Build failed')         // ✗ in red
 logger.warn('Update available')      // ⚠ in yellow
 logger.info('System status: OK')     // ℹ in blue
 ```
 
 **Output Preview:**
 ```
-✓ Firewall enabled         # Theme success color
-✗ Threat detected          # Theme error color
+✓ Build complete           # Theme success color
+✗ Build failed             # Theme error color
 ⚠ Update available         # Theme warning color
 ℹ System status: OK        # Theme info color
 ```
@@ -374,7 +379,7 @@ console.log(link('Documentation', 'https://socket.dev'))
 
 // Override theme
 console.log(link('API', 'https://api.socket.dev', {
-  theme: 'coana'
+  theme: 'sunset'
 }))
 
 // Show URL fallback
@@ -445,10 +450,10 @@ colors: {
 import { setTheme, Spinner } from '@socketsecurity/lib'
 
 // Set theme once at startup
-setTheme('socket-firewall')
+setTheme('terracotta')
 
 // All components inherit theme
-const spinner = Spinner({ text: 'Scanning for threats...' })
+const spinner = Spinner({ text: 'Building project...' })
 spinner.start()
 ```
 
@@ -601,8 +606,8 @@ colors: {
 }
 
 // Changes automatically when theme changes!
-setTheme('coana')      // Links become blue
-setTheme('firewall')   // Links become orange
+setTheme('sunset')       // Links become warm orange
+setTheme('terracotta')   // Links become warm peachy coral (secondary)
 ```
 
 ### Q: Theme not restoring after crash?

src/themes/index.ts

@@ -7,7 +7,7 @@
  * import { setTheme, THEMES } from '@socketsecurity/lib/themes'
  *
  * // Set global theme
- * setTheme('brick')
+ * setTheme('terracotta')
  * ```
  *
  * @example
@@ -55,10 +55,10 @@ export type {
 
 // Curated themes
 export {
-  BRICK_THEME,
   LUSH_THEME,
   SOCKET_THEME,
   SUNSET_THEME,
+  TERRACOTTA_THEME,
   THEMES,
   ULTRA_THEME,
   type ThemeName,

src/themes/themes.ts

@@ -47,44 +47,50 @@ export const SOCKET_THEME: Theme = {
 }
 
 /**
- * Sunset — Crisp azure.
- * Clean analytical theme with precise blue tones.
+ * Sunset — Vibrant twilight gradient.
+ * Warm sunset palette with orange and purple/pink tones.
  */
 export const SUNSET_THEME: Theme = {
   name: 'sunset',
   displayName: 'Sunset',
   colors: {
-    primary: [100, 200, 255],
-    secondary: [50, 150, 200],
+    primary: [255, 140, 100],
+    secondary: [200, 100, 180],
     success: 'greenBright',
     error: 'redBright',
     warning: 'yellowBright',
-    info: 'blueBright',
-    step: 'cyanBright',
+    info: 'magentaBright',
+    step: 'primary',
     text: 'white',
     textDim: 'gray',
-    link: 'cyanBright',
+    link: 'primary',
     prompt: 'primary',
   },
   effects: {
     spinner: {
       color: 'primary',
       style: 'dots',
     },
+    shimmer: {
+      enabled: true,
+      color: ['secondary', 'primary'],
+      direction: 'ltr',
+      speed: 0.4,
+    },
   },
   meta: {
-    description: 'Crisp azure theme for precision and clarity',
-    version: '1.0.0',
+    description: 'Warm sunset theme with purple-to-orange gradient',
+    version: '2.0.0',
   },
 }
 
 /**
- * Brick — Solid warmth.
+ * Terracotta — Solid warmth.
  * Rich terracotta and ember tones for grounded confidence.
  */
-export const BRICK_THEME: Theme = {
-  name: 'brick',
-  displayName: 'Brick',
+export const TERRACOTTA_THEME: Theme = {
+  name: 'terracotta',
+  displayName: 'Terracotta',
   colors: {
     primary: [255, 100, 50],
     secondary: [255, 150, 100],
@@ -192,7 +198,7 @@ export const THEMES = {
   __proto__: null,
   socket: SOCKET_THEME,
   sunset: SUNSET_THEME,
-  brick: BRICK_THEME,
+  terracotta: TERRACOTTA_THEME,
   lush: LUSH_THEME,
   ultra: ULTRA_THEME,
 } as const

test/isolated/themes.test.ts

@@ -29,7 +29,7 @@ describe('themes', () => {
     it('should have all default themes', () => {
       expect(THEMES).toHaveProperty('socket')
       expect(THEMES).toHaveProperty('sunset')
-      expect(THEMES).toHaveProperty('brick')
+      expect(THEMES).toHaveProperty('terracotta')
       expect(THEMES).toHaveProperty('lush')
       expect(THEMES).toHaveProperty('ultra')
     })
@@ -53,8 +53,8 @@ describe('themes', () => {
     })
 
     it('should set theme by object', () => {
-      setTheme(THEMES['brick'])
-      expect(getTheme().name).toBe('brick')
+      setTheme(THEMES['terracotta'])
+      expect(getTheme().name).toBe('terracotta')
     })
 
     it('should default to socket theme', () => {
@@ -129,7 +129,7 @@ describe('themes', () => {
 
     it('should resolve secondary color reference', () => {
       const resolved = resolveColor('secondary', THEMES.sunset.colors)
-      expect(resolved).toEqual([50, 150, 200])
+      expect(resolved).toEqual([200, 100, 180])
     })
 
     it('should resolve secondary to primary if not defined', () => {