@enact/cli 5.0.2 → 5.1.1

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,20 @@
+## 5.1.1 (February 10, 2023)
+
+* Fixed `eslint-plugin-react` version to `7.31.11` temporarily.
+* Updated dependencies.
+
+### pack
+
+* Updated `babel.config.js` to use `babel-preset-enact` module that holds the babel config for Enact.
+
+## 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.

package/commands/info.js

@@ -103,6 +103,7 @@ function api({cliInfo = false, dev = false} = {}) {
 				console.log(chalk.yellow.bold('==Enact Components=='));
 				[
 					'@enact/dev-utils',
+					'babel-preset-enact',
 					'eslint-config-enact',
 					'eslint-plugin-enact',
 					'postcss-resolution-independence'

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/config/babel.config.js

@@ -1,132 +1 @@
-/*
- *  babel.config.js
- *
- *  A Babel javascript configuration dynamically setup for Enact
- *  development environment on target platforms.
- */
-const path = require('path');
-
-// Check if JSX transform is able
-const hasJsxRuntime = (() => {
-	if (process.env.DISABLE_NEW_JSX_TRANSFORM === 'true') {
-		return false;
-	}
-
-	try {
-		require.resolve('react/jsx-runtime');
-		return true;
-	} catch (e) {
-		return false;
-	}
-})();
-
-module.exports = function (api) {
-	const env = process.env.BABEL_ENV || process.env.NODE_ENV;
-	const es5Standalone = process.env.ES5 && process.env.ES5 !== 'false';
-
-	if (api && api.cache) api.cache(() => env + es5Standalone);
-
-	return {
-		presets: [
-			[
-				require('@babel/preset-env').default,
-				{
-					exclude: [
-						// Exclude transforms that make all code slower
-						'transform-typeof-symbol',
-						// Exclude chunky/costly transforms
-						'transform-regenerator',
-						// Ignore web features since window and DOM is not available
-						// in a V8 snapshot blob.
-						// TODO: investigates ways to include but delay loading.
-						'web.dom-collections.for-each',
-						'web.dom-collections.iterator',
-						'web.immediate',
-						'web.queue-microtask',
-						'web.timers',
-						'web.url',
-						'web.url.to-json',
-						'web.url-search-params'
-					],
-					forceAllTransforms: es5Standalone,
-					useBuiltIns: 'entry',
-					corejs: 3
-				}
-			],
-			[
-				require('@babel/preset-react').default,
-				{
-					// Adds component stack to warning messages
-					// Adds __self attribute to JSX which React will use for some warnings
-					development: env !== 'production' && !es5Standalone,
-					// Will use the native built-in instead of trying to polyfill
-					// behavior for any plugins that require one.
-					...(!hasJsxRuntime ? {useBuiltIns: true} : {runtime: 'automatic'})
-				}
-			],
-			['@babel/preset-typescript']
-		],
-		plugins: [
-			// Stage 0
-			// '@babel/plugin-proposal-function-bind',
-
-			// Stage 1
-			require('@babel/plugin-proposal-export-default-from').default,
-			// '@babel/plugin-proposal-logical-assignment-operators',
-			// ['@babel/plugin-proposal-pipeline-operator', { 'proposal': 'minimal' }],
-			// '@babel/plugin-proposal-do-expressions',
-
-			// Stage 2
-			[require('@babel/plugin-proposal-decorators').default, false],
-			require('@babel/plugin-proposal-export-namespace-from').default,
-			require('@babel/plugin-proposal-numeric-separator').default,
-			// '@babel/plugin-proposal-function-sent',
-			// '@babel/plugin-proposal-throw-expressions',
-
-			// Stage 3
-			require('@babel/plugin-syntax-dynamic-import').default,
-			[require('@babel/plugin-proposal-class-properties').default, {loose: true}],
-			[require('@babel/plugin-proposal-private-methods').default, {loose: true}],
-			[require('@babel/plugin-proposal-private-property-in-object').default, {loose: true}],
-			// '@babel/plugin-syntax-import-meta',
-			// '@babel/plugin-proposal-json-strings'
-
-			// Soon to be included within pre-env; include here until then
-			require('@babel/plugin-proposal-optional-chaining').default,
-			require('@babel/plugin-proposal-nullish-coalescing-operator').default,
-
-			!es5Standalone && [
-				require('@babel/plugin-transform-runtime').default,
-				{
-					corejs: false,
-					helpers: true,
-					// Explicitly resolve runtime version to avoid issue
-					// https://github.com/babel/babel/issues/10261
-					version: require('@babel/runtime/package.json').version,
-					regenerator: false,
-					useESModules: !es5Standalone,
-					// @remove-on-eject-begin
-					// Undocumented option to use CLI-contained runtime, ensuring
-					// the correct version
-					absoluteRuntime: path.dirname(require.resolve('@babel/runtime/package.json'))
-					// @remove-on-eject-end
-				}
-			],
-
-			require('babel-plugin-dev-expression'),
-			env === 'test' && !es5Standalone && require('babel-plugin-dynamic-import-node').default,
-			env === 'production' && !es5Standalone && require('@babel/plugin-transform-react-inline-elements').default,
-			env === 'production' &&
-				!es5Standalone && [
-					require('babel-plugin-transform-react-remove-prop-types').default,
-					{removeImport: true}
-				]
-		].filter(Boolean),
-		overrides: [
-			{
-				test: /\.tsx?$/,
-				plugins: [[require('@babel/plugin-proposal-decorators').default, {legacy: true}]]
-			}
-		]
-	};
-};
+module.exports = require('babel-preset-enact');

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).