@senpiper/sp-agent 0.1.6 → 0.1.7

package/node_modules/@types/node/vm.d.ts

@@ -1,6 +1,44 @@
-declare module "node:vm" {
+/**
+ * The `node:vm` module enables compiling and running code within V8 Virtual
+ * Machine contexts.
+ *
+ * **The `node:vm` module is not a security**
+ * **mechanism. Do not use it to run untrusted code.**
+ *
+ * JavaScript code can be compiled and run immediately or
+ * compiled, saved, and run later.
+ *
+ * A common use case is to run the code in a different V8 Context. This means
+ * invoked code has a different global object than the invoking code.
+ *
+ * One can provide the context by `contextifying` an
+ * object. The invoked code treats any property in the context like a
+ * global variable. Any changes to global variables caused by the invoked
+ * code are reflected in the context object.
+ *
+ * ```js
+ * import vm from 'node:vm';
+ *
+ * const x = 1;
+ *
+ * const context = { x: 2 };
+ * vm.createContext(context); // Contextify the object.
+ *
+ * const code = 'x += 40; var y = 17;';
+ * // `x` and `y` are global variables in the context.
+ * // Initially, x has the value 2 because that is the value of context.x.
+ * vm.runInContext(code, context);
+ *
+ * console.log(context.x); // 42
+ * console.log(context.y); // 17
+ *
+ * console.log(x); // 1; y is not defined.
+ * ```
+ * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/vm.js)
+ */
+declare module "vm" {
     import { NonSharedBuffer } from "node:buffer";
-    import { ImportAttributes, ImportPhase } from "node:module";
+    import { ImportAttributes } from "node:module";
     interface Context extends NodeJS.Dict<any> {}
     interface BaseOptions {
         /**
@@ -23,7 +61,6 @@ declare module "node:vm" {
         specifier: string,
         referrer: T,
         importAttributes: ImportAttributes,
-        phase: ImportPhase,
     ) => Module | Promise<Module>;
     interface ScriptOptions extends BaseOptions {
         /**
@@ -35,8 +72,7 @@ declare module "node:vm" {
         /**
          * Used to specify how the modules should be loaded during the evaluation of this script when `import()` is called. This option is
          * part of the experimental modules API. We do not recommend using it in a production environment. For detailed information, see
-         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v26.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
-         * @experimental
+         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v22.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
          */
         importModuleDynamically?:
             | DynamicModuleLoader<Script>
@@ -81,8 +117,7 @@ declare module "node:vm" {
         /**
          * Used to specify how the modules should be loaded during the evaluation of this script when `import()` is called. This option is
          * part of the experimental modules API. We do not recommend using it in a production environment. For detailed information, see
-         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v26.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
-         * @experimental
+         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v22.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
          */
         importModuleDynamically?:
             | DynamicModuleLoader<Script>
@@ -95,8 +130,7 @@ declare module "node:vm" {
         /**
          * Used to specify how the modules should be loaded during the evaluation of this script when `import()` is called. This option is
          * part of the experimental modules API. We do not recommend using it in a production environment. For detailed information, see
-         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v26.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
-         * @experimental
+         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v22.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
          */
         importModuleDynamically?:
             | DynamicModuleLoader<Script>
@@ -115,8 +149,7 @@ declare module "node:vm" {
         /**
          * Used to specify how the modules should be loaded during the evaluation of this script when `import()` is called. This option is
          * part of the experimental modules API. We do not recommend using it in a production environment. For detailed information, see
-         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v26.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
-         * @experimental
+         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v22.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
          */
         importModuleDynamically?:
             | DynamicModuleLoader<ReturnType<typeof compileFunction>>
@@ -159,8 +192,7 @@ declare module "node:vm" {
         /**
          * Used to specify how the modules should be loaded during the evaluation of this script when `import()` is called. This option is
          * part of the experimental modules API. We do not recommend using it in a production environment. For detailed information, see
-         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v26.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
-         * @experimental
+         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v22.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
          */
         importModuleDynamically?:
             | DynamicModuleLoader<Context>
@@ -200,16 +232,16 @@ declare module "node:vm" {
          * The globals are contained in the `context` object.
          *
          * ```js
-         * import { createContext, Script } from 'node:vm';
+         * import vm from 'node:vm';
          *
          * const context = {
          *   animal: 'cat',
          *   count: 2,
          * };
          *
-         * const script = new Script('count += 1; name = "kitty";');
+         * const script = new vm.Script('count += 1; name = "kitty";');
          *
-         * createContext(context);
+         * vm.createContext(context);
          * for (let i = 0; i < 10; ++i) {
          *   script.runInContext(context);
          * }
@@ -232,21 +264,20 @@ declare module "node:vm" {
          *
          * 1. Creates a new context.
          * 2. If `contextObject` is an object, contextifies it with the new context.
-         *    If `contextObject` is undefined, creates a new object and contextifies it.
+         *    If  `contextObject` is undefined, creates a new object and contextifies it.
          *    If `contextObject` is `vm.constants.DONT_CONTEXTIFY`, don't contextify anything.
-         * 3. Compiles the code as a `vm.Script`
-         * 4. Runs the compiled code within the created context. The code does not have access to the scope in
-         *    which this method is called.
-         * 5. Returns the result.
+         * 3. Runs the compiled code contained by the `vm.Script` object within the created context. The code
+         *    does not have access to the scope in which this method is called.
+         * 4. Returns the result.
          *
          * The following example compiles code that sets a global variable, then executes
          * the code multiple times in different contexts. The globals are set on and
          * contained within each individual `context`.
          *
          * ```js
-         * import { constants, Script } from 'node:vm';
+         * const vm = require('node:vm');
          *
-         * const script = new Script('globalVar = "set"');
+         * const script = new vm.Script('globalVar = "set"');
          *
          * const contexts = [{}, {}, {}];
          * contexts.forEach((context) => {
@@ -257,10 +288,10 @@ declare module "node:vm" {
          * // Prints: [{ globalVar: 'set' }, { globalVar: 'set' }, { globalVar: 'set' }]
          *
          * // This would throw if the context is created from a contextified object.
-         * // constants.DONT_CONTEXTIFY allows creating contexts with ordinary
+         * // vm.constants.DONT_CONTEXTIFY allows creating contexts with ordinary
          * // global objects that can be frozen.
-         * const freezeScript = new Script('Object.freeze(globalThis); globalThis;');
-         * const frozenContext = freezeScript.runInNewContext(constants.DONT_CONTEXTIFY);
+         * const freezeScript = new vm.Script('Object.freeze(globalThis); globalThis;');
+         * const frozenContext = freezeScript.runInNewContext(vm.constants.DONT_CONTEXTIFY);
          * ```
          * @since v0.3.1
          * @param contextObject Either `vm.constants.DONT_CONTEXTIFY` or an object that will be contextified.
@@ -279,11 +310,11 @@ declare module "node:vm" {
          * executes that code multiple times:
          *
          * ```js
-         * import { Script } from 'node:vm';
+         * import vm from 'node:vm';
          *
          * global.globalVar = 0;
          *
-         * const script = new Script('globalVar += 1', { filename: 'myfile.vm' });
+         * const script = new vm.Script('globalVar += 1', { filename: 'myfile.vm' });
          *
          * for (let i = 0; i < 1000; ++i) {
          *   script.runInThisContext();
@@ -363,23 +394,23 @@ declare module "node:vm" {
     }
     /**
      * If the given `contextObject` is an object, the `vm.createContext()` method will
-     * [prepare that object](https://nodejs.org/docs/latest-v26.x/api/vm.html#what-does-it-mean-to-contextify-an-object)
+     * [prepare that object](https://nodejs.org/docs/latest-v22.x/api/vm.html#what-does-it-mean-to-contextify-an-object)
      * and return a reference to it so that it can be used in calls to {@link runInContext} or
-     * [`script.runInContext()`](https://nodejs.org/docs/latest-v26.x/api/vm.html#scriptrunincontextcontextifiedobject-options).
+     * [`script.runInContext()`](https://nodejs.org/docs/latest-v22.x/api/vm.html#scriptrunincontextcontextifiedobject-options).
      * Inside such scripts, the global object will be wrapped by the `contextObject`, retaining all of its
      * existing properties but also having the built-in objects and functions any standard
      * [global object](https://es5.github.io/#x15.1) has. Outside of scripts run by the vm module, global
      * variables will remain unchanged.
      *
      * ```js
-     * import { createContext, runInContext } from 'node:vm';
+     * const vm = require('node:vm');
      *
      * global.globalVar = 3;
      *
      * const context = { globalVar: 1 };
-     * createContext(context);
+     * vm.createContext(context);
      *
-     * runInContext('globalVar *= 2;', context);
+     * vm.runInContext('globalVar *= 2;', context);
      *
      * console.log(context);
      * // Prints: { globalVar: 2 }
@@ -430,13 +461,13 @@ declare module "node:vm" {
      * The following example compiles and executes different scripts using a single `contextified` object:
      *
      * ```js
-     * import { createContext, runInContext } from 'node:vm';
+     * import vm from 'node:vm';
      *
      * const contextObject = { globalVar: 1 };
-     * createContext(contextObject);
+     * vm.createContext(contextObject);
      *
      * for (let i = 0; i < 10; ++i) {
-     *   runInContext('globalVar *= 2;', contextObject);
+     *   vm.runInContext('globalVar *= 2;', contextObject);
      * }
      * console.log(contextObject);
      * // Prints: { globalVar: 1024 }
@@ -467,24 +498,21 @@ declare module "node:vm" {
      * variable and sets a new one. These globals are contained in the `contextObject`.
      *
      * ```js
-     * import { runInNewContext, constants } from 'node:vm';
+     * const vm = require('node:vm');
      *
      * const contextObject = {
      *   animal: 'cat',
      *   count: 2,
      * };
      *
-     * runInNewContext('count += 1; name = "kitty"', contextObject);
+     * vm.runInNewContext('count += 1; name = "kitty"', contextObject);
      * console.log(contextObject);
      * // Prints: { animal: 'cat', count: 3, name: 'kitty' }
      *
      * // This would throw if the context is created from a contextified object.
      * // vm.constants.DONT_CONTEXTIFY allows creating contexts with ordinary global objects that
      * // can be frozen.
-     * const frozenContext = runInNewContext(
-     *   'Object.freeze(globalThis); globalThis;',
-     *   constants.DONT_CONTEXTIFY,
-     * );
+     * const frozenContext = vm.runInNewContext('Object.freeze(globalThis); globalThis;', vm.constants.DONT_CONTEXTIFY);
      * ```
      * @since v0.3.1
      * @param code The JavaScript code to compile and run.
@@ -508,10 +536,10 @@ declare module "node:vm" {
      * the JavaScript [`eval()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval) function to run the same code:
      *
      * ```js
-     * import { runInThisContext } from 'node:vm';
+     * import vm from 'node:vm';
      * let localVar = 'initial value';
      *
-     * const vmResult = runInThisContext('localVar = "vm";');
+     * const vmResult = vm.runInThisContext('localVar = "vm";');
      * console.log(`vmResult: '${vmResult}', localVar: '${localVar}'`);
      * // Prints: vmResult: 'vm', localVar: 'initial value'
      *
@@ -523,6 +551,38 @@ declare module "node:vm" {
      * Because `vm.runInThisContext()` does not have access to the local scope, `localVar` is unchanged. In contrast,
      * [`eval()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval) _does_ have access to the
      * local scope, so the value `localVar` is changed. In this way `vm.runInThisContext()` is much like an [indirect `eval()` call](https://es5.github.io/#x10.4.2), e.g.`(0,eval)('code')`.
+     *
+     * ## Example: Running an HTTP server within a VM
+     *
+     * When using either `script.runInThisContext()` or {@link runInThisContext}, the code is executed within the current V8 global
+     * context. The code passed to this VM context will have its own isolated scope.
+     *
+     * In order to run a simple web server using the `node:http` module the code passed
+     * to the context must either import `node:http` on its own, or have a
+     * reference to the `node:http` module passed to it. For instance:
+     *
+     * ```js
+     * 'use strict';
+     * import vm from 'node:vm';
+     *
+     * const code = `
+     * ((require) => {
+     * const http = require('node:http');
+     *
+     *   http.createServer((request, response) => {
+     *     response.writeHead(200, { 'Content-Type': 'text/plain' });
+     *     response.end('Hello World\\n');
+     *   }).listen(8124);
+     *
+     *   console.log('Server running at http://127.0.0.1:8124/');
+     * })`;
+     *
+     * vm.runInThisContext(code)(require);
+     * ```
+     *
+     * The `require()` in the above case shares the state with the context it is
+     * passed from. This may introduce risks when untrusted code is executed, e.g.
+     * altering objects in the context in unwanted ways.
      * @since v0.3.1
      * @param code The JavaScript code to compile and run.
      * @return the result of the very last statement executed in the script.
@@ -554,32 +614,44 @@ declare module "node:vm" {
      * the memory occupied by each heap space in the current V8 instance.
      *
      * ```js
-     * import { createContext, measureMemory } from 'node:vm';
+     * import vm from 'node:vm';
      * // Measure the memory used by the main context.
-     * measureMemory({ mode: 'summary' })
+     * vm.measureMemory({ mode: 'summary' })
      *   // This is the same as vm.measureMemory()
      *   .then((result) => {
      *     // The current format is:
      *     // {
-     *     //   total: { jsMemoryEstimate: 1601828, jsMemoryRange: [1601828, 5275288] },
-     *     //   WebAssembly: { code: 0, metadata: 33962 },
+     *     //   total: {
+     *     //      jsMemoryEstimate: 2418479, jsMemoryRange: [ 2418479, 2745799 ]
+     *     //    }
      *     // }
      *     console.log(result);
      *   });
      *
-     * const context = createContext({ a: 1 });
-     * measureMemory({ mode: 'detailed', execution: 'eager' }).then((result) => {
-     *   // Reference the context here so that it won't be GC'ed
-     *   // until the measurement is complete.
-     *   console.log('Context:', context.a);
-     *   // {
-     *   //   total: { jsMemoryEstimate: 1767100, jsMemoryRange: [1767100, 5440560] },
-     *   //   WebAssembly: { code: 0, metadata: 33962 },
-     *   //   current: { jsMemoryEstimate: 1601828, jsMemoryRange: [1601828, 5275288] },
-     *   //   other: [{ jsMemoryEstimate: 165272, jsMemoryRange: [Array] }],
-     *   // }
-     *   console.log(result);
-     * });
+     * const context = vm.createContext({ a: 1 });
+     * vm.measureMemory({ mode: 'detailed', execution: 'eager' })
+     *   .then((result) => {
+     *     // Reference the context here so that it won't be GC'ed
+     *     // until the measurement is complete.
+     *     console.log(context.a);
+     *     // {
+     *     //   total: {
+     *     //     jsMemoryEstimate: 2574732,
+     *     //     jsMemoryRange: [ 2574732, 2904372 ]
+     *     //   },
+     *     //   current: {
+     *     //     jsMemoryEstimate: 2438996,
+     *     //     jsMemoryRange: [ 2438996, 2768636 ]
+     *     //   },
+     *     //   other: [
+     *     //     {
+     *     //       jsMemoryEstimate: 135736,
+     *     //       jsMemoryRange: [ 135736, 465376 ]
+     *     //     }
+     *     //   ]
+     *     // }
+     *     console.log(result);
+     *   });
      * ```
      * @since v13.10.0
      * @experimental
@@ -599,12 +671,14 @@ declare module "node:vm" {
      * flag enabled.
      *
      * The `vm.Module` class provides a low-level interface for using
-     * ECMAScript modules in VM contexts. It is the counterpart of the `vm.Script`
-     * class that closely mirrors [Module Record](https://tc39.es/ecma262/#sec-abstract-module-records)s as defined in the ECMAScript
+     * ECMAScript modules in VM contexts. It is the counterpart of the `vm.Script` class that closely mirrors [Module Record](https://262.ecma-international.org/14.0/#sec-abstract-module-records) s as
+     * defined in the ECMAScript
      * specification.
      *
      * Unlike `vm.Script` however, every `vm.Module` object is bound to a context from
-     * its creation.
+     * its creation. Operations on `vm.Module` objects are intrinsically asynchronous,
+     * in contrast with the synchronous nature of `vm.Script` objects. The use of
+     * 'async' functions can help with manipulating `vm.Module` objects.
      *
      * Using a `vm.Module` object requires three distinct steps: creation/parsing,
      * linking, and evaluation. These three steps are illustrated in the following
@@ -632,7 +706,7 @@ declare module "node:vm" {
      * // Here, we attempt to obtain the default export from the module "foo", and
      * // put it into local binding "secret".
      *
-     * const rootModule = new vm.SourceTextModule(`
+     * const bar = new vm.SourceTextModule(`
      *   import s from 'foo';
      *   s;
      *   print(s);
@@ -642,48 +716,39 @@ declare module "node:vm" {
      * //
      * // "Link" the imported dependencies of this Module to it.
      * //
-     * // Obtain the requested dependencies of a SourceTextModule by
-     * // `sourceTextModule.moduleRequests` and resolve them.
+     * // The provided linking callback (the "linker") accepts two arguments: the
+     * // parent module (`bar` in this case) and the string that is the specifier of
+     * // the imported module. The callback is expected to return a Module that
+     * // corresponds to the provided specifier, with certain requirements documented
+     * // in `module.link()`.
+     * //
+     * // If linking has not started for the returned Module, the same linker
+     * // callback will be called on the returned Module.
      * //
      * // Even top-level Modules without dependencies must be explicitly linked. The
-     * // array passed to `sourceTextModule.linkRequests(modules)` can be
-     * // empty, however.
+     * // callback provided would never be called, however.
      * //
-     * // Note: This is a contrived example in that the resolveAndLinkDependencies
-     * // creates a new "foo" module every time it is called. In a full-fledged
-     * // module system, a cache would probably be used to avoid duplicated modules.
-     *
-     * const moduleMap = new Map([
-     *   ['root', rootModule],
-     * ]);
-     *
-     * function resolveAndLinkDependencies(module) {
-     *   const requestedModules = module.moduleRequests.map((request) => {
-     *     // In a full-fledged module system, the resolveAndLinkDependencies would
-     *     // resolve the module with the module cache key `[specifier, attributes]`.
-     *     // In this example, we just use the specifier as the key.
-     *     const specifier = request.specifier;
-     *
-     *     let requestedModule = moduleMap.get(specifier);
-     *     if (requestedModule === undefined) {
-     *       requestedModule = new vm.SourceTextModule(`
-     *         // The "secret" variable refers to the global variable we added to
-     *         // "contextifiedObject" when creating the context.
-     *         export default secret;
-     *       `, { context: referencingModule.context });
-     *       moduleMap.set(specifier, requestedModule);
-     *       // Resolve the dependencies of the new module as well.
-     *       resolveAndLinkDependencies(requestedModule);
-     *     }
-     *
-     *     return requestedModule;
-     *   });
-     *
-     *   module.linkRequests(requestedModules);
+     * // The link() method returns a Promise that will be resolved when all the
+     * // Promises returned by the linker resolve.
+     * //
+     * // Note: This is a contrived example in that the linker function creates a new
+     * // "foo" module every time it is called. In a full-fledged module system, a
+     * // cache would probably be used to avoid duplicated modules.
+     *
+     * async function linker(specifier, referencingModule) {
+     *   if (specifier === 'foo') {
+     *     return new vm.SourceTextModule(`
+     *       // The "secret" variable refers to the global variable we added to
+     *       // "contextifiedObject" when creating the context.
+     *       export default secret;
+     *     `, { context: referencingModule.context });
+     *
+     *     // Using `contextifiedObject` instead of `referencingModule.context`
+     *     // here would work as well.
+     *   }
+     *   throw new Error(`Unable to resolve dependency: ${specifier}`);
      * }
-     *
-     * resolveAndLinkDependencies(rootModule);
-     * rootModule.instantiate();
+     * await bar.link(linker);
      *
      * // Step 3
      * //
@@ -691,12 +756,20 @@ declare module "node:vm" {
      * // resolve after the module has finished evaluating.
      *
      * // Prints 42.
-     * await rootModule.evaluate();
+     * await bar.evaluate();
      * ```
      * @since v13.0.0, v12.16.0
      * @experimental
      */
     class Module {
+        /**
+         * The specifiers of all dependencies of this module. The returned array is frozen
+         * to disallow any changes to it.
+         *
+         * Corresponds to the `[[RequestedModules]]` field of [Cyclic Module Record](https://tc39.es/ecma262/#sec-cyclic-module-records) s in
+         * the ECMAScript specification.
+         */
+        dependencySpecifiers: readonly string[];
         /**
          * If the `module.status` is `'errored'`, this property contains the exception
          * thrown by the module during evaluation. If the status is anything else,
@@ -741,47 +814,19 @@ declare module "node:vm" {
          */
         status: ModuleStatus;
         /**
-         * Evaluate the module and its dependencies. Corresponds to the [Evaluate() concrete method](https://tc39.es/ecma262/#sec-moduleevaluation) field of
-         * [Cyclic Module Record](https://tc39.es/ecma262/#sec-cyclic-module-records)s in the ECMAScript specification.
-         *
-         * If the module is a `vm.SourceTextModule`, `evaluate()` must be called after the module has been instantiated;
-         * otherwise `evaluate()` will return a rejected promise.
+         * Evaluate the module.
          *
-         * For a `vm.SourceTextModule`, the promise returned by `evaluate()` may be fulfilled either
-         * synchronously or asynchronously:
+         * This must be called after the module has been linked; otherwise it will reject.
+         * It could be called also when the module has already been evaluated, in which
+         * case it will either do nothing if the initial evaluation ended in success
+         * (`module.status` is `'evaluated'`) or it will re-throw the exception that the
+         * initial evaluation resulted in (`module.status` is `'errored'`).
          *
-         * 1. If the `vm.SourceTextModule` has no top-level `await` in itself or any of its dependencies, the promise will be
-         *    fulfilled _synchronously_ after the module and all its dependencies have been evaluated.
-         *    1. If the evaluation succeeds, the promise will be _synchronously_ resolved to `undefined`.
-         *    2. If the evaluation results in an exception, the promise will be _synchronously_ rejected with the exception
-         *       that causes the evaluation to fail, which is the same as `module.error`.
-         * 2. If the `vm.SourceTextModule` has top-level `await` in itself or any of its dependencies, the promise will be
-         *    fulfilled _asynchronously_ after the module and all its dependencies have been evaluated.
-         *    1. If the evaluation succeeds, the promise will be _asynchronously_ resolved to `undefined`.
-         *    2. If the evaluation results in an exception, the promise will be _asynchronously_ rejected with the exception
-         *       that causes the evaluation to fail.
+         * This method cannot be called while the module is being evaluated
+         * (`module.status` is `'evaluating'`).
          *
-         * If the module is a `vm.SyntheticModule`, `evaluate()` always returns a promise that fulfills synchronously, see
-         * the specification of [Evaluate() of a Synthetic Module Record](https://tc39.es/ecma262/#sec-smr-Evaluate):
-         *
-         * 1. If the `evaluateCallback` passed to its constructor throws an exception synchronously, `evaluate()` returns
-         *    a promise that will be synchronously rejected with that exception.
-         * 2. If the `evaluateCallback` does not throw an exception, `evaluate()` returns a promise that will be
-         *    synchronously resolved to `undefined`.
-         *
-         * The `evaluateCallback` of a `vm.SyntheticModule` is executed synchronously within the `evaluate()` call, and its
-         * return value is discarded. This means if `evaluateCallback` is an asynchronous function, the promise returned by
-         * `evaluate()` will not reflect its asynchronous behavior, and any rejections from an asynchronous
-         * `evaluateCallback` will be lost.
-         *
-         * `evaluate()` could also be called again after the module has already been evaluated, in which case:
-         *
-         * 1. If the initial evaluation ended in success (`module.status` is `'evaluated'`), it will do nothing
-         *    and return a promise that resolves to `undefined`.
-         * 2. If the initial evaluation resulted in an exception (`module.status` is `'errored'`), it will re-reject
-         *    the exception that the initial evaluation resulted in.
-         *
-         * This method cannot be called while the module is being evaluated (`module.status` is `'evaluating'`).
+         * Corresponds to the [Evaluate() concrete method](https://tc39.es/ecma262/#sec-moduleevaluation) field of [Cyclic Module Record](https://tc39.es/ecma262/#sec-cyclic-module-records) s in the
+         * ECMAScript specification.
          * @return Fulfills with `undefined` upon success.
          */
         evaluate(options?: ModuleEvaluateOptions): Promise<void>;
@@ -789,10 +834,6 @@ declare module "node:vm" {
          * Link module dependencies. This method must be called before evaluation, and
          * can only be called once per module.
          *
-         * Use `sourceTextModule.linkRequests(modules)` and
-         * `sourceTextModule.instantiate()` to link modules either synchronously or
-         * asynchronously.
-         *
          * The function is expected to return a `Module` object or a `Promise` that
          * eventually resolves to a `Module` object. The returned `Module` must satisfy the
          * following two invariants:
@@ -837,30 +878,10 @@ declare module "node:vm" {
         /**
          * Used to specify how the modules should be loaded during the evaluation of this script when `import()` is called. This option is
          * part of the experimental modules API. We do not recommend using it in a production environment. For detailed information, see
-         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v26.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
-         * @experimental
+         * [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v22.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
          */
         importModuleDynamically?: DynamicModuleLoader<SourceTextModule> | undefined;
     }
-    /**
-     * A `ModuleRequest` represents the request to import a module with given import attributes and phase.
-     * @since 24.4.0
-     */
-    interface ModuleRequest {
-        /**
-         * The specifier of the requested module.
-         */
-        specifier: string;
-        /**
-         * The `"with"` value passed to the `WithClause` in a `ImportDeclaration`, or an empty object if no value was
-         * provided.
-         */
-        attributes: ImportAttributes;
-        /**
-         * The phase of the requested module (`"source"` or `"evaluation"`).
-         */
-        phase: ImportPhase;
-    }
     /**
      * This feature is only available with the `--experimental-vm-modules` command
      * flag enabled.
@@ -873,163 +894,9 @@ declare module "node:vm" {
     class SourceTextModule extends Module {
         /**
          * Creates a new `SourceTextModule` instance.
-         *
-         * Properties assigned to the `import.meta` object that are objects may
-         * allow the module to access information outside the specified `context`. Use
-         * `vm.runInContext()` to create objects in a specific context.
-         *
-         * ```js
-         * import vm from 'node:vm';
-         *
-         * const contextifiedObject = vm.createContext({ secret: 42 });
-         *
-         * const module = new vm.SourceTextModule(
-         *   'Object.getPrototypeOf(import.meta.prop).secret = secret;',
-         *   {
-         *     initializeImportMeta(meta) {
-         *       // Note: this object is created in the top context. As such,
-         *       // Object.getPrototypeOf(import.meta.prop) points to the
-         *       // Object.prototype in the top context rather than that in
-         *       // the contextified object.
-         *       meta.prop = {};
-         *     },
-         *   });
-         * // The module has an empty `moduleRequests` array.
-         * module.linkRequests([]);
-         * module.instantiate();
-         * await module.evaluate();
-         *
-         * // Now, Object.prototype.secret will be equal to 42.
-         * //
-         * // To fix this problem, replace
-         * //     meta.prop = {};
-         * // above with
-         * //     meta.prop = vm.runInContext('{}', contextifiedObject);
-         * ```
          * @param code JavaScript Module code to parse
          */
         constructor(code: string, options?: SourceTextModuleOptions);
-        /**
-         * @deprecated Use `sourceTextModule.moduleRequests` instead.
-         */
-        readonly dependencySpecifiers: readonly string[];
-        /**
-         * Iterates over the dependency graph and returns `true` if any module in its
-         * dependencies or this module itself contains top-level `await` expressions,
-         * otherwise returns `false`.
-         *
-         * The search may be slow if the graph is big enough.
-         *
-         * This requires the module to be instantiated first. If the module is not
-         * instantiated yet, an error will be thrown.
-         * @since v24.9.0
-         */
-        hasAsyncGraph(): boolean;
-        /**
-         * Returns whether the module itself contains any top-level `await` expressions.
-         *
-         * This corresponds to the field `[[HasTLA]]` in [Cyclic Module Record](https://tc39.es/ecma262/#sec-cyclic-module-records) in the
-         * ECMAScript specification.
-         * @since v24.9.0
-         */
-        hasTopLevelAwait(): boolean;
-        /**
-         * Instantiate the module with the linked requested modules.
-         *
-         * This resolves the imported bindings of the module, including re-exported
-         * binding names. When there are any bindings that cannot be resolved,
-         * an error would be thrown synchronously.
-         *
-         * If the requested modules include cyclic dependencies, the
-         * `sourceTextModule.linkRequests(modules)` method must be called on all
-         * modules in the cycle before calling this method.
-         * @since v24.8.0
-         */
-        instantiate(): void;
-        /**
-         * Link module dependencies. This method must be called before evaluation, and
-         * can only be called once per module.
-         *
-         * The order of the module instances in the `modules` array should correspond to the order of
-         * `sourceTextModule.moduleRequests` being resolved. If two module requests have the same
-         * specifier and import attributes, they must be resolved with the same module instance or an
-         * `ERR_MODULE_LINK_MISMATCH` would be thrown. For example, when linking requests for this
-         * module:
-         *
-         * ```js
-         * import foo from 'foo';
-         * import source Foo from 'foo';
-         * ```
-         *
-         * The `modules` array must contain two references to the same instance, because the two
-         * module requests are identical but in two phases.
-         *
-         * If the module has no dependencies, the `modules` array can be empty.
-         *
-         * Users can use `sourceTextModule.moduleRequests` to implement the host-defined
-         * [HostLoadImportedModule](https://tc39.es/ecma262/#sec-HostLoadImportedModule) abstract operation in the ECMAScript specification,
-         * and using `sourceTextModule.linkRequests()` to invoke specification defined
-         * [FinishLoadingImportedModule](https://tc39.es/ecma262/#sec-FinishLoadingImportedModule), on the module with all dependencies in a batch.
-         *
-         * It's up to the creator of the `SourceTextModule` to determine if the resolution
-         * of the dependencies is synchronous or asynchronous.
-         *
-         * After each module in the `modules` array is linked, call
-         * `sourceTextModule.instantiate()`.
-         * @since v24.8.0
-         * @param modules Array of `vm.Module` objects that this module depends on.
-         * The order of the modules in the array is the order of
-         * `sourceTextModule.moduleRequests`.
-         */
-        linkRequests(modules: readonly Module[]): void;
-        /**
-         * The requested import dependencies of this module. The returned array is frozen
-         * to disallow any changes to it.
-         *
-         * For example, given a source text:
-         *
-         * ```js
-         * import foo from 'foo';
-         * import fooAlias from 'foo';
-         * import bar from './bar.js';
-         * import withAttrs from '../with-attrs.ts' with { arbitraryAttr: 'attr-val' };
-         * import source Module from 'wasm-mod.wasm';
-         * ```
-         *
-         * The value of the `sourceTextModule.moduleRequests` will be:
-         *
-         * ```js
-         * [
-         *   {
-         *     specifier: 'foo',
-         *     attributes: {},
-         *     phase: 'evaluation',
-         *   },
-         *   {
-         *     specifier: 'foo',
-         *     attributes: {},
-         *     phase: 'evaluation',
-         *   },
-         *   {
-         *     specifier: './bar.js',
-         *     attributes: {},
-         *     phase: 'evaluation',
-         *   },
-         *   {
-         *     specifier: '../with-attrs.ts',
-         *     attributes: { arbitraryAttr: 'attr-val' },
-         *     phase: 'evaluation',
-         *   },
-         *   {
-         *     specifier: 'wasm-mod.wasm',
-         *     attributes: {},
-         *     phase: 'source',
-         *   },
-         * ];
-         * ```
-         * @since v24.4.0
-         */
-        readonly moduleRequests: readonly ModuleRequest[];
     }
     interface SyntheticModuleOptions {
         /**
@@ -1052,21 +919,15 @@ declare module "node:vm" {
      * module graphs.
      *
      * ```js
-     * import { SyntheticModule } from 'node:vm';
+     * import vm from 'node:vm';
      *
      * const source = '{ "a": 1 }';
-     * const syntheticModule = new SyntheticModule(['default'], function() {
+     * const module = new vm.SyntheticModule(['default'], function() {
      *   const obj = JSON.parse(source);
      *   this.setExport('default', obj);
      * });
      *
-     * // Use `syntheticModule` in linking
-     * (async () => {
-     *   await syntheticModule.link(() => {});
-     *   await syntheticModule.evaluate();
-     *
-     *   console.log('Default export:', syntheticModule.namespace.default);
-     * })();
+     * // Use `module` in linking...
      * ```
      * @since v13.0.0, v12.16.0
      * @experimental
@@ -1083,7 +944,9 @@ declare module "node:vm" {
             options?: SyntheticModuleOptions,
         );
         /**
-         * This method sets the module export binding slots with the given value.
+         * This method is used after the module is linked to set the values of exports. If
+         * it is called before the module is linked, an `ERR_VM_MODULE_STATUS` error
+         * will be thrown.
          *
          * ```js
          * import vm from 'node:vm';
@@ -1092,6 +955,7 @@ declare module "node:vm" {
          *   m.setExport('x', 1);
          * });
          *
+         * await m.link(() => {});
          * await m.evaluate();
          *
          * assert.strictEqual(m.namespace.x, 1);
@@ -1112,7 +976,7 @@ declare module "node:vm" {
          * and `vm.compileFunction()` so that Node.js uses the default ESM loader from the main
          * context to load the requested module.
          *
-         * For detailed information, see [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v26.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
+         * For detailed information, see [Support of dynamic `import()` in compilation APIs](https://nodejs.org/docs/latest-v22.x/api/vm.html#support-of-dynamic-import-in-compilation-apis).
          * @since v21.7.0, v20.12.0
          */
         const USE_MAIN_CONTEXT_DEFAULT_LOADER: number;
@@ -1131,6 +995,6 @@ declare module "node:vm" {
         const DONT_CONTEXTIFY: number;
     }
 }
-declare module "vm" {
-    export * from "node:vm";
+declare module "node:vm" {
+    export * from "vm";
 }