Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
165 commits
Select commit Hold shift + click to select a range
92eea70
excel stuff
Chenglong-MS Sep 20, 2026
aa492a5
Merge branch 'dev' of github.com:microsoft/flint-chart into dev
Chenglong-MS Sep 20, 2026
bad6ebd
Merge remote-tracking branch 'origin/main' into dev
Chenglong-MS Sep 20, 2026
e026e7d
wrapping labels
Chenglong-MS Sep 30, 2026
158f8ca
feat(skills): an interaction-author skill maps a gesture or an intent…
xavier-shaw Sep 30, 2026
5d36fdd
feat(interactions): a surface reports each committed selection, and t…
xavier-shaw Sep 30, 2026
c706422
fix(hosts): the interactive chart view fits its frame
xavier-shaw Sep 30, 2026
433cc0e
temporal
Chenglong-MS Sep 30, 2026
15a9840
accessible navigation
Chenglong-MS Sep 30, 2026
6ff6424
accessible navigation: fix readings, focus, and refresh; add design doc
invalid-email-address Sep 30, 2026
f08a598
ok
Chenglong-MS Sep 30, 2026
ca0cc86
fixes
Chenglong-MS Oct 1, 2026
28862c9
githu
Chenglong-MS Oct 5, 2026
fd866a0
interaction
Chenglong-MS Oct 6, 2026
3ddebad
interaction updates
Chenglong-MS Oct 6, 2026
bc03ecf
refactor(interactions): ChartState is the data half of the interactio…
xavier-shaw Oct 5, 2026
4041a38
feat(interactions): a surface exposes getState and onChange in place …
xavier-shaw Oct 5, 2026
0179f83
feat(hosts): the MCP view sends the chart state in field terms, and t…
xavier-shaw Oct 5, 2026
3b020a8
docs(interactions): host access to the chart state
xavier-shaw Oct 5, 2026
7a9ed7f
feat(skills): flint-interaction-author covers the mechanism, presets,…
xavier-shaw Oct 6, 2026
a183a4f
update
Chenglong-MS Oct 6, 2026
ae4ea4b
updates
Chenglong-MS Oct 6, 2026
e39d6f0
docs(interactions): the read side in the programming guide, the galle…
xavier-shaw Oct 7, 2026
7742e34
interactive application and source data
xavier-shaw Oct 7, 2026
24886d5
Merge branch 'dev' into feat/host-chart-state
xavier-shaw Oct 7, 2026
9db4eb6
Merge pull request #137 from microsoft/feat/host-chart-state
xavier-shaw Oct 7, 2026
729f96c
minor
Chenglong-MS Oct 7, 2026
4ccebcb
Merge branch 'dev' of github.com:microsoft/flint-chart into dev
Chenglong-MS Oct 7, 2026
727af10
fixes
Chenglong-MS Oct 7, 2026
44071cf
feat(mcp): updates argument on create_chart_view and validate_chart
xavier-shaw Oct 7, 2026
cb255f4
docs(skills): guide the agent to the right update op and value types
xavier-shaw Oct 7, 2026
5ef0a90
feat(site): temporal key values in the debug gym
xavier-shaw Oct 7, 2026
d2d092e
fix and update application examples
xavier-shaw Oct 7, 2026
83a89d2
update
Chenglong-MS Oct 8, 2026
070aa85
widget as an interaction
Chenglong-MS Oct 8, 2026
ffc9559
filter widget
Chenglong-MS Oct 8, 2026
12d3f0e
perf(interactions): share one path datum list across a line's segments
xavier-shaw Oct 8, 2026
bfefd9a
fix(interactions): resolve provenance by stamped source row when inli…
xavier-shaw Oct 8, 2026
bf757f4
fix(interactions): re-plan calendar ticks of a navigated time axis fr…
xavier-shaw Oct 8, 2026
6d21fde
update application and bespoke examples
xavier-shaw Oct 8, 2026
4d01ce9
fix demos
xavier-shaw Oct 8, 2026
38c9094
feat(echarts): strokeDash on the Line Chart
jaxor24 Oct 8, 2026
ff141e7
updates to the new API
Chenglong-MS Oct 8, 2026
aaa7ff8
plotly fix
Chenglong-MS Oct 8, 2026
9364cf2
updates
Chenglong-MS Oct 8, 2026
ac2743b
feat: apple theme and overlay fixes
xavier-shaw Oct 9, 2026
89a17c2
feat: list_interaction_presets and a rewritten interaction-author skill
xavier-shaw Oct 9, 2026
0173213
feat: live layout for navigated bar charts
xavier-shaw Oct 9, 2026
29671c3
feat: easier ChartUpdates
xavier-shaw Oct 9, 2026
0a7a1fa
feat(mcp): client roots, update context, clearer chart view
xavier-shaw Oct 9, 2026
34f3129
demo: handles and a curve on the Old Faithful sketch
xavier-shaw Oct 9, 2026
9dba970
feat(mcp): get_flint_skill tool serves the bundled skills
xavier-shaw Oct 9, 2026
9348ca5
feat: report each update op before and after the chart is drawn
xavier-shaw Oct 9, 2026
a6f4b45
updates
Chenglong-MS Oct 10, 2026
0358962
fixes
Chenglong-MS Oct 10, 2026
f2f2c7d
fix: clip only stack groups that place their bars, not a plot-filling…
xavier-shaw Oct 9, 2026
f34dcbb
fix: overlays follow the chart's clip when zoomed
xavier-shaw Oct 9, 2026
dd97baf
fix: pick only marks on screen when the chart is zoomed
xavier-shaw Oct 9, 2026
fad5641
feat(mcp): create_chart_view validates on its own, so agents skip the…
xavier-shaw Oct 9, 2026
df7a72b
demo: zoom clipping lab under Layout
xavier-shaw Oct 10, 2026
9138bf9
fixes
Chenglong-MS Oct 10, 2026
df67ccd
fix(echarts): keep a strokeDash legend entry apart from a colour valu…
jaxor24 Oct 10, 2026
eb061ac
refactor(plan): split the compile into analyze, plan and emit; the pl…
xavier-shaw Oct 12, 2026
228e1a8
feat(plan): the plan makes every room decision, measured, within the …
xavier-shaw Oct 12, 2026
7bce3d4
feat(session): a chart mounted for a room lays out again in place; th…
xavier-shaw Oct 12, 2026
d2f27e1
feat(plan): composite charts plan their views; facet gaps, closing ru…
xavier-shaw Oct 12, 2026
2cdcdde
fix(session): filters push every size their replan changes; a faceted…
xavier-shaw Oct 12, 2026
0e91b67
fix(plan): titles and MCP renders measure text as they are drawn; cos…
xavier-shaw Oct 12, 2026
827dc83
fix(plan): titles keep inside the theme's padding, sparkline colours …
xavier-shaw Oct 12, 2026
37873e8
chore(copilot): sync the bundled app with the layout plan
xavier-shaw Oct 12, 2026
35cc605
Merge pull request #139 from microsoft/feat/layout-plan-clean
Chenglong-MS Oct 12, 2026
561c08c
fix
Chenglong-MS Oct 12, 2026
8716493
add layout inspector
xavier-shaw Oct 13, 2026
7772ea7
updates
Chenglong-MS Oct 14, 2026
9247fe3
Merge origin/dev: layout inspector, alongside the label overflow rework
Chenglong-MS Oct 14, 2026
b20fd91
new layout algorithm
Chenglong-MS Oct 15, 2026
84e753a
minor
Chenglong-MS Oct 15, 2026
e44a053
updates
Chenglong-MS Oct 15, 2026
fbe8660
feat(interactive): where targets, and reset gestures reach onChange
xavier-shaw Oct 15, 2026
bdaeb38
feat(mcp): live boards of several charts the reader can arrange
xavier-shaw Oct 15, 2026
f67ef8b
feat(mcp): charts on a board connect by the fields they share
xavier-shaw Oct 15, 2026
4a12286
feat(mcp): board theme, bottom bar, export, and recovery
xavier-shaw Oct 15, 2026
37710ab
feat(mcp-app): selection chips and reopen recovery in the chart card
xavier-shaw Oct 15, 2026
2b66de6
feat(mcp-ui): edit layout moves a chart by a grip handle and resizes …
xavier-shaw Oct 15, 2026
0fda400
minor
Chenglong-MS Oct 15, 2026
0fad8d8
Merge branch 'dev' of github.com:microsoft/flint-chart into dev
Chenglong-MS Oct 15, 2026
83570c5
fixes
Chenglong-MS Oct 15, 2026
44bc351
feat(density): stack mode with a layered, translucent option
xavier-shaw Oct 13, 2026
ae1379a
feat(vegalite): Ridgeline Plot and Marginal Plot
xavier-shaw Oct 13, 2026
a353adf
docs(templates): the extending guide for composite and plan-tested te…
xavier-shaw Oct 13, 2026
f42d999
test-data: gallery tiles for the Ridgeline Plot and Marginal Plot
xavier-shaw Oct 13, 2026
fa81fbe
add layout plan demos
xavier-shaw Oct 13, 2026
c8f490b
feat(ridgeline): value axis, marked values and gradient key in perspe…
claude Oct 13, 2026
ef8ef96
fix(ridgeline): marked values stay in the plot, every ridge keeps its…
xavier-shaw Oct 15, 2026
ac21de1
feat(ridgeline): plan the perspective's depth, and give its labels wa…
xavier-shaw Oct 15, 2026
b95fa54
chore(copilot): sync the bundled app with the Ridgeline and Marginal …
xavier-shaw Oct 15, 2026
a9975d9
hover
Chenglong-MS Oct 15, 2026
6788bb0
feat(ridgeline): markAt toggles marks at the x ticks
xavier-shaw Oct 15, 2026
d02f4e6
Merge pull request #142 from microsoft/ridgeline-and-marginal-charts
xavier-shaw Oct 15, 2026
0ae103b
fix
Chenglong-MS Oct 15, 2026
905fd91
fix layout inspector
xavier-shaw Oct 16, 2026
0c89c15
feat(core): tables — a chart's drawn rows, and the Table chart type
xavier-shaw Oct 16, 2026
c99a4de
feat(mcp): tables in the chart card and on boards
xavier-shaw Oct 16, 2026
59ac14e
docs: Table and view in the skills and reference
xavier-shaw Oct 16, 2026
69abfc5
fix(theme): a compact unit belongs to every printed value
xavier-shaw Oct 17, 2026
da36126
feat(interactive): public event types, generated into the skill
xavier-shaw Oct 17, 2026
f920279
feat(interactive): linkCharts, validateLinks and useLinkedCharts
xavier-shaw Oct 17, 2026
1c07c43
refactor(mcp): board links come from flint-chart
xavier-shaw Oct 17, 2026
ba8fa53
chore: sync skill copies and the Copilot plugin
xavier-shaw Oct 17, 2026
aa55f43
new theme
Chenglong-MS Oct 17, 2026
5bf5e3e
Merge branch 'dev' of github.com:microsoft/flint-chart into dev
Chenglong-MS Oct 17, 2026
6703b07
ok
Chenglong-MS Oct 17, 2026
c9edca0
update advanced examples
Chenglong-MS Oct 17, 2026
eceb654
fixes
Chenglong-MS Oct 18, 2026
a1af441
updates
Chenglong-MS Oct 20, 2026
8caf5be
feat(mcp): boards build off screen; show_board opens the one card a turn
xavier-shaw Oct 19, 2026
ffc2057
feat(flint-js): KPI card shortens its value (k/M) with a shared forma…
xavier-shaw Oct 20, 2026
700bc8a
feat(mcp)!: charts build off screen like boards; show opens the one c…
xavier-shaw Oct 20, 2026
ca7be19
feat(site): MCP page tells a chart story and a board story with live …
xavier-shaw Oct 20, 2026
2d51661
fixes
Chenglong-MS Oct 20, 2026
f7a6c4a
updates
Chenglong-MS Oct 20, 2026
f61de75
Merge remote-tracking branch 'origin/main' into dev
Chenglong-MS Oct 20, 2026
e2d6ce8
fix(site): wrap the nav to two rows below 980px
Chenglong-MS Oct 20, 2026
384d085
chore: keep dev's package-lock after merging main
Chenglong-MS Oct 20, 2026
cecdbe5
Merge PR #138: feat(echarts): strokeDash on the Line Chart
Chenglong-MS Oct 20, 2026
5c051ca
fix(flint-js): close CodeQL ReDoS and URL-scheme alerts
Chenglong-MS Oct 20, 2026
d1d03da
test(flint-js): fix test typecheck errors and a cold-start timeout
Chenglong-MS Oct 20, 2026
5aec859
chore(flint-js): clear lint errors
Chenglong-MS Oct 20, 2026
e140711
fix(site): read overflowFit where the pins demo read straightRefused
Chenglong-MS Oct 20, 2026
cd2e39e
ci: give the site build an 8 GB heap
Chenglong-MS Oct 20, 2026
6522254
chore(deps): update vulnerable transitive dependencies
Chenglong-MS Oct 20, 2026
650745e
test(flint-js): give the filter re-layout test time for its cold import
Chenglong-MS Oct 20, 2026
a3c3c1a
chore(deps): patch vite and vitest for their dev-server advisories
Chenglong-MS Oct 20, 2026
8b76d82
fix(flint-js): keep idle dot opacity and rings when charts are intera…
Chenglong-MS Oct 21, 2026
0127316
feat(flint-js): clearer multi-key legends
Chenglong-MS Oct 21, 2026
f97b624
feat(site): video, menu icons and community section for 1.0
Chenglong-MS Oct 21, 2026
5f6b96b
docs: release 1.0.0 and rewrite the README after the project site
Chenglong-MS Oct 21, 2026
c4cfc5c
fixes
Chenglong-MS Oct 21, 2026
4b7f52d
uupdate image
Chenglong-MS Oct 21, 2026
6898b96
fix
Chenglong-MS Oct 21, 2026
7756ffb
readme
Chenglong-MS Oct 21, 2026
3c695fa
ok
Chenglong-MS Oct 21, 2026
90c9e1c
ok
Chenglong-MS Oct 21, 2026
9caad86
fixes
Chenglong-MS Oct 21, 2026
8afece0
fix(mcp-ui): boards draw the theme's furniture as charts do
xavier-shaw Oct 20, 2026
adddaf5
refactor(mcp-ui)!: each board cell is one whole Flint chart
xavier-shaw Oct 21, 2026
c3cb5f9
fix(mcp-ui): copying a chart or a board as PNG works in sandboxed hos…
xavier-shaw Oct 21, 2026
475eac3
docs(skills): board charts draw their own heading; Link charts and ch…
xavier-shaw Oct 21, 2026
3e99e1b
fix(vegalite): a dodge over years lanes each year, not each value (#147)
onmax Oct 21, 2026
c1a23e9
updates
Chenglong-MS Oct 21, 2026
9aa7e4e
Merge branch 'dev' of github.com:microsoft/flint-chart into dev
Chenglong-MS Oct 21, 2026
a02848e
add talk material
Chenglong-MS Oct 21, 2026
4872cc0
fix
Chenglong-MS Oct 21, 2026
2377d11
fixes
Chenglong-MS Oct 21, 2026
1187607
slides fix
Chenglong-MS Oct 21, 2026
cf8e162
Merge main (the 1.0 squash, #146) into dev
Chenglong-MS Oct 21, 2026
74aafd4
fix
Chenglong-MS Oct 21, 2026
68d8b75
chore(release): 1.0.1
Chenglong-MS Oct 21, 2026
d6b85b8
fixes
Chenglong-MS Oct 21, 2026
d2a65d1
coffee
Chenglong-MS Oct 21, 2026
66a2c29
feat(mcp)!: the server keeps nothing; show takes the spec
xavier-shaw Oct 21, 2026
da100fb
docs: stateless MCP in the README, setup tutorials, MCP page and CHAN…
xavier-shaw Oct 21, 2026
9d27982
fix(mcp): get_flint_skill finds a section by the start of its heading
xavier-shaw Oct 21, 2026
7d75e8b
fix(mcp-ui): the chart card never scrolls its frame; a tall chart sca…
xavier-shaw Oct 21, 2026
5694e09
chore(copilot): sync the plugin's app build
xavier-shaw Oct 21, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/extensions/flint-chart/.mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"command": "npx",
"args": [
"--yes",
"flint-chart-mcp@1.0.0"
"flint-chart-mcp@1.0.1"
],
"cwd": "${PLUGIN_ROOT}"
}
Expand Down
2 changes: 1 addition & 1 deletion .github/extensions/flint-chart/.plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "flint-chart",
"description": "Flint chart authoring MCP, skill, and native interactive chart canvas for Copilot CLI.",
"version": "1.0.0",
"version": "1.0.1",
"author": {
"name": "Microsoft",
"url": "https://github.com/microsoft/flint-chart"
Expand Down
192 changes: 96 additions & 96 deletions .github/extensions/flint-chart/assets/flint-app.html

Large diffs are not rendered by default.

36 changes: 19 additions & 17 deletions .github/extensions/flint-chart/skills/flint-chart-author/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,22 +43,24 @@ First decide which workflow the user is asking for:
`semantic_types` + `chart_spec` pieces. Do not install packages or write
renderer code unless asked.
- **MCP chart output:** if Flint MCP tools are available, **default to
`create_chart` then `show`** whenever the user asks to see a chart.
`create_chart` checks the spec and returns a report and the chart's id
without drawing; fix what the report asks with `update_chart`, then call
`show` once, which opens an interactive, live-rendered card with a
customization panel. Only fall back to `render_chart` (PNG/SVG) when the host has
no App UI support or the user explicitly wants a static image. Use
`validate_chart` to check a spec without rendering, `compile_chart` when the
user wants backend-native JSON, and `list_chart_types` when you need the
supported chart catalog.
- **DO** pass `updates` beside the input to `create_chart` when the user
`validate_chart` then `show`** whenever the user asks to see a chart.
`validate_chart` checks the spec and returns a report without drawing; fix
what it asks in the spec, then call `show({ "chart": … })` once with the
whole spec, which opens an interactive, live-rendered card with a
customization panel. The server keeps nothing between calls: the spec in
the conversation is the chart. Only fall back to `render_chart` (PNG/SVG)
when the host has no App UI support or the user explicitly wants a static
image. Use `compile_chart` when the user wants backend-native JSON, and
`list_chart_types` when you need the supported chart catalog.
- **DO** pass `updates` beside the input to `validate_chart` and `show` when the user
asks the chart to open in a state: rows to stand out, a note on a mark, a
framed range. It is a list of ChartUpdate layers, state not behaviour; the
shapes are in `flint://interaction-skill` under "Update the chart". To change a
chart in a later turn, call `update_chart` with its id and new `updates`, then
`show` again: a new card shows the new version, earlier cards stay as they were.
- **DO** pass `view: "table"` to `create_chart` when the user wants to see
chart in a later turn, change its spec or `updates` and call `show` again: a
new card shows it, earlier cards stay as they were. The reader's edits in the
card's panel live on that card; its context gives the `chart_spec` that keeps
them, so pass it unless the user asked for something else.
- **DO** pass `view: "table"` to `show` when the user wants to see
a chart's numbers: the card opens on the table of the rows the chart draws,
and the reader can switch to the chart. When the user wants records listed and
no chart at all, use `chartType: "Table"` instead.
Expand Down Expand Up @@ -594,9 +596,9 @@ Put the three steps into one `ChartAssemblyInput`, with the data bound as in
```

Add `theme_spec`, `chartProperties`, `interaction_spec` or `updates` only when
the request asks for them. With the MCP tools, send it to `create_chart`
directly (it validates; skip `validate_chart`), fix what the report asks with
`update_chart`, then `show`. Without them, run the "Validation checklist".
the request asks for them. With the MCP tools, check it with `validate_chart`,
fix what the report asks in the spec, then pass the whole spec to `show` as
`chart`. Without them, run the "Validation checklist".

## Chart-level properties (`chartProperties`)

Expand Down Expand Up @@ -860,4 +862,4 @@ Before returning, verify:

## Copilot CLI chart canvas

When this plugin's native **Flint Chart Canvas** is available, prefer it over `create_chart` and `show`. Validate the complete `ChartAssemblyInput` first, then open the canvas with that input, including any theme, options, and `interaction_spec`. Pass resolved inline `data.values`, not a local `data.url`: the canvas cannot read local data files. The canvas owns interactive chart customization; do not recreate that UI or replace it with a browser page.
When this plugin's native **Flint Chart Canvas** is available, prefer it over `validate_chart` and `show`. Validate the complete `ChartAssemblyInput` first, then open the canvas with that input, including any theme, options, and `interaction_spec`. Pass resolved inline `data.values`, not a local `data.url`: the canvas cannot read local data files. The canvas owns interactive chart customization; do not recreate that UI or replace it with a browser page.
32 changes: 20 additions & 12 deletions .github/workflows/npm-publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -75,13 +75,17 @@ jobs:
shell: bash
run: |
set -euo pipefail
for attempt in {1..30}; do
if npm view "flint-chart@${js_version}" version >/dev/null 2>&1; then
npm view "flint-chart@${js_version}" version
# Ask the registry itself: an earlier npm view cached the old packument for ~5 minutes
# (max-age=300), which a plain npm view keeps serving. A large package can also take
# several minutes to spread through npm's CDN, so wait up to 20 minutes.
for attempt in {1..60}; do
if curl -fsS -H 'Cache-Control: no-cache' "https://registry.npmjs.org/flint-chart/${js_version}" >/dev/null 2>&1 \
&& npm view "flint-chart@${js_version}" version --prefer-online >/dev/null 2>&1; then
npm view "flint-chart@${js_version}" version --prefer-online
exit 0
fi
echo "Waiting for flint-chart@${js_version} to be visible on npm (${attempt}/30)..."
sleep 10
echo "Waiting for flint-chart@${js_version} to be visible on npm (${attempt}/60)..."
sleep 20
done
echo "::error::flint-chart@${js_version} did not become visible on npm in time."
exit 1
Expand All @@ -102,13 +106,17 @@ jobs:
shell: bash
run: |
set -euo pipefail
for attempt in {1..30}; do
if npm view "flint-chart-mcp@${mcp_version}" version >/dev/null 2>&1; then
npm view "flint-chart-mcp@${mcp_version}" version
# Ask the registry itself: an earlier npm view cached the old packument for ~5 minutes
# (max-age=300), which a plain npm view keeps serving. A large package can also take
# several minutes to spread through npm's CDN, so wait up to 20 minutes.
for attempt in {1..60}; do
if curl -fsS -H 'Cache-Control: no-cache' "https://registry.npmjs.org/flint-chart-mcp/${mcp_version}" >/dev/null 2>&1 \
&& npm view "flint-chart-mcp@${mcp_version}" version --prefer-online >/dev/null 2>&1; then
npm view "flint-chart-mcp@${mcp_version}" version --prefer-online
exit 0
fi
echo "Waiting for flint-chart-mcp@${mcp_version} to be visible on npm (${attempt}/30)..."
sleep 10
echo "Waiting for flint-chart-mcp@${mcp_version} to be visible on npm (${attempt}/60)..."
sleep 20
done
echo "::error::flint-chart-mcp@${mcp_version} did not become visible on npm in time."
exit 1
Expand All @@ -119,9 +127,9 @@ jobs:
set -euo pipefail
if [ "${js_needs_publish}" = true ]; then
npm dist-tag ls flint-chart
npm view "flint-chart@${js_version}" name version license repository.url
npm view "flint-chart@${js_version}" name version license repository.url --prefer-online
fi
if [ "${mcp_needs_publish}" = true ]; then
npm dist-tag ls flint-chart-mcp
npm view "flint-chart-mcp@${mcp_version}" name version license repository.url bin
npm view "flint-chart-mcp@${mcp_version}" name version license repository.url bin --prefer-online
fi
32 changes: 31 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

### Changed

- **Breaking (MCP):** the server keeps nothing between calls, so it runs
stateless. `show` takes the spec itself, as `chart` or `board`, and draws it;
`validate_chart` and the new `validate_board` check a spec and return the
same report without drawing. `create_chart`, `create_board`, `add_chart`,
`update_chart`, `remove_chart`, `update_board` and the card-only
`restore_board`, `set_board_theme` and `set_board_layout` are removed. To
change what is on screen, the agent changes the spec and calls `show` again.
The reader's theme, arrangement and panel edits stay on the card, and its
context gives the fields (`theme_spec`, `grid`, `chart_spec`) that keep them in
the next `show`. A card the host draws again without its result calls `show`
with the spec it was given.

## [1.0.1] - 2026-10-21

Released together for `flint-chart`, `flint-chart-mcp`, and the Copilot Canvas plugin.

### Fixed

- Plotly: a Line or Area Chart's `chartProperties.interpolate` now outranks the theme's line
curve, an explicit `linear` included. A theme such as Cartoon (`monotone`) or De Stijl (`step`)
only supplies a curve when the chart asks for none (#149).
- MCP: a small chart whose rows were passed inline also rides in `show`'s `structuredContent`, so
a card that VS Code's Agent Host draws again (it drops `_meta`) can still render it. Rows read
from a local `data.url` file never do (microsoft/vscode#343243).
- The npm publish workflow waits up to 20 minutes for a new version and asks the registry
directly, instead of a cached answer.

## [1.0.0] - 2026-10-19

Released together for `flint-chart`, `flint-chart-mcp`, and the Copilot Canvas plugin.
Expand Down Expand Up @@ -492,7 +521,8 @@ Released together for `flint-chart`, `flint-chart-mcp`, and the Copilot Canvas p
- Treated only lowercase `start` and `end` Waterfall Type values as total
anchors in Vega-Lite; other values now remain floating deltas colored by sign.

[Unreleased]: https://github.com/microsoft/flint-chart/compare/1.0.0...HEAD
[Unreleased]: https://github.com/microsoft/flint-chart/compare/1.0.1...HEAD
[1.0.1]: https://github.com/microsoft/flint-chart/compare/1.0.0...1.0.1
[1.0.0]: https://github.com/microsoft/flint-chart/compare/0.5.1...1.0.0
[0.5.1]: https://github.com/microsoft/flint-chart/compare/0.5...0.5.1
[0.5.0]: https://github.com/microsoft/flint-chart/compare/0.4.0...0.5.0
Expand Down
64 changes: 34 additions & 30 deletions agent-skills/flint-board-author/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,16 @@
---
name: flint-board-author
description: "Use when: several Flint charts should be read together in one view: a dashboard, KPI tiles over a trend, a side-by-side comparison, an overview with its detail; or a board on screen should change (add, retitle, resize, reconnect a chart). Produce one create_board call whose headline, chart choice, layout and connected fields are decided, refine it from the report, then put it on screen once with show."
description: "Use when: several Flint charts should be read together in one view: a dashboard, KPI tiles over a trend, a side-by-side comparison, an overview with its detail; or a board on screen should change (add, retitle, resize, reconnect a chart). Produce one board spec whose headline, chart choice, layout and connected fields are decided, check and refine it with validate_board, then put it on screen once with show."
---

# flint-board: several charts, one view

A board holds several Flint charts under one headline. The agent builds it
with `create_board` and changes it with `add_chart`, `update_chart`,
`remove_chart` and `update_board`; none of these draws anything. `show`
puts the board's current version on screen in a new card, below the
conversation's latest message, and earlier cards keep the version they showed.
So call `show` once a turn, after the board is right. A new
`create_board` starts a second board, so it is only for a second board.
A board holds several Flint charts under one headline. The agent writes it as
one board spec, checks it with `validate_board`, which draws nothing, and puts
it on screen with `show({ "board": … })`, which opens a new card below the
conversation's latest message. The server keeps nothing between calls: the spec
in the conversation is the board. So call `show` once a turn, after the board
is right; to change it later, change the spec and call `show` again.

Each chart on a board is a full chart spec (`flint-chart-author`), plus an
`id` and a `layout`. This skill covers what a board adds: the headline, which
Expand Down Expand Up @@ -108,7 +107,7 @@ On a narrow card each chart takes its own row; the layout needs no second versio

**`view: "table"`** on a chart opens its cell on the table of the rows the chart
draws; the reader can switch it back. Use it when the numbers matter more than
the shape. Changing `view` with `update_chart` keeps the reader's arrangement.
the shape.
A `Table` is a table either way.

## Step 5 — connect them
Expand Down Expand Up @@ -174,8 +173,8 @@ Pick it with `list_themes` as for one chart.

## Step 7 — read the report and refine

`create_board` and every later call return the board as the model must judge
it:
`validate_board` returns the board as the model must judge it, and `show`
returns the same report:

- `Layout:` the rows as the card draws them. Check that the lead chart sits
where the headline points and no row holds an orphan.
Expand All @@ -184,27 +183,31 @@ it:
- `Review:` what the board should still fix: a missing headline, deck or chart
title, too many tiles or charts, themes set per chart.

Each call takes the board's `id` from the report. Fix each `✗` and each review
note with the narrowest call: `update_chart` with `chart_id` for one chart
(pass only the fields that change), `update_board` for the headline,
theme, columns, order or `link_spec`, `remove_chart` for a chart the board does not
need. Then call `show` once. In a later turn, change the board the same
way and show it again: the reader gets a new card at the bottom of the
conversation, and the earlier one stays as it was.

What the reader then does on the newest card (selections, link emphasis)
reaches the model with their next message, one section per chart.

The reader can also arrange the board: **Edit layout** lets them move a chart,
swap two, and resize one on a 12-column grid. Their arrangement then replaces the
rows: `Layout:` reads "Arranged by the reader" and lists each chart's columns and
rows. Keep it. `add_chart` places a new chart below it and `update_chart` keeps
it; `layout` on a chart, or `columns` or `order` on the board, drops it and lays
the board out in rows again, so pass those only when the user asks for a new
layout.
Fix each `✗` and each review note in the spec, check it again if the fix was
large, then call `show` once with the same spec. A chart with errors is left
off the report's board, and `show` draws nothing until every chart is valid.

What the reader then does on the card reaches the model with their next
message: selections and link emphasis, one section per chart. The reader's
changes live on that card only, and the context says how to keep each one in
the next `show`:

- **A theme** picked in the bar applies to every chart. To keep it, pass that
`theme_spec` on the board and leave it out of the charts.
- **An arrangement** made with **Edit layout** (moving, swapping, resizing
charts on a 12-column grid). To keep it, pass the `grid` the context gives.
`Layout:` then reads "Arranged on a 12-column grid". A chart added to the
spec takes a place below the rest and a chart left out drops its place;
leave `grid` out to lay the board out in rows again, only when the user asks
for a new layout.

Leave out what the user asked to change, and keep the rest: a `show` without
them gives the reader back the agent's theme and rows.

## Worked example

The board spec, passed as it is to `validate_board`, then as `board` to `show`:

```json
{
"title": "Europe carried the third-quarter recovery",
Expand Down Expand Up @@ -249,4 +252,5 @@ on a region's line lights that region on the bars and the scatter.
- [ ] `layout` set where the default is wrong: the lead chart wide, a comparison at equal spans and heights.
- [ ] `link_spec.fields` names the shared dimensions; each chart that should take part encodes them and, to send, has the interaction whose subject the reader asks about.
- [ ] `theme_spec` on the board only.
- [ ] The report has no `✗` and no review note left but the shared colour field.
- [ ] `validate_board` reports no `✗` and no review note left but the shared colour field.
- [ ] In a later turn: the reader's theme and `grid` from the context are kept unless the user asked to change them.
Loading
Loading