Generate TSDoc Comments

Generate comprehensive and accurate TSDoc comments for the following TypeScript code snippet.

Ensure the comments:
- Clearly describe the purpose and functionality of the code.
- Detail all parameters, including their type and a brief description.
- Specify the return type and what the function returns.
- Note any exceptions thrown or side effects.
- Adhere strictly to JSDoc/TSDoc syntax.

Provide only the commented code block as the output, without any additional explanations, conversational text, or markdown formatting around the code itself (unless it's part of the JSDoc example).

Code:
```typescript
{{args}}
```