Merge pull request #1713 from analogjs/beta

chore: release 1.16.0

Author: brandonroberts

.all-contributorsrc

@@ -1287,6 +1287,24 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "vsternbach",
+      "name": "Vlad Sternbach",
+      "avatar_url": "https://avatars.githubusercontent.com/u/3830668?v=4",
+      "profile": "https://github.com/vsternbach",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "meeroslav",
+      "name": "Miroslav Jonaš",
+      "avatar_url": "https://avatars.githubusercontent.com/u/881612?v=4",
+      "profile": "https://github.com/meeroslav",
+      "contributions": [
+        "infra"
+      ]
     }
   ],
   "contributorsPerLine": 7,

.gitignore

@@ -68,4 +68,4 @@ tmpanalogapp*
 .nx/workspace-data
 vite.config.*.timestamp*
 .vite-inspect
-vitest.config.*.timestamp*
+vitest.config.*.timestamp*

CHANGELOG.md

@@ -1,3 +1,93 @@
+# [1.16.0-beta.15](https://github.com/analogjs/analog/compare/v1.16.0-beta.14...v1.16.0-beta.15) (2025-04-28)
+
+### Bug Fixes
+
+- **vite-plugin-angular:** allow the plugin to be imported with commonjs/require ([#1710](https://github.com/analogjs/analog/issues/1710)) ([84cb758](https://github.com/analogjs/analog/commit/84cb758f6bb256fa5c9875a6bdf5564bcbc80ca5))
+
+# [1.16.0-beta.14](https://github.com/analogjs/analog/compare/v1.16.0-beta.13...v1.16.0-beta.14) (2025-04-24)
+
+### Bug Fixes
+
+- **platform:** allow marked extensions to add new renderers ([#1708](https://github.com/analogjs/analog/issues/1708)) ([a0bfb70](https://github.com/analogjs/analog/commit/a0bfb705c097f12bfd13f46f8da516c1eff0033c))
+
+# [1.16.0-beta.13](https://github.com/analogjs/analog/compare/v1.16.0-beta.12...v1.16.0-beta.13) (2025-04-24)
+
+### Features
+
+- **content:** add ability to pass extensions to marked instance ([#1707](https://github.com/analogjs/analog/issues/1707)) ([47d1598](https://github.com/analogjs/analog/commit/47d15989fdcfa3a9dfa072ebe5925381b6812cbb))
+
+# [1.16.0-beta.12](https://github.com/analogjs/analog/compare/v1.16.0-beta.11...v1.16.0-beta.12) (2025-04-24)
+
+### Bug Fixes
+
+- **storybook-angular:** adjust vite peer dep ([17e23d5](https://github.com/analogjs/analog/commit/17e23d5bd75d56e6f5957ff7509c649ad807a226))
+
+# [1.16.0-beta.11](https://github.com/analogjs/analog/compare/v1.16.0-beta.10...v1.16.0-beta.11) (2025-04-24)
+
+### Bug Fixes
+
+- **storybook-angular:** adjust peer deps versions ([0042da6](https://github.com/analogjs/analog/commit/0042da6955e170f6f9e2ee6865e0b72525318366))
+
+# [1.16.0-beta.10](https://github.com/analogjs/analog/compare/v1.16.0-beta.9...v1.16.0-beta.10) (2025-04-24)
+
+### Bug Fixes
+
+- **storybook-angular:** move storybook to peer deps ([dc91f4b](https://github.com/analogjs/analog/commit/dc91f4be0af0dcccef4b0380b0861399e3cf185d))
+
+# [1.16.0-beta.9](https://github.com/analogjs/analog/compare/v1.16.0-beta.8...v1.16.0-beta.9) (2025-04-24)
+
+### Bug Fixes
+
+- **storybook-angular:** only include explicit deps in package.json ([#1703](https://github.com/analogjs/analog/issues/1703)) ([63ef9fe](https://github.com/analogjs/analog/commit/63ef9fec6a9b66637192ec0cf4e30820e0258e43))
+
+# [1.16.0-beta.8](https://github.com/analogjs/analog/compare/v1.16.0-beta.7...v1.16.0-beta.8) (2025-04-23)
+
+### Bug Fixes
+
+- **nx-plugin:** add middleware include to app templates, update docs ([#1701](https://github.com/analogjs/analog/issues/1701)) ([1ff4ebb](https://github.com/analogjs/analog/commit/1ff4ebb1f0dee0857ee5f4f86a0c18962f731b57))
+
+# [1.16.0-beta.7](https://github.com/analogjs/analog/compare/v1.16.0-beta.6...v1.16.0-beta.7) (2025-04-23)
+
+### Features
+
+- introduce @analogjs/storybook-angular package ([#1699](https://github.com/analogjs/analog/issues/1699)) ([f0c5760](https://github.com/analogjs/analog/commit/f0c5760226fe6c80b63e6c521d2ecaacdb2f3b86))
+
+# [1.16.0-beta.6](https://github.com/analogjs/analog/compare/v1.16.0-beta.5...v1.16.0-beta.6) (2025-04-23)
+
+### Bug Fixes
+
+- **vite-plugin-nitro:** remove compressed index files for SSR-only rendering ([#1700](https://github.com/analogjs/analog/issues/1700)) ([06419c1](https://github.com/analogjs/analog/commit/06419c108f7753a50990e85ee28995c50affc079))
+
+# [1.16.0-beta.5](https://github.com/analogjs/analog/compare/v1.16.0-beta.4...v1.16.0-beta.5) (2025-04-22)
+
+### Features
+
+- **nx-plugin:** update templates to use Tailwind version 4.x ([#1692](https://github.com/analogjs/analog/issues/1692)) ([2e561ed](https://github.com/analogjs/analog/commit/2e561ed41e2be22893115455a2f57f6082856a58))
+
+# [1.16.0-beta.4](https://github.com/analogjs/analog/compare/v1.16.0-beta.3...v1.16.0-beta.4) (2025-04-22)
+
+### Bug Fixes
+
+- **platform:** align logic for determining client only rendering ([#1695](https://github.com/analogjs/analog/issues/1695)) ([1f7f560](https://github.com/analogjs/analog/commit/1f7f5601f43e4a9dd99c4783a20eaeb2b55b83a3))
+
+# [1.16.0-beta.3](https://github.com/analogjs/analog/compare/v1.16.0-beta.2...v1.16.0-beta.3) (2025-04-21)
+
+### Bug Fixes
+
+- **vite-plugin-angular:** check for compiler when using JiT and HMR ([#1693](https://github.com/analogjs/analog/issues/1693)) ([0173944](https://github.com/analogjs/analog/commit/01739448589da6100a3b9cfd4274174db3f1050e))
+
+# [1.16.0-beta.2](https://github.com/analogjs/analog/compare/v1.16.0-beta.1...v1.16.0-beta.2) (2025-04-16)
+
+### Bug Fixes
+
+- **vite-plugin-nitro:** fix behavior when opting out of prerendering ([#1688](https://github.com/analogjs/analog/issues/1688)) ([aa7f02a](https://github.com/analogjs/analog/commit/aa7f02abc457d2d8d7a2af97b4fb1847ebb0ae19))
+
+# [1.16.0-beta.1](https://github.com/analogjs/analog/compare/v1.15.1...v1.16.0-beta.1) (2025-04-10)
+
+### Features
+
+- **vite-plugin-nitro:** make source root configurable/optional ([#1681](https://github.com/analogjs/analog/issues/1681)) ([6477173](https://github.com/analogjs/analog/commit/6477173e7b4ab3759421b96bbd4c6df1aea25b05))
+
 ## [1.15.1](https://github.com/analogjs/analog/compare/v1.15.0...v1.15.1) (2025-04-09)
 
 ### Bug Fixes

README.md

@@ -2,7 +2,7 @@
 
 <!-- prettier-ignore-start -->
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-136-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-138-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 <!-- prettier-ignore-end -->
 
@@ -287,6 +287,8 @@ Thanks goes to these wonderful people for contributing to Analog ([emoji key](ht
       <td align="center" valign="top" width="14.28%"><a href="https://3cloudsolutions.com"><img src="https://avatars.githubusercontent.com/u/1328532?v=4?s=100" width="100px;" alt="Roydon Gyles-Bedford"/><br /><sub><b>Roydon Gyles-Bedford</b></sub></a><br /><a href="https://github.com/analogjs/analog/commits?author=rgylesbedford" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://jordanpowell88.com"><img src="https://avatars.githubusercontent.com/u/3605268?v=4?s=100" width="100px;" alt="Jordan"/><br /><sub><b>Jordan</b></sub></a><br /><a href="#infra-jordanpowell88" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://shannonmoeller.com"><img src="https://avatars.githubusercontent.com/u/155164?v=4?s=100" width="100px;" alt="Shannon Moeller 🧢"/><br /><sub><b>Shannon Moeller 🧢</b></sub></a><br /><a href="https://github.com/analogjs/analog/commits?author=shannonmoeller" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/vsternbach"><img src="https://avatars.githubusercontent.com/u/3830668?v=4?s=100" width="100px;" alt="Vlad Sternbach"/><br /><sub><b>Vlad Sternbach</b></sub></a><br /><a href="https://github.com/analogjs/analog/commits?author=vsternbach" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/meeroslav"><img src="https://avatars.githubusercontent.com/u/881612?v=4?s=100" width="100px;" alt="Miroslav Jonaš"/><br /><sub><b>Miroslav Jonaš</b></sub></a><br /><a href="#infra-meeroslav" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
     </tr>
   </tbody>
 </table>

apps/docs-app/docs/contributors.mdx

@@ -234,6 +234,8 @@ Andres is a software engineer for HeroDevs, Angular and Firebase GDE.
       <td align="center" valign="top" width="14.28%"><a href="https://3cloudsolutions.com"><img src="https://avatars.githubusercontent.com/u/1328532?v=4?s=100" width="100px;" alt="Roydon Gyles-Bedford"/><br /><sub><b>Roydon Gyles-Bedford</b></sub></a><br /><a href="https://github.com/analogjs/analog/commits?author=rgylesbedford" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://jordanpowell88.com"><img src="https://avatars.githubusercontent.com/u/3605268?v=4?s=100" width="100px;" alt="Jordan"/><br /><sub><b>Jordan</b></sub></a><br /><a href="#infra-jordanpowell88" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://shannonmoeller.com"><img src="https://avatars.githubusercontent.com/u/155164?v=4?s=100" width="100px;" alt="Shannon Moeller 🧢"/><br /><sub><b>Shannon Moeller 🧢</b></sub></a><br /><a href="https://github.com/analogjs/analog/commits?author=shannonmoeller" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/vsternbach"><img src="https://avatars.githubusercontent.com/u/3830668?v=4?s=100" width="100px;" alt="Vlad Sternbach"/><br /><sub><b>Vlad Sternbach</b></sub></a><br /><a href="https://github.com/analogjs/analog/commits?author=vsternbach" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/meeroslav"><img src="https://avatars.githubusercontent.com/u/881612?v=4?s=100" width="100px;" alt="Miroslav Jonaš"/><br /><sub><b>Miroslav Jonaš</b></sub></a><br /><a href="#infra-meeroslav" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
     </tr>
   </tbody>
 </table>

apps/docs-app/docs/features/routing/middleware.md

@@ -13,6 +13,19 @@ src/
         └── auth.ts
 ```
 
+Also, if not present, add the middleware files to `include` array in the `tsconfig.app.json`.
+
+```json
+{
+  // other config ...
+  "include": [
+    "src/**/*.d.ts",
+    "src/app/pages/**/*.page.ts",
+    "src/server/middleware/**/*.ts" <----
+  ],
+}
+```
+
 Middleware is defined using the `defineEventHandler` function.
 
 ```ts
@@ -50,3 +63,25 @@ export default defineEventHandler(async (event) => {
   }
 });
 ```
+
+## Accessing Environment Variables
+
+Use the `process.env` global to access environment variables inside the middleware functions. Both server-only and publicly accessible environment variables defined in `.env` files can be read from the middleware.
+
+```ts
+import { defineEventHandler, getRequestURL } from 'h3';
+
+export default defineEventHandler((event) => {
+  console.log('Path:', getRequestURL(event).pathname);
+  console.log(
+    'Server Only Environment Variable:',
+    process.env['SERVER_ONLY_VARIABLE'],
+  );
+  console.log(
+    'Public Environment Variable:',
+    process.env['VITE_EXAMPLE_VARIABLE'],
+  );
+});
+```
+
+Learn more about [environment variables](https://vite.dev/guide/env-and-mode.html#env-variables) in the Vite documentation.

apps/docs-app/docs/features/server/server-side-rendering.md

@@ -29,7 +29,7 @@ For more information about externals with SSR, check out the [Vite documentation
 
 ## Hybrid Rendering with Client-Only Routes
 
-SSR is enabled by default. For a hybrid approach, you can specific some routes to only be rendered client-side, and not be server side rendered. This is done through the `routeRules` configuration object by specifying an `ssr` option.
+SSR is enabled by default. For a hybrid approach, you can specify some routes to only be rendered client-side, and not be server side rendered. This is done through the `routeRules` configuration object by specifying an `ssr` option.
 
 ```ts
 import { defineConfig } from 'vite';
@@ -94,24 +94,18 @@ export default defineConfig(({ mode }) => ({
 }));
 ```
 
-You can opt out of prerendering by passing an empty array of routes and disabling prerender on the root route.
+You can opt-out of prerendering altogether by passing an empty array of routes.
 
 ```js
 import { defineConfig } from 'vite';
 import analog from '@analogjs/platform';
+
 // https://vitejs.dev/config/
 export default defineConfig(({ mode }) => ({
   // ...other config
   plugins: [
     analog({
       ssr: true,
-      nitro: {
-        routeRules: {
-          '/': {
-            prerender: false,
-          },
-        },
-      },
       prerender: {
         routes: async () => {
           return [];

apps/docs-app/docs/guides/compatibility.md

@@ -1,10 +1,27 @@
 # Version Compatibility
 
-Analog is compatible across multiple versions of Angular, Nx, and Vite.
+Analog is compatible across multiple versions of Angular and Vite.
 
 Its always recommended to use the latest version of Analog because there are bug fixes and features continually being added.
 
-Below is a reference table that matches versions of Nx and Angular with the Analog version that is compatible with it.
+Below is a reference table that matches compatible versions of Angular with the Analog and Vite.
+
+# Angular Version Support
+
+| Angular Version | Analog Version | Vite Version |
+| --------------- | -------------- | ------------ |
+| ^19.1.0         | **latest**     | ^6.0.0       |
+| ^18.0.0         | **latest**     | ^5.0.0       |
+| ^17.0.0         | **latest**     | ^5.0.0       |
+| ^17.0.0         | **latest**     | ^5.0.0       |
+| ^16.1.0         | **latest**     | ^5.0.0       |
+| ~15.2.X         | **latest**     | ^5.0.0       |
+
+You can also [migrate and existing Angular Single Page Application](/docs/guides/migrating) to Analog.
+
+# Nx Version Support
+
+Using Nx is not a requirement to use Analog. Analog uses the Nx Devkit for supporting Nx workspaces and Angular CLI workspaces
 
 The table shows the minimum version of Nx, the supported Angular version, and the minimum supported version of Analog and Vite.