From 1582d54ecaf81cb516a28368c0d409b5d5fe7da9 Mon Sep 17 00:00:00 2001
From: Dean Sofer <proloser@hotmail.com>
Date: Fri, 18 Oct 2013 13:36:21 -0700
Subject: [PATCH] feat(alias): Created a new ui-alias module for
 renaming/combining directives

---
 modules/alias/README.md | 42 +++++++++++++++++++++++++++++++++++++++++
 modules/alias/alias.js  | 14 ++++++++++++++
 2 files changed, 56 insertions(+)
 create mode 100644 modules/alias/README.md
 create mode 100644 modules/alias/alias.js

diff --git a/modules/alias/README.md b/modules/alias/README.md
new file mode 100644
index 00000000..5c72a791
--- /dev/null
+++ b/modules/alias/README.md
@@ -0,0 +1,42 @@
+ui-alias
+--------
+
+Rename third-party directives or quickly generate simple template directives for use internally in your app!
+
+* Sick of the `ui-*` `bs-*` and other such prefixes cluttering up your beautiful html? 
+* Always find you're calling the same set of directives together?
+
+Now you can **ALIAS** it!
+
+## Installation
+
+1. Load `alias.js`
+2. Add `ui.alias` as a dependency
+3. Create a `uiAliasConfig` constant on the `ui.alias` module
+
+## Configuration
+
+* Create a `constant` on the `ui.alias` module
+* Keys are your alias, while the values are either a string template or a [DirectiveDefinitionObject](http://docs.angularjs.org/guide/directive#writingdirectiveslongversion)
+* Aliases create new directives that generate templates
+* Alias directives are `replace: true` by default unless explicitly set to `false`
+
+```js
+angular.module('ui.alias').constant('uiAliasConfig', {
+	'alias': '<template dir1 dir2 options="customConfigScopeVar"></template>',
+	'alias2': {
+		template: '<another-template></another-template>',
+		restrict: 'AEC'
+	}
+	// Example:
+	date: '<input ui-date ui-date-format="mm/dd/yyyy">'
+
+});
+```
+
+## Notes
+
+* Be careful to avoid creating an alias that fires recursively  
+  Example: `<button>` -> `<ui-button>` -> `<button>`
+* You cannot override existing directives. Both the original *and* your alias directives will execute.
+* You can create multiple an alias for different configurations of the same directives / templates
\ No newline at end of file
diff --git a/modules/alias/alias.js b/modules/alias/alias.js
new file mode 100644
index 00000000..184a0cf7
--- /dev/null
+++ b/modules/alias/alias.js
@@ -0,0 +1,14 @@
+angular.module('ui.alias', []).config(['$compileProvider', 'uiAliasConfig', function($compileProvider, uiAliasConfig){
+  uiAliasConfig = uiAliasConfig || {};
+  angular.forEach(uiAliasConfig, function(config, alias){
+    if (angular.isString(config)) {
+      config = {
+        replace: true,
+        template: config
+      };
+    }
+    $compileProvider.directive(alias, function(){
+      return config;
+    });
+  });
+}]);
\ No newline at end of file