semiotic 3.8.1 → 3.8.3

package/CLAUDE.md

@@ -4,7 +4,7 @@
 - Install: `npm install semiotic`
 <!-- semiotic-bundle-sizes:start -->
 <!-- Auto-generated by scripts/sync-bundle-sizes.mjs — do not edit by hand. -->
-- **Use sub-path imports** — `semiotic/xy` (108KB gz), `semiotic/ordinal` (88KB gz), `semiotic/network` (93KB gz), `semiotic/geo` (66KB gz), `semiotic/realtime` (119KB gz), `semiotic/realtime/core` (118KB gz), `semiotic/realtime/react` (1KB gz), `semiotic/server` (124KB gz), `semiotic/server/node` (124KB gz), `semiotic/server/edge` (123KB gz), `semiotic/utils` (59KB gz), `semiotic/utils/core` (58KB gz), `semiotic/utils/react` (4KB gz), `semiotic/recipes` (53KB gz), `semiotic/recipes/core` (52KB gz), `semiotic/recipes/react` (1KB gz), `semiotic/themes` (6KB gz), `semiotic/themes/core` (6KB gz), `semiotic/themes/react` (4KB gz), `semiotic/data` (3KB gz), `semiotic/value` (6KB gz), `semiotic/physics` (104KB gz), `semiotic/physics/matter` (1KB gz), `semiotic/physics/rapier` (1KB gz), `semiotic/ai` (394KB gz), `semiotic/ai/core` (67KB gz), `semiotic/controls` (10KB gz), `semiotic/rough` (3KB gz). Full `semiotic` is 251KB gz.
+- **Use sub-path imports** — `semiotic/xy` (136KB gz), `semiotic/ordinal` (116KB gz), `semiotic/network` (122KB gz), `semiotic/geo` (95KB gz), `semiotic/realtime` (148KB gz), `semiotic/realtime/core` (143KB gz), `semiotic/realtime/react` (1KB gz), `semiotic/server` (134KB gz), `semiotic/server/node` (134KB gz), `semiotic/server/edge` (157KB gz), `semiotic/utils` (75KB gz), `semiotic/utils/core` (74KB gz), `semiotic/utils/react` (6KB gz), `semiotic/recipes` (75KB gz), `semiotic/recipes/core` (74KB gz), `semiotic/recipes/react` (2KB gz), `semiotic/themes` (7KB gz), `semiotic/themes/core` (7KB gz), `semiotic/themes/react` (6KB gz), `semiotic/data` (4KB gz), `semiotic/value` (8KB gz), `semiotic/physics` (133KB gz), `semiotic/physics/matter` (1KB gz), `semiotic/physics/rapier` (1KB gz), `semiotic/ai` (430KB gz), `semiotic/ai/core` (68KB gz), `semiotic/controls` (12KB gz), `semiotic/rough` (3KB gz). Full `semiotic` is 347KB gz.
 <!-- semiotic-bundle-sizes:end -->
 - CLI: `npx semiotic-ai [--schema|--compact|--examples|--doctor|--audit-a11y]` · MCP: `npx semiotic-mcp`
 
@@ -339,6 +339,8 @@ Interface for proposing/scoring variants beyond `capability.variants`. The built
 
 These rules are generated from `ai/behaviorContracts.cjs` and are consumed by `semiotic-ai --doctor`, MCP resources, and docs checks.
 
+- **Accessible chart text uses direct chart props** (`accessibility.description-props`): High-level charts expose title for the visible name, description for a concise accessible description, summary for a screen-reader-only takeaway and interaction guidance, and accessibleTable for the data-table fallback.
+  Agent action: Put title, description, summary, and accessibleTable directly on the chart component when they appear in its schema. For generated L1–L3 description or a navigable chart tree, use ChartContainer with chartConfig plus describe and/or navigable; do not invent frameProps fields.
 - **Data required by usage mode** (`props.data-required-by-usage-mode`): Static usage (`renderChart`, MCP previews, SSR snapshots, and copy/paste examples with immediate data) requires data in props. React push mode selects live ingestion by omitting data and mutating through a ref.
   Agent action: Pass usageMode="push" to `semiotic-ai --doctor` when validating ref-based JSX with no data prop. Keep usageMode="static" or omit it for renderChart/MCP/static configs where data must be present.
 - **Categorical color precedence** (`color.category-precedence`): When colorBy is set, CategoryColorProvider/LinkedCharts category maps win for mapped categories. Unmapped categories fall back to explicit colorScheme, then ThemeProvider colors.categorical, then the built-in categorical fallback.

