@pascal-app/core 0.1.3

package/dist/events/bus.d.ts

@@ -0,0 +1,42 @@
+import type { ThreeEvent } from '@react-three/fiber';
+import type { BuildingNode, CeilingNode, ItemNode, LevelNode, RoofNode, SlabNode, WallNode, ZoneNode } from '../schema';
+import type { AnyNode } from '../schema/types';
+export interface GridEvent {
+    position: [number, number, number];
+    nativeEvent: ThreeEvent<PointerEvent>;
+}
+export interface NodeEvent<T extends AnyNode = AnyNode> {
+    node: T;
+    position: [number, number, number];
+    localPosition: [number, number, number];
+    normal?: [number, number, number];
+    stopPropagation: () => void;
+    nativeEvent: ThreeEvent<PointerEvent>;
+}
+export type WallEvent = NodeEvent<WallNode>;
+export type ItemEvent = NodeEvent<ItemNode>;
+export type BuildingEvent = NodeEvent<BuildingNode>;
+export type LevelEvent = NodeEvent<LevelNode>;
+export type ZoneEvent = NodeEvent<ZoneNode>;
+export type SlabEvent = NodeEvent<SlabNode>;
+export type CeilingEvent = NodeEvent<CeilingNode>;
+export type RoofEvent = NodeEvent<RoofNode>;
+export declare const eventSuffixes: readonly ["click", "move", "enter", "leave", "pointerdown", "pointerup", "context-menu", "double-click"];
+export type EventSuffix = (typeof eventSuffixes)[number];
+type NodeEvents<T extends string, E> = {
+    [K in `${T}:${EventSuffix}`]: E;
+};
+type GridEvents = {
+    [K in `grid:${EventSuffix}`]: GridEvent;
+};
+export interface CameraControlEvent {
+    nodeId: AnyNode['id'];
+}
+type CameraControlEvents = {
+    'camera-controls:view': CameraControlEvent;
+    'camera-controls:capture': CameraControlEvent;
+};
+type EditorEvents = GridEvents & NodeEvents<'wall', WallEvent> & NodeEvents<'item', ItemEvent> & NodeEvents<'building', BuildingEvent> & NodeEvents<'level', LevelEvent> & NodeEvents<'zone', ZoneEvent> & NodeEvents<'slab', SlabEvent> & NodeEvents<'ceiling', CeilingEvent> & NodeEvents<'roof', RoofEvent> & CameraControlEvents;
+export declare const emitter: import("mitt").Emitter<EditorEvents>;
+export {};
+//# sourceMappingURL=bus.d.ts.map

package/dist/events/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/events/bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACvH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAG9C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,WAAW,EAAE,UAAU,CAAC,YAAY,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IACpD,IAAI,EAAE,CAAC,CAAA;IACP,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,WAAW,EAAE,UAAU,CAAC,YAAY,CAAC,CAAA;CACtC;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAC3C,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAC3C,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC,CAAA;AACnD,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;AAC7C,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAC3C,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAC3C,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,CAAA;AACjD,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAG3C,eAAO,MAAM,aAAa,0GAShB,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI;KACpC,CAAC,IAAI,GAAG,CAAC,IAAI,WAAW,EAAE,GAAG,CAAC;CAChC,CAAA;AAED,KAAK,UAAU,GAAG;KACf,CAAC,IAAI,QAAQ,WAAW,EAAE,GAAG,SAAS;CACxC,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,KAAK,mBAAmB,GAAG;IACzB,sBAAsB,EAAE,kBAAkB,CAAA;IAC1C,yBAAyB,EAAE,kBAAkB,CAAA;CAC9C,CAAA;AAED,KAAK,YAAY,GAAG,UAAU,GAC5B,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7B,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7B,UAAU,CAAC,UAAU,EAAE,aAAa,CAAC,GACrC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,GAC/B,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7B,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7B,UAAU,CAAC,SAAS,EAAE,YAAY,CAAC,GACnC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7B,mBAAmB,CAAA;AAErB,eAAO,MAAM,OAAO,sCAAuB,CAAA"}

