@sanity/tsdown-config 0.7.3 → 0.9.0

package/README.md

@@ -11,3 +11,59 @@ import {defineConfig} from '@sanity/tsdown-config'
 
 export default defineConfig({tsconfig: 'tsconfig.dist.json'})
 ```
+
+## React Compiler
+
+The same React Compiler feature as `@sanity/pkg-utils` is available. It runs
+[`babel-plugin-react-compiler`](https://react.dev/learn/react-compiler) on the source files before
+they are bundled, so published components are memoized automatically. The plugin needs to be
+installed separately:
+
+```sh
+pnpm add --save-dev babel-plugin-react-compiler
+```
+
+Then enable it:
+
+```ts
+import {defineConfig} from '@sanity/tsdown-config'
+
+export default defineConfig({
+  tsconfig: 'tsconfig.dist.json',
+  reactCompiler: true,
+})
+```
+
+Pass an object to configure the compiler, using the same options as [`babel-plugin-react-compiler`](https://react.dev/reference/react-compiler/configuration):
+
+```ts
+export default defineConfig({
+  tsconfig: 'tsconfig.dist.json',
+  reactCompiler: {target: '18'},
+})
+```
+
+## styled-components
+
+If your package uses `styled-components`, enable the same `styledComponents` transform that `@sanity/pkg-utils` has:
+
+```ts
+import {defineConfig} from '@sanity/tsdown-config'
+
+export default defineConfig({
+  tsconfig: 'tsconfig.dist.json',
+  styledComponents: true,
+})
+```
+
+It adds `displayName` (better debugging) and `componentId` (avoids SSR hydration mismatches) to your styled components, and minifies the CSS in tagged template literals.
+Unlike `@sanity/pkg-utils` it doesn't require installing `babel-plugin-styled-components`, as it uses [oxc's native port](https://oxc.rs/docs/guide/usage/transformer/plugins.html#styled-components) of the babel plugin.
+
+Pass an object to customize the transform, using the same options as [`babel-plugin-styled-components`](https://styled-components.com/docs/tooling#babel-plugin):
+
+```ts
+export default defineConfig({
+  tsconfig: 'tsconfig.dist.json',
+  styledComponents: {namespace: 'my-package'},
+})
+```

package/dist/index.d.mts

@@ -1,4 +1,39 @@
 import { UserConfig } from "tsdown";
+import { PluginOptions } from "babel-plugin-react-compiler";
+/**
+* Options for the `styled-components` transform, the same options as `babel-plugin-styled-components`.
+* @public
+*/
+interface StyledComponentsOptions {
+  /** @defaultValue true */
+  displayName?: boolean;
+  /**
+  * @defaultValue []
+  * @example ["\@xstyled/styled-components", "\@xstyled/styled-components/*"]
+  */
+  topLevelImportPaths?: string[];
+  /** @defaultValue true */
+  ssr?: boolean;
+  /** @defaultValue false */
+  fileName?: boolean;
+  /** @defaultValue ["index"] */
+  meaninglessFileNames?: string[];
+  /** @defaultValue true */
+  minify?: boolean;
+  /** @defaultValue false */
+  transpileTemplateLiterals?: boolean;
+  namespace?: string;
+  /** @defaultValue true */
+  pure?: boolean;
+}
+/**
+* Options for the React Compiler, the same options as `babel-plugin-react-compiler`.
+* The typings resolve in userland once `babel-plugin-react-compiler` (an optional peer
+* dependency, required to use `reactCompiler`) is installed, and always match the installed
+* version of the compiler.
+* @public
+*/
+type ReactCompilerOptions = Partial<PluginOptions>;
 /**
 * @public
 */
@@ -7,10 +42,28 @@ interface PackageOptions extends Pick<UserConfig, "tsconfig" | "entry" | "format
   * @defaultValue 'neutral'
   */
   platform?: UserConfig["platform"];
+  /**
+  * 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
+  * to configure the compiler (e.g. `{target: '18'}`).
+  * This is the same feature as the `babel: {reactCompiler: true}` and `reactCompilerOptions`
+  * options in `@sanity/pkg-utils`. Unlike `styledComponents` there's no oxc native port of the
+  * React Compiler yet, so `babel-plugin-react-compiler` needs to be installed.
+  * @defaultValue false
+  */
+  reactCompiler?: boolean | ReactCompilerOptions;
+  /**
+  * Applies the `styled-components` transform (`displayName`, `componentId`, CSS minification, etc)
+  * with the same defaults as the `babel: {styledComponents: true}` option in `@sanity/pkg-utils`.
+  * Unlike `@sanity/pkg-utils` it doesn't use `babel-plugin-styled-components`, but oxc's native port of it,
+  * so there's no need to install babel dependencies.
+  * @defaultValue false
+  */
+  styledComponents?: boolean | StyledComponentsOptions;
 }
 /**
 * @public
 */
-declare function defineConfig(options?: PackageOptions): UserConfig;
-export { PackageOptions, defineConfig };
+declare function defineConfig(options?: PackageOptions): Promise<UserConfig>;
+export { PackageOptions, ReactCompilerOptions, StyledComponentsOptions, defineConfig };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;AAKA;;UAAiB,cAAA,SAAuB,IAAA,CAAK,UAAA;;;;EAI3C,QAAA,GAAW,UAAA;AAAA;;;;iBAMG,YAAA,CAAa,OAAA,GAAS,cAAA,GAAsB,UAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;AAOA;;;UAAiB,uBAAA;;EAEf,WAAA;;;;;EAKA,mBAAA;;EAEA,GAAA;EAWA;EATA,QAAA;EAmBF;EAjBE,oBAAA;;EAEA,MAAA;EAeyC;EAbzC,yBAAA;EACA,SAAA;;EAEA,IAAA;AAAA;;;;;;;;KAUU,oBAAA,GAAuB,OAAA,CAAQ,aAAA;;;;UAK1B,cAAA,SAAuB,IAAA,CAAK,UAAA;;;AAsBd;EAlB7B,QAAA,GAAW,UAAA;EAwBS;;;;;;;;;EAdpB,aAAA,aAA0B,oBAAA;;;AAc8C;;;;;EANxE,gBAAA,aAA6B,uBAAA;AAAA;;;;iBAMT,YAAA,CAAa,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,UAAA"}

package/dist/index.mjs

@@ -2,24 +2,36 @@ import { defineConfig as defineConfig$1 } from "tsdown";
 /**
 * @public
 */
-function defineConfig(options = {}) {
-	let { entry } = options, tsconfig = options.tsconfig ?? "tsconfig.json", platform = options.platform ?? "neutral";
+async function defineConfig(options = {}) {
+	let { entry } = options, tsconfig = options.tsconfig ?? "tsconfig.json", platform = options.platform ?? "neutral", reactCompiler = options.reactCompiler ?? !1, styledComponents = options.styledComponents ?? !1, report = { gzip: !1 }, format = options.format ?? "esm", inputOptions = {
+		preserveEntrySignatures: "strict",
+		experimental: { attachDebugInfo: "none" },
+		...styledComponents !== !1 && { transform: { plugins: { styledComponents: {
+			fileName: !1,
+			transpileTemplateLiterals: !1,
+			pure: !0,
+			cssProp: !1,
+			...typeof styledComponents == "object" ? styledComponents : {}
+		} } } }
+	}, outputOptions = { hoistTransitiveImports: !1 }, exports = {
+		enabled: "local-only",
+		devExports: !0
+	}, plugins = [];
+	if (reactCompiler !== !1) {
+		let [{ default: pluginBabel }, { reactCompilerPreset }] = await Promise.all([import("@rolldown/plugin-babel"), import("@vitejs/plugin-react")]);
+		plugins.push(await pluginBabel({ presets: [reactCompilerPreset(typeof reactCompiler == "object" ? reactCompiler : {})] }));
+	}
 	return defineConfig$1({
 		entry,
-		exports: {
-			enabled: "local-only",
-			devExports: !0
-		},
-		format: options.format ?? "esm",
+		exports,
+		format,
 		hash: !1,
-		inputOptions: {
-			preserveEntrySignatures: "strict",
-			experimental: { attachDebugInfo: "none" }
-		},
-		outputOptions: { hoistTransitiveImports: !1 },
+		inputOptions,
+		outputOptions,
 		platform,
+		plugins,
 		publint: !0,
-		report: { gzip: !1 },
+		report,
 		tsconfig,
 		minify: {
 			compress: !0,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["defineTsdownConfig"],"sources":["../src/index.ts"],"sourcesContent":["import {defineConfig as defineTsdownConfig, type UserConfig} from 'tsdown'\n\n/**\n * @public\n */\nexport interface PackageOptions extends Pick<UserConfig, 'tsconfig' | 'entry' | 'format'> {\n  /**\n   * @defaultValue 'neutral'\n   */\n  platform?: UserConfig['platform']\n}\n\n/**\n * @public\n */\nexport function defineConfig(options: PackageOptions = {}): UserConfig {\n  const {entry} = options\n  const tsconfig = options.tsconfig ?? 'tsconfig.json'\n  const platform = options.platform ?? 'neutral'\n  const report = {gzip: false} as const satisfies UserConfig['report']\n  const publint = true\n  const hash = false\n  const format = options.format ?? 'esm'\n  const inputOptions = {\n    preserveEntrySignatures: 'strict',\n    experimental: {attachDebugInfo: 'none'},\n  } as const satisfies UserConfig['inputOptions']\n  const outputOptions = {\n    hoistTransitiveImports: false,\n  } as const satisfies UserConfig['outputOptions']\n  const exports = {\n    enabled: 'local-only',\n    // @TODO use @sanity/parse-package-json to determine if devExports should be `true` or `source`\n    devExports: true,\n  } as const satisfies UserConfig['exports']\n\n  return defineTsdownConfig({\n    entry,\n    exports,\n    format,\n    hash,\n    inputOptions,\n    outputOptions,\n    platform,\n    publint,\n    report,\n    tsconfig,\n    minify: {compress: true, codegen: false, mangle: false},\n    // Rely on tsdown's/rolldown's default tree-shaking (`moduleSideEffects: true`) rather than\n    // customizing it. Previously this set the equivalent of `moduleSideEffects: 'no-external'`\n    // (with a `.css` exemption), which stripped intentional side-effect-only imports of external\n    // packages (e.g. `import 'react-time-ago/locale/en'`) from the output. The default preserves\n    // those imports while still honoring `package.json` `sideEffects` fields for bundled modules.\n  })\n}\n"],"mappings":";;;;AAeA,SAAgB,aAAa,UAA0B,CAAC,GAAe;CACrE,IAAM,EAAC,UAAS,SACV,WAAW,QAAQ,YAAY,iBAC/B,WAAW,QAAQ,YAAY;CAkBrC,OAAOA,eAAmB;EACxB;EACA,SAAA;GAPA,SAAS;GAET,YAAY;EAKN;EACN,QAjBa,QAAQ,UAAU;EAkB/B,MAAA;EACA,cAAA;GAjBA,yBAAyB;GACzB,cAAc,EAAC,iBAAiB,OAAM;EAgB3B;EACX,eAAA,EAdA,wBAAwB,GAcZ;EACZ;EACA,SAAA;EACA,QAAA,EA1Bc,MAAM,GA0Bf;EACL;EACA,QAAQ;GAAC,UAAU;GAAM,SAAS;GAAO,QAAQ;EAAK;CAMxD,CAAC;AACH"}
+{"version":3,"file":"index.mjs","names":["defineTsdownConfig"],"sources":["../src/index.ts"],"sourcesContent":["import type {PluginOptions as ReactCompilerPluginOptions} from 'babel-plugin-react-compiler'\nimport {defineConfig as defineTsdownConfig, type Rolldown, type UserConfig} from 'tsdown'\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<UserConfig, 'tsconfig' | 'entry' | 'format'> {\n  /**\n   * @defaultValue 'neutral'\n   */\n  platform?: UserConfig['platform']\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\n/**\n * @public\n */\nexport async function defineConfig(options: PackageOptions = {}): Promise<UserConfig> {\n  const {entry} = options\n  const tsconfig = options.tsconfig ?? 'tsconfig.json'\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 hash = false\n  const format = options.format ?? 'esm'\n  const inputOptions = {\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  const outputOptions = {\n    hoistTransitiveImports: false,\n  } as const satisfies UserConfig['outputOptions']\n  const exports = {\n    enabled: 'local-only',\n    // @TODO use @sanity/parse-package-json to determine if devExports should be `true` or `source`\n    devExports: true,\n  } as const satisfies UserConfig['exports']\n\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      // The plugin types don't match when `@rolldown/plugin-babel` resolves its `rolldown` peer\n      // dependency to a different version than the one bundled with `tsdown`, so cast it:\n      // https://tsdown.dev/advanced/plugins#rollup-plugins\n      // oxlint-disable-next-line no-unsafe-type-assertion\n      (await pluginBabel({\n        presets: [reactCompilerPreset(typeof reactCompiler === 'object' ? reactCompiler : {})],\n      })) as unknown as Rolldown.Plugin,\n    )\n  }\n\n  return defineTsdownConfig({\n    entry,\n    exports,\n    format,\n    hash,\n    inputOptions,\n    outputOptions,\n    platform,\n    plugins,\n    publint,\n    report,\n    tsconfig,\n    minify: {compress: true, codegen: false, mangle: false},\n    // Rely on tsdown's/rolldown's default tree-shaking (`moduleSideEffects: true`) rather than\n    // customizing it. Previously this set the equivalent of `moduleSideEffects: 'no-external'`\n    // (with a `.css` exemption), which stripped intentional side-effect-only imports of external\n    // packages (e.g. `import 'react-time-ago/locale/en'`) from the output. The default preserves\n    // those imports while still honoring `package.json` `sideEffects` fields for bundled modules.\n  })\n}\n"],"mappings":";;;;AAsEA,eAAsB,aAAa,UAA0B,CAAC,GAAwB;CACpF,IAAM,EAAC,UAAS,SACV,WAAW,QAAQ,YAAY,iBAC/B,WAAW,QAAQ,YAAY,WAC/B,gBAAgB,QAAQ,iBAAiB,IACzC,mBAAmB,QAAQ,oBAAoB,IAC/C,SAAS,EAAC,MAAM,GAAK,GAGrB,SAAS,QAAQ,UAAU,OAC3B,eAAe;EACnB,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,GACM,gBAAgB,EACpB,wBAAwB,GAC1B,GACM,UAAU;EACd,SAAS;EAET,YAAY;CACd,GAEM,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,KAKL,MAAM,YAAY,EACjB,SAAS,CAAC,oBAAoB,OAAO,iBAAkB,WAAW,gBAAgB,CAAC,CAAC,CAAC,EACvF,CAAC,CACH;CACF;CAEA,OAAOA,eAAmB;EACxB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;GAAC,UAAU;GAAM,SAAS;GAAO,QAAQ;EAAK;CAMxD,CAAC;AACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/tsdown-config",
-  "version": "0.7.3",
+  "version": "0.9.0",
   "description": "Shared configuration for tsdown",
   "keywords": [
     "sanity-io",
@@ -35,21 +35,32 @@
     "dist"
   ],
   "dependencies": {
+    "@babel/core": "^7.29.7",
+    "@rolldown/plugin-babel": "^0.2.3",
+    "@vitejs/plugin-react": "^6.0.3",
     "publint": "^0.3.21"
   },
   "devDependencies": {
+    "@types/babel__core": "^7.20.5",
     "@typescript/native-preview": "7.0.0-dev.20260421.2",
+    "babel-plugin-react-compiler": "^1.0.0",
     "tinyexec": "^1.2.4",
     "tsdown": "^0.22.3",
     "typescript": "6.0.3",
     "vitest": "^4.1.9",
-    "@sanity/tsconfig": "^2.1.0",
-    "@sanity/pkg-utils": "^10.8.2"
+    "@sanity/pkg-utils": "^10.9.0",
+    "@sanity/tsconfig": "^2.1.0"
   },
   "peerDependencies": {
+    "babel-plugin-react-compiler": "*",
     "tsdown": "0.22.x",
     "typescript": "5.8.x || 5.9.x || 6.0.x"
   },
+  "peerDependenciesMeta": {
+    "babel-plugin-react-compiler": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=20.19 <22 || >=22.12"
   },