sanchousf-ai-toolkit 0.2.1__tar.gz

sanchousf_ai_toolkit-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sanchousf
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sanchousf_ai_toolkit-0.2.1/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: sanchousf-ai-toolkit
+Version: 0.2.1
+Summary: AI-Toolkit: Modular CAD, AI, and Engineering Tools
+Author: AI-Toolkit Contributors
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Manufacturing
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
+Classifier: Topic :: Multimedia :: Graphics :: Viewers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dearpygui>=1.10.0
+Requires-Dist: numpy>=1.22.0
+Requires-Dist: scipy>=1.9.0
+Requires-Dist: scikit-image>=0.19.0
+Requires-Dist: trimesh>=3.15.0
+Requires-Dist: PyOpenGL>=3.1.5
+Requires-Dist: pillow>=9.0.0
+Requires-Dist: shapely>=2.0.0
+Requires-Dist: manifold3d>=3.0.0
+Requires-Dist: glfw>=2.5.0
+Requires-Dist: matplotlib>=3.5.0
+Requires-Dist: rich>=12.0.0
+Provides-Extra: cad
+Requires-Dist: dearpygui>=1.10.0; extra == "cad"
+Requires-Dist: numpy>=1.22.0; extra == "cad"
+Requires-Dist: scipy>=1.9.0; extra == "cad"
+Requires-Dist: scikit-image>=0.19.0; extra == "cad"
+Requires-Dist: trimesh>=3.15.0; extra == "cad"
+Requires-Dist: PyOpenGL>=3.1.5; extra == "cad"
+Requires-Dist: pillow>=9.0.0; extra == "cad"
+Requires-Dist: shapely>=2.0.0; extra == "cad"
+Requires-Dist: manifold3d>=3.0.0; extra == "cad"
+Requires-Dist: glfw>=2.5.0; extra == "cad"
+Requires-Dist: matplotlib>=3.5.0; extra == "cad"
+Requires-Dist: rich>=12.0.0; extra == "cad"
+Provides-Extra: remesh
+Requires-Dist: pyvista>=0.40.0; extra == "remesh"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
+Requires-Dist: pyvista>=0.40.0; extra == "dev"
+Requires-Dist: setuptools>=61.0; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# AI Toolkit
+
+A modular repository of specialized engineering tools, automation workflows, and helper utilities designed for AI agents and human developers.
+
+---
+
+## Toolkits & Modules
+
+| Module | Description | Quick Links |
+|---|---|---|
+| **[CAD Toolkit](cad/README.md)** | Hardware-accelerated 3D CAD viewer, procedural & parametric modeling engine, CSG operations, Signed Distance Fields (SDF), 3D printability analysis, and AI Agent CollabBridge HTTP/CLI. | [Documentation](cad/README.md) • [Interactive Viewer](cad/README.md#1-launching-the-interactive-3d-viewer) • [AI Bridge](cad/README.md#3-ai-agent-collabbridge-bridgepy) |
+
+---
+
+## Highlights: 3D CAD Toolkit (`cad/`)
+
+The **[CAD Toolkit](cad/README.md)** provides a complete 3D modeling and visualization suite built for autonomous AI agents and pair-programming workflows:
+
+- **Interactive 3D Viewport**: Fast, cross-platform UI with Dear PyGui and hardware-accelerated OpenGL offscreen rendering with CPU fallback.
+- **AI Agent CollabBridge**: HTTP JSON API & CLI on port `8765` enabling external AI agents to query scene state, inspect geometry, command camera views, adjust live parameters, and export models.
+- **Procedural Modeling**: Parametric primitives, CSG booleans (union, difference, intersection, chamfer, fillet) powered by Manifold3D, assemblies, and exploded views.
+- **Signed Distance Fields (SDF)**: Smooth mathematical CSG blending and high-resolution Marching Cubes meshing.
+- **3D Print Preparation**: Overhang detection, support volume estimation, bed boundary checks (Bambu, Prusa, Ender, Voron), and automatic print orientation optimization.
+- **Automated Testing & CI**: Comprehensive 222-test suite enforcing >=90% code coverage across Linux, Windows, and macOS.
+
+For full setup instructions, CLI parameters, and developer guides, refer to the **[CAD Toolkit Documentation](cad/README.md)**.
+
+---
+
+## Repository Structure
+
+```text
+ai-toolkit/
+├── .github/
+│   └── workflows/
+│       └── cad.yml           # Cross-platform GitHub Actions CI for CAD
+├── cad/                      # 3D Computer-Aided Design & Procedural Modeling Tool
+│   ├── README.md             # In-depth CAD documentation & CLI reference
+│   ├── view.py               # Interactive 3D CAD viewer
+│   ├── save.py               # Headless scene exporter & snapshot generator
+│   ├── bridge.py             # AI Agent CollabBridge client
+│   ├── core/                 # Modeling, rendering, SDF, and geometry engine
+│   ├── scenes/               # Demo procedural scenes
+│   ├── scripts/              # Cross-platform environment & setup helpers
+│   ├── ci/                   # Tool-specific CI composite action
+│   └── tests/                # 222 unit and integration tests (95% coverage)
+└── LICENSE                   # Repository license
+```
+
+---
+
+## Contributing & Development
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/sanchousf/ai-toolkit.git
+   cd ai-toolkit
+   ```
+2. Navigate to the tool directory (e.g. `cd cad`) and run the setup script:
+   - Linux / macOS / Termux: `./setup_dev.sh`
+   - Windows: `setup_dev.bat`
+3. Run tests with coverage:
+   - Linux / macOS / Termux: `./run_tests.sh`
+   - Windows: `run_tests.bat`

sanchousf_ai_toolkit-0.2.1/README.md

@@ -0,0 +1,64 @@
+# AI Toolkit
+
+A modular repository of specialized engineering tools, automation workflows, and helper utilities designed for AI agents and human developers.
+
+---
+
+## Toolkits & Modules
+
+| Module | Description | Quick Links |
+|---|---|---|
+| **[CAD Toolkit](cad/README.md)** | Hardware-accelerated 3D CAD viewer, procedural & parametric modeling engine, CSG operations, Signed Distance Fields (SDF), 3D printability analysis, and AI Agent CollabBridge HTTP/CLI. | [Documentation](cad/README.md) • [Interactive Viewer](cad/README.md#1-launching-the-interactive-3d-viewer) • [AI Bridge](cad/README.md#3-ai-agent-collabbridge-bridgepy) |
+
+---
+
+## Highlights: 3D CAD Toolkit (`cad/`)
+
+The **[CAD Toolkit](cad/README.md)** provides a complete 3D modeling and visualization suite built for autonomous AI agents and pair-programming workflows:
+
+- **Interactive 3D Viewport**: Fast, cross-platform UI with Dear PyGui and hardware-accelerated OpenGL offscreen rendering with CPU fallback.
+- **AI Agent CollabBridge**: HTTP JSON API & CLI on port `8765` enabling external AI agents to query scene state, inspect geometry, command camera views, adjust live parameters, and export models.
+- **Procedural Modeling**: Parametric primitives, CSG booleans (union, difference, intersection, chamfer, fillet) powered by Manifold3D, assemblies, and exploded views.
+- **Signed Distance Fields (SDF)**: Smooth mathematical CSG blending and high-resolution Marching Cubes meshing.
+- **3D Print Preparation**: Overhang detection, support volume estimation, bed boundary checks (Bambu, Prusa, Ender, Voron), and automatic print orientation optimization.
+- **Automated Testing & CI**: Comprehensive 222-test suite enforcing >=90% code coverage across Linux, Windows, and macOS.
+
+For full setup instructions, CLI parameters, and developer guides, refer to the **[CAD Toolkit Documentation](cad/README.md)**.
+
+---
+
+## Repository Structure
+
+```text
+ai-toolkit/
+├── .github/
+│   └── workflows/
+│       └── cad.yml           # Cross-platform GitHub Actions CI for CAD
+├── cad/                      # 3D Computer-Aided Design & Procedural Modeling Tool
+│   ├── README.md             # In-depth CAD documentation & CLI reference
+│   ├── view.py               # Interactive 3D CAD viewer
+│   ├── save.py               # Headless scene exporter & snapshot generator
+│   ├── bridge.py             # AI Agent CollabBridge client
+│   ├── core/                 # Modeling, rendering, SDF, and geometry engine
+│   ├── scenes/               # Demo procedural scenes
+│   ├── scripts/              # Cross-platform environment & setup helpers
+│   ├── ci/                   # Tool-specific CI composite action
+│   └── tests/                # 222 unit and integration tests (95% coverage)
+└── LICENSE                   # Repository license
+```
+
+---
+
+## Contributing & Development
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/sanchousf/ai-toolkit.git
+   cd ai-toolkit
+   ```
+2. Navigate to the tool directory (e.g. `cd cad`) and run the setup script:
+   - Linux / macOS / Termux: `./setup_dev.sh`
+   - Windows: `setup_dev.bat`
+3. Run tests with coverage:
+   - Linux / macOS / Termux: `./run_tests.sh`
+   - Windows: `run_tests.bat`

sanchousf_ai_toolkit-0.2.1/cad/README.md

@@ -0,0 +1,249 @@
+# 3D CAD Toolkit
+
+A high-performance, modular 3D Computer-Aided Design (CAD), procedural modeling, and visualization engine engineered for both interactive human workflows and autonomous AI agent collaboration.
+
+---
+
+## Key Features
+
+- **Interactive 3D Viewport**:
+  - Built with [Dear PyGui](https://github.com/hoffstadt/DearPyGui) for responsive, lightweight cross-platform GUI.
+  - Hardware-accelerated OpenGL offscreen rendering with true per-pixel depth buffering (Z-buffer), polygon offset shaded-wireframe overlays, and automatic CPU rasterizer fallback.
+  - 3D translation/rotation/scale manipulator gizmos, flying and orbit camera controls, RGB coordinate axes, and build-plate grid.
+  - Interactive measurement tools (point-to-point distance, angles, surface area).
+
+- **AI Agent CollabBridge (HTTP & CLI)**:
+  - Built-in HTTP JSON API (`port 8765`) and CLI (`bridge.py`) designed specifically for AI pair programmers and autonomous agents.
+  - Allows external processes to query scene state, select/inspect objects, trigger parametric tweaks, draw temporary 3D debug overlays, and command camera movements in real time without restarting the viewer.
+
+- **Procedural & Parametric Modeling**:
+  - **Primitives**: Box, Sphere, Cylinder, Capsule, Cone, Torus, Extruded Text, and 3D Polylines.
+  - **CSG Operations**: Exact Boolean Union, Difference, Intersection, Chamfer, Fillet, Sweep, and Loft via [Manifold3D](https://github.com/elalish/manifold).
+  - **Assembly Management**: Hierarchical object groups, transformation hierarchies, and interactive exploded views.
+
+- **Signed Distance Fields (SDF) & Meshing**:
+  - Mathematical SDF representation with smooth polynomial CSG blending (`smooth_union`, `smooth_difference`, `smooth_intersection`).
+  - High-resolution Marching Cubes and Dual Contouring meshing with integrated quadric mesh decimation/simplification.
+
+- **3D Printability Analysis**:
+  - Watertight / manifold topology validation.
+  - Critical overhang detection and support volume estimation.
+  - Build-volume verification against popular printer presets (Bambu Lab, Prusa MK3/MK4, Ender 3, Voron 2.4/350).
+  - Automatic print orientation optimization (`--auto-orient`) to minimize support requirements and maximize build-plate contact area.
+
+- **Multi-Format Export & Rendering**:
+  - **3D Formats**: Binary/ASCII STL, OBJ, PLY, GLB, and DXF.
+  - **High-Resolution Snapshots**: Anti-aliased (SSAA 1x/2x/4x) image snapshots in PNG (with alpha transparency), JPEG, WebP, TIFF, and BMP with customizable camera angles and backgrounds.
+
+- **Cross-Platform & Headless Compatibility**:
+  - Tested and supported across Linux (Ubuntu, Debian, and Android Termux/PRoot), macOS, and Windows.
+  - Intelligent OpenGL driver probe and caching system to handle headless virtual machines and software rasterization environments.
+
+---
+
+## Directory Structure
+
+```text
+cad/
+├── view.py                  # Main interactive 3D CAD viewer application
+├── save.py                  # Headless scene exporter, snapshot generator & CLI
+├── bridge.py                # CollabBridge CLI for external & AI agent control
+├── remesh.py                # Standalone mesh decimation & remeshing tool
+├── requirements.txt         # Core runtime dependencies
+├── requirements-dev.txt     # Development and testing dependencies
+├── pytest.ini               # Pytest configuration (90% coverage enforcement)
+│
+├── core/                    # Core engine implementation
+│   ├── analysis/            # 3D printability, overhangs, bed envelopes
+│   ├── bridge/              # HTTP CollabBridge server & protocol
+│   ├── common/              # Global constants and progress reporting
+│   ├── geometry/            # Mesh representations, transforms, STL I/O
+│   ├── io/                  # Multi-format mesh exporters (STL, OBJ, GLB, etc.)
+│   ├── modeling/            # CSG booleans, assemblies, sketches, remeshing
+│   ├── primitives/          # Parametric shapes, text, polyline sweeps
+│   ├── rendering/           # OpenGL FBO renderer, DPG viewport, gizmo, camera
+│   ├── scratchpad/          # Temporary geometric canvas for experiments
+│   ├── sdf/                 # Mathematical SDF models and Marching Cubes mesher
+│   └── spatial/             # Raycasting, BVH, and screen-space object picking
+│
+├── scenes/                  # Ready-to-run procedural scene definitions
+│   ├── assembly_demo.py     # Multi-part mechanical assembly with exploded view
+│   ├── parametric_demo.py   # Live slider-driven parametric model
+│   ├── polyline.py          # Complex 3D swept path demonstrations
+│   └── test.py              # 3D primitives, text, and SDF CSG / Gyroid models
+│
+├── scripts/                 # Modular helper scripts
+│   ├── env.sh / env.bat     # Dynamic virtual environment and path discovery
+│   ├── setup_base.sh/.bat   # Unified 5-step installer backend
+│   ├── check_gl.sh          # Self-testing OpenGL compatibility probe & cache
+│   └── probe_gl.py          # Micro-probe for OpenGL rasterization validation
+│
+├── ci/                      # Continuous Integration
+│   └── action.yml           # GitHub Actions composite action for CAD
+│
+└── tests/                   # Test suite (223 unit & integration tests)
+```
+
+---
+
+## Installation & Setup
+
+Automated setup scripts create an isolated `.venv`, upgrade `pip`, install all requirements, and verify core library imports.
+
+### Runtime Installation (Users)
+- **Linux / macOS / Termux**:
+  ```bash
+  ./setup.sh
+  ```
+- **Windows**:
+  ```cmd
+  setup.bat
+  ```
+
+### Developer Installation (Includes Testing & Coverage Tools)
+- **Linux / macOS / Termux**:
+  ```bash
+  ./setup_dev.sh
+  ```
+- **Windows**:
+  ```cmd
+  setup_dev.bat
+  ```
+
+---
+
+## Quick Start
+
+### 1. Launching the Interactive 3D Viewer
+
+**Viewing scenes in your active project folder or custom path (`view.sh` / `view.bat`):**
+```bash
+# By default, discovers scenes in the current terminal directory:
+./view.sh
+
+# Or specify a target directory, relative or absolute path, or standalone scene file:
+./view.sh path/to/scenes/
+./view.sh path/to/my_scene.py
+# Windows: view.bat [path]
+```
+
+**Running bundled repository example scenes (`run.sh` / `run.bat`):**
+```bash
+./run.sh
+# Windows: run.bat
+```
+
+Load a specific scene:
+```bash
+./run.sh -s scenes/assembly_demo.py
+./run.sh -s scenes/parametric_demo.py
+```
+
+#### Viewport Navigation Controls:
+- **Left Mouse Click / Drag**: Rotate camera around focal point / select objects in pick mode.
+- **Right Mouse Drag**: Pan camera horizontally and vertically.
+- **Mouse Wheel / Scroll**: Zoom in and out.
+- **Toolbar**: Switch between Move, Rotate, Scale, and Measure tools; toggle shaded and wireframe modes; inspect object geometry.
+
+---
+
+### 2. Headless Scene Exporting & Snapshot Generation (`save.py`)
+
+Export a scene directly to binary STL:
+```bash
+./save.sh -s scenes/assembly_demo.py -o output.stl
+```
+
+Export to OBJ, GLB, or PLY format:
+```bash
+./save.sh -s scenes/parametric_demo.py -e model.glb
+```
+
+Generate a high-resolution 4K isometric preview image with anti-aliasing:
+```bash
+./save.sh -s scenes/assembly_demo.py -i preview.png --resolution 3840x2160 --cam-ori iso --supersample 4
+```
+
+Analyze 3D printability and optimize print orientation for a Bambu Lab bed:
+```bash
+./save.sh -s scenes/assembly_demo.py --analyze-print --printer-bed bambu --auto-orient
+```
+
+Merge scene objects using Smooth Boolean Union (SDF Marching Cubes):
+```bash
+./save.sh -s scenes/assembly_demo.py --sdf-merge smooth_union --sdf-k 3.0 -o merged.stl
+```
+
+---
+
+### 3. AI Agent CollabBridge (`bridge.py`)
+
+When `view.py` is running, the viewer hosts an HTTP JSON endpoint on port `8765`. AI agents or terminal users can query and control the application live via `./bridge.sh`:
+
+```bash
+# Check viewer status and active scene
+./bridge.sh status
+
+# List all available scenes
+./bridge.sh scenes
+
+# Load a new scene dynamically
+./bridge.sh scene scenes/assembly_demo.py
+
+# Select an object by name
+./bridge.sh select "BasePlate"
+
+# Translate selected object by [+10mm X, 0mm Y, +5mm Z]
+./bridge.sh translate "10,0,5"
+
+# Adjust exploded view ratio (0.0 = assembled, 1.0 = exploded)
+./bridge.sh explode 0.5
+
+# Request a 3D printability check
+./bridge.sh print-check
+
+# Export current viewer model to disk
+./bridge.sh export "exported_model.stl"
+```
+
+---
+
+### 4. Running Tests & Code Coverage
+
+Execute the complete 222-test suite:
+```bash
+./run_tests.sh
+# Windows: run_tests.bat
+```
+
+- **Enforced Coverage**: [pytest.ini](pytest.ini) requires a minimum of **90% test coverage** across the `core/` package; test runs below this threshold automatically fail.
+- **Coverage Reports**: HTML reports are generated at `cad/htmlcov/index.html` and XML reports at `cad/coverage.xml`.
+
+---
+
+## OpenGL Driver Compatibility & Probing
+
+In certain virtualized, containerized, or headless environments (e.g. Android PRoot, headless CI runners, or systems without GPU drivers), default OpenGL drivers may trigger errors or lack WGL/GLX support.
+
+The toolkit includes an automated driver probe:
+- **Automatic Fallback**: [scripts/check_gl.sh](scripts/check_gl.sh) tests OpenGL rasterization via [scripts/probe_gl.py](scripts/probe_gl.py) and caches the result in `.venv/.gallium_probe`. If default Mesa `llvmpipe` fails, it automatically selects `softpipe`.
+- **Force Re-testing**: Pass `--retest-gl` to any launcher script to re-evaluate the host environment:
+  ```bash
+  ./run.sh --retest-gl
+  ./run_tests.sh --retest-gl
+  # Or via check_gl.sh directly:
+  ./scripts/check_gl.sh --retest
+  ```
+- **Inspect Status**:
+  ```bash
+  ./scripts/check_gl.sh --status
+  ```
+
+---
+
+## Continuous Integration
+
+Cross-platform CI is configured in [`.github/workflows/cad.yml`](../.github/workflows/cad.yml) and executes on every push and pull request to `main`, `dev/**`, and `release/**`:
+- **Matrix**: Ubuntu 24.04 (with Xvfb), Windows Server 2022, and macOS 14/15 on Python 3.12.
+- **Action**: Uses the self-contained composite action in [ci/action.yml](ci/action.yml).
+- **Artifacts**: Uploads HTML coverage reports on all platforms and submits to Codecov.

sanchousf_ai_toolkit-0.2.1/cad/__init__.py

@@ -0,0 +1,136 @@
+"""
+AI-Toolkit CAD Package.
+A modular, high-performance 3D CAD engine for parametric modeling, procedural generation,
+signed distance fields, interactive viewport rendering, and dynamic scene authoring.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.2.1"
+
+# Re-export subpackages
+from . import core
+from . import scene
+
+
+# Base scene authoring & dynamic loader
+from .scene.base import BaseScene, EmptyScene, ErrorScene
+from .scene.loader import (
+    SceneEntry,
+    SceneLoader,
+    load_scene_from_file,
+    discover_scenes,
+    resolve_scene,
+)
+
+# Geometry primitives & entities
+from .core.geometry import (
+    MeshObject,
+    ObjectGroup,
+    ObjectsGroup,
+    CADPart,
+    CADAssembly,
+    OriginMode,
+    CSGOperation,
+    DecimateMethod,
+    SimplifierBackend,
+    STLHelper,
+)
+from .core.primitives import (
+    BoxModel,
+    SphereModel,
+    CylinderModel,
+    CapsuleModel,
+    ConeModel,
+    TorusModel,
+    WedgeModel,
+    RegularPrismModel,
+    PolylineModel,
+    TextModel,
+)
+
+# Parametric modeling & operations
+from .core.modeling import (
+    WorkPlane,
+    Sketch2D,
+    ExtrusionModel,
+    RevolveModel,
+    SweepModel,
+    LoftModel,
+    linear_pattern,
+    circular_pattern,
+    mirror_object,
+    align_objects,
+    FeatureTree,
+    MeshSimplifier,
+    mesh_boolean,
+)
+
+# Procedural SDF & meshing
+from .core.sdf import (
+    SDFModel,
+    SDFGroup,
+    SDFOps,
+    SDFMesher,
+    merge_to_sdf_group,
+)
+
+__all__ = [
+    # Metadata
+    "__version__",
+    # Subpackages
+    "core",
+    "scene",
+    # Scene interfaces & loading
+    "BaseScene",
+    "EmptyScene",
+    "ErrorScene",
+    "SceneEntry",
+    "SceneLoader",
+    "load_scene_from_file",
+    "discover_scenes",
+    "resolve_scene",
+    # Geometry entities & enums
+    "MeshObject",
+    "ObjectGroup",
+    "ObjectsGroup",
+    "CADPart",
+    "CADAssembly",
+    "OriginMode",
+    "CSGOperation",
+    "DecimateMethod",
+    "SimplifierBackend",
+    "STLHelper",
+    # Primitives
+    "BoxModel",
+    "SphereModel",
+    "CylinderModel",
+    "CapsuleModel",
+    "ConeModel",
+    "TorusModel",
+    "WedgeModel",
+    "RegularPrismModel",
+    "PolylineModel",
+    "TextModel",
+    # Modeling & operations
+    "WorkPlane",
+    "Sketch2D",
+    "ExtrusionModel",
+    "RevolveModel",
+    "SweepModel",
+    "LoftModel",
+    "linear_pattern",
+    "circular_pattern",
+    "mirror_object",
+    "align_objects",
+    "FeatureTree",
+    "MeshSimplifier",
+    "mesh_boolean",
+    # SDF
+    "SDFModel",
+    "SDFGroup",
+    "SDFOps",
+    "SDFMesher",
+    "merge_to_sdf_group",
+]
+