@fnndsc/brasa 0.48.1 → 0.49.0

package/dist/lib/quoting.js

@@ -0,0 +1,70 @@
+/**
+ * @file Quoting: when a backslash escapes the character after it.
+ *
+ * POSIX's rule, read by every parser that splits a line (words, `;`, `|`,
+ * `>`, `$( … )`, completion), so no split disagrees with another:
+ *
+ * - inside single quotes every character is literal, a backslash included;
+ * - inside double quotes a backslash escapes only `$`, `` ` ``, `"`, `\` and
+ *   newline, and before anything else it stays as written;
+ * - outside quotes a backslash escapes the next character, whatever it is.
+ *
+ * So `printf '%s\n' a` hands printf its `\n`, `grep '\.mgz$'` its `\.`, and
+ * `"a\"b"` is still one word holding a quote (#1258).
+ *
+ * @module
+ */
+/** What a backslash escapes inside double quotes; before anything else it stays. */
+const DOUBLE_QUOTE_ESCAPES = new Set(['$', '`', '"', '\\', '\n']);
+/**
+ * Whether a backslash, where it stands, escapes the character after it.
+ *
+ * @param inSingle - Whether it stands inside single quotes.
+ * @param inDouble - Whether it stands inside double quotes.
+ * @param next - The character after it, or undefined at the line's end.
+ * @returns True when the two are one escaped character; false when the
+ *   backslash is a character of its own.
+ */
+export function backslash_escapesNext(inSingle, inDouble, next) {
+    if (inSingle)
+        return false;
+    if (!inDouble)
+        return true;
+    return next !== undefined && DOUBLE_QUOTE_ESCAPES.has(next);
+}
+/**
+ * Finds a quote a line opens and never closes, reading quotes by the rule
+ * above, so a refusal names exactly what the word parser would have run
+ * past (#1260).
+ *
+ * @param line - The line.
+ * @returns The open quote, or null when every quote closes.
+ */
+export function quoteOpen_find(line) {
+    let inSingle = false;
+    let inDouble = false;
+    let openedAt = 0;
+    for (let at = 0; at < line.length; at++) {
+        const char = line[at];
+        if (char === '\\' && backslash_escapesNext(inSingle, inDouble, line[at + 1])) {
+            at++;
+            continue;
+        }
+        if (char === "'" && !inDouble) {
+            inSingle = !inSingle;
+            if (inSingle)
+                openedAt = at + 1;
+        }
+        else if (char === '"' && !inSingle) {
+            inDouble = !inDouble;
+            if (inDouble)
+                openedAt = at + 1;
+        }
+    }
+    if (inSingle)
+        return { quote: "'", column: openedAt };
+    if (inDouble)
+        return { quote: '"', column: openedAt };
+    return null;
+}
+//# sourceMappingURL=quoting.js.map

package/dist/lib/quoting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quoting.js","sourceRoot":"","sources":["../../src/lib/quoting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,oFAAoF;AACpF,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEvF;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAiB,EAAE,QAAiB,EAAE,IAAwB;IAClG,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,IAAI,KAAK,SAAS,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAQD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,QAAQ,GAAY,KAAK,CAAC;IAC9B,IAAI,QAAQ,GAAY,KAAK,CAAC;IAC9B,IAAI,QAAQ,GAAW,CAAC,CAAC;IACzB,KAAK,IAAI,EAAE,GAAW,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;QAChD,MAAM,IAAI,GAAW,IAAI,CAAC,EAAE,CAAW,CAAC;QACxC,IAAI,IAAI,KAAK,IAAI,IAAI,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAAC,EAAE,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QACjG,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,IAAI,QAAQ;gBAAE,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,IAAI,QAAQ;gBAAE,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,IAAI,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACtD,IAAI,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACtD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/semicolonParser.d.ts

@@ -1,10 +1,3 @@
-/**
- * @file Semicolon command parser
- *
- * Parses semicolon-separated commands while respecting quotes.
- *
- * @module
- */
 /**
  * Parses a command line for semicolon separators and returns individual commands.
  * Respects quoted strings - semicolons inside quotes are not treated as separators.

package/dist/lib/semicolonParser.js

@@ -5,6 +5,7 @@
  *
  * @module
  */
+import { backslash_escapesNext } from './quoting.js';
 /**
  * Parses a command line for semicolon separators and returns individual commands.
  * Respects quoted strings - semicolons inside quotes are not treated as separators.
@@ -28,14 +29,15 @@ export function semicolons_parse(line) {
     let escapeNext = false;
     for (let i = 0; i < line.length; i++) {
         const char = line[i];
-        // A backslash escapes the next character, inside quotes or out, as the
-        // word tokenizer and the pipe and redirect parsers read it: an escaped
-        // quote neither opens nor closes a quote, so `'it\'s; x'` is one command.
+        // A backslash escapes as POSIX quoting says (lib/quoting.ts), the rule
+        // the word tokenizer and the pipe and redirect parsers read: an escaped
+        // quote neither opens nor closes a quote, so `"it\"s; x"` is one command,
+        // and in single quotes a backslash is a character, so `'a\'; b` is two.
         if (escapeNext) {
             currentCommand += char;
             escapeNext = false;
         }
-        else if (char === '\\') {
+        else if (char === '\\' && backslash_escapesNext(inSingleQuote, inDoubleQuote, line[i + 1])) {
             currentCommand += char;
             escapeNext = true;
         }

package/dist/lib/semicolonParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"semicolonParser.js","sourceRoot":"","sources":["../../src/lib/semicolonParser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,cAAc,GAAW,EAAE,CAAC;IAChC,IAAI,aAAa,GAAY,KAAK,CAAC;IACnC,IAAI,aAAa,GAAY,KAAK,CAAC;IACnC,IAAI,UAAU,GAAY,KAAK,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;QAE7B,uEAAuE;QACvE,uEAAuE;QACvE,0EAA0E;QAC1E,IAAI,UAAU,EAAE,CAAC;YACf,cAAc,IAAI,IAAI,CAAC;YACvB,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;aAAM,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACzB,cAAc,IAAI,IAAI,CAAC;YACvB,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,aAAa,GAAG,CAAC,aAAa,CAAC;YAC/B,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,aAAa,GAAG,CAAC,aAAa,CAAC;YAC/B,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAW,cAAc,CAAC,IAAI,EAAE,CAAC;YAC9C,IAAI,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,cAAc,GAAG,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,MAAM,OAAO,GAAW,cAAc,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,OAAO;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEpC,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"semicolonParser.js","sourceRoot":"","sources":["../../src/lib/semicolonParser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,cAAc,GAAW,EAAE,CAAC;IAChC,IAAI,aAAa,GAAY,KAAK,CAAC;IACnC,IAAI,aAAa,GAAY,KAAK,CAAC;IACnC,IAAI,UAAU,GAAY,KAAK,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;QAE7B,uEAAuE;QACvE,wEAAwE;QACxE,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,UAAU,EAAE,CAAC;YACf,cAAc,IAAI,IAAI,CAAC;YACvB,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;aAAM,IAAI,IAAI,KAAK,IAAI,IAAI,qBAAqB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7F,cAAc,IAAI,IAAI,CAAC;YACvB,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,aAAa,GAAG,CAAC,aAAa,CAAC;YAC/B,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,aAAa,GAAG,CAAC,aAAa,CAAC;YAC/B,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAW,cAAc,CAAC,IAAI,EAAE,CAAC;YAC9C,IAAI,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,cAAc,GAAG,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,MAAM,OAAO,GAAW,cAAc,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,OAAO;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEpC,OAAO,QAAQ,CAAC;AAClB,CAAC"}