u-space 0.0.15 → 0.0.16

package/dist/plugins/u-manager/semantics/BuildingGroup.d.ts

@@ -1,5 +1,6 @@
 import { BaseGroup } from 'u-space';
 import type { FloorMesh } from './FloorMesh';
+import type { SemanticKind } from './types';
 export declare class BuildingGroup extends BaseGroup {
     isBuildingGroup: boolean;
     type: string;
@@ -10,6 +11,6 @@ export declare class BuildingGroup extends BaseGroup {
     removeFloor(mesh: FloorMesh): this;
     isolateFloor(mesh: FloorMesh | number): this;
     showAllFloors(): this;
-    planishFloors(): this;
-    unplanishFloors(): this;
+    planishFloors(kind?: SemanticKind): this;
+    unplanishFloors(kind?: SemanticKind): this;
 }

package/dist/plugins/u-manager/semantics/FloorMesh.d.ts

@@ -1,6 +1,6 @@
 import { Box3, Matrix4, Sphere, Vector3, Vector4, type Intersection, type Raycaster } from 'three/webgpu';
 import { BaseMesh } from 'u-space';
-import type { SemanticColor, SemanticGeometryEntry } from './types';
+import type { SemanticColor, SemanticGeometryEntry, SemanticKind } from './types';
 export declare class FloorMesh extends BaseMesh {
     #private;
     isFloorMergedSemanticMesh: boolean;
@@ -14,13 +14,13 @@ export declare class FloorMesh extends BaseMesh {
     windowsInstances: Map<string, number>;
     semanticInstances: Map<string, number>;
     constructor(entries: SemanticGeometryEntry[]);
-    planish(): void;
-    unplanish(): void;
+    planish(kind?: SemanticKind): this;
+    unplanish(kind?: SemanticKind): this;
     get semanticCount(): number;
     get instanceCount(): number;
     getSemanticIndexById(id: string): number | undefined;
     getSemanticIdAt(index: number): string;
-    getSemanticKindAt(index: number): import("./types").SemanticKind;
+    getSemanticKindAt(index: number): SemanticKind;
     getSemanticNameAt(index: number): string | undefined;
     setColorAt(index: number, color: SemanticColor): this;
     getColorAt(index: number, target?: Vector4): Vector4;
@@ -30,6 +30,7 @@ export declare class FloorMesh extends BaseMesh {
     getVisibleAt(index: number): boolean;
     setMatrixAt(index: number, matrix: Matrix4): this;
     setScaleAt(index: number, scale: number | Vector3, y?: number, z?: number): this;
+    setScaleYAt(index: number, y: number): this;
     getMatrixAt(index: number, matrix?: Matrix4): Matrix4;
     getFinalMatrixAt(index: number, matrix?: Matrix4): Matrix4;
     computeBoundingBox(): void;

package/dist/plugins/u-manager/semantics/types.d.ts

@@ -1,5 +1,5 @@
 import type { BufferGeometry, Color, Matrix4, Vector3, Vector4 } from 'three/webgpu';
-export type SemanticKind = 'WALL' | 'COLUMN' | 'SPACE' | 'Doors' | 'Windows';
+export type SemanticKind = 'Walls' | 'Columns' | 'Spaces' | 'Doors' | 'Windows';
 export type SemanticColor = Color | Vector3 | Vector4;
 export interface SemanticGeometryEntry {
     id: string;

package/dist/src/objects/BaseMesh.d.ts

@@ -3,6 +3,8 @@ import type { InteractionEventMap } from '../interactions';
 export declare class BaseMesh<TGeometry extends BufferGeometry = BufferGeometry, TMaterial extends Material | Material[] = Material | Material[], TEventMap extends Object3DEventMap = InteractionEventMap> extends Mesh<TGeometry, TMaterial, TEventMap> {
     readonly isBaseMesh = true;
     type: string;
+    castShadow: boolean;
+    receiveShadow: boolean;
     ignoreInvisibleWhenRaycast: boolean;
     constructor(...args: ConstructorParameters<typeof Mesh<TGeometry, TMaterial, TEventMap>>);
     raycast(raycaster: Raycaster, intersects: Intersection[]): boolean | void;

package/docs/api-plugin-u-manager.md

@@ -46,8 +46,8 @@ floor.addEventListener('click', ({ event }) => {
 | `getFloorAt(index)` | 按楼层下标获取 `FloorMesh`。 |
 | `isolateFloor(floor \| index)` | 只显示指定楼层，隐藏其他楼层。 |
 | `showAllFloors()` | 显示全部楼层。 |
-| `planishFloors()` | 将所有楼层整体压扁。 |
-| `unplanishFloors()` | 恢复所有楼层整体缩放。 |
+| `planishFloors(kind?)` | 压扁所有楼层；传入 `kind` 时只压扁该语义类型。 |
+| `unplanishFloors(kind?)` | 恢复所有楼层；传入 `kind` 时只恢复该语义类型。 |
 
 ### `FloorMesh`
 
@@ -62,18 +62,19 @@ floor.addEventListener('click', ({ event }) => {
 | `wallsInstances` / `columnsInstances` / `spacesInstances` / `doorsInstances` / `windowsInstances` | 按语义类型维护的 ID 到实例下标映射。 |
 | `getSemanticIndexById(id)` | 根据语义 ID 获取实例下标。 |
 | `getSemanticIdAt(index)` | 获取实例语义 ID。 |
-| `getSemanticKindAt(index)` | 获取实例类型：`'WALL' \| 'COLUMN' \| 'SPACE' \| 'Doors' \| 'Windows'`。 |
-| `getSemanticNameAt(index)` | 获取实例名称；当前 `SPACE` 会从语义数据的 `Name` 写入，其他类型可能为 `undefined`。 |
+| `getSemanticKindAt(index)` | 获取实例类型：`'Walls' \| 'Columns' \| 'Spaces' \| 'Doors' \| 'Windows'`。 |
+| `getSemanticNameAt(index)` | 获取实例名称；当前 `Spaces` 会从语义数据的 `Name` 写入，其他类型可能为 `undefined`。 |
 | `setColorAt(index, color)` / `getColorAt(index, target?)` | 修改或读取实例颜色，支持 `Color`、`Vector3`、`Vector4`。 |
 | `setOpacityAt(index, opacity)` / `getOpacityAt(index)` | 修改或读取实例透明度。 |
 | `setVisibleAt(index, visible)` / `getVisibleAt(index)` | 修改或读取实例显隐状态。 |
 | `setMatrixAt(index, matrix)` / `getMatrixAt(index, target?)` | 设置或读取实例附加矩阵。 |
 | `setScaleAt(index, scale, y?, z?)` | 修改实例缩放，支持 `number` 或 `Vector3`。 |
+| `setScaleYAt(index, y)` | 只修改实例 Y 轴缩放，保留 X/Z 缩放和已有位移、旋转。 |
 | `getFinalMatrixAt(index, target?)` | 读取实例最终矩阵，包含语义对象原始基点矩阵。 |
 | `getBoundingBoxAt(index, target?, world?)` | 获取实例包围盒；`world = true` 时包含 `FloorMesh.matrixWorld`。 |
 | `getBoundingSphereAt(index, target?, world?)` | 获取实例包围球；`world = true` 时包含 `FloorMesh.matrixWorld`。 |
 | `computeBoundingBox()` / `computeBoundingSphere()` | 计算整个楼层的包围体。 |
-| `planish()` / `unplanish()` | 压扁或恢复整个楼层 mesh。 |
+| `planish(kind?)` / `unplanish(kind?)` | 压扁或恢复楼层语义实例；传入 `kind` 时只作用于该语义类型。 |
 
 ### 飞向语义实例
 
@@ -110,7 +111,7 @@ if (index !== undefined) {
 
 ### 楼层压扁
 
-`planish()` 会缩放整个 `FloorMesh`，适合展示楼层整体。`setScaleAt()` 只缩放单个语义实例，并保留该语义对象自己的基点矩阵，因此压扁墙、柱、房间时不会被压到世界原点。
+`planish()` / `unplanish()` 默认作用于当前楼层的全部语义实例；传入 `kind` 时只处理该类型，例如 `floor.planish('Walls')`。如果只想调整单个实例，可以使用 `setScaleAt()` 或 `setScaleYAt()`，它们会保留该语义对象自己的基点矩阵，因此压扁墙、柱、房间时不会被压到世界原点。
 
 ## `SceneLoader`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-space",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "type": "module",
   "types": "dist/src/index.d.ts",
   "module": "dist/index.js",
@@ -60,10 +60,12 @@
     "vitepress": "^1.6.4"
   },
   "peerDependencies": {
-    "3d-tiles-renderer": ">=0.4.27",
+    "3d-tiles-renderer": ">=0.4.28",
     "@takram/three-geospatial": ">=0.9.1",
+    "@takram/three-atmosphere": ">=0.19.1",
     "@types/three": ">=0.184.1",
     "camera-controls": ">=3.1.2",
+    "postprocessing": ">=6.39.1",
     "three": ">=0.184.0"
   }
 }