Function pythonModuleFiles

src/resolution/name-matcher.ts:696–713

* The repo files a Python module path can name from `fromFile`. Relative * paths (`..settings`) resolve exactly; absolute ones match a file path * suffix, so a source root (`src/`) still resolves — and two files sharing * the tail (`x/settings.py`, `y/settings.py`) both come back.

(dotted: string, fromFile: string, context: ResolutionContext)

 * the tail (`x/settings.py`, `y/settings.py`) both come back.
 */
function pythonModuleFiles(dotted: string, fromFile: string, context: ResolutionContext): string[] {
  const dots = dotted.match(/^\.+/)?.[0].length ?? 0;
  const parts = dotted.slice(dots).split('.').filter(Boolean);
  if (!parts.length) return [];
  let dir = '';
  if (dots) {
    dir = path.posix.dirname(fromFile.replace(/\\/g, '/'));
    for (let i = 1; i < dots; i++) dir = path.posix.dirname(dir);
    if (dir === '.') dir = '';
  }
  const rel = [dir, ...parts].filter(Boolean).join('/');
  const matches = (file: string, want: string) => dots ? file === want : file === want || file.endsWith(`/${want}`);
  const last = parts[parts.length - 1]!;
  return [
    ...context.getNodesByName(`${last}.py`), ...context.getNodesByName(`${last}.pyi`), ...context.getNodesByName('__init__.py'),
  ].filter(n => n.kind === 'file' && (matches(n.filePath, `${rel}.py`) || matches(n.filePath, `${rel}.pyi`) || matches(n.filePath, `${rel}/__init__.py`)))
    .map(n => n.filePath);
}

/**
 * How `filePath` spells the module `moduleFile`: `aliases` import exactly that