/* =============================================================================
 * design_structure_ford_calc.ts
 * 세월교 명세 계산 — 월류 폭 ↔ 월류 높이 연동(PLAN 52-4).
 *
 * 높이 = 담당 유역 설계유량을 그 월류 폭으로 넘기는 필요 수심(Manning 개수로 · `fordSection` 그대로).
 * 근거: Manning 공식 `resources/knowledge/technical_info/01_임도/03_계산정보/통수단면.md:23~33`
 *   (KDS 44 40 00 2.7.1~2.7.2) · 조도계수 0.017 = 같은 파일 :59(콘크리트 수로 보통 · 울진 물넘이) ·
 *   경사 10 % = 실무 수리계산서 역산값(`config_frontend.FORD_SLOPE` · 지식DB 수치 없음).
 * 폭을 바꾸면 높이 칸을 이 값으로 채움 · 사용자는 올려 적을 수 있고 이 값 아래로는 안 받음.
 * 높이는 저장되는 입력값 — 서버는 받은 높이로 노면을 내림(`B06_Section_Engine_Culvert._ford_set`) · 재계산 안 함.
 * 설계유량이 없으면 null = 손 입력.
 * ========================================================================== */

import { fordSection } from "../../B05_Profile/B05_Profile_UI_Drainage_Facility_Fields";

/** 월류 폭(m) → 필요 월류 높이(m) · 0.01 m 올림. 유량 · 폭이 없으면 null. */
export function fordHeightM(designFlowM3s: number | null, widthM: number): number | null {
  const section = fordSection(designFlowM3s, widthM);
  return section ? Math.ceil(section.depthM * 100 - 1e-9) / 100 : null;
}

/** 높이 빈 칸 안내. */
export function fordHeightHint(designFlowM3s: number | null, widthM: number): string {
  const need = fordHeightM(designFlowM3s, widthM);
  if (need !== null) return `필요 수심 ${need.toFixed(2)} 이상`;
  return designFlowM3s ? "월류 폭을 넣으면 셈" : "설계유량 없음 — 손 입력";
}