@ihabdevteam/core 0.350.0 → 0.352.0

package/dist/ihabdevteam-core.d.ts

@@ -1754,7 +1754,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.350.0";
+export declare const CORE_VERSION = "0.352.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -2430,6 +2430,13 @@ export declare interface ErrorStateProps {
  */
 export declare function escapeCsvField(v: unknown): string;
 
+/**
+ * EUC-KR 바이트 — 한글 2 · ASCII 1 · 줄바꿈 2.
+ *
+ * @public
+ */
+export declare function eucKrBytes(text: string): number;
+
 /**
  * 슬래시로 묶인 복합 약호(예: '명/관', '동/보동')를 라벨맵으로 각각 펼쳐 다시 '/'로 잇는다.
  * 라벨맵에 없는 조각은 원문 그대로 둔다. 빈 문자열은 빈 문자열 그대로 반환.
@@ -3736,6 +3743,9 @@ export declare function ListPopup<T extends {
 /** 첫 쪽으로 돌아갈 까닭을 잇는 값 — **글로 적을 수 있는 것**만 받는다(아래 `resetOn` 참고) @public */
 export declare type ListResetValue = string | number | boolean | null | undefined;
 
+/** 장문(LMS) 본문 한계 */
+export declare const LMS_BYTE_LIMIT = 2000;
+
 /** @public */
 export declare function Loader(props: LoaderProps): JSX.Element;
 
