Skip to content

Migrate to new MalloyRenderer API and improve visualization docs#293

Merged
mtoy-googly-moogly merged 1 commit intomainfrom
renderer-migration-and-docs-cleanup
Mar 11, 2026
Merged

Migrate to new MalloyRenderer API and improve visualization docs#293
mtoy-googly-moogly merged 1 commit intomainfrom
renderer-migration-and-docs-cleanup

Conversation

@mtoy-googly-moogly
Copy link
Contributor

Summary

  • Migrate from <malloy-render> web component to new MalloyRenderer JS API — the old web component is no longer exported by @malloydata/render. Now uses createViz() / setResult() / render() pattern with API.util.wrapResult() for serialization.
  • Fix CSS bleed from Shadow DOM removal — scope div.header rule to div.top > div.header, add table reset block inside .result-inner to prevent site styles from bleeding into renderer output.
  • Upgrade @malloydata/malloy and @malloydata/render to 0.0.358, remove unused jsdom / @types/jsdom dependencies.
  • Clean up renderer docs — delete renderer.malloynb, legacy_renderer.malloynb, renderer_next.malloynb; consolidate TOC under single "Visualizations" section.
  • Add tag parameter reference to each visualization page (bar charts, line charts, scatter charts, dashboards, lists, numbers, links, pivots, transpose, shape maps, segment maps).
  • Add quick reference cheatsheet to the visualizations overview page with links to individual pages.
  • Fix typos across multiple doc pages.

Test plan

  • npm run build completes without errors
  • Verify charts render correctly on key pages (numbers, bar charts, line charts, scatter charts)
  • Verify tables have correct font size (12px, not 22px)
  • Verify pivot tables, dashboards, and maps render correctly
  • Verify links in overview cheatsheet point to correct pages
  • Verify deleted renderer docs pages return 404 / are not linked

🤖 Generated with Claude Code

- Migrate from <malloy-render> web component to MalloyRenderer JS API
  (createViz/setResult/render) using stable Malloy.Result via wrapResult()
- Move UMD script to <head> so it loads before inline render scripts
- Fix CSS style bleed: scope div.header to div.top > div.header,
  add table style resets inside .result-inner
- Update UMD path from dist/webcomponent to dist/module
- Remove legacy renderer code paths, HTMLView, JSDOM dependencies
- Add build-time render tag validation via @malloydata/render-validator
- Delete obsolete renderer pages and clean up TOC into single
  "Visualizations" section
- Add tag property reference tables to all 11 visualization doc pages
- Add quick reference cheatsheet to overview page
- Fix typos across 7 doc files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@mtoy-googly-moogly mtoy-googly-moogly merged commit 78dfac2 into main Mar 11, 2026
5 checks passed
@mtoy-googly-moogly mtoy-googly-moogly deleted the renderer-migration-and-docs-cleanup branch March 11, 2026 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant