Namespaces
namespace	anonymous_namespace{asm_patch.cc}

namespace	anonymous_namespace{hack_manifest.cc}

namespace	anonymous_namespace{oracle_menu_registry.cc}

namespace	anonymous_namespace{story_event_graph.cc}

namespace	anonymous_namespace{story_event_graph_query.cc}

namespace	anonymous_namespace{widget_state_capture.cc}

namespace	RomAddressKey

Classes
struct	AsarPatchResult
	Asar patch result information. More...

struct	AsarSymbol
	Symbol information extracted from Asar assembly. More...

class	AsarWrapper
	Modern C++ wrapper for Asar 65816 assembler integration. More...

class	AsmPatch
	Represents a ZScream-compatible ASM patch file. More...

struct	BuildPipeline
	Build pipeline information. More...

struct	DungeonConnection
	A connection between two rooms (stair, holewarp, or door). More...

struct	DungeonEntry
	A complete dungeon entry with rooms and connections. More...

struct	DungeonRoom
	A room within a dungeon, with spatial and metadata info. More...

struct	FeatureFlag
	A compile-time feature flag. More...

class	FeatureFlags
	A class to manage experimental feature flags. More...

class	HackManifest
	Loads and queries the hack manifest JSON for yaze-ASM integration. More...

struct	MessageLayout
	Message range information for the expanded message system. More...

struct	OracleMenuBinEntry

struct	OracleMenuComponent

struct	OracleMenuComponentEditResult

struct	OracleMenuDrawRoutine

struct	OracleMenuRegistry

struct	OracleMenuValidationIssue

struct	OracleMenuValidationReport

struct	OracleProgressionState
	Oracle of Secrets game progression state parsed from SRAM. More...

struct	OverworldArea
	An overworld area from the overworld registry. More...

struct	OwnedBank
	An expanded bank with ownership classification. More...

class	PatchManager
	Manages a collection of ZScream-compatible ASM patches. More...

struct	PatchParameter
	Represents a configurable parameter within an ASM patch. More...

struct	ProjectRegistry
	Project-level registry data loaded from the Oracle planning outputs. More...

struct	ProtectedRegion
	A contiguous protected ROM region owned by the ASM hack. More...

struct	RomAddressOverrides

class	RomSettings

struct	RoomTagEntry
	A room tag entry from the dispatch table. More...

struct	SnapshotResult

struct	SramVariable
	A custom SRAM variable definition. More...

struct	StoryEdge
	A directed edge in the story event graph. More...

class	StoryEventGraph
	The complete Oracle narrative progression graph. More...

struct	StoryEventNode
	A node in the Oracle story event graph. More...

struct	StoryEventNodeFilter
	Filter options for StoryEventGraph node search in UI. More...

struct	StoryFlag
	A flag set or cleared by a story event. More...

struct	StoryLocation
	A location associated with a story event. More...

struct	StoryPredicate
	A predicate for determining event completion from SRAM state. More...

class	VersionManager
	Manages project versioning (Git) and ROM artifact snapshots. More...

struct	WidgetState

struct	Window

struct	WriteConflict
	A conflict detected when yaze wants to write to an ASM-owned address. More...

Typedefs
using	json = nlohmann::json

Enumerations
enum class	AddressOwnership : uint8_t { kVanillaSafe , kHookPatched , kAsmOwned , kShared , kAsmExpansion , kRam , kMirror }
	Ownership classification for ROM addresses and banks. More...

enum class	OracleMenuValidationSeverity { kError , kWarning }

enum class	PatchParameterType { kByte , kWord , kLong , kBool , kChoice , kBitfield , kItem }
	Parameter types supported by ZScream-compatible ASM patches. More...

enum class	StoryNodeStatus : uint8_t { kLocked , kAvailable , kCompleted , kBlocked }
	Completion status of a story event node for rendering. More...

Functions
std::string	CaptureWidgetState ()

std::string	SerializeWidgetStateToJson (const WidgetState &state)

