Feature/modular custom parser

README.md

@@ -32,10 +32,10 @@ It's a pun on the tagline.
 
 # Talks and Podcasts
 
-* [React Round Up](https://reactroundup.com/wrangle-your-css-in-js-for-peanuts-using-goober-ft-cristian-bote-rru-177) 👉 https://reactroundup.com/wrangle-your-css-in-js-for-peanuts-using-goober-ft-cristian-bote-rru-177
-* ReactDay Berlin 2019 👉  https://www.youtube.com/watch?v=k4-AVy3acqk
-* [PodRocket](https://podrocket.logrocket.com/) by [LogRocket](https://logrocket.com/) 👉 https://podrocket.logrocket.com/goober
-* [ngParty](https://www.ngparty.cz/) 👉 https://www.youtube.com/watch?v=XKFvOBDPeB0
+-   [React Round Up](https://reactroundup.com/wrangle-your-css-in-js-for-peanuts-using-goober-ft-cristian-bote-rru-177) 👉 https://reactroundup.com/wrangle-your-css-in-js-for-peanuts-using-goober-ft-cristian-bote-rru-177
+-   ReactDay Berlin 2019 👉 https://www.youtube.com/watch?v=k4-AVy3acqk
+-   [PodRocket](https://podrocket.logrocket.com/) by [LogRocket](https://logrocket.com/) 👉 https://podrocket.logrocket.com/goober
+-   [ngParty](https://www.ngparty.cz/) 👉 https://www.youtube.com/watch?v=XKFvOBDPeB0
 
 # Table of contents
 
@@ -285,7 +285,7 @@ const Title = styled('h1', React.forwardRef)`
 `;
 ```
 
-### `setup(pragma: Function, prefixer?: Function, theme?: Function, forwardProps?: Function)`
+### `setup(pragma: Function, parser?: Object, theme?: Function, forwardProps?: Function, parser?: Function)`
 
 The call to `setup()` should occur only once. It should be called in the entry file of your project.
 
@@ -298,17 +298,26 @@ import { setup } from 'goober';
 setup(React.createElement);
 ```
 
-#### With prefixer
+#### With parser
 
 ```js
 import React from 'react';
 import { setup } from 'goober';
 
 const customPrefixer = (key, value) => `${key}: ${value};\n`;
 
-setup(React.createElement, customPrefixer);
+setup(React.createElement, { pre: customPrefixer });
 ```
 
+There are four parser functions you can override to customize how goober handles styles:
+
+-   `at`: Handles @ rules.
+-   `obj`: Handles objects.
+-   `str`: Handles strings.
+-   `pre`: Allows for adding a custom prefix function easily within the default `str` parser function.
+
+You can reference the [default parser functions](https://github.com/cristianbote/goober/blob/master/src/core/parse.js) as a starting point.
+
 #### With theme
 
 ```js
@@ -768,7 +777,7 @@ import { setup } from 'goober';
 import { prefix } from 'goober/prefixer';
 
 // Bootstrap goober
-setup(React.createElement, prefix);
+setup(React.createElement, { pre: prefix });
 ```
 
 And voilà! It is done!