Convert this pseudocode to working code

Convert the following pseudocode into idiomatic, working [Language] code: [Paste pseudocode]. Follow the logic precisely but use language-native patterns and idioms. Add type annotations if the language supports them, handle any edge cases the pseudocode implies but does not state explicitly, and include a brief docstring describing the function's purpose and parameters.