@metamask/snaps-cli 6.3.0 → 6.3.2

package/dist/webpack/loaders/wasm.mjs

@@ -1,16 +1,97 @@
-import {
-  getExports,
-  getImports,
-  getModuleImports,
-  raw,
-  wasm_default
-} from "../../chunk-ERSRIVYH.mjs";
-import "../../chunk-R77RJHC5.mjs";
-export {
-  wasm_default as default,
-  getExports,
-  getImports,
-  getModuleImports,
-  raw
+/* eslint-disable no-restricted-globals */
+import { assert } from "@metamask/utils";
+import { dirname, resolve } from "path";
+/**
+ * Get the imports code for the WASM module. This code imports each of the
+ * imports from the WASM module.
+ *
+ * @param importMap - The import map for the WASM module.
+ * @returns The imports code for the WASM module.
+ */
+export function getImports(importMap) {
+    return Object.entries(importMap)
+        .map(([moduleName, exportNames]) => `import { ${exportNames.join(', ')} } from ${JSON.stringify(moduleName)};`)
+        .join('\n');
+}
+/**
+ * Get the imports code to use in `WebAssembly.Instance`. This code adds each of
+ * the imports to the `imports` object.
+ *
+ * @param importMap - The import map for the WASM module.
+ * @returns The imports code for the WASM module.
+ */
+export function getModuleImports(importMap) {
+    return Object.entries(importMap)
+        .map(([moduleName, exportNames]) => `${JSON.stringify(moduleName)}: { ${exportNames.join(', ')} },`)
+        .join('\n');
+}
+/**
+ * Get the exports code for the WASM module. This code exports each of the
+ * exports from the WASM module as a variable. This function assumes that the
+ * exports are available in a variable named `exports`.
+ *
+ * @param descriptors - The export descriptors from the WASM module.
+ * @returns The exports code for the WASM module.
+ */
+export function getExports(descriptors) {
+    return descriptors
+        .map((descriptor) => {
+        if (descriptor.name === 'default') {
+            return `export default exports[${JSON.stringify(descriptor.name)}];`;
+        }
+        return `export const ${descriptor.name} = exports[${JSON.stringify(descriptor.name)}];`;
+    })
+        .join('\n');
+}
+/**
+ * A Webpack loader that synchronously loads the WASM module. This makes it
+ * possible to import the WASM module directly.
+ *
+ * @param source - The WASM module as `Uint8Array`.
+ * @returns The WASM module as a JavaScript string.
+ * @example
+ * ```ts
+ * import * as wasm from './program.wasm';
+ *
+ * // Do something with the WASM module...
+ * ```
+ */
+// Note: This function needs to be defined like this, so that Webpack can bind
+// `this` to the loader context, and TypeScript can infer the type of `this`.
+const loader = async function loader(source) {
+    assert(source instanceof Uint8Array, 'Expected source to be a Uint8Array.');
+    const bytes = new Uint8Array(source);
+    const wasmModule = await WebAssembly.compile(bytes);
+    // eslint-disable-next-line @typescript-eslint/no-shadow
+    const exports = WebAssembly.Module.exports(wasmModule);
+    const imports = WebAssembly.Module.imports(wasmModule).reduce((target, descriptor) => {
+        var _a;
+        target[_a = descriptor.module] ?? (target[_a] = []);
+        target[descriptor.module].push(descriptor.name);
+        return target;
+    }, {});
+    // Add the WASM import as a dependency so that Webpack will watch it for
+    // changes.
+    const path = dirname(this.resourcePath);
+    for (const name of Object.keys(imports)) {
+        this.addDependency(resolve(path, name));
+    }
+    return `
+    ${getImports(imports)}
+
+    const bytes = new Uint8Array(${JSON.stringify(Array.from(source))});
+    const module = new WebAssembly.Module(bytes);
+    const instance = new WebAssembly.Instance(module, {
+      ${getModuleImports(imports)}
+    });
+
+    const exports = instance.exports;
+    ${getExports(exports)}
+  `;
 };
+export default loader;
+// By setting `raw` to `true`, we are telling Webpack to provide the source as a
+// `Uint8Array` instead of converting it to a string. This allows us to avoid
+// having to convert the source back to a `Uint8Array` in the loader.
+export const raw = true;
 //# sourceMappingURL=wasm.mjs.map

package/dist/webpack/loaders/wasm.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"wasm.mjs","sourceRoot":"","sources":["../../../src/webpack/loaders/wasm.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-restricted-globals */\n\nimport { assert } from '@metamask/utils';\nimport { dirname, resolve } from 'path';\nimport type { LoaderDefinitionFunction } from 'webpack';\n\n/**\n * Get the imports code for the WASM module. This code imports each of the\n * imports from the WASM module.\n *\n * @param importMap - The import map for the WASM module.\n * @returns The imports code for the WASM module.\n */\nexport function getImports(importMap: Record<string, string[]>) {\n  return Object.entries(importMap)\n    .map(\n      ([moduleName, exportNames]) =>\n        `import { ${exportNames.join(', ')} } from ${JSON.stringify(\n          moduleName,\n        )};`,\n    )\n    .join('\\n');\n}\n\n/**\n * Get the imports code to use in `WebAssembly.Instance`. This code adds each of\n * the imports to the `imports` object.\n *\n * @param importMap - The import map for the WASM module.\n * @returns The imports code for the WASM module.\n */\nexport function getModuleImports(importMap: Record<string, string[]>) {\n  return Object.entries(importMap)\n    .map(\n      ([moduleName, exportNames]) =>\n        `${JSON.stringify(moduleName)}: { ${exportNames.join(', ')} },`,\n    )\n    .join('\\n');\n}\n\n/**\n * Get the exports code for the WASM module. This code exports each of the\n * exports from the WASM module as a variable. This function assumes that the\n * exports are available in a variable named `exports`.\n *\n * @param descriptors - The export descriptors from the WASM module.\n * @returns The exports code for the WASM module.\n */\nexport function getExports(descriptors: WebAssembly.ModuleExportDescriptor[]) {\n  return descriptors\n    .map((descriptor) => {\n      if (descriptor.name === 'default') {\n        return `export default exports[${JSON.stringify(descriptor.name)}];`;\n      }\n\n      return `export const ${descriptor.name} = exports[${JSON.stringify(\n        descriptor.name,\n      )}];`;\n    })\n    .join('\\n');\n}\n\n/**\n * A Webpack loader that synchronously loads the WASM module. This makes it\n * possible to import the WASM module directly.\n *\n * @param source - The WASM module as `Uint8Array`.\n * @returns The WASM module as a JavaScript string.\n * @example\n * ```ts\n * import * as wasm from './program.wasm';\n *\n * // Do something with the WASM module...\n * ```\n */\n// Note: This function needs to be defined like this, so that Webpack can bind\n// `this` to the loader context, and TypeScript can infer the type of `this`.\nconst loader: LoaderDefinitionFunction = async function loader(\n  source: unknown,\n) {\n  assert(source instanceof Uint8Array, 'Expected source to be a Uint8Array.');\n\n  const bytes = new Uint8Array(source);\n  const wasmModule = await WebAssembly.compile(bytes);\n\n  // eslint-disable-next-line @typescript-eslint/no-shadow\n  const exports = WebAssembly.Module.exports(wasmModule);\n  const imports = WebAssembly.Module.imports(wasmModule).reduce<\n    Record<string, string[]>\n  >((target, descriptor) => {\n    target[descriptor.module] ??= [];\n    target[descriptor.module].push(descriptor.name);\n\n    return target;\n  }, {});\n\n  // Add the WASM import as a dependency so that Webpack will watch it for\n  // changes.\n  const path = dirname(this.resourcePath);\n  for (const name of Object.keys(imports)) {\n    this.addDependency(resolve(path, name));\n  }\n\n  return `\n    ${getImports(imports)}\n\n    const bytes = new Uint8Array(${JSON.stringify(Array.from(source))});\n    const module = new WebAssembly.Module(bytes);\n    const instance = new WebAssembly.Instance(module, {\n      ${getModuleImports(imports)}\n    });\n\n    const exports = instance.exports;\n    ${getExports(exports)}\n  `;\n};\n\nexport default loader;\n\n// By setting `raw` to `true`, we are telling Webpack to provide the source as a\n// `Uint8Array` instead of converting it to a string. This allows us to avoid\n// having to convert the source back to a `Uint8Array` in the loader.\nexport const raw = true;\n"]}

