spectra-cli 4.1.1

package/dist/panoramic/exporters/html-exporter.d.ts

@@ -0,0 +1,83 @@
+/**
+ * HTML 交互式可视化导出器
+ * 纯函数管道：GraphJSON + CommunityResult + GodNode[] → 单文件 HTML
+ *
+ * 遵循 Graphify 纯函数管道设计模式：无类封装，无实例状态
+ * FR 追踪: FR-006 ~ FR-012、FR-016 ~ FR-018
+ */
+import type { GraphJSON } from '../graph/graph-types.js';
+import type { CommunityResult } from '../community/community-detector.js';
+import type { GodNode } from '../community/god-node-analyzer.js';
+import type { ExportResult } from './export-types.js';
+/**
+ * 按社区 ID 均匀分布色相，返回 HSL 颜色字符串
+ *
+ * @param communityId - 社区 ID（从 0 开始）
+ * @param totalCommunities - 社区总数
+ * @returns HSL 格式颜色字符串，如 "hsl(120, 65%, 55%)"
+ */
+export declare function communityColor(communityId: number, totalCommunities: number): string;
+/**
+ * 按度数对数缩放计算节点半径
+ * 范围：[4, 20] px；度数为 0 时取最小值 4
+ *
+ * @param degree - 节点度数（非负整数）
+ * @returns 节点半径（px）
+ */
+export declare function nodeRadius(degree: number): number;
+/**
+ * 按置信度分数线性映射边透明度
+ * 范围：[0.1, 0.8]
+ *
+ * @param confidenceScore - 置信度分数 [0.0, 1.0]
+ * @returns 透明度值 [0.1, 0.8]
+ */
+export declare function edgeOpacity(confidenceScore: number): number;
+/**
+ * 计算预计算网格布局坐标（节点数 > 5000 时使用）
+ *
+ * 公式：列数 = Math.ceil(Math.sqrt(n))，节点间距 GRID_SPACING px
+ *
+ * @param nodeIds - 节点 ID 数组
+ * @returns 节点 ID → {x, y} 坐标映射
+ */
+export declare function computeGridLayout(nodeIds: string[]): Map<string, {
+    x: number;
+    y: number;
+}>;
+/**
+ * 将图谱数据序列化为嵌入 HTML 的 JSON 字符串（纯函数）
+ *
+ * 处理逻辑：
+ * - 节点附加 color、radius、communityId、isGodNode
+ * - 悬空边（source 或 target 不在节点集）静默跳过（FR-017）
+ * - 节点数 > 5000 时调用 computeGridLayout 注入 fx/fy（FR-012）
+ *
+ * @param graphJson - GraphJSON 图谱数据
+ * @param communityResult - 社区检测结果
+ * @param godNodes - God Node 列表
+ * @returns JSON.stringify 后的字符串
+ */
+export declare function buildGraphData(graphJson: GraphJSON, communityResult: CommunityResult, godNodes: GodNode[]): string;
+/**
+ * 生成单文件 HTML（纯函数，不写盘）
+ * 返回完整 HTML 字符串，内嵌 d3-force bundle + 图谱数据 + CSS + JS
+ *
+ * @param graphJson - GraphJSON 图谱数据
+ * @param communityResult - 社区检测结果
+ * @param godNodes - God Node 列表
+ * @returns 完整 HTML 字符串
+ */
+export declare function generateHtml(graphJson: GraphJSON, communityResult: CommunityResult, godNodes: GodNode[]): string;
+/**
+ * HTML 导出写盘入口
+ * 纯函数管道：graphJson + communityResult + godNodes → 单文件 HTML
+ *
+ * @param graphJson - GraphJSON 图谱数据
+ * @param communityResult - 社区检测结果
+ * @param godNodes - God Node 列表
+ * @param outputDir - 输出目录（绝对路径或相对路径）
+ * @returns ExportResult（文件路径列表、数量、耗时）
+ */
+export declare function generateHtmlExport(graphJson: GraphJSON, communityResult: CommunityResult, godNodes: GodNode[], outputDir: string): ExportResult;
+//# sourceMappingURL=html-exporter.d.ts.map

