editor: Einordnung, Einsatz und Prüfung

Ein WebGPU-basierter Gebäudeeditor mit Turborepo-Aufbau

pascalorg/editor wird im Material für den Prüfpunkt 1 als „Create and share 3D architectural projects. Node Renderers Renderers are React components that create Three.js objects for each node type: Pattern: 1.“ beschrieben. Der Standard-Branch ist main, die erfasste Sprache TypeScript. Die README ist die maßgebliche Quelle für die hier genannten Funktionen und belegt keine allgemeine Leistungs- oder Sicherheitsgarantie.

Pascal Editor ist ein in TypeScript geschriebener 3D-Gebäudeeditor, der auf React Three Fiber und WebGPU basiert. Das Repository ist ein Turborepo-Monorepo: apps/editor ist ein Next.js-Host, und packages enthält core, viewer, editor, nodes und ui. Die README beschreibt den viewer als 3D-Rendering-Laufzeit und den editor als die Ebene, die interaktive Werkzeuge und Auswahl hinzufügt. Die Repository-Metadaten beschreiben das Projekt als Möglichkeit, 3D-Architekturprojekte zu erstellen und zu teilen, aber die README selbst geht nicht auf den Freigabeworkflow ein.

Die README-Angaben nennen das Projekt ausdrücklich beim Namen und verknüpfen die Funktion mit dem Repository . Die Aussage beschreibt einen vorgesehenen Einsatz, keine Zusage für jede Umgebung. Für die Prüfung gehört der konkrete Einstieg des Projekts in den Test: Repository, README und die dort genannten Dateien müssen zusammenpassen.

Fünf Laufzeitpakete und ihre Abgrenzung

pascalorg/editor wird im Material für den Prüfpunkt 2 als „Create and share 3D architectural projects. Node Renderers Renderers are React components that create Three.js objects for each node type: Pattern: 1.“ beschrieben. Der Standard-Branch ist main, die erfasste Sprache TypeScript. Die README ist die maßgebliche Quelle für die hier genannten Funktionen und belegt keine allgemeine Leistungs- oder Sicherheitsgarantie.

@pascal-app/core verwaltet Knotenschemata, Szenenzustand über Zustand, Registry-Verträge, räumliche Abfragen und einen Event-Bus. @pascal-app/viewer bietet die React-Three-Fiber-Rendering-Laufzeit, gemeinsame Render-Systeme, Standardkamera und Steuerung sowie Nachbearbeitung. @pascal-app/editor enthält Bearbeitungswerkzeuge, Panels, Auswahl und UI zur direkten Manipulation. @pascal-app/nodes liefert das eingebaute Registry-Plugin mit Knotendefinitionen, Renderern, Geometrie und Systemen. Die Verantwortlichkeitstabelle der README weist jedem Paket eine Aufgabe zu, und apps/editor ist der eigenständige Next.js-Host, der alles verbindet.

Für eine belastbare Einordnung ist ein projektspezifischer Ablauf sinnvoll. Verwende den im README genannten Befehl oder Pfad, etwa `` sofern vorhanden, und beobachte genau die vom Projekt beschriebene Ausgabe. Fehlende Angaben zu Laufzeit, Datenhaltung oder Skalierung bleiben offene Punkte; sie werden nicht durch Annahmen ersetzt.

Szenenzustand und die drei Zustand-Stores

pascalorg/editor wird im Material für den Prüfpunkt 3 als „Create and share 3D architectural projects. Node Renderers Renderers are React components that create Three.js objects for each node type: Pattern: 1.“ beschrieben. Der Standard-Branch ist main, die erfasste Sprache TypeScript. Die README ist die maßgebliche Quelle für die hier genannten Funktionen und belegt keine allgemeine Leistungs- oder Sicherheitsgarantie.

Der Zustand ist auf drei Zustand-Stores verteilt. useScene in @pascal-app/core speichert Knoten, Root-IDs, dirty Nodes und CRUD-Operationen; es persistiert in IndexedDB und nutzt Zundo für Undo/Redo mit 50-Schritte-Verlauf. useViewer in @pascal-app/viewer verfolgt die aktuelle Auswahl von Building-, Level- und Zone-IDs, den Anzeigemodus für Ebenen (stacked, exploded, solo) und den Kameramodus. useEditor in apps/editor speichert das aktive Werkzeug, die Sichtbarkeit von Strukturebenen, Panel-Zustände und editorspezifische Einstellungen. Die README zeigt Abonnement-Syntax für React-Komponenten und getState-Aufrufe für Code außerhalb von React.

Die Lizenz und die Pflegehinweise bilden einen eigenen Teil der Entscheidung. Metadaten sind ein Signal über den aktuellen Stand, aber keine Aussage über Fehlerfreiheit oder Support. Bei einer Integration müssen Abhängigkeiten, Berechtigungen und der Umgang mit Nutzerdaten am tatsächlichen Code und an der jeweiligen Konfiguration geprüft werden.

Knoten, Hierarchie und die Szenen-Registry

pascalorg/editor wird im Material für den Prüfpunkt 4 als „Create and share 3D architectural projects. Node Renderers Renderers are React components that create Three.js objects for each node type: Pattern: 1.“ beschrieben. Der Standard-Branch ist main, die erfasste Sprache TypeScript. Die README ist die maßgebliche Quelle für die hier genannten Funktionen und belegt keine allgemeine Leistungs- oder Sicherheitsgarantie.

