Guides
Changelog
Track notable changes to Astro Components.
This changelog covers user-facing changes to @prosefly/astro-components,
including components, markdown transforms, integration behavior, styling tokens,
and documentation.
Unreleased
0.7.0
September 10, 2026- Added
AudioPlayer, a themed audio surface with artwork and metadata, playback-speed controls, seeking, mute, native-audio fallback, and Media Session integration. - Added
Embedfor explicit metadata and URL-based embeds. URL resolution supports selected oEmbed and Schema.org providers before falling back to OpenGraph, with normalized provider HTML and persistent metadata caching. - Added build-time Mermaid rendering through
rehypeMermaid. Fencedmermaidcode blocks now become responsive, themed SVG diagrams in Markdown and MDX without a browser Mermaid runtime. - Image-only paragraphs are now transformed by the
remarkImageGalleryMDX-only plugin into the publicImageGallerycomponent. Gallery CSS and runtime are bundled only on pages that use the component; ordinary.mdpages are not transformed. - Breaking: Removed the former
rehypeImageGalleryexport and themarkdown/image-gallery.cssandmarkdown/image-gallery.jssubpaths. UseremarkImageGalleryor the publicImageGallerycomponent instead; both own their required styles and runtime.
0.6.2
September 2, 2026- Inject image gallery css when astro build.
0.6.1
August 30, 2026- Package builds no longer include external JavaScript or declaration sourcemaps that point to unpublished source files, avoiding Vite missing-source warnings.
0.6.0
August 30, 2026- Added the
@prosefly/astro-components/integrationintegration to own shared icon preloading, Markdown transforms, and image-gallery assets. - Package-manager tabs now preserve syntax-highlighted generated code while avoiding duplicate Expressive Code frame chrome inside tab panels.
- Simplified the Expressive Code public API: use the
@prosefly/astro-components/expressive-codeentry forexpressiveCodeHeaderIconsandExpressiveCodeHeaderIconsOptions; internal icon and label helpers are no longer public exports, making that entry the unique public Expressive Code API. - Updated the installation, integration, Expressive Code, and package-manager tabs documentation for the shared integration and its independent plugin entry.
0.5.1
August 24, 2026- Expanded Expressive Code language labels from common aliases such as
ts,py, andmdtotypescript,python, andmarkdown. - Clarified internal utility module names and centralized shared language-label and Iconify helpers.
0.5.0
July 25, 2026- Moved component state styling hooks from modifier classes to
data-*attributes while keeping BEM classes for structure. - Added an Expressive Code header icon plugin that can display file-type icons for code frames.
- Added language labels for Expressive Code frames without titles.
- Skipped Expressive Code terminal frames because their frame already indicates terminal context.
0.4.1
July 20, 2026- Added
--pf-badge-radiussoBadgecorner radius can be customized independently from the global pill radius.
0.4.0
July 20, 2026- Renamed the component CSS, data attribute, and custom property namespace from
pltopf. - Added default light/dark token fallbacks for standalone component styles.
0.3.0
July 19, 2026- Added
remarkCalloutDirectivesfor writing callouts, also known as admonitions, with Markdown directive syntax. - Changed
Cardtitles to render as non-heading text so cards do not affect page heading hierarchy. - Exposed callouts as
role="note"instead of complementary landmarks. - Added unit tests for the markdown transforms.
- Updated markdown setup examples to use Astro’s
unified()processor API.
0.2.1
July 18, 2026- Fixed the
@prosefly/astro-components/iconESM entry by moving the FileTree icon helper into the icon module and using explicit.jsimports.
0.2.0
July 18, 2026FileTreenow supportsiconSet="vscode-icons"for richer file-type icons.- Semantic badge colors for
info,success,warning, anddanger. - Shared semantic CSS tokens for status-oriented components.
- Callout colors now use the shared semantic token palette, with type-specific callout override tokens still available.
0.1.0
July 17, 2026- MDX components for callouts, cards, tabs, accordions, file trees, steps, badges, and icons.
- Iconify preload integration for projects that need icons without the full Lotus theme.
- Markdown transforms for package-manager tabs and image galleries.
- CSS custom properties for shared typography, color, radius, and component styling.