rangy-rails 1.3alpha.772.0

data/vendor/assets/javascripts/rangy-selectionsaverestore.js

@@ -0,0 +1,237 @@
+/**
+ * Selection save and restore module for Rangy.
+ * Saves and restores user selections using marker invisible elements in the DOM.
+ *
+ * Part of Rangy, a cross-browser JavaScript range and selection library
+ * http://code.google.com/p/rangy/
+ *
+ * Depends on Rangy core.
+ *
+ * Copyright 2013, Tim Down
+ * Licensed under the MIT license.
+ * Version: 1.3alpha.772
+ * Build date: 26 February 2013
+ */
+rangy.createModule("SaveRestore", function(api, module) {
+    api.requireModules( ["DomUtil", "DomRange", "WrappedRange"] );
+
+    var dom = api.dom;
+
+    var markerTextChar = "\ufeff";
+
+    function gEBI(id, doc) {
+        return (doc || document).getElementById(id);
+    }
+
+    function insertRangeBoundaryMarker(range, atStart) {
+        var markerId = "selectionBoundary_" + (+new Date()) + "_" + ("" + Math.random()).slice(2);
+        var markerEl;
+        var doc = dom.getDocument(range.startContainer);
+
+        // Clone the Range and collapse to the appropriate boundary point
+        var boundaryRange = range.cloneRange();
+        boundaryRange.collapse(atStart);
+
+        // Create the marker element containing a single invisible character using DOM methods and insert it
+        markerEl = doc.createElement("span");
+        markerEl.id = markerId;
+        markerEl.style.lineHeight = "0";
+        markerEl.style.display = "none";
+        markerEl.className = "rangySelectionBoundary";
+        markerEl.appendChild(doc.createTextNode(markerTextChar));
+
+        boundaryRange.insertNode(markerEl);
+        boundaryRange.detach();
+        return markerEl;
+    }
+
+    function setRangeBoundary(doc, range, markerId, atStart) {
+        var markerEl = gEBI(markerId, doc);
+        if (markerEl) {
+            range[atStart ? "setStartBefore" : "setEndBefore"](markerEl);
+            markerEl.parentNode.removeChild(markerEl);
+        } else {
+            module.warn("Marker element has been removed. Cannot restore selection.");
+        }
+    }
+
+    function compareRanges(r1, r2) {
+        return r2.compareBoundaryPoints(r1.START_TO_START, r1);
+    }
+
+    function saveRange(range, backward) {
+        var startEl, endEl, doc = api.DomRange.getRangeDocument(range), text = range.toString();
+
+        if (range.collapsed) {
+            endEl = insertRangeBoundaryMarker(range, false);
+            return {
+                document: doc,
+                markerId: endEl.id,
+                collapsed: true
+            };
+        } else {
+            endEl = insertRangeBoundaryMarker(range, false);
+            startEl = insertRangeBoundaryMarker(range, true);
+
+            return {
+                document: doc,
+                startMarkerId: startEl.id,
+                endMarkerId: endEl.id,
+                collapsed: false,
+                backward: backward,
+                toString: function() {
+                    return "original text: '" + text + "', new text: '" + range.toString() + "'";
+                }
+            };
+        }
+    }
+
+    function restoreRange(rangeInfo, normalize) {
+        var doc = rangeInfo.document;
+        if (typeof normalize == "undefined") {
+            normalize = true;
+        }
+        var range = api.createRange(doc);
+        if (rangeInfo.collapsed) {
+            var markerEl = gEBI(rangeInfo.markerId, doc);
+            if (markerEl) {
+                markerEl.style.display = "inline";
+                var previousNode = markerEl.previousSibling;
+
+                // Workaround for issue 17
+                if (previousNode && previousNode.nodeType == 3) {
+                    markerEl.parentNode.removeChild(markerEl);
+                    range.collapseToPoint(previousNode, previousNode.length);
+                } else {
+                    range.collapseBefore(markerEl);
+                    markerEl.parentNode.removeChild(markerEl);
+                }
+            } else {
+                module.warn("Marker element has been removed. Cannot restore selection.");
+            }
+        } else {
+            setRangeBoundary(doc, range, rangeInfo.startMarkerId, true);
+            setRangeBoundary(doc, range, rangeInfo.endMarkerId, false);
+        }
+
+        if (normalize) {
+            range.normalizeBoundaries();
+        }
+
+        return range;
+    }
+
+    function saveRanges(ranges, backward) {
+        var rangeInfos = [], range, doc;
+
+        // Order the ranges by position within the DOM, latest first, cloning the array to leave the original untouched
+        ranges = ranges.slice(0);
+        ranges.sort(compareRanges);
+
+        for (var i = 0, len = ranges.length; i < len; ++i) {
+            rangeInfos[i] = saveRange(ranges[i], backward);
+        }
+
+        // Now that all the markers are in place and DOM manipulation over, adjust each range's boundaries to lie
+        // between its markers
+        for (i = len - 1; i >= 0; --i) {
+            range = ranges[i];
+            doc = api.DomRange.getRangeDocument(range);
+            if (range.collapsed) {
+                range.collapseAfter(gEBI(rangeInfos[i].markerId, doc));
+            } else {
+                range.setEndBefore(gEBI(rangeInfos[i].endMarkerId, doc));
+                range.setStartAfter(gEBI(rangeInfos[i].startMarkerId, doc));
+            }
+        }
+
+        return rangeInfos;
+    }
+
+    function saveSelection(win) {
+        if (!api.isSelectionValid(win)) {
+            module.warn("Cannot save selection. This usually happens when the selection is collapsed and the selection document has lost focus.");
+            return null;
+        }
+        var sel = api.getSelection(win);
+        var ranges = sel.getAllRanges();
+        var backward = (ranges.length == 1 && sel.isBackward());
+
+        var rangeInfos = saveRanges(ranges, backward);
+
+        // Ensure current selection is unaffected
+        if (backward) {
+            sel.setSingleRange(ranges[0], "backward");
+        } else {
+            sel.setRanges(ranges);
+        }
+
+        return {
+            win: win,
+            rangeInfos: rangeInfos,
+            restored: false
+        };
+    }
+
+    function restoreRanges(rangeInfos) {
+        var ranges = [];
+
+        // Ranges are in reverse order of appearance in the DOM. We want to restore earliest first to avoid
+        // normalization affecting previously restored ranges.
+        var rangeCount = rangeInfos.length;
+
+        for (var i = rangeCount - 1; i >= 0; i--) {
+            ranges[i] = restoreRange(rangeInfos[i], true);
+        }
+
+        return ranges;
+    }
+
+    function restoreSelection(savedSelection, preserveDirection) {
+        if (!savedSelection.restored) {
+            var rangeInfos = savedSelection.rangeInfos;
+            var sel = api.getSelection(savedSelection.win);
+            var ranges = restoreRanges(rangeInfos), rangeCount = rangeInfos.length;
+
+            if (rangeCount == 1 && preserveDirection && api.features.selectionHasExtend && rangeInfos[0].backward) {
+                sel.removeAllRanges();
+                sel.addRange(ranges[0], true);
+            } else {
+                sel.setRanges(ranges);
+            }
+
+            savedSelection.restored = true;
+        }
+    }
+
+    function removeMarkerElement(doc, markerId) {
+        var markerEl = gEBI(markerId, doc);
+        if (markerEl) {
+            markerEl.parentNode.removeChild(markerEl);
+        }
+    }
+
+    function removeMarkers(savedSelection) {
+        var rangeInfos = savedSelection.rangeInfos;
+        for (var i = 0, len = rangeInfos.length, rangeInfo; i < len; ++i) {
+            rangeInfo = rangeInfos[i];
+            if (rangeInfo.collapsed) {
+                removeMarkerElement(savedSelection.doc, rangeInfo.markerId);
+            } else {
+                removeMarkerElement(savedSelection.doc, rangeInfo.startMarkerId);
+                removeMarkerElement(savedSelection.doc, rangeInfo.endMarkerId);
+            }
+        }
+    }
+
+    api.util.extend(api, {
+        saveRange: saveRange,
+        restoreRange: restoreRange,
+        saveRanges: saveRanges,
+        restoreRanges: restoreRanges,
+        saveSelection: saveSelection,
+        restoreSelection: restoreSelection,
+        removeMarkerElement: removeMarkerElement,
+        removeMarkers: removeMarkers
+    });
+});

