Merge remote-tracking branches 'origin/sub_laptop_2' and 'origin/sub_laptop_5' into main_laptop_1

A00_Common/group_workflow.ts

@@ -3,6 +3,8 @@
  * D 예정노선 · E 안정성평가 단계 묶음(요구 345 · PLAN 529-1) — B05~B09 틀(`createWorkflowLayout`)을
  *   단계 목록 · 아이콘 · 주소 인자로 그대로 씀. 빈 단계 = 틀 · 좌측 패널([?] [<] [>]) · 단계 막대만.
  *   페이지 길 = 각 폴더 `draft/<폴더>_Route.ts` · 본문이 생기면 그 폴더 페이지로 갈아 끼움.
+ *   떠남(560-4) = `beforeLeave` 가 true 일 때만 — 단계 아이콘 · [<] [>] 는 기다린 뒤 이동 ·
+ *   머리 메뉴 · 뒤로 가기는 같은 함수를 `setLeaveGuard` 로(false = 머묾).
  * ========================================================================== */
 
 import {
@@ -15,7 +17,7 @@ import {
 import { el, hideLoadingOverlay, showLoadingOverlay, showToast } from "@ui/ui_template_elements";
 import { t, type LocaleKey } from "@ui/ui_template_locale";
 import { createWorkflowLayout } from "@ui/ui_template_workflow_layout";
-import { navigateTo, type PageRenderer } from "./router";
+import { navigateTo, setLeaveGuard, type PageRenderer } from "./router";
 
 interface GroupFlow {
   routes: readonly RoutePath[];
@@ -55,11 +57,18 @@ export function groupFlowOf(
 export function mountGroupStep(
   root: HTMLElement,
   route: RoutePath,
-  parts: { mainContent?: HTMLElement; leftPanel?: HTMLElement } = {},
+  parts: {
+    mainContent?: HTMLElement;
+    leftPanel?: HTMLElement;
+    /** 떠나기 전 — 저장 등 · false = 머묾 */
+    beforeLeave?: () => Promise<boolean>;
+  } = {},
 ): void {
   const flow = FLOWS.find((f) => f.routes.includes(route));
   if (!flow) throw new Error(`단계 묶음 밖 주소: ${route}`);
   const active = flow.routes.indexOf(route);
+  const leave = parts.beforeLeave;
+  if (leave) setLeaveGuard(async () => !root.isConnected || (await leave()));
   const layout = createWorkflowLayout({
     title: t(flow.labels[active]),
     steps: flow.labels.map((key) => t(key)),
@@ -69,7 +78,10 @@ export function mountGroupStep(
     leftPanel: parts.leftPanel,
     mainContent:
       parts.mainContent ?? el("p", { className: "app-placeholder", text: t("DE_Step_Empty") }),
-    onStepClick: (_index, next) => navigateTo(next as RoutePath),
+    onStepClick: (_index, next) => {
+      if (!leave) return navigateTo(next as RoutePath);
+      void leave().then((ok) => ok && navigateTo(next as RoutePath));
+    },
   });
   root.append(layout.root);
 }