@realsee/dnalogel 3.64.23-alpha.4 → 3.64.23-ke-webgpu.1

package/dist/shared-utils/CSS3DRender/index.d.ts

@@ -1,2 +1,2 @@
-import { Five } from '@realsee/five';
+import { Five } from '@realsee/five-webgpu';
 export declare function initialCSS3DRender(five: Five): () => any;

package/dist/shared-utils/Object3DHelper/Helper/Objects/ArrowGroup.d.ts

@@ -6,7 +6,7 @@ interface InstanceParameter {
     color?: THREE.Color | string | number;
 }
 export declare class ArrowGroup extends DirectionGroup {
-    line: DirectionMesh<THREE.Geometry, THREE.MeshBasicMaterial>;
+    line: DirectionMesh<THREE.BufferGeometry, THREE.MeshBasicMaterial>;
     arrow: DirectionMesh<THREE.ConeGeometry, THREE.MeshBasicMaterial>;
     private lineHeight;
     private arrowHeight;

package/dist/shared-utils/Object3DHelper/utils/cameraHooks.d.ts

@@ -1,2 +1,3 @@
+import type * as THREE from 'three';
 export declare function cameraHooks(camera: THREE.Camera): any;
 export declare function disposeCameraHooks(camera: THREE.Camera): void;

package/dist/shared-utils/Object3DHelper/utils/direction.d.ts

@@ -4,11 +4,11 @@ export declare class DirectionGroup extends THREE.Group {
     direction: Direction;
     constructor(direction?: Direction);
 }
-export declare class DirectionLine<T extends THREE.Geometry, K extends THREE.Material> extends THREE.Line<T, K> {
+export declare class DirectionLine<T extends THREE.BufferGeometry, K extends THREE.Material> extends THREE.Line<T, K> {
     direction: Direction;
     constructor(geometry?: T, material?: K, direction?: Direction);
 }
-export declare class DirectionMesh<T extends THREE.Geometry, K extends THREE.Material> extends THREE.Mesh<T, K> {
+export declare class DirectionMesh<T extends THREE.BufferGeometry, K extends THREE.Material> extends THREE.Mesh<T, K> {
     direction: Direction;
     constructor(geometry?: T, material?: K, direction?: Direction);
 }

package/dist/shared-utils/Utils/BaseUtil.d.ts

@@ -1,4 +1,4 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 import { Subscribe, type EventMap } from '../Subscribe';
 export declare class BaseUtil<Event extends EventMap = {}> extends Subscribe<Event> {
     five: Five;

package/dist/shared-utils/Utils/FiveUtil.d.ts

@@ -1,11 +1,11 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 import { BaseUtil } from './BaseUtil';
 import { WorkUtil } from './WorkUtil';
 export declare class FiveUtil extends BaseUtil {
     workUtil: WorkUtil;
     get version(): string;
     get majorVersion(): number;
-    get model(): import("@realsee/five").Model;
+    get model(): import("@realsee/five-webgpu").Model;
     constructor(five: Five);
     moveToPano(panoNumber: number, movePanoOptions: Parameters<Five['moveToPano']>[1]): Promise<void>;
 }

package/dist/shared-utils/Utils/WorkUtil.d.ts

@@ -1,4 +1,4 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 import { BaseUtil } from './BaseUtil';
 import * as THREE from 'three';
 export type WorkFromType = 'poincare' | 'aerophoto' | 'vr' | 'weilaijia' | 'sand';
@@ -16,11 +16,11 @@ export declare class WorkUtil extends BaseUtil {
     /**
      * @description 获取当前的 work
      */
-    get work(): import("@realsee/five").Work;
-    get observers(): import("@realsee/five").WorkObserver[];
+    get work(): import("@realsee/five-webgpu").Work;
+    get observers(): readonly import("@realsee/five-webgpu").WorkObserver[];
     get transform(): THREE.Matrix4;
     constructor(five: Five);
-    getResolvedObserver(observerIndex: number): import("@realsee/five").WorkResolvedObserver;
+    getResolvedObserver(observerIndex: number): import("@realsee/five-webgpu").WorkResolvedObserver;
     /**
      * @description 获取全景点坐标
      */
@@ -32,5 +32,5 @@ export declare class WorkUtil extends BaseUtil {
     /**
      * @description 获取observer
      */
-    getObserver(observerIndex: number): import("@realsee/five").WorkObserver;
+    getObserver(observerIndex: number): import("@realsee/five-webgpu").WorkObserver;
 }

package/dist/shared-utils/changeModelCanvasOpacity.d.ts

@@ -1,2 +1,2 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 export default function changeModelCanvasOpacity(five: Five, opacity: number, duration?: number): void;

package/dist/shared-utils/createCanvasTextTexture.d.ts

@@ -5,4 +5,4 @@ export default function createCanvasTextTexture(text: string, config?: {
     backgroundColor?: string;
     fontColor?: string;
     textAlign?: CanvasTextAlign;
-}): CanvasTexture;
+}): CanvasTexture<HTMLCanvasElement>;

package/dist/shared-utils/five/FiveDomEvents.d.ts

@@ -6,7 +6,7 @@
  * 3. 基于第二点，废弃了之前使用浏览器原生事件监听点击的方式，改为使用 wantsTapGesture 的方式
  * 4. 重构之后只会在 wantsTapGesture 事件触发的时候做射线检测
  */
-import type { Five, Model as FiveModel } from '@realsee/five';
+import type { Five, Model as FiveModel } from '@realsee/five-webgpu';
 import type * as THREE from 'three';
 export interface FiveDomEventMap {
     /**

package/dist/shared-utils/five/FiveLine.d.ts

@@ -1,10 +1,35 @@
-import { Line as Five_Line } from '@realsee/five/line';
 import * as THREE from 'three';
+import { Line2NodeMaterial } from 'three/webgpu';
+import { Line2 } from 'three/examples/jsm/lines/webgpu/Line2.js';
 export type Color = THREE.Color | string | number;
-export declare class FiveLine extends Five_Line {
-    constructor(...args: ConstructorParameters<typeof Five_Line>);
-    toJSON(): {
-        type: string;
-        points: any;
-    };
+/**
+ * 由 `@realsee/five/line` 的 `Line` 移植而来。
+ *
+ * five-webgpu 移除了 `line` 入口（旧 five 是把 three 的 line addons vendored 进 `lib/line/utils/`
+ * 再加这个自研类），且全 `lib/` 无任何等价实现，因此把它移植到 dnalogel 内部。
+ *
+ * 与原实现的差异：
+ * 1. 粗线材质换成 `Line2NodeMaterial`（WebGPU 下 `lines/LineMaterial.js` 是 ShaderMaterial，不可用）
+ * 2. 去掉了 `setResolution`。resolution 已从材质移到对象上，且 WebGPU 版 `LineSegments2.onBeforeRender`
+ *    会自己用当前 viewport 维护 `_resolution`，不需要外部干预
+ * 3. 原实现里 `setMaterial` 对 `dashed` 的特殊处理（改 `defines.USE_DASH` 再置 `needsUpdate`）已删除，
+ *    `Line2NodeMaterial` 原生支持 `dashed` 属性，且 NodeMaterial 没有 `defines`
+ */
+export declare class FiveLine extends THREE.Object3D {
+    line: Line2;
+    points: THREE.Points<THREE.BufferGeometry, THREE.PointsMaterial>;
+    needsRender: boolean;
+    readonly isFiveLine = true;
+    /** r183 起 `Object3D.type` 是 readonly，不能像原实现那样在构造函数里赋值，改为字段声明 */
+    readonly type = "FiveLine";
+    constructor(vector0?: THREE.Vector3, vector1?: THREE.Vector3);
+    setPoints(vector0: THREE.Vector3, vector1: THREE.Vector3): void;
+    getPoints(): [THREE.Vector3, THREE.Vector3];
+    setMaterial(map: ConstructorParameters<typeof Line2NodeMaterial>[0]): void;
+    /**
+     * ⚠️ 这是 ke 分支既有的调试用重写，返回的是精简结构，并不满足 three 的 `Object3DJSON` 契约。
+     * r183 给 `toJSON` 加了严格返回类型才暴露出来。经确认 dnalogel 内部无任何调用方，
+     * 故迁移阶段只做类型让行、不改变行为；是否应改名（避免污染 three 的序列化链路）留作后续决策。
+     */
+    toJSON(): THREE.Object3DJSON;
 }

package/dist/shared-utils/five/FivePuppet.d.ts

@@ -1,4 +1,4 @@
-import { Five } from '@realsee/five';
+import { Five } from '@realsee/five-webgpu';
 import * as THREE from 'three';
 /**
  * @description 模拟 Five 行为的 canvas，与 Five 唯一区别是 scene 是空的

package/dist/shared-utils/five/changeMode.d.ts

@@ -1,3 +1,3 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 /** 等待 five changeMode 结束 */
 export default function changeMode(five: Five, changeModeParams: Parameters<Five['changeMode']>): Promise<boolean>;

package/dist/shared-utils/five/fiveEveryReadyListener.d.ts

@@ -1,2 +1,2 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 export declare function fiveEveryReadyListener(five: Five, callback: () => void): () => void;

package/dist/shared-utils/five/fiveLoaded.d.ts

@@ -1,2 +1,2 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 export declare function waitFiveLoaded(five: Five): Promise<void>;

package/dist/shared-utils/five/fiveModelLoad.d.ts

@@ -1,4 +1,4 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 /**
  * @description: 等待 five model 加载完成
  */

package/dist/shared-utils/five/getFiveModel.d.ts

@@ -1,2 +1,2 @@
-import { Five } from '@realsee/five';
-export declare function getFiveModel(five: Five): import("@realsee/five").Model;
+import { Five } from '@realsee/five-webgpu';
+export declare function getFiveModel(five: Five): import("@realsee/five-webgpu").Model;

package/dist/shared-utils/five/getFloorIndex.d.ts

@@ -1,4 +1,4 @@
-import type { Work } from '@realsee/five';
+import type { Work } from '@realsee/five-webgpu';
 export default function getFloorIndex(work: Work, point: {
     y: number;
 }): number;

package/dist/shared-utils/five/getPosition.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 interface IIntersection extends THREE.Intersection {
     raycaster: THREE.Raycaster;
     isVirtual: boolean;

package/dist/shared-utils/five/getRaycasterByNdcPosition.d.ts

@@ -1,4 +1,4 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 import * as THREE from 'three';
 export declare function getRaycasterByNdcPosition(five: Five, position: {
     x: number;

package/dist/shared-utils/five/index.d.ts

@@ -1,4 +1,4 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 /** Five 模型是否加载完成 */
 export declare function checkFiveModelLoaded(five: Five): {
     result: boolean;

package/dist/shared-utils/five/lookObject.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 /**
  * @description 以最佳视角观察物体
  * @param five five 实例

package/dist/shared-utils/five/lookPoint.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 /**
  * @description 以最佳视角看向一个三维空间点
  * @param five five 实例

package/dist/shared-utils/five/mode.d.ts

@@ -1,3 +1,3 @@
-import type { Mode } from '@realsee/five';
+import type { Mode } from '@realsee/five-webgpu';
 export declare function isPanoramaLike(mode: Mode): boolean;
 export declare function isModelLike(mode: Mode): boolean;

package/dist/shared-utils/getPxmm.d.ts

@@ -1,4 +1,4 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 import { FLOOR_PLAN_ATTACHED_TO } from '../floorplan/constant';
 interface GetPxmmOption {
     attachedTo: FLOOR_PLAN_ATTACHED_TO;

package/dist/shared-utils/object3d2LocalMatrix.d.ts

@@ -8,5 +8,5 @@ declare const bject3d2LocalMatrix: (mesh: THREE.Object3D, { scale, rotation, pos
         y: number;
         z: number;
     };
-}) => THREE.Object3D;
+}) => THREE.Object3D<THREE.Object3DEventMap>;
 export default bject3d2LocalMatrix;

package/dist/shared-utils/tag.d.ts

@@ -1,4 +1,4 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 import { type AnyPosition } from './positionToVector3';
 import * as THREE from 'three';
 export declare class LightTag {

package/dist/shared-utils/three/Extras/Curves/BezierCurve3.d.ts

@@ -1,12 +1,13 @@
 import * as THREE from 'three';
 declare class CustomBezierCurve3 extends THREE.Curve<THREE.Vector3> {
-    type: string;
+    /** r183 起 Curve.type 是 readonly，不能像原实现那样在构造函数里赋值，改为字段声明 */
+    readonly type = "CustomBezierCurve3";
     controlPoints: THREE.Vector3[];
     constructor(controlPoints?: THREE.Vector3[]);
     getPoint(t: number, optionalTarget?: THREE.Vector3): THREE.Vector3;
     copy(source: CustomBezierCurve3): this;
-    toJSON(): object & {
-        controlPoints: number[][];
+    toJSON(): THREE.CurveJSON & {
+        controlPoints: THREE.Vector3Tuple[];
     };
     fromJSON(json: any): this;
 }

package/dist/shared-utils/three/FragmentTransparencyMaterial.d.ts

@@ -1,17 +1,15 @@
 import * as THREE from 'three';
-export declare class FragmentTransparencyMaterial extends THREE.ShaderMaterial {
-    uniforms: {
-        map: {
-            value: THREE.Texture;
-        };
-    };
-    transparent: boolean;
-    blending: THREE.Blending;
-    blendSrc: THREE.BlendingDstFactor;
-    blendDst: THREE.BlendingDstFactor;
-    blendSrcAlpha: THREE.BlendingDstFactor;
-    blendDstAlpha: THREE.BlendingDstFactor;
-    vertexShader: string;
-    fragmentShader: string;
+/**
+ * 「保持在不透明渲染队列里，但仍做 alpha 混合」的贴图材质。
+ *
+ * 原实现是一个 `ShaderMaterial`，但它的 GLSL 只有一行 `gl_FragColor = texture2D(map, vUv)`，
+ * 即纯粹的贴图采样，没有任何自定义计算 —— 真正起作用的是下面那套自定义混合配置
+ * （`transparent = false` 保证它留在不透明队列、不参与透明排序，同时用 `CustomBlending`
+ * 强制开启 SrcAlpha / OneMinusSrcAlpha 混合）。
+ *
+ * WebGPU 不消费裸 GLSL，而这个 shader 又无需保留，因此直接降级为内置 `MeshBasicMaterial`
+ * 并原样保留混合参数，视觉与原实现等价。
+ */
+export declare class FragmentTransparencyMaterial extends THREE.MeshBasicMaterial {
     constructor(texture: THREE.Texture);
 }

package/dist/shared-utils/three/GLTFLoader.d.ts

@@ -1,2 +1,13 @@
-import type { GLTF } from '@realsee/five/gltf-loader';
-export default function loadGLTF(url: string): Promise<GLTF>;
+import { loadGltf } from '@realsee/five-webgpu';
+export type GLTFLoadResult = Awaited<ReturnType<typeof loadGltf>>;
+/**
+ * five-webgpu 移除了 `gltf-loader` 入口，改为顶层导出 `loadGltf`（url → Promise）。
+ * 本函数对外契约不变，仍是 `loadGLTF(url): Promise<...>`，只是结果类型从 `GLTF` 变成
+ * five 的 `LoadResultType`（`scene` / `textures` / `animations` / `dispose` 等）。
+ *
+ * ⚠️ `upAxis: 'Y'` 不可省略。`loadGltf` 默认 `modelUpAxis='Y'` + `upAxis='Z'`，会给内容
+ * 叠一次 ROTATE_X_MATRIX 把模型从 Y-up 转成 Z-up；而原先的 three GLTFLoader 不做任何旋转。
+ * 显式传 `upAxis: 'Y'` 会再叠一次 ROTATE_X_MATRIX_INVERSE，两次抵消，从而保持原朝向。
+ * 若省略，PanoTag 的 3D 模型标签会整体躺倒 90°。
+ */
+export default function loadGLTF(url: string): Promise<import("@realsee/five-webgpu").LoadResultType>;

package/dist/shared-utils/three/Magnifier.d.ts

@@ -1,4 +1,4 @@
-import type { Five, SubscribeEventMap } from '@realsee/five';
+import type { Five, SubscribeEventMap } from '@realsee/five-webgpu';
 import Hammer from 'hammerjs';
 import * as THREE from 'three';
 import { Subscribe } from '../Subscribe';
@@ -57,7 +57,25 @@ export declare class Magnifier {
         y: number;
     }): void;
     resetOffset(): void;
-    render(): void;
+    /**
+     * WebGPU 不支持同步回读像素，five-webgpu 的 `getPixels()` 因此返回 `Promise`，本方法随之变为 async。
+     *
+     * 现有约 10 个调用点都是即发即忘（不 await），签名变化对它们透明；
+     * 但异步化带来了并发问题：逐帧调用时多个回读可能交错完成、乱序写入 canvas。
+     *
+     * 这里的策略是「丢中间帧、但绝不丢最后一帧」：
+     * 有回读在途时不再并发发起，只登记 `renderRequested`；当前这次结束后再补跑一次。
+     *
+     * ⚠️ 不能简单地「在途就 return」了事：调用方是先更新 `renderCenter` 再调 `render()` 的
+     * （见 renderWithPoint / renderWithScreenPoint）。若直接丢弃，手指抬起前的最后一次调用
+     * 恰好撞上在途回读时，这一帧就永远不会被渲染，放大镜会停在上一个位置不动。
+     * `renderOnce()` 每次都重新读 `this.renderCenter`，所以补跑拿到的是最新位置。
+     */
+    render(): Promise<void>;
+    private renderPending;
+    /** 在途期间是否又来了新的渲染请求，用于结束后补跑最后一帧 */
+    private renderRequested;
+    private renderOnce;
     protected getRenderCenter(): THREE.Vector3 | {
         x: number;
         y: number;

package/dist/shared-utils/three/PointSelector/index.d.ts

@@ -1,4 +1,4 @@
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 import { PointSelectorHelper, type PointIntersection, type PointSelectorHelperConfig } from './utils/PointSelectorHelper';
 import type { Vector3 } from 'three';
 import * as THREE from 'three';
@@ -6,7 +6,12 @@ import { Subscribe } from '../../Subscribe';
 import type { LiteralString } from '../../../typings/utils.type';
 export type { PointIntersection };
 export type ActionIfNoIntersection = LiteralString<'virtualPoint' | 'lastPoint' | 'disable'>;
-export type AdherePoint = (Vector3 | THREE.Face3) & {
+/**
+ * r125 移除了 `THREE.Face3` 类，r183 的对应物是 `Face` —— 但它是纯 interface，无法 `instanceof`。
+ * 这里用结构判断代替：`Face` 有 `normal`，`Vector3` 没有。
+ */
+export declare function isFace(point: Vector3 | THREE.Face): point is THREE.Face;
+export type AdherePoint = (Vector3 | THREE.Face) & {
     /**
      * @description 被模型遮挡也能看到的点
      */

package/dist/shared-utils/three/PointSelector/utils/PointHelper.d.ts

@@ -1,16 +1,17 @@
 import * as THREE from 'three';
+import { MeshBasicNodeMaterial } from 'three/webgpu';
 import type { Intersection } from '../../../../typings/typings';
 import type { PointHelperAbstract } from './typing';
 import { CSS3DObjectPlus } from '../../../../CSS3DRenderPlugin/utils/three/CSS3DObject';
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 export interface MouseGroupParameter {
     isMobile?: boolean;
     useNormalVector?: boolean;
     ballColor?: number;
 }
-declare function createPlaneMesh(): THREE.Mesh<THREE.PlaneGeometry, THREE.MeshBasicMaterial>;
-declare function createLineMesh(): THREE.Mesh<THREE.TubeGeometry, THREE.ShaderMaterial>;
-declare function createBallMesh(): THREE.Mesh<THREE.SphereGeometry, THREE.MeshBasicMaterial>;
+declare function createPlaneMesh(): THREE.Mesh<THREE.PlaneGeometry, THREE.MeshBasicMaterial, THREE.Object3DEventMap>;
+declare function createLineMesh(): THREE.Mesh<THREE.TubeGeometry, MeshBasicNodeMaterial, THREE.Object3DEventMap>;
+declare function createBallMesh(): THREE.Mesh<THREE.SphereGeometry, THREE.MeshBasicMaterial, THREE.Object3DEventMap>;
 declare function createBorderMesh(): CSS3DObjectPlus<HTMLElement>;
 type PlanMesh = ReturnType<typeof createPlaneMesh>;
 type LineMesh = ReturnType<typeof createLineMesh>;

package/dist/shared-utils/three/PointSelector/utils/PointHelper2.d.ts

@@ -1,6 +1,7 @@
 import * as THREE from 'three';
+import { MeshBasicNodeMaterial } from 'three/webgpu';
 import type { Intersection } from '../../../../typings/typings';
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 import type { PointHelperAbstract } from './typing';
 import { ICSS3DSprite } from '../../../../CSS3DRenderPlugin/utils/three/CSS3DSprite';
 export interface MouseGroupParameter {
@@ -8,11 +9,11 @@ export interface MouseGroupParameter {
     useNormalVector?: boolean;
     ballColor?: number;
 }
-declare function createPlaneMesh(): THREE.Mesh<THREE.CircleGeometry, THREE.ShaderMaterial>;
-declare function createCrossline(): THREE.Group;
-declare function createLineMesh(length: number): THREE.Mesh<THREE.TubeGeometry, THREE.MeshBasicMaterial>;
-declare function createRingMesh(): THREE.Mesh<THREE.RingGeometry, THREE.MeshBasicMaterial>;
-declare function createBallMesh(): THREE.Mesh<THREE.SphereGeometry, THREE.MeshBasicMaterial>;
+declare function createPlaneMesh(): THREE.Mesh<THREE.CircleGeometry, MeshBasicNodeMaterial, THREE.Object3DEventMap>;
+declare function createCrossline(): THREE.Group<THREE.Object3DEventMap>;
+declare function createLineMesh(length: number): THREE.Mesh<THREE.TubeGeometry, THREE.MeshBasicMaterial, THREE.Object3DEventMap>;
+declare function createRingMesh(): THREE.Mesh<THREE.RingGeometry, THREE.MeshBasicMaterial, THREE.Object3DEventMap>;
+declare function createBallMesh(): THREE.Mesh<THREE.SphereGeometry, THREE.MeshBasicMaterial, THREE.Object3DEventMap>;
 declare function createCSSBallMesh(): ICSS3DSprite;
 export declare class PointHelper2 extends THREE.Object3D implements PointHelperAbstract {
     disableGetPixel: boolean;

package/dist/shared-utils/three/PointSelector/utils/PointSelectorHelper.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import type { Five } from '@realsee/five';
+import type { Five } from '@realsee/five-webgpu';
 import { Magnifier } from '../..';
 import type { Intersection } from '../../../../typings/typings';
 import { Subscribe } from '../../../Subscribe';

package/dist/shared-utils/three/applyObjectMatrixWorld.d.ts

@@ -1,3 +1,4 @@
+import type * as THREE from 'three';
 import type { Object3D } from 'three';
 export declare function localToWorld<P extends THREE.Vector3 | THREE.Vector3[]>(object: Object3D, point: P): P;
 export declare function worldToLocal<P extends THREE.Vector3 | THREE.Vector3[]>(object: Object3D, point: P): P;

package/dist/shared-utils/three/circleImageURL.d.ts

@@ -0,0 +1,21 @@
+import { Texture } from 'three';
+/**
+ * 圆形点贴图（32x32 PNG，白色实心圆带柔边）
+ *
+ * 原先分别存在于 five 的 `lib/line/circle_png.ts` 与 dnalogel 的 `Sculpt/Meshes/Point.ts`，
+ * 两份 base64 实测完全相同。WebGPU 迁移后 five 不再提供 `line` 入口，故收敛到 shared-utils，
+ * 由 `FiveLine` 与 `Sculpt/Meshes/Point` 共用。
+ */
+export declare const circleImageURL: string;
+/**
+ * 取共享的圆形点贴图。
+ *
+ * 收敛前 `Sculpt/Meshes/Point.ts` 与 `shared-utils/five/FiveLine.ts` 各自维护了一个
+ * 模块级 `sharedCircleTexture` 缓存，加载的却是同一张 base64，等于白占一份显存。
+ *
+ * 这里统一成一份，并显式声明 `SRGBColorSpace`：
+ * r183 起贴图默认 `NoColorSpace`（按线性数据处理），颜色贴图需自己声明 sRGB 才会做
+ * sRGB→linear 解码。本图是纯黑白 + alpha 柔边，0 和 1 在两种色彩空间下等价，
+ * 所以此处补声明是为了统一口径与避免误导，不改变实际观感。
+ */
+export declare function getSharedCircleTexture(): Texture;

package/dist/shared-utils/three/core/Line2.d.ts

@@ -1,13 +1,10 @@
-import { THREE_Line2 as Five_THREE_Line2 } from '@realsee/five/line';
+import { Line2 as Three_Line2 } from 'three/examples/jsm/lines/webgpu/Line2.js';
+import type * as THREE from 'three';
 import type { LineMaterial } from './LineMaterial';
 import type { LineGeometry } from './LineGeometry';
-export declare class THREE_Line2 extends Five_THREE_Line2 {
+export declare class THREE_Line2 extends Three_Line2 {
     material: LineMaterial;
     constructor(geometry: LineGeometry, material: LineMaterial);
-    toJSON(): {
-        type: string;
-        geometryAttributes: {
-            [name: string]: import("three").BufferAttribute | import("three").InterleavedBufferAttribute;
-        };
-    };
+    /** 同 FiveLine：ke 既有的调试用重写，不满足 r183 的 `MeshJSON` 契约，无调用方，仅做类型让行 */
+    toJSON(): THREE.MeshJSON;
 }

package/dist/shared-utils/three/core/LineGeometry.d.ts

@@ -1,13 +1,16 @@
 import type { WireframeGeometry } from 'three';
-import { LineGeometry as Five_LineGeometry } from '@realsee/five/line';
+import { LineGeometry as Three_LineGeometry } from 'three/examples/jsm/lines/LineGeometry.js';
 import * as THREE from 'three';
-export declare class LineGeometry extends Five_LineGeometry {
-    constructor(...args: ConstructorParameters<typeof Five_LineGeometry>);
+export declare class LineGeometry extends Three_LineGeometry {
+    constructor(...args: ConstructorParameters<typeof Three_LineGeometry>);
+    /**
+     * 空线也必须提供实例属性。Line2NodeMaterial 即使 instanceCount 为 0，
+     * 仍会要求绑定 instanceStart/End 和虚线使用的距离属性对应的 vertex buffer。
+     */
+    private setEmptyAttributes;
+    private setLineDistanceAttributes;
+    setPositions(array: Float32Array | Array<number>): this;
     fromEdgesGeometry(geometry: WireframeGeometry): this;
-    toJSON(): {
-        type: string;
-        attributes: {
-            [name: string]: THREE.BufferAttribute | THREE.InterleavedBufferAttribute;
-        };
-    };
+    /** 同 FiveLine：ke 既有的调试用重写，不满足 r183 的 `BufferGeometryJSON` 契约，无调用方，仅做类型让行 */
+    toJSON(): THREE.BufferGeometryJSON;
 }

package/dist/shared-utils/three/core/LineMaterial.d.ts

@@ -1,15 +1,14 @@
-import { LineMaterial as Five_LineMaterial } from '@realsee/five/line';
+import { Line2NodeMaterial } from 'three/webgpu';
 import * as THREE from 'three';
 import type { Merge } from 'type-fest';
 import type { Color } from '../../..';
-export declare class LineMaterial extends Five_LineMaterial {
+type Line2NodeMaterialParameters = ConstructorParameters<typeof Line2NodeMaterial>[0];
+export declare class LineMaterial extends Line2NodeMaterial {
     get three_color(): Color;
     set three_color(value: Color);
     private _three_color;
-    private _dashed;
-    constructor(params?: Merge<ConstructorParameters<typeof Five_LineMaterial>[0], THREE.MeshBasicMaterialParameters>);
-    toJSON(): {
-        type: string;
-        color: number | THREE.Vector3;
-    };
+    constructor(params?: Merge<Line2NodeMaterialParameters, THREE.MeshBasicMaterialParameters>);
+    /** 同 FiveLine：ke 既有的调试用重写，不满足 r183 的 `MaterialJSON` 契约，无调用方，仅做类型让行 */
+    toJSON(): THREE.MaterialJSON;
 }
+export {};

package/dist/shared-utils/three/core/LineMaterial2.d.ts

@@ -1,15 +1,18 @@
-import * as THREE from 'three';
-import type { Merge } from 'type-fest';
-import type { Color } from '../../..';
-import { Five_LineMaterial2 } from './Five_LineMaterial2';
-export declare class LineMaterial2 extends Five_LineMaterial2 {
-    get three_color(): Color;
-    set three_color(value: Color);
-    private _three_color;
-    private _dashed;
-    constructor(params?: Merge<ConstructorParameters<typeof Five_LineMaterial2>[0], THREE.MeshBasicMaterialParameters>);
-    toJSON(): {
-        type: string;
-        color: number | THREE.Vector3;
-    };
+import { LineMaterial } from './LineMaterial';
+/**
+ * 虚线粗线材质。
+ *
+ * 原先继承自 `Five_LineMaterial2` —— 那是 three 官方粗线材质
+ * （`examples/jsm/lines/LineMaterial`）的 vendored GLSL 拷贝（331 行），
+ * 与 `@realsee/five/line` 导出的 `LineMaterial` 其实是同一份实现，
+ * 连虚线的 `mod(vLineDistance, dashSize + gapSize) < dashSize` → `discard`
+ * 和端帽 discard 逻辑都逐行相同。
+ *
+ * WebGPU 下两者都换成官方 `Line2NodeMaterial`（原生支持 `dashed`）之后，
+ * 本类与 `LineMaterial` 已完全等价，因此直接继承它，并删除那份 vendored 拷贝。
+ *
+ * 保留独立类名只是为了不改动 `Sculpt/Meshes/Line.ts` 里
+ * 「line1 用实线材质、line2 用虚线材质」的既有写法。
+ */
+export declare class LineMaterial2 extends LineMaterial {
 }

package/dist/shared-utils/three/core/LineSegments.d.ts

@@ -1,7 +1,7 @@
 /** @file three.js 中声明有问题，这里重载一下声明 */
-import type { Geometry, BufferGeometry, Material } from 'three';
+import type { BufferGeometry, Material } from 'three';
 import { LineSegments as OriginLineSegments } from 'three';
-declare class LineSegments<TGeometry extends Geometry | BufferGeometry = Geometry | BufferGeometry, TMaterial extends Material | Material[] = Material | Material[]> extends OriginLineSegments<TGeometry, TMaterial> {
+declare class LineSegments<TGeometry extends BufferGeometry = BufferGeometry, TMaterial extends Material | Material[] = Material | Material[]> extends OriginLineSegments<TGeometry, TMaterial> {
     geometry: TGeometry;
     material: TMaterial;
     constructor(geometry: TGeometry, material: TMaterial);

package/dist/shared-utils/three/core/Object3D.d.ts

@@ -2,7 +2,7 @@ import * as THREE from 'three';
 export declare class Object3D<ChildeItem extends THREE.Object3D = THREE.Object3D> extends THREE.Object3D {
     children: ChildeItem[];
     /** 获取 raycaster 与当前物体的交点 */
-    getRaycastIntersects(raycaster: THREE.Raycaster): THREE.Intersection[];
+    getRaycastIntersects(raycaster: THREE.Raycaster): THREE.Intersection<THREE.Object3D<THREE.Object3DEventMap>>[];
     /** 获取 raycaster 与当前物体的第一个交点 */
-    getRaycastIntersection(raycaster: THREE.Raycaster): THREE.Intersection;
+    getRaycastIntersection(raycaster: THREE.Raycaster): THREE.Intersection<THREE.Object3D<THREE.Object3DEventMap>>;
 }

package/dist/shared-utils/three/index.d.ts

@@ -7,7 +7,3 @@ export * from './core/Object3D';
 export * from './core/LineSegments';
 export * from './boundingBox';
 export * from './blink';
-export * from './getIntersect';
-export * from './getRaycaster';
-export * from './PointDomHelper';
-export * from './LegacyPointHelper';