@endo/compartment-mapper 1.3.0 → 1.4.0

package/src/import-lite.js

@@ -1,5 +1,6 @@
-/* Provides functions for evaluating a module and its transitive dependencies
- * given a partially completed compartment map.
+/**
+ * @module Provides functions for evaluating a module and its transitive
+ * dependencies given a partially completed compartment map.
  * The compartment map needs to describe every reachable compartment, where to
  * find modules in that compartment, and how to link modules between
  * compartments, but does not need to capture a module descriptor for every
@@ -14,19 +15,22 @@
  * `@endo/compartment-mapper/import-parsers.js` or similar.
  */
 
-// @ts-check
 /* eslint no-shadow: "off" */
-/** @import {CompartmentMapDescriptor} from './types.js' */
-/** @import {SyncImportLocationOptions} from './types.js' */
-/** @import {ImportNowHookMaker} from './types.js' */
-/** @import {ModuleTransforms} from './types.js' */
-/** @import {ReadNowPowers} from './types.js' */
-/** @import {Application} from './types.js' */
-/** @import {ImportLocationOptions} from './types.js' */
-/** @import {ExecuteFn} from './types.js' */
-/** @import {ReadFn} from './types.js' */
-/** @import {ReadPowers} from './types.js' */
-/** @import {SomeObject} from './types.js' */
+
+/**
+ * @import {
+ *   CompartmentMapDescriptor,
+ *   SyncImportLocationOptions,
+ *   ImportNowHookMaker,
+ *   ReadNowPowers,
+ *   Application,
+ *   ImportLocationOptions,
+ *   ExecuteFn,
+ *   ReadFn,
+ *   ReadPowers,
+ *   SomeObject,
+ * } from './types.js'
+ */
 
 import { link } from './link.js';
 import {
@@ -91,15 +95,12 @@ export const loadFromMap = async (readPowers, compartmentMap, options = {}) => {
   const {
     searchSuffixes = undefined,
     parserForLanguage: parserForLanguageOption = {},
-    languageForExtension: languageForExtensionOption = {},
+    Compartment: LoadCompartmentOption = Compartment,
   } = options;
 
   const parserForLanguage = freeze(
     assign(create(null), parserForLanguageOption),
   );
-  const languageForExtension = freeze(
-    assign(create(null), languageForExtensionOption),
-  );
 
   /**
    * Object containing options and read powers that fulfills all requirements
@@ -150,12 +151,13 @@ export const loadFromMap = async (readPowers, compartmentMap, options = {}) => {
       modules,
       transforms,
       __shimTransforms__,
-      Compartment,
+      Compartment: CompartmentOption = LoadCompartmentOption,
       importHook: exitModuleImportHook,
     } = options;
     const compartmentExitModuleImportHook = exitModuleImportHookMaker({
       modules,
       exitModuleImportHook,
+      entryCompartmentName,
     });
     const makeImportHook = makeImportHookMaker(
       readPowers,
@@ -194,12 +196,11 @@ export const loadFromMap = async (readPowers, compartmentMap, options = {}) => {
         makeImportHook,
         makeImportNowHook,
         parserForLanguage,
-        languageForExtension,
         globals,
         transforms,
         syncModuleTransforms,
         __shimTransforms__,
-        Compartment,
+        Compartment: CompartmentOption,
       }));
     } else {
       // sync module transforms are allowed, because they are "compatible"
@@ -208,13 +209,12 @@ export const loadFromMap = async (readPowers, compartmentMap, options = {}) => {
       ({ compartment, pendingJobsPromise } = link(compartmentMap, {
         makeImportHook,
         parserForLanguage,
-        languageForExtension,
         globals,
         transforms,
         moduleTransforms,
         syncModuleTransforms,
         __shimTransforms__,
-        Compartment,
+        Compartment: CompartmentOption,
       }));
     }
 

package/src/import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["import.js"],"names":[],"mappings":";;;;;;;AA6CG,yCACQ,aAAa,kBACb,MAAM,WACN,kBAAkB,GAChB,OAAO,CAAC,WAAW,CAAC,CAChC;;;;;;;;AAGE,yCACQ,MAAM,GAAG,UAAU,kBACnB,MAAM,8CAEJ,OAAO,CAAC,WAAW,CAAC,CAChC;;;;;;;;;;;AAiCE,2CACQ,aAAa,kBACb,MAAM,WACN,yBAAyB,GACvB,OAAO,CAAC,UAAU,CAAC,CAE/B;;;;;;;;;;;AAKE,2CACQ,UAAU,GAAC,MAAM,kBACjB,MAAM,gDAEJ,OAAO,CAAC,UAAU,CAAC,CAE/B;mCAlFgC,YAAY;wCAJP,YAAY;iCAFnB,YAAY;4BAQjB,YAAY;gCACR,YAAY;yCANH,YAAY;+CACN,YAAY;gCAC3B,YAAY;2CAJD,YAAY"}
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["import.js"],"names":[],"mappings":";;;;;;;AAiDG,yCACQ,aAAa,kBACb,MAAM,WACN,kBAAkB,GAChB,OAAO,CAAC,WAAW,CAAC,CAChC;;;;;;;;AAGE,yCACQ,MAAM,GAAG,UAAU,kBACnB,MAAM,8CAEJ,OAAO,CAAC,WAAW,CAAC,CAChC;;;;;;;;;;;AAqDE,2CACQ,aAAa,kBACb,MAAM,WACN,yBAAyB,GACvB,OAAO,CAAC,UAAU,CAAC,CAE/B;;;;;;;;;;;AAKE,2CACQ,UAAU,GAAC,MAAM,kBACjB,MAAM,gDAEJ,OAAO,CAAC,UAAU,CAAC,CAE/B;mCA3GS,YAAY;wCAAZ,YAAY;iCAAZ,YAAY;4BAAZ,YAAY;gCAAZ,YAAY;yCAAZ,YAAY;+CAAZ,YAAY;gCAAZ,YAAY;2CAAZ,YAAY"}

package/src/import.js

@@ -1,6 +1,7 @@
-/* Provides functions for evaluating a module and its transitive
- * dependencies given the URL of the entry module and assuming packages
- * laid out according to the `node_modules` conventions.
+/**
+ * @module Provides functions for evaluating a module and its transitive
+ * dependencies given the URL of the entry module and assuming packages laid
+ * out according to the `node_modules` conventions.
  *
  * To import modules according to any other convention, use `import-lite.js`
  * and provide a compartment map with a custom analog to `mapNodeModules` from
@@ -10,7 +11,20 @@
  * for most cases.
  */
 
-// @ts-check
+/**
+ * @import {
+ *   Application,
+ *   SyncImportLocationOptions,
+ *   ImportLocationOptions,
+ *   SyncArchiveOptions,
+ *   LoadLocationOptions,
+ *   SomeObject,
+ *   ReadNowPowers,
+ *   ArchiveOptions,
+ *   ReadFn,
+ *   ReadPowers,
+ * } from './types.js'
+ */
 
 import { defaultParserForLanguage } from './import-parsers.js';
 import { mapNodeModules } from './node-modules.js';
@@ -18,17 +32,6 @@ import { loadFromMap } from './import-lite.js';
 
 const { assign, create, freeze } = Object;
 
-/** @import {Application} from './types.js' */
-/** @import {ImportLocationOptions} from './types.js' */
-/** @import {SyncArchiveOptions} from './types.js' */
-/** @import {LoadLocationOptions} from './types.js' */
-/** @import {SyncImportLocationOptions} from './types.js' */
-/** @import {SomeObject} from './types.js' */
-/** @import {ReadNowPowers} from './types.js' */
-/** @import {ArchiveOptions} from './types.js' */
-/** @import {ReadFn} from './types.js' */
-/** @import {ReadPowers} from './types.js' */
-
 /**
  * Add the default parserForLanguage option.
  * @param {ArchiveOptions} [options]
@@ -39,7 +42,8 @@ const assignParserForLanguage = (options = {}) => {
   const parserForLanguage = freeze(
     assign(create(null), defaultParserForLanguage, parserForLanguageOption),
   );
-  return { ...rest, parserForLanguage };
+  const languages = Object.keys(parserForLanguage);
+  return { ...rest, parserForLanguage, languages };
 };
 
 /**
@@ -69,7 +73,21 @@ export const loadLocation = async (
   moduleLocation,
   options = {},
 ) => {
-  const { dev, tags, commonDependencies, policy } = options;
+  const {
+    dev,
+    tags,
+    commonDependencies,
+    policy,
+    parserForLanguage,
+    languages,
+    languageForExtension,
+    commonjsLanguageForExtension,
+    moduleLanguageForExtension,
+    workspaceLanguageForExtension,
+    workspaceCommonjsLanguageForExtension,
+    workspaceModuleLanguageForExtension,
+    ...otherOptions
+  } = assignParserForLanguage(options);
   // conditions are not present in SyncArchiveOptions
   const conditions =
     'conditions' in options ? options.conditions || tags : tags;
@@ -78,12 +96,18 @@ export const loadLocation = async (
     conditions,
     commonDependencies,
     policy,
+    languageForExtension,
+    commonjsLanguageForExtension,
+    moduleLanguageForExtension,
+    workspaceLanguageForExtension,
+    workspaceCommonjsLanguageForExtension,
+    workspaceModuleLanguageForExtension,
+    languages,
+  });
+  return loadFromMap(readPowers, compartmentMap, {
+    parserForLanguage,
+    ...otherOptions,
   });
-  return loadFromMap(
-    readPowers,
-    compartmentMap,
-    assignParserForLanguage(options),
-  );
 };
 
 /**
@@ -111,7 +135,7 @@ export const loadLocation = async (
 /**
  * @param {ReadPowers|ReadFn|ReadNowPowers} readPowers
  * @param {string} moduleLocation
- * @param {ImportLocationOptions} [options]
+ * @param {ImportLocationOptions|SyncImportLocationOptions} [options]
  * @returns {Promise<SomeObject>} the object of the imported modules exported
  * names.
  */

package/src/infer-exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"infer-exports.d.ts","sourceRoot":"","sources":["infer-exports.js"],"names":[],"mappings":"AAsHO,+DATJ;IAAkC,IAAI,EAA9B,MAAM;IACqB,MAAM;IACN,OAAO,GAAlC,MAAM;CACd,cAAQ,GAAG,CAAC,MAAM,CAAC,SAEX,oBAAoB,kCA2B9B;AAkBM,yCAPI,MAAM,cACN,GAAG,CAAC,MAAM,CAAC,SAEX,oBAAoB,GAElB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG8B;AAE1D,uIA2CN;0CApMuC,YAAY"}
+{"version":3,"file":"infer-exports.d.ts","sourceRoot":"","sources":["infer-exports.js"],"names":[],"mappings":"AAqHO,+DATJ;IAAkC,IAAI,EAA9B,MAAM;IACqB,MAAM;IACN,OAAO,GAAlC,MAAM;CACd,cAAQ,GAAG,CAAC,MAAM,CAAC,SAEX,oBAAoB,kCA2B9B;AAkBM,yCAPI,MAAM,cACN,GAAG,CAAC,MAAM,CAAC,SAEX,oBAAoB,GAElB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG8B;AAE1D,uIA2CN;0CApMuC,YAAY"}

package/src/infer-exports.js

@@ -1,12 +1,11 @@
-/* Provides functions needed by `node-modules.js` for building
+/**
+ * @module Provides functions needed by `node-modules.js` for building
  * inter-compartment linkage according to the specifications in a
  * `package.json` as laid out in the `node_modules` convention.
  * These functions implement the behavior for a package's `"main"`,
  * `"browser"`, `"imports"`, and `"exports"` properties in a `package.json`.
  */
 
-// @ts-check
-
 /** @import {LanguageForExtension} from './types.js' */
 
 import { join, relativize } from './node-module-specifier.js';

package/src/json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["json.js"],"names":[],"mappings":"AAUO,yCAHI,MAAM,YACN,MAAM,OAWhB"}
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["json.js"],"names":[],"mappings":"AASO,yCAHI,MAAM,YACN,MAAM,OAWhB"}

