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

package/dist/{lib → utils}/to-absolute-specifier.d.mts

@@ -1,8 +1,8 @@
 /**
  * @file toAbsoluteSpecifier
- * @module mlly/lib/toAbsoluteSpecifier
+ * @module mlly/utils/toAbsoluteSpecifier
  */
-import { URL } from 'node:url';
+import type { ModuleId } from '../types/index.mjs';
 /**
  * Converts `specifier` into an absolute specifier.
  *
@@ -11,12 +11,12 @@ import { URL } from 'node:url';
  * includes a file extension.
  * :::
  *
- * @see {@link URL}
+ * @see {@linkcode ModuleId}
  * @see https://nodejs.org/api/esm.html#terminology
  *
- * @param {URL | string} specifier - Module specifier to convert
- * @param {URL | string} [cwd=process.cwd()] - Current working directory
+ * @param {ModuleId} specifier - Module specifier to convert
+ * @param {ModuleId} [cwd=pathToFileURL('./')] - Current working directory
  * @return {string} `specifier` as absolute specifier (file url)
  */
-declare const toAbsoluteSpecifier: (specifier: URL | string, cwd?: URL | string) => string;
+declare const toAbsoluteSpecifier: (specifier: ModuleId, cwd?: ModuleId) => string;
 export default toAbsoluteSpecifier;

package/dist/utils/to-absolute-specifier.mjs

@@ -0,0 +1,8 @@
+import { pathToFileURL } from "node:url";
+import toURL from "./to-url.mjs";
+const toAbsoluteSpecifier = (specifier, cwd = pathToFileURL("./")) => toURL(specifier, cwd).href;
+var to_absolute_specifier_default = toAbsoluteSpecifier;
+export {
+  to_absolute_specifier_default as default
+};
+//# sourceMappingURL=to-absolute-specifier.mjs.map

package/dist/utils/to-absolute-specifier.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/to-absolute-specifier.ts"],
+  "mappings": "AAMA,SAAS,qBAAqB;AAC9B,OAAO,WAAW;AAiBlB,MAAM,sBAAsB,CAC1B,WACA,MAAgB,cAAc,IAAI,MACvB,MAAM,WAAW,GAAG,EAAE;AAEnC,IAAO,gCAAQ;",
+  "names": []
+}

package/dist/utils/to-bare-specifier.d.mts

@@ -0,0 +1,42 @@
+/**
+ * @file toBareSpecifier
+ * @module mlly/utils/toBareSpecifier
+ */
+import type { ModuleId } from '../types/index.mjs';
+/**
+ * Converts the given module `specifier` into a bare specifier.
+ *
+ * The new specifier is **not** guaranteed to resolve to an existing module, nor
+ * is it guaranteed to have a file extension, but it *is* guaranteed to be a
+ * package path containing a valid [subpath export][1] if the specifier's parent
+ * package uses package [`exports`][2]. If the parent package does not use
+ * `exports`, the new specifier is only guaranteed to begin with a valid NPM
+ * package name or Node.js [builtin module][3] name.
+ *
+ * The given module `specifier` should be absolute, syntactically bare (i.e. not
+ * begin with `'/'` or `'.'`), or relative to the current working directory
+ * (e.g. `'./dist/index.mjs'`).
+ *
+ * ::: warning
+ * Internal specifier (i.e. [subpath import][4]; `'#src'`, `'#src/utils'`)
+ * conversion is not supported. Converting *_to_* an internal specifier will be
+ * supported in the future.
+ * :::
+ *
+ * [1]: https://nodejs.org/api/packages.html#subpath-exports
+ * [2]: https://nodejs.org/api/packages.html#exports
+ * [3]: https://nodejs.org/api/module.html#modulebuiltinmodules
+ * [4]: https://nodejs.org/api/packages.html#subpath-imports
+ *
+ * @see {@linkcode CONDITIONS}
+ * @see {@linkcode ModuleId}
+ * @see https://nodejs.org/api/esm.html#terminology
+ *
+ * @param {ModuleId} specifier - Module specifier to convert
+ * @param {ModuleId} parent - URL of module to resolve from
+ * @param {Set<string>?} [conditions=CONDITIONS] - Export conditions
+ * @return {string} `specifier` as bare specifier
+ * @throws {NodeError}
+ */
+declare const toBareSpecifier: (specifier: ModuleId, parent: ModuleId, conditions?: Set<string>) => string;
+export default toBareSpecifier;

