@ihabdevteam/core 0.314.0 → 0.318.0

package/dist/packages/core/src/components/wordTableLayout.js

@@ -117,6 +117,54 @@ export const POS_LABEL = {
 export const WORD_TYPE_LABEL = {
     '고유': '고유어', '한자': '한자어', '외래': '외래어', '혼종': '혼종어',
 };
+/* ── 품사·어종을 **지금 언어로** ─────────────────────────────────────────
+   위 두 표는 **한국어**다(자료의 약호를 한국어 전체 표기로 펴는 표). 화면에 그릴 때는 이것을 그대로
+   쓰면 안 된다 — 영어 화면에서 한 줄 안에 섞인다(말귀 실측 2026-10-10, 낱말 제안 카드:
+   `Grade 3 · 명사 · 혼종어 · … · Homonym 1` — 등급·동음이의는 영어인데 품사·어종만 한국어).
+
+   **그 번역은 `WordTable` 안에만 숨어 있었다.** 그래서 밖에서는 `POS_LABEL` 을 날로 쓸 수밖에
+   없었고(공개된 것이 그것뿐이었다), 앱이 그렇게 썼다. 번역을 여기로 올려 **같이 공개한다** —
+   같은 결정이 두 자리에 적히지 않게 한다((120), 2026-10-10).
+
+   두 날 표(`POS_LABEL`·`WORD_TYPE_LABEL`)는 **그대로 내보낸다** — 쓰는 데가 있고, 한국어 전체
+   표기가 필요한 자리(인쇄 등)도 있다. 다만 **화면에 그릴 때는 아래 둘을 쓴다.** */
+/** 약호 → i18n 열쇠 조각. 자료의 `POS` 칸은 홑 코드 열셋(+ `명/관` 같은 슬래시 묶음)이다. */
+const POS_I18N_KEY = {
+    '명': 'noun', '동': 'verb', '형': 'adjective', '부': 'adverb', '수': 'numeral', '관': 'determiner', '감': 'interjection',
+    '조': 'particle', '접': 'affix', '의': 'dependentNoun', '대': 'pronoun', '보동': 'auxVerb', '보형': 'auxAdjective',
+};
+/** 자료의 `Class` 칸은 넷이다(라이브 전수: 한자 9,361 · 고유 8,458 · 혼종 4,227 · 외래 954). */
+const WORD_TYPE_I18N_KEY = { '고유': 'native', '한자': 'sino', '외래': 'foreign', '혼종': 'mixed' };
+/**
+ * **품사 약호 → 지금 언어의 이름**(`{ '명': 'Noun', … }`). `expandSlashLabel` 에 그대로 넘긴다.
+ *
+ * 사전에 없는 약호는 한국어 전체 표기(`POS_LABEL`)로 둔다 — 자료에 새 약호가 와도 빈칸이 안 된다.
+ * @public
+ */
+export function posLabels(t) {
+    return Object.fromEntries(Object.entries(POS_LABEL).map(([k, v]) => [k, POS_I18N_KEY[k] ? t(`wordTable.pos.${POS_I18N_KEY[k]}`, { defaultValue: v }) : v]));
+}
+/**
+ * **어종 약호 → 지금 언어의 이름**(`{ '한자': 'Sino-Korean', … }`). 쓰는 법은 `posLabels` 와 같다.
+ * @public
+ */
+export function wordTypeLabels(t) {
+    return Object.fromEntries(Object.entries(WORD_TYPE_LABEL).map(([k, v]) => [k, WORD_TYPE_I18N_KEY[k] ? t(`wordSearch.filter.type.${WORD_TYPE_I18N_KEY[k]}`, { defaultValue: v }) : v]));
+}
+/**
+ * 약호 → i18n 열쇠 조각 표(품사·어종).
+ *
+ * **차례가 뜻을 갖는다**(2026-10-10, 말귀_2 가 쓰기 시작한 뒤 적음). 처음에는 *사전 덮임을 세는*
+ * 데 쓰라고 내보냈는데(약호마다 말이 있나), 말귀가 **제안 폼 고르개의 차례**를 여기서 가져갔다 —
+ * *"말과 무관한 것은 말에서 안 꺼낸다"* 는 가름이고 맞다. 그래서 이 표는 이제 **두 가지를 뜻한다**:
+ * *어떤 약호가 있나* 와 *어떤 차례로 보이나.*
+ *
+ * **차례는 한국어 사전 차례다**(명 · 동 · 형 · 부 · 수 · 관 · 감 · 조 · 접 · 의 · 대 · 보동 · 보형).
+ * 약호를 **더하는 것은 뒤에 붙이면** 쓰는 쪽이 안 흔들리지만, **차례를 바꾸는 것은 쓰는 쪽 화면을
+ * 바꾼다** — 판 올릴 때 알려야 한다. *한 칸이 두 가지를 뜻하는 것은 어긋나는 날까지 안 보인다.*
+ * @public
+ */
+export const WORD_LABEL_I18N_KEYS = { pos: POS_I18N_KEY, wordType: WORD_TYPE_I18N_KEY };
 /**
  * 슬래시로 묶인 복합 약호(예: '명/관', '동/보동')를 라벨맵으로 각각 펼쳐 다시 '/'로 잇는다.
  * 라벨맵에 없는 조각은 원문 그대로 둔다. 빈 문자열은 빈 문자열 그대로 반환.

package/dist/packages/core/src/components.d.ts

@@ -219,7 +219,7 @@ export { default as TrainingPagePopupTitle } from './components/Training/Trainin
 export { default as FilterPanel, FILTER_ALL_VALUE } from './components/FilterPanel';
 export type { FilterPanelProps, FilterPanelSection, FilterPanelItem } from './components/FilterPanel';
 export { default as WordTable, WORD_TABLE_PAPER } from './components/WordTable';
-export { POS_LABEL, WORD_TYPE_LABEL, expandSlashLabel, printWordTable } from './components/wordTableLayout';
+export { POS_LABEL, WORD_TYPE_LABEL, posLabels, wordTypeLabels, WORD_LABEL_I18N_KEYS, expandSlashLabel, printWordTable } from './components/wordTableLayout';
 export type { WordTableProps, WordTableOrientation, WordTableContentType, WordTableCutLine, WordTableEditEntry } from './components/WordTable';
 export { useFitScale } from './components/useFitScale';
 export type { UseFitScaleResult } from './components/useFitScale';

package/dist/packages/core/src/components.js

@@ -161,7 +161,7 @@ export { default as FilterPanel, FILTER_ALL_VALUE } from './components/FilterPan
 export { default as WordTable, WORD_TABLE_PAPER } from './components/WordTable';
 // 라벨 맵·헬퍼는 순수 상수/함수라 컴포넌트 파일(WordTable.tsx)을 거치지 않고 직접 내보낸다
 // (컴포넌트 파일이 non-component를 export하면 fast refresh가 깨진다).
-export { POS_LABEL, WORD_TYPE_LABEL, expandSlashLabel, printWordTable } from './components/wordTableLayout';
+export { POS_LABEL, WORD_TYPE_LABEL, posLabels, wordTypeLabels, WORD_LABEL_I18N_KEYS, expandSlashLabel, printWordTable } from './components/wordTableLayout';
 export { useFitScale } from './components/useFitScale';
 export { default as WordSearchResultBlock } from './components/Word/WordSearchResultBlock';
 export { default as PhonemeSelectBlock } from './components/Word/PhonemeSelectBlock';

package/dist/packages/core/src/hooks/useWordTrainingFilter.js

@@ -414,7 +414,12 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
         // label만 오버라이드하고 나머지(items/allOption 등)는 공용 빌더 그대로 사용.
         sections.push({
             ...buildGradeSection(t, attrKeys, {
-                labelInfo: infoAction([t('wordPairs.filter.difficultyInfo', { defaultValue: '국립국어원의 기초 어휘 등급이 결과에 반영됩니다.' })]),
+                /* **등급마다 무엇인지 적는다**(말귀 요청 (205), 사장님이 주신 글 — 2026-10-12). 전에는
+                   *"국립국어원의 기초 어휘 등급이 결과에 반영됩니다"* 한 줄이라, 1등급이 쉬운 쪽인지
+                   어려운 쪽인지도 알 수 없었다. 앱 두 화면에는 이미 이 다섯 줄이 들어가 있어
+                   (앱 열쇠 `wordSearch.filter.gradeInfo`), 이 자리만 한 줄로 남아 **세 화면이 다른 말**을
+                   하고 있었다 — 글자까지 같은 것을 쓴다. */
+                labelInfo: infoAction([1, 2, 3, 4, 5].map(n => t(`wordPairs.filter.difficultyInfo${n}`))),
             }),
             label: LABELS.gradeLabel,
         });