package/src/json.js

@@ -1,5 +1,4 @@
-/* Annotates JSON parse exceptions with the location of the source. */
-// @ts-check
+/** @module Annotates JSON parse exceptions with the location of the source. */
 
 /**
  * Parses JSON and, if necessary, throws exceptions that include the location

package/src/link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["link.js"],"names":[],"mappings":"AAqPO,sEAJI,wBAAwB,WACxB,WAAW,GACT,UAAU,CA0LtB;AAOM,yCAJI,wBAAwB,WACxB,WAAW,eAIqB;8CA5ZjC,YAAY;iCAAZ,YAAY;gCAAZ,YAAY"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["link.js"],"names":[],"mappings":"AAsPO,sEAJI,wBAAwB,WACxB,WAAW,GACT,UAAU,CAwKtB;AAOM,yCAJI,wBAAwB,WACxB,WAAW,eAIqB;8CA5YjC,YAAY;iCAAZ,YAAY;gCAAZ,YAAY"}

package/src/link.js

@@ -1,4 +1,6 @@
-/* Provides the linking behavior shared by all Compartment Mapper workflows.
+/**
+ * @module Provides the linking behavior shared by all Compartment Mapper
+ * workflows.
  * This involves creating and configuring compartments according to the
  * specifications in a compartment map, and is suitable for compartment maps
  * that just outline the locations of compartments and their inter-linkage and
@@ -6,26 +8,22 @@
  * dependencies of their entry module.
  */
 
