Document cursor pagination and capped totals

[javorosas]

Contexto

Prepara la documentación para anunciar el soporte opt-in de pagination=cursor
(ya mergeado en la API) y el capping de totales a 3,000 (totals_are_capped),
incluyendo la política de paginación por páginas (máximo 30 páginas). La doc se
escribe como si la política completa ya estuviera vigente; el correo de anuncio
definirá la fecha de aplicación.

Cambios

• Guía nueva de paginación (docs/guides/pagination.mdx, ES + EN):
  • Comparativa pagination=page vs pagination=cursor (cursor recomendado para listas grandes).
  • Parámetros pagination, limit, page, after, before y sus combinaciones válidas.
  • Formas de respuesta de ambos modos (previous_cursor, next_cursor, total_results, totals_are_capped).
  • Navegación secuencial con cursores y tope de 3,000 resultados.
• OpenAPI (ambos specs, openapi_v2.yaml y openapi_v2.en.yaml):
  • Nuevos parámetros compartidos SearchPagination, SearchAfter, SearchBefore en components.parameters.
  • $ref a esos parámetros en los 19 endpoints de búsqueda (catálogos, customers, invoices, organizations, products, receipts, retentions).
  • Campos previous_cursor, next_cursor y totals_are_capped en el schema compartido SearchResult.
• CHANGELOG.md: entrada de release para el anuncio.

Validación

• Ambos YAML parsean y los 57 $ref nuevos quedan dentro de listas parameters (0 fugas en security).
• git diff --check sin errores.