Ein Diagramm erstellen.
Seine Darstellung prüfen.
Funktionierende Beispiele, genaue Optionsfehler und ein lesbares Modell des gezeichneten Diagramms. Geben Sie Ihrem Agenten die Möglichkeit, seine Arbeit von der ersten Konfiguration bis zu den endgültigen Werten zu prüfen.
Nutzen Sie Markdown, Repository-Anweisungen, eine Shell oder MCP mit den Werkzeugen Ihrer Wahl.
Optionen validieren
Genauen Pfad, Problem und Korrekturvorschlag erhalten.
WestCoastCharts.validate(options)Diagramm zeichnen
Dieselbe Konfiguration in Ihrer Anwendung verwenden.
await chart.render()Gezeichneten Zustand lesen
Werte, Skalen und unterstützte Aggregate untersuchen.
chart.describe()Einen Optionsfehler vor dem Zeichnen erkennen.
Die folgende Konfiguration verwendet legend.enabled. Führen Sie den Bibliotheksvalidator aus, übernehmen Sie seine Korrektur und untersuchen Sie anschließend das gezeichnete Diagramm.
Läuft in Ihrem Browser mit Bibliothek 1.1.5. Drei illustrative Werte; kein MCP-Server wird aufgerufen.
chart: { type: 'bar' },
series: [{ name: 'Requests', data: [12, 19, 7] }],
legend: { enabled: false }Bereit zur Validierung.
Zurückgegebenes Modell lesen
Entdecken, validieren, zeichnen, beschreiben.
Sieben Werkzeuge decken Erkundung, Validierung, Zeichnen und Auswertung ab. Beginnen Sie mit einem unterstützten Beispiel, korrigieren Sie die Konfiguration und prüfen Sie die tatsächlich gezeichneten Werte.
Public agent tools 0.2.3, tested with Library 1.1.5; available from the versioned GitHub release and npm. Browser examples use Library 1.1.5. Versionen und Grenzen vergleichen ↓
Premium-Kunden und Testnutzer können ihre Agenten mit denselben Werkzeugen verbinden, indem sie die privat heruntergeladene vollständige Library und ihren Lizenzschlüssel verwenden. Premium für Ihre Agenten einrichten →
npm install west-coast-charts@1.1.5
npm install west-coast-charts-agent@0.2.3
npx --no-install wcc --version
npx --no-install wcc-mcp --version- 01
Entdecken
list_chart_types · list_examples · get_example · get_schemaUnterstützten Typ wählen, Ausgangskonfiguration abrufen und nur den benötigten Schemapfad anfordern.
- 02
Validieren
validate_chartFehler und Warnungen lesen, Hinweise anwenden und erneut validieren, bis ok gleich true ist. Eine Validierung bestätigt nicht die fachliche Aussage der Daten.
- 03
Zeichnen
render_chartSVG oder PNG mit Prüftabelle ausgeben. Nutzen Sie delivery: "link", wenn die Bilddaten nicht im Modellkontext benötigt werden.
- 04
Beschreiben
describe_chartGezeichnete Werte als JSON oder Markdown lesen. Prüfen Sie Einheiten, Aggregationsfunktionen, ausgeblendete Reihen und tableSource, bevor Sie Aussagen ableiten.
MCP-Validierungsaufruf und Antwort untersuchen
Beispielanfrage und ausgewählte Antwortfelder, anhand des Werkzeugvertrags geprüft. Diese Seite führt den Aufruf nicht aus. Die aktuellen Werkzeuge benötigen den echten e1-Validator; ein fehlendes Modul führt zu einem ausdrücklichen Fehler.
{
"name": "validate_chart",
"arguments": {
"spec": {
"chart": {
"type": "bar"
},
"series": [
{
"name": "Revenue",
"data": [
12,
19,
7
]
}
],
"legend": {
"enabled": false
}
}
}
}{
"structuredContent": {
"ok": false,
"validator": "e1",
"errors": [
{
"kind": "unknown_option",
"path": "legend.enabled",
"pointer": "/legend/enabled",
"suggestion": "legend.show",
"fix": {
"op": "rename",
"from": "legend.enabled",
"to": "legend.show"
}
}
],
"warnings": []
}
}Ergebnisherkunft lesen und Validierung von Werkzeugfehlern unterscheiden
Die Herkunft eines Ergebnisses kennen.
render_chart und describe_chart geben das Auswertungsmodell zurück in structuredContent.table. Das zugehörige Feld tableSource must be describe in den aktuellen Werkzeugen sein. Das echte Beschreibungsmodul der Library ist erforderlich; fehlende Module führen zu einem ausdrücklichen Fehler. Stub- oder null-Ausgaben eines älteren Servers sind keine vollständige Prüfung.
Prüfen Sie structuredContent.table.table.total, structuredContent.table.table.truncated, Einheiten und jede Aggregationsfunktion. Vollständige Modelle können weiterhin nicht unterstützte oder leere Felder enthalten. Perzentile, Raten und Bewertungen lassen sich nicht einfach summieren.
Ungültige Optionen von Werkzeugfehlern trennen.
validate_chart mit Rückgabe ok: false ist ein normales Ergebnis. Das Feld validator -Feld muss den echten e1 -Validator ausweisen. Die aktuellen Werkzeuge melden einen ausdrücklichen Fehler, wenn er fehlt. Der Validator prüft weder die fachliche Bedeutung der Daten noch einen Premium-Schlüssel.
Fehler verwenden isError: true. Der JSON-Umschlag {error:{kind,message,hint,details}} im zweiten Textblock von content, nicht in structuredContent. Folgen Sie dem Hinweis und validieren Sie erneut.
Ressourcen, Prompts, Transport und Ausführungsgrenzen
Agent-Werkzeuge 0.2.3 unterstützen Library 1.1.5. Die CLI- und MCP-Anleitungen nennen geprüfte Module, das Laden optionaler Premium-Runtimes und bekannte Grenzen ohne Browser. Prüfen Sie die tatsächlich geladene Runtime; eine Browser-Vorschau belegt keine Headless-Unterstützung.
Lesen Sie wcc://docs/agent-quickstart, entdecken Sie die aufgeführten wcc://docs/{slug} Ressourcen und prüfen Sie wcc://version für die tatsächlichen Versionen von Server, Render-Core, Bibliothek und Schriften. wcc://errors liefert Fehlerhinweise. Die letzten 32 Darstellungen sind verfügbar über wcc://renders/{id}.
Die build_dashboard und pick_chart_type Prompts bieten wiederverwendbare Abläufe. Nutzen Sie Schemaausschnitte, paginierte Beispiele und delivery: "link" für einen kleinen Modellkontext. Verbindungen sind über stdio oder Streamable HTTP möglich, optional mit konfigurierter Bearer-/OAuth-Authentifizierung.
Die sieben Diagrammwerkzeuge berechnen Ergebnisse ohne Dateischreibzugriffe und ohne ausgehende Anfragen für Diagrammdaten. Konfigurationen sind JSON ohne Formatter-Funktionen. Konfigurierte HTTP-Authentifizierung kann JWKS abrufen; Netzwerkzugriffe sind also nicht generell ausgeschlossen. Grenzen für Breite, Höhe, Skalierung und Pixelzahl gelten.
CLI chart export und skills install schreiben Dateien. Ihre Überschreib- und Bestätigungsoptionen sind gesondert dokumentiert. Diese Seite betreibt keinen MCP-Server und führt diese Beispiele nicht aus.
Premium-Schlüssel und maschinenlesbare Lizenzfehler
Headless-Darstellung mit Premium benötigt einen konfigurierten Lizenzschlüssel oder einen ausdrücklichen Evaluierungsmodus mit „unlicensed“-Wasserzeichen. Schlüsselfreie localhost-Darstellung im Browser bedeutet nicht, dass Headless-Werkzeuge Lizenzen umgehen. Bewahren Sie Schlüssel in der Serverkonfiguration oder im dokumentierten HTTP-Header auf, nicht in geteilten Konfigurationen.
Fehlende oder abgelehnte Schlüssel erzeugen kind: "license" mit details.reason gleich license_required oder license_invalid. Die CLI-Referenz dokumentiert die Priorität der Schlüsselquellen und Exit-Codes. Die Verfügbarkeit der 30-Tage-Testlizenz umfasst alle 13 Familien einschließlich Quint, Vitals Clock und Practice Schedule. Starten Sie den Test auf der Preisseite. Diese Beispiele selbst stellen keinen Schlüssel aus und starten keinen Testzeitraum.
Ein zuverlässiger Ausgangspunkt für Ihren Agenten.
Ein Regelwerk. Nutzen Sie die reine Markdown-Version oder ein optionales editorspezifisches Format.
Repository-Anweisungen
AGENTS.mdPrüfen und in vorhandene Anweisungen übernehmen. Für Agenten, die AGENTS.md lesen, oder als Textkontext nutzbar.HerunterladenCopilot-Anweisungen
.github/copilot-instructions.mdOptionales Format für GitHub Copilot. Mit bestehenden Projektanweisungen zusammenführen.HerunterladenCursor-Regel
.cursor/rules/westcoast-charts.mdcOptionales .mdc-Format für Cursor-Projekte. Vor dem Hinzufügen den Dateigeltungsbereich prüfen.Herunterladencurl -fsSL https://westcoast-charts.com/agents/AGENTS.md -o westcoast-charts.instructions.md
# Review, then merge the relevant rules into your project instructions.Vollständiges Regelwerk lesen
## WestCoast Charts
WestCoast Charts (1.1.5, release, public Core release, on npm) is an ApexCharts-4.x-compatible charting library. Docs for agents: https://westcoast-charts.com/llms.txt
- Install the current MIT Core with `npm install west-coast-charts@1.1.5`. Alternative versioned archives and checksums: https://westcoast-charts.com/download/index.md. Import the default export: `import WestCoastCharts from 'west-coast-charts'`. Do not import from `apexcharts`.
- Create charts with `const chart = new WestCoastCharts(element, options)` and `await chart.render()`; call `chart.destroy()` when the element is removed (React effect cleanup, Vue `onBeforeUnmount`, Svelte `onDestroy`, Angular `ngOnDestroy`).
- Options use the ApexCharts 4.x format. Before using an option you are not sure about, look it up in https://westcoast-charts.com/docs/reference/options/index.md (premium types: https://westcoast-charts.com/docs/reference/premium-options/index.md). Never guess option names.
- Extra MIT chart types (gauge, funnel, waterfall, sunburst, ...): `import types from 'west-coast-charts/types'` and `WestCoastCharts.use(types)`, or import one type, e.g. `'west-coast-charts/types/gauge'`.
- Premium types (sankey, chord, gantt, tree, stock, map, marimekko, network, radialColumn, quintTimeline, quintConvergence, vitalsClock, schedule): `import premium from 'west-coast-charts/premium'`, `WestCoastCharts.use(premium)`, and `WestCoastCharts.setLicenseKey(key)` read from configuration, never hard-coded. Localhost evaluation needs no key. The Free Core and MIT-marked source remain under their stated MIT licence; Premium distribution, updates and support have separate business terms. See https://westcoast-charts.com/maintenance/#licensing and https://westcoast-charts.com/terms/.
- Quint types (`quintTimeline`, `quintConvergence`) also use the separate module: `import quint from 'west-coast-charts/layers/quint'` and `WestCoastCharts.use(quint)`. It is not part of the Premium bundle. Read https://westcoast-charts.com/docs/quint/index.md for lanes, units and the labelled time-axis lens.
- If `render()` rejects naming a missing import, add that import; do not switch to another chart type.
- Medical/practice types require explicit modules in addition to Premium: `west-coast-charts/layers/vitals` for `vitalsClock`, and `west-coast-charts/layers/schedule` for `schedule`. They are not autoloaded. Bands, alarms and scores come from the caller; the library supplies no clinical thresholds or clinical score/alarm logic. Schedule changes are proposals; the caller decides and updates the model. Read https://westcoast-charts.com/docs/medical/index.md.
- Orient is optional MIT: import and register `west-coast-charts/features/orient` with the core runtime before creating the chart. /full already includes it. Supported types and limits: https://westcoast-charts.com/docs/features/orient/index.md. It is not a Premium family; check the current headless module matrix before using it through CLI or MCP.
- Update data with `chart.updateSeries(series)` or `chart.updateOptions(options)` instead of re-creating the chart.
- For machine-readable validation, load `west-coast-charts/agent/validate`, use `WestCoastCharts.validate(options)`, inspect `issues`, apply suggested fixes with `WestCoastCharts.applyFixes(options, issues)` and validate again.
- Load `west-coast-charts/agent/describe` and call `chart.describe({format: "json"})` after rendering for values, aggregates, scales, filters and table from the actual drawn state. Do not sum non-additive measures.
- Inspect `schemaVersion` and the options schema https://westcoast-charts.com/wcc/schema/wcc-options.schema.json. Result schema: https://westcoast-charts.com/wcc/schema/wcc-describe.schema.json. Respect missing/null fields and table truncation; never infer unavailable aggregates from a stub result.
- With MCP, discover available types/examples and narrow schema paths before validating, rendering and describing. Require `validator: "e1"` and `tableSource: "describe"` for the current tools; absent providers must fail explicitly rather than silently substituting stubs. Public agent tools 0.2.3, tested with Library 1.1.5; available from the versioned GitHub release and npm. Verify the resolved runtime and current module support before using Quint, Orient, vitalsClock or schedule. Tool errors use `isError` and a JSON envelope in the second text content block. See https://westcoast-charts.com/agents/index.md.
- Headless Premium rendering requires a configured key or explicit evaluation mode; browser localhost behaviour does not remove this requirement. Keep licence keys out of shared specs. The seven MCP tools do not write files; CLI export and skills-install commands do.
- For a working starting point, copy a gallery example: https://westcoast-charts.com/gallery/index.md (every entry has its full options).
Die passende Schnittstelle für Ihren Ablauf.
Nutzen Sie den Browser-Ablauf direkt oder installieren Sie CLI und MCP aus dem versionierten öffentlichen Release. Die Werkzeuge laden die installierte Library; prüfen Sie vor dem Rendern deren gemeldete Version und Modulunterstützung.
Strukturierte Optionsvalidierung
Browser · 1.1.5Schemaversion, Problemtyp, Schweregrad, Punktpfad, JSON Pointer, Vorschläge und maschinell anwendbare Korrekturen. applyFixes() liefert eine korrigierte Kopie; validieren Sie sie vor dem Zeichnen erneut.
chart.describe()
Browser · 1.1.5JSON, Tabelle oder Markdown aus dem gezeichneten Zustand: Werte, Einheiten, Aggregationsfunktionen, Skalenbereiche, Extremwerte, Filter und ausgeblendete Reihen, soweit unterstützt. Felder können null sein; beachten Sie table.total und table.truncated.
Options- und Ergebnisschemas
Maschinenlesbare VerträgeDas Optionsschema enthält x-wcc-version. Das separate Ergebnisschema wcc-describe/1 definiert das Auswertungsmodell. MCP get_schema unterstützt eng begrenzte Punktpfade und Tiefenlimits.
Importe und funktionierende Beispiele
Browser · 1.1.5Jede Galerieseite enthält Konfiguration und Importanleitung. Validierung, describe(), Funktionen und Ebenen sind optionale Module; Quint benötigt zusätzlich zu Premium layers/quint.
Vital- und Planungsmodule
Browsermodule · 1.1.5Explizite Importe von layers/vitals und layers/schedule ergänzen vitalsClock und schedule. Schedule-Helfer berechnen Konflikte, Auslastung und Patientenfluss-Zusammenfassungen ohne Diagramm; dies sind Modul-APIs und keine zusätzlichen MCP-Werkzeuge. Verwenden Sie für das Rendern ohne Browser die aktuelle Modulübersicht und eine ausdrücklich installierte vollständige Premium-Runtime.
Radiale Ansichten mit Orient drehen
Optionale MIT-Funktion · 1.1.5Drehen Sie eine unterstützte radiale Ansicht, ohne die Daten zu ändern. Laden Sie features/orient mit dem Core; /full enthält es bereits. Die Orientierung erscheint im zugänglichen Text und in chart.describe(), wenn das Modul geladen ist. Prüfen Sie die aktuelle Headless-Modulübersicht; Orient beschreibt die Ausrichtung und keine geänderten Datenwerte.
Kommandozeile ohne Browser
Agent tools · 0.2.3wcc validates, renders SVG/PNG, exports files and prints verification tables. Public agent tools 0.2.3, tested with Library 1.1.5; available from the versioned GitHub release and npm. Check the resolved library version, validator and tableSource before relying on inspection.
MCP-Server
Agent tools · 0.2.3Seven tools, Markdown resources, version discovery and two reusable prompts over stdio or Streamable HTTP. Public agent tools 0.2.3, tested with Library 1.1.5; available from the versioned GitHub release and npm.
Browserablauf: validieren → korrigieren → zeichnen → auswerten
Library 1.1.5, using optional modules from the public MIT Core package. This example expects a #chart Element. Es ist eine kopierbare Anleitung; diese Seite führt sie nicht aus.
Der Validator benennt genaue Optionspfade und JSON Pointer. Prüfen Sie Korrekturen, validieren Sie die korrigierte Kopie und lesen Sie anschließend JSON oder Markdown aus dem Diagramm. Das Agent Lab führt den interaktiven Browserablauf aus.
import WestCoastCharts from 'west-coast-charts'
import validatorPlugin from 'west-coast-charts/agent/validate'
import describePlugin from 'west-coast-charts/agent/describe'
WestCoastCharts.use(validatorPlugin).use(describePlugin)
const options = {
chart: { type: 'bar' },
series: [{ name: 'Revenue', data: [12, 19, 7] }],
xaxis: { categories: ['Q1', 'Q2', 'Q3'] },
}
const report = WestCoastCharts.validate(options)
const fixed = WestCoastCharts.applyFixes(options, report.issues)
if (!WestCoastCharts.validate(fixed).ok) throw new Error('Resolve remaining option issues')
const chart = new WestCoastCharts(document.querySelector('#chart'), fixed)
await chart.render()
const model = chart.describe({ format: 'json' })
const markdown = chart.describe({ format: 'markdown' })Vitals Clock und Practice Schedule: explizite Modulimporte
Vitals Clock zeigt Messwerte in Zeitfenstern, unterscheidet fehlende Messungen von null und nennt das Alter der letzten Werte. Practice Schedule zeigt Räume, Personen und Termine; Verschieben und Größenänderungen erzeugen Vorschläge, die der Aufrufer bestätigen und neu zeichnen muss. Bereiche, Alarme und Bewertungen stammen aus der aufrufenden Anwendung. Die Bibliothek liefert keine klinischen Schwellenwerte und trifft keine klinischen Bewertungs- oder Alarmentscheidungen. Die Originalbeispiele verwenden erfundene Demodaten und Schwellenwerte.
Diese separaten Premium-Typmodule werden nicht automatisch geladen. Registrieren Sie die benötigten Module vor dem Erstellen des Diagramms. Bei Script-Tags zuerst Core und Premium laden, danach dist/layers/vitals.min.js oder dist/layers/schedule.min.js.
Das Planungsmodul bietet eigenständige conflicts(), utilization(), utilizationSeries() und flow.fromEvents() -Helfer. Dies sind Library-APIs und keine zusätzlichen MCP-Werkzeuge. Patientenfluss-Zusammenfassungen behalten Median-/P90-Wartezeiten bei. Die Verwendung ohne Browser erfordert die separat gelieferte vollständige Premium-Runtime und die aktuellen Agent-Werkzeuge. Beachten Sie die geprüfte Modulübersicht in der Anleitung.
Datenverträge und Hilfs-APIs lesen · Originaldemos entdecken
import WestCoastCharts from 'west-coast-charts'
import premium from 'west-coast-charts/premium'
import vitals from 'west-coast-charts/layers/vitals'
import schedule from 'west-coast-charts/layers/schedule'
WestCoastCharts.use([premium, vitals, schedule])
// Load only the type modules your application uses.
// Neither vitalsClock nor schedule is autoloaded.Optionale MIT-Funktion: eine radiale Ansicht ausrichten
Orient ist eine optionale MIT-Funktion für pie, donut, polarArea, radialBar, Premium chord und radialColumn mit Ebenen. Die Ansicht dreht sich bei aufrechten Beschriftungen und unveränderten Datenwerten. Die Ausrichtung bleibt nach Datenupdates und Größenänderungen erhalten und wirkt bei geladenen Funktionen in Perspektiven, Verlauf und Freigabelinks mit. Reduzierte Bewegung oder animate: false überspringt den Übergang. Andere Diagrammtypen werden nicht unterstützt; es gibt keine 3D-Neigung oder frei wählbare Ziehwinkel.
Der einfache Core bleibt schlank: Laden Sie diese Funktion nur bei Bedarf. Der /full Einstiegspunkt installiert sie bereits. Bei Script-Tags laden Sie dist/west-coast-charts.min.js, danach dist/features/runtime.min.js, danach dist/features/orient.min.js, in dieser Reihenfolge vor dem Initialisieren des Diagramms. Der folgende ESM-Import lädt runtime.esm.js über seine eigene Abhängigkeit; kein zusätzlicher Runtime-Import ist erforderlich. Diese Browseranleitung erwartet ein #chart element and the public MIT Core 1.1.5 package; it is not executed on this page.
Orient-API und Steuerung lesen · Originalbeispiele für Orient ausprobieren
import WestCoastCharts from 'west-coast-charts'
import orient from 'west-coast-charts/features/orient'
WestCoastCharts.use(orient)
const chart = new WestCoastCharts(document.querySelector('#chart'), {
chart: { type: 'donut', orient: { enabled: true } },
labels: ['Direct', 'Search', 'Referral'],
series: [44, 35, 21],
})
await chart.render()
await chart.orient.rotateTo('Search', 'top', { animate: false })
const orientation = chart.orient.get()
const description = chart.orient.describe()
// await chart.orient.reset()Codex, Claude Code, Hermes, Cursor oder Copilot nutzen
Wählen Sie die Fähigkeiten Ihrer Einrichtung: Markdown lesen, Repository-Anweisungen, Shell-Befehle oder MCP-Verbindung. Dies sind verfügbare Schnittstellen und Dokumentationen, keine pauschale Zusage getesteter Kompatibilität mit jedem Client und jeder Version.
- Codex: Nutzen Sie AGENTS.md, wenn Ihre Einrichtung Repository-Anweisungen liest.
- Claude Code: die MCP-Anleitung enthält ein Beispiel für die stdio-Konfiguration.
- Hermes: Stellen Sie den Markdown-Kontext über Ihren konfigurierten Client bereit. Hier ist kein Hermes-spezifischer Adapter bestätigt.
- Cursor: eine optionale .mdc-Regel und ein MCP-Konfigurationsbeispiel stehen bereit.
- Copilot: eine optionale Datei .github/copilot-instructions.md steht bereit.
Cursor-Nutzer können außerdem https://westcoast-charts.com/docs/ hinzufügen über @Docs. Die Einzeldatei-Alternative ist https://westcoast-charts.com/llms-full.txt.
Nur den benötigten Kontext lesen.
https://westcoast-charts.com/llms.txtHier beginnen. Kompakt; verlinkt die Markdown-Version jeder wichtigen Seite.Follow the explicit index.md linkz. B. https://westcoast-charts.com/docs/getting-started/index.md. Originalbeispiele und einige rechtliche Seiten stehen nur als HTML bereit.Accept: text/markdownSeiten mit einer veröffentlichten Markdown-Fassung liefern diese mit Vary: Accept zurück; andernfalls lesen Sie das HTML.rel="alternate" type="text/markdown", rel="describedby"Redaktionelle Seiten mit einer Markdown-Fassung verlinken diese im Seitenkopf. Folgen Sie dieser URL, statt eine Adresse zu erraten.https://westcoast-charts.com/docs/sitemap.mdAlle Dokumentations- und Galerieseiten in einer Liste.https://westcoast-charts.com/llms-full.txtOptional für Clients, die eine einzelne Dokument-URL lesen.curl -H 'Accept: text/markdown' https://westcoast-charts.com/docs/getting-started/
# Or read the explicit Markdown URL:
curl https://westcoast-charts.com/docs/getting-started/index.mdNutzungssignal für automatisierte Clients: Content-Signal: search=yes, ai-input=yes (robots.txt und HTTP-Header).