@ihabdevteam/core 0.361.0 → 0.362.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 +53 -0
- package/dist/components.cjs.js +9 -9
- package/dist/components.esm.css +1 -1
- package/dist/hooks.cjs.js +1 -1
- package/dist/i18n.cjs.js +1 -1
- package/dist/ihabdevteam-core.cjs.js +185 -185
- package/dist/ihabdevteam-core.d.ts +50 -31
- package/dist/packages/core/src/components/Button.css +19 -0
- package/dist/packages/core/src/components/Button.js +5 -2
- package/dist/packages/core/src/components/buttonTypes.d.ts +16 -0
- package/dist/packages/core/src/utils/chunkSkew.d.ts +32 -30
- package/dist/packages/core/src/utils/chunkSkew.js +68 -2
- package/dist/packages/core/src/utils.d.ts +1 -1
- package/dist/packages/core/src/utils.js +1 -1
- package/dist/packages/core/src/version.d.ts +1 -1
- package/dist/packages/core/src/version.js +1 -1
- package/dist/utils.cjs.js +5 -5
- package/package.json +1 -1
|
@@ -994,6 +994,22 @@ export declare interface ButtonProps {
|
|
|
994
994
|
useDisabledCovered?: boolean;
|
|
995
995
|
/** disabled 시 버튼을 완전히 투명하게 하는 스타일 */
|
|
996
996
|
useDisabledInvisible?: boolean;
|
|
997
|
+
/**
|
|
998
|
+
* 막혔을 때도 **바탕을 가진 꼴** — 말귀 청 (404), 2026-10-25.
|
|
999
|
+
*
|
|
1000
|
+
* 기본 막힌 꼴(`button--variant-disabled`)은 `background-color: transparent` 다. 글 흐름
|
|
1001
|
+
* 안에서는 뒤에 지면밖에 없어 괜찮지만, **떠 있는 단추**(`position: fixed`)에서는 뒤의
|
|
1002
|
+
* 판과 글자가 **단추를 뚫고 보인다.** 말귀 어드민 '정책 관리' 의 저장 단추가 그 자리다
|
|
1003
|
+
* (판이 2,600px 넘어 떠 있지 않으면 끝까지 내려가야 저장할 수 있다).
|
|
1004
|
+
*
|
|
1005
|
+
* **막힌 꼴은 변종을 통째로 갈아 끼운다** — `variant="main"` 을 줘도 막히면
|
|
1006
|
+
* `button--variant-disabled` 가 선다. 그래서 앱이 `variant` 로는 이 자리를 못 푼다.
|
|
1007
|
+
*
|
|
1008
|
+
* 가리는 것(`useDisabledCovered`, 글자까지 투명)과 **다르다** — 이쪽은 글이 그대로
|
|
1009
|
+
* 보이고 바탕만 생긴다. 바탕색은 가리는 꼴이 이미 쓰는 `--color-darkWhite` 다(새 색을
|
|
1010
|
+
* 고르지 않는다 — 색은 사장님 자리다).
|
|
1011
|
+
*/
|
|
1012
|
+
useDisabledFilled?: boolean;
|
|
997
1013
|
width?: number | string;
|
|
998
1014
|
minWidth?: number | string;
|
|
999
1015
|
onClick?: (e: MouseEvent_2<HTMLButtonElement>) => void;
|
|
@@ -1754,7 +1770,7 @@ export declare function copyText(text: string): Promise<boolean>;
|
|
|
1754
1770
|
*
|
|
1755
1771
|
* 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
|
|
1756
1772
|
*/
|
|
1757
|
-
export declare const CORE_VERSION = "0.
|
|
1773
|
+
export declare const CORE_VERSION = "0.362.0";
|
|
1758
1774
|
|
|
1759
1775
|
/** @public */
|
|
1760
1776
|
declare const coreDefault: Record<string, unknown>;
|
|
@@ -3211,6 +3227,39 @@ export declare function installSkewRecovery(): () => void;
|
|
|
3211
3227
|
/** @public 검색어가 초성으로만 이루어졌는지 (예: 'ㅎㅈ' → true, '한' → false) */
|
|
3212
3228
|
export declare function isAllChoseong(search: string): boolean;
|
|
3213
3229
|
|
|
3230
|
+
/**
|
|
3231
|
+
* **낡은 묶음을 못 받은 오류인가** — 말귀 청 (402), 2026-10-25.
|
|
3232
|
+
*
|
|
3233
|
+
* 배포 직후 옛 `index.html` 을 들고 있던 창이 새 조각을 찾다 실패하면 나는 오류들이다.
|
|
3234
|
+
* **브라우저마다 말이 다르다:**
|
|
3235
|
+
*
|
|
3236
|
+
* Chrome Failed to fetch dynamically imported module: …/assets/App-xxxx.js
|
|
3237
|
+
* Firefox error loading dynamically imported module
|
|
3238
|
+
* Safari Importing a module script failed
|
|
3239
|
+
* CSS Unable to preload CSS for /assets/App-xxxx.css (Vite)
|
|
3240
|
+
*
|
|
3241
|
+
* **이 오류는 '다시 시도' 로 안 풀린다.** React 의 `lazy` 는 한 번 거절되면 그 상태로
|
|
3242
|
+
* 굳는다(`_status = 2`) — 경계가 다시 그려도 **같은 거절이 그대로 다시 던져진다.**
|
|
3243
|
+
* 풀리는 길은 새로고침뿐이다(새 `index.html` 을 받아야 새 조각 이름을 안다). 그래서 이
|
|
3244
|
+
* 가름이 맞느냐가 *"사람에게 새로고침을 내미느냐 '다시 시도' 를 내미느냐"* 를 가른다.
|
|
3245
|
+
*
|
|
3246
|
+
* ## 왜 코어가 드나
|
|
3247
|
+
*
|
|
3248
|
+
* 이 셈이 **말귀 회원앱과 어드민에 한 벌씩** 있었다(어드민 쪽은 2026-10-24 에 생겼다 —
|
|
3249
|
+
* 어드민 오류 경계에 이 가지가 없어 낡은 묶음에 사람이 갇히고 있었다). 두 앱은 번들이
|
|
3250
|
+
* 갈려 서로의 `src/` 를 못 끌어 쓴다.
|
|
3251
|
+
*
|
|
3252
|
+
* **사본이 갈라지면 조용히 아프다** — 새 브라우저가 새 말투를 내서 한쪽만 더하면, 다른
|
|
3253
|
+
* 앱은 그 오류를 낡은 묶음으로 **못 알아보고 '다시 시도' 만 내밀어** 사람을 가둔다.
|
|
3254
|
+
* 굳은 `lazy` 는 다시 그려도 같은 거절을 던지니까.
|
|
3255
|
+
*
|
|
3256
|
+
* **`recoverFromSkew` 와 한 몸이다** — 복구하는 자는 이미 여기 있는데 *"이게 그 오류인가"*
|
|
3257
|
+
* 를 가리는 자만 밖에 있었다. 새 말투가 생기면 **한 곳만** 고친다.
|
|
3258
|
+
*
|
|
3259
|
+
* @public
|
|
3260
|
+
*/
|
|
3261
|
+
export declare function isChunkLoadError(error: unknown): boolean;
|
|
3262
|
+
|
|
3214
3263
|
/**
|
|
3215
3264
|
* @public 티어가 매니저 줄(말귀매니저)인지. `none` 과 개인 줄(free·personal_standard)은 false.
|
|
3216
3265
|
*
|
|
@@ -6090,36 +6139,6 @@ export declare interface Recommendation {
|
|
|
6090
6139
|
*/
|
|
6091
6140
|
export declare function recommendTables(tables: readonly TableCandidate[], weakLabels: readonly string[], limit?: number): Recommendation[];
|
|
6092
6141
|
|
|
6093
|
-
/**
|
|
6094
|
-
* 배포 skew 복구 — 그리고 그 복구가 내던 오류 화면.
|
|
6095
|
-
*
|
|
6096
|
-
* ── 무엇이 문제였나 ──
|
|
6097
|
-
* 새 배포로 청크 해시가 바뀌면 캐시된 옛 index.html 이 사라진 청크를 부른다. Vite 는
|
|
6098
|
-
* `vite:preloadError` 를 던지고, 우리는 그때 한 번 새로고침해 새 index.html 을 받는다.
|
|
6099
|
-
* 여기까지는 뜻대로 돈다.
|
|
6100
|
-
*
|
|
6101
|
-
* 그런데 그 이벤트를 `preventDefault()` 하면 Vite 헬퍼가 이렇게 한다(vite 소스 그대로):
|
|
6102
|
-
*
|
|
6103
|
-
* function handlePreloadError(err) {
|
|
6104
|
-
* const e = new Event('vite:preloadError', { cancelable: true })
|
|
6105
|
-
* window.dispatchEvent(e)
|
|
6106
|
-
* if (!e.defaultPrevented) throw err // ← 막으면 안 던진다
|
|
6107
|
-
* }
|
|
6108
|
-
* return baseModule().catch(handlePreloadError) // ← 안 던지니 undefined 로 resolve
|
|
6109
|
-
*
|
|
6110
|
-
* **`location.reload()` 는 곧바로 멈추지 않는다.** 새 판이 뜨기 전까지 React 는 계속
|
|
6111
|
-
* 그리고, `React.lazy` 는 resolve 된 `undefined` 의 `.default` 를 읽는다 —
|
|
6112
|
-
* `Cannot read properties of undefined (reading 'default')`. 운영에서 이 오류가
|
|
6113
|
-
* 07-09 ~ 08-28 동안 **아홉 사람에게 열세 번** 났다(/today·/customers·/my-word-table·
|
|
6114
|
-
* /word-pairs·/word-management·/training-store — 스택은 전부 vendor-react 의 lazy 초기화).
|
|
6115
|
-
*
|
|
6116
|
-
* 즉 복구는 되는데 그 길목에서 **오류 화면을 한 번 띄우고 가짜 보고를 남기고** 있었다.
|
|
6117
|
-
*
|
|
6118
|
-
* ── 어떻게 고치나 ──
|
|
6119
|
-
* 새로고침을 걸어 둔 동안에는 `lazy` 가 아무것도 결정하지 않게 한다(`lazyPage` 가
|
|
6120
|
-
* 영영 resolve 하지 않는 약속을 돌려 Suspense 를 그대로 둔다). 그러려면 "지금 새로고침이
|
|
6121
|
-
* 예약돼 있나"를 물을 수 있어야 해서, 그 판단을 여기 한 곳에 둔다.
|
|
6122
|
-
*/
|
|
6123
6142
|
/**
|
|
6124
6143
|
* 배포 skew 로 판단되면 1회만 새로고침해 새 index.html 을 받는다.
|
|
6125
6144
|
* 앱이 `vite:preloadError`(또는 청크 로드 실패)를 받았을 때 부른다.
|
|
@@ -400,6 +400,25 @@
|
|
|
400
400
|
color: var(--color-disabled);
|
|
401
401
|
}
|
|
402
402
|
|
|
403
|
+
/* **떠 있는 단추의 막힌 꼴**(말귀 청 (404), 2026-10-25) — 위 기본 막힌 꼴은 바탕이
|
|
404
|
+
`transparent` 라 `position: fixed` 자리에서 **뒤의 판·글자가 단추를 뚫고 보인다.**
|
|
405
|
+
글은 그대로 두고 바탕만 깐다. 색은 가리는 꼴(`disabled-covered`)이 이미 쓰는 것을
|
|
406
|
+
그대로 쓴다 — 새 색을 고르지 않는다. */
|
|
407
|
+
.button--variant-disabled-filled
|
|
408
|
+
{
|
|
409
|
+
border: var(--button-border, 1px solid var(--color-whiteLine));
|
|
410
|
+
color: var(--color-disabled);
|
|
411
|
+
--button-subLabel-color: var(--color-disabled);
|
|
412
|
+
background-color: var(--color-darkWhite);
|
|
413
|
+
}
|
|
414
|
+
|
|
415
|
+
.button--variant-disabled-filled .button__icon,
|
|
416
|
+
.button--variant-disabled-filled .button__left,
|
|
417
|
+
.button--variant-disabled-filled .button__right
|
|
418
|
+
{
|
|
419
|
+
color: var(--color-disabled);
|
|
420
|
+
}
|
|
421
|
+
|
|
403
422
|
|
|
404
423
|
|
|
405
424
|
/* **가려진 단추에는 테두리 선이 안 보인다**(말귀 요청 (88), 사용자 결정 2026-10-06 —
|
|
@@ -11,7 +11,7 @@ import { isTouchPointer, recentlyTouched, useTouchToggle } from '../hooks/touchT
|
|
|
11
11
|
/* **ref 는 forwardRef 로 받는다** — React 19 는 ref 를 props 로 넘기지만 peer 는 16.8~ 라, React 18(kscan) 에서는 함수 컴포넌트에 준
|
|
12
12
|
ref 가 버려진다. 게다가 전에는 안쪽 ref(`btnRef`)가 props 에서 온 ref 를 덮어써 19 에서도 부르는 쪽 ref 가 비었다. 두 ref 를 잇는다. */
|
|
13
13
|
function ButtonInner(props, forwardedRef) {
|
|
14
|
-
const { size = 48, type: explicitType, htmlType, href, target, rel, icon, rightIcon, label: labelProp, count, subLabel, children, ariaLabel, variant = 'default', align = 'center', nowrap = false, selected, toggleable = false, ariaExpanded, ariaControls, disabled = false, useLabel = true, useBorder = true, useBG = true, useDisabledCovered = false, useDisabledInvisible = false, width, minWidth, onClick, onDisabledClick, showTooltipInfo = false, tooltipInfoText = null, tooltipDescription = null, tooltipOnly = false, iconSize = 'medium', iconColor, shape = 'rounded', color, className, ...rest } = props;
|
|
14
|
+
const { size = 48, type: explicitType, htmlType, href, target, rel, icon, rightIcon, label: labelProp, count, subLabel, children, ariaLabel, variant = 'default', align = 'center', nowrap = false, selected, toggleable = false, ariaExpanded, ariaControls, disabled = false, useLabel = true, useBorder = true, useBG = true, useDisabledCovered = false, useDisabledInvisible = false, useDisabledFilled = false, width, minWidth, onClick, onDisabledClick, showTooltipInfo = false, tooltipInfoText = null, tooltipDescription = null, tooltipOnly = false, iconSize = 'medium', iconColor, shape = 'rounded', color, className, ...rest } = props;
|
|
15
15
|
const sizeKey = typeof size === 'string' && isNaN(Number(size))
|
|
16
16
|
? size.toLowerCase()
|
|
17
17
|
: String(Number(size) || 48);
|
|
@@ -22,10 +22,13 @@ function ButtonInner(props, forwardedRef) {
|
|
|
22
22
|
// label prop 우선, 없으면 children으로 fallback
|
|
23
23
|
const label = labelProp ?? children;
|
|
24
24
|
const disabledProp = disabled || Boolean(rest.disabled);
|
|
25
|
+
/* 막힌 꼴 넷 — **가리기·안 보이기가 먼저**다(둘은 단추를 아예 안 보이게 하므로
|
|
26
|
+
바탕을 깔라는 말과 함께 오면 안 보이게 하는 쪽이 뜻이 세다). (404) */
|
|
25
27
|
const effectiveVariant = disabledProp
|
|
26
28
|
? useDisabledCovered ? 'disabled-covered'
|
|
27
29
|
: useDisabledInvisible ? 'disabled-invisibled'
|
|
28
|
-
: 'disabled'
|
|
30
|
+
: useDisabledFilled ? 'disabled-filled'
|
|
31
|
+
: 'disabled'
|
|
29
32
|
: variant;
|
|
30
33
|
const variantClass = effectiveVariant ? `button--variant-${effectiveVariant}` : '';
|
|
31
34
|
const alignClass = align ? `button--align-${align}` : '';
|
|
@@ -98,6 +98,22 @@ export interface ButtonProps {
|
|
|
98
98
|
useDisabledCovered?: boolean;
|
|
99
99
|
/** disabled 시 버튼을 완전히 투명하게 하는 스타일 */
|
|
100
100
|
useDisabledInvisible?: boolean;
|
|
101
|
+
/**
|
|
102
|
+
* 막혔을 때도 **바탕을 가진 꼴** — 말귀 청 (404), 2026-10-25.
|
|
103
|
+
*
|
|
104
|
+
* 기본 막힌 꼴(`button--variant-disabled`)은 `background-color: transparent` 다. 글 흐름
|
|
105
|
+
* 안에서는 뒤에 지면밖에 없어 괜찮지만, **떠 있는 단추**(`position: fixed`)에서는 뒤의
|
|
106
|
+
* 판과 글자가 **단추를 뚫고 보인다.** 말귀 어드민 '정책 관리' 의 저장 단추가 그 자리다
|
|
107
|
+
* (판이 2,600px 넘어 떠 있지 않으면 끝까지 내려가야 저장할 수 있다).
|
|
108
|
+
*
|
|
109
|
+
* **막힌 꼴은 변종을 통째로 갈아 끼운다** — `variant="main"` 을 줘도 막히면
|
|
110
|
+
* `button--variant-disabled` 가 선다. 그래서 앱이 `variant` 로는 이 자리를 못 푼다.
|
|
111
|
+
*
|
|
112
|
+
* 가리는 것(`useDisabledCovered`, 글자까지 투명)과 **다르다** — 이쪽은 글이 그대로
|
|
113
|
+
* 보이고 바탕만 생긴다. 바탕색은 가리는 꼴이 이미 쓰는 `--color-darkWhite` 다(새 색을
|
|
114
|
+
* 고르지 않는다 — 색은 사장님 자리다).
|
|
115
|
+
*/
|
|
116
|
+
useDisabledFilled?: boolean;
|
|
101
117
|
width?: number | string;
|
|
102
118
|
minWidth?: number | string;
|
|
103
119
|
onClick?: (e: MouseEvent<HTMLButtonElement>) => void;
|
|
@@ -1,33 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 배포 skew 복구 — 그리고 그 복구가 내던 오류 화면.
|
|
3
|
-
*
|
|
4
|
-
* ── 무엇이 문제였나 ──
|
|
5
|
-
* 새 배포로 청크 해시가 바뀌면 캐시된 옛 index.html 이 사라진 청크를 부른다. Vite 는
|
|
6
|
-
* `vite:preloadError` 를 던지고, 우리는 그때 한 번 새로고침해 새 index.html 을 받는다.
|
|
7
|
-
* 여기까지는 뜻대로 돈다.
|
|
8
|
-
*
|
|
9
|
-
* 그런데 그 이벤트를 `preventDefault()` 하면 Vite 헬퍼가 이렇게 한다(vite 소스 그대로):
|
|
10
|
-
*
|
|
11
|
-
* function handlePreloadError(err) {
|
|
12
|
-
* const e = new Event('vite:preloadError', { cancelable: true })
|
|
13
|
-
* window.dispatchEvent(e)
|
|
14
|
-
* if (!e.defaultPrevented) throw err // ← 막으면 안 던진다
|
|
15
|
-
* }
|
|
16
|
-
* return baseModule().catch(handlePreloadError) // ← 안 던지니 undefined 로 resolve
|
|
17
|
-
*
|
|
18
|
-
* **`location.reload()` 는 곧바로 멈추지 않는다.** 새 판이 뜨기 전까지 React 는 계속
|
|
19
|
-
* 그리고, `React.lazy` 는 resolve 된 `undefined` 의 `.default` 를 읽는다 —
|
|
20
|
-
* `Cannot read properties of undefined (reading 'default')`. 운영에서 이 오류가
|
|
21
|
-
* 07-09 ~ 08-28 동안 **아홉 사람에게 열세 번** 났다(/today·/customers·/my-word-table·
|
|
22
|
-
* /word-pairs·/word-management·/training-store — 스택은 전부 vendor-react 의 lazy 초기화).
|
|
23
|
-
*
|
|
24
|
-
* 즉 복구는 되는데 그 길목에서 **오류 화면을 한 번 띄우고 가짜 보고를 남기고** 있었다.
|
|
25
|
-
*
|
|
26
|
-
* ── 어떻게 고치나 ──
|
|
27
|
-
* 새로고침을 걸어 둔 동안에는 `lazy` 가 아무것도 결정하지 않게 한다(`lazyPage` 가
|
|
28
|
-
* 영영 resolve 하지 않는 약속을 돌려 Suspense 를 그대로 둔다). 그러려면 "지금 새로고침이
|
|
29
|
-
* 예약돼 있나"를 물을 수 있어야 해서, 그 판단을 여기 한 곳에 둔다.
|
|
30
|
-
*/
|
|
31
1
|
/**
|
|
32
2
|
* 배포 skew 로 판단되면 1회만 새로고침해 새 index.html 을 받는다.
|
|
33
3
|
* 앱이 `vite:preloadError`(또는 청크 로드 실패)를 받았을 때 부른다.
|
|
@@ -70,3 +40,35 @@ export declare function skewReloadPending(now?: number): boolean;
|
|
|
70
40
|
* @public
|
|
71
41
|
*/
|
|
72
42
|
export declare function installSkewRecovery(): () => void;
|
|
43
|
+
/**
|
|
44
|
+
* **낡은 묶음을 못 받은 오류인가** — 말귀 청 (402), 2026-10-25.
|
|
45
|
+
*
|
|
46
|
+
* 배포 직후 옛 `index.html` 을 들고 있던 창이 새 조각을 찾다 실패하면 나는 오류들이다.
|
|
47
|
+
* **브라우저마다 말이 다르다:**
|
|
48
|
+
*
|
|
49
|
+
* Chrome Failed to fetch dynamically imported module: …/assets/App-xxxx.js
|
|
50
|
+
* Firefox error loading dynamically imported module
|
|
51
|
+
* Safari Importing a module script failed
|
|
52
|
+
* CSS Unable to preload CSS for /assets/App-xxxx.css (Vite)
|
|
53
|
+
*
|
|
54
|
+
* **이 오류는 '다시 시도' 로 안 풀린다.** React 의 `lazy` 는 한 번 거절되면 그 상태로
|
|
55
|
+
* 굳는다(`_status = 2`) — 경계가 다시 그려도 **같은 거절이 그대로 다시 던져진다.**
|
|
56
|
+
* 풀리는 길은 새로고침뿐이다(새 `index.html` 을 받아야 새 조각 이름을 안다). 그래서 이
|
|
57
|
+
* 가름이 맞느냐가 *"사람에게 새로고침을 내미느냐 '다시 시도' 를 내미느냐"* 를 가른다.
|
|
58
|
+
*
|
|
59
|
+
* ## 왜 코어가 드나
|
|
60
|
+
*
|
|
61
|
+
* 이 셈이 **말귀 회원앱과 어드민에 한 벌씩** 있었다(어드민 쪽은 2026-10-24 에 생겼다 —
|
|
62
|
+
* 어드민 오류 경계에 이 가지가 없어 낡은 묶음에 사람이 갇히고 있었다). 두 앱은 번들이
|
|
63
|
+
* 갈려 서로의 `src/` 를 못 끌어 쓴다.
|
|
64
|
+
*
|
|
65
|
+
* **사본이 갈라지면 조용히 아프다** — 새 브라우저가 새 말투를 내서 한쪽만 더하면, 다른
|
|
66
|
+
* 앱은 그 오류를 낡은 묶음으로 **못 알아보고 '다시 시도' 만 내밀어** 사람을 가둔다.
|
|
67
|
+
* 굳은 `lazy` 는 다시 그려도 같은 거절을 던지니까.
|
|
68
|
+
*
|
|
69
|
+
* **`recoverFromSkew` 와 한 몸이다** — 복구하는 자는 이미 여기 있는데 *"이게 그 오류인가"*
|
|
70
|
+
* 를 가리는 자만 밖에 있었다. 새 말투가 생기면 **한 곳만** 고친다.
|
|
71
|
+
*
|
|
72
|
+
* @public
|
|
73
|
+
*/
|
|
74
|
+
export declare function isChunkLoadError(error: unknown): boolean;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { getErrorMessage } from './errorMessage';
|
|
1
2
|
/**
|
|
2
3
|
* 배포 skew 복구 — 그리고 그 복구가 내던 오류 화면.
|
|
3
4
|
*
|
|
@@ -97,13 +98,35 @@ export function skewReloadPending(now = Date.now()) {
|
|
|
97
98
|
export function installSkewRecovery() {
|
|
98
99
|
if (typeof window === 'undefined')
|
|
99
100
|
return () => { };
|
|
100
|
-
|
|
101
|
+
/**
|
|
102
|
+
* **이 판에서 새로고침을 이미 걸었나** — 말귀 청 (401), 2026-10-25.
|
|
103
|
+
*
|
|
104
|
+
* 듣는 이가 **둘인데 10초 막이는 하나**다. CSS 청크가 깨지면 `link` 의 `error` 가
|
|
105
|
+
* **캡처 단계**라 `onStyleError` 가 먼저 돌아 `recoverFromSkew()` 를 **써 버리고**,
|
|
106
|
+
* 뒤이은 `onChunkError` 는 `false` 를 받아 `preventDefault()` 를 못 했다. 그러면
|
|
107
|
+
* Vite 헬퍼가 오류를 다시 던져 → `lazy` → 오류 경계 → **가짜 보고가 하나** 남는다.
|
|
108
|
+
* 사람은 복구되는데(새로고침은 걸린다) **보고 쪽만 샜다** — 운영 보고에 `Unable to
|
|
109
|
+
* preload CSS for …` 가 그대로 쌓여 있었다(말귀 실측 2026-10-24).
|
|
110
|
+
*
|
|
111
|
+
* **`skewReloadPending()` 을 쓰면 안 된다.** 그것은 `sessionStorage` 를 보므로
|
|
112
|
+
* **새로고침 뒤에도 10초 동안 참**이다 — *"새로고침했는데 새 조각도 아직 CDN 에 안
|
|
113
|
+
* 퍼져 8초 뒤 또 실패"* 하는 참 오류까지 삼켜 사람이 빈 화면에 갇힌다. 이 깃발은
|
|
114
|
+
* **판마다 새로 나므로** 그 건은 그대로 던진다(새 판 = 새 `install` = 깃발 거짓).
|
|
115
|
+
*/
|
|
116
|
+
let reloadedThisPage = false;
|
|
117
|
+
const markReload = () => {
|
|
118
|
+
const ok = recoverFromSkew();
|
|
119
|
+
if (ok)
|
|
120
|
+
reloadedThisPage = true;
|
|
121
|
+
return ok;
|
|
122
|
+
};
|
|
123
|
+
const onChunkError = (e) => { if (markReload() || reloadedThisPage)
|
|
101
124
|
e.preventDefault(); };
|
|
102
125
|
/* 스타일시트만 본다 — 그림 하나가 깨졌다고 판을 새로 받으면 안 된다 */
|
|
103
126
|
const onStyleError = (e) => {
|
|
104
127
|
const el = e.target;
|
|
105
128
|
if (el instanceof HTMLLinkElement && el.rel === 'stylesheet')
|
|
106
|
-
|
|
129
|
+
markReload();
|
|
107
130
|
};
|
|
108
131
|
window.addEventListener('vite:preloadError', onChunkError);
|
|
109
132
|
window.addEventListener('error', onStyleError, true);
|
|
@@ -112,3 +135,46 @@ export function installSkewRecovery() {
|
|
|
112
135
|
window.removeEventListener('error', onStyleError, true);
|
|
113
136
|
};
|
|
114
137
|
}
|
|
138
|
+
/**
|
|
139
|
+
* **낡은 묶음을 못 받은 오류인가** — 말귀 청 (402), 2026-10-25.
|
|
140
|
+
*
|
|
141
|
+
* 배포 직후 옛 `index.html` 을 들고 있던 창이 새 조각을 찾다 실패하면 나는 오류들이다.
|
|
142
|
+
* **브라우저마다 말이 다르다:**
|
|
143
|
+
*
|
|
144
|
+
* Chrome Failed to fetch dynamically imported module: …/assets/App-xxxx.js
|
|
145
|
+
* Firefox error loading dynamically imported module
|
|
146
|
+
* Safari Importing a module script failed
|
|
147
|
+
* CSS Unable to preload CSS for /assets/App-xxxx.css (Vite)
|
|
148
|
+
*
|
|
149
|
+
* **이 오류는 '다시 시도' 로 안 풀린다.** React 의 `lazy` 는 한 번 거절되면 그 상태로
|
|
150
|
+
* 굳는다(`_status = 2`) — 경계가 다시 그려도 **같은 거절이 그대로 다시 던져진다.**
|
|
151
|
+
* 풀리는 길은 새로고침뿐이다(새 `index.html` 을 받아야 새 조각 이름을 안다). 그래서 이
|
|
152
|
+
* 가름이 맞느냐가 *"사람에게 새로고침을 내미느냐 '다시 시도' 를 내미느냐"* 를 가른다.
|
|
153
|
+
*
|
|
154
|
+
* ## 왜 코어가 드나
|
|
155
|
+
*
|
|
156
|
+
* 이 셈이 **말귀 회원앱과 어드민에 한 벌씩** 있었다(어드민 쪽은 2026-10-24 에 생겼다 —
|
|
157
|
+
* 어드민 오류 경계에 이 가지가 없어 낡은 묶음에 사람이 갇히고 있었다). 두 앱은 번들이
|
|
158
|
+
* 갈려 서로의 `src/` 를 못 끌어 쓴다.
|
|
159
|
+
*
|
|
160
|
+
* **사본이 갈라지면 조용히 아프다** — 새 브라우저가 새 말투를 내서 한쪽만 더하면, 다른
|
|
161
|
+
* 앱은 그 오류를 낡은 묶음으로 **못 알아보고 '다시 시도' 만 내밀어** 사람을 가둔다.
|
|
162
|
+
* 굳은 `lazy` 는 다시 그려도 같은 거절을 던지니까.
|
|
163
|
+
*
|
|
164
|
+
* **`recoverFromSkew` 와 한 몸이다** — 복구하는 자는 이미 여기 있는데 *"이게 그 오류인가"*
|
|
165
|
+
* 를 가리는 자만 밖에 있었다. 새 말투가 생기면 **한 곳만** 고친다.
|
|
166
|
+
*
|
|
167
|
+
* @public
|
|
168
|
+
*/
|
|
169
|
+
export function isChunkLoadError(error) {
|
|
170
|
+
/* 원인 꺼내기는 한 벌(`getErrorMessage`) — `instanceof Error` 로 가르면 평범한 객체로
|
|
171
|
+
오는 원인이 사라진다(`errorCauseSingleSource` 못이 그것을 센다). */
|
|
172
|
+
if (error == null)
|
|
173
|
+
return false;
|
|
174
|
+
return CHUNK_LOAD_PATTERNS.test(getErrorMessage(error));
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* 위가 보는 말투들. **하나로 두는 까닭** — 새 브라우저가 새 말투를 내면 고칠 자리가
|
|
178
|
+
* 여기 하나다. `g` 를 안 붙인다(`lastIndex` 가 남아 **두 번째 부름이 거짓이 된다**).
|
|
179
|
+
*/
|
|
180
|
+
const CHUNK_LOAD_PATTERNS = /Failed to fetch dynamically imported module|error loading dynamically imported module|Importing a module script failed|Unable to preload CSS/i;
|
|
@@ -58,7 +58,7 @@ export { wordContainsChoseong, wordContainsJungseong, wordContainsJongseong, wor
|
|
|
58
58
|
export { isSyllablePattern, matchesSyllablePattern, validateSyllableSearchInput, patternToComposition, matchesWordQuery, searchAndRankWords } from './utils/koreanSyllable';
|
|
59
59
|
export { PLAN_FEATURES, PLAN_LIMITS, TIER_RANK, getPlanTier, isManagerTier, type PlanTier, type DataLevel, type PlanFeatures, type PlanLimits, } from './utils/planFeatures';
|
|
60
60
|
export { WORD_SUGGESTION_WEEKLY_QUOTA, WORD_SUGGESTION_ACCOUNT_LIMIT, WORD_SUGGESTION_EXISTING_ERROR, isThisWeekPick, } from './utils/wordSuggestionPolicy';
|
|
61
|
-
export { recoverFromSkew, skewReloadPending, installSkewRecovery } from './utils/chunkSkew';
|
|
61
|
+
export { recoverFromSkew, skewReloadPending, installSkewRecovery, isChunkLoadError } from './utils/chunkSkew';
|
|
62
62
|
export { isSessionForThisTab } from './utils/sessionTab';
|
|
63
63
|
export type { TabSessionLike } from './utils/sessionTab';
|
|
64
64
|
export { lazyPage } from './utils/lazyPage';
|
|
@@ -48,7 +48,7 @@ export { PLAN_FEATURES, PLAN_LIMITS, TIER_RANK, getPlanTier, isManagerTier, } fr
|
|
|
48
48
|
말귀어드민(단어 제안 관리)이 같은 숫자를 봐야 하는데, 한쪽 화면 폴더에 두면
|
|
49
49
|
다른 쪽이 그 폴더 없이는 빌드되지 않는다. 값과 순수 함수뿐이다. */
|
|
50
50
|
export { WORD_SUGGESTION_WEEKLY_QUOTA, WORD_SUGGESTION_ACCOUNT_LIMIT, WORD_SUGGESTION_EXISTING_ERROR, isThisWeekPick, } from './utils/wordSuggestionPolicy';
|
|
51
|
-
export { recoverFromSkew, skewReloadPending, installSkewRecovery } from './utils/chunkSkew';
|
|
51
|
+
export { recoverFromSkew, skewReloadPending, installSkewRecovery, isChunkLoadError } from './utils/chunkSkew';
|
|
52
52
|
export { isSessionForThisTab } from './utils/sessionTab';
|
|
53
53
|
export { lazyPage } from './utils/lazyPage';
|
|
54
54
|
export { prefetchChunk } from './utils/prefetchChunk';
|