@ihabdevteam/core 0.8.0

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

@@ -0,0 +1,350 @@
+/// <reference path="../types/lucide-deep-imports.d.ts" />
+// ↑ deep import 에 타입을 붙이는 앰비언트 선언. 이 파일에 붙여 두는 이유:
+// 소비 앱은 tsconfig 의 paths 로 core 소스를 직접 보는데, 그 include 에는
+// core 의 types/ 가 안 걸려 선언이 로드되지 않는다(관측: speechear TS7016 159개).
+// 참조를 쓰는 파일에 두면 import 를 타고 따라온다.
+/**
+ * lucide 아이콘의 개별 모듈을 직접 가져옵니다.
+ *
+ * `import { Ear } from 'lucide-react'` 이 아닌 이유: 배럴(dist/esm/lucide-react.mjs)이
+ * 아이콘 전체를 네임스페이스로 재수출합니다.
+ *
+ *     import * as index from './icons/index.mjs'
+ *     export { index as icons }
+ *
+ * `sideEffects: false` 여도 이 재수출이 있으면, 배럴 모듈이 청크 경계에 고정되는
+ * 순간 1,700여 개가 통째로 남습니다. webpack 은 이걸 떨궈내지만 rollup/vite 는
+ * 못 합니다 — 같은 core 를 쓰는데도 kscan(webpack)은 페이지당 125개, speechear
+ * (vite)는 1,731개가 실렸습니다. 배럴을 아예 거치지 않으면 번들러와 무관하게
+ * 필요한 것만 남습니다.
+ *
+ * 경로가 lucide 내부 구조에 기대는 것은 맞지만, 새로 생긴 결합은 아닙니다 —
+ * lucide 가 공개 진입점으로 함께 파는 dynamicIconImports 자체가 같은 경로를
+ * 씁니다(`import('./icons/a-arrow-down.mjs')`). 1.21.0 에는 exports 필드가 없어
+ * deep import 가 막히지 않습니다. 나중에 lucide 가 exports 를 넣어 이 경로가
+ * 막히면 test/lucideIconSet.test.tsx 가 잡습니다.
+ */
+import AlertTriangleIcon from 'lucide-react/dist/esm/icons/alert-triangle.mjs';
+import AlignStartVerticalIcon from 'lucide-react/dist/esm/icons/align-start-vertical.mjs';
+import ArrowDownIcon from 'lucide-react/dist/esm/icons/arrow-down.mjs';
+import ArrowLeftIcon from 'lucide-react/dist/esm/icons/arrow-left.mjs';
+import ArrowRightIcon from 'lucide-react/dist/esm/icons/arrow-right.mjs';
+import ArrowRightLeftIcon from 'lucide-react/dist/esm/icons/arrow-right-left.mjs';
+import AudioLinesIcon from 'lucide-react/dist/esm/icons/audio-lines.mjs';
+import BabyIcon from 'lucide-react/dist/esm/icons/baby.mjs';
+import BanIcon from 'lucide-react/dist/esm/icons/ban.mjs';
+import BellIcon from 'lucide-react/dist/esm/icons/bell.mjs';
+import BookMarkedIcon from 'lucide-react/dist/esm/icons/book-marked.mjs';
+import BookOpenIcon from 'lucide-react/dist/esm/icons/book-open.mjs';
+import BowArrowIcon from 'lucide-react/dist/esm/icons/bow-arrow.mjs';
+import BracesIcon from 'lucide-react/dist/esm/icons/braces.mjs';
+import BugIcon from 'lucide-react/dist/esm/icons/bug.mjs';
+import CalendarCheckIcon from 'lucide-react/dist/esm/icons/calendar-check.mjs';
+import CalendarDaysIcon from 'lucide-react/dist/esm/icons/calendar-days.mjs';
+import CameraIcon from 'lucide-react/dist/esm/icons/camera.mjs';
+import ChartColumnIcon from 'lucide-react/dist/esm/icons/chart-column.mjs';
+import ChartLineIcon from 'lucide-react/dist/esm/icons/chart-line.mjs';
+import ChartPieIcon from 'lucide-react/dist/esm/icons/chart-pie.mjs';
+import CheckIcon from 'lucide-react/dist/esm/icons/check.mjs';
+import ChevronLeftIcon from 'lucide-react/dist/esm/icons/chevron-left.mjs';
+import ChevronRightIcon from 'lucide-react/dist/esm/icons/chevron-right.mjs';
+import ClipboardListIcon from 'lucide-react/dist/esm/icons/clipboard-list.mjs';
+import CombineIcon from 'lucide-react/dist/esm/icons/combine.mjs';
+import CopyIcon from 'lucide-react/dist/esm/icons/copy.mjs';
+import CreditCardIcon from 'lucide-react/dist/esm/icons/credit-card.mjs';
+import DatabaseIcon from 'lucide-react/dist/esm/icons/database.mjs';
+import DiffIcon from 'lucide-react/dist/esm/icons/diff.mjs';
+import DownloadIcon from 'lucide-react/dist/esm/icons/download.mjs';
+import EarIcon from 'lucide-react/dist/esm/icons/ear.mjs';
+import EditIcon from 'lucide-react/dist/esm/icons/edit.mjs';
+import Edit2Icon from 'lucide-react/dist/esm/icons/edit-2.mjs';
+import Edit3Icon from 'lucide-react/dist/esm/icons/edit-3.mjs';
+import EllipsisIcon from 'lucide-react/dist/esm/icons/ellipsis.mjs';
+import EraserIcon from 'lucide-react/dist/esm/icons/eraser.mjs';
+import ExternalLinkIcon from 'lucide-react/dist/esm/icons/external-link.mjs';
+import EyeIcon from 'lucide-react/dist/esm/icons/eye.mjs';
+import FileTextIcon from 'lucide-react/dist/esm/icons/file-text.mjs';
+import FlipHorizontalIcon from 'lucide-react/dist/esm/icons/flip-horizontal.mjs';
+import FolderOpenIcon from 'lucide-react/dist/esm/icons/folder-open.mjs';
+import FolderPlusIcon from 'lucide-react/dist/esm/icons/folder-plus.mjs';
+import GamepadIcon from 'lucide-react/dist/esm/icons/gamepad.mjs';
+import GavelIcon from 'lucide-react/dist/esm/icons/gavel.mjs';
+import GitMergeIcon from 'lucide-react/dist/esm/icons/git-merge.mjs';
+import GlobeIcon from 'lucide-react/dist/esm/icons/globe.mjs';
+import HeadphonesIcon from 'lucide-react/dist/esm/icons/headphones.mjs';
+import HeartIcon from 'lucide-react/dist/esm/icons/heart.mjs';
+import HomeIcon from 'lucide-react/dist/esm/icons/home.mjs';
+import InfoIcon from 'lucide-react/dist/esm/icons/info.mjs';
+import KeyRoundIcon from 'lucide-react/dist/esm/icons/key-round.mjs';
+import LandmarkIcon from 'lucide-react/dist/esm/icons/landmark.mjs';
+import LayersIcon from 'lucide-react/dist/esm/icons/layers.mjs';
+import LayoutDashboardIcon from 'lucide-react/dist/esm/icons/layout-dashboard.mjs';
+import LeafIcon from 'lucide-react/dist/esm/icons/leaf.mjs';
+import LightbulbIcon from 'lucide-react/dist/esm/icons/lightbulb.mjs';
+import LinkIcon from 'lucide-react/dist/esm/icons/link.mjs';
+import Link2Icon from 'lucide-react/dist/esm/icons/link-2.mjs';
+import Link2OffIcon from 'lucide-react/dist/esm/icons/link-2-off.mjs';
+import ListIcon from 'lucide-react/dist/esm/icons/list.mjs';
+import ListChecksIcon from 'lucide-react/dist/esm/icons/list-checks.mjs';
+import ListOrderedIcon from 'lucide-react/dist/esm/icons/list-ordered.mjs';
+import LoaderIcon from 'lucide-react/dist/esm/icons/loader.mjs';
+import LogOutIcon from 'lucide-react/dist/esm/icons/log-out.mjs';
+import MailIcon from 'lucide-react/dist/esm/icons/mail.mjs';
+import MapPinIcon from 'lucide-react/dist/esm/icons/map-pin.mjs';
+import MessageCircleIcon from 'lucide-react/dist/esm/icons/message-circle.mjs';
+import MessageCircleQuestionMarkIcon from 'lucide-react/dist/esm/icons/message-circle-question-mark.mjs';
+import MessageSquareIcon from 'lucide-react/dist/esm/icons/message-square.mjs';
+import MessageSquareTextIcon from 'lucide-react/dist/esm/icons/message-square-text.mjs';
+import MinusCircleIcon from 'lucide-react/dist/esm/icons/minus-circle.mjs';
+import MoreHorizontalIcon from 'lucide-react/dist/esm/icons/more-horizontal.mjs';
+import PackageIcon from 'lucide-react/dist/esm/icons/package.mjs';
+import PaletteIcon from 'lucide-react/dist/esm/icons/palette.mjs';
+import PartyPopperIcon from 'lucide-react/dist/esm/icons/party-popper.mjs';
+import PauseIcon from 'lucide-react/dist/esm/icons/pause.mjs';
+import PencilIcon from 'lucide-react/dist/esm/icons/pencil.mjs';
+import PhoneIcon from 'lucide-react/dist/esm/icons/phone.mjs';
+import PlayIcon from 'lucide-react/dist/esm/icons/play.mjs';
+import PlayCircleIcon from 'lucide-react/dist/esm/icons/play-circle.mjs';
+import PlusIcon from 'lucide-react/dist/esm/icons/plus.mjs';
+import PrinterIcon from 'lucide-react/dist/esm/icons/printer.mjs';
+import RefreshCwIcon from 'lucide-react/dist/esm/icons/refresh-cw.mjs';
+import RepeatIcon from 'lucide-react/dist/esm/icons/repeat.mjs';
+import ReplaceIcon from 'lucide-react/dist/esm/icons/replace.mjs';
+import RocketIcon from 'lucide-react/dist/esm/icons/rocket.mjs';
+import RotateCcwIcon from 'lucide-react/dist/esm/icons/rotate-ccw.mjs';
+import RotateCwIcon from 'lucide-react/dist/esm/icons/rotate-cw.mjs';
+import SaladIcon from 'lucide-react/dist/esm/icons/salad.mjs';
+import ScanSearchIcon from 'lucide-react/dist/esm/icons/scan-search.mjs';
+import CircleAlertIcon from 'lucide-react/dist/esm/icons/circle-alert.mjs';
+import AlertCircleIcon from 'lucide-react/dist/esm/icons/alert-circle.mjs';
+import CheckCircleIcon from 'lucide-react/dist/esm/icons/check-circle.mjs';
+import SearchIcon from 'lucide-react/dist/esm/icons/search.mjs';
+import ScissorsIcon from 'lucide-react/dist/esm/icons/scissors.mjs';
+import SearchXIcon from 'lucide-react/dist/esm/icons/search-x.mjs';
+import SendIcon from 'lucide-react/dist/esm/icons/send.mjs';
+import SettingsIcon from 'lucide-react/dist/esm/icons/settings.mjs';
+import ShieldCheckIcon from 'lucide-react/dist/esm/icons/shield-check.mjs';
+import ShoppingCartIcon from 'lucide-react/dist/esm/icons/shopping-cart.mjs';
+import ShuffleIcon from 'lucide-react/dist/esm/icons/shuffle.mjs';
+import SkipBackIcon from 'lucide-react/dist/esm/icons/skip-back.mjs';
+import SkipForwardIcon from 'lucide-react/dist/esm/icons/skip-forward.mjs';
+import SquareIcon from 'lucide-react/dist/esm/icons/square.mjs';
+import StarIcon from 'lucide-react/dist/esm/icons/star.mjs';
+import StoreIcon from 'lucide-react/dist/esm/icons/store.mjs';
+import SunMediumIcon from 'lucide-react/dist/esm/icons/sun-medium.mjs';
+import TableIcon from 'lucide-react/dist/esm/icons/table.mjs';
+import Table2Icon from 'lucide-react/dist/esm/icons/table-2.mjs';
+import TerminalIcon from 'lucide-react/dist/esm/icons/terminal.mjs';
+import TextCursorInputIcon from 'lucide-react/dist/esm/icons/text-cursor-input.mjs';
+import TextInitialIcon from 'lucide-react/dist/esm/icons/text-initial.mjs';
+import TicketIcon from 'lucide-react/dist/esm/icons/ticket.mjs';
+import Trash2Icon from 'lucide-react/dist/esm/icons/trash-2.mjs';
+import TrendingUpIcon from 'lucide-react/dist/esm/icons/trending-up.mjs';
+import TriangleAlertIcon from 'lucide-react/dist/esm/icons/triangle-alert.mjs';
+import TrophyIcon from 'lucide-react/dist/esm/icons/trophy.mjs';
+import UnlinkIcon from 'lucide-react/dist/esm/icons/unlink.mjs';
+import UploadIcon from 'lucide-react/dist/esm/icons/upload.mjs';
+import UserIcon from 'lucide-react/dist/esm/icons/user.mjs';
+import UserPlusIcon from 'lucide-react/dist/esm/icons/user-plus.mjs';
+import UserRoundIcon from 'lucide-react/dist/esm/icons/user-round.mjs';
+import UserRoundCheckIcon from 'lucide-react/dist/esm/icons/user-round-check.mjs';
+import UsersIcon from 'lucide-react/dist/esm/icons/users.mjs';
+import UsersRoundIcon from 'lucide-react/dist/esm/icons/users-round.mjs';
+import Volume2Icon from 'lucide-react/dist/esm/icons/volume-2.mjs';
+import WrenchIcon from 'lucide-react/dist/esm/icons/wrench.mjs';
+import XIcon from 'lucide-react/dist/esm/icons/x.mjs';
+import ZapIcon from 'lucide-react/dist/esm/icons/zap.mjs';
+import AnchorIcon from 'lucide-react/dist/esm/icons/anchor.mjs';
+import ArrowUpAZIcon from 'lucide-react/dist/esm/icons/arrow-up-a-z.mjs';
+import BarChart2Icon from 'lucide-react/dist/esm/icons/bar-chart-2.mjs';
+import CalendarIcon from 'lucide-react/dist/esm/icons/calendar.mjs';
+import CarIcon from 'lucide-react/dist/esm/icons/car.mjs';
+import CoffeeIcon from 'lucide-react/dist/esm/icons/coffee.mjs';
+import Gamepad2Icon from 'lucide-react/dist/esm/icons/gamepad-2.mjs';
+import InboxIcon from 'lucide-react/dist/esm/icons/inbox.mjs';
+import ListTreeIcon from 'lucide-react/dist/esm/icons/list-tree.mjs';
+import MessageSquareMoreIcon from 'lucide-react/dist/esm/icons/message-square-more.mjs';
+import MinusIcon from 'lucide-react/dist/esm/icons/minus.mjs';
+import Share2Icon from 'lucide-react/dist/esm/icons/share-2.mjs';
+import SparklesIcon from 'lucide-react/dist/esm/icons/sparkles.mjs';
+import TypeIcon from 'lucide-react/dist/esm/icons/type.mjs';
+import VolumeIcon from 'lucide-react/dist/esm/icons/volume.mjs';
+import ChevronDownIcon from 'lucide-react/dist/esm/icons/chevron-down.mjs';
+import ChevronUpIcon from 'lucide-react/dist/esm/icons/chevron-up.mjs';
+import CircleIcon from 'lucide-react/dist/esm/icons/circle.mjs';
+import TriangleIcon from 'lucide-react/dist/esm/icons/triangle.mjs';
+import MenuIcon from 'lucide-react/dist/esm/icons/menu.mjs';
+import MoonIcon from 'lucide-react/dist/esm/icons/moon.mjs';
+import ThumbsUpIcon from 'lucide-react/dist/esm/icons/thumbs-up.mjs';
+/**
+ * 정적으로 번들되는 아이콘 목록.
+ *
+ * 이 목록은 speechear·kscan 소스의 icon 리터럴(`icon="..."`, `icon: '...'`)을
+ * 훑어 만들었습니다. **여기 없는 이름은 지연 로드됩니다** — 화면에는 결국
+ * 나오지만 첫 렌더에는 잠깐 비어 보입니다. 새 아이콘을 쓰기 시작했는데
+ * 유독 그것만 늦게 뜬다면 이 목록에 추가하세요.
+ *
+ * 왜 이렇게 하는가: 예전에는 `import * as lucide from 'lucide-react'` 로
+ * 통째로 가져와 이름으로 조회했습니다. 그러면 어떤 이름이든 들어올 수 있으니
+ * 번들러가 아이콘을 하나도 떨궈내지 못합니다 — 소비 앱 청크 하나에 아이콘
+ * 모듈 1767개, JS 전송량 6.8MB 가 실렸습니다. 이름을 하나씩 적어 두면
+ * tree-shaking 이 동작합니다.
+ */
+export const STATIC_LUCIDE_ICONS = {
+    'alert-triangle': AlertTriangleIcon,
+    'align-start-vertical': AlignStartVerticalIcon,
+    'anchor': AnchorIcon,
+    'arrow-down': ArrowDownIcon,
+    'arrow-left': ArrowLeftIcon,
+    'arrow-right': ArrowRightIcon,
+    'arrow-right-left': ArrowRightLeftIcon,
+    'arrow-up-a-z': ArrowUpAZIcon,
+    'audio-lines': AudioLinesIcon,
+    'baby': BabyIcon,
+    'ban': BanIcon,
+    'bar-chart-2': BarChart2Icon,
+    'bell': BellIcon,
+    'book-marked': BookMarkedIcon,
+    'book-open': BookOpenIcon,
+    'bow-arrow': BowArrowIcon,
+    'braces': BracesIcon,
+    'bug': BugIcon,
+    'calendar': CalendarIcon,
+    'calendar-check': CalendarCheckIcon,
+    'calendar-days': CalendarDaysIcon,
+    'camera': CameraIcon,
+    'car': CarIcon,
+    'chart-column': ChartColumnIcon,
+    'chart-line': ChartLineIcon,
+    'chart-pie': ChartPieIcon,
+    'check': CheckIcon,
+    'chevron-down': ChevronDownIcon,
+    'chevron-left': ChevronLeftIcon,
+    'chevron-right': ChevronRightIcon,
+    'chevron-up': ChevronUpIcon,
+    'circle': CircleIcon,
+    'clipboard-list': ClipboardListIcon,
+    'coffee': CoffeeIcon,
+    'combine': CombineIcon,
+    'copy': CopyIcon,
+    'credit-card': CreditCardIcon,
+    'database': DatabaseIcon,
+    'diff': DiffIcon,
+    'download': DownloadIcon,
+    'ear': EarIcon,
+    'edit': EditIcon,
+    'edit-2': Edit2Icon,
+    'edit-3': Edit3Icon,
+    'ellipsis': EllipsisIcon,
+    'eraser': EraserIcon,
+    'external-link': ExternalLinkIcon,
+    'eye': EyeIcon,
+    'file-text': FileTextIcon,
+    'flip-horizontal': FlipHorizontalIcon,
+    'folder-open': FolderOpenIcon,
+    'folder-plus': FolderPlusIcon,
+    'gamepad': GamepadIcon,
+    'gamepad-2': Gamepad2Icon,
+    'gavel': GavelIcon,
+    'git-merge': GitMergeIcon,
+    'globe': GlobeIcon,
+    'headphones': HeadphonesIcon,
+    'heart': HeartIcon,
+    'home': HomeIcon,
+    'inbox': InboxIcon,
+    'info': InfoIcon,
+    'key-round': KeyRoundIcon,
+    'landmark': LandmarkIcon,
+    'layers': LayersIcon,
+    'layout-dashboard': LayoutDashboardIcon,
+    'leaf': LeafIcon,
+    'lightbulb': LightbulbIcon,
+    'link': LinkIcon,
+    'link-2': Link2Icon,
+    'link-2-off': Link2OffIcon,
+    'list': ListIcon,
+    'list-checks': ListChecksIcon,
+    'list-ordered': ListOrderedIcon,
+    'list-tree': ListTreeIcon,
+    'loader': LoaderIcon,
+    'log-out': LogOutIcon,
+    'mail': MailIcon,
+    'map-pin': MapPinIcon,
+    'menu': MenuIcon,
+    'message-circle': MessageCircleIcon,
+    'message-circle-question-mark': MessageCircleQuestionMarkIcon,
+    'message-square': MessageSquareIcon,
+    'message-square-more': MessageSquareMoreIcon,
+    'message-square-text': MessageSquareTextIcon,
+    'minus': MinusIcon,
+    'minus-circle': MinusCircleIcon,
+    'moon': MoonIcon,
+    'more-horizontal': MoreHorizontalIcon,
+    'package': PackageIcon,
+    'palette': PaletteIcon,
+    'party-popper': PartyPopperIcon,
+    'pause': PauseIcon,
+    'pencil': PencilIcon,
+    'phone': PhoneIcon,
+    'play': PlayIcon,
+    'play-circle': PlayCircleIcon,
+    'plus': PlusIcon,
+    'printer': PrinterIcon,
+    'refresh-cw': RefreshCwIcon,
+    'repeat': RepeatIcon,
+    'replace': ReplaceIcon,
+    'rocket': RocketIcon,
+    'rotate-ccw': RotateCcwIcon,
+    'rotate-cw': RotateCwIcon,
+    'salad': SaladIcon,
+    'scan-search': ScanSearchIcon,
+    /* SearchSummary 의 기본 상태 아이콘 — 없어서 안 그려지고 있었다(2026-08-28). */
+    search: SearchIcon,
+    /* SearchSummary 의 오류 상태 아이콘 — 같은 이유로 안 그려졌다. */
+    'circle-alert': CircleAlertIcon,
+    /* Alert 의 위험·성공 아이콘. lucide 가 circle-alert / circle-check 로 이름을 바꿨지만
+       이 저장소는 옛 이름을 쓰고 lucide 도 그 파일을 계속 판다 — 쓰는 이름 그대로 등록한다. */
+    'alert-circle': AlertCircleIcon,
+    'check-circle': CheckCircleIcon,
+    'scissors': ScissorsIcon,
+    'search-x': SearchXIcon,
+    'send': SendIcon,
+    'settings': SettingsIcon,
+    'share-2': Share2Icon,
+    'shield-check': ShieldCheckIcon,
+    'shopping-cart': ShoppingCartIcon,
+    'shuffle': ShuffleIcon,
+    'skip-back': SkipBackIcon,
+    'skip-forward': SkipForwardIcon,
+    'sparkles': SparklesIcon,
+    'square': SquareIcon,
+    'star': StarIcon,
+    'store': StoreIcon,
+    'sun-medium': SunMediumIcon,
+    'table': TableIcon,
+    'table-2': Table2Icon,
+    'terminal': TerminalIcon,
+    'text-cursor-input': TextCursorInputIcon,
+    'text-initial': TextInitialIcon,
+    'thumbs-up': ThumbsUpIcon,
+    'ticket': TicketIcon,
+    'triangle': TriangleIcon,
+    'trash-2': Trash2Icon,
+    'trending-up': TrendingUpIcon,
+    'triangle-alert': TriangleAlertIcon,
+    'trophy': TrophyIcon,
+    'type': TypeIcon,
+    'unlink': UnlinkIcon,
+    'upload': UploadIcon,
+    'user': UserIcon,
+    'user-plus': UserPlusIcon,
+    'user-round': UserRoundIcon,
+    'user-round-check': UserRoundCheckIcon,
+    'users': UsersIcon,
+    'users-round': UsersRoundIcon,
+    'volume': VolumeIcon,
+    'volume-2': Volume2Icon,
+    'wrench': WrenchIcon,
+    'x': XIcon,
+    'zap': ZapIcon
+};

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