package/README.md

@@ -16,14 +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.1
+## What's New in 3.8.3
 
-3.8.1 makes the hosted MCP rendering path release-ready:
+3.8.3 aligns browser and server rendering while tightening the docs release gate:
 
-- Stateless HTTP requests no longer cancel rendering after a completed request body.
-- Hosted `createChart` now has verified SVG and render evidence with `render-proven` status.
-- `GET /health` is the sole supported MCP health endpoint; nightly remains `main`-based while
-  stable deployments are pinned to published releases.
+- 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"
@@ -370,35 +372,35 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
 
 | Entry Point | gzip | What's inside |
 |---|---|---|
-| `semiotic/xy` | **108 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
-| `semiotic/ordinal` | **88 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
-| `semiotic/network` | **93 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
-| `semiotic/geo` | **66 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
-| `semiotic/realtime` | **119 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
-| `semiotic/realtime/core` | **118 KB** | Streaming chart types, HOCs, and buffer helpers |
+| `semiotic/xy` | **136 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
+| `semiotic/ordinal` | **116 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
+| `semiotic/network` | **122 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
+| `semiotic/geo` | **95 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
+| `semiotic/realtime` | **148 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
+| `semiotic/realtime/core` | **143 KB** | Streaming chart types, HOCs, and buffer helpers |
 | `semiotic/realtime/react` | **1 KB** | Stream status and synced push hooks |
-| `semiotic/server` | **124 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
-| `semiotic/server/node` | **124 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
-| `semiotic/server/edge` | **123 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
-| `semiotic/utils` | **59 KB** | ThemeProvider, validators, serialization — no chart components |
-| `semiotic/utils/core` | **58 KB** | Theme helpers and serialization utilities |
-| `semiotic/utils/react` | **4 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
-| `semiotic/recipes` | **53 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
-| `semiotic/recipes/core` | **52 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
-| `semiotic/recipes/react` | **1 KB** | Glyph and React layout-selection helpers |
-| `semiotic/themes` | **6 KB** | Theme presets only (tufte, carbon, etc.) |
-| `semiotic/themes/core` | **6 KB** | Theme presets and token helpers |
-| `semiotic/themes/react` | **4 KB** | ThemeProvider/useTheme and hooks |
-| `semiotic/data` | **3 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
-| `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
-| `semiotic/physics` | **104 KB** | GaltonBoardChart, EventDropChart, PhysicsPileChart, CollisionSwarmChart, PhysicalFlowChart, PhysicsCustomChart |
+| `semiotic/server` | **134 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
+| `semiotic/server/node` | **134 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
+| `semiotic/server/edge` | **157 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
+| `semiotic/utils` | **75 KB** | ThemeProvider, validators, serialization — no chart components |
+| `semiotic/utils/core` | **74 KB** | Theme helpers and serialization utilities |
+| `semiotic/utils/react` | **6 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
+| `semiotic/recipes` | **75 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
+| `semiotic/recipes/core` | **74 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
+| `semiotic/recipes/react` | **2 KB** | Glyph and React layout-selection helpers |
+| `semiotic/themes` | **7 KB** | Theme presets only (tufte, carbon, etc.) |
+| `semiotic/themes/core` | **7 KB** | Theme presets and token helpers |
+| `semiotic/themes/react` | **6 KB** | ThemeProvider/useTheme and hooks |
+| `semiotic/data` | **4 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
+| `semiotic/value` | **8 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
+| `semiotic/physics` | **133 KB** | GaltonBoardChart, EventDropChart, PhysicsPileChart, CollisionSwarmChart, PhysicalFlowChart, PhysicsCustomChart |
 | `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
 | `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
-| `semiotic/ai` | **394 KB** | All schema-backed charts + validation — optimized for LLM code generation |
-| `semiotic/ai/core` | **67 KB** | suggestCharts, validateProps, describeChart, repairChartConfig, tool adapters — no chart components |
-| `semiotic/controls` | **10 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
+| `semiotic/ai` | **430 KB** | All schema-backed charts + validation — optimized for LLM code generation |
+| `semiotic/ai/core` | **68 KB** | suggestCharts, validateProps, describeChart, repairChartConfig, tool adapters — no chart components |
+| `semiotic/controls` | **12 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
 | `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
-| `semiotic` | **251 KB** | Everything below (full bundle) |
+| `semiotic` | **347 KB** | Everything below (full bundle) |
 
 <!-- semiotic-bundle-sizes:end -->
 
