@realsee/five-webgpu 1.0.0-alpha.6 → 1.0.0-alpha.7

package/ai_guides/features/five.md

@@ -43,6 +43,17 @@ interface FiveInitArgs {
   plugins?: FivePlugin[];
   /** 是否显示 Powered by Realsee */
   poweredByRealsee?: boolean;
+  /**
+   * 强制使用 WebGL2 回落后端（默认 false）
+   * 进入 XRPanorama（WebXR 头显全景）的前置条件。
+   * 只在构造期生效，后端无法在运行时切换，设备检测必须在 new Five() 之前完成。
+   * 详见下方《forceWebGL 与 XR 回落后端》。
+   */
+  forceWebGL?: boolean;
+  /**
+   * @deprecated 在 five-webgpu 中未接线、无效。需要 WebGL2 后端请使用 `forceWebGL`。
+   */
+  webgl2?: boolean;
 }
 ```
 
@@ -73,6 +84,64 @@ Five 内部维护了一个 `requestAnimationFrame` 循环。
 | `antialias` | `boolean` | `false` | 抗锯齿，开启会增加性能消耗 |
 | `modeChangeDuration` | `number` | `800` | 模式切换动画时长 (ms) |
 | `enableWheel` | `boolean` | `true` | 是否支持滚轮缩放 |
+| `forceWebGL` | `boolean` | `false` | 强制使用 WebGL2 回落后端，进入 `XRPanorama` 的前置条件，详见下文 |
+| `webgl2` | `boolean` | — | **已废弃**，在 five-webgpu 中未接线。需要 WebGL2 请用 `forceWebGL` |
+
+### forceWebGL 与 XR 回落后端
+
+`forceWebGL` 让 five-webgpu 强制走 WebGL2 回落后端，而不是默认的 WebGPU 后端。它存在的唯一原因是 **进入 `XRPanorama`（WebXR 头显全景）模式**：`three` 的 WebGPU 后端目前不支持 WebXR，而 WebGL2 后端下 `renderer.xr` 完整可用。
+
+**语义与使用约束**
+
+- **语义**：`forceWebGL: true` 时，内部 `WebGPURenderer` 以 `{ forceWebGL: true }` 构造，使用 `WebGLBackend` 而非 WebGPU。
+- **必须在 `new Five()` 时决定**：后端在 renderer 构造期定死，**运行时无法切换**。因此业务侧的「是否需要进入 XR」的设备检测必须发生在 `new Five()` 之前，不能等实例创建后再改。
+- **与 `enableHDR` 互斥**：当 `forceWebGL` 为 `true` 时 `enableHDR` 不生效（`five.enableHDR` 会被置为 `false`），因为 XR 的 projection layer 固定 `colorFormat: RGBA8`，HDR 没有落地路径。
+- **传入外部 `renderer` 时不生效**：如果通过 `renderer` 参数传入了外部渲染器，`forceWebGL` 不会对其生效，需由调用方自行在构造该 renderer 时设置 `forceWebGL`（与 `antialias` 等参数一致）。
+- **`webgl2` 已废弃**：遗留的 `webgl2` 参数在 five-webgpu 中未接线、无任何效果；需要 WebGL2 后端请改用 `forceWebGL`。
+
+**能力降级限制**（开启 `forceWebGL` 后不可规避）
+
+1. **XR 下没有后处理**：`XRPanorama` 模式会整体旁路 `FiveRenderer` 的后处理链路（合成 / EffectComposer 全屏 pass 均不参与），滤镜、泛光等后处理在头显中不生效。
+2. **点云走 NodeMaterial 路径**：`forceWebGL` 下点云不再走 WebGPU compute 光栅化，而是退回 NodeMaterial 渲染路径。
+3. **3DGS 走 CPU 排序，且 VR 中性能预期需放低**：`forceWebGL` 下 3DGS 只能走 CPU 排序（`RASTER_CPU_SORT`）；在 XR 中还要叠加双眼渲染开销，务必对点数 / 显示做降级，不要期待与 WebGPU 后端相同的帧率。
+
+```typescript
+import { Five } from "@realsee/five-webgpu";
+
+// 设备检测需在 new Five() 之前完成
+const needXR = detectNeedXR();
+
+const five = new Five({
+  forceWebGL: needXR, // 一旦创建就无法再切换后端
+});
+
+five.load(workData);
+
+// 进入 XR（需在用户手势回调中调用，会触发 WebXR 权限请求）
+button.addEventListener("click", () => {
+  five.changeMode("XRPanorama").catch((error) => {
+    // 后端非 WebGL2 或浏览器不支持 WebXR 时，这里会收到含 forceWebGL 字样的中文错误
+    console.error(error);
+  });
+});
+
+// 用户摘下头显 / 退出 XR 时切回普通全景
+five.on("xr.session.end", () => five.changeMode("Panorama"));
+```
+
+也可以直接使用内置的 `XRButton`，样式与 API 同原始 five 保持一致（`XRButton.createButton(onClickHook)`）：
+
+```typescript
+import { Five, XRButton } from "@realsee/five-webgpu";
+
+const button = XRButton.createButton(() => five.changeMode("XRPanorama"));
+document.body.appendChild(button);
+```
+
+- 浏览器没有 `navigator.xr` 时显示 `WEBXR NOT AVAILABLE`（非 HTTPS 时显示 `WEBXR NEEDS HTTPS`），不支持 `immersive-vr` 时显示 `VR NOT SUPPORTED`。
+- 回调返回 Promise 时，`XRButton` 会接住 reject。若失败原因是没有开启 `forceWebGL`（后端是 WebGPU），按钮文案会临时变为「需降级到 WebGL2」，3 秒后恢复。其他失败原因不改变按钮，错误通过 `five.on("error")` 上报。
+
+> 更多模式说明（含 `XRPanorama` 与 `VRPanorama` 的区别）见 [mode.md](./mode.md)，可运行示例参见 `examples/xr`。
 
 ## Examples
 
@@ -180,5 +249,5 @@ five.updateCameraWithKeyframes(keyframes, 2000).then(() => {
 ---
 
 ```yaml