@@ -0,0 +1,44 @@
+/**
+ * lucide 아이콘 로더
+ *
+ * 아이콘은 전부 정적 목록(`lucideIconSet.ts`)에서 나온다. 목록에 없는 이름은
+ * **렌더되지 않는다** — 개발 모드에서 이름당 한 번 경고를 남긴다.
+ *
+ * 예전에는 목록에 없는 이름을 `import('lucide-react/dynamicIconImports.mjs')`
+ * 로 지연 로드했다. 화면에는 결국 나왔지만 값이 컸다:
+ *
+ * - 그 import 하나가 아이콘 모듈 2,025개를 번들러의 모듈 그래프에 끌어들여,
+ *   Next dev 서버의 라우트 첫 컴파일이 5.6초 → 20~35초로 늘었다(모듈
+ *   3,911 → 7,189개). 화면을 옮길 때마다 한참 걸리던 원인이다.
+ * - 프로덕션 산출물에 2KB 미만 아이콘 청크가 1,600여 개 생겼다.
+ *
+ * 그 대가로 얻던 것은 "목록을 안 갱신해도 아이콘이 늦게나마 뜬다" 하나였다.
+ * 그 안전망은 이제 시험이 맡는다 — 소스의 icon 리터럴을 훑어 목록에 없으면
+ * 시험이 실패한다(`test/lucideIconSet.test.tsx`). 조용한 지연 대신 빨간 줄이
+ * 뜬다.
+ *
+ * @public
+ */
+import type { ComponentType } from 'react';
+type IconComponent = ComponentType<Record<string, unknown>>;
+/**
+ * 정적으로 번들된 아이콘을 이름으로 찾습니다. 없으면 null.
+ *
+ * 동기입니다 — 서버 렌더에서도 쓸 수 있어야 하고(useEffect 가 돌지 않는다),
+ * 클라이언트 첫 렌더에서도 아이콘 자리가 비지 않아야 합니다.
+ *
+ * @public
+ */
+export declare function getStaticLucideIcon(name: string): IconComponent | null;
+/**
+ * (호환용) 예전 지연 로드 API. 이제 아무것도 받아오지 않습니다.
+ *
+ * 시그니처를 남겨 두는 이유: useLucideIcon 등 호출부가 기대는 공개 API 라
+ * 지우면 소비 앱이 깨진다. 정적 목록에 없는 이름은 null 로 끝나고, 개발
+ * 모드에서 어느 이름이 빠졌는지 알려 준다. 목록에 있는 이름이 들어오면
+ * 이미 동기 경로가 처리했을 것이므로 조용히 null 만 돌려준다.
+ *
+ * @public
+ */
+export declare function loadLucideIcon(name: string): Promise<IconComponent | null>;
+export {};

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

