@plainviz/core 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { parse } from './parse';
-export type { PlainVizIR, ParseResult, ParseError, ChartType, } from './ir';
+export { parse } from './parse.js';
+export type { PlainVizIR, ParseResult, ParseError, ChartType, DataSeries, } from './ir.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAS,GACV,MAAM,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1 +1 @@
-export { parse } from './parse';
+export { parse } from './parse.js';

package/dist/ir.d.ts

@@ -3,22 +3,31 @@
  * This is the canonical output of the parser.
  * All renderers consume this format.
  */
-export type ChartType = 'bar' | 'line' | 'pie' | 'area';
+export type ChartType = 'bar' | 'line' | 'pie' | 'area' | 'donut';
+export interface DataSeries {
+    name: string;
+    values: number[];
+    color?: string;
+}
 export interface PlainVizIR {
     type: ChartType;
     title?: string;
     subtitle?: string;
     labels: string[];
     values: number[];
+    series?: DataSeries[];
     meta?: {
         xAxis?: string;
         yAxis?: string;
         theme?: string;
+        colors?: string[];
     };
 }
 export interface ParseError {
     line: number;
     message: string;
+    hint?: string;
+    source?: string;
 }
 export type ParseResult = {
     ok: true;

package/dist/ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC"}
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC"}

package/dist/parse.d.ts

@@ -2,6 +2,6 @@
  * PlainViz Parser
  * Parses PlainViz syntax into IR (Intermediate Representation)
  */
-import type { ParseResult } from './ir';
+import type { ParseResult } from './ir.js';
 export declare function parse(input: string): ParseResult;
 //# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAc,WAAW,EAAyB,MAAM,MAAM,CAAC;AAiB3E,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAuHhD"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAc,WAAW,EAAyB,MAAM,SAAS,CAAC;AAiD9E,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CA8NhD"}

package/dist/parse.js

@@ -4,8 +4,34 @@
  */
 const HEADER_KEYS = new Set([
     'type', 'title', 'subtitle', 'theme',
-    'x-axis', 'y-axis', 'x', 'y'
+    'x-axis', 'y-axis', 'x', 'y',
+    'legend', 'colors'
 ]);
+// Simple split by comma (both English and Chinese) - for headers like Legend, Colors
+function splitList(value) {
+    return value.split(/[,，]/).map(s => s.trim()).filter(s => s);
+}
+// Smart split for data values
+// Preserves number formatting like $1,200 or 1,000,000
+function splitValues(value) {
+    // Chinese comma always splits
+    // English comma only splits if followed by whitespace or at end
+    const parts = value.split(/，|,(?=\s|$)/).map(s => s.trim()).filter(s => s);
+    // If we got only one part, return as-is
+    if (parts.length <= 1) {
+        return parts;
+    }
+    // Verify all parts look like numbers (with optional formatting)
+    // If any part is clearly not a number, don't split
+    const allNumbers = parts.every(p => {
+        const cleaned = p.replace(/[$%,\s]/g, '');
+        return !isNaN(parseFloat(cleaned));
+    });
+    if (!allNumbers) {
+        return [value]; // Return original if not all parts are numbers
+    }
+    return parts;
+}
 function isHeaderKey(key) {
     return HEADER_KEYS.has(key.toLowerCase());
 }
@@ -23,9 +49,13 @@ export function parse(input) {
     let xAxis;
     let yAxis;
     let theme;
+    let legend = [];
+    let colors = [];
     const labels = [];
     const values = [];
+    const multiValues = []; // 多系列数据
     let inDataSection = false;
+    let isMultiSeries = false;
     for (let i = 0; i < lines.length; i++) {
         const lineNum = i + 1;
         const line = lines[i];
@@ -37,13 +67,43 @@ export function parse(input) {
         // Find colon separator
         const colonIndex = trimmed.indexOf(':');
         if (colonIndex === -1) {
-            errors.push({ line: lineNum, message: `Missing ':' separator` });
+            // Check for common mistakes
+            if (trimmed.includes('=')) {
+                errors.push({
+                    line: lineNum,
+                    message: `Use ':' instead of '='`,
+                    hint: `Try: ${trimmed.replace('=', ':')}`,
+                    source: trimmed,
+                });
+            }
+            else {
+                errors.push({
+                    line: lineNum,
+                    message: `Missing ':' separator`,
+                    hint: `Each line should be "Label: Value", e.g., "Sales: 100"`,
+                    source: trimmed,
+                });
+            }
             continue;
         }
         const key = trimmed.slice(0, colonIndex).trim();
         const value = trimmed.slice(colonIndex + 1).trim();
         if (!key) {
-            errors.push({ line: lineNum, message: `Empty key before ':'` });
+            errors.push({
+                line: lineNum,
+                message: `Empty label before ':'`,
+                hint: `Add a label name, e.g., "Product A: 50"`,
+                source: trimmed,
+            });
+            continue;
+        }
+        if (!value) {
+            errors.push({
+                line: lineNum,
+                message: `Missing value after ':'`,
+                hint: `Add a number value, e.g., "${key}: 100"`,
+                source: trimmed,
+            });
             continue;
         }
         // Parse header fields
@@ -51,15 +111,19 @@ export function parse(input) {
             const keyLower = key.toLowerCase();
             switch (keyLower) {
                 case 'type':
-                    const validTypes = ['bar', 'line', 'pie', 'area'];
+                    const validTypes = ['bar', 'line', 'pie', 'area', 'donut'];
                     const typeLower = value.toLowerCase();
                     if (validTypes.includes(typeLower)) {
                         type = typeLower;
                     }
                     else {
+                        // Find closest match for suggestion
+                        const suggestion = validTypes.find(t => t.startsWith(typeLower.charAt(0)) || typeLower.includes(t.charAt(0))) || 'bar';
                         errors.push({
                             line: lineNum,
-                            message: `Invalid chart type '${value}'. Valid types: ${validTypes.join(', ')}`
+                            message: `Unknown chart type "${value}"`,
+                            hint: `Valid types: bar, line, pie, area. Did you mean "${suggestion}"?`,
+                            source: trimmed,
                         });
                     }
                     break;
@@ -80,26 +144,67 @@ export function parse(input) {
                 case 'theme':
                     theme = value;
                     break;
+                case 'legend':
+                    legend = splitList(value);
+                    break;
+                case 'colors':
+                    colors = splitList(value);
+                    break;
             }
         }
         else {
             // Data section
             inDataSection = true;
-            const numValue = cleanNumber(value);
-            if (isNaN(numValue)) {
-                errors.push({
-                    line: lineNum,
-                    message: `Invalid number '${value}' for label '${key}'`
-                });
-                continue;
+            // Check for multi-series (comma-separated values)
+            const rawValues = splitValues(value);
+            if (rawValues.length > 1) {
+                // Multi-series data
+                isMultiSeries = true;
+                const nums = [];
+                let hasError = false;
+                for (const rv of rawValues) {
+                    const num = cleanNumber(rv);
+                    if (isNaN(num)) {
+                        errors.push({
+                            line: lineNum,
+                            message: `"${rv}" is not a valid number`,
+                            hint: `Use numbers like: ${key}: 100, 80, 60`,
+                            source: trimmed,
+                        });
+                        hasError = true;
+                        break;
+                    }
+                    nums.push(num);
+                }
+                if (!hasError) {
+                    labels.push(key);
+                    multiValues.push(nums);
+                }
+            }
+            else {
+                // Single value
+                const numValue = cleanNumber(value);
+                if (isNaN(numValue)) {
+                    errors.push({
+                        line: lineNum,
+                        message: `"${value}" is not a valid number`,
+                        hint: `Use a number like: ${key}: 100 (supports $, %, commas)`,
+                        source: trimmed,
+                    });
+                    continue;
+                }
+                labels.push(key);
+                values.push(numValue);
             }
-            labels.push(key);
-            values.push(numValue);
         }
     }
     // Validation
     if (labels.length === 0 && errors.length === 0) {
-        errors.push({ line: 0, message: 'No data points found' });
+        errors.push({
+            line: 0,
+            message: 'No data points found',
+            hint: `Add data like:\nApples: 50\nOranges: 30\nBananas: 45`,
+        });
     }
     if (errors.length > 0) {
         return { ok: false, errors };
@@ -107,13 +212,29 @@ export function parse(input) {
     const ir = {
         type,
         labels,
-        values,
+        values: isMultiSeries ? [] : values,
     };
+    // Build series for multi-series data
+    if (isMultiSeries && multiValues.length > 0) {
+        const seriesCount = multiValues[0].length;
+        ir.series = [];
+        for (let s = 0; s < seriesCount; s++) {
+            const seriesName = legend[s] || `Series ${s + 1}`;
+            const seriesValues = multiValues.map(row => row[s] ?? 0);
+            ir.series.push({
+                name: seriesName,
+                values: seriesValues,
+                color: colors[s],
+            });
+        }
+        // Also populate values with first series for backward compatibility
+        ir.values = ir.series[0]?.values || [];
+    }
     if (title)
         ir.title = title;
     if (subtitle)
         ir.subtitle = subtitle;
-    if (xAxis || yAxis || theme) {
+    if (xAxis || yAxis || theme || colors.length > 0) {
         ir.meta = {};
         if (xAxis)
             ir.meta.xAxis = xAxis;
@@ -121,6 +242,8 @@ export function parse(input) {
             ir.meta.yAxis = yAxis;
         if (theme)
             ir.meta.theme = theme;
+        if (colors.length > 0)
+            ir.meta.colors = colors;
     }
     return { ok: true, ir };
 }

package/dist/parse.test.js

@@ -105,7 +105,8 @@ A: abc
 `);
             expect(result.ok).toBe(false);
             if (!result.ok) {
-                expect(result.errors[0].message).toContain("Invalid number");
+                expect(result.errors[0].message).toContain("not a valid number");
+                expect(result.errors[0].hint).toBeDefined();
             }
         });
         it('reports error for invalid chart type', () => {
@@ -115,7 +116,8 @@ A: 10
 `);
             expect(result.ok).toBe(false);
             if (!result.ok) {
-                expect(result.errors[0].message).toContain("Invalid chart type");
+                expect(result.errors[0].message).toContain("Unknown chart type");
+                expect(result.errors[0].hint).toContain("Valid types");
             }
         });
         it('reports error when no data points', () => {
@@ -151,4 +153,57 @@ A: 10
             }
         });
     });
+    describe('multi-series parsing', () => {
+        it('parses comma-separated values as multi-series', () => {
+            const result = parse(`
+Type: Bar
+Legend: 阿里, 腾讯
+营收: 100, 80
+利润: 30, 25
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.labels).toEqual(['营收', '利润']);
+                expect(result.ir.series).toBeDefined();
+                expect(result.ir.series?.length).toBe(2);
+                expect(result.ir.series?.[0].name).toBe('阿里');
+                expect(result.ir.series?.[0].values).toEqual([100, 30]);
+                expect(result.ir.series?.[1].name).toBe('腾讯');
+                expect(result.ir.series?.[1].values).toEqual([80, 25]);
+            }
+        });
+        it('uses default series names when Legend not provided', () => {
+            const result = parse(`
+Type: Bar
+A: 10, 20
+B: 30, 40
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.series?.[0].name).toBe('Series 1');
+                expect(result.ir.series?.[1].name).toBe('Series 2');
+            }
+        });
+        it('supports Chinese commas', () => {
+            const result = parse(`
+Type: Bar
+A: 100，200
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.series?.length).toBe(2);
+            }
+        });
+        it('preserves number formatting with commas', () => {
+            const result = parse(`
+Type: Bar
+Sales: $1,200
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.values).toEqual([1200]);
+                expect(result.ir.series).toBeUndefined();
+            }
+        });
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plainviz/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "PlainViz core parser and IR",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -1,7 +1,8 @@
-export { parse } from './parse';
+export { parse } from './parse.js';
 export type {
   PlainVizIR,
   ParseResult,
   ParseError,
   ChartType,
-} from './ir';
+  DataSeries,
+} from './ir.js';

package/src/ir.ts

@@ -4,24 +4,34 @@
  * All renderers consume this format.
  */
 
-export type ChartType = 'bar' | 'line' | 'pie' | 'area';
+export type ChartType = 'bar' | 'line' | 'pie' | 'area' | 'donut';
+
+export interface DataSeries {
+  name: string;
+  values: number[];
+  color?: string;
+}
 
 export interface PlainVizIR {
   type: ChartType;
   title?: string;
   subtitle?: string;
   labels: string[];
-  values: number[];
+  values: number[];           // 单系列数据（向后兼容）
+  series?: DataSeries[];      // 多系列数据
   meta?: {
     xAxis?: string;
     yAxis?: string;
     theme?: string;
+    colors?: string[];        // 自定义颜色
   };
 }
 
 export interface ParseError {
   line: number;
   message: string;
+  hint?: string;
+  source?: string;
 }
 
 export type ParseResult =

package/src/parse.test.ts

@@ -114,7 +114,8 @@ A: abc
 `);
       expect(result.ok).toBe(false);
       if (!result.ok) {
-        expect(result.errors[0].message).toContain("Invalid number");
+        expect(result.errors[0].message).toContain("not a valid number");
+        expect(result.errors[0].hint).toBeDefined();
       }
     });
 
@@ -125,7 +126,8 @@ A: 10
 `);
       expect(result.ok).toBe(false);
       if (!result.ok) {
-        expect(result.errors[0].message).toContain("Invalid chart type");
+        expect(result.errors[0].message).toContain("Unknown chart type");
+        expect(result.errors[0].hint).toContain("Valid types");
       }
     });
 
