Merged some conflicts.

app/lib/scripts/SpriteScriptModule.coffee

@@ -1,5 +1,6 @@
 ScriptModule = require './ScriptModule'
 {me} = require 'lib/auth'
+util = require 'lib/utils'
 
 module.exports = class SpritesScriptModule extends ScriptModule
   @neededFor: (noteGroup) ->
@@ -36,9 +37,9 @@ module.exports = class SpritesScriptModule extends ScriptModule
     responses = [] unless script.skippable or responses
     for response in responses ? []
       response.text = response.i18n?[me.lang()]?.text ? response.text
-    text = sprite.say.i18n?[me.lang()]?.text or sprite.say.text
-    blurb = sprite.say.i18n?[me.lang()]?.blurb or sprite.say.blurb
-    sound = sprite.say.sound?[me.lang()]?.sound or sprite.say.sound
+    text = util.i18n(sprite.say, 'text')
+    blurb = util.i18n(sprite.say, 'blurb')
+    sound = sprite.say.sound # TODO support sound i18n
     note =
       channel: 'level-sprite-dialogue'
       event:

app/lib/utils.coffee

@@ -28,8 +28,8 @@ module.exports.normalizeFunc = (func_thing, object) ->
       console.error("Could not find method", func_thing, 'in object', @)
       return => null # always return a func, or Mediator will go boom
     func_thing = func
-  return func_thing 
-  
+  return func_thing
+
 module.exports.hexToHSL = (hex) ->
   rgbToHsl(hexToR(hex), hexToG(hex), hexToB(hex))
 
@@ -37,11 +37,34 @@ hexToR = (h) -> parseInt (cutHex(h)).substring(0, 2), 16
 hexToG = (h) -> parseInt (cutHex(h)).substring(2, 4), 16
 hexToB = (h) -> parseInt (cutHex(h)).substring(4, 6), 16
 cutHex = (h) -> (if (h.charAt(0) is "#") then h.substring(1, 7) else h)
-  
+
 module.exports.hslToHex = (hsl) ->
   '#' + (toHex(n) for n in hslToRgb(hsl...)).join('')
-  
+
 toHex = (n) ->
   h = Math.floor(n).toString(16)
   h = '0'+h if h.length is 1
   h
+
+module.exports.i18n = (say, target, language=me.lang(), fallback='en') ->
+  generalResult = null
+  fallbackResult = null
+  fallforwardResult = null # If a general language isn't available, the first specific one will do
+  matches = (/\w+/gi).exec(language)
+  generalName = matches[0] if matches
+
+  for localeName, locale of say.i18n
+    if target of locale
+      result = locale[target]
+    else continue
+    return result if localeName == language
+    generalResult = result if localeName == generalName
+    fallbackResult = result if localeName == fallback
+    fallforwardResult = result if localeName.indexOf(language) == 0 and not fallforwardResult?
+
+  return generalResult if generalResult?
+  return fallforwardResult if fallforwardResult?
+  return fallbackResult if fallbackResult?
+  return say[target] if target of say
+  return say.text if 'text' of say
+  null

test/app/lib/utils.spec.coffee

@@ -0,0 +1,46 @@
+describe 'utils library', ->
+  util = require 'lib/utils'
+
+  beforeEach ->
+    this.fixture1 =
+      "text": "G'day, Wizard! Come to practice? Well, let's get started..."
+      "blurb": "G'day"
+      "i18n":
+        "es-419":
+          "text": "¡Buenas, Hechicero! ¿Vienes a practicar? Bueno, empecemos..."
+        "es-ES":
+          "text": "¡Buenas Mago! ¿Vienes a practicar? Bien, empecemos..."
+        "es":
+          "text": "¡Buenas Mago! ¿Vienes a practicar? Muy bien, empecemos..."
+        "fr":
+          "text": "S'lut, Magicien! Venu pratiquer? Ok, bien débutons..."
+        "pt-BR":
+          "text": "Bom dia, feiticeiro! Veio praticar? Então vamos começar..."
+        "en":
+          "text": "Ohai Magician!"
+        "de":
+          "text": "'N Tach auch, Zauberer! Kommst Du zum Üben? Dann lass uns anfangen..."
+        "sv":
+          "text": "Godagens, trollkarl! Kommit för att öva? Nå, låt oss börja..."
+
+
+  it 'i18n should find a valid target string', ->
+    expect(util.i18n(this.fixture1, 'text', 'sv')).toEqual(this.fixture1.i18n['sv'].text)
+    expect(util.i18n(this.fixture1, 'text', 'es-ES')).toEqual(this.fixture1.i18n['es-ES'].text)
+
+  it 'i18n picks the correct fallback for a specific language', ->
+    expect(util.i18n(this.fixture1, 'text', 'fr-be')).toEqual(this.fixture1.i18n['fr'].text)
+
+  it 'i18n picks the correct fallback', ->
+    expect(util.i18n(this.fixture1, 'text', 'nl')).toEqual(this.fixture1.i18n['en'].text)
+    expect(util.i18n(this.fixture1, 'text', 'nl', 'de')).toEqual(this.fixture1.i18n['de'].text)
+
+  it 'i18n falls back to the default text, even for other targets (like blurb)', ->
+    delete this.fixture1.i18n['en']
+    expect(util.i18n(this.fixture1, 'text', 'en')).toEqual(this.fixture1.text)
+    expect(util.i18n(this.fixture1, 'blurb', 'en')).toEqual(this.fixture1.blurb)
+    delete this.fixture1.blurb
+    expect(util.i18n(this.fixture1, 'blurb', 'en')).toEqual(this.fixture1.text)
+
+  it 'i18n can fall forward if a general language is not found', ->
+    expect(util.i18n(this.fixture1, 'text', 'pt')).toEqual(this.fixture1.i18n['pt-BR'].text)