@elaraai/east-web-std 1.0.85

package/dist/src/path.js

@@ -0,0 +1,562 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { East, StringType, ArrayType } from "@elaraai/east";
+import { EastError } from "@elaraai/east/internal";
+// Path strings use POSIX (forward-slash) semantics, as east-node-std's pure
+// path ops do on every OS (`node:path/posix`). A browser has no `node:path`,
+// so the functions below port Node.js's POSIX path functions (lib/path.js,
+// MIT — see THIRD_PARTY_NOTICES.md); test/path.spec.ts holds them to
+// `node:path/posix` over a generated corpus of paths.
+/** `/` */
+const SLASH = 47;
+/** `.` */
+const DOT = 46;
+/**
+ * The working directory {@link path_resolve} resolves against. A browser has
+ * none, so a relative path resolves against the root.
+ */
+const WORKING_DIRECTORY = "/";
+/**
+ * Resolves the `.` and `..` segments of a path and drops empty ones. Node's
+ * `normalizeString` for the POSIX separator.
+ *
+ * @param path - The path, without the root that makes it absolute
+ * @param allowAboveRoot - Whether `..` segments that climb past the start stay
+ */
+function normalizeString(path, allowAboveRoot) {
+    let res = "";
+    let lastSegmentLength = 0;
+    let lastSlash = -1;
+    let dots = 0;
+    let code = 0;
+    for (let i = 0; i <= path.length; ++i) {
+        if (i < path.length) {
+            code = path.charCodeAt(i);
+        }
+        else if (code === SLASH) {
+            break;
+        }
+        else {
+            code = SLASH;
+        }
+        if (code === SLASH) {
+            if (lastSlash === i - 1 || dots === 1) {
+                // NOOP
+            }
+            else if (dots === 2) {
+                if (res.length < 2 || lastSegmentLength !== 2 ||
+                    res.charCodeAt(res.length - 1) !== DOT ||
+                    res.charCodeAt(res.length - 2) !== DOT) {
+                    if (res.length > 2) {
+                        const lastSlashIndex = res.lastIndexOf("/");
+                        if (lastSlashIndex === -1) {
+                            res = "";
+                            lastSegmentLength = 0;
+                        }
+                        else {
+                            res = res.slice(0, lastSlashIndex);
+                            lastSegmentLength = res.length - 1 - res.lastIndexOf("/");
+                        }
+                        lastSlash = i;
+                        dots = 0;
+                        continue;
+                    }
+                    else if (res.length !== 0) {
+                        res = "";
+                        lastSegmentLength = 0;
+                        lastSlash = i;
+                        dots = 0;
+                        continue;
+                    }
+                }
+                if (allowAboveRoot) {
+                    res += res.length > 0 ? "/.." : "..";
+                    lastSegmentLength = 2;
+                }
+            }
+            else {
+                if (res.length > 0) {
+                    res += `/${path.slice(lastSlash + 1, i)}`;
+                }
+                else {
+                    res = path.slice(lastSlash + 1, i);
+                }
+                lastSegmentLength = i - lastSlash - 1;
+            }
+            lastSlash = i;
+            dots = 0;
+        }
+        else if (code === DOT && dots !== -1) {
+            ++dots;
+        }
+        else {
+            dots = -1;
+        }
+    }
+    return res;
+}
+/** Node's `path.posix.normalize`. */
+function normalize(path) {
+    if (path.length === 0) {
+        return ".";
+    }
+    const isAbsolute = path.charCodeAt(0) === SLASH;
+    const trailingSeparator = path.charCodeAt(path.length - 1) === SLASH;
+    // Normalize the path
+    let normalized = normalizeString(path, !isAbsolute);
+    if (normalized.length === 0) {
+        if (isAbsolute) {
+            return "/";
+        }
+        return trailingSeparator ? "./" : ".";
+    }
+    if (trailingSeparator) {
+        normalized += "/";
+    }
+    return isAbsolute ? `/${normalized}` : normalized;
+}
+/** Node's `path.posix.join`. */
+function join(segments) {
+    if (segments.length === 0) {
+        return ".";
+    }
+    let joined;
+    for (const segment of segments) {
+        if (segment.length > 0) {
+            joined = joined === undefined ? segment : `${joined}/${segment}`;
+        }
+    }
+    if (joined === undefined) {
+        return ".";
+    }
+    return normalize(joined);
+}
+/**
+ * Node's `path.posix.resolve(path)`, with {@link WORKING_DIRECTORY} where
+ * Node reads `process.cwd()`.
+ */
+function resolve(path) {
+    let resolvedPath = "";
+    let resolvedAbsolute = false;
+    // The path, then the working directory, until one of them is absolute
+    for (const segment of [path, WORKING_DIRECTORY]) {
+        if (resolvedAbsolute) {
+            break;
+        }
+        // Skip empty entries
+        if (segment.length === 0) {
+            continue;
+        }
+        resolvedPath = `${segment}/${resolvedPath}`;
+        resolvedAbsolute = segment.charCodeAt(0) === SLASH;
+    }
+    // Normalize the path
+    resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute);
+    if (resolvedAbsolute) {
+        return `/${resolvedPath}`;
+    }
+    return resolvedPath.length > 0 ? resolvedPath : ".";
+}
+/** Node's `path.posix.dirname`. */
+function dirname(path) {
+    if (path.length === 0) {
+        return ".";
+    }
+    const hasRoot = path.charCodeAt(0) === SLASH;
+    let end = -1;
+    let matchedSlash = true;
+    for (let i = path.length - 1; i >= 1; --i) {
+        if (path.charCodeAt(i) === SLASH) {
+            if (!matchedSlash) {
+                end = i;
+                break;
+            }
+        }
+        else {
+            // We saw the first non-path separator
+            matchedSlash = false;
+        }
+    }
+    if (end === -1) {
+        return hasRoot ? "/" : ".";
+    }
+    if (hasRoot && end === 1) {
+        return "//";
+    }
+    return path.slice(0, end);
+}
+/** Node's `path.posix.basename`, without a suffix to strip. */
+function basename(path) {
+    let start = 0;
+    let end = -1;
+    let matchedSlash = true;
+    for (let i = path.length - 1; i >= 0; --i) {
+        if (path.charCodeAt(i) === SLASH) {
+            // If we reached a path separator that was not part of a set of path
+            // separators at the end of the string, stop now
+            if (!matchedSlash) {
+                start = i + 1;
+                break;
+            }
+        }
+        else if (end === -1) {
+            // We saw the first non-path separator, mark this as the end of our
+            // path component
+            matchedSlash = false;
+            end = i + 1;
+        }
+    }
+    if (end === -1) {
+        return "";
+    }
+    return path.slice(start, end);
+}
+/** Node's `path.posix.extname`. */
+function extname(path) {
+    let startDot = -1;
+    let startPart = 0;
+    let end = -1;
+    let matchedSlash = true;
+    // Track the state of characters (if any) we see before our first dot and
+    // after any path separator we find
+    let preDotState = 0;
+    for (let i = path.length - 1; i >= 0; --i) {
+        const code = path.charCodeAt(i);
+        if (code === SLASH) {
+            // If we reached a path separator that was not part of a set of path
+            // separators at the end of the string, stop now
+            if (!matchedSlash) {
+                startPart = i + 1;
+                break;
+            }
+            continue;
+        }
+        if (end === -1) {
+            // We saw the first non-path separator, mark this as the end of our
+            // extension
+            matchedSlash = false;
+            end = i + 1;
+        }
+        if (code === DOT) {
+            // If this is our first dot, mark it as the start of our extension
+            if (startDot === -1) {
+                startDot = i;
+            }
+            else if (preDotState !== 1) {
+                preDotState = 1;
+            }
+        }
+        else if (startDot !== -1) {
+            // We saw a non-dot and non-path separator before our dot, so we should
+            // have a good chance at having a non-empty extension
+            preDotState = -1;
+        }
+    }
+    if (startDot === -1 ||
+        end === -1 ||
+        // We saw a non-dot character immediately before the dot
+        preDotState === 0 ||
+        // The (right-most) trimmed path component is exactly '..'
+        (preDotState === 1 &&
+            startDot === end - 1 &&
+            startDot === startPart + 1)) {
+        return "";
+    }
+    return path.slice(startDot, end);
+}
+/**
+ * Joins path segments into a single path.
+ *
+ * Combines an array of path segments with a forward-slash (`/`) separator on every platform.
+ * Normalizes the resulting path by resolving `.` and `..` segments. Empty segments
+ * are ignored.
+ *
+ * This is a platform function for the East language, enabling path joining
+ * in East programs running in a browser.
+ *
+ * @param segments - Array of path segments to join (e.g., ["dir", "subdir", "file.txt"])
+ * @returns The joined path, using forward slashes (`/`) on every platform
+ *
+ * @example
+ * ```ts
+ * const buildPath = East.function([], StringType, $ => {
+ *     const segments = $.let(["home", "user", "documents", "file.txt"], ArrayType(StringType));
+ *     return Path.join(segments);
+ *     // Returns: "home/user/documents/file.txt" on every platform
+ * });
+ * ```
+ */
+export const path_join = East.platform("path_join", [ArrayType(StringType)], StringType);
+/**
+ * Resolves a path to an absolute path.
+ *
+ * Converts a relative path to an absolute path by resolving it against the current
+ * working directory. If the path is already absolute, it is normalized and returned.
+ * Resolves `.` and `..` segments to their actual locations.
+ *
+ * This is a platform function for the East language, enabling path resolution
+ * in East programs running in a browser. A browser has no working directory,
+ * so a relative path resolves against the root, `/`.
+ *
+ * @param path - The path to resolve (relative or absolute)
+ * @returns The absolute path
+ *
+ * @example
+ * ```ts
+ * const getAbsolutePath = East.function([], StringType, $ => {
+ *     return Path.resolve("documents/../file.txt");
+ *     // Returns: "/file.txt"
+ * });
+ * ```
+ */
+export const path_resolve = East.platform("path_resolve", [StringType], StringType);
+/**
+ * Gets the directory name from a path.
+ *
+ * Extracts the directory portion of a path by removing the last segment (file name).
+ * Similar to the Unix `dirname` command. Trailing path separators are ignored.
+ *
+ * This is a platform function for the East language, enabling directory extraction
+ * in East programs running in a browser.
+ *
+ * @param path - The file path to extract directory from
+ * @returns The directory portion of the path
+ *
+ * @example
+ * ```ts
+ * const getDir = East.function([], StringType, $ => {
+ *     return Path.dirname("/home/user/documents/file.txt");
+ *     // Returns: "/home/user/documents"
+ * });
+ * ```
+ */
+export const path_dirname = East.platform("path_dirname", [StringType], StringType);
+/**
+ * Gets the base name (file name) from a path.
+ *
+ * Extracts the last segment of a path, typically the file name. Similar to the Unix
+ * `basename` command. Trailing path separators are ignored.
+ *
+ * This is a platform function for the East language, enabling filename extraction
+ * in East programs running in a browser.
+ *
+ * @param path - The file path to extract filename from
+ * @returns The file name portion of the path (including extension)
+ *
+ * @example
+ * ```ts
+ * const getFilename = East.function([], StringType, $ => {
+ *     return Path.basename("/home/user/documents/file.txt");
+ *     // Returns: "file.txt"
+ * });
+ * ```
+ */
+export const path_basename = East.platform("path_basename", [StringType], StringType);
+/**
+ * Gets the file extension from a path.
+ *
+ * Extracts the file extension from a path, including the leading dot. If the path
+ * has no extension or ends with a dot, returns an empty string. Only returns the
+ * last extension if multiple dots are present.
+ *
+ * This is a platform function for the East language, enabling extension extraction
+ * in East programs running in a browser.
+ *
+ * @param path - The file path to extract extension from
+ * @returns The file extension including the dot (e.g., ".txt"), or empty string if none
+ *
+ * @example
+ * ```ts
+ * const getExtension = East.function([], StringType, $ => {
+ *     return Path.extname("/home/user/documents/file.txt");
+ *     // Returns: ".txt"
+ * });
+ * ```
+ */
+export const path_extname = East.platform("path_extname", [StringType], StringType);
+/**
+ * Browser implementation of path platform functions.
+ *
+ * Pass this array to {@link East.compile} to enable path operations.
+ */
+const PathImpl = [
+    path_join.implement((segments) => {
+        try {
+            return join(segments);
+        }
+        catch (err) {
+            throw new EastError(`Failed to join path segments: ${err.message}`, {
+                location: [{ filename: "path_join", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    path_resolve.implement((path) => {
+        try {
+            return resolve(path);
+        }
+        catch (err) {
+            throw new EastError(`Failed to resolve path: ${err.message}`, {
+                location: [{ filename: "path_resolve", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    path_dirname.implement((path) => {
+        try {
+            return dirname(path);
+        }
+        catch (err) {
+            throw new EastError(`Failed to get dirname: ${err.message}`, {
+                location: [{ filename: "path_dirname", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    path_basename.implement((path) => {
+        try {
+            return basename(path);
+        }
+        catch (err) {
+            throw new EastError(`Failed to get basename: ${err.message}`, {
+                location: [{ filename: "path_basename", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    path_extname.implement((path) => {
+        try {
+            return extname(path);
+        }
+        catch (err) {
+            throw new EastError(`Failed to get extname: ${err.message}`, {
+                location: [{ filename: "path_extname", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+];
+/**
+ * Grouped path manipulation platform functions.
+ *
+ * Provides path utilities for East programs.
+ *
+ * @example
+ * ```ts
+ * import { East, StringType, ArrayType } from "@elaraai/east";
+ * import { Path } from "@elaraai/east-web-std";
+ *
+ * const buildPath = East.function([], StringType, $ => {
+ *     const segments = $.let(["dir", "subdir", "file.txt"], ArrayType(StringType));
+ *     const fullPath = $.let(Path.join(segments));
+ *     const ext = $.let(Path.extname(fullPath));
+ *     return fullPath;
+ * });
+ *
+ * const compiled = East.compile(buildPath, Path.Implementation);
+ * compiled();  // Returns: "dir/subdir/file.txt"
+ * ```
+ */
+export const Path = {
+    /**
+     * Joins path segments into a single path.
+     *
+     * Combines an array of path segments with a forward-slash (`/`) separator on every platform.
+     * Normalizes the resulting path and ignores empty segments.
+     *
+     * @param segments - Array of path segments to join
+     * @returns The joined path, using forward slashes (`/`) on every platform
+     *
+     * @example
+     * ```ts
+     * const buildPath = East.function([], StringType, $ => {
+     *     const segments = $.let(["home", "user", "file.txt"], ArrayType(StringType));
+     *     return Path.join(segments);
+     * });
+     * ```
+     */
+    join: path_join,
+    /**
+     * Resolves a path to an absolute path.
+     *
+     * Converts a relative path to an absolute path by resolving it against the
+     * working directory, which in a browser is the root, `/`. Normalizes the
+     * path and resolves `.` and `..` segments.
+     *
+     * @param path - The path to resolve (relative or absolute)
+     * @returns The absolute path
+     *
+     * @example
+     * ```ts
+     * const getAbsolutePath = East.function([], StringType, $ => {
+     *     return Path.resolve("documents/../file.txt");  // "/file.txt"
+     * });
+     * ```
+     */
+    resolve: path_resolve,
+    /**
+     * Gets the directory name from a path.
+     *
+     * Extracts the directory portion of a path by removing the last segment (file name).
+     * Trailing path separators are ignored.
+     *
+     * @param path - The file path to extract directory from
+     * @returns The directory portion of the path
+     *
+     * @example
+     * ```ts
+     * const getDir = East.function([], StringType, $ => {
+     *     return Path.dirname("/home/user/documents/file.txt");
+     * });
+     * ```
+     */
+    dirname: path_dirname,
+    /**
+     * Gets the base name (file name) from a path.
+     *
+     * Extracts the last segment of a path, typically the file name.
+     * Trailing path separators are ignored.
+     *
+     * @param path - The file path to extract filename from
+     * @returns The file name portion of the path (including extension)
+     *
+     * @example
+     * ```ts
+     * const getFilename = East.function([], StringType, $ => {
+     *     return Path.basename("/home/user/documents/file.txt");
+     * });
+     * ```
+     */
+    basename: path_basename,
+    /**
+     * Gets the file extension from a path.
+     *
+     * Extracts the file extension from a path, including the leading dot.
+     * Returns empty string if no extension exists.
+     *
+     * @param path - The file path to extract extension from
+     * @returns The file extension including the dot (e.g., ".txt"), or empty string
+     *
+     * @example
+     * ```ts
+     * const getExtension = East.function([], StringType, $ => {
+     *     return Path.extname("file.txt");
+     * });
+     *
+     * const compiled = East.compile(getExtension, Path.Implementation);
+     * compiled();  // Returns: ".txt"
+     * ```
+     */
+    extname: path_extname,
+    /**
+     * Browser implementation of path platform functions.
+     *
+     * Pass this to {@link East.compile} to enable path operations.
+     */
+    Implementation: PathImpl,
+};
+// Exported beside `Path.Implementation`, as east-node-std exports it
+export { PathImpl };
+//# sourceMappingURL=path.js.map

package/dist/src/path.js.map

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

package/dist/src/random/crypto-rng.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Vendored from npm package 'random' (https://github.com/transitive-bullshit/random)
+ * Originally by Travis Fischer, distributed under MIT license
+ *
+ * Ported from east-node-std's src/random/crypto-rng.ts
+ * (libs/east-node/packages/east-node-std/src/random/crypto-rng.ts), modified
+ * to draw from the web-standard `crypto.getRandomValues` where east-node-std
+ * reads `node:crypto`'s `randomBytes`. It reads the same 48 bits the same
+ * way, so the two draw from the same distribution; an unseeded draw is never
+ * reproducible on either.
+ */
+import RNG, { type SeedType } from "./rng.js";
+/**
+ * Cryptographically secure RNG using the web-standard crypto.getRandomValues
+ *
+ * Note: Seeding is not supported for cryptographic RNG as it uses the host's entropy source.
+ * The seed/clone methods are provided for API compatibility but have no effect.
+ */
+export default class CryptoRNG extends RNG {
+    get name(): string;
+    /**
+     * Generate a random number in [0, 1) using crypto.getRandomValues
+     */
+    next(): number;
+    /**
+     * Seeding is not supported for cryptographic RNG (no-op for API compatibility)
+     */
+    seed(_seed?: SeedType, _opts?: Record<string, unknown>): void;
+    /**
+     * Clone returns a new instance (seeding not supported)
+     */
+    clone(_seed?: SeedType, _opts?: Record<string, unknown>): RNG;
+}
+//# sourceMappingURL=crypto-rng.d.ts.map

package/dist/src/random/crypto-rng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-rng.d.ts","sourceRoot":"","sources":["../../../src/random/crypto-rng.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH;;;;;;;;;;GAUG;AAEH,OAAO,GAAG,EAAE,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,GAAG;IACtC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,MAAM;IAad;;OAEG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7D;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG;CAGhE"}

package/dist/src/random/crypto-rng.js

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Vendored from npm package 'random' (https://github.com/transitive-bullshit/random)
+ * Originally by Travis Fischer, distributed under MIT license
+ *
+ * Ported from east-node-std's src/random/crypto-rng.ts
+ * (libs/east-node/packages/east-node-std/src/random/crypto-rng.ts), modified
+ * to draw from the web-standard `crypto.getRandomValues` where east-node-std
+ * reads `node:crypto`'s `randomBytes`. It reads the same 48 bits the same
+ * way, so the two draw from the same distribution; an unseeded draw is never
+ * reproducible on either.
+ */
+import RNG, {} from "./rng.js";
+/**
+ * Cryptographically secure RNG using the web-standard crypto.getRandomValues
+ *
+ * Note: Seeding is not supported for cryptographic RNG as it uses the host's entropy source.
+ * The seed/clone methods are provided for API compatibility but have no effect.
+ */
+export default class CryptoRNG extends RNG {
+    get name() {
+        return "crypto";
+    }
+    /**
+     * Generate a random number in [0, 1) using crypto.getRandomValues
+     */
+    next() {
+        // Use 6 bytes (48 bits) for good precision
+        const bytes = globalThis.crypto.getRandomValues(new Uint8Array(6));
+        // Read them as one big-endian unsigned integer, as east-node-std's
+        // `readUIntBE(0, 6)` does; 2^48 is well inside a double's exact range
+        let value = 0;
+        for (const byte of bytes) {
+            value = value * 256 + byte;
+        }
+        // Divide by 2^48 to get [0, 1)
+        return value / 0x1000000000000;
+    }
+    /**
+     * Seeding is not supported for cryptographic RNG (no-op for API compatibility)
+     */
+    seed(_seed, _opts) {
+        // No-op: crypto RNG uses the host's entropy source
+    }
+    /**
+     * Clone returns a new instance (seeding not supported)
+     */
+    clone(_seed, _opts) {
+        return new CryptoRNG();
+    }
+}
+//# sourceMappingURL=crypto-rng.js.map

package/dist/src/random/crypto-rng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-rng.js","sourceRoot":"","sources":["../../../src/random/crypto-rng.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH;;;;;;;;;;GAUG;AAEH,OAAO,GAAG,EAAE,EAAiB,MAAM,UAAU,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,GAAG;IACtC,IAAI,IAAI;QACJ,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,IAAI;QACA,2CAA2C;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,mEAAmE;QACnE,sEAAsE;QACtE,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,KAAK,GAAG,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC;QAC/B,CAAC;QACD,+BAA+B;QAC/B,OAAO,KAAK,GAAG,eAAe,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAgB,EAAE,KAA+B;QAClD,mDAAmD;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAgB,EAAE,KAA+B;QACnD,OAAO,IAAI,SAAS,EAAE,CAAC;IAC3B,CAAC;CACJ"}