astro

Patch Changes

• #9706 1539e04a8e5865027b3a8718c6f142885e7c8d88 Thanks @bluwy! - Removes redundant HMR handling code

• Updated dependencies [165cfc154be477337037185c32b308616d1ed6fa, e9a72d9a91a3741566866bcaab11172cb0dc7d31]:

  • @astrojs/[email protected]

Patch Changes

• #9643 e9a72d9a91a3741566866bcaab11172cb0dc7d31 Thanks @blackmann! - Removes unnecessary shikiji dependency

Patch Changes

• #9665 d02a3c48a3ce204649d22e17b1e26fb5a6a60bcf Thanks @bluwy! - Disables internal file watcher for one-off Vite servers to improve start-up performance

• #9664 1bf0ddd2777ae5f9fde3fd854a9e75aa56c080f2 Thanks @bluwy! - Improves HMR for Astro style and script modules

• #9668 74008cc23853ed507b144efab02300202c5386ed Thanks @Princesseuh! - Fix the passthrough image service not generating srcset values properly

• #9693 d38b2a4fe827e956662fcf457d1f1f84832c2f15 Thanks @kidylee! - Disables View Transition form handling when the action property points to an external URL

• #9678 091097e60ef38dadb87d7c8c1fc9cb939a248921 Thanks @ematipico! - Adds an error during the build phase in case i18n.routing.prefixDefaultLocale is set to true and the index page is missing.

• #9659 39050c6e1f77dc21e87716d95e627a654828ee74 Thanks @Princesseuh! - Fix Astro wrongfully deleting certain images imported with ?url when used in tandem with astro:assets

• #9685 35d54b3ddb3310ab4c505d49bd4937b2d25e4078 Thanks @lilnasy! - Fixes an issue where anchor elements within a custom component could not trigger a view transition.

Patch Changes

• #9666 cdf8ce06271b8b5e474186a3cd6d7925c423a4a6 Thanks @martrapp! - Fixes an issue where Partytown scripts didn't execute after view transition

Patch Changes

• #9642 cdb7bfa66260afc79b829b617492a01a709a86ef Thanks @martrapp! - Fixes an issue where View Transitions did not work when navigating to the 404 page

• #9637 5cba637c4ec39c06794146b0c7fd3225d26dcabb Thanks @bluwy! - Improves environment variables replacement in SSR

• #9658 a3b5695176cd0280438938c1d6caef478a571415 Thanks @martrapp! - Fixes an issue caused by trying to load text/partytown scripts during view transitions

• #9657 a4f90d95ff97abe59f2a1ef0956cab257ae36838 Thanks @ematipico! - Fixes a bug where the custom status code wasn't correctly computed in the dev server

• #9627 a700a20291e19cde23705e8e661e833aec7d3095 Thanks @lilnasy! - Adds a warning when setting cookies will have no effect

• #9652 e72efd6a9a1e2a70488fd225529617ffd8418534 Thanks @bluwy! - Improves environment variables handling by using esbuild to perform replacements

• #9560 8b9c4844f7b302380835154fab1c3489979fc07d Thanks @bluwy! - Fixes tsconfig alias with import.meta.glob

• #9653 50f39183cfec4a4522c1f935d710e5d9b724993b Thanks @Princesseuh! - Pin Sharp to 0.32.6 until we can raise our semver requirements. To use the latest version of Sharp, you can add it to your project's dependencies.

Patch Changes

• #9648 d7f1903cded3e864b392d1dd7502672d37936f11 Thanks @lilnasy! - Fixes an issue where the serverless function could not respond with a prerendered 404 page.

Patch Changes

• #9652 e72efd6a9a1e2a70488fd225529617ffd8418534 Thanks @bluwy! - Removes environment variables workaround that broke project builds with sourcemaps

Patch Changes

• #9476 651f45b4010ad9b8d9f61fdc748618e220fe5375 Thanks @ElianCodes! - Improves seasonal message handling by automatically detecting the local date

Patch Changes

• #9610 24663c9695385fed9ece57bf4aecdca3a8581e70 Thanks @florian-lefebvre! - Fixes the RSS schema to make the title optional if the description is already provided. It also makes pubDate and link optional, as specified in the RSS specification.

Patch Changes

• #9618 401fd3e8c8957a3bed6469a622cd67b157ca303f Thanks @ldh3907! - Adds a second generic parameter to APIRoute to type the params

• #9600 47b951b3888a5a8a708d2f9b974f12fba7ec9ed3 Thanks @jacobdalamb! - Improves tailwind config file detection when adding the tailwind integration using astro add tailwind

  Tailwind config file ending in .ts, .mts or .cts will now be used instead of creating a new tailwind.config.mjs when the tailwind integration is added using astro add tailwind.

