@plainviz/core 0.1.0

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

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

package/dist/ir.d.ts

@@ -0,0 +1,30 @@
+/**
+ * PlainViz Intermediate Representation (IR)
+ * This is the canonical output of the parser.
+ * All renderers consume this format.
+ */
+export type ChartType = 'bar' | 'line' | 'pie' | 'area';
+export interface PlainVizIR {
+    type: ChartType;
+    title?: string;
+    subtitle?: string;
+    labels: string[];
+    values: number[];
+    meta?: {
+        xAxis?: string;
+        yAxis?: string;
+        theme?: string;
+    };
+}
+export interface ParseError {
+    line: number;
+    message: string;
+}
+export type ParseResult = {
+    ok: true;
+    ir: PlainVizIR;
+} | {
+    ok: false;
+    errors: ParseError[];
+};
+//# sourceMappingURL=ir.d.ts.map

package/dist/ir.d.ts.map

@@ -0,0 +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"}

package/dist/ir.js

@@ -0,0 +1,6 @@
+/**
+ * PlainViz Intermediate Representation (IR)
+ * This is the canonical output of the parser.
+ * All renderers consume this format.
+ */
+export {};

package/dist/parse.d.ts

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

package/dist/parse.d.ts.map

@@ -0,0 +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"}

package/dist/parse.js

