ic-mops 2.1.0 → 2.2.1

package/bundle/templates/licenses/MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) <year> <copyright-owner>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bundle/templates/mops-publish.yml

@@ -0,0 +1,17 @@
+name: publish on mops
+
+on:
+  release:
+    types: [released]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: dfinity/setup-mops@v1
+        with:
+          # Make sure you set the MOPS_IDENTITY_PEM secret in your repository settings https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository
+          identity-pem: ${{ secrets.MOPS_IDENTITY_PEM }}
+      - run: mops publish

package/bundle/templates/mops-test.yml

@@ -0,0 +1,24 @@
+name: mops test
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: dfinity/setup-mops@v1
+        with:
+          mops-version: 1
+
+      - name: install mops packages
+        run: mops install
+
+      - name: run tests
+        run: mops test

package/bundle/templates/src/lib.mo

@@ -0,0 +1,15 @@
+module {
+  // This comment will not be included in the documentation
+  // Use triple slash for documentation
+
+  /// Add two natural numbers
+  ///
+  /// Example:
+  /// ```motoko
+  /// assert add(1, 2) == 3;
+  /// assert add(7, 3) == 10;
+  /// ```
+  public func add(x : Nat, y : Nat) : Nat {
+    return x + y;
+  };
+};

package/bundle/templates/test/lib.test.mo

@@ -0,0 +1,4 @@
+import { add } "../src";
+
+assert add(1, 2) == 3;
+assert add(3, 22) == 25;

package/bundle/xhr-sync-worker.js

@@ -0,0 +1,51 @@
+"use strict";
+// Persistent worker thread for handling synchronous XHR requests.
+//
+// This worker runs in a separate thread and performs async HTTP requests on behalf of the main
+// thread, which blocks on Atomics.wait() until we signal completion. A single JSDOM instance is
+// created at startup and reused across requests to avoid the ~400ms initialization cost each time.
+//
+// The signaling protocol (shared with sendSyncWorkerRequest in XMLHttpRequest-impl.js):
+// 1. Main thread sends us a SharedArrayBuffer, a MessagePort, and the serialized request config.
+// 2. We perform the XHR asynchronously.
+// 3. When done, we post the serialized response to the MessagePort, then signal the main thread
+//    by writing 1 to the SharedArrayBuffer with Atomics.store() and waking it with Atomics.notify().
+
+const { parentPort } = require("node:worker_threads");
+const { JSDOM } = require("../../../..");
+const idlUtils = require("../../../generated/idl/utils");
+
+const dom = new JSDOM();
+const IDLE_TIMEOUT_MS = 5000;
+
+let idleTimer = setTimeout(() => process.exit(0), IDLE_TIMEOUT_MS);
+idleTimer.unref();
+
+parentPort.on("message", ({ sharedBuffer, responsePort, config }) => {
+  clearTimeout(idleTimer);
+
+  const int32 = new Int32Array(sharedBuffer);
+
+  const xhr = new dom.window.XMLHttpRequest();
+  const xhrImpl = idlUtils.implForWrapper(xhr);
+  xhrImpl._adoptSerializedRequest(config);
+
+  function done() {
+    const response = xhrImpl._serializeResponse();
+    const transfer = response.responseBytes ? [response.responseBytes.buffer] : [];
+    responsePort.postMessage(response, transfer);
+    Atomics.store(int32, 0, 1);
+    Atomics.notify(int32, 0);
+
+    idleTimer = setTimeout(() => process.exit(0), IDLE_TIMEOUT_MS);
+    idleTimer.unref();
+  }
+
+  try {
+    xhr.addEventListener("loadend", done, false);
+    xhr.send(xhrImpl._body);
+  } catch (error) {
+    xhrImpl._error = error;
+    done();
+  }
+});

package/cli.ts

@@ -46,7 +46,9 @@ import {
   apiVersion,
   checkApiCompatibility,
   checkConfigFile,
+  getGlobalMocArgs,
   getNetworkFile,
+  readConfig,
   setNetwork,
   version,
 } from "./mops.js";
