@happyvertical/smrt-vitest 0.39.16 → 0.40.0

package/AGENTS.md

@@ -24,6 +24,30 @@ Without the plugin → "unregistered class" / "No field metadata found" errors.
 4. Registers all classes in ObjectRegistry
 5. Watch mode caveat: manifest only generated at startup — restart vitest after adding new classes/fields
 
+## Vite 8 (rolldown/oxc) normalization (#2017)
+
+The plugin's `config` hook normalizes three vite 8 behaviors so consumers
+don't carry per-repo workarounds (evidence: anytown.ai#707,
+willgriffin.dev#220):
+
+1. `esbuild.tsconfigRaw` is ignored on vite 8 → injects
+   `oxc.decorator = { legacy: true, emitDecoratorMetadata: true }` (+ the
+   `oxc.tsconfig.compilerOptions` mirror) so `@smrt()` legacy decorators
+   still transform.
+2. oxc elides type-position-only imports by default, silently dropping
+   side-effect model imports (SMRT object registration) in test files outside
+   the tsconfig `include` → injects
+   `oxc.typescript = { onlyRemoveTypeImports: true }`.
+3. Rolldown prefix-matches string alias `find`s, mangling unaliased subpath
+   imports (`@org/pkg/sub` → `src/index.ts/sub`) → workspace aliases are
+   anchored exact-match RegExps; unaliased subpaths fall through to the
+   exports map. `aliasFilter` drops entries entirely.
+
+Overrides: any `oxc` field the consumer sets is never injected
+(`resolveOxcDefaults`); `oxc: false` suppresses everything. Keys are inert on
+esbuild-based vite ≤ 7. Build-only vite configs that don't list the plugin
+still need their own `oxc.decorator` on vite 8.
+
 ## CI retry (flaky-test resilience)
 
 The plugin injects `test.retry` into every consuming package's config: **2 in CI

package/README.md

@@ -35,6 +35,49 @@ Without this plugin, tests fail with `"No field metadata found"` or `"unregister
 | `packages` | `string[]` | `[]` | Additional packages beyond auto-discovered |
 | `verbose` | `boolean` | `false` | Enable detailed logging |
 | `root` | `string` | `process.cwd()` | Root directory |
+| `setupFile` | `string` | package setup entry | Override the setup file injected into Vitest projects |
+| `aliasFilter` | `(entry) => boolean` | keep all | Drop auto-generated workspace alias entries (receives the raw string `find` and `replacement`) |
+
+### Vite 8 (rolldown/oxc) Normalization
+
+Vite 8 replaced esbuild with rolldown/oxc, which changed three behaviors that
+break SMRT projects. The plugin normalizes all three so consuming apps don't
+need per-repo workarounds (evidence: anytown.ai#707, willgriffin.dev#220):
+
+1. **`esbuild.tsconfigRaw` is ignored** — legacy `@smrt()` decorators reach
+   the bundle untransformed. The plugin injects
+   `oxc.decorator = { legacy: true, emitDecoratorMetadata: true }` (plus the
+   matching `oxc.tsconfig.compilerOptions` mirror).
+2. **oxc elides type-position side-effect imports by default** — test files
+   usually sit outside the tsconfig `include`, so a repo-wide
+   `verbatimModuleSyntax` never reaches them and side-effect model imports
+   (SMRT object registration) are silently dropped. The plugin injects
+   `oxc.typescript = { onlyRemoveTypeImports: true }`.
+3. **Rolldown prefix-matches string alias `find`s** — a bare workspace alias
+   like `@org/pkg` → `src/index.ts` mangles unaliased subpath imports
+   (`@org/pkg/sub` → `src/index.ts/sub`). Workspace aliases are emitted as
+   anchored exact-match RegExps, so unaliased subpaths fall through to the
+   package exports map; use `aliasFilter` to drop entries entirely.
+
+   > **Breaking change for direct `getWorkspaceViteAliases()` consumers:**
+   > each entry's `find` is now an anchored `RegExp`, not a `string` (the
+   > returned array is still ordered most-specific first, and the new second
+   > `options` parameter is optional). Code that used `find` as a string —
+   > e.g. a `Map` key or an equality filter — should match with
+   > `entry.find.test('<specifier>')` instead. Filters passed via
+   > `aliasFilter` (or the helper's `options.filter`) are unaffected: they
+   > receive the raw string `find` before anchoring. Plugin-only consumers
+   > need no changes.
+
+All defaults are override-able: any `oxc` field you set in your own config is
+never injected (explicit consumer values always win, and sibling fields still
+deep-merge), and `oxc: false` suppresses injection entirely. The `oxc` keys
+are inert on esbuild-based vite ≤ 7.
+
+Note: the plugin only reaches configs that include it (vitest configs and any
+vite config listing it in `plugins`). An app's separate build-only
+`vite.config.ts` without the plugin still needs its own `oxc.decorator`
+settings on vite 8.
 
 ### Watch Mode Note