@metamask/snaps-cli 6.3.0 → 6.3.2

package/dist/webpack/utils.d.mts

@@ -0,0 +1,259 @@
+/// <reference types="browserify" />
+import type { Ora } from "ora/index.js";
+import type { Configuration } from "webpack";
+import type { ProcessedWebpackConfig } from "../config.mjs";
+export declare const BROWSERSLIST_FILE: string;
+export declare const WEBPACK_FALLBACKS: {
+    assert: string;
+    buffer: string;
+    console: string;
+    constants: string;
+    crypto: string;
+    domain: string;
+    events: string;
+    http: string;
+    https: string;
+    os: string;
+    path: string;
+    punycode: string;
+    process: string;
+    querystring: string;
+    stream: string;
+    _stream_duplex: string;
+    _stream_passthrough: string;
+    _stream_readable: string;
+    _stream_transform: string;
+    _stream_writable: string;
+    string_decoder: string;
+    sys: string;
+    timers: string;
+    tty: string;
+    url: string;
+    util: string;
+    vm: string;
+    zlib: string;
+};
+/**
+ * Get the default loader for JavaScript and TypeScript files, based on the
+ * config object.
+ *
+ * - If the `legacy` option is set, we use the custom `browserify` loader. This
+ * uses the legacy Browserify config to transpile the code.
+ * - Otherwise, we use the `swc-loader`. This is a Webpack loader that uses the
+ * `SWC` compiler, which is a much faster alternative to Babel and TypeScript's
+ * own compiler.
+ *
+ * @param config - The processed snap Webpack config.
+ * @param config.legacy - The legacy config object, if any.
+ * @param config.sourceMap - Whether to generate source maps.
+ * @see https://swc.rs/docs/usage/swc-loader
+ * @returns The default loader.
+ */
+export declare function getDefaultLoader({ legacy, sourceMap, }: ProcessedWebpackConfig): Promise<{
+    loader: string;
+    options: {
+        fn: import("webpack").LoaderDefinitionFunction<{
+            transpilationMode: import("../builders").TranspilationModes.LocalAndDeps;
+            depsToTranspile: string[];
+            writeManifest: boolean;
+            bundlerCustomizer?: ((bundler: import("browserify").BrowserifyObject) => void) | undefined;
+        } | {
+            transpilationMode: import("../builders").TranspilationModes.LocalOnly | import("../builders").TranspilationModes.None;
+            depsToTranspile: unknown[];
+            writeManifest: boolean;
+            bundlerCustomizer?: ((bundler: import("browserify").BrowserifyObject) => void) | undefined;
+        }, {}>;
+    } & ({
+        transpilationMode: import("../builders").TranspilationModes.LocalAndDeps;
+        depsToTranspile: string[];
+        writeManifest: boolean;
+        bundlerCustomizer?: ((bundler: import("browserify").BrowserifyObject) => void) | undefined;
+    } | {
+        transpilationMode: import("../builders").TranspilationModes.LocalOnly | import("../builders").TranspilationModes.None;
+        depsToTranspile: unknown[];
+        writeManifest: boolean;
+        bundlerCustomizer?: ((bundler: import("browserify").BrowserifyObject) => void) | undefined;
+    });
+} | {
+    /**
+     * We use the `swc-loader` to transpile TypeScript and JavaScript files.
+     * This is a Webpack loader that uses the `SWC` compiler, which is a much
+     * faster alternative to Babel and TypeScript's own compiler.
+     */
+    loader: string;
+    /**
+     * The options for the `swc-loader`. These can be overridden in the
+     * `.swcrc` file.
+     *
+     * @see https://swc.rs/docs/configuration/swcrc
+     */
+    options: {
+        sync: boolean;
+        /**
+         * This tells SWC to generate source maps. We set it to the
+         * `sourceMap` value from the config object.
+         *
+         * This must be enabled if source maps are enabled in the config.
+         */
+        sourceMaps: boolean;
+        jsc: {
+            parser: {
+                /**
+                 * This tells the parser to parse TypeScript files. If you
+                 * don't need to support TypeScript, you can set this to
+                 * `ecmascript` instead, but there's no harm in leaving it
+                 * as `typescript`.
+                 *
+                 * @see https://swc.rs/docs/configuration/compilation#jscparser
+                 */
+                syntax: string;
+                /**
+                 * This tells the parser to transpile JSX.
+                 *
+                 * @see https://swc.rs/docs/configuration/compilation#jscparser
+                 * @see https://swc.rs/docs/configuration/compilation#jscparserjsx
+                 */
+                tsx: boolean;
+            };
+            transform: {
+                react: {
+                    /**
+                     * This tells SWC to use the JSX runtime, instead of the
+                     * `createElement` function.
+                     *
+                     * @see https://swc.rs/docs/configuration/compilation#jsctransformreact
+                     */
+                    runtime: string;
+                    /**
+                     * This tells SWC to import the JSX runtime from the
+                     * `@metamask/snaps-sdk` package, instead of the default React
+                     * package.
+                     *
+                     * @see https://swc.rs/docs/configuration/compilation#jsctransformreact
+                     */
+                    importSource: string;
+                    /**
+                     * This tells SWC to use `Object.assign` and `Object.create` for
+                     * JSX spread attributes, instead of the default behavior.
+                     *
+                     * @see https://swc.rs/docs/configuration/compilation#jsctransformreact
+                     */
+                    useBuiltins: boolean;
+                };
+            };
+        };
+        /**
+         * The module configuration. This tells SWC how to output the
+         * transpiled code.
+         *
+         * @see https://swc.rs/docs/configuration/modules
+         */
+        module: {
+            /**
+             * This tells SWC to output ES6 modules. This will allow Webpack to
+             * optimize the output code better. Snaps don't support ES6 however, so
+             * the output code will be transpiled to CommonJS by Webpack later in
+             * the build process.
+             *
+             * @see https://swc.rs/docs/configuration/modules#es6
+             */
+            type: string;
+        };
+        env: {
+            targets: string;
+        };
+    };
+}>;
+/**
+ * Get the Webpack devtool configuration based on the given snap config.
+ *
+ * - If `sourceMap` is `inline`, return `inline-source-map`.
+ * - If `sourceMap` is `true`, return `source-map`.
+ * - Otherwise, return `false`.
+ *
+ * @param sourceMap - The `sourceMap` value from the snap config.
+ * @returns The Webpack devtool configuration.
+ */
+export declare function getDevTool(sourceMap: ProcessedWebpackConfig['sourceMap']): Configuration['devtool'];
+/**
+ * Get a function that can be used as handler function for Webpack's
+ * `ProgressPlugin`.
+ *
+ * @param spinner - The spinner to update.
+ * @param spinnerText - The initial spinner text. This will be prepended to the
+ * percentage.
+ * @returns A function that can be used as handler function for Webpack's
+ * `ProgressPlugin`.
+ */
+export declare function getProgressHandler(spinner?: Ora, spinnerText?: string): (percentage: number) => void;
+/**
+ * Get the targets from the `.browserslistrc` file.
+ *
+ * @returns The browser targets as an array of strings.
+ */
+export declare function getBrowserslistTargets(): Promise<string[]>;
+/**
+ * Get a singular or plural string based on the given count. This is useful for
+ * generating messages like "1 error" or "2 errors". By default, the plural
+ * string is the singular string with an "s" appended to it.
+ *
+ * This assumes that the text is in English, and likely won't work for some
+ * other languages.
+ *
+ * @param count - The count.
+ * @param singular - The singular string.
+ * @param plural - The plural string.
+ * @returns The singular or plural string.
+ * @example
+ * ```typescript
+ * pluralize(1, 'error'); // => 'error'
+ * pluralize(2, 'error'); // => 'errors'
+ * pluralize(1, 'error', 'problem'); // => 'error'
+ * pluralize(2, 'error', 'problems'); // => 'problems'
+ * ```
+ */
+export declare function pluralize(count: number, singular: string, plural?: string): string;
+/**
+ * Get an object that can be used as fallback config for Webpack's
+ * `fallback` config.
+ *
+ * @param polyfills - The polyfill object from the snap config.
+ * @returns The webpack fallback config.
+ */
+export declare function getFallbacks(polyfills: ProcessedWebpackConfig['polyfills']): {
+    [index: string]: string | false;
+};
+/**
+ * Get an object that can be used as environment variables for Webpack's
+ * `DefinePlugin`.
+ *
+ * @param environment - The environment object from the Snap config.
+ * @param defaults - The default environment variables.
+ * @returns The Webpack environment variables.
+ */
+export declare function getEnvironmentVariables(environment: Record<string, unknown>, defaults?: {
+    NODE_DEBUG: string;
+    NODE_ENV: string;
+    DEBUG: string;
+}): {
+    [k: string]: string;
+};
+/**
+ * Format the given text to fit within the terminal width.
+ *
+ * @param text - The text to format.
+ * @param indent - The indentation to use.
+ * @param initialIndent - The initial indentation to use, i.e., the indentation
+ * for the first line.
+ * @returns The formatted text.
+ */
+export declare function formatText(text: string, indent: number, initialIndent?: number): string;
+/**
+ * Get an SVG from the given bytes and mime type.
+ *
+ * @param mimeType - The mime type of the image.
+ * @param bytes - The image bytes.
+ * @returns The SVG.
+ */
+export declare function getImageSVG(mimeType: string, bytes: Uint8Array): string;
+//# sourceMappingURL=utils.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/webpack/utils.ts"],"names":[],"mappings":";AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,qBAAY;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB;AAE7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAkB;AAGxD,eAAO,MAAM,iBAAiB,QAM7B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC7B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,MAAM,EACN,SAAS,GACV,EAAE,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;IAarB;;;;OAIG;;IAGH;;;;;OAKG;;;QAID;;;;;WAKG;;;;gBAKC;;;;;;;mBAOG;;gBAGH;;;;;mBAKG;;;;;oBAMD;;;;;uBAKG;;oBAGH;;;;;;uBAMG;;oBAGH;;;;;uBAKG;;;;;QAMT;;;;;WAKG;;YAED;;;;;;;eAOG;;;;;;;GASV;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC,GAC7C,aAAa,CAAC,SAAS,CAAC,CAU1B;AAED;;;;;;;;;GASG;AAEH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,gBAChD,MAAM,UAO3B;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,sBAM3C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAiB,UAGxB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC,GAAG;IAC5E,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;CACjC,CAsBA;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ;;;;CAIP;;EAQF;AAiDD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,aAAa,SAAS,UAWvB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,UAG9D"}

