O que Integração do Pascal Editor faz?
Visão Geral
O Pascal Editor (pascalorg/editor) é um editor de edifícios 3D open source construído com React Three Fiber e WebGPU. Ele fornece um grafo de cena baseado em nós, gerenciamento de estado com Zustand e uma arquitetura de sistemas ideal para geração arquitetônica orientada por IA. Esta skill cobre a API principal para criar, manipular e exportar geometria de edifícios.
Instruções
Início Rápido
npx create-next-app@latest my-building-app
cd my-building-app
npm install @pascal-app/core @pascal-app/ui @react-three/fiber @react-three/drei three zustand
Hierarquia de Nós
O Pascal usa uma árvore de nós tipados:
Site -> Edifício -> Nível -> Parede -> Abertura (porta/janela)
-> Laje (piso/teto)
-> Zona (limite de cômodo)
-> Item (mobiliário, acessório)
Cada nó possui: id (UUID), type, parentId, children (IDs filhos), props (específicos do tipo) e dirty (marca para reconstrução).
Stores Zustand
import { useScene, useViewer, useEditor } from '@pascal-app/core'
// useScene -- grafo de cena (nós, relações)
const { nodes, createNode, updateNode, deleteNode } = useScene()
// useViewer -- estado da viewport (câmera, seleção)
const { selectedIds, camera, setSelection } = useViewer()
// useEditor -- modo de ferramenta e estado da interface
const { activeTool, setTool, history } = useEditor()
Criando Paredes com Aberturas
const scene = useScene.getState()
// Parede externa: 4,5m de comprimento, 200mm de espessura, 2,7m de pé direito
const wall = await scene.createNode({
type: 'wall',
props: {
start: { x: 0, y: 0 }, end: { x: 4.5, y: 0 },
thickness: 0.20, height: 2.7,
isExterior: true, material: 'masonry',
}
}, levelId)
// Adicionar uma janela: 1,2m de largura, peitoril a 900mm
await scene.createNode({
type: 'item',
props: {
itemType: 'window', wallId: wall.id,
offsetFromStart: 1.5, width: 1.2, height: 1.2, sillHeight: 0.9,
}
}, wall.id)
// Adicionar uma porta: 900mm de largura
await scene.createNode({
type: 'item',
props: {
itemType: 'door', wallId: wall.id,
offsetFromStart: 3.0, width: 0.9, height: 2.1, sillHeight: 0,
}
}, wall.id)
Criando Níveis e Cômodos
const level = await scene.createNode({
type: 'level',
props: { name: 'Térreo', elevation: 0, height: 2.7, index: 0 }
}, buildingId)
// Laje do piso
await scene.createNode({
type: 'slab',
props: {
polygon: [{ x: 0, y: 0 }, { x: 10, y: 0 }, { x: 10, y: 8 }, { x: 0, y: 8 }],
thickness: 0.25, isRoof: false,
}
}, level.id)
// Zona do cômodo para rotulagem e cálculo de área
await scene.createNode({
type: 'zone',
props: {
name: 'Sala de Estar', roomType: 'living',
polygon: [{ x: 0.1, y: 0.1 }, { x: 5.4, y: 0.1 }, { x: 5.4, y: 7.9 }, { x: 0.1, y: 7.9 }],
}
}, level.id)
Exportando Cena para JSON
function exportScene(): BuildingExport {
const { nodes } = useScene.getState()
const allNodes = Object.values(nodes)
const site = allNodes.find(n => n.type === 'site')
const building = allNodes.find(n => n.type === 'building')
const levels = allNodes
.filter(n => n.type === 'level' && n.parentId === building.id)
.sort((a, b) => a.props.elevation - b.props.elevation)
return {
units: 'meters',
site: { width: site.props.width, depth: site.props.depth },
building: {
levels: levels.map(level => ({
name: level.props.name,
elevation: level.props.elevation,
height: level.props.height,
walls: getChildrenByType(level.id, 'wall', allNodes),
rooms: getChildrenByType(level.id, 'zone', allNodes),
}))
}
}
}
Renderização com React Three Fiber
import { Canvas } from '@react-three/fiber'
import { PascalScene, PascalCamera, PascalControls } from '@pascal-app/ui'
export function BuildingViewer() {
return (
<Canvas camera={{ position: [0, 20, 20], fov: 45 }}>
<PascalScene />
<PascalCamera />
<PascalControls />
<ambientLight intensity={0.5} />
<directionalLight position={[10, 20, 10]} castShadow />
</Canvas>
)
}
Ajuste à Grade
O Pascal usa uma grade de 100 mm (0,1 m) por padrão:
const snapToGrid = (value: number, gridSize = 0.1) =>
Math.round(value / gridSize) * gridSize
Exemplos
Exemplo 1: Construir um Térreo de 10m x 8m
Crie um térreo completo com paredes externas, uma divisória interna separando sala e quartos, e aberturas adequadas:
- Criar nó de nível com elevação 0, altura 2,7 m
- Criar laje de piso: polígono 10 m x 8 m, espessura 0,25 m
- Criar 4 paredes externas (0,20 m de espessura, alvenaria): norte (10 m), leste (8 m), sul (10 m), oeste (8 m)
- Adicionar divisória interna em x=5,5 (0,10 m de espessura, madeira) percorrendo toda a profundidade
- Adicionar porta de entrada na parede norte: 1,0 m x 2,1 m no offset 3,5 m
- Adicionar janelas na parede leste: duas de 1,2 m x 1,2 m com peitoril 0,9 m, nos offsets 1,2 m e 4,5 m
- Criar zonas: Sala de Estar (5,3 m x 7,8 m = 41,3 m2), área dos Quartos (4,3 m x 7,8 m = 33,5 m2)
- Exportar para JSON para validação contra as regras de
architectural-dimensions
Exemplo 2: Registrar um Sistema de Validação Personalizado
Crie um sistema que verifica a espessura da parede sempre que um nó de parede muda:
import { registerSystem, useScene } from '@pascal-app/core'
registerSystem({
name: 'wall-validator',
nodeTypes: ['wall'],
priority: 100,
process(dirtyNodes) {
for (const node of dirtyNodes) {
const { thickness, isExterior, height } = node.props
if (isExterior && thickness < 0.14)
console.warn(`Parede ${node.id}: espessura externa ${thickness}m < mínimo de 0,14m`)
if (height < 2.1)
console.warn(`Parede ${node.id}: altura ${height}m < mínimo de 2,1m`)
}
}
})
Isso é executado automaticamente sempre que os nós de parede são marcados como sujos, antes que os sistemas de geometria reconstruam as malhas.
Diretrizes
- Todas as dimensões estão em metros -- o Pascal usa o sistema métrico internamente
- Use
useScenepara todas as operações CRUD de nós,useViewerpara seleção/câmera,useEditorpara ferramentas - Ajuste as coordenadas para a grade de 0,1 m para geometria limpa
- Espessura das paredes: 0,20 m para externas, 0,10 m para divisórias internas
- A altura do peitoril da porta é sempre 0 (nível do piso); a altura do peitoril da janela padrão é 0,9 m
- Registre sistemas personalizados com prioridade > 50 para executar antes da reconstrução da geometria (0-50)
- Combine com a skill
architectural-dimensionspara validação de medidas do mundo real - Pacotes principais:
@pascal-app/core,@pascal-app/ui,@react-three/fiber,three,zustand - GitHub: github.com/pascalorg/editor