package/dist/webpack/plugins.cjs

@@ -0,0 +1,277 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _SnapsStatsPlugin_instances, _SnapsStatsPlugin_spinner, _SnapsStatsPlugin_getStatsErrorMessage, _SnapsWatchPlugin_instances, _SnapsWatchPlugin_spinner, _SnapsWatchPlugin_safeEvaluate, _SnapsBuiltInResolver_source, _SnapsBuiltInResolver_spinner, _SnapsBundleWarningsPlugin_instances, _SnapsBundleWarningsPlugin_checkBuiltIns, _SnapsBundleWarningsPlugin_isProvidePlugin, _SnapsBundleWarningsPlugin_checkBuffer;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapsBundleWarningsPlugin = exports.SnapsBuiltInResolver = exports.SnapsWatchPlugin = exports.SnapsStatsPlugin = void 0;
+const utils_1 = require("@metamask/utils");
+const chalk_1 = require("chalk");
+const module_1 = require("module");
+const webpack_1 = require("webpack");
+const eval_1 = require("../commands/eval/index.cjs");
+const utils_2 = require("../utils/index.cjs");
+const utils_3 = require("./utils.cjs");
+/**
+ * A plugin that logs the stats after compilation. This is useful for logging
+ * the number of files compiled, and the time taken to compile them.
+ */
+class SnapsStatsPlugin {
+    constructor(options = {
+        verbose: false,
+    }, spinner) {
+        _SnapsStatsPlugin_instances.add(this);
+        /**
+         * The spinner to use for logging.
+         */
+        _SnapsStatsPlugin_spinner.set(this, void 0);
+        this.options = options;
+        __classPrivateFieldSet(this, _SnapsStatsPlugin_spinner, spinner, "f");
+    }
+    /**
+     * Apply the plugin to the Webpack compiler.
+     *
+     * @param compiler - The Webpack compiler.
+     */
+    apply(compiler) {
+        compiler.hooks.afterDone.tap(this.constructor.name, (stats) => {
+            if (!stats) {
+                return;
+            }
+            const { modules, time, errors, warnings } = stats.toJson();
+            (0, utils_1.assert)(modules, 'Modules must be defined in stats.');
+            (0, utils_1.assert)(time, 'Time must be defined in stats.');
+            if (errors?.length) {
+                const formattedErrors = errors
+                    .map((statsError) => __classPrivateFieldGet(this, _SnapsStatsPlugin_instances, "m", _SnapsStatsPlugin_getStatsErrorMessage).call(this, statsError))
+                    .join('\n\n');
+                (0, utils_2.error)(`Compiled ${modules.length} ${(0, utils_3.pluralize)(modules.length, 'file')} in ${time}ms with ${errors.length} ${(0, utils_3.pluralize)(errors.length, 'error')}.\n\n${formattedErrors}\n`, __classPrivateFieldGet(this, _SnapsStatsPlugin_spinner, "f"));
+                __classPrivateFieldGet(this, _SnapsStatsPlugin_spinner, "f")?.stop();
+                process.exitCode = 1;
+                return;
+            }
+            if (warnings?.length) {
+                const formattedWarnings = warnings
+                    .map((statsWarning) => __classPrivateFieldGet(this, _SnapsStatsPlugin_instances, "m", _SnapsStatsPlugin_getStatsErrorMessage).call(this, statsWarning, chalk_1.yellow))
+                    .join('\n\n');
+                (0, utils_2.warn)(`Compiled ${modules.length} ${(0, utils_3.pluralize)(modules.length, 'file')} in ${time}ms with ${warnings.length} ${(0, utils_3.pluralize)(warnings.length, 'warning')}.\n\n${formattedWarnings}\n`, __classPrivateFieldGet(this, _SnapsStatsPlugin_spinner, "f"));
+            }
+            else {
+                (0, utils_2.info)(`Compiled ${modules.length} ${(0, utils_3.pluralize)(modules.length, 'file')} in ${time}ms.`, __classPrivateFieldGet(this, _SnapsStatsPlugin_spinner, "f"));
+            }
+            if (compiler.watchMode) {
+                // The spinner may be restarted by the watch plugin, outside of the
+                // `executeSteps` flow, so we stop it here just in case.
+                __classPrivateFieldGet(this, _SnapsStatsPlugin_spinner, "f")?.succeed('Done!');
+            }
+        });
+    }
+}
+exports.SnapsStatsPlugin = SnapsStatsPlugin;
+_SnapsStatsPlugin_spinner = new WeakMap(), _SnapsStatsPlugin_instances = new WeakSet(), _SnapsStatsPlugin_getStatsErrorMessage = function _SnapsStatsPlugin_getStatsErrorMessage(statsError, color = chalk_1.red) {
+    const baseMessage = this.options.verbose
+        ? (0, utils_2.getErrorMessage)(statsError)
+        : statsError.message;
+    const [first, ...rest] = baseMessage.split('\n');
+    return [
+        color((0, utils_3.formatText)(`• ${first}`, 4, 2)),
+        ...rest.map((message) => (0, utils_3.formatText)(color(message), 4)),
+        statsError.details && `\n${(0, utils_3.formatText)((0, chalk_1.dim)(statsError.details), 6)}`,
+    ]
+        .filter(Boolean)
+        .join('\n');
+};
+/**
+ * A plugin that adds extra files to watch. This is useful for watching files
+ * that are not imported by the entry point, such as the `snap.manifest.json`
+ * file.
+ */
+class SnapsWatchPlugin {
+    constructor(options, spinner) {
+        _SnapsWatchPlugin_instances.add(this);
+        /**
+         * The spinner to use for logging.
+         */
+        _SnapsWatchPlugin_spinner.set(this, void 0);
+        this.options = options;
+        __classPrivateFieldSet(this, _SnapsWatchPlugin_spinner, spinner, "f");
+    }
+    /**
+     * Apply the plugin to the Webpack compiler.
+     *
+     * @param compiler - The Webpack compiler.
+     */
+    apply(compiler) {
+        compiler.hooks.invalid.tap(this.constructor.name, (file) => {
+            __classPrivateFieldGet(this, _SnapsWatchPlugin_spinner, "f")?.start();
+            (0, utils_2.info)(`Changes detected in ${(0, chalk_1.yellow)(file)}, recompiling.`, __classPrivateFieldGet(this, _SnapsWatchPlugin_spinner, "f"));
+        });
+        compiler.hooks.afterEmit.tapPromise(this.constructor.name, async ({ fileDependencies }) => {
+            this.options.files?.forEach(fileDependencies.add.bind(fileDependencies));
+            if (this.options.bundle && this.options.evaluate) {
+                await __classPrivateFieldGet(this, _SnapsWatchPlugin_instances, "m", _SnapsWatchPlugin_safeEvaluate).call(this, this.options.bundle);
+            }
+        });
+    }
+}
+exports.SnapsWatchPlugin = SnapsWatchPlugin;
+_SnapsWatchPlugin_spinner = new WeakMap(), _SnapsWatchPlugin_instances = new WeakSet(), _SnapsWatchPlugin_safeEvaluate = 
+/**
+ * Safely evaluate the bundle at the given path. If an error occurs, it will
+ * be logged to the console, rather than throwing an error.
+ *
+ * This function should never throw an error.
+ *
+ * @param bundlePath - The path to the bundle.
+ */
+async function _SnapsWatchPlugin_safeEvaluate(bundlePath) {
+    try {
+        await (0, eval_1.evaluate)(bundlePath);
+        (0, utils_2.info)(`Snap bundle evaluated successfully.`, __classPrivateFieldGet(this, _SnapsWatchPlugin_spinner, "f"));
+    }
+    catch (evaluateError) {
+        (0, utils_2.error)(evaluateError.message, __classPrivateFieldGet(this, _SnapsWatchPlugin_spinner, "f"));
+    }
+};
+/**
+ * A plugin that logs a message when a built-in module is not resolved. The
+ * MetaMask Snaps CLI does not support built-in modules by default, and this
+ * plugin is used to warn the user when they try to import a built-in module,
+ * when no fallback is configured.
+ */
+class SnapsBuiltInResolver {
+    constructor(options = {
+        ignore: [],
+    }, spinner) {
+        /**
+         * The built-in modules that have been imported, but not resolved.
+         */
+        this.unresolvedModules = new Set();
+        /**
+         * The name of the resolver hook to tap into.
+         */
+        _SnapsBuiltInResolver_source.set(this, 'described-resolve');
+        /**
+         * The spinner to use for logging.
+         */
+        _SnapsBuiltInResolver_spinner.set(this, void 0);
+        this.options = options;
+        __classPrivateFieldSet(this, _SnapsBuiltInResolver_spinner, spinner, "f");
+    }
+    /**
+     * Apply the plugin to the Webpack resolver.
+     *
+     * @param resolver - The Webpack resolver.
+     */
+    apply(resolver) {
+        resolver
+            .getHook(__classPrivateFieldGet(this, _SnapsBuiltInResolver_source, "f"))
+            .tapAsync(this.constructor.name, ({ module: isModule, request }, _, callback) => {
+            if (!isModule || !request) {
+                return callback();
+            }
+            const baseRequest = request.split('/')[0];
+            if ((0, module_1.isBuiltin)(baseRequest) &&
+                !this.options.ignore?.includes(baseRequest)) {
+                const fallback = resolver.options.fallback.find(({ name }) => name === baseRequest);
+                if (fallback && !fallback.alias) {
+                    this.unresolvedModules.add(baseRequest);
+                }
+            }
+            return callback();
+        });
+    }
+}
+exports.SnapsBuiltInResolver = SnapsBuiltInResolver;
+_SnapsBuiltInResolver_source = new WeakMap(), _SnapsBuiltInResolver_spinner = new WeakMap();
+/**
+ * A plugin that logs a message when:
+ *
+ * - A built-in module is not resolved. The MetaMask Snaps CLI does not support
+ * built-in modules by default, and this plugin is used to warn the user when
+ * they try to import a built-in module, when no fallback is configured.
+ * - A snap uses the `Buffer` global. The MetaMask Snaps CLI does not support
+ * the `Buffer` global by default, and this plugin is used to warn the user when
+ * they try to use the `Buffer` global.
+ *
+ * We use both a resolver and a plugin, because the resolver is used to detect
+ * when a built-in module is imported, and the plugin is used to log a single
+ * message when the compilation is complete. We can't do everything in a single
+ * plugin, because the resolver doesn't have access to the compilation, and the
+ * plugin doesn't have access to the resolver.
+ */
+class SnapsBundleWarningsPlugin {
+    constructor(options = {
+        buffer: true,
+        builtIns: true,
+    }) {
+        _SnapsBundleWarningsPlugin_instances.add(this);
+        this.options = options;
+    }
+    /**
+     * Apply the plugin to the Webpack compiler.
+     *
+     * @param compiler - The Webpack compiler.
+     */
+    apply(compiler) {
+        if (this.options.builtIns) {
+            __classPrivateFieldGet(this, _SnapsBundleWarningsPlugin_instances, "m", _SnapsBundleWarningsPlugin_checkBuiltIns).call(this, compiler);
+        }
+        if (this.options.buffer) {
+            __classPrivateFieldGet(this, _SnapsBundleWarningsPlugin_instances, "m", _SnapsBundleWarningsPlugin_checkBuffer).call(this, compiler);
+        }
+    }
+}
+exports.SnapsBundleWarningsPlugin = SnapsBundleWarningsPlugin;
+_SnapsBundleWarningsPlugin_instances = new WeakSet(), _SnapsBundleWarningsPlugin_checkBuiltIns = function _SnapsBundleWarningsPlugin_checkBuiltIns(compiler) {
+    compiler.hooks.afterCompile.tap(this.constructor.name, (compilation) => {
+        if (!this.options.builtInResolver) {
+            return;
+        }
+        const { unresolvedModules } = this.options.builtInResolver;
+        if (unresolvedModules.size === 0) {
+            return;
+        }
+        const formattedModules = new Array(...unresolvedModules)
+            .map((name) => `• ${name}`)
+            .join('\n');
+        const webpackError = new webpack_1.WebpackError(`The snap attempted to use one or more Node.js builtins, but no browser fallback has been provided. The MetaMask Snaps CLI does not support Node.js builtins by default. If you want to use this module, you must set ${(0, chalk_1.bold)('`polyfills`')} to ${(0, chalk_1.bold)('`true`')} or an object with the builtins to polyfill as the key and ${(0, chalk_1.bold)('`true`')} as the value. To disable this warning, set ${(0, chalk_1.bold)('`stats.builtIns`')} to ${(0, chalk_1.bold)('`false`')} in your snap config file, or add the module to the ${(0, chalk_1.bold)('`stats.builtIns.ignore`')} array.`);
+        webpackError.details = formattedModules;
+        compilation.warnings.push(webpackError);
+    });
+}, _SnapsBundleWarningsPlugin_isProvidePlugin = function _SnapsBundleWarningsPlugin_isProvidePlugin(instance) {
+    return ((0, utils_1.isObject)(instance) &&
+        instance.constructor.name === 'ProvidePlugin' &&
+        (0, utils_1.hasProperty)(instance, 'definitions'));
+}, _SnapsBundleWarningsPlugin_checkBuffer = function _SnapsBundleWarningsPlugin_checkBuffer(compiler) {
+    const plugin = compiler.options.plugins?.find((instance) => __classPrivateFieldGet(this, _SnapsBundleWarningsPlugin_instances, "m", _SnapsBundleWarningsPlugin_isProvidePlugin).call(this, instance));
+    // If the `ProvidePlugin` is configured to provide `Buffer`, then we don't
+    // need to warn the user.
+    if (plugin) {
+        const { definitions } = plugin;
+        if (definitions.Buffer) {
+            return;
+        }
+    }
+    compiler.hooks.compilation.tap(this.constructor.name, (compilation) => {
+        compilation.hooks.afterProcessAssets.tap(this.constructor.name, (assets) => {
+            // Check if assets use `Buffer`.
+            const bufferAssets = Object.entries(assets)
+                .filter(([name]) => name.endsWith('.js'))
+                .filter(([, asset]) => asset.source().includes('Buffer'));
+            if (bufferAssets.length === 0) {
+                return;
+            }
+            compilation.warnings.push(new webpack_1.WebpackError(`The snap attempted to use the Node.js Buffer global, which is not supported in the MetaMask Snaps CLI by default. To use the Buffer global, you must polyfill Buffer by setting ${(0, chalk_1.bold)('`buffer`')} to ${(0, chalk_1.bold)('`true`')} in the ${(0, chalk_1.bold)('`polyfills`')} config object in your snap config. To disable this warning, set ${(0, chalk_1.bold)('`stats.buffer`')} to ${(0, chalk_1.bold)('`false`')} in your snap config file.`));
+        });
+    });
+};
+//# sourceMappingURL=plugins.cjs.map

