jax 0.0.0.1

data/spec/javascripts/jax/builtin/meshes/cube_spec.js

@@ -0,0 +1,10 @@
+describe("Cube", function() {
+  var cube;
+  
+  beforeEach(function() { cube = new Jax.Mesh.Cube() });
+  
+  it("should build successfully", function() {
+    var verts = [], colors = [], texes = [], norms = [];
+    cube.init(verts, colors, texes, norms);
+  });
+});

data/spec/javascripts/jax/builtin/meshes/plane_spec.js

@@ -0,0 +1,8 @@
+describe("Jax.Mesh.Plane", function() {
+  var plane;
+  
+  describe("with no options", function() {
+    beforeEach(function() { plane = new Jax.Mesh.Plane(); });
+    it("should initialize", function() { });
+  });
+});

data/spec/javascripts/jax/builtin/meshes/quad_spec.js

@@ -0,0 +1,8 @@
+describe("Jax.Mesh.Quad", function() {
+  var quad;
+  
+  describe("with no options", function() {
+    beforeEach(function() { quad = new Jax.Mesh.Quad(); });
+    it("should initialize", function() { });
+  });
+});

data/spec/javascripts/jax/builtin/meshes/sphere_spec.js

@@ -0,0 +1,8 @@
+describe("Jax.Mesh.Sphere", function() {
+  var sphere;
+  
+  describe("with no options", function() {
+    beforeEach(function() { sphere = new Jax.Mesh.Sphere(); });
+    it("should initialize", function() { });
+  });
+});

data/spec/javascripts/jax/builtin/meshes/teapot_spec.js

@@ -0,0 +1,8 @@
+describe("Jax.Mesh.Teapot", function() {
+  var teapot;
+  
+  describe("with no options", function() {
+    beforeEach(function() { teapot = new Jax.Mesh.Teapot(); });
+    it("should initialize", function() { });
+  });
+});

data/spec/javascripts/jax/builtin/meshes/torus_spec.js

@@ -0,0 +1,8 @@
+describe("Jax.Mesh.Torus", function() {
+  var torus;
+  
+  describe("with no options", function() {
+    beforeEach(function() { torus = new Jax.Mesh.Torus(); });
+    it("should initialize", function() { });
+  });
+});

data/spec/javascripts/jax/compatibility_spec.js

@@ -0,0 +1,50 @@
+describe("LCD Compatibility tests", function() {
+  var context;
+  beforeEach(function() { context = new Jax.Context('canvas-element'); });
+  afterEach(function() { context.dispose(); });
+  
+  /* these tests verify that different aspects of Jax can perform on lowest-common-denominator machines */
+  
+  /*
+    From the GL ES SL spec, section 7.8:
+    
+    //
+    // Implementation dependent constants. The example values below
+    // are the minimum values allowed for these maximums.
+    //
+        
+    So, the "basic" shader must define no more than at most the above
+    uniforms, varyings, etc. -- or else the basic shader itself may
+    fail on some implementations!
+    
+    Jax will dynamically step back from other shader chain elements,
+    but if the 'basic' shader exceeds these limits then Jax is out of
+    the running entirely on some processors -- not good!
+    
+    TODO add some tests to validate 'basic' shader against the following:
+      const mediump int gl_MaxVertexTextureImageUnits = 0;
+      const mediump int gl_MaxCombinedTextureImageUnits = 8;
+      const mediump int gl_MaxTextureImageUnits = 8;
+      const mediump int gl_MaxDrawBuffers = 1;
+  */
+  describe("Basic shader", function() {
+    var matr, shader;
+    beforeEach(function() { matr = new Jax.Material(); shader = matr.prepareShader(); });
+    
+    it("should not have more than 16 uniforms", function() {
+      // const mediump int gl_MaxVertexUniformVectors = 128;
+      // const mediump int gl_MaxFragmentUniformVectors = 16;
+      expect(shader.countUniforms(matr)).toBeLessThan(17);
+    });
+    
+    it("should not have more than 8 varyings", function() {
+      // const mediump int gl_MaxVaryingVectors = 8;
+      expect(shader.countVaryings(matr)).toBeLessThan(9);
+    });
+    
+    it("should not have more than 8 attribs", function() {
+      // const mediump int gl_MaxVertexAttribs = 8;
+      expect(shader.countAttributes(matr)).toBeLessThan(9);
+    });
+  });
+});

