@enact/cli 5.0.1 → 5.1.0

package/.travis.yml

@@ -8,4 +8,4 @@ install:
     - npm install
 
 script:
-    - npm run lint
+    - npm run lint -- --report-unused-disable-directives --max-warnings 0

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## 5.1.0 (November 4, 2022)
+
+* Unpinned versions of dependencies.
+
+### pack
+
+* Added `--custom-skin` option to build with custom skin for sandstone apps.
+
+## 5.0.2 (September 16, 2022)
+
+* Pinned versions of dependencies as same as 5.0.0.
+
+### serve
+
+* Fixed deprecation warning regarding middleware.
+
 ## 5.0.1 (August 30, 2022)
 
 ### pack

package/commands/pack.js

@@ -46,6 +46,7 @@ function displayHelp() {
 	console.log('    -s, --snapshot    Generate V8 snapshot blob');
 	console.log('                      (requires V8_MKSNAPSHOT set)');
 	console.log('    -m, --meta        JSON to override package.json enact metadata');
+	console.log('    -c, --custom-skin Build with a custom skin');
 	console.log('    --stats           Output bundle analysis file');
 	console.log('    --verbose         Verbose log build details');
 	console.log('    -v, --version     Display version information');
@@ -59,7 +60,6 @@ function displayHelp() {
 			--externals           	Specify a local directory path to the standalone external framework
 			--externals-public    	Remote public path to the external framework for use injecting into HTML
 			--externals-polyfill  	Flag whether to use external polyfill (or include in framework build)
-			--custom-skin         	To use a custom skin for build
 			--ilib-additional-path	Specify iLib additional resources path
 	*/
 	process.exit(0);
@@ -301,6 +301,7 @@ function cli(args) {
 			l: 'locales',
 			s: 'snapshot',
 			m: 'meta',
+			c: 'custom-skin',
 			w: 'watch',
 			h: 'help'
 		}

package/commands/serve.js

@@ -211,22 +211,31 @@ function devServerConfig(host, port, protocol, publicPath, proxy, allowedHost) {
 		},
 		// `proxy` is run between `before` and `after` `webpack-dev-server` hooks
 		proxy,
-		onBeforeSetupMiddleware(devServer) {
-			// Keep `evalSourceMapMiddleware`
-			// middlewares before `redirectServedPath` otherwise will not have any effect
-			// This lets us fetch source contents from webpack for the error overlay
-			devServer.app.use(evalSourceMapMiddleware(devServer));
+		setupMiddlewares(middlewares, devServer) {
+			if (!devServer) {
+				throw new Error('webpack-dev-server is not defined');
+			}
 
 			// Optionally register app-side proxy middleware if it exists
 			const proxySetup = path.join(process.cwd(), 'src', 'setupProxy.js');
 			if (fs.existsSync(proxySetup)) {
 				require(proxySetup)(devServer.app);
 			}
-		},
-		onAfterSetupMiddleware(devServer) {
-			// Redirect to `PUBLIC_URL` or `homepage`/`enact.publicUrl` from `package.json`
-			// if url not match
-			devServer.app.use(redirectServedPathMiddleware(publicPath));
+
+			middlewares.unshift(
+				// Keep `evalSourceMapMiddleware`
+				// middlewares before `redirectServedPath` otherwise will not have any effect
+				// This lets us fetch source contents from webpack for the error overlay
+				evalSourceMapMiddleware(devServer)
+			);
+
+			middlewares.push(
+				// Redirect to `PUBLIC_URL` or `homepage`/`enact.publicUrl` from `package.json`
+				// if url not match
+				redirectServedPathMiddleware(publicPath)
+			);
+
+			return middlewares;
 		}
 	};
 }

package/docs/building-apps.md

@@ -22,6 +22,7 @@ order: 4
             "all" - All locales that iLib supports
     -s, --snapshot    Generate V8 snapshot blob
                       (requires V8_MKSNAPSHOT set)
+    -c, --custom-skin Build with a custom skin
     --stats           Output bundle analysis file
 
 ```
@@ -196,6 +197,27 @@ try to set `NODE_PATH` to point global node_modules directory like below.
 export NODE_PATH=/path/to/your/global/node_modules
 ```
 
+## Custom Skin Support
+
+Sandstone supports custom skin features to let you easily override the colors of components. All you need to do is build your app with `--custom-skin` option and add a CSS file named `custom_skin.css` which includes a preset of colors, under the `customizations` folder in the build result like below.
+
+```none
+my-app/
+  README.md
+  .gitignore
+  package.json
+  dist/
+    customizations/
+      custom_skin.css
+    main.css
+    main.js
+    ...
+  node_modules/
+  src/
+  resources/
+  webos-meta/
+```
+
 ## Isomorphic Support & Prerendering
 By using the isomorphic code layout option, your project bundle will be outputted in a versatile universal code format allowing potential usage outside the browser. The Enact CLI takes advantage of this mode by additionally generating an HTML output of your project and embedding it directly with the resulting **index.html**. By default, isomorphic mode will attempt to prerender only `en-US`, however with the `--locales` option, a wide variety of locales can be specified and prerendered. More details on isomorphic support and its limitations can be found [here](./isomorphic-support.md).