simple-circuit-engine 0.0.12 → 0.0.13

package/dist/scene/shared/components/index.d.ts

@@ -27,3 +27,7 @@ export { Nor8GateVisualFactory } from './gates/Nor8GateVisualFactory';
 export { XorGateVisualFactory } from './gates/XorGateVisualFactory';
 export { Xor4GateVisualFactory } from './gates/Xor4GateVisualFactory';
 export { Xor8GateVisualFactory } from './gates/Xor8GateVisualFactory';
+export { HalfAdderVisualFactory } from './arithmetic/HalfAdderVisualFactory';
+export { AdderVisualFactory } from './arithmetic/AdderVisualFactory';
+export { EightBitAdderVisualFactory } from './arithmetic/EightBitAdderVisualFactory';
+export { EightBitOnesComplementVisualFactory } from './arithmetic/EightBitOnesComplementVisualFactory';

package/dist/scene/shared/types.d.ts

@@ -452,8 +452,6 @@ export type ConfigControlType = 'dropdown' | 'color' | 'number' | 'text' | 'bool
 export interface ConfigFieldDefinition {
     /** Config map key (e.g., "activeColor", "initialState") */
     key: string;
-    /** Human-readable label for the form field */
-    label: string;
     /** Control type to render */
     type: ConfigControlType;
     /** Options for dropdown type (array or label-value object) */

package/dist/scene/shared/utils/GeometryUtils.d.ts

@@ -247,6 +247,36 @@ export declare function XorGateTailGeometry(orWidth: number, orHeight: number, t
  */
 export declare function LGeometry(width: number, height: number, thickness: number, angle: number, invert: boolean, junctionRadius: number, depth: number, steps?: number): ExtrudeGeometry;
 export declare function CyclicTrapezoidGeometry(width: number, tailHeight: number, headHeight: number, thickness: number, depth: number, steps?: number): ExtrudeGeometry;
+/**
+ * Create an ExtrudeGeometry shaped like an empty rectangle (frame/border).
+ * Shape is centered at origin. The inner hole is a smaller rectangle inset
+ * by `thickness` on all four sides.
+ *
+ * @param width     - Total width of the outer rectangle
+ * @param height    - Total height of the outer rectangle
+ * @param thickness - Wall thickness of the frame (inset on each side)
+ * @param depth     - Extrusion depth
+ * @param steps     - Number of extrusion steps
+ * @constructor
+ */
+export declare function EmptyRectangleGeometry(width: number, height: number, thickness: number, depth: number, steps?: number): ExtrudeGeometry;
+/**
+ * Create an ExtrudeGeometry shaped like a rectangle with a rectangular "nail"
+ * (intrusion or protrusion)
+ * The main rectangle is centered at origin; the nail hangs inside or outside it.
+ *
+ * @param width      - Total width of the rectangle
+ * @param height     - Height of the main rectangle body
+ * @param nailWidth  - Width of the nail intrusion
+ * @param nailHeight - Height of the nail
+ * @param nailX      - Horizontal center of the nail, measured from the rectangle's left edge
+ * @param protusion  - if false nail will enter inside the rectangle (intrusion), else outside (protusion)
+ * @param depth      - Extrusion depth
+ * @param steps      - Number of extrusion steps
+ * @throws Error if nail dimensions or position are geometrically invalid
+ * @constructor
+ */
+export declare function RectangleWithNailGeometry(width: number, height: number, nailWidth: number, nailHeight: number, nailX: number, protusion: boolean, depth: number, steps?: number): ExtrudeGeometry;
 /**
  * Create an ExtrudeGeometry for the inner hole of a cyclic trapezoid.
  * Returns null when the geometry should be solid (no hole).
@@ -259,3 +289,49 @@ export declare function CyclicTrapezoidGeometry(width: number, tailHeight: numbe
  * @param steps      - Number of extrusion steps
  */
 export declare function CyclicTrapezoidHoleGeometry(width: number, tailHeight: number, headHeight: number, thickness: number, depth: number, steps?: number): ExtrudeGeometry | null;
+/**
+ * Create an ExtrudeGeometry for a drip (teardrop) shape.
+ * The shape has a sharp pointed tip at the top and a rounded bottom.
+ * Shape is centered at origin.
+ *
+ * Construction: the rounded bottom is a circle of radius width/2 centered at
+ * y = -height/2 + width/2. Two straight tangent lines connect the circle to the
+ * tip at (0, +height/2). This requires height > width so the tip sits above the
+ * circle and the tangent lines exist.
+ *
+ * @param width     - Total width
+ * @param height    - Total height (must be > width)
+ * @param thickness - Wall thickness of the shell
+ * @param depth     - Extrusion depth
+ * @param steps     - Number of extrusion steps
+ * @throws Error if height <= width (tip too low for tangent construction)
+ * @constructor
+ */
+export declare function DripGeometry(width: number, height: number, thickness: number, depth: number, steps?: number): ExtrudeGeometry;
+/**
+ * Create an ExtrudeGeometry for the inner hole of a drip shape.
+ * Returns null when thickness is large enough that the drip has no hole.
+ *
+ * @param width     - Total width
+ * @param height    - Total height (must be > width)
+ * @param thickness - Wall thickness
+ * @param depth     - Extrusion depth
+ * @param steps     - Number of extrusion steps
+ * @throws Error if height <= width
+ */
+export declare function DripHoleGeometry(width: number, height: number, thickness: number, depth: number, steps?: number): ExtrudeGeometry | null;
+/**
+ * Create an ExtrudeGeometry shaped like japanese hiragana Ku and katakana Ko (くコ)
+ * Shape is centered horizontally at the junction between the two and vertically at the middle height
+ * by `kuThickness` on all four sides.
+ *
+ * @param kuWidth     - width of the left ku part (outer)
+ * @param koWidth     - width of the right ko part (outer)
+ * @param height    - Total height of the outer geometry
+ * @param kuThickness - Wall kuThickness of the frame (inset on ku side)
+ * @param koThickness - Wall koThickness of the frame (inset on ko side)
+ * @param depth     - Extrusion depth
+ * @param steps     - Number of extrusion steps
+ * @constructor
+ */
+export declare function KuKoGeometry(kuWidth: number, koWidth: number, height: number, kuThickness: number, koThickness: number, depth: number, steps?: number): ExtrudeGeometry;

package/dist/scene/static/CircuitController.d.ts

@@ -41,6 +41,7 @@ export declare class CircuitController extends AbstractCircuitController {
      * @throws {TypeError} factoryRegistry is null/undefined
      */
     constructor(factoryRegistry: IFactoryRegistry, sharedResources?: SharedResources);
+    setLanguage(lng: string): void;
     /**
      * Specific Initialization logic, performed after AbstractCircuitController initialization
      * @private

package/dist/scene/static/PinTooltipWidget.d.ts

@@ -21,6 +21,11 @@ export declare class PinTooltipWidget {
     /** Update cursor position without recreating the tooltip */
     updatePosition(clientX: number, clientY: number): void;
     get isVisible(): boolean;
+    /**
+     * Signal a language change — hides any open tooltip so the next hover
+     * recreates it with updated translations.
+     */
+    setLanguage(_lng: string): void;
     dispose(): void;
     private _position;
 }

package/dist/scene/static/tools/BuildTool.d.ts

@@ -49,6 +49,10 @@ export declare class BuildTool implements IEditingTool {
      * Cancels any active operations and removes all event handlers
      */
     onDeactivate(): void;
+    /**
+     * Forward a language change to the component picker.
+     */
+    setLanguage(lng: string): void;
     /**
      * Cancel current ongoing operation : can be called from outside if needed
      */

package/dist/scene/static/tools/ComponentPickerWidget.d.ts

@@ -31,6 +31,7 @@ export interface ComponentPickerState {
 export declare class ComponentPickerWidget {
     private readonly registry;
     private container;
+    private titleEl;
     private groupDropdown;
     private itemList;
     private state;
@@ -69,6 +70,12 @@ export declare class ComponentPickerWidget {
      * Full cleanup including state reset.
      */
     dispose(): void;
+    /**
+     * Refresh all user-visible text in place after a language change.
+     * No-op if the widget is not currently open.
+     * Preserves drag position, scroll, resize dimensions, and current selection.
+     */
+    setLanguage(_lng: string): void;
     private createDOM;
     private renderItemList;
     private createItemElement;

package/dist/scene/static/tools/ConfigPanelWidget.d.ts

@@ -16,6 +16,8 @@ export declare class ConfigPanelWidget {
     private readonly editComponentConfig;
     private _isOpen;
     private _currentComponentId;
+    private _currentComponent;
+    private _currentFactory;
     private gui;
     private container;
     private formDataObject;
@@ -77,6 +79,18 @@ export declare class ConfigPanelWidget {
      * @param factory - Visual factory for the component
      */
     private onValueChange;
+    /**
+     * Resolve a form field label via i18n, falling back to a humanised form
+     * of the field key when no translation is available (e.g. "transitionSpan" →
+     * "Transition Span"). The fallback covers two cases: (a) the consumer never
+     * called registerSceTranslations, (b) the key is not yet in the locale file.
+     */
+    private _resolveFieldLabel;
+    /**
+     * Refresh the panel to display strings in the current language.
+     * No-op if the panel is not open.
+     */
+    setLanguage(_lng: string): void;
     /**
      * Rebuild the GUI in place, re-reading the updated component config.
      * Used after interdependent field changes (defaultLogicFamily, activationLogic).