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

package/dist/package/declarations/src/bi-messages.d.ts

@@ -0,0 +1,247 @@
+/**
+ * BI 文案包（纯数据，零依赖）：渲染器只用 common.noData/Loading，
+ * 设计器（designer-vue）消费 designer.* 与 types.*。
+ * 键值取自 go-wind-admin 设计语言口径；改键同步两端包装包。
+ */
+export declare const BI_MESSAGES_ZH: {
+    common: {
+        noData: string;
+        loading: string;
+        back: string;
+        resetDrill: string;
+        exportImage: string;
+        fullscreen: string;
+    };
+    designer: {
+        addChart: string;
+        addDataset: string;
+        undo: string;
+        redo: string;
+        compact: string;
+        import: string;
+        exportTemplate: string;
+        export: string;
+        preview: string;
+        edit: string;
+        delete: string;
+        charts: string;
+        datasets: string;
+        property: string;
+        selectChart: string;
+        title: string;
+        type: string;
+        dataset: string;
+        encoding: string;
+        dimension: string;
+        measure: string;
+        series: string;
+        position: string;
+        size: string;
+        datasetName: string;
+        datasetType: string;
+        rowsJson: string;
+        apiParams: string;
+        typeStatic: string;
+        typeApi: string;
+        noDataset: string;
+        invalidJson: string;
+        save: string;
+        cancel: string;
+        importFailed: string;
+        confirmDeleteChart: string;
+        columns: string;
+        tabData: string;
+        tabStyle: string;
+        tabLayout: string;
+        duplicate: string;
+        paste: string;
+        aggregation: string;
+        aggNone: string;
+        aggSum: string;
+        aggAvg: string;
+        aggCount: string;
+        aggMax: string;
+        aggMin: string;
+        measures: string;
+        sortLabel: string;
+        sortByDim: string;
+        sortByMeasure: string;
+        asc: string;
+        desc: string;
+        topN: string;
+        filters: string;
+        addFilter: string;
+        filterField: string;
+        opEq: string;
+        opNe: string;
+        opGt: string;
+        opGte: string;
+        opLt: string;
+        opLte: string;
+        opContains: string;
+        opIn: string;
+        showLegend: string;
+        showLabel: string;
+        stack: string;
+        dataZoom: string;
+        palette: string;
+        paletteDefault: string;
+        paletteOcean: string;
+        paletteSunset: string;
+        paletteForest: string;
+        paletteMono: string;
+        numberFormat: string;
+        decimals: string;
+        thousand: string;
+        prefix: string;
+        suffix: string;
+        typeNumber: string;
+        typeString: string;
+        typeDate: string;
+        drillPath: string;
+        addDrillLevel: string;
+        linkage: string;
+        linkageTip: string;
+        templates: string;
+        themePreset: string;
+        themeAuto: string;
+    };
+    types: {
+        bar: string;
+        line: string;
+        area: string;
+        pie: string;
+        donut: string;
+        scatter: string;
+        radar: string;
+        gauge: string;
+        pivot: string;
+        graph: string;
+        funnel: string;
+        treemap: string;
+        sunburst: string;
+        sankey: string;
+        heatmap: string;
+    };
+};
+export declare const BI_MESSAGES_EN: {
+    common: {
+        noData: string;
+        loading: string;
+        back: string;
+        resetDrill: string;
+        exportImage: string;
+        fullscreen: string;
+    };
+    designer: {
+        addChart: string;
+        addDataset: string;
+        undo: string;
+        redo: string;
+        compact: string;
+        import: string;
+        exportTemplate: string;
+        export: string;
+        preview: string;
+        edit: string;
+        delete: string;
+        charts: string;
+        datasets: string;
+        property: string;
+        selectChart: string;
+        title: string;
+        type: string;
+        dataset: string;
+        encoding: string;
+        dimension: string;
+        measure: string;
+        series: string;
+        position: string;
+        size: string;
+        datasetName: string;
+        datasetType: string;
+        rowsJson: string;
+        apiParams: string;
+        typeStatic: string;
+        typeApi: string;
+        noDataset: string;
+        invalidJson: string;
+        save: string;
+        cancel: string;
+        importFailed: string;
+        confirmDeleteChart: string;
+        columns: string;
+        tabData: string;
+        tabStyle: string;
+        tabLayout: string;
+        duplicate: string;
+        paste: string;
+        aggregation: string;
+        aggNone: string;
+        aggSum: string;
+        aggAvg: string;
+        aggCount: string;
+        aggMax: string;
+        aggMin: string;
+        measures: string;
+        sortLabel: string;
+        sortByDim: string;
+        sortByMeasure: string;
+        asc: string;
+        desc: string;
+        topN: string;
+        filters: string;
+        addFilter: string;
+        filterField: string;
+        opEq: string;
+        opNe: string;
+        opGt: string;
+        opGte: string;
+        opLt: string;
+        opLte: string;
+        opContains: string;
+        opIn: string;
+        showLegend: string;
+        showLabel: string;
+        stack: string;
+        dataZoom: string;
+        palette: string;
+        paletteDefault: string;
+        paletteOcean: string;
+        paletteSunset: string;
+        paletteForest: string;
+        paletteMono: string;
+        numberFormat: string;
+        decimals: string;
+        thousand: string;
+        prefix: string;
+        suffix: string;
+        typeNumber: string;
+        typeString: string;
+        typeDate: string;
+        drillPath: string;
+        addDrillLevel: string;
+        linkage: string;
+        linkageTip: string;
+        templates: string;
+        themePreset: string;
+        themeAuto: string;
+    };
+    types: {
+        bar: string;
+        line: string;
+        area: string;
+        pie: string;
+        donut: string;
+        scatter: string;
+        radar: string;
+        gauge: string;
+        pivot: string;
+        graph: string;
+        funnel: string;
+        treemap: string;
+        sunburst: string;
+        sankey: string;
+        heatmap: string;
+    };
+};

