@vis-pilot/runtime 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present vis-pilot contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @vis-pilot/runtime
+
+Browser runtime wrapper for vis-pilot based on ECharts.
+
+## Usage
+
+```ts
+import { VisPilot } from '@vis-pilot/runtime'
+
+const container = document.getElementById('chart') as HTMLDivElement
+const pilot = new VisPilot(container, 'dark')
+
+pilot.render({
+  mode: 'text',
+  input: `
+chart: line
+title: Runtime Demo
+x: month
+y: value
+data:
+  - month: Jan
+    value: 120
+  - month: Feb
+    value: 150
+  - month: Mar
+    value: 170
+`
+})
+
+pilot.appendData([{ month: 'Apr', value: 190 }])
+
+window.addEventListener('beforeunload', () => {
+  pilot.dispose()
+})
+```

package/dist/VisPilot.d.ts

@@ -0,0 +1,11 @@
+import type { RenderInput } from '@vis-pilot/core';
+export declare class VisPilot {
+    private readonly chart;
+    private currentSchema?;
+    constructor(dom: HTMLElement, theme?: string);
+    render(input: RenderInput): void;
+    updateData(data: Record<string, unknown>[]): void;
+    appendData(data: Record<string, unknown>[]): void;
+    resize(): void;
+    dispose(): void;
+}

package/dist/VisPilot.js

@@ -0,0 +1,58 @@
+import * as echarts from 'echarts';
+import { buildOption, parseTextOrThrow, normalizeSchema, sanitizeOption, validateOption, validateSchema } from '@vis-pilot/engine';
+export class VisPilot {
+    constructor(dom, theme) {
+        this.chart = echarts.init(dom, theme);
+    }
+    render(input) {
+        if (input.mode === 'option') {
+            validateOption(input.input);
+            const option = sanitizeOption(input.input);
+            this.chart.setOption(option, { notMerge: true });
+            return;
+        }
+        const schema = input.mode === 'schema'
+            ? normalizeSchema(input.input)
+            : normalizeSchema(parseTextOrThrow(input.input));
+        validateSchema(schema);
+        this.currentSchema = schema;
+        const option = sanitizeOption(buildOption(schema));
+        this.chart.setOption(option, { notMerge: true });
+    }
+    updateData(data) {
+        if (!this.currentSchema) {
+            throw new Error('No active schema to update. Call render with schema/text mode first.');
+        }
+        this.render({
+            mode: 'schema',
+            input: {
+                ...this.currentSchema,
+                dataset: {
+                    ...this.currentSchema.dataset,
+                    source: data
+                }
+            }
+        });
+    }
+    appendData(data) {
+        if (!this.currentSchema) {
+            throw new Error('No active schema to append. Call render with schema/text mode first.');
+        }
+        this.render({
+            mode: 'schema',
+            input: {
+                ...this.currentSchema,
+                dataset: {
+                    ...this.currentSchema.dataset,
+                    source: [...this.currentSchema.dataset.source, ...data]
+                }
+            }
+        });
+    }
+    resize() {
+        this.chart.resize();
+    }
+    dispose() {
+        this.chart.dispose();
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './VisPilot.js';

package/dist/index.js

@@ -0,0 +1 @@
+export * from './VisPilot.js';

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@vis-pilot/runtime",
+  "version": "0.1.0",
+  "description": "Browser runtime wrapper for vis-pilot based on ECharts.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "echarts": "^5.6.0",
+    "@vis-pilot/core": "0.1.0",
+    "@vis-pilot/engine": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}