package/dist/events/bus.js

@@ -0,0 +1,13 @@
+import mitt from 'mitt';
+// Event suffixes - exported for use in hooks
+export const eventSuffixes = [
+    'click',
+    'move',
+    'enter',
+    'leave',
+    'pointerdown',
+    'pointerup',
+    'context-menu',
+    'double-click',
+];
+export const emitter = mitt();

package/dist/hooks/scene-registry/scene-registry.d.ts

@@ -0,0 +1,18 @@
+import type * as THREE from "three";
+export declare const sceneRegistry: {
+    nodes: Map<string, THREE.Object3D<THREE.Object3DEventMap>>;
+    byType: {
+        building: Set<string>;
+        ceiling: Set<string>;
+        level: Set<string>;
+        wall: Set<string>;
+        item: Set<string>;
+        slab: Set<string>;
+        zone: Set<string>;
+        roof: Set<string>;
+        scan: Set<string>;
+        guide: Set<string>;
+    };
+};
+export declare function useRegistry(id: string, type: keyof typeof sceneRegistry.byType, ref: React.RefObject<THREE.Object3D>): void;
+//# sourceMappingURL=scene-registry.d.ts.map

package/dist/hooks/scene-registry/scene-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-registry.d.ts","sourceRoot":"","sources":["../../../src/hooks/scene-registry/scene-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;CAkBzB,CAAC;AAEF,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,OAAO,aAAa,CAAC,MAAM,EACvC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,QAkBrC"}

package/dist/hooks/scene-registry/scene-registry.js

@@ -0,0 +1,35 @@
+import { useLayoutEffect } from "react";
+export const sceneRegistry = {
+    // Master lookup: ID -> Object3D
+    nodes: new Map(),
+    // Categorized lookups: Type -> Set of IDs
+    // Using a Set is faster for adding/deleting than an Array
+    byType: {
+        building: new Set(),
+        ceiling: new Set(),
+        level: new Set(),
+        wall: new Set(),
+        item: new Set(),
+        slab: new Set(),
+        zone: new Set(),
+        roof: new Set(),
+        scan: new Set(),
+        guide: new Set(),
+    },
+};
+export function useRegistry(id, type, ref) {
+    useLayoutEffect(() => {
+        const obj = ref.current;
+        if (!obj)
+            return;
+        // 1. Add to master map
+        sceneRegistry.nodes.set(id, obj);
+        // 2. Add to type-specific set
+        sceneRegistry.byType[type].add(id);
+        // 4. Cleanup when component unmounts
+        return () => {
+            sceneRegistry.nodes.delete(id);
+            sceneRegistry.byType[type].delete(id);
+        };
+    }, [id, type, ref]);
+}

package/dist/hooks/spatial-grid/spatial-grid-manager.d.ts