-// @ts-check
-
-/** @import {ModuleMapHook} from 'ses' */
 /**
+ * @import {ModuleMapHook} from 'ses'
  * @import {
  *   CompartmentDescriptor,
  *   CompartmentMapDescriptor,
  *   ImportNowHookMaker,
- *   LanguageForExtension,
  *   LinkOptions,
  *   LinkResult,
  *   ModuleDescriptor,
  *   ParseFn,
- *   ParseFnAsync,
+ *   AsyncParseFn,
  *   ParserForLanguage,
  *   ParserImplementation,
  *   ShouldDeferError,
  * } from './types.js'
  */
-/** @import {ERef} from '@endo/eventual-send' */
 
 import { makeMapParsers } from './map-parser.js';
 import { resolve as resolveFallback } from './node-module-specifier.js';
@@ -43,7 +41,7 @@ const { allSettled } = Promise;
 
 /**
  * @template T
- * @type {(iterable: Iterable<ERef<T>>) => Promise<Array<PromiseSettledResult<T>>>}
+ * @type {(iterable: Iterable<Promise<T>>) => Promise<Array<PromiseSettledResult<T>>>}
  */
 const promiseAllSettled = allSettled.bind(Promise);
 
@@ -112,6 +110,8 @@ const makeModuleMapHook = (
 
     const moduleDescriptor = moduleDescriptors[moduleSpecifier];
     if (moduleDescriptor !== undefined) {
+      moduleDescriptor.retained = true;
+
       // "foreignCompartmentName" refers to the compartment which
       // may differ from the current compartment
       const {
@@ -193,6 +193,7 @@ const makeModuleMapHook = (
         // a moduleMapHook when we assemble compartments from the resulting
         // archive.
         moduleDescriptors[moduleSpecifier] = {
+          retained: true,
           compartment: foreignCompartmentName,
           module: foreignModuleSpecifier,
         };
@@ -252,7 +253,6 @@ export const link = (
     makeImportHook,
     makeImportNowHook = impossibleImportNowHookMaker,
     parserForLanguage: parserForLanguageOption = {},
-    languageForExtension: languageForExtensionOption = {},
     globals = {},
     transforms = [],
     moduleTransforms,
@@ -277,10 +277,6 @@ export const link = (
 
   const pendingJobs = [];
 
-  /** @type {LanguageForExtension} */
-  const defaultLanguageForExtension = freeze(
-    assign(create(null), languageForExtensionOption),
-  );
   /** @type {ParserForLanguage} */
   const parserForLanguage = freeze(
     assign(create(null), parserForLanguageOption),
@@ -298,8 +294,8 @@ export const link = (
     const {
       location,
       name,
-      parsers: languageForExtensionOverrides = {},
-      types: languageForModuleSpecifierOverrides = {},
+      parsers: languageForExtension = {},
+      types: languageForModuleSpecifier = {},
     } = compartmentDescriptor;
 
     // this is for retaining the correct type inference about these values
@@ -312,22 +308,9 @@ export const link = (
     // The `moduleMapHook` writes back to the compartment map.
     compartmentDescriptor.modules = modules;
 
-    /** @type {Record<string, string>} */
-    const languageForModuleSpecifier = freeze(
-      assign(create(null), languageForModuleSpecifierOverrides),
-    );
-    /** @type {LanguageForExtension} */
-    const languageForExtension = freeze(
-      assign(
-        create(null),
-        defaultLanguageForExtension,
-        languageForExtensionOverrides,
-      ),
-    );
-
     // TS is kind of dumb about this, so we can use a type assertion to avoid a
     // pointless ternary.
-    const parse = /** @type {ParseFn|ParseFnAsync} */ (
+    const parse = /** @type {ParseFn|AsyncParseFn} */ (
       mapParsers(languageForExtension, languageForModuleSpecifier)
     );
 

package/src/map-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-parser.d.ts","sourceRoot":"","sources":["map-parser.js"],"names":[],"mappings":"AAqSO,+FAHI,qBAAqB,GACnB,YAAY,CA+CxB;2CAxTS,YAAY;kCAAZ,YAAY"}
+{"version":3,"file":"map-parser.d.ts","sourceRoot":"","sources":["map-parser.js"],"names":[],"mappings":"AA0SO,+FAHI,qBAAqB,GACnB,YAAY,CA+CxB;2CApUS,YAAY;kCAAZ,YAAY"}

package/src/map-parser.js

@@ -1,15 +1,8 @@
 /**
- * Exports {@link makeMapParsers}, which creates a function which matches a
+ * @module Exports {@link makeMapParsers}, which creates a function which matches a
  * module to a parser based on reasons.
- *
- * @module
  */
 
-// @ts-check
-
-import { syncTrampoline, asyncTrampoline } from '@endo/trampoline';
-import { parseExtension } from './extension.js';
-
 /**
  * @import {
  *   LanguageForExtension,
@@ -19,7 +12,7 @@ import { parseExtension } from './extension.js';
  *   ModuleTransform,
  *   ModuleTransforms,
  *   ParseFn,
- *   ParseFnAsync,
+ *   AsyncParseFn,
  *   ParseResult,
  *   ParserForLanguage,
  *   SyncModuleTransform,
@@ -27,6 +20,9 @@ import { parseExtension } from './extension.js';
  * } from './types.js';
  */
 
+import { syncTrampoline, asyncTrampoline } from '@endo/trampoline';
+import { parseExtension } from './extension.js';
+
 const { entries, fromEntries, keys, hasOwnProperty, values } = Object;
 const { apply } = Reflect;
 // q, as in quote, for strings in error messages.
@@ -64,7 +60,7 @@ const extensionImpliesLanguage = extension => extension !== 'js';
  * @param {ParserForLanguage} parserForLanguage
  * @param {ModuleTransforms} moduleTransforms
  * @param {SyncModuleTransforms} syncModuleTransforms
- * @returns {ParseFnAsync|ParseFn}
+ * @returns {AsyncParseFn|ParseFn}
  */
 const makeExtensionParser = (
   preferSynchronous,
@@ -78,7 +74,8 @@ const makeExtensionParser = (
   let transforms;
 
   /**
-   * Function returning a generator which executes a parser for a module in either sync or async context.
+   * Function returning a generator which executes a parser for a module in
+   * either sync or async context.
    *
    * @param {Uint8Array} bytes
    * @param {string} specifier
@@ -104,6 +101,14 @@ const makeExtensionParser = (
     ) {
       language = languageForModuleSpecifier[specifier];
     } else {
+      // We should revisit this design decision:
+      // Defaulting the language to the extension conflates those namespaces.
+      // So, a transform keyed by extension can be used to coerce a language
+      // (e.g., .mts to mjs) as a shorthand for configuring a parser for that
+      // extension that pre-processes the file before handing off to the
+      // parser.
+      // But, this forces us to support the case of using weird language
+      // names like pre-mjs-json as valid, unconfigured extensions.
       language = languageForExtension[extension] || extension;
     }
 
@@ -169,7 +174,7 @@ const makeExtensionParser = (
   syncParser.isSyncParser = true;
 
   /**
-   * @type {ParseFnAsync}
+   * @type {AsyncParseFn}
    */
   const asyncParser = async (
     bytes,
@@ -190,7 +195,7 @@ const makeExtensionParser = (
 
   // Unfortunately, typescript was not smart enough to figure out the return
   // type depending on a boolean in arguments, so it has to be
-  // ParseFnAsync|ParseFn
+  // AsyncParseFn|ParseFn
   if (preferSynchronous) {
     transforms = syncModuleTransforms;
     return syncParser;
@@ -233,7 +238,7 @@ const makeExtensionParser = (
  * @param {ModuleTransforms} [moduleTransforms]
  * @param {SyncModuleTransforms} [syncModuleTransforms]
  * @param {false} [preferSynchronous]
- * @returns {ParseFnAsync}
+ * @returns {AsyncParseFn}
  */
 
 /**
@@ -245,7 +250,7 @@ const makeExtensionParser = (
  * @param {ModuleTransforms} [moduleTransforms]
  * @param {SyncModuleTransforms} [syncModuleTransforms]
  * @param {boolean} [preferSynchronous] If `true`, will create a `ParseFn`
- * @returns {ParseFnAsync|ParseFn}
+ * @returns {AsyncParseFn|ParseFn}
  */
 function mapParsers(
   languageForExtension,
@@ -300,7 +305,7 @@ export const makeMapParsers = ({
    * Async `mapParsers()` function; returned when a non-synchronous parser is
    * present _or_ when `moduleTransforms` is non-empty.
    *
-   * @type {MapParsersFn<ParseFnAsync>}
+   * @type {MapParsersFn<AsyncParseFn>}
    */
   const asyncParseFn = (languageForExtension, languageForModuleSpecifier) =>
     mapParsers(

package/src/node-module-specifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-module-specifier.d.ts","sourceRoot":"","sources":["node-module-specifier.js"],"names":[],"mappings":"AAyDO,8BAJI,MAAM,YACN,MAAM,GACJ,MAAM,CAiClB;AAeM,2BAJI,MAAM,QACN,MAAM,GACJ,MAAM,CA6BlB;AAaM,iCALI,MAAM,GAEJ,MAAM,CAclB"}
+{"version":3,"file":"node-module-specifier.d.ts","sourceRoot":"","sources":["node-module-specifier.js"],"names":[],"mappings":"AAwDO,8BAJI,MAAM,YACN,MAAM,GACJ,MAAM,CAiClB;AAeM,2BAJI,MAAM,QACN,MAAM,GACJ,MAAM,CA6BlB;AAaM,iCALI,MAAM,GAEJ,MAAM,CAclB"}

package/src/node-module-specifier.js

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

package/src/node-modules.d.ts

@@ -1,11 +1,5 @@
 export function compartmentMapForNodeModules(readPowers: ReadFn | ReadPowers | MaybeReadPowers, packageLocation: string, conditions: Set<string>, packageDescriptor: object, moduleSpecifier: string, options?: CompartmentMapForNodeModulesOptions | undefined): Promise<CompartmentMapDescriptor>;
-export function mapNodeModules(readPowers: ReadFn | ReadPowers | MaybeReadPowers, moduleLocation: string, options?: {
-    tags?: Set<string> | undefined;
-    conditions?: Set<string> | undefined;
-    dev?: boolean | undefined;
-    commonDependencies?: object;
-    policy?: object;
-} | undefined): Promise<CompartmentMapDescriptor>;
+export function mapNodeModules(readPowers: ReadFn | ReadPowers | MaybeReadPowers, moduleLocation: string, options?: MapNodeModulesOptions | undefined): Promise<CompartmentMapDescriptor>;
 /**
  * The graph is an intermediate object model that the functions of this module
  * build by exploring the `node_modules` tree dropped by tools like npm and
@@ -37,6 +31,13 @@ export type Node = {
      */
     types: Record<string, Language>;
 };
+export type LanguageOptions = {
+    commonjsLanguageForExtension: LanguageForExtension;
+    moduleLanguageForExtension: LanguageForExtension;
+    workspaceCommonjsLanguageForExtension: LanguageForExtension;
+    workspaceModuleLanguageForExtension: LanguageForExtension;
+    languages: Set<string>;
+};
 export type CommonDependencyDescriptors = Record<string, {
     spec: string;
     alias: string;
@@ -47,6 +48,7 @@ import type { ReadPowers } from './types.js';
 import type { MaybeReadPowers } from './types.js';
 import type { CompartmentMapForNodeModulesOptions } from './types.js';
 import type { CompartmentMapDescriptor } from './types.js';
+import type { MapNodeModulesOptions } from './types.js';
 import type { LanguageForExtension } from './types.js';
 import type { Language } from './types.js';
 //# sourceMappingURL=node-modules.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"node-modules.d.ts","sourceRoot":"","sources":["node-modules.js"],"names":[],"mappings":"AAwvBO,yDARI,MAAM,GAAG,UAAU,GAAG,eAAe,mBACrC,MAAM,cACN,GAAG,CAAC,MAAM,CAAC,qBACX,MAAM,mBACN,MAAM,8DAEJ,OAAO,CAAC,wBAAwB,CAAC,CA+C7C;AAaM,2CAVI,MAAM,GAAG,UAAU,GAAG,eAAe,kBACrC,MAAM;;;;yBAKN,MAAM;aACN,MAAM;gBACJ,OAAO,CAAC,wBAAwB,CAAC,CAmC7C;;;;;;;oBAjzBY,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;;WAKnB,MAAM;UACN,MAAM;UACN,KAAK,CAAC,MAAM,CAAC;iBACb,KAAK,CAAC,MAAM,CAAC;qBACb,OAAO;qBACP,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;qBACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;yBACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;aAEtB,oBAAoB;;;;;WAEpB,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;;0CAKzB,MAAM,CAAC,MAAM,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC;iDA+E/C,MAAM,KACJ,OAAO,CAAC,MAAM,CAAC;4BAhHF,YAAY;gCACR,YAAY;qCAHP,YAAY;yDAPQ,YAAY;8CAGvB,YAAY;0CAEhB,YAAY;8BADxB,YAAY"}
+{"version":3,"file":"node-modules.d.ts","sourceRoot":"","sources":["node-modules.js"],"names":[],"mappings":"AAy1BO,yDARI,MAAM,GAAG,UAAU,GAAG,eAAe,mBACrC,MAAM,cACN,GAAG,CAAC,MAAM,CAAC,qBACX,MAAM,mBACN,MAAM,8DAEJ,OAAO,CAAC,wBAAwB,CAAC,CAkD7C;AAQM,2CALI,MAAM,GAAG,UAAU,GAAG,eAAe,kBACrC,MAAM,gDAEJ,OAAO,CAAC,wBAAwB,CAAC,CA6B7C;;;;;;;oBAr4BY,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;;WAKnB,MAAM;UACN,MAAM;UACN,KAAK,CAAC,MAAM,CAAC;iBACb,KAAK,CAAC,MAAM,CAAC;qBACb,OAAO;qBACP,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;qBACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;yBACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;aAEtB,oBAAoB;;;;;WAEpB,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;;;kCAMxB,oBAAoB;gCACpB,oBAAoB;2CACpB,oBAAoB;yCACpB,oBAAoB;eACpB,GAAG,CAAC,MAAM,CAAC;;0CAIZ,MAAM,CAAC,MAAM,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC;iDA+E/C,MAAM,KACJ,OAAO,CAAC,MAAM,CAAC;4BAvHlB,YAAY;gCAAZ,YAAY;qCAAZ,YAAY;yDAAZ,YAAY;8CAAZ,YAAY;2CAAZ,YAAY;0CAAZ,YAAY;8BAAZ,YAAY"}