/*!
* VisualEditor DataModel InternalList class.
*
* @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* DataModel meta item.
*
* @class
* @mixins ve.EventEmitter
*
* @constructor
* @param {ve.dm.Document} doc Document model
*/
ve.dm.InternalList = function VeDmInternalList( doc ) {
// Mixin constructors
ve.EventEmitter.call( this );
// Properties
this.document = doc;
this.store = new ve.dm.IndexValueStore();
this.itemHtmlQueue = [];
this.listNode = null;
this.nodes = {};
// Event handlers
// this.getDocument().connect( this, { 'transact': 'onTransact' } );
};
/* Inheritance */
ve.mixinClass( ve.dm.InternalList, ve.EventEmitter );
/* Methods */
/**
* Queues up an item's html for parsing later.
*
* If an item with the specified group and key already exists it will be ignored.
*
* @method
* @param {string} groupName Item group
* @param {string} key Item key
* @param {string} html Item contents
* @returns {number} Index of the item in the index-value store, and also the list
*/
ve.dm.InternalList.prototype.queueItemHtml = function ( groupName, key, html ) {
var index = this.getStore().indexOfHash( groupName + '/' + key );
if ( index === null ) {
index = this.getStore().index( html, groupName + '/' + key );
this.itemHtmlQueue.push( index );
}
return index;
};
/**
* Gets all the item's HTML strings
* @method
* @returns {Object} Name-indexed object containing HTMLElements
*/
ve.dm.InternalList.prototype.getItemHtmlQueue = function () {
return this.getStore().values( this.itemHtmlQueue );
};
/**
* Gets the internal list's document model
* @method
* @returns {ve.dm.Document} Document model
*/
ve.dm.InternalList.prototype.getDocument = function () {
return this.document;
};
/**
* Gets the internal list's index value store
* @method
* @returns {ve.dm.IndexValueStore} Index value store
*/
ve.dm.InternalList.prototype.getStore = function () {
return this.store;
};
/**
* Get the list node
* @method
* @returns {ve.dm.InternalListNode} List node
*/
ve.dm.InternalList.prototype.getListNode = function () {
var i, nodes;
// find listNode if not set, or unattached
if ( !this.listNode || !this.listNode.doc ) {
nodes = this.getDocument().documentNode.children;
for ( i = nodes.length; i >= 0; i-- ) {
if ( nodes[i] instanceof ve.dm.InternalListNode ) {
this.listNode = nodes[i];
break;
}
}
}
return this.listNode;
};
/**
* Get the item node from a specific index
* @method
* @param {number} index Item's index
* @returns {ve.dm.InternalItemNode} Item node
*/
ve.dm.InternalList.prototype.getItemNode = function ( index ) {
return this.getListNode().children[index];
};
/**
* Converts stored item HTML into linear data.
*
* Each item is an InternalItem, and they are wrapped in an InternalList.
* If there are no items an empty array is returned.
*
* Stored HTML is deleted after conversion.
*
* @method
* @param {ve.dm.Converter} converter Converter object
* @returns {Array} Linear model data
*/
ve.dm.InternalList.prototype.convertToData = function ( converter ) {
var i, length, itemData,
itemHtmlQueue = this.getItemHtmlQueue(), list = [];
if ( itemHtmlQueue.length ) {
list.push( { 'type': 'internalList' } );
for ( i = 0, length = itemHtmlQueue.length; i < length; i++ ) {
itemData = converter.getDataFromDomRecursion( $( '
' ).html( itemHtmlQueue[i] )[0] );
list = list.concat(
[{ 'type': 'internalItem' }],
itemData,
[{ 'type': '/internalItem' }]
);
}
list.push( { 'type': '/internalList' } );
}
// After conversion we no longer need the HTML
this.itemHtmlQueue = [];
return list;
};
/**
* Add a node.
* @method
* @param {string} groupName Item group
* @param {string} key Item name
* @param {ve.dm.Node} node Item node
*/
ve.dm.InternalList.prototype.addNode = function ( groupName, key, node ) {
var i, len, start, keyNodes, group = this.nodes[groupName];
// The group may not exist yet
if ( group === undefined ) {
group = this.nodes[groupName] = {
keyNodes: {},
keyOrder: []
};
}
keyNodes = group.keyNodes[key];
// The key may not exist yet
if ( keyNodes === undefined ) {
keyNodes = group.keyNodes[key] = [];
}
if ( ve.indexOf( key, group.keyOrder ) === -1 ) {
group.keyOrder.push( key );
}
if ( node.getDocument().buildingNodeTree ) {
// If the document is building the original node tree
// then every item is being added in order, so we don't
// need to worry about sorting.
keyNodes.push( node );
} else {
// TODO: We could use binary search insertion sort
start = node.getRange().start;
for ( i = 0, len = keyNodes.length; i < len; i++ ) {
if ( start < keyNodes[i].getRange().start ) {
break;
}
}
// 'i' is now the insertion point, so add the node here
keyNodes.splice( i, 0, node );
this.sortGroupKeys( group );
}
};
/**
* Remove a node.
* @method
* @param {string} groupName Item group
* @param {string} key Item name
* @param {ve.dm.Node} node Item node
*/
ve.dm.InternalList.prototype.removeNode = function ( groupName, key, node ) {
var i, len, j,
group = this.nodes[groupName],
keyNodes = group.keyNodes[key];
for ( i = 0, len = keyNodes.length; i < len; i++ ) {
if ( keyNodes[i] === node ) {
keyNodes.splice( i, 1 );
if ( keyNodes.length === 0 ) {
delete group.keyNodes[key];
j = ve.indexOf( key, group.keyOrder );
group.keyOrder.splice( j, 1 );
} else {
// If the key has been emptied then removing it from the keyOrder
// array is sufficient to keep it ordered, otherwise we need to
// re-sort the keys, as we don't know the position of the new
// 0th item in the key
this.sortGroupKeys( group );
}
break;
}
}
};
/**
* Sort the keyOrder array within a group object.
* @param {Object} group Group object
*/
ve.dm.InternalList.prototype.sortGroupKeys = function ( group ) {
// Sort keyOrder
group.keyOrder.sort( function ( key1, key2 ) {
return group.keyNodes[key1][0].getRange().start - group.keyNodes[key2][0].getRange().start;
} );
};
/**
* Clone this internal list.
*
* @param {ve.dm.Document} [doc] The new list's document. Defaults to this list's document.
* @returns {ve.dm.InternalList} Clone of this internal
*/
ve.dm.InternalList.prototype.clone = function ( doc ) {
var clone = new this.constructor( doc || this.getDocument() );
clone.store = this.getStore().clone();
return clone;
};
/**
* Merge another document's internal list into this one.
*
* Objects that are in other but not in this are added to this, possibly with a different index.
*
* @param {ve.dm.InternalList} other List to merge into this one
* @returns {Object} Object in which the keys are indexes in other and the values are the corresponding keys in this
*/
ve.dm.InternalList.prototype.merge = function ( other ) {
var i, len, index, storeMapping = this.getStore().merge( other.getStore() ), mapping = {};
for ( i = 0, len = other.itemHtmlQueue.length; i < len; i++ ) {
other.itemHtmlQueue[i] = storeMapping[other.itemHtmlQueue[i]];
index = ve.indexOf( other.itemHtmlQueue[i], this.itemHtmlQueue );
if ( index === -1 ) {
index = this.itemHtmlQueue.push( other.itemHtmlQueue[i] ) - 1;
}
mapping[i] = index;
}
return mapping;
};