@@ -0,0 +1,90 @@
+import type { AnyNode } from '../../schema';
+/**
+ * Point-in-polygon test using ray casting algorithm.
+ */
+export declare function pointInPolygon(px: number, pz: number, polygon: Array<[number, number]>): boolean;
+/**
+ * Test if an item's footprint overlaps with a polygon.
+ * Checks: any item corner inside polygon, or any polygon vertex inside item AABB, or edges intersect.
+ */
+export declare function itemOverlapsPolygon(position: [number, number, number], dimensions: [number, number, number], rotation: [number, number, number], polygon: Array<[number, number]>, inset?: number): boolean;
+/**
+ * Test if a wall segment overlaps with a polygon.
+ * A wall is considered to overlap if:
+ * - Its midpoint is inside the polygon (wall crosses through)
+ * - At least one endpoint is inside (wall partially or fully in slab)
+ * - It's collinear with and overlaps a polygon edge (wall on slab boundary)
+ *
+ * Note: A wall with just one endpoint touching the edge but the rest outside
+ * is NOT considered overlapping (adjacent only).
+ */
+export declare function wallOverlapsPolygon(start: [number, number], end: [number, number], polygon: Array<[number, number]>): boolean;
+export declare class SpatialGridManager {
+    private cellSize;
+    private floorGrids;
+    private wallGrids;
+    private walls;
+    private slabsByLevel;
+    private ceilingGrids;
+    private ceilings;
+    private itemCeilingMap;
+    constructor(cellSize?: number);
+    private getFloorGrid;
+    private getWallGrid;
+    private getWallLength;
+    private getWallHeight;
+    private getCeilingGrid;
+    private getSlabMap;
+    handleNodeCreated(node: AnyNode, levelId: string): void;
+    handleNodeUpdated(node: AnyNode, levelId: string): void;
+    handleNodeDeleted(nodeId: string, nodeType: string, levelId: string): string[];
+    canPlaceOnFloor(levelId: string, position: [number, number, number], dimensions: [number, number, number], rotation: [number, number, number], ignoreIds?: string[]): {
+        valid: boolean;
+        conflictIds: string[];
+    };
+    /**
+     * Check if an item can be placed on a wall
+     * @param levelId - the level containing the wall
+     * @param wallId - the wall to check
+     * @param localX - X position in wall-local space (distance from wall start)
+     * @param localY - Y position (height from floor)
+     * @param dimensions - item dimensions [width, height, depth]
+     * @param attachType - 'wall' (needs both sides) or 'wall-side' (needs one side)
+     * @param side - which side for 'wall-side' items
+     * @param ignoreIds - item IDs to ignore in collision check
+     */
+    canPlaceOnWall(levelId: string, wallId: string, localX: number, localY: number, dimensions: [number, number, number], attachType?: 'wall' | 'wall-side', side?: 'front' | 'back', ignoreIds?: string[]): {
+        valid: boolean;
+        conflictIds: string[];
+    };
+    getWallForItem(levelId: string, itemId: string): string | undefined;
+    /**
+     * Get the total slab elevation at a given (x, z) position on a level.
+     * Returns the highest slab elevation if the point is inside any slab polygon, otherwise 0.
+     */
+    getSlabElevationAt(levelId: string, x: number, z: number): number;
+    /**
+     * Get the slab elevation for an item using its full footprint (bounding box).
+     * Checks if any part of the item's rotated footprint overlaps with any slab polygon.
+     * Returns the highest overlapping slab elevation, or 0 if none.
+     */
+    getSlabElevationForItem(levelId: string, position: [number, number, number], dimensions: [number, number, number], rotation: [number, number, number]): number;
+    /**
+     * Get the slab elevation for a wall by checking if it overlaps with any slab polygon.
+     * Uses wallOverlapsPolygon which handles edge cases (points on boundary, collinear segments).
+     * Returns the highest slab elevation found, or 0 if none.
+     */
+    getSlabElevationForWall(levelId: string, start: [number, number], end: [number, number]): number;
+    /**
+     * Check if an item can be placed on a ceiling.
+     * Validates that the footprint is within the ceiling polygon and doesn't overlap other ceiling items.
+     */
+    canPlaceOnCeiling(ceilingId: string, position: [number, number, number], dimensions: [number, number, number], rotation: [number, number, number], ignoreIds?: string[]): {
+        valid: boolean;
+        conflictIds: string[];
+    };
+    clearLevel(levelId: string): void;
+    clear(): void;
+}
+export declare const spatialGridManager: SpatialGridManager;
+//# sourceMappingURL=spatial-grid-manager.d.ts.map

package/dist/hooks/spatial-grid/spatial-grid-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-grid-manager.d.ts","sourceRoot":"","sources":["../../../src/hooks/spatial-grid/spatial-grid-manager.ts"],"names":[],"mappings":"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"}