@ihabdevteam/core 0.321.0 → 0.323.0

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

@@ -9,7 +9,7 @@ import { toKstYmd, formatYmd } from '../../utils/date';
  * 이 파일에는 화면도 저장도 없다. 무엇을 담을지만 안다.
  */
 /** 다음 표에 담을 표시 — 틀림과 애매. */
-const 담을것 = new Set(['x', 'triangle']);
+const COUNTED_MARKS = new Set(['x', 'triangle']);
 /**
  * 다음 표에 담을 칸들.
  *
@@ -28,29 +28,29 @@ export function reviewCells(items, marks) {
     const out = [];
     for (let i = 0; i < items.length; i++) {
         const m = marks[String(i)];
-        if (m && 담을것.has(m))
+        if (m && COUNTED_MARKS.has(m))
             out.push(items[i]);
     }
     return out;
 }
 /** 복습 꼬리 — `[N차 ]복습 MM.DD`. '복습' 뒤에 날짜가 따라와야만 꼬리로 본다("복습 자료" 같은 이름을 잘라 먹지 않게). */
-const 복습꼬리 = /\s*(?:(\d+)차\s*)?복습\s*\d{2}\.\d{2}$/;
+const REVIEW_SUFFIX = /\s*(?:(\d+)차\s*)?복습\s*\d{2}\.\d{2}$/;
 /** 원래 표 → (꼬리를 뗀 바탕 이름, 새 복습표의 회차). 메타가 있으면 메타를, 없으면 이름을 읽는다. */
