'use strict'; var map = require('../../utils/array').map; var join = require('../../utils/array').join; var escape = require('../../utils/string').escape; function factory (type, config, load, typed) { var register = load(require('./compile')).register; var compile = load(require('./compile')).compile; var Node = load(require('./Node')); var RangeNode = load(require('./RangeNode')); var SymbolNode = load(require('./SymbolNode')); var Range = load(require('../../type/matrix/Range')); var isArray = Array.isArray; /** * @constructor IndexNode * @extends Node * * Describes a subset of a matrix or an object property. * Cannot be used on its own, needs to be used within an AccessorNode or * AssignmentNode. * * @param {Node[]} dimensions * @param {boolean} [dotNotation=false] Optional property describing whether * this index was written using dot * notation like `a.b`, or using bracket * notation like `a["b"]` (default). * Used to stringify an IndexNode. */ function IndexNode(dimensions, dotNotation) { if (!(this instanceof IndexNode)) { throw new SyntaxError('Constructor must be called with the new operator'); } this.dimensions = dimensions; this.dotNotation = dotNotation || false; // validate input if (!isArray(dimensions) || !dimensions.every(type.isNode)) { throw new TypeError('Array containing Nodes expected for parameter "dimensions"'); } if (this.dotNotation && !this.isObjectProperty()) { throw new Error('dotNotation only applicable for object properties'); } // TODO: deprecated since v3, remove some day var deprecated = function () { throw new Error('Property `IndexNode.object` is deprecated, use `IndexNode.fn` instead'); }; Object.defineProperty(this, 'object', { get: deprecated, set: deprecated }); } IndexNode.prototype = new Node(); IndexNode.prototype.type = 'IndexNode'; IndexNode.prototype.isIndexNode = true; /** * Compile all range nodes * * When some of the dimensions has `end` defined, the IndexNode requires * a variable `size` to be defined in the current closure, and must contain * the size of the matrix that's being handled. To check whether the `size` * variable is needed, call IndexNode.needsSize(). * * @param {IndexNode} node The node to be compiled * @param {Object} defs Object which can be used to define functions * or constants globally available for the * compiled expression * @param {Object} args Object with local function arguments, the key is * the name of the argument, and the value is `true`. * The object may not be mutated, but must be * extended instead. * @return {string} code */ function compileIndexNode(node, defs, args) { if (!(node instanceof IndexNode)) { throw new TypeError('No valid IndexNode') } // args can be mutated by IndexNode, when dimensions use `end` var childArgs = Object.create(args); // helper function to create a Range from start, step and end defs.range = function (start, end, step) { return new Range( type.isBigNumber(start) ? start.toNumber() : start, type.isBigNumber(end) ? end.toNumber() : end, type.isBigNumber(step) ? step.toNumber() : step ); }; // TODO: implement support for bignumber (currently bignumbers are silently // reduced to numbers when changing the value to zero-based) // TODO: Optimization: when the range values are ConstantNodes, // we can beforehand resolve the zero-based value // optimization for a simple object property var dimensions = map(node.dimensions, function (range, i) { if (type.isRangeNode(range)) { if (range.needsEnd()) { childArgs.end = 'end'; // resolve end and create range return '(function () {' + 'var end = size[' + i + ']; ' + 'return range(' + compile(range.start, defs, childArgs) + ', ' + compile(range.end, defs, childArgs) + ', ' + (range.step ? compile(range.step, defs, childArgs) : '1') + '); ' + '})()'; } else { // create range return 'range(' + compile(range.start, defs, childArgs) + ', ' + compile(range.end, defs, childArgs) + ', ' + (range.step ? compile(range.step, defs, childArgs) : '1') + ')'; } } if (type.isSymbolNode(range) && range.name === 'end') { childArgs.end = 'end'; // resolve the parameter 'end' return '(function () {' + 'var end = size[' + i + ']; ' + 'return ' + compile(range, defs, childArgs) + '; ' + '})()' } else { // ConstantNode return compile(range, defs, childArgs); } }); return 'math.index(' + join(dimensions, ', ') + ')'; } // register the compile function register(IndexNode.prototype.type, compileIndexNode); /** * Execute a callback for each of the child nodes of this node * @param {function(child: Node, path: string, parent: Node)} callback */ IndexNode.prototype.forEach = function (callback) { for (var i = 0; i < this.dimensions.length; i++) { callback(this.dimensions[i], 'dimensions[' + i + ']', this); } }; /** * Create a new IndexNode having it's childs be the results of calling * the provided callback function for each of the childs of the original node. * @param {function(child: Node, path: string, parent: Node): Node} callback * @returns {IndexNode} Returns a transformed copy of the node */ IndexNode.prototype.map = function (callback) { var dimensions = []; for (var i = 0; i < this.dimensions.length; i++) { dimensions[i] = this._ifNode(callback(this.dimensions[i], 'dimensions[' + i + ']', this)); } return new IndexNode(dimensions); }; /** * Create a clone of this node, a shallow copy * @return {IndexNode} */ IndexNode.prototype.clone = function () { return new IndexNode(this.dimensions.slice(0)); }; /** * Test whether this IndexNode contains a single property name * @return {boolean} */ IndexNode.prototype.isObjectProperty = function () { return this.dimensions.length === 1 && type.isConstantNode(this.dimensions[0]) && this.dimensions[0].valueType === 'string'; }; /** * Returns the property name if IndexNode contains a property. * If not, returns null. * @return {string | null} */ IndexNode.prototype.getObjectProperty = function () { return this.isObjectProperty() ? this.dimensions[0].value : null; }; /** * Get string representation * @param {Object} options * @return {string} str */ IndexNode.prototype._toString = function (options) { // format the parameters like "[1, 0:5]" return this.dotNotation ? ('.' + this.getObjectProperty()) : ('[' + this.dimensions.join(', ') + ']'); }; /** * Get HTML representation * @param {Object} options * @return {string} str */ IndexNode.prototype.toHTML = function (options) { // format the parameters like "[1, 0:5]" var dimensions = [] for (var i=0; i.' + '' + escape(this.getObjectProperty()) + '';} else { return '[' + dimensions.join(',') + ']'} }; /** * Get LaTeX representation * @param {Object} options * @return {string} str */ IndexNode.prototype._toTex = function (options) { var dimensions = this.dimensions.map(function (range) { return range.toTex(options); }); return this.dotNotation ? ('.' + this.getObjectProperty() + '') : ('_{' + dimensions.join(',') + '}'); }; /** * Test whether this IndexNode needs the object size, size of the Matrix * @return {boolean} */ IndexNode.prototype.needsSize = function () { return this.dimensions.some(function (range) { return (type.isRangeNode(range) && range.needsEnd()) || (type.isSymbolNode(range) && range.name === 'end'); }); }; return IndexNode; } exports.name = 'IndexNode'; exports.path = 'expression.node'; exports.factory = factory;