create-docusaurus 0.0.0-4376 → 0.0.0-4383

package/templates/facebook/node_modules/meow/index.d.ts

@@ -0,0 +1,315 @@
+import {PackageJson} from 'type-fest';
+
+declare namespace meow {
+	type FlagType = 'string' | 'boolean' | 'number';
+
+	/**
+	Callback function to determine if a flag is required during runtime.
+
+	@param flags - Contains the flags converted to camel-case excluding aliases.
+	@param input - Contains the non-flag arguments.
+
+	@returns True if the flag is required, otherwise false.
+	*/
+	type IsRequiredPredicate = (flags: Readonly<AnyFlags>, input: readonly string[]) => boolean;
+
+	interface Flag<Type extends FlagType, Default> {
+		readonly type?: Type;
+		readonly alias?: string;
+		readonly default?: Default;
+		readonly isRequired?: boolean | IsRequiredPredicate;
+		readonly isMultiple?: boolean;
+	}
+
+	type StringFlag = Flag<'string', string>;
+	type BooleanFlag = Flag<'boolean', boolean>;
+	type NumberFlag = Flag<'number', number>;
+
+	type AnyFlag = StringFlag | BooleanFlag | NumberFlag;
+	type AnyFlags = Record<string, AnyFlag>;
+
+	interface Options<Flags extends AnyFlags> {
+		/**
+		Define argument flags.
+
+		The key is the flag name in camel-case and the value is an object with any of:
+
+		- `type`: Type of value. (Possible values: `string` `boolean` `number`)
+		- `alias`: Usually used to define a short flag alias.
+		- `default`: Default value when the flag is not specified.
+		- `isRequired`: Determine if the flag is required.
+			If it's only known at runtime whether the flag is required or not you can pass a Function instead of a boolean, which based on the given flags and other non-flag arguments should decide if the flag is required.
+		- `isMultiple`: Indicates a flag can be set multiple times. Values are turned into an array. (Default: false)
+			Multiple values are provided by specifying the flag multiple times, for example, `$ foo -u rainbow -u cat`. Space- or comma-separated values are *not* supported.
+
+		Note that flags are always defined using a camel-case key (`myKey`), but will match arguments in kebab-case (`--my-key`).
+
+		@example
+		```
+		flags: {
+			unicorn: {
+				type: 'string',
+				alias: 'u',
+				default: ['rainbow', 'cat'],
+				isMultiple: true,
+				isRequired: (flags, input) => {
+					if (flags.otherFlag) {
+						return true;
+					}
+
+					return false;
+				}
+			}
+		}
+		```
+		*/
+		readonly flags?: Flags;
+
+		/**
+		Description to show above the help text. Default: The package.json `"description"` property.
+
+		Set it to `false` to disable it altogether.
+		*/
+		readonly description?: string | false;
+
+		/**
+		The help text you want shown.
+
+		The input is reindented and starting/ending newlines are trimmed which means you can use a [template literal](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/template_strings) without having to care about using the correct amount of indent.
+
+		The description will be shown above your help text automatically.
+
+		Set it to `false` to disable it altogether.
+		*/
+		readonly help?: string | false;
+
+		/**
+		Set a custom version output. Default: The package.json `"version"` property.
+
+		Set it to `false` to disable it altogether.
+		*/
+		readonly version?: string | false;
+
+		/**
+		Automatically show the help text when the `--help` flag is present. Useful to set this value to `false` when a CLI manages child CLIs with their own help text.
+
+		This option is only considered when there is only one argument in `process.argv`.
+		*/
+		readonly autoHelp?: boolean;
+
+		/**
+		Automatically show the version text when the `--version` flag is present. Useful to set this value to `false` when a CLI manages child CLIs with their own version text.
+
+		This option is only considered when there is only one argument in `process.argv`.
+		*/
+		readonly autoVersion?: boolean;
+
+		/**
+		`package.json` as an `Object`. Default: Closest `package.json` upwards.
+
+		_You most likely don't need this option._
+		*/
+		readonly pkg?: Record<string, unknown>;
+
+		/**
+		Custom arguments object.
+
+		@default process.argv.slice(2)
+		*/
+		readonly argv?: readonly string[];
+
+		/**
+		Infer the argument type.
+
+		By default, the argument `5` in `$ foo 5` becomes a string. Enabling this would infer it as a number.
+
+		@default false
+		*/
+		readonly inferType?: boolean;
+
+		/**
+		Value of `boolean` flags not defined in `argv`.
+
+		If set to `undefined`, the flags not defined in `argv` will be excluded from the result. The `default` value set in `boolean` flags take precedence over `booleanDefault`.
+
+		_Note: If used in conjunction with `isMultiple`, the default flag value is set to `[]`._
+
+		__Caution: Explicitly specifying `undefined` for `booleanDefault` has different meaning from omitting key itself.__
+
+		@example
+		```
+		import meow = require('meow');
+
+		const cli = meow(`
+			Usage
+				$ foo
+
+			Options
+				--rainbow, -r  Include a rainbow
+				--unicorn, -u  Include a unicorn
+				--no-sparkles  Exclude sparkles
+
+			Examples
+				$ foo
+				🌈 unicorns✨🌈
+		`, {
+			booleanDefault: undefined,
+			flags: {
+				rainbow: {
+					type: 'boolean',
+					default: true,
+					alias: 'r'
+				},
+					unicorn: {
+					type: 'boolean',
+					default: false,
+					alias: 'u'
+				},
+				cake: {
+					type: 'boolean',
+					alias: 'c'
+				},
+				sparkles: {
+					type: 'boolean',
+					default: true
+				}
+			}
+		});
+
+		//{
+		//	flags: {
+		//		rainbow: true,
+		//		unicorn: false,
+		//		sparkles: true
+		//	},
+		//	unnormalizedFlags: {
+		//		rainbow: true,
+		//		r: true,
+		//		unicorn: false,
+		//		u: false,
+		//		sparkles: true
+		//	},
+		//	…
+		//}
+		```
+		*/
+		readonly booleanDefault?: boolean | null | undefined;
+
+		/**
+		Whether to use [hard-rejection](https://github.com/sindresorhus/hard-rejection) or not. Disabling this can be useful if you need to handle `process.on('unhandledRejection')` yourself.
+
+		@default true
+		*/
+		readonly hardRejection?: boolean;
+
+		/**
+		Whether to allow unknown flags or not.
+
+		@default true
+		*/
+		readonly allowUnknownFlags?: boolean;
+	}
+
+	type TypedFlag<Flag extends AnyFlag> =
+		Flag extends {type: 'number'}
+			? number
+			: Flag extends {type: 'string'}
+				? string
+				: Flag extends {type: 'boolean'}
+					? boolean
+					: unknown;
+
+	type PossiblyOptionalFlag<Flag extends AnyFlag, FlagType> =
+		Flag extends {isRequired: true}
+			? FlagType
+			: Flag extends {default: any}
+				? FlagType
+				: FlagType | undefined;
+
+	type TypedFlags<Flags extends AnyFlags> = {
+		[F in keyof Flags]: Flags[F] extends {isMultiple: true}
+			? PossiblyOptionalFlag<Flags[F], Array<TypedFlag<Flags[F]>>>
+			: PossiblyOptionalFlag<Flags[F], TypedFlag<Flags[F]>>
+	};
+
+	interface Result<Flags extends AnyFlags> {
+		/**
+		Non-flag arguments.
+		*/
+		input: string[];
+
+		/**
+		Flags converted to camelCase excluding aliases.
+		*/
+		flags: TypedFlags<Flags> & Record<string, unknown>;
+
+		/**
+		Flags converted camelCase including aliases.
+		*/
+		unnormalizedFlags: TypedFlags<Flags> & Record<string, unknown>;
+
+		/**
+		The `package.json` object.
+		*/
+		pkg: PackageJson;
+
+		/**
+		The help text used with `--help`.
+		*/
+		help: string;
+
+		/**
+		Show the help text and exit with code.
+
+		@param exitCode - The exit code to use. Default: `2`.
+		*/
+		showHelp: (exitCode?: number) => void;
+
+		/**
+		Show the version text and exit.
+		*/
+		showVersion: () => void;
+	}
+}
+/**
+@param helpMessage - Shortcut for the `help` option.
+
+@example
+```
+#!/usr/bin/env node
+'use strict';
+import meow = require('meow');
+import foo = require('.');
+
+const cli = meow(`
+	Usage
+	  $ foo <input>
+
+	Options
+	  --rainbow, -r  Include a rainbow
+
+	Examples
+	  $ foo unicorns --rainbow
+	  🌈 unicorns 🌈
+`, {
+	flags: {
+		rainbow: {
+			type: 'boolean',
+			alias: 'r'
+		}
+	}
+});
+
+//{
+//	input: ['unicorns'],
+//	flags: {rainbow: true},
+//	...
+//}
+
+foo(cli.input[0], cli.flags);
+```
+*/
+declare function meow<Flags extends meow.AnyFlags>(helpMessage: string, options?: meow.Options<Flags>): meow.Result<Flags>;
+declare function meow<Flags extends meow.AnyFlags>(options?: meow.Options<Flags>): meow.Result<Flags>;
+
+export = meow;