@@ -164,4 +166,61 @@ A: 10
       }
     });
   });
+
+  describe('multi-series parsing', () => {
+    it('parses comma-separated values as multi-series', () => {
+      const result = parse(`
+Type: Bar
+Legend: 阿里, 腾讯
+营收: 100, 80
+利润: 30, 25
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.labels).toEqual(['营收', '利润']);
+        expect(result.ir.series).toBeDefined();
+        expect(result.ir.series?.length).toBe(2);
+        expect(result.ir.series?.[0].name).toBe('阿里');
+        expect(result.ir.series?.[0].values).toEqual([100, 30]);
+        expect(result.ir.series?.[1].name).toBe('腾讯');
+        expect(result.ir.series?.[1].values).toEqual([80, 25]);
+      }
+    });
+
+    it('uses default series names when Legend not provided', () => {
+      const result = parse(`
+Type: Bar
+A: 10, 20
+B: 30, 40
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.series?.[0].name).toBe('Series 1');
+        expect(result.ir.series?.[1].name).toBe('Series 2');
+      }
+    });
+
+    it('supports Chinese commas', () => {
+      const result = parse(`
+Type: Bar
+A: 100，200
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.series?.length).toBe(2);
+      }
+    });
+
+    it('preserves number formatting with commas', () => {
+      const result = parse(`
+Type: Bar
+Sales: $1,200
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.values).toEqual([1200]);
+        expect(result.ir.series).toBeUndefined();
+      }
+    });
+  });
 });

