@endo/compartment-mapper 1.6.0 → 1.6.1

package/src/node-module-specifier.js

@@ -1,7 +1,9 @@
 /**
- * @module Provides functions for interacting with Node.js module specifiers in
+ * Provides functions for interacting with Node.js module specifiers in
  * their canonical form.
  * This is a kind of path math that is platform-agnostic.
+ *
+ * @module
  */
 
 // q, as in quote, for error messages.

package/src/node-modules.d.ts

@@ -1,6 +1,6 @@
 export function basename(location: string): string;
-export function compartmentMapForNodeModules(readPowers: ReadFn | ReadPowers | MaybeReadPowers, packageLocation: string, conditionsOption: Set<string>, packageDescriptor: PackageDescriptor, moduleSpecifier: string, options?: CompartmentMapForNodeModulesOptions | undefined): Promise<CompartmentMapDescriptor>;
-export function mapNodeModules(readPowers: ReadFn | ReadPowers | MaybeReadPowers, moduleLocation: string, { tags, conditions, log, ...otherOptions }?: MapNodeModulesOptions | undefined): Promise<CompartmentMapDescriptor>;
+export function compartmentMapForNodeModules(readPowers: ReadFn | ReadPowers | MaybeReadPowers, packageLocation: string, conditionsOption: Set<string>, packageDescriptor: PackageDescriptor, moduleSpecifier: string, options?: CompartmentMapForNodeModulesOptions): Promise<CompartmentMapDescriptor>;
+export function mapNodeModules(readPowers: ReadFn | ReadPowers | MaybeReadPowers, moduleLocation: string, { tags, conditions, log, ...otherOptions }?: MapNodeModulesOptions): Promise<CompartmentMapDescriptor>;
 import type { ReadFn } from './types.js';
 import type { ReadPowers } from './types.js';
 import type { MaybeReadPowers } from './types.js';

package/src/node-modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-modules.d.ts","sourceRoot":"","sources":["node-modules.js"],"names":[],"mappings":"AAiFO,mCAHI,MAAM,GACJ,MAAM,CAYlB;AAuwBM,yDATI,MAAM,GAAG,UAAU,GAAG,eAAe,mBACrC,MAAM,oBACN,GAAG,CAAC,MAAM,CAAC,qBACX,iBAAiB,mBACjB,MAAM,8DAEJ,OAAO,CAAC,wBAAwB,CAAC,CAkE7C;AAaM,2CALI,MAAM,GAAG,UAAU,GAAG,eAAe,kBACrC,MAAM,mFAEJ,OAAO,CAAC,wBAAwB,CAAC,CA0B7C;4BAz6BS,YAAY;gCAAZ,YAAY;qCAAZ,YAAY;uCAAZ,YAAY;yDAAZ,YAAY;8CAAZ,YAAY;2CAAZ,YAAY"}
+{"version":3,"file":"node-modules.d.ts","sourceRoot":"","sources":["node-modules.js"],"names":[],"mappings":"AAmFO,mCAHI,MAAM,GACJ,MAAM,CAYlB;AA43BM,yDATI,MAAM,GAAG,UAAU,GAAG,eAAe,mBACrC,MAAM,oBACN,GAAG,CAAC,MAAM,CAAC,qBACX,iBAAiB,mBACjB,MAAM,YACN,mCAAmC,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAkE7C;AAaM,2CALI,MAAM,GAAG,UAAU,GAAG,eAAe,kBACrC,MAAM,+CACN,qBAAqB,GACnB,OAAO,CAAC,wBAAwB,CAAC,CA0B7C;4BA9hCS,YAAY;gCAAZ,YAAY;qCAAZ,YAAY;uCAAZ,YAAY;yDAAZ,YAAY;8CAAZ,YAAY;2CAAZ,YAAY"}

package/src/node-modules.js

