feat(grunt): use Angular UI Publisher

Merge branch 'douglasduteil-ft-component-publisher'

Closes #153

Author: douglasduteil

.gitignore

@@ -1,4 +1,7 @@
 bower_components/
 node_modules/
-.rcs
-*.swp
+out/
+dist/
+
+# don't track generated/copied html demo files
+demo/*.html

.jshintrc

@@ -0,0 +1,23 @@
+{
+  "boss": true,
+  "browser": true,
+  "eqnull": true,
+  "expr": true,
+  "globalstrict": true,
+  "immed": true,
+  "laxbreak": true,
+  "loopfunc": true,
+  "newcap": true,
+  "noarg": true,
+  "noempty": true,
+  "nonew": true,
+  "quotmark": true,
+  "smarttabs": true,
+  "sub": true,
+  "trailing": true,
+  "undef": true,
+  "unused": true,
+  "globals": {
+    "angular": false
+  }
+}

.travis.yml

@@ -1,15 +1,17 @@
 ---
 language: node_js
 node_js:
-- '0.8'
+- '0.10'
 before_install:
 - export DISPLAY=:99.0
 - sh -e /etc/init.d/xvfb start
-- npm install -g bower grunt-cli
-- npm install
-- bower install
-before_script: bower_components/angular-ui-docs/.travis/before_script.sh
-after_success: bower_components/angular-ui-docs/.travis/after_success.sh
+- npm install -qg bower grunt-cli
+- npm install -q
+- bower install --force
+- bower install --force
+after_success:
+- "./node_modules/angular-ui-publisher/travis/authentication.sh || exit 0"
+- "grunt dist build:gh-pages publish:gh-pages build:bower publish:bower build:subbower publish:subbower"
 script: grunt
 env:
   global:

README.md

@@ -1,56 +1,87 @@
-# AngularUI - The companion suite for AngularJS
+# UI.Utils [![Build Status](https://travis-ci.org/angular-ui/ui-utils.png?branch=master)](https://travis-ci.org/angular-ui/ui-utils)
 
-***
+The companion suite for AngularJS
 
-[![Build Status](https://travis-ci.org/angular-ui/ui-utils.png?branch=master)](https://travis-ci.org/angular-ui/ui-utils)
+## Requirements
+
+- AngularJS
 
 ## Usage
 
-### Requirements
 
-* **AngularJS v1.0.0+** is currently required.
-* **jQuery*** Until the refactor is complete, some directives still require jQuery
+You can get it from [Bower](http://bower.io/)
+
+```sh
+# All the modules
+bower install angular-ui-utils\#bower
+
+# A specific module
+# bower install angular-ui-utils\#bower-<moduleName>
+bower install angular-ui-utils\#bower-event
+bower install angular-ui-utils\#bower-keypress
+...
+
+# A specific version
+bower install angular-ui-utils\#v0.0.4
+# A specific module version
+bower install angular-ui-utils\#event-0.0.4
+bower install angular-ui-utils\#keypress-0.0.4
+...
+
+# If you want the sources with it
+bower install angular-ui-utils
+# or for a specific source version
+bower install angular-ui-utils\#src0.0.4
+```
+
+This will copy the UI.Utils files into a `bower_components` folder, along with its dependencies. Load the script files in your application:
+
+```html
+<script type="text/javascript" src="bower_components/angular/angular.js"></script>
+<!-- for all the modules -->
+<script type="text/javascript" src="bower_components/angular-ui-utils/ui-utils.js"></script>
 
-## Installation
+<!-- or just specific one-->
+<script type="text/javascript" src="bower_components/angular-ui-event/event.js"></script>
+<script type="text/javascript" src="bower_components/angular-ui-keypress/keypress.js"></script>
+<!-- ... -->
+```
 
 Add the specific modules to your dependencies, or add the entire lib by depending on `ui.utils`
 
 ```javascript
 angular.module('myApp', ['ui.keypress', 'ui.event', ...])
 // or if ALL modules are loaded along with modules/utils.js
-angular.module('myApp', ['ui.utils'])
+var myAppModule = angular.module('MyApp', ['ui.utils']);
 ```
 
 Each directive and filter is now it's own module and will have a relevant README.md in their respective folders
 
 ## Development
 
-At this time, we do not have a build script. You must include all `.js` files you wish to work on.
-We will likely be adding a `Gruntfile.js` in the near future for this
+We use Karma and jshint to ensure the quality of the code.  The easiest way to run these checks is to use grunt:
 
-### Requirements
+```sh
+npm install -g grunt-cli
+npm install && bower install
+grunt
+```
 
-0. Install [Node.js](http://nodejs.org/) and NPM (should come with)
+The karma task will try to open Firefox and Chrome as browser in which to run the tests.  Make sure this is available or change the configuration in `test\karma.conf.js`
 
-1. Install global dependencies `grunt-cli`, `bower`, and `karma`:
 
-    ```bash
-    $ npm install -g karma grunt-cli bower
-    ```
+### Grunt Serve
 
-2. Install local dependencies:
+We have one task to serve them all !
 
-    ```bash
-    $ npm install
-    $ bower install
-    ```
+```sh
+grunt serve
+```
 
-### Running Tests
+It's equal to run separately:
 
-Make sure all tests pass in order for your Pull Request to be accepted
+* `grunt connect:server` : giving you a development server at [http://127.0.0.1:8000/](http://127.0.0.1:8000/).
 
-You can choose what browsers to test in: `Chrome,ChromeCanary,Firefox,PhantomJS`
+* `grunt karma:server` : giving you a Karma server to run tests (at [http://localhost:9876/](http://localhost:9876/) by default). You can force a test on this server with `grunt karma:unit:run`.
 
-```bash
-$ karma start --browsers=Chrome,Firefox test/karma.conf.js --single-run=true
-```
+* `grunt watch` : will automatically test your code and build your demo.  You can demo generation with `grunt build:gh-pages`.

bower.json

@@ -10,7 +10,6 @@
   },
   "devDependencies": {
     "angular-mocks": "~1.0.5",
-    "jquery": ">=1.6",
-    "angular-ui-docs": "angular-ui/angular-ui-docs"
+    "jquery": ">=1.6"
   }
 }

demo/demo.js

@@ -1,15 +1,16 @@
+'use strict';
 
 angular.module('doc.ui-utils', ['ui.utils', 'prettifyDirective' ]);
 
 angular.module('ui.scroll')
     .factory('datasource', [
-    '$log', '$timeout', '$rootScope', function(console, $timeout, $rootScope) {
+    '$log', '$timeout', function(console, $timeout) {
         var get = function(index, count, success) {
             return $timeout(function() {
                 var i, result, _i, _ref;
                 result = [];
                 for (i = _i = index, _ref = index + count - 1; index <= _ref ? _i <= _ref : _i >= _ref; i = index <= _ref ? ++_i : --_i) {
-                    result.push("item #" + i);
+                    result.push('item #' + i);
                 }
                 return success(result);
             }, 100);