Parser class abstract

A base interface for all configuration parsers in Jetleaf.

Parsers are responsible for converting raw configuration sources (strings, assets, or files) into a normalized Map<String, dynamic> representation.
This abstraction allows Jetleaf to support multiple configuration formats (JSON, YAML, XML, properties files, etc.) while providing a unified API for accessing configuration values.

Core responsibilities:

• Parse raw string sources with parse.
• Parse from Assets with parseAsset.
• Parse into generic objects with parseAs.
• Optionally parse directly from files with parseFile.

Example implementation (JSON parser):

class JsonParser extends Parser {
  @override
  Map<String, dynamic> parse(String source) {
    return jsonDecode(source) as Map<String, dynamic>;
  }

  @override
  Map<String, dynamic> parseFile(String path) {
    final fileContent = File(path).readAsStringSync();
    return parse(fileContent);
  }
}

void main() {
  final parser = JsonParser();

  final config = parser.parse('{"host": "localhost", "port": 8080}');
  print(config['host']); // Output: localhost
}