核心更新日志

1.5.2 2025-12-23

修复

修复导出版本号与实际版本号不同步的问题

1.5.1 2025-12-23

修复

修复依赖引入的问题

1.5.0 2025-12-23

特性

新增 PopupRoot 组件，用于同步应用上下文，彻底解决独立渲染弹出层无法共享应用上下文的问题。
render() 函数新增 placement 参数，默认居中 center ，用于指定弹出层的位置。
createPopup() 函数新增 logHandler 参数，用于自定义日志打印函数。
调试模式自动开启详细日志输出，方便开发者调试。
use() 插件注册函数开启风险校验，针对未定义作者 author 参数的插件将会在调试模式下打印警告日志，提示开发者注意插件风险。
use() 插件注册函数开启对核心版本的校验，针对校验失败的插件将会在调试模式下打印错误日志，并且阻止该插件的注册。
新增导出 Log 、 LogType 、 printLog 等工具 API ，用于插件开发者提供插件日志输出。
新增导出 LogGroupItemType 、 LogGroupItem 等工具类型，用于插件开发者提供插件日志分组输出。
新增导出 Version 类型，用于插件开发者使用该类型进行版本适配和维护。
新增导出 TypeScript 工具类型 ExtractComponentPropTypes<T>，用于从组件类型中提取属性类型。

优化

render() 函数的 componentProps 参数支持自动推导渲染组件的属性类型，提供更好的开发体验。
优化遮罩层在不同主题下的渲染效果。
移除冗余代码和依赖。

1.4.0 2025-11-20

特性

definePlugin 方法支持自定义插件 注册选项，会自动在调用 use() 函数注册插件时提供对应的参数选项类型推断，为插件使用者提供更好的使用体验。

优化

提供更完整的类型定义，提升开发体验。
提供更详细的代码注释，方便开发者理解和使用。

1.3.4 2025-11-08

修复

修复 debugMode 模式下无法正常销毁弹出层根节点的问题。
修复渲染参数 maxWidth 和 maxHeight 无法正确生效的问题。

1.3.3 2025-11-08

优化

优化遮罩层的渲染效果。

1.3.2 2025-11-07

优化

优化弹出层在亮色主题下，遮罩层的渲染效果。

1.3.1 2025-11-07

修复

修复渲染参数 viewAnimation 偶现无法正确触发动画的问题。

1.3.0 2025-11-05

特性

支持暗色主题。
遮罩层支持高斯模糊，默认开启，提供配置项 maskBlur 用于关闭高斯模糊。
支持每个弹出层独立设置禁用滚动条

破坏性改动

DANGER

优化部分渲染参数名称。

1.2.1 2025-10-31

特性

插件创建选项支持 debugMode 模式，开启后会在Vue devtools 中显示弹出层组件信息，方便开发调试。

性能提升

优化弹出层的渲染性能，默认使用 VNode 渲染，仅在 debugMode 模式下使用独立 app 实例渲染，方便调试。

1.2.0 2025-10-29

特性

新增插件创建选项 autoDisableScroll ，用于自动禁用滚动条。

适配

适配 vue 3.5.22 版本，提供更好的兼容性和性能。

修复

修复类型导出问题，确保在使用时能够正确获取到类型定义。

1.1.5 2025-10-28

修复

修复类型导出问题，确保在使用时能够正确获取到类型定义。

1.1.4 2025-10-28

修复

修复类型导出问题，确保在使用时能够正确获取到类型定义。

1.1.3 2025-10-28

修复

修复类型导出问题，确保在使用时能够正确获取到类型定义。

1.1.2 2025-10-28

修复

修复核心的控制器默认挂载 Vue 实例的类型声明问题，提供完善的类型定义。

1.1.1 2025-10-28

修复

修复类型导出问题，确保在使用时能够正确获取到类型定义。

1.1.0 2025-10-27

特性

新增控制器实例 render() 函数的渲染参数 viewTranslateX 、 viewTranslateY ，用于控制弹出层的位移。
新增控制器实例 update() 函数，用于更新弹出层的渲染参数。

代码重构

重构插件系统，提供更高的可扩展性。
重构动画系统，提升流畅度，提供更多配置项。

1.0.0 2025-10-27

特性

从 vue-popup 成功迁移到 vue 3 版本