@ihabdevteam/core 0.427.0 → 0.429.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 (63) hide show
  1. package/CHANGELOG.md +114 -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 +191 -191
  8. package/dist/ihabdevteam-core.css +1 -1
  9. package/dist/ihabdevteam-core.d.ts +32 -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/{packages/core/src/logo/Symbol_SL.svg → logo/Symbol_SC.svg} +1 -1
  19. package/dist/{packages/core/src/logo/Symbol_SL_mono.svg → logo/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/useWordAttributeFilter.js +16 -4
  35. package/dist/packages/core/src/hooks/useWordTrainingFilter.js +14 -5
  36. package/dist/packages/core/src/hooks/wordTrainingFilterSections.js +1 -1
  37. package/dist/packages/core/src/i18n/locales/en.json +3 -2
  38. package/dist/packages/core/src/i18n/locales/ko.json +2 -1
  39. package/dist/packages/core/src/logo/Logo_SCL_en.svg +1 -0
  40. package/dist/packages/core/src/logo/Logo_SCL_en_mono.svg +1 -0
  41. package/dist/packages/core/src/logo/Logo_SCL_ko.svg +1 -0
  42. package/dist/packages/core/src/logo/Logo_SCL_ko_mono.svg +1 -0
  43. package/dist/packages/core/src/logo/Logo_SC_en.svg +1 -0
  44. package/dist/packages/core/src/logo/Logo_SC_en_mono.svg +1 -0
  45. package/dist/packages/core/src/logo/Logo_SC_ko.svg +1 -0
  46. package/dist/packages/core/src/logo/Logo_SC_ko_mono.svg +1 -0
  47. package/dist/{logo/Symbol_SL.svg → packages/core/src/logo/Symbol_SC.svg} +1 -1
  48. package/dist/{logo/Symbol_SL_mono.svg → packages/core/src/logo/Symbol_SC_mono.svg} +1 -1
  49. package/dist/packages/core/src/tokens.css +309 -0
  50. package/dist/packages/core/src/utils/contrast.d.ts +18 -0
  51. package/dist/packages/core/src/utils/contrast.js +47 -0
  52. package/dist/packages/core/src/utils/wordAttributeFilterCodes.d.ts +32 -0
  53. package/dist/packages/core/src/utils/wordAttributeFilterCodes.js +149 -3
  54. package/dist/packages/core/src/utils.d.ts +1 -0
  55. package/dist/packages/core/src/utils.js +1 -0
  56. package/dist/packages/core/src/version.d.ts +1 -1
  57. package/dist/packages/core/src/version.js +1 -1
  58. package/dist/utils.cjs.js +165 -165
  59. package/package.json +1 -1
  60. /package/dist/logo/{Logo_SL_en.svg → old/Logo_SL_en.svg} +0 -0
  61. /package/dist/logo/{Logo_SL_en_mono.svg → old/Logo_SL_en_mono.svg} +0 -0
  62. /package/dist/packages/core/src/logo/{Logo_SL_en.svg → old/Logo_SL_en.svg} +0 -0
  63. /package/dist/packages/core/src/logo/{Logo_SL_en_mono.svg → old/Logo_SL_en_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
+ }
@@ -78,6 +78,14 @@ export interface WordGradeBand {
78
78
  maxAge: number | null;
79
79
  /** 난이도 칩을 나이로 보일지 — `true` 면 `N세` 칩들(열린 묶음은 `N세 이상` 하나), `false` 면 `N등급` 하나 */
80
80
  showAge: boolean;
81
+ /**
82
+ * 칩 이름 — `showAge: false` 묶음에서만 읽는다. 주면 `N등급` 대신 이 글자가 선다(`초등 저학년`).
83
+ *
84
+ * 사장님 지시 2026-11-10: *"난이도를 등급으로 표현하지 않기로 했어"*. **칩 코드는 그대로
85
+ * `'2'`** 다 — 낱말의 `grade` 와 맞대는 쪽이라. 이름표가 곧 거르개의 열쇠이므로 이 글자는
86
+ * **코드로 되읽힌다**(`wordAttributeValueCodeOf`). 빈 글자는 안 준 것으로 본다.
87
+ */
88
+ label?: string;
81
89
  }
82
90
  /** 묶음 하나를 나이 범위로 편 것 */
83
91
  export interface ResolvedGradeBand {
@@ -85,6 +93,8 @@ export interface ResolvedGradeBand {
85
93
  minAge: number;
86
94
  maxAge: number | null;
87
95
  showAge: boolean;
96
+ /** 칩 이름 — `showAge: false` 이고 이름을 받았을 때만 */
97
+ label?: string;
88
98
  }
89
99
  /**
90
100
  * 묶음 목록을 나이 범위로 편다. **꼴이 어긋나면 `null`** — 부르는 쪽은 묶음이 없는 것처럼 간다.
@@ -98,6 +108,28 @@ export interface ResolvedGradeBand {
98
108
  * 표시가 없다. 엉뚱하게 보이느니 아는 꼴(묶음 없음)로 서는 편이 낫다.
99
109
  */
100
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[];
101
133
  /**
102
134
  * 편 묶음 → 난이도 칩 **코드**(그 차례대로). `없음` 은 넣지 않는다 — 부르는 쪽이 맨 끝에 둔다.
103
135
  *
@@ -154,18 +154,151 @@ export function resolveGradeBands(bands) {
154
154
  const band = bands[i];
155
155
  if (!band || band.grade !== i + 1 || typeof band.showAge !== 'boolean')
156
156
  return null;
157
+ const label = band.showAge ? undefined : bandLabelOf(band.label);
158
+ if (label === null)
159
+ return null;
160
+ const resolved = { grade: band.grade, minAge, maxAge: null, showAge: band.showAge };
161
+ if (label)
162
+ resolved.label = label;
157
163
  if (i === bands.length - 1) {
158
164
  if (band.maxAge !== null)
159
165
  return null;
160
- out.push({ grade: band.grade, minAge, maxAge: null, showAge: band.showAge });
166
+ out.push(resolved);
161
167
  break;
162
168
  }
163
169
  const max = band.maxAge;
164
170
  if (typeof max !== 'number' || !Number.isInteger(max) || max < minAge || max >= MAX_AGE)
165
171
  return null;
166
- out.push({ grade: band.grade, minAge, maxAge: max, showAge: band.showAge });
172
+ resolved.maxAge = max;
173
+ out.push(resolved);
167
174
  minAge = max + 1;
168
175
  }
176
+ /* 이름표끼리 같으면 하나로 되읽혀 다른 칩을 켠다 */
177
+ const labels = out.flatMap(b => (b.label ? [b.label] : []));
178
+ if (new Set(labels).size !== labels.length)
179
+ return null;
180
+ rememberBandLabels(out);
181
+ return out;
182
+ }
183
+ /**
184
+ * 묶음 이름 하나를 본다 — 안 줬거나 빈 글자면 `undefined`(이름 없음), **쓸 수 없는 이름이면 `null`**
185
+ * (묶음 전체가 꼴 어긋남).
186
+ *
187
+ * 쓸 수 없는 이름은 **다른 칩의 글자와 겹치는 것**이다 — `3세`·`2등급`·`없음`·`'4'` 같은 것.
188
+ * 이름표가 곧 열쇠라 겹치면 되읽을 때 엉뚱한 코드가 나온다. 나이 꼴(`10세 이상`)도 막는다.
189
+ */
190
+ function bandLabelOf(raw) {
191
+ if (raw === undefined || raw === null)
192
+ return undefined;
193
+ if (typeof raw !== 'string')
194
+ return null;
195
+ const label = raw.trim();
196
+ if (!label)
197
+ return undefined;
198
+ if (isGradeCode(label) || AGE_LIKE.test(label))
199
+ return null;
200
+ for (const lng of languages())
201
+ if (dictFor(lng).reverse.grade.has(label))
202
+ return null;
203
+ return label;
204
+ }
205
+ /**
206
+ * **지금 묶음의 이름표** — 코드 ↔ 이름(청 (389)+, 사장님 지시 2026-11-10).
207
+ *
208
+ * 이름표 → 코드 되읽기(`wordAttributeValueCodeOf`)와 코드 → 이름표(`wordAttributeValueLabelOf`·
209
+ * `wordAttributeFilterFromCodes`)는 **묶음을 안 받는다** — 부르는 자리가 많고(낱말 2만여 개마다
210
+ * 불리는 `matchesFilters` 까지) 다 묶음을 넘기게 바꿀 수 없다. 그래서 `resolveGradeBands` 가
211
+ * **꼴이 맞는 묶음을 볼 때마다 여기를 갈아 끼운다.** 묶음은 앱에 하나(`app_config`)라 화면끼리
212
+ * 다툴 일이 없다.
213
+ *
214
+ * 묶음이 없거나 어긋날 때는 **비우지 않는다** — 묶음을 안 넘기는 화면 하나가 다른 화면의 이름표를
215
+ * 지우면, 그 화면의 켜진 칩이 되읽히지 않는다(켜져 보이는데 0건). 이름 없는 칩(`2등급`)은 사전이
216
+ * 늘 읽으므로 남은 이름표가 해를 끼치지 않는다.
217
+ */
218
+ const bandLabelByCode = new Map();
219
+ const bandCodeByLabel = new Map();
220
+ /** 마지막으로 본 꼴 맞는 묶음 — `wordAttributeFilterFromCodes` 가 저장된 코드를 지금 칩에 맞출 때 쓴다 */
221
+ let currentBands = null;
222
+ function rememberBandLabels(bands) {
223
+ currentBands = bands;
224
+ /* **코드 → 이름은 갈아 끼우고, 이름 → 코드는 쌓는다.** 앱이 지금 언어의 사전 이름을 label 로
225
+ 붙여 넘기므로(말귀, 2026-11-10 사장님: *"이거 번역도 되어야 하잖아"*) 언어를 바꾸면 이름이
226
+ 바뀐다. 이름 → 코드까지 갈아 끼우면 바꾸기 전에 켜 둔 `초등 저학년` 이 `Early elementary`
227
+ 화면에서 안 읽혀 **켜져 보이는데 0건**이 된다(재 봤다). 사전이 지금 언어·ko·en 을 다 읽는
228
+ 것과 같은 까닭이다. 쌓인 옛 이름은 제 코드로만 읽히고, 같은 이름이 다른 코드로 오면 새 것이
229
+ 이긴다. */
230
+ bandLabelByCode.clear();
231
+ for (const band of bands) {
232
+ if (!band.label)
233
+ continue;
234
+ bandLabelByCode.set(String(band.grade), band.label);
235
+ bandCodeByLabel.set(band.label, String(band.grade));
236
+ }
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
+ }
169
302
  return out;
170
303
  }
