SMGLocalization.SourceGenerator 1.0.1

SMG.Localization.Generator

A powerful source generator for strongly-typed localization in .NET applications. Supports nested JSON structures, dependency injection, and real-time language switching with events.

Features

• Strongly-typed localization with IntelliSense support
• Nested JSON structure support (Common.App.Name)
• Dependency Injection integration
• Language change events for real-time UI updates
• Blazor and MAUI support
• Fallback language support
• Zero runtime overhead - all generated at compile time

Installation

<PackageReference Include="SMGLocalization.SourceGenerator" Version="1.0.0">
    <PrivateAssets>all</PrivateAssets>
    <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
</PackageReference>

Quick Start

1. Create JSON files in i18n folder

i18n/Common.en.json:

{
  "App": {
    "Name": "Smart Lighting",
    "Version": "1.0"
  },
  "Buttons": {
    "Save": "Save",
    "Cancel": "Cancel"
  }
}

i18n/Common.tr.json:

{
  "App": {
    "Name": "Akıllı Aydınlatma",
    "Version": "1.0"
  },
  "Buttons": {
    "Save": "Kaydet",
    "Cancel": "İptal"
  }
}

2. Register services

using SMG.Localization.Generated;

builder.Services.AddLocalization(options =>
{
    options.DefaultLanguage = "en";
    options.FallbackLanguage = "en";
});

3. Use in your code

Dependency Injection:

@inject ILocalizationService Localization

<h3>@Localization.Current.Common.App.Name</h3>
<button @onclick="() => Localization.SetLanguage("tr")">Türkçe</button>

Static usage:

LocalizationManager.SetLanguage("tr");
Console.WriteLine(LocalizationManager.Current.Common.App.Name);

Language Change Events

@implements IDisposable

protected override void OnInitialized()
{
    Localization.LanguageChanged += OnLanguageChanged;
}

private void OnLanguageChanged(object sender, LanguageChangedEventArgs e)
{
    InvokeAsync(StateHasChanged); // Update UI
}

public void Dispose()
{
    Localization.LanguageChanged -= OnLanguageChanged;
}

MAUI Specific Setup

For MAUI projects, add this to prevent bundle errors:

 <ItemGroup>
    <Content Remove="i18n\**\*.json" />
    <AdditionalFiles Include="i18n\**\*.json" CopyToOutputDirectory="Always"/>
</ItemGroup>

Requirements

• .NET Standard 2.0+
• Microsoft.Extensions.DependencyInjection
• Microsoft.Extensions.Options

JSON File Naming

Use this pattern: {Scope}.{Language}.json

• Common.en.json → Common class
• Home.tr.json → Home class
• Admin.fr.json → Admin class

Generated Code Structure

// Generated classes
public static class Common
{
    public static class App
    {
        public static string Name { get; }
        public static string Version { get; }
    }
    
    public static class Buttons
    {
        public static string Save { get; }
        public static string Cancel { get; }
    }
}

// DI Service
public interface ILocalizationService
{
    string CurrentLanguage { get; }
    void SetLanguage(string language);
    Localization Current { get; }
    event EventHandler<LanguageChangedEventArgs> LanguageChanged;
}

License

MIT License