@@ -0,0 +1,76 @@
+/**
+ * lucide 아이콘 로더
+ *
+ * 아이콘은 전부 정적 목록(`lucideIconSet.ts`)에서 나온다. 목록에 없는 이름은
+ * **렌더되지 않는다** — 개발 모드에서 이름당 한 번 경고를 남긴다.
+ *
+ * 예전에는 목록에 없는 이름을 `import('lucide-react/dynamicIconImports.mjs')`
+ * 로 지연 로드했다. 화면에는 결국 나왔지만 값이 컸다:
+ *
+ * - 그 import 하나가 아이콘 모듈 2,025개를 번들러의 모듈 그래프에 끌어들여,
+ *   Next dev 서버의 라우트 첫 컴파일이 5.6초 → 20~35초로 늘었다(모듈
+ *   3,911 → 7,189개). 화면을 옮길 때마다 한참 걸리던 원인이다.
+ * - 프로덕션 산출물에 2KB 미만 아이콘 청크가 1,600여 개 생겼다.
+ *
+ * 그 대가로 얻던 것은 "목록을 안 갱신해도 아이콘이 늦게나마 뜬다" 하나였다.
+ * 그 안전망은 이제 시험이 맡는다 — 소스의 icon 리터럴을 훑어 목록에 없으면
+ * 시험이 실패한다(`test/lucideIconSet.test.tsx`). 조용한 지연 대신 빨간 줄이
+ * 뜬다.
+ *
+ * @public
+ */
+import { STATIC_LUCIDE_ICONS } from './lucideIconSet';
+/**
+ * 정적으로 번들된 아이콘을 이름으로 찾습니다. 없으면 null.
+ *
+ * 동기입니다 — 서버 렌더에서도 쓸 수 있어야 하고(useEffect 가 돌지 않는다),
+ * 클라이언트 첫 렌더에서도 아이콘 자리가 비지 않아야 합니다.
+ *
+ * @public
+ */
+export function getStaticLucideIcon(name) {
+    return STATIC_LUCIDE_ICONS[name] ?? null;
+}
+/** 개발 모드에서 이름당 한 번만 경고하기 위한 기록 */
+const warned = new Set();
+/**
+ * 개발 모드인가. vite 는 `import.meta.env.DEV`, webpack/Next 는
+ * `process.env.NODE_ENV` 를 정적으로 치환한다 — 소비 앱이 어느 쪽이든
+ * 동작하도록 둘 다 본다. 어느 것도 없으면 조용히 있는 쪽(false)을 고른다.
+ */
+const isDev = (() => {
+    try {
+        if (import.meta.env?.DEV)
+            return true;
+    }
+    catch {
+        /* import.meta 가 없는 번들러 */
+    }
+    try {
+        /* `process` 를 그냥 쓰면 브라우저용 tsconfig(노드 타입 없음)에서 TS2591 이 난다 —
+           소비 앱의 타입검사가 통째로 막힌다. globalThis 를 거치면 선언 없이도 읽힌다. */
+        const g = globalThis;
+        return g.process != null && g.process.env?.NODE_ENV !== 'production';
+    }
+    catch {
+        return false;
+    }
+})();
+/**
+ * (호환용) 예전 지연 로드 API. 이제 아무것도 받아오지 않습니다.
+ *
+ * 시그니처를 남겨 두는 이유: useLucideIcon 등 호출부가 기대는 공개 API 라
+ * 지우면 소비 앱이 깨진다. 정적 목록에 없는 이름은 null 로 끝나고, 개발
+ * 모드에서 어느 이름이 빠졌는지 알려 준다. 목록에 있는 이름이 들어오면
+ * 이미 동기 경로가 처리했을 것이므로 조용히 null 만 돌려준다.
+ *
+ * @public
+ */
+export function loadLucideIcon(name) {
+    if (isDev && !(name in STATIC_LUCIDE_ICONS) && !warned.has(name)) {
+        warned.add(name);
+        console.warn(`[ihabdevteam-core] lucide 아이콘 '${name}' 이 정적 목록에 없어 렌더되지 않습니다. ` +
+            `utils/lucideIconSet.ts 의 STATIC_LUCIDE_ICONS 에 추가하세요.`);
+    }
+    return Promise.resolve(null);
+}

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