package/dist/package/declarations/src/bi-messages.js

@@ -0,0 +1,247 @@
+/**
+ * BI 文案包（纯数据，零依赖）：渲染器只用 common.noData/Loading，
+ * 设计器（designer-vue）消费 designer.* 与 types.*。
+ * 键值取自 go-wind-admin 设计语言口径；改键同步两端包装包。
+ */
+export const BI_MESSAGES_ZH = {
+    common: {
+        noData: "暂无数据",
+        loading: "加载中…",
+        back: "返回上一层",
+        resetDrill: "重置下钻",
+        exportImage: "导出图片",
+        fullscreen: "全屏",
+    },
+    designer: {
+        addChart: "新增图表",
+        addDataset: "新增数据集",
+        undo: "撤销",
+        redo: "重做",
+        compact: "整理布局",
+        import: "导入",
+        exportTemplate: "导出模板",
+        export: "导出",
+        preview: "预览",
+        edit: "编辑",
+        delete: "删除",
+        charts: "图表",
+        datasets: "数据集",
+        property: "属性",
+        selectChart: "点击画布中的图表进行编辑",
+        title: "标题",
+        type: "图型",
+        dataset: "数据集",
+        encoding: "视觉映射",
+        dimension: "维度",
+        measure: "度量",
+        series: "系列拆分",
+        position: "位置 (x / y)",
+        size: "大小 (宽 × 高)",
+        datasetName: "数据集名称",
+        datasetType: "类型",
+        rowsJson: "行数据 (JSON 数组)",
+        apiParams: "API 参数 (JSON)",
+        typeStatic: "静态数据",
+        typeApi: "API 取数",
+        noDataset: "请先创建数据集",
+        invalidJson: "JSON 格式错误",
+        save: "保存",
+        cancel: "取消",
+        importFailed: "导入失败",
+        confirmDeleteChart: "确定删除该图表吗？",
+        columns: "列",
+        tabData: "数据",
+        tabStyle: "样式",
+        tabLayout: "布局",
+        duplicate: "复制",
+        paste: "粘贴",
+        aggregation: "聚合方式",
+        aggNone: "不聚合",
+        aggSum: "求和",
+        aggAvg: "平均",
+        aggCount: "计数",
+        aggMax: "最大",
+        aggMin: "最小",
+        measures: "多度量（宽表）",
+        sortLabel: "排序",
+        sortByDim: "按维度",
+        sortByMeasure: "按度量",
+        asc: "升序",
+        desc: "降序",
+        topN: "取前 N 项",
+        filters: "过滤器",
+        addFilter: "+ 添加条件",
+        filterField: "字段",
+        opEq: "等于",
+        opNe: "不等于",
+        opGt: "大于",
+        opGte: "大于等于",
+        opLt: "小于",
+        opLte: "小于等于",
+        opContains: "包含",
+        opIn: "属于（逗号分隔）",
+        showLegend: "显示图例",
+        showLabel: "数值标签",
+        stack: "堆叠",
+        dataZoom: "数据缩放",
+        palette: "色盘",
+        paletteDefault: "默认",
+        paletteOcean: "海洋",
+        paletteSunset: "夕照",
+        paletteForest: "森林",
+        paletteMono: "墨阶",
+        numberFormat: "数字格式",
+        decimals: "小数位",
+        thousand: "千分位",
+        prefix: "前缀",
+        suffix: "后缀",
+        typeNumber: "数值",
+        typeString: "文本",
+        typeDate: "日期",
+        drillPath: "下钻路径",
+        addDrillLevel: "+ 添加下钻层级",
+        linkage: "跨图联动",
+        linkageTip: "开启后，点击图表以维度值过滤同数据集的其它图表",
+        templates: "模板",
+        themePreset: "仪表盘主题",
+        themeAuto: "跟随宿主亮暗",
+    },
+    types: {
+        bar: "柱状图",
+        line: "折线图",
+        area: "面积图",
+        pie: "饼图",
+        donut: "环形图",
+        scatter: "散点图",
+        radar: "雷达图",
+        gauge: "仪表图",
+        pivot: "透视表",
+        graph: "关系图",
+        funnel: "漏斗图",
+        treemap: "矩形树图",
+        sunburst: "旭日图",
+        sankey: "桑基图",
+        heatmap: "热力图",
+    },
+};
+export const BI_MESSAGES_EN = {
+    common: {
+        noData: "No data",
+        loading: "Loading…",
+        back: "Back",
+        resetDrill: "Reset drill",
+        exportImage: "Export PNG",
+        fullscreen: "Fullscreen",
+    },
+    designer: {
+        addChart: "Add Chart",
+        addDataset: "Add Dataset",
+        undo: "Undo",
+        redo: "Redo",
+        compact: "Tidy Layout",
+        import: "Import",
+        exportTemplate: "Export template",
+        export: "Export",
+        preview: "Preview",
+        edit: "Edit",
+        delete: "Delete",
+        charts: "Charts",
+        datasets: "Datasets",
+        property: "Properties",
+        selectChart: "Click a chart on the canvas to edit",
+        title: "Title",
+        type: "Type",
+        dataset: "Dataset",
+        encoding: "Encoding",
+        dimension: "Dimension",
+        measure: "Measure",
+        series: "Series",
+        position: "Position (x / y)",
+        size: "Size (W × H)",
+        datasetName: "Dataset name",
+        datasetType: "Type",
+        rowsJson: "Rows (JSON array)",
+        apiParams: "API params (JSON)",
+        typeStatic: "Static",
+        typeApi: "API",
+        noDataset: "Create a dataset first",
+        invalidJson: "Invalid JSON",
+        save: "Save",
+        cancel: "Cancel",
+        importFailed: "Import failed",
+        confirmDeleteChart: "Delete this chart?",
+        columns: "columns",
+        tabData: "Data",
+        tabStyle: "Style",
+        tabLayout: "Layout",
+        duplicate: "Duplicate",
+        paste: "Paste",
+        aggregation: "Aggregation",
+        aggNone: "None",
+        aggSum: "Sum",
+        aggAvg: "Average",
+        aggCount: "Count",
+        aggMax: "Max",
+        aggMin: "Min",
+        measures: "Multi-measure (wide)",
+        sortLabel: "Sort",
+        sortByDim: "By dimension",
+        sortByMeasure: "By measure",
+        asc: "Ascending",
+        desc: "Descending",
+        topN: "Top N",
+        filters: "Filters",
+        addFilter: "+ Add condition",
+        filterField: "Field",
+        opEq: "equals",
+        opNe: "not equals",
+        opGt: "greater than",
+        opGte: "≥",
+        opLt: "less than",
+        opLte: "≤",
+        opContains: "contains",
+        opIn: "in (comma separated)",
+        showLegend: "Show legend",
+        showLabel: "Data labels",
+        stack: "Stack",
+        dataZoom: "Data zoom",
+        palette: "Palette",
+        paletteDefault: "Default",
+        paletteOcean: "Ocean",
+        paletteSunset: "Sunset",
+        paletteForest: "Forest",
+        paletteMono: "Mono",
+        numberFormat: "Number format",
+        decimals: "Decimals",
+        thousand: "Thousands separator",
+        prefix: "Prefix",
+        suffix: "Suffix",
+        typeNumber: "Number",
+        typeString: "Text",
+        typeDate: "Date",
+        drillPath: "Drill path",
+        addDrillLevel: "+ Add drill level",
+        linkage: "Cross-filter",
+        linkageTip: "Clicking a chart filters sibling charts on the same dataset",
+        templates: "Templates",
+        themePreset: "Dashboard theme",
+        themeAuto: "Follow host",
+    },
+    types: {
+        bar: "Bar",
+        line: "Line",
+        area: "Area",
+        pie: "Pie",
+        donut: "Donut",
+        scatter: "Scatter",
+        radar: "Radar",
+        gauge: "Gauge",
+        pivot: "Pivot table",
+        graph: "Graph",
+        funnel: "Funnel",
+        treemap: "Treemap",
+        sunburst: "Sunburst",
+        sankey: "Sankey",
+        heatmap: "Heatmap",
+    },
+};

