jax 1.1.1 → 2.0.0

data/app/assets/stylesheets/jax/runtime.css

@@ -0,0 +1,47 @@
+div.list {
+  float: left;
+  height: 470px;
+  border-left: 1px solid #000;
+  overflow-y: scroll;
+  min-width: 2in;
+  font-size: 10pt;
+}
+
+div.list div {
+  padding: 5px;
+  padding-right: 2em;
+  background-color: #eee;
+  margin-bottom: 2px;
+}
+
+div.list div:nth-child(even) {
+  background-color: #ccc;
+}
+
+canvas {
+  width: 640px;
+  height: 470px;
+  border-right: 1px inset #000;
+}
+
+div.help {
+  float: left;
+  text-align: left;
+  width: 150px;
+}
+
+div#how-to-customize {
+  text-align: left;
+  display: none;
+  background-color: #fff;
+  margin: 0;
+  padding-left: 1em;
+  padding-right: 1em;
+  width: 800px;
+  border: 1px solid #aaa;
+  font-size: 11pt;
+}
+
+#below-nav {
+  margin-left: 2.5in;
+}

data/app/assets/stylesheets/jax/shader_editor.css

@@ -0,0 +1,3 @@
+#below-nav {
+  margin-left: 4in;
+}

data/app/assets/stylesheets/jax/suite.css

@@ -0,0 +1,82 @@
+/*= require "jax/runtime" */
+/*= require "jax/nav" */
+
+body {
+  margin: 0;
+  background-color: #eee;
+  font-family: "Helvetica Neue Light", "Lucida Grande", "Calibri", "Arial", sans-serif;
+}
+
+a {
+  color: #00f;
+  text-decoration: none;
+}
+
+a:hover {
+  color: #00f;
+  text-decoration: none;
+}
+
+a:active {
+  color: #00f;
+  text-decoration: none;
+}
+
+a:visited {
+  color: #00f;
+  text-decoration: none;
+}
+
+div#jax-banner {
+  margin-top: 1em;
+  margin-left: 1in;
+  margin-bottom: 1em;
+}
+
+div#jax-banner span.title {
+  color: red;
+  font-size: 22pt;
+  margin-left: 0.5em;
+}
+
+div#jax-banner span.version {
+  font-size: 8pt;
+}
+
+div.code {
+  white-space: pre;
+  font-family: monospace;
+}
+
+div.spacer {
+  clear: both;
+}
+
+div#content {
+  margin-left: 1in;
+  margin-right: 1in;
+}
+
+#below-nav-row {
+  padding-top: 1em;
+  background-color: #fff;
+  padding-bottom: 0.75em;
+  margin-bottom: 0.25em;
+  border-bottom: 1px dashed #999;
+}
+
+#below-nav {
+  padding-left: 0.25in;
+  font-size: 11pt;
+}
+
+#below-nav #drop-arrow {
+  border-left: 1px dashed #000;
+  border-bottom: 1px dashed #000;
+  width: 1em;
+  height: 0.6em;
+  margin-right: 0.5em;
+  display: block;
+  float: left;
+}
+

data/app/controllers/jax/suite_controller.rb

@@ -0,0 +1,48 @@
+class Jax::SuiteController < ActionController::Base
+  layout :layout
+  helper_method :webgl_start
+  
+  def index
+    redirect_to :action => :run_webgl
+  end
+  
+  def jasmine
+    # order helpers before specs
+    @specs = helpers + specs
+  end
+  
+  def spec
+    render :text => Jax.config.specs[params[:id]].to_s
+  end
+  
+  private
+  def webgl_start
+    Jax.config.webgl_start
+  end
+  
+  def helpers
+    collect_spec_files_matching /_helper\./
+  end
+  
+  def specs
+    collect_spec_files_matching /([sS]pec|[tT]est)\./
+  end
+  
+  def collect_spec_files_matching(pattern)
+    [].tap do |files|
+      Jax.config.specs.each_file do |file|
+        file = Jax.config.specs.attributes_for(file).logical_path
+        if file =~ pattern
+          files << file
+        end
+      end
+    end
+  end
+  
+  def layout
+    case params[:action]
+    when 'spec' then nil
+    else 'jax'
+    end
+  end
+end