@@ -0,0 +1,126 @@
+/**
+ * PlainViz Parser
+ * Parses PlainViz syntax into IR (Intermediate Representation)
+ */
+const HEADER_KEYS = new Set([
+    'type', 'title', 'subtitle', 'theme',
+    'x-axis', 'y-axis', 'x', 'y'
+]);
+function isHeaderKey(key) {
+    return HEADER_KEYS.has(key.toLowerCase());
+}
+function cleanNumber(value) {
+    // Remove common formatting: $, %, commas, spaces
+    const cleaned = value.replace(/[$%,\s]/g, '');
+    return parseFloat(cleaned);
+}
+export function parse(input) {
+    const lines = input.split('\n');
+    const errors = [];
+    let type = 'bar';
+    let title;
+    let subtitle;
+    let xAxis;
+    let yAxis;
+    let theme;
+    const labels = [];
+    const values = [];
+    let inDataSection = false;
+    for (let i = 0; i < lines.length; i++) {
+        const lineNum = i + 1;
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('#')) {
+            continue;
+        }
+        // Find colon separator
+        const colonIndex = trimmed.indexOf(':');
+        if (colonIndex === -1) {
+            errors.push({ line: lineNum, message: `Missing ':' separator` });
+            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 ':'` });
+            continue;
+        }
+        // Parse header fields
+        if (!inDataSection && isHeaderKey(key)) {
+            const keyLower = key.toLowerCase();
+            switch (keyLower) {
+                case 'type':
+                    const validTypes = ['bar', 'line', 'pie', 'area'];
+                    const typeLower = value.toLowerCase();
+                    if (validTypes.includes(typeLower)) {
+                        type = typeLower;
+                    }
+                    else {
+                        errors.push({
+                            line: lineNum,
+                            message: `Invalid chart type '${value}'. Valid types: ${validTypes.join(', ')}`
+                        });
+                    }
+                    break;
+                case 'title':
+                    title = value.replace(/^["']|["']$/g, '');
+                    break;
+                case 'subtitle':
+                    subtitle = value.replace(/^["']|["']$/g, '');
+                    break;
+                case 'x-axis':
+                case 'x':
+                    xAxis = value;
+                    break;
+                case 'y-axis':
+                case 'y':
+                    yAxis = value;
+                    break;
+                case 'theme':
+                    theme = 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;
+            }
+            labels.push(key);
+            values.push(numValue);
+        }
+    }
+    // Validation
+    if (labels.length === 0 && errors.length === 0) {
+        errors.push({ line: 0, message: 'No data points found' });
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    const ir = {
+        type,
+        labels,
+        values,
+    };
+    if (title)
+        ir.title = title;
+    if (subtitle)
+        ir.subtitle = subtitle;
+    if (xAxis || yAxis || theme) {
+        ir.meta = {};
+        if (xAxis)
+            ir.meta.xAxis = xAxis;
+        if (yAxis)
+            ir.meta.yAxis = yAxis;
+        if (theme)
+            ir.meta.theme = theme;
+    }
+    return { ok: true, ir };
+}

package/dist/parse.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parse.test.d.ts.map

package/dist/parse.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.test.d.ts","sourceRoot":"","sources":["../src/parse.test.ts"],"names":[],"mappings":""}

package/dist/parse.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect } from 'vitest';
+import { parse } from './parse';
+describe('parse', () => {
+    describe('basic parsing', () => {
+        it('parses simple bar chart', () => {
+            const result = parse(`
+Type: Bar
+Title: Test
+
+A: 10
+B: 20
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.type).toBe('bar');
+                expect(result.ir.title).toBe('Test');
+                expect(result.ir.labels).toEqual(['A', 'B']);
+                expect(result.ir.values).toEqual([10, 20]);
+            }
+        });
+        it('defaults to bar chart when type not specified', () => {
+            const result = parse(`
+A: 10
+B: 20
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.type).toBe('bar');
+            }
+        });
+    });
+    describe('number cleaning', () => {
+        it('handles currency format ($1,200)', () => {
+            const result = parse(`
+Price: $1,200
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.values).toEqual([1200]);
+            }
+        });
+        it('handles percentage format (50%)', () => {
+            const result = parse(`
+Rate: 50%
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.values).toEqual([50]);
+            }
+        });
+        it('handles numbers with commas (1,000,000)', () => {
+            const result = parse(`
+Big: 1,000,000
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.values).toEqual([1000000]);
+            }
+        });
+    });
+    describe('whitespace handling', () => {
+        it('ignores empty lines', () => {
+            const result = parse(`
+Type: Bar
+
+A: 10
+
+B: 20
+
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.labels).toEqual(['A', 'B']);
+            }
+        });
+        it('ignores comment lines (// and #)', () => {
+            const result = parse(`
+// This is a comment
+Type: Bar
+# Another comment
+A: 10
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.labels).toEqual(['A']);
+            }
+        });
+    });
+    describe('error handling', () => {
+        it('reports error for missing colon', () => {
+            const result = parse(`
+Type: Bar
+A 10
+`);
+            expect(result.ok).toBe(false);
+            if (!result.ok) {
+                expect(result.errors[0].message).toContain("Missing ':'");
+                expect(result.errors[0].line).toBe(3);
+            }
+        });
+        it('reports error for invalid number', () => {
+            const result = parse(`
+Type: Bar
+A: abc
+`);
+            expect(result.ok).toBe(false);
+            if (!result.ok) {
+                expect(result.errors[0].message).toContain("Invalid number");
+            }
+        });
+        it('reports error for invalid chart type', () => {
+            const result = parse(`
+Type: InvalidType
+A: 10
+`);
+            expect(result.ok).toBe(false);
+            if (!result.ok) {
+                expect(result.errors[0].message).toContain("Invalid chart type");
+            }
+        });
+        it('reports error when no data points', () => {
+            const result = parse(`
+Type: Bar
+Title: Empty
+`);
+            expect(result.ok).toBe(false);
+            if (!result.ok) {
+                expect(result.errors[0].message).toContain("No data points");
+            }
+        });
+    });
+    describe('title parsing', () => {
+        it('strips quotes from title', () => {
+            const result = parse(`
+Title: "Quoted Title"
+A: 10
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.title).toBe('Quoted Title');
+            }
+        });
+        it('handles title without quotes', () => {
+            const result = parse(`
+Title: Unquoted Title
+A: 10
+`);
+            expect(result.ok).toBe(true);
+            if (result.ok) {
+                expect(result.ir.title).toBe('Unquoted Title');
+            }
+        });
+    });
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@plainviz/core",
+  "version": "0.1.0",
+  "description": "PlainViz core parser and IR",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest"
+  },
+  "keywords": [
+    "plainviz",
+    "parser",
+    "chart",
+    "visualization"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.0"
+  }
+}

package/src/index.ts

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

package/src/ir.ts

@@ -0,0 +1,29 @@
+/**
+ * PlainViz Intermediate Representation (IR)
+ * This is the canonical output of the parser.
+ * All renderers consume this format.
+ */
+
+export type ChartType = 'bar' | 'line' | 'pie' | 'area';
+
+export interface PlainVizIR {
+  type: ChartType;
+  title?: string;
+  subtitle?: string;
+  labels: string[];
+  values: number[];
+  meta?: {
+    xAxis?: string;
+    yAxis?: string;
+    theme?: string;
+  };
+}
+
+export interface ParseError {
+  line: number;
+  message: string;
+}
+
+export type ParseResult =
+  | { ok: true; ir: PlainVizIR }
+  | { ok: false; errors: ParseError[] };

package/src/parse.test.ts

@@ -0,0 +1,167 @@
+import { describe, it, expect } from 'vitest';
+import { parse } from './parse';
+
+describe('parse', () => {
+  describe('basic parsing', () => {
+    it('parses simple bar chart', () => {
+      const result = parse(`
+Type: Bar
+Title: Test
+
+A: 10
+B: 20
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.type).toBe('bar');
+        expect(result.ir.title).toBe('Test');
+        expect(result.ir.labels).toEqual(['A', 'B']);
+        expect(result.ir.values).toEqual([10, 20]);
+      }
+    });
+
+    it('defaults to bar chart when type not specified', () => {
+      const result = parse(`
+A: 10
+B: 20
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.type).toBe('bar');
+      }
+    });
+  });
+
+  describe('number cleaning', () => {
+    it('handles currency format ($1,200)', () => {
+      const result = parse(`
+Price: $1,200
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.values).toEqual([1200]);
+      }
+    });
+
+    it('handles percentage format (50%)', () => {
+      const result = parse(`
+Rate: 50%
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.values).toEqual([50]);
+      }
+    });
+
+    it('handles numbers with commas (1,000,000)', () => {
+      const result = parse(`
+Big: 1,000,000
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.values).toEqual([1000000]);
+      }
+    });
+  });
+
+  describe('whitespace handling', () => {
+    it('ignores empty lines', () => {
+      const result = parse(`
+Type: Bar
+
+A: 10
+
+B: 20
+
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.labels).toEqual(['A', 'B']);
+      }
+    });
+
+    it('ignores comment lines (// and #)', () => {
+      const result = parse(`
+// This is a comment
+Type: Bar
+# Another comment
+A: 10
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.labels).toEqual(['A']);
+      }
+    });
+  });
+
+  describe('error handling', () => {
+    it('reports error for missing colon', () => {
+      const result = parse(`
+Type: Bar
+A 10
+`);
+      expect(result.ok).toBe(false);
+      if (!result.ok) {
+        expect(result.errors[0].message).toContain("Missing ':'");
+        expect(result.errors[0].line).toBe(3);
+      }
+    });
+
+    it('reports error for invalid number', () => {
+      const result = parse(`
+Type: Bar
+A: abc
+`);
+      expect(result.ok).toBe(false);
+      if (!result.ok) {
+        expect(result.errors[0].message).toContain("Invalid number");
+      }
+    });
+
+    it('reports error for invalid chart type', () => {
+      const result = parse(`
+Type: InvalidType
+A: 10
+`);
+      expect(result.ok).toBe(false);
+      if (!result.ok) {
+        expect(result.errors[0].message).toContain("Invalid chart type");
+      }
+    });
+
+    it('reports error when no data points', () => {
+      const result = parse(`
+Type: Bar
+Title: Empty
+`);
+      expect(result.ok).toBe(false);
+      if (!result.ok) {
+        expect(result.errors[0].message).toContain("No data points");
+      }
+    });
+  });
+
+  describe('title parsing', () => {
+    it('strips quotes from title', () => {
+      const result = parse(`
+Title: "Quoted Title"
+A: 10
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.title).toBe('Quoted Title');
+      }
+    });
+
+    it('handles title without quotes', () => {
+      const result = parse(`
+Title: Unquoted Title
+A: 10
+`);
+      expect(result.ok).toBe(true);
+      if (result.ok) {
+        expect(result.ir.title).toBe('Unquoted Title');
+      }
+    });
+  });
+});

package/src/parse.ts

@@ -0,0 +1,142 @@
+/**
+ * PlainViz Parser
+ * Parses PlainViz syntax into IR (Intermediate Representation)
+ */
+
+import type { PlainVizIR, ParseResult, ParseError, ChartType } from './ir';
+
+const HEADER_KEYS = new Set([
+  'type', 'title', 'subtitle', 'theme',
+  'x-axis', 'y-axis', 'x', 'y'
+]);
+
+function isHeaderKey(key: string): boolean {
+  return HEADER_KEYS.has(key.toLowerCase());
+}
+
+function cleanNumber(value: string): number {
+  // Remove common formatting: $, %, commas, spaces
+  const cleaned = value.replace(/[$%,\s]/g, '');
+  return parseFloat(cleaned);
+}
+
+export function parse(input: string): ParseResult {
+  const lines = input.split('\n');
+  const errors: ParseError[] = [];
+
+  let type: ChartType = 'bar';
+  let title: string | undefined;
+  let subtitle: string | undefined;
+  let xAxis: string | undefined;
+  let yAxis: string | undefined;
+  let theme: string | undefined;
+
+  const labels: string[] = [];
+  const values: number[] = [];
+
+  let inDataSection = false;
+
+  for (let i = 0; i < lines.length; i++) {
+    const lineNum = i + 1;
+    const line = lines[i];
+    const trimmed = line.trim();
+
+    // Skip empty lines and comments
+    if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('#')) {
+      continue;
+    }
+
+    // Find colon separator
+    const colonIndex = trimmed.indexOf(':');
+    if (colonIndex === -1) {
+      errors.push({ line: lineNum, message: `Missing ':' separator` });
+      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 ':'` });
+      continue;
+    }
+
+    // Parse header fields
+    if (!inDataSection && isHeaderKey(key)) {
+      const keyLower = key.toLowerCase();
+
+      switch (keyLower) {
+        case 'type':
+          const validTypes = ['bar', 'line', 'pie', 'area'];
+          const typeLower = value.toLowerCase();
+          if (validTypes.includes(typeLower)) {
+            type = typeLower as ChartType;
+          } else {
+            errors.push({
+              line: lineNum,
+              message: `Invalid chart type '${value}'. Valid types: ${validTypes.join(', ')}`
+            });
+          }
+          break;
+        case 'title':
+          title = value.replace(/^["']|["']$/g, '');
+          break;
+        case 'subtitle':
+          subtitle = value.replace(/^["']|["']$/g, '');
+          break;
+        case 'x-axis':
+        case 'x':
+          xAxis = value;
+          break;
+        case 'y-axis':
+        case 'y':
+          yAxis = value;
+          break;
+        case 'theme':
+          theme = 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;
+      }
+
+      labels.push(key);
+      values.push(numValue);
+    }
+  }
+
+  // Validation
+  if (labels.length === 0 && errors.length === 0) {
+    errors.push({ line: 0, message: 'No data points found' });
+  }
+
+  if (errors.length > 0) {
+    return { ok: false, errors };
+  }
+
+  const ir: PlainVizIR = {
+    type,
+    labels,
+    values,
+  };
+
+  if (title) ir.title = title;
+  if (subtitle) ir.subtitle = subtitle;
+  if (xAxis || yAxis || theme) {
+    ir.meta = {};
+    if (xAxis) ir.meta.xAxis = xAxis;
+    if (yAxis) ir.meta.yAxis = yAxis;
+    if (theme) ir.meta.theme = theme;
+  }
+
+  return { ok: true, ir };
+}