@@ -255,6 +257,19 @@ program
     console.log(sourcesArr.join("\n"));
   });
 
+// moc-args
+program
+  .command("moc-args")
+  .description("Print global moc compiler flags from [moc] config section")
+  .action(async () => {
+    checkConfigFile(true);
+    let config = readConfig();
+    let args = getGlobalMocArgs(config);
+    if (args.length) {
+      console.log(args.join("\n"));
+    }
+  });
+
 // search
 program
   .command("search <text>")

package/commands/bench.ts

@@ -12,7 +12,12 @@ import { filesize } from "filesize";
 import terminalSize from "terminal-size";
 import { SemVer } from "semver";
 
-import { getRootDir, readConfig, readDfxJson } from "../mops.js";
+import {
+  getGlobalMocArgs,
+  getRootDir,
+  readConfig,
+  readDfxJson,
+} from "../mops.js";
 import { parallel } from "../parallel.js";
 import { absToRel } from "./test/utils.js";
 import { getMocVersion } from "../helpers/get-moc-version.js";
@@ -138,13 +143,15 @@ export async function bench(
 
   await replica.start({ silent: options.silent });
 
+  let globalMocArgs = getGlobalMocArgs(config);
+
   if (!process.env.CI && !options.silent) {
     console.log("Deploying canisters...");
   }
 
   await parallel(os.cpus().length, files, async (file: string) => {
     try {
-      await deployBenchFile(file, options, replica);
+      await deployBenchFile(file, options, replica, globalMocArgs);
     } catch (err) {
       console.error("Unexpected error. Stopping replica...");
       await replica.stop();
@@ -267,6 +274,7 @@ async function deployBenchFile(
   file: string,
   options: BenchOptions,
   replica: BenchReplica,
+  globalMocArgs: string[],
 ): Promise<void> {
   let rootDir = getRootDir();
   let tempDir = path.join(rootDir, ".mops/.bench/", path.parse(file).name);
@@ -294,7 +302,7 @@ async function deployBenchFile(
   let mocArgs = getMocArgs(options);
   options.verbose && console.time(`build ${canisterName}`);
   await execaCommand(
-    `${mocPath} -c --idl canister.mo ${mocArgs} ${(await sources({ cwd: tempDir })).join(" ")}`,
+    `${mocPath} -c --idl canister.mo ${globalMocArgs.join(" ")} ${mocArgs} ${(await sources({ cwd: tempDir })).join(" ")}`,
     {
       cwd: tempDir,
       stdio: options.verbose ? "pipe" : ["pipe", "ignore", "pipe"],

package/commands/build.ts

@@ -6,7 +6,7 @@ import { join } from "node:path";
 import { cliError } from "../error.js";
 import { isCandidCompatible } from "../helpers/is-candid-compatible.js";
 import { CustomSection, getWasmBindings } from "../wasm.js";
-import { readConfig } from "../mops.js";
+import { getGlobalMocArgs, readConfig } from "../mops.js";
 import { CanisterConfig } from "../types.js";
 import { sourcesArgs } from "./sources.js";
 import { toolchain } from "./toolchain/index.js";
@@ -82,8 +82,8 @@ export async function build(
       "-o",
       wasmPath,
       motokoPath,
-      ...(options.extraArgs ?? []),
       ...(await sourcesArgs()).flat(),
+      ...getGlobalMocArgs(config),
     ];
     if (config.build?.args) {
       if (typeof config.build.args === "string") {
@@ -101,6 +101,7 @@ export async function build(
       }
       args.push(...canister.args);
     }
+    args.push(...(options.extraArgs ?? []));
     const isPublicCandid = true; // always true for now to reduce corner cases
     const candidVisibility = isPublicCandid ? "icp:public" : "icp:private";
     if (isPublicCandid) {

package/commands/check.ts

@@ -2,6 +2,7 @@ import { relative } from "node:path";
 import chalk from "chalk";
 import { execa } from "execa";
 import { cliError } from "../error.js";
+import { getGlobalMocArgs, readConfig } from "../mops.js";
 import { autofixMotoko } from "../helpers/autofix-motoko.js";
 import { getMocSemVer } from "../helpers/get-moc-version.js";
 import { sourcesArgs } from "./sources.js";
@@ -30,8 +31,10 @@ export async function check(
     cliError("No Motoko files specified for checking");
   }
 
+  const config = readConfig();
   const mocPath = await toolchain.bin("moc", { fallback: true });
   const sources = await sourcesArgs();
+  const globalMocArgs = getGlobalMocArgs(config);
 
   // --all-libs enables richer diagnostics with edit suggestions from moc (requires moc >= 1.3.0)
   const allLibs = supportsAllLibsFlag();
@@ -53,6 +56,7 @@ export async function check(
     "--check",
     ...(allLibs ? ["--all-libs"] : []),
     ...sources.flat(),
+    ...globalMocArgs,
     ...(options.extraArgs ?? []),
   ];
 

package/commands/test/test.ts

@@ -13,7 +13,7 @@ import { SemVer } from "semver";
 import { ActorMethod } from "@icp-sdk/core/agent";
 
 import { sources } from "../sources.js";
-import { getRootDir, readConfig } from "../../mops.js";
+import { getGlobalMocArgs, getRootDir, readConfig } from "../../mops.js";
 import { parallel } from "../../parallel.js";
 
 import { MMF1 } from "./mmf1.js";
@@ -232,6 +232,7 @@ export async function testWithReporter(
 
   let config = readConfig();
   let sourcesArr = await sources();
+  let globalMocArgs = getGlobalMocArgs(config);
 
   if (!mocPath) {
     mocPath = await toolchain.bin("moc", { fallback: true });
@@ -298,6 +299,7 @@ export async function testWithReporter(
         "--hide-warnings",
         "--error-detail=2",
         ...sourcesArr.join(" ").split(" "),
+        ...globalMocArgs,
         file,
       ].filter((x) => x);
 

package/commands/toolchain/index.ts

@@ -174,6 +174,10 @@ async function download(
   version: string,
   { silent = false, verbose = false } = {},
 ) {
+  if (version.match(FILE_PATH_REGEX)) {
+    return;
+  }
+
   let toolUtils = getToolUtils(tool);
   let logUpdate = createLogUpdate(process.stdout, { showCursor: true });
 

package/commands/watch/error-checker.ts

@@ -4,7 +4,7 @@ import os from "node:os";
 import chalk from "chalk";
 
 import { getMocPath } from "../../helpers/get-moc-path.js";
-import { getRootDir } from "../../mops.js";
+import { getGlobalMocArgs, getRootDir, readConfig } from "../../mops.js";
 import { sources } from "../sources.js";
 import { parallel } from "../../parallel.js";
 import { globMoFiles } from "./globMoFiles.js";
@@ -44,6 +44,7 @@ export class ErrorChecker {
     let rootDir = getRootDir();
     let mocPath = getMocPath();
     let deps = await sources({ cwd: rootDir });
+    let globalMocArgs = getGlobalMocArgs(readConfig());
 
     let paths = globMoFiles(rootDir);
 
@@ -54,7 +55,12 @@ export class ErrorChecker {
       try {
         await promisify(execFile)(
           mocPath,
-          ["--check", ...deps.flatMap((x) => x.split(" ")), file],
+          [
+            "--check",
+            ...deps.flatMap((x) => x.split(" ")),
+            ...globalMocArgs,
+            file,
+          ],
           { cwd: rootDir },
         );
       } catch (error: any) {

package/commands/watch/warning-checker.ts

@@ -4,7 +4,7 @@ import os from "node:os";
 import chalk from "chalk";
 
 import { getMocPath } from "../../helpers/get-moc-path.js";
-import { getRootDir } from "../../mops.js";
+import { getGlobalMocArgs, getRootDir, readConfig } from "../../mops.js";
 import { sources } from "../sources.js";
 import { ErrorChecker } from "./error-checker.js";
 import { parallel } from "../../parallel.js";
@@ -70,6 +70,7 @@ export class WarningChecker {
     let rootDir = getRootDir();
     let mocPath = getMocPath();
     let deps = await sources({ cwd: rootDir });
+    let globalMocArgs = getGlobalMocArgs(readConfig());
     let paths = globMoFiles(rootDir);
 
     this.totalFiles = paths.length;
@@ -82,7 +83,12 @@ export class WarningChecker {
 
       let { stderr } = await promisify(execFile)(
         mocPath,
-        ["--check", ...deps.flatMap((x) => x.split(" ")), file],
+        [
+          "--check",
+          ...deps.flatMap((x) => x.split(" ")),
+          ...globalMocArgs,
+          file,
+        ],
         { cwd: rootDir, signal },
       ).catch((error) => {
         if (error.code === "ABORT_ERR") {

package/dist/cli.js

@@ -32,7 +32,7 @@ import { toolchain } from "./commands/toolchain/index.js";
 import { update } from "./commands/update.js";
 import { getPrincipal, getUserProp, importPem, setUserProp, } from "./commands/user.js";
 import { watch } from "./commands/watch/watch.js";
-import { apiVersion, checkApiCompatibility, checkConfigFile, getNetworkFile, setNetwork, version, } from "./mops.js";
+import { apiVersion, checkApiCompatibility, checkConfigFile, getGlobalMocArgs, getNetworkFile, readConfig, setNetwork, version, } from "./mops.js";
 import { resolvePackages } from "./resolve-packages.js";
 import { TOOLCHAINS } from "./commands/toolchain/toolchain-utils.js";
 events.setMaxListeners(20);
@@ -193,6 +193,18 @@ program
     let sourcesArr = await sources(options);
     console.log(sourcesArr.join("\n"));
 });
+// moc-args
+program
+    .command("moc-args")
+    .description("Print global moc compiler flags from [moc] config section")
+    .action(async () => {
+    checkConfigFile(true);
+    let config = readConfig();
+    let args = getGlobalMocArgs(config);
+    if (args.length) {
+        console.log(args.join("\n"));
+    }
+});
 // search
 program
     .command("search <text>")

package/dist/commands/bench.js

@@ -11,7 +11,7 @@ import stringWidth from "string-width";
 import { filesize } from "filesize";
 import terminalSize from "terminal-size";
 import { SemVer } from "semver";
-import { getRootDir, readConfig, readDfxJson } from "../mops.js";
+import { getGlobalMocArgs, getRootDir, readConfig, readDfxJson, } from "../mops.js";
 import { parallel } from "../parallel.js";
 import { absToRel } from "./test/utils.js";
 import { getMocVersion } from "../helpers/get-moc-version.js";
@@ -95,12 +95,13 @@ export async function bench(filter = "", optionsArg = {}) {
         }
     }
     await replica.start({ silent: options.silent });
+    let globalMocArgs = getGlobalMocArgs(config);
     if (!process.env.CI && !options.silent) {
         console.log("Deploying canisters...");
     }
     await parallel(os.cpus().length, files, async (file) => {
         try {
-            await deployBenchFile(file, options, replica);
+            await deployBenchFile(file, options, replica, globalMocArgs);
         }
         catch (err) {
             console.error("Unexpected error. Stopping replica...");
@@ -191,7 +192,7 @@ function getMocArgs(options) {
     }
     return args;
 }
-async function deployBenchFile(file, options, replica) {
+async function deployBenchFile(file, options, replica, globalMocArgs) {
     let rootDir = getRootDir();
     let tempDir = path.join(rootDir, ".mops/.bench/", path.parse(file).name);
     let canisterName = path.parse(file).name;
@@ -205,7 +206,7 @@ async function deployBenchFile(file, options, replica) {
     let mocPath = getMocPath();
     let mocArgs = getMocArgs(options);
     options.verbose && console.time(`build ${canisterName}`);
-    await execaCommand(`${mocPath} -c --idl canister.mo ${mocArgs} ${(await sources({ cwd: tempDir })).join(" ")}`, {
+    await execaCommand(`${mocPath} -c --idl canister.mo ${globalMocArgs.join(" ")} ${mocArgs} ${(await sources({ cwd: tempDir })).join(" ")}`, {
         cwd: tempDir,
         stdio: options.verbose ? "pipe" : ["pipe", "ignore", "pipe"],
     });

package/dist/commands/build.js

@@ -6,7 +6,7 @@ import { join } from "node:path";
 import { cliError } from "../error.js";
 import { isCandidCompatible } from "../helpers/is-candid-compatible.js";
 import { getWasmBindings } from "../wasm.js";
-import { readConfig } from "../mops.js";
+import { getGlobalMocArgs, readConfig } from "../mops.js";
 import { sourcesArgs } from "./sources.js";
 import { toolchain } from "./toolchain/index.js";
 export const DEFAULT_BUILD_OUTPUT_DIR = ".mops/.build";
@@ -55,8 +55,8 @@ export async function build(canisterNames, options) {
             "-o",
             wasmPath,
             motokoPath,
-            ...(options.extraArgs ?? []),
             ...(await sourcesArgs()).flat(),
+            ...getGlobalMocArgs(config),
         ];
         if (config.build?.args) {
             if (typeof config.build.args === "string") {
@@ -70,6 +70,7 @@ export async function build(canisterNames, options) {
             }
             args.push(...canister.args);
         }
+        args.push(...(options.extraArgs ?? []));
         const isPublicCandid = true; // always true for now to reduce corner cases
         const candidVisibility = isPublicCandid ? "icp:public" : "icp:private";
         if (isPublicCandid) {

package/dist/commands/check.js

@@ -2,6 +2,7 @@ import { relative } from "node:path";
 import chalk from "chalk";
 import { execa } from "execa";
 import { cliError } from "../error.js";
+import { getGlobalMocArgs, readConfig } from "../mops.js";
 import { autofixMotoko } from "../helpers/autofix-motoko.js";
 import { getMocSemVer } from "../helpers/get-moc-version.js";
 import { sourcesArgs } from "./sources.js";
@@ -16,8 +17,10 @@ export async function check(files, options = {}) {
     if (fileList.length === 0) {
         cliError("No Motoko files specified for checking");
     }
+    const config = readConfig();
     const mocPath = await toolchain.bin("moc", { fallback: true });
     const sources = await sourcesArgs();
+    const globalMocArgs = getGlobalMocArgs(config);
     // --all-libs enables richer diagnostics with edit suggestions from moc (requires moc >= 1.3.0)
     const allLibs = supportsAllLibsFlag();
     if (!allLibs) {
@@ -30,6 +33,7 @@ export async function check(files, options = {}) {
         "--check",
         ...(allLibs ? ["--all-libs"] : []),
         ...sources.flat(),
+        ...globalMocArgs,
         ...(options.extraArgs ?? []),
     ];
     if (options.fix) {

package/dist/commands/test/test.js

@@ -10,7 +10,7 @@ import chokidar from "chokidar";
 import debounce from "debounce";
 import { SemVer } from "semver";
 import { sources } from "../sources.js";
-import { getRootDir, readConfig } from "../../mops.js";
+import { getGlobalMocArgs, getRootDir, readConfig } from "../../mops.js";
 import { parallel } from "../../parallel.js";
 import { MMF1 } from "./mmf1.js";
 import { absToRel, pipeMMF, pipeStderrToMMF, pipeStdoutToMMF, } from "./utils.js";
@@ -152,6 +152,7 @@ export async function testWithReporter(reporterName, filter = "", defaultMode =
     reporter.addFiles(files);
     let config = readConfig();
     let sourcesArr = await sources();
+    let globalMocArgs = getGlobalMocArgs(config);
     if (!mocPath) {
         mocPath = await toolchain.bin("moc", { fallback: true });
     }
@@ -197,6 +198,7 @@ export async function testWithReporter(reporterName, filter = "", defaultMode =
                 "--hide-warnings",
                 "--error-detail=2",
                 ...sourcesArr.join(" ").split(" "),
+                ...globalMocArgs,
                 file,
             ].filter((x) => x);
             // interpret

package/dist/commands/toolchain/index.js

@@ -136,6 +136,9 @@ async function init({ reset = false, silent = false } = {}) {
     }
 }
 async function download(tool, version, { silent = false, verbose = false } = {}) {
+    if (version.match(FILE_PATH_REGEX)) {
+        return;
+    }
     let toolUtils = getToolUtils(tool);
     let logUpdate = createLogUpdate(process.stdout, { showCursor: true });
     silent || logUpdate("Installing", tool, version);

package/dist/commands/watch/error-checker.js

@@ -3,7 +3,7 @@ import { promisify } from "node:util";
 import os from "node:os";
 import chalk from "chalk";
 import { getMocPath } from "../../helpers/get-moc-path.js";
-import { getRootDir } from "../../mops.js";
+import { getGlobalMocArgs, getRootDir, readConfig } from "../../mops.js";
 import { sources } from "../sources.js";
 import { parallel } from "../../parallel.js";
 import { globMoFiles } from "./globMoFiles.js";
@@ -31,12 +31,18 @@ export class ErrorChecker {
         let rootDir = getRootDir();
         let mocPath = getMocPath();
         let deps = await sources({ cwd: rootDir });
+        let globalMocArgs = getGlobalMocArgs(readConfig());
         let paths = globMoFiles(rootDir);
         this.totalFiles = paths.length;
         this.processedFiles = 0;
         await parallel(os.cpus().length, paths, async (file) => {
             try {
-                await promisify(execFile)(mocPath, ["--check", ...deps.flatMap((x) => x.split(" ")), file], { cwd: rootDir });
+                await promisify(execFile)(mocPath, [
+                    "--check",
+                    ...deps.flatMap((x) => x.split(" ")),
+                    ...globalMocArgs,
+                    file,
+                ], { cwd: rootDir });
             }
             catch (error) {
                 error.message.split("\n").forEach((line) => {

package/dist/commands/watch/warning-checker.js

@@ -3,7 +3,7 @@ import { promisify } from "node:util";
 import os from "node:os";
 import chalk from "chalk";
 import { getMocPath } from "../../helpers/get-moc-path.js";
-import { getRootDir } from "../../mops.js";
+import { getGlobalMocArgs, getRootDir, readConfig } from "../../mops.js";
 import { sources } from "../sources.js";
 import { parallel } from "../../parallel.js";
 import { globMoFiles } from "./globMoFiles.js";
@@ -51,6 +51,7 @@ export class WarningChecker {
         let rootDir = getRootDir();
         let mocPath = getMocPath();
         let deps = await sources({ cwd: rootDir });
+        let globalMocArgs = getGlobalMocArgs(readConfig());
         let paths = globMoFiles(rootDir);
         this.totalFiles = paths.length;
         this.processedFiles = 0;
@@ -58,7 +59,12 @@ export class WarningChecker {
             let controller = new AbortController();
             let { signal } = controller;
             this.controllers.set(file, controller);
-            let { stderr } = await promisify(execFile)(mocPath, ["--check", ...deps.flatMap((x) => x.split(" ")), file], { cwd: rootDir, signal }).catch((error) => {
+            let { stderr } = await promisify(execFile)(mocPath, [
+                "--check",
+                ...deps.flatMap((x) => x.split(" ")),
+                ...globalMocArgs,
+                file,
+            ], { cwd: rootDir, signal }).catch((error) => {
                 if (error.code === "ABORT_ERR") {
                     return { stderr: "" };
                 }

package/dist/error.d.ts

@@ -1 +1 @@
-export declare function cliError(...args: unknown[]): void;
+export declare function cliError(...args: unknown[]): never;