ADD: test for localize

Author: futurist

.editorconfig

@@ -0,0 +1,7 @@
+root=true
+
+[*]
+indent_style=space
+indent_size=2
+end_of_line=lf
+charset=utf-8

.gitignore

@@ -0,0 +1 @@
+node_modules

.travis.yml

@@ -0,0 +1,6 @@
+language: node_js
+
+node_js:
+  - '6.2.1'
+
+script: 'npm test'

README.md

@@ -0,0 +1,117 @@
+# cssobj-plugin-selector-localize
+
+Localize class names for cssobj.
+
+## Install
+
+install from github directly:
+
+``` javascript
+npm install cssobj/cssobj-plugin-selector-localize
+```
+
+## API
+
+``` javascript
+var localize = require('cssobj-plugin-selector-localize')
+var loc = localize(prefix, localNames)
+```
+
+### prefix
+
+- Type: `String`
+
+- Default: Random String
+
+If pass empty string `''`, will use `''` (empty prefix)
+
+If pass other falsy value, will use default.
+
+### localNames
+
+- Type: `Object`
+
+- Default: `{}`
+
+**key/val** pair to define how class name map into local name.
+
+Key is original class name.
+
+Val is localized name.
+
+## Usage
+
+### Localize
+
+``` javascript
+var localize = require('cssobj-plugin-selector-localize')
+var ret = cssobj({'.item': {color: 'red'}}, {
+  plugins:{ selector: localize() }
+})
+// css is => ._1hisnf23_item {color: red;}
+
+// you can get the map using:
+ret.map('item')  // === _1hisnf23_item
+
+```
+
+### Global
+
+There's 2 way to make class **Global**
+
+#### 1. :global(classNames)
+
+Add **:global()** to wrap class names, to make them global.
+
+``` javascript
+var ret = cssobj({'body :global(.nav .item) .login': {color: 'red'}}, {
+  plugins:{ selector: localize() }
+})
+// css is => body .nav .item ._1hisnf23_login {color: red;}
+```
+
+#### 2. .!className
+
+Just add **!** in front of class name, if you want it global.
+
+``` javascript
+var ret = cssobj({'body .!nav .!item .login': {color: 'red'}}, {
+  plugins:{ selector: localize() }
+})
+// css is => body .nav .item ._1hisnf23_login {color: red;}
+```
+
+### Custom Prefix
+
+You can control the prefix:
+
+``` javascript
+var ret = cssobj({'body .nav .item .login': {color: 'red'}}, {
+  plugins:{ selector: localize('_your_prefix_') }
+})
+// css is => body ._your_prefix_nav ._your_prefix_item ._your_prefix_login {color: red;}
+```
+
+
+### Custom Local Names
+
+You can control the map for each class name:
+
+``` javascript
+var ret = cssobj({'body .nav .!item .login': {color: 'red'}}, {
+  plugins:{ selector: localize(null, {nav: '_abc_'}) }
+})
+// css is => body ._abc_ .!item ._1hisnf23_login {color: red;}
+```
+
+### Get the class map
+
+``` javascript
+var ret = cssobj({'body .nav .item .login': {color: 'red'}}, {
+  plugins:{ selector: localize('_prefix_', {nav: '_abc_'}) }
+})
+
+ret.map('nav')  // === _abc_
+ret.map('item')  // === _prefix_item
+```
+

dist/cssobj-plugin-selector-localize.amd.js

@@ -0,0 +1,43 @@
+define('cssobj_plugin_selector_localize', function () { 'use strict';
+
+  // random string, should used across all cssobj plugins
+  var random = (function () {
+    var count = 0
+    return function () {
+      count++
+      return '_' + Math.floor(Math.random() * Math.pow(2, 32)).toString(36) + count + '_'
+    }
+  })()
+
+  var reClass = /:global\s*\(((?:\s*\.[A-Za-z0-9_-]+\s*)+)\)|(\.)([!A-Za-z0-9_-]+)/g
+
+  function cssobj_plugin_selector_localize(prefix, localNames) {
+
+    prefix = prefix!=='' ? prefix || random() : ''
+
+    localNames = localNames || {}
+
+    var replacer = function (match, global, dot, name) {
+      if (global) {
+        return global
+      }
+      if (name[0] === '!') {
+        return dot + name.substr(1)
+      }
+
+      return dot + map(name)
+    }
+
+    var map = function(name) {
+      return name in localNames ? localNames[name] : prefix + name
+    }
+
+    return function localizeName (sel, node, result) {
+      if(!result.map) result.map = map
+      return sel.replace(reClass, replacer)
+    }
+  }
+
+  return cssobj_plugin_selector_localize;
+
+});

dist/cssobj-plugin-selector-localize.cjs.js