package/dist/packages/core/src/i18n/locales/en.json

@@ -30,9 +30,11 @@
         "reset": "Reset",
         "update": "Update",
         "download": "Download",
-        "likeCount": "{{count}} likes",
+        "likeCount_one": "{{count}} like",
+        "likeCount_other": "{{count}} likes",
         "selectedOfMax": "{{count}} of {{max}}",
-        "downloadCount": "{{count}} downloads",
+        "downloadCount_one": "{{count}} download",
+        "downloadCount_other": "{{count}} downloads",
         "descriptionFor": "About {{name}}",
         "search": "Search",
         "empty": "No data.",
@@ -124,7 +126,8 @@
             "noVisit": "No Show"
         },
         "periodSelect": "Period unit",
-        "visitCount": "{{count}} visit(s)",
+        "visitCount_one": "{{count}} visit",
+        "visitCount_other": "{{count}} visits",
         "statusCount": "{{count}} {{label}}"
     },
     "passCard": {
@@ -196,7 +199,8 @@
         "more": "More",
         "moreMenu": "More menu",
         "badgeLabel": "{{label}}, {{count}}",
-        "badgeInsideLabel": "{{label}}, {{count}} notifications inside"
+        "badgeInsideLabel_one": "{{label}}, {{count}} notification inside",
+        "badgeInsideLabel_other": "{{label}}, {{count}} notifications inside"
     },
     "settings": {
         "language": {
@@ -356,8 +360,10 @@
             "sameStructure": "Only same phoneme structure"
         },
         "noQuestions": "No questions available.",
-        "countQuestions": "{{n}} questions",
-        "countSentences": "{{n}} sentences",
+        "countQuestions_one": "{{n}} question",
+        "countQuestions_other": "{{n}} questions",
+        "countSentences_one": "{{n}} sentence",
+        "countSentences_other": "{{n}} sentences",
         "comingSoon": "Coming Soon",
         "nextQuestion": "Next",
         "noiseRatioTitle": "Noise Ratio",
@@ -789,7 +795,8 @@
             "title": "Load Saved Word Table",
             "empty": "No saved word tables.",
             "loadButton": "Load",
-            "itemCount": "{{count}} words",
+            "itemCount_one": "{{count}} word",
+            "itemCount_other": "{{count}} words",
             "deleteAriaLabel": "Delete {{name}}",
             "viewLabel": "View as",
             "sortLabel": "Sort by",
@@ -841,14 +848,18 @@
             "none": "Tap ○ · △ · ✕ under a cell to mark it. With a mouse they appear when you hover the cell; with a keyboard, when focus reaches it.",
             "tally": "{{marked}} scored · ○ {{o}} · △ {{triangle}} · ✕ {{x}} · {{rate}}%",
             "save": "Save score",
-            "saved": "Saved {{count}} marks for {{name}}.",
+            "saved_one": "Saved {{count}} mark for {{name}}.",
+            "saved_other": "Saved {{count}} marks for {{name}}.",
             "reviewTitle": "Create a review table?",
-            "reviewMessage": "Builds a new table from the {{count}} cells {{name}} got wrong or partial. Correct ones are left out.",
+            "reviewMessage_one": "Builds a new table from the {{count}} cell {{name}} got wrong or partial. Correct ones are left out.",
+            "reviewMessage_other": "Builds a new table from the {{count}} cells {{name}} got wrong or partial. Correct ones are left out.",
             "reviewConfirm": "Create review table",
             "reviewDescription": "Cells marked wrong or partial in “{{name}}” — {{count}} of them.",
-            "reviewCreated": "Created “{{name}}” — {{count}} cells.",
+            "reviewCreated_one": "Created “{{name}}” — {{count}} cell.",
+            "reviewCreated_other": "Created “{{name}}” — {{count}} cells.",
             "discardTitle": "Discard this scoring?",
-            "discardMessage": "You marked {{count}} cells but have not saved. Leaving discards them.",
+            "discardMessage_one": "You marked {{count}} cell but have not saved. Leaving discards it.",
+            "discardMessage_other": "You marked {{count}} cells but have not saved. Leaving discards them.",
             "discardConfirm": "Discard and leave"
         },
         "info": {
@@ -1012,7 +1023,8 @@
         "copy": "Copy",
         "loading": "Loading…",
         "empty": "No links created yet.",
-        "uses": "Used {{count}} times",
+        "uses_one": "Used {{count}} time",
+        "uses_other": "Used {{count}} times",
         "expiresAt": "Expires: {{date}}",
         "createdAt": "Created: {{date}}",
         "confirmDelete": "Delete this link?",
@@ -1133,7 +1145,11 @@
             ],
             "orderAny": "Any",
             "orderMatch": "Match",
