effect 4.0.6 → 4.1.0

package/dist/process/ChildProcess.js

@@ -14,7 +14,9 @@ import * as Context from "../Context.js";
 import * as Effectable from "../Effectable.js";
 import { dual } from "../Function.js";
 import * as Predicate from "../Predicate.js";
+import * as Result from "../Result.js";
 import { ChildProcessSpawner } from "./ChildProcessSpawner.js";
+import * as CommandLine from "./CommandLine.js";
 const TypeId = "~effect/process/ChildProcess";
 // =============================================================================
 // Constructors
@@ -74,16 +76,33 @@ const makePipedCommand = (left, right, options = {}) => Object.assign(Object.cre
  * 2. Options + template literal: `make({ cwd: "/app" })\`npm run build\``
  * 3. Array form: `make("npm", ["run", "build"], options?)`
  *
- * Template literals are not parsed until execution time, allowing parsing
- * errors to flow through Effect's error channel.
+ * Templates are split with `CommandLine.template`: quotes group words, each
+ * `${}` value is one literal argument, and an argument that contains a
+ * `Redacted` value stays `Redacted`. Arguments in the array form can be
+ * `Redacted` too.
+ *
+ * With the `shell` option, the template text is the shell script and is kept
+ * as written.
+ *
+ * **Gotchas**
+ *
+ * - A template is parsed when `make` is called. Shell syntax such as `|`,
+ *   `$HOME`, `*` or `~` throws a `CommandLine.CommandLineError`: quote it, or
+ *   pass the value with `${}`.
+ * - A template with the `shell` option cannot contain `${}` values, because
+ *   their quoting depends on the shell. Build the script with
+ *   `CommandLine.quote` and pass it as a string.
+ * - The program name, the first word, cannot be `Redacted`.
+ * - A NUL character in the command, an argument or an `env` value fails with
+ *   a `BadArgument` error when the command is spawned.
  *
  * **Example** (Creating commands)
  *
  * ```ts import.meta.vitest
  * import { ChildProcess } from "effect/process"
  *
- * // Template literal form
- * const cmd1 = ChildProcess.make`echo "hello"`
+ * // Template literal form; quotes group words
+ * const cmd1 = ChildProcess.make`echo "hello world"`
  *
  * // With options
  * const cmd2 = ChildProcess.make({ cwd: "/tmp" })`ls -la`
@@ -91,7 +110,7 @@ const makePipedCommand = (left, right, options = {}) => Object.assign(Object.cre
  * // Array form
  * const cmd3 = ChildProcess.make("git", ["status"])
  *
- * const result = [cmd1.command, cmd2.options.cwd, cmd3.args[0]] // => ["echo", "/tmp", "status"]
+ * const result = [cmd1.args[0], cmd2.options.cwd, cmd3.args[0]] // => ["hello world", "/tmp", "status"]
  * ```
  *
  * @stability unstable
@@ -102,15 +121,18 @@ export const make = function make(...args) {
   // Template literal form: make`command`
   if (isTemplateString(args[0])) {
     const [templates, ...expressions] = args;
-    const tokens = parseTemplates(templates, expressions);
-    return makeStandardCommand(tokens[0] ?? "", tokens.slice(1), {});
+    const [command, cmdArgs] = parseTemplate(templates, expressions);
+    return makeStandardCommand(command, cmdArgs, {});
   }
   // Options form: make({ cwd: "/tmp" })`command`
   if (typeof args[0] === "object" && !Array.isArray(args[0]) && !isTemplateString(args[0])) {
     const options = args[0];
     return function (templates, ...expressions) {
-      const tokens = parseTemplates(templates, expressions);
-      return makeStandardCommand(tokens[0] ?? "", tokens.slice(1), options);
+      if (options.shell !== undefined && options.shell !== false) {
+        return makeStandardCommand(shellScript(templates, expressions), [], options);
+      }
+      const [command, cmdArgs] = parseTemplate(templates, expressions);
+      return makeStandardCommand(command, cmdArgs, options);
     };
   }
   // Standard form without arguments: make("command", options?)
@@ -171,7 +193,7 @@ export const pipeTo = /*#__PURE__*/dual(args => isCommand(args[0]) && isCommand(
  * ```ts import.meta.vitest
  * import { ChildProcess } from "effect/process"
  *
- * const command = ChildProcess.make`echo "foo"`
+ * const command = ChildProcess.make`echo foo`
  *
  * const prefixed = command.pipe(
  *   ChildProcess.prefix`time`
@@ -198,10 +220,10 @@ export const prefix = function prefix(...args) {
 const parsePrefixArgs = args => {
   if (isTemplateString(args[0])) {
     const [templates, ...expressions] = args;
-    const tokens = parseTemplates(templates, expressions);
+    const [command, cmdArgs] = parseTemplate(templates, expressions);
     return {
-      command: tokens[0] ?? "",
-      args: tokens.slice(1)
+      command,
+      args: cmdArgs
     };
   }
   const [command, cmdArgs = []] = args;
@@ -330,154 +352,30 @@ export const fdName = fd => `fd${fd}`;
 // =============================================================================
 // Template Parsing
 // =============================================================================
-const parseTemplates = (templates, expressions) => {
-  let tokens = [];
-  for (const [index, template] of templates.entries()) {
-    tokens = parseTemplate(templates, expressions, tokens, template, index);
+const parseTemplate = (templates, expressions) => {
+  const [program = "", ...args] = Result.getOrThrow(CommandLine.template(templates, ...expressions));
+  if (typeof program !== "string") {
+    throw new CommandLine.CommandLineError({
+      reason: "InvalidArgument",
+      message: "The program name of a command cannot be Redacted"
+    });
   }
-  return tokens;
+  return [program, args];
 };
-const parseTemplate = (templates, expressions, prevTokens, template, index) => {
-  const rawTemplate = templates.raw[index];
-  if (rawTemplate === undefined) {
-    throw new Error(`Invalid backslash sequence: ${templates.raw[index]}`);
-  }
-  const {
-    hasLeadingWhitespace,
-    hasTrailingWhitespace,
-    tokens
-  } = splitByWhitespaces(template, rawTemplate);
-  const nextTokens = concatTokens(prevTokens, tokens, hasLeadingWhitespace);
-  if (index === expressions.length) {
-    return nextTokens;
-  }
-  const expression = expressions[index];
-  const expressionTokens = Array.isArray(expression) ? expression.map(expression => parseExpression(expression)) : [parseExpression(expression)];
-  return concatTokens(nextTokens, expressionTokens, hasTrailingWhitespace);
-};
-/**
- * Convert valid expressions defined in a template string command (i.e. using
- * `${expression}` into strings.
- */
-const parseExpression = expression => {
-  const type = typeof expression;
-  if (type === "string") {
-    return expression; // Return strings directly
-  }
-  return String(expression); // Convert numbers to strings
-};
-const DELIMITERS = /*#__PURE__*/new Set([" ", "\t", "\r", "\n"]);
-/**
- * Number of characters in backslash escape sequences: \0 \xXX or \uXXXX
- * \cX is allowed in RegExps but not in strings
- * Octal sequences are not allowed in strict mode
- */
-const ESCAPE_LENGTH = {
-  x: 3,
-  u: 5
-};
-/**
- * Splits a template string by whitespace while also properly handling escape
- * sequences.
- *
- * As an example, let's review the following valid commands:
- *
- * ```ts
- * ChildProcess.exec`echo foo\n bar`
- * // We should run `["echo", "foo\n", "bar"]`
- *
- * ChildProcess.exec`echo foo
- *  bar`
- * // We should run `["echo", "foo", "bar]`
- * ```
- *
- * The problem is that when we evaluate the template string for both of the above
- * commands, we will end up with the same string "echo foo\n bar".
- *
- * What we really want is to include the escaped character in the arguments for
- * the first command, since it was written explicitly by the user.
- *
- * This is why also having access to the raw template string is useful - in a
- * template string, there are two representations of the same string:
- * 1. `template`     - The processed string (escape sequences are evaluated).
- * 2. `template.raw` - The raw string (escape sequences are literal).
- */
-const splitByWhitespaces = (template, rawTemplate) => {
-  if (rawTemplate.length === 0) {
-    return {
-      tokens: [],
-      hasLeadingWhitespace: false,
-      hasTrailingWhitespace: false
-    };
+const shellScript = (templates, expressions) => {
+  if (expressions.length > 0) {
+    throw new CommandLine.CommandLineError({
+      reason: "UnsupportedSyntax",
+      message: "A shell template cannot interpolate values; build the script with CommandLine.quote"
+    });
   }
-  const hasLeadingWhitespace = DELIMITERS.has(rawTemplate[0]);
-  const tokens = [];
-  // Given that escape sequences will have different lengths in the template
-  // versus the raw template, we must maintain two indices:
-  // - One for the index into the template string
-  // - One for the index into the raw template string
-  // We also maintain the current cursor position for where we are in the template
-  let templateCursor = 0;
-  for (let templateIndex = 0, rawIndex = 0; templateIndex < template.length; templateIndex += 1, rawIndex += 1) {
-    // Use the raw template character to check for actual whitespace
-    const rawCharacter = rawTemplate[rawIndex];
-    if (DELIMITERS.has(rawCharacter)) {
-      // Whitespace found, extract token from template if necessary
-      if (templateCursor !== templateIndex) {
-        tokens.push(template.slice(templateCursor, templateIndex));
-      }
-      // Advance the template start index to the current position
-      templateCursor = templateIndex + 1;
-    } else if (rawCharacter === "\\") {
-      // Escape sequence detected, check the next raw character
-      const nextRawCharacter = rawTemplate[rawIndex + 1];
-      if (nextRawCharacter === "\n") {
-        // Handle `\` character followed by a newline (i.e. a line continuation) by:
-        // - Reversing the template index (backslash-newline is erased in template)
-        // - Advancing the raw template index past the line continuation
-        templateIndex -= 1;
-        rawIndex += 1;
-      } else if (nextRawCharacter === "u" && rawTemplate[rawIndex + 2] === "{") {
-        // Handle variable-length unicode escape sequences (i.e. `\u{1F600}`) by:
-        // - Advancing the template index an extra code unit for astral code points
-        // - Advancing the raw template index past the unicode escape sequence
-        const end = rawTemplate.indexOf("}", rawIndex + 3);
-        if (parseInt(rawTemplate.slice(rawIndex + 3, end), 16) > 0xffff) {
-          templateIndex += 1;
-        }
-        rawIndex = end;
-      } else {
-        // Advance raw template index past fixed-length escape sequences:
-        // - \n    → 2 chars (backslash + n)
-        // - \t    → 2 chars (backslash + t)
-        // - \xHH  → 4 chars (backslash + x + H + H)
-        // - \uHHHH → 6 chars (backslash + u + H + H + H + H)
-        rawIndex += ESCAPE_LENGTH[nextRawCharacter] ?? 1;
-      }
-    }
+  const script = templates[0];
+  if (script === undefined) {
+    throw new CommandLine.CommandLineError({
+      reason: "InvalidEscape",
+      message: "Template part 0 contains an invalid escape sequence"
+    });
   }
-  // Trailing whitespace only exists if the template cursor is equivalent to the
-  // length of the template
-  const hasTrailingWhitespace = templateCursor === template.length;
-  // If we did not end with trailing whitespace, ensure the final token is added
-  if (!hasTrailingWhitespace) {
-    tokens.push(template.slice(templateCursor));
-  }
-  return {
-    tokens,
-    hasLeadingWhitespace,
-    hasTrailingWhitespace
-  };
+  return script;
 };
-/**
- * Concatenates two separate sets of string tokens together.
- *
- * If either set is empty or `isSeparated=false`, the last element of `prevTokens`
- * and the first element of `nextTokens` will be joined into a single token.
- */
-const concatTokens = (prevTokens, nextTokens, isSeparated) => isSeparated || prevTokens.length === 0 || nextTokens.length === 0
-// Keep the previous and next tokens separate from one another
-? [...prevTokens, ...nextTokens]
-// Join the last token from the previous set and the first token from the next set
-: [...prevTokens.slice(0, -1), `${prevTokens.at(-1)}${nextTokens.at(0)}`, ...nextTokens.slice(1)];
 //# sourceMappingURL=ChildProcess.js.map

package/dist/process/ChildProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChildProcess.js","names":[],"sources":["../../src/process/ChildProcess.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ChildProcess.js","names":[],"sources":["../../src/process/ChildProcess.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/process/ChildProcessSpawner.d.ts

@@ -132,6 +132,9 @@ export interface ChildProcessHandle {
      *
      * **Details**
      *
+     * Available for `"input"` and `"duplex"` file descriptors. The write side is
+     * ended when the sink completes.
+     *
      * If a file descriptor is accessed that was not configured, returns a drain
      * `Sink`.
      */
@@ -142,6 +145,8 @@ export interface ChildProcessHandle {
      *
      * **Details**
      *
+     * Available for `"output"` and `"duplex"` file descriptors.
+     *
      * If a file descriptor is accessed that was not configured, returns an empty
      * `Stream`.
      */
@@ -218,11 +223,23 @@ declare const ChildProcessSpawner_base: Context.ServiceClass<ChildProcessSpawner
     spawn(command: Command): Effect.Effect<ChildProcessHandle, PlatformError.PlatformError, Scope.Scope>;
     /**
      * Run a command and return its exit code.
+     *
+     * **Details**
+     *
+     * Piped `stdout` and `stderr` are read and discarded until the process
+     * exits. A read failure before then, such as from an output `Sink`, fails
+     * the effect.
      */
     exitCode(command: Command): Effect.Effect<ExitCode, PlatformError.PlatformError>;
     /**
      * Stream the output of a command as strings. Optionally include stderr output
      * interleaved with stdout.
+     *
+     * **Details**
+     *
+     * Without `includeStderr`, piped `stderr` is read and discarded until
+     * `stdout` ends. A read failure before then, such as from an output `Sink`,
+     * fails the result.
      */
     streamString(command: Command, options?: {
         readonly includeStderr?: boolean | undefined;
@@ -230,18 +247,36 @@ declare const ChildProcessSpawner_base: Context.ServiceClass<ChildProcessSpawner
     /**
      * Stream the output of a command as lines. Optionally include stderr output
      * interleaved with stdout.
+     *
+     * **Details**
+     *
+     * Without `includeStderr`, piped `stderr` is read and discarded until
+     * `stdout` ends. A read failure before then, such as from an output `Sink`,
+     * fails the result.
      */
     streamLines(command: Command, options?: {
         readonly includeStderr?: boolean | undefined;
     }): Stream.Stream<string, PlatformError.PlatformError>;
     /**
      * Run a command and return the lines of its output as an array of strings.
+     *
+     * **Details**
+     *
+     * Without `includeStderr`, piped `stderr` is read and discarded until
+     * `stdout` ends. A read failure before then, such as from an output `Sink`,
+     * fails the result.
      */
     lines(command: Command, options?: {
         readonly includeStderr?: boolean | undefined;
     }): Effect.Effect<Array<string>, PlatformError.PlatformError>;
     /**
      * Run a command and return its output as a string.
+     *
+     * **Details**
+     *
+     * Without `includeStderr`, piped `stderr` is read and discarded until
+     * `stdout` ends. A read failure before then, such as from an output `Sink`,
+     * fails the result.
      */
     string(command: Command, options?: {
         readonly includeStderr?: boolean | undefined;

package/dist/process/ChildProcessSpawner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChildProcessSpawner.d.ts","sourceRoot":"","sources":["../../src/process/ChildProcessSpawner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChildProcessSpawner.d.ts","sourceRoot":"","sources":["../../src/process/ChildProcessSpawner.ts"],"names":[],"mappings":"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"}

package/dist/process/ChildProcessSpawner.js

@@ -62,11 +62,14 @@ export const makeHandle = params => Object.setPrototypeOf({
  * @since 4.0.0
  */
 export const make = spawn => {
-  const streamString = (command, options) => spawn(command).pipe(Effect.map(handle => Stream.decodeText(options?.includeStderr === true ? handle.all : handle.stdout)), Stream.unwrap);
+  // The helpers own the handle, so they drain any output they do not return
+  // to keep a full pipe from blocking the child.
+  const streamString = (command, options) => spawn(command).pipe(Effect.map(handle => Stream.decodeText(options?.includeStderr === true ? handle.all : Stream.drainFork(handle.stdout, handle.stderr))), Stream.unwrap);
   const streamLines = (command, options) => Stream.splitLines(streamString(command, options));
   return ChildProcessSpawner.of({
     spawn,
-    exitCode: command => Effect.scoped(Effect.flatMap(spawn(command), handle => handle.exitCode)),
+    // Return once the process exits, even if descendants keep the pipes open.
+    exitCode: command => Effect.scoped(Effect.flatMap(spawn(command), handle => Effect.raceFirst(handle.exitCode, Effect.andThen(Stream.runDrain(handle.all), Effect.never)))),
     streamString,
     streamLines,
     lines: (command, options) => Stream.runCollect(streamLines(command, options)),

package/dist/process/ChildProcessSpawner.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChildProcessSpawner.js","names":[],"sources":["../../src/process/ChildProcessSpawner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;AAaA,OAAO,KAAK,KAAK,MAAM,aAAa;AACpC,OAAO,KAAK,OAAO,MAAM,eAAe;AACxC,OAAO,KAAK,MAAM,MAAM,cAAc;AACtC,OAAO,KAAK,WAAW,MAAM,mBAAmB;AAIhD,OAAO,KAAK,MAAM,MAAM,cAAc;AAYtC;;;;;;;AAOA,OAAO,MAAM,QAAQ,gBAAgC,KAAK,CAAC,OAAO,EAAY;AAY9E;;;;;;;AAOA,OAAO,MAAM,SAAS,gBAAiC,KAAK,CAAC,OAAO,EAAa;AAkBjF,MAAM,YAAY,GAAG,wDAAwD;AAiI7E,MAAM,WAAW,GAAG;EAClB,CAAC,YAAY,GAAG,YAAY;EAC5B,GAAG,WAAW,CAAC,SAAS;EACxB,MAAM;IACJ,OAAO;MAAE,GAAG,EAAE,oBAAoB;MAAE,GAAG,EAAE,IAAI,CAAC;IAAG,CAAE;EACrD;CACD;AAED;;;;;;;AAOA,OAAO,MAAM,UAAU,GAAI,MAAqD,IAC9E,MAAM,CAAC,cAAc,CAAC;EAAE,GAAG;AAAM,CAAE,EAAE,WAAW,CAAC;AAEnD;;;;;;;;AAQA,OAAO,MAAM,IAAI,GAAI,KAA8C,IAAoC;EACrG,MAAM,YAAY,GAAkD,CAAC,OAAO,EAAE,OAAO,KACnF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CACjB,MAAM,CAAC,GAAG,CAAE,MAAM,IAChB,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAC7D,CACF,EACD,MAAM,CAAC,MAAM,CACd;EACH,MAAM,WAAW,GAAkD,CAAC,OAAO,EAAE,OAAO,KAClF,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;EAEnD,OAAO,mBAAmB,CAAC,EAAE,CAAC;IAC5B,KAAK;IACL,QAAQ,EAAG,OAAO,IAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAG,MAAM,IAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjG,YAAY;IACZ,WAAW;IACX,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7E,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;GAC7E,CAAC;AACJ,CAAC;AAED;;;;;;;AAOA,OAAM,MAAO,mBAAoB,sBAAQ,OAAO,CAAC,OAAO,EA4CpD,CAAC,oCAAoC,CAAC","ignoreList":[]}
+{"version":3,"file":"ChildProcessSpawner.js","names":[],"sources":["../../src/process/ChildProcessSpawner.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;AAaA,OAAO,KAAK,KAAK,MAAM,aAAa;AACpC,OAAO,KAAK,OAAO,MAAM,eAAe;AACxC,OAAO,KAAK,MAAM,MAAM,cAAc;AACtC,OAAO,KAAK,WAAW,MAAM,mBAAmB;AAIhD,OAAO,KAAK,MAAM,MAAM,cAAc;AAYtC;;;;;;;AAOA,OAAO,MAAM,QAAQ,gBAAgC,KAAK,CAAC,OAAO,EAAY;AAY9E;;;;;;;AAOA,OAAO,MAAM,SAAS,gBAAiC,KAAK,CAAC,OAAO,EAAa;AAkBjF,MAAM,YAAY,GAAG,wDAAwD;AAsI7E,MAAM,WAAW,GAAG;EAClB,CAAC,YAAY,GAAG,YAAY;EAC5B,GAAG,WAAW,CAAC,SAAS;EACxB,MAAM;IACJ,OAAO;MAAE,GAAG,EAAE,oBAAoB;MAAE,GAAG,EAAE,IAAI,CAAC;IAAG,CAAE;EACrD;CACD;AAED;;;;;;;AAOA,OAAO,MAAM,UAAU,GAAI,MAAqD,IAC9E,MAAM,CAAC,cAAc,CAAC;EAAE,GAAG;AAAM,CAAE,EAAE,WAAW,CAAC;AAEnD;;;;;;;;AAQA,OAAO,MAAM,IAAI,GAAI,KAA8C,IAAoC;EACrG;EACA;EACA,MAAM,YAAY,GAAkD,CAAC,OAAO,EAAE,OAAO,KACnF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CACjB,MAAM,CAAC,GAAG,CAAE,MAAM,IAChB,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAC9F,CACF,EACD,MAAM,CAAC,MAAM,CACd;EACH,MAAM,WAAW,GAAkD,CAAC,OAAO,EAAE,OAAO,KAClF,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;EAEnD,OAAO,mBAAmB,CAAC,EAAE,CAAC;IAC5B,KAAK;IACL;IACA,QAAQ,EAAG,OAAO,IAChB,MAAM,CAAC,MAAM,CACX,MAAM,CAAC,OAAO,CACZ,KAAK,CAAC,OAAO,CAAC,EACb,MAAM,IAAK,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CACzG,CACF;IACH,YAAY;IACZ,WAAW;IACX,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7E,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;GAC7E,CAAC;AACJ,CAAC;AAED;;;;;;;AAOA,OAAM,MAAO,mBAAoB,sBAAQ,OAAO,CAAC,OAAO,EA0EpD,CAAC,oCAAoC,CAAC","ignoreList":[]}