absl::Status	CreateWindow (Window &window, gfx::IRenderer *renderer, int flags)

absl::Status	ShutdownWindow (Window &window)

absl::Status	HandleEvents (Window &window)

std::string	AddressOwnershipToString (AddressOwnership ownership)

absl::StatusOr< std::filesystem::path >	ResolveOracleProjectRoot (const std::filesystem::path &start_path)

absl::StatusOr< OracleMenuRegistry >	BuildOracleMenuRegistry (const std::filesystem::path &project_root)

OracleMenuValidationReport	ValidateOracleMenuRegistry (const OracleMenuRegistry &registry, int max_row, int max_col)

absl::StatusOr< OracleMenuComponentEditResult >	SetOracleMenuComponentOffset (const std::filesystem::path &project_root, const std::string &asm_relative_path, const std::string &table_label, int index, int row, int col, bool write_changes)

absl::StatusOr< OracleProgressionState >	LoadOracleProgressionFromSrmFile (const std::string &srm_path)

bool	StoryNodeStatusAllowed (StoryNodeStatus status, const StoryEventNodeFilter &filter)

std::string	BuildStoryEventNodeSearchText (const StoryEventNode &node)

bool	StoryEventNodeMatchesQuery (const StoryEventNode &node, std::string_view query)

bool	StoryEventNodeMatchesFilter (const StoryEventNode &node, const StoryEventNodeFilter &filter)

Variables
bool	g_window_is_resizing = false

Typedef Documentation

◆ json

using yaze::core::json = nlohmann::json

Definition at line 18 of file story_event_graph.cc.

Enumeration Type Documentation

◆ AddressOwnership

enum class yaze::core::AddressOwnership : uint8_t

strong

Ownership classification for ROM addresses and banks.

The hack manifest distinguishes between addresses that:

