feat(일위대가실무): 329-3 엑셀 보기 창 — 읽기 전용 시트(일위대가 · 단가산출 탭) + 호표 목록(체크 · 찾기 · 맞춤) · 목록 누름 → 영역 강조 · 칸 누름 → 그 호표 · 고른 호표 한 번에 사전조합 + 결과 표 · 여는 자리 넷(올린 직후 · 엑셀로 보기 · 엑셀에서 보기 · 로직 추가 덧줄) · 늦게 불러옴

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XWh5wNNycMkbwMpACz1rte

M02_MasterTemplete/M02_MasterTemplete_Hopyo_Api.ts

@@ -5,6 +5,7 @@
  * ========================================================================== */
 
 import { API_BASE_URL } from "@config/config_frontend";
+import type { Workbook } from "../A00_Common/spreadsheet/spreadsheet";
 import { call, getActiveLayer, getActiveOwner, type Layer } from "./M02_MasterTemplete_Api_Fetch";
 import type { LaborRef } from "./M02_MasterTemplete_Labor_Calc";
 
@@ -34,6 +35,22 @@ export interface HopyoBrief {
   금액: Money;
   /** [들어감 수, 줄 수] */
   맞춤: [number, number];
+  /** 일위대가 시트 행 [시작, 끝](엑셀 1부터 · 329 · 옛 파일 없음) */
+  행?: [number, number];
+}
+
+/** 엑셀 보기 창 목록 한 줄 — 호표 · 단가산출 블록 행 범위 */
+export interface HopyoSpan {
+  번: number;
+  이름: string;
+  행: [number, number];
+}
+
+/** 엑셀 보기 창 격자(329) — 시트 「일위대가」 · 「단가산출」 */
+export interface HopyoGrid {
+  책: Workbook;
+  호표: HopyoSpan[];
+  단산: HopyoSpan[];
 }
 
 export interface HopyoView extends HopyoFile {
@@ -136,6 +153,10 @@ export const listHopyo = async (scope: HopyoScope): Promise<HopyoFile[]> =>
 export const readHopyo = (scope: HopyoScope, key: string): Promise<HopyoView> =>
   call(at(scope, `/hopyo/${enc(key)}`));
 
+/** 격자 — 없으면 404 「격자 없음 — 다시 올리면 보임」(옛 파일) */
+export const readHopyoGrid = (scope: HopyoScope, key: string): Promise<HopyoGrid> =>
+  call(at(scope, `/hopyo-grid/${enc(key)}`));
+
 export const readHopyoOne = (scope: HopyoScope, key: string, no: number): Promise<HopyoOne> =>
   call(at(scope, `/hopyo/${enc(key)}/${no}`));