@qzsy/vinext 0.1.7

package/dist/cli-args.d.ts

@@ -0,0 +1,33 @@
+//#region src/cli-args.d.ts
+/**
+ * CLI argument parser for the vinext CLI.
+ *
+ * Parses flags for `vinext dev`, `vinext start`, `vinext build`, etc.
+ * Validates that value-taking flags (`--port`, `--hostname`) have actual values
+ * rather than silently consuming the next flag or returning NaN/undefined.
+ */
+type ParsedArgs = {
+  port?: number;
+  hostname?: string;
+  help?: boolean;
+  verbose?: boolean;
+  turbopack?: boolean;
+  experimental?: boolean;
+  prerenderAll?: boolean;
+  prerenderConcurrency?: number;
+  precompress?: boolean;
+  positionals?: string[];
+};
+declare function parsePositiveIntegerArg(raw: string, flag: string): number;
+/**
+ * Parse CLI arguments into a structured object.
+ *
+ * Handles both `--flag value` and `--flag=value` forms for value-taking flags.
+ *
+ * Used by `vinext dev`, `build`, `start`, `lint`, `check`, and `init` commands.
+ * The `deploy` command uses `parseDeployArgs` (a `node:util` wrapper) for its
+ * own flag set including `--env`, `--skip-build`, etc.
+ */
+declare function parseArgs(args: string[]): ParsedArgs;
+//#endregion
+export { parseArgs, parsePositiveIntegerArg };

package/dist/cli-args.js

@@ -0,0 +1,124 @@
+//#region src/cli-args.ts
+const FLAG_PATTERN = /^(?:--|-[a-zA-Z]$)/;
+/**
+* Consume the next positional argument as a value for a flag.
+*
+* Throws if:
+* - No argument follows (end of argv)
+* - The value is an empty string
+* - The next argument is another flag (--long or -x short form)
+*/
+function takeValue(flag, args, i) {
+	const next = args[i + 1];
+	if (next === void 0 || next === "") throw new Error(`${flag} requires a value, but none was provided.`);
+	if (FLAG_PATTERN.test(next)) throw new Error(`${flag} requires a value, but got "${next}" which looks like another flag.`);
+	return next;
+}
+/**
+* Try to extract a value from `--flag=value` form.
+* Returns the raw value, or null if the arg doesn't match this flag's = form.
+*/
+function tryEqualsForm(arg, flagName) {
+	const prefix = `--${flagName}=`;
+	return arg.startsWith(prefix) ? arg.slice(prefix.length) : null;
+}
+/**
+* Parse a port string into a valid TCP port number (0-65535).
+*
+* Uses `Number()` instead of `parseInt()` so that trailing garbage
+* (`4000abc`) is rejected rather than silently truncated to 4000.
+*/
+function parsePort(raw, flag) {
+	if (raw === "") throw new Error(`${flag} requires a value, but none was provided.`);
+	const parsed = Number(raw);
+	if (!Number.isInteger(parsed)) throw new Error(`${flag} expects an integer, but got "${raw}".`);
+	if (parsed < 0 || parsed > 65535) throw new Error(`${flag} expects a valid port (0-65535), but got "${raw}".`);
+	return parsed;
+}
+function parsePositiveIntegerArg(raw, flag) {
+	if (raw === "") throw new Error(`${flag} requires a value, but none was provided.`);
+	const parsed = Number(raw);
+	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error(`${flag} expects a positive integer, but got "${raw}".`);
+	return parsed;
+}
+/**
+* Parse CLI arguments into a structured object.
+*
+* Handles both `--flag value` and `--flag=value` forms for value-taking flags.
+*
+* Used by `vinext dev`, `build`, `start`, `lint`, `check`, and `init` commands.
+* The `deploy` command uses `parseDeployArgs` (a `node:util` wrapper) for its
+* own flag set including `--env`, `--skip-build`, etc.
+*/
+function parseArgs(args) {
+	const result = {};
+	const addPositional = (arg) => {
+		result.positionals ??= [];
+		result.positionals.push(arg);
+	};
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		switch (arg) {
+			case "--help":
+			case "-h":
+				result.help = true;
+				break;
+			case "--verbose":
+				result.verbose = true;
+				break;
+			case "--turbopack":
+				result.turbopack = true;
+				break;
+			case "--experimental-https":
+				result.experimental = true;
+				break;
+			case "--prerender-all":
+				result.prerenderAll = true;
+				break;
+			case "--prerender-concurrency": {
+				const raw = takeValue(arg, args, i);
+				i++;
+				result.prerenderConcurrency = parsePositiveIntegerArg(raw, arg);
+				break;
+			}
+			case "--precompress":
+				result.precompress = true;
+				break;
+			case "--port":
+			case "-p": {
+				const raw = takeValue(arg, args, i);
+				i++;
+				result.port = parsePort(raw, arg);
+				break;
+			}
+			case "--hostname":
+			case "-H":
+				result.hostname = takeValue(arg, args, i);
+				i++;
+				break;
+			default: {
+				const eqRaw = tryEqualsForm(arg, "port");
+				if (eqRaw !== null) {
+					result.port = parsePort(eqRaw, "--port");
+					break;
+				}
+				const hostRaw = tryEqualsForm(arg, "hostname");
+				if (hostRaw !== null) {
+					if (hostRaw === "") throw new Error(`--hostname requires a value, but none was provided.`);
+					result.hostname = hostRaw;
+					break;
+				}
+				const prerenderConcurrencyRaw = tryEqualsForm(arg, "prerender-concurrency");
+				if (prerenderConcurrencyRaw !== null) {
+					result.prerenderConcurrency = parsePositiveIntegerArg(prerenderConcurrencyRaw, "--prerender-concurrency");
+					break;
+				}
+				if (!FLAG_PATTERN.test(arg)) addPositional(arg);
+				break;
+			}
+		}
+	}
+	return result;
+}
+//#endregion
+export { parseArgs, parsePositiveIntegerArg };

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export { };