如何将依赖包的ambient声明归入命名空间，以Engine.xxx形式调用？

你需要把依赖包的全局方法封装到Engine对象下，同时避免手动重复所有类型声明，这里有几个实用方案：

1. 动态挂载+自动类型推导 #

直接在你的模块里创建Engine对象，把全局方法挂载上去，用TypeScript的typeof自动继承原类型：

// engine.ts
export const Engine = {
  emit: globalThis.emit as typeof emit,
  TriggerEvent: globalThis.TriggerEvent as typeof TriggerEvent
};

要是方法太多不想一个个写，可以用动态遍历的方式（注意运行时要确认全局方法存在）：

// 批量挂载示例
const methodNames = ['emit', 'TriggerEvent', /* 其他所有方法名 */] as const;
const Engine = {} as {
  [K in typeof methodNames[number]]: typeof globalThis[K];
};

methodNames.forEach(name => {
  Engine[name] = globalThis[name];
});

export { Engine };

这样使用者只能通过Engine.emit调用，类型提示和原全局声明完全一致，不用手动写任何类型。

2. 类型提取+Pick筛选 #

如果只想导出部分方法，可以先提取全局所有函数类型，再用Pick筛选需要的：

// 提取全局所有函数类型
type GlobalFunctions = {
  [K in keyof typeof globalThis]: typeof globalThis[K] extends Function ? typeof globalThis[K] : never;
};

// 只导出需要的方法
export const Engine: Pick<GlobalFunctions, 'emit' | 'TriggerEvent'> = {
  emit: globalThis.emit,
  TriggerEvent: globalThis.TriggerEvent
};

这种方式适合需要严格控制导出方法列表的场景，类型自动同步，不用手动维护。

3. 隐藏全局声明+声明合并 #

如果想彻底禁止使用者直接调用全局方法，可以在你的包的类型声明里做处理：

1. 编写index.d.ts，把方法合并到Engine命名空间：

// index.d.ts
declare namespace Engine {
  export function emit(eventName: string, ...args: any[]): void;
  export function TriggerEvent(eventName: string, ...args: any[]): void;
}

export { Engine };

2. 运行时文件里实现Engine：

// index.js
export const Engine = {
  emit: emit,
  TriggerEvent: TriggerEvent
};

然后在你的包的package.json里把types字段指向这个index.d.ts，同时确保使用者的tsconfig.json不会直接引入依赖包的全局类型（比如只引入你的包的类型）。这样使用者的代码里直接写emit会报错，必须用Engine.emit。

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