data/spec/javascripts/jax/context_spec.js

@@ -0,0 +1,82 @@
+describe("Jax.Canvas", function() {
+  var context;
+  
+  describe("with no routes", function() {
+    beforeEach(function() { 
+      Jax.routes.clear();
+      context = new Jax.Context(document.getElementById("canvas-element"));
+    });
+    afterEach(function() { context.dispose(); });
+  
+    it("should keep a handle to canvas", function() {
+      expect(context.canvas.id).toEqual("canvas-element");
+    });
+  
+    it("should not be rendering, because there's no root controller", function() {
+      expect(context.isRendering()).toBeFalsy();
+    });
+  });
+  
+  describe("when redirecting", function() {
+    beforeEach(function() {
+      jasmine.Clock.useMock();
+      
+      Jax.routes.clear();
+      
+      Jax.views.push('one/index', function() { });
+      Jax.views.push('two/index', function() { });
+
+      var one = Jax.Controller.create("one", {index:function() {}});
+      var two = Jax.Controller.create("two", {
+        index:function() { this.world.addObject(new Jax.Model()); },
+        update: function(tc) {  }
+      });
+      
+      Jax.routes.map("/", one);
+      Jax.routes.map("two", two);
+      
+      context = new Jax.Context(document.getElementById("canvas-element"));
+    });
+    
+    afterEach(function() { context.dispose(); });
+    
+    it("should dispose the world", function() {
+      spyOn(context.world, 'dispose').andCallThrough();
+      context.redirectTo("two");
+      expect(context.world.dispose).toHaveBeenCalled();
+    });
+    
+    it("to a bad route should stop execution of current controller", function() {
+      context.redirectTo("two");
+      var two_instance = context.current_controller;
+      
+      jasmine.Clock.tick(Jax.update_speed+1);
+      expect(function() { context.redirectTo("invalid"); }).toThrow("Route not recognized: 'invalid'");
+      expect(context.world.objects.length).toEqual(0);
+      
+      spyOn(two_instance, "update"); // notice we can't do this earlier because it *does* get called above
+      jasmine.Clock.tick(Jax.update_speed+1);
+      expect(two_instance.update).not.toHaveBeenCalled();
+    });
+  });
+  
+  describe("with routes", function() {
+    var controller;
+    var action_called = 0, view_called = 0;
+    
+    beforeEach(function() {
+      Jax.routes.clear();
+      Jax.routes.root(Jax.Controller.create("welcome", {index: function() { action_called++; }}), "index");
+      Jax.views.push("welcome/index", function() {
+        this.glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
+        view_called++;
+      });
+      context = new Jax.Context(document.getElementById("canvas-element"));
+    });
+    afterEach(function() { context.dispose(); });
+  
+    it("should be rendering, because there's a controller", function() {
+      expect(context.isRendering()).toBeTruthy();
+    });
+  });
+});

data/spec/javascripts/jax/controller_spec.js

