@hachej/boring-bi-dashboard 0.1.60

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 boringdata
+
+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,83 @@
+# @hachej/boring-bi-dashboard
+
+BI dashboard plugin primitives for Boring workspace.
+
+This package is the host-side home for the BSL dashboard UX:
+
+- prompt/agent output should target a neutral `boring.generated-pane` JSON contract with `profile: "bi-dashboard"`
+- the plugin renders approved dashboard components in boring-ui
+- BSL owns semantic queries and artifacts
+- the plugin maps components to ECharts/Perspective/json-render runtimes
+
+Current scope is an initial plugin shell and typed dashboard contract. The actual BSL server bridge, Perspective viewer runtime, ECharts runtime, and json-render adapter should be layered behind the same component schema.
+
+## Panel
+
+The plugin registers:
+
+- panel: `bi-dashboard.panel`
+- command: `bi-dashboard.open`
+
+## Dashboard contract
+
+Agents should generate specs shaped like:
+
+```json
+{
+  "kind": "boring.generated-pane",
+  "profile": "bi-dashboard",
+  "version": 1,
+  "title": "Revenue Overview",
+  "queries": {
+    "revenue_by_month": {
+      "id": "revenue_by_month",
+      "model": "orders",
+      "query": "sm.group_by(\"month\").aggregate(\"revenue\").order_by(\"month\")"
+    }
+  },
+  "root": "dashboard",
+  "elements": {
+    "dashboard": {
+      "type": "DashboardGrid",
+      "props": { "columns": 12 },
+      "children": ["revenue-line"]
+    },
+    "revenue-line": {
+      "type": "BSLChart",
+      "props": {
+        "queryId": "revenue_by_month",
+        "renderer": "echarts",
+        "chartType": "line",
+        "x": "month",
+        "y": "revenue"
+      }
+    }
+  }
+}
+```
+
+## Example and playground
+
+Example workspace fixtures live in `example/`:
+
+- `example/data/people.csv`
+- `example/dashboards/people.dashboard.json`
+- `example/eval/bi-dashboard.yaml`
+
+Run the plugin through the existing workspace playground without making it a default playground plugin:
+
+```bash
+BORING_EXTERNAL_PLUGINS=1 \
+BORING_AGENT_WORKSPACE_ROOT="$PWD/plugins/bi-dashboard/example" \
+pnpm --filter workspace-playground dev
+```
+
+Run the authoring eval through the plugin-local playground runner:
+
+```bash
+pnpm --filter @hachej/boring-bi-dashboard playground:eval
+```
+
+The runner checks that the agent writes a dashboard file and validates the generated JSON with `parseDashboardSpec`.
+
+See `playground/README.md` for full playground commands.

package/dist/front/index.d.ts

@@ -0,0 +1,28 @@
+import * as _hachej_boring_workspace_plugin from '@hachej/boring-workspace/plugin';
+import { PaneProps, BoringFrontSurfaceResolverRegistration } from '@hachej/boring-workspace/plugin';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { B as BslDashboardSpec } from '../types-BGZKL9Rs.js';
+export { a as BslChartSpec, b as BslDashboardComponentSpec, c as BslDashboardQuerySpec, d as BslPerspectiveViewerSpec } from '../types-BGZKL9Rs.js';
+import '@hachej/boring-generated-pane/shared';
+import 'zod';
+
+interface BiDashboardPaneParams {
+    path?: string;
+    spec?: BslDashboardSpec;
+}
+declare function BiDashboardPane({ params }: PaneProps<BiDashboardPaneParams>): react_jsx_runtime.JSX.Element;
+
+declare const sampleBiDashboardSpec: BslDashboardSpec;
+
+declare const BI_DASHBOARD_PANEL_ID = "bi-dashboard.panel";
+declare const BI_DASHBOARD_LEFT_TAB_ID = "bi-dashboard.dashboards";
+
+declare function DashboardFilesPane({ params, containerApi }: PaneProps<{
+    searchQuery?: string;
+}>): react_jsx_runtime.JSX.Element;
+
+declare const biDashboardSurfaceResolver: BoringFrontSurfaceResolverRegistration;
+
+declare const biDashboardPlugin: _hachej_boring_workspace_plugin.BoringFrontFactoryWithId;
+
+export { BI_DASHBOARD_LEFT_TAB_ID, BI_DASHBOARD_PANEL_ID, BiDashboardPane, type BiDashboardPaneParams, BslDashboardSpec, DashboardFilesPane, biDashboardPlugin, biDashboardSurfaceResolver, biDashboardPlugin as default, sampleBiDashboardSpec };