@@ -0,0 +1,22 @@
+/**
+ * 소음설정 영속 저장소 — TTS/Storage 리졸버, 훈련 로거와 동일한 전역 주입 패턴.
+ *
+ * 앱(src)에서 configureNoiseSettingsStore()로 Supabase load/save 콜백을 등록하면,
+ * TrainingPagePopup이 마운트 시 load()로 초기화하고 변경 시 save()로 기록한다.
+ * core는 사용자/고객 식별자를 모른다 — 본인(profiles) vs 고객(managed_user) 분기는
+ * 앱이 주입한 콜백 내부에서 현재 훈련 대상에 따라 결정한다.
+ */
+import type { CoreNoiseSettings } from '../components/Training/NoisePlayerContext';
+/** @public 소음설정 영속 저장소. 앱에서 Supabase 연결을 주입한다. */
+export interface NoiseSettingsStore {
+    /** 현재 훈련 대상(본인 또는 고객)의 저장된 소음설정. 없으면 null. */
+    load: () => Promise<Partial<CoreNoiseSettings> | null>;
+    /** 현재 훈련 대상의 소음설정을 저장(fire-and-forget). */
+    save: (settings: CoreNoiseSettings) => Promise<void> | void;
+}
+/** @public */
+export declare function configureNoiseSettingsStore(store: NoiseSettingsStore | null): void;
+/** @public 저장된 소음설정 로드. 미설정/실패 시 null. */
+export declare function loadNoiseSettings(): Promise<Partial<CoreNoiseSettings> | null>;
+/** @public 소음설정 저장(fire-and-forget). */
+export declare function saveNoiseSettings(settings: CoreNoiseSettings): void;

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

