ember.nvp 1.3.0 → 1.5.0

package/.release-plan.json

@@ -2,13 +2,17 @@
   "solution": {
     "ember.nvp": {
       "impact": "minor",
-      "oldVersion": "1.2.0",
-      "newVersion": "1.3.0",
+      "oldVersion": "1.4.0",
+      "newVersion": "1.5.0",
       "tagName": "latest",
       "constraints": [
         {
           "impact": "minor",
           "reason": "Appears in changelog section :rocket: Enhancement"
+        },
+        {
+          "impact": "patch",
+          "reason": "Appears in changelog section :bug: Bug Fix"
         }
       ],
       "pkgJSONPath": "./package.json"
@@ -17,21 +21,11 @@
       "oldVersion": "1.1.0"
     },
     "@nullvoxpopuli/ember-rolldown": {
-      "impact": "minor",
-      "oldVersion": "2.4.0",
-      "newVersion": "2.5.0",
-      "tagName": "latest",
-      "constraints": [
-        {
-          "impact": "minor",
-          "reason": "Appears in changelog section :rocket: Enhancement"
-        }
-      ],
-      "pkgJSONPath": "./packages/rolldown/package.json"
+      "oldVersion": "2.7.0"
     },
     "@nullvoxpopuli/ember-vite": {
       "oldVersion": "1.1.0"
     }
   },
-  "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"
+  "description": "## Release (2026-08-18)\n\n* ember.nvp 1.5.0 (minor)\n\n#### :rocket: Enhancement\n* `ember.nvp`\n  * [#125](https://github.com/NullVoxPopuli/ember.nvp/pull/125) Update to 7.2, drop ember-strict-application-resolver polyfill ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### :bug: Bug Fix\n* `ember.nvp`\n  * [#121](https://github.com/NullVoxPopuli/ember.nvp/pull/121) Fix initial README formatting ([@tcjr](https://github.com/tcjr))\n  * [#122](https://github.com/NullVoxPopuli/ember.nvp/pull/122) Strip debug code from production app builds ([@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,62 @@
 # Changelog
 
