Dokümantasyon: JSDoc, Docstring, README

/**
 * Belirli bir tutar için indirim miktarını hesaplar.
 *
 * 1000 TL ve üzeri alımlar için %10 indirim uygulanır.
 * Negatif tutarlarda ValidationError fırlatılır.
 *
 * @param amount - İndirimsiz toplam tutar (TL).
 * @returns Hesaplanmış indirim miktarı (TL).
 * @throws {ValidationError} amount negatif olduğunda.
 *
 * @example
 * // Eşik üstü
 * calculateDiscount(1500); // 150
 *
 * @example
 * // Eşik altı
 * calculateDiscount(500); // 0
 *
 * @see {@link calculateFinalPrice}
 */
export function calculateDiscount(amount: number): number {
  if (amount < 0) {
    throw new ValidationError("Amount must be non-negative");
  }
  return amount >= 1000 ? amount * 0.1 : 0;
}