171
304
  /**
@@ -315,6 +448,12 @@ export function wordAttributeValueCodeOf(section, value) {
315
448
  return value;
316
449
  if (isSectionValueCode(section, value))
317
450
  return value;
451
+ /* 묶음 이름표(`초등 저학년` → `'2'`) — 사전보다 먼저. 숫자 길로 가면 `초등 3학년` 이 3등급이 된다 */
452
+ if (section === 'grade') {
453
+ const hit = bandCodeByLabel.get(value.trim());
454
+ if (hit)
455
+ return hit;
456
+ }
318
457
  for (const lng of languages()) {
319
458
  const hit = dictFor(lng).reverse[section].get(value);
320
459
  if (hit)
@@ -351,6 +490,11 @@ export function wordAttributeValueCodeOf(section, value) {
351
490
  const AGE_LIKE = /(^age\s*\d)|((세|살|years?\s*old|yrs?)(\s*(이상|\+|or\s+(older|above|more)))?$)/i;
352
491
  /** 코드 → 지금 언어의 라벨. `'none'` 도 사전 꼴로 나온다(숫자 틀 `{{n}}등급` 에 넣으면 `NaN등급` 이 된다). 모르는 코드는 그대로. */
353
492
  export function wordAttributeValueLabelOf(section, code, lng = i18n.language) {
493
+ if (section === 'grade') {
494
+ const named = bandLabelByCode.get(code);
495
+ if (named)
496
+ return named;
497
+ }
354
498
  return dictFor(lng).value[section][code] ?? code;
355
499
  }
356
500
  const toArray = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === 'string') : typeof v === 'string' && v ? [v] : []);
@@ -383,7 +527,9 @@ export function wordAttributeFilterFromCodes(codes, lng = i18n.language) {
383
527
  const out = {};
384
528
  for (const s of sectionCodes) {
385
529
  /* 자유 절은 값이 곧 라벨이다 — 사전에 없다고 버리면 저장했다 되읽을 때 사라진다 */
386
- const labels = (codes?.[s] ?? []).map((c) => 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);
387
533
  if (labels.length)
388
534
  out[d.section[s]] = labels;
389
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';