package/dist/webpack/utils.mjs

@@ -1,39 +1,352 @@
-import {
-  BROWSERSLIST_FILE,
-  WEBPACK_FALLBACKS,
-  formatText,
-  getBrowserslistTargets,
-  getDefaultLoader,
-  getDevTool,
-  getEnvironmentVariables,
-  getFallbacks,
-  getImageSVG,
-  getProgressHandler,
-  pluralize
-} from "../chunk-V6SYDSWM.mjs";
-import "../chunk-AZMQTZXZ.mjs";
-import "../chunk-ERSRIVYH.mjs";
-import "../chunk-JL3URCHO.mjs";
-import "../chunk-L72RLBV5.mjs";
-import "../chunk-QMD3VO6R.mjs";
-import "../chunk-TDSL55B3.mjs";
-import "../chunk-YCYGKEXF.mjs";
-import "../chunk-7RHK2YTB.mjs";
-import "../chunk-ZAW4ZWQX.mjs";
-import "../chunk-MR44GPM3.mjs";
-import "../chunk-X7TESUC7.mjs";
-import "../chunk-R77RJHC5.mjs";
-export {
-  BROWSERSLIST_FILE,
-  WEBPACK_FALLBACKS,
-  formatText,
-  getBrowserslistTargets,
-  getDefaultLoader,
-  getDevTool,
-  getEnvironmentVariables,
-  getFallbacks,
-  getImageSVG,
-  getProgressHandler,
-  pluralize
+function $importDefault(module) {
+    if (module?.__esModule) {
+        return module.default;
+    }
+    return module;
+}
+import { bytesToBase64 } from "@metamask/utils";
+import $chalk from "chalk";
+const { dim } = $chalk;
+import { promises as fs } from "fs";
+import { builtinModules } from "module";
+import { dirname, resolve } from "path";
+import $stripAnsi from "strip-ansi/index.js";
+const stripAnsi = $importDefault($stripAnsi);
+import { browserify, getFunctionLoader } from "./loaders/index.mjs";
+export const BROWSERSLIST_FILE = resolve(dirname(
+// eslint-disable-next-line n/no-extraneous-require
+require.resolve('@metamask/snaps-cli/package.json')), '.browserslistrc');
+export const WEBPACK_FALLBACKS = {
+    assert: require.resolve('assert/'),
+    buffer: require.resolve('buffer/'),
+    console: require.resolve('console-browserify'),
+    constants: require.resolve('constants-browserify'),
+    crypto: require.resolve('crypto-browserify'),
+    domain: require.resolve('domain-browser'),
+    events: require.resolve('events/'),
+    http: require.resolve('stream-http'),
+    https: require.resolve('https-browserify'),
+    os: require.resolve('os-browserify/browser'),
+    path: require.resolve('path-browserify'),
+    punycode: require.resolve('punycode/'),
+    process: require.resolve('process/browser'),
+    querystring: require.resolve('querystring-es3'),
+    stream: require.resolve('stream-browserify'),
+    /* eslint-disable @typescript-eslint/naming-convention  */
+    _stream_duplex: require.resolve('readable-stream/lib/_stream_duplex'),
+    _stream_passthrough: require.resolve('readable-stream/lib/_stream_passthrough'),
+    _stream_readable: require.resolve('readable-stream/lib/_stream_readable'),
+    _stream_transform: require.resolve('readable-stream/lib/_stream_transform'),
+    _stream_writable: require.resolve('readable-stream/lib/_stream_writable'),
+    string_decoder: require.resolve('string_decoder/'),
+    /* eslint-enable @typescript-eslint/naming-convention  */
+    sys: require.resolve('util/'),
+    timers: require.resolve('timers-browserify'),
+    tty: require.resolve('tty-browserify'),
+    url: require.resolve('url/'),
+    util: require.resolve('util/'),
+    vm: require.resolve('vm-browserify'),
+    zlib: require.resolve('browserify-zlib'),
 };
+/**
+ * Get the default loader for JavaScript and TypeScript files, based on the
+ * config object.
+ *
+ * - If the `legacy` option is set, we use the custom `browserify` loader. This
+ * uses the legacy Browserify config to transpile the code.
+ * - Otherwise, we use the `swc-loader`. This is a Webpack loader that uses the
+ * `SWC` compiler, which is a much faster alternative to Babel and TypeScript's
+ * own compiler.
+ *
+ * @param config - The processed snap Webpack config.
+ * @param config.legacy - The legacy config object, if any.
+ * @param config.sourceMap - Whether to generate source maps.
+ * @see https://swc.rs/docs/usage/swc-loader
+ * @returns The default loader.
+ */
+export async function getDefaultLoader({ legacy, sourceMap, }) {
+    if (legacy) {
+        /**
+         * If the snap uses the legacy config, we use the custom `browserify`
+         * loader. This uses the legacy Browserify config to transpile the code.
+         * This is necessary for backwards compatibility with the
+         * `bundlerCustomizer` function.
+         */
+        return getFunctionLoader(browserify, legacy);
+    }
+    const targets = await getBrowserslistTargets();
+    return {
+        /**
+         * We use the `swc-loader` to transpile TypeScript and JavaScript files.
+         * This is a Webpack loader that uses the `SWC` compiler, which is a much
+         * faster alternative to Babel and TypeScript's own compiler.
+         */
+        loader: require.resolve('swc-loader'),
+        /**
+         * The options for the `swc-loader`. These can be overridden in the
+         * `.swcrc` file.
+         *
+         * @see https://swc.rs/docs/configuration/swcrc
+         */
+        options: {
+            sync: false,
+            /**
+             * This tells SWC to generate source maps. We set it to the
+             * `sourceMap` value from the config object.
+             *
+             * This must be enabled if source maps are enabled in the config.
+             */
+            sourceMaps: Boolean(getDevTool(sourceMap)),
+            jsc: {
+                parser: {
+                    /**
+                     * This tells the parser to parse TypeScript files. If you
+                     * don't need to support TypeScript, you can set this to
+                     * `ecmascript` instead, but there's no harm in leaving it
+                     * as `typescript`.
+                     *
+                     * @see https://swc.rs/docs/configuration/compilation#jscparser
+                     */
+                    syntax: 'typescript',
+                    /**
+                     * This tells the parser to transpile JSX.
+                     *
+                     * @see https://swc.rs/docs/configuration/compilation#jscparser
+                     * @see https://swc.rs/docs/configuration/compilation#jscparserjsx
+                     */
+                    tsx: true,
+                },
+                transform: {
+                    react: {
+                        /**
+                         * This tells SWC to use the JSX runtime, instead of the
+                         * `createElement` function.
+                         *
+                         * @see https://swc.rs/docs/configuration/compilation#jsctransformreact
+                         */
+                        runtime: 'automatic',
+                        /**
+                         * This tells SWC to import the JSX runtime from the
+                         * `@metamask/snaps-sdk` package, instead of the default React
+                         * package.
+                         *
+                         * @see https://swc.rs/docs/configuration/compilation#jsctransformreact
+                         */
+                        importSource: '@metamask/snaps-sdk',
+                        /**
+                         * This tells SWC to use `Object.assign` and `Object.create` for
+                         * JSX spread attributes, instead of the default behavior.
+                         *
+                         * @see https://swc.rs/docs/configuration/compilation#jsctransformreact
+                         */
+                        useBuiltins: true,
+                    },
+                },
+            },
+            /**
+             * The module configuration. This tells SWC how to output the
+             * transpiled code.
+             *
+             * @see https://swc.rs/docs/configuration/modules
+             */
+            module: {
+                /**
+                 * This tells SWC to output ES6 modules. This will allow Webpack to
+                 * optimize the output code better. Snaps don't support ES6 however, so
+                 * the output code will be transpiled to CommonJS by Webpack later in
+                 * the build process.
+                 *
+                 * @see https://swc.rs/docs/configuration/modules#es6
+                 */
+                type: 'es6',
+            },
+            env: {
+                targets: targets.join(', '),
+            },
+        },
+    };
+}
+/**
+ * Get the Webpack devtool configuration based on the given snap config.
+ *
+ * - If `sourceMap` is `inline`, return `inline-source-map`.
+ * - If `sourceMap` is `true`, return `source-map`.
+ * - Otherwise, return `false`.
+ *
+ * @param sourceMap - The `sourceMap` value from the snap config.
+ * @returns The Webpack devtool configuration.
+ */
+export function getDevTool(sourceMap) {
+    if (sourceMap === 'inline') {
+        return 'inline-source-map';
+    }
+    if (sourceMap === true) {
+        return 'source-map';
+    }
+    return false;
+}
+/**
+ * Get a function that can be used as handler function for Webpack's
+ * `ProgressPlugin`.
+ *
+ * @param spinner - The spinner to update.
+ * @param spinnerText - The initial spinner text. This will be prepended to the
+ * percentage.
+ * @returns A function that can be used as handler function for Webpack's
+ * `ProgressPlugin`.
+ */
+// Note: This is extracted for testing purposes.
+export function getProgressHandler(spinner, spinnerText) {
+    return (percentage) => {
+        if (spinner && spinnerText) {
+            spinner.text = `${spinnerText} ${dim(`(${Math.round(percentage * 100)}%)`)}`;
+        }
+    };
+}
+/**
+ * Get the targets from the `.browserslistrc` file.
+ *
+ * @returns The browser targets as an array of strings.
+ */
+export async function getBrowserslistTargets() {
+    const contents = await fs.readFile(BROWSERSLIST_FILE, 'utf8');
+    return contents
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith('#'));
+}
+/**
+ * Get a singular or plural string based on the given count. This is useful for
+ * generating messages like "1 error" or "2 errors". By default, the plural
+ * string is the singular string with an "s" appended to it.
+ *
+ * This assumes that the text is in English, and likely won't work for some
+ * other languages.
+ *
+ * @param count - The count.
+ * @param singular - The singular string.
+ * @param plural - The plural string.
+ * @returns The singular or plural string.
+ * @example
+ * ```typescript
+ * pluralize(1, 'error'); // => 'error'
+ * pluralize(2, 'error'); // => 'errors'
+ * pluralize(1, 'error', 'problem'); // => 'error'
+ * pluralize(2, 'error', 'problems'); // => 'problems'
+ * ```
+ */
+export function pluralize(count, singular, plural = `${singular}s`) {
+    return count === 1 ? singular : plural;
+}
+/**
+ * Get an object that can be used as fallback config for Webpack's
+ * `fallback` config.
+ *
+ * @param polyfills - The polyfill object from the snap config.
+ * @returns The webpack fallback config.
+ */
+export function getFallbacks(polyfills) {
+    if (polyfills === true) {
+        return Object.fromEntries(builtinModules.map((name) => [
+            name,
+            WEBPACK_FALLBACKS[name] ?? false,
+        ]));
+    }
+    if (polyfills === false) {
+        return Object.fromEntries(builtinModules.map((name) => [name, false]));
+    }
+    return Object.fromEntries(builtinModules.map((name) => [
+        name,
+        polyfills[name]
+            ? WEBPACK_FALLBACKS[name]
+            : false,
+    ]));
+}
+/**
+ * Get an object that can be used as environment variables for Webpack's
+ * `DefinePlugin`.
+ *
+ * @param environment - The environment object from the Snap config.
+ * @param defaults - The default environment variables.
+ * @returns The Webpack environment variables.
+ */
+export function getEnvironmentVariables(environment, defaults = {
+    NODE_DEBUG: 'false',
+    NODE_ENV: 'production',
+    DEBUG: 'false',
+}) {
+    return Object.fromEntries(Object.entries({
+        ...defaults,
+        ...environment,
+    }).map(([key, value]) => [`process.env.${key}`, JSON.stringify(value)]));
+}
+/**
+ * Format the given line to fit within the terminal width.
+ *
+ * @param line - The line to format.
+ * @param indent - The indentation to use.
+ * @param initialIndent - The initial indentation to use, i.e., the indentation
+ * for the first line.
+ * @returns The formatted line.
+ */
+function formatLine(line, indent, initialIndent) {
+    const terminalWidth = process.stdout.columns;
+    if (!terminalWidth) {
+        return `${' '.repeat(initialIndent)}${line}`;
+    }
+    return line.split(' ').reduce(({ formattedText, currentLineLength }, word, index) => {
+        // `chalk` adds ANSI escape codes to the text, which are not visible
+        // characters. We need to strip them to get the visible length of the
+        // text.
+        const visibleWord = stripAnsi(word);
+        // Determine if a space should be added before the word.
+        const spaceBeforeWord = index > 0 ? ' ' : '';
+        const wordLengthWithSpace = visibleWord.length + spaceBeforeWord.length;
+        // If the word would exceed the terminal width, start a new line.
+        if (currentLineLength + wordLengthWithSpace > terminalWidth) {
+            return {
+                formattedText: `${formattedText}\n${' '.repeat(indent)}${word}`,
+                currentLineLength: indent + visibleWord.length,
+            };
+        }
+        // Otherwise, add the word to the current line.
+        return {
+            formattedText: formattedText + spaceBeforeWord + word,
+            currentLineLength: currentLineLength + wordLengthWithSpace,
+        };
+    }, {
+        formattedText: ' '.repeat(initialIndent),
+        currentLineLength: initialIndent,
+    }).formattedText;
+}
+/**
+ * Format the given text to fit within the terminal width.
+ *
+ * @param text - The text to format.
+ * @param indent - The indentation to use.
+ * @param initialIndent - The initial indentation to use, i.e., the indentation
+ * for the first line.
+ * @returns The formatted text.
+ */
+export function formatText(text, indent, initialIndent = indent) {
+    const lines = text.split('\n');
+    // Apply formatting to each line separately and then join them.
+    return lines
+        .map((line, index) => {
+        const lineIndent = index === 0 ? initialIndent : indent;
+        return formatLine(line, indent, lineIndent);
+    })
+        .join('\n');
+}
+/**
+ * Get an SVG from the given bytes and mime type.
+ *
+ * @param mimeType - The mime type of the image.
+ * @param bytes - The image bytes.
+ * @returns The SVG.
+ */
+export function getImageSVG(mimeType, bytes) {
+    const dataUrl = `data:${mimeType};base64,${bytesToBase64(bytes)}`;
+    return `<svg xmlns="http://www.w3.org/2000/svg"><image href="${dataUrl}" /></svg>`;
+}
 //# sourceMappingURL=utils.mjs.map