@@ -0,0 +1,36 @@
+const g = globalThis;
+/** @public */
+export function configureNoiseSettingsStore(store) {
+    g.__ihabNoiseSettingsStore = store;
+}
+/** @public 저장된 소음설정 로드. 미설정/실패 시 null. */
+export async function loadNoiseSettings() {
+    try {
+        return (await g.__ihabNoiseSettingsStore?.load()) ?? null;
+    }
+    catch (e) {
+        if (import.meta.env?.DEV)
+            console.warn('[noiseSettingsStore] load', e);
+        return null;
+    }
+}
+/** @public 소음설정 저장(fire-and-forget). */
+export function saveNoiseSettings(settings) {
+    const warn = (e) => {
+        if (import.meta.env?.DEV)
+            console.warn('[noiseSettingsStore] save', e);
+    };
+    try {
+        // save 는 Promise 를 돌려줄 수 있다. void 는 "결과를 안 쓴다"는 표시일 뿐이라
+        // 거절된 promise 를 잡아 주지 않고, 아래 catch 는 동기 throw 만 받는다.
+        // 그대로 두면 저장이 실패할 때(네트워크 등) unhandled rejection 이 남는다 —
+        // 기다리지 않는 것과 실패를 흘리는 것은 다르므로 여기서 받아 삼킨다.
+        const r = g.__ihabNoiseSettingsStore?.save(settings);
+        if (r && typeof r.catch === 'function') {
+            void r.catch(warn);
+        }
+    }
+    catch (e) {
+        warn(e);
+    }
+}

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

