ember.nvp 0.6.0 → 1.0.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

@@ -1,11 +1,15 @@
 {
   "solution": {
     "ember.nvp": {
-      "impact": "minor",
-      "oldVersion": "0.5.0",
-      "newVersion": "0.6.0",
+      "impact": "major",
+      "oldVersion": "0.7.0",
+      "newVersion": "1.0.0",
       "tagName": "latest",
       "constraints": [
+        {
+          "impact": "major",
+          "reason": "Appears in changelog section :boom: Breaking Change"
+        },
         {
           "impact": "minor",
           "reason": "Appears in changelog section :rocket: Enhancement"
@@ -13,9 +17,29 @@
       ],
       "pkgJSONPath": "./package.json"
     },
+    "@nullvoxpopuli/ember-build-tooling-utils": {
+      "oldVersion": "1.1.0"
+    },
+    "@nullvoxpopuli/ember-rolldown": {
+      "impact": "major",
+      "oldVersion": "1.1.0",
+      "newVersion": "2.0.0",
+      "tagName": "latest",
+      "constraints": [
+        {
+          "impact": "major",
+          "reason": "Appears in changelog section :boom: Breaking Change"
+        },
+        {
+          "impact": "minor",
+          "reason": "Appears in changelog section :rocket: Enhancement"
+        }
+      ],
+      "pkgJSONPath": "./packages/rolldown/package.json"
+    },
     "@nullvoxpopuli/ember-vite": {
-      "oldVersion": "1.0.3"
+      "oldVersion": "1.1.0"
     }
   },
-  "description": "## Release (2026-07-04)\n\n* ember.nvp 0.6.0 (minor)\n\n#### :rocket: Enhancement\n* `ember.nvp`\n  * [#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))\n\n#### Committers: 1\n- @NullVoxPopuli's reduced-access machine account for AI usage ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n"
+  "description": "## Release (2026-07-18)\n\n* ember.nvp 1.0.0 (major)\n* @nullvoxpopuli/ember-rolldown 2.0.0 (major)\n\n#### :boom: Breaking Change\n* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#86](https://github.com/NullVoxPopuli/ember.nvp/pull/86) Remove defineConfig ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### :rocket: Enhancement\n* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#84](https://github.com/NullVoxPopuli/ember.nvp/pull/84) Create config plugin for rolldown ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### Committers: 1\n- [@NullVoxPopuli](https://github.com/NullVoxPopuli)\n"
 }

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # Changelog
 
+## Release (2026-07-18)
+
+* ember.nvp 1.0.0 (major)
+* @nullvoxpopuli/ember-rolldown 2.0.0 (major)
+
+#### :boom: Breaking Change
+* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`
+  * [#86](https://github.com/NullVoxPopuli/ember.nvp/pull/86) Remove defineConfig ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### :rocket: Enhancement
+* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`
+  * [#84](https://github.com/NullVoxPopuli/ember.nvp/pull/84) Create config plugin for rolldown ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### Committers: 1
+- [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+
+## 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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ember.nvp",
-  "version": "0.6.0",
+  "version": "1.0.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",
@@ -24,6 +24,8 @@
     "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"
@@ -39,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>;
+}

package/packages/rolldown/README.md

@@ -0,0 +1,120 @@
+# `@nullvoxpopuli/ember-rolldown`
+
+A batteries-included meta-plugin for building Ember v2 libraries (addons) with
+[rolldown](https://rolldown.rs/) — or [tsdown](https://tsdown.dev/), which is
+built on top of rolldown and also emits `.d.ts` files.
+
+It compiles `.gts`/`.gjs` and template-tag (`<template>`) source into
+publishable output, so a single `ember()` call replaces the usual stack of
+`@embroider/*` externals handling, content-tag preprocessing, and babel wiring.
+
+## Install
+
+```bash
+npm add --save-dev @nullvoxpopuli/ember-rolldown
+```
+
+Requires node 24+, and — since these packages ship TypeScript source — a
+modern TypeScript when type-checking: 6+ with `lib` covering `es2025` (e.g.
+`esnext`).
+
+## Usage
+
+Import `defineConfig` from the bundler you're using — `tsdown` or `rolldown` —
+so it carries that tool's own config types; `@nullvoxpopuli/ember-rolldown`
+provides `ember()` (the defaults travel with the plugin, not `defineConfig`).
+
+In your `tsdown.config.js` (recommended — emits declarations):
+
+```js
+import { defineConfig } from "tsdown";
+import { ember } from "@nullvoxpopuli/ember-rolldown";
+
+export default defineConfig({
+  entry: ["./src/index.ts"],
+  plugins: [ember()],
+});
+```
+
+This builds your entry to `dist/*.js` and `dist/*.d.ts` with sourcemaps,
+cleaning `dist/` between builds and leaving the ember virtual packages to the
+consuming app. You choose the `entry` and `plugins`; any tsdown option you
+pass wins.
+
+Or in a plain `rolldown.config.js`:
+
+```js
+import { defineConfig } from "rolldown";
+import { ember } from "@nullvoxpopuli/ember-rolldown";
+
+export default defineConfig({
+  input: ["src/index.ts"],
+  plugins: [ember()],
+});
+```
+
+A `babel.config.js` is optional. Without one, `ember()` compiles templates
+(to `precompileTemplate`), decorators (via
+[decorator-transforms](https://github.com/ef4/decorator-transforms)), and
+TypeScript; with one, your config runs instead.
+
+### Declarations
+
+Declarations are emitted with isolated declarations — the only declaration
+pipeline that can see `<template>` (`.gts`/`.gjs`) modules, which exist only
+inside the bundler's module graph. Your `tsconfig.json` must enable it
+(`ember()` errors otherwise):
+
+```jsonc
+{
+  "compilerOptions": {
+    "isolatedDeclarations": true,
+  },
+}
+```
+
+Isolated declarations means every exported value carries an explicit type
+annotation. For template-only components:
+
+```gts
+import type { TOC } from "@ember/component/template-only";
+
+export const Badge: TOC<BadgeSignature> = <template>...</template>;
+```
+
+## What `ember()` does
+
+`ember()` returns an array of rolldown plugins:
+
+- **`emberIsolatedDeclarations()`** — errors when a `tsconfig.json` is present
+  without `isolatedDeclarations: true`.
+- **`emberExternals()`** — keeps your `dependencies`, `peerDependencies`, and
+  the ember virtual packages (e.g. `@ember/component`, `@glimmer/tracking`, the
+  template compiler) external, so the consuming app resolves them.
+- **`emberTransform()`** — preprocesses `<template>` via
+  [content-tag](https://github.com/embroider-build/content-tag) and maps
+  `.gts`/`.gjs` to `.ts`/`.js` so rolldown understands them. Also rewrites
+  `.gts` specifiers in emitted `.d.ts` files.
+- **`emberBabel()`** — runs babel with `babelHelpers: "bundled"`, but only on
+  the files that actually need it (template-tag, decorators, template imports);
+  everything else stays on rolldown's fast native (oxc) transform.
+
+## Configuration
+
+```ts
+ember({
+  babel: {
+    configFile: "./babel.config.js",
+    babelHelpers: "bundled",
+    plugins: [],
+    filter: { include: { imports: ["ember-concurrency"], code: [] } },
+  },
+});
+```
+
+Each option is documented on `BabelOptions`.
+
+## Credit
+
+The `emberExternals` and `emberTransform` plugins are derived from
+[embroider-build/embroider#2658](https://github.com/embroider-build/embroider/pull/2658).

package/packages/rolldown/index.ts

@@ -0,0 +1,60 @@
+import type { Plugin } from "rolldown";
+
+import { emberBabel, type BabelOptions } from "./src/babel.ts";
+import { emberConfig } from "./src/config.ts";
+import { emberExternals } from "./src/externals.ts";
+import { emberIsolatedDeclarations } from "./src/isolated-declarations.ts";
+import { emberTransform } from "./src/transform.ts";
+
+interface Config {
+  /**
+   * Options for the babel step; see `BabelOptions`.
+   */
+  babel?: BabelOptions;
+}
+
+/**
+ * A batteries-included plugin for building Ember v2 libraries (addons) with
+ * rolldown (or tsdown, which is built on rolldown).
+ *
+ * It bundles everything needed to compile `.gts`/`.gjs` and template-tag
+ * (`<template>`) source into publishable output:
+ *
+ * - `emberConfig()` — applies sensible tsdown defaults for a library build
+ *   (sourcemaps, `clean`, `dts`, `.js`/`.d.ts` extensions, quiet logging);
+ *   anything you set explicitly still wins.
+ * - `emberIsolatedDeclarations()` — errors when a tsconfig.json is present
+ *   without `isolatedDeclarations: true` (required: it is the only
+ *   declaration pipeline that can see compiled template-tag modules).
+ * - `emberExternals()` — keeps your dependencies, peerDependencies, and the
+ *   ember virtual packages external, so consuming apps resolve them.
+ * - `emberTransform()` — preprocesses `<template>` via content-tag and maps
+ *   `.gts`/`.gjs` to `.ts`/`.js` so rolldown can understand them.
+ * - `emberBabel()` — runs babel (template compilation, decorators, type
+ *   stripping) with `babelHelpers: "bundled"`, but only on the files that
+ *   actually need it (via `maybeBabel`); everything else stays on the fast
+ *   native transform. The library's own `babel.config.js` is used when it
+ *   exists; no config file is required.
+ *
+ * Usage in `tsdown.config.js` (import `defineConfig` from `tsdown` — or from
+ * `rolldown` for a `rolldown.config.js` — so it carries the correct types):
+ *
+ * ```js
+ * import { defineConfig } from "tsdown";
+ * import { ember } from "@nullvoxpopuli/ember-rolldown";
+ *
+ * export default defineConfig({
+ *   entry: ["./src/index.ts"],
+ *   plugins: [ember()],
+ * });
+ * ```
+ */
+export function ember(config: Config = {}): Plugin[] {
+  return [
+    emberConfig(),
+    emberIsolatedDeclarations(),
+    emberExternals(),
+    emberTransform(),
+    emberBabel(config.babel),
+  ];
+}