如何解决@contra/date包中dayjs扩展接口类型不被消费方识别的问题？

1. 入口文件显式导入插件类型声明 #

在你的包入口文件（比如index.ts）中，除了初始化dayjs和插件，还要显式导入插件的类型声明文件，这样消费项目导入你的包时，TypeScript会自动合并插件对Dayjs接口的扩展：

// @contra/date/index.ts
import dayjs from 'dayjs';
import relativeTime from 'dayjs/plugin/relativeTime';
// 显式导入插件的类型声明，触发TypeScript合并接口扩展
import 'dayjs/plugin/relativeTime';

dayjs.extend(relativeTime);

// 导出dayjs实例及所需类型
export default dayjs;
export type { Dayjs, Duration } from 'dayjs';

2. 自定义类型声明文件合并扩展 #

如果你的包需要单独维护类型声明，可创建index.d.ts文件，通过导入插件类型来自动合并接口，无需重复编写扩展代码：

// @contra/date/index.d.ts
import dayjs from 'dayjs';
// 导入插件类型，让TypeScript识别Dayjs的扩展方法
import 'dayjs/plugin/relativeTime';

// 无需重复声明扩展，TypeScript会自动合并插件的接口定义
export default dayjs;
export type { Dayjs, Duration } from 'dayjs';

然后在package.json中指定类型入口：

{
  "types": "index.d.ts"
}

3. 确保类型文件被正确发布 #

检查package.json的files字段，确保编译后的类型文件（包括通过导入引入的插件类型相关内容）被包含在发布包中；同时确认tsconfig.json的include字段覆盖了必要的类型文件，避免编译时丢失扩展定义。

核心原理 #

dayjs插件的类型声明本身已经通过模块扩展（declare module 'dayjs'）为Dayjs接口添加了from/fromNow/to/toNow方法，问题在于消费项目没有自动加载这些扩展声明。通过在你的包入口或类型文件中显式导入插件类型，就能让TypeScript在处理你的包时自动合并这些扩展，无需重复编写接口定义。

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