Generate JSDoc / docstring comments

Add [JSDoc / Python docstrings / Go doc comments] to every exported or public function, class, and type in the following code: [Paste code]. For each item document its purpose in one sentence, describe all parameters with their types and expected values, describe the return value and its type, list any exceptions or errors that may be thrown, and include a short usage example where it adds meaningful clarity. Do not change any logic.