diff --git a/assets/hterm_all.js b/assets/hterm_all.js deleted file mode 100644 index 41d4fae..0000000 --- a/assets/hterm_all.js +++ /dev/null @@ -1,19633 +0,0 @@ -// This file was generated by libdot/bin/concat.sh. -// It has been marked read-only for your safety. Rather -// than edit it directly, please modify one of these source -// files... -// -// libdot/js/lib.js -// libdot/js/lib_polyfill.js -// libdot/js/lib_array.js -// libdot/js/lib_colors.js -// libdot/js/lib_f.js -// libdot/js/lib_message_manager.js -// libdot/js/lib_preference_manager.js -// libdot/js/lib_resource.js -// libdot/js/lib_storage.js -// libdot/js/lib_storage_chrome.js -// libdot/js/lib_storage_local.js -// libdot/js/lib_storage_memory.js -// libdot/js/lib_test_manager.js -// libdot/js/lib_utf8.js -// libdot/third_party/wcwidth/lib_wc.js -// - -// SOURCE FILE: libdot/js/lib.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -if (typeof lib != 'undefined') - throw new Error('Global "lib" object already exists.'); - -var lib = {}; - -/** - * Map of "dependency" to ["source", ...]. - * - * Each dependency is a object name, like "lib.fs", "source" is the url that - * depends on the object. - */ -lib.runtimeDependencies_ = {}; - -/** - * List of functions that need to be invoked during library initialization. - * - * Each element in the initCallbacks_ array is itself a two-element array. - * Element 0 is a short string describing the owner of the init routine, useful - * for debugging. Element 1 is the callback function. - */ -lib.initCallbacks_ = []; - -/** - * Records a runtime dependency. - * - * This can be useful when you want to express a run-time dependency at - * compile time. It is not intended to be a full-fledged library system or - * dependency tracker. It's just there to make it possible to debug the - * deps without running all the code. - * - * Object names are specified as strings. For example... - * - * lib.rtdep('lib.colors', 'lib.PreferenceManager'); - * - * Object names need not be rooted by 'lib'. You may use this to declare a - * dependency on any object. - * - * The client program may call lib.ensureRuntimeDependencies() at startup in - * order to ensure that all runtime dependencies have been met. - * - * @param {string} var_args One or more objects specified as strings. - */ -lib.rtdep = function(var_args) { - var source; - - try { - throw new Error(); - } catch (ex) { - var stackArray = ex.stack.split('\n'); - // In Safari, the resulting stackArray will only have 2 elements and the - // individual strings are formatted differently. - if (stackArray.length >= 3) { - source = stackArray[2].replace(/^\s*at\s+/, ''); - } else { - source = stackArray[1].replace(/^\s*global code@/, ''); - } - } - - for (var i = 0; i < arguments.length; i++) { - var path = arguments[i]; - if (path instanceof Array) { - lib.rtdep.apply(lib, path); - } else { - var ary = this.runtimeDependencies_[path]; - if (!ary) - ary = this.runtimeDependencies_[path] = []; - ary.push(source); - } - } -}; - -/** - * Ensures that all runtime dependencies are met, or an exception is thrown. - * - * Every unmet runtime dependency will be logged to the JS console. If at - * least one dependency is unmet this will raise an exception. - */ -lib.ensureRuntimeDependencies_ = function() { - var passed = true; - - for (var path in lib.runtimeDependencies_) { - var sourceList = lib.runtimeDependencies_[path]; - var names = path.split('.'); - - // In a document context 'window' is the global object. In a worker it's - // called 'self'. - var obj = (window || self); - for (var i = 0; i < names.length; i++) { - if (!(names[i] in obj)) { - console.warn('Missing "' + path + '" is needed by', sourceList); - passed = false; - break; - } - - obj = obj[names[i]]; - } - } - - if (!passed) - throw new Error('Failed runtime dependency check'); -}; - -/** - * Register an initialization function. - * - * The initialization functions are invoked in registration order when - * lib.init() is invoked. Each function will receive a single parameter, which - * is a function to be invoked when it completes its part of the initialization. - * - * @param {string} name A short descriptive name of the init routine useful for - * debugging. - * @param {function(function)} callback The initialization function to register. - * @return {function} The callback parameter. - */ -lib.registerInit = function(name, callback) { - lib.initCallbacks_.push([name, callback]); - return callback; -}; - -/** - * Initialize the library. - * - * This will ensure that all registered runtime dependencies are met, and - * invoke any registered initialization functions. - * - * Initialization is asynchronous. The library is not ready for use until - * the onInit function is invoked. - * - * @param {function()} onInit The function to invoke when initialization is - * complete. - * @param {function(*)} opt_logFunction An optional function to send - * initialization related log messages to. - */ -lib.init = function(onInit, opt_logFunction) { - var ary = lib.initCallbacks_; - - var initNext = function() { - if (ary.length) { - var rec = ary.shift(); - if (opt_logFunction) - opt_logFunction('init: ' + rec[0]); - rec[1](lib.f.alarm(initNext)); - } else { - onInit(); - } - }; - - if (typeof onInit != 'function') - throw new Error('Missing or invalid argument: onInit'); - - lib.ensureRuntimeDependencies_(); - - setTimeout(initNext, 0); -}; -// SOURCE FILE: libdot/js/lib_polyfill.js -// Copyright 2017 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * @fileoverview Polyfills for ES2016+ features we want to use. - */ - -// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padStart -if (!String.prototype.padStart) { - String.prototype.padStart = function(targetLength, padString) { - // If the string is already long enough, nothing to do! - targetLength -= this.length; - if (targetLength <= 0) - return String(this); - - if (padString === undefined) - padString = ' '; - - // In case the pad is multiple chars long. - if (targetLength > padString.length) - padString = padString.repeat((targetLength / padString.length) + 1); - - return padString.slice(0, targetLength) + String(this); - }; -} - -// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padEnd -if (!String.prototype.padEnd) { - String.prototype.padEnd = function(targetLength, padString) { - // If the string is already long enough, nothing to do! - targetLength -= this.length; - if (targetLength <= 0) - return String(this); - - if (padString === undefined) - padString = ' '; - - // In case the pad is multiple chars long. - if (targetLength > padString.length) - padString = padString.repeat((targetLength / padString.length) + 1); - - return String(this) + padString.slice(0, targetLength); - }; -} - -// https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_objects/Object/values -// https://github.com/tc39/proposal-object-values-entries/blob/master/polyfill.js -if (!Object.values || !Object.entries) { - const reduce = Function.bind.call(Function.call, Array.prototype.reduce); - const isEnumerable = Function.bind.call(Function.call, - Object.prototype.propertyIsEnumerable); - const concat = Function.bind.call(Function.call, Array.prototype.concat); - - if (!Object.values) { - Object.values = function values(O) { - return reduce(Reflect.ownKeys(O), (v, k) => concat(v, - typeof k === 'string' && isEnumerable(O, k) ? [O[k]] : []), []); - }; - } - - if (!Object.entries) { - Object.entries = function entries(O) { - return reduce(Reflect.ownKeys(O), (e, k) => concat(e, - typeof k === 'string' && isEnumerable(O, k) ? [[k, O[k]]] : []), []); - }; - } -} -// SOURCE FILE: libdot/js/lib_array.js -// Copyright 2017 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * @fileoverview Helper functions for (typed) arrays. - */ - -lib.array = {}; - -/** - * Convert an array of four unsigned bytes into an unsigned 32-bit integer (big - * endian). - * - * @param {!Array.} array - * @returns {!number} - */ -lib.array.arrayBigEndianToUint32 = function(array) { - const maybeSigned = - (array[0] << 24) | (array[1] << 16) | (array[2] << 8) | (array[3] << 0); - // Interpret the result of the bit operations as an unsigned integer. - return maybeSigned >>> 0; -}; - -/** - * Convert an unsigned 32-bit integer into an array of four unsigned bytes (big - * endian). - * - * @param {!number} uint32 - * @returns {!Array.} - */ -lib.array.uint32ToArrayBigEndian = function(uint32) { - return [ - (uint32 >>> 24) & 0xFF, - (uint32 >>> 16) & 0xFF, - (uint32 >>> 8) & 0xFF, - (uint32 >>> 0) & 0xFF, - ]; -}; - -/** - * Concatenate an arbitrary number of typed arrays of the same type into a new - * typed array of this type. - * - * @template TYPED_ARRAY - * @param {...!TYPED_ARRAY} arrays - * @returns {!TYPED_ARRAY} - */ -lib.array.concatTyped = function(...arrays) { - let resultLength = 0; - for (const array of arrays) { - resultLength += array.length; - } - const result = new arrays[0].constructor(resultLength); - let pos = 0; - for (const array of arrays) { - result.set(array, pos); - pos += array.length; - } - return result; -}; - -/** - * Compare two array-like objects entrywise. - * - * @template ARRAY_LIKE - * @param {?ARRAY_LIKE} a - * @param {?ARRAY_LIKE} b - * @returns {!boolean} true if both arrays are null or they agree entrywise; - * false otherwise. - */ -lib.array.compare = function(a, b) { - if (a === null || b === null) { - return a === null && b === null; - } - - if (a.length !== b.length) { - return false; - } - - for (let i = 0; i < a.length; i++) { - if (a[i] !== b[i]) { - return false; - } - } - return true; -}; -// SOURCE FILE: libdot/js/lib_colors.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * Namespace for color utilities. - */ -lib.colors = {}; - -/** - * First, some canned regular expressions we're going to use in this file. - * - * - * BRACE YOURSELF - * - * ,~~~~. - * |>_< ~~ - * 3`---'-/. - * 3:::::\v\ - * =o=:::::\,\ - * | :::::\,,\ - * - * THE REGULAR EXPRESSIONS - * ARE COMING. - * - * There's no way to break long RE literals in JavaScript. Fix that why don't - * you? Oh, and also there's no way to write a string that doesn't interpret - * escapes. - * - * Instead, we stoop to this .replace() trick. - */ -lib.colors.re_ = { - // CSS hex color, #RGB. - hex16: /#([a-f0-9])([a-f0-9])([a-f0-9])/i, - - // CSS hex color, #RRGGBB. - hex24: /#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})/i, - - // CSS rgb color, rgb(rrr,ggg,bbb). - rgb: new RegExp( - ('^/s*rgb/s*/(/s*(/d{1,3})/s*,/s*(/d{1,3})/s*,' + - '/s*(/d{1,3})/s*/)/s*$' - ).replace(/\//g, '\\'), 'i'), - - // CSS rgb color, rgb(rrr,ggg,bbb,aaa). - rgba: new RegExp( - ('^/s*rgba/s*' + - '/(/s*(/d{1,3})/s*,/s*(/d{1,3})/s*,/s*(/d{1,3})/s*' + - '(?:,/s*(/d+(?:/./d+)?)/s*)/)/s*$' - ).replace(/\//g, '\\'), 'i'), - - // Either RGB or RGBA. - rgbx: new RegExp( - ('^/s*rgba?/s*' + - '/(/s*(/d{1,3})/s*,/s*(/d{1,3})/s*,/s*(/d{1,3})/s*' + - '(?:,/s*(/d+(?:/./d+)?)/s*)?/)/s*$' - ).replace(/\//g, '\\'), 'i'), - - // An X11 "rgb:dddd/dddd/dddd" value. - x11rgb: /^\s*rgb:([a-f0-9]{1,4})\/([a-f0-9]{1,4})\/([a-f0-9]{1,4})\s*$/i, - - // English color name. - name: /[a-z][a-z0-9\s]+/, -}; - -/** - * Convert a CSS rgb(ddd,ddd,ddd) color value into an X11 color value. - * - * Other CSS color values are ignored to ensure sanitary data handling. - * - * Each 'ddd' component is a one byte value specified in decimal. - * - * @param {string} value The CSS color value to convert. - * @return {string} The X11 color value or null if the value could not be - * converted. - */ -lib.colors.rgbToX11 = function(value) { - function scale(v) { - v = (Math.min(v, 255) * 257).toString(16); - return lib.f.zpad(v, 4); - } - - var ary = value.match(lib.colors.re_.rgbx); - if (!ary) - return null; - - return 'rgb:' + scale(ary[1]) + '/' + scale(ary[2]) + '/' + scale(ary[3]); -}; - -/** - * Convert a legacy X11 colover value into an CSS rgb(...) color value. - * - * They take the form: - * 12 bit: #RGB -> #R000G000B000 - * 24 bit: #RRGGBB -> #RR00GG00BB00 - * 36 bit: #RRRGGGBBB -> #RRR0GGG0BBB0 - * 48 bit: #RRRRGGGGBBBB - * These are the most significant bits. - * - * Truncate values back down to 24 bit since that's all CSS supports. - */ -lib.colors.x11HexToCSS = function(v) { - if (!v.startsWith('#')) - return null; - // Strip the leading # off. - v = v.substr(1); - - // Reject unknown sizes. - if ([3, 6, 9, 12].indexOf(v.length) == -1) - return null; - - // Reject non-hex values. - if (v.match(/[^a-f0-9]/i)) - return null; - - // Split the colors out. - var size = v.length / 3; - var r = v.substr(0, size); - var g = v.substr(size, size); - var b = v.substr(size + size, size); - - // Normalize to 16 bits. - function norm16(v) { - v = parseInt(v, 16); - return size == 2 ? v : // 16 bit - size == 1 ? v << 4 : // 8 bit - v >> (4 * (size - 2)); // 24 or 32 bit - } - return lib.colors.arrayToRGBA([r, g, b].map(norm16)); -}; - -/** - * Convert an X11 color value into an CSS rgb(...) color value. - * - * The X11 value may be an X11 color name, or an RGB value of the form - * rgb:hhhh/hhhh/hhhh. If a component value is less than 4 digits it is - * padded out to 4, then scaled down to fit in a single byte. - * - * @param {string} value The X11 color value to convert. - * @return {string} The CSS color value or null if the value could not be - * converted. - */ -lib.colors.x11ToCSS = function(v) { - function scale(v) { - // Pad out values with less than four digits. This padding (probably) - // matches xterm. It's difficult to say for sure since xterm seems to - // arrive at a padded value and then perform some combination of - // gamma correction, color space transformation, and quantization. - - if (v.length == 1) { - // Single digits pad out to four by repeating the character. "f" becomes - // "ffff". Scaling down a hex value of this pattern by 257 is the same - // as cutting off one byte. We skip the middle step and just double - // the character. - return parseInt(v + v, 16); - } - - if (v.length == 2) { - // Similar deal here. X11 pads two digit values by repeating the - // byte (or scale up by 257). Since we're going to scale it back - // down anyway, we can just return the original value. - return parseInt(v, 16); - } - - if (v.length == 3) { - // Three digit values seem to be padded by repeating the final digit. - // e.g. 10f becomes 10ff. - v = v + v.substr(2); - } - - // Scale down the 2 byte value. - return Math.round(parseInt(v, 16) / 257); - } - - var ary = v.match(lib.colors.re_.x11rgb); - if (!ary) { - // Handle the legacy format. - if (v.startsWith('#')) - return lib.colors.x11HexToCSS(v); - else - return lib.colors.nameToRGB(v); - } - - ary.splice(0, 1); - return lib.colors.arrayToRGBA(ary.map(scale)); -}; - -/** - * Converts one or more CSS '#RRGGBB' color values into their rgb(...) - * form. - * - * Arrays are converted in place. If a value cannot be converted, it is - * replaced with null. - * - * @param {string|Array.} A single RGB value or array of RGB values to - * convert. - * @return {string|Array.} The converted value or values. - */ -lib.colors.hexToRGB = function(arg) { - var hex16 = lib.colors.re_.hex16; - var hex24 = lib.colors.re_.hex24; - - function convert(hex) { - if (hex.length == 4) { - hex = hex.replace(hex16, function(h, r, g, b) { - return "#" + r + r + g + g + b + b; - }); - } - var ary = hex.match(hex24); - if (!ary) - return null; - - return 'rgb(' + parseInt(ary[1], 16) + ', ' + - parseInt(ary[2], 16) + ', ' + - parseInt(ary[3], 16) + ')'; - } - - if (arg instanceof Array) { - for (var i = 0; i < arg.length; i++) { - arg[i] = convert(arg[i]); - } - } else { - arg = convert(arg); - } - - return arg; -}; - -/** - * Converts one or more CSS rgb(...) forms into their '#RRGGBB' color values. - * - * If given an rgba(...) form, the alpha field is thrown away. - * - * Arrays are converted in place. If a value cannot be converted, it is - * replaced with null. - * - * @param {string|Array.} A single rgb(...) value or array of rgb(...) - * values to convert. - * @return {string|Array.} The converted value or values. - */ -lib.colors.rgbToHex = function(arg) { - function convert(rgb) { - var ary = lib.colors.crackRGB(rgb); - if (!ary) - return null; - return '#' + lib.f.zpad(((parseInt(ary[0]) << 16) | - (parseInt(ary[1]) << 8) | - (parseInt(ary[2]) << 0)).toString(16), 6); - } - - if (arg instanceof Array) { - for (var i = 0; i < arg.length; i++) { - arg[i] = convert(arg[i]); - } - } else { - arg = convert(arg); - } - - return arg; -}; - -/** - * Take any valid css color definition and turn it into an rgb or rgba value. - * - * Returns null if the value could not be normalized. - */ -lib.colors.normalizeCSS = function(def) { - if (def.startsWith('#')) - return lib.colors.hexToRGB(def); - - if (lib.colors.re_.rgbx.test(def)) - return def; - - return lib.colors.nameToRGB(def); -}; - -/** - * Convert a 3 or 4 element array into an rgba(...) string. - */ -lib.colors.arrayToRGBA = function(ary) { - var alpha = (ary.length > 3) ? ary[3] : 1; - return 'rgba(' + ary[0] + ', ' + ary[1] + ', ' + ary[2] + ', ' + alpha + ')'; -}; - -/** - * Overwrite the alpha channel of an rgb/rgba color. - */ -lib.colors.setAlpha = function(rgb, alpha) { - var ary = lib.colors.crackRGB(rgb); - ary[3] = alpha; - return lib.colors.arrayToRGBA(ary); -}; - -/** - * Mix a percentage of a tint color into a base color. - */ -lib.colors.mix = function(base, tint, percent) { - var ary1 = lib.colors.crackRGB(base); - var ary2 = lib.colors.crackRGB(tint); - - for (var i = 0; i < 4; ++i) { - var diff = ary2[i] - ary1[i]; - ary1[i] = Math.round(parseInt(ary1[i]) + diff * percent); - } - - return lib.colors.arrayToRGBA(ary1); -}; - -/** - * Split an rgb/rgba color into an array of its components. - * - * On success, a 4 element array will be returned. For rgb values, the alpha - * will be set to 1. - */ -lib.colors.crackRGB = function(color) { - if (color.startsWith('rgba')) { - var ary = color.match(lib.colors.re_.rgba); - if (ary) { - ary.shift(); - return ary; - } - } else { - var ary = color.match(lib.colors.re_.rgb); - if (ary) { - ary.shift(); - ary.push('1'); - return ary; - } - } - - console.error('Couldn\'t crack: ' + color); - return null; -}; - -/** - * Convert an X11 color name into a CSS rgb(...) value. - * - * Names are stripped of spaces and converted to lowercase. If the name is - * unknown, null is returned. - * - * This list of color name to RGB mapping is derived from the stock X11 - * rgb.txt file. - * - * @param {string} name The color name to convert. - * @return {string} The corresponding CSS rgb(...) value. - */ -lib.colors.nameToRGB = function(name) { - if (name in lib.colors.colorNames) - return lib.colors.colorNames[name]; - - name = name.toLowerCase(); - if (name in lib.colors.colorNames) - return lib.colors.colorNames[name]; - - name = name.replace(/\s+/g, ''); - if (name in lib.colors.colorNames) - return lib.colors.colorNames[name]; - - return null; -}; - -/** - * The stock color palette. - */ -lib.colors.stockColorPalette = lib.colors.hexToRGB - ([// The "ANSI 16"... - '#000000', '#CC0000', '#4E9A06', '#C4A000', - '#3465A4', '#75507B', '#06989A', '#D3D7CF', - '#555753', '#EF2929', '#00BA13', '#FCE94F', - '#729FCF', '#F200CB', '#00B5BD', '#EEEEEC', - - // The 6x6 color cubes... - '#000000', '#00005F', '#000087', '#0000AF', '#0000D7', '#0000FF', - '#005F00', '#005F5F', '#005F87', '#005FAF', '#005FD7', '#005FFF', - '#008700', '#00875F', '#008787', '#0087AF', '#0087D7', '#0087FF', - '#00AF00', '#00AF5F', '#00AF87', '#00AFAF', '#00AFD7', '#00AFFF', - '#00D700', '#00D75F', '#00D787', '#00D7AF', '#00D7D7', '#00D7FF', - '#00FF00', '#00FF5F', '#00FF87', '#00FFAF', '#00FFD7', '#00FFFF', - - '#5F0000', '#5F005F', '#5F0087', '#5F00AF', '#5F00D7', '#5F00FF', - '#5F5F00', '#5F5F5F', '#5F5F87', '#5F5FAF', '#5F5FD7', '#5F5FFF', - '#5F8700', '#5F875F', '#5F8787', '#5F87AF', '#5F87D7', '#5F87FF', - '#5FAF00', '#5FAF5F', '#5FAF87', '#5FAFAF', '#5FAFD7', '#5FAFFF', - '#5FD700', '#5FD75F', '#5FD787', '#5FD7AF', '#5FD7D7', '#5FD7FF', - '#5FFF00', '#5FFF5F', '#5FFF87', '#5FFFAF', '#5FFFD7', '#5FFFFF', - - '#870000', '#87005F', '#870087', '#8700AF', '#8700D7', '#8700FF', - '#875F00', '#875F5F', '#875F87', '#875FAF', '#875FD7', '#875FFF', - '#878700', '#87875F', '#878787', '#8787AF', '#8787D7', '#8787FF', - '#87AF00', '#87AF5F', '#87AF87', '#87AFAF', '#87AFD7', '#87AFFF', - '#87D700', '#87D75F', '#87D787', '#87D7AF', '#87D7D7', '#87D7FF', - '#87FF00', '#87FF5F', '#87FF87', '#87FFAF', '#87FFD7', '#87FFFF', - - '#AF0000', '#AF005F', '#AF0087', '#AF00AF', '#AF00D7', '#AF00FF', - '#AF5F00', '#AF5F5F', '#AF5F87', '#AF5FAF', '#AF5FD7', '#AF5FFF', - '#AF8700', '#AF875F', '#AF8787', '#AF87AF', '#AF87D7', '#AF87FF', - '#AFAF00', '#AFAF5F', '#AFAF87', '#AFAFAF', '#AFAFD7', '#AFAFFF', - '#AFD700', '#AFD75F', '#AFD787', '#AFD7AF', '#AFD7D7', '#AFD7FF', - '#AFFF00', '#AFFF5F', '#AFFF87', '#AFFFAF', '#AFFFD7', '#AFFFFF', - - '#D70000', '#D7005F', '#D70087', '#D700AF', '#D700D7', '#D700FF', - '#D75F00', '#D75F5F', '#D75F87', '#D75FAF', '#D75FD7', '#D75FFF', - '#D78700', '#D7875F', '#D78787', '#D787AF', '#D787D7', '#D787FF', - '#D7AF00', '#D7AF5F', '#D7AF87', '#D7AFAF', '#D7AFD7', '#D7AFFF', - '#D7D700', '#D7D75F', '#D7D787', '#D7D7AF', '#D7D7D7', '#D7D7FF', - '#D7FF00', '#D7FF5F', '#D7FF87', '#D7FFAF', '#D7FFD7', '#D7FFFF', - - '#FF0000', '#FF005F', '#FF0087', '#FF00AF', '#FF00D7', '#FF00FF', - '#FF5F00', '#FF5F5F', '#FF5F87', '#FF5FAF', '#FF5FD7', '#FF5FFF', - '#FF8700', '#FF875F', '#FF8787', '#FF87AF', '#FF87D7', '#FF87FF', - '#FFAF00', '#FFAF5F', '#FFAF87', '#FFAFAF', '#FFAFD7', '#FFAFFF', - '#FFD700', '#FFD75F', '#FFD787', '#FFD7AF', '#FFD7D7', '#FFD7FF', - '#FFFF00', '#FFFF5F', '#FFFF87', '#FFFFAF', '#FFFFD7', '#FFFFFF', - - // The greyscale ramp... - '#080808', '#121212', '#1C1C1C', '#262626', '#303030', '#3A3A3A', - '#444444', '#4E4E4E', '#585858', '#626262', '#6C6C6C', '#767676', - '#808080', '#8A8A8A', '#949494', '#9E9E9E', '#A8A8A8', '#B2B2B2', - '#BCBCBC', '#C6C6C6', '#D0D0D0', '#DADADA', '#E4E4E4', '#EEEEEE' - ]); - -/** - * The current color palette, possibly with user changes. - */ -lib.colors.colorPalette = lib.colors.stockColorPalette; - -/** - * Named colors according to the stock X11 rgb.txt file. - */ -lib.colors.colorNames = { - "aliceblue": "rgb(240, 248, 255)", - "antiquewhite": "rgb(250, 235, 215)", - "antiquewhite1": "rgb(255, 239, 219)", - "antiquewhite2": "rgb(238, 223, 204)", - "antiquewhite3": "rgb(205, 192, 176)", - "antiquewhite4": "rgb(139, 131, 120)", - "aquamarine": "rgb(127, 255, 212)", - "aquamarine1": "rgb(127, 255, 212)", - "aquamarine2": "rgb(118, 238, 198)", - "aquamarine3": "rgb(102, 205, 170)", - "aquamarine4": "rgb(69, 139, 116)", - "azure": "rgb(240, 255, 255)", - "azure1": "rgb(240, 255, 255)", - "azure2": "rgb(224, 238, 238)", - "azure3": "rgb(193, 205, 205)", - "azure4": "rgb(131, 139, 139)", - "beige": "rgb(245, 245, 220)", - "bisque": "rgb(255, 228, 196)", - "bisque1": "rgb(255, 228, 196)", - "bisque2": "rgb(238, 213, 183)", - "bisque3": "rgb(205, 183, 158)", - "bisque4": "rgb(139, 125, 107)", - "black": "rgb(0, 0, 0)", - "blanchedalmond": "rgb(255, 235, 205)", - "blue": "rgb(0, 0, 255)", - "blue1": "rgb(0, 0, 255)", - "blue2": "rgb(0, 0, 238)", - "blue3": "rgb(0, 0, 205)", - "blue4": "rgb(0, 0, 139)", - "blueviolet": "rgb(138, 43, 226)", - "brown": "rgb(165, 42, 42)", - "brown1": "rgb(255, 64, 64)", - "brown2": "rgb(238, 59, 59)", - "brown3": "rgb(205, 51, 51)", - "brown4": "rgb(139, 35, 35)", - "burlywood": "rgb(222, 184, 135)", - "burlywood1": "rgb(255, 211, 155)", - "burlywood2": "rgb(238, 197, 145)", - "burlywood3": "rgb(205, 170, 125)", - "burlywood4": "rgb(139, 115, 85)", - "cadetblue": "rgb(95, 158, 160)", - "cadetblue1": "rgb(152, 245, 255)", - "cadetblue2": "rgb(142, 229, 238)", - "cadetblue3": "rgb(122, 197, 205)", - "cadetblue4": "rgb(83, 134, 139)", - "chartreuse": "rgb(127, 255, 0)", - "chartreuse1": "rgb(127, 255, 0)", - "chartreuse2": "rgb(118, 238, 0)", - "chartreuse3": "rgb(102, 205, 0)", - "chartreuse4": "rgb(69, 139, 0)", - "chocolate": "rgb(210, 105, 30)", - "chocolate1": "rgb(255, 127, 36)", - "chocolate2": "rgb(238, 118, 33)", - "chocolate3": "rgb(205, 102, 29)", - "chocolate4": "rgb(139, 69, 19)", - "coral": "rgb(255, 127, 80)", - "coral1": "rgb(255, 114, 86)", - "coral2": "rgb(238, 106, 80)", - "coral3": "rgb(205, 91, 69)", - "coral4": "rgb(139, 62, 47)", - "cornflowerblue": "rgb(100, 149, 237)", - "cornsilk": "rgb(255, 248, 220)", - "cornsilk1": "rgb(255, 248, 220)", - "cornsilk2": "rgb(238, 232, 205)", - "cornsilk3": "rgb(205, 200, 177)", - "cornsilk4": "rgb(139, 136, 120)", - "cyan": "rgb(0, 255, 255)", - "cyan1": "rgb(0, 255, 255)", - "cyan2": "rgb(0, 238, 238)", - "cyan3": "rgb(0, 205, 205)", - "cyan4": "rgb(0, 139, 139)", - "darkblue": "rgb(0, 0, 139)", - "darkcyan": "rgb(0, 139, 139)", - "darkgoldenrod": "rgb(184, 134, 11)", - "darkgoldenrod1": "rgb(255, 185, 15)", - "darkgoldenrod2": "rgb(238, 173, 14)", - "darkgoldenrod3": "rgb(205, 149, 12)", - "darkgoldenrod4": "rgb(139, 101, 8)", - "darkgray": "rgb(169, 169, 169)", - "darkgreen": "rgb(0, 100, 0)", - "darkgrey": "rgb(169, 169, 169)", - "darkkhaki": "rgb(189, 183, 107)", - "darkmagenta": "rgb(139, 0, 139)", - "darkolivegreen": "rgb(85, 107, 47)", - "darkolivegreen1": "rgb(202, 255, 112)", - "darkolivegreen2": "rgb(188, 238, 104)", - "darkolivegreen3": "rgb(162, 205, 90)", - "darkolivegreen4": "rgb(110, 139, 61)", - "darkorange": "rgb(255, 140, 0)", - "darkorange1": "rgb(255, 127, 0)", - "darkorange2": "rgb(238, 118, 0)", - "darkorange3": "rgb(205, 102, 0)", - "darkorange4": "rgb(139, 69, 0)", - "darkorchid": "rgb(153, 50, 204)", - "darkorchid1": "rgb(191, 62, 255)", - "darkorchid2": "rgb(178, 58, 238)", - "darkorchid3": "rgb(154, 50, 205)", - "darkorchid4": "rgb(104, 34, 139)", - "darkred": "rgb(139, 0, 0)", - "darksalmon": "rgb(233, 150, 122)", - "darkseagreen": "rgb(143, 188, 143)", - "darkseagreen1": "rgb(193, 255, 193)", - "darkseagreen2": "rgb(180, 238, 180)", - "darkseagreen3": "rgb(155, 205, 155)", - "darkseagreen4": "rgb(105, 139, 105)", - "darkslateblue": "rgb(72, 61, 139)", - "darkslategray": "rgb(47, 79, 79)", - "darkslategray1": "rgb(151, 255, 255)", - "darkslategray2": "rgb(141, 238, 238)", - "darkslategray3": "rgb(121, 205, 205)", - "darkslategray4": "rgb(82, 139, 139)", - "darkslategrey": "rgb(47, 79, 79)", - "darkturquoise": "rgb(0, 206, 209)", - "darkviolet": "rgb(148, 0, 211)", - "debianred": "rgb(215, 7, 81)", - "deeppink": "rgb(255, 20, 147)", - "deeppink1": "rgb(255, 20, 147)", - "deeppink2": "rgb(238, 18, 137)", - "deeppink3": "rgb(205, 16, 118)", - "deeppink4": "rgb(139, 10, 80)", - "deepskyblue": "rgb(0, 191, 255)", - "deepskyblue1": "rgb(0, 191, 255)", - "deepskyblue2": "rgb(0, 178, 238)", - "deepskyblue3": "rgb(0, 154, 205)", - "deepskyblue4": "rgb(0, 104, 139)", - "dimgray": "rgb(105, 105, 105)", - "dimgrey": "rgb(105, 105, 105)", - "dodgerblue": "rgb(30, 144, 255)", - "dodgerblue1": "rgb(30, 144, 255)", - "dodgerblue2": "rgb(28, 134, 238)", - "dodgerblue3": "rgb(24, 116, 205)", - "dodgerblue4": "rgb(16, 78, 139)", - "firebrick": "rgb(178, 34, 34)", - "firebrick1": "rgb(255, 48, 48)", - "firebrick2": "rgb(238, 44, 44)", - "firebrick3": "rgb(205, 38, 38)", - "firebrick4": "rgb(139, 26, 26)", - "floralwhite": "rgb(255, 250, 240)", - "forestgreen": "rgb(34, 139, 34)", - "gainsboro": "rgb(220, 220, 220)", - "ghostwhite": "rgb(248, 248, 255)", - "gold": "rgb(255, 215, 0)", - "gold1": "rgb(255, 215, 0)", - "gold2": "rgb(238, 201, 0)", - "gold3": "rgb(205, 173, 0)", - "gold4": "rgb(139, 117, 0)", - "goldenrod": "rgb(218, 165, 32)", - "goldenrod1": "rgb(255, 193, 37)", - "goldenrod2": "rgb(238, 180, 34)", - "goldenrod3": "rgb(205, 155, 29)", - "goldenrod4": "rgb(139, 105, 20)", - "gray": "rgb(190, 190, 190)", - "gray0": "rgb(0, 0, 0)", - "gray1": "rgb(3, 3, 3)", - "gray10": "rgb(26, 26, 26)", - "gray100": "rgb(255, 255, 255)", - "gray11": "rgb(28, 28, 28)", - "gray12": "rgb(31, 31, 31)", - "gray13": "rgb(33, 33, 33)", - "gray14": "rgb(36, 36, 36)", - "gray15": "rgb(38, 38, 38)", - "gray16": "rgb(41, 41, 41)", - "gray17": "rgb(43, 43, 43)", - "gray18": "rgb(46, 46, 46)", - "gray19": "rgb(48, 48, 48)", - "gray2": "rgb(5, 5, 5)", - "gray20": "rgb(51, 51, 51)", - "gray21": "rgb(54, 54, 54)", - "gray22": "rgb(56, 56, 56)", - "gray23": "rgb(59, 59, 59)", - "gray24": "rgb(61, 61, 61)", - "gray25": "rgb(64, 64, 64)", - "gray26": "rgb(66, 66, 66)", - "gray27": "rgb(69, 69, 69)", - "gray28": "rgb(71, 71, 71)", - "gray29": "rgb(74, 74, 74)", - "gray3": "rgb(8, 8, 8)", - "gray30": "rgb(77, 77, 77)", - "gray31": "rgb(79, 79, 79)", - "gray32": "rgb(82, 82, 82)", - "gray33": "rgb(84, 84, 84)", - "gray34": "rgb(87, 87, 87)", - "gray35": "rgb(89, 89, 89)", - "gray36": "rgb(92, 92, 92)", - "gray37": "rgb(94, 94, 94)", - "gray38": "rgb(97, 97, 97)", - "gray39": "rgb(99, 99, 99)", - "gray4": "rgb(10, 10, 10)", - "gray40": "rgb(102, 102, 102)", - "gray41": "rgb(105, 105, 105)", - "gray42": "rgb(107, 107, 107)", - "gray43": "rgb(110, 110, 110)", - "gray44": "rgb(112, 112, 112)", - "gray45": "rgb(115, 115, 115)", - "gray46": "rgb(117, 117, 117)", - "gray47": "rgb(120, 120, 120)", - "gray48": "rgb(122, 122, 122)", - "gray49": "rgb(125, 125, 125)", - "gray5": "rgb(13, 13, 13)", - "gray50": "rgb(127, 127, 127)", - "gray51": "rgb(130, 130, 130)", - "gray52": "rgb(133, 133, 133)", - "gray53": "rgb(135, 135, 135)", - "gray54": "rgb(138, 138, 138)", - "gray55": "rgb(140, 140, 140)", - "gray56": "rgb(143, 143, 143)", - "gray57": "rgb(145, 145, 145)", - "gray58": "rgb(148, 148, 148)", - "gray59": "rgb(150, 150, 150)", - "gray6": "rgb(15, 15, 15)", - "gray60": "rgb(153, 153, 153)", - "gray61": "rgb(156, 156, 156)", - "gray62": "rgb(158, 158, 158)", - "gray63": "rgb(161, 161, 161)", - "gray64": "rgb(163, 163, 163)", - "gray65": "rgb(166, 166, 166)", - "gray66": "rgb(168, 168, 168)", - "gray67": "rgb(171, 171, 171)", - "gray68": "rgb(173, 173, 173)", - "gray69": "rgb(176, 176, 176)", - "gray7": "rgb(18, 18, 18)", - "gray70": "rgb(179, 179, 179)", - "gray71": "rgb(181, 181, 181)", - "gray72": "rgb(184, 184, 184)", - "gray73": "rgb(186, 186, 186)", - "gray74": "rgb(189, 189, 189)", - "gray75": "rgb(191, 191, 191)", - "gray76": "rgb(194, 194, 194)", - "gray77": "rgb(196, 196, 196)", - "gray78": "rgb(199, 199, 199)", - "gray79": "rgb(201, 201, 201)", - "gray8": "rgb(20, 20, 20)", - "gray80": "rgb(204, 204, 204)", - "gray81": "rgb(207, 207, 207)", - "gray82": "rgb(209, 209, 209)", - "gray83": "rgb(212, 212, 212)", - "gray84": "rgb(214, 214, 214)", - "gray85": "rgb(217, 217, 217)", - "gray86": "rgb(219, 219, 219)", - "gray87": "rgb(222, 222, 222)", - "gray88": "rgb(224, 224, 224)", - "gray89": "rgb(227, 227, 227)", - "gray9": "rgb(23, 23, 23)", - "gray90": "rgb(229, 229, 229)", - "gray91": "rgb(232, 232, 232)", - "gray92": "rgb(235, 235, 235)", - "gray93": "rgb(237, 237, 237)", - "gray94": "rgb(240, 240, 240)", - "gray95": "rgb(242, 242, 242)", - "gray96": "rgb(245, 245, 245)", - "gray97": "rgb(247, 247, 247)", - "gray98": "rgb(250, 250, 250)", - "gray99": "rgb(252, 252, 252)", - "green": "rgb(0, 255, 0)", - "green1": "rgb(0, 255, 0)", - "green2": "rgb(0, 238, 0)", - "green3": "rgb(0, 205, 0)", - "green4": "rgb(0, 139, 0)", - "greenyellow": "rgb(173, 255, 47)", - "grey": "rgb(190, 190, 190)", - "grey0": "rgb(0, 0, 0)", - "grey1": "rgb(3, 3, 3)", - "grey10": "rgb(26, 26, 26)", - "grey100": "rgb(255, 255, 255)", - "grey11": "rgb(28, 28, 28)", - "grey12": "rgb(31, 31, 31)", - "grey13": "rgb(33, 33, 33)", - "grey14": "rgb(36, 36, 36)", - "grey15": "rgb(38, 38, 38)", - "grey16": "rgb(41, 41, 41)", - "grey17": "rgb(43, 43, 43)", - "grey18": "rgb(46, 46, 46)", - "grey19": "rgb(48, 48, 48)", - "grey2": "rgb(5, 5, 5)", - "grey20": "rgb(51, 51, 51)", - "grey21": "rgb(54, 54, 54)", - "grey22": "rgb(56, 56, 56)", - "grey23": "rgb(59, 59, 59)", - "grey24": "rgb(61, 61, 61)", - "grey25": "rgb(64, 64, 64)", - "grey26": "rgb(66, 66, 66)", - "grey27": "rgb(69, 69, 69)", - "grey28": "rgb(71, 71, 71)", - "grey29": "rgb(74, 74, 74)", - "grey3": "rgb(8, 8, 8)", - "grey30": "rgb(77, 77, 77)", - "grey31": "rgb(79, 79, 79)", - "grey32": "rgb(82, 82, 82)", - "grey33": "rgb(84, 84, 84)", - "grey34": "rgb(87, 87, 87)", - "grey35": "rgb(89, 89, 89)", - "grey36": "rgb(92, 92, 92)", - "grey37": "rgb(94, 94, 94)", - "grey38": "rgb(97, 97, 97)", - "grey39": "rgb(99, 99, 99)", - "grey4": "rgb(10, 10, 10)", - "grey40": "rgb(102, 102, 102)", - "grey41": "rgb(105, 105, 105)", - "grey42": "rgb(107, 107, 107)", - "grey43": "rgb(110, 110, 110)", - "grey44": "rgb(112, 112, 112)", - "grey45": "rgb(115, 115, 115)", - "grey46": "rgb(117, 117, 117)", - "grey47": "rgb(120, 120, 120)", - "grey48": "rgb(122, 122, 122)", - "grey49": "rgb(125, 125, 125)", - "grey5": "rgb(13, 13, 13)", - "grey50": "rgb(127, 127, 127)", - "grey51": "rgb(130, 130, 130)", - "grey52": "rgb(133, 133, 133)", - "grey53": "rgb(135, 135, 135)", - "grey54": "rgb(138, 138, 138)", - "grey55": "rgb(140, 140, 140)", - "grey56": "rgb(143, 143, 143)", - "grey57": "rgb(145, 145, 145)", - "grey58": "rgb(148, 148, 148)", - "grey59": "rgb(150, 150, 150)", - "grey6": "rgb(15, 15, 15)", - "grey60": "rgb(153, 153, 153)", - "grey61": "rgb(156, 156, 156)", - "grey62": "rgb(158, 158, 158)", - "grey63": "rgb(161, 161, 161)", - "grey64": "rgb(163, 163, 163)", - "grey65": "rgb(166, 166, 166)", - "grey66": "rgb(168, 168, 168)", - "grey67": "rgb(171, 171, 171)", - "grey68": "rgb(173, 173, 173)", - "grey69": "rgb(176, 176, 176)", - "grey7": "rgb(18, 18, 18)", - "grey70": "rgb(179, 179, 179)", - "grey71": "rgb(181, 181, 181)", - "grey72": "rgb(184, 184, 184)", - "grey73": "rgb(186, 186, 186)", - "grey74": "rgb(189, 189, 189)", - "grey75": "rgb(191, 191, 191)", - "grey76": "rgb(194, 194, 194)", - "grey77": "rgb(196, 196, 196)", - "grey78": "rgb(199, 199, 199)", - "grey79": "rgb(201, 201, 201)", - "grey8": "rgb(20, 20, 20)", - "grey80": "rgb(204, 204, 204)", - "grey81": "rgb(207, 207, 207)", - "grey82": "rgb(209, 209, 209)", - "grey83": "rgb(212, 212, 212)", - "grey84": "rgb(214, 214, 214)", - "grey85": "rgb(217, 217, 217)", - "grey86": "rgb(219, 219, 219)", - "grey87": "rgb(222, 222, 222)", - "grey88": "rgb(224, 224, 224)", - "grey89": "rgb(227, 227, 227)", - "grey9": "rgb(23, 23, 23)", - "grey90": "rgb(229, 229, 229)", - "grey91": "rgb(232, 232, 232)", - "grey92": "rgb(235, 235, 235)", - "grey93": "rgb(237, 237, 237)", - "grey94": "rgb(240, 240, 240)", - "grey95": "rgb(242, 242, 242)", - "grey96": "rgb(245, 245, 245)", - "grey97": "rgb(247, 247, 247)", - "grey98": "rgb(250, 250, 250)", - "grey99": "rgb(252, 252, 252)", - "honeydew": "rgb(240, 255, 240)", - "honeydew1": "rgb(240, 255, 240)", - "honeydew2": "rgb(224, 238, 224)", - "honeydew3": "rgb(193, 205, 193)", - "honeydew4": "rgb(131, 139, 131)", - "hotpink": "rgb(255, 105, 180)", - "hotpink1": "rgb(255, 110, 180)", - "hotpink2": "rgb(238, 106, 167)", - "hotpink3": "rgb(205, 96, 144)", - "hotpink4": "rgb(139, 58, 98)", - "indianred": "rgb(205, 92, 92)", - "indianred1": "rgb(255, 106, 106)", - "indianred2": "rgb(238, 99, 99)", - "indianred3": "rgb(205, 85, 85)", - "indianred4": "rgb(139, 58, 58)", - "ivory": "rgb(255, 255, 240)", - "ivory1": "rgb(255, 255, 240)", - "ivory2": "rgb(238, 238, 224)", - "ivory3": "rgb(205, 205, 193)", - "ivory4": "rgb(139, 139, 131)", - "khaki": "rgb(240, 230, 140)", - "khaki1": "rgb(255, 246, 143)", - "khaki2": "rgb(238, 230, 133)", - "khaki3": "rgb(205, 198, 115)", - "khaki4": "rgb(139, 134, 78)", - "lavender": "rgb(230, 230, 250)", - "lavenderblush": "rgb(255, 240, 245)", - "lavenderblush1": "rgb(255, 240, 245)", - "lavenderblush2": "rgb(238, 224, 229)", - "lavenderblush3": "rgb(205, 193, 197)", - "lavenderblush4": "rgb(139, 131, 134)", - "lawngreen": "rgb(124, 252, 0)", - "lemonchiffon": "rgb(255, 250, 205)", - "lemonchiffon1": "rgb(255, 250, 205)", - "lemonchiffon2": "rgb(238, 233, 191)", - "lemonchiffon3": "rgb(205, 201, 165)", - "lemonchiffon4": "rgb(139, 137, 112)", - "lightblue": "rgb(173, 216, 230)", - "lightblue1": "rgb(191, 239, 255)", - "lightblue2": "rgb(178, 223, 238)", - "lightblue3": "rgb(154, 192, 205)", - "lightblue4": "rgb(104, 131, 139)", - "lightcoral": "rgb(240, 128, 128)", - "lightcyan": "rgb(224, 255, 255)", - "lightcyan1": "rgb(224, 255, 255)", - "lightcyan2": "rgb(209, 238, 238)", - "lightcyan3": "rgb(180, 205, 205)", - "lightcyan4": "rgb(122, 139, 139)", - "lightgoldenrod": "rgb(238, 221, 130)", - "lightgoldenrod1": "rgb(255, 236, 139)", - "lightgoldenrod2": "rgb(238, 220, 130)", - "lightgoldenrod3": "rgb(205, 190, 112)", - "lightgoldenrod4": "rgb(139, 129, 76)", - "lightgoldenrodyellow": "rgb(250, 250, 210)", - "lightgray": "rgb(211, 211, 211)", - "lightgreen": "rgb(144, 238, 144)", - "lightgrey": "rgb(211, 211, 211)", - "lightpink": "rgb(255, 182, 193)", - "lightpink1": "rgb(255, 174, 185)", - "lightpink2": "rgb(238, 162, 173)", - "lightpink3": "rgb(205, 140, 149)", - "lightpink4": "rgb(139, 95, 101)", - "lightsalmon": "rgb(255, 160, 122)", - "lightsalmon1": "rgb(255, 160, 122)", - "lightsalmon2": "rgb(238, 149, 114)", - "lightsalmon3": "rgb(205, 129, 98)", - "lightsalmon4": "rgb(139, 87, 66)", - "lightseagreen": "rgb(32, 178, 170)", - "lightskyblue": "rgb(135, 206, 250)", - "lightskyblue1": "rgb(176, 226, 255)", - "lightskyblue2": "rgb(164, 211, 238)", - "lightskyblue3": "rgb(141, 182, 205)", - "lightskyblue4": "rgb(96, 123, 139)", - "lightslateblue": "rgb(132, 112, 255)", - "lightslategray": "rgb(119, 136, 153)", - "lightslategrey": "rgb(119, 136, 153)", - "lightsteelblue": "rgb(176, 196, 222)", - "lightsteelblue1": "rgb(202, 225, 255)", - "lightsteelblue2": "rgb(188, 210, 238)", - "lightsteelblue3": "rgb(162, 181, 205)", - "lightsteelblue4": "rgb(110, 123, 139)", - "lightyellow": "rgb(255, 255, 224)", - "lightyellow1": "rgb(255, 255, 224)", - "lightyellow2": "rgb(238, 238, 209)", - "lightyellow3": "rgb(205, 205, 180)", - "lightyellow4": "rgb(139, 139, 122)", - "limegreen": "rgb(50, 205, 50)", - "linen": "rgb(250, 240, 230)", - "magenta": "rgb(255, 0, 255)", - "magenta1": "rgb(255, 0, 255)", - "magenta2": "rgb(238, 0, 238)", - "magenta3": "rgb(205, 0, 205)", - "magenta4": "rgb(139, 0, 139)", - "maroon": "rgb(176, 48, 96)", - "maroon1": "rgb(255, 52, 179)", - "maroon2": "rgb(238, 48, 167)", - "maroon3": "rgb(205, 41, 144)", - "maroon4": "rgb(139, 28, 98)", - "mediumaquamarine": "rgb(102, 205, 170)", - "mediumblue": "rgb(0, 0, 205)", - "mediumorchid": "rgb(186, 85, 211)", - "mediumorchid1": "rgb(224, 102, 255)", - "mediumorchid2": "rgb(209, 95, 238)", - "mediumorchid3": "rgb(180, 82, 205)", - "mediumorchid4": "rgb(122, 55, 139)", - "mediumpurple": "rgb(147, 112, 219)", - "mediumpurple1": "rgb(171, 130, 255)", - "mediumpurple2": "rgb(159, 121, 238)", - "mediumpurple3": "rgb(137, 104, 205)", - "mediumpurple4": "rgb(93, 71, 139)", - "mediumseagreen": "rgb(60, 179, 113)", - "mediumslateblue": "rgb(123, 104, 238)", - "mediumspringgreen": "rgb(0, 250, 154)", - "mediumturquoise": "rgb(72, 209, 204)", - "mediumvioletred": "rgb(199, 21, 133)", - "midnightblue": "rgb(25, 25, 112)", - "mintcream": "rgb(245, 255, 250)", - "mistyrose": "rgb(255, 228, 225)", - "mistyrose1": "rgb(255, 228, 225)", - "mistyrose2": "rgb(238, 213, 210)", - "mistyrose3": "rgb(205, 183, 181)", - "mistyrose4": "rgb(139, 125, 123)", - "moccasin": "rgb(255, 228, 181)", - "navajowhite": "rgb(255, 222, 173)", - "navajowhite1": "rgb(255, 222, 173)", - "navajowhite2": "rgb(238, 207, 161)", - "navajowhite3": "rgb(205, 179, 139)", - "navajowhite4": "rgb(139, 121, 94)", - "navy": "rgb(0, 0, 128)", - "navyblue": "rgb(0, 0, 128)", - "oldlace": "rgb(253, 245, 230)", - "olivedrab": "rgb(107, 142, 35)", - "olivedrab1": "rgb(192, 255, 62)", - "olivedrab2": "rgb(179, 238, 58)", - "olivedrab3": "rgb(154, 205, 50)", - "olivedrab4": "rgb(105, 139, 34)", - "orange": "rgb(255, 165, 0)", - "orange1": "rgb(255, 165, 0)", - "orange2": "rgb(238, 154, 0)", - "orange3": "rgb(205, 133, 0)", - "orange4": "rgb(139, 90, 0)", - "orangered": "rgb(255, 69, 0)", - "orangered1": "rgb(255, 69, 0)", - "orangered2": "rgb(238, 64, 0)", - "orangered3": "rgb(205, 55, 0)", - "orangered4": "rgb(139, 37, 0)", - "orchid": "rgb(218, 112, 214)", - "orchid1": "rgb(255, 131, 250)", - "orchid2": "rgb(238, 122, 233)", - "orchid3": "rgb(205, 105, 201)", - "orchid4": "rgb(139, 71, 137)", - "palegoldenrod": "rgb(238, 232, 170)", - "palegreen": "rgb(152, 251, 152)", - "palegreen1": "rgb(154, 255, 154)", - "palegreen2": "rgb(144, 238, 144)", - "palegreen3": "rgb(124, 205, 124)", - "palegreen4": "rgb(84, 139, 84)", - "paleturquoise": "rgb(175, 238, 238)", - "paleturquoise1": "rgb(187, 255, 255)", - "paleturquoise2": "rgb(174, 238, 238)", - "paleturquoise3": "rgb(150, 205, 205)", - "paleturquoise4": "rgb(102, 139, 139)", - "palevioletred": "rgb(219, 112, 147)", - "palevioletred1": "rgb(255, 130, 171)", - "palevioletred2": "rgb(238, 121, 159)", - "palevioletred3": "rgb(205, 104, 137)", - "palevioletred4": "rgb(139, 71, 93)", - "papayawhip": "rgb(255, 239, 213)", - "peachpuff": "rgb(255, 218, 185)", - "peachpuff1": "rgb(255, 218, 185)", - "peachpuff2": "rgb(238, 203, 173)", - "peachpuff3": "rgb(205, 175, 149)", - "peachpuff4": "rgb(139, 119, 101)", - "peru": "rgb(205, 133, 63)", - "pink": "rgb(255, 192, 203)", - "pink1": "rgb(255, 181, 197)", - "pink2": "rgb(238, 169, 184)", - "pink3": "rgb(205, 145, 158)", - "pink4": "rgb(139, 99, 108)", - "plum": "rgb(221, 160, 221)", - "plum1": "rgb(255, 187, 255)", - "plum2": "rgb(238, 174, 238)", - "plum3": "rgb(205, 150, 205)", - "plum4": "rgb(139, 102, 139)", - "powderblue": "rgb(176, 224, 230)", - "purple": "rgb(160, 32, 240)", - "purple1": "rgb(155, 48, 255)", - "purple2": "rgb(145, 44, 238)", - "purple3": "rgb(125, 38, 205)", - "purple4": "rgb(85, 26, 139)", - "red": "rgb(255, 0, 0)", - "red1": "rgb(255, 0, 0)", - "red2": "rgb(238, 0, 0)", - "red3": "rgb(205, 0, 0)", - "red4": "rgb(139, 0, 0)", - "rosybrown": "rgb(188, 143, 143)", - "rosybrown1": "rgb(255, 193, 193)", - "rosybrown2": "rgb(238, 180, 180)", - "rosybrown3": "rgb(205, 155, 155)", - "rosybrown4": "rgb(139, 105, 105)", - "royalblue": "rgb(65, 105, 225)", - "royalblue1": "rgb(72, 118, 255)", - "royalblue2": "rgb(67, 110, 238)", - "royalblue3": "rgb(58, 95, 205)", - "royalblue4": "rgb(39, 64, 139)", - "saddlebrown": "rgb(139, 69, 19)", - "salmon": "rgb(250, 128, 114)", - "salmon1": "rgb(255, 140, 105)", - "salmon2": "rgb(238, 130, 98)", - "salmon3": "rgb(205, 112, 84)", - "salmon4": "rgb(139, 76, 57)", - "sandybrown": "rgb(244, 164, 96)", - "seagreen": "rgb(46, 139, 87)", - "seagreen1": "rgb(84, 255, 159)", - "seagreen2": "rgb(78, 238, 148)", - "seagreen3": "rgb(67, 205, 128)", - "seagreen4": "rgb(46, 139, 87)", - "seashell": "rgb(255, 245, 238)", - "seashell1": "rgb(255, 245, 238)", - "seashell2": "rgb(238, 229, 222)", - "seashell3": "rgb(205, 197, 191)", - "seashell4": "rgb(139, 134, 130)", - "sienna": "rgb(160, 82, 45)", - "sienna1": "rgb(255, 130, 71)", - "sienna2": "rgb(238, 121, 66)", - "sienna3": "rgb(205, 104, 57)", - "sienna4": "rgb(139, 71, 38)", - "skyblue": "rgb(135, 206, 235)", - "skyblue1": "rgb(135, 206, 255)", - "skyblue2": "rgb(126, 192, 238)", - "skyblue3": "rgb(108, 166, 205)", - "skyblue4": "rgb(74, 112, 139)", - "slateblue": "rgb(106, 90, 205)", - "slateblue1": "rgb(131, 111, 255)", - "slateblue2": "rgb(122, 103, 238)", - "slateblue3": "rgb(105, 89, 205)", - "slateblue4": "rgb(71, 60, 139)", - "slategray": "rgb(112, 128, 144)", - "slategray1": "rgb(198, 226, 255)", - "slategray2": "rgb(185, 211, 238)", - "slategray3": "rgb(159, 182, 205)", - "slategray4": "rgb(108, 123, 139)", - "slategrey": "rgb(112, 128, 144)", - "snow": "rgb(255, 250, 250)", - "snow1": "rgb(255, 250, 250)", - "snow2": "rgb(238, 233, 233)", - "snow3": "rgb(205, 201, 201)", - "snow4": "rgb(139, 137, 137)", - "springgreen": "rgb(0, 255, 127)", - "springgreen1": "rgb(0, 255, 127)", - "springgreen2": "rgb(0, 238, 118)", - "springgreen3": "rgb(0, 205, 102)", - "springgreen4": "rgb(0, 139, 69)", - "steelblue": "rgb(70, 130, 180)", - "steelblue1": "rgb(99, 184, 255)", - "steelblue2": "rgb(92, 172, 238)", - "steelblue3": "rgb(79, 148, 205)", - "steelblue4": "rgb(54, 100, 139)", - "tan": "rgb(210, 180, 140)", - "tan1": "rgb(255, 165, 79)", - "tan2": "rgb(238, 154, 73)", - "tan3": "rgb(205, 133, 63)", - "tan4": "rgb(139, 90, 43)", - "thistle": "rgb(216, 191, 216)", - "thistle1": "rgb(255, 225, 255)", - "thistle2": "rgb(238, 210, 238)", - "thistle3": "rgb(205, 181, 205)", - "thistle4": "rgb(139, 123, 139)", - "tomato": "rgb(255, 99, 71)", - "tomato1": "rgb(255, 99, 71)", - "tomato2": "rgb(238, 92, 66)", - "tomato3": "rgb(205, 79, 57)", - "tomato4": "rgb(139, 54, 38)", - "turquoise": "rgb(64, 224, 208)", - "turquoise1": "rgb(0, 245, 255)", - "turquoise2": "rgb(0, 229, 238)", - "turquoise3": "rgb(0, 197, 205)", - "turquoise4": "rgb(0, 134, 139)", - "violet": "rgb(238, 130, 238)", - "violetred": "rgb(208, 32, 144)", - "violetred1": "rgb(255, 62, 150)", - "violetred2": "rgb(238, 58, 140)", - "violetred3": "rgb(205, 50, 120)", - "violetred4": "rgb(139, 34, 82)", - "wheat": "rgb(245, 222, 179)", - "wheat1": "rgb(255, 231, 186)", - "wheat2": "rgb(238, 216, 174)", - "wheat3": "rgb(205, 186, 150)", - "wheat4": "rgb(139, 126, 102)", - "white": "rgb(255, 255, 255)", - "whitesmoke": "rgb(245, 245, 245)", - "yellow": "rgb(255, 255, 0)", - "yellow1": "rgb(255, 255, 0)", - "yellow2": "rgb(238, 238, 0)", - "yellow3": "rgb(205, 205, 0)", - "yellow4": "rgb(139, 139, 0)", - "yellowgreen": "rgb(154, 205, 50)" -}; -// SOURCE FILE: libdot/js/lib_f.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * Grab bag of utility functions. - */ -lib.f = {}; - -/** - * Create a unique enum value. - * - * @suppress {lintChecks} - * @param {string} name A human friendly name for debugging. - * @return {Object} A unique enum that won't compare equal to anything else. - */ -lib.f.createEnum = function(name) { - // We use a String object as nothing else should be using them -- we want to - // use string primitives normally. But debuggers will include our name. - // eslint-disable-next-line no-new-wrappers - return new String(name); -}; - -/** - * Replace variable references in a string. - * - * Variables are of the form %FUNCTION(VARNAME). FUNCTION is an optional - * escape function to apply to the value. - * - * For example - * lib.f.replaceVars("%(greeting), %encodeURIComponent(name)", - * { greeting: "Hello", - * name: "Google+" }); - * - * Will result in "Hello, Google%2B". - */ -lib.f.replaceVars = function(str, vars) { - return str.replace(/%([a-z]*)\(([^\)]+)\)/gi, function(match, fn, varname) { - if (typeof vars[varname] == 'undefined') - throw 'Unknown variable: ' + varname; - - var rv = vars[varname]; - - if (fn in lib.f.replaceVars.functions) { - rv = lib.f.replaceVars.functions[fn](rv); - } else if (fn) { - throw 'Unknown escape function: ' + fn; - } - - return rv; - }); -}; - -/** - * Functions that can be used with replaceVars. - * - * Clients can add to this list to extend lib.f.replaceVars(). - */ -lib.f.replaceVars.functions = { - encodeURI: encodeURI, - encodeURIComponent: encodeURIComponent, - escapeHTML: function(str) { - var map = { - '<': '<', - '>': '>', - '&': '&', - '"': '"', - "'": ''' - }; - - return str.replace(/[<>&\"\']/g, (m) => map[m]); - } -}; - -/** - * Get the list of accepted UI languages. - * - * @param {function(Array)} callback Function to invoke with the results. The - * parameter is a list of locale names. - */ -lib.f.getAcceptLanguages = function(callback) { - if (lib.f.getAcceptLanguages.chromeSupported()) { - chrome.i18n.getAcceptLanguages(callback); - } else { - setTimeout(function() { - callback([navigator.language.replace(/-/g, '_')]); - }, 0); - } -}; - -lib.f.getAcceptLanguages.chromeSupported = function() { - return window.chrome && chrome.i18n; -}; - -/** - * Parse a query string into a hash. - * - * This takes a url query string in the form 'name1=value&name2=value' and - * converts it into an object of the form { name1: 'value', name2: 'value' }. - * If a given name appears multiple times in the query string, only the - * last value will appear in the result. If the name ends with [], it is - * turned into an array. - * - * Names and values are passed through decodeURIComponent before being added - * to the result object. - * - * @param {string} queryString The string to parse. If it starts with a - * leading '?', the '?' will be ignored. - */ -lib.f.parseQuery = function(queryString) { - if (queryString.startsWith('?')) - queryString = queryString.substr(1); - - var rv = {}; - - var pairs = queryString.split('&'); - for (var i = 0; i < pairs.length; i++) { - var pair = pairs[i].split('='); - let key = decodeURIComponent(pair[0]); - let val = decodeURIComponent(pair[1]); - - if (key.endsWith('[]')) { - // It's an array. - key = key.slice(0, -2); - // The key doesn't exist, or wasn't an array before. - if (!(rv[key] instanceof Array)) - rv[key] = []; - rv[key].push(val); - } else { - // It's a plain string. - rv[key] = val; - } - } - - return rv; -}; - -lib.f.getURL = function(path) { - if (lib.f.getURL.chromeSupported()) - return chrome.runtime.getURL(path); - - return path; -}; - -lib.f.getURL.chromeSupported = function() { - return window.chrome && chrome.runtime && chrome.runtime.getURL; -}; - -/** - * Clamp a given integer to a specified range. - * - * @param {integer} v The value to be clamped. - * @param {integer} min The minimum acceptable value. - * @param {integer} max The maximum acceptable value. - */ -lib.f.clamp = function(v, min, max) { - if (v < min) - return min; - if (v > max) - return max; - return v; -}; - -/** - * Left pad a number to a given length with leading zeros. - * - * @param {string|integer} number The number to pad. - * @param {integer} length The desired length. - * @return {string} The padded number as a string. - */ -lib.f.zpad = function(number, length) { - return String(number).padStart(length, '0'); -}; - -/** - * Return a string containing a given number of space characters. - * - * This method maintains a static cache of the largest amount of whitespace - * ever requested. It shouldn't be used to generate an insanely huge amount of - * whitespace. - * - * @param {integer} length The desired amount of whitespace. - * @param {string} A string of spaces of the requested length. - */ -lib.f.getWhitespace = function(length) { - if (length <= 0) - return ''; - - var f = this.getWhitespace; - if (!f.whitespace) - f.whitespace = ' '; - - while (length > f.whitespace.length) { - f.whitespace += f.whitespace; - } - - return f.whitespace.substr(0, length); -}; - - /** - * Ensure that a function is called within a certain time limit. - * - * Simple usage looks like this... - * - * lib.registerInit(lib.f.alarm(onInit)); - * - * This will log a warning to the console if onInit() is not invoked within - * 5 seconds. - * - * If you're performing some operation that may take longer than 5 seconds you - * can pass a duration in milliseconds as the optional second parameter. - * - * If you pass a string identifier instead of a callback function, you'll get a - * wrapper generator rather than a single wrapper. Each call to the - * generator will return a wrapped version of the callback wired to - * a shared timeout. This is for cases where you want to ensure that at least - * one of a set of callbacks is invoked before a timeout expires. - * - * var alarm = lib.f.alarm('fetch object'); - * lib.foo.fetchObject(alarm(onSuccess), alarm(onFailure)); - * - * @param {function(*)} callback The function to wrap in an alarm. - * @param {int} opt_ms Optional number of milliseconds to wait before raising - * an alarm. Default is 5000 (5 seconds). - * @return {function} If callback is a function then the return value will be - * the wrapped callback. If callback is a string then the return value will - * be a function that generates new wrapped callbacks. - */ -lib.f.alarm = function(callback, opt_ms) { - var ms = opt_ms || 5 * 1000; - var stack = lib.f.getStack(1); - - return (function() { - // This outer function is called immediately. It's here to capture a new - // scope for the timeout variable. - - // The 'timeout' variable is shared by this timeout function, and the - // callback wrapper. - var timeout = setTimeout(function() { - var name = (typeof callback == 'string') ? name : callback.name; - name = name ? (': ' + name) : ''; - console.warn('lib.f.alarm: timeout expired: ' + (ms / 1000) + 's' + name); - console.log(stack); - timeout = null; - }, ms); - - var wrapperGenerator = function(callback) { - return function() { - if (timeout) { - clearTimeout(timeout); - timeout = null; - } - - return callback.apply(null, arguments); - }; - }; - - if (typeof callback == 'string') - return wrapperGenerator; - - return wrapperGenerator(callback); - })(); -}; - -/** - * Return the current call stack after skipping a given number of frames. - * - * This method is intended to be used for debugging only. It returns an - * Object instead of an Array, because the console stringifies arrays by - * default and that's not what we want. - * - * A typical call might look like... - * - * console.log('Something wicked this way came', lib.f.getStack()); - * // Notice the comma ^ - * - * This would print the message to the js console, followed by an object - * which can be clicked to reveal the stack. - * - * @param {number} opt_ignoreFrames The optional number of stack frames to - * ignore. The actual 'getStack' call is always ignored. - */ -lib.f.getStack = function(opt_ignoreFrames) { - var ignoreFrames = opt_ignoreFrames ? opt_ignoreFrames + 2 : 2; - - var stackArray; - - try { - throw new Error(); - } catch (ex) { - stackArray = ex.stack.split('\n'); - } - - var stackObject = {}; - for (var i = ignoreFrames; i < stackArray.length; i++) { - stackObject[i - ignoreFrames] = stackArray[i].replace(/^\s*at\s+/, ''); - } - - return stackObject; -}; - -/** - * Divides the two numbers and floors the results, unless the remainder is less - * than an incredibly small value, in which case it returns the ceiling. - * This is useful when the number are truncated approximations of longer - * values, and so doing division with these numbers yields a result incredibly - * close to a whole number. - * - * @param {number} numerator - * @param {number} denominator - * @return {number} - */ -lib.f.smartFloorDivide = function(numerator, denominator) { - var val = numerator / denominator; - var ceiling = Math.ceil(val); - if (ceiling - val < .0001) { - return ceiling; - } else { - return Math.floor(val); - } -}; - -/** - * Get a random integer in a range (inclusive). - * - * @param {number} min The lowest integer in the range. - * @param {number} max The highest integer in the range. - * @return {number} A random number between min & max. - */ -lib.f.randomInt = function(min, max) { - return Math.floor(Math.random() * (max - min + 1)) + min; -}; - -/** - * Get the current OS. - * - * @return {Promise} A promise that resolves to a constant in - * runtime.PlatformOs. - */ -lib.f.getOs = function() { - // Try the brower extensions API. - if (window.browser && browser.runtime && browser.runtime.getPlatformInfo) - return browser.runtime.getPlatformInfo().then((info) => info.os); - - // Use the native Chrome API if available. - if (window.chrome && chrome.runtime && chrome.runtime.getPlatformInfo) { - return new Promise((resolve, reject) => - chrome.runtime.getPlatformInfo((info) => resolve(info.os))); - } - - // Fallback logic. Capture the major OS's. The rest should support the - // browser API above. - if (window.navigator && navigator.userAgent) { - const ua = navigator.userAgent; - if (ua.includes('Mac OS X')) - return Promise.resolve('mac'); - else if (ua.includes('CrOS')) - return Promise.resolve('cros'); - else if (ua.includes('Linux')) - return Promise.resolve('linux'); - else if (ua.includes('Android')) - return Promise.resolve('android'); - else if (ua.includes('Windows')) - return Promise.resolve('windows'); - } - - // Still here? No idea. - return Promise.reject(null); -}; - -/** - * Get the current Chrome milestone version. - * - * @return {number} The milestone number if we're running on Chrome, else NaN. - */ -lib.f.getChromeMilestone = function() { - if (window.navigator && navigator.userAgent) { - const ary = navigator.userAgent.match(/\sChrome\/(\d+)/); - if (ary) - return parseInt(ary[1]); - } - - // Returning NaN will make all number comparisons fail. - return NaN; -}; -// SOURCE FILE: libdot/js/lib_message_manager.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * MessageManager class handles internationalized strings. - * - * Note: chrome.i18n isn't sufficient because... - * 1. There's a bug in chrome that makes it unavailable in iframes: - * https://crbug.com/130200 - * 2. The client code may not be packaged in a Chrome extension. - * 3. The client code may be part of a library packaged in a third-party - * Chrome extension. - * - * @param {Array} languages List of languages to load, in the order they - * should be loaded. Newer messages replace older ones. 'en' is - * automatically added as the first language if it is not already present. - */ -lib.MessageManager = function(languages) { - this.languages_ = languages.map((el) => el.replace(/-/g, '_')); - - if (this.languages_.indexOf('en') == -1) - this.languages_.unshift('en'); - - this.messages = {}; -}; - -/** - * Add message definitions to the message manager. - * - * This takes an object of the same format of a Chrome messages.json file. See - * . - */ -lib.MessageManager.prototype.addMessages = function(defs) { - for (var key in defs) { - var def = defs[key]; - - if (!def.placeholders) { - this.messages[key] = def.message; - } else { - // Replace "$NAME$" placeholders with "$1", etc. - this.messages[key] = def.message.replace( - /\$([a-z][^\s\$]+)\$/ig, - function(m, name) { - return defs[key].placeholders[name.toLowerCase()].content; - }); - } - } -}; - -/** - * Load the first available language message bundle. - * - * @param {string} pattern A url pattern containing a "$1" where the locale - * name should go. - * @param {function(Array,Array)} onComplete Function to be called when loading - * is complete. The two arrays are the list of successful and failed - * locale names. If the first parameter is length 0, no locales were - * loaded. - */ -lib.MessageManager.prototype.findAndLoadMessages = function( - pattern, onComplete) { - var languages = this.languages_.concat(); - var loaded = []; - var failed = []; - - function onLanguageComplete(state) { - if (state) { - loaded = languages.shift(); - } else { - failed = languages.shift(); - } - - if (languages.length) { - tryNextLanguage(); - } else { - onComplete(loaded, failed); - } - } - - var tryNextLanguage = function() { - this.loadMessages(this.replaceReferences(pattern, languages), - onLanguageComplete.bind(this, true), - onLanguageComplete.bind(this, false)); - }.bind(this); - - tryNextLanguage(); -}; - -/** - * Load messages from a messages.json file. - */ -lib.MessageManager.prototype.loadMessages = function( - url, onSuccess, opt_onError) { - var xhr = new XMLHttpRequest(); - - xhr.onload = () => { - this.addMessages(JSON.parse(xhr.responseText)); - onSuccess(); - }; - if (opt_onError) - xhr.onerror = () => opt_onError(xhr); - - xhr.open('GET', url); - xhr.send(); -}; - -/** - * Replace $1...$n references with the elements of the args array. - * - * @param {string} msg String containing the message and argument references. - * @param {Array} args Array containing the argument values. - */ -lib.MessageManager.replaceReferences = function(msg, args) { - return msg.replace(/\$(\d+)/g, function (m, index) { - return args[index - 1]; - }); -}; - -/** - * Per-instance copy of replaceReferences. - */ -lib.MessageManager.prototype.replaceReferences = - lib.MessageManager.replaceReferences; - -/** - * Get a message by name, optionally replacing arguments too. - * - * @param {string} msgname String containing the name of the message to get. - * @param {Array} opt_args Optional array containing the argument values. - * @param {string} opt_default Optional value to return if the msgname is not - * found. Returns the message name by default. - */ -lib.MessageManager.prototype.get = function(msgname, opt_args, opt_default) { - var message; - - if (msgname in this.messages) { - message = this.messages[msgname]; - - } else { - if (window.chrome && window.chrome.i18n) - message = chrome.i18n.getMessage(msgname); - - if (!message) { - console.warn('Unknown message: ' + msgname); - message = opt_default === undefined ? msgname : opt_default; - // Register the message with the default to avoid multiple warnings. - this.messages[msgname] = message; - } - } - - if (!opt_args) - return message; - - if (!(opt_args instanceof Array)) - opt_args = [opt_args]; - - return this.replaceReferences(message, opt_args); -}; - -/** - * Process all of the "i18n" html attributes found in a given dom fragment. - * - * The real work happens in processI18nAttribute. - */ -lib.MessageManager.prototype.processI18nAttributes = function(dom) { - var nodes = dom.querySelectorAll('[i18n]'); - - for (var i = 0; i < nodes.length; i++) - this.processI18nAttribute(nodes[i]); -}; - -/** - * Process the "i18n" attribute in the specified node. - * - * The i18n attribute should contain a JSON object. The keys are taken to - * be attribute names, and the values are message names. - * - * If the JSON object has a "_" (underscore) key, its value is used as the - * textContent of the element. - * - * Message names can refer to other attributes on the same element with by - * prefixing with a dollar sign. For example... - * - * - * - * The aria-label message name will be computed as "SEND_BUTTON_ARIA_LABEL". - * Notice that the "id" attribute was appended to the target attribute, and - * the result converted to UPPER_AND_UNDER style. - */ -lib.MessageManager.prototype.processI18nAttribute = function(node) { - // Convert the "lower-and-dashes" attribute names into - // "UPPER_AND_UNDER" style. - const thunk = (str) => str.replace(/-/g, '_').toUpperCase(); - - var i18n = node.getAttribute('i18n'); - if (!i18n) - return; - - try { - i18n = JSON.parse(i18n); - } catch (ex) { - console.error('Can\'t parse ' + node.tagName + '#' + node.id + ': ' + i18n); - throw ex; - } - - // Load all the messages specified in the i18n attributes. - for (var key in i18n) { - // The node attribute we'll be setting. - var attr = key; - - var msgname = i18n[key]; - // For "=foo", re-use the referenced message name. - if (msgname.startsWith('=')) { - key = msgname.substr(1); - msgname = i18n[key]; - } - - // For "$foo", calculate the message name. - if (msgname.startsWith('$')) - msgname = thunk(node.getAttribute(msgname.substr(1)) + '_' + key); - - // Finally load the message. - var msg = this.get(msgname); - if (attr == '_') - node.textContent = msg; - else - node.setAttribute(attr, msg); - } -}; -// SOURCE FILE: libdot/js/lib_preference_manager.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * Constructor for lib.PreferenceManager objects. - * - * These objects deal with persisting changes to stable storage and notifying - * consumers when preferences change. - * - * It is intended that the backing store could be something other than HTML5 - * storage, but there aren't any use cases at the moment. In the future there - * may be a chrome api to store sync-able name/value pairs, and we'd want - * that. - * - * @param {lib.Storage.*} storage The storage object to use as a backing - * store. - * @param {string} opt_prefix The optional prefix to be used for all preference - * names. The '/' character should be used to separate levels of hierarchy, - * if you're going to have that kind of thing. If provided, the prefix - * should start with a '/'. If not provided, it defaults to '/'. - */ -lib.PreferenceManager = function(storage, opt_prefix) { - this.storage = storage; - this.storageObserver_ = this.onStorageChange_.bind(this); - - this.isActive_ = false; - this.activate(); - - this.trace = false; - - var prefix = opt_prefix || '/'; - if (!prefix.endsWith('/')) - prefix += '/'; - - this.prefix = prefix; - - this.prefRecords_ = {}; - this.globalObservers_ = []; - - this.childFactories_ = {}; - - // Map of list-name to {map of child pref managers} - // As in... - // - // this.childLists_ = { - // 'profile-ids': { - // 'one': PreferenceManager, - // 'two': PreferenceManager, - // ... - // }, - // - // 'frob-ids': { - // ... - // } - // } - this.childLists_ = {}; -}; - -/** - * Used internally to indicate that the current value of the preference should - * be taken from the default value defined with the preference. - * - * Equality tests against this value MUST use '===' or '!==' to be accurate. - */ -lib.PreferenceManager.prototype.DEFAULT_VALUE = lib.f.createEnum('DEFAULT'); - -/** - * An individual preference. - * - * These objects are managed by the PreferenceManager, you shouldn't need to - * handle them directly. - */ -lib.PreferenceManager.Record = function(name, defaultValue) { - this.name = name; - this.defaultValue = defaultValue; - this.currentValue = this.DEFAULT_VALUE; - this.observers = []; -}; - -/** - * A local copy of the DEFAULT_VALUE constant to make it less verbose. - */ -lib.PreferenceManager.Record.prototype.DEFAULT_VALUE = - lib.PreferenceManager.prototype.DEFAULT_VALUE; - -/** - * Register a callback to be invoked when this preference changes. - * - * @param {function(value, string, lib.PreferenceManager} observer The function - * to invoke. It will receive the new value, the name of the preference, - * and a reference to the PreferenceManager as parameters. - */ -lib.PreferenceManager.Record.prototype.addObserver = function(observer) { - this.observers.push(observer); -}; - -/** - * Unregister an observer callback. - * - * @param {function} observer A previously registered callback. - */ -lib.PreferenceManager.Record.prototype.removeObserver = function(observer) { - var i = this.observers.indexOf(observer); - if (i >= 0) - this.observers.splice(i, 1); -}; - -/** - * Fetch the value of this preference. - */ -lib.PreferenceManager.Record.prototype.get = function() { - if (this.currentValue === this.DEFAULT_VALUE) { - if (/^(string|number)$/.test(typeof this.defaultValue)) - return this.defaultValue; - - if (typeof this.defaultValue == 'object') { - // We want to return a COPY of the default value so that users can - // modify the array or object without changing the default value. - return JSON.parse(JSON.stringify(this.defaultValue)); - } - - return this.defaultValue; - } - - return this.currentValue; -}; - -/** - * Stop this preference manager from tracking storage changes. - * - * Call this if you're going to swap out one preference manager for another so - * that you don't get notified about irrelevant changes. - */ -lib.PreferenceManager.prototype.deactivate = function() { - if (!this.isActive_) - throw new Error('Not activated'); - - this.isActive_ = false; - this.storage.removeObserver(this.storageObserver_); -}; - -/** - * Start tracking storage changes. - * - * If you previously deactivated this preference manager, you can reactivate it - * with this method. You don't need to call this at initialization time, as - * it's automatically called as part of the constructor. - */ -lib.PreferenceManager.prototype.activate = function() { - if (this.isActive_) - throw new Error('Already activated'); - - this.isActive_ = true; - this.storage.addObserver(this.storageObserver_); -}; - -/** - * Read the backing storage for these preferences. - * - * You should do this once at initialization time to prime the local cache - * of preference values. The preference manager will monitor the backing - * storage for changes, so you should not need to call this more than once. - * - * This function recursively reads storage for all child preference managers as - * well. - * - * This function is asynchronous, if you need to read preference values, you - * *must* wait for the callback. - * - * @param {function()} opt_callback Optional function to invoke when the read - * has completed. - */ -lib.PreferenceManager.prototype.readStorage = function(opt_callback) { - var pendingChildren = 0; - - function onChildComplete() { - if (--pendingChildren == 0 && opt_callback) - opt_callback(); - } - - var keys = Object.keys(this.prefRecords_).map((el) => this.prefix + el); - - if (this.trace) - console.log('Preferences read: ' + this.prefix); - - this.storage.getItems(keys, function(items) { - var prefixLength = this.prefix.length; - - for (var key in items) { - var value = items[key]; - var name = key.substr(prefixLength); - var needSync = (name in this.childLists_ && - (JSON.stringify(value) != - JSON.stringify(this.prefRecords_[name].currentValue))); - - this.prefRecords_[name].currentValue = value; - - if (needSync) { - pendingChildren++; - this.syncChildList(name, onChildComplete); - } - } - - if (pendingChildren == 0 && opt_callback) - setTimeout(opt_callback); - }.bind(this)); -}; - -/** - * Define a preference. - * - * This registers a name, default value, and onChange handler for a preference. - * - * @param {string} name The name of the preference. This will be prefixed by - * the prefix of this PreferenceManager before written to local storage. - * @param {string|number|boolean|Object|Array|null} value The default value of - * this preference. Anything that can be represented in JSON is a valid - * default value. - * @param {function(value, string, lib.PreferenceManager} opt_observer A - * function to invoke when the preference changes. It will receive the new - * value, the name of the preference, and a reference to the - * PreferenceManager as parameters. - */ -lib.PreferenceManager.prototype.definePreference = function( - name, value, opt_onChange) { - - var record = this.prefRecords_[name]; - if (record) { - this.changeDefault(name, value); - } else { - record = this.prefRecords_[name] = - new lib.PreferenceManager.Record(name, value); - } - - if (opt_onChange) - record.addObserver(opt_onChange); -}; - -/** - * Define multiple preferences with a single function call. - * - * @param {Array} defaults An array of 3-element arrays. Each three element - * array should contain the [key, value, onChange] parameters for a - * preference. - */ -lib.PreferenceManager.prototype.definePreferences = function(defaults) { - for (var i = 0; i < defaults.length; i++) { - this.definePreference(defaults[i][0], defaults[i][1], defaults[i][2]); - } -}; - -/** - * Define an ordered list of child preferences. - * - * Child preferences are different from just storing an array of JSON objects - * in that each child is an instance of a preference manager. This means you - * can observe changes to individual child preferences, and get some validation - * that you're not reading or writing to an undefined child preference value. - * - * @param {string} listName A name for the list of children. This must be - * unique in this preference manager. The listName will become a - * preference on this PreferenceManager used to store the ordered list of - * child ids. It is also used in get/add/remove operations to identify the - * list of children to operate on. - * @param {function} childFactory A function that will be used to generate - * instances of these children. The factory function will receive the - * parent lib.PreferenceManager object and a unique id for the new child - * preferences. - */ -lib.PreferenceManager.prototype.defineChildren = function( - listName, childFactory) { - - // Define a preference to hold the ordered list of child ids. - this.definePreference(listName, [], - this.onChildListChange_.bind(this, listName)); - this.childFactories_[listName] = childFactory; - this.childLists_[listName] = {}; -}; - -/** - * Register to observe preference changes. - * - * @param {Function} global A callback that will happen for every preference. - * Pass null if you don't need one. - * @param {Object} map A map of preference specific callbacks. Pass null if - * you don't need any. - */ -lib.PreferenceManager.prototype.addObservers = function(global, map) { - if (global && typeof global != 'function') - throw new Error('Invalid param: globals'); - - if (global) - this.globalObservers_.push(global); - - if (!map) - return; - - for (var name in map) { - if (!(name in this.prefRecords_)) - throw new Error('Unknown preference: ' + name); - - this.prefRecords_[name].addObserver(map[name]); - } -}; - -/** - * Dispatch the change observers for all known preferences. - * - * It may be useful to call this after readStorage completes, in order to - * get application state in sync with user preferences. - * - * This can be used if you've changed a preference manager out from under - * a live object, for example when switching to a different prefix. - */ -lib.PreferenceManager.prototype.notifyAll = function() { - for (var name in this.prefRecords_) { - this.notifyChange_(name); - } -}; - -/** - * Notify the change observers for a given preference. - * - * @param {string} name The name of the preference that changed. - */ -lib.PreferenceManager.prototype.notifyChange_ = function(name) { - var record = this.prefRecords_[name]; - if (!record) - throw new Error('Unknown preference: ' + name); - - var currentValue = record.get(); - - for (var i = 0; i < this.globalObservers_.length; i++) - this.globalObservers_[i](name, currentValue); - - for (var i = 0; i < record.observers.length; i++) { - record.observers[i](currentValue, name, this); - } -}; - -/** - * Create a new child PreferenceManager for the given child list. - * - * The optional hint parameter is an opaque prefix added to the auto-generated - * unique id for this child. Your child factory can parse out the prefix - * and use it. - * - * @param {string} listName The child list to create the new instance from. - * @param {string} opt_hint Optional hint to include in the child id. - * @param {string} opt_id Optional id to override the generated id. - */ -lib.PreferenceManager.prototype.createChild = function(listName, opt_hint, - opt_id) { - var ids = this.get(listName); - var id; - - if (opt_id) { - id = opt_id; - if (ids.indexOf(id) != -1) - throw new Error('Duplicate child: ' + listName + ': ' + id); - - } else { - // Pick a random, unique 4-digit hex identifier for the new profile. - while (!id || ids.indexOf(id) != -1) { - id = lib.f.randomInt(1, 0xffff).toString(16); - id = lib.f.zpad(id, 4); - if (opt_hint) - id = opt_hint + ':' + id; - } - } - - var childManager = this.childFactories_[listName](this, id); - childManager.trace = this.trace; - childManager.resetAll(); - - this.childLists_[listName][id] = childManager; - - ids.push(id); - this.set(listName, ids); - - return childManager; -}; - -/** - * Remove a child preferences instance. - * - * Removes a child preference manager and clears any preferences stored in it. - * - * @param {string} listName The name of the child list containing the child to - * remove. - * @param {string} id The child ID. - */ -lib.PreferenceManager.prototype.removeChild = function(listName, id) { - var prefs = this.getChild(listName, id); - prefs.resetAll(); - - var ids = this.get(listName); - var i = ids.indexOf(id); - if (i != -1) { - ids.splice(i, 1); - this.set(listName, ids); - } - - delete this.childLists_[listName][id]; -}; - -/** - * Return a child PreferenceManager instance for a given id. - * - * If the child list or child id is not known this will return the specified - * default value or throw an exception if no default value is provided. - * - * @param {string} listName The child list to look in. - * @param {string} id The child ID. - * @param {*} opt_default The optional default value to return if the child - * is not found. - */ -lib.PreferenceManager.prototype.getChild = function(listName, id, opt_default) { - if (!(listName in this.childLists_)) - throw new Error('Unknown child list: ' + listName); - - var childList = this.childLists_[listName]; - if (!(id in childList)) { - if (typeof opt_default == 'undefined') - throw new Error('Unknown "' + listName + '" child: ' + id); - - return opt_default; - } - - return childList[id]; -}; - -/** - * Calculate the difference between two lists of child ids. - * - * Given two arrays of child ids, this function will return an object - * with "added", "removed", and "common" properties. Each property is - * a map of child-id to `true`. For example, given... - * - * a = ['child-x', 'child-y'] - * b = ['child-y'] - * - * diffChildLists(a, b) => - * { added: { 'child-x': true }, removed: {}, common: { 'child-y': true } } - * - * The added/removed properties assume that `a` is the current list. - * - * @param {Array[string]} a The most recent list of child ids. - * @param {Array[string]} b An older list of child ids. - * @return {Object} An object with added/removed/common properties. - */ -lib.PreferenceManager.diffChildLists = function(a, b) { - var rv = { - added: {}, - removed: {}, - common: {}, - }; - - for (var i = 0; i < a.length; i++) { - if (b.indexOf(a[i]) != -1) { - rv.common[a[i]] = true; - } else { - rv.added[a[i]] = true; - } - } - - for (var i = 0; i < b.length; i++) { - if ((b[i] in rv.added) || (b[i] in rv.common)) - continue; - - rv.removed[b[i]] = true; - } - - return rv; -}; - -/** - * Synchronize a list of child PreferenceManagers instances with the current - * list stored in prefs. - * - * This will instantiate any missing managers and read current preference values - * from storage. Any active managers that no longer appear in preferences will - * be deleted. - * - * @param {string} listName The child list to synchronize. - * @param {function()} opt_callback Optional function to invoke when the sync - * is complete. - */ -lib.PreferenceManager.prototype.syncChildList = function( - listName, opt_callback) { - - var pendingChildren = 0; - function onChildStorage() { - if (--pendingChildren == 0 && opt_callback) - opt_callback(); - } - - // The list of child ids that we *should* have a manager for. - var currentIds = this.get(listName); - - // The known managers at the start of the sync. Any manager still in this - // list at the end should be discarded. - var oldIds = Object.keys(this.childLists_[listName]); - - var rv = lib.PreferenceManager.diffChildLists(currentIds, oldIds); - - for (var i = 0; i < currentIds.length; i++) { - var id = currentIds[i]; - - var managerIndex = oldIds.indexOf(id); - if (managerIndex >= 0) - oldIds.splice(managerIndex, 1); - - if (!this.childLists_[listName][id]) { - var childManager = this.childFactories_[listName](this, id); - if (!childManager) { - console.warn('Unable to restore child: ' + listName + ': ' + id); - continue; - } - - childManager.trace = this.trace; - this.childLists_[listName][id] = childManager; - pendingChildren++; - childManager.readStorage(onChildStorage); - } - } - - for (var i = 0; i < oldIds.length; i++) { - delete this.childLists_[listName][oldIds[i]]; - } - - if (!pendingChildren && opt_callback) - setTimeout(opt_callback); -}; - -/** - * Reset a preference to its default state. - * - * This will dispatch the onChange handler if the preference value actually - * changes. - * - * @param {string} name The preference to reset. - */ -lib.PreferenceManager.prototype.reset = function(name) { - var record = this.prefRecords_[name]; - if (!record) - throw new Error('Unknown preference: ' + name); - - this.storage.removeItem(this.prefix + name); - - if (record.currentValue !== this.DEFAULT_VALUE) { - record.currentValue = this.DEFAULT_VALUE; - this.notifyChange_(name); - } -}; - -/** - * Reset all preferences back to their default state. - */ -lib.PreferenceManager.prototype.resetAll = function() { - var changed = []; - - for (var listName in this.childLists_) { - var childList = this.childLists_[listName]; - for (var id in childList) { - childList[id].resetAll(); - } - } - - for (var name in this.prefRecords_) { - if (this.prefRecords_[name].currentValue !== this.DEFAULT_VALUE) { - this.prefRecords_[name].currentValue = this.DEFAULT_VALUE; - changed.push(name); - } - } - - var keys = Object.keys(this.prefRecords_).map(function(el) { - return this.prefix + el; - }.bind(this)); - - this.storage.removeItems(keys); - - changed.forEach(this.notifyChange_.bind(this)); -}; - -/** - * Return true if two values should be considered not-equal. - * - * If both values are the same scalar type and compare equal this function - * returns false (no difference), otherwise return true. - * - * This is used in places where we want to check if a preference has changed. - * Rather than take the time to compare complex values we just consider them - * to always be different. - * - * @param {*} a A value to compare. - * @param {*} b A value to compare. - */ -lib.PreferenceManager.prototype.diff = function(a, b) { - // If the types are different, or the type is not a simple primitive one. - if ((typeof a) !== (typeof b) || - !(/^(undefined|boolean|number|string)$/.test(typeof a))) { - return true; - } - - return a !== b; -}; - -/** - * Change the default value of a preference. - * - * This is useful when subclassing preference managers. - * - * The function does not alter the current value of the preference, unless - * it has the old default value. When that happens, the change observers - * will be notified. - * - * @param {string} name The name of the parameter to change. - * @param {*} newValue The new default value for the preference. - */ -lib.PreferenceManager.prototype.changeDefault = function(name, newValue) { - var record = this.prefRecords_[name]; - if (!record) - throw new Error('Unknown preference: ' + name); - - if (!this.diff(record.defaultValue, newValue)) { - // Default value hasn't changed. - return; - } - - if (record.currentValue !== this.DEFAULT_VALUE) { - // This pref has a specific value, just change the default and we're done. - record.defaultValue = newValue; - return; - } - - record.defaultValue = newValue; - - this.notifyChange_(name); -}; - -/** - * Change the default value of multiple preferences. - * - * @param {Object} map A map of name -> value pairs specifying the new default - * values. - */ -lib.PreferenceManager.prototype.changeDefaults = function(map) { - for (var key in map) { - this.changeDefault(key, map[key]); - } -}; - -/** - * Set a preference to a specific value. - * - * This will dispatch the onChange handler if the preference value actually - * changes. - * - * @param {string} key The preference to set. - * @param {*} value The value to set. Anything that can be represented in - * JSON is a valid value. - */ -lib.PreferenceManager.prototype.set = function(name, newValue) { - var record = this.prefRecords_[name]; - if (!record) - throw new Error('Unknown preference: ' + name); - - var oldValue = record.get(); - - if (!this.diff(oldValue, newValue)) - return; - - if (this.diff(record.defaultValue, newValue)) { - record.currentValue = newValue; - this.storage.setItem(this.prefix + name, newValue); - } else { - record.currentValue = this.DEFAULT_VALUE; - this.storage.removeItem(this.prefix + name); - } - - // We need to manually send out the notification on this instance. If we - // The storage event won't fire a notification because we've already changed - // the currentValue, so it won't see a difference. If we delayed changing - // currentValue until the storage event, a pref read immediately after a write - // would return the previous value. - // - // The notification is in a timeout so clients don't accidentally depend on - // a synchronous notification. - setTimeout(this.notifyChange_.bind(this, name), 0); -}; - -/** - * Get the value of a preference. - * - * @param {string} key The preference to get. - */ -lib.PreferenceManager.prototype.get = function(name) { - var record = this.prefRecords_[name]; - if (!record) - throw new Error('Unknown preference: ' + name); - - return record.get(); -}; - -/** - * Return all non-default preferences as a JSON object. - * - * This includes any nested preference managers as well. - */ -lib.PreferenceManager.prototype.exportAsJson = function() { - var rv = {}; - - for (var name in this.prefRecords_) { - if (name in this.childLists_) { - rv[name] = []; - var childIds = this.get(name); - for (var i = 0; i < childIds.length; i++) { - var id = childIds[i]; - rv[name].push({id: id, json: this.getChild(name, id).exportAsJson()}); - } - - } else { - var record = this.prefRecords_[name]; - if (record.currentValue != this.DEFAULT_VALUE) - rv[name] = record.currentValue; - } - } - - return rv; -}; - -/** - * Import a JSON blob of preferences previously generated with exportAsJson. - * - * This will create nested preference managers as well. - */ -lib.PreferenceManager.prototype.importFromJson = function(json, opt_onComplete) { - let pendingWrites = 0; - const onWriteStorage = () => { - if (--pendingWrites < 1 && opt_onComplete) - opt_onComplete(); - }; - - for (var name in json) { - if (name in this.childLists_) { - var childList = json[name]; - for (var i = 0; i < childList.length; i++) { - var id = childList[i].id; - - var childPrefManager = this.childLists_[name][id]; - if (!childPrefManager) - childPrefManager = this.createChild(name, null, id); - - childPrefManager.importFromJson(childList[i].json, onWriteStorage); - pendingWrites++; - } - - } else { - // The set is synchronous. - this.set(name, json[name]); - } - } - - // If we didn't update any children, no async work has been queued, so make - // the completion callback directly. - if (pendingWrites == 0 && opt_onComplete) - opt_onComplete(); -}; - -/** - * Called when one of the child list preferences changes. - */ -lib.PreferenceManager.prototype.onChildListChange_ = function(listName) { - this.syncChildList(listName); -}; - -/** - * Called when a key in the storage changes. - */ -lib.PreferenceManager.prototype.onStorageChange_ = function(map) { - for (var key in map) { - if (this.prefix) { - if (key.lastIndexOf(this.prefix, 0) != 0) - continue; - } - - var name = key.substr(this.prefix.length); - - if (!(name in this.prefRecords_)) { - // Sometimes we'll get notified about prefs that are no longer defined. - continue; - } - - var record = this.prefRecords_[name]; - - var newValue = map[key].newValue; - var currentValue = record.currentValue; - if (currentValue === record.DEFAULT_VALUE) - currentValue = (void 0); - - if (this.diff(currentValue, newValue)) { - if (typeof newValue == 'undefined' || newValue === null) { - record.currentValue = record.DEFAULT_VALUE; - } else { - record.currentValue = newValue; - } - - this.notifyChange_(name); - } - } -}; -// SOURCE FILE: libdot/js/lib_resource.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * Storage for canned resources. - * - * These are usually non-JavaScript things that are collected during a build - * step and converted into a series of 'lib.resource.add(...)' calls. See - * the "@resource" directive from libdot/bin/concat.sh for the canonical use - * case. - * - * This is global storage, so you should prefix your resource names to avoid - * collisions. - */ -lib.resource = { - resources_: {} -}; - -/** - * Add a resource. - * - * @param {string} name A name for the resource. You should prefix this to - * avoid collisions with resources from a shared library. - * @param {string} type A mime type for the resource, or "raw" if not - * applicable. - * @param {*} data The value of the resource. - */ -lib.resource.add = function(name, type, data) { - lib.resource.resources_[name] = { - type: type, - name: name, - data: data - }; -}; - -/** - * Retrieve a resource record. - * - * The resource data is stored on the "data" property of the returned object. - * - * @param {string} name The name of the resource to get. - * @param {*} opt_defaultValue The optional value to return if the resource is - * not defined. - * @return {object} An object with "type", "name", and "data" properties. - */ -lib.resource.get = function(name, opt_defaultValue) { - if (!(name in lib.resource.resources_)) { - if (typeof opt_defaultValue == 'undefined') - throw 'Unknown resource: ' + name; - - return opt_defaultValue; - } - - return lib.resource.resources_[name]; -}; - -/** - * Retrieve resource data. - * - * @param {string} name The name of the resource to get. - * @param {*} opt_defaultValue The optional value to return if the resource is - * not defined. - * @return {*} The resource data. - */ -lib.resource.getData = function(name, opt_defaultValue) { - if (!(name in lib.resource.resources_)) { - if (typeof opt_defaultValue == 'undefined') - throw 'Unknown resource: ' + name; - - return opt_defaultValue; - } - - return lib.resource.resources_[name].data; -}; - -/** - * Retrieve resource as a data: url. - * - * @param {string} name The name of the resource to get. - * @param {*} opt_defaultValue The optional value to return if the resource is - * not defined. - * @return {*} A data: url encoded version of the resource. - */ -lib.resource.getDataUrl = function(name, opt_defaultValue) { - var resource = lib.resource.get(name, opt_defaultValue); - return 'data:' + resource.type + ',' + resource.data; -}; -// SOURCE FILE: libdot/js/lib_storage.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * Namespace for implementations of persistent, possibly cloud-backed - * storage. - */ -lib.Storage = new Object(); -// SOURCE FILE: libdot/js/lib_storage_chrome.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * chrome.storage based class with an async interface that is interchangeable - * with other lib.Storage.* implementations. - */ -lib.Storage.Chrome = function(storage) { - this.storage_ = storage; - this.observers_ = []; - - chrome.storage.onChanged.addListener(this.onChanged_.bind(this)); -}; - -/** - * Called by the storage implementation when the storage is modified. - */ -lib.Storage.Chrome.prototype.onChanged_ = function(changes, areaname) { - if (chrome.storage[areaname] != this.storage_) - return; - - for (var i = 0; i < this.observers_.length; i++) { - this.observers_[i](changes); - } -}; - -/** - * Register a function to observe storage changes. - * - * @param {function(map)} callback The function to invoke when the storage - * changes. - */ -lib.Storage.Chrome.prototype.addObserver = function(callback) { - this.observers_.push(callback); -}; - -/** - * Unregister a change observer. - * - * @param {function} observer A previously registered callback. - */ -lib.Storage.Chrome.prototype.removeObserver = function(callback) { - var i = this.observers_.indexOf(callback); - if (i != -1) - this.observers_.splice(i, 1); -}; - -/** - * Delete everything in this storage. - * - * @param {function(map)} callback The function to invoke when the delete - * has completed. - */ -lib.Storage.Chrome.prototype.clear = function(opt_callback) { - this.storage_.clear(); - - if (opt_callback) - setTimeout(opt_callback, 0); -}; - -/** - * Return the current value of a storage item. - * - * @param {string} key The key to look up. - * @param {function(value) callback The function to invoke when the value has - * been retrieved. - */ -lib.Storage.Chrome.prototype.getItem = function(key, callback) { - this.storage_.get(key, callback); -}; -/** - * Fetch the values of multiple storage items. - * - * @param {Array} keys The keys to look up. - * @param {function(map) callback The function to invoke when the values have - * been retrieved. - */ - -lib.Storage.Chrome.prototype.getItems = function(keys, callback) { - this.storage_.get(keys, callback); -}; - -/** - * Set a value in storage. - * - * @param {string} key The key for the value to be stored. - * @param {*} value The value to be stored. Anything that can be serialized - * with JSON is acceptable. - * @param {function()} opt_callback Optional function to invoke when the - * set is complete. You don't have to wait for the set to complete in order - * to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Chrome.prototype.setItem = function(key, value, opt_callback) { - const onComplete = () => { - if (chrome.runtime.lastError) { - // Doesn't seem to be any better way of handling this. - // https://crbug.com/764759 - if (chrome.runtime.lastError.message.indexOf('MAX_WRITE_OPERATIONS')) { - console.warn(`Will retry save of ${key} after exceeding quota`, - chrome.runtime.lastError); - setTimeout(() => this.setItem(key, value, onComplete), 1000); - return; - } else { - console.error('Unknown runtime error', chrome.runtime.lastError); - } - } - - if (opt_callback) - opt_callback(); - }; - - var obj = {}; - obj[key] = value; - this.storage_.set(obj, onComplete); -}; - -/** - * Set multiple values in storage. - * - * @param {Object} map A map of key/values to set in storage. - * @param {function()} opt_callback Optional function to invoke when the - * set is complete. You don't have to wait for the set to complete in order - * to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Chrome.prototype.setItems = function(obj, opt_callback) { - this.storage_.set(obj, opt_callback); -}; - -/** - * Remove an item from storage. - * - * @param {string} key The key to be removed. - * @param {function()} opt_callback Optional function to invoke when the - * remove is complete. You don't have to wait for the set to complete in - * order to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Chrome.prototype.removeItem = function(key, opt_callback) { - this.storage_.remove(key, opt_callback); -}; - -/** - * Remove multiple items from storage. - * - * @param {Array} keys The keys to be removed. - * @param {function()} opt_callback Optional function to invoke when the - * remove is complete. You don't have to wait for the set to complete in - * order to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Chrome.prototype.removeItems = function(keys, opt_callback) { - this.storage_.remove(keys, opt_callback); -}; -// SOURCE FILE: libdot/js/lib_storage_local.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * window.localStorage based class with an async interface that is - * interchangeable with other lib.Storage.* implementations. - */ -lib.Storage.Local = function() { - this.observers_ = []; - this.storage_ = window.localStorage; - window.addEventListener('storage', this.onStorage_.bind(this)); -}; - -/** - * Called by the storage implementation when the storage is modified. - */ -lib.Storage.Local.prototype.onStorage_ = function(e) { - if (e.storageArea != this.storage_) - return; - - // JS throws an exception if JSON.parse is given an empty string. So here we - // only parse if the value is truthy. This mean the empty string, undefined - // and null will not be parsed. - var prevValue = e.oldValue ? JSON.parse(e.oldValue) : e.oldValue; - var curValue = e.newValue ? JSON.parse(e.newValue) : e.newValue; - var o = {}; - o[e.key] = { - oldValue: prevValue, - newValue: curValue - }; - - for (var i = 0; i < this.observers_.length; i++) { - this.observers_[i](o); - } -}; - -/** - * Register a function to observe storage changes. - * - * @param {function(map)} callback The function to invoke when the storage - * changes. - */ -lib.Storage.Local.prototype.addObserver = function(callback) { - this.observers_.push(callback); -}; - -/** - * Unregister a change observer. - * - * @param {function} observer A previously registered callback. - */ -lib.Storage.Local.prototype.removeObserver = function(callback) { - var i = this.observers_.indexOf(callback); - if (i != -1) - this.observers_.splice(i, 1); -}; - -/** - * Delete everything in this storage. - * - * @param {function(map)} callback The function to invoke when the delete - * has completed. - */ -lib.Storage.Local.prototype.clear = function(opt_callback) { - this.storage_.clear(); - - if (opt_callback) - setTimeout(opt_callback, 0); -}; - -/** - * Return the current value of a storage item. - * - * @param {string} key The key to look up. - * @param {function(value) callback The function to invoke when the value has - * been retrieved. - */ -lib.Storage.Local.prototype.getItem = function(key, callback) { - var value = this.storage_.getItem(key); - - if (typeof value == 'string') { - try { - value = JSON.parse(value); - } catch (e) { - // If we can't parse the value, just return it unparsed. - } - } - - setTimeout(callback.bind(null, value), 0); -}; - -/** - * Fetch the values of multiple storage items. - * - * @param {Array} keys The keys to look up. - * @param {function(map) callback The function to invoke when the values have - * been retrieved. - */ -lib.Storage.Local.prototype.getItems = function(keys, callback) { - var rv = {}; - - for (var i = keys.length - 1; i >= 0; i--) { - var key = keys[i]; - var value = this.storage_.getItem(key); - if (typeof value == 'string') { - try { - rv[key] = JSON.parse(value); - } catch (e) { - // If we can't parse the value, just return it unparsed. - rv[key] = value; - } - } else { - keys.splice(i, 1); - } - } - - setTimeout(callback.bind(null, rv), 0); -}; - -/** - * Set a value in storage. - * - * @param {string} key The key for the value to be stored. - * @param {*} value The value to be stored. Anything that can be serialized - * with JSON is acceptable. - * @param {function()} opt_callback Optional function to invoke when the - * set is complete. You don't have to wait for the set to complete in order - * to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Local.prototype.setItem = function(key, value, opt_callback) { - this.storage_.setItem(key, JSON.stringify(value)); - - if (opt_callback) - setTimeout(opt_callback, 0); -}; - -/** - * Set multiple values in storage. - * - * @param {Object} map A map of key/values to set in storage. - * @param {function()} opt_callback Optional function to invoke when the - * set is complete. You don't have to wait for the set to complete in order - * to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Local.prototype.setItems = function(obj, opt_callback) { - for (var key in obj) { - this.storage_.setItem(key, JSON.stringify(obj[key])); - } - - if (opt_callback) - setTimeout(opt_callback, 0); -}; - -/** - * Remove an item from storage. - * - * @param {string} key The key to be removed. - * @param {function()} opt_callback Optional function to invoke when the - * remove is complete. You don't have to wait for the set to complete in - * order to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Local.prototype.removeItem = function(key, opt_callback) { - this.storage_.removeItem(key); - - if (opt_callback) - setTimeout(opt_callback, 0); -}; - -/** - * Remove multiple items from storage. - * - * @param {Array} keys The keys to be removed. - * @param {function()} opt_callback Optional function to invoke when the - * remove is complete. You don't have to wait for the set to complete in - * order to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Local.prototype.removeItems = function(ary, opt_callback) { - for (var i = 0; i < ary.length; i++) { - this.storage_.removeItem(ary[i]); - } - - if (opt_callback) - setTimeout(opt_callback, 0); -}; -// SOURCE FILE: libdot/js/lib_storage_memory.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * In-memory storage class with an async interface that is interchangeable with - * other lib.Storage.* implementations. - */ -lib.Storage.Memory = function() { - this.observers_ = []; - this.storage_ = {}; -}; - -/** - * Register a function to observe storage changes. - * - * @param {function(map)} callback The function to invoke when the storage - * changes. - */ -lib.Storage.Memory.prototype.addObserver = function(callback) { - this.observers_.push(callback); -}; - -/** - * Unregister a change observer. - * - * @param {function} observer A previously registered callback. - */ -lib.Storage.Memory.prototype.removeObserver = function(callback) { - var i = this.observers_.indexOf(callback); - if (i != -1) - this.observers_.splice(i, 1); -}; - -/** - * Delete everything in this storage. - * - * @param {function(map)} callback The function to invoke when the delete - * has completed. - */ -lib.Storage.Memory.prototype.clear = function(opt_callback) { - var e = {}; - for (var key in this.storage_) { - e[key] = {oldValue: this.storage_[key], newValue: (void 0)}; - } - - this.storage_ = {}; - - setTimeout(function() { - for (var i = 0; i < this.observers_.length; i++) { - this.observers_[i](e); - } - }.bind(this), 0); - - if (opt_callback) - setTimeout(opt_callback, 0); -}; - -/** - * Return the current value of a storage item. - * - * @param {string} key The key to look up. - * @param {function(value) callback The function to invoke when the value has - * been retrieved. - */ -lib.Storage.Memory.prototype.getItem = function(key, callback) { - var value = this.storage_[key]; - - if (typeof value == 'string') { - try { - value = JSON.parse(value); - } catch (e) { - // If we can't parse the value, just return it unparsed. - } - } - - setTimeout(callback.bind(null, value), 0); -}; - -/** - * Fetch the values of multiple storage items. - * - * @param {Array} keys The keys to look up. - * @param {function(map) callback The function to invoke when the values have - * been retrieved. - */ -lib.Storage.Memory.prototype.getItems = function(keys, callback) { - var rv = {}; - - for (var i = keys.length - 1; i >= 0; i--) { - var key = keys[i]; - var value = this.storage_[key]; - if (typeof value == 'string') { - try { - rv[key] = JSON.parse(value); - } catch (e) { - // If we can't parse the value, just return it unparsed. - rv[key] = value; - } - } else { - keys.splice(i, 1); - } - } - - setTimeout(callback.bind(null, rv), 0); -}; - -/** - * Set a value in storage. - * - * @param {string} key The key for the value to be stored. - * @param {*} value The value to be stored. Anything that can be serialized - * with JSON is acceptable. - * @param {function()} opt_callback Optional function to invoke when the - * set is complete. You don't have to wait for the set to complete in order - * to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Memory.prototype.setItem = function(key, value, opt_callback) { - var oldValue = this.storage_[key]; - this.storage_[key] = JSON.stringify(value); - - var e = {}; - e[key] = {oldValue: oldValue, newValue: value}; - - setTimeout(function() { - for (var i = 0; i < this.observers_.length; i++) { - this.observers_[i](e); - } - }.bind(this), 0); - - if (opt_callback) - setTimeout(opt_callback, 0); -}; - -/** - * Set multiple values in storage. - * - * @param {Object} map A map of key/values to set in storage. - * @param {function()} opt_callback Optional function to invoke when the - * set is complete. You don't have to wait for the set to complete in order - * to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Memory.prototype.setItems = function(obj, opt_callback) { - var e = {}; - - for (var key in obj) { - e[key] = {oldValue: this.storage_[key], newValue: obj[key]}; - this.storage_[key] = JSON.stringify(obj[key]); - } - - setTimeout(function() { - for (var i = 0; i < this.observers_.length; i++) { - this.observers_[i](e); - } - }.bind(this)); - - if (opt_callback) - setTimeout(opt_callback, 0); -}; - -/** - * Remove an item from storage. - * - * @param {string} key The key to be removed. - * @param {function()} opt_callback Optional function to invoke when the - * remove is complete. You don't have to wait for the set to complete in - * order to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Memory.prototype.removeItem = function(key, opt_callback) { - delete this.storage_[key]; - - if (opt_callback) - setTimeout(opt_callback, 0); -}; - -/** - * Remove multiple items from storage. - * - * @param {Array} keys The keys to be removed. - * @param {function()} opt_callback Optional function to invoke when the - * remove is complete. You don't have to wait for the set to complete in - * order to read the value, since the local cache is updated synchronously. - */ -lib.Storage.Memory.prototype.removeItems = function(ary, opt_callback) { - for (var i = 0; i < ary.length; i++) { - delete this.storage_[ary[i]]; - } - - if (opt_callback) - setTimeout(opt_callback, 0); -}; -// SOURCE FILE: libdot/js/lib_test_manager.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * @fileoverview JavaScript unit testing framework for synchronous and - * asynchronous tests. - * - * This file contains the lib.TestManager and related classes. At the moment - * it's all collected in a single file since it's reasonably small - * (=~1k lines), and it's a lot easier to include one file into your test - * harness than it is to include seven. - * - * The following classes are defined... - * - * lib.TestManager - The root class and entrypoint for creating test runs. - * lib.TestManager.Log - Logging service. - * lib.TestManager.Suite - A collection of tests. - * lib.TestManager.Test - A single test. - * lib.TestManager.TestRun - Manages the execution of a set of tests. - * lib.TestManager.Result - A single test result. - */ - -/** - * Root object in the unit test hierarchy, and keeper of the log object. - * - * @param {lib.TestManager.Log} opt_log Optional lib.TestManager.Log object. - * Logs to the JavaScript console if omitted. - */ -lib.TestManager = function(opt_log) { - this.log = opt_log || new lib.TestManager.Log(); -}; - -/** - * Create a new test run object for this test manager. - * - * @param {Object} opt_cx An object to be passed to test suite setup(), - * preamble(), and test cases during this test run. This object is opaque - * to lib.TestManager.* code. It's entirely up to the test suite what it's - * used for. - */ -lib.TestManager.prototype.createTestRun = function(opt_cx) { - return new lib.TestManager.TestRun(this, opt_cx); -}; - -/** - * Called when a test run associated with this test manager completes. - * - * Clients may override this to call an appropriate function. - */ -lib.TestManager.prototype.onTestRunComplete = function(testRun) {}; - -/** - * Called before a test associated with this test manager is run. - * - * @param {lib.TestManager.Result} result The result object for the upcoming - * test. - * @param {Object} cx The context object for a test run. - */ -lib.TestManager.prototype.testPreamble = function(result, cx) {}; - -/** - * Called after a test associated with this test manager finishes. - * - * @param {lib.TestManager.Result} result The result object for the finished - * test. - * @param {Object} cx The context object for a test run. - */ -lib.TestManager.prototype.testPostamble = function(result, cx) {}; - -/** - * Destination for test case output. - * - * Thw API will be the same as the console object. e.g. We support info(), - * warn(), error(), etc... just like console.info(), etc... - * - * @param {Object} opt_console The console object to route all logging through. - * Should provide saome API as the standard console API. - */ -lib.TestManager.Log = function(opt_console=console) { - this.save = false; - this.data = ''; - this.prefix_ = ''; - this.prefixStack_ = 0; - - // Capture all the console entry points in case code at runtime calls these - // directly. We want to be able to still see things. - // We also expose the direct API to our callers (e.g. we provide warn()). - this.console_ = opt_console; - ['log', 'debug', 'info', 'warn', 'error'].forEach((level) => { - let msgPrefix = ''; - switch (level) { - case 'debug': - case 'warn': - case 'error': - msgPrefix = level.toUpperCase() + ': '; - break; - } - - const oLog = this.console_[level]; - this[level] = this.console_[level] = (...args) => { - if (this.save) - this.data += this.prefix_ + msgPrefix + args.join(' ') + '\n'; - oLog.apply(this.console_, args); - }; - }); - - // Wrap/bind the group functions. - ['group', 'groupCollapsed'].forEach((group) => { - const oGroup = this.console_[group]; - this[group] = this.console_[group] = (label='') => { - oGroup(label); - if (this.save) - this.data += this.prefix_ + label + '\n'; - this.prefix_ = ' '.repeat(++this.prefixStack_); - }; - }); - - const oGroupEnd = this.console_.groupEnd; - this.groupEnd = this.console_.groupEnd = () => { - oGroupEnd(); - if (this.prefixStack_) - this.prefix_ = ' '.repeat(--this.prefixStack_); - }; -}; - -/** - * Returns a new constructor function that will inherit from - * lib.TestManager.Suite. - * - * Use this function to create a new test suite subclass. It will return a - * properly initialized constructor function for the subclass. You can then - * override the setup() and preamble() methods if necessary and add test cases - * to the subclass. - * - * var MyTests = new lib.TestManager.Suite('MyTests'); - * - * MyTests.prototype.setup = function(cx) { - * // Sets this.size to cx.size if it exists, or the default value of 10 - * // if not. - * this.setDefault(cx, {size: 10}); - * }; - * - * MyTests.prototype.preamble = function(result, cx) { - * // Some tests (even successful ones) may side-effect this list, so - * // recreate it before every test. - * this.list = []; - * for (var i = 0; i < this.size; i++) { - * this.list[i] = i; - * } - * }; - * - * // Basic synchronous test case. - * MyTests.addTest('pop-length', function(result, cx) { - * this.list.pop(); - * - * // If this assertion fails, the testcase will stop here. - * result.assertEQ(this.list.length, this.size - 1); - * - * // A test must indicate it has passed by calling this method. - * result.pass(); - * }); - * - * // Sample asynchronous test case. - * MyTests.addTest('async-pop-length', function(result, cx) { - * var callback = () => { - * result.assertEQ(this.list.length, this.size - 1); - * result.pass(); - * }; - * - * // Wait 100ms to check the array length for the sake of this example. - * setTimeout(callback, 100); - * - * this.list.pop(); - * - * // Indicate that this test needs another 200ms to complete. - * // If the test does not report pass/fail by then, it is considered to - * // have timed out. - * result.requestTime(200); - * }); - * - * ... - * - * @param {string} suiteName The name of the test suite. - */ -lib.TestManager.Suite = function(suiteName) { - function ctor(testManager, cx) { - this.testManager_ = testManager; - this.suiteName = suiteName; - - this.setup(cx); - } - - ctor.suiteName = suiteName; - ctor.addTest = lib.TestManager.Suite.addTest; - ctor.disableTest = lib.TestManager.Suite.disableTest; - ctor.getTest = lib.TestManager.Suite.getTest; - ctor.getTestList = lib.TestManager.Suite.getTestList; - ctor.testList_ = []; - ctor.testMap_ = {}; - ctor.prototype = Object.create(lib.TestManager.Suite.prototype); - ctor.constructor = lib.TestManager.Suite; - - lib.TestManager.Suite.subclasses.push(ctor); - - return ctor; -}; - -/** - * List of lib.TestManager.Suite subclasses, in the order they were defined. - */ -lib.TestManager.Suite.subclasses = []; - -/** - * Add a test to a lib.TestManager.Suite. - * - * This method is copied to new subclasses when they are created. - */ -lib.TestManager.Suite.addTest = function(testName, testFunction) { - if (testName in this.testMap_) - throw 'Duplicate test name: ' + testName; - - var test = new lib.TestManager.Test(this, testName, testFunction); - this.testMap_[testName] = test; - this.testList_.push(test); -}; - -/** - * Defines a disabled test. - */ -lib.TestManager.Suite.disableTest = function(testName, testFunction) { - if (testName in this.testMap_) - throw 'Duplicate test name: ' + testName; - - var test = new lib.TestManager.Test(this, testName, testFunction); - console.log('Disabled test: ' + test.fullName); -}; - -/** - * Get a lib.TestManager.Test instance by name. - * - * This method is copied to new subclasses when they are created. - * - * @param {string} testName The name of the desired test. - * @return {lib.TestManager.Test} The requested test, or undefined if it was not - * found. - */ -lib.TestManager.Suite.getTest = function(testName) { - return this.testMap_[testName]; -}; - -/** - * Get an array of lib.TestManager.Tests associated with this Suite. - * - * This method is copied to new subclasses when they are created. - */ -lib.TestManager.Suite.getTestList = function() { - return this.testList_; -}; - -/** - * Set properties on a test suite instance, pulling the property value from - * the context if it exists and from the defaults dictionary if not. - * - * This is intended to be used in your test suite's setup() method to - * define parameters for the test suite which may be overridden through the - * context object. For example... - * - * MySuite.prototype.setup = function(cx) { - * this.setDefaults(cx, {size: 10}); - * }; - * - * If the context object has a 'size' property then this.size will be set to - * the value of cx.size, otherwise this.size will get a default value of 10. - * - * @param {Object} cx The context object for a test run. - * @param {Object} defaults An object containing name/value pairs to set on - * this test suite instance. The value listed here will be used if the - * name is not defined on the context object. - */ -lib.TestManager.Suite.prototype.setDefaults = function(cx, defaults) { - for (var k in defaults) { - this[k] = (k in cx) ? cx[k] : defaults[k]; - } -}; - -/** - * Subclassable method called to set up the test suite. - * - * The default implementation of this method is a no-op. If your test suite - * requires some kind of suite-wide setup, this is the place to do it. - * - * It's fine to store state on the test suite instance, that state will be - * accessible to all tests in the suite. If any test case fails, the entire - * test suite object will be discarded and a new one will be created for - * the remaining tests. - * - * Any side effects outside of this test suite instance must be idempotent. - * For example, if you're adding DOM nodes to a document, make sure to first - * test that they're not already there. If they are, remove them rather than - * reuse them. You should not count on their state, since they were probably - * left behind by a failed testcase. - * - * Any exception here will abort the remainder of the test run. - * - * @param {Object} cx The context object for a test run. - */ -lib.TestManager.Suite.prototype.setup = function(cx) {}; - -/** - * Subclassable method called to do pre-test set up. - * - * The default implementation of this method is a no-op. If your test suite - * requires some kind of pre-test setup, this is the place to do it. - * - * This can be used to avoid a bunch of boilerplate setup/teardown code in - * this suite's testcases. - * - * Any exception here will abort the remainder of the test run. - * - * @param {lib.TestManager.Result} result The result object for the upcoming - * test. - * @param {Object} cx The context object for a test run. - */ -lib.TestManager.Suite.prototype.preamble = function(result, cx) {}; - -/** - * Subclassable method called to do post-test tear-down. - * - * The default implementation of this method is a no-op. If your test suite - * requires some kind of pre-test setup, this is the place to do it. - * - * This can be used to avoid a bunch of boilerplate setup/teardown code in - * this suite's testcases. - * - * Any exception here will abort the remainder of the test run. - * - * @param {lib.TestManager.Result} result The result object for the finished - * test. - * @param {Object} cx The context object for a test run. - */ -lib.TestManager.Suite.prototype.postamble = function(result, cx) {}; - -/** - * Object representing a single test in a test suite. - * - * These are created as part of the lib.TestManager.Suite.addTest() method. - * You should never have to construct one by hand. - * - * @param {lib.TestManager.Suite} suiteClass The test suite class containing - * this test. - * @param {string} testName The local name of this test case, not including the - * test suite name. - * @param {function(lib.TestManager.Result, Object)} testFunction The function - * to invoke for this test case. This is passed a Result instance and the - * context object associated with the test run. - * - */ -lib.TestManager.Test = function(suiteClass, testName, testFunction) { - /** - * The test suite class containing this function. - */ - this.suiteClass = suiteClass; - - /** - * The local name of this test, not including the test suite name. - */ - this.testName = testName; - - /** - * The global name of this test, including the test suite name. - */ - this.fullName = suiteClass.suiteName + '[' + testName + ']'; - - // The function to call for this test. - this.testFunction_ = testFunction; -}; - -/** - * Execute this test. - * - * This is called by a lib.TestManager.Result instance, as part of a - * lib.TestManager.TestRun. You should not call it by hand. - * - * @param {lib.TestManager.Result} result The result object for the test. - */ -lib.TestManager.Test.prototype.run = function(result) { - try { - // Tests are applied to the parent lib.TestManager.Suite subclass. - this.testFunction_.apply(result.suite, - [result, result.testRun.cx]); - } catch (ex) { - if (ex instanceof lib.TestManager.Result.TestComplete) - return; - - result.println('Test raised an exception: ' + ex); - - if (ex.stack) { - if (ex.stack instanceof Array) { - result.println(ex.stack.join('\n')); - } else { - result.println(ex.stack); - } - } - - result.completeTest_(result.FAILED, false); - } -}; - -/** - * Used to choose a set of tests and run them. - * - * It's slightly more convenient to construct one of these from - * lib.TestManager.prototype.createTestRun(). - * - * @param {lib.TestManager} testManager The testManager associated with this - * TestRun. - * @param {Object} cx A context to be passed into the tests. This can be used - * to set parameters for the test suite or individual test cases. - */ -lib.TestManager.TestRun = function(testManager, cx) { - /** - * The associated lib.TestManager instance. - */ - this.testManager = testManager; - - /** - * Shortcut to the lib.TestManager's log. - */ - this.log = testManager.log; - - /** - * The test run context. It's entirely up to the test suite and test cases - * how this is used. It is opaque to lib.TestManager.* classes. - */ - this.cx = cx || {}; - - /** - * The list of test cases that encountered failures. - */ - this.failures = []; - - /** - * The list of test cases that passed. - */ - this.passes = []; - - /** - * The time the test run started, or null if it hasn't been started yet. - */ - this.startDate = null; - - /** - * The time in milliseconds that the test run took to complete, or null if - * it hasn't completed yet. - */ - this.duration = null; - - /** - * The most recent result object, or null if the test run hasn't started - * yet. In order to detect late failures, this is not cleared when the test - * completes. - */ - this.currentResult = null; - - /** - * Number of maximum failures. The test run will stop when this number is - * reached. If 0 or omitted, the entire set of selected tests is run, even - * if some fail. - */ - this.maxFailures = 0; - - /** - * True if this test run ended early because of an unexpected condition. - */ - this.panic = false; - - // List of pending test cases. - this.testQueue_ = []; - -}; - -/** - * This value can be passed to select() to indicate that all tests should - * be selected. - */ -lib.TestManager.TestRun.prototype.ALL_TESTS = lib.f.createEnum(''); - -/** - * Add a single test to the test run. - */ -lib.TestManager.TestRun.prototype.selectTest = function(test) { - this.testQueue_.push(test); -}; - -lib.TestManager.TestRun.prototype.selectSuite = function( - suiteClass, opt_pattern) { - var pattern = opt_pattern || this.ALL_TESTS; - var selectCount = 0; - var testList = suiteClass.getTestList(); - - for (var j = 0; j < testList.length; j++) { - var test = testList[j]; - // Note that we're using "!==" rather than "!=" so that we're matching - // the ALL_TESTS String object, rather than the contents of the string. - if (pattern !== this.ALL_TESTS) { - if (pattern instanceof RegExp) { - if (!pattern.test(test.testName)) - continue; - } else if (test.testName != pattern) { - continue; - } - } - - this.selectTest(test); - selectCount++; - } - - return selectCount; -}; - -/** - * Selects one or more tests to gather results for. - * - * Selecting the same test more than once is allowed. - * - * @param {string|RegExp} pattern Pattern used to select tests. - * If TestRun.prototype.ALL_TESTS, all tests are selected. - * If a string, only the test that exactly matches is selected. - * If a RegExp, only tests matching the RegExp are added. - * - * @return {int} The number of additional tests that have been selected into - * this TestRun. - */ -lib.TestManager.TestRun.prototype.selectPattern = function(pattern) { - var selectCount = 0; - - for (var i = 0; i < lib.TestManager.Suite.subclasses.length; i++) { - selectCount += this.selectSuite(lib.TestManager.Suite.subclasses[i], - pattern); - } - - if (!selectCount) { - this.log.warn('No tests matched selection criteria: ' + pattern); - } - - return selectCount; -}; - -/** - * Hooked up to window.onerror during a test run in order to catch exceptions - * that would otherwise go uncaught. - */ -lib.TestManager.TestRun.prototype.onUncaughtException_ = function( - message, file, line) { - - if (message.indexOf('Uncaught lib.TestManager.Result.TestComplete') == 0 || - message.indexOf('status: passed') != -1) { - // This is a result.pass() or result.fail() call from a callback. We're - // already going to deal with it as part of the completeTest_() call - // that raised it. We can safely squelch this error message. - return true; - } - - if (!this.currentResult) - return; - - if (message == 'Uncaught ' + this.currentResult.expectedErrorMessage_) { - // Test cases may need to raise an unhandled exception as part of the test. - return; - } - - var when = 'during'; - - if (this.currentResult.status != this.currentResult.PENDING) - when = 'after'; - - this.log.error('Uncaught exception ' + when + ' test case: ' + - this.currentResult.test.fullName); - this.log.error(message + ', ' + file + ':' + line); - - this.currentResult.completeTest_(this.currentResult.FAILED, false); - - return false; -}; - -/** - * Called to when this test run has completed. - * - * This method typically re-runs itself asynchronously, in order to let the - * DOM stabilize and short-term timeouts to complete before declaring the - * test run complete. - * - * @param {boolean} opt_skipTimeout If true, the timeout is skipped and the - * test run is completed immediately. This should only be used from within - * this function. - */ -lib.TestManager.TestRun.prototype.onTestRunComplete_ = function( - opt_skipTimeout) { - if (!opt_skipTimeout) { - // The final test may have left a lingering setTimeout(..., 0), or maybe - // poked at the DOM in a way that will trigger a event to fire at the end - // of this stack, so we give things a chance to settle down before our - // final cleanup... - setTimeout(this.onTestRunComplete_.bind(this), 0, true); - return; - } - - this.duration = (new Date()) - this.startDate; - - this.log.groupEnd(); - this.log.info(this.passes.length + ' passed, ' + - this.failures.length + ' failed, ' + - this.msToSeconds_(this.duration)); - - this.summarize(); - - window.onerror = null; - - this.testManager.onTestRunComplete(this); -}; - -/** - * Called by the lib.TestManager.Result object when a test completes. - * - * @param {lib.TestManager.Result} result The result object which has just - * completed. - */ -lib.TestManager.TestRun.prototype.onResultComplete = function(result) { - try { - this.testManager.testPostamble(result, this.cx); - result.suite.postamble(result, this.ctx); - } catch (ex) { - this.log.error('Unexpected exception in postamble: ' + - (ex.stack ? ex.stack : ex)); - this.panic = true; - } - - if (result.status != result.PASSED) - this.log.error(result.status); - else if (result.duration > 500) - this.log.warn('Slow test took ' + this.msToSeconds_(result.duration)); - this.log.groupEnd(); - - if (result.status == result.FAILED) { - this.failures.push(result); - this.currentSuite = null; - } else if (result.status == result.PASSED) { - this.passes.push(result); - } else { - this.log.error('Unknown result status: ' + result.test.fullName + ': ' + - result.status); - this.panic = true; - return; - } - - this.runNextTest_(); -}; - -/** - * Called by the lib.TestManager.Result object when a test which has already - * completed reports another completion. - * - * This is usually indicative of a buggy testcase. It is probably reporting a - * result on exit and then again from an asynchronous callback. - * - * It may also be the case that the last act of the testcase causes a DOM change - * which triggers some event to run after the test returns. If the event - * handler reports a failure or raises an uncaught exception, the test will - * fail even though it has already completed. - * - * In any case, re-completing a test ALWAYS moves it into the failure pile. - * - * @param {lib.TestManager.Result} result The result object which has just - * completed. - * @param {string} lateStatus The status that the test attempted to record this - * time around. - */ -lib.TestManager.TestRun.prototype.onResultReComplete = function( - result, lateStatus) { - this.log.error('Late complete for test: ' + result.test.fullName + ': ' + - lateStatus); - - // Consider any late completion a failure, even if it's a double-pass, since - // it's a misuse of the testing API. - var index = this.passes.indexOf(result); - if (index >= 0) { - this.passes.splice(index, 1); - this.failures.push(result); - } -}; - -/** - * Run the next test in the queue. - */ -lib.TestManager.TestRun.prototype.runNextTest_ = function() { - if (this.panic || !this.testQueue_.length) { - this.onTestRunComplete_(); - return; - } - - if (this.maxFailures && this.failures.length >= this.maxFailures) { - this.log.error('Maximum failure count reached, aborting test run.'); - this.onTestRunComplete_(); - return; - } - - // Peek at the top test first. We remove it later just before it's about - // to run, so that we don't disturb the incomplete test count in the - // event that we fail before running it. - var test = this.testQueue_[0]; - var suite = this.currentResult ? this.currentResult.suite : null; - - try { - if (!suite || !(suite instanceof test.suiteClass)) { - if (suite) - this.log.groupEnd(); - this.log.group(test.suiteClass.suiteName); - suite = new test.suiteClass(this.testManager, this.cx); - } - } catch (ex) { - // If test suite setup fails we're not even going to try to run the tests. - this.log.error('Exception during setup: ' + (ex.stack ? ex.stack : ex)); - this.panic = true; - this.onTestRunComplete_(); - return; - } - - try { - this.log.group(test.testName); - - this.currentResult = new lib.TestManager.Result(this, suite, test); - this.testManager.testPreamble(this.currentResult, this.cx); - suite.preamble(this.currentResult, this.cx); - - this.testQueue_.shift(); - } catch (ex) { - this.log.error('Unexpected exception during test preamble: ' + - (ex.stack ? ex.stack : ex)); - this.log.groupEnd(); - - this.panic = true; - this.onTestRunComplete_(); - return; - } - - try { - this.currentResult.run(); - } catch (ex) { - // Result.run() should catch test exceptions and turn them into failures. - // If we got here, it means there is trouble in the testing framework. - this.log.error('Unexpected exception during test run: ' + - (ex.stack ? ex.stack : ex)); - this.panic = true; - } -}; - -/** - * Run the selected list of tests. - * - * Some tests may need to run asynchronously, so you cannot assume the run is - * complete when this function returns. Instead, pass in a function to be - * called back when the run has completed. - * - * This function will log the results of the test run as they happen into the - * log defined by the associated lib.TestManager. By default this is - * console.log, which can be viewed in the JavaScript console of most browsers. - * - * The browser state is determined by the last test to run. We intentionally - * don't do any cleanup so that you can inspect the state of a failed test, or - * leave the browser ready for manual testing. - * - * Any failures in lib.TestManager.* code or test suite setup or test case - * preamble will cause the test run to abort. - */ -lib.TestManager.TestRun.prototype.run = function() { - this.log.info('Running ' + this.testQueue_.length + ' test(s)'); - - window.onerror = this.onUncaughtException_.bind(this); - this.startDate = new Date(); - this.runNextTest_(); -}; - -/** - * Format milliseconds as fractional seconds. - */ -lib.TestManager.TestRun.prototype.msToSeconds_ = function(ms) { - var secs = (ms / 1000).toFixed(2); - return secs + 's'; -}; - -/** - * Log the current result summary. - */ -lib.TestManager.TestRun.prototype.summarize = function() { - if (this.failures.length) { - for (var i = 0; i < this.failures.length; i++) { - this.log.error('FAILED: ' + this.failures[i].test.fullName); - } - } - - if (this.testQueue_.length) { - this.log.warn('Test run incomplete: ' + this.testQueue_.length + - ' test(s) were not run.'); - } -}; - -/** - * Record of the result of a single test. - * - * These are constructed during a test run, you shouldn't have to make one - * on your own. - * - * An instance of this class is passed in to each test function. It can be - * used to add messages to the test log, to record a test pass/fail state, to - * test assertions, or to create exception-proof wrappers for callback - * functions. - * - * @param {lib.TestManager.TestRun} testRun The TestRun instance associated with - * this result. - * @param {lib.TestManager.Suit} suite The Suite containing the test we're - * collecting this result for. - * @param {lib.TestManager.Test} test The test we're collecting this result for. - */ -lib.TestManager.Result = function(testRun, suite, test) { - /** - * The TestRun instance associated with this result. - */ - this.testRun = testRun; - - /** - * The Suite containing the test we're collecting this result for. - */ - this.suite = suite; - - /** - * The test we're collecting this result for. - */ - this.test = test; - - /** - * The time we started to collect this result, or null if we haven't started. - */ - this.startDate = null; - - /** - * The time in milliseconds that the test took to complete, or null if - * it hasn't completed yet. - */ - this.duration = null; - - /** - * The current status of this test result. - */ - this.status = this.PENDING; - - // An error message that the test case is expected to generate. - this.expectedErrorMessage_ = null; -}; - -/** - * Possible values for this.status. - */ -lib.TestManager.Result.prototype.PENDING = 'pending'; -lib.TestManager.Result.prototype.FAILED = 'FAILED'; -lib.TestManager.Result.prototype.PASSED = 'passed'; - -/** - * Exception thrown when a test completes (pass or fail), to ensure no more of - * the test is run. - */ -lib.TestManager.Result.TestComplete = function(result) { - this.result = result; -}; - -lib.TestManager.Result.TestComplete.prototype.toString = function() { - return 'lib.TestManager.Result.TestComplete: ' + this.result.test.fullName + - ', status: ' + this.result.status; -}; - -/** - * Start the test associated with this result. - */ -lib.TestManager.Result.prototype.run = function() { - this.startDate = new Date(); - this.test.run(this); - - if (this.status == this.PENDING && !this.timeout_) { - this.println('Test did not return a value and did not request more time.'); - this.completeTest_(this.FAILED, false); - } -}; - -/** - * Unhandled error message this test expects to generate. - * - * This must be the exact string that would appear in the JavaScript console, - * minus the 'Uncaught ' prefix. - * - * The test case does *not* automatically fail if the error message is not - * encountered. - */ -lib.TestManager.Result.prototype.expectErrorMessage = function(str) { - this.expectedErrorMessage_ = str; -}; - -/** - * Function called when a test times out. - */ -lib.TestManager.Result.prototype.onTimeout_ = function() { - this.timeout_ = null; - - if (this.status != this.PENDING) - return; - - this.println('Test timed out.'); - this.completeTest_(this.FAILED, false); -}; - -/** - * Indicate that a test case needs more time to complete. - * - * Before a test case returns it must report a pass/fail result, or request more - * time to do so. - * - * If a test does not report pass/fail before the time expires it will - * be reported as a timeout failure. Any late pass/fails will be noted in the - * test log, but will not affect the final result of the test. - * - * Test cases may call requestTime more than once. If you have a few layers - * of asynchronous API to go through, you should call this once per layer with - * an estimate of how long each callback will take to complete. - * - * @param {int} ms Number of milliseconds requested. - */ -lib.TestManager.Result.prototype.requestTime = function(ms) { - if (this.timeout_) - clearTimeout(this.timeout_); - - this.timeout_ = setTimeout(this.onTimeout_.bind(this), ms); -}; - -/** - * Report the completion of a test. - * - * @param {string} status The status of the test case. - * @param {boolean} opt_throw Optional boolean indicating whether or not - * to throw the TestComplete exception. - */ -lib.TestManager.Result.prototype.completeTest_ = function(status, opt_throw) { - if (this.status == this.PENDING) { - this.duration = (new Date()) - this.startDate; - this.status = status; - - this.testRun.onResultComplete(this); - } else { - this.testRun.onResultReComplete(this, status); - } - - if (arguments.length < 2 || opt_throw) - throw new lib.TestManager.Result.TestComplete(this); -}; - -/** - * Assert that an actual value is exactly equal to the expected value. - * - * This uses the JavaScript '===' operator in order to avoid type coercion. - * - * If the assertion fails, the test is marked as a failure and a TestCompleted - * exception is thrown. - * - * @param {*} actual The actual measured value. - * @param {*} expected The value expected. - * @param {string} opt_name An optional name used to identify this - * assertion in the test log. If omitted it will be the file:line - * of the caller. - */ -lib.TestManager.Result.prototype.assertEQ = function( - actual, expected, opt_name) { - // Utility function to pretty up the log. - function format(value) { - if (typeof value == 'number') - return value; - - var str = String(value); - var ary = str.split('\n').map((e) => JSON.stringify(e)); - if (ary.length > 1) { - // If the string has newlines, start it off on its own line so that - // it's easier to compare against another string with newlines. - return '\n' + ary.join('\n'); - } else { - return ary.join('\n'); - } - } - - if (actual === expected) - return; - - // Deal with common object types since JavaScript can't. - if (expected instanceof Array) - if (lib.array.compare(actual, expected)) - return; - - var name = opt_name ? '[' + opt_name + ']' : ''; - - this.fail('assertEQ' + name + ': ' + this.getCallerLocation_(1) + ': ' + - format(actual) + ' !== ' + format(expected)); -}; - -/** - * Assert that a value is true. - * - * This uses the JavaScript '===' operator in order to avoid type coercion. - * The must be the boolean value `true`, not just some "truish" value. - * - * If the assertion fails, the test is marked as a failure and a TestCompleted - * exception is thrown. - * - * @param {boolean} actual The actual measured value. - * @param {string} opt_name An optional name used to identify this - * assertion in the test log. If omitted it will be the file:line - * of the caller. - */ -lib.TestManager.Result.prototype.assert = function(actual, opt_name) { - if (actual === true) - return; - - var name = opt_name ? '[' + opt_name + ']' : ''; - - this.fail('assert' + name + ': ' + this.getCallerLocation_(1) + ': ' + - String(actual)); -}; - -/** - * Return the filename:line of a calling stack frame. - * - * This uses a dirty hack. It throws an exception, catches it, and examines - * the stack property of the caught exception. - * - * @param {int} frameIndex The stack frame to return. 0 is the frame that - * called this method, 1 is its caller, and so on. - * @return {string} A string of the format "filename:linenumber". - */ -lib.TestManager.Result.prototype.getCallerLocation_ = function(frameIndex) { - try { - throw new Error(); - } catch (ex) { - var frame = ex.stack.split('\n')[frameIndex + 2]; - var ary = frame.match(/([^/]+:\d+):\d+\)?$/); - return ary ? ary[1] : '???'; - } -}; - -/** - * Write a message to the result log. - */ -lib.TestManager.Result.prototype.println = function(message) { - this.testRun.log.info(message); -}; - -/** - * Mark a failed test and exit out of the rest of the test. - * - * This will throw a TestCompleted exception, causing the current test to stop. - * - * @param {string} opt_message Optional message to add to the log. - */ -lib.TestManager.Result.prototype.fail = function(opt_message) { - if (arguments.length) - this.println(opt_message); - - this.completeTest_(this.FAILED, true); -}; - -/** - * Mark a passed test and exit out of the rest of the test. - * - * This will throw a TestCompleted exception, causing the current test to stop. - */ -lib.TestManager.Result.prototype.pass = function() { - this.completeTest_(this.PASSED, true); -}; -// SOURCE FILE: libdot/js/lib_utf8.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -// TODO(davidben): When the string encoding API is implemented, -// replace this with the native in-browser implementation. -// -// https://wiki.whatwg.org/wiki/StringEncoding -// https://encoding.spec.whatwg.org/ - -/** - * A stateful UTF-8 decoder. - */ -lib.UTF8Decoder = function() { - // The number of bytes left in the current sequence. - this.bytesLeft = 0; - // The in-progress code point being decoded, if bytesLeft > 0. - this.codePoint = 0; - // The lower bound on the final code point, if bytesLeft > 0. - this.lowerBound = 0; -}; - -/** - * Decodes a some UTF-8 data, taking into account state from previous - * data streamed through the encoder. - * - * @param {String} str data to decode, represented as a JavaScript - * String with each code unit representing a byte between 0x00 to - * 0xFF. - * @return {String} The data decoded into a JavaScript UTF-16 string. - */ -lib.UTF8Decoder.prototype.decode = function(str) { - var ret = ''; - for (var i = 0; i < str.length; i++) { - var c = str.charCodeAt(i); - if (this.bytesLeft == 0) { - if (c <= 0x7F) { - ret += str.charAt(i); - } else if (0xC0 <= c && c <= 0xDF) { - this.codePoint = c - 0xC0; - this.bytesLeft = 1; - this.lowerBound = 0x80; - } else if (0xE0 <= c && c <= 0xEF) { - this.codePoint = c - 0xE0; - this.bytesLeft = 2; - this.lowerBound = 0x800; - } else if (0xF0 <= c && c <= 0xF7) { - this.codePoint = c - 0xF0; - this.bytesLeft = 3; - this.lowerBound = 0x10000; - } else if (0xF8 <= c && c <= 0xFB) { - this.codePoint = c - 0xF8; - this.bytesLeft = 4; - this.lowerBound = 0x200000; - } else if (0xFC <= c && c <= 0xFD) { - this.codePoint = c - 0xFC; - this.bytesLeft = 5; - this.lowerBound = 0x4000000; - } else { - ret += '\ufffd'; - } - } else { - if (0x80 <= c && c <= 0xBF) { - this.bytesLeft--; - this.codePoint = (this.codePoint << 6) + (c - 0x80); - if (this.bytesLeft == 0) { - // Got a full sequence. Check if it's within bounds and - // filter out surrogate pairs. - var codePoint = this.codePoint; - if (codePoint < this.lowerBound - || (0xD800 <= codePoint && codePoint <= 0xDFFF) - || codePoint > 0x10FFFF) { - ret += '\ufffd'; - } else { - // Encode as UTF-16 in the output. - if (codePoint < 0x10000) { - ret += String.fromCharCode(codePoint); - } else { - // Surrogate pair. - codePoint -= 0x10000; - ret += String.fromCharCode( - 0xD800 + ((codePoint >>> 10) & 0x3FF), - 0xDC00 + (codePoint & 0x3FF)); - } - } - } - } else { - // Too few bytes in multi-byte sequence. Rewind stream so we - // don't lose the next byte. - ret += '\ufffd'; - this.bytesLeft = 0; - i--; - } - } - } - return ret; -}; - -/** - * Decodes UTF-8 data. This is a convenience function for when all the - * data is already known. - * - * @param {String} str data to decode, represented as a JavaScript - * String with each code unit representing a byte between 0x00 to - * 0xFF. - * @return {String} The data decoded into a JavaScript UTF-16 string. - */ -lib.decodeUTF8 = function(utf8) { - return (new lib.UTF8Decoder()).decode(utf8); -}; - -/** - * Encodes a UTF-16 string into UTF-8. - * - * TODO(davidben): Do we need a stateful version of this that can - * handle a surrogate pair split in two calls? What happens if a - * keypress event would have contained a character outside the BMP? - * - * @param {String} str The string to encode. - * @return {String} The string encoded as UTF-8, as a JavaScript - * string with bytes represented as code units from 0x00 to 0xFF. - */ -lib.encodeUTF8 = function(str) { - var ret = ''; - for (var i = 0; i < str.length; i++) { - // Get a unicode code point out of str. - var c = str.charCodeAt(i); - if (0xDC00 <= c && c <= 0xDFFF) { - c = 0xFFFD; - } else if (0xD800 <= c && c <= 0xDBFF) { - if (i+1 < str.length) { - var d = str.charCodeAt(i+1); - if (0xDC00 <= d && d <= 0xDFFF) { - // Swallow a surrogate pair. - c = 0x10000 + ((c & 0x3FF) << 10) + (d & 0x3FF); - i++; - } else { - c = 0xFFFD; - } - } else { - c = 0xFFFD; - } - } - - // Encode c in UTF-8. - var bytesLeft; - if (c <= 0x7F) { - ret += str.charAt(i); - continue; - } else if (c <= 0x7FF) { - ret += String.fromCharCode(0xC0 | (c >>> 6)); - bytesLeft = 1; - } else if (c <= 0xFFFF) { - ret += String.fromCharCode(0xE0 | (c >>> 12)); - bytesLeft = 2; - } else /* if (c <= 0x10FFFF) */ { - ret += String.fromCharCode(0xF0 | (c >>> 18)); - bytesLeft = 3; - } - - while (bytesLeft > 0) { - bytesLeft--; - ret += String.fromCharCode(0x80 | ((c >>> (6 * bytesLeft)) & 0x3F)); - } - } - return ret; -}; -// SOURCE FILE: libdot/third_party/wcwidth/lib_wc.js -// Copyright (c) 2014 The Chromium OS Authors. All rights reserved. -// Use of lib.wc source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * This JavaScript library is ported from the wcwidth.js module of node.js. - * The original implementation can be found at: - * https://npmjs.org/package/wcwidth.js - */ - -/** - * JavaScript porting of Markus Kuhn's wcwidth() implementation - * - * The following explanation comes from the original C implementation: - * - * This is an implementation of wcwidth() and wcswidth() (defined in - * IEEE Std 1002.1-2001) for Unicode. - * - * http://www.opengroup.org/onlinepubs/007904975/functions/wcwidth.html - * http://www.opengroup.org/onlinepubs/007904975/functions/wcswidth.html - * - * In fixed-width output devices, Latin characters all occupy a single - * "cell" position of equal width, whereas ideographic CJK characters - * occupy two such cells. Interoperability between terminal-line - * applications and (teletype-style) character terminals using the - * UTF-8 encoding requires agreement on which character should advance - * the cursor by how many cell positions. No established formal - * standards exist at present on which Unicode character shall occupy - * how many cell positions on character terminals. These routines are - * a first attempt of defining such behavior based on simple rules - * applied to data provided by the Unicode Consortium. - * - * For some graphical characters, the Unicode standard explicitly - * defines a character-cell width via the definition of the East Asian - * FullWidth (F), Wide (W), Half-width (H), and Narrow (Na) classes. - * In all these cases, there is no ambiguity about which width a - * terminal shall use. For characters in the East Asian Ambiguous (A) - * class, the width choice depends purely on a preference of backward - * compatibility with either historic CJK or Western practice. - * Choosing single-width for these characters is easy to justify as - * the appropriate long-term solution, as the CJK practice of - * displaying these characters as double-width comes from historic - * implementation simplicity (8-bit encoded characters were displayed - * single-width and 16-bit ones double-width, even for Greek, - * Cyrillic, etc.) and not any typographic considerations. - * - * Much less clear is the choice of width for the Not East Asian - * (Neutral) class. Existing practice does not dictate a width for any - * of these characters. It would nevertheless make sense - * typographically to allocate two character cells to characters such - * as for instance EM SPACE or VOLUME INTEGRAL, which cannot be - * represented adequately with a single-width glyph. The following - * routines at present merely assign a single-cell width to all - * neutral characters, in the interest of simplicity. This is not - * entirely satisfactory and should be reconsidered before - * establishing a formal standard in lib.wc area. At the moment, the - * decision which Not East Asian (Neutral) characters should be - * represented by double-width glyphs cannot yet be answered by - * applying a simple rule from the Unicode database content. Setting - * up a proper standard for the behavior of UTF-8 character terminals - * will require a careful analysis not only of each Unicode character, - * but also of each presentation form, something the author of these - * routines has avoided to do so far. - * - * http://www.unicode.org/unicode/reports/tr11/ - * - * Markus Kuhn -- 2007-05-26 (Unicode 5.0) - * - * Permission to use, copy, modify, and distribute lib.wc software - * for any purpose and without fee is hereby granted. The author - * disclaims all warranties with regard to lib.wc software. - * - * Latest version: http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c - */ - -/** - * The following function defines the column width of an ISO 10646 character - * as follows: - * - * - The null character (U+0000) has a column width of 0. - * - Other C0/C1 control characters and DEL will lead to a return value of -1. - * - Non-spacing and enclosing combining characters (general category code Mn - * or Me in the Unicode database) have a column width of 0. - * - SOFT HYPHEN (U+00AD) has a column width of 1. - * - Other format characters (general category code Cf in the Unicode database) - * and ZERO WIDTH SPACE (U+200B) have a column width of 0. - * - Hangul Jamo medial vowels and final consonants (U+1160-U+11FF) have a - * column width of 0. - * - Spacing characters in the East Asian Wide (W) or East Asian Full-width (F) - * category as defined in Unicode Technical Report #11 have a column width of - * 2. - * - East Asian Ambiguous characters are taken into account if - * regardCjkAmbiguous flag is enabled. They have a column width of 2. - * - All remaining characters (including all printable ISO 8859-1 and WGL4 - * characters, Unicode control characters, etc.) have a column width of 1. - * - * This implementation assumes that characters are encoded in ISO 10646. - */ - -lib.wc = {}; - -// Width of a nul character. -lib.wc.nulWidth = 0; - -// Width of a control character. -lib.wc.controlWidth = 0; - -// Flag whether to consider East Asian Ambiguous characters. -lib.wc.regardCjkAmbiguous = false; - -// Width of an East Asian Ambiguous character. -lib.wc.cjkAmbiguousWidth = 2; - -// Sorted list of non-overlapping intervals of non-spacing characters -// generated by the `./ranges.py` helper. -lib.wc.combining = [ - [0x00ad, 0x00ad], [0x0300, 0x036f], [0x0483, 0x0489], - [0x0591, 0x05bd], [0x05bf, 0x05bf], [0x05c1, 0x05c2], - [0x05c4, 0x05c5], [0x05c7, 0x05c7], [0x0610, 0x061a], - [0x061c, 0x061c], [0x064b, 0x065f], [0x0670, 0x0670], - [0x06d6, 0x06dc], [0x06df, 0x06e4], [0x06e7, 0x06e8], - [0x06ea, 0x06ed], [0x0711, 0x0711], [0x0730, 0x074a], - [0x07a6, 0x07b0], [0x07eb, 0x07f3], [0x0816, 0x0819], - [0x081b, 0x0823], [0x0825, 0x0827], [0x0829, 0x082d], - [0x0859, 0x085b], [0x08d4, 0x08e1], [0x08e3, 0x0902], - [0x093a, 0x093a], [0x093c, 0x093c], [0x0941, 0x0948], - [0x094d, 0x094d], [0x0951, 0x0957], [0x0962, 0x0963], - [0x0981, 0x0981], [0x09bc, 0x09bc], [0x09c1, 0x09c4], - [0x09cd, 0x09cd], [0x09e2, 0x09e3], [0x0a01, 0x0a02], - [0x0a3c, 0x0a3c], [0x0a41, 0x0a42], [0x0a47, 0x0a48], - [0x0a4b, 0x0a4d], [0x0a51, 0x0a51], [0x0a70, 0x0a71], - [0x0a75, 0x0a75], [0x0a81, 0x0a82], [0x0abc, 0x0abc], - [0x0ac1, 0x0ac5], [0x0ac7, 0x0ac8], [0x0acd, 0x0acd], - [0x0ae2, 0x0ae3], [0x0afa, 0x0aff], [0x0b01, 0x0b01], - [0x0b3c, 0x0b3c], [0x0b3f, 0x0b3f], [0x0b41, 0x0b44], - [0x0b4d, 0x0b4d], [0x0b56, 0x0b56], [0x0b62, 0x0b63], - [0x0b82, 0x0b82], [0x0bc0, 0x0bc0], [0x0bcd, 0x0bcd], - [0x0c00, 0x0c00], [0x0c3e, 0x0c40], [0x0c46, 0x0c48], - [0x0c4a, 0x0c4d], [0x0c55, 0x0c56], [0x0c62, 0x0c63], - [0x0c81, 0x0c81], [0x0cbc, 0x0cbc], [0x0cbf, 0x0cbf], - [0x0cc6, 0x0cc6], [0x0ccc, 0x0ccd], [0x0ce2, 0x0ce3], - [0x0d00, 0x0d01], [0x0d3b, 0x0d3c], [0x0d41, 0x0d44], - [0x0d4d, 0x0d4d], [0x0d62, 0x0d63], [0x0dca, 0x0dca], - [0x0dd2, 0x0dd4], [0x0dd6, 0x0dd6], [0x0e31, 0x0e31], - [0x0e34, 0x0e3a], [0x0e47, 0x0e4e], [0x0eb1, 0x0eb1], - [0x0eb4, 0x0eb9], [0x0ebb, 0x0ebc], [0x0ec8, 0x0ecd], - [0x0f18, 0x0f19], [0x0f35, 0x0f35], [0x0f37, 0x0f37], - [0x0f39, 0x0f39], [0x0f71, 0x0f7e], [0x0f80, 0x0f84], - [0x0f86, 0x0f87], [0x0f8d, 0x0f97], [0x0f99, 0x0fbc], - [0x0fc6, 0x0fc6], [0x102d, 0x1030], [0x1032, 0x1037], - [0x1039, 0x103a], [0x103d, 0x103e], [0x1058, 0x1059], - [0x105e, 0x1060], [0x1071, 0x1074], [0x1082, 0x1082], - [0x1085, 0x1086], [0x108d, 0x108d], [0x109d, 0x109d], - [0x1160, 0x11ff], [0x135d, 0x135f], [0x1712, 0x1714], - [0x1732, 0x1734], [0x1752, 0x1753], [0x1772, 0x1773], - [0x17b4, 0x17b5], [0x17b7, 0x17bd], [0x17c6, 0x17c6], - [0x17c9, 0x17d3], [0x17dd, 0x17dd], [0x180b, 0x180e], - [0x1885, 0x1886], [0x18a9, 0x18a9], [0x1920, 0x1922], - [0x1927, 0x1928], [0x1932, 0x1932], [0x1939, 0x193b], - [0x1a17, 0x1a18], [0x1a1b, 0x1a1b], [0x1a56, 0x1a56], - [0x1a58, 0x1a5e], [0x1a60, 0x1a60], [0x1a62, 0x1a62], - [0x1a65, 0x1a6c], [0x1a73, 0x1a7c], [0x1a7f, 0x1a7f], - [0x1ab0, 0x1abe], [0x1b00, 0x1b03], [0x1b34, 0x1b34], - [0x1b36, 0x1b3a], [0x1b3c, 0x1b3c], [0x1b42, 0x1b42], - [0x1b6b, 0x1b73], [0x1b80, 0x1b81], [0x1ba2, 0x1ba5], - [0x1ba8, 0x1ba9], [0x1bab, 0x1bad], [0x1be6, 0x1be6], - [0x1be8, 0x1be9], [0x1bed, 0x1bed], [0x1bef, 0x1bf1], - [0x1c2c, 0x1c33], [0x1c36, 0x1c37], [0x1cd0, 0x1cd2], - [0x1cd4, 0x1ce0], [0x1ce2, 0x1ce8], [0x1ced, 0x1ced], - [0x1cf4, 0x1cf4], [0x1cf8, 0x1cf9], [0x1dc0, 0x1df9], - [0x1dfb, 0x1dff], [0x200b, 0x200f], [0x202a, 0x202e], - [0x2060, 0x2064], [0x2066, 0x206f], [0x20d0, 0x20f0], - [0x2cef, 0x2cf1], [0x2d7f, 0x2d7f], [0x2de0, 0x2dff], - [0x302a, 0x302d], [0x3099, 0x309a], [0xa66f, 0xa672], - [0xa674, 0xa67d], [0xa69e, 0xa69f], [0xa6f0, 0xa6f1], - [0xa802, 0xa802], [0xa806, 0xa806], [0xa80b, 0xa80b], - [0xa825, 0xa826], [0xa8c4, 0xa8c5], [0xa8e0, 0xa8f1], - [0xa926, 0xa92d], [0xa947, 0xa951], [0xa980, 0xa982], - [0xa9b3, 0xa9b3], [0xa9b6, 0xa9b9], [0xa9bc, 0xa9bc], - [0xa9e5, 0xa9e5], [0xaa29, 0xaa2e], [0xaa31, 0xaa32], - [0xaa35, 0xaa36], [0xaa43, 0xaa43], [0xaa4c, 0xaa4c], - [0xaa7c, 0xaa7c], [0xaab0, 0xaab0], [0xaab2, 0xaab4], - [0xaab7, 0xaab8], [0xaabe, 0xaabf], [0xaac1, 0xaac1], - [0xaaec, 0xaaed], [0xaaf6, 0xaaf6], [0xabe5, 0xabe5], - [0xabe8, 0xabe8], [0xabed, 0xabed], [0xfb1e, 0xfb1e], - [0xfe00, 0xfe0f], [0xfe20, 0xfe2f], [0xfeff, 0xfeff], - [0xfff9, 0xfffb], [0x101fd, 0x101fd], [0x102e0, 0x102e0], - [0x10376, 0x1037a], [0x10a01, 0x10a03], [0x10a05, 0x10a06], - [0x10a0c, 0x10a0f], [0x10a38, 0x10a3a], [0x10a3f, 0x10a3f], - [0x10ae5, 0x10ae6], [0x11001, 0x11001], [0x11038, 0x11046], - [0x1107f, 0x11081], [0x110b3, 0x110b6], [0x110b9, 0x110ba], - [0x11100, 0x11102], [0x11127, 0x1112b], [0x1112d, 0x11134], - [0x11173, 0x11173], [0x11180, 0x11181], [0x111b6, 0x111be], - [0x111ca, 0x111cc], [0x1122f, 0x11231], [0x11234, 0x11234], - [0x11236, 0x11237], [0x1123e, 0x1123e], [0x112df, 0x112df], - [0x112e3, 0x112ea], [0x11300, 0x11301], [0x1133c, 0x1133c], - [0x11340, 0x11340], [0x11366, 0x1136c], [0x11370, 0x11374], - [0x11438, 0x1143f], [0x11442, 0x11444], [0x11446, 0x11446], - [0x114b3, 0x114b8], [0x114ba, 0x114ba], [0x114bf, 0x114c0], - [0x114c2, 0x114c3], [0x115b2, 0x115b5], [0x115bc, 0x115bd], - [0x115bf, 0x115c0], [0x115dc, 0x115dd], [0x11633, 0x1163a], - [0x1163d, 0x1163d], [0x1163f, 0x11640], [0x116ab, 0x116ab], - [0x116ad, 0x116ad], [0x116b0, 0x116b5], [0x116b7, 0x116b7], - [0x1171d, 0x1171f], [0x11722, 0x11725], [0x11727, 0x1172b], - [0x11a01, 0x11a06], [0x11a09, 0x11a0a], [0x11a33, 0x11a38], - [0x11a3b, 0x11a3e], [0x11a47, 0x11a47], [0x11a51, 0x11a56], - [0x11a59, 0x11a5b], [0x11a8a, 0x11a96], [0x11a98, 0x11a99], - [0x11c30, 0x11c36], [0x11c38, 0x11c3d], [0x11c3f, 0x11c3f], - [0x11c92, 0x11ca7], [0x11caa, 0x11cb0], [0x11cb2, 0x11cb3], - [0x11cb5, 0x11cb6], [0x11d31, 0x11d36], [0x11d3a, 0x11d3a], - [0x11d3c, 0x11d3d], [0x11d3f, 0x11d45], [0x11d47, 0x11d47], - [0x16af0, 0x16af4], [0x16b30, 0x16b36], [0x16f8f, 0x16f92], - [0x1bc9d, 0x1bc9e], [0x1bca0, 0x1bca3], [0x1d167, 0x1d169], - [0x1d173, 0x1d182], [0x1d185, 0x1d18b], [0x1d1aa, 0x1d1ad], - [0x1d242, 0x1d244], [0x1da00, 0x1da36], [0x1da3b, 0x1da6c], - [0x1da75, 0x1da75], [0x1da84, 0x1da84], [0x1da9b, 0x1da9f], - [0x1daa1, 0x1daaf], [0x1e000, 0x1e006], [0x1e008, 0x1e018], - [0x1e01b, 0x1e021], [0x1e023, 0x1e024], [0x1e026, 0x1e02a], - [0x1e8d0, 0x1e8d6], [0x1e944, 0x1e94a], [0xe0001, 0xe0001], - [0xe0020, 0xe007f], [0xe0100, 0xe01ef], -]; - -// Sorted list of non-overlapping intervals of East Asian Ambiguous characters -// generated by the `./ranges.py` helper. -lib.wc.ambiguous = [ - [0x00a1, 0x00a1], [0x00a4, 0x00a4], [0x00a7, 0x00a8], - [0x00aa, 0x00aa], [0x00ad, 0x00ae], [0x00b0, 0x00b4], - [0x00b6, 0x00ba], [0x00bc, 0x00bf], [0x00c6, 0x00c6], - [0x00d0, 0x00d0], [0x00d7, 0x00d8], [0x00de, 0x00e1], - [0x00e6, 0x00e6], [0x00e8, 0x00ea], [0x00ec, 0x00ed], - [0x00f0, 0x00f0], [0x00f2, 0x00f3], [0x00f7, 0x00fa], - [0x00fc, 0x00fc], [0x00fe, 0x00fe], [0x0101, 0x0101], - [0x0111, 0x0111], [0x0113, 0x0113], [0x011b, 0x011b], - [0x0126, 0x0127], [0x012b, 0x012b], [0x0131, 0x0133], - [0x0138, 0x0138], [0x013f, 0x0142], [0x0144, 0x0144], - [0x0148, 0x014b], [0x014d, 0x014d], [0x0152, 0x0153], - [0x0166, 0x0167], [0x016b, 0x016b], [0x01ce, 0x01ce], - [0x01d0, 0x01d0], [0x01d2, 0x01d2], [0x01d4, 0x01d4], - [0x01d6, 0x01d6], [0x01d8, 0x01d8], [0x01da, 0x01da], - [0x01dc, 0x01dc], [0x0251, 0x0251], [0x0261, 0x0261], - [0x02c4, 0x02c4], [0x02c7, 0x02c7], [0x02c9, 0x02cb], - [0x02cd, 0x02cd], [0x02d0, 0x02d0], [0x02d8, 0x02db], - [0x02dd, 0x02dd], [0x02df, 0x02df], [0x0300, 0x036f], - [0x0391, 0x03a1], [0x03a3, 0x03a9], [0x03b1, 0x03c1], - [0x03c3, 0x03c9], [0x0401, 0x0401], [0x0410, 0x044f], - [0x0451, 0x0451], [0x1100, 0x115f], [0x2010, 0x2010], - [0x2013, 0x2016], [0x2018, 0x2019], [0x201c, 0x201d], - [0x2020, 0x2022], [0x2024, 0x2027], [0x2030, 0x2030], - [0x2032, 0x2033], [0x2035, 0x2035], [0x203b, 0x203b], - [0x203e, 0x203e], [0x2074, 0x2074], [0x207f, 0x207f], - [0x2081, 0x2084], [0x20ac, 0x20ac], [0x2103, 0x2103], - [0x2105, 0x2105], [0x2109, 0x2109], [0x2113, 0x2113], - [0x2116, 0x2116], [0x2121, 0x2122], [0x2126, 0x2126], - [0x212b, 0x212b], [0x2153, 0x2154], [0x215b, 0x215e], - [0x2160, 0x216b], [0x2170, 0x2179], [0x2189, 0x2189], - [0x2190, 0x2199], [0x21b8, 0x21b9], [0x21d2, 0x21d2], - [0x21d4, 0x21d4], [0x21e7, 0x21e7], [0x2200, 0x2200], - [0x2202, 0x2203], [0x2207, 0x2208], [0x220b, 0x220b], - [0x220f, 0x220f], [0x2211, 0x2211], [0x2215, 0x2215], - [0x221a, 0x221a], [0x221d, 0x2220], [0x2223, 0x2223], - [0x2225, 0x2225], [0x2227, 0x222c], [0x222e, 0x222e], - [0x2234, 0x2237], [0x223c, 0x223d], [0x2248, 0x2248], - [0x224c, 0x224c], [0x2252, 0x2252], [0x2260, 0x2261], - [0x2264, 0x2267], [0x226a, 0x226b], [0x226e, 0x226f], - [0x2282, 0x2283], [0x2286, 0x2287], [0x2295, 0x2295], - [0x2299, 0x2299], [0x22a5, 0x22a5], [0x22bf, 0x22bf], - [0x2312, 0x2312], [0x231a, 0x231b], [0x2329, 0x232a], - [0x23e9, 0x23ec], [0x23f0, 0x23f0], [0x23f3, 0x23f3], - [0x2460, 0x24e9], [0x24eb, 0x254b], [0x2550, 0x2573], - [0x2580, 0x258f], [0x2592, 0x2595], [0x25a0, 0x25a1], - [0x25a3, 0x25a9], [0x25b2, 0x25b3], [0x25b6, 0x25b7], - [0x25bc, 0x25bd], [0x25c0, 0x25c1], [0x25c6, 0x25c8], - [0x25cb, 0x25cb], [0x25ce, 0x25d1], [0x25e2, 0x25e5], - [0x25ef, 0x25ef], [0x25fd, 0x25fe], [0x2605, 0x2606], - [0x2609, 0x2609], [0x260e, 0x260f], [0x2614, 0x2615], - [0x261c, 0x261c], [0x261e, 0x261e], [0x2640, 0x2640], - [0x2642, 0x2642], [0x2648, 0x2653], [0x2660, 0x2661], - [0x2663, 0x2665], [0x2667, 0x266a], [0x266c, 0x266d], - [0x266f, 0x266f], [0x267f, 0x267f], [0x2693, 0x2693], - [0x269e, 0x269f], [0x26a1, 0x26a1], [0x26aa, 0x26ab], - [0x26bd, 0x26bf], [0x26c4, 0x26e1], [0x26e3, 0x26e3], - [0x26e8, 0x26ff], [0x2705, 0x2705], [0x270a, 0x270b], - [0x2728, 0x2728], [0x273d, 0x273d], [0x274c, 0x274c], - [0x274e, 0x274e], [0x2753, 0x2755], [0x2757, 0x2757], - [0x2776, 0x277f], [0x2795, 0x2797], [0x27b0, 0x27b0], - [0x27bf, 0x27bf], [0x2b1b, 0x2b1c], [0x2b50, 0x2b50], - [0x2b55, 0x2b59], [0x2e80, 0x2fdf], [0x2ff0, 0x303e], - [0x3040, 0x4dbf], [0x4e00, 0xa4cf], [0xa960, 0xa97f], - [0xac00, 0xd7a3], [0xe000, 0xfaff], [0xfe00, 0xfe19], - [0xfe30, 0xfe6f], [0xff01, 0xff60], [0xffe0, 0xffe6], - [0xfffd, 0xfffd], [0x16fe0, 0x16fe1], [0x17000, 0x18aff], - [0x1b000, 0x1b12f], [0x1b170, 0x1b2ff], [0x1f004, 0x1f004], - [0x1f0cf, 0x1f0cf], [0x1f100, 0x1f10a], [0x1f110, 0x1f12d], - [0x1f130, 0x1f169], [0x1f170, 0x1f1ac], [0x1f200, 0x1f202], - [0x1f210, 0x1f23b], [0x1f240, 0x1f248], [0x1f250, 0x1f251], - [0x1f260, 0x1f265], [0x1f300, 0x1f320], [0x1f32d, 0x1f335], - [0x1f337, 0x1f37c], [0x1f37e, 0x1f393], [0x1f3a0, 0x1f3ca], - [0x1f3cf, 0x1f3d3], [0x1f3e0, 0x1f3f0], [0x1f3f4, 0x1f3f4], - [0x1f3f8, 0x1f43e], [0x1f440, 0x1f440], [0x1f442, 0x1f4fc], - [0x1f4ff, 0x1f53d], [0x1f54b, 0x1f54e], [0x1f550, 0x1f567], - [0x1f57a, 0x1f57a], [0x1f595, 0x1f596], [0x1f5a4, 0x1f5a4], - [0x1f5fb, 0x1f64f], [0x1f680, 0x1f6c5], [0x1f6cc, 0x1f6cc], - [0x1f6d0, 0x1f6d2], [0x1f6eb, 0x1f6ec], [0x1f6f4, 0x1f6f8], - [0x1f910, 0x1f93e], [0x1f940, 0x1f94c], [0x1f950, 0x1f96b], - [0x1f980, 0x1f997], [0x1f9c0, 0x1f9c0], [0x1f9d0, 0x1f9e6], - [0x20000, 0x2fffd], [0x30000, 0x3fffd], [0xe0100, 0xe01ef], - [0xf0000, 0xffffd], [0x100000, 0x10fffd], -]; - -// Sorted list of non-overlapping intervals of East Asian Unambiguous characters -// generated by the `./ranges.py` helper. -lib.wc.unambiguous = [ - [0x1100, 0x115f], [0x231a, 0x231b], [0x2329, 0x232a], - [0x23e9, 0x23ec], [0x23f0, 0x23f0], [0x23f3, 0x23f3], - [0x25fd, 0x25fe], [0x2614, 0x2615], [0x2648, 0x2653], - [0x267f, 0x267f], [0x2693, 0x2693], [0x26a1, 0x26a1], - [0x26aa, 0x26ab], [0x26bd, 0x26be], [0x26c4, 0x26c5], - [0x26ce, 0x26ce], [0x26d4, 0x26d4], [0x26ea, 0x26ea], - [0x26f2, 0x26f3], [0x26f5, 0x26f5], [0x26fa, 0x26fa], - [0x26fd, 0x26fd], [0x2705, 0x2705], [0x270a, 0x270b], - [0x2728, 0x2728], [0x274c, 0x274c], [0x274e, 0x274e], - [0x2753, 0x2755], [0x2757, 0x2757], [0x2795, 0x2797], - [0x27b0, 0x27b0], [0x27bf, 0x27bf], [0x2b1b, 0x2b1c], - [0x2b50, 0x2b50], [0x2b55, 0x2b55], [0x2e80, 0x2fdf], - [0x2ff0, 0x303e], [0x3040, 0x3247], [0x3250, 0x4dbf], - [0x4e00, 0xa4cf], [0xa960, 0xa97f], [0xac00, 0xd7a3], - [0xf900, 0xfaff], [0xfe10, 0xfe19], [0xfe30, 0xfe6f], - [0xff01, 0xff60], [0xffe0, 0xffe6], [0x16fe0, 0x16fe1], - [0x17000, 0x18aff], [0x1b000, 0x1b12f], [0x1b170, 0x1b2ff], - [0x1f004, 0x1f004], [0x1f0cf, 0x1f0cf], [0x1f18e, 0x1f18e], - [0x1f191, 0x1f19a], [0x1f200, 0x1f202], [0x1f210, 0x1f23b], - [0x1f240, 0x1f248], [0x1f250, 0x1f251], [0x1f260, 0x1f265], - [0x1f300, 0x1f320], [0x1f32d, 0x1f335], [0x1f337, 0x1f37c], - [0x1f37e, 0x1f393], [0x1f3a0, 0x1f3ca], [0x1f3cf, 0x1f3d3], - [0x1f3e0, 0x1f3f0], [0x1f3f4, 0x1f3f4], [0x1f3f8, 0x1f43e], - [0x1f440, 0x1f440], [0x1f442, 0x1f4fc], [0x1f4ff, 0x1f53d], - [0x1f54b, 0x1f54e], [0x1f550, 0x1f567], [0x1f57a, 0x1f57a], - [0x1f595, 0x1f596], [0x1f5a4, 0x1f5a4], [0x1f5fb, 0x1f64f], - [0x1f680, 0x1f6c5], [0x1f6cc, 0x1f6cc], [0x1f6d0, 0x1f6d2], - [0x1f6eb, 0x1f6ec], [0x1f6f4, 0x1f6f8], [0x1f910, 0x1f93e], - [0x1f940, 0x1f94c], [0x1f950, 0x1f96b], [0x1f980, 0x1f997], - [0x1f9c0, 0x1f9c0], [0x1f9d0, 0x1f9e6], [0x20000, 0x2fffd], - [0x30000, 0x3fffd], -]; - -/** - * Binary search to check if the given unicode character is in the table. - * - * @param {integer} ucs A unicode character code. - * @param {Object} table A sorted list of internals to match against. - * @return {boolean} True if the given character is in the table. - */ -lib.wc.binaryTableSearch_ = function(ucs, table) { - var min = 0, max = table.length - 1; - var mid; - - if (ucs < table[min][0] || ucs > table[max][1]) - return false; - while (max >= min) { - mid = Math.floor((min + max) / 2); - if (ucs > table[mid][1]) { - min = mid + 1; - } else if (ucs < table[mid][0]) { - max = mid - 1; - } else { - return true; - } - } - - return false; -}; - -/** - * Binary search to check if the given unicode character is a space character. - * - * @param {integer} ucs A unicode character code. - * - * @return {boolean} True if the given character is a space character; false - * otherwise. - */ -lib.wc.isSpace = function(ucs) { - return lib.wc.binaryTableSearch_(ucs, lib.wc.combining); -}; - -/** - * Auxiliary function for checking if the given unicode character is a East - * Asian Ambiguous character. - * - * @param {integer} ucs A unicode character code. - * - * @return {boolean} True if the given character is a East Asian Ambiguous - * character. - */ -lib.wc.isCjkAmbiguous = function(ucs) { - return lib.wc.binaryTableSearch_(ucs, lib.wc.ambiguous); -}; - -/** - * Determine the column width of the given character. - * - * @param {integer} ucs A unicode character code. - * - * @return {integer} The column width of the given character. - */ -lib.wc.charWidth = function(ucs) { - if (lib.wc.regardCjkAmbiguous) { - return lib.wc.charWidthRegardAmbiguous(ucs); - } else { - return lib.wc.charWidthDisregardAmbiguous(ucs); - } -}; - -/** - * Determine the column width of the given character without considering East - * Asian Ambiguous characters. - * - * @param {integer} ucs A unicode character code. - * - * @return {integer} The column width of the given character. - */ -lib.wc.charWidthDisregardAmbiguous = function(ucs) { - // Optimize for ASCII characters. - if (ucs < 0x7f) { - if (ucs >= 0x20) - return 1; - else if (ucs == 0) - return lib.wc.nulWidth; - else /* if (ucs < 0x20) */ - return lib.wc.controlWidth; - } - - // Test for 8-bit control characters. - if (ucs < 0xa0) - return lib.wc.controlWidth; - - // Binary search in table of non-spacing characters. - if (lib.wc.isSpace(ucs)) - return 0; - - // Binary search in table of wide characters. - return lib.wc.binaryTableSearch_(ucs, lib.wc.unambiguous) ? 2 : 1; -}; - -/** - * Determine the column width of the given character considering East Asian - * Ambiguous characters. - * - * @param {integer} ucs A unicode character code. - * - * @return {integer} The column width of the given character. - */ -lib.wc.charWidthRegardAmbiguous = function(ucs) { - if (lib.wc.isCjkAmbiguous(ucs)) - return lib.wc.cjkAmbiguousWidth; - - return lib.wc.charWidthDisregardAmbiguous(ucs); -}; - -/** - * Determine the column width of the given string. - * - * @param {string} str A string. - * - * @return {integer} The column width of the given string. - */ -lib.wc.strWidth = function(str) { - var width, rv = 0; - - for (var i = 0; i < str.length;) { - var codePoint = str.codePointAt(i); - width = lib.wc.charWidth(codePoint); - if (width < 0) - return -1; - rv += width; - i += (codePoint <= 0xffff) ? 1 : 2; - } - - return rv; -}; - -/** - * Get the substring at the given column offset of the given column width. - * - * @param {string} str The string to get substring from. - * @param {integer} start The starting column offset to get substring. - * @param {integer} opt_width The column width of the substring. - * - * @return {string} The substring. - */ -lib.wc.substr = function(str, start, opt_width) { - var startIndex = 0; - var endIndex, width; - - // Fun edge case: Normally we associate zero width codepoints (like combining - // characters) with the previous codepoint, so we skip any leading ones while - // including trailing ones. However, if there are zero width codepoints at - // the start of the string, and the substring starts at 0, lets include them - // in the result. This also makes for a simple optimization for a common - // request. - if (start) { - for (width = 0; startIndex < str.length;) { - const codePoint = str.codePointAt(startIndex); - width += lib.wc.charWidth(codePoint); - if (width > start) - break; - startIndex += (codePoint <= 0xffff) ? 1 : 2; - } - } - - if (opt_width != undefined) { - for (endIndex = startIndex, width = 0; endIndex < str.length;) { - const codePoint = str.codePointAt(endIndex); - width += lib.wc.charWidth(codePoint); - if (width > opt_width) - break; - endIndex += (codePoint <= 0xffff) ? 1 : 2; - } - return str.substring(startIndex, endIndex); - } - - return str.substr(startIndex); -}; - -/** - * Get substring at the given start and end column offset. - * - * @param {string} str The string to get substring from. - * @param {integer} start The starting column offset. - * @param {integer} end The ending column offset. - * - * @return {string} The substring. - */ -lib.wc.substring = function(str, start, end) { - return lib.wc.substr(str, start, end - start); -}; -lib.resource.add('libdot/changelog/version', 'text/plain', -'1.21' -); - -lib.resource.add('libdot/changelog/date', 'text/plain', -'2018-01-05' -); - - -// This file was generated by libdot/bin/concat.sh. -// It has been marked read-only for your safety. Rather -// than edit it directly, please modify one of these source -// files... -// -// - -lib.resource.add('hterm/audio/bell', 'audio/ogg;base64', -'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' + -'zinmkFLKMeUcUko5p5xTzjkIHYTKMQadgxAppRxTzinHHITMQeWcg9BBKAAAIMABACDAQig0ZEUA' + -'ECcA4HAkz5M0SxQlSxNFzxRl1xNN15U0zTQ1UVRVyxNV1VRV2xZNVbYlTRNNTfRUVRNFVRVV05ZN' + -'VbVtzzRl2VRV3RZV1bZl2xZ+V5Z13zNNWRZV1dZNVbV115Z9X9ZtXZg0zTQ1UVRVTRRV1VRV2zZV' + -'17Y1UXRVUVVlWVRVWXZlWfdVV9Z9SxRV1VNN2RVVVbZV2fVtVZZ94XRVXVdl2fdVWRZ+W9eF4fZ9' + -'4RhV1dZN19V1VZZ9YdZlYbd13yhpmmlqoqiqmiiqqqmqtm2qrq1bouiqoqrKsmeqrqzKsq+rrmzr' + -'miiqrqiqsiyqqiyrsqz7qizrtqiquq3KsrCbrqvrtu8LwyzrunCqrq6rsuz7qizruq3rxnHrujB8' + -'pinLpqvquqm6um7runHMtm0co6rqvirLwrDKsu/rui+0dSFRVXXdlF3jV2VZ921fd55b94WybTu/' + -'rfvKceu60vg5z28cubZtHLNuG7+t+8bzKz9hOI6lZ5q2baqqrZuqq+uybivDrOtCUVV9XZVl3zdd' + -'WRdu3zeOW9eNoqrquirLvrDKsjHcxm8cuzAcXds2jlvXnbKtC31jyPcJz2vbxnH7OuP2daOvDAnH' + -'jwAAgAEHAIAAE8pAoSErAoA4AQAGIecUUxAqxSB0EFLqIKRUMQYhc05KxRyUUEpqIZTUKsYgVI5J' + -'yJyTEkpoKZTSUgehpVBKa6GU1lJrsabUYu0gpBZKaS2U0lpqqcbUWowRYxAy56RkzkkJpbQWSmkt' + -'c05K56CkDkJKpaQUS0otVsxJyaCj0kFIqaQSU0mptVBKa6WkFktKMbYUW24x1hxKaS2kEltJKcYU' + -'U20txpojxiBkzknJnJMSSmktlNJa5ZiUDkJKmYOSSkqtlZJSzJyT0kFIqYOOSkkptpJKTKGU1kpK' + -'sYVSWmwx1pxSbDWU0lpJKcaSSmwtxlpbTLV1EFoLpbQWSmmttVZraq3GUEprJaUYS0qxtRZrbjHm' + -'GkppraQSW0mpxRZbji3GmlNrNabWam4x5hpbbT3WmnNKrdbUUo0txppjbb3VmnvvIKQWSmktlNJi' + -'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' + -'m2L/kruPM6Q7oz4tvDQy+bZ3HzOi+gNHA4DZEgA=' -); - -lib.resource.add('hterm/images/icon-96', 'image/png;base64', -'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' + -'ODoyNC0wNDowMNba8BsAAAAASUVORK5CYII=' -); - -lib.resource.add('hterm/concat/date', 'text/plain', -'Sun, 11 Mar 2018 12:57:12 +0000' -); - -lib.resource.add('hterm/changelog/version', 'text/plain', -'1.78' -); - -lib.resource.add('hterm/changelog/date', 'text/plain', -'2018-01-29' -); - -lib.resource.add('hterm/git/HEAD', 'text/plain', -'7a7207d729703081e78404427ff929703800f703' -); - - -// This file was generated by libdot/bin/concat.sh. -// It has been marked read-only for your safety. Rather -// than edit it directly, please modify one of these source -// files... -// -// hterm/js/hterm.js -// hterm/js/hterm_frame.js -// hterm/js/hterm_keyboard.js -// hterm/js/hterm_keyboard_bindings.js -// hterm/js/hterm_keyboard_keymap.js -// hterm/js/hterm_keyboard_keypattern.js -// hterm/js/hterm_options.js -// hterm/js/hterm_parser.js -// hterm/js/hterm_parser_identifiers.js -// hterm/js/hterm_preference_manager.js -// hterm/js/hterm_pubsub.js -// hterm/js/hterm_screen.js -// hterm/js/hterm_scrollport.js -// hterm/js/hterm_terminal.js -// hterm/js/hterm_terminal_io.js -// hterm/js/hterm_text_attributes.js -// hterm/js/hterm_vt.js -// hterm/js/hterm_vt_character_map.js -// - -// SOURCE FILE: hterm/js/hterm.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.Storage'); - -/** - * @fileoverview Declares the hterm.* namespace and some basic shared utilities - * that are too small to deserve dedicated files. - */ -var hterm = {}; - -/** - * The type of window hosting hterm. - * - * This is set as part of hterm.init(). The value is invalid until - * initialization completes. - */ -hterm.windowType = null; - -/** - * The OS we're running under. - * - * Used when setting up OS-specific behaviors. - * - * This is set as part of hterm.init(). The value is invalid until - * initialization completes. - */ -hterm.os = null; - -/** - * Warning message to display in the terminal when browser zoom is enabled. - * - * You can replace it with your own localized message. - */ -hterm.zoomWarningMessage = 'ZOOM != 100%'; - -/** - * Brief overlay message displayed when text is copied to the clipboard. - * - * By default it is the unicode BLACK SCISSORS character, but you can - * replace it with your own localized message. - * - * This is only displayed when the 'enable-clipboard-notice' preference - * is enabled. - */ -hterm.notifyCopyMessage = '\u2702'; - - -/** - * Text shown in a desktop notification for the terminal - * bell. \u226a is a unicode EIGHTH NOTE, %(title) will - * be replaced by the terminal title. - */ -hterm.desktopNotificationTitle = '\u266A %(title) \u266A'; - -/** - * List of known hterm test suites. - * - * A test harness should ensure that they all exist before running. - */ -hterm.testDeps = ['hterm.ScrollPort.Tests', 'hterm.Screen.Tests', - 'hterm.Terminal.Tests', 'hterm.VT.Tests', - 'hterm.VT.CannedTests']; - -/** - * The hterm init function, registered with lib.registerInit(). - * - * This is called during lib.init(). - * - * @param {function} onInit The function lib.init() wants us to invoke when - * initialization is complete. - */ -lib.registerInit('hterm', function(onInit) { - function initOs(os) { - hterm.os = os; - - onInit(); - } - - function initMessageManager() { - lib.f.getAcceptLanguages((languages) => { - if (!hterm.messageManager) - hterm.messageManager = new lib.MessageManager(languages); - - // If OS detection fails, then we'll still set the value to something. - // The OS logic in hterm tends to be best effort anyways. - lib.f.getOs().then(initOs).catch(initOs); - }); - } - - function onWindow(window) { - hterm.windowType = window.type; - initMessageManager(); - } - - function onTab(tab) { - if (tab && window.chrome) { - chrome.windows.get(tab.windowId, null, onWindow); - } else { - // TODO(rginda): This is where we end up for a v1 app's background page. - // Maybe windowType = 'none' would be more appropriate, or something. - hterm.windowType = 'normal'; - initMessageManager(); - } - } - - if (!hterm.defaultStorage) { - if (window.chrome && chrome.storage && chrome.storage.sync) { - hterm.defaultStorage = new lib.Storage.Chrome(chrome.storage.sync); - } else { - hterm.defaultStorage = new lib.Storage.Local(); - } - } - - // The chrome.tabs API is not supported in packaged apps, and detecting if - // you're a packaged app is a little awkward. - var isPackagedApp = false; - if (window.chrome && chrome.runtime && chrome.runtime.getManifest) { - var manifest = chrome.runtime.getManifest(); - isPackagedApp = manifest.app && manifest.app.background; - } - - if (isPackagedApp) { - // Packaged apps are never displayed in browser tabs. - setTimeout(onWindow.bind(null, {type: 'popup'}), 0); - } else { - if (window.chrome && chrome.tabs) { - // The getCurrent method gets the tab that is "currently running", not the - // topmost or focused tab. - chrome.tabs.getCurrent(onTab); - } else { - setTimeout(onWindow.bind(null, {type: 'normal'}), 0); - } - } -}); - -/** - * Return decimal { width, height } for a given dom node. - */ -hterm.getClientSize = function(dom) { - return dom.getBoundingClientRect(); -}; - -/** - * Return decimal width for a given dom node. - */ -hterm.getClientWidth = function(dom) { - return dom.getBoundingClientRect().width; -}; - -/** - * Return decimal height for a given dom node. - */ -hterm.getClientHeight = function(dom) { - return dom.getBoundingClientRect().height; -}; - -/** - * Copy the current selection to the system clipboard. - * - * @param {HTMLDocument} The document with the selection to copy. - */ -hterm.copySelectionToClipboard = function(document) { - try { - document.execCommand('copy'); - } catch (firefoxException) { - // Ignore this. FF throws an exception if there was an error, even though - // the spec says just return false. - } -}; - -/** - * Paste the system clipboard into the element with focus. - * - * Note: In Chrome/Firefox app/extension environments, you'll need the - * "clipboardRead" permission. In other environments, this might always - * fail as the browser frequently blocks access for security reasons. - * - * @param {HTMLDocument} The document to paste into. - * @return {boolean} True if the paste succeeded. - */ -hterm.pasteFromClipboard = function(document) { - try { - return document.execCommand('paste'); - } catch (firefoxException) { - // Ignore this. FF 40 and older would incorrectly throw an exception if - // there was an error instead of returning false. - return false; - } -}; - -/** - * Return a formatted message in the current locale. - * - * @param {string} name The name of the message to return. - * @param {Array=} args The message arguments, if required. - * @param {string=} string The default message text. - * @return {string} The localized message. - */ -hterm.msg = function(name, args = [], string) { - return hterm.messageManager.get('HTERM_' + name, args, string); -}; - -/** - * Create a new notification. - * - * @param {Object} params Various parameters for the notification. - * @param {string} params.title The title (defaults to the window's title). - * @param {string} params.body The message body (main text). - */ -hterm.notify = function(params) { - var def = (curr, fallback) => curr !== undefined ? curr : fallback; - if (params === undefined || params === null) - params = {}; - - // Merge the user's choices with the default settings. We don't take it - // directly in case it was stuffed with excess junk. - var options = { - 'body': params.body, - 'icon': def(params.icon, lib.resource.getDataUrl('hterm/images/icon-96')), - } - - var title = def(params.title, window.document.title); - if (!title) - title = 'hterm'; - title = lib.f.replaceVars(hterm.desktopNotificationTitle, {'title': title}); - - var n = new Notification(title, options); - n.onclick = function() { - window.focus(); - this.close(); - }; - return n; -}; - -/** - * Launches url in a new tab. - * - * @param {string} url URL to launch in a new tab. - */ -hterm.openUrl = function(url) { - if (window.chrome && chrome.browser && chrome.browser.openTab) { - // For Chrome v2 apps, we need to use this API to properly open windows. - chrome.browser.openTab({'url': url}); - } else { - const win = window.open(url, '_blank'); - win.focus(); - } -} - -/** - * Constructor for a hterm.Size record. - * - * Instances of this class have public read/write members for width and height. - * - * @param {integer} width The width of this record. - * @param {integer} height The height of this record. - */ -hterm.Size = function(width, height) { - this.width = width; - this.height = height; -}; - -/** - * Adjust the width and height of this record. - * - * @param {integer} width The new width of this record. - * @param {integer} height The new height of this record. - */ -hterm.Size.prototype.resize = function(width, height) { - this.width = width; - this.height = height; -}; - -/** - * Return a copy of this record. - * - * @return {hterm.Size} A new hterm.Size instance with the same width and - * height. - */ -hterm.Size.prototype.clone = function() { - return new hterm.Size(this.width, this.height); -}; - -/** - * Set the height and width of this instance based on another hterm.Size. - * - * @param {hterm.Size} that The object to copy from. - */ -hterm.Size.prototype.setTo = function(that) { - this.width = that.width; - this.height = that.height; -}; - -/** - * Test if another hterm.Size instance is equal to this one. - * - * @param {hterm.Size} that The other hterm.Size instance. - * @return {boolean} True if both instances have the same width/height, false - * otherwise. - */ -hterm.Size.prototype.equals = function(that) { - return this.width == that.width && this.height == that.height; -}; - -/** - * Return a string representation of this instance. - * - * @return {string} A string that identifies the width and height of this - * instance. - */ -hterm.Size.prototype.toString = function() { - return '[hterm.Size: ' + this.width + ', ' + this.height + ']'; -}; - -/** - * Constructor for a hterm.RowCol record. - * - * Instances of this class have public read/write members for row and column. - * - * This class includes an 'overflow' bit which is use to indicate that an - * attempt has been made to move the cursor column passed the end of the - * screen. When this happens we leave the cursor column set to the last column - * of the screen but set the overflow bit. In this state cursor movement - * happens normally, but any attempt to print new characters causes a cr/lf - * first. - * - * @param {integer} row The row of this record. - * @param {integer} column The column of this record. - * @param {boolean} opt_overflow Optional boolean indicating that the RowCol - * has overflowed. - */ -hterm.RowCol = function(row, column, opt_overflow) { - this.row = row; - this.column = column; - this.overflow = !!opt_overflow; -}; - -/** - * Adjust the row and column of this record. - * - * @param {integer} row The new row of this record. - * @param {integer} column The new column of this record. - * @param {boolean} opt_overflow Optional boolean indicating that the RowCol - * has overflowed. - */ -hterm.RowCol.prototype.move = function(row, column, opt_overflow) { - this.row = row; - this.column = column; - this.overflow = !!opt_overflow; -}; - -/** - * Return a copy of this record. - * - * @return {hterm.RowCol} A new hterm.RowCol instance with the same row and - * column. - */ -hterm.RowCol.prototype.clone = function() { - return new hterm.RowCol(this.row, this.column, this.overflow); -}; - -/** - * Set the row and column of this instance based on another hterm.RowCol. - * - * @param {hterm.RowCol} that The object to copy from. - */ -hterm.RowCol.prototype.setTo = function(that) { - this.row = that.row; - this.column = that.column; - this.overflow = that.overflow; -}; - -/** - * Test if another hterm.RowCol instance is equal to this one. - * - * @param {hterm.RowCol} that The other hterm.RowCol instance. - * @return {boolean} True if both instances have the same row/column, false - * otherwise. - */ -hterm.RowCol.prototype.equals = function(that) { - return (this.row == that.row && this.column == that.column && - this.overflow == that.overflow); -}; - -/** - * Return a string representation of this instance. - * - * @return {string} A string that identifies the row and column of this - * instance. - */ -hterm.RowCol.prototype.toString = function() { - return ('[hterm.RowCol: ' + this.row + ', ' + this.column + ', ' + - this.overflow + ']'); -}; -// SOURCE FILE: hterm/js/hterm_frame.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.f'); - -/** - * First draft of the interface between the terminal and a third party dialog. - * - * This is rough. It's just the terminal->dialog layer. To complete things - * we'll also need a command->terminal layer. That will have to facilitate - * command->terminal->dialog or direct command->dialog communication. - * - * I imagine this class will change significantly when that happens. - */ - -/** - * Construct a new frame for the given terminal. - * - * @param terminal {hterm.Terminal} The parent terminal object. - * @param url {String} The url to load in the frame. - * @param opt_options {Object} Optional options for the frame. Not implemented. - */ -hterm.Frame = function(terminal, url, opt_options) { - this.terminal_ = terminal; - this.div_ = terminal.div_; - this.url = url; - this.options = opt_options || {}; - this.iframe_ = null; - this.container_ = null; - this.messageChannel_ = null; -}; - -/** - * Handle messages from the iframe. - */ -hterm.Frame.prototype.onMessage_ = function(e) { - switch (e.data.name) { - case 'ipc-init-ok': - // We get this response after we send them ipc-init and they finish. - this.sendTerminalInfo_(); - return; - case 'terminal-info-ok': - // We get this response after we send them terminal-info and they finish. - // Show the finished frame, and then rebind our message handler to the - // callback below. - this.container_.style.display = 'flex'; - this.postMessage('visible'); - this.messageChannel_.port1.onmessage = this.onMessage.bind(this); - this.onLoad(); - return; - default: - console.log('Unknown message from frame:', e.data); - return; - } -}; - -/** - * Clients could override this, I guess. - * - * It doesn't support multiple listeners, but I'm not sure that would make sense - * here. It's probably better to speak directly to our parents. - */ -hterm.Frame.prototype.onMessage = function() {}; - -/** - * Handle iframe onLoad event. - */ -hterm.Frame.prototype.onLoad_ = function() { - this.messageChannel_ = new MessageChannel(); - this.messageChannel_.port1.onmessage = this.onMessage_.bind(this); - this.messageChannel_.port1.start(); - this.iframe_.contentWindow.postMessage( - {name: 'ipc-init', argv: [{messagePort: this.messageChannel_.port2}]}, - this.url, [this.messageChannel_.port2]); -}; - -/** - * Clients may override this. - */ -hterm.Frame.prototype.onLoad = function() {}; - -/** - * Sends the terminal-info message to the iframe. - */ -hterm.Frame.prototype.sendTerminalInfo_ = function() { - lib.f.getAcceptLanguages(function(languages) { - this.postMessage('terminal-info', [{ - acceptLanguages: languages, - foregroundColor: this.terminal_.getForegroundColor(), - backgroundColor: this.terminal_.getBackgroundColor(), - cursorColor: this.terminal_.getCursorColor(), - fontSize: this.terminal_.getFontSize(), - fontFamily: this.terminal_.getFontFamily(), - baseURL: lib.f.getURL('/') - }] - ); - }.bind(this)); -}; - -/** - * User clicked the close button on the frame decoration. - */ -hterm.Frame.prototype.onCloseClicked_ = function() { - this.close(); -}; - -/** - * Close this frame. - */ -hterm.Frame.prototype.close = function() { - if (!this.container_ || !this.container_.parentNode) - return; - - this.container_.parentNode.removeChild(this.container_); - this.onClose(); -}; - - -/** - * Clients may override this. - */ -hterm.Frame.prototype.onClose = function() {}; - -/** - * Send a message to the iframe. - */ -hterm.Frame.prototype.postMessage = function(name, argv) { - if (!this.messageChannel_) - throw new Error('Message channel is not set up.'); - - this.messageChannel_.port1.postMessage({name: name, argv: argv}); -}; - -/** - * Show the UI for this frame. - * - * The iframe src is not loaded until this method is called. - */ -hterm.Frame.prototype.show = function() { - var self = this; - - function opt(name, defaultValue) { - if (name in self.options) - return self.options[name]; - - return defaultValue; - } - - var self = this; - - if (this.container_ && this.container_.parentNode) { - console.error('Frame already visible'); - return; - } - - var headerHeight = '16px'; - - var divSize = hterm.getClientSize(this.div_); - - var width = opt('width', 640); - var height = opt('height', 480); - var left = (divSize.width - width) / 2; - var top = (divSize.height - height) / 2; - - var document = this.terminal_.document_; - - var container = this.container_ = document.createElement('div'); - container.style.cssText = ( - 'position: absolute;' + - 'display: none;' + - 'flex-direction: column;' + - 'top: 10%;' + - 'left: 4%;' + - 'width: 90%;' + - 'height: 80%;' + - 'min-height: 20%;' + - 'max-height: 80%;' + - 'box-shadow: 0 0 2px ' + this.terminal_.getForegroundColor() + ';' + - 'border: 2px ' + this.terminal_.getForegroundColor() + ' solid;'); - - if (false) { - // No use for the close button, so no use for the window header either. - var header = document.createElement('div'); - header.style.cssText = ( - 'display: flex;' + - 'justify-content: flex-end;' + - 'height: ' + headerHeight + ';' + - 'background-color: ' + this.terminal_.getForegroundColor() + ';' + - 'color: ' + this.terminal_.getBackgroundColor() + ';' + - 'font-size: 16px;' + - 'font-family: ' + this.terminal_.getFontFamily()); - container.appendChild(header); - - var button = document.createElement('div'); - button.setAttribute('role', 'button'); - button.style.cssText = ( - 'margin-top: -3px;' + - 'margin-right: 3px;' + - 'cursor: pointer;'); - button.textContent = '\u2a2f'; - button.addEventListener('click', this.onCloseClicked_.bind(this)); - header.appendChild(button); - } - - var iframe = this.iframe_ = document.createElement('iframe'); - iframe.onload = this.onLoad_.bind(this); - iframe.style.cssText = ( - 'display: flex;' + - 'flex: 1;' + - 'width: 100%'); - iframe.setAttribute('src', this.url); - iframe.setAttribute('seamless', true); - container.appendChild(iframe); - - this.div_.appendChild(container); -}; -// SOURCE FILE: hterm/js/hterm_keyboard.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('hterm.Keyboard.KeyMap'); - -/** - * Keyboard handler. - * - * Consumes onKey* events and invokes onVTKeystroke on the associated - * hterm.Terminal object. - * - * See also: [XTERM] as referenced in vt.js. - * - * @param {hterm.Terminal} The Terminal object associated with this keyboard. - */ -hterm.Keyboard = function(terminal) { - // The parent vt interpreter. - this.terminal = terminal; - - // The element we're currently capturing keyboard events for. - this.keyboardElement_ = null; - - // The event handlers we are interested in, and their bound callbacks, saved - // so they can be uninstalled with removeEventListener, when required. - this.handlers_ = [ - ['focusout', this.onFocusOut_.bind(this)], - ['keydown', this.onKeyDown_.bind(this)], - ['keypress', this.onKeyPress_.bind(this)], - ['keyup', this.onKeyUp_.bind(this)], - ['textInput', this.onTextInput_.bind(this)] - ]; - - /** - * The current key map. - */ - this.keyMap = new hterm.Keyboard.KeyMap(this); - - this.bindings = new hterm.Keyboard.Bindings(this); - - /** - * none: Disable any AltGr related munging. - * ctrl-alt: Assume Ctrl+Alt means AltGr. - * left-alt: Assume left Alt means AltGr. - * right-alt: Assume right Alt means AltGr. - */ - this.altGrMode = 'none'; - - /** - * If true, Shift-Insert will fall through to the browser as a paste. - * If false, the keystroke will be sent to the host. - */ - this.shiftInsertPaste = true; - - /** - * If true, home/end will control the terminal scrollbar and shift home/end - * will send the VT keycodes. If false then home/end sends VT codes and - * shift home/end scrolls. - */ - this.homeKeysScroll = false; - - /** - * Same as above, except for page up/page down. - */ - this.pageKeysScroll = false; - - /** - * If true, Ctrl-Plus/Minus/Zero controls zoom. - * If false, Ctrl-Shift-Plus/Minus/Zero controls zoom, Ctrl-Minus sends ^_, - * Ctrl-Plus/Zero do nothing. - */ - this.ctrlPlusMinusZeroZoom = true; - - /** - * Ctrl+C copies if true, sends ^C to host if false. - * Ctrl+Shift+C sends ^C to host if true, copies if false. - */ - this.ctrlCCopy = false; - - /** - * Ctrl+V pastes if true, sends ^V to host if false. - * Ctrl+Shift+V sends ^V to host if true, pastes if false. - */ - this.ctrlVPaste = false; - - /** - * Enable/disable application keypad. - * - * This changes the way numeric keys are sent from the keyboard. - */ - this.applicationKeypad = false; - - /** - * Enable/disable the application cursor mode. - * - * This changes the way cursor keys are sent from the keyboard. - */ - this.applicationCursor = false; - - /** - * If true, the backspace should send BS ('\x08', aka ^H). Otherwise - * the backspace key should send '\x7f'. - */ - this.backspaceSendsBackspace = false; - - /** - * The encoding method for data sent to the host. - */ - this.characterEncoding = 'utf-8'; - - /** - * Set whether the meta key sends a leading escape or not. - */ - this.metaSendsEscape = true; - - /** - * Set whether meta-V gets passed to host. - */ - this.passMetaV = true; - - /** - * Controls how the alt key is handled. - * - * escape....... Send an ESC prefix. - * 8-bit........ Add 128 to the unshifted character as in xterm. - * browser-key.. Wait for the keypress event and see what the browser says. - * (This won't work well on platforms where the browser - * performs a default action for some alt sequences.) - * - * This setting only matters when alt is distinct from meta (altIsMeta is - * false.) - */ - this.altSendsWhat = 'escape'; - - /** - * Set whether the alt key acts as a meta key, instead of producing 8-bit - * characters. - * - * True to enable, false to disable, null to autodetect based on platform. - */ - this.altIsMeta = false; - - /** - * If true, tries to detect DEL key events that are from alt-backspace on - * Chrome OS vs from a true DEL key press. - * - * Background: At the time of writing, on Chrome OS, alt-backspace is mapped - * to DEL. Some users may be happy with this, but others may be frustrated - * that it's impossible to do meta-backspace. If the user enables this pref, - * we use a trick to tell a true DEL keypress from alt-backspace: on - * alt-backspace, we will see the alt key go down, then get a DEL keystroke - * that indicates that alt is not pressed. See https://crbug.com/174410 . - */ - this.altBackspaceIsMetaBackspace = false; - - /** - * Used to keep track of the current alt-key state, which is necessary for - * the altBackspaceIsMetaBackspace preference above and for the altGrMode - * preference. This is a bitmap with where bit positions correspond to the - * "location" property of the key event. - */ - this.altKeyPressed = 0; - - /** - * If true, Chrome OS media keys will be mapped to their F-key equivalent. - * E.g. "Back" will be mapped to F1. If false, Chrome will handle the keys. - */ - this.mediaKeysAreFKeys = false; - - /** - * Holds the previous setting of altSendsWhat when DECSET 1039 is used. When - * DECRST 1039 is used, altSendsWhat is changed back to this and this is - * nulled out. - */ - this.previousAltSendsWhat_ = null; -}; - -/** - * Special handling for keyCodes in a keyboard layout. - */ -hterm.Keyboard.KeyActions = { - /** - * Call preventDefault and stopPropagation for this key event and nothing - * else. - */ - CANCEL: lib.f.createEnum('CANCEL'), - - /** - * This performs the default terminal action for the key. If used in the - * 'normal' action and the the keystroke represents a printable key, the - * character will be sent to the host. If used in one of the modifier - * actions, the terminal will perform the normal action after (possibly) - * altering it. - * - * - If the normal sequence starts with CSI, the sequence will be adjusted - * to include the modifier parameter as described in [XTERM] in the final - * table of the "PC-Style Function Keys" section. - * - * - If the control key is down and the key represents a printable character, - * and the uppercase version of the unshifted keycap is between - * 64 (ASCII '@') and 95 (ASCII '_'), then the uppercase version of the - * unshifted keycap minus 64 is sent. This makes '^@' send '\x00' and - * '^_' send '\x1f'. (Note that one higher that 0x1f is 0x20, which is - * the first printable ASCII value.) - * - * - If the alt key is down and the key represents a printable character then - * the value of the character is shifted up by 128. - * - * - If meta is down and configured to send an escape, '\x1b' will be sent - * before the normal action is performed. - */ - DEFAULT: lib.f.createEnum('DEFAULT'), - - /** - * Causes the terminal to opt out of handling the key event, instead letting - * the browser deal with it. - */ - PASS: lib.f.createEnum('PASS'), - - /** - * Insert the first or second character of the keyCap, based on e.shiftKey. - * The key will be handled in onKeyDown, and e.preventDefault() will be - * called. - * - * It is useful for a modified key action, where it essentially strips the - * modifier while preventing the browser from reacting to the key. - */ - STRIP: lib.f.createEnum('STRIP') -}; - -/** - * Encode a string according to the 'send-encoding' preference. - */ -hterm.Keyboard.prototype.encode = function(str) { - if (this.characterEncoding == 'utf-8') - return this.terminal.vt.encodeUTF8(str); - - return str; -}; - -/** - * Capture keyboard events sent to the associated element. - * - * This enables the keyboard. Captured events are consumed by this class - * and will not perform their default action or bubble to other elements. - * - * Passing a null element will uninstall the keyboard handlers. - * - * @param {HTMLElement} element The element whose events should be captured, or - * null to disable the keyboard. - */ -hterm.Keyboard.prototype.installKeyboard = function(element) { - if (element == this.keyboardElement_) - return; - - if (element && this.keyboardElement_) - this.installKeyboard(null); - - for (var i = 0; i < this.handlers_.length; i++) { - var handler = this.handlers_[i]; - if (element) { - element.addEventListener(handler[0], handler[1]); - } else { - this.keyboardElement_.removeEventListener(handler[0], handler[1]); - } - } - - this.keyboardElement_ = element; -}; - -/** - * Disable keyboard event capture. - * - * This will allow the browser to process key events normally. - */ -hterm.Keyboard.prototype.uninstallKeyboard = function() { - this.installKeyboard(null); -}; - -/** - * Handle onTextInput events. - * - * These are generated when using IMEs, Virtual Keyboards (VKs), compose keys, - * Unicode input, etc... - */ -hterm.Keyboard.prototype.onTextInput_ = function(e) { - if (!e.data) - return; - - // Just pass the generated buffer straight down. No need for us to split it - // up or otherwise parse it ahead of times. - this.terminal.onVTKeystroke(e.data); -}; - -/** - * Handle onKeyPress events. - */ -hterm.Keyboard.prototype.onKeyPress_ = function(e) { - var code; - - var key = String.fromCharCode(e.which); - var lowerKey = key.toLowerCase(); - if ((e.ctrlKey || e.metaKey) && (lowerKey == 'c' || lowerKey == 'v')) { - // On FF the key press (not key down) event gets fired for copy/paste. - // Let it fall through for the default browser behavior. - return; - } - - if (e.altKey && this.altSendsWhat == 'browser-key' && e.charCode == 0) { - // If we got here because we were expecting the browser to handle an - // alt sequence but it didn't do it, then we might be on an OS without - // an enabled IME system. In that case we fall back to xterm-like - // behavior. - // - // This happens here only as a fallback. Typically these platforms should - // set altSendsWhat to either 'escape' or '8-bit'. - var ch = String.fromCharCode(e.keyCode); - if (!e.shiftKey) - ch = ch.toLowerCase(); - code = ch.charCodeAt(0) + 128; - - } else if (e.charCode >= 32) { - ch = e.charCode; - } - - if (ch) - this.terminal.onVTKeystroke(String.fromCharCode(ch)); - - e.preventDefault(); - e.stopPropagation(); -}; - -/** - * Prevent default handling for non-ctrl-shifted event. - * - * When combined with Chrome permission 'app.window.fullscreen.overrideEsc', - * and called for both key down and key up events, - * the ESC key remains usable within fullscreen Chrome app windows. - */ -hterm.Keyboard.prototype.preventChromeAppNonCtrlShiftDefault_ = function(e) { - if (!window.chrome || !window.chrome.app || !window.chrome.app.window) - return; - if (!e.ctrlKey || !e.shiftKey) - e.preventDefault(); -}; - -hterm.Keyboard.prototype.onFocusOut_ = function(e) { - this.altKeyPressed = 0; -}; - -hterm.Keyboard.prototype.onKeyUp_ = function(e) { - if (e.keyCode == 18) - this.altKeyPressed = this.altKeyPressed & ~(1 << (e.location - 1)); - - if (e.keyCode == 27) - this.preventChromeAppNonCtrlShiftDefault_(e); -}; - -/** - * Handle onKeyDown events. - */ -hterm.Keyboard.prototype.onKeyDown_ = function(e) { - if (e.keyCode == 18) - this.altKeyPressed = this.altKeyPressed | (1 << (e.location - 1)); - - if (e.keyCode == 27) - this.preventChromeAppNonCtrlShiftDefault_(e); - - var keyDef = this.keyMap.keyDefs[e.keyCode]; - if (!keyDef) { - // If this key hasn't been explicitly registered, fall back to the unknown - // key mapping (keyCode == 0), and then automatically register it to avoid - // any further warnings here. - console.warn(`No definition for key ${e.key} (keyCode ${e.keyCode})`); - keyDef = this.keyMap.keyDefs[0]; - this.keyMap.addKeyDef(e.keyCode, keyDef); - } - - // The type of action we're going to use. - var resolvedActionType = null; - - var self = this; - function getAction(name) { - // Get the key action for the given action name. If the action is a - // function, dispatch it. If the action defers to the normal action, - // resolve that instead. - - resolvedActionType = name; - - var action = keyDef[name]; - if (typeof action == 'function') - action = action.apply(self.keyMap, [e, keyDef]); - - if (action === DEFAULT && name != 'normal') - action = getAction('normal'); - - return action; - } - - // Note that we use the triple-equals ('===') operator to test equality for - // these constants, in order to distinguish usage of the constant from usage - // of a literal string that happens to contain the same bytes. - var CANCEL = hterm.Keyboard.KeyActions.CANCEL; - var DEFAULT = hterm.Keyboard.KeyActions.DEFAULT; - var PASS = hterm.Keyboard.KeyActions.PASS; - var STRIP = hterm.Keyboard.KeyActions.STRIP; - - var control = e.ctrlKey; - var alt = this.altIsMeta ? false : e.altKey; - var meta = this.altIsMeta ? (e.altKey || e.metaKey) : e.metaKey; - - // In the key-map, we surround the keyCap for non-printables in "[...]" - var isPrintable = !(/^\[\w+\]$/.test(keyDef.keyCap)); - - switch (this.altGrMode) { - case 'ctrl-alt': - if (isPrintable && control && alt) { - // ctrl-alt-printable means altGr. We clear out the control and - // alt modifiers and wait to see the charCode in the keydown event. - control = false; - alt = false; - } - break; - - case 'right-alt': - if (isPrintable && (this.terminal.keyboard.altKeyPressed & 2)) { - control = false; - alt = false; - } - break; - - case 'left-alt': - if (isPrintable && (this.terminal.keyboard.altKeyPressed & 1)) { - control = false; - alt = false; - } - break; - } - - var action; - - if (control) { - action = getAction('control'); - } else if (alt) { - action = getAction('alt'); - } else if (meta) { - action = getAction('meta'); - } else { - action = getAction('normal'); - } - - // If e.maskShiftKey was set (during getAction) it means the shift key is - // already accounted for in the action, and we should not act on it any - // further. This is currently only used for Ctrl-Shift-Tab, which should send - // "CSI Z", not "CSI 1 ; 2 Z". - var shift = !e.maskShiftKey && e.shiftKey; - - var keyDown = { - keyCode: e.keyCode, - shift: e.shiftKey, // not `var shift` from above. - ctrl: control, - alt: alt, - meta: meta - }; - - var binding = this.bindings.getBinding(keyDown); - - if (binding) { - // Clear out the modifier bits so we don't try to munge the sequence - // further. - shift = control = alt = meta = false; - resolvedActionType = 'normal'; - action = binding.action; - - if (typeof action == 'function') - action = action.call(this, this.terminal, keyDown); - } - - if (alt && this.altSendsWhat == 'browser-key' && action == DEFAULT) { - // When altSendsWhat is 'browser-key', we wait for the keypress event. - // In keypress, the browser should have set the event.charCode to the - // appropriate character. - // TODO(rginda): Character compositions will need some black magic. - action = PASS; - } - - if (action === PASS || (action === DEFAULT && !(control || alt || meta))) { - // If this key is supposed to be handled by the browser, or it is an - // unmodified key with the default action, then exit this event handler. - // If it's an unmodified key, it'll be handled in onKeyPress where we - // can tell for sure which ASCII code to insert. - // - // This block needs to come before the STRIP test, otherwise we'll strip - // the modifier and think it's ok to let the browser handle the keypress. - // The browser won't know we're trying to ignore the modifiers and might - // perform some default action. - return; - } - - if (action === STRIP) { - alt = control = false; - action = keyDef.normal; - if (typeof action == 'function') - action = action.apply(this.keyMap, [e, keyDef]); - - if (action == DEFAULT && keyDef.keyCap.length == 2) - action = keyDef.keyCap.substr((shift ? 1 : 0), 1); - } - - e.preventDefault(); - e.stopPropagation(); - - if (action === CANCEL) - return; - - if (action !== DEFAULT && typeof action != 'string') { - console.warn('Invalid action: ' + JSON.stringify(action)); - return; - } - - // Strip the modifier that is associated with the action, since we assume that - // modifier has already been accounted for in the action. - if (resolvedActionType == 'control') { - control = false; - } else if (resolvedActionType == 'alt') { - alt = false; - } else if (resolvedActionType == 'meta') { - meta = false; - } - - if (action.substr(0, 2) == '\x1b[' && (alt || control || shift || meta)) { - // The action is an escape sequence that and it was triggered in the - // presence of a keyboard modifier, we may need to alter the action to - // include the modifier before sending it. - - // The math is funky but aligns w/xterm. - let imod = 1; - if (shift) - imod += 1; - if (alt) - imod += 2; - if (control) - imod += 4; - if (meta) - imod += 8; - let mod = ';' + imod; - - if (action.length == 3) { - // Some of the CSI sequences have zero parameters unless modified. - action = '\x1b[1' + mod + action.substr(2, 1); - } else { - // Others always have at least one parameter. - action = action.substr(0, action.length - 1) + mod + - action.substr(action.length - 1); - } - - } else { - if (action === DEFAULT) { - action = keyDef.keyCap.substr((shift ? 1 : 0), 1); - - if (control) { - var unshifted = keyDef.keyCap.substr(0, 1); - var code = unshifted.charCodeAt(0); - if (code >= 64 && code <= 95) { - action = String.fromCharCode(code - 64); - } - } - } - - if (alt && this.altSendsWhat == '8-bit' && action.length == 1) { - var code = action.charCodeAt(0) + 128; - action = String.fromCharCode(code); - } - - // We respect alt/metaSendsEscape even if the keymap action was a literal - // string. Otherwise, every overridden alt/meta action would have to - // check alt/metaSendsEscape. - if ((alt && this.altSendsWhat == 'escape') || - (meta && this.metaSendsEscape)) { - action = '\x1b' + action; - } - } - - this.terminal.onVTKeystroke(action); -}; -// SOURCE FILE: hterm/js/hterm_keyboard_bindings.js -// Copyright (c) 2015 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * A mapping from hterm.Keyboard.KeyPattern to an action. - * - * TODO(rginda): For now this bindings code is only used for user overrides. - * hterm.Keyboard.KeyMap still handles all of the built-in key mappings. - * It'd be nice if we migrated that over to be hterm.Keyboard.Bindings based. - */ -hterm.Keyboard.Bindings = function() { - this.bindings_ = {}; -}; - -/** - * Remove all bindings. - */ -hterm.Keyboard.Bindings.prototype.clear = function () { - this.bindings_ = {}; -}; - -/** - * Add a new binding. - * - * Internal API that assumes parsed objects as inputs. - * See the public addBinding for more details. - * - * @param {hterm.Keyboard.KeyPattern} keyPattern - * @param {string|function|hterm.Keyboard.KeyAction} action - */ -hterm.Keyboard.Bindings.prototype.addBinding_ = function(keyPattern, action) { - var binding = null; - var list = this.bindings_[keyPattern.keyCode]; - if (list) { - for (var i = 0; i < list.length; i++) { - if (list[i].keyPattern.matchKeyPattern(keyPattern)) { - binding = list[i]; - break; - } - } - } - - if (binding) { - binding.action = action; - } else { - binding = {keyPattern: keyPattern, action: action}; - - if (!list) { - this.bindings_[keyPattern.keyCode] = [binding]; - } else { - this.bindings_[keyPattern.keyCode].push(binding); - - list.sort(function(a, b) { - return hterm.Keyboard.KeyPattern.sortCompare( - a.keyPattern, b.keyPattern); - }); - } - } -}; - -/** - * Add a new binding. - * - * If a binding for the keyPattern already exists it will be overridden. - * - * More specific keyPatterns take precedence over those with wildcards. Given - * bindings for "Ctrl-A" and "Ctrl-*-A", and a "Ctrl-A" keydown, the "Ctrl-A" - * binding will match even if "Ctrl-*-A" was created last. - * - * If action is a string, it will be passed through hterm.Parser.parseKeyAction. - * - * For example: - * // Will replace Ctrl-P keystrokes with the string "hiya!". - * addBinding('Ctrl-P', "'hiya!'"); - * // Will cancel the keystroke entirely (make it do nothing). - * addBinding('Alt-D', hterm.Keyboard.KeyActions.CANCEL); - * // Will execute the code and return the action. - * addBinding('Ctrl-T', function() { - * console.log('Got a T!'); - * return hterm.Keyboard.KeyActions.PASS; - * }); - * - * @param {string|hterm.Keyboard.KeyPattern} keyPattern - * @param {string|function|hterm.Keyboard.KeyAction} action - */ -hterm.Keyboard.Bindings.prototype.addBinding = function(key, action) { - // If we're given a hterm.Keyboard.KeyPattern object, pass it down. - if (typeof key != 'string') { - this.addBinding_(key, action); - return; - } - - // Here we treat key as a string. - var p = new hterm.Parser(); - - p.reset(key); - var sequence; - - try { - sequence = p.parseKeySequence(); - } catch (ex) { - console.error(ex); - return; - } - - if (!p.isComplete()) { - console.error(p.error('Expected end of sequence: ' + sequence)); - return; - } - - // If action is a string, parse it. Otherwise assume it's callable. - if (typeof action == 'string') { - p.reset(action); - try { - action = p.parseKeyAction(); - } catch (ex) { - console.error(ex); - return; - } - } - - if (!p.isComplete()) { - console.error(p.error('Expected end of sequence: ' + sequence)); - return; - } - - this.addBinding_(new hterm.Keyboard.KeyPattern(sequence), action); -}; - -/** - * Add multiple bindings at a time using a map of {string: string, ...} - * - * This uses hterm.Parser to parse the maps key into KeyPatterns, and the - * map values into {string|function|KeyAction}. - * - * For example: - * { - * // Will replace Ctrl-P keystrokes with the string "hiya!". - * 'Ctrl-P': "'hiya!'", - * // Will cancel the keystroke entirely (make it do nothing). - * 'Alt-D': hterm.Keyboard.KeyActions.CANCEL, - * } - * - * @param {Object} map - */ -hterm.Keyboard.Bindings.prototype.addBindings = function(map) { - for (var key in map) { - this.addBinding(key, map[key]); - } -}; - -/** - * Return the binding that is the best match for the given keyDown record, - * or null if there is no match. - * - * @param {Object} keyDown An object with a keyCode property and zero or - * more boolean properties representing key modifiers. These property names - * must match those defined in hterm.Keyboard.KeyPattern.modifiers. - */ -hterm.Keyboard.Bindings.prototype.getBinding = function(keyDown) { - var list = this.bindings_[keyDown.keyCode]; - if (!list) - return null; - - for (var i = 0; i < list.length; i++) { - var binding = list[i]; - if (binding.keyPattern.matchKeyDown(keyDown)) - return binding; - } - - return null; -}; -// SOURCE FILE: hterm/js/hterm_keyboard_keymap.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('hterm.Keyboard.KeyActions'); - -/** - * The default key map for hterm. - * - * Contains a mapping of keyCodes to keyDefs (aka key definitions). The key - * definition tells the hterm.Keyboard class how to handle keycodes. - * - * This should work for most cases, as the printable characters get handled - * in the keypress event. In that case, even if the keycap is wrong in the - * key map, the correct character should be sent. - * - * Different layouts, such as Dvorak should work with this keymap, as those - * layouts typically move keycodes around on the keyboard without disturbing - * the actual keycaps. - * - * There may be issues with control keys on non-US keyboards or with keyboards - * that very significantly from the expectations here, in which case we may - * have to invent new key maps. - * - * The sequences defined in this key map come from [XTERM] as referenced in - * vt.js, starting with the section titled "Alt and Meta Keys". - */ -hterm.Keyboard.KeyMap = function(keyboard) { - this.keyboard = keyboard; - this.keyDefs = {}; - this.reset(); -}; - -/** - * Add a single key definition. - * - * The definition is a hash containing the following keys: 'keyCap', 'normal', - * 'control', and 'alt'. - * - * - keyCap is a string identifying the key. For printable - * keys, the key cap should be exactly two characters, starting with the - * unshifted version. For example, 'aA', 'bB', '1!' and '=+'. For - * non-printable the key cap should be surrounded in square braces, as in - * '[INS]', '[LEFT]'. By convention, non-printable keycaps are in uppercase - * but this is not a strict requirement. - * - * - Normal is the action that should be performed when they key is pressed - * in the absence of any modifier. See below for the supported actions. - * - * - Control is the action that should be performed when they key is pressed - * along with the control modifier. See below for the supported actions. - * - * - Alt is the action that should be performed when they key is pressed - * along with the alt modifier. See below for the supported actions. - * - * - Meta is the action that should be performed when they key is pressed - * along with the meta modifier. See below for the supported actions. - * - * Actions can be one of the hterm.Keyboard.KeyActions as documented below, - * a literal string, or an array. If the action is a literal string then - * the string is sent directly to the host. If the action is an array it - * is taken to be an escape sequence that may be altered by modifier keys. - * The second-to-last element of the array will be overwritten with the - * state of the modifier keys, as specified in the final table of "PC-Style - * Function Keys" from [XTERM]. - */ -hterm.Keyboard.KeyMap.prototype.addKeyDef = function(keyCode, def) { - if (keyCode in this.keyDefs) - console.warn('Duplicate keyCode: ' + keyCode); - - this.keyDefs[keyCode] = def; -}; - -/** - * Add multiple key definitions in a single call. - * - * This function takes the key definitions as variable argument list. Each - * argument is the key definition specified as an array. - * - * (If the function took everything as one big hash we couldn't detect - * duplicates, and there would be a lot more typing involved.) - * - * Each key definition should have 6 elements: (keyCode, keyCap, normal action, - * control action, alt action and meta action). See KeyMap.addKeyDef for the - * meaning of these elements. - */ -hterm.Keyboard.KeyMap.prototype.addKeyDefs = function(var_args) { - for (var i = 0; i < arguments.length; i++) { - this.addKeyDef(arguments[i][0], - { keyCap: arguments[i][1], - normal: arguments[i][2], - control: arguments[i][3], - alt: arguments[i][4], - meta: arguments[i][5] - }); - } -}; - -/** - * Set up the default state for this keymap. - */ -hterm.Keyboard.KeyMap.prototype.reset = function() { - this.keyDefs = {}; - - var self = this; - - // This function is used by the "macro" functions below. It makes it - // possible to use the call() macro as an argument to any other macro. - function resolve(action, e, k) { - if (typeof action == 'function') - return action.apply(self, [e, k]); - - return action; - } - - // If not application keypad a, else b. The keys that care about - // application keypad ignore it when the key is modified. - function ak(a, b) { - return function(e, k) { - var action = (e.shiftKey || e.ctrlKey || e.altKey || e.metaKey || - !self.keyboard.applicationKeypad) ? a : b; - return resolve(action, e, k); - }; - } - - // If mod or not application cursor a, else b. The keys that care about - // application cursor ignore it when the key is modified. - function ac(a, b) { - return function(e, k) { - var action = (e.shiftKey || e.ctrlKey || e.altKey || e.metaKey || - !self.keyboard.applicationCursor) ? a : b; - return resolve(action, e, k); - }; - } - - // If not backspace-sends-backspace keypad a, else b. - function bs(a, b) { - return function(e, k) { - var action = !self.keyboard.backspaceSendsBackspace ? a : b; - return resolve(action, e, k); - }; - } - - // If not e.shiftKey a, else b. - function sh(a, b) { - return function(e, k) { - var action = !e.shiftKey ? a : b; - e.maskShiftKey = true; - return resolve(action, e, k); - }; - } - - // If not e.altKey a, else b. - function alt(a, b) { - return function(e, k) { - var action = !e.altKey ? a : b; - return resolve(action, e, k); - }; - } - - // If no modifiers a, else b. - function mod(a, b) { - return function(e, k) { - var action = !(e.shiftKey || e.ctrlKey || e.altKey || e.metaKey) ? a : b; - return resolve(action, e, k); - }; - } - - // Compute a control character for a given character. - function ctl(ch) { return String.fromCharCode(ch.charCodeAt(0) - 64) } - - // Call a method on the keymap instance. - function c(m) { return function (e, k) { return this[m](e, k) } } - - // Ignore if not trapping media keys. - function med(fn) { - return function(e, k) { - if (!self.keyboard.mediaKeysAreFKeys) { - // Block Back, Forward, and Reload keys to avoid navigating away from - // the current page. - return (e.keyCode == 166 || e.keyCode == 167 || e.keyCode == 168) ? - hterm.Keyboard.KeyActions.CANCEL : - hterm.Keyboard.KeyActions.PASS; - } - return resolve(fn, e, k); - }; - } - - // Browser-specific differences. - if (window.navigator && navigator.userAgent) { - if (navigator.userAgent.includes('Firefox')) { - // Firefox defines some keys uniquely. No other browser defines these is - // this way. Some even conflict. The keyCode field isn't well documented - // as it isn't standardized. At some point we should switch to "key". - // https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/keyCode - // http://unixpapa.com/js/key.html - var keycapMute = 181; // Mute - var keycapVolDn = 182; // Volume Down - var keycapVolUp = 183; // Volume Up - var keycapSC = 59; // ;: - var keycapEP = 61; // =+ - var keycapMU = 173; // -_ - - this.addKeyDefs( - // Firefox Italian +*. - [171, '+*', DEFAULT, c('onPlusMinusZero_'), DEFAULT, c('onPlusMinusZero_')] - ); - } else { - // All other browsers use these mappings. - var keycapMute = 173; // Mute - var keycapVolDn = 174; // Volume Down - var keycapVolUp = 175; // Volume Up - var keycapSC = 186; // ;: - var keycapEP = 187; // =+ - var keycapMU = 189; // -_ - } - } - - var ESC = '\x1b'; - var CSI = '\x1b['; - var SS3 = '\x1bO'; - - var CANCEL = hterm.Keyboard.KeyActions.CANCEL; - var DEFAULT = hterm.Keyboard.KeyActions.DEFAULT; - var PASS = hterm.Keyboard.KeyActions.PASS; - var STRIP = hterm.Keyboard.KeyActions.STRIP; - - this.addKeyDefs( - // These fields are: [keycode, keycap, normal, control, alt, meta] - - // The browser sends the keycode 0 for some keys. We'll just assume it's - // going to do the right thing by default for those keys. - [0, '[UNKNOWN]', PASS, PASS, PASS, PASS], - - // First row. - [27, '[ESC]', ESC, DEFAULT, DEFAULT, DEFAULT], - [112, '[F1]', mod(SS3 + 'P', CSI + 'P'), DEFAULT, CSI + "23~", DEFAULT], - [113, '[F2]', mod(SS3 + 'Q', CSI + 'Q'), DEFAULT, CSI + "24~", DEFAULT], - [114, '[F3]', mod(SS3 + 'R', CSI + 'R'), DEFAULT, CSI + "25~", DEFAULT], - [115, '[F4]', mod(SS3 + 'S', CSI + 'S'), DEFAULT, CSI + "26~", DEFAULT], - [116, '[F5]', CSI + '15~', DEFAULT, CSI + "28~", DEFAULT], - [117, '[F6]', CSI + '17~', DEFAULT, CSI + "29~", DEFAULT], - [118, '[F7]', CSI + '18~', DEFAULT, CSI + "31~", DEFAULT], - [119, '[F8]', CSI + '19~', DEFAULT, CSI + "32~", DEFAULT], - [120, '[F9]', CSI + '20~', DEFAULT, CSI + "33~", DEFAULT], - [121, '[F10]', CSI + '21~', DEFAULT, CSI + "34~", DEFAULT], - [122, '[F11]', c('onF11_'), DEFAULT, CSI + "42~", DEFAULT], - [123, '[F12]', CSI + '24~', DEFAULT, CSI + "43~", DEFAULT], - - // Second row. - [192, '`~', DEFAULT, sh(ctl('@'), ctl('^')), DEFAULT, PASS], - [49, '1!', DEFAULT, c('onCtrlNum_'), c('onAltNum_'), c('onMetaNum_')], - [50, '2@', DEFAULT, c('onCtrlNum_'), c('onAltNum_'), c('onMetaNum_')], - [51, '3#', DEFAULT, c('onCtrlNum_'), c('onAltNum_'), c('onMetaNum_')], - [52, '4$', DEFAULT, c('onCtrlNum_'), c('onAltNum_'), c('onMetaNum_')], - [53, '5%', DEFAULT, c('onCtrlNum_'), c('onAltNum_'), c('onMetaNum_')], - [54, '6^', DEFAULT, c('onCtrlNum_'), c('onAltNum_'), c('onMetaNum_')], - [55, '7&', DEFAULT, c('onCtrlNum_'), c('onAltNum_'), c('onMetaNum_')], - [56, '8*', DEFAULT, c('onCtrlNum_'), c('onAltNum_'), c('onMetaNum_')], - [57, '9(', DEFAULT, c('onCtrlNum_'), c('onAltNum_'), c('onMetaNum_')], - [48, '0)', DEFAULT, c('onPlusMinusZero_'),c('onAltNum_'),c('onPlusMinusZero_')], - [keycapMU, '-_', DEFAULT, c('onPlusMinusZero_'), DEFAULT, c('onPlusMinusZero_')], - [keycapEP, '=+', DEFAULT, c('onPlusMinusZero_'), DEFAULT, c('onPlusMinusZero_')], - - [8, '[BKSP]', bs('\x7f', '\b'), bs('\b', '\x7f'), DEFAULT, DEFAULT], - - // Third row. - [9, '[TAB]', sh('\t', CSI + 'Z'), STRIP, PASS, DEFAULT], - [81, 'qQ', DEFAULT, ctl('Q'), DEFAULT, DEFAULT], - [87, 'wW', DEFAULT, ctl('W'), DEFAULT, DEFAULT], - [69, 'eE', DEFAULT, ctl('E'), DEFAULT, DEFAULT], - [82, 'rR', DEFAULT, ctl('R'), DEFAULT, DEFAULT], - [84, 'tT', DEFAULT, ctl('T'), DEFAULT, DEFAULT], - [89, 'yY', DEFAULT, ctl('Y'), DEFAULT, DEFAULT], - [85, 'uU', DEFAULT, ctl('U'), DEFAULT, DEFAULT], - [73, 'iI', DEFAULT, ctl('I'), DEFAULT, DEFAULT], - [79, 'oO', DEFAULT, ctl('O'), DEFAULT, DEFAULT], - [80, 'pP', DEFAULT, ctl('P'), DEFAULT, DEFAULT], - [219, '[{', DEFAULT, ctl('['), DEFAULT, DEFAULT], - [221, ']}', DEFAULT, ctl(']'), DEFAULT, DEFAULT], - [220, '\\|', DEFAULT, ctl('\\'), DEFAULT, DEFAULT], - - // Fourth row. (We let Ctrl-Shift-J pass for Chrome DevTools.) - [20, '[CAPS]', PASS, PASS, PASS, DEFAULT], - [65, 'aA', DEFAULT, ctl('A'), DEFAULT, DEFAULT], - [83, 'sS', DEFAULT, ctl('S'), DEFAULT, DEFAULT], - [68, 'dD', DEFAULT, ctl('D'), DEFAULT, DEFAULT], - [70, 'fF', DEFAULT, ctl('F'), DEFAULT, DEFAULT], - [71, 'gG', DEFAULT, ctl('G'), DEFAULT, DEFAULT], - [72, 'hH', DEFAULT, ctl('H'), DEFAULT, DEFAULT], - [74, 'jJ', DEFAULT, sh(ctl('J'), PASS), DEFAULT, DEFAULT], - [75, 'kK', DEFAULT, sh(ctl('K'), c('onClear_')), DEFAULT, DEFAULT], - [76, 'lL', DEFAULT, sh(ctl('L'), PASS), DEFAULT, DEFAULT], - [keycapSC, ';:', DEFAULT, STRIP, DEFAULT, DEFAULT], - [222, '\'"', DEFAULT, STRIP, DEFAULT, DEFAULT], - [13, '[ENTER]', '\r', CANCEL, CANCEL, DEFAULT], - - // Fifth row. This includes the copy/paste shortcuts. On some - // platforms it's Ctrl-C/V, on others it's Meta-C/V. We assume either - // Ctrl-C/Meta-C should pass to the browser when there is a selection, - // and Ctrl-Shift-V/Meta-*-V should always pass to the browser (since - // these seem to be recognized as paste too). - [16, '[SHIFT]', PASS, PASS, PASS, DEFAULT], - [90, 'zZ', DEFAULT, ctl('Z'), DEFAULT, DEFAULT], - [88, 'xX', DEFAULT, ctl('X'), DEFAULT, DEFAULT], - [67, 'cC', DEFAULT, c('onCtrlC_'), DEFAULT, c('onMetaC_')], - [86, 'vV', DEFAULT, c('onCtrlV_'), DEFAULT, c('onMetaV_')], - [66, 'bB', DEFAULT, sh(ctl('B'), PASS), DEFAULT, sh(DEFAULT, PASS)], - [78, 'nN', DEFAULT, c('onCtrlN_'), DEFAULT, c('onMetaN_')], - [77, 'mM', DEFAULT, ctl('M'), DEFAULT, DEFAULT], - [188, ',<', DEFAULT, alt(STRIP, PASS), DEFAULT, DEFAULT], - [190, '.>', DEFAULT, alt(STRIP, PASS), DEFAULT, DEFAULT], - [191, '/?', DEFAULT, sh(ctl('_'), ctl('?')), DEFAULT, DEFAULT], - - // Sixth and final row. - [17, '[CTRL]', PASS, PASS, PASS, PASS], - [18, '[ALT]', PASS, PASS, PASS, PASS], - [91, '[LAPL]', PASS, PASS, PASS, PASS], - [32, ' ', DEFAULT, ctl('@'), DEFAULT, DEFAULT], - [92, '[RAPL]', PASS, PASS, PASS, PASS], - [93, '[RMENU]', PASS, PASS, PASS, PASS], - - // These things. - [42, '[PRTSCR]', PASS, PASS, PASS, PASS], - [145, '[SCRLK]', PASS, PASS, PASS, PASS], - [19, '[BREAK]', PASS, PASS, PASS, PASS], - - // The block of six keys above the arrows. - [45, '[INSERT]', c('onKeyInsert_'), DEFAULT, DEFAULT, DEFAULT], - [36, '[HOME]', c('onKeyHome_'), DEFAULT, DEFAULT, DEFAULT], - [33, '[PGUP]', c('onKeyPageUp_'), DEFAULT, DEFAULT, DEFAULT], - [46, '[DEL]', c('onKeyDel_'), DEFAULT, DEFAULT, DEFAULT], - [35, '[END]', c('onKeyEnd_'), DEFAULT, DEFAULT, DEFAULT], - [34, '[PGDOWN]', c('onKeyPageDown_'), DEFAULT, DEFAULT, DEFAULT], - - // Arrow keys. When unmodified they respect the application cursor state, - // otherwise they always send the CSI codes. - [38, '[UP]', c('onKeyArrowUp_'), DEFAULT, DEFAULT, DEFAULT], - [40, '[DOWN]', c('onKeyArrowDown_'), DEFAULT, DEFAULT, DEFAULT], - [39, '[RIGHT]', ac(CSI + 'C', SS3 + 'C'), DEFAULT, DEFAULT, DEFAULT], - [37, '[LEFT]', ac(CSI + 'D', SS3 + 'D'), DEFAULT, DEFAULT, DEFAULT], - - [144, '[NUMLOCK]', PASS, PASS, PASS, PASS], - - // On Apple keyboards, the NumLock key is a Clear key. It also tends to be - // what KP5 sends when numlock is off. Not clear if we could do anything - // useful with it, so just pass it along. - [12, '[CLEAR]', PASS, PASS, PASS, PASS], - - // With numlock off, the keypad generates the same key codes as the arrows - // and 'block of six' for some keys, and null key codes for the rest. - - // Keypad with numlock on generates unique key codes... - [96, '[KP0]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [97, '[KP1]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [98, '[KP2]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [99, '[KP3]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [100, '[KP4]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [101, '[KP5]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [102, '[KP6]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [103, '[KP7]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [104, '[KP8]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [105, '[KP9]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [107, '[KP+]', DEFAULT, c('onPlusMinusZero_'), DEFAULT, c('onPlusMinusZero_')], - [109, '[KP-]', DEFAULT, c('onPlusMinusZero_'), DEFAULT, c('onPlusMinusZero_')], - [106, '[KP*]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [111, '[KP/]', DEFAULT, DEFAULT, DEFAULT, DEFAULT], - [110, '[KP.]', DEFAULT, DEFAULT, DEFAULT, DEFAULT] - ); - - // OS-specific differences. - if (hterm.os == 'cros') { - this.addKeyDefs( - // Chrome OS keyboard top row. - [166, '[BACK]', med(mod(SS3+'P', CSI+'P')), DEFAULT, CSI+'23~', DEFAULT], - [167, '[FWD]', med(mod(SS3+'Q', CSI+'Q')), DEFAULT, CSI+'24~', DEFAULT], - [168, '[RELOAD]', med(mod(SS3+'R', CSI+'R')), DEFAULT, CSI+'25~', DEFAULT], - [183, '[FSCR]', med(mod(SS3+'S', CSI+'S')), DEFAULT, CSI+'26~', DEFAULT], - [182, '[WINS]', med(CSI + '15~'), DEFAULT, CSI+'28~', DEFAULT], - [216, '[BRIT-]', med(CSI + '17~'), DEFAULT, CSI+'29~', DEFAULT], - [217, '[BRIT+]', med(CSI + '18~'), DEFAULT, CSI+'31~', DEFAULT] - - // 173 [MUTE], 174 [VOL-] and 175 [VOL+] are trapped by the Chrome OS - // window manager, so we'll never see them. Note that 173 is also - // Firefox's -_ keycode. - ); - } -}; - -/** - * Either allow the paste or send a key sequence. - */ -hterm.Keyboard.KeyMap.prototype.onKeyInsert_ = function(e) { - if (this.keyboard.shiftInsertPaste && e.shiftKey) - return hterm.Keyboard.KeyActions.PASS; - - return '\x1b[2~'; -}; - -/** - * Either scroll the scrollback buffer or send a key sequence. - */ -hterm.Keyboard.KeyMap.prototype.onKeyHome_ = function(e) { - if (!this.keyboard.homeKeysScroll ^ e.shiftKey) { - if ((e.altey || e.ctrlKey || e.shiftKey) || - !this.keyboard.applicationCursor) { - return '\x1b[H'; - } - - return '\x1bOH'; - } - - this.keyboard.terminal.scrollHome(); - return hterm.Keyboard.KeyActions.CANCEL; -}; - -/** - * Either scroll the scrollback buffer or send a key sequence. - */ -hterm.Keyboard.KeyMap.prototype.onKeyEnd_ = function(e) { - if (!this.keyboard.homeKeysScroll ^ e.shiftKey) { - if ((e.altKey || e.ctrlKey || e.shiftKey) || - !this.keyboard.applicationCursor) { - return '\x1b[F'; - } - - return '\x1bOF'; - } - - this.keyboard.terminal.scrollEnd(); - return hterm.Keyboard.KeyActions.CANCEL; -}; - -/** - * Either scroll the scrollback buffer or send a key sequence. - */ -hterm.Keyboard.KeyMap.prototype.onKeyPageUp_ = function(e) { - if (!this.keyboard.pageKeysScroll ^ e.shiftKey) - return '\x1b[5~'; - - this.keyboard.terminal.scrollPageUp(); - return hterm.Keyboard.KeyActions.CANCEL; -}; - -/** - * Either send a true DEL, or sub in meta-backspace. - * - * On Chrome OS, if we know the alt key is down, but we get a DEL event that - * claims that the alt key is not pressed, we know the DEL was a synthetic - * one from a user that hit alt-backspace. Based on a user pref, we can sub - * in meta-backspace in this case. - */ -hterm.Keyboard.KeyMap.prototype.onKeyDel_ = function(e) { - if (this.keyboard.altBackspaceIsMetaBackspace && - this.keyboard.altKeyPressed && !e.altKey) - return '\x1b\x7f'; - return '\x1b[3~'; -}; - -/** - * Either scroll the scrollback buffer or send a key sequence. - */ -hterm.Keyboard.KeyMap.prototype.onKeyPageDown_ = function(e) { - if (!this.keyboard.pageKeysScroll ^ e.shiftKey) - return '\x1b[6~'; - - this.keyboard.terminal.scrollPageDown(); - return hterm.Keyboard.KeyActions.CANCEL; -}; - -/** - * Either scroll the scrollback buffer or send a key sequence. - */ -hterm.Keyboard.KeyMap.prototype.onKeyArrowUp_ = function(e) { - if (!this.keyboard.applicationCursor && e.shiftKey) { - this.keyboard.terminal.scrollLineUp(); - return hterm.Keyboard.KeyActions.CANCEL; - } - - return (e.shiftKey || e.ctrlKey || e.altKey || e.metaKey || - !this.keyboard.applicationCursor) ? '\x1b[A' : '\x1bOA'; -}; - -/** - * Either scroll the scrollback buffer or send a key sequence. - */ -hterm.Keyboard.KeyMap.prototype.onKeyArrowDown_ = function(e) { - if (!this.keyboard.applicationCursor && e.shiftKey) { - this.keyboard.terminal.scrollLineDown(); - return hterm.Keyboard.KeyActions.CANCEL; - } - - return (e.shiftKey || e.ctrlKey || e.altKey || e.metaKey || - !this.keyboard.applicationCursor) ? '\x1b[B' : '\x1bOB'; -}; - -/** - * Clear the primary/alternate screens and the scrollback buffer. - */ -hterm.Keyboard.KeyMap.prototype.onClear_ = function(e, keyDef) { - this.keyboard.terminal.wipeContents(); - return hterm.Keyboard.KeyActions.CANCEL; -}; - -/** - * Handle F11 behavior (fullscreen) when not in a window. - * - * It would be nice to use the Fullscreen API, but the UX is slightly different - * a bad way: the Escape key is automatically registered for exiting. If we let - * the browser handle F11 directly though, we still get to capture Escape. - */ -hterm.Keyboard.KeyMap.prototype.onF11_ = function(e, keyDef) { - if (hterm.windowType != 'popup') - return hterm.Keyboard.KeyActions.PASS; - else - return '\x1b[23~'; -}; - -/** - * Either pass Ctrl-1..9 to the browser or send them to the host. - * - * Note that Ctrl-1 and Ctrl-9 don't actually have special sequences mapped - * to them in xterm or gnome-terminal. The range is really Ctrl-2..8, but - * we handle 1..9 since Chrome treats the whole range special. - */ -hterm.Keyboard.KeyMap.prototype.onCtrlNum_ = function(e, keyDef) { - // Compute a control character for a given character. - function ctl(ch) { return String.fromCharCode(ch.charCodeAt(0) - 64) } - - if (this.keyboard.terminal.passCtrlNumber && !e.shiftKey) - return hterm.Keyboard.KeyActions.PASS; - - switch (keyDef.keyCap.substr(0, 1)) { - case '1': return '1'; - case '2': return ctl('@'); - case '3': return ctl('['); - case '4': return ctl('\\'); - case '5': return ctl(']'); - case '6': return ctl('^'); - case '7': return ctl('_'); - case '8': return '\x7f'; - case '9': return '9'; - } -}; - -/** - * Either pass Alt-1..9 to the browser or send them to the host. - */ -hterm.Keyboard.KeyMap.prototype.onAltNum_ = function(e, keyDef) { - if (this.keyboard.terminal.passAltNumber && !e.shiftKey) - return hterm.Keyboard.KeyActions.PASS; - - return hterm.Keyboard.KeyActions.DEFAULT; -}; - -/** - * Either pass Meta-1..9 to the browser or send them to the host. - */ -hterm.Keyboard.KeyMap.prototype.onMetaNum_ = function(e, keyDef) { - if (this.keyboard.terminal.passMetaNumber && !e.shiftKey) - return hterm.Keyboard.KeyActions.PASS; - - return hterm.Keyboard.KeyActions.DEFAULT; -}; - -/** - * Either send a ^C or interpret the keystroke as a copy command. - */ -hterm.Keyboard.KeyMap.prototype.onCtrlC_ = function(e, keyDef) { - var selection = this.keyboard.terminal.getDocument().getSelection(); - - if (!selection.isCollapsed) { - if (this.keyboard.ctrlCCopy && !e.shiftKey) { - // Ctrl-C should copy if there is a selection, send ^C otherwise. - // Perform the copy by letting the browser handle Ctrl-C. On most - // browsers, this is the *only* way to place text on the clipboard from - // the 'drive-by' web. - if (this.keyboard.terminal.clearSelectionAfterCopy) { - setTimeout(selection.collapseToEnd.bind(selection), 50); - } - return hterm.Keyboard.KeyActions.PASS; - } - - if (!this.keyboard.ctrlCCopy && e.shiftKey) { - // Ctrl-Shift-C should copy if there is a selection, send ^C otherwise. - // Perform the copy manually. This only works in situations where - // document.execCommand('copy') is allowed. - if (this.keyboard.terminal.clearSelectionAfterCopy) { - setTimeout(selection.collapseToEnd.bind(selection), 50); - } - this.keyboard.terminal.copySelectionToClipboard(); - return hterm.Keyboard.KeyActions.CANCEL; - } - } - - return '\x03'; -}; - -/** - * Either send a ^N or open a new window to the same location. - */ -hterm.Keyboard.KeyMap.prototype.onCtrlN_ = function(e, keyDef) { - if (e.shiftKey) { - window.open(document.location.href, '', - 'chrome=no,close=yes,resize=yes,scrollbars=yes,' + - 'minimizable=yes,width=' + window.innerWidth + - ',height=' + window.innerHeight); - return hterm.Keyboard.KeyActions.CANCEL; - } - - return '\x0e'; -}; - -/** - * Either send a ^V or issue a paste command. - * - * The default behavior is to paste if the user presses Ctrl-Shift-V, and send - * a ^V if the user presses Ctrl-V. This can be flipped with the - * 'ctrl-v-paste' preference. - * - */ -hterm.Keyboard.KeyMap.prototype.onCtrlV_ = function(e, keyDef) { - if ((!e.shiftKey && this.keyboard.ctrlVPaste) || - (e.shiftKey && !this.keyboard.ctrlVPaste)) { - // We try to do the pasting ourselves as not all browsers/OSs bind Ctrl-V to - // pasting. Notably, on macOS, Ctrl-V/Ctrl-Shift-V do nothing. - // However, this might run into web restrictions, so if it fails, we still - // fallback to the letting the native behavior (hopefully) save us. - if (this.keyboard.terminal.paste()) - return hterm.Keyboard.KeyActions.CANCEL; - else - return hterm.Keyboard.KeyActions.PASS; - } - - return '\x16'; -}; - -/** - * Either the default action or open a new window to the same location. - */ -hterm.Keyboard.KeyMap.prototype.onMetaN_ = function(e, keyDef) { - if (e.shiftKey) { - window.open(document.location.href, '', - 'chrome=no,close=yes,resize=yes,scrollbars=yes,' + - 'minimizable=yes,width=' + window.outerWidth + - ',height=' + window.outerHeight); - return hterm.Keyboard.KeyActions.CANCEL; - } - - return hterm.Keyboard.KeyActions.DEFAULT; -}; - -/** - * Either send a Meta-C or allow the browser to interpret the keystroke as a - * copy command. - * - * If there is no selection, or if the user presses Meta-Shift-C, then we'll - * transmit an '\x1b' (if metaSendsEscape is on) followed by 'c' or 'C'. - * - * If there is a selection, we defer to the browser. In this case we clear out - * the selection so the user knows we heard them, and also to give them a - * chance to send a Meta-C by just hitting the key again. - */ -hterm.Keyboard.KeyMap.prototype.onMetaC_ = function(e, keyDef) { - var document = this.keyboard.terminal.getDocument(); - if (e.shiftKey || document.getSelection().isCollapsed) { - // If the shift key is being held, or there is no document selection, send - // a Meta-C. The keyboard code will add the ESC if metaSendsEscape is true, - // we just have to decide between 'c' and 'C'. - return keyDef.keyCap.substr(e.shiftKey ? 1 : 0, 1); - } - - // Otherwise let the browser handle it as a copy command. - if (this.keyboard.terminal.clearSelectionAfterCopy) { - setTimeout(function() { document.getSelection().collapseToEnd() }, 50); - } - return hterm.Keyboard.KeyActions.PASS; -}; - -/** - * Either PASS or DEFAULT Meta-V, depending on preference. - * - * Always PASS Meta-Shift-V to allow browser to interpret the keystroke as - * a paste command. - */ -hterm.Keyboard.KeyMap.prototype.onMetaV_ = function(e, keyDef) { - if (e.shiftKey) - return hterm.Keyboard.KeyActions.PASS; - - return this.keyboard.passMetaV ? - hterm.Keyboard.KeyActions.PASS : - hterm.Keyboard.KeyActions.DEFAULT; -}; - -/** - * Handle font zooming. - * - * The browser's built-in zoom has a bit of an issue at certain zoom levels. - * At some magnifications, the measured height of a row of text differs from - * the height that was explicitly set. - * - * We override the browser zoom keys to change the ScrollPort's font size to - * avoid the issue. - */ -hterm.Keyboard.KeyMap.prototype.onPlusMinusZero_ = function(e, keyDef) { - if (!(this.keyboard.ctrlPlusMinusZeroZoom ^ e.shiftKey)) { - // If ctrl-PMZ controls zoom and the shift key is pressed, or - // ctrl-shift-PMZ controls zoom and this shift key is not pressed, - // then we want to send the control code instead of affecting zoom. - if (keyDef.keyCap == '-_') - return '\x1f'; // ^_ - - // Only ^_ is valid, the other sequences have no meaning. - return hterm.Keyboard.KeyActions.CANCEL; - } - - if (this.keyboard.terminal.getZoomFactor() != 1) { - // If we're not at 1:1 zoom factor, let the Ctrl +/-/0 keys control the - // browser zoom, so it's easier to for the user to get back to 100%. - return hterm.Keyboard.KeyActions.PASS; - } - - var cap = keyDef.keyCap.substr(0, 1); - if (cap == '0') { - this.keyboard.terminal.setFontSize(0); - } else { - var size = this.keyboard.terminal.getFontSize(); - - if (cap == '-' || keyDef.keyCap == '[KP-]') { - size -= 1; - } else { - size += 1; - } - - this.keyboard.terminal.setFontSize(size); - } - - return hterm.Keyboard.KeyActions.CANCEL; -}; -// SOURCE FILE: hterm/js/hterm_keyboard_keypattern.js -// Copyright (c) 2015 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * A record of modifier bits and keycode used to define a key binding. - * - * The modifier names are enumerated in the static KeyPattern.modifiers - * property below. Each modifier can be true, false, or "*". True means - * the modifier key must be present, false means it must not, and "*" means - * it doesn't matter. - */ -hterm.Keyboard.KeyPattern = function(spec) { - this.wildcardCount = 0; - this.keyCode = spec.keyCode; - - hterm.Keyboard.KeyPattern.modifiers.forEach(function(mod) { - this[mod] = spec[mod] || false; - if (this[mod] == '*') - this.wildcardCount++; - }.bind(this)); -}; - -/** - * Valid modifier names. - */ -hterm.Keyboard.KeyPattern.modifiers = [ - 'shift', 'ctrl', 'alt', 'meta' -]; - -/** - * A compare callback for Array.prototype.sort(). - * - * The bindings code wants to be sure to search through the strictest key - * patterns first, so that loosely defined patterns have a lower priority than - * exact patterns. - * - * @param {hterm.Keyboard.KeyPattern} a - * @param {hterm.Keyboard.KeyPattern} b - */ -hterm.Keyboard.KeyPattern.sortCompare = function(a, b) { - if (a.wildcardCount < b.wildcardCount) - return -1; - - if (a.wildcardCount > b.wildcardCount) - return 1; - - return 0; -}; - -/** - * Private method used to match this key pattern against other key patterns - * or key down events. - * - * @param {Object} The object to match. - * @param {boolean} True if we should ignore wildcards. Useful when you want - * to perform and exact match against another key pattern. - */ -hterm.Keyboard.KeyPattern.prototype.match_ = function(obj, exactMatch) { - if (this.keyCode != obj.keyCode) - return false; - - var rv = true; - - hterm.Keyboard.KeyPattern.modifiers.forEach(function(mod) { - var modValue = (mod in obj) ? obj[mod] : false; - if (!rv || (!exactMatch && this[mod] == '*') || this[mod] == modValue) - return; - - rv = false; - }.bind(this)); - - return rv; -}; - -/** - * Return true if the given keyDown object is a match for this key pattern. - * - * @param {Object} keyDown An object with a keyCode property and zero or - * more boolean properties representing key modifiers. These property names - * must match those defined in hterm.Keyboard.KeyPattern.modifiers. - */ -hterm.Keyboard.KeyPattern.prototype.matchKeyDown = function(keyDown) { - return this.match_(keyDown, false); -}; - -/** - * Return true if the given hterm.Keyboard.KeyPattern is exactly the same as - * this one. - * - * @param {hterm.Keyboard.KeyPattern} - */ -hterm.Keyboard.KeyPattern.prototype.matchKeyPattern = function(keyPattern) { - return this.match_(keyPattern, true); -}; -// SOURCE FILE: hterm/js/hterm_options.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * @fileoverview This file implements the hterm.Options class, - * which stores current operating conditions for the terminal. This object is - * used instead of a series of parameters to allow saving/restoring of cursor - * conditions easily, and to provide an easy place for common configuration - * options. - * - * Original code by Cory Maccarrone. - */ - -/** - * Constructor for the hterm.Options class, optionally acting as a copy - * constructor. - * - * The defaults are as defined in http://www.vt100.net/docs/vt510-rm/DECSTR - * except that we enable autowrap (wraparound) by default since that seems to - * be what xterm does. - * - * @param {hterm.Options=} opt_copy Optional instance to copy. - * @constructor - */ -hterm.Options = function(opt_copy) { - // All attributes in this class are public to allow easy access by the - // terminal. - - this.wraparound = opt_copy ? opt_copy.wraparound : true; - this.reverseWraparound = opt_copy ? opt_copy.reverseWraparound : false; - this.originMode = opt_copy ? opt_copy.originMode : false; - this.autoCarriageReturn = opt_copy ? opt_copy.autoCarriageReturn : false; - this.cursorVisible = opt_copy ? opt_copy.cursorVisible : false; - this.cursorBlink = opt_copy ? opt_copy.cursorBlink : false; - this.insertMode = opt_copy ? opt_copy.insertMode : false; - this.reverseVideo = opt_copy ? opt_copy.reverseVideo : false; - this.bracketedPaste = opt_copy ? opt_copy.bracketedPaste : false; -}; -// SOURCE FILE: hterm/js/hterm_parser.js -// Copyright (c) 2015 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('hterm.Keyboard.KeyActions'); - -/** - * @constructor - * Parses the key definition syntax used for user keyboard customizations. - */ -hterm.Parser = function() { - /** - * @type {string} The source string. - */ - this.source = ''; - - /** - * @type {number} The current position. - */ - this.pos = 0; - - /** - * @type {string?} The character at the current position. - */ - this.ch = null; -}; - -hterm.Parser.prototype.error = function(message) { - return new Error('Parse error at ' + this.pos + ': ' + message); -}; - -hterm.Parser.prototype.isComplete = function() { - return this.pos == this.source.length; -}; - -hterm.Parser.prototype.reset = function(source, opt_pos) { - this.source = source; - this.pos = opt_pos || 0; - this.ch = source.substr(0, 1); -}; - -/** - * Parse a key sequence. - * - * A key sequence is zero or more of the key modifiers defined in - * hterm.Parser.identifiers.modifierKeys followed by a key code. Key - * codes can be an integer or an identifier from - * hterm.Parser.identifiers.keyCodes. Modifiers and keyCodes should be joined - * by the dash character. - * - * An asterisk "*" can be used to indicate that the unspecified modifiers - * are optional. - * - * For example: - * A: Matches only an unmodified "A" character. - * 65: Same as above. - * 0x41: Same as above. - * Ctrl-A: Matches only Ctrl-A. - * Ctrl-65: Same as above. - * Ctrl-0x41: Same as above. - * Ctrl-Shift-A: Matches only Ctrl-Shift-A. - * Ctrl-*-A: Matches Ctrl-A, as well as any other key sequence that includes - * at least the Ctrl and A keys. - * - * @return {Object} An object with shift, ctrl, alt, meta, keyCode - * properties. - */ -hterm.Parser.prototype.parseKeySequence = function() { - var rv = { - keyCode: null - }; - - for (var k in hterm.Parser.identifiers.modifierKeys) { - rv[hterm.Parser.identifiers.modifierKeys[k]] = false; - } - - while (this.pos < this.source.length) { - this.skipSpace(); - - var token = this.parseToken(); - if (token.type == 'integer') { - rv.keyCode = token.value; - - } else if (token.type == 'identifier') { - var ucValue = token.value.toUpperCase(); - if (ucValue in hterm.Parser.identifiers.modifierKeys && - hterm.Parser.identifiers.modifierKeys.hasOwnProperty(ucValue)) { - var mod = hterm.Parser.identifiers.modifierKeys[ucValue]; - if (rv[mod] && rv[mod] != '*') - throw this.error('Duplicate modifier: ' + token.value); - rv[mod] = true; - - } else if (ucValue in hterm.Parser.identifiers.keyCodes && - hterm.Parser.identifiers.keyCodes.hasOwnProperty(ucValue)) { - rv.keyCode = hterm.Parser.identifiers.keyCodes[ucValue]; - - } else { - throw this.error('Unknown key: ' + token.value); - } - - } else if (token.type == 'symbol') { - if (token.value == '*') { - for (var id in hterm.Parser.identifiers.modifierKeys) { - var p = hterm.Parser.identifiers.modifierKeys[id]; - if (!rv[p]) - rv[p] = '*'; - } - } else { - throw this.error('Unexpected symbol: ' + token.value); - } - } else { - throw this.error('Expected integer or identifier'); - } - - this.skipSpace(); - - if (this.ch != '-') - break; - - if (rv.keyCode != null) - throw this.error('Extra definition after target key'); - - this.advance(1); - } - - if (rv.keyCode == null) - throw this.error('Missing target key'); - - return rv; -}; - -hterm.Parser.prototype.parseKeyAction = function() { - this.skipSpace(); - - var token = this.parseToken(); - - if (token.type == 'string') - return token.value; - - if (token.type == 'identifier') { - if (token.value in hterm.Parser.identifiers.actions && - hterm.Parser.identifiers.actions.hasOwnProperty(token.value)) - return hterm.Parser.identifiers.actions[token.value]; - - throw this.error('Unknown key action: ' + token.value); - } - - throw this.error('Expected string or identifier'); - -}; - -hterm.Parser.prototype.peekString = function() { - return this.ch == '\'' || this.ch == '"'; -}; - -hterm.Parser.prototype.peekIdentifier = function() { - return this.ch.match(/[a-z_]/i); -}; - -hterm.Parser.prototype.peekInteger = function() { - return this.ch.match(/[0-9]/); -}; - -hterm.Parser.prototype.parseToken = function() { - if (this.ch == '*') { - var rv = {type: 'symbol', value: this.ch}; - this.advance(1); - return rv; - } - - if (this.peekIdentifier()) - return {type: 'identifier', value: this.parseIdentifier()}; - - if (this.peekString()) - return {type: 'string', value: this.parseString()}; - - if (this.peekInteger()) - return {type: 'integer', value: this.parseInteger()}; - - - throw this.error('Unexpected token'); -}; - -hterm.Parser.prototype.parseIdentifier = function() { - if (!this.peekIdentifier()) - throw this.error('Expected identifier'); - - return this.parsePattern(/[a-z0-9_]+/ig); -}; - -hterm.Parser.prototype.parseInteger = function() { - var base = 10; - - if (this.ch == '0' && this.pos < this.source.length - 1 && - this.source.substr(this.pos + 1, 1) == 'x') { - return parseInt(this.parsePattern(/0x[0-9a-f]+/gi)); - } - - return parseInt(this.parsePattern(/\d+/g)); -}; - -/** - * Parse a single or double quoted string. - * - * The current position should point at the initial quote character. Single - * quoted strings will be treated literally, double quoted will process escapes. - * - * TODO(rginda): Variable interpolation. - * - * @param {ParseState} parseState - * @param {string} quote A single or double-quote character. - * @return {string} - */ -hterm.Parser.prototype.parseString = function() { - var result = ''; - - var quote = this.ch; - if (quote != '"' && quote != '\'') - throw this.error('String expected'); - - this.advance(1); - - var re = new RegExp('[\\\\' + quote + ']', 'g'); - - while (this.pos < this.source.length) { - re.lastIndex = this.pos; - if (!re.exec(this.source)) - throw this.error('Unterminated string literal'); - - result += this.source.substring(this.pos, re.lastIndex - 1); - - this.advance(re.lastIndex - this.pos - 1); - - if (quote == '"' && this.ch == '\\') { - this.advance(1); - result += this.parseEscape(); - continue; - } - - if (quote == '\'' && this.ch == '\\') { - result += this.ch; - this.advance(1); - continue; - } - - if (this.ch == quote) { - this.advance(1); - return result; - } - } - - throw this.error('Unterminated string literal'); -}; - - -/** - * Parse an escape code from the current position (which should point to - * the first character AFTER the leading backslash.) - * - * @return {string} - */ -hterm.Parser.prototype.parseEscape = function() { - var map = { - '"': '"', - '\'': '\'', - '\\': '\\', - 'a': '\x07', - 'b': '\x08', - 'e': '\x1b', - 'f': '\x0c', - 'n': '\x0a', - 'r': '\x0d', - 't': '\x09', - 'v': '\x0b', - 'x': function() { - var value = this.parsePattern(/[a-z0-9]{2}/ig); - return String.fromCharCode(parseInt(value, 16)); - }, - 'u': function() { - var value = this.parsePattern(/[a-z0-9]{4}/ig); - return String.fromCharCode(parseInt(value, 16)); - } - }; - - if (!(this.ch in map && map.hasOwnProperty(this.ch))) - throw this.error('Unknown escape: ' + this.ch); - - var value = map[this.ch]; - this.advance(1); - - if (typeof value == 'function') - value = value.call(this); - - return value; -}; - -/** - * Parse the given pattern starting from the current position. - * - * @param {RegExp} pattern A pattern representing the characters to span. MUST - * include the "global" RegExp flag. - * @return {string} - */ -hterm.Parser.prototype.parsePattern = function(pattern) { - if (!pattern.global) - throw this.error('Internal error: Span patterns must be global'); - - pattern.lastIndex = this.pos; - var ary = pattern.exec(this.source); - - if (!ary || pattern.lastIndex - ary[0].length != this.pos) - throw this.error('Expected match for: ' + pattern); - - this.pos = pattern.lastIndex - 1; - this.advance(1); - - return ary[0]; -}; - - -/** - * Advance the current position. - * - * @param {number} count - */ -hterm.Parser.prototype.advance = function(count) { - this.pos += count; - this.ch = this.source.substr(this.pos, 1); -}; - -/** - * @param {string=} opt_expect A list of valid non-whitespace characters to - * terminate on. - * @return {void} - */ -hterm.Parser.prototype.skipSpace = function(opt_expect) { - if (!/\s/.test(this.ch)) - return; - - var re = /\s+/gm; - re.lastIndex = this.pos; - - var source = this.source; - if (re.exec(source)) - this.pos = re.lastIndex; - - this.ch = this.source.substr(this.pos, 1); - - if (opt_expect) { - if (this.ch.indexOf(opt_expect) == -1) { - throw this.error('Expected one of ' + opt_expect + ', found: ' + - this.ch); - } - } -}; -// SOURCE FILE: hterm/js/hterm_parser_identifiers.js -// Copyright (c) 2015 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * Collections of identifier for hterm.Parser. - */ -hterm.Parser.identifiers = {}; - -/** - * Modifier key names used when defining key sequences. - * - * These are upper case so we can normalize the user input and be forgiving. - * "CTRL-A" and "Ctrl-A" and "ctrl-a" are all accepted. - * - * Note: Names here cannot overlap with hterm.Parser.identifiers.keyCodes. - */ -hterm.Parser.identifiers.modifierKeys = { - SHIFT: 'shift', - CTRL: 'ctrl', - // Common alias. - CONTROL: 'ctrl', - ALT: 'alt', - META: 'meta' -}; - -/** - * Key codes useful when defining key sequences. - * - * Punctuation is mostly left out of this list because they can move around - * based on keyboard locale and browser. - * - * In a key sequence like "Ctrl-ESC", the ESC comes from this list of - * identifiers. It is equivalent to "Ctrl-27" and "Ctrl-0x1b". - * - * These are upper case so we can normalize the user input and be forgiving. - * "Ctrl-ESC" and "Ctrl-Esc" an "Ctrl-esc" are all accepted. - * - * We also include common aliases for the same key. "Esc" and "Escape" are the - * same key. - * - * Note: Names here cannot overlap with hterm.Parser.identifiers.modifierKeys. - */ -hterm.Parser.identifiers.keyCodes = { - // Top row. - ESCAPE: 27, - ESC: 27, - F1: 112, - F2: 113, - F3: 114, - F4: 115, - F5: 116, - F6: 117, - F7: 118, - F8: 119, - F9: 120, - F10: 121, - F11: 122, - F12: 123, - - // Row two. - ONE: 49, - TWO: 50, - THREE: 51, - FOUR: 52, - FIVE: 53, - SIX: 54, - SEVEN: 55, - EIGHT: 56, - NINE: 57, - ZERO: 48, - BACKSPACE: 8, - BKSP: 8, - BS: 8, - - // Row three. - TAB: 9, - Q: 81, - W: 87, - E: 69, - R: 82, - T: 84, - Y: 89, - U: 85, - I: 73, - O: 79, - P: 80, - - // Row four. - CAPS_LOCK: 20, - CAPSLOCK: 20, - CAPS: 20, - A: 65, - S: 83, - D: 68, - F: 70, - G: 71, - H: 72, - J: 74, - K: 75, - L: 76, - // We map enter and return together even though enter should really be 10 - // because most people don't know or care about the history here. Plus, - // most keyboards/programs map them together already. If they really want - // to bind them differently, they can also use the numeric value. - ENTER: 13, - ENT: 13, - RETURN: 13, - RET: 13, - - // Row five. - Z: 90, - X: 88, - C: 67, - V: 86, - B: 66, - N: 78, - M: 77, - - // Etc. - SPACE: 32, - SP: 32, - PRINT_SCREEN: 42, - PRTSC: 42, - SCROLL_LOCK: 145, - SCRLK: 145, - BREAK: 19, - BRK: 19, - INSERT: 45, - INS: 45, - HOME: 36, - PAGE_UP: 33, - PGUP: 33, - DELETE: 46, - DEL: 46, - END: 35, - PAGE_DOWN: 34, - PGDOWN: 34, - PGDN: 34, - UP: 38, - DOWN: 40, - RIGHT: 39, - LEFT: 37, - NUMLOCK: 144, - - // Keypad - KP0: 96, - KP1: 97, - KP2: 98, - KP3: 99, - KP4: 100, - KP5: 101, - KP6: 102, - KP7: 103, - KP8: 104, - KP9: 105, - KP_PLUS: 107, - KP_ADD: 107, - KP_MINUS: 109, - KP_SUBTRACT: 109, - KP_STAR: 106, - KP_MULTIPLY: 106, - KP_DIVIDE: 111, - KP_DECIMAL: 110, - KP_PERIOD: 110, - - // Chrome OS media keys - NAVIGATE_BACK: 166, - NAVIGATE_FORWARD: 167, - RELOAD: 168, - FULL_SCREEN: 183, - WINDOW_OVERVIEW: 182, - BRIGHTNESS_UP: 216, - BRIGHTNESS_DOWN: 217 -}; - -/** - * Identifiers for use in key actions. - */ -hterm.Parser.identifiers.actions = { - /** - * Prevent the browser and operating system from handling the event. - */ - CANCEL: hterm.Keyboard.KeyActions.CANCEL, - - /** - * Wait for a "keypress" event, send the keypress charCode to the host. - */ - DEFAULT: hterm.Keyboard.KeyActions.DEFAULT, - - /** - * Let the browser or operating system handle the key. - */ - PASS: hterm.Keyboard.KeyActions.PASS, - - /** - * Scroll the terminal one page up. - */ - scrollPageUp: function(terminal) { - terminal.scrollPageUp(); - return hterm.Keyboard.KeyActions.CANCEL; - }, - - /** - * Scroll the terminal one page down. - */ - scrollPageDown: function(terminal) { - terminal.scrollPageDown(); - return hterm.Keyboard.KeyActions.CANCEL; - }, - - /** - * Scroll the terminal to the top. - */ - scrollToTop: function(terminal) { - terminal.scrollEnd(); - return hterm.Keyboard.KeyActions.CANCEL; - }, - - /** - * Scroll the terminal to the bottom. - */ - scrollToBottom: function(terminal) { - terminal.scrollEnd(); - return hterm.Keyboard.KeyActions.CANCEL; - }, - - /** - * Clear the terminal and scrollback buffer. - */ - clearScrollback: function(terminal) { - terminal.wipeContents(); - return hterm.Keyboard.KeyActions.CANCEL; - } -}; -// SOURCE FILE: hterm/js/hterm_preference_manager.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.f', 'lib.Storage'); - -/** - * PreferenceManager subclass managing global NaSSH preferences. - * - * This is currently just an ordered list of known connection profiles. - */ -hterm.PreferenceManager = function(profileId) { - lib.PreferenceManager.call(this, hterm.defaultStorage, - hterm.PreferenceManager.prefix_ + profileId); - var defs = hterm.PreferenceManager.defaultPreferences; - Object.keys(defs).forEach(function(key) { - this.definePreference(key, defs[key][1]); - }.bind(this)); -}; - -/** - * The storage key prefix to namespace the preferences. - */ -hterm.PreferenceManager.prefix_ = '/hterm/profiles/'; - -/** - * List all the defined profiles. - * - * @param {function(Array)} callback Called with the list of profiles. - */ -hterm.PreferenceManager.listProfiles = function(callback) { - hterm.defaultStorage.getItems(null, (items) => { - const profiles = {}; - for (let key of Object.keys(items)) { - if (key.startsWith(hterm.PreferenceManager.prefix_)) { - // Turn "/hterm/profiles/foo/bar/cow" to "foo/bar/cow". - const subKey = key.slice(hterm.PreferenceManager.prefix_.length); - // Turn "foo/bar/cow" into "foo". - profiles[subKey.split('/', 1)[0]] = true; - } - } - callback(Object.keys(profiles)); - }); -}; - -hterm.PreferenceManager.categories = {}; -hterm.PreferenceManager.categories.Keyboard = 'Keyboard'; -hterm.PreferenceManager.categories.Appearance = 'Appearance'; -hterm.PreferenceManager.categories.CopyPaste = 'CopyPaste'; -hterm.PreferenceManager.categories.Sounds = 'Sounds'; -hterm.PreferenceManager.categories.Scrolling = 'Scrolling'; -hterm.PreferenceManager.categories.Encoding = 'Encoding'; -hterm.PreferenceManager.categories.Extensions = 'Extensions'; -hterm.PreferenceManager.categories.Miscellaneous = 'Miscellaneous'; - -/** - * List of categories, ordered by display order (top to bottom) - */ -hterm.PreferenceManager.categoryDefinitions = [ - { id: hterm.PreferenceManager.categories.Appearance, - text: 'Appearance (fonts, colors, images)'}, - { id: hterm.PreferenceManager.categories.CopyPaste, - text: 'Copy & Paste'}, - { id: hterm.PreferenceManager.categories.Encoding, - text: 'Encoding'}, - { id: hterm.PreferenceManager.categories.Keyboard, - text: 'Keyboard'}, - { id: hterm.PreferenceManager.categories.Scrolling, - text: 'Scrolling'}, - { id: hterm.PreferenceManager.categories.Sounds, - text: 'Sounds'}, - { id: hterm.PreferenceManager.categories.Extensions, - text: 'Extensions'}, - { id: hterm.PreferenceManager.categories.Miscellaneous, - text: 'Misc.'} -]; - - -hterm.PreferenceManager.defaultPreferences = { - 'alt-gr-mode': - [hterm.PreferenceManager.categories.Keyboard, null, - [null, 'none', 'ctrl-alt', 'left-alt', 'right-alt'], - 'Select an AltGr detection heuristic.\n' + - '\n' + - '\'null\': Autodetect based on navigator.language:\n' + - ' \'en-us\' => \'none\', else => \'right-alt\'\n' + - '\'none\': Disable any AltGr related munging.\n' + - '\'ctrl-alt\': Assume Ctrl+Alt means AltGr.\n' + - '\'left-alt\': Assume left Alt means AltGr.\n' + - '\'right-alt\': Assume right Alt means AltGr.'], - - 'alt-backspace-is-meta-backspace': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'If set, undoes the Chrome OS Alt-Backspace->DEL remap, so that ' + - 'alt-backspace indeed is alt-backspace.'], - - 'alt-is-meta': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'Set whether the alt key acts as a meta key or as a distinct alt key.'], - - 'alt-sends-what': - [hterm.PreferenceManager.categories.Keyboard, 'escape', - ['escape', '8-bit', 'browser-key'], - 'Controls how the alt key is handled.\n' + - '\n' + - ' escape....... Send an ESC prefix.\n' + - ' 8-bit........ Add 128 to the unshifted character as in xterm.\n' + - ' browser-key.. Wait for the keypress event and see what the browser\n' + - ' says. (This won\'t work well on platforms where the\n' + - ' browser performs a default action for some alt sequences.)' - ], - - 'audible-bell-sound': - [hterm.PreferenceManager.categories.Sounds, 'lib-resource:hterm/audio/bell', - 'url', - 'URL of the terminal bell sound. Empty string for no audible bell.'], - - 'desktop-notification-bell': - [hterm.PreferenceManager.categories.Sounds, false, 'bool', - 'If true, terminal bells in the background will create a Web ' + - 'Notification. https://www.w3.org/TR/notifications/\n' + - '\n'+ - 'Displaying notifications requires permission from the user. When this ' + - 'option is set to true, hterm will attempt to ask the user for permission ' + - 'if necessary. Note browsers may not show this permission request if it ' + - 'did not originate from a user action.\n' + - '\n' + - 'Chrome extensions with the "notifications" permission have permission to ' + - 'display notifications.'], - - 'background-color': - [hterm.PreferenceManager.categories.Appearance, 'rgb(16, 16, 16)', 'color', - 'The background color for text with no other color attributes.'], - - 'background-image': - [hterm.PreferenceManager.categories.Appearance, '', 'string', - 'CSS value of the background image. Empty string for no image.\n' + - '\n' + - 'For example:\n' + - ' url(https://goo.gl/anedTK)\n' + - ' linear-gradient(top bottom, blue, red)'], - - 'background-size': - [hterm.PreferenceManager.categories.Appearance, '', 'string', - 'CSS value of the background image size. Defaults to none.'], - - 'background-position': - [hterm.PreferenceManager.categories.Appearance, '', 'string', - 'CSS value of the background image position.\n' + - '\n' + - 'For example:\n' + - ' 10% 10%\n' + - ' center'], - - 'backspace-sends-backspace': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'If true, the backspace should send BS (\'\\x08\', aka ^H). Otherwise ' + - 'the backspace key should send \'\\x7f\'.'], - - 'character-map-overrides': - [hterm.PreferenceManager.categories.Appearance, null, 'value', - 'This is specified as an object. It is a sparse array, where each ' + - 'property is the character set code and the value is an object that is ' + - 'a sparse array itself. In that sparse array, each property is the ' + - 'received character and the value is the displayed character.\n' + - '\n' + - 'For example:\n' + - ' {"0":{"+":"\\u2192",",":"\\u2190","-":"\\u2191",".":"\\u2193", ' + - '"0":"\\u2588"}}' - ], - - 'close-on-exit': - [hterm.PreferenceManager.categories.Miscellaneous, true, 'bool', - 'Whether or not to close the window when the command exits.'], - - 'cursor-blink': - [hterm.PreferenceManager.categories.Appearance, false, 'bool', - 'Whether or not to blink the cursor by default.'], - - 'cursor-blink-cycle': - [hterm.PreferenceManager.categories.Appearance, [1000, 500], 'value', - 'The cursor blink rate in milliseconds.\n' + - '\n' + - 'A two element array, the first of which is how long the cursor should be ' + - 'on, second is how long it should be off.'], - - 'cursor-color': - [hterm.PreferenceManager.categories.Appearance, 'rgba(255, 0, 0, 0.5)', - 'color', - 'The color of the visible cursor.'], - - 'color-palette-overrides': - [hterm.PreferenceManager.categories.Appearance, null, 'value', - 'Override colors in the default palette.\n' + - '\n' + - 'This can be specified as an array or an object. If specified as an ' + - 'object it is assumed to be a sparse array, where each property ' + - 'is a numeric index into the color palette.\n' + - '\n' + - 'Values can be specified as almost any css color value. This ' + - 'includes #RGB, #RRGGBB, rgb(...), rgba(...), and any color names ' + - 'that are also part of the stock X11 rgb.txt file.\n' + - '\n' + - 'You can use \'null\' to specify that the default value should be not ' + - 'be changed. This is useful for skipping a small number of indices ' + - 'when the value is specified as an array.'], - - 'copy-on-select': - [hterm.PreferenceManager.categories.CopyPaste, true, 'bool', - 'Automatically copy mouse selection to the clipboard.'], - - 'use-default-window-copy': - [hterm.PreferenceManager.categories.CopyPaste, false, 'bool', - 'Whether to use the default window copy behavior'], - - 'clear-selection-after-copy': - [hterm.PreferenceManager.categories.CopyPaste, true, 'bool', - 'Whether to clear the selection after copying.'], - - 'ctrl-plus-minus-zero-zoom': - [hterm.PreferenceManager.categories.Keyboard, true, 'bool', - 'If true, Ctrl-Plus/Minus/Zero controls zoom.\n' + - 'If false, Ctrl-Shift-Plus/Minus/Zero controls zoom, Ctrl-Minus sends ^_, ' + - 'Ctrl-Plus/Zero do nothing.'], - - 'ctrl-c-copy': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'Ctrl+C copies if true, send ^C to host if false.\n' + - 'Ctrl+Shift+C sends ^C to host if true, copies if false.'], - - 'ctrl-v-paste': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'Ctrl+V pastes if true, send ^V to host if false.\n' + - 'Ctrl+Shift+V sends ^V to host if true, pastes if false.'], - - 'east-asian-ambiguous-as-two-column': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'Set whether East Asian Ambiguous characters have two column width.'], - - 'enable-8-bit-control': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'True to enable 8-bit control characters, false to ignore them.\n' + - '\n' + - 'We\'ll respect the two-byte versions of these control characters ' + - 'regardless of this setting.'], - - 'enable-bold': - [hterm.PreferenceManager.categories.Appearance, null, 'tristate', - 'True if we should use bold weight font for text with the bold/bright ' + - 'attribute. False to use the normal weight font. Null to autodetect.'], - - 'enable-bold-as-bright': - [hterm.PreferenceManager.categories.Appearance, true, 'bool', - 'True if we should use bright colors (8-15 on a 16 color palette) ' + - 'for any text with the bold attribute. False otherwise.'], - - 'enable-blink': - [hterm.PreferenceManager.categories.Appearance, true, 'bool', - 'True if we should respect the blink attribute. False to ignore it. '], - - 'enable-clipboard-notice': - [hterm.PreferenceManager.categories.CopyPaste, true, 'bool', - 'Show a message in the terminal when the host writes to the clipboard.'], - - 'enable-clipboard-write': - [hterm.PreferenceManager.categories.CopyPaste, true, 'bool', - 'Allow the remote host to write directly to the local system clipboard.\n' + - 'Read access is never granted regardless of this setting.\n' + - '\n' + - 'This is used to control access to features like OSC-52.'], - - 'enable-dec12': - [hterm.PreferenceManager.categories.Miscellaneous, false, 'bool', - 'Respect the host\'s attempt to change the cursor blink status using ' + - 'DEC Private Mode 12.'], - - 'environment': - [hterm.PreferenceManager.categories.Miscellaneous, - { - // Signal ncurses based apps to use UTF-8 output instead of legacy drawing - // modes (which only work in ISO-2022 mode). Since hterm is always UTF-8, - // this shouldn't cause problems. - 'NCURSES_NO_UTF8_ACS': '1', - 'TERM': 'xterm-256color', - }, - 'value', - 'The default environment variables, as an object.'], - - 'font-family': - [hterm.PreferenceManager.categories.Appearance, - '"DejaVu Sans Mono", "Everson Mono", FreeMono, "Menlo", "Terminal", ' + - 'monospace', 'string', - 'Default font family for the terminal text.'], - - 'font-size': - [hterm.PreferenceManager.categories.Appearance, 15, 'int', - 'The default font size in pixels.'], - - 'font-smoothing': - [hterm.PreferenceManager.categories.Appearance, 'antialiased', 'string', - 'CSS font-smoothing property.'], - - 'foreground-color': - [hterm.PreferenceManager.categories.Appearance, 'rgb(240, 240, 240)', 'color', - 'The foreground color for text with no other color attributes.'], - - 'home-keys-scroll': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'If true, home/end will control the terminal scrollbar and shift home/end ' + - 'will send the VT keycodes. If false then home/end sends VT codes and ' + - 'shift home/end scrolls.'], - - 'keybindings': - [hterm.PreferenceManager.categories.Keyboard, null, 'value', - 'A map of key sequence to key actions. Key sequences include zero or ' + - 'more modifier keys followed by a key code. Key codes can be decimal or ' + - 'hexadecimal numbers, or a key identifier. Key actions can be specified ' + - 'a string to send to the host, or an action identifier. For a full ' + - 'explanation of the format, see https://goo.gl/LWRndr.\n' + - '\n' + - 'Sample keybindings:\n' + - '{\n' + - ' "Ctrl-Alt-K": "clearScrollback",\n' + - ' "Ctrl-Shift-L": "PASS",\n' + - ' "Ctrl-H": "\'HELLO\\n\'"\n' + - '}'], - - 'media-keys-are-fkeys': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'If true, convert media keys to their Fkey equivalent. If false, let ' + - 'the browser handle the keys.'], - - 'meta-sends-escape': - [hterm.PreferenceManager.categories.Keyboard, true, 'bool', - 'Set whether the meta key sends a leading escape or not.'], - - 'mouse-right-click-paste': - [hterm.PreferenceManager.categories.CopyPaste, true, 'bool', - 'Paste on right mouse button clicks.\n' + - '\n' + - 'This option is activate independent of the "mouse-paste-button" ' + - 'setting.\n' + - '\n' + - 'Note: This will handle left & right handed mice correctly.'], - - 'mouse-paste-button': - [hterm.PreferenceManager.categories.CopyPaste, null, - [null, 0, 1, 2, 3, 4, 5, 6], - 'Mouse paste button, or null to autodetect.\n' + - '\n' + - 'For autodetect, we\'ll use the middle mouse button for non-X11 ' + - 'platforms (including Chrome OS). On X11, we\'ll use the right mouse ' + - 'button (since the native window manager should paste via the middle ' + - 'mouse button).\n' + - '\n' + - '0 == left (primary) button.\n' + - '1 == middle (auxiliary) button.\n' + - '2 == right (secondary) button.\n' + - '\n' + - 'This option is activate independent of the "mouse-right-click-paste" ' + - 'setting.\n' + - '\n' + - 'Note: This will handle left & right handed mice correctly.'], - - 'word-break-match-left': - [hterm.PreferenceManager.categories.CopyPaste, - '[^\\s\\[\\](){}<>"\'\\^!@#$%&*,;:`]', 'string', - 'Regular expression to halt matching to the left (start) of a selection.\n' + - '\n' + - 'Normally this is a character class to reject specific characters.\n' + - 'We allow "~" and "." by default as paths frequently start with those.'], - - 'word-break-match-right': - [hterm.PreferenceManager.categories.CopyPaste, - '[^\\s\\[\\](){}<>"\'\\^!@#$%&*,;:~.`]', 'string', - 'Regular expression to halt matching to the right (end) of a selection.\n' + - '\n' + - 'Normally this is a character class to reject specific characters.'], - - 'word-break-match-middle': - [hterm.PreferenceManager.categories.CopyPaste, - '[^\\s\\[\\](){}<>"\'\\^]*', 'string', - 'Regular expression to match all the characters in the middle.\n' + - '\n' + - 'Normally this is a character class to reject specific characters.\n' + - '\n' + - 'Used to expand the selection surrounding the starting point.'], - - 'page-keys-scroll': - [hterm.PreferenceManager.categories.Keyboard, false, 'bool', - 'If true, page up/down will control the terminal scrollbar and shift ' + - 'page up/down will send the VT keycodes. If false then page up/down ' + - 'sends VT codes and shift page up/down scrolls.'], - - 'pass-alt-number': - [hterm.PreferenceManager.categories.Keyboard, null, 'tristate', - 'Set whether we should pass Alt-1..9 to the browser.\n' + - '\n' + - 'This is handy when running hterm in a browser tab, so that you don\'t ' + - 'lose Chrome\'s "switch to tab" keyboard accelerators. When not running ' + - 'in a tab it\'s better to send these keys to the host so they can be ' + - 'used in vim or emacs.\n' + - '\n' + - 'If true, Alt-1..9 will be handled by the browser. If false, Alt-1..9 ' + - 'will be sent to the host. If null, autodetect based on browser platform ' + - 'and window type.'], - - 'pass-ctrl-number': - [hterm.PreferenceManager.categories.Keyboard, null, 'tristate', - 'Set whether we should pass Ctrl-1..9 to the browser.\n' + - '\n' + - 'This is handy when running hterm in a browser tab, so that you don\'t ' + - 'lose Chrome\'s "switch to tab" keyboard accelerators. When not running ' + - 'in a tab it\'s better to send these keys to the host so they can be ' + - 'used in vim or emacs.\n' + - '\n' + - 'If true, Ctrl-1..9 will be handled by the browser. If false, Ctrl-1..9 ' + - 'will be sent to the host. If null, autodetect based on browser platform ' + - 'and window type.'], - - 'pass-meta-number': - [hterm.PreferenceManager.categories.Keyboard, null, 'tristate', - 'Set whether we should pass Meta-1..9 to the browser.\n' + - '\n' + - 'This is handy when running hterm in a browser tab, so that you don\'t ' + - 'lose Chrome\'s "switch to tab" keyboard accelerators. When not running ' + - 'in a tab it\'s better to send these keys to the host so they can be ' + - 'used in vim or emacs.\n' + - '\n' + - 'If true, Meta-1..9 will be handled by the browser. If false, Meta-1..9 ' + - 'will be sent to the host. If null, autodetect based on browser platform ' + - 'and window type.'], - - 'pass-meta-v': - [hterm.PreferenceManager.categories.Keyboard, true, 'bool', - 'Set whether meta-V gets passed to host.'], - - 'receive-encoding': - [hterm.PreferenceManager.categories.Encoding, 'utf-8', ['utf-8', 'raw'], - 'Set the expected encoding for data received from the host.\n' + - '\n' + - 'Valid values are \'utf-8\' and \'raw\'.'], - - 'scroll-on-keystroke': - [hterm.PreferenceManager.categories.Scrolling, true, 'bool', - 'If true, scroll to the bottom on any keystroke.'], - - 'scroll-on-output': - [hterm.PreferenceManager.categories.Scrolling, false, 'bool', - 'If true, scroll to the bottom on terminal output.'], - - 'scrollbar-visible': - [hterm.PreferenceManager.categories.Scrolling, true, 'bool', - 'The vertical scrollbar mode.'], - - 'scroll-wheel-may-send-arrow-keys': - [hterm.PreferenceManager.categories.Scrolling, false, 'bool', - 'When using the alternative screen buffer, and DECCKM (Application Cursor ' + - 'Keys) is active, mouse wheel scroll events will emulate arrow keys.\n' + - '\n' + - 'It can be temporarily disabled by holding the shift key.\n' + - '\n' + - 'This frequently comes up when using pagers (less) or reading man pages ' + - 'or text editors (vi/nano) or using screen/tmux.'], - - 'scroll-wheel-move-multiplier': - [hterm.PreferenceManager.categories.Scrolling, 1, 'int', - 'The multiplier for the pixel delta in wheel events caused by the ' + - 'scroll wheel. Alters how fast the page scrolls.'], - - 'send-encoding': - [hterm.PreferenceManager.categories.Encoding, 'utf-8', ['utf-8', 'raw'], - 'Set the encoding for data sent to host.'], - - 'terminal-encoding': - [hterm.PreferenceManager.categories.Encoding, 'utf-8', - ['iso-2022', 'utf-8', 'utf-8-locked'], - 'The default terminal encoding (DOCS).\n' + - '\n' + - 'ISO-2022 enables character map translations (like graphics maps).\n' + - 'UTF-8 disables support for those.\n' + - '\n' + - 'The locked variant means the encoding cannot be changed at runtime ' + - 'via terminal escape sequences.\n' + - '\n' + - 'You should stick with UTF-8 unless you notice broken rendering with ' + - 'legacy applications.'], - - 'shift-insert-paste': - [hterm.PreferenceManager.categories.Keyboard, true, 'bool', - 'Shift + Insert pastes if true, sent to host if false.'], - - 'user-css': - [hterm.PreferenceManager.categories.Appearance, '', 'url', - 'URL of user stylesheet to include in the terminal document.'], - - 'user-css-text': - [hterm.PreferenceManager.categories.Appearance, '', 'multiline-string', - 'Custom CSS text for styling the terminal.'], - - 'allow-images-inline': - [hterm.PreferenceManager.categories.Extensions, null, 'tristate', - 'Whether to allow the remote side to display images in the terminal.\n' + - '\n' + - 'By default, we prompt until a choice is made.'], -}; - -hterm.PreferenceManager.prototype = - Object.create(lib.PreferenceManager.prototype); -hterm.PreferenceManager.constructor = hterm.PreferenceManager; -// SOURCE FILE: hterm/js/hterm_pubsub.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -/** - * Utility class used to add publish/subscribe/unsubscribe functionality to - * an existing object. - */ -hterm.PubSub = function() { - this.observers_ = {}; -}; - -/** - * Add publish, subscribe, and unsubscribe methods to an existing object. - * - * No other properties of the object are touched, so there is no need to - * worry about clashing private properties. - * - * @param {Object} obj The object to add this behavior to. - */ -hterm.PubSub.addBehavior = function(obj) { - var pubsub = new hterm.PubSub(); - for (var m in hterm.PubSub.prototype) { - obj[m] = hterm.PubSub.prototype[m].bind(pubsub); - } -}; - -/** - * Subscribe to be notified of messages about a subject. - * - * @param {string} subject The subject to subscribe to. - * @param {function(Object)} callback The function to invoke for notifications. - */ -hterm.PubSub.prototype.subscribe = function(subject, callback) { - if (!(subject in this.observers_)) - this.observers_[subject] = []; - - this.observers_[subject].push(callback); -}; - -/** - * Unsubscribe from a subject. - * - * @param {string} subject The subject to unsubscribe from. - * @param {function(Object)} callback A callback previously registered via - * subscribe(). - */ -hterm.PubSub.prototype.unsubscribe = function(subject, callback) { - var list = this.observers_[subject]; - if (!list) - throw 'Invalid subject: ' + subject; - - var i = list.indexOf(callback); - if (i < 0) - throw 'Not subscribed: ' + subject; - - list.splice(i, 1); -}; - -/** - * Publish a message about a subject. - * - * Subscribers (and the optional final callback) are invoked asynchronously. - * This method will return before anyone is actually notified. - * - * @param {string} subject The subject to publish about. - * @param {Object} e An arbitrary object associated with this notification. - * @param {function(Object)} opt_lastCallback An optional function to call after - * all subscribers have been notified. - */ -hterm.PubSub.prototype.publish = function(subject, e, opt_lastCallback) { - function notifyList(i) { - // Set this timeout before invoking the callback, so we don't have to - // concern ourselves with exceptions. - if (i < list.length - 1) - setTimeout(notifyList, 0, i + 1); - - list[i](e); - } - - var list = this.observers_[subject]; - if (list) { - // Copy the list, in case it changes while we're notifying. - list = [].concat(list); - } - - if (opt_lastCallback) { - if (list) { - list.push(opt_lastCallback); - } else { - list = [opt_lastCallback]; - } - } - - if (list) - setTimeout(notifyList, 0, 0); -}; -// SOURCE FILE: hterm/js/hterm_screen.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.f', 'lib.wc', - 'hterm.RowCol', 'hterm.Size', 'hterm.TextAttributes'); - -/** - * @fileoverview This class represents a single terminal screen full of text. - * - * It maintains the current cursor position and has basic methods for text - * insert and overwrite, and adding or removing rows from the screen. - * - * This class has no knowledge of the scrollback buffer. - * - * The number of rows on the screen is determined only by the number of rows - * that the caller inserts into the screen. If a caller wants to ensure a - * constant number of rows on the screen, it's their responsibility to remove a - * row for each row inserted. - * - * The screen width, in contrast, is enforced locally. - * - * - * In practice... - * - The hterm.Terminal class holds two hterm.Screen instances. One for the - * primary screen and one for the alternate screen. - * - * - The html.Screen class only cares that rows are HTMLElements. In the - * larger context of hterm, however, the rows happen to be displayed by an - * hterm.ScrollPort and have to follow a few rules as a result. Each - * row must be rooted by the custom HTML tag 'x-row', and each must have a - * rowIndex property that corresponds to the index of the row in the context - * of the scrollback buffer. These invariants are enforced by hterm.Terminal - * because that is the class using the hterm.Screen in the context of an - * hterm.ScrollPort. - */ - -/** - * Create a new screen instance. - * - * The screen initially has no rows and a maximum column count of 0. - * - * @param {integer} opt_columnCount The maximum number of columns for this - * screen. See insertString() and overwriteString() for information about - * what happens when too many characters are added too a row. Defaults to - * 0 if not provided. - */ -hterm.Screen = function(opt_columnCount) { - /** - * Public, read-only access to the rows in this screen. - */ - this.rowsArray = []; - - // The max column width for this screen. - this.columnCount_ = opt_columnCount || 80; - - // The current color, bold, underline and blink attributes. - this.textAttributes = new hterm.TextAttributes(window.document); - - // Current zero-based cursor coordinates. - this.cursorPosition = new hterm.RowCol(0, 0); - - // Saved state used by DECSC and related settings. This is only for saving - // and restoring specific state, not for the current/active state. - this.cursorState_ = new hterm.Screen.CursorState(this); - - // The node containing the row that the cursor is positioned on. - this.cursorRowNode_ = null; - - // The node containing the span of text that the cursor is positioned on. - this.cursorNode_ = null; - - // The offset in column width into cursorNode_ where the cursor is positioned. - this.cursorOffset_ = null; - - // Regexes for expanding word selections. - this.wordBreakMatchLeft = null; - this.wordBreakMatchRight = null; - this.wordBreakMatchMiddle = null; -}; - -/** - * Return the screen size as an hterm.Size object. - * - * @return {hterm.Size} hterm.Size object representing the current number - * of rows and columns in this screen. - */ -hterm.Screen.prototype.getSize = function() { - return new hterm.Size(this.columnCount_, this.rowsArray.length); -}; - -/** - * Return the current number of rows in this screen. - * - * @return {integer} The number of rows in this screen. - */ -hterm.Screen.prototype.getHeight = function() { - return this.rowsArray.length; -}; - -/** - * Return the current number of columns in this screen. - * - * @return {integer} The number of columns in this screen. - */ -hterm.Screen.prototype.getWidth = function() { - return this.columnCount_; -}; - -/** - * Set the maximum number of columns per row. - * - * @param {integer} count The maximum number of columns per row. - */ -hterm.Screen.prototype.setColumnCount = function(count) { - this.columnCount_ = count; - - if (this.cursorPosition.column >= count) - this.setCursorPosition(this.cursorPosition.row, count - 1); -}; - -/** - * Remove the first row from the screen and return it. - * - * @return {HTMLElement} The first row in this screen. - */ -hterm.Screen.prototype.shiftRow = function() { - return this.shiftRows(1)[0]; -}; - -/** - * Remove rows from the top of the screen and return them as an array. - * - * @param {integer} count The number of rows to remove. - * @return {Array.} The selected rows. - */ -hterm.Screen.prototype.shiftRows = function(count) { - return this.rowsArray.splice(0, count); -}; - -/** - * Insert a row at the top of the screen. - * - * @param {HTMLElement} row The row to insert. - */ -hterm.Screen.prototype.unshiftRow = function(row) { - this.rowsArray.splice(0, 0, row); -}; - -/** - * Insert rows at the top of the screen. - * - * @param {Array.} rows The rows to insert. - */ -hterm.Screen.prototype.unshiftRows = function(rows) { - this.rowsArray.unshift.apply(this.rowsArray, rows); -}; - -/** - * Remove the last row from the screen and return it. - * - * @return {HTMLElement} The last row in this screen. - */ -hterm.Screen.prototype.popRow = function() { - return this.popRows(1)[0]; -}; - -/** - * Remove rows from the bottom of the screen and return them as an array. - * - * @param {integer} count The number of rows to remove. - * @return {Array.} The selected rows. - */ -hterm.Screen.prototype.popRows = function(count) { - return this.rowsArray.splice(this.rowsArray.length - count, count); -}; - -/** - * Insert a row at the bottom of the screen. - * - * @param {HTMLElement} row The row to insert. - */ -hterm.Screen.prototype.pushRow = function(row) { - this.rowsArray.push(row); -}; - -/** - * Insert rows at the bottom of the screen. - * - * @param {Array.} rows The rows to insert. - */ -hterm.Screen.prototype.pushRows = function(rows) { - rows.push.apply(this.rowsArray, rows); -}; - -/** - * Insert a row at the specified row of the screen. - * - * @param {integer} index The index to insert the row. - * @param {HTMLElement} row The row to insert. - */ -hterm.Screen.prototype.insertRow = function(index, row) { - this.rowsArray.splice(index, 0, row); -}; - -/** - * Insert rows at the specified row of the screen. - * - * @param {integer} index The index to insert the rows. - * @param {Array.} rows The rows to insert. - */ -hterm.Screen.prototype.insertRows = function(index, rows) { - for (var i = 0; i < rows.length; i++) { - this.rowsArray.splice(index + i, 0, rows[i]); - } -}; - -/** - * Remove a row from the screen and return it. - * - * @param {integer} index The index of the row to remove. - * @return {HTMLElement} The selected row. - */ -hterm.Screen.prototype.removeRow = function(index) { - return this.rowsArray.splice(index, 1)[0]; -}; - -/** - * Remove rows from the bottom of the screen and return them as an array. - * - * @param {integer} index The index to start removing rows. - * @param {integer} count The number of rows to remove. - * @return {Array.} The selected rows. - */ -hterm.Screen.prototype.removeRows = function(index, count) { - return this.rowsArray.splice(index, count); -}; - -/** - * Invalidate the current cursor position. - * - * This sets this.cursorPosition to (0, 0) and clears out some internal - * data. - * - * Attempting to insert or overwrite text while the cursor position is invalid - * will raise an obscure exception. - */ -hterm.Screen.prototype.invalidateCursorPosition = function() { - this.cursorPosition.move(0, 0); - this.cursorRowNode_ = null; - this.cursorNode_ = null; - this.cursorOffset_ = null; -}; - -/** - * Clear the contents of the cursor row. - */ -hterm.Screen.prototype.clearCursorRow = function() { - this.cursorRowNode_.innerHTML = ''; - this.cursorRowNode_.removeAttribute('line-overflow'); - this.cursorOffset_ = 0; - this.cursorPosition.column = 0; - this.cursorPosition.overflow = false; - - var text; - if (this.textAttributes.isDefault()) { - text = ''; - } else { - text = lib.f.getWhitespace(this.columnCount_); - } - - // We shouldn't honor inverse colors when clearing an area, to match - // xterm's back color erase behavior. - var inverse = this.textAttributes.inverse; - this.textAttributes.inverse = false; - this.textAttributes.syncColors(); - - var node = this.textAttributes.createContainer(text); - this.cursorRowNode_.appendChild(node); - this.cursorNode_ = node; - - this.textAttributes.inverse = inverse; - this.textAttributes.syncColors(); -}; - -/** - * Mark the current row as having overflowed to the next line. - * - * The line overflow state is used when converting a range of rows into text. - * It makes it possible to recombine two or more overflow terminal rows into - * a single line. - * - * This is distinct from the cursor being in the overflow state. Cursor - * overflow indicates that printing at the cursor position will commit a - * line overflow, unless it is preceded by a repositioning of the cursor - * to a non-overflow state. - */ -hterm.Screen.prototype.commitLineOverflow = function() { - this.cursorRowNode_.setAttribute('line-overflow', true); -}; - -/** - * Relocate the cursor to a give row and column. - * - * @param {integer} row The zero based row. - * @param {integer} column The zero based column. - */ -hterm.Screen.prototype.setCursorPosition = function(row, column) { - if (!this.rowsArray.length) { - console.warn('Attempt to set cursor position on empty screen.'); - return; - } - - if (row >= this.rowsArray.length) { - console.error('Row out of bounds: ' + row); - row = this.rowsArray.length - 1; - } else if (row < 0) { - console.error('Row out of bounds: ' + row); - row = 0; - } - - if (column >= this.columnCount_) { - console.error('Column out of bounds: ' + column); - column = this.columnCount_ - 1; - } else if (column < 0) { - console.error('Column out of bounds: ' + column); - column = 0; - } - - this.cursorPosition.overflow = false; - - var rowNode = this.rowsArray[row]; - var node = rowNode.firstChild; - - if (!node) { - node = rowNode.ownerDocument.createTextNode(''); - rowNode.appendChild(node); - } - - var currentColumn = 0; - - if (rowNode == this.cursorRowNode_) { - if (column >= this.cursorPosition.column - this.cursorOffset_) { - node = this.cursorNode_; - currentColumn = this.cursorPosition.column - this.cursorOffset_; - } - } else { - this.cursorRowNode_ = rowNode; - } - - this.cursorPosition.move(row, column); - - while (node) { - var offset = column - currentColumn; - var width = hterm.TextAttributes.nodeWidth(node); - if (!node.nextSibling || width > offset) { - this.cursorNode_ = node; - this.cursorOffset_ = offset; - return; - } - - currentColumn += width; - node = node.nextSibling; - } -}; - -/** - * Set the provided selection object to be a caret selection at the current - * cursor position. - */ -hterm.Screen.prototype.syncSelectionCaret = function(selection) { - try { - selection.collapse(this.cursorNode_, this.cursorOffset_); - } catch (firefoxIgnoredException) { - // FF can throw an exception if the range is off, rather than just not - // performing the collapse. - } -}; - -/** - * Split a single node into two nodes at the given offset. - * - * For example: - * Given the DOM fragment '
Hello World
', call splitNode_ - * passing the span and an offset of 6. This would modify the fragment to - * become: '
Hello World
'. If the span - * had any attributes they would have been copied to the new span as well. - * - * The to-be-split node must have a container, so that the new node can be - * placed next to it. - * - * @param {HTMLNode} node The node to split. - * @param {integer} offset The offset into the node where the split should - * occur. - */ -hterm.Screen.prototype.splitNode_ = function(node, offset) { - var afterNode = node.cloneNode(false); - - var textContent = node.textContent; - node.textContent = hterm.TextAttributes.nodeSubstr(node, 0, offset); - afterNode.textContent = lib.wc.substr(textContent, offset); - - if (afterNode.textContent) - node.parentNode.insertBefore(afterNode, node.nextSibling); - if (!node.textContent) - node.parentNode.removeChild(node); -}; - -/** - * Ensure that text is clipped and the cursor is clamped to the column count. - */ -hterm.Screen.prototype.maybeClipCurrentRow = function() { - var width = hterm.TextAttributes.nodeWidth(this.cursorRowNode_); - - if (width <= this.columnCount_) { - // Current row does not need clipping, but may need clamping. - if (this.cursorPosition.column >= this.columnCount_) { - this.setCursorPosition(this.cursorPosition.row, this.columnCount_ - 1); - this.cursorPosition.overflow = true; - } - - return; - } - - // Save off the current column so we can maybe restore it later. - var currentColumn = this.cursorPosition.column; - - // Move the cursor to the final column. - this.setCursorPosition(this.cursorPosition.row, this.columnCount_ - 1); - - // Remove any text that partially overflows. - width = hterm.TextAttributes.nodeWidth(this.cursorNode_); - - if (this.cursorOffset_ < width - 1) { - this.cursorNode_.textContent = hterm.TextAttributes.nodeSubstr( - this.cursorNode_, 0, this.cursorOffset_ + 1); - } - - // Remove all nodes after the cursor. - var rowNode = this.cursorRowNode_; - var node = this.cursorNode_.nextSibling; - - while (node) { - rowNode.removeChild(node); - node = this.cursorNode_.nextSibling; - } - - if (currentColumn < this.columnCount_) { - // If the cursor was within the screen before we started then restore its - // position. - this.setCursorPosition(this.cursorPosition.row, currentColumn); - } else { - // Otherwise leave it at the the last column in the overflow state. - this.cursorPosition.overflow = true; - } -}; - -/** - * Insert a string at the current character position using the current - * text attributes. - * - * You must call maybeClipCurrentRow() after in order to clip overflowed - * text and clamp the cursor. - * - * It is also up to the caller to properly maintain the line overflow state - * using hterm.Screen..commitLineOverflow(). - */ -hterm.Screen.prototype.insertString = function(str, wcwidth=undefined) { - var cursorNode = this.cursorNode_; - var cursorNodeText = cursorNode.textContent; - - this.cursorRowNode_.removeAttribute('line-overflow'); - - // We may alter the width of the string by prepending some missing - // whitespaces, so we need to record the string width ahead of time. - if (wcwidth === undefined) - wcwidth = lib.wc.strWidth(str); - - // No matter what, before this function exits the cursor column will have - // moved this much. - this.cursorPosition.column += wcwidth; - - // Local cache of the cursor offset. - var offset = this.cursorOffset_; - - // Reverse offset is the offset measured from the end of the string. - // Zero implies that the cursor is at the end of the cursor node. - var reverseOffset = hterm.TextAttributes.nodeWidth(cursorNode) - offset; - - if (reverseOffset < 0) { - // A negative reverse offset means the cursor is positioned past the end - // of the characters on this line. We'll need to insert the missing - // whitespace. - var ws = lib.f.getWhitespace(-reverseOffset); - - // This whitespace should be completely unstyled. Underline, background - // color, and strikethrough would be visible on whitespace, so we can't use - // one of those spans to hold the text. - if (!(this.textAttributes.underline || - this.textAttributes.strikethrough || - this.textAttributes.background || - this.textAttributes.wcNode || - !this.textAttributes.asciiNode || - this.textAttributes.tileData != null)) { - // Best case scenario, we can just pretend the spaces were part of the - // original string. - str = ws + str; - } else if (cursorNode.nodeType == Node.TEXT_NODE || - !(cursorNode.wcNode || - !cursorNode.asciiNode || - cursorNode.tileNode || - cursorNode.style.textDecoration || - cursorNode.style.textDecorationStyle || - cursorNode.style.textDecorationLine || - cursorNode.style.backgroundColor)) { - // Second best case, the current node is able to hold the whitespace. - cursorNode.textContent = (cursorNodeText += ws); - } else { - // Worst case, we have to create a new node to hold the whitespace. - var wsNode = cursorNode.ownerDocument.createTextNode(ws); - this.cursorRowNode_.insertBefore(wsNode, cursorNode.nextSibling); - this.cursorNode_ = cursorNode = wsNode; - this.cursorOffset_ = offset = -reverseOffset; - cursorNodeText = ws; - } - - // We now know for sure that we're at the last character of the cursor node. - reverseOffset = 0; - } - - if (this.textAttributes.matchesContainer(cursorNode)) { - // The new text can be placed directly in the cursor node. - if (reverseOffset == 0) { - cursorNode.textContent = cursorNodeText + str; - } else if (offset == 0) { - cursorNode.textContent = str + cursorNodeText; - } else { - cursorNode.textContent = - hterm.TextAttributes.nodeSubstr(cursorNode, 0, offset) + - str + hterm.TextAttributes.nodeSubstr(cursorNode, offset); - } - - this.cursorOffset_ += wcwidth; - return; - } - - // The cursor node is the wrong style for the new text. If we're at the - // beginning or end of the cursor node, then the adjacent node is also a - // potential candidate. - - if (offset == 0) { - // At the beginning of the cursor node, the check the previous sibling. - var previousSibling = cursorNode.previousSibling; - if (previousSibling && - this.textAttributes.matchesContainer(previousSibling)) { - previousSibling.textContent += str; - this.cursorNode_ = previousSibling; - this.cursorOffset_ = lib.wc.strWidth(previousSibling.textContent); - return; - } - - var newNode = this.textAttributes.createContainer(str); - this.cursorRowNode_.insertBefore(newNode, cursorNode); - this.cursorNode_ = newNode; - this.cursorOffset_ = wcwidth; - return; - } - - if (reverseOffset == 0) { - // At the end of the cursor node, the check the next sibling. - var nextSibling = cursorNode.nextSibling; - if (nextSibling && - this.textAttributes.matchesContainer(nextSibling)) { - nextSibling.textContent = str + nextSibling.textContent; - this.cursorNode_ = nextSibling; - this.cursorOffset_ = lib.wc.strWidth(str); - return; - } - - var newNode = this.textAttributes.createContainer(str); - this.cursorRowNode_.insertBefore(newNode, nextSibling); - this.cursorNode_ = newNode; - // We specifically need to include any missing whitespace here, since it's - // going in a new node. - this.cursorOffset_ = hterm.TextAttributes.nodeWidth(newNode); - return; - } - - // Worst case, we're somewhere in the middle of the cursor node. We'll - // have to split it into two nodes and insert our new container in between. - this.splitNode_(cursorNode, offset); - var newNode = this.textAttributes.createContainer(str); - this.cursorRowNode_.insertBefore(newNode, cursorNode.nextSibling); - this.cursorNode_ = newNode; - this.cursorOffset_ = wcwidth; -}; - -/** - * Overwrite the text at the current cursor position. - * - * You must call maybeClipCurrentRow() after in order to clip overflowed - * text and clamp the cursor. - * - * It is also up to the caller to properly maintain the line overflow state - * using hterm.Screen..commitLineOverflow(). - */ -hterm.Screen.prototype.overwriteString = function(str, wcwidth=undefined) { - var maxLength = this.columnCount_ - this.cursorPosition.column; - if (!maxLength) - return [str]; - - if (wcwidth === undefined) - wcwidth = lib.wc.strWidth(str); - - if (this.textAttributes.matchesContainer(this.cursorNode_) && - this.cursorNode_.textContent.substr(this.cursorOffset_) == str) { - // This overwrite would be a no-op, just move the cursor and return. - this.cursorOffset_ += wcwidth; - this.cursorPosition.column += wcwidth; - return; - } - - this.deleteChars(Math.min(wcwidth, maxLength)); - this.insertString(str, wcwidth); -}; - -/** - * Forward-delete one or more characters at the current cursor position. - * - * Text to the right of the deleted characters is shifted left. Only affects - * characters on the same row as the cursor. - * - * @param {integer} count The column width of characters to delete. This is - * clamped to the column width minus the cursor column. - * @return {integer} The column width of the characters actually deleted. - */ -hterm.Screen.prototype.deleteChars = function(count) { - var node = this.cursorNode_; - var offset = this.cursorOffset_; - - var currentCursorColumn = this.cursorPosition.column; - count = Math.min(count, this.columnCount_ - currentCursorColumn); - if (!count) - return 0; - - var rv = count; - var startLength, endLength; - - while (node && count) { - // Sanity check so we don't loop forever, but we don't also go quietly. - if (count < 0) { - console.error(`Deleting ${rv} chars went negative: ${count}`); - break; - } - - startLength = hterm.TextAttributes.nodeWidth(node); - node.textContent = hterm.TextAttributes.nodeSubstr(node, 0, offset) + - hterm.TextAttributes.nodeSubstr(node, offset + count); - endLength = hterm.TextAttributes.nodeWidth(node); - - // Deal with splitting wide characters. There are two ways: we could delete - // the first column or the second column. In both cases, we delete the wide - // character and replace one of the columns with a space (since the other - // was deleted). If there are more chars to delete, the next loop will pick - // up the slack. - if (node.wcNode && offset < startLength && - ((endLength && startLength == endLength) || (!endLength && offset == 1))) { - // No characters were deleted when there should be. We're probably trying - // to delete one column width from a wide character node. We remove the - // wide character node here and replace it with a single space. - var spaceNode = this.textAttributes.createContainer(' '); - node.parentNode.insertBefore(spaceNode, offset ? node : node.nextSibling); - node.textContent = ''; - endLength = 0; - count -= 1; - } else - count -= startLength - endLength; - - var nextNode = node.nextSibling; - if (endLength == 0 && node != this.cursorNode_) { - node.parentNode.removeChild(node); - } - node = nextNode; - offset = 0; - } - - // Remove this.cursorNode_ if it is an empty non-text node. - if (this.cursorNode_.nodeType != Node.TEXT_NODE && - !this.cursorNode_.textContent) { - var cursorNode = this.cursorNode_; - if (cursorNode.previousSibling) { - this.cursorNode_ = cursorNode.previousSibling; - this.cursorOffset_ = hterm.TextAttributes.nodeWidth( - cursorNode.previousSibling); - } else if (cursorNode.nextSibling) { - this.cursorNode_ = cursorNode.nextSibling; - this.cursorOffset_ = 0; - } else { - var emptyNode = this.cursorRowNode_.ownerDocument.createTextNode(''); - this.cursorRowNode_.appendChild(emptyNode); - this.cursorNode_ = emptyNode; - this.cursorOffset_ = 0; - } - this.cursorRowNode_.removeChild(cursorNode); - } - - return rv; -}; - -/** - * Finds first X-ROW of a line containing specified X-ROW. - * Used to support line overflow. - * - * @param {Node} row X-ROW to begin search for first row of line. - * @return {Node} The X-ROW that is at the beginning of the line. - **/ -hterm.Screen.prototype.getLineStartRow_ = function(row) { - while (row.previousSibling && - row.previousSibling.hasAttribute('line-overflow')) { - row = row.previousSibling; - } - return row; -}; - -/** - * Gets text of a line beginning with row. - * Supports line overflow. - * - * @param {Node} row First X-ROW of line. - * @return {string} Text content of line. - **/ -hterm.Screen.prototype.getLineText_ = function(row) { - var rowText = ""; - while (row) { - rowText += row.textContent; - if (row.hasAttribute('line-overflow')) { - row = row.nextSibling; - } else { - break; - } - } - return rowText; -}; - -/** - * Returns X-ROW that is ancestor of the node. - * - * @param {Node} node Node to get X-ROW ancestor for. - * @return {Node} X-ROW ancestor of node, or null if not found. - **/ -hterm.Screen.prototype.getXRowAncestor_ = function(node) { - while (node) { - if (node.nodeName === 'X-ROW') - break; - node = node.parentNode; - } - return node; -}; - -/** - * Returns position within line of character at offset within node. - * Supports line overflow. - * - * @param {Node} row X-ROW at beginning of line. - * @param {Node} node Node to get position of. - * @param {integer} offset Offset into node. - * - * @return {integer} Position within line of character at offset within node. - **/ -hterm.Screen.prototype.getPositionWithOverflow_ = function(row, node, offset) { - if (!node) - return -1; - var ancestorRow = this.getXRowAncestor_(node); - if (!ancestorRow) - return -1; - var position = 0; - while (ancestorRow != row) { - position += hterm.TextAttributes.nodeWidth(row); - if (row.hasAttribute('line-overflow') && row.nextSibling) { - row = row.nextSibling; - } else { - return -1; - } - } - return position + this.getPositionWithinRow_(row, node, offset); -}; - -/** - * Returns position within row of character at offset within node. - * Does not support line overflow. - * - * @param {Node} row X-ROW to get position within. - * @param {Node} node Node to get position for. - * @param {integer} offset Offset within node to get position for. - * @return {integer} Position within row of character at offset within node. - **/ -hterm.Screen.prototype.getPositionWithinRow_ = function(row, node, offset) { - if (node.parentNode != row) { - // If we traversed to the top node, then there's nothing to find here. - if (node.parentNode == null) - return -1; - - return this.getPositionWithinRow_(node.parentNode, node, offset) + - this.getPositionWithinRow_(row, node.parentNode, 0); - } - var position = 0; - for (var i = 0; i < row.childNodes.length; i++) { - var currentNode = row.childNodes[i]; - if (currentNode == node) - return position + offset; - position += hterm.TextAttributes.nodeWidth(currentNode); - } - return -1; -}; - -/** - * Returns the node and offset corresponding to position within line. - * Supports line overflow. - * - * @param {Node} row X-ROW at beginning of line. - * @param {integer} position Position within line to retrieve node and offset. - * @return {Array} Two element array containing node and offset respectively. - **/ -hterm.Screen.prototype.getNodeAndOffsetWithOverflow_ = function(row, position) { - while (row && position > hterm.TextAttributes.nodeWidth(row)) { - if (row.hasAttribute('line-overflow') && row.nextSibling) { - position -= hterm.TextAttributes.nodeWidth(row); - row = row.nextSibling; - } else { - return -1; - } - } - return this.getNodeAndOffsetWithinRow_(row, position); -}; - -/** - * Returns the node and offset corresponding to position within row. - * Does not support line overflow. - * - * @param {Node} row X-ROW to get position within. - * @param {integer} position Position within row to retrieve node and offset. - * @return {Array} Two element array containing node and offset respectively. - **/ -hterm.Screen.prototype.getNodeAndOffsetWithinRow_ = function(row, position) { - for (var i = 0; i < row.childNodes.length; i++) { - var node = row.childNodes[i]; - var nodeTextWidth = hterm.TextAttributes.nodeWidth(node); - if (position <= nodeTextWidth) { - if (node.nodeName === 'SPAN') { - /** Drill down to node contained by SPAN. **/ - return this.getNodeAndOffsetWithinRow_(node, position); - } else { - return [node, position]; - } - } - position -= nodeTextWidth; - } - return null; -}; - -/** - * Returns the node and offset corresponding to position within line. - * Supports line overflow. - * - * @param {Node} row X-ROW at beginning of line. - * @param {integer} start Start position of range within line. - * @param {integer} end End position of range within line. - * @param {Range} range Range to modify. - **/ -hterm.Screen.prototype.setRange_ = function(row, start, end, range) { - var startNodeAndOffset = this.getNodeAndOffsetWithOverflow_(row, start); - if (startNodeAndOffset == null) - return; - var endNodeAndOffset = this.getNodeAndOffsetWithOverflow_(row, end); - if (endNodeAndOffset == null) - return; - range.setStart(startNodeAndOffset[0], startNodeAndOffset[1]); - range.setEnd(endNodeAndOffset[0], endNodeAndOffset[1]); -}; - -/** - * Expands selection to surround URLs. - * - * @param {Selection} selection Selection to expand. - **/ -hterm.Screen.prototype.expandSelection = function(selection) { - if (!selection) - return; - - var range = selection.getRangeAt(0); - if (!range || range.toString().match(/\s/)) - return; - - var row = this.getLineStartRow_(this.getXRowAncestor_(range.startContainer)); - if (!row) - return; - - var startPosition = this.getPositionWithOverflow_(row, - range.startContainer, - range.startOffset); - if (startPosition == -1) - return; - var endPosition = this.getPositionWithOverflow_(row, - range.endContainer, - range.endOffset); - if (endPosition == -1) - return; - - // Use the user configurable match settings. - var leftMatch = this.wordBreakMatchLeft; - var rightMatch = this.wordBreakMatchRight; - var insideMatch = this.wordBreakMatchMiddle; - - //Move start to the left. - var rowText = this.getLineText_(row); - var lineUpToRange = lib.wc.substring(rowText, 0, endPosition); - var leftRegularExpression = new RegExp(leftMatch + insideMatch + "$"); - var expandedStart = lineUpToRange.search(leftRegularExpression); - if (expandedStart == -1 || expandedStart > startPosition) - return; - - //Move end to the right. - var lineFromRange = lib.wc.substring(rowText, startPosition, - lib.wc.strWidth(rowText)); - var rightRegularExpression = new RegExp("^" + insideMatch + rightMatch); - var found = lineFromRange.match(rightRegularExpression); - if (!found) - return; - var expandedEnd = startPosition + lib.wc.strWidth(found[0]); - if (expandedEnd == -1 || expandedEnd < endPosition) - return; - - this.setRange_(row, expandedStart, expandedEnd, range); - selection.addRange(range); -}; - -/** - * Save the current cursor state to the corresponding screens. - * - * @param {hterm.VT} vt The VT object to read graphic codeset details from. - */ -hterm.Screen.prototype.saveCursorAndState = function(vt) { - this.cursorState_.save(vt); -}; - -/** - * Restore the saved cursor state in the corresponding screens. - * - * @param {hterm.VT} vt The VT object to write graphic codeset details to. - */ -hterm.Screen.prototype.restoreCursorAndState = function(vt) { - this.cursorState_.restore(vt); -}; - -/** - * Track all the things related to the current "cursor". - * - * The set of things saved & restored here is defined by DEC: - * https://vt100.net/docs/vt510-rm/DECSC.html - * - Cursor position - * - Character attributes set by the SGR command - * - Character sets (G0, G1, G2, or G3) currently in GL and GR - * - Wrap flag (autowrap or no autowrap) - * - State of origin mode (DECOM) - * - Selective erase attribute - * - Any single shift 2 (SS2) or single shift 3 (SS3) functions sent - * - * These are done on a per-screen basis. - */ -hterm.Screen.CursorState = function(screen) { - this.screen_ = screen; - this.cursor = null; - this.textAttributes = null; - this.GL = this.GR = this.G0 = this.G1 = this.G2 = this.G3 = null; -}; - -/** - * Save all the cursor state. - * - * @param {hterm.VT} vt The VT object to read graphic codeset details from. - */ -hterm.Screen.CursorState.prototype.save = function(vt) { - this.cursor = vt.terminal.saveCursor(); - - this.textAttributes = this.screen_.textAttributes.clone(); - - this.GL = vt.GL; - this.GR = vt.GR; - - this.G0 = vt.G0; - this.G1 = vt.G1; - this.G2 = vt.G2; - this.G3 = vt.G3; -}; - -/** - * Restore the previously saved cursor state. - * - * @param {hterm.VT} vt The VT object to write graphic codeset details to. - */ -hterm.Screen.CursorState.prototype.restore = function(vt) { - vt.terminal.restoreCursor(this.cursor); - - // Cursor restore includes char attributes (bold/etc...), but does not change - // the color palette (which are a terminal setting). - const tattrs = this.textAttributes.clone(); - tattrs.colorPalette = this.screen_.textAttributes.colorPalette; - tattrs.syncColors(); - - this.screen_.textAttributes = tattrs; - - vt.GL = this.GL; - vt.GR = this.GR; - - vt.G0 = this.G0; - vt.G1 = this.G1; - vt.G2 = this.G2; - vt.G3 = this.G3; -}; -// SOURCE FILE: hterm/js/hterm_scrollport.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.f', 'hterm.PubSub', 'hterm.Size'); - -/** - * A 'viewport' view of fixed-height rows with support for selection and - * copy-to-clipboard. - * - * 'Viewport' in this case means that only the visible rows are in the DOM. - * If the rowProvider has 100,000 rows, but the ScrollPort is only 25 rows - * tall, then only 25 dom nodes are created. The ScrollPort will ask the - * RowProvider to create new visible rows on demand as they are scrolled in - * to the visible area. - * - * This viewport is designed so that select and copy-to-clipboard still works, - * even when all or part of the selection is scrolled off screen. - * - * Note that the X11 mouse clipboard does not work properly when all or part - * of the selection is off screen. It would be difficult to fix this without - * adding significant overhead to pathologically large selection cases. - * - * The RowProvider should return rows rooted by the custom tag name 'x-row'. - * This ensures that we can quickly assign the correct display height - * to the rows with css. - * - * @param {RowProvider} rowProvider An object capable of providing rows as - * raw text or row nodes. - */ -hterm.ScrollPort = function(rowProvider) { - hterm.PubSub.addBehavior(this); - - this.rowProvider_ = rowProvider; - - // SWAG the character size until we can measure it. - this.characterSize = new hterm.Size(10, 10); - - // DOM node used for character measurement. - this.ruler_ = null; - - this.selection = new hterm.ScrollPort.Selection(this); - - // A map of rowIndex => rowNode for each row that is drawn as part of a - // pending redraw_() call. Null if there is no pending redraw_ call. - this.currentRowNodeCache_ = null; - - // A map of rowIndex => rowNode for each row that was drawn as part of the - // previous redraw_() call. - this.previousRowNodeCache_ = {}; - - // Used during scroll events to detect when the underlying cause is a resize. - this.lastScreenWidth_ = null; - this.lastScreenHeight_ = null; - - // True if the user should be allowed to select text in the terminal. - // This is disabled when the host requests mouse drag events so that we don't - // end up with two notions of selection. - this.selectionEnabled_ = true; - - // The last row count returned by the row provider, re-populated during - // syncScrollHeight(). - this.lastRowCount_ = 0; - - // The scroll wheel pixel delta multiplier to increase/decrease - // the scroll speed of mouse wheel events. See: https://goo.gl/sXelnq - this.scrollWheelMultiplier_ = 1; - - // The last touch events we saw to support touch based scrolling. Indexed - // by touch identifier since we can have more than one touch active. - this.lastTouch_ = {}; - - /** - * True if the last scroll caused the scrollport to show the final row. - */ - this.isScrolledEnd = true; - - /** - * A guess at the current scrollbar width, fixed in resize(). - */ - this.currentScrollbarWidthPx = 16; - - /** - * Whether the ctrl-v key on the screen should paste. - */ - this.ctrlVPaste = false; - - this.div_ = null; - this.document_ = null; - - // Collection of active timeout handles. - this.timeouts_ = {}; - - this.observers_ = {}; - - this.DEBUG_ = false; -} - -/** - * Proxy for the native selection object which understands how to walk up the - * DOM to find the containing row node and sort out which comes first. - * - * @param {hterm.ScrollPort} scrollPort The parent hterm.ScrollPort instance. - */ -hterm.ScrollPort.Selection = function(scrollPort) { - this.scrollPort_ = scrollPort; - - /** - * The row containing the start of the selection. - * - * This may be partially or fully selected. It may be the selection anchor - * or the focus, but its rowIndex is guaranteed to be less-than-or-equal-to - * that of the endRow. - * - * If only one row is selected then startRow == endRow. If there is no - * selection or the selection is collapsed then startRow == null. - */ - this.startRow = null; - - /** - * The row containing the end of the selection. - * - * This may be partially or fully selected. It may be the selection anchor - * or the focus, but its rowIndex is guaranteed to be greater-than-or-equal-to - * that of the startRow. - * - * If only one row is selected then startRow == endRow. If there is no - * selection or the selection is collapsed then startRow == null. - */ - this.endRow = null; - - /** - * True if startRow != endRow. - */ - this.isMultiline = null; - - /** - * True if the selection is just a point rather than a range. - */ - this.isCollapsed = null; -}; - -/** - * Given a list of DOM nodes and a container, return the DOM node that - * is first according to a depth-first search. - * - * Returns null if none of the children are found. - */ -hterm.ScrollPort.Selection.prototype.findFirstChild = function( - parent, childAry) { - var node = parent.firstChild; - - while (node) { - if (childAry.indexOf(node) != -1) - return node; - - if (node.childNodes.length) { - var rv = this.findFirstChild(node, childAry); - if (rv) - return rv; - } - - node = node.nextSibling; - } - - return null; -}; - -/** - * Synchronize this object with the current DOM selection. - * - * This is a one-way synchronization, the DOM selection is copied to this - * object, not the other way around. - */ -hterm.ScrollPort.Selection.prototype.sync = function() { - var self = this; - - // The dom selection object has no way to tell which nodes come first in - // the document, so we have to figure that out. - // - // This function is used when we detect that the "anchor" node is first. - function anchorFirst() { - self.startRow = anchorRow; - self.startNode = selection.anchorNode; - self.startOffset = selection.anchorOffset; - self.endRow = focusRow; - self.endNode = selection.focusNode; - self.endOffset = selection.focusOffset; - } - - // This function is used when we detect that the "focus" node is first. - function focusFirst() { - self.startRow = focusRow; - self.startNode = selection.focusNode; - self.startOffset = selection.focusOffset; - self.endRow = anchorRow; - self.endNode = selection.anchorNode; - self.endOffset = selection.anchorOffset; - } - - var selection = this.scrollPort_.getDocument().getSelection(); - - this.startRow = null; - this.endRow = null; - this.isMultiline = null; - this.isCollapsed = !selection || selection.isCollapsed; - - if (this.isCollapsed) - return; - - var anchorRow = selection.anchorNode; - while (anchorRow && !('rowIndex' in anchorRow)) { - anchorRow = anchorRow.parentNode; - } - - if (!anchorRow) { - console.error('Selection anchor is not rooted in a row node: ' + - selection.anchorNode.nodeName); - return; - } - - var focusRow = selection.focusNode; - while (focusRow && !('rowIndex' in focusRow)) { - focusRow = focusRow.parentNode; - } - - if (!focusRow) { - console.error('Selection focus is not rooted in a row node: ' + - selection.focusNode.nodeName); - return; - } - - if (anchorRow.rowIndex < focusRow.rowIndex) { - anchorFirst(); - - } else if (anchorRow.rowIndex > focusRow.rowIndex) { - focusFirst(); - - } else if (selection.focusNode == selection.anchorNode) { - if (selection.anchorOffset < selection.focusOffset) { - anchorFirst(); - } else { - focusFirst(); - } - - } else { - // The selection starts and ends in the same row, but isn't contained all - // in a single node. - var firstNode = this.findFirstChild( - anchorRow, [selection.anchorNode, selection.focusNode]); - - if (!firstNode) - throw new Error('Unexpected error syncing selection.'); - - if (firstNode == selection.anchorNode) { - anchorFirst(); - } else { - focusFirst(); - } - } - - this.isMultiline = anchorRow.rowIndex != focusRow.rowIndex; -}; - - -/** - * Turn a div into this hterm.ScrollPort. - */ -hterm.ScrollPort.prototype.decorate = function(div) { - this.div_ = div; - - this.iframe_ = div.ownerDocument.createElement('iframe'); - this.iframe_.style.cssText = ( - 'border: 0;' + - 'height: 100%;' + - 'position: absolute;' + - 'width: 100%'); - - // Set the iframe src to # in FF. Otherwise when the frame's - // load event fires in FF it clears out the content of the iframe. - if ('mozInnerScreenX' in window) // detect a FF only property - this.iframe_.src = '#'; - - div.appendChild(this.iframe_); - - this.iframe_.contentWindow.addEventListener('resize', - this.onResize_.bind(this)); - - var doc = this.document_ = this.iframe_.contentDocument; - doc.body.style.cssText = ( - 'margin: 0px;' + - 'padding: 0px;' + - 'height: 100%;' + - 'width: 100%;' + - 'overflow: hidden;' + - 'cursor: var(--hterm-mouse-cursor-style);' + - '-webkit-user-select: none;' + - '-moz-user-select: none;'); - - const metaCharset = doc.createElement('meta'); - metaCharset.setAttribute('charset', 'utf-8'); - doc.head.appendChild(metaCharset); - - if (this.DEBUG_) { - // When we're debugging we add padding to the body so that the offscreen - // elements are visible. - this.document_.body.style.paddingTop = - this.document_.body.style.paddingBottom = - 'calc(var(--hterm-charsize-height) * 3)'; - } - - var style = doc.createElement('style'); - style.textContent = ( - 'x-row {' + - ' display: block;' + - ' height: var(--hterm-charsize-height);' + - ' line-height: var(--hterm-charsize-height);' + - '}'); - doc.head.appendChild(style); - - this.userCssLink_ = doc.createElement('link'); - this.userCssLink_.setAttribute('rel', 'stylesheet'); - - this.userCssText_ = doc.createElement('style'); - doc.head.appendChild(this.userCssText_); - - // TODO(rginda): Sorry, this 'screen_' isn't the same thing as hterm.Screen - // from screen.js. I need to pick a better name for one of them to avoid - // the collision. - // We make this field editable even though we don't actually allow anything - // to be edited here so that Chrome will do the right thing with virtual - // keyboards and IMEs. But make sure we turn off all the input helper logic - // that doesn't make sense here, and might inadvertently mung or save input. - // Some of these attributes are standard while others are browser specific, - // but should be safely ignored by other browsers. - this.screen_ = doc.createElement('x-screen'); - this.screen_.setAttribute('contenteditable', 'true'); - this.screen_.setAttribute('spellcheck', 'false'); - this.screen_.setAttribute('autocomplete', 'off'); - this.screen_.setAttribute('autocorrect', 'off'); - this.screen_.setAttribute('autocapitalize', 'none'); - this.screen_.setAttribute('role', 'textbox'); - this.screen_.setAttribute('tabindex', '-1'); - this.screen_.style.cssText = ( - 'caret-color: transparent;' + - 'display: block;' + - 'font-family: monospace;' + - 'font-size: 15px;' + - 'font-variant-ligatures: none;' + - 'height: 100%;' + - 'overflow-y: scroll; overflow-x: hidden;' + - 'white-space: pre;' + - 'width: 100%;' + - 'outline: none !important'); - - doc.body.appendChild(this.screen_); - - this.screen_.addEventListener('scroll', this.onScroll_.bind(this)); - this.screen_.addEventListener('wheel', this.onScrollWheel_.bind(this)); - this.screen_.addEventListener('touchstart', this.onTouch_.bind(this)); - this.screen_.addEventListener('touchmove', this.onTouch_.bind(this)); - this.screen_.addEventListener('touchend', this.onTouch_.bind(this)); - this.screen_.addEventListener('touchcancel', this.onTouch_.bind(this)); - this.screen_.addEventListener('copy', this.onCopy_.bind(this)); - this.screen_.addEventListener('paste', this.onPaste_.bind(this)); - this.screen_.addEventListener('drop', this.onDragAndDrop_.bind(this)); - - doc.body.addEventListener('keydown', this.onBodyKeyDown_.bind(this)); - - // This is the main container for the fixed rows. - this.rowNodes_ = doc.createElement('div'); - this.rowNodes_.id = 'hterm:row-nodes'; - this.rowNodes_.style.cssText = ( - 'display: block;' + - 'position: fixed;' + - 'overflow: hidden;' + - '-webkit-user-select: text;' + - '-moz-user-select: text;'); - this.screen_.appendChild(this.rowNodes_); - - // Two nodes to hold offscreen text during the copy event. - this.topSelectBag_ = doc.createElement('x-select-bag'); - this.topSelectBag_.style.cssText = ( - 'display: block;' + - 'overflow: hidden;' + - 'height: var(--hterm-charsize-height);' + - 'white-space: pre;'); - - this.bottomSelectBag_ = this.topSelectBag_.cloneNode(); - - // Nodes above the top fold and below the bottom fold are hidden. They are - // only used to hold rows that are part of the selection but are currently - // scrolled off the top or bottom of the visible range. - this.topFold_ = doc.createElement('x-fold'); - this.topFold_.id = 'hterm:top-fold-for-row-selection'; - this.topFold_.style.cssText = 'display: block;'; - this.rowNodes_.appendChild(this.topFold_); - - this.bottomFold_ = this.topFold_.cloneNode(); - this.bottomFold_.id = 'hterm:bottom-fold-for-row-selection'; - this.rowNodes_.appendChild(this.bottomFold_); - - // This hidden div accounts for the vertical space that would be consumed by - // all the rows in the buffer if they were visible. It's what causes the - // scrollbar to appear on the 'x-screen', and it moves within the screen when - // the scrollbar is moved. - // - // It is set 'visibility: hidden' to keep the browser from trying to include - // it in the selection when a user 'drag selects' upwards (drag the mouse to - // select and scroll at the same time). Without this, the selection gets - // out of whack. - this.scrollArea_ = doc.createElement('div'); - this.scrollArea_.id = 'hterm:scrollarea'; - this.scrollArea_.style.cssText = 'visibility: hidden'; - this.screen_.appendChild(this.scrollArea_); - - // This svg element is used to detect when the browser is zoomed. It must be - // placed in the outermost document for currentScale to be correct. - // TODO(rginda): This means that hterm nested in an iframe will not correctly - // detect browser zoom level. We should come up with a better solution. - // Note: This must be http:// else Chrome cannot create the element correctly. - var xmlns = 'http://www.w3.org/2000/svg'; - this.svg_ = this.div_.ownerDocument.createElementNS(xmlns, 'svg'); - this.svg_.id = 'hterm:zoom-detector'; - this.svg_.setAttribute('xmlns', xmlns); - this.svg_.setAttribute('version', '1.1'); - this.svg_.style.cssText = ( - 'position: absolute;' + - 'top: 0;' + - 'left: 0;' + - 'visibility: hidden'); - - - // We send focus to this element just before a paste happens, so we can - // capture the pasted text and forward it on to someone who cares. - this.pasteTarget_ = doc.createElement('textarea'); - this.pasteTarget_.id = 'hterm:ctrl-v-paste-target'; - this.pasteTarget_.setAttribute('tabindex', '-1'); - this.pasteTarget_.style.cssText = ( - 'position: absolute;' + - 'height: 1px;' + - 'width: 1px;' + - 'left: 0px; ' + - 'bottom: 0px;' + - 'opacity: 0'); - this.pasteTarget_.contentEditable = true; - - this.screen_.appendChild(this.pasteTarget_); - this.pasteTarget_.addEventListener( - 'textInput', this.handlePasteTargetTextInput_.bind(this)); - - this.resize(); -}; - -/** - * Select the font-family and font-smoothing for this scrollport. - * - * @param {string} fontFamily Value of the CSS 'font-family' to use for this - * scrollport. Should be a monospace font. - * @param {string} opt_smoothing Optional value for '-webkit-font-smoothing'. - * Defaults to an empty string if not specified. - */ -hterm.ScrollPort.prototype.setFontFamily = function(fontFamily, opt_smoothing) { - this.screen_.style.fontFamily = fontFamily; - if (opt_smoothing) { - this.screen_.style.webkitFontSmoothing = opt_smoothing; - } else { - this.screen_.style.webkitFontSmoothing = ''; - } - - this.syncCharacterSize(); -}; - -hterm.ScrollPort.prototype.getFontFamily = function() { - return this.screen_.style.fontFamily; -}; - -/** - * Set a custom stylesheet to include in the scrollport. - * - * Defaults to null, meaning no custom css is loaded. Set it back to null or - * the empty string to remove a previously applied custom css. - */ -hterm.ScrollPort.prototype.setUserCssUrl = function(url) { - if (url) { - this.userCssLink_.setAttribute('href', url); - - if (!this.userCssLink_.parentNode) - this.document_.head.appendChild(this.userCssLink_); - } else if (this.userCssLink_.parentNode) { - this.document_.head.removeChild(this.userCssLink_); - } -}; - -hterm.ScrollPort.prototype.setUserCssText = function(text) { - this.userCssText_.textContent = text; -}; - -hterm.ScrollPort.prototype.focus = function() { - this.iframe_.focus(); - this.screen_.focus(); -}; - -hterm.ScrollPort.prototype.getForegroundColor = function() { - return this.screen_.style.color; -}; - -hterm.ScrollPort.prototype.setForegroundColor = function(color) { - this.screen_.style.color = color; -}; - -hterm.ScrollPort.prototype.getBackgroundColor = function() { - return this.screen_.style.backgroundColor; -}; - -hterm.ScrollPort.prototype.setBackgroundColor = function(color) { - this.screen_.style.backgroundColor = color; -}; - -hterm.ScrollPort.prototype.setBackgroundImage = function(image) { - this.screen_.style.backgroundImage = image; -}; - -hterm.ScrollPort.prototype.setBackgroundSize = function(size) { - this.screen_.style.backgroundSize = size; -}; - -hterm.ScrollPort.prototype.setBackgroundPosition = function(position) { - this.screen_.style.backgroundPosition = position; -}; - -hterm.ScrollPort.prototype.setCtrlVPaste = function(ctrlVPaste) { - this.ctrlVPaste = ctrlVPaste; -}; - -/** - * Get the usable size of the scrollport screen. - * - * The width will not include the scrollbar width. - */ -hterm.ScrollPort.prototype.getScreenSize = function() { - var size = hterm.getClientSize(this.screen_); - return { - height: size.height, - width: size.width - this.currentScrollbarWidthPx - }; -}; - -/** - * Get the usable width of the scrollport screen. - * - * This the widget width minus scrollbar width. - */ -hterm.ScrollPort.prototype.getScreenWidth = function() { - return this.getScreenSize().width ; -}; - -/** - * Get the usable height of the scrollport screen. - */ -hterm.ScrollPort.prototype.getScreenHeight = function() { - return this.getScreenSize().height; -}; - -/** - * Return the document that holds the visible rows of this hterm.ScrollPort. - */ -hterm.ScrollPort.prototype.getDocument = function() { - return this.document_; -}; - -/** - * Returns the x-screen element that holds the rows of this hterm.ScrollPort. - */ -hterm.ScrollPort.prototype.getScreenNode = function() { - return this.screen_; -}; - -/** - * Clear out any cached rowNodes. - */ -hterm.ScrollPort.prototype.resetCache = function() { - this.currentRowNodeCache_ = null; - this.previousRowNodeCache_ = {}; -}; - -/** - * Change the current rowProvider. - * - * This will clear the row cache and cause a redraw. - * - * @param {Object} rowProvider An object capable of providing the rows - * in this hterm.ScrollPort. - */ -hterm.ScrollPort.prototype.setRowProvider = function(rowProvider) { - this.resetCache(); - this.rowProvider_ = rowProvider; - this.scheduleRedraw(); -}; - -/** - * Inform the ScrollPort that the root DOM nodes for some or all of the visible - * rows are no longer valid. - * - * Specifically, this should be called if this.rowProvider_.getRowNode() now - * returns an entirely different node than it did before. It does not - * need to be called if the content of a row node is the only thing that - * changed. - * - * This skips some of the overhead of a full redraw, but should not be used - * in cases where the scrollport has been scrolled, or when the row count has - * changed. - */ -hterm.ScrollPort.prototype.invalidate = function() { - var node = this.topFold_.nextSibling; - while (node != this.bottomFold_) { - var nextSibling = node.nextSibling; - node.parentElement.removeChild(node); - node = nextSibling; - } - - this.previousRowNodeCache_ = null; - var topRowIndex = this.getTopRowIndex(); - var bottomRowIndex = this.getBottomRowIndex(topRowIndex); - - this.drawVisibleRows_(topRowIndex, bottomRowIndex); -}; - -hterm.ScrollPort.prototype.scheduleInvalidate = function() { - if (this.timeouts_.invalidate) - return; - - var self = this; - this.timeouts_.invalidate = setTimeout(function () { - delete self.timeouts_.invalidate; - self.invalidate(); - }, 0); -}; - -/** - * Set the font size of the ScrollPort. - */ -hterm.ScrollPort.prototype.setFontSize = function(px) { - this.screen_.style.fontSize = px + 'px'; - this.syncCharacterSize(); -}; - -/** - * Return the current font size of the ScrollPort. - */ -hterm.ScrollPort.prototype.getFontSize = function() { - return parseInt(this.screen_.style.fontSize); -}; - -/** - * Measure the size of a single character in pixels. - * - * @param {string} opt_weight The font weight to measure, or 'normal' if - * omitted. - * @return {hterm.Size} A new hterm.Size object. - */ -hterm.ScrollPort.prototype.measureCharacterSize = function(opt_weight) { - // Number of lines used to average the height of a single character. - var numberOfLines = 100; - // Number of chars per line used to average the width of a single character. - var lineLength = 100; - - if (!this.ruler_) { - this.ruler_ = this.document_.createElement('div'); - this.ruler_.id = 'hterm:ruler-character-size'; - this.ruler_.style.cssText = ( - 'position: absolute;' + - 'top: 0;' + - 'left: 0;' + - 'visibility: hidden;' + - 'height: auto !important;' + - 'width: auto !important;'); - - // We need to put the text in a span to make the size calculation - // work properly in Firefox - this.rulerSpan_ = this.document_.createElement('span'); - this.rulerSpan_.id = 'hterm:ruler-span-workaround'; - this.rulerSpan_.innerHTML = - ('X'.repeat(lineLength) + '\r').repeat(numberOfLines); - this.ruler_.appendChild(this.rulerSpan_); - - this.rulerBaseline_ = this.document_.createElement('span'); - this.rulerSpan_.id = 'hterm:ruler-baseline'; - // We want to collapse it on the baseline - this.rulerBaseline_.style.fontSize = '0px'; - this.rulerBaseline_.textContent = 'X'; - } - - this.rulerSpan_.style.fontWeight = opt_weight || ''; - - this.rowNodes_.appendChild(this.ruler_); - var rulerSize = hterm.getClientSize(this.rulerSpan_); - - var size = new hterm.Size(rulerSize.width / lineLength, - rulerSize.height / numberOfLines); - - this.ruler_.appendChild(this.rulerBaseline_); - size.baseline = this.rulerBaseline_.offsetTop; - this.ruler_.removeChild(this.rulerBaseline_); - - this.rowNodes_.removeChild(this.ruler_); - - this.div_.ownerDocument.body.appendChild(this.svg_); - size.zoomFactor = this.svg_.currentScale; - this.div_.ownerDocument.body.removeChild(this.svg_); - - return size; -}; - -/** - * Synchronize the character size. - * - * This will re-measure the current character size and adjust the height - * of an x-row to match. - */ -hterm.ScrollPort.prototype.syncCharacterSize = function() { - this.characterSize = this.measureCharacterSize(); - - this.resize(); -}; - -/** - * Reset dimensions and visible row count to account for a change in the - * dimensions of the 'x-screen'. - */ -hterm.ScrollPort.prototype.resize = function() { - this.currentScrollbarWidthPx = hterm.getClientWidth(this.screen_) - - this.screen_.clientWidth; - - this.syncScrollHeight(); - this.syncRowNodesDimensions_(); - - var self = this; - this.publish( - 'resize', { scrollPort: this }, - function() { - self.scrollRowToBottom(self.rowProvider_.getRowCount()); - self.scheduleRedraw(); - }); -}; - -/** - * Set the position and size of the row nodes element. - */ -hterm.ScrollPort.prototype.syncRowNodesDimensions_ = function() { - var screenSize = this.getScreenSize(); - - this.lastScreenWidth_ = screenSize.width; - this.lastScreenHeight_ = screenSize.height; - - // We don't want to show a partial row because it would be distracting - // in a terminal, so we floor any fractional row count. - this.visibleRowCount = lib.f.smartFloorDivide( - screenSize.height, this.characterSize.height); - - // Then compute the height of our integral number of rows. - var visibleRowsHeight = this.visibleRowCount * this.characterSize.height; - - // Then the difference between the screen height and total row height needs to - // be made up for as top margin. We need to record this value so it - // can be used later to determine the topRowIndex. - this.visibleRowTopMargin = 0; - this.visibleRowBottomMargin = screenSize.height - visibleRowsHeight; - - this.topFold_.style.marginBottom = this.visibleRowTopMargin + 'px'; - - - var topFoldOffset = 0; - var node = this.topFold_.previousSibling; - while (node) { - topFoldOffset += hterm.getClientHeight(node); - node = node.previousSibling; - } - - // Set the dimensions of the visible rows container. - this.rowNodes_.style.width = screenSize.width + 'px'; - this.rowNodes_.style.height = visibleRowsHeight + topFoldOffset + 'px'; - this.rowNodes_.style.left = this.screen_.offsetLeft + 'px'; - this.rowNodes_.style.top = this.screen_.offsetTop - topFoldOffset + 'px'; -}; - -hterm.ScrollPort.prototype.syncScrollHeight = function() { - // Resize the scroll area to appear as though it contains every row. - this.lastRowCount_ = this.rowProvider_.getRowCount(); - this.scrollArea_.style.height = (this.characterSize.height * - this.lastRowCount_ + - this.visibleRowTopMargin + - this.visibleRowBottomMargin + - 'px'); -}; - -/** - * Schedule a redraw to happen asynchronously. - * - * If this method is called multiple times before the redraw has a chance to - * run only one redraw occurs. - */ -hterm.ScrollPort.prototype.scheduleRedraw = function() { - if (this.timeouts_.redraw) - return; - - var self = this; - this.timeouts_.redraw = setTimeout(function () { - delete self.timeouts_.redraw; - self.redraw_(); - }, 0); -}; - -/** - * Redraw the current hterm.ScrollPort based on the current scrollbar position. - * - * When redrawing, we are careful to make sure that the rows that start or end - * the current selection are not touched in any way. Doing so would disturb - * the selection, and cleaning up after that would cause flashes at best and - * incorrect selection at worst. Instead, we modify the DOM around these nodes. - * We even stash the selection start/end outside of the visible area if - * they are not supposed to be visible in the hterm.ScrollPort. - */ -hterm.ScrollPort.prototype.redraw_ = function() { - this.resetSelectBags_(); - this.selection.sync(); - - this.syncScrollHeight(); - - this.currentRowNodeCache_ = {}; - - var topRowIndex = this.getTopRowIndex(); - var bottomRowIndex = this.getBottomRowIndex(topRowIndex); - - this.drawTopFold_(topRowIndex); - this.drawBottomFold_(bottomRowIndex); - this.drawVisibleRows_(topRowIndex, bottomRowIndex); - - this.syncRowNodesDimensions_(); - - this.previousRowNodeCache_ = this.currentRowNodeCache_; - this.currentRowNodeCache_ = null; - - this.isScrolledEnd = ( - this.getTopRowIndex() + this.visibleRowCount >= this.lastRowCount_); -}; - -/** - * Ensure that the nodes above the top fold are as they should be. - * - * If the selection start and/or end nodes are above the visible range - * of this hterm.ScrollPort then the dom will be adjusted so that they appear - * before the top fold (the first x-fold element, aka this.topFold). - * - * If not, the top fold will be the first element. - * - * It is critical that this method does not move the selection nodes. Doing - * so would clear the current selection. Instead, the rest of the DOM is - * adjusted around them. - */ -hterm.ScrollPort.prototype.drawTopFold_ = function(topRowIndex) { - if (!this.selection.startRow || - this.selection.startRow.rowIndex >= topRowIndex) { - // Selection is entirely below the top fold, just make sure the fold is - // the first child. - if (this.rowNodes_.firstChild != this.topFold_) - this.rowNodes_.insertBefore(this.topFold_, this.rowNodes_.firstChild); - - return; - } - - if (!this.selection.isMultiline || - this.selection.endRow.rowIndex >= topRowIndex) { - // Only the startRow is above the fold. - if (this.selection.startRow.nextSibling != this.topFold_) - this.rowNodes_.insertBefore(this.topFold_, - this.selection.startRow.nextSibling); - } else { - // Both rows are above the fold. - if (this.selection.endRow.nextSibling != this.topFold_) { - this.rowNodes_.insertBefore(this.topFold_, - this.selection.endRow.nextSibling); - } - - // Trim any intermediate lines. - while (this.selection.startRow.nextSibling != - this.selection.endRow) { - this.rowNodes_.removeChild(this.selection.startRow.nextSibling); - } - } - - while(this.rowNodes_.firstChild != this.selection.startRow) { - this.rowNodes_.removeChild(this.rowNodes_.firstChild); - } -}; - -/** - * Ensure that the nodes below the bottom fold are as they should be. - * - * If the selection start and/or end nodes are below the visible range - * of this hterm.ScrollPort then the dom will be adjusted so that they appear - * after the bottom fold (the second x-fold element, aka this.bottomFold). - * - * If not, the bottom fold will be the last element. - * - * It is critical that this method does not move the selection nodes. Doing - * so would clear the current selection. Instead, the rest of the DOM is - * adjusted around them. - */ -hterm.ScrollPort.prototype.drawBottomFold_ = function(bottomRowIndex) { - if (!this.selection.endRow || - this.selection.endRow.rowIndex <= bottomRowIndex) { - // Selection is entirely above the bottom fold, just make sure the fold is - // the last child. - if (this.rowNodes_.lastChild != this.bottomFold_) - this.rowNodes_.appendChild(this.bottomFold_); - - return; - } - - if (!this.selection.isMultiline || - this.selection.startRow.rowIndex <= bottomRowIndex) { - // Only the endRow is below the fold. - if (this.bottomFold_.nextSibling != this.selection.endRow) - this.rowNodes_.insertBefore(this.bottomFold_, - this.selection.endRow); - } else { - // Both rows are below the fold. - if (this.bottomFold_.nextSibling != this.selection.startRow) { - this.rowNodes_.insertBefore(this.bottomFold_, - this.selection.startRow); - } - - // Trim any intermediate lines. - while (this.selection.startRow.nextSibling != - this.selection.endRow) { - this.rowNodes_.removeChild(this.selection.startRow.nextSibling); - } - } - - while(this.rowNodes_.lastChild != this.selection.endRow) { - this.rowNodes_.removeChild(this.rowNodes_.lastChild); - } -}; - -/** - * Ensure that the rows between the top and bottom folds are as they should be. - * - * This method assumes that drawTopFold_() and drawBottomFold_() have already - * run, and that they have left any visible selection row (selection start - * or selection end) between the folds. - * - * It recycles DOM nodes from the previous redraw where possible, but will ask - * the rowSource to make new nodes if necessary. - * - * It is critical that this method does not move the selection nodes. Doing - * so would clear the current selection. Instead, the rest of the DOM is - * adjusted around them. - */ -hterm.ScrollPort.prototype.drawVisibleRows_ = function( - topRowIndex, bottomRowIndex) { - var self = this; - - // Keep removing nodes, starting with currentNode, until we encounter - // targetNode. Throws on failure. - function removeUntilNode(currentNode, targetNode) { - while (currentNode != targetNode) { - if (!currentNode) - throw 'Did not encounter target node'; - - if (currentNode == self.bottomFold_) - throw 'Encountered bottom fold before target node'; - - var deadNode = currentNode; - currentNode = currentNode.nextSibling; - deadNode.parentNode.removeChild(deadNode); - } - } - - // Shorthand for things we're going to use a lot. - var selectionStartRow = this.selection.startRow; - var selectionEndRow = this.selection.endRow; - var bottomFold = this.bottomFold_; - - // The node we're examining during the current iteration. - var node = this.topFold_.nextSibling; - - var targetDrawCount = Math.min(this.visibleRowCount, - this.rowProvider_.getRowCount()); - - for (var drawCount = 0; drawCount < targetDrawCount; drawCount++) { - var rowIndex = topRowIndex + drawCount; - - if (node == bottomFold) { - // We've hit the bottom fold, we need to insert a new row. - var newNode = this.fetchRowNode_(rowIndex); - if (!newNode) { - console.log("Couldn't fetch row index: " + rowIndex); - break; - } - - this.rowNodes_.insertBefore(newNode, node); - continue; - } - - if (node.rowIndex == rowIndex) { - // This node is in the right place, move along. - node = node.nextSibling; - continue; - } - - if (selectionStartRow && selectionStartRow.rowIndex == rowIndex) { - // The selection start row is supposed to be here, remove nodes until - // we find it. - removeUntilNode(node, selectionStartRow); - node = selectionStartRow.nextSibling; - continue; - } - - if (selectionEndRow && selectionEndRow.rowIndex == rowIndex) { - // The selection end row is supposed to be here, remove nodes until - // we find it. - removeUntilNode(node, selectionEndRow); - node = selectionEndRow.nextSibling; - continue; - } - - if (node == selectionStartRow || node == selectionEndRow) { - // We encountered the start/end of the selection, but we don't want it - // yet. Insert a new row instead. - var newNode = this.fetchRowNode_(rowIndex); - if (!newNode) { - console.log("Couldn't fetch row index: " + rowIndex); - break; - } - - this.rowNodes_.insertBefore(newNode, node); - continue; - } - - // There is nothing special about this node, but it's in our way. Replace - // it with the node that should be here. - var newNode = this.fetchRowNode_(rowIndex); - if (!newNode) { - console.log("Couldn't fetch row index: " + rowIndex); - break; - } - - if (node == newNode) { - node = node.nextSibling; - continue; - } - - this.rowNodes_.insertBefore(newNode, node); - if (!newNode.nextSibling) - debugger; - this.rowNodes_.removeChild(node); - node = newNode.nextSibling; - } - - if (node != this.bottomFold_) - removeUntilNode(node, bottomFold); -}; - -/** - * Empty out both select bags and remove them from the document. - * - * These nodes hold the text between the start and end of the selection - * when that text is otherwise off screen. They are filled out in the - * onCopy_ event. - */ -hterm.ScrollPort.prototype.resetSelectBags_ = function() { - if (this.topSelectBag_.parentNode) { - this.topSelectBag_.textContent = ''; - this.topSelectBag_.parentNode.removeChild(this.topSelectBag_); - } - - if (this.bottomSelectBag_.parentNode) { - this.bottomSelectBag_.textContent = ''; - this.bottomSelectBag_.parentNode.removeChild(this.bottomSelectBag_); - } -}; - -/** - * Place a row node in the cache of visible nodes. - * - * This method may only be used during a redraw_. - */ -hterm.ScrollPort.prototype.cacheRowNode_ = function(rowNode) { - this.currentRowNodeCache_[rowNode.rowIndex] = rowNode; -}; - -/** - * Fetch the row node for the given index. - * - * This will return a node from the cache if possible, or will request one - * from the RowProvider if not. - * - * If a redraw_ is in progress the row will be added to the current cache. - */ -hterm.ScrollPort.prototype.fetchRowNode_ = function(rowIndex) { - var node; - - if (this.previousRowNodeCache_ && rowIndex in this.previousRowNodeCache_) { - node = this.previousRowNodeCache_[rowIndex]; - } else { - node = this.rowProvider_.getRowNode(rowIndex); - } - - if (this.currentRowNodeCache_) - this.cacheRowNode_(node); - - return node; -}; - -/** - * Select all rows in the viewport. - */ -hterm.ScrollPort.prototype.selectAll = function() { - var firstRow; - - if (this.topFold_.nextSibling.rowIndex != 0) { - while (this.topFold_.previousSibling) { - this.rowNodes_.removeChild(this.topFold_.previousSibling); - } - - firstRow = this.fetchRowNode_(0); - this.rowNodes_.insertBefore(firstRow, this.topFold_); - this.syncRowNodesDimensions_(); - } else { - firstRow = this.topFold_.nextSibling; - } - - var lastRowIndex = this.rowProvider_.getRowCount() - 1; - var lastRow; - - if (this.bottomFold_.previousSibling.rowIndex != lastRowIndex) { - while (this.bottomFold_.nextSibling) { - this.rowNodes_.removeChild(this.bottomFold_.nextSibling); - } - - lastRow = this.fetchRowNode_(lastRowIndex); - this.rowNodes_.appendChild(lastRow); - } else { - lastRow = this.bottomFold_.previousSibling.rowIndex; - } - - var selection = this.document_.getSelection(); - selection.collapse(firstRow, 0); - selection.extend(lastRow, lastRow.childNodes.length); - - this.selection.sync(); -}; - -/** - * Return the maximum scroll position in pixels. - */ -hterm.ScrollPort.prototype.getScrollMax_ = function(e) { - return (hterm.getClientHeight(this.scrollArea_) + - this.visibleRowTopMargin + this.visibleRowBottomMargin - - hterm.getClientHeight(this.screen_)); -}; - -/** - * Scroll the given rowIndex to the top of the hterm.ScrollPort. - * - * @param {integer} rowIndex Index of the target row. - */ -hterm.ScrollPort.prototype.scrollRowToTop = function(rowIndex) { - this.syncScrollHeight(); - - this.isScrolledEnd = ( - rowIndex + this.visibleRowCount >= this.lastRowCount_); - - var scrollTop = rowIndex * this.characterSize.height + - this.visibleRowTopMargin; - - var scrollMax = this.getScrollMax_(); - if (scrollTop > scrollMax) - scrollTop = scrollMax; - - if (this.screen_.scrollTop == scrollTop) - return; - - this.screen_.scrollTop = scrollTop; - this.scheduleRedraw(); -}; - -/** - * Scroll the given rowIndex to the bottom of the hterm.ScrollPort. - * - * @param {integer} rowIndex Index of the target row. - */ -hterm.ScrollPort.prototype.scrollRowToBottom = function(rowIndex) { - this.syncScrollHeight(); - - this.isScrolledEnd = ( - rowIndex + this.visibleRowCount >= this.lastRowCount_); - - var scrollTop = rowIndex * this.characterSize.height + - this.visibleRowTopMargin + this.visibleRowBottomMargin; - scrollTop -= this.visibleRowCount * this.characterSize.height; - - if (scrollTop < 0) - scrollTop = 0; - - if (this.screen_.scrollTop == scrollTop) - return; - - this.screen_.scrollTop = scrollTop; -}; - -/** - * Return the row index of the first visible row. - * - * This is based on the scroll position. If a redraw_ is in progress this - * returns the row that *should* be at the top. - */ -hterm.ScrollPort.prototype.getTopRowIndex = function() { - return Math.round(this.screen_.scrollTop / this.characterSize.height); -}; - -/** - * Return the row index of the last visible row. - * - * This is based on the scroll position. If a redraw_ is in progress this - * returns the row that *should* be at the bottom. - */ -hterm.ScrollPort.prototype.getBottomRowIndex = function(topRowIndex) { - return topRowIndex + this.visibleRowCount - 1; -}; - -/** - * Handler for scroll events. - * - * The onScroll event fires when scrollArea's scrollTop property changes. This - * may be due to the user manually move the scrollbar, or a programmatic change. - */ -hterm.ScrollPort.prototype.onScroll_ = function(e) { - var screenSize = this.getScreenSize(); - if (screenSize.width != this.lastScreenWidth_ || - screenSize.height != this.lastScreenHeight_) { - // This event may also fire during a resize (but before the resize event!). - // This happens when the browser moves the scrollbar as part of the resize. - // In these cases, we want to ignore the scroll event and let onResize - // handle things. If we don't, then we end up scrolling to the wrong - // position after a resize. - this.resize(); - return; - } - - this.redraw_(); - this.publish('scroll', { scrollPort: this }); -}; - -/** - * Clients can override this if they want to hear scrollwheel events. - * - * Clients may call event.preventDefault() if they want to keep the scrollport - * from also handling the events. - */ -hterm.ScrollPort.prototype.onScrollWheel = function(e) {}; - -/** - * Handler for scroll-wheel events. - * - * The onScrollWheel event fires when the user moves their scrollwheel over this - * hterm.ScrollPort. Because the frontmost element in the hterm.ScrollPort is - * a fixed position DIV, the scroll wheel does nothing by default. Instead, we - * have to handle it manually. - */ -hterm.ScrollPort.prototype.onScrollWheel_ = function(e) { - this.onScrollWheel(e); - - if (e.defaultPrevented) - return; - - // Figure out how far this event wants us to scroll. - var delta = this.scrollWheelDelta(e); - - var top = this.screen_.scrollTop - delta; - if (top < 0) - top = 0; - - var scrollMax = this.getScrollMax_(); - if (top > scrollMax) - top = scrollMax; - - if (top != this.screen_.scrollTop) { - // Moving scrollTop causes a scroll event, which triggers the redraw. - this.screen_.scrollTop = top; - - // Only preventDefault when we've actually scrolled. If there's nothing - // to scroll we want to pass the event through so Chrome can detect the - // overscroll. - e.preventDefault(); - } -}; - -/** - * Calculate how far a wheel event should scroll. - * - * @param {WheelEvent} e The mouse wheel event to process. - * @return {number} How far (in pixels) to scroll. - */ -hterm.ScrollPort.prototype.scrollWheelDelta = function(e) { - var delta; - - switch (e.deltaMode) { - case WheelEvent.DOM_DELTA_PIXEL: - delta = e.deltaY * this.scrollWheelMultiplier_; - break; - case WheelEvent.DOM_DELTA_LINE: - delta = e.deltaY * this.characterSize.height; - break; - case WheelEvent.DOM_DELTA_PAGE: - delta = e.deltaY * this.characterSize.height * this.screen_.getHeight(); - break; - } - - // The sign is inverted from what we would expect. - return delta * -1; -}; - - -/** - * Clients can override this if they want to hear touch events. - * - * Clients may call event.preventDefault() if they want to keep the scrollport - * from also handling the events. - */ -hterm.ScrollPort.prototype.onTouch = function(e) {}; - -/** - * Handler for touch events. - */ -hterm.ScrollPort.prototype.onTouch_ = function(e) { - this.onTouch(e); - - if (e.defaultPrevented) - return; - - // Extract the fields from the Touch event that we need. If we saved the - // event directly, it has references to other objects (like x-row) that - // might stick around for a long time. This way we only have small objects - // in our lastTouch_ state. - var scrubTouch = function(t) { - return { - id: t.identifier, - y: t.clientY, - x: t.clientX, - }; - }; - - var i, touch; - switch (e.type) { - case 'touchstart': - // Save the current set of touches. - for (i = 0; i < e.changedTouches.length; ++i) { - touch = scrubTouch(e.changedTouches[i]); - this.lastTouch_[touch.id] = touch; - } - break; - - case 'touchcancel': - case 'touchend': - // Throw away existing touches that we're finished with. - for (i = 0; i < e.changedTouches.length; ++i) - delete this.lastTouch_[e.changedTouches[i].identifier]; - break; - - case 'touchmove': - // Walk all of the touches in this one event and merge all of their - // changes into one delta. This lets multiple fingers scroll faster. - var delta = 0; - for (i = 0; i < e.changedTouches.length; ++i) { - touch = scrubTouch(e.changedTouches[i]); - delta += (this.lastTouch_[touch.id].y - touch.y); - this.lastTouch_[touch.id] = touch; - } - - // Invert to match the touchscreen scrolling direction of browser windows. - delta *= -1; - - var top = this.screen_.scrollTop - delta; - if (top < 0) - top = 0; - - var scrollMax = this.getScrollMax_(); - if (top > scrollMax) - top = scrollMax; - - if (top != this.screen_.scrollTop) { - // Moving scrollTop causes a scroll event, which triggers the redraw. - this.screen_.scrollTop = top; - } - break; - } - - // To disable gestures or anything else interfering with our scrolling. - e.preventDefault(); -}; - -/** - * Handler for resize events. - * - * The browser will resize us such that the top row stays at the top, but we - * prefer to the bottom row to stay at the bottom. - */ -hterm.ScrollPort.prototype.onResize_ = function(e) { - // Re-measure, since onResize also happens for browser zoom changes. - this.syncCharacterSize(); -}; - -/** - * Clients can override this if they want to hear copy events. - * - * Clients may call event.preventDefault() if they want to keep the scrollport - * from also handling the events. - */ -hterm.ScrollPort.prototype.onCopy = function(e) { }; - -/** - * Handler for copy-to-clipboard events. - * - * If some or all of the selected rows are off screen we may need to fill in - * the rows between selection start and selection end. This handler determines - * if we're missing some of the selected text, and if so populates one or both - * of the "select bags" with the missing text. - */ -hterm.ScrollPort.prototype.onCopy_ = function(e) { - this.onCopy(e); - - if (e.defaultPrevented) - return; - - this.resetSelectBags_(); - this.selection.sync(); - - if (!this.selection.startRow || - this.selection.endRow.rowIndex - this.selection.startRow.rowIndex < 2) { - return; - } - - var topRowIndex = this.getTopRowIndex(); - var bottomRowIndex = this.getBottomRowIndex(topRowIndex); - - if (this.selection.startRow.rowIndex < topRowIndex) { - // Start of selection is above the top fold. - var endBackfillIndex; - - if (this.selection.endRow.rowIndex < topRowIndex) { - // Entire selection is above the top fold. - endBackfillIndex = this.selection.endRow.rowIndex; - } else { - // Selection extends below the top fold. - endBackfillIndex = this.topFold_.nextSibling.rowIndex; - } - - this.topSelectBag_.textContent = this.rowProvider_.getRowsText( - this.selection.startRow.rowIndex + 1, endBackfillIndex); - this.rowNodes_.insertBefore(this.topSelectBag_, - this.selection.startRow.nextSibling); - this.syncRowNodesDimensions_(); - } - - if (this.selection.endRow.rowIndex > bottomRowIndex) { - // Selection ends below the bottom fold. - var startBackfillIndex; - - if (this.selection.startRow.rowIndex > bottomRowIndex) { - // Entire selection is below the bottom fold. - startBackfillIndex = this.selection.startRow.rowIndex + 1; - } else { - // Selection starts above the bottom fold. - startBackfillIndex = this.bottomFold_.previousSibling.rowIndex + 1; - } - - this.bottomSelectBag_.textContent = this.rowProvider_.getRowsText( - startBackfillIndex, this.selection.endRow.rowIndex); - this.rowNodes_.insertBefore(this.bottomSelectBag_, this.selection.endRow); - } -}; - -/** - * Focuses on the paste target on a ctrl-v keydown event, as in - * FF a content editable element must be focused before the paste event. - */ -hterm.ScrollPort.prototype.onBodyKeyDown_ = function(e) { - if (!this.ctrlVPaste) - return; - - var key = String.fromCharCode(e.which); - var lowerKey = key.toLowerCase(); - if ((e.ctrlKey || e.metaKey) && lowerKey == "v") - this.pasteTarget_.focus(); -}; - -/** - * Handle a paste event on the the ScrollPort's screen element. - * - * TODO: Handle ClipboardData.files transfers. https://crbug.com/433581. - */ -hterm.ScrollPort.prototype.onPaste_ = function(e) { - this.pasteTarget_.focus(); - - var self = this; - setTimeout(function() { - self.publish('paste', { text: self.pasteTarget_.value }); - self.pasteTarget_.value = ''; - self.screen_.focus(); - }, 0); -}; - -/** - * Handles a textInput event on the paste target. Stops this from - * propagating as we want this to be handled in the onPaste_ method. - */ -hterm.ScrollPort.prototype.handlePasteTargetTextInput_ = function(e) { - e.stopPropagation(); -}; - -/** - * Handle a drop event on the the ScrollPort's screen element. - * - * By default we try to copy in the structured format (HTML/whatever). - * The shift key can select plain text though. - * - * TODO: Handle DataTransfer.files transfers. https://crbug.com/433581. - * - * @param {DragEvent} e The drag event that fired us. - */ -hterm.ScrollPort.prototype.onDragAndDrop_ = function(e) { - e.preventDefault(); - - let data; - let format; - - // If the shift key active, try to find a "rich" text source (but not plain - // text). e.g. text/html is OK. - if (e.shiftKey) { - e.dataTransfer.types.forEach((t) => { - if (!format && t != 'text/plain' && t.startsWith('text/')) - format = t; - }); - - // If we found a non-plain text source, try it out first. - if (format) - data = e.dataTransfer.getData(format); - } - - // If we haven't loaded anything useful, fall back to plain text. - if (!data) - data = e.dataTransfer.getData('text/plain'); - - if (data) - this.publish('paste', {text: data}); -}; - -/** - * Set the vertical scrollbar mode of the ScrollPort. - */ -hterm.ScrollPort.prototype.setScrollbarVisible = function(state) { - this.screen_.style.overflowY = state ? 'scroll' : 'hidden'; -}; - -/** - * Set scroll wheel multiplier. This alters how much the screen scrolls on - * mouse wheel events. - */ -hterm.ScrollPort.prototype.setScrollWheelMoveMultipler = function(multiplier) { - this.scrollWheelMultiplier_ = multiplier; -}; -// SOURCE FILE: hterm/js/hterm_terminal.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.colors', 'lib.PreferenceManager', 'lib.resource', 'lib.wc', - 'lib.f', 'hterm.Keyboard', 'hterm.Options', 'hterm.PreferenceManager', - 'hterm.Screen', 'hterm.ScrollPort', 'hterm.Size', - 'hterm.TextAttributes', 'hterm.VT'); - -/** - * Constructor for the Terminal class. - * - * A Terminal pulls together the hterm.ScrollPort, hterm.Screen and hterm.VT100 - * classes to provide the complete terminal functionality. - * - * There are a number of lower-level Terminal methods that can be called - * directly to manipulate the cursor, text, scroll region, and other terminal - * attributes. However, the primary method is interpret(), which parses VT - * escape sequences and invokes the appropriate Terminal methods. - * - * This class was heavily influenced by Cory Maccarrone's Framebuffer class. - * - * TODO(rginda): Eventually we're going to need to support characters which are - * displayed twice as wide as standard latin characters. This is to support - * CJK (and possibly other character sets). - * - * @param {string} opt_profileId Optional preference profile name. If not - * provided, defaults to 'default'. - */ -hterm.Terminal = function(opt_profileId) { - this.profileId_ = null; - - // Two screen instances. - this.primaryScreen_ = new hterm.Screen(); - this.alternateScreen_ = new hterm.Screen(); - - // The "current" screen. - this.screen_ = this.primaryScreen_; - - // The local notion of the screen size. ScreenBuffers also have a size which - // indicates their present size. During size changes, the two may disagree. - // Also, the inactive screen's size is not altered until it is made the active - // screen. - this.screenSize = new hterm.Size(0, 0); - - // The scroll port we'll be using to display the visible rows. - this.scrollPort_ = new hterm.ScrollPort(this); - this.scrollPort_.subscribe('resize', this.onResize_.bind(this)); - this.scrollPort_.subscribe('scroll', this.onScroll_.bind(this)); - this.scrollPort_.subscribe('paste', this.onPaste_.bind(this)); - this.scrollPort_.onCopy = this.onCopy_.bind(this); - - // The div that contains this terminal. - this.div_ = null; - - // The document that contains the scrollPort. Defaulted to the global - // document here so that the terminal is functional even if it hasn't been - // inserted into a document yet, but re-set in decorate(). - this.document_ = window.document; - - // The rows that have scrolled off screen and are no longer addressable. - this.scrollbackRows_ = []; - - // Saved tab stops. - this.tabStops_ = []; - - // Keep track of whether default tab stops have been erased; after a TBC - // clears all tab stops, defaults aren't restored on resize until a reset. - this.defaultTabStops = true; - - // The VT's notion of the top and bottom rows. Used during some VT - // cursor positioning and scrolling commands. - this.vtScrollTop_ = null; - this.vtScrollBottom_ = null; - - // The DIV element for the visible cursor. - this.cursorNode_ = null; - - // The current cursor shape of the terminal. - this.cursorShape_ = hterm.Terminal.cursorShape.BLOCK; - - // The current color of the cursor. - this.cursorColor_ = null; - - // Cursor blink on/off cycle in ms, overwritten by prefs once they're loaded. - this.cursorBlinkCycle_ = [100, 100]; - - // Pre-bound onCursorBlink_ handler, so we don't have to do this for each - // cursor on/off servicing. - this.myOnCursorBlink_ = this.onCursorBlink_.bind(this); - - // These prefs are cached so we don't have to read from local storage with - // each output and keystroke. They are initialized by the preference manager. - this.backgroundColor_ = null; - this.foregroundColor_ = null; - this.scrollOnOutput_ = null; - this.scrollOnKeystroke_ = null; - this.scrollWheelArrowKeys_ = null; - - // True if we should override mouse event reporting to allow local selection. - this.defeatMouseReports_ = false; - - // Terminal bell sound. - this.bellAudio_ = this.document_.createElement('audio'); - this.bellAudio_.id = 'hterm:bell-audio'; - this.bellAudio_.setAttribute('preload', 'auto'); - - // All terminal bell notifications that have been generated (not necessarily - // shown). - this.bellNotificationList_ = []; - - // Whether we have permission to display notifications. - this.desktopNotificationBell_ = false; - - // Cursor position and attributes saved with DECSC. - this.savedOptions_ = {}; - - // The current mode bits for the terminal. - this.options_ = new hterm.Options(); - - // Timeouts we might need to clear. - this.timeouts_ = {}; - - // The VT escape sequence interpreter. - this.vt = new hterm.VT(this); - - this.saveCursorAndState(true); - - // The keyboard handler. - this.keyboard = new hterm.Keyboard(this); - - // General IO interface that can be given to third parties without exposing - // the entire terminal object. - this.io = new hterm.Terminal.IO(this); - - // True if mouse-click-drag should scroll the terminal. - this.enableMouseDragScroll = true; - - this.copyOnSelect = null; - this.mouseRightClickPaste = null; - this.mousePasteButton = null; - - // Whether to use the default window copy behavior. - this.useDefaultWindowCopy = false; - - this.clearSelectionAfterCopy = true; - - this.realizeSize_(80, 24); - this.setDefaultTabStops(); - - // Whether we allow images to be shown. - this.allowImagesInline = null; - - this.reportFocus = false; - - this.setProfile(opt_profileId || 'default', - function() { this.onTerminalReady(); }.bind(this)); -}; - -/** - * Possible cursor shapes. - */ -hterm.Terminal.cursorShape = { - BLOCK: 'BLOCK', - BEAM: 'BEAM', - UNDERLINE: 'UNDERLINE' -}; - -/** - * Clients should override this to be notified when the terminal is ready - * for use. - * - * The terminal initialization is asynchronous, and shouldn't be used before - * this method is called. - */ -hterm.Terminal.prototype.onTerminalReady = function() { }; - -/** - * Default tab with of 8 to match xterm. - */ -hterm.Terminal.prototype.tabWidth = 8; - -/** - * Select a preference profile. - * - * This will load the terminal preferences for the given profile name and - * associate subsequent preference changes with the new preference profile. - * - * @param {string} profileId The name of the preference profile. Forward slash - * characters will be removed from the name. - * @param {function} opt_callback Optional callback to invoke when the profile - * transition is complete. - */ -hterm.Terminal.prototype.setProfile = function(profileId, opt_callback) { - this.profileId_ = profileId.replace(/\//g, ''); - - var terminal = this; - - if (this.prefs_) - this.prefs_.deactivate(); - - this.prefs_ = new hterm.PreferenceManager(this.profileId_); - this.prefs_.addObservers(null, { - 'alt-gr-mode': function(v) { - if (v == null) { - if (navigator.language.toLowerCase() == 'en-us') { - v = 'none'; - } else { - v = 'right-alt'; - } - } else if (typeof v == 'string') { - v = v.toLowerCase(); - } else { - v = 'none'; - } - - if (!/^(none|ctrl-alt|left-alt|right-alt)$/.test(v)) - v = 'none'; - - terminal.keyboard.altGrMode = v; - }, - - 'alt-backspace-is-meta-backspace': function(v) { - terminal.keyboard.altBackspaceIsMetaBackspace = v; - }, - - 'alt-is-meta': function(v) { - terminal.keyboard.altIsMeta = v; - }, - - 'alt-sends-what': function(v) { - if (!/^(escape|8-bit|browser-key)$/.test(v)) - v = 'escape'; - - terminal.keyboard.altSendsWhat = v; - }, - - 'audible-bell-sound': function(v) { - var ary = v.match(/^lib-resource:(\S+)/); - if (ary) { - terminal.bellAudio_.setAttribute('src', - lib.resource.getDataUrl(ary[1])); - } else { - terminal.bellAudio_.setAttribute('src', v); - } - }, - - 'desktop-notification-bell': function(v) { - if (v && Notification) { - terminal.desktopNotificationBell_ = - Notification.permission === 'granted'; - if (!terminal.desktopNotificationBell_) { - // Note: We don't call Notification.requestPermission here because - // Chrome requires the call be the result of a user action (such as an - // onclick handler), and pref listeners are run asynchronously. - // - // A way of working around this would be to display a dialog in the - // terminal with a "click-to-request-permission" button. - console.warn('desktop-notification-bell is true but we do not have ' + - 'permission to display notifications.'); - } - } else { - terminal.desktopNotificationBell_ = false; - } - }, - - 'background-color': function(v) { - terminal.setBackgroundColor(v); - }, - - 'background-image': function(v) { - terminal.scrollPort_.setBackgroundImage(v); - }, - - 'background-size': function(v) { - terminal.scrollPort_.setBackgroundSize(v); - }, - - 'background-position': function(v) { - terminal.scrollPort_.setBackgroundPosition(v); - }, - - 'backspace-sends-backspace': function(v) { - terminal.keyboard.backspaceSendsBackspace = v; - }, - - 'character-map-overrides': function(v) { - if (!(v == null || v instanceof Object)) { - console.warn('Preference character-map-modifications is not an ' + - 'object: ' + v); - return; - } - - terminal.vt.characterMaps.reset(); - terminal.vt.characterMaps.setOverrides(v); - }, - - 'cursor-blink': function(v) { - terminal.setCursorBlink(!!v); - }, - - 'cursor-blink-cycle': function(v) { - if (v instanceof Array && - typeof v[0] == 'number' && - typeof v[1] == 'number') { - terminal.cursorBlinkCycle_ = v; - } else if (typeof v == 'number') { - terminal.cursorBlinkCycle_ = [v, v]; - } else { - // Fast blink indicates an error. - terminal.cursorBlinkCycle_ = [100, 100]; - } - }, - - 'cursor-color': function(v) { - terminal.setCursorColor(v); - }, - - 'color-palette-overrides': function(v) { - if (!(v == null || v instanceof Object || v instanceof Array)) { - console.warn('Preference color-palette-overrides is not an array or ' + - 'object: ' + v); - return; - } - - lib.colors.colorPalette = lib.colors.stockColorPalette.concat(); - - if (v) { - for (var key in v) { - var i = parseInt(key); - if (isNaN(i) || i < 0 || i > 255) { - console.log('Invalid value in palette: ' + key + ': ' + v[key]); - continue; - } - - if (v[i]) { - var rgb = lib.colors.normalizeCSS(v[i]); - if (rgb) - lib.colors.colorPalette[i] = rgb; - } - } - } - - terminal.primaryScreen_.textAttributes.resetColorPalette(); - terminal.alternateScreen_.textAttributes.resetColorPalette(); - }, - - 'copy-on-select': function(v) { - terminal.copyOnSelect = !!v; - }, - - 'use-default-window-copy': function(v) { - terminal.useDefaultWindowCopy = !!v; - }, - - 'clear-selection-after-copy': function(v) { - terminal.clearSelectionAfterCopy = !!v; - }, - - 'ctrl-plus-minus-zero-zoom': function(v) { - terminal.keyboard.ctrlPlusMinusZeroZoom = v; - }, - - 'ctrl-c-copy': function(v) { - terminal.keyboard.ctrlCCopy = v; - }, - - 'ctrl-v-paste': function(v) { - terminal.keyboard.ctrlVPaste = v; - terminal.scrollPort_.setCtrlVPaste(v); - }, - - 'east-asian-ambiguous-as-two-column': function(v) { - lib.wc.regardCjkAmbiguous = v; - }, - - 'enable-8-bit-control': function(v) { - terminal.vt.enable8BitControl = !!v; - }, - - 'enable-bold': function(v) { - terminal.syncBoldSafeState(); - }, - - 'enable-bold-as-bright': function(v) { - terminal.primaryScreen_.textAttributes.enableBoldAsBright = !!v; - terminal.alternateScreen_.textAttributes.enableBoldAsBright = !!v; - }, - - 'enable-blink': function(v) { - terminal.setTextBlink(!!v); - }, - - 'enable-clipboard-write': function(v) { - terminal.vt.enableClipboardWrite = !!v; - }, - - 'enable-dec12': function(v) { - terminal.vt.enableDec12 = !!v; - }, - - 'font-family': function(v) { - terminal.syncFontFamily(); - }, - - 'font-size': function(v) { - v = parseInt(v); - if (v <= 0) { - console.error(`Invalid font size: ${v}`); - return; - } - - terminal.setFontSize(v); - }, - - 'font-smoothing': function(v) { - terminal.syncFontFamily(); - }, - - 'foreground-color': function(v) { - terminal.setForegroundColor(v); - }, - - 'home-keys-scroll': function(v) { - terminal.keyboard.homeKeysScroll = v; - }, - - 'keybindings': function(v) { - terminal.keyboard.bindings.clear(); - - if (!v) - return; - - if (!(v instanceof Object)) { - console.error('Error in keybindings preference: Expected object'); - return; - } - - try { - terminal.keyboard.bindings.addBindings(v); - } catch (ex) { - console.error('Error in keybindings preference: ' + ex); - } - }, - - 'media-keys-are-fkeys': function(v) { - terminal.keyboard.mediaKeysAreFKeys = v; - }, - - 'meta-sends-escape': function(v) { - terminal.keyboard.metaSendsEscape = v; - }, - - 'mouse-right-click-paste': function(v) { - terminal.mouseRightClickPaste = v; - }, - - 'mouse-paste-button': function(v) { - terminal.syncMousePasteButton(); - }, - - 'page-keys-scroll': function(v) { - terminal.keyboard.pageKeysScroll = v; - }, - - 'pass-alt-number': function(v) { - if (v == null) { - // Let Alt-1..9 pass to the browser (to control tab switching) on - // non-OS X systems, or if hterm is not opened in an app window. - v = (hterm.os != 'mac' && hterm.windowType != 'popup'); - } - - terminal.passAltNumber = v; - }, - - 'pass-ctrl-number': function(v) { - if (v == null) { - // Let Ctrl-1..9 pass to the browser (to control tab switching) on - // non-OS X systems, or if hterm is not opened in an app window. - v = (hterm.os != 'mac' && hterm.windowType != 'popup'); - } - - terminal.passCtrlNumber = v; - }, - - 'pass-meta-number': function(v) { - if (v == null) { - // Let Meta-1..9 pass to the browser (to control tab switching) on - // OS X systems, or if hterm is not opened in an app window. - v = (hterm.os == 'mac' && hterm.windowType != 'popup'); - } - - terminal.passMetaNumber = v; - }, - - 'pass-meta-v': function(v) { - terminal.keyboard.passMetaV = v; - }, - - 'receive-encoding': function(v) { - if (!(/^(utf-8|raw)$/).test(v)) { - console.warn('Invalid value for "receive-encoding": ' + v); - v = 'utf-8'; - } - - terminal.vt.characterEncoding = v; - }, - - 'scroll-on-keystroke': function(v) { - terminal.scrollOnKeystroke_ = v; - }, - - 'scroll-on-output': function(v) { - terminal.scrollOnOutput_ = v; - }, - - 'scrollbar-visible': function(v) { - terminal.setScrollbarVisible(v); - }, - - 'scroll-wheel-may-send-arrow-keys': function(v) { - terminal.scrollWheelArrowKeys_ = v; - }, - - 'scroll-wheel-move-multiplier': function(v) { - terminal.setScrollWheelMoveMultipler(v); - }, - - 'send-encoding': function(v) { - if (!(/^(utf-8|raw)$/).test(v)) { - console.warn('Invalid value for "send-encoding": ' + v); - v = 'utf-8'; - } - - terminal.keyboard.characterEncoding = v; - }, - - 'shift-insert-paste': function(v) { - terminal.keyboard.shiftInsertPaste = v; - }, - - 'terminal-encoding': function(v) { - terminal.vt.setEncoding(v); - }, - - 'user-css': function(v) { - terminal.scrollPort_.setUserCssUrl(v); - }, - - 'user-css-text': function(v) { - terminal.scrollPort_.setUserCssText(v); - }, - - 'word-break-match-left': function(v) { - terminal.primaryScreen_.wordBreakMatchLeft = v; - terminal.alternateScreen_.wordBreakMatchLeft = v; - }, - - 'word-break-match-right': function(v) { - terminal.primaryScreen_.wordBreakMatchRight = v; - terminal.alternateScreen_.wordBreakMatchRight = v; - }, - - 'word-break-match-middle': function(v) { - terminal.primaryScreen_.wordBreakMatchMiddle = v; - terminal.alternateScreen_.wordBreakMatchMiddle = v; - }, - - 'allow-images-inline': function(v) { - terminal.allowImagesInline = v; - }, - }); - - this.prefs_.readStorage(function() { - this.prefs_.notifyAll(); - - if (opt_callback) - opt_callback(); - }.bind(this)); -}; - - -/** - * Returns the preferences manager used for configuring this terminal. - * - * @return {hterm.PreferenceManager} - */ -hterm.Terminal.prototype.getPrefs = function() { - return this.prefs_; -}; - -/** - * Enable or disable bracketed paste mode. - * - * @param {boolean} state The value to set. - */ -hterm.Terminal.prototype.setBracketedPaste = function(state) { - this.options_.bracketedPaste = state; -}; - -/** - * Set the color for the cursor. - * - * If you want this setting to persist, set it through prefs_, rather than - * with this method. - * - * @param {string=} color The color to set. If not defined, we reset to the - * saved user preference. - */ -hterm.Terminal.prototype.setCursorColor = function(color) { - if (color === undefined) - color = this.prefs_.get('cursor-color'); - - this.cursorColor_ = color; - this.cursorNode_.style.backgroundColor = color; - this.cursorNode_.style.borderColor = color; -}; - -/** - * Return the current cursor color as a string. - * @return {string} - */ -hterm.Terminal.prototype.getCursorColor = function() { - return this.cursorColor_; -}; - -/** - * Enable or disable mouse based text selection in the terminal. - * - * @param {boolean} state The value to set. - */ -hterm.Terminal.prototype.setSelectionEnabled = function(state) { - this.enableMouseDragScroll = state; -}; - -/** - * Set the background color. - * - * If you want this setting to persist, set it through prefs_, rather than - * with this method. - * - * @param {string=} color The color to set. If not defined, we reset to the - * saved user preference. - */ -hterm.Terminal.prototype.setBackgroundColor = function(color) { - if (color === undefined) - color = this.prefs_.get('background-color'); - - this.backgroundColor_ = lib.colors.normalizeCSS(color); - this.primaryScreen_.textAttributes.setDefaults( - this.foregroundColor_, this.backgroundColor_); - this.alternateScreen_.textAttributes.setDefaults( - this.foregroundColor_, this.backgroundColor_); - this.scrollPort_.setBackgroundColor(color); -}; - -/** - * Return the current terminal background color. - * - * Intended for use by other classes, so we don't have to expose the entire - * prefs_ object. - * - * @return {string} - */ -hterm.Terminal.prototype.getBackgroundColor = function() { - return this.backgroundColor_; -}; - -/** - * Set the foreground color. - * - * If you want this setting to persist, set it through prefs_, rather than - * with this method. - * - * @param {string=} color The color to set. If not defined, we reset to the - * saved user preference. - */ -hterm.Terminal.prototype.setForegroundColor = function(color) { - if (color === undefined) - color = this.prefs_.get('foreground-color'); - - this.foregroundColor_ = lib.colors.normalizeCSS(color); - this.primaryScreen_.textAttributes.setDefaults( - this.foregroundColor_, this.backgroundColor_); - this.alternateScreen_.textAttributes.setDefaults( - this.foregroundColor_, this.backgroundColor_); - this.scrollPort_.setForegroundColor(color); -}; - -/** - * Return the current terminal foreground color. - * - * Intended for use by other classes, so we don't have to expose the entire - * prefs_ object. - * - * @return {string} - */ -hterm.Terminal.prototype.getForegroundColor = function() { - return this.foregroundColor_; -}; - -/** - * Create a new instance of a terminal command and run it with a given - * argument string. - * - * @param {function} commandClass The constructor for a terminal command. - * @param {string} argString The argument string to pass to the command. - */ -hterm.Terminal.prototype.runCommandClass = function(commandClass, argString) { - var environment = this.prefs_.get('environment'); - if (typeof environment != 'object' || environment == null) - environment = {}; - - var self = this; - this.command = new commandClass( - { argString: argString || '', - io: this.io.push(), - environment: environment, - onExit: function(code) { - self.io.pop(); - self.uninstallKeyboard(); - if (self.prefs_.get('close-on-exit')) - window.close(); - } - }); - - this.installKeyboard(); - this.command.run(); -}; - -/** - * Returns true if the current screen is the primary screen, false otherwise. - * - * @return {boolean} - */ -hterm.Terminal.prototype.isPrimaryScreen = function() { - return this.screen_ == this.primaryScreen_; -}; - -/** - * Install the keyboard handler for this terminal. - * - * This will prevent the browser from seeing any keystrokes sent to the - * terminal. - */ -hterm.Terminal.prototype.installKeyboard = function() { - this.keyboard.installKeyboard(this.scrollPort_.getDocument().body); -} - -/** - * Uninstall the keyboard handler for this terminal. - */ -hterm.Terminal.prototype.uninstallKeyboard = function() { - this.keyboard.installKeyboard(null); -} - -/** - * Set a CSS variable. - * - * Normally this is used to set variables in the hterm namespace. - * - * @param {string} name The variable to set. - * @param {string} value The value to assign to the variable. - * @param {string?} opt_prefix The variable namespace/prefix to use. - */ -hterm.Terminal.prototype.setCssVar = function(name, value, - opt_prefix='--hterm-') { - this.document_.documentElement.style.setProperty( - `${opt_prefix}${name}`, value); -}; - -/** - * Get a CSS variable. - * - * Normally this is used to get variables in the hterm namespace. - * - * @param {string} name The variable to read. - * @param {string?} opt_prefix The variable namespace/prefix to use. - * @return {string} The current setting for this variable. - */ -hterm.Terminal.prototype.getCssVar = function(name, opt_prefix='--hterm-') { - return this.document_.documentElement.style.getPropertyValue( - `${opt_prefix}${name}`); -}; - -/** - * Set the font size for this terminal. - * - * Call setFontSize(0) to reset to the default font size. - * - * This function does not modify the font-size preference. - * - * @param {number} px The desired font size, in pixels. - */ -hterm.Terminal.prototype.setFontSize = function(px) { - if (px <= 0) - px = this.prefs_.get('font-size'); - - this.scrollPort_.setFontSize(px); - this.setCssVar('charsize-width', this.scrollPort_.characterSize.width + 'px'); - this.setCssVar('charsize-height', - this.scrollPort_.characterSize.height + 'px'); -}; - -/** - * Get the current font size. - * - * @return {number} - */ -hterm.Terminal.prototype.getFontSize = function() { - return this.scrollPort_.getFontSize(); -}; - -/** - * Get the current font family. - * - * @return {string} - */ -hterm.Terminal.prototype.getFontFamily = function() { - return this.scrollPort_.getFontFamily(); -}; - -/** - * Set the CSS "font-family" for this terminal. - */ -hterm.Terminal.prototype.syncFontFamily = function() { - this.scrollPort_.setFontFamily(this.prefs_.get('font-family'), - this.prefs_.get('font-smoothing')); - this.syncBoldSafeState(); -}; - -/** - * Set this.mousePasteButton based on the mouse-paste-button pref, - * autodetecting if necessary. - */ -hterm.Terminal.prototype.syncMousePasteButton = function() { - var button = this.prefs_.get('mouse-paste-button'); - if (typeof button == 'number') { - this.mousePasteButton = button; - return; - } - - if (hterm.os != 'linux') { - this.mousePasteButton = 1; // Middle mouse button. - } else { - this.mousePasteButton = 2; // Right mouse button. - } -}; - -/** - * Enable or disable bold based on the enable-bold pref, autodetecting if - * necessary. - */ -hterm.Terminal.prototype.syncBoldSafeState = function() { - var enableBold = this.prefs_.get('enable-bold'); - if (enableBold !== null) { - this.primaryScreen_.textAttributes.enableBold = enableBold; - this.alternateScreen_.textAttributes.enableBold = enableBold; - return; - } - - var normalSize = this.scrollPort_.measureCharacterSize(); - var boldSize = this.scrollPort_.measureCharacterSize('bold'); - - var isBoldSafe = normalSize.equals(boldSize); - if (!isBoldSafe) { - console.warn('Bold characters disabled: Size of bold weight differs ' + - 'from normal. Font family is: ' + - this.scrollPort_.getFontFamily()); - } - - this.primaryScreen_.textAttributes.enableBold = isBoldSafe; - this.alternateScreen_.textAttributes.enableBold = isBoldSafe; -}; - -/** - * Control text blinking behavior. - * - * @param {boolean=} state Whether to enable support for blinking text. - */ -hterm.Terminal.prototype.setTextBlink = function(state) { - if (state === undefined) - state = this.prefs_.get('enable-blink'); - this.setCssVar('blink-node-duration', state ? '0.7s' : '0'); -}; - -/** - * Set the mouse cursor style based on the current terminal mode. - */ -hterm.Terminal.prototype.syncMouseStyle = function() { - this.setCssVar('mouse-cursor-style', - this.vt.mouseReport == this.vt.MOUSE_REPORT_DISABLED ? - 'var(--hterm-mouse-cursor-text)' : - 'var(--hterm-mouse-cursor-pointer)'); -}; - -/** - * Return a copy of the current cursor position. - * - * @return {hterm.RowCol} The RowCol object representing the current position. - */ -hterm.Terminal.prototype.saveCursor = function() { - return this.screen_.cursorPosition.clone(); -}; - -/** - * Return the current text attributes. - * - * @return {string} - */ -hterm.Terminal.prototype.getTextAttributes = function() { - return this.screen_.textAttributes; -}; - -/** - * Set the text attributes. - * - * @param {string} textAttributes The attributes to set. - */ -hterm.Terminal.prototype.setTextAttributes = function(textAttributes) { - this.screen_.textAttributes = textAttributes; -}; - -/** - * Return the current browser zoom factor applied to the terminal. - * - * @return {number} The current browser zoom factor. - */ -hterm.Terminal.prototype.getZoomFactor = function() { - return this.scrollPort_.characterSize.zoomFactor; -}; - -/** - * Change the title of this terminal's window. - * - * @param {string} title The title to set. - */ -hterm.Terminal.prototype.setWindowTitle = function(title) { - window.document.title = title; -}; - -/** - * Restore a previously saved cursor position. - * - * @param {hterm.RowCol} cursor The position to restore. - */ -hterm.Terminal.prototype.restoreCursor = function(cursor) { - var row = lib.f.clamp(cursor.row, 0, this.screenSize.height - 1); - var column = lib.f.clamp(cursor.column, 0, this.screenSize.width - 1); - this.screen_.setCursorPosition(row, column); - if (cursor.column > column || - cursor.column == column && cursor.overflow) { - this.screen_.cursorPosition.overflow = true; - } -}; - -/** - * Clear the cursor's overflow flag. - */ -hterm.Terminal.prototype.clearCursorOverflow = function() { - this.screen_.cursorPosition.overflow = false; -}; - -/** - * Save the current cursor state to the corresponding screens. - * - * See the hterm.Screen.CursorState class for more details. - * - * @param {boolean=} both If true, update both screens, else only update the - * current screen. - */ -hterm.Terminal.prototype.saveCursorAndState = function(both) { - if (both) { - this.primaryScreen_.saveCursorAndState(this.vt); - this.alternateScreen_.saveCursorAndState(this.vt); - } else - this.screen_.saveCursorAndState(this.vt); -}; - -/** - * Restore the saved cursor state in the corresponding screens. - * - * See the hterm.Screen.CursorState class for more details. - * - * @param {boolean=} both If true, update both screens, else only update the - * current screen. - */ -hterm.Terminal.prototype.restoreCursorAndState = function(both) { - if (both) { - this.primaryScreen_.restoreCursorAndState(this.vt); - this.alternateScreen_.restoreCursorAndState(this.vt); - } else - this.screen_.restoreCursorAndState(this.vt); -}; - -/** - * Sets the cursor shape - * - * @param {string} shape The shape to set. - */ -hterm.Terminal.prototype.setCursorShape = function(shape) { - this.cursorShape_ = shape; - this.restyleCursor_(); -} - -/** - * Get the cursor shape - * - * @return {string} - */ -hterm.Terminal.prototype.getCursorShape = function() { - return this.cursorShape_; -} - -/** - * Set the width of the terminal, resizing the UI to match. - * - * @param {number} columnCount - */ -hterm.Terminal.prototype.setWidth = function(columnCount) { - if (columnCount == null) { - this.div_.style.width = '100%'; - return; - } - - this.div_.style.width = Math.ceil( - this.scrollPort_.characterSize.width * - columnCount + this.scrollPort_.currentScrollbarWidthPx) + 'px'; - this.realizeSize_(columnCount, this.screenSize.height); - this.scheduleSyncCursorPosition_(); -}; - -/** - * Set the height of the terminal, resizing the UI to match. - * - * @param {number} rowCount The height in rows. - */ -hterm.Terminal.prototype.setHeight = function(rowCount) { - if (rowCount == null) { - this.div_.style.height = '100%'; - return; - } - - this.div_.style.height = - this.scrollPort_.characterSize.height * rowCount + 'px'; - this.realizeSize_(this.screenSize.width, rowCount); - this.scheduleSyncCursorPosition_(); -}; - -/** - * Deal with terminal size changes. - * - * @param {number} columnCount The number of columns. - * @param {number} rowCount The number of rows. - */ -hterm.Terminal.prototype.realizeSize_ = function(columnCount, rowCount) { - if (columnCount != this.screenSize.width) - this.realizeWidth_(columnCount); - - if (rowCount != this.screenSize.height) - this.realizeHeight_(rowCount); - - // Send new terminal size to plugin. - this.io.onTerminalResize_(columnCount, rowCount); -}; - -/** - * Deal with terminal width changes. - * - * This function does what needs to be done when the terminal width changes - * out from under us. It happens here rather than in onResize_() because this - * code may need to run synchronously to handle programmatic changes of - * terminal width. - * - * Relying on the browser to send us an async resize event means we may not be - * in the correct state yet when the next escape sequence hits. - * - * @param {number} columnCount The number of columns. - */ -hterm.Terminal.prototype.realizeWidth_ = function(columnCount) { - if (columnCount <= 0) - throw new Error('Attempt to realize bad width: ' + columnCount); - - var deltaColumns = columnCount - this.screen_.getWidth(); - - this.screenSize.width = columnCount; - this.screen_.setColumnCount(columnCount); - - if (deltaColumns > 0) { - if (this.defaultTabStops) - this.setDefaultTabStops(this.screenSize.width - deltaColumns); - } else { - for (var i = this.tabStops_.length - 1; i >= 0; i--) { - if (this.tabStops_[i] < columnCount) - break; - - this.tabStops_.pop(); - } - } - - this.screen_.setColumnCount(this.screenSize.width); -}; - -/** - * Deal with terminal height changes. - * - * This function does what needs to be done when the terminal height changes - * out from under us. It happens here rather than in onResize_() because this - * code may need to run synchronously to handle programmatic changes of - * terminal height. - * - * Relying on the browser to send us an async resize event means we may not be - * in the correct state yet when the next escape sequence hits. - * - * @param {number} rowCount The number of rows. - */ -hterm.Terminal.prototype.realizeHeight_ = function(rowCount) { - if (rowCount <= 0) - throw new Error('Attempt to realize bad height: ' + rowCount); - - var deltaRows = rowCount - this.screen_.getHeight(); - - this.screenSize.height = rowCount; - - var cursor = this.saveCursor(); - - if (deltaRows < 0) { - // Screen got smaller. - deltaRows *= -1; - while (deltaRows) { - var lastRow = this.getRowCount() - 1; - if (lastRow - this.scrollbackRows_.length == cursor.row) - break; - - if (this.getRowText(lastRow)) - break; - - this.screen_.popRow(); - deltaRows--; - } - - var ary = this.screen_.shiftRows(deltaRows); - this.scrollbackRows_.push.apply(this.scrollbackRows_, ary); - - // We just removed rows from the top of the screen, we need to update - // the cursor to match. - cursor.row = Math.max(cursor.row - deltaRows, 0); - } else if (deltaRows > 0) { - // Screen got larger. - - if (deltaRows <= this.scrollbackRows_.length) { - var scrollbackCount = Math.min(deltaRows, this.scrollbackRows_.length); - var rows = this.scrollbackRows_.splice( - this.scrollbackRows_.length - scrollbackCount, scrollbackCount); - this.screen_.unshiftRows(rows); - deltaRows -= scrollbackCount; - cursor.row += scrollbackCount; - } - - if (deltaRows) - this.appendRows_(deltaRows); - } - - this.setVTScrollRegion(null, null); - this.restoreCursor(cursor); -}; - -/** - * Scroll the terminal to the top of the scrollback buffer. - */ -hterm.Terminal.prototype.scrollHome = function() { - this.scrollPort_.scrollRowToTop(0); -}; - -/** - * Scroll the terminal to the end. - */ -hterm.Terminal.prototype.scrollEnd = function() { - this.scrollPort_.scrollRowToBottom(this.getRowCount()); -}; - -/** - * Scroll the terminal one page up (minus one line) relative to the current - * position. - */ -hterm.Terminal.prototype.scrollPageUp = function() { - var i = this.scrollPort_.getTopRowIndex(); - this.scrollPort_.scrollRowToTop(i - this.screenSize.height + 1); -}; - -/** - * Scroll the terminal one page down (minus one line) relative to the current - * position. - */ -hterm.Terminal.prototype.scrollPageDown = function() { - var i = this.scrollPort_.getTopRowIndex(); - this.scrollPort_.scrollRowToTop(i + this.screenSize.height - 1); -}; - -/** - * Scroll the terminal one line up relative to the current position. - */ -hterm.Terminal.prototype.scrollLineUp = function() { - var i = this.scrollPort_.getTopRowIndex(); - this.scrollPort_.scrollRowToTop(i - 1); -}; - -/** - * Scroll the terminal one line down relative to the current position. - */ -hterm.Terminal.prototype.scrollLineDown = function() { - var i = this.scrollPort_.getTopRowIndex(); - this.scrollPort_.scrollRowToTop(i + 1); -}; - -/** - * Clear primary screen, secondary screen, and the scrollback buffer. - */ -hterm.Terminal.prototype.wipeContents = function() { - this.scrollbackRows_.length = 0; - this.scrollPort_.resetCache(); - - [this.primaryScreen_, this.alternateScreen_].forEach(function(screen) { - var bottom = screen.getHeight(); - if (bottom > 0) { - this.renumberRows_(0, bottom); - this.clearHome(screen); - } - }.bind(this)); - - this.syncCursorPosition_(); - this.scrollPort_.invalidate(); -}; - -/** - * Full terminal reset. - * - * Perform a full reset to the default values listed in - * https://vt100.net/docs/vt510-rm/RIS.html - */ -hterm.Terminal.prototype.reset = function() { - this.vt.reset(); - - this.clearAllTabStops(); - this.setDefaultTabStops(); - - const resetScreen = (screen) => { - // We want to make sure to reset the attributes before we clear the screen. - // The attributes might be used to initialize default/empty rows. - screen.textAttributes.reset(); - screen.textAttributes.resetColorPalette(); - this.clearHome(screen); - screen.saveCursorAndState(this.vt); - }; - resetScreen(this.primaryScreen_); - resetScreen(this.alternateScreen_); - - // Reset terminal options to their default values. - this.options_ = new hterm.Options(); - this.setCursorBlink(!!this.prefs_.get('cursor-blink')); - - this.setVTScrollRegion(null, null); - - this.setCursorVisible(true); -}; - -/** - * Soft terminal reset. - * - * Perform a soft reset to the default values listed in - * http://www.vt100.net/docs/vt510-rm/DECSTR#T5-9 - */ -hterm.Terminal.prototype.softReset = function() { - this.vt.reset(); - - // Reset terminal options to their default values. - this.options_ = new hterm.Options(); - - // We show the cursor on soft reset but do not alter the blink state. - this.options_.cursorBlink = !!this.timeouts_.cursorBlink; - - const resetScreen = (screen) => { - // Xterm also resets the color palette on soft reset, even though it doesn't - // seem to be documented anywhere. - screen.textAttributes.reset(); - screen.textAttributes.resetColorPalette(); - screen.saveCursorAndState(this.vt); - }; - resetScreen(this.primaryScreen_); - resetScreen(this.alternateScreen_); - - // The xterm man page explicitly says this will happen on soft reset. - this.setVTScrollRegion(null, null); - - // Xterm also shows the cursor on soft reset, but does not alter the blink - // state. - this.setCursorVisible(true); -}; - -/** - * Move the cursor forward to the next tab stop, or to the last column - * if no more tab stops are set. - */ -hterm.Terminal.prototype.forwardTabStop = function() { - var column = this.screen_.cursorPosition.column; - - for (var i = 0; i < this.tabStops_.length; i++) { - if (this.tabStops_[i] > column) { - this.setCursorColumn(this.tabStops_[i]); - return; - } - } - - // xterm does not clear the overflow flag on HT or CHT. - var overflow = this.screen_.cursorPosition.overflow; - this.setCursorColumn(this.screenSize.width - 1); - this.screen_.cursorPosition.overflow = overflow; -}; - -/** - * Move the cursor backward to the previous tab stop, or to the first column - * if no previous tab stops are set. - */ -hterm.Terminal.prototype.backwardTabStop = function() { - var column = this.screen_.cursorPosition.column; - - for (var i = this.tabStops_.length - 1; i >= 0; i--) { - if (this.tabStops_[i] < column) { - this.setCursorColumn(this.tabStops_[i]); - return; - } - } - - this.setCursorColumn(1); -}; - -/** - * Set a tab stop at the given column. - * - * @param {integer} column Zero based column. - */ -hterm.Terminal.prototype.setTabStop = function(column) { - for (var i = this.tabStops_.length - 1; i >= 0; i--) { - if (this.tabStops_[i] == column) - return; - - if (this.tabStops_[i] < column) { - this.tabStops_.splice(i + 1, 0, column); - return; - } - } - - this.tabStops_.splice(0, 0, column); -}; - -/** - * Clear the tab stop at the current cursor position. - * - * No effect if there is no tab stop at the current cursor position. - */ -hterm.Terminal.prototype.clearTabStopAtCursor = function() { - var column = this.screen_.cursorPosition.column; - - var i = this.tabStops_.indexOf(column); - if (i == -1) - return; - - this.tabStops_.splice(i, 1); -}; - -/** - * Clear all tab stops. - */ -hterm.Terminal.prototype.clearAllTabStops = function() { - this.tabStops_.length = 0; - this.defaultTabStops = false; -}; - -/** - * Set up the default tab stops, starting from a given column. - * - * This sets a tabstop every (column % this.tabWidth) column, starting - * from the specified column, or 0 if no column is provided. It also flags - * future resizes to set them up. - * - * This does not clear the existing tab stops first, use clearAllTabStops - * for that. - * - * @param {integer} opt_start Optional starting zero based starting column, useful - * for filling out missing tab stops when the terminal is resized. - */ -hterm.Terminal.prototype.setDefaultTabStops = function(opt_start) { - var start = opt_start || 0; - var w = this.tabWidth; - // Round start up to a default tab stop. - start = start - 1 - ((start - 1) % w) + w; - for (var i = start; i < this.screenSize.width; i += w) { - this.setTabStop(i); - } - - this.defaultTabStops = true; -}; - -/** - * Interpret a sequence of characters. - * - * Incomplete escape sequences are buffered until the next call. - * - * @param {string} str Sequence of characters to interpret or pass through. - */ -hterm.Terminal.prototype.interpret = function(str) { - this.vt.interpret(str); - this.scheduleSyncCursorPosition_(); -}; - -/** - * Take over the given DIV for use as the terminal display. - * - * @param {HTMLDivElement} div The div to use as the terminal display. - */ -hterm.Terminal.prototype.decorate = function(div) { - const charset = div.ownerDocument.characterSet.toLowerCase(); - if (charset != 'utf-8') { - console.warn(`Document encoding should be set to utf-8, not "${charset}";` + - ` Add to your HTML to fix.`); - } - - this.div_ = div; - - this.scrollPort_.decorate(div); - this.scrollPort_.setBackgroundImage(this.prefs_.get('background-image')); - this.scrollPort_.setBackgroundSize(this.prefs_.get('background-size')); - this.scrollPort_.setBackgroundPosition( - this.prefs_.get('background-position')); - this.scrollPort_.setUserCssUrl(this.prefs_.get('user-css')); - this.scrollPort_.setUserCssText(this.prefs_.get('user-css-text')); - - this.div_.focus = this.focus.bind(this); - - this.setFontSize(this.prefs_.get('font-size')); - this.syncFontFamily(); - - this.setScrollbarVisible(this.prefs_.get('scrollbar-visible')); - this.setScrollWheelMoveMultipler( - this.prefs_.get('scroll-wheel-move-multiplier')); - - this.document_ = this.scrollPort_.getDocument(); - - this.document_.body.oncontextmenu = function() { return false; }; - - var onMouse = this.onMouse_.bind(this); - var screenNode = this.scrollPort_.getScreenNode(); - screenNode.addEventListener('mousedown', onMouse); - screenNode.addEventListener('mouseup', onMouse); - screenNode.addEventListener('mousemove', onMouse); - this.scrollPort_.onScrollWheel = onMouse; - - screenNode.addEventListener( - 'focus', this.onFocusChange_.bind(this, true)); - // Listen for mousedown events on the screenNode as in FF the focus - // events don't bubble. - screenNode.addEventListener('mousedown', function() { - setTimeout(this.onFocusChange_.bind(this, true)); - }.bind(this)); - - screenNode.addEventListener( - 'blur', this.onFocusChange_.bind(this, false)); - - var style = this.document_.createElement('style'); - style.textContent = - ('.cursor-node[focus="false"] {' + - ' box-sizing: border-box;' + - ' background-color: transparent !important;' + - ' border-width: 2px;' + - ' border-style: solid;' + - '}' + - '.wc-node {' + - ' display: inline-block;' + - ' text-align: center;' + - ' width: calc(var(--hterm-charsize-width) * 2);' + - ' line-height: var(--hterm-charsize-height);' + - '}' + - ':root {' + - ' --hterm-charsize-width: ' + this.scrollPort_.characterSize.width + 'px;' + - ' --hterm-charsize-height: ' + this.scrollPort_.characterSize.height + 'px;' + - // Default position hides the cursor for when the window is initializing. - ' --hterm-cursor-offset-col: -1;' + - ' --hterm-cursor-offset-row: -1;' + - ' --hterm-blink-node-duration: 0.7s;' + - ' --hterm-mouse-cursor-text: text;' + - ' --hterm-mouse-cursor-pointer: default;' + - ' --hterm-mouse-cursor-style: var(--hterm-mouse-cursor-text);' + - '}' + - '.uri-node:hover {' + - ' text-decoration: underline;' + - ' cursor: pointer;' + - '}' + - '@keyframes blink {' + - ' from { opacity: 1.0; }' + - ' to { opacity: 0.0; }' + - '}' + - '.blink-node {' + - ' animation-name: blink;' + - ' animation-duration: var(--hterm-blink-node-duration);' + - ' animation-iteration-count: infinite;' + - ' animation-timing-function: ease-in-out;' + - ' animation-direction: alternate;' + - '}'); - this.document_.head.appendChild(style); - - this.cursorNode_ = this.document_.createElement('div'); - this.cursorNode_.id = 'hterm:terminal-cursor'; - this.cursorNode_.className = 'cursor-node'; - this.cursorNode_.style.cssText = - ('position: absolute;' + - 'left: calc(var(--hterm-charsize-width) * var(--hterm-cursor-offset-col));' + - 'top: calc(var(--hterm-charsize-height) * var(--hterm-cursor-offset-row));' + - 'display: block;' + - 'width: var(--hterm-charsize-width);' + - 'height: var(--hterm-charsize-height);' + - '-webkit-transition: opacity, background-color 100ms linear;' + - '-moz-transition: opacity, background-color 100ms linear;'); - - this.setCursorColor(); - this.setCursorBlink(!!this.prefs_.get('cursor-blink')); - this.restyleCursor_(); - - this.document_.body.appendChild(this.cursorNode_); - - // When 'enableMouseDragScroll' is off we reposition this element directly - // under the mouse cursor after a click. This makes Chrome associate - // subsequent mousemove events with the scroll-blocker. Since the - // scroll-blocker is a peer (not a child) of the scrollport, the mousemove - // events do not cause the scrollport to scroll. - // - // It's a hack, but it's the cleanest way I could find. - this.scrollBlockerNode_ = this.document_.createElement('div'); - this.scrollBlockerNode_.id = 'hterm:mouse-drag-scroll-blocker'; - this.scrollBlockerNode_.style.cssText = - ('position: absolute;' + - 'top: -99px;' + - 'display: block;' + - 'width: 10px;' + - 'height: 10px;'); - this.document_.body.appendChild(this.scrollBlockerNode_); - - this.scrollPort_.onScrollWheel = onMouse; - ['mousedown', 'mouseup', 'mousemove', 'click', 'dblclick', - ].forEach(function(event) { - this.scrollBlockerNode_.addEventListener(event, onMouse); - this.cursorNode_.addEventListener(event, onMouse); - this.document_.addEventListener(event, onMouse); - }.bind(this)); - - this.cursorNode_.addEventListener('mousedown', function() { - setTimeout(this.focus.bind(this)); - }.bind(this)); - - this.setReverseVideo(false); - - this.scrollPort_.focus(); - this.scrollPort_.scheduleRedraw(); -}; - -/** - * Return the HTML document that contains the terminal DOM nodes. - * - * @return {HTMLDocument} - */ -hterm.Terminal.prototype.getDocument = function() { - return this.document_; -}; - -/** - * Focus the terminal. - */ -hterm.Terminal.prototype.focus = function() { - this.scrollPort_.focus(); -}; - -/** - * Return the HTML Element for a given row index. - * - * This is a method from the RowProvider interface. The ScrollPort uses - * it to fetch rows on demand as they are scrolled into view. - * - * TODO(rginda): Consider saving scrollback rows as (HTML source, text content) - * pairs to conserve memory. - * - * @param {integer} index The zero-based row index, measured relative to the - * start of the scrollback buffer. On-screen rows will always have the - * largest indices. - * @return {HTMLElement} The 'x-row' element containing for the requested row. - */ -hterm.Terminal.prototype.getRowNode = function(index) { - if (index < this.scrollbackRows_.length) - return this.scrollbackRows_[index]; - - var screenIndex = index - this.scrollbackRows_.length; - return this.screen_.rowsArray[screenIndex]; -}; - -/** - * Return the text content for a given range of rows. - * - * This is a method from the RowProvider interface. The ScrollPort uses - * it to fetch text content on demand when the user attempts to copy their - * selection to the clipboard. - * - * @param {integer} start The zero-based row index to start from, measured - * relative to the start of the scrollback buffer. On-screen rows will - * always have the largest indices. - * @param {integer} end The zero-based row index to end on, measured - * relative to the start of the scrollback buffer. - * @return {string} A single string containing the text value of the range of - * rows. Lines will be newline delimited, with no trailing newline. - */ -hterm.Terminal.prototype.getRowsText = function(start, end) { - var ary = []; - for (var i = start; i < end; i++) { - var node = this.getRowNode(i); - ary.push(node.textContent); - if (i < end - 1 && !node.getAttribute('line-overflow')) - ary.push('\n'); - } - - return ary.join(''); -}; - -/** - * Return the text content for a given row. - * - * This is a method from the RowProvider interface. The ScrollPort uses - * it to fetch text content on demand when the user attempts to copy their - * selection to the clipboard. - * - * @param {integer} index The zero-based row index to return, measured - * relative to the start of the scrollback buffer. On-screen rows will - * always have the largest indices. - * @return {string} A string containing the text value of the selected row. - */ -hterm.Terminal.prototype.getRowText = function(index) { - var node = this.getRowNode(index); - return node.textContent; -}; - -/** - * Return the total number of rows in the addressable screen and in the - * scrollback buffer of this terminal. - * - * This is a method from the RowProvider interface. The ScrollPort uses - * it to compute the size of the scrollbar. - * - * @return {integer} The number of rows in this terminal. - */ -hterm.Terminal.prototype.getRowCount = function() { - return this.scrollbackRows_.length + this.screen_.rowsArray.length; -}; - -/** - * Create DOM nodes for new rows and append them to the end of the terminal. - * - * This is the only correct way to add a new DOM node for a row. Notice that - * the new row is appended to the bottom of the list of rows, and does not - * require renumbering (of the rowIndex property) of previous rows. - * - * If you think you want a new blank row somewhere in the middle of the - * terminal, look into moveRows_(). - * - * This method does not pay attention to vtScrollTop/Bottom, since you should - * be using moveRows() in cases where they would matter. - * - * The cursor will be positioned at column 0 of the first inserted line. - * - * @param {number} count The number of rows to created. - */ -hterm.Terminal.prototype.appendRows_ = function(count) { - var cursorRow = this.screen_.rowsArray.length; - var offset = this.scrollbackRows_.length + cursorRow; - for (var i = 0; i < count; i++) { - var row = this.document_.createElement('x-row'); - row.appendChild(this.document_.createTextNode('')); - row.rowIndex = offset + i; - this.screen_.pushRow(row); - } - - var extraRows = this.screen_.rowsArray.length - this.screenSize.height; - if (extraRows > 0) { - var ary = this.screen_.shiftRows(extraRows); - Array.prototype.push.apply(this.scrollbackRows_, ary); - if (this.scrollPort_.isScrolledEnd) - this.scheduleScrollDown_(); - } - - if (cursorRow >= this.screen_.rowsArray.length) - cursorRow = this.screen_.rowsArray.length - 1; - - this.setAbsoluteCursorPosition(cursorRow, 0); -}; - -/** - * Relocate rows from one part of the addressable screen to another. - * - * This is used to recycle rows during VT scrolls (those which are driven - * by VT commands, rather than by the user manipulating the scrollbar.) - * - * In this case, the blank lines scrolled into the scroll region are made of - * the nodes we scrolled off. These have their rowIndex properties carefully - * renumbered so as not to confuse the ScrollPort. - * - * @param {number} fromIndex The start index. - * @param {number} count The number of rows to move. - * @param {number} toIndex The destination index. - */ -hterm.Terminal.prototype.moveRows_ = function(fromIndex, count, toIndex) { - var ary = this.screen_.removeRows(fromIndex, count); - this.screen_.insertRows(toIndex, ary); - - var start, end; - if (fromIndex < toIndex) { - start = fromIndex; - end = toIndex + count; - } else { - start = toIndex; - end = fromIndex + count; - } - - this.renumberRows_(start, end); - this.scrollPort_.scheduleInvalidate(); -}; - -/** - * Renumber the rowIndex property of the given range of rows. - * - * The start and end indices are relative to the screen, not the scrollback. - * Rows in the scrollback buffer cannot be renumbered. Since they are not - * addressable (you can't delete them, scroll them, etc), you should have - * no need to renumber scrollback rows. - * - * @param {number} start The start index. - * @param {number} end The end index. - * @param {hterm.Screen} opt_screen The screen to renumber. - */ -hterm.Terminal.prototype.renumberRows_ = function(start, end, opt_screen) { - var screen = opt_screen || this.screen_; - - var offset = this.scrollbackRows_.length; - for (var i = start; i < end; i++) { - screen.rowsArray[i].rowIndex = offset + i; - } -}; - -/** - * Print a string to the terminal. - * - * This respects the current insert and wraparound modes. It will add new lines - * to the end of the terminal, scrolling off the top into the scrollback buffer - * if necessary. - * - * The string is *not* parsed for escape codes. Use the interpret() method if - * that's what you're after. - * - * @param{string} str The string to print. - */ -hterm.Terminal.prototype.print = function(str) { - var startOffset = 0; - - var strWidth = lib.wc.strWidth(str); - // Fun edge case: If the string only contains zero width codepoints (like - // combining characters), we make sure to iterate at least once below. - if (strWidth == 0 && str) - strWidth = 1; - - while (startOffset < strWidth) { - if (this.options_.wraparound && this.screen_.cursorPosition.overflow) { - this.screen_.commitLineOverflow(); - this.newLine(); - } - - var count = strWidth - startOffset; - var didOverflow = false; - var substr; - - if (this.screen_.cursorPosition.column + count >= this.screenSize.width) { - didOverflow = true; - count = this.screenSize.width - this.screen_.cursorPosition.column; - } - - if (didOverflow && !this.options_.wraparound) { - // If the string overflowed the line but wraparound is off, then the - // last printed character should be the last of the string. - // TODO: This will add to our problems with multibyte UTF-16 characters. - substr = lib.wc.substr(str, startOffset, count - 1) + - lib.wc.substr(str, strWidth - 1); - count = strWidth; - } else { - substr = lib.wc.substr(str, startOffset, count); - } - - var tokens = hterm.TextAttributes.splitWidecharString(substr); - for (var i = 0; i < tokens.length; i++) { - this.screen_.textAttributes.wcNode = tokens[i].wcNode; - this.screen_.textAttributes.asciiNode = tokens[i].asciiNode; - - if (this.options_.insertMode) { - this.screen_.insertString(tokens[i].str, tokens[i].wcStrWidth); - } else { - this.screen_.overwriteString(tokens[i].str, tokens[i].wcStrWidth); - } - this.screen_.textAttributes.wcNode = false; - this.screen_.textAttributes.asciiNode = true; - } - - this.screen_.maybeClipCurrentRow(); - startOffset += count; - } - - this.scheduleSyncCursorPosition_(); - - if (this.scrollOnOutput_) - this.scrollPort_.scrollRowToBottom(this.getRowCount()); -}; - -/** - * Set the VT scroll region. - * - * This also resets the cursor position to the absolute (0, 0) position, since - * that's what xterm appears to do. - * - * Setting the scroll region to the full height of the terminal will clear - * the scroll region. This is *NOT* what most terminals do. We're explicitly - * going "off-spec" here because it makes `screen` and `tmux` overflow into the - * local scrollback buffer, which means the scrollbars and shift-pgup/pgdn - * continue to work as most users would expect. - * - * @param {integer} scrollTop The zero-based top of the scroll region. - * @param {integer} scrollBottom The zero-based bottom of the scroll region, - * inclusive. - */ -hterm.Terminal.prototype.setVTScrollRegion = function(scrollTop, scrollBottom) { - if (scrollTop == 0 && scrollBottom == this.screenSize.height - 1) { - this.vtScrollTop_ = null; - this.vtScrollBottom_ = null; - } else { - this.vtScrollTop_ = scrollTop; - this.vtScrollBottom_ = scrollBottom; - } -}; - -/** - * Return the top row index according to the VT. - * - * This will return 0 unless the terminal has been told to restrict scrolling - * to some lower row. It is used for some VT cursor positioning and scrolling - * commands. - * - * @return {integer} The topmost row in the terminal's scroll region. - */ -hterm.Terminal.prototype.getVTScrollTop = function() { - if (this.vtScrollTop_ != null) - return this.vtScrollTop_; - - return 0; -}; - -/** - * Return the bottom row index according to the VT. - * - * This will return the height of the terminal unless the it has been told to - * restrict scrolling to some higher row. It is used for some VT cursor - * positioning and scrolling commands. - * - * @return {integer} The bottom most row in the terminal's scroll region. - */ -hterm.Terminal.prototype.getVTScrollBottom = function() { - if (this.vtScrollBottom_ != null) - return this.vtScrollBottom_; - - return this.screenSize.height - 1; -} - -/** - * Process a '\n' character. - * - * If the cursor is on the final row of the terminal this will append a new - * blank row to the screen and scroll the topmost row into the scrollback - * buffer. - * - * Otherwise, this moves the cursor to column zero of the next row. - */ -hterm.Terminal.prototype.newLine = function() { - var cursorAtEndOfScreen = (this.screen_.cursorPosition.row == - this.screen_.rowsArray.length - 1); - - if (this.vtScrollBottom_ != null) { - // A VT Scroll region is active, we never append new rows. - if (this.screen_.cursorPosition.row == this.vtScrollBottom_) { - // We're at the end of the VT Scroll Region, perform a VT scroll. - this.vtScrollUp(1); - this.setAbsoluteCursorPosition(this.screen_.cursorPosition.row, 0); - } else if (cursorAtEndOfScreen) { - // We're at the end of the screen, the only thing to do is put the - // cursor to column 0. - this.setAbsoluteCursorPosition(this.screen_.cursorPosition.row, 0); - } else { - // Anywhere else, advance the cursor row, and reset the column. - this.setAbsoluteCursorPosition(this.screen_.cursorPosition.row + 1, 0); - } - } else if (cursorAtEndOfScreen) { - // We're at the end of the screen. Append a new row to the terminal, - // shifting the top row into the scrollback. - this.appendRows_(1); - } else { - // Anywhere else in the screen just moves the cursor. - this.setAbsoluteCursorPosition(this.screen_.cursorPosition.row + 1, 0); - } -}; - -/** - * Like newLine(), except maintain the cursor column. - */ -hterm.Terminal.prototype.lineFeed = function() { - var column = this.screen_.cursorPosition.column; - this.newLine(); - this.setCursorColumn(column); -}; - -/** - * If autoCarriageReturn is set then newLine(), else lineFeed(). - */ -hterm.Terminal.prototype.formFeed = function() { - if (this.options_.autoCarriageReturn) { - this.newLine(); - } else { - this.lineFeed(); - } -}; - -/** - * Move the cursor up one row, possibly inserting a blank line. - * - * The cursor column is not changed. - */ -hterm.Terminal.prototype.reverseLineFeed = function() { - var scrollTop = this.getVTScrollTop(); - var currentRow = this.screen_.cursorPosition.row; - - if (currentRow == scrollTop) { - this.insertLines(1); - } else { - this.setAbsoluteCursorRow(currentRow - 1); - } -}; - -/** - * Replace all characters to the left of the current cursor with the space - * character. - * - * TODO(rginda): This should probably *remove* the characters (not just replace - * with a space) if there are no characters at or beyond the current cursor - * position. - */ -hterm.Terminal.prototype.eraseToLeft = function() { - var cursor = this.saveCursor(); - this.setCursorColumn(0); - const count = cursor.column + 1; - this.screen_.overwriteString(lib.f.getWhitespace(count), count); - this.restoreCursor(cursor); -}; - -/** - * Erase a given number of characters to the right of the cursor. - * - * The cursor position is unchanged. - * - * If the current background color is not the default background color this - * will insert spaces rather than delete. This is unfortunate because the - * trailing space will affect text selection, but it's difficult to come up - * with a way to style empty space that wouldn't trip up the hterm.Screen - * code. - * - * eraseToRight is ignored in the presence of a cursor overflow. This deviates - * from xterm, but agrees with gnome-terminal and konsole, xfce4-terminal. See - * crbug.com/232390 for details. - * - * @param {number} opt_count The number of characters to erase. - */ -hterm.Terminal.prototype.eraseToRight = function(opt_count) { - if (this.screen_.cursorPosition.overflow) - return; - - var maxCount = this.screenSize.width - this.screen_.cursorPosition.column; - var count = opt_count ? Math.min(opt_count, maxCount) : maxCount; - - if (this.screen_.textAttributes.background === - this.screen_.textAttributes.DEFAULT_COLOR) { - var cursorRow = this.screen_.rowsArray[this.screen_.cursorPosition.row]; - if (hterm.TextAttributes.nodeWidth(cursorRow) <= - this.screen_.cursorPosition.column + count) { - this.screen_.deleteChars(count); - this.clearCursorOverflow(); - return; - } - } - - var cursor = this.saveCursor(); - this.screen_.overwriteString(lib.f.getWhitespace(count), count); - this.restoreCursor(cursor); - this.clearCursorOverflow(); -}; - -/** - * Erase the current line. - * - * The cursor position is unchanged. - */ -hterm.Terminal.prototype.eraseLine = function() { - var cursor = this.saveCursor(); - this.screen_.clearCursorRow(); - this.restoreCursor(cursor); - this.clearCursorOverflow(); -}; - -/** - * Erase all characters from the start of the screen to the current cursor - * position, regardless of scroll region. - * - * The cursor position is unchanged. - */ -hterm.Terminal.prototype.eraseAbove = function() { - var cursor = this.saveCursor(); - - this.eraseToLeft(); - - for (var i = 0; i < cursor.row; i++) { - this.setAbsoluteCursorPosition(i, 0); - this.screen_.clearCursorRow(); - } - - this.restoreCursor(cursor); - this.clearCursorOverflow(); -}; - -/** - * Erase all characters from the current cursor position to the end of the - * screen, regardless of scroll region. - * - * The cursor position is unchanged. - */ -hterm.Terminal.prototype.eraseBelow = function() { - var cursor = this.saveCursor(); - - this.eraseToRight(); - - var bottom = this.screenSize.height - 1; - for (var i = cursor.row + 1; i <= bottom; i++) { - this.setAbsoluteCursorPosition(i, 0); - this.screen_.clearCursorRow(); - } - - this.restoreCursor(cursor); - this.clearCursorOverflow(); -}; - -/** - * Fill the terminal with a given character. - * - * This methods does not respect the VT scroll region. - * - * @param {string} ch The character to use for the fill. - */ -hterm.Terminal.prototype.fill = function(ch) { - var cursor = this.saveCursor(); - - this.setAbsoluteCursorPosition(0, 0); - for (var row = 0; row < this.screenSize.height; row++) { - for (var col = 0; col < this.screenSize.width; col++) { - this.setAbsoluteCursorPosition(row, col); - this.screen_.overwriteString(ch, 1); - } - } - - this.restoreCursor(cursor); -}; - -/** - * Erase the entire display and leave the cursor at (0, 0). - * - * This does not respect the scroll region. - * - * @param {hterm.Screen} opt_screen Optional screen to operate on. Defaults - * to the current screen. - */ -hterm.Terminal.prototype.clearHome = function(opt_screen) { - var screen = opt_screen || this.screen_; - var bottom = screen.getHeight(); - - if (bottom == 0) { - // Empty screen, nothing to do. - return; - } - - for (var i = 0; i < bottom; i++) { - screen.setCursorPosition(i, 0); - screen.clearCursorRow(); - } - - screen.setCursorPosition(0, 0); -}; - -/** - * Erase the entire display without changing the cursor position. - * - * The cursor position is unchanged. This does not respect the scroll - * region. - * - * @param {hterm.Screen} opt_screen Optional screen to operate on. Defaults - * to the current screen. - */ -hterm.Terminal.prototype.clear = function(opt_screen) { - var screen = opt_screen || this.screen_; - var cursor = screen.cursorPosition.clone(); - this.clearHome(screen); - screen.setCursorPosition(cursor.row, cursor.column); -}; - -/** - * VT command to insert lines at the current cursor row. - * - * This respects the current scroll region. Rows pushed off the bottom are - * lost (they won't show up in the scrollback buffer). - * - * @param {integer} count The number of lines to insert. - */ -hterm.Terminal.prototype.insertLines = function(count) { - var cursorRow = this.screen_.cursorPosition.row; - - var bottom = this.getVTScrollBottom(); - count = Math.min(count, bottom - cursorRow); - - // The moveCount is the number of rows we need to relocate to make room for - // the new row(s). The count is the distance to move them. - var moveCount = bottom - cursorRow - count + 1; - if (moveCount) - this.moveRows_(cursorRow, moveCount, cursorRow + count); - - for (var i = count - 1; i >= 0; i--) { - this.setAbsoluteCursorPosition(cursorRow + i, 0); - this.screen_.clearCursorRow(); - } -}; - -/** - * VT command to delete lines at the current cursor row. - * - * New rows are added to the bottom of scroll region to take their place. New - * rows are strictly there to take up space and have no content or style. - * - * @param {number} count The number of lines to delete. - */ -hterm.Terminal.prototype.deleteLines = function(count) { - var cursor = this.saveCursor(); - - var top = cursor.row; - var bottom = this.getVTScrollBottom(); - - var maxCount = bottom - top + 1; - count = Math.min(count, maxCount); - - var moveStart = bottom - count + 1; - if (count != maxCount) - this.moveRows_(top, count, moveStart); - - for (var i = 0; i < count; i++) { - this.setAbsoluteCursorPosition(moveStart + i, 0); - this.screen_.clearCursorRow(); - } - - this.restoreCursor(cursor); - this.clearCursorOverflow(); -}; - -/** - * Inserts the given number of spaces at the current cursor position. - * - * The cursor position is not changed. - * - * @param {number} count The number of spaces to insert. - */ -hterm.Terminal.prototype.insertSpace = function(count) { - var cursor = this.saveCursor(); - - var ws = lib.f.getWhitespace(count || 1); - this.screen_.insertString(ws, ws.length); - this.screen_.maybeClipCurrentRow(); - - this.restoreCursor(cursor); - this.clearCursorOverflow(); -}; - -/** - * Forward-delete the specified number of characters starting at the cursor - * position. - * - * @param {integer} count The number of characters to delete. - */ -hterm.Terminal.prototype.deleteChars = function(count) { - var deleted = this.screen_.deleteChars(count); - if (deleted && !this.screen_.textAttributes.isDefault()) { - var cursor = this.saveCursor(); - this.setCursorColumn(this.screenSize.width - deleted); - this.screen_.insertString(lib.f.getWhitespace(deleted)); - this.restoreCursor(cursor); - } - - this.clearCursorOverflow(); -}; - -/** - * Shift rows in the scroll region upwards by a given number of lines. - * - * New rows are inserted at the bottom of the scroll region to fill the - * vacated rows. The new rows not filled out with the current text attributes. - * - * This function does not affect the scrollback rows at all. Rows shifted - * off the top are lost. - * - * The cursor position is not altered. - * - * @param {integer} count The number of rows to scroll. - */ -hterm.Terminal.prototype.vtScrollUp = function(count) { - var cursor = this.saveCursor(); - - this.setAbsoluteCursorRow(this.getVTScrollTop()); - this.deleteLines(count); - - this.restoreCursor(cursor); -}; - -/** - * Shift rows below the cursor down by a given number of lines. - * - * This function respects the current scroll region. - * - * New rows are inserted at the top of the scroll region to fill the - * vacated rows. The new rows not filled out with the current text attributes. - * - * This function does not affect the scrollback rows at all. Rows shifted - * off the bottom are lost. - * - * @param {integer} count The number of rows to scroll. - */ -hterm.Terminal.prototype.vtScrollDown = function(opt_count) { - var cursor = this.saveCursor(); - - this.setAbsoluteCursorPosition(this.getVTScrollTop(), 0); - this.insertLines(opt_count); - - this.restoreCursor(cursor); -}; - - -/** - * Set the cursor position. - * - * The cursor row is relative to the scroll region if the terminal has - * 'origin mode' enabled, or relative to the addressable screen otherwise. - * - * @param {integer} row The new zero-based cursor row. - * @param {integer} row The new zero-based cursor column. - */ -hterm.Terminal.prototype.setCursorPosition = function(row, column) { - if (this.options_.originMode) { - this.setRelativeCursorPosition(row, column); - } else { - this.setAbsoluteCursorPosition(row, column); - } -}; - -/** - * Move the cursor relative to its current position. - * - * @param {number} row - * @param {number} column - */ -hterm.Terminal.prototype.setRelativeCursorPosition = function(row, column) { - var scrollTop = this.getVTScrollTop(); - row = lib.f.clamp(row + scrollTop, scrollTop, this.getVTScrollBottom()); - column = lib.f.clamp(column, 0, this.screenSize.width - 1); - this.screen_.setCursorPosition(row, column); -}; - -/** - * Move the cursor to the specified position. - * - * @param {number} row - * @param {number} column - */ -hterm.Terminal.prototype.setAbsoluteCursorPosition = function(row, column) { - row = lib.f.clamp(row, 0, this.screenSize.height - 1); - column = lib.f.clamp(column, 0, this.screenSize.width - 1); - this.screen_.setCursorPosition(row, column); -}; - -/** - * Set the cursor column. - * - * @param {integer} column The new zero-based cursor column. - */ -hterm.Terminal.prototype.setCursorColumn = function(column) { - this.setAbsoluteCursorPosition(this.screen_.cursorPosition.row, column); -}; - -/** - * Return the cursor column. - * - * @return {integer} The zero-based cursor column. - */ -hterm.Terminal.prototype.getCursorColumn = function() { - return this.screen_.cursorPosition.column; -}; - -/** - * Set the cursor row. - * - * The cursor row is relative to the scroll region if the terminal has - * 'origin mode' enabled, or relative to the addressable screen otherwise. - * - * @param {integer} row The new cursor row. - */ -hterm.Terminal.prototype.setAbsoluteCursorRow = function(row) { - this.setAbsoluteCursorPosition(row, this.screen_.cursorPosition.column); -}; - -/** - * Return the cursor row. - * - * @return {integer} The zero-based cursor row. - */ -hterm.Terminal.prototype.getCursorRow = function() { - return this.screen_.cursorPosition.row; -}; - -/** - * Request that the ScrollPort redraw itself soon. - * - * The redraw will happen asynchronously, soon after the call stack winds down. - * Multiple calls will be coalesced into a single redraw. - */ -hterm.Terminal.prototype.scheduleRedraw_ = function() { - if (this.timeouts_.redraw) - return; - - var self = this; - this.timeouts_.redraw = setTimeout(function() { - delete self.timeouts_.redraw; - self.scrollPort_.redraw_(); - }, 0); -}; - -/** - * Request that the ScrollPort be scrolled to the bottom. - * - * The scroll will happen asynchronously, soon after the call stack winds down. - * Multiple calls will be coalesced into a single scroll. - * - * This affects the scrollbar position of the ScrollPort, and has nothing to - * do with the VT scroll commands. - */ -hterm.Terminal.prototype.scheduleScrollDown_ = function() { - if (this.timeouts_.scrollDown) - return; - - var self = this; - this.timeouts_.scrollDown = setTimeout(function() { - delete self.timeouts_.scrollDown; - self.scrollPort_.scrollRowToBottom(self.getRowCount()); - }, 10); -}; - -/** - * Move the cursor up a specified number of rows. - * - * @param {integer} count The number of rows to move the cursor. - */ -hterm.Terminal.prototype.cursorUp = function(count) { - return this.cursorDown(-(count || 1)); -}; - -/** - * Move the cursor down a specified number of rows. - * - * @param {integer} count The number of rows to move the cursor. - */ -hterm.Terminal.prototype.cursorDown = function(count) { - count = count || 1; - var minHeight = (this.options_.originMode ? this.getVTScrollTop() : 0); - var maxHeight = (this.options_.originMode ? this.getVTScrollBottom() : - this.screenSize.height - 1); - - var row = lib.f.clamp(this.screen_.cursorPosition.row + count, - minHeight, maxHeight); - this.setAbsoluteCursorRow(row); -}; - -/** - * Move the cursor left a specified number of columns. - * - * If reverse wraparound mode is enabled and the previous row wrapped into - * the current row then we back up through the wraparound as well. - * - * @param {integer} count The number of columns to move the cursor. - */ -hterm.Terminal.prototype.cursorLeft = function(count) { - count = count || 1; - - if (count < 1) - return; - - var currentColumn = this.screen_.cursorPosition.column; - if (this.options_.reverseWraparound) { - if (this.screen_.cursorPosition.overflow) { - // If this cursor is in the right margin, consume one count to get it - // back to the last column. This only applies when we're in reverse - // wraparound mode. - count--; - this.clearCursorOverflow(); - - if (!count) - return; - } - - var newRow = this.screen_.cursorPosition.row; - var newColumn = currentColumn - count; - if (newColumn < 0) { - newRow = newRow - Math.floor(count / this.screenSize.width) - 1; - if (newRow < 0) { - // xterm also wraps from row 0 to the last row. - newRow = this.screenSize.height + newRow % this.screenSize.height; - } - newColumn = this.screenSize.width + newColumn % this.screenSize.width; - } - - this.setCursorPosition(Math.max(newRow, 0), newColumn); - - } else { - var newColumn = Math.max(currentColumn - count, 0); - this.setCursorColumn(newColumn); - } -}; - -/** - * Move the cursor right a specified number of columns. - * - * @param {integer} count The number of columns to move the cursor. - */ -hterm.Terminal.prototype.cursorRight = function(count) { - count = count || 1; - - if (count < 1) - return; - - var column = lib.f.clamp(this.screen_.cursorPosition.column + count, - 0, this.screenSize.width - 1); - this.setCursorColumn(column); -}; - -/** - * Reverse the foreground and background colors of the terminal. - * - * This only affects text that was drawn with no attributes. - * - * TODO(rginda): Test xterm to see if reverse is respected for text that has - * been drawn with attributes that happen to coincide with the default - * 'no-attribute' colors. My guess is probably not. - * - * @param {boolean} state The state to set. - */ -hterm.Terminal.prototype.setReverseVideo = function(state) { - this.options_.reverseVideo = state; - if (state) { - this.scrollPort_.setForegroundColor(this.prefs_.get('background-color')); - this.scrollPort_.setBackgroundColor(this.prefs_.get('foreground-color')); - } else { - this.scrollPort_.setForegroundColor(this.prefs_.get('foreground-color')); - this.scrollPort_.setBackgroundColor(this.prefs_.get('background-color')); - } -}; - -/** - * Ring the terminal bell. - * - * This will not play the bell audio more than once per second. - */ -hterm.Terminal.prototype.ringBell = function() { - this.cursorNode_.style.backgroundColor = - this.scrollPort_.getForegroundColor(); - - var self = this; - setTimeout(function() { - self.restyleCursor_(); - }, 200); - - // bellSquelchTimeout_ affects both audio and notification bells. - if (this.bellSquelchTimeout_) - return; - - if (this.bellAudio_.getAttribute('src')) { - this.bellAudio_.play(); - this.bellSequelchTimeout_ = setTimeout(function() { - delete this.bellSquelchTimeout_; - }.bind(this), 500); - } else { - delete this.bellSquelchTimeout_; - } - - if (this.desktopNotificationBell_ && !this.document_.hasFocus()) { - var n = hterm.notify(); - this.bellNotificationList_.push(n); - // TODO: Should we try to raise the window here? - n.onclick = function() { self.closeBellNotifications_(); }; - } -}; - -/** - * Set the origin mode bit. - * - * If origin mode is on, certain VT cursor and scrolling commands measure their - * row parameter relative to the VT scroll region. Otherwise, row 0 corresponds - * to the top of the addressable screen. - * - * Defaults to off. - * - * @param {boolean} state True to set origin mode, false to unset. - */ -hterm.Terminal.prototype.setOriginMode = function(state) { - this.options_.originMode = state; - this.setCursorPosition(0, 0); -}; - -/** - * Set the insert mode bit. - * - * If insert mode is on, existing text beyond the cursor position will be - * shifted right to make room for new text. Otherwise, new text overwrites - * any existing text. - * - * Defaults to off. - * - * @param {boolean} state True to set insert mode, false to unset. - */ -hterm.Terminal.prototype.setInsertMode = function(state) { - this.options_.insertMode = state; -}; - -/** - * Set the auto carriage return bit. - * - * If auto carriage return is on then a formfeed character is interpreted - * as a newline, otherwise it's the same as a linefeed. The difference boils - * down to whether or not the cursor column is reset. - * - * @param {boolean} state The state to set. - */ -hterm.Terminal.prototype.setAutoCarriageReturn = function(state) { - this.options_.autoCarriageReturn = state; -}; - -/** - * Set the wraparound mode bit. - * - * If wraparound mode is on, certain VT commands will allow the cursor to wrap - * to the start of the following row. Otherwise, the cursor is clamped to the - * end of the screen and attempts to write past it are ignored. - * - * Defaults to on. - * - * @param {boolean} state True to set wraparound mode, false to unset. - */ -hterm.Terminal.prototype.setWraparound = function(state) { - this.options_.wraparound = state; -}; - -/** - * Set the reverse-wraparound mode bit. - * - * If wraparound mode is off, certain VT commands will allow the cursor to wrap - * to the end of the previous row. Otherwise, the cursor is clamped to column - * 0. - * - * Defaults to off. - * - * @param {boolean} state True to set reverse-wraparound mode, false to unset. - */ -hterm.Terminal.prototype.setReverseWraparound = function(state) { - this.options_.reverseWraparound = state; -}; - -/** - * Selects between the primary and alternate screens. - * - * If alternate mode is on, the alternate screen is active. Otherwise the - * primary screen is active. - * - * Swapping screens has no effect on the scrollback buffer. - * - * Each screen maintains its own cursor position. - * - * Defaults to off. - * - * @param {boolean} state True to set alternate mode, false to unset. - */ -hterm.Terminal.prototype.setAlternateMode = function(state) { - var cursor = this.saveCursor(); - this.screen_ = state ? this.alternateScreen_ : this.primaryScreen_; - - if (this.screen_.rowsArray.length && - this.screen_.rowsArray[0].rowIndex != this.scrollbackRows_.length) { - // If the screen changed sizes while we were away, our rowIndexes may - // be incorrect. - var offset = this.scrollbackRows_.length; - var ary = this.screen_.rowsArray; - for (var i = 0; i < ary.length; i++) { - ary[i].rowIndex = offset + i; - } - } - - this.realizeWidth_(this.screenSize.width); - this.realizeHeight_(this.screenSize.height); - this.scrollPort_.syncScrollHeight(); - this.scrollPort_.invalidate(); - - this.restoreCursor(cursor); - this.scrollPort_.resize(); -}; - -/** - * Set the cursor-blink mode bit. - * - * If cursor-blink is on, the cursor will blink when it is visible. Otherwise - * a visible cursor does not blink. - * - * You should make sure to turn blinking off if you're going to dispose of a - * terminal, otherwise you'll leak a timeout. - * - * Defaults to on. - * - * @param {boolean} state True to set cursor-blink mode, false to unset. - */ -hterm.Terminal.prototype.setCursorBlink = function(state) { - this.options_.cursorBlink = state; - - if (!state && this.timeouts_.cursorBlink) { - clearTimeout(this.timeouts_.cursorBlink); - delete this.timeouts_.cursorBlink; - } - - if (this.options_.cursorVisible) - this.setCursorVisible(true); -}; - -/** - * Set the cursor-visible mode bit. - * - * If cursor-visible is on, the cursor will be visible. Otherwise it will not. - * - * Defaults to on. - * - * @param {boolean} state True to set cursor-visible mode, false to unset. - */ -hterm.Terminal.prototype.setCursorVisible = function(state) { - this.options_.cursorVisible = state; - - if (!state) { - if (this.timeouts_.cursorBlink) { - clearTimeout(this.timeouts_.cursorBlink); - delete this.timeouts_.cursorBlink; - } - this.cursorNode_.style.opacity = '0'; - return; - } - - this.syncCursorPosition_(); - - this.cursorNode_.style.opacity = '1'; - - if (this.options_.cursorBlink) { - if (this.timeouts_.cursorBlink) - return; - - this.onCursorBlink_(); - } else { - if (this.timeouts_.cursorBlink) { - clearTimeout(this.timeouts_.cursorBlink); - delete this.timeouts_.cursorBlink; - } - } -}; - -/** - * Synchronizes the visible cursor and document selection with the current - * cursor coordinates. - */ -hterm.Terminal.prototype.syncCursorPosition_ = function() { - var topRowIndex = this.scrollPort_.getTopRowIndex(); - var bottomRowIndex = this.scrollPort_.getBottomRowIndex(topRowIndex); - var cursorRowIndex = this.scrollbackRows_.length + - this.screen_.cursorPosition.row; - - if (cursorRowIndex > bottomRowIndex) { - // Cursor is scrolled off screen, move it outside of the visible area. - this.setCssVar('cursor-offset-row', '-1'); - return; - } - - if (this.options_.cursorVisible && - this.cursorNode_.style.display == 'none') { - // Re-display the terminal cursor if it was hidden by the mouse cursor. - this.cursorNode_.style.display = ''; - } - - // Position the cursor using CSS variable math. If we do the math in JS, - // the float math will end up being more precise than the CSS which will - // cause the cursor tracking to be off. - this.setCssVar( - 'cursor-offset-row', - `${cursorRowIndex - topRowIndex} + ` + - `${this.scrollPort_.visibleRowTopMargin}px`); - this.setCssVar('cursor-offset-col', this.screen_.cursorPosition.column); - - this.cursorNode_.setAttribute('title', - '(' + this.screen_.cursorPosition.column + - ', ' + this.screen_.cursorPosition.row + - ')'); - - // Update the caret for a11y purposes. - var selection = this.document_.getSelection(); - if (selection && selection.isCollapsed) - this.screen_.syncSelectionCaret(selection); -}; - -/** - * Adjusts the style of this.cursorNode_ according to the current cursor shape - * and character cell dimensions. - */ -hterm.Terminal.prototype.restyleCursor_ = function() { - var shape = this.cursorShape_; - - if (this.cursorNode_.getAttribute('focus') == 'false') { - // Always show a block cursor when unfocused. - shape = hterm.Terminal.cursorShape.BLOCK; - } - - var style = this.cursorNode_.style; - - switch (shape) { - case hterm.Terminal.cursorShape.BEAM: - style.height = 'var(--hterm-charsize-height)'; - style.backgroundColor = 'transparent'; - style.borderBottomStyle = null; - style.borderLeftStyle = 'solid'; - break; - - case hterm.Terminal.cursorShape.UNDERLINE: - style.height = this.scrollPort_.characterSize.baseline + 'px'; - style.backgroundColor = 'transparent'; - style.borderBottomStyle = 'solid'; - // correct the size to put it exactly at the baseline - style.borderLeftStyle = null; - break; - - default: - style.height = 'var(--hterm-charsize-height)'; - style.backgroundColor = this.cursorColor_; - style.borderBottomStyle = null; - style.borderLeftStyle = null; - break; - } -}; - -/** - * Synchronizes the visible cursor with the current cursor coordinates. - * - * The sync will happen asynchronously, soon after the call stack winds down. - * Multiple calls will be coalesced into a single sync. - */ -hterm.Terminal.prototype.scheduleSyncCursorPosition_ = function() { - if (this.timeouts_.syncCursor) - return; - - var self = this; - this.timeouts_.syncCursor = setTimeout(function() { - self.syncCursorPosition_(); - delete self.timeouts_.syncCursor; - }, 0); -}; - -/** - * Show or hide the zoom warning. - * - * The zoom warning is a message warning the user that their browser zoom must - * be set to 100% in order for hterm to function properly. - * - * @param {boolean} state True to show the message, false to hide it. - */ -hterm.Terminal.prototype.showZoomWarning_ = function(state) { - if (!this.zoomWarningNode_) { - if (!state) - return; - - this.zoomWarningNode_ = this.document_.createElement('div'); - this.zoomWarningNode_.id = 'hterm:zoom-warning'; - this.zoomWarningNode_.style.cssText = ( - 'color: black;' + - 'background-color: #ff2222;' + - 'font-size: large;' + - 'border-radius: 8px;' + - 'opacity: 0.75;' + - 'padding: 0.2em 0.5em 0.2em 0.5em;' + - 'top: 0.5em;' + - 'right: 1.2em;' + - 'position: absolute;' + - '-webkit-text-size-adjust: none;' + - '-webkit-user-select: none;' + - '-moz-text-size-adjust: none;' + - '-moz-user-select: none;'); - - this.zoomWarningNode_.addEventListener('click', function(e) { - this.parentNode.removeChild(this); - }); - } - - this.zoomWarningNode_.textContent = lib.MessageManager.replaceReferences( - hterm.zoomWarningMessage, - [parseInt(this.scrollPort_.characterSize.zoomFactor * 100)]); - - this.zoomWarningNode_.style.fontFamily = this.prefs_.get('font-family'); - - if (state) { - if (!this.zoomWarningNode_.parentNode) - this.div_.parentNode.appendChild(this.zoomWarningNode_); - } else if (this.zoomWarningNode_.parentNode) { - this.zoomWarningNode_.parentNode.removeChild(this.zoomWarningNode_); - } -}; - -/** - * Show the terminal overlay for a given amount of time. - * - * The terminal overlay appears in inverse video in a large font, centered - * over the terminal. You should probably keep the overlay message brief, - * since it's in a large font and you probably aren't going to check the size - * of the terminal first. - * - * @param {string} msg The text (not HTML) message to display in the overlay. - * @param {number} opt_timeout The amount of time to wait before fading out - * the overlay. Defaults to 1.5 seconds. Pass null to have the overlay - * stay up forever (or until the next overlay). - */ -hterm.Terminal.prototype.showOverlay = function(msg, opt_timeout) { - if (!this.overlayNode_) { - if (!this.div_) - return; - - this.overlayNode_ = this.document_.createElement('div'); - this.overlayNode_.style.cssText = ( - 'border-radius: 15px;' + - 'font-size: xx-large;' + - 'opacity: 0.75;' + - 'padding: 0.2em 0.5em 0.2em 0.5em;' + - 'position: absolute;' + - '-webkit-user-select: none;' + - '-webkit-transition: opacity 180ms ease-in;' + - '-moz-user-select: none;' + - '-moz-transition: opacity 180ms ease-in;'); - - this.overlayNode_.addEventListener('mousedown', function(e) { - e.preventDefault(); - e.stopPropagation(); - }, true); - } - - this.overlayNode_.style.color = this.prefs_.get('background-color'); - this.overlayNode_.style.backgroundColor = this.prefs_.get('foreground-color'); - this.overlayNode_.style.fontFamily = this.prefs_.get('font-family'); - - this.overlayNode_.textContent = msg; - this.overlayNode_.style.opacity = '0.75'; - - if (!this.overlayNode_.parentNode) - this.div_.appendChild(this.overlayNode_); - - var divSize = hterm.getClientSize(this.div_); - var overlaySize = hterm.getClientSize(this.overlayNode_); - - this.overlayNode_.style.top = - (divSize.height - overlaySize.height) / 2 + 'px'; - this.overlayNode_.style.left = (divSize.width - overlaySize.width - - this.scrollPort_.currentScrollbarWidthPx) / 2 + 'px'; - - if (this.overlayTimeout_) - clearTimeout(this.overlayTimeout_); - - if (opt_timeout === null) - return; - - this.overlayTimeout_ = setTimeout(() => { - this.overlayNode_.style.opacity = '0'; - this.overlayTimeout_ = setTimeout(() => this.hideOverlay(), 200); - }, opt_timeout || 1500); -}; - -/** - * Hide the terminal overlay immediately. - * - * Useful when we show an overlay for an event with an unknown end time. - */ -hterm.Terminal.prototype.hideOverlay = function() { - if (this.overlayTimeout_) - clearTimeout(this.overlayTimeout_); - this.overlayTimeout_ = null; - - if (this.overlayNode_.parentNode) - this.overlayNode_.parentNode.removeChild(this.overlayNode_); - this.overlayNode_.style.opacity = '0.75'; -}; - -/** - * Paste from the system clipboard to the terminal. - */ -hterm.Terminal.prototype.paste = function() { - return hterm.pasteFromClipboard(this.document_); -}; - -/** - * Copy a string to the system clipboard. - * - * Note: If there is a selected range in the terminal, it'll be cleared. - * - * @param {string} str The string to copy. - */ -hterm.Terminal.prototype.copyStringToClipboard = function(str) { - if (this.prefs_.get('enable-clipboard-notice')) - setTimeout(this.showOverlay.bind(this, hterm.notifyCopyMessage, 500), 200); - - var copySource = this.document_.createElement('pre'); - copySource.id = 'hterm:copy-to-clipboard-source'; - copySource.textContent = str; - copySource.style.cssText = ( - '-webkit-user-select: text;' + - '-moz-user-select: text;' + - 'position: absolute;' + - 'top: -99px'); - - this.document_.body.appendChild(copySource); - - var selection = this.document_.getSelection(); - var anchorNode = selection.anchorNode; - var anchorOffset = selection.anchorOffset; - var focusNode = selection.focusNode; - var focusOffset = selection.focusOffset; - - selection.selectAllChildren(copySource); - - hterm.copySelectionToClipboard(this.document_); - - // IE doesn't support selection.extend. This means that the selection - // won't return on IE. - if (selection.extend) { - selection.collapse(anchorNode, anchorOffset); - selection.extend(focusNode, focusOffset); - } - - copySource.parentNode.removeChild(copySource); -}; - -/** - * Display an image. - * - * @param {Object} options The image to display. - * @param {string=} options.name A human readable string for the image. - * @param {string|number=} options.size The size (in bytes). - * @param {boolean=} options.preserveAspectRatio Whether to preserve aspect. - * @param {boolean=} options.inline Whether to display the image inline. - * @param {string|number=} options.width The width of the image. - * @param {string|number=} options.height The height of the image. - * @param {string=} options.align Direction to align the image. - * @param {string} options.uri The source URI for the image. - */ -hterm.Terminal.prototype.displayImage = function(options) { - // Make sure we're actually given a resource to display. - if (options.uri === undefined) - return; - - // Set up the defaults to simplify code below. - if (!options.name) - options.name = ''; - - // Has the user approved image display yet? - if (this.allowImagesInline !== true) { - this.newLine(); - const row = this.getRowNode(this.scrollbackRows_.length + - this.getCursorRow() - 1); - - if (this.allowImagesInline === false) { - row.textContent = hterm.msg('POPUP_INLINE_IMAGE_DISABLED', [], - 'Inline Images Disabled'); - return; - } - - // Show a prompt. - let button; - const span = this.document_.createElement('span'); - span.innerText = hterm.msg('POPUP_INLINE_IMAGE', [], 'Inline Images'); - span.style.fontWeight = 'bold'; - span.style.borderWidth = '1px'; - span.style.borderStyle = 'dashed'; - button = this.document_.createElement('span'); - button.innerText = hterm.msg('BUTTON_BLOCK', [], 'block'); - button.style.marginLeft = '1em'; - button.style.borderWidth = '1px'; - button.style.borderStyle = 'solid'; - button.addEventListener('click', () => { - this.prefs_.set('allow-images-inline', false); - }); - span.appendChild(button); - button = this.document_.createElement('span'); - button.innerText = hterm.msg('BUTTON_ALLOW_SESSION', [], - 'allow this session'); - button.style.marginLeft = '1em'; - button.style.borderWidth = '1px'; - button.style.borderStyle = 'solid'; - button.addEventListener('click', () => { - this.allowImagesInline = true; - }); - span.appendChild(button); - button = this.document_.createElement('span'); - button.innerText = hterm.msg('BUTTON_ALLOW_ALWAYS', [], 'always allow'); - button.style.marginLeft = '1em'; - button.style.borderWidth = '1px'; - button.style.borderStyle = 'solid'; - button.addEventListener('click', () => { - this.prefs_.set('allow-images-inline', true); - }); - span.appendChild(button); - - row.appendChild(span); - return; - } - - // See if we should show this object directly, or download it. - if (options.inline) { - const io = this.io.push(); - io.showOverlay(hterm.msg('LOADING_RESOURCE_START', [options.name], - 'Loading $1 ...'), null); - - // While we're loading the image, eat all the user's input. - io.onVTKeystroke = io.sendString = () => {}; - - // Initialize this new image. - const img = this.document_.createElement('img'); - img.src = options.uri; - img.title = img.alt = options.name; - - // Attach the image to the page to let it load/render. It won't stay here. - // This is needed so it's visible and the DOM can calculate the height. If - // the image is hidden or not in the DOM, the height is always 0. - this.document_.body.appendChild(img); - - // Wait for the image to finish loading before we try moving it to the - // right place in the terminal. - img.onload = () => { - // Now that we have the image dimensions, figure out how to show it. - img.style.objectFit = options.preserveAspectRatio ? 'scale-down' : 'fill'; - img.style.maxWidth = `${this.document_.body.clientWidth}px`; - img.style.maxHeight = `${this.document_.body.clientHeight}px`; - - // Parse a width/height specification. - const parseDim = (dim, maxDim, cssVar) => { - if (!dim || dim == 'auto') - return ''; - - const ary = dim.match(/^([0-9]+)(px|%)?$/); - if (ary) { - if (ary[2] == '%') - return maxDim * parseInt(ary[1]) / 100 + 'px'; - else if (ary[2] == 'px') - return dim; - else - return `calc(${dim} * var(${cssVar}))`; - } - - return ''; - }; - img.style.width = - parseDim(options.width, this.document_.body.clientWidth, - '--hterm-charsize-width'); - img.style.height = - parseDim(options.height, this.document_.body.clientHeight, - '--hterm-charsize-height'); - - // Figure out how many rows the image occupies, then add that many. - // XXX: This count will be inaccurate if the font size changes on us. - const padRows = Math.ceil(img.clientHeight / - this.scrollPort_.characterSize.height); - for (let i = 0; i < padRows; ++i) - this.newLine(); - - // Update the max height in case the user shrinks the character size. - img.style.maxHeight = `calc(${padRows} * var(--hterm-charsize-height))`; - - // Move the image to the last row. This way when we scroll up, it doesn't - // disappear when the first row gets clipped. It will disappear when we - // scroll down and the last row is clipped ... - this.document_.body.removeChild(img); - // Create a wrapper node so we can do an absolute in a relative position. - // This helps with rounding errors between JS & CSS counts. - const div = this.document_.createElement('div'); - div.style.position = 'relative'; - div.style.textAlign = options.align; - img.style.position = 'absolute'; - img.style.bottom = 'calc(0px - var(--hterm-charsize-height))'; - div.appendChild(img); - const row = this.getRowNode(this.scrollbackRows_.length + - this.getCursorRow() - 1); - row.appendChild(div); - - io.hideOverlay(); - io.pop(); - }; - - // If we got a malformed image, give up. - img.onerror = (e) => { - this.document_.body.removeChild(img); - io.showOverlay(hterm.msg('LOADING_RESOURCE_FAILED', [options.name], - 'Loading $1 failed ...')); - io.pop(); - }; - } else { - // We can't use chrome.downloads.download as that requires "downloads" - // permissions, and that works only in extensions, not apps. - const a = this.document_.createElement('a'); - a.href = options.uri; - a.download = options.name; - this.document_.body.appendChild(a); - a.click(); - a.remove(); - } -}; - -/** - * Returns the selected text, or null if no text is selected. - * - * @return {string|null} - */ -hterm.Terminal.prototype.getSelectionText = function() { - var selection = this.scrollPort_.selection; - selection.sync(); - - if (selection.isCollapsed) - return null; - - - // Start offset measures from the beginning of the line. - var startOffset = selection.startOffset; - var node = selection.startNode; - - if (node.nodeName != 'X-ROW') { - // If the selection doesn't start on an x-row node, then it must be - // somewhere inside the x-row. Add any characters from previous siblings - // into the start offset. - - if (node.nodeName == '#text' && node.parentNode.nodeName == 'SPAN') { - // If node is the text node in a styled span, move up to the span node. - node = node.parentNode; - } - - while (node.previousSibling) { - node = node.previousSibling; - startOffset += hterm.TextAttributes.nodeWidth(node); - } - } - - // End offset measures from the end of the line. - var endOffset = (hterm.TextAttributes.nodeWidth(selection.endNode) - - selection.endOffset); - node = selection.endNode; - - if (node.nodeName != 'X-ROW') { - // If the selection doesn't end on an x-row node, then it must be - // somewhere inside the x-row. Add any characters from following siblings - // into the end offset. - - if (node.nodeName == '#text' && node.parentNode.nodeName == 'SPAN') { - // If node is the text node in a styled span, move up to the span node. - node = node.parentNode; - } - - while (node.nextSibling) { - node = node.nextSibling; - endOffset += hterm.TextAttributes.nodeWidth(node); - } - } - - var rv = this.getRowsText(selection.startRow.rowIndex, - selection.endRow.rowIndex + 1); - return lib.wc.substring(rv, startOffset, lib.wc.strWidth(rv) - endOffset); -}; - -/** - * Copy the current selection to the system clipboard, then clear it after a - * short delay. - */ -hterm.Terminal.prototype.copySelectionToClipboard = function() { - var text = this.getSelectionText(); - if (text != null) - this.copyStringToClipboard(text); -}; - -hterm.Terminal.prototype.overlaySize = function() { - this.showOverlay(this.screenSize.width + 'x' + this.screenSize.height); -}; - -/** - * Invoked by hterm.Terminal.Keyboard when a VT keystroke is detected. - * - * @param {string} string The VT string representing the keystroke, in UTF-16. - */ -hterm.Terminal.prototype.onVTKeystroke = function(string) { - if (this.scrollOnKeystroke_) - this.scrollPort_.scrollRowToBottom(this.getRowCount()); - - this.io.onVTKeystroke(this.keyboard.encode(string)); -}; - -/** - * Open the selected url. - */ -hterm.Terminal.prototype.openSelectedUrl_ = function() { - var str = this.getSelectionText(); - - // If there is no selection, try and expand wherever they clicked. - if (str == null) { - this.screen_.expandSelection(this.document_.getSelection()); - str = this.getSelectionText(); - - // If clicking in empty space, return. - if (str == null) - return; - } - - // Make sure URL is valid before opening. - if (str.length > 2048 || str.search(/[\s\[\](){}<>"'\\^`]/) >= 0) - return; - - // If the URI isn't anchored, it'll open relative to the extension. - // We have no way of knowing the correct schema, so assume http. - if (str.search('^[a-zA-Z][a-zA-Z0-9+.-]*://') < 0) { - // We have to whitelist a few protocols that lack authorities and thus - // never use the //. Like mailto. - switch (str.split(':', 1)[0]) { - case 'mailto': - break; - default: - str = 'http://' + str; - break; - } - } - - hterm.openUrl(str); -} - - -/** - * Add the terminalRow and terminalColumn properties to mouse events and - * then forward on to onMouse(). - * - * The terminalRow and terminalColumn properties contain the (row, column) - * coordinates for the mouse event. - * - * @param {Event} e The mouse event to handle. - */ -hterm.Terminal.prototype.onMouse_ = function(e) { - if (e.processedByTerminalHandler_) { - // We register our event handlers on the document, as well as the cursor - // and the scroll blocker. Mouse events that occur on the cursor or - // scroll blocker will also appear on the document, but we don't want to - // process them twice. - // - // We can't just prevent bubbling because that has other side effects, so - // we decorate the event object with this property instead. - return; - } - - var reportMouseEvents = (!this.defeatMouseReports_ && - this.vt.mouseReport != this.vt.MOUSE_REPORT_DISABLED); - - e.processedByTerminalHandler_ = true; - - // One based row/column stored on the mouse event. - e.terminalRow = parseInt((e.clientY - this.scrollPort_.visibleRowTopMargin) / - this.scrollPort_.characterSize.height) + 1; - e.terminalColumn = parseInt(e.clientX / - this.scrollPort_.characterSize.width) + 1; - - if (e.type == 'mousedown' && e.terminalColumn > this.screenSize.width) { - // Mousedown in the scrollbar area. - return; - } - - if (this.options_.cursorVisible && !reportMouseEvents) { - // If the cursor is visible and we're not sending mouse events to the - // host app, then we want to hide the terminal cursor when the mouse - // cursor is over top. This keeps the terminal cursor from interfering - // with local text selection. - if (e.terminalRow - 1 == this.screen_.cursorPosition.row && - e.terminalColumn - 1 == this.screen_.cursorPosition.column) { - this.cursorNode_.style.display = 'none'; - } else if (this.cursorNode_.style.display == 'none') { - this.cursorNode_.style.display = ''; - } - } - - if (e.type == 'mousedown') { - if (e.altKey || !reportMouseEvents) { - // If VT mouse reporting is disabled, or has been defeated with - // alt-mousedown, then the mouse will act on the local selection. - this.defeatMouseReports_ = true; - this.setSelectionEnabled(true); - } else { - // Otherwise we defer ownership of the mouse to the VT. - this.defeatMouseReports_ = false; - this.document_.getSelection().collapseToEnd(); - this.setSelectionEnabled(false); - e.preventDefault(); - } - } - - if (!reportMouseEvents) { - if (e.type == 'dblclick' && this.copyOnSelect) { - this.screen_.expandSelection(this.document_.getSelection()); - this.copySelectionToClipboard(this.document_); - } - - if (e.type == 'click' && !e.shiftKey && (e.ctrlKey || e.metaKey)) { - // Debounce this event with the dblclick event. If you try to doubleclick - // a URL to open it, Chrome will fire click then dblclick, but we won't - // have expanded the selection text at the first click event. - clearTimeout(this.timeouts_.openUrl); - this.timeouts_.openUrl = setTimeout(this.openSelectedUrl_.bind(this), - 500); - return; - } - - if (e.type == 'mousedown') { - if ((this.mouseRightClickPaste && e.button == 2 /* right button */) || - e.button == this.mousePasteButton) { - if (!this.paste()) - console.warn('Could not paste manually due to web restrictions'); - } - } - - if (e.type == 'mouseup' && e.button == 0 && this.copyOnSelect && - !this.document_.getSelection().isCollapsed) { - this.copySelectionToClipboard(this.document_); - } - - if ((e.type == 'mousemove' || e.type == 'mouseup') && - this.scrollBlockerNode_.engaged) { - // Disengage the scroll-blocker after one of these events. - this.scrollBlockerNode_.engaged = false; - this.scrollBlockerNode_.style.top = '-99px'; - } - - // Emulate arrow key presses via scroll wheel events. - if (this.scrollWheelArrowKeys_ && !e.shiftKey && - this.keyboard.applicationCursor && !this.isPrimaryScreen()) { - if (e.type == 'wheel') { - var delta = this.scrollPort_.scrollWheelDelta(e); - var lines = lib.f.smartFloorDivide( - Math.abs(delta), this.scrollPort_.characterSize.height); - - var data = '\x1bO' + (delta < 0 ? 'B' : 'A'); - this.io.sendString(data.repeat(lines)); - - e.preventDefault(); - } - } - } else /* if (this.reportMouseEvents) */ { - if (!this.scrollBlockerNode_.engaged) { - if (e.type == 'mousedown') { - // Move the scroll-blocker into place if we want to keep the scrollport - // from scrolling. - this.scrollBlockerNode_.engaged = true; - this.scrollBlockerNode_.style.top = (e.clientY - 5) + 'px'; - this.scrollBlockerNode_.style.left = (e.clientX - 5) + 'px'; - } else if (e.type == 'mousemove') { - // Oh. This means that drag-scroll was disabled AFTER the mouse down, - // in which case it's too late to engage the scroll-blocker. - this.document_.getSelection().collapseToEnd(); - e.preventDefault(); - } - } - - this.onMouse(e); - } - - if (e.type == 'mouseup' && this.document_.getSelection().isCollapsed) { - // Restore this on mouseup in case it was temporarily defeated with a - // alt-mousedown. Only do this when the selection is empty so that - // we don't immediately kill the users selection. - this.defeatMouseReports_ = false; - } -}; - -/** - * Clients should override this if they care to know about mouse events. - * - * The event parameter will be a normal DOM mouse click event with additional - * 'terminalRow' and 'terminalColumn' properties. - * - * @param {Event} e The mouse event to handle. - */ -hterm.Terminal.prototype.onMouse = function(e) { }; - -/** - * React when focus changes. - * - * @param {boolean} focused True if focused, false otherwise. - */ -hterm.Terminal.prototype.onFocusChange_ = function(focused) { - this.cursorNode_.setAttribute('focus', focused); - this.restyleCursor_(); - - if (this.reportFocus) { - this.io.sendString(focused === true ? '\x1b[I' : '\x1b[O') - } - - if (focused === true) - this.closeBellNotifications_(); -}; - -/** - * React when the ScrollPort is scrolled. - */ -hterm.Terminal.prototype.onScroll_ = function() { - this.scheduleSyncCursorPosition_(); -}; - -/** - * React when text is pasted into the scrollPort. - * - * @param {Event} e The DOM paste event to handle. - */ -hterm.Terminal.prototype.onPaste_ = function(e) { - var data = e.text.replace(/\n/mg, '\r'); - data = this.keyboard.encode(data); - if (this.options_.bracketedPaste) - data = '\x1b[200~' + data + '\x1b[201~'; - - this.io.sendString(data); -}; - -/** - * React when the user tries to copy from the scrollPort. - * - * @param {Event} e The DOM copy event. - */ -hterm.Terminal.prototype.onCopy_ = function(e) { - if (!this.useDefaultWindowCopy) { - e.preventDefault(); - setTimeout(this.copySelectionToClipboard.bind(this), 0); - } -}; - -/** - * React when the ScrollPort is resized. - * - * Note: This function should not directly contain code that alters the internal - * state of the terminal. That kind of code belongs in realizeWidth or - * realizeHeight, so that it can be executed synchronously in the case of a - * programmatic width change. - */ -hterm.Terminal.prototype.onResize_ = function() { - var columnCount = Math.floor(this.scrollPort_.getScreenWidth() / - this.scrollPort_.characterSize.width) || 0; - var rowCount = lib.f.smartFloorDivide(this.scrollPort_.getScreenHeight(), - this.scrollPort_.characterSize.height) || 0; - - if (columnCount <= 0 || rowCount <= 0) { - // We avoid these situations since they happen sometimes when the terminal - // gets removed from the document or during the initial load, and we can't - // deal with that. - // This can also happen if called before the scrollPort calculates the - // character size, meaning we dived by 0 above and default to 0 values. - return; - } - - var isNewSize = (columnCount != this.screenSize.width || - rowCount != this.screenSize.height); - - // We do this even if the size didn't change, just to be sure everything is - // in sync. - this.realizeSize_(columnCount, rowCount); - this.showZoomWarning_(this.scrollPort_.characterSize.zoomFactor != 1); - - if (isNewSize) - this.overlaySize(); - - this.restyleCursor_(); - this.scheduleSyncCursorPosition_(); -}; - -/** - * Service the cursor blink timeout. - */ -hterm.Terminal.prototype.onCursorBlink_ = function() { - if (!this.options_.cursorBlink) { - delete this.timeouts_.cursorBlink; - return; - } - - if (this.cursorNode_.getAttribute('focus') == 'false' || - this.cursorNode_.style.opacity == '0') { - this.cursorNode_.style.opacity = '1'; - this.timeouts_.cursorBlink = setTimeout(this.myOnCursorBlink_, - this.cursorBlinkCycle_[0]); - } else { - this.cursorNode_.style.opacity = '0'; - this.timeouts_.cursorBlink = setTimeout(this.myOnCursorBlink_, - this.cursorBlinkCycle_[1]); - } -}; - -/** - * Set the scrollbar-visible mode bit. - * - * If scrollbar-visible is on, the vertical scrollbar will be visible. - * Otherwise it will not. - * - * Defaults to on. - * - * @param {boolean} state True to set scrollbar-visible mode, false to unset. - */ -hterm.Terminal.prototype.setScrollbarVisible = function(state) { - this.scrollPort_.setScrollbarVisible(state); -}; - -/** - * Set the scroll wheel move multiplier. This will affect how fast the page - * scrolls on wheel events. - * - * Defaults to 1. - * - * @param {number} multiplier The multiplier to set. - */ -hterm.Terminal.prototype.setScrollWheelMoveMultipler = function(multiplier) { - this.scrollPort_.setScrollWheelMoveMultipler(multiplier); -}; - -/** - * Close all web notifications created by terminal bells. - */ -hterm.Terminal.prototype.closeBellNotifications_ = function() { - this.bellNotificationList_.forEach(function(n) { - n.close(); - }); - this.bellNotificationList_.length = 0; -}; -// SOURCE FILE: hterm/js/hterm_terminal_io.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.encodeUTF8'); - -/** - * Input/Output interface used by commands to communicate with the terminal. - * - * Commands like `nassh` and `crosh` receive an instance of this class as - * part of their argv object. This allows them to write to and read from the - * terminal without exposing them to an entire hterm.Terminal instance. - * - * The active command must override the onVTKeystroke() and sendString() methods - * of this class in order to receive keystrokes and send output to the correct - * destination. - * - * Isolating commands from the terminal provides the following benefits: - * - Provides a mechanism to save and restore onVTKeystroke and sendString - * handlers when invoking subcommands (see the push() and pop() methods). - * - The isolation makes it easier to make changes in Terminal and supporting - * classes without affecting commands. - * - In The Future commands may run in web workers where they would only be able - * to talk to a Terminal instance through an IPC mechanism. - * - * @param {hterm.Terminal} - */ -hterm.Terminal.IO = function(terminal) { - this.terminal_ = terminal; - - // The IO object to restore on IO.pop(). - this.previousIO_ = null; - - // Any data this object accumulated while not active. - this.buffered_ = ''; -}; - -/** - * Show the terminal overlay for a given amount of time. - * - * The terminal overlay appears in inverse video in a large font, centered - * over the terminal. You should probably keep the overlay message brief, - * since it's in a large font and you probably aren't going to check the size - * of the terminal first. - * - * @param {string} msg The text (not HTML) message to display in the overlay. - * @param {number} opt_timeout The amount of time to wait before fading out - * the overlay. Defaults to 1.5 seconds. Pass null to have the overlay - * stay up forever (or until the next overlay). - */ -hterm.Terminal.IO.prototype.showOverlay = function(message, opt_timeout) { - this.terminal_.showOverlay(message, opt_timeout); -}; - -/** - * Hide the current overlay immediately. - * - * Useful when we show an overlay for an event with an unknown end time. - */ -hterm.Terminal.IO.prototype.hideOverlay = function() { - this.terminal_.hideOverlay(); -}; - -/** - * Open an frame in the current terminal window, pointed to the specified - * url. - * - * Eventually we'll probably need size/position/decoration options. - * The user should also be able to move/resize the frame. - * - * @param {string} url The URL to load in the frame. - * @param {Object} opt_options Optional frame options. Not implemented. - */ -hterm.Terminal.IO.prototype.createFrame = function(url, opt_options) { - return new hterm.Frame(this.terminal_, url, opt_options); -}; - -/** - * Change the preference profile for the terminal. - * - * @param profileName {string} The name of the preference profile to activate. - */ -hterm.Terminal.IO.prototype.setTerminalProfile = function(profileName) { - this.terminal_.setProfile(profileName); -}; - -/** - * Create a new hterm.Terminal.IO instance and make it active on the Terminal - * object associated with this instance. - * - * This is used to pass control of the terminal IO off to a subcommand. The - * IO.pop() method can be used to restore control when the subcommand completes. - */ -hterm.Terminal.IO.prototype.push = function() { - var io = new hterm.Terminal.IO(this.terminal_); - io.keyboardCaptured_ = this.keyboardCaptured_; - - io.columnCount = this.columnCount; - io.rowCount = this.rowCount; - - io.previousIO_ = this.terminal_.io; - this.terminal_.io = io; - - return io; -}; - -/** - * Restore the Terminal's previous IO object. - * - * We'll flush out any queued data. - */ -hterm.Terminal.IO.prototype.pop = function() { - this.terminal_.io = this.previousIO_; - this.previousIO_.flush(); -}; - -/** - * Flush accumulated data. - * - * If we're not the active IO, the connected process might still be writing - * data to us, but we won't be displaying it. Flush any buffered data now. - */ -hterm.Terminal.IO.prototype.flush = function() { - if (this.buffered_) { - this.terminal_.interpret(this.buffered_); - this.buffered_ = ''; - } -}; - -/** - * Called when data needs to be sent to the current command. - * - * Clients should override this to receive notification of pending data. - * - * @param {string} string The data to send. - */ -hterm.Terminal.IO.prototype.sendString = function(string) { - // Override this. - console.log('Unhandled sendString: ' + string); -}; - -/** - * Called when a terminal keystroke is detected. - * - * Clients should override this to receive notification of keystrokes. - * - * The keystroke data will be encoded according to the 'send-encoding' - * preference. - * - * @param {string} string The VT key sequence. - */ -hterm.Terminal.IO.prototype.onVTKeystroke = function(string) { - // Override this. - console.log('Unobserverd VT keystroke: ' + JSON.stringify(string)); -}; - -hterm.Terminal.IO.prototype.onTerminalResize_ = function(width, height) { - var obj = this; - while (obj) { - obj.columnCount = width; - obj.rowCount = height; - obj = obj.previousIO_; - } - - this.onTerminalResize(width, height); -}; - -/** - * Called when terminal size is changed. - * - * Clients should override this to receive notification of resize. - * - * @param {string|integer} terminal width. - * @param {string|integer} terminal height. - */ -hterm.Terminal.IO.prototype.onTerminalResize = function(width, height) { - // Override this. -}; - -/** - * Write a UTF-8 encoded byte string to the terminal. - * - * @param {string} string The UTF-8 encoded string to print. - */ -hterm.Terminal.IO.prototype.writeUTF8 = function(string) { - // If another process has the foreground IO, buffer new data sent to this IO - // (since it's in the background). When we're made the foreground IO again, - // we'll flush everything. - if (this.terminal_.io != this) { - this.buffered_ += string; - return; - } - - this.terminal_.interpret(string); -}; - -/** - * Write a UTF-8 encoded byte string to the terminal followed by crlf. - * - * @param {string} string The UTF-8 encoded string to print. - */ -hterm.Terminal.IO.prototype.writelnUTF8 = function(string) { - this.writeUTF8(string + '\r\n'); -}; - -/** - * Write a UTF-16 JavaScript string to the terminal. - * - * @param {string} string The string to print. - */ -hterm.Terminal.IO.prototype.print = -hterm.Terminal.IO.prototype.writeUTF16 = function(string) { - this.writeUTF8(lib.encodeUTF8(string)); -}; - -/** - * Print a UTF-16 JavaScript string to the terminal followed by a newline. - * - * @param {string} string The string to print. - */ -hterm.Terminal.IO.prototype.println = -hterm.Terminal.IO.prototype.writelnUTF16 = function(string) { - this.writelnUTF8(lib.encodeUTF8(string)); -}; -// SOURCE FILE: hterm/js/hterm_text_attributes.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.colors'); - -/** - * Constructor for TextAttribute objects. - * - * These objects manage a set of text attributes such as foreground/ - * background color, bold, faint, italic, blink, underline, and strikethrough. - * - * TextAttribute instances can be used to construct a DOM container implementing - * the current attributes, or to test an existing DOM container for - * compatibility with the current attributes. - * - * @constructor - * @param {HTMLDocument} document The parent document to use when creating - * new DOM containers. - */ -hterm.TextAttributes = function(document) { - this.document_ = document; - // These variables contain the source of the color as either: - // SRC_DEFAULT (use context default) - // rgb(...) (true color form) - // number (representing the index from color palette to use) - this.foregroundSource = this.SRC_DEFAULT; - this.backgroundSource = this.SRC_DEFAULT; - this.underlineSource = this.SRC_DEFAULT; - - // These properties cache the value in the color table, but foregroundSource - // and backgroundSource contain the canonical values. - this.foreground = this.DEFAULT_COLOR; - this.background = this.DEFAULT_COLOR; - this.underlineColor = this.DEFAULT_COLOR; - - this.defaultForeground = 'rgb(255, 255, 255)'; - this.defaultBackground = 'rgb(0, 0, 0)'; - - // Any attributes added here that do not default to falsey (e.g. undefined or - // null) require a bit more care. createContainer has to always attach the - // attribute so matchesContainer can work correctly. - this.bold = false; - this.faint = false; - this.italic = false; - this.blink = false; - this.underline = false; - this.strikethrough = false; - this.inverse = false; - this.invisible = false; - this.wcNode = false; - this.asciiNode = true; - this.tileData = null; - this.uri = null; - this.uriId = null; - - this.colorPalette = null; - this.resetColorPalette(); -}; - -/** - * If false, we ignore the bold attribute. - * - * This is used for fonts that have a bold version that is a different size - * than the normal weight version. - */ -hterm.TextAttributes.prototype.enableBold = true; - -/** - * If true, use bright colors (if available) for bold text. - * - * This setting is independent of the enableBold setting. - */ -hterm.TextAttributes.prototype.enableBoldAsBright = true; - -/** - * A sentinel constant meaning "whatever the default color is in this context". - */ -hterm.TextAttributes.prototype.DEFAULT_COLOR = lib.f.createEnum(''); - -/** - * A constant string used to specify that source color is context default. - */ -hterm.TextAttributes.prototype.SRC_DEFAULT = 'default'; - -/** - * The document object which should own the DOM nodes created by this instance. - * - * @param {HTMLDocument} document The parent document. - */ -hterm.TextAttributes.prototype.setDocument = function(document) { - this.document_ = document; -}; - -/** - * Create a deep copy of this object. - * - * @return {hterm.TextAttributes} A deep copy of this object. - */ -hterm.TextAttributes.prototype.clone = function() { - var rv = new hterm.TextAttributes(null); - - for (var key in this) { - rv[key] = this[key]; - } - - rv.colorPalette = this.colorPalette.concat(); - return rv; -}; - -/** - * Reset the current set of attributes. - * - * This does not affect the palette. Use resetColorPalette() for that. - * It also doesn't affect the tile data, it's not meant to. - */ -hterm.TextAttributes.prototype.reset = function() { - this.foregroundSource = this.SRC_DEFAULT; - this.backgroundSource = this.SRC_DEFAULT; - this.underlineSource = this.SRC_DEFAULT; - this.foreground = this.DEFAULT_COLOR; - this.background = this.DEFAULT_COLOR; - this.underlineColor = this.DEFAULT_COLOR; - this.bold = false; - this.faint = false; - this.italic = false; - this.blink = false; - this.underline = false; - this.strikethrough = false; - this.inverse = false; - this.invisible = false; - this.wcNode = false; - this.asciiNode = true; - this.uri = null; - this.uriId = null; -}; - -/** - * Reset the color palette to the default state. - */ -hterm.TextAttributes.prototype.resetColorPalette = function() { - this.colorPalette = lib.colors.colorPalette.concat(); - this.syncColors(); -}; - -/** - * Test if the current attributes describe unstyled text. - * - * @return {boolean} True if the current attributes describe unstyled text. - */ -hterm.TextAttributes.prototype.isDefault = function() { - return (this.foregroundSource == this.SRC_DEFAULT && - this.backgroundSource == this.SRC_DEFAULT && - !this.bold && - !this.faint && - !this.italic && - !this.blink && - !this.underline && - !this.strikethrough && - !this.inverse && - !this.invisible && - !this.wcNode && - this.asciiNode && - this.tileData == null && - this.uri == null); -}; - -/** - * Create a DOM container (a span or a text node) with a style to match the - * current set of attributes. - * - * This method will create a plain text node if the text is unstyled, or - * an HTML span if the text is styled. Due to lack of monospace wide character - * fonts on certain systems (e.g. Chrome OS), we need to put each wide character - * in a span of CSS class '.wc-node' which has double column width. - * Each vt_tiledata tile is also represented by a span with a single - * character, with CSS classes '.tile' and '.tile_'. - * - * @param {string} opt_textContent Optional text content for the new container. - * @return {HTMLNode} An HTML span or text nodes styled to match the current - * attributes. - */ -hterm.TextAttributes.prototype.createContainer = function(opt_textContent) { - if (this.isDefault()) { - // Only attach attributes where we need an explicit default for the - // matchContainer logic below. - const node = this.document_.createTextNode(opt_textContent); - node.asciiNode = true; - return node; - } - - var span = this.document_.createElement('span'); - var style = span.style; - var classes = []; - - if (this.foreground != this.DEFAULT_COLOR) - style.color = this.foreground; - - if (this.background != this.DEFAULT_COLOR) - style.backgroundColor = this.background; - - if (this.enableBold && this.bold) - style.fontWeight = 'bold'; - - if (this.faint) - span.faint = true; - - if (this.italic) - style.fontStyle = 'italic'; - - if (this.blink) { - classes.push('blink-node'); - span.blinkNode = true; - } - - let textDecorationLine = ''; - span.underline = this.underline; - if (this.underline) { - textDecorationLine += ' underline'; - style.textDecorationStyle = this.underline; - } - if (this.underlineSource != this.SRC_DEFAULT) - style.textDecorationColor = this.underlineColor; - if (this.strikethrough) { - textDecorationLine += ' line-through'; - span.strikethrough = true; - } - if (textDecorationLine) - style.textDecorationLine = textDecorationLine; - - if (this.wcNode) { - classes.push('wc-node'); - span.wcNode = true; - } - span.asciiNode = this.asciiNode; - - if (this.tileData != null) { - classes.push('tile'); - classes.push('tile_' + this.tileData); - span.tileNode = true; - } - - if (opt_textContent) - span.textContent = opt_textContent; - - if (this.uri) { - classes.push('uri-node'); - span.uriId = this.uriId; - span.title = this.uri; - span.addEventListener('click', hterm.openUrl.bind(this, this.uri)); - } - - if (classes.length) - span.className = classes.join(' '); - - return span; -}; - -/** - * Tests if the provided object (string, span or text node) has the same - * style as this TextAttributes instance. - * - * This indicates that text with these attributes could be inserted directly - * into the target DOM node. - * - * For the purposes of this method, a string is considered a text node. - * - * @param {string|HTMLNode} obj The object to test. - * @return {boolean} True if the provided container has the same style as - * this attributes instance. - */ -hterm.TextAttributes.prototype.matchesContainer = function(obj) { - if (typeof obj == 'string' || obj.nodeType == Node.TEXT_NODE) - return this.isDefault(); - - var style = obj.style; - - // We don't want to put multiple characters in a wcNode or a tile. - // See the comments in createContainer. - // For attributes that default to false, we do not require that obj have them - // declared, so always normalize them using !! (to turn undefined into false) - // in the compares below. - return (!(this.wcNode || obj.wcNode) && - this.asciiNode == obj.asciiNode && - !(this.tileData != null || obj.tileNode) && - this.uriId == obj.uriId && - this.foreground == style.color && - this.background == style.backgroundColor && - this.underlineColor == style.textDecorationColor && - (this.enableBold && this.bold) == !!style.fontWeight && - this.blink == !!obj.blinkNode && - this.italic == !!style.fontStyle && - this.underline == obj.underline && - !!this.strikethrough == !!obj.strikethrough); -}; - -hterm.TextAttributes.prototype.setDefaults = function(foreground, background) { - this.defaultForeground = foreground; - this.defaultBackground = background; - - this.syncColors(); -}; - -/** - * Updates foreground and background properties based on current indices and - * other state. - * - * @param {string} terminalForeground The terminal foreground color for use as - * inverse text background. - * @param {string} terminalBackground The terminal background color for use as - * inverse text foreground. - * - */ -hterm.TextAttributes.prototype.syncColors = function() { - function getBrightIndex(i) { - if (i < 8) { - // If the color is from the lower half of the ANSI 16, add 8. - return i + 8; - } - - // If it's not from the 16 color palette, ignore bold requests. This - // matches the behavior of gnome-terminal. - return i; - } - - var foregroundSource = this.foregroundSource; - var backgroundSource = this.backgroundSource; - var defaultForeground = this.DEFAULT_COLOR; - var defaultBackground = this.DEFAULT_COLOR; - - if (this.inverse) { - foregroundSource = this.backgroundSource; - backgroundSource = this.foregroundSource; - // We can't inherit the container's color anymore. - defaultForeground = this.defaultBackground; - defaultBackground = this.defaultForeground; - } - - if (this.enableBoldAsBright && this.bold) { - if (Number.isInteger(foregroundSource)) { - foregroundSource = getBrightIndex(foregroundSource); - } - } - - if (foregroundSource == this.SRC_DEFAULT) - this.foreground = defaultForeground; - else if (Number.isInteger(foregroundSource)) - this.foreground = this.colorPalette[foregroundSource]; - else - this.foreground = foregroundSource; - - if (this.faint) { - var colorToMakeFaint = ((this.foreground == this.DEFAULT_COLOR) ? - this.defaultForeground : this.foreground); - this.foreground = lib.colors.mix(colorToMakeFaint, 'rgb(0, 0, 0)', 0.3333); - } - - if (backgroundSource == this.SRC_DEFAULT) - this.background = defaultBackground; - else if (Number.isInteger(backgroundSource)) - this.background = this.colorPalette[backgroundSource]; - else - this.background = backgroundSource; - - // Process invisible settings last to keep it simple. - if (this.invisible) - this.foreground = this.background; - - if (this.underlineSource == this.SRC_DEFAULT) - this.underlineColor = ''; - else if (Number.isInteger(this.underlineSource)) - this.underlineColor = this.colorPalette[this.underlineSource]; - else - this.underlineColor = this.underlineSource; -}; - -/** - * Static method used to test if the provided objects (strings, spans or - * text nodes) have the same style. - * - * For the purposes of this method, a string is considered a text node. - * - * @param {string|HTMLNode} obj1 An object to test. - * @param {string|HTMLNode} obj2 Another object to test. - * @return {boolean} True if the containers have the same style. - */ -hterm.TextAttributes.containersMatch = function(obj1, obj2) { - if (typeof obj1 == 'string') - return hterm.TextAttributes.containerIsDefault(obj2); - - if (obj1.nodeType != obj2.nodeType) - return false; - - if (obj1.nodeType == Node.TEXT_NODE) - return true; - - var style1 = obj1.style; - var style2 = obj2.style; - - return (style1.color == style2.color && - style1.backgroundColor == style2.backgroundColor && - style1.backgroundColor == style2.backgroundColor && - style1.fontWeight == style2.fontWeight && - style1.fontStyle == style2.fontStyle && - style1.textDecoration == style2.textDecoration && - style1.textDecorationColor == style2.textDecorationColor && - style1.textDecorationStyle == style2.textDecorationStyle && - style1.textDecorationLine == style2.textDecorationLine); -}; - -/** - * Static method to test if a given DOM container represents unstyled text. - * - * For the purposes of this method, a string is considered a text node. - * - * @param {string|HTMLNode} obj1 An object to test. - * @return {boolean} True if the object is unstyled. - */ -hterm.TextAttributes.containerIsDefault = function(obj) { - return typeof obj == 'string' || obj.nodeType == Node.TEXT_NODE; -}; - -/** - * Static method to get the column width of a node's textContent. - * - * @param {HTMLElement} node The HTML element to get the width of textContent - * from. - * @return {integer} The column width of the node's textContent. - */ -hterm.TextAttributes.nodeWidth = function(node) { - if (!node.asciiNode) { - return lib.wc.strWidth(node.textContent); - } else { - return node.textContent.length; - } -} - -/** - * Static method to get the substr of a node's textContent. The start index - * and substr width are computed in column width. - * - * @param {HTMLElement} node The HTML element to get the substr of textContent - * from. - * @param {integer} start The starting offset in column width. - * @param {integer} width The width to capture in column width. - * @return {integer} The extracted substr of the node's textContent. - */ -hterm.TextAttributes.nodeSubstr = function(node, start, width) { - if (!node.asciiNode) { - return lib.wc.substr(node.textContent, start, width); - } else { - return node.textContent.substr(start, width); - } -} - -/** - * Static method to get the substring based of a node's textContent. The - * start index of end index are computed in column width. - * - * @param {HTMLElement} node The HTML element to get the substr of textContent - * from. - * @param {integer} start The starting offset in column width. - * @param {integer} end The ending offset in column width. - * @return {integer} The extracted substring of the node's textContent. - */ -hterm.TextAttributes.nodeSubstring = function(node, start, end) { - if (!node.asciiNode) { - return lib.wc.substring(node.textContent, start, end); - } else { - return node.textContent.substring(start, end); - } -}; - -/** - * Static method to split a string into contiguous runs of single-width - * characters and runs of double-width characters. - * - * @param {string} str The string to split. - * @return {Array} An array of objects that contain substrings of str, where - * each substring is either a contiguous runs of single-width characters - * or a double-width character. For objects that contain a double-width - * character, its wcNode property is set to true. For objects that contain - * only ASCII content, its asciiNode property is set to true. - */ -hterm.TextAttributes.splitWidecharString = function(str) { - var rv = []; - var base = 0, length = 0, wcStrWidth = 0, wcCharWidth; - var asciiNode = true; - - for (var i = 0; i < str.length;) { - var c = str.codePointAt(i); - var increment; - if (c < 128) { - wcStrWidth += 1; - length += 1; - increment = 1; - } else { - increment = (c <= 0xffff) ? 1 : 2; - wcCharWidth = lib.wc.charWidth(c); - if (wcCharWidth <= 1) { - wcStrWidth += wcCharWidth; - length += increment; - asciiNode = false; - } else { - if (length) { - rv.push({ - str: str.substr(base, length), - asciiNode: asciiNode, - wcStrWidth: wcStrWidth, - }); - asciiNode = true; - wcStrWidth = 0; - } - rv.push({ - str: str.substr(i, increment), - wcNode: true, - asciiNode: false, - wcStrWidth: 2, - }); - base = i + increment; - length = 0; - } - } - i += increment; - } - - if (length) { - rv.push({ - str: str.substr(base, length), - asciiNode: asciiNode, - wcStrWidth: wcStrWidth, - }); - } - - return rv; -}; -// SOURCE FILE: hterm/js/hterm_vt.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.colors', 'lib.f', 'lib.UTF8Decoder', - 'hterm.VT.CharacterMap'); - -/** - * Constructor for the VT escape sequence interpreter. - * - * The interpreter operates on a terminal object capable of performing cursor - * move operations, painting characters, etc. - * - * This interpreter is intended to be compatible with xterm, though it - * ignores some of the more esoteric escape sequences. - * - * Control sequences are documented in hterm/doc/ControlSequences.md. - * - * @param {hterm.Terminal} terminal Terminal to use with the interpreter. - */ -hterm.VT = function(terminal) { - /** - * The display terminal object associated with this virtual terminal. - */ - this.terminal = terminal; - - terminal.onMouse = this.onTerminalMouse_.bind(this); - this.mouseReport = this.MOUSE_REPORT_DISABLED; - this.mouseCoordinates = this.MOUSE_COORDINATES_X10; - - // We only want to report mouse moves between cells, not between pixels. - this.lastMouseDragResponse_ = null; - - // Parse state left over from the last parse. You should use the parseState - // instance passed into your parse routine, rather than reading - // this.parseState_ directly. - this.parseState_ = new hterm.VT.ParseState(this.parseUnknown_); - - // Any "leading modifiers" for the escape sequence, such as '?', ' ', or the - // other modifiers handled in this.parseCSI_. - this.leadingModifier_ = ''; - - // Any "trailing modifiers". Same character set as a leading modifier, - // except these are found after the numeric arguments. - this.trailingModifier_ = ''; - - // Whether or not to respect the escape codes for setting terminal width. - this.allowColumnWidthChanges_ = false; - - // The amount of time we're willing to wait for the end of an OSC sequence. - this.oscTimeLimit_ = 20000; - - // Decoder to maintain UTF-8 decode state. - this.utf8Decoder_ = new lib.UTF8Decoder(); - - /** - * Whether to accept the 8-bit control characters. - * - * An 8-bit control character is one with the eighth bit set. These - * didn't work on 7-bit terminals so they all have two byte equivalents. - * Most hosts still only use the two-byte versions. - * - * We ignore 8-bit control codes by default. This is in order to avoid - * issues with "accidental" usage of codes that need to be terminated. - * The "accident" usually involves cat'ing binary data. - */ - this.enable8BitControl = false; - - /** - * Whether to allow the OSC 52 sequence to write to the system clipboard. - */ - this.enableClipboardWrite = true; - - /** - * Respect the host's attempt to change the cursor blink status using - * the DEC Private mode 12. - */ - this.enableDec12 = false; - - /** - * The expected encoding method for data received from the host. - */ - this.characterEncoding = 'utf-8'; - - /** - * If true, emit warnings when we encounter a control character or escape - * sequence that we don't recognize or explicitly ignore. - * - * We disable this by default as the console logging can be expensive when - * dumping binary files (e.g. `cat /dev/zero`) to the point where you can't - * recover w/out restarting. - */ - this.warnUnimplemented = false; - - /** - * The set of available character maps (used by G0...G3 below). - */ - this.characterMaps = new hterm.VT.CharacterMaps(); - - /** - * The default G0...G3 character maps. - * We default to the US/ASCII map everywhere as that aligns with other - * terminals, and it makes it harder to accidentally switch to the graphics - * character map (Ctrl-N). Any program that wants to use the graphics map - * will usually select it anyways since there's no guarantee what state any - * of the maps are in at any particular time. - */ - this.G0 = this.G1 = this.G2 = this.G3 = - this.characterMaps.getMap('B'); - - /** - * The 7-bit visible character set. - * - * This is a mapping from inbound data to display glyph. The GL set - * contains the 94 bytes from 0x21 to 0x7e. - * - * The default GL set is 'B', US ASCII. - */ - this.GL = 'G0'; - - /** - * The 8-bit visible character set. - * - * This is a mapping from inbound data to display glyph. The GR set - * contains the 94 bytes from 0xa1 to 0xfe. - */ - this.GR = 'G0'; - - /** - * The current encoding of the terminal. - * - * We only support ECMA-35 and UTF-8, so go with a boolean here. - * The encoding can be locked too. - */ - this.codingSystemUtf8_ = false; - this.codingSystemLocked_ = false; - - // Construct a regular expression to match the known one-byte control chars. - // This is used in parseUnknown_ to quickly scan a string for the next - // control character. - this.cc1Pattern_ = null; - this.updateEncodingState_(); -}; - -/** - * No mouse events. - */ -hterm.VT.prototype.MOUSE_REPORT_DISABLED = 0; - -/** - * DECSET mode 9. - * - * Report mouse down events only. - */ -hterm.VT.prototype.MOUSE_REPORT_PRESS = 1; - -/** - * DECSET mode 1000. - * - * Report mouse down/up events only. - */ -hterm.VT.prototype.MOUSE_REPORT_CLICK = 2; - -/** - * DECSET mode 1002. - * - * Report mouse down/up and movement while a button is down. - */ -hterm.VT.prototype.MOUSE_REPORT_DRAG = 3; - -/** - * DEC mode for X10 coorindates (the default). - */ -hterm.VT.prototype.MOUSE_COORDINATES_X10 = 0; - -/** - * DEC mode 1005 for UTF-8 coorindates. - */ -hterm.VT.prototype.MOUSE_COORDINATES_UTF8 = 1; - -/** - * DEC mode 1006 for SGR coorindates. - */ -hterm.VT.prototype.MOUSE_COORDINATES_SGR = 2; - -/** - * ParseState constructor. - * - * This object tracks the current state of the parse. It has fields for the - * current buffer, position in the buffer, and the parse function. - * - * @param {function} defaultFunc The default parser function. - * @param {string} opt_buf Optional string to use as the current buffer. - */ -hterm.VT.ParseState = function(defaultFunction, opt_buf) { - this.defaultFunction = defaultFunction; - this.buf = opt_buf || null; - this.pos = 0; - this.func = defaultFunction; - this.args = []; - // Whether any of the arguments in the args array have subarguments. - // e.g. All CSI sequences are integer arguments separated by semi-colons, - // so subarguments are further colon separated. - this.subargs = null; -}; - -/** - * Reset the parser function, buffer, and position. - */ -hterm.VT.ParseState.prototype.reset = function(opt_buf) { - this.resetParseFunction(); - this.resetBuf(opt_buf || ''); - this.resetArguments(); -}; - -/** - * Reset the parser function only. - */ -hterm.VT.ParseState.prototype.resetParseFunction = function() { - this.func = this.defaultFunction; -}; - -/** - * Reset the buffer and position only. - * - * @param {string} buf Optional new value for buf, defaults to null. - */ -hterm.VT.ParseState.prototype.resetBuf = function(opt_buf) { - this.buf = (typeof opt_buf == 'string') ? opt_buf : null; - this.pos = 0; -}; - -/** - * Reset the arguments list only. - * - * Typically we reset arguments before parsing a sequence that uses them rather - * than always trying to make sure they're in a good state. This can lead to - * confusion during debugging where args from a previous sequence appear to be - * "sticking around" in other sequences (which in reality don't use args). - * - * @param {string} opt_arg_zero Optional initial value for args[0]. - */ -hterm.VT.ParseState.prototype.resetArguments = function(opt_arg_zero) { - this.args.length = 0; - if (typeof opt_arg_zero != 'undefined') - this.args[0] = opt_arg_zero; -}; - -/** - * Parse an argument as an integer. - * - * This assumes the inputs are already in the proper format. e.g. This won't - * handle non-numeric arguments. - * - * An "0" argument is treated the same as "" which means the default value will - * be applied. This is what most terminal sequences expect. - * - * @param {string} argstr The argument to parse directly. - * @param {number=} defaultValue Default value if argstr is empty. - * @return {number} The parsed value. - */ -hterm.VT.ParseState.prototype.parseInt = function(argstr, defaultValue) { - if (defaultValue === undefined) - defaultValue = 0; - - if (argstr) { - const ret = parseInt(argstr, 10); - // An argument of zero is treated as the default value. - return ret == 0 ? defaultValue : ret; - } - return defaultValue; -}; - -/** - * Get an argument as an integer. - * - * @param {number} argnum The argument number to retrieve. - * @param {number=} defaultValue Default value if the argument is empty. - * @return {number} The parsed value. - */ -hterm.VT.ParseState.prototype.iarg = function(argnum, defaultValue) { - return this.parseInt(this.args[argnum], defaultValue); -}; - -/** - * Check whether an argument has subarguments. - * - * @param {number} argnum The argument number to check. - * @return {number} Whether the argument has subarguments. - */ -hterm.VT.ParseState.prototype.argHasSubargs = function(argnum) { - return this.subargs && this.subargs[argnum]; -}; - -/** - * Mark an argument as having subarguments. - * - * @param {number} argnum The argument number that has subarguments. - */ -hterm.VT.ParseState.prototype.argSetSubargs = function(argnum) { - if (this.subargs === null) - this.subargs = {}; - this.subargs[argnum] = true; -}; - -/** - * Advance the parse position. - * - * @param {integer} count The number of bytes to advance. - */ -hterm.VT.ParseState.prototype.advance = function(count) { - this.pos += count; -}; - -/** - * Return the remaining portion of the buffer without affecting the parse - * position. - * - * @return {string} The remaining portion of the buffer. - */ -hterm.VT.ParseState.prototype.peekRemainingBuf = function() { - return this.buf.substr(this.pos); -}; - -/** - * Return the next single character in the buffer without affecting the parse - * position. - * - * @return {string} The next character in the buffer. - */ -hterm.VT.ParseState.prototype.peekChar = function() { - return this.buf.substr(this.pos, 1); -}; - -/** - * Return the next single character in the buffer and advance the parse - * position one byte. - * - * @return {string} The next character in the buffer. - */ -hterm.VT.ParseState.prototype.consumeChar = function() { - return this.buf.substr(this.pos++, 1); -}; - -/** - * Return true if the buffer is empty, or the position is past the end. - */ -hterm.VT.ParseState.prototype.isComplete = function() { - return this.buf == null || this.buf.length <= this.pos; -}; - -/** - * Reset the VT back to baseline state. - */ -hterm.VT.prototype.reset = function() { - this.G0 = this.G1 = this.G2 = this.G3 = - this.characterMaps.getMap('B'); - - this.GL = 'G0'; - this.GR = 'G0'; - - this.mouseReport = this.MOUSE_REPORT_DISABLED; - this.mouseCoordinates = this.MOUSE_COORDINATES_X10; - this.lastMouseDragResponse_ = null; -}; - -/** - * Handle terminal mouse events. - * - * See the "Mouse Tracking" section of [xterm]. - */ -hterm.VT.prototype.onTerminalMouse_ = function(e) { - // Short circuit a few events to avoid unnecessary processing. - if (this.mouseReport == this.MOUSE_REPORT_DISABLED) - return; - else if (this.mouseReport != this.MOUSE_REPORT_DRAG && e.type == 'mousemove') - return; - - // Temporary storage for our response. - var response; - - // Modifier key state. - var mod = 0; - if (this.mouseReport != this.MOUSE_REPORT_PRESS) { - if (e.shiftKey) - mod |= 4; - if (e.metaKey || (this.terminal.keyboard.altIsMeta && e.altKey)) - mod |= 8; - if (e.ctrlKey) - mod |= 16; - } - - // X & Y coordinate reporting. - let x; - let y; - let limit = 255; - switch (this.mouseCoordinates) { - case this.MOUSE_COORDINATES_UTF8: - // UTF-8 mode is the same as X10 but with higher limits. - limit = 2047; - case this.MOUSE_COORDINATES_X10: - // X10 reports coordinates by encoding into strings. - x = String.fromCharCode(lib.f.clamp(e.terminalColumn + 32, 32, limit)); - y = String.fromCharCode(lib.f.clamp(e.terminalRow + 32, 32, limit)); - break; - case this.MOUSE_COORDINATES_SGR: - // SGR reports coordinates by transmitting the numbers directly. - x = e.terminalColumn; - y = e.terminalRow; - break; - } - - switch (e.type) { - case 'wheel': - // Mouse wheel is treated as button 1 or 2 plus an additional 64. - b = (((e.deltaY * -1) > 0) ? 0 : 1) + 64; - b |= mod; - if (this.mouseCoordinates == this.MOUSE_COORDINATES_SGR) - response = `\x1b[<${b};${x};${y}M`; - else - response = '\x1b[M' + String.fromCharCode(b) + x + y; - - // Keep the terminal from scrolling. - e.preventDefault(); - break; - - case 'mousedown': - // Buttons are encoded as button number. - var b = Math.min(e.button, 2); - // In X10 mode, we also add 32 for legacy reasons. - if (this.mouseCoordinates != this.MOUSE_COORDINATES_SGR) - b += 32; - - // And mix in the modifier keys. - b |= mod; - - if (this.mouseCoordinates == this.MOUSE_COORDINATES_SGR) - response = `\x1b[<${b};${x};${y}M`; - else - response = '\x1b[M' + String.fromCharCode(b) + x + y; - break; - - case 'mouseup': - if (this.mouseReport != this.MOUSE_REPORT_PRESS) { - if (this.mouseCoordinates == this.MOUSE_COORDINATES_SGR) { - // SGR mode can report the released button. - response = `\x1b[<${e.button};${x};${y}m`; - } else { - // X10 mode has no indication of which button was released. - response = '\x1b[M\x23' + x + y; - } - } - break; - - case 'mousemove': - if (this.mouseReport == this.MOUSE_REPORT_DRAG && e.buttons) { - // Standard button bits. The XTerm protocol only reports the first - // button press (e.g. if left & right are pressed, right is ignored), - // and it only supports the first three buttons. If none of them are - // pressed, then XTerm flags it as a release. We'll do the same. - b = this.mouseCoordinates == this.MOUSE_COORDINATES_SGR ? 0 : 32; - - // Priority here matches XTerm: left, middle, right. - if (e.buttons & 0x1) { - // Report left button. - b += 0; - } else if (e.buttons & 0x4) { - // Report middle button. - b += 1; - } else if (e.buttons & 0x2) { - // Report right button. - b += 2; - } else { - // Release higher buttons. - b += 3; - } - - // Add 32 to indicate mouse motion. - b += 32; - - // And mix in the modifier keys. - b |= mod; - - if (this.mouseCoordinates == this.MOUSE_COORDINATES_SGR) - response = `\x1b[<${b};${x};${y}M`; - else - response = '\x1b[M' + String.fromCharCode(b) + x + y; - - // If we were going to report the same cell because we moved pixels - // within, suppress the report. This is what xterm does and cuts - // down on duplicate messages. - if (this.lastMouseDragResponse_ == response) - response = ''; - else - this.lastMouseDragResponse_ = response; - } - - break; - - case 'click': - case 'dblclick': - break; - - default: - console.error('Unknown mouse event: ' + e.type, e); - break; - } - - if (response) - this.terminal.io.sendString(response); -}; - -/** - * Interpret a string of characters, displaying the results on the associated - * terminal object. - * - * The buffer will be decoded according to the 'receive-encoding' preference. - */ -hterm.VT.prototype.interpret = function(buf) { - this.parseState_.resetBuf(this.decode(buf)); - - while (!this.parseState_.isComplete()) { - var func = this.parseState_.func; - var pos = this.parseState_.pos; - var buf = this.parseState_.buf; - - this.parseState_.func.call(this, this.parseState_); - - if (this.parseState_.func == func && this.parseState_.pos == pos && - this.parseState_.buf == buf) { - throw 'Parser did not alter the state!'; - } - } -}; - -/** - * Decode a string according to the 'receive-encoding' preference. - */ -hterm.VT.prototype.decode = function(str) { - if (this.characterEncoding == 'utf-8') - return this.decodeUTF8(str); - - return str; -}; - -/** - * Encode a UTF-16 string as UTF-8. - * - * See also: https://en.wikipedia.org/wiki/UTF-16 - */ -hterm.VT.prototype.encodeUTF8 = function(str) { - return lib.encodeUTF8(str); -}; - -/** - * Decode a UTF-8 string into UTF-16. - */ -hterm.VT.prototype.decodeUTF8 = function(str) { - return this.utf8Decoder_.decode(str); -}; - -/** - * Set the encoding of the terminal. - * - * @param {string} encoding The name of the encoding to set. - */ -hterm.VT.prototype.setEncoding = function(encoding) { - switch (encoding) { - default: - console.warn('Invalid value for "terminal-encoding": ' + encoding); - // Fall through. - case 'iso-2022': - this.codingSystemUtf8_ = false; - this.codingSystemLocked_ = false; - break; - case 'utf-8-locked': - this.codingSystemUtf8_ = true; - this.codingSystemLocked_ = true; - break; - case 'utf-8': - this.codingSystemUtf8_ = true; - this.codingSystemLocked_ = false; - break; - } - - this.updateEncodingState_(); -}; - -/** - * Refresh internal state when the encoding changes. - */ -hterm.VT.prototype.updateEncodingState_ = function() { - // If we're in UTF8 mode, don't suport 8-bit escape sequences as we'll never - // see those -- everything should be UTF8! - var cc1 = Object.keys(hterm.VT.CC1) - .filter((e) => !this.codingSystemUtf8_ || e.charCodeAt() < 0x80) - .map((e) => '\\x' + lib.f.zpad(e.charCodeAt().toString(16), 2)) - .join(''); - this.cc1Pattern_ = new RegExp(`[${cc1}]`); -}; - -/** - * The default parse function. - * - * This will scan the string for the first 1-byte control character (C0/C1 - * characters from [CTRL]). Any plain text coming before the code will be - * printed to the terminal, then the control character will be dispatched. - */ -hterm.VT.prototype.parseUnknown_ = function(parseState) { - var self = this; - - function print(str) { - if (!self.codingSystemUtf8_ && self[self.GL].GL) - str = self[self.GL].GL(str); - - self.terminal.print(str); - }; - - // Search for the next contiguous block of plain text. - var buf = parseState.peekRemainingBuf(); - var nextControl = buf.search(this.cc1Pattern_); - - if (nextControl == 0) { - // We've stumbled right into a control character. - this.dispatch('CC1', buf.substr(0, 1), parseState); - parseState.advance(1); - return; - } - - if (nextControl == -1) { - // There are no control characters in this string. - print(buf); - parseState.reset(); - return; - } - - print(buf.substr(0, nextControl)); - this.dispatch('CC1', buf.substr(nextControl, 1), parseState); - parseState.advance(nextControl + 1); -}; - -/** - * Parse a Control Sequence Introducer code and dispatch it. - * - * See [CSI] for some useful information about these codes. - */ -hterm.VT.prototype.parseCSI_ = function(parseState) { - var ch = parseState.peekChar(); - var args = parseState.args; - - const finishParsing = () => { - // Resetting the arguments isn't strictly necessary, but it makes debugging - // less confusing (otherwise args will stick around until the next sequence - // that needs arguments). - parseState.resetArguments(); - // We need to clear subargs since we explicitly set it. - parseState.subargs = null; - parseState.resetParseFunction(); - }; - - if (ch >= '@' && ch <= '~') { - // This is the final character. - this.dispatch('CSI', this.leadingModifier_ + this.trailingModifier_ + ch, - parseState); - finishParsing(); - - } else if (ch == ';') { - // Parameter delimiter. - if (this.trailingModifier_) { - // Parameter delimiter after the trailing modifier. That's a paddlin'. - finishParsing(); - - } else { - if (!args.length) { - // They omitted the first param, we need to supply it. - args.push(''); - } - - args.push(''); - } - - } else if (ch >= '0' && ch <= '9' || ch == ':') { - // Next byte in the current parameter. - - if (this.trailingModifier_) { - // Numeric parameter after the trailing modifier. That's a paddlin'. - finishParsing(); - } else { - if (!args.length) { - args[0] = ch; - } else { - args[args.length - 1] += ch; - } - - // Possible sub-parameters. - if (ch == ':') - parseState.argSetSubargs(args.length - 1); - } - - } else if (ch >= ' ' && ch <= '?') { - // Modifier character. - if (!args.length) { - this.leadingModifier_ += ch; - } else { - this.trailingModifier_ += ch; - } - - } else if (this.cc1Pattern_.test(ch)) { - // Control character. - this.dispatch('CC1', ch, parseState); - - } else { - // Unexpected character in sequence, bail out. - finishParsing(); - } - - parseState.advance(1); -}; - -/** - * Skip over the string until the next String Terminator (ST, 'ESC \') or - * Bell (BEL, '\x07'). - * - * The string is accumulated in parseState.args[0]. Make sure to reset the - * arguments (with parseState.resetArguments) before starting the parse. - * - * You can detect that parsing in complete by checking that the parse - * function has changed back to the default parse function. - * - * @return {boolean} If true, parsing is ongoing or complete. If false, we've - * exceeded the max string sequence. - */ -hterm.VT.prototype.parseUntilStringTerminator_ = function(parseState) { - var buf = parseState.peekRemainingBuf(); - var args = parseState.args; - // Since we might modify parse state buffer locally, if we want to advance - // the parse state buffer later on, we need to know how many chars we added. - let bufInserted = 0; - - if (!args.length) { - args[0] = ''; - args[1] = new Date(); - } else { - // If our saved buffer ends with an escape, it's because we were hoping - // it's an ST split across two buffers. Move it from our saved buffer - // to the start of our current buffer for processing anew. - if (args[0].slice(-1) == '\x1b') { - args[0] = args[0].slice(0, -1); - buf = '\x1b' + buf; - bufInserted = 1; - } - } - - const nextTerminator = buf.search(/[\x1b\x07]/); - const terminator = buf[nextTerminator]; - let foundTerminator; - - // If the next escape we see is not a start of a ST, fall through. This will - // either be invalid (embedded escape), or we'll queue it up (wait for \\). - if (terminator == '\x1b' && buf[nextTerminator + 1] != '\\') - foundTerminator = false; - else - foundTerminator = (nextTerminator != -1); - - if (!foundTerminator) { - // No terminator here, have to wait for the next string. - - args[0] += buf; - - var abortReason; - - // Special case: If our buffering happens to split the ST (\e\\), we have to - // buffer the content temporarily. So don't reject a trailing escape here, - // instead we let it timeout or be rejected in the next pass. - if (terminator == '\x1b' && nextTerminator != buf.length - 1) - abortReason = 'embedded escape: ' + nextTerminator; - - if (new Date() - args[1] > this.oscTimeLimit_) - abortReason = 'timeout expired: ' + (new Date() - args[1]); - - if (abortReason) { - if (this.warnUnimplemented) - console.log('parseUntilStringTerminator_: aborting: ' + abortReason, - args[0]); - parseState.reset(args[0]); - return false; - } - - parseState.advance(buf.length - bufInserted); - return true; - } - - args[0] += buf.substr(0, nextTerminator); - - parseState.resetParseFunction(); - parseState.advance(nextTerminator + - (terminator == '\x1b' ? 2 : 1) - bufInserted); - - return true; -}; - -/** - * Dispatch to the function that handles a given CC1, ESC, or CSI or VT52 code. - */ -hterm.VT.prototype.dispatch = function(type, code, parseState) { - var handler = hterm.VT[type][code]; - if (!handler) { - if (this.warnUnimplemented) - console.warn('Unknown ' + type + ' code: ' + JSON.stringify(code)); - return; - } - - if (handler == hterm.VT.ignore) { - if (this.warnUnimplemented) - console.warn('Ignored ' + type + ' code: ' + JSON.stringify(code)); - return; - } - - if (parseState.subargs && !handler.supportsSubargs) { - if (this.warnUnimplemented) - console.warn('Ignored ' + type + ' code w/subargs: ' + JSON.stringify(code)); - return; - } - - if (type == 'CC1' && code > '\x7f' && !this.enable8BitControl) { - // It's kind of a hack to put this here, but... - // - // If we're dispatching a 'CC1' code, and it's got the eighth bit set, - // but we're not supposed to handle 8-bit codes? Just ignore it. - // - // This prevents an errant (DCS, '\x90'), (OSC, '\x9d'), (PM, '\x9e') or - // (APC, '\x9f') from locking up the terminal waiting for its expected - // (ST, '\x9c') or (BEL, '\x07'). - console.warn('Ignoring 8-bit control code: 0x' + - code.charCodeAt(0).toString(16)); - return; - } - - handler.apply(this, [parseState, code]); -}; - -/** - * Set one of the ANSI defined terminal mode bits. - * - * Invoked in response to SM/RM. - * - * Unexpected and unimplemented values are silently ignored. - */ -hterm.VT.prototype.setANSIMode = function(code, state) { - if (code == 4) { // Insert Mode (IRM) - this.terminal.setInsertMode(state); - } else if (code == 20) { // Automatic Newline (LNM) - this.terminal.setAutoCarriageReturn(state); - } else if (this.warnUnimplemented) { - console.warn('Unimplemented ANSI Mode: ' + code); - } -}; - -/** - * Set or reset one of the DEC Private modes. - * - * Invoked in response to DECSET/DECRST. - */ -hterm.VT.prototype.setDECMode = function(code, state) { - switch (parseInt(code, 10)) { - case 1: // DECCKM - this.terminal.keyboard.applicationCursor = state; - break; - - case 3: // DECCOLM - if (this.allowColumnWidthChanges_) { - this.terminal.setWidth(state ? 132 : 80); - - this.terminal.clearHome(); - this.terminal.setVTScrollRegion(null, null); - } - break; - - case 5: // DECSCNM - this.terminal.setReverseVideo(state); - break; - - case 6: // DECOM - this.terminal.setOriginMode(state); - break; - - case 7: // DECAWM - this.terminal.setWraparound(state); - break; - - case 9: // Report on mouse down events only (X10). - this.mouseReport = ( - state ? this.MOUSE_REPORT_PRESS : this.MOUSE_REPORT_DISABLED); - this.terminal.syncMouseStyle(); - break; - - case 12: // Start blinking cursor - if (this.enableDec12) - this.terminal.setCursorBlink(state); - break; - - case 25: // DECTCEM - this.terminal.setCursorVisible(state); - break; - - case 30: // Show scrollbar - this.terminal.setScrollbarVisible(state); - break; - - case 40: // Allow 80 - 132 (DECCOLM) Mode - this.terminal.allowColumnWidthChanges_ = state; - break; - - case 45: // Reverse-wraparound Mode - this.terminal.setReverseWraparound(state); - break; - - case 67: // Backarrow key sends backspace (DECBKM) - this.terminal.keyboard.backspaceSendsBackspace = state; - break; - - case 1000: // Report on mouse clicks only (X11). - this.mouseReport = ( - state ? this.MOUSE_REPORT_CLICK : this.MOUSE_REPORT_DISABLED); - this.terminal.syncMouseStyle(); - break; - - case 1002: // Report on mouse clicks and drags - this.mouseReport = ( - state ? this.MOUSE_REPORT_DRAG : this.MOUSE_REPORT_DISABLED); - this.terminal.syncMouseStyle(); - break; - - case 1004: // Report on window focus change. - this.terminal.reportFocus = state; - break; - - case 1005: // Extended coordinates in UTF-8 mode. - this.mouseCoordinates = ( - state ? this.MOUSE_COORDINATES_UTF8 : this.MOUSE_COORDINATES_X10); - break; - - case 1006: // Extended coordinates in SGR mode. - this.mouseCoordinates = ( - state ? this.MOUSE_COORDINATES_SGR : this.MOUSE_COORDINATES_X10); - break; - - case 1007: // Enable Alternate Scroll Mode. - this.terminal.scrollWheelArrowKeys_ = state; - break; - - case 1010: // Scroll to bottom on tty output - this.terminal.scrollOnOutput = state; - break; - - case 1011: // Scroll to bottom on key press - this.terminal.scrollOnKeystroke = state; - break; - - case 1036: // Send ESC when Meta modifies a key - this.terminal.keyboard.metaSendsEscape = state; - break; - - case 1039: // Send ESC when Alt modifies a key - if (state) { - if (!this.terminal.keyboard.previousAltSendsWhat_) { - this.terminal.keyboard.previousAltSendsWhat_ = - this.terminal.keyboard.altSendsWhat; - this.terminal.keyboard.altSendsWhat = 'escape'; - } - } else if (this.terminal.keyboard.previousAltSendsWhat_) { - this.terminal.keyboard.altSendsWhat = - this.terminal.keyboard.previousAltSendsWhat_; - this.terminal.keyboard.previousAltSendsWhat_ = null; - } - break; - - case 47: // Use Alternate Screen Buffer - case 1047: - this.terminal.setAlternateMode(state); - break; - - case 1048: // Save cursor as in DECSC. - if (state) - this.terminal.saveCursorAndState(); - else - this.terminal.restoreCursorAndState(); - break; - - case 1049: // 1047 + 1048 + clear. - if (state) { - this.terminal.saveCursorAndState(); - this.terminal.setAlternateMode(state); - this.terminal.clear(); - } else { - this.terminal.setAlternateMode(state); - this.terminal.restoreCursorAndState(); - } - - break; - - case 2004: // Bracketed paste mode. - this.terminal.setBracketedPaste(state); - break; - - default: - if (this.warnUnimplemented) - console.warn('Unimplemented DEC Private Mode: ' + code); - break; - } -}; - -/** - * Function shared by control characters and escape sequences that are - * ignored. - */ -hterm.VT.ignore = function() {}; - -/** - * Collection of control characters expressed in a single byte. - * - * This includes the characters from the C0 and C1 sets (see [CTRL]) that we - * care about. Two byte versions of the C1 codes are defined in the - * hterm.VT.ESC collection. - * - * The 'CC1' mnemonic here refers to the fact that these are one-byte Control - * Codes. It's only used in this source file and not defined in any of the - * referenced documents. - */ -hterm.VT.CC1 = {}; - -/** - * Collection of two-byte and three-byte sequences starting with ESC. - */ -hterm.VT.ESC = {}; - -/** - * Collection of CSI (Control Sequence Introducer) sequences. - * - * These sequences begin with 'ESC [', and may take zero or more arguments. - */ -hterm.VT.CSI = {}; - -/** - * Collection of OSC (Operating System Control) sequences. - * - * These sequences begin with 'ESC ]', followed by a function number and a - * string terminated by either ST or BEL. - */ -hterm.VT.OSC = {}; - -/** - * Collection of VT52 sequences. - * - * When in VT52 mode, other sequences are disabled. - */ -hterm.VT.VT52 = {}; - -/** - * Null (NUL). - * - * Silently ignored. - */ -hterm.VT.CC1['\x00'] = hterm.VT.ignore; - -/** - * Enquiry (ENQ). - * - * Transmit answerback message. - * - * The default answerback message in xterm is an empty string, so we just - * ignore this. - */ -hterm.VT.CC1['\x05'] = hterm.VT.ignore; - -/** - * Ring Bell (BEL). - */ -hterm.VT.CC1['\x07'] = function() { - this.terminal.ringBell(); -}; - -/** - * Backspace (BS). - * - * Move the cursor to the left one character position, unless it is at the - * left margin, in which case no action occurs. - */ -hterm.VT.CC1['\x08'] = function() { - this.terminal.cursorLeft(1); -}; - -/** - * Horizontal Tab (HT). - * - * Move the cursor to the next tab stop, or to the right margin if no further - * tab stops are present on the line. - */ -hterm.VT.CC1['\x09'] = function() { - this.terminal.forwardTabStop(); -}; - -/** - * Line Feed (LF). - * - * This code causes a line feed or a new line operation. See Automatic - * Newline (LNM). - */ -hterm.VT.CC1['\x0a'] = function() { - this.terminal.formFeed(); -}; - -/** - * Vertical Tab (VT). - * - * Interpreted as LF. - */ -hterm.VT.CC1['\x0b'] = hterm.VT.CC1['\x0a']; - -/** - * Form Feed (FF). - * - * Interpreted as LF. - */ -hterm.VT.CC1['\x0c'] = hterm.VT.CC1['\x0a']; - -/** - * Carriage Return (CR). - * - * Move cursor to the left margin on the current line. - */ -hterm.VT.CC1['\x0d'] = function() { - this.terminal.setCursorColumn(0); -}; - -/** - * Shift Out (SO), aka Lock Shift 0 (LS1). - * - * Invoke G1 character set in GL. - */ -hterm.VT.CC1['\x0e'] = function() { - this.GL = 'G1'; -}; - -/** - * Shift In (SI), aka Lock Shift 0 (LS0). - * - * Invoke G0 character set in GL. - */ -hterm.VT.CC1['\x0f'] = function() { - this.GL = 'G0'; -}; - -/** - * Transmit On (XON). - * - * Not currently implemented. - * - * TODO(rginda): Implement? - */ -hterm.VT.CC1['\x11'] = hterm.VT.ignore; - -/** - * Transmit Off (XOFF). - * - * Not currently implemented. - * - * TODO(rginda): Implement? - */ -hterm.VT.CC1['\x13'] = hterm.VT.ignore; - -/** - * Cancel (CAN). - * - * If sent during a control sequence, the sequence is immediately terminated - * and not executed. - * - * It also causes the error character to be displayed. - */ -hterm.VT.CC1['\x18'] = function(parseState) { - // If we've shifted in the G1 character set, shift it back out to - // the default character set. - if (this.GL == 'G1') { - this.GL = 'G0'; - } - parseState.resetParseFunction(); - this.terminal.print('?'); -}; - -/** - * Substitute (SUB). - * - * Interpreted as CAN. - */ -hterm.VT.CC1['\x1a'] = hterm.VT.CC1['\x18']; - -/** - * Escape (ESC). - */ -hterm.VT.CC1['\x1b'] = function(parseState) { - function parseESC(parseState) { - var ch = parseState.consumeChar(); - - if (ch == '\x1b') - return; - - this.dispatch('ESC', ch, parseState); - - if (parseState.func == parseESC) - parseState.resetParseFunction(); - }; - - parseState.func = parseESC; -}; - -/** - * Delete (DEL). - */ -hterm.VT.CC1['\x7f'] = hterm.VT.ignore; - -// 8 bit control characters and their two byte equivalents, below... - -/** - * Index (IND). - * - * Like newline, only keep the X position - */ -hterm.VT.CC1['\x84'] = -hterm.VT.ESC['D'] = function() { - this.terminal.lineFeed(); -}; - -/** - * Next Line (NEL). - * - * Like newline, but doesn't add lines. - */ -hterm.VT.CC1['\x85'] = -hterm.VT.ESC['E'] = function() { - this.terminal.setCursorColumn(0); - this.terminal.cursorDown(1); -}; - -/** - * Horizontal Tabulation Set (HTS). - */ -hterm.VT.CC1['\x88'] = -hterm.VT.ESC['H'] = function() { - this.terminal.setTabStop(this.terminal.getCursorColumn()); -}; - -/** - * Reverse Index (RI). - * - * Move up one line. - */ -hterm.VT.CC1['\x8d'] = -hterm.VT.ESC['M'] = function() { - this.terminal.reverseLineFeed(); -}; - -/** - * Single Shift 2 (SS2). - * - * Select of G2 Character Set for the next character only. - * - * Not currently implemented. - */ -hterm.VT.CC1['\x8e'] = -hterm.VT.ESC['N'] = hterm.VT.ignore; - -/** - * Single Shift 3 (SS3). - * - * Select of G3 Character Set for the next character only. - * - * Not currently implemented. - */ -hterm.VT.CC1['\x8f'] = -hterm.VT.ESC['O'] = hterm.VT.ignore; - -/** - * Device Control String (DCS). - * - * Indicate a DCS sequence. See Device-Control functions in [XTERM]. - * Not currently implemented. - * - * TODO(rginda): Consider implementing DECRQSS, the rest don't seem applicable. - */ -hterm.VT.CC1['\x90'] = -hterm.VT.ESC['P'] = function(parseState) { - parseState.resetArguments(); - parseState.func = this.parseUntilStringTerminator_; -}; - -/** - * Start of Guarded Area (SPA). - * - * Will not implement. - */ -hterm.VT.CC1['\x96'] = -hterm.VT.ESC['V'] = hterm.VT.ignore; - -/** - * End of Guarded Area (EPA). - * - * Will not implement. - */ -hterm.VT.CC1['\x97'] = -hterm.VT.ESC['W'] = hterm.VT.ignore; - -/** - * Start of String (SOS). - * - * Will not implement. - */ -hterm.VT.CC1['\x98'] = -hterm.VT.ESC['X'] = hterm.VT.ignore; - -/** - * Single Character Introducer (SCI, also DECID). - * - * Return Terminal ID. Obsolete form of 'ESC [ c' (DA). - */ -hterm.VT.CC1['\x9a'] = -hterm.VT.ESC['Z'] = function() { - this.terminal.io.sendString('\x1b[?1;2c'); -}; - -/** - * Control Sequence Introducer (CSI). - * - * The lead into most escape sequences. See [CSI]. - */ -hterm.VT.CC1['\x9b'] = -hterm.VT.ESC['['] = function(parseState) { - parseState.resetArguments(); - this.leadingModifier_ = ''; - this.trailingModifier_ = ''; - parseState.func = this.parseCSI_; -}; - -/** - * String Terminator (ST). - * - * Used to terminate DCS/OSC/PM/APC commands which may take string arguments. - * - * We don't directly handle it here, as it's only used to terminate other - * sequences. See the 'parseUntilStringTerminator_' method. - */ -hterm.VT.CC1['\x9c'] = -hterm.VT.ESC['\\'] = hterm.VT.ignore; - -/** - * Operating System Command (OSC). - * - * Commands relating to the operating system. - */ -hterm.VT.CC1['\x9d'] = -hterm.VT.ESC[']'] = function(parseState) { - parseState.resetArguments(); - - function parseOSC(parseState) { - if (!this.parseUntilStringTerminator_(parseState)) { - // The string sequence was too long. - return; - } - - if (parseState.func == parseOSC) { - // We're not done parsing the string yet. - return; - } - - // We're done. - var ary = parseState.args[0].match(/^(\d+);(.*)$/); - if (ary) { - parseState.args[0] = ary[2]; - this.dispatch('OSC', ary[1], parseState); - } else { - console.warn('Invalid OSC: ' + JSON.stringify(parseState.args[0])); - } - - // Resetting the arguments isn't strictly necessary, but it makes debugging - // less confusing (otherwise args will stick around until the next sequence - // that needs arguments). - parseState.resetArguments(); - }; - - parseState.func = parseOSC; -}; - -/** - * Privacy Message (PM). - * - * Will not implement. - */ -hterm.VT.CC1['\x9e'] = -hterm.VT.ESC['^'] = function(parseState) { - parseState.resetArguments(); - parseState.func = this.parseUntilStringTerminator_; -}; - -/** - * Application Program Control (APC). - * - * Will not implement. - */ -hterm.VT.CC1['\x9f'] = -hterm.VT.ESC['_'] = function(parseState) { - parseState.resetArguments(); - parseState.func = this.parseUntilStringTerminator_; -}; - -/** - * ESC \x20 - Unclear to me where these originated, possibly in xterm. - * - * Not currently implemented: - * ESC \x20 F - Select 7 bit escape codes in responses (S7C1T). - * ESC \x20 G - Select 8 bit escape codes in responses (S8C1T). - * NB: We currently assume S7C1T always. - * - * Will not implement: - * ESC \x20 L - Set ANSI conformance level 1. - * ESC \x20 M - Set ANSI conformance level 2. - * ESC \x20 N - Set ANSI conformance level 3. - */ -hterm.VT.ESC['\x20'] = function(parseState) { - parseState.func = function(parseState) { - var ch = parseState.consumeChar(); - if (this.warnUnimplemented) - console.warn('Unimplemented sequence: ESC 0x20 ' + ch); - parseState.resetParseFunction(); - }; -}; - -/** - * DEC 'ESC #' sequences. - */ -hterm.VT.ESC['#'] = function(parseState) { - parseState.func = function(parseState) { - var ch = parseState.consumeChar(); - if (ch == '8') // DEC Screen Alignment Test (DECALN) - this.terminal.fill('E'); - - parseState.resetParseFunction(); - }; -}; - -/** - * Designate Other Coding System (DOCS). - */ -hterm.VT.ESC['%'] = function(parseState) { - parseState.func = function(parseState) { - var ch = parseState.consumeChar(); - - // If we've locked the encoding, then just eat the bytes and return. - if (this.codingSystemLocked_) { - if (ch == '/') - parseState.consumeChar(); - parseState.resetParseFunction(); - return; - } - - // Process the encoding requests. - switch (ch) { - case '@': - // Switch to ECMA 35. - this.setEncoding('iso-2022'); - break; - - case 'G': - // Switch to UTF-8. - this.setEncoding('utf-8'); - break; - - case '/': - // One way transition to something else. - ch = parseState.consumeChar(); - switch (ch) { - case 'G': // UTF-8 Level 1. - case 'H': // UTF-8 Level 2. - case 'I': // UTF-8 Level 3. - // We treat all UTF-8 levels the same. - this.setEncoding('utf-8-locked'); - break; - - default: - if (this.warnUnimplemented) - console.warn('Unknown ESC % / argument: ' + JSON.stringify(ch)); - break; - } - break; - - default: - if (this.warnUnimplemented) - console.warn('Unknown ESC % argument: ' + JSON.stringify(ch)); - break; - } - - parseState.resetParseFunction(); - }; -}; - -/** - * Character Set Selection (SCS). - * - * ESC ( Ps - Set G0 character set (VT100). - * ESC ) Ps - Set G1 character set (VT220). - * ESC * Ps - Set G2 character set (VT220). - * ESC + Ps - Set G3 character set (VT220). - * ESC - Ps - Set G1 character set (VT300). - * ESC . Ps - Set G2 character set (VT300). - * ESC / Ps - Set G3 character set (VT300). - * - * All other sequences are echoed to the terminal. - */ -hterm.VT.ESC['('] = -hterm.VT.ESC[')'] = -hterm.VT.ESC['*'] = -hterm.VT.ESC['+'] = -hterm.VT.ESC['-'] = -hterm.VT.ESC['.'] = -hterm.VT.ESC['/'] = function(parseState, code) { - parseState.func = function(parseState) { - var ch = parseState.consumeChar(); - if (ch == '\x1b') { - parseState.resetParseFunction(); - parseState.func(); - return; - } - - var map = this.characterMaps.getMap(ch); - if (map !== undefined) { - if (code == '(') { - this.G0 = map; - } else if (code == ')' || code == '-') { - this.G1 = map; - } else if (code == '*' || code == '.') { - this.G2 = map; - } else if (code == '+' || code == '/') { - this.G3 = map; - } - } else if (this.warnUnimplemented) { - console.log('Invalid character set for "' + code + '": ' + ch); - } - - parseState.resetParseFunction(); - }; -}; - -/** - * Back Index (DECBI). - * - * VT420 and up. Not currently implemented. - */ -hterm.VT.ESC['6'] = hterm.VT.ignore; - -/** - * Save Cursor (DECSC). - */ -hterm.VT.ESC['7'] = function() { - this.terminal.saveCursorAndState(); -}; - -/** - * Restore Cursor (DECRC). - */ -hterm.VT.ESC['8'] = function() { - this.terminal.restoreCursorAndState(); -}; - -/** - * Forward Index (DECFI). - * - * VT210 and up. Not currently implemented. - */ -hterm.VT.ESC['9'] = hterm.VT.ignore; - -/** - * Application keypad (DECKPAM). - */ -hterm.VT.ESC['='] = function() { - this.terminal.keyboard.applicationKeypad = true; -}; - -/** - * Normal keypad (DECKPNM). - */ -hterm.VT.ESC['>'] = function() { - this.terminal.keyboard.applicationKeypad = false; -}; - -/** - * Cursor to lower left corner of screen. - * - * Will not implement. - * - * This is only recognized by xterm when the hpLowerleftBugCompat resource is - * set. - */ -hterm.VT.ESC['F'] = hterm.VT.ignore; - -/** - * Full Reset (RIS). - */ -hterm.VT.ESC['c'] = function() { - this.terminal.reset(); -}; - -/** - * Memory lock/unlock. - * - * Will not implement. - */ -hterm.VT.ESC['l'] = -hterm.VT.ESC['m'] = hterm.VT.ignore; - -/** - * Lock Shift 2 (LS2) - * - * Invoke the G2 Character Set as GL. - */ -hterm.VT.ESC['n'] = function() { - this.GL = 'G2'; -}; - -/** - * Lock Shift 3 (LS3) - * - * Invoke the G3 Character Set as GL. - */ -hterm.VT.ESC['o'] = function() { - this.GL = 'G3'; -}; - -/** - * Lock Shift 2, Right (LS3R) - * - * Invoke the G3 Character Set as GR. - */ -hterm.VT.ESC['|'] = function() { - this.GR = 'G3'; -}; - -/** - * Lock Shift 2, Right (LS2R) - * - * Invoke the G2 Character Set as GR. - */ -hterm.VT.ESC['}'] = function() { - this.GR = 'G2'; -}; - -/** - * Lock Shift 1, Right (LS1R) - * - * Invoke the G1 Character Set as GR. - */ -hterm.VT.ESC['~'] = function() { - this.GR = 'G1'; -}; - -/** - * Change icon name and window title. - * - * We only change the window title. - */ -hterm.VT.OSC['0'] = function(parseState) { - this.terminal.setWindowTitle(parseState.args[0]); -}; - -/** - * Change window title. - */ -hterm.VT.OSC['2'] = hterm.VT.OSC['0']; - -/** - * Set/read color palette. - */ -hterm.VT.OSC['4'] = function(parseState) { - // Args come in as a single 'index1;rgb1 ... ;indexN;rgbN' string. - // We split on the semicolon and iterate through the pairs. - var args = parseState.args[0].split(';'); - - var pairCount = parseInt(args.length / 2); - var colorPalette = this.terminal.getTextAttributes().colorPalette; - var responseArray = []; - - for (var pairNumber = 0; pairNumber < pairCount; ++pairNumber) { - var colorIndex = parseInt(args[pairNumber * 2]); - var colorValue = args[pairNumber * 2 + 1]; - - if (colorIndex >= colorPalette.length) - continue; - - if (colorValue == '?') { - // '?' means we should report back the current color value. - colorValue = lib.colors.rgbToX11(colorPalette[colorIndex]); - if (colorValue) - responseArray.push(colorIndex + ';' + colorValue); - - continue; - } - - colorValue = lib.colors.x11ToCSS(colorValue); - if (colorValue) - colorPalette[colorIndex] = colorValue; - } - - if (responseArray.length) - this.terminal.io.sendString('\x1b]4;' + responseArray.join(';') + '\x07'); -}; - -/** - * Hyperlinks. - * - * The first argument is optional and colon separated: - * id= - * The second argument is the link itself. - * - * Calling with a non-blank URI starts it. A blank URI stops it. - * - * https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda - */ -hterm.VT.OSC['8'] = function(parseState) { - const args = parseState.args[0].split(';'); - let id = null; - let uri = null; - - if (args.length != 2 || args[1].length == 0) { - // Reset link. - } else { - // Pull out any colon separated parameters in the first argument. - const params = args[0].split(':'); - id = ''; - params.forEach((param) => { - const idx = param.indexOf('='); - if (idx == -1) - return; - - const key = param.slice(0, idx); - const value = param.slice(idx + 1); - switch (key) { - case 'id': - id = value; - break; - default: - // Ignore unknown keys. - break; - } - }); - - // The URI is in the second argument. - uri = args[1]; - } - - const attrs = this.terminal.getTextAttributes(); - attrs.uri = uri; - attrs.uriId = id; -}; - -/** - * iTerm2 growl notifications. - */ -hterm.VT.OSC['9'] = function(parseState) { - // This just dumps the entire string as the message. - hterm.notify({'body': parseState.args[0]}); -}; - -/** - * Change VT100 text foreground color. - */ -hterm.VT.OSC['10'] = function(parseState) { - // Args come in as a single string, but extra args will chain to the following - // OSC sequences. - var args = parseState.args[0].split(';'); - if (!args) - return; - - var colorArg; - var colorX11 = lib.colors.x11ToCSS(args.shift()); - if (colorX11) - this.terminal.setForegroundColor(colorX11); - - if (args.length > 0) { - parseState.args[0] = args.join(';'); - hterm.VT.OSC['11'].apply(this, [parseState]); - } -}; - -/** - * Change VT100 text background color. - */ -hterm.VT.OSC['11'] = function(parseState) { - // Args come in as a single string, but extra args will chain to the following - // OSC sequences. - var args = parseState.args[0].split(';'); - if (!args) - return; - - var colorArg; - var colorX11 = lib.colors.x11ToCSS(args.shift()); - if (colorX11) - this.terminal.setBackgroundColor(colorX11); - - if (args.length > 0) { - parseState.args[0] = args.join(';'); - hterm.VT.OSC['12'].apply(this, [parseState]); - } -}; - -/** - * Change text cursor color. - */ -hterm.VT.OSC['12'] = function(parseState) { - // Args come in as a single string, but extra args will chain to the following - // OSC sequences. - var args = parseState.args[0].split(';'); - if (!args) - return; - - var colorArg; - var colorX11 = lib.colors.x11ToCSS(args.shift()); - if (colorX11) - this.terminal.setCursorColor(colorX11); - - /* Note: If we support OSC 13+, we'd chain it here. - if (args.length > 0) { - parseState.args[0] = args.join(';'); - hterm.VT.OSC['13'].apply(this, [parseState]); - } - */ -}; - -/** - * Set the cursor shape. - * - * Parameter is expected to be in the form "CursorShape=number", where number is - * one of: - * - * 0 - Block - * 1 - I-Beam - * 2 - Underline - * - * This is a bit of a de-facto standard supported by iTerm 2 and Konsole. See - * also: DECSCUSR. - * - * Invalid numbers will restore the cursor to the block shape. - */ -hterm.VT.OSC['50'] = function(parseState) { - var args = parseState.args[0].match(/CursorShape=(.)/i); - if (!args) { - console.warn('Could not parse OSC 50 args: ' + parseState.args[0]); - return; - } - - switch (args[1]) { - case '1': // CursorShape=1: I-Beam. - this.terminal.setCursorShape(hterm.Terminal.cursorShape.BEAM); - break; - - case '2': // CursorShape=2: Underline. - this.terminal.setCursorShape(hterm.Terminal.cursorShape.UNDERLINE); - break; - - default: // CursorShape=0: Block. - this.terminal.setCursorShape(hterm.Terminal.cursorShape.BLOCK); - } -}; - -/** - * Set/read system clipboard. - * - * Read is not implemented due to security considerations. A remote app - * that is able to both write and read to the clipboard could essentially - * take over your session. - * - * The clipboard data will be decoded according to the 'receive-encoding' - * preference. - */ -hterm.VT.OSC['52'] = function(parseState) { - if (!this.enableClipboardWrite) - return; - - // Args come in as a single 'clipboard;b64-data' string. The clipboard - // parameter is used to select which of the X clipboards to address. Since - // we're not integrating with X, we treat them all the same. - var args = parseState.args[0].match(/^[cps01234567]*;(.*)/); - if (!args) - return; - - var data = window.atob(args[1]); - if (data) - this.terminal.copyStringToClipboard(this.decode(data)); -}; - -/** - * Reset foreground color. - */ -hterm.VT.OSC['110'] = function(parseState) { - this.terminal.setForegroundColor(); -}; - -/** - * Reset background color. - */ -hterm.VT.OSC['111'] = function(parseState) { - this.terminal.setBackgroundColor(); -}; - -/** - * Reset text cursor color. - */ -hterm.VT.OSC['112'] = function(parseState) { - this.terminal.setCursorColor(); -}; - -/** - * iTerm2 extended sequences. - * - * We only support image display atm. - */ -hterm.VT.OSC['1337'] = function(parseState) { - // Args come in as a set of key value pairs followed by data. - // File=name=;size=123;inline=1: - let args = parseState.args[0].match(/^File=([^:]*):([\s\S]*)$/m); - if (!args) { - if (this.warnUnimplemented) - console.log(`iTerm2 1337: unsupported sequence: ${args[1]}`); - return; - } - - const options = { - name: '', - size: 0, - preserveAspectRatio: true, - inline: false, - width: 'auto', - height: 'auto', - align: 'left', - uri: 'data:application/octet-stream;base64,' + args[2].replace(/[\n\r]+/gm, ''), - }; - // Walk the "key=value;" sets. - args[1].split(';').forEach((ele) => { - const kv = ele.match(/^([^=]+)=(.*)$/m); - if (!kv) - return; - - // Sanitize values nicely. - switch (kv[1]) { - case 'name': - try { - options.name = window.atob(kv[2]); - } catch (e) {} - break; - case 'size': - try { - options.size = parseInt(kv[2]); - } catch (e) {} - break; - case 'width': - options.width = kv[2]; - break; - case 'height': - options.height = kv[2]; - break; - case 'preserveAspectRatio': - options.preserveAspectRatio = !(kv[2] == '0'); - break; - case 'inline': - options.inline = !(kv[2] == '0'); - break; - // hterm-specific keys. - case 'align': - options.align = kv[2]; - break; - default: - // Ignore unknown keys. Don't want remote stuffing our JS env. - break; - } - }); - - // This is a bit of a hack. If the buffer has data following the image, we - // need to delay processing of it until after we've finished with the image. - // Otherwise while we wait for the the image to load asynchronously, the new - // text data will intermingle with the image. - if (options.inline) { - const io = this.terminal.io; - const queued = parseState.peekRemainingBuf(); - parseState.advance(queued.length); - this.terminal.displayImage(options); - io.writeUTF8(queued); - } else - this.terminal.displayImage(options); -}; - -/** - * URxvt perl modules. - * - * This is the escape system used by rxvt-unicode and its perl modules. - * Obviously we don't support perl or custom modules, so we list a few common - * ones that we find useful. - * - * Technically there is no format here, but most modules obey: - * ; - */ -hterm.VT.OSC['777'] = function(parseState) { - var ary; - var urxvtMod = parseState.args[0].split(';', 1)[0]; - - switch (urxvtMod) { - case 'notify': - // Format: - // notify;title;message - var title, message; - ary = parseState.args[0].match(/^[^;]+;([^;]*)(;([\s\S]*))?$/); - if (ary) { - title = ary[1]; - message = ary[3]; - } - hterm.notify({'title': title, 'body': message}); - break; - - default: - console.warn('Unknown urxvt module: ' + parseState.args[0]); - break; - } -}; - -/** - * Insert (blank) characters (ICH). - */ -hterm.VT.CSI['@'] = function(parseState) { - this.terminal.insertSpace(parseState.iarg(0, 1)); -}; - -/** - * Cursor Up (CUU). - */ -hterm.VT.CSI['A'] = function(parseState) { - this.terminal.cursorUp(parseState.iarg(0, 1)); -}; - -/** - * Cursor Down (CUD). - */ -hterm.VT.CSI['B'] = function(parseState) { - this.terminal.cursorDown(parseState.iarg(0, 1)); -}; - -/** - * Cursor Forward (CUF). - */ -hterm.VT.CSI['C'] = function(parseState) { - this.terminal.cursorRight(parseState.iarg(0, 1)); -}; - -/** - * Cursor Backward (CUB). - */ -hterm.VT.CSI['D'] = function(parseState) { - this.terminal.cursorLeft(parseState.iarg(0, 1)); -}; - -/** - * Cursor Next Line (CNL). - * - * This is like Cursor Down, except the cursor moves to the beginning of the - * line as well. - */ -hterm.VT.CSI['E'] = function(parseState) { - this.terminal.cursorDown(parseState.iarg(0, 1)); - this.terminal.setCursorColumn(0); -}; - -/** - * Cursor Preceding Line (CPL). - * - * This is like Cursor Up, except the cursor moves to the beginning of the - * line as well. - */ -hterm.VT.CSI['F'] = function(parseState) { - this.terminal.cursorUp(parseState.iarg(0, 1)); - this.terminal.setCursorColumn(0); -}; - -/** - * Cursor Horizontal Absolute (CHA). - * - * Xterm calls this Cursor Character Absolute. - */ -hterm.VT.CSI['G'] = function(parseState) { - this.terminal.setCursorColumn(parseState.iarg(0, 1) - 1); -}; - -/** - * Cursor Position (CUP). - */ -hterm.VT.CSI['H'] = function(parseState) { - this.terminal.setCursorPosition(parseState.iarg(0, 1) - 1, - parseState.iarg(1, 1) - 1); -}; - -/** - * Cursor Forward Tabulation (CHT). - */ -hterm.VT.CSI['I'] = function(parseState) { - var count = parseState.iarg(0, 1); - count = lib.f.clamp(count, 1, this.terminal.screenSize.width); - for (var i = 0; i < count; i++) { - this.terminal.forwardTabStop(); - } -}; - -/** - * Erase in Display (ED, DECSED). - */ -hterm.VT.CSI['J'] = -hterm.VT.CSI['?J'] = function(parseState, code) { - var arg = parseState.args[0]; - - if (!arg || arg == 0) { - this.terminal.eraseBelow(); - } else if (arg == 1) { - this.terminal.eraseAbove(); - } else if (arg == 2) { - this.terminal.clear(); - } else if (arg == 3) { - // The xterm docs say this means "Erase saved lines", but we'll just clear - // the display since killing the scrollback seems rude. - this.terminal.clear(); - } -}; - -/** - * Erase in line (EL, DECSEL). - */ -hterm.VT.CSI['K'] = -hterm.VT.CSI['?K'] = function(parseState, code) { - var arg = parseState.args[0]; - - if (!arg || arg == 0) { - this.terminal.eraseToRight(); - } else if (arg == 1) { - this.terminal.eraseToLeft(); - } else if (arg == 2) { - this.terminal.eraseLine(); - } -}; - -/** - * Insert Lines (IL). - */ -hterm.VT.CSI['L'] = function(parseState) { - this.terminal.insertLines(parseState.iarg(0, 1)); -}; - -/** - * Delete Lines (DL). - */ -hterm.VT.CSI['M'] = function(parseState) { - this.terminal.deleteLines(parseState.iarg(0, 1)); -}; - -/** - * Delete Characters (DCH). - * - * This command shifts the line contents left, starting at the cursor position. - */ -hterm.VT.CSI['P'] = function(parseState) { - this.terminal.deleteChars(parseState.iarg(0, 1)); -}; - -/** - * Scroll Up (SU). - */ -hterm.VT.CSI['S'] = function(parseState) { - this.terminal.vtScrollUp(parseState.iarg(0, 1)); -}; - -/** - * Scroll Down (SD). - * Also 'Initiate highlight mouse tracking'. Will not implement this part. - */ -hterm.VT.CSI['T'] = function(parseState) { - if (parseState.args.length <= 1) - this.terminal.vtScrollDown(parseState.iarg(0, 1)); -}; - -/** - * Reset one or more features of the title modes to the default value. - * - * ESC [ > Ps T - * - * Normally, "reset" disables the feature. It is possible to disable the - * ability to reset features by compiling a different default for the title - * modes into xterm. - * - * Ps values: - * 0 - Do not set window/icon labels using hexadecimal. - * 1 - Do not query window/icon labels using hexadecimal. - * 2 - Do not set window/icon labels using UTF-8. - * 3 - Do not query window/icon labels using UTF-8. - * - * Will not implement. - */ -hterm.VT.CSI['>T'] = hterm.VT.ignore; - -/** - * Erase Characters (ECH). - */ -hterm.VT.CSI['X'] = function(parseState) { - this.terminal.eraseToRight(parseState.iarg(0, 1)); -}; - -/** - * Cursor Backward Tabulation (CBT). - */ -hterm.VT.CSI['Z'] = function(parseState) { - var count = parseState.iarg(0, 1); - count = lib.f.clamp(count, 1, this.terminal.screenSize.width); - for (var i = 0; i < count; i++) { - this.terminal.backwardTabStop(); - } -}; - -/** - * Character Position Absolute (HPA). - * - * Same as Cursor Horizontal Absolute (CHA). - */ -hterm.VT.CSI['`'] = hterm.VT.CSI['G']; - -/** - * Character Position Relative (HPR). - */ -hterm.VT.CSI['a'] = function(parseState) { - this.terminal.setCursorColumn(this.terminal.getCursorColumn() + - parseState.iarg(0, 1)); -}; - -/** - * Repeat the preceding graphic character. - * - * Not currently implemented. - */ -hterm.VT.CSI['b'] = hterm.VT.ignore; - -/** - * Send Device Attributes (Primary DA). - * - * TODO(rginda): This is hardcoded to send back 'VT100 with Advanced Video - * Option', but it may be more correct to send a VT220 response once - * we fill out the 'Not currently implemented' parts. - */ -hterm.VT.CSI['c'] = function(parseState) { - if (!parseState.args[0] || parseState.args[0] == 0) { - this.terminal.io.sendString('\x1b[?1;2c'); - } -}; - -/** - * Send Device Attributes (Secondary DA). - * - * TODO(rginda): This is hardcoded to send back 'VT100' but it may be more - * correct to send a VT220 response once we fill out more 'Not currently - * implemented' parts. - */ -hterm.VT.CSI['>c'] = function(parseState) { - this.terminal.io.sendString('\x1b[>0;256;0c'); -}; - -/** - * Line Position Absolute (VPA). - */ -hterm.VT.CSI['d'] = function(parseState) { - this.terminal.setAbsoluteCursorRow(parseState.iarg(0, 1) - 1); -}; - -/** - * Horizontal and Vertical Position (HVP). - * - * Same as Cursor Position (CUP). - */ -hterm.VT.CSI['f'] = hterm.VT.CSI['H']; - -/** - * Tab Clear (TBC). - */ -hterm.VT.CSI['g'] = function(parseState) { - if (!parseState.args[0] || parseState.args[0] == 0) { - // Clear tab stop at cursor. - this.terminal.clearTabStopAtCursor(false); - } else if (parseState.args[0] == 3) { - // Clear all tab stops. - this.terminal.clearAllTabStops(); - } -}; - -/** - * Set Mode (SM). - */ -hterm.VT.CSI['h'] = function(parseState) { - for (var i = 0; i < parseState.args.length; i++) { - this.setANSIMode(parseState.args[i], true); - } -}; - -/** - * DEC Private Mode Set (DECSET). - */ -hterm.VT.CSI['?h'] = function(parseState) { - for (var i = 0; i < parseState.args.length; i++) { - this.setDECMode(parseState.args[i], true); - } -}; - -/** - * Media Copy (MC). - * Media Copy (MC, DEC Specific). - * - * These commands control the printer. Will not implement. - */ -hterm.VT.CSI['i'] = -hterm.VT.CSI['?i'] = hterm.VT.ignore; - -/** - * Reset Mode (RM). - */ -hterm.VT.CSI['l'] = function(parseState) { - for (var i = 0; i < parseState.args.length; i++) { - this.setANSIMode(parseState.args[i], false); - } -}; - -/** - * DEC Private Mode Reset (DECRST). - */ -hterm.VT.CSI['?l'] = function(parseState) { - for (var i = 0; i < parseState.args.length; i++) { - this.setDECMode(parseState.args[i], false); - } -}; - -/** - * Parse extended SGR 38/48 sequences. - * - * This deals with the various ISO 8613-6 forms, and with legacy xterm forms - * that are common in the wider application world. - * - * @param {hterm.VT.ParseState} parseState The current input state. - * @param {number} i The argument in parseState to start processing. - * @param {hterm.TextAttributes} attrs The current text attributes. - * @return {Object} The skipCount member defines how many arguments to skip - * (i.e. how many were processed), and the color member is the color that - * was successfully processed, or undefined if not. - */ -hterm.VT.prototype.parseSgrExtendedColors = function(parseState, i, attrs) { - let ary; - let usedSubargs; - - if (parseState.argHasSubargs(i)) { - // The ISO 8613-6 compliant form. - // e.g. 38:[color choice]:[arg1]:[arg2]:... - ary = parseState.args[i].split(':'); - ary.shift(); // Remove "38". - usedSubargs = true; - } else if (parseState.argHasSubargs(i + 1)) { - // The xterm form which isn't ISO 8613-6 compliant. Not many emulators - // support this, and others actively do not want to. We'll ignore it so - // at least the rest of the stream works correctly. e.g. 38;2:R:G:B - // We return 0 here so we only skip the "38" ... we can't be confident the - // next arg is actually supposed to be part of it vs a typo where the next - // arg is legit. - return {skipCount: 0}; - } else { - // The xterm form which isn't ISO 8613-6 compliant, but many emulators - // support, and many applications rely on. - // e.g. 38;2;R;G;B - ary = parseState.args.slice(i + 1); - usedSubargs = false; - } - - // Figure out which form to parse. - switch (parseInt(ary[0])) { - default: // Unknown. - case 0: // Implementation defined. We ignore it. - return {skipCount: 0}; - - case 1: { // Transparent color. - // Require ISO 8613-6 form. - if (!usedSubargs) - return {skipCount: 0}; - - return { - color: 'rgba(0, 0, 0, 0)', - skipCount: 0, - }; - } - - case 2: { // RGB color. - // Skip over the color space identifier, if it exists. - let start; - if (usedSubargs) { - // The ISO 8613-6 compliant form: - // 38:2::R:G:B[:...] - // The xterm form isn't ISO 8613-6 compliant. - // 38:2:R:G:B - // Since the ISO 8613-6 form requires at least 5 arguments, - // we can still support the xterm form unambiguously. - if (ary.length == 4) - start = 1; - else - start = 2; - } else { - // The legacy xterm form: 38;2;R;G;B - start = 1; - } - - // We need at least 3 args for RGB. If we don't have them, assume this - // sequence is corrupted, so don't eat anything more. - // We ignore more than 3 args on purpose since ISO 8613-6 defines some, - // and we don't care about them. - if (ary.length < start + 3) - return {skipCount: 0}; - - const r = parseState.parseInt(ary[start + 0]); - const g = parseState.parseInt(ary[start + 1]); - const b = parseState.parseInt(ary[start + 2]); - return { - color: `rgb(${r}, ${g}, ${b})`, - skipCount: usedSubargs ? 0 : 4, - }; - } - - case 3: { // CMY color. - // No need to support xterm/legacy forms as xterm doesn't support CMY. - if (!usedSubargs) - return {skipCount: 0}; - - // We need at least 4 args for CMY. If we don't have them, assume - // this sequence is corrupted. We ignore the color space identifier, - // tolerance, etc... - if (ary.length < 4) - return {skipCount: 0}; - - // TODO: See CMYK below. - const c = parseState.parseInt(ary[1]); - const m = parseState.parseInt(ary[2]); - const y = parseState.parseInt(ary[3]); - return {skipCount: 0}; - } - - case 4: { // CMYK color. - // No need to support xterm/legacy forms as xterm doesn't support CMYK. - if (!usedSubargs) - return {skipCount: 0}; - - // We need at least 5 args for CMYK. If we don't have them, assume - // this sequence is corrupted. We ignore the color space identifier, - // tolerance, etc... - if (ary.length < 5) - return {skipCount: 0}; - - // TODO: Implement this. - // Might wait until CSS4 is adopted for device-cmyk(): - // https://www.w3.org/TR/css-color-4/#cmyk-colors - // Or normalize it to RGB ourselves: - // https://www.w3.org/TR/css-color-4/#cmyk-rgb - const c = parseState.parseInt(ary[1]); - const m = parseState.parseInt(ary[2]); - const y = parseState.parseInt(ary[3]); - const k = parseState.parseInt(ary[4]); - return {skipCount: 0}; - } - - case 5: { // Color palette index. - // If we're short on args, assume this sequence is corrupted, so don't - // eat anything more. - if (ary.length < 2) - return {skipCount: 0}; - - // Support 38:5:P (ISO 8613-6) and 38;5;P (xterm/legacy). - // We also ignore extra args with 38:5:P:[...], but more for laziness. - const ret = { - skipCount: usedSubargs ? 0 : 2, - }; - const color = parseState.parseInt(ary[1]); - if (color < attrs.colorPalette.length) - ret.color = color; - return ret; - } - } -}; - -/** - * Character Attributes (SGR). - * - * Iterate through the list of arguments, applying the attribute changes based - * on the argument value... - */ -hterm.VT.CSI['m'] = function(parseState) { - var attrs = this.terminal.getTextAttributes(); - - if (!parseState.args.length) { - attrs.reset(); - return; - } - - for (var i = 0; i < parseState.args.length; i++) { - // If this argument has subargs (i.e. it has args followed by colons), - // the iarg logic will implicitly truncate that off for us. - var arg = parseState.iarg(i, 0); - - if (arg < 30) { - if (arg == 0) { // Normal (default). - attrs.reset(); - } else if (arg == 1) { // Bold. - attrs.bold = true; - } else if (arg == 2) { // Faint. - attrs.faint = true; - } else if (arg == 3) { // Italic. - attrs.italic = true; - } else if (arg == 4) { // Underline. - if (parseState.argHasSubargs(i)) { - const uarg = parseState.args[i].split(':')[1]; - if (uarg == 0) - attrs.underline = false; - else if (uarg == 1) - attrs.underline = 'solid'; - else if (uarg == 2) - attrs.underline = 'double'; - else if (uarg == 3) - attrs.underline = 'wavy'; - else if (uarg == 4) - attrs.underline = 'dotted'; - else if (uarg == 5) - attrs.underline = 'dashed'; - } else { - attrs.underline = 'solid'; - } - } else if (arg == 5) { // Blink. - attrs.blink = true; - } else if (arg == 7) { // Inverse. - attrs.inverse = true; - } else if (arg == 8) { // Invisible. - attrs.invisible = true; - } else if (arg == 9) { // Crossed out. - attrs.strikethrough = true; - } else if (arg == 21) { // Double underlined. - attrs.underline = 'double'; - } else if (arg == 22) { // Not bold & not faint. - attrs.bold = false; - attrs.faint = false; - } else if (arg == 23) { // Not italic. - attrs.italic = false; - } else if (arg == 24) { // Not underlined. - attrs.underline = false; - } else if (arg == 25) { // Not blink. - attrs.blink = false; - } else if (arg == 27) { // Steady. - attrs.inverse = false; - } else if (arg == 28) { // Visible. - attrs.invisible = false; - } else if (arg == 29) { // Not crossed out. - attrs.strikethrough = false; - } - - } else if (arg < 50) { - // Select fore/background color from bottom half of 16 color palette - // or from the 256 color palette or alternative specify color in fully - // qualified rgb(r, g, b) form. - if (arg < 38) { - attrs.foregroundSource = arg - 30; - - } else if (arg == 38) { - const result = this.parseSgrExtendedColors(parseState, i, attrs); - if (result.color !== undefined) - attrs.foregroundSource = result.color; - i += result.skipCount; - - } else if (arg == 39) { - attrs.foregroundSource = attrs.SRC_DEFAULT; - - } else if (arg < 48) { - attrs.backgroundSource = arg - 40; - - } else if (arg == 48) { - const result = this.parseSgrExtendedColors(parseState, i, attrs); - if (result.color !== undefined) - attrs.backgroundSource = result.color; - i += result.skipCount; - - } else { - attrs.backgroundSource = attrs.SRC_DEFAULT; - } - - } else if (arg == 58) { // Underline coloring. - const result = this.parseSgrExtendedColors(parseState, i, attrs); - if (result.color !== undefined) - attrs.underlineSource = result.color; - i += result.skipCount; - - } else if (arg == 59) { // Disable underline coloring. - attrs.underlineSource = attrs.SRC_DEFAULT; - - } else if (arg >= 90 && arg <= 97) { - attrs.foregroundSource = arg - 90 + 8; - - } else if (arg >= 100 && arg <= 107) { - attrs.backgroundSource = arg - 100 + 8; - } - } - - attrs.setDefaults(this.terminal.getForegroundColor(), - this.terminal.getBackgroundColor()); -}; - -// SGR calls can handle subargs. -hterm.VT.CSI['m'].supportsSubargs = true; - -/** - * Set xterm-specific keyboard modes. - * - * Will not implement. - */ -hterm.VT.CSI['>m'] = hterm.VT.ignore; - -/** - * Device Status Report (DSR, DEC Specific). - * - * 5 - Status Report. Result (OK) is CSI 0 n - * 6 - Report Cursor Position (CPR) [row;column]. Result is CSI r ; c R - */ -hterm.VT.CSI['n'] = function(parseState) { - if (parseState.args[0] == 5) { - this.terminal.io.sendString('\x1b0n'); - } else if (parseState.args[0] == 6) { - var row = this.terminal.getCursorRow() + 1; - var col = this.terminal.getCursorColumn() + 1; - this.terminal.io.sendString('\x1b[' + row + ';' + col + 'R'); - } -}; - -/** - * Disable modifiers which may be enabled via CSI['>m']. - * - * Will not implement. - */ -hterm.VT.CSI['>n'] = hterm.VT.ignore; - -/** - * Device Status Report (DSR, DEC Specific). - * - * 6 - Report Cursor Position (CPR) [row;column] as CSI ? r ; c R - * 15 - Report Printer status as CSI ? 1 0 n (ready) or - * CSI ? 1 1 n (not ready). - * 25 - Report UDK status as CSI ? 2 0 n (unlocked) or CSI ? 2 1 n (locked). - * 26 - Report Keyboard status as CSI ? 2 7 ; 1 ; 0 ; 0 n (North American). - * The last two parameters apply to VT400 & up, and denote keyboard ready - * and LK01 respectively. - * 53 - Report Locator status as CSI ? 5 3 n Locator available, if compiled-in, - * or CSI ? 5 0 n No Locator, if not. - */ -hterm.VT.CSI['?n'] = function(parseState) { - if (parseState.args[0] == 6) { - var row = this.terminal.getCursorRow() + 1; - var col = this.terminal.getCursorColumn() + 1; - this.terminal.io.sendString('\x1b[' + row + ';' + col + 'R'); - } else if (parseState.args[0] == 15) { - this.terminal.io.sendString('\x1b[?11n'); - } else if (parseState.args[0] == 25) { - this.terminal.io.sendString('\x1b[?21n'); - } else if (parseState.args[0] == 26) { - this.terminal.io.sendString('\x1b[?12;1;0;0n'); - } else if (parseState.args[0] == 53) { - this.terminal.io.sendString('\x1b[?50n'); - } -}; - -/** - * This is used by xterm to decide whether to hide the pointer cursor as the - * user types. - * - * Valid values for the parameter: - * 0 - Never hide the pointer. - * 1 - Hide if the mouse tracking mode is not enabled. - * 2 - Always hide the pointer. - * - * If no parameter is given, xterm uses the default, which is 1. - * - * Not currently implemented. - */ -hterm.VT.CSI['>p'] = hterm.VT.ignore; - -/** - * Soft terminal reset (DECSTR). - */ -hterm.VT.CSI['!p'] = function() { - this.terminal.softReset(); -}; - -/** - * Request ANSI Mode (DECRQM). - * - * Not currently implemented. - */ -hterm.VT.CSI['$p'] = hterm.VT.ignore; -hterm.VT.CSI['?$p'] = hterm.VT.ignore; - -/** - * Set conformance level (DECSCL). - * - * Not currently implemented. - */ -hterm.VT.CSI['"p'] = hterm.VT.ignore; - -/** - * Load LEDs (DECLL). - * - * Not currently implemented. Could be implemented as virtual LEDs overlaying - * the terminal if anyone cares. - */ -hterm.VT.CSI['q'] = hterm.VT.ignore; - -/** - * Set cursor style (DECSCUSR, VT520). - */ -hterm.VT.CSI[' q'] = function(parseState) { - var arg = parseState.args[0]; - - if (arg == 0 || arg == 1) { - this.terminal.setCursorShape(hterm.Terminal.cursorShape.BLOCK); - this.terminal.setCursorBlink(true); - } else if (arg == 2) { - this.terminal.setCursorShape(hterm.Terminal.cursorShape.BLOCK); - this.terminal.setCursorBlink(false); - } else if (arg == 3) { - this.terminal.setCursorShape(hterm.Terminal.cursorShape.UNDERLINE); - this.terminal.setCursorBlink(true); - } else if (arg == 4) { - this.terminal.setCursorShape(hterm.Terminal.cursorShape.UNDERLINE); - this.terminal.setCursorBlink(false); - } else if (arg == 5) { - this.terminal.setCursorShape(hterm.Terminal.cursorShape.BEAM); - this.terminal.setCursorBlink(true); - } else if (arg == 6) { - this.terminal.setCursorShape(hterm.Terminal.cursorShape.BEAM); - this.terminal.setCursorBlink(false); - } else { - console.warn('Unknown cursor style: ' + arg); - } -}; - -/** - * Select character protection attribute (DECSCA). - * - * Will not implement. - */ -hterm.VT.CSI['"q'] = hterm.VT.ignore; - -/** - * Set Scrolling Region (DECSTBM). - */ -hterm.VT.CSI['r'] = function(parseState) { - var args = parseState.args; - var scrollTop = args[0] ? parseInt(args[0], 10) -1 : null; - var scrollBottom = args[1] ? parseInt(args[1], 10) - 1 : null; - this.terminal.setVTScrollRegion(scrollTop, scrollBottom); - this.terminal.setCursorPosition(0, 0); -}; - -/** - * Restore DEC Private Mode Values. - * - * Will not implement. - */ -hterm.VT.CSI['?r'] = hterm.VT.ignore; - -/** - * Change Attributes in Rectangular Area (DECCARA) - * - * Will not implement. - */ -hterm.VT.CSI['$r'] = hterm.VT.ignore; - -/** - * Save cursor (ANSI.SYS) - */ -hterm.VT.CSI['s'] = function() { - this.terminal.saveCursorAndState(); -}; - -/** - * Save DEC Private Mode Values. - * - * Will not implement. - */ -hterm.VT.CSI['?s'] = hterm.VT.ignore; - -/** - * Window manipulation (from dtterm, as well as extensions). - * - * Will not implement. - */ -hterm.VT.CSI['t'] = hterm.VT.ignore; - -/** - * Reverse Attributes in Rectangular Area (DECRARA). - * - * Will not implement. - */ -hterm.VT.CSI['$t'] = hterm.VT.ignore; - -/** - * Set one or more features of the title modes. - * - * Will not implement. - */ -hterm.VT.CSI['>t'] = hterm.VT.ignore; - -/** - * Set warning-bell volume (DECSWBV, VT520). - * - * Will not implement. - */ -hterm.VT.CSI[' t'] = hterm.VT.ignore; - -/** - * Restore cursor (ANSI.SYS). - */ -hterm.VT.CSI['u'] = function() { - this.terminal.restoreCursorAndState(); -}; - -/** - * Set margin-bell volume (DECSMBV, VT520). - * - * Will not implement. - */ -hterm.VT.CSI[' u'] = hterm.VT.ignore; - -/** - * Copy Rectangular Area (DECCRA, VT400 and up). - * - * Will not implement. - */ -hterm.VT.CSI['$v'] = hterm.VT.ignore; - -/** - * Enable Filter Rectangle (DECEFR). - * - * Will not implement. - */ -hterm.VT.CSI['\'w'] = hterm.VT.ignore; - -/** - * Request Terminal Parameters (DECREQTPARM). - * - * Not currently implemented. - */ -hterm.VT.CSI['x'] = hterm.VT.ignore; - -/** - * Select Attribute Change Extent (DECSACE). - * - * Will not implement. - */ -hterm.VT.CSI['*x'] = hterm.VT.ignore; - -/** - * Fill Rectangular Area (DECFRA), VT420 and up. - * - * Will not implement. - */ -hterm.VT.CSI['$x'] = hterm.VT.ignore; - -/** - * vt_tiledata (as used by NAOhack and UnNetHack) - * (see https://nethackwiki.com/wiki/Vt_tiledata for more info) - * - * Implemented as far as we care (start a glyph and end a glyph). - */ -hterm.VT.CSI['z'] = function(parseState) { - if (parseState.args.length < 1) - return; - var arg = parseState.args[0]; - if (arg == 0) { - // Start a glyph (one parameter, the glyph number). - if (parseState.args.length < 2) - return; - this.terminal.getTextAttributes().tileData = parseState.args[1]; - } else if (arg == 1) { - // End a glyph. - this.terminal.getTextAttributes().tileData = null; - } -}; - -/** - * Enable Locator Reporting (DECELR). - * - * Not currently implemented. - */ -hterm.VT.CSI['\'z'] = hterm.VT.ignore; - -/** - * Erase Rectangular Area (DECERA), VT400 and up. - * - * Will not implement. - */ -hterm.VT.CSI['$z'] = hterm.VT.ignore; - -/** - * Select Locator Events (DECSLE). - * - * Not currently implemented. - */ -hterm.VT.CSI['\'{'] = hterm.VT.ignore; - -/** - * Request Locator Position (DECRQLP). - * - * Not currently implemented. - */ -hterm.VT.CSI['\'|'] = hterm.VT.ignore; - -/** - * Insert Columns (DECIC), VT420 and up. - * - * Will not implement. - */ -hterm.VT.CSI['\'}'] = hterm.VT.ignore; - -/** - * Delete P s Columns (DECDC), VT420 and up. - * - * Will not implement. - */ -hterm.VT.CSI['\'~'] = hterm.VT.ignore; -// SOURCE FILE: hterm/js/hterm_vt_character_map.js -// Copyright (c) 2012 The Chromium OS Authors. All rights reserved. -// Use of this source code is governed by a BSD-style license that can be -// found in the LICENSE file. - -'use strict'; - -lib.rtdep('lib.f'); - -/** - * Character map object. - * - * Mapping from received to display character, used depending on the active - * VT character set. - * - * GR maps are not currently supported. - * - * @param {string} description A human readable description of this map. - * @param {Object} glmap The GL mapping from input to output characters. - */ -hterm.VT.CharacterMap = function(description, glmap) { - /** - * Short description for this character set, useful for debugging. - */ - this.description = description; - - /** - * The function to call to when this map is installed in GL. - */ - this.GL = null; - - // Always keep an unmodified reference to the map. - // This allows us to sanely reset back to the original state. - this.glmapBase_ = glmap; - - // Now sync the internal state as needed. - this.sync_(); -}; - -/** - * Internal helper for resyncing internal state. - * - * Used when the mappings change. - * - * @param {Object?} opt_glmap Additional mappings to overlay on top of the - * base mapping. - */ -hterm.VT.CharacterMap.prototype.sync_ = function(opt_glmap) { - // If there are no maps, then reset the state back. - if (!this.glmapBase_ && !opt_glmap) { - this.GL = null; - delete this.glmap_; - delete this.glre_; - return; - } - - // Set the the GL mapping. If we're given a custom mapping, then create a - // new object to hold the merged map. This way we can cleanly reset back. - if (opt_glmap) - this.glmap_ = Object.assign({}, this.glmapBase_, opt_glmap); - else - this.glmap_ = this.glmapBase_; - - var glchars = Object.keys(this.glmap_).map((key) => - '\\x' + lib.f.zpad(key.charCodeAt(0).toString(16))); - this.glre_ = new RegExp('[' + glchars.join('') + ']', 'g'); - - this.GL = (str) => str.replace(this.glre_, (ch) => this.glmap_[ch]); -}; - -/** - * Reset map back to original mappings (discarding runtime updates). - * - * Specifically, any calls to setOverrides will be discarded. - */ -hterm.VT.CharacterMap.prototype.reset = function() { - // If we haven't been given a custom mapping, then there's nothing to reset. - if (this.glmap_ !== this.glmapBase_) - this.sync_(); -}; - -/** - * Merge custom changes to this map. - * - * The input map need not duplicate the existing mappings as it is merged with - * the existing base map (what was created with). Subsequent calls to this - * will throw away previous override settings. - * - * @param {Object} glmap The custom map to override existing mappings. - */ -hterm.VT.CharacterMap.prototype.setOverrides = function(glmap) { - this.sync_(glmap); -}; - -/** - * Return a copy of this mapping. - * - * @return {hterm.VT.CharacterMap} A new hterm.VT.CharacterMap instance. - */ -hterm.VT.CharacterMap.prototype.clone = function() { - var map = new hterm.VT.CharacterMap(this.description, this.glmapBase_); - if (this.glmap_ !== this.glmapBase_) - map.setOverrides(this.glmap_); - return map; -}; - -/** - * Table of character maps. - */ -hterm.VT.CharacterMaps = function() { - this.maps_ = hterm.VT.CharacterMaps.DefaultMaps; - - // Always keep an unmodified reference to the map. - // This allows us to sanely reset back to the original state. - this.mapsBase_ = this.maps_; -}; - -/** - * Look up a previously registered map. - * - * @param {String} name The name of the map to lookup. - * @return {hterm.VT.CharacterMap} The map, if it's been registered. - */ -hterm.VT.CharacterMaps.prototype.getMap = function(name) { - if (this.maps_.hasOwnProperty(name)) - return this.maps_[name]; - else - return undefined; -}; - -/** - * Register a new map. - * - * Any previously registered maps by this name will be discarded. - * - * @param {String} name The name of the map. - * @param {hterm.VT.CharacterMap} map The map to register. - */ -hterm.VT.CharacterMaps.prototype.addMap = function(name, map) { - if (this.maps_ === this.mapsBase_) - this.maps_ = Object.assign({}, this.mapsBase_); - this.maps_[name] = map; -}; - -/** - * Reset the table and all its maps back to original state. - */ -hterm.VT.CharacterMaps.prototype.reset = function() { - if (this.maps_ !== hterm.VT.CharacterMaps.DefaultMaps) - this.maps_ = hterm.VT.CharacterMaps.DefaultMaps; -}; - -/** - * Merge custom changes to this table. - * - * @param {Object} maps A set of hterm.VT.CharacterMap objects. - */ -hterm.VT.CharacterMaps.prototype.setOverrides = function(maps) { - if (this.maps_ === this.mapsBase_) - this.maps_ = Object.assign({}, this.mapsBase_); - - for (var name in maps) { - var map = this.getMap(name); - if (map !== undefined) { - this.maps_[name] = map.clone(); - this.maps_[name].setOverrides(maps[name]); - } else - this.addMap(name, new hterm.VT.CharacterMap('user ' + name, maps[name])); - } -}; - -/** - * The default set of supported character maps. - */ -hterm.VT.CharacterMaps.DefaultMaps = {}; - -/** - * VT100 Graphic character map. - * http://vt100.net/docs/vt220-rm/table2-4.html - */ -hterm.VT.CharacterMaps.DefaultMaps['0'] = new hterm.VT.CharacterMap( - 'graphic', { - '\x60':'\u25c6', // ` -> diamond - '\x61':'\u2592', // a -> grey-box - '\x62':'\u2409', // b -> h/t - '\x63':'\u240c', // c -> f/f - '\x64':'\u240d', // d -> c/r - '\x65':'\u240a', // e -> l/f - '\x66':'\u00b0', // f -> degree - '\x67':'\u00b1', // g -> +/- - '\x68':'\u2424', // h -> n/l - '\x69':'\u240b', // i -> v/t - '\x6a':'\u2518', // j -> bottom-right - '\x6b':'\u2510', // k -> top-right - '\x6c':'\u250c', // l -> top-left - '\x6d':'\u2514', // m -> bottom-left - '\x6e':'\u253c', // n -> line-cross - '\x6f':'\u23ba', // o -> scan1 - '\x70':'\u23bb', // p -> scan3 - '\x71':'\u2500', // q -> scan5 - '\x72':'\u23bc', // r -> scan7 - '\x73':'\u23bd', // s -> scan9 - '\x74':'\u251c', // t -> left-tee - '\x75':'\u2524', // u -> right-tee - '\x76':'\u2534', // v -> bottom-tee - '\x77':'\u252c', // w -> top-tee - '\x78':'\u2502', // x -> vertical-line - '\x79':'\u2264', // y -> less-equal - '\x7a':'\u2265', // z -> greater-equal - '\x7b':'\u03c0', // { -> pi - '\x7c':'\u2260', // | -> not-equal - '\x7d':'\u00a3', // } -> british-pound - '\x7e':'\u00b7', // ~ -> dot - }); - -/** - * British character map. - * http://vt100.net/docs/vt220-rm/table2-5.html - */ -hterm.VT.CharacterMaps.DefaultMaps['A'] = new hterm.VT.CharacterMap( - 'british', { - '\x23': '\u00a3', // # -> british-pound - }); - -/** - * US ASCII map, no changes. - */ -hterm.VT.CharacterMaps.DefaultMaps['B'] = new hterm.VT.CharacterMap( - 'us', null); - -/** - * Dutch character map. - * http://vt100.net/docs/vt220-rm/table2-6.html - */ -hterm.VT.CharacterMaps.DefaultMaps['4'] = new hterm.VT.CharacterMap( - 'dutch', { - '\x23': '\u00a3', // # -> british-pound - - '\x40': '\u00be', // @ -> 3/4 - - '\x5b': '\u0132', // [ -> 'ij' ligature (xterm goes with \u00ff?) - '\x5c': '\u00bd', // \ -> 1/2 - '\x5d': '\u007c', // ] -> vertical bar - - '\x7b': '\u00a8', // { -> two dots - '\x7c': '\u0066', // | -> f - '\x7d': '\u00bc', // } -> 1/4 - '\x7e': '\u00b4', // ~ -> acute - }); - -/** - * Finnish character map. - * http://vt100.net/docs/vt220-rm/table2-7.html - */ -hterm.VT.CharacterMaps.DefaultMaps['C'] = -hterm.VT.CharacterMaps.DefaultMaps['5'] = new hterm.VT.CharacterMap( - 'finnish', { - '\x5b': '\u00c4', // [ -> 'A' umlaut - '\x5c': '\u00d6', // \ -> 'O' umlaut - '\x5d': '\u00c5', // ] -> 'A' ring - '\x5e': '\u00dc', // ~ -> 'u' umlaut - - '\x60': '\u00e9', // ` -> 'e' acute - - '\x7b': '\u00e4', // { -> 'a' umlaut - '\x7c': '\u00f6', // | -> 'o' umlaut - '\x7d': '\u00e5', // } -> 'a' ring - '\x7e': '\u00fc', // ~ -> 'u' umlaut - }); - -/** - * French character map. - * http://vt100.net/docs/vt220-rm/table2-8.html - */ -hterm.VT.CharacterMaps.DefaultMaps['R'] = new hterm.VT.CharacterMap( - 'french', { - '\x23': '\u00a3', // # -> british-pound - - '\x40': '\u00e0', // @ -> 'a' grave - - '\x5b': '\u00b0', // [ -> ring - '\x5c': '\u00e7', // \ -> 'c' cedilla - '\x5d': '\u00a7', // ] -> section symbol (double s) - - '\x7b': '\u00e9', // { -> 'e' acute - '\x7c': '\u00f9', // | -> 'u' grave - '\x7d': '\u00e8', // } -> 'e' grave - '\x7e': '\u00a8', // ~ -> umlaut - }); - -/** - * French Canadian character map. - * http://vt100.net/docs/vt220-rm/table2-9.html - */ -hterm.VT.CharacterMaps.DefaultMaps['Q'] = new hterm.VT.CharacterMap( - 'french canadian', { - '\x40': '\u00e0', // @ -> 'a' grave - - '\x5b': '\u00e2', // [ -> 'a' circumflex - '\x5c': '\u00e7', // \ -> 'c' cedilla - '\x5d': '\u00ea', // ] -> 'e' circumflex - '\x5e': '\u00ee', // ^ -> 'i' circumflex - - '\x60': '\u00f4', // ` -> 'o' circumflex - - '\x7b': '\u00e9', // { -> 'e' acute - '\x7c': '\u00f9', // | -> 'u' grave - '\x7d': '\u00e8', // } -> 'e' grave - '\x7e': '\u00fb', // ~ -> 'u' circumflex - }); - -/** - * German character map. - * http://vt100.net/docs/vt220-rm/table2-10.html - */ -hterm.VT.CharacterMaps.DefaultMaps['K'] = new hterm.VT.CharacterMap( - 'german', { - '\x40': '\u00a7', // @ -> section symbol (double s) - - '\x5b': '\u00c4', // [ -> 'A' umlaut - '\x5c': '\u00d6', // \ -> 'O' umlaut - '\x5d': '\u00dc', // ] -> 'U' umlaut - - '\x7b': '\u00e4', // { -> 'a' umlaut - '\x7c': '\u00f6', // | -> 'o' umlaut - '\x7d': '\u00fc', // } -> 'u' umlaut - '\x7e': '\u00df', // ~ -> eszett - }); - -/** - * Italian character map. - * http://vt100.net/docs/vt220-rm/table2-11.html - */ -hterm.VT.CharacterMaps.DefaultMaps['Y'] = new hterm.VT.CharacterMap( - 'italian', { - '\x23': '\u00a3', // # -> british-pound - - '\x40': '\u00a7', // @ -> section symbol (double s) - - '\x5b': '\u00b0', // [ -> ring - '\x5c': '\u00e7', // \ -> 'c' cedilla - '\x5d': '\u00e9', // ] -> 'e' acute - - '\x60': '\u00f9', // ` -> 'u' grave - - '\x7b': '\u00e0', // { -> 'a' grave - '\x7c': '\u00f2', // | -> 'o' grave - '\x7d': '\u00e8', // } -> 'e' grave - '\x7e': '\u00ec', // ~ -> 'i' grave - }); - -/** - * Norwegian/Danish character map. - * http://vt100.net/docs/vt220-rm/table2-12.html - */ -hterm.VT.CharacterMaps.DefaultMaps['E'] = -hterm.VT.CharacterMaps.DefaultMaps['6'] = new hterm.VT.CharacterMap( - 'norwegian/danish', { - '\x40': '\u00c4', // @ -> 'A' umlaut - - '\x5b': '\u00c6', // [ -> 'AE' ligature - '\x5c': '\u00d8', // \ -> 'O' stroke - '\x5d': '\u00c5', // ] -> 'A' ring - '\x5e': '\u00dc', // ^ -> 'U' umlaut - - '\x60': '\u00e4', // ` -> 'a' umlaut - - '\x7b': '\u00e6', // { -> 'ae' ligature - '\x7c': '\u00f8', // | -> 'o' stroke - '\x7d': '\u00e5', // } -> 'a' ring - '\x7e': '\u00fc', // ~ -> 'u' umlaut - }); - -/** - * Spanish character map. - * http://vt100.net/docs/vt220-rm/table2-13.html - */ -hterm.VT.CharacterMaps.DefaultMaps['Z'] = new hterm.VT.CharacterMap( - 'spanish', { - '\x23': '\u00a3', // # -> british-pound - - '\x40': '\u00a7', // @ -> section symbol (double s) - - '\x5b': '\u00a1', // [ -> '!' inverted - '\x5c': '\u00d1', // \ -> 'N' tilde - '\x5d': '\u00bf', // ] -> '?' inverted - - '\x7b': '\u00b0', // { -> ring - '\x7c': '\u00f1', // | -> 'n' tilde - '\x7d': '\u00e7', // } -> 'c' cedilla - }); - -/** - * Swedish character map. - * http://vt100.net/docs/vt220-rm/table2-14.html - */ -hterm.VT.CharacterMaps.DefaultMaps['7'] = -hterm.VT.CharacterMaps.DefaultMaps['H'] = new hterm.VT.CharacterMap( - 'swedish', { - '\x40': '\u00c9', // @ -> 'E' acute - - '\x5b': '\u00c4', // [ -> 'A' umlaut - '\x5c': '\u00d6', // \ -> 'O' umlaut - '\x5d': '\u00c5', // ] -> 'A' ring - '\x5e': '\u00dc', // ^ -> 'U' umlaut - - '\x60': '\u00e9', // ` -> 'e' acute - - '\x7b': '\u00e4', // { -> 'a' umlaut - '\x7c': '\u00f6', // | -> 'o' umlaut - '\x7d': '\u00e5', // } -> 'a' ring - '\x7e': '\u00fc', // ~ -> 'u' umlaut - }); - -/** - * Swiss character map. - * http://vt100.net/docs/vt220-rm/table2-15.html - */ -hterm.VT.CharacterMaps.DefaultMaps['='] = new hterm.VT.CharacterMap( - 'swiss', { - '\x23': '\u00f9', // # -> 'u' grave - - '\x40': '\u00e0', // @ -> 'a' grave - - '\x5b': '\u00e9', // [ -> 'e' acute - '\x5c': '\u00e7', // \ -> 'c' cedilla - '\x5d': '\u00ea', // ] -> 'e' circumflex - '\x5e': '\u00ee', // ^ -> 'i' circumflex - '\x5f': '\u00e8', // _ -> 'e' grave - - '\x60': '\u00f4', // ` -> 'o' circumflex - - '\x7b': '\u00e4', // { -> 'a' umlaut - '\x7c': '\u00f6', // | -> 'o' umlaut - '\x7d': '\u00fc', // } -> 'u' umlaut - '\x7e': '\u00fb', // ~ -> 'u' circumflex - }); -lib.resource.add('hterm/audio/bell', 'audio/ogg;base64', -'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' + -'zinmkFLKMeUcUko5p5xTzjkIHYTKMQadgxAppRxTzinHHITMQeWcg9BBKAAAIMABACDAQig0ZEUA' + -'ECcA4HAkz5M0SxQlSxNFzxRl1xNN15U0zTQ1UVRVyxNV1VRV2xZNVbYlTRNNTfRUVRNFVRVV05ZN' + -'VbVtzzRl2VRV3RZV1bZl2xZ+V5Z13zNNWRZV1dZNVbV115Z9X9ZtXZg0zTQ1UVRVTRRV1VRV2zZV' + -'17Y1UXRVUVVlWVRVWXZlWfdVV9Z9SxRV1VNN2RVVVbZV2fVtVZZ94XRVXVdl2fdVWRZ+W9eF4fZ9' + -'4RhV1dZN19V1VZZ9YdZlYbd13yhpmmlqoqiqmiiqqqmqtm2qrq1bouiqoqrKsmeqrqzKsq+rrmzr' + -'miiqrqiqsiyqqiyrsqz7qizrtqiquq3KsrCbrqvrtu8LwyzrunCqrq6rsuz7qizruq3rxnHrujB8' + -'pinLpqvquqm6um7runHMtm0co6rqvirLwrDKsu/rui+0dSFRVXXdlF3jV2VZ921fd55b94WybTu/' + -'rfvKceu60vg5z28cubZtHLNuG7+t+8bzKz9hOI6lZ5q2baqqrZuqq+uybivDrOtCUVV9XZVl3zdd' + -'WRdu3zeOW9eNoqrquirLvrDKsjHcxm8cuzAcXds2jlvXnbKtC31jyPcJz2vbxnH7OuP2daOvDAnH' + -'jwAAgAEHAIAAE8pAoSErAoA4AQAGIecUUxAqxSB0EFLqIKRUMQYhc05KxRyUUEpqIZTUKsYgVI5J' + -'yJyTEkpoKZTSUgehpVBKa6GU1lJrsabUYu0gpBZKaS2U0lpqqcbUWowRYxAy56RkzkkJpbQWSmkt' + -'c05K56CkDkJKpaQUS0otVsxJyaCj0kFIqaQSU0mptVBKa6WkFktKMbYUW24x1hxKaS2kEltJKcYU' + -'U20txpojxiBkzknJnJMSSmktlNJa5ZiUDkJKmYOSSkqtlZJSzJyT0kFIqYOOSkkptpJKTKGU1kpK' + -'sYVSWmwx1pxSbDWU0lpJKcaSSmwtxlpbTLV1EFoLpbQWSmmttVZraq3GUEprJaUYS0qxtRZrbjHm' + -'GkppraQSW0mpxRZbji3GmlNrNabWam4x5hpbbT3WmnNKrdbUUo0txppjbb3VmnvvIKQWSmktlNJi' + -'ai3G1mKtoZTWSiqxlZJabDHm2lqMOZTSYkmpxZJSjC3GmltsuaaWamwx5ppSi7Xm2nNsNfbUWqwt' + -'xppTS7XWWnOPufVWAADAgAMAQIAJZaDQkJUAQBQAAEGIUs5JaRByzDkqCULMOSepckxCKSlVzEEI' + -'JbXOOSkpxdY5CCWlFksqLcVWaykptRZrLQAAoMABACDABk2JxQEKDVkJAEQBACDGIMQYhAYZpRiD' + -'0BikFGMQIqUYc05KpRRjzknJGHMOQioZY85BKCmEUEoqKYUQSkklpQIAAAocAAACbNCUWByg0JAV' + -'AUAUAABgDGIMMYYgdFQyKhGETEonqYEQWgutddZSa6XFzFpqrbTYQAithdYySyXG1FpmrcSYWisA' + -'AOzAAQDswEIoNGQlAJAHAEAYoxRjzjlnEGLMOegcNAgx5hyEDirGnIMOQggVY85BCCGEzDkIIYQQ' + -'QuYchBBCCKGDEEIIpZTSQQghhFJK6SCEEEIppXQQQgihlFIKAAAqcAAACLBRZHOCkaBCQ1YCAHkA' + -'AIAxSjkHoZRGKcYglJJSoxRjEEpJqXIMQikpxVY5B6GUlFrsIJTSWmw1dhBKaS3GWkNKrcVYa64h' + -'pdZirDXX1FqMteaaa0otxlprzbkAANwFBwCwAxtFNicYCSo0ZCUAkAcAgCCkFGOMMYYUYoox55xD' + -'CCnFmHPOKaYYc84555RijDnnnHOMMeecc845xphzzjnnHHPOOeecc44555xzzjnnnHPOOeecc845' + -'55xzzgkAACpwAAAIsFFkc4KRoEJDVgIAqQAAABFWYowxxhgbCDHGGGOMMUYSYowxxhhjbDHGGGOM' + -'McaYYowxxhhjjDHGGGOMMcYYY4wxxhhjjDHGGGOMMcYYY4wxxhhjjDHGGGOMMcYYY4wxxhhjjDHG' + -'GFtrrbXWWmuttdZaa6211lprrQBAvwoHAP8HG1ZHOCkaCyw0ZCUAEA4AABjDmHOOOQYdhIYp6KSE' + -'DkIIoUNKOSglhFBKKSlzTkpKpaSUWkqZc1JSKiWlllLqIKTUWkottdZaByWl1lJqrbXWOgiltNRa' + -'a6212EFIKaXWWostxlBKSq212GKMNYZSUmqtxdhirDGk0lJsLcYYY6yhlNZaazHGGGstKbXWYoy1' + -'xlprSam11mKLNdZaCwDgbnAAgEiwcYaVpLPC0eBCQ1YCACEBAARCjDnnnHMQQgghUoox56CDEEII' + -'IURKMeYcdBBCCCGEjDHnoIMQQgghhJAx5hx0EEIIIYQQOucchBBCCKGEUkrnHHQQQgghlFBC6SCE' + -'EEIIoYRSSikdhBBCKKGEUkopJYQQQgmllFJKKaWEEEIIoYQSSimllBBCCKWUUkoppZQSQgghlFJK' + -'KaWUUkIIoZRQSimllFJKCCGEUkoppZRSSgkhhFBKKaWUUkopIYQSSimllFJKKaUAAIADBwCAACPo' + -'JKPKImw04cIDUGjISgCADAAAcdhq6ynWyCDFnISWS4SQchBiLhFSijlHsWVIGcUY1ZQxpRRTUmvo' + -'nGKMUU+dY0oxw6yUVkookYLScqy1dswBAAAgCAAwECEzgUABFBjIAIADhAQpAKCwwNAxXAQE5BIy' + -'CgwKx4Rz0mkDABCEyAyRiFgMEhOqgaJiOgBYXGDIB4AMjY20iwvoMsAFXdx1IIQgBCGIxQEUkICD' + -'E2544g1PuMEJOkWlDgIAAAAA4AAAHgAAkg0gIiKaOY4Ojw+QEJERkhKTE5QAAAAAALABgA8AgCQF' + -'iIiIZo6jw+MDJERkhKTE5AQlAAAAAAAAAAAACAgIAAAAAAAEAAAACAhPZ2dTAAQYOwAAAAAAAOGp' + -'bkoCAAAAmc74DRgyNjM69TAzOTk74dnLubewsbagmZiNp4d0KbsExSY/I3XUTwJgkeZdn1HY4zoj' + -'33/q9DFtv3Ui1/jmx7lCUtPt18/sYf9MkgAsAGRBd3gMGP4sU+qCPYBy9VrA3YqJosW3W2/ef1iO' + -'/u3cg8ZG/57jU+pPmbGEJUgkfnaI39DbPqxddZphbMRmCc5rKlkUMkyx8iIoug5dJv1OYH9a59c+' + -'3Gevqc7Z2XFdDjL/qHztRfjWEWxJ/aiGezjohu9HsCZdQBKbiH0VtU/3m85lDG2T/+xkZcYnX+E+' + -'aqzv/xTgOoTFG+x7SNqQ4N+oAABSxuVXw77Jd5bmmTmuJakX7509HH0kGYKvARPpwfOSAPySPAc2' + -'EkneDwB2HwAAJlQDYK5586N79GJCjx4+p6aDUd27XSvRyXLJkIC5YZ1jLv5lpOhZTz0s+DmnF1di' + -'ptrnM6UDgIW11Xh8cHTd0/SmbgOAdxcyWwMAAGIrZ3fNSfZbzKiYrK4+tPqtnMVLOeWOG2kVvUY+' + -'p2PJ/hkCl5aFRO4TLGYPZcIU3vYM1hohS4jHFlnyW/2T5J7kGsShXWT8N05V+3C/GPqJ1QdWisGP' + -'xEzHqXISBPIinWDUt7IeJv/f5OtzBxpTzZZQ+CYEhHXfqG4aABQli72GJhN4oJv+hXcApAJSErAW' + -'8G2raAX4NUcABnVt77CzZAB+LsHcVe+Q4h+QB1wh/ZrJTPxSBdI8mgTeAdTsQOoFUEng9BHcVPhx' + -'SRRYkKWZJXOFYP6V4AEripJoEjXgA2wJRZHSExmJDm8F0A6gEXsg5a4ZsALItrMB7+fh7UKLvYWS' + -'dtsDwFf1mzYzS1F82N1h2Oyt2e76B1QdS0SAsQigLPMOgJS9JRC7hFXA6kUsLFNKD5cA5cTRvgSq' + -'Pc3Fl99xW3QTi/MHR8DEm6WnvaVQATwRqRKjywQ9BrrhugR2AKTsPQeQckrAOgDOhbTESyrXQ50C' + -'kNpXdtWjW7W2/3UjeX3U95gIdalfRAoAmqUEiwp53hCdcCwlg47fcbfzlmQMAgaBkh7c+fcDgF+i' + -'fwDXfzegLPcLYJsAAJQArTXjnh/uXGy3v1Hk3pV6/3t5ruW81f6prfbM2Q3WNVy98BwUtbCwhFhA' + -'WuPev6Oe/4ZaFQUcgKrVs4defzh1TADA1DEh5b3VlDaECw5b+bPfkKos3tIAue3vJZOih3ga3l6O' + -'3PSfIkrLv0PAS86PPdL7g8oc2KteNFKKzKRehOv2gJoFLBPXmaXvPBQILgJon0bbWBszrYZYYwE7' + -'jl2j+vTdU7Vpk21LiU0QajPkywAAHqbUC0/YsYOdb4e6BOp7E0cCi04Ao/TgD8ZVAMid6h/A8IeB' + -'Nkp6/xsAACZELEYIk+yvI6Qz1NN6lIftB/6IMWjWJNOqPTMedAmyaj6Es0QBklJpiSWWHnQ2CoYb' + -'GWAmt+0gLQBFKCBnp2QUUQZ/1thtZDBJUpFWY82z34ocorB62oX7qB5y0oPAv/foxH25wVmgIHf2' + -'xFOr8leZcBq1Kx3ZvCq9Bga639AxuHuPNL/71YCF4EywJpqHFAX6XF0sjVbuANnvvdLcrufYwOM/' + -'iDa6iA468AYAAB6mNBMXcgTD8HSRqJ4vw8CjAlCEPACASlX/APwPOJKl9xQAAAPmnev2eWp33Xgy' + -'w3Dvfz6myGk3oyP8YTKsCOvzAgALQi0o1c6Nzs2O2Pg2h4ACIJAgAGP0aNn5x0BDgVfH7u2TtyfD' + -'cRIuYAyQhBF/lvSRAttgA6TPbWZA9gaUrZWAUEAA+Dx47Q3/r87HxUUqZmB0BmUuMlojFjHt1gDu' + -'nnvuX8MImsjSq5WkzSzGS62OEIlOufWWezxWpv6FBgDgJVltfXFYtNAAnqU0xQoD0YLiXo5cF5QV' + -'4CnY1tBLAkZCOABAhbk/AM+/AwSCCdlWAAAMcFjS7owb8GVDzveDiZvznbt2tF4bL5odN1YKl88T' + -'AEABCZvufq9YCTBtMwVAQUEAwGtNltzSaHvADYC3TxLVjqiRA+OZAMhzcqEgRcAOwoCgvdTxsTHL' + -'QEF6+oOb2+PAI8ciPQcXg7pOY+LjxQSv2fjmFuj34gGwz310/bGK6z3xgT887eomWULEaDd04wHe' + -'tYxdjcgV2SxvSwn0VoZXJRqkRC5ASQ/muVoAUsX7AgAQMBNaVwAAlABRxT/1PmfqLqSRNDbhXb07' + -'berpB3b94jpuWEZjBCD2OcdXFpCKEgCDfcFPMw8AAADUwT4lnUm50lmwrpMMhPQIKj6u0E8fr2vG' + -'BngMNdIlrZsigjahljud6AFVg+tzXwUnXL3TJLpajaWKA4VAAAAMiFfqJgKAZ08XrtS3dxtQNYcp' + -'PvYEG8ClvrQRJgBephwnNWJjtGqmp6VEPSvBe7EBiU3qgJbQAwD4Le8LAMDMhHbNAAAlgK+tFs5O' + -'+YyJc9yCnJa3rxLPulGnxwsXV9Fsk2k4PisCAHC8FkwbGE9gJQAAoMnyksj0CdFMZLLgoz8M+Fxz' + -'iwYBgIx+zHiCBAKAlBKNpF1sO9JpVcyEi9ar15YlHgrut5fPJnkdJ6vEwZPyAHQBIEDUrlMcBAAd' + -'2KAS0Qq+JwRsE4AJZtMnAD6GnOYwYlOIZvtzUNdjreB7fiMkWI0CmBB6AIAKc38A9osEFlTSGECB' + -'+cbeRDC0aRpLHqNPplcK/76Lxn2rpmqyXsYJWRi/FQAAAKBQk9MCAOibrQBQADCDsqpooPutd+05' + -'Ce9g6iEdiYXgVmQAI4+4wskEBEiBloNQ6Ki0/KTQ0QjWfjxzi+AeuXKoMjEVfQOZzr0y941qLgM2' + -'AExvbZOqcxZ6J6krlrj4y2j9AdgKDx6GnJsVLhbc42uq584+ouSdNBpoCiCVHrz+WzUA/DDtD8AT' + -'gA3h0lMCAAzcFv+S+fSSNkeYWlTpb34mf2RfmqqJeMeklhHAfu7VoAEACgAApKRktL+KkQDWMwYC' + -'UAAAAHCKsp80xhp91UjqQBw3x45cetqkjQEyu3G9B6N+R650Uq8OVig7wOm6Wun0ea4lKDPoabJs' + -'6aLqgbhPzpv4KR4iODilw88ZpY7q1IOMcbASAOAVtmcCnobcrkG4KGS7/ZnskVWRNF9J0RUHKOnB' + -'yy9WA8Dv6L4AAARMCQUA4GritfVM2lcZfH3Q3T/vZ47J2YHhcmBazjfdyuV25gLAzrc0cwAAAAAY' + -'Ch6PdwAAAGyWjFW4yScjaWa2mGcofHxWxewKALglWBpLUvwwk+UOh5eNGyUOs1/EF+pZr+ud5Ozo' + -'GwYdAABg2p52LiSgAY/ZVlOmilEgHn6G3OcwYjzI7vOj1t6xsx4S3lBY96EUQBF6AIBAmPYH4PoG' + -'YCoJAADWe+OZJZi7/x76/yH7Lzf9M5XzRKnFPmveMsilQHwVAAAAAKB3LQD8PCIAAADga0QujBLy' + -'wzeJ4a6Z/ERVBAUlAEDqvoM7BQBAuAguzFqILtmjH3Kd4wfKobnOhA3z85qWoRPm9hwoOHoDAAlC' + -'bwDAA56FHAuXflHo3fe2ttG9XUDeA9YmYCBQ0oPr/1QC8IvuCwAAApbUAQCK22MmE3O78VAbHQT9' + -'PIPNoT9zNc3l2Oe7TAVLANBufT8MAQAAAGzT4PS8AQAAoELGHb2uaCwwEv1EWhFriUkbAaAZ27/f' + -'VZnTZXbWz3BwWpjUaMZKRj7dZ0J//gUeTdpVEwAAZOFsNxKAjQSgA+ABPoY8Jj5y2wje81jsXc/1' + -'TOQWTDYZBmAkNDiqVwuA2NJ9AQAAEBKAt9Vrsfs/2N19MO91S9rd8EHTZHnzC5MYmfQEACy/FBcA' + -'AADA5c4gi4z8RANs/m6FNXVo9DV46JG1BBDukqlw/Va5G7QbuGVSI+2aZaoLXJrdVj2zlC9Z5QEA' + -'EFz/5QzgVZwAAAAA/oXcxyC6WfTu+09Ve/c766J4VTAGUFmA51+VANKi/QPoPwYgYAkA715OH4S0' + -'s5KDHvj99MMq8TPFc3roKZnGOoT1bmIhVgc7XAMBAAAAAMAW1VbQw3gapzOpJd+Kd2fc4iSO62fJ' + -'v9+movui1wUNPAj059N3OVxzk4gV73PmE8FIA2F5mRq37Evc76vLXfF4rD5UJJAw46hW6LZCb5sN' + -'Ldx+kzMCAAB+hfy95+965ZCLP7B3/VlTHCvDEKtQhTm4KiCgAEAbrfbWTPssAAAAXpee1tVrozYY' + -'n41wD1aeYtkKfswN5/SXPO0JDnhO/4laUortv/s412fybe/nONdncoCHnBVliu0CQGBWlPY/5Kwo' + -'m2L/kruPM6Q7oz4tvDQy+bZ3HzOi+gNHA4DZEgA=' -); - -lib.resource.add('hterm/images/icon-96', 'image/png;base64', -'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' + -'ODoyNC0wNDowMNba8BsAAAAASUVORK5CYII=' -); - -lib.resource.add('hterm/concat/date', 'text/plain', -'Sun, 11 Mar 2018 12:57:13 +0000' -); - -lib.resource.add('hterm/changelog/version', 'text/plain', -'1.78' -); - -lib.resource.add('hterm/changelog/date', 'text/plain', -'2018-01-29' -); - -lib.resource.add('hterm/git/HEAD', 'text/plain', -'7a7207d729703081e78404427ff929703800f703' -); - - diff --git a/assets/shell.js b/assets/shell.js index 2aa6cc7..2786790 100644 --- a/assets/shell.js +++ b/assets/shell.js @@ -5,94 +5,52 @@ $(document).ready(() => { if ($shell.length < 1) { return; } - let $close = $(".shell-close"); + let $close = $("#shell-close"); - let closeTimeout = null; + Terminal.applyAddon(attach); + Terminal.applyAddon(fit); - // excerpt from wetty + let term = new Terminal(); + let ws = new WebSocket("ws" + (window.location.protocol === "https:" ? "s" : "") + "://" + window.location.host + "/websocket?path=" + encodeURIComponent($shell.data("path"))); + term.attach(ws, true, true); + term.open($shell[0]); - let socket = io("?path=" + encodeURIComponent($shell.data("path"))); - let term = null; - let buf = ""; + ws.addEventListener("open", () => { - function Wetty(argv) { - this.argv_ = argv; - this.io = null; - this.pid_ = -1; - } - Wetty.prototype.run = function () { - this.io = this.argv_.io.push(); - - this.io.onVTKeystroke = this.sendString_.bind(this); - this.io.sendString = this.sendString_.bind(this); - this.io.onTerminalResize = this.onTerminalResize.bind(this); - }; - Wetty.prototype.sendString_ = function (str) { - socket.emit("input", str); - - // cancel close timeout - if (closeTimeout != null) { - clearTimeout(closeTimeout); - term.io.writeUTF16("\r\nkeyboard input detected. timeout canceled"); - closeTimeout = null; - } - }; - Wetty.prototype.onTerminalResize = function (col, row) { - socket.emit("resize", { col: col, row: row }); - }; - - socket.on("connect", () => { - console.log("socket.io connection established"); - lib.init(() => { - hterm.defaultStorage = new lib.Storage.Local(); - term = new hterm.Terminal(); - window.term = term; - term.decorate(document.getElementById("shell")); - // force custom size - $shell.find("iframe").css("height", "calc(100% - 56px * 2)"); - - term.setCursorPosition(0, 0); - term.setCursorVisible(true); - term.prefs_.set("ctrl-c-copy", true); - term.prefs_.set("ctrl-v-paste", true); - term.prefs_.set("use-default-window-copy", true); - - term.runCommandClass(Wetty); - socket.emit("resize", { - col: term.screenSize.width, - row: term.screenSize.height, - }); - - if (buf && buf != "") { - term.io.writeUTF16(buf); - buf = ""; - } - }); - }); - - socket.on("output", (data) => { - if (!term) { - buf += data; - return; - } - term.io.writeUTF16(data); - }); - - socket.on("disconnect", () => { - console.log("socket.io connection closed"); - }); - - // end excerpt from wetty - - socket.on("disconnect", () => { - term.io.writeUTF16("\r\n\r\nclosing shell in 2 seconds..."); - closeTimeout = setTimeout(() => { - window.location.pathname = window.location.pathname.replace("@shell", ""); - }, 2000); - }); - - $close.click(() => { - socket.disconnect(); - }); + // resize + term.on("resize", ({ cols, rows }) => { + console.log(cols, rows); + const buf = Uint16Array.of(0, cols, rows); + ws.send(buf); + }); + $(window).on("resize", () => { + term.fit(); + }); + term.fit(); + // close + let closeTimeout = null; + $close.on("click", (e) => { + e.preventDefault(); + if (ws.readyState !== 1) { + window.location.pathname = window.location.pathname.replace("@shell", ""); + } else { + ws.close(); + } + }); + ws.addEventListener("close", () => { + term.write("\r\n\r\nclosing shell in 2 seconds..."); + closeTimeout = setTimeout(() => { + window.location.pathname = window.location.pathname.replace("@shell", ""); + }, 2000); + }); + term.on("data", () => { + if (closeTimeout != null) { + clearTimeout(closeTimeout); + term.write("\r\nkeyboard input detected. timeout canceled"); + closeTimeout = null; + } + }); + + }); }); diff --git a/index.js b/index.js index 653b551..9e767e2 100755 --- a/index.js +++ b/index.js @@ -10,6 +10,7 @@ const bodyparser = require("body-parser"); const session = require("express-session"); const busboy = require("connect-busboy"); const flash = require("connect-flash"); +const querystring = require("querystring"); const archiver = require("archiver"); @@ -64,6 +65,7 @@ app.use("/bootstrap", express.static(path.join(__dirname, "node_modules/bootstra app.use("/octicons", express.static(path.join(__dirname, "node_modules/octicons/build"))); app.use("/jquery", express.static(path.join(__dirname, "node_modules/jquery/dist"))); app.use("/filesize", express.static(path.join(__dirname, "node_modules/filesize/lib"))); +app.use("/xterm", express.static(path.join(__dirname, "node_modules/xterm/dist"))); app.use("/assets", express.static(path.join(__dirname, "assets"))); app.use(session({ @@ -431,7 +433,7 @@ if (shellable || cmdable) { }); const pty = require("node-pty"); - const io = require("socket.io")(http); + const WebSocket = require("ws"); app.get("/*@shell", (req, res) => { res.filename = req.params[0]; @@ -441,9 +443,11 @@ if (shellable || cmdable) { })); }); - io.on("connection", (socket) => { - let cwd = relative(socket.handshake.query.path); - + const ws = new WebSocket.Server({ server: http }); + ws.on("connection", (socket, request) => { + console.log(request.url); + const { path } = querystring.parse(request.url.split("?")[1]); + let cwd = relative(path); let term = pty.spawn(exec, args, { name: "xterm-256color", cols: 80, @@ -453,19 +457,24 @@ if (shellable || cmdable) { console.log("pid " + term.pid + " shell " + process.env.SHELL + " started in " + cwd); term.on("data", (data) => { - socket.emit("output", data); + socket.send(data, { binary: true }); }); term.on("exit", (code) => { console.log("pid " + term.pid + " ended") - socket.disconnect(); + socket.close(); }); - socket.on("resize", (data) => { - term.resize(data.col, data.row); - }); - socket.on("input", (data) => { + socket.on("message", (data) => { + // special messages should decode to Buffers + if (Buffer.isBuffer(data)) { + switch (data.readUInt16BE(0)) { + case 0: + term.resize(data.readUInt16BE(1), data.readUInt16BE(2)); + return; + } + } term.write(data); }); - socket.on("disconnect", () => { + socket.on("close", () => { term.end(); }); }); diff --git a/package.json b/package.json index 0477339..9a48b41 100644 --- a/package.json +++ b/package.json @@ -21,6 +21,8 @@ "octicons": "^6.0.1", "rimraf": "^2.6.2", "socket.io": "^2.0.4", - "thirty-two": "^1.0.2" + "thirty-two": "^1.0.2", + "ws": "^6.1.2", + "xterm": "^3.8.0" } } diff --git a/views/layouts/main.handlebars b/views/layouts/main.handlebars index 469ae00..f0c5ccd 100644 --- a/views/layouts/main.handlebars +++ b/views/layouts/main.handlebars @@ -10,10 +10,12 @@ + + + + - - diff --git a/views/shell.handlebars b/views/shell.handlebars index 1767ee5..790cace 100644 --- a/views/shell.handlebars +++ b/views/shell.handlebars @@ -1,12 +1,12 @@ {{> navbar}} -
-
+
+