ember.nvp 1.1.0 → 1.3.0

package/.release-plan.json

@@ -2,21 +2,13 @@
   "solution": {
     "ember.nvp": {
       "impact": "minor",
-      "oldVersion": "1.0.0",
-      "newVersion": "1.1.0",
+      "oldVersion": "1.2.0",
+      "newVersion": "1.3.0",
       "tagName": "latest",
       "constraints": [
         {
           "impact": "minor",
           "reason": "Appears in changelog section :rocket: Enhancement"
-        },
-        {
-          "impact": "patch",
-          "reason": "Appears in changelog section :memo: Documentation"
-        },
-        {
-          "impact": "patch",
-          "reason": "Appears in changelog section :house: Internal"
         }
       ],
       "pkgJSONPath": "./package.json"
@@ -26,21 +18,13 @@
     },
     "@nullvoxpopuli/ember-rolldown": {
       "impact": "minor",
-      "oldVersion": "2.0.0",
-      "newVersion": "2.1.0",
+      "oldVersion": "2.4.0",
+      "newVersion": "2.5.0",
       "tagName": "latest",
       "constraints": [
         {
           "impact": "minor",
           "reason": "Appears in changelog section :rocket: Enhancement"
-        },
-        {
-          "impact": "patch",
-          "reason": "Appears in changelog section :memo: Documentation"
-        },
-        {
-          "impact": "patch",
-          "reason": "Appears in changelog section :house: Internal"
         }
       ],
       "pkgJSONPath": "./packages/rolldown/package.json"
@@ -49,5 +33,5 @@
       "oldVersion": "1.1.0"
     }
   },
-  "description": "## Release (2026-07-22)\n\n* ember.nvp 1.1.0 (minor)\n* @nullvoxpopuli/ember-rolldown 2.1.0 (minor)\n\n#### :rocket: Enhancement\n* `@nullvoxpopuli/ember-rolldown`\n  * [#97](https://github.com/NullVoxPopuli/ember.nvp/pull/97) Add appReexports plugin as a separate ember-rolldown entrypoint ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#95](https://github.com/NullVoxPopuli/ember.nvp/pull/95) enable declaration maps in the rolldown plugin ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n* `ember.nvp`\n  * [#91](https://github.com/NullVoxPopuli/ember.nvp/pull/91) Add a browser extension project type (minimal-extension base) ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n\n#### :memo: Documentation\n* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#96](https://github.com/NullVoxPopuli/ember.nvp/pull/96) rolldown: document + test co-located CSS support ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### :house: Internal\n* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`\n  * [#93](https://github.com/NullVoxPopuli/ember.nvp/pull/93) More tests ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n* `ember.nvp`\n  * [#92](https://github.com/NullVoxPopuli/ember.nvp/pull/92) Move check layers into their own permutation matrix ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n  * [#90](https://github.com/NullVoxPopuli/ember.nvp/pull/90) Remove pinYukuParser test helper ([@Copilot](https://github.com/apps/copilot-swe-agent))\n  * [#89](https://github.com/NullVoxPopuli/ember.nvp/pull/89) refactor(test): extract shared listFiles/read helpers to #test-helpers ([@Copilot](https://github.com/apps/copilot-swe-agent))\n  * [#87](https://github.com/NullVoxPopuli/ember.nvp/pull/87) Convert Greeting declaration check to inline snapshot assertion ([@Copilot](https://github.com/apps/copilot-swe-agent))\n\n#### Committers: 3\n- @NullVoxPopuli's reduced-access machine account for AI usage ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))\n- Copilot [Bot] ([@copilot-swe-agent](https://github.com/apps/copilot-swe-agent))\n- [@NullVoxPopuli](https://github.com/NullVoxPopuli)\n"
+  "description": "## Release (2026-08-03)\n\n* ember.nvp 1.3.0 (minor)\n* @nullvoxpopuli/ember-rolldown 2.5.0 (minor)\n\n#### :rocket: Enhancement\n* `ember.nvp`\n  * [#106](https://github.com/NullVoxPopuli/ember.nvp/pull/106) README layer ([@tcjr](https://github.com/tcjr))\n* `@nullvoxpopuli/ember-rolldown`\n  * [#107](https://github.com/NullVoxPopuli/ember.nvp/pull/107) rolldown: check the tsconfig the build uses, not always tsconfig.json ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### Committers: 2\n- Tom Carter ([@tcjr](https://github.com/tcjr))\n- [@NullVoxPopuli](https://github.com/NullVoxPopuli)\n"
 }

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # Changelog
 
