@the-bearded-bear/claude-craft 8.18.2 → 8.19.0-next.2d709ba

package/Dev/i18n/base/Angular/rules/00-project-context.md.template

@@ -13,7 +13,7 @@
 - **Language**: TypeScript 5.x
 - **Styling**: {{STYLING}} (SCSS/Tailwind/Angular Material)
 - **State Management**: {{STATE_MANAGEMENT}} (Signals/NgRx/NGXS)
-- **Testing**: {{TESTING}} (Vitest/Jest + Cypress)
+- **Testing**: {{TESTING}} (Vitest/Jest + Playwright)
 - **Build Tool**: Angular CLI / Vite
 
 ## Architecture

package/Dev/i18n/base/Angular/rules/06-tooling.md

@@ -227,19 +227,16 @@ export default defineConfig({
 
 **src/test-setup.ts**
 ```typescript
-import '@analogjs/vitest-angular/setup-zone';
-import { getTestBed } from '@angular/core/testing';
-import {
-  BrowserDynamicTestingModule,
-  platformBrowserDynamicTesting
-} from '@angular/platform-browser-dynamic/testing';
-
-getTestBed().initTestEnvironment(
-  BrowserDynamicTestingModule,
-  platformBrowserDynamicTesting()
-);
+// Angular 22 — zoneless (do NOT import setup-zone: it re-introduces Zone.js and masks
+// signal timing bugs in tests. setup-zone is ONLY for zone-based apps.)
+import { setupTestBed } from '@analogjs/vitest-angular/setup-testbed';
+setupTestBed({ zoneless: true });
 ```
 
+> **Important:** Never use `import '@analogjs/vitest-angular/setup-zone'` in an Angular 21+
+> zoneless project. It re-activates Zone.js in tests and makes change-detection behavior
+> inconsistent with the real app.
+
 ### Jest (Alternative)
 
 ```bash
@@ -263,25 +260,38 @@ module.exports = {
 };
 ```
 
-### Cypress for E2E
+### Playwright for E2E (claude-craft standard)
+
+> **claude-craft standard:** Playwright is the required E2E tool for all JS/TS projects.
+> Cypress remains compatible for legacy projects but should not be used for new Angular projects.
 
 ```bash
-npm install -D cypress @cypress/schematic
-ng add @cypress/schematic
+npm install -D @playwright/test
+npx playwright install chromium
 ```
 
-**cypress.config.ts**
+**playwright.config.ts**
 ```typescript
-import { defineConfig } from 'cypress';
+import { defineConfig, devices } from '@playwright/test';
 
 export default defineConfig({
-  e2e: {
-    baseUrl: 'http://localhost:4200',
-    supportFile: 'cypress/support/e2e.ts',
-    specPattern: 'cypress/e2e/**/*.cy.ts',
-    video: false,
-    screenshotOnRunFailure: true
-  }
+  testDir: './e2e',
+  fullyParallel: true,
+  forbidOnly: !!process.env['CI'],
+  retries: process.env['CI'] ? 2 : 0,
+  reporter: 'html',
+  webServer: {
+    command: 'ng serve',
+    url: 'http://localhost:4200',
+    reuseExistingServer: !process.env['CI'],
+  },
+  use: {
+    baseURL: 'http://localhost:4200',
+    trace: 'on-first-retry',
+  },
+  projects: [
+    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+  ],
 });
 ```
 
@@ -510,7 +520,7 @@ Essential Angular tooling:
 | ESLint + Angular ESLint | Code linting |
 | Prettier | Code formatting |
 | Vitest/Jest | Unit testing |
-| Cypress | E2E testing |
+| Playwright | E2E testing |
 | NgRx/Signals | State management |
 | Webpack Bundle Analyzer | Bundle analysis |
 | Angular DevTools | Debugging |

package/Dev/i18n/base/Angular/rules/07-testing-angular.md

@@ -6,7 +6,7 @@
 
 ```
         /\
-       /  \      E2E Tests (Cypress/Playwright)
+       /  \      E2E Tests (Playwright)
       /----\     10% - Critical user journeys
      /      \
     /--------\   Integration Tests
@@ -57,19 +57,16 @@ export default defineConfig({
 
 **src/test-setup.ts**
 ```typescript
-import '@analogjs/vitest-angular/setup-zone';
-import { getTestBed } from '@angular/core/testing';
-import {
-  BrowserDynamicTestingModule,
-  platformBrowserDynamicTesting
-} from '@angular/platform-browser-dynamic/testing';
-
-getTestBed().initTestEnvironment(
-  BrowserDynamicTestingModule,
-  platformBrowserDynamicTesting()
-);
+// Angular 22 — zoneless (do NOT import setup-zone: it re-introduces Zone.js and masks
+// signal timing bugs in tests. setup-zone is ONLY for zone-based apps.)
+import { setupTestBed } from '@analogjs/vitest-angular/setup-testbed';
+setupTestBed({ zoneless: true });
 ```
 
+> **Important:** Never use `import '@analogjs/vitest-angular/setup-zone'` in an Angular 21+
+> zoneless project. It re-activates Zone.js in tests and makes change-detection behavior
+> inconsistent with the real app.
+
 ## Component Testing
 
 ### Basic Component Test
@@ -611,63 +608,78 @@ describe('authInterceptor', () => {
 });
 ```
 
-## E2E Testing with Cypress
+## E2E Testing with Playwright
+
+> **claude-craft standard:** Playwright is the required E2E tool for all JS/TS projects
+> (see `.claude/rules/07-testing.md`). Cypress remains compatible for existing legacy projects
+> but should not be adopted for new Angular projects.
 
 ### Setup
 
+```bash
+npm install -D @playwright/test
+npx playwright install chromium
+```
+
+**playwright.config.ts**
 ```typescript
-// cypress/support/commands.ts
-declare global {
-  namespace Cypress {
-    interface Chainable {
-      login(email: string, password: string): Chainable<void>;
-    }
-  }
-}
-
-Cypress.Commands.add('login', (email: string, password: string) => {
-  cy.visit('/auth/login');
-  cy.get('[data-cy=email]').type(email);
-  cy.get('[data-cy=password]').type(password);
-  cy.get('[data-cy=submit]').click();
-  cy.url().should('include', '/dashboard');
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './e2e',
+  fullyParallel: true,
+  forbidOnly: !!process.env['CI'],
+  retries: process.env['CI'] ? 2 : 0,
+  reporter: 'html',
+  webServer: {
+    command: 'ng serve',
+    url: 'http://localhost:4200',
+    reuseExistingServer: !process.env['CI'],
+  },
+  use: {
+    baseURL: 'http://localhost:4200',
+    trace: 'on-first-retry',
+  },
+  projects: [
+    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+  ],
 });
 ```
 
 ### E2E Test Example
 
 ```typescript
-// cypress/e2e/users.cy.ts
-describe('Users Feature', () => {
-  beforeEach(() => {
-    cy.login('admin@test.com', 'password');
-  });
+// e2e/users.spec.ts
+import { test, expect } from '@playwright/test';
+
+test.describe('Users Feature', () => {
+  test.use({ storageState: 'e2e/.auth/user.json' });
 
-  it('should display users list', () => {
-    cy.visit('/users');
+  test('should display users list', async ({ page }) => {
+    await page.goto('/users');
 
-    cy.get('[data-cy=users-list]').should('be.visible');
-    cy.get('[data-cy=user-card]').should('have.length.greaterThan', 0);
+    await expect(page.getByTestId('users-list')).toBeVisible();
+    await expect(page.getByTestId('user-card')).toHaveCount(expect.any(Number));
   });
 
-  it('should create new user', () => {
-    cy.visit('/users');
-    cy.get('[data-cy=add-user]').click();
+  test('should create new user', async ({ page }) => {
+    await page.goto('/users');
+    await page.getByTestId('add-user').click();
 
-    cy.get('[data-cy=user-name]').type('New User');
-    cy.get('[data-cy=user-email]').type('new@test.com');
-    cy.get('[data-cy=save]').click();
+    await page.getByTestId('user-name').fill('New User');
+    await page.getByTestId('user-email').fill('new@test.com');
+    await page.getByTestId('save').click();
 
-    cy.get('[data-cy=toast]').should('contain', 'User created');
-    cy.get('[data-cy=users-list]').should('contain', 'New User');
+    await expect(page.getByTestId('toast')).toContainText('User created');
+    await expect(page.getByTestId('users-list')).toContainText('New User');
   });
 
-  it('should search users', () => {
-    cy.visit('/users');
+  test('should search users', async ({ page }) => {
+    await page.goto('/users');
 
-    cy.get('[data-cy=search]').type('John');
-    cy.get('[data-cy=user-card]').should('have.length', 1);
-    cy.get('[data-cy=user-card]').should('contain', 'John');
+    await page.getByTestId('search').fill('John');
+    await expect(page.getByTestId('user-card')).toHaveCount(1);
+    await expect(page.getByTestId('user-card').first()).toContainText('John');
   });
 });
 ```
@@ -730,7 +742,7 @@ beforeEach(() => {
 |-----------|------|----------|
 | Unit | Vitest/Jest | 70% |
 | Integration | TestBed | 20% |
-| E2E | Cypress | 10% |
+| E2E | Playwright | 10% |
 
 Testing priorities:
 1. Critical business logic

package/Dev/i18n/base/Angular/rules/08-quality-tools.md

@@ -399,12 +399,11 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Cypress run
-        uses: cypress-io/github-action@v6
-        with:
-          build: npm run build
-          start: npm run serve:ci
-          wait-on: 'http://localhost:4200'
+      - name: Playwright install
+        run: npx playwright install --with-deps chromium
+
+      - name: Playwright run
+        run: npm run e2e
 ```
 
 ## Security Scanning
@@ -461,8 +460,8 @@ sonar.javascript.lcov.reportPaths=coverage/lcov.info
     "test": "vitest",
     "test:ci": "vitest run --coverage",
     "test:watch": "vitest watch",
-    "e2e": "cypress run",
-    "e2e:open": "cypress open",
+    "e2e": "playwright test",
+    "e2e:ui": "playwright test --ui",
 
     "lint": "ng lint",
     "lint:fix": "ng lint --fix",

package/Dev/i18n/base/CSharp/rules/06-tooling.md

@@ -71,7 +71,11 @@ dotnet publish -c Release --self-contained -r linux-x64
   <PackageReference Include="xunit.runner.visualstudio" Version="2.*">
     <PrivateAssets>all</PrivateAssets>
   </PackageReference>
+  <!-- Moq 4.20.0 (Aug 2023) briefly embedded SponsorLink (scraped git emails); reverted in 4.20.2.
+       4.20.70 is clean and MIT. New projects may prefer NSubstitute (MIT, cleaner API). -->
   <PackageReference Include="Moq" Version="4.*" />
+  <!-- Alternative: NSubstitute (MIT, .NET community default 2026)
+  <PackageReference Include="NSubstitute" Version="5.*" /> -->
   <PackageReference Include="FluentAssertions" Version="6.*" />
   <PackageReference Include="Bogus" Version="35.*" />
   <PackageReference Include="Testcontainers" Version="3.*" />

package/Dev/i18n/base/CSharp/rules/07-testing-csharp.md

@@ -266,6 +266,36 @@ _loggerMock.Verify(
     Times.Once);
 ```
 
+### Alternative: NSubstitute
+
+> **Moq vs NSubstitute (2026):** Moq 4.20.0 (Aug 2023) briefly embedded SponsorLink (scraped git emails) — reverted in 4.20.2, 4.20.70 is clean and MIT. The .NET community has broadly adopted **NSubstitute** (MIT) for its cleaner API. Both frameworks are valid; NSubstitute is recommended for new projects.
+>
+> NuGet: `NSubstitute` Version 5.*
+
+```csharp
+// NSubstitute: equivalent of the Moq examples above
+var orderRepo = Substitute.For<IOrderRepository>();
+var emailService = Substitute.For<IEmailService>();
+
+var sut = new OrderService(orderRepo, emailService);
+
+// Setup
+var order = CreateTestOrder();
+orderRepo.GetByIdAsync(order.Id, Arg.Any<CancellationToken>()).Returns(order);
+
+// Act
+await sut.ProcessOrderAsync(order.Id);
+
+// Verify
+await emailService.Received(1).SendOrderConfirmationAsync(
+    Arg.Is<Order>(o => o.Id == order.Id),
+    Arg.Any<CancellationToken>());
+
+// Verify NOT called
+await orderRepo.DidNotReceive().DeleteAsync(
+    Arg.Any<Order>(), Arg.Any<CancellationToken>());
+```
+
 ## FluentAssertions
 
 ### Basic Assertions
@@ -392,31 +422,53 @@ public class CustomerFaker : Faker<Customer>
 
 ## Integration Testing
 
-### WebApplicationFactory
+> **Critical anti-pattern: do not use `UseInMemoryDatabase` for integration tests.** The EF Core in-memory provider enforces no FK constraints, unique constraints, transactions, or `RowVersion`. Tests pass in-memory and silently fail against real PostgreSQL/SQL Server in production. Use **Testcontainers** (see below) or SQLite with `UseRelationalNulls()` as a Docker-free fallback.
+
+### WebApplicationFactory (with Testcontainers)
 
 ```csharp
-// Custom WebApplicationFactory
-public class CustomWebApplicationFactory : WebApplicationFactory<Program>
+// NuGet: Testcontainers.PostgreSql 4.* (Version 4.x — always call WithImage explicitly)
+public class CustomWebApplicationFactory : WebApplicationFactory<Program>, IAsyncLifetime
 {
+    private PostgreSqlContainer _postgres = null!;
+
+    public async Task InitializeAsync()
+    {
+        _postgres = new PostgreSqlBuilder()
+            .WithImage("postgres:16-alpine")  // Required in 4.x — no default image
+            .WithDatabase("testdb")
+            .WithUsername("test")
+            .WithPassword("test")
+            .Build();
+        await _postgres.StartAsync();
+    }
+
+    public new async Task DisposeAsync() => await _postgres.DisposeAsync();
+
     protected override void ConfigureWebHost(IWebHostBuilder builder)
     {
         builder.ConfigureServices(services =>
         {
-            // Remove real database
+            // Replace real database with test container
             var descriptor = services.SingleOrDefault(
                 d => d.ServiceType == typeof(DbContextOptions<ApplicationDbContext>));
             if (descriptor != null)
                 services.Remove(descriptor);
 
-            // Add in-memory database
             services.AddDbContext<ApplicationDbContext>(options =>
-            {
-                options.UseInMemoryDatabase("TestDb");
-            });
+                options.UseNpgsql(_postgres.GetConnectionString()));
 
             // Replace external services with fakes
             services.AddScoped<IEmailService, FakeEmailService>();
         });
+
+        builder.Configure(app =>
+        {
+            // Apply migrations on the test database
+            using var scope = app.ApplicationServices.CreateScope();
+            var db = scope.ServiceProvider.GetRequiredService<ApplicationDbContext>();
+            db.Database.MigrateAsync().GetAwaiter().GetResult();
+        });
     }
 }
 

package/Dev/i18n/base/CSharp/rules/12-aspire-cloud-native.md

@@ -211,8 +211,9 @@ var builder = WebApplication.CreateBuilder(args);
 builder.AddServiceDefaults();
 
 // Add application services
-builder.Services.AddEndpointsApiExplorer();
-builder.Services.AddSwaggerGen();
+// .NET 10: native OpenAPI + Scalar UI (Swashbuckle removed from template since .NET 9)
+// Packages: Microsoft.AspNetCore.OpenApi + Scalar.AspNetCore (see Directory.Packages.props)
+builder.Services.AddOpenApi();
 
 // Add database (Aspire provides connection string automatically)
 builder.AddNpgsqlDbContext<ApplicationDbContext>("ordersdb");
@@ -227,8 +228,8 @@ app.MapDefaultEndpoints();
 
 if (app.Environment.IsDevelopment())
 {
-    app.UseSwagger();
-    app.UseSwaggerUI();
+    app.MapOpenApi();
+    app.MapScalarApiReference();
 }
 
 app.MapOrderEndpoints();

package/Dev/i18n/base/Common/skills/dynamic-workflows/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: dynamic-workflows
+description: Orchestrate dozens-to-hundreds of subagents from a script Claude writes (Claude Code Dynamic Workflows, trigger `ultracode`). Use when a task exceeds a single agent's context or needs more than ~4 concurrent workers — large audits, migrations, multi-source research, fan-out reviews. Distinct from Agent Teams (synchronous, ≤4 workers) and ralph-run (sequential single-context loop).
+context: fork
+---
+
+# Dynamic Workflows — orchestration multi-agents scriptée
+
+Dynamic Workflows (Claude Code 2.1.154+, mot-clé déclencheur **`ultracode`**) laissent Claude
+**écrire un script JavaScript** qui orchestre des sous-agents de façon déterministe (boucles,
+conditions, fan-out). Le script tourne en arrière-plan ; on suit l'exécution via `/workflows`.
+
+> ⚠️ Opt-in coûteux : un workflow peut lancer des dizaines à centaines de sous-agents. Ne l'utiliser
+> que sur demande explicite (mot « ultracode », « use a workflow », « fan out agents ») ou quand le
+> palier de complexité ci-dessous est franchi.
+
+## Quand l'utiliser — les 3 paliers d'orchestration
+
+| Palier | Outil | Concurrence | Quand |
+|--------|-------|-------------|-------|
+| 1 | **Sub-agent simple** (Task/Agent) | 1 | Une investigation isolée, garder le contexte principal propre |
+| 2 | **Agent Teams** (`/team:audit`, `/team:sprint`, `/team:security`) | 1 leader + ~3 workers | Travail parallèle borné, synchrone, qui tient en un round |
+| 3 | **Dynamic Workflows** (`ultracode`) | jusqu'à ~1000 sous-agents (cap concurrent ~16) | La tâche dépasse le contexte d'un agent OU exige >4 workers OU une boucle/pipeline déterministe |
+
+**Heuristique break-even :** dès que tu écrirais « lance N agents, puis pour chacun fais X, puis
+agrège » — c'est un workflow. Si N ≤ 4 et une seule passe suffit, reste sur Agent Teams.
+
+## Patterns composables (prompts minimaux)
+
+- **Fan-out & synthesize** — N lecteurs en parallèle sur des sous-systèmes disjoints → un agent
+  synthétise. (audit, cartographie de code)
+- **Adversarial verification** — chaque finding passé à ≥1 sceptique chargé de le **réfuter** ;
+  ne garder que les `CONFIRMED`. *Le pattern qualité le plus important pour la génération autonome.*
+- **Generate-and-filter** — générer large (idées, candidats), puis filtrer par un juge.
+- **Classify-and-act** — un classifieur route chaque item vers le traitement adapté.
+- **Pipeline** — chaque item traverse toutes les étapes sans barrière (latence = pire chaîne, pas
+  somme des étapes). C'est le défaut multi-étapes.
+- **Loop-until-done / loop-until-dry** — relancer des chercheurs jusqu'à K rounds sans nouveauté
+  (découverte de taille inconnue : bugs, edge cases).
+
+## Squelette type (review → verify)
+
+```js
+const results = await pipeline(
+  DIMENSIONS,
+  d => agent(d.prompt, { phase: 'Review', schema: FINDINGS }),
+  review => parallel(review.findings.map(f => () =>
+    agent(`Adversarially verify: ${f.title}. Default refuted=true if unsure.`,
+          { phase: 'Verify', schema: VERDICT }).then(v => ({ ...f, verdict: v }))))
+)
+const confirmed = results.flat().filter(Boolean).filter(f => f.verdict?.isReal)
+```
+
+`pipeline()` par défaut (pas de barrière) ; `parallel()` seulement quand l'étape N a besoin de TOUS
+les résultats de N-1 (dédup, early-exit, comparaison croisée). `schema` force une sortie structurée
+validée. Pour des éditions concurrentes de fichiers, `isolation: 'worktree'`.
+
+## Monitoring
+
+- **`/workflows`** : progression live (phases, agents, tokens).
+- Le script revient avec un résultat agrégé ; lire ce résultat, décider la suite (souvent plusieurs
+  workflows en séquence : comprendre → concevoir → implémenter → revoir).
+
+## À ne pas confondre
+
+- **ralph-run** (`/common:ralph-run`) : boucle séquentielle mono-contexte jusqu'à une DoD — pas de
+  parallélisme. Pour une tâche qui dépasse ce modèle, basculer sur un Dynamic Workflow.
+- **`/effort ultracode`** : palier d'effort CLI (débit code max sur Opus 4.8) — orthogonal au
+  déclencheur `ultracode` des workflows, même si souvent utilisés ensemble.
+
+> Référence : [Claude Code Workflows](https://code.claude.com/docs/en/workflows) · voir aussi
+> `@.claude/commands/common/sub-agents-patterns.md` (tableau comparatif des orchestrations).

package/Dev/i18n/base/PHP/commands/check-code-quality.md

@@ -96,7 +96,7 @@ return (new PhpCsFixer\Config())
     ->setRiskyAllowed(true)
     ->setRules([
         '@PSR12' => true,
-        '@PHP84Migration' => true,
+        '@PHP85Migration' => true,
         '@Symfony' => true,
         '@Symfony:risky' => true,
 

package/Dev/i18n/base/VueJS/rules/06-tooling.md

@@ -36,12 +36,13 @@ export default defineConfig({
   build: {
     target: 'esnext',
     sourcemap: true,
-    rollupOptions: {
+    // Vite 8 / Rolldown (default): object form of manualChunks removed — use codeSplitting.groups
+    rolldownOptions: {
       output: {
-        // ⚠️ Vite 8 (Rolldown): manualChunks is deprecated when Rolldown is active (default bundler in Vite 8).
-        // Remove or condition to `build.rolldown !== true`. Rolldown produces equivalent or better automatic chunking.
-        manualChunks: {
-          'vue-vendor': ['vue', 'vue-router', 'pinia'],
+        codeSplitting: {
+          groups: [
+            { name: 'vue-vendor', test: /node_modules\/(vue|pinia|vue-router)/ },
+          ],
         },
       },
     },
@@ -49,6 +50,9 @@ export default defineConfig({
 })
 ```
 
+> **Vite 8 / Rolldown (default):** The object form of `manualChunks` is **removed** (not supported). Use `build.rolldownOptions.output.codeSplitting.groups`.
+> **Vite 7 / Rolldown disabled (legacy):** use `build.rollupOptions.output.manualChunks` — `// Only if Rolldown is explicitly disabled`.
+
 ### Environment Variables
 
 ```bash
@@ -142,8 +146,8 @@ export default [
 ```json
 {
   "scripts": {
-    "lint": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx",
-    "lint:fix": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx --fix"
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
   }
 }
 ```
@@ -340,7 +344,7 @@ const router = createRouter({ history: createWebHistory() });
     "lint:fix": "eslint . --fix",
     "format": "prettier --write src/",
     "format:check": "prettier --check src/",
-    "prepare": "husky install"
+    "prepare": "husky"
   },
   "dependencies": {
     "vue": "^3.5.0",
@@ -368,7 +372,7 @@ const router = createRouter({ history: createWebHistory() });
 
 ```bash
 pnpm add -D husky lint-staged
-pnpm exec husky install
+pnpm exec husky init
 ```
 
 ### Configuration
@@ -389,18 +393,12 @@ pnpm exec husky install
 ```
 
 ```bash
-# .husky/pre-commit
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
+# .husky/pre-commit  (Husky v9 — no wrapper sourcing needed)
 pnpm lint-staged
 ```
 
 ```bash
-# .husky/pre-push
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
+# .husky/pre-push  (Husky v9 — no wrapper sourcing needed)
 pnpm type-check
 pnpm test:unit
 ```

package/Dev/i18n/base/VueJS/rules/08-quality-tools.md

@@ -330,16 +330,16 @@ export default defineConfig({
 ### Bundle Size Limits
 
 ```typescript
-// vite.config.ts
+// vite.config.ts — Vite 8 / Rolldown (default)
 export default defineConfig({
   build: {
-    rollupOptions: {
+    rolldownOptions: {
       output: {
-        // ⚠️ Vite 8 (Rolldown): manualChunks is deprecated when Rolldown is the active bundler.
-        // Remove or condition to build.rolldown !== true for Vite 8+ projects.
-        manualChunks: {
-          'vue-vendor': ['vue', 'vue-router', 'pinia'],
-          'ui-vendor': ['@headlessui/vue', '@heroicons/vue'],
+        codeSplitting: {
+          groups: [
+            { name: 'vue-vendor', test: /node_modules\/(vue|pinia|vue-router)/ },
+            { name: 'ui-vendor', test: /node_modules\/@headlessui|@heroicons/ },
+          ],
         },
       },
     },
@@ -348,6 +348,9 @@ export default defineConfig({
 })
 ```
 
+> **Vite 8 / Rolldown (default):** The object form of `manualChunks` is **removed** (not supported). Use `build.rolldownOptions.output.codeSplitting.groups`.
+> **Vite 7 / Rolldown disabled (legacy):** use `build.rollupOptions.output.manualChunks` — `// Only if Rolldown is explicitly disabled`.
+
 ## Dependency Audit
 
 ### npm audit
@@ -379,7 +382,7 @@ pnpm update -i
 
 ```typescript
 // src/utils/webVitals.ts
-import { onCLS, onFID, onFCP, onLCP, onTTFB } from 'web-vitals'
+import { onCLS, onINP, onFCP, onLCP, onTTFB } from 'web-vitals'
 
 type ReportHandler = (metric: {
   name: string
@@ -389,7 +392,7 @@ type ReportHandler = (metric: {
 
 export function reportWebVitals(onReport: ReportHandler) {
   onCLS(onReport)
-  onFID(onReport)
+  onINP(onReport)   // INP replaced FID as a Core Web Vital (March 2024)
   onFCP(onReport)
   onLCP(onReport)
   onTTFB(onReport)