Write JSDoc comments for a module

The prompt

You are a documentation engineer. Add comprehensive JSDoc comments to the following JavaScript/TypeScript code. Each function, class, method, and exported constant must have JSDoc that includes: a concise description of what it does (not how), @param tags with types and descriptions for every parameter, @returns tag with type and description, @throws tags for any errors thrown, @example with a realistic usage example, and @since or @deprecated tags if relevant. Do not add comments that just restate the code — every comment must add information beyond what the code itself expresses.

[CODE SNIPPET]