package/dist/utils/to-bare-specifier.mjs

@@ -0,0 +1,90 @@
+import regexp from "../internal/escape-reg-exp.mjs";
+import validateURLString from "../internal/validate-url-string.mjs";
+import {
+  ERR_OPERATION_FAILED,
+  ERR_PACKAGE_PATH_NOT_EXPORTED,
+  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 { URL, fileURLToPath, pathToFileURL } from "node:url";
+import CONDITIONS from "./conditions.mjs";
+import findSubpath from "./find-subpath.mjs";
+import isAbsoluteSpecifier from "./is-absolute-specifier.mjs";
+import isRelativeSpecifier from "./is-relative-specifier.mjs";
+import lookupPackageScope from "./lookup-package-scope.mjs";
+import parseModuleId from "./parse-module-id.mjs";
+import parseSubpath from "./parse-subpath.mjs";
+import PATTERN_CHARACTER from "./pattern-character.mjs";
+import toAbsoluteSpecifier from "./to-absolute-specifier.mjs";
+import toNodeURL from "./to-node-url.mjs";
+import toURL from "./to-url.mjs";
+const toBareSpecifier = (specifier, parent, conditions = CONDITIONS) => {
+  validateURLString(specifier, "specifier");
+  validateURLString(parent, "parent");
+  if (specifier instanceof URL)
+    specifier = specifier.href;
+  if (isBuiltin(specifier))
+    return toNodeURL(specifier);
+  if (specifier.startsWith("file:"))
+    specifier = fileURLToPath(specifier);
+  if (isRelativeSpecifier(specifier)) {
+    specifier = fileURLToPath(toAbsoluteSpecifier(specifier));
+  }
+  const url = toURL(
+    isAbsoluteSpecifier(specifier) || specifier.startsWith("node_modules") ? specifier : `node_modules/${specifier}`
+  );
+  const scope = lookupPackageScope(
+    url,
+    pathToFileURL(".")
+  );
+  if (!scope) {
+    throw new ERR_OPERATION_FAILED(`Package scope for '${specifier}' not found`);
+  }
+  const { dir: pkgdir, pkgjson } = scope;
+  const { exports, main, name = "", types } = pkgjson;
+  specifier = url.pathname.includes(name) ? name + url.pathname.replace(new RegExp(`.*?${regexp(name)}`), "") : name + specifier.replace(fileURLToPath(pkgdir.replace(/\/$/, "")), "");
+  const id = parseModuleId(specifier, {
+    internal: false,
+    parent,
+    pkgname: true
+  });
+  if (isNIL(exports)) {
+    return [main, types].some((ep) => ep === id.path || ep === id.path.slice(2)) ? id.pkg : specifier;
+  }
+  try {
+    parseSubpath(specifier, exports, { dir: pkgdir, parent });
+  } catch (e) {
+    if (e.code === ErrorCode.ERR_PACKAGE_PATH_NOT_EXPORTED) {
+      const target = specifier.replace(name, ".");
+      let subpath = findSubpath(target, exports, {
+        conditions,
+        dir: pkgdir,
+        parent
+      });
+      if (subpath === null) {
+        throw new ERR_PACKAGE_PATH_NOT_EXPORTED(
+          fileURLToPath(pkgdir),
+          id.path,
+          fileURLToPath(parent)
+        );
+      }
+      if (subpath.includes(PATTERN_CHARACTER)) {
+        subpath = subpath.slice(0, subpath.indexOf(PATTERN_CHARACTER)).slice(1);
+        subpath = "." + target.slice(target.indexOf(subpath));
+      }
+      if (pathe.extname(target) === pathe.extname(subpath)) {
+        subpath = pathe.changeExt(subpath, "");
+      }
+      return name + subpath.slice(1);
+    }
+    throw e;
+  }
+  return specifier;
+};
+var to_bare_specifier_default = toBareSpecifier;
+export {
+  to_bare_specifier_default as default
+};
+//# sourceMappingURL=to-bare-specifier.mjs.map

package/dist/utils/to-bare-specifier.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/to-bare-specifier.ts"],
+  "mappings": "AAMA,OAAO,YAAY;AACnB,OAAO,uBAAuB;AAE9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,iBAAiB;AAC1B,OAAO,WAAW;AAClB,SAAS,aAA4B;AACrC,SAAS,KAAK,eAAe,qBAAqB;AAClD,OAAO,gBAAgB;AACvB,OAAO,iBAAiB;AACxB,OAAO,yBAAyB;AAChC,OAAO,yBAAyB;AAChC,OAAO,wBAAwB;AAC/B,OAAO,mBAAmB;AAC1B,OAAO,kBAAkB;AACzB,OAAO,uBAAuB;AAC9B,OAAO,yBAAyB;AAChC,OAAO,eAAe;AACtB,OAAO,WAAW;AAqClB,MAAM,kBAAkB,CACtB,WACA,QACA,aAA0B,eACf;AACX,oBAAkB,WAAW,WAAW;AACxC,oBAAkB,QAAQ,QAAQ;AAGlC,MAAI,qBAAqB;AAAK,gBAAY,UAAU;AAGpD,MAAI,UAAU,SAAS;AAAG,WAAO,UAAU,SAAS;AAGpD,MAAI,UAAU,WAAW,OAAO;AAAG,gBAAY,cAAc,SAAS;AAGtE,MAAI,oBAAoB,SAAS,GAAG;AAClC,gBAAY,cAAc,oBAAoB,SAAS,CAAC;AAAA,EAC1D;AAOA,QAAM,MAAW;AAAA,IACf,oBAAoB,SAAS,KAAK,UAAU,WAAW,cAAc,IACjE,YACA,gBAAgB;AAAA,EACtB;AAOA,QAAM,QAAgC;AAAA,IACpC;AAAA,IACA,cAAc,GAAG;AAAA,EACnB;AAGA,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,qBAAqB,sBAAsB,sBAAsB;AAAA,EAC7E;AAGA,QAAM,EAAE,KAAK,QAAQ,QAAQ,IAAI;AAGjC,QAAM,EAAE,SAAS,MAAM,OAAO,IAAI,MAAM,IAAI;AAG5C,cAAY,IAAI,SAAS,SAAS,IAAI,IAClC,OAAO,IAAI,SAAS,QAAQ,IAAI,OAAO,MAAM,OAAO,IAAI,GAAG,GAAG,EAAE,IAChE,OAAO,UAAU,QAAQ,cAAc,OAAO,QAAQ,OAAO,EAAE,CAAC,GAAG,EAAE;AASzE,QAAM,KAAqB,cAAc,WAAW;AAAA,IAClD,UAAU;AAAA,IACV;AAAA,IACA,SAAS;AAAA,EACX,CAAC;AAGD,MAAI,MAAM,OAAO,GAAG;AAClB,WAAO,CAAC,MAAM,KAAK,EAAE,KAAK,QAAM,OAAO,GAAG,QAAQ,OAAO,GAAG,KAAK,MAAM,CAAC,CAAC,IACrE,GAAG,MACH;AAAA,EACN;AAGA,MAAI;AACF,iBAAa,WAAW,SAAS,EAAE,KAAK,QAAQ,OAAO,CAAC;AAAA,EAC1D,SAAS,GAAP;AAEA,QAAK,EAAgB,SAAS,UAAU,+BAA+B;AAMrE,YAAM,SAAiB,UAAU,QAAQ,MAAM,GAAG;AAQlD,UAAI,UAA4B,YAAY,QAAQ,SAAS;AAAA,QAC3D;AAAA,QACA,KAAK;AAAA,QACL;AAAA,MACF,CAAC;AAGD,UAAI,YAAY,MAAM;AACpB,cAAM,IAAI;AAAA,UACR,cAAc,MAAM;AAAA,UACpB,GAAG;AAAA,UACH,cAAc,MAAM;AAAA,QACtB;AAAA,MACF;AAGA,UAAI,QAAQ,SAAS,iBAAiB,GAAG;AACvC,kBAAU,QAAQ,MAAM,GAAG,QAAQ,QAAQ,iBAAiB,CAAC,EAAE,MAAM,CAAC;AACtE,kBAAU,MAAM,OAAO,MAAM,OAAO,QAAQ,OAAO,CAAC;AAAA,MACtD;AAIA,UAAI,MAAM,QAAQ,MAAM,MAAM,MAAM,QAAQ,OAAO,GAAG;AACpD,kBAAU,MAAM,UAAU,SAAS,EAAE;AAAA,MACvC;AAEA,aAAO,OAAO,QAAQ,MAAM,CAAC;AAAA,IAC/B;AAEA,UAAM;AAAA,EACR;AAEA,SAAO;AACT;AAEA,IAAO,4BAAQ;",
+  "names": []
+}

