small refactor + fix brackets
[fnpeditor.git] / src / editor / modules / documentCanvas / canvas / canvas.test.js
index 2dc24eb..028c767 100644 (file)
 define([
 define([
+'libs/jquery',
 'libs/chai',
 'libs/sinon',
 'modules/documentCanvas/canvas/canvas',
 'libs/chai',
 'libs/sinon',
 'modules/documentCanvas/canvas/canvas',
+'modules/documentCanvas/canvas/utils',
 'modules/documentCanvas/canvas/documentElement',
 'modules/documentCanvas/canvas/documentElement',
-'modules/documentCanvas/canvas/utils'
-], function(chai, sinon, canvas, documentElement, utils) {
+'wlxml/wlxml',
+], function($, chai, sinon, canvas, utils, documentElement, wlxml) {
     
 'use strict';
     
 'use strict';
+/* global describe, it, beforeEach, afterEach */
 
 var expect = chai.expect;
 
 
 var expect = chai.expect;
 
+var getCanvasFromXML = function(xml, elements) {
+    return canvas.fromXMLDocument(getDocumentFromXML(xml), elements);
+};
 
 
-describe('Canvas', function() {
+var getDocumentFromXML = function(xml) {
+    return wlxml.WLXMLDocumentFromXML(xml);
+};
 
 
+var wait = function(callback, timeout) {
+    /* globals window */
+    return window.setTimeout(callback, timeout || 0.5);
+};
 
 
 
 
-    describe('ZWS', function() {
-        var view, section, textElement;
-        
-        beforeEach(function() {
-            var c = canvas.fromXML('<section></section>');
+describe('wtf', function() {
+    it('wtf!', function() {
+        var c = getCanvasFromXML('<section>Alice</section>'),
+            doc = c.wlxmlDocument;
 
 
-            section = c.doc();
-            textElement = section.children()[0];
-            view = c.view()[0];
-            document.getElementsByTagName('body')[0].appendChild(view);
-        });
+        var txtNode = doc.root.contents()[0];
+        txtNode.wrapWith({tagName: 'header', start: 1, end: 2});
+        expect(c.doc().children().length).to.equal(3);
+    });
+});
 
 
-        afterEach(function() {
-            view.parentNode.removeChild(view);
+describe('new Canvas', function() {
+    it('abc', function() {
+        var doc = wlxml.WLXMLDocumentFromXML('<section>Alice <span>has</span> a cat!</div>'),
+            c = canvas.fromXMLDocument(doc);
+
+        expect(c.doc().children()).to.have.length(3);
+        expect(c.doc().children()[0].canvas).to.equal(c);
+        expect(c.doc().children()[0].wlxmlNode.sameNode(doc.root));
+    });
+});
+
+describe('Handling empty text nodes', function() {
+    it('puts zero width space into node with about to be remove text', function(done) {
+        var c = getCanvasFromXML('<section>Alice</section>'),
+            textElement = c.doc().children()[0];
+        textElement.setText('');
+
+        /* Wait for MutationObserver to kick in. */
+        wait(function() {
+            expect(textElement.getText({raw:true})).to.equal(utils.unicode.ZWS, 'ZWS in canvas');
+            expect(c.wlxmlDocument.root.contents()[0].getText()).to.equal('', 'empty string in a document');
+            done();
         });
         });
+    });
+});
 
 
-        var getTextContainerNode = function(textElement) {
-            return textElement.dom().contents()[0];
-        }
+describe('Handling changes to the document', function() {
+    it('replaces the whole canvas content when document root node replaced', function() {
+        var doc = getDocumentFromXML('<section></section>'),
+            c = canvas.fromXMLDocument(doc);
 
 
-        it('is set automatically on all empty DocumentTextElements', function() {
-            expect(getTextContainerNode(textElement).data).to.equal(utils.unicode.ZWS);
+        var header = doc.root.replaceWith({tagName: 'header'});
+        expect(c.doc().wlxmlNode.sameNode(header)).to.equal(true);
+    });
+});
 
 
-            var header = section.append({tag: 'header'}),
-                newText = header.append({text: ''}),
-                textNode = getTextContainerNode(textElement);
-            
-            expect(textNode.data).to.equal(utils.unicode.ZWS);
-        });
+describe('Listening to document changes', function() {
 
 
-        it('is added automatically when whole text gets deleted', function() {
-            getTextContainerNode(textElement).data = '';
-            
-            window.setTimeout(function() {
-                expect(getTextContainerNode(textElement).data).to.equal(utils.unicode.ZWS);
-            }, 0)
-            
-            var header = section.append({tag: 'header'}),
-                newText = header.append({text: 'Alice'}),
-                textNode = getTextContainerNode(newText);
-
-            expect(textNode.data).to.have.length('Alice'.length);
-            textNode.data = '';
-
-            window.setTimeout(function() {
-                expect(textNode.data).to.equal(utils.unicode.ZWS);
-            }, 0)
-        });
+    it('Handling element node moved', function() {
+        var doc = getDocumentFromXML('<section><a></a><b></b></section>'),
+            a = doc.root.contents()[0],
+            b = doc.root.contents()[1],
+            c = canvas.fromXMLDocument(doc);
+
+        a.before(b);
+        var sectionChildren = c.doc().children();
+        expect(sectionChildren.length).to.equal(2);
+        expect(sectionChildren[0].wlxmlNode.getTagName()).to.equal('b');
+        expect(sectionChildren[1].wlxmlNode.getTagName()).to.equal('a');
     });
 
     });
 
-    describe('Internal HTML representation of a DocumentNodeElement', function() {
-        it('is always a div tag', function() {
-            ['section', 'header', 'span', 'aside', 'figure'].forEach(function(tagName) {
-                var dom = canvas.fromXML('<' + tagName + '></' + tagName + '>').doc().dom();
-                expect(dom.prop('tagName')).to.equal('DIV', tagName + ' is represented as div');
-            });
-        });
-        it('has wlxml tag put into wlxml-tag attribute of its internal container', function() {
-            var dom = canvas.fromXML('<section></section>').doc().dom();
-            expect(dom.children('[document-element-content]').attr('wlxml-tag')).to.equal('section');
-        });
-        it('has wlxml class put into wlxml-class attribute of its internal containr, dots replaced with dashes', function() {
-            var dom = canvas.fromXML('<section class="some.class"></section>').doc().dom();
-            expect(dom.children('[document-element-content]').attr('wlxml-class')).to.equal('some-class');
-        });
+    it('Handling text node moved', function() {
+        var doc = getDocumentFromXML('<section><a></a>Alice</section>'),
+            a = doc.root.contents()[0],
+            textNode = doc.root.contents()[1],
+            c = canvas.fromXMLDocument(doc);
+
+        a.before(textNode);
+        var sectionChildren = c.doc().children();
+        expect(sectionChildren.length).to.equal(2);
+        expect(sectionChildren[0].getText()).to.equal('Alice');
+        expect(sectionChildren[1].wlxmlNode.getTagName()).to.equal('a');
     });
 
     });
 
-    describe('Internal HTML representation of a DocumentTextElement', function() {
-        it('is text node wrapped in a div with document-text-element attribute set', function() {
-            var dom = canvas.fromXML('<section>Alice</section>').doc().children()[0].dom();
-            expect(dom.prop('tagName')).to.equal('DIV');
-            expect(dom.attr('document-text-element')).to.equal('');
-            expect(dom.contents().length).to.equal(1);
-            expect(dom.contents()[0].nodeType).to.equal(Node.TEXT_NODE);
-            expect($(dom.contents()[0]).text()).to.equal('Alice');
-        });
+    it('Handles nodeTagChange event', function() {
+
+        var doc = wlxml.WLXMLDocumentFromXML('<section><div>Alice</div></section>'),
+            c = canvas.fromXMLDocument(doc);
+
+        doc.root.contents()[0].setTag('header');
+
+        var headerNode = doc.root.contents()[0],
+            headerElement = c.doc().children()[0];
+
+        expect(headerElement.wlxmlNode.getTagName()).to.equal('header', 'element ok');
+
+        /* Make sure we handle invalidation of reference to wlxmlNode after changing its tag */
+        expect(headerNode.getData('canvasElement').sameNode(headerElement)).to.equal(true, 'node->element');
+        expect(headerElement.wlxmlNode.sameNode(headerNode)).to.equal(true, 'element->node');
     });
 
     });
 
-    describe('basic properties', function() {
-        it('renders empty document when canvas created from empty XML', function() {
-            var c = canvas.fromXML('');
-            expect(c.doc()).to.equal(null);
-        });
+    it('Handles nodeDetached event for an empty text node', function(done) {
+        var doc = wlxml.WLXMLDocumentFromXML('<section><div>A<span>b</span></div></section>'),
+            aTextNode = doc.root.contents()[0].contents()[0],
+            aTextElement;
 
 
-        it('gives access to its document root node', function() {
-            var c = canvas.fromXML('<section></section>');
-            expect(c.doc().getWlxmlTag()).to.equal('section');
-        });
+        canvas.fromXMLDocument(doc);
+        aTextElement = utils.getElementForNode(aTextNode);
 
 
-        describe('root element', function() {
-            it('has no parent', function() {
-                var c = canvas.fromXML('<section></section>');
-                expect(c.doc().parent()).to.be.null;
-            });
-        });
+        aTextElement.setText('');
 
 
-        describe('DocumentTextElement', function() {
-            it('can have its content set', function() {
-                var c = canvas.fromXML('<section>Alice</section>'),
-                    root = c.doc(),
-                    text = root.children()[0];
-                
-                text.setText('a cat');
-                expect(root.children()[0].getText()).to.equal('a cat');
-            });
+        wait(function() {
+            var parent = aTextElement.parent();
+            expect(aTextElement.getText({raw:true})).to.equal(utils.unicode.ZWS, 'canvas represents this as empty node');
+            aTextElement.wlxmlNode.detach();
+            expect(parent.children().length).to.equal(1);
+            expect(parent.children()[0].wlxmlNode.getTagName()).to.equal('span');
+            done();
         });
         });
+    });
+});
 
 
-        describe('DocumentNodeElement', function() {
-            it('knows index of its child', function() {
-                var c = canvas.fromXML('<section><div></div><header></header><span></span></section>'),
-                    root = c.doc(),
-                    child = root.children()[1];
-                expect(root.childIndex(child)).to.equal(1);
-            });
-
-            it('knows WLXML tag it renders', function(){
-                var c = canvas.fromXML('<section></section>'),
-                    section = c.doc();
-                expect(section.getWlxmlTag()).to.equal('section', 'initial tag is section');
-                section.setWlxmlTag('header');
-                expect(section.getWlxmlTag()).to.equal('header', 'tag is changed to header');
-            });
-
-            it('knows WLXML class of a WLXML tag it renders', function(){
-                var c = canvas.fromXML('<section class="some.class.A"></section>'),
-                    section = c.doc();
-                expect(section.getWlxmlClass()).to.equal('some.class.A');
-                section.setWlxmlClass('some.class.B');
-                expect(section.getWlxmlClass()).to.equal('some.class.B');
-                section.setWlxmlClass(null);
-                expect(section.getWlxmlClass()).to.be.undefined;
-            });
-
-
-
-            describe('element has meta attributes', function() {
-                it('can change its meta attributes', function() {
-                    var c = canvas.fromXML('<section><span class="uri" meta-uri="someuri"></span></section>'),
-                    span = c.doc().children()[0];
-                    
-                    expect(span.getWlxmlMetaAttr('uri')).to.equal('someuri');
-                    span.setWlxmlMetaAttr('uri', 'otheruri');
-                    expect(span.getWlxmlMetaAttr('uri')).to.equal('otheruri');
-                });
-
-                it('changes its meta attributes with class change', function() {
-                    var c = canvas.fromXML('<section><span class="uri" meta-uri="someuri"></span></section>'),
-                    span = c.doc().children()[0];
-                    
-                    expect(span.getWlxmlMetaAttr('uri')).to.equal('someuri');
-                    span.setWlxmlClass('author');
-                    expect(span.getWlxmlMetaAttr('uri')).to.be.undefined;
-                });
-
-                it('keeps meta attribute value on class change if a new class has this attribute', function() {
-                    var c = canvas.fromXML('<section><span class="uri" meta-uri="someuri"></span></section>'),
-                    span = c.doc().children()[0];
-                    span.setWlxmlClass('uri.some.subclass');
-                    expect(span.getWlxmlMetaAttr('uri')).to.equal('someuri');
-                });
-            });
-        });
+describe('Displaying span nodes', function() {
+    it('inlines a span element with a text', function() {
+        var c = getCanvasFromXML('<section><span>Alice</span></section>'),
+            spanElement = c.doc().children()[0];
+        expect(spanElement.isBlock()).to.equal(false);
+    });
+    it('renders non-span element as a block', function() {
+        var c = getCanvasFromXML('<section><span></span></section>'),
+            element = c.doc().children()[0],
+            node = element.wlxmlNode;
+
+        expect(element.isBlock()).to.equal(false, 'initially inline');
+        node = node.setTag('div');
+        expect(node.getData('canvasElement').isBlock()).to.equal(true, 'block');
+    });
 
 
-        it('returns DocumentNodeElement instance from HTMLElement', function() {
-            var c = canvas.fromXML('<section></section>'),
-                htmlElement = c.doc().dom().get(0),
-                element = c.getDocumentElement(htmlElement);
-            expect(element).to.be.instanceOf(documentElement.DocumentNodeElement);
-            expect(element.sameNode(c.doc()));
-        });
+    it('inlines a span element if its block content gets removed', function() {
+        var c = getCanvasFromXML('<section><span>Alice <div>has</div> a cat!</span></section>'),
+            spanElement = c.doc().children()[0],
+            divNode = spanElement.wlxmlNode.contents()[1];
+
+        expect(spanElement.isBlock()).to.equal(true, 'initially a block');
+        divNode.detach();
+        expect(spanElement.isBlock()).to.equal(false, 'inlined after removing inner block');
         
         
-        it('returns DocumentTextElement instance from Text Node', function() {
-            var c = canvas.fromXML('<section>Alice</section>'),
-                aliceElement = c.doc().children()[0],
-                textNode = aliceElement.dom().contents()[0],
-                element = c.getDocumentElement(textNode);
+        spanElement.wlxmlNode.append({tagName: 'div'});
 
 
-            expect(textNode.nodeType).to.equal(Node.TEXT_NODE, 'text node selected');
-            expect($(textNode).text()).to.equal('Alice');
+        expect(spanElement.isBlock()).to.equal(true, 'block again after bringing back inner block');
+    });
 
 
-            expect(element).to.be.instanceOf(documentElement.DocumentTextElement);
-            expect(element.sameNode(c.doc().children()[0]));
-        });
+    it('keeps showing element as a block after changing its node tag to span if it contains elements of non-span nodes', function() {
+        var c = getCanvasFromXML('<section><div><div></div></div></section>'),
+            outerDivElement = c.doc().children()[0],
+            outerDivNode = outerDivElement.wlxmlNode;
+        outerDivNode = outerDivNode.setTag('span');
+        expect(c.doc().children()[0].isBlock()).to.equal(true);
     });
     });
+});
+
+
+describe('Default document changes handling', function() {
+    it('handles added node', function() {
+        var c = getCanvasFromXML('<section></section>');
+        c.wlxmlDocument.root.append({tagName:'div'});
+        expect(c.doc().children().length).to.equal(1);
+        c.wlxmlDocument.root.prepend({tagName:'div'});
+        expect(c.doc().children().length).to.equal(2);
 
 
+        var node = c.wlxmlDocument.root.contents()[1];
+        node.before({tagName: 'div'});
+        expect(c.doc().children().length).to.equal(3);
+        node.after({tagName: 'div'});
+        expect(c.doc().children().length).to.equal(4);
+    });
+
+    it('handles attribute value change for a class attribute', function() {
+        var c = getCanvasFromXML('<section></section>');
+        c.wlxmlDocument.root.setAttr('class', 'test');
+        expect(c.doc().wlxmlNode.getClass()).to.equal('test');
+    });
 
 
+    it('handles detached node', function() {
+        var c = getCanvasFromXML('<section><div></div></section>');
+        c.wlxmlDocument.root.contents()[0].detach();
+        expect(c.doc().children().length).to.equal(0);
+    });
 
 
-    describe('document representation api', function() {
-        describe('document root element', function() {
-            var c = canvas.fromXML('<section></section>');
-            it('exists', function() {
-                expect(c.doc()).to.be.instanceOf(documentElement.DocumentElement);
-            });
-            it('is of type DocumentNodeElement', function() {
-                expect(c.doc()).to.be.instanceOf(documentElement.DocumentNodeElement);
-            });
+    it('handles moved node', function() {
+        var doc = getDocumentFromXML('<section><c></c><a></a><b></b></section>'),
+            c = doc.root.contents()[0],
+            a = doc.root.contents()[1],
+            b = doc.root.contents()[2],
+            cv = canvas.fromXMLDocument(doc);
+
+        a.document.transaction(function() {
+            a.before(b); // => cab
+            b.after(c); // => bca
+        }, {
+            error: function(e) {throw e;}
         });
 
         });
 
-        describe('DocumentElements comparison', function() {
-            it('reports dwo DocumentElements to be the same when they represent the same wlxml document element', function() {
-                var c = canvas.fromXML('<section><div></div><div></div></section>'),
-                    first_div1 = c.doc().children()[0],
-                    first_div2 = c.doc().children()[0],
-                    second_div = c.doc().children()[1];
-                expect(first_div1.sameNode(first_div1)).to.be.true;
-                expect(first_div1.sameNode(first_div2)).to.be.true;
-                expect(first_div1.sameNode(second_div)).to.be.false;
-            });
+        var sectionChildren = cv.doc().children();
+        expect(sectionChildren.length).to.equal(3);
+        expect(sectionChildren[0].wlxmlNode.getTagName()).to.equal('b');
+        expect(sectionChildren[1].wlxmlNode.getTagName()).to.equal('c');
+        expect(sectionChildren[2].wlxmlNode.getTagName()).to.equal('a');
+    });
+
+    it('handles moving text node to another parent', function() {
+        var c = getCanvasFromXML('<section>Alice<div><span>has</span></div>a cat.</section>'),
+            doc = c.wlxmlDocument,
+            text = doc.root.contents()[0],
+            div = doc.root.contents()[1];
+        
+        div.append(text);
+        
+        var sectionChildren = c.doc().children();
+        expect(sectionChildren.length).to.equal(2);
+        expect(sectionChildren[0].wlxmlNode.sameNode(div)).to.equal(true);
+        expect(sectionChildren[1].getText()).to.equal('a cat.');
+
+        expect(div.contents().length).to.equal(2);
+        expect(div.contents()[0].getTagName()).to.equal('span');
+        expect(div.contents()[1].getText()).to.equal('Alice');
+    });
+
+    it('handles change in a text node', function() {
+        var c = getCanvasFromXML('<section>Alice</section>');
+        c.wlxmlDocument.root.contents()[0].setText('cat');
+        expect(c.doc().children()[0].getText()).to.equal('cat');
+    });
+
+    describe('Regression tests', function() {
+        it('handles moving node after its next neighbour correctly', function() {
+            var c = getCanvasFromXML('<section><a></a><b></b></section>'),
+                doc = c.wlxmlDocument,
+                a = doc.root.contents()[0],
+                b = doc.root.contents()[1];
+            b.after(a);
+            var sectionChildren = c.doc().children();
+            expect(sectionChildren[0].wlxmlNode.getTagName()).to.equal('b');
+            expect(sectionChildren[1].wlxmlNode.getTagName()).to.equal('a');
         });
         });
+    });
+});
+    
+describe('Custom elements based on wlxml class attribute', function() {
+    it('allows custom rendering', function() {
+        var prototype = $.extend({}, documentElement.DocumentNodeElement.prototype, {
+                init: function() {
+                    this._container().append('<test></test>');
+                }
+            }),
+            c = getCanvasFromXML('<section><div class="testClass"></div></section>', [
+            {tag: 'div', klass: 'testClass', prototype: prototype}
+        ]);
+
+        expect(c.doc().children()[0]._container().children('test').length).to.equal(1); // @!
+    });
 
 
-        describe('traversing', function() {
-            it('reports element nodes', function() {
-                var c = canvas.fromXML('<section><div></div></section>'),
-                    children = c.doc().children();
-                expect(children.length).to.equal(1);
-                expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
-
-                c = canvas.fromXML('<section><div></div><div></div></section>'),
-                    children = c.doc().children();
-                expect(children.length).to.equal(2);
-                expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
-                expect(children[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
-            });
-            
-            it('reports text nodes', function() {
-                var c = canvas.fromXML('<section>Alice</section>'),
-                    children = c.doc().children();
-                expect(children.length).to.equal(1);
-                expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
-            });
-
-            describe('accessing parents', function() {
-                it('returns DocumentNodeElement representing parent in wlxml document as DocumentNodeElement parent', function() {
-                    var c = canvas.fromXML('<section><div></div></section>'),
-                        div = c.doc().children()[0];
-                    expect(div.parent().sameNode(c.doc())).to.be.true;
-                });
-                it('returns DocumentNodeElement representing parent in wlxml document as DocumentTextElement parent', function() {
-                    var c = canvas.fromXML('<section>Alice</section>'),
-                        text = c.doc().children()[0];
-                    expect(text.parent().sameNode(c.doc())).to.be.true;
-                });
-            });
-
-            describe('accessing sibling parents of two elements', function() {
-                it('returns elements themself if they have direct common parent', function() {
-                    var c = canvas.fromXML('<section>\
-                        <div>\
-                            <div>A</div>\
-                            <div>B</div>\
-                        </div>\
-                    </section>'),
-                        section = c.doc(),
-                        wrappingDiv = c.doc().children()[0],
-                        divA = wrappingDiv.children()[0],
-                        divB = wrappingDiv.children()[1];
-
-                    var siblingParents = c.getSiblingParents({element1: divA, element2: divB});
-
-                    expect(siblingParents.element1.sameNode(divA)).to.equal(true, 'divA');
-                    expect(siblingParents.element2.sameNode(divB)).to.equal(true, 'divB');
-                });
-
-                it('returns sibling parents - example 1', function() {
-                    var c = canvas.fromXML('<section>Alice <span>has a cat</span></section>'),
-                        section = c.doc(),
-                        aliceText = section.children()[0],
-                        span = section.children()[1],
-                        spanText = span.children()[0];
-
-                    var siblingParents = c.getSiblingParents({element1: aliceText, element2: spanText});
-
-                    expect(siblingParents.element1.sameNode(aliceText)).to.equal(true, 'aliceText');
-                    expect(siblingParents.element2.sameNode(span)).to.equal(true, 'span');
-                });
-            })
-
-            describe('free text handling', function() {
-                    it('sees free text', function() {
-                        var c = canvas.fromXML('<section>Alice <span>has</span> a cat</section>'),
-                            children = c.doc().children();
-                        expect(children.length).to.equal(3);
-                        expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
-                        expect(children[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
-                        expect(children[2]).to.be.instanceOf(documentElement.DocumentTextElement);
-                    });
-            });
-
-            describe('empty nodes handling', function() {
-                it('says empty element node from XML source has one empty DocumentTextElement', function() {
-                    var c = canvas.fromXML('<section></section>');
-                    expect(c.doc().children()).to.have.length(1);
-                    expect(c.doc().children()[0].getText()).to.equal('');
-                });
-
-                it('allows creation of an empty element node', function() {
-                    var c = canvas.fromXML('<section></section>'),
-                        section = c.doc(),
-                        header = section.append({tag: 'header'});
-                    expect(header.children()).to.have.length(0);
-                });
-            });
-            
-            describe('white characters handling', function() {
-
-                it('says element node with one space has one DocumentTextElement', function() {
-                    var c = canvas.fromXML('<section> </section>');
-                    expect(c.doc().children().length).to.equal(1);
-                    expect(c.doc().children()[0]).to.be.instanceOf(documentElement.DocumentTextElement);
-                    expect(c.doc().children()[0].getText()).to.equal(' ');
-                });
-                it('ignores white space surrounding block elements', function() {
-                    var c = canvas.fromXML('<section> <div></div> </section>');
-                    var children = c.doc().children();
-                    expect(children.length).to.equal(1);
-                    expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
-                });
-                it('ignores white space between block elements', function() {
-                    var c = canvas.fromXML('<section><div></div> <div></div></section>');
-                    var children = c.doc().children();
-                    expect(children.length === 2);
-                    [0,1].forEach(function(idx) {
-                        expect(children[idx]).to.be.instanceOf(documentElement.DocumentNodeElement);
-                    });
-                });
-
-                it('trims white space from the beginning and the end of the block elements', function() {
-                    var c = canvas.fromXML('<section> Alice <span>has</span> a cat </section>');
-                    expect(c.doc().children()[0].getText()).to.equal('Alice ');
-                    expect(c.doc().children()[2].getText()).to.equal(' a cat');
-                });
-
-                it('normalizes string of white characters to one space at the inline element boundries', function() {
-                    var c = canvas.fromXML('<span>   Alice has a cat   </span>');
-                    expect(c.doc().children()[0].getText()).to.equal(' Alice has a cat ');
-                });
-
-                it('normalizes string of white characters to one space before inline element', function() {
-                    var c = canvas.fromXML('<div>Alice has  <span>a cat</span></div>');
-                    expect(c.doc().children()[0].getText()).to.equal('Alice has ');
-                });
-                
-                it('normalizes string of white characters to one space after inline element', function() {
-                    var c = canvas.fromXML('<div>Alice has <span>a</span>  cat</div>');
-                    expect(c.doc().children()[2].getText()).to.equal(' cat');
-                });
-            });
-
-            describe('getting vertically first text element', function() {
-                it('returns the first child if it\'s text element, ignores metadata', function() {
-                    var c = canvas.fromXML('<section><metadata><dc:author>author</dc:author></metadata>Alice<div>has</div>a cat</section>'),
-                        first = c.doc().getVerticallyFirstTextElement();
-
-                    expect(first.sameNode(c.doc().children()[1])).to.be.true;
-                });
-
-                it('looks recursively inside node elements if they precede text element', function() {
-                    var c = canvas.fromXML('\
-                            <section>\
-                                <div>\
-                                    <div>\
-                                        Alice\
-                                    </div>\
-                                </div>\
-                                Some text\
-                            </section>'),
-                        textAlice = c.doc().children()[0].children()[0].children()[0],
-                        first = c.doc().getVerticallyFirstTextElement();
-
-                    expect(textAlice).to.be.instanceOf(documentElement.DocumentTextElement);
-                    expect(first.sameNode(textAlice)).to.be.true;
-                });
-            });
+    it('allows handling changes to internal structure of rendered node', function() {
+        var prototype = $.extend({}, documentElement.DocumentNodeElement.prototype, {
+                init: function() {
+                    this.header = $('<h1>');
+                    this._container().append(this.header);
+                    this.refresh2();
+                },
+                refresh2: function() {
+                    this.header.text(this.wlxmlNode.contents().length);
+                },
+                onNodeAdded: function(event) {
+                    void(event);
+                    this.refresh2();
+                },
+                onNodeTextChange: function(event) {
+                    this.header.text(event.meta.node.getText());
+                },
+                children: function() { return []; }
         });
 
         });
 
-        describe('manipulation api', function() {
-
-            describe('Basic Element inserting', function() {
-                it('can put new NodeElement at the end', function() {
-                    var c = canvas.fromXML('<section><div></div></section>'),
-                        appended = c.doc().append({tag: 'header', klass: 'some.class'}),
-                        children = c.doc().children();
-
-                    expect(children.length).to.equal(2);
-                    expect(children[1].sameNode(appended)).to.be.true;
-                });
-
-                it('can put new TextElement at the end', function() {
-                    var c = canvas.fromXML('<section><div><div></section>'),
-                        appended = c.doc().append({text: 'Alice'}),
-                        children = c.doc().children();
-
-                    expect(children.length).to.equal(2);
-                    expect(children[1].sameNode(appended)).to.be.true;
-                    expect(children[1].getText()).to.equal('Alice');
-                });
-
-                it('can put new NodeElement at the beginning', function() {
-                    var c = canvas.fromXML('<section><div></div></section>'),
-                        prepended = c.doc().prepend({tag: 'header', klass: 'some.class'}),
-                        children = c.doc().children();
-
-                    expect(children).to.have.length(2);
-                    expect(children[0].sameNode(prepended)).to.be.true;
-                });
-
-                it('can put new TextElement at the beginning', function() {
-                    var c = canvas.fromXML('<section><div></div></section>'),
-                        prepended = c.doc().prepend({text: 'Alice'}),
-                        children = c.doc().children();
-
-                    expect(children).to.have.length(2)
-                    expect(children[0].sameNode(prepended)).to.be.true;
-                    expect(children[0].getText()).to.equal('Alice');
-                });
-
-                it('can put new NodeElement after another NodeElement', function() {
-                    var c = canvas.fromXML('<section><div></div></section>'),
-                        div = c.doc().children()[0],
-                        added = div.after({tag: 'header', klass: 'some.class'}),
-                        children = c.doc().children();
-                    expect(children.length).to.equal(2);
-                    expect(children[1].sameNode(added)).to.be.true;
-                });
-
-                it('can put new Nodeelement before another element', function() {
-                    var c = canvas.fromXML('<section><div></div></section>'),
-                        div = c.doc().children()[0],
-                        added = div.before({tag: 'header', klass: 'some.class'}),
-                        children = c.doc().children();
-                    expect(children.length).to.equal(2);
-                    expect(children[0].sameNode(added)).to.be.true;
-                });
-
-                it('can put new DocumentNodeElement after DocumentTextElement', function() {
-                    var c = canvas.fromXML('<section>Alice</section>'),
-                        text = c.doc().children()[0],
-                        added = text.after({tag: 'p'}),
-                        children = c.doc().children();
-
-                    expect(children.length).to.equal(2);
-                    expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
-                    expect(children[0].getText()).to.equal('Alice');
-                    expect(children[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
-                    expect(children[1].sameNode(added)).to.be.true;
-                });
-                it('can put new DocumentNodeElement before DocumentTextElement', function() {
-                    var c = canvas.fromXML('<section>Alice</section>'),
-                        text = c.doc().children()[0],
-                        added = text.before({tag: 'p'}),
-                        children = c.doc().children();
-
-                    expect(children.length).to.equal(2);
-                    expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
-                    expect(children[0].sameNode(added)).to.be.true;
-                    expect(children[1]).to.be.instanceOf(documentElement.DocumentTextElement);
-                    expect(children[1].getText()).to.equal('Alice');
-                });
-
-                it('can divide DocumentTextElement with a new DocumentNodeElement', function() {
-                    var c = canvas.fromXML('<section>Alice has a cat</section>'),
-                        section = c.doc(),
-                        text = section.children()[0];
-
-                    var returned = text.divide({tag: 'aside', klass: 'footnote', offset: 5}),
-                        sectionChildren = section.children(),
-                        lhsText = sectionChildren[0],
-                        rhsText = sectionChildren[2];
-
-                    expect(lhsText.getText()).to.equal('Alice');
-                    expect(returned.sameNode(sectionChildren[1]));
-                    expect(rhsText.getText()).to.equal(' has a cat');
-                });
-
-                it('treats dividing DocumentTextElement at the very end as appending after it', function() {
-                    var c = canvas.fromXML('<section>Alice has a cat</section>'),
-                        section = c.doc(),
-                        text = section.children()[0];
-
-                    var returned = text.divide({tag: 'aside', klass: 'footnote', offset: 15}),
-                        sectionChildren = section.children(),
-                        textElement = sectionChildren[0],
-                        nodeElement = sectionChildren[1];
-
-                    expect(sectionChildren.length).to.equal(2);
-                    expect(textElement.getText()).to.equal('Alice has a cat');
-                    expect(returned.sameNode(nodeElement)).to.be.true;
-                    expect(nodeElement.getWlxmlTag()).to.equal('aside');
-                });
-
-                it('treats dividing DocumentTextElement at the very beginning as appending before it', function() {
-                    var c = canvas.fromXML('<section>Alice has a cat</section>'),
-                        section = c.doc(),
-                        text = section.children()[0];
-
-                    var returned = text.divide({tag: 'aside', klass: 'footnote', offset: 0}),
-                        sectionChildren = section.children(),
-                        nodeElement = sectionChildren[0],
-                        textElement = sectionChildren[1];
-                        
-                    expect(sectionChildren.length).to.equal(2);
-                    expect(textElement.getText()).to.equal('Alice has a cat');
-                    expect(returned.sameNode(nodeElement)).to.be.true;
-                    expect(nodeElement.getWlxmlTag()).to.equal('aside');
-                });
-            });
-
-            describe('Removing elements', function() {
-                it('merges left and right DocumentTextElement sibling of a detached DocumentNodeElement', function() {
-                    var c = canvas.fromXML('<section>Alice<div>has</div>a cat</section>'),
-                        section = c.doc(),
-                        div = section.children()[1];
-
-                    div.detach();
-
-                    var sectionChildren = section.children(),
-                        textElement = sectionChildren[0];
-
-                    expect(sectionChildren).to.have.length(1);
-                    expect(textElement.getText()).to.equal('Alicea cat');
-                });
-            });
-
-            describe('Splitting text', function() {
-                
-                it('splits DocumentTextElement\'s parent into two DocumentNodeElements of the same type', function() {
-                    var c = canvas.fromXML('<section><header>Some header</header></section>'),
-                        section = c.doc(),
-                        text = section.children()[0].children()[0];
-
-                    var returnedValue = text.split({offset: 5});
-                    expect(section.children().length).to.equal(2, 'section has two children');
-                    
-                    var header1 = section.children()[0];
-                    var header2 = section.children()[1];
-
-                    expect(header1.getWlxmlTag()).to.equal('header', 'first section child represents wlxml header');
-                    expect(header1.children().length).to.equal(1, 'first header has one text child');
-                    expect(header1.children()[0].getText()).to.equal('Some ', 'first header has correct content');
-                    expect(header2.getWlxmlTag()).to.equal('header', 'second section child represents wlxml header');
-                    expect(header2.children().length).to.equal(1, 'second header has one text child');
-                    expect(header2.children()[0].getText()).to.equal('header', 'second header has correct content');
-
-                    expect(returnedValue.first.sameNode(header1)).to.equal(true, 'first node returnde');
-                    expect(returnedValue.second.sameNode(header2)).to.equal(true, 'second node returned');
-                });
-
-                it('leaves empty copy of DocumentNodeElement if splitting at the very beginning', function() {
-                        var c = canvas.fromXML('<section><header>Some header</header></section>'),
-                        section = c.doc(),
-                        text = section.children()[0].children()[0];
-
-                        text.split({offset: 0});
-                        
-                        var header1 = section.children()[0];
-                        var header2 = section.children()[1];
-
-                        expect(header1.children().length).to.equal(0);
-                        expect(header2.children()[0].getText()).to.equal('Some header');
-                });
-
-                it('leaves empty copy of DocumentNodeElement if splitting at the very end', function() {
-                        var c = canvas.fromXML('<section><header>Some header</header></section>'),
-                        section = c.doc(),
-                        text = section.children()[0].children()[0];
-
-                        text.split({offset: 11});
-                        
-                        var header1 = section.children()[0];
-                        var header2 = section.children()[1];
-
-                        expect(header1.children()[0].getText()).to.equal('Some header');
-                        expect(header2.children().length).to.equal(0);
-                });
-
-                it('keeps DocumentTextElement\'s parent\'s children elements intact', function() {
-                    var c = canvas.fromXML('\
-                            <section>\
-                                <header>\
-                                    A <span>fancy</span> and <span>nice</span> header\
-                                </header>\
-                            </section>'),
-                        section = c.doc(),
-                        header = section.children()[0],
-                        textAnd = header.children()[2];
-
-                    textAnd.split({offset: 2});
-                    
-                    var sectionChildren = section.children();
-                    expect(sectionChildren.length).to.equal(2, 'Section has two children');
-                    expect(sectionChildren[0].getWlxmlTag()).to.equal('header', 'First section element is a wlxml header');
-                    expect(sectionChildren[1].getWlxmlTag()).to.equal('header', 'Second section element is a wlxml header');
-
-                    var firstHeaderChildren = sectionChildren[0].children();
-                    expect(firstHeaderChildren.length).to.equal(3, 'First header has three children');
-                    expect(firstHeaderChildren[0].getText()).to.equal('A ', 'First header starts with a text');
-                    expect(firstHeaderChildren[1].getWlxmlTag()).to.equal('span', 'First header has span in the middle');
-                    expect(firstHeaderChildren[2].getText()).to.equal(' a', 'First header ends with text');
-
-                    var secondHeaderChildren = sectionChildren[1].children();
-                    expect(secondHeaderChildren.length).to.equal(3, 'Second header has three children');
-                    expect(secondHeaderChildren[0].getText()).to.equal('nd ', 'Second header starts with text');
-                    expect(secondHeaderChildren[1].getWlxmlTag()).to.equal('span', 'Second header has span in the middle');
-                    expect(secondHeaderChildren[2].getText()).to.equal(' header', 'Second header ends with text');
-                });
-            });
-
-            describe('wrapping', function() {
-                it('wraps DocumentNodeElement', function() {
-                    var c = canvas.fromXML('<section><div></div></section>'),
-                        div = c.doc().children()[0];
-                    
-                    var returned = div.wrapWithNodeElement({tag: 'header', klass: 'some.class'}),
-                        parent = div.parent(),
-                        parent2 = c.doc().children()[0];
-
-                    expect(returned.sameNode(parent)).to.be.true;
-                    expect(returned.sameNode(parent2)).to.be.true;
-                    expect(returned.getWlxmlTag()).to.equal('header');
-                    expect(returned.getWlxmlClass()).to.equal('some.class');
-                });
-                it('wraps DocumentTextElement', function() {
-                    var c = canvas.fromXML('<section>Alice</section>'),
-                        text = c.doc().children()[0];
-                    
-                    var returned = text.wrapWithNodeElement({tag: 'header', klass: 'some.class'}),
-                        parent = text.parent(),
-                        parent2 = c.doc().children()[0];
-
-                    expect(returned.sameNode(parent)).to.be.true;
-                    expect(returned.sameNode(parent2)).to.be.true;
-                    expect(returned.getWlxmlTag()).to.equal('header');
-                    expect(returned.getWlxmlClass()).to.equal('some.class');
-                });
-                
-                describe('wrapping part of DocumentTextElement', function() {
-                    [{start: 5, end: 12}, {start: 12, end: 5}].forEach(function(offsets) {
-                        it('wraps in the middle ' + offsets.start + '/' + offsets.end, function() {
-                            var c = canvas.fromXML('<section>Alice has a cat</section>'),
-                                text = c.doc().children()[0];
-                            
-                            var returned = text.wrapWithNodeElement({tag: 'header', klass: 'some.class', start: offsets.start, end: offsets.end}),
-                                children = c.doc().children();
-
-                            expect(children.length).to.equal(3);
-                            
-                            expect(children[0]).to.be.instanceOf(documentElement.DocumentTextElement);
-                            expect(children[0].getText()).to.equal('Alice');
-
-                            expect(children[1].sameNode(returned)).to.be.true;
-                            expect(returned.getWlxmlTag()).to.equal('header');
-                            expect(returned.getWlxmlClass()).to.equal('some.class');
-                            expect(children[1].children().length).to.equal(1);
-                            expect(children[1].children()[0].getText()).to.equal(' has a ');
-
-                            expect(children[2]).to.be.instanceOf(documentElement.DocumentTextElement);
-                            expect(children[2].getText()).to.equal('cat');
-                        });
-                    });
-
-                    it('wraps whole text inside DocumentTextElement if offsets span entire content', function() {
-                         var c = canvas.fromXML('<section>Alice has a cat</section>'),
-                             text = c.doc().children()[0];
-                         
-                         var returned = text.wrapWithNodeElement({tag: 'header', klass: 'some.class', start: 0, end: 15}),
-                             children = c.doc().children();
-
-                         expect(children.length).to.equal(1);
-                         expect(children[0]).to.be.instanceOf(documentElement.DocumentNodeElement);
-                         expect(children[0].children()[0].getText()).to.equal('Alice has a cat');
-                    });
-                });
-
-                it('wraps text spanning multiple sibling DocumentTextNodes', function() {
-                    var c = canvas.fromXML('<section>Alice has a <span>small</span> cat</section>'),
-                        section = c.doc(),
-                        wrapper = c.wrapText({
-                            inside: section, 
-                            _with: {tag: 'span', klass: 'some.class'},
-                            offsetStart: 6,
-                            offsetEnd: 4,
-                            textNodeIdx: [0,2]
-                        });
-
-                    expect(section.children().length).to.equal(2);
-                    expect(section.children()[0]).to.be.instanceOf(documentElement.DocumentTextElement);
-                    expect(section.children()[0].getText()).to.equal('Alice ');
-
-                    var wrapper2 = section.children()[1];
-                    expect(wrapper2.sameNode(wrapper)).to.be.true;
-
-                    var wrapperChildren = wrapper.children();
-                    expect(wrapperChildren.length).to.equal(3);
-                    expect(wrapperChildren[0].getText()).to.equal('has a ');
-
-                    expect(wrapperChildren[1]).to.be.instanceOf(documentElement.DocumentNodeElement);
-                    expect(wrapperChildren[1].children().length).to.equal(1);
-                    expect(wrapperChildren[1].children()[0].getText()).to.equal('small');
-
-                    expect(wrapperChildren[2].getText()).to.equal(' cat');
-                });
-
-                it('wraps multiple sibling Elements', function() {
-                    var c = canvas.fromXML('<section>Alice<div>has</div><div>a cat</div></section>'),
-                        section = c.doc(),
-                        aliceText = section.children()[0],
-                        firstDiv = section.children()[1],
-                        lastDiv = section.children()[section.children().length -1];
-
-                    var returned = c.wrapElements({
-                            element1: aliceText,
-                            element2: lastDiv,
-                            _with: {tag: 'header'}
-                        });
-
-                    var sectionChildren = section.children(),
-                        header = sectionChildren[0],
-                        headerChildren = header.children();
-
-                    expect(sectionChildren).to.have.length(1);
-                    expect(header.sameNode(returned)).to.equal(true, 'wrapper returned');
-                    expect(headerChildren).to.have.length(3);
-                    expect(headerChildren[0].sameNode(aliceText)).to.equal(true, 'first node wrapped');
-                    expect(headerChildren[1].sameNode(firstDiv)).to.equal(true, 'second node wrapped');
-                    expect(headerChildren[2].sameNode(lastDiv)).to.equal(true, 'third node wrapped');
-                });
-                it('wraps multiple sibling Elements - middle case', function() {
-                    var c = canvas.fromXML('<section><div></div>div></div><div></div><div></div></section>'),
-                        section = c.doc(),
-                        div1 = section.children()[0],
-                        div2 = section.children()[1],
-                        div3 = section.children()[2],
-                        div4 = section.children()[3];
-
-                    var returned = c.wrapElements({
-                            element1: div2,
-                            element2: div3,
-                            _with: {tag: 'header'}
-                        });
-
-                    var sectionChildren = section.children(),
-                        header = sectionChildren[1],
-                        headerChildren = header.children();
-
-                    expect(sectionChildren).to.have.length(3);
-                    expect(headerChildren).to.have.length(2);
-                    expect(headerChildren[0].sameNode(div2)).to.equal(true, 'first node wrapped');
-                    expect(headerChildren[1].sameNode(div3)).to.equal(true, 'second node wrapped');
-                });
-            });
-
-            describe('unwrapping DocumentTextElement from its parent DocumentNodeElement if it\'s its only child', function() {
-                it('unwraps text element from its parent and stays between its old parent siblings', function() {
-                    var c = canvas.fromXML('<section><div>Alice</div><div>has</div><div>a cat</div></section>'),
-                        section = c.doc(),
-                        sectionChildren = section.children(),
-                        divAlice = sectionChildren[0],
-                        divHas = sectionChildren[1],
-                        textHas = divHas.children()[0],
-                        divCat = sectionChildren[2];
-
-                    var newTextContainer = textHas.unwrap(),
-                        sectionChildren = section.children();
-
-                    expect(sectionChildren[0].sameNode(divAlice)).to.equal(true, 'divAlice ok');
-                    expect(newTextContainer.sameNode(section)).to.equal(true, 'unwrap returns new text parent DocumentNodeElement');
-                    expect(sectionChildren[1].getText()).to.equal('has');
-                    expect(sectionChildren[2].sameNode(divCat)).to.equal(true, 'divCat ok');
-
-                });
-                it('unwraps and join with its old parent adjacent text elements ', function() {
-                    var c = canvas.fromXML('<section>Alice <span>has a</span> cat</section>'),
-                    section = c.doc(),
-                    text = section.children()[1].children()[0];
-
-                    var newTextContainer = text.unwrap();
-
-                    expect(section.children().length).to.equal(1, 'section has one child');
-                    expect(section.children()[0].getText()).to.equal('Alice has a cat');
-                    expect(newTextContainer.sameNode(c.doc())).to.equal(true, 'unwrap returns new text parent DocumentNodeElement');
-                });
-
-                it('unwraps text element from its parent - first child case', function() {
-                    var c = canvas.fromXML('<section><span class="uri">Some</span>text</section>'),
-                        section = c.doc(),
-                        span = section.children()[0];
-
-                    span.children()[0].unwrap();
-
-                    var sectionChildren = section.children();
-
-                    expect(sectionChildren).to.have.length(1);
-                    expect(sectionChildren[0].getText()).to.equal('Sometext');
-                });
-            });
-
-            describe('unwrapping the whole content of a DocumentNodeElement', function() {
-                it('removes a DocumentNodeElement but keeps its content', function() {
-                    var c = canvas.fromXML('<section><div>Alice has<span>a</span> cat</div></section>'),
-                        section = c.doc(),
-                        div = c.doc().children()[0],
-                        span = div.children()[1];
-
-                    var range = div.unwrapContents(),
-                        sectionChildren = section.children();
-
-                    expect(sectionChildren).to.have.length(3);
-                    expect(sectionChildren[0].getText()).to.equal('Alice has');
-                    expect(sectionChildren[1].sameNode(span)).to.equal(true, 'span ok');
-                    expect(sectionChildren[2].getText()).to.equal(' cat');
-
-                    expect(range.element1.sameNode(sectionChildren[0])).to.equal(true, 'range start ok');
-                    expect(range.element2.sameNode(sectionChildren[2])).to.equal(true, 'range end ok');
-                });
-                it('merges text elements on the boundries', function() {
-                    var c = canvas.fromXML('<section>Alice<div>has a <span>cat</span>!</div>!!</section>'),
-                        section = c.doc(),
-                        div = c.doc().children()[1],
-                        span = div.children()[1];
-
-                    var range = div.unwrapContents(),
-                        sectionChildren = section.children();
-
-                    expect(sectionChildren).to.have.length(3);
-                    expect(sectionChildren[0].getText()).to.equal('Alicehas a ');
-                    expect(sectionChildren[1].sameNode(span)).to.equal(true, 'span ok');
-                    expect(sectionChildren[2].getText()).to.equal('!!!');
-
-                    expect(range.element1.sameNode(sectionChildren[0])).to.equal(true, 'range start ok');
-                    expect(range.element2.sameNode(sectionChildren[2])).to.equal(true, 'range end ok');
-                });
-
-                it('merges text elements on the boundries - single child case', function() {
-                    var c = canvas.fromXML('<section>Alice <span>has</span> a cat</section>'),
-                        section = c.doc(),
-                        span = section.children()[1];
-
-                    var range = span.unwrapContents(),
-                        sectionChildren = section.children();
-
-                    expect(sectionChildren).to.have.length(1);
-                    expect(sectionChildren[0].getText()).to.equal('Alice has a cat');
-                });
-            });
-            
+        var c = getCanvasFromXML('<section><div class="testClass"><a></a></div></section>', [
+            {tag: 'div', klass: 'testClass', prototype: prototype}
+        ]);
+
+        var node = c.wlxmlDocument.root.contents()[0],
+            element = node.getData('canvasElement');
+
+        var header = element.dom.find('h1');
+        expect(header.text()).to.equal('1', 'just <a>');
+
+        node.append({tagName: 'div'});
+
+        expect(header.text()).to.equal('2', 'added div');
+
+        var textNode = node.append({text: 'test'});
+
+        expect(header.text()).to.equal('3', 'added text node');
+        
+        textNode.setText('test2');
+
+        expect(header.text()).to.equal('test2', 'text node change handled');
+    });
+
+    describe('Handling unknown class', function() {
+        it('Inherits default behavior', function() {
+            var c = getCanvasFromXML('<section><div class="unknown">Hi!</div></section>');
+            expect(c.doc().children()[0].children()[0].getText()).to.equal('Hi!');
         });
         });
+    });
+});
+
+describe('Cursor', function() {
+    /* globals Node */
+    var getSelection;
 
 
-        describe('Lists api', function() {
-            describe('creating lists', function() {
-                it('allows creation of a list from existing sibling DocumentElements', function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            Alice\
-                            <div>has</div>\
-                            a\
-                            <div>cat</div>\
-                        </section>'),
-                        section = c.doc(),
-                        textHas = section.children()[1],
-                        divA = section.children()[2]
-                    
-                    c.list.create({element1: textHas, element2: divA});
-
-                    expect(section.children().length).to.equal(3, 'section has three child elements');
-
-                    var child1 = section.children()[0],
-                        list = section.children()[1],
-                        child3 = section.children()[2];
-
-                    expect(child1.getText()).to.equal('Alice');
-                    expect(list.is('list')).to.equal(true, 'second child is a list');
-                    expect(list.children().length).to.equal(2, 'list contains two elements');
-                    list.children().forEach(function(child) {
-                        expect(child.getWlxmlClass()).to.equal('item', 'list childs have wlxml class of item');
-                    });
-                    expect(child3.children()[0].getText()).to.equal('cat');
-                });
-                
-                it('allows creating nested list from existing sibling list items', function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list-items">\
-                                <div class="item">A</div>\
-                                <div class="item">B</div>\
-                                <div class="item">C</div>\
-                                <div class="item">D</div>\
-                            </div>\
-                        </section>'),
-                        outerList = c.doc().children()[0],
-                        itemB = outerList.children()[1],
-                        itemC = outerList.children()[2];
-
-
-                        c.list.create({element1: itemB, element2: itemC});
-
-                    var outerListItems = outerList.children(),
-                        innerList = outerListItems[1].children()[0],
-                        innerListItems = innerList.children();
-
-                    expect(outerListItems.length).to.equal(3, 'outer list has three items');
-                    expect(outerListItems[0].children()[0].getText()).to.equal('A', 'first outer item ok');
-                    expect(outerListItems[1].getWlxmlClass()).to.equal('item', 'inner list is wrapped by item element');
-
-                    expect(innerList.is('list')).to.equal(true, 'inner list created');
-                    expect(innerListItems.length).to.equal(2, 'inner list has two items');
-                    expect(innerListItems[0].children()[0].getText()).to.equal('B', 'first inner item ok');
-                    expect(innerListItems[1].children()[0].getText()).to.equal('C', 'second inner item ok');
-
-                    expect(outerListItems[2].children()[0].getText()).to.equal('D', 'last outer item ok');
-
-                });
-
-            });
-
-            describe('extracting list items', function() {
-                it('creates two lists with extracted items in the middle if extracting from the middle of the list', function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list.items">\
-                                <div class="item">0</div>\
-                                <div class="item">1</div>\
-                                <div class="item">2</div>\
-                                <div class="item">3</div>\
-                            </div>\
-                        </section>'),
-                        list = c.doc().children()[0],
-                        item1 = list.children()[1],
-                        item2 = list.children()[2];
-
-                    c.list.extractItems({element1: item1, element2: item2});
-
-                    var section = c.doc(),
-                        list1 = section.children()[0],
-                        oldItem1 = section.children()[1],
-                        oldItem2 = section.children()[2],
-                        list2 = section.children()[3];
-
-                    expect(section.children().length).to.equal(4, 'section contains four children');
-                    
-                    expect(list1.is('list')).to.equal(true, 'first section child is a list');
-                    expect(list1.children().length).to.equal(1, 'first list has one child');
-                    expect(list1.children()[0].children()[0].getText()).to.equal('0', 'first item of the first list is a first item of the original list');
-
-                    expect(oldItem1.children()[0].getText()).to.equal('1', 'first item got extracted');
-                    expect(oldItem1.getWlxmlClass() === undefined).to.equal(true, 'first extracted element has no wlxml class');
-
-                    expect(oldItem2.children()[0].getText()).to.equal('2', 'second item got extracted');
-                    expect(oldItem2.getWlxmlClass() === undefined).to.equal(true, 'second extracted element has no wlxml class');
-
-                    expect(list2.is('list')).to.equal(true, 'last section child is a list');
-                    expect(list2.children().length).to.equal(1, 'second list has one child');
-                    expect(list2.children()[0].children()[0].getText()).to.equal('3', 'first item of the second list is a last item of the original list');
-                });
-
-                it('puts extracted items above the list if starting item is the first one', function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list.items">\
-                                <div class="item">0</div>\
-                                <div class="item">1</div>\
-                                <div class="item">2</div>\
-                            </div>\
-                        </section>'),
-                        list = c.doc().children()[0],
-                        item1 = list.children()[0],
-                        item2 = list.children()[1],
-                        item3 = list.children()[2];
-
-                    c.list.extractItems({element1: item1, element2: item2});
-
-                    var section = c.doc(),
-                        oldItem1 = section.children()[0],
-                        oldItem2 = section.children()[1],
-                        newList = section.children()[2];
-
-                    expect(section.children().length).to.equal(3, 'section has three children');
-                    expect(oldItem1.children()[0].getText()).to.equal('0', 'first item extracted');
-                    expect(oldItem2.children()[0].getText()).to.equal('1', 'second item extracted');
-                    expect(newList.is('list')).to.equal(true, 'list lies below extracted item');
-                    expect(newList.children().length).to.equal(1, 'list has now one child');
-                });
-
-                it('puts extracted items below the list if ending item is the last one', function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list.items">\
-                                <div class="item">0</div>\
-                                <div class="item">1</div>\
-                                <div class="item">2</div>\
-                            </div>\
-                        </section>'),
-                        list = c.doc().children()[0],
-                        item1 = list.children()[0],
-                        item2 = list.children()[1],
-                        item3 = list.children()[2];
-
-                    c.list.extractItems({element1: item2, element2: item3});
-
-                    var section = c.doc(),
-                        oldItem1 = section.children()[1],
-                        oldItem2 = section.children()[2],
-                        newList = section.children()[0];
-
-                    expect(section.children().length).to.equal(3, 'section has three children');
-                    expect(oldItem1.children()[0].getText()).to.equal('1', 'first item extracted');
-                    expect(oldItem2.children()[0].getText()).to.equal('2', 'second item extracted');
-                    expect(newList.is('list')).to.equal(true, 'list lies above extracted item');
-                    expect(newList.children().length).to.equal(1, 'list has now one child');
-                });
-
-                it('removes list if all its items are extracted', function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list.items">\
-                                <div class="item">some item</div>\
-                                <div class="item">some item 2</div>\
-                            </div>\
-                        </section>'),
-                        list = c.doc().children()[0],
-                        item1 = list.children()[0],
-                        item2 = list.children()[1];
-
-                    c.list.extractItems({element1: item1, element2: item2});
-
-                    var section = c.doc(),
-                        list1 = section.children()[0],
-                        oldItem1 = section.children()[0],
-                        oldItem2 = section.children()[1];
-
-                    expect(section.children().length).to.equal(2, 'section contains two children');
-                    expect(oldItem1.children()[0].getText()).to.equal('some item');
-                    expect(oldItem2.children()[0].getText()).to.equal('some item 2');
-                });
-
-                it('creates two lists with extracted items in the middle if extracting from the middle of the list - nested case' , function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list.items">\
-                                <div class="item">0</div>\
-                                <div class="item">\
-                                    <div class="list.items">\
-                                        <div class="item">1.1</div>\
-                                        <div class="item">1.2</div>\
-                                        <div class="item">1.3</div>\
-                                    </div>\
-                                </div>\
-                                <div class="item">2</div>\
-                            </div>\
-                        </section>'),
-                        list = c.doc().children()[0],
-                        nestedList = list.children()[1].children()[0],
-                        nestedListItem = nestedList.children()[1];
-
-                    c.list.extractItems({element1: nestedListItem, element2: nestedListItem});
-
-                    var section = c.doc(),
-                        list = section.children()[0],
-                        item1 = list.children()[0],
-                        item2 = list.children()[1], //
-                        item3 = list.children()[2],
-                        item4 = list.children()[3], //
-                        item5 = list.children()[4],
-                        nestedList1 = item2.children()[0],
-                        nestedList2 = item4.children()[0];
-
-                    expect(list.children().length).to.equal(5, 'top list has five items');
-                    
-                    expect(item1.children()[0].getText()).to.equal('0', 'first item ok');
-
-                    expect(item2.getWlxmlClass()).to.equal('item', 'first nested list is still wrapped in item element');
-                    expect(nestedList1.children().length).to.equal(1, 'first nested list is left with one child');
-                    expect(nestedList1.children()[0].children()[0].getText()).to.equal('1.1', 'first nested list item left alone');
-                    
-                    expect(item3.children()[0].getText()).to.equal('1.2', 'third item ok');
-
-                    expect(item4.getWlxmlClass()).to.equal('item', 'second nested list is still wrapped in item element');
-                    expect(nestedList2.children().length).to.equal(1, 'second nested list is left with one child');
-                    expect(nestedList2.children()[0].children()[0].getText()).to.equal('1.3', 'second nested list item left alone');
-
-                    expect(item5.children()[0].getText()).to.equal('2', 'last item ok');
-                });
-
-                it('puts extracted items below the list if ending item is the last one - nested case' , function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list.items">\
-                                <div class="item">0</div>\
-                                <div class="item">\
-                                    <div class="list.items">\
-                                        <div class="item">1.1</div>\
-                                        <div class="item">1.2</div>\
-                                        <div class="item">1.3</div>\
-                                    </div>\
-                                </div>\
-                                <div class="item">2</div>\
-                            </div>\
-                        </section>'),
-                        list = c.doc().children()[0],
-                        nestedList = list.children()[1].children()[0],
-                        nestedListItem1 = nestedList.children()[1],
-                        nestedListItem2 = nestedList.children()[2];
-
-                    c.list.extractItems({element1: nestedListItem1, element2: nestedListItem2});
-
-                    var section = c.doc(),
-                        list = section.children()[0],
-                        item1 = list.children()[0],
-                        item2 = list.children()[1],
-                        item3 = list.children()[2],
-                        item4 = list.children()[3],
-                        item5 = list.children()[4];
-                    nestedList = item2.children()[0];
-
-                    expect(list.children().length).to.equal(5, 'top list has five items');
-                    expect(item1.children()[0].getText()).to.equal('0', 'first item ok');
-                    expect(item2.getWlxmlClass()).to.equal('item', 'nested list is still wrapped in item element');
-                    expect(nestedList.children().length).to.equal(1, 'nested list is left with one child');
-                    expect(nestedList.children()[0].children()[0].getText()).to.equal('1.1', 'nested list item left alone');
-                    expect(item3.children()[0].getText()).to.equal('1.2', 'third item ok');
-                    expect(item4.children()[0].getText()).to.equal('1.3', 'fourth item ok');
-                    expect(item5.children()[0].getText()).to.equal('2', 'fifth item ok');
-                });
-
-                it('puts extracted items above the list if starting item is the first one - nested case' , function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list.items">\
-                                <div class="item">0</div>\
-                                <div class="item">\
-                                    <div class="list.items">\
-                                        <div class="item">1.1</div>\
-                                        <div class="item">1.2</div>\
-                                        <div class="item">1.3</div>\
-                                    </div>\
-                                </div>\
-                                <div class="item">2</div>\
-                            </div>\
-                        </section>'),
-                        list = c.doc().children()[0],
-                        nestedList = list.children()[1].children()[0],
-                        nestedListItem1 = nestedList.children()[0],
-                        nestedListItem2 = nestedList.children()[1];
-
-                    c.list.extractItems({element1: nestedListItem1, element2: nestedListItem2});
-
-                    var section = c.doc(),
-                        list = section.children()[0],
-                        item1 = list.children()[0],
-                        item2 = list.children()[1],
-                        item3 = list.children()[2],
-                        item4 = list.children()[3],
-                        item5 = list.children()[4];
-                    nestedList = item4.children()[0];
-
-                    expect(list.children().length).to.equal(5, 'top list has five items');
-                    expect(item1.children()[0].getText()).to.equal('0', 'first item ok');
-                    expect(item2.children()[0].getText()).to.equal('1.1', 'second item ok');
-                    expect(item3.children()[0].getText()).to.equal('1.2', 'third item ok');
-                    
-                    expect(item4.getWlxmlClass()).to.equal('item', 'nested list is still wrapped in item element');
-                    expect(nestedList.children().length).to.equal(1, 'nested list is left with one child');
-                    expect(nestedList.children()[0].children()[0].getText()).to.equal('1.3', 'nested list item left alone');
-                    expect(item5.children()[0].getText()).to.equal('2', 'fifth item ok');
-                });
-
-                it('removes list if all its items are extracted - nested case', function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list.items">\
-                                <div class="item">0</div>\
-                                <div class="item">\
-                                    <div class="list.items">\
-                                        <div class="item">1.1</div>\
-                                        <div class="item">1.2</div>\
-                                    </div>\
-                                </div>\
-                                <div class="item">2</div>\
-                            </div>\
-                        </section>'),
-                        list = c.doc().children()[0],
-                        nestedList = list.children()[1].children()[0],
-                        nestedListItem1 = nestedList.children()[0],
-                        nestedListItem2 = nestedList.children()[1];
-
-                    c.list.extractItems({element1: nestedListItem1, element2: nestedListItem2});
-
-                    var section = c.doc(),
-                        list = section.children()[0],
-                        item1 = list.children()[0],
-                        item2 = list.children()[1],
-                        item3 = list.children()[2],
-                        item4 = list.children()[3];
-
-                    expect(list.children().length).to.equal(4, 'top list has four items');
-                    expect(item1.children()[0].getText()).to.equal('0', 'first item ok');
-                    expect(item2.children()[0].getText()).to.equal('1.1', 'second item ok');
-                    expect(item3.children()[0].getText()).to.equal('1.2', 'third item ok');
-                    expect(item4.children()[0].getText()).to.equal('2', 'fourth item ok');
-                });
-
-                it('extracts items out of outer most list when merge flag is set to false', function() {
-                    var c = canvas.fromXML('\
-                        <section>\
-                            <div class="list.items">\
-                                <div class="item">0</div>\
-                                <div class="item">\
-                                    <div class="list.items">\
-                                        <div class="item">1.1</div>\
-                                        <div class="item">1.2</div>\
-                                    </div>\
-                                </div>\
-                                <div class="item">2</div>\
-                            </div>\
-                        </section>'),
-                        section = c.doc(),
-                        list = section.children()[0],
-                        nestedList = list.children()[1].children()[0],
-                        nestedListItem = nestedList.children()[0];
-
-                    var test = c.list.extractItems({element1: nestedListItem, element2: nestedListItem, merge: false});
-
-                    expect(test).to.equal(true, 'extraction status ok');
-
-                    var sectionChildren = section.children(),
-                        extractedItem = sectionChildren[1];
-
-                    expect(sectionChildren.length).to.equal(3, 'section has three children');
-                    expect(sectionChildren[0].is('list')).to.equal(true, 'first child is a list');
-
-                    expect(extractedItem.getWlxmlTag()).to.equal('div', 'extracted item is a wlxml div');
-                    expect(extractedItem.getWlxmlClass()).to.equal(undefined, 'extracted item has no wlxml class');
-                    expect(extractedItem.children()[0].getText()).to.equal('1.1', 'extracted item ok');
-                    expect(sectionChildren[2].is('list')).to.equal(true, 'second child is a list');
-                });
-            });
+    var findTextNode = function(inside, text) {
+        var nodes = inside.find(':not(iframe)').addBack().contents().filter(function() {
+            return this.nodeType === Node.TEXT_NODE && this.data === text;
         });
         });
+        if(nodes.length) {
+            return nodes[0];
+        }
+        return null;
+    };
 
 
+    beforeEach(function() {
+        /* globals window */
+        getSelection = sinon.stub(window, 'getSelection');
     });
 
     });
 
-    describe('Cursor', function() {
+    afterEach(function() {
+        getSelection.restore();
+    });
 
 
-        var getSelection;
+    it('returns position when browser selection collapsed', function() {
+        var c = getCanvasFromXML('<section>Alice has a cat</section>'),
+            dom = c.doc().dom,
+            text = findTextNode(dom, 'Alice has a cat');
 
 
-        var findTextNode = function(inside, text) {
-            var nodes = inside.find(':not(iframe)').addBack().contents().filter(function() {
-                return this.nodeType === Node.TEXT_NODE && this.data === text;
-            });
-            if(nodes.length)
-                return nodes[0];
-            return null;
-        }
+        expect(text.nodeType).to.equal(Node.TEXT_NODE, 'correct node selected');
+        expect($(text).text()).to.equal('Alice has a cat');
 
 
-        beforeEach(function() {
-            getSelection = sinon.stub(window, 'getSelection');
+        getSelection.returns({
+            anchorNode: text,
+            focusNode: text,
+            anchorOffset: 5,
+            focusOffset: 5,
+            isCollapsed: true
         });
         });
-
-        afterEach(function() {
-            getSelection.restore();
+        var cursor = c.getCursor(),
+            position = cursor.getPosition();
+
+        expect(cursor.isSelecting()).to.equal(false, 'cursor is not selecting anything');
+        expect(position.element.getText()).to.equal('Alice has a cat');
+        expect(position.offset).to.equal(5);
+        expect(position.offsetAtEnd).to.equal(false, 'offset is not at end');
+
+        getSelection.returns({
+            anchorNode: text,
+            focusNode: text,
+            anchorOffset: 15,
+            focusOffset: 15,
+            isCollapsed: true
         });
 
         });
 
-        it('returns position when browser selection collapsed', function() {
-            var c = canvas.fromXML('<section>Alice has a cat</section>'),
-                dom = c.doc().dom(),
-                text = findTextNode(dom, 'Alice has a cat');
-
-            expect(text.nodeType).to.equal(Node.TEXT_NODE, 'correct node selected');
-            expect($(text).text()).to.equal('Alice has a cat');
-
-            getSelection.returns({
-                anchorNode: text,
-                focusNode: text,
-                anchorOffset: 5,
-                focusOffset: 5,
-                isCollapsed: true
-            });
-            var cursor = c.getCursor(),
-                position = cursor.getPosition();
-
-            expect(cursor.isSelecting()).to.equal(false, 'cursor is not selecting anything');
-            expect(position.element.getText()).to.equal('Alice has a cat');
-            expect(position.offset).to.equal(5);
-            expect(position.offsetAtEnd).to.equal(false, 'offset is not at end');
-
-            getSelection.returns({
-                anchorNode: text,
-                focusNode: text,
-                anchorOffset: 15,
-                focusOffset: 15,
-                isCollapsed: true
-            });
-
-            expect(cursor.getPosition().offsetAtEnd).to.equal(true, 'offset at end');
-        });
+        expect(cursor.getPosition().offsetAtEnd).to.equal(true, 'offset at end');
+    });
 
 
-        it('returns boundries of selection when browser selection not collapsed', function() {
-            var c = canvas.fromXML('<section>Alice <span>has</span> a <span>big</span> cat</section>'),
-                dom = c.doc().dom(),
-                text = {
-                    alice: findTextNode(dom, 'Alice '),
-                    has: findTextNode(dom, 'has'),
-                    cat: findTextNode(dom, ' cat')
-                },
-                cursor = c.getCursor(),
-                aliceElement = c.getDocumentElement(text.alice),
-                catElement = c.getDocumentElement(text.cat);
-
-
-                [
-                    {focus: text.alice, focusOffset: 1, anchor: text.cat,   anchorOffset: 2, selectionAnchor: catElement},
-                    {focus: text.cat,   focusOffset: 2, anchor: text.alice, anchorOffset: 1, selectionAnchor: aliceElement}
-                ].forEach(function(s, idx) {
-                    getSelection.returns({isColapsed: false, anchorNode: s.anchor, anchorOffset: s.anchorOffset, focusNode: s.focus, focusOffset: s.focusOffset});
-
-                    var selectionStart = cursor.getSelectionStart(),
-                        selectionEnd = cursor.getSelectionEnd(),
-                        selectionAnchor = cursor.getSelectionAnchor();
-
-                    expect(cursor.isSelecting()).to.equal(true, 'cursor is selecting');
-                    expect(selectionStart.element.sameNode(aliceElement)).to.equal(true, '"Alice" is the start of the selection ' + idx);
-                    expect(selectionStart.offset).to.equal(1, '"Alice" offset ok' + idx);
-                    expect(selectionEnd.element.sameNode(catElement)).to.equal(true, '"Cat" is the start of the selection ' + idx);
-                    expect(selectionEnd.offset).to.equal(2, '"Cat" offset ok' + idx);
-                    expect(selectionAnchor.element.sameNode(s.selectionAnchor)).to.equal(true, 'anchor ok');
-                    expect(selectionAnchor.offset).to.equal(s.anchorOffset, 'anchor offset ok');
-                });
+    it('recognizes selection start and end on document order', function() {
+        var c = getCanvasFromXML('<section><span>Alice</span><span>has a cat</span><div>abc<span>...</span>cde</div></section>'),
+            dom = c.doc().dom,
+            textFirst = findTextNode(dom, 'Alice'),
+            textSecond = findTextNode(dom, 'has a cat'),
+            textAbc = findTextNode(dom, 'abc'),
+            textCde = findTextNode(dom, 'cde');
+
+        var check = function(label, expected) {
+            var cursor = c.getCursor();
+            label = label + ': ';
+            expect(cursor.getSelectionStart().element.getText()).to.equal(expected.start.text, label + 'start element ok');
+            expect(cursor.getSelectionStart().offset).to.equal(expected.start.offset, label + 'start offset ok');
+            expect(cursor.getSelectionEnd().element.getText()).to.equal(expected.end.text, label + 'end element ok');
+            expect(cursor.getSelectionEnd().offset).to.equal(expected.end.offset, label + 'end offset ok');
+        };
+
+        getSelection.returns({
+            anchorNode: textFirst,
+            focusNode: textFirst,
+            anchorOffset: 1,
+            focusOffset: 3,
+            isCollapsed: false
         });
 
         });
 
-        it('recognizes when browser selection boundries lies in sibling DocumentTextElements', function() {
-            var c = canvas.fromXML('<section>Alice <span>has</span> a <span>big</span> cat</section>'),
-                dom = c.doc().dom(),
-                text = {
-                    alice: findTextNode(dom, 'Alice '),
-                    has: findTextNode(dom, 'has'),
-                    a: findTextNode(dom, ' a '),
-                    big: findTextNode(dom, 'big'),
-                    cat: findTextNode(dom, ' cat'),
-                },
-                cursor = c.getCursor();
+        check('same element, anchor first', {
+            start: {text: 'Alice', offset: 1},
+            end: {text: 'Alice', offset:3}
+        });
 
 
-            expect($(text.alice).text()).to.equal('Alice ');
-            expect($(text.has).text()).to.equal('has');
-            expect($(text.a).text()).to.equal(' a ');
-            expect($(text.big).text()).to.equal('big');
-            expect($(text.cat).text()).to.equal(' cat');
 
 
-            getSelection.returns({anchorNode: text.alice, focusNode: text.a});
-            expect(cursor.isSelectingSiblings()).to.equal(true, '"Alice" and "a" are children');
+        getSelection.returns({
+            anchorNode: textFirst,
+            focusNode: textFirst,
+            anchorOffset: 3,
+            focusOffset: 1,
+            isCollapsed: false
+        });
 
 
-            getSelection.returns({anchorNode: text.alice, focusNode: text.cat});
-            expect(cursor.isSelectingSiblings()).to.equal(true, '"Alice" and "cat" are children');
+        check('same element, anchor second', {
+            start: {text: 'Alice', offset: 1},
+            end: {text: 'Alice', offset:3}
+        });
 
 
-            getSelection.returns({anchorNode: text.alice, focusNode: text.has});
-            expect(cursor.isSelectingSiblings()).to.equal(false, '"Alice" and "has" are not children');
 
 
-            getSelection.returns({anchorNode: text.has, focusNode: text.big});
-            expect(cursor.isSelectingSiblings()).to.equal(false, '"has" and "big" are not children');
-            
-        })
-    });
+        getSelection.returns({
+            anchorNode: textAbc,
+            focusNode: textCde,
+            anchorOffset: 3,
+            focusOffset: 1,
+            isCollapsed: false
+        });
 
 
-    describe('Serializing document to WLXML', function() {
-        it('keeps document intact when no changes have been made', function() {
-            var xmlIn = '<section>Alice<div>has</div>a <span class="uri" meta-uri="http://cat.com">cat</span>!</section>',
-                c = canvas.fromXML(xmlIn),
-                xmlOut = c.toXML();
-
-            var parser = new DOMParser(),
-                input = parser.parseFromString(xmlIn, "application/xml").childNodes[0],
-                output = parser.parseFromString(xmlOut, "application/xml").childNodes[0];
-            
-            expect(input.isEqualNode(output)).to.be.true;
+        check('same parent, anchor first', {
+            start: {text: 'abc', offset: 3},
+            end: {text: 'cde', offset:1}
         });
 
         });
 
-        it('keeps arbitrary node attributes intact', function() {
-            var xmlIn = '<section a="1" xmlns:dcterms="http://purl.org/dc/terms/"></section>',
-                $xmlOut = $(canvas.fromXML(xmlIn).toXML());
 
 
-            expect($xmlOut.attr('a')).to.equal('1');
-            expect($xmlOut.attr('xmlns:dcterms')).to.equal('http://purl.org/dc/terms/');
+        getSelection.returns({
+            anchorNode: textCde,
+            focusNode: textAbc,
+            anchorOffset: 1,
+            focusOffset: 3,
+            isCollapsed: false
         });
 
         });
 
-        it('doesn\' serialize meta attribute if its empty', function() {
-            var c;
+        check('same parent, anchor second', {
+            start: {text: 'abc', offset: 3},
+            end: {text: 'cde', offset:1}
+        });
 
 
-            c = canvas.fromXML('<section class="uri" meta-uri="some.uri"></section>');
-            c.doc().setWlxmlMetaAttr('uri', '');
-            expect($(c.toXML()).attr('meta-uri')).to.equal(undefined, 'overriding attribute with zero length string');
 
 
-            c = canvas.fromXML('<section class="uri"></section>');
-            c.doc().setWlxmlMetaAttr('uri', '');
-            expect($(c.toXML()).attr('meta-uri')).to.equal(undefined, 'setting attribute to zero length string');
+        getSelection.returns({
+            anchorNode: textFirst,
+            focusNode: textSecond,
+            anchorOffset: 1,
+            focusOffset: 3,
+            isCollapsed: false
         });
 
         });
 
-        describe('output xml', function() {
-            it('keeps entities intact', function() {
-                var xmlIn = '<section>&lt; &gt;</section>',
-                    c = canvas.fromXML(xmlIn),
-                    xmlOut = c.toXML();
-                expect(xmlOut).to.equal(xmlIn);
-            });
-            it('keeps entities intact when they form html/xml', function() {
-                var xmlIn = '<section>&lt;abc&gt;</section>',
-                    c = canvas.fromXML(xmlIn),
-                    xmlOut = c.toXML();
-                expect(xmlOut).to.equal(xmlIn);
-            });
+        check('different parents, anchor first', {
+            start: {text: 'Alice', offset: 1},
+            end: {text: 'has a cat', offset:3}
         });
 
         });
 
-        describe('formatting output xml', function() {
-            /*it('keeps white spaces at the edges of input xml', function() {
-                var xmlIn = '  <section></section>  ',
-                c = canvas.fromXML(xmlIn),
-                xmlOut = c.toXML();
-
-                expect(xmlOut.substr(4)).to.equal('   <', 'start');
-                expect(xmlOut.substr(-2)).to.equal('>  ', 'end');
-            });*/
-            it('keeps white space between XML nodes', function() {
-                var xmlIn = '<section>\n\n\n<div></div>\n\n\n<div></div>\n\n\n</section>',
-                c = canvas.fromXML(xmlIn),
-                xmlOut = c.toXML();
-
-                var partsIn = xmlIn.split('\n\n\n'),
-                    partsOut = xmlOut.split('\n\n\n');
-                
-                expect(partsIn).to.deep.equal(partsOut);
-            });
-
-            it('keeps white space between XML nodes - inline case', function() {
-                var xmlIn = '<section>\n\n\n<span></span>\n\n\n<span></span>\n\n\n</section>',
-                c = canvas.fromXML(xmlIn);
-                
-                var xmlOut = c.toXML();
-
-                var partsIn = xmlIn.split('\n\n\n'),
-                    partsOut = xmlOut.split('\n\n\n');
-                
-                expect(partsIn).to.deep.equal(partsOut);
-            });
-
-            it('keeps white space at the beginning of text', function() {
-                var xmlIn = '<section>    abc<div>some div</div>    abc</section>',
-                    c = canvas.fromXML(xmlIn),
-                    xmlOut = c.toXML();
-
-                expect(xmlOut).to.equal(xmlIn);
-            });
-
-            it('nests new children block elements', function() {
-                var c = canvas.fromXML('<section></section>');
-    
-                c.doc().append({tag: 'header'});
 
 
-                var xmlOut = c.toXML();
-                expect(xmlOut.split('\n  ')[0]).to.equal('<section>', 'nesting start ok');
-                expect(xmlOut.split('\n').slice(-1)[0]).to.equal('</section>', 'nesting end ok');
+        getSelection.returns({
+            anchorNode: textSecond,
+            focusNode: textFirst,
+            anchorOffset: 3,
+            focusOffset: 1,
+            isCollapsed: false
+        });
+
+        check('different parents, anchor second', {
+            start: {text: 'Alice', offset: 1},
+            end: {text: 'has a cat', offset:3}
+        });
+    });
 
 
-            });
+    it('returns boundaries of selection when browser selection not collapsed', function() {
+        var c = getCanvasFromXML('<section>Alice <span>has</span> a <span>big</span> cat</section>'),
+            dom = c.doc().dom,
+            text = {
+                alice: findTextNode(dom, 'Alice '),
+                has: findTextNode(dom, 'has'),
+                cat: findTextNode(dom, ' cat')
+            },
+            cursor = c.getCursor(),
+            aliceElement = c.getDocumentElement(text.alice),
+            catElement = c.getDocumentElement(text.cat);
+
+        [
+            {focus: text.alice, focusOffset: 1, anchor: text.cat,   anchorOffset: 2, selectionAnchor: catElement},
+            {focus: text.cat,   focusOffset: 2, anchor: text.alice, anchorOffset: 1, selectionAnchor: aliceElement}
+        ].forEach(function(s, idx) {
+            getSelection.returns({isColapsed: false, anchorNode: s.anchor, anchorOffset: s.anchorOffset, focusNode: s.focus, focusOffset: s.focusOffset});
+
+            var selectionStart = cursor.getSelectionStart(),
+                selectionEnd = cursor.getSelectionEnd(),
+                selectionAnchor = cursor.getSelectionAnchor();
+
+            expect(cursor.isSelecting()).to.equal(true, 'cursor is selecting');
+            expect(selectionStart.element.sameNode(aliceElement)).to.equal(true, '"Alice" is the start of the selection ' + idx);
+            expect(selectionStart.offset).to.equal(1, '"Alice" offset ok' + idx);
+            expect(selectionEnd.element.sameNode(catElement)).to.equal(true, '"Cat" is the start of the selection ' + idx);
+            expect(selectionEnd.offset).to.equal(2, '"Cat" offset ok' + idx);
+            expect(selectionAnchor.element.sameNode(s.selectionAnchor)).to.equal(true, 'anchor ok');
+            expect(selectionAnchor.offset).to.equal(s.anchorOffset, 'anchor offset ok');
+        });
+    });
 
 
-            it('doesn\'t nest new children inline elements', function() {
-                var c = canvas.fromXML('<section></section>');
-    
-                c.doc().append({tag: 'span'});
-
-                var xmlOut = c.toXML();
-                expect(xmlOut).to.equal('<section><span></span></section>');
-            });
-
-            it('keeps original white space at the end of text', function() {
-                
-                var xmlIn = '<header>    Some text ended with white space \
-                \
-                <span class="uri">Some text</span> some text\
-            \
-            </header>',
-                    c = canvas.fromXML(xmlIn);
-
-            var xmlOut = c.toXML();
-            console.log(xmlOut);
-            expect(xmlOut).to.equal(xmlIn);
-            });
-
-            it('keeps white space around text node', function() {
-                var xmlIn = '<section>\
-                <header>header1</header>\
-                Some text surrounded by white space\
-                <header>header2</header>\
-            </section>',
-                    c = canvas.fromXML(xmlIn);
-
-                var xmlOut = c.toXML();
-                expect(xmlOut).to.equal(xmlIn);
-            });
-
-            it('keeps white space around text node - last node case', function() {
-                var xmlIn = '<section>\
-                <header>header</header>\
-                    \
-                Some text surrounded by white space\
-                    \
-            </section>',
-                    c = canvas.fromXML(xmlIn);
-
-                var xmlOut = c.toXML();
-                expect(xmlOut).to.equal(xmlIn);
-            });
-
-            it('keeps white space after detaching text element', function() {
-                var xmlIn = '<section><header>header</header>\n\
-                    \n\
-                text1\n\
-                    \n\
-            </section>',
-                    expectedXmlOut = '<section><header>header</header>\n\
-                    \n\
-                \n\
-                    \n\
-            </section>',
-                    c = canvas.fromXML(xmlIn),
-                    children = c.doc().children(),
-                    text = children[children.length-1];
-                
-                expect(text.getText()).to.equal('text1');
-
-                text.detach();
-
-                var xmlOut = c.toXML();
-                expect(xmlOut).to.equal(expectedXmlOut);
-            });
-
-        })
-    })
+    it('recognizes when browser selection boundaries lies in sibling DocumentTextElements', function() {
+        var c = getCanvasFromXML('<section>Alice <span>has</span> a <span>big</span> cat</section>'),
+            dom = c.doc().dom,
+            text = {
+                alice: findTextNode(dom, 'Alice '),
+                has: findTextNode(dom, 'has'),
+                a: findTextNode(dom, ' a '),
+                big: findTextNode(dom, 'big'),
+                cat: findTextNode(dom, ' cat'),
+            },
+            cursor = c.getCursor();
+
+        expect($(text.alice).text()).to.equal('Alice ');
+        expect($(text.has).text()).to.equal('has');
+        expect($(text.a).text()).to.equal(' a ');
+        expect($(text.big).text()).to.equal('big');
+        expect($(text.cat).text()).to.equal(' cat');
+
+        getSelection.returns({anchorNode: text.alice, focusNode: text.a});
+        expect(cursor.isSelectingSiblings()).to.equal(true, '"Alice" and "a" are children');
+
+        getSelection.returns({anchorNode: text.alice, focusNode: text.cat});
+        expect(cursor.isSelectingSiblings()).to.equal(true, '"Alice" and "cat" are children');
+
+        getSelection.returns({anchorNode: text.alice, focusNode: text.has});
+        expect(cursor.isSelectingSiblings()).to.equal(false, '"Alice" and "has" are not children');
+
+        getSelection.returns({anchorNode: text.has, focusNode: text.big});
+        expect(cursor.isSelectingSiblings()).to.equal(false, '"has" and "big" are not children');
+    });
 });
 
 });
 
-
 });
\ No newline at end of file
 });
\ No newline at end of file