Merge pull request #3580 from tkoomzaaskz/added-radio.js-library

added radio.js library

ajax/libs/radio/0.2.0/radio.js

@@ -0,0 +1,176 @@
+/**
+ Radio.js - Chainable, Dependency Free Publish/Subscribe for Javascript
+ http://radio.uxder.com
+ Author: Scott Murphy 2011
+ twitter: @hellocreation, github: uxder
+ 
+ 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 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.
+ */
+(function (name, global, definition) {
+  if (typeof module !== 'undefined') module.exports = definition(name, global);
+  else if (typeof define === 'function' && typeof define.amd  === 'object') define(definition);
+  else global[name] = definition(name, global);
+})('radio', this, function (name, global) {
+
+  "use strict";
+
+  /**
+   * Main Wrapper for radio.$ and create a function radio to accept the channelName
+   * @param {String} channelName topic of event
+   */
+  function radio(channelName) {
+    arguments.length ? radio.$.channel(channelName) : radio.$.reset();
+    return radio.$;
+  }
+
+  radio.$ = {
+    version: '0.2',
+    channelName: "",
+    channels: [],
+
+    /**
+     * Reset global state, by removing all channels
+     * @example
+     *    radio()
+     */
+    reset: function() {
+      radio.$.channelName = "";
+      radio.$.channels = [];
+    },
+ 
+    /**
+     * Broadcast (publish)
+     * Iterate through all listeners (callbacks) in current channel and pass arguments to subscribers
+     * @param arguments data to be sent to listeners
+     * @example
+     *    //basic usage
+     *    radio('channel1').broadcast('my message'); 
+     *    //send an unlimited number of parameters
+     *    radio('channel2').broadcast(param1, param2, param3 ... );
+     */
+    broadcast: function() {
+      var i, c = this.channels[this.channelName],
+        l = c.length,
+        subscriber, callback, context;
+      //iterate through current channel and run each subscriber
+      for (i = 0; i < l; i++) {
+        subscriber = c[i];
+        //if subscriber was an array, set the callback and context.
+        if ((typeof(subscriber) === 'object') && (subscriber.length)) {
+          callback = subscriber[0];
+          //if user set the context, set it to the context otherwise, it is a globally scoped function
+          context = subscriber[1] || global;
+        }
+        callback.apply(context, arguments);
+      }
+      return this;
+    },
+
+    /**
+     * Create the channel if it doesn't exist and set the current channel/event name
+     * @param {String} name the name of the channel
+     * @example
+     *    radio('channel1');
+     */
+    channel: function(name) {
+      var c = this.channels;
+      //create a new channel if it doesn't exists
+      if (!c[name]) c[name] = [];
+      this.channelName = name;
+      return this;
+    },
+
+    /**
+     * Add Subscriber to channel
+     * Take the arguments and add it to the this.channels array.
+     * @param {Function|Array} arguments list of callbacks or arrays[callback, context] separated by commas
+     * @example
+     *      //basic usage
+     *      var callback = function() {};
+     *      radio('channel1').subscribe(callback); 
+     *
+     *      //subscribe an endless amount of callbacks
+     *      radio('channel1').subscribe(callback, callback2, callback3 ...);
+     *
+     *      //adding callbacks with context
+     *      radio('channel1').subscribe([callback, context],[callback1, context], callback3);
+     *     
+     *      //subscribe by chaining
+     *      radio('channel1').subscribe(callback).radio('channel2').subscribe(callback).subscribe(callback2);
+     */
+    subscribe: function() {
+      var a = arguments,
+        c = this.channels[this.channelName],
+        i, l = a.length,
+        p, ai = [];
+
+      //run through each arguments and subscribe it to the channel
+      for (i = 0; i < l; i++) {
+        ai = a[i];
+        //if the user sent just a function, wrap the fucntion in an array [function]
+        p = (typeof(ai) === "function") ? [ai] : ai;
+        if ((typeof(p) === 'object') && (p.length)) c.push(p);
+      }
+      return this;
+    },
+
+    /**
+     * Remove subscriber from channel
+     * Take arguments with functions and unsubscribe it if there is a match against existing subscribers.
+     * @param {Function} arguments callbacks separated by commas
+     * @example
+     *      //basic usage
+     *      radio('channel1').unsubscribe(callback); 
+     *      //you can unsubscribe as many callbacks as you want
+     *      radio('channel1').unsubscribe(callback, callback2, callback3 ...);
+     *       //removing callbacks with context is the same
+     *      radio('channel1').subscribe([callback, context]).unsubscribe(callback);
+     */
+    unsubscribe: function() {
+      var a = arguments,
+        i, j, c = this.channels[this.channelName],
+        l = a.length,
+        cl = c.length,
+        offset = 0,
+        jo;
+      //loop through each argument
+      for (i = 0; i < l; i++) {
+        //need to reset vars that change as the channel array items are removed
+        offset = 0;
+        cl = c.length;
+        //loop through the channel
+        for (j = 0; j < cl; j++) {
+          jo = j - offset;
+          //if there is a match with the argument and the channel function, unsubscribe it from the channel array
+          if (c[jo][0] === a[i]) {
+            //unsubscribe matched item from the channel array
+            c.splice(jo, 1);
+            offset++;
+          }
+        }
+      }
+      return this;
+    }
+  };
+
+  return radio;
+});

ajax/libs/radio/0.2.0/radio.min.js

@@ -0,0 +1 @@
+(function(a,c,b){if(typeof module!=="undefined"){module.exports=b(a,c)}else{if(typeof define==="function"&&typeof define.amd==="object"){define(b)}else{c[a]=b(a,c)}}})("radio",this,function(b,c){function a(d){a.$.channel(d);return a.$}a.$={version:"0.2",channelName:"",channels:[],broadcast:function(){var f,j=this.channels[this.channelName],d=j.length,g,h,e;for(f=0;f<d;f++){g=j[f];if((typeof(g)==="object")&&(g.length)){h=g[0];e=g[1]||c}h.apply(e,arguments)}return this},channel:function(d){var e=this.channels;if(!e[d]){e[d]=[]}this.channelName=d;return this},subscribe:function(){var f=arguments,j=this.channels[this.channelName],g,e=f.length,h,d=[];for(g=0;g<e;g++){d=f[g];h=(typeof(d)==="function")?[d]:d;if((typeof(h)==="object")&&(h.length)){j.push(h)}}return this},unsubscribe:function(){var g=arguments,k,h,n=this.channels[this.channelName],f=g.length,e=n.length,m=0,d;for(k=0;k<f;k++){m=0;e=n.length;for(h=0;h<e;h++){d=h-m;if(n[d][0]===g[k]){n.splice(d,1);m++}}}return this}};return a});

ajax/libs/radio/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "radio",
+  "filename": "radio.min.js",
+  "description": "A small dependency-free publish/subscribe (pub/sub) javascript library",
+  "version": "0.2.0",
+  "homepage": "http://radio.uxder.com/",
+  "author": "Scott Murphy, @hellocreation",
+  "keywords": [ "pubsub", "pub/sub","publish","subscribe","events", "ender" ],
+  "main": "./radio.js",
+  "ender": "./ender.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uxder/Radio.git"
+  }
+}