package/dist/{lib → utils}/to-data-url.d.mts

@@ -1,8 +1,8 @@
 /**
  * @file toDataURL
- * @module mlly/lib/toDataURL
+ * @module mlly/utils/toDataURL
  */
-import type { MIMEType } from '../types/index.mjs';
+import type { MimeType } from '../types/index.mjs';
 /**
  * Converts `code` into a [`data:` URL][1] using `base64` encoding.
  *
@@ -18,12 +18,13 @@ import type { MIMEType } from '../types/index.mjs';
  * [2]: https://nodejs.org/api/esm.html#terminology
  * [3]: {@link ./resolve-modules.ts}
  *
- * @see {@link MIMEType}
+ * @see {@linkcode MimeType}
  * @see https://nodejs.org/api/esm.html#esm_data_imports
  *
  * @param {string} code - Code to convert
- * @param {MIMEType} [mime='text/javascript'] - MIME type
+ * @param {MimeType} [mime='text/javascript'] - MIME type
  * @return {string} `code` as `data:` URL
+ * @throws {NodeError<TypeError>} If `code` or `mime` is not a string
  */
-declare const toDataURL: (code: string, mime?: MIMEType) => string;
+declare const toDataURL: (code: string, mime?: MimeType) => string;
 export default toDataURL;