package/dist/package/declarations/src/bi-response.d.ts

@@ -0,0 +1,10 @@
+import type { BiCard, BiWorkbench } from "./rpc/bi/admin/v1/bi_card";
+import type { BiQueryResult, BiQuerySpec } from "./rpc/bi/admin/v1/bi_query";
+/** 补齐 HTTP JSON 省略的查询集合字段，保留服务端返回的过滤、排序与时间范围。 */
+export declare function normalizeBiQuerySpec(query: BiQuerySpec): BiQuerySpec;
+/** 将无数据查询的省略字段统一为可渲染的空结果。 */
+export declare function normalizeBiQueryResult(result: BiQueryResult): BiQueryResult;
+/** 在卡片 API 边界补齐查询配置，页面不再重复处理缺省集合。 */
+export declare function normalizeBiCard(card: BiCard): BiCard;
+/** 新账号和清空后的工作台使用相同的空集合结构。 */
+export declare function normalizeBiWorkbench(workbench: BiWorkbench): BiWorkbench;

package/dist/package/declarations/src/bi-response.js

@@ -0,0 +1,33 @@
+/** 补齐 HTTP JSON 省略的查询集合字段，保留服务端返回的过滤、排序与时间范围。 */
+export function normalizeBiQuerySpec(query) {
+    return {
+        ...query,
+        dimensions: query.dimensions ?? [],
+        measures: query.measures ?? [],
+        filters: (query.filters ?? []).map(filter => ({ ...filter, values: filter.values ?? [] })),
+        orders: query.orders ?? []
+    };
+}
+/** 将无数据查询的省略字段统一为可渲染的空结果。 */
+export function normalizeBiQueryResult(result) {
+    return {
+        ...result,
+        columns: result.columns ?? [],
+        rows: (result.rows ?? []).map(row => ({ values: row.values ?? [] })),
+        truncated: result.truncated ?? false,
+        elapsed_ms: result.elapsed_ms ?? 0,
+        query_record_id: result.query_record_id ?? 0
+    };
+}
+/** 在卡片 API 边界补齐查询配置，页面不再重复处理缺省集合。 */
+export function normalizeBiCard(card) {
+    return { ...card, query: card.query ? normalizeBiQuerySpec(card.query) : undefined };
+}
+/** 新账号和清空后的工作台使用相同的空集合结构。 */
+export function normalizeBiWorkbench(workbench) {
+    return {
+        dashboard_ids: workbench.dashboard_ids ?? [],
+        favorite_ids: workbench.favorite_ids ?? [],
+        dashboards: workbench.dashboards ?? []
+    };
+}

