@flex-development/mlly 1.0.0-alpha.1 → 1.0.0-alpha.11

package/dist/internal/resolver.mjs

@@ -0,0 +1,500 @@
+import CONDITIONS from "../utils/conditions.mjs";
+import isExportsSugar from "../utils/is-exports-sugar.mjs";
+import isRelativeSpecifier from "../utils/is-relative-specifier.mjs";
+import lookupPackageScope from "../utils/lookup-package-scope.mjs";
+import parseModuleId from "../utils/parse-module-id.mjs";
+import parseSubpath from "../utils/parse-subpath.mjs";
+import PATTERN_CHARACTER from "../utils/pattern-character.mjs";
+import readPackageJson from "../utils/read-package-json.mjs";
+import toNodeURL from "../utils/to-node-url.mjs";
+import toURL from "../utils/to-url.mjs";
+import {
+  ERR_INVALID_MODULE_SPECIFIER,
+  ERR_INVALID_PACKAGE_CONFIG,
+  ERR_INVALID_PACKAGE_TARGET,
+  ERR_MODULE_NOT_FOUND,
+  ERR_PACKAGE_IMPORT_NOT_DEFINED,
+  ERR_PACKAGE_PATH_NOT_EXPORTED,
+  ERR_UNSUPPORTED_DIR_IMPORT,
+  ErrorCode
+} from "@flex-development/errnode";
+import { isBuiltin } from "@flex-development/is-builtin";
+import pathe from "@flex-development/pathe";
+import { isNIL } from "@flex-development/tutils";
+import fs from "node:fs";
+import { URL, fileURLToPath, pathToFileURL } from "node:url";
+import regexp from "./escape-reg-exp.mjs";
+import isArrayIndex from "./is-array-index.mjs";
+import isDirectory from "./is-directory.mjs";
+import isFile from "./is-file.mjs";
+import PACKAGE_NAME_REGEX from "./regex-package-name.mjs";
+import PACKAGE_PATH_REGEX from "./regex-package-path.mjs";
+class Resolver {
+  /**
+   * Resolves `specifier` according to the [ESM Resolver algorithm][1].
+   *
+   * [1]: https://nodejs.org/api/esm.html#esm_resolver_algorithm
+   *
+   * @public
+   *
+   * @param {string} specifier - Module specifier to resolve
+   * @param {ModuleId} parent - URL of module to resolve from
+   * @param {string?} [condition='default'] - Export condition to apply
+   * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+   * @param {boolean?} [preserveSymlinks=false] - Skip resolving symlinks
+   * @return {URL} Resolved module URL
+   * @throws {NodeError}
+   */
+  resolveModule(specifier, parent, condition = "default", conditions = CONDITIONS, preserveSymlinks = false) {
+    parent = toURL(parent);
+    const remote = /^https?:$/.test(parent.protocol);
+    let error = new ERR_MODULE_NOT_FOUND(
+      specifier,
+      remote ? parent.href : fileURLToPath(parent),
+      PACKAGE_PATH_REGEX.test(specifier) ? "package" : "module"
+    );
+    let url = null;
+    try {
+      switch (true) {
+        case isRelativeSpecifier(specifier):
+        case pathe.isAbsolute(specifier):
+          url = new URL(specifier, parent);
+          break;
+        case (!remote && specifier.startsWith("#")):
+          url = this.resolvePackageImport(
+            specifier,
+            parent,
+            condition,
+            conditions
+          );
+          break;
+        default:
+          try {
+            url = new URL(specifier);
+          } catch {
+            if (!remote) {
+              url = this.resolvePackage(
+                specifier,
+                parent,
+                condition,
+                conditions
+              );
+            }
+          }
+          break;
+      }
+      if (url && url.protocol === "file:") {
+        const path = fileURLToPath(url);
+        if (!isFile(path)) {
+          throw isDirectory(path) ? new ERR_UNSUPPORTED_DIR_IMPORT(path, fileURLToPath(parent)) : new ERR_MODULE_NOT_FOUND(path, fileURLToPath(parent), "module");
+        }
+        if (!preserveSymlinks) {
+          const { hash, search } = url;
+          url = pathToFileURL(fs.realpathSync(path));
+          url.hash = hash;
+          url.search = search;
+        }
+      }
+    } catch (e) {
+      error = e;
+      url = null;
+    }
+    if (!url)
+      throw error;
+    return url;
+  }
+  /**
+   * Resolves a package path using a combination of the following algorithms:
+   *
+   * - `PACKAGE_RESOLVE`
+   * - `PACKAGE_SELF_RESOLVE`
+   *
+   * @see https://nodejs.org/api/esm.html#resolver-algorithm-specification
+   *
+   * @public
+   *
+   * @param {string} specifier - Module specifier to resolve
+   * @param {ModuleId} parent - URL of module to resolve from
+   * @param {string?} [condition='default'] - Export condition to apply
+   * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+   * @return {URL} Resolved package path URL
+   * @throws {NodeError}
+   */
+  resolvePackage(specifier, parent, condition = "default", conditions = CONDITIONS) {
+    const id = parseModuleId(specifier, {
+      parent,
+      pkgname: !isBuiltin(specifier)
+    });
+    if (isBuiltin(id.raw))
+      return new URL(toNodeURL(id.raw));
+    const stopdir = pathToFileURL("." + pathe.sep);
+    let scope = lookupPackageScope(
+      parent,
+      stopdir,
+      specifier,
+      parent
+    );
+    if ((scope == null ? void 0 : scope.pkgjson.name) === id.pkg && !isNIL(scope.pkgjson.exports)) {
+      return this.resolvePackageExport(
+        id.raw,
+        scope.pkg,
+        parent,
+        condition,
+        conditions
+      );
+    }
+    let url = null;
+    if (scope) {
+      let { dir: pkgdir } = scope;
+      while (pkgdir !== ".") {
+        scope = lookupPackageScope(
+          new URL(`node_modules/${id.raw}`, pkgdir + pathe.sep),
+          stopdir,
+          specifier,
+          parent
+        );
+        if (scope)
+          break;
+        pkgdir = pathe.dirname(pkgdir);
+      }
+    }
+    switch (true) {
+      case (scope && !isNIL(scope.pkgjson.exports)):
+        url = this.resolvePackageExport(
+          specifier,
+          scope.pkg,
+          parent,
+          condition,
+          conditions
+        );
+        break;
+      case (scope && id.path === "."):
+        url = this.resolvePackageMain(scope.pkg, scope.pkgjson, parent);
+        break;
+      case !!scope:
+        url = new URL(id.path, scope.pkg);
+        break;
+    }
+    if (!url)
+      throw new ERR_MODULE_NOT_FOUND(id.pkg, fileURLToPath(parent));
+    return url;
+  }
+  /**
+   * Resolves a subpath export according to the `PACKAGE_EXPORTS_RESOLVE`
+   * algorithm.
+   *
+   * @see https://nodejs.org/api/esm.html#resolver-algorithm-specification
+   * @see https://nodejs.org/api/packages.html#subpath-exports
+   *
+   * @public
+   *
+   * @param {string} specifier - Module specifier containing subpath
+   * @param {ModuleId} pkg - URL of relevant `package.json` file
+   * @param {ModuleId} parent - URL of module to resolve from
+   * @param {string?} [condition='default'] - Export condition to apply
+   * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+   * @return {URL} Resolved package export URL
+   * @throws {NodeError<Error | TypeError>}
+   */
+  resolvePackageExport(specifier, pkg, parent, condition = "default", conditions = CONDITIONS) {
+    const dir = new URL(".", pkg);
+    const pkgjson = readPackageJson(
+      dir,
+      specifier,
+      parent
+    );
+    let exports = pkgjson == null ? void 0 : pkgjson.exports;
+    const subpath = parseSubpath(specifier, exports, {
+      dir,
+      parent
+    });
+    if (!subpath.internal && isExportsSugar(exports, pkg, parent)) {
+      exports = { ".": exports };
+    }
+    const url = this.resolvePackageTarget(
+      dir,
+      exports == null ? void 0 : exports[subpath.key],
+      subpath.base,
+      subpath.key,
+      parent,
+      subpath.internal,
+      condition,
+      conditions
+    );
+    if (!url) {
+      throw new ERR_PACKAGE_PATH_NOT_EXPORTED(
+        fileURLToPath(dir),
+        subpath.raw,
+        fileURLToPath(parent)
+      );
+    }
+    return url;
+  }
+  /**
+   * Resolves a subpath import according to the `PACKAGE_IMPORTS_RESOLVE`
+   * algorithm.
+   *
+   * @see https://nodejs.org/api/esm.html#resolver-algorithm-specification
+   * @see https://nodejs.org/api/packages.html#subpath-imports
+   *
+   * @public
+   *
+   * @param {string} specifier - Module specifier containing subpath
+   * @param {ModuleId} parent - URL of module to resolve from
+   * @param {string?} [condition='default'] - Export condition to apply
+   * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+   * @return {URL} Resolved package import URL
+   * @throws {NodeError<Error | TypeError>}
+   */
+  resolvePackageImport(specifier, parent, condition = "default", conditions = CONDITIONS) {
+    const id = parseModuleId(specifier, {
+      internal: true,
+      parent
+    });
+    const scope = lookupPackageScope(
+      parent,
+      pathToFileURL("."),
+      specifier,
+      parent
+    );
+    let url = null;
+    if (scope) {
+      const imports = scope.pkgjson.imports;
+      const subpath = parseSubpath(id.raw, imports, {
+        dir: scope.dir,
+        internal: true,
+        parent
+      });
+      url = this.resolvePackageTarget(
+        scope.dir,
+        imports == null ? void 0 : imports[subpath.key],
+        subpath.base,
+        subpath.key,
+        parent,
+        subpath.internal,
+        condition,
+        conditions
+      );
+    }
+    if (!url) {
+      throw new ERR_PACKAGE_IMPORT_NOT_DEFINED(
+        specifier,
+        fileURLToPath(parent),
+        /* c8 ignore next */
+        (scope == null ? void 0 : scope.dir) ? fileURLToPath(scope.dir) : void 0
+      );
+    }
+    return url;
+  }
+  /**
+   * Resolves a package entry point using the legacy CommonJS `main` resolution
+   * alogirthm:
+   *
+   * 1. let M = pkgdir `pkgjson.main`
+   * 2. TRY(M, M.js, M.json, M.node, M/index.js, M/index.json, M/index.node)
+   * 4. TRY(pkgdir/index.js, pkgdir/index.json, pkgdir/index.node)
+   * 5. ERR_MODULE_NOT_FOUND
+   *
+   * @todo emit deprecation messages
+   *
+   * @public
+   *
+   * @param {ModuleId} pkg - URL of relevant `package.json` file
+   * @param {PackageJson} pkgjson - Relevant `package.json` object
+   * @param {ModuleId} parent - URL of module to resolve from
+   * @return {URL} Package entry point URL
+   * @throws {NodeError} If package entry point is not found
+   */
+  resolvePackageMain(pkg, pkgjson, parent) {
+    const tries = [
+      ...pkgjson.main ? [
+        pkgjson.main,
+        `./${pkgjson.main}.js`,
+        `./${pkgjson.main}.json`,
+        `./${pkgjson.main}.node`,
+        `./${pkgjson.main}/index.js`,
+        `./${pkgjson.main}/index.json`,
+        `./${pkgjson.main}/index.node`
+      ] : [],
+      "./index.js",
+      "./index.json",
+      "./index.node"
+    ];
+    let url = null;
+    for (const input of tries) {
+      if (isFile(url = new URL(input, pkg)))
+        break;
+      url = null;
+    }
+    if (!url) {
+      throw new ERR_MODULE_NOT_FOUND(
+        fileURLToPath(new URL(".", pkg)),
+        fileURLToPath(parent)
+      );
+    }
+    return url;
+  }
+  /**
+   * Resolves a package target according to the `PACKAGE_TARGET_RESOLVE`
+   * algorithm.
+   *
+   * @see https://nodejs.org/api/esm.html#resolver-algorithm-specification
+   *
+   * @todo emit deprecation messages
+   *
+   * @public
+   *
+   * @param {ModuleId} dir - URL of directory containing relevant `package.json`
+   * @param {Exports | undefined} target - Package `exports` or `imports` target
+   * @param {string} subpath - Package subpath without entry prefix (`key`)
+   * @param {string} key - Subpath defined in relevant `package.json` file
+   * @param {ModuleId} parent - URL of module to resolve from
+   * @param {boolean?} [internal=false] - Package `imports` hint
+   * @param {string?} [condition='default'] - Export condition to apply
+   * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+   * @return {Nullable<URL>} Resolved package target URL or `null`
+   * @throws {NodeError<Error | TypeError>}
+   */
+  resolvePackageTarget(dir, target, subpath, key, parent, internal = false, condition = "default", conditions = CONDITIONS) {
+    let url = null;
+    switch (true) {
+      case target === null:
+        break;
+      case Array.isArray(target):
+        let error;
+        for (const item of target) {
+          try {
+            url = this.resolvePackageTarget(
+              dir,
+              item,
+              subpath,
+              key,
+              parent,
+              internal,
+              condition,
+              conditions
+            );
+          } catch (e) {
+            error = e;
+            if (error.code !== ErrorCode.ERR_INVALID_PACKAGE_TARGET)
+              throw error;
+            continue;
+          }
+          if (url)
+            break;
+        }
+        if (error && !url)
+          throw error;
+        break;
+      case typeof target === "object":
+        target = target;
+        for (const prop of Object.getOwnPropertyNames(target)) {
+          if (isArrayIndex(prop)) {
+            throw new ERR_INVALID_PACKAGE_CONFIG(
+              fileURLToPath(dir),
+              fileURLToPath(parent),
+              '"exports" cannot contain numeric property keys'
+            );
+          }
+          if (prop === condition || conditions.has(prop)) {
+            url = this.resolvePackageTarget(
+              dir,
+              target[prop],
+              subpath,
+              key,
+              parent,
+              internal,
+              condition,
+              conditions
+            );
+            if (url)
+              break;
+          }
+        }
+        break;
+      case typeof target === "string":
+        target = target;
+        const pattern = key.includes(PATTERN_CHARACTER);
+        switch (true) {
+          case (subpath && !pattern && !target.endsWith(pathe.sep)):
+            throw new ERR_INVALID_PACKAGE_TARGET(
+              fileURLToPath(dir),
+              key,
+              target,
+              internal,
+              fileURLToPath(parent)
+            );
+          case (internal && PACKAGE_NAME_REGEX.test(target)):
+            url = this.resolvePackage(target, parent, condition, conditions);
+            break;
+          case target.startsWith("." + pathe.sep):
+            const invalidSegmentRegex = (type) => {
+              return new RegExp(
+                `(^|\\\\|\\/)((\\.|%2e)(\\.|%2e)?|(n|%6e|%4e)(o|%6f|%4f)(d|%64|%44)(e|%65|%45)(_|%5f)(m|%6d|%4d)(o|%6f|%4f)(d|%64|%44)(u|%75|%55)(l|%6c|%4c)(e|%65|%45)(s|%73|%53))${type === "deprecated" ? "" : "?"}(\\\\|\\/|$)`,
+                "i"
+              );
+            };
+            if (invalidSegmentRegex().test(target.slice(2))) {
+              if (invalidSegmentRegex("deprecated").test(target.slice(2))) {
+                throw new ERR_INVALID_PACKAGE_TARGET(
+                  fileURLToPath(dir),
+                  key,
+                  target,
+                  internal,
+                  fileURLToPath(parent)
+                );
+              }
+            }
+            url = new URL(
+              target,
+              pathToFileURL(fileURLToPath(dir).replace(/\/$/, "") + pathe.sep)
+            );
+            if (subpath) {
+              if (invalidSegmentRegex().test(subpath)) {
+                if (invalidSegmentRegex("deprecated").test(subpath)) {
+                  throw new ERR_INVALID_MODULE_SPECIFIER(
+                    key.replace(PATTERN_CHARACTER, subpath),
+                    [
+                      `request is not a valid match in pattern "${key}" for`,
+                      `the "${internal ? "imports" : "exports"}" resolution`,
+                      `of ${fileURLToPath(dir).replace(/\/$/, "")}/package.json`
+                    ].join(" "),
+                    fileURLToPath(parent)
+                  );
+                }
+              }
+              url = new URL(
+                url.href.replace(
+                  new RegExp(regexp(PATTERN_CHARACTER), "g"),
+                  subpath
+                )
+              );
+            }
+            break;
+          default:
+            throw new ERR_INVALID_PACKAGE_TARGET(
+              fileURLToPath(dir),
+              key,
+              target,
+              internal,
+              fileURLToPath(parent)
+            );
+        }
+        break;
+      default:
+        throw new ERR_INVALID_PACKAGE_TARGET(
+          fileURLToPath(dir),
+          key,
+          target,
+          internal,
+          fileURLToPath(parent)
+        );
+    }
+    return url;
+  }
+}
+var resolver_default = Resolver;
+export {
+  resolver_default as default
+};
+//# sourceMappingURL=resolver.mjs.map

