merge from angular-ui/angular-ui master

Author: edeustace

.gitignore

@@ -1 +1,3 @@
-node_modules
+node_modules
+*.coffee.js
+.idea

CHANGELOG.md

@@ -0,0 +1,9 @@
+# [Cha Cha Cha Changes](http://www.youtube.com/watch?v=pl3vxEudif8&t=0m53s)
+
+## master
+* **Prettifier** renamed to **inflector**
+* Unit tests
+
+## v0.1.0
+* New folder structure
+* Too many to list

Jakefile.coffee

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2012 the AngularUI Team, http://angular-ui.github.com
+
+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.

LICENSE

@@ -1,4 +1,4 @@
-# AngularUI
+# AngularUI - The companion suite for AngularJS
 
 ***
 
@@ -9,85 +9,63 @@
 * **AngularJS v1.0.0+** is currently required.
 * **jQuery / Plugins** _(depends on directive)._ Check specific directive dependencies for more information
 
-### Installation
+## Installation
 
-The repository comes with the modules pre-built and compressed into the build directory.
-
-0. _Coming Soon_ Generate a custom build of angular-ui containing only the components you want and nothing more
-1. Include the javascript files - angular-ui.js or angular-ui.min.js  
-2. Add a dependency to the ui module in your angular application module:
+The repository comes with the modules pre-built and compressed into the `build/` directory.
 
 ```javascript
 angular.module('myApp', ['ui']);
 ```
 
 The modules can be found in the [Directives](http://github.com/angular-ui/angular-ui/modules/directives) and [Filters](http://github.com/angular-ui/angular-ui/modules/filters) folders. Check out the readme file associated with each module for specific module usage information.
 
-## Building
+## Development
 
-You do not need to build the project to use it - see above - but if you are hacking on it then this is what you need to know.
+You do not need to build the project to use it - see above - but if you are working on it then this is what you need to know.
 
 ### Requirements
 
-Install UglifyJS & LESS:
+0. Install [Node.js](http://nodejs.org/) and NPM (should come with)
+
+1. Install local dependencies:
 
 ```bash
-$ [sudo] npm install uglify-js -g  
-$ [sudo] npm install less -g  
-$ [sudo] npm install coffee-script -g
+$ npm install
 ```
 
-### Build/Compress
+2. Install global dependencies `grunt`, `coffee-script`, and `testacular`:
 
 ```bash
-$ make build
+$ npm install -g testacular coffee-script grunt
 ```
 
-## Testing
-
-The modules come with unit tests that should be run on any changes and certainly before commiting changes to the project.  The unit tests should also provide further insight into the usage of the modules.
+### Build Files & Run Tests
 
-### Requirements
-The project is configured to use the marvellous [Testacular](http://vojtajina.github.com/testacular/) test runner from AngularJS developer Vojta.  It is a nodeJS app.  You simply install it from NPM:
+Before you commit, always run `grunt` to build and test everything once.
 
 ```bash
-$ [sudo] npm install testacular -g
+$ grunt
 ```
 
-The test configuration is in test/test-config.js.  You pass this in when you run the test server:
-
-```bash
-$ testacular test/test-config.js
-```
+### Test & Develop
 
-Capture your testing browsers by browsing to http://localhost:8080 (in this case) on all the different flavours of browser you wish to test.
+The modules come with unit tests that should be run on any changes and certainly before commiting changes to the project.  The unit tests should also provide further insight into the usage of the modules.
 
-Then whenever you make a change either run
+First, start the testacular server:
 ```bash
-$ make build
-$ testacular-run
+$ grunt server
 ```
-
-Or even quicker
-
+Then, open your browser to http://localhost:8080 and run the watch command to re-run tests on every save:
 ```bash
-$ make test
+$ grunt watch
 ```
 
-# Template
+### Publishing
 
-The `ui.config` dependency is optional, however it is **highly** recommended that you leverage this so that developers may set app-wide defaults instead of passing the same parameters to every directive.
+For core team: if you wish to publish a new version follow these steps:
 
-```javascript
-
-/**
- * Directive Description
- * @param expression {type} description
- * @example code demo (if possible)
- */
-angular.module('ui.directives').directive('uiMYDIRECTIVE', ['ui.config', function(uiConfig) {
-  return function(scope, elm, attrs) {
-  };
-}]);
-
-```
+1. Bump the version number inside `package.json`
+2. Build and test
+3. Commit the updated `package.json` and `build/` folder on their own commit
+4. Tag the commit: `git tag v[maj].[min].[patch]`
+5. Push the tag: `git push [angular-ui] master --tags`

Makefile

@@ -1,3 +1,10 @@
+/**
+ * AngularUI - The companion suite for AngularJS
+ * @version v0.1.0 - 2012-07-20
+ * @link http://angular-ui.github.com
+ * @license MIT License, http://www.opensource.org/licenses/MIT
+ */
+
 // READ: http://docs-next.angularjs.org/guide/ie
 (function(exports){
 

README.md

@@ -1,34 +1,46 @@
+
+
 /**
  * import components to builds angular-ui.css
  */
+
 /* ui-reset */
+
 .ui-resetwrap {
-  display: inline-block;
   position: relative;
+  display: inline-block;
 }
+
 .ui-reset {
-  display: none;
   position: absolute;
-  cursor: pointer;
   top: 0;
   right: 0;
   z-index: 2;
+  display: none;
   height: 100%;
+  cursor: pointer;
 }
+
 .ui-resetwrap:hover .ui-reset {
   display: block;
 }
+
 /* ui-currency */
+
 .ui-currency-pos {
   color: green;
 }
+
 .ui-currency-neg {
   color: red;
 }
+
 .ui-currency-zero {
   color: blue;
 }
+
 /* highlight */
+
 .ui-match {
   background: yellow;
-}
+}