data/app/views/jax/suite/jasmine.html.erb

@@ -0,0 +1,38 @@
+<% content_for :head do %>
+  <%= javascript_include_tag 'jasmine' %>
+  <%= javascript_include_tag 'jax/jasmine_runner' %>
+  <%= stylesheet_link_tag 'jax/jasmine' %>
+
+  <script type="text/javascript">
+    window.onload = function() {
+      setupJaxTestEnvironment();
+    };
+  </script>
+  
+  <% @specs.each do |spec| %>
+    <%# javascript_include_tag insists on looking for this in assets! %>
+    <%#= javascript_include_tag url_for(:id => spec, :action => 'spec') %>
+    <script src="<%= url_for(:id => spec, :action => 'spec') %>" type="text/javascript"></script>
+  <% end %>
+<% end %>
+
+<div id="outer" class="jasmine_reporter">
+  <div class="banner">
+    <div class="logo">
+      <a href="http://pivotal.github.com/jasmine/" target="_blank">Jasmine</a>
+      <span class="version" id="jasmine-version"></span>
+    </div>
+    <div class="options">
+      Show
+      <input id="__jasmine_TrivialReporter_showPassed__" type="checkbox" />
+      <label for="__jasmine_TrivialReporter_showPassed__">passed</label>
+      <input id="__jasmine_TrivialReporter_showSkipped__" type="checkbox" />
+      <label for="__jasmine_TrivialReporter_showSkipped__">skipped</label>
+    </div>
+  </div>
+  <div id="runner" class="runner running">
+    <a class="run_spec" href="?">run all</a>
+    <span id="runnerMessageSpan">Running...</span>
+    <span class="finished-at" id="finishedAtSpan" />
+  </div>
+</div>

data/app/views/jax/suite/run_webgl.html.erb

@@ -0,0 +1,49 @@
+<% content_for :head do %>
+  <%= javascript_include_tag :jquery %>
+  <%= javascript_include_tag 'jax/runtime' %>
+  <%= javascript_include_tag 'jax/controller-list' %>
+  <%= stylesheet_link_tag 'jax/suite' %>
+  <%= stylesheet_link_tag 'jax/controller-list' %>
+<% end %>
+
+<% content_for :below_nav do %>
+  <a href="#" onclick="toggleCustomizationHelp();return false;">customize</a>
+<% end %>
+
+<div id="how-to-customize">
+  <p>
+  This is the default page loaded when Jax doesn't know where to find your real WebGL application.
+  You can continue using this page to test your JavaScript, or you can customize it
+  by adding the following code to <strong>config/initializers/jax.rb</strong>:
+  </p>
+
+  <div class="code">
+  Jax.config.webgl_start = "/path/to/start.html"
+
+  # Alternatively, you can use a routing hash like so:
+  #
+  #   Jax.config.webgl_start = {
+  #     :controller => "webgl",
+  #     :action => "index"
+  #   }
+  #
+  # You can also use a proc to defer the decision until runtime:
+  #
+  #   Jax.config.webgl_start = proc do
+  #     { :controller => "webgl", :action => "profile", :id => params[:id] }
+  #   end
+  #
+  </div>
+</div>
+
+<div id="controller-list" class="list">
+  <!--
+    this list is populated by JS. It contains a selection of controllers for the user to test.
+    When an item is selected, it fires Jax.Controller#redirectTo(item).
+  -->
+</div>
+
+<canvas id="webgl" width="640" height="470">
+  Sorry, your browser doesn't support the &lt;canvas/&gt; tag. Please come back with a newer
+  browser.
+</canvas>

data/app/views/jax/suite/shader_editor.html.erb

@@ -0,0 +1,24 @@
+<% content_for :head do %>
+  <%= javascript_include_tag :jquery %>
+  <%= javascript_include_tag 'jax/shader_editor' %>
+  <%= stylesheet_link_tag "jax/shader_editor"%>
+<% end %>
+
+<% content_for :below_nav do %>
+  <select id="mesh">
+    <option value="Jax.Mesh.Cube">Jax.Mesh.Cube</option>
+    <option value="Jax.Mesh.Plane">Jax.Mesh.Plane</option>
+    <option value="Jax.Mesh.Quad">Jax.Mesh.Quad</option>
+    <option value="Jax.Mesh.Sphere" selected="selected">Jax.Mesh.Sphere</option>
+    <option value="Jax.Mesh.Teapot">Jax.Mesh.Teapot</option>
+    <option value="Jax.Mesh.Torus">Jax.Mesh.Torus</option>
+  </select>
+<% end %>
+
+<div id="material-list" class="list">
+  <!-- holds a list of materials, to be clicked on for editing/previewing -->
+</div>
+
+<div id="preview-div">
+  <canvas id="preview" width="640" height="470"></canvas>
+</div>

