@enact/dev-utils/mixins/isomorphic.js

A collection of development utilities for Enact apps.

const fs = require('fs');
const path = require('path');
const helper = require('../config-helper');
const app = require('../option-parser');
const PrerenderPlugin = require('../plugins/PrerenderPlugin');

module.exports = {
	apply: function (config, opts = {}) {
		// Resolve ReactDOM and ReactDOMSever relative to the app.
		const reactDOMServer = path.join(app.context, 'node_modules', 'react-dom', 'server.js');

		if (!opts.externals) {
			// Expose React on global to avoid multiple copy usage
			const react = path.join(app.context, 'node_modules', 'react', 'index.js');
			if (fs.existsSync(react)) {
				config.module.rules.unshift({
					test: fs.realpathSync(react),
					loader: 'expose-loader',
					options: {
						exposes: 'React'
					}
				});
			}
		}

		// If 'isomorphic' value is a string, use custom entrypoint.
		if (typeof app.isomorphic === 'string') {
			helper.replaceMain(config, path.resolve(app.isomorphic));
		}

		// Since we're building for isomorphic usage, expose ReactElement
		config.output.library = 'App';

		// Use universal module definition to allow usage in Node and browser environments.
		config.output.libraryTarget = 'umd';

		// Use 'this' as the global object to attach the app object to.
		config.output.globalObject = 'this';

		// Include plugin to prerender the html into the index.html
		const htmlPluginInstance = helper.getPluginByName(config, 'HtmlWebpackPlugin');
		const webOSMetaPluginInstance = helper.getPluginByName(config, 'WebOSMetaPlugin');
		config.plugins.push(
			new PrerenderPlugin({
				server: reactDOMServer,
				locales: opts.locales,
				deep: app.deep,
				externals: opts.externals,
				screenTypes: app.screenTypes,
				fontGenerator: app.fontGenerator,
				externalStartup: app.externalStartup,
				mapfile: opts.mapfile,
				htmlPlugin: htmlPluginInstance && htmlPluginInstance.constructor,
				webOSMetaPlugin: webOSMetaPluginInstance && webOSMetaPluginInstance.constructor
			})
		);

		// Apply snapshot specialization options if needed
		if (opts.snapshot && !opts.externals) {
			const SnapshotPlugin = require('../plugins/SnapshotPlugin');

			// Inject snapshot helper for the transition from v8 snapshot into the window
			helper.injectEntry(config, SnapshotPlugin.helperJS);
			helper.injectEntry(config, SnapshotPlugin.helperReduxJS);

			// Include plugin to attempt generation of v8 snapshot binary if V8_MKSNAPSHOT env var is set
			config.plugins.push(
				new SnapshotPlugin({
					target: 'main.js',
					webOSMetaPlugin: webOSMetaPluginInstance && webOSMetaPluginInstance.constructor
				})
			);
		}

		return config;
	}
};