Complete the RecipeBook controller

src/scripts/constants.coffee

@@ -15,10 +15,20 @@ exports.Opacity = Opacity = {}
 Opacity.hidden  = 1e-6
 Opacity.shown   = 1
 
-exports.Event             = Event = {}
-Event.book                = {}
-Event.book.load           = {}
-Event.book.load.started   = 'book:load:started'   # controller, url
-Event.book.load.succeeded = 'book:load:succeeded' # controller, book
-Event.book.load.failed    = 'book:load:failed'    # controller, error message
-Event.book.load.finished  = 'book:load:finished'  # controller
+exports.Event        = Event = {}
+Event.change         = 'change'
+Event.load           = {}
+Event.load.started   = 'book:load:started'   # controller, url
+Event.load.succeeded = 'book:load:succeeded' # controller, book
+Event.load.failed    = 'book:load:failed'    # controller, error message
+Event.load.finished  = 'book:load:finished'  # controller
+
+exports.DefaultBookUrls = DefaultBookUrls = [
+    '/data/vanilla.json'
+    '/data/applied_energetics.json'
+    '/data/buildcraft.json'
+    '/data/gravisuite.json'
+    '/data/industrial_craft.json'
+    '/data/more_blocks.json'
+    '/data/thermal_expansion.json'
+]

src/scripts/controllers/base_controller.coffee

@@ -12,6 +12,9 @@ views = require '../views'
 module.exports = class BaseController extends Backbone.View
 
     constructor: (options={})->
+        Object.defineProperty this, 'model', get:@getModel, set:@setModel
+
+        @_model    = null
         @_rendered = false
         @_parent   = options.parent
         @_children = []
@@ -35,10 +38,40 @@ module.exports = class BaseController extends Backbone.View
 
     # Event Methods ################################################################################
 
+    onDidModelChange: ->
+        @_tryRefresh()
+
+    onDidModelSync: ->
+        @_tryRefresh()
+
     onWillRender: -> # do nothing
 
     onDidRender: ->
-        @refresh()
+        @_tryRefresh()
+
+    onWillShow: -> # do nothing
+
+    onDidShow: -> # do nothing
+
+    onWillChangeModel: (oldModel, newModel)->
+        if oldModel?.on?
+            @stopListening oldModel
+        if newModel?.on?
+            @listenTo newModel, 'sync', (e)=> @onDidModelSync e
+            @listenTo newModel, 'change', (e)=> @onDidModelChange e
+        return true
+
+    # Property Methods #############################################################################
+
+    getModel: ->
+        return @_model
+
+    setModel: (newModel)->
+        return if @model is newModel
+        return unless @onWillChangeModel @_model, newModel
+
+        @_model = newModel
+        @_tryRefresh()
 
     # Backbone.View Overrides ######################################################################
 
@@ -75,3 +108,7 @@ module.exports = class BaseController extends Backbone.View
     _loadTemplate: (templateName)->
         if templateName?
             @_template = views[templateName]
+
+    _tryRefresh: ->
+        return unless @_rendered
+        @refresh()

src/scripts/controllers/landing_page_controller.coffee

@@ -1,5 +1,5 @@
 ###
-# Crafting Guide - crafting_guide_controller.coffee
+# Crafting Guide - landing_page_controller.coffee
 #
 # Copyright (c) 2014 by Redwood Labs
 # All rights reserved.
@@ -21,5 +21,5 @@ module.exports = class LandingPageController extends BaseController
     # BaseController Overrides #####################################################################
 
     onDidRender: ->
-        @recipeBooksController = @addChild RecipeCatalogController, '.view__recipe_catalog'
+        @recipeBooksController = @addChild RecipeCatalogController, '.view__recipe_catalog', model:@model.catalog
         super

src/scripts/controllers/recipe_book_controller.coffee

@@ -0,0 +1,28 @@
+###
+# Crafting Guide - recipe_book_controller.coffee
+#
+# Copyright (c) 2014 by Redwood Labs
+# All rights reserved.
+###
+
+BaseController = require './base_controller'
+
+########################################################################################################################
+
+module.exports = class RecipeBookController extends BaseController
+
+    constructor: (options={})->
+        if not options.model? then throw new Error "options.model is required"
+        options.templateName = 'recipe_book'
+        super options
+
+    # BaseController Overrides #####################################################################
+
+    onDidRender: ->
+        @$name = @$('td:nth-child(1) p')
+        @$description = @$('td:nth-child(2) p')
+        super
+
+    refresh: ->
+        @$name.html "#{@model.modName} (#{@model.modVersion})"
+        @$description.html "#{@model.description}"

src/scripts/controllers/recipe_catalog_controller.coffee

@@ -5,12 +5,36 @@
 # All rights reserved.
 ###
 
-BaseController = require './base_controller'
+BaseController       = require './base_controller'
+RecipeBookController = require './recipe_book_controller'
 
 ########################################################################################################################
 
 module.exports = class RecipeCatalogController extends BaseController
 
     constructor: (options={})->
+        if not options.model? then throw new Error "options.model is required"
+        @_bookControllers = []
+
         options.templateName = 'recipe_catalog'
         super options
+
+    # BaseController Overrides #####################################################################
+
+    onDidRender: ->
+        @$table = @$('table')
+        super
+
+    refresh: ->
+        @$('table tr:not(:last-child)').remove()
+        return unless @model?
+
+        @_bookControllers = []
+        for i in [@model.books.length-1..0] by -1
+            book = @model.books[i]
+            controller = new RecipeBookController model:book
+            controller.render()
+            @_bookControllers.push controller
+            @$table.prepend controller.$el
+
+        super

src/scripts/crafting_guide_router.coffee

