Files

T

PascalandGitHub 0bd0cab533 feat: stair system, scene graph utilities, read-only mode, viewer state improvements (#210 )

Stair system (full stack):
- New StairNode + StairSegmentNode schemas with flights, landings, L/U-shapes
- StairSystem: geometry generation with throttled per-frame updates
- Stair tool, edit system, panels, tree node, and renderers
- Event bus types, scene registry, and command palette entries

Scene graph utilities:
- cloneLevelSubtree: deep-clone a level with remapped IDs
- forkSceneGraph: clone + strip scan/guide nodes for project forking

Core improvements:
- Read-only mode on scene store (blocks create/update/delete when locked)
- readOnly guards on node-actions and collection actions
- Upload store for scan/guide file upload handling

Viewer state:
- previewSelectedIds for box-select live preview
- hoverHighlightMode (default/delete) for delete-mode hover outline

2026-04-05 01:20:43 -04:00

src

feat: stair system, scene graph utilities, read-only mode, viewer state improvements (#210 )

2026-04-05 01:20:43 -04:00

package.json

release: @pascal-app/core@0.3.3 @pascal-app/viewer@0.3.3

2026-03-31 20:52:13 +00:00

README.md

packages

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

tsconfig.json

remove community

2026-03-13 09:07:46 +01: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