@adatechnology/game-floorplan-three 0.10.2 → 0.10.3

package/dist/index.js

@@ -16,7 +16,7 @@ import {
   ptBR,
   rectsOf,
   specimenSpec
-} from "./chunk-Y3Y7NYOL.js";
+} from "./chunk-JZQA7G63.js";
 
 // src/navigation/floor-navigator.ts
 var CELL = 0.1;

package/dist/{testing-BK7QmoUq.d.ts → testing-DWLAejq6.d.ts}

@@ -1,17 +1,17 @@
-import { DeferredQueue, ModuleScenario, TestableModule, DestructibleSpec } from '@adatechnology/game-contracts';
-import { DestructionWorld, DestructionEvent } from '@adatechnology/game-destruction';
+import { DestructibleSpec, DestructionEvent, DeferredQueue, PartState, ObjectState, HitResult, ModuleScenario, TestableModule } from '@adatechnology/game-contracts';
+import { DestructionWorld, DestructionEvent as DestructionEvent$1 } from '@adatechnology/game-destruction';
 import { DestructionRenderer } from '@adatechnology/game-destruction-three';
 import { FloorplanResult, ResultGate, FloorplanResultFields, ResultRoom, PlanWall, PlanDoor, PlanWindow, Rect } from '@adatechnology/game-floorplan';
 import * as THREE_NS from 'three';
 import { LightBudget, LightHandle } from '@adatechnology/game-render-three';
 import { DocumentLike, Props3dOptions, Props3d } from '@adatechnology/game-props3d';
+import { StructurePart, Support, DestructibleSpecOptions, Outbuilding, Utilities, WaterTank, Construction, Structure, PlumbingPoint, PlumbingRun } from '@adatechnology/game-floorplan-structure';
 import { catenary } from '@adatechnology/game-shapes-three';
 import * as Vegetation from '@adatechnology/game-vegetation';
 import { PlantSpec } from '@adatechnology/game-vegetation';
 import * as Interactables from '@adatechnology/game-interactables';
 import { ObjectSpec, World } from '@adatechnology/game-interactables';
 import { FloorplanAdapter, HouseholdKit, AdapterOptions, PlanEntry, AdapterPlan, WaterNetwork, AddResult, BlockedFn } from '@adatechnology/game-floorplan-interactables';
-import { StructurePart, Support, Outbuilding, Utilities, WaterTank, Construction, Structure, PlumbingPoint, PlumbingRun } from '@adatechnology/game-floorplan-structure';
 import * as VegetationThree from '@adatechnology/game-vegetation/three';
 
 /** Texts the house shows to the player (interaction prompts, messages, outbuilding labels), by locale. */
@@ -100,6 +100,117 @@ interface SpeciesLibrary {
     toSpec(species: string): PlantSpec;
 }
 
