// Commander X16 Emulator — source file discovery + caching for the debugger's

// native "Source" window. Locates the real .s/.c files referenced (by name only)

// in cc65 .dbg info and caches their contents split into lines.

#ifndef _SOURCE_VIEW_H_

#define _SOURCE_VIEW_H_

#include <stdbool.h>

#ifdef __cplusplus

extern "C" {

#endif

// A loaded source file, split into individual lines.

typedef struct {

	char  *name;      // the file name as referenced by the .dbg (key)

	char  *text;      // owned backing buffer (lines point into this)

	char **lines;     // array of 'count' pointers into 'text'

	int    count;     // number of lines

	bool   found;     // false = file could not be located on disk

} source_file_t;

// Register a directory to search for source files. Duplicates are ignored;

// most-recently-added roots are searched first. Safe to pass NULL/empty.

void source_view_add_path(const char *dir);

// Look up (and cache) a source file by the name stored in the .dbg. Resolution

// order: the name as-is, then each registered search root (most recent first),

// then the current working directory. Returns a cached entry (never freed by the

// caller). The returned entry is always non-NULL while a lookup slot is available;

// check ->found to know whether the file was actually located.

const source_file_t *source_view_get(const char *name);

// Drop all cached file contents (call when loaded modules change, so overlays

// re-read fresh). Registered search paths are kept.

void source_view_invalidate(void);

// Free everything (cached files and registered paths). Call on shutdown.

void source_view_free(void);

#ifdef __cplusplus

}

#endif

#endif