package/dist/internal/resolver.mjs.map

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

package/dist/internal/validate-boolean.d.mts

@@ -0,0 +1,20 @@
+/**
+ * @file Internal - validateBoolean
+ * @module mlly/internal/validateBoolean
+ */
+/**
+ * Checks if given `value` is a boolean.
+ *
+ * Throws [`ERR_INVALID_ARG_TYPE`][1] if the `value` is not a boolean.
+ *
+ * [1]: https://nodejs.org/api/errors.html#err_invalid_arg_value
+ *
+ * @see {@linkcode ERR_INVALID_ARG_TYPE}
+ *
+ * @param {unknown} value - Value supplied by user
+ * @param {string} name - Name of invalid argument or property
+ * @return {value is boolean} `true` if `value` is a boolean
+ * @throws {NodeError<TypeError>} If `value` is not a boolean
+ */
+declare const validateBoolean: (value: unknown, name: string) => value is boolean;
+export default validateBoolean;

package/dist/internal/validate-boolean.mjs

@@ -0,0 +1,11 @@
+import { ERR_INVALID_ARG_TYPE } from "@flex-development/errnode";
+const validateBoolean = (value, name) => {
+  if (typeof value === "boolean")
+    return true;
+  throw new ERR_INVALID_ARG_TYPE(name, "boolean", value);
+};
+var validate_boolean_default = validateBoolean;
+export {
+  validate_boolean_default as default
+};
+//# sourceMappingURL=validate-boolean.mjs.map