@@ -1,5 +1,5 @@
 /**
- * @module Provides functions for constructing a compartment map that has a
+ * Provides functions for constructing a compartment map that has a
  * compartment descriptor corresponding to every reachable package from an
  * entry module and how to create links between them.
  * The resulting compartment map does not describe individual modules but does
@@ -7,6 +7,8 @@
  * wildcard expansion.
  * See {@link link} to expand a compartment map to capture module descriptors
  * for transitive dependencies.
+ *
+ * @module
  */
 
 /* eslint no-shadow: 0 */
@@ -53,7 +55,7 @@ import {
 import { unpackReadPowers } from './powers.js';
 import { search, searchDescriptor } from './search.js';
 
-const { assign, create, keys, values } = Object;
+const { assign, create, keys, values, entries } = Object;
 
 const decoder = new TextDecoder();
 
@@ -123,6 +125,90 @@ const readDescriptorWithMemo = async (memo, maybeRead, packageLocation) => {
   return promise;
 };
 
+/**
+ * Compares `logicalPath` to the current best logical path in `preferredPackageLogicalPathMap` for `packageLocation`.
+ *
+ * If no current best path exists, it returns `logicalPath`.
+ *
+ * @template {string[]} T
+ * @template {string[]} U
+ * @param {T} logicalPath
+ * @param {string} packageLocation
+ * @param {Map<string, U>} preferredPackageLogicalPathMap
+ * @returns {T|U}
+ */
+const currentBestLogicalPath = (
+  logicalPath,
+  packageLocation,
+  preferredPackageLogicalPathMap,
+) => {
+  const theCurrentBest = preferredPackageLogicalPathMap.get(packageLocation);
+  if (theCurrentBest === undefined) {
+    return logicalPath;
+  }
+  return pathCompare(logicalPath, theCurrentBest) < 0
+    ? logicalPath
+    : theCurrentBest;
+};
+
+/**
+ * Updates the shortest paths in a subgraph of `graph` starting with `packageLocation`.
+ *
+ * This should be called upon the second (and each subsequent) visit to a graph node.
+ *
+ * @param {Graph} graph Graph
+ * @param {string} packageLocation Location of the package to start with
+ * @param {string[]} logicalPath Current path parts of the same package
+ * @param {Map<string, string[]>} [preferredPackageLogicalPathMap] Mapping of shortest known paths for each package location
+ * @returns {void}
+ */
+const updateShortestPaths = (
+  graph,
+  packageLocation,
+  logicalPath,
+  preferredPackageLogicalPathMap = new Map(),
+) => {
+  const node = graph[packageLocation];
+  if (!node) {
+    throw new ReferenceError(
+      `Cannot find package at ${packageLocation} in graph`,
+    );
+  }
+
+  const bestLogicalPath = currentBestLogicalPath(
+    logicalPath,
+    packageLocation,
+    preferredPackageLogicalPathMap,
+  );
+
+  if (bestLogicalPath === logicalPath) {
+    preferredPackageLogicalPathMap.set(packageLocation, bestLogicalPath);
+
+    for (const name of keys(node.dependencyLocations).sort()) {
+      const packageLocation = node.dependencyLocations[name];
+      if (!packageLocation) {
+        // "should never happen"
+        throw new ReferenceError(
+          `Expected graph node ${q(node.name)} to contain a dependency location for ${q(name)}`,
+        );
+      }
+      updateShortestPaths(
+        graph,
+        packageLocation,
+        [...logicalPath, name],
+        preferredPackageLogicalPathMap,
+      );
+    }
+  }
+
+  // a path length of 0 means the node represents the eventual entry compartment.
+  // we do not want to mess with that path.
+  if (node.path.length && node.path !== bestLogicalPath) {
+    node.path = bestLogicalPath;
+  }
+
+  return undefined;
+};
 /**
  * `findPackage` behaves as Node.js to find third-party modules by searching
  * parent to ancestor directories for a `node_modules` directory that contains
@@ -291,6 +377,13 @@ const graphPackage = async (
   } = {},
 ) => {
   if (graph[packageLocation] !== undefined) {
+    updateShortestPaths(
+      graph,
+      packageLocation,
+      logicalPath,
+      preferredPackageLogicalPathMap,
+    );
+
     // Returning the promise here would create a causal cycle and stall recursion.
     return undefined;
   }
@@ -310,7 +403,20 @@ const graphPackage = async (
   const dependencyLocations = {};
   /** @type {ReturnType<typeof gatherDependency>[]} */
   const children = [];
+
+  /**
+   * A set containing dependency names which are considered "optional"
+   */
   const optionals = new Set();
+
+  /**
+   * Contains the names of _all_ dependencies
+   *
+   * @type {Set<string>}
+   */
+  const allDependencies = new Set();
+
+  // these are fields from package.json containing dependencies
   const {
     dependencies = {},
     peerDependencies = {},
@@ -319,32 +425,40 @@ const graphPackage = async (
     optionalDependencies = {},
     devDependencies = {},
   } = packageDescriptor;
-  const allDependencies = {};
-  for (const [name, descriptor] of Object.entries(
-    commonDependencyDescriptors,
-  )) {
+
+  for (const [name, descriptor] of entries(commonDependencyDescriptors)) {
     if (Object(descriptor) === descriptor) {
-      const { spec } = descriptor;
-      allDependencies[name] = spec;
+      allDependencies.add(name);
     }
   }
-  assign(allDependencies, dependencies);
-  assign(allDependencies, peerDependencies);
-  for (const [name, meta] of Object.entries(peerDependenciesMeta)) {
+
+  // only consider devDependencies if dev flag is true
+  for (const name of keys({
+    ...dependencies,
+    ...peerDependencies,
+    ...bundleDependencies,
+    ...optionalDependencies,
+    ...(dev ? devDependencies : {}),
+  })) {
+    allDependencies.add(name);
+  }
+
+  // for historical reasons, some packages omit peerDependencies and only
+  // use the peerDependenciesMeta field (because there was no way to define
+  // an "optional" peerDependency prior to npm v7). this is plainly wrong,
+  // but not exactly rare, either
+  for (const [name, meta] of entries(peerDependenciesMeta)) {
     if (Object(meta) === meta && meta.optional) {
       optionals.add(name);
+      allDependencies.add(name);
     }
   }
-  assign(allDependencies, bundleDependencies);
-  assign(allDependencies, optionalDependencies);
-  for (const name of Object.keys(optionalDependencies)) {
+
+  for (const name of keys(optionalDependencies)) {
     optionals.add(name);
   }
-  if (dev) {
-    assign(allDependencies, devDependencies);
-  }
 
-  for (const name of keys(allDependencies).sort()) {
+  for (const name of [...allDependencies].sort()) {
     const optional = optionals.has(name);
     const childLogicalPath = [...logicalPath, name];
     children.push(
@@ -407,7 +521,7 @@ const graphPackage = async (
 
   const sourceDirname = basename(packageLocation);
 
-  Object.assign(result, {
+  assign(result, {
     name,
     path: logicalPath,
     label: `${name}${version ? `-v${version}` : ''}`,
@@ -432,7 +546,7 @@ const graphPackage = async (
   await Promise.all(children);
 
   // handle commonDependencyDescriptors package aliases
-  for (const [name, { alias }] of Object.entries(commonDependencyDescriptors)) {
+  for (const [name, { alias }] of entries(commonDependencyDescriptors)) {
     // update the dependencyLocations to point to the common dependency
     const targetLocation = dependencyLocations[name];
     if (targetLocation === undefined) {
@@ -510,15 +624,20 @@ const gatherDependency = async (
     throw Error(`Cannot find dependency ${name} for ${packageLocation}`);
   }
   dependencyLocations[name] = dependency.packageLocation;
-  const theCurrentBest = preferredPackageLogicalPathMap.get(
+
+  const bestLogicalPath = currentBestLogicalPath(
+    childLogicalPath,
     dependency.packageLocation,
+    preferredPackageLogicalPathMap,
   );
-  if (pathCompare(childLogicalPath, theCurrentBest) < 0) {
+
+  if (bestLogicalPath === childLogicalPath) {
     preferredPackageLogicalPathMap.set(
       dependency.packageLocation,
-      childLogicalPath,
+      bestLogicalPath,
     );
   }
+
   await graphPackage(
     name,
     readDescriptor,
@@ -598,7 +717,7 @@ const graphPackages = async (
   /** @type {CommonDependencyDescriptors} */
   const commonDependencyDescriptors = {};
   const packageDescriptorDependencies = packageDescriptor.dependencies || {};
-  for (const [alias, dependencyName] of Object.entries(commonDependencies)) {
+  for (const [alias, dependencyName] of entries(commonDependencies)) {
     const spec = packageDescriptorDependencies[dependencyName];
     if (spec === undefined) {
       throw Error(
@@ -653,7 +772,7 @@ const translateGraph = (
   policy,
 ) => {
   /** @type {CompartmentMapDescriptor['compartments']} */
-  const compartments = Object.create(null);
+  const compartments = create(null);
 
   // For each package, build a map of all the external modules the package can
   // import from other packages.
@@ -676,9 +795,9 @@ const translateGraph = (
       types,
     } = graph[dependeeLocation];
     /** @type {CompartmentDescriptor['modules']} */
-    const moduleDescriptors = Object.create(null);
+    const moduleDescriptors = create(null);
     /** @type {CompartmentDescriptor['scopes']} */
-    const scopes = Object.create(null);
+    const scopes = create(null);
 
     /**
      * List of all the compartments (by name) that this compartment can import from.
@@ -838,10 +957,10 @@ const makeLanguageOptions = ({
   };
 
   const languages = new Set([
-    ...Object.values(moduleLanguageForExtension),
-    ...Object.values(commonjsLanguageForExtension),
-    ...Object.values(workspaceModuleLanguageForExtension),
-    ...Object.values(workspaceCommonjsLanguageForExtension),
+    ...values(moduleLanguageForExtension),
+    ...values(commonjsLanguageForExtension),
+    ...values(workspaceModuleLanguageForExtension),
+    ...values(workspaceCommonjsLanguageForExtension),
     ...additionalLanguages,
   ]);
 

package/src/node-powers.d.ts

@@ -37,7 +37,7 @@ export function makeWritePowers({ fs, url }: {
 }): {
     write: (location: string, data: Uint8Array) => Promise<void>;
 };
-export function makeNodeReadPowers(fs: FsInterface, crypto?: CryptoInterface | undefined): ReadPowers;
+export function makeNodeReadPowers(fs: FsInterface, crypto?: CryptoInterface): ReadPowers;
 export function makeNodeWritePowers(fs: FsInterface): WritePowers;
 import type { FsInterface } from './types/node-powers.js';
 import type { UrlInterface } from './types/node-powers.js';

package/src/node-powers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-powers.d.ts","sourceRoot":"","sources":["node-powers.js"],"names":[],"mappings":"AA0LO,8DANJ;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;IACA,MAAM;IACR,IAAI;CACjC,GAAU,eAAe,GAAG,aAAa,CAoC3C;AAlKD;;;;;;;;;;;GAWG;AACH,2DANG;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;IACA,MAAM;IACR,IAAI;CACjC,GAAU,eAAe,CA0G3B;AAgDD;;;;;;;;GAQG;AACH,6CAHG;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;CAAC;sBAOtB,MAAM,QACN,UAAU;EAYtB;AA2BM,uCALI,WAAW,yCAET,UAAU,CAKtB;AAWM,wCAJI,WAAW,GACT,WAAW,CAKvB;iCApRS,wBAAwB;kCAAxB,wBAAwB;qCAAxB,wBAAwB;mCAAxB,wBAAwB;qCAexB,mBAAmB;mCAAnB,mBAAmB;gCAAnB,mBAAmB;iCAAnB,mBAAmB"}
+{"version":3,"file":"node-powers.d.ts","sourceRoot":"","sources":["node-powers.js"],"names":[],"mappings":"AA4LO,8DANJ;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;IACA,MAAM;IACR,IAAI;CACjC,GAAU,eAAe,GAAG,aAAa,CAoC3C;AAlKD;;;;;;;;;;;GAWG;AACH,2DANG;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;IACA,MAAM;IACR,IAAI;CACjC,GAAU,eAAe,CA0G3B;AAgDD;;;;;;;;GAQG;AACH,6CAHG;IAA0B,EAAE,EAApB,WAAW;IACS,GAAG;CAAC;sBAOtB,MAAM,QACN,UAAU;EAYtB;AA2BM,uCALI,WAAW,WACX,eAAe,GACb,UAAU,CAKtB;AAWM,wCAJI,WAAW,GACT,WAAW,CAKvB;iCApRS,wBAAwB;kCAAxB,wBAAwB;qCAAxB,wBAAwB;mCAAxB,wBAAwB;qCAexB,mBAAmB;mCAAnB,mBAAmB;gCAAnB,mBAAmB;iCAAnB,mBAAmB"}

package/src/node-powers.js

@@ -1,10 +1,12 @@
 /**
- * @module Provides adapters for Compartment Mapper I/O to the corresponding
+ * Provides adapters for Compartment Mapper I/O to the corresponding
  * Node.js implementations of those behaviors.
  *
  * The Compartment Mapper generalizes its I/O interface to allow for a wide
  * variety of I/O providers, but especially for reading and writing from
  * virtualized file systems like zip files.
+ *
+ * @module
  */
 
 /**

package/src/parse-archive-cjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseArchiveCjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: true;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-archive-cjs.d.ts.map

package/src/parse-archive-cjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-archive-cjs.d.ts","sourceRoot":"","sources":["parse-archive-cjs.js"],"names":[],"mappings":"AAkBA,sBAAsB;AACtB,8BADW,OAAO,CAkDhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BAjEzB,YAAY"}
+{"version":3,"file":"parse-archive-cjs.d.ts","sourceRoot":"","sources":["parse-archive-cjs.js"],"names":[],"mappings":"AAoBA,sBAAsB;AACtB,8BADW,OAAO,CAkDhB;;;;;;;6BA/DyB,YAAY"}

package/src/parse-archive-cjs.js

@@ -1,6 +1,8 @@
 /**
- * @module Provides language behavior for analyzing, pre-compiling, and storing
+ * Provides language behavior for analyzing, pre-compiling, and storing
  * CommonJS modules for an archive.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/parse-archive-mjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseArchiveMjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-archive-mjs.d.ts.map

package/src/parse-archive-mjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-archive-mjs.d.ts","sourceRoot":"","sources":["parse-archive-mjs.js"],"names":[],"mappings":"AAYA,sBAAsB;AACtB,8BADW,OAAO,CAqBhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BA9BzB,YAAY"}
+{"version":3,"file":"parse-archive-mjs.d.ts","sourceRoot":"","sources":["parse-archive-mjs.js"],"names":[],"mappings":"AAcA,sBAAsB;AACtB,8BADW,OAAO,CAqBhB;;;;;;;6BA5ByB,YAAY"}

package/src/parse-archive-mjs.js

@@ -1,6 +1,8 @@
 /**
- * @module Provides language behavior for analyzing, pre-compiling, and storing ESM
+ * Provides language behavior for analyzing, pre-compiling, and storing ESM
  * modules for an archive.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/parse-bytes.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseBytes: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-bytes.d.ts.map

package/src/parse-bytes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-bytes.d.ts","sourceRoot":"","sources":["parse-bytes.js"],"names":[],"mappings":"AAgBA,sBAAsB;AACtB,yBADW,OAAO,CA0BhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BAtCzB,YAAY"}
+{"version":3,"file":"parse-bytes.d.ts","sourceRoot":"","sources":["parse-bytes.js"],"names":[],"mappings":"AAkBA,sBAAsB;AACtB,yBADW,OAAO,CA0BhB;;;;;;;6BApCyB,YAAY"}

package/src/parse-bytes.js

@@ -1,6 +1,8 @@
 /**
- * @module Provides rudimentary support for treating an arbitrary file as a
+ * Provides rudimentary support for treating an arbitrary file as a
  * module that exports the bytes of that file.
+ *
+ * @module
  */
 
 /** @import {Harden} from 'ses' */

package/src/parse-cjs-shared-export-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-cjs-shared-export-wrapper.d.ts","sourceRoot":"","sources":["parse-cjs-shared-export-wrapper.js"],"names":[],"mappings":"AAwCO,2CAPI,UAAU,GAAG,MAAM,GAAG,SAAS,YAC/B,MAAM,GACJ;IACR,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAC,IAAI,CAAA;CACrB,CAgCH;AAmBM,uGAZJ;IAAmB,uBAAuB,EAAlC,MAAM;IACU,WAAW,EAA3B,WAAW;IACgB,eAAe,EAA1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACX,QAAQ,EAAnB,MAAM;IAC8B,UAAU,EAA9C,MAAM,GAAG,UAAU,GAAG,SAAS;CACvC,GAAU;IACR,MAAM,EAAE;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC;IACzB,aAAa,EAAE,GAAG,CAAC;IACnB,YAAY,WAAW;IACvB,OAAO,WAAW;CACnB,CA2HH;gCA5MqC,YAAY;4BAAZ,YAAY"}
+{"version":3,"file":"parse-cjs-shared-export-wrapper.d.ts","sourceRoot":"","sources":["parse-cjs-shared-export-wrapper.js"],"names":[],"mappings":"AA0CO,2CAPI,UAAU,GAAG,MAAM,GAAG,SAAS,YAC/B,MAAM,GACJ;IACR,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAC,IAAI,CAAA;CACrB,CAgCH;AAmBM,uGAZJ;IAAmB,uBAAuB,EAAlC,MAAM;IACU,WAAW,EAA3B,WAAW;IACgB,eAAe,EAA1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACX,QAAQ,EAAnB,MAAM;IAC8B,UAAU,EAA9C,MAAM,GAAG,UAAU,GAAG,SAAS;CACvC,GAAU;IACR,MAAM,EAAE;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,CAAC;IACzB,aAAa,EAAE,GAAG,CAAC;IACnB,YAAY,WAAW;IACvB,OAAO,WAAW;CACnB,CA2HH;gCA5MqC,YAAY;4BAAZ,YAAY"}

package/src/parse-cjs-shared-export-wrapper.js

@@ -1,7 +1,9 @@
 /**
- * @module Provides shared functionality for {@link parse-cjs.js} and {@link
+ * Provides shared functionality for {@link parse-cjs.js} and {@link
  * parse-archive-cjs.js} toward importing or archiving CommonJS as a virtual
  * module source.
+ *
+ * @module
  */
 
 /** @import {ReadFn, ReadPowers} from './types.js' */

package/src/parse-cjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseCjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: true;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-cjs.d.ts.map

package/src/parse-cjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-cjs.d.ts","sourceRoot":"","sources":["parse-cjs.js"],"names":[],"mappings":"AAcA,sBAAsB;AACtB,uBADW,OAAO,CA0DhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BArEzB,YAAY"}
+{"version":3,"file":"parse-cjs.d.ts","sourceRoot":"","sources":["parse-cjs.js"],"names":[],"mappings":"AAgBA,sBAAsB;AACtB,uBADW,OAAO,CA0DhB;;;;;;;6BAnEyB,YAAY"}

package/src/parse-cjs.js

@@ -1,6 +1,8 @@
 /**
- * @module Provides language behavior (parser) for importing CommonJS as a
+ * Provides language behavior (parser) for importing CommonJS as a
  * virtual module source.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/parse-json.d.ts

@@ -1,7 +1,10 @@
 /** @type {ParseFn} */
 export const parseJson: ParseFn;
-declare const _default: ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
-import type { ParserImplementation } from './types.js';
 //# sourceMappingURL=parse-json.d.ts.map

package/src/parse-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-json.d.ts","sourceRoot":"","sources":["parse-json.js"],"names":[],"mappings":"AAmBA,sBAAsB;AACtB,wBADW,OAAO,CAqBhB;wBAES,oBAAoB;;6BAtCiB,YAAY;0CAAZ,YAAY"}
+{"version":3,"file":"parse-json.d.ts","sourceRoot":"","sources":["parse-json.js"],"names":[],"mappings":"AAmBA,sBAAsB;AACtB,wBADW,OAAO,CAqBhB;;;;;;;6BApC8C,YAAY"}

package/src/parse-mjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseMjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-mjs.d.ts.map

package/src/parse-mjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-mjs.d.ts","sourceRoot":"","sources":["parse-mjs.js"],"names":[],"mappings":"AAQA,sBAAsB;AACtB,uBADW,OAAO,CAqBhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BA7BzB,YAAY"}
+{"version":3,"file":"parse-mjs.d.ts","sourceRoot":"","sources":["parse-mjs.js"],"names":[],"mappings":"AAQA,sBAAsB;AACtB,uBADW,OAAO,CAqBhB;;;;;;;6BA3ByB,YAAY"}

package/src/parse-pre-cjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parsePreCjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: true;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-pre-cjs.d.ts.map

package/src/parse-pre-cjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-pre-cjs.d.ts","sourceRoot":"","sources":["parse-pre-cjs.js"],"names":[],"mappings":"AAeA,sBAAsB;AACtB,0BADW,OAAO,CAuDhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BAhEzB,YAAY"}
+{"version":3,"file":"parse-pre-cjs.d.ts","sourceRoot":"","sources":["parse-pre-cjs.js"],"names":[],"mappings":"AAiBA,sBAAsB;AACtB,0BADW,OAAO,CAuDhB;;;;;;;6BA9DyB,YAAY"}

package/src/parse-pre-cjs.js

@@ -1,9 +1,11 @@
 /**
- * @module Provides language-specific behavior for importing pre-compiled
+ * Provides language-specific behavior for importing pre-compiled
  * CommonJS.
  * Pre-compiled CommonJS is a module in JSON format that describes its imports,
  * exports, and source to execute in the presence of `require`, `module`, and
  * `exports`.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/parse-pre-mjs.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parsePreMjs: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-pre-mjs.d.ts.map

package/src/parse-pre-mjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-pre-mjs.d.ts","sourceRoot":"","sources":["parse-pre-mjs.js"],"names":[],"mappings":"AAaA,sBAAsB;AACtB,0BADW,OAAO,CAsBhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BA9BzB,YAAY"}
+{"version":3,"file":"parse-pre-mjs.d.ts","sourceRoot":"","sources":["parse-pre-mjs.js"],"names":[],"mappings":"AAeA,sBAAsB;AACtB,0BADW,OAAO,CAsBhB;;;;;;;6BA5ByB,YAAY"}

package/src/parse-pre-mjs.js

@@ -1,8 +1,10 @@
 /**
- * @module Provides language-specific behaviors for importing pre-compiled ESM.
+ * Provides language-specific behaviors for importing pre-compiled ESM.
  * Pre-compiling or translating ESM from a module to a script with a
  * calling-convention is necessary to prepare an archive so that it can be
  * imported by the SES shim without entraining a dependency on Babel.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/parse-text.d.ts

@@ -1,6 +1,10 @@
 /** @type {ParseFn} */
 export const parseText: ParseFn;
-declare const _default: import("./types.js").ParserImplementation;
+declare const _default: {
+    parse: ParseFn;
+    heuristicImports: false;
+    synchronous: true;
+};
 export default _default;
 import type { ParseFn } from './types.js';
 //# sourceMappingURL=parse-text.d.ts.map

package/src/parse-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-text.d.ts","sourceRoot":"","sources":["parse-text.js"],"names":[],"mappings":"AAkBA,sBAAsB;AACtB,wBADW,OAAO,CAuBhB;wBAES,OAAO,YAAY,EAAE,oBAAoB;;6BArCzB,YAAY"}
+{"version":3,"file":"parse-text.d.ts","sourceRoot":"","sources":["parse-text.js"],"names":[],"mappings":"AAoBA,sBAAsB;AACtB,wBADW,OAAO,CAuBhB;;;;;;;6BAnCyB,YAAY"}

package/src/parse-text.js

@@ -1,7 +1,9 @@
 /**
- * @module Provides language-behaviors for importing a module as a document
+ * Provides language-behaviors for importing a module as a document
  * that exports itself as a string based on a UTF-8 interpretation of the
  * module's text.
+ *
+ * @module
  */
 
 /** @import {ParseFn} from './types.js' */

package/src/policy-format.d.ts

@@ -1,8 +1,9 @@
+export const WILDCARD_POLICY_VALUE: "any";
 export function policyLookupHelper(packagePolicy: import("./types.js").PackagePolicy, field: "builtins" | "globals" | "packages", itemName: string): boolean | import("./types.js").AttenuationDefinition;
 export function isAllowingEverything(policyValue: unknown): policyValue is import("./types.js").WildcardPolicy;
 export function isAttenuationDefinition(allegedDefinition: unknown): allegedDefinition is import("./types.js").AttenuationDefinition;
 export function getAttenuatorFromDefinition(attenuationDefinition: import("./types.js").AttenuationDefinition): import("./types.js").UnifiedAttenuationDefinition;
-export function assertPackagePolicy(allegedPackagePolicy: unknown, path: string, url?: string | undefined): asserts allegedPackagePolicy is SomePackagePolicy | undefined;
+export function assertPackagePolicy(allegedPackagePolicy: unknown, path: string, url?: string): asserts allegedPackagePolicy is SomePackagePolicy | undefined;
 export function assertPolicy(allegedPolicy: unknown): asserts allegedPolicy is (SomePolicy | undefined);
 import type { SomePackagePolicy } from './types.js';
 import type { SomePolicy } from './types.js';

package/src/policy-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy-format.d.ts","sourceRoot":"","sources":["policy-format.js"],"names":[],"mappings":"AA2BO,kDALI,OAAO,YAAY,EAAE,aAAa,SAClC,UAAU,GAAC,SAAS,GAAC,UAAU,YAC/B,MAAM,GACJ,OAAO,GAAG,OAAO,YAAY,EAAE,qBAAqB,CAyBhE;AAQM,kDAHI,OAAO,GACL,WAAW,IAAI,OAAO,YAAY,EAAE,cAAc,CAGxB;AAOhC,2DAHI,OAAO,GACL,iBAAiB,IAAI,OAAO,YAAY,EAAE,qBAAqB,CAS3E;AAOM,mEAHI,OAAO,YAAY,EAAE,qBAAqB,GACxC,OAAO,YAAY,EAAE,4BAA4B,CAuB7D;AA0CM,0DALI,OAAO,QACP,MAAM,6BAEJ,QAAQ,oBAAoB,IAAI,iBAAiB,GAAC,SAAS,CA4DvE;AAUM,4CAHI,OAAO,GACL,QAAQ,aAAa,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,CAgC7D;uCA5OgD,YAAY;gCAAZ,YAAY"}
+{"version":3,"file":"policy-format.d.ts","sourceRoot":"","sources":["policy-format.js"],"names":[],"mappings":"AAeA,oCAAqC,KAAK,CAAC;AAepC,kDALI,OAAO,YAAY,EAAE,aAAa,SAClC,UAAU,GAAC,SAAS,GAAC,UAAU,YAC/B,MAAM,GACJ,OAAO,GAAG,OAAO,YAAY,EAAE,qBAAqB,CAyBhE;AAQM,kDAHI,OAAO,GACL,WAAW,IAAI,OAAO,YAAY,EAAE,cAAc,CAGxB;AAOhC,2DAHI,OAAO,GACL,iBAAiB,IAAI,OAAO,YAAY,EAAE,qBAAqB,CAS3E;AAOM,mEAHI,OAAO,YAAY,EAAE,qBAAqB,GACxC,OAAO,YAAY,EAAE,4BAA4B,CAuB7D;AA0CM,0DALI,OAAO,QACP,MAAM,QACN,MAAM,GACJ,QAAQ,oBAAoB,IAAI,iBAAiB,GAAC,SAAS,CA4DvE;AAUM,4CAHI,OAAO,GACL,QAAQ,aAAa,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,CAgC7D;uCA7OgD,YAAY;gCAAZ,YAAY"}