@@ -0,0 +1,41 @@
+'use strict';
+
+// random string, should used across all cssobj plugins
+var random = (function () {
+  var count = 0
+  return function () {
+    count++
+    return '_' + Math.floor(Math.random() * Math.pow(2, 32)).toString(36) + count + '_'
+  }
+})()
+
+var reClass = /:global\s*\(((?:\s*\.[A-Za-z0-9_-]+\s*)+)\)|(\.)([!A-Za-z0-9_-]+)/g
+
+function cssobj_plugin_selector_localize(prefix, localNames) {
+
+  prefix = prefix!=='' ? prefix || random() : ''
+
+  localNames = localNames || {}
+
+  var replacer = function (match, global, dot, name) {
+    if (global) {
+      return global
+    }
+    if (name[0] === '!') {
+      return dot + name.substr(1)
+    }
+
+    return dot + map(name)
+  }
+
+  var map = function(name) {
+    return name in localNames ? localNames[name] : prefix + name
+  }
+
+  return function localizeName (sel, node, result) {
+    if(!result.map) result.map = map
+    return sel.replace(reClass, replacer)
+  }
+}
+
+module.exports = cssobj_plugin_selector_localize;

dist/cssobj-plugin-selector-localize.es.js

@@ -0,0 +1,39 @@
+// random string, should used across all cssobj plugins
+var random = (function () {
+  var count = 0
+  return function () {
+    count++
+    return '_' + Math.floor(Math.random() * Math.pow(2, 32)).toString(36) + count + '_'
+  }
+})()
+
+var reClass = /:global\s*\(((?:\s*\.[A-Za-z0-9_-]+\s*)+)\)|(\.)([!A-Za-z0-9_-]+)/g
+
+function cssobj_plugin_selector_localize(prefix, localNames) {
+
+  prefix = prefix!=='' ? prefix || random() : ''
+
+  localNames = localNames || {}
+
+  var replacer = function (match, global, dot, name) {
+    if (global) {
+      return global
+    }
+    if (name[0] === '!') {
+      return dot + name.substr(1)
+    }
+
+    return dot + map(name)
+  }
+
+  var map = function(name) {
+    return name in localNames ? localNames[name] : prefix + name
+  }
+
+  return function localizeName (sel, node, result) {
+    if(!result.map) result.map = map
+    return sel.replace(reClass, replacer)
+  }
+}
+
+export default cssobj_plugin_selector_localize;

dist/cssobj-plugin-selector-localize.iife.js

@@ -0,0 +1,44 @@
+var cssobj_plugin_selector_localize = (function () {
+  'use strict';
+
+  // random string, should used across all cssobj plugins
+  var random = (function () {
+    var count = 0
+    return function () {
+      count++
+      return '_' + Math.floor(Math.random() * Math.pow(2, 32)).toString(36) + count + '_'
+    }
+  })()
+
+  var reClass = /:global\s*\(((?:\s*\.[A-Za-z0-9_-]+\s*)+)\)|(\.)([!A-Za-z0-9_-]+)/g
+
+  function cssobj_plugin_selector_localize(prefix, localNames) {
+
+    prefix = prefix!=='' ? prefix || random() : ''
+
+    localNames = localNames || {}
+
+    var replacer = function (match, global, dot, name) {
+      if (global) {
+        return global
+      }
+      if (name[0] === '!') {
+        return dot + name.substr(1)
+      }
+
+      return dot + map(name)
+    }
+
+    var map = function(name) {
+      return name in localNames ? localNames[name] : prefix + name
+    }
+
+    return function localizeName (sel, node, result) {
+      if(!result.map) result.map = map
+      return sel.replace(reClass, replacer)
+    }
+  }
+
+  return cssobj_plugin_selector_localize;
+
+}());

dist/cssobj-plugin-selector-localize.min.js

@@ -0,0 +1,30 @@
+{
+  "name": "cssobj-plugin-selector-localize",
+  "version": "1.0.0",
+  "description": "Localize class name for cssobj",
+  "main": "dist/cssobj-plugin-selector-localize.cjs.js",
+  "jsnext:main": "dist/cssobj-plugin-selector-localize.es.js",
+  "scripts": {
+    "test": "mocha",
+    "report": "cd dist && gzip < cssobj-plugin-selector-localize.min.js > cssobj-plugin-selector-localize.min.gz && ls -lh && rm -f *.gz",
+    "make": "rollup -c && uglifyjs dist/cssobj-plugin-selector-localize.iife.js -cm -o dist/cssobj-plugin-selector-localize.min.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cssobj/cssobj-plugin-selector-localize.git"
+  },
+  "keywords": [
+    "cssobj",
+    "localize"
+  ],
+  "author": "James Yang <jamesyang999@gmail.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/cssobj/cssobj-plugin-selector-localize/issues"
+  },
+  "homepage": "https://github.com/cssobj/cssobj-plugin-selector-localize#readme",
+  "devDependencies": {
+    "chai": "^3.5.0",
+    "mocha": "^2.5.3"
+  }
+}