data/app/views/layouts/jax.html.erb

@@ -0,0 +1,40 @@
+<!DOCTYPE HTML>
+<html>
+  <head>
+    <title>Jax Development Suite</title>
+    <%= javascript_include_tag 'jax/application' %>
+    <%= javascript_include_tag :jquery %>
+    <%= stylesheet_link_tag 'jax/suite' %>
+
+    <%= yield :head %>
+  </head>
+  
+  <body>
+    <div id="jax-banner">
+      <span class="title">Jax Development Suite</span>
+      <span class="version">v<%= Jax::VERSION %></span>
+    </div>
+
+    <div id="nav">
+      <ul>
+        <li><%= link_to "Test Suite", :action => 'jasmine' %></li>
+        <li><%= link_to "Run Application", :action => "run_webgl" %></li>
+        <li><%= link_to "Materials", :action => "shader_editor" %></li>
+        <li><%= link_to "Guides & Docs", 'http://guides.jaxgl.com' %></li>
+      </ul>
+    </div>
+    
+    <% if !(content = yield(:below_nav).strip.html_safe).blank? %>
+      <div id="below-nav-row">
+        <div id="below-nav">
+          <div id="drop-arrow"></div>
+          <%= content %>
+        </div>
+      </div>
+    <% end %>
+
+    <div id="content">
+      <%= yield %>
+    </div>
+  </body>
+</html>

data/bin/jax

@@ -3,9 +3,13 @@ require "rubygems"
 require "thor"
 require "thor/group"
 
-require File.join(File.expand_path(File.dirname(__FILE__)), "../lib/jax/generators/script_jax_loader")
+begin
+  require "jax/script_loader"
+rescue LoadError
+  puts "Couldn't find Jax!"
+  puts "Try running `gem install jax` first."
+  exit
+end
 
-Jax::Generators::ScriptJaxLoader.exec_script_jax! # this uses exec so, if found, the rest of this file won't load
+Jax::ScriptLoader.invoke!
 
-require File.join(File.expand_path(File.dirname(__FILE__)), "../lib/jax/generators/app")
-JaxAppGenerator.start

data/config/routes.rb

@@ -0,0 +1,2 @@
+# See lib/jax/rails/application.rb for out-of-Rails (and test) routes
+# See lib/jax/engine.rb for Jax routes, both within Rails and without

data/config.ru

@@ -0,0 +1,5 @@
+# This file is used by Rack-based servers to start the application.
+
+# require ::File.expand_path('../config/environment',  __FILE__)
+require 'jax'
+run Jax::Rails::Application

data/features/rails/resources.feature

@@ -0,0 +1,45 @@
+@rails
+Feature: Resources
+
+  Scenario: File system default resource
+    Given file "app/assets/jax/resources/people/default.resource" contains "name: Colin"
+    When I visit "/assets/resources/people/default"
+    Then the response should contain:
+      """
+      Person.addResources({"default":{"name":"Colin"}});
+      """
+
+  Scenario: File system resource
+    Given file "app/assets/jax/resources/people/jennifer.resource" contains "name: Jennifer"
+    When I visit "/assets/resources/people/jennifer"
+    Then the response should contain:
+      """
+      Person.addResources({"jennifer":{"name":"Jennifer"}});
+      """
+
+  Scenario: All resources
+    Given file "app/assets/jax/resources/people/default.resource" contains "name: Colin"
+      And file "app/assets/jax/resources/people/jennifer.resource" contains "name: Jennifer"
+    When I visit "/assets/jax/application.js"
+    Then the response should contain:
+      """
+      "name":"Colin"
+      """
+    And the response should contain:
+      """
+      "name":"Jennifer"
+      """
+
+  Scenario: Add resource after first request
+    Given file "app/assets/jax/resources/people/default.resource" contains "name: Colin"
+    When I visit "/assets/jax/application.js"
+    Then the response should contain:
+      """
+      "name":"Colin"
+      """
+    When file "app/assets/jax/resources/people/jennifer.resource" contains "name: Jennifer"
+      And I visit "/assets/jax/application.js"
+    Then the response should contain:
+      """
+      "name":"Jennifer"
+      """

