/* Copyright 2020 Bruno Windels Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ /* lookups will be far more frequent than changing fragment order, so data structure should be optimized for fast lookup we can have a Map: fragmentId to sortIndex changing the order, we would need to rebuild the index lets do this the stupid way for now, changing any fragment rebuilds all islands to build this: first load all fragments put them in a map by id now iterate through them until no more fragments get the first create an island array, and add to list with islands going backwards and forwards get and remove sibling and prepend/append it to island array stop when no more previous/next return list with islands */ import {isValidFragmentId} from "./common.js"; function findBackwardSiblingFragments(current, byId) { const sortedSiblings = []; while (isValidFragmentId(current.previousId)) { const previous = byId.get(current.previousId); if (!previous) { break; } if (previous.nextId !== current.id) { throw new Error(`Previous fragment ${previous.id} doesn't point back to ${current.id}`); } byId.delete(current.previousId); sortedSiblings.unshift(previous); current = previous; } return sortedSiblings; } function findForwardSiblingFragments(current, byId) { const sortedSiblings = []; while (isValidFragmentId(current.nextId)) { const next = byId.get(current.nextId); if (!next) { break; } if (next.previousId !== current.id) { throw new Error(`Next fragment ${next.id} doesn't point back to ${current.id}`); } byId.delete(current.nextId); sortedSiblings.push(next); current = next; } return sortedSiblings; } function createIslands(fragments) { const byId = new Map(); for(let f of fragments) { byId.set(f.id, f); } const islands = []; while(byId.size) { const current = byId.values().next().value; byId.delete(current.id); // new island const previousSiblings = findBackwardSiblingFragments(current, byId); const nextSiblings = findForwardSiblingFragments(current, byId); const island = previousSiblings.concat(current, nextSiblings); islands.push(island); } return islands.map(a => new Island(a)); } class Fragment { constructor(id, previousId, nextId) { this.id = id; this.previousId = previousId; this.nextId = nextId; } } class Island { constructor(sortedFragments) { this._idToSortIndex = new Map(); sortedFragments.forEach((f, i) => { this._idToSortIndex.set(f.id, i); }); } compare(idA, idB) { const sortIndexA = this._idToSortIndex.get(idA); if (sortIndexA === undefined) { throw new Error(`first id ${idA} isn't part of this island`); } const sortIndexB = this._idToSortIndex.get(idB); if (sortIndexB === undefined) { throw new Error(`second id ${idB} isn't part of this island`); } return sortIndexA - sortIndexB; } get fragmentIds() { return this._idToSortIndex.keys(); } } /* index for fast lookup of how two fragments can be sorted */ export class FragmentIdComparer { constructor(fragments) { this._fragmentsById = fragments.reduce((map, f) => {map.set(f.id, f); return map;}, new Map()); this.rebuild(fragments); } _getIsland(id) { const island = this._idToIsland.get(id); if (island === undefined) { throw new Error(`Unknown fragment id ${id}`); } return island; } compare(idA, idB) { if (idA === idB) { return 0; } const islandA = this._getIsland(idA); const islandB = this._getIsland(idB); if (islandA !== islandB) { throw new Error(`${idA} and ${idB} are on different islands, can't tell order`); } return islandA.compare(idA, idB); } rebuild(fragments) { const islands = createIslands(fragments); this._idToIsland = new Map(); for(let island of islands) { for(let id of island.fragmentIds) { this._idToIsland.set(id, island); } } } /** use for fragments coming out of persistence, not newly created ones, or also fragments for a new island (like for a permalink) */ add(fragment) { const copy = new Fragment(fragment.id, fragment.previousId, fragment.nextId); this._fragmentsById.set(fragment.id, copy); this.rebuild(this._fragmentsById.values()); } /** use for appending newly created fragments */ append(id, previousId) { const fragment = new Fragment(id, previousId, null); const prevFragment = this._fragmentsById.get(previousId); if (prevFragment) { prevFragment.nextId = id; } this._fragmentsById.set(id, fragment); this.rebuild(this._fragmentsById.values()); } /** use for prepending newly created fragments */ prepend(id, nextId) { const fragment = new Fragment(id, null, nextId); const nextFragment = this._fragmentsById.get(nextId); if (nextFragment) { nextFragment.previousId = id; } this._fragmentsById.set(id, fragment); this.rebuild(this._fragmentsById.values()); } } export function tests() { return { test_1_island_3_fragments(assert) { const index = new FragmentIdComparer([ {id: 3, previousId: 2}, {id: 1, nextId: 2}, {id: 2, nextId: 3, previousId: 1}, ]); assert(index.compare(1, 2) < 0); assert(index.compare(2, 1) > 0); assert(index.compare(1, 3) < 0); assert(index.compare(3, 1) > 0); assert(index.compare(2, 3) < 0); assert(index.compare(3, 2) > 0); assert.equal(index.compare(1, 1), 0); }, test_falsy_id(assert) { const index = new FragmentIdComparer([ {id: 0, nextId: 1}, {id: 1, previousId: 0}, ]); assert(index.compare(0, 1) < 0); assert(index.compare(1, 0) > 0); }, test_falsy_id_reverse(assert) { const index = new FragmentIdComparer([ {id: 1, previousId: 0}, {id: 0, nextId: 1}, ]); assert(index.compare(0, 1) < 0); assert(index.compare(1, 0) > 0); }, test_allow_unknown_id(assert) { // as we tend to load fragments incrementally // as events come into view, we need to allow // unknown previousId/nextId in the fragments that we do load assert.doesNotThrow(() => { new FragmentIdComparer([ {id: 1, previousId: 2}, {id: 0, nextId: 3}, ]); }); }, test_throw_on_link_mismatch(assert) { // as we tend to load fragments incrementally // as events come into view, we need to allow // unknown previousId/nextId in the fragments that we do load assert.throws(() => { new FragmentIdComparer([ {id: 1, previousId: 0}, {id: 0, nextId: 2}, ]); }); }, test_2_island_dont_compare(assert) { const index = new FragmentIdComparer([ {id: 1}, {id: 2}, ]); assert.throws(() => index.compare(1, 2)); assert.throws(() => index.compare(2, 1)); }, test_2_island_compare_internally(assert) { const index = new FragmentIdComparer([ {id: 1, nextId: 2}, {id: 2, previousId: 1}, {id: 11, nextId: 12}, {id: 12, previousId: 11}, ]); assert(index.compare(1, 2) < 0); assert(index.compare(11, 12) < 0); assert.throws(() => index.compare(1, 11)); assert.throws(() => index.compare(12, 2)); }, test_unknown_id(assert) { const index = new FragmentIdComparer([{id: 1}]); assert.throws(() => index.compare(1, 2)); assert.throws(() => index.compare(2, 1)); }, test_rebuild_flushes_old_state(assert) { const index = new FragmentIdComparer([ {id: 1, nextId: 2}, {id: 2, previousId: 1}, ]); index.rebuild([ {id: 11, nextId: 12}, {id: 12, previousId: 11}, ]); assert.throws(() => index.compare(1, 2)); assert(index.compare(11, 12) < 0); }, test_append(assert) { const index = new FragmentIdComparer([]); // add livefragment when opening timeline, // note that there is no nextId as the sync // hasn't come in yet index.add({id: 1}); // now sync comes in and replaces the live fragment index.append(2, 1); assert(index.compare(1, 2) < 0); }, test_prepend(assert) { const index = new FragmentIdComparer([]); index.add({id: 2}); index.prepend(1, 2); assert(index.compare(1, 2) < 0); } } }