Merge commit '97948b2e0b80764fdcec2fb2132f76bcef3c3466' into feature/uikit-refactor-p5--web-components

# Conflicts:
#	packages/uikit-workshop/package.json

Author: sghoweri

README.md

@@ -24,9 +24,7 @@ Refer to the [core usage guidelines](https://github.com/pattern-lab/patternlab-n
 
 As of Pattern Lab Node 3.0.0, installation of [Editions](http://patternlab.io/docs/advanced-ecosystem-overview.html) is accomplished via the command line interface.
 
-_0 to 60mph_
-
-The below assume a new directory and project is required.
+The below assumes a new directory and project is required. This is likely what you want to do if starting from scratch. You could also run this within an existing project. The CLI will ask you for the installation location.
 
 1. Open a terminal window and following along below:
     ```bash
@@ -36,31 +34,10 @@ The below assume a new directory and project is required.
     ```
     > If you get an error stating that `npx` is not installed, ensure you are on `npm 5.2.0` or later by running `npm -v` or install it globally with `npm install -g npx`. [Learn more about npx.](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b)
 1. Follow the on-screen prompts to choose your Edition and a Starterkit should you want one.
-1. Run `npm install` one last time to ensure any transient packages from the CLI are installed.
-1. Open `package.json` and add the following to your `scripts` object
-    ```diff
-    "scripts": {
-    + "patternlab": "patternlab"
-    },
-    ```
-    This tells `npm` to look in the local `node_modules/.bin` directory for the `patternlab` CLI.
-1. In your terminal, run `npm run patternlab <command>`, where `<command>` is a documented method on the CLI, such as `build`, `serve`, or `help`.
-
-
-_Established npm projects_
+  - If you chose `edition-node`, new commands in the "scripts" will be added in your `package.json`.
+  - If you chose `edition-node-gulp`, a `gulpfile.js` will be added to your project.
 
-1. Run the following command from a terminal:
-    ```bash
-    npm install @pattern-lab/cli --save-dev
-    ```
-1. Open `package.json` and add the following to your `scripts` object
-    ```diff
-    "scripts": {
-    + "patternlab": "patternlab"
-    },
-    ```
-    This tells `npm` to look in the local `node_modules/.bin` directory for the `patternlab` CLI.
-1. In your terminal, run `npm run patternlab init`. Follow the on-screen prompts to choose your Edition and a Starterkit should you want one.
+  > Notice that `@pattern-lab/cli` was installed as a depdendency. Learn how to further [use the cli in your own project](https://github.com/pattern-lab/patternlab-node/blob/dev/packages/cli/readme.md#configuring-your-project-to-use-the-cli).
 
 
 ## Ecosystem
@@ -85,7 +62,6 @@ Pattern Lab / Node wouldn't be what it is today without the support of the commu
 * **[Brad Frost](http://bradfrost.com/)**
 * [Marcos Peebles](https://twitter.com/marcospeebles)
 * [Susan Simkins](https://twitter.com/susanmsimkins)
-* [Wilfred Nas](https://twitter.com/wnas)
 
 ## Contributing
 

packages/cli/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+<a name="0.0.1-beta.0"></a>
+## [0.0.1-beta.0](https://github.com/pattern-lab/patternlab-node/tree/master/packages/cli/compare/@pattern-lab/[email protected]...@pattern-lab/[email protected]) (2018-09-07)
+
+
+### Bug Fixes
+
+* **cli:** set initialized to false during plugin installation ([88cce3f](https://github.com/pattern-lab/patternlab-node/tree/master/packages/cli/commit/88cce3f))
+* **cli:** support scoped plugins ([4ae13ce](https://github.com/pattern-lab/patternlab-node/tree/master/packages/cli/commit/4ae13ce))
+* **package:** update tap dependency ([2b70ff4](https://github.com/pattern-lab/patternlab-node/tree/master/packages/cli/commit/2b70ff4))
+
+
+
+
+
 <a name="0.0.1-alpha.23"></a>
 
 ## [0.0.1-alpha.23](https://github.com/pattern-lab/patternlab-node/tree/master/packages/cli/compare/@pattern-lab/[email protected]...@pattern-lab/[email protected]) (2018-07-09)

packages/cli/bin/cli-actions/build.js

@@ -1,14 +1,12 @@
 'use strict';
 const buildPatterns = require('../build');
-const copyFiles = require('../copy-source-files');
 const resolveConfig = require('../resolve-config');
 const { error, info, wrapAsync } = require('../utils');
 
 const build = options =>
   wrapAsync(function*() {
     try {
       const config = yield resolveConfig(options.parent.config);
-      yield copyFiles(config.paths);
       yield buildPatterns(config, options);
       info(`build: Yay, your Pattern Lab project was successfully built ☺`);
     } catch (err) {

packages/cli/bin/cli-actions/serve.js

@@ -1,14 +1,12 @@
 'use strict';
 const resolveConfig = require('../resolve-config');
-const build = require('./build');
 const servePatterns = require('../serve');
 const wrapAsync = require('../utils').wrapAsync;
 
 const serve = options =>
   wrapAsync(function*() {
     const config = yield resolveConfig(options.parent.config);
-    yield build(options);
-    servePatterns(config, options.watch);
+    servePatterns(config, options);
   });
 
 module.exports = serve;

packages/cli/bin/copy-source-files.js

@@ -57,6 +57,7 @@ cli
   .alias('compile')
   .description('Build Pattern Lab. Optionally (re-)build only the patterns')
   .option('-p, --patterns-only', 'Whether to only build patterns')
+  .option('--no-watch', 'Start watching for changes')
   .action(build);
 
 /**
@@ -130,7 +131,7 @@ cli
   .command('serve')
   .alias('browse')
   .description('Starts a server to inspect files in browser')
-  .option('-w, --watch', 'Start watching for changes')
+  .option('--no-watch', 'Start watching for changes')
   .action(serve);
 
 // Show additional help

packages/cli/bin/patternlab.js

@@ -9,8 +9,9 @@ const { error, info } = require('./utils');
  * @func serve
  * @desc Start a browser-sync server in the Pattern Lab public dir
  * @param {object} config - The passed Pattern Lab config
+ * @param {object} options - The passed options at invocation time
  */
-function serve(config) {
+function serve(config, options) {
   if (!isValidConfig) {
     throw new TypeError(
       'serve: Expects config not to be empty and of type object.'
@@ -37,7 +38,7 @@ function serve(config) {
   try {
     info(`serve: Serving your files …`);
     const pl = patternlab(config);
-    pl.server.serve({});
+    pl.server.serve(options);
   } catch (err) {
     error(err);
   }

packages/cli/bin/serve.js

@@ -1,16 +1,16 @@
 {
   "name": "@pattern-lab/cli",
   "description": "Command-line interface (CLI) for the @pattern-lab/core.",
-  "version": "0.0.1-alpha.23",
+  "version": "0.0.1-beta.0",
   "bin": {
     "patternlab": "bin/patternlab.js"
   },
   "author": {
     "name": "Raphael Okon"
   },
   "dependencies": {
-    "@pattern-lab/core": "^3.0.0-alpha.16",
-    "@pattern-lab/live-server": "^1.3.3-alpha.6",
+    "@pattern-lab/core": "^3.0.0-beta.0",
+    "@pattern-lab/live-server": "^1.3.3-beta.0",
     "archiver": "2.1.1",
     "chalk": "2.4.1",
     "commander": "2.15.1",

packages/cli/package.json

@@ -14,11 +14,44 @@
 #### Via Yarn
 `yarn add @pattern-lab/cli --dev`
 
-## Getting Started
-1. In order to use Pattern Lab you need to initialize a Pattern Lab project with `patternlab init`. The CLI will ask you some setup question and scaffold your project based on it.
-2. Build your patterns use `patternlab build`. The Pattern Lab CLI will assume that the `patternlab-config.json` is in the project root. Othewise specify a custom path to config with `patternlab build --config path/to/config`
-3. To view your patterns in the browser preview `patternlab serve` or again specify a custom config location `patternlab serve --config path/to/config`
-4. To export your patterns in the browser preview `patternlab export` or again specify a custom config location `patternlab export --config path/to/config`
+## Configuring Your Project to Use the CLI
+
+If the CLI is installed globally, you may call commands directly, such as `patternlab --version`.
+
+If the CLI is not installed globally, you need to tell `npm` where to find the executable when invoking commands.
+
+Open `package.json` and add the following to your `scripts` object:
+
+```diff
+"scripts": {
++ "patternlab": "patternlab"
+},
+```
+This tells `npm` to look in the local `node_modules/.bin` directory for the `patternlab` CLI.
+
+Subcommands and options can then be forwarded to the CLI like this:
+
+```bash
+npm run patternlab -- serve
+```
+
+Installing [`edition-node`](https://github.com/pattern-lab/patternlab-node/tree/master/packages/edition-node) will add the following CLI commands for convenience:
+
+```diff
+  "scripts": {
++    "pl:build": "patternlab build --config ./patternlab-config.json",
++    "pl:help": "patternlab --help",
++    "pl:install": "patternlab install --config ./patternlab-config.json",
++    "pl:serve": "patternlab serve --config ./patternlab-config.json",
++    "pl:version": "patternlab --version"
+  },
+```
+
+Then you can invoke any of these like this:
+
+```
+npm run pl:serve
+```
 
 ## API & Usage
 ### General usage

packages/cli/readme.md

@@ -3,6 +3,27 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+<a name="3.0.0-beta.0"></a>
+# [3.0.0-beta.0](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/compare/@pattern-lab/[email protected]...@pattern-lab/[email protected]) (2018-09-07)
+
+
+### Bug Fixes
+
+* **docs:** update event info with tab example ([0f227a3](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/commit/0f227a3))
+* **package:** Allow .json extension on annotations file (issue [#836](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/issues/836)) ([b92e62b](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/commit/b92e62b))
+* **package:** update tap dependency ([2b70ff4](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/commit/2b70ff4))
+* **plugins:** support scoped packages ([44f0f8e](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/commit/44f0f8e))
+
+
+### Features
+
+* **API:** remove reliance on patternlab object during plugin install ([0850fd6](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/commit/0850fd6))
+* **core:** remove plugin install / disable / enable logic ([5a58824](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/commit/5a58824)), closes [#872](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/issues/872)
+
+
+
+
+
 <a name="3.0.0-alpha.16"></a>
 
 # [3.0.0-alpha.16](https://github.com/pattern-lab/patternlab-node/tree/master/packages/core/compare/@pattern-lab/[email protected]...@pattern-lab/[email protected]) (2018-07-06)