File size: 1,479 Bytes
e547dfd | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 | /*
* Sovereign IDE — Code Reference Parser (@-syntax)
* Phase 2: Agent output -> editor navigation
*/
#ifndef SOVEREIGN_CODE_REF_PARSER_H
#define SOVEREIGN_CODE_REF_PARSER_H
#include <stddef.h>
#include <stdbool.h>
#include <stdint.h>
#define CODE_REF_MAX_PATH 512
/* Parsed @-syntax reference */
typedef struct {
bool valid;
char path[CODE_REF_MAX_PATH]; /* relative path (normalized, forward slashes) */
size_t line_start; /* 1-indexed, 0 = no line specified */
size_t line_end; /* 1-indexed, same as start if single line */
bool has_range; /* true if #L was present */
size_t source_offset; /* offset of '@' in source text */
size_t source_length; /* total consumed characters */
} CodeRef;
/*
* Parse a single @-reference at the given offset.
* Returns a CodeRef (check .valid). Sets *consumed to chars eaten.
*/
CodeRef code_ref_parse_single(const char *text, size_t start_offset, size_t *consumed);
/*
* Scan text for all @-references. Returns count found.
* Fills out_refs up to max_refs entries.
*/
size_t code_ref_scan(const char *text, size_t text_len, CodeRef *out_refs, size_t max_refs);
/*
* Resolve a CodeRef path against workspace root.
* Writes full path to out_path. Returns false on error.
*/
bool code_ref_resolve(const CodeRef *ref, const char *workspace_root, char *out_path, size_t out_max);
#endif /* SOVEREIGN_CODE_REF_PARSER_H */
|