ember.nvp 0.5.0 → 0.7.0

package/.github/workflows/ci.yml

@@ -29,13 +29,28 @@ jobs:
       - run: pnpm lint
 
   node_tests:
-    name: "Node Tests"
+    name: "Node Tests (${{ matrix.slice.name }})"
     runs-on: ubuntu-latest
     timeout-minutes: 15
 
+    strategy:
+      fail-fast: false
+      matrix:
+        slice:
+          - name: app permutations 1/2
+            args: test/ember.nvp/permutations/app-1.test.ts
+          - name: app permutations 2/2
+            args: test/ember.nvp/permutations/app-2.test.ts
+          - name: library permutations 1/2
+            args: test/ember.nvp/permutations/library-1.test.ts
+          - name: library permutations 2/2
+            args: test/ember.nvp/permutations/library-2.test.ts
+          - name: everything else
+            args: --exclude 'test/ember.nvp/permutations/**'
+
     steps:
       - uses: wyvox/action@v1
       - run: |
           git config --global user.name "ci"
           git config --global user.email "non@none.none"
-          pnpm test:node
+          pnpm test:node ${{ matrix.slice.args }}

package/.release-plan.json

@@ -2,14 +2,22 @@
   "solution": {
     "ember.nvp": {
       "impact": "minor",
-      "oldVersion": "0.4.0",
-      "newVersion": "0.5.0",
+      "oldVersion": "0.6.0",
+      "newVersion": "0.7.0",
       "tagName": "latest",
       "constraints": [
         {
           "impact": "minor",
           "reason": "Appears in changelog section :rocket: Enhancement"
         },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :bug: Bug Fix"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :memo: Documentation"
+        },
         {
           "impact": "patch",
           "reason": "Appears in changelog section :house: Internal"
@@ -17,9 +25,81 @@
       ],
       "pkgJSONPath": "./package.json"
     },
+    "@nullvoxpopuli/ember-build-tooling-utils": {
+      "impact": "minor",
+      "oldVersion": "1.0.0",
+      "newVersion": "1.1.0",
+      "tagName": "latest",
+      "constraints": [
+        {
+          "impact": "minor",
+          "reason": "Appears in changelog section :rocket: Enhancement"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :bug: Bug Fix"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :memo: Documentation"
+        }
+      ],
+      "pkgJSONPath": "./packages/build-tooling-utils/package.json"
+    },
+    "@nullvoxpopuli/ember-rolldown": {
+      "impact": "minor",
+      "oldVersion": "1.0.0",
+      "newVersion": "1.1.0",
+      "tagName": "latest",
+      "constraints": [
+        {
+          "impact": "patch",
+          "reason": "Has dependency `workspace:*` on @nullvoxpopuli/ember-build-tooling-utils"
+        },
+        {
+          "impact": "minor",
+          "reason": "Appears in changelog section :rocket: Enhancement"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :bug: Bug Fix"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :memo: Documentation"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :house: Internal"
+        }
+      ],
+      "pkgJSONPath": "./packages/rolldown/package.json"
+    },
     "@nullvoxpopuli/ember-vite": {
-      "oldVersion": "1.0.3"
+      "impact": "minor",
+      "oldVersion": "1.0.3",
+      "newVersion": "1.1.0",
+      "tagName": "latest",
+      "constraints": [
+        {
+          "impact": "minor",
+          "reason": "Appears in changelog section :rocket: Enhancement"
+        },
+        {
+          "impact": "patch",
+          "reason": "Has dependency `workspace:*` on @nullvoxpopuli/ember-build-tooling-utils"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :bug: Bug Fix"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :house: Internal"
+        }
+      ],
+      "pkgJSONPath": "./packages/vite/package.json"
     }
   },
