simple-circuit-engine 0.0.8 → 0.0.10

package/AGENTS.md

@@ -14,20 +14,25 @@ import {
   Circuit,
   BehaviorRegistry,
   registerBasicComponentsBehaviors,
+  registerGatesComponentsBehaviors,
 } from 'simple-circuit-engine/core';
 import {
   CircuitEngine,
   engineOptions,
-  FactoryRegistry,
+  GroupedFactoryRegistry,
   DefaultVisualFactory,
   registerBasicComponentsFactories,
+  registerGatesComponentsFactories,
 } from 'simple-circuit-engine/scene';
 
 // Create component factory registry and behavior registry with basic components
 const componentsFactoryRegistry = registerBasicComponentsFactories(
-  new FactoryRegistry(new DefaultVisualFactory())
+  new GroupedFactoryRegistry(new DefaultVisualFactory())
 );
+registerGatesComponentsFactories(componentsFactoryRegistry); //... other groups of components if needed
+
 const behaviorRegistry = registerBasicComponentsBehaviors(new BehaviorRegistry());
+registerGatesComponentsBehaviors(behaviorRegistry); //... other groupsof components  if needed
 
 // Instanciate and Initialize CircuitEngine (it creates and uses a new Circuit by default)
 const engine = new CircuitEngine(componentsFactoryRegistry, behaviorRegistry);
@@ -67,7 +72,7 @@ animate();
 - `CircuitRunner` - Tick-based simulation orchestrator
 - `SimulationState` - Circuit state at a given tick
 - `BehaviorRegistry` - Maps ComponentType → behavior logic
-- `registerBasicComponentsBehaviors()` - Registers built-in behaviors
+- `registerBasicComponentsBehaviors()` - Registers basic components built-in behaviors
 
 ### Types
 
@@ -84,15 +89,19 @@ animate();
 
 ### Visual Factories
 
-- `FactoryRegistry` - Maps ComponentType → visual factory
+- `GroupedFactoryRegistry` - Register groups of components referencing types and their visual factories
 - `DefaultVisualFactory` - Fallback factory for unknown types
-- `registerBasicComponentsFactories()` - Registers built-in factories
+- `registerBasicComponentsFactories()` - Registers basic components built-in factories
 
 ### Tools (Edit Mode)
 
-- `BuildTool` - Primary editing tool
-- `AddComponentTool` - Component placement
-- `MultiSelectTool` - Rectangle selection + bulk ops
+- `BuildTool` - Primary unified editing tool (add/drag/move/rotate/remove/wire/copy-cut/paste one element)
+- `MultiSelectTool` - Rectangle selection + bulk ops (drag, copy-cut/paste, remove multiple elements)
+
+### Widgets
+
+- `ComponentPicketWidget` - Widget for selecting component to add in BuildTool (edit mode)
+- `ConfigPanelWidget.ts` - Widget for editing components configuration (edit mode)
 
 ### Managers
 
@@ -130,10 +139,9 @@ engine.on('simulationTick', (state) => { ... });
 ### Non-Goals
 
 - **NOT realistic physics**: This is a discrete graph model, not SPICE
-- **NOT for production circuits**: Educational purposes only
+- **No analog simulation**: No voltage drops, current limiting, etc.
 - **Circuit states are boolean**: Tension/current are on/off, not continuous values
-- **No analog simulation**: No voltage drops, current limiting, etc.  
-
+- **NOT for production circuits**: Educational purposes only
 
 ### Do NOT
 

package/CLAUDE.md

@@ -68,9 +68,10 @@ src/scene/
   |     +-- CircuitWriter.ts     # Writes scene changes to core model
   |     +-- SelectionManager.ts  # Tracks selected elements
   |     +-- tools/
-  |           +-- BuildTool.ts       # Unified edit tool (state machine)
+  |           +-- BuildTool.ts       # Unified build tool (state machine)
+  |           +-- ComponentPickerWidget.ts # Widget for selecting component to add in BuildTool
+  |           +-- ConfigPanelWidget.ts # Widget for changing components configuration
   |           +-- MultiSelectTool.ts # Rectangle selection + bulk operations
-  |           +-- AddComponentTool.ts # Component placement tool
   +-- simulation/
   |     +-- CircuitRunnerController.ts  # Simulation mode controller
   +-- shared/
@@ -81,7 +82,7 @@ src/scene/
   |     +-- BranchingPointVisualFactory.ts # BP visuals
   |     +-- components/
   |     |     +-- ComponentVisualFactory.ts  # Interface + base class
-  |     |     +-- FactoryRegistry.ts         # Maps types to factories
+  |     |     +-- GroupedFactoryRegistry.ts  # Register groups of components referencing types and their visual factories
   |     |     +-- ...                        # Components factories
   |     +-- types.ts             # Shared type definitions
   |     +-- utils/               # Geometry, camera, lighting utilities

package/README.md

@@ -37,11 +37,11 @@ This code set up the main CircuitEngine instance in edit mode on a new Circuit,
 ```javascript
 import { WebGLRenderer } from 'three';
 import { Circuit, BehaviorRegistry, registerBasicComponentsBehaviors } from 'simple-circuit-engine/core';
-import { CircuitEngine, engineOptions, FactoryRegistry, DefaultVisualFactory, registerBasicComponentsFactories } from 'simple-circuit-engine/scene';
+import { CircuitEngine, engineOptions, GroupedFactoryRegistry, DefaultVisualFactory, registerBasicComponentsBehaviors } from 'simple-circuit-engine/scene';
 
-// Create component factory registry with all basic visual factories (for scene objects creation - rendering
-const componentsFactoryRegistry = registerBasicComponentsFactories(new FactoryRegistry(new DefaultVisualFactory()));
-// Create behavior registry with all basic component behaviors (for simulation)
+// Create component factory registry with basic components visual factories (for scene objects creation - rendering)
+const componentsFactoryRegistry = registerBasicComponentsFactories(new GroupedFactoryRegistry(new DefaultVisualFactory()));
+// Create behavior registry with basic components behaviors (for simulation)
 const behaviorRegistry = registerBasicComponentsBehaviors(new BehaviorRegistry());
 
 // Initialize CircuitEngine