package/dist/internal/validate-boolean.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/validate-boolean.ts"],
+  "mappings": "AAKA,SAAS,4BAA4C;AAgBrD,MAAM,kBAAkB,CAAC,OAAgB,SAAmC;AAC1E,MAAI,OAAO,UAAU;AAAW,WAAO;AACvC,QAAM,IAAI,qBAAqB,MAAM,WAAW,KAAK;AACvD;AAEA,IAAO,2BAAQ;",
+  "names": []
+}

package/dist/internal/validate-object.d.mts

@@ -0,0 +1,23 @@
+/**
+ * @file Internal - validateObject
+ * @module mlly/internal/validateObject
+ */
+import type { ObjectPlain } from '@flex-development/tutils';
+/**
+ * Checks if given `value` is an object.
+ *
+ * **Note**: Array values are not considered objects.
+ *
+ * Throws [`ERR_INVALID_ARG_TYPE`][1] if the `value` is not an object.
+ *
+ * [1]: https://nodejs.org/api/errors.html#err_invalid_arg_value
+ *
+ * @see {@linkcode ERR_INVALID_ARG_TYPE}
+ *
+ * @param {unknown} value - Value supplied by user
+ * @param {string} name - Name of invalid argument or property
+ * @return {value is ObjectPlain} `true` if `value` is an object
+ * @throws {NodeError<TypeError>} If `value` is not an object
+ */
+declare const validateObject: (value: unknown, name: string) => value is ObjectPlain;
+export default validateObject;