@@ -3877,6 +3887,21 @@ export declare function matchSyllables(word: string, pronMap: Map<string, string
 /** 단어+동음이의어 번호 → 뜻 조회 키 */
 export declare const meaningKey: (word: string, homonum?: number) => string;
 
+/**
+ * 글 하나를 재서 **쓰는 쪽이 그릴 만큼** 돌려준다.
+ *
+ * `over` 는 *"한계를 넘었나"* 다 — 단문이면 90, 장문이면 2000 을 기준으로 본다.
+ * 장문까지 넘으면 보내는 쪽에서 **잘린다.**
+ *
+ * @public
+ */
+export declare function measureSmsText(text: string): {
+    bytes: number;
+    type: SmsType;
+    limit: number;
+    over: boolean;
+};
+
 /**
  * 미디어쿼리 결과를 강제로 덮어쓰기 위한 컨텍스트.
  * 랜딩페이지 폰 목업처럼 데스크탑 뷰포트에서 모바일 화면을 재현해야 할 때,
@@ -4206,6 +4231,73 @@ export declare interface NoticeBoxProps {
     className?: string;
 }
 
+/**
+ * **보내는 알림 글을 한자리에서 본다** — 말귀 청 (314), 2026-10-21.
+ *
+ * 말귀가 보내는 문자 글이 **여섯 파일에 흩어져** 있었다. 그래서 방문 알림만 머리말이
+ * `[기관명]` 으로 다른 것을(나머지 일곱은 `[말귀]`) **다음 날에야** 알았다. 한눈에 보이면
+ * 그 자리에서 보였을 흠이다.
+ *
+ * ## 글은 **쓰는 쪽이 넘긴다**
+ *
+ * 문안은 서비스마다 다르고 그쪽 저장소에 산다. **코어가 글을 들고 있으면 반드시 낡는다** —
+ * 그래서 이 블록은 받아서 그리기만 한다. 코어가 쥐는 것은 **재는 자**(`measureSmsText`)와
+ * **그리는 꼴**뿐이다.
+ *
+ * ## 바이트가 요점이다
+ *
+ * **90바이트**가 단문(18원)과 장문(45원)을 가르는데 한글이 2바이트라 **글자 수로는 가늠이
+ * 안 된다**(45자가 90바이트고, 영문이 섞이면 또 달라진다). 그래서 글마다 바이트와 갈래를
+ * 적고, 한계를 넘은 줄은 눈에 띄게 둔다.
+ *
+ * @example
+ * ```tsx
+ * <NotifyTextPreview items={[{
+ *   name: '인증번호',
+ *   meta: { '받는 이': '가입하는 사람', '언제': '인증 단추를 누를 때' },
+ *   sms: '[말귀] 인증번호 123456 를 입력해 주세요. 5분 안에 유효합니다.',
+ *   ata: '[말귀] 인증번호 안내\n인증번호: 123456',
+ * }]} />
+ * ```
+ *
+ * @public
+ */
+export declare interface NotifyTextItem {
+    /** 갈래 이름 — 목록에서 이것으로 찾는다 */
+    name: string;
+    /**
+     * 곁말 — **이름과 값의 짝**을 적은 차례대로 그린다(`받는 이` · `언제` · `고치는 곳` …).
+     *
+     * 칸 이름을 박지 않는 까닭: 서비스마다 적을 것이 다르다. 코어가 `to`·`when` 처럼 박으면
+     * *"보내는 함수"* 나 *"알림톡 환경변수"* 를 적을 자리가 없어 쓰는 쪽이 다시 짜게 된다.
+     */
+    meta?: Record<string, string>;
+    /** 문자 본문 — 바이트와 갈래를 여기서 잰다 */
+    sms: string;
+    /** 알림톡 본문. 없으면 그 칸을 안 그린다 */
+    ata?: string;
+}
+
+/** @public */
+export declare function NotifyTextPreview({ items, className, ariaLabel, titleLevel }: NotifyTextPreviewProps): JSX.Element;
+
+/** @public */
+export declare interface NotifyTextPreviewProps {
+    items: NotifyTextItem[];
+    className?: string;
+    /**
+     * 읽어 줄 이름. 묶음에 이름이 없으면 낭독기가 **묶음을 아예 안 알린다**
+     * (`ColorPicker` 의 주석과 같은 까닭).
+     */
+    ariaLabel?: string;
+    /**
+     * 갈래 이름의 머리글 급. **박지 않고 연다** — 이 블록은 담는 것 안에 서므로 묶음 급이
+     * 바뀌면 따라 내려가야 한다(`ChartSection` 과 같은 규약). `0` 이면 머리글이 아니라
+     * `div` 로 그린다.
+     */
+    titleLevel?: 0 | 2 | 3 | 4 | 5 | 6;
+}
+
 /**
  * @public 정식 음원이 저장소에 놓이는 자리.
  *
@@ -7028,6 +7120,21 @@ export declare interface SliderProps {
     tickShape?: 'dot' | 'dash';
 }
 
+/** 단문(SMS) 한 통에 드는 한계 — 넘으면 장문(LMS)이다 */
+export declare const SMS_BYTE_LIMIT = 90;
+
+/** 보내는 갈래 */
+export declare type SmsType = 'SMS' | 'LMS';
+
+/**
+ * 단문이냐 장문이냐 — **직접 정한다.**
+ *
+ * 보내는 쪽이 알아서 바꿔 주기도 하지만, 우리가 정하면 **어느 값으로 보냈는지 자취에 남는다.**
+ *
+ * @public
+ */
+export declare function smsTypeFor(text: string): SmsType;
+
 /**
  * 정렬 상태를 드롭다운 **한 문자열**로 주고받는 부호 — `"name|asc"` 꼴.
  *

package/dist/packages/core/src/components/Checkbox.css

@@ -1,4 +1,11 @@
 .checkbox {
+  /* **감싸개가 자리를 잡아야 한다.** 숨긴 `.checkbox__input` 이 `position: absolute` 인데
+     여기 `position` 이 없으면 그 1px 칸이 **가장 가까운 자리 잡힌 조상**(창의 스크롤 통)
+     맨 위에 놓인다. 이름표를 누르면 그 숨은 칸이 초점을 받고, 브라우저가 그것을 보이려고
+     **스크롤을 맨 위로 올린다** — 폰에서 가입 창의 동의 칸을 누르면 창이 튀었다
+     (사장님 신고 2026-10-20, 말귀가 실제 폰에서 재현하고 자리를 짚었다).
+     긴 폼 어디서든 같은 일이 난다. `.radio`·`.toggle` 은 진작 이것을 갖고 있었다. */
+  position: relative;
   display: inline-flex;
   align-items: center;
   gap: 8px;

package/dist/packages/core/src/components/NotifyTextPreview.css

@@ -0,0 +1,81 @@
+/* **알림 글 미리보기**(말귀 청 (314)) — 글은 쓰는 쪽이 넘기고 여기서는 그리기만 한다.
+   글자 크기는 `styles.css` 의 공용 클래스(`h5b`·`caption-1`)로 받는다 — 컴포넌트 CSS 에
+   크기를 적으면 저장소의 글자 체계 밖으로 나간다. */
+
+.notify-text-preview {
+    display: flex;
+    flex-direction: column;
+    gap: var(--spacing-l);
+}
+
+.notify-text-preview__item {
+    display: flex;
+    flex-direction: column;
+    gap: 10px;
+    padding: var(--spacing-m);
+    border: 1px solid var(--color-darkWhite);
+    border-radius: 12px;
+}
+
+.notify-text-preview__head {
+    display: flex;
+    flex-direction: column;
+}
+
+.notify-text-preview__name {
+    margin: 0 0 6px;
+}
+
+/* 곁말 — 이름과 값이 짝으로 선다. `<dl>` 안에서 짝을 묶으려면 `<div>` 로 감싼다(HTML 규약) */
+.notify-text-preview__meta {
+    margin: 0;
+    color: var(--color-gray);
+}
+.notify-text-preview__meta-row {
+    display: grid;
+    grid-template-columns: auto 1fr;
+    gap: 10px;
+}
+.notify-text-preview__meta dt { margin: 0; }
+.notify-text-preview__meta dd { margin: 0; min-width: 0; word-break: break-all; }
+
+/* 문자와 알림톡을 **나란히** — 좁은 칸에서는 위아래로 접힌다 */
+.notify-text-preview__body {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
+    gap: 10px;
+}
+
+.notify-text-preview__col {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+    min-width: 0;          /* 긴 글이 칸을 밀어내지 않게 */
+}
+
+.notify-text-preview__col-head {
+    display: flex;
+    justify-content: space-between;
+    align-items: baseline;
+    gap: 8px;
+    color: var(--color-gray);
+}
+
+.notify-text-preview__bytes { white-space: nowrap; }
+
+/* 한계를 넘은 줄 — **색만으로 말하지 않는다.** 글(`한계 넘음`)이 함께 간다. */
+.notify-text-preview__bytes.is-over {
+    color: var(--color-error);
+    font-weight: 600;
+}
+
+.notify-text-preview__text {
+    margin: 0;
+    padding: 10px;
+    background: var(--color-deepWhite);
+    border-radius: 8px;
+    /* 글은 적힌 그대로 — 줄바꿈이 바이트를 바꾸므로 접지 않고 보여 준다 */
+    white-space: pre-wrap;
+    word-break: break-word;
+    font: inherit;
+}

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

@@ -0,0 +1,65 @@
+import './NotifyTextPreview.css';
+/**
+ * **보내는 알림 글을 한자리에서 본다** — 말귀 청 (314), 2026-10-21.
+ *
+ * 말귀가 보내는 문자 글이 **여섯 파일에 흩어져** 있었다. 그래서 방문 알림만 머리말이
+ * `[기관명]` 으로 다른 것을(나머지 일곱은 `[말귀]`) **다음 날에야** 알았다. 한눈에 보이면
+ * 그 자리에서 보였을 흠이다.
+ *
+ * ## 글은 **쓰는 쪽이 넘긴다**
+ *
+ * 문안은 서비스마다 다르고 그쪽 저장소에 산다. **코어가 글을 들고 있으면 반드시 낡는다** —
+ * 그래서 이 블록은 받아서 그리기만 한다. 코어가 쥐는 것은 **재는 자**(`measureSmsText`)와
+ * **그리는 꼴**뿐이다.
+ *
+ * ## 바이트가 요점이다
+ *
+ * **90바이트**가 단문(18원)과 장문(45원)을 가르는데 한글이 2바이트라 **글자 수로는 가늠이
+ * 안 된다**(45자가 90바이트고, 영문이 섞이면 또 달라진다). 그래서 글마다 바이트와 갈래를
+ * 적고, 한계를 넘은 줄은 눈에 띄게 둔다.
+ *
+ * @example
+ * ```tsx
+ * <NotifyTextPreview items={[{
+ *   name: '인증번호',
+ *   meta: { '받는 이': '가입하는 사람', '언제': '인증 단추를 누를 때' },
+ *   sms: '[말귀] 인증번호 123456 를 입력해 주세요. 5분 안에 유효합니다.',
+ *   ata: '[말귀] 인증번호 안내\n인증번호: 123456',
+ * }]} />
+ * ```
+ *
+ * @public
+ */
+export interface NotifyTextItem {
+    /** 갈래 이름 — 목록에서 이것으로 찾는다 */
+    name: string;
+    /**
+     * 곁말 — **이름과 값의 짝**을 적은 차례대로 그린다(`받는 이` · `언제` · `고치는 곳` …).
+     *
+     * 칸 이름을 박지 않는 까닭: 서비스마다 적을 것이 다르다. 코어가 `to`·`when` 처럼 박으면
+     * *"보내는 함수"* 나 *"알림톡 환경변수"* 를 적을 자리가 없어 쓰는 쪽이 다시 짜게 된다.
+     */
+    meta?: Record<string, string>;
+    /** 문자 본문 — 바이트와 갈래를 여기서 잰다 */
+    sms: string;
+    /** 알림톡 본문. 없으면 그 칸을 안 그린다 */
+    ata?: string;
+}
+/** @public */
+export interface NotifyTextPreviewProps {
+    items: NotifyTextItem[];
+    className?: string;
+    /**
+     * 읽어 줄 이름. 묶음에 이름이 없으면 낭독기가 **묶음을 아예 안 알린다**
+     * (`ColorPicker` 의 주석과 같은 까닭).
+     */
+    ariaLabel?: string;
+    /**
+     * 갈래 이름의 머리글 급. **박지 않고 연다** — 이 블록은 담는 것 안에 서므로 묶음 급이
+     * 바뀌면 따라 내려가야 한다(`ChartSection` 과 같은 규약). `0` 이면 머리글이 아니라
+     * `div` 로 그린다.
+     */
+    titleLevel?: 0 | 2 | 3 | 4 | 5 | 6;
+}
+/** @public */
+export default function NotifyTextPreview({ items, className, ariaLabel, titleLevel }: NotifyTextPreviewProps): import("react").JSX.Element;

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

@@ -0,0 +1,15 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { measureSmsText } from '../utils/smsBytes';
+import './NotifyTextPreview.css';
+/** @public */
+export default function NotifyTextPreview({ items, className, ariaLabel = '알림 글', titleLevel = 4 }) {
+    /* 글자 꼴(`h5b`)과 머리글 급(`titleLevel`)은 **다른 것**이다 — 급은 바깥 묶음이 정한다 */
+    const TitleTag = titleLevel ? `h${titleLevel}` : 'div';
+    return (_jsx("div", { className: `notify-text-preview${className ? ` ${className}` : ''}`, role: "group", "aria-label": ariaLabel, children: items.map((item) => {
+            const m = measureSmsText(item.sms);
+            return (_jsxs("section", { className: "notify-text-preview__item", children: [_jsxs("header", { className: "notify-text-preview__head", children: [_jsx(TitleTag, { className: "notify-text-preview__name h5b", children: item.name }), item.meta && Object.keys(item.meta).length > 0 ? (_jsx("dl", { className: "notify-text-preview__meta caption-1", children: Object.entries(item.meta).map(([k, v]) => (_jsxs("div", { className: "notify-text-preview__meta-row", children: [_jsx("dt", { children: k }), _jsx("dd", { children: v })] }, k))) })) : null] }), _jsxs("div", { className: "notify-text-preview__body", children: [_jsxs("div", { className: "notify-text-preview__col", children: [_jsxs("div", { className: "notify-text-preview__col-head caption-1", children: [_jsx("span", { children: "\uBB38\uC790" }), _jsxs("span", { className: `notify-text-preview__bytes${m.over ? ' is-over' : ''}`, 
+                                                /* 넘은 것은 색만으로 말하지 않는다 — 색을 못 보는 사람에게도 글로 간다 */
+                                                title: m.over ? `${m.limit}바이트를 넘었다 — 보낼 때 잘린다` : undefined, children: [m.bytes, "\uBC14\uC774\uD2B8 \u00B7 ", m.type, m.over ? ' · 한계 넘음' : ''] })] }), _jsx("pre", { className: "notify-text-preview__text", children: item.sms })] }), item.ata ? (_jsxs("div", { className: "notify-text-preview__col", children: [_jsx("div", { className: "notify-text-preview__col-head caption-1", children: _jsx("span", { children: "\uC54C\uB9BC\uD1A1" }) }), _jsx("pre", { className: "notify-text-preview__text", children: item.ata })] })) : null] })] }, item.name));
+        }) }));
+}

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

@@ -140,6 +140,8 @@ export { default as DatePicker } from './components/DatePicker';
 export type { DatePickerProps } from './components/DatePicker';
 export { useCalendarMonth } from './components/useCalendarMonth';
 export type { UseCalendarMonthResult } from './components/useCalendarMonth';
+export { default as NotifyTextPreview } from './components/NotifyTextPreview';
+export type { NotifyTextPreviewProps, NotifyTextItem } from './components/NotifyTextPreview';
 export { default as BrandLogo } from './components/BrandLogo';
 export type { BrandLogoProps } from './components/BrandLogo';
 export { default as BarChart, BarChartControls } from './components/BarChart';

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

@@ -93,6 +93,9 @@ export { useCalendarMonth } from './components/useCalendarMonth';
 /* 브랜드 로고 — 그대로 · 한 톤(`tone`) · 글자만 다른 색(`textColor`).
    2026-10-15 에 로고 파일에서 `_white`·`_black`·`_textWhite` 가 없어지면서,
    그 색들을 **파일이 아니라 여기서** 내기로 했다. */
+/* 보내는 알림 글을 한자리에서 본다 — 글은 **쓰는 쪽이 넘긴다**(말귀 청 (314)).
+   코어가 쥐는 것은 재는 자(`measureSmsText`)와 그리는 꼴뿐이다. */
+export { default as NotifyTextPreview } from './components/NotifyTextPreview';
 export { default as BrandLogo } from './components/BrandLogo';
 export { default as BarChart, BarChartControls } from './components/BarChart';
 export { default as LineChart, LINE_CHART_HOVER_DELAY_MS } from './components/LineChart';

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

@@ -0,0 +1,59 @@
+/**
+ * **문자 글의 길이를 바이트로 잰다** — 말귀 청 (314), 2026-10-21.
+ *
+ * 문자는 **90바이트**에서 단문(18원)과 장문(45원)이 갈린다. 한글이 2바이트라
+ * **글자 수로는 가늠이 안 된다** — 45자가 90바이트고, 영문이 섞이면 또 달라진다.
+ * 값이 두 배 넘게 갈리는 자리라 짐작으로 둘 곳이 아니다.
+ *
+ * ## 왜 코어가 드나
+ *
+ * 같은 셈이 **말귀에 한 벌, 여기에 한 벌**로 갈릴 자리였다(말귀 `api/_lib/smsForms.ts`).
+ * 한 결정이 두 곳에 적히면 한쪽만 고쳐지는 날이 온다 — 그때 요금 갈래가 조용히 어긋난다.
+ * 말귀가 제 것을 걷고 이것을 쓰기로 했으므로 **뜻이 한 글자도 다르면 안 된다.**
+ *
+ * ## 참 EUC-KR 과 다른 자리 — 알고 둔다
+ *
+ * 이것은 참 EUC-KR 인코더가 아니라 **그 자가 재는 값을 흉내 낸 셈**이다:
+ *
+ * · **줄바꿈은 2**로 센다 — 보낼 때 `\r\n` 으로 나가기 때문이다. 그래서 글에 이미
+ *   `\r\n` 이 들어 있으면 **4로 세어 실제보다 크게** 잡는다. 크게 잡는 쪽은 **안전하다**
+ *   (단문에 들 것을 장문으로 보낼 뿐, 그 반대가 아니다). 작게 잡으면 보내는 쪽에서 잘린다.
+ * · **EUC-KR 에 없는 글자**(이모지 따위)도 2로 센다. 참 EUC-KR 은 그것을 아예 못 담아
+ *   보내는 쪽이 거르거나 바꾼다 — 길이보다 **담기는지**가 먼저인 자리라 여기서 안 다룬다.
+ *
+ * 두 자리 다 말귀가 쓰던 셈 그대로다. 고치려면 **양쪽을 같은 날 고친다.**
+ */
+/** 단문(SMS) 한 통에 드는 한계 — 넘으면 장문(LMS)이다 */
+export declare const SMS_BYTE_LIMIT = 90;
+/** 장문(LMS) 본문 한계 */
+export declare const LMS_BYTE_LIMIT = 2000;
+/** 보내는 갈래 */
+export type SmsType = 'SMS' | 'LMS';
+/**
+ * EUC-KR 바이트 — 한글 2 · ASCII 1 · 줄바꿈 2.
+ *
+ * @public
+ */
+export declare function eucKrBytes(text: string): number;
+/**
+ * 단문이냐 장문이냐 — **직접 정한다.**
+ *
+ * 보내는 쪽이 알아서 바꿔 주기도 하지만, 우리가 정하면 **어느 값으로 보냈는지 자취에 남는다.**
+ *
+ * @public
+ */
+export declare function smsTypeFor(text: string): SmsType;
+/**
+ * 글 하나를 재서 **쓰는 쪽이 그릴 만큼** 돌려준다.
+ *
+ * `over` 는 *"한계를 넘었나"* 다 — 단문이면 90, 장문이면 2000 을 기준으로 본다.
+ * 장문까지 넘으면 보내는 쪽에서 **잘린다.**
+ *
+ * @public
+ */
+export declare function measureSmsText(text: string): {
+    bytes: number;
+    type: SmsType;
+    limit: number;
+    over: boolean;
+};

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

@@ -0,0 +1,69 @@
+/**
+ * **문자 글의 길이를 바이트로 잰다** — 말귀 청 (314), 2026-10-21.
+ *
+ * 문자는 **90바이트**에서 단문(18원)과 장문(45원)이 갈린다. 한글이 2바이트라
+ * **글자 수로는 가늠이 안 된다** — 45자가 90바이트고, 영문이 섞이면 또 달라진다.
+ * 값이 두 배 넘게 갈리는 자리라 짐작으로 둘 곳이 아니다.
+ *
+ * ## 왜 코어가 드나
+ *
+ * 같은 셈이 **말귀에 한 벌, 여기에 한 벌**로 갈릴 자리였다(말귀 `api/_lib/smsForms.ts`).
+ * 한 결정이 두 곳에 적히면 한쪽만 고쳐지는 날이 온다 — 그때 요금 갈래가 조용히 어긋난다.
+ * 말귀가 제 것을 걷고 이것을 쓰기로 했으므로 **뜻이 한 글자도 다르면 안 된다.**
+ *
+ * ## 참 EUC-KR 과 다른 자리 — 알고 둔다
+ *
+ * 이것은 참 EUC-KR 인코더가 아니라 **그 자가 재는 값을 흉내 낸 셈**이다:
+ *
+ * · **줄바꿈은 2**로 센다 — 보낼 때 `\r\n` 으로 나가기 때문이다. 그래서 글에 이미
+ *   `\r\n` 이 들어 있으면 **4로 세어 실제보다 크게** 잡는다. 크게 잡는 쪽은 **안전하다**
+ *   (단문에 들 것을 장문으로 보낼 뿐, 그 반대가 아니다). 작게 잡으면 보내는 쪽에서 잘린다.
+ * · **EUC-KR 에 없는 글자**(이모지 따위)도 2로 센다. 참 EUC-KR 은 그것을 아예 못 담아
+ *   보내는 쪽이 거르거나 바꾼다 — 길이보다 **담기는지**가 먼저인 자리라 여기서 안 다룬다.
+ *
+ * 두 자리 다 말귀가 쓰던 셈 그대로다. 고치려면 **양쪽을 같은 날 고친다.**
+ */
+/** 단문(SMS) 한 통에 드는 한계 — 넘으면 장문(LMS)이다 */
+export const SMS_BYTE_LIMIT = 90;
+/** 장문(LMS) 본문 한계 */
+export const LMS_BYTE_LIMIT = 2000;
+/**
+ * EUC-KR 바이트 — 한글 2 · ASCII 1 · 줄바꿈 2.
+ *
+ * @public
+ */
+export function eucKrBytes(text) {
+    let bytes = 0;
+    for (const ch of text) {
+        const code = ch.codePointAt(0) ?? 0;
+        if (ch === '\n' || ch === '\r')
+            bytes += 2;
+        else
+            bytes += code < 0x80 ? 1 : 2;
+    }
+    return bytes;
+}
+/**
+ * 단문이냐 장문이냐 — **직접 정한다.**
+ *
+ * 보내는 쪽이 알아서 바꿔 주기도 하지만, 우리가 정하면 **어느 값으로 보냈는지 자취에 남는다.**
+ *
+ * @public
+ */
+export function smsTypeFor(text) {
+    return eucKrBytes(text) > SMS_BYTE_LIMIT ? 'LMS' : 'SMS';
+}
+/**
+ * 글 하나를 재서 **쓰는 쪽이 그릴 만큼** 돌려준다.
+ *
+ * `over` 는 *"한계를 넘었나"* 다 — 단문이면 90, 장문이면 2000 을 기준으로 본다.
+ * 장문까지 넘으면 보내는 쪽에서 **잘린다.**
+ *
+ * @public
+ */
+export function measureSmsText(text) {
+    const bytes = eucKrBytes(text);
+    const type = smsTypeFor(text);
+    const limit = type === 'SMS' ? SMS_BYTE_LIMIT : LMS_BYTE_LIMIT;
+    return { bytes, type, limit, over: bytes > limit };
+}

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

@@ -6,6 +6,8 @@ export { configureTTS, getTTSUrlResolver, getTTSFallbackUrlResolver, clearAudioE
 export { configurePronunciationResolver, getPronunciationResolver } from './utils/pronunciationConfig';
 export { getElementAnalyser, resumeAudioMeter, readLevel, routeElementAudio, setElementVolume, getElementVolume } from './utils/audioMeter';
 export { configureImageResolver, getImageResolver, checkImageExists, getImageExistsCached, prewarmImageCache, bulkSetImageExistence, clearImageExistenceCache, getImageExistenceStats } from './utils/imageConfig';
+export { eucKrBytes, smsTypeFor, measureSmsText, SMS_BYTE_LIMIT, LMS_BYTE_LIMIT } from './utils/smsBytes';
+export type { SmsType } from './utils/smsBytes';
 export { buildPairIndex, getPairIndex, clearPairIndexCache } from './utils/wordPairIndex';
 export type { PairIndex, PairIndexEntry, PairInput } from './utils/wordPairIndex';
 export { minimalPairDistractors, filterContrastCandidates, hasStructureContrast, buildMultiPartPosContrast, hasSel } from './utils/wordContrast';

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

@@ -5,6 +5,9 @@ export { configureTTS, getTTSUrlResolver, getTTSFallbackUrlResolver, clearAudioE
 export { configurePronunciationResolver, getPronunciationResolver } from './utils/pronunciationConfig';
 export { getElementAnalyser, resumeAudioMeter, readLevel, routeElementAudio, setElementVolume, getElementVolume } from './utils/audioMeter';
 export { configureImageResolver, getImageResolver, checkImageExists, getImageExistsCached, prewarmImageCache, bulkSetImageExistence, clearImageExistenceCache, getImageExistenceStats } from './utils/imageConfig';
+/* 문자 글의 바이트 — 90바이트가 단문(18원)과 장문(45원)을 가른다(말귀 청 (314)).
+   말귀가 제 셈을 걷고 이것을 쓴다 — 한 결정이 두 곳에 적히지 않게. */
+export { eucKrBytes, smsTypeFor, measureSmsText, SMS_BYTE_LIMIT, LMS_BYTE_LIMIT } from './utils/smsBytes';
 export { buildPairIndex, getPairIndex, clearPairIndexCache } from './utils/wordPairIndex';
 export { minimalPairDistractors, filterContrastCandidates, hasStructureContrast, buildMultiPartPosContrast, hasSel } from './utils/wordContrast';
 export { parseSyllable, composeSyllable, createDecompCache, CHOSEONG, JUNGSEONG, JONGSEONG } from './utils/koreanSyllable';

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

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

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

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