Merge pull request #1113 from nteract/pre-3.8.3

Release 3.8.3: narrative examples & SSR alignment

Author: emeeks

CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.8.3] - 2026-07-17
+
+### Added
+
+- **Narrative examples.** Added Earthquakes and Europa Languages examples,
+  including deterministic data fixtures and example-gallery previews.
+
+### Changed
+
+- **Browser/server rendering alignment.** Browser, static SVG, and MCP render
+  paths now share chart-mode defaults, line and geo styling, legend layout,
+  temporal histogram configuration, and specialized network, geo, gauge, and
+  custom-chart rendering behavior.
+- **SSR parity coverage.** Replaced the redundant SSR/CSR screenshot matrix
+  with semantic markup and targeted geometry assertions, while retaining the
+  dedicated cross-browser visual suite.
+
+### Fixed
+
+- **Docs example route smoke test.** The route contract now targets the
+  `ExamplePageLayout` title specifically, and the Earthquakes dashboard uses a
+  nested heading level instead of duplicating the page's H1.
+
 ## [3.8.2] - 2026-07-16
 
 ### Fixed

README.md

@@ -16,15 +16,16 @@ AI coding assistants generate correct chart code on the first try.
 <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%">
 <!-- semiotic-readme-dashboard:end -->
 
-## What's New in 3.8.2
+## What's New in 3.8.3
 
-3.8.2 makes the hosted MCP accessibility contract internally consistent:
+3.8.3 aligns browser and server rendering while tightening the docs release gate:
 
-- Chart schemas, validation, repair guidance, and audits consistently expose `title`,
-  `description`, `summary`, and `accessibleTable`.
-- Hosted `getChartSchema` returns structured output for component lists, schemas, and errors,
-  including direct and `ChartContainer` accessibility guidance.
-- The public MCP profile remains a focused five-tool surface with render-proven `createChart` output.
+- Static SVG rendering now shares chart defaults, legend layout, color behavior, and specialized
+  chart paths with the browser renderers.
+- SSR parity coverage compares semantic chart output and targeted rendered geometry without
+  maintaining a second, redundant visual-snapshot matrix.
+- Two new narrative examples—Earthquakes and Europa Languages—exercise geographic and network
+  visualization paths, and every example source route is smoke-tested in CI.
 
 ```jsx
 import { LineChart } from "semiotic/xy"

ai/mcp-build-info.test.ts

@@ -4,8 +4,8 @@ import {
 } from "./mcp-build-info"
 
 describe("Semiotic MCP build identity", () => {
-  const packageVersion = "3.8.2"
-  const surfaceVersion = "3.8.2-ai"
+  const packageVersion = "3.8.3"
+  const surfaceVersion = "3.8.3-ai"
 
   it("reports explicit repository-nightly provenance and a distinct MCP identity", () => {
     const commitSha = "00db062e9ed42be02a9c4f59dbf8396ebd1712cd"
@@ -35,7 +35,7 @@ describe("Semiotic MCP build identity", () => {
     })
     expect(mcpServerInfoForBuild(buildInfo)).toEqual({
       name: "semiotic-nightly",
-      version: "3.8.2-nightly+00db062",
+      version: "3.8.3-nightly+00db062",
     })
   })
 
@@ -117,7 +117,7 @@ describe("Semiotic MCP build identity", () => {
 
     const serverInfo = mcpServerInfoForBuild(buildInfo)
     expect(serverInfo.name).toBe("semiotic-nightly")
-    expect(serverInfo.version).toBe("3.8.2-nightly+unknown")
+    expect(serverInfo.version).toBe("3.8.3-nightly+unknown")
     expect(serverInfo.version).not.toBe(packageVersion)
   })
 })

ai/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "semiotic",
-  "version": "3.8.2",
+  "version": "3.8.3",
   "description": "React data visualization library for charts, networks, and beyond",
   "tools": [
     {

ai/surface-manifest.json

@@ -7,7 +7,7 @@
     "src/components/semiotic-ai.ts",
     "ai/mcp-server.ts"
   ],
-  "version": "3.8.2",
+  "version": "3.8.3",
   "components": {
     "schema": 54,
     "aiChartExports": 51,

benchmarks/setup/cold-consumer-imports.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "package": {
     "name": "semiotic",
-    "version": "3.8.2"
+    "version": "3.8.3"
   },
   "method": {
     "artifact": "npm pack --ignore-scripts tarball",