+## Release (2026-08-03)
+
+* ember.nvp 1.3.0 (minor)
+* @nullvoxpopuli/ember-rolldown 2.5.0 (minor)
+
+#### :rocket: Enhancement
+* `ember.nvp`
+  * [#106](https://github.com/NullVoxPopuli/ember.nvp/pull/106) README layer ([@tcjr](https://github.com/tcjr))
+* `@nullvoxpopuli/ember-rolldown`
+  * [#107](https://github.com/NullVoxPopuli/ember.nvp/pull/107) rolldown: check the tsconfig the build uses, not always tsconfig.json ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### Committers: 2
+- Tom Carter ([@tcjr](https://github.com/tcjr))
+- [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+
+## Release (2026-07-24)
+
+* @nullvoxpopuli/ember-rolldown 2.4.0 (minor)
+
+#### :rocket: Enhancement
+* `@nullvoxpopuli/ember-rolldown`
+  * [#104](https://github.com/NullVoxPopuli/ember.nvp/pull/104) rolldown: support .gts/.gjs build entries ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### Committers: 1
+- [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+
+## Release (2026-07-22)
+
+* @nullvoxpopuli/ember-rolldown 2.3.0 (minor)
+
+#### :rocket: Enhancement
+* `@nullvoxpopuli/ember-rolldown`
+  * [#101](https://github.com/NullVoxPopuli/ember.nvp/pull/101) appReexports: accept string[] include and options as second argument ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+
+#### :bug: Bug Fix
+* `@nullvoxpopuli/ember-rolldown`
+  * [#103](https://github.com/NullVoxPopuli/ember.nvp/pull/103) rolldown: externalize the modules ember-source provides (renamed-modules) ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### 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-22)
+
+* ember.nvp 1.2.0 (minor)
+* @nullvoxpopuli/ember-rolldown 2.2.0 (minor)
+
+#### :rocket: Enhancement
+* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`
+  * [#98](https://github.com/NullVoxPopuli/ember.nvp/pull/98) Integration-test ember-scoped-css; add babel.templateTransforms ([@NullVoxPopuli-ai-agent](https://github.com/NullVoxPopuli-ai-agent))
+
+#### :bug: Bug Fix
+* `@nullvoxpopuli/ember-rolldown`
+  * [#99](https://github.com/NullVoxPopuli/ember.nvp/pull/99) rolldown: fix virtual .gts declaration resolution + specifier-rewrite sourcemaps ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### 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-22)
 
 * ember.nvp 1.1.0 (minor)

package/README.md

@@ -198,6 +198,11 @@ export default {
 
     await packageJson.addScripts({ "my-script": 'echo "Hello"' }, project.directory);
   },
+
+  // Optionally add something to the README.md file
+  readme() {
+    return "### My Feature\n\nHere's what my feature brings to the table.";
+  },
 };
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ember.nvp",
-  "version": "1.1.0",
+  "version": "1.3.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",

package/packages/rolldown/README.md

@@ -58,11 +58,30 @@ A `babel.config.js` is optional. Without one, `ember()` compiles templates
 [decorator-transforms](https://github.com/ef4/decorator-transforms)), and
 TypeScript; with one, your config runs instead.
 
+### Entrypoints
+
+Entries may be any extension — `.ts`, `.js`, `.gts`, `.gjs`:
+
+```js
+export default defineConfig({
+  entry: ["./src/index.ts", "./src/components/menu.gts"],
+  plugins: [ember()],
+});
+```
+
+Whatever the source extension, the emitted `.js` and `.d.ts` paths mirror the
+entry paths (that's how tsdown's dts support works): the example emits
+`dist/index.js` + `dist/index.d.ts` and `dist/components/menu.js` +
+`dist/components/menu.d.ts`. Type imports resolve against those emitted
+paths, so your entries — together with your `exports` map — _are_ your
+public API: a module that isn't an entry has no stable `dist/` path of its
+own and is only reachable through the entrypoints that re-export it.
+
 ### 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
+inside the bundler's module graph. The tsconfig your build uses must enable it
 (`ember()` errors otherwise):
 
 ```jsonc
@@ -82,6 +101,33 @@ import type { TOC } from "@ember/component/template-only";
 export const Badge: TOC<BadgeSignature> = <template>...</template>;
 ```
 
+#### Keeping the constraint off dev-only code
+
+`isolatedDeclarations` is a constraint on how _published_ code is written, so it
+should cover only the code you emit declarations for. If your package also holds
+dev-only code — a demo app, in-package tests — putting the flag on the single
+`tsconfig.json` that covers everything would force explicit annotations on demo
+components and test helpers that never get a `.d.ts` emitted for them.
+
+The tsconfig `ember()` checks is the one
+[tsdown's `tsconfig` option](https://tsdown.dev/options/tsconfig) points at, so
+point the build at a publish-only config and leave `tsconfig.json` alone for
+editors and `tsc --noEmit`:
+
+```js
+// tsdown.config.js
+export default defineConfig({
+  entry: ["./src/index.ts"],
+  // include: ["src/**/*"], isolatedDeclarations: true
+  tsconfig: "./tsconfig.publish.json",
+  plugins: [ember()],
+});
+```
+
+The tradeoff: isolated-declaration errors in `src` then surface when you build
+rather than in your editor, since the editor uses `tsconfig.json`. Run the build
+(or `tsc --noEmit -p tsconfig.publish.json`) in CI so nothing lands unchecked.
+
 ## CSS
 
 Components that import co-located CSS (`import './popup.css'`) need
@@ -99,16 +145,50 @@ because the importing component module never loads, any declaration that
 references that component dangles, surfacing as misleading
 `UNLOADABLE_DEPENDENCY` errors on `<component>.d.ts` files.
 
-Scoping/transforming the CSS itself (e.g.
-[ember-scoped-css](https://github.com/soxhub/ember-scoped-css)) is separate
-from bundling and runs via its own plugins.
+### ember-scoped-css
+
+[ember-scoped-css](https://github.com/auditboard/ember-scoped-css) works with
+this pipeline: its template transform rides along via `ember()`'s
+`babel.templateTransforms` option, and its unplugin (`ember-scoped-css/rollup`)
+resolves the scoped CSS requests the transform injects:
+
+```js
+import { defineConfig } from "tsdown";
+import { ember } from "@nullvoxpopuli/ember-rolldown";
+import { scopedCSS } from "ember-scoped-css/rollup";
+import { scopedCSS as scopedCssBabel } from "ember-scoped-css/babel";
+
+export default defineConfig({
+  entry: ["./src/index.ts"],
+  css: { inject: true },
+  plugins: [
+    ember({
+      babel: {
+        plugins: [scopedCssBabel()],
+        templateTransforms: [scopedCssBabel.template({})],
+      },
+    }),
+    scopedCSS(),
+  ],
+});
+```
+
+This scopes co-located `.css` files, inline `<style scoped>` blocks, and the
+`scopedClass` pseudo-helper (that last one is what the `babel.plugins` entry
+handles — leave it off if you don't use `scopedClass` in module code).
+
+`css.inject` matters for libraries: it keeps the `import "./style.css"`
+statement in `dist/index.js`, so consuming apps pull the styles in through
+the module graph — without it the bundled CSS is emitted but nothing loads
+it.
 
 ## What `ember()` does
 
 `ember()` returns an array of rolldown plugins:
 
-- **`emberIsolatedDeclarations()`** — errors when a `tsconfig.json` is present
-  without `isolatedDeclarations: true`.
+- **`emberIsolatedDeclarations()`** — errors when the tsconfig the build uses
+  (tsdown's `tsconfig` option, defaulting to `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.
@@ -128,12 +208,17 @@ ember({
     configFile: "./babel.config.js",
     babelHelpers: "bundled",
     plugins: [],
+    templateTransforms: [],
     filter: { include: { imports: ["ember-concurrency"], code: [] } },
   },
 });
 ```
 
-Each option is documented on `BabelOptions`.
+Each option is documented on `BabelOptions`. `templateTransforms` feeds
+template AST transforms to the default template-compilation step; it can't be
+combined with a babel config file — a config lists
+`babel-plugin-ember-template-compilation` itself, so its transforms belong
+there.
 
 ## App re-exports
 
@@ -156,12 +241,14 @@ export default defineConfig({
 
 With no arguments, top-level services (`services/*`) are re-exported — under
 strict mode, components and helpers are imported, but services are still
-injected by name. A string argument is an include glob, and an object gives
-full control:
+injected by name. A string or array of strings is the include glob(s),
+optionally followed by the remaining options; an object gives full control:
 
 ```js
 appReexports(); // services/*
 appReexports("components/**"); // one include glob
+appReexports(["services/*", "helpers/*"]);
+appReexports("components/**", { exclude: ["components/-private/**"] });
 appReexports({ include: ["services/*", "helpers/*"], exclude: [...] });
 ```
 

package/packages/rolldown/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nullvoxpopuli/ember-rolldown",
-  "version": "2.1.0",
+  "version": "2.5.0",
   "description": "Meta plugin for building ember v2 libraries/addons with rolldown & tsdown.",
   "type": "module",
   "main": "index.ts",

package/packages/rolldown/src/app-reexports.test.ts

@@ -51,13 +51,16 @@ describe("appReexports", () => {
     await rm(projectDir, { recursive: true, force: true });
   });
 
-  async function build(options?: string | AppReexportsOptions) {
+  async function build(
+    include?: string | string[] | AppReexportsOptions,
+    options?: Omit<AppReexportsOptions, "include">,
+  ) {
     const bundle = await rolldown({
       input: {
         "components/foo": "./src/components/foo.js",
         "utils/math": "./src/utils/math.js",
       },
-      plugins: [appReexports(options)],
+      plugins: [appReexports(include, options)],
     });
 
     await bundle.write({ dir: "dist" });
@@ -100,6 +103,36 @@ describe("appReexports", () => {
     expect(Object.keys(manifest["ember-addon"]["app-js"])).toEqual(["./components/foo.js"]);
   });
 
+  it("accepts an array of include globs", async () => {
+    await build(["components/**", "utils/**"]);
+
+    const manifest = await readJson("package.json");
+
+    expect(Object.keys(manifest["ember-addon"]["app-js"])).toEqual([
+      "./components/foo.js",
+      "./utils/math.js",
+    ]);
+  });
+
+  it("accepts options as the second argument alongside a string or array include", async () => {
+    await build("**/*.js", { exclude: ["utils/**"] });
+
+    let manifest = await readJson("package.json");
+
+    expect(Object.keys(manifest["ember-addon"]["app-js"])).toEqual(["./components/foo.js"]);
+
+    await build(["components/**", "utils/**"], {
+      mapFilename: (name) => name.replace("math", "arithmetic"),
+    });
+
+    manifest = await readJson("package.json");
+
+    expect(manifest["ember-addon"]["app-js"]).toEqual({
+      "./components/foo.js": "./dist/_app_/components/foo.js",
+      "./utils/arithmetic.js": "./dist/_app_/utils/arithmetic.js",
+    });
+  });
+
   it("defaults to top-level services", async () => {
     await mkdir(join(projectDir, "src/services/nested"), { recursive: true });
     await writeFile(join(projectDir, "src/services/session.js"), "export default class {}\n");

package/packages/rolldown/src/app-reexports.ts

@@ -65,16 +65,27 @@ export interface AppReexportsOptions {
  * ```
  *
  * With no arguments, top-level services (`services/*`) are re-exported. A
- * string argument is an include glob; an object gives full control:
+ * string or array of strings is the include glob(s), optionally followed by
+ * the remaining options; an object gives full control:
  *
  * ```js
  * appReexports();                          // services/*
  * appReexports("components/**");           // one include glob
+ * appReexports(["services/*", "helpers/*"]);
+ * appReexports("components/**", { exclude: ["components/-private/**"] });
  * appReexports({ include: ["services/*", "helpers/*"], exclude: [...] });
  * ```
  */
-export function appReexports(options: string | AppReexportsOptions = {}): Plugin {
-  const resolved = typeof options === "string" ? { include: [options] } : options;
+export function appReexports(
+  includeOrOptions: string | string[] | AppReexportsOptions = {},
+  options: Omit<AppReexportsOptions, "include"> = {},
+): Plugin {
+  const resolved =
+    typeof includeOrOptions === "string"
+      ? { ...options, include: [includeOrOptions] }
+      : Array.isArray(includeOrOptions)
+        ? { ...options, include: includeOrOptions }
+        : includeOrOptions;
   const include = resolved.include ?? ["services/*"];
 
   return {

package/packages/rolldown/src/babel.test.ts

@@ -0,0 +1,17 @@
+import { describe, expect, it } from "vitest";
+
+import { emberBabel } from "./babel.ts";
+
+describe("emberBabel", () => {
+  it("rejects templateTransforms combined with a config file", () => {
+    expect(() =>
+      emberBabel({ configFile: "./babel.config.js", templateTransforms: ["some-transform"] }),
+    ).toThrow(/pass the transforms/);
+  });
+
+  it("allows templateTransforms when config files are opted out", () => {
+    expect(() =>
+      emberBabel({ configFile: false, templateTransforms: ["some-transform"] }),
+    ).not.toThrow();
+  });
+});

package/packages/rolldown/src/babel.ts

@@ -4,6 +4,7 @@ import templateCompilation from "babel-plugin-ember-template-compilation";
 import decoratorTransforms from "decorator-transforms";
 import { loadPartialConfigSync } from "@babel/core";
 import type { PluginItem } from "@babel/core";
+import type { Transform } from "babel-plugin-ember-template-compilation";
 import type { Plugin } from "rolldown";
 
 export interface BabelOptions {
@@ -24,6 +25,15 @@ export interface BabelOptions {
    * Extra babel plugins to run, appended after the config's plugins.
    */
   plugins?: PluginItem[];
+  /**
+   * Template AST transforms (e.g. ember-scoped-css's `scopedCSS.template()`)
+   * passed to the default `babel-plugin-ember-template-compilation` entry.
+   *
+   * Only valid without a babel config file: with your own config, you list
+   * `babel-plugin-ember-template-compilation` yourself, so its `transforms`
+   * belong there.
+   */
+  templateTransforms?: Transform[];
   /**
    * Opt additional files into babel (see maybeBabel's `filter`). Use this to
    * cover addons that ship code needing babel (e.g. `ember-concurrency`).
@@ -63,7 +73,7 @@ function detectConfigFile(): string | undefined {
  *   consuming app resolves it (the library keeps `decorator-transforms` as
  *   a real dependency).
  */
-function defaultPlugins(): PluginItem[] {
+function defaultPlugins(templateTransforms?: Transform[]): PluginItem[] {
   return [
     [
       transformTypeScript,
@@ -73,7 +83,7 @@ function defaultPlugins(): PluginItem[] {
         allowDeclareFields: true,
       },
     ],
-    [templateCompilation, { targetFormat: "hbs" }],
+    [templateCompilation, { targetFormat: "hbs", transforms: templateTransforms ?? [] }],
     [
       decoratorTransforms,
       {
@@ -118,6 +128,14 @@ export function emberBabel(options: BabelOptions = {}): Plugin {
   };
 
   if (configFile) {
+    if (options.templateTransforms?.length) {
+      throw new Error(
+        `\`babel.templateTransforms\` cannot be combined with a babel config file (found ${configFile}). ` +
+          `Your config lists babel-plugin-ember-template-compilation itself, so pass the transforms ` +
+          `to its \`transforms\` option there instead.`,
+      );
+    }
+
     return maybeBabel({
       ...shared,
       configFile,
@@ -131,6 +149,6 @@ export function emberBabel(options: BabelOptions = {}): Plugin {
     // for one -- we provide the whole plugin list inline.
     configFile: false,
     babelrc: false,
-    plugins: defaultPlugins().concat(options.plugins ?? []),
+    plugins: defaultPlugins(options.templateTransforms).concat(options.plugins ?? []),
   }) as unknown as Plugin;
 }