DefaultVariableResolver class final

Default implementation of TemplateVariableResolver, providing variable resolution from a flat or nested map of values.

DefaultVariableResolver supports:

• Resolving simple variables: 'name'
• Resolving nested variables using dot notation: 'user.address.city'
• Converting values to string representations for template rendering.

Design Notes

• Nested variables are resolved recursively through Map<String, Object?>.
• Supports standard types: String, bool, List, Map, and general objects.
• Returns empty string '' for null values to avoid template errors.

Usage Example

final resolver = DefaultVariableResolver({
  'name': 'Alice',
  'user': {
    'address': {'city': 'Paris', 'zip': 75000}
  },
  'tags': ['dart', 'flutter']
});

print(resolver.resolve('name')); // 'Alice'
print(resolver.resolve('user.address.city')); // 'Paris'
print(resolver.resolve('tags')); // 'dart, flutter'
print(resolver.resolve('unknown')); // ''