@liuhange/dsh-data-visualization 2.0.0

package/README.md

@@ -0,0 +1,37 @@
+# @liuhange/dsh-data-visualization
+
+可视化报表插件：生成自包含 HTML 报表，含脱敏统计、清洗对比、资产分布、质量评分、血缘追踪五种交互式图表。
+
+## Tool 接口
+
+### `generate_visualization`
+
+读取各插件 JSON 报告，生成自包含 HTML 可视化报表。
+
+**参数：**
+- `reportPaths` (string, 必填): JSON 格式的报告路径对象 `{masking, cleaning, inventory, quality, lineage}`
+- `outputPath` (string, 必填): HTML 报表输出路径
+
+**输出：**
+- `visualization_report.html`: 自包含 HTML 报表（断网可独立打开）
+
+## 图表类型
+
+| 图表 | 说明 | 数据来源 |
+|------|------|---------|
+| 柱状图 | 脱敏各字段统计 | 脱敏报告 JSON |
+| 对比图 | 清洗前后数据量对比 | 清洗报告 JSON |
+| 饼图 | 数据资产分类分布 | 盘点报告 JSON |
+| 雷达图 | 质量评分多维度展示 | 质量评分 JSON |
+| 流程图 | 血缘追踪可视化 | 血缘 JSON |
+
+## 配置节点
+
+`business-rules.json` → `visualization` 节点。缺失时使用默认模板（2列网格、默认配色、交互全启用）。
+
+## 特性
+
+- 自包含 HTML：所有 CSS/JS 内联，无外部依赖，断网可打开
+- 交互式：支持展开/折叠详情、切换图表类型
+- 容错：部分 JSON 缺失时对应图表显示占位符，其他图表正常
+- 配置化：图表配置/布局/配色从配置文件读取

package/lib/types/chartRenderers/barChartRenderer.d.ts

@@ -0,0 +1,8 @@
+import type { ChartRenderResult } from '../types.js';
+import type { VisualizationConfig } from '@liuhange/dsh-data-asset-shared';
+export declare class BarChartRenderer {
+    render(data: unknown, config: VisualizationConfig): ChartRenderResult;
+    private extractCounts;
+    private placeholder;
+}
+//# sourceMappingURL=barChartRenderer.d.ts.map

package/lib/types/chartRenderers/comparisonChartRenderer.d.ts

@@ -0,0 +1,8 @@
+import type { ChartRenderResult } from '../types.js';
+import type { VisualizationConfig } from '@liuhange/dsh-data-asset-shared';
+export declare class ComparisonChartRenderer {
+    render(data: unknown, config: VisualizationConfig): ChartRenderResult;
+    private extractData;
+    private placeholder;
+}
+//# sourceMappingURL=comparisonChartRenderer.d.ts.map

package/lib/types/chartRenderers/flowchartRenderer.d.ts

@@ -0,0 +1,8 @@
+import type { ChartRenderResult } from '../types.js';
+import type { VisualizationConfig } from '@liuhange/dsh-data-asset-shared';
+export declare class FlowchartRenderer {
+    render(data: unknown, config: VisualizationConfig): ChartRenderResult;
+    private extractData;
+    private placeholder;
+}
+//# sourceMappingURL=flowchartRenderer.d.ts.map

package/lib/types/chartRenderers/pieChartRenderer.d.ts

@@ -0,0 +1,8 @@
+import type { ChartRenderResult } from '../types.js';
+import type { VisualizationConfig } from '@liuhange/dsh-data-asset-shared';
+export declare class PieChartRenderer {
+    render(data: unknown, config: VisualizationConfig): ChartRenderResult;
+    private extractData;
+    private placeholder;
+}
+//# sourceMappingURL=pieChartRenderer.d.ts.map

package/lib/types/chartRenderers/radarChartRenderer.d.ts

@@ -0,0 +1,8 @@
+import type { ChartRenderResult } from '../types.js';
+import type { VisualizationConfig } from '@liuhange/dsh-data-asset-shared';
+export declare class RadarChartRenderer {
+    render(data: unknown, config: VisualizationConfig): ChartRenderResult;
+    private extractData;
+    private placeholder;
+}
+//# sourceMappingURL=radarChartRenderer.d.ts.map

package/lib/types/defaultVisualizationConfig.d.ts