package/dist/internal/validate-object.mjs

@@ -0,0 +1,11 @@
+import { ERR_INVALID_ARG_TYPE } from "@flex-development/errnode";
+const validateObject = (value, name) => {
+  if (typeof value === "object" && value && !Array.isArray(value))
+    return true;
+  throw new ERR_INVALID_ARG_TYPE(name, "object", value);
+};
+var validate_object_default = validateObject;
+export {
+  validate_object_default as default
+};
+//# sourceMappingURL=validate-object.mjs.map

package/dist/internal/validate-object.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/validate-object.ts"],
+  "mappings": "AAKA,SAAS,4BAA4C;AAmBrD,MAAM,iBAAiB,CAAC,OAAgB,SAAuC;AAC7E,MAAI,OAAO,UAAU,YAAY,SAAS,CAAC,MAAM,QAAQ,KAAK;AAAG,WAAO;AACxE,QAAM,IAAI,qBAAqB,MAAM,UAAU,KAAK;AACtD;AAEA,IAAO,0BAAQ;",
+  "names": []
+}

package/dist/internal/validate-set.d.mts

@@ -0,0 +1,23 @@
+/**
+ * @file Internal - validateSet
+ * @module mlly/internal/validateSet
+ */
+/**
+ * Checks if given `value` is an instance of {@linkcode Set}.
+ *
+ * Throws [`ERR_INVALID_ARG_TYPE`][1] if the `value` is not a {@linkcode Set}
+ * instance.
+ *
+ * [1]: https://nodejs.org/api/errors.html#err_invalid_arg_value
+ *
+ * @see {@linkcode ERR_INVALID_ARG_TYPE}
+ *
+ * @template T - Item type(s)
+ *
+ * @param {unknown} value - Value supplied by user
+ * @param {string} name - Name of invalid argument or property
+ * @return {value is Set} `true` if `value` is instance of {@linkcode Set}
+ * @throws {NodeError<TypeError>} If `value` is an instance of {@linkcode Set}
+ */
+declare function validateSet<T = unknown>(value: unknown, name: string): value is Set<T>;
+export default validateSet;

