337 lines
9.1 KiB
JavaScript
337 lines
9.1 KiB
JavaScript
/* jslint node: true */
|
|
'use strict';
|
|
|
|
// ENiGMA½
|
|
const events = require('events');
|
|
const util = require('util');
|
|
const ansi = require('./ansi_term.js');
|
|
const colorCodes = require('./color_codes.js');
|
|
const enigAssert = require('./enigma_assert.js');
|
|
const { renderSubstr } = require('./string_util.js');
|
|
|
|
// deps
|
|
const _ = require('lodash');
|
|
|
|
exports.View = View;
|
|
|
|
const VIEW_SPECIAL_KEY_MAP_DEFAULT = {
|
|
accept: ['return'],
|
|
exit: ['esc'],
|
|
backspace: ['backspace', 'del', 'ctrl + d'], // https://www.tecmint.com/linux-command-line-bash-shortcut-keys/
|
|
del: ['del'],
|
|
next: ['tab'],
|
|
up: ['up arrow'],
|
|
down: ['down arrow'],
|
|
end: ['end'],
|
|
home: ['home'],
|
|
left: ['left arrow'],
|
|
right: ['right arrow'],
|
|
clearLine: ['ctrl + y'],
|
|
};
|
|
|
|
exports.VIEW_SPECIAL_KEY_MAP_DEFAULT = VIEW_SPECIAL_KEY_MAP_DEFAULT;
|
|
|
|
function View(options) {
|
|
events.EventEmitter.call(this);
|
|
|
|
enigAssert(_.isObject(options));
|
|
enigAssert(_.isObject(options.client));
|
|
|
|
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.autoAdjustHeight = _.get(options, 'dimens.height')
|
|
? false
|
|
: _.get(options, 'autoAdjustHeight', true);
|
|
this.position = { x: 0, y: 0 };
|
|
this.textStyle = options.textStyle || 'normal';
|
|
this.focusTextStyle = options.focusTextStyle || this.textStyle;
|
|
this.offsetsApplied = false;
|
|
this.truncateOmission = options.truncateOmission || '';
|
|
|
|
if (options.id) {
|
|
this.setId(options.id);
|
|
}
|
|
|
|
if (options.position) {
|
|
this.setPosition(options.position);
|
|
}
|
|
|
|
if (options.dimens) {
|
|
this.setDimension(options.dimens);
|
|
} else {
|
|
this.dimens = {
|
|
width: options.width || 0,
|
|
height: 0,
|
|
};
|
|
}
|
|
|
|
// :TODO: Just use styleSGRx for these, e.g. styleSGR0, styleSGR1 = norm/focus
|
|
this.ansiSGR =
|
|
options.ansiSGR || ansi.getSGRFromGraphicRendition({ fg: 39, bg: 49 }, true);
|
|
this.ansiFocusSGR = options.ansiFocusSGR || this.ansiSGR;
|
|
|
|
this.styleSGR1 = options.styleSGR1 || this.ansiSGR;
|
|
this.styleSGR2 = options.styleSGR2 || this.ansiFocusSGR;
|
|
|
|
if (this.acceptsInput) {
|
|
this.specialKeyMap = options.specialKeyMap || VIEW_SPECIAL_KEY_MAP_DEFAULT;
|
|
|
|
if (_.isObject(options.specialKeyMapOverride)) {
|
|
this.setSpecialKeyMapOverride(options.specialKeyMapOverride);
|
|
}
|
|
}
|
|
|
|
this.isKeyMapped = function (keySet, keyName) {
|
|
return (
|
|
_.has(this.specialKeyMap, keySet) &&
|
|
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 () {
|
|
this.client.term.rawWrite(ansi.hideCursor());
|
|
};
|
|
|
|
this.restoreCursor = function () {
|
|
//this.client.term.write(ansi.setCursorStyle(this.cursorStyle));
|
|
this.client.term.rawWrite(
|
|
'show' === this.cursor ? ansi.showCursor() : ansi.hideCursor()
|
|
);
|
|
};
|
|
|
|
this.initDefaultWidth = function (width = 15) {
|
|
this.dimens.width =
|
|
this.dimens.width ||
|
|
Math.min(width, this.client.term.termWidth - this.position.col);
|
|
};
|
|
}
|
|
|
|
util.inherits(View, events.EventEmitter);
|
|
|
|
View.prototype.setId = function (id) {
|
|
this.id = id;
|
|
};
|
|
|
|
View.prototype.getId = function () {
|
|
return this.id;
|
|
};
|
|
|
|
View.prototype.getWidth = function () {
|
|
return this.dimens.width;
|
|
};
|
|
|
|
View.prototype.getHeight = function () {
|
|
return this.dimens.height;
|
|
};
|
|
|
|
View.prototype.setPosition = function (pos) {
|
|
//
|
|
// Allow the following forms: [row, col], { row : r, col : c }, or (row, col)
|
|
//
|
|
if (Array.isArray(pos)) {
|
|
this.position.row = pos[0];
|
|
this.position.col = pos[1];
|
|
} else if (_.isNumber(pos.row) && _.isNumber(pos.col)) {
|
|
this.position.row = pos.row;
|
|
this.position.col = pos.col;
|
|
} else if (2 === arguments.length) {
|
|
this.position.row = parseInt(arguments[0], 10);
|
|
this.position.col = parseInt(arguments[1], 10);
|
|
}
|
|
|
|
// sanitize
|
|
this.position.row = Math.max(this.position.row, 1);
|
|
this.position.col = Math.max(this.position.col, 1);
|
|
this.position.row = Math.min(this.position.row, this.client.term.termHeight);
|
|
this.position.col = Math.min(this.position.col, this.client.term.termWidth);
|
|
};
|
|
|
|
View.prototype.setDimension = function (dimens) {
|
|
enigAssert(
|
|
_.isObject(dimens) && _.isNumber(dimens.height) && _.isNumber(dimens.width)
|
|
);
|
|
this.dimens = dimens;
|
|
this.autoAdjustHeight = false;
|
|
};
|
|
|
|
View.prototype.setHeight = function (height) {
|
|
height = parseInt(height) || 1;
|
|
height = Math.min(height, this.client.term.termHeight);
|
|
|
|
this.dimens.height = height;
|
|
this.autoAdjustHeight = false;
|
|
};
|
|
|
|
View.prototype.setWidth = function (width) {
|
|
width = parseInt(width) || 1;
|
|
width = Math.min(width, this.client.term.termWidth - this.position.col);
|
|
|
|
this.dimens.width = width;
|
|
};
|
|
|
|
View.prototype.getSGR = function () {
|
|
return this.ansiSGR;
|
|
};
|
|
|
|
View.prototype.getStyleSGR = function (n) {
|
|
n = parseInt(n) || 0;
|
|
return this['styleSGR' + n];
|
|
};
|
|
|
|
View.prototype.getFocusSGR = function () {
|
|
return this.ansiFocusSGR;
|
|
};
|
|
|
|
View.prototype.setSpecialKeyMapOverride = function (specialKeyMapOverride) {
|
|
this.specialKeyMap = Object.assign(this.specialKeyMap, specialKeyMapOverride);
|
|
};
|
|
|
|
View.prototype.setPropertyValue = function (propName, value) {
|
|
switch (propName) {
|
|
case 'acceptsFocus':
|
|
if (_.isBoolean(value)) {
|
|
this.acceptsFocus = value;
|
|
}
|
|
break;
|
|
|
|
case 'height':
|
|
this.setHeight(value);
|
|
break;
|
|
case 'width':
|
|
this.setWidth(value);
|
|
break;
|
|
case 'focus':
|
|
this.setFocusProperty(value);
|
|
break;
|
|
|
|
case 'text':
|
|
if ('setText' in this) {
|
|
this.setText(value);
|
|
}
|
|
break;
|
|
|
|
case 'textStyle':
|
|
this.textStyle = value;
|
|
break;
|
|
case 'focusTextStyle':
|
|
this.focusTextStyle = value;
|
|
break;
|
|
|
|
case 'justify':
|
|
this.justify = value;
|
|
break;
|
|
|
|
case 'fillChar':
|
|
if ('fillChar' in this) {
|
|
if (_.isNumber(value)) {
|
|
this.fillChar = String.fromCharCode(value);
|
|
} else if (_.isString(value)) {
|
|
this.fillChar = renderSubstr(value, 0, 1);
|
|
}
|
|
}
|
|
break;
|
|
|
|
case 'submit':
|
|
if (_.isBoolean(value)) {
|
|
this.submit = value;
|
|
} /* else {
|
|
this.submit = _.isArray(value) && value.length > 0;
|
|
}
|
|
*/
|
|
break;
|
|
|
|
case 'resizable':
|
|
if (_.isBoolean(value)) {
|
|
this.resizable = value;
|
|
}
|
|
break;
|
|
|
|
case 'argName':
|
|
this.submitArgName = value;
|
|
break;
|
|
|
|
case 'omit':
|
|
if (_.isBoolean(value)) {
|
|
this.omitFromSubmission = value;
|
|
break;
|
|
}
|
|
break;
|
|
|
|
case 'validate':
|
|
if (_.isFunction(value)) {
|
|
this.validate = value;
|
|
}
|
|
break;
|
|
|
|
case 'truncateOmission':
|
|
if (_.isString(value)) {
|
|
this.truncateOmission = value;
|
|
}
|
|
break;
|
|
}
|
|
|
|
if (/styleSGR[0-9]{1,2}/.test(propName)) {
|
|
if (_.isObject(value)) {
|
|
this[propName] = ansi.getSGRFromGraphicRendition(value, true);
|
|
} else if (_.isString(value)) {
|
|
this[propName] = colorCodes.pipeToAnsi(value);
|
|
}
|
|
}
|
|
};
|
|
|
|
View.prototype.redraw = function () {
|
|
this.client.term.write(ansi.goto(this.position.row, this.position.col));
|
|
};
|
|
|
|
View.prototype.setFocusProperty = function (focused) {
|
|
// Either this should accept focus, or the focus should be false
|
|
enigAssert(this.acceptsFocus || !focused, 'View does not accept focus');
|
|
this.hasFocus = focused;
|
|
};
|
|
|
|
View.prototype.setFocus = function (focused) {
|
|
// Call separate method to differentiate between a value set as a
|
|
// property vs focus programmatically called.
|
|
this.setFocusProperty(focused);
|
|
this.restoreCursor();
|
|
};
|
|
|
|
View.prototype.onKeyPress = function (ch, key) {
|
|
enigAssert(this.hasFocus, 'View does not have focus');
|
|
enigAssert(this.acceptsInput, 'View does not accept input');
|
|
|
|
if (!this.hasFocus || !this.acceptsInput) {
|
|
return;
|
|
}
|
|
|
|
if (key) {
|
|
enigAssert(this.specialKeyMap, 'No special key map defined');
|
|
|
|
if (this.isKeyMapped('accept', key.name)) {
|
|
this.emit('action', 'accept', key);
|
|
} else if (this.isKeyMapped('next', key.name)) {
|
|
this.emit('action', 'next', key);
|
|
}
|
|
}
|
|
|
|
if (ch) {
|
|
enigAssert(1 === ch.length);
|
|
}
|
|
|
|
this.emit('key press', ch, key);
|
|
};
|
|
|
|
View.prototype.getData = function () {};
|