mint-lang · gdotdesign · Sep 17, 2023 · Jun 12, 2023 · Jun 13, 2023 · Jun 13, 2023
diff --git a/core/source/Locale.mint b/core/source/Locale.mint
@@ -0,0 +1,19 @@
+module Locale {
+  /* Sets the current locale. */
+  fun set (locale : String) : Bool {
+    `_L.set(#{locale})`
+  }
+
+  /* Returns the current locale. */
+  fun get : Maybe(String) {
+    `
+    (() => {
+      if (_L.locale) {
+        return #{Maybe::Just(`_L.locale`)}
+      } else {
+        return #{Maybe::Nothing}
+      }
+    })()
+    `
+  }
+}
diff --git a/documentation/Language/Locale.md b/documentation/Language/Locale.md
@@ -0,0 +1,49 @@
+# Locale
+
+This feature of the language allows specifing localization tokens and values for languages indentified by [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) codes.
+
+```mint
+locale en {
+  ui: {
+    buttons: {
+      ok: "OK"
+    }
+  }
+}
+
+locale hu {
+  ui: {
+    buttons: {
+      ok: "Rendben"
+    }
+  }
+}
+```
+
+A locale consists of a tree structure where the keys are lowercase identifiers and the values are expressions.
+
+To localize a value you need to use the locale token:
+
+```
+:ui.buttons.ok
+```
+
+or if it's a function if can be called:
+
+```
+:ui.buttons.ok(param1, param2)
+```
+
+To get and set the current locale the `Locale` module can be used:
+
+```
+Locale.set("en")
+Locale.get() // Maybe::Just("en")
+```
+
+Every translation is typed checked:
+
+* all translations of the same key must have the same type
+* locale keys must have translations in every defined language
+
+Locales are open like Modules are so they can be defined in multiple places.
diff --git a/spec/compilers/call_labelled b/spec/compilers/call_labelled
@@ -0,0 +1,21 @@
+component Main {
+  fun test (argument1 : String, argument2: Number) : Html {
+    <div/>
+  }
+
+  fun render : Html {
+    test(argument2: 0, argument1: "")
+  }
+}
+--------------------------------------------------------------------------------
+class A extends _C {
+  a(b, c) {
+    return _h("div", {});
+  }
+
+  render() {
+    return this.a(``, 0);
+  }
+};
+
+A.displayName = "Main";
diff --git a/spec/compilers/locale_key b/spec/compilers/locale_key
@@ -0,0 +1,25 @@
+locale en {
+  test: "Hello"
+}
+
+component Main {
+  fun render : String {
+    :test
+  }
+}
+--------------------------------------------------------------------------------
+class A extends _C {
+  componentWillUnmount() {
+    _L._unsubscribe(this);
+  }
+
+  componentDidMount() {
+    _L._subscribe(this);
+  }
+
+  render() {
+    return _L.t("test");
+  }
+};
+
+A.displayName = "Main";
diff --git a/spec/formatters/locale b/spec/formatters/locale
@@ -0,0 +1,11 @@
+locale en {
+  ui: {
+    button: {
+      ok: "OK"
+    }
+  }
+}
+--------------------------------------------------------------------------------
+locale en {
+  ui: { button: { ok: "OK" } }
+}
diff --git a/spec/formatters/locale_key b/spec/formatters/locale_key
@@ -0,0 +1,23 @@
+locale en {
+  ui: {
+    button: {
+      ok: "OK"
+    }
+  }
+}
+
+component Main {
+  fun render : String {
+    :ui.button.ok
+  }
+}
+--------------------------------------------------------------------------------
+locale en {
+  ui: { button: { ok: "OK" } }
+}
+
+component Main {
+  fun render : String {
+    :ui.button.ok
+  }
+}
diff --git a/spec/parsers/locale_key_spec.cr b/spec/parsers/locale_key_spec.cr
@@ -0,0 +1,11 @@
+require "../spec_helper"
+
+describe "Locale" do
+  subject locale_key
+
+  expect_ignore "comp"
+  expect_ignore "asd"
+  expect_ignore ":"
+
+  expect_ok ":ui.button.ok"
+end
diff --git a/spec/parsers/locale_spec.cr b/spec/parsers/locale_spec.cr
@@ -0,0 +1,16 @@
+require "../spec_helper"
+
+describe "Locale" do
+  subject locale
+
+  expect_ignore "comp"
+  expect_ignore "asd"
+
+  expect_error "locale", Mint::Parser::LocaleExpectedLanguage
+  expect_error "locale{", Mint::Parser::LocaleExpectedLanguage
+  expect_error "locale ", Mint::Parser::LocaleExpectedLanguage
+  expect_error "locale en", Mint::Parser::LocaleExpectedOpeningBracket
+  expect_error "locale en {", Mint::Parser::LocaleExpectedClosingBracket
+
+  expect_ok "locale en { a: \"\" }"
+end
diff --git a/spec/type_checking/function_call_labelled b/spec/type_checking/function_call_labelled
@@ -0,0 +1,39 @@
+component Main {
+  fun test (argument1 : String, argument2: Number) : Html {
+    <div/>
+  }
+
+  fun render : Html {
+    test(argument2: 0, argument1: "")
+  }
+}
+-------------------------------------------------------------CallMixedArguments
+component Main {
+  fun test (argument1 : String, argument2: Number) : Html {
+    <div/>
+  }
+
+  fun render : Html {
+    test(0, argument1: "")
+  }
+}
+-------------------------------------------------------------CallMixedArguments
+component Main {
+  fun test (argument1 : String, argument2: Number) : Html {
+    <div/>
+  }
+
+  fun render : Html {
+    test(argument2: 0, "")
+  }
+}
+-----------------------------------------------------------CallNotFoundArgument
+component Main {
+  fun test (argument1 : String, argument2: Number) : Html {
+    <div/>
+  }
+
+  fun render : Html {
+    test(argument3: 0, argument1: "")
+  }
+}
diff --git a/spec/type_checking/locale_key b/spec/type_checking/locale_key
@@ -0,0 +1,43 @@
+locale en {
+  test: ""
+}
+
+component Main {
+  fun render : String {
+    :test
+  }
+}
+-------------------------------------------------------------TranslationMissing
+component Main {
+  fun render : String {
+    :test
+  }
+}
+-------------------------------------------------------TranslationNotTranslated
+locale en {
+  test: ""
+}
+
+locale hu {
+
+}
+
+component Main {
+  fun render : String {
+    :test
+  }
+}
+------------------------------------------------------------TranslationMismatch
+locale en {
+  test: ""
+}
+
+locale hu {
+  test: 0
+}
+
+component Main {
+  fun render : String {
+    :test
+  }
+}
diff --git a/src/ast.cr b/src/ast.cr
@@ -30,18 +30,21 @@ module Mint
                        If |
                        Js
 
