feat!: defaults transform to typescript

Due to the incomplete support of jsdoc in `oxc-transform`, using native TypeScript can achieve optimal speed.

Therefore, this change will set `typescript` as the default transformer.

Author: sxzz

package.json

@@ -79,20 +79,23 @@
   },
   "peerDependencies": {
     "@swc/core": "^1.6.6",
+    "oxc-transform": "^0.28.0",
     "typescript": "^5.5.2"
   },
   "peerDependenciesMeta": {
     "@swc/core": {
       "optional": true
     },
+    "oxc-transform": {
+      "optional": true
+    },
     "typescript": {
       "optional": true
     }
   },
   "dependencies": {
     "@rollup/pluginutils": "^5.1.0",
     "oxc-parser": "^0.27.0",
-    "oxc-transform": "^0.27.0",
     "unplugin": "^1.14.0"
   },
   "devDependencies": {
@@ -104,6 +107,7 @@
     "esbuild": "^0.23.1",
     "eslint": "^9.10.0",
     "fast-glob": "^3.3.2",
+    "oxc-transform": "^0.27.0",
     "prettier": "^3.3.3",
     "rolldown": "nightly",
     "rollup": "^4.21.2",

pnpm-lock.yaml

@@ -11,14 +11,15 @@ export type Options = {
 } & (
   | {
       /**
-       * `@swc/core` should be installed yourself if you want to use `swc` transformer.
+       * `oxc-transform` or `@swc/core` should be installed yourself
+       * if you want to use `oxc` or `swc` transformer.
        */
       transformer?: 'oxc' | 'swc'
     }
   | {
       /**
        * `typescript` should be installed yourself.
-       * @default oxc
+       * @default 'typescript'
        */
       transformer: 'typescript'
       /** Only for typescript transformer */
@@ -38,7 +39,7 @@ export function resolveOptions(options: Options): OptionsResolved {
     include: options.include || [/\.[cm]?ts$/],
     exclude: options.exclude || [/node_modules/],
     enforce: 'enforce' in options ? options.enforce : 'pre',
-    transformer: options.transformer || 'oxc',
+    transformer: options.transformer || 'typescript',
     ignoreErrors: options.ignoreErrors || false,
     extraOutdir: options.extraOutdir,
   }

src/core/options.ts

@@ -5,22 +5,36 @@ export interface TransformResult {
   errors: Array<string>
 }
 
+function tryImport<T>(pkg: string): Promise<T | null> {
+  try {
+    return import(pkg)
+  } catch {
+    return Promise.resolve(null)
+  }
+}
+
 export async function oxcTransform(
   id: string,
   code: string,
 ): Promise<TransformResult> {
-  const { isolatedDeclaration } = await import('oxc-transform')
-  return isolatedDeclaration(id, code, { sourcemap: false })
+  const oxc = await tryImport<typeof import('oxc-transform')>('oxc-transform')
+  if (!oxc) {
+    return {
+      code: '',
+      errors: [
+        'oxc-transform is required for transforming TypeScript, please install `oxc-transform`.',
+      ],
+    }
+  }
+  return oxc.isolatedDeclaration(id, code, { sourcemap: false })
 }
 
 export async function swcTransform(
   id: string,
   code: string,
 ): Promise<TransformResult> {
-  let swc: typeof import('@swc/core')
-  try {
-    swc = await import('@swc/core')
-  } catch {
+  const swc = await tryImport<typeof import('@swc/core')>('@swc/core')
+  if (!swc) {
     return {
       code: '',
       errors: [
@@ -61,11 +75,8 @@ export async function tsTransform(
   code: string,
   transformOptions?: TranspileOptions,
 ): Promise<TransformResult> {
-  let ts: typeof import('typescript')
-
-  try {
-    ts = await import('typescript')
-  } catch {
+  const ts = await tryImport<typeof import('typescript')>('typescript')
+  if (!ts) {
     return {
       code: '',
       errors: [

src/core/transformer.ts

@@ -14,7 +14,7 @@ export {
 };
 ",
   "// temp/main.d.ts
-import { type Num } from "./types";
+import { type Num } from './types';
 export type Str = string;
 export declare function hello(s: Str): Str;
 export declare let num: Num;
@@ -30,7 +30,7 @@ export type Num2 = number;
 
 exports[`esbuild > write mode 1`] = `
 [
-  "import { type Num } from "./types";
+  "import { type Num } from './types';
 export type Str = string;
 export declare function hello(s: Str): Str;
 export declare let num: Num;

tests/__snapshots__/esbuild.test.ts.snap

@@ -11,7 +11,7 @@ let num = 1;
 export { hello, num };
 ",
   "// temp/main.d.ts
-import { type Num } from "./types";
+import { type Num } from './types';
 export type Str = string;
 export declare function hello(s: Str): Str;
 export declare let num: Num;

tests/__snapshots__/rollup.test.ts.snap

@@ -9,7 +9,12 @@ test('rolldown', async () => {
 
   const bundle = await rolldown({
     input,
-    plugins: [UnpluginIsolatedDecl({ extraOutdir: 'temp' })],
+    plugins: [
+      UnpluginIsolatedDecl({
+        extraOutdir: 'temp',
+        transformer: 'oxc',
+      }),
+    ],
     logLevel: 'silent',
   })