@ac-kit/core 0.1.0

package/dist/shell/process/stringify-env-variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify-env-variable.d.ts","sourceRoot":"","sources":["../../../src/shell/process/stringify-env-variable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,MAAM,GAAG,MAAM,GACpB,MAAM,CAER;AAED,MAAM,MAAM,0BAA0B,GACnC,KAAK,GACL,YAAY,GACZ,QAAQ,GACR,QAAQ,CAAC;AAEZ;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,0BAA0B,GAChC,MAAM,CAcR;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC9C,6EAA6E;IAC7E,UAAU,CAAC,EAAE,0BAA0B,CAAC;CACxC,CAAC;AAOF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,gCAAgC,GACxC,MAAM,CA0BR;AAED,MAAM,MAAM,2BAA2B,GAAG,gCAAgC,CAAC;AAO3E;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,2BAA2B,GACnC,MAAM,CAOR"}

package/dist/shell/process/stringify-env-variable.js

@@ -0,0 +1,86 @@
+import { UnsupportedError, defaults } from "@ac-kit/core";
+/**
+ * Stringify a string environment variable value.
+ *
+ * If the string contains spaces, quotes, or equal signs, it will be quoted.
+ *
+ * @param value The string value to stringify.
+ * @returns The stringified string value.
+ */
+export function stringifyEnvVariableStringValue(value) {
+    return /[\s"'=]/.test(value) ? JSON.stringify(value) : value;
+}
+/**
+ * Stringify a number or bigint environment variable value.
+ *
+ * @param value The number or bigint value to stringify.
+ * @returns The stringified number or bigint value.
+ */
+export function stringifyEnvVariableNumberValue(value) {
+    return `${value}`;
+}
+/**
+ * Stringify a boolean environment variable value according to the specified
+ * flavor.
+ *
+ * @param value The boolean value to stringify.
+ * @param flavor The flavor to use for stringifying the boolean value.
+ * @returns The stringified boolean value.
+ */
+export function stringifyEnvVariableBoolValue(value, flavor) {
+    switch (flavor) {
+        case "1/0":
+            return value ? "1" : "0";
+        case "true/false":
+            return value ? "true" : "false";
+        case "yes/no":
+            return value ? "yes" : "no";
+        case "on/off":
+            return value ? "on" : "off";
+    }
+}
+const STRINGIFY_ENV_VARIABLE_VALUE_DEFAULT_OPTIONS = {
+    boolFlavor: "1/0",
+};
+/**
+ * Stringify an environment variable value.
+ *
+ * @param value The environment variable value.
+ * @param options Options for stringifying the value.
+ * @returns The stringified environment variable value.
+ */
+export function stringifyEnvVariableValue(value, options) {
+    const effectiveOptions = defaults(options, STRINGIFY_ENV_VARIABLE_VALUE_DEFAULT_OPTIONS);
+    switch (typeof value) {
+        case "string":
+            return stringifyEnvVariableStringValue(value);
+        case "number":
+        case "bigint":
+            return stringifyEnvVariableNumberValue(value);
+        case "boolean":
+            return stringifyEnvVariableBoolValue(value, effectiveOptions.boolFlavor);
+        case "object":
+            if (value === null) {
+                return "";
+            }
+        // else, fall through to throw
+        default:
+            throw new UnsupportedError(`value type "${typeof value}"`);
+    }
+}
+const STRINGIFY_ENV_VARIABLE_DEFAULT_OPTIONS = {
+    ...STRINGIFY_ENV_VARIABLE_VALUE_DEFAULT_OPTIONS,
+};
+/**
+ * Stringify an environment variable assignment (e.g., `KEY=value`)
+ *
+ * @param name The environment variable name.
+ * @param value The environment variable value.
+ * @param options Options for stringifying the value.
+ * @returns The stringified environment variable assignment.
+ */
+export function stringifyEnvVariable(name, value, options) {
+    const effectiveOptions = defaults(options, STRINGIFY_ENV_VARIABLE_DEFAULT_OPTIONS);
+    return `${name}=${stringifyEnvVariableValue(value, effectiveOptions)}`;
+}
+//# sourceMappingURL=stringify-env-variable.js.map

package/dist/shell/process/stringify-env-variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify-env-variable.js","sourceRoot":"","sources":["../../../src/shell/process/stringify-env-variable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI1D;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAAa;IAC5D,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC9C,KAAsB;IAEtB,OAAO,GAAG,KAAK,EAAE,CAAC;AACnB,CAAC;AAQD;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC5C,KAAc,EACd,MAAkC;IAElC,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,KAAK;YACT,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAE1B,KAAK,YAAY;YAChB,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAEjC,KAAK,QAAQ;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAE7B,KAAK,QAAQ;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9B,CAAC;AACF,CAAC;AAOD,MAAM,4CAA4C,GACjD;IACC,UAAU,EAAE,KAAK;CACjB,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACxC,KAAuB,EACvB,OAA0C;IAE1C,MAAM,gBAAgB,GAAG,QAAQ,CAChC,OAAO,EACP,4CAA4C,CAC5C,CAAC;IAEF,QAAQ,OAAO,KAAK,EAAE,CAAC;QACtB,KAAK,QAAQ;YACZ,OAAO,+BAA+B,CAAC,KAAK,CAAC,CAAC;QAE/C,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACZ,OAAO,+BAA+B,CAAC,KAAK,CAAC,CAAC;QAE/C,KAAK,SAAS;YACb,OAAO,6BAA6B,CAAC,KAAK,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAE1E,KAAK,QAAQ;YACZ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,EAAE,CAAC;YACX,CAAC;QACF,8BAA8B;QAE9B;YACC,MAAM,IAAI,gBAAgB,CAAC,eAAe,OAAO,KAAK,GAAG,CAAC,CAAC;IAC7D,CAAC;AACF,CAAC;AAID,MAAM,sCAAsC,GAC3C;IACC,GAAG,4CAA4C;CAC/C,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CACnC,IAAY,EACZ,KAAuB,EACvB,OAAqC;IAErC,MAAM,gBAAgB,GAAG,QAAQ,CAChC,OAAO,EACP,sCAAsC,CACtC,CAAC;IAEF,OAAO,GAAG,IAAI,IAAI,yBAAyB,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/dist/shell/process/types.d.ts

@@ -0,0 +1,7 @@
+export type EnvVariableValue = string | number | bigint | boolean | null;
+export type EnvVariable = {
+    name: string;
+    value: EnvVariableValue;
+};
+export type EnvVariables = Record<string, EnvVariableValue>;
+//# sourceMappingURL=types.d.ts.map

package/dist/shell/process/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shell/process/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEzE,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/shell/process/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shell/process/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shell/process/types.ts"],"names":[],"mappings":""}

package/dist/shell/shell/escape-posix-sh-command-arg.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Escape a string to be safely used as a shell argument in POSIX-compliant
+ * shells
+ *
+ * It adds single quotes around a string and quotes/escapes any existing single
+ * quotes.
+ *
+ * Example:
+ *
+ * ```ts
+ * const unsafe = "It's a test";
+ * const safe = escapeShellArgPosix(unsafe);
+ * console.log(safe); // 'It'\''s a test'
+ * ```
+ *
+ * @param expr The string to escape
+ * @returns The escaped string
+ */
+export declare function escapePosixShCommandArg(expr: string): string;
+//# sourceMappingURL=escape-posix-sh-command-arg.d.ts.map

package/dist/shell/shell/escape-posix-sh-command-arg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-posix-sh-command-arg.d.ts","sourceRoot":"","sources":["../../../src/shell/shell/escape-posix-sh-command-arg.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5D"}

package/dist/shell/shell/escape-posix-sh-command-arg.js

@@ -0,0 +1,26 @@
+import { escapePosixShSqe } from "./escape-posix-sh-sqe.js";
+/**
+ * Escape a string to be safely used as a shell argument in POSIX-compliant
+ * shells
+ *
+ * It adds single quotes around a string and quotes/escapes any existing single
+ * quotes.
+ *
+ * Example:
+ *
+ * ```ts
+ * const unsafe = "It's a test";
+ * const safe = escapeShellArgPosix(unsafe);
+ * console.log(safe); // 'It'\''s a test'
+ * ```
+ *
+ * @param expr The string to escape
+ * @returns The escaped string
+ */
+export function escapePosixShCommandArg(expr) {
+    if (expr === "") {
+        return "''";
+    }
+    return `'${escapePosixShSqe(expr)}'`;
+}
+//# sourceMappingURL=escape-posix-sh-command-arg.js.map

package/dist/shell/shell/escape-posix-sh-command-arg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-posix-sh-command-arg.js","sourceRoot":"","sources":["../../../src/shell/shell/escape-posix-sh-command-arg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IACnD,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;AACtC,CAAC"}

package/dist/shell/shell/escape-posix-sh-command.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Escapes any characters in a string that might be used to trick a
+ * POSIX-compliant shell command into executing arbitrary commands.
+ *
+ * It escapes the following characters by adding a backslash before them:
+ * &#;`|*?~<>^()[]{}$, \n and \xFF.
+ *
+ * The characters ' and " are escaped only if they are not paired.
+ *
+ * Based on PHP escapeshellcmd:
+ * https://www.php.net/manual/en/function.escapeshellcmd.php
+ *
+ * Source code:
+ * https://github.com/php/php-src/blob/d85662d6cc2c6d5f69403f6fb2001ff78e1bd174/ext/standard/exec.c#L270
+ *
+ * @param cmd The command to escape @returns The escaped command
+ */
+export declare function escapePosixShCommand(cmd: string): string;
+//# sourceMappingURL=escape-posix-sh-command.d.ts.map

package/dist/shell/shell/escape-posix-sh-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-posix-sh-command.d.ts","sourceRoot":"","sources":["../../../src/shell/shell/escape-posix-sh-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoCxD"}

package/dist/shell/shell/escape-posix-sh-command.js

@@ -0,0 +1,55 @@
+/**
+ * Escapes any characters in a string that might be used to trick a
+ * POSIX-compliant shell command into executing arbitrary commands.
+ *
+ * It escapes the following characters by adding a backslash before them:
+ * &#;`|*?~<>^()[]{}$, \n and \xFF.
+ *
+ * The characters ' and " are escaped only if they are not paired.
+ *
+ * Based on PHP escapeshellcmd:
+ * https://www.php.net/manual/en/function.escapeshellcmd.php
+ *
+ * Source code:
+ * https://github.com/php/php-src/blob/d85662d6cc2c6d5f69403f6fb2001ff78e1bd174/ext/standard/exec.c#L270
+ *
+ * @param cmd The command to escape @returns The escaped command
+ */
+export function escapePosixShCommand(cmd) {
+    // Escape any of the special characters with a backslash
+    cmd = cmd.replace(/([&#;`|*?~<>^()[\]{}$\\\n\xFF])/g, "\\$1");
+    // Escape unpaired quotes by preceding them with a backslash
+    let result = "";
+    let lastMatchingQuoteIndex = -1;
+    for (let i = 0; i < cmd.length; i++) {
+        const c = cmd[i];
+        if (c === "'" || c === '"') {
+            if (lastMatchingQuoteIndex === -1) {
+                lastMatchingQuoteIndex = cmd.indexOf(c, i + 1);
+                if (lastMatchingQuoteIndex === -1) {
+                    // No matching quote found, escape this one
+                    result += `\\${c}`;
+                }
+                else {
+                    result += c;
+                }
+            }
+            else {
+                if (cmd[lastMatchingQuoteIndex] === c) {
+                    // Found the matching quote for the last opened quote
+                    lastMatchingQuoteIndex = -1;
+                    result += c;
+                }
+                else {
+                    // The quote is not matching the last opened quote, escape it
+                    result += `\\${c}`;
+                }
+            }
+        }
+        else {
+            result += c;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=escape-posix-sh-command.js.map

package/dist/shell/shell/escape-posix-sh-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-posix-sh-command.js","sourceRoot":"","sources":["../../../src/shell/shell/escape-posix-sh-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC/C,wDAAwD;IACxD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kCAAkC,EAAE,MAAM,CAAC,CAAC;IAE9D,4DAA4D;IAC5D,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,sBAAsB,GAAG,CAAC,CAAC,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAEjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,sBAAsB,KAAK,CAAC,CAAC,EAAE,CAAC;gBACnC,sBAAsB,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/C,IAAI,sBAAsB,KAAK,CAAC,CAAC,EAAE,CAAC;oBACnC,2CAA2C;oBAC3C,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACP,MAAM,IAAI,CAAC,CAAC;gBACb,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,IAAI,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvC,qDAAqD;oBACrD,sBAAsB,GAAG,CAAC,CAAC,CAAC;oBAC5B,MAAM,IAAI,CAAC,CAAC;gBACb,CAAC;qBAAM,CAAC;oBACP,6DAA6D;oBAC7D,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;gBACpB,CAAC;YACF,CAAC;QACF,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,CAAC,CAAC;QACb,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/shell/shell/escape-posix-sh-sqe.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Escape a string to be safely used in a single-quoted shell command.
+ *
+ * Example:
+ *
+ * ```ts
+ * const unsafe = "It's a test";
+ * const safe = escapePosixShSqe(unsafe);
+ * console.log(safe); // It'\''s a test
+ * ```
+ */
+export declare function escapePosixShSqe(expr: string): string;
+//# sourceMappingURL=escape-posix-sh-sqe.d.ts.map

package/dist/shell/shell/escape-posix-sh-sqe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-posix-sh-sqe.d.ts","sourceRoot":"","sources":["../../../src/shell/shell/escape-posix-sh-sqe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/shell/shell/escape-posix-sh-sqe.js

@@ -0,0 +1,15 @@
+/**
+ * Escape a string to be safely used in a single-quoted shell command.
+ *
+ * Example:
+ *
+ * ```ts
+ * const unsafe = "It's a test";
+ * const safe = escapePosixShSqe(unsafe);
+ * console.log(safe); // It'\''s a test
+ * ```
+ */
+export function escapePosixShSqe(expr) {
+    return expr.replace(/'/g, "'\\''");
+}
+//# sourceMappingURL=escape-posix-sh-sqe.js.map

package/dist/shell/shell/escape-posix-sh-sqe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-posix-sh-sqe.js","sourceRoot":"","sources":["../../../src/shell/shell/escape-posix-sh-sqe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/shell/shell/escape-win32-cmd-command-arg.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Escape a string to be safely used as a shell argument in Windows cmd.exe
+ *
+ * It adds double quotes around a string and escapes any existing problematic
+ * characters (such as %, !, and ") by replacing them with spaces. Backslashes
+ * are escaped by doubling them.
+ *
+ * Example:
+ *
+ * ```ts
+ * const unsafe = 'A "complex" %string% with !special! chars \\';
+ * const safe = escapeShellArgWindows(unsafe);
+ * console.log(safe); // "A  complex  string  with  special  chars \\"
+ * ```
+ *
+ * @param expr The string to escape
+ * @returns The escaped string
+ */
+export declare function escapeWin32CmdCommandArg(expr: string): string;
+//# sourceMappingURL=escape-win32-cmd-command-arg.d.ts.map

package/dist/shell/shell/escape-win32-cmd-command-arg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-win32-cmd-command-arg.d.ts","sourceRoot":"","sources":["../../../src/shell/shell/escape-win32-cmd-command-arg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY7D"}

package/dist/shell/shell/escape-win32-cmd-command-arg.js

@@ -0,0 +1,29 @@
+/**
+ * Escape a string to be safely used as a shell argument in Windows cmd.exe
+ *
+ * It adds double quotes around a string and escapes any existing problematic
+ * characters (such as %, !, and ") by replacing them with spaces. Backslashes
+ * are escaped by doubling them.
+ *
+ * Example:
+ *
+ * ```ts
+ * const unsafe = 'A "complex" %string% with !special! chars \\';
+ * const safe = escapeShellArgWindows(unsafe);
+ * console.log(safe); // "A  complex  string  with  special  chars \\"
+ * ```
+ *
+ * @param expr The string to escape
+ * @returns The escaped string
+ */
+export function escapeWin32CmdCommandArg(expr) {
+    if (expr === "") {
+        return '""';
+    }
+    // Replace problematic characters with spaces
+    expr = expr.replace(/[%!"]/g, " ");
+    // Escape backslashes by double them
+    expr = expr.replace(/\\/g, "\\\\");
+    return `"${expr}"`;
+}
+//# sourceMappingURL=escape-win32-cmd-command-arg.js.map

package/dist/shell/shell/escape-win32-cmd-command-arg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-win32-cmd-command-arg.js","sourceRoot":"","sources":["../../../src/shell/shell/escape-win32-cmd-command-arg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACpD,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,6CAA6C;IAC7C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAEnC,oCAAoC;IACpC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEnC,OAAO,IAAI,IAAI,GAAG,CAAC;AACpB,CAAC"}

package/dist/shell/shell/escape-win32-cmd-command.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Escape any characters in a string that might be used to trick a Windows
+ * cmd.exe command into executing arbitrary commands.
+ *
+ * It escapes the following characters by adding a caret (^) before them:
+ * '"%!&#;`|*?~<>^()[]{}$, \n and \xFF.
+ *
+ * Based on PHP escapeshellcmd:
+ * https://www.php.net/manual/en/function.escapeshellcmd.php
+ *
+ * Source code:
+ * https://github.com/php/php-src/blob/d85662d6cc2c6d5f69403f6fb2001ff78e1bd174/ext/standard/exec.c#L270
+ *
+ * @param cmd The command to escape
+ * @returns The escaped command
+ */
+export declare function escapeWin32CmdCommand(cmd: string): string;
+//# sourceMappingURL=escape-win32-cmd-command.d.ts.map

package/dist/shell/shell/escape-win32-cmd-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-win32-cmd-command.d.ts","sourceRoot":"","sources":["../../../src/shell/shell/escape-win32-cmd-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/shell/shell/escape-win32-cmd-command.js

@@ -0,0 +1,20 @@
+/**
+ * Escape any characters in a string that might be used to trick a Windows
+ * cmd.exe command into executing arbitrary commands.
+ *
+ * It escapes the following characters by adding a caret (^) before them:
+ * '"%!&#;`|*?~<>^()[]{}$, \n and \xFF.
+ *
+ * Based on PHP escapeshellcmd:
+ * https://www.php.net/manual/en/function.escapeshellcmd.php
+ *
+ * Source code:
+ * https://github.com/php/php-src/blob/d85662d6cc2c6d5f69403f6fb2001ff78e1bd174/ext/standard/exec.c#L270
+ *
+ * @param cmd The command to escape
+ * @returns The escaped command
+ */
+export function escapeWin32CmdCommand(cmd) {
+    return cmd.replace(/(['"%!&#;`|*?~<>^()[\]{}$\\\n\xFF])/g, "^$1");
+}
+//# sourceMappingURL=escape-win32-cmd-command.js.map

package/dist/shell/shell/escape-win32-cmd-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-win32-cmd-command.js","sourceRoot":"","sources":["../../../src/shell/shell/escape-win32-cmd-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAChD,OAAO,GAAG,CAAC,OAAO,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/string/apply-text-edits.d.ts

@@ -0,0 +1,23 @@
+export type TextEdit = {
+    /** The offset in the source string where the edit should be applied. */
+    offset: number;
+    /** The length of the text to replace at the offset. */
+    length: number;
+    /**
+     * The content to insert at the offset. If `length` is greater than 0, this
+     * content will replace the text at the offset.
+     */
+    content: string;
+};
+/**
+ * Applies a set of {@link TextEdit}s to `source`.
+ *
+ * Edits must be non-overlapping. Applies in descending offset order to avoid
+ * invalidating subsequent offsets.
+ *
+ * @param source The source string to apply edits to
+ * @param edits The edits to apply
+ * @returns The modified string after applying the edits
+ */
+export declare function applyTextEdits(source: string, edits: TextEdit[]): string;
+//# sourceMappingURL=apply-text-edits.d.ts.map

package/dist/string/apply-text-edits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-text-edits.d.ts","sourceRoot":"","sources":["../../src/string/apply-text-edits.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACtB,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAWxE"}

package/dist/string/apply-text-edits.js

@@ -0,0 +1,22 @@
+/**
+ * Applies a set of {@link TextEdit}s to `source`.
+ *
+ * Edits must be non-overlapping. Applies in descending offset order to avoid
+ * invalidating subsequent offsets.
+ *
+ * @param source The source string to apply edits to
+ * @param edits The edits to apply
+ * @returns The modified string after applying the edits
+ */
+export function applyTextEdits(source, edits) {
+    const sorted = edits.slice().sort((a, b) => b.offset - a.offset);
+    let result = source;
+    for (const edit of sorted) {
+        result =
+            result.slice(0, edit.offset) +
+                edit.content +
+                result.slice(edit.offset + edit.length);
+    }
+    return result;
+}
+//# sourceMappingURL=apply-text-edits.js.map

package/dist/string/apply-text-edits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-text-edits.js","sourceRoot":"","sources":["../../src/string/apply-text-edits.ts"],"names":[],"mappings":"AAcA;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,KAAiB;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAEjE,IAAI,MAAM,GAAG,MAAM,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM;YACL,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC;gBAC5B,IAAI,CAAC,OAAO;gBACZ,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/string/ascii/is-ascii-alpha-numeric.d.ts

@@ -0,0 +1,3 @@
+/** Equivalent to C's `isalnum` — whether `code` is an ASCII letter or digit. */
+export declare function isAsciiAlphaNumeric(code: number): boolean;
+//# sourceMappingURL=is-ascii-alpha-numeric.d.ts.map

package/dist/string/ascii/is-ascii-alpha-numeric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-alpha-numeric.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-alpha-numeric.ts"],"names":[],"mappings":"AAGA,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/string/ascii/is-ascii-alpha-numeric.js

@@ -0,0 +1,7 @@
+import { isAsciiAlpha } from "./is-ascii-alpha.js";
+import { isAsciiDigit } from "./is-ascii-digit.js";
+/** Equivalent to C's `isalnum` — whether `code` is an ASCII letter or digit. */
+export function isAsciiAlphaNumeric(code) {
+    return isAsciiAlpha(code) || isAsciiDigit(code);
+}
+//# sourceMappingURL=is-ascii-alpha-numeric.js.map

package/dist/string/ascii/is-ascii-alpha-numeric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-alpha-numeric.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-alpha-numeric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/string/ascii/is-ascii-alpha.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Equivalent to C's `isalpha` — whether `code` is an ASCII letter (`A`-`Z` or
+ * `a`-`z`).
+ */
+export declare function isAsciiAlpha(code: number): boolean;
+//# sourceMappingURL=is-ascii-alpha.d.ts.map

package/dist/string/ascii/is-ascii-alpha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-alpha.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-alpha.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/string/ascii/is-ascii-alpha.js

@@ -0,0 +1,10 @@
+import { isAsciiLowerAlpha } from "./is-ascii-lower-alpha.js";
+import { isAsciiUpperAlpha } from "./is-ascii-upper-alpha.js";
+/**
+ * Equivalent to C's `isalpha` — whether `code` is an ASCII letter (`A`-`Z` or
+ * `a`-`z`).
+ */
+export function isAsciiAlpha(code) {
+    return isAsciiUpperAlpha(code) || isAsciiLowerAlpha(code);
+}
+//# sourceMappingURL=is-ascii-alpha.js.map

package/dist/string/ascii/is-ascii-alpha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-alpha.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-alpha.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC"}

package/dist/string/ascii/is-ascii-base64-char.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Whether `code` is a character of the base64 or base64url alphabet (RFC 4648
+ * §4/§5: `A`-`Z`, `a`-`z`, `0`-`9`, plus either `+`/`/` (base64) or `-`/`_`
+ * (base64url) — never padding (`=`)).
+ *
+ * Accepts both alphabets' extra characters at once: the two alphabets only
+ * differ in those two symbols, so a caller that needs to tell them apart (e.g.
+ * to detect which one a string uses) should test for `+`/`/` and `-`/`_`
+ * directly rather than relying on this predicate alone.
+ */
+export declare function isAsciiBase64Char(code: number): boolean;
+//# sourceMappingURL=is-ascii-base64-char.d.ts.map

package/dist/string/ascii/is-ascii-base64-char.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-base64-char.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-base64-char.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQvD"}

package/dist/string/ascii/is-ascii-base64-char.js

@@ -0,0 +1,20 @@
+import { HYPHEN_MINUS, PLUS, SLASH, UNDERSCORE, } from "../../constants/ascii.js";
+import { isAsciiAlphaNumeric } from "./is-ascii-alpha-numeric.js";
+/**
+ * Whether `code` is a character of the base64 or base64url alphabet (RFC 4648
+ * §4/§5: `A`-`Z`, `a`-`z`, `0`-`9`, plus either `+`/`/` (base64) or `-`/`_`
+ * (base64url) — never padding (`=`)).
+ *
+ * Accepts both alphabets' extra characters at once: the two alphabets only
+ * differ in those two symbols, so a caller that needs to tell them apart (e.g.
+ * to detect which one a string uses) should test for `+`/`/` and `-`/`_`
+ * directly rather than relying on this predicate alone.
+ */
+export function isAsciiBase64Char(code) {
+    return (isAsciiAlphaNumeric(code) ||
+        code === PLUS ||
+        code === SLASH ||
+        code === HYPHEN_MINUS ||
+        code === UNDERSCORE);
+}
+//# sourceMappingURL=is-ascii-base64-char.js.map

package/dist/string/ascii/is-ascii-base64-char.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-base64-char.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-base64-char.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,UAAU,GACV,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC7C,OAAO,CACN,mBAAmB,CAAC,IAAI,CAAC;QACzB,IAAI,KAAK,IAAI;QACb,IAAI,KAAK,KAAK;QACd,IAAI,KAAK,YAAY;QACrB,IAAI,KAAK,UAAU,CACnB,CAAC;AACH,CAAC"}

package/dist/string/ascii/is-ascii-digit.d.ts

@@ -0,0 +1,3 @@
+/** Equivalent to C's `isdigit` — whether `code` is an ASCII digit (`0`-`9`). */
+export declare function isAsciiDigit(code: number): boolean;
+//# sourceMappingURL=is-ascii-digit.d.ts.map

package/dist/string/ascii/is-ascii-digit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-digit.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-digit.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/string/ascii/is-ascii-digit.js

@@ -0,0 +1,6 @@
+import { DIGIT_NINE, DIGIT_ZERO } from "../../constants/ascii.js";
+/** Equivalent to C's `isdigit` — whether `code` is an ASCII digit (`0`-`9`). */
+export function isAsciiDigit(code) {
+    return code >= DIGIT_ZERO && code <= DIGIT_NINE;
+}
+//# sourceMappingURL=is-ascii-digit.js.map

package/dist/string/ascii/is-ascii-digit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-digit.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-digit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAElE,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,OAAO,IAAI,IAAI,UAAU,IAAI,IAAI,IAAI,UAAU,CAAC;AACjD,CAAC"}

package/dist/string/ascii/is-ascii-hex-digit.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Equivalent to C's `isxdigit` — whether `code` is an ASCII hexadecimal digit
+ * (`0`-`9`, `A`-`F`, `a`-`f`).
+ */
+export declare function isAsciiHexDigit(code: number): boolean;
+//# sourceMappingURL=is-ascii-hex-digit.d.ts.map

package/dist/string/ascii/is-ascii-hex-digit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-hex-digit.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-hex-digit.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrD"}

package/dist/string/ascii/is-ascii-hex-digit.js

@@ -0,0 +1,11 @@
+import { DIGIT_NINE, DIGIT_ZERO, LOWERCASE_A, LOWERCASE_F, UPPERCASE_A, UPPERCASE_F, } from "../../constants/ascii.js";
+/**
+ * Equivalent to C's `isxdigit` — whether `code` is an ASCII hexadecimal digit
+ * (`0`-`9`, `A`-`F`, `a`-`f`).
+ */
+export function isAsciiHexDigit(code) {
+    return ((code >= DIGIT_ZERO && code <= DIGIT_NINE) ||
+        (code >= UPPERCASE_A && code <= UPPERCASE_F) ||
+        (code >= LOWERCASE_A && code <= LOWERCASE_F));
+}
+//# sourceMappingURL=is-ascii-hex-digit.js.map

package/dist/string/ascii/is-ascii-hex-digit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-hex-digit.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-hex-digit.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,GACX,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,OAAO,CACN,CAAC,IAAI,IAAI,UAAU,IAAI,IAAI,IAAI,UAAU,CAAC;QAC1C,CAAC,IAAI,IAAI,WAAW,IAAI,IAAI,IAAI,WAAW,CAAC;QAC5C,CAAC,IAAI,IAAI,WAAW,IAAI,IAAI,IAAI,WAAW,CAAC,CAC5C,CAAC;AACH,CAAC"}

package/dist/string/ascii/is-ascii-lower-alpha.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Equivalent to C's `islower` — whether `code` is an ASCII lowercase letter
+ * (`a`-`z`).
+ */
+export declare function isAsciiLowerAlpha(code: number): boolean;
+//# sourceMappingURL=is-ascii-lower-alpha.d.ts.map

package/dist/string/ascii/is-ascii-lower-alpha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-lower-alpha.d.ts","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-lower-alpha.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/string/ascii/is-ascii-lower-alpha.js

@@ -0,0 +1,9 @@
+import { LOWERCASE_A, LOWERCASE_Z } from "../../constants/ascii.js";
+/**
+ * Equivalent to C's `islower` — whether `code` is an ASCII lowercase letter
+ * (`a`-`z`).
+ */
+export function isAsciiLowerAlpha(code) {
+    return code >= LOWERCASE_A && code <= LOWERCASE_Z;
+}
+//# sourceMappingURL=is-ascii-lower-alpha.js.map

package/dist/string/ascii/is-ascii-lower-alpha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-ascii-lower-alpha.js","sourceRoot":"","sources":["../../../src/string/ascii/is-ascii-lower-alpha.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC7C,OAAO,IAAI,IAAI,WAAW,IAAI,IAAI,IAAI,WAAW,CAAC;AACnD,CAAC"}