-            "difficultyInfo": "Reflects the National Institute of Korean Language's basic vocabulary grade.",
+            "difficultyInfo1": "Level 1 — everyday vocabulary acquired before school age and used for life",
+            "difficultyInfo2": "Level 2 — difficulty of grades 1–2",
+            "difficultyInfo3": "Level 3 — difficulty of grades 3–4",
+            "difficultyInfo4": "Level 4 — difficulty of grades 5–6",
+            "difficultyInfo5": "No level — frequent everyday words outside the national standard list, plus coinages and loanwords",
             "selectLabel": "Select",
             "onlyHasImage": "Only words with images",
             "onlySameStructure": "Only same phoneme structure"
@@ -1230,7 +1246,7 @@
         "address": "Address",
         "support": "Support",
         "ceoName": "Ji-hye Han",
-        "addressValue": "302, 3F, Haechan Bldg, 32 Siocheong-gil, Chuncheon, Gangwon, Korea"
+        "addressValue": "302, 3F, Haechan Bldg, 32 Sicheong-gil, Chuncheon, Gangwon, Korea"
     },
     "landing": {
         "trainingPhone": {
@@ -1274,7 +1290,8 @@
         "phaseWordDownload": "Download Word Data",
         "phaseImageCheck": "Check Images",
         "phasePairAnalysis": "Analyze Word Pairs",
-        "downloadingCount": "Downloading {{n}} words",
+        "downloadingCount_one": "Downloading {{n}} word",
+        "downloadingCount_other": "Downloading {{n}} words",
         "checkingPage": "Checking page {{page}} list",
         "imageCount": "{{done}} / {{total}} items"
     },
@@ -1334,7 +1351,8 @@
             "countSuffix": " sessions"
         },
         "time": {
-            "countLabel": "{{n}} sessions",
+            "countLabel_one": "{{n}} session",
+            "countLabel_other": "{{n}} sessions",
             "empty": "No training records"
         },
         "daily": {
@@ -1349,6 +1367,7 @@
             "title": "Linked Visit Records"
         },
         "detail": "Details",