package/dist/{lib → utils}/to-data-url.mjs

@@ -1,7 +1,11 @@
+import validateString from "../internal/validate-string.mjs";
 const toDataURL = (code, mime = "text/javascript") => {
+  validateString(code, "code");
+  validateString(mime, "mime");
   return `data:${mime};base64,${Buffer.from(code).toString("base64")}`;
 };
 var to_data_url_default = toDataURL;
 export {
   to_data_url_default as default
 };
+//# sourceMappingURL=to-data-url.mjs.map

package/dist/utils/to-data-url.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/to-data-url.ts"],
+  "mappings": "AAKA,OAAO,oBAAoB;AA2B3B,MAAM,YAAY,CAChB,MACA,OAAiB,sBACN;AACX,iBAAe,MAAM,MAAM;AAC3B,iBAAe,MAAM,MAAM;AAC3B,SAAO,QAAQ,eAAe,OAAO,KAAK,IAAI,EAAE,SAAS,QAAQ;AACnE;AAEA,IAAO,sBAAQ;",
+  "names": []
+}

package/dist/utils/to-node-url.d.mts

@@ -0,0 +1,19 @@
+/**
+ * @file toNodeURL
+ * @module mlly/utils/toNodeURL
+ */
+/**
+ * Converts the given module `specifier` to a `node:` URL.
+ *
+ * ::: warning
+ * Does not guarantee the new specifier is an existing Node.js builtin module.
+ * :::
+ *
+ * @see https://nodejs.org/api/esm.html#node-imports
+ *
+ * @param {string} specifier - Module specifier to convert
+ * @return {string} `specifier` as `node:` URL
+ * @throws {NodeError<TypeError>} If `specifier` is not a string
+ */
+declare const toNodeURL: (specifier: string) => string;
+export default toNodeURL;

package/dist/utils/to-node-url.mjs

@@ -0,0 +1,10 @@
+import validateString from "../internal/validate-string.mjs";
+const toNodeURL = (specifier) => {
+  validateString(specifier, "specifier");
+  return specifier.startsWith("node:") ? specifier : `node:${specifier}`;
+};
+var to_node_url_default = toNodeURL;
+export {
+  to_node_url_default as default
+};
+//# sourceMappingURL=to-node-url.mjs.map

package/dist/utils/to-node-url.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/to-node-url.ts"],
+  "mappings": "AAKA,OAAO,oBAAoB;AAgB3B,MAAM,YAAY,CAAC,cAA8B;AAC/C,iBAAe,WAAW,WAAW;AACrC,SAAO,UAAU,WAAW,OAAO,IAAI,YAAY,QAAQ;AAC7D;AAEA,IAAO,sBAAQ;",
+  "names": []
+}

package/dist/{lib → utils}/to-relative-specifier.d.mts

@@ -1,8 +1,8 @@
 /**
  * @file toRelativeSpecifier
- * @module mlly/lib/toRelativeSpecifier
+ * @module mlly/utils/toRelativeSpecifier
  */
