Semiotic

Get usage instructions for a named Semiotic theme preset. Returns ThemeProvider examples, CSS custom properties, and design token export patterns. Available themes: light, dark, high-contrast, pastels, pastels-dark, bi-tool, bi-tool-dark, italian, italian-dark, tufte, tufte-dark, journalist, journalist-dark, playful, playful-dark, carbon, carbon-dark.

Audit a Semiotic chart configuration against the Chartability (POUR-CAF) accessibility framework — Perceivable, Operable, Understandable, Robust, Compromising, Assistive, Flexible. Statically grades the config (no DOM/AT): credits the built-ins every HOC ships (keyboard nav, focus ring, skip link, screen-reader data table, reduced-motion + forced-colors, shareable state), flags author-actionable gaps (missing title/description/summary, low contrast, small text, color-only encoding, undescribed trends, data density), and routes everything that needs real assistive-technology testing to a 'manual' item. Returns a per-principle report with the 14 critical heuristics marked. Pass inChartContainer=true to credit data-download/share affordances. Pair with manual NVDA/JAWS/VoiceOver testing — Chartability is not a pass/fail certification.

Evaluate a chart and its explicit artifact contract under a named policy. The tool audits only supplied claims, evidence, source identity, review state, and time state; missing facts remain missing or unknown. Results are capped and report truncation explicitly.

Audit a Semiotic chart configuration for mobile visualization risks. Use before generating phone-sized charts or when adapting a desktop chart to mobile. Flags fixed desktop widths, rough mark-density overload, hover-only detail, small touch targets, complex gestures without controls, legend dependence, annotation overload, and missing mobile transformation hints. Static analysis only: still verify rendered charts at phone widths.

Diagnose a Semiotic chart configuration for common problems (empty data, bad dimensions, missing accessors, wrong data shape, color contrast issues, etc). Pass usageMode='push' for ref-based React HOCs that intentionally omit data; omit usageMode or pass 'static' for renderChart/MCP/server configs where data is required. Checks WCAG color contrast ratios and suggests COLOR_BLIND_SAFE_CATEGORICAL for accessibility. Returns a human-readable diagnostic report with actionable fixes.

Evaluate a Semiotic chart through one deterministic quality pass: numeric data contracts, configuration and representation/deception checks, and static Chartability accessibility heuristics. Returns the independent audit reports plus a severity-ranked findings list and notification feed. Pass data separately when it should override props.data; use inChartContainer, describe, or navigable to describe the intended accessibility wrapper. This is static analysis and does not replace manual assistive-technology testing or render evidence.

Evaluate an explicit artifact contract under a named policy and explain why publication or action is refused. Missing evidence, source, review, and time facts stay explicit rather than being guessed.

Return the prop schema for a Semiotic chart component. Pass { component: '<name>' } to get its props, or omit component to list all available components. Components marked [renderable] can be passed to renderChart for static SVG output.

Build the agent-reader grounding payload for a Semiotic chart: the layered L1–L3 natural-language description, the L4 communicative-act sentence (what the chart is asking the reader to do), and a structured navigation tree (chart → axes/series → datum). Use this to interpret a chart faithfully without pixels.

Conversational interrogation of a Semiotic chart. Extract a statistical summary and answer natural language questions about the data, trends, and outliers. Returns a summary and guidance for an AI to generate a textual answer and visual annotations.

Propose and score chart variants for a selected Semiotic component. Uses the capability registry plus heuristic variant discovery: registered variants, conservative transforms, and same-intent cross-family alternatives. Returns ranked proposals with fit/novelty/risk scores, rationale, and ready-to-use props. Use after suggestCharts when an agent wants to actively explore variants rather than stop at the first chart recommendation.

Recommend chart and non-chart outcomes from explicit data and an explicit artifact contract. Evidence, source, review, and time facts are never synthesized. The named policy can recommend waiting, collecting data, or making no claim instead of forcing a chart.

Render a Semiotic chart to static SVG or PNG. This is a static snapshot path: props must include data immediately, and ref/push-mode charts cannot be rendered through this tool. Returns SVG text by default or an image/png artifact when format='png', plus a "Render evidence" JSON block (mark counts by type, resolved axis domains, empty flag, annotation count, accessible name) — read the evidence instead of parsing the SVG to verify the chart actually rendered data marks. An optional explicit contract is preserved in render evidence together with its transfer status; missing contract facts are not inferred. Optionally pass theme CSS custom properties (--semiotic-bg, --semiotic-text, etc.) to style the output. PNG requires the 'sharp' package to be installed. Available components: AreaChart, BarChart, BigNumber, BoxPlot, BubbleChart, BumpChart, CalendarHeatmapRecipe, CandlestickChart, ChainReactionChart, ChordDiagram, ChoroplethMap, CirclePack, CollisionSwarmChart, ConnectedScatterplot, CrucibleChart, DependencyForestChart, DifferenceChart, DistanceCartogram, DonutChart, DotPlot, EventDropChart, FlowCircuitChart, FlowMap, ForceDirectedGraph, FunnelChart, GaltonBoardChart, GaugeChart, GauntletChart, GroupedBarChart, Heatmap, Histogram, LikertChart, LineChart, MinimapChart, MotifBraidChart, MultiAxisLineChart, OrbitDiagram, PacketFlowChart, ParallelCoordinatesRecipe, PieChart, ProcessFlowChart, ProcessSankey, ProportionalSymbolMap, QuadrantChart, RadarChart, RidgelinePlot, SankeyDiagram, Scatterplot, ScatterplotMatrix, StackedAreaChart, StackedBarChart, SwarmPlot, SwimlaneChart, TemporalHistogram, TreeDiagram, Treemap, UnitPileChart, ViolinPlot, WaterfallChart.

