Have you played La Mulana 1 +2 or Environmental Station Alpha? Those are some of the best games ever made imo and are puzzle metroidvanias. Puzzles in metroidvanias can often double as "secrets" which really makes things interesting- especially when they involve lore, world structure, or map knowledge as a part of the the puzzle.