hobgoblin/src/repository.js

A framework for writing roguelike games in JavaScript, implementing ROT.js

Game.Repository = function(name, ctor) {
	this._name = name;
	this._templates = {};
    this._randomTemplates = {};
	this._ctor = ctor; // ctor = 'constructor'
};

Game.Repository.prototype.getTemplate = function(name) {
    return this._templates[name];
};

Game.Repository.prototype.getTemplates = function() {
    return this._templates;
};

// Define a new named template.
Game.Repository.prototype.define = function(name, template, options) {
    this._templates[name] = template;
    // Apply any options
    var disableRandomCreation = options && options['disableRandomCreation'];
    if (!disableRandomCreation) {
        this._randomTemplates[name] = template;
    }
};

// Create an object based on a template.
Game.Repository.prototype.create = function(name, extraProperties) {
    if(!this._templates[name]) {
        throw new Error("No template named '" + name + "' in repository '" + this._name + "'");
    }
    // Copy the template
    var template = Object.create(this._templates[name]);
    // Apply any extra properties
    if(extraProperties) {
        for (var key in extraProperties) {
            // If a template has a property like
            // {random: true, values: ['val1', 'val2', 'val3']}
            // then create the element with a random value
            if(
                extraProperties[key]['random'] &&
                extraProperties[key]['random'] === true &&
                extraProperties[key]['values'] &&
                extraProperties[key]['values'].constructor === Array
            ) {
                template[key] = extraProperties[key]['values'].random();
            } else {
                template[key] = extraProperties[key];
            }
        }
    }
    // Create the object, passing the template as an argument
    return new this._ctor(template);
};

// Create an object based on a random template
Game.Repository.prototype.createRandom = function() {
    // Pick a random key and create an object based off of it.
    return this.create(Object.keys(this._randomTemplates).random());
};

// Cycle through all the templates. If a template has a function that's name
// matches the criteria string, it will execute that function to determine whether 
// or not to create the current template. If none are found, return false.
Game.Repository.prototype.createIf = function(criteria) {
    var names = [];
    for (var name in this._templates) {
        names.push(name);
    };
    var randomized = names.randomize();

    // Loop through a randomized array of templates...
    for(var i = 0; i < randomized.length; i++) {
        // Create the object
        var temp = this.create(randomized[i]);

        // Check to see if the temp object has the function
        // that's name matches the criteria string
        if(temp[criteria]) {
            // Get any additional arguments passed to this function
            var args = Array.prototype.slice.call(arguments, 1)

            // Execute the criteria function
            var create = temp[criteria].apply(temp, args);
            if(create) {
                // If it passes, return the temp object
                return temp;
            } else {
                continue;
            }
        }
    }
    return false;
};