@liujitcn/kratos-admin-bi 0.0.0-stage → 0.1.6

package/dist/package/declarations/src/components/BiWorkbenchPreview.vue.d.ts

@@ -0,0 +1,7 @@
+import type { BiDashboard } from "../rpc/bi/admin/v1/bi_dashboard";
+type __VLS_Props = {
+    dashboard: BiDashboard;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/declarations/src/components/BiWorkbenchPreview.vue.js

@@ -0,0 +1,176 @@
+/// <reference types="../../../../../node_modules/.pnpm/@vue+language-core@3.3.13/node_modules/@vue/language-core/types/template-helpers.d.ts" />
+/// <reference types="../../../../../node_modules/.pnpm/@vue+language-core@3.3.13/node_modules/@vue/language-core/types/props-fallback.d.ts" />
+import { onBeforeUnmount, ref } from "vue";
+import { useIntersectionObserver } from "@vueuse/core";
+import { t } from "@liujitcn/kratos-admin-core";
+import { dashboardResults, dashboardSnapshotCard, parseDashboardLayout } from "../bi-dashboard-schema";
+import { defBiDashboardService } from "../api/bi/admin/v1/bi_dashboard";
+import BiCardVisualization from "./BiCardVisualization.vue";
+const { defineProps, } = {};
+const props = defineProps();
+const host = ref();
+const layout = ref({ schemaVersion: 3, name: "", cards: [] });
+const results = ref(new Map());
+const loading = ref(true);
+const error = ref("");
+let active = true;
+const { stop } = useIntersectionObserver(host, ([entry]) => {
+    if (entry?.isIntersecting) {
+        stop();
+        void load();
+    }
+});
+/** 入口可见时按发布版本取真实数据，缩略图复用卡片渲染器。 */
+async function load() {
+    loading.value = true;
+    error.value = "";
+    try {
+        const data = await defBiDashboardService.GetBiDashboardData({
+            id: props.dashboard.id,
+            version: props.dashboard.published_version
+        });
+        if (!active)
+            return;
+        layout.value = parseDashboardLayout(data.schema_json);
+        results.value = dashboardResults(data);
+    }
+    catch (cause) {
+        if (active)
+            error.value = cause instanceof Error ? cause.message : t("bi.query.error");
+    }
+    finally {
+        if (active)
+            loading.value = false;
+    }
+}
+onBeforeUnmount(() => {
+    active = false;
+});
+const __VLS_ctx = {
+    ...{},
+    ...{},
+    ...{},
+};
+let __VLS_components;
+let __VLS_intrinsics;
+let __VLS_directives;
+void __VLS_ctx, __VLS_components, __VLS_intrinsics, __VLS_directives;
+// @ts-ignore
+__VLS_withDotValue(loading, {});
+// @ts-ignore
+__VLS_withDotValue(error, {});
+// @ts-ignore
+__VLS_withDotValue(layout, {});
+// @ts-ignore
+__VLS_withDotValue(results, {});
+void {};
+/** @type {__VLS_StyleScopedClasses['bi-workbench-preview']} */ ;
+/** @type {__VLS_StyleScopedClasses['bi-workbench-preview']} */ ;
+/** @type {__VLS_StyleScopedClasses['bi-workbench-preview__empty']} */ ;
+__VLS_asFunctionalElement1(__VLS_intrinsics.div, __VLS_intrinsics.div)({
+    ref: "host",
+    ...{ class: "bi-workbench-preview" },
+    'aria-busy': (loading.value),
+});
+/** @type {__VLS_StyleScopedClasses['bi-workbench-preview']} */ ;
+if (loading.value) {
+    let __VLS_0;
+    /** @ts-ignore @type { | typeof __VLS_components.elSkeleton | typeof __VLS_components.ElSkeleton | typeof __VLS_components['el-skeleton']} */
+    elSkeleton;
+    // @ts-ignore
+    const __VLS_1 = __VLS_asFunctionalComponent1(__VLS_0, new __VLS_0({
+        // @ts-ignore
+        rows: (2), animated: true,
+    }));
+    const __VLS_2 = __VLS_1({
+        rows: (2),
+        animated: true,
+    }, ...__VLS_functionalComponentArgsRest(__VLS_1));
+}
+else if (error.value) {
+    __VLS_asFunctionalElement1(__VLS_intrinsics.div, __VLS_intrinsics.div)({
+        ...{ class: "bi-workbench-preview__empty" },
+        role: "alert",
+    });
+    /** @type {__VLS_StyleScopedClasses['bi-workbench-preview__empty']} */ ;
+    __VLS_asFunctionalElement1(__VLS_intrinsics.span, __VLS_intrinsics.span)({});
+    (error.value);
+    let __VLS_5;
+    /** @ts-ignore @type { | typeof __VLS_components.elButton | typeof __VLS_components.ElButton | typeof __VLS_components['el-button'] | typeof __VLS_components.elButton | typeof __VLS_components.ElButton | typeof __VLS_components['el-button']} */
+    elButton;
+    // @ts-ignore
+    const __VLS_6 = __VLS_asFunctionalComponent1(__VLS_5, new __VLS_5({
+        // @ts-ignore
+        ...{ 'onClick': {} }, link: true, type: "primary",
+    }));
+    const __VLS_7 = __VLS_6({
+        ...{ 'onClick': {} },
+        link: true,
+        type: "primary",
+    }, ...__VLS_functionalComponentArgsRest(__VLS_6));
+    let __VLS_10;
+    const __VLS_11 = {
+        /** @type {typeof __VLS_10.click} */
+        onClick: (load),
+    };
+    void __VLS_11;
+    const { default: __VLS_12 } = __VLS_nonNull(__VLS_8.slots);
+    (__VLS_unwrap(t, {})("bi.card.retry"));
+    // @ts-ignore
+    [loading, loading, error, error, t,];
+    var __VLS_8;
+    var __VLS_9;
+}
+else {
+    const __VLS_13 = __VLS_tryAsConstant((layout.value.cards.slice(0, 2)));
+    for (const [item] of __VLS_vFor(__VLS_nonNull(__VLS_13))) {
+        __VLS_asFunctionalElement1(__VLS_intrinsics.div, __VLS_intrinsics.div)({
+            key: (item.id),
+            ...{ class: "bi-workbench-preview__card" },
+        });
+        /** @type {__VLS_StyleScopedClasses['bi-workbench-preview__card']} */ ;
+        __VLS_asFunctionalElement1(__VLS_intrinsics.h4, __VLS_intrinsics.h4)({
+            title: (item.name),
+        });
+        (item.name);
+        __VLS_asFunctionalElement1(__VLS_intrinsics.div, __VLS_intrinsics.div)({
+            ...{ class: "bi-workbench-preview__chart" },
+        });
+        /** @type {__VLS_StyleScopedClasses['bi-workbench-preview__chart']} */ ;
+        if (results.value.get(item.id)) {
+            const __VLS_14 = BiCardVisualization;
+            // @ts-ignore
+            const __VLS_15 = __VLS_asFunctionalComponent1(__VLS_14, new __VLS_14({
+                // @ts-ignore
+                card: (__VLS_unwrap(dashboardSnapshotCard, {})(item)), result: (results.value.get(item.id)), compact: true,
+            }));
+            const __VLS_16 = __VLS_15({
+                card: (__VLS_unwrap(dashboardSnapshotCard, {})(item)),
+                result: (results.value.get(item.id)),
+                compact: true,
+            }, ...__VLS_functionalComponentArgsRest(__VLS_15));
+        }
+        else {
+            __VLS_asFunctionalElement1(__VLS_intrinsics.span, __VLS_intrinsics.span)({
+                ...{ class: "bi-workbench-preview__empty" },
+            });
+            /** @type {__VLS_StyleScopedClasses['bi-workbench-preview__empty']} */ ;
+            (__VLS_unwrap(t, {})("common.message.no_data"));
+        }
+        // @ts-ignore
+        [t, layout, results, results, dashboardSnapshotCard,];
+    }
+    if (!layout.value.cards.length) {
+        __VLS_asFunctionalElement1(__VLS_intrinsics.span, __VLS_intrinsics.span)({
+            ...{ class: "bi-workbench-preview__empty" },
+        });
+        /** @type {__VLS_StyleScopedClasses['bi-workbench-preview__empty']} */ ;
+        (__VLS_unwrap(t, {})("bi.dashboard.empty"));
+    }
+}
+// @ts-ignore
+[t, layout,];
+const __VLS_export = (await import('vue')).defineComponent({
+    __typeProps: {},
+});
+export default {};

package/dist/package/declarations/src/components/source-model-layout.d.ts

@@ -0,0 +1,3 @@
+import type { BiSourceModel } from "../rpc/bi/admin/v1/bi_source";
+/** 将事实表置于中央，关联子树分布两侧并为连线保留间距。 */
+export declare function formatSourceModelLayout(model: BiSourceModel): void;

package/dist/package/declarations/src/components/source-model-layout.js

@@ -0,0 +1,66 @@
+/** 将事实表置于中央，关联子树分布两侧并为连线保留间距。 */
+export function formatSourceModelLayout(model) {
+    const tables = new Map(model.tables.map(table => [table.key, table]));
+    const children = new Map();
+    const targets = new Set();
+    for (const relation of model.relations) {
+        if (!tables.has(relation.left_table) || !tables.has(relation.right_table))
+            continue;
+        const branch = children.get(relation.left_table) ?? [];
+        branch.push(relation.right_table);
+        children.set(relation.left_table, branch);
+        targets.add(relation.right_table);
+    }
+    if (tables.has(model.base_table)) {
+        const branches = children.get(model.base_table) ?? [];
+        for (const table of model.tables) {
+            if (table.key !== model.base_table && !targets.has(table.key))
+                branches.push(table.key);
+        }
+        children.set(model.base_table, branches);
+    }
+    const visited = new Set();
+    let row = 0;
+    /** 为子树分配独立行，避免同层节点和不同分支相互遮挡。 */
+    function placeTable(key, depth, direction) {
+        const table = tables.get(key);
+        if (!table || visited.has(key))
+            return;
+        visited.add(key);
+        const childRows = (children.get(key) ?? [])
+            .map(child => placeTable(child, depth + 1, direction))
+            .filter((value) => value !== undefined);
+        const center = childRows.length ? (childRows[0] + childRows[childRows.length - 1]) / 2 : row++;
+        table.x = direction * depth * 520;
+        table.y = 40 + center * 280;
+        return center;
+    }
+    const base = tables.get(model.base_table);
+    if (base) {
+        visited.add(base.key);
+        const branches = children.get(base.key) ?? [];
+        const middle = Math.ceil(branches.length / 2);
+        for (const key of branches.slice(0, middle))
+            placeTable(key, 1, 1);
+        const rightRows = row;
+        const rightTables = model.tables.filter(table => visited.has(table.key) && table !== base);
+        row = 0;
+        for (const key of branches.slice(middle))
+            placeTable(key, 1, -1);
+        const leftRows = row;
+        row = Math.max(1, leftRows, rightRows);
+        for (const table of rightTables)
+            table.y += (row - rightRows) * 140;
+        for (const table of model.tables.filter(table => visited.has(table.key) && table.x < 0))
+            table.y += (row - leftRows) * 140;
+        base.x = 0;
+        base.y = 40 + (row - 1) * 140;
+    }
+    for (const table of model.tables.filter(table => !targets.has(table.key)))
+        placeTable(table.key, 0, 1);
+    for (const table of model.tables)
+        placeTable(table.key, 0, 1);
+    const minX = Math.min(0, ...model.tables.map(table => table.x));
+    for (const table of model.tables)
+        table.x += 40 - minX;
+}

package/dist/package/declarations/src/dataset/index.d.ts

@@ -0,0 +1,7 @@
+import type { BiRow } from "../schema/types";
+/** 从行集合推导列名（所有行键的并集，保持首次出现顺序） */
+export declare function getColumns(rows: BiRow[] | undefined): string[];
+/** 数值化：非有限数归 0（图表轴不允许 NaN/undefined） */
+export declare function toNumber(value: unknown): number;
+/** 去重保序 */
+export declare function unique<T>(list: T[]): T[];

package/dist/package/declarations/src/dataset/index.js

@@ -0,0 +1,25 @@
+/** 从行集合推导列名（所有行键的并集，保持首次出现顺序） */
+export function getColumns(rows) {
+    if (!rows?.length)
+        return [];
+    const cols = [];
+    const seen = new Set();
+    for (const row of rows) {
+        for (const key of Object.keys(row ?? {})) {
+            if (!seen.has(key)) {
+                seen.add(key);
+                cols.push(key);
+            }
+        }
+    }
+    return cols;
+}
+/** 数值化：非有限数归 0（图表轴不允许 NaN/undefined） */
+export function toNumber(value) {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : 0;
+}
+/** 去重保序 */
+export function unique(list) {
+    return [...new Set(list)];
+}

package/dist/package/declarations/src/dataset/labels.d.ts

@@ -0,0 +1,2 @@
+/** 按日期分组值生成短标签，只改变显示文本，保留原始分类和提示数据。 */
+export declare function createDimensionLabelFormatter(values: unknown[], field?: string): (value: unknown) => string;

package/dist/package/declarations/src/dataset/labels.js

@@ -0,0 +1,21 @@
+/** 按日期分组值生成短标签，只改变显示文本，保留原始分类和提示数据。 */
+export function createDimensionLabelFormatter(values, field = "") {
+    const pattern = /^(\d{4})-(\d{2})(?:-(\d{2})(?:[ T](\d{2})(?::(\d{2}))?(?::(\d{2})(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?)?$/;
+    const dates = values.map(value => pattern.exec(String(value ?? ""))).filter(value => value !== null);
+    const month = /(?:^|_)(?:month|monthly|ym)(?:_|$)|月/i.test(field);
+    const hour = /(?:^|_)(?:hour|hourly)(?:_|$)|小时/i.test(field) ||
+        (dates.length > 0 &&
+            dates.every(date => date[3] && date[0].slice(0, 10) === dates[0][0].slice(0, 10)) &&
+            dates.some(date => Number(date[4]) || Number(date[5]) || Number(date[6])));
+    return value => {
+        const text = String(value ?? "");
+        const date = pattern.exec(text);
+        if (!date)
+            return text;
+        if (month || !date[3])
+            return `${date[2]}月`;
+        if (hour && date[4])
+            return `${date[4]}时`;
+        return `${date[2]}/${date[3]}`;
+    };
+}

package/dist/package/declarations/src/dataset/transform.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 图表级数据变换管线：过滤 → 聚合 → 排序 → TopN。
+ * 渲染器在 compile 前调用 transformRows，设计器画布与渲染器共用同一管线。
+ * 聚合语义 = 主流 BI：按 dimension 分组，对 measure（或宽表 measures 全部列）施加 agg。
+ */
+import type { BiChartFilter, BiChartSchema, BiRow } from "../schema/types";
+export declare function applyFilters(rows: BiRow[], filters: BiChartFilter[] | undefined): BiRow[];
+/** 分组聚合：输出每（维度组）一行的宽表（保留维度列 + 各度量列） */
+export declare function aggregateRows(rows: BiRow[], chart: BiChartSchema): BiRow[];
+export declare function sortRows(rows: BiRow[], chart: BiChartSchema): BiRow[];
+/** 渲染管线：过滤 → 聚合 → 排序/TopN，返回供 compile 消费的行 */
+export declare function transformRows(chart: BiChartSchema, inputRows: BiRow[]): BiRow[];
+export type BiFieldType = "number" | "date" | "string";
+export declare function inferFieldType(rows: BiRow[] | undefined, field: string): BiFieldType;
+export declare function formatNumber(value: number, format?: {
+    decimals?: number;
+    thousand?: boolean;
+    prefix?: string;
+    suffix?: string;
+}): string;

package/dist/package/declarations/src/dataset/transform.js

@@ -0,0 +1,173 @@
+/**
+ * 图表级数据变换管线：过滤 → 聚合 → 排序 → TopN。
+ * 渲染器在 compile 前调用 transformRows，设计器画布与渲染器共用同一管线。
+ * 聚合语义 = 主流 BI：按 dimension 分组，对 measure（或宽表 measures 全部列）施加 agg。
+ */
+import { NON_AGG_TYPES } from "../engine/chart-types";
+import { toNumber } from "./index";
+/** 单过滤器行判定；值解析：数字串转数，in 接数组 */
+function matchFilter(row, f) {
+    const cell = row[f.field];
+    switch (f.op) {
+        case "eq":
+            return String(cell) === String(f.value);
+        case "ne":
+            return String(cell) !== String(f.value);
+        case "gt":
+            return toNumber(cell) > toNumber(f.value);
+        case "gte":
+            return toNumber(cell) >= toNumber(f.value);
+        case "lt":
+            return toNumber(cell) < toNumber(f.value);
+        case "lte":
+            return toNumber(cell) <= toNumber(f.value);
+        case "contains":
+            return String(cell ?? "").includes(String(f.value ?? ""));
+        case "in": {
+            const list = Array.isArray(f.value) ? f.value : [f.value];
+            return list.map(String).includes(String(cell));
+        }
+        default:
+            return true;
+    }
+}
+export function applyFilters(rows, filters) {
+    if (!filters?.length)
+        return rows;
+    return rows.filter((row) => filters.every((f) => matchFilter(row, f)));
+}
+const AGG_FNS = {
+    sum: (nums) => nums.reduce((a, b) => a + b, 0),
+    avg: (nums) => (nums.length ? nums.reduce((a, b) => a + b, 0) / nums.length : 0),
+    max: (nums) => (nums.length ? Math.max(...nums) : 0),
+    min: (nums) => (nums.length ? Math.min(...nums) : 0),
+    // count 不依赖数值：调用方传入占位 1 数组
+    count: (nums) => nums.length,
+};
+/** 是否应执行聚合：给了 dimension + 显式 agg（非 none）；
+ *  边列表/矩阵型（sankey/graph/heatmap）天然按行消费，不做维度聚合 */
+function shouldAggregate(chart) {
+    if (NON_AGG_TYPES.has(chart.type))
+        return false;
+    const agg = chart.aggregation ?? "sum";
+    const dim = chart.encoding?.dimension;
+    if (!dim || agg === "none")
+        return false;
+    // 至少要有一个度量对象（count 允许无 measure）
+    return !!(chart.encoding?.measure || chart.encoding?.measures?.length || agg === "count");
+}
+/** 分组键字段：维度 + （pivot 图的列维度也要保留，供 S2 交叉表用） */
+function groupFieldsOf(chart) {
+    const fields = [chart.encoding?.dimension ?? ""];
+    if (chart.type === "pivot" && chart.encoding?.series)
+        fields.push(chart.encoding.series);
+    return fields.filter(Boolean);
+}
+/** 分组聚合：输出每（维度组）一行的宽表（保留维度列 + 各度量列） */
+export function aggregateRows(rows, chart) {
+    const groupFields = groupFieldsOf(chart);
+    const agg = chart.aggregation ?? "sum";
+    const measure = chart.encoding?.measure;
+    const measures = chart.encoding?.measures ?? (measure ? [measure] : []);
+    const keyOf = (row) => groupFields.map((f) => String(row[f] ?? "")).join("\u0001");
+    const groups = new Map();
+    for (const row of rows) {
+        const key = keyOf(row);
+        const bucket = groups.get(key);
+        if (bucket)
+            bucket.push(row);
+        else
+            groups.set(key, [row]);
+    }
+    const apply = (nums) => {
+        switch (agg) {
+            case "count":
+                return nums.length;
+            case "none":
+                return 0;
+            case "avg":
+                return AGG_FNS.avg(nums);
+            case "max":
+                return AGG_FNS.max(nums);
+            case "min":
+                return AGG_FNS.min(nums);
+            default:
+                return AGG_FNS.sum(nums);
+        }
+    };
+    const out = [];
+    for (const bucket of groups.values()) {
+        const row = {};
+        for (const f of groupFields)
+            row[f] = bucket[0]?.[f];
+        if (agg === "count" && measures.length === 0) {
+            // 纯计数：值列名用 measure 占位或固定 count
+            row[measure ?? "count"] = bucket.length;
+        }
+        for (const m of measures) {
+            row[m] = apply(bucket.map((r) => (agg === "count" ? 1 : toNumber(r[m]))));
+        }
+        // 非分组字段的长表 series 值在聚合后无意义（pivot 的列维度已保留），丢弃
+        out.push(row);
+    }
+    return out;
+}
+export function sortRows(rows, chart) {
+    const sort = chart.sort;
+    if (!sort)
+        return rows;
+    const dim = chart.encoding?.dimension ?? "";
+    const measure = chart.encoding?.measures?.[0] ?? chart.encoding?.measure ?? "";
+    const dir = sort.order === "desc" ? -1 : 1;
+    const sorted = [...rows].sort((a, b) => {
+        if (sort.by === "measure" && measure) {
+            return (toNumber(a[measure]) - toNumber(b[measure])) * dir;
+        }
+        return String(a[dim] ?? "").localeCompare(String(b[dim] ?? ""), "zh-CN") * dir;
+    });
+    return sort.topN && sort.topN > 0 ? sorted.slice(0, sort.topN) : sorted;
+}
+/** 渲染管线：过滤 → 聚合 → 排序/TopN，返回供 compile 消费的行 */
+export function transformRows(chart, inputRows) {
+    let rows = applyFilters(inputRows, chart.filters);
+    if (shouldAggregate(chart)) {
+        rows = aggregateRows(rows, chart);
+    }
+    rows = sortRows(rows, chart);
+    return rows;
+}
+export function inferFieldType(rows, field) {
+    if (!rows?.length)
+        return "string";
+    let sawValue = false;
+    let allNumber = true;
+    let allDate = true;
+    for (const row of rows.slice(0, 100)) {
+        const v = row?.[field];
+        if (v === null || v === undefined || v === "")
+            continue;
+        sawValue = true;
+        if (allNumber && !Number.isFinite(Number(v)))
+            allNumber = false;
+        if (allDate && !(typeof v === "string" && /^[\d-]{8,}$/.test(v) && !Number.isNaN(Date.parse(v)))) {
+            allDate = false;
+        }
+    }
+    if (!sawValue)
+        return "string";
+    if (allNumber)
+        return "number";
+    if (allDate)
+        return "date";
+    return "string";
+}
+// ============ 数值格式化（轴标签/标签/提示共用） ============
+export function formatNumber(value, format) {
+    let n = Number.isFinite(value) ? value : 0;
+    if (format?.decimals !== undefined)
+        n = Number(n.toFixed(format.decimals));
+    let str = String(n);
+    if (format?.thousand)
+        str = str.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+    return (format?.prefix ?? "") + str + (format?.suffix ?? "");
+}

package/dist/package/declarations/src/engine/chart-types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 图型注册表：type → engine 映射。
+ * 内置 8 种 echarts 图型；引擎适配器包（bi-engine-s2 等）经
+ * registerChartType("pivot", "s2") 扩展设计器的图型选择与引擎解析。
+ */
+import type { BiChartType } from "../schema/types";
+/** 边列表 / 矩阵型图：数据是边或三元组，默认不做维度聚合 */
+export declare const NON_AGG_TYPES: Set<string>;
+/** 注册新图型（设计器图型网格与 addChart 的引擎解析随之扩展）；重复注册覆盖 */
+export declare function registerChartType(type: string, engine: string): void;
+/** 已注册的全部图型（内置 + 扩展，按注册顺序） */
+export declare function getChartTypes(): BiChartType[];
+/** 图型对应的引擎名（未注册图型回落 echarts） */
+export declare function getEngineForType(type: string | undefined): string;

package/dist/package/declarations/src/engine/chart-types.js

@@ -0,0 +1,37 @@
+/**
+ * 图型注册表：type → engine 映射。
+ * 内置 8 种 echarts 图型；引擎适配器包（bi-engine-s2 等）经
+ * registerChartType("pivot", "s2") 扩展设计器的图型选择与引擎解析。
+ */
+const BUILTIN_CHART_TYPES = [
+    "bar",
+    "line",
+    "area",
+    "pie",
+    "donut",
+    "scatter",
+    "radar",
+    "gauge",
+    "funnel",
+    "treemap",
+    "sunburst",
+    "sankey",
+    "heatmap",
+];
+/** 边列表 / 矩阵型图：数据是边或三元组，默认不做维度聚合 */
+export const NON_AGG_TYPES = new Set(["sankey", "graph", "heatmap"]);
+const typeToEngine = new Map();
+for (const t of BUILTIN_CHART_TYPES)
+    typeToEngine.set(t, "echarts");
+/** 注册新图型（设计器图型网格与 addChart 的引擎解析随之扩展）；重复注册覆盖 */
+export function registerChartType(type, engine) {
+    typeToEngine.set(type, engine);
+}
+/** 已注册的全部图型（内置 + 扩展，按注册顺序） */
+export function getChartTypes() {
+    return [...typeToEngine.keys()];
+}
+/** 图型对应的引擎名（未注册图型回落 echarts） */
+export function getEngineForType(type) {
+    return typeToEngine.get(type ?? "") ?? "echarts";
+}

package/dist/package/declarations/src/engine/echarts.d.ts

@@ -0,0 +1,16 @@
+import type { BarSeriesOption, GaugeSeriesOption, LineSeriesOption, PieSeriesOption, RadarSeriesOption, ScatterSeriesOption } from "echarts/charts";
+import type { ComposeOption } from "echarts/core";
+import type { GridComponentOption, LegendComponentOption, TitleComponentOption, TooltipComponentOption } from "echarts/components";
+import type { BiResolvedTheme } from "../theme";
+import type { BiChartSchema, BiRow } from "../schema/types";
+import type { ChartEngine } from "./types";
+export type BiEChartsOption = ComposeOption<BarSeriesOption | LineSeriesOption | PieSeriesOption | ScatterSeriesOption | RadarSeriesOption | GaugeSeriesOption | TitleComponentOption | LegendComponentOption | TooltipComponentOption | GridComponentOption>;
+/** schema + 行数据 + 主题模式 → ECharts option */
+export declare function compileEcharts(chart: BiChartSchema, rows: BiRow[], theme: BiResolvedTheme): BiEChartsOption;
+/**
+ * 创建 ECharts 引擎实例（幂等注册 echarts 模块）。
+ * handle 上带内部约定字段 __echartsInstance 供 bindEvents 取实例。
+ */
+export declare function createEchartsEngine(): ChartEngine;
+/** 默认注册（调用方引入本模块后执行一次；重复注册无害） */
+export declare function installEchartsEngine(): void;