• #9622 5156c740506cbf6ec85c95e1663c14cbd438d75b Thanks @bluwy! - Fixes the Sharp image service limitInputPixels option type

Patch Changes

• #9591 22a5405b4a4b7948458ad170b0a7bde6954058c1 Thanks @lilnasy! - Fixes an issue where 404.astro was not used in static mode.

• #9598 bd8fa7acd23ba6e7afa2c435807bd5fd6b24f505 Thanks @lilnasy! - Marks the speedInsights configuration as deprecated. Vercel has migrated features of the Speed Insights API into a framework-agnostic library with @vercel/speed-insights. See Vercel Speed Insights Quickstart for instructions on how to use the library instead.

Patch Changes

• #9620 a1bb5fea552ce65585f49ecb6701733c48d117f9 Thanks @bluwy! - Fixes class property hydration error

• #9490 a1c31665cbc48bfdf4885112b427db48ecc48276 Thanks @natemoo-re! - Fixes a bug that caused styles referenced by appEntrypoint to be excluded from the build

Patch Changes

• #9355 2e4d110a876efc4ddcdeda403259317d1cbb742d Thanks @marvin-j97! - Upgrades vite-plugin-solid to ^2.8.0

Minor Changes

• #9513 e44f6acf99195a3f29b8390fd9b2c06410551b74 Thanks @wtto00! - Adds a 'load' prefetch strategy to prefetch links on page load

• #9377 fe719e27a84c09e46b515252690678c174a25759 Thanks @bluwy! - Adds "Missing ARIA roles check" and "Unsupported ARIA roles check" audit rules for the dev toolbar

• #9573 2a8b9c56b9c6918531c57ec38b89474571331aee Thanks @bluwy! - Allows passing a string to --open and server.open to open a specific URL on startup in development

• #9544 b8a6fa8917ff7babd35dafb3d3dcd9a58cee836d Thanks @bluwy! - Adds a helpful error for static sites when you use the astro preview command if you have not previously run astro build.

• #9546 08402ad5846c73b6887e74ed4575fd71a3e3c73d Thanks @bluwy! - Adds an option for the Sharp image service to allow large images to be processed. Set limitInputPixels: false to bypass the default image size limit:

  // astro.config.mjs
  import { defineConfig } from 'astro/config';
  
  export default defineConfig({
    image: {
      service: {
        entrypoint: 'astro/assets/services/sharp',
        config: {
          limitInputPixels: false,
        },
      },
    },
  });
  

• #9596 fbc26976533bbcf2de9d6dba1aa3ea3dc6ce0853 Thanks @Princesseuh! - Adds the ability to set a rootMargin setting when using the client:visible directive. This allows a component to be hydrated when it is near the viewport, rather than hydrated when it has entered the viewport.

  <!-- Load component when it's within 200px away from entering the viewport -->
  <Component client:visible={{ rootMargin: '200px' }} />
  

• #9063 f33fe3190b482a42ebc68cc5275fd7f2c49102e6 Thanks @alex-sherwin! - Cookie encoding / decoding can now be customized

  Adds new encode and decode functions to allow customizing how cookies are encoded and decoded. For example, you can bypass the default encoding via encodeURIComponent when adding a URL as part of a cookie:

  ---
  import { encodeCookieValue } from './cookies';
  Astro.cookies.set('url', Astro.url.toString(), {
    // Override the default encoding so that URI components are not encoded
    encode: (value) => encodeCookieValue(value),
  });
  ---
  

  Later, you can decode the URL in the same way:

  ---
  import { decodeCookieValue } from './cookies';
  const url = Astro.cookies.get('url', {
    decode: (value) => decodeCookieValue(value),
  });
  ---
  

Patch Changes

• #9593 3b4e629ac8c2fdb4b491bf01abc7794e2e100173 Thanks @bluwy! - Improves astro add error reporting when the dependencies fail to install

• #9563 d48ab90fb41fbc0589cd2df711682a41382c03aa Thanks @martrapp! - Fixes back navigation to fragment links (e.g. #about) in Firefox when using view transitions

  Co-authored-by: Florian Lefebvre [email protected]
  Co-authored-by: Sarah Rainsberger [email protected]

• #9597 9fd24a546c45d48451da46637c14e7ed54dac76a Thanks @lilnasy! - Fixes an issue where configuring trailingSlash had no effect on API routes.

• #9586 82bad5d6205672ed3f6a49d4de53d3a68367433e Thanks @martrapp! - Fixes page titles in the browser's drop-down for back / forward navigation when using view transitions

