f96e0ff7733b8ca62f55d5e231a1699e30278120
[fnpeditor.git] / modules / documentCanvas / canvas / canvas.test3.js
1 define([
2 'libs/chai',
3 'libs/sinon',
4 'modules/documentCanvas/canvas/canvas',
5 'modules/documentCanvas/canvas/documentElement',
6 'modules/documentCanvas/canvas/utils'
7 ], function(chai, sinon, canvas, documentElement, utils) {
8     
9 'use strict';
10
11 var expect = chai.expect;
12
13
14 describe('Canvas', function() {
15
16
17
18     describe('ZWS', function() {
19         var view, section, textElement;
20         
21         beforeEach(function() {
22             var c = canvas.fromXML('<section></section>');
23
24             section = c.doc();
25             textElement = section.children()[0];
26             view = c.view()[0];
27             document.getElementsByTagName('body')[0].appendChild(view);
28         });
29
30         afterEach(function() {
31             view.parentNode.removeChild(view);
32         });
33
34         var getTextContainerNode = function(textElement) {
35             return textElement.dom().contents()[0];
36         }
37
38         it('is set automatically on all empty DocumentTextElements', function() {
39             expect(getTextContainerNode(textElement).data).to.equal(utils.unicode.ZWS);
40
41             var header = section.append({tag: 'header'}),
42                 newText = header.append({text: ''}),
43                 textNode = getTextContainerNode(textElement);
44             
45             expect(textNode.data).to.equal(utils.unicode.ZWS);
46         });
47
48         it('is added automatically when whole text gets deleted', function() {
49             getTextContainerNode(textElement).data = '';
50             
51             window.setTimeout(function() {
52                 expect(getTextContainerNode(textElement).data).to.equal(utils.unicode.ZWS);
53             }, 0)
54             
55             var header = section.append({tag: 'header'}),
56                 newText = header.append({text: 'Alice'}),
57                 textNode = getTextContainerNode(newText);
58
59             expect(textNode.data).to.have.length('Alice'.length);
60             textNode.data = '';
61
62             window.setTimeout(function() {
63                 expect(textNode.data).to.equal(utils.unicode.ZWS);
64             }, 0)
65         });
66     });
67
68     describe('Internal HTML representation of a DocumentNodeElement', function() {
69         it('is always a div tag', function() {
70             ['section', 'header', 'span', 'aside', 'figure'].forEach(function(tagName) {
71                 var dom = canvas.fromXML('<' + tagName + '></' + tagName + '>').doc().dom();
72                 expect(dom.prop('tagName')).to.equal('DIV', tagName + ' is represented as div');
73             });
74         });
75         it('has wlxml tag put into wlxml-tag attribute of its internal container', function() {
76             var dom = canvas.fromXML('<section></section>').doc().dom();
77             expect(dom.children('[document-element-content]').attr('wlxml-tag')).to.equal('section');
78         });
79         it('has wlxml class put into wlxml-class attribute of its internal containr, dots replaced with dashes', function() {
80             var dom = canvas.fromXML('<section class="some.class"></section>').doc().dom();
81             expect(dom.children('[document-element-content]').attr('wlxml-class')).to.equal('some-class');
82         });
83     });
84
85     describe('Internal HTML representation of a DocumentTextElement', function() {
86         it('is text node wrapped in a div with document-text-element attribute set', function() {
87             var dom = canvas.fromXML('<section>Alice</section>').doc().children()[0].dom();
88             expect(dom.prop('tagName')).to.equal('DIV');
89             expect(dom.attr('document-text-element')).to.equal('');
90             expect(dom.contents().length).to.equal(1);
91             expect(dom.contents()[0].nodeType).to.equal(Node.TEXT_NODE);
92             expect($(dom.contents()[0]).text()).to.equal('Alice');
93         });
94     });
95
96     describe('basic properties', function() {
97         it('renders empty document when canvas created from empty XML', function() {
98             var c = canvas.fromXML('');
99             expect(c.doc()).to.equal(null);
100         });
101
102         it('gives access to its document root node', function() {
103             var c = canvas.fromXML('<section></section>');
104             expect(c.doc().getWlxmlTag()).to.equal('section');
105         });
106
107         describe('root element', function() {
108             it('has no parent', function() {
109                 var c = canvas.fromXML('<section></section>');
110                 expect(c.doc().parent()).to.be.null;
111             });
112         });
113
114         describe('DocumentTextElement', function() {
115             it('can have its content set', function() {
116                 var c = canvas.fromXML('<section>Alice</section>'),
117                     root = c.doc(),
118                     text = root.children()[0];
119                 
120                 text.setText('a cat');
121                 expect(root.children()[0].getText()).to.equal('a cat');
122             });
123         });
124
125         describe('DocumentNodeElement', function() {
126             it('knows index of its child', function() {
127                 var c = canvas.fromXML('<section><div></div><header></header><span></span></section>'),
128                     root = c.doc(),
129                     child = root.children()[1];
130                 expect(root.childIndex(child)).to.equal(1);
131             });
132
133             it('knows WLXML tag it renders', function(){
134                 var c = canvas.fromXML('<section></section>'),
135                     section = c.doc();
136                 expect(section.getWlxmlTag()).to.equal('section', 'initial tag is section');
137                 section.setWlxmlTag('header');
138                 expect(section.getWlxmlTag()).to.equal('header', 'tag is changed to header');
139             });
140
141             it('knows WLXML class of a WLXML tag it renders', function(){
142                 var c = canvas.fromXML('<section class="some.class.A"></section>'),
143                     section = c.doc();
144                 expect(section.getWlxmlClass()).to.equal('some.class.A');
145                 section.setWlxmlClass('some.class.B');
146                 expect(section.getWlxmlClass()).to.equal('some.class.B');
147                 section.setWlxmlClass(null);
148                 expect(section.getWlxmlClass()).to.be.undefined;
149             });
150
151
152
153             describe('element has meta attributes', function() {
154                 it('can change its meta attributes', function() {
155                     var c = canvas.fromXML('<section><span class="uri" meta-uri="someuri"></span></section>'),
156                     span = c.doc().children()[0];
157                     
158                     expect(span.getWlxmlMetaAttr('uri')).to.equal('someuri');
159                     span.setWlxmlMetaAttr('uri', 'otheruri');
160                     expect(span.getWlxmlMetaAttr('uri')).to.equal('otheruri');
161                 });
162
163                 it('changes its meta attributes with class change', function() {
164                     var c = canvas.fromXML('<section><span class="uri" meta-uri="someuri"></span></section>'),
165                     span = c.doc().children()[0];
166                     
167                     expect(span.getWlxmlMetaAttr('uri')).to.equal('someuri');
168                     span.setWlxmlClass('author');
169                     expect(span.getWlxmlMetaAttr('uri')).to.be.undefined;
170                 });
171
172                 it('keeps meta attribute value on class change if a new class has this attribute', function() {
173                     var c = canvas.fromXML('<section><span class="uri" meta-uri="someuri"></span></section>'),
174                     span = c.doc().children()[0];
175                     span.setWlxmlClass('uri.some.subclass');
176                     expect(span.getWlxmlMetaAttr('uri')).to.equal('someuri');
177                 });
178             });
179         });
180
181         it('returns DocumentNodeElement instance from HTMLElement', function() {
182             var c = canvas.fromXML('<section></section>'),
183                 htmlElement = c.doc().dom().get(0),
184                 element = c.getDocumentElement(htmlElement);
185             expect(element).to.be.instanceOf(documentElement.DocumentNodeElement);
186             expect(element.sameNode(c.doc()));
187         });
188         
189         it('returns DocumentTextElement instance from Text Node', function() {
190             var c = canvas.fromXML('<section>Alice</section>'),
191                 aliceElement = c.doc().children()[0],
192                 textNode = aliceElement.dom().contents()[0],
193                 element = c.getDocumentElement(textNode);
194
195             expect(textNode.nodeType).to.equal(Node.TEXT_NODE, 'text node selected');
196             expect($(textNode).text()).to.equal('Alice');
197
198             expect(element).to.be.instanceOf(documentElement.DocumentTextElement);
199             expect(element.sameNode(c.doc().children()[0]));
200         });
201     });
202
203
204
205     describe('document representation api', function() {
206         describe('document root element', function() {
207             var c = canvas.fromXML('<section></section>');
208             it('exists', function() {
209                 expect(c.doc()).to.be.instanceOf(documentElement.DocumentElement);
210             });
211             it('is of type DocumentNodeElement', function() {
212                 expect(c.doc()).to.be.instanceOf(documentElement.DocumentNodeElement);
213             });
214         });
215
216         describe('DocumentElements comparison', function() {
217             it('reports dwo DocumentElements to be the same when they represent the same wlxml document element', function() {
218                 var c = canvas.fromXML('<section><div></div><div></div></section>'),
219                     first_div1 = c.doc().children()[0],
220                     first_div2 = c.doc().children()[0],
221                     second_div = c.doc().children()[1];
222                 expect(first_div1.sameNode(first_div1)).to.be.true;
223                 expect(first_div1.sameNode(first_div2)).to.be.true;
224                 expect(first_div1.sameNode(second_div)).to.be.false;
225             });
226         });
227
228         describe('traversing', function() {
229             it('reports element nodes', function() {
230                 var c = canvas.fromXML('<section><div></div></section>'),
231                     children = c.doc().children();
232                 expect(children.length).to.equal(1);
233                 expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
234
235                 c = canvas.fromXML('<section><div></div><div></div></section>'),
236                     children = c.doc().children();
237                 expect(children.length).to.equal(2);
238                 expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
239                 expect(children[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
240             });
241             
242             it('reports text nodes', function() {
243                 var c = canvas.fromXML('<section>Alice</section>'),
244                     children = c.doc().children();
245                 expect(children.length).to.equal(1);
246                 expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
247             });
248
249             describe('accessing parents', function() {
250                 it('returns DocumentNodeElement representing parent in wlxml document as DocumentNodeElement parent', function() {
251                     var c = canvas.fromXML('<section><div></div></section>'),
252                         div = c.doc().children()[0];
253                     expect(div.parent().sameNode(c.doc())).to.be.true;
254                 });
255                 it('returns DocumentNodeElement representing parent in wlxml document as DocumentTextElement parent', function() {
256                     var c = canvas.fromXML('<section>Alice</section>'),
257                         text = c.doc().children()[0];
258                     expect(text.parent().sameNode(c.doc())).to.be.true;
259                 });
260             });
261
262             describe('accessing sibling parents of two elements', function() {
263                 it('returns elements themself if they have direct common parent', function() {
264                     var c = canvas.fromXML('<section>\
265                         <div>\
266                             <div>A</div>\
267                             <div>B</div>\
268                         </div>\
269                     </section>'),
270                         section = c.doc(),
271                         wrappingDiv = c.doc().children()[0],
272                         divA = wrappingDiv.children()[0],
273                         divB = wrappingDiv.children()[1];
274
275                     var siblingParents = c.getSiblingParents({element1: divA, element2: divB});
276
277                     expect(siblingParents.element1.sameNode(divA)).to.equal(true, 'divA');
278                     expect(siblingParents.element2.sameNode(divB)).to.equal(true, 'divB');
279                 });
280
281                 it('returns sibling parents - example 1', function() {
282                     var c = canvas.fromXML('<section>Alice <span>has a cat</span></section>'),
283                         section = c.doc(),
284                         aliceText = section.children()[0],
285                         span = section.children()[1],
286                         spanText = span.children()[0];
287
288                     var siblingParents = c.getSiblingParents({element1: aliceText, element2: spanText});
289
290                     expect(siblingParents.element1.sameNode(aliceText)).to.equal(true, 'aliceText');
291                     expect(siblingParents.element2.sameNode(span)).to.equal(true, 'span');
292                 });
293             })
294
295             describe('free text handling', function() {
296                     it('sees free text', function() {
297                         var c = canvas.fromXML('<section>Alice <span>has</span> a cat</section>'),
298                             children = c.doc().children();
299                         expect(children.length).to.equal(3);
300                         expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
301                         expect(children[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
302                         expect(children[2]).to.be.instanceOf(documentElement.DocumentTextElement);
303                     });
304             });
305
306             describe('empty nodes handling', function() {
307                 it('says empty element node from XML source has one empty DocumentTextElement', function() {
308                     var c = canvas.fromXML('<section></section>');
309                     expect(c.doc().children()).to.have.length(1);
310                     expect(c.doc().children()[0].getText()).to.equal('');
311                 });
312
313                 it('allows creation of an empty element node', function() {
314                     var c = canvas.fromXML('<section></section>'),
315                         section = c.doc(),
316                         header = section.append({tag: 'header'});
317                     expect(header.children()).to.have.length(0);
318                 });
319             });
320             
321             describe('white characters handling', function() {
322
323                 it('says element node with one space has one DocumentTextElement', function() {
324                     var c = canvas.fromXML('<section> </section>');
325                     expect(c.doc().children().length).to.equal(1);
326                     expect(c.doc().children()[0]).to.be.instanceOf(documentElement.DocumentTextElement);
327                     expect(c.doc().children()[0].getText()).to.equal(' ');
328                 });
329                 it('ignores white space surrounding block elements', function() {
330                     var c = canvas.fromXML('<section> <div></div> </section>');
331                     var children = c.doc().children();
332                     expect(children.length).to.equal(1);
333                     expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
334                 });
335                 it('ignores white space between block elements', function() {
336                     var c = canvas.fromXML('<section><div></div> <div></div></section>');
337                     var children = c.doc().children();
338                     expect(children.length === 2);
339                     [0,1].forEach(function(idx) {
340                         expect(children[idx]).to.be.instanceOf(documentElement.DocumentNodeElement);
341                     });
342                 });
343
344                 it('trims white space from the beginning and the end of the block elements', function() {
345                     var c = canvas.fromXML('<section> Alice <span>has</span> a cat </section>');
346                     expect(c.doc().children()[0].getText()).to.equal('Alice ');
347                     expect(c.doc().children()[2].getText()).to.equal(' a cat');
348                 });
349
350                 it('normalizes string of white characters to one space at the inline element boundries', function() {
351                     var c = canvas.fromXML('<span>   Alice has a cat   </span>');
352                     expect(c.doc().children()[0].getText()).to.equal(' Alice has a cat ');
353                 });
354
355                 it('normalizes string of white characters to one space before inline element', function() {
356                     var c = canvas.fromXML('<div>Alice has  <span>a cat</span></div>');
357                     expect(c.doc().children()[0].getText()).to.equal('Alice has ');
358                 });
359                 
360                 it('normalizes string of white characters to one space after inline element', function() {
361                     var c = canvas.fromXML('<div>Alice has <span>a</span>  cat</div>');
362                     expect(c.doc().children()[2].getText()).to.equal(' cat');
363                 });
364             });
365
366             describe('getting vertically first text element', function() {
367                 it('returns the first child if it\'s text element, ignores metadata', function() {
368                     var c = canvas.fromXML('<section><metadata><dc:author>author</dc:author></metadata>Alice<div>has</div>a cat</section>'),
369                         first = c.doc().getVerticallyFirstTextElement();
370
371                     expect(first.sameNode(c.doc().children()[1])).to.be.true;
372                 });
373
374                 it('looks recursively inside node elements if they precede text element', function() {
375                     var c = canvas.fromXML('\
376                             <section>\
377                                 <div>\
378                                     <div>\
379                                         Alice\
380                                     </div>\
381                                 </div>\
382                                 Some text\
383                             </section>'),
384                         textAlice = c.doc().children()[0].children()[0].children()[0],
385                         first = c.doc().getVerticallyFirstTextElement();
386
387                     expect(textAlice).to.be.instanceOf(documentElement.DocumentTextElement);
388                     expect(first.sameNode(textAlice)).to.be.true;
389                 });
390             });
391         });
392
393         describe('manipulation api', function() {
394
395             describe('Basic Element inserting', function() {
396                 it('can put new NodeElement at the end', function() {
397                     var c = canvas.fromXML('<section><div></div></section>'),
398                         appended = c.doc().append({tag: 'header', klass: 'some.class'}),
399                         children = c.doc().children();
400
401                     expect(children.length).to.equal(2);
402                     expect(children[1].sameNode(appended)).to.be.true;
403                 });
404
405                 it('can put new TextElement at the end', function() {
406                     var c = canvas.fromXML('<section><div><div></section>'),
407                         appended = c.doc().append({text: 'Alice'}),
408                         children = c.doc().children();
409
410                     expect(children.length).to.equal(2);
411                     expect(children[1].sameNode(appended)).to.be.true;
412                     expect(children[1].getText()).to.equal('Alice');
413                 });
414
415                 it('can put new NodeElement at the beginning', function() {
416                     var c = canvas.fromXML('<section><div></div></section>'),
417                         prepended = c.doc().prepend({tag: 'header', klass: 'some.class'}),
418                         children = c.doc().children();
419
420                     expect(children).to.have.length(2);
421                     expect(children[0].sameNode(prepended)).to.be.true;
422                 });
423
424                 it('can put new TextElement at the beginning', function() {
425                     var c = canvas.fromXML('<section><div></div></section>'),
426                         prepended = c.doc().prepend({text: 'Alice'}),
427                         children = c.doc().children();
428
429                     expect(children).to.have.length(2)
430                     expect(children[0].sameNode(prepended)).to.be.true;
431                     expect(children[0].getText()).to.equal('Alice');
432                 });
433
434                 it('can put new NodeElement after another NodeElement', function() {
435                     var c = canvas.fromXML('<section><div></div></section>'),
436                         div = c.doc().children()[0],
437                         added = div.after({tag: 'header', klass: 'some.class'}),
438                         children = c.doc().children();
439                     expect(children.length).to.equal(2);
440                     expect(children[1].sameNode(added)).to.be.true;
441                 });
442
443                 it('can put new Nodeelement before another element', function() {
444                     var c = canvas.fromXML('<section><div></div></section>'),
445                         div = c.doc().children()[0],
446                         added = div.before({tag: 'header', klass: 'some.class'}),
447                         children = c.doc().children();
448                     expect(children.length).to.equal(2);
449                     expect(children[0].sameNode(added)).to.be.true;
450                 });
451
452                 it('can put new DocumentNodeElement after DocumentTextElement', function() {
453                     var c = canvas.fromXML('<section>Alice</section>'),
454                         text = c.doc().children()[0],
455                         added = text.after({tag: 'p'}),
456                         children = c.doc().children();
457
458                     expect(children.length).to.equal(2);
459                     expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
460                     expect(children[0].getText()).to.equal('Alice');
461                     expect(children[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
462                     expect(children[1].sameNode(added)).to.be.true;
463                 });
464                 it('can put new DocumentNodeElement before DocumentTextElement', function() {
465                     var c = canvas.fromXML('<section>Alice</section>'),
466                         text = c.doc().children()[0],
467                         added = text.before({tag: 'p'}),
468                         children = c.doc().children();
469
470                     expect(children.length).to.equal(2);
471                     expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
472                     expect(children[0].sameNode(added)).to.be.true;
473                     expect(children[1]).to.be.instanceOf(documentElement.DocumentTextElement);
474                     expect(children[1].getText()).to.equal('Alice');
475                 });
476
477                 it('can divide DocumentTextElement with a new DocumentNodeElement', function() {
478                     var c = canvas.fromXML('<section>Alice has a cat</section>'),
479                         section = c.doc(),
480                         text = section.children()[0];
481
482                     var returned = text.divide({tag: 'aside', klass: 'footnote', offset: 5}),
483                         sectionChildren = section.children(),
484                         lhsText = sectionChildren[0],
485                         rhsText = sectionChildren[2];
486
487                     expect(lhsText.getText()).to.equal('Alice');
488                     expect(returned.sameNode(sectionChildren[1]));
489                     expect(rhsText.getText()).to.equal(' has a cat');
490                 });
491
492                 it('treats dividing DocumentTextElement at the very end as appending after it', function() {
493                     var c = canvas.fromXML('<section>Alice has a cat</section>'),
494                         section = c.doc(),
495                         text = section.children()[0];
496
497                     var returned = text.divide({tag: 'aside', klass: 'footnote', offset: 15}),
498                         sectionChildren = section.children(),
499                         textElement = sectionChildren[0],
500                         nodeElement = sectionChildren[1];
501
502                     expect(sectionChildren.length).to.equal(2);
503                     expect(textElement.getText()).to.equal('Alice has a cat');
504                     expect(returned.sameNode(nodeElement)).to.be.true;
505                     expect(nodeElement.getWlxmlTag()).to.equal('aside');
506                 });
507
508                 it('treats dividing DocumentTextElement at the very beginning as appending before it', function() {
509                     var c = canvas.fromXML('<section>Alice has a cat</section>'),
510                         section = c.doc(),
511                         text = section.children()[0];
512
513                     var returned = text.divide({tag: 'aside', klass: 'footnote', offset: 0}),
514                         sectionChildren = section.children(),
515                         nodeElement = sectionChildren[0],
516                         textElement = sectionChildren[1];
517                         
518                     expect(sectionChildren.length).to.equal(2);
519                     expect(textElement.getText()).to.equal('Alice has a cat');
520                     expect(returned.sameNode(nodeElement)).to.be.true;
521                     expect(nodeElement.getWlxmlTag()).to.equal('aside');
522                 });
523             });
524
525             describe('Removing elements', function() {
526                 it('merges left and right DocumentTextElement sibling of a detached DocumentNodeElement', function() {
527                     var c = canvas.fromXML('<section>Alice<div>has</div>a cat</section>'),
528                         section = c.doc(),
529                         div = section.children()[1];
530
531                     div.detach();
532
533                     var sectionChildren = section.children(),
534                         textElement = sectionChildren[0];
535
536                     expect(sectionChildren).to.have.length(1);
537                     expect(textElement.getText()).to.equal('Alicea cat');
538                 });
539             });
540
541             describe('Splitting text', function() {
542                 
543                 it('splits DocumentTextElement\'s parent into two DocumentNodeElements of the same type', function() {
544                     var c = canvas.fromXML('<section><header>Some header</header></section>'),
545                         section = c.doc(),
546                         text = section.children()[0].children()[0];
547
548                     var returnedValue = text.split({offset: 5});
549                     expect(section.children().length).to.equal(2, 'section has two children');
550                     
551                     var header1 = section.children()[0];
552                     var header2 = section.children()[1];
553
554                     expect(header1.getWlxmlTag()).to.equal('header', 'first section child represents wlxml header');
555                     expect(header1.children().length).to.equal(1, 'first header has one text child');
556                     expect(header1.children()[0].getText()).to.equal('Some ', 'first header has correct content');
557                     expect(header2.getWlxmlTag()).to.equal('header', 'second section child represents wlxml header');
558                     expect(header2.children().length).to.equal(1, 'second header has one text child');
559                     expect(header2.children()[0].getText()).to.equal('header', 'second header has correct content');
560
561                     expect(returnedValue.first.sameNode(header1)).to.equal(true, 'first node returnde');
562                     expect(returnedValue.second.sameNode(header2)).to.equal(true, 'second node returned');
563                 });
564
565                 it('leaves empty copy of DocumentNodeElement if splitting at the very beginning', function() {
566                         var c = canvas.fromXML('<section><header>Some header</header></section>'),
567                         section = c.doc(),
568                         text = section.children()[0].children()[0];
569
570                         text.split({offset: 0});
571                         
572                         var header1 = section.children()[0];
573                         var header2 = section.children()[1];
574
575                         expect(header1.children().length).to.equal(0);
576                         expect(header2.children()[0].getText()).to.equal('Some header');
577                 });
578
579                 it('leaves empty copy of DocumentNodeElement if splitting at the very end', function() {
580                         var c = canvas.fromXML('<section><header>Some header</header></section>'),
581                         section = c.doc(),
582                         text = section.children()[0].children()[0];
583
584                         text.split({offset: 11});
585                         
586                         var header1 = section.children()[0];
587                         var header2 = section.children()[1];
588
589                         expect(header1.children()[0].getText()).to.equal('Some header');
590                         expect(header2.children().length).to.equal(0);
591                 });
592
593                 it('keeps DocumentTextElement\'s parent\'s children elements intact', function() {
594                     var c = canvas.fromXML('\
595                             <section>\
596                                 <header>\
597                                     A <span>fancy</span> and <span>nice</span> header\
598                                 </header>\
599                             </section>'),
600                         section = c.doc(),
601                         header = section.children()[0],
602                         textAnd = header.children()[2];
603
604                     textAnd.split({offset: 2});
605                     
606                     var sectionChildren = section.children();
607                     expect(sectionChildren.length).to.equal(2, 'Section has two children');
608                     expect(sectionChildren[0].getWlxmlTag()).to.equal('header', 'First section element is a wlxml header');
609                     expect(sectionChildren[1].getWlxmlTag()).to.equal('header', 'Second section element is a wlxml header');
610
611                     var firstHeaderChildren = sectionChildren[0].children();
612                     expect(firstHeaderChildren.length).to.equal(3, 'First header has three children');
613                     expect(firstHeaderChildren[0].getText()).to.equal('A ', 'First header starts with a text');
614                     expect(firstHeaderChildren[1].getWlxmlTag()).to.equal('span', 'First header has span in the middle');
615                     expect(firstHeaderChildren[2].getText()).to.equal(' a', 'First header ends with text');
616
617                     var secondHeaderChildren = sectionChildren[1].children();
618                     expect(secondHeaderChildren.length).to.equal(3, 'Second header has three children');
619                     expect(secondHeaderChildren[0].getText()).to.equal('nd ', 'Second header starts with text');
620                     expect(secondHeaderChildren[1].getWlxmlTag()).to.equal('span', 'Second header has span in the middle');
621                     expect(secondHeaderChildren[2].getText()).to.equal(' header', 'Second header ends with text');
622                 });
623             });
624
625             describe('wrapping', function() {
626                 it('wraps DocumentNodeElement', function() {
627                     var c = canvas.fromXML('<section><div></div></section>'),
628                         div = c.doc().children()[0];
629                     
630                     var returned = div.wrapWithNodeElement({tag: 'header', klass: 'some.class'}),
631                         parent = div.parent(),
632                         parent2 = c.doc().children()[0];
633
634                     expect(returned.sameNode(parent)).to.be.true;
635                     expect(returned.sameNode(parent2)).to.be.true;
636                     expect(returned.getWlxmlTag()).to.equal('header');
637                     expect(returned.getWlxmlClass()).to.equal('some.class');
638                 });
639                 it('wraps DocumentTextElement', function() {
640                     var c = canvas.fromXML('<section>Alice</section>'),
641                         text = c.doc().children()[0];
642                     
643                     var returned = text.wrapWithNodeElement({tag: 'header', klass: 'some.class'}),
644                         parent = text.parent(),
645                         parent2 = c.doc().children()[0];
646
647                     expect(returned.sameNode(parent)).to.be.true;
648                     expect(returned.sameNode(parent2)).to.be.true;
649                     expect(returned.getWlxmlTag()).to.equal('header');
650                     expect(returned.getWlxmlClass()).to.equal('some.class');
651                 });
652                 
653                 describe('wrapping part of DocumentTextElement', function() {
654                     [{start: 5, end: 12}, {start: 12, end: 5}].forEach(function(offsets) {
655                         it('wraps in the middle ' + offsets.start + '/' + offsets.end, function() {
656                             var c = canvas.fromXML('<section>Alice has a cat</section>'),
657                                 text = c.doc().children()[0];
658                             
659                             var returned = text.wrapWithNodeElement({tag: 'header', klass: 'some.class', start: offsets.start, end: offsets.end}),
660                                 children = c.doc().children();
661
662                             expect(children.length).to.equal(3);
663                             
664                             expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
665                             expect(children[0].getText()).to.equal('Alice');
666
667                             expect(children[1].sameNode(returned)).to.be.true;
668                             expect(returned.getWlxmlTag()).to.equal('header');
669                             expect(returned.getWlxmlClass()).to.equal('some.class');
670                             expect(children[1].children().length).to.equal(1);
671                             expect(children[1].children()[0].getText()).to.equal(' has a ');
672
673                             expect(children[2]).to.be.instanceOf(documentElement.DocumentTextElement);
674                             expect(children[2].getText()).to.equal('cat');
675                         });
676                     });
677
678                     it('wraps whole text inside DocumentTextElement if offsets span entire content', function() {
679                          var c = canvas.fromXML('<section>Alice has a cat</section>'),
680                              text = c.doc().children()[0];
681                          
682                          var returned = text.wrapWithNodeElement({tag: 'header', klass: 'some.class', start: 0, end: 15}),
683                              children = c.doc().children();
684
685                          expect(children.length).to.equal(1);
686                          expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
687                          expect(children[0].children()[0].getText()).to.equal('Alice has a cat');
688                     });
689                 });
690
691                 it('wraps text spanning multiple sibling DocumentTextNodes', function() {
692                     var c = canvas.fromXML('<section>Alice has a <span>small</span> cat</section>'),
693                         section = c.doc(),
694                         wrapper = c.wrapText({
695                             inside: section, 
696                             _with: {tag: 'span', klass: 'some.class'},
697                             offsetStart: 6,
698                             offsetEnd: 4,
699                             textNodeIdx: [0,2]
700                         });
701
702                     expect(section.children().length).to.equal(2);
703                     expect(section.children()[0]).to.be.instanceOf(documentElement.DocumentTextElement);
704                     expect(section.children()[0].getText()).to.equal('Alice ');
705
706                     var wrapper2 = section.children()[1];
707                     expect(wrapper2.sameNode(wrapper)).to.be.true;
708
709                     var wrapperChildren = wrapper.children();
710                     expect(wrapperChildren.length).to.equal(3);
711                     expect(wrapperChildren[0].getText()).to.equal('has a ');
712
713                     expect(wrapperChildren[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
714                     expect(wrapperChildren[1].children().length).to.equal(1);
715                     expect(wrapperChildren[1].children()[0].getText()).to.equal('small');
716
717                     expect(wrapperChildren[2].getText()).to.equal(' cat');
718                 });
719
720                 it('wraps multiple sibling Elements', function() {
721                     var c = canvas.fromXML('<section>Alice<div>has</div><div>a cat</div></section>'),
722                         section = c.doc(),
723                         aliceText = section.children()[0],
724                         firstDiv = section.children()[1],
725                         lastDiv = section.children()[section.children().length -1];
726
727                     var returned = c.wrapElements({
728                             element1: aliceText,
729                             element2: lastDiv,
730                             _with: {tag: 'header'}
731                         });
732
733                     var sectionChildren = section.children(),
734                         header = sectionChildren[0],
735                         headerChildren = header.children();
736
737                     expect(sectionChildren).to.have.length(1);
738                     expect(header.sameNode(returned)).to.equal(true, 'wrapper returned');
739                     expect(headerChildren).to.have.length(3);
740                     expect(headerChildren[0].sameNode(aliceText)).to.equal(true, 'first node wrapped');
741                     expect(headerChildren[1].sameNode(firstDiv)).to.equal(true, 'second node wrapped');
742                     expect(headerChildren[2].sameNode(lastDiv)).to.equal(true, 'third node wrapped');
743                 });
744                 it('wraps multiple sibling Elements - middle case', function() {
745                     var c = canvas.fromXML('<section><div></div>div></div><div></div><div></div></section>'),
746                         section = c.doc(),
747                         div1 = section.children()[0],
748                         div2 = section.children()[1],
749                         div3 = section.children()[2],
750                         div4 = section.children()[3];
751
752                     var returned = c.wrapElements({
753                             element1: div2,
754                             element2: div3,
755                             _with: {tag: 'header'}
756                         });
757
758                     var sectionChildren = section.children(),
759                         header = sectionChildren[1],
760                         headerChildren = header.children();
761
762                     expect(sectionChildren).to.have.length(3);
763                     expect(headerChildren).to.have.length(2);
764                     expect(headerChildren[0].sameNode(div2)).to.equal(true, 'first node wrapped');
765                     expect(headerChildren[1].sameNode(div3)).to.equal(true, 'second node wrapped');
766                 });
767             });
768
769             describe('unwrapping DocumentTextElement from its parent DocumentNodeElement if it\'s its only child', function() {
770                 it('unwraps text element from its parent and stays between its old parent siblings', function() {
771                     var c = canvas.fromXML('<section><div>Alice</div><div>has</div><div>a cat</div></section>'),
772                         section = c.doc(),
773                         sectionChildren = section.children(),
774                         divAlice = sectionChildren[0],
775                         divHas = sectionChildren[1],
776                         textHas = divHas.children()[0],
777                         divCat = sectionChildren[2];
778
779                     var newTextContainer = textHas.unwrap(),
780                         sectionChildren = section.children();
781
782                     expect(sectionChildren[0].sameNode(divAlice)).to.equal(true, 'divAlice ok');
783                     expect(newTextContainer.sameNode(section)).to.equal(true, 'unwrap returns new text parent DocumentNodeElement');
784                     expect(sectionChildren[1].getText()).to.equal('has');
785                     expect(sectionChildren[2].sameNode(divCat)).to.equal(true, 'divCat ok');
786
787                 });
788                 it('unwraps and join with its old parent adjacent text elements ', function() {
789                     var c = canvas.fromXML('<section>Alice <span>has a</span> cat</section>'),
790                     section = c.doc(),
791                     text = section.children()[1].children()[0];
792
793                     var newTextContainer = text.unwrap();
794
795                     expect(section.children().length).to.equal(1, 'section has one child');
796                     expect(section.children()[0].getText()).to.equal('Alice has a cat');
797                     expect(newTextContainer.sameNode(c.doc())).to.equal(true, 'unwrap returns new text parent DocumentNodeElement');
798                 });
799
800                 it('unwraps text element from its parent - first child case', function() {
801                     var c = canvas.fromXML('<section><span class="uri">Some</span>text</section>'),
802                         section = c.doc(),
803                         span = section.children()[0];
804
805                     span.children()[0].unwrap();
806
807                     var sectionChildren = section.children();
808
809                     expect(sectionChildren).to.have.length(1);
810                     expect(sectionChildren[0].getText()).to.equal('Sometext');
811                 });
812             });
813         });
814
815         describe('Lists api', function() {
816             describe('creating lists', function() {
817                 it('allows creation of a list from existing sibling DocumentElements', function() {
818                     var c = canvas.fromXML('\
819                         <section>\
820                             Alice\
821                             <div>has</div>\
822                             a\
823                             <div>cat</div>\
824                         </section>'),
825                         section = c.doc(),
826                         textHas = section.children()[1],
827                         divA = section.children()[2]
828                     
829                     c.list.create({element1: textHas, element2: divA});
830
831                     expect(section.children().length).to.equal(3, 'section has three child elements');
832
833                     var child1 = section.children()[0],
834                         list = section.children()[1],
835                         child3 = section.children()[2];
836
837                     expect(child1.getText()).to.equal('Alice');
838                     expect(list.is('list')).to.equal(true, 'second child is a list');
839                     expect(list.children().length).to.equal(2, 'list contains two elements');
840                     list.children().forEach(function(child) {
841                         expect(child.getWlxmlClass()).to.equal('item', 'list childs have wlxml class of item');
842                     });
843                     expect(child3.children()[0].getText()).to.equal('cat');
844                 });
845                 
846                 it('allows creating nested list from existing sibling list items', function() {
847                     var c = canvas.fromXML('\
848                         <section>\
849                             <div class="list-items">\
850                                 <div class="item">A</div>\
851                                 <div class="item">B</div>\
852                                 <div class="item">C</div>\
853                                 <div class="item">D</div>\
854                             </div>\
855                         </section>'),
856                         outerList = c.doc().children()[0],
857                         itemB = outerList.children()[1],
858                         itemC = outerList.children()[2];
859
860
861                         c.list.create({element1: itemB, element2: itemC});
862
863                     var outerListItems = outerList.children(),
864                         innerList = outerListItems[1].children()[0],
865                         innerListItems = innerList.children();
866
867                     expect(outerListItems.length).to.equal(3, 'outer list has three items');
868                     expect(outerListItems[0].children()[0].getText()).to.equal('A', 'first outer item ok');
869                     expect(outerListItems[1].getWlxmlClass()).to.equal('item', 'inner list is wrapped by item element');
870
871                     expect(innerList.is('list')).to.equal(true, 'inner list created');
872                     expect(innerListItems.length).to.equal(2, 'inner list has two items');
873                     expect(innerListItems[0].children()[0].getText()).to.equal('B', 'first inner item ok');
874                     expect(innerListItems[1].children()[0].getText()).to.equal('C', 'second inner item ok');
875
876                     expect(outerListItems[2].children()[0].getText()).to.equal('D', 'last outer item ok');
877
878                 });
879
880             });
881
882             describe('extracting list items', function() {
883                 it('creates two lists with extracted items in the middle if extracting from the middle of the list', function() {
884                     var c = canvas.fromXML('\
885                         <section>\
886                             <div class="list.items">\
887                                 <div class="item">0</div>\
888                                 <div class="item">1</div>\
889                                 <div class="item">2</div>\
890                                 <div class="item">3</div>\
891                             </div>\
892                         </section>'),
893                         list = c.doc().children()[0],
894                         item1 = list.children()[1],
895                         item2 = list.children()[2];
896
897                     c.list.extractItems({element1: item1, element2: item2});
898
899                     var section = c.doc(),
900                         list1 = section.children()[0],
901                         oldItem1 = section.children()[1],
902                         oldItem2 = section.children()[2],
903                         list2 = section.children()[3];
904
905                     expect(section.children().length).to.equal(4, 'section contains four children');
906                     
907                     expect(list1.is('list')).to.equal(true, 'first section child is a list');
908                     expect(list1.children().length).to.equal(1, 'first list has one child');
909                     expect(list1.children()[0].children()[0].getText()).to.equal('0', 'first item of the first list is a first item of the original list');
910
911                     expect(oldItem1.children()[0].getText()).to.equal('1', 'first item got extracted');
912                     expect(oldItem1.getWlxmlClass() === undefined).to.equal(true, 'first extracted element has no wlxml class');
913
914                     expect(oldItem2.children()[0].getText()).to.equal('2', 'second item got extracted');
915                     expect(oldItem2.getWlxmlClass() === undefined).to.equal(true, 'second extracted element has no wlxml class');
916
917                     expect(list2.is('list')).to.equal(true, 'last section child is a list');
918                     expect(list2.children().length).to.equal(1, 'second list has one child');
919                     expect(list2.children()[0].children()[0].getText()).to.equal('3', 'first item of the second list is a last item of the original list');
920                 });
921
922                 it('puts extracted items above the list if starting item is the first one', function() {
923                     var c = canvas.fromXML('\
924                         <section>\
925                             <div class="list.items">\
926                                 <div class="item">0</div>\
927                                 <div class="item">1</div>\
928                                 <div class="item">2</div>\
929                             </div>\
930                         </section>'),
931                         list = c.doc().children()[0],
932                         item1 = list.children()[0],
933                         item2 = list.children()[1],
934                         item3 = list.children()[2];
935
936                     c.list.extractItems({element1: item1, element2: item2});
937
938                     var section = c.doc(),
939                         oldItem1 = section.children()[0],
940                         oldItem2 = section.children()[1],
941                         newList = section.children()[2];
942
943                     expect(section.children().length).to.equal(3, 'section has three children');
944                     expect(oldItem1.children()[0].getText()).to.equal('0', 'first item extracted');
945                     expect(oldItem2.children()[0].getText()).to.equal('1', 'second item extracted');
946                     expect(newList.is('list')).to.equal(true, 'list lies below extracted item');
947                     expect(newList.children().length).to.equal(1, 'list has now one child');
948                 });
949
950                 it('puts extracted items below the list if ending item is the last one', function() {
951                     var c = canvas.fromXML('\
952                         <section>\
953                             <div class="list.items">\
954                                 <div class="item">0</div>\
955                                 <div class="item">1</div>\
956                                 <div class="item">2</div>\
957                             </div>\
958                         </section>'),
959                         list = c.doc().children()[0],
960                         item1 = list.children()[0],
961                         item2 = list.children()[1],
962                         item3 = list.children()[2];
963
964                     c.list.extractItems({element1: item2, element2: item3});
965
966                     var section = c.doc(),
967                         oldItem1 = section.children()[1],
968                         oldItem2 = section.children()[2],
969                         newList = section.children()[0];
970
971                     expect(section.children().length).to.equal(3, 'section has three children');
972                     expect(oldItem1.children()[0].getText()).to.equal('1', 'first item extracted');
973                     expect(oldItem2.children()[0].getText()).to.equal('2', 'second item extracted');
974                     expect(newList.is('list')).to.equal(true, 'list lies above extracted item');
975                     expect(newList.children().length).to.equal(1, 'list has now one child');
976                 });
977
978                 it('removes list if all its items are extracted', function() {
979                     var c = canvas.fromXML('\
980                         <section>\
981                             <div class="list.items">\
982                                 <div class="item">some item</div>\
983                                 <div class="item">some item 2</div>\
984                             </div>\
985                         </section>'),
986                         list = c.doc().children()[0],
987                         item1 = list.children()[0],
988                         item2 = list.children()[1];
989
990                     c.list.extractItems({element1: item1, element2: item2});
991
992                     var section = c.doc(),
993                         list1 = section.children()[0],
994                         oldItem1 = section.children()[0],
995                         oldItem2 = section.children()[1];
996
997                     expect(section.children().length).to.equal(2, 'section contains two children');
998                     expect(oldItem1.children()[0].getText()).to.equal('some item');
999                     expect(oldItem2.children()[0].getText()).to.equal('some item 2');
1000                 });
1001
1002                 it('creates two lists with extracted items in the middle if extracting from the middle of the list - nested case' , function() {
1003                     var c = canvas.fromXML('\
1004                         <section>\
1005                             <div class="list.items">\
1006                                 <div class="item">0</div>\
1007                                 <div class="item">\
1008                                     <div class="list.items">\
1009                                         <div class="item">1.1</div>\
1010                                         <div class="item">1.2</div>\
1011                                         <div class="item">1.3</div>\
1012                                     </div>\
1013                                 </div>\
1014                                 <div class="item">2</div>\
1015                             </div>\
1016                         </section>'),
1017                         list = c.doc().children()[0],
1018                         nestedList = list.children()[1].children()[0],
1019                         nestedListItem = nestedList.children()[1];
1020
1021                     c.list.extractItems({element1: nestedListItem, element2: nestedListItem});
1022
1023                     var section = c.doc(),
1024                         list = section.children()[0],
1025                         item1 = list.children()[0],
1026                         item2 = list.children()[1], //
1027                         item3 = list.children()[2],
1028                         item4 = list.children()[3], //
1029                         item5 = list.children()[4],
1030                         nestedList1 = item2.children()[0],
1031                         nestedList2 = item4.children()[0];
1032
1033                     expect(list.children().length).to.equal(5, 'top list has five items');
1034                     
1035                     expect(item1.children()[0].getText()).to.equal('0', 'first item ok');
1036
1037                     expect(item2.getWlxmlClass()).to.equal('item', 'first nested list is still wrapped in item element');
1038                     expect(nestedList1.children().length).to.equal(1, 'first nested list is left with one child');
1039                     expect(nestedList1.children()[0].children()[0].getText()).to.equal('1.1', 'first nested list item left alone');
1040                     
1041                     expect(item3.children()[0].getText()).to.equal('1.2', 'third item ok');
1042
1043                     expect(item4.getWlxmlClass()).to.equal('item', 'second nested list is still wrapped in item element');
1044                     expect(nestedList2.children().length).to.equal(1, 'second nested list is left with one child');
1045                     expect(nestedList2.children()[0].children()[0].getText()).to.equal('1.3', 'second nested list item left alone');
1046
1047                     expect(item5.children()[0].getText()).to.equal('2', 'last item ok');
1048                 });
1049
1050                 it('puts extracted items below the list if ending item is the last one - nested case' , function() {
1051                     var c = canvas.fromXML('\
1052                         <section>\
1053                             <div class="list.items">\
1054                                 <div class="item">0</div>\
1055                                 <div class="item">\
1056                                     <div class="list.items">\
1057                                         <div class="item">1.1</div>\
1058                                         <div class="item">1.2</div>\
1059                                         <div class="item">1.3</div>\
1060                                     </div>\
1061                                 </div>\
1062                                 <div class="item">2</div>\
1063                             </div>\
1064                         </section>'),
1065                         list = c.doc().children()[0],
1066                         nestedList = list.children()[1].children()[0],
1067                         nestedListItem1 = nestedList.children()[1],
1068                         nestedListItem2 = nestedList.children()[2];
1069
1070                     c.list.extractItems({element1: nestedListItem1, element2: nestedListItem2});
1071
1072                     var section = c.doc(),
1073                         list = section.children()[0],
1074                         item1 = list.children()[0],
1075                         item2 = list.children()[1],
1076                         item3 = list.children()[2],
1077                         item4 = list.children()[3],
1078                         item5 = list.children()[4];
1079                     nestedList = item2.children()[0];
1080
1081                     expect(list.children().length).to.equal(5, 'top list has five items');
1082                     expect(item1.children()[0].getText()).to.equal('0', 'first item ok');
1083                     expect(item2.getWlxmlClass()).to.equal('item', 'nested list is still wrapped in item element');
1084                     expect(nestedList.children().length).to.equal(1, 'nested list is left with one child');
1085                     expect(nestedList.children()[0].children()[0].getText()).to.equal('1.1', 'nested list item left alone');
1086                     expect(item3.children()[0].getText()).to.equal('1.2', 'third item ok');
1087                     expect(item4.children()[0].getText()).to.equal('1.3', 'fourth item ok');
1088                     expect(item5.children()[0].getText()).to.equal('2', 'fifth item ok');
1089                 });
1090
1091                 it('puts extracted items above the list if starting item is the first one - nested case' , function() {
1092                     var c = canvas.fromXML('\
1093                         <section>\
1094                             <div class="list.items">\
1095                                 <div class="item">0</div>\
1096                                 <div class="item">\
1097                                     <div class="list.items">\
1098                                         <div class="item">1.1</div>\
1099                                         <div class="item">1.2</div>\
1100                                         <div class="item">1.3</div>\
1101                                     </div>\
1102                                 </div>\
1103                                 <div class="item">2</div>\
1104                             </div>\
1105                         </section>'),
1106                         list = c.doc().children()[0],
1107                         nestedList = list.children()[1].children()[0],
1108                         nestedListItem1 = nestedList.children()[0],
1109                         nestedListItem2 = nestedList.children()[1];
1110
1111                     c.list.extractItems({element1: nestedListItem1, element2: nestedListItem2});
1112
1113                     var section = c.doc(),
1114                         list = section.children()[0],
1115                         item1 = list.children()[0],
1116                         item2 = list.children()[1],
1117                         item3 = list.children()[2],
1118                         item4 = list.children()[3],
1119                         item5 = list.children()[4];
1120                     nestedList = item4.children()[0];
1121
1122                     expect(list.children().length).to.equal(5, 'top list has five items');
1123                     expect(item1.children()[0].getText()).to.equal('0', 'first item ok');
1124                     expect(item2.children()[0].getText()).to.equal('1.1', 'second item ok');
1125                     expect(item3.children()[0].getText()).to.equal('1.2', 'third item ok');
1126                     
1127                     expect(item4.getWlxmlClass()).to.equal('item', 'nested list is still wrapped in item element');
1128                     expect(nestedList.children().length).to.equal(1, 'nested list is left with one child');
1129                     expect(nestedList.children()[0].children()[0].getText()).to.equal('1.3', 'nested list item left alone');
1130                     expect(item5.children()[0].getText()).to.equal('2', 'fifth item ok');
1131                 });
1132
1133                 it('removes list if all its items are extracted - nested case', function() {
1134                     var c = canvas.fromXML('\
1135                         <section>\
1136                             <div class="list.items">\
1137                                 <div class="item">0</div>\
1138                                 <div class="item">\
1139                                     <div class="list.items">\
1140                                         <div class="item">1.1</div>\
1141                                         <div class="item">1.2</div>\
1142                                     </div>\
1143                                 </div>\
1144                                 <div class="item">2</div>\
1145                             </div>\
1146                         </section>'),
1147                         list = c.doc().children()[0],
1148                         nestedList = list.children()[1].children()[0],
1149                         nestedListItem1 = nestedList.children()[0],
1150                         nestedListItem2 = nestedList.children()[1];
1151
1152                     c.list.extractItems({element1: nestedListItem1, element2: nestedListItem2});
1153
1154                     var section = c.doc(),
1155                         list = section.children()[0],
1156                         item1 = list.children()[0],
1157                         item2 = list.children()[1],
1158                         item3 = list.children()[2],
1159                         item4 = list.children()[3];
1160
1161                     expect(list.children().length).to.equal(4, 'top list has four items');
1162                     expect(item1.children()[0].getText()).to.equal('0', 'first item ok');
1163                     expect(item2.children()[0].getText()).to.equal('1.1', 'second item ok');
1164                     expect(item3.children()[0].getText()).to.equal('1.2', 'third item ok');
1165                     expect(item4.children()[0].getText()).to.equal('2', 'fourth item ok');
1166                 });
1167
1168                 it('extracts items out of outer most list when merge flag is set to false', function() {
1169                     var c = canvas.fromXML('\
1170                         <section>\
1171                             <div class="list.items">\
1172                                 <div class="item">0</div>\
1173                                 <div class="item">\
1174                                     <div class="list.items">\
1175                                         <div class="item">1.1</div>\
1176                                         <div class="item">1.2</div>\
1177                                     </div>\
1178                                 </div>\
1179                                 <div class="item">2</div>\
1180                             </div>\
1181                         </section>'),
1182                         section = c.doc(),
1183                         list = section.children()[0],
1184                         nestedList = list.children()[1].children()[0],
1185                         nestedListItem = nestedList.children()[0];
1186
1187                     var test = c.list.extractItems({element1: nestedListItem, element2: nestedListItem, merge: false});
1188
1189                     expect(test).to.equal(true, 'extraction status ok');
1190
1191                     var sectionChildren = section.children(),
1192                         extractedItem = sectionChildren[1];
1193
1194                     expect(sectionChildren.length).to.equal(3, 'section has three children');
1195                     expect(sectionChildren[0].is('list')).to.equal(true, 'first child is a list');
1196
1197                     expect(extractedItem.getWlxmlTag()).to.equal('div', 'extracted item is a wlxml div');
1198                     expect(extractedItem.getWlxmlClass()).to.equal(undefined, 'extracted item has no wlxml class');
1199                     expect(extractedItem.children()[0].getText()).to.equal('1.1', 'extracted item ok');
1200                     expect(sectionChildren[2].is('list')).to.equal(true, 'second child is a list');
1201                 });
1202             });
1203         });
1204
1205     });
1206
1207     describe('Cursor', function() {
1208
1209         var getSelection;
1210
1211         var findTextNode = function(inside, text) {
1212             var nodes = inside.find(':not(iframe)').addBack().contents().filter(function() {
1213                 return this.nodeType === Node.TEXT_NODE && this.data === text;
1214             });
1215             if(nodes.length)
1216                 return nodes[0];
1217             return null;
1218         }
1219
1220         beforeEach(function() {
1221             getSelection = sinon.stub(window, 'getSelection');
1222         });
1223
1224         afterEach(function() {
1225             getSelection.restore();
1226         });
1227
1228         it('returns position when browser selection collapsed', function() {
1229             var c = canvas.fromXML('<section>Alice has a cat</section>'),
1230                 dom = c.doc().dom(),
1231                 text = findTextNode(dom, 'Alice has a cat');
1232
1233             expect(text.nodeType).to.equal(Node.TEXT_NODE, 'correct node selected');
1234             expect($(text).text()).to.equal('Alice has a cat');
1235
1236             getSelection.returns({
1237                 anchorNode: text,
1238                 focusNode: text,
1239                 anchorOffset: 5,
1240                 focusOffset: 5,
1241                 isCollapsed: true
1242             });
1243             var cursor = c.getCursor(),
1244                 position = cursor.getPosition();
1245
1246             expect(cursor.isSelecting()).to.equal(false, 'cursor is not selecting anything');
1247             expect(position.element.getText()).to.equal('Alice has a cat');
1248             expect(position.offset).to.equal(5);
1249             expect(position.offsetAtEnd).to.equal(false, 'offset is not at end');
1250
1251             getSelection.returns({
1252                 anchorNode: text,
1253                 focusNode: text,
1254                 anchorOffset: 15,
1255                 focusOffset: 15,
1256                 isCollapsed: true
1257             });
1258
1259             expect(cursor.getPosition().offsetAtEnd).to.equal(true, 'offset at end');
1260         });
1261
1262         it('returns boundries of selection when browser selection not collapsed', function() {
1263             var c = canvas.fromXML('<section>Alice <span>has</span> a <span>big</span> cat</section>'),
1264                 dom = c.doc().dom(),
1265                 text = {
1266                     alice: findTextNode(dom, 'Alice '),
1267                     has: findTextNode(dom, 'has'),
1268                     cat: findTextNode(dom, ' cat')
1269                 },
1270                 cursor = c.getCursor(),
1271                 aliceElement = c.getDocumentElement(text.alice),
1272                 catElement = c.getDocumentElement(text.cat);
1273
1274
1275                 [
1276                     {focus: text.alice, focusOffset: 1, anchor: text.cat,   anchorOffset: 2, selectionAnchor: catElement},
1277                     {focus: text.cat,   focusOffset: 2, anchor: text.alice, anchorOffset: 1, selectionAnchor: aliceElement}
1278                 ].forEach(function(s, idx) {
1279                     getSelection.returns({isColapsed: false, anchorNode: s.anchor, anchorOffset: s.anchorOffset, focusNode: s.focus, focusOffset: s.focusOffset});
1280
1281                     var selectionStart = cursor.getSelectionStart(),
1282                         selectionEnd = cursor.getSelectionEnd(),
1283                         selectionAnchor = cursor.getSelectionAnchor();
1284
1285                     expect(cursor.isSelecting()).to.equal(true, 'cursor is selecting');
1286                     expect(selectionStart.element.sameNode(aliceElement)).to.equal(true, '"Alice" is the start of the selection ' + idx);
1287                     expect(selectionStart.offset).to.equal(1, '"Alice" offset ok' + idx);
1288                     expect(selectionEnd.element.sameNode(catElement)).to.equal(true, '"Cat" is the start of the selection ' + idx);
1289                     expect(selectionEnd.offset).to.equal(2, '"Cat" offset ok' + idx);
1290                     expect(selectionAnchor.element.sameNode(s.selectionAnchor)).to.equal(true, 'anchor ok');
1291                     expect(selectionAnchor.offset).to.equal(s.anchorOffset, 'anchor offset ok');
1292                 });
1293         });
1294
1295         it('recognizes when browser selection boundries lies in sibling DocumentTextElements', function() {
1296             var c = canvas.fromXML('<section>Alice <span>has</span> a <span>big</span> cat</section>'),
1297                 dom = c.doc().dom(),
1298                 text = {
1299                     alice: findTextNode(dom, 'Alice '),
1300                     has: findTextNode(dom, 'has'),
1301                     a: findTextNode(dom, ' a '),
1302                     big: findTextNode(dom, 'big'),
1303                     cat: findTextNode(dom, ' cat'),
1304                 },
1305                 cursor = c.getCursor();
1306
1307             expect($(text.alice).text()).to.equal('Alice ');
1308             expect($(text.has).text()).to.equal('has');
1309             expect($(text.a).text()).to.equal(' a ');
1310             expect($(text.big).text()).to.equal('big');
1311             expect($(text.cat).text()).to.equal(' cat');
1312
1313             getSelection.returns({anchorNode: text.alice, focusNode: text.a});
1314             expect(cursor.isSelectingSiblings()).to.equal(true, '"Alice" and "a" are children');
1315
1316             getSelection.returns({anchorNode: text.alice, focusNode: text.cat});
1317             expect(cursor.isSelectingSiblings()).to.equal(true, '"Alice" and "cat" are children');
1318
1319             getSelection.returns({anchorNode: text.alice, focusNode: text.has});
1320             expect(cursor.isSelectingSiblings()).to.equal(false, '"Alice" and "has" are not children');
1321
1322             getSelection.returns({anchorNode: text.has, focusNode: text.big});
1323             expect(cursor.isSelectingSiblings()).to.equal(false, '"has" and "big" are not children');
1324             
1325         })
1326     });
1327
1328     describe('Serializing document to WLXML', function() {
1329         it('keeps document intact when no changes have been made', function() {
1330             var xmlIn = '<section>Alice<div>has</div>a <span class="uri" meta-uri="http://cat.com">cat</span>!</section>',
1331                 c = canvas.fromXML(xmlIn),
1332                 xmlOut = c.toXML();
1333
1334             var parser = new DOMParser(),
1335                 input = parser.parseFromString(xmlIn, "application/xml").childNodes[0],
1336                 output = parser.parseFromString(xmlOut, "application/xml").childNodes[0];
1337             
1338             expect(input.isEqualNode(output)).to.be.true;
1339         });
1340
1341         it('keeps arbitrary node attributes intact', function() {
1342             var xmlIn = '<section a="1" xmlns:dcterms="http://purl.org/dc/terms/"></section>',
1343                 $xmlOut = $(canvas.fromXML(xmlIn).toXML());
1344
1345             expect($xmlOut.attr('a')).to.equal('1');
1346             expect($xmlOut.attr('xmlns:dcterms')).to.equal('http://purl.org/dc/terms/');
1347         });
1348
1349         it('doesn\' serialize meta attribute if its empty', function() {
1350             var c;
1351
1352             c = canvas.fromXML('<section class="uri" meta-uri="some.uri"></section>');
1353             c.doc().setWlxmlMetaAttr('uri', '');
1354             expect($(c.toXML()).attr('meta-uri')).to.equal(undefined, 'overriding attribute with zero length string');
1355
1356             c = canvas.fromXML('<section class="uri"></section>');
1357             c.doc().setWlxmlMetaAttr('uri', '');
1358             expect($(c.toXML()).attr('meta-uri')).to.equal(undefined, 'setting attribute to zero length string');
1359         });
1360
1361         describe('output xml', function() {
1362             it('keeps entities intact', function() {
1363                 var xmlIn = '<section>&lt; &gt;</section>',
1364                     c = canvas.fromXML(xmlIn),
1365                     xmlOut = c.toXML();
1366                 expect(xmlOut).to.equal(xmlIn);
1367             });
1368             it('keeps entities intact when they form html/xml', function() {
1369                 var xmlIn = '<section>&lt;abc&gt;</section>',
1370                     c = canvas.fromXML(xmlIn),
1371                     xmlOut = c.toXML();
1372                 expect(xmlOut).to.equal(xmlIn);
1373             });
1374         });
1375
1376         describe('formatting output xml', function() {
1377             /*it('keeps white spaces at the edges of input xml', function() {
1378                 var xmlIn = '  <section></section>  ',
1379                 c = canvas.fromXML(xmlIn),
1380                 xmlOut = c.toXML();
1381
1382                 expect(xmlOut.substr(4)).to.equal('   <', 'start');
1383                 expect(xmlOut.substr(-2)).to.equal('>  ', 'end');
1384             });*/
1385             it('keeps white space between XML nodes', function() {
1386                 var xmlIn = '<section>\n\n\n<div></div>\n\n\n<div></div>\n\n\n</section>',
1387                 c = canvas.fromXML(xmlIn),
1388                 xmlOut = c.toXML();
1389
1390                 var partsIn = xmlIn.split('\n\n\n'),
1391                     partsOut = xmlOut.split('\n\n\n');
1392                 
1393                 expect(partsIn).to.deep.equal(partsOut);
1394             });
1395
1396             it('keeps white space between XML nodes - inline case', function() {
1397                 var xmlIn = '<section>\n\n\n<span></span>\n\n\n<span></span>\n\n\n</section>',
1398                 c = canvas.fromXML(xmlIn);
1399                 
1400                 var xmlOut = c.toXML();
1401
1402                 var partsIn = xmlIn.split('\n\n\n'),
1403                     partsOut = xmlOut.split('\n\n\n');
1404                 
1405                 expect(partsIn).to.deep.equal(partsOut);
1406             });
1407
1408             it('keeps white space at the beginning of text', function() {
1409                 var xmlIn = '<section>    abc<div>some div</div>    abc</section>',
1410                     c = canvas.fromXML(xmlIn),
1411                     xmlOut = c.toXML();
1412
1413                 expect(xmlOut).to.equal(xmlIn);
1414             });
1415
1416             it('nests new children block elements', function() {
1417                 var c = canvas.fromXML('<section></section>');
1418     
1419                 c.doc().append({tag: 'header'});
1420
1421                 var xmlOut = c.toXML();
1422                 expect(xmlOut.split('\n  ')[0]).to.equal('<section>', 'nesting start ok');
1423                 expect(xmlOut.split('\n').slice(-1)[0]).to.equal('</section>', 'nesting end ok');
1424
1425             });
1426
1427             it('doesn\'t nest new children inline elements', function() {
1428                 var c = canvas.fromXML('<section></section>');
1429     
1430                 c.doc().append({tag: 'span'});
1431
1432                 var xmlOut = c.toXML();
1433                 expect(xmlOut).to.equal('<section><span></span></section>');
1434             });
1435
1436             it('keeps original white space at the end of text', function() {
1437                 
1438                 var xmlIn = '<header>    Some text ended with white space \
1439                 \
1440                 <span class="uri">Some text</span> some text\
1441             \
1442             </header>',
1443                     c = canvas.fromXML(xmlIn);
1444
1445             var xmlOut = c.toXML();
1446             console.log(xmlOut);
1447             expect(xmlOut).to.equal(xmlIn);
1448             });
1449
1450             it('keeps white space around text node', function() {
1451                 var xmlIn = '<section>\
1452                 <header>header1</header>\
1453                 Some text surrounded by white space\
1454                 <header>header2</header>\
1455             </section>',
1456                     c = canvas.fromXML(xmlIn);
1457
1458                 var xmlOut = c.toXML();
1459                 expect(xmlOut).to.equal(xmlIn);
1460             });
1461
1462             it('keeps white space around text node - last node case', function() {
1463                 var xmlIn = '<section>\
1464                 <header>header</header>\
1465                     \
1466                 Some text surrounded by white space\
1467                     \
1468             </section>',
1469                     c = canvas.fromXML(xmlIn);
1470
1471                 var xmlOut = c.toXML();
1472                 expect(xmlOut).to.equal(xmlIn);
1473             });
1474
1475             it('keeps white space after detaching text element', function() {
1476                 var xmlIn = '<section><header>header</header>\n\
1477                     \n\
1478                 text1\n\
1479                     \n\
1480             </section>',
1481                     expectedXmlOut = '<section><header>header</header>\n\
1482                     \n\
1483                 \n\
1484                     \n\
1485             </section>',
1486                     c = canvas.fromXML(xmlIn),
1487                     children = c.doc().children(),
1488                     text = children[children.length-1];
1489                 
1490                 expect(text.getText()).to.equal('text1');
1491
1492                 text.detach();
1493
1494                 var xmlOut = c.toXML();
1495                 expect(xmlOut).to.equal(expectedXmlOut);
1496             });
1497
1498         })
1499     })
1500 });
1501
1502
1503 });