adding-mod-parsers

To parse game mod strings into typed objects, use template-based parsing patterns to convert raw mod strings like "+10% all stats" into typed Mod objects. This ensures type safety and drives a reliable parsing pipeline for your calculation engine.

To add support for a new game mod pattern, update the parser templates in templates.ts, add type definitions in mod.ts, map values in enums.ts, implement calculation handlers in offense.ts, and verify the implementation with tests in mod-parser.test.ts.

Template-based parsing for game mods is a mechanism where predefined templates guide the pattern matching for raw mod strings. This approach converts strings into typed Mod objects that the calculation engine can safely and consistently process.

To ensure type safety when extending mod parsers, convert raw mod strings into typed Mod objects using defined templates and enum mappings. This typed pipeline guarantees that the calculation engine receives consistent and validated data structures.

To add a new mod type, you need to update five key files: src/tli/mod.ts for type definitions, src/tli/mod-parser/templates.ts for patterns, src/tli/mod-parser/enums.ts for mappings, src/tli/calcs/offense.ts for calculations, and src/tli/mod-parser.test.ts for tests.

To test a newly added mod parser pattern, run the existing tests located in src/tli/mod-parser.test.ts after updating your templates, type definitions, enums, and calculation handlers. This verifies that the new pattern integrates correctly with the parsing pipeline.