@ihabdevteam/core 0.442.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.
- package/CHANGELOG.md +14 -0
- package/dist/components.cjs.js +190 -190
- package/dist/components.esm.css +2 -2
- package/dist/hooks.cjs.js +5 -5
- package/dist/i18n.cjs.js +1 -1
- package/dist/ihabdevteam-core.cjs.js +186 -186
- package/dist/ihabdevteam-core.d.ts +247 -1
- package/dist/packages/core/src/components/ErrorBoundary.d.ts +55 -0
- package/dist/packages/core/src/components/ErrorBoundary.js +52 -0
- package/dist/packages/core/src/components/KeepScreenAwake.d.ts +9 -0
- package/dist/packages/core/src/components/KeepScreenAwake.js +12 -0
- package/dist/packages/core/src/components/MarkIcon.css +12 -0
- package/dist/packages/core/src/components/MarkIcon.d.ts +20 -0
- package/dist/packages/core/src/components/MarkIcon.js +18 -0
- package/dist/packages/core/src/components/PagePopup.d.ts +43 -0
- package/dist/packages/core/src/components/PagePopup.js +71 -0
- package/dist/packages/core/src/components/Popup/Popup.js +2 -1
- package/dist/packages/core/src/components/ScoreMarkCounts.css +9 -0
- package/dist/packages/core/src/components/ScoreMarkCounts.d.ts +19 -0
- package/dist/packages/core/src/components/ScoreMarkCounts.js +16 -0
- package/dist/packages/core/src/components.d.ts +10 -0
- package/dist/packages/core/src/components.js +7 -0
- package/dist/packages/core/src/hooks/useClosingDelay.d.ts +12 -0
- package/dist/packages/core/src/hooks/useClosingDelay.js +30 -0
- package/dist/packages/core/src/hooks/useOnline.d.ts +9 -0
- package/dist/packages/core/src/hooks/useOnline.js +23 -0
- package/dist/packages/core/src/hooks/useOutsideClose.d.ts +11 -0
- package/dist/packages/core/src/hooks/useOutsideClose.js +23 -0
- package/dist/packages/core/src/hooks/useSaveOnHide.d.ts +14 -0
- package/dist/packages/core/src/hooks/useSaveOnHide.js +32 -0
- package/dist/packages/core/src/hooks/useScreenWakeLock.d.ts +12 -0
- package/dist/packages/core/src/hooks/useScreenWakeLock.js +53 -0
- package/dist/packages/core/src/hooks.d.ts +5 -0
- package/dist/packages/core/src/hooks.js +6 -0
- package/dist/packages/core/src/utils/kstDateTime.d.ts +21 -0
- package/dist/packages/core/src/utils/kstDateTime.js +38 -0
- package/dist/packages/core/src/utils/popupTiming.d.ts +7 -0
- package/dist/packages/core/src/utils/popupTiming.js +7 -0
- package/dist/packages/core/src/utils.d.ts +2 -0
- package/dist/packages/core/src/utils.js +1 -0
- package/dist/packages/core/src/version.d.ts +1 -1
- package/dist/packages/core/src/version.js +1 -1
- package/dist/utils.cjs.js +166 -166
- 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.
|
|
2230
|
+
export declare const CORE_VERSION = "0.443.0";
|
|
2229
2231
|
|
|
2230
2232
|
/** @public */
|
|
2231
2233
|
declare const coreDefault: Record<string, unknown>;
|
|
@@ -2891,6 +2893,58 @@ export declare interface EmptyStateProps {
|
|
|
2891
2893
|
*/
|
|
2892
2894
|
export declare function ensureTrainingDataLoaded(timeout?: number): Promise<boolean>;
|
|
2893
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
|
+
|
|
2894
2948
|
export declare function ErrorState({ message, hint, icon, onRetry, retryLabel, className }: ErrorStateProps): JSX.Element;
|
|
2895
2949
|
|
|
2896
2950
|
/** @public
|
|
@@ -4510,6 +4564,30 @@ export declare const JONGSEONG: readonly ["", "ㄱ", "ㄲ", "ㄳ", "ㄴ", "ㄵ",
|
|
|
4510
4564
|
|
|
4511
4565
|
export declare const JUNGSEONG: readonly ["ㅏ", "ㅐ", "ㅑ", "ㅒ", "ㅓ", "ㅔ", "ㅕ", "ㅖ", "ㅗ", "ㅘ", "ㅙ", "ㅚ", "ㅛ", "ㅜ", "ㅝ", "ㅞ", "ㅟ", "ㅠ", "ㅡ", "ㅢ", "ㅣ"];
|
|
4512
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
|
+
|
|
4513
4591
|
/**
|
|
4514
4592
|
* KST 달력 날짜(연, 0부터 세는 월, 일)의 **00:00 KST 순간.** 일·월은 넘쳐도 된다(`Date.UTC` 처럼 — 32일은 다음 달 1일).
|
|
4515
4593
|
* 서버에 기간을 물을 때(`toISOString()`) 기기 시간대가 아니라 KST 의 하루로 자르려고 쓴다.
|
|
@@ -4518,6 +4596,16 @@ export declare const JUNGSEONG: readonly ["ㅏ", "ㅐ", "ㅑ", "ㅒ", "ㅓ", "
|
|
|
4518
4596
|
*/
|
|
4519
4597
|
export declare function kstStartOfDay(year: number, month0: number, day: number): Date;
|
|
4520
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
|
+
|
|
4521
4609
|
/**
|
|
4522
4610
|
* {@link cellKey} 로 만든 칸 낱말에서 동형어 번호를 뗀 보이는 글자 — `배#2 / 패` → `배 / 패`. 번호가 없으면 그대로.
|
|
4523
4611
|
*
|
|
@@ -5067,6 +5155,26 @@ export declare const MARK_VARIANT: Record<ScoreMark, 'main' | 'warn' | 'danger'>
|
|
|
5067
5155
|
*/
|
|
5068
5156
|
export declare function markAfterClick(current: ScoreMark | null, clicked: ScoreMark): ScoreMark | null;
|
|
5069
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
|
+
|
|
5070
5178
|
/** 매길 수 있는 표시 — 화면에 이 순서로 늘어놓는다(맞음 → 애매 → 틀림) */
|
|
5071
5179
|
export declare const MARKS: readonly ScoreMark[];
|
|
5072
5180
|
|
|
@@ -5583,6 +5691,36 @@ export declare namespace Page {
|
|
|
5583
5691
|
/** @public */
|
|
5584
5692
|
declare type PageNumberPosition = 'left' | 'center' | 'right' | 'none';
|
|
5585
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
|
+
|
|
5586
5724
|
/**
|
|
5587
5725
|
* Compound Page Component that groups steps for multi-page training
|
|
5588
5726
|
*/
|
|
@@ -6520,6 +6658,14 @@ export declare type PlanTier = 'none' | 'free' | 'personal_standard' | 'mgr_free
|
|
|
6520
6658
|
/** @public */
|
|
6521
6659
|
export declare function Popup(props: PopupProps): JSX.Element;
|
|
6522
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
|
+
|
|
6523
6669
|
/** footer buttons 배열로 전달할 때 사용하는 버튼 설정 */
|
|
6524
6670
|
export declare type PopupButtonConfig = {
|
|
6525
6671
|
label: string;
|
|
@@ -7859,6 +8005,25 @@ export declare function scoreKey(cellIndex: number): string;
|
|
|
7859
8005
|
/** 채점 표시. `null` 은 아직 안 매긴 것 — 0점과는 다르다. */
|
|
7860
8006
|
export declare type ScoreMark = 'o' | 'triangle' | 'x';
|
|
7861
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
|
+
|
|
7862
8027
|
/**
|
|
7863
8028
|
* 쌓인 채점으로 **무엇이 부족하고 다음에 무엇을 할지** 읽어 낸다.
|
|
7864
8029
|
*
|
|
@@ -8785,6 +8950,11 @@ export declare interface StatChartProps {
|
|
|
8785
8950
|
/** @deprecated `ChartSectionSize` 를 쓴다 — `auto`→`small` · `ring`→`medium`(2026-11-02) @public */
|
|
8786
8951
|
export declare type StatChartSize = ChartSectionSize;
|
|
8787
8952
|
|
|
8953
|
+
declare interface State {
|
|
8954
|
+
hasError: boolean;
|
|
8955
|
+
error?: Error;
|
|
8956
|
+
}
|
|
8957
|
+
|
|
8788
8958
|
/**
|
|
8789
8959
|
* Compound Step Components that work within TrainingPagePopup context
|
|
8790
8960
|
*/
|
|
@@ -11497,6 +11667,19 @@ export declare interface UseCalendarMonthResult {
|
|
|
11497
11667
|
/** @public */
|
|
11498
11668
|
export declare function useCardDragToGroup<T = string>(onDrop: (payload: T, groupKey: string) => void, getId?: (payload: T) => string): CardDragToGroup<T>;
|
|
11499
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
|
+
|
|
11500
11683
|
/**
|
|
11501
11684
|
* TextField의 `suggestions` 옵션이 쓰는 자동완성 콤보박스 상태/키보드 로직.
|
|
11502
11685
|
* 순수 입력(값 관리)과 분리해서, 자동완성이 필요 없는 TextField 사용처는
|
|
@@ -11810,6 +11993,27 @@ export declare function useMediaQuery(query: string): boolean;
|
|
|
11810
11993
|
/** @public */
|
|
11811
11994
|
export declare function useNoisePlayer(): NoisePlayerContextValue | null;
|
|
11812
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
|
+
|
|
11813
12017
|
/**
|
|
11814
12018
|
* 클라이언트 페이지네이션 — 목록·페이지크기·현재 페이지로 현재 쪽 항목·총 쪽수·보정된
|
|
11815
12019
|
* 현재 쪽을 낸다. 목록이 줄어 page 가 총 쪽수를 넘으면 마지막 쪽으로 조인다(curPage).
|
|
@@ -11834,6 +12038,20 @@ export declare function usePagedList<T>(items: T[], perPage: number, page: numbe
|
|
|
11834
12038
|
curPage: number;
|
|
11835
12039
|
};
|
|
11836
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
|
+
|
|
11837
12055
|
/**
|
|
11838
12056
|
* **거르는 조건이 바뀌면 첫 쪽으로 돌아간다.** `usePagedList` 의 짝이다.
|
|
11839
12057
|
*
|
|
@@ -11912,6 +12130,34 @@ export declare function usePasswordChange(onChangePassword?: (current: string, n
|
|
|
11912
12130
|
*/
|
|
11913
12131
|
export declare function useRelativeDay(): (iso?: string | null) => string;
|
|
11914
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
|
+
|
|
11915
12161
|
export declare function useSoundCompassExam(speakers: SpeakerPos[], { mode, autoStart, onPlaySpeaker, onComplete, playMs, feedbackMs, }?: UseSoundCompassExamOptions): SoundCompassExam;
|
|
11916
12162
|
|
|
11917
12163
|
export declare interface UseSoundCompassExamOptions {
|
|
@@ -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
|
+
};
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
'use client';
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { useCallback, useEffect, useRef, useState } from 'react';
|
|
4
|
+
import { cx } from '../utils/cx';
|
|
5
|
+
import { useFocusTrap, FOCUSABLE_SELECTOR } from '../hooks/useFocusTrap';
|
|
6
|
+
import { lockBodyScrollWithPadding } from '../hooks/bodyScrollLock';
|
|
7
|
+
import { prefersReducedMotion } from '../hooks/usePrefersReducedMotion';
|
|
8
|
+
import { PAGE_POPUP_CLOSE_MS } from './Training/pagePopupTiming';
|
|
9
|
+
import './Training/TrainingPagePopup.css';
|
|
10
|
+
/**
|
|
11
|
+
* **훈련이 아닌 전체 화면 창의 껍데기**(말귀 청 (437) ㉰ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
|
|
12
|
+
*
|
|
13
|
+
* 생김새는 `TrainingPagePopup` 과 같은 `page-popup` 이고, 걸음 넘기기 · 소음 · 결과는 없다 — 단어표 채점 창처럼 화면을 덮는
|
|
14
|
+
* 아무 창이나 담는다. 자리 셋(`top` · 본문 · `bottom`)만 쥐고 내용은 부르는 쪽이 넣는다. 닫힘은 `usePagePopupClose` 와 짝이다.
|
|
15
|
+
*
|
|
16
|
+
* · **열 때 판 안으로 초점을 옮기고, 닫힐 때 부른 자리로 되돌린다.** 부른 자리는 효과가 아니라 **그리는 중**에 적는다 —
|
|
17
|
+
* 자식의 `autoFocus` 는 커밋 중에 걸려, 효과에서 읽으면 부른 사람이 아니라 그 자식이 적힌다.
|
|
18
|
+
* · Tab 은 판 안을 돈다(`useFocusTrap`).
|
|
19
|
+
* @public
|
|
20
|
+
*/
|
|
21
|
+
export default function PagePopup({ children, top, bottom, mode = 'top', contentFull = false, closing = false, className, 'aria-label': ariaLabel }) {
|
|
22
|
+
const panelRef = useRef(null);
|
|
23
|
+
const previouslyFocusedRef = useRef(typeof document === 'undefined' ? null : document.activeElement);
|
|
24
|
+
useEffect(() => {
|
|
25
|
+
const previouslyFocused = previouslyFocusedRef.current;
|
|
26
|
+
const panel = panelRef.current;
|
|
27
|
+
if (panel && !panel.contains(document.activeElement)) {
|
|
28
|
+
const first = panel.querySelector(FOCUSABLE_SELECTOR);
|
|
29
|
+
(first ?? panel).focus();
|
|
30
|
+
}
|
|
31
|
+
return () => { previouslyFocused?.focus?.(); };
|
|
32
|
+
}, []);
|
|
33
|
+
useFocusTrap(panelRef);
|
|
34
|
+
return (_jsx("div", { className: cx('page-popup', closing && 'page-popup--closing', className), role: "dialog", "aria-modal": "true", "aria-label": ariaLabel, children: _jsxs("div", { className: "page-popup__panel", ref: panelRef, tabIndex: -1, children: [top && _jsx("div", { className: "page-popup__top", children: top }), _jsx("div", { className: "page-popup__scroll", children: _jsx("div", { className: cx('page-popup__content', mode === 'center' ? 'page-popup__content--center' : 'page-popup__content--top', contentFull && 'page-popup__content--full'), children: children }) }), bottom && _jsx("div", { className: "page-popup__bottom", children: bottom })] }) }));
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* **전체 화면 창이 사라지는 동안의 뒷일** — `PagePopup` 의 짝(말귀 청 (437) ㉰).
|
|
38
|
+
*
|
|
39
|
+
* · **한 번만 닫힌다** — ESC · 닫기 단추 · 안쪽 '완료' 가 잇달아 들어와도 첫 번째만 먹는다(타이머가 여럿 걸려 `onClose` 가 두 번 불리지 않게).
|
|
40
|
+
* · **다 사라진 뒤에 떼어 낸다** — `closing` 을 켜고 `PAGE_POPUP_CLOSE_MS` 기다렸다가 `onClose`. **움직임 줄이기면 0** 이다.
|
|
41
|
+
* · **`onClose` 가 던지면 풀린다** — 안 풀면 닫기 가드가 걸린 채 남아 다시는 못 닫는다(`TrainingPagePopup` 과 같은 고침 — 앱 사본엔 둘 다 없었다).
|
|
42
|
+
* · 떠 있는 동안 뒤 화면 스크롤을 잠근다. 화면을 떠나면 타이머를 끈다.
|
|
43
|
+
* @public
|
|
44
|
+
*/
|
|
45
|
+
export function usePagePopupClose(onClose) {
|
|
46
|
+
const [closing, setClosing] = useState(false);
|
|
47
|
+
const closingRef = useRef(false);
|
|
48
|
+
const timerRef = useRef(null);
|
|
49
|
+
const handleClose = useCallback(() => {
|
|
50
|
+
if (closingRef.current)
|
|
51
|
+
return;
|
|
52
|
+
closingRef.current = true;
|
|
53
|
+
setClosing(true);
|
|
54
|
+
timerRef.current = setTimeout(() => {
|
|
55
|
+
timerRef.current = null;
|
|
56
|
+
/* 던지면 가드를 풀고 남긴다 — `TrainingPagePopup` 의 scheduleClose 와 같다(다시 던지면 타이머 밖이라 아무도 못 잡는다) */
|
|
57
|
+
try {
|
|
58
|
+
onClose();
|
|
59
|
+
}
|
|
60
|
+
catch (e) {
|
|
61
|
+
closingRef.current = false;
|
|
62
|
+
setClosing(false);
|
|
63
|
+
console.error(e);
|
|
64
|
+
}
|
|
65
|
+
}, prefersReducedMotion() ? 0 : PAGE_POPUP_CLOSE_MS);
|
|
66
|
+
}, [onClose]);
|
|
67
|
+
useEffect(() => lockBodyScrollWithPadding(), []);
|
|
68
|
+
useEffect(() => () => { if (timerRef.current)
|
|
69
|
+
clearTimeout(timerRef.current); }, []);
|
|
70
|
+
return { closing, handleClose };
|
|
71
|
+
}
|