@mnaoumov/typescript-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/function.cjs

@@ -0,0 +1,141 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+function keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var function_exports = {};
+__export(function_exports, {
+  cloneFunction: () => cloneFunction,
+  createFunction: () => createFunction,
+  getFunctionExpressionString: () => getFunctionExpressionString,
+  noop: () => noop,
+  noopAsync: () => noopAsync,
+  noopAsyncSingletonPromise: () => noopAsyncSingletonPromise,
+  omitAsyncReturnType: () => omitAsyncReturnType,
+  omitReturnType: () => omitReturnType
+});
+module.exports = __toCommonJS(function_exports);
+function getFunctionExpressionString($function) {
+  const functionString = $function.toString();
+  if (FUNCTION_EXPRESSION_RE.test(functionString)) {
+    return functionString;
+  }
+  const asyncMatch = ASYNC_KEYWORD_RE.exec(functionString);
+  return asyncMatch ? `async function ${functionString.slice(asyncMatch[0].length)}` : `function ${functionString}`;
+}
+function noop() {
+}
+const noopAsyncSingletonPromise = Promise.resolve();
+function noopAsync() {
+  return noopAsyncSingletonPromise;
+}
+function omitAsyncReturnType($function) {
+  return async (...$arguments) => {
+    await $function(...$arguments);
+  };
+}
+const FUNCTION_EXPRESSION_RE = /^(?:function\b|async\b\s*(?:function\b|\()|\()/;
+const ASYNC_KEYWORD_RE = /^async\b\s*/;
+function cloneFunction($function) {
+  return clonedFunction;
+  function clonedFunction(...$arguments) {
+    return $function.apply(this, $arguments);
+  }
+}
+function createFunction(params) {
+  const argumentNames = params.argumentNames ?? [];
+  return new Function(...argumentNames, params.functionBody);
+}
+function omitReturnType($function) {
+  return (...$arguments) => {
+    $function(...$arguments);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cloneFunction,
+  createFunction,
+  getFunctionExpressionString,
+  noop,
+  noopAsync,
+  noopAsyncSingletonPromise,
+  omitAsyncReturnType,
+  omitReturnType
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Z1bmN0aW9uLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgYW5kIHR5cGVzIGZvciB3b3JraW5nIHdpdGggZnVuY3Rpb25zLlxuICovXG5cbmltcG9ydCB0eXBlIHsgUHJvbWlzYWJsZSB9IGZyb20gJ3R5cGUtZmVzdCc7XG5cbi8qKlxuICogUmVwcmVzZW50cyBhIGdlbmVyaWMgYXN5bmMgZnVuY3Rpb24uXG4gKlxuICogQHR5cGVQYXJhbSBBcmd1bWVudHMgLSBUaGUgYXJndW1lbnRzIG9mIHRoZSBmdW5jdGlvbi5cbiAqIEB0eXBlUGFyYW0gUmV0dXJuIC0gVGhlIGF3YWl0ZWQgcmV0dXJuIHR5cGUgb2YgdGhlIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgdHlwZSBHZW5lcmljQXN5bmNGdW5jdGlvbjxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10gPSBuZXZlcltdLCBSZXR1cm4gPSB1bmtub3duPiA9IEdlbmVyaWNGdW5jdGlvbjxBcmd1bWVudHMsIFByb21pc2U8UmV0dXJuPj47XG5cbi8qKlxuICogUmVwcmVzZW50cyBhIGdlbmVyaWMgYXN5bmMgdm9pZCBmdW5jdGlvbi5cbiAqXG4gKiBAdHlwZVBhcmFtIEFyZ3VtZW50cyAtIFRoZSBhcmd1bWVudHMgb2YgdGhlIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgdHlwZSBHZW5lcmljQXN5bmNWb2lkRnVuY3Rpb248QXJndW1lbnRzIGV4dGVuZHMgdW5rbm93bltdID0gbmV2ZXJbXT4gPSBHZW5lcmljQXN5bmNGdW5jdGlvbjxBcmd1bWVudHMsIHZvaWQ+O1xuXG4vKipcbiAqIFJlcHJlc2VudHMgYSBnZW5lcmljIGZ1bmN0aW9uLlxuICpcbiAqIEB0eXBlUGFyYW0gQXJndW1lbnRzIC0gVGhlIGFyZ3VtZW50cyBvZiB0aGUgZnVuY3Rpb24uXG4gKiBAdHlwZVBhcmFtIFJldHVybiAtIFRoZSByZXR1cm4gdHlwZSBvZiB0aGUgZnVuY3Rpb24uXG4gKi9cbmV4cG9ydCB0eXBlIEdlbmVyaWNGdW5jdGlvbjxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10gPSBuZXZlcltdLCBSZXR1cm4gPSB1bmtub3duPiA9ICguLi4kYXJndW1lbnRzOiBBcmd1bWVudHMpID0+IFJldHVybjtcblxuLyoqXG4gKiBSZXByZXNlbnRzIGEgZ2VuZXJpYyBwcm9taXNhYmxlIGZ1bmN0aW9uLlxuICpcbiAqIEB0eXBlUGFyYW0gQXJndW1lbnRzIC0gVGhlIGFyZ3VtZW50cyBvZiB0aGUgZnVuY3Rpb24uXG4gKiBAdHlwZVBhcmFtIFJldHVybiAtIFRoZSBhd2FpdGVkIHJldHVybiB0eXBlIG9mIHRoZSBmdW5jdGlvbi5cbiAqL1xuZXhwb3J0IHR5cGUgR2VuZXJpY1Byb21pc2FibGVGdW5jdGlvbjxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10gPSBuZXZlcltdLCBSZXR1cm4gPSB1bmtub3duPiA9IEdlbmVyaWNGdW5jdGlvbjxBcmd1bWVudHMsIFByb21pc2FibGU8UmV0dXJuPj47XG5cbi8qKlxuICogUmVwcmVzZW50cyBhIGdlbmVyaWMgcHJvbWlzYWJsZSB2b2lkIGZ1bmN0aW9uLlxuICpcbiAqIEB0eXBlUGFyYW0gQXJndW1lbnRzIC0gVGhlIGFyZ3VtZW50cyBvZiB0aGUgZnVuY3Rpb24uXG4gKi9cbmV4cG9ydCB0eXBlIEdlbmVyaWNQcm9taXNhYmxlVm9pZEZ1bmN0aW9uPEFyZ3VtZW50cyBleHRlbmRzIHVua25vd25bXSA9IG5ldmVyW10+ID0gR2VuZXJpY1Byb21pc2FibGVGdW5jdGlvbjxBcmd1bWVudHMsIHZvaWQ+O1xuXG4vKipcbiAqIFJlcHJlc2VudHMgYSBnZW5lcmljIHZvaWQgZnVuY3Rpb24uXG4gKlxuICogQHR5cGVQYXJhbSBBcmd1bWVudHMgLSBUaGUgYXJndW1lbnRzIG9mIHRoZSBmdW5jdGlvbi5cbiAqL1xuZXhwb3J0IHR5cGUgR2VuZXJpY1ZvaWRGdW5jdGlvbjxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10gPSBuZXZlcltdPiA9IEdlbmVyaWNGdW5jdGlvbjxBcmd1bWVudHMsIHZvaWQ+O1xuXG4vKipcbiAqIENvbnZlcnRzIGEgZnVuY3Rpb24gaW50byBhIHN0cmluZyB0aGF0IGlzIGEgdmFsaWQgZnVuY3Rpb24gZXhwcmVzc2lvbi5cbiAqXG4gKiBgRnVuY3Rpb24ucHJvdG90eXBlLnRvU3RyaW5nKClgIG9uIGEgc2hvcnRoYW5kIG1ldGhvZCBsaWtlIGB7IGZuKCkge30gfWBcbiAqIHJldHVybnMgYFwiZm4oKSB7fVwiYCwgd2hpY2ggaXMgbm90IGEgdmFsaWQgZXhwcmVzc2lvbi5cbiAqIFRoaXMgaGVscGVyIGRldGVjdHMgdGhhdCBmb3JtIGFuZCBwcmVmaXhlcyBpdCB3aXRoIGBmdW5jdGlvbiBgLlxuICpcbiAqIEBwYXJhbSAkZnVuY3Rpb24gLSBUaGUgZnVuY3Rpb24gdG8gY29udmVydC5cbiAqIEByZXR1cm5zIEEgc3RyaW5nIHRoYXQgaXMgYSB2YWxpZCBmdW5jdGlvbiBleHByZXNzaW9uLlxuICovXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVuc2FmZS1mdW5jdGlvbi10eXBlIC0tIFdlIG5lZWQgdG8gdXNlIGBGdW5jdGlvbmAgdHlwZS5cbmV4cG9ydCBmdW5jdGlvbiBnZXRGdW5jdGlvbkV4cHJlc3Npb25TdHJpbmcoJGZ1bmN0aW9uOiBGdW5jdGlvbik6IHN0cmluZyB7XG4gIGNvbnN0IGZ1bmN0aW9uU3RyaW5nID0gJGZ1bmN0aW9uLnRvU3RyaW5nKCk7XG5cbiAgaWYgKEZVTkNUSU9OX0VYUFJFU1NJT05fUkUudGVzdChmdW5jdGlvblN0cmluZykpIHtcbiAgICByZXR1cm4gZnVuY3Rpb25TdHJpbmc7XG4gIH1cblxuICBjb25zdCBhc3luY01hdGNoID0gQVNZTkNfS0VZV09SRF9SRS5leGVjKGZ1bmN0aW9uU3RyaW5nKTtcbiAgcmV0dXJuIGFzeW5jTWF0Y2ggPyBgYXN5bmMgZnVuY3Rpb24gJHtmdW5jdGlvblN0cmluZy5zbGljZShhc3luY01hdGNoWzBdLmxlbmd0aCl9YCA6IGBmdW5jdGlvbiAke2Z1bmN0aW9uU3RyaW5nfWA7XG59XG5cbi8qKlxuICogQSBmdW5jdGlvbiB0aGF0IGRvZXMgbm90aGluZy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG5vb3AoKTogdm9pZCB7XG4gIC8vIERvZXMgbm90aGluZy5cbn1cblxuLyoqXG4gKiBBIHNpbmdsZXRvbiBuby1vcCBwcm9taXNlLlxuICovXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgb2JzaWRpYW4tZGV2LXV0aWxzL3ByZWZlci1ub29wLWFzeW5jIC0tIEF2b2lkIGNpcmN1bGFyIHJlZmVyZW5jZS5cbmV4cG9ydCBjb25zdCBub29wQXN5bmNTaW5nbGV0b25Qcm9taXNlID0gUHJvbWlzZS5yZXNvbHZlKCk7XG5cbi8qKlxuICogQSBmdW5jdGlvbiB0aGF0IGRvZXMgbm90aGluZy5cbiAqXG4gKiBAcmV0dXJucyBBIHByb21pc2UgdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBmdW5jdGlvbiBpcyBjb21wbGV0ZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG5vb3BBc3luYygpOiBQcm9taXNlPHZvaWQ+IHtcbiAgcmV0dXJuIG5vb3BBc3luY1NpbmdsZXRvblByb21pc2U7XG59XG5cbi8qKlxuICogTWFrZXMgYW4gYXN5bmMgZnVuY3Rpb24gdGhhdCBjYWxscyB0aGUgb3JpZ2luYWwgYXN5bmMgZnVuY3Rpb24gd2l0aCB0aGUgcHJvdmlkZWQgYXJndW1lbnRzIGFuZCBvbWl0cyB0aGUgcmV0dXJuIHZhbHVlLlxuICpcbiAqIEB0eXBlUGFyYW0gQXJndW1lbnRzIC0gQXJndW1lbnRzIHRvIGJlIHBhc3NlZCB0byB0aGUgZnVuY3Rpb24uXG4gKiBAcGFyYW0gJGZ1bmN0aW9uIC0gRnVuY3Rpb24gdG8gYmUgY2FsbGVkLlxuICogQHJldHVybnMgQW4gYXN5bmMgZnVuY3Rpb24gdGhhdCBjYWxscyB0aGUgb3JpZ2luYWwgZnVuY3Rpb24gd2l0aCB0aGUgcHJvdmlkZWQgYXJndW1lbnRzIGFuZCBvbWl0cyB0aGUgcmV0dXJuIHZhbHVlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gb21pdEFzeW5jUmV0dXJuVHlwZTxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10+KCRmdW5jdGlvbjogR2VuZXJpY0FzeW5jRnVuY3Rpb248QXJndW1lbnRzPik6IEdlbmVyaWNBc3luY1ZvaWRGdW5jdGlvbjxBcmd1bWVudHM+IHtcbiAgcmV0dXJuIGFzeW5jICguLi4kYXJndW1lbnRzOiBBcmd1bWVudHMpID0+IHtcbiAgICBhd2FpdCAkZnVuY3Rpb24oLi4uJGFyZ3VtZW50cyk7XG4gIH07XG59XG5cbi8qKlxuICogTWF0Y2hlcyBzdHJpbmdzIHRoYXQgYXJlIGFscmVhZHkgdmFsaWQgZnVuY3Rpb24gZXhwcmVzc2lvbnM6XG4gKiAtIGBmdW5jdGlvbiAuLi5gIChrZXl3b3JkLCBub3QgaWRlbnRpZmllciBsaWtlIGBmdW5jdGlvbjFgKVxuICogLSBgKGAgKGFycm93IGZ1bmN0aW9uKVxuICogLSBgYXN5bmNcXGJgIGZvbGxvd2VkIGJ5IGBmdW5jdGlvblxcYmAgb3IgYChgIChhc3luYyBmdW5jdGlvbi9hcnJvdylcbiAqL1xuY29uc3QgRlVOQ1RJT05fRVhQUkVTU0lPTl9SRSA9IC9eKD86ZnVuY3Rpb25cXGJ8YXN5bmNcXGJcXHMqKD86ZnVuY3Rpb25cXGJ8XFwoKXxcXCgpLztcblxuLyoqXG4gKiBNYXRjaGVzIHRoZSBgYXN5bmNgIGtleXdvcmQgKHdvcmQgYm91bmRhcnksIG5vdCBgYXN5bmMxYCkgZm9sbG93ZWQgYnkgb3B0aW9uYWwgd2hpdGVzcGFjZS5cbiAqIFVzZWQgdG8gc3RyaXAgdGhlIGBhc3luY2AgcHJlZml4IGZyb20gYXN5bmMgc2hvcnRoYW5kIG1ldGhvZHMgYmVmb3JlIHJlLWFkZGluZyBgYXN5bmMgZnVuY3Rpb25gLlxuICovXG5jb25zdCBBU1lOQ19LRVlXT1JEX1JFID0gL15hc3luY1xcYlxccyovO1xuXG50eXBlIEFyZ3VtZW50TmFtZXNPZjxUIGV4dGVuZHMgR2VuZXJpY0Z1bmN0aW9uPiA9IE1hcFRvQXJndW1lbnROYW1lczxQYXJhbWV0ZXJzPFQ+PjtcblxuaW50ZXJmYWNlIENyZWF0ZUZ1bmN0aW9uQXJndW1lbnRsZXNzUGFyYW1zIHtcbiAgcmVhZG9ubHkgZnVuY3Rpb25Cb2R5OiBzdHJpbmc7XG59XG5cbmludGVyZmFjZSBDcmVhdGVGdW5jdGlvblBhcmFtczxURnVuY3Rpb24gZXh0ZW5kcyBHZW5lcmljRnVuY3Rpb24+IGV4dGVuZHMgQ3JlYXRlRnVuY3Rpb25Bcmd1bWVudGxlc3NQYXJhbXMge1xuICByZWFkb25seSBhcmd1bWVudE5hbWVzOiBBcmd1bWVudE5hbWVzT2Y8VEZ1bmN0aW9uPjtcbn1cblxudHlwZSBNYXBUb0FyZ3VtZW50TmFtZXM8VEFyZ3VtZW50cyBleHRlbmRzIHJlYWRvbmx5IHVua25vd25bXT4gPSB7XG4gIHJlYWRvbmx5IFtLIGluIGtleW9mIFRBcmd1bWVudHNdOiBzdHJpbmc7XG59O1xuXG4vKipcbiAqIENsb25lIGEgZnVuY3Rpb24gYnkgY3JlYXRpbmcgYSBuZXcgZnVuY3Rpb24gdGhhdCBjYWxscyB0aGUgb3JpZ2luYWwgZnVuY3Rpb24uXG4gKlxuICogVGhpcyBpcyB1c2VmdWwgZm9yIGNyZWF0aW5nIGEgbmV3IGluc3RhbmNlIG9mIGEgZnVuY3Rpb24gdGhhdCBoYXMgdGhlIHNhbWUgYmVoYXZpb3IgYnV0IGlzIG5vdCBzdHJpY3RseSBlcXVhbCB0byB0aGUgb3JpZ2luYWwgZnVuY3Rpb24uXG4gKlxuICogQHR5cGVQYXJhbSBURnVuY3Rpb24gLSBUaGUgdHlwZSBvZiB0aGUgZnVuY3Rpb24gdG8gY2xvbmUuXG4gKiBAcGFyYW0gJGZ1bmN0aW9uIC0gVGhlIGZ1bmN0aW9uIHRvIGNsb25lLlxuICogQHJldHVybnMgQSBuZXcgZnVuY3Rpb24gdGhhdCBoYXMgdGhlIHNhbWUgYmVoYXZpb3IgYXMgdGhlIG9yaWdpbmFsIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gY2xvbmVGdW5jdGlvbjxURnVuY3Rpb24gZXh0ZW5kcyBHZW5lcmljRnVuY3Rpb24+KCRmdW5jdGlvbjogVEZ1bmN0aW9uKTogVEZ1bmN0aW9uIHtcbiAgcmV0dXJuIGNsb25lZEZ1bmN0aW9uIGFzIFRGdW5jdGlvbjtcblxuICBmdW5jdGlvbiBjbG9uZWRGdW5jdGlvbih0aGlzOiBUaGlzUGFyYW1ldGVyVHlwZTxURnVuY3Rpb24+LCAuLi4kYXJndW1lbnRzOiBQYXJhbWV0ZXJzPFRGdW5jdGlvbj4pOiBSZXR1cm5UeXBlPFRGdW5jdGlvbj4ge1xuICAgIHJldHVybiAkZnVuY3Rpb24uYXBwbHkodGhpcywgJGFyZ3VtZW50cykgYXMgUmV0dXJuVHlwZTxURnVuY3Rpb24+O1xuICB9XG59XG4vKipcbiAqIENyZWF0ZXMgYSBmdW5jdGlvbiBmcm9tIHRoZSBwcm92aWRlZCBwYXJhbWV0ZXJzLlxuICpcbiAqIEZ1bmN0aW9uIGlzIGFyZ3VtZW50bGVzcywgc28gYGFyZ05hbWVzYCBpcyBub3QgbmVlZGVkLlxuICpcbiAqIEB0eXBlUGFyYW0gVEZ1bmN0aW9uIC0gVGhlIHR5cGUgb2YgdGhlIGZ1bmN0aW9uIHRvIGNyZWF0ZS5cbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyB0byBjcmVhdGUgdGhlIGZ1bmN0aW9uIHdpdGguXG4gKiBAcmV0dXJucyBBIGZ1bmN0aW9uIGNyZWF0ZWQgZnJvbSB0aGUgcHJvdmlkZWQgcGFyYW1ldGVycy5cbiAqL1xuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bm5lY2Vzc2FyeS10eXBlLXBhcmFtZXRlcnMgLS0gV2UgbmVlZCByZXR1cm4gdHlwZS5cbmV4cG9ydCBmdW5jdGlvbiBjcmVhdGVGdW5jdGlvbjxURnVuY3Rpb24gZXh0ZW5kcyAoKSA9PiB1bmtub3duPihwYXJhbXM6IENyZWF0ZUZ1bmN0aW9uQXJndW1lbnRsZXNzUGFyYW1zKTogVEZ1bmN0aW9uO1xuLyoqXG4gKiBDcmVhdGVzIGEgZnVuY3Rpb24gZnJvbSB0aGUgcHJvdmlkZWQgcGFyYW1ldGVycy5cbiAqXG4gKiBGdW5jdGlvbiBoYXMgYXJndW1lbnRzLCBzbyBgYXJnTmFtZXNgIGlzIHJlcXVpcmVkLlxuICpcbiAqIEB0eXBlUGFyYW0gVEZ1bmN0aW9uIC0gVGhlIHR5cGUgb2YgdGhlIGZ1bmN0aW9uIHRvIGNyZWF0ZS5cbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyB0byBjcmVhdGUgdGhlIGZ1bmN0aW9uIHdpdGguXG4gKiBAcmV0dXJucyBBIGZ1bmN0aW9uIGNyZWF0ZWQgZnJvbSB0aGUgcHJvdmlkZWQgcGFyYW1ldGVycy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNyZWF0ZUZ1bmN0aW9uPFRGdW5jdGlvbiBleHRlbmRzIEdlbmVyaWNGdW5jdGlvbj4ocGFyYW1zOiBDcmVhdGVGdW5jdGlvblBhcmFtczxURnVuY3Rpb24+KTogVEZ1bmN0aW9uO1xuLyoqXG4gKiBDcmVhdGVzIGEgZnVuY3Rpb24gZnJvbSB0aGUgcHJvdmlkZWQgcGFyYW1ldGVycy5cbiAqXG4gKiBAdHlwZVBhcmFtIFRGdW5jdGlvbiAtIFRoZSB0eXBlIG9mIHRoZSBmdW5jdGlvbiB0byBjcmVhdGUuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIHRvIGNyZWF0ZSB0aGUgZnVuY3Rpb24gd2l0aC5cbiAqIEByZXR1cm5zIEEgZnVuY3Rpb24gY3JlYXRlZCBmcm9tIHRoZSBwcm92aWRlZCBwYXJhbWV0ZXJzLlxuICovXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlRnVuY3Rpb248VEZ1bmN0aW9uIGV4dGVuZHMgR2VuZXJpY0Z1bmN0aW9uPihcbiAgcGFyYW1zOiBDcmVhdGVGdW5jdGlvbkFyZ3VtZW50bGVzc1BhcmFtcyAmIFBhcnRpYWw8Q3JlYXRlRnVuY3Rpb25QYXJhbXM8VEZ1bmN0aW9uPj5cbik6IFRGdW5jdGlvbiB7XG4gIGNvbnN0IGFyZ3VtZW50TmFtZXMgPSBwYXJhbXMuYXJndW1lbnROYW1lcyA/PyBbXTtcbiAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIG5vLW5ldy1mdW5jLCBAdHlwZXNjcmlwdC1lc2xpbnQvbm8taW1wbGllZC1ldmFsIC0tIE5lZWQgZnVuY3Rpb24gY29uc3RydWN0b3JcbiAgcmV0dXJuIG5ldyBGdW5jdGlvbiguLi5hcmd1bWVudE5hbWVzLCBwYXJhbXMuZnVuY3Rpb25Cb2R5KSBhcyBURnVuY3Rpb247XG59XG5cbi8qKlxuICogTWFrZXMgYSBmdW5jdGlvbiB0aGF0IGNhbGxzIHRoZSBvcmlnaW5hbCBmdW5jdGlvbiB3aXRoIHRoZSBwcm92aWRlZCBhcmd1bWVudHMgYW5kIG9taXRzIHRoZSByZXR1cm4gdmFsdWUuXG4gKlxuICogQHR5cGVQYXJhbSBBcmd1bWVudHMgLSBBcmd1bWVudHMgdG8gYmUgcGFzc2VkIHRvIHRoZSBmdW5jdGlvbi5cbiAqIEBwYXJhbSAkZnVuY3Rpb24gLSBGdW5jdGlvbiB0byBiZSBjYWxsZWQuXG4gKiBAcmV0dXJucyBBIGZ1bmN0aW9uIHRoYXQgY2FsbHMgdGhlIG9yaWdpbmFsIGZ1bmN0aW9uIHdpdGggdGhlIHByb3ZpZGVkIGFyZ3VtZW50cyBhbmQgb21pdHMgdGhlIHJldHVybiB2YWx1ZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG9taXRSZXR1cm5UeXBlPEFyZ3VtZW50cyBleHRlbmRzIHVua25vd25bXT4oJGZ1bmN0aW9uOiBHZW5lcmljRnVuY3Rpb248QXJndW1lbnRzPik6IEdlbmVyaWNWb2lkRnVuY3Rpb248QXJndW1lbnRzPiB7XG4gIHJldHVybiAoLi4uJGFyZ3VtZW50czogQXJndW1lbnRzKSA9PiB7XG4gICAgJGZ1bmN0aW9uKC4uLiRhcmd1bWVudHMpO1xuICB9O1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBZ0VPLFNBQVMsNEJBQTRCLFdBQTZCO0FBQ3ZFLFFBQU0saUJBQWlCLFVBQVUsU0FBUztBQUUxQyxNQUFJLHVCQUF1QixLQUFLLGNBQWMsR0FBRztBQUMvQyxXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sYUFBYSxpQkFBaUIsS0FBSyxjQUFjO0FBQ3ZELFNBQU8sYUFBYSxrQkFBa0IsZUFBZSxNQUFNLFdBQVcsQ0FBQyxFQUFFLE1BQU0sQ0FBQyxLQUFLLFlBQVksY0FBYztBQUNqSDtBQUtPLFNBQVMsT0FBYTtBQUU3QjtBQU1PLE1BQU0sNEJBQTRCLFFBQVEsUUFBUTtBQU9sRCxTQUFTLFlBQTJCO0FBQ3pDLFNBQU87QUFDVDtBQVNPLFNBQVMsb0JBQWlELFdBQWlGO0FBQ2hKLFNBQU8sVUFBVSxlQUEwQjtBQUN6QyxVQUFNLFVBQVUsR0FBRyxVQUFVO0FBQUEsRUFDL0I7QUFDRjtBQVFBLE1BQU0seUJBQXlCO0FBTS9CLE1BQU0sbUJBQW1CO0FBeUJsQixTQUFTLGNBQWlELFdBQWlDO0FBQ2hHLFNBQU87QUFFUCxXQUFTLGtCQUFzRCxZQUEwRDtBQUN2SCxXQUFPLFVBQVUsTUFBTSxNQUFNLFVBQVU7QUFBQSxFQUN6QztBQUNGO0FBOEJPLFNBQVMsZUFDZCxRQUNXO0FBQ1gsUUFBTSxnQkFBZ0IsT0FBTyxpQkFBaUIsQ0FBQztBQUUvQyxTQUFPLElBQUksU0FBUyxHQUFHLGVBQWUsT0FBTyxZQUFZO0FBQzNEO0FBU08sU0FBUyxlQUE0QyxXQUF1RTtBQUNqSSxTQUFPLElBQUksZUFBMEI7QUFDbkMsY0FBVSxHQUFHLFVBQVU7QUFBQSxFQUN6QjtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/function.d.cts

@@ -0,0 +1,128 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility functions and types for working with functions.
+ */
+import type { Promisable } from 'type-fest' with { 'resolution-mode': 'import' };
+/**
+ * Represents a generic async function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ * @typeParam Return - The awaited return type of the function.
+ */
+export type GenericAsyncFunction<Arguments extends unknown[] = never[], Return = unknown> = GenericFunction<Arguments, Promise<Return>>;
+/**
+ * Represents a generic async void function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ */
+export type GenericAsyncVoidFunction<Arguments extends unknown[] = never[]> = GenericAsyncFunction<Arguments, void>;
+/**
+ * Represents a generic function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ * @typeParam Return - The return type of the function.
+ */
+export type GenericFunction<Arguments extends unknown[] = never[], Return = unknown> = (...$arguments: Arguments) => Return;
+/**
+ * Represents a generic promisable function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ * @typeParam Return - The awaited return type of the function.
+ */
+export type GenericPromisableFunction<Arguments extends unknown[] = never[], Return = unknown> = GenericFunction<Arguments, Promisable<Return>>;
+/**
+ * Represents a generic promisable void function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ */
+export type GenericPromisableVoidFunction<Arguments extends unknown[] = never[]> = GenericPromisableFunction<Arguments, void>;
+/**
+ * Represents a generic void function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ */
+export type GenericVoidFunction<Arguments extends unknown[] = never[]> = GenericFunction<Arguments, void>;
+/**
+ * Converts a function into a string that is a valid function expression.
+ *
+ * `Function.prototype.toString()` on a shorthand method like `{ fn() {} }`
+ * returns `"fn() {}"`, which is not a valid expression.
+ * This helper detects that form and prefixes it with `function `.
+ *
+ * @param $function - The function to convert.
+ * @returns A string that is a valid function expression.
+ */
+export declare function getFunctionExpressionString($function: Function): string;
+/**
+ * A function that does nothing.
+ */
+export declare function noop(): void;
+/**
+ * A singleton no-op promise.
+ */
+export declare const noopAsyncSingletonPromise: Promise<void>;
+/**
+ * A function that does nothing.
+ *
+ * @returns A promise that resolves when the function is complete.
+ */
+export declare function noopAsync(): Promise<void>;
+/**
+ * Makes an async function that calls the original async function with the provided arguments and omits the return value.
+ *
+ * @typeParam Arguments - Arguments to be passed to the function.
+ * @param $function - Function to be called.
+ * @returns An async function that calls the original function with the provided arguments and omits the return value.
+ */
+export declare function omitAsyncReturnType<Arguments extends unknown[]>($function: GenericAsyncFunction<Arguments>): GenericAsyncVoidFunction<Arguments>;
+type ArgumentNamesOf<T extends GenericFunction> = MapToArgumentNames<Parameters<T>>;
+interface CreateFunctionArgumentlessParams {
+    readonly functionBody: string;
+}
+interface CreateFunctionParams<TFunction extends GenericFunction> extends CreateFunctionArgumentlessParams {
+    readonly argumentNames: ArgumentNamesOf<TFunction>;
+}
+type MapToArgumentNames<TArguments extends readonly unknown[]> = {
+    readonly [K in keyof TArguments]: string;
+};
+/**
+ * Clone a function by creating a new function that calls the original function.
+ *
+ * This is useful for creating a new instance of a function that has the same behavior but is not strictly equal to the original function.
+ *
+ * @typeParam TFunction - The type of the function to clone.
+ * @param $function - The function to clone.
+ * @returns A new function that has the same behavior as the original function.
+ */
+export declare function cloneFunction<TFunction extends GenericFunction>($function: TFunction): TFunction;
+/**
+ * Creates a function from the provided parameters.
+ *
+ * Function is argumentless, so `argNames` is not needed.
+ *
+ * @typeParam TFunction - The type of the function to create.
+ * @param params - The parameters to create the function with.
+ * @returns A function created from the provided parameters.
+ */
+export declare function createFunction<TFunction extends () => unknown>(params: CreateFunctionArgumentlessParams): TFunction;
+/**
+ * Creates a function from the provided parameters.
+ *
+ * Function has arguments, so `argNames` is required.
+ *
+ * @typeParam TFunction - The type of the function to create.
+ * @param params - The parameters to create the function with.
+ * @returns A function created from the provided parameters.
+ */
+export declare function createFunction<TFunction extends GenericFunction>(params: CreateFunctionParams<TFunction>): TFunction;
+/**
+ * Makes a function that calls the original function with the provided arguments and omits the return value.
+ *
+ * @typeParam Arguments - Arguments to be passed to the function.
+ * @param $function - Function to be called.
+ * @returns A function that calls the original function with the provided arguments and omits the return value.
+ */
+export declare function omitReturnType<Arguments extends unknown[]>($function: GenericFunction<Arguments>): GenericVoidFunction<Arguments>;
+export {};