package/dist/package/declarations/src/bi-vue.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Vue 3 BI 仪表盘：BiDashboard 只读渲染器 + BiDesigner 画布设计器。
+ * 数据查询与卡片配置由服务端提供，设计器仅调整卡片布局。
+ */
+import "./styles.scss";
+export { default as BiDashboard } from "./components/BiDashboard.vue";
+export { default as BiDesigner } from "./components/BiDesigner.vue";
+export { default as BiChart } from "./components/BiChart.vue";
+export { provideBiEnv, useBiEnv, useBiTheme, useBiI18n } from "./env";
+export type { BiEnv } from "./env";

package/dist/package/declarations/src/bi-vue.js

@@ -0,0 +1,10 @@
+/**
+ * Vue 3 BI 仪表盘：BiDashboard 只读渲染器 + BiDesigner 画布设计器。
+ * 数据查询与卡片配置由服务端提供，设计器仅调整卡片布局。
+ */
+import "./styles.scss";
+export { default as BiDashboard } from "./components/BiDashboard.vue";
+export { default as BiDesigner } from "./components/BiDesigner.vue";
+export { default as BiChart } from "./components/BiChart.vue";
+// 环境注入（主题跟随 / resolvers / 项目 i18n）
+export { provideBiEnv, useBiEnv, useBiTheme, useBiI18n } from "./env";