@@ -0,0 +1,9 @@
+export declare const VALID_GLIDES: Record<string, string[]>;
+/** 모음 → 대표 핵모음(+활음) 매핑. 단어↔발음 변환과 대립쌍 매칭(VOWEL_NUCLEUS)이 공유하는 단일 출처. */
+export declare const VOWEL_TO_PHONEME: Record<string, {
+    glide?: string;
+    nucleus: string;
+}>;
+/** 종성 글자 → 음소(대표음) 변환. 매핑에 없으면 원본 유지. */
+export declare function finalToPhoneme(jong: string): string;
+export declare function convertToPhoneme(sel: Record<string, string>): Record<string, string>;

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

@@ -0,0 +1,53 @@
+export const VALID_GLIDES = {
+    ㅏ: ['j', 'w'], ㅓ: ['j', 'w'], ㅗ: ['j'], ㅜ: ['j'],
+    'ㅔ/ㅐ': ['j', 'w'], ㅣ: ['w', 'ɰ'], ㅡ: [],
+};
+const JONGSEONG_TO_PHONEME = {
+    ㄱ: 'ㄱ', ㄲ: 'ㄱ', ㅋ: 'ㄱ', ㄳ: 'ㄱ', ㄺ: 'ㄱ',
+    ㄴ: 'ㄴ', ㄵ: 'ㄴ', ㄶ: 'ㄴ',
+    ㄷ: 'ㄷ', ㅅ: 'ㄷ', ㅆ: 'ㄷ', ㅈ: 'ㄷ', ㅊ: 'ㄷ', ㅌ: 'ㄷ', ㅎ: 'ㄷ',
+    ㄹ: 'ㄹ', ㄼ: 'ㄹ', ㄽ: 'ㄹ', ㄾ: 'ㄹ', ㅀ: 'ㄹ',
+    ㅁ: 'ㅁ', ㄻ: 'ㅁ',
+    ㅂ: 'ㅂ', ㅍ: 'ㅂ', ㄿ: 'ㅂ', ㅄ: 'ㅂ',
+    ㅇ: 'ㅇ',
+};
+/** 모음 → 대표 핵모음(+활음) 매핑. 단어↔발음 변환과 대립쌍 매칭(VOWEL_NUCLEUS)이 공유하는 단일 출처. */
+export const VOWEL_TO_PHONEME = {
+    ㅏ: { nucleus: 'ㅏ' }, ㅑ: { glide: 'j', nucleus: 'ㅏ' },
+    ㅓ: { nucleus: 'ㅓ' }, ㅕ: { glide: 'j', nucleus: 'ㅓ' },
+    ㅗ: { nucleus: 'ㅗ' }, ㅛ: { glide: 'j', nucleus: 'ㅗ' },
+    ㅜ: { nucleus: 'ㅜ' }, ㅠ: { glide: 'j', nucleus: 'ㅜ' },
+    ㅡ: { nucleus: 'ㅡ' },
+    ㅣ: { nucleus: 'ㅣ' },
+    ㅐ: { nucleus: 'ㅔ/ㅐ' }, ㅒ: { glide: 'j', nucleus: 'ㅔ/ㅐ' },
+    ㅔ: { nucleus: 'ㅔ/ㅐ' }, ㅖ: { glide: 'j', nucleus: 'ㅔ/ㅐ' },
+    ㅘ: { glide: 'w', nucleus: 'ㅏ' },
+    ㅙ: { glide: 'w', nucleus: 'ㅔ/ㅐ' },
+    ㅚ: { glide: 'w', nucleus: 'ㅔ/ㅐ' },
+    ㅝ: { glide: 'w', nucleus: 'ㅓ' },
+    ㅞ: { glide: 'w', nucleus: 'ㅔ/ㅐ' },
+    ㅟ: { glide: 'w', nucleus: 'ㅣ' },
+    ㅢ: { glide: 'ɰ', nucleus: 'ㅣ' },
+};
+/** 종성 글자 → 음소(대표음) 변환. 매핑에 없으면 원본 유지. */
+export function finalToPhoneme(jong) {
+    return JONGSEONG_TO_PHONEME[jong] ?? jong;
+}
+export function convertToPhoneme(sel) {
+    const result = {};
+    if (sel['초성'])
+        result['초성'] = sel['초성'];
+    if (sel['모음']) {
+        const m = VOWEL_TO_PHONEME[sel['모음']];
+        // 활음을 항상 명시한다('없음' 포함). 단어 분해(decomposePhonemicSyllable)는 활음 없는 모음에도
+        // 활음:'없음'을 넣으므로, 선택 변환도 대칭으로 맞춰야 활음 대비(예: ㅐ↔ㅙ = 없음↔w)가 매칭된다.
+        // (안 넣으면 ㅐ/ㅔ↔ㅚ/ㅙ 대립이 모음(nucleus)만 같고 대비 섹션이 없어 0건이 됨.)
+        if (m) {
+            result['모음'] = m.nucleus;
+            result['활음'] = m.glide ?? '없음';
+        }
+    }
+    if (sel['종성'])
+        result['종성'] = JONGSEONG_TO_PHONEME[sel['종성']] ?? sel['종성'];
+    return result;
+}

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

