enigma-bbs/core/view.js

/* jslint node: true */
'use strict';

var events		= require('events');
var util		= require('util');
var assert		= require('assert');
var ansi		= require('./ansi_term.js');
var _			= require('lodash');

exports.View							= View;
exports.VIEW_SPECIAL_KEY_MAP_DEFAULT	= VIEW_SPECIAL_KEY_MAP_DEFAULT;

var VIEW_SPECIAL_KEY_MAP_DEFAULT = {
	accept		: [ 'enter' ],
	exit		: [ 'esc' ],
	backspace	: [ 'backspace', 'del' ],
	del			: [ 'del' ],
	next		: [ 'tab' ],
	up			: [ 'up arrow' ],
	down		: [ 'down arrow' ],
	end			: [ 'end' ],
	home		: [ 'home' ],
	left		: [ 'left arrow' ],
	right		: [ 'right arrow' ],
	clearLine	: [ 'end of medium' ],
};

function View(options) {
	events.EventEmitter.call(this);

	assert(_.isObject(options));
	assert(_.isObject(options.client));

	var self			= this;

	this.client			= options.client;
	
	this.cursor			= options.cursor || 'show';
	this.cursorStyle	= options.cursorStyle || 'default';

	this.acceptsFocus	= options.acceptsFocus || false;
	this.acceptsInput	= options.acceptsInput || false;

	this.position 		= { x : 0, y : 0 };
	this.dimens			= { height : 1, width : 0 };

	this.textStyle		= options.textStyle || 'normal';
	this.focusTextStyle	= options.focusTextStyle || this.textStyle;

	if(options.id) {
		this.setId(options.id);
	}

	if(options.position) {
		this.setPosition(options.position);
	}

	//	:TODO: Don't allow width/height > client.term
	if(options.dimens && options.dimens.height) {
		this.dimens.height = options.dimens.height;
	}

	if(options.dimens && options.dimens.width) {
		this.dimens.width = options.dimens.width;
	}

	this.color			= options.color || { flags : 0, fg : 7,  bg : 0 };
	this.focusColor		= options.focusColor || this.color;

	if(options.styleColor1) {
		this.styleColor1 = options.styleColor1;
	}

	if(this.acceptsInput) {
		this.specialKeyMap = options.specialKeyMap || VIEW_SPECIAL_KEY_MAP_DEFAULT;
	}

	this.isSpecialKeyMapped = function(keySet, keyName) {
		return this.specialKeyMap[keySet].indexOf(keyName) > -1;
	};

	this.getANSIColor = function(color) {
		var sgr = [ color.flags, color.fg ];
		if(color.bg !== color.flags) {
			sgr.push(color.bg);
		}
		return ansi.sgr(sgr);
	};

	this.hideCusor = function() {
		self.client.term.write(ansi.hideCursor());
	};

	this.restoreCursor = function() {
		//this.client.term.write(ansi.setCursorStyle(this.cursorStyle));
		this.client.term.write('show' === this.cursor ? ansi.showCursor() : ansi.hideCursor());
	};
}

util.inherits(View, events.EventEmitter);

View.prototype.setId = function(id) {
	this.id = id;
};

View.prototype.getId = function() {
	return this.id;
};

View.prototype.setPosition = function(pos) {
	//
	//	We allow [x, y], { x : x, y : y }, or (x, y)
	//
	if(util.isArray(pos)) {
		this.position.x = pos[0];
		this.position.y = pos[1];
	} else if(pos.x && pos.y) {
		this.position.x = pos.x;
		this.position.y = pos.y;
	} else if(2 === arguments.length) {
		this.position.x = parseInt(arguments[0], 10);
		this.position.y = parseInt(arguments[1], 10);
	}
	
	assert(!(isNaN(this.position.x)));
	assert(!(isNaN(this.position.y)));

	assert(
		this.position.x > 0 && this.position.x <= this.client.term.termHeight, 
		'X position ' + this.position.x + ' out of terminal range ' + this.client.term.termHeight);

	assert(
		this.position.y > 0 && this.position.y <= this.client.term.termWidth, 
		'Y position ' + this.position.y + ' out of terminal range ' + this.client.term.termWidth);
};

View.prototype.setColor = function(color, bgColor, flags) {
	if(_.isObject(color)) {
		assert(_.has(color, 'fg'));
		assert(_.has(color, 'bg'));
		assert(_.has(color, 'flags'));

		this.color = color;
	} else {
		if(color) {
			this.color.fg = color;
		}

		if(bgColor) {
			this.color.bg = bgColor;
		}

		if(_.isNumber(flags)) {
			this.color.flags = flags;
		}
	}

	//	allow strings such as 'red', 'black', etc. to be passed
	if(_.isString(this.color.fg)) {
		this.color.fg = ansi.getFGColorValue(this.color.fg);
	}

	if(_.isString(this.color.bg)) {
		this.color.bg = ansi.getBGColorValue(this.color.bg);
	}	
};

View.prototype.getColor = function() {
	return this.color;
};

View.prototype.getFocusColor = function() {
	return this.focusColor;
};

View.prototype.redraw = function() {
	this.client.term.write(ansi.goto(this.position.x, this.position.y));
};

View.prototype.setFocus = function(focused) {
	assert(this.acceptsFocus, 'View does not accept focus');

	this.hasFocus = focused;
	this.restoreCursor();
};

View.prototype.onKeyPress = function(key, isSpecial) {
	assert(this.hasFocus, 'View does not have focus');
	assert(this.acceptsInput, 'View does not accept input');
};

View.prototype.onSpecialKeyPress = function(keyName) {
	assert(this.hasFocus, 'View does not have focus');
	assert(this.acceptsInput, 'View does not accept input');
	assert(this.specialKeyMap, 'No special key map defined');

	if(this.isSpecialKeyMapped('accept', keyName)) {
		this.emit('action', 'accept');
	} else if(this.isSpecialKeyMapped('next', keyName)) {
		this.emit('action', 'next');
	}
};

View.prototype.getData = function() {
};