package/dist/package/declarations/src/card-schema.d.ts

@@ -0,0 +1,30 @@
+import type { BiDashboard } from "./rpc/bi/admin/v1/bi_dashboard";
+import type { BiChartEncoding, BiChartStyle, BiChartSchema, BiRow } from "./schema/types";
+import type { BiCard } from "./rpc/bi/admin/v1/bi_card";
+import type { BiQueryResult, BiSourceDescriptor } from "./rpc/bi/admin/v1/bi_query";
+/** 将卡片查询结果映射到现有图表引擎，保留分组及全部所选指标。 */
+export declare function buildCardChart(card: BiCard, result: BiQueryResult): {
+    chart: BiChartSchema;
+    rows: BiRow[];
+    metrics: Array<{
+        code: string;
+        name: string;
+        value: string;
+    }>;
+    metricOnly: boolean;
+};
+/** 数据卡片统一保存字段映射与受控样式。 */
+export interface CardChartConfig {
+    encoding: BiChartEncoding;
+    style: Pick<BiChartStyle, "showLabel" | "showLegend" | "stack" | "dataZoom" | "palette">;
+}
+/** 从服务端配置读取图表字段，预览卡片允许使用默认映射。 */
+export declare function parseCardChart(card: Pick<BiCard, "chart_json">): CardChartConfig;
+/** 仅在卡片明确指定时间字段或只有一个可过滤日期分组时开放周期切换。 */
+export declare function supportsCardPeriod(card: BiCard, source?: BiSourceDescriptor): boolean;
+/** 计算刷新等待时间，86400对应浏览器本地时区的下一次02:00。 */
+export declare function cardRefreshDelay(seconds: number, now?: Date): number;
+/** 按当前四种界面语言的分组习惯显示数字字符串，不转换浮点数或丢弃小数位。 */
+export declare function formatCardMetric(value: string): string;
+/** 保持工作台入口顺序，忽略已删除或撤销权限的仪表盘。 */
+export declare function orderWorkbenchDashboards(ids: number[], dashboards: BiDashboard[]): BiDashboard[];

package/dist/package/declarations/src/card-schema.js