@@ -419,33 +421,33 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
 
 | Public named import | Runtime | gzip cold-consumer bundle |
 |---|---:|---:|
-| `import { LineChart } from "semiotic"` | browser | **281.3 KiB** |
-| `import { LineChart } from "semiotic/xy"` | browser | **143.8 KiB** |
-| `import { BarChart } from "semiotic/ordinal"` | browser | **119.1 KiB** |
-| `import { SankeyDiagram } from "semiotic/network"` | browser | **124.4 KiB** |
-| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **163.5 KiB** |
-| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **163.4 KiB** |
+| `import { LineChart } from "semiotic"` | browser | **146.9 KiB** |
+| `import { LineChart } from "semiotic/xy"` | browser | **146.9 KiB** |
+| `import { BarChart } from "semiotic/ordinal"` | browser | **121.4 KiB** |
+| `import { SankeyDiagram } from "semiotic/network"` | browser | **126.0 KiB** |
+| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **120.8 KiB** |
+| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **168.9 KiB** |
 | `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
-| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **113.6 KiB** |
+| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **115.8 KiB** |
 | `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
 | `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** |
-| `import { renderChart } from "semiotic/server"` | node | **164.7 KiB** |
-| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **79.9 KiB** |
-| `import { renderToImage } from "semiotic/server/node"` | node | **165.1 KiB** |
-| `import { suggestCharts } from "semiotic/ai"` | browser | **413.4 KiB** |
-| `import { suggestCharts } from "semiotic/ai/core"` | browser | **30.6 KiB** |
+| `import { renderChart } from "semiotic/server"` | node | **177.0 KiB** |
+| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **84.3 KiB** |
+| `import { renderToImage } from "semiotic/server/node"` | node | **177.5 KiB** |
+| `import { suggestCharts } from "semiotic/ai"` | browser | **205.8 KiB** |
+| `import { suggestCharts } from "semiotic/ai/core"` | browser | **31.1 KiB** |
 | `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
-| `import { ChoroplethMap } from "semiotic/geo"` | browser | **104.1 KiB** |
+| `import { ChoroplethMap } from "semiotic/geo"` | browser | **105.6 KiB** |
 | `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.3 KiB** |
 | `import { resolveThemePreset } from "semiotic/themes"` | browser | **3.4 KiB** |
 | `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **3.4 KiB** |
 | `import { ThemeProvider } from "semiotic/themes/react"` | browser | **4.4 KiB** |
-| `import { validateProps } from "semiotic/utils"` | browser | **7.9 KiB** |
-| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **2.1 KiB** |
-| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **1.8 KiB** |
-| `import { waffleLayout } from "semiotic/recipes"` | browser | **1.3 KiB** |
-| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **1.3 KiB** |
-| `import { Glyph } from "semiotic/recipes/react"` | browser | **0.9 KiB** |
+| `import { validateProps } from "semiotic/utils"` | browser | **6.4 KiB** |
+| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **0.2 KiB** |
+| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **0.3 KiB** |
+| `import { waffleLayout } from "semiotic/recipes"` | browser | **2.5 KiB** |
+| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **2.5 KiB** |
+| `import { Glyph } from "semiotic/recipes/react"` | browser | **0.8 KiB** |
 | `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
 | `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
 
