@ihabdevteam/core 0.441.0 → 0.443.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/dist/components.cjs.js +190 -190
  3. package/dist/components.esm.css +2 -2
  4. package/dist/hooks.cjs.js +5 -5
  5. package/dist/i18n.cjs.js +1 -1
  6. package/dist/ihabdevteam-core.cjs.js +186 -186
  7. package/dist/ihabdevteam-core.d.ts +296 -1
  8. package/dist/packages/core/src/components/ErrorBoundary.d.ts +55 -0
  9. package/dist/packages/core/src/components/ErrorBoundary.js +52 -0
  10. package/dist/packages/core/src/components/KeepScreenAwake.d.ts +9 -0
  11. package/dist/packages/core/src/components/KeepScreenAwake.js +12 -0
  12. package/dist/packages/core/src/components/MarkIcon.css +12 -0
  13. package/dist/packages/core/src/components/MarkIcon.d.ts +20 -0
  14. package/dist/packages/core/src/components/MarkIcon.js +18 -0
  15. package/dist/packages/core/src/components/PagePopup.d.ts +43 -0
  16. package/dist/packages/core/src/components/PagePopup.js +71 -0
  17. package/dist/packages/core/src/components/Popup/ListPopup.js +3 -1
  18. package/dist/packages/core/src/components/Popup/Popup.js +2 -1
  19. package/dist/packages/core/src/components/Popup/useDiscardGuard.d.ts +26 -0
  20. package/dist/packages/core/src/components/Popup/useDiscardGuard.js +28 -0
  21. package/dist/packages/core/src/components/ScoreMarkCounts.css +9 -0
  22. package/dist/packages/core/src/components/ScoreMarkCounts.d.ts +19 -0
  23. package/dist/packages/core/src/components/ScoreMarkCounts.js +16 -0
  24. package/dist/packages/core/src/components.d.ts +12 -2
  25. package/dist/packages/core/src/components.js +8 -1
  26. package/dist/packages/core/src/hooks/useClosingDelay.d.ts +12 -0
  27. package/dist/packages/core/src/hooks/useClosingDelay.js +30 -0
  28. package/dist/packages/core/src/hooks/useOnline.d.ts +9 -0
  29. package/dist/packages/core/src/hooks/useOnline.js +23 -0
  30. package/dist/packages/core/src/hooks/useOutsideClose.d.ts +11 -0
  31. package/dist/packages/core/src/hooks/useOutsideClose.js +23 -0
  32. package/dist/packages/core/src/hooks/usePageSizeOptions.d.ts +19 -0
  33. package/dist/packages/core/src/hooks/usePageSizeOptions.js +25 -0
  34. package/dist/packages/core/src/hooks/useSaveOnHide.d.ts +14 -0
  35. package/dist/packages/core/src/hooks/useSaveOnHide.js +32 -0
  36. package/dist/packages/core/src/hooks/useScreenWakeLock.d.ts +12 -0
  37. package/dist/packages/core/src/hooks/useScreenWakeLock.js +53 -0
  38. package/dist/packages/core/src/hooks.d.ts +6 -0
  39. package/dist/packages/core/src/hooks.js +7 -0
  40. package/dist/packages/core/src/utils/kstDateTime.d.ts +21 -0
  41. package/dist/packages/core/src/utils/kstDateTime.js +38 -0
  42. package/dist/packages/core/src/utils/popupTiming.d.ts +7 -0
  43. package/dist/packages/core/src/utils/popupTiming.js +7 -0
  44. package/dist/packages/core/src/utils.d.ts +2 -0
  45. package/dist/packages/core/src/utils.js +1 -0
  46. package/dist/packages/core/src/version.d.ts +1 -1
  47. package/dist/packages/core/src/version.js +1 -1
  48. package/dist/utils.cjs.js +166 -166
  49. package/package.json +1 -1
@@ -1,9 +1,11 @@
1
+ import { Component } from 'react';
1
2
  import { ComponentType } from 'react';
2
3
  import { Context } from 'react';
3
4
  import { CSSProperties } from 'react';
4
5
  import { Dispatch } from 'react';
5
6
  import { DragEvent as DragEvent_2 } from 'react';
6
7
  import type { ElementType } from 'react';
8
+ import { ErrorInfo } from 'react';
7
9
  import { FC } from 'react';
8
10
  import { FocusEvent as FocusEvent_2 } from 'react';
9
11
  import { ForwardRefExoticComponent } from 'react';
@@ -2225,7 +2227,7 @@ export declare function copyText(text: string): Promise<boolean>;
2225
2227
  *
2226
2228
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
2227
2229
  */
2228
- export declare const CORE_VERSION = "0.441.0";
2230
+ export declare const CORE_VERSION = "0.443.0";
2229
2231
 
2230
2232
  /** @public */
2231
2233
  declare const coreDefault: Record<string, unknown>;
@@ -2541,6 +2543,9 @@ export declare const DEFAULT_LOCALE = "ko";
2541
2543
 
2542
2544
  export declare const DEFAULT_NOISE_SETTINGS: CoreNoiseSettings;
2543
2545
 
2546
+ /** @public 목록 쪽당 개수의 기본값 — 말귀 회원앱 목록들이 쓰던 넷 */
2547
+ export declare const DEFAULT_PAGE_SIZES: readonly [10, 25, 50, 100];
2548
+
2544
2549
  /** @public */
2545
2550
  export declare function deriveNoiseContexts(trainingData: Record<string, unknown> | null | undefined): NoiseContext_2[];
2546
2551
 