-tags: [five, initialization, core, instance, lifecycle]
+tags: [five, initialization, core, instance, lifecycle, forceWebGL, webgl2, xr, webxr]
 ```

package/ai_guides/features/material.md

@@ -51,12 +51,19 @@ Five 支持高性能的点云渲染（PBM），并提供灵活的样式配置：
 
 ### 4. Vertex Marks & Semantic Filtering (顶点标记与语义过滤)
 
-`vertexMarks` 是一个**全局开关**，用于控制是否启用模型顶点上的语义标记（`_feature_id_rsmask`）逻辑。
-
-*   **机制**: 模型顶点预置了 `_feature_id_rsmask` 属性，不同的值代表不同的语义部分。
-*   **当前支持**: 目前主要支持 `_feature_id_rsmask=1`（通常标记为天花板/房顶）。
-    *   当 `vertexMarks` 开启时，标记为 `1` 的顶点部分会在特定视角（如俯视）下自动隐藏，实现“开盖”效果，优化室内布局观测体验。
-*   **未来扩展**: 该机制设计支持更多标记值，未来可能用于控制其他特定模型部件的显示效果。
+`vertexMarks` 用于控制模型顶点上的语义标记（`_feature_id_rsmask`）逻辑。它是一个**按位掩码（bit flag）**，可以独立开关多类标注，而不再是单一的全局 `boolean` 开关。
+
+*   **机制**: 模型顶点预置了 `_feature_id_rsmask` 属性，不同的值代表不同的语义部分；每一类标注对应掩码中的一位，可按位独立启用。
+*   **标志位 (`PBMVertexMarkFlag`)**:
+    *   `PBMVertexMarkFlag.roof` (`0b00000010`): 开盖标注（`_feature_id_rsmask=1`）。开启后，命中屋顶标记的顶点会按 `roofStyle` 裁切：`AUTO` 随相机俯仰角渐进隐藏，`HIDE` 始终隐藏。
+    *   `PBMVertexMarkFlag.hidden` (`0b00000100`): 隐藏标注（`_feature_id_rsmask=2`）。开启后，命中隐藏标记且超过高度阈值的顶点会被裁掉。
+    *   `PBMVertexMarkFlag.none` (`0b00000000`): 不启用任何标注。
+    *   `PBMVertexMarkFlag.all` (`0b11111111`): 启用全部标注（默认全开，且包含未来新增的标注档位）。
+*   **按位组合**: 使用按位或组合多个标志，例如同时开启开盖与隐藏：
+    `PBMVertexMarkFlag.roof | PBMVertexMarkFlag.hidden`。
+*   **向后兼容**: `vertexMarks` 仍接受 `boolean`。传入 `true` 等价于 `PBMVertexMarkFlag.all`（全开），`false` 等价于 `PBMVertexMarkFlag.none`（全关）。
+*   **与自定义节点的关系**: 节点上下文中的 `isRoof` / `isHidden` 等标记判定**始终可用**，不受本开关影响；`vertexMarks` 只门控管线内置的自动裁切。
+*   **未来扩展**: 新增标注档位时，只需在 `PBMVertexMarkFlag` 中追加一个新的位，不影响现有标志。
 
 ## Configuration
 
@@ -74,7 +81,7 @@ Five 支持高性能的点云渲染（PBM），并提供灵活的样式配置：
 | `pointMinPixel` | `number` | `0` | 点云最小像素尺寸。 |
 | `pointMaxPixel` | `number` | `40` | 点云最大像素尺寸。 |
 | `pointAppearAnimation` | `boolean` | `true` | 是否开启点云出现动画。 |
-| `vertexMarks` | `boolean` | `true` | 是否显示/生效标注。 |
+| `vertexMarks` | `boolean \| number` | `true` | 顶点标注开关，按位控制（见 Concepts）。`PBMVertexMarkFlag` 位掩码；传入 `boolean` 时 `true`=全开、`false`=全关。 |
 | `brightness` | `number` | `1.0` | 场景亮度倍数。 |
 | `floorStyle` | `PBMFloorStyle` | `'OPACITY'` | 楼层显示样式。 |
 | `shownFloorIndex` | `number` | `-1` | 当前显示的楼层索引。`-1` 表示显示所有楼层。 |
@@ -140,6 +147,26 @@ five.model.set({
 });
 ```
 