data/features/rails/shaders.feature

@@ -0,0 +1,13 @@
+Feature: Shaders
+  
+  Scenario: Detect new shaders without reloading app
+    Given shader "water" exists
+      And I visit "/assets/jax/application.js"
+      # necessary to make sure 'shader' directories' mtimes are updated
+      And I wait
+    When shader "other" exists
+      And I visit "/assets/jax/application.js"
+    Then I should see:
+      """
+      shader_data("other")["vertex"]
+      """

data/features/rails/specs.feature

@@ -0,0 +1,24 @@
+@rails
+Feature: Rails Specs
+
+  Scenario: JavaScript spec in Rails
+    Given file "spec/javascripts/script.js" contains "1"
+    When I visit "/spec/script.js"
+    Then I should see "1"
+
+  Scenario: CoffeeScript spec in Rails
+    Given file "spec/javascripts/script.js.coffee" contains "2"
+    When I visit "/spec/script.js"
+    Then I should see "2"
+
+  Scenario: List JS Specs
+    # This is used when building the list of specs to include in the suite.
+    Given file "spec/javascripts/script_spec.js" contains "1"
+    When I visit "/jasmine"
+    Then I should see a "script" element with attribute "src" equal to "/spec/script_spec.js"
+
+  Scenario: List CS Specs
+    # This is used when building the list of specs to include in the suite.
+    Given file "spec/javascripts/script_spec.js.coffee" contains "2"
+    When I visit "/jasmine"
+    Then I should see a "script" element with attribute "src" equal to "/spec/script_spec.js"

data/features/runtime.feature

@@ -0,0 +1,15 @@
+Feature: Runtime
+
+  Scenario: Default runtime
+    Given I am on the WebGL start page
+    Then I should see a "canvas" element
+
+  Scenario: Runtime with string
+    Given the WebGL start page is "/webgl_start.html"
+    Then the WebGL start path should be "/webgl_start.html"
+
+  Scenario: Runtime with hash
+    Given the WebGL start page is a hash with the following keys:
+      | controller | action   |
+      | jax/suite  | jasmine  |
+    Then the WebGL start path should be "http://www.example.com/jasmine"

data/features/step_definitions/environment_steps.rb

@@ -0,0 +1,15 @@
+Given /^file "([^"]*)" contains "([^"]*)"$/ do |arg1, arg2|
+  create_file arg1, arg2
+end
+
+When /^I visit "([^"]*)"$/ do |arg1|
+  visit arg1
+end
+
+Given /^shader "([^"]*)" exists$/ do |arg1|
+  create_shader arg1, :vertex => "void main(void) { gl_Position = vec4(0,0,0,1); }"
+end
+
+Given /^I wait$/ do
+  sleep(1)
+end

data/features/step_definitions/response_steps.rb

@@ -0,0 +1,13 @@
+Then /^show me the response$/ do
+  puts page.body
+end
+
+Then /^I should see:$/ do |text|
+  page.body.should =~ /#{Regexp::escape(text)}/
+end
+
+# Basically the same as 'I should see' but used for matchers
+# against jax/application.js, which is huge.
+Then /^the response should contain:$/ do |text|
+  (!!page.body.to_s[text]).should be_true
+end

data/features/step_definitions/runtime.rb

@@ -0,0 +1,11 @@
+Given /^the WebGL start page is "([^"]*)"$/ do |arg1|
+  Jax.config.webgl_start = arg1
+end
+
+Then /^the WebGL start path should be "([^"]*)"$/ do |arg1|
+  url_for(Jax.config.webgl_start).should == arg1
+end
+
+Given /^the WebGL start page is a hash with the following keys:$/ do |table|
+  Jax.config.webgl_start = table.hashes.first
+end