-  "description": "## Release (2026-06-29)\n\n* ember.nvp 0.5.0 (minor)\n\n#### :rocket: Enhancement\n* `ember.nvp`\n  * [#55](https://github.com/NullVoxPopuli/ember.nvp/pull/55) Upgrade @clack/prompts ([@tcjr](https://github.com/tcjr))\n\n#### :house: Internal\n* `ember.nvp`\n  * [#53](https://github.com/NullVoxPopuli/ember.nvp/pull/53) Add typescript to root ([@tcjr](https://github.com/tcjr))\n\n#### Committers: 1\n- Tom Carter ([@tcjr](https://github.com/tcjr))\n"
+  "description": "## Release (2026-07-17)\n\n* ember.nvp 0.7.0 (minor)\n* @nullvoxpopuli/ember-build-tooling-utils 1.1.0 (minor)\n* @nullvoxpopuli/ember-rolldown 1.1.0 (minor)\n* @nullvoxpopuli/ember-vite 1.1.0 (minor)\n\n#### :rocket: Enhancement\n* `ember.nvp`\n  * [#78](https://github.com/NullVoxPopuli/ember.nvp/pull/78) publint and are-the-types-wrong layers ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#77](https://github.com/NullVoxPopuli/ember.nvp/pull/77) TypeScript is the default for libraries ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#73](https://github.com/NullVoxPopuli/ember.nvp/pull/73) Implement the vitest layer for libraries ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#71](https://github.com/NullVoxPopuli/ember.nvp/pull/71) Add inspector-support layer (Ember Inspector wiring via ember-estree codemod) ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n* `@nullvoxpopuli/ember-vite`, `ember.nvp`\n  * [#72](https://github.com/NullVoxPopuli/ember.nvp/pull/72) qunit layer: support libraries (tests without any index.html) ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#61](https://github.com/NullVoxPopuli/ember.nvp/pull/61) Update maybeBabel ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n* `ember.nvp`, `@nullvoxpopuli/ember-build-tooling-utils`, `@nullvoxpopuli/ember-rolldown`, `@nullvoxpopuli/ember-vite`\n  * [#63](https://github.com/NullVoxPopuli/ember.nvp/pull/63) Library support via rolldown ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n  * [#66](https://github.com/NullVoxPopuli/ember.nvp/pull/66) Lean on node 24: RegExp.escape, import.meta.dirname, fs.rm ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#67](https://github.com/NullVoxPopuli/ember.nvp/pull/67) Export our own defineConfig, preloaded with ember library defaults ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#64](https://github.com/NullVoxPopuli/ember.nvp/pull/64) Make both library flavors build: isolated declarations, hbs targetFormat, real tests ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n* `@nullvoxpopuli/ember-build-tooling-utils`, `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#65](https://github.com/NullVoxPopuli/ember.nvp/pull/65) No generated babel.config.js; drop the plugin packages' dist build ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n* `@nullvoxpopuli/ember-vite`\n  * [#62](https://github.com/NullVoxPopuli/ember.nvp/pull/62) Cleanup maybeBabel ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### :bug: Bug Fix\n* `@nullvoxpopuli/ember-build-tooling-utils`, `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#83](https://github.com/NullVoxPopuli/ember.nvp/pull/83) Can't publish TS, build with rolldown ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n* `@nullvoxpopuli/ember-rolldown`\n  * [#82](https://github.com/NullVoxPopuli/ember.nvp/pull/82) Fix watching in the rolldown plugin ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n* `ember.nvp`\n  * [#79](https://github.com/NullVoxPopuli/ember.nvp/pull/79) The library base generates an empty src ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#74](https://github.com/NullVoxPopuli/ember.nvp/pull/74) Generated TS libraries type check: drop allowJs, load ember/glint types ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#70](https://github.com/NullVoxPopuli/ember.nvp/pull/70) Library template is private; generated libraries are publishable ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#58](https://github.com/NullVoxPopuli/ember.nvp/pull/58) Fix lint:types in generated qunit apps: import #app/app.ts with extension ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#59](https://github.com/NullVoxPopuli/ember.nvp/pull/59) Make freshly generated apps pass their own pnpm lint ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n* `@nullvoxpopuli/ember-vite`, `ember.nvp`\n  * [#75](https://github.com/NullVoxPopuli/ember.nvp/pull/75) packages/vite: built-in babel fallback when no config file exists ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n\n#### :memo: Documentation\n* `@nullvoxpopuli/ember-build-tooling-utils`, `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#68](https://github.com/NullVoxPopuli/ember.nvp/pull/68) Docs pass: outcome-focused, timeless READMEs and comments ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n\n#### :house: Internal\n* `ember.nvp`\n  * [#81](https://github.com/NullVoxPopuli/ember.nvp/pull/81) Split the app permutations CI slice in two ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#80](https://github.com/NullVoxPopuli/ember.nvp/pull/80) Split the app and library permutations CI slices in two ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#76](https://github.com/NullVoxPopuli/ember.nvp/pull/76) Shard CI: per-base permutation files, parallel Node Tests jobs ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n* `@nullvoxpopuli/ember-rolldown`, `@nullvoxpopuli/ember-vite`, `ember.nvp`\n  * [#69](https://github.com/NullVoxPopuli/ember.nvp/pull/69) Remove comments from config files (generated and in READMEs) ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n\n#### Committers: 2\n- @NullVoxPopuli's reduced-access machine account for AI usage ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n- [@NullVoxPopuli](https://github.com/NullVoxPopuli)\n"
 }

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog
 