-import { URL } from 'node:url';
+import type { ModuleId } from '../types/index.mjs';
 /**
  * Converts `specifier` into a relative specifier.
  *
@@ -11,12 +11,12 @@ import { URL } from 'node:url';
  * includes a file extension.
  * :::
  *
- * @see {@link URL}
+ * @see {@linkcode ModuleId}
  * @see https://nodejs.org/api/esm.html#terminology
  *
- * @param {URL | string} specifier - Module specifier to convert
- * @param {URL | string} parent - Parent module URL or path to resolve from
+ * @param {ModuleId} specifier - Module specifier to convert
+ * @param {ModuleId} parent - Parent module URL or path to resolve from
  * @return {string} `specifier` as relative specifier
  */
-declare const toRelativeSpecifier: (specifier: URL | string, parent: URL | string) => string;
+declare const toRelativeSpecifier: (specifier: ModuleId, parent: ModuleId) => string;
 export default toRelativeSpecifier;

package/dist/{lib → utils}/to-relative-specifier.mjs

@@ -1,5 +1,5 @@
-import { fileURLToPath, URL } from "node:url";
-import upath from "upath";
+import pathe from "@flex-development/pathe";
+import { URL, fileURLToPath } from "node:url";
 const toRelativeSpecifier = (specifier, parent) => {
   if (parent instanceof URL)
     parent = parent.href;
@@ -9,9 +9,13 @@ const toRelativeSpecifier = (specifier, parent) => {
     parent = fileURLToPath(parent);
   if (specifier.startsWith("file:"))
     specifier = fileURLToPath(specifier);
-  return upath.relative(upath.dirname(parent), specifier).replace(/^(\w)/, "./$1");
+  specifier = pathe.relative(pathe.resolve(parent), pathe.resolve(specifier)).replace(/^\.\.\/?/, "").replace(/^(\w)/, "./$1");
+  if (!specifier)
+    specifier = ".";
+  return specifier;
 };
 var to_relative_specifier_default = toRelativeSpecifier;
 export {
   to_relative_specifier_default as default
 };
+//# sourceMappingURL=to-relative-specifier.mjs.map

package/dist/utils/to-relative-specifier.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/to-relative-specifier.ts"],
+  "mappings": "AAMA,OAAO,WAAW;AAClB,SAAS,KAAK,qBAAqB;AAiBnC,MAAM,sBAAsB,CAAC,WAAqB,WAA6B;AAE7E,MAAI,kBAAkB;AAAK,aAAS,OAAO;AAC3C,MAAI,qBAAqB;AAAK,gBAAY,UAAU;AAGpD,MAAI,OAAO,WAAW,OAAO;AAAG,aAAS,cAAc,MAAM;AAC7D,MAAI,UAAU,WAAW,OAAO;AAAG,gBAAY,cAAc,SAAS;AAGtE,cAAY,MACT,SAAS,MAAM,QAAQ,MAAM,GAAG,MAAM,QAAQ,SAAS,CAAC,EACxD,QAAQ,YAAY,EAAE,EACtB,QAAQ,SAAS,MAAM;AAI1B,MAAI,CAAC;AAAW,gBAAY;AAE5B,SAAO;AACT;AAEA,IAAO,gCAAQ;",
+  "names": []
+}

package/dist/utils/to-url.d.mts

@@ -0,0 +1,22 @@
+/**
+ * @file toURL
+ * @module mlly/utils/toURL
+ */
+import type { ModuleId } from '../types/index.mjs';
+import { URL } from 'node:url';
+/**
+ * Converts the given module `id` to an instance of [`URL`][1].
+ *
+ * [1]: https://nodejs.org/api/url.html#class-url
+ *
+ * @see {@linkcode ModuleId}
+ *
+ * @param {ModuleId} id - Module id to evaluate
+ * @param {ModuleId?} [base=pathToFileURL('./')] - Base URL to resolve against
+ * if `id` is not absolute
+ * @return {URL} `id` as instance of `URL`
+ * @throws {NodeError<TypeError>} If either `id` or `base` is not a string or an
+ * instance of `URL`
+ */
+declare const toURL: (id: ModuleId, base?: ModuleId) => URL;
+export default toURL;

package/dist/utils/to-url.mjs