Render a static-data Semiotic chart as a ChatGPT Apps widget. Use this after suggestCharts/getSchema/diagnoseConfig when the user wants to see an interactive chart inside ChatGPT. The server renders Semiotic to SVG and the widget adds fit, zoom, data, hover, and render-evidence controls. Available components: AreaChart, BarChart, BigNumber, BoxPlot, BubbleChart, BumpChart, CalendarHeatmapRecipe, CandlestickChart, ChainReactionChart, ChordDiagram, ChoroplethMap, CirclePack, CollisionSwarmChart, ConnectedScatterplot, CrucibleChart, DependencyForestChart, DifferenceChart, DistanceCartogram, DonutChart, DotPlot, EventDropChart, FlowCircuitChart, FlowMap, ForceDirectedGraph, FunnelChart, GaltonBoardChart, GaugeChart, GauntletChart, GroupedBarChart, Heatmap, Histogram, LikertChart, LineChart, MinimapChart, MotifBraidChart, MultiAxisLineChart, OrbitDiagram, PacketFlowChart, ParallelCoordinatesRecipe, PieChart, ProcessFlowChart, ProcessSankey, ProportionalSymbolMap, QuadrantChart, RadarChart, RidgelinePlot, SankeyDiagram, Scatterplot, ScatterplotMatrix, StackedAreaChart, StackedBarChart, SwarmPlot, SwimlaneChart, TemporalHistogram, TreeDiagram, Treemap, UnitPileChart, ViolinPlot, WaterfallChart.

Propose repairs for a chart and explicit artifact contract. By default this is proposal-only. If enabled, safe application fills missing component and configuration/data identity fields only; existing bindings are never overwritten. Mismatches require an explicit revision and claim reassessment. Source, evidence, review, approval, and time facts are never invented. Returned contracts omit evidence samples, report transfer losses, and are withheld above a 64 KiB UTF-8 cap.

Validate that a chart component is a sensible choice for a dataset, and if not, propose ranked alternatives that fit. Returns a structured status of ok, alternative, or unknown.

Generate a GitHub issue URL for Semiotic bug reports or feature requests. Returns a URL the user can open to submit. For rendering bugs, include the component name, props summary, and any diagnoseConfig output in the body.

Lightweight heuristic chart recommender for a small data sample (1-5 rows) with capability filtering (push API, linked hover, SSR, selection, legend). Returns ranked recommendations with example props. For richer capability-descriptor ranking (scores, reasons, caveats) and the full 13-intent taxonomy, prefer `suggestCharts` (plural).

Recommend Semiotic charts for a dataset using heuristic capability descriptors. Returns ranked, structured suggestions with scores, reasons, caveats, and ready-to-use props; no LLM call is made.

Generate a dashboard of complementary chart panels for a dataset — each panel answers a distinct analytical intent (trend, rank, distribution, correlation, etc.) and the engine diversifies by chart family by default. Heuristic only; no LLM call. Use when the user asks 'show me this data' or 'build me a dashboard' rather than picking one chart.

Recommend streaming Semiotic charts for a schema (not row data). Pass fields (with optional cardinality and additive hints) plus optional throughput (band or rows/sec), retention, shape ('append'|'keyed'|'aggregate'), and keyFields. Ranks realtime XY charts plus push-capable ordinal/value/xy charts (BarChart, PieChart, Scatterplot, BigNumber, GaugeChart, …). Returns suggestions, excluded fits-reasons, the ranking intents (inferred when none is given), schema warnings, and optional stretch picks when audience is set.

Compose a multi-panel dashboard from one or more stream schemas. Honors AudienceProfile.dashboard layout policy (cellBudget, leadFamilies, windowPreference).

Recommend literacy-growth chart picks for a dataset given an AudienceProfile. Returns charts the data supports but the audience is unfamiliar with (familiarity ≤ 3, or ≤ 4 at exposureLevel 2), each paired with the familiar chart it could substitute for and a rationale. Use when the consumer wants to gently expose users to less familiar but more analytically appropriate visualizations.

Recommend a semantic token / ISOTYPE encoding for a reader task. Use before drawing repeated dots, icons, glyphs, natural-frequency grids, quantile dotplots, or hybrid bar-token views. Returns the recommended tokenEncoding, warnings, alternatives, and matching suggestCharts capability intents. Accepts canonical token intents (precise-comparison, probability-estimation, risk-communication, memory, support-decision, etc.) and friendly aliases (measure, estimate probability, understand risk, remember, decide).