feat: roundedBox and text

Author: BCsabaEngine

projects/examples/A.solids.ts

@@ -67,6 +67,34 @@ export const hexagonalPrism = (): Solid => {
 	return Solid.prism(6, 6, 12, { color: 'cyan' }); // 6-sided, radius 6, height 12
 };
 
+/**
+ * Rounded Box - box with filleted/rounded edges
+ * Parameters: width (X), height (Y), depth (Z), options object with color, radius, segments
+ * Note: Radius defaults to 10% of smallest dimension. Segments control rounding quality.
+ */
+export const roundedBox = (): Solid => {
+	return Solid.roundedBox(10, 10, 10, { color: 'teal', radius: 2 }); // 10×10×10 with 2-unit radius
+};
+
+/**
+ * Text - 3D extruded text
+ * Parameters: text string, options object with color, size, height (extrusion depth)
+ * Note: Uses Helvetiker Regular font. Text is centered on XZ plane and aligned to Y=0
+ */
+export const textShape = (): Solid => {
+	return Solid.text('CSG', { color: 'blue', size: 8, height: 3 }); // "CSG" text
+};
+
+/**
+ * Text as Cutter - demonstrates using text in CSG subtraction (embossing/engraving)
+ * Creates a plate with text cut into it
+ */
+export const textCutter = (): Solid => {
+	const plate = Solid.cube(30, 20, 5, { color: 'gray' }).center().align('bottom');
+	const text = Solid.text('HELLO', { size: 4, height: 10, color: 'gray' }).move({ y: 10 });
+	return Solid.SUBTRACT(plate, text);
+};
+
 /**
  * Component registration map
  * Keys: Component names (appear in UI dropdown)
@@ -80,5 +108,8 @@ export const components: ComponentsMap = {
 	'A3. Solids: Sphere': sphere,
 	'A4. Solids: Cone': cone,
 	'A5. Solids: Triangle Prism': trianglePrism,
-	'A6. Solids: Hexagonal Prism': hexagonalPrism
+	'A6. Solids: Hexagonal Prism': hexagonalPrism,
+	'A7. Solids: Rounded Box': roundedBox,
+	'A8. Solids: Text': textShape,
+	'A9. Solids: Text Cutter': textCutter
 };

src/lib/3d/Solid.ts

@@ -12,6 +12,11 @@ import {
 	SphereGeometry,
 	Vector3
 } from 'three';
+import helvetikerFont from 'three/examples/fonts/helvetiker_regular.typeface.json';
+import { RoundedBoxGeometry } from 'three/examples/jsm/geometries/RoundedBoxGeometry.js';
+import { TextGeometry } from 'three/examples/jsm/geometries/TextGeometry.js';
+import type { Font } from 'three/examples/jsm/loaders/FontLoader.js';
+import { FontLoader } from 'three/examples/jsm/loaders/FontLoader.js';
 import { STLLoader } from 'three/examples/jsm/loaders/STLLoader.js';
 import { SVGLoader } from 'three/examples/jsm/loaders/SVGLoader.js';
 import { ADDITION, Brush, Evaluator, INTERSECTION, SUBTRACTION } from 'three-bvh-csg';
@@ -56,6 +61,16 @@ export class Solid {
 	// ============================================================================
 
 	private static evaluator: Evaluator = new Evaluator();
+	private static defaultFont: Font | undefined = undefined;
+
+	// Helper to load and cache the default font for text geometry
+	private static getDefaultFont(): Font {
+		if (!this.defaultFont) {
+			const loader = new FontLoader();
+			this.defaultFont = loader.parse(helvetikerFont);
+		}
+		return this.defaultFont;
+	}
 
 	// Helper to convert degrees to radians
 	private static degreesToRadians = (degrees: number): number => degrees * (Math.PI / 180);
@@ -133,11 +148,13 @@ export class Solid {
 	private static geometryToBrush(
 		geometry:
 			| BoxGeometry
+			| RoundedBoxGeometry
 			| CylinderGeometry
 			| SphereGeometry
 			| ConeGeometry
 			| ExtrudeGeometry
 			| LatheGeometry
+			| TextGeometry
 			| BufferGeometry
 	): Brush {
 		const result = new Brush(geometry.translate(0, 0, 0));
@@ -172,6 +189,44 @@ export class Solid {
 		).normalize();
 	};
 
+	static roundedBox = (
+		width: number,
+		height: number,
+		depth: number,
+		options?: {
+			color?: string;
+			radius?: number;
+			segments?: number;
+		}
+	): Solid => {
+		// Validate dimensions (check finite first, then positive)
+		if (!Number.isFinite(width) || !Number.isFinite(height) || !Number.isFinite(depth))
+			throw new Error(
+				`RoundedBox dimensions must be finite (got width: ${width}, height: ${height}, depth: ${depth})`
+			);
+		if (width <= 0 || height <= 0 || depth <= 0)
+			throw new Error(
+				`RoundedBox dimensions must be positive (got width: ${width}, height: ${height}, depth: ${depth})`
+			);
+
+		const color = options?.color ?? 'gray';
+		const radius = options?.radius ?? Math.min(width, height, depth) * 0.1;
+		const segments = options?.segments ?? 2;
+
+		// Validate radius is within bounds
+		const maxRadius = Math.min(width, height, depth) / 2;
+		if (radius > maxRadius)
+			throw new Error(
+				`RoundedBox radius (${radius}) cannot exceed half of smallest dimension (${maxRadius})`
+			);
+		if (radius < 0) throw new Error(`RoundedBox radius must be non-negative (got ${radius})`);
+
+		return new Solid(
+			this.geometryToBrush(new RoundedBoxGeometry(width, height, depth, segments, radius)),
+			color
+		).normalize();
+	};
+
 	static cylinder = (
 		radius: number,
 		height: number,
@@ -388,6 +443,46 @@ export class Solid {
 		}
 	): Solid => this.prism(3, radius, height, options);
 
+	static text = (
+		text: string,
+		options?: {
+			color?: string;
+			size?: number;
+			height?: number;
+			curveSegments?: number;
+			bevelEnabled?: boolean;
+		}
+	): Solid => {
+		// Validate text parameter
+		if (!text || text.length === 0) throw new Error('Text cannot be empty');
+
+		const color = options?.color ?? 'gray';
+		const size = options?.size ?? 10;
+		const height = options?.height ?? 2;
+		const curveSegments = options?.curveSegments ?? 12;
+		const bevelEnabled = options?.bevelEnabled ?? false;
+
+		// Get the default font
+		const font = this.getDefaultFont();
+
+		// Create text geometry
+		// Note: TextGeometry's 'depth' parameter is what we call 'height' (extrusion depth)
+		const geometry = new TextGeometry(text, {
+			font,
+			size,
+			depth: height,
+			curveSegments,
+			bevelEnabled
+		});
+
+		// Create solid and normalize
+		const solid = new Solid(this.geometryToBrush(geometry), color).normalize();
+
+		// Center text on XZ plane and align to bottom (Y=0)
+		// This makes text easier to position and orient consistently
+		return solid.center({ x: true, z: true }).align('bottom');
+	};
+
 	// ============================================================================
 	// SECTION 4.5: Import Methods (Static)
 	// ============================================================================