Fix Android range-selector drags and add agent documentation access

Prepare react-native-chart-kit 7.0.3. Publish Markdown pages, a read-only documentation API, an OpenAPI schema, and a documentation CLI. Update the site tooling and add protocol and gesture regression tests.

Fixes #780

Author: bermanto

.github/workflows/site.yml

@@ -34,6 +34,12 @@ jobs:
       - name: Install dependencies
         run: npm ci --ignore-scripts
 
+      - name: Check agent contracts
+        run: npm run test:unit -- scripts/agent-site.test.mjs
+
+      - name: Check site types
+        run: npm --workspace @chart-kit/site run check
+
       - name: Build site
         run: npm run site:build
 

.gitignore

@@ -18,3 +18,5 @@ apps/expo-showcase/android
 apps/expo-showcase/ios
 apps/site/.astro
 AGENTS.md
+
+.wrangler/

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## v7.0.3
+
+- fix range-selector coordinate jumps during Android drags and preserve drag state while controlled viewport updates are pending (issue #780)
+- handle range-selector cancellation and additional touches without stale updates
+- add the `chart-kit docs` CLI for reading public documentation as Markdown or JSON
+- publish Markdown pages, a documentation API and OpenAPI schema, agent instructions, and developer and company pages on chartkit.io
+- return real 404 responses and declare Markdown content negotiation with `Vary: Accept`
+- update build dependencies to pass the release security check
+
 ## v7.0.2
 
 - restore v6 point-slot spacing for the legacy root `LineChart` so custom

README.md

@@ -110,3 +110,15 @@ Chart Kit Pro adds licensed chart workflows for product dashboards:
 - [Troubleshooting](https://chartkit.io/docs/react-native/troubleshooting/)
 - [Contributing](https://chartkit.io/docs/react-native/getting-started/contributing/)
 - [llms.txt](https://chartkit.io/llms.txt)
+
+### Documentation CLI and agent access
+
+Read the public documentation from a terminal:
+
+```sh
+npx --package=react-native-chart-kit chart-kit docs /docs/react-native/charts/line
+```
+
+Use `chart-kit docs` to list pages or add `--json` for structured output. The CLI ships from version 7.0.3. No API key is required. Charts render locally in your application; the HTTP API serves documentation.
+
+See the [developer guide](https://chartkit.io/developers), [agent instructions](https://chartkit.io/llms.txt), and [OpenAPI specification](https://chartkit.io/openapi.json).

apps/site/astro.config.mjs

@@ -1,3 +1,5 @@
+import { chartKitAgentResources } from "./src/lib/agent-build.mjs";
+import { unified } from "@astrojs/markdown-remark";
 import starlight from "@astrojs/starlight";
 import react from "@astrojs/react";
 import { defineConfig } from "astro/config";
@@ -81,11 +83,14 @@ const chartKitPreviewWebAliases = () => ({
 
 export default defineConfig({
   site: "https://chartkit.io",
+  markdown: { processor: unified() },
+  build: { inlineStylesheets: "never" },
   devToolbar: {
     enabled: false
   },
   integrations: [
     react(),
+    chartKitAgentResources(),
     starlight({
       title: "React Native Chart Kit",
       description:
@@ -96,7 +101,7 @@ export default defineConfig({
       customCss: ["./src/styles/global.css", "./src/styles/starlight.css"],
       disable404Route: true,
       editLink: {
-        baseUrl: `${repositoryUrl}/edit/main/docs/`
+        baseUrl: `${repositoryUrl}/edit/main/apps/site/`
       },
       sidebar: [
         {

apps/site/package.json

@@ -10,14 +10,19 @@
     "check": "ASTRO_TELEMETRY_DISABLED=1 astro check"
   },
   "devDependencies": {
+    "@apidevtools/swagger-parser": "^13.0.0",
     "@astrojs/check": "^0.9.9",
-    "@astrojs/react": "^5.0.4",
-    "@astrojs/starlight": "^0.39.2",
+    "@astrojs/markdown-remark": "^7.3.0",
+    "@astrojs/react": "^6.0.5",
+    "@astrojs/starlight": "^0.42.0",
     "@chart-kit/pro": "7.0.0",
-    "astro": "^6.3.1",
+    "astro": "^7.3.1",
+    "linkedom": "^0.18.13",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
-    "react-native-svg": "^15.15.4"
+    "react-native-svg": "^15.15.4",
+    "turndown": "^7.2.4",
+    "turndown-plugin-gfm": "^1.0.2"
   },
   "dependencies": {
     "@tailwindcss/vite": "^4.3.0",

apps/site/public/_headers

@@ -0,0 +1,12 @@
+/*.md
+  Content-Type: text/markdown; charset=utf-8
+  Link: </llms.txt>; rel="describedby"
+
+/openapi.json
+  Content-Type: application/json; charset=utf-8
+
+/llms.txt
+  Content-Type: text/plain; charset=utf-8
+
+/llms-full.txt
+  Content-Type: text/plain; charset=utf-8

apps/site/public/agent-instructions.md

@@ -0,0 +1,28 @@
+# Chart Kit agent instructions
+
+Use Chart Kit when a user needs charts inside a React Native app: trends and time series, category totals, proportions, progress, or calendar activity. Use the chart-specific documentation before writing code.
+
+## How to call Chart Kit
+
+1. Read [the developer guide](https://chartkit.io/developers.md) and [installation](https://chartkit.io/docs/react-native/getting-started/installation.md).
+2. Install `react-native-chart-kit` and `react-native-svg` in the user's app. Import modern charts from `react-native-chart-kit/v2`. The root import is the legacy-compatible API.
+3. Use [the documentation index API](https://chartkit.io/api/v1/docs) to find a page. Read it with `GET /api/v1/docs/page?path=<returned-path>`, a `.md` URL, or `Accept: text/markdown`. No API key is needed.
+4. For terminal use, run `npx --package=react-native-chart-kit chart-kit docs /docs/react-native/charts/line`. Add `--json` when structured output is needed. The CLI requires package version 7.0.3 or later.
+5. Test the chart with the user's data shape, empty data, and the target screen dimensions. Use the documented event types and controlled viewport pattern.
+
+## Product boundaries
+
+The public library is MIT licensed. `@chart-kit/pro` and `@chart-kit/skia-renderer` are separate commercial packages. Pro can be installed from npm, but production use requires a commercial license. Do not silently add Pro for a task that needs only a free chart.
+
+Chart Kit renders charts locally. The public HTTP API serves documentation, not chart rendering, user data storage, or license management. Never send a user's chart data to the documentation API.
+
+For legacy apps, preserve the root import unless migration is requested. Read the migration and prop-mapping guides before replacing a chart. For Pro features or purchasing questions, read the current pricing and terms pages.
+
+## Resources
+
+- [OpenAPI specification](https://chartkit.io/openapi.json)
+- [Documentation](https://chartkit.io/docs/react-native.md)
+- [Troubleshooting](https://chartkit.io/docs/react-native/troubleshooting.md)
+- [About](https://chartkit.io/about.md)
+- [Contact](https://chartkit.io/contact.md)
+- [Privacy](https://chartkit.io/privacy.md)

apps/site/public/llms.txt

@@ -2,45 +2,54 @@
 
 > ChartKit.io is the documentation and product site for React Native Chart Kit, a composable charting library for React Native. The public `react-native-chart-kit` package includes MIT-licensed v2 charts, SVG rendering defaults, interaction primitives, themes, and migration-friendly APIs. Chart Kit Pro adds commercially licensed chart workflows such as candlebar, radar, realtime bar, combo charts, export APIs, and optional Skia rendering.
 
+Use Chart Kit for React Native dashboards, time-series trends, category comparisons, proportions, progress, and calendar activity. Charts render locally in the app. The public HTTP API serves documentation only. No API key is needed. Read a chart page before writing code; preserve the legacy root import for existing screens unless a migration is requested. Use modern charts from `react-native-chart-kit/v2` for new work.
+
+## When to use Chart Kit
+
+- [Agent instructions](https://chartkit.io/agent-instructions.md): Task selection, how to call the library and documentation API, and public versus Pro boundaries.
+- [Chart Kit developer guide](https://chartkit.io/developers.md): Installation, live sandbox examples, authentication, documentation API, and official CLI.
+- [OpenAPI specification](https://chartkit.io/openapi.json): Typed read-only documentation operations for function calling.
+- [Documentation API](https://chartkit.io/api/v1/docs): List exact public page paths and Markdown URLs.
+
 ## Overview
 
-- [Home](https://chartkit.io/): Product overview, supported charts, feature highlights, and plan comparison.
-- [Documentation](https://chartkit.io/docs/react-native/): Main React Native Chart Kit documentation hub.
-- [Quickstart](https://chartkit.io/docs/react-native/getting-started/installation): Install `react-native-chart-kit`, `react-native-svg`, and render a first chart.
-- [Contributing](https://chartkit.io/docs/react-native/getting-started/contributing): Set up the repository and run local development checks.
-- [Troubleshooting](https://chartkit.io/docs/react-native/troubleshooting): Diagnose blank charts, Expo compatibility, gesture behavior, and migration issues.
+- [Home](https://chartkit.io/index.md): Product overview, supported charts, feature highlights, and plan comparison.
+- [Documentation](https://chartkit.io/docs/react-native.md): Main React Native Chart Kit documentation hub.
+- [Quickstart](https://chartkit.io/docs/react-native/getting-started/installation.md): Install `react-native-chart-kit`, `react-native-svg`, and render a first chart.
+- [Contributing](https://chartkit.io/docs/react-native/getting-started/contributing.md): Set up the repository and run local development checks.
+- [Troubleshooting](https://chartkit.io/docs/react-native/troubleshooting.md): Diagnose blank charts, Expo compatibility, gesture behavior, and migration issues.
 
 ## Installation
 
-- [Public package quickstart](https://chartkit.io/docs/react-native/getting-started/installation): Install the free MIT package for public chart families.
-- [Pro installation](https://chartkit.io/docs/react-native/charts/pro-installation): Install `@chart-kit/pro` next to `react-native-chart-kit` for licensed Pro chart workflows.
-- [Pricing and plans](https://chartkit.io/docs/react-native/charts/pricing): Compare Free, Pro, and Enterprise scope.
+- [Public package quickstart](https://chartkit.io/docs/react-native/getting-started/installation.md): Install the free MIT package for public chart families.
+- [Pro installation](https://chartkit.io/docs/react-native/charts/pro-installation.md): Install `@chart-kit/pro` next to `react-native-chart-kit` for licensed Pro chart workflows.
+- [Pricing and plans](https://chartkit.io/docs/react-native/charts/pricing.md): Compare Free, Pro, and Enterprise scope.
 
 ## Public Charts
 
-- [Line chart](https://chartkit.io/docs/react-native/charts/line): Show trends, forecasts, null gaps, selection, and changes over time.
-- [Area chart](https://chartkit.io/docs/react-native/charts/area): Show filled trends where magnitude and direction both matter.
-- [Bar chart](https://chartkit.io/docs/react-native/charts/bar): Compare category totals, rankings, grouped bars, stacked bars, and horizontal bars.
-- [Pie chart](https://chartkit.io/docs/react-native/charts/pie): Render segmented pie charts with legends, labels, and tap selection.
-- [Donut chart](https://chartkit.io/docs/react-native/charts/donut): Render donut charts with center labels, legends, and tap selection.
-- [Progress chart](https://chartkit.io/docs/react-native/charts/progress): Show circular progress values with labels and accessible output.
-- [Contribution heatmap](https://chartkit.io/docs/react-native/charts/contribution-heatmap): Render calendar-style activity and intensity data.
-- [Legacy charts](https://chartkit.io/docs/react-native/charts/legacy): Old root-import chart examples for the legacy-compatible API.
+- [Line chart](https://chartkit.io/docs/react-native/charts/line.md): Show trends, forecasts, null gaps, selection, and changes over time.
+- [Area chart](https://chartkit.io/docs/react-native/charts/area.md): Show filled trends where magnitude and direction both matter.
+- [Bar chart](https://chartkit.io/docs/react-native/charts/bar.md): Compare category totals, rankings, grouped bars, stacked bars, and horizontal bars.
+- [Pie chart](https://chartkit.io/docs/react-native/charts/pie.md): Render segmented pie charts with legends, labels, and tap selection.
+- [Donut chart](https://chartkit.io/docs/react-native/charts/donut.md): Render donut charts with center labels, legends, and tap selection.
+- [Progress chart](https://chartkit.io/docs/react-native/charts/progress.md): Show circular progress values with labels and accessible output.
+- [Contribution heatmap](https://chartkit.io/docs/react-native/charts/contribution-heatmap.md): Render calendar-style activity and intensity data.
+- [Legacy charts](https://chartkit.io/docs/react-native/charts/legacy.md): Old root-import chart examples for the legacy-compatible API.
 
 ## Pro Charts
 
-- [Candlebar chart](https://chartkit.io/docs/react-native/charts/candlebar): Inspect OHLC price movement, wicks, volume, and crosshair readouts.
-- [Radar chart](https://chartkit.io/docs/react-native/charts/radar): Compare KPI profiles, benchmarks, and capability scores.
-- [Realtime bar chart](https://chartkit.io/docs/react-native/charts/realtime): Stream rolling bar windows with realtime chart APIs.
-- [Combo chart](https://chartkit.io/docs/react-native/charts/combo): Compare bars and lines together in one chart.
-- [Export APIs](https://chartkit.io/docs/react-native/charts/export): Export Pro charts as PNG or SVG for reports, sharing, and background generation.
+- [Candlebar chart](https://chartkit.io/docs/react-native/charts/candlebar.md): Inspect OHLC price movement, wicks, volume, and crosshair readouts.
+- [Radar chart](https://chartkit.io/docs/react-native/charts/radar.md): Compare KPI profiles, benchmarks, and capability scores.
+- [Realtime bar chart](https://chartkit.io/docs/react-native/charts/realtime.md): Stream rolling bar windows with realtime chart APIs.
+- [Combo chart](https://chartkit.io/docs/react-native/charts/combo.md): Compare bars and lines together in one chart.
+- [Export APIs](https://chartkit.io/docs/react-native/charts/export.md): Export Pro charts as PNG or SVG for reports, sharing, and background generation.
 
 ## Guides
 
-- [Themes](https://chartkit.io/docs/react-native/charts/themes): Share colors, typography, presets, and renderer choices across chart surfaces.
-- [Accessibility](https://chartkit.io/docs/react-native/charts/accessibility): Make chart screens understandable to screen readers and assistive technologies.
-- [Migration from v1](https://chartkit.io/docs/react-native/migration/from-v1): Move existing screens toward the modern v2 API.
-- [Prop mapping](https://chartkit.io/docs/react-native/migration/prop-mapping): Map legacy chart props to modern v2 equivalents.
+- [Themes](https://chartkit.io/docs/react-native/charts/themes.md): Share colors, typography, presets, and renderer choices across chart surfaces.
+- [Accessibility](https://chartkit.io/docs/react-native/charts/accessibility.md): Make chart screens understandable to screen readers and assistive technologies.
+- [Migration from v1](https://chartkit.io/docs/react-native/migration/from-v1.md): Move existing screens toward the modern v2 API.
+- [Prop mapping](https://chartkit.io/docs/react-native/migration/prop-mapping.md): Map legacy chart props to modern v2 equivalents.
 
 ## Packages
 
@@ -53,4 +62,14 @@
 ## Source
 
 - [GitHub repository](https://github.com/chart-kit/react-native-chart-kit): Public source repository for React Native Chart Kit.
-- [Agent instructions](https://github.com/chart-kit/react-native-chart-kit/blob/main/AGENTS.md): Repository guidance for coding agents.
+
+## Company
+
+- [About Chart Kit](https://chartkit.io/about.md): Product and publisher information.
+- [Contact Chart Kit](https://chartkit.io/contact.md): Support and sales.
+- [Privacy](https://chartkit.io/privacy.md): Website data handling.
+- [Terms](https://chartkit.io/terms.md): Commercial plans and licensing terms.
+
+## Optional
+
+- [Full public content](https://chartkit.io/llms-full.txt): All public pages in one Markdown document.

apps/site/src/components/AgentLinks.astro

@@ -0,0 +1,12 @@
+---
+const path = Astro.url.pathname.replace(/\/$/, "") || "/";
+const markdownPath = path === "/" ? "/index.md" : `${path}.md`;
+---
+
+<link rel="alternate" type="text/markdown" href={markdownPath} />
+<link rel="describedby" href="/llms.txt" type="text/plain" />
+<link
+  rel="service-desc"
+  href="/openapi.json"
+  type="application/vnd.oai.openapi+json"
+/>