package/dist/panoramic/exporters/html-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-exporter.d.ts","sourceRoot":"","sources":["../../../src/panoramic/exporters/html-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAiBtD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAMpF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAK3D;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAe1F;AAyCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,OAAO,EAAE,GAClB,MAAM,CAmFR;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,OAAO,EAAE,GAClB,MAAM,CAQR;AAMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,GAChB,YAAY,CAgBd"}

package/dist/panoramic/exporters/html-exporter.js

@@ -0,0 +1,224 @@
+/**
+ * HTML 交互式可视化导出器
+ * 纯函数管道：GraphJSON + CommunityResult + GodNode[] → 单文件 HTML
+ *
+ * 遵循 Graphify 纯函数管道设计模式：无类封装，无实例状态
+ * FR 追踪: FR-006 ~ FR-012、FR-016 ~ FR-018
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { buildHtmlTemplate } from './html-template.js';
+// ============================================================
+// 常量定义
+// ============================================================
+/** 大图阈值：节点数超过此值时启用预计算网格布局，跳过 d3-force 仿真 */
+const LARGE_GRAPH_THRESHOLD = 5_000;
+/** 网格布局节点间距（px） */
+const GRID_SPACING = 60;
+// ============================================================
+// 视觉映射函数 — FR-007
+// ============================================================
+/**
+ * 按社区 ID 均匀分布色相，返回 HSL 颜色字符串
+ *
+ * @param communityId - 社区 ID（从 0 开始）
+ * @param totalCommunities - 社区总数
+ * @returns HSL 格式颜色字符串，如 "hsl(120, 65%, 55%)"
+ */
+export function communityColor(communityId, totalCommunities) {
+    // 避免除以 0；单个社区时固定色相
+    const hue = totalCommunities > 0
+        ? Math.round((communityId / totalCommunities) * 360) % 360
+        : 0;
+    return `hsl(${hue}, 65%, 55%)`;
+}
+/**
+ * 按度数对数缩放计算节点半径
+ * 范围：[4, 20] px；度数为 0 时取最小值 4
+ *
+ * @param degree - 节点度数（非负整数）
+ * @returns 节点半径（px）
+ */
+export function nodeRadius(degree) {
+    const MIN = 4;
+    const MAX = 20;
+    if (degree <= 0)
+        return MIN;
+    // Math.log1p(degree) 对数缩放：degree=1→ln(2)≈0.69，degree=100→ln(101)≈4.62
+    // 用常用图谱的 degree 上限（约 degree=1000）来标准化到 [MIN, MAX]
+    const normalized = Math.log1p(degree) / Math.log1p(1000);
+    return Math.min(MAX, Math.round(MIN + normalized * (MAX - MIN)));
+}
+/**
+ * 按置信度分数线性映射边透明度
+ * 范围：[0.1, 0.8]
+ *
+ * @param confidenceScore - 置信度分数 [0.0, 1.0]
+ * @returns 透明度值 [0.1, 0.8]
+ */
+export function edgeOpacity(confidenceScore) {
+    const MIN = 0.1;
+    const MAX = 0.8;
+    const clamped = Math.max(0, Math.min(1, confidenceScore));
+    return MIN + clamped * (MAX - MIN);
+}
+// ============================================================
+// 大图网格布局 — FR-012
+// ============================================================
+/**
+ * 计算预计算网格布局坐标（节点数 > 5000 时使用）
+ *
+ * 公式：列数 = Math.ceil(Math.sqrt(n))，节点间距 GRID_SPACING px
+ *
+ * @param nodeIds - 节点 ID 数组
+ * @returns 节点 ID → {x, y} 坐标映射
+ */
+export function computeGridLayout(nodeIds) {
+    const n = nodeIds.length;
+    const layout = new Map();
+    if (n === 0)
+        return layout;
+    const cols = Math.ceil(Math.sqrt(n));
+    for (let i = 0; i < n; i++) {
+        const id = nodeIds[i];
+        const col = i % cols;
+        const row = Math.floor(i / cols);
+        layout.set(id, { x: col * GRID_SPACING, y: row * GRID_SPACING });
+    }
+    return layout;
+}
+/**
+ * 将图谱数据序列化为嵌入 HTML 的 JSON 字符串（纯函数）
+ *
+ * 处理逻辑：
+ * - 节点附加 color、radius、communityId、isGodNode
+ * - 悬空边（source 或 target 不在节点集）静默跳过（FR-017）
+ * - 节点数 > 5000 时调用 computeGridLayout 注入 fx/fy（FR-012）
+ *
+ * @param graphJson - GraphJSON 图谱数据
+ * @param communityResult - 社区检测结果
+ * @param godNodes - God Node 列表
+ * @returns JSON.stringify 后的字符串
+ */
+export function buildGraphData(graphJson, communityResult, godNodes) {
+    const { nodes, links } = graphJson;
+    const { nodeCommunityMap, communities } = communityResult;
+    const totalCommunities = communities.length;
+    // 构建节点 ID 集合（用于悬空边过滤）
+    const nodeIdSet = new Set(nodes.map((n) => n.id));
+    // 构建 God Node ID 集合
+    const godNodeIdSet = new Set(godNodes.map((g) => g.id));
+    // 计算每个节点的度数（从边列表统计，仅计算非悬空边）
+    const degreeMap = new Map();
+    for (const edge of links) {
+        if (!nodeIdSet.has(edge.source) || !nodeIdSet.has(edge.target))
+            continue;
+        degreeMap.set(edge.source, (degreeMap.get(edge.source) ?? 0) + 1);
+        degreeMap.set(edge.target, (degreeMap.get(edge.target) ?? 0) + 1);
+    }
+    // 大图降级：预计算网格布局（FR-012）
+    const isLargeGraph = nodes.length > LARGE_GRAPH_THRESHOLD;
+    const gridLayout = isLargeGraph
+        ? computeGridLayout(nodes.map((n) => n.id))
+        : undefined;
+    // 构建 HTML 节点数组
+    const htmlNodes = nodes.map((node) => {
+        const communityId = nodeCommunityMap.get(node.id) ?? -1;
+        const degree = degreeMap.get(node.id) ?? 0;
+        const color = communityId >= 0
+            ? communityColor(communityId, totalCommunities)
+            : 'hsl(0, 0%, 50%)'; // 未分类节点：灰色
+        const htmlNode = {
+            id: node.id,
+            label: node.label,
+            kind: node.kind,
+            color,
+            radius: nodeRadius(degree),
+            communityId,
+            degree,
+            isGodNode: godNodeIdSet.has(node.id),
+        };
+        // 注入预计算坐标（仅大图）
+        if (gridLayout) {
+            const pos = gridLayout.get(node.id);
+            if (pos) {
+                htmlNode.fx = pos.x;
+                htmlNode.fy = pos.y;
+            }
+        }
+        return htmlNode;
+    });
+    // 构建 HTML 边数组（跳过悬空边 FR-017）
+    const htmlLinks = [];
+    for (const edge of links) {
+        if (!nodeIdSet.has(edge.source) || !nodeIdSet.has(edge.target)) {
+            // 悬空边静默跳过
+            continue;
+        }
+        htmlLinks.push({
+            source: edge.source,
+            target: edge.target,
+            relation: edge.relation,
+            opacity: edgeOpacity(edge.confidenceScore),
+        });
+    }
+    // 构建社区图例数据
+    const htmlCommunities = communities.map((c) => ({
+        id: c.id,
+        color: communityColor(c.id, totalCommunities),
+        nodeCount: c.nodes.length,
+    }));
+    return JSON.stringify({
+        nodes: htmlNodes,
+        links: htmlLinks,
+        communities: htmlCommunities,
+    });
+}
+// ============================================================
+// HTML 生成 — FR-006、FR-007 ~ FR-012、FR-018
+// ============================================================
+/**
+ * 生成单文件 HTML（纯函数，不写盘）
+ * 返回完整 HTML 字符串，内嵌 d3-force bundle + 图谱数据 + CSS + JS
+ *
+ * @param graphJson - GraphJSON 图谱数据
+ * @param communityResult - 社区检测结果
+ * @param godNodes - God Node 列表
+ * @returns 完整 HTML 字符串
+ */
+export function generateHtml(graphJson, communityResult, godNodes) {
+    const graphDataJson = buildGraphData(graphJson, communityResult, godNodes);
+    // Feature 140 T19：透传 nodeCount，让 export 入口在极小图（< 3 节点）时也能注入说明 banner，
+    // 与 batch-orchestrator 入口行为一致（修复 Codex review W3 — 入口分叉一致性）。
+    return buildHtmlTemplate(graphDataJson, {
+        forceLayoutThreshold: 2000,
+        nodeCount: graphJson.nodes.length,
+    });
+}
+// ============================================================
+// 写盘入口 — FR-006、FR-016
+// ============================================================
+/**
+ * HTML 导出写盘入口
+ * 纯函数管道：graphJson + communityResult + godNodes → 单文件 HTML
+ *
+ * @param graphJson - GraphJSON 图谱数据
+ * @param communityResult - 社区检测结果
+ * @param godNodes - God Node 列表
+ * @param outputDir - 输出目录（绝对路径或相对路径）
+ * @returns ExportResult（文件路径列表、数量、耗时）
+ */
+export function generateHtmlExport(graphJson, communityResult, godNodes, outputDir) {
+    const startTime = Date.now();
+    const html = generateHtml(graphJson, communityResult, godNodes);
+    // 确保输出目录存在
+    fs.mkdirSync(outputDir, { recursive: true });
+    const outputPath = path.resolve(outputDir, 'graph.html');
+    fs.writeFileSync(outputPath, html, 'utf-8');
+    return {
+        files: [outputPath],
+        fileCount: 1,
+        durationMs: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=html-exporter.js.map

package/dist/panoramic/exporters/html-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-exporter.js","sourceRoot":"","sources":["../../../src/panoramic/exporters/html-exporter.ts"],"names":[],"mappings":"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"}

package/dist/panoramic/exporters/html-template.d.ts

@@ -0,0 +1,32 @@
+/**
+ * HTML 模板 + 内联 d3-force bundle
+ * D3_FORCE_BUNDLE 由构建脚本 scripts/inline-d3.ts 在构建期自动写入
+ * 请勿手动编辑 D3_FORCE_BUNDLE 常量（会被下次构建覆盖）
+ *
+ * d3-force 版本: 3.0.0
+ */
+export declare const D3_FORCE_BUNDLE = "// https://d3js.org/d3-force/ v3.0.0 Copyright 2010-2021 Mike Bostock\n!function(n,t){\"object\"==typeof exports&&\"undefined\"!=typeof module?t(exports,require(\"d3-quadtree\"),require(\"d3-dispatch\"),require(\"d3-timer\")):\"function\"==typeof define&&define.amd?define([\"exports\",\"d3-quadtree\",\"d3-dispatch\",\"d3-timer\"],t):t((n=\"undefined\"!=typeof globalThis?globalThis:n||self).d3=n.d3||{},n.d3,n.d3,n.d3)}(this,(function(n,t,e,r){\"use strict\";function i(n){return function(){return n}}function u(n){return 1e-6*(n()-.5)}function o(n){return n.x+n.vx}function f(n){return n.y+n.vy}function a(n){return n.index}function c(n,t){var e=n.get(t);if(!e)throw new Error(\"node not found: \"+t);return e}const l=4294967296;function h(n){return n.x}function v(n){return n.y}var y=Math.PI*(3-Math.sqrt(5));n.forceCenter=function(n,t){var e,r=1;function i(){var i,u,o=e.length,f=0,a=0;for(i=0;i<o;++i)f+=(u=e[i]).x,a+=u.y;for(f=(f/o-n)*r,a=(a/o-t)*r,i=0;i<o;++i)(u=e[i]).x-=f,u.y-=a}return null==n&&(n=0),null==t&&(t=0),i.initialize=function(n){e=n},i.x=function(t){return arguments.length?(n=+t,i):n},i.y=function(n){return arguments.length?(t=+n,i):t},i.strength=function(n){return arguments.length?(r=+n,i):r},i},n.forceCollide=function(n){var e,r,a,c=1,l=1;function h(){for(var n,i,h,y,d,g,x,s=e.length,p=0;p<l;++p)for(i=t.quadtree(e,o,f).visitAfter(v),n=0;n<s;++n)h=e[n],g=r[h.index],x=g*g,y=h.x+h.vx,d=h.y+h.vy,i.visit(M);function M(n,t,e,r,i){var o=n.data,f=n.r,l=g+f;if(!o)return t>y+l||r<y-l||e>d+l||i<d-l;if(o.index>h.index){var v=y-o.x-o.vx,s=d-o.y-o.vy,p=v*v+s*s;p<l*l&&(0===v&&(p+=(v=u(a))*v),0===s&&(p+=(s=u(a))*s),p=(l-(p=Math.sqrt(p)))/p*c,h.vx+=(v*=p)*(l=(f*=f)/(x+f)),h.vy+=(s*=p)*l,o.vx-=v*(l=1-l),o.vy-=s*l)}}}function v(n){if(n.data)return n.r=r[n.data.index];for(var t=n.r=0;t<4;++t)n[t]&&n[t].r>n.r&&(n.r=n[t].r)}function y(){if(e){var t,i,u=e.length;for(r=new Array(u),t=0;t<u;++t)i=e[t],r[i.index]=+n(i,t,e)}}return\"function\"!=typeof n&&(n=i(null==n?1:+n)),h.initialize=function(n,t){e=n,a=t,y()},h.iterations=function(n){return arguments.length?(l=+n,h):l},h.strength=function(n){return arguments.length?(c=+n,h):c},h.radius=function(t){return arguments.length?(n=\"function\"==typeof t?t:i(+t),y(),h):n},h},n.forceLink=function(n){var t,e,r,o,f,l,h=a,v=function(n){return 1/Math.min(o[n.source.index],o[n.target.index])},y=i(30),d=1;function g(r){for(var i=0,o=n.length;i<d;++i)for(var a,c,h,v,y,g,x,s=0;s<o;++s)c=(a=n[s]).source,v=(h=a.target).x+h.vx-c.x-c.vx||u(l),y=h.y+h.vy-c.y-c.vy||u(l),v*=g=((g=Math.sqrt(v*v+y*y))-e[s])/g*r*t[s],y*=g,h.vx-=v*(x=f[s]),h.vy-=y*x,c.vx+=v*(x=1-x),c.vy+=y*x}function x(){if(r){var i,u,a=r.length,l=n.length,v=new Map(r.map(((n,t)=>[h(n,t,r),n])));for(i=0,o=new Array(a);i<l;++i)(u=n[i]).index=i,\"object\"!=typeof u.source&&(u.source=c(v,u.source)),\"object\"!=typeof u.target&&(u.target=c(v,u.target)),o[u.source.index]=(o[u.source.index]||0)+1,o[u.target.index]=(o[u.target.index]||0)+1;for(i=0,f=new Array(l);i<l;++i)u=n[i],f[i]=o[u.source.index]/(o[u.source.index]+o[u.target.index]);t=new Array(l),s(),e=new Array(l),p()}}function s(){if(r)for(var e=0,i=n.length;e<i;++e)t[e]=+v(n[e],e,n)}function p(){if(r)for(var t=0,i=n.length;t<i;++t)e[t]=+y(n[t],t,n)}return null==n&&(n=[]),g.initialize=function(n,t){r=n,l=t,x()},g.links=function(t){return arguments.length?(n=t,x(),g):n},g.id=function(n){return arguments.length?(h=n,g):h},g.iterations=function(n){return arguments.length?(d=+n,g):d},g.strength=function(n){return arguments.length?(v=\"function\"==typeof n?n:i(+n),s(),g):v},g.distance=function(n){return arguments.length?(y=\"function\"==typeof n?n:i(+n),p(),g):y},g},n.forceManyBody=function(){var n,e,r,o,f,a=i(-30),c=1,l=1/0,y=.81;function d(r){var i,u=n.length,f=t.quadtree(n,h,v).visitAfter(x);for(o=r,i=0;i<u;++i)e=n[i],f.visit(s)}function g(){if(n){var t,e,r=n.length;for(f=new Array(r),t=0;t<r;++t)e=n[t],f[e.index]=+a(e,t,n)}}function x(n){var t,e,r,i,u,o=0,a=0;if(n.length){for(r=i=u=0;u<4;++u)(t=n[u])&&(e=Math.abs(t.value))&&(o+=t.value,a+=e,r+=e*t.x,i+=e*t.y);n.x=r/a,n.y=i/a}else{(t=n).x=t.data.x,t.y=t.data.y;do{o+=f[t.data.index]}while(t=t.next)}n.value=o}function s(n,t,i,a){if(!n.value)return!0;var h=n.x-e.x,v=n.y-e.y,d=a-t,g=h*h+v*v;if(d*d/y<g)return g<l&&(0===h&&(g+=(h=u(r))*h),0===v&&(g+=(v=u(r))*v),g<c&&(g=Math.sqrt(c*g)),e.vx+=h*n.value*o/g,e.vy+=v*n.value*o/g),!0;if(!(n.length||g>=l)){(n.data!==e||n.next)&&(0===h&&(g+=(h=u(r))*h),0===v&&(g+=(v=u(r))*v),g<c&&(g=Math.sqrt(c*g)));do{n.data!==e&&(d=f[n.data.index]*o/g,e.vx+=h*d,e.vy+=v*d)}while(n=n.next)}}return d.initialize=function(t,e){n=t,r=e,g()},d.strength=function(n){return arguments.length?(a=\"function\"==typeof n?n:i(+n),g(),d):a},d.distanceMin=function(n){return arguments.length?(c=n*n,d):Math.sqrt(c)},d.distanceMax=function(n){return arguments.length?(l=n*n,d):Math.sqrt(l)},d.theta=function(n){return arguments.length?(y=n*n,d):Math.sqrt(y)},d},n.forceRadial=function(n,t,e){var r,u,o,f=i(.1);function a(n){for(var i=0,f=r.length;i<f;++i){var a=r[i],c=a.x-t||1e-6,l=a.y-e||1e-6,h=Math.sqrt(c*c+l*l),v=(o[i]-h)*u[i]*n/h;a.vx+=c*v,a.vy+=l*v}}function c(){if(r){var t,e=r.length;for(u=new Array(e),o=new Array(e),t=0;t<e;++t)o[t]=+n(r[t],t,r),u[t]=isNaN(o[t])?0:+f(r[t],t,r)}}return\"function\"!=typeof n&&(n=i(+n)),null==t&&(t=0),null==e&&(e=0),a.initialize=function(n){r=n,c()},a.strength=function(n){return arguments.length?(f=\"function\"==typeof n?n:i(+n),c(),a):f},a.radius=function(t){return arguments.length?(n=\"function\"==typeof t?t:i(+t),c(),a):n},a.x=function(n){return arguments.length?(t=+n,a):t},a.y=function(n){return arguments.length?(e=+n,a):e},a},n.forceSimulation=function(n){var t,i=1,u=.001,o=1-Math.pow(u,1/300),f=0,a=.6,c=new Map,h=r.timer(g),v=e.dispatch(\"tick\",\"end\"),d=function(){let n=1;return()=>(n=(1664525*n+1013904223)%l)/l}();function g(){x(),v.call(\"tick\",t),i<u&&(h.stop(),v.call(\"end\",t))}function x(e){var r,u,l=n.length;void 0===e&&(e=1);for(var h=0;h<e;++h)for(i+=(f-i)*o,c.forEach((function(n){n(i)})),r=0;r<l;++r)null==(u=n[r]).fx?u.x+=u.vx*=a:(u.x=u.fx,u.vx=0),null==u.fy?u.y+=u.vy*=a:(u.y=u.fy,u.vy=0);return t}function s(){for(var t,e=0,r=n.length;e<r;++e){if((t=n[e]).index=e,null!=t.fx&&(t.x=t.fx),null!=t.fy&&(t.y=t.fy),isNaN(t.x)||isNaN(t.y)){var i=10*Math.sqrt(.5+e),u=e*y;t.x=i*Math.cos(u),t.y=i*Math.sin(u)}(isNaN(t.vx)||isNaN(t.vy))&&(t.vx=t.vy=0)}}function p(t){return t.initialize&&t.initialize(n,d),t}return null==n&&(n=[]),s(),t={tick:x,restart:function(){return h.restart(g),t},stop:function(){return h.stop(),t},nodes:function(e){return arguments.length?(n=e,s(),c.forEach(p),t):n},alpha:function(n){return arguments.length?(i=+n,t):i},alphaMin:function(n){return arguments.length?(u=+n,t):u},alphaDecay:function(n){return arguments.length?(o=+n,t):+o},alphaTarget:function(n){return arguments.length?(f=+n,t):f},velocityDecay:function(n){return arguments.length?(a=1-n,t):1-a},randomSource:function(n){return arguments.length?(d=n,c.forEach(p),t):d},force:function(n,e){return arguments.length>1?(null==e?c.delete(n):c.set(n,p(e)),t):c.get(n)},find:function(t,e,r){var i,u,o,f,a,c=0,l=n.length;for(null==r?r=1/0:r*=r,c=0;c<l;++c)(o=(i=t-(f=n[c]).x)*i+(u=e-f.y)*u)<r&&(a=f,r=o);return a},on:function(n,e){return arguments.length>1?(v.on(n,e),t):v.on(n)}}},n.forceX=function(n){var t,e,r,u=i(.1);function o(n){for(var i,u=0,o=t.length;u<o;++u)(i=t[u]).vx+=(r[u]-i.x)*e[u]*n}function f(){if(t){var i,o=t.length;for(e=new Array(o),r=new Array(o),i=0;i<o;++i)e[i]=isNaN(r[i]=+n(t[i],i,t))?0:+u(t[i],i,t)}}return\"function\"!=typeof n&&(n=i(null==n?0:+n)),o.initialize=function(n){t=n,f()},o.strength=function(n){return arguments.length?(u=\"function\"==typeof n?n:i(+n),f(),o):u},o.x=function(t){return arguments.length?(n=\"function\"==typeof t?t:i(+t),f(),o):n},o},n.forceY=function(n){var t,e,r,u=i(.1);function o(n){for(var i,u=0,o=t.length;u<o;++u)(i=t[u]).vy+=(r[u]-i.y)*e[u]*n}function f(){if(t){var i,o=t.length;for(e=new Array(o),r=new Array(o),i=0;i<o;++i)e[i]=isNaN(r[i]=+n(t[i],i,t))?0:+u(t[i],i,t)}}return\"function\"!=typeof n&&(n=i(null==n?0:+n)),o.initialize=function(n){t=n,f()},o.strength=function(n){return arguments.length?(u=\"function\"==typeof n?n:i(+n),f(),o):u},o.y=function(t){return arguments.length?(n=\"function\"==typeof t?t:i(+t),f(),o):n},o},Object.defineProperty(n,\"__esModule\",{value:!0})}));\n";
+import type { GraphHtmlOptions } from '../qa/types.js';
+/**
+ * 构建完整 HTML 模板
+ * 将 d3 bundle、图谱数据 JSON、CSS、交互 JS 组装为单文件字符串
+ *
+ * @param graphDataJson - buildGraphData() 返回的 JSON 字符串（含 hyperedges 字段）
+ * @param options - graph.html 生成配置（可选，未传时行为与旧版等价）
+ * @returns 完整 HTML 字符串（单文件，包含所有内联资源，零外部 CDN 引用）
+ */
+export declare function buildHtmlTemplate(graphDataJson: string, options?: GraphHtmlOptions): string;
+/**
+ * 组装完整 HTML 字符串（内部函数，便于测试）
+ * F5 扩展：支持 hyperedge 凸包、大图横幅、节点跳转 spec、力导向阈值
+ */
+export declare function buildFullHtml(graphDataJson: string, d3Bundle: string, opts?: {
+    forceLayoutThreshold?: number;
+    showHyperedges?: boolean;
+    enableSearch?: boolean;
+    enableJumpToSpec?: boolean;
+    fileSizeWarnThreshold?: number;
+    /** Feature 140 T19：节点数 < 3 时注入"极小图"banner */
+    nodeCount?: number;
+}): string;
+//# sourceMappingURL=html-template.d.ts.map

package/dist/panoramic/exporters/html-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-template.d.ts","sourceRoot":"","sources":["../../../src/panoramic/exporters/html-template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,eAAO,MAAM,eAAe,urQAE3B,CAAC;AAGF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAsBvD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAsB3F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IACL,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,MAAM,CAwqBR"}