feat: experimental isolated declaration support

[pi0]

Add experimental support for isolated declaration generation powered by OXC and unplugin-isolated-decl by @sxzz ❤️

Read more: microsoft/TypeScript#58944

To opt in:

import { defineBuildConfig } from "unbuild";

export default defineBuildConfig({
  rollup: {
    // https://github.com/microsoft/TypeScript/issues/58944
    // https://github.com/unplugin/unplugin-isolated-decl
    isolatedDecl: {
      transformer: "oxc",
    },
  },
});

Tips for migrating the codebase to be ready for isolated declaration support:

• ts-fix might help. (you can try with npx @pi0/[email protected] -w - see Publish on NPM for easier installation microsoft/ts-fix#29)
• Using @typescript-eslint/explicit-function-return-type is helpful to find all issues (refactor: add explicit return types #412)
• Using transformer: "typescript" might help to find issues easier. Default oxc sometimes is crypted about which line.

TODO

Currently plugin generates types to dist/src/**.{mts,cts}. We need to find a way to merge them or at least generate top level declaration in dist/*.{mts,dts} to make it cleaner for package.json exports and avoid requirement of updating it. Also the paths seem relative to root in tsconfig rather than dist!