• #9575 ab6049bd58e4d02f47d500f9db08a865bc7f09b8 Thanks @bluwy! - Sets correct process.env.NODE_ENV default when using the JS API

• #9587 da307e4a080483f8763f1919a05fa2194bb14e22 Thanks @jjenzz! - Adds a CSSProperties interface that allows extending the style attribute

• #9513 e44f6acf99195a3f29b8390fd9b2c06410551b74 Thanks @wtto00! - Ignores 3g in slow connection detection. Only 2g and slow-2g are considered slow connections.

Major Changes

• #6791 37021044dd4382a9b214f89b7c221bf1c93f3e7d Thanks @patdx! - Render SolidJS components using renderToStringAsync.

  This changes the renderer of SolidJS components from renderToString to renderToStringAsync. It also injects the actual SolidJS hydration script generated by generateHydrationScript, so that Suspense, ErrorBoundary and similar components can be hydrated correctly.

  The server render phase will now wait for Suspense boundaries to resolve instead of always rendering the Suspense fallback.

  If you use the APIs createResource or lazy, their functionalities will now be executed on the server side, not just the client side.

  This increases the flexibility of the SolidJS integration. Server-side components can now safely fetch remote data, call async Astro server functions like getImage() or load other components dynamically. Even server-only components that do not hydrate in the browser will benefit.

  It is very unlikely that a server-only component would have used the Suspense feature until now, so this should not be a breaking change for server-only components.

  This could be a breaking change for components that meet the following conditions:

  • The component uses Suspense APIs like Suspense, lazy or createResource, and
  • The component is mounted using a hydrating directive:
    • client:load
    • client:idle
    • client:visible
    • client:media

  These components will now first try to resolve the Suspense boundaries on the server side instead of the client side.

  If you do not want Suspense boundaries to be resolved on the server (for example, if you are using createResource to do an HTTP fetch that relies on a browser-side cookie), you may consider:

  • changing the template directive to client:only to skip server side rendering completely
  • use APIs like isServer or onMount() to detect server mode and render a server fallback without using Suspense.

Minor Changes

• #9524 0903ef90494e9c8bd0272347a0cdd51eca7f4648 Thanks @aleksandrjet! - Allows rendering lazy components.

  You can now use lazy components with Suspense:

  import { lazy, Suspense } from 'preact/compat';
  
  const HeavyComponent = lazy(() => import('./HeavyComponent'));
  
  const Component = () => {
    return (
      <Suspense fallback={<p>Loading...</p>}>
        <HeavyComponent foo="bar" />
      </Suspense>
    );
  };
  

Minor Changes

• #9470 607303be198931825dac9f3bc97867b4886feaf3 Thanks @onsclom! - Improves the create astro CLI experience by asking all the questions upfront, then creating your new Astro project based on your responses.

Patch Changes

• #9571 ec71f03cfd9b8195fb21c92dfda0eff63b6ebeed Thanks @bluwy! - Removes telemetry for unhandled errors in the dev server

• #9548 8049f0cd91b239c52e37d571e3ba3e703cf0e4cf Thanks @bluwy! - Fixes error overlay display on URI malformed error

• #9504 8cc3d6aa46f438d668516539c34b48ad748ade39 Thanks @matiboux! - Implement i18n's getLocaleByPath function

• #9547 22f42d11a4fd2e154a0c5873c4f516584e383b70 Thanks @bluwy! - Prevents ANSI codes from rendering in the error overlay

• #9446 ede3f7fef6b43a08c9371f7a2531e2eef858b94d Thanks @alexnguyennz! - Toggle dev toolbar hitbox height when toolbar is visible

• #9572 9f6453cf4972ac28eec4f07a1373feaa295c8864 Thanks @bluwy! - Documents supported --host and --port flags in astro preview --help

• #9540 7f212f0831d8cd899a86fb94899a7cad8ec280db Thanks @matthewp! - Fixes remote images with encoded characters

• #9559 8b873bf1f343efc1f486d8ef53c38380e2373c08 Thanks @sygint! - Adds 'starlight' to the displayed options for astro add

• #9537 16e61fcacb98e6bd948ac240bc082659d70193a4 Thanks @walter9388! - <Image /> srcset now parses encoded paths correctly

Patch Changes

• #9550 7b586a6e23e25653814db9adea9674ec3a9bd535 Thanks @lilnasy! - Fixes an issue where a build could not complete on Node 21.

Patch Changes

• #9562 67e06f9db1b0492ccfb4b053762dc91d69a53ecb Thanks @DET171! - Updates the command used for installing packages with pnpm and yarn