path: root/docs/class-diag.puml

@startuml

!include style.ipuml

' !include hide-groups.ipuml
' !include hide-details.ipuml

class main as "main()"
hide main circle
hide main members

exception Exception {
	+ Exception(const char* fmt, ...)
	+ what() : const char*
	--
	# error : char*
	# va_format(va_list args, const char* fmt)
}

together { /' LAYOUT '/
rectangle Group_FileReading as "File reading" <<group>> {
	class FileReader <<Factory>> {
		+open(url) : FileStrategy&
	}
	interface FileStrategy {
		+ read() : string
		+ close()
		--
		# open(string url)
		# clone() : FileStrategy* <<const>>
	}
	class LocalFile {
		- instance : LocalFile <<static>>
	}
	class HTTPFile {
		- instance : HTTPFile <<static>>
	}
	package CPR { }

	FileStrategy <|.. LocalFile
	FileStrategy <|.. HTTPFile

	FileStrategy <. FileReader
	FileStrategy .> FileReader

	HTTPFile -> CPR

	' LAYOUT
	LocalFile -r[hidden] HTTPFile
}
rectangle Group_ParsingDeserialization as "Parsing & deserialization" <<group>> {
	class Parser {
		+ parse(FileStrategy &, Deserializer &) <<static>>
		+ register_strategy(ParserStrategy *) <<static>>
		--
		- get_collection() : ParserCollection <<static>>
	}
	interface ParserStrategy  {
		+ parse(FileStrategy &, Deserializer &) <<static>>
		+ heuristic(FileStrategy &) : unsigned int <<static>>
	}

	ParserStrategy .> Parser
	ParserStrategy <. Parser

	class CSVParser
	class XMLParser
	class TXTParser

	package pugixml { }

	CSVParser ..|> ParserStrategy
	TXTParser ..|> ParserStrategy
	XMLParser ..|> ParserStrategy

	XMLParser -> pugixml

	class Deserializer {
		+ Deserializer(Museum &)
		--
		+ set_canvas(CanvasData)
		+ set_tile(TileData)
		+ add_artist(ArtistData)
		+ add_type(type : string, Color, weight : unsigned int)
	}

	CSVParser -up-> Deserializer
	XMLParser -up-> Deserializer
	TXTParser -up-> Deserializer

	' LAYOUT
	CSVParser -r[hidden] TXTParser
	TXTParser -r[hidden] XMLParser
}
} /' LAYOUT '/

together { /' LAYOUT '/
rectangle Group_Model as "Model" <<group>> {
	class Museum {
		+ people : People
		+ canvas : Canvas
		--
		+ update()
		--
		- paused : bool <<+get>> <<+set>>
		- jump : unsigned long
		--
		- working : bool
		- worker : thread *
		- work()
	}
	class Canvas {
		+ Canvas(Museum &)
		--
		+ get_tile(x, y) : Tile &
		+ set_tile(TileData)
		--
		+ update()
		+ data : CanvasData
		+ set_data(CanvasData)
		--
		- tiles : vector<Tile *>
		- museum : Museum &
	}
	class People {
		+ People(Museum &)
		--
		+ add_artist(ArtistData)
		+ remove_artist(Artist &)
		+ get_artists() : forward_list<Artist *>
		--
		- artists : forward_list<Artist *>
		- artist_count : size_t
		- museum : Museum &
		--
		- deleted_artists : forward_list<Artist *>
		- cleanup()
	}
	class Tile {
		+ data : TileData
		+ color : Color
		+ behavior : uniq<TileBehaviorStrategy>
		+ set_data(TileData &)
		+ set_type(type : const string &)
		+ update()
		+ step(Artist *)
		+ get_neighbor(dx, dy) : Tile *
		--
		- museum : Museum &
	}
	struct TileData {
		+ x : unsigned int
		+ y : unsigned int
		+ type : string
	}
	class Artist {
		+ update()
		+ step : bool
		+ color : Color
		+ data : ArtistData
		--
		- data : ArtistData
		- museum : Museum &
	}
	struct ArtistData {
		+ x : float
		+ y : float
		+ vx : float
		+ vy : float
	}
	struct CanvasData {
		+ rows : unsigned int
		+ columns : unsigned int
	}

	Museum --> People
	Museum --> Canvas

	Canvas --> Tile
	People --> Artist

	Tile   -> TileData
	Artist -l> ArtistData
	Canvas -> CanvasData

	' LAYOUT
	Artist -r[hidden] Tile
}
rectangle Group_TileAppearance as "Tile appearance" <<group>> {
	struct Color {
		red : unsigned int
		green : unsigned int
		blue : unsigned int
	}
	class TileAppearance {
		+ get_color(string) : Color <<static>>
		+ register_color(string, Color) <<static>>
	}

	Tile --> Color

	Color <.. TileAppearance
}
rectangle Group_TileBehavior as "Tile behavior" <<group>> {
	interface TileBehaviorStrategy {
		+ step(Artist *)
		+ update(Tile &)
		+ clone(Museum &) : uniq<TileBehaviorStrategy>
		--
		# TileBehaviorStrategy(type : string)
		# TileBehaviorStrategy()
		--
		# interactions : unsigned int
		# museum : Museum *
	}

	class TileBehavior {
		+ get_strategy(string) : TileBehaviorStrategy & <<static>>
		+ register_strategy(string, TileBehaviorStrategy *) <<static>>
		--
		- get_collection() : TileBehaviorCollection & <<static>>
	}

	together {
		class NullTileBehavior {
			- type = "" <<static constexpr>>
		}
		class GrayTileBehavior {
			- type = "G" : <<static constexpr>>
		}
		class RedTileBehavior {
			- type = "R" : <<static constexpr>>
		}
		class BlueTileBehavior {
			- type = "B" : <<static constexpr>>
			--
			- dx : int
			- dy : int
		}
		class YellowTileBehavior {
			- type = "Y" : <<static constexpr>>
			--
			- last_interactions : unsigned int
		}

		' LAYOUT
		TileBehavior -d[hidden]- NullTileBehavior
		NullTileBehavior -d[hidden]- GrayTileBehavior
		GrayTileBehavior -d[hidden]- RedTileBehavior
		RedTileBehavior -d[hidden]- BlueTileBehavior
		BlueTileBehavior -d[hidden]- YellowTileBehavior
	}

	TileBehaviorStrategy <|.[norank]. NullTileBehavior
	TileBehaviorStrategy <|.[norank]. GrayTileBehavior
	TileBehaviorStrategy <|.[norank]. RedTileBehavior
	TileBehaviorStrategy <|.[norank]. BlueTileBehavior
	TileBehaviorStrategy <|.[norank]. YellowTileBehavior

	Tile --> "state" TileBehavior

	TileBehavior .l> TileBehaviorStrategy
	TileBehavior <. TileBehaviorStrategy
}
} /' LAYOUT '/