Knoten sind die Datenprimitive der Szene und erweitern alle BaseNode mit id, type, parentId, visible, einer optionalen gespeicherten Kamera und optionalen JSON-Metadaten. Die Hierarchie ist Site, Building, Level, dann Wall mit Item-Kindern, Slab, Ceiling mit Item-Kindern, Roof, Zone, Scan und Guide. Knoten werden in einem flachen Wörterbuch Record<id, Node> gespeichert, nicht in einem verschachtelten Baum; Eltern-Kind-Verknüpfungen werden über parentId- und children-Arrays geführt. Eine Szenen-Registry bildet Knoten-IDs auf Three.js-Objekte ab und indexiert Objekte auch nach Typ, sodass Systeme Objekte auflösen können, ohne den Szenengraphen zu durchlaufen. Renderer sind React-Komponenten, die Platzhalter-Meshes erstellen und mit useRegistry registrieren.

Systeme berechnen Geometrie aus dirty Nodes neu

pascalorg/editor wird im Material für den Prüfpunkt 5 als „Create and share 3D architectural projects. Node Renderers Renderers are React components that create Three.js objects for each node type: Pattern: 1.“ beschrieben. Der Standard-Branch ist main, die erfasste Sprache TypeScript. Die README ist die maßgebliche Quelle für die hier genannten Funktionen und belegt keine allgemeine Leistungs- oder Sicherheitsgarantie.

Systeme sind React-Komponenten, die im Render-Loop über useFrame laufen und Geometrie sowie Transformationen aktualisieren. Wenn createNode, updateNode oder deleteNode einen Knoten ändert, wird dieser zur dirtyNodes-Menge in useScene hinzugefügt. Jedes Frame iterieren Systeme über die dirty-Menge, suchen den Knoten und sein registriertes Three.js-Objekt, berechnen die Geometrie neu und löschen das Flag. Zu den Kernsystemen gehören WallSystem, SlabSystem, CeilingSystem, RoofSystem und ItemSystem; zu den Viewer-Systemen gehören LevelSystem, ScanSystem und GuideSystem. WallSystem erzeugt Wandgeometrie mit Gehrungen und CSG-Ausschnitten für Türen und Fenster, während ItemSystem Objekte an Wänden, Decken oder Böden positioniert. Die dirty-Menge kann auch manuell markiert werden.

Editor-Werkzeuge, Auswahl und Plugin-Erweiterung

pascalorg/editor wird im Material für den Prüfpunkt 6 als „Create and share 3D architectural projects. Node Renderers Renderers are React components that create Three.js objects for each node type: Pattern: 1.“ beschrieben. Der Standard-Branch ist main, die erfasste Sprache TypeScript. Die README ist die maßgebliche Quelle für die hier genannten Funktionen und belegt keine allgemeine Leistungs- oder Sicherheitsgarantie.

Der Editor erweitert den Viewer um Werkzeuge, die über die Symbolleiste aktiviert werden: SelectTool, WallTool, ZoneTool, ItemTool und SlabTool. Ein benutzerdefinierter Auswahlmanager durchläuft die Hierarchie Site, Building, Level, Zone und Items; jede Tiefe hat ihre eigene Hover- und Klickstrategie. Editorspezifische Systeme umfassen ZoneSystem und benutzerdefinierte Kamerasteuerung zum Fokussieren von Knoten. Plugins sind der Erweiterungsweg für neue Knotenarten und linke Panels; die README verlinkt auf einen Entwicklerleitfaden und nennt pascalorg/plugin-trees als ausgearbeitetes Beispiel. Plugins verwenden dasselbe Plugin-Manifest wie die eingebauten, es gibt keine separate interne API.

Entwicklungsbefehle und MIT-Lizenz

pascalorg/editor wird im Material für den Prüfpunkt 7 als „Create and share 3D architectural projects. Node Renderers Renderers are React components that create Three.js objects for each node type: Pattern: 1.“ beschrieben. Der Standard-Branch ist main, die erfasste Sprache TypeScript. Die README ist die maßgebliche Quelle für die hier genannten Funktionen und belegt keine allgemeine Leistungs- oder Sicherheitsgarantie.

Die Entwicklung nutzt Bun als Paketmanager. Von der Repository-Wurzel aus führt bun install und dann bun dev dazu, dass @pascal-app/core und @pascal-app/viewer gebaut werden, der Watch-Modus für beide Pakete startet und der Next.js-Editor unter http://localhost:3002 läuft. Produktions-Builds verwenden turbo build, optional gefiltert auf ein Paket. Die README zeigt auch npm-publish-Befehle für core und viewer. Das Repository ist MIT-lizenziert, Copyright Pascal Group Inc. Die Lizenz erlaubt das Verwenden, Kopieren, Ändern, Zusammenführen, Veröffentlichen, Verteilen, Unterlizenzieren und Verkaufen von Kopien, sofern der Copyright-Hinweis enthalten ist. Sie lehnt ausdrücklich Gewährleistung und Haftung ab und sagt nichts über Support, Sicherheitsgarantien oder Produktionsreife.

Redaktionelles Fazit

Geeignet ist pascalorg/editor für Teams, deren konkreter Anwendungsfall mit der README-Beschreibung übereinstimmt und die den genannten Einstieg selbst ausführen können. Ungeeignet ist es als ungeprüfter Ersatz für eine eigene Betriebs- oder Sicherheitsbewertung. Zuerst sollten der README-Einstieg, die relevanten Dateien und die Ausgabe des projektspezifischen Befehls geprüft werden.

Offizielle Quellen

1. Official documentation
2. Official README
3. Project repository
4. Release notes