+## Release (2026-08-18)
+
+* ember.nvp 1.5.0 (minor)
+
+#### :rocket: Enhancement
+* `ember.nvp`
+  * [#125](https://github.com/NullVoxPopuli/ember.nvp/pull/125) Update to 7.2, drop ember-strict-application-resolver polyfill ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### :bug: Bug Fix
+* `ember.nvp`
+  * [#121](https://github.com/NullVoxPopuli/ember.nvp/pull/121) Fix initial README formatting ([@tcjr](https://github.com/tcjr))
+  * [#122](https://github.com/NullVoxPopuli/ember.nvp/pull/122) Strip debug code from production app builds ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### Committers: 2
+- Tom Carter ([@tcjr](https://github.com/tcjr))
+- [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+
+## Release (2026-08-07)
+
+* @nullvoxpopuli/ember-rolldown 2.7.0 (minor)
+
+#### :rocket: Enhancement
+* `@nullvoxpopuli/ember-rolldown`
+  * [#118](https://github.com/NullVoxPopuli/ember.nvp/pull/118) rolldown: ship type declarations ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### Committers: 1
+- [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+
+## Release (2026-08-05)
+
+* @nullvoxpopuli/ember-rolldown 2.6.1 (patch)
+
+#### :bug: Bug Fix
+* `@nullvoxpopuli/ember-rolldown`
+  * [#115](https://github.com/NullVoxPopuli/ember.nvp/pull/115) rolldown: don't resolve absolute specifiers against the importer's directory ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### Committers: 1
+- [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+
+## Release (2026-08-03)
+
+* ember.nvp 1.4.0 (minor)
+* @nullvoxpopuli/ember-rolldown 2.6.0 (minor)
+
+#### :rocket: Enhancement
+* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`
+  * [#111](https://github.com/NullVoxPopuli/ember.nvp/pull/111) rolldown: find publish configs in config/ too ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+* `@nullvoxpopuli/ember-rolldown`
+  * [#109](https://github.com/NullVoxPopuli/ember.nvp/pull/109) rolldown: prefer babel.publish.config over babel.config ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### :house: Internal
+* `@nullvoxpopuli/ember-rolldown`, `ember.nvp`
+  * [#112](https://github.com/NullVoxPopuli/ember.nvp/pull/112) rolldown: test the isolated-declarations guard through generated libraries ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### Committers: 1
+- [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+
 ## Release (2026-08-03)
 
 * ember.nvp 1.3.0 (minor)

package/package.json

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

@@ -53,10 +53,12 @@ export default defineConfig({
 });
 ```
 
-A `babel.config.js` is optional. Without one, `ember()` compiles templates
+A babel config 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.
+TypeScript; with one, your config runs instead. A `babel.publish.config.*` is
+preferred over a `babel.config.*` — see
+[Publish vs. development babel config](#publish-vs-development-babel-config).
 
 ### Entrypoints
 
@@ -124,6 +126,21 @@ export default defineConfig({
 });
 ```
 
+Any path works, so the publish config can live wherever you keep build
+configuration — `tsconfig: "./config/tsconfig.publish.json"`. (A directory works
+too: `tsconfig: "./config"` picks up `config/tsconfig.json`.)
+
+`tsconfig: false` is rejected while declarations are on: with no tsconfig there
+is no `isolatedDeclarations`, and the fallback pipeline can't see compiled
+`.gts`, so it would fail later with "Source file not found". Set `dts: false`
+alongside it if the library ships no types.
+
+A tsconfig's relative paths resolve against the file itself, so a config kept in
+`config/` wants `"include": ["../src/**/*"]` and `"rootDir": "../src"`. The build
+won't tell you if you get that wrong — tsdown drives declaration emit from
+`entry`, not from the tsconfig's `include` — but `tsc`/`ember-tsc` and your
+editor will, if you ever point them at that config.
+
 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.
@@ -198,7 +215,9 @@ it.
   `.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.
+  everything else stays on rolldown's fast native (oxc) transform. Uses your
+  `babel.publish.config.*` (root or `config/`) in preference to your
+  `babel.config.*`.
 
 ## Configuration
 
@@ -220,6 +239,46 @@ combined with a babel config file — a config lists
 `babel-plugin-ember-template-compilation` itself, so its transforms belong
 there.
 
+### Publish vs. development babel config
+
+A library's plain `babel.config.*` is usually its _development_ config: it
+compiles `@embroider/macros` away, targets the wire format, and wires up
+whatever the in-package demo app or test suite needs. None of that belongs in a
+published artifact — macros must survive for the consuming app to evaluate, and
+the wire format is private between one template compiler and one glimmer
+runtime of the same version.
+
+Babel's own resolution can't tell those apart, so `ember()` looks for a config
+named for publishing first. With no explicit `configFile`, detection is:
+
+1. `babel.publish.config.{mjs,cjs,js,mts,cts,ts,json}` in the package root
+2. the same names in `config/`
+3. otherwise babel's own resolution (`babel.config.*`, honoring `rootMode`)
+4. otherwise no config file — templates, decorators and TypeScript are still
+   handled by the built-in defaults
+
+So a library that keeps both configs needs no `babel` option at all:
+
+```
+my-addon/
+  babel.config.mjs          # dev: macros compiled, wire format, test-app wiring
+  babel.publish.config.mjs  # what ember() uses
+```
+
+...and so does one that keeps build configuration out of its root:
+
+```
+my-addon/
+  babel.config.mjs
+  config/
+    babel.publish.config.mjs  # what ember() uses
+    tsconfig.publish.json     # see below
+```
+
+Set `configFile` explicitly to override that (`configFile: false` ignores config
+files entirely, which is what you want when your publish config would just
+restate the built-in defaults).
+
 ## App re-exports
 
 For libraries whose modules must appear in the consuming app's namespace

package/packages/rolldown/index.ts

@@ -1,10 +1,9 @@
-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";
+import type { RolldownPluginLike } from "./src/plugin-like.ts";
 
 interface Config {
   /**
@@ -49,7 +48,7 @@ interface Config {
  * });
  * ```
  */
-export function ember(config: Config = {}): Plugin[] {
+export function ember(config: Config = {}): RolldownPluginLike[] {
   return [
     emberConfig(),
     emberIsolatedDeclarations(),

package/packages/rolldown/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nullvoxpopuli/ember-rolldown",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "Meta plugin for building ember v2 libraries/addons with rolldown & tsdown.",
   "type": "module",
   "main": "index.ts",
@@ -11,9 +11,16 @@
   "publishConfig": {
     "main": "dist/index.js",
     "exports": {
-      ".": "./dist/index.js",
-      "./app-reexports": "./dist/app-reexports.js"
-    }
+      ".": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "./app-reexports": {
+        "types": "./dist/app-reexports.d.ts",
+        "default": "./dist/app-reexports.js"
+      }
+    },
+    "types": "dist/index.d.ts"
   },
   "keywords": [
     "rolldown",
@@ -31,7 +38,7 @@
     "directory": "packages/rolldown"
   },
   "scripts": {
-    "build": "rolldown --config",
+    "build": "tsdown",
     "prepack": "pnpm build"
   },
   "packageManager": "pnpm@10.28.0",

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

@@ -1,7 +1,7 @@
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, extname, join, matchesGlob, relative, resolve, sep } from "node:path";
 
-import type { Plugin } from "rolldown";
+import type { RolldownPluginLike } from "./plugin-like.ts";
 
 export interface AppReexportsOptions {
   /**
@@ -79,7 +79,7 @@ export interface AppReexportsOptions {
 export function appReexports(
   includeOrOptions: string | string[] | AppReexportsOptions = {},
   options: Omit<AppReexportsOptions, "include"> = {},
-): Plugin {
+): RolldownPluginLike {
   const resolved =
     typeof includeOrOptions === "string"
       ? { ...options, include: [includeOrOptions] }

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

@@ -1,6 +1,85 @@
-import { describe, expect, it } from "vitest";
+import { mkdtemp, mkdir, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { rolldown } from "rolldown";
+import { afterEach, describe, expect, it } from "vitest";
 
-import { emberBabel } from "./babel.ts";
+import { emberBabel, type BabelOptions } from "./babel.ts";
+import { emberTransform } from "./transform.ts";
+
+let restoreCwd: (() => void) | undefined;
+
+afterEach(() => {
+  restoreCwd?.();
+  restoreCwd = undefined;
+});
+
+/**
+ * A babel config whose only plugin rewrites the string `"MARKER"` to `name`, so
+ * the emitted code says which config file babel actually loaded.
+ */
+function markerConfig(name: string): string {
+  return [
+    `export default {`,
+    `  plugins: [`,
+    `    function marker() {`,
+    `      return {`,
+    `        visitor: {`,
+    `          StringLiteral(path) {`,
+    `            if (path.node.value === 'MARKER') path.node.value = '${name}';`,
+    `          },`,
+    `        },`,
+    `      };`,
+    `    },`,
+    `  ],`,
+    `};`,
+  ].join("\n");
+}
+
+/**
+ * Builds a `.gts` entry (so babel actually runs -- `maybeBabel` skips files that
+ * need no transform) in a temp dir that becomes the cwd, the way config
+ * detection sees it under the tsdown CLI. Returns the emitted code.
+ */
+async function bundleWithBabel(
+  files: Record<string, string>,
+  options?: BabelOptions,
+): Promise<string> {
+  const dir = await mkdtemp(path.join(tmpdir(), "ember-rolldown-babel-"));
+
+  const withDefaults: Record<string, string> = {
+    "package.json": JSON.stringify({ name: "fixture", version: "0.0.0", type: "module" }),
+    "index.gts": [
+      `export const marker = 'MARKER';`,
+      `export default <template>hi</template>;`,
+    ].join("\n"),
+    ...files,
+  };
+
+  for (const [relative, source] of Object.entries(withDefaults)) {
+    const full = path.join(dir, relative);
+    await mkdir(path.dirname(full), { recursive: true });
+    await writeFile(full, source, "utf8");
+  }
+
+  const previousCwd = process.cwd();
+  process.chdir(dir);
+  restoreCwd = () => process.chdir(previousCwd);
+
+  const build = await rolldown({
+    input: [path.join(dir, "index.gts")],
+    plugins: [emberTransform(), emberBabel(options)],
+    external: (id) => !(id.startsWith(".") || path.isAbsolute(id)),
+    onwarn() {},
+  });
+
+  const { output } = await build.generate({ format: "es" });
+
+  return output
+    .filter((chunk): chunk is typeof chunk & { code: string } => "code" in chunk)
+    .map((chunk) => chunk.code)
+    .join("\n");
+}
 
 describe("emberBabel", () => {
   it("rejects templateTransforms combined with a config file", () => {
@@ -14,4 +93,48 @@ describe("emberBabel", () => {
       emberBabel({ configFile: false, templateTransforms: ["some-transform"] }),
     ).not.toThrow();
   });
+
+  describe("config detection", () => {
+    it("prefers babel.publish.config over babel.config", async () => {
+      const code = await bundleWithBabel({
+        "babel.config.mjs": markerConfig("dev"),
+        "babel.publish.config.mjs": markerConfig("publish"),
+      });
+
+      expect(code).toContain(`"publish"`);
+      expect(code).not.toContain(`"dev"`);
+    });
+
+    it("falls back to babel.config when there is no publish config", async () => {
+      const code = await bundleWithBabel({ "babel.config.mjs": markerConfig("dev") });
+
+      expect(code).toContain(`"dev"`);
+    });
+
+    it("uses an explicit configFile over either", async () => {
+      const code = await bundleWithBabel(
+        {
+          "babel.config.mjs": markerConfig("dev"),
+          "babel.publish.config.mjs": markerConfig("publish"),
+          "babel.explicit.config.mjs": markerConfig("explicit"),
+        },
+        { configFile: "./babel.explicit.config.mjs" },
+      );
+
+      expect(code).toContain(`"explicit"`);
+      expect(code).not.toContain(`"publish"`);
+    });
+
+    it("ignores every config file when configFile is false", async () => {
+      const code = await bundleWithBabel(
+        {
+          "babel.config.mjs": markerConfig("dev"),
+          "babel.publish.config.mjs": markerConfig("publish"),
+        },
+        { configFile: false },
+      );
+
+      expect(code).toContain(`"MARKER"`);
+    });
+  });
 });

package/packages/rolldown/src/babel.ts

@@ -3,6 +3,8 @@ import transformTypeScript from "@babel/plugin-transform-typescript";
 import templateCompilation from "babel-plugin-ember-template-compilation";
 import decoratorTransforms from "decorator-transforms";
 import { loadPartialConfigSync } from "@babel/core";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
 import type { PluginItem } from "@babel/core";
 import type { Transform } from "babel-plugin-ember-template-compilation";
 import type { Plugin } from "rolldown";
@@ -12,8 +14,9 @@ export interface BabelOptions {
   /**
    * The babel config file to use.
    *
-   * - `undefined`: auto-detect the project's babel config (via babel's own
-   *   config resolution).
+   * - `undefined`: auto-detect. A `babel.publish.config.*` (in the package root
+   *   or `config/`) wins, because this is a publish build; otherwise babel's own
+   *   config resolution applies (see `detectConfigFile`).
    * - a string: use that config file.
    * - `false`: ignore config files entirely.
    *
@@ -46,14 +49,55 @@ export interface BabelOptions {
   };
 }
 
+/** Tried in order, so an ESM config wins over a JSON one of the same name. */
+const PUBLISH_CONFIG_EXTENSIONS = ["mjs", "cjs", "js", "mts", "cts", "ts", "json"];
+
+/**
+ * Tried in order: next to package.json first, then `config/` for libraries that
+ * keep their build configuration out of the package root.
+ */
+const PUBLISH_CONFIG_DIRECTORIES = [".", "config"];
+
 /**
- * Resolve the project's root babel config the way babel itself does
- * (`babel.config.{js,cjs,mjs,cts,json}`, honoring `rootMode` semantics).
+ * A `babel.publish.config.*` (in the package root or `config/`), if there is
+ * one.
+ *
+ * A library's plain `babel.config.*` is its *development* config: it typically
+ * compiles `@embroider/macros` away, targets the wire format, and wires up
+ * whatever the in-package demo app or test suite needs. None of that belongs in
+ * a published artifact -- macros must stay for the consuming app to evaluate,
+ * and the wire format is private between one template compiler and one glimmer
+ * runtime. Babel's own resolution can't tell the two apart (it finds whatever
+ * `babel.config.*` exists), so a publish build has to prefer the config named
+ * for publishing.
+ */
+function detectPublishConfigFile(): string | undefined {
+  for (const directory of PUBLISH_CONFIG_DIRECTORIES) {
+    for (const extension of PUBLISH_CONFIG_EXTENSIONS) {
+      const candidate = resolve(directory, `babel.publish.config.${extension}`);
+
+      if (existsSync(candidate)) return candidate;
+    }
+  }
+
+  return undefined;
+}
+
+/**
+ * The config this publish build should use: a `babel.publish.config.*` when the
+ * library has one, else the project's root babel config resolved the way babel
+ * itself does (`babel.config.{js,cjs,mjs,cts,json}`, honoring `rootMode`
+ * semantics) -- which for a library whose only config *is* its publish config
+ * is the same file either way.
  *
  * The sync API evaluates the config file; on node 24+ that works for native
  * ESM configs too (require(esm)).
  */
 function detectConfigFile(): string | undefined {
+  const publishConfig = detectPublishConfigFile();
+
+  if (publishConfig) return publishConfig;
+
   const partial = loadPartialConfigSync({ cwd: process.cwd() });
 
   return partial?.config ?? undefined;
@@ -112,9 +156,10 @@ function defaultPlugins(templateTransforms?: Transform[]): PluginItem[] {
  * to only the files that actually need it (template-tag, decorators, template
  * imports). Everything else stays on the native transform.
  *
- * The library's own babel config is used when it exists; without one,
- * `defaultPlugins` covers templates, decorators, and TypeScript, so no
- * config file is required.
+ * The library's own babel config is used when it exists -- its
+ * `babel.publish.config.*` (root or `config/`) in preference to its
+ * `babel.config.*`, since this is a publish build. Without one, `defaultPlugins` covers templates, decorators,
+ * and TypeScript, so no config file is required.
  *
  * Libraries default to `babelHelpers: "bundled"` so the emitted output is
  * self-contained.

package/packages/rolldown/src/isolated-declarations.ts

@@ -55,12 +55,15 @@ function resolveTsconfigPath(option: string | boolean | undefined): string | und
  * sources -- isolated declarations then constrain exactly the code that gets
  * declarations emitted for it, and nothing else.
  *
- * Projects with no tsconfig (JavaScript libraries, or `tsconfig: false`) or
- * without the `typescript` package have no declarations to emit, so there is
- * nothing to check.
+ * Projects with no tsconfig (JavaScript libraries) or without the `typescript`
+ * package have no declarations to emit, so there is nothing to check.
+ * `tsconfig: false` is different: it is an explicit opt-out, and combined with
+ * declaration emit it produces a confusing "Source file not found" from the
+ * tsc-based pipeline, so it errors here instead.
  */
 export function emberIsolatedDeclarations(): Plugin {
   let tsconfigOption: string | boolean | undefined;
+  let emitsDeclarations = true;
 
   return {
     name: "ember:isolated-declarations",
@@ -69,9 +72,31 @@ export function emberIsolatedDeclarations(): Plugin {
     // -- i.e. the cwd's tsconfig.json, the only thing it could mean there.
     tsdownConfig(config: UserConfig) {
       tsconfigOption = config.tsconfig;
+      // `emberConfig()` turns dts on unless the library turned it off, so an
+      // explicit `false` is the only "no declarations" signal. Hook order
+      // between plugins isn't guaranteed, so don't rely on it having run.
+      emitsDeclarations = config.dts !== false;
     },
 
     async buildStart() {
+      if (tsconfigOption === false) {
+        if (!emitsDeclarations) return;
+
+        // Without a tsconfig there is no `isolatedDeclarations`, so tsdown
+        // falls back to the tsc-based declaration pipeline -- which reads
+        // source files from disk and dies with "Source file not found" on
+        // every `.gts`/`.gjs`, since those only exist compiled in the module
+        // graph. Say so here instead of leaving that to be decoded.
+        this.error(
+          `\`tsconfig: false\` cannot be combined with declaration emit.\n\n` +
+            `Declarations are emitted by the isolated-declarations pipeline, which needs a ` +
+            `tsconfig setting "compilerOptions.isolatedDeclarations": true -- it is the only ` +
+            `pipeline that can see compiled .gts/.gjs modules.\n\n` +
+            `Either point tsdown's \`tsconfig\` option at such a config, or set \`dts: false\` ` +
+            `if this library ships no types.`,
+        );
+      }
+
       const tsconfigPath = resolveTsconfigPath(tsconfigOption);
 
       if (!tsconfigPath || !existsSync(tsconfigPath)) return;

package/packages/rolldown/src/plugin-like.ts

@@ -0,0 +1,23 @@
+/**
+ * What this package hands back: an object that rolldown and tsdown accept in
+ * `plugins`.
+ *
+ * Structurally this *is* rolldown's `Plugin` -- `name` is its only required
+ * member, every hook is optional -- so the two are assignable in both
+ * directions: a consumer who imports rolldown's own type can still write
+ * `const plugins: Plugin[] = ember()`, and tsdown's `plugins` option lists
+ * `{ name: string }` among the shapes it takes.
+ *
+ * Declaring it here rather than re-exporting rolldown's type is what keeps
+ * `rolldown` out of the published declarations. Otherwise it has to become a
+ * runtime `dependency` purely so consumers can resolve a type: leave it a
+ * devDependency and the declaration bundler inlines a ~200kB private copy of
+ * rolldown's types instead, nominally distinct from the consumer's own.
+ *
+ * The precise hook signatures still apply inside this package -- each plugin
+ * function is typed with rolldown's real `Plugin` (a devDependency), and this
+ * type only widens what crosses the package boundary.
+ */
+export interface RolldownPluginLike {
+  name: string;
+}