@ihabdevteam/core 0.428.0 → 0.430.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 (66) hide show
  1. package/CHANGELOG.md +90 -0
  2. package/dist/components.cjs.js +173 -173
  3. package/dist/components.esm.css +2 -2
  4. package/dist/hooks.cjs.js +5 -5
  5. package/dist/i18n.cjs.js +3 -3
  6. package/dist/ihabdevteam-core-tokens.css +1 -1
  7. package/dist/ihabdevteam-core.cjs.js +189 -189
  8. package/dist/ihabdevteam-core.css +1 -1
  9. package/dist/ihabdevteam-core.d.ts +22 -1
  10. package/dist/logo/Logo_SCL_en.svg +1 -0
  11. package/dist/logo/Logo_SCL_en_mono.svg +1 -0
  12. package/dist/logo/Logo_SCL_ko.svg +1 -0
  13. package/dist/logo/Logo_SCL_ko_mono.svg +1 -0
  14. package/dist/logo/Logo_SC_en.svg +1 -0
  15. package/dist/logo/Logo_SC_en_mono.svg +1 -0
  16. package/dist/logo/Logo_SC_ko.svg +1 -0
  17. package/dist/logo/Logo_SC_ko_mono.svg +1 -0
  18. package/dist/logo/{Symbol_SL.svg → Symbol_SC.svg} +1 -1
  19. package/dist/logo/{Symbol_SL_mono.svg → Symbol_SC_mono.svg} +1 -1
  20. package/dist/packages/core/src/components/BarChart.css +8 -0
  21. package/dist/packages/core/src/components/Button.css +17 -0
  22. package/dist/packages/core/src/components/ChartSection.css +8 -0
  23. package/dist/packages/core/src/components/Footer.css +2 -2
  24. package/dist/packages/core/src/components/Header.css +3 -3
  25. package/dist/packages/core/src/components/Header.js +2 -1
  26. package/dist/packages/core/src/components/PassCard/PassCard.css +56 -12
  27. package/dist/packages/core/src/components/ProgressIndicator.css +22 -0
  28. package/dist/packages/core/src/components/SideNav.css +13 -0
  29. package/dist/packages/core/src/components/Slider.css +9 -0
  30. package/dist/packages/core/src/components/Toggle.css +20 -0
  31. package/dist/packages/core/src/components/TopBanner.css +18 -0
  32. package/dist/packages/core/src/components/Training/TrainingBlockButton.css +83 -0
  33. package/dist/packages/core/src/components/Training/TrainingStepBullet.css +18 -0
  34. package/dist/packages/core/src/hooks/useWordTrainingFilter.js +14 -5
  35. package/dist/packages/core/src/hooks/wordTrainingFilterSections.js +1 -1
  36. package/dist/packages/core/src/i18n/locales/en.json +2 -2
  37. package/dist/packages/core/src/i18n/locales/ko.json +1 -1
  38. package/dist/packages/core/src/logo/Logo_SCL_en.svg +1 -0
  39. package/dist/packages/core/src/logo/Logo_SCL_en_mono.svg +1 -0
  40. package/dist/packages/core/src/logo/Logo_SCL_ko.svg +1 -0
  41. package/dist/packages/core/src/logo/Logo_SCL_ko_mono.svg +1 -0
  42. package/dist/packages/core/src/logo/Logo_SC_en.svg +1 -0
  43. package/dist/packages/core/src/logo/Logo_SC_en_mono.svg +1 -0
  44. package/dist/packages/core/src/logo/Logo_SC_ko.svg +1 -0
  45. package/dist/packages/core/src/logo/Logo_SC_ko_mono.svg +1 -0
  46. package/dist/packages/core/src/logo/{Symbol_SL.svg → Symbol_SC.svg} +1 -1
  47. package/dist/packages/core/src/logo/{Symbol_SL_mono.svg → Symbol_SC_mono.svg} +1 -1
  48. package/dist/packages/core/src/tokens.css +309 -0
  49. package/dist/packages/core/src/utils/contrast.d.ts +18 -0
  50. package/dist/packages/core/src/utils/contrast.js +47 -0
  51. package/dist/packages/core/src/utils/wordAttributeFilterCodes.d.ts +22 -0
  52. package/dist/packages/core/src/utils/wordAttributeFilterCodes.js +72 -1
  53. package/dist/packages/core/src/utils.d.ts +1 -0
  54. package/dist/packages/core/src/utils.js +1 -0
  55. package/dist/packages/core/src/version.d.ts +1 -1
  56. package/dist/packages/core/src/version.js +1 -1
  57. package/dist/utils.cjs.js +165 -165
  58. package/package.json +1 -1
  59. /package/dist/logo/{Logo_SL_en.svg → old/Logo_SL_en.svg} +0 -0
  60. /package/dist/logo/{Logo_SL_en_mono.svg → old/Logo_SL_en_mono.svg} +0 -0
  61. /package/dist/logo/{Logo_SL_ko.svg → old/Logo_SL_ko.svg} +0 -0
  62. /package/dist/logo/{Logo_SL_ko_mono.svg → old/Logo_SL_ko_mono.svg} +0 -0
  63. /package/dist/packages/core/src/logo/{Logo_SL_en.svg → old/Logo_SL_en.svg} +0 -0
  64. /package/dist/packages/core/src/logo/{Logo_SL_en_mono.svg → old/Logo_SL_en_mono.svg} +0 -0
  65. /package/dist/packages/core/src/logo/{Logo_SL_ko.svg → old/Logo_SL_ko.svg} +0 -0
  66. /package/dist/packages/core/src/logo/{Logo_SL_ko_mono.svg → old/Logo_SL_ko_mono.svg} +0 -0