@@ -0,0 +1,22 @@
+/**
+ * 발음(음소) 선택 UI의 **표준 그룹 데이터 단일 출처**.
+ * 대립쌍표(WordPairsPage)와 단어훈련(useWordTrainingFilter)이 각자 중복 정의하던
+ * PHONEME_SECTIONS / PHONEME_CLUSTERS를 하나로 합친 것.
+ *
+ * 각 파트(cho/jung/jong)는 "시각적 클러스터(행)"의 배열이고, 각 행은 버튼 아이템의 배열이다.
+ * 자음 클러스터는 조음 위치별로 묶고 **평음-경음-격음(-비음/유음)** 순서로 나열한다
+ * (예: ㅂ-ㅃ-ㅍ-ㅁ, ㄷ-ㄸ-ㅌ, ㄱ-ㄲ-ㅋ).
+ *
+ * 소비처는 이 데이터에서 자기 값 인코딩을 파생한다 — 매칭 로직은 각 소비처가 그대로 소유한다:
+ *  - 대립쌍표: 아이템 value = jamos[0](대표 자모), 병합 버튼은 labels = jamos 전체로 표시.
+ *  - 단어훈련: 아이템 v = jamos.join('')(병합 문자열), 렌더 시 valueToJamos로 labels 복원.
+ * 동음 병합 버튼(예: ㅔ/ㅐ)의 jamos 순서는 두 소비처가 공유하므로 여기서 한 번만 정의한다.
+ */
+export interface PhonemeGroupItem {
+    /** 이 버튼이 대표/매칭하는 자모들. 단일 버튼이면 1개, 동음 병합 버튼이면 여러 개(예: ['ㅔ','ㅐ']). */
+    jamos: string[];
+    /** 조음 정보 등 hover 시 노출할 tooltip 텍스트. */
+    tooltip: string;
+}
+/** @internal 발음 선택 표준 그룹. cho/jung/jong 각각 클러스터(행)들의 배열. */
+export declare const PHONEME_GROUPS: Record<'cho' | 'jung' | 'jong', PhonemeGroupItem[][]>;

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

