Code dokumentace s JSDoc/docstrings

Dokumentuj tento kód:\n\n**Kód:**\n```[JAZYK]\n[KÓD BEZ DOKUMENTACE]\n```\n\n**Documentation Style:**\n- JavaScript/TypeScript: JSDoc\n- Python: Google/NumPy docstrings\n- Java: Javadoc\n- PHP: PHPDoc\n\n**Include:**\n1. **Function/Class description**\n - What it does\n - When to use it\n\n2. **Parameters:**\n - @param name - type - description\n - Default values\n - Optional vs required\n\n3. **Returns:**\n - @returns type - description\n - Possible return values\n\n4. **Examples:**\n - @example with code\n - Common use cases\n\n5. **Throws/Exceptions:**\n - @throws ErrorType - when\n\n6. **Additional:**\n - @deprecated if relevant\n - @see for related functions\n - @since version\n\nJazyk: [JAZYK]. Style guide: [GUIDE].