data/vendor/assets/javascripts/rangy-serializer.js

@@ -0,0 +1,294 @@
+/**
+ * Serializer module for Rangy.
+ * Serializes Ranges and Selections. An example use would be to store a user's selection on a particular page in a
+ * cookie or local storage and restore it on the user's next visit to the same page.
+ *
+ * Part of Rangy, a cross-browser JavaScript range and selection library
+ * http://code.google.com/p/rangy/
+ *
+ * Depends on Rangy core.
+ *
+ * Copyright 2013, Tim Down
+ * Licensed under the MIT license.
+ * Version: 1.3alpha.772
+ * Build date: 26 February 2013
+ */
+rangy.createModule("Serializer", function(api, module) {
+    api.requireModules( ["WrappedSelection", "WrappedRange"] );
+    var UNDEF = "undefined";
+
+    // encodeURIComponent and decodeURIComponent are required for cookie handling
+    if (typeof encodeURIComponent == UNDEF || typeof decodeURIComponent == UNDEF) {
+        module.fail("Global object is missing encodeURIComponent and/or decodeURIComponent method");
+    }
+
+    // Checksum for checking whether range can be serialized
+    var crc32 = (function() {
+        function utf8encode(str) {
+            var utf8CharCodes = [];
+
+            for (var i = 0, len = str.length, c; i < len; ++i) {
+                c = str.charCodeAt(i);
+                if (c < 128) {
+                    utf8CharCodes.push(c);
+                } else if (c < 2048) {
+                    utf8CharCodes.push((c >> 6) | 192, (c & 63) | 128);
+                } else {
+                    utf8CharCodes.push((c >> 12) | 224, ((c >> 6) & 63) | 128, (c & 63) | 128);
+                }
+            }
+            return utf8CharCodes;
+        }
+
+        var cachedCrcTable = null;
+
+        function buildCRCTable() {
+            var table = [];
+            for (var i = 0, j, crc; i < 256; ++i) {
+                crc = i;
+                j = 8;
+                while (j--) {
+                    if ((crc & 1) == 1) {
+                        crc = (crc >>> 1) ^ 0xEDB88320;
+                    } else {
+                        crc >>>= 1;
+                    }
+                }
+                table[i] = crc >>> 0;
+            }
+            return table;
+        }
+
+        function getCrcTable() {
+            if (!cachedCrcTable) {
+                cachedCrcTable = buildCRCTable();
+            }
+            return cachedCrcTable;
+        }
+
+        return function(str) {
+            var utf8CharCodes = utf8encode(str), crc = -1, crcTable = getCrcTable();
+            for (var i = 0, len = utf8CharCodes.length, y; i < len; ++i) {
+                y = (crc ^ utf8CharCodes[i]) & 0xFF;
+                crc = (crc >>> 8) ^ crcTable[y];
+            }
+            return (crc ^ -1) >>> 0;
+        };
+    })();
+
+    var dom = api.dom;
+
+    function escapeTextForHtml(str) {
+        return str.replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    }
+
+    function nodeToInfoString(node, infoParts) {
+        infoParts = infoParts || [];
+        var nodeType = node.nodeType, children = node.childNodes, childCount = children.length;
+        var nodeInfo = [nodeType, node.nodeName, childCount].join(":");
+        var start = "", end = "";
+        switch (nodeType) {
+            case 3: // Text node
+                start = escapeTextForHtml(node.nodeValue);
+                break;
+            case 8: // Comment
+                start = "<!--" + escapeTextForHtml(node.nodeValue) + "-->";
+                break;
+            default:
+                start = "<" + nodeInfo + ">";
+                end = "</>";
+                break;
+        }
+        if (start) {
+            infoParts.push(start);
+        }
+        for (var i = 0; i < childCount; ++i) {
+            nodeToInfoString(children[i], infoParts);
+        }
+        if (end) {
+            infoParts.push(end);
+        }
+        return infoParts;
+    }
+
+    // Creates a string representation of the specified element's contents that is similar to innerHTML but omits all
+    // attributes and comments and includes child node counts. This is done instead of using innerHTML to work around
+    // IE <= 8's policy of including element properties in attributes, which ruins things by changing an element's
+    // innerHTML whenever the user changes an input within the element.
+    function getElementChecksum(el) {
+        var info = nodeToInfoString(el).join("");
+        return crc32(info).toString(16);
+    }
+
+    function serializePosition(node, offset, rootNode) {
+        var pathBits = [], n = node;
+        rootNode = rootNode || dom.getDocument(node).documentElement;
+        while (n && n != rootNode) {
+            pathBits.push(dom.getNodeIndex(n, true));
+            n = n.parentNode;
+        }
+        return pathBits.join("/") + ":" + offset;
+    }
+
+    function deserializePosition(serialized, rootNode, doc) {
+        if (!rootNode) {
+            rootNode = (doc || document).documentElement;
+        }
+        var bits = serialized.split(":");
+        var node = rootNode;
+        var nodeIndices = bits[0] ? bits[0].split("/") : [], i = nodeIndices.length, nodeIndex;
+
+        while (i--) {
+            nodeIndex = parseInt(nodeIndices[i], 10);
+            if (nodeIndex < node.childNodes.length) {
+                node = node.childNodes[nodeIndex];
+            } else {
+                throw module.createError("deserializePosition() failed: node " + dom.inspectNode(node) +
+                        " has no child with index " + nodeIndex + ", " + i);
+            }
+        }
+
+        return new dom.DomPosition(node, parseInt(bits[1], 10));
+    }
+
+    function serializeRange(range, omitChecksum, rootNode) {
+        rootNode = rootNode || api.DomRange.getRangeDocument(range).documentElement;
+        if (!dom.isOrIsAncestorOf(rootNode, range.commonAncestorContainer)) {
+            throw module.createError("serializeRange(): range " + range.inspect() +
+                " is not wholly contained within specified root node " + dom.inspectNode(rootNode));
+        }
+        var serialized = serializePosition(range.startContainer, range.startOffset, rootNode) + "," +
+            serializePosition(range.endContainer, range.endOffset, rootNode);
+        if (!omitChecksum) {
+            serialized += "{" + getElementChecksum(rootNode) + "}";
+        }
+        return serialized;
+    }
+
+    function deserializeRange(serialized, rootNode, doc) {
+        if (rootNode) {
+            doc = doc || dom.getDocument(rootNode);
+        } else {
+            doc = doc || document;
+            rootNode = doc.documentElement;
+        }
+        var result = /^([^,]+),([^,\{]+)(\{([^}]+)\})?$/.exec(serialized);
+        var checksum = result[4], rootNodeChecksum = getElementChecksum(rootNode);
+        if (checksum && checksum !== getElementChecksum(rootNode)) {
+            throw module.createError("deserializeRange(): checksums of serialized range root node (" + checksum +
+                    ") and target root node (" + rootNodeChecksum + ") do not match");
+        }
+        var start = deserializePosition(result[1], rootNode, doc), end = deserializePosition(result[2], rootNode, doc);
+        var range = api.createRange(doc);
+        range.setStartAndEnd(start.node, start.offset, end.node, end.offset);
+        return range;
+    }
+
+    function canDeserializeRange(serialized, rootNode, doc) {
+        if (!rootNode) {
+            rootNode = (doc || document).documentElement;
+        }
+        var result = /^([^,]+),([^,]+)(\{([^}]+)\})?$/.exec(serialized);
+        var checksum = result[3];
+        return !checksum || checksum === getElementChecksum(rootNode);
+    }
+
+    function serializeSelection(selection, omitChecksum, rootNode) {
+        selection = api.getSelection(selection);
+        var ranges = selection.getAllRanges(), serializedRanges = [];
+        for (var i = 0, len = ranges.length; i < len; ++i) {
+            serializedRanges[i] = serializeRange(ranges[i], omitChecksum, rootNode);
+        }
+        return serializedRanges.join("|");
+    }
+
+    function deserializeSelection(serialized, rootNode, win) {
+        if (rootNode) {
+            win = win || dom.getWindow(rootNode);
+        } else {
+            win = win || window;
+            rootNode = win.document.documentElement;
+        }
+        var serializedRanges = serialized.split("|");
+        var sel = api.getSelection(win);
+        var ranges = [];
+
+        for (var i = 0, len = serializedRanges.length; i < len; ++i) {
+            ranges[i] = deserializeRange(serializedRanges[i], rootNode, win.document);
+        }
+        sel.setRanges(ranges);
+
+        return sel;
+    }
+
+    function canDeserializeSelection(serialized, rootNode, win) {
+        var doc;
+        if (rootNode) {
+            doc = win ? win.document : dom.getDocument(rootNode);
+        } else {
+            win = win || window;
+            rootNode = win.document.documentElement;
+        }
+        var serializedRanges = serialized.split("|");
+
+        for (var i = 0, len = serializedRanges.length; i < len; ++i) {
+            if (!canDeserializeRange(serializedRanges[i], rootNode, doc)) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    var cookieName = "rangySerializedSelection";
+
+    function getSerializedSelectionFromCookie(cookie) {
+        var parts = cookie.split(/[;,]/);
+        for (var i = 0, len = parts.length, nameVal, val; i < len; ++i) {
+            nameVal = parts[i].split("=");
+            if (nameVal[0].replace(/^\s+/, "") == cookieName) {
+                val = nameVal[1];
+                if (val) {
+                    return decodeURIComponent(val.replace(/\s+$/, ""));
+                }
+            }
+        }
+        return null;
+    }
+
+    function restoreSelectionFromCookie(win) {
+        win = win || window;
+        var serialized = getSerializedSelectionFromCookie(win.document.cookie);
+        if (serialized) {
+            deserializeSelection(serialized, win.doc);
+        }
+    }
+
+    function saveSelectionCookie(win, props) {
+        win = win || window;
+        props = (typeof props == "object") ? props : {};
+        var expires = props.expires ? ";expires=" + props.expires.toUTCString() : "";
+        var path = props.path ? ";path=" + props.path : "";
+        var domain = props.domain ? ";domain=" + props.domain : "";
+        var secure = props.secure ? ";secure" : "";
+        var serialized = serializeSelection(api.getSelection(win));
+        win.document.cookie = encodeURIComponent(cookieName) + "=" + encodeURIComponent(serialized) + expires + path + domain + secure;
+    }
+
+    api.serializePosition = serializePosition;
+    api.deserializePosition = deserializePosition;
+
+    api.serializeRange = serializeRange;
+    api.deserializeRange = deserializeRange;
+    api.canDeserializeRange = canDeserializeRange;
+
+    api.serializeSelection = serializeSelection;
+    api.deserializeSelection = deserializeSelection;
+    api.canDeserializeSelection = canDeserializeSelection;
+
+    api.restoreSelectionFromCookie = restoreSelectionFromCookie;
+    api.saveSelectionCookie = saveSelectionCookie;
+
+    api.getElementChecksum = getElementChecksum;
+    api.nodeToInfoString = nodeToInfoString;
+});