+## Release (2026-07-17)
+
+* ember.nvp 0.7.0 (minor)
+* @nullvoxpopuli/ember-build-tooling-utils 1.1.0 (minor)
+* @nullvoxpopuli/ember-rolldown 1.1.0 (minor)
+* @nullvoxpopuli/ember-vite 1.1.0 (minor)
+
+#### :rocket: Enhancement
+* `ember.nvp`
+  * [#78](https://github.com/NullVoxPopuli/ember.nvp/pull/78) publint and are-the-types-wrong layers ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#77](https://github.com/NullVoxPopuli/ember.nvp/pull/77) TypeScript is the default for libraries ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#73](https://github.com/NullVoxPopuli/ember.nvp/pull/73) Implement the vitest layer for libraries ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#71](https://github.com/NullVoxPopuli/ember.nvp/pull/71) Add inspector-support layer (Ember Inspector wiring via ember-estree codemod) ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+* `@nullvoxpopuli/ember-vite`, `ember.nvp`
+  * [#72](https://github.com/NullVoxPopuli/ember.nvp/pull/72) qunit layer: support libraries (tests without any index.html) ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#61](https://github.com/NullVoxPopuli/ember.nvp/pull/61) Update maybeBabel ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+* `ember.nvp`, `@nullvoxpopuli/ember-build-tooling-utils`, `@nullvoxpopuli/ember-rolldown`, `@nullvoxpopuli/ember-vite`
+  * [#63](https://github.com/NullVoxPopuli/ember.nvp/pull/63) Library support via rolldown ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+  * [#66](https://github.com/NullVoxPopuli/ember.nvp/pull/66) Lean on node 24: RegExp.escape, import.meta.dirname, fs.rm ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`
+  * [#67](https://github.com/NullVoxPopuli/ember.nvp/pull/67) Export our own defineConfig, preloaded with ember library defaults ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#64](https://github.com/NullVoxPopuli/ember.nvp/pull/64) Make both library flavors build: isolated declarations, hbs targetFormat, real tests ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+* `@nullvoxpopuli/ember-build-tooling-utils`, `@nullvoxpopuli/ember-rolldown`, `ember.nvp`
+  * [#65](https://github.com/NullVoxPopuli/ember.nvp/pull/65) No generated babel.config.js; drop the plugin packages' dist build ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+* `@nullvoxpopuli/ember-vite`
+  * [#62](https://github.com/NullVoxPopuli/ember.nvp/pull/62) Cleanup maybeBabel ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### :bug: Bug Fix
+* `@nullvoxpopuli/ember-build-tooling-utils`, `@nullvoxpopuli/ember-rolldown`, `ember.nvp`
+  * [#83](https://github.com/NullVoxPopuli/ember.nvp/pull/83) Can't publish TS, build with rolldown ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+* `@nullvoxpopuli/ember-rolldown`
+  * [#82](https://github.com/NullVoxPopuli/ember.nvp/pull/82) Fix watching in the rolldown plugin ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+* `ember.nvp`
+  * [#79](https://github.com/NullVoxPopuli/ember.nvp/pull/79) The library base generates an empty src ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#74](https://github.com/NullVoxPopuli/ember.nvp/pull/74) Generated TS libraries type check: drop allowJs, load ember/glint types ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#70](https://github.com/NullVoxPopuli/ember.nvp/pull/70) Library template is private; generated libraries are publishable ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#58](https://github.com/NullVoxPopuli/ember.nvp/pull/58) Fix lint:types in generated qunit apps: import #app/app.ts with extension ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#59](https://github.com/NullVoxPopuli/ember.nvp/pull/59) Make freshly generated apps pass their own pnpm lint ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+* `@nullvoxpopuli/ember-vite`, `ember.nvp`
+  * [#75](https://github.com/NullVoxPopuli/ember.nvp/pull/75) packages/vite: built-in babel fallback when no config file exists ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+
+#### :memo: Documentation
+* `@nullvoxpopuli/ember-build-tooling-utils`, `@nullvoxpopuli/ember-rolldown`, `ember.nvp`
+  * [#68](https://github.com/NullVoxPopuli/ember.nvp/pull/68) Docs pass: outcome-focused, timeless READMEs and comments ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+
+#### :house: Internal
+* `ember.nvp`
+  * [#81](https://github.com/NullVoxPopuli/ember.nvp/pull/81) Split the app permutations CI slice in two ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#80](https://github.com/NullVoxPopuli/ember.nvp/pull/80) Split the app and library permutations CI slices in two ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+  * [#76](https://github.com/NullVoxPopuli/ember.nvp/pull/76) Shard CI: per-base permutation files, parallel Node Tests jobs ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+* `@nullvoxpopuli/ember-rolldown`, `@nullvoxpopuli/ember-vite`, `ember.nvp`
+  * [#69](https://github.com/NullVoxPopuli/ember.nvp/pull/69) Remove comments from config files (generated and in READMEs) ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+
+#### Committers: 2
+- @NullVoxPopuli's reduced-access machine account for AI usage ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+- [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+
+## Release (2026-07-04)
+
+* ember.nvp 0.6.0 (minor)
+
+#### :rocket: Enhancement
+* `ember.nvp`
+  * [#56](https://github.com/NullVoxPopuli/ember.nvp/pull/56) Stage all generation in a copy-on-write overlay; confirm before writing ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+
+#### Committers: 1
+- @NullVoxPopuli's reduced-access machine account for AI usage ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+
 ## Release (2026-06-29)
 
 * ember.nvp 0.5.0 (minor)

package/README.md

@@ -30,6 +30,18 @@ pnpm dlx NullVoxPopuli/ember.nvp
 npx NullVoxPopuli/ember.nvp
 ```
 
+### Updating an existing project
+
+You can run `ember.nvp` on top of an existing project to add layers to it. Generation never writes directly to your project -- everything runs in a staging directory first, and before finishing you choose to:
+
+- **write the files** -- apply all of the staged changes
+- **review the diff** -- step through each changed file's diff, accepting or rejecting it individually (or accept/reject everything remaining)
+- **cancel** -- discard everything; your project is untouched
+
+Only files that actually changed are written. `node_modules`, `.git`, and everything else in your project are left alone, and the accepted changes land as uncommitted edits for you to review with your own git tooling.
+
+New projects skip the confirmation and are written as soon as generation succeeds. For scripting, `--write yes` / `--write no` answers the confirmation up front.
+
 ### Wrapping
 
 The provided CLI is only a wrapper around our exported `generateProject` function.
@@ -55,6 +67,23 @@ await generateProject(new Project(
 
 All parts of the generator are idempotent, so running generators on existing projects _can_ no-op.
 
+To get the same don't-write-until-confirmed behavior as the CLI, wrap generation in a `Stage`. A stage is a real directory in the OS temp dir, seeded with a copy of the target directory's current contents (sans `node_modules`/`.git`) -- so layers run against the project's existing state with plain `node:fs`, `ember-apply`, and subprocesses, and authoring a layer is exactly the same with or without one.
+
+```js
+import { generateProject, Project, Stage } from "ember.nvp";
+
+const stage = await Stage.create(directoryToGenerateIn);
+
+await generateProject(new Project(stage.directory, { name, path, type, layers, packageManager }));
+
+const changes = await stage.changes(); // [{ path, status: 'added' | 'modified' | 'deleted' }]
+console.log(await stage.diff(changes)); // unified diff against the target directory
+
+await stage.commit(); // write the changes to the target directory
+// or: await stage.commit(someOfTheChanges)  -- write only an accepted subset
+// or: await stage.discard()                 -- throw everything away, touching nothing
+```
+
 ## Reqs
 
 - node 24+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ember.nvp",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "ember project generator, alternative to the official blueprints, but more modern -- hopefully one day to upstream back in to ember-cli / official blueprints",
   "repository": {
     "type": "git",
@@ -22,7 +22,10 @@
     "@clack/prompts": "^1.6.0",
     "babel-remove-types": "^2.0.0",
     "content-tag": "^4.2.0",
+    "diff": "^9.0.0",
     "ember-apply": "^2.17.0",
+    "ember-estree": "^0.7.0",
+    "enhanced-resolve": "^5.24.2",
     "execa": "^9.6.1",
     "latest-version": "^9.0.0",
     "package-name-regex": "^5.0.0"
@@ -38,7 +41,6 @@
     "prettier": "^3.8.3",
     "prettier-plugin-ember-template-tag": "^2.1.6",
     "release-plan": "^0.18.0",
-    "rimraf": "^6.1.3",
     "typescript": "^5.9.3",
     "vite": "^8.0.14",
     "vitest": "^4.1.7"

package/packages/build-tooling-utils/README.md

@@ -0,0 +1,37 @@
+# `@nullvoxpopuli/ember-build-tooling-utils`
+
+Shared build tooling for the `@nullvoxpopuli` ember meta-plugins
+([`@nullvoxpopuli/ember-vite`](../vite) and
+[`@nullvoxpopuli/ember-rolldown`](../rolldown)).
+
+It's intentionally bundler-agnostic (no `vite`/`rolldown` dependency) so both
+meta-plugins can consume the same logic.
+
+Requires node 24+, and — since this package ships TypeScript source — a
+modern TypeScript when type-checking: 6+ with `lib` covering `es2025` (e.g.
+`esnext`).
+
+## Exports
+
+### `maybeBabel(options?)`
+
+A babel plugin (`@rollup/plugin-babel`) wrapped in a
+[`@rolldown/pluginutils`](https://github.com/rolldown/rolldown) filter so babel
+runs **only** on files that actually need it:
+
+- template-tag files (`.gts`/`.gjs`)
+- files importing template/macro modules (`@ember/template-compiler`,
+  `@embroider/macros`, …)
+- local (non-`node_modules`) code using decorators
+
+Everything else skips babel and is handled by the bundler's native (oxc)
+transform. The point: don't buy rolldown/oxc speed and then give it all back by
+routing every module through babel.
+
+`options` extends `@rollup/plugin-babel`'s options, plus a `filter.include`
+(`imports` / `code`) to opt additional files in.
+
+### `extensions`
+
+The list of file extensions ember source can be authored in. Mirrors
+embroider's canonical list (see `extensions.ts` for details).

package/packages/build-tooling-utils/index.ts

@@ -0,0 +1,2 @@
+export { maybeBabel } from "./src/maybe-babel.ts";
+export { extensions } from "./src/extensions.ts";

package/packages/build-tooling-utils/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@nullvoxpopuli/ember-build-tooling-utils",
+  "version": "1.1.0",
+  "description": "Shared build tooling for @nullvoxpopuli ember meta-plugins: maybeBabel (run babel only where needed) and the ember file extensions list.",
+  "type": "module",
+  "main": "index.ts",
+  "publishConfig": {
+    "main": "dist/index.js"
+  },
+  "keywords": [
+    "ember",
+    "babel",
+    "rolldown",
+    "vite",
+    "meta plugin",
+    "build"
+  ],
+  "author": "NullVoxPopuli",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NullVoxPopuli/ember.nvp",
+    "directory": "packages/build-tooling-utils"
+  },
+  "scripts": {
+    "build": "rolldown --config",
+    "prepack": "pnpm build"
+  },
+  "packageManager": "pnpm@10.28.0",
+  "dependencies": {
+    "@babel/core": "^7.28.10",
+    "@rolldown/pluginutils": "^1.0.1",
+    "@rollup/plugin-babel": "^7.1.0"
+  },
+  "engines": {
+    "node": ">= 24"
+  },
+  "devDependencies": {
+    "rolldown": "^1.1.2",
+    "typescript": "^6.0.3"
+  }
+}

package/packages/build-tooling-utils/rolldown.config.js

@@ -0,0 +1,18 @@
+import { defineConfig } from "rolldown";
+
+import manifest from "./package.json" with { type: "json" };
+
+const deps = Object.keys(manifest.dependencies || {});
+
+export default defineConfig({
+  input: "index.ts",
+  output: {
+    format: "esm",
+    file: "dist/index.js",
+    codeSplitting: false,
+  },
+  external(id) {
+    if (id.startsWith("node:")) return true;
+    if (deps.some((dep) => id.startsWith(dep))) return true;
+  },
+});

package/packages/build-tooling-utils/src/extensions.ts

@@ -0,0 +1,18 @@
+/**
+ * The file extensions ember source can be authored in.
+ *
+ * Mirrors embroider's canonical list, which is only exported from
+ * `@embroider/vite` (its `src/ember.ts`) — copied rather than depended on so
+ * this shared tooling stays bundler-agnostic. Keep in sync.
+ */
+export const extensions = [
+  ".mjs",
+  ".gjs",
+  ".js",
+  ".mts",
+  ".gts",
+  ".ts",
+  ".hbs",
+  ".hbs.js",
+  ".json",
+];

package/packages/build-tooling-utils/src/maybe-babel.ts

@@ -0,0 +1,146 @@
+/**
+ * Reasons we have to have babel
+ * - decorators
+ * - ember-concurrency
+ * - scoped-css
+ * - template compilation optimization
+ *
+ * `maybeBabel` runs babel ONLY on the files that actually need it (template-tag
+ * files, files importing template/macro modules, and local code using
+ * decorators). Everything else skips babel so the bundler's native (oxc)
+ * transform handles it -- the whole point being to keep the fast path fast and
+ * not re-slow the build by sending every file through babel.
+ *
+ * This is shared between the vite (app) and rolldown/tsdown (library)
+ * meta-plugins.
+ */
+import { and, code, id, include, not, or } from "@rolldown/pluginutils";
+import { babel } from "@rollup/plugin-babel";
+import type { RollupBabelInputPluginOptions } from "@rollup/plugin-babel";
+
+import { extensions } from "./extensions.ts";
+
+/**
+ * If a file imports any of these, it needs babel (templates, macros, and a
+ * couple of addons that ship decorator-adjacent runtime code).
+ */
+const babelRequiredImports = [
+  // Templates
+  // (old non template() form)
+  "@ember/template-compiler",
+  "@ember/template-compilation",
+
+  // Legacy templates (hbs / loose mode)
+  "ember-cli-htmlbars",
+  "ember-cli-htmlbars-inline-precompile",
+  "htmlbars-inline-precompile",
+
+  // Build Macros
+  // (since import.meta.env is not available in all environments)
+  "@embroider/macros",
+  "@glimmer/env",
+  "@ember/debug",
+  "@ember/application/deprecations",
+];
+
+const decoratorRegex = /(?<![\w'"`])(?<!\*\s+)(?<!\/\/[^\n]*)(?<!\/\*[^\n]*)@\w+/;
+//                     └────┬─────┘└───┬───┘└──────┬──────┘└──────┬──────┘└┬─┘
+//                          │          │           │              │        │
+//                          │          │           │              │        └── the `@decorator`
+//                          │          │           │              └──────── not inside a single-line block comment (`/* @dec */`)
+//                          │          │           └─────────────────────── not on a `//` line comment
+//                          │          └─────────────────────────────────── not a JSDoc tag, even with multiple spaces (`*    @param`)
+//                          └────────────────────────────────────────────── not mid-identifier or inside a string
+
+const nodeModulesPattern = /\/node_modules\//;
+
+const extensionRegExp = new RegExp(
+  `(${extensions
+    .filter((ext) => ext !== ".json")
+    .map(RegExp.escape)
+    .join("|")})(\\?.*)?(#.*)?$`,
+);
+
+type Options = Omit<RollupBabelInputPluginOptions, "filter"> & {
+  filter?: {
+    include: {
+      /**
+       * If any additional (custom) plugins are provided, a pattern
+       * should be provided that detects their usage
+       *
+       * for example, to also run babel on files that import from ember-concurrency
+       * ```js
+       * {
+       *   code: ['ember-concurrency'],
+       * }
+       * ```
+       */
+      imports: string[];
+      /**
+       * If any additional (custom) plugins are provided, a pattern
+       * should be provided that detects their usage
+       *
+       * for example, to also run babel on files that use polyfilled APIs,
+       * or use the "formatMessage" technique for translations
+       * ```js
+       * {
+       *   code: ['myPolyfilledAPICall(', /\bintl\.formatMessage\b/],
+       * }
+       * ```
+       */
+      code: (string | RegExp)[];
+    };
+  };
+};
+
+export function maybeBabel(userOptions: Options = {}) {
+  const { filter, ...options } = userOptions;
+
+  const plugin = babel({
+    babelHelpers: "runtime",
+    extensions,
+    skipPreflightCheck: true,
+    ...options,
+  });
+
+  const importsRegex = new RegExp(
+    babelRequiredImports
+      .concat(filter?.include?.imports ?? [])
+      .map(RegExp.escape)
+      .join("|"),
+  );
+
+  const maybeBabelFilter = [
+    include(
+      and(
+        // is one of the babel-supported extensions
+        id(extensionRegExp),
+        or(
+          // always run gts and gjs through babel
+          id(/\.gts$/),
+          id(/\.gjs$/),
+          // imports one of the modules above
+          code(importsRegex),
+          // (a common way to do translations)
+          // local app code using a decorator
+          // NOTE: maybeBabel requires that all libraries compile away their decorators
+          //
+          // TODO: what do we do when native decorators start shipping?
+          //     (ignore decorator transforming entirely?)
+          and(not(id(nodeModulesPattern)), code(decoratorRegex)),
+          // user provided additional opt-ins to the regex here
+          ...(filter?.include?.code?.map((x) => code(x)) ?? []),
+        ),
+      ),
+    ),
+  ];
+
+  // types are incorrect
+  (plugin.transform as { filter: unknown }).filter = maybeBabelFilter;
+
+  return {
+    ...plugin,
+    enforce: "pre",
+    name: "nullvoxpopuli:babel",
+  } as ReturnType<typeof babel>;
+}