semiotic 3.9.0 → 3.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -17,54 +17,12 @@ AI coding assistants generate correct chart code on the first try.
|
|
|
17
17
|
<img src="./docs/public/assets/img/semiotic-release-dashboard.svg" alt="Semiotic release dashboard showing chart count, bundle sizes, capability coverage, chart families, and documentation growth" width="100%">
|
|
18
18
|
<!-- semiotic-readme-dashboard:end -->
|
|
19
19
|
|
|
20
|
-
## What's New in 3.9.
|
|
21
|
-
|
|
22
|
-
3.9.0 closes renderer and API gaps while making chart interaction easier to express:
|
|
23
|
-
|
|
24
|
-
- Retained mark styles accept datum-specific CSS cursors across canvas, SVG, and static rendering;
|
|
25
|
-
realtime chart HOCs also accept a top-level cursor default, including `TemporalHistogram`.
|
|
26
|
-
Cursor presentation stays separate from click and keyboard behavior so applications keep control
|
|
27
|
-
of interaction semantics.
|
|
28
|
-
- Realtime charts now share the generic typing, accessibility metadata, loading/empty states,
|
|
29
|
-
legends, selection, linked-hover, and observation contracts of the high-level chart families;
|
|
30
|
-
RealtimeLineChart also supports bounded event-time reordering, window aggregation, and explicit
|
|
31
|
-
end-of-stream flushing.
|
|
32
|
-
- Static rendering gains OrbitDiagram plus broad client-parity fixes for grouped XY data, custom
|
|
33
|
-
layouts, geo flows, gradients, background layers, empty scenes, and zero-valued network edges.
|
|
34
|
-
- New observation, tooltip, snapshot-flow, network hit-target, responsive, and theme-CSS helpers
|
|
35
|
-
are public, while stricter package, API, performance, docs, npm, Cloud Run, and MCP Registry
|
|
36
|
-
gates protect the release artifact end to end.
|
|
37
|
-
- `evaluateChart` now combines data-contract, representation, accessibility, and optional
|
|
38
|
-
render-evidence findings for the AI API, CLI, and MCP server. AI descriptions also distinguish
|
|
39
|
-
value components such as `BigNumber` from chart HOCs, and CommonJS recipe imports keep their
|
|
40
|
-
geographic dependencies lazy.
|
|
41
|
-
- Side legends reserve their focus-ring clearance consistently in browser and static output; use
|
|
42
|
-
the typed `frameProps.legendLayout.edgeGutter` to tune that clearance when necessary.
|
|
20
|
+
## What's New in 3.9.1
|
|
43
21
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
nodes={nodes}
|
|
49
|
-
edges={edges}
|
|
50
|
-
styleRules={[
|
|
51
|
-
{ when: node => Boolean(node.url), style: { cursor: "pointer" } }
|
|
52
|
-
]}
|
|
53
|
-
onClick={node => node?.url && openNode(node.url)}
|
|
54
|
-
/>
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
Simple charts stay five lines:
|
|
58
|
-
|
|
59
|
-
```jsx
|
|
60
|
-
import { LineChart } from "semiotic/xy"
|
|
61
|
-
|
|
62
|
-
<LineChart
|
|
63
|
-
data={salesData}
|
|
64
|
-
xAccessor="month"
|
|
65
|
-
yAccessor="revenue"
|
|
66
|
-
/>
|
|
67
|
-
```
|
|
22
|
+
3.9.1 is a focused patch release. It removes the webpack “conflicting star
|
|
23
|
+
exports” warning emitted by `semiotic/utils`, while keeping every existing
|
|
24
|
+
utility—including `resolveResponsiveDimension` and `useResponsiveSize`—available
|
|
25
|
+
from the same public entry point.
|
|
68
26
|
|
|
69
27
|
## Why Semiotic
|
|
70
28
|
|
|
@@ -419,35 +377,35 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
|
|
|
419
377
|
|
|
420
378
|
| Entry Point | gzip | What's inside |
|
|
421
379
|
|---|---|---|
|
|
422
|
-
| `semiotic/xy` | **
|
|
423
|
-
| `semiotic/ordinal` | **
|
|
424
|
-
| `semiotic/network` | **
|
|
425
|
-
| `semiotic/geo` | **
|
|
426
|
-
| `semiotic/realtime` | **
|
|
427
|
-
| `semiotic/realtime/core` | **
|
|
380
|
+
| `semiotic/xy` | **154 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
|
|
381
|
+
| `semiotic/ordinal` | **129 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
|
|
382
|
+
| `semiotic/network` | **150 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
|
|
383
|
+
| `semiotic/geo` | **110 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
|
|
384
|
+
| `semiotic/realtime` | **165 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
|
|
385
|
+
| `semiotic/realtime/core` | **164 KB** | Streaming chart types, HOCs, and buffer helpers |
|
|
428
386
|
| `semiotic/realtime/react` | **1 KB** | Stream status and synced push hooks |
|
|
429
|
-
| `semiotic/server` | **
|
|
430
|
-
| `semiotic/server/node` | **
|
|
431
|
-
| `semiotic/server/edge` | **
|
|
387
|
+
| `semiotic/server` | **197 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
388
|
+
| `semiotic/server/node` | **197 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
389
|
+
| `semiotic/server/edge` | **202 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
|
|
432
390
|
| `semiotic/utils` | **93 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
|
|
433
391
|
| `semiotic/utils/core` | **86 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
|
|
434
392
|
| `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
|
|
435
393
|
| `semiotic/recipes` | **94 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
436
394
|
| `semiotic/recipes/core` | **86 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
437
395
|
| `semiotic/recipes/react` | **7 KB** | Glyph and React layout-selection helpers |
|
|
438
|
-
| `semiotic/themes` | **
|
|
439
|
-
| `semiotic/themes/core` | **
|
|
396
|
+
| `semiotic/themes` | **7 KB** | Theme presets only (tufte, carbon, etc.) |
|
|
397
|
+
| `semiotic/themes/core` | **7 KB** | Theme presets and token helpers |
|
|
440
398
|
| `semiotic/themes/react` | **6 KB** | ThemeProvider/useTheme and hooks |
|
|
441
399
|
| `semiotic/data` | **4 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
|
|
442
400
|
| `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
|
|
443
|
-
| `semiotic/physics` | **
|
|
401
|
+
| `semiotic/physics` | **165 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
|
|
444
402
|
| `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
|
|
445
403
|
| `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
|
|
446
|
-
| `semiotic/ai` | **
|
|
447
|
-
| `semiotic/ai/core` | **
|
|
404
|
+
| `semiotic/ai` | **522 KB** | All schema-backed charts + validation — optimized for LLM code generation |
|
|
405
|
+
| `semiotic/ai/core` | **88 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
|
|
448
406
|
| `semiotic/controls` | **11 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
|
|
449
407
|
| `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
|
|
450
|
-
| `semiotic` | **
|
|
408
|
+
| `semiotic` | **335 KB** | Everything below (full bundle) |
|
|
451
409
|
|
|
452
410
|
<!-- semiotic-bundle-sizes:end -->
|
|
453
411
|
|
|
@@ -470,19 +428,19 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
|
|
|
470
428
|
|---|---:|---:|
|
|
471
429
|
| `import { LineChart } from "semiotic"` | browser | **162.5 KiB** |
|
|
472
430
|
| `import { LineChart } from "semiotic/xy"` | browser | **162.2 KiB** |
|
|
473
|
-
| `import { BarChart } from "semiotic/ordinal"` | browser | **130.
|
|
431
|
+
| `import { BarChart } from "semiotic/ordinal"` | browser | **130.6 KiB** |
|
|
474
432
|
| `import { SankeyDiagram } from "semiotic/network"` | browser | **152.7 KiB** |
|
|
475
433
|
| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **135.4 KiB** |
|
|
476
434
|
| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
|
|
477
435
|
| `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
|
|
478
|
-
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.
|
|
436
|
+
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.3 KiB** |
|
|
479
437
|
| `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
|
|
480
438
|
| `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** |
|
|
481
|
-
| `import { renderChart } from "semiotic/server"` | node | **243.
|
|
482
|
-
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **86.
|
|
483
|
-
| `import { renderToImage } from "semiotic/server/node"` | node | **243.
|
|
484
|
-
| `import { suggestCharts } from "semiotic/ai"` | browser | **239.
|
|
485
|
-
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **38.
|
|
439
|
+
| `import { renderChart } from "semiotic/server"` | node | **243.4 KiB** |
|
|
440
|
+
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **86.6 KiB** |
|
|
441
|
+
| `import { renderToImage } from "semiotic/server/node"` | node | **243.9 KiB** |
|
|
442
|
+
| `import { suggestCharts } from "semiotic/ai"` | browser | **239.3 KiB** |
|
|
443
|
+
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **38.2 KiB** |
|
|
486
444
|
| `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
|
|
487
445
|
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **114.6 KiB** |
|
|
488
446
|
| `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.1 KiB** |
|
package/ai/reference.md
CHANGED
|
@@ -10,7 +10,7 @@ diagnostic tools; when possible, confirm a non-empty render with evidence.
|
|
|
10
10
|
- Install: `npm install semiotic`
|
|
11
11
|
<!-- semiotic-bundle-sizes:start -->
|
|
12
12
|
<!-- Auto-generated by scripts/sync-bundle-sizes.mjs — do not edit by hand. -->
|
|
13
|
-
- **Use sub-path imports** — `semiotic/xy` (
|
|
13
|
+
- **Use sub-path imports** — `semiotic/xy` (154KB gz), `semiotic/ordinal` (129KB gz), `semiotic/network` (150KB gz), `semiotic/geo` (110KB gz), `semiotic/realtime` (165KB gz), `semiotic/realtime/core` (164KB gz), `semiotic/realtime/react` (1KB gz), `semiotic/server` (197KB gz), `semiotic/server/node` (197KB gz), `semiotic/server/edge` (202KB gz), `semiotic/utils` (93KB gz), `semiotic/utils/core` (86KB gz), `semiotic/utils/react` (7KB gz), `semiotic/recipes` (94KB gz), `semiotic/recipes/core` (86KB gz), `semiotic/recipes/react` (7KB gz), `semiotic/themes` (7KB gz), `semiotic/themes/core` (7KB gz), `semiotic/themes/react` (6KB gz), `semiotic/data` (4KB gz), `semiotic/value` (6KB gz), `semiotic/physics` (165KB gz), `semiotic/physics/matter` (1KB gz), `semiotic/physics/rapier` (1KB gz), `semiotic/ai` (522KB gz), `semiotic/ai/core` (88KB gz), `semiotic/controls` (11KB gz), `semiotic/rough` (3KB gz). Full `semiotic` is 335KB gz.
|
|
14
14
|
<!-- semiotic-bundle-sizes:end -->
|
|
15
15
|
- CLI: `npx semiotic-ai [--schema|--compact|--examples|--doctor|--audit-a11y|--evaluate]` · MCP: `npx semiotic-mcp`
|
|
16
16
|
|
package/ai/schema.json
CHANGED
package/ai/surface-manifest.json
CHANGED
|
@@ -4,4 +4,4 @@
|
|
|
4
4
|
* Import from "semiotic/utils" for the full utilities surface.
|
|
5
5
|
*/
|
|
6
6
|
export * from "./semiotic-utils-core";
|
|
7
|
-
export
|
|
7
|
+
export { ThemeProvider, useTheme, useReducedMotion, useHighContrast, useResponsiveSize, } from "./semiotic-utils-react";
|
package/dist/semiotic-utils.d.ts
CHANGED
|
@@ -4,4 +4,4 @@
|
|
|
4
4
|
* Import from "semiotic/utils" for the full utilities surface.
|
|
5
5
|
*/
|
|
6
6
|
export * from "./components/semiotic-utils-core";
|
|
7
|
-
export
|
|
7
|
+
export { ThemeProvider, useTheme, useReducedMotion, useHighContrast, useResponsiveSize, } from "./components/semiotic-utils-react";
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
"use client";
|
|
2
|
-
export*from"./semiotic-utils-core.module.min.js";export
|
|
2
|
+
export*from"./semiotic-utils-core.module.min.js";export{ThemeProvider,useTheme,useReducedMotion,useHighContrast,useResponsiveSize}from"./semiotic-utils-react.module.min.js";
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "semiotic",
|
|
3
|
-
"version": "3.9.
|
|
3
|
+
"version": "3.9.1",
|
|
4
4
|
"mcpName": "io.github.nteract/semiotic",
|
|
5
5
|
"description": "Verified generative visualization for React and agents, with deterministic chart validation, repair, rendering evidence, and MCP.",
|
|
6
6
|
"main": "dist/semiotic.min.js",
|