feat: add entry option with glob support (#214)

sxzz · web-flow · commit c7079ee8c4b8 · 2026-03-27T16:23:10.000+08:00
diff --git a/package.json b/package.json
@@ -82,14 +82,16 @@
     "birpc": "^4.0.0",
     "dts-resolver": "^2.1.3",
     "get-tsconfig": "^4.13.7",
-    "obug": "^2.1.1"
+    "obug": "^2.1.1",
+    "picomatch": "^4.0.4"
   },
   "devDependencies": {
     "@jridgewell/source-map": "^0.3.11",
     "@sxzz/eslint-config": "^7.8.3",
     "@sxzz/prettier-config": "^2.3.1",
     "@sxzz/test-utils": "^0.5.15",
     "@types/node": "^25.5.0",
+    "@types/picomatch": "^4.0.2",
     "@typescript/native-preview": "7.0.0-dev.20260325.1",
     "@volar/typescript": "^2.4.28",
     "@vue/language-core": "^3.2.6",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/src/generate.ts b/src/generate.ts
@@ -4,6 +4,7 @@ import { readFile, rm } from 'node:fs/promises'
 import path from 'node:path'
 import { parse } from '@babel/parser'
 import { createDebug } from 'obug'
+import picomatch from 'picomatch'
 import { isolatedDeclarationSync } from 'rolldown/experimental'
 import {
   filename_to_dts,
@@ -47,6 +48,7 @@ export interface TsModule {
 export type DtsMap = Map<string, TsModule>
 
 export function createGeneratePlugin({
+  entry,
   tsconfig,
   tsconfigRaw,
   build,
@@ -64,6 +66,7 @@ export function createGeneratePlugin({
   sourcemap,
 }: Pick<
   OptionsResolved,
+  | 'entry'
   | 'cwd'
   | 'tsconfig'
   | 'tsconfigRaw'
@@ -80,6 +83,13 @@ export function createGeneratePlugin({
   | 'emitJs'
   | 'sourcemap'
 >): Plugin {
+  const entryMatcher = entry
+    ? picomatch(entry, {
+        ignore: entry
+          .filter((p: string) => p.startsWith('!'))
+          .map((p: string) => p.slice(1)),
+      })
+    : undefined
   const dtsMap: DtsMap = new Map<string, TsModule>()
 
   /**
@@ -185,7 +195,9 @@ export function createGeneratePlugin({
 
         if (shouldEmit) {
           const mod = this.getModuleInfo(id)
-          const isEntry = !!mod?.isEntry
+          const isEntry = entryMatcher
+            ? entryMatcher(path.relative(cwd, id))
+            : !!mod?.isEntry
           const dtsId = filename_to_dts(id)
           dtsMap.set(dtsId, { code, id, isEntry })
           debug('register dts source: %s', id)
diff --git a/src/options.ts b/src/options.ts
@@ -10,6 +10,21 @@ import type { IsolatedDeclarationsOptions } from 'rolldown/experimental'
 
 //#region General Options
 export interface GeneralOptions {
+  /**
+   * Glob pattern(s) to filter which entry files get `.d.ts` generation.
+   *
+   * When specified, only entry files matching these patterns will emit `.d.ts` chunks.
+   * When not specified, all entries get `.d.ts` generation.
+   *
+   * Supports negation patterns (e.g., `['**', '!src/icons/**']`) for exclusion.
+   * Patterns are matched against file paths relative to `cwd`.
+   *
+   * @example
+   * entry: 'src/index.ts'
+   * entry: ['src/*.ts', '!src/internal/**']
+   */
+  entry?: string | string[]
+
   /**
    * The directory in which the plugin will search for the `tsconfig.json` file.
    */
@@ -224,6 +239,7 @@ type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U
 export type OptionsResolved = Overwrite<
   Required<Omit<Options, 'compilerOptions'>>,
   {
+    entry?: string[]
     tsconfig?: string
     oxc: IsolatedDeclarationsOptions | false
     tsconfigRaw: TsConfigJson
@@ -234,6 +250,7 @@ export type OptionsResolved = Overwrite<
 let warnedTsgo = false
 
 export function resolveOptions({
+  entry,
   cwd = process.cwd(),
   dtsInput = false,
   emitDtsOnly = false,
@@ -340,7 +357,14 @@ export function resolveOptions({
     warnedTsgo = true
   }
 
+  const resolvedEntry = entry
+    ? Array.isArray(entry)
+      ? entry
+      : [entry]
+    : undefined
+
   return {
+    entry: resolvedEntry,
     cwd,
     dtsInput,
     emitDtsOnly,
diff --git a/tests/index.test.ts b/tests/index.test.ts
@@ -70,6 +70,48 @@ test('input alias', async () => {
   expect(snapshot).toMatchSnapshot()
 })
 
+test('entry option - include glob', async () => {
+  const root = path.resolve(dirname, 'fixtures/alias')
+  const { chunks } = await rolldownBuild(
+    {
+      output1: 'input1.ts',
+      'output2/index': 'input2.ts',
+    },
+    [dts({ entry: 'input1.ts', emitDtsOnly: false, cwd: root })],
+    { cwd: root },
+  )
+  const fileNames = chunks.map((chunk) => chunk.fileName).toSorted()
+
+  expect(fileNames).toContain('output1.d.ts')
+  expect(fileNames).toContain('output1.js')
+  expect(fileNames).toContain('output2/index.js')
+  expect(fileNames).not.toContain('output2/index.d.ts')
+})
+
+test('entry option - negation glob', async () => {
+  const root = path.resolve(dirname, 'fixtures/alias')
+  const { chunks } = await rolldownBuild(
+    {
+      output1: 'input1.ts',
+      'output2/index': 'input2.ts',
+    },
+    [
+      dts({
+        entry: ['**/*.ts', '!input2.ts'],
+        emitDtsOnly: false,
+        cwd: root,
+      }),
+    ],
+    { cwd: root },
+  )
+  const fileNames = chunks.map((chunk) => chunk.fileName).toSorted()
+
+  expect(fileNames).toContain('output1.d.ts')
+  expect(fileNames).toContain('output1.js')
+  expect(fileNames).toContain('output2/index.js')
+  expect(fileNames).not.toContain('output2/index.d.ts')
+})
+
 test('isolated declaration error', async () => {
   const error = await rolldownBuild(
     path.resolve(dirname, 'fixtures/isolated-decl-error.ts'),
