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.0
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
- ```jsx
45
- import { ForceDirectedGraph } from "semiotic/network"
46
-
47
- <ForceDirectedGraph
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` | **152 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
423
- | `semiotic/ordinal` | **128 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
424
- | `semiotic/network` | **149 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
425
- | `semiotic/geo` | **109 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
426
- | `semiotic/realtime` | **163 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
427
- | `semiotic/realtime/core` | **162 KB** | Streaming chart types, HOCs, and buffer helpers |
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` | **195 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
430
- | `semiotic/server/node` | **195 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
431
- | `semiotic/server/edge` | **200 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
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` | **6 KB** | Theme presets only (tufte, carbon, etc.) |
439
- | `semiotic/themes/core` | **6 KB** | Theme presets and token helpers |
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` | **164 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
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` | **520 KB** | All schema-backed charts + validation — optimized for LLM code generation |
447
- | `semiotic/ai/core` | **87 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
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` | **334 KB** | Everything below (full bundle) |
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.5 KiB** |
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.2 KiB** |
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.2 KiB** |
482
- | `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **86.5 KiB** |
483
- | `import { renderToImage } from "semiotic/server/node"` | node | **243.6 KiB** |
484
- | `import { suggestCharts } from "semiotic/ai"` | browser | **239.2 KiB** |
485
- | `import { suggestCharts } from "semiotic/ai/core"` | browser | **38.1 KiB** |
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` (152KB gz), `semiotic/ordinal` (128KB gz), `semiotic/network` (149KB gz), `semiotic/geo` (109KB gz), `semiotic/realtime` (163KB gz), `semiotic/realtime/core` (162KB gz), `semiotic/realtime/react` (1KB gz), `semiotic/server` (195KB gz), `semiotic/server/node` (195KB gz), `semiotic/server/edge` (200KB 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` (6KB gz), `semiotic/themes/core` (6KB gz), `semiotic/themes/react` (6KB gz), `semiotic/data` (4KB gz), `semiotic/value` (6KB gz), `semiotic/physics` (164KB gz), `semiotic/physics/matter` (1KB gz), `semiotic/physics/rapier` (1KB gz), `semiotic/ai` (520KB gz), `semiotic/ai/core` (87KB gz), `semiotic/controls` (11KB gz), `semiotic/rough` (3KB gz). Full `semiotic` is 334KB gz.
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
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "name": "semiotic",
4
- "version": "3.9.0",
4
+ "version": "3.9.1",
5
5
  "description": "React data visualization library for charts, networks, and beyond",
6
6
  "tools": [
7
7
  {
@@ -7,7 +7,7 @@
7
7
  "src/components/semiotic-ai.ts",
8
8
  "ai/mcp-server.ts"
9
9
  ],
10
- "version": "3.9.0",
10
+ "version": "3.9.1",
11
11
  "components": {
12
12
  "schema": 57,
13
13
  "aiChartExports": 54,
@@ -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 * from "./semiotic-utils-react";
7
+ export { ThemeProvider, useTheme, useReducedMotion, useHighContrast, useResponsiveSize, } from "./semiotic-utils-react";
@@ -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 * from "./components/semiotic-utils-react";
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*from"./semiotic-utils-react.module.min.js";
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.0",
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",