@ihabdevteam/core 0.149.0 → 0.151.0

package/dist/packages/core/src/hooks/useTablePaging.d.ts

@@ -42,8 +42,32 @@ export declare function useTablePaging<T>(rows: readonly T[], resetOn?: unknown,
     };
     setPage: import("react").Dispatch<import("react").SetStateAction<number>>;
 };
-/** 머리행 정렬 상태 — 같은 칸을 다시 누르면 방향이 뒤집힌다 @public */
-export declare function useTableSort<K extends string>(): {
+/** `useTableSort` 의 선택 인자. @public */
+export interface TableSortOptions<K extends string> {
+    /** 머리를 눌러 정렬이 바뀔 때 바뀐 정렬로 불린다 — 쪽을 따로 들고 있는 표가 첫 쪽으로 돌아가는 자리 등. */
+    onSortChange?: (sort: {
+        key: K;
+        asc: boolean;
+    }) => void;
+}
+/**
+ * 머리행 정렬 상태 — 같은 칸을 다시 누르면 방향이 뒤집힌다.
+ *
+ * **정렬이 바뀌면 첫 쪽으로** — `useTablePaging` 의 `resetOn` 에 돌려받은 `정렬` 을 그대로 넣는다.
+ * `정렬` 은 누를 때만 새 객체가 되므로(렌더마다 새로 만들지 않는다) 그 자체가 열쇠다. 쪽을 따로 들고 있으면 `onSortChange` 에서 되돌린다.
+ *
+ * `sortRows(rows, 값)` 은 지금 정렬로 줄을 세운 **새 배열**을 준다(정렬이 없으면 받은 배열 그대로) — `칸순`(숫자는 수로,
+ * 한글·영문은 사람 차례) 으로 견주고 **빈 값(null·undefined·'')은 오름·내림 모두 맨 뒤**(ListPopup 과 같은 규칙).
+ *
+ * @example
+ * const { 정렬, 칸, sortRows } = useTableSort<'name' | 'joined'>()
+ * const 세운줄 = useMemo(() => sortRows(rows, (r, key) => r[key]), [rows, sortRows])
+ * const { pageRows, pageSizeProps, paginationProps } = useTablePaging(세운줄, 정렬)   // 정렬이 바뀌면 첫 쪽
+ * <Table fields={[칸('이름', 'name'), 칸('가입일', 'joined')]} … />
+ *
+ * @public
+ */
+export declare function useTableSort<K extends string>(opts?: TableSortOptions<K>): {
     정렬: {
         key: K;
         asc: boolean;
@@ -53,4 +77,5 @@ export declare function useTableSort<K extends string>(): {
         sortDir: "desc" | "asc" | null;
         onClick: () => void;
     };
+    sortRows: <R>(rows: readonly R[], 값: (row: R, key: K) => unknown) => readonly R[];
 };

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

@@ -1,7 +1,8 @@
 'use client';
-import { useCallback, useMemo, useState } from 'react';
+import { useCallback, useMemo, useRef, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import { VAP_PAGE_SIZE_OPTIONS } from './useVisitAllPanel';
+import { 칸순빈값뒤 } from '../utils/textSort';
 /**
  * 표의 쪽넘김 — 개수 보기 · 쪽 · 이번 쪽 줄.
  *
@@ -60,11 +61,35 @@ export function useTablePaging(rows, resetOn, opts) {
         setPage,
     };
 }
-/** 머리행 정렬 상태 — 같은 칸을 다시 누르면 방향이 뒤집힌다 @public */
-export function useTableSort() {
+/**
+ * 머리행 정렬 상태 — 같은 칸을 다시 누르면 방향이 뒤집힌다.
+ *
+ * **정렬이 바뀌면 첫 쪽으로** — `useTablePaging` 의 `resetOn` 에 돌려받은 `정렬` 을 그대로 넣는다.
+ * `정렬` 은 누를 때만 새 객체가 되므로(렌더마다 새로 만들지 않는다) 그 자체가 열쇠다. 쪽을 따로 들고 있으면 `onSortChange` 에서 되돌린다.
+ *
+ * `sortRows(rows, 값)` 은 지금 정렬로 줄을 세운 **새 배열**을 준다(정렬이 없으면 받은 배열 그대로) — `칸순`(숫자는 수로,
+ * 한글·영문은 사람 차례) 으로 견주고 **빈 값(null·undefined·'')은 오름·내림 모두 맨 뒤**(ListPopup 과 같은 규칙).
+ *
+ * @example
+ * const { 정렬, 칸, sortRows } = useTableSort<'name' | 'joined'>()
+ * const 세운줄 = useMemo(() => sortRows(rows, (r, key) => r[key]), [rows, sortRows])
+ * const { pageRows, pageSizeProps, paginationProps } = useTablePaging(세운줄, 정렬)   // 정렬이 바뀌면 첫 쪽
+ * <Table fields={[칸('이름', 'name'), 칸('가입일', 'joined')]} … />
+ *
+ * @public
+ */
+export function useTableSort(opts) {
     const [정렬, 정렬바꾸기] = useState(null);
+    /* 다음 정렬은 **ref 에서** 계산해 알린다 — 갱신 함수 안에서 부르면 StrictMode 가 두 번 부른다 */
+    const 지금정렬 = useRef(정렬);
+    const 알림 = useRef(opts?.onSortChange);
+    알림.current = opts?.onSortChange;
     const 누름 = useCallback((key) => {
-        정렬바꾸기(앞 => 앞?.key === key ? { key, asc: !앞.asc } : { key, asc: true });
+        const 앞 = 지금정렬.current;
+        const 다음 = 앞?.key === key ? { key, asc: !앞.asc } : { key, asc: true };
+        지금정렬.current = 다음;
+        정렬바꾸기(다음);
+        알림.current?.(다음);
     }, []);
     /** Table 의 field 하나에 붙일 것 — 라벨과 함께 쓴다 */
     const 칸 = useCallback((label, key) => ({
@@ -72,6 +97,13 @@ export function useTableSort() {
         sortDir: 정렬?.key === key ? (정렬.asc ? 'asc' : 'desc') : null,
         onClick: () => 누름(key),
     }), [정렬, 누름]);
+    /** 지금 정렬로 세운 새 배열(정렬 없으면 받은 배열 그대로). 빈 값은 오름·내림 모두 맨 뒤. */
+    const sortRows = useCallback((rows, 값) => {
+        if (!정렬)
+            return rows;
+        const { key, asc } = 정렬;
+        return [...rows].sort((a, b) => 칸순빈값뒤(값(a, key), 값(b, key), asc));
+    }, [정렬]);
     /* 쪽넘김에 그대로 건넨다 — 차례가 바뀌면 첫 쪽으로 돌아가게 */
-    return { 정렬, 칸 };
+    return { 정렬, 칸, sortRows };
 }

package/dist/packages/core/src/hooks/useWordAttributeFilter.d.ts

@@ -1,6 +1,8 @@
 import { type ReactNode } from 'react';
 import type { TFunction } from 'i18next';
 import { type FilterPanelSection } from '../types/filterPanel';
+export { toWordAttributeFilterCodes, wordAttributeFilterFromCodes, normalizeWordAttributeFilter } from '../utils/wordAttributeFilterCodes';
+export type { WordAttributeFilterCodes, WordAttributeSectionCode } from '../utils/wordAttributeFilterCodes';
 /**
  * 등급/음절수/품사/어종 필터의 공용 i18n 키+맵.
  * 단어표(useWordSearch)·대립쌍표(useWordPairsSearch)·단어훈련(useWordTrainingFilter)이
@@ -68,5 +70,10 @@ export declare function buildPositionSection(t: TFunction, opts: {
  * @public 긍정형 다중 토글 섹션의 filterSelected 갱신 헬퍼 — 단어표·대립쌍표 공용.
  * '전체'(FILTER_ALL_VALUE)면 해당 섹션 해제, 그 외엔 값 토글, 남은 값이 없으면 key 자체를 제거한다.
  * (FilterPanel은 로케일과 무관하게 FILTER_ALL_VALUE를 방출하므로 t('common.all', '전체')과 비교하면 안 된다.)
+ *
+ * **속성 섹션(등급·음절 수·품사·어종)은 값을 코드로 견준다** — prev 에 다른 언어·옛 라벨로 든 같은 섹션이 있으면 그것을 읽어
+ * `sectionLabel` 의 언어 라벨로 합쳐 적는다. 전에는 한국어로 저장된 '품사' 가 영어 화면의 'Part of Speech' 옆에 따로 남아,
+ * 칩은 꺼진 채로 보이는데 필터는 걸려 있었고 끌 길이 없었다. 반환 모양(라벨 열쇠·라벨 값)은 그대로다.
+ * 저장할 때는 `toWordAttributeFilterCodes` 로 코드 모양을 함께 담는다.
  */
 export declare function toggleAttributeFilter(prev: Record<string, string[]>, value: string, sectionLabel: string): Record<string, string[]>;

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

@@ -2,6 +2,9 @@
 import { useMemo } from 'react';
 import { useTranslation } from 'react-i18next';
 import { FILTER_ALL_VALUE } from '../types/filterPanel';
+import { toWordAttributeFilterCodes, wordAttributeFilterFromCodes, wordAttributeSectionOf, wordAttributeValueCodeOf, wordAttributeLabelLanguageOf, } from '../utils/wordAttributeFilterCodes';
+/* 저장용 코드 모양과 오가는 도구 — 공용 속성 필터를 언어와 무관하게 저장·복원한다(utils/wordAttributeFilterCodes) */
+export { toWordAttributeFilterCodes, wordAttributeFilterFromCodes, normalizeWordAttributeFilter } from '../utils/wordAttributeFilterCodes';
 /**
  * @public
  * 등급/음절수/품사/어종 필터의 공용 라벨+매핑을 만든다. 세 화면(단어표/대립쌍표/단어훈련)이
@@ -100,8 +103,30 @@ export function buildPositionSection(t, opts) {
  * @public 긍정형 다중 토글 섹션의 filterSelected 갱신 헬퍼 — 단어표·대립쌍표 공용.
  * '전체'(FILTER_ALL_VALUE)면 해당 섹션 해제, 그 외엔 값 토글, 남은 값이 없으면 key 자체를 제거한다.
  * (FilterPanel은 로케일과 무관하게 FILTER_ALL_VALUE를 방출하므로 t('common.all', '전체')과 비교하면 안 된다.)
+ *
+ * **속성 섹션(등급·음절 수·품사·어종)은 값을 코드로 견준다** — prev 에 다른 언어·옛 라벨로 든 같은 섹션이 있으면 그것을 읽어
+ * `sectionLabel` 의 언어 라벨로 합쳐 적는다. 전에는 한국어로 저장된 '품사' 가 영어 화면의 'Part of Speech' 옆에 따로 남아,
+ * 칩은 꺼진 채로 보이는데 필터는 걸려 있었고 끌 길이 없었다. 반환 모양(라벨 열쇠·라벨 값)은 그대로다.
+ * 저장할 때는 `toWordAttributeFilterCodes` 로 코드 모양을 함께 담는다.
  */
 export function toggleAttributeFilter(prev, value, sectionLabel) {
+    const 섹션 = wordAttributeSectionOf(sectionLabel);
+    const 값코드 = 섹션 && value !== FILTER_ALL_VALUE ? wordAttributeValueCodeOf(섹션, value) : null;
+    if (섹션 && (value === FILTER_ALL_VALUE || 값코드)) {
+        const 남김 = {};
+        const 같은섹션 = {};
+        for (const [k, v] of Object.entries(prev))
+            (wordAttributeSectionOf(k) === 섹션 ? 같은섹션 : 남김)[k] = v;
+        if (value === FILTER_ALL_VALUE)
+            return 남김;
+        const 지금 = toWordAttributeFilterCodes(같은섹션)[섹션] ?? [];
+        const 다음 = 지금.includes(값코드) ? 지금.filter(c => c !== 값코드) : [...지금, 값코드];
+        if (다음.length === 0)
+            return 남김;
+        const 라벨 = wordAttributeFilterFromCodes({ [섹션]: 다음 }, wordAttributeLabelLanguageOf(sectionLabel));
+        const 값들 = Object.values(라벨)[0] ?? [];
+        return { ...남김, [sectionLabel]: 값들 };
+    }
     if (value === FILTER_ALL_VALUE) {
         const { [sectionLabel]: _omit, ...rest } = prev;
         return rest;

package/dist/packages/core/src/i18n/index.js

@@ -31,8 +31,16 @@ export const LOCALE_STORAGE_KEY = 'ihab_display_language';
  * `test/versionOnEverySubpath.test.ts` 가 갈래마다 이것이 있는지 센다.
  */
 export { CORE_VERSION } from '../version';
-/** localStorage에서 저장된 언어 코드를 읽어온다. 없거나 지원하지 않는 코드면 기본값 반환. */
+/**
+ * localStorage에서 저장된 언어 코드를 읽어온다. 없거나 지원하지 않는 코드면 기본값 반환.
+ *
+ * **서버(window 없음)에서는 읽지 않고 DEFAULT_LOCALE.** Node 22+ 는 자기 전역 localStorage 를 갖고 있어
+ * (`--localstorage-file`) 서버가 저장소에 남은 언어로 첫 화면을 그리면 브라우저의 첫 렌더와 어긋난다.
+ * 브라우저에서는 지금처럼 저장 언어로 시작한다(SPA 첫 화면 유지). SSR 앱은 수화 뒤 저장된 언어로 `i18n.changeLanguage` 한다.
+ */
 function getSavedLocale() {
+    if (typeof window === 'undefined')
+        return DEFAULT_LOCALE;
     try {
         const saved = localStorage.getItem(LOCALE_STORAGE_KEY);
         if (saved && SUPPORTED_LOCALES.some(l => l.code === saved))

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

@@ -393,9 +393,11 @@
         "cardInstructions": "Look at the word card, listen to the sound, and check it.",
         "noCards": "No cards.",
         "audioFetchError": "Failed to load the sound source.",
+        "ttsUnavailable": "Speech playback isn't available on this device.",
         "selectConfirm": "Look at the question and select the answer.",
         "orderListDefault": "Arrange the sentences in the order you heard.",
         "result": {
+            "pendingDone": "Results are still being calculated, so you can't finish yet.",
             "eyebrow": "Training Complete",
             "title": "You've finished all the training!",
             "scoreAria": "{{correct}} / {{total}} questions",
@@ -763,7 +765,7 @@
             "empty": "No saved word tables.",
             "loadButton": "Load",
             "itemCount": "{{count}} words",
-            "deleteAriaLabel": "Delete",
+            "deleteAriaLabel": "Delete {{name}}",
             "sort": {
                 "newest": "Newest",
                 "oldest": "Oldest",
@@ -885,7 +887,8 @@
             "syllable": "Syllables ↑",
             "syllableDesc": "Syllables ↓",
             "grade": "Grade ↑",
-            "gradeDesc": "Grade ↓"
+            "gradeDesc": "Grade ↓",
+            "original": "Original order"
         },
         "pageSize": "Show {{count}}",
         "pageSizeAria": "Page size",
@@ -1440,5 +1443,24 @@
     },
     "breadcrumb": {
         "ariaLabel": "Breadcrumb"
+    },
+    "board": {
+        "empty": "No items yet."
+    },
+    "promoBannerBg": {
+        "main": "Main gradient",
+        "soft": "Soft",
+        "sub": "Sub color",
+        "deep": "Deep gradient",
+        "softSub": "Soft sub",
+        "warm": "Warm (accent)",
+        "dark": "Dark",
+        "radial": "Radial gradient",
+        "diagonal": "Diagonal pattern",
+        "dots": "Dot pattern",
+        "outline": "Outline",
+        "success": "Success / done",
+        "naver": "Naver blog notice",
+        "instagram": "Instagram notice"
     }
 }

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

@@ -391,9 +391,11 @@
         "cardInstructions": "낱말 카드를 보고 소리를 듣고 확인하세요.",
         "noCards": "카드가 없습니다.",
         "audioFetchError": "사운드 소스를 가져오지 못했습니다.",
+        "ttsUnavailable": "이 기기에서는 음성을 들려줄 수 없습니다.",
         "selectConfirm": "문제를 보고 해당하는 내용을 선택하세요.",
         "orderListDefault": "문장을 들은 순서대로 배치하세요.",
         "result": {
+            "pendingDone": "결과를 계산하는 중이라 아직 완료할 수 없습니다.",
             "eyebrow": "훈련 완료",
             "title": "훈련을 모두 마쳤습니다.",
             "scoreAria": "{{correct}} / {{total}} 문항",
@@ -761,7 +763,7 @@
             "empty": "저장된 단어 표가 없습니다.",
             "loadButton": "불러오기",
             "itemCount": "{{count}}개",
-            "deleteAriaLabel": "삭제",
+            "deleteAriaLabel": "{{name}} 삭제",
             "sort": {
                 "newest": "최신순",
                 "oldest": "오래된순",
@@ -883,7 +885,8 @@
             "syllable": "음절 수 ↑",
             "syllableDesc": "음절 수 ↓",
             "grade": "등급순 ↑",
-            "gradeDesc": "등급순 ↓"
+            "gradeDesc": "등급순 ↓",
+            "original": "받은 순서"
         },
         "pageSize": "{{count}}개씩 보기",
         "pageSizeAria": "페이지 크기",
@@ -1438,5 +1441,24 @@
     },
     "breadcrumb": {
         "ariaLabel": "이동 경로"
+    },
+    "board": {
+        "empty": "등록된 항목이 없습니다."
+    },
+    "promoBannerBg": {
+        "main": "메인 그라디언트",
+        "soft": "소프트",
+        "sub": "서브 컬러",
+        "deep": "딥 그라디언트",
+        "softSub": "소프트 서브",
+        "warm": "웜(강조)",
+        "dark": "다크",
+        "radial": "방사형 그라디언트",
+        "diagonal": "대각선 패턴",
+        "dots": "도트 패턴",
+        "outline": "아웃라인",
+        "success": "성공/완료",
+        "naver": "네이버 블로그 안내",
+        "instagram": "인스타그램 안내"
     }
 }

package/dist/packages/core/src/tokens.css

@@ -244,8 +244,13 @@
   --z-content: 1;
   --z-dropdown: 200;
   --z-sticky: 500;
+  /* 선택 막대(BulkBar) — 페이지 내용·붙박이 위, 내비·메뉴 아래 */
+  --z-bulk-bar: 600;
   --z-nav: 1000;
   --z-sidebar: 1100;
+  /* body 로 빠지는 메뉴(Dropdown·DatePicker·Header·BottomNav 더보기) — 내비·사이드바 위, 창(overlay·page-popup·modal) 아래.
+     창·툴팁 안에서 연 메뉴는 anchoredMenuZIndex 가 그 층 바로 위로 올린다. 서열: 페이지 < BulkBar < 메뉴 < 창 < 툴팁 < 알림 < 토스트 */
+  --z-menu: 1500;
   --z-overlay: 2000;
   --z-page-popup: 2100;  /* 훈련 팝업 전체화면 */
   /* 플로팅 버튼(버그신고 FAB 등) — page-popup 위에 떠서 훈련 중에도 쓸 수 있어야 하지만,

package/dist/packages/core/src/types/wordSearch.d.ts

@@ -34,12 +34,24 @@ export interface WordTableSearchConfig {
     inputMode: 'word' | 'phoneme';
     positionCount: number;
     filterScope: 'all' | 'searchWordOnly';
+    /** 필터 선택(라벨 열쇠·라벨 값 — 저장한 때의 언어). 속성 섹션은 어느 언어로 적혀 있어도 코어가 읽는다. */
     filterSelected: Record<string, string[]>;
+    /**
+     * 선택. 공용 속성 필터(등급·음절 수·품사·어종)를 **언어와 무관한 코드**로 — `toWordAttributeFilterCodes(filterSelected)`.
+     * 있으면 복원할 때 `wordAttributeFilterFromCodes` 로 지금 언어 라벨을 만든다(라벨 쪽보다 앞선다).
+     */
+    attributeCodes?: import('../utils/wordAttributeFilterCodes').WordAttributeFilterCodes;
     phonemeSelected: Record<string, string>[];
 }
 /** 단어표(단일)의 검색 구성 — 수정 시 필터 패널을 복원하기 위해 저장한다. */
 export interface WordSearchFilterConfig {
+    /** 필터 선택(라벨 열쇠·라벨 값 — 저장한 때의 언어). 속성 섹션은 어느 언어로 적혀 있어도 코어가 읽는다. */
     filterSelected: Record<string, string | string[]>;
+    /**
+     * 선택. 공용 속성 필터(등급·음절 수·품사·어종)를 **언어와 무관한 코드**로 — `toWordAttributeFilterCodes(filterSelected)`.
+     * 있으면 복원할 때 `wordAttributeFilterFromCodes` 로 지금 언어 라벨을 만든다(라벨 쪽보다 앞선다).
+     */
+    attributeCodes?: import('../utils/wordAttributeFilterCodes').WordAttributeFilterCodes;
     /**
      * 입력 방식 — 'char'(글자 선택, 기본) | 'pron'(발음 선택) | 'direct'(글자 입력·직접입력).
      * 'char'/'pron'은 초성/중성/종성+위치 버튼 선택 모드로 UI는 동일하고 매칭 대상만 철자(word)/표준발음(pronunciation)으로 다르다.

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

@@ -9,7 +9,11 @@
  *    뒤 열이 통째로 밀린다.
  * 2. **수식으로 실행되지 않게.** `=`·`+`·`-`·`@` 로 시작하는 값을 엑셀·시트가 수식으로
  *    실행한다(CSV Injection). 탭이나 CR 로 시작하는 경우도 파서가 앞의 공백문자를 버리고
- *    그다음 글자를 첫 글자로 읽으므로 같은 결과가 된다(OWASP 권고).
+ *    그다음 글자를 첫 글자로 읽으므로 같은 결과가 된다. 앞에 **작은따옴표 `'`** 를 세운다(OWASP 권고) —
+ *    전에는 탭을 세웠는데, 탭도 앞 공백으로 버리는 판에서는 수식이 그대로 살아났다.
+ *
+ * 선행 0(`007`·`010-…`)은 건드리지 않는다(결정 2026-09-15) — 엑셀이 숫자로 읽어 0 을 떼는 것은 여는 쪽의 일이고,
+ * 여기서 글자로 박으면 그 값을 다시 읽는 프로그램이 따옴표를 떠안는다.
  *
  * 이 규칙이 두 군데에 따로 적혀 있었고, 고객 목록 쪽 사본이 `\r` 둘 다를 빠뜨린 채
  * "어드민과 동일한 규칙"이라고 주석까지 달고 있었다.
@@ -17,6 +21,7 @@
 export declare function escapeCsvField(v: unknown): string;
 /**
  * 브라우저에서 CSV 파일을 내려받게 한다. 앞에 BOM 을 붙인다 — 없으면 엑셀이 한글을
- * 깨뜨린다.
+ * 깨뜨린다. **이미 BOM 으로 시작하는 글에는 또 붙이지 않는다**(두 번 붙으면 엑셀 첫 칸 머리에 보이지 않는 글자가 낀다).
+ * Blob 주소는 누르고 조금 뒤에 회수한다.
  */
 export declare function downloadCsvText(filename: string, csv: string): void;

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

@@ -9,7 +9,11 @@
  *    뒤 열이 통째로 밀린다.
  * 2. **수식으로 실행되지 않게.** `=`·`+`·`-`·`@` 로 시작하는 값을 엑셀·시트가 수식으로
  *    실행한다(CSV Injection). 탭이나 CR 로 시작하는 경우도 파서가 앞의 공백문자를 버리고
- *    그다음 글자를 첫 글자로 읽으므로 같은 결과가 된다(OWASP 권고).
+ *    그다음 글자를 첫 글자로 읽으므로 같은 결과가 된다. 앞에 **작은따옴표 `'`** 를 세운다(OWASP 권고) —
+ *    전에는 탭을 세웠는데, 탭도 앞 공백으로 버리는 판에서는 수식이 그대로 살아났다.
+ *
+ * 선행 0(`007`·`010-…`)은 건드리지 않는다(결정 2026-09-15) — 엑셀이 숫자로 읽어 0 을 떼는 것은 여는 쪽의 일이고,
+ * 여기서 글자로 박으면 그 값을 다시 읽는 프로그램이 따옴표를 떠안는다.
  *
  * 이 규칙이 두 군데에 따로 적혀 있었고, 고객 목록 쪽 사본이 `\r` 둘 다를 빠뜨린 채
  * "어드민과 동일한 규칙"이라고 주석까지 달고 있었다.
@@ -19,19 +23,22 @@ export function escapeCsvField(v) {
     /* 숫자 값은 수식이 아니다 — 음수(환불 금액 등)에 탭을 붙이면 엑셀이 글자 칸으로 읽어 합계가 안 된다.
        글자 '-2+3' 은 그대로 막는다. */
     if (!(typeof v === 'number' && Number.isFinite(v)) && /^[=+\-@\t\r]/.test(s))
-        s = '\t' + s;
+        s = "'" + s;
     return /[",\n\r]/.test(s) ? `"${s.replaceAll('"', '""')}"` : s;
 }
+/** 내려받기를 누른 뒤 Blob 주소를 회수하기까지 — 곧바로 회수하면 Safari 가 내려받기를 시작하기 전에 주소가 사라졌다. */
+const BLOB_REVOKE_DELAY_MS = 1000;
 /**
  * 브라우저에서 CSV 파일을 내려받게 한다. 앞에 BOM 을 붙인다 — 없으면 엑셀이 한글을
- * 깨뜨린다.
+ * 깨뜨린다. **이미 BOM 으로 시작하는 글에는 또 붙이지 않는다**(두 번 붙으면 엑셀 첫 칸 머리에 보이지 않는 글자가 낀다).
+ * Blob 주소는 누르고 조금 뒤에 회수한다.
  */
 export function downloadCsvText(filename, csv) {
-    const blob = new Blob(['' + csv], { type: 'text/csv;charset=utf-8' });
+    const blob = new Blob([csv.startsWith('\uFEFF') ? csv : '\uFEFF' + csv], { type: 'text/csv;charset=utf-8' });
     const url = URL.createObjectURL(blob);
     const a = document.createElement('a');
     a.href = url;
     a.download = filename;
     a.click();
-    URL.revokeObjectURL(url);
+    setTimeout(() => URL.revokeObjectURL(url), BLOB_REVOKE_DELAY_MS);
 }

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

@@ -25,14 +25,45 @@ function mulberry32(seed) {
 }
 // shuffle/sample은 공용 utils/array로 통일(시드 rng 지원 동일). 여기선 sampleArray 이름만 유지해 내부에서 사용.
 const sampleArray = sample;
-// 시드가 주어지면 한 PRNG로 모든 타입을 결정적 추출 → 기기/세션 무관 동일 선택
-function createSelection(counts, seed) {
-    const rng = seed ? mulberry32(hashSeed(seed)) : Math.random;
+/** KST 날짜 'YYYY-MM-DD' → 날 번호(1970-01-01 = 0). 홀짝으로 이틀마다 번갈아 쓸 반쪽을 고른다. */
+const 날번호 = (ymd) => {
+    const [y, m, d] = ymd.split('-').map(Number);
+    return Math.round(Date.UTC(y, (m || 1) - 1, d || 1) / 86_400_000);
+};
+/** 항목을 가리키는 열쇠 — 자료의 id(없으면 name). 자료가 늘거나 차례가 바뀌어도 그 항목의 반쪽이 안 바뀌게 */
+const 항목열쇠 = (it, i) => {
+    const o = (it ?? {});
+    return String(o.id ?? o.name ?? i);
+};
+/**
+ * 한 유형의 그 날 세트.
+ *
+ * **(c) 시드는 유형마다 따로**(사용자|날짜|유형) — 전에는 네 유형이 난수 한 줄기를 차례로 나눠 써서, 짧은 이야기 자료가 하나
+ * 늘면 뒤 유형(긴 이야기·순서 맞추기) 세트까지 바뀌었다.
+ *
+ * **(b) 어제 고른 항목은 오늘 빼고 고른다.** 저장 없이 결정적으로 뽑는 훅이라 "어제 세트" 는 어제 날짜로 같은 규칙을 다시 계산한
+ * 것인데, 그것을 빼고 뽑는 규칙을 그대로 되풀이하면 어제 세트도 그제 세트를 빼고 뽑은 것이어야 해서 끝없이 거슬러 올라가고,
+ * 한 단계만 거슬러 올라가면 '어제 보기' 가 어제 실제로 뜬 세트와 달라진다. 그래서 **항목마다 사용자·유형으로 반쪽(홀·짝)을
+ * 정하고, 날 번호의 홀짝에 맞는 반쪽에서만 뽑는다** — 이웃한 두 날은 늘 다른 반쪽이라 겹치지 않고, 어제 보기는 어제 계산과 같다.
+ * 두 반쪽이 모두 필요한 개수 이상일 때만(후보가 충분할 때) 이렇게 하고, 모자라면 전처럼 전체에서 뽑는다(빈 세트로 두지 않는다).
+ */
+function 유형세트(pool, n, userId, ymd, type) {
+    if (!pool.length || n <= 0)
+        return [];
+    const rng = mulberry32(hashSeed(`${userId}|${ymd}|${type}`));
+    const 쪽 = 날번호(ymd) & 1;
+    const 이쪽 = pool.filter((it, i) => ((hashSeed(`${userId}|${type}|${항목열쇠(it, i)}`) >>> 7) & 1) === 쪽);
+    const 충분 = 이쪽.length >= n && pool.length - 이쪽.length >= n;
+    return sampleArray((충분 ? 이쪽 : pool), n, rng);
+}
+// (user, 날짜)로 결정적 추출 → 기기/세션 무관 동일 선택. 유형마다 시드가 따로다(위 유형세트).
+function createSelection(counts, userId, ymd) {
+    const 개수 = (k) => Math.max(0, counts[k] || 0);
     return {
-        LISTEN_IN_NOISE: sampleArray(NOISE_DATAS, Math.max(0, counts.LISTEN_IN_NOISE || 0), rng),
-        SHORT_STORY: sampleArray(SHORT_STORIES, Math.max(0, counts.SHORT_STORY || 0), rng),
-        LONG_STORY: sampleArray(LONG_STORIES, Math.max(0, counts.LONG_STORY || 0), rng),
-        ORDERING_SENTENCE: sampleArray(ORDER_SETS, Math.max(0, counts.ORDERING_SENTENCE || 0), rng),
+        LISTEN_IN_NOISE: 유형세트(NOISE_DATAS, 개수('LISTEN_IN_NOISE'), userId, ymd, 'LISTEN_IN_NOISE'),
+        SHORT_STORY: 유형세트(SHORT_STORIES, 개수('SHORT_STORY'), userId, ymd, 'SHORT_STORY'),
+        LONG_STORY: 유형세트(LONG_STORIES, 개수('LONG_STORY'), userId, ymd, 'LONG_STORY'),
+        ORDERING_SENTENCE: 유형세트(ORDER_SETS, 개수('ORDERING_SENTENCE'), userId, ymd, 'ORDERING_SENTENCE'),
     };
 }
 export function hasItems(s) {
@@ -48,21 +79,20 @@ const DEFAULT_TRAINING_COUNTS = {
     LONG_STORY: 1,
     ORDERING_SENTENCE: 2,
 };
-// userId 시드 → (user, 날짜)별 결정적 선택. 모든 기기/세션에서 동일하므로
-// localStorage 캐시 없이 매번 결정적으로 재계산한다(저장 없음).
+// userId 시드 → (user, 날짜, 유형)별 결정적 선택. 모든 기기/세션에서 동일하므로
+// localStorage 캐시 없이 매번 결정적으로 재계산한다(저장 없음). 이웃한 두 날의 세트는 후보가 충분하면 겹치지 않는다(유형세트).
 export function resolveSelection(_forceRefresh = false, counts = DEFAULT_TRAINING_COUNTS, userId) {
     // 서버 완료집계와 동일하게 KST 기준 날짜. userId 없어도 날짜로 결정적(Math.random 비결정성 제거)
     const today = toKstYmd(Date.now());
     const yesterday = toKstYmd(Date.now() - 86400000);
-    const seedToday = `${userId ?? ''}|${today}`;
-    const seedYesterday = `${userId ?? ''}|${yesterday}`;
+    const u = userId ?? '';
     const hasSource = NOISE_DATAS.length > 0 || SHORT_STORIES.length > 0 ||
         LONG_STORIES.length > 0 || ORDER_SETS.length > 0;
     if (!hasSource) {
-        return { today: createSelection(counts, seedToday), yesterday: null };
+        return { today: createSelection(counts, u, today), yesterday: null };
     }
     return {
-        today: createSelection(counts, seedToday),
-        yesterday: createSelection(counts, seedYesterday),
+        today: createSelection(counts, u, today),
+        yesterday: createSelection(counts, u, yesterday),
     };
 }

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

@@ -28,6 +28,12 @@ export declare function formatDatetimeKo(iso: string): string;
 export declare function toKstHm(when?: string | number | Date | null): string;
 /** KST(Asia/Seoul) 기준 오늘 날짜를 'YYYY-MM-DD'로 반환. DB 날짜 비교 기준선으로 사용. */
 export declare function getTodayKst(): string;
+/**
+ * 부르는 쪽이 정한 '오늘'('YYYY-MM-DD')이 있으면 그것, 없거나 꼴이 틀리면 KST 오늘.
+ * Calendar·DatePicker·useCalendarMonth 의 `today` 가 쓴다(로컬 앱·SSR 이 서버와 같은 날을 넘기는 자리).
+ * 공개 export 아님(utils.ts 가 다시 내보내지 않는다).
+ */
+export declare function todayYmdOr(today?: string | null): string;
 /**
  * KST 오늘을 **기기 달력의 자정 Date** 로 — 연·월·일 칸을 `getFullYear()/getMonth()/getDate()` 로 세는 곳(BarChart)의
  * '지금'. 칸에 넣는 자료도 같은 모양(`parseLocalYmd(toKstYmd(시각))`)이어야 해외 기기에서도 KST 의 날에 선다.
@@ -63,11 +69,13 @@ export declare function parseLocalYmd(ymd: string): Date;
  * 문자열을 낸다 — 연·월·일 경계 표본으로 대조했다.)
  *
  * 빈 값·못 읽는 값은 빈 문자열이다. 0(epoch)은 유효한 값이라 그대로 옮긴다.
+ * 시간대 없는 시각 글자('2026-09-30 20:00:00')는 KST 벽시계 시각으로 읽는다(날짜만 있는 글자는 그대로).
  */
 export declare function toKstYmd(when?: string | number | Date | null): string;
 type TranslateFn = import('i18next').TFunction;
 /**
  * ISO 문자열을 'store.time.*' i18n 키 기반 상대시간 문자열로 변환.
+ * 시간대 없는 시각 글자는 KST 벽시계 시각으로 읽는다.
  * (예: 방금 전 / N분 전 / N시간 전 / N일 전 …)
  * 빈/유효하지 않은 입력은 빈 문자열을 반환한다.
  */

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

@@ -16,12 +16,35 @@
  * 영어로 보더라도 가리키는 날은 같아야 한다.
  */
 const KST = 'Asia/Seoul';
+/* 시간대 없는 벽시계 시각 — 'YYYY-MM-DDTHH:mm[:ss[.fff…]]' 또는 가운데가 빈칸('YYYY-MM-DD HH:mm:ss', Postgres timestamp 꼴).
+   뒤돌아보기 없이(iOS 15 Safari) 끝까지 맞춘다 — 뒤에 Z·±hh:mm 이 붙으면 걸리지 않는다. */
+const 벽시계시각 = /^(\d{4}-\d{2}-\d{2})[T ](\d{2}:\d{2})(?::(\d{2})(?:\.(\d+))?)?$/;
+/**
+ * 날짜·시각 값을 순간(Date)으로 읽는 **이 파일의 공용 파서.** 못 읽는 값(빈 값·깨진 글자)이면 null.
+ *
+ * **시간대 없는 시각 글자는 KST 벽시계 시각으로 읽는다**(끝에 +09:00 을 붙인 것처럼, 2026-09-15 결정).
+ * `new Date('2026-09-30T20:00:00')` 은 **기기 지역시각**으로 해석된다 — KST 기기에서는 우연히 맞고, 뉴욕 기기에서는
+ * 13시간 밀려 날짜까지 바뀌었다. 빈칸 꼴('2026-09-30 20:00:00')은 Safari 가 아예 못 읽었다.
+ * 날짜만 있는 'YYYY-MM-DD' 는 지금 규칙(UTC 자정 = KST 같은 날 9시)을 그대로 따른다.
+ * Date·숫자·오프셋 있는 글자는 그대로.
+ */
+function 순간으로(when) {
+    let d;
+    if (when instanceof Date)
+        d = when;
+    else if (typeof when === 'string') {
+        const s = when.trim();
+        const m = 벽시계시각.exec(s);
+        /* 소수 초는 세 자리까지만 — 여섯 자리(Postgres)는 엔진마다 읽기가 갈린다 */
+        d = new Date(m ? `${m[1]}T${m[2]}:${m[3] ?? '00'}${m[4] ? `.${m[4].slice(0, 3).padEnd(3, '0')}` : ''}+09:00` : s);
+    }
+    else
+        d = new Date(when);
+    return Number.isNaN(d.getTime()) ? null : d;
+}
 /* 못 읽는 값(빈 문자열·깨진 날짜)이면 null — 아래 형식 함수들이 화면에 "Invalid Date" 를 그대로 내던 것을 빈 글자로 막는다
    (같은 파일의 toKstYmd·formatYmd 는 이미 막고 있었다) */
-const 읽은날 = (iso) => {
-    const d = new Date(iso);
-    return Number.isNaN(d.getTime()) ? null : d;
-};
+const 읽은날 = (iso) => 순간으로(iso);
 export function formatDateKo(iso) {
     const d = 읽은날(iso);
     if (!d)
@@ -87,8 +110,8 @@ export function formatDatetimeKo(iso) {
 export function toKstHm(when) {
     if (when === null || when === undefined || when === '')
         return '';
-    const d = when instanceof Date ? when : new Date(when);
-    if (isNaN(d.getTime()))
+    const d = 순간으로(when);
+    if (!d)
         return '';
     return new Intl.DateTimeFormat('en-GB', {
         timeZone: KST, hour: '2-digit', minute: '2-digit', hour12: false,
@@ -98,6 +121,14 @@ export function toKstHm(when) {
 export function getTodayKst() {
     return toKstYmd(new Date());
 }
+/**
+ * 부르는 쪽이 정한 '오늘'('YYYY-MM-DD')이 있으면 그것, 없거나 꼴이 틀리면 KST 오늘.
+ * Calendar·DatePicker·useCalendarMonth 의 `today` 가 쓴다(로컬 앱·SSR 이 서버와 같은 날을 넘기는 자리).
+ * 공개 export 아님(utils.ts 가 다시 내보내지 않는다).
+ */
+export function todayYmdOr(today) {
+    return today && /^\d{4}-\d{2}-\d{2}$/.test(today) ? today : getTodayKst();
+}
 /**
  * KST 오늘을 **기기 달력의 자정 Date** 로 — 연·월·일 칸을 `getFullYear()/getMonth()/getDate()` 로 세는 곳(BarChart)의
  * '지금'. 칸에 넣는 자료도 같은 모양(`parseLocalYmd(toKstYmd(시각))`)이어야 해외 기기에서도 KST 의 날에 선다.
@@ -141,26 +172,29 @@ export function parseLocalYmd(ymd) {
  * 문자열을 낸다 — 연·월·일 경계 표본으로 대조했다.)
  *
  * 빈 값·못 읽는 값은 빈 문자열이다. 0(epoch)은 유효한 값이라 그대로 옮긴다.
+ * 시간대 없는 시각 글자('2026-09-30 20:00:00')는 KST 벽시계 시각으로 읽는다(날짜만 있는 글자는 그대로).
  */
 export function toKstYmd(when) {
     if (when === null || when === undefined || when === '')
         return '';
-    const d = when instanceof Date ? when : new Date(when);
-    if (isNaN(d.getTime()))
+    const d = 순간으로(when);
+    if (!d)
         return '';
     return new Intl.DateTimeFormat('fr-CA', { timeZone: 'Asia/Seoul' }).format(d);
 }
 /**
  * ISO 문자열을 'store.time.*' i18n 키 기반 상대시간 문자열로 변환.
+ * 시간대 없는 시각 글자는 KST 벽시계 시각으로 읽는다.
  * (예: 방금 전 / N분 전 / N시간 전 / N일 전 …)
  * 빈/유효하지 않은 입력은 빈 문자열을 반환한다.
  */
 export function formatRelativeTime(input, t) {
     if (!input)
         return '';
-    const then = new Date(input).getTime();
-    if (Number.isNaN(then))
+    const d = 순간으로(input);
+    if (!d)
         return '';
+    const then = d.getTime();
     const sec = Math.max(0, Math.floor((Date.now() - then) / 1000));
     const min = Math.floor(sec / 60), hour = Math.floor(min / 60), day = Math.floor(hour / 24);
     const week = Math.floor(day / 7), month = Math.floor(day / 30), year = Math.floor(day / 365);

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

@@ -11,7 +11,7 @@ export declare function formatPhone(raw: string): string;
  * 그대로 잘랐는데(`2026-08-19T16:00:00Z` → `2026.08.19`), 그건 UTC 날짜라 KST 자정~
  * 아침 아홉 시 사이의 값이 전부 하루 전으로 보였다. 이 함수를 쓰는 곳이 전부 그랬다 —
  * 회원의 문의 등록일, 고객 등록일. 날짜만 있는 값(YYYY-MM-DD)은 시각이 없으니
- * 옮길 것도 없어 그대로 둔다.
+ * 옮길 것도 없어 그대로 둔다. 시간대 없는 시각('2026-09-30 20:00:00')은 KST 벽시계 시각으로 읽는다.
  */
 export declare function normalizeDate(input: string | null | undefined): string | undefined;
 /**