package/src/parse.ts

@@ -3,13 +3,45 @@
  * Parses PlainViz syntax into IR (Intermediate Representation)
  */
 
-import type { PlainVizIR, ParseResult, ParseError, ChartType } from './ir';
+import type { PlainVizIR, ParseResult, ParseError, ChartType } from './ir.js';
 
 const HEADER_KEYS = new Set([
   'type', 'title', 'subtitle', 'theme',
-  'x-axis', 'y-axis', 'x', 'y'
+  'x-axis', 'y-axis', 'x', 'y',
+  'legend', 'colors'
 ]);
 
+// Simple split by comma (both English and Chinese) - for headers like Legend, Colors
+function splitList(value: string): string[] {
+  return value.split(/[,，]/).map(s => s.trim()).filter(s => s);
+}
+
+// Smart split for data values
+// Preserves number formatting like $1,200 or 1,000,000
+function splitValues(value: string): string[] {
+  // Chinese comma always splits
+  // English comma only splits if followed by whitespace or at end
+  const parts = value.split(/，|,(?=\s|$)/).map(s => s.trim()).filter(s => s);
+
+  // If we got only one part, return as-is
+  if (parts.length <= 1) {
+    return parts;
+  }
+
+  // Verify all parts look like numbers (with optional formatting)
+  // If any part is clearly not a number, don't split
+  const allNumbers = parts.every(p => {
+    const cleaned = p.replace(/[$%,\s]/g, '');
+    return !isNaN(parseFloat(cleaned));
+  });
+
+  if (!allNumbers) {
+    return [value]; // Return original if not all parts are numbers
+  }
+
+  return parts;
+}
+
 function isHeaderKey(key: string): boolean {
   return HEADER_KEYS.has(key.toLowerCase());
 }