@@ -0,0 +1,12 @@
+import validateURLString from "../internal/validate-url-string.mjs";
+import { URL, pathToFileURL } from "node:url";
+const toURL = (id, base = pathToFileURL("./")) => {
+  validateURLString(id, "id");
+  validateURLString(base, "base");
+  return id instanceof URL ? id : new URL(id, base);
+};
+var to_url_default = toURL;
+export {
+  to_url_default as default
+};
+//# sourceMappingURL=to-url.mjs.map

package/dist/utils/to-url.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/to-url.ts"],
+  "mappings": "AAKA,OAAO,uBAAuB;AAG9B,SAAS,KAAK,qBAAqB;AAgBnC,MAAM,QAAQ,CAAC,IAAc,OAAiB,cAAc,IAAI,MAAW;AACzE,oBAAkB,IAAI,IAAI;AAC1B,oBAAkB,MAAM,MAAM;AAC9B,SAAO,cAAc,MAAM,KAAK,IAAI,IAAI,IAAI,IAAI;AAClD;AAEA,IAAO,iBAAQ;",
+  "names": []
+}

package/dist/utils/validate-assertions.d.mts

@@ -0,0 +1,23 @@
+/**
+ * @file validateAssertions
+ * @module mlly/utils/validateAssertions
+ */
+import type { Format } from '../enums/index.mjs';
+import type { ImportAssertions } from '../interfaces/index.mjs';
+import type { ModuleId } from '../types/index.mjs';
+import type { LiteralUnion } from '@flex-development/tutils';
+/**
+ * Test a module's `import` assertions.
+ *
+ * @see {@linkcode Format}
+ * @see {@linkcode ImportAssertions}
+ * @see {@linkcode ModuleId}
+ *
+ * @param {ModuleId} url - Module URL of imported module (for error reporting)
+ * @param {LiteralUnion<Format, string>} format - Module format
+ * @param {ImportAssertions} [assertions={}] - `import` assertions
+ * @return {true} `true` if `assertions` are valid
+ * @throws {NodeError<TypeError>}
+ */
+declare const validateAssertions: (url: ModuleId, format: LiteralUnion<Format, string>, assertions?: ImportAssertions) => true;
+export default validateAssertions;

package/dist/utils/validate-assertions.mjs

@@ -0,0 +1,52 @@
+import { AssertType } from "../enums/index.mjs";
+import FORMAT_TYPE_MAP from "../internal/format-type-map.mjs";
+import validateString from "../internal/validate-string.mjs";
+import validateURLString from "../internal/validate-url-string.mjs";
+import {
+  ERR_IMPORT_ASSERTION_TYPE_FAILED,
+  ERR_IMPORT_ASSERTION_TYPE_MISSING,
+  ERR_IMPORT_ASSERTION_TYPE_UNSUPPORTED
+} from "@flex-development/errnode";
+import { URL } from "node:url";
+const validateAssertions = (url, format, assertions = {}) => {
+  validateURLString(url, "url");
+  validateString(format, "format");
+  if (url instanceof URL)
+    url = url.href;
+  const has_type = Object.hasOwnProperty.call(assertions, "type");
+  const type = FORMAT_TYPE_MAP.get(format);
+  let err = false;
+  switch (type) {
+    case void 0:
+      break;
+    case AssertType.IMPLICIT:
+      if (has_type)
+        err = true;
+      break;
+    case assertions.type:
+      break;
+    default:
+      err = true;
+  }
+  if (err) {
+    if (!has_type)
+      throw new ERR_IMPORT_ASSERTION_TYPE_MISSING(url, type);
+    validateString(assertions.type, "assertions.type");
+    const supported = [];
+    for (const [, type2] of FORMAT_TYPE_MAP) {
+      if (type2 === AssertType.IMPLICIT)
+        continue;
+      supported.push(type2);
+    }
+    if (!supported.includes(assertions.type)) {
+      throw new ERR_IMPORT_ASSERTION_TYPE_UNSUPPORTED(assertions.type);
+    }
+    throw new ERR_IMPORT_ASSERTION_TYPE_FAILED(url, assertions.type);
+  }
+  return true;
+};
+var validate_assertions_default = validateAssertions;
+export {
+  validate_assertions_default as default
+};
+//# sourceMappingURL=validate-assertions.mjs.map

