├── main.css
├── main.js
├── .travis.yml
├── docs
    ├── example
    │   ├── tsconfig.json
    │   ├── typings.json
    │   ├── README.md
    │   ├── index.html
    │   ├── webpack.config.js
    │   ├── src
    │   │   └── example.tsx
    │   ├── dist
    │   │   ├── react-console.example.css
    │   │   └── react-console.example.css.map
    │   ├── package.json
    │   └── server.js
    ├── images
    │   └── example.svg
    ├── stylesheets
    │   ├── github-light.css
    │   ├── stylesheet.css
    │   └── normalize.css
    └── index.html
├── tsconfig.json
├── typings.json
├── dev
    ├── index.html
    └── dev.tsx
├── .npmignore
├── .gitignore
├── src
    ├── react-console.scss
    └── react-console.tsx
├── server.js
├── release.js
├── package.json
├── CHANGELOG.md
├── main.d.ts
├── karma.conf.js
├── README.md
├── webpack.config.js
├── test
    └── test.tsx
└── LICENSE


/main.css:
--------------------------------------------------------------------------------
1 | @import "./lib/react-console.css";
2 | 


--------------------------------------------------------------------------------
/main.js:
--------------------------------------------------------------------------------
1 | "use strict";
2 | 
3 | module.exports = require("./lib/react-console.js");
4 | 


--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | language: node_js
2 | node_js:
3 |   - node
4 | before_script:
5 |   - export CHROME_BIN=chromium-browser
6 |   - export DISPLAY=:99.0
7 |   - sh -e /etc/init.d/xvfb start
8 | 


--------------------------------------------------------------------------------
/docs/example/tsconfig.json:
--------------------------------------------------------------------------------
 1 | {
 2 | 	"compilerOptions": {
 3 | 		"noImplicitAny": true,
 4 | 		"declaration": false,
 5 | 		"sourceMap": true,
 6 | 		"module": "commonjs",
 7 | 		"target": "es5",
 8 | 		"jsx": "react"
 9 | 	}
10 | }
11 | 


--------------------------------------------------------------------------------
/docs/example/typings.json:
--------------------------------------------------------------------------------
1 | {
2 |   "name": "react-console",
3 |   "dependencies": {},
4 |   "globalDevDependencies": {
5 |     "react": "registry:dt/react#0.14.0+20160630100702",
6 |     "react-dom": "registry:dt/react-dom#0.14.0+20160412154040"
7 |   }
8 | }
9 | 


--------------------------------------------------------------------------------
/tsconfig.json:
--------------------------------------------------------------------------------
 1 | {
 2 | 	"compilerOptions": {
 3 | 		"noImplicitAny": true,
 4 | 		"declaration": false,
 5 | 		"sourceMap": true,
 6 | 		"module": "commonjs",
 7 | 		"target": "es5",
 8 | 		"jsx": "react"
 9 | 	},
10 | 	"exclude": [
11 | 		"docs/example",
12 | 		"test",
13 | 		".tmp",
14 | 		"node_modules"
15 | 	]
16 | }
17 | 


--------------------------------------------------------------------------------
/typings.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "react-console",
 3 |   "dependencies": {},
 4 |   "globalDevDependencies": {
 5 |     "chai": "registry:dt/chai#3.4.0+20160601211834",
 6 |     "enzyme": "registry:dt/enzyme#2.4.1+20160709041153",
 7 |     "es6-shim": "registry:dt/es6-shim#0.31.2+20160602141504",
 8 |     "mocha": "registry:dt/mocha#2.2.5+20160720003353",
 9 |     "react": "registry:dt/react#0.14.0+20160817201227",
10 |     "react-dom": "registry:dt/react-dom#0.14.0+20160412154040"
11 |   }
12 | }
13 | 


--------------------------------------------------------------------------------
/docs/example/README.md:
--------------------------------------------------------------------------------
 1 | # Example react-console project
 2 | 
 3 | Example React console emulator.
 4 | 
 5 | Used in the [live demo][demo-url].
 6 | 
 7 | 
 8 | ## Usage
 9 | 
10 | Build project:
11 | 
12 |     npm install
13 | 
14 | Start dev server:
15 | 
16 |     npm start
17 | 
18 | Test project:
19 | 
20 |     npm test
21 | 
22 | Clean generated files:
23 | 
24 |     npm run clean
25 | 
26 | Clean generated files and dependencies:
27 | 
28 |     npm run clean:deep
29 | 
30 | [demo-url]: https://astralarya.github.io/react-console/#react-console
31 | 


--------------------------------------------------------------------------------
/dev/index.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en-us">
 3 | <head>
 4 |     <meta charset="utf-8">
 5 |     <meta http-equiv="X-UA-Compatible" content="IE=edge">
 6 |     <meta name="viewport" content="width=device-width, initial-scale=1">
 7 |     <meta name="description" content="react-console: a simple React console emulator">
 8 |     <meta name="author" content="Mara Kim">
 9 |     <title>react-console</title>
10 |     <link type="text/css" rel="stylesheet" href="dist/react-console.dev.css" media="all" />
11 | </head>
12 | <body>
13 | <div id="console"></div>
14 | <script src="dist/react-console.dev.js"></script>
15 | <script>
16 | 	Dev.init(document.getElementById("console"));
17 | </script>
18 | </body>
19 | 


--------------------------------------------------------------------------------
/docs/example/index.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en-us">
 3 | <head>
 4 |     <meta charset="utf-8">
 5 |     <meta http-equiv="X-UA-Compatible" content="IE=edge">
 6 |     <meta name="viewport" content="width=device-width, initial-scale=1">
 7 |     <meta name="description" content="react-console: a simple React console emulator">
 8 |     <meta name="author" content="Mara Kim">
 9 |     <title>react-console</title>
10 |     <link type="text/css" rel="stylesheet" href="dist/react-console.example.css" media="all" />
11 | </head>
12 | <body>
13 | <div id="console"></div>
14 | <script src="dist/react-console.example.js"></script>
15 | <script>
16 | 	Example.init(document.getElementById("console"));
17 | </script>
18 | </body>
19 | 


--------------------------------------------------------------------------------
/.npmignore:
--------------------------------------------------------------------------------
 1 | # Logs
 2 | logs
 3 | *.log
 4 | 
 5 | # Runtime data
 6 | pids
 7 | *.pid
 8 | *.seed
 9 | 
10 | # Directory for instrumented libs generated by jscoverage/JSCover
11 | lib-cov
12 | 
13 | # Coverage directory used by tools like istanbul
14 | coverage
15 | 
16 | # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
17 | .grunt
18 | 
19 | # Compiled binary addons (http://nodejs.org/api/addons.html)
20 | build/Release
21 | 
22 | # Dependency directory
23 | # Commenting this out is preferred by some people, see
24 | # https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git-
25 | node_modules
26 | 
27 | # Typescript type definitions
28 | typings
29 | 
30 | # Users Environment Variables
31 | .lock-wscript
32 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # Logs
 2 | logs
 3 | *.log
 4 | npm-debug.log*
 5 | 
 6 | # Runtime data
 7 | pids
 8 | *.pid
 9 | *.seed
10 | 
11 | # Directory for instrumented libs generated by jscoverage/JSCover
12 | lib-cov
13 | 
14 | # Coverage directory used by tools like istanbul
15 | coverage
16 | 
17 | # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
18 | .grunt
19 | 
20 | # node-waf configuration
21 | .lock-wscript
22 | 
23 | # Compiled binary addons (http://nodejs.org/api/addons.html)
24 | build/Release
25 | 
26 | # Dependency directory
27 | node_modules
28 | 
29 | # Optional npm cache directory
30 | .npm
31 | 
32 | # Optional REPL history
33 | .node_repl_history
34 | 
35 | # Typescript type definitions
36 | typings
37 | 
38 | # Directory for built project
39 | dist
40 | lib
41 | 
42 | # mocha-webpack cache
43 | .tmp
44 | 
45 | # github token
46 | .token.json
47 | 


--------------------------------------------------------------------------------
/docs/example/webpack.config.js:
--------------------------------------------------------------------------------
 1 | // Project settings
 2 | 
 3 | let project = 'react-console';
 4 | 
 5 | // Build system
 6 | 
 7 | let FailPlugin = require('webpack-fail-plugin');
 8 | let ExtractTextPlugin = require('extract-text-webpack-plugin');
 9 | 
10 | module.exports = {
11 | 	context: __dirname,
12 | 	entry: './src/example.tsx',
13 | 	output: {
14 | 		path: __dirname + '/dist',
15 | 		filename: project + '.example.js',
16 | 		library: "Example",
17 | 		libraryTarget: "var",
18 | 	},
19 | 	module: {
20 | 		loaders: [
21 | 			{
22 | 				test: /\.tsx?$/,
23 | 				loader: "ts-loader",
24 | 			},
25 | 			{
26 | 				test: /\.s?css$/,
27 | 				loader: ExtractTextPlugin.extract("css-loader?sourceMap!sass-loader?sourceMap"),
28 | 			},
29 | 		],
30 | 		preLoaders: [
31 | 			{
32 | 				test: /\.(css|js)$/,
33 | 				loader: "source-map-loader",
34 | 			}
35 | 		],
36 | 	},
37 | 	devtool: 'source-map',
38 | 	plugins: [
39 | 		FailPlugin,
40 | 		new ExtractTextPlugin(project + '.example.css'),
41 | 	],
42 | };
43 | 


--------------------------------------------------------------------------------
/dev/dev.tsx:
--------------------------------------------------------------------------------
 1 | "use strict";
 2 | 
 3 | import * as React from 'react';
 4 | import * as ReactDOM from 'react-dom';
 5 | import Console from '../src/react-console.tsx';
 6 | 
 7 | interface EchoConsoleState {
 8 | 	count: number;
 9 | }
10 | class EchoConsole extends React.Component<{},EchoConsoleState> {
11 | 	constructor(props: {}) {
12 | 		super(props);
13 | 		this.state = {
14 | 			count: 0,
15 | 		};
16 | 	}
17 | 	child: {
18 | 		console?: Console,
19 | 	} = {};
20 | 	echo = (text: string) => {
21 | 		this.child.console.log(text);
22 | 		this.setState({
23 | 			count: this.state.count+1,
24 | 		}, this.child.console.return);
25 | 	}
26 | 	promptLabel = () => {
27 | 		return this.state.count + "> ";
28 | 	}
29 | 	render() {
30 | 		return <Console ref={ref => this.child.console = ref}
31 | 			handler={this.echo}
32 | 			promptLabel={this.promptLabel}
33 | 			welcomeMessage={"Welcome to the react-console demo!"}
34 | 			autofocus={true}
35 | 		/>;
36 | 	}
37 | }
38 | 
39 | export function init(element: Element) {
40 | 	ReactDOM.render(<EchoConsole/>, element);
41 | }
42 | 


--------------------------------------------------------------------------------
/docs/example/src/example.tsx:
--------------------------------------------------------------------------------
 1 | "use strict";
 2 | 
 3 | import * as React from 'react';
 4 | import * as ReactDOM from 'react-dom';
 5 | import Console from 'react-console-component';
 6 | import 'react-console-component/main.css';
 7 | 
 8 | interface EchoConsoleState {
 9 | 	count: number;
10 | }
11 | class EchoConsole extends React.Component<{},EchoConsoleState> {
12 | 	constructor(props: {}) {
13 | 		super(props);
14 | 		this.state = {
15 | 			count: 0,
16 | 		};
17 | 	}
18 | 	child: {
19 | 		console?: Console,
20 | 	} = {};
21 | 	echo = (text: string) => {
22 | 		this.child.console.log(text);
23 | 		this.setState({
24 | 			count: this.state.count+1,
25 | 		}, this.child.console.return);
26 | 	}
27 | 	promptLabel = () => {
28 | 		return this.state.count + "> ";
29 | 	}
30 | 	render() {
31 | 		return <Console ref={ref => this.child.console = ref}
32 | 			handler={this.echo}
33 | 			promptLabel={this.promptLabel}
34 | 			welcomeMessage={"Welcome to the react-console demo!\nThis is an example of a simple echo console."}
35 | 			autofocus={true}
36 | 		/>;
37 | 	}
38 | }
39 | 
40 | export function init(element: Element) {
41 | 	ReactDOM.render(<EchoConsole/>, element);
42 | }
43 | 