+        "detailFor": "{{name}} details",
         "trainingType": {
             "LISTEN_IN_NOISE": "Sentence in Noise",
             "SHORT_STORY": "Short Story",
@@ -1397,7 +1416,8 @@
         "colTrend": "Change",
         "colRuns": "Runs",
         "unitItem": " items",
-        "skippedOnly": "{{n}} older record(s) were excluded — they do not say what was answered.",
+        "skippedOnly_one": "{{n}} older record was excluded — it does not say what was answered.",
+        "skippedOnly_other": "{{n}} older records were excluded — they do not say what was answered.",
         "summaryLabel": "Recorded",
         "summaryValue": "{{items}} items · {{pending}} still missed",
         "nextLabel": "Next to work on",
@@ -1407,7 +1427,8 @@
         "typeClear": "All caught up",
         "typePending": "{{pending}} of {{total}} left",
         "flat": "no change",
-        "runs": "{{count}} run(s)",
+        "runs_one": "{{count}} run",
+        "runs_other": "{{count}} runs",
         "avgDuration": "{{sec}}s avg"
     },
     "table": {

package/dist/packages/core/src/i18n/locales/ko.json

@@ -1134,7 +1134,11 @@
             ],
             "orderAny": "무관",
             "orderMatch": "일치",
-            "difficultyInfo": "국립국어원의 기초 어휘 등급이 결과에 반영됩니다.",
+            "difficultyInfo1": "1등급 : 학령전기에 습득하여 평생에 걸쳐 일상 언어생활을 하는 데 사용되는 어휘",
+            "difficultyInfo2": "2등급 : 초등학교 1-2학년 난이도 어휘",
+            "difficultyInfo3": "3등급 : 초등학교 3-4학년 난이도 어휘",
+            "difficultyInfo4": "4등급 : 초등학교 5-6학년 난이도 어휘",
+            "difficultyInfo5": "등급없음 : 국립국어원 표준 어휘 외 고빈도 생활 어휘, 신조어 및 외래어",
             "selectLabel": "선택",
             "onlyHasImage": "이미지 있는 단어만",
             "onlySameStructure": "음소 구조 같은 단어만"