@@ -0,0 +1,145 @@
+describe("Jax.Controller", function() {
+  var klass;
+  var instance;
+  
+  describe("with an update method", function() {
+    var context;
+    
+    beforeEach(function() {
+      klass = Jax.Controller.create("welcome", { index: function() { }, update: function(tc) { } });
+      Jax.views.push("welcome/index", function() { });
+      Jax.routes.map("welcome", klass);
+      context = new Jax.Context(document.getElementById('canvas-element'));
+      instance = context.redirectTo("welcome");
+      spyOn(instance, 'update');
+    });
+    
+    it("should be called when the context is updated", function() {
+      /*
+        we can't really register a callback to setTimeout and check that it was called automatically,
+        so we'll have to simulate it by calling Context#update() directly.
+       */
+      context.update();
+      expect(instance.update).toHaveBeenCalled();
+    });
+  });
+
+  describe("which does not render or redirect", function() {
+    beforeEach(function() {
+      klass = Jax.Controller.create("welcome", { index: function() { } });
+      instance = new klass();
+    });
+    
+    it("should produce the view named after the controller and action names", function() {
+      instance.fireAction("index");
+      expect(instance.view_key).toEqual("welcome/index");
+    });
+    
+    it("should map the route automatically", function() {
+      expect(function() { Jax.routes.recognize_route("welcome/index") }).not.toThrow();
+    });
+  });
+
+  describe("with event actions", function() {
+    var evt;
+
+    function doMouseEvent(type) {
+      /* MouseEvents - click, mousedown, mousemove, mouseout, mouseover, mouseup */
+      /* initMouseEvent - type, bubbles, cancelable, windowObject, detail, screenX, screenY, clientX, clientY, ctrlKey,
+       * altKey, shiftKey, metaKey, button, relatedTarget */
+      evt = document.createEvent('MouseEvents');
+      evt.initMouseEvent(type, true, true, window, 1, 0, 0, 0, 0, false, false, false, false, 0, null);
+      document.getElementById('canvas-element').dispatchEvent(evt);
+    }
+
+    function doKeyEvent(type) {
+      /* UIEvents - DOMActivate, DOMFocusIn, DOMFocusOut */
+      /* KeyEvents / UIEvents - keydown, keypress, keyup */
+      /* initUIEvent - type, bubbles, cancelable windowObject, detail */
+      if (window.KeyEvent && !KeyEvent.fake) {
+        evt = document.createEvent('KeyEvents');
+        // type, bubbles, cancelable, windowObject, ctrlKey, altKey, shiftKey, metaKey, keyCode, charCode
+        evt.initKeyEvent(type, true, true, window, false, false, false, false, 13, 0);
+      } else {
+        evt = document.createEvent('UIEvents');
+        evt.initUIEvent(type, true, true, window, 1);
+        evt.keyCode = 13;
+      }
+      document.getElementById('canvas-element').dispatchEvent(evt);
+    }
+
+    var context;
+
+    beforeEach(function() {
+      var methods = {
+        mouse_clicked:  function(evt) { },
+        mouse_moved:    function(evt) { },
+        mouse_dragged:  function(evt) { },
+        mouse_pressed:  function(evt) { },
+        mouse_exited:   function(evt) { },
+        mouse_entered:  function(evt) { },
+        mouse_released: function(evt) { },
+        key_typed:      function(evt) { },
+        key_pressed:    function(evt) { },
+        key_released:   function(evt) { }
+      };
+      klass.addMethods(methods);
+      expect(instance).toHaveMethod("mouse_clicked"); // verify methods were added
+      for (var method_name in methods) spyOn(instance, method_name);
+      Jax.routes.clear();
+      context = new Jax.Context(document.getElementById("canvas-element"));
+      context.current_controller = instance;
+    });
+    afterEach(function() { context.dispose(); });
+
+    it("should dispatch key pressed events", function() {
+      doKeyEvent('keypress');
+      expect(instance.key_typed).toHaveBeenCalled();
+    });
+
+    it("should dispatch key released events", function() {
+      doKeyEvent('keyup');
+      expect(instance.key_released).toHaveBeenCalled();
+    });
+
+    it("should dispatch key down events", function() {
+      doKeyEvent('keydown');
+      expect(instance.key_pressed).toHaveBeenCalled();
+    });
+
+    it("should dispatch mouse released events", function() {
+      doMouseEvent('mouseup');
+      expect(instance.mouse_released).toHaveBeenCalled();
+    });
+    it("should dispatch mouse entered events", function() {
+      doMouseEvent('mouseout');
+      expect(instance.mouse_exited).toHaveBeenCalled();
+    });
+    it("should dispatch mouse exited events", function() {
+      doMouseEvent('mouseover');
+      expect(instance.mouse_entered).toHaveBeenCalled();
+    });
+
+    it("should dispatch mouse pressed events", function() {
+      doMouseEvent('mousedown');
+      expect(instance.mouse_pressed).toHaveBeenCalled();
+    });
+
+    it("should dispatch mouse dragged events", function() {
+      doMouseEvent('mousedown');
+      doMouseEvent('mousemove');
+      doMouseEvent('mouseup');
+      expect(instance.mouse_dragged).toHaveBeenCalled();
+    });
+
+    it("should dispatch mouse moved events", function() {
+      doMouseEvent('mousemove');
+      expect(instance.mouse_moved).toHaveBeenCalled();
+    });
+
+    it("should dispatch mouse clicked events", function() {
+      doMouseEvent('click');
+      expect(instance.mouse_clicked).toHaveBeenCalled();
+    });
+  });
+});

