使用dts-bundle合并Pixi.js类型定义后子类无法继承父类方法

我正在使用TypeScript和Pixi.js开发类库，构建时会生成所有*.d.ts文件，并通过dts-bundle将这些文件合并为单个index.d.ts文件，合并后的代码如下：

// Generated by dts-bundle v0.7.3
// Dependencies for this module:
/// <reference path="../pixi.js" />

declare module LIB{

    import { Container } from "pixi.js";

    export class BaseContainer extends Container{
        constructor();
    }

}

在类库内部可正常使用Pixi.js及其所有模块，但将该index.d.ts引入其他项目后，虽能识别BaseContainer并创建实例，但调用addChild等继承自Container的方法时，编译器报错：

Property 'addChild' does not exist on type 'BaseContainer'.

我尝试调整dts-bundle配置与tsconfig相关属性，但问题仍未解决，请问哪里操作出错了？

问题根源在于模块引用方式冲突和dts-bundle老旧版本的类型处理缺陷：

1. 三斜线引用与ES模块导入混合导致类型关联失败
   合并后的文件同时使用了/// <reference path="../pixi.js" />和ES模块import，这会让TypeScript无法正确解析Container的完整原型链。其他项目引入后，无法识别BaseContainer继承的addChild等方法类型。

2. dts-bundle v0.7.3对ES模块支持不足
   这个版本的dts-bundle是较旧的工具，处理ES模块下的类继承时，容易丢失父类的类型信息，导致子类只保留自身定义，没有继承父类的方法。

具体修复步骤： #

• 清理冲突的引用方式
  删除合并后index.d.ts中的三斜线引用，只保留ES模块导入：

  // Generated by dts-bundle v0.7.3
  declare module LIB {
      import { Container } from "pixi.js";
  
      export class BaseContainer extends Container {
          constructor();
      }
  }
  

• 替换为现代类型合并工具
  弃用dts-bundle，改用@microsoft/api-extractor或rollup-plugin-dts，这两个工具对TypeScript的模块系统和类型继承支持更完善，能准确保留父类的所有类型信息。
• 校准类库的tsconfig配置
  在类库的tsconfig.json中确保核心配置正确：

  {
      "compilerOptions": {
          "declaration": true,
          "module": "ESNext",
          "target": "ES6",
          "esModuleInterop": true,
          "skipLibCheck": true,
          "strict": true
      }
  }
  

• 确保依赖正确安装
  在引入类库的项目中，必须将pixi.js安装为生产依赖（而非开发依赖），确保TypeScript能正确找到Container的类型定义。

内容的提问来源于stack exchange，提问作者Romiar