together { /' LAYOUT '/
rectangle Group_Commands as "Commands" <<group>> {
	class Command {
		# museum : Museum&
		# view : View&
		# controller : ViewController&
		--
		+ Command(command : const Command *)
		+ Command(museum, view, controller)
	}

	class MuseumPauseCommand {
		+ toggle()
		+ set(paused : bool)
	}
	class OpenFileGUICommand {
		+ execute()
	}
	class ArtistVisibilityCommand {
		+ toggle()
		+ set(paused : bool)
	}
	class LoadFilesCommand {
		+ execute(files)
	}
	class TileDecayCommand {
		+ execute(x, y)
	}

	Command <|-u- MuseumPauseCommand
	Command <|-u- OpenFileGUICommand
	Command <|-u- ArtistVisibilityCommand
	Command <|-u- TileDecayCommand
	Command <|-d- LoadFilesCommand
}
rectangle Group_Visualization as "Visualization" <<group>> {
	struct Rectangle {
		x : unsigned int
		y : unsigned int
		width : unsigned int
		height : unsigned int
	}
	enum MouseCode { }
	enum KeyboardCode { }
	package SDL3 { }

	class View {
		+ window_size(width, height)
		+ dialog_file(callback : fn(files : vec<string>, data), data)
		+ draw_rect(Rectangle, Color)
		--
		- window : SDL_Window *
		- renderer : SDL_Renderer *
		--
		+ open : bool
		- worker : thread *
		- work()
	}
	class ViewController {
		+ update()
		+ ev_keydown(KeyboardCode);
		+ ev_mousedown(MouseCode);
		+ ev_mousemove(x, y);
		--
		- draw_artists : bool <<+get>> <<+set>>
		- cmd_base : const Command *
	}

	ViewController ..> View
	ViewController <-- View
	View --> SDL3

	View .> Rectangle
	ViewController .> KeyboardCode
	ViewController .> MouseCode
}
} /' LAYOUT '/

Command .[norank]> Museum
Command .[norank]> View
Command .[norank]> ViewController

ParserStrategy ..> FileStrategy
Deserializer .> Museum

ViewController -[norank]> Command

main -d-> Museum
main -u-> LoadFilesCommand
main -[norank]> Deserializer
main -[norank]> View
main .l> Exception

' LAYOUT
Group_TileBehavior -r[hidden] Group_TileAppearance
Group_Model -r[hidden] Group_ParsingDeserialization
Group_Commands -r[hidden] Group_Visualization

@enduml