entityjs 0.2.2

data/.gitignore

@@ -0,0 +1,7 @@
+Thumbs.db
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.redcar
+mygame

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in entityjs.gemspec
+gemspec

data/README.md

@@ -0,0 +1,49 @@
+# Entity JS
+An HTML5 javascript game engine utlizing the entity-component design. Write highly flexible code in a powerful javascript framework.
+
+[EntityJS Website](http://entityjs.com) | [Demos](http://entityjs.com/demos) | [Tutorials](http://entityjs.com/tutorials) | [API](http://entityjs.com/api)
+
+## What makes this different from other javascript game engines?
+Entity strives to be the most flexible game engine available. We understand no one likes rewritting the same functions and lines of code over and over. So we have developed a solution to this problem and that is the component-entity design. The traditional approach to game engine design is creating a hierarchy of classes. This is infact the **most** tightly coupled design. This creates close coupled classes whos functionality is strictly typed to one class, its not easily portable to other projects, good luck copying that one needed function and as game development progresses classes get bigger and more complex. You will eventually end up with *god-classes* who control most of the game logic.
+
+This becomes a big mess.
+
+In the world of *entity-component* designs. All logic is implemented in a *component*, as big or small as you want. You can then create an *entity* and add/remove components to it. The entity is a live represantation of all its components. With this low coupling of components and entities you can mix and match components together to create powerful functionality yet still portable and robust.
+
+## Directory Structure
+
+* **build** Contains two build commands to compile entityjs code.
+	* **build_min.bat** Will build a minified version for release.
+	* **build_debug.bat** Will build a debug file for testing offline.
+* **lib** Contains two compiled sources *entity.min.js* and *entity.debug.js*
+* **src** Contains source code of *entityjs*
+* **tutorials** Contains simple tutorials and examples.
+
+## Quick Start Guide
+This will take you through some quick steps to display an image on a canvas element.
+
+* Include *entity.min.js* in your html document (All compiled sources can be found in */lib*).
+
+* Initialize the system by calling *re.system.init*.
+
+	`re.system.init('#canvasId');`
+
+* Start the *main loop* of the application. This will refresh the screen and update logic.
+
+	`re.system.start();`
+
+* We now have to load our image *welcome.png*.
+
+	<code>re.load('welcome.png').complete(function(){ });</code>
+
+* Now inside the complete function body we can display the image. *re.entity* creates a new entity with the given components.
+
+	`re.entity('bitmap welcome.png');`
+
+That should now display an image on your canvas. Yes! For more information check out [the website](entityjs.com).
+
+## Future
+* Ruby YUI compiler
+* Level Editor
+* JS Loader
+* More tutorials!

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/entityjs

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+
+lib = File.expand_path(File.dirname(__FILE__) + '/../lib')
+$LOAD_PATH.unshift(lib) if File.directory?(lib) && !$LOAD_PATH.include?(lib)
+
+require 'entityjs'
+require 'entityjs/command'
+
+args = ARGV.dup
+ARGV.clear
+command = args.shift.strip rescue 'help'
+
+Entityjs::Command.run(command, args)

data/build/build_debug.bat

@@ -0,0 +1 @@
+php debug.php

data/build/build_min.bat

@@ -0,0 +1 @@
+php min.php

data/build/config.php

@@ -0,0 +1,64 @@
+<?php
+/*
+This file contains configurable variables for both debug.php and min.php.
+*/
+
+//turn off error for blank regex
+error_reporting(E_ALL ^ E_WARNING);
+
+//current entityjs version
+//this will be added to all built files.
+$version = '0.3';
+
+//full length path to entityjs folder
+$absolute_path = '..';
+
+//path to entityjs source files
+$source_path = $absolute_path.'/src';
+
+//path to output directory
+$des_path = $absolute_path.'/lib';
+
+//location of license
+$license = $absolute_path.'/license.txt';
+
+//name of entityjs directory
+$entity = 'entityjs';
+
+//name of re definition file
+$re_file = 're.js';
+
+//ignore regular expression
+/*
+ignore regular expression
+
+example
+
+$ignore_reg = '/(socket|storage|group)/'
+
+*/
+$ignore_reg = '/(socket)/';
+
+//path to entityjs directory
+$retro_folder = $source_path.'/'.$entity.'/';
+
+//name of outputed minified file
+$min_name = 'entity.min.js';
+
+//name of outputed debug file
+$debug_name = 'entity.debug.js';
+
+
+/*
+Compile replace variables.
+
+Adding these variables to your release source files will be replaced
+with the respected value.
+*/
+
+//replaces $VERSION with current entity js version
+$version_pattern = '$VERSION';
+
+//more to come..
+
+?>

data/build/debug.php

@@ -0,0 +1,48 @@
+<?php
+/*
+The debug.php file is used to create an entity.debug.php file for your application.
+Include this file into your web page and it will load all files in the source
+directory automatically for you.
+
+@usage
+Open the command prompt
+Navigate to the debug.php directory
+type "php debug.php"
+This will create for you a entity.debug.js in the lib directory
+
+You can now use this file in debug testing / debugging.
+
+@warning
+Each time a file is deleted or created in the source directory 
+you must run this php script again.
+*/
+
+require 'config.php';
+
+require 'files.php';
+
+$header = file_get_contents($license)."\nif(!path) path = '';\n";
+
+//add version
+$source = str_replace($version_pattern, $version, $header);
+
+//print out all files
+foreach($files as $k){
+	//remove ../
+	$cut = substr($k, 3);
+	
+	$source .= "document.write(\"<script src='\"+path+\"".$cut."' language='javascript'><\/script>\");\n";
+}
+
+//add version
+$source .= "\nwindow.onload = function(){ re.version = '".$version."'; }";
+
+$final = $des_path .'/'.$debug_name;
+
+
+//create file
+file_put_contents($final, $source);
+
+printf('Success! File created at %s', $final);
+
+?>

data/build/files.php

@@ -0,0 +1,74 @@
+<?php
+/*
+Used in php files min.php and local.php to find all files in the source directory.
+
+Creates a $file variable.
+*/
+
+//finds all files in source path
+function findFiles($dir) {
+	global $re_file, $ignore_reg;
+	
+    if($dh = opendir($dir)) {
+
+        $files = array();
+        $inner_files = array();
+
+        while($file = readdir($dh)) {
+		
+            if($file != "." && $file != ".." && $file[0] != '.') {
+			
+                if(is_dir($dir . "/" . $file)) {
+                    $inner_files = findFiles($dir . "/" . $file);
+                    if(is_array($inner_files)) $files = array_merge($files, $inner_files); 
+					
+                } else if(strrpos($file, '.js')){
+					$f = $dir .'/' . $file;
+					
+					if(!preg_match($ignore_reg, $f)){
+						
+						//push to the beginning to prevent null re errors
+						if($file == $re_file){
+							array_unshift($files, $f);
+						} else {
+							array_push($files, $f);
+						}
+						
+						printf("Found file: %s\n", $f);
+					} else {
+						
+						printf("[Ignored] file: %s\n", $f);
+					}
+                }
+				
+            }
+			
+        }
+
+        closedir($dh);
+		
+        return $files;
+    }
+}
+
+$files = findFiles($source_path);
+
+//sort files in correct order
+for($i=count($files)-1; $i>=0; $i--){
+	
+	$t = $files[$i];
+	
+	if(strpos($t, $retro_folder)){
+		//move to beginning
+		
+		//remove
+		array_splice($files, $i);
+		
+		//move to front
+		array_unshift($t);
+	}
+	
+}
+
+
+?>

data/build/jsmin.php

@@ -0,0 +1,376 @@
+<?php
+/**
+ * jsmin.php - PHP implementation of Douglas Crockford's JSMin.
+ *
+ * This is pretty much a direct port of jsmin.c to PHP with just a few
+ * PHP-specific performance tweaks. Also, whereas jsmin.c reads from stdin and
+ * outputs to stdout, this library accepts a string as input and returns another
+ * string as output.
+ *
+ * PHP 5 or higher is required.
+ *
+ * Permission is hereby granted to use this version of the library under the
+ * same terms as jsmin.c, which has the following license:
+ *
+ * --
+ * Copyright (c) 2002 Douglas Crockford  (www.crockford.com)
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to
+ * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+ * of the Software, and to permit persons to whom the Software is furnished to do
+ * so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * The Software shall be used for Good, not Evil.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * --
+ *
+ * @package JSMin
+ * @author Ryan Grove <ryan@wonko.com>
+ * @copyright 2002 Douglas Crockford <douglas@crockford.com> (jsmin.c)
+ * @copyright 2008 Ryan Grove <ryan@wonko.com> (PHP port)
+ * @license http://opensource.org/licenses/mit-license.php MIT License
+ * @version 1.1.1 (2008-03-02)
+ * @link https://github.com/rgrove/jsmin-php/
+ */
+
+class JSMin {
+  const ORD_LF            = 10;
+  const ORD_SPACE         = 32;
+  const ACTION_KEEP_A     = 1;
+  const ACTION_DELETE_A   = 2;
+  const ACTION_DELETE_A_B = 3;
+
+  protected $a           = '';
+  protected $b           = '';
+  protected $input       = '';
+  protected $inputIndex  = 0;
+  protected $inputLength = 0;
+  protected $lookAhead   = null;
+  protected $output      = '';
+
+  // -- Public Static Methods --------------------------------------------------
+
+  /**
+   * Minify Javascript
+   *
+   * @uses __construct()
+   * @uses min()
+   * @param string $js Javascript to be minified
+   * @return string
+   */
+  public static function minify($js) {
+    $jsmin = new JSMin($js);
+    return $jsmin->min();
+  }
+
+  // -- Public Instance Methods ------------------------------------------------
+
+  /**
+   * Constructor
+   *
+   * @param string $input Javascript to be minified
+   */
+  public function __construct($input) {
+    $this->input       = str_replace("\r\n", "\n", $input);
+    $this->inputLength = strlen($this->input);
+  }
+
+  // -- Protected Instance Methods ---------------------------------------------
+
+  /**
+   * Action -- do something! What to do is determined by the $command argument.
+   *
+   * action treats a string as a single character. Wow!
+   * action recognizes a regular expression if it is preceded by ( or , or =.
+   *
+   * @uses next()
+   * @uses get()
+   * @throws JSMinException If parser errors are found:
+   *         - Unterminated string literal
+   *         - Unterminated regular expression set in regex literal
+   *         - Unterminated regular expression literal
+   * @param int $command One of class constants:
+   *      ACTION_KEEP_A      Output A. Copy B to A. Get the next B.
+   *      ACTION_DELETE_A    Copy B to A. Get the next B. (Delete A).
+   *      ACTION_DELETE_A_B  Get the next B. (Delete B).
+  */
+  protected function action($command) {
+    switch($command) {
+      case self::ACTION_KEEP_A:
+        $this->output .= $this->a;
+
+      case self::ACTION_DELETE_A:
+        $this->a = $this->b;
+
+        if ($this->a === "'" || $this->a === '"') {
+          for (;;) {
+            $this->output .= $this->a;
+            $this->a       = $this->get();
+
+            if ($this->a === $this->b) {
+              break;
+            }
+
+            if (ord($this->a) <= self::ORD_LF) {
+              throw new JSMinException('Unterminated string literal.');
+            }
+
+            if ($this->a === '\\') {
+              $this->output .= $this->a;
+              $this->a       = $this->get();
+            }
+          }
+        }
+
+      case self::ACTION_DELETE_A_B:
+        $this->b = $this->next();
+
+        if ($this->b === '/' && (
+            $this->a === '(' || $this->a === ',' || $this->a === '=' ||
+            $this->a === ':' || $this->a === '[' || $this->a === '!' ||
+            $this->a === '&' || $this->a === '|' || $this->a === '?' ||
+            $this->a === '{' || $this->a === '}' || $this->a === ';' ||
+            $this->a === "\n" )) {
+
+          $this->output .= $this->a . $this->b;
+
+          for (;;) {
+            $this->a = $this->get();
+
+            if ($this->a === '[') {
+              /*
+                inside a regex [...] set, which MAY contain a '/' itself. Example: mootools Form.Validator near line 460:
+                  return Form.Validator.getValidator('IsEmpty').test(element) || (/^(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]\.?){0,63}[a-z0-9!#$%&'*+/=?^_`{|}~-]@(?:(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\])$/i).test(element.get('value'));
+              */
+              for (;;) {
+                $this->output .= $this->a;
+                $this->a = $this->get();
+
+                if ($this->a === ']') {
+                    break;
+                } elseif ($this->a === '\\') {
+                  $this->output .= $this->a;
+                  $this->a       = $this->get();
+                } elseif (ord($this->a) <= self::ORD_LF) {
+                  throw new JSMinException('Unterminated regular expression set in regex literal.');
+                }
+              }
+            } elseif ($this->a === '/') {
+              break;
+            } elseif ($this->a === '\\') {
+              $this->output .= $this->a;
+              $this->a       = $this->get();
+            } elseif (ord($this->a) <= self::ORD_LF) {
+              throw new JSMinException('Unterminated regular expression literal.');
+            }
+
+            $this->output .= $this->a;
+          }
+
+          $this->b = $this->next();
+        }
+    }
+  }
+
+  /**
+   * Get next char. Convert ctrl char to space.
+   *
+   * @return string|null
+   */
+  protected function get() {
+    $c = $this->lookAhead;
+    $this->lookAhead = null;
+
+    if ($c === null) {
+      if ($this->inputIndex < $this->inputLength) {
+        $c = substr($this->input, $this->inputIndex, 1);
+        $this->inputIndex += 1;
+      } else {
+        $c = null;
+      }
+    }
+
+    if ($c === "\r") {
+      return "\n";
+    }
+
+    if ($c === null || $c === "\n" || ord($c) >= self::ORD_SPACE) {
+      return $c;
+    }
+
+    return ' ';
+  }
+
+  /**
+   * Is $c a letter, digit, underscore, dollar sign, or non-ASCII character.
+   *
+   * @return bool
+   */
+  protected function isAlphaNum($c) {
+    return ord($c) > 126 || $c === '\\' || preg_match('/^[\w\$]$/', $c) === 1;
+  }
+
+  /**
+   * Perform minification, return result
+   *
+   * @uses action()
+   * @uses isAlphaNum()
+   * @return string
+   */
+  protected function min() {
+    $this->a = "\n";
+    $this->action(self::ACTION_DELETE_A_B);
+
+    while ($this->a !== null) {
+      switch ($this->a) {
+        case ' ':
+          if ($this->isAlphaNum($this->b)) {
+            $this->action(self::ACTION_KEEP_A);
+          } else {
+            $this->action(self::ACTION_DELETE_A);
+          }
+          break;
+
+        case "\n":
+          switch ($this->b) {
+            case '{':
+            case '[':
+            case '(':
+            case '+':
+            case '-':
+              $this->action(self::ACTION_KEEP_A);
+              break;
+
+            case ' ':
+              $this->action(self::ACTION_DELETE_A_B);
+              break;
+
+            default:
+              if ($this->isAlphaNum($this->b)) {
+                $this->action(self::ACTION_KEEP_A);
+              }
+              else {
+                $this->action(self::ACTION_DELETE_A);
+              }
+          }
+          break;
+
+        default:
+          switch ($this->b) {
+            case ' ':
+              if ($this->isAlphaNum($this->a)) {
+                $this->action(self::ACTION_KEEP_A);
+                break;
+              }
+
+              $this->action(self::ACTION_DELETE_A_B);
+              break;
+
+            case "\n":
+              switch ($this->a) {
+                case '}':
+                case ']':
+                case ')':
+                case '+':
+                case '-':
+                case '"':
+                case "'":
+                  $this->action(self::ACTION_KEEP_A);
+                  break;
+
+                default:
+                  if ($this->isAlphaNum($this->a)) {
+                    $this->action(self::ACTION_KEEP_A);
+                  }
+                  else {
+                    $this->action(self::ACTION_DELETE_A_B);
+                  }
+              }
+              break;
+
+            default:
+              $this->action(self::ACTION_KEEP_A);
+              break;
+          }
+      }
+    }
+
+    return $this->output;
+  }
+
+  /**
+   * Get the next character, skipping over comments. peek() is used to see
+   *  if a '/' is followed by a '/' or '*'.
+   *
+   * @uses get()
+   * @uses peek()
+   * @throws JSMinException On unterminated comment.
+   * @return string
+   */
+  protected function next() {
+    $c = $this->get();
+
+    if ($c === '/') {
+      switch($this->peek()) {
+        case '/':
+          for (;;) {
+            $c = $this->get();
+
+            if (ord($c) <= self::ORD_LF) {
+              return $c;
+            }
+          }
+
+        case '*':
+          $this->get();
+
+          for (;;) {
+            switch($this->get()) {
+              case '*':
+                if ($this->peek() === '/') {
+                  $this->get();
+                  return ' ';
+                }
+                break;
+
+              case null:
+                throw new JSMinException('Unterminated comment.');
+            }
+          }
+
+        default:
+          return $c;
+      }
+    }
+
+    return $c;
+  }
+
+  /**
+   * Get next char. If is ctrl character, translate to a space or newline.
+   *
+   * @uses get()
+   * @return string|null
+   */
+  protected function peek() {
+    $this->lookAhead = $this->get();
+    return $this->lookAhead;
+  }
+}
+
+// -- Exceptions ---------------------------------------------------------------
+class JSMinException extends Exception {}
+
+?>

data/build/min.php

@@ -0,0 +1,50 @@
+<?php
+/*
+Retrojs minifier
+Version 0.1
+
+This will minify all javascript files in the source path.
+
+The default source path is entityjs/src/
+
+When releasing a new version of your game. You could put it inside the source folder (entityjs/src)
+and it will be compiled into one javascript file for you.
+
+@warning This will minify ALL files in source path directories and sub-directories even
+if its not a javascript file!
+
+@usage 
+Go into the command prompt 
+Nagivate to min.php
+type "php min.php"
+or put all files into your server and navigate to the min.php file.
+*/
+
+require 'config.php';
+
+require 'jsmin.php';
+
+require 'files.php';
+
+//add all files
+foreach($files as $k){
+	$source .= file_get_contents($k);
+}
+
+//compile
+$js=JSMin::minify($source);
+
+//add license
+$js = file_get_contents($license) . $js;
+
+//add version
+$js = str_replace($version_pattern, $version, $js);
+
+//paste into file
+$full_des = $des_path.'/'.$min_name;
+
+file_put_contents($full_des, $js);
+
+printf('Success! Minified file at %s',$full_des);
+
+?>