-    getter components, modules, records, stores, routes, providers
-    getter suites, enums, comments, nodes, unified_modules, keywords
-    getter operators
+    getter components, modules, records, stores, routes, providers, operators
+    getter suites, enums, comments, nodes, keywords, locales
+
+    getter unified_modules, unified_locales
 
     def initialize(@operators = [] of Tuple(Int32, Int32),
                    @keywords = [] of Tuple(Int32, Int32),
                    @records = [] of RecordDefinition,
                    @unified_modules = [] of Module,
+                   @unified_locales = [] of Locale,
                    @components = [] of Component,
                    @providers = [] of Provider,
                    @comments = [] of Comment,
                    @modules = [] of Module,
+                   @locales = [] of Locale,
                    @routes = [] of Routes,
                    @suites = [] of Suite,
                    @stores = [] of Store,
@@ -77,6 +80,7 @@ module Mint
       @comments.concat ast.comments
       @modules.concat ast.modules
       @records.concat ast.records
+      @locales.concat ast.locales
       @stores.concat ast.stores
       @routes.concat ast.routes
       @suites.concat ast.suites
@@ -111,6 +115,18 @@ module Mint
             )
           end
 
+      @unified_locales =
+        @locales
+          .group_by(&.language)
+          .map do |_, locales|
+            Locale.new(
+              input: Data.new(input: "", file: ""),
+              fields: locales.flat_map(&.fields),
+              language: locales.first.language,
+              comment: nil,
+              from: 0,
+              to: 0)
+          end
       self
     end
   end

diff --git a/src/ast/call.cr b/src/ast/call.cr
@@ -3,7 +3,7 @@ module Mint
     class Call < Node
       getter arguments, expression
 
-      def initialize(@arguments : Array(Expression),
+      def initialize(@arguments : Array(CallExpression),
                      @expression : Expression,
                      @input : Data,
                      @from : Int32,

diff --git a/src/ast/call_expression.cr b/src/ast/call_expression.cr
@@ -0,0 +1,14 @@
+module Mint
+  class Ast
+    class CallExpression < Node
+      getter name, expression
+
+      def initialize(@expression : Expression,
+                     @name : Variable?,
+                     @input : Data,
+                     @from : Int32,
+                     @to : Int32)
+      end
+    end
+  end
+end
diff --git a/src/ast/component.cr b/src/ast/component.cr
@@ -3,7 +3,8 @@ module Mint
     class Component < Node
       getter properties, connects, styles, states, comments
       getter functions, gets, uses, name, comment, refs, constants
-      getter? global
+
+      getter? global, locales
 
       def initialize(@refs : Array(Tuple(Variable, Node)),
                      @properties : Array(Property),
@@ -16,6 +17,7 @@ module Mint
                      @comment : Comment?,
                      @gets : Array(Get),
                      @uses : Array(Use),
+                     @locales : Bool,
                      @global : Bool,
                      @name : TypeId,
                      @input : Data,

diff --git a/src/ast/locale.cr b/src/ast/locale.cr
@@ -0,0 +1,15 @@
+module Mint
+  class Ast
+    class Locale < Node
+      getter fields, comment, language
+
+      def initialize(@fields : Array(RecordField),
+                     @comment : Comment?,
+                     @language : String,
+                     @input : Data,
+                     @from : Int32,
+                     @to : Int32)
+      end
+    end
+  end
+end
diff --git a/src/ast/locale_key.cr b/src/ast/locale_key.cr
@@ -0,0 +1,13 @@
+module Mint
+  class Ast
+    class LocaleKey < Node
+      getter value
+
+      def initialize(@value : String,
+                     @input : Data,
+                     @from : Int32,
+                     @to : Int32)
+      end
+    end
+  end
+end