@@ -0,0 +1,3 @@
+import type { VisualizationConfig } from '@liuhange/dsh-data-asset-shared';
+export declare const defaultVisualizationConfig: VisualizationConfig;
+//# sourceMappingURL=defaultVisualizationConfig.d.ts.map

package/lib/types/htmlAssembler.d.ts

@@ -0,0 +1,12 @@
+import type { VisualizationConfig } from '@liuhange/dsh-data-asset-shared';
+import type { ChartRenderResult } from './types.js';
+export interface HtmlAssembleInput {
+    charts: ChartRenderResult[];
+    config: VisualizationConfig;
+    reportData: Record<string, unknown>;
+}
+export declare class HtmlAssembler {
+    private interactionScript;
+    assemble(input: HtmlAssembleInput): string;
+}
+//# sourceMappingURL=htmlAssembler.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "data-visualization";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/interactionScript.d.ts

@@ -0,0 +1,5 @@
+import type { VisualizationConfig } from '@liuhange/dsh-data-asset-shared';
+export declare class InteractionScript {
+    generate(interactions: VisualizationConfig['interactions']): string;
+}
+//# sourceMappingURL=interactionScript.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,3 @@
+export declare const invariant = "data-visualization";
+export declare function install(): void;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/reportDataLoader.d.ts

@@ -0,0 +1,5 @@
+import type { ReportDataLoadResult } from './types.js';
+export declare class ReportDataLoader {
+    load(filePath: string): Promise<ReportDataLoadResult>;
+}
+//# sourceMappingURL=reportDataLoader.d.ts.map

package/lib/types/templateLoader.d.ts

@@ -0,0 +1,5 @@
+import type { VisualizationConfig } from '@liuhange/dsh-data-asset-shared';
+export declare class TemplateLoader {
+    load(config: VisualizationConfig | undefined): VisualizationConfig;
+}
+//# sourceMappingURL=templateLoader.d.ts.map

package/lib/types/types.d.ts

@@ -0,0 +1,30 @@
+export type ChartType = 'bar' | 'comparison' | 'pie' | 'radar' | 'flowchart';
+export interface GenerateVisualizationParams {
+    reportPaths: {
+        masking?: string;
+        cleaning?: string;
+        inventory?: string;
+        quality?: string;
+        lineage?: string;
+    };
+    outputPath: string;
+}
+export interface ChartRenderResult {
+    type: ChartType;
+    title: string;
+    svgContent: string;
+    dataAvailable: boolean;
+    errorMessage?: string;
+}
+export interface GenerateVisualizationResult {
+    htmlPath: string;
+    chartCount: number;
+    chartsRendered: string[];
+    status: 'SUCCESS' | 'FAILED';
+    configStatus: string;
+}
+export interface ReportDataLoadResult {
+    data: unknown;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/package.json

@@ -0,0 +1,39 @@
+{
+    "name":  "@liuhange/dsh-data-visualization",
+    "description":  "Data visualization plugin: generate self-contained HTML reports with interactive charts (bar/comparison/pie/radar/flowchart)",
+    "version":  "2.0.0",
+    "publishConfig":  {
+                          "access":  "public"
+                      },
+    "repository":  {
+                       "type":  "git",
+                       "url":  "git+https://github.com/liuhange789/data-asset-inspector.git",
+                       "directory":  "packages/data-asset/data-visualization"
+                   },
+    "type":  "module",
+    "main":  "lib/index.js",
+    "types":  "lib/types/index.d.ts",
+    "exports":  {
+                    ".":  {
+                              "types":  "./lib/types/index.d.ts",
+                              "default":  "./lib/index.js"
+                          },
+                    "./invariant":  {
+                                        "types":  "./lib/types/invariant.d.ts",
+                                        "default":  "./lib/invariant.js"
+                                    },
+                    "./src/*":  "./src/*",
+                    "./package.json":  "./package.json"
+                },
+    "files":  [
+                  "lib/index.js",
+                  "lib/invariant.js",
+                  "lib/types/**/*.d.ts"
+              ],
+    "license":  "MIT",
+    "peerDependencies":  {
+                             "@deepseek-ai/cordis":  "^0.1.0",
+                             "@deepseek-ai/dsh-tools":  "^0.1.0",
+                             "@liuhange/dsh-data-asset-shared":  "^2.0.0"
+                         }
+}