@@ -19,6 +19,9 @@
19
19
  ══════════════════════════════════════════════════════════ */
20
20
 
21
21
  :root {
22
+ /* 곁줄(왼쪽 레일) 폭. 글자 크기에 따라 넓어진다 — 아래 data-font-scale 블록.
23
+ 앱이 본문을 레일만큼 밀 때도 이 값을 읽는다(`padding-left: var(--side-nav-width, 220px)`). */
24
+ --side-nav-width: 220px;
22
25
  /* 브라우저 기본 UI(달력 팝업·시간 스피너·스크롤바·자동완성)의 명암을 테마와 맞춘다.
23
26
  선언이 없으면 브라우저는 항상 라이트로 그린다 — 다크 모드에서 방문 일시 입력
24
27
  (VisitsPage의 datetime-local)의 달력이 흰 배경으로 떠 혼자 튄다. */
@@ -347,6 +350,7 @@
347
350
  반드시 위 미디어쿼리 블록보다 뒤에 와야 글자 크기 설정이 이긴다. */
348
351
 
349
352
  [data-font-scale="large1"] {
353
+ --side-nav-width: 232px;
350
354
  --text-h4-size: 19px; --text-h4-line: 29px;
351
355
  --text-h5-size: 17px; --text-h5-line: 26px;
352
356
  --text-body-1-size: 20px; --text-body-1-line: 31px;
@@ -359,6 +363,7 @@
359
363
  }
360
364
 
361
365
  [data-font-scale="large2"] {
366
+ --side-nav-width: 236px;
362
367
  --text-h4-size: 21px; --text-h4-line: 32px;
363
368
  --text-h5-size: 19px; --text-h5-line: 29px;
364
369
  --text-body-1-size: 23px; --text-body-1-line: 36px;
@@ -371,6 +376,7 @@
371
376
  }
372
377
 
373
378
  [data-font-scale="large3"] {
379
+ --side-nav-width: 244px;
374
380
  --text-h4-size: 23px; --text-h4-line: 35px;
375
381
  --text-h5-size: 21px; --text-h5-line: 32px;
376
382
  --text-body-1-size: 25px; --text-body-1-line: 39px;
@@ -384,6 +390,57 @@
384
390
 
385
391
  /* ── 다크 모드 ────────────────────────────────────────────────────────── */
386
392
  /* 수동 설정: data-theme="dark" */
393
+ /* ── 고대비 (data-contrast="more") ─────────────────────────────────────────────
394
+ **말귀 청 (393).** 앱 설정의 고대비 스위치가 `<html data-contrast="more">` 를 단다(테마와 따로 서서
395
+ 라이트·다크·자동에 겹친다). 기본은 꺼짐이라 **안 켠 사람의 화면은 한 픽셀도 안 바뀐다.**
396
+ OS 의 `prefers-contrast: more` 도 같은 값을 탄다(사장님 결정 2026-11-11) — 아래 따로 둔 블록.
397
+
398
+ 기준: 글 4.5:1 · 테두리 3:1 이상. 밝은 꼴 실측 낮은 대비(앱, 2026-11-11): 파란 단추 흰 글자 2.96 ·
399
+ 바닥글 2.42 · 회색 설명 2.48 · 수 배지 2.63.
400
+
401
+ | 토큰 | 보통 | 고대비 | 대비 |
402
+ |---|---|---|---|
403
+ | main (흰 글자 얹음) | #499cdf 2.96 | #2a6db0 | 5.37 |
404
+ | sub (흰 글자 얹음) | #4dcdc0 | #257e76 | 4.86 |
405
+ | lightGray (deepWhite 위) | #96a4b8 2.48 | #5f6b7a | 5.19 |
406
+ | gray (darkWhite 위) | #64748b | #434d56 | 7.67 |
407
+ | whiteLine (테두리) | #dde3ec | #7b8798 | 3.6 |
408
+ | error · success · infoLink | 3.9 · 2.8 · 4.0 | #b52f2b · #1d7a6e · #1f62a8 | 6.05 · 5.07 · 6.11 |
409
+
410
+ **간접 토큰도 다시 적는다** — `var(--color-X)` 로 적힌 것은 선언한 원소에서 값이 굳는다(다크 블록과 같은 함정).
411
+ 이 블록은 **다크 블록들보다 앞에** 둔다 — 같은 원소에 두 속성이 다 달리면 특이도가 같아 뒤엣것이 이긴다.
412
+ 다크 + 고대비는 아래 `[data-theme="dark"][data-contrast="more"]` 가 더 센 특이도로 받는다. */
413
+ [data-contrast="more"] {
414
+ --color-main: #2a6db0;
415
+ --color-deepMain: #1e5a8f;
416
+ --color-darkMain: #164a78;
417
+ --color-sub: #257e76;
418
+ --color-deepSub: #1f6b64;
419
+ --color-darkSub: #185a54;
420
+ --color-text-main: var(--color-darkMain);
421
+ --color-text-sub: var(--color-darkSub);
422
+ --color-lightGray: #5f6b7a;
423
+ --color-softGray: #56616f;
424
+ --color-gray: #434d56;
425
+ --color-deepGray: #36404a;
426
+ --color-darkGray: #2a3138;
427
+ --color-whiteLine: #7b8798;
428
+ --color-error: #b52f2b;
429
+ --color-success: #1d7a6e;
430
+ --color-infoLink: #1f62a8;
431
+ --color-main-a10: color-mix(in srgb, var(--color-main) 10%, transparent);
432
+ --color-main-a20: color-mix(in srgb, var(--color-main) 20%, transparent);
433
+ --color-sub-a10: color-mix(in srgb, var(--color-sub) 10%, transparent);
434
+ --color-text-primary: var(--color-black);
435
+ --color-text-secondary: var(--color-gray);
436
+ --color-text-muted: var(--color-lightGray);
437
+ --color-text-on-brand: var(--color-pureWhite);
438
+ --color-surface: var(--color-white);
439
+ --color-surface-raised: var(--color-deepWhite);
440
+ --color-surface-sunken: var(--color-darkWhite);
441
+ --color-border: var(--color-whiteLine);
442
+ }
443
+
387
444
  [data-theme="dark"] {
388
445
  color-scheme: dark;
389
446
  /* Surface & Background */
@@ -515,6 +572,258 @@
515
572
  화면(랜딩 페이지, 로그인 팝업 등)의 루트 요소에 이 클래스를 붙여 사용한다.
516
573
  portal로 document.body에 직접 렌더되는 요소(Popup 등)는 조상 스코프의 CSS
517
574
  변수를 상속받지 못하므로, 이런 요소는 반드시 자기 자신에게 이 클래스를 붙여야 한다. */
575
+ /* 다크 + 고대비 — 다크가 들어오는 **세 길**에 다 단다(`[data-theme="dark"]` · OS 자동 · `auto`) */
576
+ [data-theme="dark"][data-contrast="more"] {
577
+ /* 단추 글자는 어두운 꼴에서도 **흰색 그대로**다(Button.css `color: #ffffff`). 그래서 main·sub 는
578
+ 밝은 고대비와 같은 짙은 값을 쓴다 — 보통 main 위 흰 글자는 2.96(놀이터 실측, 어두운 꼴). */
579
+ --color-main: #2a6db0;
580
+ --color-deepMain: #1e5a8f;
581
+ --color-darkMain: #164a78;
582
+ --color-sub: #257e76;
583
+ --color-deepSub: #1f6b64;
584
+ --color-darkSub: #185a54;
585
+ --color-text-main: var(--color-softMain);
586
+ --color-text-sub: var(--color-softSub);
587
+ /* 회색은 한 단씩 밝게 (deepWhite #252a30 · darkWhite #2d3238 위) */
588
+ --color-lightGray: #a1aab7;
589
+ --color-softGray: #b0b8c4;
590
+ --color-gray: #c3cad4;
591
+ --color-deepGray: #d0d6de;
592
+ --color-darkGray: #dde1e7;
593
+ --color-whiteLine: rgba(255, 255, 255, 0.45);
594
+ --color-error: #f07b77;
595
+ --color-success: #2fae9e;
596
+ --color-infoLink: #6aa8ea;
597
+ --color-main-a10: color-mix(in srgb, var(--color-main) 10%, transparent);
598
+ --color-main-a20: color-mix(in srgb, var(--color-main) 20%, transparent);
599
+ --color-sub-a10: color-mix(in srgb, var(--color-sub) 10%, transparent);
600
+ --color-text-primary: var(--color-black);
601
+ --color-text-secondary: var(--color-gray);
602
+ --color-text-muted: var(--color-lightGray);
603
+ --color-text-on-brand: var(--color-pureWhite);
604
+ --color-surface: var(--color-white);
605
+ --color-surface-raised: var(--color-deepWhite);
606
+ --color-surface-sunken: var(--color-darkWhite);
607
+ --color-border: var(--color-whiteLine);
608
+ }
609
+ @media (prefers-color-scheme: dark) {
610
+ :root:not([data-theme="light"]):not([data-theme="dark"])[data-contrast="more"] {
611
+ /* 단추 글자는 어두운 꼴에서도 **흰색 그대로**다(Button.css `color: #ffffff`). 그래서 main·sub 는
612
+ 밝은 고대비와 같은 짙은 값을 쓴다 — 보통 main 위 흰 글자는 2.96(놀이터 실측, 어두운 꼴). */
613
+ --color-main: #2a6db0;
614
+ --color-deepMain: #1e5a8f;
615
+ --color-darkMain: #164a78;
616
+ --color-sub: #257e76;
617
+ --color-deepSub: #1f6b64;
618
+ --color-darkSub: #185a54;
619
+ --color-text-main: var(--color-softMain);
620
+ --color-text-sub: var(--color-softSub);
621
+ /* 회색은 한 단씩 밝게 (deepWhite #252a30 · darkWhite #2d3238 위) */
622
+ --color-lightGray: #a1aab7;
623
+ --color-softGray: #b0b8c4;
624
+ --color-gray: #c3cad4;
625
+ --color-deepGray: #d0d6de;
626
+ --color-darkGray: #dde1e7;
627
+ --color-whiteLine: rgba(255, 255, 255, 0.45);
628
+ --color-error: #f07b77;
629
+ --color-success: #2fae9e;
630
+ --color-infoLink: #6aa8ea;
631
+ --color-main-a10: color-mix(in srgb, var(--color-main) 10%, transparent);
632
+ --color-main-a20: color-mix(in srgb, var(--color-main) 20%, transparent);
633
+ --color-sub-a10: color-mix(in srgb, var(--color-sub) 10%, transparent);
634
+ --color-text-primary: var(--color-black);
635
+ --color-text-secondary: var(--color-gray);
636
+ --color-text-muted: var(--color-lightGray);
637
+ --color-text-on-brand: var(--color-pureWhite);
638
+ --color-surface: var(--color-white);
639
+ --color-surface-raised: var(--color-deepWhite);
640
+ --color-surface-sunken: var(--color-darkWhite);
641
+ --color-border: var(--color-whiteLine);
642
+ }
643
+ [data-theme="auto"][data-contrast="more"] {
644
+ /* 단추 글자는 어두운 꼴에서도 **흰색 그대로**다(Button.css `color: #ffffff`). 그래서 main·sub 는
645
+ 밝은 고대비와 같은 짙은 값을 쓴다 — 보통 main 위 흰 글자는 2.96(놀이터 실측, 어두운 꼴). */
646
+ --color-main: #2a6db0;
647
+ --color-deepMain: #1e5a8f;
648
+ --color-darkMain: #164a78;
649
+ --color-sub: #257e76;
650
+ --color-deepSub: #1f6b64;
651
+ --color-darkSub: #185a54;
652
+ --color-text-main: var(--color-softMain);
653
+ --color-text-sub: var(--color-softSub);
654
+ /* 회색은 한 단씩 밝게 (deepWhite #252a30 · darkWhite #2d3238 위) */
655
+ --color-lightGray: #a1aab7;
656
+ --color-softGray: #b0b8c4;
657
+ --color-gray: #c3cad4;
658
+ --color-deepGray: #d0d6de;
659
+ --color-darkGray: #dde1e7;
660
+ --color-whiteLine: rgba(255, 255, 255, 0.45);
661
+ --color-error: #f07b77;
662
+ --color-success: #2fae9e;
663
+ --color-infoLink: #6aa8ea;
664
+ --color-main-a10: color-mix(in srgb, var(--color-main) 10%, transparent);
665
+ --color-main-a20: color-mix(in srgb, var(--color-main) 20%, transparent);
666
+ --color-sub-a10: color-mix(in srgb, var(--color-sub) 10%, transparent);
667
+ --color-text-primary: var(--color-black);
668
+ --color-text-secondary: var(--color-gray);
669
+ --color-text-muted: var(--color-lightGray);
670
+ --color-text-on-brand: var(--color-pureWhite);
671
+ --color-surface: var(--color-white);
672
+ --color-surface-raised: var(--color-deepWhite);
673
+ --color-surface-sunken: var(--color-darkWhite);
674
+ --color-border: var(--color-whiteLine);
675
+ }
676
+ }
677
+
678
+ /* ── OS 의 '대비 높이기'(prefers-contrast: more)도 같은 값을 탄다 (사장님 결정 2026-11-11) ──
679
+ **앱이 고른 것이 이긴다** — `data-contrast` 가 달려 있으면(`more` 든 `normal` 이든) 이 블록은 안 맞는다.
680
+ `applyContrast(false)` 가 속성을 떼지 않고 `normal` 을 다는 까닭이 이것이다(OS 를 켜 둔 사람도 끌 수 있게).
681
+
682
+ 스코프 빌드에서 `:root:not(...)` 는 한 번도 안 맞는다(위 OS 자동 다크와 같은 까닭, postcss.config.cjs).
683
+ 그래서 스코프 원소를 **직접** 적은 꼴을 함께 둔다 — `.ihabdevteam-core-scope` 로 시작하는 선택자는
684
+ 프리픽스가 그대로 둔다. `:not([data-contrast] *)` 는 "조상 어디에도 그 속성이 없다" 이다.
685
+
686
+ 특이도: 밝은 꼴 (0,3,0) · 어두운 꼴도 (0,3,0) 이고 **뒤에 있어** 이긴다. 보통 다크(0,2,0)는 밝은 고대비가
687
+ 누르지만 곧바로 어두운 고대비가 같은 토큰을 다 덮는다(두 블록이 적는 토큰이 같다). */
688
+ @media (prefers-contrast: more) {
689
+ :root:not([data-contrast]),
690
+ .ihabdevteam-core-scope:not([data-contrast] *):not([data-contrast]) {
691
+
692
+ --color-main: #2a6db0;
693
+ --color-deepMain: #1e5a8f;
694
+ --color-darkMain: #164a78;
695
+ --color-sub: #257e76;
696
+ --color-deepSub: #1f6b64;
697
+ --color-darkSub: #185a54;
698
+ --color-text-main: var(--color-darkMain);
699
+ --color-text-sub: var(--color-darkSub);
700
+ --color-lightGray: #5f6b7a;
701
+ --color-softGray: #56616f;
702
+ --color-gray: #434d56;
703
+ --color-deepGray: #36404a;
704
+ --color-darkGray: #2a3138;
705
+ --color-whiteLine: #7b8798;
706
+ --color-error: #b52f2b;
707
+ --color-success: #1d7a6e;
708
+ --color-infoLink: #1f62a8;
709
+ --color-main-a10: color-mix(in srgb, var(--color-main) 10%, transparent);
710
+ --color-main-a20: color-mix(in srgb, var(--color-main) 20%, transparent);
711
+ --color-sub-a10: color-mix(in srgb, var(--color-sub) 10%, transparent);
712
+ --color-text-primary: var(--color-black);
713
+ --color-text-secondary: var(--color-gray);
714
+ --color-text-muted: var(--color-lightGray);
715
+ --color-text-on-brand: var(--color-pureWhite);
716
+ --color-surface: var(--color-white);
717
+ --color-surface-raised: var(--color-deepWhite);
718
+ --color-surface-sunken: var(--color-darkWhite);
719
+ --color-border: var(--color-whiteLine);
720
+ }
721
+ [data-theme="dark"]:not([data-contrast]) {
722
+
723
+ /* 단추 글자는 어두운 꼴에서도 **흰색 그대로**다(Button.css `color: #ffffff`). 그래서 main·sub 는
724
+ 밝은 고대비와 같은 짙은 값을 쓴다 — 보통 main 위 흰 글자는 2.96(놀이터 실측, 어두운 꼴). */
725
+ --color-main: #2a6db0;
726
+ --color-deepMain: #1e5a8f;
727
+ --color-darkMain: #164a78;
728
+ --color-sub: #257e76;
729
+ --color-deepSub: #1f6b64;
730
+ --color-darkSub: #185a54;
731
+ --color-text-main: var(--color-softMain);
732
+ --color-text-sub: var(--color-softSub);
733
+ /* 회색은 한 단씩 밝게 (deepWhite #252a30 · darkWhite #2d3238 위) */
734
+ --color-lightGray: #a1aab7;
735
+ --color-softGray: #b0b8c4;
736
+ --color-gray: #c3cad4;
737
+ --color-deepGray: #d0d6de;
738
+ --color-darkGray: #dde1e7;
739
+ --color-whiteLine: rgba(255, 255, 255, 0.45);
740
+ --color-error: #f07b77;
741
+ --color-success: #2fae9e;
742
+ --color-infoLink: #6aa8ea;
743
+ --color-main-a10: color-mix(in srgb, var(--color-main) 10%, transparent);
744
+ --color-main-a20: color-mix(in srgb, var(--color-main) 20%, transparent);
745
+ --color-sub-a10: color-mix(in srgb, var(--color-sub) 10%, transparent);
746
+ --color-text-primary: var(--color-black);
747
+ --color-text-secondary: var(--color-gray);
748
+ --color-text-muted: var(--color-lightGray);
749
+ --color-text-on-brand: var(--color-pureWhite);
750
+ --color-surface: var(--color-white);
751
+ --color-surface-raised: var(--color-deepWhite);
752
+ --color-surface-sunken: var(--color-darkWhite);
753
+ --color-border: var(--color-whiteLine);
754
+ }
755
+ }
756
+ @media (prefers-contrast: more) and (prefers-color-scheme: dark) {
757
+ :root:not([data-theme="light"]):not([data-theme="dark"]):not([data-contrast]) {
758
+
759
+ /* 단추 글자는 어두운 꼴에서도 **흰색 그대로**다(Button.css `color: #ffffff`). 그래서 main·sub 는
760
+ 밝은 고대비와 같은 짙은 값을 쓴다 — 보통 main 위 흰 글자는 2.96(놀이터 실측, 어두운 꼴). */
761
+ --color-main: #2a6db0;
762
+ --color-deepMain: #1e5a8f;
763
+ --color-darkMain: #164a78;
764
+ --color-sub: #257e76;
765
+ --color-deepSub: #1f6b64;
766
+ --color-darkSub: #185a54;
767
+ --color-text-main: var(--color-softMain);
768
+ --color-text-sub: var(--color-softSub);
769
+ /* 회색은 한 단씩 밝게 (deepWhite #252a30 · darkWhite #2d3238 위) */
770
+ --color-lightGray: #a1aab7;
771
+ --color-softGray: #b0b8c4;
772
+ --color-gray: #c3cad4;
773
+ --color-deepGray: #d0d6de;
774
+ --color-darkGray: #dde1e7;
775
+ --color-whiteLine: rgba(255, 255, 255, 0.45);
776
+ --color-error: #f07b77;
777
+ --color-success: #2fae9e;
778
+ --color-infoLink: #6aa8ea;
779
+ --color-main-a10: color-mix(in srgb, var(--color-main) 10%, transparent);
780
+ --color-main-a20: color-mix(in srgb, var(--color-main) 20%, transparent);
781
+ --color-sub-a10: color-mix(in srgb, var(--color-sub) 10%, transparent);
782
+ --color-text-primary: var(--color-black);
783
+ --color-text-secondary: var(--color-gray);
784
+ --color-text-muted: var(--color-lightGray);
785
+ --color-text-on-brand: var(--color-pureWhite);
786
+ --color-surface: var(--color-white);
787
+ --color-surface-raised: var(--color-deepWhite);
788
+ --color-surface-sunken: var(--color-darkWhite);
789
+ --color-border: var(--color-whiteLine);
790
+ }
791
+ [data-theme="auto"]:not([data-contrast]) {
792
+
793
+ /* 단추 글자는 어두운 꼴에서도 **흰색 그대로**다(Button.css `color: #ffffff`). 그래서 main·sub 는
794
+ 밝은 고대비와 같은 짙은 값을 쓴다 — 보통 main 위 흰 글자는 2.96(놀이터 실측, 어두운 꼴). */
795
+ --color-main: #2a6db0;
796
+ --color-deepMain: #1e5a8f;
797
+ --color-darkMain: #164a78;
798
+ --color-sub: #257e76;
799
+ --color-deepSub: #1f6b64;
800
+ --color-darkSub: #185a54;
801
+ --color-text-main: var(--color-softMain);
802
+ --color-text-sub: var(--color-softSub);
803
+ /* 회색은 한 단씩 밝게 (deepWhite #252a30 · darkWhite #2d3238 위) */
804
+ --color-lightGray: #a1aab7;
805
+ --color-softGray: #b0b8c4;
806
+ --color-gray: #c3cad4;
807
+ --color-deepGray: #d0d6de;
808
+ --color-darkGray: #dde1e7;
809
+ --color-whiteLine: rgba(255, 255, 255, 0.45);
810
+ --color-error: #f07b77;
811
+ --color-success: #2fae9e;
812
+ --color-infoLink: #6aa8ea;
813
+ --color-main-a10: color-mix(in srgb, var(--color-main) 10%, transparent);
814
+ --color-main-a20: color-mix(in srgb, var(--color-main) 20%, transparent);
815
+ --color-sub-a10: color-mix(in srgb, var(--color-sub) 10%, transparent);
816
+ --color-text-primary: var(--color-black);
817
+ --color-text-secondary: var(--color-gray);
818
+ --color-text-muted: var(--color-lightGray);
819
+ --color-text-on-brand: var(--color-pureWhite);
820
+ --color-surface: var(--color-white);
821
+ --color-surface-raised: var(--color-deepWhite);
822
+ --color-surface-sunken: var(--color-darkWhite);
823
+ --color-border: var(--color-whiteLine);
824
+ }
825
+ }
826
+
518
827
  .force-light-scheme {
519
828
  color-scheme: light;
520
829
  --color-pureWhite: #ffffff;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * 고대비 유틸리티 (말귀 청 (393))
3
+ * - 켜짐/꺼짐 — 테마(`data-theme`)와 따로 서서 라이트·다크·자동에 겹친다
4
+ * - localStorage 키: 'ihab_contrast' ('more' | 'normal')
5
+ * - 적용: <html data-contrast="more"> · 끄면 <html data-contrast="normal">
6
+ * - 아무것도 안 골랐으면 속성을 안 단다 — 그때는 OS 의 `prefers-contrast: more` 를 따른다
7
+ * (사장님 결정 2026-11-11). 끈 사람에게 `normal` 을 다는 까닭: 떼면 OS 설정이 다시 들어온다.
8
+ * - 색을 바꾸는 몫은 tokens.css 의 `[data-contrast="more"]` 블록에 있다
9
+ *
10
+ * 앱(`speechear-v2/src/libs/contrastMode.ts`)이 먼저 쓰던 키·꼴과 같게 맞췄다 — 앱이 제 것을 걷고
11
+ * 이것으로 바꿔도 저장된 값이 그대로 읽힌다.
12
+ */
13
+ /** 저장된 고대비 — 못 읽으면 꺼짐 */
14
+ export declare function getSavedContrast(): boolean;
15
+ /** 고대비를 켜고 끈다 — 꼬리표와 저장을 함께 */
16
+ export declare function applyContrast(on: boolean): void;
17
+ /** 앱이 뜰 때 저장된 값을 곧바로 입힌다 — 고른 적이 없으면 속성을 떼어 OS 설정을 따른다 */
18
+ export declare function initContrast(): void;
@@ -0,0 +1,47 @@
1
+ /**
2
+ * 고대비 유틸리티 (말귀 청 (393))
3
+ * - 켜짐/꺼짐 — 테마(`data-theme`)와 따로 서서 라이트·다크·자동에 겹친다
4
+ * - localStorage 키: 'ihab_contrast' ('more' | 'normal')
5
+ * - 적용: <html data-contrast="more"> · 끄면 <html data-contrast="normal">
6
+ * - 아무것도 안 골랐으면 속성을 안 단다 — 그때는 OS 의 `prefers-contrast: more` 를 따른다
7
+ * (사장님 결정 2026-11-11). 끈 사람에게 `normal` 을 다는 까닭: 떼면 OS 설정이 다시 들어온다.
8
+ * - 색을 바꾸는 몫은 tokens.css 의 `[data-contrast="more"]` 블록에 있다
9
+ *
10
+ * 앱(`speechear-v2/src/libs/contrastMode.ts`)이 먼저 쓰던 키·꼴과 같게 맞췄다 — 앱이 제 것을 걷고
11
+ * 이것으로 바꿔도 저장된 값이 그대로 읽힌다.
12
+ */
13
+ const STORAGE_KEY = 'ihab_contrast';
14
+ const ATTR = 'data-contrast';
15
+ /** 저장된 고대비 — 못 읽으면 꺼짐 */
16
+ export function getSavedContrast() {
17
+ try {
18
+ return localStorage.getItem(STORAGE_KEY) === 'more';
19
+ }
20
+ catch {
21
+ return false;
22
+ }
23
+ }
24
+ /** 고대비를 켜고 끈다 — 꼬리표와 저장을 함께 */
25
+ export function applyContrast(on) {
26
+ try {
27
+ document.documentElement.setAttribute(ATTR, on ? 'more' : 'normal');
28
+ localStorage.setItem(STORAGE_KEY, on ? 'more' : 'normal');
29
+ }
30
+ catch { }
31
+ }
32
+ /** 앱이 뜰 때 저장된 값을 곧바로 입힌다 — 고른 적이 없으면 속성을 떼어 OS 설정을 따른다 */
33
+ export function initContrast() {
34
+ let saved = null;
35
+ try {
36
+ saved = localStorage.getItem(STORAGE_KEY);
37
+ }
38
+ catch { }
39
+ if (saved === 'more' || saved === 'normal')
40
+ applyContrast(saved === 'more');
41
+ else {
42
+ try {
43
+ document.documentElement.removeAttribute(ATTR);
44
+ }
45
+ catch { }
46
+ }
47
+ }
@@ -108,6 +108,28 @@ export interface ResolvedGradeBand {
108
108
  * 표시가 없다. 엉뚱하게 보이느니 아는 꼴(묶음 없음)로 서는 편이 낫다.
109
109
  */
110
110
  export declare function resolveGradeBands(bands: readonly WordGradeBand[] | null | undefined): ResolvedGradeBand[] | null;
111
+ /**
112
+ * @public 저장된 난이도 코드를 **지금 묶음의 칩**에 맞춘다(말귀 청, 사장님 2026-11-10: *"훈련 설정에도
113
+ * 맞추고 … 모두 맞춰서 나오도록"*).
114
+ *
115
+ * 어드민이 분류마다 '나이로 표시' 를 켜고 끈다. 그러면 저장할 때의 칩과 지금 칩이 달라진다 — `'1'`
116
+ * (`1등급`·`미취학`)을 저장했는데 지금 미취학이 `1세`…`6세` 로 보이면 **켜질 칩이 없다.** 칩은 꺼져
117
+ * 보이는데 거르개는 그대로 걸고, 사람이 다시 누르면 엉뚱한 것이 겹친다.
118
+ *
119
+ * - 분류 코드(`'1'`)인데 그 분류가 나이로 보인다 → 그 분류의 나이 칩 전부(`age1`…`age6`, 위가
120
+ * 열렸으면 `age13plus`).
121
+ * - 나이 코드(`age3`)인데 그 나이의 분류가 이름 칩이다 → 그 분류 코드 하나(`'1'`). 나이로 보이되
122
+ * 그 나이 칩이 없으면(열린 분류의 `age15`) 그 분류의 칩.
123
+ * - 열린 나이 코드(`age7plus`) → 그 나이 이상이 걸치는 분류마다 위 둘대로.
124
+ * - 어느 분류에도 안 드는 것과 `none` 은 그대로. 겹치면 하나만(처음 차례).
125
+ *
126
+ * **같은 낱말을 고른다** — 분류 코드는 낱말의 `grade` 로, 나이 칩은 `age` 로 거르는데 DB 가 나이로
127
+ * 등급을 매기므로 둘이 같은 낱말이다. 다만 나이 하나(`age3`)를 이름 칩으로 맞추면 그 분류 전체로
128
+ * 넓어진다 — 이름 칩으로는 3세만 고를 수 없어서다.
129
+ *
130
+ * `bands` 를 안 주면 마지막으로 본 묶음(`resolveGradeBands`)을 쓰고, 그것도 없으면 그대로 돌려준다.
131
+ */
132
+ export declare function alignGradeCodesToBands(codes: readonly string[], bands?: readonly ResolvedGradeBand[] | null): string[];
111
133
  /**
112
134
  * 편 묶음 → 난이도 칩 **코드**(그 차례대로). `없음` 은 넣지 않는다 — 부르는 쪽이 맨 끝에 둔다.
113
135
  *
@@ -217,7 +217,10 @@ function bandLabelOf(raw) {
217
217
  */
218
218
  const bandLabelByCode = new Map();
219
219
  const bandCodeByLabel = new Map();
220
+ /** 마지막으로 본 꼴 맞는 묶음 — `wordAttributeFilterFromCodes` 가 저장된 코드를 지금 칩에 맞출 때 쓴다 */
221
+ let currentBands = null;
220
222
  function rememberBandLabels(bands) {
223
+ currentBands = bands;
221
224
  /* **코드 → 이름은 갈아 끼우고, 이름 → 코드는 쌓는다.** 앱이 지금 언어의 사전 이름을 label 로
222
225
  붙여 넘기므로(말귀, 2026-11-10 사장님: *"이거 번역도 되어야 하잖아"*) 언어를 바꾸면 이름이
223
226
  바뀐다. 이름 → 코드까지 갈아 끼우면 바꾸기 전에 켜 둔 `초등 저학년` 이 `Early elementary`
@@ -232,6 +235,72 @@ function rememberBandLabels(bands) {
232
235
  bandCodeByLabel.set(band.label, String(band.grade));
233
236
  }
234
237
  }
238
+ /**
239
+ * @public 저장된 난이도 코드를 **지금 묶음의 칩**에 맞춘다(말귀 청, 사장님 2026-11-10: *"훈련 설정에도
240
+ * 맞추고 … 모두 맞춰서 나오도록"*).
241
+ *
242
+ * 어드민이 분류마다 '나이로 표시' 를 켜고 끈다. 그러면 저장할 때의 칩과 지금 칩이 달라진다 — `'1'`
243
+ * (`1등급`·`미취학`)을 저장했는데 지금 미취학이 `1세`…`6세` 로 보이면 **켜질 칩이 없다.** 칩은 꺼져
244
+ * 보이는데 거르개는 그대로 걸고, 사람이 다시 누르면 엉뚱한 것이 겹친다.
245
+ *
246
+ * - 분류 코드(`'1'`)인데 그 분류가 나이로 보인다 → 그 분류의 나이 칩 전부(`age1`…`age6`, 위가
247
+ * 열렸으면 `age13plus`).
248
+ * - 나이 코드(`age3`)인데 그 나이의 분류가 이름 칩이다 → 그 분류 코드 하나(`'1'`). 나이로 보이되
249
+ * 그 나이 칩이 없으면(열린 분류의 `age15`) 그 분류의 칩.
250
+ * - 열린 나이 코드(`age7plus`) → 그 나이 이상이 걸치는 분류마다 위 둘대로.
251
+ * - 어느 분류에도 안 드는 것과 `none` 은 그대로. 겹치면 하나만(처음 차례).
252
+ *
253
+ * **같은 낱말을 고른다** — 분류 코드는 낱말의 `grade` 로, 나이 칩은 `age` 로 거르는데 DB 가 나이로
254
+ * 등급을 매기므로 둘이 같은 낱말이다. 다만 나이 하나(`age3`)를 이름 칩으로 맞추면 그 분류 전체로
255
+ * 넓어진다 — 이름 칩으로는 3세만 고를 수 없어서다.
256
+ *
257
+ * `bands` 를 안 주면 마지막으로 본 묶음(`resolveGradeBands`)을 쓰고, 그것도 없으면 그대로 돌려준다.
258
+ */
259
+ export function alignGradeCodesToBands(codes, bands) {
260
+ const use = bands === undefined ? currentBands : bands;
261
+ if (!use || use.length === 0)
262
+ return [...codes];
263
+ const out = [];
264
+ const push = (list) => { for (const c of list)
265
+ if (!out.includes(c))
266
+ out.push(c); };
267
+ const chipsOf = (band) => gradeBandCodes([band]);
268
+ const bandOfAge = (n) => use.find(b => n >= b.minAge && (b.maxAge == null || n <= b.maxAge));
269
+ for (const code of codes) {
270
+ if (GRADE_LEVELS.includes(code)) {
271
+ const band = use.find(b => String(b.grade) === code);
272
+ push(band ? chipsOf(band) : [code]);
273
+ continue;
274
+ }
275
+ const age = ageOfGradeCode(code);
276
+ if (age != null) {
277
+ const band = bandOfAge(age);
278
+ push(band && !(band.showAge && band.maxAge != null) ? chipsOf(band) : [code]);
279
+ continue;
280
+ }
281
+ const from = agePlusOfGradeCode(code);
282
+ if (from != null) {
283
+ const touched = use.filter(b => b.maxAge == null || b.maxAge >= from);
284
+ if (touched.length === 0) {
285
+ push([code]);
286
+ continue;
287
+ }
288
+ for (const band of touched) {
289
+ if (band.showAge && band.maxAge != null) {
290
+ const ages = [];
291
+ for (let n = Math.max(from, band.minAge); n <= band.maxAge; n++)
292
+ ages.push(`age${n}`);
293
+ push(ages);
294
+ }
295
+ else
296
+ push(chipsOf(band));
297
+ }
298
+ continue;
299
+ }
300
+ push([code]);
301
+ }
302
+ return out;
303
+ }
235
304
  /**
236
305
  * 편 묶음 → 난이도 칩 **코드**(그 차례대로). `없음` 은 넣지 않는다 — 부르는 쪽이 맨 끝에 둔다.
237
306
  *
@@ -458,7 +527,9 @@ export function wordAttributeFilterFromCodes(codes, lng = i18n.language) {
458
527
  const out = {};
459
528
  for (const s of sectionCodes) {
460
529
  /* 자유 절은 값이 곧 라벨이다 — 사전에 없다고 버리면 저장했다 되읽을 때 사라진다 */
461
- const labels = (codes?.[s] ?? []).map((c) => (s === 'grade' ? bandLabelByCode.get(c) : undefined) ?? d.value[s][c] ?? (FREE_VALUE_SECTIONS.has(s) ? c : undefined)).filter((x) => !!x);
530
+ /* 난이도는 **지금 칩에 맞춰서** — 나이로 표시가 바뀐 뒤 저장된 표를 열어도 켜질 칩이 있게 */
531
+ const list = s === 'grade' ? alignGradeCodesToBands(codes?.[s] ?? []) : (codes?.[s] ?? []);
532
+ const labels = list.map((c) => (s === 'grade' ? bandLabelByCode.get(c) : undefined) ?? d.value[s][c] ?? (FREE_VALUE_SECTIONS.has(s) ? c : undefined)).filter((x) => !!x);
462
533
  if (labels.length)
463
534
  out[d.section[s]] = labels;
464
535
  }
@@ -49,6 +49,7 @@ export { getSavedTheme, applyTheme, initTheme } from './utils/theme';
49
49
  export type { ThemeMode } from './utils/theme';
50
50
  export { getSavedFontScale, applyFontScale, initFontScale } from './utils/fontScale';
51
51
  export type { FontScale } from './utils/fontScale';
52
+ export { getSavedContrast, applyContrast, initContrast } from './utils/contrast';
52
53
  export { classifyPairDifficulty, firstChoseongOf, toChoseong, isAllChoseong, matchesChoseongSearch } from './utils/koreanSyllable';
53
54
  export { ensureTrainingDataLoaded, getTrainingPools, loadTrainingData, isTrainingDataLoaded, getDailySelection, computeDailySelection, NOISE_DATAS, SHORT_STORIES, LONG_STORIES, ORDER_SETS } from './utils/getTrainingData';
54
55
  export type { TrainingCounts, ComputeDailySelectionOptions } from './utils/getTrainingData';
@@ -37,6 +37,7 @@ export { configureTrainingCategories, getTopicTypes, getTrainingTypes } from './
37
37
  export { formatYmd, formatRelativeTime, getTodayKst, getTodayKstDate, kstStartOfDay, parseLocalYmd, toKstYmd, toKstHm, formatDateKo, formatDateLongKo, formatDatetimeKo, formatDateLocale, formatDateLongLocale } from './utils/date';
38
38
  export { getSavedTheme, applyTheme, initTheme } from './utils/theme';
39
39
  export { getSavedFontScale, applyFontScale, initFontScale } from './utils/fontScale';
40
+ export { getSavedContrast, applyContrast, initContrast } from './utils/contrast';
40
41
  export { classifyPairDifficulty, firstChoseongOf, toChoseong, isAllChoseong, matchesChoseongSearch } from './utils/koreanSyllable';
41
42
  export { ensureTrainingDataLoaded, getTrainingPools, loadTrainingData, isTrainingDataLoaded, getDailySelection, computeDailySelection, NOISE_DATAS, SHORT_STORIES, LONG_STORIES, ORDER_SETS } from './utils/getTrainingData';
42
43
  export { TRAINING_TYPES, TOPIC_TYPES, TRAINING_TYPE_I18N_KEY } from './utils/CategoryData';
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export declare const CORE_VERSION = "0.428.0";
49
+ export declare const CORE_VERSION = "0.430.0";
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export const CORE_VERSION = '0.428.0';
49
+ export const CORE_VERSION = '0.430.0';