package/templates/facebook/node_modules/meow/index.js

@@ -0,0 +1,236 @@
+'use strict';
+const path = require('path');
+const buildParserOptions = require('minimist-options');
+const parseArguments = require('yargs-parser');
+const camelCaseKeys = require('camelcase-keys');
+const decamelize = require('decamelize');
+const decamelizeKeys = require('decamelize-keys');
+const trimNewlines = require('trim-newlines');
+const redent = require('redent');
+const readPkgUp = require('read-pkg-up');
+const hardRejection = require('hard-rejection');
+const normalizePackageData = require('normalize-package-data');
+
+// Prevent caching of this module so module.parent is always accurate
+delete require.cache[__filename];
+const parentDir = path.dirname(module.parent && module.parent.filename ? module.parent.filename : '.');
+
+const isFlagMissing = (flagName, definedFlags, receivedFlags, input) => {
+	const flag = definedFlags[flagName];
+	let isFlagRequired = true;
+
+	if (typeof flag.isRequired === 'function') {
+		isFlagRequired = flag.isRequired(receivedFlags, input);
+		if (typeof isFlagRequired !== 'boolean') {
+			throw new TypeError(`Return value for isRequired callback should be of type boolean, but ${typeof isFlagRequired} was returned.`);
+		}
+	}
+
+	if (typeof receivedFlags[flagName] === 'undefined') {
+		return isFlagRequired;
+	}
+
+	return flag.isMultiple && receivedFlags[flagName].length === 0;
+};
+
+const getMissingRequiredFlags = (flags, receivedFlags, input) => {
+	const missingRequiredFlags = [];
+	if (typeof flags === 'undefined') {
+		return [];
+	}
+
+	for (const flagName of Object.keys(flags)) {
+		if (flags[flagName].isRequired && isFlagMissing(flagName, flags, receivedFlags, input)) {
+			missingRequiredFlags.push({key: flagName, ...flags[flagName]});
+		}
+	}
+
+	return missingRequiredFlags;
+};
+
+const reportMissingRequiredFlags = missingRequiredFlags => {
+	console.error(`Missing required flag${missingRequiredFlags.length > 1 ? 's' : ''}`);
+	for (const flag of missingRequiredFlags) {
+		console.error(`\t--${decamelize(flag.key, '-')}${flag.alias ? `, -${flag.alias}` : ''}`);
+	}
+};
+
+const validateOptions = ({flags}) => {
+	const invalidFlags = Object.keys(flags).filter(flagKey => flagKey.includes('-') && flagKey !== '--');
+	if (invalidFlags.length > 0) {
+		throw new Error(`Flag keys may not contain '-': ${invalidFlags.join(', ')}`);
+	}
+};
+
+const reportUnknownFlags = unknownFlags => {
+	console.error([
+		`Unknown flag${unknownFlags.length > 1 ? 's' : ''}`,
+		...unknownFlags
+	].join('\n'));
+};
+
+const buildParserFlags = ({flags, booleanDefault}) => {
+	const parserFlags = {};
+
+	for (const [flagKey, flagValue] of Object.entries(flags)) {
+		const flag = {...flagValue};
+
+		if (
+			typeof booleanDefault !== 'undefined' &&
+			flag.type === 'boolean' &&
+			!Object.prototype.hasOwnProperty.call(flag, 'default')
+		) {
+			flag.default = flag.isMultiple ? [booleanDefault] : booleanDefault;
+		}
+
+		if (flag.isMultiple) {
+			flag.type = flag.type ? `${flag.type}-array` : 'array';
+			flag.default = flag.default || [];
+			delete flag.isMultiple;
+		}
+
+		parserFlags[flagKey] = flag;
+	}
+
+	return parserFlags;
+};
+
+const validateFlags = (flags, options) => {
+	for (const [flagKey, flagValue] of Object.entries(options.flags)) {
+		if (flagKey !== '--' && !flagValue.isMultiple && Array.isArray(flags[flagKey])) {
+			throw new Error(`The flag --${flagKey} can only be set once.`);
+		}
+	}
+};
+
+const meow = (helpText, options) => {
+	if (typeof helpText !== 'string') {
+		options = helpText;
+		helpText = '';
+	}
+
+	const foundPkg = readPkgUp.sync({
+		cwd: parentDir,
+		normalize: false
+	});
+
+	options = {
+		pkg: foundPkg ? foundPkg.packageJson : {},
+		argv: process.argv.slice(2),
+		flags: {},
+		inferType: false,
+		input: 'string',
+		help: helpText,
+		autoHelp: true,
+		autoVersion: true,
+		booleanDefault: false,
+		hardRejection: true,
+		allowUnknownFlags: true,
+		...options
+	};
+
+	if (options.hardRejection) {
+		hardRejection();
+	}
+
+	validateOptions(options);
+	let parserOptions = {
+		arguments: options.input,
+		...buildParserFlags(options)
+	};
+
+	parserOptions = decamelizeKeys(parserOptions, '-', {exclude: ['stopEarly', '--']});
+
+	if (options.inferType) {
+		delete parserOptions.arguments;
+	}
+
+	parserOptions = buildParserOptions(parserOptions);
+
+	parserOptions.configuration = {
+		...parserOptions.configuration,
+		'greedy-arrays': false
+	};
+
+	if (parserOptions['--']) {
+		parserOptions.configuration['populate--'] = true;
+	}
+
+	if (!options.allowUnknownFlags) {
+		// Collect unknown options in `argv._` to be checked later.
+		parserOptions.configuration['unknown-options-as-args'] = true;
+	}
+
+	const {pkg} = options;
+	const argv = parseArguments(options.argv, parserOptions);
+	let help = redent(trimNewlines((options.help || '').replace(/\t+\n*$/, '')), 2);
+
+	normalizePackageData(pkg);
+
+	process.title = pkg.bin ? Object.keys(pkg.bin)[0] : pkg.name;
+
+	let {description} = options;
+	if (!description && description !== false) {
+		({description} = pkg);
+	}
+
+	help = (description ? `\n  ${description}\n` : '') + (help ? `\n${help}\n` : '\n');
+
+	const showHelp = code => {
+		console.log(help);
+		process.exit(typeof code === 'number' ? code : 2);
+	};
+
+	const showVersion = () => {
+		console.log(typeof options.version === 'string' ? options.version : pkg.version);
+		process.exit(0);
+	};
+
+	if (argv._.length === 0 && options.argv.length === 1) {
+		if (argv.version === true && options.autoVersion) {
+			showVersion();
+		}
+
+		if (argv.help === true && options.autoHelp) {
+			showHelp(0);
+		}
+	}
+
+	const input = argv._;
+	delete argv._;
+
+	if (!options.allowUnknownFlags) {
+		const unknownFlags = input.filter(item => typeof item === 'string' && item.startsWith('-'));
+		if (unknownFlags.length > 0) {
+			reportUnknownFlags(unknownFlags);
+			process.exit(2);
+		}
+	}
+
+	const flags = camelCaseKeys(argv, {exclude: ['--', /^\w$/]});
+	const unnormalizedFlags = {...flags};
+
+	validateFlags(flags, options);
+
+	for (const flagValue of Object.values(options.flags)) {
+		delete flags[flagValue.alias];
+	}
+
+	const missingRequiredFlags = getMissingRequiredFlags(options.flags, flags, input);
+	if (missingRequiredFlags.length > 0) {
+		reportMissingRequiredFlags(missingRequiredFlags);
+		process.exit(2);
+	}
+
+	return {
+		input,
+		flags,
+		unnormalizedFlags,
+		pkg,
+		help,
+		showHelp,
+		showVersion
+	};
+};
+
+module.exports = meow;

