@ai-gui/plugin-bigscreen 0.36.3 → 0.37.1

package/dist/index.js

@@ -1,4 +1,4 @@
-import { chart3dOption, chartOption, formatNumber, gaugeColour, gaugeOption, globeOption, palette, withAlpha } from "./options-C087Peeh.js";
+import { EDGE_VERTICES, GRAPH_LABELS, GRAPH_LEGEND_ROWS, GRAPH_MAX_STEPS, GRAPH_SETTLE_STEPS, LAYOUT_GRAVITY, LAYOUT_SPRING, ORBIT_BOX, ORBIT_DISTANCE, ORBIT_EXTENT, ORBIT_FOV, REMEMBERED_GRAPHS, TIMELINE_LABELS, chart3dOption, chartOption, countriesTexture, createLayout, degrees, earthColours, earthTexture, forgetPositions, formatNumber, gaugeColour, gaugeOption, globeOption, globeTexture, graph3dOption, graphKey, graphLegend, graphOrbitData, graphOrbitOption, graphTooltip, hash, layoutChunk, layoutRadius, layoutSteps, orbitFrame, palette, recallPositions, rememberPositions, seedPositions, spacedItems, timelineHeight, timelineOption, timelineWindow, typeColour, withAlpha } from "./positions-CN8aP4-S.js";
 import { translate } from "@ai-gui/core";
 
 //#region src/parse.ts
