Packages: Extract @wordpress/nux package (#8016)

* Packages: Extract `@wordpress/nux` package

* Docs: Regenerate docs after moving nux to packages

* Build: Add Eslint rule for NUX package

* NUX: Fix build handling for CSS files

Author: gziolo

.eslintrc.js

@@ -88,6 +88,10 @@ module.exports = {
 				selector: 'ImportDeclaration[source.value=/^keycodes(\\u002F|$)/]',
 				message: 'Use @wordpress/keycodes as import path instead.',
 			},
+			{
+				selector: 'ImportDeclaration[source.value=/^nux(\\u002F|$)/]',
+				message: 'Use @wordpress/nux as import path instead.',
+			},
 			{
 				selector: 'ImportDeclaration[source.value=/^utils(\\u002F|$)/]',
 				message: 'Use @wordpress/utils as import path instead.',
@@ -112,10 +116,6 @@ module.exports = {
 				"selector": "ImportDeclaration[source.value=/^core-blocks$/]",
 				"message": "Use @wordpress/core-blocks as import path instead."
 			},
-			{
-				"selector": "ImportDeclaration[source.value=/^nux$/]",
-				"message": "Use @wordpress/nux as import path instead."
-			},
 			{
 				selector: 'CallExpression[callee.name="deprecated"] Property[key.name="version"][value.value=/' + majorMinorRegExp + '/]',
 				message: 'Deprecated functions must be removed before releasing this version.',

docs/manifest.json

@@ -222,9 +222,9 @@
 		"parent": "packages"
 	},
 	{
-		"title": "@wordpress/api-request",
-		"slug": "packages-api-request",
-		"markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/packages/api-request/README.md",
+		"title": "@wordpress/api-fetch",
+		"slug": "packages-api-fetch",
+		"markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/packages/api-fetch/README.md",
 		"parent": "packages"
 	},
 	{
@@ -377,6 +377,12 @@
 		"markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/packages/npm-package-json-lint-config/README.md",
 		"parent": "packages"
 	},
+	{
+		"title": "@wordpress/nux",
+		"slug": "packages-nux",
+		"markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/packages/nux/README.md",
+		"parent": "packages"
+	},
 	{
 		"title": "@wordpress/plugins",
 		"slug": "packages-plugins",
@@ -443,12 +449,6 @@
 		"markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/editor/README.md",
 		"parent": "packages"
 	},
-	{
-		"title": "@wordpress/nux",
-		"slug": "packages-nux",
-		"markdown_source": "https://raw.githubusercontent.com/WordPress/gutenberg/master/nux/README.md",
-		"parent": "packages"
-	},
 	{
 		"title": "Data Package Reference",
 		"slug": "data",

docs/tool/config.js

@@ -17,7 +17,6 @@ const gutenbergPackages = [
 	'core-blocks',
 	'edit-post',
 	'editor',
-	'nux',
 ];
 
 module.exports = {
@@ -45,8 +44,8 @@ module.exports = {
 		},
 		'core/nux': {
 			title: 'The NUX (New User Experience) Data',
-			selectors: [ path.resolve( root, 'nux/store/selectors.js' ) ],
-			actions: [ path.resolve( root, 'nux/store/actions.js' ) ],
+			selectors: [ path.resolve( root, 'packages/nux/src/store/selectors.js' ) ],
+			actions: [ path.resolve( root, 'packages/nux/src/store/actions.js' ) ],
 		},
 		'core/viewport': {
 			title: 'The Viewport Data',

nux/index.js

@@ -1,6 +1,3 @@
-/**
- * Internal dependencies
- */
-import './store';
+export * from '../packages/nux/src';
 
-export { default as DotTip } from './components/dot-tip';
+import '../packages/nux/src/style.scss';

package-lock.json

@@ -34,6 +34,7 @@
 		"@wordpress/i18n": "file:packages/i18n",
 		"@wordpress/is-shallow-equal": "file:packages/is-shallow-equal",
 		"@wordpress/keycodes": "file:packages/keycodes",
+		"@wordpress/nux": "file:packages/nux",
 		"@wordpress/plugins": "file:packages/plugins",
 		"@wordpress/shortcode": "file:packages/shortcode",
 		"@wordpress/url": "file:packages/url",

package.json

@@ -0,0 +1 @@
+package-lock=false

packages/nux/.npmrc

@@ -1,12 +1,19 @@
-NUX (New User eXperience)
-=========================
+# @wordpress/nux
 
-The NUX module exposes components, and `wp.data` methods useful for onboarding a new user to the WordPress admin interface. Specifically, it exposes _tips_ and _guides_.
+The NUX (New User eXperience) module exposes components, and `wp.data` methods useful for onboarding a new user to the WordPress admin interface. Specifically, it exposes _tips_ and _guides_.
 
 A _tip_ is a component that points to an element in the UI and contains text that explains the element's functionality. The user can dismiss a tip, in which case it never shows again. The user can also disable tips entirely. Information about tips is persisted between sessions using `localStorage`.
 
 A _guide_ allows a series of of tips to be presented to the user one by one. When a user dismisses a tip that is in a guide, the next tip in the guide is shown.
 
+## Installation
+
+Install the module
+
+```bash
+npm install @wordpress/nux --save
+```
+
 ## DotTip
 
 `DotTip` is a React component that renders a single _tip_ on the screen. The tip will point to the React element that `DotTip` is nested within. Each tip is uniquely identified by a string passed to `id`.

nux/README.md packages/nux/README.mdnux/README.md renamed to packages/nux/README.md

@@ -0,0 +1,36 @@
+{
+	"name": "@wordpress/nux",
+	"version": "1.0.0-alpha.0",
+	"description": "NUX (New User eXperience) module for WordPress",
+	"author": "The WordPress Contributors",
+	"license": "GPL-2.0-or-later",
+	"keywords": [
+		"wordpress",
+		"nux"
+	],
+	"homepage": "https://github.com/WordPress/gutenberg/tree/master/packages/nux/README.md",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/WordPress/gutenberg.git"
+	},
+	"bugs": {
+		"url": "https://github.com/WordPress/gutenberg/issues"
+	},
+	"main": "build/index.js",
+	"module": "build-module/index.js",
+	"dependencies": {
+		"@wordpress/components": "file:../components",
+		"@wordpress/compose": "file:../compose",
+		"@wordpress/data": "file:../data",
+		"@wordpress/element": "file:../element",
+		"@wordpress/i18n": "file:../i18n",
+		"lodash": "^4.17.10",
+		"rememo": "^3.0.0"
+	},
+	"devDependencies": {
+		"enzyme": "^3.3.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}