package/dist/internal/validate-set.mjs

@@ -0,0 +1,11 @@
+import { ERR_INVALID_ARG_TYPE } from "@flex-development/errnode";
+function validateSet(value, name) {
+  if (value instanceof Set)
+    return true;
+  throw new ERR_INVALID_ARG_TYPE(name, ["Set"], value);
+}
+var validate_set_default = validateSet;
+export {
+  validate_set_default as default
+};
+//# sourceMappingURL=validate-set.mjs.map

package/dist/internal/validate-set.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal/validate-set.ts"],
+  "mappings": "AAKA,SAAS,4BAA4C;AAmBrD,SAAS,YACP,OACA,MACiB;AACjB,MAAI,iBAAiB;AAAK,WAAO;AACjC,QAAM,IAAI,qBAAqB,MAAM,CAAC,KAAK,GAAG,KAAK;AACrD;AAEA,IAAO,uBAAQ;",
+  "names": []
+}

package/dist/internal/validate-string.d.mts

@@ -0,0 +1,20 @@
+/**
+ * @file Internal - validateString
+ * @module mlly/internal/validateString
+ */
+/**
+ * Checks if given `value` is a string.
+ *
+ * Throws [`ERR_INVALID_ARG_TYPE`][1] if the `value` is not a string.
+ *
+ * [1]: https://nodejs.org/api/errors.html#err_invalid_arg_value
+ *
+ * @see {@linkcode ERR_INVALID_ARG_TYPE}
+ *
+ * @param {unknown} value - Value supplied by user
+ * @param {string} name - Name of invalid argument or property
+ * @return {value is string} `true` if `value` is a string
+ * @throws {NodeError<TypeError>} If `value` is not a string
+ */
+declare const validateString: (value: unknown, name: string) => value is string;
+export default validateString;

package/dist/internal/validate-string.mjs

@@ -0,0 +1,11 @@
+import { ERR_INVALID_ARG_TYPE } from "@flex-development/errnode";
+const validateString = (value, name) => {
+  if (typeof value === "string")
+    return true;
+  throw new ERR_INVALID_ARG_TYPE(name, "string", value);
+};
+var validate_string_default = validateString;
+export {
+  validate_string_default as default
+};
+//# sourceMappingURL=validate-string.mjs.map