@@ -459,9 +461,9 @@ import { SankeyDiagram } from "semiotic/network"
 import { ChoroplethMap } from "semiotic/geo"
 ```
 
-**Tree-shaking**: Each sub-path is a separate, pre-bundled artifact marked `"sideEffects": false`, so importing from `semiotic/xy` never pulls in `semiotic/ordinal` or `semiotic/network`. Note the boundary: within a family artifact the charts are **already combined into one module**, so importing only `LineChart` from `semiotic/xy` still loads the whole XY family artifact (≈98 KB gz) — bundlers cannot tree-shake individual charts back out of a pre-bundled family. Cross-family separation is real; per-chart separation within a family is not (granular per-chart entries are planned). Pick the narrowest sub-path for your charts.
+**Tree-shaking & multi-subpath imports**: Family entries (`semiotic/xy`, `semiotic/network`, `semiotic/ai`, …) are built as one ESM graph with **shared chunks**. Stream frames, renderers, and other common code ship once and are imported by every entry that needs them — so combining `semiotic/ai` + `semiotic/xy` + `semiotic/network` does **not** mean paying for three full copies of the runtime. The package is marked `"sideEffects": false`, so modern bundlers keep only the named exports you retain (e.g. `LineChart` + `suggestCharts`). Prefer family subpaths for clarity; import AI helpers from `semiotic/ai` or the lighter `semiotic/ai/core` when you do not need the chart catalog.
 
-**When to use `"semiotic"`**: Only if your app uses charts from 3+ categories (XY + ordinal + network) and you'd rather have one import than three. The full bundle is roughly the sum of every sub-path bundle above — see the `semiotic` row of the table for the current number.
+**When to use `"semiotic"`**: Fine when you want one import for mixed families. With shared chunks it is no longer “sum every subpath” — the cold-consumer table above is the better guide for a single named import, and multi-family apps should not see the old double-pay tax.
 
 ## TypeScript
 

package/ai/behaviorContracts.cjs

@@ -147,6 +147,15 @@ const PUSH_MODE_COMPONENTS = [
 const STATIC_DATA_COMPONENTS = loadStaticDataComponentsFromSchema()
 
 const BEHAVIOR_CONTRACTS = [
+  {
+    id: "accessibility.description-props",
+    category: "accessibility",
+    title: "Accessible chart text uses direct chart props",
+    severity: "warning",
+    appliesTo: {},
+    summary: "High-level charts expose title for the visible name, description for a concise accessible description, summary for a screen-reader-only takeaway and interaction guidance, and accessibleTable for the data-table fallback.",
+    agentAction: "Put title, description, summary, and accessibleTable directly on the chart component when they appear in its schema. For generated L1–L3 description or a navigable chart tree, use ChartContainer with chartConfig plus describe and/or navigable; do not invent frameProps fields.",
+  },
   {
     id: "props.data-required-by-usage-mode",
     category: "required-props",

package/ai/dist/mcp-server.js

@@ -7559,6 +7559,15 @@ var require_behaviorContracts = __commonJS({
     ];
     var STATIC_DATA_COMPONENTS = loadStaticDataComponentsFromSchema();
     var BEHAVIOR_CONTRACTS2 = [
+      {
+        id: "accessibility.description-props",
+        category: "accessibility",
+        title: "Accessible chart text uses direct chart props",
+        severity: "warning",
+        appliesTo: {},
+        summary: "High-level charts expose title for the visible name, description for a concise accessible description, summary for a screen-reader-only takeaway and interaction guidance, and accessibleTable for the data-table fallback.",
+        agentAction: "Put title, description, summary, and accessibleTable directly on the chart component when they appear in its schema. For generated L1\u2013L3 description or a navigable chart tree, use ChartContainer with chartConfig plus describe and/or navigable; do not invent frameProps fields."
+      },
       {
         id: "props.data-required-by-usage-mode",
         category: "required-props",
@@ -33769,12 +33778,60 @@ function buildInfoForProfile(profile) {
 function profileResult(result) {
   return { ...result, surfaceVersion: SURFACE_VERSION };
 }
+function schemaAccessibilityGuidance(entry) {
+  const properties = entry?.parameters?.properties ?? {};
+  const directProps = Object.fromEntries(
+    ["title", "description", "summary", "accessibleTable"].filter((name) => properties[name]).map((name) => [name, properties[name]])
+  );
+  return {
+    directProps,
+    chartContainer: {
+      component: "ChartContainer",
+      requires: ["chartConfig"],
+      titleProp: "title",
+      subtitleProp: "subtitle",
+      describeProp: "describe",
+      navigableProp: "navigable",
+      description: "Use ChartContainer with chartConfig plus describe for a generated L1\u2013L3 description and navigable for a screen-reader navigation tree."
+    }
+  };
+}
+function accessibilityRecommendation(component, props, data) {
+  const directProps = schemaAccessibilityGuidance(schemaByComponent[component]).directProps;
+  const recommendation = {};
+  const categoryAccessor = typeof props.categoryAccessor === "string" ? props.categoryAccessor : void 0;
+  const valueAccessor = typeof props.valueAccessor === "string" ? props.valueAccessor : void 0;
+  if (directProps.description && typeof props.description !== "string") {
+    recommendation.description = categoryAccessor && valueAccessor ? `${component} comparing ${valueAccessor} by ${categoryAccessor}.` : `${component} chart.`;
+  }
+  if (directProps.summary && typeof props.summary !== "string") {
+    const numericRows = categoryAccessor && valueAccessor ? data.map((row) => ({ category: row[categoryAccessor], value: row[valueAccessor] })).filter((row) => typeof row.value === "number" && Number.isFinite(row.value)) : [];
+    const highest = numericRows.reduce(
+      (current, row) => !current || row.value > current.value ? row : current,
+      void 0
+    );
+    recommendation.summary = highest ? `${String(highest.category)} is highest at ${highest.value}. Use arrow keys to move between chart marks.` : "Use arrow keys to move between chart marks.";
+  }
+  return Object.keys(recommendation).length > 0 ? {
+    location: "direct-component-props",
+    props: recommendation,
+    chartContainer: schemaAccessibilityGuidance(schemaByComponent[component]).chartContainer
+  } : void 0;
+}
 async function getSchemaHandler(args) {
   const component = args.component;
+  const availableComponents = allComponentNames.map((name) => ({
+    name,
+    renderable: metadataForComponent(name).renderable
+  }));
   if (!component) {
-    const list = allComponentNames.map((name) => metadataForComponent(name).renderable ? `${name} [renderable]` : name);
+    const list = availableComponents.map(
+      ({ name, renderable: renderable2 }) => renderable2 ? `${name} [renderable]` : name
+    );
     return {
-      content: [{ type: "text", text: `Available components (${allComponentNames.length}):
+      content: [{
+        type: "text",
+        text: `Available components (${allComponentNames.length}):
 ${list.join(", ")}
 
 Components marked [renderable] can be rendered to SVG via renderChart (pass theme parameter for styled output). Others (Realtime*) require a browser environment.
@@ -33783,27 +33840,55 @@ For full agent context, read MCP resources: semiotic://schema, semiotic://compon
 
 All charts support CSS custom properties for theming (--semiotic-bg, --semiotic-text, --semiotic-grid, etc.) and <ThemeProvider>. Use COLOR_BLIND_SAFE_CATEGORICAL (import from semiotic/themes) for accessible color palettes.
 
-Pass { component: '<name>' } to get the prop schema for a specific component.` }]
+Pass { component: '<name>' } to get the prop schema for a specific component.`
+      }],
+      structuredContent: profileResult({
+        status: "component-list",
+        availableComponents
+      })
     };
   }
   const entry = schemaByComponent[component];
   if (!entry) {
     const available = Object.keys(schemaByComponent).sort();
     return {
-      content: [{ type: "text", text: `Unknown component "${component}". Available: ${available.join(", ")}` }],
+      content: [{
+        type: "text",
+        text: `Unknown component "${component}". Available: ${available.join(", ")}`
+      }],
+      structuredContent: profileResult({
+        status: "unknown-component",
+        component,
+        availableComponents
+      }),
       isError: true
     };
   }
-  const renderableNote = metadataForComponent(component).renderable ? "This component can be rendered to SVG via renderChart." : "This component requires a browser environment and cannot be rendered via renderChart.";
-  const contracts = behaviorContractsFor({ component, props: {} });
+  const renderable = metadataForComponent(component).renderable;
+  const renderableNote = renderable ? "This component can be rendered to SVG via renderChart." : "This component requires a browser environment and cannot be rendered via renderChart.";
+  const contracts = behaviorContractsFor({
+    component,
+    props: {}
+  });
   const contractText = contracts.length > 0 ? `
 
 Behavior contracts:
 ${JSON.stringify(contracts, null, 2)}` : "";
   return {
-    content: [{ type: "text", text: `${renderableNote}
+    content: [{
+      type: "text",
+      text: `${renderableNote}
 
-${JSON.stringify(entry, null, 2)}${contractText}` }]
+${JSON.stringify(entry, null, 2)}${contractText}`
+    }],
+    structuredContent: profileResult({
+      status: "component-schema",
+      component,
+      renderable,
+      schema: entry,
+      accessibility: schemaAccessibilityGuidance(entry),
+      behaviorContracts: contracts
+    })
   };
 }
 var SUGGEST_INTENT_ALIASES = {
@@ -34645,9 +34730,17 @@ async function improveChartHandler(args) {
   const repair = (0, import_ai3.repairChartConfig)(args.component, data, { intent });
   const capability = (0, import_ai3.getCapability)(args.component);
   const variants = capability ? (0, import_ai3.proposeVariant)(args.component, capability, { profile: (0, import_ai3.profileData)(data), intent }) : [];
+  const accessibility = accessibilityRecommendation(args.component, args.props, data);
   return {
     content: [{ type: "text", text: `Improvement analysis for ${args.component}: ${diagnosis.diagnoses.length} diagnosis item(s), repair status ${repair.status}, ${variants.length} variant proposal(s).` }],
-    structuredContent: profileResult({ status: repair.status === "ok" ? "reviewed" : "repair-needed", component: args.component, diagnostics: diagnosis.diagnoses, repair, variants })
+    structuredContent: profileResult({
+      status: repair.status === "ok" ? "reviewed" : "repair-needed",
+      component: args.component,
+      diagnostics: diagnosis.diagnoses,
+      repair,
+      variants,
+      ...accessibility ? { accessibilityRecommendation: accessibility } : {}
+    })
   };
 }
 async function explainChartHandler(args) {
@@ -34659,8 +34752,8 @@ async function explainChartHandler(args) {
 }
 async function auditChartHandler(args) {
   const diagnosis = (0, import_ai3.diagnoseConfig)(args.component, args.props);
-  const accessibility = (0, import_ai3.auditAccessibility)(args.component, args.props, { inChartContainer: true, describe: true, navigable: true });
-  const mobile = (0, import_ai3.auditMobileVisualization)(args.component, args.props, { viewportWidth: args.viewportWidth, inChartContainer: true });
+  const accessibility = (0, import_ai3.auditAccessibility)(args.component, args.props);
+  const mobile = (0, import_ai3.auditMobileVisualization)(args.component, args.props, { viewportWidth: args.viewportWidth });
   const blocking = diagnosis.diagnoses.some((item) => item.severity === "error") || !accessibility.ok || !mobile.ok;
   return {
     content: [{ type: "text", text: `Audit for ${args.component}: ${blocking ? "blocking findings need attention" : "no blocking findings"}.` }],
@@ -34859,7 +34952,19 @@ function createServer2(profile = "developer", options = {}) {
       title: "Improve an existing chart",
       description: "Diagnose a chart configuration, assess data fit, and propose repairs or variants.",
       inputSchema: { component: external_exports3.string(), props: external_exports3.record(external_exports3.string(), external_exports3.unknown()), data: external_exports3.array(external_exports3.record(external_exports3.string(), external_exports3.unknown())).optional(), intent: external_exports3.union([external_exports3.string(), external_exports3.array(external_exports3.string())]).optional() },
-      outputSchema: { status: external_exports3.enum(["reviewed", "repair-needed"]), component: external_exports3.string(), surfaceVersion: external_exports3.string() },
+      outputSchema: {
+        status: external_exports3.enum(["reviewed", "repair-needed"]),
+        component: external_exports3.string(),
+        diagnostics: external_exports3.array(external_exports3.unknown()),
+        repair: external_exports3.record(external_exports3.string(), external_exports3.unknown()),
+        variants: external_exports3.array(external_exports3.unknown()),
+        accessibilityRecommendation: external_exports3.object({
+          location: external_exports3.literal("direct-component-props"),
+          props: external_exports3.record(external_exports3.string(), external_exports3.string()),
+          chartContainer: external_exports3.record(external_exports3.string(), external_exports3.unknown())
+        }).optional(),
+        surfaceVersion: external_exports3.string()
+      },
       annotations: READ_ONLY_TOOL_ANNOTATIONS
     }, improveChartHandler);
     srv.registerTool("explainChart", {
@@ -34879,7 +34984,31 @@ function createServer2(profile = "developer", options = {}) {
     srv.registerTool("getChartSchema", {
       title: "Get a chart schema",
       description: "Return canonical Semiotic prop-schema guidance for code editing and advanced configuration.",
-      inputSchema: { component: external_exports3.string().optional() },
+      inputSchema: {
+        component: external_exports3.string().optional()
+      },
+      outputSchema: {
+        status: external_exports3.enum([
+          "component-list",
+          "component-schema",
+          "unknown-component"
+        ]),
+        component: external_exports3.string().optional(),
+        renderable: external_exports3.boolean().optional(),
+        availableComponents: external_exports3.array(
+          external_exports3.object({
+            name: external_exports3.string(),
+            renderable: external_exports3.boolean()
+          })
+        ).optional(),
+        schema: external_exports3.record(external_exports3.string(), external_exports3.unknown()).optional(),
+        accessibility: external_exports3.object({
+          directProps: external_exports3.record(external_exports3.string(), external_exports3.unknown()),
+          chartContainer: external_exports3.record(external_exports3.string(), external_exports3.unknown())
+        }).optional(),
+        behaviorContracts: external_exports3.array(external_exports3.unknown()).optional(),
+        surfaceVersion: external_exports3.string()
+      },
       annotations: READ_ONLY_TOOL_ANNOTATIONS
     }, getSchemaHandler);
     return srv;