@@ -0,0 +1,87 @@
+/** 将卡片查询结果映射到现有图表引擎，保留分组及全部所选指标。 */
+export function buildCardChart(card, result) {
+    const config = parseCardChart(card);
+    const numericFields = result.columns.filter(column => column.type === "number");
+    const measure = config.encoding.measure ||
+        (card.chart_type === "scatter" ? numericFields[1]?.code : undefined) ||
+        card.query?.measures[0]?.code ||
+        result.columns.find(column => column.type === "number")?.code ||
+        result.columns[0]?.code ||
+        "";
+    const dimension = config.encoding.dimension ||
+        (card.chart_type === "scatter" ? numericFields[0]?.code : undefined) ||
+        (card.query ? card.query.dimensions[0] : result.columns.find(column => column.code !== measure)?.code);
+    const rows = result.rows.map(row => Object.fromEntries(result.columns.map((column, index) => [column.code, row.values[index] ?? ""])));
+    const measures = config.encoding.measures?.length
+        ? config.encoding.measures
+        : card.query?.measures.length
+            ? card.query.measures.map(item => item.code)
+            : [measure];
+    return {
+        chart: {
+            id: `card_${card.id}`,
+            datasetId: `card_${card.id}`,
+            type: card.chart_type,
+            encoding: {
+                dimension,
+                measure,
+                measures: ["bar", "line", "area"].includes(card.chart_type) && measures.length > 1 ? measures : undefined,
+                series: card.chart_type === "scatter" ? undefined : card.query?.dimensions[1],
+                ...config.encoding
+            },
+            aggregation: "none",
+            style: {
+                showLabel: false,
+                showLegend: measures.length > 1 || card.chart_type === "pie" || card.chart_type === "donut",
+                ...config.style
+            }
+        },
+        rows,
+        metrics: measures.map(code => ({
+            code,
+            name: result.columns.find(column => column.code === code)?.name || code,
+            value: String(rows[0]?.[code] ?? "—")
+        })),
+        metricOnly: card.chart_type === "metric"
+    };
+}
+/** 从服务端配置读取图表字段，预览卡片允许使用默认映射。 */
+export function parseCardChart(card) {
+    return card.chart_json
+        ? JSON.parse(card.chart_json)
+        : { encoding: {}, style: { showLegend: true, showLabel: false } };
+}
+/** 仅在卡片明确指定时间字段或只有一个可过滤日期分组时开放周期切换。 */
+export function supportsCardPeriod(card, source) {
+    const fields = source?.dimensions.filter(dimension => dimension.type === "date" &&
+        dimension.filterable &&
+        (card.query?.time_range
+            ? dimension.code === card.query.time_range.field
+            : card.query?.dimensions.includes(dimension.code))) ?? [];
+    return fields.length === 1;
+}
+/** 计算刷新等待时间，86400对应浏览器本地时区的下一次02:00。 */
+export function cardRefreshDelay(seconds, now = new Date()) {
+    if (seconds !== 86400)
+        return seconds * 1000;
+    const next = new Date(now.getTime());
+    next.setHours(2, 0, 0, 0);
+    if (next.getTime() <= now.getTime())
+        next.setDate(next.getDate() + 1);
+    return next.getTime() - now.getTime();
+}
+/** 按当前四种界面语言的分组习惯显示数字字符串，不转换浮点数或丢弃小数位。 */
+export function formatCardMetric(value) {
+    if (!/^[+-]?\d+(?:\.\d+)?$/.test(value))
+        return value;
+    const [integer, fraction] = value.split(".");
+    return integer.replace(/\B(?=(\d{3})+(?!\d))/g, ",") + (fraction === undefined ? "" : "." + fraction);
+}
+/** 保持工作台入口顺序，忽略已删除或撤销权限的仪表盘。 */
+export function orderWorkbenchDashboards(ids, dashboards) {
+    const byID = new Map(dashboards.map(item => [item.id, item]));
+    return ids.flatMap(id => {
+        const item = byID.get(id);
+        return item ? [item] : [];
+    });
+}