Merge branch 'krpano'

packages/docs/.umirc.ts

@@ -12,10 +12,14 @@ export default defineConfig({
   resolve: {
     includes: ["./docs"],
   },
+  headScripts: [
+    { src: "https://houseoss.4dkankan.com/project/leifeng-transfer/tour.js" },
+  ],
   alias: {
     "@dage/utils": join(__dirname, "../utils/dist/"),
     "@dage/service": join(__dirname, "../service/dist/"),
     "@dage/pc-components": join(__dirname, "../pc-components/dist/"),
+    "@dage/krpano": join(__dirname, "../krpano/dist/"),
   },
   navs: [
     {
@@ -31,6 +35,10 @@ export default defineConfig({
       path: "/service",
     },
     {
+      title: "krpano",
+      path: "/krpano",
+    },
+    {
       title: "更新日志",
       path: "/log",
     },
@@ -100,6 +108,28 @@ export default defineConfig({
         path: "/log/SERVICE_CHANGELOG",
       },
     ],
+    "/krpano": [
+      {
+        title: "基本使用",
+        path: "/krpano",
+      },
+      {
+        title: "Scene 场景",
+        path: "/krpano/scene",
+      },
+      {
+        title: "HotSpot 热点",
+        path: "/krpano/hotspot",
+      },
+      {
+        title: "Autorotate 自动旋转",
+        path: "/krpano/autorotate",
+      },
+      {
+        title: "View 视角",
+        path: "/krpano/view",
+      },
+    ],
   },
   // more config: https://d.umijs.org/config
 });

packages/docs/docs/index.md

@@ -14,6 +14,8 @@ features:
     desc: 接口请求[工具](#/service)
   - title: "@dage/utils"
     desc: 工具[类库](#/utils)
+  - title: "@dage/krpano"
+    desc: 基于 `krpano` 的 React[组件库](#/krpano)
 ---
 
 ## 如何使用

packages/docs/docs/krpano/autorotate/index.md

@@ -0,0 +1,3 @@
+### API
+
+<API hideTitle exports='["Autorotate"]' src='@dage/krpano/index.d.ts'></API>

packages/docs/docs/krpano/components/MouseHoldView.tsx

@@ -0,0 +1,34 @@
+import React, { useRef, FC } from "react";
+
+export interface MouseHoldViewProps {
+  children?: React.ReactNode;
+  onHold: () => void;
+}
+
+export const MouseHoldView: FC<MouseHoldViewProps> = ({ children, onHold }) => {
+  const isMouseHeld = useRef(false);
+  const requestIdRef = useRef<number | null>(null);
+
+  const handleMouseDown = () => {
+    isMouseHeld.current = true;
+    requestAnimationFrame(checkMouseHold);
+  };
+
+  const handleMouseUp = () => {
+    isMouseHeld.current = false;
+    requestIdRef.current && cancelAnimationFrame(requestIdRef.current);
+  };
+
+  const checkMouseHold = () => {
+    if (isMouseHeld.current) {
+      onHold();
+      requestIdRef.current = requestAnimationFrame(checkMouseHold);
+    }
+  };
+
+  return (
+    <div onMouseDown={handleMouseDown} onMouseUp={handleMouseUp}>
+      {children}
+    </div>
+  );
+};

packages/docs/docs/krpano/components/index.ts

@@ -0,0 +1 @@
+export * from "./MouseHoldView";

packages/docs/docs/krpano/hotspot/index.md

@@ -0,0 +1,86 @@
+## 示例
+
+```tsx
+import React, { useState, useMemo } from "react";
+import { HotSpot, Krpano, Scene, View } from "@dage/krpano";
+
+const URL = "https://houseoss.4dkankan.com/project/leifeng-transfer";
+
+export default () => {
+  const [currentScene, setCurrentScene] = useState("center1");
+
+  const CENTER_SCENE_LIST = useMemo<SceneProps[]>(
+    () => [
+      {
+        name: "center1",
+        previewUrl: URL + "/panos/center1.tiles/preview.jpg",
+        imageTagAttributes: {
+          type: "cube",
+          tileSize: 512,
+          multires: true,
+        },
+        images: [
+          {
+            tiledImageWidth: 2624,
+            tiledImageHeight: 2624,
+            url: URL + "/panos/center1.tiles/%s/l3/%v/l3_%s_%v_%h.jpg",
+          },
+          {
+            tiledImageWidth: 1280,
+            tiledImageHeight: 1280,
+            url: URL + "/panos/center1.tiles/%s/l2/%v/l2_%s_%v_%h.jpg",
+          },
+          {
+            tiledImageWidth: 640,
+            tiledImageHeight: 640,
+            url: URL + "/panos/center1.tiles/%s/l1/%v/l1_%s_%v_%h.jpg",
+          },
+        ],
+        children: (
+          <>
+            <View
+              hlookat={0}
+              vlookat={0}
+              fovType="MFOV"
+              fov={120}
+              maxPixelZoom={2}
+              fovMin={70}
+              fovMax={140}
+              limitView="auto"
+            />
+
+            <HotSpot
+              name="hotspot1"
+              url={require("./guide.png")}
+              atv={5}
+              scale={0.5}
+              edge="top"
+              distorted={true}
+              onClick={() => alert("点击了 hotspot1")}
+            />
+          </>
+        ),
+      },
+    ],
+    []
+  );
+
+  return (
+    <div className="demo">
+      <Krpano
+        className="krpano"
+        currentScene={currentScene}
+        passQueryParameters={true}
+      >
+        {CENTER_SCENE_LIST.map((sc) => (
+          <Scene key={sc.name} {...sc} />
+        ))}
+      </Krpano>
+    </div>
+  );
+};
+```
+
+## API
+
+<API hideTitle exports='["HotSpot"]' src='@dage/krpano/index.d.ts'></API>

packages/docs/docs/krpano/index.less

@@ -0,0 +1,70 @@
+.demo {
+  position: relative;
+}
+
+.krpano {
+  height: 600px;
+}
+
+@primaryColor: coral;
+
+.active-btn {
+  color: white;
+  background-color: @primaryColor;
+}
+
+.toolbar {
+  display: flex;
+  gap: 10px;
+  position: absolute;
+  bottom: 20px;
+  right: 20px;
+}
+
+.scene-panel {
+  position: absolute;
+  bottom: 20px;
+  left: 50%;
+  padding: 10px;
+  user-select: none;
+  transform: translateX(-50%);
+  background: rgba(0, 0, 0, 0.4);
+
+  &__menu {
+    display: flex;
+    gap: 20px;
+    margin-bottom: 10px;
+    color: white;
+
+    &__item {
+      cursor: pointer;
+
+      &.active {
+        color: @primaryColor;
+        font-weight: bold;
+      }
+    }
+  }
+
+  &__list {
+    display: flex;
+    gap: 10px;
+
+    &__item {
+      flex-shrink: 0;
+      width: 150px;
+      height: 80px;
+      cursor: pointer;
+      border: 2px solid transparent;
+
+      &.active {
+        border-color: @primaryColor;
+      }
+      & > img {
+        width: 100%;
+        height: 100%;
+        object-fit: cover;
+      }
+    }
+  }
+}

packages/docs/docs/krpano/index.md

@@ -0,0 +1,321 @@
+krpano 是一款基于 xml 开发的插件，改个 skin 样式琢磨半天，想动态添加或者切换场景无从下手，国内社区少的可怜，只有个[英文文档](https://krpano.com/docu/xml/?version=119pr13)，修改成本太高了，还好有 gpt 做参数解析。
+
+`@dage/krpano` 将常用的标签使用 `React` 进行了组件化封装（MVVM 真香），并在实例上补充了 `vtourskin` 的功能，支持类型推断，基本满足开发需求。
+
+## 开发环境
+
+`krpano 1.19-pr13`
+
+## 示例
+
+```tsx
+import React, { useState, useMemo } from "react";
+import {
+  Autorotate,
+  Krpano,
+  Scene,
+  View,
+  HotSpot,
+  SceneProps,
+  ROTATE_DIRECTION,
+  ZOOM_ACTION,
+} from "@dage/krpano";
+import { MouseHoldView } from "./components";
+import "./index.less";
+
+interface ISceneProps extends Partial<SceneProps> {
+  thumbUrl?: string;
+}
+
+const URL = "https://houseoss.4dkankan.com/project/leifeng-transfer";
+
+export default () => {
+  const [currentMenu, setCurrentMenu] = useState(0);
+  const [currentScene, setCurrentScene] = useState("center1");
+  const [autorotateEnable, setAutorotateEnable] = useState(false);
+
+  const CENTER_SCENE_LIST = useMemo<ISceneProps[]>(
+    () => [
+      {
+        name: "center1",
+        thumbUrl: URL + "/panos/center1.tiles/thumb.jpg",
+        previewUrl: URL + "/panos/center1.tiles/preview.jpg",
+        imageTagAttributes: {
+          type: "cube",
+          tileSize: 512,
+          multires: true,
+        },
+        images: [
+          {
+            tiledImageWidth: 2624,
+            tiledImageHeight: 2624,
+            url: URL + "/panos/center1.tiles/%s/l3/%v/l3_%s_%v_%h.jpg",
+          },
+          {
+            tiledImageWidth: 1280,
+            tiledImageHeight: 1280,
+            url: URL + "/panos/center1.tiles/%s/l2/%v/l2_%s_%v_%h.jpg",
+          },
+          {
+            tiledImageWidth: 640,
+            tiledImageHeight: 640,
+            url: URL + "/panos/center1.tiles/%s/l1/%v/l1_%s_%v_%h.jpg",
+          },
+        ],
+        children: (
+          <>
+            <View
+              hlookat={0}
+              vlookat={0}
+              fovType="MFOV"
+              fov={120}
+              maxPixelZoom={2}
+              fovMin={70}
+              fovMax={140}
+              limitView="auto"
+            />
+
+            <HotSpot
+              name="hotspot1"
+              url={require("./hotspot/guide.png")}
+              atv={5}
+              scale={0.5}
+              edge="top"
+              distorted={true}
+              onClick={() => setCurrentScene("center2")}
+            />
+          </>
+        ),
+      },
+      {
+        name: "center2",
+        thumbUrl: URL + "/panos/center2.tiles/thumb.jpg",
+        previewUrl: URL + "/panos/center2.tiles/preview.jpg",
+        imageTagAttributes: {
+          type: "cube",
+          tileSize: 512,
+          multires: true,
+        },
+        images: [
+          {
+            tiledImageWidth: 2624,
+            tiledImageHeight: 2624,
+            url: URL + "/panos/center2.tiles/%s/l3/%v/l3_%s_%v_%h.jpg",
+          },
+          {
+            tiledImageWidth: 1280,
+            tiledImageHeight: 1280,
+            url: URL + "/panos/center2.tiles/%s/l2/%v/l2_%s_%v_%h.jpg",
+          },
+          {
+            tiledImageWidth: 640,
+            tiledImageHeight: 640,
+            url: URL + "/panos/center2.tiles/%s/l1/%v/l1_%s_%v_%h.jpg",
+          },
+        ],
+        children: (
+          <View
+            hlookat={0}
+            vlookat={0}
+            fovType="MFOV"
+            fov={120}
+            maxPixelZoom={2}
+            fovMin={70}
+            fovMax={140}
+            limitView="auto"
+          />
+        ),
+      },
+    ],
+    []
+  );
+  // 支持从 xml 中获取场景
+  const PARTY_SCENE_LIST = useMemo<ISceneProps[]>(
+    () => [
+      {
+        name: "scene_party",
+        thumbUrl: URL + "/panos/party.tiles/thumb.jpg",
+      },
+    ],
+    []
+  );
+  const MENUS = [
+    {
+      title: "长沙国防教育馆",
+      scenes: CENTER_SCENE_LIST,
+    },
+    {
+      title: "游客服务中心",
+      scenes: PARTY_SCENE_LIST,
+    },
+  ];
+
+  const handleSceneClick = (name: string) => {
+    setCurrentScene(name);
+  };
+
+  const handleMenuClick = (idx: number) => {
+    setCurrentMenu(idx);
+  };
+
+  const handleView = (direction: ROTATE_DIRECTION) => {
+    window.ReactKrpanoActionProxy?.rotateView(direction);
+  };
+
+  const handleZoom = (action: ZOOM_ACTION) => {
+    window.ReactKrpanoActionProxy?.zoomView(action);
+  };
+
+  return (
+    <div className="demo">
+      <Krpano
+        className="krpano"
+        xml="./party.xml"
+        webvrUrl="./krpano/plugins/webvr.xml"
+        currentScene={currentScene}
+        passQueryParameters={true}
+      >
+        <Autorotate enabled={autorotateEnable} />
+
+        {[...CENTER_SCENE_LIST, ...PARTY_SCENE_LIST].map(
+          (sc) => sc.imageTagAttributes && <Scene key={sc.name} {...sc} />
+        )}
+      </Krpano>
+
+      <div className="scene-panel">
+        <div className="scene-panel__menu">
+          {MENUS.map((sc, idx) => (
+            <div
+              key={sc.title}
+              className={`scene-panel__menu__item ${
+                idx === currentMenu && "active"
+              }`}
+              onClick={handleMenuClick.bind(undefined, idx)}
+            >
+              {sc.title}
+            </div>
+          ))}
+        </div>
+
+        <div className="scene-panel__list">
+          {MENUS[currentMenu].scenes.map((sc) => (
+            <div
+              key={sc.name}
+              className={`scene-panel__list__item ${
+                sc.name === currentScene ? "active" : ""
+              }`}
+              onClick={handleSceneClick.bind(undefined, sc.name)}
+            >
+              <img
+                src={sc.thumbUrl || sc.images![0].url.replace("%s", "f")}
+                alt={sc.name}
+              />
+            </div>
+          ))}
+        </div>
+      </div>
+
+      <div className="toolbar">
+        <MouseHoldView
+          onHold={handleView.bind(undefined, ROTATE_DIRECTION.LEFT)}
+        >
+          <button>←</button>
+        </MouseHoldView>
+        <MouseHoldView
+          onHold={handleView.bind(undefined, ROTATE_DIRECTION.RIGHT)}
+        >
+          <button>→</button>
+        </MouseHoldView>
+        <MouseHoldView onHold={handleView.bind(undefined, ROTATE_DIRECTION.UP)}>
+          <button>↑</button>
+        </MouseHoldView>
+        <MouseHoldView
+          onHold={handleView.bind(undefined, ROTATE_DIRECTION.DOWN)}
+        >
+          <button>↓</button>
+        </MouseHoldView>
+        <MouseHoldView onHold={handleZoom.bind(undefined, ZOOM_ACTION.IN)}>
+          <button>+</button>
+        </MouseHoldView>
+        <MouseHoldView onHold={handleZoom.bind(undefined, ZOOM_ACTION.OUT)}>
+          <button>-</button>
+        </MouseHoldView>
+        <button
+          className={`${autorotateEnable && "active-btn"}`}
+          onClick={() => setAutorotateEnable(!autorotateEnable)}
+        >
+          360°
+        </button>
+        <button
+          onClick={() => {
+            window.ReactKrpanoActionProxy?.call("webvr.enterVR();");
+          }}
+        >
+          vr
+        </button>
+      </div>
+    </div>
+  );
+};
+```
+
+## API
+
+### Krpano
+
+<API hideTitle exports='["Krpano"]' src='@dage/krpano/index.d.ts'></API>
+
+## window.ReactKrpanoActionProxy Methods
+
+### call
+
+执行 Javascript 函数
+
+| Name     | Description              | Type      | Default      |
+| -------- | ------------------------ | --------- | ------------ |
+| action   | 动作                     | `string`  | `(required)` |
+| nexttick | 是否在下一个渲染帧后执行 | `boolean` | `false`      |
+
+### setTag
+
+动态添加标签
+
+| Name  | Description | Type                  | Default      |
+| ----- | ----------- | --------------------- | ------------ |
+| tag   | 标签        | `string`              | `(required)` |
+| name  | 名称        | `string`              | `(required)` |
+| attrs | 属性        | `Record<string, any>` | `(required)` |
+
+### removeScene
+
+删除场景
+
+| Name | Description | Type     | Default      |
+| ---- | ----------- | -------- | ------------ |
+| name | 场景名称    | `string` | `(required)` |
+
+### loadScene
+
+加载场景
+
+| Name | Description | Type     | Default      |
+| ---- | ----------- | -------- | ------------ |
+| name | 场景名称    | `string` | `(required)` |
+
+### rotateView
+
+旋转视图
+
+| Name      | Description | Type               | Default      |
+| --------- | ----------- | ------------------ | ------------ |
+| direction | 方位        | `ROTATE_DIRECTION` | `(required)` |
+| degrees   | 旋转度数    | `number`           | `10`         |
+
+### zoomView
+
+缩放视图
+
+| Name   | Description | Type          | Default      |
+| ------ | ----------- | ------------- | ------------ |
+| action | 动作        | `ZOOM_ACTION` | `(required)` |
+| num    | 缩放大小    | `number`      | `10`         |

packages/docs/docs/krpano/scene/index.md

@@ -0,0 +1,3 @@
+### API
+
+<API hideTitle exports='["Scene"]' src='@dage/krpano/index.d.ts'></API>

packages/docs/docs/krpano/view/index.md

@@ -0,0 +1,3 @@
+### API
+
+<API hideTitle exports='["View"]' src='@dage/krpano/index.d.ts'></API>

packages/docs/public/krpano/plugins/webvr.xml

@@ -0,0 +1,897 @@
+<krpano>
+	<!--
+		webvr.xml
+		- krpano 1.19
+	-->
+
+	<!-- load the WebVR plugin and assign it to a 'webvr' variable for easier usage -->
+	<plugin name="WebVR" devices="html5" keep="true"
+	        url="webvr.js"
+	        onloaded="copy(webvr, plugin[WebVR]);"
+	        mousespeed="0.00125"
+	        multireslock="true"
+	        fullscreen_mirroring="true"
+	        mobilevr_support="true"
+	        mobilevr_ipd="63.5"
+	        mobilevr_screensize="auto"
+	        mobilevr_lens_overlap="1.0"
+	        mobilevr_lens_fov="96"
+	        mobilevr_lens_dist="0.6"
+	        mobilevr_lens_dist2="1|0|0|0"
+	        mobilevr_lens_ca="0.0"
+	        mobilevr_lens_vign="100"
+	        mobilevr_wakelock="true"
+	        mobilevr_sensor_mode="3"
+	        mobilevr_autocalibration="false"
+	        mobilevr_touch_support="true"
+	        mobilevr_fake_support="false"
+	        vr_cursor="hotspot[vr_cursor]"
+	        vr_cursor_enabled="true"
+	        vr_cursor_onover="if(handcursor, tween(hotspot[vr_cursor].scale,0.4,0.1); vr_auto_click(get(vr_timeout)); );"
+	        vr_cursor_onout="tween(hotspot[vr_cursor].scale,0.3,0.1);"
+	        onavailable="webvr_onavailable();"
+	        onunavailable=""
+	        onunknowndevice="webvr_onunknowndevice();"
+	        onentervr="webvr_onentervr();"
+	        onexitvr="webvr_onexitvr();"
+	        />
+
+	
+	<!-- a custom xml data structure with the supported VR headsets -->
+	<vrheadsets>
+		<headset name="cb1" caption="Cardboard A"   overlap="1.10" fov="96.0"  dist="1.00" dist2="1|0|0|0" ca="0.000" vig="100" />
+		<headset name="cb2" caption="Cardboard B"   overlap="1.00" fov="96.0"  dist="0.60" dist2="1|0|0|0" ca="0.000" vig="100" />
+		<headset name="gvr" caption="GearVR"        overlap="1.00" fov="112.0" dist="0.95" dist2="1|0|0|0" ca="0.090" vig="100" />
+		<headset name="hom" caption="HOMiDO"        overlap="1.00" fov="101.0" dist="1.10" dist2="1|0|0|0" ca="0.075" vig="100" />
+		<headset name="one" caption="VR ONE"        overlap="1.00" fov="109.9" dist="0.00" dist2="1.139|0.093|0.018|0.207" ca="0.090" vig="35" />
+		<headset name="ccr" caption="ColorCross VR" overlap="1.00" fov="70.0"  dist="0.65" dist2="1|0|0|0" ca="0.000" vig="100" />
+		<headset name="nod" caption="No Distortion" overlap="1.00" fov="96.0"  dist="0.00" dist2="1|0|0|0" ca="0.000" vig="100" />
+	</vrheadsets>
+
+
+	<!-- the VR cursor hotspot -->
+	<hotspot name="vr_cursor" keep="true"
+	         url="webvr_cursor_80x80_17f.png"
+	         visible="false"
+	         enabled="false"
+	         distorted="true"
+	         crop="0|0|80|80"
+	         scale="0.3"
+	         depth="1000"
+	         />
+
+
+	<!-- vr_auto_click() - call this action in the onover event of a
+	     hotspot to trigger automatically a click after some time.  -->
+	<action name="vr_auto_click">
+		if(webvr.isenabled,
+			if(%1 != null, set(vr_aclk_timeout, %1), set(vr_aclk_timeout, 2000));
+			copy(vr_aclk_t1, timertick);
+			set(vr_aclk_waiting, true);
+			copy(vr_aclk_hotspot, name);
+			set(hotspot[vr_cursor].crop,'0|0|80|80');
+
+			asyncloop(vr_aclk_waiting AND vr_aclk_hotspot == name,
+				sub(dt, timertick,vr_aclk_t1);
+
+				if(!hovering,
+					set(vr_aclk_waiting, false);
+					set(hotspot[vr_cursor].crop,'0|0|80|80');
+				  ,
+					div(f, dt, vr_aclk_timeout);
+					mul(f, 16);
+					roundval(f);
+					Math.min(f, 16);
+					mul(f, 80);
+
+					txtadd(hotspot[vr_cursor].crop,get(f),'|0|80|80');
+
+					<!-- wait another 100ms delay after finishing the animation before doing the click -->
+					sub(dt, 100);
+					if(dt GT vr_aclk_timeout,
+						set(vr_aclk_waiting,false);
+						set(hotspot[vr_cursor].crop,'0|0|80|80');
+						<!-- call onclick -->
+						onclick();
+					  );
+				  );
+				);
+		  );
+	</action>
+
+
+	<!-- by pressing SPACE the Oculus Rift could be re-centered -->
+	<events name="webvr_events" devices="html5" keep="true"
+	        onkeydown="if(webvr AND webvr.isenabled AND keycode==32, webvr.resetSensor() );"
+	        onmousedown="if(webvr AND webvr.isenabled, webvr_showbuttons() );"
+	        />
+
+
+	<!-- when WebVR support is available show an EnterVR button -->
+	<action name="webvr_onavailable">
+		webvr.loadsettings();
+		delayedcall(0.5, tween(layer[webvr_enterbutton].alpha,1.0); );
+	</action>
+	
+	
+	<action name="webvr_onunknowndevice">
+		if(webvr.isfake AND device.desktop AND webvr.havesettings == false,
+			<!-- set the 'no distortion' headset for fake desktop usage -->
+			set(webvr.mobilevr_lens_overlap, 1.0);
+			set(webvr.mobilevr_lens_fov, 96.0);
+			set(webvr.mobilevr_lens_dist, 0.0);
+			set(webvr.mobilevr_lens_dist2, '1|0|0|0');
+			set(webvr.mobilevr_lens_ca, 0.0);
+			set(webvr.mobilevr_lens_vign, 100);
+		  ,
+			set(ask_user_for_screensize,true);
+		  );
+	</action>
+
+
+	<action name="webvr_onentervr">
+		tween(layer[webvr_enterbutton].alpha,0,0);
+
+		webvr_showbuttons();
+		webvr_hide_all_non_vr_layers();
+
+		<!-- when the screen size is unknown an no custom size is set, open the setup screen on entering the VR mode -->
+		if(webvr.ismobilevr == true AND !webvr.isfake AND ask_user_for_screensize == true AND webvr.mobilevr_screensize == 'auto',
+			set(ask_user_for_screensize, false);
+			vr_setup();
+		  );
+		if(webvr.isfake,
+			webvr_show_fakemode_info(true);
+		  );
+	</action>
+
+
+	<action name="webvr_onexitvr">
+		stopdelayedcall(vr_button_fadeout);
+
+		tween(layer[webvr_enterbutton].alpha,1);
+		tween(layer[webvr_exitbutton].alpha,0);
+		tween(layer[webvr_setupbutton].alpha,0);
+		
+		webvr_show_fakemode_info(false);
+
+		webvr_restore_layers();
+	</action>
+
+
+	<action name="webvr_hide_all_non_vr_layers">
+		for(set(i,0), i LT layer.count, inc(i),
+			copy(lr, layer[get(i)]);
+			if(lr.vr !== true,
+				copy(lr.vr_backup_visible, lr.visible);
+				set(lr.visible, false);
+			  );
+		  );
+	</action>
+
+	<action name="webvr_restore_layers">
+		for(set(i,0), i LT layer.count, inc(i),
+			copy(lr, layer[get(i)]);
+			if(lr.vr_backup_visible,
+				copy(lr.visible, lr.vr_backup_visible);
+				delete(lr.vr_backup_visible);
+			  );
+		  );
+	</action>
+	
+	<action name="webvr_show_fakemode_info">
+		if('%1' == 'true',
+			addlayer(webvr_fakemode_info);
+			set(layer[webvr_fakemode_info].url, '%SWFPATH%/plugins/textfield.swf');
+			set(layer[webvr_fakemode_info].keep, true);
+			set(layer[webvr_fakemode_info].align, 'bottom');
+			set(layer[webvr_fakemode_info].y, 80);
+			set(layer[webvr_fakemode_info].background, false);
+			set(layer[webvr_fakemode_info].css, 'color:#FFFFFF;text-align:center;');
+			set(layer[webvr_fakemode_info].html, '[i][u]Simulated WebVR Mode![/u][/i][br]For real WebVR with headset tracking, either use a [a href="http://webvr.info" target="_blank" style="color:#FFFFFF;"]WebVR-API-capable[/a] desktop browser or a mobile device and a VR headset.');
+		  ,
+			removelayer(webvr_fakemode_info);
+		  );
+	</action>
+	
+	
+	<!-- ensure the same scaling on mobiles (regardless if mobilescale is 0.5 or 1.0) -->
+	<krpano webvr_setup_scale="calc:(1.0 + 1.0*(device.mobile AND stagescale LT 1.0)) / (1.0 + 1.0*device.mobile)"
+	        webvr_button_scale.normal="1.0"
+	        webvr_button_scale.mobile="1.6"
+	        />
+
+	
+	<!-- the EnterVR/ExitVR and SetupVR buttons -->
+	<style name="webvr_button_style"
+	       url="%SWFPATH%/plugins/textfield.swf"
+	       backgroundcolor="0x000000"
+	       backgroundalpha="0.5"
+	       roundedge="calc:9*webvr_setup_scale*webvr_button_scale"
+	       css="calc:'color:#FFFFFF;font-size:' + 20*webvr_setup_scale*webvr_button_scale + 'px;'"
+	       padding="calc:6*webvr_setup_scale*webvr_button_scale + ' ' + 10*webvr_setup_scale*webvr_button_scale"
+	       />
+	
+	<layer name="webvr_enterbutton" keep="true" vr="true"
+	       style="webvr_button_style"
+	       html="Enter VR"
+	       align="top" y="24"
+	       autoalpha="true" alpha="0.0"
+	       onclick="webvr.enterVR();"
+	       />
+
+	<layer name="webvr_exitbutton" keep="true" vr="true"
+	       style="webvr_button_style"
+	       html="Exit VR"
+	       align="top" y="24"
+	       autoalpha="true" alpha="0.0"
+	       onclick="webvr.exitVR();"
+	       />
+
+	<layer name="webvr_setupbutton" keep="true" vr="true"
+	       style="webvr_button_style"
+	       html="VR Setup"
+	       align="bottom" y="24"
+	       autoalpha="true" alpha="0.0"
+	       onclick="vr_setup()"
+	       />
+
+
+	<action name="webvr_showbuttons">
+		stopdelayedcall(vr_button_fadeout);
+		if(webvr.ismobilevr,
+			tween(layer[webvr_exitbutton].alpha|layer[webvr_setupbutton].alpha, 1.0|1.0, 0.25);
+			delayedcall(vr_button_fadeout, 3.0, tween(layer[webvr_exitbutton].alpha|layer[webvr_setupbutton].alpha, 0.0|0.0, 1.0); );
+		  ,
+			tween(layer[webvr_exitbutton].alpha, 1.0, 0.25);
+			delayedcall(vr_button_fadeout, 3.0, tween(layer[webvr_exitbutton].alpha, 0.0, 1.0); );
+		  );
+	</action>
+
+
+
+	<!--
+		VR Setup
+	-->
+
+	<action name="vr_setup">
+		<!-- disable cursor -->
+		set(webvr.vr_cursor_enabled, false);
+		
+		<!-- hide VR buttons -->
+		tween(layer[webvr_exitbutton].alpha,0);
+		tween(layer[webvr_setupbutton].alpha,0);
+		
+		<!-- create background layer -->
+		addlayer(vr_setup_bg);
+		set(layer[vr_setup_bg].type, container);
+		set(layer[vr_setup_bg].bgcolor, 0x000000);
+		set(layer[vr_setup_bg].bgalpha, 0.5);
+		set(layer[vr_setup_bg].bgcapture, true);
+		set(layer[vr_setup_bg].handcursor, false);
+		set(layer[vr_setup_bg].align, lefttop);
+		set(layer[vr_setup_bg].width, 100%);
+		set(layer[vr_setup_bg].height, 100%);
+		set(layer[vr_setup_bg].zorder, 99999);
+		
+		<!-- get and prepare device infos and settings -->
+		copy(i_screensize, webvr.mobilevr_screensize);
+		if(i_screensize == 'auto', copy(i_screensize, webvr.devicesize));
+		if(i_screensize LE 0, set(i_screensize, 5.0));
+		roundval(i_screensize, 1);
+		txtadd(i_screensize, ' inch');
+
+		copy(i_ipd, webvr.mobilevr_ipd);
+		roundval(i_ipd, 1);
+		txtadd(i_ipd, ' mm');
+
+		copy(i_fov, webvr.mobilevr_lens_fov);
+		roundval(i_fov, 1);
+
+		copy(i_dist, webvr.mobilevr_lens_dist);
+		roundval(i_dist, 2);
+		
+		copy(i_dist2, webvr.mobilevr_lens_dist2);
+		txtsplit(i_dist2, '|', i_dist2_k1, i_dist2_k2, i_dist2_k3, i_dist2_k4);
+		mul(i_dist2_k1,1);
+		mul(i_dist2_k2,10);
+		mul(i_dist2_k3,10);
+		mul(i_dist2_k4,10);
+		roundval(i_dist2_k1,2);
+		roundval(i_dist2_k2,2);
+		roundval(i_dist2_k3,2);
+		roundval(i_dist2_k4,2);
+
+		copy(i_vig, webvr.mobilevr_lens_vign);
+		roundval(i_vig, 0);
+		
+		copy(i_overlap, webvr.mobilevr_lens_overlap);
+		roundval(i_overlap, 2);
+		
+		copy(i_ca, webvr.mobilevr_lens_ca);
+		roundval(i_ca, 3);
+
+		set(i_headset, 'Custom');
+		for(set(i,0), i LT vrheadsets.headset.count, inc(i),
+			copy(hs, vrheadsets.headset[get(i)]);
+			if(i_overlap == hs.overlap AND i_fov == hs.fov AND i_dist == hs.dist AND i_dist2 == hs.dist2 AND i_ca == hs.ca AND i_vig == hs.vig , copy(i_headset, hs.caption));
+		   );
+
+		<!-- when the screen size is unknown, mark it red -->
+		set(known_size, true);
+		set(sizcol, #FFFFFF);
+		copy(i_devicename, webvr.devicename);
+		if(i_devicename == 'Unknown',
+			if(webvr.mobilevr_screensize == 'auto',
+				set(sizcol, #AA0000);
+				set(known_size, false);
+			  ,
+				set(i_devicename, 'Custom');
+			  );
+		  );
+
+		
+		<!-- create layer for the main menu -->
+		addlayer(vr_setup_m1);
+		set(layer[vr_setup_m1].type, container);
+		set(layer[vr_setup_m1].parent, vr_setup_bg);
+		set(layer[vr_setup_m1].align, lefttop);
+		set(layer[vr_setup_m1].width, 100%);
+		set(layer[vr_setup_m1].height, 100%);
+		
+		<!-- create layer for the headset customization menu -->
+		addlayer(vr_setup_m3);
+		set(layer[vr_setup_m3].type, container);
+		set(layer[vr_setup_m3].parent, vr_setup_bg);
+		set(layer[vr_setup_m3].align, lefttop);
+		set(layer[vr_setup_m3].width, 100%);
+		set(layer[vr_setup_m3].height, 100%);
+		set(layer[vr_setup_m3].visible, false);
+		
+		<!-- create layer for the calibration menu -->
+		addlayer(vr_setup_m2);
+		set(layer[vr_setup_m2].type, container);
+		set(layer[vr_setup_m2].parent, vr_setup_bg);
+		set(layer[vr_setup_m2].align, lefttop);
+		set(layer[vr_setup_m2].width, 100%);
+		set(layer[vr_setup_m2].height, 100%);
+		set(layer[vr_setup_m2].visible, false);
+		
+		<!-- create the text elements -->
+		set(vr_setup_text_parent, 'vr_setup_m1');
+		vr_setup_createtext(vr_setup_title, 'MOBILE VR SETUP',       center, center, 0, -225, #FFFFFF,     false);
+
+		vr_setup_createtext(vr_setup_dvn1, 'Device:',         center, right,  0, -145, #FFFFFF,     true, vr_setup_select('screen') );
+		vr_setup_createtext(vr_setup_dvn2, get(i_devicename), center, left,   0, -145, get(sizcol), true, vr_setup_select('screen') );
+		vr_setup_createtext(vr_setup_siz1, 'Screensize:',     center, right,  0, -105, #FFFFFF,     true, vr_setup_select('screen') );
+		vr_setup_createtext(vr_setup_siz2, get(i_screensize), center, left,   0, -105, get(sizcol), true, vr_setup_select('screen') );
+
+		vr_setup_createtext(vr_setup_ipd1, 'IPD:',            center, right,  0,  -35, #FFFFFF,     true, vr_setup_select('ipd') );
+		vr_setup_createtext(vr_setup_ipd2, get(i_ipd),        center, left,   0,  -35, #FFFFFF,     true, vr_setup_select('ipd') );
+
+		vr_setup_createtext(vr_setup_hmd1, 'VR Headset:',     center, right,  0,  +35, #FFFFFF,     true, vr_setup_select('headset') );
+		vr_setup_createtext(vr_setup_hmd2, get(i_headset),    center, left,   0,  +35, #FFFFFF,     true, vr_setup_select('headset') );
+		
+		vr_setup_createtext(vr_setup_hmd3, 'Customize',       center, center, 0,  +75, #FFFFFF,     true, set(background,true), set(background,false), vr_setup_customize_headset() );
+
+		
+
+		if(webvr.iswebvr == false,
+			vr_setup_createtext(vr_setup_cal, 'Calibrate Gyroscope',   center, center,    0, +145, #FFFFFF,     true, set(background,true), set(background,false), vr_setup_calibration() );
+		  );
+
+		vr_setup_createtext(vr_setup_sav, 'SAVE',          center, center, -200, +225, #FFFFFF,     true, set(background,true), set(background,false), vr_setup_save() );
+		vr_setup_createtext(vr_setup_rst, 'RESET',         center, center,    0, +225, #FFFFFF,     true, set(background,true), set(background,false), vr_setup_reset() );
+		vr_setup_createtext(vr_setup_cls, 'CLOSE',         center, center, +200, +225, #FFFFFF,     true, set(background,true), set(background,false), vr_setup_close() );
+		
+		<!-- and the adjusting buttons -->
+		vr_setup_createbutton(vr_setup_btn1, '&#60;', left,  left,  5%, -35, #FFFFFF, true, null);
+		vr_setup_createbutton(vr_setup_btn2, '&#62;', right, right, 5%, -35, #FFFFFF, true, null);
+		
+		
+		<!-- create the customize_headset text elements -->
+		set(vr_setup_text_parent, 'vr_setup_m3');
+		vr_setup_createtext(vr_setup_m31, 'VR HEADSET', center, center, 0, -225, #FFFFFF, false);
+		
+		vr_setup_createtext(vr_setup_fov1,  'FOV:',           center, right,  0,  -80,  #FFFFFF,    true, vr_setup_select('fov') );
+		vr_setup_createtext(vr_setup_fov2, get(i_fov),        center, left,   0,  -80,  #FFFFFF,    true, vr_setup_select('fov') );
+		vr_setup_createtext(vr_setup_dst1, 'Distortion:',     center, right,  0,  -32,  #FFFFFF,    true, vr_setup_select('dist') );
+		vr_setup_createtext(vr_setup_dst2, get(i_dist),       center, left,   0,  -32,  #FFFFFF,    true, vr_setup_select('dist') );
+		vr_setup_createtext(vr_setup_d2tx, 'Dist2:',          center, right,  0,  +16,  #FFFFFF,    true, vr_setup_select('dist2k1') );
+		vr_setup_createtext(vr_setup_d2k1, get(i_dist2_k1),   center, left,   0,  +16,  #FFFFFF,    true, vr_setup_select('dist2k1') );
+		vr_setup_createtext(vr_setup_d2k2, get(i_dist2_k2),   center, left, +100, +16,  #FFFFFF,    true, vr_setup_select('dist2k2') );
+		vr_setup_createtext(vr_setup_d2k3, get(i_dist2_k3),   center, left, +200, +16,  #FFFFFF,    true, vr_setup_select('dist2k3') );
+		vr_setup_createtext(vr_setup_d2k4, get(i_dist2_k4),   center, left, +300, +16,  #FFFFFF,    true, vr_setup_select('dist2k4') );
+		
+		
+		vr_setup_createtext(vr_setup_cac1, 'CA Corr:',        center, right,  0,  +64,  #FFFFFF,    true, vr_setup_select('ca') );
+		vr_setup_createtext(vr_setup_cac2, get(i_ca),         center, left,   0,  +64,  #FFFFFF,    true, vr_setup_select('ca') );
+		vr_setup_createtext(vr_setup_vig1, 'Vignette:',       center, right,  0, +112,  #FFFFFF,    true, vr_setup_select('vignette') );
+		vr_setup_createtext(vr_setup_vig2, get(i_vig),        center, left,   0, +112,  #FFFFFF,    true, vr_setup_select('vignette') );
+		vr_setup_createtext(vr_setup_olp1, 'Overlap:',        center, right,  0, +160,  #FFFFFF,    true, vr_setup_select('overlap') );
+		vr_setup_createtext(vr_setup_olp2, get(i_overlap),    center, left,   0, +160,  #FFFFFF,    true, vr_setup_select('overlap') );
+				
+		vr_setup_createtext(vr_setup_m35, 'CLOSE',       center, center, 0, +225, #FFFFFF, true, set(background,true), set(background,false), vr_setup_close_sub_menus() );
+		
+		
+		<!-- create the calibration text elements -->
+		set(vr_setup_text_parent, 'vr_setup_m2');
+		vr_setup_createtext(vr_setup_cb1, 'GYROSCOPE', center, center, 0, -225, #FFFFFF, false);
+		vr_setup_createtext(vr_setup_cb2, 'Place the device on a flat and[br]stable surface and tab calibrate[br]to correct a gyroscope drifting.', center, center, 0, -95, #FFFFFF, false, vr_setup_select('screen') );
+		vr_setup_createtext(vr_setup_cb3, 'CALIBRATE',   center, center, 0,  +55, #FFFFFF, true, set(background,true), set(background,false), vr_setup_do_calibration() );
+		vr_setup_createtext(vr_setup_cb4, 'RESET',       center, center, 0, +125, #FFFFFF, true, set(background,true), set(background,false), webvr.resetcalibration() );
+		vr_setup_createtext(vr_setup_cb5, 'CLOSE',       center, center, 0, +225, #FFFFFF, true, set(background,true), set(background,false), vr_setup_close_sub_menus() );
+		
+		vr_setup_createtext(vr_setup_cb6, 'Calibrating...',      bottom, center, 0, 40, #FFFFFF, false, null );
+		vr_setup_createtext(vr_setup_cb7, 'Calibration okay.',   bottom, center, 0, 40, #FFFFFF, false, null );
+		vr_setup_createtext(vr_setup_cb8, 'Calibration failed!', bottom, center, 0, 40, #FFFFFF, false, null );
+		set(layer[vr_setup_cb6].autoalpha, true);
+		set(layer[vr_setup_cb7].autoalpha, true);
+		set(layer[vr_setup_cb8].autoalpha, true);
+		set(layer[vr_setup_cb6].alpha, 0.0);
+		set(layer[vr_setup_cb7].alpha, 0.0);
+		set(layer[vr_setup_cb8].alpha, 0.0);
+		
+		
+		<!-- pre-select the screen size for adjusting when it is unknown, otherwise the IPD -->
+		if(known_size == false,
+			vr_setup_select('screen', true);
+		  ,
+			vr_setup_select('ipd', true);
+		  );
+	</action>
+
+
+	<action name="vr_setup_createtext">
+		<!--
+			%1 = name
+			%2 = text
+			%3 = align
+			%4 = edge
+			%5 = x
+			%6 = y
+			%7 = color
+			%8 = enabled
+			%9 = ondown
+			%10 = onup
+			%11 = onclick
+		-->
+		addlayer(%1);
+		set(layer[%1].parent, get(vr_setup_text_parent));
+		set(layer[%1].url, '%SWFPATH%/plugins/textfield.swf');
+		set(layer[%1].css, calc('text-align:%3;color:%7;font-size:'+40*webvr_setup_scale+'px;font-weight:bold;'));
+		set(layer[%1].padding, calc(0 + ' ' + 8*webvr_setup_scale));
+		set(layer[%1].roundedge, calc(8*webvr_setup_scale));
+		set(layer[%1].background, false);
+		set(layer[%1].backgroundcolor, 0xFFFFFF);
+		set(layer[%1].backgroundalpha, 0.25);
+		set(layer[%1].align, %3);
+		set(layer[%1].edge, %4);
+		set(layer[%1].x, calc(%5 * webvr_setup_scale));
+		set(layer[%1].y, calc(%6 * webvr_setup_scale));
+		set(layer[%1].html, %2);
+		set(layer[%1].enabled, %8);
+		set(layer[%1].ondown, %9);
+		set(layer[%1].onup, %10);
+		set(layer[%1].onclick, %11);
+	</action>
+
+
+	<action name="vr_setup_createbutton">
+		vr_setup_createtext(%1,%2,%3,%4,%5,%6,%7,%8,%9);
+		set(layer[%1].css, calc('vertical-align:middle;text-align:center;color:%7;font-size:'+60*webvr_setup_scale+'px;font-weight:bold;'));
+		set(layer[%1].background, true);
+		set(layer[%1].padding, 0);
+		set(layer[%1].roundedge, calc(40 * webvr_setup_scale));
+		set(layer[%1].width, calc(70 * webvr_setup_scale));
+		set(layer[%1].height, calc(70 * webvr_setup_scale));
+		set(layer[%1].vcenter, true);
+	</action>
+
+
+	<action name="vr_setup_reset">
+		<!-- reset to the defaults -->
+		set(webvr.mobilevr_screensize, 'auto');
+		copy(i_screensize, webvr.devicesize);
+		if(i_screensize LE 0, set(i_screensize, 5.0); );
+		roundval(i_screensize, 1);
+		set(layer[vr_setup_dvn2].html, get(webvr.devicename));
+		txtadd(layer[vr_setup_siz2].html, get(i_screensize), ' inch');
+
+		set(webvr.mobilevr_ipd, 63.5);
+		copy(i_ipd, webvr.mobilevr_ipd);
+		roundval(i_ipd, 1);
+		txtadd(layer[vr_setup_ipd2].html, get(i_ipd), ' mm');
+
+		<!-- set fake custom lens settings and call 'next' headset to switch to the default 'Cardboard' settings -->
+		set(webvr.mobilevr_lens_fov, 100);
+		set(webvr.mobilevr_lens_dist, 0.5);
+		set(webvr.mobilevr_lens_dist2, '1|0|0|0');
+		set(webvr.mobilevr_lens_vign, 100);
+		set(webvr.mobilevr_lens_overlap, 1.0);
+		set(webvr.mobilevr_lens_ca, 0.0);
+		
+		if(webvr.isfake AND device.desktop,
+			<!-- select 'no distortion' headset for fake desktop usage -->
+			vr_setup_change_headset(-1);
+		  ,
+			<!-- select 'Cardboard A' headset for Mobile-VR usage -->
+			vr_setup_change_headset(+1);	
+		  );
+
+		vr_setup_select(get(selected_var));
+	</action>
+
+
+	<action name="vr_setup_close">
+		<!-- 2. parameter == true => remove children elements too -->
+		removelayer(vr_setup_bg, true);
+		
+		<!-- enable cursor -->
+		set(webvr.vr_cursor_enabled, true);
+	</action>
+
+
+	<action name="vr_setup_save">
+		webvr.saveSettings();
+		vr_setup_close();
+	</action>
+	
+	
+	<action name="vr_setup_customize_headset">
+		set(layer[vr_setup_bg].bgalpha, 0.1);
+		
+		set(layer[vr_setup_m1].visible,false);
+		set(layer[vr_setup_m2].visible,false);
+		set(layer[vr_setup_m3].visible,true);
+		
+		set(layer[vr_setup_hmd1].parent, vr_setup_m3);
+		set(layer[vr_setup_hmd2].parent, vr_setup_m3);
+		set(layer[vr_setup_btn1].parent, vr_setup_m3);
+		set(layer[vr_setup_btn2].parent, vr_setup_m3);
+		
+		set(layer[vr_setup_hmd1].y, calc(-145 * webvr_setup_scale));
+		set(layer[vr_setup_hmd2].y, calc(-145 * webvr_setup_scale));
+		
+		copy(old_selection, selected_var);
+		vr_setup_select('headset');
+	</action>
+	
+	
+
+	<action name="vr_setup_calibration">
+		set(layer[vr_setup_m1].visible,false);
+		set(layer[vr_setup_m2].visible,true);
+	</action>
+	
+	<action name="vr_setup_close_sub_menus">
+		set(layer[vr_setup_bg].bgalpha, 0.5);
+		
+		set(layer[vr_setup_m1].visible,true);
+		set(layer[vr_setup_m2].visible,false);
+		set(layer[vr_setup_m3].visible,false);
+		
+		set(layer[vr_setup_hmd1].parent, vr_setup_m1);
+		set(layer[vr_setup_hmd2].parent, vr_setup_m1);
+		set(layer[vr_setup_btn1].parent, vr_setup_m1);
+		set(layer[vr_setup_btn2].parent, vr_setup_m1);
+		
+		set(layer[vr_setup_hmd1].y, calc(+35 * webvr_setup_scale));
+		set(layer[vr_setup_hmd2].y, calc(+35 * webvr_setup_scale));
+		
+		if(old_selection,
+			vr_setup_select(get(old_selection));
+			delete(old_selection);
+		  );
+	</action>
+	
+	<action name="vr_setup_do_calibration">
+		if(!webvr.isfake,
+			tween(layer[vr_setup_cb6].alpha, 1.0, 0.1);
+			tween(layer[vr_setup_cb7].alpha, 0.0, 0.1);
+			tween(layer[vr_setup_cb8].alpha, 0.0, 0.1);
+			webvr.calibrate(
+				tween(layer[vr_setup_cb6].alpha, 0.0, 0.1);
+				tween(layer[vr_setup_cb7].alpha, 1.0, 0.1);
+				delayedcall(2.0, tween(layer[vr_setup_cb7].alpha, 0.0, 0.25) );
+			  ,
+				tween(layer[vr_setup_cb6].alpha, 0.0, 0.1);
+				tween(layer[vr_setup_cb8].alpha, 1.0, 0.1);
+				delayedcall(2.0, tween(layer[vr_setup_cb8].alpha, 0.0, 0.25) );
+			  );
+		  );
+	</action>
+
+	<action name="vr_setup_update_dist2">
+		txtadd(webvr.mobilevr_lens_dist2, get(i_dist2_k1), '|', calc(i_dist2_k2/10.0), '|', calc(i_dist2_k3/10.0), '|', calc(i_dist2_k4/10.0));
+		vr_setup_change_headset(0);
+	</action>
+
+	<action name="vr_setup_select">
+		<!-- select a setting for adjusting -->
+		set(layer[vr_setup_siz2].background, false);
+		set(layer[vr_setup_ipd2].background, false);
+		set(layer[vr_setup_hmd2].background, false);
+		set(layer[vr_setup_fov2].background, false);
+		set(layer[vr_setup_dst2].background, false);
+		set(layer[vr_setup_d2k1].background, false);
+		set(layer[vr_setup_d2k2].background, false);
+		set(layer[vr_setup_d2k3].background, false);
+		set(layer[vr_setup_d2k4].background, false);
+		set(layer[vr_setup_vig2].background, false);
+		set(layer[vr_setup_cac2].background, false);
+		set(layer[vr_setup_olp2].background, false);
+
+		set(selected_setting, null);
+		delete(selected_var_value);
+
+		set(layer[vr_setup_btn1].ondown, vr_setup_change_ondown(-1) );
+		set(layer[vr_setup_btn2].ondown, vr_setup_change_ondown(+1) );
+		set(selected_var_callback, null);
+
+		set(selected_var, %1);
+
+		if(selected_var == 'screen',
+			set(selected_setting,      vr_setup_siz2);
+			set(selected_var_name,     'webvr.mobilevr_screensize');
+			set(selected_var_postfix,  ' inch');
+			copy(selected_var_value,   get(selected_var_name));
+			if(selected_var_value == 'auto', copy(selected_var_value, webvr.devicesize));
+			if(selected_var_value LE 0, set(selected_var_value, 5.0));
+			set(selected_var_step,     0.1);
+			set(selected_var_min,      4);
+			set(selected_var_max,      10);
+			set(selected_var_round,    1);
+			set(selected_var_callback, vr_setup_change_screen() );
+		  );
+
+		if(selected_var == 'ipd',
+			set(selected_setting,      vr_setup_ipd2);
+			set(selected_var_name,     'webvr.mobilevr_ipd');
+			set(selected_var_postfix,  ' mm');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     0.1);
+			set(selected_var_min,      40);
+			set(selected_var_max,      80);
+			set(selected_var_round,    1);
+		  );
+
+		if(selected_var == 'headset',
+			set(selected_setting,      vr_setup_hmd2);
+			set(layer[vr_setup_btn1].ondown, vr_setup_change_headset(-1) );
+			set(layer[vr_setup_btn2].ondown, vr_setup_change_headset(+1) );
+		  );
+
+		if(selected_var == 'fov',
+			set(selected_setting,      vr_setup_fov2);
+			set(selected_var_name,     'webvr.mobilevr_lens_fov');
+			set(selected_var_postfix,  '');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     0.1);
+			set(selected_var_min,      40);
+			set(selected_var_max,      179);
+			set(selected_var_round,    1);
+			set(selected_var_callback, vr_setup_change_headset(0) );
+		  );
+
+		if(selected_var == 'dist',
+			set(selected_setting,      vr_setup_dst2);
+			set(selected_var_name,     'webvr.mobilevr_lens_dist');
+			set(selected_var_postfix,  '');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     0.01);
+			set(selected_var_min,      0);
+			set(selected_var_max,      5);
+			set(selected_var_round,    2);
+			set(selected_var_callback, vr_setup_change_headset(0) );
+		  );
+		
+		if(selected_var == 'dist2k1',
+			set(selected_setting,      vr_setup_d2k1);
+			set(selected_var_name,     'i_dist2_k1');
+			set(selected_var_postfix,  '');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     0.01);
+			set(selected_var_min,      -9);
+			set(selected_var_max,      +9);
+			set(selected_var_round,    2);
+			set(selected_var_callback, vr_setup_update_dist2() );
+		  );
+		
+		if(selected_var == 'dist2k2',
+			set(selected_setting,      vr_setup_d2k2);
+			set(selected_var_name,     'i_dist2_k2');
+			set(selected_var_postfix,  '');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     0.01);
+			set(selected_var_min,      -9);
+			set(selected_var_max,      +9);
+			set(selected_var_round,    2);
+			set(selected_var_callback, vr_setup_update_dist2() );
+		  );
+		
+		if(selected_var == 'dist2k3',
+			set(selected_setting,      vr_setup_d2k3);
+			set(selected_var_name,     'i_dist2_k3');
+			set(selected_var_postfix,  '');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     0.01);
+			set(selected_var_min,      -9);
+			set(selected_var_max,      +9);
+			set(selected_var_round,    2);
+			set(selected_var_callback, vr_setup_update_dist2() );
+		  );
+
+		if(selected_var == 'dist2k4',
+			set(selected_setting,      vr_setup_d2k4);
+			set(selected_var_name,     'i_dist2_k4');
+			set(selected_var_postfix,  '');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     0.01);
+			set(selected_var_min,      -9);
+			set(selected_var_max,      +9);
+			set(selected_var_round,    2);
+			set(selected_var_callback, vr_setup_update_dist2() );
+		  );
+
+		if(selected_var == 'vignette',
+			set(selected_setting,      vr_setup_vig2);
+			set(selected_var_name,     'webvr.mobilevr_lens_vign');
+			set(selected_var_postfix,  '');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     1);
+			set(selected_var_min,      10);
+			set(selected_var_max,      200);
+			set(selected_var_round,    0);
+			set(selected_var_callback, vr_setup_change_headset(0) );
+		  );
+
+		if(selected_var == 'ca',
+			set(selected_setting,      vr_setup_cac2);
+			set(selected_var_name,     'webvr.mobilevr_lens_ca');
+			set(selected_var_postfix,  '');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     0.01);
+			set(selected_var_min,      -1.0);
+			set(selected_var_max,      +1.0);
+			set(selected_var_round,    2);
+			set(selected_var_callback, vr_setup_change_headset(0) );
+		  );
+		  
+		if(selected_var == 'overlap',
+			set(selected_setting,      vr_setup_olp2);
+			set(selected_var_name,     'webvr.mobilevr_lens_overlap');
+			set(selected_var_postfix,  '');
+			copy(selected_var_value,   get(selected_var_name));
+			set(selected_var_step,     0.01);
+			set(selected_var_min,      0.5);
+			set(selected_var_max,      2.0);
+			set(selected_var_round,    2);
+			set(selected_var_callback, vr_setup_change_headset(0) );
+		  );
+
+		if(selected_setting != null,
+			set(layer[get(selected_setting)].background, true);
+			if(%2 == true,
+				set(layer[vr_setup_btn1].y, get(layer[get(selected_setting)].y));
+				set(layer[vr_setup_btn2].y, get(layer[get(selected_setting)].y));
+			  ,
+				tween(layer[vr_setup_btn1].y, get(layer[get(selected_setting)].y));
+				tween(layer[vr_setup_btn2].y, get(layer[get(selected_setting)].y));
+			  );
+		  );
+	</action>
+
+
+	<action name="vr_setup_change_screen">
+		set(layer[vr_setup_dvn2].html, 'Custom');
+		set(layer[vr_setup_dvn2].css, calc('color:#FFFFFF;font-size:'+40*webvr_setup_scale+'px;font-weight:bold;'));
+		set(layer[vr_setup_siz2].css, calc('color:#FFFFFF;font-size:'+40*webvr_setup_scale+'px;font-weight:bold;'));
+	</action>
+
+
+	<action name="vr_setup_change_ondown">
+		copy(t0,timertick);
+		set(t1,0);
+		asyncloop(pressed,
+			copy(t2,timertick);
+			sub(dt,t2,t1);
+			if(dt GT 100,
+				copy(t1,t2);
+				sub(dt,t1,t0);
+				div(dt,1000);
+				Math.max(dt,1);
+				mul(dt,%1);
+				vr_setup_adjust(get(dt));
+			  );
+		  );
+	</action>
+
+
+	<action name="vr_setup_adjust">
+		if(selected_setting != null,
+			mul(change, selected_var_step, %1);
+			add(selected_var_value, change);
+			Math.max(selected_var_value, selected_var_min);
+			Math.min(selected_var_value, selected_var_max);
+			roundval(selected_var_value, get(selected_var_round));
+			tween(get(selected_var_name), get(selected_var_value), 0.1);
+			txtadd(layer[get(selected_setting)].html, get(selected_var_value), get(selected_var_postfix));
+			if(selected_var_callback != null, selected_var_callback());
+		  );
+	</action>
+
+
+	<action name="vr_setup_change_headset">
+		set(i_headset, 'Custom');
+		if(%1 != 0,
+			copy(i_fov, webvr.mobilevr_lens_fov);
+			roundval(i_fov, 1);
+			copy(i_dist, webvr.mobilevr_lens_dist);
+			roundval(i_dist, 2);
+			copy(i_dist2, webvr.mobilevr_lens_dist2);
+			copy(i_vig, webvr.mobilevr_lens_vign);
+			roundval(i_vig, 0);
+			copy(i_ca, webvr.mobilevr_lens_ca);
+			roundval(i_ca, 3);
+			copy(i_overlap, webvr.mobilevr_lens_overlap);
+			roundval(i_overlap, 2);
+			set(i_hsindex, -1);
+			copy(i_hscount, vrheadsets.headset.count);
+			for(set(i,0), i LT i_hscount, inc(i),
+				copy(hs, vrheadsets.headset[get(i)]);
+				if(i_overlap == hs.overlap AND i_fov == hs.fov AND i_dist == hs.dist AND i_dist2 == hs.dist2 AND i_ca == hs.ca AND i_vig == hs.vig , copy(i_hsindex, i); copy(i_headset, hs.caption); );
+			   );
+
+			if(%1 GT 0,
+				<!-- loop right -->
+				add(i_hsindex, 1);
+				if(i_hsindex GE i_hscount, set(i_hsindex,0));
+			  ,
+				<!-- loop left -->
+				sub(i_hsindex, 1);
+				if(i_hsindex LT 0, sub(i_hsindex,i_hscount,1));
+			  );
+
+			copy(hs, vrheadsets.headset[get(i_hsindex)]);
+			copy(i_headset, hs.caption);
+			copy(i_overlap, hs.overlap);
+			copy(i_fov,     hs.fov);
+			copy(i_dist,    hs.dist);
+			copy(i_dist2,   hs.dist2);
+			copy(i_ca,      hs.ca);
+			copy(i_vig,     hs.vig);
+		  );
+
+		copy(layer[vr_setup_hmd2].html, i_headset);
+		if(%1 != 0,
+			copy(webvr.mobilevr_lens_overlap, i_overlap);
+			copy(webvr.mobilevr_lens_fov, i_fov);
+			copy(webvr.mobilevr_lens_dist, i_dist);
+			copy(webvr.mobilevr_lens_dist2, i_dist2);
+			copy(webvr.mobilevr_lens_ca, i_ca);
+			copy(webvr.mobilevr_lens_vign, i_vig);
+			copy(layer[vr_setup_olp2].html, i_overlap);
+			copy(layer[vr_setup_fov2].html, i_fov);
+			copy(layer[vr_setup_dst2].html, i_dist);
+			
+			txtsplit(i_dist2, '|', i_dist2_k1, i_dist2_k2, i_dist2_k3, i_dist2_k4);
+			mul(i_dist2_k1,1);
+			mul(i_dist2_k2,10);
+			mul(i_dist2_k3,10);
+			mul(i_dist2_k4,10);
+			roundval(i_dist2_k1,2);
+			roundval(i_dist2_k2,2);
+			roundval(i_dist2_k3,2);
+			roundval(i_dist2_k4,2);
+			copy(layer[vr_setup_d2k1].html, i_dist2_k1);
+			copy(layer[vr_setup_d2k2].html, i_dist2_k2);
+			copy(layer[vr_setup_d2k3].html, i_dist2_k3);
+			copy(layer[vr_setup_d2k4].html, i_dist2_k4);
+			
+			copy(layer[vr_setup_cac2].html, i_ca);
+			copy(layer[vr_setup_vig2].html, i_vig);
+		  );
+	</action>
+
+</krpano>

packages/docs/public/party.xml

@@ -0,0 +1,22 @@
+<krpano version="1.19" title="">
+
+	<scene name="scene_party" title="湖南党史陈列馆" onstart="" thumburl="https://houseoss.4dkankan.com/project/leifeng-transfer/panos/party.tiles/thumb.jpg" lat="28.20631294" lng="112.83942033" heading="0.0">
+
+		<view hlookat="0.0" vlookat="0.0" fovtype="MFOV" fov="120" maxpixelzoom="2.0" fovmin="70" fovmax="140" limitview="auto" />
+
+		<preview url="https://houseoss.4dkankan.com/project/leifeng-transfer/panos/party.tiles/preview.jpg" />
+
+		<image type="CUBE" prealign="0|0.0|0" multires="true" tilesize="512">
+			<level tiledimagewidth="2624" tiledimageheight="2624">
+				<cube url="https://houseoss.4dkankan.com/project/leifeng-transfer/panos/party.tiles/%s/l3/%v/l3_%s_%v_%h.jpg" />
+			</level>
+			<level tiledimagewidth="1280" tiledimageheight="1280">
+				<cube url="https://houseoss.4dkankan.com/project/leifeng-transfer/panos/party.tiles/%s/l2/%v/l2_%s_%v_%h.jpg" />
+			</level>
+			<level tiledimagewidth="640" tiledimageheight="640">
+				<cube url="https://houseoss.4dkankan.com/project/leifeng-transfer/panos/party.tiles/%s/l1/%v/l1_%s_%v_%h.jpg" />
+			</level>
+		</image>
+
+	</scene>
+</krpano>

packages/hooks/babel.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  presets: [
+    ["@babel/preset-env", { targets: { node: "current" } }],
+    "@babel/preset-typescript",
+  ],
+};

packages/hooks/jest.config.js

@@ -0,0 +1,198 @@
+/*
+ * For a detailed explanation regarding each configuration property, visit:
+ * https://jestjs.io/docs/configuration
+ */
+
+module.exports = {
+  // All imported modules in your tests should be mocked automatically
+  // automock: false,
+
+  // Stop running tests after `n` failures
+  // bail: 0,
+
+  // The directory where Jest should store its cached dependency information
+  // cacheDirectory: "/tmp/jest_rs",
+
+  // Automatically clear mock calls and instances between every test
+  // clearMocks: false,
+
+  // Indicates whether the coverage information should be collected while executing the test
+  // collectCoverage: false,
+
+  // An array of glob patterns indicating a set of files for which coverage information should be collected
+  // collectCoverageFrom: undefined,
+
+  // The directory where Jest should output its coverage files
+  // coverageDirectory: undefined,
+
+  // An array of regexp pattern strings used to skip coverage collection
+  // coveragePathIgnorePatterns: [
+  //   "/node_modules/"
+  // ],
+
+  // Indicates which provider should be used to instrument code for coverage
+  // coverageProvider: "babel",
+
+  // A list of reporter names that Jest uses when writing coverage reports
+  // coverageReporters: [
+  //   "json",
+  //   "text",
+  //   "lcov",
+  //   "clover"
+  // ],
+
+  // An object that configures minimum threshold enforcement for coverage results
+  // coverageThreshold: undefined,
+
+  // A path to a custom dependency extractor
+  // dependencyExtractor: undefined,
+
+  // Make calling deprecated APIs throw helpful error messages
+  // errorOnDeprecated: false,
+
+  // Force coverage collection from ignored files using an array of glob patterns
+  // forceCoverageMatch: [],
+
+  // A path to a module which exports an async function that is triggered once before all test suites
+  // globalSetup: undefined,
+
+  // A path to a module which exports an async function that is triggered once after all test suites
+  // globalTeardown: undefined,
+
+  // A set of global variables that need to be available in all test environments
+  // globals: {},
+
+  // The maximum amount of workers used to run your tests. Can be specified as % or a number. E.g. maxWorkers: 10% will use 10% of your CPU amount + 1 as the maximum worker number. maxWorkers: 2 will use a maximum of 2 workers.
+  // maxWorkers: "50%",
+
+  // An array of directory names to be searched recursively up from the requiring module's location
+  // moduleDirectories: [
+  //   "node_modules"
+  // ],
+
+  // An array of file extensions your modules use
+  // moduleFileExtensions: [
+  //   "js",
+  //   "jsx",
+  //   "ts",
+  //   "tsx",
+  //   "json",
+  //   "node"
+  // ],
+
+  // A map from regular expressions to module names or to arrays of module names that allow to stub out resources with a single module
+  // moduleNameMapper: {
+  //   '\\?url$': '<rootDir>/__mocks__/urlMock.js',
+  //   '\\.(png|jpg|jpeg|gif|svg)$': '<rootDir>/__mocks__/urlMock.js',
+  //   '\\.scss$': '<rootDir>/__mocks__/scssMock.js',
+  // },
+
+  // An array of regexp pattern strings, matched against all module paths before considered 'visible' to the module loader
+  // modulePathIgnorePatterns: [],
+
+  // Activates notifications for test results
+  // notify: false,
+
+  // An enum that specifies notification mode. Requires { notify: true }
+  // notifyMode: "failure-change",
+
+  // A preset that is used as a base for Jest's configuration
+  // preset: undefined,
+
+  // Run tests from one or more projects
+  // projects: undefined,
+
+  // Use this configuration option to add custom reporters to Jest
+  // reporters: undefined,
+
+  // Automatically reset mock state between every test
+  // resetMocks: false,
+
+  // Reset the module registry before running each individual test
+  // resetModules: false,
+
+  // A path to a custom resolver
+  // resolver: undefined,
+
+  // Automatically restore mock state between every test
+  // restoreMocks: false,
+
+  // The root directory that Jest should scan for tests and modules within
+  // rootDir: undefined,
+
+  // A list of paths to directories that Jest should use to search for files in
+  // roots: [
+  //   "<rootDir>"
+  // ],
+
+  // Allows you to use a custom runner instead of Jest's default test runner
+  // runner: "jest-runner",
+
+  // The paths to modules that run some code to configure or set up the testing environment before each test
+  // setupFiles: [],
+
+  // A list of paths to modules that run some code to configure or set up the testing framework before each test
+  // setupFilesAfterEnv: [],
+
+  // The number of seconds after which a test is considered as slow and reported as such in the results.
+  // slowTestThreshold: 5,
+
+  // A list of paths to snapshot serializer modules Jest should use for snapshot testing
+  // snapshotSerializers: [],
+
+  // The test environment that will be used for testing
+  testEnvironment: "jsdom",
+
+  // Options that will be passed to the testEnvironment
+  // testEnvironmentOptions: {},
+
+  // Adds a location field to test results
+  // testLocationInResults: false,
+
+  // The glob patterns Jest uses to detect test files
+  // testMatch: [
+  //   "**/__tests__/**/*.[jt]s?(x)",
+  //   "**/?(*.)+(spec|test).[tj]s?(x)"
+  // ],
+
+  // An array of regexp pattern strings that are matched against all test paths, matched tests are skipped
+  // testPathIgnorePatterns: [
+  //   "/node_modules/"
+  // ],
+
+  // The regexp pattern or array of patterns that Jest uses to detect test files
+  // testRegex: [],
+
+  // This option allows the use of a custom results processor
+  // testResultsProcessor: undefined,
+
+  // This option allows use of a custom test runner
+  // testRunner: "jest-circus/runner",
+
+  // This option sets the URL for the jsdom environment. It is reflected in properties such as location.href
+  // testURL: "http://localhost",
+
+  // Setting this value to "fake" allows the use of fake timers for functions such as "setTimeout"
+  // timers: "real",
+
+  // A map from regular expressions to paths to transformers
+  // transform: undefined,
+
+  // An array of regexp pattern strings that are matched against all source file paths, matched files will skip transformation
+  transformIgnorePatterns: [
+    "node_modules\\/(?!\\.pnpm|strip-json-comments|@dage)",
+    "\\.pnp\\.[^\\/]+$",
+  ],
+
+  // An array of regexp pattern strings that are matched against all modules before the module loader will automatically return a mock for them
+  // unmockedModulePathPatterns: undefined,
+
+  // Indicates whether each individual test should be reported during the run
+  // verbose: undefined,
+
+  // An array of regexp patterns that are matched against all source file paths before re-running tests in watch mode
+  // watchPathIgnorePatterns: [],
+
+  // Whether to use watchman for file crawling
+  // watchman: true,
+};

packages/hooks/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@dage/hooks",
+  "version": "1.0.0",
+  "description": "React hooks 集合",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "start": "tsc -b tsconfig.build.json --watch",
+    "prebuild": "rimraf dist",
+    "build": "tsc -b tsconfig.build.json",
+    "test": "jest",
+    "type-check": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.22.10",
+    "@babel/preset-env": "^7.22.10",
+    "@babel/preset-typescript": "^7.22.5",
+    "@testing-library/react-hooks": "^8.0.1",
+    "babel-jest": "^29.6.2",
+    "jest": "^29.6.2"
+  },
+  "peerDependencies": {
+    "react": ">=17"
+  },
+  "license": "MIT"
+}

packages/hooks/src/index.ts

@@ -0,0 +1 @@
+export * from "./useCreate";

packages/hooks/src/useCreate.ts

@@ -0,0 +1,12 @@
+import { useRef } from "react";
+
+/**
+ * 在组件首次创建时调用
+ */
+export function useCreate(cb: Function) {
+  const initialized = useRef(false);
+  if (!initialized.current) {
+    initialized.current = true;
+    cb();
+  }
+}

packages/hooks/tsconfig.build.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false
+  },
+  "exclude": ["dist", "node_modules", "*.d.ts", "**/*.test.*"]
+}

packages/hooks/tsconfig.json

@@ -0,0 +1,73 @@
+{
+  "compilerOptions": {
+    /* Visit https://aka.ms/tsconfig.json to read more about this file */
+
+    /* Basic Options */
+    // "incremental": true,                         /* Enable incremental compilation */
+    "target": "ES2015" /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'ES2020', 'ES2021', or 'ESNEXT'. */,
+    "module": "ESNext" /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */,
+    // "lib": [],                                   /* Specify library files to be included in the compilation. */
+    // "allowJs": true,                             /* Allow javascript files to be compiled. */
+    // "checkJs": true,                             /* Report errors in .js files. */
+    "jsx": "react" /* Specify JSX code generation: 'preserve', 'react-native', 'react', 'react-jsx' or 'react-jsxdev'. */,
+    "declaration": true /* Generates corresponding '.d.ts' file. */,
+    "declarationMap": true /* Generates a sourcemap for each corresponding '.d.ts' file. */,
+    "sourceMap": false /* Generates corresponding '.map' file. */,
+    // "outFile": "./",                             /* Concatenate and emit output to single file. */
+    "outDir": "./dist" /* Redirect output structure to the directory. */,
+    "rootDir": "./src" /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */,
+    // "composite": true,                           /* Enable project compilation */
+    // "tsBuildInfoFile": "./",                     /* Specify file to store incremental compilation information */
+    // "removeComments": true,                      /* Do not emit comments to output. */
+    "noEmit": true /* Do not emit outputs. */,
+    "importHelpers": true /* Import emit helpers from 'tslib'. */,
+    // "downlevelIteration": true,                  /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */
+    // "isolatedModules": true,                     /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */
+
+    /* Strict Type-Checking Options */
+    "strict": true /* Enable all strict type-checking options. */,
+    // "noImplicitAny": true,                       /* Raise error on expressions and declarations with an implied 'any' type. */
+    // "strictNullChecks": true,                    /* Enable strict null checks. */
+    // "strictFunctionTypes": true,                 /* Enable strict checking of function types. */
+    // "strictBindCallApply": true,                 /* Enable strict 'bind', 'call', and 'apply' methods on functions. */
+    // "strictPropertyInitialization": true,        /* Enable strict checking of property initialization in classes. */
+    // "noImplicitThis": true,                      /* Raise error on 'this' expressions with an implied 'any' type. */
+    // "alwaysStrict": true,                        /* Parse in strict mode and emit "use strict" for each source file. */
+
+    /* Additional Checks */
+    "noUnusedLocals": true /* Report errors on unused locals. */,
+    // "noUnusedParameters": true,                  /* Report errors on unused parameters. */
+    // "noImplicitReturns": true,                   /* Report error when not all code paths in function return a value. */
+    "noFallthroughCasesInSwitch": true /* Report errors for fallthrough cases in switch statement. */,
+    // "noUncheckedIndexedAccess": true,            /* Include 'undefined' in index signature results */
+    "noImplicitOverride": true /* Ensure overriding members in derived classes are marked with an 'override' modifier. */,
+    // "noPropertyAccessFromIndexSignature": true,  /* Require undeclared properties from index signatures to use element accesses. */
+
+    /* Module Resolution Options */
+    "moduleResolution": "node" /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */,
+    // "baseUrl": "./",                             /* Base directory to resolve non-absolute module names. */
+    // "paths": {},                                 /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */
+    // "rootDirs": [],                              /* List of root folders whose combined content represents the structure of the project at runtime. */
+    // "typeRoots": [],                             /* List of folders to include type definitions from. */
+    // "types": [],                                 /* Type declaration files to be included in compilation. */
+    "allowSyntheticDefaultImports": true /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */,
+    "esModuleInterop": true /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */,
+    // "preserveSymlinks": true,                    /* Do not resolve the real path of symlinks. */
+    // "allowUmdGlobalAccess": true,                /* Allow accessing UMD globals from modules. */
+
+    /* Source Map Options */
+    // "sourceRoot": "",                            /* Specify the location where debugger should locate TypeScript files instead of source locations. */
+    // "mapRoot": "",                               /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSourceMap": true,                     /* Emit a single file with source maps instead of having a separate file. */
+    // "inlineSources": true,                       /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */
+
+    /* Experimental Options */
+    // "experimentalDecorators": true,              /* Enables experimental support for ES7 decorators. */
+    // "emitDecoratorMetadata": true,               /* Enables experimental support for emitting type metadata for decorators. */
+
+    /* Advanced Options */
+    "skipLibCheck": true /* Skip type checking of declaration files. */,
+    "forceConsistentCasingInFileNames": true /* Disallow inconsistently-cased references to the same file. */
+  },
+  "exclude": ["dist", "node_modules", "*.d.ts"]
+}

packages/krpano/babel.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+  presets: [
+    ["@babel/preset-env", { targets: { node: "current" } }],
+    "@babel/preset-typescript",
+    "@babel/preset-react",
+  ],
+};

packages/krpano/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@dage/krpano",
+  "version": "0.0.1",
+  "description": "krpano sdk",
+  "module": "dist/index.js",
+  "main": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "start": "tsc --build tsconfig.build.json --watch",
+    "prebuild": "rimraf dist",
+    "build": "tsc --build tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "test": "jest"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.22.10",
+    "@babel/preset-env": "^7.22.10",
+    "@babel/preset-typescript": "^7.22.5",
+    "@types/escape-html": "^1.0.2",
+    "@types/react": "^18.2.20",
+    "babel-jest": "^29.6.2",
+    "jest": "^29.6.2"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@dage/hooks": "workspace:^",
+    "escape-html": "^1.0.3"
+  }
+}

packages/krpano/src/KrpanoActionProxy.ts

@@ -0,0 +1,261 @@
+import { PromiseQueue } from "./PromiseQueue";
+import { ViewProps } from "./components";
+import {
+  NativeKrpanoRendererObject,
+  ROTATE_DIRECTION,
+  ZOOM_ACTION,
+} from "./types";
+import { buildKrpanoAction, buildKrpanoTagSetterActions } from "./utils";
+
+export type HandlerFunc = (renderer: KrpanoActionProxy) => void;
+
+interface EventHandler {
+  eventName: string;
+  selector: string;
+  handler: HandlerFunc;
+}
+
+export class KrpanoActionProxy {
+  name: string;
+  krpanoRenderer?: NativeKrpanoRendererObject;
+  eventHandlers: EventHandler[] = [];
+  dynamicTagWaitQueue: PromiseQueue<any>;
+
+  constructor(
+    krpanoRenderer?: NativeKrpanoRendererObject,
+    name = "ReactKrpanoActionProxy"
+  ) {
+    this.krpanoRenderer = krpanoRenderer;
+    this.name = name;
+
+    // krpano 1.19 版本不支持动态插入 include，只能在文本中插入后重新加载
+    this.dynamicTagWaitQueue = new PromiseQueue();
+  }
+
+  waitIncludeLoad() {
+    return this.syncTagsLoaded
+      ? Promise.resolve()
+      : this.dynamicTagWaitQueue.push();
+  }
+
+  /**
+   * 执行 Javascript 函数
+   * @param action 动作
+   * @param nexttick 是否在下一个渲染帧后执行
+   */
+  call(action: string, nexttick = false): void {
+    const actionStr = nexttick ? `nexttick(${action})` : action;
+
+    this.krpanoRenderer?.call(actionStr);
+  }
+
+  set(name: string, ...params: Array<string | number | boolean>): void {
+    this.call(buildKrpanoAction("set", name, ...params));
+  }
+
+  /**
+   * 动态添加标签
+   * @param tag 标签
+   * @param name 名称
+   * @param attrs 属性
+   */
+  async setTag(
+    tag: "scene" | "hotspot" | "layer" | "view" | "events" | "autorotate",
+    name: string | null,
+    attrs: Record<string, any>
+  ) {
+    let nexttick = false;
+
+    if (tag === "hotspot" || tag === "events") {
+      nexttick = true;
+    }
+
+    await this.waitIncludeLoad();
+
+    this.call(
+      buildKrpanoTagSetterActions(name ? `${tag}[${name}]` : tag, attrs),
+      nexttick
+    );
+  }
+
+  get<T = any>(name: string): T {
+    return this.krpanoRenderer?.get(name);
+  }
+
+  /**
+   * 删除场景
+   * @param name 场景名称
+   */
+  removeScene(name: string): void {
+    if (
+      this.get("scene") &&
+      typeof this.get("scene").removeItem === "function"
+    ) {
+      this.get("scene").removeItem(name);
+    } else {
+      // TODO: report Error
+    }
+  }
+
+  /**
+   * 加载场景
+   * @param name 场景 name
+   */
+  loadScene(name: string): void {
+    this.call(
+      buildKrpanoAction("loadscene", name, "null", "MERGE", "BLEND(0.5)")
+    );
+  }
+
+  /**
+   * 旋转视图
+   * @param direction 方位
+   * @param degrees 旋转度数，默认为 10
+   */
+  rotateView(direction: ROTATE_DIRECTION, degrees = 10) {
+    let str = "";
+    const view: ViewProps = this.get("view");
+
+    switch (direction) {
+      case ROTATE_DIRECTION.LEFT:
+        str = `view.hlookat, ${(view.hlookat || 0) - degrees}`;
+        break;
+      case ROTATE_DIRECTION.RIGHT:
+        str = `view.hlookat, ${(view.hlookat || 0) + degrees}`;
+        break;
+      case ROTATE_DIRECTION.UP:
+        str = `view.vlookat, ${(view.vlookat || 0) - degrees}`;
+        break;
+      case ROTATE_DIRECTION.DOWN:
+        str = `view.vlookat, ${(view.vlookat || 0) + degrees}`;
+        break;
+    }
+
+    this.call(buildKrpanoAction("tween", str, 0.5));
+  }
+
+  /**
+   * 缩放视图
+   * @param action 动作
+   * @param num 缩放大小
+   */
+  zoomView(action: ZOOM_ACTION, num = 10) {
+    const view: ViewProps = this.get("view");
+    const targetFov = action === ZOOM_ACTION.IN ? -num : num;
+
+    this.call(
+      buildKrpanoAction("tween", "view.fov", (view.fov || 0) + targetFov, 1)
+    );
+  }
+
+  on(eventName: string, selector: string, handler: HandlerFunc): this {
+    this.eventHandlers.push({
+      eventName: eventName.toLowerCase(),
+      selector,
+      handler,
+    });
+    return this;
+  }
+
+  off(eventName: string, selector: string, handler: HandlerFunc): void {
+    this.eventHandlers = this.eventHandlers.filter(
+      (e) =>
+        !(
+          e.eventName === eventName.toLowerCase() &&
+          e.selector === selector &&
+          e.handler === handler
+        )
+    );
+  }
+
+  fire(eventName: string, selector: string): void {
+    this.eventHandlers
+      .filter(
+        (e) =>
+          e.eventName === eventName.toLowerCase() && e.selector === selector
+      )
+      .map(({ handler }) => handler(this));
+  }
+
+  bindEvents(
+    selector: string,
+    mapEventsToHandler: Record<string, HandlerFunc | undefined>
+  ): void {
+    Object.keys(mapEventsToHandler).map((eventName) => {
+      const func = mapEventsToHandler[eventName];
+
+      if (func) {
+        this.on(eventName, selector, func);
+      }
+    });
+  }
+
+  unbindEvents(
+    selector: string,
+    mapEventsToHandler: Record<string, HandlerFunc | undefined>
+  ): void {
+    Object.keys(mapEventsToHandler).map((eventName) => {
+      const func = mapEventsToHandler[eventName];
+
+      if (func) {
+        this.off(eventName, selector, func);
+      }
+    });
+  }
+
+  addHotspot(
+    name: string,
+    attrs: Record<string, string | boolean | number | undefined>
+  ): void {
+    this.call(buildKrpanoAction("addhotspot", name), true);
+    this.setTag("hotspot", name, attrs);
+  }
+  removeHotspot(name: string): void {
+    this.call(buildKrpanoAction("removehotspot", name), true);
+  }
+
+  syncTagsLoaded = false;
+  syncTagStack: {
+    tagName: string;
+    attribute: Record<string, unknown>;
+  }[] = [];
+
+  pushSyncTag(tagName: string, attribute: Record<string, unknown>) {
+    this.syncTagStack.unshift({
+      tagName,
+      attribute,
+    });
+  }
+
+  async createSyncTags() {
+    const xmlDoc = await this.getXMLContent();
+    const krpanoElement = xmlDoc.querySelector("krpano");
+
+    while (this.syncTagStack.length) {
+      const tag = this.syncTagStack.pop()!;
+      const element = xmlDoc.createElement(tag.tagName);
+
+      for (const key in tag.attribute) {
+        element.setAttribute(key, tag.attribute[key] as string);
+      }
+
+      krpanoElement?.insertBefore(element, null);
+    }
+
+    return xmlDoc;
+  }
+
+  private async getXMLContent() {
+    let contentText = "";
+    const xml = this?.get("xml");
+    const parser = new DOMParser();
+
+    if (xml.content) {
+      contentText = xml.content;
+    } else if (xml.url) {
+      contentText = await fetch(xml.url).then((res) => res.text());
+    }
+
+    return parser.parseFromString(contentText, "text/xml");
+  }
+}

packages/krpano/src/PromiseQueue.ts

@@ -0,0 +1,33 @@
+export interface PromiseQueueItem<T> {
+  resolve(value: T): void;
+  reject(error: Error): void;
+}
+
+export class PromiseQueue<T> {
+  private queue: Array<PromiseQueueItem<T>> = [];
+
+  /**
+   * 返回一个 promise 用于等待
+   */
+  push = () => {
+    return new Promise<T>((resolve, reject) => {
+      this.queue.push({ resolve, reject });
+    });
+  };
+
+  /**
+   * 清空队列, 正常结束
+   */
+  flushResolve = (value: T) => {
+    this.queue.forEach((item) => item.resolve(value));
+    this.queue = [];
+  };
+
+  /**
+   * 清空队列, 移除结束
+   */
+  flushReject = (error: Error) => {
+    this.queue.forEach((item) => item.reject(error));
+    this.queue = [];
+  };
+}

packages/krpano/src/components/Autorotate.tsx

@@ -0,0 +1,56 @@
+import React, { useContext, useEffect } from "react";
+import { KrpanoRendererContext } from "../contexts";
+
+/**
+ * @see https://krpano.com/docu/xml/#autorotate
+ */
+export interface AutorotateProps {
+  enabled: boolean;
+  /**
+   * 用户交互后等待的时间（秒）
+   * @default 2
+   */
+  waittime?: number;
+  /**
+   * 自动旋转的速度
+   * @default 10
+   */
+  speed?: number;
+  /**
+   * 自动旋转时视角的水平位置
+   * @default 0
+   */
+  horizon?: number;
+  /**
+   * 旋转的加速度
+   * @default 1
+   */
+  accel?: number;
+  tofov?: "off" | number;
+  oneroundrange?: number;
+  /**
+   * 当用户放大或缩小（通过滚动鼠标滚轮或手势）时，启用这个属性会减缓缩放的速度
+   * @default true
+   */
+  zoomslowdown?: boolean;
+  /**
+   * 定义哪些事件可以中断全景图像的交互操作
+   * @default userviewchange|layers|keyboard
+   */
+  interruptionevents?: string;
+}
+
+export const Autorotate: React.FC<AutorotateProps> = (props) => {
+  const renderer = useContext(KrpanoRendererContext);
+
+  useEffect(() => {
+    const options = {
+      waittime: 2,
+      speed: 10,
+      ...props,
+    };
+    renderer?.setTag("autorotate", null, options);
+  }, [renderer, props]);
+
+  return <div className="autorotate" />;
+};

packages/krpano/src/components/Events.tsx

@@ -0,0 +1,80 @@
+import { FC, useContext, useEffect } from "react";
+import { KrpanoRendererContext } from "../contexts/KrpanoRendererContext";
+import { EventCallback } from "../types";
+import { mapEventPropsToJSCall } from "../utils";
+
+/**
+ * @see https://krpano.com/docu/xml/#events
+ */
+export interface EventsConfig {
+  /** 事件名，若存在该参数则为局部事件 */
+  name?: string;
+  /** 暂时不支持 */
+  // keep?: boolean;
+  onEnterFullscreen?: EventCallback;
+  onExitFullscreen?: EventCallback;
+  onXmlComplete?: EventCallback;
+  onPreviewComplete?: EventCallback;
+  onLoadComplete?: EventCallback;
+  onBlendComplete?: EventCallback;
+  onNewPano?: EventCallback;
+  onRemovePano?: EventCallback;
+  onNewScene?: EventCallback;
+  onXmlError?: EventCallback;
+  onLoadError?: EventCallback;
+  onKeydown?: EventCallback;
+  onKeyup?: EventCallback;
+  onClick?: EventCallback;
+  onSingleClick?: EventCallback;
+  onDoubleClick?: EventCallback;
+  onMousedown?: EventCallback;
+  onMouseup?: EventCallback;
+  onMousewheel?: EventCallback;
+  onContextmenu?: EventCallback;
+  onIdle?: EventCallback;
+  onViewChange?: EventCallback;
+  onViewChanged?: EventCallback;
+  onResize?: EventCallback;
+  onFrameBufferResize?: EventCallback;
+  onAutoRotateStart?: EventCallback;
+  onAutoRotateStop?: EventCallback;
+  onAutoRotateOneRound?: EventCallback;
+  onAutoRotateChange?: EventCallback;
+  onIPhoneFullscreen?: EventCallback;
+}
+
+export interface EventsProps extends EventsConfig {}
+
+const GlobalEvents = "__GlobalEvents";
+
+export const Events: FC<EventsProps> = ({ name, ...EventsAttrs }) => {
+  const renderer = useContext(KrpanoRendererContext);
+  const EventSelector = `events[${name || GlobalEvents}]`;
+
+  // 在renderer上绑定回调
+  useEffect(() => {
+    renderer?.bindEvents(EventSelector, { ...EventsAttrs });
+
+    return () => {
+      renderer?.unbindEvents(EventSelector, { ...EventsAttrs });
+    };
+  }, [renderer, EventsAttrs]);
+
+  // Krpano标签上添加js call，触发事件
+  useEffect(() => {
+    renderer?.setTag(
+      "events",
+      // 全局事件直接设置
+      name || null,
+      mapEventPropsToJSCall(
+        { ...EventsAttrs },
+        (eventName) =>
+          `js(${renderer.name}.fire(${eventName},${EventSelector}))`
+      )
+    );
+  }, [name, renderer]);
+
+  return <div className="events"></div>;
+};
+
+export default Events;

packages/krpano/src/components/HotSpot.tsx

@@ -0,0 +1,93 @@
+import { FC, ReactNode, useContext, useEffect, useMemo } from "react";
+import { EventCallback } from "../types";
+import { KrpanoRendererContext } from "../contexts";
+import { buildKrpanoAction, mapEventPropsToJSCall, mapObject } from "../utils";
+
+export interface HotspotProps {
+  name: string;
+  children?: ReactNode;
+  url?: string;
+  type?: string;
+  keep?: boolean;
+  visible?: boolean;
+  enabled?: boolean;
+  handCursor?: boolean;
+  cursor?: string;
+  maskChildren?: boolean;
+  zOrder?: string;
+  style?: string;
+  ath?: number;
+  atv?: number;
+  edge?: string;
+  zoom?: boolean;
+  distorted?: boolean;
+  rx?: number;
+  ry?: number;
+  rz?: number;
+  width?: string;
+  height?: string;
+  /**
+   * 比例
+   * @default 0.5
+   */
+  scale?: number;
+  rotate?: number;
+  alpha?: number;
+  onOver?: EventCallback;
+  onHover?: EventCallback;
+  onOut?: EventCallback;
+  onDown?: EventCallback;
+  onUp?: EventCallback;
+  onClick?: EventCallback;
+  onLoaded?: EventCallback;
+}
+
+export const HotSpot: FC<HotspotProps> = ({ name, children, ...rest }) => {
+  const EventSelector = `hotspot[${name}]`;
+  const renderer = useContext(KrpanoRendererContext);
+  const options = useMemo(() => {
+    const { scale = 0.5, ...r } = rest;
+
+    return {
+      scale,
+      onOver: buildKrpanoAction("tween", "scale", scale + 0.05),
+      onOut: buildKrpanoAction("tween", "scale", scale),
+      ...r,
+    };
+  }, [rest]);
+
+  useEffect(() => {
+    const eventsObj = mapObject({ ...options }, (key, value) => {
+      if (key.startsWith("on") && typeof value === "function") {
+        return {
+          [key]: value,
+        };
+      }
+      return {};
+    });
+
+    renderer?.bindEvents(EventSelector, eventsObj as any);
+    renderer?.addHotspot(name, {});
+
+    return () => {
+      renderer?.unbindEvents(EventSelector, eventsObj as any);
+      renderer?.removeHotspot(name);
+    };
+  }, []);
+
+  useEffect(() => {
+    renderer?.setTag(
+      "hotspot",
+      name,
+      Object.assign(
+        { ...options },
+        mapEventPropsToJSCall(
+          { ...options },
+          (key) => `js(${renderer?.name}.fire(${key},${EventSelector}))`
+        )
+      )
+    );
+  }, [renderer, name, options]);
+
+  return <div className="hotspot">{children}</div>;
+};

packages/krpano/src/components/Include.tsx

@@ -0,0 +1,21 @@
+import { FC, useContext, useEffect } from "react";
+import { KrpanoRendererContext } from "../contexts";
+
+export interface IncludeProps {
+  url: string;
+}
+
+/**
+ * 注意：不支持动态插入
+ */
+export const Include: FC<IncludeProps> = ({ url }) => {
+  const renderer = useContext(KrpanoRendererContext);
+
+  useEffect(() => {
+    if (!renderer) return;
+
+    renderer.pushSyncTag("include", { url });
+  }, [renderer]);
+
+  return <></>;
+};

packages/krpano/src/components/Krpano.tsx

@@ -0,0 +1,98 @@
+import React, { useCallback, useEffect, useMemo, useState } from "react";
+import { KrpanoActionProxy } from "../KrpanoActionProxy";
+import { useEventCallback } from "../hooks";
+import { IKrpanoConfig, NativeKrpanoRendererObject } from "../types";
+import { useKrpano } from "../hooks/useKrpano";
+import { CurrentSceneContext, KrpanoRendererContext } from "../contexts";
+import { buildKrpanoAction } from "../utils";
+import { WebVR } from "./WebVR";
+
+export interface KrpanoProps extends Omit<IKrpanoConfig, "onready" | "target"> {
+  className?: string;
+  style?: React.CSSProperties;
+  children?: React.ReactNode;
+  currentScene?: string;
+  target?: string;
+  /**
+   * webvr.xml 地址，需遵循同源策略
+   */
+  webvrUrl?: string;
+  onReady?: (renderer: KrpanoActionProxy) => void;
+}
+
+export const Krpano: React.FC<KrpanoProps> = ({
+  className,
+  style,
+  children,
+  currentScene,
+  target = "krpano",
+  webvrUrl,
+  onReady,
+  ...rest
+}) => {
+  const [renderer, setRenderer] = useState<KrpanoActionProxy | null>(null);
+  const restRef = useEventCallback(rest);
+  const onReadyRef = useEventCallback(onReady);
+  const onReadyCallback = useCallback(
+    (obj: NativeKrpanoRendererObject) => {
+      const renderer = new KrpanoActionProxy(obj);
+      (window as any)[renderer.name] = renderer;
+      setRenderer(renderer);
+
+      if (onReadyRef.current) {
+        onReadyRef.current(renderer);
+      }
+    },
+    [onReadyRef]
+  );
+  const krpanoConfig = useMemo(
+    () => ({
+      target,
+      onready: onReadyCallback,
+      ...restRef.current,
+    }),
+    [target, restRef, onReadyCallback]
+  );
+
+  useKrpano(krpanoConfig);
+
+  useEffect(() => {
+    if (!renderer) return;
+
+    const reloadXML = async () => {
+      if (renderer.syncTagStack.length) {
+        // 如果有同步标签（include、plugin），则重新加载
+        const updateXmlString = new XMLSerializer().serializeToString(
+          await renderer.createSyncTags()
+        );
+
+        renderer.call(buildKrpanoAction("loadxml", updateXmlString));
+      }
+
+      renderer.syncTagsLoaded = true;
+      renderer.dynamicTagWaitQueue.flushResolve(true);
+    };
+
+    reloadXML();
+  }, [renderer]);
+
+  useEffect(() => {
+    if (!renderer || !currentScene) return;
+
+    renderer.waitIncludeLoad().then(() => {
+      renderer.loadScene(currentScene);
+    });
+  }, [renderer, currentScene]);
+
+  return (
+    <KrpanoRendererContext.Provider value={renderer}>
+      <CurrentSceneContext.Provider value={currentScene || null}>
+        {webvrUrl && <WebVR url={webvrUrl} />}
+
+        <div id={target} className={className} style={style}>
+          {renderer ? children : null}
+        </div>
+      </CurrentSceneContext.Provider>
+    </KrpanoRendererContext.Provider>
+  );
+};

packages/krpano/src/components/Plugin.tsx

@@ -0,0 +1,21 @@
+import { FC, useContext, useEffect } from "react";
+import { KrpanoRendererContext } from "../contexts";
+
+export interface PluginProps {
+  attribute: Record<string, unknown>;
+}
+
+/**
+ * 注意：不支持动态插入
+ */
+export const Plugin: FC<PluginProps> = ({ attribute }) => {
+  const renderer = useContext(KrpanoRendererContext);
+
+  useEffect(() => {
+    if (!renderer) return;
+
+    renderer.pushSyncTag("plugin", attribute);
+  }, [renderer]);
+
+  return <></>;
+};

packages/krpano/src/components/Scene.tsx

@@ -0,0 +1,99 @@
+import { useContext, useEffect } from "react";
+import { CurrentSceneContext, KrpanoRendererContext } from "../contexts";
+import { XMLMeta } from "../types";
+import { buildXML } from "../utils";
+
+export interface SceneImageAttributes {
+  type: "cube" | "sphere";
+  /** 瓦片尺寸 */
+  tileSize?: number;
+  multires?: boolean;
+}
+
+export interface SceneImage {
+  url: string;
+}
+
+export interface SceneImageWithMultires extends SceneImage {
+  tiledImageWidth: number;
+  tiledImageHeight: number;
+}
+
+export interface SceneProps {
+  name: string;
+  children?: React.ReactNode;
+  previewUrl?: string;
+  /** 直接指定scene的xml内容。指定后会忽略其他设置 */
+  content?: string;
+  /** image标签属性 */
+  imageTagAttributes: SceneImageAttributes;
+  /** Scene包含的图片。数组的长度大于1时按multires解析为多个level */
+  images?: [SceneImage] | SceneImageWithMultires[];
+}
+
+export const Scene: React.FC<SceneProps> = ({
+  name,
+  previewUrl,
+  imageTagAttributes,
+  images = [],
+  content,
+  children,
+}) => {
+  const renderer = useContext(KrpanoRendererContext);
+  const currentScene = useContext(CurrentSceneContext);
+
+  useEffect(() => {
+    const contentImageMeta: XMLMeta = {
+      tag: "image",
+      // @ts-ignore
+      attrs: imageTagAttributes,
+      children: [],
+    };
+
+    // multires
+    if (images.length > 1) {
+      contentImageMeta.children!.push(
+        ...(images as SceneImageWithMultires[]).map(
+          ({ tiledImageWidth, tiledImageHeight, ...img }) => {
+            const imgXML: XMLMeta = {
+              tag: "level",
+              attrs: {
+                tiledImageWidth,
+                tiledImageHeight,
+              },
+              children: [
+                {
+                  tag: imageTagAttributes.type,
+                  attrs: { ...img },
+                },
+              ],
+            };
+
+            return imgXML;
+          }
+        )
+      );
+    } else if (images.length === 1) {
+      const { ...img } = images[0] as SceneImage;
+
+      contentImageMeta.children!.push({
+        tag: imageTagAttributes.type,
+        attrs: { ...img },
+      });
+    }
+
+    renderer?.setTag("scene", name, {
+      content:
+        content ||
+        `${previewUrl ? `<preview url="${previewUrl}" />` : ""}${
+          images.length > 0 ? buildXML(contentImageMeta) : ""
+        }`,
+    });
+
+    return () => {
+      renderer?.removeScene(name);
+    };
+  }, [renderer, name, images, imageTagAttributes, content, previewUrl]);
+
+  return <div className="scene">{currentScene === name ? children : null}</div>;
+};

packages/krpano/src/components/View.tsx

@@ -0,0 +1,55 @@
+import React, { useContext, useEffect } from "react";
+import { KrpanoRendererContext } from "../contexts";
+
+/**
+ * @see https://krpano.com/docu/xml/#view
+ */
+export interface ViewProps {
+  hlookat?: number;
+  vlookat?: number;
+  fov?: number;
+  fovMin?: number;
+  fovMax?: number;
+  camRoll?: number;
+  /**
+   * @see https://krpano.com/docu/xml/#view.fovtype
+   */
+  fovType?: "VFOV" | "HFOV" | "DFOV" | "MFOV" | "SFOV";
+  maxPixelZoom?: number;
+  mFovRatio?: number;
+  distortion?: number;
+  distortionFovLink?: number;
+  stereographic?: boolean;
+  pannini?: number;
+  architectural?: number;
+  architecturalOnlyMiddle?: boolean;
+  /**
+   * @see https://krpano.com/docu/xml/#view.limitview
+   */
+  limitView?: "off" | "auto" | "lookat" | "range" | "fullrange" | "offrange";
+  hlookatMin?: number;
+  hlookatMax?: number;
+  vlookatMin?: number;
+  vlookatMax?: number;
+  rx?: number;
+  ry?: number;
+  tx?: number;
+  ty?: number;
+  tz?: number;
+  ox?: number;
+  oy?: number;
+  oz?: number;
+  children?: null;
+}
+
+export const View: React.FC<ViewProps> = ({ children, ...viewAttrs }) => {
+  const renderer = useContext(KrpanoRendererContext);
+
+  useEffect(() => {
+    renderer?.setTag("view", null, { ...viewAttrs });
+  }, [renderer, viewAttrs]);
+
+  return <div className="view">{children}</div>;
+};
+
+export default View;

packages/krpano/src/components/WebVR/index.tsx

@@ -0,0 +1,25 @@
+import { FC } from "react";
+import { Include, Plugin } from "..";
+
+export interface WebVRProps {
+  url: string;
+}
+
+const WEBVR_CONFIG = {
+  name: "WebVR",
+  keep: true,
+  devices: "html5",
+  "multireslock.desktop": true,
+  "multireslock.mobile.or.tablet": false,
+  mobilevr_support: true,
+  mobilevr_fake_support: true,
+};
+
+export const WebVR: FC<WebVRProps> = ({ url }) => {
+  return (
+    <>
+      <Include url={url} />
+      <Plugin attribute={WEBVR_CONFIG} />
+    </>
+  );
+};

packages/krpano/src/components/index.ts

@@ -0,0 +1,8 @@
+export * from "./Krpano";
+export * from "./Scene";
+export * from "./View";
+export * from "./HotSpot";
+export * from "./Autorotate";
+export * from "./Events";
+export * from "./Include";
+export * from "./Plugin";

packages/krpano/src/contexts/CurrentSceneContext.ts

@@ -0,0 +1,3 @@
+import React from "react";
+
+export const CurrentSceneContext = React.createContext<string | null>(null);

packages/krpano/src/contexts/KrpanoRendererContext.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import { KrpanoActionProxy } from "../KrpanoActionProxy";
+
+export const KrpanoRendererContext =
+  React.createContext<KrpanoActionProxy | null>(null);

packages/krpano/src/contexts/index.ts

@@ -0,0 +1,2 @@
+export * from "./CurrentSceneContext";
+export * from "./KrpanoRendererContext";

packages/krpano/src/hooks/index.ts

@@ -0,0 +1 @@
+export * from "./useEventCallback";

packages/krpano/src/hooks/useEventCallback.ts

@@ -0,0 +1,11 @@
+import { useLayoutEffect, useRef } from "react";
+
+export function useEventCallback<T>(callback: T): React.MutableRefObject<T> {
+  const callbackRef = useRef(callback);
+
+  useLayoutEffect(() => {
+    callbackRef.current = callback;
+  }, [callback]);
+
+  return callbackRef;
+}

packages/krpano/src/hooks/useKrpano.ts

@@ -0,0 +1,27 @@
+import { useEffect, useRef } from "react";
+import { IKrpanoConfig } from "../types";
+
+export const useKrpano = (config: IKrpanoConfig): void => {
+  const isCreated = useRef(false);
+
+  useEffect(() => {
+    const defaultConfig: Partial<IKrpanoConfig> = {
+      html5: "auto",
+      xml: null,
+      mobilescale: 1,
+    };
+    const embedpano = () => {
+      if (typeof window.embedpano === "function") {
+        window.embedpano({ ...defaultConfig, ...config });
+      }
+    };
+
+    if (typeof window.embedpano === "function") {
+      (config.xml || !isCreated.current) && embedpano();
+
+      isCreated.current = true;
+    } else {
+      throw new Error("Krpano required");
+    }
+  }, [config]);
+};

packages/krpano/src/index.ts

@@ -0,0 +1,5 @@
+export * from "./components";
+
+export * from "./contexts";
+export * from "./hooks";
+export * from "./types";

packages/krpano/src/types.ts

@@ -0,0 +1,76 @@
+import { KrpanoActionProxy } from "./KrpanoActionProxy";
+
+declare global {
+  interface Window {
+    embedpano?: (config: IKrpanoConfig) => void;
+    ReactKrpanoActionProxy?: KrpanoActionProxy;
+  }
+}
+
+export interface NativeKrpanoRendererObject {
+  get(key: string): any;
+  call(action: string): void;
+}
+
+/**
+ * @see https://krpano.com/docu/html/#wmode
+ */
+export interface IKrpanoConfig {
+  /**
+   * 全景图xml路径。需要手动设置为null才不会加载。
+   * @see https://krpano.com/docu/html/#xml
+   */
+  xml?: string | null;
+  /**  挂载点id */
+  target: string;
+  swf?: string;
+  id?: string;
+  bgcolor?: string;
+  /**
+   * @see https://krpano.com/docu/html/#html5
+   */
+  html5?: string;
+  flash?: string;
+  wmode?: string;
+  localfallback?: string;
+  vars?: Record<string, unknown>;
+  initvars?: Record<string, unknown>;
+  consolelog?: boolean;
+  basepath?: string;
+  mwheel?: boolean;
+  capturetouch?: boolean;
+  focus?: boolean;
+  webglsettings?: Record<string, unknown>;
+  webxr?: string;
+  mobilescale?: number;
+  touchdevicemousesupport?: boolean;
+  fakedevice?: string;
+  passQueryParameters?: boolean;
+  onready?: (renderer: NativeKrpanoRendererObject) => void;
+}
+
+export type EventCallback = (renderer: KrpanoActionProxy) => void;
+
+export interface XMLMeta {
+  tag: string;
+  attrs: Record<string, string | number | boolean>;
+  children?: XMLMeta[];
+}
+
+/**
+ * 旋转方位
+ */
+export enum ROTATE_DIRECTION {
+  UP = "up",
+  DOWN = "down",
+  LEFT = "left",
+  RIGHT = "right",
+}
+
+/**
+ * 缩放动作
+ */
+export enum ZOOM_ACTION {
+  IN = "in",
+  OUT = "out",
+}

packages/krpano/src/utils.ts

@@ -0,0 +1,107 @@
+import escapeHTML from "escape-html";
+import { XMLMeta } from "./types";
+
+/**
+ * @see https://krpano.com/docu/actions/?version=119pr13
+ */
+type FuncName =
+  | "addplugin"
+  | "set"
+  | "loadxml"
+  | "loadscene"
+  | "loadpano"
+  | "tween"
+  | "addhotspot"
+  | "removehotspot"
+  | "nexttick";
+
+/**
+ * 执行单个函数
+ * @param func 函数名
+ * @param params 参数列表
+ */
+export const buildKrpanoAction = (
+  func: FuncName,
+  ...params: Array<string | number | boolean>
+): string => `${func}(${params.map((p) => `${p}`).join(", ")});`;
+
+/**
+ * 动态添加标签用
+ * @see https://krpano.com/forum/wbb/index.php?page=Thread&threadID=15873
+ */
+export const buildKrpanoTagSetterActions = (
+  name: string,
+  attrs: Record<string, string | boolean | number | undefined>
+): string =>
+  Object.keys(attrs)
+    .map((key) => {
+      const val = attrs[key];
+      key = key.toLowerCase();
+      if (val === undefined) {
+        return "";
+      }
+      // 如果属性值中有双引号，需要改用单引号
+      let quote = '"';
+      if (val.toString().includes(quote)) {
+        // eslint-disable-next-line quotes
+        quote = "'";
+      }
+      if (key === "style") {
+        return `assignstyle(${name}, ${val});`;
+      }
+      if (typeof val === "boolean" || typeof val === "number") {
+        return `set(${name}.${key}, ${val});`;
+      }
+      // content是XML文本，不能转义，因为不涉及用户输入也不需要
+      return `set(${name}.${key}, ${quote}${
+        key === "content" ? val : escapeHTML(val.toString())
+      }${quote});`;
+    })
+    .filter((str) => !!str)
+    .join("");
+
+/**
+ * 根据元数据构建xml
+ */
+export const buildXML = ({ tag, attrs, children }: XMLMeta): string => {
+  const attributes = Object.keys(attrs)
+    .map((key) => `${key.toLowerCase()}="${attrs[key]}"`)
+    .join(" ");
+
+  if (children && children.length) {
+    return `<${tag} ${attributes}>${children
+      .map((child) => buildXML(child))
+      .join("")}</${tag}>`;
+  }
+  return `<${tag} ${attributes} />`;
+};
+
+/**
+ * 对Object进行map操作
+ */
+export const mapObject = (
+  obj: Record<string, unknown>,
+  mapper: (key: string, value: unknown) => Record<string, unknown>
+): Record<string, unknown> => {
+  return Object.assign(
+    {},
+    ...Object.keys(obj).map((key) => {
+      const value = obj[key];
+      return mapper(key, value);
+    })
+  );
+};
+
+/**
+ * 主要用于绑定Krpano事件和js调用。提取某个对象中的onXXX属性并替换为对应的调用字符串，丢弃其他属性
+ */
+export const mapEventPropsToJSCall = (
+  obj: Record<string, unknown>,
+  getString: (key: string, value: unknown) => string
+): Record<string, string> =>
+  mapObject(obj, (key, value) => {
+    if (key.startsWith("on") && typeof value === "function") {
+      return { [key]: getString(key, value) };
+    }
+    return {};
+  }) as Record<string, string>;

packages/krpano/tsconfig.build.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false
+  },
+  "exclude": ["dist", "node_modules", "*.d.ts", "**/*.test.*"]
+}

packages/krpano/tsconfig.json

@@ -0,0 +1,73 @@
+{
+  "compilerOptions": {
+    /* Visit https://aka.ms/tsconfig.json to read more about this file */
+
+    /* Basic Options */
+    // "incremental": true,                         /* Enable incremental compilation */
+    "target": "ES2015" /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'ES2020', 'ES2021', or 'ESNEXT'. */,
+    "module": "ESNext" /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */,
+    // "lib": [],                                   /* Specify library files to be included in the compilation. */
+    // "allowJs": true,                             /* Allow javascript files to be compiled. */
+    // "checkJs": true,                             /* Report errors in .js files. */
+    "jsx": "react-jsx" /* Specify JSX code generation: 'preserve', 'react-native', 'react', 'react-jsx' or 'react-jsxdev'. */,
+    "declaration": true /* Generates corresponding '.d.ts' file. */,
+    "declarationMap": true /* Generates a sourcemap for each corresponding '.d.ts' file. */,
+    "sourceMap": false /* Generates corresponding '.map' file. */,
+    // "outFile": "./",                             /* Concatenate and emit output to single file. */
+    "outDir": "./dist" /* Redirect output structure to the directory. */,
+    "rootDir": "./src" /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */,
+    // "composite": true,                           /* Enable project compilation */
+    // "tsBuildInfoFile": "./",                     /* Specify file to store incremental compilation information */
+    // "removeComments": true,                      /* Do not emit comments to output. */
+    "noEmit": true /* Do not emit outputs. */,
+    "importHelpers": true /* Import emit helpers from 'tslib'. */,
+    // "downlevelIteration": true,                  /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */
+    // "isolatedModules": true,                     /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */
+
+    /* Strict Type-Checking Options */
+    "strict": true /* Enable all strict type-checking options. */,
+    // "noImplicitAny": true,                       /* Raise error on expressions and declarations with an implied 'any' type. */
+    // "strictNullChecks": true,                    /* Enable strict null checks. */
+    // "strictFunctionTypes": true,                 /* Enable strict checking of function types. */
+    // "strictBindCallApply": true,                 /* Enable strict 'bind', 'call', and 'apply' methods on functions. */
+    // "strictPropertyInitialization": true,        /* Enable strict checking of property initialization in classes. */
+    // "noImplicitThis": true,                      /* Raise error on 'this' expressions with an implied 'any' type. */
+    // "alwaysStrict": true,                        /* Parse in strict mode and emit "use strict" for each source file. */
+
+    /* Additional Checks */
+    "noUnusedLocals": true /* Report errors on unused locals. */,
+    // "noUnusedParameters": true,                  /* Report errors on unused parameters. */
+    // "noImplicitReturns": true,                   /* Report error when not all code paths in function return a value. */
+    "noFallthroughCasesInSwitch": true /* Report errors for fallthrough cases in switch statement. */,
+    // "noUncheckedIndexedAccess": true,            /* Include 'undefined' in index signature results */
+    "noImplicitOverride": true /* Ensure overriding members in derived classes are marked with an 'override' modifier. */,
+    // "noPropertyAccessFromIndexSignature": true,  /* Require undeclared properties from index signatures to use element accesses. */
+
+    /* Module Resolution Options */
+    "moduleResolution": "node" /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */,
+    // "baseUrl": "./",                             /* Base directory to resolve non-absolute module names. */
+    // "paths": {},                                 /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */
+    // "rootDirs": [],                              /* List of root folders whose combined content represents the structure of the project at runtime. */
+    // "typeRoots": [],                             /* List of folders to include type definitions from. */
+    // "types": [],                                 /* Type declaration files to be included in compilation. */
+    "allowSyntheticDefaultImports": true /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */,
+    "esModuleInterop": true /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */,
+    // "preserveSymlinks": true,                    /* Do not resolve the real path of symlinks. */
+    // "allowUmdGlobalAccess": true,                /* Allow accessing UMD globals from modules. */
+
+    /* Source Map Options */
+    // "sourceRoot": "",                            /* Specify the location where debugger should locate TypeScript files instead of source locations. */
+    // "mapRoot": "",                               /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSourceMap": true,                     /* Emit a single file with source maps instead of having a separate file. */
+    // "inlineSources": true,                       /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */
+
+    /* Experimental Options */
+    // "experimentalDecorators": true,              /* Enables experimental support for ES7 decorators. */
+    // "emitDecoratorMetadata": true,               /* Enables experimental support for emitting type metadata for decorators. */
+
+    /* Advanced Options */
+    "skipLibCheck": true /* Skip type checking of declaration files. */,
+    "forceConsistentCasingInFileNames": true /* Disallow inconsistently-cased references to the same file. */
+  },
+  "exclude": ["dist", "node_modules", "*.d.ts"]
+}

pnpm-lock.yaml

@@ -298,6 +298,68 @@ importers:
 
   packages/events: {}
 
+  packages/hooks:
+    dependencies:
+      react:
+        specifier: '>=17'
+        version: registry.npmmirror.com/react@18.2.0
+    devDependencies:
+      '@babel/core':
+        specifier: ^7.22.10
+        version: registry.npmmirror.com/@babel/core@7.22.10
+      '@babel/preset-env':
+        specifier: ^7.22.10
+        version: registry.npmmirror.com/@babel/preset-env@7.22.10(@babel/core@7.22.10)
+      '@babel/preset-typescript':
+        specifier: ^7.22.5
+        version: registry.npmmirror.com/@babel/preset-typescript@7.22.5(@babel/core@7.22.10)
+      '@testing-library/react-hooks':
+        specifier: ^8.0.1
+        version: registry.npmmirror.com/@testing-library/react-hooks@8.0.1(react@18.2.0)
+      babel-jest:
+        specifier: ^29.6.2
+        version: registry.npmmirror.com/babel-jest@29.6.2(@babel/core@7.22.10)
+      jest:
+        specifier: ^29.6.2
+        version: registry.npmmirror.com/jest@29.6.3
+
+  packages/krpano:
+    dependencies:
+      '@dage/hooks':
+        specifier: workspace:^
+        version: link:../hooks
+      escape-html:
+        specifier: ^1.0.3
+        version: registry.npmmirror.com/escape-html@1.0.3
+      react:
+        specifier: '>=18'
+        version: registry.npmmirror.com/react@18.2.0
+      react-dom:
+        specifier: '>=18'
+        version: registry.npmmirror.com/react-dom@18.2.0(react@18.2.0)
+    devDependencies:
+      '@babel/core':
+        specifier: ^7.22.10
+        version: registry.npmmirror.com/@babel/core@7.22.10
+      '@babel/preset-env':
+        specifier: ^7.22.10
+        version: registry.npmmirror.com/@babel/preset-env@7.22.10(@babel/core@7.22.10)
+      '@babel/preset-typescript':
+        specifier: ^7.22.5
+        version: registry.npmmirror.com/@babel/preset-typescript@7.22.5(@babel/core@7.22.10)
+      '@types/escape-html':
+        specifier: ^1.0.2
+        version: registry.npmmirror.com/@types/escape-html@1.0.2
+      '@types/react':
+        specifier: ^18.2.20
+        version: registry.npmmirror.com/@types/react@18.2.20
+      babel-jest:
+        specifier: ^29.6.2
+        version: registry.npmmirror.com/babel-jest@29.6.2(@babel/core@7.22.10)
+      jest:
+        specifier: ^29.6.2
+        version: registry.npmmirror.com/jest@29.6.3
+
   packages/pc-components:
     dependencies:
       '@amap/amap-react':
@@ -1164,6 +1226,7 @@ packages:
     id: registry.npmmirror.com/@babel/plugin-proposal-class-properties/7.8.3
     name: '@babel/plugin-proposal-class-properties'
     version: 7.8.3
+    deprecated: This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-class-properties instead.
     peerDependencies:
       '@babel/core': ^7.0.0-0
     dependencies:
@@ -2875,19 +2938,6 @@ packages:
       '@babel/core': registry.npmmirror.com/@babel/core@7.22.10
       '@babel/plugin-transform-react-jsx': registry.npmmirror.com/@babel/plugin-transform-react-jsx@7.22.5(@babel/core@7.22.10)
 
-  registry.npmmirror.com/@babel/plugin-transform-react-jsx-self@7.22.5(@babel/core@7.22.10):
-    resolution: {integrity: sha512-nTh2ogNUtxbiSbxaT4Ds6aXnXEipHweN9YRgOX/oNXdf0cCrGn/+2LozFa3lnPV5D90MkjhgckCPBrsoSc1a7g==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@babel/plugin-transform-react-jsx-self/-/plugin-transform-react-jsx-self-7.22.5.tgz}
-    id: registry.npmmirror.com/@babel/plugin-transform-react-jsx-self/7.22.5
-    name: '@babel/plugin-transform-react-jsx-self'
-    version: 7.22.5
-    engines: {node: '>=6.9.0'}
-    peerDependencies:
-      '@babel/core': ^7.0.0-0
-    dependencies:
-      '@babel/core': registry.npmmirror.com/@babel/core@7.22.10
-      '@babel/helper-plugin-utils': registry.npmmirror.com/@babel/helper-plugin-utils@7.22.5
-    dev: true
-
   registry.npmmirror.com/@babel/plugin-transform-react-jsx-self@7.22.5(@babel/core@7.8.6):
     resolution: {integrity: sha512-nTh2ogNUtxbiSbxaT4Ds6aXnXEipHweN9YRgOX/oNXdf0cCrGn/+2LozFa3lnPV5D90MkjhgckCPBrsoSc1a7g==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@babel/plugin-transform-react-jsx-self/-/plugin-transform-react-jsx-self-7.22.5.tgz}
     id: registry.npmmirror.com/@babel/plugin-transform-react-jsx-self/7.22.5
@@ -2901,19 +2951,6 @@ packages:
       '@babel/helper-plugin-utils': registry.npmmirror.com/@babel/helper-plugin-utils@7.22.5
     dev: true
 
-  registry.npmmirror.com/@babel/plugin-transform-react-jsx-source@7.22.5(@babel/core@7.22.10):
-    resolution: {integrity: sha512-yIiRO6yobeEIaI0RTbIr8iAK9FcBHLtZq0S89ZPjDLQXBA4xvghaKqI0etp/tF3htTM0sazJKKLz9oEiGRtu7w==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@babel/plugin-transform-react-jsx-source/-/plugin-transform-react-jsx-source-7.22.5.tgz}
-    id: registry.npmmirror.com/@babel/plugin-transform-react-jsx-source/7.22.5
-    name: '@babel/plugin-transform-react-jsx-source'
-    version: 7.22.5
-    engines: {node: '>=6.9.0'}
-    peerDependencies:
-      '@babel/core': ^7.0.0-0
-    dependencies:
-      '@babel/core': registry.npmmirror.com/@babel/core@7.22.10
-      '@babel/helper-plugin-utils': registry.npmmirror.com/@babel/helper-plugin-utils@7.22.5
-    dev: true
-
   registry.npmmirror.com/@babel/plugin-transform-react-jsx-source@7.22.5(@babel/core@7.8.6):
     resolution: {integrity: sha512-yIiRO6yobeEIaI0RTbIr8iAK9FcBHLtZq0S89ZPjDLQXBA4xvghaKqI0etp/tF3htTM0sazJKKLz9oEiGRtu7w==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@babel/plugin-transform-react-jsx-source/-/plugin-transform-react-jsx-source-7.22.5.tgz}
     id: registry.npmmirror.com/@babel/plugin-transform-react-jsx-source/7.22.5
@@ -3474,22 +3511,6 @@ packages:
       '@babel/plugin-transform-react-jsx-development': registry.npmmirror.com/@babel/plugin-transform-react-jsx-development@7.22.5(@babel/core@7.22.10)
       '@babel/plugin-transform-react-pure-annotations': registry.npmmirror.com/@babel/plugin-transform-react-pure-annotations@7.22.5(@babel/core@7.22.10)
 
-  registry.npmmirror.com/@babel/preset-react@7.8.3(@babel/core@7.22.10):
-    resolution: {integrity: sha512-9hx0CwZg92jGb7iHYQVgi0tOEHP/kM60CtWJQnmbATSPIQQ2xYzfoCI3EdqAhFBeeJwYMdWQuDUHMsuDbH9hyQ==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@babel/preset-react/-/preset-react-7.8.3.tgz}
-    id: registry.npmmirror.com/@babel/preset-react/7.8.3
-    name: '@babel/preset-react'
-    version: 7.8.3
-    peerDependencies:
-      '@babel/core': ^7.0.0-0
-    dependencies:
-      '@babel/core': registry.npmmirror.com/@babel/core@7.22.10
-      '@babel/helper-plugin-utils': registry.npmmirror.com/@babel/helper-plugin-utils@7.22.5
-      '@babel/plugin-transform-react-display-name': registry.npmmirror.com/@babel/plugin-transform-react-display-name@7.22.5(@babel/core@7.22.10)
-      '@babel/plugin-transform-react-jsx': registry.npmmirror.com/@babel/plugin-transform-react-jsx@7.22.5(@babel/core@7.22.10)
-      '@babel/plugin-transform-react-jsx-self': registry.npmmirror.com/@babel/plugin-transform-react-jsx-self@7.22.5(@babel/core@7.22.10)
-      '@babel/plugin-transform-react-jsx-source': registry.npmmirror.com/@babel/plugin-transform-react-jsx-source@7.22.5(@babel/core@7.22.10)
-    dev: true
-
   registry.npmmirror.com/@babel/preset-react@7.8.3(@babel/core@7.8.6):
     resolution: {integrity: sha512-9hx0CwZg92jGb7iHYQVgi0tOEHP/kM60CtWJQnmbATSPIQQ2xYzfoCI3EdqAhFBeeJwYMdWQuDUHMsuDbH9hyQ==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@babel/preset-react/-/preset-react-7.8.3.tgz}
     id: registry.npmmirror.com/@babel/preset-react/7.8.3
@@ -4846,31 +4867,6 @@ packages:
       - supports-color
     dev: false
 
-  registry.npmmirror.com/@jest/transform@29.6.2:
-    resolution: {integrity: sha512-ZqCqEISr58Ce3U+buNFJYUktLJZOggfyvR+bZMaiV1e8B1SIvJbwZMrYz3gx/KAPn9EXmOmN+uB08yLCjWkQQg==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@jest/transform/-/transform-29.6.2.tgz}
-    name: '@jest/transform'
-    version: 29.6.2
-    engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0}
-    dependencies:
-      '@babel/core': registry.npmmirror.com/@babel/core@7.22.10
-      '@jest/types': registry.npmmirror.com/@jest/types@29.6.3
-      '@jridgewell/trace-mapping': registry.npmmirror.com/@jridgewell/trace-mapping@0.3.19
-      babel-plugin-istanbul: registry.npmmirror.com/babel-plugin-istanbul@6.1.1
-      chalk: registry.npmmirror.com/chalk@4.1.2
-      convert-source-map: registry.npmmirror.com/convert-source-map@2.0.0
-      fast-json-stable-stringify: registry.npmmirror.com/fast-json-stable-stringify@2.1.0
-      graceful-fs: registry.npmmirror.com/graceful-fs@4.2.11
-      jest-haste-map: registry.npmmirror.com/jest-haste-map@29.6.3
-      jest-regex-util: registry.npmmirror.com/jest-regex-util@29.6.3
-      jest-util: registry.npmmirror.com/jest-util@29.6.3
-      micromatch: registry.npmmirror.com/micromatch@4.0.5
-      pirates: registry.npmmirror.com/pirates@4.0.6
-      slash: registry.npmmirror.com/slash@3.0.0
-      write-file-atomic: registry.npmmirror.com/write-file-atomic@4.0.2
-    transitivePeerDependencies:
-      - supports-color
-    dev: true
-
   registry.npmmirror.com/@jest/transform@29.6.3:
     resolution: {integrity: sha512-dPIc3DsvMZ/S8ut4L2ViCj265mKO0owB0wfzBv2oGzL9pQ+iRvJewHqLBmsGb7XFb5UotWIEtvY5A/lnylaIoQ==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@jest/transform/-/transform-29.6.3.tgz}
     name: '@jest/transform'
@@ -5673,7 +5669,7 @@ packages:
       '@babel/core': registry.npmmirror.com/@babel/core@7.22.10
       '@babel/plugin-transform-react-constant-elements': registry.npmmirror.com/@babel/plugin-transform-react-constant-elements@7.22.5(@babel/core@7.22.10)
       '@babel/preset-env': registry.npmmirror.com/@babel/preset-env@7.22.10(@babel/core@7.22.10)
-      '@babel/preset-react': registry.npmmirror.com/@babel/preset-react@7.8.3(@babel/core@7.22.10)
+      '@babel/preset-react': registry.npmmirror.com/@babel/preset-react@7.22.5(@babel/core@7.22.10)
       '@svgr/core': registry.npmmirror.com/@svgr/core@4.3.3
       '@svgr/plugin-jsx': registry.npmmirror.com/@svgr/plugin-jsx@4.3.3
       '@svgr/plugin-svgo': registry.npmmirror.com/@svgr/plugin-svgo@4.3.1
@@ -5758,6 +5754,30 @@ packages:
       redent: registry.npmmirror.com/redent@3.0.0
     dev: false
 
+  registry.npmmirror.com/@testing-library/react-hooks@8.0.1(react@18.2.0):
+    resolution: {integrity: sha512-Aqhl2IVmLt8IovEVarNDFuJDVWVvhnr9/GCU6UUnrYXwgDFF9h2L2o2P9KBni1AST5sT6riAyoukFLyjQUgD/g==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@testing-library/react-hooks/-/react-hooks-8.0.1.tgz}
+    id: registry.npmmirror.com/@testing-library/react-hooks/8.0.1
+    name: '@testing-library/react-hooks'
+    version: 8.0.1
+    engines: {node: '>=12'}
+    peerDependencies:
+      '@types/react': ^16.9.0 || ^17.0.0
+      react: ^16.9.0 || ^17.0.0
+      react-dom: ^16.9.0 || ^17.0.0
+      react-test-renderer: ^16.9.0 || ^17.0.0
+    peerDependenciesMeta:
+      '@types/react':
+        optional: true
+      react-dom:
+        optional: true
+      react-test-renderer:
+        optional: true
+    dependencies:
+      '@babel/runtime': registry.npmmirror.com/@babel/runtime@7.22.10
+      react: registry.npmmirror.com/react@18.2.0
+      react-error-boundary: registry.npmmirror.com/react-error-boundary@3.1.4(react@18.2.0)
+    dev: true
+
   registry.npmmirror.com/@testing-library/react@13.4.0(react-dom@18.2.0)(react@18.2.0):
     resolution: {integrity: sha512-sXOGON+WNTh3MLE9rve97ftaZukN3oNf2KjDy7YTx6hcTO2uuLHuCGynMDhFwGw/jYf4OJ2Qk0i4i79qMNNkyw==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@testing-library/react/-/react-13.4.0.tgz}
     id: registry.npmmirror.com/@testing-library/react/13.4.0
@@ -5893,6 +5913,12 @@ packages:
     version: 4.1.5
     dev: true
 
+  registry.npmmirror.com/@types/escape-html@1.0.2:
+    resolution: {integrity: sha512-gaBLT8pdcexFztLSPRtriHeXY/Kn4907uOCZ4Q3lncFBkheAWOuNt53ypsF8szgxbEJ513UeBzcf4utN0EzEwA==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@types/escape-html/-/escape-html-1.0.2.tgz}
+    name: '@types/escape-html'
+    version: 1.0.2
+    dev: true
+
   registry.npmmirror.com/@types/eslint-scope@3.7.4:
     resolution: {integrity: sha512-9K4zoImiZc3HlIp6AVUDE4CWYx22a+lhSZMYNpbjW04+YF0KWj4pJXnEMjdnFTiQibFFmElcsasJXDbdI/EPhA==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/@types/eslint-scope/-/eslint-scope-3.7.4.tgz}
     name: '@types/eslint-scope'
@@ -5915,7 +5941,7 @@ packages:
     name: '@types/eslint'
     version: 8.44.2
     dependencies:
-      '@types/estree': registry.npmmirror.com/@types/estree@0.0.50
+      '@types/estree': registry.npmmirror.com/@types/estree@1.0.1
       '@types/json-schema': registry.npmmirror.com/@types/json-schema@7.0.12
     dev: false
 
@@ -8582,10 +8608,10 @@ packages:
       '@babel/core': ^7.8.0
     dependencies:
       '@babel/core': registry.npmmirror.com/@babel/core@7.22.10
-      '@jest/transform': registry.npmmirror.com/@jest/transform@29.6.2
+      '@jest/transform': registry.npmmirror.com/@jest/transform@29.6.3
       '@types/babel__core': registry.npmmirror.com/@types/babel__core@7.20.1
       babel-plugin-istanbul: registry.npmmirror.com/babel-plugin-istanbul@6.1.1
-      babel-preset-jest: registry.npmmirror.com/babel-preset-jest@29.5.0(@babel/core@7.22.10)
+      babel-preset-jest: registry.npmmirror.com/babel-preset-jest@29.6.3(@babel/core@7.22.10)
       chalk: registry.npmmirror.com/chalk@4.1.2
       graceful-fs: registry.npmmirror.com/graceful-fs@4.2.11
       slash: registry.npmmirror.com/slash@3.0.0
@@ -8913,20 +8939,6 @@ packages:
       babel-preset-current-node-syntax: registry.npmmirror.com/babel-preset-current-node-syntax@1.0.1(@babel/core@7.22.10)
     dev: false
 
-  registry.npmmirror.com/babel-preset-jest@29.5.0(@babel/core@7.22.10):
-    resolution: {integrity: sha512-JOMloxOqdiBSxMAzjRaH023/vvcaSaec49zvg+2LmNsktC7ei39LTJGw02J+9uUtTZUq6xbLyJ4dxe9sSmIuAg==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/babel-preset-jest/-/babel-preset-jest-29.5.0.tgz}
-    id: registry.npmmirror.com/babel-preset-jest/29.5.0
-    name: babel-preset-jest
-    version: 29.5.0
-    engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0}
-    peerDependencies:
-      '@babel/core': ^7.0.0
-    dependencies:
-      '@babel/core': registry.npmmirror.com/@babel/core@7.22.10
-      babel-plugin-jest-hoist: registry.npmmirror.com/babel-plugin-jest-hoist@29.6.3
-      babel-preset-current-node-syntax: registry.npmmirror.com/babel-preset-current-node-syntax@1.0.1(@babel/core@7.22.10)
-    dev: true
-
   registry.npmmirror.com/babel-preset-jest@29.6.3(@babel/core@7.22.10):
     resolution: {integrity: sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/babel-preset-jest/-/babel-preset-jest-29.6.3.tgz}
     id: registry.npmmirror.com/babel-preset-jest/29.6.3
@@ -10722,14 +10734,14 @@ packages:
     peerDependencies:
       webpack: ^5.0.0
     dependencies:
-      icss-utils: registry.npmmirror.com/icss-utils@5.1.0(postcss@8.4.4)
-      postcss: registry.npmmirror.com/postcss@8.4.4
-      postcss-modules-extract-imports: registry.npmmirror.com/postcss-modules-extract-imports@3.0.0(postcss@8.4.4)
-      postcss-modules-local-by-default: registry.npmmirror.com/postcss-modules-local-by-default@4.0.3(postcss@8.4.4)
-      postcss-modules-scope: registry.npmmirror.com/postcss-modules-scope@3.0.0(postcss@8.4.4)
-      postcss-modules-values: registry.npmmirror.com/postcss-modules-values@4.0.0(postcss@8.4.4)
+      icss-utils: registry.npmmirror.com/icss-utils@5.1.0(postcss@8.4.27)
+      postcss: registry.npmmirror.com/postcss@8.4.27
+      postcss-modules-extract-imports: registry.npmmirror.com/postcss-modules-extract-imports@3.0.0(postcss@8.4.27)
+      postcss-modules-local-by-default: registry.npmmirror.com/postcss-modules-local-by-default@4.0.3(postcss@8.4.27)
+      postcss-modules-scope: registry.npmmirror.com/postcss-modules-scope@3.0.0(postcss@8.4.27)
+      postcss-modules-values: registry.npmmirror.com/postcss-modules-values@4.0.0(postcss@8.4.27)
       postcss-value-parser: registry.npmmirror.com/postcss-value-parser@4.2.0
-      semver: registry.npmmirror.com/semver@7.3.5
+      semver: registry.npmmirror.com/semver@7.5.4
       webpack: registry.npmmirror.com/webpack@5.64.4
     dev: false
 
@@ -11680,7 +11692,7 @@ packages:
     name: domutils
     version: 1.5.1
     dependencies:
-      dom-serializer: registry.npmmirror.com/dom-serializer@0.1.1
+      dom-serializer: registry.npmmirror.com/dom-serializer@0.2.2
       domelementtype: registry.npmmirror.com/domelementtype@1.3.1
     dev: true
 
@@ -15115,7 +15127,7 @@ packages:
       safer-buffer: registry.npmmirror.com/safer-buffer@2.1.2
     dev: false
 
-  registry.npmmirror.com/icss-utils@5.1.0(postcss@8.4.4):
+  registry.npmmirror.com/icss-utils@5.1.0(postcss@8.4.27):
     resolution: {integrity: sha512-soFhflCVWLfRNOPU3iv5Z9VUdT44xFRbzjLsEzSr5AQmgqPMTHdU3PMT1Cf1ssx8fLNJDA1juftYl+PUcv3MqA==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/icss-utils/-/icss-utils-5.1.0.tgz}
     id: registry.npmmirror.com/icss-utils/5.1.0
     name: icss-utils
@@ -15124,7 +15136,7 @@ packages:
     peerDependencies:
       postcss: ^8.1.0
     dependencies:
-      postcss: registry.npmmirror.com/postcss@8.4.4
+      postcss: registry.npmmirror.com/postcss@8.4.27
     dev: false
 
   registry.npmmirror.com/idb@6.1.5:
@@ -21294,7 +21306,7 @@ packages:
     engines: {node: '>=10.0'}
     dependencies:
       camelcase-css: registry.npmmirror.com/camelcase-css@2.0.1
-      postcss: registry.npmmirror.com/postcss@8.4.4
+      postcss: registry.npmmirror.com/postcss@8.4.27
     dev: false
 
   registry.npmmirror.com/postcss-lab-function@2.0.1:
@@ -21533,7 +21545,7 @@ packages:
       postcss-selector-parser: registry.npmmirror.com/postcss-selector-parser@6.0.13
     dev: false
 
-  registry.npmmirror.com/postcss-modules-extract-imports@3.0.0(postcss@8.4.4):
+  registry.npmmirror.com/postcss-modules-extract-imports@3.0.0(postcss@8.4.27):
     resolution: {integrity: sha512-bdHleFnP3kZ4NYDhuGlVK+CMrQ/pqUm8bx/oGL93K6gVwiclvX5x0n76fYMKuIGKzlABOy13zsvqjb0f92TEXw==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/postcss-modules-extract-imports/-/postcss-modules-extract-imports-3.0.0.tgz}
     id: registry.npmmirror.com/postcss-modules-extract-imports/3.0.0
     name: postcss-modules-extract-imports
@@ -21542,10 +21554,10 @@ packages:
     peerDependencies:
       postcss: ^8.1.0
     dependencies:
-      postcss: registry.npmmirror.com/postcss@8.4.4
+      postcss: registry.npmmirror.com/postcss@8.4.27
     dev: false
 
-  registry.npmmirror.com/postcss-modules-local-by-default@4.0.3(postcss@8.4.4):
+  registry.npmmirror.com/postcss-modules-local-by-default@4.0.3(postcss@8.4.27):
     resolution: {integrity: sha512-2/u2zraspoACtrbFRnTijMiQtb4GW4BvatjaG/bCjYQo8kLTdevCUlwuBHx2sCnSyrI3x3qj4ZK1j5LQBgzmwA==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/postcss-modules-local-by-default/-/postcss-modules-local-by-default-4.0.3.tgz}
     id: registry.npmmirror.com/postcss-modules-local-by-default/4.0.3
     name: postcss-modules-local-by-default
@@ -21554,13 +21566,13 @@ packages:
     peerDependencies:
       postcss: ^8.1.0
     dependencies:
-      icss-utils: registry.npmmirror.com/icss-utils@5.1.0(postcss@8.4.4)
-      postcss: registry.npmmirror.com/postcss@8.4.4
+      icss-utils: registry.npmmirror.com/icss-utils@5.1.0(postcss@8.4.27)
+      postcss: registry.npmmirror.com/postcss@8.4.27
       postcss-selector-parser: registry.npmmirror.com/postcss-selector-parser@6.0.13
       postcss-value-parser: registry.npmmirror.com/postcss-value-parser@4.2.0
     dev: false
 
-  registry.npmmirror.com/postcss-modules-scope@3.0.0(postcss@8.4.4):
+  registry.npmmirror.com/postcss-modules-scope@3.0.0(postcss@8.4.27):
     resolution: {integrity: sha512-hncihwFA2yPath8oZ15PZqvWGkWf+XUfQgUGamS4LqoP1anQLOsOJw0vr7J7IwLpoY9fatA2qiGUGmuZL0Iqlg==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/postcss-modules-scope/-/postcss-modules-scope-3.0.0.tgz}
     id: registry.npmmirror.com/postcss-modules-scope/3.0.0
     name: postcss-modules-scope
@@ -21569,11 +21581,11 @@ packages:
     peerDependencies:
       postcss: ^8.1.0
     dependencies:
-      postcss: registry.npmmirror.com/postcss@8.4.4
+      postcss: registry.npmmirror.com/postcss@8.4.27
       postcss-selector-parser: registry.npmmirror.com/postcss-selector-parser@6.0.13
     dev: false
 
-  registry.npmmirror.com/postcss-modules-values@4.0.0(postcss@8.4.4):
+  registry.npmmirror.com/postcss-modules-values@4.0.0(postcss@8.4.27):
     resolution: {integrity: sha512-RDxHkAiEGI78gS2ofyvCsu7iycRv7oqw5xMWn9iMoR0N/7mf9D50ecQqUo5BZ9Zh2vH4bCUR/ktCqbB9m8vJjQ==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/postcss-modules-values/-/postcss-modules-values-4.0.0.tgz}
     id: registry.npmmirror.com/postcss-modules-values/4.0.0
     name: postcss-modules-values
@@ -21582,8 +21594,8 @@ packages:
     peerDependencies:
       postcss: ^8.1.0
     dependencies:
-      icss-utils: registry.npmmirror.com/icss-utils@5.1.0(postcss@8.4.4)
-      postcss: registry.npmmirror.com/postcss@8.4.4
+      icss-utils: registry.npmmirror.com/icss-utils@5.1.0(postcss@8.4.27)
+      postcss: registry.npmmirror.com/postcss@8.4.27
     dev: false
 
   registry.npmmirror.com/postcss-nested@5.0.6(postcss@8.4.4):
@@ -22076,7 +22088,7 @@ packages:
       cssesc: registry.npmmirror.com/cssesc@3.0.0
       util-deprecate: registry.npmmirror.com/util-deprecate@1.0.2
 
-  registry.npmmirror.com/postcss-sorting@6.0.0(postcss@8.4.4):
+  registry.npmmirror.com/postcss-sorting@6.0.0(postcss@8.4.27):
     resolution: {integrity: sha512-bYJ0vgAiGbjCBKi7B07CzsBc9eM84nLEbavUmwNp8rAa+PNyrgdH+6PpnqTtciLuUs99c4rFQQmCaYgeBQYmSQ==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/postcss-sorting/-/postcss-sorting-6.0.0.tgz}
     id: registry.npmmirror.com/postcss-sorting/6.0.0
     name: postcss-sorting
@@ -22085,7 +22097,7 @@ packages:
       postcss: ^8.0.4
     dependencies:
       lodash: registry.npmmirror.com/lodash@4.17.21
-      postcss: registry.npmmirror.com/postcss@8.4.4
+      postcss: registry.npmmirror.com/postcss@8.4.27
     dev: true
 
   registry.npmmirror.com/postcss-svgo@5.1.0(postcss@8.4.4):
@@ -22200,6 +22212,7 @@ packages:
       nanoid: registry.npmmirror.com/nanoid@3.3.6
       picocolors: registry.npmmirror.com/picocolors@1.0.0
       source-map-js: registry.npmmirror.com/source-map-js@1.0.2
+    dev: false
 
   registry.npmmirror.com/preferred-pm@3.0.3:
     resolution: {integrity: sha512-+wZgbxNES/KlJs9q40F/1sfOd/j7f1O9JaHcW5Dsn3aUUOZg3L2bjpVUcKV2jvtElYfoTuQiNeMfQJ4kwUAhCQ==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/preferred-pm/-/preferred-pm-3.0.3.tgz}
@@ -22254,9 +22267,9 @@ packages:
     peerDependencies:
       prettier: '>= 2.0.0'
     dependencies:
-      postcss: registry.npmmirror.com/postcss@8.4.4
+      postcss: registry.npmmirror.com/postcss@8.4.27
       postcss-less: registry.npmmirror.com/postcss-less@4.0.1
-      postcss-sorting: registry.npmmirror.com/postcss-sorting@6.0.0(postcss@8.4.4)
+      postcss-sorting: registry.npmmirror.com/postcss-sorting@6.0.0(postcss@8.4.27)
       prettier: registry.npmmirror.com/prettier@2.8.8
     dev: true
 
@@ -23769,7 +23782,6 @@ packages:
     dependencies:
       '@babel/runtime': registry.npmmirror.com/@babel/runtime@7.22.10
       react: registry.npmmirror.com/react@18.2.0
-    dev: false
 
   registry.npmmirror.com/react-error-overlay@6.0.11:
     resolution: {integrity: sha512-/6UZ2qgEyH2aqzYZgQPxEnz33NJ2gNsnHA2o5+o4wW9bLM/JYQitNP9xPhsXwC08hMMovfGe/8retsdDsczPRg==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/react-error-overlay/-/react-error-overlay-6.0.11.tgz}
@@ -24010,7 +24022,6 @@ packages:
     engines: {node: '>=0.10.0'}
     dependencies:
       loose-envify: registry.npmmirror.com/loose-envify@1.4.0
-    dev: false
 
   registry.npmmirror.com/read-pkg-up@4.0.0:
     resolution: {integrity: sha512-6etQSH7nJGsK0RbG/2TeDzZFa8shjQ1um+SwQQ5cwKy0dhSXdOncEhb1CPpvQG4h7FyOV6EB6YlV0yJvZQNAkA==, registry: https://registry.npm.taobao.org/, tarball: https://registry.npmmirror.com/read-pkg-up/-/read-pkg-up-4.0.0.tgz}

scripts/build.js

@@ -1,6 +1,6 @@
 const ch = require("child_process");
 
-const packages = ["utils", "service", "pc-components"];
+const packages = ["utils", "service", "pc-components", "krpano"];
 
 packages.forEach((p) => {
   console.log(`********  build package: ${p} ************`);

scripts/publish.js

@@ -1,6 +1,13 @@
 const ch = require("child_process");
 
-const packages = ["backend-cli", "service", "events", "pc-components", "utils"];
+const packages = [
+  "backend-cli",
+  "service",
+  "events",
+  "pc-components",
+  "utils",
+  "krpano",
+];
 
 packages.forEach((name) => {
   if (!["backend-cli", "events"].includes(name)) {