+/** What draws a piece of the structure: a loose group (`obj`), or a range of a merged mesh (`whole` when the range is the whole mesh). */
+type StructureMeshItem = {
+    obj: THREE_NS.Object3D;
+    mesh?: undefined;
+    whole?: undefined;
+    v0?: undefined;
+    v1?: undefined;
+    i0?: undefined;
+    i1?: undefined;
+} | {
+    obj?: undefined;
+    mesh: THREE_NS.Mesh;
+    v0: number;
+    v1: number;
+    i0: number;
+    i1: number;
+    whole: boolean;
+};
+/** A piece of the house's structure: the part of the plan (or a tagged piece the plan does not have), how many meshes draw it, and what it holds. */
+type HouseStructurePart = StructurePart & {
+    meshes: number;
+    extra: boolean;
+    contains?: unknown;
+    explodes?: unknown;
+    tags?: string[];
+    thickness?: number;
+    fill?: number;
+    [field: string]: unknown;
+};
+/** A support of the house's structure (`extra` when the house added it: what is fitted into a wall rests on it). */
+type HouseSupport = Support & {
+    extra?: boolean;
+};
+/** `house.structure`: the parts and supports of the house, the meshes that draw each part and the destructible spec. */
+interface HouseStructure {
+    system: string;
+    parts: HouseStructurePart[];
+    supports: HouseSupport[];
+    levels: number[];
+    elevation: number;
+    byId: Map<string, HouseStructurePart>;
+    meshesOf(id: string): StructureMeshItem[];
+    /** The piece a raycast hit (object and face index): merged mesh by its ranges, single-piece mesh or loose group by userData. */
+    pieceId(obj: THREE_NS.Object3D | null, face?: number | null): string | null;
+    spec(options?: DestructibleSpecOptions | null): DestructibleSpec;
+    [field: string]: unknown;
+}
+/** The breach view of a house (`createBreachView`): draws the units that come out of its walls. */
+interface BreachView {
+    stage(event: DestructionEvent): boolean;
+    spall(event: DestructionEvent): boolean;
+    claim(): void;
+    chip(event: DestructionEvent): boolean;
+    drop(partId: string): void;
+    setLod(level: number): void;
+    restore(): void;
+    flush(budgetMs?: number): number;
+    release(): void;
+    deferredQueue(): DeferredQueue;
+    has(partId: string): boolean;
+    statistics(): {
+        walls: number;
+        gone: number;
+        craters: number;
+        flakes: number;
+        units: number;
+    };
+}
+/** What undoes `follow`: the house's drawing back, the listener gone, and the per-frame painting. */
+interface HouseFollow {
+    restore(): void;
+    dispose(): void;
+    update(): void;
+}
+/** `house.destruction`: the adapter of the house to the destruction world (`cfg.destruction`). */
+interface HouseDestruction {
+    world: DestructionWorld | null;
+    id: string | null;
+    active: boolean;
+    renderer: HouseDestructionRenderer | null;
+    spec: DestructibleSpec | null;
+    specOptions: DestructibleSpecOptions | null;
+    breach: BreachView;
+    onEvent(fn: (e: DestructionEvent) => void): () => void;
+    hide(id: string): void;
+    dropPiece(id: string): void;
+    restore(): void;
+    sync(): void;
+    ranges(): Record<string, BoundMeshes[]>;
+    activate(world?: DestructionWorld | null, specOptions?: DestructibleSpecOptions | null): HouseDestruction;
+    deactivate(): void;
+    follow(world: DestructionWorld, id: string, spec: DestructibleSpec): HouseFollow;
+    piece(id: string): PartState | null;
+    state(): ObjectState | null;
+    reset(): void;
+    strike(pid: string, point: {
+        x: number;
+        y: number;
+        z: number;
+    } | null | undefined, type: string | undefined, amount: number | null | undefined, d?: {
+        hpMax?: number;
+    } | null): HitResult | null;
+    animate(dt: number): void;
+    statistics(): {
+        hiddenPieces: number;
+        falling: number;
+        fragments: number;
+        breached: ReturnType<BreachView['statistics']>;
+    };
+}
+
 /** A part of the house a hit can damage (door, window, glass, tank...): the game reads `hp`. */
 interface Damageable {
     type: string;
@@ -227,7 +338,7 @@ interface HouseRendererOptions {
     /** A part took damage (`house.damage`, a hit of the destruction world): the part, or for a wall `{ type: 'wall', damageable, collider }`. */
     onDamage?: (part: HousePart | HouseWallDamage, point: HousePoint | null | undefined, type: string) => void;
     /** Every event of the destruction world about this house, with the house's inner group. */
-    onWreck?: (event: DestructionEvent, house: THREE_NS.Group) => void;
+    onWreck?: (event: DestructionEvent$1, house: THREE_NS.Group) => void;
     /** The player acts on something; returning `false` cancels it. */
     onInteract?: (target: HouseInteractTarget, action?: InteractionTarget | KitInteractionTarget) => boolean | void;
     /** A room's light turned on or off (`on` is what it shows now). */
@@ -410,9 +521,9 @@ interface House {
     electrical: ElectricalInfo | null;
     gutters: GutterInfo | null;
     /** The structure of the house (`game-floorplan-structure`): its parts and `spec()`, the destructible spec. */
-    structure: any;
+    structure: HouseStructure;
     /** The adapter to the destruction world (`destruction` option). */
-    destruction: any;
+    destruction: HouseDestruction;
     update(dt: number, time?: number, focus?: HousePoint): void;
     show(options?: {
         floor?: number;

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-export { A as AreaContext, D as DEFAULT_SPECIMENS, F as FLOORPLAN_AREA_ID, d as FloorplanEngineLike, e as FloorplanTestOptions, S as SPECIMEN_AT, o as SpecimenDef, p as TemplateGroup, r as buildSpecimenMeshes, s as createFloorplanTestModule, t as createHouseScenarios, y as specimenSpec } from './testing-BK7QmoUq.js';
+export { A as AreaContext, D as DEFAULT_SPECIMENS, F as FLOORPLAN_AREA_ID, d as FloorplanEngineLike, e as FloorplanTestOptions, S as SPECIMEN_AT, o as SpecimenDef, p as TemplateGroup, r as buildSpecimenMeshes, s as createFloorplanTestModule, t as createHouseScenarios, y as specimenSpec } from './testing-DWLAejq6.js';
 import '@adatechnology/game-contracts';
 import '@adatechnology/game-destruction';
 import '@adatechnology/game-destruction-three';
@@ -6,9 +6,9 @@ import '@adatechnology/game-floorplan';
 import 'three';
 import '@adatechnology/game-render-three';
 import '@adatechnology/game-props3d';
+import '@adatechnology/game-floorplan-structure';
 import '@adatechnology/game-shapes-three';
 import '@adatechnology/game-vegetation';
 import '@adatechnology/game-interactables';
 import '@adatechnology/game-floorplan-interactables';
-import '@adatechnology/game-floorplan-structure';
 import '@adatechnology/game-vegetation/three';

package/dist/testing.js

@@ -6,7 +6,7 @@ import {
   createFloorplanTestModule,
   createHouseScenarios,
   specimenSpec
-} from "./chunk-Y3Y7NYOL.js";
+} from "./chunk-JZQA7G63.js";
 export {
   DEFAULT_SPECIMENS,
   FLOORPLAN_AREA_ID,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/game-floorplan-three",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "license": "MIT",
   "description": "three.js renderer for @adatechnology/game-floorplan: walls, doors, windows, floors, stairs, roofs, lot, furniture, lights, mirrors and cars of a plan, bound to the destruction of its structure, plus the floor navigator.",
   "keywords": [
@@ -42,10 +42,10 @@
     "MIGRATION.md"
   ],
   "dependencies": {
-    "@adatechnology/game-contracts": "^0.27.0",
-    "@adatechnology/game-destruction": "^0.18.1",
+    "@adatechnology/game-contracts": "^0.28.0",
+    "@adatechnology/game-destruction": "^0.18.2",
     "@adatechnology/game-floorplan-interactables": "^1.0.0",
-    "@adatechnology/game-floorplan-structure": "^2.1.2",
+    "@adatechnology/game-floorplan-structure": "^2.1.3",
     "@adatechnology/game-props3d": "^0.3.3",
     "@adatechnology/game-render-three": "^0.2.0",
     "@adatechnology/game-shapes-three": "^0.3.1",
@@ -53,9 +53,9 @@
   },
   "peerDependencies": {
     "three": "^0.160.0",
-    "@adatechnology/game-floorplan": "^0.3.5",
+    "@adatechnology/game-floorplan": "^0.3.6",
     "@adatechnology/game-vegetation": "^0.2.1",
-    "@adatechnology/game-interactables": "^0.2.19"
+    "@adatechnology/game-interactables": "^0.2.20"
   },
   "devDependencies": {
     "@types/node": "^22.10.7",
@@ -64,14 +64,14 @@
     "tsup": "^8.5.1",
     "typescript": "^5.7.3",
     "vitest": "^3.2.4",
-    "@adatechnology/game-floorplan": "^0.3.5",
+    "@adatechnology/game-floorplan": "^0.3.6",
     "@adatechnology/game-kit-defaults": "^0.2.0",
-    "@adatechnology/game-interactables": "^0.2.19",
+    "@adatechnology/game-interactables": "^0.2.20",
     "@adatechnology/game-interactables-household": "^0.5.0",
-    "@adatechnology/game-interactables-three": "^0.2.6",
+    "@adatechnology/game-interactables-three": "^0.2.7",
     "@adatechnology/game-floorplan-commercial": "^6.0.0",
     "@adatechnology/golden-tool": "^0.0.0",
-    "@adatechnology/game-destruction-three": "^0.17.1",
+    "@adatechnology/game-destruction-three": "^0.17.3",
     "@adatechnology/game-vegetation": "^0.2.1",
     "@adatechnology/game-vegetation-species": "^0.2.0",
     "@adatechnology/game-floorplan-rural": "^5.0.1",