@@ -1350,6 +1354,7 @@
             "title": "방문 연동 기록"
         },
         "detail": "상세보기",
+        "detailFor": "{{name}} 상세보기",
         "trainingType": {
             "LISTEN_IN_NOISE": "소음 하 문장",
             "SHORT_STORY": "짧은 이야기",

package/dist/packages/core/src/utils/wornDate.d.ts

@@ -5,8 +5,20 @@
  * `2026.null.null` 이 찍혔고, 정렬 열쇠를 만들 때는 `null.padStart` 에서 표가 통째로 터졌다. 빈 값은 '' 로 다룬다.
  */
 type 칸값 = string | number | null | undefined;
-/** 화면에 적을 착용일 — `2026.05.02`. 뒤쪽 빈 칸은 떼고(`2026`), 전부 비면 ''. */
-export declare function formatWornDate(year: 칸값, month: 칸값, day: 칸값): string;
+/**
+ * 화면에 적을 착용일.
+ *
+ * **`lang` 을 주면 보는 말을 따른다**(말귀 요청 (118), 사장님 지시 2026-10-11 *"날짜 꼴도 하나로
+ * 통일해"*). 한국어 `2026년 9월 9일` · 영어 `Sep 9, 2026` — 앱이 다른 화면 날짜를 모은 그 꼴이고,
+ * 코어 `formatDateLocale` 이 내는 것과 같다(글자를 또 짓지 않고 그것에 넘긴다).
+ *
+ * **연·월·일이 다 있을 때만** 그렇게 한다. 반쪽 값(연도만 · 연월만)은 그 말로 옮길 수가 없어
+ * 예전처럼 점으로 잇는다(`2026` · `2026.9`) — 서버에 월·일이 `null` 로 오는 옛 기록이 있다.
+ *
+ * `lang` 을 안 주면 **예전 그대로** 점 꼴이다(`2026.09.09`) — 부르는 자리가 말을 모르는 곳도 있을
+ * 수 있어 깨지지 않게 둔다. 화면에 그리는 자리는 주는 쪽이 맞다.
+ */
+export declare function formatWornDate(year: 칸값, month: 칸값, day: 칸값, lang?: string): string;
 /** 착용일 정렬 열쇠 — 자리수를 채워(`2026-05-02`) 글자 비교가 날짜 차례와 같게. 연도가 없으면 ''. */
 export declare function wornDateSortKey(year: 칸값, month: 칸값, day: 칸값): string;
 export {};

package/dist/packages/core/src/utils/wornDate.js

@@ -1,7 +1,42 @@
+import { formatDateLocale } from './date';
 const 글자 = (v) => (v == null ? '' : String(v).trim());
-/** 화면에 적을 착용일 — `2026.05.02`. 뒤쪽 빈 칸은 떼고(`2026`), 전부 비면 ''. */
-export function formatWornDate(year, month, day) {
-    const 조각 = [글자(year), 글자(month), 글자(day)];
+/**
+ * 화면에 적을 착용일.
+ *
+ * **`lang` 을 주면 보는 말을 따른다**(말귀 요청 (118), 사장님 지시 2026-10-11 *"날짜 꼴도 하나로
+ * 통일해"*). 한국어 `2026년 9월 9일` · 영어 `Sep 9, 2026` — 앱이 다른 화면 날짜를 모은 그 꼴이고,
+ * 코어 `formatDateLocale` 이 내는 것과 같다(글자를 또 짓지 않고 그것에 넘긴다).
+ *
+ * **연·월·일이 다 있을 때만** 그렇게 한다. 반쪽 값(연도만 · 연월만)은 그 말로 옮길 수가 없어
+ * 예전처럼 점으로 잇는다(`2026` · `2026.9`) — 서버에 월·일이 `null` 로 오는 옛 기록이 있다.
+ *
+ * `lang` 을 안 주면 **예전 그대로** 점 꼴이다(`2026.09.09`) — 부르는 자리가 말을 모르는 곳도 있을
+ * 수 있어 깨지지 않게 둔다. 화면에 그리는 자리는 주는 쪽이 맞다.
+ */
+export function formatWornDate(year, month, day, lang) {
+    const y = 글자(year), m = 글자(month), d = 글자(day);
+    if (lang && y && m && d) {
+        /* 자리수를 채워 ISO 로 만든다 — `formatDateLocale` 이 읽는 꼴. */
+        const iso = `${y.padStart(4, '0')}-${m.padStart(2, '0')}-${d.padStart(2, '0')}`;
+        /**
+         * **되돌아오는지 본다 — `new Date` 는 없는 날짜를 조용히 굴린다.**
+         * `2026-09-31` → **2026-10-01**, `2026-02-30` → **2026-03-02**(실측). 그러면 자료에 적힌 날과
+         * **다른 날**이 화면에 선다 — 잘못된 값을 보여 주는 것보다 **조용히 고쳐 보여 주는 것**이 나쁘다
+         * (사람이 틀린 줄 모른다). 지은 ISO 가 그대로 돌아올 때만 말로 옮기고, 아니면 아래 점 꼴로
+         * 자료에 적힌 그대로 보여 준다.
+         *
+         * *이 가름은 못이 안 울어서 찾았다* — `&& m && d` 조건만 깨뜨려 봤을 때는 조용했다(그때는
+         * `2026-00-00` 이 **못 읽는 날짜**라 저절로 떨어졌다). 못이 안 울면 **무엇이 막고 있나**를 묻는다.
+         */
+        const 날 = new Date(iso);
+        const 되돌아옴 = !Number.isNaN(날.getTime()) && 날.toISOString().slice(0, 10) === iso;
+        if (되돌아옴) {
+            const 말대로 = formatDateLocale(iso, lang);
+            if (말대로)
+                return 말대로;
+        }
+    }
+    const 조각 = [y, m, d];
     while (조각.length > 0 && 조각[조각.length - 1] === '')
         조각.pop();
     return 조각.join('.');

package/dist/packages/core/src/version.d.ts

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.314.0";
+export declare const CORE_VERSION = "0.318.0";

package/dist/packages/core/src/version.js

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export const CORE_VERSION = '0.314.0';
+export const CORE_VERSION = '0.318.0';