@@ -2888,6 +2893,58 @@ export declare interface EmptyStateProps {
2888
2893
  */
2889
2894
  export declare function ensureTrainingDataLoaded(timeout?: number): Promise<boolean>;
2890
2895
 
2896
+ /**
2897
+ * **오류 울타리** — 아래 화면이 그리다 넘어지면 잡아서 넘어진 화면을 세운다(말귀 청 (437) ㉴ — 말귀 앱 · 어드민 두 벌을 하나로, 2026-11-13).
2898
+ *
2899
+ * · **운영에서도 남긴다** — `console.error(error, '[ErrorBoundary]', 줄기)` 로. 앱의 오류 보고가 `console.error` 를 가로채 보낸다.
2900
+ * `Error` 를 **첫 인자로** 준다 — 문자열이 앞이면 보고가 새 `Error` 를 만들어 줄기(스택)가 사라진다.
2901
+ * · `resetKeys` 가 바뀌면 오류를 푼다(쪽을 옮기면 빠져나올 수 있게).
2902
+ * · 낡은 묶음 오류(`isChunkLoadError`)면 `staleChunk` 를 참으로 넘긴다 — 되살리기가 아니라 새로고침을 권할 자리다.
2903
+ * · 넘어진 화면의 문구 · 모양 · 개발용 다시 그리기는 앱이 넘긴다(`fallback` · `registerHealth`).
2904
+ * @public
2905
+ */
2906
+ export declare class ErrorBoundary extends Component<ErrorBoundaryProps, State> {
2907
+ state: State;
2908
+ private releaseHealth?;
2909
+ static getDerivedStateFromError(error: Error): State;
2910
+ componentDidCatch(error: Error, info: ErrorInfo): void;
2911
+ componentDidMount(): void;
2912
+ componentWillUnmount(): void;
2913
+ componentDidUpdate(prevProps: ErrorBoundaryProps): void;
2914
+ render(): ReactNode;
2915
+ }
2916
+
2917
+ /** @public */
2918
+ export declare interface ErrorBoundaryProps {
2919
+ children: ReactNode;
2920
+ /** 넘어진 화면 — 문구 · 모양은 앱 몫이다. 안 주면 아무것도 안 그린다 */
2921
+ fallback?: (p: ErrorFallbackProps) => ReactNode;
2922
+ onError?: (error: Error, info: ErrorInfo) => void;
2923
+ /**
2924
+ * 이 값들이 바뀌면 오류를 푼다 — 보통 지금 쪽의 열쇠를 넘긴다. 울타리가 쪽 전환보다 바깥에 있으면 쪽을 바꿔도 같은 울타리가
2925
+ * 남아 오류 화면에 붙박이고, 머리 · 바닥 내비만 눌리는 채 빠져나갈 길이 새로고침뿐이 된다.
2926
+ */
2927
+ resetKeys?: readonly unknown[];
2928
+ /** 새로고침을 바꿔 끼운다 — 시험이 jsdom 의 `location.reload` 를 못 부르므로 */
2929
+ reload?: () => void;
2930
+ /**
2931
+ * 개발 중 고쳐 끼우기(HMR)가 왔을 때 '이 울타리가 오류 화면인가' 를 알릴 자리 — 앱의 개발용 손을 넘긴다.
2932
+ * 받은 함수를 부르면 지금 오류 화면인지 답하고, 돌려준 함수는 떼어 낼 때 부른다.
2933
+ */
2934
+ registerHealth?: (isBroken: () => boolean) => () => void;
2935
+ }
2936
+
2937
+ /** @public 넘어진 화면을 그릴 때 받는 것 */
2938
+ export declare interface ErrorFallbackProps {
2939
+ error?: Error;
2940
+ /** 다시 그려 본다 — 일시적인 렌더 오류는 이것으로 풀리는 수가 많다 */
2941
+ retry: () => void;
2942
+ /** 쪽을 새로 고친다 — 낡은 묶음(배포 뒤 옛 조각) 오류는 되살려도 같은 오류가 다시 난다 */
2943
+ reload: () => void;
2944
+ /** 낡은 묶음 오류인가 — 참이면 `reload` 를 권한다 */
2945
+ staleChunk: boolean;
2946
+ }
2947
+
2891
2948
  export declare function ErrorState({ message, hint, icon, onRetry, retryLabel, className }: ErrorStateProps): JSX.Element;
2892
2949
 
2893
2950
  /** @public
@@ -4507,6 +4564,30 @@ export declare const JONGSEONG: readonly ["", "ㄱ", "ㄲ", "ㄳ", "ㄴ", "ㄵ",
4507
4564
 
4508
4565
  export declare const JUNGSEONG: readonly ["ㅏ", "ㅐ", "ㅑ", "ㅒ", "ㅓ", "ㅔ", "ㅕ", "ㅖ", "ㅗ", "ㅘ", "ㅙ", "ㅚ", "ㅛ", "ㅜ", "ㅝ", "ㅞ", "ㅟ", "ㅠ", "ㅡ", "ㅢ", "ㅣ"];
4509
4566
 
4567
+ /**
4568
+ * **감싼 것이 떠 있는 동안 폰 화면이 꺼지지 않게 한다** — 자리를 차지하지 않는다(말귀 청 (437) ㉲).
4569
+ * 훈련 창을 띄우는 길목을 이것으로 감싼다. 켜고 끄는 조건이 따로 있으면 `useScreenWakeLock(active)` 를 바로 쓴다.
4570
+ * @public
4571
+ */
4572
+ export declare function KeepScreenAwake({ children }: {
4573
+ children: ReactNode;
4574
+ }): JSX.Element;
4575
+
4576
+ /** @public 그 순간의 한국 시각을 칸으로 — 기본은 지금. 두 자리로 채운다 */
4577
+ export declare function kstNowParts(now?: Date): KstParts;
4578
+
4579
+ /** @public 연 · 월 · 일 · 시 · 분 칸(한국 시각) */
4580
+ export declare interface KstParts {
4581
+ year: string;
4582
+ month: string;
4583
+ day: string;
4584
+ hour: string;
4585
+ minute: string;
4586
+ }
4587
+
4588
+ /** @public 칸(한국 시각)이 가리키는 순간. 못 읽으면 Invalid Date */
4589
+ export declare function kstPartsAt(p: KstParts): Date;
4590
+
4510
4591
  /**
4511
4592
  * KST 달력 날짜(연, 0부터 세는 월, 일)의 **00:00 KST 순간.** 일·월은 넘쳐도 된다(`Date.UTC` 처럼 — 32일은 다음 달 1일).
4512
4593
  * 서버에 기간을 물을 때(`toISOString()`) 기기 시간대가 아니라 KST 의 하루로 자르려고 쓴다.
@@ -4515,6 +4596,16 @@ export declare const JUNGSEONG: readonly ["ㅏ", "ㅐ", "ㅑ", "ㅒ", "ㅓ", "
4515
4596
  */
4516
4597
  export declare function kstStartOfDay(year: number, month0: number, day: number): Date;
4517
4598
 
4599
+ /**
4600
+ * **화면이 고른 한국 시각(벽시계)을 서버가 아는 순간으로, 또 그 반대로**(말귀 청 (437) ㉳ⓒ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
4601
+ *
4602
+ * `timestamptz` 칸에 시간대 표기가 없는 문자열(`2026-09-06T12:55:00`)을 보내면 서버가 UTC 로 읽어 **9시간이 밀린다**
4603
+ * (말귀 실측: 12:55 → 21:55, 저녁 것은 날짜까지 하루). 기기 시간대가 아니라 **한국 시각**으로 읽는다 — 뉴욕 기기에서
4604
+ * 12:55 를 골라도 KST 12:55 다. 한국은 서머타임이 없어 +09:00 한 값이다. KST 날짜 셈의 다른 식구는 `utils/date.ts`.
4605
+ */
4606
+ /** @public `YYYY-MM-DD` + `HH:mm`(한국 시각) → `Z` 붙은 ISO. 못 읽을 값(2월 31일 · 25시 …)이면 `null` */
4607
+ export declare function kstToIso(date: string, time: string): string | null;
4608
+
4518
4609
  /**
4519
4610
  * {@link cellKey} 로 만든 칸 낱말에서 동형어 번호를 뗀 보이는 글자 — `배#2 / 패` → `배 / 패`. 번호가 없으면 그대로.
4520
4611
  *
@@ -5064,6 +5155,26 @@ export declare const MARK_VARIANT: Record<ScoreMark, 'main' | 'warn' | 'danger'>
5064
5155
  */
5065
5156
  export declare function markAfterClick(current: ScoreMark | null, clicked: ScoreMark): ScoreMark | null;
5066
5157
 
5158
+ /**
5159
+ * **평가 표시(○ △ ✕) — 단어표 칸에 찍히는 그 그림 그대로**(말귀 청 (437) ㉱ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
5160
+ *
5161
+ * 원은 `CircleBadge`, 그림은 단어표가 쓰는 `MARK_ICON`, **색은 단어표의 `MARK_VARIANT` 를 그대로 따른다** — 앱 사본은 CSS 에
5162
+ * 색 셋(○ main · △ warn · ✕ error)을 다시 적고 있어 표의 색이 바뀌면 갈릴 수 있었다. 여기서는 클래스가 `MARK_VARIANT` 의
5163
+ * 값으로 정해지므로 표와 늘 같다. **모양과 색 둘 다로 가른다** — 색만으로 가르면 색을 잘 못 가리는 사람에게 셋이 같아진다.
5164
+ * @public
5165
+ */
5166
+ export declare function MarkIcon({ mark, label }: MarkIconProps): JSX.Element;
5167
+
5168
+ /** @public */
5169
+ export declare interface MarkIconProps {
5170
+ mark: ScoreMark;
5171
+ /**
5172
+ * 낭독기에 읽힐 이름. **빈 글자면 그림으로만 두고 숨긴다** — 곁에서 같은 것을 이미 말하고 있는 자리가 있다
5173
+ * (채점 창 바닥의 셈은 `role="status"` 한 줄이 통째로 읽는다). 이름 없는 `role="img"` 는 '그림' 이라고만 들린다.
5174
+ */
5175
+ label: string;
5176
+ }
5177
+
5067
5178
  /** 매길 수 있는 표시 — 화면에 이 순서로 늘어놓는다(맞음 → 애매 → 틀림) */
5068
5179
  export declare const MARKS: readonly ScoreMark[];
5069
5180
 
@@ -5580,6 +5691,36 @@ export declare namespace Page {
5580
5691
  /** @public */
5581
5692
  declare type PageNumberPosition = 'left' | 'center' | 'right' | 'none';
5582
5693
 
5694
+ /**
5695
+ * **훈련이 아닌 전체 화면 창의 껍데기**(말귀 청 (437) ㉰ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
5696
+ *
5697
+ * 생김새는 `TrainingPagePopup` 과 같은 `page-popup` 이고, 걸음 넘기기 · 소음 · 결과는 없다 — 단어표 채점 창처럼 화면을 덮는
5698
+ * 아무 창이나 담는다. 자리 셋(`top` · 본문 · `bottom`)만 쥐고 내용은 부르는 쪽이 넣는다. 닫힘은 `usePagePopupClose` 와 짝이다.
5699
+ *
5700
+ * · **열 때 판 안으로 초점을 옮기고, 닫힐 때 부른 자리로 되돌린다.** 부른 자리는 효과가 아니라 **그리는 중**에 적는다 —
5701
+ * 자식의 `autoFocus` 는 커밋 중에 걸려, 효과에서 읽으면 부른 사람이 아니라 그 자식이 적힌다.
5702
+ * · Tab 은 판 안을 돈다(`useFocusTrap`).
5703
+ * @public
5704
+ */
5705
+ export declare function PagePopup({ children, top, bottom, mode, contentFull, closing, className, 'aria-label': ariaLabel }: PagePopupProps): JSX.Element;
5706
+
5707
+ /** @public */
5708
+ export declare interface PagePopupProps {
5709
+ children?: ReactNode;
5710
+ /** 위에 붙는 자리(제목 · 뒤로 단추 등) */
5711
+ top?: ReactNode;
5712
+ /** 아래에 붙는 자리(단추 · 걸음 표시 등) */
5713
+ bottom?: ReactNode;
5714
+ /** 본문 세로 맞춤 — `top`(기본, 위부터) · `center`(짧으면 가운데) */
5715
+ mode?: 'top' | 'center';
5716
+ /** 속 통의 폭 · 여백 제약을 푼다 — 안에 넣는 화면이 제 폭과 여백을 그대로 쓰는 쓰임(표 한 판을 꽉 채우는 창) */
5717
+ contentFull?: boolean;
5718
+ /** 닫히는 중 — `usePagePopupClose` 의 `closing` 을 넘긴다 */
5719
+ closing?: boolean;
5720
+ className?: string;
5721
+ 'aria-label'?: string;
5722
+ }
5723
+
5583
5724
  /**
5584
5725
  * Compound Page Component that groups steps for multi-page training
5585
5726
  */
@@ -6517,6 +6658,14 @@ export declare type PlanTier = 'none' | 'free' | 'personal_standard' | 'mgr_free
6517
6658
  /** @public */
6518
6659
  export declare function Popup(props: PopupProps): JSX.Element;
6519
6660
 
6661
+ /**
6662
+ * **`Popup` 이 사라지는 데 걸리는 시간** — `.popup--closing { transition: opacity 260ms }` 과 닫힘 타이머가 이 수를 쓴다
6663
+ * (말귀 청 (437) ㉳ⓑ, 2026-11-13 — 앱이 이 수를 베껴 들고 "창이 다 사라진 뒤에 일을 치르려" 기다렸다. 코어가 바꾸면 조용히 어긋났다).
6664
+ * 움직임 줄이기에서는 `Popup` 이 0 으로 닫는다 — 기다릴 때는 `useClosingDelay` 를 쓰면 그것까지 따른다.
6665
+ * @public
6666
+ */
6667
+ export declare const POPUP_CLOSE_MS = 260;
6668
+
6520
6669
  /** footer buttons 배열로 전달할 때 사용하는 버튼 설정 */
6521
6670
  export declare type PopupButtonConfig = {
6522
6671
  label: string;
@@ -7856,6 +8005,25 @@ export declare function scoreKey(cellIndex: number): string;
7856
8005
  /** 채점 표시. `null` 은 아직 안 매긴 것 — 0점과는 다르다. */
7857
8006
  export declare type ScoreMark = 'o' | 'triangle' | 'x';
7858
8007
 
8008
+ /**
8009
+ * **매긴 셈 한 묶음 — ○ n · △ n · ✕ n**(말귀 청 (437) ㉱ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
8010
+ *
8011
+ * · **셋을 늘 함께 세운다. 0 도 세운다** — 빠지면 `○ 2 · ✕ 1` 이 되어 △ 를 안 매긴 것인지 △ 가 없는 표인지 가릴 수 없다.
8012
+ * · **들리는 말은 여기서 안 낸다** — 쓰는 자리마다 곁에 `role="status"` 한 줄이 셈을 통째로 읽는다. 곁에 그런 줄이 없으면 `label` 을 준다.
8013
+ * @public
8014
+ */
8015
+ export declare function ScoreMarkCounts({ o, triangle, x, label, className }: ScoreMarkCountsProps): JSX.Element;
8016
+
8017
+ /** @public */
8018
+ export declare interface ScoreMarkCountsProps {
8019
+ o: number;
8020
+ triangle: number;
8021
+ x: number;
8022
+ /** 낭독기에 읽힐 이름 — **곁에 셈을 읽는 줄이 없을 때만** 준다. 안 주면 셋 다 그림으로만 선다 */
8023
+ label?: (mark: ScoreMark, count: number) => string;
8024
+ className?: string;
8025
+ }
8026
+
7859
8027
  /**
7860
8028
  * 쌓인 채점으로 **무엇이 부족하고 다음에 무엇을 할지** 읽어 낸다.
7861
8029
  *
@@ -8782,6 +8950,11 @@ export declare interface StatChartProps {
8782
8950
  /** @deprecated `ChartSectionSize` 를 쓴다 — `auto`→`small` · `ring`→`medium`(2026-11-02) @public */
8783
8951
  export declare type StatChartSize = ChartSectionSize;
8784
8952
 
8953
+ declare interface State {
8954
+ hasError: boolean;
8955
+ error?: Error;
8956
+ }
8957
+
8785
8958
  /**
8786
8959
  * Compound Step Components that work within TrainingPagePopup context
8787
8960
  */
@@ -11494,6 +11667,19 @@ export declare interface UseCalendarMonthResult {
11494
11667
  /** @public */
11495
11668
  export declare function useCardDragToGroup<T = string>(onDrop: (payload: T, groupKey: string) => void, getId?: (payload: T) => string): CardDragToGroup<T>;
11496
11669
 
11670
+ /**
11671
+ * **창이 사라질 짬을 준 뒤에 치른다**(말귀 청 (437) ㉳ⓑ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
11672
+ *
11673
+ * 고객을 지우는 것처럼 **이 창 자체가 없어지는** 일은, 곧바로 치르면 창이 붙은 채로 바깥이 목록을 다시 그려 사라지는 그림과
11674
+ * 겹친다. 한 박자 늦추면 창이 먼저 가고 목록이 그다음이다. 기다리는 시간은 `Popup` 의 닫힘 시간(`POPUP_CLOSE_MS`) — 움직임
11675
+ * 줄이기에서는 `Popup` 처럼 0 이다(앱 사본은 260 을 베껴 들고 움직임 줄이기를 몰랐다).
11676
+ *
11677
+ * · **기다리는 동안 창이 먼저 없어질 수 있다** — 걷힐 때 반드시 시계를 끈다(없는 창이 남긴 일이 뒤늦게 터지지 않게).
11678
+ * · 한 번에 **하나만** 잰다 — 다시 부르면 앞의 것을 덮어쓴다. 두 번 눌러도 일은 한 번만 난다.
11679
+ * @public
11680
+ */
11681
+ export declare function useClosingDelay(waitMs?: number): (todo?: () => void) => void;
11682
+
11497
11683
  /**
11498
11684
  * TextField의 `suggestions` 옵션이 쓰는 자동완성 콤보박스 상태/키보드 로직.
11499
11685
  * 순수 입력(값 관리)과 분리해서, 자동완성이 필요 없는 TextField 사용처는
@@ -11807,6 +11993,27 @@ export declare function useMediaQuery(query: string): boolean;
11807
11993
  /** @public */
11808
11994
  export declare function useNoisePlayer(): NoisePlayerContextValue | null;
11809
11995
 
11996
+ /**
11997
+ * **망이 붙어 있나**(말귀 청 (437) ㉲ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
11998
+ *
11999
+ * `navigator.onLine` 이 **참이라고 인터넷이 되는 것은 아니다**(공유기에만 붙은 상태도 참). 거짓일 때만 믿는다 — 그래서 이 값은
12000
+ * "끊겼다" 를 말하는 데만 쓰고 "붙었다" 를 보장하는 데는 안 쓴다. `useSyncExternalStore` 로 그릴 때마다 바깥 값을 읽어,
12001
+ * 첫 그림과 효과 사이에 바뀐 것을 놓치지 않는다. `navigator` 가 없는 터전(서버)에서는 붙은 것으로 친다 — 틀린 띠가 더 나쁘다.
12002
+ * @public
12003
+ */
12004
+ export declare function useOnline(): boolean;
12005
+
12006
+ /**
12007
+ * **밖을 누르면 접는다** — 펴 둔 목록 · 판을 닫는 한 가지 배선(말귀 청 (437) ㉲ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
12008
+ *
12009
+ * · **`mousedown` 에서 닫는다**(`click` 이 아니라) — 누르는 순간 닫혀야 그 아래 것이 눌리지 않는다. 통 **안**이면 아무 일도 안 한다.
12010
+ * · **펴 있을 때만 듣는다** — 접힌 목록 수십 개가 문서 듣개를 물고 있을 까닭이 없다.
12011
+ * · 닫는 함수는 ref 로 들고 최신 것을 부른다 — 인라인 함수를 넘겨도 렌더마다 듣개를 다시 걸지 않는다.
12012
+ * 닻이 있는 떠 있는 메뉴는 `useAnchoredMenu` 가 같은 일을 한다 — 이것은 제자리에 펴지는 목록 · 판 몫이다.
12013
+ * @public
12014
+ */
12015
+ export declare function useOutsideClose(isOpen: boolean, boxRef: RefObject<HTMLElement | null>, close: () => void): void;
12016
+
11810
12017
  /**
11811
12018
  * 클라이언트 페이지네이션 — 목록·페이지크기·현재 페이지로 현재 쪽 항목·총 쪽수·보정된
11812
12019
  * 현재 쪽을 낸다. 목록이 줄어 page 가 총 쪽수를 넘으면 마지막 쪽으로 조인다(curPage).
@@ -11831,6 +12038,20 @@ export declare function usePagedList<T>(items: T[], perPage: number, page: numbe
11831
12038
  curPage: number;
11832
12039
  };
11833
12040
 
12041
+ /**
12042
+ * **전체 화면 창이 사라지는 동안의 뒷일** — `PagePopup` 의 짝(말귀 청 (437) ㉰).
12043
+ *
12044
+ * · **한 번만 닫힌다** — ESC · 닫기 단추 · 안쪽 '완료' 가 잇달아 들어와도 첫 번째만 먹는다(타이머가 여럿 걸려 `onClose` 가 두 번 불리지 않게).
12045
+ * · **다 사라진 뒤에 떼어 낸다** — `closing` 을 켜고 `PAGE_POPUP_CLOSE_MS` 기다렸다가 `onClose`. **움직임 줄이기면 0** 이다.
12046
+ * · **`onClose` 가 던지면 풀린다** — 안 풀면 닫기 가드가 걸린 채 남아 다시는 못 닫는다(`TrainingPagePopup` 과 같은 고침 — 앱 사본엔 둘 다 없었다).
12047
+ * · 떠 있는 동안 뒤 화면 스크롤을 잠근다. 화면을 떠나면 타이머를 끈다.
12048
+ * @public
12049
+ */
12050
+ export declare function usePagePopupClose(onClose: () => void): {
12051
+ closing: boolean;
12052
+ handleClose: () => void;
12053
+ };
12054
+
11834
12055
  /**
11835
12056
  * **거르는 조건이 바뀌면 첫 쪽으로 돌아간다.** `usePagedList` 의 짝이다.
11836
12057
  *
@@ -11854,6 +12075,24 @@ export declare function usePagedList<T>(items: T[], perPage: number, page: numbe
11854
12075
  */
11855
12076
  export declare function usePageResetOnChange(key: string, setPage: (n: number) => void): void;
11856
12077
 
12078
+ /**
12079
+ * **"N개씩 보기" 보기 목록** — `Toolbar` 의 `pageSize.options` · `Dropdown` 에 그대로 넘긴다(말귀 청 (437) ㉳ⓐ, 2026-11-13).
12080
+ *
12081
+ * 코어가 `ListPopup` 안에서 `common.pageSizeLabel` 로 이 목록을 짓고도 내주지 않아, 말귀 앱 · 어드민이 사전 열쇠 세 벌과
12082
+ * 박은 한국어로 같은 것을 다시 지었다. 문구는 사전(`common.pageSizeLabel` — `{{n}}개씩 보기` · `Show {{n}}`) 한 벌이고,
12083
+ * 값(몇 개씩)은 화면마다 다르니 받는다. 값은 문자열로 돌려준다(드롭다운 값이 문자열이다).
12084
+ *
12085
+ * ```tsx
12086
+ * const options = usePageSizeOptions() // 10 · 25 · 50 · 100
12087
+ * const cards = usePageSizeOptions([12, 24, 48]) // 화면마다 다른 값
12088
+ * ```
12089
+ * @public
12090
+ */
12091
+ export declare function usePageSizeOptions(counts?: readonly number[]): {
12092
+ value: string;
12093
+ label: string;
12094
+ }[];
12095
+
11857
12096
  /**
11858
12097
  * 비밀번호 변경 폼 상태와 핸들러를 캡슐화한 훅.
11859
12098
  * showModal 상태는 컴포넌트가 직접 관리 (훅 밖에 두어야 모달 열기 트리거 제어 가능).
@@ -11891,6 +12130,34 @@ export declare function usePasswordChange(onChangePassword?: (current: string, n
11891
12130
  */
11892
12131
  export declare function useRelativeDay(): (iso?: string | null) => string;
11893
12132
 
12133
+ /**
12134
+ * **쪽이 숨는 순간 초안을 바로 적는다**(말귀 청 (437) ㉲ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
12135
+ *
12136
+ * 고치던 것을 늦춰(디바운스) 적는 화면은, 마지막 손질 뒤 그 짬 안에 탭이 사라지면 그 손질만 빠진다. 폰에서는 드물지 않다 —
12137
+ * 글자를 치고 바로 홈 단추를 누르거나 전화가 와서 앱이 뒤로 밀린다. 묻는 길(`beforeunload`)은 iOS 사파리가 거의 안 쏴서 못 쓴다.
12138
+ *
12139
+ * · `visibilitychange` → `hidden` 이 폰에서 실제로 오는 신호다(홈 · 앱 전환 · 화면 잠금).
12140
+ * · `pagehide` 는 탭을 닫거나 옮길 때 · 뒤로-앞으로 캐시로 들어갈 때 와서 `hidden` 이 안 오는 경우를 메운다.
12141
+ * 둘 다 올 수 있다 — 같은 값을 두 번 적어도 해가 없게(멱등하게) 적는다.
12142
+ *
12143
+ * **여기서 비동기를 하지 않는다** — 숨는 순간 브라우저는 약속이 끝나기를 안 기다린다. `localStorage` 처럼 그 자리에서 끝나는 쓰기만.
12144
+ * @public
12145
+ */
12146
+ export declare function useSaveOnHide(save: () => void, enabled?: boolean): void;
12147
+
12148
+ /**
12149
+ * **켜 둔 동안 폰 화면이 저절로 꺼지지 않게 한다**(말귀 청 (437) ㉲ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
12150
+ *
12151
+ * 훈련은 "듣고 → 고르기" 라 손이 화면에 닿지 않는 구간이 길다 — 폰의 화면 꺼짐(30초 · 1분)이 먼저 와서 소리는 나는데 화면이
12152
+ * 꺼지고, 깨우면 잠금 화면이 가로막는다.
12153
+ *
12154
+ * · `active` 인 동안 `wakeLock.request('screen')` 을 잡는다. 못 잡으면(저전력 모드 · 안 되는 브라우저) **조용히** 지나간다.
12155
+ * · 탭이 숨겨지면 브라우저가 알아서 놓는다. **다시 보이면 다시 잡는다**(`visibilitychange`).
12156
+ * · 끝나면 놓는다. 잡는 중에 끝났으면 잡힌 것을 바로 놓는다(언마운트 뒤에 남는 잠금이 없게).
12157
+ * @public
12158
+ */
12159
+ export declare function useScreenWakeLock(active: boolean): void;
12160
+
11894
12161
  export declare function useSoundCompassExam(speakers: SpeakerPos[], { mode, autoStart, onPlaySpeaker, onComplete, playMs, feedbackMs, }?: UseSoundCompassExamOptions): SoundCompassExam;
11895
12162
 
11896
12163
  export declare interface UseSoundCompassExamOptions {
@@ -12041,6 +12308,26 @@ export declare function useTrainingTypeLabels(): {
12041
12308
  all: Record<string, string>;
12042
12309
  };
12043
12310
 
12311
+ /**
12312
+ * **값으로 묻는 닫기 막이** — 창이 처음 열린 때의 값과 지금 값을 견줘, 달라졌으면 닫기 전에 묻는다
12313
+ * (말귀 청 (437) ㉯, 2026-11-13).
12314
+ *
12315
+ * `useDiscardGuard` 는 참 · 거짓만 받는다. 그래서 말귀 앱 여섯 창이 저마다
12316
+ * `const [first] = useState(() => JSON.stringify(x))` 로 첫 모습을 얼리고 `JSON.stringify(cur) !== first` 를 넘겼다
12317
+ * (회사 정보 · 정보 입력 · 방문 고치기 · 방문 등록 · 고객 추가 · 단어훈련 묶음). 그 두 줄을 여기 한 벌로 둔다.
12318
+ *
12319
+ * · 첫 값은 **처음 그릴 때 한 번** 얼린다 — 그 뒤 부르는 쪽이 새 객체를 넘겨도 기준은 안 바뀐다.
12320
+ * · 견주기는 JSON 꼴로 한다 — 자리만 같고 새로 만든 객체 · 배열이어도 내용이 같으면 '안 달라짐' 이다.
12321
+ * (그래서 값에는 JSON 으로 옮길 수 있는 것만 넣는다 — 함수 · `Date` 의 시각 차 · `undefined` 칸은 견주기에서 빠진다.)
12322
+ * · 값을 늦게 불러오는 창은 다 불러온 뒤 `rebase()` 를 부른다 — 안 부르면 빈 첫 값과 견줘 늘 '달라짐' 이 된다.
12323
+ *
12324
+ * ```tsx
12325
+ * const { beforeClose, discardPopup, allowClose, isDirty } = useValueDiscardGuard(form, onClose)
12326
+ * ```
12327
+ * @public
12328
+ */
12329
+ export declare function useValueDiscardGuard(value: unknown, onClose: () => void, labels?: DiscardGuardLabels): ValueDiscardGuard;
12330
+
12044
12331
  /**
12045
12332
  * 통합 방문 전체보기 팝업의 검색/필터/페이지네이션 상태를 관리하는 훅.
12046
12333
  * `mergedVisits`(예정+완료+미방문)를 받아 파생 데이터를 계산.
@@ -12313,6 +12600,14 @@ export declare function validateSyllableSearchInput(input: string): {
12313
12600
  ok: boolean;
12314
12601
  };
12315
12602
 
12603
+ /** @public `useValueDiscardGuard` 가 돌려주는 것 — `DiscardGuard` 에 지금 달라졌나 · 기준 다시 잡기를 더한 것 */
12604
+ export declare interface ValueDiscardGuard extends DiscardGuard {
12605
+ /** 첫 값과 지금 값이 다른가 — 저장 단추를 켜고 끌 때도 쓴다 */
12606
+ isDirty: boolean;
12607
+ /** **지금 값을 새 기준으로 잡는다** — 늦게 불러온 값을 채운 뒤나, 저장해 놓고 창을 안 닫고 이어 쓸 때 부른다 */
12608
+ rebase: () => void;
12609
+ }
12610
+
12316
12611
  /** 선택 값(자모 문자열, 병합 버튼은 다자모)을 실제 매칭 자모 배열로 분해. NO_CODA는 빈 배열. */
12317
12612
  export declare const valueToJamos: (v: string) => string[];
12318
12613
 
@@ -0,0 +1,55 @@
1
+ import { Component, type ErrorInfo, type ReactNode } from 'react';
2
+ /** @public 넘어진 화면을 그릴 때 받는 것 */
3
+ export interface ErrorFallbackProps {
4
+ error?: Error;
5
+ /** 다시 그려 본다 — 일시적인 렌더 오류는 이것으로 풀리는 수가 많다 */
6
+ retry: () => void;
7
+ /** 쪽을 새로 고친다 — 낡은 묶음(배포 뒤 옛 조각) 오류는 되살려도 같은 오류가 다시 난다 */
8
+ reload: () => void;
9
+ /** 낡은 묶음 오류인가 — 참이면 `reload` 를 권한다 */
10
+ staleChunk: boolean;
11
+ }
12
+ /** @public */
13
+ export interface ErrorBoundaryProps {
14
+ children: ReactNode;
15
+ /** 넘어진 화면 — 문구 · 모양은 앱 몫이다. 안 주면 아무것도 안 그린다 */
16
+ fallback?: (p: ErrorFallbackProps) => ReactNode;
17
+ onError?: (error: Error, info: ErrorInfo) => void;
18
+ /**
19
+ * 이 값들이 바뀌면 오류를 푼다 — 보통 지금 쪽의 열쇠를 넘긴다. 울타리가 쪽 전환보다 바깥에 있으면 쪽을 바꿔도 같은 울타리가
20
+ * 남아 오류 화면에 붙박이고, 머리 · 바닥 내비만 눌리는 채 빠져나갈 길이 새로고침뿐이 된다.
21
+ */
22
+ resetKeys?: readonly unknown[];
23
+ /** 새로고침을 바꿔 끼운다 — 시험이 jsdom 의 `location.reload` 를 못 부르므로 */
24
+ reload?: () => void;
25
+ /**
26
+ * 개발 중 고쳐 끼우기(HMR)가 왔을 때 '이 울타리가 오류 화면인가' 를 알릴 자리 — 앱의 개발용 손을 넘긴다.
27
+ * 받은 함수를 부르면 지금 오류 화면인지 답하고, 돌려준 함수는 떼어 낼 때 부른다.
28
+ */
29
+ registerHealth?: (isBroken: () => boolean) => () => void;
30
+ }
31
+ interface State {
32
+ hasError: boolean;
33
+ error?: Error;
34
+ }
35
+ /**
36
+ * **오류 울타리** — 아래 화면이 그리다 넘어지면 잡아서 넘어진 화면을 세운다(말귀 청 (437) ㉴ — 말귀 앱 · 어드민 두 벌을 하나로, 2026-11-13).
37
+ *
38
+ * · **운영에서도 남긴다** — `console.error(error, '[ErrorBoundary]', 줄기)` 로. 앱의 오류 보고가 `console.error` 를 가로채 보낸다.
39
+ * `Error` 를 **첫 인자로** 준다 — 문자열이 앞이면 보고가 새 `Error` 를 만들어 줄기(스택)가 사라진다.
40
+ * · `resetKeys` 가 바뀌면 오류를 푼다(쪽을 옮기면 빠져나올 수 있게).
41
+ * · 낡은 묶음 오류(`isChunkLoadError`)면 `staleChunk` 를 참으로 넘긴다 — 되살리기가 아니라 새로고침을 권할 자리다.
42
+ * · 넘어진 화면의 문구 · 모양 · 개발용 다시 그리기는 앱이 넘긴다(`fallback` · `registerHealth`).
43
+ * @public
44
+ */
45
+ export default class ErrorBoundary extends Component<ErrorBoundaryProps, State> {
46
+ state: State;
47
+ private releaseHealth?;
48
+ static getDerivedStateFromError(error: Error): State;
49
+ componentDidCatch(error: Error, info: ErrorInfo): void;
50
+ componentDidMount(): void;
51
+ componentWillUnmount(): void;
52
+ componentDidUpdate(prevProps: ErrorBoundaryProps): void;
53
+ render(): ReactNode;
54
+ }
55
+ export {};
@@ -0,0 +1,52 @@
1
+ 'use client';
2
+ import { Component } from 'react';
3
+ import { isChunkLoadError } from '../utils/chunkSkew';
4
+ /**
5
+ * **오류 울타리** — 아래 화면이 그리다 넘어지면 잡아서 넘어진 화면을 세운다(말귀 청 (437) ㉴ — 말귀 앱 · 어드민 두 벌을 하나로, 2026-11-13).
6
+ *
7
+ * · **운영에서도 남긴다** — `console.error(error, '[ErrorBoundary]', 줄기)` 로. 앱의 오류 보고가 `console.error` 를 가로채 보낸다.
8
+ * `Error` 를 **첫 인자로** 준다 — 문자열이 앞이면 보고가 새 `Error` 를 만들어 줄기(스택)가 사라진다.
9
+ * · `resetKeys` 가 바뀌면 오류를 푼다(쪽을 옮기면 빠져나올 수 있게).
10
+ * · 낡은 묶음 오류(`isChunkLoadError`)면 `staleChunk` 를 참으로 넘긴다 — 되살리기가 아니라 새로고침을 권할 자리다.
11
+ * · 넘어진 화면의 문구 · 모양 · 개발용 다시 그리기는 앱이 넘긴다(`fallback` · `registerHealth`).
12
+ * @public
13
+ */
14
+ export default class ErrorBoundary extends Component {
15
+ state = { hasError: false };
16
+ releaseHealth;
17
+ static getDerivedStateFromError(error) {
18
+ return { hasError: true, error };
19
+ }
20
+ componentDidCatch(error, info) {
21
+ this.props.onError?.(error, info);
22
+ console.error(error, '[ErrorBoundary]', info.componentStack);
23
+ }
24
+ componentDidMount() {
25
+ this.releaseHealth = this.props.registerHealth?.(() => this.state.hasError);
26
+ }
27
+ componentWillUnmount() {
28
+ this.releaseHealth?.();
29
+ }
30
+ componentDidUpdate(prevProps) {
31
+ if (!this.state.hasError)
32
+ return;
33
+ const prev = prevProps.resetKeys;
34
+ const next = this.props.resetKeys;
35
+ if (!prev || !next)
36
+ return;
37
+ if (prev.length !== next.length || prev.some((k, i) => !Object.is(k, next[i]))) {
38
+ this.setState({ hasError: false, error: undefined });
39
+ }
40
+ }
41
+ render() {
42
+ if (!this.state.hasError)
43
+ return this.props.children;
44
+ const error = this.state.error;
45
+ return this.props.fallback?.({
46
+ error,
47
+ retry: () => this.setState({ hasError: false, error: undefined }),
48
+ reload: this.props.reload ?? (() => { window.location.reload(); }),
49
+ staleChunk: isChunkLoadError(error),
50
+ }) ?? null;
51
+ }
52
+ }
@@ -0,0 +1,9 @@
1
+ import type { ReactNode } from 'react';
2
+ /**
3
+ * **감싼 것이 떠 있는 동안 폰 화면이 꺼지지 않게 한다** — 자리를 차지하지 않는다(말귀 청 (437) ㉲).
4
+ * 훈련 창을 띄우는 길목을 이것으로 감싼다. 켜고 끄는 조건이 따로 있으면 `useScreenWakeLock(active)` 를 바로 쓴다.
5
+ * @public
6
+ */
7
+ export default function KeepScreenAwake({ children }: {
8
+ children: ReactNode;
9
+ }): import("react").JSX.Element;
@@ -0,0 +1,12 @@
1
+ 'use client';
2
+ import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
3
+ import { useScreenWakeLock } from '../hooks/useScreenWakeLock';
4
+ /**
5
+ * **감싼 것이 떠 있는 동안 폰 화면이 꺼지지 않게 한다** — 자리를 차지하지 않는다(말귀 청 (437) ㉲).
6
+ * 훈련 창을 띄우는 길목을 이것으로 감싼다. 켜고 끄는 조건이 따로 있으면 `useScreenWakeLock(active)` 를 바로 쓴다.
7
+ * @public
8
+ */
9
+ export default function KeepScreenAwake({ children }) {
10
+ useScreenWakeLock(true);
11
+ return _jsx(_Fragment, { children: children });
12
+ }
@@ -0,0 +1,12 @@
1
+ /* 평가 표시 — 원은 `CircleBadge` 가 그린다. 여기서 더하는 것은 **색 하나**뿐이다(말귀 청 (437) ㉱).
2
+ 클래스는 단어표의 `MARK_VARIANT` 값(main · warn · danger)이다 — 표의 색과 같은 이름 · 같은 토큰. */
3
+ .mark-icon {
4
+ display: inline-flex;
5
+ flex: 0 0 auto;
6
+ vertical-align: middle;
7
+ }
8
+ .mark-icon__badge--main { background: var(--color-main); }
9
+ .mark-icon__badge--warn { background: var(--color-warn); }
10
+ .mark-icon__badge--danger { background: var(--color-error); }
11
+ /* 그림을 원의 정가운데로 — `Icon` 의 감싸개는 글줄 상자라 줄 높이만큼 위로 떴다(실측 0.75px) */
12
+ .mark-icon__badge .iconRenderer-icon { display: flex; }
@@ -0,0 +1,20 @@
1
+ import { type ScoreMark } from './Word/wordTableScoring';
2
+ import './MarkIcon.css';
3
+ /** @public */
4
+ export interface MarkIconProps {
5
+ mark: ScoreMark;
6
+ /**
7
+ * 낭독기에 읽힐 이름. **빈 글자면 그림으로만 두고 숨긴다** — 곁에서 같은 것을 이미 말하고 있는 자리가 있다
8
+ * (채점 창 바닥의 셈은 `role="status"` 한 줄이 통째로 읽는다). 이름 없는 `role="img"` 는 '그림' 이라고만 들린다.
9
+ */
10
+ label: string;
11
+ }
12
+ /**
13
+ * **평가 표시(○ △ ✕) — 단어표 칸에 찍히는 그 그림 그대로**(말귀 청 (437) ㉱ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
14
+ *
15
+ * 원은 `CircleBadge`, 그림은 단어표가 쓰는 `MARK_ICON`, **색은 단어표의 `MARK_VARIANT` 를 그대로 따른다** — 앱 사본은 CSS 에
16
+ * 색 셋(○ main · △ warn · ✕ error)을 다시 적고 있어 표의 색이 바뀌면 갈릴 수 있었다. 여기서는 클래스가 `MARK_VARIANT` 의
17
+ * 값으로 정해지므로 표와 늘 같다. **모양과 색 둘 다로 가른다** — 색만으로 가르면 색을 잘 못 가리는 사람에게 셋이 같아진다.
18
+ * @public
19
+ */
20
+ export default function MarkIcon({ mark, label }: MarkIconProps): import("react").JSX.Element;
@@ -0,0 +1,18 @@
1
+ 'use client';
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import CircleBadge from './CircleBadge';
4
+ import Icon from './Icon';
5
+ import { MARK_ICON, MARK_VARIANT } from './Word/wordTableScoring';
6
+ import './MarkIcon.css';
7
+ /**
8
+ * **평가 표시(○ △ ✕) — 단어표 칸에 찍히는 그 그림 그대로**(말귀 청 (437) ㉱ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
9
+ *
10
+ * 원은 `CircleBadge`, 그림은 단어표가 쓰는 `MARK_ICON`, **색은 단어표의 `MARK_VARIANT` 를 그대로 따른다** — 앱 사본은 CSS 에
11
+ * 색 셋(○ main · △ warn · ✕ error)을 다시 적고 있어 표의 색이 바뀌면 갈릴 수 있었다. 여기서는 클래스가 `MARK_VARIANT` 의
12
+ * 값으로 정해지므로 표와 늘 같다. **모양과 색 둘 다로 가른다** — 색만으로 가르면 색을 잘 못 가리는 사람에게 셋이 같아진다.
13
+ * @public
14
+ */
15
+ export default function MarkIcon({ mark, label }) {
16
+ const readable = label ? { role: 'img', 'aria-label': label } : { 'aria-hidden': true };
17
+ return (_jsx("span", { className: "mark-icon", ...readable, children: _jsx(CircleBadge, { size: 24, position: "inline", className: `mark-icon__badge mark-icon__badge--${MARK_VARIANT[mark]}`, children: _jsx(Icon, { icon: MARK_ICON[mark], size: 14 }) }) }));
18
+ }
@@ -0,0 +1,43 @@
1
+ import { type ReactNode } from 'react';
2
+ import './Training/TrainingPagePopup.css';
3
+ /** @public */
4
+ export interface PagePopupProps {
5
+ children?: ReactNode;
6
+ /** 위에 붙는 자리(제목 · 뒤로 단추 등) */
7
+ top?: ReactNode;
8
+ /** 아래에 붙는 자리(단추 · 걸음 표시 등) */
9
+ bottom?: ReactNode;
10
+ /** 본문 세로 맞춤 — `top`(기본, 위부터) · `center`(짧으면 가운데) */
11
+ mode?: 'top' | 'center';
12
+ /** 속 통의 폭 · 여백 제약을 푼다 — 안에 넣는 화면이 제 폭과 여백을 그대로 쓰는 쓰임(표 한 판을 꽉 채우는 창) */
13
+ contentFull?: boolean;
14
+ /** 닫히는 중 — `usePagePopupClose` 의 `closing` 을 넘긴다 */
15
+ closing?: boolean;
16
+ className?: string;
17
+ 'aria-label'?: string;
18
+ }
19
+ /**
20
+ * **훈련이 아닌 전체 화면 창의 껍데기**(말귀 청 (437) ㉰ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
21
+ *
22
+ * 생김새는 `TrainingPagePopup` 과 같은 `page-popup` 이고, 걸음 넘기기 · 소음 · 결과는 없다 — 단어표 채점 창처럼 화면을 덮는
23
+ * 아무 창이나 담는다. 자리 셋(`top` · 본문 · `bottom`)만 쥐고 내용은 부르는 쪽이 넣는다. 닫힘은 `usePagePopupClose` 와 짝이다.
24
+ *
25
+ * · **열 때 판 안으로 초점을 옮기고, 닫힐 때 부른 자리로 되돌린다.** 부른 자리는 효과가 아니라 **그리는 중**에 적는다 —
26
+ * 자식의 `autoFocus` 는 커밋 중에 걸려, 효과에서 읽으면 부른 사람이 아니라 그 자식이 적힌다.
27
+ * · Tab 은 판 안을 돈다(`useFocusTrap`).
28
+ * @public
29
+ */
30
+ export default function PagePopup({ children, top, bottom, mode, contentFull, closing, className, 'aria-label': ariaLabel }: PagePopupProps): import("react").JSX.Element;
31
+ /**
32
+ * **전체 화면 창이 사라지는 동안의 뒷일** — `PagePopup` 의 짝(말귀 청 (437) ㉰).
33
+ *
34
+ * · **한 번만 닫힌다** — ESC · 닫기 단추 · 안쪽 '완료' 가 잇달아 들어와도 첫 번째만 먹는다(타이머가 여럿 걸려 `onClose` 가 두 번 불리지 않게).
35
+ * · **다 사라진 뒤에 떼어 낸다** — `closing` 을 켜고 `PAGE_POPUP_CLOSE_MS` 기다렸다가 `onClose`. **움직임 줄이기면 0** 이다.
36
+ * · **`onClose` 가 던지면 풀린다** — 안 풀면 닫기 가드가 걸린 채 남아 다시는 못 닫는다(`TrainingPagePopup` 과 같은 고침 — 앱 사본엔 둘 다 없었다).
37
+ * · 떠 있는 동안 뒤 화면 스크롤을 잠근다. 화면을 떠나면 타이머를 끈다.
38
+ * @public
39
+ */
40
+ export declare function usePagePopupClose(onClose: () => void): {
41
+ closing: boolean;
42
+ handleClose: () => void;
43
+ };