Files

T

Wassim SAMADandClaude Opus 4.7 cf93c32183 Add HostingService with cycle/depth/kind validation (Phase 1, 2/6)

First service in `core/src/services/`: pure, no React or R3F, takes
SceneApi + node data, returns results.

Exports:
- `canAttach(childId, hostId, scene)` — validates host attachment.
  Rejects self-host, cycles (host's ancestor chain contains child),
  chains past MAX_HOST_DEPTH (6), and host kinds outside the child
  def's `capabilities.hostable.parents` allowlist. Returns a typed
  AttachError discriminated union so callers can render specific
  messages.
- `getSurface(host)` / `getTopSurfaceHeight(host)` — reads
  `def.capabilities.surfaces` from the registry; resolves
  function-valued heights with the node.
- `clampYToHostTop(host, y)` — convenience for placement code.
- `pickHost({ point, candidates, placedKind, hitTest? })` — given
  spatially pre-filtered candidates, returns the first hostable.
  The runtime is responsible for spatial filtering; this function
  stays pure.

MAX_HOST_DEPTH = 6: the explore earlier found today's editor has no
cap on item-on-item nesting. Cap is bounded by hostable depth, not
total tree depth (sites/buildings/levels don't count).

17 tests cover all rejection paths + happy paths + function-valued
surface heights.

Re-exported from `@pascal-app/core` via a new `services/` barrel.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-14 12:20:28 -04:00

src

Add HostingService with cycle/depth/kind validation (Phase 1, 2/6)

2026-05-14 12:20:28 -04:00

package.json

Add test script to @pascal-app/core so turbo picks up its unit tests

2026-05-14 11:41:46 -04:00

README.md

packages

2026-02-05 08:22:19 +09:00

tsconfig.json

Reset core/viewer/editor/mcp packages and apps/editor from private-editor

2026-05-09 20:52:26 +00:00

README.md

@pascal-app/core

Core library for Pascal 3D building editor.

Installation

npm install @pascal-app/core

Peer Dependencies

npm install react three @react-three/fiber @react-three/drei

What's Included

Node Schemas - Zod schemas for all building primitives (walls, slabs, items, etc.)
Scene State - Zustand store with IndexedDB persistence and undo/redo
Systems - Geometry generation for walls, floors, ceilings, roofs
Scene Registry - Fast lookup from node IDs to Three.js objects
Spatial Grid - Collision detection and placement validation
Event Bus - Typed event emitter for inter-component communication
Asset Storage - IndexedDB-based file storage for user-uploaded assets

Usage

import { useScene, WallNode, ItemNode } from '@pascal-app/core'

// Create a wall
const wall = WallNode.parse({
  points: [[0, 0], [5, 0]],
  height: 3,
  thickness: 0.2,
})

useScene.getState().createNode(wall, parentLevelId)

// Subscribe to scene changes
function MyComponent() {
  const nodes = useScene((state) => state.nodes)
  const walls = Object.values(nodes).filter(n => n.type === 'wall')

  return <div>Total walls: {walls.length}</div>
}

Node Types

SiteNode - Root container
BuildingNode - Building within a site
LevelNode - Floor level
WallNode - Vertical wall with optional openings
SlabNode - Floor slab
CeilingNode - Ceiling surface
RoofNode - Roof geometry
ZoneNode - Spatial zone/room
ItemNode - Furniture, fixtures, appliances
ScanNode - 3D scan reference
GuideNode - 2D guide image reference

Systems

Systems process dirty nodes each frame to update geometry:

WallSystem - Wall geometry with mitering and CSG cutouts
SlabSystem - Floor polygon generation
CeilingSystem - Ceiling geometry
RoofSystem - Roof generation
ItemSystem - Item positioning on walls/ceilings/floors

License

MIT