yeoman-environment 8.3.0 → 8.4.0

package/dist/store.d.ts

@@ -37,6 +37,10 @@ export type StoreLookupGeneratorMeta = FoundGenerator & ((StoreGeneratorMeta & {
 export type StoreGeneratorMeta = Omit<GeneratorMeta, 'importGenerator' | 'instantiate' | 'instantiateHelp'> & {
     /** Require the module `require(meta.resolved)`, throws if the module cannot be required synchronously. */
     requireModule?: () => unknown;
+    /** Require the sibling module of the name, like `command.ts` next to `index.ts`, `undefined` if missing. */
+    requireSibling?: (name: string) => unknown;
+    /** Import the sibling module of the name, like `requireSibling` for a module that can not be required. */
+    importSibling?: (name: string) => Promise<unknown>;
     importGenerator: <G extends BaseGenerator = BaseGenerator>(options?: StoreEnvironmentOptions) => Promise<GetGeneratorConstructor<G> & BaseGeneratorConstructorMeta> | (GetGeneratorConstructor<G> & BaseGeneratorConstructorMeta);
     instantiate: <G extends BaseGenerator = BaseGenerator>(arguments_?: string[], options?: any, environmentOptions?: StoreEnvironmentOptions) => Promise<G>;
     instantiateHelp: <G extends BaseGenerator = BaseGenerator>(options?: StoreEnvironmentOptions) => Promise<G>;

package/dist/store.js

@@ -7,9 +7,9 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     return path;
 };
 import { pathToFileURL } from 'node:url';
-import { basename, extname, join, relative } from 'node:path';
+import { basename, dirname, extname, join, relative } from 'node:path';
 import { createRequire } from 'node:module';
-import { readFileSync, realpathSync } from 'node:fs';
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
 import { namespaceFromPackageName, toNamespace } from '@yeoman/namespace';
 import createDebug from 'debug';
 import { lookupGeneratorsSync } from "./generator-lookup.js";
@@ -20,6 +20,38 @@ const require = createRequire(import.meta.url);
 const operationsKey = Symbol('operations');
 const setOperations = (meta, operations) => Object.defineProperty(meta, operationsKey, { value: operations });
 const getOperations = (meta) => meta[operationsKey];
+/** The functions loading the modules next to a generator module, with its extension. */
+const createSiblingFunctions = (resolved) => {
+    if (typeof resolved !== 'string' || !extname(resolved)) {
+        return {};
+    }
+    const folder = dirname(resolved);
+    const extension = extname(resolved);
+    const siblingPath = (name) => {
+        const filePath = join(folder, `${name}${extension}`);
+        return existsSync(filePath) ? filePath : undefined;
+    };
+    const requireSibling = (name) => {
+        const filePath = siblingPath(name);
+        return filePath ? require(filePath) : undefined;
+    };
+    const importSibling = async (name) => {
+        const filePath = siblingPath(name);
+        if (!filePath) {
+            return undefined;
+        }
+        try {
+            return require(filePath);
+        }
+        catch (error) {
+            if (error.code === 'ERR_REQUIRE_ESM' || error.code === 'ERR_REQUIRE_ASYNC_MODULE') {
+                return import(__rewriteRelativeImportExtension(pathToFileURL(filePath).href));
+            }
+            throw error;
+        }
+    };
+    return { requireSibling, importSibling };
+};
 /** The namespace of a generator package, like `@scope/foo` for `@scope/generator-foo`, undefined for another name. */
 const namespaceOfPackage = (packageName) => {
     try {
@@ -222,6 +254,7 @@ export default class Store {
         generatorMeta = {
             ...meta,
             ...this.createMetaFunctions(operations, () => this.environment),
+            ...createSiblingFunctions(meta.resolved),
             requireModule,
             importModule,
             getPackageJson,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yeoman-environment",
-  "version": "8.3.0",
+  "version": "8.4.0",
   "description": "Handles the lifecyle and bootstrapping of generators in a specific environment",
   "keywords": [
     "development",