@@ -51,6 +51,21 @@ const FIELDS = {
 		"arcs",
 		"points",
 		"rotate"
+	],
+	timeline: [
+		"lanes",
+		"items",
+		"links",
+		"from",
+		"to"
+	],
+	graph3d: [
+		"nodes",
+		"edges",
+		"types",
+		"focus",
+		"mode",
+		"rotate"
 	]
 };
 const KINDS = new Set([
@@ -59,7 +74,9 @@ const KINDS = new Set([
 	"rank",
 	"chart",
 	"chart3d",
-	"globe"
+	"globe",
+	"timeline",
+	"graph3d"
 ]);
 const CHART3D_TYPES = new Set([
 	"bar3D",
@@ -67,10 +84,67 @@ const CHART3D_TYPES = new Set([
 	"surface",
 	"line3D"
 ]);
+const LINK_KINDS = new Set([
+	"contradicts",
+	"follows",
+	"same"
+]);
+const LANE_FIELDS = new Set([
+	"id",
+	"name",
+	"color"
+]);
+const TIMELINE_ITEM_FIELDS = new Set([
+	"id",
+	"lane",
+	"at",
+	"label",
+	"detail",
+	"url",
+	"value"
+]);
+const LINK_FIELDS = new Set([
+	"from",
+	"to",
+	"kind"
+]);
+const NODE_FIELDS = new Set([
+	"id",
+	"name",
+	"type",
+	"value"
+]);
+const EDGE_FIELDS = new Set([
+	"from",
+	"to",
+	"type"
+]);
 const HEX = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i;
+/**
+* Every limit the parser enforces, named.
+*
+* Exported because a limit the parser checks and nothing states is a trap: the prompt spec has to
+* name the same numbers, and a host building a fence of its own needs to know where the cliff is.
+* Overrunning any of them voids the whole block, so they are all deliberately generous — generous
+* enough that the biggest of them are not reachable under the default 64 KiB source cap: five
+* thousand edges is around a hundred kilobytes of JSON, so a host that really wants a graph that
+* size has to raise `maxSourceBytes` as well.
+*/
 const MAX_POINTS = 5e3;
 const MAX_ITEMS = 50;
 const MAX_ARCS = 300;
+const MAX_LANES = 24;
+const MAX_TIMELINE_ITEMS = 500;
+const MAX_LINKS = 500;
+const MAX_NODES = 2e3;
+const MAX_EDGES = 5e3;
+const MAX_TYPES = 32;
+const MAX_LANE_NAME = 40;
+const MAX_ITEM_LABEL = 120;
+const MAX_ITEM_DETAIL = 400;
+const MAX_URL = 400;
+const MAX_NODE_NAME = 80;
+const MAX_TYPE_NAME = 32;
 const bad = (message) => ({
 	ok: false,
 	error: {
@@ -91,6 +165,23 @@ const text = (value, max = 120) => typeof value === "string" && value.length <=
 * model that had never been told there was a limit.
 */
 const tooLong = (at, max, value) => typeof value === "string" ? `${at} must be at most ${max} characters (got ${value.length})` : `${at} must be a string of at most ${max} characters`;
+/**
+* A moment, as far as `Date.parse` is concerned — which is what the chart will read it with.
+*
+* Deliberately the platform's own parser rather than a stricter regular expression: a model that
+* writes `2026-09-01T08:00:00+02:00` or `2026-09-01` has said something a timeline can place, and
+* refusing the whole block over the shape of a suffix helps nobody.
+*/
+const instant = (value) => typeof value === "string" && value.length <= 40 && Number.isFinite(Date.parse(value));
+/**
+* A link a click may follow.
+*
+* Only `http` and `https`: this URL ends up in `window.open`, and `javascript:` there is script
+* the page runs because a model asked it to.
+*/
+const httpUrl = (value) => typeof value === "string" && value.length <= MAX_URL && /^https?:\/\/\S+$/i.test(value);
+/** The first key that is not in `allowed`, or undefined. */
+const stray = (raw, allowed) => Object.keys(raw).find((key) => !allowed.has(key));
 const lngLat = (value) => Array.isArray(value) && value.length === 2 && value.every(finite) && Math.abs(value[0]) <= 180 && Math.abs(value[1]) <= 90;
 function parseKpi(raw, at) {
 	if (!finite(raw.value)) return bad(`${at}.value must be a number`);
@@ -264,6 +355,181 @@ function parseGlobe(raw, at) {
 		value: panel
 	};
 }
+/**
+* A timeline, checked against itself.
+*
+* The references are the part worth the code: a claim on a lane nobody declared, or a
+* contradiction between an id and nothing, is dropped silently by every charting library there
+* is — and a timeline missing the very link it was drawn for is worse than no timeline at all.
+*/
+function parseTimeline(raw, at) {
+	if (!Array.isArray(raw.lanes) || raw.lanes.length === 0 || raw.lanes.length > MAX_LANES) return bad(`${at}.lanes must be 1 to ${MAX_LANES} entries`);
+	const lanes = [];
+	const laneIds = new Set();
+	for (const [index, lane] of raw.lanes.entries()) {
+		const where = `${at}.lanes[${index}]`;
+		if (!isRecord(lane) || !text(lane.id, 64) || typeof lane.name !== "string") return bad(`${where} must be {id, name}`);
+		const key = stray(lane, LANE_FIELDS);
+		if (key) return bad(`${where}.${key} is not a field of a timeline lane`);
+		if (!text(lane.name, MAX_LANE_NAME)) return bad(tooLong(`${where}.name`, MAX_LANE_NAME, lane.name));
+		if (laneIds.has(lane.id)) return bad(`${where}.id is a duplicate lane id`);
+		laneIds.add(lane.id);
+		const entry = {
+			id: lane.id,
+			name: lane.name
+		};
+		if (lane.color !== void 0) {
+			if (typeof lane.color !== "string" || !HEX.test(lane.color)) return bad(`${where}.color must be a hex colour like #22d3ee`);
+			entry.color = lane.color;
+		}
+		lanes.push(entry);
+	}
+	if (!Array.isArray(raw.items) || raw.items.length === 0 || raw.items.length > MAX_TIMELINE_ITEMS) return bad(`${at}.items must be 1 to ${MAX_TIMELINE_ITEMS} entries`);
+	const items = [];
+	const itemIds = new Set();
+	for (const [index, item] of raw.items.entries()) {
+		const where = `${at}.items[${index}]`;
+		if (!isRecord(item) || typeof item.lane !== "string" || typeof item.label !== "string" || item.at === void 0) return bad(`${where} must be {lane, at, label}`);
+		const key = stray(item, TIMELINE_ITEM_FIELDS);
+		if (key) return bad(`${where}.${key} is not a field of a timeline item`);
+		if (!laneIds.has(item.lane)) return bad(`${where}.lane is not one of the panel's lane ids`);
+		if (!instant(item.at)) return bad(`${where}.at must be an ISO 8601 date-time, like 2026-09-01T08:00:00Z`);
+		if (!text(item.label, MAX_ITEM_LABEL)) return bad(tooLong(`${where}.label`, MAX_ITEM_LABEL, item.label));
+		const entry = {
+			lane: item.lane,
+			at: item.at,
+			label: item.label
+		};
+		if (item.id !== void 0) {
+			if (!text(item.id, 64)) return bad(tooLong(`${where}.id`, 64, item.id));
+			if (itemIds.has(item.id)) return bad(`${where}.id is a duplicate item id`);
+			itemIds.add(item.id);
+			entry.id = item.id;
+		}
+		if (item.detail !== void 0) {
+			if (!text(item.detail, MAX_ITEM_DETAIL)) return bad(tooLong(`${where}.detail`, MAX_ITEM_DETAIL, item.detail));
+			entry.detail = item.detail;
+		}
+		if (item.url !== void 0) {
+			if (!httpUrl(item.url)) return bad(`${where}.url must be an http or https URL`);
+			entry.url = item.url;
+		}
+		if (item.value !== void 0) {
+			if (!finite(item.value) || item.value < 0) return bad(`${where}.value must be zero or a positive number`);
+			entry.value = item.value;
+		}
+		items.push(entry);
+	}
+	const panel = {
+		kind: "timeline",
+		lanes,
+		items
+	};
+	if (raw.links !== void 0) {
+		if (!Array.isArray(raw.links) || raw.links.length > MAX_LINKS) return bad(`${at}.links must be up to ${MAX_LINKS} entries`);
+		panel.links = [];
+		for (const [index, link] of raw.links.entries()) {
+			const where = `${at}.links[${index}]`;
+			if (!isRecord(link) || typeof link.from !== "string" || typeof link.to !== "string") return bad(`${where} must be {from, to}`);
+			const key = stray(link, LINK_FIELDS);
+			if (key) return bad(`${where}.${key} is not a field of a timeline link`);
+			for (const end of ["from", "to"]) if (!itemIds.has(link[end])) return bad(`${where}.${end} is not an item id`);
+			const entry = {
+				from: link.from,
+				to: link.to
+			};
+			if (link.kind !== void 0) {
+				if (typeof link.kind !== "string" || !LINK_KINDS.has(link.kind)) return bad(`${where}.kind must be contradicts, follows or same`);
+				entry.kind = link.kind;
+			}
+			panel.links.push(entry);
+		}
+	}
+	for (const edge of ["from", "to"]) {
+		if (raw[edge] === void 0) continue;
+		if (!instant(raw[edge])) return bad(`${at}.${edge} must be an ISO 8601 date-time, like 2026-09-01T08:00:00Z`);
+		panel[edge] = raw[edge];
+	}
+	return {
+		ok: true,
+		value: panel
+	};
+}
+/** A knowledge graph, checked against itself: every edge and the focus must land on a real node. */
+function parseGraph3d(raw, at) {
+	if (!Array.isArray(raw.nodes) || raw.nodes.length === 0 || raw.nodes.length > MAX_NODES) return bad(`${at}.nodes must be 1 to ${MAX_NODES} entries`);
+	const nodes = [];
+	const ids = new Set();
+	for (const [index, node] of raw.nodes.entries()) {
+		const where = `${at}.nodes[${index}]`;
+		if (!isRecord(node) || !text(node.id, 64) || typeof node.name !== "string") return bad(`${where} must be {id, name}`);
+		const key = stray(node, NODE_FIELDS);
+		if (key) return bad(`${where}.${key} is not a field of a graph3d node`);
+		if (!text(node.name, MAX_NODE_NAME)) return bad(tooLong(`${where}.name`, MAX_NODE_NAME, node.name));
+		if (ids.has(node.id)) return bad(`${where}.id is a duplicate node id`);
+		ids.add(node.id);
+		const entry = {
+			id: node.id,
+			name: node.name
+		};
+		if (node.type !== void 0) {
+			if (!text(node.type, MAX_TYPE_NAME)) return bad(tooLong(`${where}.type`, MAX_TYPE_NAME, node.type));
+			entry.type = node.type;
+		}
+		if (node.value !== void 0) {
+			if (!finite(node.value) || node.value < 0) return bad(`${where}.value must be zero or a positive number`);
+			entry.value = node.value;
+		}
+		nodes.push(entry);
+	}
+	if (!Array.isArray(raw.edges) || raw.edges.length > MAX_EDGES) return bad(`${at}.edges must be up to ${MAX_EDGES} entries`);
+	const edges = [];
+	for (const [index, edge] of raw.edges.entries()) {
+		const where = `${at}.edges[${index}]`;
+		if (!isRecord(edge) || typeof edge.from !== "string" || typeof edge.to !== "string") return bad(`${where} must be {from, to}`);
+		const key = stray(edge, EDGE_FIELDS);
+		if (key) return bad(`${where}.${key} is not a field of a graph3d edge`);
+		for (const end of ["from", "to"]) if (!ids.has(edge[end])) return bad(`${where}.${end} is not a node id`);
+		const entry = {
+			from: edge.from,
+			to: edge.to
+		};
+		if (edge.type !== void 0) {
+			if (!text(edge.type, MAX_TYPE_NAME)) return bad(tooLong(`${where}.type`, MAX_TYPE_NAME, edge.type));
+			entry.type = edge.type;
+		}
+		edges.push(entry);
+	}
+	const panel = {
+		kind: "graph3d",
+		nodes,
+		edges
+	};
+	if (raw.types !== void 0) {
+		if (!isRecord(raw.types) || Object.keys(raw.types).length > MAX_TYPES) return bad(`${at}.types must be up to ${MAX_TYPES} entries`);
+		const types = {};
+		for (const [name, colour] of Object.entries(raw.types)) {
+			if (!text(name, MAX_TYPE_NAME)) return bad(tooLong(`${at}.types key`, MAX_TYPE_NAME, name));
+			if (typeof colour !== "string" || !HEX.test(colour)) return bad(`${at}.types.${name} must be a hex colour like #22d3ee`);
+			types[name] = colour;
+		}
+		panel.types = types;
+	}
+	if (raw.focus !== void 0) {
+		if (typeof raw.focus !== "string" || !ids.has(raw.focus)) return bad(`${at}.focus is not a node id`);
+		panel.focus = raw.focus;
+	}
+	if (raw.mode !== void 0 && raw.mode !== "orbit" && raw.mode !== "flat") return bad(`${at}.mode must be orbit or flat`);
+	panel.mode = raw.mode ?? "orbit";
+	if (raw.rotate !== void 0) {
+		if (typeof raw.rotate !== "boolean") return bad(`${at}.rotate must be true or false`);
+		panel.rotate = raw.rotate;
+	}
+	return {
+		ok: true,
+		value: panel
+	};
+}
 function parsePanel(raw, index, columns) {
 	const at = `panels[${index}]`;
 	if (!isRecord(raw)) return bad(`${at} must be an object`);
@@ -298,6 +564,12 @@ function parsePanel(raw, index, columns) {
 		case "globe":
 			parsed = parseGlobe(raw, at);
 			break;
+		case "timeline":
+			parsed = parseTimeline(raw, at);
+			break;
+		case "graph3d":
+			parsed = parseGraph3d(raw, at);
+			break;
 	}
 	if (!parsed.ok) return parsed;
 	const panel = parsed.value;
@@ -418,6 +690,8 @@ const ZH = `数据大屏（围栏代码块）：\`\`\`bigscreen 开头，块内
 - "chart"：option（必填）——完整的 ECharts option，颜色、字体、动画由大屏统一
 - "chart3d"：type "bar3D" | "scatter3D" | "surface" | "line3D"、data（[[x, y, z], ...]）、xAxis / yAxis（类目名列表，给了的话 x、y 就是下标）、rotate（默认 true）
 - "globe"：arcs（[{"from": [经度, 纬度], "to": [经度, 纬度], "label"}]）、points（[{"coord": [经度, 纬度], "label", "value"}]）、rotate（默认 true）。至少给一个。适合洲际、跨国的流向；同一个省内的线路在地球上只有几个像素，那种用普通图表
+- "timeline"：一条泳道一个来源，一个点一条说法，说法之间可以连线。lanes（必填，1–24 条，[{"id", "name"（最多 40 字符）, "color"（十六进制）}]，从上到下就是你写的顺序）；items（必填，1–500 条，[{"id", "lane"（必须是上面某个 lane 的 id）, "at"（ISO 8601，如 "2026-09-01T08:00:00Z"）, "label"（最多 120 字符）, "detail"（最多 400 字符，只在悬停时出现）, "url"（只能是 http/https，点击打开）, "value"（点的大小）}]）；links（最多 500 条，[{"from", "to", "kind"}]，from 和 to 必须是上面写了 id 的 item，kind 是 "contradicts"（红线，两句话不可能同时为真）| "follows"（默认，带箭头）| "same"（点线，同一件事））；from、to（时间窗口，默认取所有 item 的范围再各留 5%）。lane 或 item 的 id 引用不到就整个块作废
+- "graph3d"：实体和带类型的边组成的知识图谱。nodes（必填，1–2000 个，[{"id", "name"（最多 80 字符）, "type"（最多 32 字符，同名的 type 在整面墙上颜色一致）, "value"（大小，默认按度数）}]）；edges（必填，最多 5000 条，[{"from", "to", "type"（最多 32 字符）}]，两端必须是上面的 node id）；types（最多 32 项，把某个 type 指定成某个十六进制颜色）；focus（某个 node id，会高亮并且永远带标签）；mode（"orbit" 默认 | "flat"）；rotate（默认 true）。mode "orbit" 是真正的三维模型：实体在空间里由力导向布局散开，镜头绕着它转，rotate false 就直接给最终模型且不转；mode "flat" 是原来的 GPU 平面布局，一两千个节点以上、三维反而看不清时才用它。度数最高的 20 个带标签，其余悬停可见，右下角有类型图例
 
 布局建议：第一行放 3–4 个 kpi（各 span 3），然后大图 span 8 配一个 rank 或 gauge span 4，3D 和地球 span 6。
 
@@ -440,6 +714,70 @@ const ZH = `数据大屏（围栏代码块）：\`\`\`bigscreen 开头，块内
 }
 \`\`\`
 
+例子——一条时间线，三家媒体，四条说法，其中两条互相矛盾：
+
+\`\`\`bigscreen
+{
+  "title": "边境车队",
+  "panels": [
+    {
+      "kind": "timeline",
+      "title": "各家说法",
+      "span": 12,
+      "lanes": [
+        { "id": "reuters", "name": "路透社" },
+        { "id": "tass", "name": "塔斯社" },
+        { "id": "ap", "name": "美联社" }
+      ],
+      "items": [
+        { "id": "c1", "lane": "reuters", "at": "2026-09-01T08:12:00Z", "label": "车队于清晨越境", "detail": "两名现场消息人士", "url": "https://example.com/reuters-1", "value": 3 },
+        { "id": "c2", "lane": "tass", "at": "2026-09-01T09:30:00Z", "label": "没有任何车队越境" },
+        { "id": "c3", "lane": "ap", "at": "2026-09-01T11:05:00Z", "label": "卫星影像确认越境" },
+        { "id": "c4", "lane": "reuters", "at": "2026-09-01T14:40:00Z", "label": "第二支车队" }
+      ],
+      "links": [
+        { "from": "c1", "to": "c2", "kind": "contradicts" },
+        { "from": "c1", "to": "c4", "kind": "follows" },
+        { "from": "c1", "to": "c3", "kind": "same" }
+      ]
+    }
+  ]
+}
+\`\`\`
+
+例子——一张知识图谱，六个实体三种类型，七条边：
+
+\`\`\`bigscreen
+{
+  "title": "实体关系",
+  "panels": [
+    {
+      "kind": "graph3d",
+      "title": "谁报道了什么",
+      "span": 12,
+      "focus": "convoy",
+      "nodes": [
+        { "id": "kyiv", "name": "基辅", "type": "place" },
+        { "id": "moscow", "name": "莫斯科", "type": "place" },
+        { "id": "reuters", "name": "路透社", "type": "outlet" },
+        { "id": "tass", "name": "塔斯社", "type": "outlet" },
+        { "id": "convoy", "name": "车队越境", "type": "event" },
+        { "id": "denial", "name": "否认越境", "type": "event" }
+      ],
+      "edges": [
+        { "from": "reuters", "to": "convoy", "type": "reported" },
+        { "from": "tass", "to": "denial", "type": "reported" },
+        { "from": "convoy", "to": "kyiv", "type": "located" },
+        { "from": "denial", "to": "moscow", "type": "located" },
+        { "from": "convoy", "to": "denial", "type": "contradicts" },
+        { "from": "reuters", "to": "kyiv", "type": "located" },
+        { "from": "tass", "to": "moscow", "type": "located" }
+      ]
+    }
+  ]
+}
+\`\`\`
+
 这一版画不了的（遇到就退回普通图表或文字）：实时刷新、可交互筛选、表格、地图着色（省份热力图）、视频。需要宿主提供真实数据的 BI 看板用 dashboard 块，不用这个。`;
 const EN = `Data walls (fenced): \`\`\`bigscreen with a JSON object inside. Emit one when the user asks for a dashboard, an overview, a "big screen", or wants a set of metrics, rankings, trends and places shown together and shown well. It draws a dark, glowing wall: numbers count up, gauges sweep, rank bars grow, charts draw themselves, 3D charts and globes turn slowly. Keep the explanation itself outside the block.
 
@@ -451,6 +789,10 @@ Top level: title (at most 80 characters), subtitle (at most 120), theme ("dark"
 
 Each panel: kind (required), title (at most 80 characters), span (columns, default 4), height (px). By kind: "kpi" (value, unit, prefix, decimals, delta as a fraction, upIsGood, trend as a short number list, label — one short line under the number, **at most 40 characters**, for a caption like "vs last month"; detail does not fit there, so put it in its own panel or outside the block); "gauge" (value, max default 100, unit, style "dial" or "ring", thresholds [0.6, 0.85] as alarm levels — amber past the first, red past the second — only for metrics where higher is worse, never for a completion rate); "rank" (items as {name, value}, unit, top default 8); "chart" (option: a full ECharts option — colours, fonts and animation come from the wall); "chart3d" (type "bar3D" | "scatter3D" | "surface" | "line3D", data as [x, y, z] points, optional xAxis and yAxis category lists, rotate); "globe" (arcs as {from: [lng, lat], to: [lng, lat], label}, points as {coord: [lng, lat], label, value}, rotate; at least one of arcs or points; for intercontinental flows — a route within one region is a few pixels on a globe, so use an ordinary chart for those).
 
+"timeline" — one swim-lane per source, one point per claim, lines between claims. lanes (required, 1 to 24, as {id, name at most 40 characters, color as hex}; drawn top-down in the order you write them); items (required, 1 to 500, as {id, lane — an id from lanes, at — ISO 8601 like "2026-09-01T08:00:00Z", label at most 120 characters, detail at most 400 and shown only on hover, url — http or https only, opened on click, value — how big the point is}); links (at most 500, as {from, to, kind}, where from and to are ids of items you gave an id to, and kind is "contradicts" (a red line: the two cannot both be true), "follows" (the default, with an arrow) or "same" (dotted, one thing said twice)); from and to for the window, which otherwise takes the claims' own range with 5% either side. A lane id or an item id that resolves to nothing voids the whole block.
+
+"graph3d" — entities and typed edges as a knowledge graph. nodes (required, 1 to 2000, as {id, name at most 80 characters, type at most 32 characters — one type is one colour everywhere on the wall, value — how big, defaulting to its degree}); edges (required, at most 5000, as {from, to, type at most 32 characters}, both ends being node ids); types (at most 32 entries, pinning a type to a hex colour); focus (a node id, highlighted and always labelled); mode ("orbit", the default, or "flat"); rotate (default true). In "orbit" the graph is a real three-dimensional model: the entities settle into space in front of the reader and the camera turns around them, and rotate false hands over the settled model without turning it. "flat" is the older GPU layout on a plane — reach for it only when a graph is big enough that depth hides more than it shows. The twenty busiest entities carry a label, the rest are one hover away, and the types are keyed in the corner.
+
 Layout: a first row of three or four kpi panels at span 3, then a wide chart at span 8 beside a rank or gauge at span 4, and 3D or globe panels at span 6.
 
 Example:
@@ -469,6 +811,70 @@ Example:
 }
 \`\`\`
 
+A timeline — three outlets, four claims, one of which contradicts another:
+
+\`\`\`bigscreen
+{
+  "title": "Border convoy",
+  "panels": [
+    {
+      "kind": "timeline",
+      "title": "Who said what",
+      "span": 12,
+      "lanes": [
+        { "id": "reuters", "name": "Reuters" },
+        { "id": "tass", "name": "TASS" },
+        { "id": "ap", "name": "AP" }
+      ],
+      "items": [
+        { "id": "c1", "lane": "reuters", "at": "2026-09-01T08:12:00Z", "label": "Convoy crossed at dawn", "detail": "Two sources on the ground.", "url": "https://example.com/reuters-1", "value": 3 },
+        { "id": "c2", "lane": "tass", "at": "2026-09-01T09:30:00Z", "label": "No convoy crossed" },
+        { "id": "c3", "lane": "ap", "at": "2026-09-01T11:05:00Z", "label": "Crossing confirmed by satellite" },
+        { "id": "c4", "lane": "reuters", "at": "2026-09-01T14:40:00Z", "label": "A second convoy" }
+      ],
+      "links": [
+        { "from": "c1", "to": "c2", "kind": "contradicts" },
+        { "from": "c1", "to": "c4", "kind": "follows" },
+        { "from": "c1", "to": "c3", "kind": "same" }
+      ]
+    }
+  ]
+}
+\`\`\`
+
+A knowledge graph — six entities of three types, seven edges:
+
+\`\`\`bigscreen
+{
+  "title": "Entities",
+  "panels": [
+    {
+      "kind": "graph3d",
+      "title": "Who reported what",
+      "span": 12,
+      "focus": "convoy",
+      "nodes": [
+        { "id": "kyiv", "name": "Kyiv", "type": "place" },
+        { "id": "moscow", "name": "Moscow", "type": "place" },
+        { "id": "reuters", "name": "Reuters", "type": "outlet" },
+        { "id": "tass", "name": "TASS", "type": "outlet" },
+        { "id": "convoy", "name": "Convoy crossing", "type": "event" },
+        { "id": "denial", "name": "Denial of crossing", "type": "event" }
+      ],
+      "edges": [
+        { "from": "reuters", "to": "convoy", "type": "reported" },
+        { "from": "tass", "to": "denial", "type": "reported" },
+        { "from": "convoy", "to": "kyiv", "type": "located" },
+        { "from": "denial", "to": "moscow", "type": "located" },
+        { "from": "convoy", "to": "denial", "type": "contradicts" },
+        { "from": "reuters", "to": "kyiv", "type": "located" },
+        { "from": "tass", "to": "moscow", "type": "located" }
+      ]
+    }
+  ]
+}
+\`\`\`
+
 Not supported — fall back to ordinary charts or prose: live refresh, interactive filters, tables, choropleth maps, video. A BI board whose numbers must come from the host's own queries is a dashboard block, not this.`;
 const PROMPT = {
 	en: { spec: EN },
@@ -488,7 +894,7 @@ const bigscreenCss = [
 	".aigui-bs-subtitle{margin:.25rem 0 0;font-size:.85rem;color:var(--aigui-bs-muted);letter-spacing:.12em}",
 	".aigui-bs-rule{height:1px;margin:.8rem auto 0;width:70%}",
 	".aigui-bs-grid{display:grid;gap:.9rem}",
-	".aigui-bs-panel{display:flex;flex-direction:column;min-width:0;border:1px solid;border-radius:10px;padding:.7rem .85rem .85rem;backdrop-filter:blur(6px)}",
+	".aigui-bs-panel{position:relative;display:flex;flex-direction:column;min-width:0;border:1px solid;border-radius:10px;padding:.7rem .85rem .85rem;backdrop-filter:blur(6px)}",
 	"[data-aigui-bigscreen='dark'] .aigui-bs-panel{background:linear-gradient(180deg,rgba(17,27,50,.82),rgba(10,18,36,.82));box-shadow:inset 0 1px 0 rgba(255,255,255,.04),0 10px 30px rgba(0,0,0,.35)}",
 	"[data-aigui-bigscreen='light'] .aigui-bs-panel{background:rgba(255,255,255,.9);box-shadow:0 6px 20px rgba(15,23,42,.06)}",
 	".aigui-bs-panel-title{display:flex;align-items:center;gap:.5rem;margin:0 0 .5rem;font-size:.8rem;font-weight:600;letter-spacing:.08em;text-transform:uppercase;color:var(--aigui-bs-muted)}",
@@ -508,6 +914,10 @@ const bigscreenCss = [
 	".aigui-bs-rank-track{display:block;height:8px;border-radius:4px;overflow:hidden}",
 	".aigui-bs-rank-fill{display:block;height:100%;border-radius:4px;transition:width 1.2s cubic-bezier(.22,1,.36,1)}",
 	".aigui-bs-rank-value{color:var(--aigui-bs-muted);font-variant-numeric:tabular-nums}",
+	".aigui-bs-graph-legend{position:absolute;right:.6rem;bottom:.6rem;z-index:2;display:flex;flex-direction:column;gap:.15rem;max-width:48%;padding:.3rem .45rem;border-radius:6px;background:color-mix(in srgb,currentColor 8%,transparent);font-size:.68rem;line-height:1.5;letter-spacing:.02em;color:var(--aigui-bs-muted);pointer-events:none}",
+	".aigui-bs-graph-legend-row{display:flex;align-items:center;gap:.35rem;min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}",
+	".aigui-bs-graph-legend-dot{flex:none;width:8px;height:8px;border-radius:50%}",
+	".aigui-bs-graph-legend-line{flex:none;width:12px;height:2px;border-radius:1px}",
 	".aigui-bs-note{display:flex;align-items:center;justify-content:center;height:100%;min-height:4rem;font-size:.85rem;color:var(--aigui-bs-muted)}",
 	"[data-aigui-bigscreen-loading]{min-height:8rem;border-radius:14px;background:currentColor;opacity:.06}",
 	":where([data-aigui-bigscreen-error]){padding:0.5rem 0.75rem;border-radius:0.5rem;font-size:0.875rem;background:color-mix(in srgb,currentColor 8%,transparent);border:1px solid color-mix(in srgb,currentColor 25%,transparent)}",
@@ -549,9 +959,9 @@ function bigscreen(options = {}) {
 			mount: (el) => {
 				let destroy;
 				let disposed = false;
-				import("./mount-CbzNLMoI.js").then(({ mountScreen }) => {
+				import("./mount-ChcoxgHd.js").then(({ mountScreen }) => {
 					if (disposed) return;
-					destroy = mountScreen(el, definition, options.animate !== false);
+					destroy = mountScreen(el, definition, options.animate !== false, options.globe, options.events);
 				}).catch(() => {
 					const error = document.createElement("div");
 					error.setAttribute("data-aigui-bigscreen-error", "");
@@ -586,4 +996,4 @@ function bigscreen(options = {}) {
 }
 
 //#endregion
-export { bigscreen, bigscreenCss, bigscreenPromptSpec, chart3dOption, chartOption, formatNumber, gaugeColour, gaugeOption, globeOption, palette, parseBigscreen, withAlpha };
+export { EDGE_VERTICES, GRAPH_LABELS, GRAPH_LEGEND_ROWS, GRAPH_MAX_STEPS, GRAPH_SETTLE_STEPS, LAYOUT_GRAVITY, LAYOUT_SPRING, MAX_ARCS, MAX_EDGES, MAX_ITEMS, MAX_ITEM_DETAIL, MAX_ITEM_LABEL, MAX_LANES, MAX_LANE_NAME, MAX_LINKS, MAX_NODES, MAX_NODE_NAME, MAX_POINTS, MAX_TIMELINE_ITEMS, MAX_TYPES, MAX_TYPE_NAME, MAX_URL, ORBIT_BOX, ORBIT_DISTANCE, ORBIT_EXTENT, ORBIT_FOV, REMEMBERED_GRAPHS, TIMELINE_LABELS, bigscreen, bigscreenCss, bigscreenPromptSpec, chart3dOption, chartOption, countriesTexture, createLayout, degrees, earthColours, earthTexture, forgetPositions, formatNumber, gaugeColour, gaugeOption, globeOption, globeTexture, graph3dOption, graphKey, graphLegend, graphOrbitData, graphOrbitOption, graphTooltip, hash, layoutChunk, layoutRadius, layoutSteps, orbitFrame, palette, parseBigscreen, recallPositions, rememberPositions, seedPositions, spacedItems, timelineHeight, timelineOption, timelineWindow, typeColour, withAlpha };