d.ts很多字段无法访问了 about layaair

[GuoLei1990]

SHAPEORIENTATION_UPY 是注释错误被隐藏了，已修复a458b25
其它的下划线变量我们是故意不让外部访问 这是ts的一种严谨模式功能"stripInternal": true。如果你想访问任何内部变量，但我们没有提供，可以告知我们，经过权衡会正式公开

[HiKit]

Vector3的UP ZERO等常量希望开放，不然要在项目内定义

[HiKit]

AnimatorControllerLayer希望开放currentPlayState，在一些逻辑下需要取动作原件，比如判断当前动作是否是循环动作，比如切换模型时需要处理动作同步
类似如下：
if (oldAnimator && this._animator) { let state: Laya.AnimatorState = oldAnimator.getControllerLayer(). **_currentPlayState**; let playState: Laya.AnimatorPlayState = oldAnimator.getCurrentAnimatorPlayState(); if (state && playState) { this._animator.play(state.name, 0, playState.normalizedTime); } }

[GuoLei1990]

在 8061ace 提交中公开了当前播放状态机,具体使用方式为 animator.getControllerLayer().getCurrentPlayState().animatorState，统一归类到动画播放状态信息中

[GuoLei1990]

Vector3的UP ZERO屏蔽的原因是因为在JS中无struct概念,vector3为class,公开Vector3.UP是一种极其危险的做法，开发者会经常无意中修改Vector3.UP,导致Vector3.UP值并非（0，1，0），连锁导致所有引用此变量的计算全都崩溃，我们曾收到大量疑似BUG的反馈均由此导致。通常像C#这种有struct概念的语言 我们会将vector3设计为struct，而非class,公开Vector3的UP和ZERO非常安全易用，但在LayaAir中由于我们采用TS（JS）语言，很遗憾，我们不能这么做。

[HiKit]

Vector3的UP ZERO屏蔽的原因是因为在JS中无struct概念,vector3为class,公开Vector3.UP是一种极其危险的做法，开发者会经常无意中修改Vector3.UP,导致Vector3.UP值并非（0，1，0），连锁导致所有引用此变量的计算全都崩溃，我们曾收到大量疑似BUG的反馈均由此导致。通常像C#这种有struct概念的语言 我们会将vector3设计为struct，而非class,公开Vector3的UP和ZERO非常安全易用，但在LayaAir中由于我们采用TS（JS）语言，很遗憾，我们不能这么做。

了解了，这种我项目内自己定义。

[eos3tion]

@GuoLei1990
ts是可以用 Readonly标记，
也可以利用Object.freeze

Vector3.UP = Object.freeze(new Vector3(0,1,0));

把属性锁定，防止修改
我也觉得你们写法并不是最舒服的

[GuoLei1990]

@eos3tion Readonly标记可以防止 Vector3.UP =new Vector3(100,100,100);但无法防止Vector3.UP.x=100,依然会造成Vector3.UP的实际值变化

[eos3tion]

@GuoLei1990 Readonly<T> 这个是可以的，你看下我上面那个对应的链接
https://www.typescriptlang.org/docs/handbook/release-notes/overview.html#improvements-for-readonlyarray-and-readonly-tuples

[GuoLei1990]

@eos3tion 很棒 试了一下 使用 readonly UP: Readonly<Vector3> 确实可以防止Vector3.UP.x=100。但另一个可能更常见的风险还是无法规避。
例如：

var out=Vector3.ZERO;
Vector3.add(a,b,out);

Vector3.add方法内部会对out做修改

不过 Readonly可能会对其它API的设计有帮助

[eos3tion]

@GuoLei1990 这种，tsservice目前没法直接报错，不过用Object.freeze是能强制锁死属性的。这种倒是不怕被误用，修改 Vector3.ZERO的属性

[GuoLei1990]

@eos3tion 目前看功能是可行的,我们需要对Object.freeze的性能进行一下测试,如果没有发现问题，后续可能会应用此方法