使用别名而不是相对路径创建的 Typescript 声明文件

Question

编辑 1：将 GitHub URL 添加到项目

编辑 2：从 tsconfig.json 中删除 baseUrl 修复了所有问题，使用相对导入工作正常。

如何使用相对路径而不是 alias 生成打字稿声明文件？

我正在UMD 模式下创建一个库(samplelibrary) 并在npm 中发布它。打包的 npm 库只有 build 文件夹（带类型），package.json 和 README.md

当我尝试在另一个打字稿应用程序中使用该库时，由于生成的类型声明文件无效，构建失败。类型声明文件包含别名而不是相对路径。

编译日志：

ERROR in /workspace/myproject/node_modules/samplelibrary/build/typings/src/foo.d.ts(403,17): TS2307: Cannot find module 'utils/bar

如何解决这个问题？

实际创建的声明文件foo.d.ts:

declare const Foo: {
   bar: typeof import("utils/bar");
}

预期文件：

declare const Foo: {
   bar: typeof import("./utils/bar");
}

tsconfig.json

{
  "compilerOptions": {
    "target": "es5",
    "module": "esnext",
    "moduleResolution": "node",
    "jsx": "react",
    "sourceMap": true,
    "rootDir": "./",
    "baseUrl": "./src",
    "paths": {
      "@samplecompany/sampleproject": ["./"]
    },
    "outDir": "build",
    "removeComments": true,
    "noImplicitAny": true,
    "noImplicitReturns": true,
    "noImplicitThis": true,
    "strictNullChecks": true,
    "declaration": true,
    "declarationDir": "typings",
    "importHelpers": true
  },
  "files": ["types/untyped-modules.d.ts"],
  "include": [
    "src/**/*",
    "test/**/*",
    "build/**/*",
    "styleguide-renderer/**/*"
  ],
  "exclude": ["node_modules"]
}

文件夹结构：

root
  -src
    -utils
       -bar.ts
    -foo.ts

utils/bar.ts

export const bar = {
   hello: "World"
}

src/foo.ts

import { bar } from "./utils/bar.ts

export default const Foo = {
    bar
};

Answer 1

你真倒霉：TypeScript 不会重写导入路径。参见 this declined suggestion。您需要避免在库中使用别名，除非您也在使用项目中配置别名。

Answer 2

要解决此问题，

从您的打字稿配置中删除 baseUrl 用法。
在您的项目中仅使用相对导入，例如 ../somefile、./somefolder/file 等，

已修复here

Answer 3

好吧，如果没有重大的诡计，它似乎就无法工作，但最终，我想通了。所以问题是需要重写类型声明路径。为此，您需要一些 bundler/compiler 来为您完成。我想有很多包可以为基于 tsc 的编译做这件事，但在我的例子中，我使用的是 Rollup，所以没有那么多。好吧，我只找到了一个 https://github.com/zerkalica/zerollup/tree/master/packages/ts-transform-paths

那里有帮助您使用它的说明。但基本上你需要做的是：

安装yarn add -D @zerollup/ts-transform-paths ttypescript
将其添加到您的 rollup.config.js
使用 "plugins": [{ "transform": "@zerollup/ts-transform-paths" }]

tsconfig.json

现在我的路径从 @react 重写为 "../../react/file"。耶！

为了更好的衡量，这里是我的配置：

{
  "compilerOptions": {
    "target": "es6",
    "lib": ["dom", "dom.iterable", "esnext"],
    "allowJs": true,
    "declaration": true,
    "declarationDir": "./dist",
    "skipLibCheck": true,
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "strict": true,
    "forceConsistentCasingInFileNames": true,
    "module": "esnext",
    "moduleResolution": "node",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": true,
    "jsx": "react",
    "baseUrl": ".",
    "paths": {
      "@context/*": ["src/context/*"],
      "@pm/*": ["src/pm/*"],
      "@react/*": ["src/react/*"],
      "@typings/*": ["src/typings/*"]
    },
    "plugins": [{ "transform": "@zerollup/ts-transform-paths" }]
  },
  "include": ["src"],
  "exclude": ["node_modules"]
}

import alias from '@rollup/plugin-alias'
import typescript from 'rollup-plugin-typescript2'
import postcss from 'rollup-plugin-postcss'
import ttypescript from 'ttypescript'

import path from 'path'

import pkg from './package.json'

export default {
  input: 'src/index.ts',
  output: [
    {
      file: pkg.main,
      format: 'cjs',
    },
    {
      file: pkg.module,
      format: 'es',
    },
  ],
  external: [
    ...Object.keys(pkg.peerDependencies || {}),
  ],
  plugins: [
    alias({
      entries: [
        { find: '@context', replacement: path.resolve(__dirname, 'src/context') },
        { find: '@pm', replacement: path.resolve(__dirname, 'src/pm') },
        { find: '@react', replacement: path.resolve(__dirname, 'src/react') },
        { find: '@typings', replacement: path.resolve(__dirname, 'src/typings') },
      ]
    }),
    typescript({
      typescript: ttypescript
    }),
    postcss()
  ],
}

使用别名而不是相对路径创建的 Typescript 声明文件

Typescript declaration file created with alias instead of relative path

typescript

reactjs

tsconfig

ts-loader

typescript-typings