feat(spec): type ChartConfig colors as palette or value→color map (#2262)

ChartConfigSchema.colors now accepts a positional palette (string[]) OR an
explicit value→color map (Record<value,color>, kanban-style). A value→color
map — and a select/lookup dimension's option colors — take precedence over
the positional palette per category.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: os-zhuang

.changeset/chart-config-colors-map.md

@@ -0,0 +1,11 @@
+---
+"@objectstack/spec": patch
+---
+
+feat(spec): type ChartConfig `colors` as a palette OR a value→color map
+
+`ChartConfigSchema.colors` now accepts either a positional palette (`string[]`)
+or an explicit value→color map (`Record<value, color>`, kanban-style). A
+value→color map — and a select/lookup dimension's option colors — take
+precedence over the positional palette per category, so semantic charts
+(health, status) paint their own colors instead of the generic palette.

packages/spec/src/ui/chart.zod.ts

@@ -185,8 +185,15 @@ export const ChartConfigSchema = lazySchema(() => z.object({
   /** Series Configuration */
   series: z.array(ChartSeriesSchema).optional().describe('Defined series configuration'),
 
-  /** Appearance */
-  colors: z.array(z.string()).optional().describe('Color palette'),
+  /** Appearance. Either a positional palette (string[]) applied per category in
+   *  order, or a value→color map ({ value: color }, kanban-style). A value→color
+   *  map — and a select/lookup dimension's option colors — take precedence over
+   *  the positional palette per category, so semantic charts (health, status)
+   *  paint their own colors instead of the generic palette. */
+  colors: z.union([
+    z.array(z.string()),
+    z.record(z.string(), z.string()),
+  ]).optional().describe('Color palette (string[]) or value→color map ({ value: color })'),
   height: z.number().optional().describe('Fixed height in pixels'),
 
   /** Components */