@embroider/core 3.5.1-unstable.f779011 → 3.5.1

package/src/module-resolver.js

@@ -15,51 +15,64 @@ const path_1 = require("path");
 const shared_internals_2 = require("@embroider/shared-internals");
 const debug_1 = __importDefault(require("debug"));
 const assert_never_1 = __importDefault(require("assert-never"));
-const reverse_exports_1 = require("@embroider/reverse-exports");
-const resolve_exports_1 = require("resolve.exports");
+const virtual_content_1 = require("./virtual-content");
 const typescript_memoize_1 = require("typescript-memoize");
 const describe_exports_1 = require("./describe-exports");
 const fs_1 = require("fs");
-const node_resolve_1 = require("./node-resolve");
 const semver_1 = require("semver");
-const module_request_1 = require("./module-request");
+const node_resolve_1 = require("./node-resolve");
 const debug = (0, debug_1.default)('embroider:resolver');
-// Using a formatter makes this work lazy so nothing happens when we aren't
-// logging. It is unfortunate that formatters are a globally mutable config and
-// you can only use single character names, but oh well.
-debug_1.default.formatters.p = (s) => {
-    let cwd = process.cwd();
-    if (s.startsWith(cwd)) {
-        return s.slice(cwd.length + 1);
-    }
-    return s;
-};
 function logTransition(reason, before, after = before) {
-    if (after.resolvedTo) {
-        debug(`[%s:resolvedTo] %s because %s\n  in    %p`, before.debugType, before.specifier, reason, before.fromFile);
+    if (after.isVirtual) {
+        debug(`virtualized %s in %s because %s`, before.specifier, before.fromFile, reason);
     }
     else if (before.specifier !== after.specifier) {
         if (before.fromFile !== after.fromFile) {
-            debug(`[%s:aliased and rehomed] %s to %s\n  because %s\n  from    %p\n  to      %p`, before.debugType, before.specifier, after.specifier, reason, before.fromFile, after.fromFile);
+            debug(`aliased and rehomed: %s to %s, from %s to %s because %s`, before.specifier, after.specifier, before.fromFile, after.fromFile, reason);
         }
         else {
-            debug(`[%s:aliased] %s to %s\n  because %s`, before.debugType, before.specifier, after.specifier, reason);
+            debug(`aliased: %s to %s in %s because`, before.specifier, after.specifier, before.fromFile, reason);
         }
     }
     else if (before.fromFile !== after.fromFile) {
-        debug(`[%s:rehomed] %s, because %s\n  from    %p\n  to      %p`, before.debugType, before.specifier, reason, before.fromFile, after.fromFile);
+        debug(`rehomed: %s from %s to %s because`, before.specifier, before.fromFile, after.fromFile, reason);
     }
     else {
-        debug(`[%s:unchanged] %s because %s\n  in    %p`, before.debugType, before.specifier, reason, before.fromFile);
+        debug(`unchanged: %s in %s because %s`, before.specifier, before.fromFile, reason);
     }
     return after;
 }
-const compatPattern = /@embroider\/virtual\/(?<type>[^\/]+)\/(?<rest>.*)/;
+const compatPattern = /#embroider_compat\/(?<type>[^\/]+)\/(?<rest>.*)/;
+class NodeModuleRequest {
+    constructor(specifier, fromFile, isVirtual, meta) {
+        this.specifier = specifier;
+        this.fromFile = fromFile;
+        this.isVirtual = isVirtual;
+        this.meta = meta;
+    }
+    alias(specifier) {
+        return new NodeModuleRequest(specifier, this.fromFile, false, this.meta);
+    }
+    rehome(fromFile) {
+        if (this.fromFile === fromFile) {
+            return this;
+        }
+        else {
+            return new NodeModuleRequest(this.specifier, fromFile, false, this.meta);
+        }
+    }
+    virtualize(filename) {
+        return new NodeModuleRequest(filename, this.fromFile, true, this.meta);
+    }
+    withMeta(meta) {
+        return new NodeModuleRequest(this.specifier, this.fromFile, this.isVirtual, meta);
+    }
+}
 class Resolver {
     constructor(options) {
         this.options = options;
     }
-    async beforeResolve(request) {
+    beforeResolve(request) {
         if (request.specifier === '@embroider/macros') {
             // the macros package is always handled directly within babel (not
             // necessarily as a real resolvable package), so we should not mess with it.
@@ -68,15 +81,9 @@ class Resolver {
             return logTransition('early exit', request);
         }
         request = this.handleFastbootSwitch(request);
-        request = await this.handleGlobalsCompat(request);
+        request = this.handleGlobalsCompat(request);
         request = this.handleImplicitModules(request);
-        request = this.handleImplicitTestScripts(request);
-        request = this.handleVendorStyles(request);
-        request = this.handleTestSupportStyles(request);
-        request = this.handleEntrypoint(request);
-        request = this.handleRouteEntrypoint(request);
         request = this.handleRenaming(request);
-        request = this.handleVendor(request);
         // we expect the specifier to be app relative at this point - must be after handleRenaming
         request = this.generateFastbootSwitch(request);
         request = this.preHandleExternal(request);
@@ -90,16 +97,34 @@ class Resolver {
     // that calls your build system's normal module resolver, this does both pre-
     // and post-resolution adjustments as needed to implement our compatibility
     // rules.
-    async resolve(request) {
-        request = await this.beforeResolve(request);
-        let resolution;
-        if (request.resolvedTo) {
-            resolution = await (0, module_request_1.extractResolution)(request.resolvedTo);
-        }
-        else {
-            resolution = await request.defaultResolve();
-        }
-        resolution = await this.afterResolve(request, resolution);
+    //
+    // Depending on the plugin architecture you're working in, it may be easier to
+    // call beforeResolve and fallbackResolve directly, in which case matching the
+    // details of the recursion to what this method does are your responsibility.
+    async resolve(request, defaultResolve) {
+        let gen = this.internalResolve(request, defaultResolve);
+        let out = gen.next();
+        while (!out.done) {
+            out = gen.next(await out.value);
+        }
+        return out.value;
+    }
+    // synchronous alternative to resolve() above. Because our own internals are
+    // all synchronous, you can use this if your defaultResolve function is
+    // synchronous.
+    resolveSync(request, defaultResolve) {
+        let gen = this.internalResolve(request, defaultResolve);
+        let out = gen.next();
+        while (!out.done) {
+            out = gen.next(out.value);
+        }
+        return out.value;
+    }
+    // Our core implementation is a generator so it can power both resolve() and
+    // resolveSync()
+    *internalResolve(request, defaultResolve) {
+        request = this.beforeResolve(request);
+        let resolution = yield defaultResolve(request);
         switch (resolution.type) {
             case 'found':
                 return resolution;
@@ -108,57 +133,51 @@ class Resolver {
             default:
                 throw (0, assert_never_1.default)(resolution);
         }
-        request = request.clone();
-        let nextRequest = await this.fallbackResolve(request);
+        let nextRequest = this.fallbackResolve(request);
         if (nextRequest === request) {
             // no additional fallback is available.
             return resolution;
         }
-        if (nextRequest.resolvedTo) {
-            return await (0, module_request_1.extractResolution)(nextRequest.resolvedTo);
-        }
         if (nextRequest.fromFile === request.fromFile && nextRequest.specifier === request.specifier) {
             throw new Error('Bug Discovered! New request is not === original request but has the same fromFile and specifier. This will likely create a loop.');
         }
-        return this.resolve(nextRequest);
+        if (nextRequest.isVirtual) {
+            // virtual requests are terminal, there is no more beforeResolve or
+            // fallbackResolve around them. The defaultResolve is expected to know how
+            // to implement them.
+            return yield defaultResolve(nextRequest);
+        }
+        return yield* this.internalResolve(nextRequest, defaultResolve);
     }
     // Use standard NodeJS resolving, with our required compatibility rules on
     // top. This is a convenience method for calling resolveSync with the
     // defaultResolve already configured to be "do the normal node thing".
-    async nodeResolve(specifier, fromFile, opts) {
-        return (0, node_resolve_1.nodeResolve)(this, specifier, fromFile, opts);
+    nodeResolve(specifier, fromFile) {
+        let resolution = this.resolveSync(new NodeModuleRequest(specifier, fromFile, false, undefined), request => {
+            if (request.isVirtual) {
+                return {
+                    type: 'found',
+                    result: {
+                        type: 'virtual',
+                        content: (0, virtual_content_1.virtualContent)(request.specifier, this),
+                        filename: request.specifier,
+                    },
+                };
+            }
+            return (0, node_resolve_1.resolve)(request.specifier, request.fromFile);
+        });
+        switch (resolution.type) {
+            case 'not_found':
+                return resolution;
+            case 'found':
+                return resolution.result;
+            default:
+                throw (0, assert_never_1.default)(resolution);
+        }
     }
     get packageCache() {
         return shared_internals_2.RewrittenPackageCache.shared('embroider', this.options.appRoot);
     }
-    async afterResolve(request, resolution) {
-        resolution = await this.handleSyntheticComponents(request, resolution);
-        return resolution;
-    }
-    async handleSyntheticComponents(request, resolution) {
-        // Key assumption: the system's defaultResolve performs extension search for
-        // extensionless requests, with JS at a higher priority than HBS.
-        // When the request had an explicit ".js" extension, the system default
-        // extension search doesn't help us locate an HBS, so we need to check for
-        // it ourselves here.
-        if (resolution.type === 'not_found') {
-            let hbsSpecifier = (0, shared_internals_1.syntheticJStoHBS)(request.specifier);
-            if (hbsSpecifier) {
-                resolution = await this.resolve(request.alias(hbsSpecifier));
-            }
-        }
-        // At this point, we might have resolved an HBS file (either because the
-        // request was extensionless and the default search found it, or because of
-        // our own code above) when the request was for a JS file.
-        if (resolution.type === 'found') {
-            let syntheticId = (0, shared_internals_1.needsSyntheticComponentJS)(request.specifier, resolution.filename);
-            if (syntheticId && (0, shared_internals_1.isInComponents)(resolution.filename, this.packageCache)) {
-                let newRequest = logTransition(`synthetic component JS`, request, request.virtualize({ type: 'template-only-component-js', specifier: syntheticId }));
-                return await (0, module_request_1.extractResolution)(newRequest.resolvedTo);
-            }
-        }
-        return resolution;
-    }
     logicalPackage(owningPackage, file) {
         let logicalLocation = this.reverseSearchAppTree(owningPackage, file);
         if (logicalLocation) {
@@ -171,9 +190,6 @@ class Resolver {
         return owningPackage;
     }
     generateFastbootSwitch(request) {
-        if (request.resolvedTo) {
-            return request;
-        }
         let pkg = this.packageCache.ownerOfFile(request.fromFile);
         if (!pkg) {
             return request;
@@ -191,11 +207,9 @@ class Resolver {
                 let fastbootFile = engineConfig.fastbootFiles[candidate];
                 if (fastbootFile) {
                     if (fastbootFile.shadowedFilename) {
-                        let { names } = (0, describe_exports_1.describeExports)((0, fs_1.readFileSync)((0, path_1.resolve)(pkg.root, fastbootFile.shadowedFilename), 'utf8'), {
-                            configFile: false,
-                        });
-                        let switchFile = fastbootSwitch(candidate, (0, path_1.resolve)(pkg.root, 'package.json'), names);
-                        if (switchFile.specifier === request.fromFile) {
+                        let { names } = (0, describe_exports_1.describeExports)((0, fs_1.readFileSync)((0, path_1.resolve)(pkg.root, fastbootFile.shadowedFilename), 'utf8'), {});
+                        let switchFile = (0, virtual_content_1.fastbootSwitch)(candidate, (0, path_1.resolve)(pkg.root, 'package.json'), names);
+                        if (switchFile === request.fromFile) {
                             return logTransition('internal lookup from fastbootSwitch', request);
                         }
                         else {
@@ -212,10 +226,7 @@ class Resolver {
     }
     handleFastbootSwitch(request) {
         var _a;
-        if (request.resolvedTo) {
-            return request;
-        }
-        let match = decodeFastbootSwitch(request.fromFile);
+        let match = (0, virtual_content_1.decodeFastbootSwitch)(request.fromFile);
         if (!match) {
             return request;
         }
@@ -253,122 +264,30 @@ class Resolver {
             }
             let entry = (_a = this.getEntryFromMergeMap(rel, pkg.root)) === null || _a === void 0 ? void 0 : _a.entry;
             if ((entry === null || entry === void 0 ? void 0 : entry.type) === 'both') {
-                return logTransition('matched addon entry', request, request.alias(entry[section].specifier).rehome(entry[section].fromFile));
+                return logTransition('matched addon entry', request, request.alias(entry[section].localPath).rehome((0, path_1.resolve)(entry[section].packageRoot, 'package.json')));
             }
         }
         return logTransition('failed to match in fastboot switch', request);
     }
     handleImplicitModules(request) {
-        if (request.resolvedTo) {
+        let im = (0, virtual_content_1.decodeImplicitModules)(request.specifier);
+        if (!im) {
             return request;
         }
-        for (let variant of ['', 'test-']) {
-            let suffix = `-embroider-implicit-${variant}modules.js`;
-            if (!request.specifier.endsWith(suffix)) {
-                continue;
-            }
-            let filename = request.specifier.slice(0, -1 * suffix.length);
-            if (!filename.endsWith('/') && filename.endsWith('\\')) {
-                continue;
-            }
-            filename = filename.slice(0, -1);
-            let pkg = this.packageCache.ownerOfFile(request.fromFile);
-            if (!(pkg === null || pkg === void 0 ? void 0 : pkg.isV2Ember())) {
-                throw new Error(`bug: found implicit modules import in non-ember package at ${request.fromFile}`);
-            }
-            let type = `implicit-${variant}modules`;
-            let packageName = (0, shared_internals_1.packageName)(filename);
-            if (packageName) {
-                let dep = this.packageCache.resolve(packageName, pkg);
-                return logTransition(`dep's implicit modules`, request, request.virtualize({ type, specifier: (0, path_1.resolve)(dep.root, `-embroider-${type}.js`), fromFile: dep.root }));
-            }
-            else {
-                return logTransition(`own implicit modules`, request, request.virtualize({ type, specifier: (0, path_1.resolve)(pkg.root, `-embroider-${type}.js`), fromFile: pkg.root }));
-            }
-        }
-        return request;
-    }
-    handleEntrypoint(request) {
-        var _a;
-        if (request.resolvedTo) {
-            return request;
-        }
-        const compatModulesSpecifier = '@embroider/virtual/compat-modules';
-        let isCompatModules = request.specifier === compatModulesSpecifier || request.specifier.startsWith(compatModulesSpecifier + '/');
-        if (!isCompatModules) {
-            return request;
-        }
-        const requestingPkg = this.packageCache.ownerOfFile(request.fromFile);
-        if (!(requestingPkg === null || requestingPkg === void 0 ? void 0 : requestingPkg.isV2Ember())) {
-            throw new Error(`bug: found entrypoint import in non-ember package at ${request.fromFile}`);
-        }
-        let pkg;
-        if (request.specifier === compatModulesSpecifier) {
-            pkg = requestingPkg;
-        }
-        else {
-            let packageName = request.specifier.slice(compatModulesSpecifier.length + 1);
-            pkg = this.packageCache.resolve(packageName, requestingPkg);
-        }
-        let matched = (0, resolve_exports_1.exports)(pkg.packageJSON, '-embroider-entrypoint.js', {
-            browser: true,
-            conditions: ['default', 'imports'],
-        });
-        let specifier = (0, path_1.resolve)(pkg.root, (_a = matched === null || matched === void 0 ? void 0 : matched[0]) !== null && _a !== void 0 ? _a : '-embroider-entrypoint.js');
-        return logTransition('entrypoint', request, request.virtualize({
-            type: 'entrypoint',
-            specifier,
-            fromDir: (0, path_1.dirname)(specifier),
-        }));
-    }
-    handleRouteEntrypoint(request) {
-        if (request.resolvedTo) {
-            return request;
-        }
-        const publicPrefix = '@embroider/core/route/';
-        if (!request.specifier.startsWith(publicPrefix)) {
-            return request;
-        }
-        let routeName = request.specifier.slice(publicPrefix.length);
         let pkg = this.packageCache.ownerOfFile(request.fromFile);
         if (!(pkg === null || pkg === void 0 ? void 0 : pkg.isV2Ember())) {
-            throw new Error(`bug: found entrypoint import in non-ember package at ${request.fromFile}`);
+            throw new Error(`bug: found implicit modules import in non-ember package at ${request.fromFile}`);
         }
-        let matched = (0, resolve_exports_1.exports)(pkg.packageJSON, '-embroider-route-entrypoint.js', {
-            browser: true,
-            conditions: ['default', 'imports'],
-        });
-        let target = matched ? `${matched}:route=${routeName}` : `-embroider-route-entrypoint.js:route=${routeName}`;
-        let specifier = (0, path_1.resolve)(pkg.root, target);
-        return logTransition('route entrypoint', request, request.virtualize({ type: 'route-entrypoint', specifier, route: routeName, fromDir: (0, path_1.dirname)(specifier) }));
-    }
-    handleImplicitTestScripts(request) {
-        if (request.specifier !== '@embroider/virtual/test-support.js') {
-            return request;
+        let packageName = (0, shared_internals_1.packageName)(im.fromFile);
+        if (packageName) {
+            let dep = this.packageCache.resolve(packageName, pkg);
+            return logTransition(`dep's implicit modules`, request, request.virtualize((0, path_1.resolve)(dep.root, `-embroider-${im.type}.js`)));
         }
-        let pkg = this.packageCache.ownerOfFile(request.fromFile);
-        if ((pkg === null || pkg === void 0 ? void 0 : pkg.root) !== this.options.engines[0].root) {
-            throw new Error(`bug: found an import of ${request.specifier} in ${request.fromFile}, but this is not the top-level Ember app. The top-level Ember app is the only one that has support for @embroider/virtual/test-support.js. If you think something should be fixed in Embroider, please open an issue on https://github.com/embroider-build/embroider/issues.`);
-        }
-        return logTransition('test-support', request, request.virtualize({ type: 'test-support-js', specifier: (0, path_1.resolve)(pkg.root, '-embroider-test-support.js') }));
-    }
-    handleTestSupportStyles(request) {
-        if (request.specifier !== '@embroider/virtual/test-support.css') {
-            return request;
-        }
-        let pkg = this.packageCache.ownerOfFile(request.fromFile);
-        if ((pkg === null || pkg === void 0 ? void 0 : pkg.root) !== this.options.engines[0].root) {
-            throw new Error(`bug: found an import of ${request.specifier} in ${request.fromFile}, but this is not the top-level Ember app. The top-level Ember app is the only one that has support for @embroider/virtual/test-support.css. If you think something should be fixed in Embroider, please open an issue on https://github.com/embroider-build/embroider/issues.`);
+        else {
+            return logTransition(`own implicit modules`, request, request.virtualize((0, path_1.resolve)(pkg.root, `-embroider-${im.type}.js`)));
         }
-        return logTransition('test-support-styles', request, request.virtualize({
-            type: 'test-support-css',
-            specifier: (0, path_1.resolve)(pkg.root, '-embroider-test-support-styles.css'),
-        }));
     }
-    async handleGlobalsCompat(request) {
-        if (request.resolvedTo) {
-            return request;
-        }
+    handleGlobalsCompat(request) {
         let match = compatPattern.exec(request.specifier);
         if (!match) {
             return request;
@@ -389,81 +308,62 @@ class Resolver {
             case 'ambiguous':
                 return this.resolveHelperOrComponent(rest, engine, request);
             default:
-                throw new Error(`bug: unexepected @embroider/virtual specifier: ${request.specifier}`);
-        }
-    }
-    handleVendorStyles(request) {
-        if (request.specifier !== '@embroider/virtual/vendor.css') {
-            return request;
-        }
-        let pkg = this.packageCache.ownerOfFile(request.fromFile);
-        if (!pkg || !this.options.engines.some(e => e.root === (pkg === null || pkg === void 0 ? void 0 : pkg.root))) {
-            throw new Error(`bug: found an import of ${request.specifier} in ${request.fromFile}, but this is not the top-level Ember app or Engine. The top-level Ember app is the only one that has support for @embroider/virtual/vendor.css. If you think something should be fixed in Embroider, please open an issue on https://github.com/embroider-build/embroider/issues.`);
+                throw new Error(`bug: unexepected #embroider_compat specifier: ${request.specifier}`);
         }
-        return logTransition('vendor-styles', request, request.virtualize({ type: 'vendor-css', specifier: (0, path_1.resolve)(pkg.root, '-embroider-vendor-styles.css') }));
     }
     resolveHelper(path, inEngine, request) {
         let target = this.parseGlobalPath(path, inEngine);
         return logTransition('resolveHelper', request, request.alias(`${target.packageName}/helpers/${target.memberName}`).rehome((0, path_1.resolve)(inEngine.root, 'package.json')));
     }
-    async resolveComponent(path, inEngine, request) {
-        var _a, _b;
+    resolveComponent(path, inEngine, request) {
         let target = this.parseGlobalPath(path, inEngine);
         let hbsModule = null;
         let jsModule = null;
         // first, the various places our template might be.
         for (let candidate of this.componentTemplateCandidates(target.packageName)) {
-            let candidateSpecifier = `${target.packageName}${candidate.prefix}${target.memberName}${candidate.suffix}`;
-            let resolution = await this.resolve(request.alias(candidateSpecifier).rehome(target.from));
-            if (resolution.type === 'found') {
-                hbsModule = resolution;
+            let resolution = this.nodeResolve(`${target.packageName}${candidate.prefix}${target.memberName}${candidate.suffix}`, target.from);
+            if (resolution.type === 'real') {
+                hbsModule = resolution.filename;
                 break;
             }
         }
         // then the various places our javascript might be.
         for (let candidate of this.componentJSCandidates(target.packageName)) {
-            let candidateSpecifier = `${target.packageName}${candidate.prefix}${target.memberName}${candidate.suffix}`;
-            let resolution = await this.resolve(request.alias(candidateSpecifier).rehome(target.from));
+            let resolution = this.nodeResolve(`${target.packageName}${candidate.prefix}${target.memberName}${candidate.suffix}`, target.from);
             // .hbs is a resolvable extension for us, so we need to exclude it here.
             // It matches as a priority lower than .js, so finding an .hbs means
             // there's definitely not a .js.
-            if (resolution.type === 'found' && !resolution.filename.endsWith('.hbs')) {
-                jsModule = resolution;
+            if (resolution.type === 'real' && !resolution.filename.endsWith('.hbs')) {
+                jsModule = resolution.filename;
                 break;
             }
         }
         if (hbsModule) {
             if (!this.emberVersionSupportsSeparateTemplates) {
-                throw new Error(`Components with separately resolved templates were removed at Ember 6.0. Migrate to either co-located js/ts + hbs files or to gjs/gts. https://deprecations.emberjs.com/id/component-template-resolving/. Bad template was: ${hbsModule.filename}.`);
+                throw new Error(`Components with separately resolved templates were removed at Ember 6.0. Migrate to either co-located js/ts + hbs files or to gjs/gts. https://deprecations.emberjs.com/id/component-template-resolving/. Bad template was: ${hbsModule}.`);
             }
-            return logTransition(`resolveComponent found legacy HBS`, request, request.virtualize({
-                type: 'component-pair',
-                hbsModule: hbsModule.filename,
-                jsModule: (_a = jsModule === null || jsModule === void 0 ? void 0 : jsModule.filename) !== null && _a !== void 0 ? _a : null,
-                debugName: (0, path_1.basename)(hbsModule.filename).replace(/\.(js|hbs)$/, ''),
-                specifier: `${this.options.appRoot}/embroider-pair-component/${encodeURIComponent(hbsModule.filename)}/__vpc__/${encodeURIComponent((_b = jsModule === null || jsModule === void 0 ? void 0 : jsModule.filename) !== null && _b !== void 0 ? _b : '')}`,
-            }));
+            return logTransition(`resolveComponent found legacy HBS`, request, request.virtualize((0, virtual_content_1.virtualPairComponent)(hbsModule, jsModule)));
         }
         else if (jsModule) {
-            return logTransition(`resolving to resolveComponent found only JS`, request, request.resolveTo(jsModule));
+            return logTransition(`resolveComponent found only JS`, request, request.alias(jsModule).rehome(target.from));
         }
         else {
             return logTransition(`resolveComponent failed`, request);
         }
     }
-    async resolveHelperOrComponent(path, inEngine, request) {
+    resolveHelperOrComponent(path, inEngine, request) {
         // resolveHelper just rewrites our request to one that should target the
         // component, so here to resolve the ambiguity we need to actually resolve
         // that candidate to see if it works.
         let helperCandidate = this.resolveHelper(path, inEngine, request);
-        let helperMatch = await this.resolve(request.alias(helperCandidate.specifier).rehome(helperCandidate.fromFile));
-        if (helperMatch.type === 'found') {
-            return logTransition('resolve to ambiguous case matched a helper', request, request.resolveTo(helperMatch));
+        let helperMatch = this.nodeResolve(helperCandidate.specifier, helperCandidate.fromFile);
+        if (helperMatch.type === 'real') {
+            return logTransition('ambiguous case matched a helper', request, helperCandidate);
         }
         // unlike resolveHelper, resolveComponent already does pre-resolution in
         // order to deal with its own internal ambiguity around JS vs HBS vs
         // colocation.≥
-        let componentMatch = await this.resolveComponent(path, inEngine, request);
+        let componentMatch = this.resolveComponent(path, inEngine, request);
         if (componentMatch !== request) {
             return logTransition('ambiguous case matched a cmoponent', request, componentMatch);
         }
@@ -488,7 +388,6 @@ class Resolver {
     }
     *componentJSCandidates(inPackageName) {
         yield { prefix: '/components/', suffix: '' };
-        yield { prefix: '/components/', suffix: '/index' };
         yield { prefix: '/components/', suffix: '/component' };
         let pods = this.podPrefix(inPackageName);
         if (pods) {
@@ -507,10 +406,10 @@ class Resolver {
     parseGlobalPath(path, inEngine) {
         let parts = path.split('@');
         if (parts.length > 1 && parts[0].length > 0) {
-            return { packageName: parts[0], memberName: parts[1], from: (0, path_1.resolve)(inEngine.root, 'package.json') };
+            return { packageName: parts[0], memberName: parts[1], from: (0, path_1.resolve)(inEngine.root, 'pacakge.json') };
         }
         else {
-            return { packageName: inEngine.packageName, memberName: path, from: (0, path_1.resolve)(inEngine.root, 'package.json') };
+            return { packageName: inEngine.packageName, memberName: path, from: (0, path_1.resolve)(inEngine.root, 'pacakge.json') };
         }
     }
     engineConfig(packageName) {
@@ -536,18 +435,14 @@ class Resolver {
                         if (!inAddonName.startsWith('./')) {
                             throw new Error(`addon ${addon.name} declares app-js in its package.json with the illegal name "${inAddonName}". It must start with "./" to make it clear that it's relative to the addon`);
                         }
-                        let specifier = (0, reverse_exports_1.externalName)(addon.packageJSON, inAddonName);
-                        if (!specifier) {
-                            throw new Error(`${addon.name}'s package.json app-js refers to ${inAddonName}, but that module is not accessible from outside the package`);
-                        }
                         let prevEntry = engineModules.get(inEngineName);
                         switch (prevEntry === null || prevEntry === void 0 ? void 0 : prevEntry.type) {
                             case undefined:
                                 engineModules.set(inEngineName, {
                                     type: 'app-only',
                                     'app-js': {
-                                        specifier,
-                                        fromFile: addonConfig.canResolveFromFile,
+                                        localPath: inAddonName,
+                                        packageRoot: addon.root,
                                         fromPackageName: addon.name,
                                     },
                                 });
@@ -560,8 +455,8 @@ class Resolver {
                                 engineModules.set(inEngineName, {
                                     type: 'both',
                                     'app-js': {
-                                        specifier,
-                                        fromFile: addonConfig.canResolveFromFile,
+                                        localPath: inAddonName,
+                                        packageRoot: addon.root,
                                         fromPackageName: addon.name,
                                     },
                                     'fastboot-js': prevEntry['fastboot-js'],
@@ -579,18 +474,14 @@ class Resolver {
                         if (!inAddonName.startsWith('./')) {
                             throw new Error(`addon ${addon.name} declares fastboot-js in its package.json with the illegal name "${inAddonName}". It must start with "./" to make it clear that it's relative to the addon`);
                         }
-                        let specifier = (0, reverse_exports_1.externalName)(addon.packageJSON, inAddonName);
-                        if (!specifier) {
-                            throw new Error(`${addon.name}'s package.json fastboot-js refers to ${inAddonName}, but that module is not accessible from outside the package`);
-                        }
                         let prevEntry = engineModules.get(inEngineName);
                         switch (prevEntry === null || prevEntry === void 0 ? void 0 : prevEntry.type) {
                             case undefined:
                                 engineModules.set(inEngineName, {
                                     type: 'fastboot-only',
                                     'fastboot-js': {
-                                        specifier,
-                                        fromFile: addonConfig.canResolveFromFile,
+                                        localPath: inAddonName,
+                                        packageRoot: addon.root,
                                         fromPackageName: addon.name,
                                     },
                                 });
@@ -603,8 +494,8 @@ class Resolver {
                                 engineModules.set(inEngineName, {
                                     type: 'both',
                                     'fastboot-js': {
-                                        specifier,
-                                        fromFile: addonConfig.canResolveFromFile,
+                                        localPath: inAddonName,
+                                        packageRoot: addon.root,
                                         fromPackageName: addon.name,
                                     },
                                     'app-js': prevEntry['app-js'],
@@ -635,7 +526,7 @@ class Resolver {
         });
     }
     handleRewrittenPackages(request) {
-        if (request.resolvedTo) {
+        if (request.isVirtual) {
             return request;
         }
         let requestingPkg = this.packageCache.ownerOfFile(request.fromFile);
@@ -654,6 +545,10 @@ class Resolver {
                 targetPkg = this.packageCache.resolve(packageName, requestingPkg);
             }
             catch (err) {
+                // this is not the place to report resolution failures. If the thing
+                // doesn't resolve, we're just not interested in redirecting it for
+                // backward-compat, that's all. The rest of the system will take care of
+                // reporting a failure to resolve (or handling it a different way)
                 if (err.code !== 'MODULE_NOT_FOUND') {
                     throw err;
                 }
@@ -669,27 +564,14 @@ class Resolver {
             return logTransition('request targets a moved package', request, this.resolveWithinMovedPackage(request, targetPkg));
         }
         else if (originalRequestingPkg !== requestingPkg) {
-            if (targetPkg) {
-                // in this case, the requesting package is moved but its destination is
-                // not, so we need to rehome the request back to the original location.
-                return logTransition('outbound request from moved package', request, request
-                    // setting meta here because if this fails, we want the fallback
-                    // logic to revert our rehome and continue from the *moved* package.
-                    .withMeta({ originalFromFile: request.fromFile })
-                    .rehome((0, path_1.resolve)(originalRequestingPkg.root, 'package.json')));
-            }
-            else {
-                // requesting package was moved and we failed to find its target. We
-                // can't let that accidentally succeed in the defaultResolve because we
-                // could escape the moved package system.
-                return logTransition('missing outbound request from moved package', request, request.notFound());
-            }
+            // in this case, the requesting package is moved but its destination is
+            // not, so we need to rehome the request back to the original location.
+            return logTransition('outbound request from moved package', request, request.withMeta({ wasMovedTo: request.fromFile }).rehome((0, path_1.resolve)(originalRequestingPkg.root, 'package.json')));
         }
         return request;
     }
     handleRenaming(request) {
-        var _a;
-        if (request.resolvedTo) {
+        if (request.isVirtual) {
             return request;
         }
         let packageName = (0, shared_internals_1.packageName)(request.specifier);
@@ -697,11 +579,14 @@ class Resolver {
             return request;
         }
         let pkg = this.packageCache.ownerOfFile(request.fromFile);
+        if (!pkg || !pkg.isV2Ember()) {
+            return request;
+        }
         // real deps take precedence over renaming rules. That is, a package like
         // ember-source might provide backburner via module renaming, but if you
         // have an explicit dependency on backburner you should still get that real
         // copy.
-        if (!(pkg === null || pkg === void 0 ? void 0 : pkg.hasDependency(packageName))) {
+        if (!pkg.hasDependency(packageName)) {
             for (let [candidate, replacement] of Object.entries(this.options.renameModules)) {
                 if (candidate === request.specifier) {
                     return logTransition(`renameModules`, request, request.alias(replacement));
@@ -719,74 +604,30 @@ class Resolver {
                 return logTransition(`renamePackages`, request, request.alias(request.specifier.replace(packageName, this.options.renamePackages[packageName])));
             }
         }
-        if (!pkg || !pkg.isV2Ember()) {
-            return request;
-        }
-        if (pkg.name === packageName) {
-            // we found a self-import
-            if ((_a = pkg.meta) === null || _a === void 0 ? void 0 : _a['auto-upgraded']) {
-                // auto-upgraded packages always get automatically adjusted. They never
-                // supported fancy package.json exports features so this direct mapping
-                // to the root is always right.
-                // "my-app/foo" -> "./foo" from app's package.json
-                // "my-addon/foo" -> "my-addon/foo" from a package that's guaranteed to be able to resolve my-addon
-                let owningEngine = this.owningEngine(pkg);
-                let addonConfig = owningEngine.activeAddons.find(a => a.root === pkg.root);
-                if (addonConfig) {
-                    // auto-upgraded addons get special support for self-resolving here.
-                    return logTransition(`v1 addon self-import`, request, request.rehome(addonConfig.canResolveFromFile));
-                }
-                else {
-                    // auto-upgraded apps will necessarily have packageJSON.exports
-                    // because we insert them, so for that support we can fall through to
-                    // that support below.
-                }
-            }
-            // v2 packages are supposed to use package.json `exports` to enable
-            // self-imports, but not all build tools actually follow the spec. This
-            // is a workaround for badly behaved packagers.
-            //
-            // Known upstream bugs this works around:
-            // - https://github.com/vitejs/vite/issues/9731
-            if (pkg.packageJSON.exports) {
-                let found = (0, resolve_exports_1.exports)(pkg.packageJSON, request.specifier, {
-                    browser: true,
-                    conditions: ['default', 'imports'],
-                });
-                if (found === null || found === void 0 ? void 0 : found[0]) {
-                    return logTransition(`v2 self-import with package.json exports`, request, request.alias(found === null || found === void 0 ? void 0 : found[0]).rehome((0, path_1.resolve)(pkg.root, 'package.json')));
-                }
-            }
+        if (pkg.meta['auto-upgraded'] && pkg.name === packageName) {
+            // we found a self-import, resolve it for them. Only auto-upgraded
+            // packages get this help, v2 packages are natively supposed to make their
+            // own modules resolvable, and we want to push them all to do that
+            // correctly.
+            return logTransition(`v1 self-import`, request, request.alias(request.specifier.replace(pkg.name, '.')).rehome((0, path_1.resolve)(pkg.root, 'package.json')));
         }
         return request;
     }
-    handleVendor(request) {
-        if (request.specifier !== '@embroider/virtual/vendor.js') {
-            return request;
-        }
-        let pkg = this.packageCache.ownerOfFile(request.fromFile);
-        if ((pkg === null || pkg === void 0 ? void 0 : pkg.root) !== this.options.engines[0].root) {
-            throw new Error(`bug: found an import of ${request.specifier} in ${request.fromFile}, but this is not the top-level Ember app. The top-level Ember app is the only one that has support for @embroider/virtual/vendor.js. If you think something should be fixed in Embroider, please open an issue on https://github.com/embroider-build/embroider/issues.`);
-        }
-        return logTransition('vendor', request, request.virtualize({ type: 'vendor-js', specifier: (0, path_1.resolve)(pkg.root, '-embroider-vendor.js') }));
-    }
     resolveWithinMovedPackage(request, pkg) {
         let levels = ['..'];
         if (pkg.name.startsWith('@')) {
             levels.push('..');
         }
-        let originalFromFile = request.fromFile;
         let newRequest = request.rehome((0, path_1.resolve)(pkg.root, ...levels, 'moved-package-target.js'));
         if (newRequest === request) {
             return request;
         }
-        // setting meta because if this fails, we want the fallback to pick up back
-        // in the original requesting package.
-        return newRequest.withMeta({ originalFromFile });
+        return newRequest.withMeta({
+            resolvedWithinPackage: pkg.root,
+        });
     }
     preHandleExternal(request) {
-        var _a;
-        if (request.resolvedTo) {
+        if (request.isVirtual) {
             return request;
         }
         let { specifier, fromFile } = request;
@@ -796,6 +637,11 @@ class Resolver {
         }
         let packageName = (0, shared_internals_1.packageName)(specifier);
         if (!packageName) {
+            // This is a relative import. We don't automatically externalize those
+            // because it's rare, and by keeping them static we give better errors. But
+            // we do allow them to be explicitly externalized by the package author (or
+            // a compat adapter). In the metadata, they would be listed in
+            // package-relative form, so we need to convert this specifier to that.
             let absoluteSpecifier = (0, path_1.resolve)((0, path_1.dirname)(fromFile), specifier);
             if (!absoluteSpecifier.startsWith(pkg.root)) {
                 // this relative path escape its package. So it's not really using
@@ -804,35 +650,48 @@ class Resolver {
                 // references to runtime utilities, like we do in @embroider/macros.
                 return logTransition('beforeResolve: relative path escapes its package', request);
             }
+            let packageRelativeSpecifier = (0, shared_internals_2.explicitRelative)(pkg.root, absoluteSpecifier);
+            if (isExplicitlyExternal(packageRelativeSpecifier, pkg)) {
+                let publicSpecifier = absoluteSpecifier.replace(pkg.root, pkg.name);
+                return this.external('beforeResolve', request, publicSpecifier);
+            }
             // if the requesting file is in an addon's app-js, the relative request
             // should really be understood as a request for a module in the containing
-            // engine.
+            // engine
             let logicalLocation = this.reverseSearchAppTree(pkg, request.fromFile);
             if (logicalLocation) {
-                return logTransition('beforeResolve: relative import in app-js', request, request.alias(path_1.posix.join(logicalLocation.owningEngine.packageName, (0, path_1.dirname)(logicalLocation.inAppName), request.specifier)));
+                return logTransition('beforeResolve: relative import in app-js', request, request.rehome((0, path_1.resolve)(logicalLocation.owningEngine.root, logicalLocation.inAppName)));
             }
             return request;
         }
+        // absolute package imports can also be explicitly external based on their
+        // full specifier name
+        if (isExplicitlyExternal(specifier, pkg)) {
+            return this.external('beforeResolve', request, specifier);
+        }
+        if (shared_internals_1.emberVirtualPackages.has(packageName) && !pkg.hasDependency(packageName)) {
+            return this.external('beforeResolve emberVirtualPackages', request, specifier);
+        }
         if (shared_internals_1.emberVirtualPeerDeps.has(packageName) && !pkg.hasDependency(packageName)) {
             // addons (whether auto-upgraded or not) may use the app's
             // emberVirtualPeerDeps, like "@glimmer/component" etc.
-            let addon = this.locateActiveAddon(packageName);
-            if (!addon) {
-                throw new Error(`${pkg.name} is trying to import the emberVirtualPeerDep "${packageName}", but it seems to be missing`);
+            if (!this.options.activeAddons[packageName]) {
+                throw new Error(`${pkg.name} is trying to import the app's ${packageName} package, but it seems to be missing`);
             }
-            return logTransition(`emberVirtualPeerDeps`, request, request.rehome(addon.canResolveFromFile));
+            let newHome = (0, path_1.resolve)(this.packageCache.maybeMoved(this.packageCache.get(this.options.appRoot)).root, 'package.json');
+            return logTransition(`emberVirtualPeerDeps in v2 addon`, request, request.rehome(newHome));
         }
         // if this file is part of an addon's app-js, it's really the logical
         // package to which it belongs (normally the app) that affects some policy
         // choices about what it can import
         let logicalPackage = this.logicalPackage(pkg, fromFile);
-        if (((_a = logicalPackage.meta) === null || _a === void 0 ? void 0 : _a['auto-upgraded']) && !logicalPackage.hasDependency('ember-auto-import')) {
+        if (logicalPackage.meta['auto-upgraded'] && !logicalPackage.hasDependency('ember-auto-import')) {
             try {
                 let dep = this.packageCache.resolve(packageName, logicalPackage);
-                if (!dep.isEmberAddon()) {
+                if (!dep.isEmberPackage()) {
                     // classic ember addons can only import non-ember dependencies if they
                     // have ember-auto-import.
-                    return logTransition('v1 package without auto-import', request, request.notFound());
+                    return this.external('v1 package without auto-import', request, specifier);
                 }
             }
             catch (err) {
@@ -842,33 +701,49 @@ class Resolver {
             }
         }
         // assertions on what native v2 addons can import
-        if (!pkg.needsLooseResolving() &&
-            !appImportInAppTree(pkg, logicalPackage, packageName) &&
-            !reliablyResolvable(pkg, packageName)) {
-            throw new Error(`${pkg.name} is trying to import from ${packageName} but that is not one of its explicit dependencies`);
+        if (!pkg.meta['auto-upgraded']) {
+            if (!pkg.meta['auto-upgraded'] &&
+                !appImportInAppTree(pkg, logicalPackage, packageName) &&
+                !reliablyResolvable(pkg, packageName)) {
+                throw new Error(`${pkg.name} is trying to import from ${packageName} but that is not one of its explicit dependencies`);
+            }
         }
         return request;
     }
-    locateActiveAddon(packageName) {
-        if (packageName === this.options.modulePrefix) {
-            // the app itself is something that addon's can classically resolve if they know it's name.
-            return {
-                root: this.options.appRoot,
-                canResolveFromFile: (0, path_1.resolve)(this.packageCache.maybeMoved(this.packageCache.get(this.options.appRoot)).root, 'package.json'),
-            };
+    external(label, request, specifier) {
+        if (this.options.amdCompatibility === 'cjs') {
+            let filename = (0, virtual_content_1.virtualExternalCJSModule)(specifier);
+            return logTransition(label, request, request.virtualize(filename));
+        }
+        else if (this.options.amdCompatibility) {
+            let entry = this.options.amdCompatibility.es.find(entry => entry[0] === specifier || entry[0] + '/index' === specifier);
+            if (!entry && request.specifier === 'require') {
+                entry = ['require', ['default', 'has']];
+            }
+            if (!entry) {
+                throw new Error(`A module tried to resolve "${request.specifier}" and didn't find it (${label}).
+
+ - Maybe a dependency declaration is missing?
+ - Remember that v1 addons can only import non-Ember-addon NPM dependencies if they include ember-auto-import in their dependencies.
+ - If this dependency is available in the AMD loader (because someone manually called "define()" for it), you can configure a shim like:
+
+  amdCompatibility: {
+    es: [
+      ["${request.specifier}", ["default", "yourNamedExportsGoHere"]],
+    ]
+  }
+
+`);
+            }
+            let filename = (0, virtual_content_1.virtualExternalESModule)(specifier, entry[1]);
+            return logTransition(label, request, request.virtualize(filename));
         }
-        for (let engine of this.options.engines) {
-            for (let addon of engine.activeAddons) {
-                if (addon.name === packageName) {
-                    return addon;
-                }
-            }
+        else {
+            throw new Error(`Embroider's amdCompatibility option is disabled, but something tried to use it to access "${request.specifier}"`);
         }
     }
-    async fallbackResolve(request) {
-        if (request.resolvedTo) {
-            throw new Error('Build tool bug detected! Fallback resolve should never see an already-resolved request.');
-        }
+    fallbackResolve(request) {
+        var _a, _b, _c;
         if (request.specifier === '@embroider/macros') {
             // the macros package is always handled directly within babel (not
             // necessarily as a real resolvable package), so we should not mess with it.
@@ -876,124 +751,108 @@ class Resolver {
             // why we need to know about it.
             return logTransition('fallback early exit', request);
         }
-        if (compatPattern.test(request.specifier)) {
+        let { specifier, fromFile } = request;
+        if (compatPattern.test(specifier)) {
             // Some kinds of compat requests get rewritten into other things
-            // deterministically. For example, "@embroider/virtual/helpers/whatever"
+            // deterministically. For example, "#embroider_compat/helpers/whatever"
             // means only "the-current-engine/helpers/whatever", and if that doesn't
             // actually exist it's that path that will show up as a missing import.
             //
             // But others have an ambiguous meaning. For example,
-            // @embroider/virtual/components/whatever can mean several different
+            // #embroider_compat/components/whatever can mean several different
             // things. If we're unable to find any of them, the actual
-            // "@embroider/virtual" request will fall through all the way to here.
+            // "#embroider_compat" request will fall through all the way to here.
             //
             // In that case, we don't want to externalize that failure. We know it's
             // not a classic runtime thing. It's better to let it be a build error
             // here.
             return request;
         }
-        let pkg = this.packageCache.ownerOfFile(request.fromFile);
-        if (pkg) {
-            ({ pkg, request } = this.restoreRehomedRequest(pkg, request));
+        if (fromFile.endsWith('moved-package-target.js')) {
+            if (!((_a = request.meta) === null || _a === void 0 ? void 0 : _a.resolvedWithinPackage)) {
+                throw new Error(`bug: embroider resolver's meta is not propagating`);
+            }
+            fromFile = (0, path_1.resolve)((_b = request.meta) === null || _b === void 0 ? void 0 : _b.resolvedWithinPackage, 'package.json');
         }
-        if (!(pkg === null || pkg === void 0 ? void 0 : pkg.isV2Ember())) {
-            // this request is coming from a file that appears to be owned by no ember
-            // package. We offer one fallback behavior for such files. They're allowed
-            // to resolve from the app's namespace.
-            //
-            // This makes it possible for integrations like vite to leave references
-            // to the app in their pre-bundled dependencies, which will end up in an
-            // arbitrary cache that is not inside any particular package.
-            let description = pkg ? 'non-ember package' : 'unowned module';
-            let packageName = (0, shared_internals_1.packageName)(request.specifier);
-            if (packageName === this.options.modulePrefix) {
-                return logTransition(`fallbackResolver: ${description} resolved app namespace`, request, request.rehome(this.packageCache.maybeMoved(this.packageCache.get(this.options.appRoot)).root));
+        let pkg = this.packageCache.ownerOfFile(fromFile);
+        if (!pkg) {
+            return logTransition('no identifiable owningPackage', request);
+        }
+        // if we rehomed this request to its un-rewritten location in order to try
+        // to do the defaultResolve from there, now we refer back to the rewritten
+        // location because that's what we want to use when asking things like
+        // isV2Ember()
+        let movedPkg = this.packageCache.maybeMoved(pkg);
+        if (movedPkg !== pkg) {
+            if (!((_c = request.meta) === null || _c === void 0 ? void 0 : _c.wasMovedTo)) {
+                throw new Error(`bug: embroider resolver's meta is not propagating`);
             }
-            return logTransition(`fallbackResolver: ${description}`, request);
+            fromFile = request.meta.wasMovedTo;
+            pkg = movedPkg;
         }
-        let packageName = (0, shared_internals_1.packageName)(request.specifier);
+        if (!pkg.isV2Ember()) {
+            return logTransition('fallbackResolve: not in an ember package', request);
+        }
+        let packageName = (0, shared_internals_1.packageName)(specifier);
         if (!packageName) {
             // this is a relative import
-            return this.relativeFallbackResolve(pkg, request);
+            let withinEngine = this.engineConfig(pkg.name);
+            if (withinEngine) {
+                // it's a relative import inside an engine (which also means app), which
+                // means we may need to satisfy the request via app tree merging.
+                let appJSMatch = this.searchAppTree(request, withinEngine, (0, shared_internals_2.explicitRelative)(pkg.root, (0, path_1.resolve)((0, path_1.dirname)(fromFile), specifier)));
+                if (appJSMatch) {
+                    return logTransition('fallbackResolve: relative appJsMatch', request, appJSMatch);
+                }
+                else {
+                    return logTransition('fallbackResolve: relative appJs search failure', request);
+                }
+            }
+            else {
+                // nothing else to do for relative imports
+                return logTransition('fallbackResolve: relative failure', request);
+            }
         }
-        if (pkg.needsLooseResolving()) {
-            let activeAddon = this.maybeFallbackToActiveAddon(request, packageName);
-            if (activeAddon) {
-                return activeAddon;
+        // auto-upgraded packages can fall back to the set of known active addons
+        if (pkg.meta['auto-upgraded'] && this.options.activeAddons[packageName]) {
+            const rehomed = this.resolveWithinMovedPackage(request, this.packageCache.get(this.options.activeAddons[packageName]));
+            if (rehomed !== request) {
+                return logTransition(`activeAddons`, request, rehomed);
             }
         }
-        let logicalLocation = this.reverseSearchAppTree(pkg, request.fromFile);
+        let logicalLocation = this.reverseSearchAppTree(pkg, fromFile);
         if (logicalLocation) {
             // the requesting file is in an addon's appTree. We didn't succeed in
             // resolving this (non-relative) request from inside the actual addon, so
             // next try to resolve it from the corresponding logical location in the
             // app.
-            return logTransition('fallbackResolve: retry from logical home of app-js file', request, 
-            // it might look more precise to rehome into logicalLocation.inAppName
-            // rather than package.json. But that logical location may not actually
-            // exist, and some systems (including node's require.resolve) will be
-            // mad about trying to resolve from notional paths that don't really
-            // exist.
-            request.rehome((0, path_1.resolve)(logicalLocation.owningEngine.root, 'package.json')));
+            return logTransition('fallbackResolve: retry from logical home of app-js file', request, request.rehome((0, path_1.resolve)(logicalLocation.owningEngine.root, logicalLocation.inAppName)));
         }
         let targetingEngine = this.engineConfig(packageName);
         if (targetingEngine) {
-            let appJSMatch = await this.searchAppTree(request, targetingEngine, request.specifier.replace(packageName, '.'));
+            let appJSMatch = this.searchAppTree(request, targetingEngine, specifier.replace(packageName, '.'));
             if (appJSMatch) {
                 return logTransition('fallbackResolve: non-relative appJsMatch', request, appJSMatch);
             }
         }
-        // this is falling through with the original specifier which was
-        // non-resolvable, which will presumably cause a static build error in stage3.
-        return logTransition('fallbackResolve final exit', request);
-    }
-    restoreRehomedRequest(pkg, request) {
-        var _a;
-        // meta.originalFromFile gets set when we want to try to rehome a request
-        // but then come back to the original location here in the fallback when the
-        // rehomed request fails
-        let movedPkg = this.packageCache.maybeMoved(pkg);
-        if (movedPkg !== pkg) {
-            let originalFromFile = (_a = request.meta) === null || _a === void 0 ? void 0 : _a.originalFromFile;
-            if (typeof originalFromFile !== 'string') {
-                throw new Error(`bug: embroider resolver's meta is not propagating`);
-            }
-            request = request.rehome(originalFromFile);
-            pkg = movedPkg;
-        }
-        return { pkg, request };
-    }
-    async relativeFallbackResolve(pkg, request) {
-        let withinEngine = this.engineConfig(pkg.name);
-        if (withinEngine) {
-            // it's a relative import inside an engine (which also means app), which
-            // means we may need to satisfy the request via app tree merging.
-            let logicalName = engineRelativeName(pkg, (0, path_1.resolve)((0, path_1.dirname)(request.fromFile), request.specifier));
-            if (!logicalName) {
-                return logTransition('fallbackResolve: relative failure because this file is not externally accessible', request);
-            }
-            let appJSMatch = await this.searchAppTree(request, withinEngine, logicalName);
-            if (appJSMatch) {
-                return logTransition('fallbackResolve: relative appJsMatch', request, appJSMatch);
-            }
-            else {
-                return logTransition('fallbackResolve: relative appJs search failure', request);
-            }
+        if (pkg.meta['auto-upgraded']) {
+            // auto-upgraded packages can fall back to attempting to find dependencies at
+            // runtime. Native v2 packages can only get this behavior in the
+            // isExplicitlyExternal case above because they need to explicitly ask for
+            // externals.
+            return this.external('v1 catch-all fallback', request, specifier);
         }
         else {
-            // nothing else to do for relative imports
-            return logTransition('fallbackResolve: relative failure', request);
-        }
-    }
-    maybeFallbackToActiveAddon(request, requestedPackageName) {
-        // auto-upgraded packages can fall back to the set of known active addons
-        let addon = this.locateActiveAddon(requestedPackageName);
-        if (addon) {
-            const rehomed = request.rehome(addon.canResolveFromFile);
-            if (rehomed !== request) {
-                return logTransition(`activeAddons`, request, rehomed);
+            // native v2 packages don't automatically externalize *everything* the way
+            // auto-upgraded packages do, but they still externalize known and approved
+            // ember virtual packages (like @ember/component)
+            if (shared_internals_1.emberVirtualPackages.has(packageName)) {
+                return this.external('emberVirtualPackages', request, specifier);
             }
         }
+        // this is falling through with the original specifier which was
+        // non-resolvable, which will presumably cause a static build error in stage3.
+        return logTransition('fallbackResolve final exit', request);
     }
     getEntryFromMergeMap(inEngineSpecifier, root) {
         var _a;
@@ -1015,22 +874,26 @@ class Resolver {
             }
         }
     }
-    async searchAppTree(request, engine, inEngineSpecifier) {
+    searchAppTree(request, engine, inEngineSpecifier) {
         let matched = this.getEntryFromMergeMap(inEngineSpecifier, engine.root);
         switch (matched === null || matched === void 0 ? void 0 : matched.entry.type) {
             case undefined:
                 return undefined;
             case 'app-only':
-                return request.alias(matched.entry['app-js'].specifier).rehome(matched.entry['app-js'].fromFile);
+                return request
+                    .alias(matched.entry['app-js'].localPath)
+                    .rehome((0, path_1.resolve)(matched.entry['app-js'].packageRoot, 'package.json'));
             case 'fastboot-only':
-                return request.alias(matched.entry['fastboot-js'].specifier).rehome(matched.entry['fastboot-js'].fromFile);
+                return request
+                    .alias(matched.entry['fastboot-js'].localPath)
+                    .rehome((0, path_1.resolve)(matched.entry['fastboot-js'].packageRoot, 'package.json'));
             case 'both':
-                let foundAppJS = await this.resolve(request.alias(matched.entry['app-js'].specifier).rehome(matched.entry['app-js'].fromFile));
-                if (foundAppJS.type !== 'found') {
+                let foundAppJS = this.nodeResolve(matched.entry['app-js'].localPath, (0, path_1.resolve)(matched.entry['app-js'].packageRoot, 'package.json'));
+                if (foundAppJS.type !== 'real') {
                     throw new Error(`${matched.entry['app-js'].fromPackageName} declared ${inEngineSpecifier} in packageJSON.ember-addon.app-js, but that module does not exist`);
                 }
-                let { names } = (0, describe_exports_1.describeExports)((0, fs_1.readFileSync)(foundAppJS.filename, 'utf8'), { configFile: false });
-                return request.virtualize(fastbootSwitch(matched.matched, (0, path_1.resolve)(engine.root, 'package.json'), names));
+                let { names } = (0, describe_exports_1.describeExports)((0, fs_1.readFileSync)(foundAppJS.filename, 'utf8'), {});
+                return request.virtualize((0, virtual_content_1.fastbootSwitch)(matched.matched, (0, path_1.resolve)(engine.root, 'package.json'), names));
         }
     }
     // check whether the given file with the given owningPackage is an addon's
@@ -1064,10 +927,14 @@ class Resolver {
         if (engineConfig) {
             // we're directly inside an engine, so we're potentially resolvable as a
             // global component
-            let inAppName = engineRelativeName(owningPackage, filename);
-            if (inAppName) {
-                return this.tryReverseComponent(engineConfig.packageName, inAppName);
-            }
+            // this kind of mapping is not true in general for all packages, but it
+            // *is* true for all classical engines (which includes apps) since they
+            // don't support package.json `exports`. As for a future v2 engine or app:
+            // this whole method is only relevant for implementing packageRules, which
+            // should only be for classic stuff. v2 packages should do the right
+            // things from the beginning and not need packageRules about themselves.
+            let inAppName = (0, shared_internals_2.explicitRelative)(engineConfig.root, filename);
+            return this.tryReverseComponent(engineConfig.packageName, inAppName);
         }
         let engineInfo = this.reverseSearchAppTree(owningPackage, filename);
         if (engineInfo) {
@@ -1094,6 +961,9 @@ __decorate([
 __decorate([
     (0, typescript_memoize_1.Memoize)()
 ], Resolver.prototype, "emberVersionSupportsSeparateTemplates", null);
+function isExplicitlyExternal(specifier, fromPkg) {
+    return Boolean(fromPkg.isV2Addon() && fromPkg.meta['externals'] && fromPkg.meta['externals'].includes(specifier));
+}
 // we don't want to allow things that resolve only by accident that are likely
 // to break in other setups. For example: import your dependencies'
 // dependencies, or importing your own name from within a monorepo (which will
@@ -1115,33 +985,4 @@ function reliablyResolvable(pkg, packageName) {
 function appImportInAppTree(inPackage, inLogicalPackage, importedPackageName) {
     return inPackage !== inLogicalPackage && importedPackageName === inLogicalPackage.name;
 }
-function engineRelativeName(pkg, filename) {
-    let outsideName = (0, reverse_exports_1.externalName)(pkg.packageJSON, (0, shared_internals_2.explicitRelative)(pkg.root, filename));
-    if (outsideName) {
-        return '.' + outsideName.slice(pkg.name.length);
-    }
-}
-const fastbootSwitchSuffix = '/embroider_fastboot_switch';
-function fastbootSwitch(specifier, fromFile, names) {
-    let filename = `${(0, path_1.resolve)((0, path_1.dirname)(fromFile), specifier)}${fastbootSwitchSuffix}`;
-    let virtualSpecifier;
-    if (names.size > 0) {
-        virtualSpecifier = `${filename}?names=${[...names].join(',')}`;
-    }
-    else {
-        virtualSpecifier = filename;
-    }
-    return {
-        type: 'fastboot-switch',
-        specifier: virtualSpecifier,
-        names,
-        hasDefaultExport: 'x',
-    };
-}
-function decodeFastbootSwitch(filename) {
-    let index = filename.indexOf(fastbootSwitchSuffix);
-    if (index >= 0) {
-        return { filename: filename.slice(0, index) };
-    }
-}
 //# sourceMappingURL=module-resolver.js.map