package/templates/facebook/node_modules/meow/license

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/templates/facebook/node_modules/meow/package.json

@@ -0,0 +1,77 @@
+{
+	"name": "meow",
+	"version": "9.0.0",
+	"description": "CLI app helper",
+	"license": "MIT",
+	"repository": "sindresorhus/meow",
+	"funding": "https://github.com/sponsors/sindresorhus",
+	"author": {
+		"name": "Sindre Sorhus",
+		"email": "sindresorhus@gmail.com",
+		"url": "https://sindresorhus.com"
+	},
+	"engines": {
+		"node": ">=10"
+	},
+	"scripts": {
+		"test": "xo && ava && tsd"
+	},
+	"files": [
+		"index.js",
+		"index.d.ts"
+	],
+	"keywords": [
+		"cli",
+		"bin",
+		"util",
+		"utility",
+		"helper",
+		"argv",
+		"command",
+		"line",
+		"meow",
+		"cat",
+		"kitten",
+		"parser",
+		"option",
+		"flags",
+		"input",
+		"cmd",
+		"console"
+	],
+	"dependencies": {
+		"@types/minimist": "^1.2.0",
+		"camelcase-keys": "^6.2.2",
+		"decamelize": "^1.2.0",
+		"decamelize-keys": "^1.1.0",
+		"hard-rejection": "^2.1.0",
+		"minimist-options": "4.1.0",
+		"normalize-package-data": "^3.0.0",
+		"read-pkg-up": "^7.0.1",
+		"redent": "^3.0.0",
+		"trim-newlines": "^3.0.0",
+		"type-fest": "^0.18.0",
+		"yargs-parser": "^20.2.3"
+	},
+	"devDependencies": {
+		"ava": "^2.4.0",
+		"execa": "^4.1.0",
+		"indent-string": "^4.0.0",
+		"tsd": "^0.13.1",
+		"xo": "^0.34.1"
+	},
+	"xo": {
+		"rules": {
+			"unicorn/no-process-exit": "off",
+			"node/no-unsupported-features/es-syntax": "off"
+		},
+		"ignores": [
+			"estest/index.js"
+		]
+	},
+	"ava": {
+		"files": [
+			"test/*"
+		]
+	}
+}