Merge branch 'master' into github-actions

Author: developit

.eslintignore

@@ -17,5 +17,8 @@
     "react": {
       "version": "16.6"
     }
-  }
+  },
+  "ignorePatterns": [
+    "dist"
+  ]
 }

.eslintrc

@@ -7,7 +7,6 @@ node_modules
 .rts2_cache_umd
 build
 dist
-package-lock.json
 yarn.lock
 .vscode
 .idea

.gitignore

@@ -0,0 +1 @@
+dist/

.npmrc

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017-present Jason Miller
+
+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.

.prettierignore

@@ -29,12 +29,12 @@
 
 ```js
 {
-  "source": "src/foo.js",         // Your source file (same as 1st arg to microbundle)
-  "main": "dist/foo.js",        // output path for CommonJS/Node
-  "module": "dist/foo.mjs",     // output path for JS Modules
-  "unpkg": "dist/foo.umd.js",   // optional, for unpkg.com
+  "source": "src/foo.js",          // Your source file (same as 1st arg to microbundle)
+  "main": "dist/foo.js",           // output path for CommonJS/Node
+  "module": "dist/foo.module.js",  // output path for JS Modules
+  "unpkg": "dist/foo.umd.js",      // optional, for unpkg.com
   "scripts": {
-    "build": "microbundle",       // uses "source" and "main" as input and output paths by default
+    "build": "microbundle",        // uses "source" and "main" as input and output paths by default
     "dev": "microbundle watch"
   }
 }
@@ -68,8 +68,8 @@ This is enabled by default - all you have to do is add the field to your `packag
 
 ```js
 {
-  "main": "dist/foo.umd.js",        // legacy UMD bundle (for Node & CDN's)
-  "module": "dist/foo.modern.mjs",  // modern ES2017 bundle
+  "main": "dist/foo.umd.js",              // legacy UMD bundle (for Node & CDN's)
+  "module": "dist/foo.modern.module.js",  // modern ES2017 bundle
   "scripts": {
     "build": "microbundle src/foo.js -f modern,umd"
   }
@@ -94,6 +94,26 @@ Acts just like `microbundle build`, but watches your source files and rebuilds o
 
 Just point the input to a `.ts` file through either the cli or the `source` key in your `package.json` and you’re done.
 
+### Using CSS Modules
+
+By default any css file imported as `.module.css`, will be treated as a css-module. If you wish to treat all .css
+imports as a module, specify the cli flag `--css-modules true`. If you wish to disable all css-module behaviours set the
+flag to `false`.
+
+The default scope name when css-modules is turned on will be, in watch mode `_[name]__[local]__[hash:base64:5]` and when
+you build `_[hash:base64:5]`. This can be overriden by specifying the flag, eg
+`--css-modules "_something_[hash:base64:7]"`. _Note:_ by setting this, it will be treated as a true, and thus, all .css
+imports will be scoped.
+
+| flag  | import                         |   is css module?   |
+| ----- | ------------------------------ | :----------------: |
+| null  | import './my-file.css';        |        :x:         |
+| null  | import './my-file.module.css'; | :white_check_mark: |
+| false | import './my-file.css';        |        :x:         |
+| false | import './my-file.module.css'; |        :x:         |
+| true  | import './my-file.css';        | :white_check_mark: |
+| true  | import './my-file.module.css'; | :white_check_mark: |
+
 ### Specifying builds in `package.json`
 
 You can specify output builds in a `package.json` as follows:
@@ -108,16 +128,18 @@ You can specify output builds in a `package.json` as follows:
 
 ### Mangling Properties
 
-Libraries often wish to rename internal object properties or class members to smaller names - transforming `this._internalIdValue` to `this._i`. Microbundle doesn't currently do this by default, but it can be enabled by adding a "mangle" property to your package.json, with a pattern to control when properties should be mangled. To mangle all property names beginning an underscore, add the following:
+To achieve the smallest possible bundle size, libraries often wish to rename internal object properties or class members to smaller names - transforming `this._internalIdValue` to `this._i`. Microbundle doesn't do this by default, however it can be enabled by createing a `mangle.json` file (or a `"mangle"` property in your package.json). Within that file, you can specify a regular expression pattern to control which properties should be mangled. For example: to mangle all property names beginning an underscore:
 
 ```json
 {
-	"mangle": {
-		"regex": "^_"
-	}
+  "mangle": {
+    "regex": "^_"
+  }
 }
 ```
 
+It's also possible to configure repeatable short names for each mangled property, so that every build of your library has the same output. **See the wiki for a [complete guide to property mangling in Microbundle](https://github.com/developit/microbundle/wiki/mangle.json).**
+
 ### All CLI Options
 
 ```
@@ -151,6 +173,7 @@ Options
 	--raw            Show raw byte size  (default false)
 	--jsx            A custom JSX pragma like React.createElement (default: h)
 	--tsconfig       Specify the path to a custom tsconfig.json
+	--css-modules    Configures .css to be treated as modules (default: null)
 	-h, --help       Displays this message
 
 Examples
@@ -174,12 +197,16 @@ Here's what's coming up for Microbundle:
 - [Preact](https://github.com/preactjs/preact) Fast 3kB React alternative with the same modern API. Components & Virtual DOM.
 - [Stockroom](https://github.com/developit/stockroom) Offload your store management to a worker easily.
 - [Microenvi](https://github.com/fwilkerson/microenvi) Bundle, serve, and hot reload with one command.
+- [Theme UI](https://github.com/system-ui/theme-ui) Build consistent, themeable React apps based on constraint-based design principles.
 - [react-recomponent](https://github.com/philipp-spiess/react-recomponent) Reason-style reducer components for React using ES6 classes.
 - [brazilian-utils](https://github.com/brazilian-utils/brazilian-utils) Utils library for specific Brazilian businesses.
 - [react-hooks-lib](https://github.com/beizhedenglong/react-hooks-lib) A set of reusable react hooks.
 - [mdx-deck-live-code](https://github.com/JReinhold/mdx-deck-live-code) A library for [mdx-deck](https://github.com/jxnblk/mdx-deck) to do live React and JS coding directly in slides.
 - [react-router-ext](https://github.com/ri7nz/react-router-ext) An Extended [react-router-dom](https://github.com/ReactTraining/react-router/tree/master/packages/react-router-dom) with simple usage.
 - [routex.js](https://github.com/alexhoma/routex.js) A dynamic routing library for Next.js.
+- [hooked-form](https://github.com/JoviDeCroock/hooked-form) A lightweight form-management library for React.
+- [goober](https://github.com/cristianbote/goober) Less than 1KB css-in-js alternative with a familiar API.
+- [react-model](https://github.com/byte-fe/react-model) The next generation state management library for React
 
 ## 🥂 License
 

LICENSE

@@ -2,3 +2,4 @@ status = [
   "continuous-integration/travis-ci/push",
 ]
 delete_merged_branches = true
+use_squash_merge = true