-function 바탕과회차(src) {
-    const 이름 = src.name.trim();
-    const 메타회차 = src.reviewRound;
-    if (typeof 메타회차 === 'number' && Number.isFinite(메타회차) && 메타회차 >= 0) {
-        const 지난 = Math.floor(메타회차);
-        if (지난 === 0)
-            return { 바탕: 이름, 회차: 1 };
+function baseAndRound(src) {
+    const name = src.name.trim();
+    const metaRound = src.reviewRound;
+    if (typeof metaRound === 'number' && Number.isFinite(metaRound) && metaRound >= 0) {
+        const past = Math.floor(metaRound);
+        if (past === 0)
+            return { base: name, round: 1 };
         /* 메타가 말하는 **그 회차의 꼬리 하나만** 뗀다 — `수업 3차 복습 09.15`(1회) 에서 `3차` 를 회차로 먹지 않는다.
            N차는 앞이 공백·처음일 때만 — `수업 13차 복습`(3회) 의 `3차` 를 떼지 않게. 사람이 이름을 고쳐 꼬리가 없으면
            이름을 통째로 바탕으로 둔다. */
-        const 그꼬리 = 지난 === 1
+        const suffix = past === 1
             ? /\s*복습\s*\d{2}\.\d{2}$/
-            : new RegExp(`(?:^|\\s)${지난}차\\s*복습\\s*\\d{2}\\.\\d{2}$`);
-        const m = 그꼬리.exec(이름);
-        return { 바탕: m ? 이름.slice(0, m.index).trim() : 이름, 회차: 지난 + 1 };
+            : new RegExp(`(?:^|\\s)${past}차\\s*복습\\s*\\d{2}\\.\\d{2}$`);
+        const m = suffix.exec(name);
+        return { base: m ? name.slice(0, m.index).trim() : name, round: past + 1 };
     }
     /* **메타 없는 옛 표 — 이름을 파싱한다.** 복습표를 또 복습하면 꼬리가 쌓인다. 그대로 두면
        `검수 대립쌍 복습 08.29 복습 08.30 복습 09.02` 처럼 자란다 — 복습을 거듭하는 것은
@@ -63,16 +63,16 @@ function 바탕과회차(src) {
   
        '복습' 은 뒤에 `MM.DD` 가 따라와야만 꼬리로 본다 — "복습 자료" 같은 사람이 지은
        이름을 잘라 먹지 않으려는 것이다. */
-    let 바탕 = 이름;
-    let 세대 = 1;
+    let base = name;
+    let generation = 1;
     for (;;) {
-        const m = 복습꼬리.exec(바탕);
+        const m = REVIEW_SUFFIX.exec(base);
         if (!m)
             break;
-        세대 = Math.max(세대, (m[1] ? Number(m[1]) : 1) + 1);
-        바탕 = 바탕.slice(0, m.index).trim();
+        generation = Math.max(generation, (m[1] ? Number(m[1]) : 1) + 1);
+        base = base.slice(0, m.index).trim();
     }
-    return { 바탕, 회차: 세대 };
+    return { base, round: generation };
 }
 /**
  * 복습표 이름.
@@ -89,11 +89,11 @@ export function reviewTableName(original, today) {
     /* 지역 날짜가 아니라 KST 로 읽는다 — 이 날짜는 **표 이름에 저장되고** 같은 이름끼리
        겹치는지 세는 데 쓰인다. 기기 시간대를 따르면 같은 날 만든 표가 다른 날짜를 달고
        남아 회차 세기가 어긋난다. */
-    const [, 월, 일] = toKstYmd(today).split('-');
-    const 날짜 = `${월}.${일}`;
-    const { 바탕, 회차: 세대 } = 바탕과회차(typeof original === 'string' ? { name: original } : original);
-    const 회차 = 세대 >= 2 ? `${세대}차 ` : '';
-    return `${바탕 || '단어표'} ${회차}복습 ${날짜}`;
+    const [, month, day] = toKstYmd(today).split('-');
+    const dateLabel = `${month}.${day}`;
+    const { base, round: generation } = baseAndRound(typeof original === 'string' ? { name: original } : original);
+    const round = generation >= 2 ? `${generation}차 ` : '';
+    return `${base || '단어표'} ${round}복습 ${dateLabel}`;
 }
 /**
  * 새로 만들 복습표에 **함께 저장할 메타** — 맨 처음 원본 표 id 와 이번이 몇 번째 복습인지.
@@ -106,7 +106,7 @@ export function reviewTableName(original, today) {
 export function reviewMeta(source) {
     return {
         reviewOf: source.reviewOf ?? source.id ?? undefined,
-        reviewRound: 바탕과회차(source).회차,
+        reviewRound: baseAndRound(source).round,
     };
 }
 /**
@@ -165,6 +165,6 @@ export function labelOfCellKey(key) {
  */
 export function scoreSheetHeader(customerName, tableName, today) {
     /* 인쇄물에 찍히는 날짜다 — 치료실의 그날(KST)이어야 한다. */
-    const 날짜 = formatYmd(today);
-    return [customerName.trim(), 날짜, tableName.trim()].filter(Boolean).join(' · ');
+    const dateLabel = formatYmd(today);
+    return [customerName.trim(), dateLabel, tableName.trim()].filter(Boolean).join(' · ');
 }

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

@@ -1,14 +1,6 @@
 import type { TFunction } from 'i18next';
 import { type FilterPanelSection } from '../FilterPanel';
 import type { WordTableOrientation, WordTableContentType, WordTableCutLine, PageNumberPosition } from '../WordTable';
-/**
- * '표 설정'(단어표 표시 옵션) 공용 섹션 빌더·선택상태·핸들러.
- * 표시 전용 훅(useWordTableDisplaySettings)과 편집/페이지분할까지 있는 WordTableBlock이 기본 5개 설정
- * (구성·용지 방향·외곽선·절취선·구분선)을 여기서 공용으로 조립한다. 각 소비처는 자신의 표시 조건
- * (절취선=칸>1, 구분선=대립쌍 등)에 따라 섹션 포함 여부만 결정하고, WordTableBlock은 칸 수·페이지당
- * 개수·페이지 번호 섹션을 그 사이에 끼워 넣는다.
- */
-/** @public 구성(이미지/단어/표준발음/구어체발음) 다중 토글 섹션. */
 export declare function buildCompositionSection(t: TFunction, opts: {
     hasImage: boolean;
     hasColloquial: boolean;
@@ -41,9 +33,14 @@ export declare function buildItemsPerPageSection(t: TFunction, opts: {
 export declare function itemsPerPageFromChoice(n: number, itemCount: number): number;
 /** @public 페이지 번호 위치(왼쪽/중앙/오른쪽/미표시) 세그먼트 섹션 — 실제 2페이지 이상일 때만 노출. */
 export declare function buildPageNumberSection(t: TFunction): FilterPanelSection;
-/** @public 페이지 번호 위치 → filterSelected 표시값. */
-export declare const PAGE_NUM_POSITION_VALUE: Record<PageNumberPosition, string>;
-/** @public FilterPanel 선택값 → 페이지 번호 위치. */
+/**
+ * @public FilterPanel 선택값 → 페이지 번호 위치.
+ *
+ * **섹션의 `value` 가 곧 코드다.** 전에는 `value` 가 한글(`'왼쪽'`)이라 여기서 되돌리는 표
+ * (`PAGE_NUM_POSITION_VALUE`)와 파서가 **둘 다** 필요했다 — 값을 코드로 돌리니 그 둘이
+ * 항등식이 되어 표를 걷었다(2026-10-13). *옮기는 표가 사라지는 것이 옳게 옮긴 표시다.*
+ * 모르는 값은 `'none'` 으로 떨어뜨린다(옛 한글 값이 어디선가 오더라도 번호를 안 찍는다).
+ */
 export declare function parsePageNumberPosition(value: string): PageNumberPosition;
 /** @public 기본 5개 설정의 filterSelected 엔트리(호출부가 자신의 추가 섹션과 spread). */
 export declare function buildTableSettingsSelected(t: TFunction, v: {

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

@@ -8,14 +8,21 @@ import { ITEMS_PER_PAGE_OPTIONS } from './wordTableBlockTypes';
  * 개수·페이지 번호 섹션을 그 사이에 끼워 넣는다.
  */
 /** @public 구성(이미지/단어/표준발음/구어체발음) 다중 토글 섹션. */
+/**
+ * 켜고 끄는 절의 값 — **코드다.** 보일 글은 사전(`wordTable.filter.show`·`.hide`)이 쥔다.
+ * 외곽선·대립선·상단/하단 정보·절취선이 같은 짝을 쓰므로 한 자리에 둔다
+ * (한글 `'표시'`·`'미표시'` 에서 2026-10-13 옮겼다 — 사장님 지시 "모두 표준으로").
+ */
+const SHOW = 'show';
+const HIDE = 'hide';
 export function buildCompositionSection(t, opts) {
     return {
         label: t('wordTable.filter.composition', '구성'),
         items: [
-            { value: '이미지', disabled: !opts.hasImage, displayLabel: t('wordTable.filter.image', '이미지') },
-            { value: '단어', displayLabel: t('wordTable.filter.word', '단어') },
-            { value: '표준 발음', displayLabel: t('wordTable.filter.standardPron', '표준 발음') },
-            { value: '구어체 발음', disabled: !opts.hasColloquial, displayLabel: t('wordTable.filter.colloquialPron', '구어체 발음') },
+            { value: 'image', disabled: !opts.hasImage, displayLabel: t('wordTable.filter.image', '이미지') },
+            { value: 'word', displayLabel: t('wordTable.filter.word', '단어') },
+            { value: 'standardPron', displayLabel: t('wordTable.filter.standardPron', '표준 발음') },
+            { value: 'colloquialPron', disabled: !opts.hasColloquial, displayLabel: t('wordTable.filter.colloquialPron', '구어체 발음') },
         ],
         multiple: true,
         allOption: true,
@@ -26,8 +33,8 @@ export function buildOrientationSection(t) {
     return {
         label: t('wordTable.filter.paperOrientation', '용지 방향'),
         items: [
-            { value: '가로', displayLabel: t('wordTable.filter.landscape', '가로') },
-            { value: '세로', displayLabel: t('wordTable.filter.portrait', '세로') },
+            { value: 'landscape', displayLabel: t('wordTable.filter.landscape', '가로') },
+            { value: 'portrait', displayLabel: t('wordTable.filter.portrait', '세로') },
         ],
         display: 'segmented',
     };
@@ -37,8 +44,8 @@ export function buildBorderSection(t) {
     return {
         label: t('wordTable.filter.border', '외곽선'),
         items: [
-            { value: '표시', displayLabel: t('wordTable.filter.show', '표시') },
-            { value: '미표시', displayLabel: t('wordTable.filter.hide', '미표시') },
+            { value: SHOW, displayLabel: t('wordTable.filter.show', '표시') },
+            { value: HIDE, displayLabel: t('wordTable.filter.hide', '미표시') },
         ],
         display: 'segmented',
     };
@@ -48,8 +55,8 @@ export function buildTopInfoSection(t) {
     return {
         label: t('wordTable.filter.topInfo', '상단 정보'),
         items: [
-            { value: '표시', displayLabel: t('wordTable.filter.show', '표시') },
-            { value: '미표시', displayLabel: t('wordTable.filter.hide', '미표시') },
+            { value: SHOW, displayLabel: t('wordTable.filter.show', '표시') },
+            { value: HIDE, displayLabel: t('wordTable.filter.hide', '미표시') },
         ],
         display: 'segmented',
     };
@@ -59,8 +66,8 @@ export function buildBottomInfoSection(t) {
     return {
         label: t('wordTable.filter.bottomInfo', '하단 정보'),
         items: [
-            { value: '표시', displayLabel: t('wordTable.filter.show', '표시') },
-            { value: '미표시', displayLabel: t('wordTable.filter.hide', '미표시') },
+            { value: SHOW, displayLabel: t('wordTable.filter.show', '표시') },
+            { value: HIDE, displayLabel: t('wordTable.filter.hide', '미표시') },
         ],
         display: 'segmented',
     };
@@ -70,10 +77,10 @@ export function buildCutLineSection(t) {
     return {
         label: t('wordTable.filter.cutLine', '절취선'),
         items: [
-            { value: '표시', displayLabel: t('wordTable.filter.show', '표시') },
-            { value: '점선', displayLabel: t('wordTable.filter.dotted', '점선') },
-            { value: '코너', displayLabel: t('wordTable.filter.corner', '코너') },
-            { value: '미표시', displayLabel: t('wordTable.filter.hide', '미표시') },
+            { value: SHOW, displayLabel: t('wordTable.filter.show', '표시') },
+            { value: 'dashed', displayLabel: t('wordTable.filter.dotted', '점선') },
+            { value: 'corner', displayLabel: t('wordTable.filter.corner', '코너') },
+            { value: HIDE, displayLabel: t('wordTable.filter.hide', '미표시') },
         ],
         display: 'segmented',
     };
@@ -83,8 +90,8 @@ export function buildDivLineSection(t) {
     return {
         label: t('wordPrint.divLine', '대립선'),
         items: [
-            { value: '표시', displayLabel: t('wordTable.filter.show', '표시') },
-            { value: '미표시', displayLabel: t('wordTable.filter.hide', '미표시') },
+            { value: SHOW, displayLabel: t('wordTable.filter.show', '표시') },
+            { value: HIDE, displayLabel: t('wordTable.filter.hide', '미표시') },
         ],
         display: 'segmented',
     };
@@ -115,35 +122,40 @@ export function buildPageNumberSection(t) {
     return {
         label: t('wordTable.filter.pageNumber', '페이지 번호'),
         items: [
-            { value: '왼쪽', displayLabel: t('wordTable.filter.pageNumberLeft', '왼쪽') },
-            { value: '중앙', displayLabel: t('wordTable.filter.pageNumberCenter', '중앙') },
-            { value: '오른쪽', displayLabel: t('wordTable.filter.pageNumberRight', '오른쪽') },
-            { value: '미표시', displayLabel: t('wordTable.filter.hide', '미표시') },
+            { value: 'left', displayLabel: t('wordTable.filter.pageNumberLeft', '왼쪽') },
+            { value: 'center', displayLabel: t('wordTable.filter.pageNumberCenter', '중앙') },
+            { value: 'right', displayLabel: t('wordTable.filter.pageNumberRight', '오른쪽') },
+            { value: HIDE, displayLabel: t('wordTable.filter.hide', '미표시') },
         ],
         display: 'segmented',
     };
 }
-/** @public 페이지 번호 위치 → filterSelected 표시값. */
-export const PAGE_NUM_POSITION_VALUE = { left: '왼쪽', center: '중앙', right: '오른쪽', none: '미표시' };
-/** @public FilterPanel 선택값 → 페이지 번호 위치. */
+/**
+ * @public FilterPanel 선택값 → 페이지 번호 위치.
+ *
+ * **섹션의 `value` 가 곧 코드다.** 전에는 `value` 가 한글(`'왼쪽'`)이라 여기서 되돌리는 표
+ * (`PAGE_NUM_POSITION_VALUE`)와 파서가 **둘 다** 필요했다 — 값을 코드로 돌리니 그 둘이
+ * 항등식이 되어 표를 걷었다(2026-10-13). *옮기는 표가 사라지는 것이 옳게 옮긴 표시다.*
+ * 모르는 값은 `'none'` 으로 떨어뜨린다(옛 한글 값이 어디선가 오더라도 번호를 안 찍는다).
+ */
 export function parsePageNumberPosition(value) {
-    return value === '왼쪽' ? 'left' : value === '중앙' ? 'center' : value === '오른쪽' ? 'right' : 'none';
+    return value === 'left' || value === 'center' || value === 'right' ? value : 'none';
 }
 /** @public 기본 5개 설정의 filterSelected 엔트리(호출부가 자신의 추가 섹션과 spread). */
 export function buildTableSettingsSelected(t, v) {
     return {
         [t('wordTable.filter.composition', '구성')]: v.contentTypes,
-        [t('wordTable.filter.paperOrientation', '용지 방향')]: v.orientation === 'landscape' ? '가로' : '세로',
-        [t('wordTable.filter.border', '외곽선')]: v.showOutline ? '표시' : '미표시',
+        [t('wordTable.filter.paperOrientation', '용지 방향')]: v.orientation,
+        [t('wordTable.filter.border', '외곽선')]: v.showOutline ? SHOW : HIDE,
         [t('wordTable.filter.cutLine', '절취선')]: v.cutLine,
-        [t('wordPrint.divLine', '대립선')]: v.showDivLine ? '표시' : '미표시',
+        [t('wordPrint.divLine', '대립선')]: v.showDivLine ? SHOW : HIDE,
         /* **`undefined` 는 '안 쓴다' 다** — `false`('미표시')와 다르다. 띠를 안 쓰는 화면은
            값을 안 주므로 항목 자체를 안 넣는다. 지금은 절 목록에 그 절이 없어 어차피 안
            보이지만, 여기 죽은 항목을 남겨 두면 **요약이 절이 아니라 이 맵을 훑도록 바뀌는 날**
            쓰지도 않는 줄 둘이 따라 선다. 그렇게 될 뻔한 것을 말귀가 tarball 을 뜯어 보고
            짚었다(2026-09-30). 쪽 번호가 쓰던 꼴(`isPaginated ? {…} : {}`)과 같게 둔다. */
-        ...(v.showTopInfo != null ? { [t('wordTable.filter.topInfo', '상단 정보')]: v.showTopInfo ? '표시' : '미표시' } : {}),
-        ...(v.showBottomInfo != null ? { [t('wordTable.filter.bottomInfo', '하단 정보')]: v.showBottomInfo ? '표시' : '미표시' } : {}),
+        ...(v.showTopInfo != null ? { [t('wordTable.filter.topInfo', '상단 정보')]: v.showTopInfo ? SHOW : HIDE } : {}),
+        ...(v.showBottomInfo != null ? { [t('wordTable.filter.bottomInfo', '하단 정보')]: v.showBottomInfo ? SHOW : HIDE } : {}),
     };
 }
 /**
@@ -161,11 +173,11 @@ export function applyTableSettingsSelect(t, value, sectionLabel, s) {
         return true;
     }
     if (sectionLabel === t('wordTable.filter.paperOrientation', '용지 방향')) {
-        s.setOrientation(value === '가로' ? 'landscape' : 'portrait');
+        s.setOrientation(value === 'landscape' ? 'landscape' : 'portrait');
         return true;
     }
     if (sectionLabel === t('wordTable.filter.border', '외곽선')) {
-        s.setShowOutline(value === '표시');
+        s.setShowOutline(value === SHOW);
         return true;
     }
     if (sectionLabel === t('wordTable.filter.cutLine', '절취선')) {
@@ -173,15 +185,15 @@ export function applyTableSettingsSelect(t, value, sectionLabel, s) {
         return true;
     }
     if (sectionLabel === t('wordPrint.divLine', '대립선')) {
-        s.setShowDivLine(value === '표시');
+        s.setShowDivLine(value === SHOW);
         return true;
     }
     if (sectionLabel === t('wordTable.filter.topInfo', '상단 정보')) {
-        s.setShowTopInfo?.(value === '표시');
+        s.setShowTopInfo?.(value === SHOW);
         return true;
     }
     if (sectionLabel === t('wordTable.filter.bottomInfo', '하단 정보')) {
-        s.setShowBottomInfo?.(value === '표시');
+        s.setShowBottomInfo?.(value === SHOW);
         return true;
     }
     return false;