"""구조물도 식 풀이 — 서버가 부르는 **껍데기**. 계산은 여기 없음.

풀이는 화면이 쓰는 `B08_Quantity_Formula.ts` 한 벌을 Node 로 돌림(판정 Ⓐ, 2026-09-13 ·
명세 13장). 파이썬으로 다시 짜면 반올림이 1원에서 조용히 갈리므로 두 벌을 두지 않음.
B06 `B06_Section_Server_Calc_Prebuild.py` 와 같은 본(`common_util_node_bundle`).
"""

from __future__ import annotations

from pathlib import Path
from typing import Any

from common_util.common_util_node_bundle import run_bundle_json

ROOT = Path(__file__).resolve().parents[1]
BUNDLE = ROOT / "config" / "formula_node" / "B08_Quantity_Formula_Node.js"
_NPM_SCRIPT = "build:formula"


def evaluate_sheets(sheets: list[dict[str, Any]]) -> list[list[dict[str, Any]]] | None:
    """장 여러 벌을 한 번에 풂 — 줄마다 `amount`(반올림 뒤)·`raw`·`error`.

    Node 가 못 돌면 `None` — 값을 지어내지 않고 부르는 쪽이 「못 풂」으로 드러냄.
    """
    output = run_bundle_json(BUNDLE, _NPM_SCRIPT, {"sheets": sheets})
    if not isinstance(output, dict) or not isinstance(output.get("sheets"), list):
        return None
    return output["sheets"]