@sanity/tsdown-config 0.14.2 → 0.16.0

package/README.md

@@ -132,6 +132,20 @@ export default defineConfig({
 })
 ```
 
+## outDir
+
+tsdown's [`outDir` option](https://tsdown.dev/options/output#outdir) is passed through as-is.
+When left undefined, tsdown writes to `dist` (the same default as `@sanity/pkg-utils`):
+
+```ts
+import {defineConfig} from '@sanity/tsdown-config'
+
+export default defineConfig({
+  tsconfig: 'tsconfig.dist.json',
+  outDir: 'lib',
+})
+```
+
 ## Isolated declarations
 
 If you're using the [`@sanity/tsconfig/isolated-declarations`](https://github.com/sanity-io/pkg-utils/tree/main/packages/%40sanity/tsconfig#isolated-declarations-tsconfigjson)
@@ -178,6 +192,43 @@ export default defineConfig({
 })
 ```
 
+## sourcemap
+
+tsdown's [`sourcemap` option](https://tsdown.dev/options/output#sourcemap) is forwarded with a
+`true` default (the same as `@sanity/pkg-utils`). tsdown itself defaults to `false` and does not
+read `sourceMap` from the tsconfig:
+
+```ts
+import {defineConfig} from '@sanity/tsdown-config'
+
+export default defineConfig({
+  tsconfig: 'tsconfig.dist.json',
+  sourcemap: false,
+})
+```
+
+## deps
+
+tsdown's [`deps` option](https://tsdown.dev/options/dependencies) is forwarded. When `platform` is
+`'neutral'` (the default), `neverBundle` always includes `/^node:/` so node built-ins stay
+external, and userland `neverBundle` entries are appended rather than replacing that default
+(tsdown's `mergeConfig` would replace the array):
+
+```ts
+import {defineConfig} from '@sanity/tsdown-config'
+
+export default defineConfig({
+  tsconfig: 'tsconfig.dist.json',
+  // Resulting neverBundle: [/^node:/, /^my-package(\/|$)/]
+  deps: {neverBundle: [/^my-package(\/|$)/]},
+})
+```
+
+`'neutral'` also restores `inputOptions.resolve.mainFields: ['module', 'main']` for inlined
+dependencies that ship no `exports` map. Prefer it over `'node'` for packages that also run in
+the browser - `'node'` makes CommonJS-interop emit a module-scope
+`createRequire(import.meta.url)` for inlined CJS deps, which crashes browser-bundled consumers.
+
 ## target
 
 tsdown's [`target` option](https://tsdown.dev/options/target) is also passed through as-is. It

package/dist/index.d.mts

@@ -48,9 +48,18 @@ type ReactCompilerOptions = Partial<PluginOptions>;
 /**
  * @public
  */
-interface PackageOptions extends Pick<UserConfig, "tsconfig" | "entry" | "format" | "dts" | "define" | "target"> {
+interface PackageOptions extends Pick<UserConfig, "tsconfig" | "entry" | "format" | "dts" | "define" | "target" | "outDir"> {
   /**
    * @defaultValue 'neutral'
+   *
+   * When left at `'neutral'` (the default), two resolution tweaks compensate for rolldown's
+   * strict neutral defaults: `deps.neverBundle` includes `/^node:/` (node built-ins stay external
+   * so neutral does not warn about them as unresolvable; only node runtimes execute those code
+   * paths), and `inputOptions.resolve.mainFields` falls back to `['module', 'main']` for inlined
+   * dependencies that ship no `exports` map (e.g. `rxjs-etc/operators`). Prefer `'neutral'` over
+   * `'node'` for packages that also run in the browser - `'node'` makes CommonJS-interop emit a
+   * module-scope `createRequire(import.meta.url)` for inlined CJS deps, which crashes
+   * browser-bundled consumers.
    */
   platform?: UserConfig["platform"];
   /**
@@ -68,6 +77,19 @@ interface PackageOptions extends Pick<UserConfig, "tsconfig" | "entry" | "format
    * `{enabled: 'local-only'}` otherwise.
    */
   exports?: UserConfig["exports"];
+  /**
+   * Whether to generate source map files. The same default as the `sourcemap` option in
+   * `@sanity/pkg-utils` - tsdown itself defaults to `false` and does not read `sourceMap` from
+   * the tsconfig.
+   * @defaultValue true
+   */
+  sourcemap?: UserConfig["sourcemap"];
+  /**
+   * tsdown's `deps` option. When `platform` is `'neutral'` (the default), `neverBundle` always
+   * includes `/^node:/` and userland `neverBundle` entries are appended (tsdown's `mergeConfig`
+   * would replace the array). Other `deps` fields pass through as-is.
+   */
+  deps?: UserConfig["deps"];
   /**
    * Runs `babel-plugin-react-compiler` on the source files before they are bundled, so published
    * components are memoized automatically. Pass `true` to use the defaults, or an options object

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;KAmBY,+BAA+B;;;;;UAM1B;;EAEf;;;;;EAKA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA;;EAEA;;;;;;;;;KAUU,uBAAuB,QAAQ;;;;UAK1B,uBAAuB,KACtC;;;;EAMA,WAAW;;;;;;;;;;;;;;;EAeX,UAAU;;;;;;;;;;EAUV,0BAA0B;;;;;;;;EAQ1B,6BAA6B;;;;;;;;;;;EAW7B,2BAA2B;;;;;iBAMP,aAAa,UAAS,iBAAsB,QAAQ"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;KAmBY,+BAA+B;;;;;UAM1B;;EAEf;;;;;EAKA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA;;EAEA;;;;;;;;;KAUU,uBAAuB,QAAQ;;;;UAK1B,uBAAuB,KACtC;;;;;;;;;;;;;EAeA,WAAW;;;;;;;;;;;;;;;EAeX,UAAU;;;;;;;EAOV,YAAY;;;;;;EAMZ,OAAO;;;;;;;;;;EAUP,0BAA0B;;;;;;;;EAQ1B,6BAA6B;;;;;;;;;;;EAW7B,2BAA2B;;;;;iBAMP,aAAa,UAAS,iBAAsB,QAAQ"}

package/dist/index.mjs

@@ -4,9 +4,10 @@ import { defineConfig as defineConfig$1, mergeConfig } from "tsdown";
 * @public
 */
 async function defineConfig(options = {}) {
-	let { entry, tsconfig, dts, define, target } = options, platform = options.platform ?? "neutral", reactCompiler = options.reactCompiler ?? !1, styledComponents = options.styledComponents ?? !1, report = { gzip: !1 }, format = options.format ?? "esm", inputOptions = {
+	let { entry, tsconfig, dts, define, target, outDir } = options, platform = options.platform ?? "neutral", sourcemap = options.sourcemap ?? !0, reactCompiler = options.reactCompiler ?? !1, styledComponents = options.styledComponents ?? !1, report = { gzip: !1 }, format = options.format ?? "esm", inputOptions = {
 		preserveEntrySignatures: "strict",
 		experimental: { attachDebugInfo: "none" },
+		...platform === "neutral" && { resolve: { mainFields: ["module", "main"] } },
 		...styledComponents !== !1 && { transform: { plugins: { styledComponents: {
 			fileName: !1,
 			transpileTemplateLiterals: !1,
@@ -14,6 +15,9 @@ async function defineConfig(options = {}) {
 			cssProp: !1,
 			...typeof styledComponents == "object" ? styledComponents : {}
 		} } } }
+	}, userNeverBundle = options.deps?.neverBundle, nodeBuiltinExternal = platform === "neutral" ? /^node:/ : void 0, neverBundle = userNeverBundle == null ? nodeBuiltinExternal && [nodeBuiltinExternal] : nodeBuiltinExternal == null ? userNeverBundle : typeof userNeverBundle == "function" ? (id, importer, isResolved) => nodeBuiltinExternal.test(id) || userNeverBundle(id, importer, isResolved) : [nodeBuiltinExternal, ...Array.isArray(userNeverBundle) ? userNeverBundle : [userNeverBundle]], deps = options.deps === void 0 && neverBundle === void 0 ? void 0 : {
+		...options.deps,
+		...neverBundle === void 0 ? {} : { neverBundle }
 	}, plugins = [];
 	if (reactCompiler !== !1) {
 		let [{ default: pluginBabel }, { reactCompilerPreset }] = await Promise.all([import("@rolldown/plugin-babel"), import("@vitejs/plugin-react")]);
@@ -32,15 +36,18 @@ async function defineConfig(options = {}) {
 	} }, { exports: options.exports });
 	return defineConfig$1({
 		define,
+		deps,
 		dts,
 		entry,
 		exports,
 		format,
 		inputOptions,
+		outDir,
 		platform,
 		plugins,
 		publint: !0,
 		report,
+		sourcemap,
 		target,
 		tsconfig,
 		minify: {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["defineTsdownConfig"],"sources":["../src/index.ts"],"sourcesContent":["import type {Options as VanillaExtractPluginOptions} from '@sanity/vanilla-extract-tsdown-plugin'\nimport type {PluginOptions as ReactCompilerPluginOptions} from 'babel-plugin-react-compiler'\nimport {detect} from 'package-manager-detector/detect'\nimport {\n  defineConfig as defineTsdownConfig,\n  mergeConfig,\n  type Rolldown,\n  type UserConfig,\n} from 'tsdown'\n\n/**\n * Options for the `vanillaExtract` option — the same options as\n * `@sanity/vanilla-extract-tsdown-plugin` (`identifiers`, `fileName`, `minify`, `target`, and\n * `inject`, all modeled after the `css` options of `@tsdown/css`), with one different default:\n * `inject` defaults to `{nodeCompat: true}` (instead of the plugin's `false`), wiring up the\n * conditional CSS export pattern that Sanity libraries ship with. Set `inject: true` for a plain\n * relative CSS import, or `inject: false` to only extract the CSS.\n * @public\n */\nexport type PackageVanillaExtractOptions = VanillaExtractPluginOptions\n\n/**\n * Options for the `styled-components` transform, the same options as `babel-plugin-styled-components`.\n * @public\n */\nexport interface StyledComponentsOptions {\n  /** @defaultValue true */\n  displayName?: boolean\n  /**\n   * @defaultValue []\n   * @example [\"\\@xstyled/styled-components\", \"\\@xstyled/styled-components/*\"]\n   */\n  topLevelImportPaths?: string[]\n  /** @defaultValue true */\n  ssr?: boolean\n  /** @defaultValue false */\n  fileName?: boolean\n  /** @defaultValue [\"index\"] */\n  meaninglessFileNames?: string[]\n  /** @defaultValue true */\n  minify?: boolean\n  /** @defaultValue false */\n  transpileTemplateLiterals?: boolean\n  namespace?: string\n  /** @defaultValue true */\n  pure?: boolean\n}\n\n/**\n * Options for the React Compiler, the same options as `babel-plugin-react-compiler`.\n * The typings resolve in userland once `babel-plugin-react-compiler` (an optional peer\n * dependency, required to use `reactCompiler`) is installed, and always match the installed\n * version of the compiler.\n * @public\n */\nexport type ReactCompilerOptions = Partial<ReactCompilerPluginOptions>\n\n/**\n * @public\n */\nexport interface PackageOptions extends Pick<\n  UserConfig,\n  'tsconfig' | 'entry' | 'format' | 'dts' | 'define' | 'target'\n> {\n  /**\n   * @defaultValue 'neutral'\n   */\n  platform?: UserConfig['platform']\n  /**\n   * tsdown's `exports` option, with defaults suited for publishing Sanity libraries:\n   * `enabled: 'local-only'` generates the `exports` map during local builds and skips it in CI\n   * (where the committed `package.json` is already up to date). When pnpm is detected,\n   * `devExports: true` also keeps the local `exports` map pointing at source files while\n   * `publishConfig.exports` receives the built files.\n   *\n   * Userland values apply with tsdown's `mergeConfig` semantics: an object deep-merges over\n   * these defaults (so individual fields can be overridden), while any other value - `false`\n   * to disable exports generation, or a bare CI condition (`'ci-only'`/`'local-only'`) -\n   * replaces them entirely.\n   * @defaultValue `{enabled: 'local-only', devExports: true}` for pnpm projects;\n   * `{enabled: 'local-only'}` otherwise.\n   */\n  exports?: UserConfig['exports']\n  /**\n   * Runs `babel-plugin-react-compiler` on the source files before they are bundled, so published\n   * components are memoized automatically. Pass `true` to use the defaults, or an options object\n   * to configure the compiler (e.g. `{target: '18'}`).\n   * This is the same feature as the `babel: {reactCompiler: true}` and `reactCompilerOptions`\n   * options in `@sanity/pkg-utils`. Unlike `styledComponents` there's no oxc native port of the\n   * React Compiler yet, so `babel-plugin-react-compiler` needs to be installed.\n   * @defaultValue false\n   */\n  reactCompiler?: boolean | ReactCompilerOptions\n  /**\n   * Applies the `styled-components` transform (`displayName`, `componentId`, CSS minification, etc)\n   * with the same defaults as the `babel: {styledComponents: true}` option in `@sanity/pkg-utils`.\n   * Unlike `@sanity/pkg-utils` it doesn't use `babel-plugin-styled-components`, but oxc's native port of it,\n   * so there's no need to install babel dependencies.\n   * @defaultValue false\n   */\n  styledComponents?: boolean | StyledComponentsOptions\n  /**\n   * Enables `@sanity/vanilla-extract-tsdown-plugin` to extract CSS into a separate,\n   * `lightningcss`-optimized file. Pass `true` to use the defaults, or an object to customize.\n   *\n   * By default (`inject: {nodeCompat: true}`) the plugin also injects the self-referential\n   * `import \"<pkg>/bundle.css\"`, emits a `bundle.css.js` shim, and writes the conditional\n   * `\"./bundle.css\"` export to `package.json` - see {@link PackageVanillaExtractOptions}.\n   * This is the same feature as `rollup.vanillaExtract` in `@sanity/pkg-utils`.\n   * @alpha\n   */\n  vanillaExtract?: boolean | PackageVanillaExtractOptions\n}\n\n/**\n * @public\n */\nexport async function defineConfig(options: PackageOptions = {}): Promise<UserConfig> {\n  // `tsconfig`, `entry`, `dts`, `define` and `target` are passed through to tsdown as-is. When\n  // left undefined, tsdown keeps its default behavior (`tsconfig` is auto-detected from the\n  // project, `dts` from `package.json`, `define` replaces nothing, and `target` applies no\n  // syntax downleveling).\n  const {entry, tsconfig, dts, define, target} = options\n  const platform = options.platform ?? 'neutral'\n  const reactCompiler = options.reactCompiler ?? false\n  const styledComponents = options.styledComponents ?? false\n  const report = {gzip: false} as const satisfies UserConfig['report']\n  const publint = true\n  const format = options.format ?? 'esm'\n  const inputOptions = {\n    // https://github.com/rolldown/rolldown/blob/main/packages/rolldown/src/options/docs/preserve-entry-signatures.md#strict\n    preserveEntrySignatures: 'strict',\n    experimental: {attachDebugInfo: 'none'},\n    ...(styledComponents !== false && {\n      transform: {\n        plugins: {\n          styledComponents: {\n            // The same defaults as `babel: {styledComponents: true}` in `@sanity/pkg-utils`:\n            // `fileName` is unnecessary, as the way we use styled-components in Sanity is usually by wrapping\n            // `@sanity/ui` primitives, not declaring new ones like \"const Button = styled.button``\"\n            fileName: false,\n            // Native template literals take less space than this transpilation, and unlike\n            // `babel-plugin-styled-components`, oxc doesn't add a `@__PURE__` annotation to the\n            // transpiled call expression either, so enabling it wouldn't improve tree-shaking\n            transpileTemplateLiterals: false,\n            // Helps dead code elimination and tree-shaking, although oxc only annotates plain call\n            // expressions so far, not tagged template expressions (https://github.com/rollup/rollup/issues/4035)\n            pure: true,\n            // Disabled, as tsdown tends to be used for npm publishing, while other tooling,\n            // like `sanity dev`, `next dev`, etc are used for testing\n            cssProp: false,\n            ...(typeof styledComponents === 'object' ? styledComponents : {}),\n          },\n        },\n      },\n    }),\n  } as const satisfies UserConfig['inputOptions']\n\n  // `outputOptions` is left to tsdown's defaults - notably chunk filenames keep tsdown's hashed\n  // default (unless userland sets `hash`), which prevents chunk/entry filename collisions\n  // (https://github.com/sanity-io/ui/issues/2262).\n  const plugins: Rolldown.Plugin[] = []\n  if (reactCompiler !== false) {\n    // Follows the official tsdown recipe for the React Compiler:\n    // https://tsdown.dev/recipes/react-support#enabling-react-compiler\n    // The plugins are lazy loaded so they're only paid for when the React Compiler is enabled.\n    // `babel-plugin-react-compiler` itself is resolved by Babel from the consumer package during\n    // the build, which is why it can be an optional peer dependency. Once rolldown ships its rust\n    // port of the React Compiler this can be swapped out for an oxc transform, like `styledComponents`.\n    const [{default: pluginBabel}, {reactCompilerPreset}] = await Promise.all([\n      import('@rolldown/plugin-babel'),\n      import('@vitejs/plugin-react'),\n    ])\n    plugins.push(\n      await pluginBabel({\n        presets: [reactCompilerPreset(typeof reactCompiler === 'object' ? reactCompiler : {})],\n      }),\n    )\n  }\n  if (options.vanillaExtract) {\n    // Lazy loaded, like `reactCompiler`, so the CSS toolchain is only paid for when the option is\n    // enabled. The plugin compiles the `.css.ts` files and extracts the CSS into a single\n    // `lightningcss`-optimized file. Its `inject` option is general purpose (and, like\n    // `css.inject` in `@tsdown/css`, disabled by default), so this config supplies the default\n    // most Sanity libraries want: `{nodeCompat: true}` wires up the whole conditional CSS export\n    // pattern - the self-referential CSS import, the no-op JS shim, and the conditional\n    // `./<fileName>` export written through this config's `exports` option (which the plugin's\n    // `tsdownConfig` hook composes into).\n    const {vanillaExtractPlugin} = await import('@sanity/vanilla-extract-tsdown-plugin')\n    plugins.push(\n      vanillaExtractPlugin({\n        inject: {nodeCompat: true},\n        ...(options.vanillaExtract === true ? {} : options.vanillaExtract),\n      }),\n    )\n  }\n\n  const packageManager = await detect({cwd: process.cwd()})\n  // tsdown's `exports` feature is enabled with Sanity-flavored defaults, and userland values\n  // apply with tsdown's own `mergeConfig` semantics: an object deep-merges over the defaults,\n  // anything else (`false`, a CI condition) replaces them.\n  const {exports} = mergeConfig(\n    {\n      exports: {\n        enabled: 'local-only',\n        // Only opt in by default when pnpm is detected: support for replacing package fields\n        // from `publishConfig` is not reliable across package managers.\n        ...(packageManager?.name === 'pnpm' && {devExports: true}),\n      },\n    },\n    {exports: options.exports},\n  )\n\n  return defineTsdownConfig({\n    define,\n    dts,\n    entry,\n    exports,\n    format,\n    inputOptions,\n    platform,\n    plugins,\n    publint,\n    report,\n    target,\n    tsconfig,\n    minify: {compress: true, codegen: false, mangle: false},\n  })\n}\n"],"mappings":";;;;;AAqHA,eAAsB,aAAa,UAA0B,CAAC,GAAwB;CAKpF,IAAM,EAAC,OAAO,UAAU,KAAK,QAAQ,WAAU,SACzC,WAAW,QAAQ,YAAY,WAC/B,gBAAgB,QAAQ,iBAAiB,IACzC,mBAAmB,QAAQ,oBAAoB,IAC/C,SAAS,EAAC,MAAM,GAAK,GAErB,SAAS,QAAQ,UAAU,OAC3B,eAAe;EAEnB,yBAAyB;EACzB,cAAc,EAAC,iBAAiB,OAAM;EACtC,GAAI,qBAAqB,MAAS,EAChC,WAAW,EACT,SAAS,EACP,kBAAkB;GAIhB,UAAU;GAIV,2BAA2B;GAG3B,MAAM;GAGN,SAAS;GACT,GAAI,OAAO,oBAAqB,WAAW,mBAAmB,CAAC;EACjE,EACF,EACF,EACF;CACF,GAKM,UAA6B,CAAC;CACpC,IAAI,kBAAkB,IAAO;EAO3B,IAAM,CAAC,EAAC,SAAS,eAAc,EAAC,yBAAwB,MAAM,QAAQ,IAAI,CACxE,OAAO,2BACP,OAAO,uBACT,CAAC;EACD,QAAQ,KACN,MAAM,YAAY,EAChB,SAAS,CAAC,oBAAoB,OAAO,iBAAkB,WAAW,gBAAgB,CAAC,CAAC,CAAC,EACvF,CAAC,CACH;CACF;CACA,IAAI,QAAQ,gBAAgB;EAS1B,IAAM,EAAC,yBAAwB,MAAM,OAAO;EAC5C,QAAQ,KACN,qBAAqB;GACnB,QAAQ,EAAC,YAAY,GAAI;GACzB,GAAI,QAAQ,mBAAmB,KAAO,CAAC,IAAI,QAAQ;EACrD,CAAC,CACH;CACF;CAMA,IAAM,EAAC,YAAW,YAChB,EACE,SAAS;EACP,SAAS;EAGT,IAAI,MAVmB,OAAO,EAAC,KAAK,QAAQ,IAAI,EAAC,CAAC,EAAA,EAU9B,SAAS,UAAU,EAAC,YAAY,GAAI;CAC1D,EACF,GACA,EAAC,SAAS,QAAQ,QAAO,CAC3B;CAEA,OAAOA,eAAmB;EACxB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;GAAC,UAAU;GAAM,SAAS;GAAO,QAAQ;EAAK;CACxD,CAAC;AACH"}
+{"version":3,"file":"index.mjs","names":["defineTsdownConfig"],"sources":["../src/index.ts"],"sourcesContent":["import type {Options as VanillaExtractPluginOptions} from '@sanity/vanilla-extract-tsdown-plugin'\nimport type {PluginOptions as ReactCompilerPluginOptions} from 'babel-plugin-react-compiler'\nimport {detect} from 'package-manager-detector/detect'\nimport {\n  defineConfig as defineTsdownConfig,\n  mergeConfig,\n  type Rolldown,\n  type UserConfig,\n} from 'tsdown'\n\n/**\n * Options for the `vanillaExtract` option — the same options as\n * `@sanity/vanilla-extract-tsdown-plugin` (`identifiers`, `fileName`, `minify`, `target`, and\n * `inject`, all modeled after the `css` options of `@tsdown/css`), with one different default:\n * `inject` defaults to `{nodeCompat: true}` (instead of the plugin's `false`), wiring up the\n * conditional CSS export pattern that Sanity libraries ship with. Set `inject: true` for a plain\n * relative CSS import, or `inject: false` to only extract the CSS.\n * @public\n */\nexport type PackageVanillaExtractOptions = VanillaExtractPluginOptions\n\n/**\n * Options for the `styled-components` transform, the same options as `babel-plugin-styled-components`.\n * @public\n */\nexport interface StyledComponentsOptions {\n  /** @defaultValue true */\n  displayName?: boolean\n  /**\n   * @defaultValue []\n   * @example [\"\\@xstyled/styled-components\", \"\\@xstyled/styled-components/*\"]\n   */\n  topLevelImportPaths?: string[]\n  /** @defaultValue true */\n  ssr?: boolean\n  /** @defaultValue false */\n  fileName?: boolean\n  /** @defaultValue [\"index\"] */\n  meaninglessFileNames?: string[]\n  /** @defaultValue true */\n  minify?: boolean\n  /** @defaultValue false */\n  transpileTemplateLiterals?: boolean\n  namespace?: string\n  /** @defaultValue true */\n  pure?: boolean\n}\n\n/**\n * Options for the React Compiler, the same options as `babel-plugin-react-compiler`.\n * The typings resolve in userland once `babel-plugin-react-compiler` (an optional peer\n * dependency, required to use `reactCompiler`) is installed, and always match the installed\n * version of the compiler.\n * @public\n */\nexport type ReactCompilerOptions = Partial<ReactCompilerPluginOptions>\n\n/**\n * @public\n */\nexport interface PackageOptions extends Pick<\n  UserConfig,\n  'tsconfig' | 'entry' | 'format' | 'dts' | 'define' | 'target' | 'outDir'\n> {\n  /**\n   * @defaultValue 'neutral'\n   *\n   * When left at `'neutral'` (the default), two resolution tweaks compensate for rolldown's\n   * strict neutral defaults: `deps.neverBundle` includes `/^node:/` (node built-ins stay external\n   * so neutral does not warn about them as unresolvable; only node runtimes execute those code\n   * paths), and `inputOptions.resolve.mainFields` falls back to `['module', 'main']` for inlined\n   * dependencies that ship no `exports` map (e.g. `rxjs-etc/operators`). Prefer `'neutral'` over\n   * `'node'` for packages that also run in the browser - `'node'` makes CommonJS-interop emit a\n   * module-scope `createRequire(import.meta.url)` for inlined CJS deps, which crashes\n   * browser-bundled consumers.\n   */\n  platform?: UserConfig['platform']\n  /**\n   * tsdown's `exports` option, with defaults suited for publishing Sanity libraries:\n   * `enabled: 'local-only'` generates the `exports` map during local builds and skips it in CI\n   * (where the committed `package.json` is already up to date). When pnpm is detected,\n   * `devExports: true` also keeps the local `exports` map pointing at source files while\n   * `publishConfig.exports` receives the built files.\n   *\n   * Userland values apply with tsdown's `mergeConfig` semantics: an object deep-merges over\n   * these defaults (so individual fields can be overridden), while any other value - `false`\n   * to disable exports generation, or a bare CI condition (`'ci-only'`/`'local-only'`) -\n   * replaces them entirely.\n   * @defaultValue `{enabled: 'local-only', devExports: true}` for pnpm projects;\n   * `{enabled: 'local-only'}` otherwise.\n   */\n  exports?: UserConfig['exports']\n  /**\n   * Whether to generate source map files. The same default as the `sourcemap` option in\n   * `@sanity/pkg-utils` - tsdown itself defaults to `false` and does not read `sourceMap` from\n   * the tsconfig.\n   * @defaultValue true\n   */\n  sourcemap?: UserConfig['sourcemap']\n  /**\n   * tsdown's `deps` option. When `platform` is `'neutral'` (the default), `neverBundle` always\n   * includes `/^node:/` and userland `neverBundle` entries are appended (tsdown's `mergeConfig`\n   * would replace the array). Other `deps` fields pass through as-is.\n   */\n  deps?: UserConfig['deps']\n  /**\n   * Runs `babel-plugin-react-compiler` on the source files before they are bundled, so published\n   * components are memoized automatically. Pass `true` to use the defaults, or an options object\n   * to configure the compiler (e.g. `{target: '18'}`).\n   * This is the same feature as the `babel: {reactCompiler: true}` and `reactCompilerOptions`\n   * options in `@sanity/pkg-utils`. Unlike `styledComponents` there's no oxc native port of the\n   * React Compiler yet, so `babel-plugin-react-compiler` needs to be installed.\n   * @defaultValue false\n   */\n  reactCompiler?: boolean | ReactCompilerOptions\n  /**\n   * Applies the `styled-components` transform (`displayName`, `componentId`, CSS minification, etc)\n   * with the same defaults as the `babel: {styledComponents: true}` option in `@sanity/pkg-utils`.\n   * Unlike `@sanity/pkg-utils` it doesn't use `babel-plugin-styled-components`, but oxc's native port of it,\n   * so there's no need to install babel dependencies.\n   * @defaultValue false\n   */\n  styledComponents?: boolean | StyledComponentsOptions\n  /**\n   * Enables `@sanity/vanilla-extract-tsdown-plugin` to extract CSS into a separate,\n   * `lightningcss`-optimized file. Pass `true` to use the defaults, or an object to customize.\n   *\n   * By default (`inject: {nodeCompat: true}`) the plugin also injects the self-referential\n   * `import \"<pkg>/bundle.css\"`, emits a `bundle.css.js` shim, and writes the conditional\n   * `\"./bundle.css\"` export to `package.json` - see {@link PackageVanillaExtractOptions}.\n   * This is the same feature as `rollup.vanillaExtract` in `@sanity/pkg-utils`.\n   * @alpha\n   */\n  vanillaExtract?: boolean | PackageVanillaExtractOptions\n}\n\n/**\n * @public\n */\nexport async function defineConfig(options: PackageOptions = {}): Promise<UserConfig> {\n  // `tsconfig`, `entry`, `dts`, `define`, `target` and `outDir` are passed through to tsdown\n  // as-is. When left undefined, tsdown keeps its default behavior (`tsconfig` is auto-detected\n  // from the project, `dts` from `package.json`, `define` replaces nothing, `target` applies no\n  // syntax downleveling, and `outDir` defaults to `'dist'`).\n  const {entry, tsconfig, dts, define, target, outDir} = options\n  const platform = options.platform ?? 'neutral'\n  const sourcemap = options.sourcemap ?? true\n  const reactCompiler = options.reactCompiler ?? false\n  const styledComponents = options.styledComponents ?? false\n  const report = {gzip: false} as const satisfies UserConfig['report']\n  const publint = true\n  const format = options.format ?? 'esm'\n  // When `platform` is `'neutral'`, restore the conventional `module`/`main` fallback that\n  // rolldown's strict neutral defaults drop - needed for inlined deps without an `exports` map.\n  const inputOptions = {\n    // https://github.com/rolldown/rolldown/blob/main/packages/rolldown/src/options/docs/preserve-entry-signatures.md#strict\n    preserveEntrySignatures: 'strict',\n    experimental: {attachDebugInfo: 'none'},\n    ...(platform === 'neutral' && {\n      resolve: {mainFields: ['module', 'main']},\n    }),\n    ...(styledComponents !== false && {\n      transform: {\n        plugins: {\n          styledComponents: {\n            // The same defaults as `babel: {styledComponents: true}` in `@sanity/pkg-utils`:\n            // `fileName` is unnecessary, as the way we use styled-components in Sanity is usually by wrapping\n            // `@sanity/ui` primitives, not declaring new ones like \"const Button = styled.button``\"\n            fileName: false,\n            // Native template literals take less space than this transpilation, and unlike\n            // `babel-plugin-styled-components`, oxc doesn't add a `@__PURE__` annotation to the\n            // transpiled call expression either, so enabling it wouldn't improve tree-shaking\n            transpileTemplateLiterals: false,\n            // Helps dead code elimination and tree-shaking, although oxc only annotates plain call\n            // expressions so far, not tagged template expressions (https://github.com/rollup/rollup/issues/4035)\n            pure: true,\n            // Disabled, as tsdown tends to be used for npm publishing, while other tooling,\n            // like `sanity dev`, `next dev`, etc are used for testing\n            cssProp: false,\n            ...(typeof styledComponents === 'object' ? styledComponents : {}),\n          },\n        },\n      },\n    }),\n  } satisfies UserConfig['inputOptions']\n\n  // `neverBundle` is concatenated (not `mergeConfig`'d) so per-package externals add to the\n  // `/^node:/` default for `platform: 'neutral'` instead of replacing it. Rolldown's\n  // `ExternalOption` array form is `Array<string | RegExp>` only; a function override is composed.\n  const userNeverBundle = options.deps?.neverBundle\n  const nodeBuiltinExternal = platform === 'neutral' ? /^node:/ : undefined\n  const neverBundle: NonNullable<UserConfig['deps']>['neverBundle'] =\n    userNeverBundle == null\n      ? nodeBuiltinExternal && [nodeBuiltinExternal]\n      : nodeBuiltinExternal == null\n        ? userNeverBundle\n        : typeof userNeverBundle === 'function'\n          ? (id, importer, isResolved) =>\n              nodeBuiltinExternal.test(id) || userNeverBundle(id, importer, isResolved)\n          : [\n              nodeBuiltinExternal,\n              ...(Array.isArray(userNeverBundle) ? userNeverBundle : [userNeverBundle]),\n            ]\n  const deps: UserConfig['deps'] =\n    options.deps === undefined && neverBundle === undefined\n      ? undefined\n      : {\n          ...options.deps,\n          ...(neverBundle === undefined ? {} : {neverBundle}),\n        }\n\n  // `outputOptions` is left to tsdown's defaults - notably chunk filenames keep tsdown's hashed\n  // default (unless userland sets `hash`), which prevents chunk/entry filename collisions\n  // (https://github.com/sanity-io/ui/issues/2262).\n  const plugins: Rolldown.Plugin[] = []\n  if (reactCompiler !== false) {\n    // Follows the official tsdown recipe for the React Compiler:\n    // https://tsdown.dev/recipes/react-support#enabling-react-compiler\n    // The plugins are lazy loaded so they're only paid for when the React Compiler is enabled.\n    // `babel-plugin-react-compiler` itself is resolved by Babel from the consumer package during\n    // the build, which is why it can be an optional peer dependency. Once rolldown ships its rust\n    // port of the React Compiler this can be swapped out for an oxc transform, like `styledComponents`.\n    const [{default: pluginBabel}, {reactCompilerPreset}] = await Promise.all([\n      import('@rolldown/plugin-babel'),\n      import('@vitejs/plugin-react'),\n    ])\n    plugins.push(\n      await pluginBabel({\n        presets: [reactCompilerPreset(typeof reactCompiler === 'object' ? reactCompiler : {})],\n      }),\n    )\n  }\n  if (options.vanillaExtract) {\n    // Lazy loaded, like `reactCompiler`, so the CSS toolchain is only paid for when the option is\n    // enabled. The plugin compiles the `.css.ts` files and extracts the CSS into a single\n    // `lightningcss`-optimized file. Its `inject` option is general purpose (and, like\n    // `css.inject` in `@tsdown/css`, disabled by default), so this config supplies the default\n    // most Sanity libraries want: `{nodeCompat: true}` wires up the whole conditional CSS export\n    // pattern - the self-referential CSS import, the no-op JS shim, and the conditional\n    // `./<fileName>` export written through this config's `exports` option (which the plugin's\n    // `tsdownConfig` hook composes into).\n    const {vanillaExtractPlugin} = await import('@sanity/vanilla-extract-tsdown-plugin')\n    plugins.push(\n      vanillaExtractPlugin({\n        inject: {nodeCompat: true},\n        ...(options.vanillaExtract === true ? {} : options.vanillaExtract),\n      }),\n    )\n  }\n\n  const packageManager = await detect({cwd: process.cwd()})\n  // tsdown's `exports` feature is enabled with Sanity-flavored defaults, and userland values\n  // apply with tsdown's own `mergeConfig` semantics: an object deep-merges over the defaults,\n  // anything else (`false`, a CI condition) replaces them.\n  const {exports} = mergeConfig(\n    {\n      exports: {\n        enabled: 'local-only',\n        // Only opt in by default when pnpm is detected: support for replacing package fields\n        // from `publishConfig` is not reliable across package managers.\n        ...(packageManager?.name === 'pnpm' && {devExports: true}),\n      },\n    },\n    {exports: options.exports},\n  )\n\n  return defineTsdownConfig({\n    define,\n    deps,\n    dts,\n    entry,\n    exports,\n    format,\n    inputOptions,\n    outDir,\n    platform,\n    plugins,\n    publint,\n    report,\n    sourcemap,\n    target,\n    tsconfig,\n    minify: {compress: true, codegen: false, mangle: false},\n  })\n}\n"],"mappings":";;;;;AA2IA,eAAsB,aAAa,UAA0B,CAAC,GAAwB;CAKpF,IAAM,EAAC,OAAO,UAAU,KAAK,QAAQ,QAAQ,WAAU,SACjD,WAAW,QAAQ,YAAY,WAC/B,YAAY,QAAQ,aAAa,IACjC,gBAAgB,QAAQ,iBAAiB,IACzC,mBAAmB,QAAQ,oBAAoB,IAC/C,SAAS,EAAC,MAAM,GAAK,GAErB,SAAS,QAAQ,UAAU,OAG3B,eAAe;EAEnB,yBAAyB;EACzB,cAAc,EAAC,iBAAiB,OAAM;EACtC,GAAI,aAAa,aAAa,EAC5B,SAAS,EAAC,YAAY,CAAC,UAAU,MAAM,EAAC,EAC1C;EACA,GAAI,qBAAqB,MAAS,EAChC,WAAW,EACT,SAAS,EACP,kBAAkB;GAIhB,UAAU;GAIV,2BAA2B;GAG3B,MAAM;GAGN,SAAS;GACT,GAAI,OAAO,oBAAqB,WAAW,mBAAmB,CAAC;EACjE,EACF,EACF,EACF;CACF,GAKM,kBAAkB,QAAQ,MAAM,aAChC,sBAAsB,aAAa,YAAY,WAAW,KAAA,GAC1D,cACJ,mBAAmB,OACf,uBAAuB,CAAC,mBAAmB,IAC3C,uBAAuB,OACrB,kBACA,OAAO,mBAAoB,cACxB,IAAI,UAAU,eACb,oBAAoB,KAAK,EAAE,KAAK,gBAAgB,IAAI,UAAU,UAAU,IAC1E,CACE,qBACA,GAAI,MAAM,QAAQ,eAAe,IAAI,kBAAkB,CAAC,eAAe,CACzE,GACJ,OACJ,QAAQ,SAAS,KAAA,KAAa,gBAAgB,KAAA,IAC1C,KAAA,IACA;EACE,GAAG,QAAQ;EACX,GAAI,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAC,YAAW;CACnD,GAKA,UAA6B,CAAC;CACpC,IAAI,kBAAkB,IAAO;EAO3B,IAAM,CAAC,EAAC,SAAS,eAAc,EAAC,yBAAwB,MAAM,QAAQ,IAAI,CACxE,OAAO,2BACP,OAAO,uBACT,CAAC;EACD,QAAQ,KACN,MAAM,YAAY,EAChB,SAAS,CAAC,oBAAoB,OAAO,iBAAkB,WAAW,gBAAgB,CAAC,CAAC,CAAC,EACvF,CAAC,CACH;CACF;CACA,IAAI,QAAQ,gBAAgB;EAS1B,IAAM,EAAC,yBAAwB,MAAM,OAAO;EAC5C,QAAQ,KACN,qBAAqB;GACnB,QAAQ,EAAC,YAAY,GAAI;GACzB,GAAI,QAAQ,mBAAmB,KAAO,CAAC,IAAI,QAAQ;EACrD,CAAC,CACH;CACF;CAMA,IAAM,EAAC,YAAW,YAChB,EACE,SAAS;EACP,SAAS;EAGT,IAAI,MAVmB,OAAO,EAAC,KAAK,QAAQ,IAAI,EAAC,CAAC,EAAA,EAU9B,SAAS,UAAU,EAAC,YAAY,GAAI;CAC1D,EACF,GACA,EAAC,SAAS,QAAQ,QAAO,CAC3B;CAEA,OAAOA,eAAmB;EACxB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;GAAC,UAAU;GAAM,SAAS;GAAO,QAAQ;EAAK;CACxD,CAAC;AACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/tsdown-config",
-  "version": "0.14.2",
+  "version": "0.16.0",
   "description": "Shared configuration for tsdown",
   "keywords": [
     "sanity-io",
@@ -40,16 +40,16 @@
     "@vitejs/plugin-react": "^6.0.3",
     "package-manager-detector": "^1.7.0",
     "publint": "^0.3.21",
-    "@sanity/vanilla-extract-tsdown-plugin": "^0.1.1"
+    "@sanity/vanilla-extract-tsdown-plugin": "^0.1.2"
   },
   "devDependencies": {
     "@types/babel__core": "^7.20.5",
     "babel-plugin-react-compiler": "^1.0.0",
     "tinyexec": "^1.2.4",
-    "tsdown": "^0.22.7",
+    "tsdown": "^0.22.8",
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
-    "@sanity/pkg-utils": "^11.0.3",
+    "@sanity/pkg-utils": "^11.0.4",
     "@sanity/tsconfig": "^2.2.0"
   },
   "peerDependencies": {