@ai-gui/plugin-bigscreen 0.36.3 → 0.37.0

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # @ai-gui/plugin-bigscreen
 
+## 0.37.0
+
+### Minor Changes
+
+- 8f3663c: A `graph3d` panel is a 3D model now, not a flat hairball.
+
+  The new default, `mode: "orbit"`, lays the entities out in space with a spring–electrical
+  simulation written for this — repulsion between every pair, springs along the edges, a weak pull
+  to the origin so a disconnected component cannot leave the panel, and a falling temperature that
+  cools the graph into a shape. It is drawn as a `scatter3D` of entities and a `lines3D` of edges
+  inside an invisible cube, lit from both sides so the far half is still readable, with the camera
+  turning slowly around it. The layout is deterministic — the starting positions are a hash of the
+  node ids — and it is stepped a few steps per animation frame rather than run to convergence, so
+  the reader watches the clusters arrive instead of being handed a settled picture. Node colours,
+  the type legend, the tooltip and `events.onNodeClick` are unchanged.
+
+  A graph re-rendered from a growing fence resumes rather than reshuffles: the positions each graph
+  settled into are remembered by node id, so the twenty entities already on screen stay where they
+  are and only the three that just arrived have to find a place.
+
+  `mode: "flat"` keeps the previous `graphGL` picture, byte for byte and pinned by a test, for
+  graphs big enough that depth hides more than it shows. `rotate: false`, and a host's
+  `animate: false`, hand over the settled model without turning it.
+
+- ae86ea6: A globe panel can now be drawn on a real earth. `bigscreen({ globe })` takes the host's planet: a
+  `baseTexture` (an equirectangular photograph the host serves itself), or a `countries` GeoJSON
+  FeatureCollection rasterised onto a 2:1 canvas in the screen's palette, plus `shading`,
+  `heightTexture`, `atmosphere` and a `light.time` that puts the terminator where the sun actually
+  is. With a host earth the points carry labels only for the largest few and the rest move to a
+  tooltip. The fence is unchanged — it still says only where the points and arcs are — and a host
+  that sets nothing gets the painted graticule it always got.
+- 84a9e1b: Two panels for provenance: `timeline` and `graph3d`.
+
+  `timeline` gives every source its own swim-lane and every claim its own point, with a line drawn
+  between claims that are related — `contradicts` in the palette's danger red, which is the picture
+  the panel exists for: two outlets said things that cannot both be true, and the red segment runs
+  between their two rows. Lanes stay in the order they were written, time runs across, the twelve
+  claims with the most empty space around them carry a label and the rest are one hover away, and a
+  claim with a `url` opens it on click. Up to 24 lanes, 500 claims and 500 links; `at` is ISO 8601;
+  `url` must be `http` or `https`, because that string reaches `window.open`.
+
+  `graph3d` draws entities and typed edges as a knowledge graph, laid out by force-atlas2 on the GPU
+  through `echarts-gl`'s `graphGL`. A type's colour is a hash of its name, so `outlet` is the same
+  colour in every panel on the wall whatever order the types appear in, and `types` pins any of them
+  to a colour of its own. Nodes are sized by degree or by `value`, the twenty busiest carry a label
+  along with `focus`, the types are keyed in the panel's corner in HTML over the canvas, and
+  `rotate` says whether the layout settles in front of the reader or arrives settled. Up to 2000
+  nodes and 5000 edges — a graph near that size also needs the host to raise `maxSourceBytes`.
+  Without the optional `echarts-gl` peer the panel shows the same one-line note the globe does.
+
+  New `bigscreen({ events })`: `onItemClick` takes a timeline click, `url` and all, and `onNodeClick`
+  gives a host something to do with an entity — a node is not a link, so there is no default.
+
+### Patch Changes
+
+- @ai-gui/core@0.37.0
+
 ## 0.36.3
 
 ### Patch Changes

package/README.md

@@ -8,12 +8,13 @@ model lays out.
 
 ```sh
 pnpm add @ai-gui/plugin-bigscreen echarts
-# for the chart3d and globe panels
+# for the chart3d, globe and graph3d panels
 pnpm add echarts-gl
 ```
 
-`echarts-gl` is an optional peer: without it the 3D and globe panels show a one-line note and the
-rest of the wall is unaffected. It is imported lazily, once, the first time such a panel mounts.
+`echarts-gl` is an optional peer: without it the `chart3d`, `globe` and `graph3d` panels show a
+one-line note and the rest of the wall is unaffected. It is imported lazily, once, the first time
+such a panel mounts.
 
 ## Usage
 
@@ -54,10 +55,26 @@ The model then emits:
 | `chart` | any ECharts option in the wall's palette, with entrance animation | `option` |
 | `chart3d` | `bar3D`, `scatter3D`, `surface` or `line3D`, slowly turning | `type`, `data`, `xAxis`, `yAxis`, `rotate` |
 | `globe` | a globe with arcing routes and sized points | `arcs`, `points`, `rotate` |
+| `timeline` | a swim-lane per source, a point per claim, lines between claims — `contradicts` in danger red | `lanes`, `items`, `links`, `from`, `to` |
+| `graph3d` | entities and typed edges, laid out by force-atlas2 on the GPU, coloured by type | `nodes`, `edges`, `types`, `focus`, `rotate` |
 
 Every panel takes `title`, `span` (columns of the grid, default 4 of 12) and `height`. The screen
 takes `title`, `subtitle`, `theme` (`dark` by default, or `light`), `accent` (hex) and `columns`.
 
+## Clicks
+
+A `timeline` claim with a `url` opens it in a new tab, opener cut off. A host that has its own
+idea of what a claim is takes the click instead, and a graph entity has no default at all:
+
+```ts
+bigscreen({
+  events: {
+    onItemClick: (item) => openClaim(item.id),
+    onNodeClick: (node) => selectEntity(node.id),
+  },
+})
+```
+
 ## Why the protocol looks like this
 
 **Presentation, not evidence.** [`@ai-gui/plugin-dashboard`](../plugin-dashboard/README.md) is the