SOURCE CODE: Uize.Services.LocAdapter.Uize (view docs)

/*______________
|       ______  |   U I Z E    J A V A S C R I P T    F R A M E W O R K
|     /      /  |   ---------------------------------------------------
|    /    O /   |    MODULE : Uize.Services.LocAdapter.Uize Class
|   /    / /    |
|  /    / /  /| |    ONLINE : http://www.uize.com
| /____/ /__/_| | COPYRIGHT : (c)2013-2016 UIZE
|          /___ |   LICENSE : Available under MIT License or GNU General Public License
|_______________|             http://www.uize.com/license.html
*/

/* Module Meta Data
  type: Class
  importance: 2
  codeCompleteness: 100
  docCompleteness: 100
*/

/*?
  Introduction
    The =Uize.Services.LocAdapter.Uize= module defines an adapter for the =Uize.Services.Loc= service, specifically to be used with the UIZE JavaScript Framework.

    *DEVELOPERS:* `Chris van Rensburg`
*/

Uize.module ({
  name:'Uize.Services.LocAdapter.Uize',
  required:[
    'Uize.Data.Simple',
    'Uize.Data.NameValueRecords',
    'Uize.Util.RegExpComposition.WordSplitter'
  ],
  superclass:'Uize.Services.LocAdapter',
  builder:function (_superclass) {
    'use strict';

    var
      _resourceFilePathRegExp = /((?:^|\/)Loc\/)en_US(\.loc)$/,
      _wordSplitterRegExpComposition = Uize.Util.RegExpComposition.WordSplitter.extend ({
        tokenName:/[a-zA-Z_]+[0-9a-zA-Z_]*/,
        token:/\[\[({tokenName})\]\]/,
        wordSplitter:/{whitespace}|{token}|{punctuation}|{number}/
      })
    ;

    return _superclass.subclass ({
      instanceMethods:{
        getLanguageResourcePath:function (_enResourcePath,_language) {
          return _enResourcePath.replace (_resourceFilePathRegExp,'$1' + _language.replace ('-','_') + '$2');
        },

        isResourceFile:function (_filePath) {
          return _resourceFilePathRegExp.test (_filePath);
        },

        parseResourceFile:function (_resourceFileText) {
          return Uize.Data.Simple.parse ({simple:_resourceFileText,collapseChildren:true});
        },

        serializeResourceFile:function (_messages) {
          return Uize.map (
            Uize.Data.NameValueRecords.fromHash (_messages),
            function (_nameValue) {
              var
                _name = _nameValue.name,
                _value = _nameValue.value
              ;
              return (
                typeof _value == 'string'
                  ? _name + ': ' + _value
                  : (
                    _name + '\n' +
                    Uize.map (
                      Uize.keys (_value),
                      function (_pluralClass) {
                        return '\t' + _pluralClass + ': ' + _value [_pluralClass];
                      }
                    ).join ('\n')
                  )
              );
            }
          ).join ('\n');
        }
      },

      instanceProperties:{
        tokenRegExp:_wordSplitterRegExpComposition.get ('token'),
        wordSplitter:_wordSplitterRegExpComposition.get ('wordSplitter')
      }
    });
  }
});