@@ -30,11 +62,15 @@ export function parse(input: string): ParseResult {
   let xAxis: string | undefined;
   let yAxis: string | undefined;
   let theme: string | undefined;
+  let legend: string[] = [];
+  let colors: string[] = [];
 
   const labels: string[] = [];
   const values: number[] = [];
+  const multiValues: number[][] = [];  // 多系列数据
 
   let inDataSection = false;
+  let isMultiSeries = false;
 
   for (let i = 0; i < lines.length; i++) {
     const lineNum = i + 1;
@@ -49,7 +85,22 @@ export function parse(input: string): ParseResult {
     // Find colon separator
     const colonIndex = trimmed.indexOf(':');
     if (colonIndex === -1) {
-      errors.push({ line: lineNum, message: `Missing ':' separator` });
+      // Check for common mistakes
+      if (trimmed.includes('=')) {
+        errors.push({
+          line: lineNum,
+          message: `Use ':' instead of '='`,
+          hint: `Try: ${trimmed.replace('=', ':')}`,
+          source: trimmed,
+        });
+      } else {
+        errors.push({
+          line: lineNum,
+          message: `Missing ':' separator`,
+          hint: `Each line should be "Label: Value", e.g., "Sales: 100"`,
+          source: trimmed,
+        });
+      }
       continue;
     }
 
@@ -57,7 +108,22 @@ export function parse(input: string): ParseResult {
     const value = trimmed.slice(colonIndex + 1).trim();
 
     if (!key) {
-      errors.push({ line: lineNum, message: `Empty key before ':'` });
+      errors.push({
+        line: lineNum,
+        message: `Empty label before ':'`,
+        hint: `Add a label name, e.g., "Product A: 50"`,
+        source: trimmed,
+      });
+      continue;
+    }
+
+    if (!value) {
+      errors.push({
+        line: lineNum,
+        message: `Missing value after ':'`,
+        hint: `Add a number value, e.g., "${key}: 100"`,
+        source: trimmed,
+      });
       continue;
     }
 
@@ -67,14 +133,20 @@ export function parse(input: string): ParseResult {
 
       switch (keyLower) {
         case 'type':
-          const validTypes = ['bar', 'line', 'pie', 'area'];
+          const validTypes = ['bar', 'line', 'pie', 'area', 'donut'];
           const typeLower = value.toLowerCase();
           if (validTypes.includes(typeLower)) {
             type = typeLower as ChartType;
           } else {
+            // Find closest match for suggestion
+            const suggestion = validTypes.find(t =>
+              t.startsWith(typeLower.charAt(0)) || typeLower.includes(t.charAt(0))
+            ) || 'bar';
             errors.push({
               line: lineNum,
-              message: `Invalid chart type '${value}'. Valid types: ${validTypes.join(', ')}`
+              message: `Unknown chart type "${value}"`,
+              hint: `Valid types: bar, line, pie, area. Did you mean "${suggestion}"?`,
+              source: trimmed,
             });
           }
           break;
@@ -95,28 +167,71 @@ export function parse(input: string): ParseResult {
         case 'theme':
           theme = value;
           break;
+        case 'legend':
+          legend = splitList(value);
+          break;
+        case 'colors':
+          colors = splitList(value);
+          break;
       }
     } else {
       // Data section
       inDataSection = true;
 
-      const numValue = cleanNumber(value);
-      if (isNaN(numValue)) {
-        errors.push({
-          line: lineNum,
-          message: `Invalid number '${value}' for label '${key}'`
-        });
-        continue;
-      }
+      // Check for multi-series (comma-separated values)
+      const rawValues = splitValues(value);
+
+      if (rawValues.length > 1) {
+        // Multi-series data
+        isMultiSeries = true;
+        const nums: number[] = [];
+        let hasError = false;
 
-      labels.push(key);
-      values.push(numValue);
+        for (const rv of rawValues) {
+          const num = cleanNumber(rv);
+          if (isNaN(num)) {
+            errors.push({
+              line: lineNum,
+              message: `"${rv}" is not a valid number`,
+              hint: `Use numbers like: ${key}: 100, 80, 60`,
+              source: trimmed,
+            });
+            hasError = true;
+            break;
+          }
+          nums.push(num);
+        }
+
+        if (!hasError) {
+          labels.push(key);
+          multiValues.push(nums);
+        }
+      } else {
+        // Single value
+        const numValue = cleanNumber(value);
+        if (isNaN(numValue)) {
+          errors.push({
+            line: lineNum,
+            message: `"${value}" is not a valid number`,
+            hint: `Use a number like: ${key}: 100 (supports $, %, commas)`,
+            source: trimmed,
+          });
+          continue;
+        }
+
+        labels.push(key);
+        values.push(numValue);
+      }
     }
   }
 
   // Validation
   if (labels.length === 0 && errors.length === 0) {
-    errors.push({ line: 0, message: 'No data points found' });
+    errors.push({
+      line: 0,
+      message: 'No data points found',
+      hint: `Add data like:\nApples: 50\nOranges: 30\nBananas: 45`,
+    });
   }
 
   if (errors.length > 0) {
@@ -126,16 +241,36 @@ export function parse(input: string): ParseResult {
   const ir: PlainVizIR = {
     type,
     labels,
-    values,
+    values: isMultiSeries ? [] : values,
   };
 
+  // Build series for multi-series data
+  if (isMultiSeries && multiValues.length > 0) {
+    const seriesCount = multiValues[0].length;
+    ir.series = [];
+
+    for (let s = 0; s < seriesCount; s++) {
+      const seriesName = legend[s] || `Series ${s + 1}`;
+      const seriesValues = multiValues.map(row => row[s] ?? 0);
+      ir.series.push({
+        name: seriesName,
+        values: seriesValues,
+        color: colors[s],
+      });
+    }
+
+    // Also populate values with first series for backward compatibility
+    ir.values = ir.series[0]?.values || [];
+  }
+
   if (title) ir.title = title;
   if (subtitle) ir.subtitle = subtitle;
-  if (xAxis || yAxis || theme) {
+  if (xAxis || yAxis || theme || colors.length > 0) {
     ir.meta = {};
     if (xAxis) ir.meta.xAxis = xAxis;
     if (yAxis) ir.meta.yAxis = yAxis;
     if (theme) ir.meta.theme = theme;
+    if (colors.length > 0) ir.meta.colors = colors;
   }
 
   return { ok: true, ir };