@@ -41,14 +41,15 @@ module.exports = class CraftingGuideRouter extends Backbone.Router
         show = =>
             @_page = controller
 
+            controller.onWillShow()
             controller.render()
-            # controller.$el.css 'opacity', Opacity.hidden
 
             $pageContent = $('.page')
             $pageContent.empty()
             $pageContent.append controller.$el
 
-            controller.$el.fadeIn showDuration
+            controller.$el.fadeIn showDuration, ->
+                controller.onDidShow()
 
         if @_mainController?
             showDuration = Duration.fast

src/scripts/models/recipe_catalog.coffee

@@ -5,9 +5,10 @@
 # All rights reserved.
 ###
 
-BaseModel        = require './base_model'
-{Event}         = require '../constants'
-RecipeBookParser = require './recipe_book_parser'
+BaseModel         = require './base_model'
+{DefaultBookUrls} = require '../constants'
+{Event}           = require '../constants'
+RecipeBookParser  = require './recipe_book_parser'
 
 ########################################################################################################################
 
@@ -18,35 +19,51 @@ module.exports = class RecipeCatalog extends BaseModel
         super attributes, options
 
         @_parser = new RecipeBookParser
+        if @books.length is 0
+            @loadAllBooks DefaultBookUrls
 
     # Public Methods ###############################################################################
 
     loadBook: (url)->
-        @trigger Event.book.load.started, this, url
-        $.ajax
-            url: url
-            dataType: 'json'
-            success: (data, status, xhr)=> @onBookLoaded(data, status, xhr)
-            error: (xhr, status, error)=> @onBookLoadFailed(error, status, xhr)
+        w.promise (resolve, reject)=>
+            @trigger Event.load.started, this, url
+            $.ajax
+                url: url
+                dataType: 'json'
+                success: (data, status, xhr)=>
+                    resolve @onBookLoaded(url, data, status, xhr)
+                error: (xhr, status, error)=>
+                    reject @onBookLoadFailed(url, error, status, xhr)
+
+    loadAllBooks: (urlList)->
+        promises = (@loadBook(url) for url in urlList)
+        return w.settle promises
 
     # Event Methods ################################################################################
 
-    onBookLoaded: (data, status, xhr)->
+    onBookLoaded: (url, data, status, xhr)->
         try
-            @books.push @_parser.parse data
-            _(@books).sortBy 'name'
+            book = @_parser.parse data
+            @books.push book
+            @books.sort (a, b)->
+                return 0 if a.modName is b.modName
+                return if a.modName < b.modName then -1 else +1
 
-            logger.info "loaded recipe book: #{book}"
-            @trigger Event.book.load.succeeded, this, book
-            @trigger Event.book.load.finished, this
+            logger.info "loaded recipe book from #{url}: #{book}"
+            @trigger Event.load.succeeded, this, book
+            @trigger Event.load.finished, this
+            @trigger Event.change, this
+
+            return book
         catch e
-            @onBookLoadFailed error, status, xhr
+            @onBookLoadFailed url, e, status, xhr
 
-
-    onBookLoadFailed: (error, status, xhr)->
-        logger.error "failed to load recipe book: #{error}"
-        @trigger Event.book.load.failed, this, error.message
-        @trigger Event.book.load.finished, this
+    onBookLoadFailed: (url, error, status, xhr)->
+        message = if error.stack? then error.stack else error
+        logger.error "failed to load recipe book from #{url}: #{message}"
+        @trigger Event.load.failed, this, error.message
+        @trigger Event.load.finished, this
+        return error
 
     # Object Overrides #############################################################################
 

src/scripts/views.js

@@ -11,13 +11,22 @@ var jade_indent = [];
 buf.push("\n<div class=\"view__landing_page\">\n  <div class=\"view__recipe_catalog\"></div>\n  <div class=\"view__crafter\"></div>\n</div>");;return buf.join("");
 };
 
+this["JST"]["recipe_book"] = function template(locals) {
+var buf = [];
+var jade_mixins = {};
+var jade_interp;
+
+var jade_indent = [];
+buf.push("\n<tr>\n  <td>\n    <p></p>\n  </td>\n  <td>\n    <p></p>\n  </td>\n</tr>");;return buf.join("");
+};
+
 this["JST"]["recipe_catalog"] = function template(locals) {
 var buf = [];
 var jade_mixins = {};
 var jade_interp;
 
 var jade_indent = [];
-buf.push("\n<div class=\"view__recipe_catalog\">\n  <h2><img src=\"/images/bookshelf.png\"/>\n    <p>Recipe Catalog</p>\n  </h2>\n  <table class=\"books\">\n    <tr>\n      <td>&nbsp;</td>\n      <td>\n        <input placeholder=\"enter a URL to load another recipe book...\" class=\"recipe_book_url\"/>\n        <button class=\"recipe_book_load_button\">Load</button>\n      </td>\n    </tr>\n  </table>\n  <div class=\"load_error\">\n    <p></p>\n  </div>\n</div>");;return buf.join("");
+buf.push("\n<div class=\"view__recipe_catalog\">\n  <h2><img src=\"/images/bookshelf.png\"/>\n    <p>Recipe Catalog</p>\n  </h2>\n  <table>\n    <tr>\n      <td>&nbsp;</td>\n      <td>\n        <input placeholder=\"enter a URL to load another recipe book...\" class=\"recipe_book_url\"/>\n        <button class=\"recipe_book_load_button\">Load</button>\n      </td>\n    </tr>\n  </table>\n  <div class=\"load_error\">\n    <p></p>\n  </div>\n</div>");;return buf.join("");
 };
 
 this["JST"]["test"] = function template(locals) {