package/dist/utils/validate-assertions.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/validate-assertions.ts"],
+  "mappings": "AAMA,SAAS,kBAAkB;AAE3B,OAAO,qBAAqB;AAC5B,OAAO,oBAAoB;AAC3B,OAAO,uBAAuB;AAE9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,WAAW;AAepB,MAAM,qBAAqB,CACzB,KACA,QACA,aAA+B,CAAC,MACvB;AACT,oBAAkB,KAAK,KAAK;AAC5B,iBAAe,QAAQ,QAAQ;AAG/B,MAAI,eAAe;AAAK,UAAM,IAAI;AAOlC,QAAM,WAAoB,OAAO,eAAe,KAAK,YAAY,MAAM;AAOvE,QAAM,OAA+B,gBAAgB,IAAI,MAAgB;AAOzE,MAAI,MAAe;AAGnB,UAAQ,MAAM;AAAA,IACZ,KAAK;AAGH;AAAA,IACF,KAAK,WAAW;AAGd,UAAI;AAAU,cAAM;AACpB;AAAA,IACF,KAAK,WAAW;AAEd;AAAA,IACF;AAEE,YAAM;AAAA,EACV;AAGA,MAAI,KAAK;AAEP,QAAI,CAAC;AAAU,YAAM,IAAI,kCAAkC,KAAK,IAAK;AAGrE,mBAAe,WAAW,MAAM,iBAAiB;AAOjD,UAAM,YAA0B,CAAC;AAGjC,eAAW,CAAC,EAAEA,KAAI,KAAK,iBAAiB;AACtC,UAAIA,UAAS,WAAW;AAAU;AAClC,gBAAU,KAAKA,KAAI;AAAA,IACrB;AAGA,QAAI,CAAC,UAAU,SAAS,WAAW,IAAkB,GAAG;AACtD,YAAM,IAAI,sCAAsC,WAAW,IAAK;AAAA,IAClE;AAGA,UAAM,IAAI,iCAAiC,KAAK,WAAW,IAAK;AAAA,EAClE;AAEA,SAAO;AACT;AAEA,IAAO,8BAAQ;",
+  "names": ["type"]
+}

package/dist/utils/validate-exports.d.mts

@@ -0,0 +1,24 @@
+/**
+ * @file validateExports
+ * @module mlly/utils/validateExports
+ */
+import type { ModuleId } from '../types/index.mjs';
+import type { Exports } from '@flex-development/pkg-types';
+/**
+ * Validates the given package [`exports`][1] configuration and schema.
+ *
+ * [1]: https://nodejs.org/api/packages.html#exports
+ *
+ * @see {@linkcode Exports}
+ * @see {@linkcode ModuleId}
+ *
+ * @param {Exports | undefined} exports - Package `exports`
+ * @param {ModuleId} pkg - URL of relevant `package.json` file
+ * @param {ModuleId} parent - URL of module to resolve from
+ * @return {true} `true` if `exports` configuration and schema are valid
+ * @throws {NodeError<Error | TypeError>} If either `pkg` or `parent` is not an
+ * instance of {@linkcode URL} or a string, or if `exports` configuration or
+ * schema is invalid
+ */
+declare const validateExports: (exports: Exports | undefined, pkg: ModuleId, parent: ModuleId) => true;
+export default validateExports;

package/dist/utils/validate-exports.mjs

