98d6a1037fd95d5fdcfd86b8417d68af539c4be7
[fnpeditor.git] / src / wlxml / wlxml.js
1 define([
2     'libs/jquery',
3     'libs/underscore',
4     'smartxml/smartxml',
5     'smartxml/transformations'
6 ], function($, _, smartxml, transformations) {
7     
8 'use strict';
9
10 // utils
11
12 var isMetaAttribute = function(attrName) {
13     return attrName.substr(0, 5) === 'meta-';
14 };
15
16 //
17
18 var AttributesList = function() {};
19 AttributesList.prototype = Object.create({});
20 AttributesList.prototype.keys = function() {
21     return _.keys(this);
22 };
23
24 var installObject = function(instance, klass) {
25     var methods = instance.document.classMethods[klass] || instance.document.classTransformations;
26     if(methods) {
27         instance.object = Object.create(_.extend({
28             transform: function(name, args) {
29                 // TODO: refactor with DocumentElement.transform
30                 var Transformation = instance.document.classTransformations[klass].get(name),
31                     transformation;
32                 if(Transformation) {
33                     transformation = new Transformation(instance.document, instance, args);
34                 }
35                 return instance.document.transform(transformation);
36             }
37         }, methods));
38         _.keys(methods).forEach(function(key) {
39             instance.object[key] = _.bind(instance.object[key], instance);
40         });
41     }
42 }
43
44 var WLXMLElementNode = function(nativeNode, document) {
45     smartxml.ElementNode.call(this, nativeNode, document);
46     installObject(this, this.getClass());
47 };
48 WLXMLElementNode.prototype = Object.create(smartxml.ElementNode.prototype);
49
50 $.extend(WLXMLElementNode.prototype, smartxml.ElementNode.prototype, {
51     getClass: function() {
52         return this.getAttr('class') || '';
53     },
54     setClass: function(klass) {
55         var methods, object;
56         if(klass !== this.klass) {
57             installObject(this, klass);
58             return this.setAttr('class', klass);
59         }
60     },
61     is: function(klass) {
62         return this.getClass().substr(0, klass.length) === klass;
63     },
64     getMetaAttributes: function() {
65         var toret = new AttributesList(),
66             classParts = [''].concat(this.getClass().split('.')),
67             classCurrent, classDesc;
68
69         classParts.forEach(function(part) {
70             classCurrent = classCurrent ? classCurrent + '.' + part : part;
71             classDesc = this.document.options.wlxmlClasses[classCurrent];
72             if(classDesc) {
73                 _.keys(classDesc.attrs).forEach(function(attrName) {
74                     toret[attrName] = _.extend({value: this.getAttr('meta-' + attrName)}, classDesc.attrs[attrName]);
75                 }.bind(this));
76             }
77         }.bind(this));
78         return toret;
79     },
80     setMetaAttribute: function(key, value) {
81         this.setAttr('meta-'+key, value);
82     },
83     getOtherAttributes: function() {
84         var toret = {};
85         this.getAttrs().forEach(function(attr) {
86             if(attr.name !== 'class' && !isMetaAttribute(attr.name)) {
87                 toret[attr.name] = attr.value;
88             }
89         });
90         return toret;
91     },
92
93     _getXMLDOMToDump: function() {
94         var DOM = this._$.clone(true, true);
95
96         DOM.find('*').addBack().each(function() {
97             var el = $(this),
98                 parent = el.parent(),
99                 contents = parent.contents(),
100                 idx = contents.index(el),
101                 data = el.data();
102
103
104             var txt;
105
106             if(data[formatter_prefix+ 'orig_before']) {
107                 txt = idx > 0 && contents[idx-1].nodeType === Node.TEXT_NODE ? contents[idx-1] : null;
108                 if(txt && txt.data === data[formatter_prefix + 'orig_before_transformed']) {
109                     txt.data = data[formatter_prefix+ 'orig_before_original'];
110                 } else {
111                     el.before(data[formatter_prefix+ 'orig_before']);
112                 }
113             }
114             if(data[formatter_prefix+ 'orig_after']) {
115                 txt = idx < contents.length-1 && contents[idx+1].nodeType === Node.TEXT_NODE ? contents[idx+1] : null;
116                 if(txt && txt.data === data[formatter_prefix + 'orig_after_transformed']) {
117                     txt.data = data[formatter_prefix+ 'orig_after_original'];
118                 } else {
119                     el.after(data[formatter_prefix+ 'orig_after']);
120                 }
121             }
122             if(data[formatter_prefix+ 'orig_begin']) {
123                 el.prepend(data[formatter_prefix+ 'orig_begin']);
124             }
125             if(data[formatter_prefix+ 'orig_end']) {
126                 contents = el.contents();
127                 txt = (contents.length && contents[contents.length-1].nodeType === Node.TEXT_NODE) ? contents[contents.length-1] : null;
128                 if(txt && txt.data === data[formatter_prefix + 'orig_end_transformed']) {
129                     txt.data = data[formatter_prefix+ 'orig_end_original'];
130                 } else {
131                     el.append(data[formatter_prefix+ 'orig_end']);
132                 }
133             }
134         });
135
136         return DOM;
137     }
138 });
139
140 WLXMLElementNode.prototype.transformations.register(transformations.createContextTransformation({
141     name: 'wlxml.setMetaAttribute',
142     impl: function(args) {
143         this.setMetaAttribute(args.name, args.value);
144     },
145     getChangeRoot: function() {
146         return this.context;
147     }
148 }));
149
150
151
152 var WLXMLDocumentNode = function() {
153     smartxml.DocumentNode.apply(this, arguments);
154 }
155 WLXMLDocumentNode.prototype = Object.create(smartxml.DocumentNode.prototype);
156
157 var WLXMLDocument = function(xml, options) {
158     smartxml.Document.call(this, xml);
159     this.options = options;
160
161     // this.DocumentNodeFactory = function() {
162     //     WLXMLDocumentNode.apply(this, arguments);
163     // };
164
165     // this.DocumentNodeFactory.prototype = Object.create(WLXMLDocumentNode.prototype);    
166     
167     this.ElementNodeFactory = function() {
168         WLXMLElementNode.apply(this, arguments);
169     }
170     this.ElementNodeFactory.prototype = Object.create(WLXMLElementNode.prototype);
171     this.ElementNodeFactory.prototype.transformations = new transformations.TransformationStorage();
172     this.ElementNodeFactory.prototype.registerTransformation = function(Transformation) {
173         return this.transformations.register(Transformation);
174     };
175
176     this.TextNodeFactory = function() {
177         smartxml.TextNode.apply(this, arguments);
178     }
179     this.TextNodeFactory.prototype = Object.create(smartxml.TextNode.prototype);
180     this.TextNodeFactory.prototype.transformations = new transformations.TransformationStorage();
181     this.TextNodeFactory.prototype.registerTransformation = function(Transformation) {
182         return this.transformations.register(Transformation);
183     };
184
185     this.classMethods = {};
186     this.classTransformations = {};
187 };
188
189 var formatter_prefix = '_wlxml_formatter_';
190
191
192 WLXMLDocument.prototype = Object.create(smartxml.Document.prototype);
193 $.extend(WLXMLDocument.prototype, {
194     ElementNodeFactory: WLXMLElementNode,
195     loadXML: function(xml) {
196         smartxml.Document.prototype.loadXML.call(this, xml, {silent: true});
197         $(this.dom).find(':not(iframe)').addBack().contents()
198             .filter(function() {return this.nodeType === Node.TEXT_NODE;})
199             .each(function() {
200                 var el = $(this),
201                     text = {original: el.text(), trimmed: $.trim(el.text())},
202                     elParent = el.parent(),
203                     hasSpanParent = elParent.prop('tagName') === 'SPAN',
204                     hasSpanBefore = el.prev().length && $(el.prev()).prop('tagName') === 'SPAN',
205                     hasSpanAfter = el.next().length && $(el.next()).prop('tagName') === 'SPAN';
206
207
208                 var addInfo = function(toAdd, where, transformed, original) {
209                     var parentContents = elParent.contents(),
210                         idx = parentContents.index(el[0]),
211                         prev = idx > 0 ? parentContents[idx-1] : null,
212                         next = idx < parentContents.length - 1 ? parentContents[idx+1] : null,
213                         target, key;
214
215                     if(where === 'above') {
216                         target = prev ? $(prev) : elParent;
217                         key = prev ? 'orig_after' : 'orig_begin';
218                     } else if(where === 'below') {
219                         target = next ? $(next) : elParent;
220                         key = next ? 'orig_before' : 'orig_end';
221                     } else { throw new Error();}
222
223                     target.data(formatter_prefix + key, toAdd);
224                     if(transformed !== undefined) {
225                         target.data(formatter_prefix + key + '_transformed', transformed);
226                     }
227                     if(original !== undefined) {
228                         target.data(formatter_prefix + key + '_original', original);
229                     }
230                 };
231
232                 text.transformed = text.trimmed;
233
234                 if(hasSpanParent || hasSpanBefore || hasSpanAfter) {
235                     var startSpace = /\s/g.test(text.original.substr(0,1)),
236                         endSpace = /\s/g.test(text.original.substr(-1)) && text.original.length > 1;
237                     text.transformed = (startSpace && (hasSpanParent || hasSpanBefore) ? ' ' : '');
238                     text.transformed += text.trimmed;
239                     text.transformed += (endSpace && (hasSpanParent || hasSpanAfter) ? ' ' : '');
240                 } else {
241                     if(text.trimmed.length === 0 && text.original.length > 0 && elParent.contents().length === 1) {
242                         text.transformed = ' ';
243                     }
244                 }
245
246                 if(!text.transformed) {
247                     addInfo(text.original, 'below');
248                     el.remove();
249                     return true; // continue
250                 }
251
252                 if(text.transformed !== text.original) {
253                     // if(!text.trimmed) {
254                     //     addInfo(text.original, 'below');
255                     // } else {
256                         var startingMatch = text.original.match(/^\s+/g),
257                             endingMatch = text.original.match(/\s+$/g),
258                             startingWhiteSpace = startingMatch ? startingMatch[0] : null,
259                             endingWhiteSpace = endingMatch ? endingMatch[0] : null;
260
261                         if(endingWhiteSpace) {
262                             if(text.transformed[text.transformed.length - 1] === ' ' && endingWhiteSpace[0] === ' ') {
263                                 endingWhiteSpace = endingWhiteSpace.substr(1);
264                             }
265                             addInfo(endingWhiteSpace, 'below', !text.trimmed ? text.transformed : undefined, !text.trimmed ? text.original : undefined);
266                         }
267
268                         if(startingWhiteSpace && text.trimmed) {
269                             if(text.transformed[0] === ' ' && startingWhiteSpace[startingWhiteSpace.length-1] === ' ') {
270                                 startingWhiteSpace = startingWhiteSpace.substr(0, startingWhiteSpace.length -1);
271                             }
272                             addInfo(startingWhiteSpace, 'above', !text.trimmed ? text.transformed : undefined, !text.trimmed ? text.original : undefined);
273                         }
274                     //}
275                 }
276
277                 el.replaceWith(document.createTextNode(text.transformed));
278             });
279         this.trigger('contentSet');
280     },
281
282     registerTransformation: function(Transformation) {
283         return this.transformations.register(Transformation);
284     },
285
286     registerClassTransformation: function(Transformation, className) {
287         var thisClassTransformations = (this.classTransformations[className] = this.classTransformations[className] || new transformations.TransformationStorage());
288         return thisClassTransformations.register(Transformation);
289     },
290
291     registerClassMethod: function(methodName, method, className) {
292         var thisClassMethods = (this.classMethods[className] = this.classMethods[className] || {});
293         thisClassMethods[methodName] = method;
294     },
295
296     registerExtension: function(extension) {
297         //debugger;
298         var doc = this,
299             existingPropertyNames = _.values(this);
300
301         var getTrans = function(desc, methodName) {
302             if(typeof desc === 'function') {
303                 desc = {impl: desc};
304             }
305             if(!desc.impl) {
306                 throw new Error('Got transformation description without implementation.')
307             }
308             desc.name = desc.name || methodName;
309             return desc;
310         };
311
312         [
313             {source: extension.document, target: doc},
314             {source: extension.documentNode, target: [doc.ElementNodeFactory.prototype, doc.TextNodeFactory.prototype]},
315
316         ].forEach(function(mapping) {
317             if(mapping.source) {
318                 if(mapping.source.methods) {
319                     existingPropertyNames = _.values(mapping.target)
320                     _.pairs(mapping.source.methods).forEach(function(pair) {
321                         var methodName = pair[0],
322                             method = pair[1],
323                             targets = _.isArray(mapping.target) ? mapping.target : [mapping.target];
324                         if(_.contains(existingPropertyNames, methodName)) {
325                             throw new Error('Cannot extend {target} with method name {methodName}. Name already exists.'
326                                 .replace('{target}', mapping.target)
327                                 .replace('{methodName}', methodName)
328                             );
329                         }
330                         targets.forEach(function(target) {
331                             target[methodName] = method;
332                         });
333                     });
334                 }
335
336                 if(mapping.source.transformations) {
337                     _.pairs(mapping.source.transformations).forEach(function(pair) {
338                         var transformation = getTrans(pair[1], pair[0]),
339                             targets = _.isArray(mapping.target) ? mapping.target : [mapping.target];
340                         targets.forEach(function(target) {
341                             target.registerTransformation(transformations.createContextTransformation(transformation));
342                         });
343                     });
344                 }
345             }
346         });
347
348         _.pairs(extension.wlxmlClass).forEach(function(pair) {
349             var className = pair[0],
350                 classExtension = pair[1];
351
352             _.pairs(classExtension.methods || {}).forEach(function(pair) {
353                 var name = pair[0],
354                     method = pair[1];
355                 doc.registerClassMethod(name, method, className);
356             });
357
358             _.pairs(classExtension.transformations || {}).forEach(function(pair) {
359                 var transformation = getTrans(pair[1], pair[0]);
360                 doc.registerClassTransformation(transformations.createContextTransformation(transformation), className);
361             }); 
362         });
363
364     }
365
366 });
367
368 var wlxmlClasses = {
369     'uri': {
370         attrs: {uri: {type: 'string'}}
371     }
372 };
373
374 var classMethods = {};
375
376 return {
377     WLXMLDocumentFromXML: function(xml, options) {
378         options = _.extend({wlxmlClasses: wlxmlClasses}, options);
379         return new WLXMLDocument(xml, options);
380     },
381
382     WLXMLElementNodeFromXML: function(xml) {
383         return this.WLXMLDocumentFromXML(xml).root;
384     },
385
386     registerExtension: function(extension) {
387         // @@ depracated
388         if(extension.documentTransformations) {
389             extension.documentTransformations.forEach(function(method) {
390                 WLXMLDocument.prototype.transformations.register(transformations.createContextTransformation(method));
391             });
392         }
393
394         _.pairs(extension.classMethods).forEach(function(pair) {
395             var className = pair[0],
396                 methods = pair[1];
397             _.pairs(methods).forEach(function(pair) {
398                 var methodName = pair[0],
399                     method = pair[1];
400                 classMethods[className] = classMethods[className] || {};
401                 classMethods[className][methodName] = method;
402             });
403             
404         });
405
406         _.extend(WLXMLDocument.prototype, extension.documentMethods);
407
408     }
409
410 };
411
412 });