@@ -0,0 +1,29 @@
+/** 자음 행: 같은 tooltip(조음 위치)을 공유하는 단일 자모 버튼들. */
+const consonantRow = (tooltip, jamos) => jamos.map(j => ({ jamos: [j], tooltip }));
+/** 모음/병합 아이템: `chars`가 여러 글자면 동음 병합 버튼(예: 'ㅔㅐ' → ['ㅔ','ㅐ']). */
+const vowel = (chars, tooltip) => ({ jamos: [...chars], tooltip });
+/** @internal 발음 선택 표준 그룹. cho/jung/jong 각각 클러스터(행)들의 배열. */
+export const PHONEME_GROUPS = {
+    cho: [
+        consonantRow('양순음', ['ㅂ', 'ㅃ', 'ㅍ', 'ㅁ']),
+        consonantRow('치조음', ['ㄷ', 'ㄸ', 'ㅌ', 'ㄴ', 'ㄹ']),
+        consonantRow('치조음', ['ㅅ', 'ㅆ']),
+        consonantRow('경구개음', ['ㅈ', 'ㅉ', 'ㅊ']),
+        consonantRow('연구개음', ['ㄱ', 'ㄲ', 'ㅋ']),
+        consonantRow('성문음', ['ㅎ']),
+    ],
+    jung: [
+        [vowel('ㅣ', '전설 고모음'), vowel('ㅟ', '전설 고모음 · w활음'), vowel('ㅢ', '전설 고모음 · ɰ활음')],
+        [vowel('ㅡ', '후설 고모음 평순')],
+        [vowel('ㅜ', '후설 고모음 원순'), vowel('ㅠ', '후설 고모음 원순 · j활음')],
+        [vowel('ㅔㅐ', '전설 중모음'), vowel('ㅖㅒ', '전설 중모음 · j활음'), vowel('ㅙㅚㅞ', '전설 중모음 · w활음')],
+        [vowel('ㅓ', '후설 중모음 평순'), vowel('ㅕ', '후설 중모음 평순 · j활음'), vowel('ㅝ', '후설 중모음 평순 · w활음')],
+        [vowel('ㅗ', '후설 중모음 원순'), vowel('ㅛ', '후설 중모음 원순 · j활음')],
+        [vowel('ㅏ', '저모음'), vowel('ㅑ', '저모음 · j활음'), vowel('ㅘ', '저모음 · w활음')],
+    ],
+    jong: [
+        consonantRow('양순음', ['ㅂ', 'ㅁ']),
+        consonantRow('치조음', ['ㄷ', 'ㄴ', 'ㄹ']),
+        consonantRow('연구개음', ['ㄱ', 'ㅇ']),
+    ],
+};