# ludalunizz/generative-design-plugin-for-solidcraft architecture

> Architecture diagram of the GitHub repository ludalunizz/generative-design-plugin-for-solidcraft, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ludalunizz/generative-design-plugin-for-solidcraft
- Repository: https://github.com/ludalunizz/generative-design-plugin-for-solidcraft

## Overview

This repository is a SolidCraft command plugin for material cards and reports, flat-part stress checks, and plate optimisation, alongside four standalone engineering CLI tools. The plugin workflow starts when a SolidCraft user or script invokes an entry; the engine uses the host API to inspect or modify the design and returns a report or generated geometry. The graph also preserves the documented solver and outline stages, plus the separate 3D stress and beam tools. Evidence is limited to README statements and the provided source excerpts/index; unsampled CLI internals are not assumed.

Main entry points: [`src/engine.rs`](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/engine.rs) (Plugin entries), [`src/topo2d.rs`](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/topo2d.rs) (2D topology solver), [`src/beam.rs`](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/beam.rs) (Beam design), [`src/stress3d.rs`](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/stress3d.rs) (Voxel stress solver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["SolidCraft Plugin"]
  node_component["WIT component adapter<br/>[component.rs]"]
  node_engine["Plugin entries<br/>[engine.rs]"]
end

subgraph group_materials["Materials"]
  node_library[("Material library<br/>[library.rs]")]
  node_material_data["Material data<br/>[library.json]"]
  node_material_ops["Material assignment<br/>[engine.rs]"]
  node_material_report["Material report<br/>[engine.rs]"]
end

subgraph group_analysis["Analysis"]
  node_stress2d["Flat-part stress<br/>[stress2d.rs]"]
  node_stress3d["Voxel stress solver<br/>[stress3d.rs]"]
  node_mg2d["2D multigrid<br/>[mg2d.rs]"]
  node_mg3d["3D multigrid<br/>[mg3d.rs]"]
end

subgraph group_optimisation["Optimisation"]
  node_topo2d["2D topology solver<br/>[topo2d.rs]"]
  node_outline["Outline generation<br/>[outline.rs]"]
  node_beam["Beam design<br/>[beam.rs]"]
  node_gpu["GPU solver<br/>[gpu.rs]"]
end

subgraph group_cli["Standalone Tools"]
  node_beam_cli["Beam optimiser CLI<br/>[beam_opt.rs]"]
  node_refine_cli["Plate refine CLI<br/>[plate_refine.rs]"]
  node_stress3d_cli["3D stress CLI<br/>[stress3d.rs]"]
  node_printed_cli["Printed-part stress CLI"]
end

node_user(("User or script"))
node_solidcraft["SolidCraft host"]

node_user -->|"invokes plugin"| node_solidcraft
node_solidcraft -->|"dispatches entry"| node_component
node_component -->|"delegates to"| node_engine
node_engine -->|"loads materials"| node_library
node_library -->|"reads data"| node_material_data
node_engine -->|"runs assignment"| node_material_ops
node_engine -->|"builds report"| node_material_report
node_engine -->|"calls analysis"| node_stress2d
node_stress2d -->|"solves with"| node_mg2d
node_engine -->|"calls optimiser"| node_topo2d
node_engine -->|"requests outlines"| node_outline
node_topo2d -->|"uses solver"| node_mg2d
node_topo2d -.->|"supports optional solver"| node_gpu
node_user -->|"runs tool"| node_beam_cli
node_user -->|"runs tool"| node_refine_cli
node_user -->|"runs tool"| node_stress3d_cli
node_user -->|"runs tool"| node_printed_cli
node_beam_cli -.->|"uses design module"| node_beam
node_stress3d_cli -.->|"uses solver"| node_stress3d
node_printed_cli -.->|"uses solver"| node_stress3d
node_stress3d -->|"solves with"| node_mg3d
node_beam -->|"optimises with"| node_topo2d
node_beam -->|"uses solver"| node_mg2d

click node_component "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/component.rs"
click node_engine "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/engine.rs"
click node_library "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/library.rs"
click node_material_data "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/materials/library.json"
click node_material_ops "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/engine.rs"
click node_material_report "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/engine.rs"
click node_stress2d "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/stress2d.rs"
click node_stress3d "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/stress3d.rs"
click node_mg2d "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/mg2d.rs"
click node_mg3d "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/mg3d.rs"
click node_topo2d "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/topo2d.rs"
click node_outline "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/outline.rs"
click node_beam "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/beam.rs"
click node_gpu "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/gpu.rs"
click node_beam_cli "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/bin/beam_opt.rs"
click node_refine_cli "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/bin/plate_refine.rs"
click node_stress3d_cli "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/bin/stress3d.rs"
click node_printed_cli "https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/bin/stress3d_printed.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_component,node_engine,node_user toneBlue
class node_library,node_material_data,node_material_ops,node_material_report toneAmber
class node_stress2d,node_stress3d,node_mg2d,node_mg3d toneMint
class node_topo2d,node_outline,node_beam,node_gpu toneRose
class node_beam_cli,node_refine_cli,node_stress3d_cli,node_printed_cli,node_solidcraft toneIndigo
```

## Components

### SolidCraft Plugin

- [WIT component adapter](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/component.rs): `src/component.rs`
- [Plugin entries](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/engine.rs): `src/engine.rs`

### Materials

- [Material library](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/library.rs): `src/library.rs`
- [Material data](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/materials/library.json): `materials/library.json`
- [Material assignment](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/engine.rs): `src/engine.rs`
- [Material report](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/engine.rs): `src/engine.rs`

### Analysis

- [Flat-part stress](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/stress2d.rs): `src/stress2d.rs`
- [Voxel stress solver](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/stress3d.rs): `src/stress3d.rs`
- [2D multigrid](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/mg2d.rs): `src/mg2d.rs`
- [3D multigrid](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/mg3d.rs): `src/mg3d.rs`

### Optimisation

- [2D topology solver](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/topo2d.rs): `src/topo2d.rs`
- [Outline generation](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/outline.rs): `src/outline.rs`
- [Beam design](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/beam.rs): `src/beam.rs`
- [GPU solver](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/gpu.rs): `src/gpu.rs`

### Standalone Tools

- [Beam optimiser CLI](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/bin/beam_opt.rs): `src/bin/beam_opt.rs`
- [Plate refine CLI](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/bin/plate_refine.rs): `src/bin/plate_refine.rs`
- [3D stress CLI](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/bin/stress3d.rs): `src/bin/stress3d.rs`
- [Printed-part stress CLI](https://github.com/ludalunizz/generative-design-plugin-for-solidcraft/blob/main/src/bin/stress3d_printed.rs): `src/bin/stress3d_printed.rs`

### Other components

- **User or script**
- **SolidCraft host**

## Connections

- User or script → SolidCraft host: invokes plugin (evidence: `README.md`)
- SolidCraft host → WIT component adapter: dispatches entry (evidence: `README.md`)
- WIT component adapter → Plugin entries: delegates to (evidence: `src/component.rs`)
- Plugin entries → Material library: loads materials (evidence: `src/engine.rs`)
- Material library → Material data: reads data (evidence: `src/library.rs`)
- Plugin entries → Material assignment: runs assignment (evidence: `src/engine.rs`)
- Plugin entries → Material report: builds report (evidence: `README.md`)
- Plugin entries → Flat-part stress: calls analysis (evidence: `src/engine.rs`)
- Flat-part stress → 2D multigrid: solves with (evidence: `src/stress2d.rs`)
- Plugin entries → 2D topology solver: calls optimiser (evidence: `src/engine.rs`)
- Plugin entries → Outline generation: requests outlines (evidence: `src/engine.rs`)
- 2D topology solver → 2D multigrid: uses solver (evidence: `src/topo2d.rs`)
- 2D topology solver → GPU solver: supports optional solver (evidence: `src/topo2d.rs`)
- User or script → Beam optimiser CLI: runs tool (evidence: `README.md`)
- User or script → Plate refine CLI: runs tool (evidence: `README.md`)
- User or script → 3D stress CLI: runs tool (evidence: `README.md`)
- User or script → Printed-part stress CLI: runs tool (evidence: `README.md`)
- Beam optimiser CLI → Beam design: uses design module
- 3D stress CLI → Voxel stress solver: uses solver
- Printed-part stress CLI → Voxel stress solver: uses solver
- Voxel stress solver → 3D multigrid: solves with (evidence: `src/stress3d.rs`)
- Beam design → 2D topology solver: optimises with (evidence: `src/beam.rs`)
- Beam design → 2D multigrid: uses solver (evidence: `src/beam.rs`)