+### 3. Toggling Vertex Marks (控制顶点标注)
+
+```typescript
+import { PBMVertexMarkFlag } from '@realsee/five-webgpu';
+
+// 仅开启“开盖”标注
+five.model.set({ vertexMarks: PBMVertexMarkFlag.roof });
+
+// 同时开启“开盖”与“隐藏”标注
+five.model.set({
+  vertexMarks: PBMVertexMarkFlag.roof | PBMVertexMarkFlag.hidden,
+});
+
+// 关闭全部标注
+five.model.set({ vertexMarks: PBMVertexMarkFlag.none });
+
+// 向后兼容：true 等价于全开，false 等价于全关
+five.model.set({ vertexMarks: true });
+```
+
 ## Related
 
 *   [Parameter](./parameter.md): 配置系统入口与继承逻辑。
@@ -149,5 +176,5 @@ five.model.set({
 ---
 
 ```yaml
-tags: [material, appearance, pointcloud, parameter, roof, ceiling, config]
+tags: [material, appearance, pointcloud, parameter, roof, hidden, ceiling, 开盖, 隐藏, 顶点标记, 位掩码, bitmask, vertex-mark, config]
 ```

package/ai_guides/features/mode.md

@@ -13,11 +13,12 @@
 
 ```ts
 type Mode =
-  | "Panorama"   // 全景图游走模式
-  | "Mapview"    // 模型地图模式
-  | "Floorplan"  // 模型户型图模式
-  | "Topview"    // 模型平面图模式
-  | "Model"      // 模型游走模式
+  | "Panorama"    // 全景图游走模式
+  | "Mapview"     // 模型地图模式
+  | "Floorplan"   // 模型户型图模式
+  | "Topview"     // 模型平面图模式
+  | "Model"       // 模型游走模式
+  | "VRPanorama"  // 手机 Cardboard 分屏全景模式（陀螺仪驱动）
 ```
 
 ## Concepts
@@ -32,6 +33,12 @@ type Mode =
     *   交互：鼠标拖拽 / Pan手势平移相机；滚轮 / Pinch手势缩放画面；点击 / Tap切换到最近全景点。
 *   **Model (模型漫游)**: 适用于第一人称在场景中自由游览。交互同 Panorama，但不限制相机只能在观察点位置。
     *   交互：鼠标拖拽 / Pan手势旋转视角；滚轮 / Pinch手势缩放视场角；点击 / Tap移动到指定位置。
+*   **XRPanorama (WebXR 头显全景)**: 适用于通过 WebXR 在 VR 头显（Pico / Quest / Apple Vision Pro 等）中沉浸式浏览全景。头显朝向决定看景方向，用手柄 / 注视射线指向并走动到全景点位。
+    *   交互：头显朝向看景；手柄指向射线（或 Vision Pro 的注视射线）拾取；手柄按键 tap / press 走点与触发事件。
+    *   前置条件：**必须在 `new Five({ forceWebGL: true })` 时开启 WebGL2 回落后端**（`three` 的 WebGPU 后端目前不支持 WebXR）；浏览器需支持 WebXR（存在 `navigator.xr`）。
+    *   进入：`five.changeMode('XRPanorama')` 或 `five.setState({ mode: 'XRPanorama' })`，会触发一次 XR 会话权限请求（需在用户手势中调用）。
+    *   退出：监听 `xr.session.end` 事件后切回其他模式（如 `Panorama`）。
+*   **VRPanorama (Cardboard 分屏全景)**: 适用于手机配合 Cardboard 眼镜的分屏体验。使用陀螺仪驱动视角，左右眼分屏渲染。**不需要头显设备，也不需要 `forceWebGL`**。
 
 ## Configuration
 
@@ -235,15 +242,25 @@ document.querySelector('#btn-map').addEventListener('click', () => {
 1.  **相机类型差异**：`Topview` 模式使用的是正交相机 (OrthographicCamera)，而其他模式使用的是透视相机 (PerspectiveCamera)。在进行自定义渲染或计算时需注意投影矩阵的差异。
 2.  **切换动画**：`setState` 触发的切换动画是自动规划的，而 `changeMode` 允许更细粒度的控制。如果需要精确控制动画时长或回调，请使用 `changeMode`。
 3.  **全景加载**：`Panorama` 模式下会自动使用瓦片（tile）方式加载全景图以平衡效率和清晰度，而其他模式（如 `Mapview`）主要展示模型几何。
+4.  **`XRPanorama` 与 `VRPanorama` 不要混淆**：
+    *   `VRPanorama` 是手机 Cardboard 分屏 + 陀螺仪方案，**不需要头显、不需要 `forceWebGL`**，面向的是把手机塞进纸盒眼镜的场景。
+    *   `XRPanorama` 走的是真正的 WebXR 头显设备（Pico / Quest / Apple Vision Pro 等），**必须 `new Five({ forceWebGL: true })`**，面向的是独立 VR 头显。
+    *   两者的驱动源（陀螺仪 vs WebXR viewer pose）、渲染路径（分屏 quad vs XR projection layer）、输入方式（无手柄 vs 手柄 / 注视射线）都不同，切换前请先确认目标设备。
+5.  **`XRPanorama` 的能力降级限制**（均源自 `forceWebGL` 的 WebGL2 回落后端，无法规避）：
+    *   **XR 下没有后处理**：XR 模式会整体旁路 `FiveRenderer` 的后处理链路（合成 / EffectComposer 全屏 pass 都不参与），滤镜、泛光等后处理效果在头显中不生效。
+    *   **点云走 NodeMaterial 路径**：`forceWebGL` 下点云不再走 WebGPU compute 光栅化，而是退回 NodeMaterial 渲染路径。
+    *   **3DGS 走 CPU 排序，且 VR 中性能预期需放低**：`forceWebGL` 下 3DGS 只能走 CPU 排序（`RASTER_CPU_SORT`）；在 XR 中还叠加了双眼渲染的开销，务必对点数 / 显示做降级，不要期待与 WebGPU 后端相同的帧率。
 
 ## Related
 
 *   [State - 状态](./state.md): 了解 Mode 在 State 中的位置及其他状态属性。
 *   [Gesture - 手势](./gesture.md): 了解不同模式下的手势交互逻辑。
 *   [Event - 事件](./event.md): 了解模式切换等相关事件。
+*   [Five - 核心类](./five.md): 了解 `forceWebGL` 初始化参数（进入 `XRPanorama` 的前置条件）。
+*   XR 示例：参见 `examples/xr`（`forceWebGL: true` + 按钮进入 `XRPanorama`）。
 
 ---
 
 ```yaml
-tags: [mode, state, interaction]
+tags: [mode, state, interaction, xr, webxr, vr, forceWebGL, XRPanorama, VRPanorama]
 ```

package/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJytWttu2zgQ/Rc9s10Ob6L81qTNIkDaBE23u0CRB8VmbTayFEhymqDIvy8oNTYpy/FQuy82bM/hOTOcGV7kX0ldVW2TzL4BFYporgmIDAgoKglPJSNCcQIyFYQD1UQxEEQxKYlKs4xwEIqAFBkRWhLJqCKKCyCKZ+KGJLX5Xph5a6uySWa/EqapeyvztUlmySfT/qzqu+vNbTOv7a1JSHJny0UyA6ZJsqmLZJbMi7xpTPOHLRfm8e0Q8XbVrouE9FbJLGmbxRs3xJv+i2eSCKY8xnc/8sfL+17OCxmT6oXMlq2pv+fzLZ9nf5BqC+roFN93MIYxhCBISTJf2WJRmzKZfRNM3TgVWnoqIuKLDWxAyjQloEAQLiQ4es21R39SbcqFLZdfq2KzNqgghJDYIGRUkUwyApR2cjKqAjmPkxQ9Roty1JJ51J/N0lblBPYxIE6Ai4GfCvcrU5sJCsaAWAUiCH/emA8PpmxxYX+xjs0BoJkiACAJABMEgHMCICgBkO5FZQQgdS/a2WWCAKOcAGPUveibTnkwe3+apt3UEeJ9ADZWmR+rc/dbY+YtnjOEIFmB+u3iY7Uwp6u8XEa4OsBgeWHIW3yxRSTtDoJlZWLIGskYxcb5kO16bspYJ3cYLK8YWWk/m6ba1PMI8jEgVoH0FVze/ohKZM8ezZd6fFd5WeHZttZYLpUNuL6Yx7juMARhmdMsWFHKhanxpJ49lk/7Hem6zdsIH3fm8f3bLeBAXf+WadeNIfPr9u+qvmvwSnbmSL8Z9ev2n8/R3T+EYFkZDVivTdPYqoxh9SFoVh2wnlZlW1dFEZNZeygstxrbK340zer4btW3Pn4SAKZhULSntp4XBkcW2iPouBAH6a6rwi5iOTsQglgEy3k4xummaat1LHOPwlCnbGz/EkQYtX15NcZhBonMn9bzdb40MQcuHxDdpSQVXW+S1J/r3209RkUIQXouRbAKVQ1uL+8M4z2VsvdUyuF6gF8KsH6lhyvn3NOHW2RHsNHeMw3E1RVxVd3FQQVFFuRtnMRxaLRCkbJeF/ixO7MPiFO/szpe3JxCOtzK7np+3yLOS9u+q5e4nH91BFyqcMqHva7O1/l/knVsEKQyoHpE2YW9M/+LutcGik0eN7PEhfKmEx6c169OPiLXx94w5uLILf4dpZAQUv51v8hbk98WiOwNzGPoueQZ4aq/s3IfQg0u0me2aE2N0rAzR5SSGjrcT+CnaoFzeGeOIEuDa4xzN1F5a2qbF7gG5QGiMyvjlAhQjAhKNRFUS9J/t/3Y/8oEJ4JzIEKAJkLSPhczTvdz8SRv7HzPhWOJGaAQ98Y0rN9+kKtVVS6jqQMUhjq4vt0O8tTYeV5MYA+BCAGg2IiAvKwuy+IpXsAAiLm0F/zAvLucnzb3PhIhgXM4MP+TJOwhERIEjKZgP50TVeyDEUIkHUvI39M6TcgI+LgQ93jJ32fbwvD3xzl7u5ilQQrWbafcu0f41ZqfF/mTtyK81ji31rgdgwIaVF1e52vTmvprXmywu10fEturFchuNXbvwRVTUxUPZjFBzzgUGQ0GYiwaL8kyISoBND46tMsI9+RzTJfLsca0E2T5yMmquPC7lbvtOt3cmu5si74f2yKiVXBJiRK8Tx8e3Pu6geNkYCV0XHt3gpe3jakfkBXqA6KdVmnvrwiedroh3Yyi+Z0x0luVDpleKmzP64O9cAx1vPGqNJWDY+VV3zQRR0tnGdN8lQZJlJZAVJZqklKlSQr9jtD95yAovwZ7bHpFw6EZTtOeUwfPqd4t8vvWPpiLzdqWeTlHRmIUhoi8Do4KH57M+2ptLuxy1dpyiaMeAWGIg9o6K6qftlx2Y7D3yMnfwyBosyDJ/SH4BFqOoR1kX9bd8Li085/+5pumsXl5UmxqnIwh4rjvafgg9rcfZ7Y27hlcE+n/AHeM/vn5X6pE5Qk="
+window.hierarchyData = "eJytmttu2zgQht9F12yXw5NI3zVpUwRImqDpdhcoeqHYrMNGlgJJThMUffeCUuOQshwPvXuToPH8+v4ZDg+i+zNr6rprs9kXoJISLRgBSQ0BxTjhhjEiVE5AGkY4cEYUN5wowQVRJteEM2YISJUToQ2RXEuiJKNEyZx/JVljv5V23rm6arPZz4xp4X9Vxcpms+yD7X7Uze3V+rqdN+7aZiS7ddUimwHTJFs3ZTbL5mXRtrb9y1UL+/B6rHh9063KjAxR2Szr2sUr/4hXwx9+kUxwGhDffC8eLu4GO08wJtUTzFWdbb4V8w0viN+J2oh6nMq3E0whxhIElGTzG1cuGltlsy+C06/ehTaBi4T6YgsbQZkWBBRnhCuQHq8FC/BH9bpauGr5uS7XK4sqQixJLYIBSoxUBCjt7RigkZ2Hgxw9JJvyaKkC9Ee7dHV1AH1KiDPgaxC2wt2NbewBDqaEWAcyKn/R2nf3tupwZX+KTu0BAEoJABgCvtkBeE4AhCAA0v/QigAYRYBRToABEGCMEmBcE2BCfR2ch6P33rbdukkwHwqQtQIa1urUf9baeYdnxhI0NVwuzuuFPb4pqmVCqiMNlgtjbvnJlYnYZwmWyvSYmkhMovF8TLua2yo1yWcNlismdtqPtq3XzTwBPiXEOpChg4vr70mNHMRjeQoC3mVR1XjaJhrL0mrE+mQf0laHsQhLNvGOUi1sg4cG8UgeozzcP7qiS8jxOTx5/aZ+Awd/DgUF/WrMIBzff+rmtsU7eQ7H5s3Clfjfj8mrfyzBUrmOqFe2bV1dpVBDCZYqVEQ9rquuqcsypbO2VFh2NJOeDhjntr3Zf1oNo/e/CQAzZjRpj10zLy0OFscjcFyxnbirunSLVGYvQoAF4zvBx+u2q1ep5EGFQZvJ80tUYdTx5cUaxx0ko9PL6apY2pQXrlCQvEpJxvq1SbJwrP8s6ykuYgk28+hl87JucWd5H5ieac6HTPOt/QC/FWDzMrtnzmngD7fJTmiTs2fGED+viJ/VfR1UNMmivk2zOC1NdigMHXzxsHYn7h7x1u+j9k9uTgWMj7LPa/6wRJxWrnvTLHE9/+ITcK3CqRyv6U2xKv6TrX0PQToDPm5i/9Azd2v/F3cvPSi1efzIEl9K30H+Qi80fnSO3B+HwJSLI7/590gZvSRdHp1f1q7qjst6vTgvOtu4okQZ2JYh2lqBjOF/3y2KzhbXJWLqROEpufOccsL1cGHm/zEqQFHVJ67sbINLfBOOSFiPEx6650O9wCX8HI6AmWhnPPVdMh7RF1fHQJB8GQoUiOBcEQGaEsGkJr7Vhh/Dp5sPhjgBmghJcyKkkUQo3W96PnR7ShwVrZsnteeWCnF9DZpuoy9v6mqZjI5UCDSTegr92Lp5UR5Aj4WYq3uuJgwUVX1RlY/pBkZChAEBExXoR9B3/2FjHyoRFiTNd4z/QRa2lBgLRu7ugwNdbIsRRpTmu/vhMCMT4v1G/Ldc4XHflZa/3c8c4lI2Calof/fhfwfAz87+OCseg73hpSV0E407uCim43u0pljZzjafi3KNPXSHktRVW3Ge+5z97+imq63Le7s4wM+0FFkNbvhUNZ6a5YCqRNLk6jDdd4T/AnbKl++x1nYH2AqVB7uS0a2Zv3Q7Xl/b/hUbfU23USS7kMwQpSD/Y8WMrKTZwFroWdFLsVdfXLe2uUfO0FCQnLSWQ74K8pEHP6Jovg9GZqvlmPQ0w7ay3rkWTqn2L7zKRN8p+PfWy2HRRLzh+siUxVcZI0hOOSU5yJzk/pSYM9Mf2P1/fYimX4t9e3vBw64RNlIMTBMm/2ZR3HXu3p6tV64qqjmyEpOy/ZX3dQjg7x7t23plz9zypnPVEoeeEGHA0dw6Kesfrlr2z2BvkYO/pUFgIWry8BH8ACzHYKNR93n7Uc/jU/j7Yt22rqiOynWDszFWIHJn0YHvTx4nrrH+q8A2Mf+Rbh/+16/foP0RJw=="

package/docs/assets/navigation.js

@@ -1 +1 @@
-window.navigationData = "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"
+window.navigationData = "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"