yaze can freely edit (vanilla data in the dev ROM)
asar patches on every build (hook addresses — yaze edits are lost)
asar fully owns (expanded banks — don't exist in dev ROM)
both yaze and asar write (shared banks like ZSCustomOverworld)

Enumerator
kVanillaSafe
kHookPatched
kAsmOwned
kShared
kAsmExpansion
kRam
kMirror

Definition at line 26 of file hack_manifest.h.

◆ OracleMenuValidationSeverity

enum class yaze::core::OracleMenuValidationSeverity

strong

Enumerator
kError
kWarning

Definition at line 49 of file oracle_menu_registry.h.

◆ PatchParameterType

enum class yaze::core::PatchParameterType

strong

Parameter types supported by ZScream-compatible ASM patches.

These correspond to the ;#type= metadata in patch files.

Enumerator
kByte
kWord
kLong
kBool
kChoice
kBitfield
kItem

Definition at line 16 of file asm_patch.h.

◆ StoryNodeStatus

enum class yaze::core::StoryNodeStatus : uint8_t

strong

Completion status of a story event node for rendering.

Enumerator
kLocked
kAvailable
kCompleted
kBlocked

Definition at line 67 of file story_event_graph.h.

Function Documentation

◆ CaptureWidgetState()

std::string yaze::core::CaptureWidgetState ( )

Definition at line 91 of file widget_state_capture.cc.

Here is the call graph for this function:

◆ SerializeWidgetStateToJson()

std::string yaze::core::SerializeWidgetStateToJson ( const WidgetState & state )

Definition at line 167 of file widget_state_capture.cc.

Referenced by CaptureWidgetState().

◆ CreateWindow()

absl::Status yaze::core::CreateWindow	(	Window &	window,
		gfx::IRenderer *	renderer,
		int	flags )

Definition at line 70 of file window.cc.

References yaze::core::Window::audio_buffer_, yaze::core::Window::audio_device_, yaze::gui::ColorsYaze(), yaze::test::TestManager::Get(), yaze::gfx::IRenderer::GetBackendRenderer(), yaze::util::PlatformPaths::GetImGuiIniPath(), yaze::gfx::IRenderer::Initialize(), yaze::test::TestManager::InitializeUITesting(), yaze::LoadPackageFonts(), LOG_INFO, LOG_WARN, RETURN_IF_ERROR, and yaze::core::Window::window_.

◆ ShutdownWindow()

absl::Status yaze::core::ShutdownWindow ( Window & window )

Todo: BAD FIX, SLOW SHUTDOWN TAKES TOO LONG NOW

Definition at line 175 of file window.cc.

References yaze::core::Window::audio_device_, yaze::test::TestManager::DestroyUITestingContext(), yaze::gfx::Arena::Get(), yaze::test::TestManager::Get(), LOG_INFO, yaze::gfx::Arena::Shutdown(), yaze::test::TestManager::StopUITesting(), and yaze::core::Window::window_.

◆ HandleEvents()

absl::Status yaze::core::HandleEvents ( Window & window )

Definition at line 220 of file window.cc.

References yaze::core::Window::active_, and g_window_is_resizing.

◆ AddressOwnershipToString()

std::string yaze::core::AddressOwnershipToString ( AddressOwnership ownership )

Definition at line 20 of file hack_manifest.cc.

References kAsmExpansion, kAsmOwned, kHookPatched, kMirror, kRam, kShared, and kVanillaSafe.

Referenced by yaze::editor::PopupManager::DrawWriteConflictWarningPopup(), yaze::editor::OverworldEditor::Save(), and yaze::editor::DungeonEditorV2::SaveRoomData().

◆ ResolveOracleProjectRoot()

absl::StatusOr< std::filesystem::path > yaze::core::ResolveOracleProjectRoot ( const std::filesystem::path & start_path )

Definition at line 252 of file oracle_menu_registry.cc.

Referenced by BuildOracleMenuRegistry(), yaze::cli::handlers::OracleMenuIndexCommandHandler::Execute(), yaze::cli::handlers::OracleMenuSetOffsetCommandHandler::Execute(), yaze::cli::handlers::OracleMenuValidateCommandHandler::Execute(), and SetOracleMenuComponentOffset().

◆ BuildOracleMenuRegistry()

absl::StatusOr< OracleMenuRegistry > yaze::core::BuildOracleMenuRegistry ( const std::filesystem::path & project_root )

Definition at line 294 of file oracle_menu_registry.cc.

References yaze::core::OracleMenuRegistry::asm_files, ASSIGN_OR_RETURN, yaze::core::OracleMenuRegistry::bins, yaze::core::OracleMenuRegistry::components, yaze::core::OracleMenuRegistry::draw_routines, yaze::core::OracleMenuRegistry::project_root, ResolveOracleProjectRoot(), and yaze::core::OracleMenuRegistry::warnings.

Referenced by yaze::cli::handlers::OracleMenuIndexCommandHandler::Execute(), yaze::cli::handlers::OracleMenuValidateCommandHandler::Execute(), and yaze::editor::OracleMenuInspectorPanel::RefreshRegistry().

Here is the call graph for this function:

◆ ValidateOracleMenuRegistry()

OracleMenuValidationReport yaze::core::ValidateOracleMenuRegistry	(	const OracleMenuRegistry &	registry,
		int	max_row,
		int	max_col )

Definition at line 479 of file oracle_menu_registry.cc.

References yaze::core::OracleMenuRegistry::asm_files, yaze::core::OracleMenuRegistry::bins, yaze::core::OracleMenuRegistry::components, ValidateOracleMenuRegistry(), and yaze::core::OracleMenuRegistry::warnings.

Referenced by yaze::cli::handlers::OracleMenuValidateCommandHandler::Execute(), and ValidateOracleMenuRegistry().

Here is the call graph for this function:

◆ SetOracleMenuComponentOffset()

absl::StatusOr< OracleMenuComponentEditResult > yaze::core::SetOracleMenuComponentOffset	(	const std::filesystem::path &	project_root,
		const std::string &	asm_relative_path,
		const std::string &	table_label,
		int	index,
		int	row,
		int	col,
		bool	write_changes )