Admin

name	type	size	perms	modified	actions
[parent directory]
.github/	dir	-	0775	2026-09-15 05:27:49
test/	dir	-	0775	2026-09-15 05:27:49
.nycrc	file	229 B	0664	2026-07-13 02:11:09	edit
eslint.config.mjs	file	608 B	0664	2026-07-13 02:11:09	edit
index.d.ts	file	873 B	0664	2026-07-13 02:11:09	edit
index.js	file	87 B	0664	2026-07-13 02:11:09	edit
LICENSE	file	1,109 B	0664	2026-07-13 02:11:09	edit
package.json	file	1,994 B	0664	2026-07-13 02:11:09	edit
parse.d.ts	file	1,444 B	0664	2026-07-13 02:11:09	edit
parse.js	file	6,326 B	0664	2026-07-13 02:11:09	edit
quote.d.ts	file	492 B	0664	2026-07-13 02:11:09	edit
quote.js	file	1,673 B	0664	2026-07-13 02:11:09	edit
README.md	file	3,997 B	0664	2026-07-13 02:11:09	edit
security.md	file	295 B	0664	2026-07-13 02:11:09	edit
tsconfig.json	file	123 B	0664	2026-07-13 02:11:09	edit

editing: parse.d.ts

declare namespace parse {
	/** A shell control operator. */
	export interface ControlOperator {
		op: '||' | '&&' | ';;' | '|&' | '<(' | '<<<' | '>>' | '>&' | '<&' | '&' | ';' | '(' | ')' | '|' | '<' | '>';
	}

/** A glob pattern parsed from the shell command. */
	export interface GlobPattern {
		op: 'glob';
		pattern: string;
	}

/** A shell comment. */
	export interface Comment {
		comment: string;
	}

/** A parsed token returned by {@link parse}. */
	export type ParseEntry = string | ControlOperator | GlobPattern | Comment;

/** Options for the {@link parse} function. */
	export interface ParseOptions {
		/** Custom escape character. Defaults to `\\`. */
		escape?: string;
	}

export type Env =
		| Record<string, string | undefined>
		| ((key: string) => string | object | undefined);
}

/**
 * Parses a shell command string into an array of tokens.
 *
 * @param s - The shell command string to parse.
 * @param env - Optional environment variables for expansion, either as an object of string values or a lookup function. When the lookup function returns an object, that object is inserted into the result verbatim.
 * @param opts - Optional parsing options.
 * @returns An array of parsed tokens, including any objects returned by an `env` lookup function.
 */
declare function parse<T extends string | object = never>(
	s: string,
	env?: parse.Env,
	opts?: parse.ParseOptions,
): (parse.ParseEntry | T)[];

export = parse;

cancel