@feng3d/reactivity 1.0.8 → 1.0.11

package/LICENSE

@@ -1,21 +1,15 @@
-MIT License
-
-Copyright (c) 2019 feng
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT 许可证
+
+版权所有 (c) 2026 feng
+
+特此授予任何获得本软件及相关文档文件（"软件"）副本的人免费许可，
+可以不受限制地处理本软件，包括但不限于使用、复制、修改、合并、
+发布、分发、再许可和/或销售本软件的副本，并允许向其提供本软件的
+人这样做，但须符合以下条件：
+
+上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。
+
+本软件按"原样"提供，不提供任何明示或暗示的保证，包括但不限于对
+适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权
+持有人均不对因本软件或本软件的使用或其他交易而产生的任何索赔、
+损害或其他责任负责，无论是在合同诉讼、侵权诉讼还是其他诉讼中。

package/README.md

@@ -1,159 +1,159 @@
-# @feng3d/reactivity
-
-feng3d的响应式库，使用方式以及API与@vue/reactivity基本保持一致。
-
-源码：https://gitee.com/feng3d/reactivity
-
-文档：https://feng3d.com/reactivity
-
-## 网站
-
-https://feng3d.com/reactivity
-
-## 安装
-```
-npm install @feng3d/reactivity
-```
-
-## 快速开始
-
-```ts
-import { ref, computed } from "@feng3d/reactivity";
-
-const a = ref(1);
-const b = ref(2);
-const c = computed(() => a.value + b.value);
-
-console.log(c.value); // 3
-a.value = 3;
-console.log(c.value); // 5
-```
-
-## 缘由
-在feng3d引擎中使用`@vue/reactivity`代替`@feng3d/watcher`来维护数据驱动功能时发现性能严重下降。
-
-为了解决这个问题，我重新实现了一个响应式库，并且在性能上进行了优化。
-
-### 问题示例
-
-示例： https://feng3d.com/reactivity/#复杂情况取值
-
-| 运行库 | 性能(ms) | 速度(x) |
-| --- | --- | --- |
-| @feng3d/reactivity | 2.8 | 286 |
-| @vue/reactivity | 801 | 1 |
-
-### 测试代码
-```ts
-复杂情况取值(ref, computed, 10000);
-
-export function 复杂情况取值(ref: <T>(value?: T) => { value: T }, computed: <T>(func: (oldValue?: T) => T) => { readonly value: T }, count: number)
-{
-    const result = { time: undefined, values: [] };
-
-    const b = ref(2);
-
-    function 递归(depth = 10)
-    {
-        if (depth <= 0) return computed(() =>
-        {
-            return b.value
-        }).value;
-
-        return computed(() =>
-        {
-            return 递归(depth - 1) + 递归(depth - 2);
-        }).value;
-    }
-
-    const cb = computed(() =>
-    {
-        return 递归(16);
-    });
-
-    b.value++;
-    cb.value;
-
-    const start = performance.now();
-    for (let i = 0; i < count; i++)
-    {
-        ref(1).value++; // 添加此行代码将会导致 @vue/reactivity 版本的性能下降，而 @feng3d/reactivity 版本的性能保持不变
-
-        cb.value;
-    }
-    result.time = performance.now() - start;
-
-    result.values.push(cb.value);
-
-    return result;
-}
-```
-
-### 分析
-@feng3d/reactivity自下而上的使用脏标记进行维护状态，当发生变化时只会冒泡一次到父节点，全局有变化时（ref(1).value++ 标记变化）并不会触发重新计算。
-@vue/reactivity自上而下的使用版本号进行维护状态，当全局有变化时（ref(1).value++ 标记变化）每次取值时都会遍历整个树的子节点比对版本号判断是否需要重新计算。
-
-## 性能情况
-### 使用不同方式维护子节点
-
-// 修改第一个元素 `arr[0].value++;`
-| 方式 | 性能(ms) | 速度(x) | 隐患 |
-| --- | --- | --- | --- |
-| 失效子节点字典 | 126 | 8.8 | 当节点失效时无法完全清除子节点，并且无法保障检查节点的顺序，导致触发过时的依赖性能或许更差，但一般情况性能最佳。 |
-| 全量子节点链表 | 679 | 1.6 | 无 |
-| 全量子节点字典 | 1110 | 1 | 无 |
-| @vue/reactivity | 216 | 5.1 | 无 |
-
-// 修改最后一个元素 `arr[9999].value++`
-| 方式 | 性能(ms) | 速度(x) | 隐患 |
-| --- | --- | --- | --- |
-| 失效子节点字典 | 125 | 9.68 | 当节点失效时无法完全清除子节点，并且无法保障检查节点的顺序，导致触发过时的依赖性能或许更差，但一般情况性能最佳。 |
-| 全量子节点链表 | 730 | 1.65 | 无 |
-| 全量子节点字典 | 1210 | 1 | 无 |
-| @vue/reactivity | 253 | 4.78 | 无 |
-
-```ts
-import { computed, ref } from "@feng3d/reactivity";
-
-数组取值(ref, computed, 1000)
-
-export function 数组取值(ref: <T>(value?: T) => { value: T }, computed: <T>(func: (oldValue?: T) => T) => { readonly value: T },count: number)
-{
-    const result = { time: undefined, values: [] };
-
-    const arr:{
-        value: number;
-    }[] = new Array(10000).fill(0).map(() => ref(0));
-
-    const cb = computed(() =>
-    {
-        return arr.reduce((prev, curr) => prev + curr.value, 0);
-    });
-
-    const start = performance.now();
-    for (let i = 0; i < count; i++)
-    {
-        // arr[0].value++; // 修改第一个元素
-        arr[9999].value++; // 修改最后一个元素
-        cb.value;
-    }
-    result.time = performance.now() - start;
-
-    result.values.push(cb.value);
-
-    return result;
-}
-
-```
-
-## 为了库的简单易用性不支持以下内容
-- markRaw
-- shallowRef
-- shallowReactive
-- shallowReadonly
-- readonly
-- computed 中 setter
-- __v_skip
-
-## 扩展
+# @feng3d/reactivity
+
+feng3d的响应式库，使用方式以及API与@vue/reactivity基本保持一致。
+
+源码：https://gitee.com/feng3d/reactivity
+
+文档：https://feng3d.com/reactivity
+
+## 网站
+
+https://feng3d.com/reactivity
+
+## 安装
+```
+npm install @feng3d/reactivity
+```
+
+## 快速开始
+
+```ts
+import { ref, computed } from "@feng3d/reactivity";
+
+const a = ref(1);
+const b = ref(2);
+const c = computed(() => a.value + b.value);
+
+console.log(c.value); // 3
+a.value = 3;
+console.log(c.value); // 5
+```
+
+## 缘由
+在feng3d引擎中使用`@vue/reactivity`代替`@feng3d/watcher`来维护数据驱动功能时发现性能严重下降。
+
+为了解决这个问题，我重新实现了一个响应式库，并且在性能上进行了优化。
+
+### 问题示例
+
+示例： https://feng3d.com/reactivity/#复杂情况取值
+
+| 运行库 | 性能(ms) | 速度(x) |
+| --- | --- | --- |
+| @feng3d/reactivity | 2.8 | 286 |
+| @vue/reactivity | 801 | 1 |
+
+### 测试代码
+```ts
+复杂情况取值(ref, computed, 10000);
+
+export function 复杂情况取值(ref: <T>(value?: T) => { value: T }, computed: <T>(func: (oldValue?: T) => T) => { readonly value: T }, count: number)
+{
+    const result = { time: undefined, values: [] };
+
+    const b = ref(2);
+
+    function 递归(depth = 10)
+    {
+        if (depth <= 0) return computed(() =>
+        {
+            return b.value
+        }).value;
+
+        return computed(() =>
+        {
+            return 递归(depth - 1) + 递归(depth - 2);
+        }).value;
+    }
+
+    const cb = computed(() =>
+    {
+        return 递归(16);
+    });
+
+    b.value++;
+    cb.value;
+
+    const start = performance.now();
+    for (let i = 0; i < count; i++)
+    {
+        ref(1).value++; // 添加此行代码将会导致 @vue/reactivity 版本的性能下降，而 @feng3d/reactivity 版本的性能保持不变
+
+        cb.value;
+    }
+    result.time = performance.now() - start;
+
+    result.values.push(cb.value);
+
+    return result;
+}
+```
+
+### 分析
+@feng3d/reactivity自下而上的使用脏标记进行维护状态，当发生变化时只会冒泡一次到父节点，全局有变化时（ref(1).value++ 标记变化）并不会触发重新计算。
+@vue/reactivity自上而下的使用版本号进行维护状态，当全局有变化时（ref(1).value++ 标记变化）每次取值时都会遍历整个树的子节点比对版本号判断是否需要重新计算。
+
+## 性能情况
+### 使用不同方式维护子节点
+
+// 修改第一个元素 `arr[0].value++;`
+| 方式 | 性能(ms) | 速度(x) | 隐患 |
+| --- | --- | --- | --- |
+| 失效子节点字典 | 126 | 8.8 | 当节点失效时无法完全清除子节点，并且无法保障检查节点的顺序，导致触发过时的依赖性能或许更差，但一般情况性能最佳。 |
+| 全量子节点链表 | 679 | 1.6 | 无 |
+| 全量子节点字典 | 1110 | 1 | 无 |
+| @vue/reactivity | 216 | 5.1 | 无 |
+
+// 修改最后一个元素 `arr[9999].value++`
+| 方式 | 性能(ms) | 速度(x) | 隐患 |
+| --- | --- | --- | --- |
+| 失效子节点字典 | 125 | 9.68 | 当节点失效时无法完全清除子节点，并且无法保障检查节点的顺序，导致触发过时的依赖性能或许更差，但一般情况性能最佳。 |
+| 全量子节点链表 | 730 | 1.65 | 无 |
+| 全量子节点字典 | 1210 | 1 | 无 |
+| @vue/reactivity | 253 | 4.78 | 无 |
+
+```ts
+import { computed, ref } from "@feng3d/reactivity";
+
+数组取值(ref, computed, 1000)
+
+export function 数组取值(ref: <T>(value?: T) => { value: T }, computed: <T>(func: (oldValue?: T) => T) => { readonly value: T },count: number)
+{
+    const result = { time: undefined, values: [] };
+
+    const arr:{
+        value: number;
+    }[] = new Array(10000).fill(0).map(() => ref(0));
+
+    const cb = computed(() =>
+    {
+        return arr.reduce((prev, curr) => prev + curr.value, 0);
+    });
+
+    const start = performance.now();
+    for (let i = 0; i < count; i++)
+    {
+        // arr[0].value++; // 修改第一个元素
+        arr[9999].value++; // 修改最后一个元素
+        cb.value;
+    }
+    result.time = performance.now() - start;
+
+    result.values.push(cb.value);
+
+    return result;
+}
+
+```
+
+## 为了库的简单易用性不支持以下内容
+- markRaw
+- shallowRef
+- shallowReactive
+- shallowReadonly
+- readonly
+- computed 中 setter
+- __v_skip
+
+## 扩展
 - 扩大被反应式的对象的类型范围，只有`Object.isExtensible`不通过的对象不被响应化。Float32Array等都允许被响应化。