@@ -0,0 +1,72 @@
+import isArrayIndex from "../internal/is-array-index.mjs";
+import validateURLString from "../internal/validate-url-string.mjs";
+import {
+  ERR_INVALID_PACKAGE_CONFIG
+} from "@flex-development/errnode";
+import { isNIL } from "@flex-development/tutils";
+import { URL, fileURLToPath } from "node:url";
+const validateExports = (exports, pkg, parent) => {
+  switch (true) {
+    case Array.isArray(exports):
+      for (const item of exports) {
+        switch (true) {
+          case Array.isArray(item):
+          case isNIL(item):
+          case (typeof item !== "object" && typeof item !== "string"):
+            throw new ERR_INVALID_PACKAGE_CONFIG(
+              fileURLToPath(pkg),
+              fileURLToPath(parent),
+              'The "exports" array must contain either objects of package subpath keys, objects of condition name keys, or strings'
+            );
+          default:
+            validateExports(
+              item,
+              pkg,
+              parent
+            );
+            break;
+        }
+      }
+      break;
+    case isNIL(exports):
+    case typeof exports === "string":
+      break;
+    case typeof exports !== "object":
+      throw new ERR_INVALID_PACKAGE_CONFIG(
+        fileURLToPath(pkg),
+        fileURLToPath(parent),
+        '"exports" must be null, undefined, a string, an object of package subpath keys or condition name keys, or an array containing objects of package subpath keys, objects of condition name keys, or strings'
+      );
+    default:
+      exports = exports;
+      validateURLString(pkg, "pkg");
+      validateURLString(parent, "parent");
+      const keys = Object.getOwnPropertyNames(exports);
+      for (const [index, key] of keys.entries()) {
+        if (isArrayIndex(key)) {
+          throw new ERR_INVALID_PACKAGE_CONFIG(
+            fileURLToPath(new URL(".", pkg)),
+            fileURLToPath(parent),
+            '"exports" cannot contain numeric property keys'
+          );
+        }
+        if (index > 0) {
+          const prev = keys[index - 1];
+          if (!key.startsWith(".") && prev.startsWith(".") || key.startsWith(".") && !prev.startsWith(".")) {
+            throw new ERR_INVALID_PACKAGE_CONFIG(
+              fileURLToPath(pkg),
+              fileURLToPath(parent),
+              `"exports" cannot contain some keys starting with '.' and some not. The exports object must either be an object of package subpath keys or an object of main entry condition name keys only.`
+            );
+          }
+        }
+      }
+      break;
+  }
+  return true;
+};
+var validate_exports_default = validateExports;
+export {
+  validate_exports_default as default
+};
+//# sourceMappingURL=validate-exports.mjs.map

package/dist/utils/validate-exports.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/validate-exports.ts"],
+  "mappings": "AAKA,OAAO,kBAAkB;AACzB,OAAO,uBAAuB;AAE9B;AAAA,EACE;AAAA,OAEK;AAEP,SAAS,aAAa;AACtB,SAAS,KAAK,qBAAqB;AAkBnC,MAAM,kBAAkB,CACtB,SACA,KACA,WACS;AACT,UAAQ,MAAM;AAAA,IACZ,KAAK,MAAM,QAAQ,OAAO;AACxB,iBAAW,QAAQ,SAAsB;AACvC,gBAAQ,MAAM;AAAA,UACZ,KAAK,MAAM,QAAQ,IAAI;AAAA,UACvB,KAAK,MAAM,IAAI;AAAA,UACf,MAAK,OAAO,SAAS,YAAY,OAAO,SAAS;AAC/C,kBAAM,IAAI;AAAA,cACR,cAAc,GAAG;AAAA,cACjB,cAAc,MAAM;AAAA,cACpB;AAAA,YACF;AAAA,UACF;AACE;AAAA,cACE;AAAA,cACA;AAAA,cACA;AAAA,YACF;AACA;AAAA,QACJ;AAAA,MACF;AAEA;AAAA,IACF,KAAK,MAAM,OAAO;AAAA,IAClB,KAAK,OAAO,YAAY;AACtB;AAAA,IACF,KAAK,OAAO,YAAY;AACtB,YAAM,IAAI;AAAA,QACR,cAAc,GAAG;AAAA,QACjB,cAAc,MAAM;AAAA,QACpB;AAAA,MACF;AAAA,IACF;AACE,gBAAU;AAEV,wBAAkB,KAAK,KAAK;AAC5B,wBAAkB,QAAQ,QAAQ;AAOlC,YAAM,OAAiB,OAAO,oBAAoB,OAAO;AAGzD,iBAAW,CAAC,OAAO,GAAG,KAAK,KAAK,QAAQ,GAAG;AAEzC,YAAI,aAAa,GAAG,GAAG;AACrB,gBAAM,IAAI;AAAA,YACR,cAAc,IAAI,IAAI,KAAK,GAAG,CAAC;AAAA,YAC/B,cAAc,MAAM;AAAA,YACpB;AAAA,UACF;AAAA,QACF;AAIA,YAAI,QAAQ,GAAG;AAMb,gBAAM,OAAe,KAAK,QAAQ,CAAC;AAGnC,cACG,CAAC,IAAI,WAAW,GAAG,KAAK,KAAK,WAAW,GAAG,KAC3C,IAAI,WAAW,GAAG,KAAK,CAAC,KAAK,WAAW,GAAG,GAC5C;AACA,kBAAM,IAAI;AAAA,cACR,cAAc,GAAG;AAAA,cACjB,cAAc,MAAM;AAAA,cACpB;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA;AAAA,EACJ;AAEA,SAAO;AACT;AAEA,IAAO,2BAAQ;",
+  "names": []
+}