package/dist/webpack/plugins.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.cjs","sourceRoot":"","sources":["../../src/webpack/plugins.ts"],"names":[],"mappings":"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","sourcesContent":["import { assert, hasProperty, isObject } from '@metamask/utils';\nimport { bold, dim, red, yellow } from 'chalk';\nimport { isBuiltin } from 'module';\nimport type { Ora } from 'ora';\nimport type {\n  Compiler,\n  ProvidePlugin,\n  ResolvePluginInstance,\n  Resolver,\n  StatsError,\n  WebpackPluginInstance,\n} from 'webpack';\nimport { WebpackError } from 'webpack';\n\nimport { evaluate } from '../commands/eval';\nimport { error, getErrorMessage, info, warn } from '../utils';\nimport { formatText, pluralize } from './utils';\n\nexport type SnapsStatsPluginOptions = {\n  /**\n   * Whether to log the verbose stats.\n   */\n  verbose?: boolean;\n};\n\n/**\n * A plugin that logs the stats after compilation. This is useful for logging\n * the number of files compiled, and the time taken to compile them.\n */\nexport class SnapsStatsPlugin implements WebpackPluginInstance {\n  /**\n   * The options for the plugin.\n   */\n  readonly options: SnapsStatsPluginOptions;\n\n  /**\n   * The spinner to use for logging.\n   */\n  readonly #spinner?: Ora;\n\n  constructor(\n    options: SnapsStatsPluginOptions = {\n      verbose: false,\n    },\n    spinner?: Ora,\n  ) {\n    this.options = options;\n    this.#spinner = spinner;\n  }\n\n  /**\n   * Apply the plugin to the Webpack compiler.\n   *\n   * @param compiler - The Webpack compiler.\n   */\n  apply(compiler: Compiler) {\n    compiler.hooks.afterDone.tap(this.constructor.name, (stats) => {\n      if (!stats) {\n        return;\n      }\n\n      const { modules, time, errors, warnings } = stats.toJson();\n\n      assert(modules, 'Modules must be defined in stats.');\n      assert(time, 'Time must be defined in stats.');\n\n      if (errors?.length) {\n        const formattedErrors = errors\n          .map((statsError) => this.#getStatsErrorMessage(statsError))\n          .join('\\n\\n');\n\n        error(\n          `Compiled ${modules.length} ${pluralize(\n            modules.length,\n            'file',\n          )} in ${time}ms with ${errors.length} ${pluralize(\n            errors.length,\n            'error',\n          )}.\\n\\n${formattedErrors}\\n`,\n          this.#spinner,\n        );\n\n        this.#spinner?.stop();\n\n        process.exitCode = 1;\n        return;\n      }\n\n      if (warnings?.length) {\n        const formattedWarnings = warnings\n          .map((statsWarning) =>\n            this.#getStatsErrorMessage(statsWarning, yellow),\n          )\n          .join('\\n\\n');\n\n        warn(\n          `Compiled ${modules.length} ${pluralize(\n            modules.length,\n            'file',\n          )} in ${time}ms with ${warnings.length} ${pluralize(\n            warnings.length,\n            'warning',\n          )}.\\n\\n${formattedWarnings}\\n`,\n          this.#spinner,\n        );\n      } else {\n        info(\n          `Compiled ${modules.length} ${pluralize(\n            modules.length,\n            'file',\n          )} in ${time}ms.`,\n          this.#spinner,\n        );\n      }\n\n      if (compiler.watchMode) {\n        // The spinner may be restarted by the watch plugin, outside of the\n        // `executeSteps` flow, so we stop it here just in case.\n        this.#spinner?.succeed('Done!');\n      }\n    });\n  }\n\n  /**\n   * Get the error message for the given stats error.\n   *\n   * @param statsError - The stats error.\n   * @param color - The color to use for the error message.\n   * @returns The error message.\n   */\n  #getStatsErrorMessage(statsError: StatsError, color = red) {\n    const baseMessage = this.options.verbose\n      ? getErrorMessage(statsError)\n      : statsError.message;\n\n    const [first, ...rest] = baseMessage.split('\\n');\n\n    return [\n      color(formatText(`• ${first}`, 4, 2)),\n      ...rest.map((message) => formatText(color(message), 4)),\n      statsError.details && `\\n${formatText(dim(statsError.details), 6)}`,\n    ]\n      .filter(Boolean)\n      .join('\\n');\n  }\n}\n\n/**\n * The options for the {@link SnapsWatchPlugin}.\n */\nexport type SnapsWatchPluginOptions = {\n  /**\n   * The bundle path. This is the file that will be evaluated, if the `evaluate`\n   * option is set.\n   */\n  bundle?: string;\n\n  /**\n   * Whether to evaluate the bundle. This only applies if the `bundle` option is\n   * set.\n   */\n  evaluate?: boolean;\n\n  /**\n   * The extra files to watch.\n   */\n  files?: string[];\n};\n\n/**\n * A plugin that adds extra files to watch. This is useful for watching files\n * that are not imported by the entry point, such as the `snap.manifest.json`\n * file.\n */\nexport class SnapsWatchPlugin implements WebpackPluginInstance {\n  /**\n   * The options for the plugin.\n   */\n  readonly options: SnapsWatchPluginOptions;\n\n  /**\n   * The spinner to use for logging.\n   */\n  readonly #spinner?: Ora;\n\n  constructor(options: SnapsWatchPluginOptions, spinner?: Ora) {\n    this.options = options;\n    this.#spinner = spinner;\n  }\n\n  /**\n   * Apply the plugin to the Webpack compiler.\n   *\n   * @param compiler - The Webpack compiler.\n   */\n  apply(compiler: Compiler) {\n    compiler.hooks.invalid.tap(this.constructor.name, (file) => {\n      this.#spinner?.start();\n      info(`Changes detected in ${yellow(file)}, recompiling.`, this.#spinner);\n    });\n\n    compiler.hooks.afterEmit.tapPromise(\n      this.constructor.name,\n      async ({ fileDependencies }) => {\n        this.options.files?.forEach(\n          fileDependencies.add.bind(fileDependencies),\n        );\n\n        if (this.options.bundle && this.options.evaluate) {\n          await this.#safeEvaluate(this.options.bundle);\n        }\n      },\n    );\n  }\n\n  /**\n   * Safely evaluate the bundle at the given path. If an error occurs, it will\n   * be logged to the console, rather than throwing an error.\n   *\n   * This function should never throw an error.\n   *\n   * @param bundlePath - The path to the bundle.\n   */\n  async #safeEvaluate(bundlePath: string) {\n    try {\n      await evaluate(bundlePath);\n      info(`Snap bundle evaluated successfully.`, this.#spinner);\n    } catch (evaluateError) {\n      error(evaluateError.message, this.#spinner);\n    }\n  }\n}\n\n/**\n * The options for the {@link SnapsBuiltInResolver}.\n */\nexport type SnapsBuiltInResolverOptions = {\n  /**\n   * The built-in modules to ignore.\n   */\n  ignore?: string[];\n};\n\n/**\n * A plugin that logs a message when a built-in module is not resolved. The\n * MetaMask Snaps CLI does not support built-in modules by default, and this\n * plugin is used to warn the user when they try to import a built-in module,\n * when no fallback is configured.\n */\nexport class SnapsBuiltInResolver implements ResolvePluginInstance {\n  /**\n   * The built-in modules that have been imported, but not resolved.\n   */\n  readonly unresolvedModules = new Set<string>();\n\n  /**\n   * The name of the resolver hook to tap into.\n   */\n  readonly #source = 'described-resolve';\n\n  /**\n   * The options for the plugin.\n   */\n  readonly options: SnapsBuiltInResolverOptions;\n\n  /**\n   * The spinner to use for logging.\n   */\n  readonly #spinner?: Ora;\n\n  constructor(\n    options: SnapsBuiltInResolverOptions = {\n      ignore: [],\n    },\n    spinner?: Ora,\n  ) {\n    this.options = options;\n    this.#spinner = spinner;\n  }\n\n  /**\n   * Apply the plugin to the Webpack resolver.\n   *\n   * @param resolver - The Webpack resolver.\n   */\n  apply(resolver: Resolver) {\n    resolver\n      .getHook(this.#source)\n      .tapAsync(\n        this.constructor.name,\n        ({ module: isModule, request }, _, callback) => {\n          if (!isModule || !request) {\n            return callback();\n          }\n\n          const baseRequest = request.split('/')[0];\n          if (\n            isBuiltin(baseRequest) &&\n            !this.options.ignore?.includes(baseRequest)\n          ) {\n            const fallback = resolver.options.fallback.find(\n              ({ name }) => name === baseRequest,\n            );\n\n            if (fallback && !fallback.alias) {\n              this.unresolvedModules.add(baseRequest);\n            }\n          }\n\n          return callback();\n        },\n      );\n  }\n}\n\n/**\n * The options for the {@link SnapsBundleWarningsPlugin}.\n */\nexport type SnapsBundleWarningsPluginOptions = {\n  /**\n   * The {@link SnapsBuiltInResolver} instance to use for detecting built-in\n   * modules.\n   */\n  builtInResolver?: SnapsBuiltInResolver | false;\n\n  /**\n   * Whether to show warnings if built-in modules are used, but not provided by\n   * Webpack's `fallback` configuration.\n   */\n  builtIns?: boolean;\n\n  /**\n   * Whether to show warnings if the `Buffer` global is used, but not provided\n   * by Webpack's `DefinePlugin`.\n   */\n  buffer?: boolean;\n};\n\n/**\n * A plugin that logs a message when:\n *\n * - A built-in module is not resolved. The MetaMask Snaps CLI does not support\n * built-in modules by default, and this plugin is used to warn the user when\n * they try to import a built-in module, when no fallback is configured.\n * - A snap uses the `Buffer` global. The MetaMask Snaps CLI does not support\n * the `Buffer` global by default, and this plugin is used to warn the user when\n * they try to use the `Buffer` global.\n *\n * We use both a resolver and a plugin, because the resolver is used to detect\n * when a built-in module is imported, and the plugin is used to log a single\n * message when the compilation is complete. We can't do everything in a single\n * plugin, because the resolver doesn't have access to the compilation, and the\n * plugin doesn't have access to the resolver.\n */\n\nexport class SnapsBundleWarningsPlugin implements WebpackPluginInstance {\n  /**\n   * The options for the plugin.\n   */\n  readonly options: SnapsBundleWarningsPluginOptions;\n\n  constructor(\n    options: SnapsBundleWarningsPluginOptions = {\n      buffer: true,\n      builtIns: true,\n    },\n  ) {\n    this.options = options;\n  }\n\n  /**\n   * Apply the plugin to the Webpack compiler.\n   *\n   * @param compiler - The Webpack compiler.\n   */\n  apply(compiler: Compiler) {\n    if (this.options.builtIns) {\n      this.#checkBuiltIns(compiler);\n    }\n\n    if (this.options.buffer) {\n      this.#checkBuffer(compiler);\n    }\n  }\n\n  /**\n   * Check if a built-in module is used, but not provided by Webpack's\n   * `fallback` configuration.\n   *\n   * @param compiler - The Webpack compiler.\n   */\n  #checkBuiltIns(compiler: Compiler) {\n    compiler.hooks.afterCompile.tap(this.constructor.name, (compilation) => {\n      if (!this.options.builtInResolver) {\n        return;\n      }\n\n      const { unresolvedModules } = this.options.builtInResolver;\n      if (unresolvedModules.size === 0) {\n        return;\n      }\n\n      const formattedModules = new Array(...unresolvedModules)\n        .map((name) => `• ${name}`)\n        .join('\\n');\n\n      const webpackError = new WebpackError(\n        `The snap attempted to use one or more Node.js builtins, but no browser fallback has been provided. The MetaMask Snaps CLI does not support Node.js builtins by default. If you want to use this module, you must set ${bold(\n          '`polyfills`',\n        )} to ${bold(\n          '`true`',\n        )} or an object with the builtins to polyfill as the key and ${bold(\n          '`true`',\n        )} as the value. To disable this warning, set ${bold(\n          '`stats.builtIns`',\n        )} to ${bold(\n          '`false`',\n        )} in your snap config file, or add the module to the ${bold(\n          '`stats.builtIns.ignore`',\n        )} array.`,\n      );\n\n      webpackError.details = formattedModules;\n      compilation.warnings.push(webpackError);\n    });\n  }\n\n  /**\n   * Check if the given instance is a `ProvidePlugin`. This is not guaranteed to\n   * be accurate, but it's good enough for our purposes. If we were to use\n   * `instanceof` instead, it might not work if multiple versions of Webpack are\n   * installed.\n   *\n   * @param instance - The instance to check.\n   * @returns Whether the instance is a `ProvidePlugin`, i.e., whether it's an\n   * object with the name `ProvidePlugin` and a `definitions` property.\n   */\n  #isProvidePlugin(instance: unknown): instance is ProvidePlugin {\n    return (\n      isObject(instance) &&\n      instance.constructor.name === 'ProvidePlugin' &&\n      hasProperty(instance, 'definitions')\n    );\n  }\n\n  /**\n   * Check if the `Buffer` global is used, but not provided by Webpack's\n   * `DefinePlugin`.\n   *\n   * @param compiler - The Webpack compiler.\n   */\n  #checkBuffer(compiler: Compiler) {\n    const plugin = compiler.options.plugins?.find((instance) =>\n      this.#isProvidePlugin(instance),\n    ) as ProvidePlugin | undefined;\n\n    // If the `ProvidePlugin` is configured to provide `Buffer`, then we don't\n    // need to warn the user.\n    if (plugin) {\n      const { definitions } = plugin;\n      if (definitions.Buffer) {\n        return;\n      }\n    }\n\n    compiler.hooks.compilation.tap(this.constructor.name, (compilation) => {\n      compilation.hooks.afterProcessAssets.tap(\n        this.constructor.name,\n        (assets) => {\n          // Check if assets use `Buffer`.\n          const bufferAssets = Object.entries(assets)\n            .filter(([name]) => name.endsWith('.js'))\n            .filter(([, asset]) => asset.source().includes('Buffer'));\n\n          if (bufferAssets.length === 0) {\n            return;\n          }\n\n          compilation.warnings.push(\n            new WebpackError(\n              `The snap attempted to use the Node.js Buffer global, which is not supported in the MetaMask Snaps CLI by default. To use the Buffer global, you must polyfill Buffer by setting ${bold(\n                '`buffer`',\n              )} to ${bold('`true`')} in the ${bold(\n                '`polyfills`',\n              )} config object in your snap config. To disable this warning, set ${bold(\n                '`stats.buffer`',\n              )} to ${bold('`false`')} in your snap config file.`,\n            ),\n          );\n        },\n      );\n    });\n  }\n}\n"]}

package/dist/{types/webpack/plugins.d.ts → webpack/plugins.d.cts}

@@ -1,5 +1,5 @@
-import type { Ora } from 'ora';
-import type { Compiler, ResolvePluginInstance, Resolver, WebpackPluginInstance } from 'webpack';
+import type { Ora } from "ora/index.js";
+import type { Compiler, ResolvePluginInstance, Resolver, WebpackPluginInstance } from "webpack";
 export type SnapsStatsPluginOptions = {
     /**
      * Whether to log the verbose stats.
@@ -145,3 +145,4 @@ export declare class SnapsBundleWarningsPlugin implements WebpackPluginInstance
      */
     apply(compiler: Compiler): void;
 }
+//# sourceMappingURL=plugins.d.cts.map

package/dist/webpack/plugins.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.cts","sourceRoot":"","sources":["../../src/webpack/plugins.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,qBAAY;AAC/B,OAAO,KAAK,EACV,QAAQ,EAER,qBAAqB,EACrB,QAAQ,EAER,qBAAqB,EACtB,gBAAgB;AAOjB,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,qBAAqB;;IAC5D;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;gBAQxC,OAAO,GAAE,uBAER,EACD,OAAO,CAAC,EAAE,GAAG;IAMf;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ;CA0FzB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,qBAAqB;;IAC5D;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;gBAO9B,OAAO,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,GAAG;IAK3D;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ;CAoCzB;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;;IAChE;;OAEG;IACH,QAAQ,CAAC,iBAAiB,cAAqB;IAO/C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;gBAQ5C,OAAO,GAAE,2BAER,EACD,OAAO,CAAC,EAAE,GAAG;IAMf;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ;CA4BzB;AAED;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;;OAGG;IACH,eAAe,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AAEH,qBAAa,yBAA0B,YAAW,qBAAqB;;IACrE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,gCAAgC,CAAC;gBAGjD,OAAO,GAAE,gCAGR;IAKH;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ;CAsHzB"}

package/dist/webpack/plugins.d.mts

@@ -0,0 +1,148 @@
+import type { Ora } from "ora/index.js";
+import type { Compiler, ResolvePluginInstance, Resolver, WebpackPluginInstance } from "webpack";
+export type SnapsStatsPluginOptions = {
+    /**
+     * Whether to log the verbose stats.
+     */
+    verbose?: boolean;
+};
+/**
+ * A plugin that logs the stats after compilation. This is useful for logging
+ * the number of files compiled, and the time taken to compile them.
+ */
+export declare class SnapsStatsPlugin implements WebpackPluginInstance {
+    #private;
+    /**
+     * The options for the plugin.
+     */
+    readonly options: SnapsStatsPluginOptions;
+    constructor(options?: SnapsStatsPluginOptions, spinner?: Ora);
+    /**
+     * Apply the plugin to the Webpack compiler.
+     *
+     * @param compiler - The Webpack compiler.
+     */
+    apply(compiler: Compiler): void;
+}
+/**
+ * The options for the {@link SnapsWatchPlugin}.
+ */
+export type SnapsWatchPluginOptions = {
+    /**
+     * The bundle path. This is the file that will be evaluated, if the `evaluate`
+     * option is set.
+     */
+    bundle?: string;
+    /**
+     * Whether to evaluate the bundle. This only applies if the `bundle` option is
+     * set.
+     */
+    evaluate?: boolean;
+    /**
+     * The extra files to watch.
+     */
+    files?: string[];
+};
+/**
+ * A plugin that adds extra files to watch. This is useful for watching files
+ * that are not imported by the entry point, such as the `snap.manifest.json`
+ * file.
+ */
+export declare class SnapsWatchPlugin implements WebpackPluginInstance {
+    #private;
+    /**
+     * The options for the plugin.
+     */
+    readonly options: SnapsWatchPluginOptions;
+    constructor(options: SnapsWatchPluginOptions, spinner?: Ora);
+    /**
+     * Apply the plugin to the Webpack compiler.
+     *
+     * @param compiler - The Webpack compiler.
+     */
+    apply(compiler: Compiler): void;
+}
+/**
+ * The options for the {@link SnapsBuiltInResolver}.
+ */
+export type SnapsBuiltInResolverOptions = {
+    /**
+     * The built-in modules to ignore.
+     */
+    ignore?: string[];
+};
+/**
+ * A plugin that logs a message when a built-in module is not resolved. The
+ * MetaMask Snaps CLI does not support built-in modules by default, and this
+ * plugin is used to warn the user when they try to import a built-in module,
+ * when no fallback is configured.
+ */
+export declare class SnapsBuiltInResolver implements ResolvePluginInstance {
+    #private;
+    /**
+     * The built-in modules that have been imported, but not resolved.
+     */
+    readonly unresolvedModules: Set<string>;
+    /**
+     * The options for the plugin.
+     */
+    readonly options: SnapsBuiltInResolverOptions;
+    constructor(options?: SnapsBuiltInResolverOptions, spinner?: Ora);
+    /**
+     * Apply the plugin to the Webpack resolver.
+     *
+     * @param resolver - The Webpack resolver.
+     */
+    apply(resolver: Resolver): void;
+}
+/**
+ * The options for the {@link SnapsBundleWarningsPlugin}.
+ */
+export type SnapsBundleWarningsPluginOptions = {
+    /**
+     * The {@link SnapsBuiltInResolver} instance to use for detecting built-in
+     * modules.
+     */
+    builtInResolver?: SnapsBuiltInResolver | false;
+    /**
+     * Whether to show warnings if built-in modules are used, but not provided by
+     * Webpack's `fallback` configuration.
+     */
+    builtIns?: boolean;
+    /**
+     * Whether to show warnings if the `Buffer` global is used, but not provided
+     * by Webpack's `DefinePlugin`.
+     */
+    buffer?: boolean;
+};
+/**
+ * A plugin that logs a message when:
+ *
+ * - A built-in module is not resolved. The MetaMask Snaps CLI does not support
+ * built-in modules by default, and this plugin is used to warn the user when
+ * they try to import a built-in module, when no fallback is configured.
+ * - A snap uses the `Buffer` global. The MetaMask Snaps CLI does not support
+ * the `Buffer` global by default, and this plugin is used to warn the user when
+ * they try to use the `Buffer` global.
+ *
+ * We use both a resolver and a plugin, because the resolver is used to detect
+ * when a built-in module is imported, and the plugin is used to log a single
+ * message when the compilation is complete. We can't do everything in a single
+ * plugin, because the resolver doesn't have access to the compilation, and the
+ * plugin doesn't have access to the resolver.
+ */
+export declare class SnapsBundleWarningsPlugin implements WebpackPluginInstance {
+    #private;
+    /**
+     * The options for the plugin.
+     */
+    readonly options: SnapsBundleWarningsPluginOptions;
+    constructor(options?: SnapsBundleWarningsPluginOptions);
+    /**
+     * Apply the plugin to the Webpack compiler.
+     *
+     * @param compiler - The Webpack compiler.
+     */
+    apply(compiler: Compiler): void;
+}
+//# sourceMappingURL=plugins.d.mts.map

package/dist/webpack/plugins.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.mts","sourceRoot":"","sources":["../../src/webpack/plugins.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,qBAAY;AAC/B,OAAO,KAAK,EACV,QAAQ,EAER,qBAAqB,EACrB,QAAQ,EAER,qBAAqB,EACtB,gBAAgB;AAOjB,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,qBAAqB;;IAC5D;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;gBAQxC,OAAO,GAAE,uBAER,EACD,OAAO,CAAC,EAAE,GAAG;IAMf;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ;CA0FzB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,qBAAqB;;IAC5D;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;gBAO9B,OAAO,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,GAAG;IAK3D;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ;CAoCzB;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;;IAChE;;OAEG;IACH,QAAQ,CAAC,iBAAiB,cAAqB;IAO/C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;gBAQ5C,OAAO,GAAE,2BAER,EACD,OAAO,CAAC,EAAE,GAAG;IAMf;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ;CA4BzB;AAED;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;;OAGG;IACH,eAAe,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AAEH,qBAAa,yBAA0B,YAAW,qBAAqB;;IACrE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,gCAAgC,CAAC;gBAGjD,OAAO,GAAE,gCAGR;IAKH;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ;CAsHzB"}