data/spec/javascripts/jax/core/delegation_spec.js

@@ -0,0 +1,48 @@
+describe("Delegation", function() {
+  /* see src/jax/prototype/extensions.js */
+  var klass;
+  
+  beforeEach(function() { klass = Jax.Class.create({initialize:function(){this.matrix_stack=new Jax.MatrixStack();}}); });
+  
+  it("should delegate via string", function() {
+    klass.delegate("getProjectionMatrix", "loadModelMatrix").into("matrix_stack");
+    
+    var src = new klass();
+    spyOn(src.matrix_stack, 'getProjectionMatrix');
+    spyOn(src.matrix_stack, 'loadModelMatrix');
+    
+    src.getProjectionMatrix();
+    src.loadModelMatrix(mat4.create());
+    
+    expect(src.matrix_stack.getProjectionMatrix).toHaveBeenCalled();
+    expect(src.matrix_stack.loadModelMatrix).toHaveBeenCalled();
+  });
+  
+  it("should delegate via regexp with explicit klass", function() {
+    klass.delegate(/^(get|load|mult)(.*)Matrix$/).into("matrix_stack", Jax.MatrixStack);
+    
+    var src = new klass();
+    spyOn(src.matrix_stack, 'getProjectionMatrix');
+    spyOn(src.matrix_stack, 'loadModelMatrix');
+    
+    src.getProjectionMatrix();
+    src.loadModelMatrix(mat4.create());
+    
+    expect(src.matrix_stack.getProjectionMatrix).toHaveBeenCalled();
+    expect(src.matrix_stack.loadModelMatrix).toHaveBeenCalled();
+  });
+  
+  it("should delegate via regexp without explicit klass", function() {
+    klass.delegate(/^(get|load|mult)(.*)Matrix$/).into("matrix_stack");
+    
+    var src = new klass();
+    spyOn(src.matrix_stack, 'getProjectionMatrix');
+    spyOn(src.matrix_stack, 'loadModelMatrix');
+    
+    src.getProjectionMatrix();
+    src.loadModelMatrix(mat4.create());
+    
+    expect(src.matrix_stack.getProjectionMatrix).toHaveBeenCalled();
+    expect(src.matrix_stack.loadModelMatrix).toHaveBeenCalled();
+  });
+});

data/spec/javascripts/jax/core/events_spec.js

@@ -0,0 +1,17 @@
+describe("Jax.Events", function() {
+  describe("Methods", function() {
+    var instance;
+    beforeEach(function() {
+      var klass = Jax.Class.create({});
+      klass.addMethods(Jax.Events.Methods);
+      instance = new klass();
+    });
+    
+    it("should pass events to listeners", function() {
+      var result = false;
+      instance.addEventListener('evt', function(evt) { result = evt; });
+      instance.fireEvent('evt', 1);
+      expect(result).toBeTruthy();
+    });
+  });
+});

data/spec/javascripts/jax/core/matrix_stack_spec.js

