Changelog
Every release of Astro Eclipse, newest first.
The current version is 1.6.0. This page is copied from packages/astro-eclipse/CHANGELOG.md at build time, the same file that ships in the npm package.
All notable changes to this project are documented here. The format follows Keep a Changelog, and the project follows Semantic Versioning.
[1.6.0] - 2026-11-09
Added
valuesoption: maps a theme to the DOM value written to<html>({ dark: 'theme-dark' }), or to several space-separated classes in class mode. Storage,getTheme(),getPreference()andonThemeChangekeep the theme names. Adds code to the head script only when set.- A guide on Content Security Policy, backed by tests: the head script is in Astro’s CSP policy, a hand-written policy needs its hash, and what
script-src 'self'alone does.
Fixed
- Under a strict
style-src(Astro’s CSP support sets one), the reveal’s<style>element was blocked and the browser’s default cross-fade played along with the effect. The runner and the CSS guard now use constructed stylesheets, whichstyle-srcdoes not block. A browser that cannot adopt stylesheets goes without the CSS guard. test:packfailed on Astro 5.0.0 and 6 because it expected no whitespace around option text.
[1.5.0] - 2026-11-09
Added
forcedThemeoption: a page with<html data-eclipse-forced="dark">shows that theme on first paint, after ClientRouter navigation and aftersetTheme, without touching the visitor’s saved choice.getTheme()returns the forced theme,getPreference()the stored one, andsetThemestores without applying.ThemeToggle,ThemeSelectandThemeRadioare disabled on a forced page. Adds about 45 B to the head script only when turned on.disableCssTransitionsoption: suppresses CSS transitions and animations for the frame of a theme change made through the client API, so elements with their owntransitionchange with the reveal.ThemeChange.forced: the forced theme, orundefined.
Changed
- The client API size budget is 4.7 kB (was 4.5 kB).
[1.4.0] - 2026-11-09
Added
ThemeRadioinastro-eclipse/components: a native radio group (<fieldset>and<legend>) for the themes andSystem. It shows the visitor’s preference, stays in sync with other controls, tabs and system mode, starts the reveal at the chosen radio, and takes the same props asThemeSelect.headlessoption: any element withdata-eclipse-set="<theme>"switches the theme on click, with optionaldata-transition,data-durationanddata-direction. It adds one page script (about 270 B gzipped) only when turned on.getSystemTheme()andthemesinastro-eclipse/client: the scheme the device prefers right now, and the configured theme names.
Changed
package.jsonlistsdist/client/headless.jsundersideEffects(it wasfalse), so bundlers keep the headless page script.
[1.3.0] - 2026-11-09
Added
- Docs: a shadcn/ui guide, a
transition:persisttoggle recipe, a multi-page (noClientRouter) guide, and a migration guide for astro-color-scheme, astro-theme-toggle and hand-written scripts. - Docs: the Tailwind 4 snippets now state the versions they were built with.
Changed
- Tests only, no change to the package code: branch coverage is 100% and enforced, and the public types have type tests.
[1.2.0] - 2026-11-09
Added
ThemeSelectinastro-eclipse/components: a native<select>that lists the themes and aSystemoption, shows the visitor’s preference, stays in sync with other controls, tabs and system mode, and starts the reveal at the select. Props:themes,system,labels,label,transition,duration,direction,class.
[1.1.0] - 2026-11-06
Added
colorSchemeoption: maps a theme tolightordarkand setscolor-schemeon<html>, so native controls and scrollbars match custom themes.themeColoroption: maps a theme to a color and keeps<meta name="theme-color">in step, creating the tag when missing.- Both are opt-in, apply before first paint, on ClientRouter swaps, on system and cross-tab changes and in
setTheme, and add no code to the head script when unset.
Changed
- Head script budget for a config with both options is 1 kB gzip (default config stays under 700 B).
[1.0.0] - 2026-11-03
Added
- Astro integration with a typed config: themes, default (or
system),data-*attribute orclass, storage key, default transition and duration. - Inline head script that sets the theme before first paint, follows
prefers-color-schemelive, syncs other tabs and re-applies the theme onastro:before-swap. astro-eclipse/client:setTheme,toggleTheme,getTheme,getPreference,onThemeChangeanddefineTransition.- View Transitions runner with
circle,circle-inverse,wipe,diamond,iris,blinds,blur-circle,star,diagonal,diagonal-soft,split,scan,slide,zoom,square,triangle,sunburst,cross,heart,ripple,clock,curtain,stairs,mosaic,blur,flip,spin,cover,revealandfade, an instant fallback, reduced-motion handling and a guard against Astro’s own page transition.wipe,blinds,diagonal,diagonal-soft,split,scan,slide,curtain,stairs,flip,coverandrevealtake adirection. astro-eclipse/componentswithThemeToggle: a real button whose accessible name states the current and next theme, with forced-colors styles, alabelprop for the name, validatedthemesand attribute passthrough.