# WestCoast Charts

> WestCoast Charts is a JavaScript charting library by West Coast Software, derived from MIT-licensed ApexCharts 4.7.0 with documented differences in theme, accessibility, escaping and validation defaults. The Free Core and MIT-marked source remain under their stated MIT licence. Premium distribution, updates and support have separate business terms. Public-host Premium previews without a key display an unlicensed notice; a licence key is not a substitute for the applicable terms. See https://westcoast-charts.com/maintenance/#licensing and https://westcoast-charts.com/terms/.

Status: version 1.1.5, release, public Core release, on npm. ApexCharts is a trademark of its respective owner; WestCoast Charts is an independent project and not affiliated with, endorsed or sponsored by ApexCharts.

## Public Core distribution

- [Public Core repository](https://github.com/Lokumbus/west-coast-charts-core) and [versioned package](https://github.com/Lokumbus/west-coast-charts-core/releases/download/v1.1.5/west-coast-charts-1.1.5.tgz). MIT; no account or key required. Premium runtimes are excluded.
- Install from npm:

```sh
npm install west-coast-charts@1.1.5
```

- Archive SHA-256: `c4a4fdfebe81f29ad27b6e583e3a343e79e93633f54208f0c26a6d586a577dcc`.
- [Pinned browser CDN bundle](https://cdn.jsdelivr.net/npm/west-coast-charts@1.1.5/dist/west-coast-charts.full.min.js). Load it as a script tag, without a bundler. Use the release tag, not an unversioned latest URL.
- Core includes optional `agent/validate`, `agent/describe` and versioned JSON schemas. Install and register these modules explicitly when using the lean Core entry.
- A cloud workspace restricted to GitHub and npm can install the GitHub archive. Its artifact viewer may have a separate network allowlist: bundle the installed library into the artifact if it cannot load the CDN. Publishing a package cannot override a client's network policy.

How to use it correctly:
- Install Core with `npm install west-coast-charts@1.1.5`. [Alternative downloads and checksums](https://westcoast-charts.com/download/index.md). Import: `import WestCoastCharts from 'west-coast-charts'`, then `await new WestCoastCharts(element, options).render()`.
- Options follow the ApexCharts 4.x format (`chart`, `series`, `xaxis`, `yaxis`, `plotOptions`, `theme`, ...). Do not invent option names: check the options reference below.
- Extra MIT chart types need `WestCoastCharts.use(types)` from `west-coast-charts/types`; premium types need `WestCoastCharts.use(premium)` from `west-coast-charts/premium` and `WestCoastCharts.setLicenseKey(key)` on public hosts (keys are bound to major version 1). A chart type whose entry is not loaded makes `render()` reject with the import to add.
- Quint types additionally need `WestCoastCharts.use(quint)` from `west-coast-charts/layers/quint`; this separate module is not in the Premium bundle. CLI/MCP use the separately versioned agent tools described below; inspect their current module support and wcc://version.
- Vitals Clock and Practice Schedule need explicit `layers/vitals` and `layers/schedule` imports alongside Premium. [Medical and practice modules](https://westcoast-charts.com/docs/medical/index.md) document caller-defined bands/alarms, controlled scheduling and standalone data helpers. Examples use invented data; no clinical thresholds, scores or alarm decisions are supplied.
- Orient is a separate MIT feature: import `west-coast-charts/features/orient` with the core; ESM loads its own runtime.esm.js dependency. Script-tag order: core bundle, dist/features/runtime.min.js, dist/features/orient.min.js. /full already includes Orient. See [Orient](https://westcoast-charts.com/docs/features/orient/index.md) for supported radial types and [live examples](https://westcoast-charts.com/examples/#radial-orient). It changes orientation, not data values.
- Core bundle: 194,836 bytes gzip, 0 runtime dependencies.
- Authored product pages, documentation and detailed example references publish Markdown twins linked in their HTML. Request their linked `index.md` URL or send `Accept: text/markdown`. The [current example directory](https://westcoast-charts.com/examples/index.md) covers all 528 samples. Original sample pages and the privacy/imprint pages do not all have twins; read their HTML rather than inventing a Markdown URL.

## Docs

- [Selective loading and measured sizes](https://westcoast-charts.com/docs/loading/index.md): verified consumer sizes, per-type increments and current Core limitations
- [Heatmap order and Gauge options](https://westcoast-charts.com/docs/chart-conventions/index.md): explicit row order and the radialBar namespace
- [Maintenance and security](https://westcoast-charts.com/maintenance/index.md): evidence, issue assessment and human release approval

- [Getting started](https://westcoast-charts.com/docs/getting-started/index.md): Install the public MIT Core, use a pinned browser CDN or offline archive. ES modules, CommonJS, React, Vue, Svelte, Angular, SSR, TypeScript and CSP.
- [Premium and licensing](https://westcoast-charts.com/docs/premium/index.md): Premium chart families and separate type modules, licence keys, domain binding, watermark and dev hosts.
- [Radial column charts](https://westcoast-charts.com/docs/radial-column/index.md): radialColumn: layers, links, keys, markers, encodings, goals, gauge, chord, readable labels, API.
- [Quint timeline and convergence](https://westcoast-charts.com/docs/quint/index.md): Shared-time-axis lanes for operations data, crossfilter, incidents and deployment markers. The labelled convergence lens expands time around an incident without changing values; loading, interaction, describe() and export.
- [Vitals Clock and Practice Schedule](https://westcoast-charts.com/docs/medical/index.md): Two separate Premium type modules: vital-sign time slots, practice resources and controlled schedule changes. Explicit imports, caller-defined bands and alarms, missing measurements, schedule helpers and redaction. Examples use invented demo data.
- [Orient: align a radial view](https://westcoast-charts.com/docs/features/orient/index.md): Optional MIT feature for radial views: align a segment or time window, keep text upright, restore the view and respect reduced motion. Supported types, API, controls, events and persistence; the plain Core entry stays lean.
- [Performance and security](https://westcoast-charts.com/docs/performance-and-security/index.md): Large-data settings, measured numbers, bundle sizes, XSS, CSP, CSV, dependencies.
- [Accessibility](https://westcoast-charts.com/docs/accessibility/index.md): Keyboard navigation, announcements, data tables, colour-vision palettes and reduced motion. Pinned library reference with source provenance.
- [Theming and design tokens](https://westcoast-charts.com/docs/theming/index.md): Built-in presets, light and dark modes, CSS tokens, precedence and registered themes. Pinned library reference with source provenance.
- [Options reference](https://westcoast-charts.com/docs/reference/options/index.md): Every option with type, default and description, generated from the shipped type declarations.
- [Premium options reference](https://westcoast-charts.com/docs/reference/premium-options/index.md): Options of the premium chart types (plotOptions.sankey, .gantt, .radialColumn, ...).
- [Premium and feature events](https://westcoast-charts.com/docs/reference/premium-events/index.md): Generated callback signatures, payloads and cancellation rules; existing family signatures and optional standard event arguments.
- [Map coverage and small states](https://westcoast-charts.com/docs/maps-coverage/index.md): Default world coverage, explicit data gaps and the optional eight-state Natural Earth boundary supplement, with source provenance.
- [Methods reference](https://westcoast-charts.com/docs/reference/methods/index.md): Chart instance and static methods with signatures.
- [wcc command line](https://westcoast-charts.com/docs/cli/index.md): Install wcc, validate options, render SVG/PNG and inspect the drawn values. Runtime discovery, module support, keys and structured failures.
- [MCP server](https://westcoast-charts.com/docs/mcp/index.md): Install wcc-mcp: seven tools, version discovery, resources and prompts over stdio or Streamable HTTP. Current runtime and module support are documented explicitly.
- [Error catalog](https://westcoast-charts.com/docs/errors/index.md): Validator issue kinds, cause, path, suggestions, machine-applicable fixes and CLI exit codes. Check the resolved library and schema version.
- [Migrating from ApexCharts 4.x](https://westcoast-charts.com/docs/migration-from-apexcharts/index.md): Switching an existing app: what is identical, what is new, what behaves differently.

## Examples

- [Current example directory](https://westcoast-charts.com/examples/index.md): 528 examples (333 Free Core, 195 Premium), original sample links, available configuration references and editor links
- [Detailed configuration references](https://westcoast-charts.com/gallery/index.md): 515 reference pages; this older collection is not the complete current catalogue
- [Human Chart Playground](https://westcoast-charts.com/chart-playground/index.md): edit actual values, labels and supported appearance locally in your browser
- [Line: Basic line](https://westcoast-charts.com/gallery/line/basic-line/index.md)
- [Bar: Basic bar](https://westcoast-charts.com/gallery/bar/basic-bar/index.md)
- [Heatmap: Basic heatmap](https://westcoast-charts.com/gallery/heatmap/basic/index.md)
- [Sankey: Basic Sankey](https://westcoast-charts.com/gallery/sankey/basic-sankey/index.md)
- [Gantt: Basic Gantt](https://westcoast-charts.com/gallery/gantt/basic-gantt/index.md)
- [Radial Column: Spectrum ring](https://westcoast-charts.com/gallery/radial-column/spectrum/index.md)
- [Stock: Basic](https://westcoast-charts.com/gallery/stock/basic/index.md)
- [Maps: Choropleth](https://westcoast-charts.com/gallery/maps/choropleth/index.md)

## Use cases

- [Operations: what changed while you were away?](https://westcoast-charts.com/use-cases/operations/index.md): activity, service health and capacity, with reading guides and live examples
- [Incident response: where did this incident travel?](https://westcoast-charts.com/use-cases/incident-response/index.md): follow a dependency path across regions and clusters

## Agents

- [Agent Lab](https://westcoast-charts.com/playground/index.md): actual browser validation, suggested fixes, rendering and describe() output
- [Using WestCoast Charts from a coding agent](https://westcoast-charts.com/agents/index.md): AGENTS.md, Markdown, CLI and MCP interfaces; optional editor-specific rules
- [wcc command line](https://westcoast-charts.com/docs/cli/index.md) (agent tools 0.2.3, Library 1.1.5): render SVG/PNG without a browser, validate, verification table
- [MCP server](https://westcoast-charts.com/docs/mcp/index.md) (agent tools 0.2.3, Library 1.1.5): render_chart, validate_chart, describe_chart and schema/example lookup through a compatible MCP client
- [Pricing](https://westcoast-charts.com/pricing/index.md): free MIT Core and annual Premium, SaaS and OEM business subscriptions through Stripe Checkout; card-free 30-day trial issuance and download on the pricing page
- [Release notes 1.1.5](https://westcoast-charts.com/changelog/index.md)

## Optional

- [Every Markdown page](https://westcoast-charts.com/docs/sitemap.md)
- [All docs in one file](https://westcoast-charts.com/llms-full.txt): for tools that read one document URL; large
- [Options schema](https://westcoast-charts.com/wcc/schema/wcc-options.schema.json): versioned Library 1.1.5 options. Validator and describe() are available as optional browser modules.
- [Describe result schema](https://westcoast-charts.com/wcc/schema/wcc-describe.schema.json): wcc-describe/1; values, units, aggregation functions, scales, filters and truncation.
- [MCP workflow and result handling](https://westcoast-charts.com/agents/index.md): discovery → validation → rendering → description; full/stub provenance, structured errors and side-effect limits.
- Public agent tools 0.2.3, tested with Library 1.1.5; available from the versioned GitHub release and npm. Read the current [CLI and MCP setup](https://westcoast-charts.com/agents/index.md), including the tested module matrix. Browser demos run the library directly; they do not execute a remote MCP server.