--------------------------------------------------------------------------------
/docs/example/dist/react-console.example.css:
--------------------------------------------------------------------------------
 1 | div.react-console-container {
 2 |   font-size: 0.85em;
 3 |   font-family: "Menlo", "Consolas", "DejaVu Sans Mono", monospace;
 4 |   width: 60em;
 5 |   max-width: 100%;
 6 |   box-sizing: border-box;
 7 |   height: 20em;
 8 |   background: #efefef;
 9 |   padding: 0.5em;
10 |   overflow: auto;
11 |   white-space: pre; }
12 | 
13 | div.react-console-prompt-box {
14 |   color: #444; }
15 | 
16 | span.react-console-prompt-label {
17 |   font-weight: bold; }
18 | 
19 | div.react-console-focus span.react-console-cursor {
20 |   background: #333;
21 |   color: #eee; }
22 | 
23 | div.react-console-nofocus span.react-console-cursor {
24 |   background: none;
25 |   color: #444;
26 |   outline: 0.1em solid #333;
27 |   outline-offset: -0.1em; }
28 | 
29 | div.react-console-focus span.react-console-cursor-idle {
30 |   animation: react-console-cursor-animation 1s infinite; }
31 | 
32 | @keyframes react-console-cursor-animation {
33 |   0% {
34 |     background: #333;
35 |     color: #eee; }
36 |   50% {
37 |     background: #333;
38 |     color: #eee; }
39 |   51% {
40 |     background: none;
41 |     color: #444; }
42 |   100% {
43 |     background: none;
44 |     color: #444; } }
45 | 
46 | div.react-console-message {
47 |   color: #999;
48 |   padding: 0.1em; }
49 | 
50 | 
51 | 
52 | /*# sourceMappingURL=react-console.example.css.map*/


--------------------------------------------------------------------------------
/docs/example/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "react-console-component-example",
 3 |   "version": "0.5.0",
 4 |   "description": "Example react console emulator",
 5 |   "private": true,
 6 |   "homepage": "https://autochthe.github.io/react-console/",
 7 |   "repository": "git+https://github.com/autochthe/react-console.git",
 8 |   "keywords": [
 9 |     "react-component",
10 |     "console",
11 |     "example"
12 |   ],
13 |   "author": "Mara Kim <mara@autochthe.net> (https://github.com/autochthe)",
14 |   "license": "GPL-3.0",
15 |   "bugs": "https://github.com/autochthe/react-console/issues",
16 |   "main": "dist/react-console.example.js",
17 |   "style": "dist/react-console.example.css",
18 |   "scripts": {
19 |     "prepublish": "typings install && webpack",
20 |     "build": "webpack",
21 |     "clean": "rm -rf dist",
22 |     "clean:deep": "rm -rf dist node_modules typings",
23 |     "test": "webpack"
24 |   },
25 |   "devDependencies": {
26 |     "css-loader": "^0.23.1",
27 |     "express": "^4.14.0",
28 |     "extract-text-webpack-plugin": "^1.0.1",
29 |     "node-sass": "^3.8.0",
30 |     "react": "^15.1.0",
31 |     "react-console-component": "^0.6.1",
32 |     "react-dom": "^15.1.0",
33 |     "sass-loader": "^4.0.0",
34 |     "source-map-loader": "^0.1.5",
35 |     "ts-loader": "^0.8.2",
36 |     "typescript": "^1.8.10",
37 |     "typings": "^1.3.0",
38 |     "webpack": "^1.13.1",
39 |     "webpack-fail-plugin": "^1.0.4"
40 |   }
41 | }
42 | 


--------------------------------------------------------------------------------
/docs/example/server.js:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env node
 2 | 
 3 | "use strict";
 4 | 
 5 | const PORT=8080;
 6 | 
 7 | 
 8 | // Webpack build server
 9 | var webpack = require('webpack');
10 | var config = require('./webpack.config.js');
11 | var compiler = webpack(config);
12 | var colors = require('colors');
13 | 
14 | var logSemaphore = 0;
15 | compiler.watch({},function(err,stats) {
16 | 	console.log(stats.toString({colors:true,chunks:false,children:false}));
17 | 	logSemaphore++;
18 | 	setTimeout(function() {
19 | 		logSemaphore--;
20 | 		if(logSemaphore == 0) {
21 | 			console.log();
22 | 			serverStatus();
23 | 			console.log();
24 | 		}
25 | 	},100);
26 | });
27 | 
28 | // Express web server
29 | var express = require('express');
30 | var app = express();
31 | var os = require('os');
32 | var ifaces = os.networkInterfaces();
33 | 
34 | app.use('/dist', express.static(__dirname + '/dist'));
35 | app.get('/', function(req, res) {
36 | 	res.sendFile(__dirname + '/index.html');
37 | });
38 | 
39 | app.listen(PORT, function() {
40 | 	serverStatus();
41 | });
42 | 
43 | function serverStatus() {
44 | 	console.log("Server listening on:")
45 | 	console.log(colors.cyan("http://localhost:%s"), PORT);
46 | 
47 | 	Object.keys(ifaces).forEach(function (ifname) {
48 | 		ifaces[ifname].forEach(function (iface) {
49 | 			if ('IPv4' === iface.family && iface.internal === false) {
50 | 				console.log(colors.cyan("http://%s:%s"), iface.address, PORT);
51 | 			}
52 | 		});
53 | 	});
54 | }
55 | 


--------------------------------------------------------------------------------
/src/react-console.scss:
--------------------------------------------------------------------------------
 1 | $monospace: 'Menlo', 'Andale Mono', 'DejaVu Sans Mono', 'Droid Sans Mono', 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;
 2 | 
 3 | $background-color: #efefef;
 4 | $prompt-color: #444;
 5 | $message-color: #999;
 6 | $cursor-color: #333;
 7 | $cursor-text-color: #eee;
 8 | 
 9 | 
10 | div.react-console-container {
11 | 	font-size: 0.85em;
12 | 	font-family: $monospace;
13 | 	width: 60em;
14 | 	max-width: 100%;
15 | 	box-sizing: border-box;
16 | 	height: 20em;
17 | 	background: $background-color;
18 | 	padding: 0.5em;
19 | 	overflow: auto;
20 | 	white-space: pre;
21 | }
22 | 
23 | div.react-console-prompt-box {
24 | 	color: $prompt-color;
25 | }
26 | 
27 | span.react-console-prompt-label {
28 | 	font-weight: bold;
29 | }
30 | 
31 | div.react-console-focus span.react-console-cursor {
32 | 	background: $cursor-color;
33 | 	color: $cursor-text-color;
34 | }
35 | 
36 | div.react-console-nofocus span.react-console-cursor {
37 | 	background: none;
38 | 	color: $prompt-color;
39 | 	outline: 0.1em solid $cursor-color;
40 | 	outline-offset: -0.1em;
41 | }
42 | 
43 | div.react-console-focus span.react-console-cursor-idle {
44 | 	animation: react-console-cursor-animation 1s infinite;
45 | }
46 | 
47 | @keyframes react-console-cursor-animation {
48 | 	0% {
49 | 		background: $cursor-color;
50 | 		color: $cursor-text-color;
51 | 	}
52 | 	50% {
53 | 		background: $cursor-color;
54 | 		color: $cursor-text-color;
55 | 	}
56 | 	51% {
57 | 		background: none;
58 | 		color: $prompt-color;
59 | 	}
60 | 	100% {
61 | 		background: none;
62 | 		color: $prompt-color;
63 | 	}
64 | }
65 | 
66 | div.react-console-message {
67 | 	color: $message-color;
68 | 	padding: 0.1em;
69 | }
70 | 


--------------------------------------------------------------------------------
/server.js:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env node
 2 | 
 3 | "use strict";
 4 | 
 5 | const PORT=8080;
 6 | 
 7 | const webpack = require('webpack');
 8 | const karma = require('karma');
 9 | const express = require('express');
10 | const colors = require('colors');
11 | const os = require('os');
12 | 
13 | // Status logging
14 | function serverStatus() {
15 | 	console.log("Server listening on:")
16 | 	console.log(colors.cyan(`http://localhost:${PORT}`));
17 | 
18 | 	let ifaces = os.networkInterfaces();
19 | 	Object.keys(ifaces).forEach(function (ifname) {
20 | 		ifaces[ifname].forEach(function (iface) {
21 | 			if ('IPv4' === iface.family && iface.internal === false) {
22 | 				console.log(colors.cyan(`http://${iface.address}:${PORT}`));
23 | 			}
24 | 		});
25 | 	});
26 | }
27 | let logSemaphore = 0;
28 | function logStart() {
29 | 	logSemaphore++;
30 | }
31 | function logEnd() {
32 | 	setTimeout(function() {
33 | 		logSemaphore--;
34 | 		if(logSemaphore == 0) {
35 | 			console.log();
36 | 			serverStatus();
37 | 			console.log();
38 | 		}
39 | 	},100);
40 | }
41 | 
42 | // Express web server
43 | let app = express();
44 | app.use('/', express.static(`${__dirname}/dev`));
45 | app.listen(PORT, function() {
46 | 	serverStatus();
47 | });
48 | 
49 | // Webpack build server
50 | let compiler = webpack(require('./webpack.config.js'));
51 | compiler.watch({},function(err,stats) {
52 | 	console.log(stats.toString({colors:true,chunks:false,children:false}));
53 | 	logStart();
54 | 	logEnd();
55 | });
56 | 
57 | // Karma test server
58 | let karmaServer = new karma.Server({
59 | 	configFile: `${__dirname}/karma.conf.js`,
60 | 	singleRun: false,
61 | });
62 | karmaServer.on('run_start', function() {
63 | 	logStart();
64 | });
65 | karmaServer.on('run_complete', function() {
66 | 	logEnd();
67 | });
68 | karmaServer.start();
69 | 


--------------------------------------------------------------------------------
/release.js:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env node
 2 | 
 3 | 'use strict';
 4 | 
 5 | const USER = 'autochthe';
 6 | const REPO = 'react-console';
 7 | const CHANGELOG = './CHANGELOG.md';
 8 | const ASSETS = [
 9 | 	'dist/dist.tar.gz',
10 | 	'dist/dist.zip',
11 | 	'dist/dist-min.tar.gz',
12 | 	'dist/dist-min.zip',
13 | ];
14 | 
15 | const token = require('./.token.json');
16 | const project = require('./package.json');
17 | 
18 | const changelogParser = require('changelog-parser');
19 | const GitHubAPI = require('github');
20 | const path = require('path');
21 | const semver = require('semver');
22 | 
23 | // Read changelog
24 | changelogParser(CHANGELOG, (err, result) => {
25 | 	if (err) throw err;
26 | 
27 | 	let found = false;
28 | 	for(let elem of result.versions) {
29 | 		if (elem.version == project.version) {
30 | 			found = true;
31 | 			if(!elem.body) {
32 | 				console.log('Changelog body is required');
33 | 				process.exit(1);
34 | 			}
35 | 			createRelease(project.version, elem.body);
36 | 		}
37 | 	}
38 | 	if(!found) {
39 | 		console.log(`No changelog found for v${project.version}`);
40 | 		process.exit(1);
41 | 	}
42 | })
43 | 
44 | function createRelease(version, body) {
45 | 	console.log(`Creating new Github release for v${version}`);
46 | 	console.log(body);
47 | 
48 | 	// Connect to github
49 | 	let github = new GitHubAPI();
50 | 	github.authenticate(token);
51 | 	github.repos.createRelease({
52 | 		user: USER,
53 | 		repo: REPO,
54 | 		tag_name: `v${version}`,
55 | 		body: body,
56 | 		prerelease: semver.prerelease(version)?true:false,
57 | 	}, (err,res) => {
58 | 		if(err) {
59 | 			console.log(err);
60 | 		} else {
61 | 			let id = res.id;
62 | 
63 | 			console.log('Uploading assets')
64 | 			for(let asset of ASSETS) {
65 | 				github.repos.uploadAsset({
66 | 					user: USER,
67 | 					repo: REPO,
68 | 					id: id,
69 | 					name: path.basename(asset),
70 | 					filePath: asset,
71 | 				});
72 | 			}
73 | 			console.log('DONE')
74 | 		}
75 | 	});
76 | }
77 | 


--------------------------------------------------------------------------------
/docs/example/dist/react-console.example.css.map:
--------------------------------------------------------------------------------
1 | {"version":3,"sources":["webpack:///webpack:///webpack:/webpack:/react-console.scss"],"names":[],"mappings":"AASA;EACC,kBAAkB;EAClB,gEAX6D;EAY7D,YAAY;EACZ,gBAAgB;EAChB,uBAAuB;EACvB,aAAa;EACb,oBAdyB;EAezB,eAAe;EACf,eAAe;EACf,iBAAiB,EACjB;;AAED;EACC,YApBkB,EAqBlB;;AAED;EACC,kBAAkB,EAClB;;AAED;EACC,iBA1BkB;EA2BlB,YA1BuB,EA2BvB;;AAED;EACC,iBAAiB;EACjB,YAlCkB;EAmClB,0BAjCkB;EAkClB,uBAAuB,EACvB;;AAED;EACC,sDAAsD,EACtD;;AAED;EACC;IACC,iBA3CiB;IA4CjB,YA3CsB;EA6CvB;IACC,iBA/CiB;IAgDjB,YA/CsB;EAiDvB;IACC,iBAAiB;IACjB,YAtDiB;EAwDlB;IACC,iBAAiB;IACjB,YA1DiB;;AA8DnB;EACC,YA9DmB;EA+DnB,eAAe,EACf","file":"react-console.example.css","sourcesContent":["$monospace: \"Menlo\", \"Consolas\", \"DejaVu Sans Mono\", monospace;\n\n$background-color: #efefef;\n$prompt-color: #444;\n$message-color: #999;\n$cursor-color: #333;\n$cursor-text-color: #eee;\n\n\ndiv.react-console-container {\n\tfont-size: 0.85em;\n\tfont-family: $monospace;\n\twidth: 60em;\n\tmax-width: 100%;\n\tbox-sizing: border-box;\n\theight: 20em;\n\tbackground: $background-color;\n\tpadding: 0.5em;\n\toverflow: auto;\n\twhite-space: pre;\n}\n\ndiv.react-console-prompt-box {\n\tcolor: $prompt-color;\n}\n\nspan.react-console-prompt-label {\n\tfont-weight: bold;\n}\n\ndiv.react-console-focus span.react-console-cursor {\n\tbackground: $cursor-color;\n\tcolor: $cursor-text-color;\n}\n\ndiv.react-console-nofocus span.react-console-cursor {\n\tbackground: none;\n\tcolor: $prompt-color;\n\toutline: 0.1em solid $cursor-color;\n\toutline-offset: -0.1em;\n}\n\ndiv.react-console-focus span.react-console-cursor-idle {\n\tanimation: react-console-cursor-animation 1s infinite;\n}\n\n@keyframes react-console-cursor-animation {\n\t0% {\n\t\tbackground: $cursor-color;\n\t\tcolor: $cursor-text-color;\n\t}\n\t50% {\n\t\tbackground: $cursor-color;\n\t\tcolor: $cursor-text-color;\n\t}\n\t51% {\n\t\tbackground: none;\n\t\tcolor: $prompt-color;\n\t}\n\t100% {\n\t\tbackground: none;\n\t\tcolor: $prompt-color;\n\t}\n}\n\ndiv.react-console-message {\n\tcolor: $message-color;\n\tpadding: 0.1em;\n}\n\n\n\n/** WEBPACK FOOTER **\n ** webpack:///react-console.scss\n **/\n\n\n/** WEBPACK FOOTER **\n ** webpack:///webpack:/webpack:/react-console.scss\n **/"],"sourceRoot":""}


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "react-console-component",
 3 |   "version": "0.6.1",
 4 |   "description": "Simple react console emulator",
 5 |   "homepage": "https://autochthe.github.io/react-console/",
 6 |   "repository": "git+https://github.com/autochthe/react-console.git",
 7 |   "keywords": [
 8 |     "react-component",
 9 |     "console"
10 |   ],
11 |   "author": "Mara Kim <mara@autochthe.net> (https://github.com/autochthe)",
12 |   "license": "GPL-3.0",
13 |   "bugs": "https://github.com/autochthe/react-console/issues",
14 |   "main": "main.js",
15 |   "style": "main.css",
16 |   "typings": "main.d.ts",
17 |   "scripts": {
18 |     "prepublish": "typings install && webpack",
19 |     "build": "webpack",
20 |     "clean": "rm -rf dist lib dev/dist test/dist coverage",
21 |     "clean:deep": "rm -rf dist lib dev/dist test/dist coverage node_modules typings",
22 |     "test": "karma start",
23 |     "preversion": "npm test",
24 |     "postversion": "git push && git push --tags && ./release.js"
25 |   },
26 |   "devDependencies": {
27 |     "chai": "^3.5.0",
28 |     "changelog-parser": "^2.0.2",
29 |     "css-loader": "^0.23.1",
30 |     "enzyme": "^2.4.1",
31 |     "exports-loader": "^0.6.3",
32 |     "express": "^4.14.0",
33 |     "extract-text-webpack-plugin": "^1.0.1",
34 |     "github": "^2.4.0",
35 |     "istanbul-instrumenter-loader": "^0.2.0",
36 |     "karma": "^1.1.2",
37 |     "karma-chrome-launcher": "^2.0.0",
38 |     "karma-coverage": "^1.1.1",
39 |     "karma-coveralls": "^1.1.2",
40 |     "karma-detect-browsers": "^2.1.0",
41 |     "karma-firefox-launcher": "^1.0.0",
42 |     "karma-ie-launcher": "^1.0.0",
43 |     "karma-mocha": "^1.1.1",
44 |     "karma-mocha-reporter": "^2.1.0",
45 |     "karma-opera-launcher": "^1.0.0",
46 |     "karma-phantomjs-launcher": "^1.0.1",
47 |     "karma-safari-launcher": "^1.0.0",
48 |     "karma-sourcemap-loader": "^0.3.7",
49 |     "karma-webpack": "^1.7.0",
50 |     "mocha": "^3.0.1",
51 |     "node-sass": "^3.8.0",
52 |     "phantomjs-polyfill-object-assign": "0.0.2",
53 |     "react": "^15.1.0",
54 |     "react-addons-test-utils": "^15.3.0",
55 |     "react-dom": "^15.1.0",
56 |     "sass-loader": "^4.0.0",
57 |     "semver": "^5.3.0",
58 |     "source-map-loader": "^0.1.5",
59 |     "ts-loader": "^0.8.2",
60 |     "typescript": "^1.8.10",
61 |     "typings": "^1.3.2",
62 |     "webpack": "^1.13.1",
63 |     "webpack-archive-plugin": "^2.0.0",
64 |     "webpack-fail-plugin": "^1.0.4",
65 |     "webpack-node-externals": "^1.3.3"
66 |   },
67 |   "peerDependencies": {
68 |     "react": "^15.1.0",
69 |     "react-dom": "^15.1.0"
70 |   }
71 | }
72 | 


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | # Changelog
 2 | This project adheres to [Semantic Versioning](http://semver.org/).
 3 | 
 4 | ## [Unreleased]
 5 | 
 6 | ## [0.6.1] - 2016-08-15
 7 | - Add Karma/Mocha/Chai testing and reporting to coveralls.io
 8 | 
 9 | ## [0.6.0] - 2016-08-05
10 | - Rename variables to match GNU readline semantics
11 | - Add Begginning/End of history commands
12 | - Add Incremental History search
13 | 
14 | ## [0.5.2] - 2016-07-08
15 | - Reorganize code to better match GNU readline
16 | - Add welcome message to example
17 | 
18 | ## [0.5.1] - 2016-07-08
19 | - Update typescript definitions
20 | 
21 | ## [0.5.0] - 2016-07-07
22 | - Add Killing and Yanking commands
23 | - Fix welcome message display
24 | 
25 | ## [0.4.2] - 2016-07-06
26 | - Update typings
27 | - Rename keyMap
28 | - Update build system to workaround webpack bug
29 | - Collect dev files
30 | 
31 | ## [0.4.1] - 2016-06-24
32 | - Add badges to README
33 | - Add test script
34 | - Add demo image
35 | - Update packages
36 | - Rename commands to match GNU readline implementation
37 | - Reorganize code
38 | - Update style
39 | 
40 | ## [0.4.0] - 2016-06-23
41 | - Add C-c support
42 | 
43 | ## [0.3.0] - 2016-06-17
44 | - Rename entry points to main.*
45 | - Add style field to package.json
46 | - Load css sourcemaps
47 | - Update pages script
48 | 
49 | ## [0.2.2] - 2016-06-15
50 | - Fix imports in example
51 | 
52 | ## [0.2.1] - 2016-06-15
53 | - Improve example documentation
54 | - Fix CSS linking
55 | 
56 | ## [0.2.0] - 2016-06-15
57 | - Make example a self-contained project
58 | 
59 | ## [0.1.1] - 2016-06-03
60 | - More sophisticated build system
61 | 
62 | ## 0.1.0 - 2016-06-03
63 | - Working basic console implementation
64 | - Webpack compilation of React-Typescript and Sass
65 | 
66 | [Unreleased]: https://github.com/astralarya/react-console/compare/v0.6.1...HEAD
67 | [0.6.1]: https://github.com/astralarya/react-console/compare/v0.6.0...v0.6.1
68 | [0.6.0]: https://github.com/astralarya/react-console/compare/v0.5.2...v0.6.0
69 | [0.5.2]: https://github.com/astralarya/react-console/compare/v0.5.1...v0.5.2
70 | [0.5.1]: https://github.com/astralarya/react-console/compare/v0.5.0...v0.5.1
71 | [0.5.0]: https://github.com/astralarya/react-console/compare/v0.4.2...v0.5.0
72 | [0.4.2]: https://github.com/astralarya/react-console/compare/v0.4.1...v0.4.2
73 | [0.4.1]: https://github.com/astralarya/react-console/compare/v0.4.0...v0.4.1
74 | [0.4.0]: https://github.com/astralarya/react-console/compare/v0.3.0...v0.4.0
75 | [0.3.0]: https://github.com/astralarya/react-console/compare/v0.2.2...v0.3.0
76 | [0.2.2]: https://github.com/astralarya/react-console/compare/v0.2.1...v0.2.2
77 | [0.2.1]: https://github.com/astralarya/react-console/compare/v0.2.0...v0.2.1
78 | [0.2.0]: https://github.com/astralarya/react-console/compare/v0.1.1...v0.2.0
79 | [0.1.1]: https://github.com/astralarya/react-console/compare/v0.1.0...v0.1.1
80 | 


--------------------------------------------------------------------------------
/docs/images/example.svg:
--------------------------------------------------------------------------------
  1 | <svg
  2 | 	xmlns:svg="http://www.w3.org/2000/svg"
  3 | 	xmlns="http://www.w3.org/2000/svg"
  4 | 	height="20em"
  5 | 	viewBox="0 0 60 20"
  6 | 	preserveAspectRatio="xMinYMin slice"
  7 | 	>
  8 | 	<style type="text/css">
  9 | 	<![CDATA[
 10 | 		.background {
 11 | 			fill: #efefef; }
 12 | 		#cursor {
 13 | 			fill: #333;
 14 | 			animation: cursor-animation 1s 8.2, cursor-animation 1s 17.5, cursor-animation 1s infinite;
 15 | 			animation-delay: 1s, 12.5s, 31.6s; }
 16 | 		#time {
 17 | 			animation: typing-animation 0.4s, typing-animation2 0.5s, typing-animation3 0.6s;
 18 | 			animation-delay: 9.2s, 11s, 30s;
 19 | 			animation-fill-mode: forwards;
 20 | 		}
 21 | 		text {
 22 | 			fill: #999;
 23 | 			font-family: 'Menlo', 'Andale Mono', 'DejaVu Sans Mono', 'Droid Sans Mono', 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace; }
 24 | 		.prompt {
 25 | 			fill: #444;
 26 | 		}
 27 | 		.prompt.label {
 28 | 			font-weight: bold;
 29 | 		}
 30 | 		@keyframes cursor-animation {
 31 | 		  0% {
 32 | 			fill: #333; }
 33 | 		  50% {
 34 | 			fill: #333; }
 35 | 		  51% {
 36 | 			fill: none; }
 37 | 		  100% {
 38 | 			fill: none; } }
 39 | 		@keyframes typing-animation {
 40 | 		  0% {
 41 | 			transform: translate(0,0); }
 42 | 		  1% {
 43 | 			transform: translate(0.6px,0); }
 44 | 		  25% {
 45 | 			transform: translate(0.6px,0); }
 46 | 		  26% {
 47 | 			transform: translate(1.3px,0); }
 48 | 		  50% {
 49 | 			transform: translate(1.3px,0); }
 50 | 		  51% {
 51 | 			transform: translate(1.9px,0); }
 52 | 		  70% {
 53 | 			transform: translate(1.9px,0); }
 54 | 		  71% {
 55 | 			transform: translate(2.4px,0); }
 56 | 		  99% {
 57 | 			transform: translate(2.4px,0); }
 58 | 		  100% {
 59 | 			transform: translate(3px,0); } }
 60 | 		@keyframes typing-animation2 {
 61 | 		  0% {
 62 | 			transform: translate(3px,0); }
 63 | 		  1% {
 64 | 			transform: translate(3.6px,0); }
 65 | 		  40% {
 66 | 			transform: translate(3.6px,0); }
 67 | 		  41% {
 68 | 			transform: translate(4.3px,0); }
 69 | 		  99% {
 70 | 			transform: translate(4.3px,0); }
 71 | 		  100% {
 72 | 			transform: translate(4.9px,0); } }
 73 | 		@keyframes typing-animation3 {
 74 | 		  0% {
 75 | 			transform: translate(4.9px,0); }
 76 | 		  1% {
 77 | 			transform: translate(3.6px,0); }
 78 | 		  99% {
 79 | 			transform: translate(3.6px,0); }
 80 | 		  100% {
 81 | 			transform: translate(0,0); } }
 82 | 	]]>
 83 | 	</style>
 84 | 	<rect
 85 | 		class="background"
 86 | 		y="0"
 87 | 		x="0"
 88 | 		height="20"
 89 | 		width="60" />
 90 | 	<text
 91 | 		class="message"
 92 | 		y="1.55"
 93 | 		x="0.5"
 94 | 		font-size="1" >
 95 | 		Try the live demo!
 96 | 	</text>
 97 | 	<text
 98 | 		class="prompt label"
 99 | 		y="3.1"
100 | 		x="0.5"
101 | 		font-size="1" >
102 | 		0&gt;
103 | 	</text>
104 | 	<text
105 | 		class="prompt"
106 | 		y="3.1"
107 | 		x="2.25"
108 | 		font-size="1" >
109 | 		hello :)
110 | 	</text>
111 | 	<g id="time">
112 | 		<rect
113 | 			class="background"
114 | 			y="2.2"
115 | 			x="2.25"
116 | 			height="1.2"
117 | 			width="60" />
118 | 		<rect
119 | 			id="cursor"
120 | 			y="2.2"
121 | 			x="2.25"
122 | 			height="1.2"
123 | 			width="0.6" />
124 | 	</g>
125 | </svg>
126 | 


--------------------------------------------------------------------------------
/main.d.ts:
--------------------------------------------------------------------------------
  1 | import * as React from 'react';
  2 | import './react-console.scss';
  3 | export interface LogMessage {
  4 |     type?: string;
  5 |     value: any[];
  6 | }
  7 | export interface LogEntry {
  8 |     label: string;
  9 |     command: string;
 10 |     message: LogMessage[];
 11 | }
 12 | export interface ConsoleProps {
 13 |     handler(command: string): any;
 14 |     cancel?(): any;
 15 |     complete?(words: string[], curr: number, promptText: string): string[];
 16 |     continue?(promptText: string): boolean;
 17 |     autofocus?: boolean;
 18 |     promptLabel?: string | (() => string);
 19 |     welcomeMessage?: string;
 20 | }
 21 | export declare enum ConsoleCommand {
 22 |     Default = 0,
 23 |     Kill = 1,
 24 |     Yank = 2,
 25 | }
 26 | export interface ConsoleState {
 27 |     focus?: boolean;
 28 |     acceptInput?: boolean;
 29 |     typer?: string;
 30 |     column?: number;
 31 |     currLabel?: string;
 32 |     promptText?: string;
 33 |     restoreText?: string;
 34 |     log?: LogEntry[];
 35 |     history?: string[];
 36 |     historyn?: number;
 37 |     kill?: string[];
 38 |     killn?: number;
 39 |     lastCommand?: ConsoleCommand;
 40 | }
 41 | export default class  extends React.Component<ConsoleProps, ConsoleState> {
 42 |     constructor(props: ConsoleProps);
 43 |     static defaultProps: {
 44 |         promptLabel: string;
 45 |         continue: () => boolean;
 46 |         cancel: () => void;
 47 |     };
 48 |     child: {
 49 |         typer?: HTMLTextAreaElement;
 50 |         container?: HTMLElement;
 51 |         focus?: HTMLElement;
 52 |     };
 53 |     log: (...messages: any[]) => void;
 54 |     logX: (type: string, ...messages: any[]) => void;
 55 |     return: () => void;
 56 |     componentDidMount(): void;
 57 |     focus: () => void;
 58 |     blur: () => void;
 59 |     keyDown: (e: KeyboardEvent) => void;
 60 |     change: () => void;
 61 |     paste: (e: ClipboardEvent) => void;
 62 |     beginningOfLine: () => void;
 63 |     endOfLine: () => void;
 64 |     forwardChar: () => void;
 65 |     backwardChar: () => void;
 66 |     forwardWord: () => void;
 67 |     backwardWord: () => void;
 68 |     acceptLine: () => void;
 69 |     previousHistory: () => void;
 70 |     nextHistory: () => void;
 71 |     deleteChar: () => void;
 72 |     backwardDeleteChar: () => void;
 73 |     killLine: () => void;
 74 |     backwardKillLine: () => void;
 75 |     killWholeLine: () => void;
 76 |     killWord: () => void;
 77 |     backwardKillWord: () => void;
 78 |     yank: () => void;
 79 |     yankPop: () => void;
 80 |     complete: () => void;
 81 |     cancelCommand: () => void;
 82 |     consoleInsert: (text: string, replace?: number) => {
 83 |         column: number;
 84 |         promptText: string;
 85 |         restoreText: string;
 86 |         lastCommand: ConsoleCommand;
 87 |     };
 88 |     moveColumn: (n: number, max?: number) => number;
 89 |     nextWord(): number;
 90 |     previousWord(): number;
 91 |     rotateRing: (n: number, ringn: number, ring: number) => number;
 92 |     rotateHistory: (n: number) => void;
 93 |     scrollSemaphore: number;
 94 |     scrollIfBottom: () => () => void;
 95 |     scrollIfBottomTrue: () => void;
 96 |     scrollToBottom: () => void;
 97 |     nextLabel: () => string;
 98 |     render(): JSX.Element;
 99 | }
100 | 


--------------------------------------------------------------------------------
/karma.conf.js:
--------------------------------------------------------------------------------
  1 | 'use strict';
  2 | 
  3 | // Karma configuration
  4 | 
  5 | module.exports = function(config) {
  6 | 	config.set({
  7 | 
  8 | 		// base path that will be used to resolve all patterns (eg. files, exclude)
  9 | 		basePath: '',
 10 | 
 11 | 
 12 | 		// frameworks to use
 13 | 		// available frameworks: https://npmjs.org/browse/keyword/karma-adapter
 14 | 		frameworks: ['detectBrowsers', 'mocha'],
 15 | 
 16 | 
 17 | 		// list of files / patterns to load in the browser
 18 | 		files: [
 19 | 			'./node_modules/phantomjs-polyfill-object-assign/object-assign-polyfill.js', //HOPE one day ditch PhantomJS polyfill
 20 | 			'test/*.tsx'
 21 | 		],
 22 | 
 23 | 
 24 | 		// list of files to exclude
 25 | 		exclude: [
 26 | 		],
 27 | 
 28 | 
 29 | 		// preprocess matching files before serving them to the browser
 30 | 		// available preprocessors: https://npmjs.org/browse/keyword/karma-preprocessor
 31 | 		preprocessors: {
 32 | 			'test/*.tsx': ['webpack', 'sourcemap'],
 33 | 		},
 34 | 
 35 | 		webpack: {
 36 | 			module: {
 37 | 				loaders: [
 38 | 					{
 39 | 						test: /\.tsx?$/,
 40 | 						loader: "ts-loader",
 41 | 					},
 42 | 					{
 43 | 						test: /\.s?css$/,
 44 | 						loader: "css-loader?sourceMap!sass-loader?sourceMap",
 45 | 					},
 46 | 				],
 47 | 				preLoaders: [
 48 | 					{
 49 | 						test: /\.(css|js)$/,
 50 | 						loader: "source-map-loader",
 51 | 					},
 52 | 				],
 53 | 				postLoaders: [
 54 | 					{
 55 | 						test: /\.tsx?$/,
 56 | 						include: /src\//,
 57 | 						loader: "istanbul-instrumenter",
 58 | 					},
 59 | 				],
 60 | 			},
 61 | 			devtool: 'inline-source-map',
 62 | 			externals: {
 63 | 				'cheerio': 'window',
 64 | 				'react/addons': true,
 65 | 				'react/lib/ExecutionEnvironment': true,
 66 | 				'react/lib/ReactContext': true,
 67 | 			},
 68 | 		},
 69 | 
 70 | 		// Travis CI Chrome config
 71 | 		customLaunchers: {
 72 | 			Chrome_travis_ci: {
 73 | 				base: 'Chrome',
 74 | 				flags: ['--no-sandbox'],
 75 | 			},
 76 | 		},
 77 | 
 78 | 		detectBrowsers: {
 79 | 			postDetection: function(availableBrowser) {
 80 | 				if(process.env.TRAVIS) {
 81 | 					availableBrowser[availableBrowser.indexOf('Chrome')] = 'Chrome_travis_ci';
 82 | 				}
 83 | 				return availableBrowser;
 84 | 			}
 85 | 		},
 86 | 
 87 | 
 88 | 		// test results reporter to use
 89 | 		// possible values: 'dots', 'progress'
 90 | 		// available reporters: https://npmjs.org/browse/keyword/karma-reporter
 91 | 		reporters: ['mocha', 'coverage', 'coveralls'],
 92 | 		coverageReporter: {
 93 | 			reporters: [
 94 | 				{ type: 'text-summary' },
 95 | 				{ type: 'lcovonly', dir: 'coverage/' },
 96 | 			]
 97 | 		},
 98 | 
 99 | 
100 | 		// web server port
101 | 		port: 9876,
102 | 
103 | 
104 | 		// enable / disable colors in the output (reporters and logs)
105 | 		colors: true,
106 | 
107 | 
108 | 		// level of logging
109 | 		// possible values: config.LOG_DISABLE || config.LOG_ERROR || config.LOG_WARN || config.LOG_INFO || config.LOG_DEBUG
110 | 		logLevel: config.LOG_INFO,
111 | 
112 | 
113 | 		// enable / disable watching file and executing tests whenever any file changes
114 | 		autoWatch: true,
115 | 
116 | 
117 | 		// Long timeout to allow for slow test environments
118 | 		browserDisconnectTimeout: 10000,
119 | 
120 | 		// Continuous Integration mode
121 | 		// if true, Karma captures browsers, runs the tests and exits
122 | 		singleRun: true,
123 | 
124 | 		// Concurrency level
125 | 		// how many browser should be started simultaneous
126 | 		concurrency: Infinity
127 | 	})
128 | }
129 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # react-console
 2 | 
 3 | Simple React.js console emulator.
 4 | 
 5 | [![NPM Version][npm-image]][npm-url]
 6 | [![NPM Downloads][downloads-image]][npm-url]
 7 | [![Travis Build][travis-image]][travis-url]
 8 | [![Coverage Status][coveralls-image]][coveralls-url]
 9 | 
10 | [![Demo Image][demo-image]][demo-url]
11 | 
12 | ## Example
13 | 
14 | Simple prompt that echoes back input:
15 | 
16 | ```javascript
17 | let EchoConsole = React.createClass({
18 | 	echo: function(text) {
19 | 		this.refs.console.log(text);
20 | 		this.refs.console.return();
21 | 	},
22 | 	render: function() {
23 | 		return <Console ref="console"
24 | 			handler={this.echo}
25 | 			autofocus={true}
26 | 		/>;
27 | 	}
28 | });
29 | ```
30 | 
31 | See the [example project](docs/example) used in the [live demo][demo-url].
32 | 
33 | 
34 | ## Installation
35 | 
36 |     npm install --save-dev react-console-component
37 | 
38 | 
39 | ## Features
40 | 
41 | * Readline emulation
42 | * Mobile friendly
43 | * Input Method Editor (IME) support
44 | 
45 | 
46 | ## Props
47 | 
48 | Properties you can pass to the console element
49 | 
50 | | Prop			| Type									| Description
51 | | ----			| ----									| ----
52 | | autofocus?		| bool								| Autofocus the console on component mount.
53 | | cancel?		| ()=>any							| Function that should stop execution of the current command and call `this.return()`.
54 | | complete?		| (words: string[], cursor: number, prompt: string)=>string[]	| Return a list of possible completions given a list of (`words`), index of the word containing the cursor (`cursor`) , and the full prompt text (`prompt`).
55 | | continue?		| (prompt: string)=>bool					| Return a boolean indicating whether to continue asking for user input on a newline given the current prompt text (`prompt`).
56 | | handler		| (command: string)=>any					| Handle a command (`command`), logging data with `this.log()` or `this.logX()`, and calling `this.return()` when finished.
57 | | promptLabel?		| string \| ()=>string						| String or function that generates a string displayed to prompt user for input.
58 | | welcomeMessage?	| string							| Initial message displayed after mount.
59 | 
60 | 
61 | ## Public members
62 | 
63 | | Member	| Type							| Description
64 | | ----		| ----							| ----
65 | | log		| (...messages: any)=>void			| Log messages to the console. If string, print the value, otherwise, print the JSON value of the message.
66 | | logX		| (type: string, ...messages: any)=>void	| Log messages of a particular type to the console. The messages will be given the class `react-console-message-{type}`.
67 | | return	| ()=>void					| Signal the current command has finished and a new prompt should be displayed.
68 | 
69 | 
70 | ## Awknoledgements
71 | 
72 | React-console is inspired by [chrisdone/jquery-console](https://github.com/chrisdone/jquery-console).
73 | 
74 | [demo-image]: https://astralarya.github.io/react-console/images/example.svg
75 | [demo-url]: https://astralarya.github.io/react-console/#react-console
76 | [npm-image]: https://img.shields.io/npm/v/react-console-component.svg
77 | [npm-url]: https://npmjs.org/package/react-console-component
78 | [downloads-image]: https://img.shields.io/npm/dm/react-console-component.svg
79 | [travis-image]: https://img.shields.io/travis/astralarya/react-console/master.svg
80 | [travis-url]: https://travis-ci.org/astralarya/react-console
81 | [coveralls-image]: https://coveralls.io/repos/github/astralarya/react-console/badge.svg?branch=master
82 | [coveralls-url]: https://coveralls.io/github/astralarya/react-console?branch=master
83 | 


--------------------------------------------------------------------------------
/webpack.config.js:
--------------------------------------------------------------------------------
  1 | 'use strict';
  2 | 
  3 | // Project settings
  4 | 
  5 | let project = 'react-console';
  6 | let library = 'Console';
  7 | let externals = {
  8 | 	"react": "React",
  9 | 	"react-dom": "ReactDOM",
 10 | };
 11 | 
 12 | 
 13 | 
 14 | // Build system
 15 | 
 16 | let webpack = require('webpack');
 17 | let FailPlugin = require('webpack-fail-plugin');
 18 | let ExtractTextPlugin = require('extract-text-webpack-plugin');
 19 | let ArchivePlugin = require('webpack-archive-plugin');
 20 | let nodeExternals = require('webpack-node-externals');
 21 | 
 22 | let options = {
 23 | 	dev: process.argv.indexOf('--dev') != -1,
 24 | 	dist: process.argv.indexOf('--dist') != -1,
 25 | 	lib: process.argv.indexOf('--lib') != -1,
 26 | 	default: process.argv.indexOf('--dev') == -1
 27 | 		&& process.argv.indexOf('--dist') == -1
 28 | 		&& process.argv.indexOf('--lib') == -1,
 29 | };
 30 | 
 31 | let base = {
 32 | 	context: __dirname + "/src",
 33 | 	entry: './' + project + '.tsx',
 34 | 	module: {
 35 | 		loaders: [
 36 | 			{
 37 | 				test: /\.tsx?$/,
 38 | 				loader: "ts-loader",
 39 | 			},
 40 | 			{
 41 | 				test: /\.s?css$/,
 42 | 				loader: ExtractTextPlugin.extract("css-loader?sourceMap!sass-loader?sourceMap"),
 43 | 			},
 44 | 		],
 45 | 		preLoaders: [
 46 | 			{
 47 | 				test: /\.(css|js)$/,
 48 | 				loader: "source-map-loader",
 49 | 			}
 50 | 		],
 51 | 	},
 52 | 	devtool: 'source-map',
 53 | };
 54 | 
 55 | let production_plugins = [
 56 | 	FailPlugin,
 57 | 	new webpack.DefinePlugin({
 58 | 		'process.env.NODE_ENV': '"production"'
 59 | 	}),
 60 | 	new webpack.optimize.UglifyJsPlugin(),
 61 | 	new webpack.optimize.OccurenceOrderPlugin(),
 62 | 	new webpack.optimize.DedupePlugin(),
 63 | ]
 64 | 
 65 | let dist = Object.assign({},base, {
 66 | 	output: {
 67 | 		path: __dirname + '/dist/dist',
 68 | 		filename: project + '.js',
 69 | 		library: library,
 70 | 		libraryTarget: "var",
 71 | 	},
 72 | 	externals: externals,
 73 | 	plugins: [
 74 | 		FailPlugin,
 75 | 		new ArchivePlugin(),
 76 | 		new ExtractTextPlugin(project + '.css'),
 77 | 	],
 78 | });
 79 | 
 80 | let dist_min = Object.assign({},dist, {
 81 | 	output: {
 82 | 		path: __dirname + '/dist/dist-min',
 83 | 		filename: project + '.min.js',
 84 | 		library: library,
 85 | 		libraryTarget: "var",
 86 | 	},
 87 | 	plugins: [
 88 | 		FailPlugin,
 89 | 		new ExtractTextPlugin(project + '.min.css'),
 90 | 		new ArchivePlugin(),
 91 | 		...production_plugins,
 92 | 	],
 93 | });
 94 | 
 95 | let libexternals = {}
 96 | for(let key in externals) {
 97 | 	if(externals.hasOwnProperty(key)) {
 98 | 		libexternals[key] = true;
 99 | 	}
100 | }
101 | let lib = Object.assign({},dist, {
102 | 	output: {
103 | 		path: __dirname + '/lib',
104 | 		filename: project + '.js',
105 | 		library: library,
106 | 		libraryTarget: "commonjs2",
107 | 	},
108 | 	externals: libexternals,
109 | 	plugins: [
110 | 		FailPlugin,
111 | 		new ExtractTextPlugin(project + '.css'),
112 | 	],
113 | });
114 | 
115 | let development = Object.assign({},base, {
116 | 	entry: '../dev/dev.tsx',
117 | 	output: {
118 | 		path: __dirname + '/dev/dist',
119 | 		filename: project + '.dev.js',
120 | 		library: "Dev",
121 | 		libraryTarget: "var",
122 | 	},
123 | 	plugins: [
124 | 		FailPlugin,
125 | 		new ExtractTextPlugin(project + '.dev.css'),
126 | 	],
127 | });
128 | 
129 | 
130 | let targets = [];
131 | if(options.dev || options.default) {
132 | 	targets.push(development);
133 | }
134 | if(options.dist || options.default) {
135 | 	targets.push(dist, dist_min);
136 | }
137 | if(options.lib || options.default) {
138 | 	targets.push(lib);
139 | }
140 | module.exports = targets;
141 | 


--------------------------------------------------------------------------------
/docs/stylesheets/github-light.css:
--------------------------------------------------------------------------------
  1 | /*
  2 | The MIT License (MIT)
  3 | 
  4 | Copyright (c) 2015 GitHub, Inc.
  5 | 
  6 | Permission is hereby granted, free of charge, to any person obtaining a copy
  7 | of this software and associated documentation files (the "Software"), to deal
  8 | in the Software without restriction, including without limitation the rights
  9 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 10 | copies of the Software, and to permit persons to whom the Software is
 11 | furnished to do so, subject to the following conditions:
 12 | 
 13 | The above copyright notice and this permission notice shall be included in all
 14 | copies or substantial portions of the Software.
 15 | 
 16 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 17 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 18 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 19 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 20 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 21 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 22 | SOFTWARE.
 23 | 
 24 | */
 25 | 
 26 | .pl-c /* comment */ {
 27 |   color: #969896;
 28 | }
 29 | 
 30 | .pl-c1      /* constant, markup.raw, meta.diff.header, meta.module-reference, meta.property-name, support, support.constant, support.variable, variable.other.constant */,
 31 | .pl-s .pl-v /* string variable */ {
 32 |   color: #0086b3;
 33 | }
 34 | 
 35 | .pl-e  /* entity */,
 36 | .pl-en /* entity.name */ {
 37 |   color: #795da3;
 38 | }
 39 | 
 40 | .pl-s .pl-s1 /* string source */,
 41 | .pl-smi      /* storage.modifier.import, storage.modifier.package, storage.type.java, variable.other, variable.parameter.function */ {
 42 |   color: #333;
 43 | }
 44 | 
 45 | .pl-ent /* entity.name.tag */ {
 46 |   color: #63a35c;
 47 | }
 48 | 
 49 | .pl-k /* keyword, storage, storage.type */ {
 50 |   color: #a71d5d;
 51 | }
 52 | 
 53 | .pl-pds              /* punctuation.definition.string, string.regexp.character-class */,
 54 | .pl-s                /* string */,
 55 | .pl-s .pl-pse .pl-s1 /* string punctuation.section.embedded source */,
 56 | .pl-sr               /* string.regexp */,
 57 | .pl-sr .pl-cce       /* string.regexp constant.character.escape */,
 58 | .pl-sr .pl-sra       /* string.regexp string.regexp.arbitrary-repitition */,
 59 | .pl-sr .pl-sre       /* string.regexp source.ruby.embedded */ {
 60 |   color: #183691;
 61 | }
 62 | 
 63 | .pl-v /* variable */ {
 64 |   color: #ed6a43;
 65 | }
 66 | 
 67 | .pl-id /* invalid.deprecated */ {
 68 |   color: #b52a1d;
 69 | }
 70 | 
 71 | .pl-ii /* invalid.illegal */ {
 72 |   background-color: #b52a1d;
 73 |   color: #f8f8f8;
 74 | }
 75 | 
 76 | .pl-sr .pl-cce /* string.regexp constant.character.escape */ {
 77 |   color: #63a35c;
 78 |   font-weight: bold;
 79 | }
 80 | 
 81 | .pl-ml /* markup.list */ {
 82 |   color: #693a17;
 83 | }
 84 | 
 85 | .pl-mh        /* markup.heading */,
 86 | .pl-mh .pl-en /* markup.heading entity.name */,
 87 | .pl-ms        /* meta.separator */ {
 88 |   color: #1d3e81;
 89 |   font-weight: bold;
 90 | }
 91 | 
 92 | .pl-mq /* markup.quote */ {
 93 |   color: #008080;
 94 | }
 95 | 
 96 | .pl-mi /* markup.italic */ {
 97 |   color: #333;
 98 |   font-style: italic;
 99 | }
100 | 
101 | .pl-mb /* markup.bold */ {
102 |   color: #333;
103 |   font-weight: bold;
104 | }
105 | 
106 | .pl-md /* markup.deleted, meta.diff.header.from-file */ {
107 |   background-color: #ffecec;
108 |   color: #bd2c00;
109 | }
110 | 
111 | .pl-mi1 /* markup.inserted, meta.diff.header.to-file */ {
112 |   background-color: #eaffea;
113 |   color: #55a532;
114 | }
115 | 
116 | .pl-mdr /* meta.diff.range */ {
117 |   color: #795da3;
118 |   font-weight: bold;
119 | }
120 | 
121 | .pl-mo /* meta.output */ {
122 |   color: #1d3e81;
123 | }
124 | 
125 | 


--------------------------------------------------------------------------------
/docs/stylesheets/stylesheet.css:
--------------------------------------------------------------------------------
  1 | * {
  2 |   box-sizing: border-box; }
  3 | 
  4 | body {
  5 |   padding: 0;
  6 |   margin: 0;
  7 |   font-family: "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;
  8 |   font-size: 16px;
  9 |   line-height: 1.5;
 10 |   color: #606c71; }
 11 | 
 12 | a {
 13 |   color: #1e6bb8;
 14 |   text-decoration: none; }
 15 |   a:hover {
 16 |     text-decoration: underline; }
 17 | 
 18 | .btn {
 19 |   display: inline-block;
 20 |   margin-bottom: 1rem;
 21 |   color: rgba(255, 255, 255, 0.7);
 22 |   background-color: rgba(255, 255, 255, 0.08);
 23 |   border-color: rgba(255, 255, 255, 0.2);
 24 |   border-style: solid;
 25 |   border-width: 1px;
 26 |   border-radius: 0.3rem;
 27 |   transition: color 0.2s, background-color 0.2s, border-color 0.2s; }
 28 |   .btn + .btn {
 29 |     margin-left: 1rem; }
 30 | 
 31 | .btn:hover {
 32 |   color: rgba(255, 255, 255, 0.8);
 33 |   text-decoration: none;
 34 |   background-color: rgba(255, 255, 255, 0.2);
 35 |   border-color: rgba(255, 255, 255, 0.3); }
 36 | 
 37 | .btn-dark {
 38 |   color: rgba(50, 50, 50, 0.7);
 39 |   background-color: rgba(50, 50, 50, 0.08);
 40 |   border-color: rgba(50, 50, 50, 0.2); }
 41 | 
 42 | .btn-dark:hover {
 43 |   color: rgba(50, 50, 50, 0.8);
 44 |   background-color: rgba(50, 50, 50, 0.2);
 45 |   border-color: rgba(50, 50, 50, 0.3); }
 46 | 
 47 | @media screen and (min-width: 64em) {
 48 |   .btn {
 49 |     padding: 0.75rem 1rem; } }
 50 | 
 51 | @media screen and (min-width: 42em) and (max-width: 64em) {
 52 |   .btn {
 53 |     padding: 0.6rem 0.9rem;
 54 |     font-size: 0.9rem; } }
 55 | 
 56 | @media screen and (max-width: 42em) {
 57 |   .btn {
 58 |     display: block;
 59 |     width: 100%;
 60 |     padding: 0.75rem;
 61 |     font-size: 0.9rem; }
 62 |     .btn + .btn {
 63 |       margin-top: 1rem;
 64 |       margin-left: 0; } }
 65 | 
 66 | .page-header {
 67 |   color: #fff;
 68 |   text-align: center;
 69 |   background-color: #2C7575;
 70 |   background-image: linear-gradient(120deg, #023463, #149454); }
 71 | 
 72 | @media screen and (min-width: 64em) {
 73 |   .page-header {
 74 |     padding: 5rem 6rem; } }
 75 | 
 76 | @media screen and (min-width: 42em) and (max-width: 64em) {
 77 |   .page-header {
 78 |     padding: 3rem 4rem; } }
 79 | 
 80 | @media screen and (max-width: 42em) {
 81 |   .page-header {
 82 |     padding: 2rem 1rem; } }
 83 | 
 84 | .project-name {
 85 |   margin-top: 0;
 86 |   margin-bottom: 0.1rem; }
 87 | 
 88 | @media screen and (min-width: 64em) {
 89 |   .project-name {
 90 |     font-size: 3.25rem; } }
 91 | 
 92 | @media screen and (min-width: 42em) and (max-width: 64em) {
 93 |   .project-name {
 94 |     font-size: 2.25rem; } }
 95 | 
 96 | @media screen and (max-width: 42em) {
 97 |   .project-name {
 98 |     font-size: 1.75rem; } }
 99 | 
100 | .project-tagline {
101 |   margin-bottom: 2rem;
102 |   font-weight: normal;
103 |   opacity: 0.7; }
104 | 
105 | @media screen and (min-width: 64em) {
106 |   .project-tagline {
107 |     font-size: 1.25rem; } }
108 | 
109 | @media screen and (min-width: 42em) and (max-width: 64em) {
110 |   .project-tagline {
111 |     font-size: 1.15rem; } }
112 | 
113 | @media screen and (max-width: 42em) {
114 |   .project-tagline {
115 |     font-size: 1rem; } }
116 | 
117 | .main-content :first-child {
118 |   margin-top: 0; }
119 | .main-content img {
120 |   max-width: 100%; }
121 | .main-content h1, .main-content h2, .main-content h3, .main-content h4, .main-content h5, .main-content h6 {
122 |   margin-top: 2rem;
123 |   margin-bottom: 1rem;
124 |   font-weight: normal;
125 |   color: #159957; }
126 | .main-content p {
127 |   margin-bottom: 1em; }
128 | .main-content code {
129 |   padding: 2px 4px;
130 |   font-family: Consolas, "Liberation Mono", Menlo, Courier, monospace;
131 |   font-size: 0.9rem;
132 |   color: #383e41;
133 |   background-color: #f3f6fa;
134 |   border-radius: 0.3rem; }
135 | .main-content pre {
136 |   padding: 0.8rem;
137 |   margin-top: 0;
138 |   margin-bottom: 1rem;
139 |   font: 1rem Consolas, "Liberation Mono", Menlo, Courier, monospace;
140 |   color: #567482;
141 |   word-wrap: normal;
142 |   background-color: #f3f6fa;
143 |   border: solid 1px #dce6f0;
144 |   border-radius: 0.3rem; }
145 |   .main-content pre > code {
146 |     padding: 0;
147 |     margin: 0;
148 |     font-size: 0.9rem;
149 |     color: #567482;
150 |     word-break: normal;
151 |     white-space: pre;
152 |     background: transparent;
153 |     border: 0; }
154 | .main-content .highlight {
155 |   margin-bottom: 1rem; }
156 |   .main-content .highlight pre {
157 |     margin-bottom: 0;
158 |     word-break: normal; }
159 | .main-content .highlight pre, .main-content pre {
160 |   padding: 0.8rem;
161 |   overflow: auto;
162 |   font-size: 0.9rem;
163 |   line-height: 1.45;
164 |   border-radius: 0.3rem; }
165 | .main-content pre code, .main-content pre tt {
166 |   display: inline;
167 |   max-width: initial;
168 |   padding: 0;
169 |   margin: 0;
170 |   overflow: initial;
171 |   line-height: inherit;
172 |   word-wrap: normal;
173 |   background-color: transparent;
174 |   border: 0; }
175 |   .main-content pre code:before, .main-content pre code:after, .main-content pre tt:before, .main-content pre tt:after {
176 |     content: normal; }
177 | .main-content ul, .main-content ol {
178 |   margin-top: 0; }
179 | .main-content blockquote {
180 |   padding: 0 1rem;
181 |   margin-left: 0;
182 |   color: #819198;
183 |   border-left: 0.3rem solid #dce6f0; }
184 |   .main-content blockquote > :first-child {
185 |     margin-top: 0; }
186 |   .main-content blockquote > :last-child {
187 |     margin-bottom: 0; }
188 | .main-content table {
189 |   display: block;
190 |   width: 100%;
191 |   overflow: auto;
192 |   word-break: normal;
193 |   word-break: keep-all; }
194 |   .main-content table th {
195 |     font-weight: bold; }
196 |   .main-content table th, .main-content table td {
197 |     padding: 0.5rem 1rem;
198 |     border: 1px solid #e9ebec; }
199 | .main-content dl {
200 |   padding: 0; }
201 |   .main-content dl dt {
202 |     padding: 0;
203 |     margin-top: 1rem;
204 |     font-size: 1rem;
205 |     font-weight: bold; }
206 |   .main-content dl dd {
207 |     padding: 0;
208 |     margin-bottom: 1rem; }
209 | .main-content hr {
210 |   height: 2px;
211 |   padding: 0;
212 |   margin: 1rem 0;
213 |   background-color: #eff0f1;
214 |   border: 0; }
215 | 
216 | @media screen and (min-width: 64em) {
217 |   .main-content {
218 |     max-width: 64rem;
219 |     padding: 2rem 6rem;
220 |     margin: 0 auto;
221 |     font-size: 1.1rem; } }
222 | 
223 | @media screen and (min-width: 42em) and (max-width: 64em) {
224 |   .main-content {
225 |     padding: 2rem 4rem;
226 |     font-size: 1.1rem; } }
227 | 
228 | @media screen and (max-width: 42em) {
229 |   .main-content {
230 |     padding: 2rem 1rem;
231 |     font-size: 1rem; } }
232 | 
233 | .site-footer {
234 |   padding-top: 2rem;
235 |   margin-top: 2rem;
236 |   border-top: solid 1px #eff0f1; }
237 | 
238 | .site-footer-owner {
239 |   display: block;
240 |   font-weight: bold; }
241 | 
242 | .site-footer-credits {
243 |   font-size: 0.8em;
244 |   color: #819198; }
245 | 
246 | @media screen and (min-width: 64em) {
247 |   .site-footer {
248 |     font-size: 1rem; } }
249 | 
250 | @media screen and (min-width: 42em) and (max-width: 64em) {
251 |   .site-footer {
252 |     font-size: 1rem; } }
253 | 
254 | @media screen and (max-width: 42em) {
255 |   .site-footer {
256 |     font-size: 0.9rem; } }
257 | 


--------------------------------------------------------------------------------
/docs/index.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html lang="en-us">
  3 |   <head>
  4 |     <meta charset="UTF-8">
  5 |     <title>React-console by astralarya</title>
  6 |     <meta name="viewport" content="width=device-width, initial-scale=1">
  7 |     <link rel="stylesheet" type="text/css" href="stylesheets/normalize.css" media="screen">
  8 |     <link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
  9 |     <link rel="stylesheet" type="text/css" href="stylesheets/stylesheet.css" media="screen">
 10 |     <link rel="stylesheet" type="text/css" href="stylesheets/github-light.css" media="screen">
 11 |     <link rel="stylesheet" type="text/css" href="example/dist/react-console.example.css" media="screen">
 12 |   </head>
 13 |   <body>
 14 |     <section class="page-header">
 15 |       <h1 class="project-name">React-console</h1>
 16 |       <h2 class="project-tagline">Simple react console emulator</h2>
 17 |       <a href="https://github.com/astralarya/react-console" class="btn">View on GitHub</a>
 18 |       <a href="https://github.com/astralarya/react-console/zipball/master" class="btn">Download .zip</a>
 19 |       <a href="https://github.com/astralarya/react-console/tarball/master" class="btn">Download .tar.gz</a>
 20 |     </section>
 21 | 
 22 |     <section class="main-content">
 23 |       <h1>
 24 | <a id="react-console" class="anchor" href="#react-console" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>react-console</h1>
 25 | 
 26 | <p>Simple React.js console emulator.</p>
 27 | 
 28 | <div id="console"></div>
 29 | <script src="example/dist/react-console.example.js"></script>
 30 | <script>
 31 | Example.init(document.getElementById("console"));
 32 | </script>
 33 | 
 34 | <p><a href="https://github.com/astralarya/react-console/tree/master/docs/example" class="btn btn-dark">Code</a></p>
 35 | 
 36 | <h2>
 37 | <a id="example" class="anchor" href="#example" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example</h2>
 38 | 
 39 | <p>Simple prompt that echoes back input:</p>
 40 | 
 41 | <div class="highlight highlight-source-js"><pre><span class="pl-k">let</span> EchoConsole <span class="pl-k">=</span> <span class="pl-smi">React</span>.<span class="pl-en">createClass</span>({
 42 |     <span class="pl-en">echo</span><span class="pl-k">:</span> <span class="pl-k">function</span>(<span class="pl-smi">text</span>) {
 43 |         <span class="pl-v">this</span>.<span class="pl-smi">refs</span>.<span class="pl-smi">console</span>.<span class="pl-en">log</span>(text);
 44 |         <span class="pl-v">this</span>.<span class="pl-smi">refs</span>.<span class="pl-smi">console</span>.<span class="pl-en">return</span>();
 45 |     },
 46 |     <span class="pl-en">render</span><span class="pl-k">:</span> <span class="pl-k">function</span>() {
 47 |         <span class="pl-k">return</span> <span class="pl-k">&lt;</span>Console ref<span class="pl-k">=</span><span class="pl-s"><span class="pl-pds">"</span>console<span class="pl-pds">"</span></span>
 48 |             handler<span class="pl-k">=</span>{<span class="pl-v">this</span>.<span class="pl-smi">echo</span>}
 49 |             autofocus<span class="pl-k">=</span>{<span class="pl-c1">true</span>}
 50 |         <span class="pl-k">/</span><span class="pl-k">&gt;</span>;
 51 |     }
 52 | });</pre></div>
 53 | 
 54 | <p>See the <a href="https://github.com/astralarya/react-console/tree/master/docs/example">example project</a> used in the live demo.</p>
 55 | 
 56 | <h2>
 57 | <a id="installation" class="anchor" href="#installation" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Installation</h2>
 58 | 
 59 | <pre><code>npm install --save-dev react-console-component
 60 | </code></pre>
 61 | 
 62 | <h2>
 63 | <a id="features" class="anchor" href="#features" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Features</h2>
 64 | 
 65 | <ul>
 66 | <li>Readline emulation</li>
 67 | <li>Mobile friendly</li>
 68 | <li>Input Method Editor (IME) support</li>
 69 | </ul>
 70 | 
 71 | <h2>
 72 | <a id="props" class="anchor" href="#props" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Props</h2>
 73 | 
 74 | <p>Properties you can pass to the console element</p>
 75 | 
 76 | <table>
 77 | <thead>
 78 | <tr>
 79 | <th>Prop</th>
 80 | <th>Type</th>
 81 | <th>Description</th>
 82 | </tr>
 83 | </thead>
 84 | <tbody>
 85 | <tr>
 86 | <td>autofocus?</td>
 87 | <td>bool</td>
 88 | <td>Autofocus the console on component mount.</td>
 89 | </tr>
 90 | <tr>
 91 | <td>cancel?</td>
 92 | <td>()=&gt;any</td>
 93 | <td>Function that should stop execution of the current command and call <code>this.return()</code>.</td>
 94 | </tr>
 95 | <tr>
 96 | <td>complete?</td>
 97 | <td>(words: string[], cursor: number, prompt: string)=&gt;string[]</td>
 98 | <td>Return a list of possible completions given a list of (<code>words</code>), index of the word containing the cursor (<code>cursor</code>) , and the full prompt text (<code>prompt</code>).</td>
 99 | </tr>
100 | <tr>
101 | <td>continue?</td>
102 | <td>(prompt: string)=&gt;bool</td>
103 | <td>Return a boolean indicating whether to continue asking for user input on a newline given the current prompt text (<code>prompt</code>).</td>
104 | </tr>
105 | <tr>
106 | <td>handler</td>
107 | <td>(command: string)=&gt;any</td>
108 | <td>Handle a command (<code>command</code>), logging data with <code>this.log()</code> or <code>this.logX()</code>, and calling <code>this.return()</code> when finished.</td>
109 | </tr>
110 | <tr>
111 | <td>promptLabel?</td>
112 | <td>string | ()=&gt;string</td>
113 | <td>String or function that generates a string displayed to prompt user for input.</td>
114 | </tr>
115 | <tr>
116 | <td>welcomeMessage?</td>
117 | <td>string</td>
118 | <td>Initial message displayed after mount.</td>
119 | </tr>
120 | </tbody>
121 | </table>
122 | 
123 | <h2>
124 | <a id="public-members" class="anchor" href="#public-members" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Public members</h2>
125 | 
126 | <table>
127 | <thead>
128 | <tr>
129 | <th>Member</th>
130 | <th>Type</th>
131 | <th>Description</th>
132 | </tr>
133 | </thead>
134 | <tbody>
135 | <tr>
136 | <td>log</td>
137 | <td>(...messages: any)=&gt;void</td>
138 | <td>Log messages to the console. If string, print the value, otherwise, print the JSON value of the message.</td>
139 | </tr>
140 | <tr>
141 | <td>logX</td>
142 | <td>(type: string, ...messages: any)=&gt;void</td>
143 | <td>Log messages of a particular type to the console. The messages will be given the class <code>react-console-message-{type}</code>.</td>
144 | </tr>
145 | <tr>
146 | <td>return</td>
147 | <td>()=&gt;void</td>
148 | <td>Signal the current command has finished and a new prompt should be displayed.</td>
149 | </tr>
150 | </tbody>
151 | </table>
152 | 
153 | <h2>
154 | <a id="Awknowledgements" class="anchor" href="#awknowledgements" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Awknoledgements</h2>
155 | 
156 | <p>React-console is inspired by <a href="https://github.com/chrisdone/jquery-console">chrisdone/jquery-console</a>.</p>
157 | 
158 |       <footer class="site-footer">
159 |         <span class="site-footer-owner"><a href="https://github.com/astralarya/react-console">React-console</a> is maintained by <a href="https://github.com/astralarya">astralarya</a>.</span>
160 | 
161 |         <span class="site-footer-credits">This page was generated in part by <a href="https://pages.github.com">GitHub Pages</a> using the <a href="https://github.com/jasonlong/cayman-theme">Cayman theme</a> by <a href="https://twitter.com/jasonlong">Jason Long</a>.</span>
162 |       </footer>
163 | 
164 |     </section>
165 | 
166 |   </body>
167 | </html>
168 | 


--------------------------------------------------------------------------------
/test/test.tsx:
--------------------------------------------------------------------------------
  1 | 'use strict';
  2 | 
  3 | import * as React from 'react';
  4 | import { assert, expect } from 'chai';
  5 | import * as enzyme from 'enzyme';
  6 | 
  7 | import {
  8 | 	ConsolePrompt,
  9 | 	ConsoleMessage,
 10 | 	default as Console
 11 | } from 'exports?ConsolePrompt&ConsoleMessage!../src/react-console.tsx';
 12 | 
 13 | 
 14 | describe('<ConsolePrompt />', function() {
 15 | 	describe('[Property] point: ', function () {
 16 | 		it('Has no cursor when point is not passed', function() {
 17 | 			var wrapper = enzyme.shallow(<ConsolePrompt />);
 18 | 			expect((wrapper.instance() as ConsolePrompt).child.cursor).not.exist;
 19 | 			expect(wrapper.find('.react-console-cursor')).length(0);
 20 | 		});
 21 | 		it('Has cursor when point is >= 0', function() {
 22 | 			var wrapper = enzyme.shallow(<ConsolePrompt point={0}/>);
 23 | 			expect(wrapper.find('.react-console-cursor')).length(1);
 24 | 		});
 25 | 	});
 26 | 	describe('[Property] value: ', function () {
 27 | 		it('`.react-console-prompt` has text \'foo\' when value=\'foo\'', function() {
 28 | 			var wrapper = enzyme.shallow(<ConsolePrompt value='foo'/>);
 29 | 			expect(wrapper.find('.react-console-prompt').text()).equals('foo');
 30 | 		});
 31 | 		it('`.react-console-prompt` has text \'bar\' and `.react-console-cursor` has text \'b\' when value=\'bar\' and point=0', function() {
 32 | 			var wrapper = enzyme.shallow(<ConsolePrompt value='bar' point={0}/>);
 33 | 			expect(wrapper.find('.react-console-prompt').text()).equals('bar');
 34 | 			expect(wrapper.find('.react-console-cursor').text()).equals('b');
 35 | 		});
 36 | 		it('`.react-console-prompt` has text \'bar\' and `.react-console-cursor` has text \'a\' when value=\'bar\' and point=1', function() {
 37 | 			var wrapper = enzyme.shallow(<ConsolePrompt value='bar' point={1}/>);
 38 | 			expect(wrapper.find('.react-console-prompt').text()).equals('bar');
 39 | 			expect(wrapper.find('.react-console-cursor').text()).equals('a');
 40 | 		});
 41 | 		it('`.react-console-prompt` has text \'bar\' and `.react-console-cursor` has text \'r\' when value=\'bar\' and point=2', function() {
 42 | 			var wrapper = enzyme.shallow(<ConsolePrompt value='bar' point={2}/>);
 43 | 			expect(wrapper.find('.react-console-prompt').text()).equals('bar');
 44 | 			expect(wrapper.find('.react-console-cursor').text()).equals('r');
 45 | 		});
 46 | 	});
 47 | 	describe('[Property] label: ', function () {
 48 | 		it('`.react-console-prompt-label` has text \'foo\' when label=\'foo\'', function() {
 49 | 			var wrapper = enzyme.shallow(<ConsolePrompt label='foo'/>);
 50 | 			expect(wrapper.find('.react-console-prompt-label').text()).equals('foo');
 51 | 		});
 52 | 	});
 53 | 	describe('[Property] argument: ', function () {
 54 | 		it('`.react-console-prompt-argument` has text \'foo\' when argument=\'foo\'', function() {
 55 | 			var wrapper = enzyme.shallow(<ConsolePrompt argument='foo'/>);
 56 | 			expect(wrapper.find('.react-console-prompt-argument').text()).equals('foo');
 57 | 		});
 58 | 		it('`.react-console-prompt-label` has text \'\' when label=\'foo\' and `.react-console-prompt-argument` has text \'bar\' when argument=\'bar\'', function() {
 59 | 			var wrapper = enzyme.shallow(<ConsolePrompt label='foo' argument='bar'/>);
 60 | 			expect(wrapper.find('.react-console-prompt-label').text()).equals('');
 61 | 			expect(wrapper.find('.react-console-prompt-argument').text()).equals('bar');
 62 | 		});
 63 | 		it('`.react-console-prompt-label` has text \'foo\\n\' when label=\'foo\\nbar\' and `.react-console-prompt-argument` has text \'baz\' when argument=\'baz\'', function() {
 64 | 			var wrapper = enzyme.mount(<ConsolePrompt label='foo\nbar' argument='baz'/>);
 65 | 			expect(wrapper.find('.react-console-prompt-label').text()).equals('foo\n');
 66 | 			expect(wrapper.find('.react-console-prompt-argument').text()).equals('baz');
 67 | 		});
 68 | 	});
 69 | 	describe('[Style] idle: ', function () {
 70 | 		it('Is not idle right after mount', function() {
 71 | 			var wrapper = enzyme.shallow(<ConsolePrompt point={0}/>);
 72 | 			expect(wrapper.find('.react-console-cursor-idle')).length(0);
 73 | 		});
 74 | 		it('Is idle after 1 second', function(done) {
 75 | 			var wrapper = enzyme.mount(<ConsolePrompt point={0}/>);
 76 | 			window.setTimeout( () => {
 77 | 				expect(wrapper.find('.react-console-cursor-idle')).length(1);
 78 | 				done();
 79 | 			}, 1100);
 80 | 		});
 81 | 	});
 82 | });
 83 | 
 84 | describe('<ConsoleMessage />', function() {
 85 | 	describe('[Property] type: ', function () {
 86 | 		it('Has class `react-console-message` when type=null', function() {
 87 | 			var wrapper = enzyme.shallow(<ConsoleMessage />);
 88 | 			assert(wrapper.hasClass('react-console-message'), 'Missing class `react-console-message`');
 89 | 		});
 90 | 		it('Has class `react-console-message react-console-message-foo` when type=\'foo\'', function() {
 91 | 			var wrapper = enzyme.shallow(<ConsoleMessage type='foo'/>);
 92 | 			assert(wrapper.hasClass('react-console-message-foo'), 'Missing class `react-console-message-foo`');
 93 | 			assert(wrapper.hasClass('react-console-message'), 'Missing class `react-console-message`');
 94 | 		});
 95 | 	});
 96 | 	describe('[Property] value: ', function () {
 97 | 		it('Text == \'ababa\' when value={[\'ababa\']}', function() {
 98 | 			var wrapper = enzyme.shallow(<ConsoleMessage value={['ababa']}/>);
 99 | 			assert(wrapper.text() == 'ababa', 'Text does not equal \'ababa\'');
100 | 		});
101 | 		it('Text == \'a\\nb\\nc\' when value={[\'a\',\'b\',\'c\']}', function() {
102 | 			var wrapper = enzyme.mount(<ConsoleMessage value={['a','b','c']}/>);
103 | 			assert(wrapper.text() == 'a\nb\nc', 'Text does not equal \'a\\nb\\nc\'');
104 | 		});
105 | 		it('Text == JSON.stringify(value) when value={[[\'a\',\'b\',\'c\',1,2,3]]}', function() {
106 | 			var wrapper = enzyme.shallow(<ConsoleMessage value={[['a','b','c',1,2,3]]}/>);
107 | 			assert(wrapper.text() == JSON.stringify(['a','b','c',1,2,3]), 'Text does not equal JSON.stringify(value)');
108 | 		});
109 | 		it('Text == JSON.stringify(value) when value={[{a:1,b:2,c:[3,4,5]}]}', function() {
110 | 			var wrapper = enzyme.shallow(<ConsoleMessage value={[{a:1,b:2,c:[3,4,5]}]}/>);
111 | 			assert(wrapper.text() == JSON.stringify({a:1,b:2,c:[3,4,5]}), 'Text does not equal JSON.stringify(value)');
112 | 		});
113 | 	});
114 | });
115 | 
116 | describe('<Console />', function() {
117 | 	describe('[Property] autofocus: ', function () {
118 | 		it('Has class `react-console-nofocus` until clicked when autofocus is undefined', function() {
119 | 			var wrapper = enzyme.mount(<Console />);
120 | 			expect(wrapper.find('.react-console-nofocus')).length(1);
121 | 			expect(wrapper.find('.react-console-focus')).length(0);
122 | 			wrapper.simulate('click');
123 | 			expect(wrapper.find('.react-console-focus')).length(1);
124 | 			expect(wrapper.find('.react-console-nofocus')).length(0);
125 | 		});
126 | 		it('Has class `react-console-focus` on mount when autofocus=true', function() {
127 | 			var wrapper = enzyme.mount(<Console autofocus={true}/>);
128 | 			expect(wrapper.find('.react-console-focus')).length(1);
129 | 			expect(wrapper.find('.react-console-nofocus')).length(0);
130 | 		});
131 | 	});
132 | 	describe('[Property] handler: ', function () {
133 | 		it('Recieves input value', function(done) {
134 | 			function handler(command: string) {
135 | 				expect(command).equals('ababa');
136 | 				done();
137 | 			}
138 | 			var wrapper = enzyme.mount(<Console handler={handler}/>);
139 | 			var typer = wrapper.find('.react-console-typer');
140 | 			(typer.get(0) as HTMLTextAreaElement).value = 'ababa';
141 | 			typer.simulate('change');
142 | 			typer.simulate('keyDown', { keyCode: 13 /* Return */ });
143 | 			/*
144 | 			wrapper.setState({promptText: 'ababa'});
145 | 			var instance = wrapper.instance() as Console;
146 | 			instance.acceptLine();
147 | 			*/
148 | 		});
149 | 	});
150 | 	describe('[Property] promptLabel: ', function () {
151 | 		it('Has label \'> \' when promptLabel undefined', function() {
152 | 			var wrapper = enzyme.mount(<Console />);
153 | 			expect(wrapper.find('.react-console-prompt-label').text()).equals('> ');
154 | 		});
155 | 		it('Has label \'ababa: \' when promptLabel=\'ababa:\' ', function() {
156 | 			var wrapper = enzyme.mount(<Console promptLabel='ababa: '/>);
157 | 			expect(wrapper.find('.react-console-prompt-label').text()).equals('ababa: ');
158 | 		});
159 | 		it('Calls function when passed as promptLabel and uses returned values as labels', function() {
160 | 			var count = 0;
161 | 			function counter() {
162 | 				return count++;
163 | 			}
164 | 			var wrapper = enzyme.mount(<Console promptLabel={counter}/>);
165 | 			var typer = wrapper.find('.react-console-typer');
166 | 			typer.simulate('keyDown', { keyCode: 13 /* Return */ });
167 | 			typer.simulate('keyDown', { keyCode: 13 /* Return */ });
168 | 			typer.simulate('keyDown', { keyCode: 13 /* Return */ });
169 | 			var labels = wrapper.find('.react-console-prompt-label');
170 | 			expect(labels).length(4);
171 | 			expect(count).equals(4);
172 | 			expect(labels.at(0).text()).equals('0');
173 | 			expect(labels.at(1).text()).equals('1');
174 | 			expect(labels.at(2).text()).equals('2');
175 | 			expect(labels.at(3).text()).equals('3');
176 | 		});
177 | 	});
178 | 	describe('[Property] welcomeMessage: ', function () {
179 | 		it('Doesn\'t have class `react-console-welcome` when welcomeMessage undefined', function() {
180 | 			var wrapper = enzyme.shallow(<Console />);
181 | 			expect(wrapper.find('.react-console-message')).length(0);
182 | 		});
183 | 		it('Has div `react-console-welcome` with text()=\'foo\' when welcomeMessage=\'foo\'', function() {
184 | 			var wrapper = enzyme.shallow(<Console welcomeMessage='foo'/>);
185 | 			var welcome = wrapper.find('.react-console-welcome');
186 | 			expect(welcome).length(1);
187 | 			expect(welcome.text()).equal('foo')
188 | 		});
189 | 	});
190 | });
191 | 


--------------------------------------------------------------------------------
/docs/stylesheets/normalize.css:
--------------------------------------------------------------------------------
  1 | /*! normalize.css v3.0.2 | MIT License | git.io/normalize */
  2 | 
  3 | /**
  4 |  * 1. Set default font family to sans-serif.
  5 |  * 2. Prevent iOS text size adjust after orientation change, without disabling
  6 |  *    user zoom.
  7 |  */
  8 | 
  9 | html {
 10 |   font-family: sans-serif; /* 1 */
 11 |   -ms-text-size-adjust: 100%; /* 2 */
 12 |   -webkit-text-size-adjust: 100%; /* 2 */
 13 | }
 14 | 
 15 | /**
 16 |  * Remove default margin.
 17 |  */
 18 | 
 19 | body {
 20 |   margin: 0;
 21 | }
 22 | 
 23 | /* HTML5 display definitions
 24 |    ========================================================================== */
 25 | 
 26 | /**
 27 |  * Correct `block` display not defined for any HTML5 element in IE 8/9.
 28 |  * Correct `block` display not defined for `details` or `summary` in IE 10/11
 29 |  * and Firefox.
 30 |  * Correct `block` display not defined for `main` in IE 11.
 31 |  */
 32 | 
 33 | article,
 34 | aside,
 35 | details,
 36 | figcaption,
 37 | figure,
 38 | footer,
 39 | header,
 40 | hgroup,
 41 | main,
 42 | menu,
 43 | nav,
 44 | section,
 45 | summary {
 46 |   display: block;
 47 | }
 48 | 
 49 | /**
 50 |  * 1. Correct `inline-block` display not defined in IE 8/9.
 51 |  * 2. Normalize vertical alignment of `progress` in Chrome, Firefox, and Opera.
 52 |  */
 53 | 
 54 | audio,
 55 | canvas,
 56 | progress,
 57 | video {
 58 |   display: inline-block; /* 1 */
 59 |   vertical-align: baseline; /* 2 */
 60 | }
 61 | 
 62 | /**
 63 |  * Prevent modern browsers from displaying `audio` without controls.
 64 |  * Remove excess height in iOS 5 devices.
 65 |  */
 66 | 
 67 | audio:not([controls]) {
 68 |   display: none;
 69 |   height: 0;
 70 | }
 71 | 
 72 | /**
 73 |  * Address `[hidden]` styling not present in IE 8/9/10.
 74 |  * Hide the `template` element in IE 8/9/11, Safari, and Firefox < 22.
 75 |  */
 76 | 
 77 | [hidden],
 78 | template {
 79 |   display: none;
 80 | }
 81 | 
 82 | /* Links
 83 |    ========================================================================== */
 84 | 
 85 | /**
 86 |  * Remove the gray background color from active links in IE 10.
 87 |  */
 88 | 
 89 | a {
 90 |   background-color: transparent;
 91 | }
 92 | 
 93 | /**
 94 |  * Improve readability when focused and also mouse hovered in all browsers.
 95 |  */
 96 | 
 97 | a:active,
 98 | a:hover {
 99 |   outline: 0;
100 | }
101 | 
102 | /* Text-level semantics
103 |    ========================================================================== */
104 | 
105 | /**
106 |  * Address styling not present in IE 8/9/10/11, Safari, and Chrome.
107 |  */
108 | 
109 | abbr[title] {
110 |   border-bottom: 1px dotted;
111 | }
112 | 
113 | /**
114 |  * Address style set to `bolder` in Firefox 4+, Safari, and Chrome.
115 |  */
116 | 
117 | b,
118 | strong {
119 |   font-weight: bold;
120 | }
121 | 
122 | /**
123 |  * Address styling not present in Safari and Chrome.
124 |  */
125 | 
126 | dfn {
127 |   font-style: italic;
128 | }
129 | 
130 | /**
131 |  * Address variable `h1` font-size and margin within `section` and `article`
132 |  * contexts in Firefox 4+, Safari, and Chrome.
133 |  */
134 | 
135 | h1 {
136 |   font-size: 2em;
137 |   margin: 0.67em 0;
138 | }
139 | 
140 | /**
141 |  * Address styling not present in IE 8/9.
142 |  */
143 | 
144 | mark {
145 |   background: #ff0;
146 |   color: #000;
147 | }
148 | 
149 | /**
150 |  * Address inconsistent and variable font size in all browsers.
151 |  */
152 | 
153 | small {
154 |   font-size: 80%;
155 | }
156 | 
157 | /**
158 |  * Prevent `sub` and `sup` affecting `line-height` in all browsers.
159 |  */
160 | 
161 | sub,
162 | sup {
163 |   font-size: 75%;
164 |   line-height: 0;
165 |   position: relative;
166 |   vertical-align: baseline;
167 | }
168 | 
169 | sup {
170 |   top: -0.5em;
171 | }
172 | 
173 | sub {
174 |   bottom: -0.25em;
175 | }
176 | 
177 | /* Embedded content
178 |    ========================================================================== */
179 | 
180 | /**
181 |  * Remove border when inside `a` element in IE 8/9/10.
182 |  */
183 | 
184 | img {
185 |   border: 0;
186 | }
187 | 
188 | /**
189 |  * Correct overflow not hidden in IE 9/10/11.
190 |  */
191 | 
192 | svg:not(:root) {
193 |   overflow: hidden;
194 | }
195 | 
196 | /* Grouping content
197 |    ========================================================================== */
198 | 
199 | /**
200 |  * Address margin not present in IE 8/9 and Safari.
201 |  */
202 | 
203 | figure {
204 |   margin: 1em 40px;
205 | }
206 | 
207 | /**
208 |  * Address differences between Firefox and other browsers.
209 |  */
210 | 
211 | hr {
212 |   box-sizing: content-box;
213 |   height: 0;
214 | }
215 | 
216 | /**
217 |  * Contain overflow in all browsers.
218 |  */
219 | 
220 | pre {
221 |   overflow: auto;
222 | }
223 | 
224 | /**
225 |  * Address odd `em`-unit font size rendering in all browsers.
226 |  */
227 | 
228 | code,
229 | kbd,
230 | pre,
231 | samp {
232 |   font-family: monospace, monospace;
233 |   font-size: 1em;
234 | }
235 | 
236 | /* Forms
237 |    ========================================================================== */
238 | 
239 | /**
240 |  * Known limitation: by default, Chrome and Safari on OS X allow very limited
241 |  * styling of `select`, unless a `border` property is set.
242 |  */
243 | 
244 | /**
245 |  * 1. Correct color not being inherited.
246 |  *    Known issue: affects color of disabled elements.
247 |  * 2. Correct font properties not being inherited.
248 |  * 3. Address margins set differently in Firefox 4+, Safari, and Chrome.
249 |  */
250 | 
251 | button,
252 | input,
253 | optgroup,
254 | select,
255 | textarea {
256 |   color: inherit; /* 1 */
257 |   font: inherit; /* 2 */
258 |   margin: 0; /* 3 */
259 | }
260 | 
261 | /**
262 |  * Address `overflow` set to `hidden` in IE 8/9/10/11.
263 |  */
264 | 
265 | button {
266 |   overflow: visible;
267 | }
268 | 
269 | /**
270 |  * Address inconsistent `text-transform` inheritance for `button` and `select`.
271 |  * All other form control elements do not inherit `text-transform` values.
272 |  * Correct `button` style inheritance in Firefox, IE 8/9/10/11, and Opera.
273 |  * Correct `select` style inheritance in Firefox.
274 |  */
275 | 
276 | button,
277 | select {
278 |   text-transform: none;
279 | }
280 | 
281 | /**
282 |  * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio`
283 |  *    and `video` controls.
284 |  * 2. Correct inability to style clickable `input` types in iOS.
285 |  * 3. Improve usability and consistency of cursor style between image-type
286 |  *    `input` and others.
287 |  */
288 | 
289 | button,
290 | html input[type="button"], /* 1 */
291 | input[type="reset"],
292 | input[type="submit"] {
293 |   -webkit-appearance: button; /* 2 */
294 |   cursor: pointer; /* 3 */
295 | }
296 | 
297 | /**
298 |  * Re-set default cursor for disabled elements.
299 |  */
300 | 
301 | button[disabled],
302 | html input[disabled] {
303 |   cursor: default;
304 | }
305 | 
306 | /**
307 |  * Remove inner padding and border in Firefox 4+.
308 |  */
309 | 
310 | button::-moz-focus-inner,
311 | input::-moz-focus-inner {
312 |   border: 0;
313 |   padding: 0;
314 | }
315 | 
316 | /**
317 |  * Address Firefox 4+ setting `line-height` on `input` using `!important` in
318 |  * the UA stylesheet.
319 |  */
320 | 
321 | input {
322 |   line-height: normal;
323 | }
324 | 
325 | /**
326 |  * It's recommended that you don't attempt to style these elements.
327 |  * Firefox's implementation doesn't respect box-sizing, padding, or width.
328 |  *
329 |  * 1. Address box sizing set to `content-box` in IE 8/9/10.
330 |  * 2. Remove excess padding in IE 8/9/10.
331 |  */
332 | 
333 | input[type="checkbox"],
334 | input[type="radio"] {
335 |   box-sizing: border-box; /* 1 */
336 |   padding: 0; /* 2 */
337 | }
338 | 
339 | /**
340 |  * Fix the cursor style for Chrome's increment/decrement buttons. For certain
341 |  * `font-size` values of the `input`, it causes the cursor style of the
342 |  * decrement button to change from `default` to `text`.
343 |  */
344 | 
345 | input[type="number"]::-webkit-inner-spin-button,
346 | input[type="number"]::-webkit-outer-spin-button {
347 |   height: auto;
348 | }
349 | 
350 | /**
351 |  * 1. Address `appearance` set to `searchfield` in Safari and Chrome.
352 |  * 2. Address `box-sizing` set to `border-box` in Safari and Chrome
353 |  *    (include `-moz` to future-proof).
354 |  */
355 | 
356 | input[type="search"] {
357 |   -webkit-appearance: textfield; /* 1 */ /* 2 */
358 |   box-sizing: content-box;
359 | }
360 | 
361 | /**
362 |  * Remove inner padding and search cancel button in Safari and Chrome on OS X.
363 |  * Safari (but not Chrome) clips the cancel button when the search input has
364 |  * padding (and `textfield` appearance).
365 |  */
366 | 
367 | input[type="search"]::-webkit-search-cancel-button,
368 | input[type="search"]::-webkit-search-decoration {
369 |   -webkit-appearance: none;
370 | }
371 | 
372 | /**
373 |  * Define consistent border, margin, and padding.
374 |  */
375 | 
376 | fieldset {
377 |   border: 1px solid #c0c0c0;
378 |   margin: 0 2px;
379 |   padding: 0.35em 0.625em 0.75em;
380 | }
381 | 
382 | /**
383 |  * 1. Correct `color` not being inherited in IE 8/9/10/11.
384 |  * 2. Remove padding so people aren't caught out if they zero out fieldsets.
385 |  */
386 | 
387 | legend {
388 |   border: 0; /* 1 */
389 |   padding: 0; /* 2 */
390 | }
391 | 
392 | /**
393 |  * Remove default vertical scrollbar in IE 8/9/10/11.
394 |  */
395 | 
396 | textarea {
397 |   overflow: auto;
398 | }
399 | 
400 | /**
401 |  * Don't inherit the `font-weight` (applied by a rule above).
402 |  * NOTE: the default cannot safely be changed in Chrome and Safari on OS X.
403 |  */
404 | 
405 | optgroup {
406 |   font-weight: bold;
407 | }
408 | 
409 | /* Tables
410 |    ========================================================================== */
411 | 
412 | /**
413 |  * Remove most spacing between table cells.
414 |  */
415 | 
416 | table {
417 |   border-collapse: collapse;
418 |   border-spacing: 0;
419 | }
420 | 
421 | td,
422 | th {
423 |   padding: 0;
424 | }
425 | 


--------------------------------------------------------------------------------
/src/react-console.tsx:
--------------------------------------------------------------------------------
   1 | "use strict";
   2 | 
   3 | import * as React from 'react';
   4 | import * as ReactDOM from 'react-dom';
   5 | import './react-console.scss';
   6 | 
   7 | interface ConsolePromptProps {
   8 | 	point?: number;
   9 | 	value: string;
  10 | 	label: string;
  11 | 	argument?: string;
  12 | }
  13 | class ConsolePrompt extends React.Component<ConsolePromptProps,{}> {
  14 | 	static defaultProps: ConsolePromptProps = {
  15 | 		point: -1,
  16 | 		value: "",
  17 | 		label: "> ",
  18 | 		argument: null,
  19 | 	}
  20 | 	child: {
  21 | 		cursor?: Element;
  22 | 	} = {};
  23 | 	// Component Lifecycle
  24 | 	componentDidMount() {
  25 | 		this.idle();
  26 | 	}
  27 | 	componentDidUpdate() {
  28 | 		this.idle();
  29 | 	}
  30 | 	// DOM Management
  31 | 	updateSemaphore: number = 0;
  32 | 	idle() {
  33 | 		// Blink cursor when idle
  34 | 		if(this.child.cursor) {
  35 | 			if(this.updateSemaphore == 0) {
  36 | 				this.child.cursor.className = "react-console-cursor";
  37 | 			}
  38 | 			this.updateSemaphore++;
  39 | 			window.setTimeout( () => {
  40 | 				this.updateSemaphore--;
  41 | 				if(this.updateSemaphore == 0 && this.child.cursor) {
  42 | 					this.child.cursor.className = "react-console-cursor react-console-cursor-idle";
  43 | 				}
  44 | 			}, 1000);
  45 | 		}
  46 | 	}
  47 | 	renderValue() {
  48 | 		if(this.props.point < 0) {
  49 | 			return [this.props.value];
  50 | 		} else if (this.props.point == this.props.value.length) {
  51 | 			return [this.props.value,<span ref={ref => this.child.cursor = ref} key="cursor" className="react-console-cursor">&nbsp;</span>];
  52 | 		} else {
  53 | 			return [this.props.value.substring(0,this.props.point),
  54 | 				<span ref={ref => this.child.cursor = ref} key="cursor" className="react-console-cursor">{this.props.value.substring(this.props.point,this.props.point+1)}</span>,
  55 | 				this.props.value.substring(this.props.point+1)];
  56 | 		}
  57 | 	}
  58 | 	render() {
  59 | 		let label = this.props.label;
  60 | 		if(this.props.argument) {
  61 | 			let idx = label.lastIndexOf("\n");
  62 | 			if(idx >= 0) {
  63 | 				label = label.substring(0, idx+1);
  64 | 			} else {
  65 | 				label = '';
  66 | 			}
  67 | 		}
  68 | 		return <div className="react-console-prompt-box">
  69 | 			<span className="react-console-prompt-label">{ label }</span>
  70 | 			<span className="react-console-prompt-argument">{ this.props.argument }</span>
  71 | 			<span className="react-console-prompt">{ this.renderValue() }</span>
  72 | 		</div>;
  73 | 	}
  74 | }
  75 | 
  76 | interface ConsoleMessageProps {
  77 | 	type?: string;
  78 | 	value: any[];
  79 | }
  80 | let ConsoleMessage: React.SFC<ConsoleMessageProps> = function(props: ConsoleMessageProps) {
  81 | 	return <div className={"react-console-message" + (props.type?" react-console-message-"+props.type:"")}>
  82 | 		{props.value.map((val: any)=>{
  83 | 			if(typeof val == 'string') {
  84 | 				return val;
  85 | 			} else {
  86 | 				return JSON.stringify(val);
  87 | 			}
  88 | 		}).join("\n")}
  89 | 	</div>;
  90 | }
  91 | ConsoleMessage.defaultProps = {
  92 | 	type: null,
  93 | 	value: [],
  94 | }
  95 | 
  96 | export interface LogMessage {
  97 | 	type?: string;
  98 | 	value: any[];
  99 | }
 100 | export interface LogEntry {
 101 | 	label: string;
 102 | 	command: string;
 103 | 	message: LogMessage[];
 104 | }
 105 | 
 106 | export interface ConsoleProps{
 107 | 	handler: (command: string)=>any;
 108 | 	cancel?: ()=>any;
 109 | 	complete?: (words: string[], curr: number, promptText: string)=>string[];
 110 | 	continue?: (promptText: string)=>boolean;
 111 | 	autofocus?: boolean;
 112 | 	promptLabel?: string | (()=>string);
 113 | 	welcomeMessage?: string;
 114 | }
 115 | export const enum ConsoleCommand {
 116 | 	Default,
 117 | 	Search,
 118 | 	Kill,
 119 | 	Yank,
 120 | };
 121 | export const enum SearchDirection {
 122 | 	Reverse,
 123 | 	Forward,
 124 | }
 125 | export interface ConsoleState{
 126 | 	focus?: boolean;
 127 | 	acceptInput?: boolean;
 128 | 	typer?: string;
 129 | 	point?: number;
 130 | 	currLabel?: string;
 131 | 	promptText?: string;
 132 | 	restoreText?: string;
 133 | 	searchText?: string;
 134 | 	searchDirection?: SearchDirection;
 135 | 	searchInit?: boolean;
 136 | 	log?: LogEntry[];
 137 | 	history?: string[];
 138 | 	historyn?: number;
 139 | 	kill?: string[];
 140 | 	killn?: number;
 141 | 	argument?: string;
 142 | 	lastCommand?: ConsoleCommand;
 143 | };
 144 | export default class extends React.Component<ConsoleProps,ConsoleState> {
 145 | 	constructor(props: ConsoleProps) {
 146 | 		super(props);
 147 | 		this.state = {
 148 | 			focus: false,
 149 | 			acceptInput: true,
 150 | 			typer: '',
 151 | 			point: 0,
 152 | 			currLabel: this.nextLabel(),
 153 | 			promptText: '',
 154 | 			restoreText: '',
 155 | 			searchText: '',
 156 | 			searchDirection: null,
 157 | 			searchInit: false,
 158 | 			log: [],
 159 | 			history: [],
 160 | 			historyn: 0,
 161 | 			kill: [],
 162 | 			killn: 0,
 163 | 			argument: null,
 164 | 			lastCommand: ConsoleCommand.Default,
 165 | 		};
 166 | 	}
 167 | 	static defaultProps = {
 168 | 		promptLabel: '> ',
 169 | 		continue: function() { return false; },
 170 | 		cancel: function() {},
 171 | 	};
 172 | 	child: {
 173 | 		typer?: HTMLTextAreaElement;
 174 | 		container?: HTMLElement;
 175 | 		focus?: HTMLElement;
 176 | 	} = {};
 177 | 	// Command API
 178 | 	log = (...messages: any[]) => {
 179 | 		let log = this.state.log;
 180 | 		log[this.state.log.length-1].message.push({value: messages});
 181 | 		this.setState({
 182 | 			log: log,
 183 | 		}, this.scrollIfBottom() );
 184 | 	}
 185 | 	logX = (type: string, ...messages: any[]) => {
 186 | 		let log = this.state.log;
 187 | 		log[this.state.log.length-1].message.push({type: type, value: messages});
 188 | 		this.setState({
 189 | 			log: log,
 190 | 		}, this.scrollIfBottom() );
 191 | 	}
 192 | 	return = () => {
 193 | 		this.setState({
 194 | 			acceptInput: true,
 195 | 			currLabel: this.nextLabel(),
 196 | 		}, this.scrollIfBottom() );
 197 | 	}
 198 | 	// Component Lifecycle
 199 | 	componentDidMount() {
 200 | 		if(this.props.autofocus) {
 201 | 			this.focus();
 202 | 		}
 203 | 	}
 204 | 	// Event Handlers
 205 | 	focus = () => {
 206 | 		if(!window.getSelection().toString()) {
 207 | 			this.child.typer.focus();
 208 | 			this.setState({ focus: true }, this.scrollToBottom );
 209 | 		}
 210 | 	}
 211 | 	blur = () => {
 212 | 		this.setState({ focus: false });
 213 | 	}
 214 | 	keyDown = (e: KeyboardEvent) => {
 215 | 		interface keyMap {
 216 | 			[key: number]: ()=>void
 217 | 		}
 218 | 		let keyCodes: keyMap = {
 219 | 			// return
 220 | 			13: this.acceptLine,
 221 | 			// left
 222 | 			37: this.backwardChar,
 223 | 			// right
 224 | 			39: this.forwardChar,
 225 | 			// up
 226 | 			38: this.previousHistory,
 227 | 			// down
 228 | 			40: this.nextHistory,
 229 | 			// backspace
 230 | 			8:  this.backwardDeleteChar,
 231 | 			// delete
 232 | 			46: this.deleteChar,
 233 | 			// end
 234 | 			35: this.endOfLine,
 235 | 			// start
 236 | 			36: this.beginningOfLine,
 237 | 			// tab
 238 | 			9: this.complete,
 239 | 			// esc
 240 | 			27: this.prefixMeta,
 241 | 		};
 242 | 		var ctrlCodes: keyMap = {
 243 | 			// C-a
 244 | 			65: this.beginningOfLine,
 245 | 			// C-e
 246 | 			69: this.endOfLine,
 247 | 			// C-f
 248 | 			70: this.forwardChar,
 249 | 			// C-b
 250 | 			66: this.backwardChar,
 251 | 			// C-l TODO
 252 | 			//76: this.clearScreen,
 253 | 			// C-p
 254 | 			80: this.previousHistory,
 255 | 			// C-n
 256 | 			78: this.nextHistory,
 257 | 			// C-r
 258 | 			82: this.reverseSearchHistory,
 259 | 			// C-s
 260 | 			83: this.forwardSearchHistory,
 261 | 			// C-d
 262 | 			68: this.deleteChar, // TODO EOF
 263 | 			// C-q TODO
 264 | 			//81: this.quotedInsert,
 265 | 			// C-v TODO
 266 | 			//86: this.quotedInsert,
 267 | 			// C-t TODO
 268 | 			//84: this.transposeChars,
 269 | 			// C-k
 270 | 			75: this.killLine,
 271 | 			// C-u
 272 | 			85: this.backwardKillLine,
 273 | 			// C-y TODO
 274 | 			89: this.yank,
 275 | 			// C-c
 276 | 			67: this.cancelCommand,
 277 | 			// C-w TODO
 278 | 			//87: this.killPreviousWhitespace,
 279 | 			// C-] TODO
 280 | 			//221: this.characterSearch,
 281 | 			// C-x TODO
 282 | 			//88: this.prefixCtrlX,
 283 | 		};
 284 | 		var ctrlXCodes: keyMap = { // TODO state
 285 | 			// C-x Rubout
 286 | 			8: this.backwardKillLine,
 287 | 			// C-x ( TODO
 288 | 			//57: this.startKbdMacro,
 289 | 			// C-x ) TODO
 290 | 			//48: this.endKbdMacro,
 291 | 			// C-x e TODO
 292 | 			//69: this.callLastKbdMacro,
 293 | 			// C-x C-u TODO
 294 | 			//85: this.undo,
 295 | 			// C-x C-x TODO
 296 | 			//88: this.exchangePointAndMark,
 297 | 		};
 298 | 		var ctrlShiftCodes: keyMap = {
 299 | 			// C-_ TODO
 300 | 			//189: this.undo,
 301 | 			// C-@ TODO
 302 | 			//50: this.setMark,
 303 | 		};
 304 | 		var metaCodes: keyMap = {
 305 | 			// M-f
 306 | 			70: this.forwardWord,
 307 | 			// M-b
 308 | 			66: this.backwardWord,
 309 | 			// M-p
 310 | 			80: this.nonIncrementalReverseSearchHistory,
 311 | 			// M-n
 312 | 			78: this.nonIncrementalForwardSearchHistory,
 313 | 			// M-.
 314 | 			190: this.yankLastArg,
 315 | 			// M-TAB TODO
 316 | 			//9: this.tabInsert,
 317 | 			// M-t TODO
 318 | 			//84: this.transposeWords,
 319 | 			// M-u TODO
 320 | 			//85: this.upcaseWord,
 321 | 			// M-l TODO
 322 | 			//76: this.downcaseWord,
 323 | 			// M-c TODO
 324 | 			//67: this.capitalizeWord,
 325 | 			// M-d
 326 | 			68: this.killWord,
 327 | 			// M-backspace
 328 | 			8: this.backwardKillWord,
 329 | 			// M-w TODO
 330 | 			//87: this.unixWordRubout,
 331 | 			// M-\ TODO
 332 | 			//220: this.deleteHorizontalSpace,
 333 | 			// M-y
 334 | 			89: this.yankPop,
 335 | 			// M-0 TODO
 336 | 			//48: () => this.digitArgument(0),
 337 | 			// M-1 TODO
 338 | 			//49: () => this.digitArgument(1),
 339 | 			// M-2 TODO
 340 | 			//50: () => this.digitArgument(2),
 341 | 			// M-3 TODO
 342 | 			//51: () => this.digitArgument(3),
 343 | 			// M-4 TODO
 344 | 			//52: () => this.digitArgument(4),
 345 | 			// M-5 TODO
 346 | 			//53: () => this.digitArgument(5),
 347 | 			// M-6 TODO
 348 | 			//54: () => this.digitArgument(6),
 349 | 			// M-7 TODO
 350 | 			//55: () => this.digitArgument(7),
 351 | 			// M-8 TODO
 352 | 			//56: () => this.digitArgument(8),
 353 | 			// M-9 TODO
 354 | 			//57: () => this.digitArgument(9),
 355 | 			// M-- TODO
 356 | 			//189: () => this.digitArgument('-'),
 357 | 			// M-f TODO
 358 | 			//71: () => this.abort,
 359 | 			// M-r TODO
 360 | 			//82: this.revertLine,
 361 | 			// M-SPACE TODO
 362 | 			//32: this.setMark,
 363 | 		};
 364 | 		var metaShiftCodes: keyMap = { // TODO hook in
 365 | 			// M-<
 366 | 			188: this.beginningOfHistory,
 367 | 			// M->
 368 | 			190: this.endOfHistory,
 369 | 			// M-_
 370 | 			189: this.yankLastArg,
 371 | 			// M-? TODO
 372 | 			//191: this.possibleCompletions,
 373 | 			// M-* TODO
 374 | 			//56: this.insertCompletions,
 375 | 		}
 376 | 		var metaCtrlCodes: keyMap = {
 377 | 			// M-C-y
 378 | 			89: this.yankNthArg,
 379 | 			// M-C-] TODO
 380 | 			//221: this.characterSearchBackward,
 381 | 			// M-C-j TODO !!!
 382 | 			//74: this.viEditingMode,
 383 | 		};
 384 | 		if(this.state.acceptInput) {
 385 | 			if (e.altKey) {
 386 | 				if (e.ctrlKey) {
 387 | 					if (e.keyCode in metaCtrlCodes) {
 388 | 						metaCtrlCodes[e.keyCode]();
 389 | 						e.preventDefault();
 390 | 					}
 391 | 				} else if (e.shiftKey) {
 392 | 					if (e.keyCode in metaShiftCodes) {
 393 | 						metaShiftCodes[e.keyCode]();
 394 | 						e.preventDefault();
 395 | 					}
 396 | 				} else if (e.keyCode in metaCodes) {
 397 | 					metaCodes[e.keyCode]();
 398 | 					e.preventDefault();
 399 | 				}
 400 | 				e.preventDefault();
 401 | 			} else if (e.ctrlKey) {
 402 | 				if (e.keyCode in ctrlCodes) {
 403 | 					ctrlCodes[e.keyCode]();
 404 | 					e.preventDefault();
 405 | 				}
 406 | 				e.preventDefault();
 407 | 			} else if (e.keyCode in keyCodes) {
 408 | 				keyCodes[e.keyCode]();
 409 | 				e.preventDefault();
 410 | 			}
 411 | 		}
 412 | 	}
 413 | 	change = () => {
 414 | 		let idx = 0;
 415 | 		for(;idx < this.state.typer.length && idx < this.child.typer.value.length; idx++) {
 416 | 			if(this.state.typer[idx] != this.child.typer.value[idx]) {
 417 | 				break;
 418 | 			}
 419 | 		}
 420 | 		let insert = this.child.typer.value.substring(idx);
 421 | 		let replace = this.state.typer.length - idx;
 422 | 		if(this.state.lastCommand == ConsoleCommand.Search) {
 423 | 			this.setState({
 424 | 				searchText: this.state.searchInit?insert:this.textInsert(insert, this.state.searchText, replace),
 425 | 				typer: this.child.typer.value,
 426 | 			}, this.triggerSearch );
 427 | 		} else {
 428 | 			this.setState(Object.assign(
 429 | 				this.consoleInsert(insert, replace),{
 430 | 					typer: this.child.typer.value,
 431 | 					lastCommand: ConsoleCommand.Default,
 432 | 				}), this.scrollToBottom
 433 | 			);
 434 | 		}
 435 | 	}
 436 | 	paste = (e: ClipboardEvent) => {
 437 | 		let insert = e.clipboardData.getData('text');
 438 | 		if(this.state.lastCommand == ConsoleCommand.Search) {
 439 | 			this.setState({
 440 | 				searchText: this.state.searchInit?insert:this.textInsert(insert, this.state.searchText),
 441 | 				typer: this.child.typer.value,
 442 | 			}, this.triggerSearch );
 443 | 		} else {
 444 | 			this.setState(Object.assign(
 445 | 				this.consoleInsert(insert),{
 446 | 					lastCommand: ConsoleCommand.Default,
 447 | 				}), this.scrollToBottom
 448 | 			);
 449 | 		}
 450 | 		e.preventDefault();
 451 | 	}
 452 | 	// Commands for Moving
 453 | 	beginningOfLine = () => {
 454 | 		this.setState({
 455 | 			point: 0,
 456 | 			argument: null,
 457 | 			lastCommand: ConsoleCommand.Default,
 458 | 		}, this.scrollToBottom);
 459 | 	}
 460 | 	endOfLine = () => {
 461 | 		this.setState({
 462 | 			point: this.state.promptText.length,
 463 | 			argument: null,
 464 | 			lastCommand: ConsoleCommand.Default,
 465 | 		}, this.scrollToBottom);
 466 | 	}
 467 | 	forwardChar = () => {
 468 | 		this.setState({
 469 | 			point: this.movePoint(1),
 470 | 			argument: null,
 471 | 			lastCommand: ConsoleCommand.Default,
 472 | 		}, this.scrollToBottom);
 473 | 	}
 474 | 	backwardChar = () => {
 475 | 		this.setState({
 476 | 			point: this.movePoint(-1),
 477 | 			argument: null,
 478 | 			lastCommand: ConsoleCommand.Default,
 479 | 		}, this.scrollToBottom);
 480 | 	}
 481 | 	forwardWord = () => {
 482 | 		this.setState({
 483 | 			point: this.nextWord(),
 484 | 			argument: null,
 485 | 			lastCommand: ConsoleCommand.Default,
 486 | 		}, this.scrollToBottom);
 487 | 	}
 488 | 	backwardWord = () => {
 489 | 		this.setState({
 490 | 			point: this.previousWord(),
 491 | 			argument: null,
 492 | 			lastCommand: ConsoleCommand.Default,
 493 | 		}, this.scrollToBottom);
 494 | 	}
 495 | 	// Commands for Manipulating the History
 496 | 	acceptLine = () => {
 497 | 		this.child.typer.value = "";
 498 | 		if(this.props.continue(this.state.promptText)) {
 499 | 			this.setState(Object.assign(
 500 | 				this.consoleInsert("\n"),{
 501 | 					typer: "",
 502 | 					lastCommand: ConsoleCommand.Default,
 503 | 				}), this.scrollToBottom
 504 | 			);
 505 | 		} else {
 506 | 			let command = this.state.promptText;
 507 | 			let history = this.state.history;
 508 | 			let log = this.state.log;
 509 | 			if(!history || history[history.length-1] != command) {
 510 | 				history.push(command);
 511 | 			}
 512 | 			log.push({
 513 | 				label: this.state.currLabel,
 514 | 				command: command,
 515 | 				message: []
 516 | 			});
 517 | 			this.setState({
 518 | 				acceptInput: false,
 519 | 				typer: "",
 520 | 				point: 0,
 521 | 				promptText: "",
 522 | 				restoreText: "",
 523 | 				log: log,
 524 | 				history: history,
 525 | 				historyn: 0,
 526 | 				argument: null,
 527 | 				lastCommand: ConsoleCommand.Default,
 528 | 			}, () => {
 529 | 				this.scrollToBottom();
 530 | 				if(this.props.handler) {
 531 | 					this.props.handler(command)
 532 | 				} else {
 533 | 					this.return();
 534 | 				}
 535 | 			});
 536 | 		}
 537 | 	}
 538 | 	previousHistory = () => {
 539 | 		this.rotateHistory(-1);
 540 | 	}
 541 | 	nextHistory = () => {
 542 | 		this.rotateHistory(1);
 543 | 	}
 544 | 	beginningOfHistory = () => {
 545 | 		this.rotateHistory(-this.state.history.length);
 546 | 	}
 547 | 	endOfHistory = () => {
 548 | 		this.rotateHistory(this.state.history.length);
 549 | 	}
 550 | 	triggerSearch = () => {
 551 | 		if(this.state.searchDirection == SearchDirection.Reverse) {
 552 | 			this.reverseSearchHistory();
 553 | 		} else {
 554 | 			this.forwardSearchHistory();
 555 | 		}
 556 | 	}
 557 | 	reverseSearchHistory = () => {
 558 | 		if(this.state.lastCommand == ConsoleCommand.Search) {
 559 | 			this.setState(Object.assign(
 560 | 				this.searchHistory(SearchDirection.Reverse, true),{
 561 | 					argument: `(reverse-i-search)\`${this.state.searchText}': `,
 562 | 					lastCommand: ConsoleCommand.Search,
 563 | 				}), this.scrollToBottom
 564 | 			);
 565 | 		} else {
 566 | 			this.setState({
 567 | 				searchDirection: SearchDirection.Reverse,
 568 | 				searchInit: true,
 569 | 				argument: `(reverse-i-search)\`': `,
 570 | 				lastCommand: ConsoleCommand.Search,
 571 | 			}, this.scrollToBottom);
 572 | 		}
 573 | 	}
 574 | 	forwardSearchHistory = () => {
 575 | 		if(this.state.lastCommand == ConsoleCommand.Search) {
 576 | 			this.setState(Object.assign(
 577 | 				this.searchHistory(SearchDirection.Forward, true),{
 578 | 					argument: `(forward-i-search)\`${this.state.searchText}': `,
 579 | 					lastCommand: ConsoleCommand.Search,
 580 | 				}), this.scrollToBottom
 581 | 			);
 582 | 		} else {
 583 | 			this.setState({
 584 | 				searchDirection: SearchDirection.Forward,
 585 | 				searchInit: true,
 586 | 				argument: `(forward-i-search)\`': `,
 587 | 				lastCommand: ConsoleCommand.Search,
 588 | 			}, this.scrollToBottom);
 589 | 		}
 590 | 	}
 591 | 	nonIncrementalReverseSearchHistory = () => {
 592 | 		// TODO
 593 | 	}
 594 | 	nonIncrementalForwardSearchHistory = () => {
 595 | 		// TODO
 596 | 	}
 597 | 	historySearchBackward = () => {
 598 | 		// TODO
 599 | 	}
 600 | 	historySearchForward = () => {
 601 | 		// TODO
 602 | 	}
 603 | 	historySubstringSearchBackward = () => {
 604 | 		// TODO
 605 | 	}
 606 | 	historySubstringSearchForward = () => {
 607 | 		// TODO
 608 | 	}
 609 | 	yankNthArg = () => {
 610 | 		// TODO
 611 | 	}
 612 | 	yankLastArg = () => {
 613 | 		// TODO
 614 | 	}
 615 | 	// Commands for Changing Text
 616 | 	deleteChar = () => {
 617 | 		if(this.state.point < this.state.promptText.length) {
 618 | 			this.setState({
 619 | 				promptText: this.state.promptText.substring(0,this.state.point)
 620 | 					+ this.state.promptText.substring(this.state.point+1),
 621 | 				argument: null,
 622 | 				lastCommand: ConsoleCommand.Default,
 623 | 			}, this.scrollToBottom);
 624 | 		}
 625 | 	}
 626 | 	backwardDeleteChar = () => {
 627 | 		if(this.state.lastCommand == ConsoleCommand.Search) {
 628 | 			this.setState({
 629 | 				searchText: this.state.searchText.substring(0,this.state.searchText.length-1),
 630 | 				typer: this.child.typer.value,
 631 | 			}, this.triggerSearch );
 632 | 		} else if(this.state.point > 0) {
 633 | 			this.setState({
 634 | 				point: this.movePoint(-1),
 635 | 				promptText: this.state.promptText.substring(0,this.state.point-1)
 636 | 					+ this.state.promptText.substring(this.state.point),
 637 | 				argument: null,
 638 | 				lastCommand: ConsoleCommand.Default,
 639 | 			}, this.scrollToBottom);
 640 | 		}
 641 | 	}
 642 | 	// Killing and Yanking
 643 | 	killLine = () => {
 644 | 		let kill = this.state.kill;
 645 | 		if(this.state.lastCommand == ConsoleCommand.Kill) {
 646 | 			kill[0] = kill[0] + this.state.promptText.substring(this.state.point);
 647 | 		} else {
 648 | 			kill.unshift(this.state.promptText.substring(this.state.point));
 649 | 		}
 650 | 		this.setState({
 651 | 			promptText: this.state.promptText.substring(0,this.state.point),
 652 | 			kill: kill,
 653 | 			killn: 0,
 654 | 			argument: null,
 655 | 			lastCommand: ConsoleCommand.Kill,
 656 | 		}, this.scrollToBottom);
 657 | 	}
 658 | 	backwardKillLine = () => {
 659 | 		let kill = this.state.kill;
 660 | 		if(this.state.lastCommand == ConsoleCommand.Kill) {
 661 | 			kill[0] = this.state.promptText.substring(0,this.state.point) + kill[0];
 662 | 		} else {
 663 | 			kill.unshift(this.state.promptText.substring(0,this.state.point));
 664 | 		}
 665 | 		this.setState({
 666 | 			point: 0,
 667 | 			promptText: this.state.promptText.substring(this.state.point),
 668 | 			kill: kill,
 669 | 			killn: 0,
 670 | 			argument: null,
 671 | 			lastCommand: ConsoleCommand.Kill,
 672 | 		}, this.scrollToBottom);
 673 | 	}
 674 | 	killWholeLine = () => {
 675 | 		let kill = this.state.kill;
 676 | 		if(this.state.lastCommand == ConsoleCommand.Kill) {
 677 | 			kill[0] = this.state.promptText.substring(0,this.state.point)
 678 | 				+ kill[0] + this.state.promptText.substring(this.state.point);
 679 | 		} else {
 680 | 			kill.unshift(this.state.promptText);
 681 | 		}
 682 | 		this.setState({
 683 | 			point: 0,
 684 | 			promptText: '',
 685 | 			kill: kill,
 686 | 			killn: 0,
 687 | 			argument: null,
 688 | 			lastCommand: ConsoleCommand.Kill,
 689 | 		}, this.scrollToBottom);
 690 | 	}
 691 | 	killWord = () => {
 692 | 		let kill = this.state.kill;
 693 | 		if(this.state.lastCommand == ConsoleCommand.Kill) {
 694 | 			kill[0] = kill[0] + this.state.promptText.substring(this.state.point,this.nextWord());
 695 | 		} else {
 696 | 			kill.unshift(this.state.promptText.substring(this.state.point,this.nextWord()));
 697 | 		}
 698 | 		this.setState({
 699 | 			promptText: this.state.promptText.substring(0,this.state.point)
 700 | 				+ this.state.promptText.substring(this.nextWord()),
 701 | 			kill: kill,
 702 | 			killn: 0,
 703 | 			argument: null,
 704 | 			lastCommand: ConsoleCommand.Kill,
 705 | 		}, this.scrollToBottom);
 706 | 	}
 707 | 	backwardKillWord = () => {
 708 | 		let kill = this.state.kill;
 709 | 		if(this.state.lastCommand == ConsoleCommand.Kill) {
 710 | 			kill[0] = this.state.promptText.substring(this.previousWord(),this.state.point) + kill[0];
 711 | 		} else {
 712 | 			kill.unshift(this.state.promptText.substring(this.previousWord(),this.state.point));
 713 | 		}
 714 | 		this.setState({
 715 | 			point: this.previousWord(),
 716 | 			promptText: this.state.promptText.substring(0,this.previousWord())
 717 | 				+ this.state.promptText.substring(this.state.point),
 718 | 			kill: kill,
 719 | 			killn: 0,
 720 | 			argument: null,
 721 | 			lastCommand: ConsoleCommand.Kill,
 722 | 		}, this.scrollToBottom);
 723 | 	}
 724 | 	yank = () => {
 725 | 		this.setState(Object.assign(
 726 | 			this.consoleInsert(this.state.kill[this.state.killn]),{
 727 | 				lastCommand: ConsoleCommand.Yank,
 728 | 			}), this.scrollToBottom
 729 | 		);
 730 | 	}
 731 | 	yankPop = () => {
 732 | 		if(this.state.lastCommand == ConsoleCommand.Yank) {
 733 | 			let killn = this.rotateRing(1, this.state.killn, this.state.kill.length);
 734 | 			this.setState(Object.assign(
 735 | 				this.consoleInsert(this.state.kill[killn], this.state.kill[this.state.killn].length),{
 736 | 					killn: killn,
 737 | 					lastCommand: ConsoleCommand.Yank,
 738 | 				}), this.scrollToBottom
 739 | 			);
 740 | 		}
 741 | 	}
 742 | 	// Numeric Arguments
 743 | 	// Completing
 744 | 	complete = () => {
 745 | 		if(this.props.complete) {
 746 | 			// Split text and find current word
 747 | 			let words = this.state.promptText.split(" ");
 748 | 			let curr = 0;
 749 | 			let idx = words[0].length;
 750 | 			while(idx < this.state.point && curr + 1 < words.length) {
 751 | 				idx += words[++curr].length + 1;
 752 | 			}
 753 | 
 754 | 			let completions = this.props.complete(words, curr, this.state.promptText);
 755 | 			if(completions.length == 1) {
 756 | 				// Perform completion
 757 | 				words[curr] = completions[0];
 758 | 				let point = -1;
 759 | 				for(let i = 0; i <= curr; i++) {
 760 | 					point += words[i].length + 1;
 761 | 				}
 762 | 				this.setState({
 763 | 					point: point,
 764 | 					promptText: words.join(" "),
 765 | 					argument: null,
 766 | 					lastCommand: ConsoleCommand.Default,
 767 | 				}, this.scrollToBottom );
 768 | 			} else if (completions.length > 1) {
 769 | 				// show completions
 770 | 				let log = this.state.log;
 771 | 				log.push({
 772 | 					label: this.state.currLabel,
 773 | 					command: this.state.promptText,
 774 | 					message: [{
 775 | 						type: "completion",
 776 | 						value: [completions.join("\t")],
 777 | 					}]
 778 | 				});
 779 | 				this.setState({
 780 | 					currLabel: this.nextLabel(),
 781 | 					log: log,
 782 | 					argument: null,
 783 | 					lastCommand: ConsoleCommand.Default,
 784 | 				}, this.scrollToBottom );
 785 | 			}
 786 | 		}
 787 | 	}
 788 | 	// Keyboard Macros
 789 | 	// Miscellaneous
 790 | 	prefixMeta = () => {
 791 | 		if(this.state.lastCommand == ConsoleCommand.Search) {
 792 | 			this.setState({
 793 | 				argument: null,
 794 | 				lastCommand: ConsoleCommand.Default,
 795 | 			});
 796 | 		}
 797 | 		// TODO Meta prefixed state
 798 | 	}
 799 | 	cancelCommand = () => {
 800 | 		if(this.state.acceptInput) { // Typing command
 801 | 			this.child.typer.value = "";
 802 | 			let log = this.state.log;
 803 | 			log.push({
 804 | 				label: this.state.currLabel,
 805 | 				command: this.state.promptText,
 806 | 				message: []
 807 | 			});
 808 | 			this.setState({
 809 | 				typer: "",
 810 | 				point: 0,
 811 | 				promptText: "",
 812 | 				restoreText: "",
 813 | 				log: log,
 814 | 				historyn: 0,
 815 | 				argument: null,
 816 | 				lastCommand: ConsoleCommand.Default,
 817 | 			}, this.scrollToBottom);
 818 | 		} else { // command is executing, call handler
 819 | 			this.props.cancel();
 820 | 		}
 821 | 	}
 822 | 	// Helper functions
 823 | 	textInsert = (insert: string, text: string, replace: number = 0, point: number = text.length): string => {
 824 | 		return text.substring(0, point - replace) + insert + text.substring(point);
 825 | 	}
 826 | 	consoleInsert = (insert: string, replace: number = 0): ConsoleState => {
 827 | 		let promptText = this.textInsert(insert, this.state.promptText, replace, this.state.point);
 828 | 		return {
 829 | 			point: this.movePoint(insert.length - replace, insert.length - replace + this.state.promptText.length),
 830 | 			promptText: promptText,
 831 | 			restoreText: promptText,
 832 | 			argument: null,
 833 | 			lastCommand: ConsoleCommand.Default,
 834 | 		};
 835 | 	}
 836 | 	movePoint = (n: number, max: number = this.state.promptText.length) => {
 837 | 		let pos = this.state.point + n;
 838 | 		if (pos < 0) {
 839 | 			return 0;
 840 | 		} if (pos > max) {
 841 | 			return max;
 842 | 		} else {
 843 | 			return pos;
 844 | 		}
 845 | 	}
 846 | 	nextWord(): number {
 847 | 		// Find first alphanumeric char after first non-alphanumeric char
 848 | 		let search = /\W\w/.exec(this.state.promptText.substring(this.state.point));
 849 | 		if(search) {
 850 | 			return search.index + this.state.point + 1;
 851 | 		} else {
 852 | 			return this.state.promptText.length;
 853 | 		}
 854 | 	}
 855 | 	previousWord(): number {
 856 | 		// Find first non-alphanumeric char after first alphanumeric char in reverse
 857 | 		let search = /\W\w(?!.*\W\w)/.exec(this.state.promptText.substring(0,this.state.point-1));
 858 | 		if(search) {
 859 | 			return search.index + 1;
 860 | 		} else {
 861 | 			return 0;
 862 | 		}
 863 | 	}
 864 | 	rotateRing = (n: number, ringn: number, ring: number, circular: boolean = true): number => {
 865 | 		if(ring == 0) return 0;
 866 | 		if(circular) {
 867 | 			return (ring + (ringn + n) % ring) % ring;
 868 | 		} else {
 869 | 			ringn = ringn - n;
 870 | 			if(ringn < 0) {
 871 | 				return 0;
 872 | 			} else if (ringn >= ring) {
 873 | 				return ring;
 874 | 			} else {
 875 | 				return ringn;
 876 | 			}
 877 | 		}
 878 | 	}
 879 | 	rotateHistory = (n: number) => {
 880 | 		let historyn = this.rotateRing(n, this.state.historyn, this.state.history.length, false);
 881 | 		if(historyn == 0) {
 882 | 			this.setState({
 883 | 				point: this.state.restoreText.length,
 884 | 				promptText: this.state.restoreText,
 885 | 				historyn: historyn,
 886 | 				argument: null,
 887 | 				lastCommand: ConsoleCommand.Default,
 888 | 			}, this.scrollToBottom );
 889 | 		} else {
 890 | 			let promptText = this.state.history[this.state.history.length-historyn];
 891 | 			this.setState({
 892 | 				point: promptText.length,
 893 | 				promptText: promptText,
 894 | 				historyn: historyn,
 895 | 				argument: null,
 896 | 				lastCommand: ConsoleCommand.Default,
 897 | 			}, this.scrollToBottom );
 898 | 		}
 899 | 	}
 900 | 	searchHistory = (direction: SearchDirection = this.state.searchDirection, next: boolean = false): ConsoleState => {
 901 | 		let idx = this.state.historyn;
 902 | 		let inc = (direction == SearchDirection.Reverse)?1:-1;
 903 | 		if(next) {
 904 | 			idx = idx + inc;
 905 | 		}
 906 | 		for(;idx > 0 && idx <= this.state.history.length; idx = idx + inc) {
 907 | 			let entry = this.state.history[this.state.history.length-idx];
 908 | 			let point = entry.indexOf(this.state.searchText);
 909 | 			if(point > -1) {
 910 | 				return {
 911 | 					point: point,
 912 | 					promptText: entry,
 913 | 					searchDirection: direction,
 914 | 					searchInit: false,
 915 | 					historyn: idx,
 916 | 				};
 917 | 			}
 918 | 		}
 919 | 		return {
 920 | 			searchDirection: direction,
 921 | 			searchInit: false,
 922 | 		};
 923 | 	}
 924 | 	// DOM management
 925 | 	scrollSemaphore = 0;
 926 | 	scrollIfBottom = () => {
 927 | 		if(this.scrollSemaphore > 0 || this.child.container.scrollTop == this.child.container.scrollHeight - this.child.container.offsetHeight) {
 928 | 			this.scrollSemaphore++;
 929 | 			return this.scrollIfBottomTrue;
 930 | 		} else {
 931 | 			return null;
 932 | 		}
 933 | 	}
 934 | 	scrollIfBottomTrue = () => {
 935 | 		this.scrollToBottom();
 936 | 		this.scrollSemaphore--;
 937 | 	}
 938 | 	scrollToBottom = () => {
 939 | 		this.child.container.scrollTop = this.child.container.scrollHeight;
 940 | 		let rect = this.child.focus.getBoundingClientRect();
 941 | 		if(rect.top < 0 || rect.left < 0 ||
 942 | 			rect.bottom > (window.innerHeight || document.documentElement.clientHeight) ||
 943 | 			rect.right > (window.innerWidth || document.documentElement.clientWidth)
 944 | 		) { this.child.typer.scrollIntoView(false); }
 945 | 	}
 946 | 	nextLabel = () => {
 947 | 		if(typeof this.props.promptLabel === "string") {
 948 | 			return this.props.promptLabel as string;
 949 | 		} else {
 950 | 			return (this.props.promptLabel as ()=>string)();
 951 | 		}
 952 | 	}
 953 | 	render() {
 954 | 		return <div ref={ref => this.child.container = ref}
 955 | 				className={"react-console-container " + (this.state.focus?"react-console-focus":"react-console-nofocus")}
 956 | 				onClick={this.focus}
 957 | 			>
 958 | 			{this.props.welcomeMessage?
 959 | 				<div className="react-console-message react-console-welcome">
 960 | 					{this.props.welcomeMessage}
 961 | 				</div>
 962 | 				: null
 963 | 			}
 964 | 			{this.state.log.map( (val: LogEntry) => {
 965 | 				return [
 966 | 					<ConsolePrompt label={val.label} value={val.command} />,
 967 | 					...val.message.map( (val: LogMessage, idx: number) => {
 968 | 						return <ConsoleMessage key={idx} type={val.type} value={val.value} />;
 969 | 					})
 970 | 				];
 971 | 			})}
 972 | 			{this.state.acceptInput?
 973 | 				<ConsolePrompt
 974 | 					label={this.state.currLabel}
 975 | 					value={this.state.promptText}
 976 | 					point={this.state.point}
 977 | 					argument={this.state.argument}
 978 | 					/>
 979 | 				: null
 980 | 			}
 981 | 			<div style={{ overflow: "hidden", height: 1, width: 1 }}>
 982 | 				<textarea
 983 | 					ref={ref => this.child.typer = ref}
 984 | 					className="react-console-typer"
 985 | 					autoComplete="off"
 986 | 					autoCorrect="off"
 987 | 					autoCapitalize="off"
 988 | 					spellCheck="false"
 989 | 					style={{ outline: "none",
 990 | 						color: "transparent",
 991 | 						backgroundColor: "transparent",
 992 | 						border: "none",
 993 | 						resize: "none",
 994 | 						overflow: "hidden",
 995 | 					}}
 996 | 					onBlur={this.blur}
 997 | 					onKeyDown={this.keyDown}
 998 | 					onChange={this.change}
 999 | 					onPaste={this.paste}
1000 | 				></textarea>
1001 | 			</div>
1002 | 			<div ref={ref => this.child.focus = ref}>&nbsp;</div>
1003 | 		</div>;
1004 | 	}
1005 | }
1006 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                     GNU GENERAL PUBLIC LICENSE
  2 |                        Version 3, 29 June 2007
  3 | 
  4 |  Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
  5 |  Everyone is permitted to copy and distribute verbatim copies
  6 |  of this license document, but changing it is not allowed.
  7 | 
  8 |                             Preamble
  9 | 
 10 |   The GNU General Public License is a free, copyleft license for
 11 | software and other kinds of works.
 12 | 
 13 |   The licenses for most software and other practical works are designed
 14 | to take away your freedom to share and change the works.  By contrast,
 15 | the GNU General Public License is intended to guarantee your freedom to
 16 | share and change all versions of a program--to make sure it remains free
 17 | software for all its users.  We, the Free Software Foundation, use the
 18 | GNU General Public License for most of our software; it applies also to
 19 | any other work released this way by its authors.  You can apply it to
 20 | your programs, too.
 21 | 
 22 |   When we speak of free software, we are referring to freedom, not
 23 | price.  Our General Public Licenses are designed to make sure that you
 24 | have the freedom to distribute copies of free software (and charge for
 25 | them if you wish), that you receive source code or can get it if you
 26 | want it, that you can change the software or use pieces of it in new
 27 | free programs, and that you know you can do these things.
 28 | 
 29 |   To protect your rights, we need to prevent others from denying you
 30 | these rights or asking you to surrender the rights.  Therefore, you have
 31 | certain responsibilities if you distribute copies of the software, or if
 32 | you modify it: responsibilities to respect the freedom of others.
 33 | 
 34 |   For example, if you distribute copies of such a program, whether
 35 | gratis or for a fee, you must pass on to the recipients the same
 36 | freedoms that you received.  You must make sure that they, too, receive
 37 | or can get the source code.  And you must show them these terms so they
 38 | know their rights.
 39 | 
 40 |   Developers that use the GNU GPL protect your rights with two steps:
 41 | (1) assert copyright on the software, and (2) offer you this License
 42 | giving you legal permission to copy, distribute and/or modify it.
 43 | 
 44 |   For the developers' and authors' protection, the GPL clearly explains
 45 | that there is no warranty for this free software.  For both users' and
 46 | authors' sake, the GPL requires that modified versions be marked as
 47 | changed, so that their problems will not be attributed erroneously to
 48 | authors of previous versions.
 49 | 
 50 |   Some devices are designed to deny users access to install or run
 51 | modified versions of the software inside them, although the manufacturer
 52 | can do so.  This is fundamentally incompatible with the aim of
 53 | protecting users' freedom to change the software.  The systematic
 54 | pattern of such abuse occurs in the area of products for individuals to
 55 | use, which is precisely where it is most unacceptable.  Therefore, we
 56 | have designed this version of the GPL to prohibit the practice for those
 57 | products.  If such problems arise substantially in other domains, we
 58 | stand ready to extend this provision to those domains in future versions
 59 | of the GPL, as needed to protect the freedom of users.
 60 | 
 61 |   Finally, every program is threatened constantly by software patents.
 62 | States should not allow patents to restrict development and use of
 63 | software on general-purpose computers, but in those that do, we wish to
 64 | avoid the special danger that patents applied to a free program could
 65 | make it effectively proprietary.  To prevent this, the GPL assures that
 66 | patents cannot be used to render the program non-free.
 67 | 
 68 |   The precise terms and conditions for copying, distribution and
 69 | modification follow.
 70 | 
 71 |                        TERMS AND CONDITIONS
 72 | 
 73 |   0. Definitions.
 74 | 
 75 |   "This License" refers to version 3 of the GNU General Public License.
 76 | 
 77 |   "Copyright" also means copyright-like laws that apply to other kinds of
 78 | works, such as semiconductor masks.
 79 | 
 80 |   "The Program" refers to any copyrightable work licensed under this
 81 | License.  Each licensee is addressed as "you".  "Licensees" and
 82 | "recipients" may be individuals or organizations.
 83 | 
 84 |   To "modify" a work means to copy from or adapt all or part of the work
 85 | in a fashion requiring copyright permission, other than the making of an
 86 | exact copy.  The resulting work is called a "modified version" of the
 87 | earlier work or a work "based on" the earlier work.
 88 | 
 89 |   A "covered work" means either the unmodified Program or a work based
 90 | on the Program.
 91 | 
 92 |   To "propagate" a work means to do anything with it that, without
 93 | permission, would make you directly or secondarily liable for
 94 | infringement under applicable copyright law, except executing it on a
 95 | computer or modifying a private copy.  Propagation includes copying,
 96 | distribution (with or without modification), making available to the
 97 | public, and in some countries other activities as well.
 98 | 
 99 |   To "convey" a work means any kind of propagation that enables other
100 | parties to make or receive copies.  Mere interaction with a user through
101 | a computer network, with no transfer of a copy, is not conveying.
102 | 
103 |   An interactive user interface displays "Appropriate Legal Notices"
104 | to the extent that it includes a convenient and prominently visible
105 | feature that (1) displays an appropriate copyright notice, and (2)
106 | tells the user that there is no warranty for the work (except to the
107 | extent that warranties are provided), that licensees may convey the
108 | work under this License, and how to view a copy of this License.  If
109 | the interface presents a list of user commands or options, such as a
110 | menu, a prominent item in the list meets this criterion.
111 | 
112 |   1. Source Code.
113 | 
114 |   The "source code" for a work means the preferred form of the work
115 | for making modifications to it.  "Object code" means any non-source
116 | form of a work.
117 | 
118 |   A "Standard Interface" means an interface that either is an official
119 | standard defined by a recognized standards body, or, in the case of
120 | interfaces specified for a particular programming language, one that
121 | is widely used among developers working in that language.
122 | 
123 |   The "System Libraries" of an executable work include anything, other
124 | than the work as a whole, that (a) is included in the normal form of
125 | packaging a Major Component, but which is not part of that Major
126 | Component, and (b) serves only to enable use of the work with that
127 | Major Component, or to implement a Standard Interface for which an
128 | implementation is available to the public in source code form.  A
129 | "Major Component", in this context, means a major essential component
130 | (kernel, window system, and so on) of the specific operating system
131 | (if any) on which the executable work runs, or a compiler used to
132 | produce the work, or an object code interpreter used to run it.
133 | 
134 |   The "Corresponding Source" for a work in object code form means all
135 | the source code needed to generate, install, and (for an executable
136 | work) run the object code and to modify the work, including scripts to
137 | control those activities.  However, it does not include the work's
138 | System Libraries, or general-purpose tools or generally available free
139 | programs which are used unmodified in performing those activities but
140 | which are not part of the work.  For example, Corresponding Source
141 | includes interface definition files associated with source files for
142 | the work, and the source code for shared libraries and dynamically
143 | linked subprograms that the work is specifically designed to require,
144 | such as by intimate data communication or control flow between those
145 | subprograms and other parts of the work.
146 | 
147 |   The Corresponding Source need not include anything that users
148 | can regenerate automatically from other parts of the Corresponding
149 | Source.
150 | 
151 |   The Corresponding Source for a work in source code form is that
152 | same work.
153 | 
154 |   2. Basic Permissions.
155 | 
156 |   All rights granted under this License are granted for the term of
157 | copyright on the Program, and are irrevocable provided the stated
158 | conditions are met.  This License explicitly affirms your unlimited
159 | permission to run the unmodified Program.  The output from running a
160 | covered work is covered by this License only if the output, given its
161 | content, constitutes a covered work.  This License acknowledges your
162 | rights of fair use or other equivalent, as provided by copyright law.
163 | 
164 |   You may make, run and propagate covered works that you do not
165 | convey, without conditions so long as your license otherwise remains
166 | in force.  You may convey covered works to others for the sole purpose
167 | of having them make modifications exclusively for you, or provide you
168 | with facilities for running those works, provided that you comply with
169 | the terms of this License in conveying all material for which you do
170 | not control copyright.  Those thus making or running the covered works
171 | for you must do so exclusively on your behalf, under your direction
172 | and control, on terms that prohibit them from making any copies of
173 | your copyrighted material outside their relationship with you.
174 | 
175 |   Conveying under any other circumstances is permitted solely under
176 | the conditions stated below.  Sublicensing is not allowed; section 10
177 | makes it unnecessary.
178 | 
179 |   3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180 | 
181 |   No covered work shall be deemed part of an effective technological
182 | measure under any applicable law fulfilling obligations under article
183 | 11 of the WIPO copyright treaty adopted on 20 December 1996, or
184 | similar laws prohibiting or restricting circumvention of such
185 | measures.
186 | 
187 |   When you convey a covered work, you waive any legal power to forbid
188 | circumvention of technological measures to the extent such circumvention
189 | is effected by exercising rights under this License with respect to
190 | the covered work, and you disclaim any intention to limit operation or
191 | modification of the work as a means of enforcing, against the work's
192 | users, your or third parties' legal rights to forbid circumvention of
193 | technological measures.
194 | 
195 |   4. Conveying Verbatim Copies.
196 | 
197 |   You may convey verbatim copies of the Program's source code as you
198 | receive it, in any medium, provided that you conspicuously and
199 | appropriately publish on each copy an appropriate copyright notice;
200 | keep intact all notices stating that this License and any
201 | non-permissive terms added in accord with section 7 apply to the code;
202 | keep intact all notices of the absence of any warranty; and give all
203 | recipients a copy of this License along with the Program.
204 | 
205 |   You may charge any price or no price for each copy that you convey,
206 | and you may offer support or warranty protection for a fee.
207 | 
208 |   5. Conveying Modified Source Versions.
209 | 
210 |   You may convey a work based on the Program, or the modifications to
211 | produce it from the Program, in the form of source code under the
212 | terms of section 4, provided that you also meet all of these conditions:
213 | 
214 |     a) The work must carry prominent notices stating that you modified
215 |     it, and giving a relevant date.
216 | 
217 |     b) The work must carry prominent notices stating that it is
218 |     released under this License and any conditions added under section
219 |     7.  This requirement modifies the requirement in section 4 to
220 |     "keep intact all notices".
221 | 
222 |     c) You must license the entire work, as a whole, under this
223 |     License to anyone who comes into possession of a copy.  This
224 |     License will therefore apply, along with any applicable section 7
225 |     additional terms, to the whole of the work, and all its parts,
226 |     regardless of how they are packaged.  This License gives no
227 |     permission to license the work in any other way, but it does not
228 |     invalidate such permission if you have separately received it.
229 | 
230 |     d) If the work has interactive user interfaces, each must display
231 |     Appropriate Legal Notices; however, if the Program has interactive
232 |     interfaces that do not display Appropriate Legal Notices, your
233 |     work need not make them do so.
234 | 
235 |   A compilation of a covered work with other separate and independent
236 | works, which are not by their nature extensions of the covered work,
237 | and which are not combined with it such as to form a larger program,
238 | in or on a volume of a storage or distribution medium, is called an
239 | "aggregate" if the compilation and its resulting copyright are not
240 | used to limit the access or legal rights of the compilation's users
241 | beyond what the individual works permit.  Inclusion of a covered work
242 | in an aggregate does not cause this License to apply to the other
243 | parts of the aggregate.
244 | 
245 |   6. Conveying Non-Source Forms.
246 | 
247 |   You may convey a covered work in object code form under the terms
248 | of sections 4 and 5, provided that you also convey the
249 | machine-readable Corresponding Source under the terms of this License,
250 | in one of these ways:
251 | 
252 |     a) Convey the object code in, or embodied in, a physical product
253 |     (including a physical distribution medium), accompanied by the
254 |     Corresponding Source fixed on a durable physical medium
255 |     customarily used for software interchange.
256 | 
257 |     b) Convey the object code in, or embodied in, a physical product
258 |     (including a physical distribution medium), accompanied by a
259 |     written offer, valid for at least three years and valid for as
260 |     long as you offer spare parts or customer support for that product
261 |     model, to give anyone who possesses the object code either (1) a
262 |     copy of the Corresponding Source for all the software in the
263 |     product that is covered by this License, on a durable physical
264 |     medium customarily used for software interchange, for a price no
265 |     more than your reasonable cost of physically performing this
266 |     conveying of source, or (2) access to copy the
267 |     Corresponding Source from a network server at no charge.
268 | 
269 |     c) Convey individual copies of the object code with a copy of the
270 |     written offer to provide the Corresponding Source.  This
271 |     alternative is allowed only occasionally and noncommercially, and
272 |     only if you received the object code with such an offer, in accord
273 |     with subsection 6b.
274 | 
275 |     d) Convey the object code by offering access from a designated
276 |     place (gratis or for a charge), and offer equivalent access to the
277 |     Corresponding Source in the same way through the same place at no
278 |     further charge.  You need not require recipients to copy the
279 |     Corresponding Source along with the object code.  If the place to
280 |     copy the object code is a network server, the Corresponding Source
281 |     may be on a different server (operated by you or a third party)
282 |     that supports equivalent copying facilities, provided you maintain
283 |     clear directions next to the object code saying where to find the
284 |     Corresponding Source.  Regardless of what server hosts the
285 |     Corresponding Source, you remain obligated to ensure that it is
286 |     available for as long as needed to satisfy these requirements.
287 | 
288 |     e) Convey the object code using peer-to-peer transmission, provided
289 |     you inform other peers where the object code and Corresponding
290 |     Source of the work are being offered to the general public at no
291 |     charge under subsection 6d.
292 | 
293 |   A separable portion of the object code, whose source code is excluded
294 | from the Corresponding Source as a System Library, need not be
295 | included in conveying the object code work.
296 | 
297 |   A "User Product" is either (1) a "consumer product", which means any
298 | tangible personal property which is normally used for personal, family,
299 | or household purposes, or (2) anything designed or sold for incorporation
300 | into a dwelling.  In determining whether a product is a consumer product,
301 | doubtful cases shall be resolved in favor of coverage.  For a particular
302 | product received by a particular user, "normally used" refers to a
303 | typical or common use of that class of product, regardless of the status
304 | of the particular user or of the way in which the particular user
305 | actually uses, or expects or is expected to use, the product.  A product
306 | is a consumer product regardless of whether the product has substantial
307 | commercial, industrial or non-consumer uses, unless such uses represent
308 | the only significant mode of use of the product.
309 | 
310 |   "Installation Information" for a User Product means any methods,
311 | procedures, authorization keys, or other information required to install
312 | and execute modified versions of a covered work in that User Product from
313 | a modified version of its Corresponding Source.  The information must
314 | suffice to ensure that the continued functioning of the modified object
315 | code is in no case prevented or interfered with solely because
316 | modification has been made.
317 | 
318 |   If you convey an object code work under this section in, or with, or
319 | specifically for use in, a User Product, and the conveying occurs as
320 | part of a transaction in which the right of possession and use of the
321 | User Product is transferred to the recipient in perpetuity or for a
322 | fixed term (regardless of how the transaction is characterized), the
323 | Corresponding Source conveyed under this section must be accompanied
324 | by the Installation Information.  But this requirement does not apply
325 | if neither you nor any third party retains the ability to install
326 | modified object code on the User Product (for example, the work has
327 | been installed in ROM).
328 | 
329 |   The requirement to provide Installation Information does not include a
330 | requirement to continue to provide support service, warranty, or updates
331 | for a work that has been modified or installed by the recipient, or for
332 | the User Product in which it has been modified or installed.  Access to a
333 | network may be denied when the modification itself materially and
334 | adversely affects the operation of the network or violates the rules and
335 | protocols for communication across the network.
336 | 
337 |   Corresponding Source conveyed, and Installation Information provided,
338 | in accord with this section must be in a format that is publicly
339 | documented (and with an implementation available to the public in
340 | source code form), and must require no special password or key for
341 | unpacking, reading or copying.
342 | 
343 |   7. Additional Terms.
344 | 
345 |   "Additional permissions" are terms that supplement the terms of this
346 | License by making exceptions from one or more of its conditions.
347 | Additional permissions that are applicable to the entire Program shall
348 | be treated as though they were included in this License, to the extent
349 | that they are valid under applicable law.  If additional permissions
350 | apply only to part of the Program, that part may be used separately
351 | under those permissions, but the entire Program remains governed by
352 | this License without regard to the additional permissions.
353 | 
354 |   When you convey a copy of a covered work, you may at your option
355 | remove any additional permissions from that copy, or from any part of
356 | it.  (Additional permissions may be written to require their own
357 | removal in certain cases when you modify the work.)  You may place
358 | additional permissions on material, added by you to a covered work,
359 | for which you have or can give appropriate copyright permission.
360 | 
361 |   Notwithstanding any other provision of this License, for material you
362 | add to a covered work, you may (if authorized by the copyright holders of
363 | that material) supplement the terms of this License with terms:
364 | 
365 |     a) Disclaiming warranty or limiting liability differently from the
366 |     terms of sections 15 and 16 of this License; or
367 | 
368 |     b) Requiring preservation of specified reasonable legal notices or
369 |     author attributions in that material or in the Appropriate Legal
370 |     Notices displayed by works containing it; or
371 | 
372 |     c) Prohibiting misrepresentation of the origin of that material, or
373 |     requiring that modified versions of such material be marked in
374 |     reasonable ways as different from the original version; or
375 | 
376 |     d) Limiting the use for publicity purposes of names of licensors or
377 |     authors of the material; or
378 | 
379 |     e) Declining to grant rights under trademark law for use of some
380 |     trade names, trademarks, or service marks; or
381 | 
382 |     f) Requiring indemnification of licensors and authors of that
383 |     material by anyone who conveys the material (or modified versions of
384 |     it) with contractual assumptions of liability to the recipient, for
385 |     any liability that these contractual assumptions directly impose on
386 |     those licensors and authors.
387 | 
388 |   All other non-permissive additional terms are considered "further
389 | restrictions" within the meaning of section 10.  If the Program as you
390 | received it, or any part of it, contains a notice stating that it is
391 | governed by this License along with a term that is a further
392 | restriction, you may remove that term.  If a license document contains
393 | a further restriction but permits relicensing or conveying under this
394 | License, you may add to a covered work material governed by the terms
395 | of that license document, provided that the further restriction does
396 | not survive such relicensing or conveying.
397 | 
398 |   If you add terms to a covered work in accord with this section, you
399 | must place, in the relevant source files, a statement of the
400 | additional terms that apply to those files, or a notice indicating
401 | where to find the applicable terms.
402 | 
403 |   Additional terms, permissive or non-permissive, may be stated in the
404 | form of a separately written license, or stated as exceptions;
405 | the above requirements apply either way.
406 | 
407 |   8. Termination.
408 | 
409 |   You may not propagate or modify a covered work except as expressly
410 | provided under this License.  Any attempt otherwise to propagate or
411 | modify it is void, and will automatically terminate your rights under
412 | this License (including any patent licenses granted under the third
413 | paragraph of section 11).
414 | 
415 |   However, if you cease all violation of this License, then your
416 | license from a particular copyright holder is reinstated (a)
417 | provisionally, unless and until the copyright holder explicitly and
418 | finally terminates your license, and (b) permanently, if the copyright
419 | holder fails to notify you of the violation by some reasonable means
420 | prior to 60 days after the cessation.
421 | 
422 |   Moreover, your license from a particular copyright holder is
423 | reinstated permanently if the copyright holder notifies you of the
424 | violation by some reasonable means, this is the first time you have
425 | received notice of violation of this License (for any work) from that
426 | copyright holder, and you cure the violation prior to 30 days after
427 | your receipt of the notice.
428 | 
429 |   Termination of your rights under this section does not terminate the
430 | licenses of parties who have received copies or rights from you under
431 | this License.  If your rights have been terminated and not permanently
432 | reinstated, you do not qualify to receive new licenses for the same
433 | material under section 10.
434 | 
435 |   9. Acceptance Not Required for Having Copies.
436 | 
437 |   You are not required to accept this License in order to receive or
438 | run a copy of the Program.  Ancillary propagation of a covered work
439 | occurring solely as a consequence of using peer-to-peer transmission
440 | to receive a copy likewise does not require acceptance.  However,
441 | nothing other than this License grants you permission to propagate or
442 | modify any covered work.  These actions infringe copyright if you do
443 | not accept this License.  Therefore, by modifying or propagating a
444 | covered work, you indicate your acceptance of this License to do so.
445 | 
446 |   10. Automatic Licensing of Downstream Recipients.
447 | 
448 |   Each time you convey a covered work, the recipient automatically
449 | receives a license from the original licensors, to run, modify and
450 | propagate that work, subject to this License.  You are not responsible
451 | for enforcing compliance by third parties with this License.
452 | 
453 |   An "entity transaction" is a transaction transferring control of an
454 | organization, or substantially all assets of one, or subdividing an
455 | organization, or merging organizations.  If propagation of a covered
456 | work results from an entity transaction, each party to that
457 | transaction who receives a copy of the work also receives whatever
458 | licenses to the work the party's predecessor in interest had or could
459 | give under the previous paragraph, plus a right to possession of the
460 | Corresponding Source of the work from the predecessor in interest, if
461 | the predecessor has it or can get it with reasonable efforts.
462 | 
463 |   You may not impose any further restrictions on the exercise of the
464 | rights granted or affirmed under this License.  For example, you may
465 | not impose a license fee, royalty, or other charge for exercise of
466 | rights granted under this License, and you may not initiate litigation
467 | (including a cross-claim or counterclaim in a lawsuit) alleging that
468 | any patent claim is infringed by making, using, selling, offering for
469 | sale, or importing the Program or any portion of it.
470 | 
471 |   11. Patents.
472 | 
473 |   A "contributor" is a copyright holder who authorizes use under this
474 | License of the Program or a work on which the Program is based.  The
475 | work thus licensed is called the contributor's "contributor version".
476 | 
477 |   A contributor's "essential patent claims" are all patent claims
478 | owned or controlled by the contributor, whether already acquired or
479 | hereafter acquired, that would be infringed by some manner, permitted
480 | by this License, of making, using, or selling its contributor version,
481 | but do not include claims that would be infringed only as a
482 | consequence of further modification of the contributor version.  For
483 | purposes of this definition, "control" includes the right to grant
484 | patent sublicenses in a manner consistent with the requirements of
485 | this License.
486 | 
487 |   Each contributor grants you a non-exclusive, worldwide, royalty-free
488 | patent license under the contributor's essential patent claims, to
489 | make, use, sell, offer for sale, import and otherwise run, modify and
490 | propagate the contents of its contributor version.
491 | 
492 |   In the following three paragraphs, a "patent license" is any express
493 | agreement or commitment, however denominated, not to enforce a patent
494 | (such as an express permission to practice a patent or covenant not to
495 | sue for patent infringement).  To "grant" such a patent license to a
496 | party means to make such an agreement or commitment not to enforce a
497 | patent against the party.
498 | 
499 |   If you convey a covered work, knowingly relying on a patent license,
500 | and the Corresponding Source of the work is not available for anyone
501 | to copy, free of charge and under the terms of this License, through a
502 | publicly available network server or other readily accessible means,
503 | then you must either (1) cause the Corresponding Source to be so
504 | available, or (2) arrange to deprive yourself of the benefit of the
505 | patent license for this particular work, or (3) arrange, in a manner
506 | consistent with the requirements of this License, to extend the patent
507 | license to downstream recipients.  "Knowingly relying" means you have
508 | actual knowledge that, but for the patent license, your conveying the
509 | covered work in a country, or your recipient's use of the covered work
510 | in a country, would infringe one or more identifiable patents in that
511 | country that you have reason to believe are valid.
512 | 
513 |   If, pursuant to or in connection with a single transaction or
514 | arrangement, you convey, or propagate by procuring conveyance of, a
515 | covered work, and grant a patent license to some of the parties
516 | receiving the covered work authorizing them to use, propagate, modify
517 | or convey a specific copy of the covered work, then the patent license
518 | you grant is automatically extended to all recipients of the covered
519 | work and works based on it.
520 | 
521 |   A patent license is "discriminatory" if it does not include within
522 | the scope of its coverage, prohibits the exercise of, or is
523 | conditioned on the non-exercise of one or more of the rights that are
524 | specifically granted under this License.  You may not convey a covered
525 | work if you are a party to an arrangement with a third party that is
526 | in the business of distributing software, under which you make payment
527 | to the third party based on the extent of your activity of conveying
528 | the work, and under which the third party grants, to any of the
529 | parties who would receive the covered work from you, a discriminatory
530 | patent license (a) in connection with copies of the covered work
531 | conveyed by you (or copies made from those copies), or (b) primarily
532 | for and in connection with specific products or compilations that
533 | contain the covered work, unless you entered into that arrangement,
534 | or that patent license was granted, prior to 28 March 2007.
535 | 
536 |   Nothing in this License shall be construed as excluding or limiting
537 | any implied license or other defenses to infringement that may
538 | otherwise be available to you under applicable patent law.
539 | 
540 |   12. No Surrender of Others' Freedom.
541 | 
542 |   If conditions are imposed on you (whether by court order, agreement or
543 | otherwise) that contradict the conditions of this License, they do not
544 | excuse you from the conditions of this License.  If you cannot convey a
545 | covered work so as to satisfy simultaneously your obligations under this
546 | License and any other pertinent obligations, then as a consequence you may
547 | not convey it at all.  For example, if you agree to terms that obligate you
548 | to collect a royalty for further conveying from those to whom you convey
549 | the Program, the only way you could satisfy both those terms and this
550 | License would be to refrain entirely from conveying the Program.
551 | 
552 |   13. Use with the GNU Affero General Public License.
553 | 
554 |   Notwithstanding any other provision of this License, you have
555 | permission to link or combine any covered work with a work licensed
556 | under version 3 of the GNU Affero General Public License into a single
557 | combined work, and to convey the resulting work.  The terms of this
558 | License will continue to apply to the part which is the covered work,
559 | but the special requirements of the GNU Affero General Public License,
560 | section 13, concerning interaction through a network will apply to the
561 | combination as such.
562 | 
563 |   14. Revised Versions of this License.
564 | 
565 |   The Free Software Foundation may publish revised and/or new versions of
566 | the GNU General Public License from time to time.  Such new versions will
567 | be similar in spirit to the present version, but may differ in detail to
568 | address new problems or concerns.
569 | 
570 |   Each version is given a distinguishing version number.  If the
571 | Program specifies that a certain numbered version of the GNU General
572 | Public License "or any later version" applies to it, you have the
573 | option of following the terms and conditions either of that numbered
574 | version or of any later version published by the Free Software
575 | Foundation.  If the Program does not specify a version number of the
576 | GNU General Public License, you may choose any version ever published
577 | by the Free Software Foundation.
578 | 
579 |   If the Program specifies that a proxy can decide which future
580 | versions of the GNU General Public License can be used, that proxy's
581 | public statement of acceptance of a version permanently authorizes you
582 | to choose that version for the Program.
583 | 
584 |   Later license versions may give you additional or different
585 | permissions.  However, no additional obligations are imposed on any
586 | author or copyright holder as a result of your choosing to follow a
587 | later version.
588 | 
589 |   15. Disclaimer of Warranty.
590 | 
591 |   THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592 | APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593 | HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594 | OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595 | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596 | PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597 | IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598 | ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599 | 
600 |   16. Limitation of Liability.
601 | 
602 |   IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604 | THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605 | GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606 | USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607 | DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608 | PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609 | EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610 | SUCH DAMAGES.
611 | 
612 |   17. Interpretation of Sections 15 and 16.
613 | 
614 |   If the disclaimer of warranty and limitation of liability provided
615 | above cannot be given local legal effect according to their terms,
616 | reviewing courts shall apply local law that most closely approximates
617 | an absolute waiver of all civil liability in connection with the
618 | Program, unless a warranty or assumption of liability accompanies a
619 | copy of the Program in return for a fee.
620 | 
621 |                      END OF TERMS AND CONDITIONS
622 | 
623 |             How to Apply These Terms to Your New Programs
624 | 
625 |   If you develop a new program, and you want it to be of the greatest
626 | possible use to the public, the best way to achieve this is to make it
627 | free software which everyone can redistribute and change under these terms.
628 | 
629 |   To do so, attach the following notices to the program.  It is safest
630 | to attach them to the start of each source file to most effectively
631 | state the exclusion of warranty; and each file should have at least
632 | the "copyright" line and a pointer to where the full notice is found.
633 | 
634 |     {one line to give the program's name and a brief idea of what it does.}
635 |     Copyright (C) {year}  {name of author}
636 | 
637 |     This program is free software: you can redistribute it and/or modify
638 |     it under the terms of the GNU General Public License as published by
639 |     the Free Software Foundation, either version 3 of the License, or
640 |     (at your option) any later version.
641 | 
642 |     This program is distributed in the hope that it will be useful,
643 |     but WITHOUT ANY WARRANTY; without even the implied warranty of
644 |     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
645 |     GNU General Public License for more details.
646 | 
647 |     You should have received a copy of the GNU General Public License
648 |     along with this program.  If not, see <http://www.gnu.org/licenses/>.
649 | 
650 | Also add information on how to contact you by electronic and paper mail.
651 | 
652 |   If the program does terminal interaction, make it output a short
653 | notice like this when it starts in an interactive mode:
654 | 
655 |     {project}  Copyright (C) {year}  {fullname}
656 |     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657 |     This is free software, and you are welcome to redistribute it
658 |     under certain conditions; type `show c' for details.
659 | 
660 | The hypothetical commands `show w' and `show c' should show the appropriate
661 | parts of the General Public License.  Of course, your program's commands
662 | might be different; for a GUI interface, you would use an "about box".
663 | 
664 |   You should also get your employer (if you work as a programmer) or school,
665 | if any, to sign a "copyright disclaimer" for the program, if necessary.
666 | For more information on this, and how to apply and follow the GNU GPL, see
667 | <http://www.gnu.org/licenses/>.
668 | 
669 |   The GNU General Public License does not permit incorporating your program
670 | into proprietary programs.  If your program is a subroutine library, you
671 | may consider it more useful to permit linking proprietary applications with
672 | the library.  If this is what you want to do, use the GNU Lesser General
673 | Public License instead of this License.  But first, please read
674 | <http://www.gnu.org/philosophy/why-not-lgpl.html>.
675 | 


--------------------------------------------------------------------------------