1 | //! stable.js 0.1.8, https://github.com/Two-Screen/stable
|
---|
2 | //! © 2018 Angry Bytes and contributors. MIT licensed.
|
---|
3 |
|
---|
4 | (function (global, factory) {
|
---|
5 | typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
|
---|
6 | typeof define === 'function' && define.amd ? define(factory) :
|
---|
7 | (global.stable = factory());
|
---|
8 | }(this, (function () { 'use strict';
|
---|
9 |
|
---|
10 | // A stable array sort, because `Array#sort()` is not guaranteed stable.
|
---|
11 | // This is an implementation of merge sort, without recursion.
|
---|
12 |
|
---|
13 | var stable = function (arr, comp) {
|
---|
14 | return exec(arr.slice(), comp)
|
---|
15 | };
|
---|
16 |
|
---|
17 | stable.inplace = function (arr, comp) {
|
---|
18 | var result = exec(arr, comp);
|
---|
19 |
|
---|
20 | // This simply copies back if the result isn't in the original array,
|
---|
21 | // which happens on an odd number of passes.
|
---|
22 | if (result !== arr) {
|
---|
23 | pass(result, null, arr.length, arr);
|
---|
24 | }
|
---|
25 |
|
---|
26 | return arr
|
---|
27 | };
|
---|
28 |
|
---|
29 | // Execute the sort using the input array and a second buffer as work space.
|
---|
30 | // Returns one of those two, containing the final result.
|
---|
31 | function exec(arr, comp) {
|
---|
32 | if (typeof(comp) !== 'function') {
|
---|
33 | comp = function (a, b) {
|
---|
34 | return String(a).localeCompare(b)
|
---|
35 | };
|
---|
36 | }
|
---|
37 |
|
---|
38 | // Short-circuit when there's nothing to sort.
|
---|
39 | var len = arr.length;
|
---|
40 | if (len <= 1) {
|
---|
41 | return arr
|
---|
42 | }
|
---|
43 |
|
---|
44 | // Rather than dividing input, simply iterate chunks of 1, 2, 4, 8, etc.
|
---|
45 | // Chunks are the size of the left or right hand in merge sort.
|
---|
46 | // Stop when the left-hand covers all of the array.
|
---|
47 | var buffer = new Array(len);
|
---|
48 | for (var chk = 1; chk < len; chk *= 2) {
|
---|
49 | pass(arr, comp, chk, buffer);
|
---|
50 |
|
---|
51 | var tmp = arr;
|
---|
52 | arr = buffer;
|
---|
53 | buffer = tmp;
|
---|
54 | }
|
---|
55 |
|
---|
56 | return arr
|
---|
57 | }
|
---|
58 |
|
---|
59 | // Run a single pass with the given chunk size.
|
---|
60 | var pass = function (arr, comp, chk, result) {
|
---|
61 | var len = arr.length;
|
---|
62 | var i = 0;
|
---|
63 | // Step size / double chunk size.
|
---|
64 | var dbl = chk * 2;
|
---|
65 | // Bounds of the left and right chunks.
|
---|
66 | var l, r, e;
|
---|
67 | // Iterators over the left and right chunk.
|
---|
68 | var li, ri;
|
---|
69 |
|
---|
70 | // Iterate over pairs of chunks.
|
---|
71 | for (l = 0; l < len; l += dbl) {
|
---|
72 | r = l + chk;
|
---|
73 | e = r + chk;
|
---|
74 | if (r > len) r = len;
|
---|
75 | if (e > len) e = len;
|
---|
76 |
|
---|
77 | // Iterate both chunks in parallel.
|
---|
78 | li = l;
|
---|
79 | ri = r;
|
---|
80 | while (true) {
|
---|
81 | // Compare the chunks.
|
---|
82 | if (li < r && ri < e) {
|
---|
83 | // This works for a regular `sort()` compatible comparator,
|
---|
84 | // but also for a simple comparator like: `a > b`
|
---|
85 | if (comp(arr[li], arr[ri]) <= 0) {
|
---|
86 | result[i++] = arr[li++];
|
---|
87 | }
|
---|
88 | else {
|
---|
89 | result[i++] = arr[ri++];
|
---|
90 | }
|
---|
91 | }
|
---|
92 | // Nothing to compare, just flush what's left.
|
---|
93 | else if (li < r) {
|
---|
94 | result[i++] = arr[li++];
|
---|
95 | }
|
---|
96 | else if (ri < e) {
|
---|
97 | result[i++] = arr[ri++];
|
---|
98 | }
|
---|
99 | // Both iterators are at the chunk ends.
|
---|
100 | else {
|
---|
101 | break
|
---|
102 | }
|
---|
103 | }
|
---|
104 | }
|
---|
105 | };
|
---|
106 |
|
---|
107 | return stable;
|
---|
108 |
|
---|
109 | })));
|
---|