romance-core 0.2.5

Core library for Romance CLI code generation
Documentation 
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

use crate::addon::Addon;
use anyhow::Result;
use std::path::Path;

pub struct I18nAddon;

impl Addon for I18nAddon {
    fn name(&self) -> &str {
        "i18n"
    }

    fn check_prerequisites(&self, project_root: &Path) -> Result<()> {
        super::check_romance_project(project_root)
    }

    fn is_already_installed(&self, project_root: &Path) -> bool {
        project_root.join("backend/src/i18n.rs").exists()
    }

    fn install(&self, project_root: &Path) -> Result<()> {
        install_i18n(project_root)
    }

    fn uninstall(&self, project_root: &Path) -> Result<()> {
        use colored::Colorize;

        println!("{}", "Uninstalling i18n (internationalization)...".bold());

        // Delete files
        if super::remove_file_if_exists(&project_root.join("backend/src/i18n.rs"))? {
            println!("  {} backend/src/i18n.rs", "delete".red());
        }
        if super::remove_file_if_exists(&project_root.join("frontend/src/lib/i18n.ts"))? {
            println!("  {} frontend/src/lib/i18n.ts", "delete".red());
        }

        // Delete locales directory
        let locales_dir = project_root.join("backend/locales");
        if locales_dir.exists() {
            std::fs::remove_dir_all(&locales_dir)?;
            println!("  {} backend/locales/", "delete".red());
        }

        // Remove mod declaration from main.rs
        super::remove_mod_from_main(project_root, "i18n")?;

        // Remove locale_middleware from routes/mod.rs
        super::remove_line_from_file(
            &project_root.join("backend/src/routes/mod.rs"),
            "locale_middleware",
        )?;

        // Remove feature flag
        super::remove_feature_flag(project_root, "i18n")?;

        // Regenerate AI context
        crate::ai_context::regenerate(project_root).ok();

        println!();
        println!(
            "{}",
            "i18n (internationalization) uninstalled successfully."
                .green()
                .bold()
        );

        Ok(())
    }
}

fn install_i18n(project_root: &Path) -> Result<()> {
    use crate::template::TemplateEngine;
    use crate::utils;
    use colored::Colorize;
    use tera::Context;

    println!("{}", "Installing i18n (internationalization)...".bold());

    let engine = TemplateEngine::new()?;
    let ctx = Context::new();

    // Generate backend i18n module
    let content = engine.render("addon/i18n/i18n.rs.tera", &ctx)?;
    utils::write_file(&project_root.join("backend/src/i18n.rs"), &content)?;
    println!("  {} backend/src/i18n.rs", "create".green());

    // Generate English locale file
    let content = engine.render("addon/i18n/en.json.tera", &ctx)?;
    utils::write_file(&project_root.join("backend/locales/en.json"), &content)?;
    println!("  {} backend/locales/en.json", "create".green());

    // Generate Russian locale file
    let content = engine.render("addon/i18n/ru.json.tera", &ctx)?;
    utils::write_file(&project_root.join("backend/locales/ru.json"), &content)?;
    println!("  {} backend/locales/ru.json", "create".green());

    // Generate frontend i18n module
    let content = engine.render("addon/i18n/i18n_frontend.ts.tera", &ctx)?;
    utils::write_file(&project_root.join("frontend/src/lib/i18n.ts"), &content)?;
    println!("  {} frontend/src/lib/i18n.ts", "create".green());

    // Add mod i18n to main.rs
    super::add_mod_to_main(project_root, "i18n")?;

    // Inject Accept-Language middleware via ROMANCE:MIDDLEWARE marker
    utils::insert_at_marker(
        &project_root.join("backend/src/routes/mod.rs"),
        "// === ROMANCE:MIDDLEWARE ===",
        "        .layer(axum::middleware::from_fn(crate::i18n::locale_middleware))",
    )?;

    // Add serde_json dependency if not present (should already be there)
    crate::generator::auth::insert_cargo_dependency(
        &project_root.join("backend/Cargo.toml"),
        &[("serde_json", r#""1""#)],
    )?;

    // Update romance.toml with i18n feature
    super::update_feature_flag(project_root, "i18n", true)?;

    println!();
    println!(
        "{}",
        "i18n (internationalization) installed successfully!"
            .green()
            .bold()
    );
    println!("  Locale files: backend/locales/en.json, backend/locales/ru.json");
    println!("  Backend usage: i18n::t(\"en\", \"common.success\")");
    println!("  Frontend usage: import {{ t }} from '@/lib/i18n'");
    println!("  The Accept-Language middleware extracts locale from request headers.");
    println!("  Access locale in handlers via: request.extensions().get::<i18n::Locale>()");

    Ok(())
}