rsbuild-plugin-arethetypeswrong

Rsbuild plugin for checking TypeScript type definitions with arethetypeswrong.

rsbuild-plugin-arethetypeswrong is the perfect partner for Rslib. When building a library, arethetypeswrong helps you to analyze TypeScript types of the package to improve its compatibility with different module resolutions.

Usage

Install:

npm add rsbuild-plugin-arethetypeswrong -D

Add plugin to your rslib.config.ts or rsbuild.config.ts:

import { pluginAreTheTypesWrong } from "rsbuild-plugin-arethetypeswrong";

export default {
  plugins: [pluginAreTheTypesWrong()],
};

Options

enable

Whether to enable arethetypeswrong.

• Type: boolean
• Default: true

For example, only run arethetypeswrong in the CI environment:

pluginAreTheTypesWrong({
  enable: Boolean(process.env.CI),
});

areTheTypesWrongOptions

Options for arethetypeswrong. See arethetypeswrong - Configuration for more details.

• Type:

interface areTheTypesWrongOptions {
  ignoreRules?: ProblemFlag[];
  ignoreResolutions?: ResolutionKind[];
  summary?: boolean;
  emoji?: boolean;
}

type ProblemFlag =
  | "no-resolution"
  | "untyped-resolution"
  | "false-cjs"
  | "false-esm"
  | "cjs-resolves-to-esm"
  | "fallback-condition"
  | "cjs-only-exports-default"
  | "named-exports"
  | "false-export-default"
  | "missing-export-equals"
  | "unexpected-module-syntax"
  | "internal-resolution-error";

type ResolutionKind = "node10" | "node16-cjs" | "node16-esm" | "bundler";

• Default:

const defaultOptions = {
  ignoreRules: [];
  ignoreResolutions: [];
  summary: true;
  emoji: true;
};

• Example:

pluginAreTheTypesWrong({
  areTheTypesWrongOptions: {
    ignoreRules: ["false-cjs"],
    ignoreResolutions: ["node16-cjs"],
  },
});

Credits

Thanks to:

• arethetypeswrong for making this possible.
• rsbuild-plugin-publint for the idea of linting as an Rsbuild plugin.

License

MIT.