@@ -0,0 +1,28 @@
+describe("Jax.MatrixStack", function() {
+  var stack;
+  
+  beforeEach(function() { stack = new Jax.MatrixStack(); });
+  
+  it('should return a model matrix', function() { expect(stack.getModelMatrix()).not.toBeUndefined(); });
+  it('should return a view matrix', function() { expect(stack.getViewMatrix()).not.toBeUndefined(); });
+  it('should return a proj matrix', function() { expect(stack.getProjectionMatrix()).not.toBeUndefined(); });
+      
+  describe("with a pushed matrix", function() {
+    beforeEach(function() { stack.push(); });
+    
+    it('should return a model matrix', function() { expect(stack.getModelMatrix()).not.toBeUndefined(); });
+    it('should return a view matrix', function() { expect(stack.getViewMatrix()).not.toBeUndefined(); });
+    it('should return a proj matrix', function() { expect(stack.getProjectionMatrix()).not.toBeUndefined(); });
+      
+    describe("translate", function() {
+      beforeEach(function() { stack.loadViewMatrix(mat4.translate(Jax.IDENTITY_MATRIX, [1,1,1], mat4.create())); });
+      
+      it("should not be an identity matrix", function() { expect(stack.getViewMatrix()).not.toEqualMatrix(Jax.IDENTITY_MATRIX); });
+      
+      it("should produce coords relative to eye", function() {
+        var vec = mat4.multiplyVec3(stack.getInverseViewMatrix(), [0,0,0]);
+        expect(vec).toEqualVector([-1,-1,-1]);
+      });
+    });
+  });
+});

data/spec/javascripts/jax/core/utils_spec.js

