mathjs 9.2.0 → 9.4.0

package/examples/node_modules/webpack-cli/README.md

@@ -0,0 +1,116 @@
+<div align="center">
+    <a href="https://github.com/webpack/webpack-cli">
+        <img width="200" height="200" src="https://webpack.js.org/assets/icon-square-big.svg">
+    </a>
+</div>
+
+# webpack CLI
+
+The official CLI of webpack
+
+## About
+
+webpack CLI provides a flexible set of commands for developers to increase speed when setting up a custom webpack project. As of webpack v4, webpack is not expecting a configuration file, but often developers want to create a more custom webpack configuration based on their use-cases and needs. webpack CLI addresses these needs by providing a set of tools to improve the setup of custom webpack configuration.
+
+## How to install
+
+When you have followed the [Getting Started](https://webpack.js.org/guides/getting-started/) guide of webpack then webpack CLI is already installed!
+
+Otherwise
+
+```bash
+npm install --save-dev webpack-cli
+```
+
+or
+
+```bash
+yarn add webpack-cli --dev
+```
+
+## Supported arguments and commands
+
+### Usage
+
+All interactions with webpack-cli are of the form
+
+```bash
+npx webpack-cli [command] [options]
+```
+
+If no command is specified then `bundle` command is used by default
+
+### Help Usage
+
+You display basic commands and arguments -
+
+```bash
+npx webpack-cli --help
+```
+
+To display all supported commands and arguments -
+
+```bash
+npx webpack-cli --help=verbose
+```
+
+or
+
+```bash
+npx webpack-cli --help verbose
+```
+
+### Available Commands
+
+```
+  build|bundle|b [entries...] [options]      Run webpack (default command, can be omitted).
+  configtest|t [config-path]                 Validate a webpack configuration.
+  help|h [command] [option]                  Display help for commands and options.
+  info|i [options]                           Outputs information about your system.
+  init|c [scaffold...] [options]             Initialize a new webpack configuration.
+  loader|l [output-path]                     Scaffold a loader.
+  migrate|m <config-path> [new-config-path]  Migrate a configuration to a new version.
+  plugin|p [output-path]                     Scaffold a plugin.
+  serve|s [entries...] [options]             Run the webpack dev server.
+  version|v [commands...]                    Output the version number of 'webpack', 'webpack-cli' and 'webpack-dev-server' and commands.
+  watch|w [entries...] [options]             Run webpack and watch for files changes.
+```
+
+### webpack 4
+
+```
+  Options:
+  --analyze                     It invokes webpack-bundle-analyzer plugin to get bundle information
+  -c, --config <value...>       Provide path to a webpack configuration file e.g. ./webpack.config.js.
+  --config-name <value...>      Name of the configuration to use.
+  -m, --merge                   Merge two or more configurations using 'webpack-merge'.
+  --env <value...>              Environment passed to the configuration when it is a function.
+  --progress [value]            Print compilation progress during build.
+  -j, --json [value]            Prints result as JSON or store it in a file.
+  -d, --devtool <value>         Determine source maps to use.
+  --no-devtool                  Do not generate source maps.
+  --entry <value...>            The entry point(s) of your application e.g. ./src/main.js.
+  -h, --hot                     Enables Hot Module Replacement
+  --no-hot                      Disables Hot Module Replacement
+  --mode <value>                Defines the mode to pass to webpack.
+  --name <value>                Name of the configuration. Used when loading multiple configurations.
+  -o, --output-path <value>     Output location of the file generated by webpack e.g. ./dist/.
+  --prefetch <value>            Prefetch this request
+  --stats [value]               It instructs webpack on how to treat the stats e.g. verbose.
+  --no-stats                    Disable stats output.
+  -t, --target <value...>       Sets the build target e.g. node.
+  -w, --watch                   Watch for files changes.
+  --no-watch                    Do not watch for file changes.
+  --watch-options-stdin         Stop watching when stdin stream has ended.
+  --no-watch-options-stdin      Do not stop watching when stdin stream has ended.
+
+Global options:
+  --color                       Enable colors on console.
+  --no-color                    Disable colors on console.
+  -v, --version                 Output the version number of 'webpack', 'webpack-cli' and 'webpack-dev-server' and commands.
+  -h, --help [verbose]          Display help for commands and options.
+```
+
+### webpack 5
+
+Checkout [`OPTIONS.md`](../../OPTIONS.md) to see list of all available options.

package/examples/node_modules/webpack-cli/bin/cli.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const Module = require('module');
+
+const originalModuleCompile = Module.prototype._compile;
+
+require('v8-compile-cache');
+
+const importLocal = require('import-local');
+const runCLI = require('../lib/bootstrap');
+const utils = require('../lib/utils');
+
+// Prefer the local installation of `webpack-cli`
+if (importLocal(__filename)) {
+    return;
+}
+
+process.title = 'webpack';
+
+if (utils.packageExists('webpack')) {
+    runCLI(process.argv, originalModuleCompile);
+} else {
+    const { promptInstallation, logger, colors } = utils;
+
+    promptInstallation('webpack', () => {
+        utils.logger.error(`It looks like ${colors.bold('webpack')} is not installed.`);
+    })
+        .then(() => {
+            logger.success(`${colors.bold('webpack')} was installed successfully.`);
+
+            runCLI(process.argv, originalModuleCompile);
+        })
+        .catch(() => {
+            logger.error(`Action Interrupted, Please try once again or install ${colors.bold('webpack')} manually.`);
+
+            process.exit(2);
+        });
+}

package/examples/node_modules/webpack-cli/lib/bootstrap.js

@@ -0,0 +1,18 @@
+const WebpackCLI = require('./webpack-cli');
+const utils = require('./utils');
+
+const runCLI = async (args, originalModuleCompile) => {
+    try {
+        // Create a new instance of the CLI object
+        const cli = new WebpackCLI();
+
+        cli._originalModuleCompile = originalModuleCompile;
+
+        await cli.run(args);
+    } catch (error) {
+        utils.logger.error(error);
+        process.exit(2);
+    }
+};
+
+module.exports = runCLI;

package/examples/node_modules/webpack-cli/lib/index.js

@@ -0,0 +1,5 @@
+const CLI = require('./webpack-cli');
+const utils = require('./utils');
+
+module.exports = CLI;
+module.exports.utils = utils;

package/examples/node_modules/webpack-cli/lib/plugins/CLIPlugin.js

@@ -0,0 +1,99 @@
+class CLIPlugin {
+    constructor(options) {
+        this.options = options;
+    }
+
+    setupHotPlugin(compiler) {
+        const { HotModuleReplacementPlugin } = compiler.webpack || require('webpack');
+        const hotModuleReplacementPlugin = Boolean(compiler.options.plugins.find((plugin) => plugin instanceof HotModuleReplacementPlugin));
+
+        if (!hotModuleReplacementPlugin) {
+            new HotModuleReplacementPlugin().apply(compiler);
+        }
+    }
+
+    setupPrefetchPlugin(compiler) {
+        const { PrefetchPlugin } = compiler.webpack || require('webpack');
+
+        new PrefetchPlugin(null, this.options.prefetch).apply(compiler);
+    }
+
+    async setupBundleAnalyzerPlugin(compiler) {
+        // eslint-disable-next-line node/no-extraneous-require
+        const { BundleAnalyzerPlugin } = require('webpack-bundle-analyzer');
+        const bundleAnalyzerPlugin = Boolean(compiler.options.plugins.find((plugin) => plugin instanceof BundleAnalyzerPlugin));
+
+        if (!bundleAnalyzerPlugin) {
+            new BundleAnalyzerPlugin().apply(compiler);
+        }
+    }
+
+    setupProgressPlugin(compiler) {
+        const { ProgressPlugin } = compiler.webpack || require('webpack');
+        const progressPlugin = Boolean(compiler.options.plugins.find((plugin) => plugin instanceof ProgressPlugin));
+
+        if (!progressPlugin) {
+            new ProgressPlugin({ profile: this.options.progress === 'profile' }).apply(compiler);
+        }
+    }
+
+    setupHelpfulOutput(compiler) {
+        const pluginName = 'webpack-cli';
+        const getCompilationName = () => (compiler.name ? ` '${compiler.name}'` : '');
+
+        compiler.hooks.run.tap(pluginName, () => {
+            this.logger.log(`Compilation${getCompilationName()} starting...`);
+        });
+
+        compiler.hooks.watchRun.tap(pluginName, (compiler) => {
+            const { bail, watch } = compiler.options;
+
+            if (bail && watch) {
+                this.logger.warn('You are using "bail" with "watch". "bail" will still exit webpack when the first error is found.');
+            }
+
+            this.logger.log(`Compilation${getCompilationName()} starting...`);
+        });
+
+        compiler.hooks.invalid.tap(pluginName, (filename, changeTime) => {
+            const date = new Date(changeTime * 1000);
+
+            this.logger.log(`File '${filename}' was modified`);
+            this.logger.log(`Changed time is ${date} (timestamp is ${changeTime})`);
+        });
+
+        (compiler.webpack ? compiler.hooks.afterDone : compiler.hooks.done).tap(pluginName, () => {
+            this.logger.log(`Compilation${getCompilationName()} finished`);
+
+            process.nextTick(() => {
+                if (compiler.watchMode) {
+                    this.logger.log(`Compiler${getCompilationName()} is watching files for updates...`);
+                }
+            });
+        });
+    }
+
+    apply(compiler) {
+        this.logger = compiler.getInfrastructureLogger('webpack-cli');
+
+        if (this.options.progress) {
+            this.setupProgressPlugin(compiler);
+        }
+
+        if (this.options.hot) {
+            this.setupHotPlugin(compiler);
+        }
+
+        if (this.options.prefetch) {
+            this.setupPrefetchPlugin(compiler);
+        }
+
+        if (this.options.analyze) {
+            this.setupBundleAnalyzerPlugin(compiler);
+        }
+
+        this.setupHelpfulOutput(compiler);
+    }
+}
+
+module.exports = CLIPlugin;

package/examples/node_modules/webpack-cli/lib/utils/__tests__/get-package-manager.test.js

@@ -0,0 +1,108 @@
+const fs = require('fs');
+const path = require('path');
+
+const syncMock = jest.fn(() => {
+    return {
+        stdout: '1.0.0',
+    };
+});
+jest.setMock('execa', {
+    sync: syncMock,
+});
+const getPackageManager = require('../get-package-manager');
+
+jest.mock('../get-package-manager', () => jest.fn());
+const globalModulesNpmValue = 'test-npm';
+jest.setMock('global-modules', globalModulesNpmValue);
+jest.setMock('enquirer', {
+    prompt: jest.fn(),
+});
+
+describe('packageUtils', () => {
+    describe('getPackageManager', () => {
+        const testYarnLockPath = path.resolve(__dirname, 'test-yarn-lock');
+        const testNpmLockPath = path.resolve(__dirname, 'test-npm-lock');
+        const testPnpmLockPath = path.resolve(__dirname, 'test-pnpm-lock');
+        const testNpmAndPnpmPath = path.resolve(__dirname, 'test-npm-and-pnpm');
+        const testNpmAndYarnPath = path.resolve(__dirname, 'test-npm-and-yarn');
+        const testYarnAndPnpmPath = path.resolve(__dirname, 'test-yarn-and-pnpm');
+        const testAllPath = path.resolve(__dirname, 'test-all-lock');
+        const noLockPath = path.resolve(__dirname, 'no-lock-files');
+
+        const cwdSpy = jest.spyOn(process, 'cwd');
+
+        beforeAll(() => {
+            // package-lock.json is ignored by .gitignore, so we simply
+            // write a lockfile here for testing
+            if (!fs.existsSync(testNpmLockPath)) {
+                fs.mkdirSync(testNpmLockPath);
+            }
+            fs.writeFileSync(path.resolve(testNpmLockPath, 'package-lock.json'), '');
+            fs.writeFileSync(path.resolve(testNpmAndPnpmPath, 'package-lock.json'), '');
+            fs.writeFileSync(path.resolve(testNpmAndYarnPath, 'package-lock.json'), '');
+            fs.writeFileSync(path.resolve(testAllPath, 'package-lock.json'), '');
+        });
+
+        beforeEach(() => {
+            syncMock.mockClear();
+        });
+
+        it('should find yarn.lock', () => {
+            cwdSpy.mockReturnValue(testYarnLockPath);
+            expect(getPackageManager()).toEqual('yarn');
+            expect(syncMock.mock.calls.length).toEqual(0);
+        });
+
+        it('should find package-lock.json', () => {
+            cwdSpy.mockReturnValue(testNpmLockPath);
+            expect(getPackageManager()).toEqual('npm');
+            expect(syncMock.mock.calls.length).toEqual(0);
+        });
+
+        it('should find pnpm-lock.yaml', () => {
+            cwdSpy.mockReturnValue(testPnpmLockPath);
+            expect(getPackageManager()).toEqual('pnpm');
+            expect(syncMock.mock.calls.length).toEqual(0);
+        });
+
+        it('should prioritize npm over pnpm', () => {
+            cwdSpy.mockReturnValue(testNpmAndPnpmPath);
+            expect(getPackageManager()).toEqual('npm');
+            expect(syncMock.mock.calls.length).toEqual(0);
+        });
+
+        it('should prioritize npm over yarn', () => {
+            cwdSpy.mockReturnValue(testNpmAndYarnPath);
+            expect(getPackageManager()).toEqual('npm');
+            expect(syncMock.mock.calls.length).toEqual(0);
+        });
+
+        it('should prioritize yarn over pnpm', () => {
+            cwdSpy.mockReturnValue(testYarnAndPnpmPath);
+            expect(getPackageManager()).toEqual('yarn');
+            expect(syncMock.mock.calls.length).toEqual(0);
+        });
+
+        it('should prioritize npm with many lock files', () => {
+            cwdSpy.mockReturnValue(testAllPath);
+            expect(getPackageManager()).toEqual('npm');
+            expect(syncMock.mock.calls.length).toEqual(0);
+        });
+
+        it('should prioritize global npm over other package managers', () => {
+            cwdSpy.mockReturnValue(noLockPath);
+            expect(getPackageManager()).toEqual('npm');
+            expect(syncMock.mock.calls.length).toEqual(1);
+        });
+
+        it('should throw error if no package manager is found', () => {
+            syncMock.mockImplementation(() => {
+                throw new Error();
+            });
+            const mockExit = jest.spyOn(process, 'exit').mockImplementation(() => {});
+            expect(getPackageManager()).toBeFalsy();
+            expect(mockExit).toBeCalledWith(2);
+            expect(syncMock.mock.calls.length).toEqual(3); // 3 calls for npm, yarn and pnpm
+        });
+    });
+});

package/examples/node_modules/webpack-cli/lib/utils/__tests__/prompt-installation.test.js

@@ -0,0 +1,118 @@
+'use strict';
+
+// eslint-disable-next-line node/no-extraneous-require
+const stripAnsi = require('strip-ansi');
+const globalModulesNpmValue = 'test-npm';
+
+jest.setMock('global-modules', globalModulesNpmValue);
+jest.setMock('enquirer', { prompt: jest.fn() });
+jest.setMock('../run-command', jest.fn());
+jest.setMock('../package-exists', jest.fn());
+jest.setMock('../get-package-manager', jest.fn());
+
+const getPackageManager = require('../get-package-manager');
+const packageExists = require('../package-exists');
+const promptInstallation = require('../prompt-installation');
+const runCommand = require('../run-command');
+const { prompt } = require('enquirer');
+
+describe('promptInstallation', () => {
+    beforeAll(() => {
+        packageExists.mockReturnValue(true);
+    });
+    beforeEach(() => {
+        runCommand.mockClear();
+        prompt.mockClear();
+    });
+
+    it('should prompt to install using npm if npm is package manager', async () => {
+        prompt.mockReturnValue({ installConfirm: true });
+
+        getPackageManager.mockReturnValue('npm');
+
+        const preMessage = jest.fn();
+        const promptResult = await promptInstallation('test-package', preMessage);
+
+        expect(promptResult).toBeTruthy();
+        expect(preMessage.mock.calls.length).toEqual(1);
+        expect(prompt.mock.calls.length).toEqual(1);
+        expect(runCommand.mock.calls.length).toEqual(1);
+        expect(stripAnsi(prompt.mock.calls[0][0][0].message)).toContain(
+            "Would you like to install 'test-package' package? (That will run 'npm install -D test-package')",
+        );
+
+        // install the package using npm
+        expect(runCommand.mock.calls[0][0]).toEqual('npm install -D test-package');
+    });
+
+    it('should prompt to install using yarn if yarn is package manager', async () => {
+        prompt.mockReturnValue({ installConfirm: true });
+
+        getPackageManager.mockReturnValue('yarn');
+
+        const promptResult = await promptInstallation('test-package');
+
+        expect(promptResult).toBeTruthy();
+        expect(prompt.mock.calls.length).toEqual(1);
+        expect(runCommand.mock.calls.length).toEqual(1);
+        expect(stripAnsi(prompt.mock.calls[0][0][0].message)).toContain(
+            "Would you like to install 'test-package' package? (That will run 'yarn add -D test-package')",
+        );
+
+        // install the package using yarn
+        expect(runCommand.mock.calls[0][0]).toEqual('yarn add -D test-package');
+    });
+
+    it('should prompt to install using pnpm if pnpm is package manager', async () => {
+        prompt.mockReturnValue({ installConfirm: true });
+
+        getPackageManager.mockReturnValue('pnpm');
+
+        const promptResult = await promptInstallation('test-package');
+
+        expect(promptResult).toBeTruthy();
+        expect(prompt.mock.calls.length).toEqual(1);
+        expect(runCommand.mock.calls.length).toEqual(1);
+        expect(stripAnsi(prompt.mock.calls[0][0][0].message)).toContain(
+            "Would you like to install 'test-package' package? (That will run 'pnpm install -D test-package')",
+        );
+
+        // install the package using npm
+        expect(runCommand.mock.calls[0][0]).toEqual('pnpm install -D test-package');
+    });
+
+    it('should support pre message', async () => {
+        prompt.mockReturnValue({ installConfirm: true });
+
+        getPackageManager.mockReturnValue('npm');
+
+        const preMessage = jest.fn();
+        const promptResult = await promptInstallation('test-package', preMessage);
+
+        expect(promptResult).toBeTruthy();
+        expect(preMessage.mock.calls.length).toEqual(1);
+        expect(prompt.mock.calls.length).toEqual(1);
+        expect(runCommand.mock.calls.length).toEqual(1);
+        expect(stripAnsi(prompt.mock.calls[0][0][0].message)).toContain(
+            "Would you like to install 'test-package' package? (That will run 'npm install -D test-package')",
+        );
+
+        // install the package using npm
+        expect(runCommand.mock.calls[0][0]).toEqual('npm install -D test-package');
+    });
+
+    it('should not install if install is not confirmed', async () => {
+        prompt.mockReturnValue({ installConfirm: false });
+
+        const mockExit = jest.spyOn(process, 'exit').mockImplementation(() => {});
+        const promptResult = await promptInstallation('test-package');
+
+        expect(promptResult).toBeUndefined();
+        expect(prompt.mock.calls.length).toEqual(1);
+        // runCommand should not be called, because the installation is not confirmed
+        expect(runCommand.mock.calls.length).toEqual(0);
+        expect(mockExit.mock.calls[0][0]).toEqual(2);
+
+        mockExit.mockRestore();
+    });
+});

package/examples/node_modules/webpack-cli/lib/utils/capitalize-first-letter.js

@@ -0,0 +1,9 @@
+const capitalizeFirstLetter = (string) => {
+    if (typeof string !== 'string') {
+        return '';
+    }
+
+    return string.charAt(0).toUpperCase() + string.slice(1);
+};
+
+module.exports = capitalizeFirstLetter;

package/examples/node_modules/webpack-cli/lib/utils/dynamic-import-loader.js

@@ -0,0 +1,13 @@
+function dynamicImportLoader() {
+    let importESM;
+
+    try {
+        importESM = new Function('id', 'return import(id);');
+    } catch (e) {
+        importESM = null;
+    }
+
+    return importESM;
+}
+
+module.exports = dynamicImportLoader;

package/examples/node_modules/webpack-cli/lib/utils/get-package-manager.js

@@ -0,0 +1,65 @@
+const fs = require('fs');
+const path = require('path');
+const { sync } = require('execa');
+
+const utils = require('./index');
+
+/**
+ *
+ * Returns the name of package manager to use,
+ * preference order - npm > yarn > pnpm
+ *
+ * @returns {String} - The package manager name
+ */
+function getPackageManager() {
+    const hasLocalNpm = fs.existsSync(path.resolve(process.cwd(), 'package-lock.json'));
+
+    if (hasLocalNpm) {
+        return 'npm';
+    }
+
+    const hasLocalYarn = fs.existsSync(path.resolve(process.cwd(), 'yarn.lock'));
+
+    if (hasLocalYarn) {
+        return 'yarn';
+    }
+
+    const hasLocalPnpm = fs.existsSync(path.resolve(process.cwd(), 'pnpm-lock.yaml'));
+
+    if (hasLocalPnpm) {
+        return 'pnpm';
+    }
+
+    try {
+        // the sync function below will fail if npm is not installed,
+        // an error will be thrown
+        if (sync('npm', ['--version'])) {
+            return 'npm';
+        }
+    } catch (e) {
+        // Nothing
+    }
+
+    try {
+        // the sync function below will fail if yarn is not installed,
+        // an error will be thrown
+        if (sync('yarn', ['--version'])) {
+            return 'yarn';
+        }
+    } catch (e) {
+        // Nothing
+    }
+
+    try {
+        // the sync function below will fail if pnpm is not installed,
+        // an error will be thrown
+        if (sync('pnpm', ['--version'])) {
+            return 'pnpm';
+        }
+    } catch (e) {
+        utils.logger.error('No package manager found.');
+        process.exit(2);
+    }
+}
+
+module.exports = getPackageManager;

package/examples/node_modules/webpack-cli/lib/utils/index.js

@@ -0,0 +1,49 @@
+module.exports = {
+    get colors() {
+        return require('colorette');
+    },
+
+    get levenshtein() {
+        return require('fastest-levenshtein');
+    },
+
+    get interpret() {
+        return require('interpret');
+    },
+
+    get rechoir() {
+        return require('rechoir');
+    },
+
+    get capitalizeFirstLetter() {
+        return require('./capitalize-first-letter');
+    },
+
+    get dynamicImportLoader() {
+        return require('./dynamic-import-loader');
+    },
+
+    get getPackageManager() {
+        return require('./get-package-manager');
+    },
+
+    get logger() {
+        return require('./logger');
+    },
+
+    get packageExists() {
+        return require('./package-exists');
+    },
+
+    get promptInstallation() {
+        return require('./prompt-installation');
+    },
+
+    get runCommand() {
+        return require('./run-command');
+    },
+
+    get toKebabCase() {
+        return require('./to-kebab-case');
+    },
+};