API overhaul (v1.0.0 preview)

.bithoundrc

@@ -1,6 +1,14 @@
 {
   "ignore": [
     "dist/*.js",
-    "example/*.js"
+    "example/*.js",
+    "plugins/postcss/dist/*.js",
+    "plugins/postcss/node_modules/**/*.js",
+    "plugins/prefix-browser/dist/*.js",
+    "plugins/prefix-browser/node_modules/**/*.js",
+    "plugins/prefix-browser/src/extracted/*.js",
+    "plugins/prefix-browser/upstream/**/*.js",
+    "plugins/prefix-iso/**/*.js",
+    "plugins/prefix-server/**/*.js"
   ]
 }

.eslintignore

@@ -0,0 +1,14 @@
+coverage
+dist
+example
+gh_pages
+modules
+plugins/postcss/dist
+plugins/postcss/node_modules
+plugins/prefix-browser/dist
+plugins/prefix-browser/node_modules
+plugins/prefix-browser/src/extracted
+plugins/prefix-browser/test-utils/exposed.js
+plugins/prefix-browser/upstream
+plugins/prefix-iso
+plugins/prefix-server

.eslintrc.js

@@ -1,22 +1,24 @@
 module.exports = {
     rules: {
         indent: [
-            2, 2
+            "error", 2
         ],
         quotes: [
-            2,
+            "error",
             "single",
             "avoid-escape"
         ],
         "linebreak-style": [
-            2,
+            "error",
             "unix"
         ],
         semi: [
-            2,
+            "error",
             "never"
         ],
-        "no-trailing-spaces": [2]
+        "no-trailing-spaces": "error",
+        "comma-dangle": "error",
+        "no-native-reassign": "error"
     },
     parserOptions: {
         ecmaVersion: 6,

.gitignore

@@ -1,2 +1,2 @@
 node_modules
-gh_pages
+coverage

.travis.yml

@@ -1,6 +1,5 @@
 language: node_js
 node_js:
-  - '0.10'
-  - '0.11'
-  - '5.0'
-script: npm run cover
+  - node
+cache: yarn
+script: "yarn install-plugins && yarn run travis"

DEVELOPMENT.md

@@ -0,0 +1,62 @@
+# `j2c` development
+
+If you want to install `j2c` to work on it, first fork the repo and clone the fork locally
+
+```BASH
+$ git clone https://github.com/yourAccount/j2c
+```
+
+Then add `j2css/j2c` as a remote for pulling, then create your work branch. My advice is to never work on the master branch directly as it will make it easier to pull remote changes and handle merge conflicts (unless you know your way around git, then do whatever you like).
+
+```BASH
+$ cd j2c
+$ git remote add j2css https://github.com/j2css/j2c.git
+$ git checkout -b your-work-branch-here
+```
+
+Now install the dependencies and the plugin dependencies ([yarn](https://yarnpkg.com/) is recommended but you can use NPM as well):
+
+```BASH
+$ yarn # resp. npm install
+$ yarn run install-plugins # resp. npm run install-plugins
+```
+
+Now run the full QA suite to verify that everything works fine.
+
+```BASH
+$ yarn run all # runs `lint`, `build`, `cover` (which runs the tests) and `check-coverage`
+```
+
+While developing, you'll probably want to use `yarn run dev` instead of `all`. It only runs the `build` and `test` tasks.
+
+While `yarn run build` will only build the core, the `test`, `lint` and `cover` tasks work on the whole project, plugins included. This ensures that changes in the core do not break plugins.
+
+## working on a plugin.
+
+The plugins are set up in distinct folders with their own `package.json` and dedicated `build` and `dev` scripts, and they rely on the main tasks to run the tests, linting  and coverage.
+
+When working in a plugin directory the `yarn run go x` command (or `yarn go x`) will be forwarded to the scripts at the `j2c` root (it literally calls `cd ../.. && yarn run x`).
+
+The test suites of the plugins depend on the `j2c` version at the root of the directory, not on the `npm` dependency.
+
+## rebasing on top of upstream changes
+
+If you want to submit a PR but other changes that were committed in the mean time, you can rebase your changes on top of them.
+
+```BASH
+$ git checkout master # resp. your target branch
+$ git pull --rebase j2css # the --rebase option gets rids of ugly merge commits
+$ git checkout your-work-branch-here
+$ git rebase master
+```
+
+If there are conflicts:
+
+1. resolve potential conflicts in your text editor (identify the problem files using `git diff` or `git status`)
+2. then run
+
+```BASH
+$ git add previously-conflictual-file
+$ git rebase continue
+```
+rinse and repeat until there are no conflicts anymore.

HISTORY.md

@@ -1,21 +1,97 @@
 # Change log
 
-## v0.11.1 (2016-03-8) and v0.11.2
-
-- Patch bump to fix what `npm` installs by default (I erronously published `v1.0.0-x` on without `--tag next`, twice) Note to self, don't publish in the
-wee hours.
+## v1.0.0 (WIP)
+
+### Breaking changes
+- The exported object is a factory, users have to create instances
+  manually as `var j2c = new J2c(options)`.
+- Local scope is now per instance rather than per sheet.
+  - `j2c.sheet()` and `j2c.inline()` return plain strings rather than
+    `String` objects.
+  - `j2c.names` holds the local -> global mappings for use in the (v)DOM.
+- syntax changes for properties and nested sub-properties.
+  tl;dr: `{foo_bat: {baz: 5}}` must now be written `{fooBar: {Baz: 5}}`
+  - underscores are not converted to dashes anymore (use CamelCase)
+  - sub-properties must start with an upper case letter
+  - the `*` hack is supported for old IE.
+- Removed the partial auto-prefix insertion from the core. There's now a
+  fully fledged prefix plugin for the browser, and Autoprefixer can be
+  used on the server by using the PostCSS adapter.
+- Revamped the plugin system.
+  - Removed `$postprocess` plugins that were taking and returning the full
+    buffer.
+  - Introduced `filter` system that can patch values on the fly on their
+    way between the compiler and the buffer.
+  - Introduced `sink` plugin that allow to subvert the sheet building
+    process to implement systems like Radium or Descartes.
+  - Introduced `at` filters that can handle at-rules beside the ones that
+    j2c supports out of the box.
+- Revamped the poorly named `@extend` into `@adopt`, based on @tivac's
+  Modular CSS `composes`. The semantics are too distant from either `@extend`
+  or `composes` to use their name witout introducing potential confusion,
+  hence the new name.
+
+  So: `j2c.sheet({'@adopt .foo': ['.bar']})` where foo is a local class that
+  adopts the behavior of the global `.bar`.
+
+### Additions
+- Added a namespace mechanism to scope the styles per component wihtout having to
+  use BEM-like classes or having to create a distinct `j2c` instance for each
+  component.
+- Prefixed at-rules are treated like their unprefixed counterparts.
+- Added `@local` as a counterpart to `@global`.
+- Consecutive, identical selectors are deduped in the output. Using mixins
+  won't cause duplicate selectors anymore.
+
+### Fixes
+- `& > &` with a selector list as parent will perform their cartesian product
+  like SASS and LESS do.
+- Robust parsing of selectors. Comas, ampersands and class-like parts
+  in strings are now ignored by the compiler.
+
+  ```JS
+  j2c.sheet({'p':{'[foo="&,.bar"]': {color: 'red'}}})
+  ```
+
+  produces
+
+  ```CSS
+  p[foo="&,.bar"] {color:red}
+  ```
+
+  Whereas previous versions would produce
+
+  ```CSS
+  [foo="p,p.bar_j2c_ubv4pc_knzcqw_ngjme7_1usit1c_9"] {color: red;}
+  ```
+
+  Likewise, `':not(p, a, ul, li)'` (a CSS4 addition) will not be split.
+
+### Size
+
+2.4Kb mingzipped (+ ~700 bytes).
+
+## v0.11.1 (2016-03-8) and v0.11.2 (2016-03-17)
+
+- Patch bump to fix what `npm` installs by default (I erronously published `
+  v1.0.0-x` on without `--tag next`, twice) Note to self, don't publish in
+  the wee hours.
 
 ## v0.11.0
 
-- Refactor the innards so that the source order is completely respected in the output, including conditional at-rules.
+- Refactor the innards so that the source order is completely respected in
+  the output, including conditional at-rules.
 - Speed ++
 - Autoprefix all animation-* and transition.
-- Some error messages are now inserted in the result as -error-prefixed at-rules and :pseudo-classes.
+- Some error messages are now inserted in the result as -error-prefixed
+  at-rules and :pseudo-classes.
 
 ## v0.10.0
 
-- At long last allow element selectors without a prepended space at the top level
-- Autoprefix animation and animation-name with -webkit- too like we do for `@keyframes`.
+- At long last allow element selectors without a prepended space at the top
+  level
+- Autoprefix animation and animation-name with -webkit- too like we do for
+  `@keyframes`.
 - Tweaks and cleanup
 
 ## v0.9.0
@@ -40,21 +116,26 @@ wee hours.
 
 ## v0.8.0
 
-- classes and animations/@keyframes names are now localized by default in `j2c.sheet()`.
+- classes and animations/@keyframes names are now localized by default in
+  `j2c.sheet()`.
 - introduced `@global{}` and `:global()` to reach global names
 - dropped `j2c.scoped()` which is obsoleted by the above.
 - dropped bulk auto-prefixing.
 - better at-rules handling.
 - support for autoDeCamelization of property-names.
-- New signature for `j2c.sheet([namespace1, namespace2, ] source)` where `namespace` is an object
-with plain -> localized names for classes and animations.
-- allow to create custom j2c instances that can be extended with plugins *[needs docs]*.
+- New signature for `j2c.sheet([namespace1, namespace2, ] source)` where
+  `namespace` is an object with plain -> localized names for classes and
+  animations.
+- allow to create custom j2c instances that can be extended with plugins
+  *[needs docs]*.
 - Hardened the test suite.
-- Bug fix: the source order is now respected in the output, with the caveat that, for nested selector, the children appear in source before the parent.
+- Bug fix: the source order is now respected in the output, with the caveat
+  that, for nested selector, the children appear in source before the parent.
 
 ## v0.7.3
 
-- Identical to `v0.7.2`. Somehow a bad commit ended up on NPM for that version.
+- Identical to `v0.7.2`. Somehow a bad commit ended up on NPM for that
+  version.
 
 ## v0.7.2