@@ -0,0 +1,256 @@
+describe("Jax.Util", function() {
+  describe("vectorize", function() {
+    var data;
+    
+    describe("with object with names", function() {
+      beforeEach(function() { data = {x:1,y:2,z:3}; });
+      it("should produce a vector", function() { expect(Jax.Util.vectorize(data)).toEqualVector([1,2,3]); });
+    });
+    
+    describe("with string", function() {
+      describe("comma delimited", function() {
+        beforeEach(function() { data = "1,2,3"; });
+        it("should produce a vector", function() { expect(Jax.Util.vectorize(data)).toEqualVector([1,2,3]); });
+      });
+      describe("space delimited", function() {
+        beforeEach(function() { data = "1 2 3"; });
+        it("should produce a vector", function() { expect(Jax.Util.vectorize(data)).toEqualVector([1,2,3]); });
+      });
+      describe("comma-and-space delimited", function() {
+        beforeEach(function() { data = "1, 2, 3"; });
+        it("should produce a vector", function() { expect(Jax.Util.vectorize(data)).toEqualVector([1,2,3]); });
+      });
+      describe("tab delimited", function() {
+        beforeEach(function() { data = "1\t2\t3"; });
+        it("should produce a vector", function() { expect(Jax.Util.vectorize(data)).toEqualVector([1,2,3]); });
+      });
+      describe("comma-space-tab delimited", function() {
+        beforeEach(function() { data = "1, \t2, \t3"; });
+        it("should produce a vector", function() { expect(Jax.Util.vectorize(data)).toEqualVector([1,2,3]); });
+      });
+    });
+    
+    describe("colorize", function() {
+      var data;
+    
+      describe("with object with short names", function() {
+        beforeEach(function() { data = {r:1,g:2,b:3,a:4}; });
+        it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,4]); });
+      });
+    
+      describe("with object with long names", function() {
+        beforeEach(function() { data = {red:1,green:2,blue:3,alpha:4}; });
+        it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,4]); });
+      });
+    
+      describe("with string", function() {
+        describe("comma delimited", function() {
+          beforeEach(function() { data = "1,2,3,4"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,4]); });
+        });
+        describe("space delimited", function() {
+          beforeEach(function() { data = "1 2 3 4"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,4]); });
+        });
+        describe("comma-and-space delimited", function() {
+          beforeEach(function() { data = "1, 2, 3, 4"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,4]); });
+        });
+        describe("tab delimited", function() {
+          beforeEach(function() { data = "1\t2\t3\t4"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,4]); });
+        });
+        describe("comma-space-tab delimited", function() {
+          beforeEach(function() { data = "1, \t2, \t3, \t4"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,4]); });
+        });
+      });
+
+      describe("with object with short names and no alpha", function() {
+        beforeEach(function() { data = {r:1,g:2,b:3}; });
+        it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,1]); });
+      });
+    
+      describe("with object with long names and no alpha", function() {
+        beforeEach(function() { data = {red:1,green:2,blue:3}; });
+        it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,1]); });
+      });
+    
+      describe("with string", function() {
+        describe("comma delimited and no alpha", function() {
+          beforeEach(function() { data = "1,2,3"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,1]); });
+        });
+        describe("space delimited and no alpha", function() {
+          beforeEach(function() { data = "1 2 3"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,1]); });
+        });
+        describe("comma-and-space delimited and no alpha", function() {
+          beforeEach(function() { data = "1, 2, 3"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,1]); });
+        });
+        describe("tab delimited and no alpha", function() {
+          beforeEach(function() { data = "1\t2\t3"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,1]); });
+        });
+        describe("comma-space-tab delimited and no alpha", function() {
+          beforeEach(function() { data = "1, \t2, \t3"; });
+          it("should produce a color", function() { expect(Jax.Util.colorize(data)).toEqualVector([1,2,3,1]); });
+        });
+      });
+    });
+    
+    describe("with object with indices", function() {
+      beforeEach(function() { data = {0:1,1:2,2:3}; });
+      it("should produce a vector", function() { expect(Jax.Util.vectorize(data)).toEqualVector([1,2,3]); });
+    });
+    
+    describe("with a vector", function() {
+      beforeEach(function() { data = [1,2,3]; });
+      it("should produce a vector", function() { expect(Jax.Util.vectorize(data)).toEqualVector([1,2,3]); });
+      it("should not return itself", function() { expect(Jax.Util.vectorize(data)).not.toEqual(data); });
+    });
+  });
+  
+  describe("properties", function() {
+    var src;
+    beforeEach(function() { src = { prop1: 1, prop2: 2 }; });
+    it("should return property names", function() {
+      expect(Jax.Util.properties(src)).toEqual(['prop1', 'prop2']);
+    });
+  });
+  
+  describe("merge", function() {
+    var src, dst;
+    describe("with a source with null attributes and destination with existing attributes of same name", function() {
+      beforeEach(function() { src = {i:null}; dst = {i:5}; Jax.Util.merge(src,dst); });
+      
+      it("should copy null attributes", function() {
+        expect(dst.i).toBeNull();
+      });
+    });
+  });
+  
+  describe("sizeofFormat", function() {
+    it("should return size of ALPHA", function() { expect(Jax.Util.sizeofFormat(GL_ALPHA)).toEqual(1); });
+    it("should return size of LUMINANCE", function() { expect(Jax.Util.sizeofFormat(GL_LUMINANCE)).toEqual(1); });
+    it("should return size of RGB", function() { expect(Jax.Util.sizeofFormat(GL_RGB)).toEqual(3); });
+    it("should return size of RGBA", function() { expect(Jax.Util.sizeofFormat(GL_RGBA)).toEqual(4); });
+    it("should return size of LUMINANCE_ALPHA", function() { expect(Jax.Util.sizeofFormat(GL_LUMINANCE_ALPHA)).toEqual(2); });
+    it("should fail", function() { expect(function(){Jax.Util.sizeofFormat(-12345);}).toThrow(); });
+  });
+  
+  describe("enumName", function() {
+    it("should work", function() {
+      expect(Jax.Util.enumName(GL_TEXTURE_2D)).toEqual("GL_TEXTURE_2D");
+    });
+    
+    describe("failure", function() {
+      it("should contain the decimal form", function() {
+        expect(Jax.Util.enumName(36059)).toMatch(/36059/);
+      });
+
+      it("should contain the hex form", function() {
+        expect(Jax.Util.enumName(36059)).toMatch(/0x8cdb/);
+      });
+    });
+  });
+  
+  describe("normalizeOptions", function() {
+    var normalized;
+    describe("with a missing default array", function() {
+      var arr = [1,2,3];
+      beforeEach(function() { normalized = Jax.Util.normalizeOptions(null, {def:arr}); });
+      
+      it("should copy the default array", function() {
+        expect(normalized.def.length).toEqual(arr.length);
+        for (var i = 0; i < arr.length; i++)
+          expect(normalized.def[i]).toEqual(arr[i]);
+      });
+    });
+    
+    describe("with only 1 argument", function() {
+      it("should clone the argument", function() {
+        expect(Jax.Util.normalizeOptions({i:1}).i).toEqual(1);
+      });
+    });
+    
+    describe("with a gen object left and array right", function() {
+      beforeEach(function() { normalized = Jax.Util.normalizeOptions({p:{"x":20,"y":40,"z":60}}, {p:[1,2,3]}); });
+      it("should merge both into a gen object", function() {
+        expect(Object.isArray(normalized.p)).toBeFalsy();
+
+        expect(normalized.p.x).toEqual(20);
+        expect(normalized.p.y).toEqual(40);
+        expect(normalized.p.z).toEqual(60);
+        expect(normalized.p[0]).toEqual(1);
+        expect(normalized.p[1]).toEqual(2);
+        expect(normalized.p[2]).toEqual(3);
+      });
+    });
+    
+    describe("with a function value that defaults to null", function() {
+      beforeEach(function() { normalized = Jax.Util.normalizeOptions({onload:function(){}}, {onload:null}); });
+      
+      it("should assign the function value", function() {
+        expect(typeof(normalized.onload)).toEqual("function");
+      });
+    });
+    
+    describe("with a missing value that defaults to null", function() {
+      beforeEach(function() { normalized = Jax.Util.normalizeOptions({}, {onload:null}); });
+      
+      it("should assign the default value", function() {
+        expect(normalized.onload).toBeNull();
+      });
+    });
+    
+    describe("given a klass value", function() {
+      beforeEach(function() { normalized = Jax.Util.normalizeOptions({k:new (Jax.Class.create({}))}, {}); });
+      
+      it("should be an instance of that klass", function() {
+        expect(normalized.k.klass).not.toBeUndefined();
+        expect(normalized.k).toBeKindOf(normalized.k.klass);
+      });
+    });
+    
+    describe("given values that are not in defaults", function() {
+      beforeEach(function() { normalized = Jax.Util.normalizeOptions({m:8,n:{o:9,p:0}}, {i:1,j:{k:2,l:3}}); });
+      
+      it("should contain defaults", function() {
+        expect(normalized.i).toEqual(1);
+        expect(normalized.j.k).toEqual(2);
+        expect(normalized.j.l).toEqual(3);
+      });
+      
+      it("should contain customs", function() {
+        expect(normalized.m).toEqual(8);
+        expect(normalized.n.o).toEqual(9);
+        expect(normalized.n.p).toEqual(0);
+      });
+    });
+    
+    describe("given values that override defaults", function() {
+      beforeEach(function() { normalized = Jax.Util.normalizeOptions({i:8,j:{k:9,l:0}}, {i:1,j:{k:2,l:3}}); });
+      
+      it("should copy overrides", function() {
+        expect(normalized.i).toEqual(8);
+        expect(normalized.j.k).toEqual(9);
+        expect(normalized.j.l).toEqual(0);
+      });
+    });
+    
+    describe("given undefined", function() {
+      beforeEach(function() { normalized = Jax.Util.normalizeOptions(undefined, {i:1,j:{k:2,l:3}}); });
+      
+      it("should copy defaults", function() {
+        expect(normalized.i).toEqual(1);
+      });
+      
+      it("should copy nested defaults", function() {
+        expect(normalized.j.k).toEqual(2);
+        expect(normalized.j.l).toEqual(3);
+      })
+    });
+  });
+});