v0.4.0

v0.4.0 is the next major release.

👉 Changelog

compare changes

🚀 Enhancements

• tests: add comark-tests (#138)
• code-notes: add comark-code-notes (#134)
• xref: add comark-xref (#130)
• table: add comark-table (#126)
• keys: add comark-keys (#124)
• footnotes: add comark-footnotes (#123)
• cast: add comark-cast (#122)
• cjk: add comark-cjk (#116)
• metrics: add comark-metrics (#114)
• diagrams: add comark-diagrams (#137)
• sources: add comark-sources (#132)
• properties: add comark-properties (#128)
• links: add comark-links (#121)
• critic: add comark-critic (#115)
• colors: add comark-colors (#111)
• lint: a rule and a Doctor page for every plugin issue (#143)
• annotate: margin notes: bottom notes, at and to, curved leaders, a bracket mark, violet by default, and one ink per figure (#145)
• tabs: package-manager tabs from one install command (#109)
• media: play videos and audio with controls on the shadcn/ui tokens (#148)
• figure: add comark-figure (#118)
• mark: add comark-mark (#113)
• qr: add comark-qr (#135)
• outline: add comark-outline (#125)
• deflist: add comark-deflist (#110)
• details: add comark-details (#127)
• lint: validate links across files, block local and preview URLs, and check URLs on request (#120)
• file-tree: add comark-file-tree (#119)
• fields: add comark-fields (#133)
• reading-time: add comark-reading-time (#136)
• code: line markers, diffs, collapsed ranges, line numbers, and terminal frames (#117)
• media: add comark-media (#108)
• badge: add comark-badge (#129)
• cards: add comark-cards (#131)
• steps: add comark-steps (#112)
• docs: recipes in the playground and on the landing canvas, and an icon card on the landing (#106)
• chips: show X, Bluesky, YouTube, and GitLab avatars through unavatar.io and keep images on disk between builds (#104)
• docs: fill the landing canvas with every example and turn chart cards through their charts (#103)
• charts: draw any Vega-Lite chart over the table (#101)
• charts: draw while parsing, and render with Vue, React, and Svelte (#99)
• code: --ck-title-font for the header's title, and a Theming page for comark-diff (#92)
• code: a header above the code with its file's name and the buttons, and actions with an icon and an onCodeAction() callback (#86)
• diff: move ::diff out of comark-annotate into its own package, comark-diff (#73)
• chips: a tinted chip with a hairline ring that stays in the line, --cp-* variables, and a Theming page (#83)
• charts,embed: a Theming page for annotate, charts, embed, github, and icon, with CSS variables for a chart's side padding and a Short's width (#84)
• tabs: slide the open tab's highlight to the tab you pick (#85)
• CSS variables and a Theming page for zoom, carousel, tabs, and code (#81)
• ⚠️ require comark 0.8, whose parser keeps Markdown inside HTML blocks (#75)
• github: rename comark-github-callouts to comark-github, and add @user and #123 references and GitHub's HTML allowlist (#74)
• chips: links and @mentions as chips with the site's favicon or the person's avatar (#76)
• annotate: numbers pick a free corner, and marks are bolder, hug their target, and each wobble their own way (#66)
• tabs: add an icon prop, drawn by comark-icon from Iconify names or image URLs (#51)
• icon: add comark-icon, Iconify icons in Markdown drawn as CSS, and a resolver other plugins share (#54)
• code: add comark-code, copy and wrap buttons on code blocks and actions of your own (#46)
• annotate: handwrite side notes and labels in an inlined Caveat by default (#57)
• annotate,charts: export the agent skill so apps can bundle it, and have it mark only what changed (#52)
• charts: add comark-charts, charts drawn from Markdown tables that agents read as data (#44)
• tabs: add comark-tabs, tabs and code groups that read without a script and sync by label (#37)
• lint: add comark-lint, a linter for Comark documents (#38)
• include: include Markdown partials and code snippets from files (#34)
• annotate: add ::diff, a code change shown like a suggested change in a review (#39)
• embed: add comark-embed, players for video, audio, and tools from a link (#35)
• annotate: copy a screenshot with its marks, and list side notes under compared screenshots (#26)
• ⚠️ ESM-only exports and a Node >=22.12 engines floor (#31)
• annotate: a zoomed screenshot shows its notes beside it, and a mark lights up its note there (#15)
• github-callouts: GitHub's > [!NOTE] alerts as shadcn-style callouts (#23)
• annotate: a slider mode for compare (#17)
• ⚠️ zoom: data-zoom-aside shows a caption beside the zoomed item, and the events map copies to the page and back (#14)

🩹 Fixes

• docs: calm the landing cards, tidy the switches and list, and show a package's examples in its sidebar (#107)
• chips: draw avatar chips without a pill, and fade favicon chips' tint and ring (#149)
• badge: default primary to shadcn's --primary, secondary to the muted text, and error to --destructive (#142)
• docs: draw the preset card's border over its divider (#144)
• steps: keep the line between steps on pages that style heading margins (#140)
• docs: scroll the playground's presets to the one a link opens (#139)
• docs: jump to the new page's position instead of sliding there (#105)
• charts: draw dumbbell gridlines and tighter rows so the change reads at a glance (#97)
• docs: resolve generated landing path from module (#87)
• docs: center the landing canvas before its first paint after a client navigation (#100)
• docs: serve the pages build.ts renders, so the Nuxt site has the landing canvas, rail, search, and header again (aaed586)
• docs: serve generated landing body and harden canvas interactions (d8eff8c)
• docs: render fixed hero and reset pooled copy state (4be2e65)
• docs: fetch server island body directly (025115c)
• charts: marks on their points, every month labeled, notes in their own style, and readable labels on areas (#91)
• annotate,carousel: badges stay on their own mark, and carousel slides align to the top (#90)
• zoom,tabs: a gap between grouped blocks, centered thumbnails, visible gallery arrows, and a raised selected tab in dark (#89)
• chips: name the chip .cp, so a chart on the same page stops drawing as a gray pill (#82)
• docs: resolve build merge conflict (4d15d0c)
• drop the stale code page, name the linter's command lint-comark everywhere, lint ::embed, and correct three LICENSE files (#77)
• lint: publish as comark-linter, since npm refuses comark-lint as too close to remark-lint (#55)
• lint: know comark-tabs' :::tabs-item and ::code-group, which its renderer has no component for (#59)
• lint: never throw on odd frontmatter or huge entities, and place and find diagnostics correctly (#43)
• annotate: ::diff marks whole characters, keeps highlights, follows a .dark theme, and looks like a shadcn Card (#41)
• annotate: Control+C copies a zoomed screenshot again, and the SVG clone states its safety (#33)
• github-callouts: bundle only the theme from comark-zoom, so callouts don't install zoom or ship its styles (#29)
• annotate: draw lighter marks and keep their numbers off the target (#28)
• zoom: keep ComarkZoomEventMap, which #14 named for hosts that extend the events (#27)
• zoom: the HTML renderer's script shows the aside and maps copies too (#25)
• green CI on main after #14 and #17 (#24)

💅 Refactors

• docs: keep each package's pages in its own docs/ folder, like VueUse (#79)
• lint: rename comark-lint to lint-comark, since npm blocks a name that close to remark-lint (#67)

📖 Documentation

• a still canvas of every example, open examples in the sidebar, a page per annotate component, and plainer prose (#150)
• charts: add a performance example, page load before and after a fix (#147)
• fields: say which margins sit outside the layer's override rule (#146)
• say "Built on Comark" in the footer, without crediting the Comark team for this site (#102)
• chips: show links as a pull request would cite them, not a credits line (#98)
• calm the landing, so the canvas holds still and cards and the studio play on hover (6d87481)
• count the plugins on the banner and Open Graph image instead of naming comark-annotate (96458dd)
• build the site with Nuxt 5 and @vite-hub/content (#45)
• a Theme pane in the playground to try the --comark-* tokens live (#94)
• embed: a Live code example that runs embedded, and why WebContainer projects need an isolated page (#93)
• clearer example names, marks on what their notes describe, correct numbers, and legible playground cards (#88)
• one container per canvas card, and a studio made for agents whose document uses five plugins (90b689a)
• a canvas of live plugin demos on the landing page, and a studio that writes, checks, fixes, and renders (37805e6)
• copy and reset in the playground editor's corner, a plain Config pane, and a search box whose icon stays put (#72)
• silly examples from a made-up correlations app, an Open Graph image, and a README banner (#70)
• lint: a guide for running comark-lint next to ESLint or oxlint, and as part of Vite Doctor (#68)
• credit each package in its own footer, and give the playground a Config tab (#61)
• a landing page like vitehub.dev, with a package grid, Drop, a starred GitHub button, and a new logo (#65)
• code: give comark-code a docs section and put it in the playground (#71)
• name the playground's Config pane as a file (#69)
• a Config tab in the playground, and preset stills that show their whole example (#62)
• add npmx and docs badges to every package README (#64)
• promote Drop at the bottom of the sidebar (#63)
• a landing page that types its Markdown, a rail that widens on hover, and a Vite Doctor page (#60)
• add a recipe for sharing a review, on Drop or a page you host (#58)
• list comark-charts' skill, and show how an app bundles a skill that matches its renderer (#53)
• one section per package, with an icon rail and a playground (#50)
• compare comark-charts with comark-vega and comark-flint-chart (#48)
• group the site into guides, recipes, and package pages (#47)
• github-callouts: say what Comark's built-in alert plugin does and what this package adds (#30)

📦 Build

• share one tsdown preset across packages, and name annotate's browser script script.ts like zoom's (#78)

✅ Tests

• check that every package is registered everywhere a new one has to be (#80)

🎨 Styles

• embed: border the player, add link icons, lay the card out as a shadcn Item, and stop dark iframes flashing white (#40)

🤖 CI

• release: publish to npm directly instead of staging for approval (#42)
• one vp check step, and the tests on Node 22.12 (#32)

🎉 New Contributors

• vitehub-bot[bot] (@vitehub-bot[bot])

❤️ Contributors

• onmax (@onmax)
• vitehub-bot[bot] (@vitehub-bot[bot])