docs: notifyDimensionsChange 文档更新

Author: mackwang112

.agents/skills/mpx2rn/references/rn-script-reference.md

@@ -587,13 +587,13 @@ setAppHide()
 | `getCurrentPages()` | 返回当前导航栈中已映射的页面实例列表（顺序与路由 state 相关）。 |
 | `setAppShow()` | 手动触发应用「进入前台」逻辑，驱动已注册的 `onShow`。 |
 | `setAppHide()` | 手动触发应用「进入后台」逻辑，驱动已注册的 `onHide`。 |
-| `notifyDimensionsChange(dimensions?)` | 主动通知框架 dimensions 发生变化，触发 rpx、vw、vh、媒体查询、onResize 等的重新计算。在某些容器环境下（如折叠屏、分屏）系统 `Dimensions` 事件无法正常触发时使用。不传参时默认使用当前全局 dimensions 并重新执行 `customDimensions`。 |
+| `notifyDimensionsChange(dimensions?)` | 主动通知框架 dimensions 发生变化，触发 rpx、vw、vh、媒体查询、onResize 等的重新计算。不传参时默认使用当前屏幕 dimensions 并重新执行 `customDimensions`。 |
 
 #### 注意事项
 
 - 勿在 App 构造函数执行完成前依赖 `getApp()` 内业务字段已赋值完毕；与路由相关的初始化宜放在 `onLaunch` / `onShow`。
 - `getCurrentPages()` 依赖 React Navigation 焦点与 `__mpxPagesMap`，与原生小程序栈细节不完全相同。
-- `notifyDimensionsChange` 由框架在首次样式计算时自动注入，可在业务代码任意位置调用。
+- `notifyDimensionsChange` 由框架在首次样式计算时自动注入，需在开始渲染后才可调用。
 
 ---
 

packages/core/@types/global.d.ts

@@ -15,14 +15,4 @@ declare module '*?resolve' {
 declare let setAppShow: () => void
 declare let setAppHide: () => void
 
-/**
- * 主动通知框架 dimensions 发生变化，触发 rpx、vw、vh、媒体查询、onResize 等的重新计算。
- *
- * 框架默认已监听 `Dimensions.addEventListener('change', ...)` 自动处理，
- * 在某些容器环境下（如折叠屏、分屏）系统事件无法正常触发时，可手动调用此方法驱动更新。
- *
- * 不传参时默认使用当前全局 dimensions。
- *
- * @param dimensions 包含 window 和 screen 的尺寸信息，不传则使用当前全局 dimensions
- */
 declare let notifyDimensionsChange: (dimensions?: { window: import('react-native').ScaledSize; screen: import('react-native').ScaledSize }) => void