@analogjs/platform 2.7.0-beta.3 → 2.7.0-beta.4

package/AGENTS.md

@@ -0,0 +1,74 @@
+# AnalogJS — conventions for AI coding assistants
+
+This file ships with `@analogjs/platform` and documents how to work in an [AnalogJS](https://analogjs.org) app (an Angular meta-framework, powered by Vite). A generated app's root `AGENTS.md` points here so the guidance stays in sync with the installed version.
+
+## Commands
+
+- `npm start` / `npm run dev` — start the dev server (Vite)
+- `npm run build` — production build
+- `npm test` — run unit tests (Vitest)
+- `npm run preview` — run the built server locally
+
+## Project structure
+
+- `src/app/pages/` — file-based routes (see Routing below)
+- `src/app/` — components and app config (`app.config.ts`, `app.config.server.ts`)
+- `src/server/routes/` — server and API routes (Nitro + h3)
+- `src/main.ts` / `src/main.server.ts` — client and server bootstrap
+- `vite.config.ts` — Vite + Analog plugin and Vitest config
+
+## Routing
+
+Routes are file-based. A file in `src/app/pages/` ending in `.page.ts` becomes a route, and it must `export default` a standalone Angular component.
+
+- `index.page.ts` → `/`
+- `about.page.ts` → `/about`
+- `products/index.page.ts` → `/products`
+- `products/[productId].page.ts` → `/products/:productId` (dynamic segment)
+- `(auth).page.ts` + `(auth)/*.page.ts` → pathless layout: `(auth).page.ts` renders a `<router-outlet />` and wraps its child routes (e.g. `(auth)/login.page.ts` → `/login`, `(auth)/signup.page.ts` → `/signup`) without adding a path segment
+- `[...not-found].page.ts` → catch-all / 404
+
+Read route params with `inject(ActivatedRoute)` from `@angular/router`.
+
+Define per-route metadata (title, meta tags, guards, resolvers) by exporting a `RouteMeta`:
+
+```ts
+import { RouteMeta } from '@analogjs/router';
+
+export const routeMeta: RouteMeta = {
+  title: 'Products',
+};
+```
+
+## Server & API routes
+
+Server routes live in `src/server/routes/` and use [h3](https://h3.dev). API routes are conventionally under `src/server/routes/api/`.
+
+```ts
+import { defineEventHandler } from 'h3';
+
+export default defineEventHandler(() => ({ message: 'Hello World' }));
+```
+
+Filenames encode the HTTP method and params: `hello.get.ts`, `users.post.ts`, `users/[id].get.ts`.
+
+## Data fetching
+
+- **Page load functions:** add a sibling `.server.ts` `load` function and read its result in the page with `injectLoad` from `@analogjs/router`.
+- **Server functions:** define functions in `.server.ts` files and call them from the client with `injectServerFn`.
+
+## Content routes
+
+Markdown content is supported via `@analogjs/content`: `injectContent` / `injectContentFiles` to load content, and `MarkdownComponent` (`analog-markdown`) to render it. Content files live in `src/content/`.
+
+## Conventions
+
+- Use modern Angular: standalone components, `inject()`, signals, and the built-in control flow (`@if`, `@for`, `@switch`).
+- Page components are **default-exported**.
+- Tests are colocated as `*.spec.ts` and run under Vitest (jsdom environment).
+- Prefer existing Angular and Analog APIs over hand-rolled equivalents.
+
+## More
+
+Full documentation: https://analogjs.org/docs
+LLM-friendly docs index: https://analogjs.org/llms.txt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@analogjs/platform",
-  "version": "2.7.0-beta.3",
+  "version": "2.7.0-beta.4",
   "description": "The fullstack meta-framework for Angular",
   "type": "module",
   "author": "Brandon Roberts <robertsbt@gmail.com>",
@@ -29,8 +29,8 @@
   },
   "dependencies": {
     "nitropack": "^2.13.1",
-    "@analogjs/vite-plugin-angular": "^2.7.0-beta.3",
-    "@analogjs/vite-plugin-nitro": "^2.7.0-beta.3",
+    "@analogjs/vite-plugin-angular": "^2.7.0-beta.4",
+    "@analogjs/vite-plugin-nitro": "^2.7.0-beta.4",
     "oxc-parser": "^0.121.0",
     "vitefu": "^1.1.2"
   },

package/src/lib/nx-plugin/src/generators/app/versions/nx_18_X/versions.d.ts

@@ -1,10 +1,10 @@
 export declare const V18_X_NX_DEVKIT = "^20.0.0";
 export declare const V18_X_NX_ANGULAR = "^20.0.0";
-export declare const V18_X_ANALOG_JS_CONTENT = "^2.7.0-beta.3";
-export declare const V18_X_ANALOG_JS_ROUTER = "^2.7.0-beta.3";
+export declare const V18_X_ANALOG_JS_CONTENT = "^2.7.0-beta.4";
+export declare const V18_X_ANALOG_JS_ROUTER = "^2.7.0-beta.4";
 export declare const V18_X_ANALOG_JS_TRPC = "~0.4.0";
-export declare const V18_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = "^2.7.0-beta.3";
-export declare const V18_X_ANALOG_JS_VITEST_ANGULAR = "^2.7.0-beta.3";
+export declare const V18_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = "^2.7.0-beta.4";
+export declare const V18_X_ANALOG_JS_VITEST_ANGULAR = "^2.7.0-beta.4";
 export declare const V18_X_TRPC_CLIENT = "^10.25.0";
 export declare const V18_X_TRPC_SERVER = "^10.25.0";
 export declare const V18_X_ISOMORPHIC_FETCH = "^3.0.0";
@@ -20,7 +20,7 @@ export declare const V18_X_TAILWINDCSS = "^4.1.4";
 export declare const V18_X_TAILWINDCSS_VITE = "^4.1.4";
 export declare const V18_X_POSTCSS = "^8.5.3";
 export declare const V18_X_AUTOPREFIXER = "^10.4.0";
-export declare const V18_X_ANALOG_JS_PLATFORM = "^2.7.0-beta.3";
+export declare const V18_X_ANALOG_JS_PLATFORM = "^2.7.0-beta.4";
 export declare const V18_X_ANGULAR_DEVKIT_BUILD_ANGULAR = "^19.0.0";
 export declare const V18_X_NX_VITE = "^21.0.0";
 export declare const V18_X_NX_LINTER = "^21.0.0";

package/src/lib/nx-plugin/src/generators/app/versions/nx_18_X/versions.js

@@ -5,11 +5,11 @@ exports.V18_X_ZOD = exports.V18_X_VITEST = exports.V18_X_VITE_TSCONFIG_PATHS = e
 // dependencies
 exports.V18_X_NX_DEVKIT = '^20.0.0';
 exports.V18_X_NX_ANGULAR = '^20.0.0';
-exports.V18_X_ANALOG_JS_CONTENT = '^2.7.0-beta.3';
-exports.V18_X_ANALOG_JS_ROUTER = '^2.7.0-beta.3';
+exports.V18_X_ANALOG_JS_CONTENT = '^2.7.0-beta.4';
+exports.V18_X_ANALOG_JS_ROUTER = '^2.7.0-beta.4';
 exports.V18_X_ANALOG_JS_TRPC = '~0.4.0';
-exports.V18_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = '^2.7.0-beta.3';
-exports.V18_X_ANALOG_JS_VITEST_ANGULAR = '^2.7.0-beta.3';
+exports.V18_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = '^2.7.0-beta.4';
+exports.V18_X_ANALOG_JS_VITEST_ANGULAR = '^2.7.0-beta.4';
 exports.V18_X_TRPC_CLIENT = '^10.25.0';
 exports.V18_X_TRPC_SERVER = '^10.25.0';
 exports.V18_X_ISOMORPHIC_FETCH = '^3.0.0';
@@ -26,7 +26,7 @@ exports.V18_X_TAILWINDCSS_VITE = '^4.1.4';
 exports.V18_X_POSTCSS = '^8.5.3';
 exports.V18_X_AUTOPREFIXER = '^10.4.0';
 // devDependencies
-exports.V18_X_ANALOG_JS_PLATFORM = '^2.7.0-beta.3';
+exports.V18_X_ANALOG_JS_PLATFORM = '^2.7.0-beta.4';
 exports.V18_X_ANGULAR_DEVKIT_BUILD_ANGULAR = '^19.0.0';
 exports.V18_X_NX_VITE = '^21.0.0';
 exports.V18_X_NX_LINTER = '^21.0.0';

package/src/lib/nx-plugin/src/generators/preset/files/AGENTS.md

@@ -0,0 +1,11 @@
+# AGENTS.md
+
+This is an [AnalogJS](https://analogjs.org) app — an Angular meta-framework powered by Vite.
+
+Framework conventions for AI assistants — file-based routing, server/API routes, data fetching, content routes, and modern Angular usage — ship with the framework and are installed alongside your dependencies. Read them here:
+
+- `node_modules/@analogjs/platform/AGENTS.md`
+
+Reading from `@analogjs/platform` keeps the guidance in sync with the installed version instead of drifting from a copy checked into the project.
+
+Full documentation: https://analogjs.org/docs · LLM-friendly index: https://analogjs.org/llms.txt

package/src/lib/nx-plugin/src/generators/preset/files/CLAUDE.md

@@ -0,0 +1 @@
+Strictly follow the rules in @AGENTS.md

package/src/lib/nx-plugin/src/generators/preset/generator.js

@@ -35,12 +35,17 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = default_1;
 const devkit_1 = require("@nx/devkit");
+const node_path_1 = require("node:path");
 async function default_1(tree, options) {
     (0, devkit_1.ensurePackage)('@nx/angular', devkit_1.NX_VERSION);
     (0, devkit_1.ensurePackage)('@nx/vite', devkit_1.NX_VERSION);
     (0, devkit_1.ensurePackage)('@nx/eslint', devkit_1.NX_VERSION);
     (0, devkit_1.ensurePackage)('@angular-devkit/core', 'latest');
     (0, devkit_1.ensurePackage)('rxjs', 'latest');
-    return await Promise.resolve().then(() => __importStar(require('../app/generator'))).then(({ appGenerator }) => appGenerator(tree, options));
+    const appTask = await Promise.resolve().then(() => __importStar(require('../app/generator'))).then(({ appGenerator }) => appGenerator(tree, options));
+    // Seed agent context at the workspace root so AI coding assistants pick up
+    // Analog conventions (see node_modules/@analogjs/platform/AGENTS.md).
+    (0, devkit_1.generateFiles)(tree, (0, node_path_1.join)(__dirname, 'files'), '.', options);
+    return appTask;
 }
 //# sourceMappingURL=generator.js.map

package/src/lib/nx-plugin/src/generators/preset/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../../../packages/nx-plugin/src/generators/preset/generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,4BAUC;AAbD,uCAA6D;AAG9C,KAAK,oBAAW,IAAU,EAAE,OAA8B;IACvE,IAAA,sBAAa,EAAC,aAAa,EAAE,mBAAU,CAAC,CAAC;IACzC,IAAA,sBAAa,EAAC,UAAU,EAAE,mBAAU,CAAC,CAAC;IACtC,IAAA,sBAAa,EAAC,YAAY,EAAE,mBAAU,CAAC,CAAC;IACxC,IAAA,sBAAa,EAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAA,sBAAa,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEhC,OAAO,MAAM,kDAAO,kBAAkB,IAAE,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAChE,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAC5B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../../../packages/nx-plugin/src/generators/preset/generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,4BAgBC;AApBD,uCAA4E;AAC5E,yCAAiC;AAGlB,KAAK,oBAAW,IAAU,EAAE,OAA8B;IACvE,IAAA,sBAAa,EAAC,aAAa,EAAE,mBAAU,CAAC,CAAC;IACzC,IAAA,sBAAa,EAAC,UAAU,EAAE,mBAAU,CAAC,CAAC;IACtC,IAAA,sBAAa,EAAC,YAAY,EAAE,mBAAU,CAAC,CAAC;IACxC,IAAA,sBAAa,EAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAA,sBAAa,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEhC,MAAM,OAAO,GAAG,MAAM,kDAAO,kBAAkB,IAAE,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CACzE,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAC5B,CAAC;IAEF,2EAA2E;IAC3E,sEAAsE;IACtE,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAA,gBAAI,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAE5D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/src/lib/nx-plugin/src/utils/versions/ng_19_X/versions.d.ts

@@ -1,13 +1,13 @@
-export declare const V19_X_ANALOG_JS_ROUTER = "^2.7.0-beta.3";
-export declare const V19_X_ANALOG_JS_CONTENT = "^2.7.0-beta.3";
+export declare const V19_X_ANALOG_JS_ROUTER = "^2.7.0-beta.4";
+export declare const V19_X_ANALOG_JS_CONTENT = "^2.7.0-beta.4";
 export declare const V19_X_MARKED = "^15.0.7";
 export declare const V19_X_MARKED_GFM_HEADING_ID = "^4.1.1";
 export declare const V19_X_MARKED_HIGHLIGHT = "^2.2.1";
 export declare const V19_X_MARKED_MANGLE = "^1.1.10";
 export declare const V19_X_PRISMJS = "^1.29.0";
-export declare const V19_X_ANALOG_JS_PLATFORM = "^2.7.0-beta.3";
-export declare const V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = "^2.7.0-beta.3";
-export declare const V19_X_ANALOG_JS_VITEST_ANGULAR = "^2.7.0-beta.3";
+export declare const V19_X_ANALOG_JS_PLATFORM = "^2.7.0-beta.4";
+export declare const V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = "^2.7.0-beta.4";
+export declare const V19_X_ANALOG_JS_VITEST_ANGULAR = "^2.7.0-beta.4";
 export declare const V19_X_NX_ANGULAR = "^22.0.0";
 export declare const V19_X_NX_VITE = "^22.0.0";
 export declare const V19_X_JSDOM = "^22.0.0";

package/src/lib/nx-plugin/src/utils/versions/ng_19_X/versions.js

@@ -2,17 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NX_X_LATEST_NX = exports.NX_X_LATEST_VITEST = exports.NX_X_LATEST_VITE = exports.V19_X_VITE = exports.V19_X_VITEST = exports.V19_X_VITE_TSCONFIG_PATHS = exports.V19_X_JSDOM = exports.V19_X_NX_VITE = exports.V19_X_NX_ANGULAR = exports.V19_X_ANALOG_JS_VITEST_ANGULAR = exports.V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = exports.V19_X_ANALOG_JS_PLATFORM = exports.V19_X_PRISMJS = exports.V19_X_MARKED_MANGLE = exports.V19_X_MARKED_HIGHLIGHT = exports.V19_X_MARKED_GFM_HEADING_ID = exports.V19_X_MARKED = exports.V19_X_ANALOG_JS_CONTENT = exports.V19_X_ANALOG_JS_ROUTER = void 0;
 // V19_X
-exports.V19_X_ANALOG_JS_ROUTER = '^2.7.0-beta.3';
-exports.V19_X_ANALOG_JS_CONTENT = '^2.7.0-beta.3';
+exports.V19_X_ANALOG_JS_ROUTER = '^2.7.0-beta.4';
+exports.V19_X_ANALOG_JS_CONTENT = '^2.7.0-beta.4';
 exports.V19_X_MARKED = '^15.0.7';
 exports.V19_X_MARKED_GFM_HEADING_ID = '^4.1.1';
 exports.V19_X_MARKED_HIGHLIGHT = '^2.2.1';
 exports.V19_X_MARKED_MANGLE = '^1.1.10';
 exports.V19_X_PRISMJS = '^1.29.0';
 // devDependencies
-exports.V19_X_ANALOG_JS_PLATFORM = '^2.7.0-beta.3';
-exports.V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = '^2.7.0-beta.3';
-exports.V19_X_ANALOG_JS_VITEST_ANGULAR = '^2.7.0-beta.3';
+exports.V19_X_ANALOG_JS_PLATFORM = '^2.7.0-beta.4';
+exports.V19_X_ANALOG_JS_VITE_PLUGIN_ANGULAR = '^2.7.0-beta.4';
+exports.V19_X_ANALOG_JS_VITEST_ANGULAR = '^2.7.0-beta.4';
 exports.V19_X_NX_ANGULAR = '^22.0.0';
 exports.V19_X_NX_VITE = '^22.0.0';
 exports.V19_X_JSDOM = '^22.0.0';