open-grid 1.1.1 → 1.2.0

package/dist/types/core/Pagination.d.ts

@@ -5,6 +5,8 @@ export interface PageChangeEvent {
     totalPages: number;
 }
 export type PageChangeFn = (e: PageChangeEvent) => void;
+/** i18n: 페이지네이션 라벨 해석기(행/페이지·범위 배지·빈 상태). / i18n: pagination label resolver (rows-per-page, range badge, empty). */
+export type PaginationT = (key: string, params?: Record<string, string | number>) => string;
 /**
  * 그리드 하단 페이지네이션 UI + 상태 관리.
  * DataLayer의 _displayIndexes 슬라이싱을 담당.
@@ -15,7 +17,8 @@ export declare class Pagination {
     private _pageSize;
     private _totalRows;
     private _onChange;
-    constructor(container: HTMLElement, pageSize: number, onChange: PageChangeFn);
+    private _t;
+    constructor(container: HTMLElement, pageSize: number, onChange: PageChangeFn, t?: PaginationT);
     get page(): number;
     get pageSize(): number;
     get totalPages(): number;
@@ -30,5 +33,7 @@ export declare class Pagination {
     };
     private _emit;
     private _render;
+    /** i18n: 상주 크롬 라벨을 활성 로케일로 다시 그린다(setLocale 경로). / i18n: repaint resident chrome labels in the active locale (setLocale path). */
+    refreshLabels(): void;
     destroy(): void;
 }

package/dist/types/core/RangeSelectionManager.d.ts

@@ -23,6 +23,8 @@ export interface RangeSelectionDeps<T extends Record<string, any>> {
     emit: (event: string, ...args: any[]) => void;
     doRender: () => void;
     announce: (msg: string) => void;
+    /** i18n: 범위 선택/채우기 announce·aria 해석. / i18n: resolve range selection/fill announce & aria. */
+    t: (key: string, params?: Record<string, string | number>) => string;
     hasCellFormula?: (rowId: string, field: string) => boolean;
     offsetFormula?: (rowId: string, field: string, dRow: number, dCol: number) => string;
     setCellFormulaByRowId?: (rowId: string, field: string, formula: string) => void;

package/dist/types/core/SortFilterManager.d.ts

@@ -13,6 +13,8 @@ export interface SortFilterDeps<T extends Record<string, any>> {
     renderHeader: () => void;
     doRender: () => void;
     announce: (msg: string) => void;
+    /** i18n: 정렬 상태어 + announce 해석. / i18n: resolve sort state words + announce. */
+    t: (key: string, params?: Record<string, string | number>) => string;
     emit: (event: string, ...args: any[]) => void;
     /** C0.5/§2.5: 정렬/필터 후 F1 범위 선택을 rowId 집합 기준으로 재투영(해제 아님). */
     onReproject?: () => void;

package/dist/types/core/WorksheetManager.d.ts

@@ -1,11 +1,14 @@
 import { ColumnDef, WorksheetState } from './types.js';
 export type SwitchCallback<T> = (name: string, state: WorksheetState<T>) => void;
+/** i18n: 탭 UI aria 해석기(주입 없으면 전역 t). / i18n: tab-UI aria resolver (global t when not injected). */
+export type WorksheetT = (key: string, params?: Record<string, string | number>) => string;
 export declare class WorksheetManager<T extends Record<string, any> = any> {
     private _sheets;
     private _active;
     private _tabBar;
     private _onSwitch;
-    constructor(container: HTMLElement, onSwitch: SwitchCallback<T>);
+    private _t;
+    constructor(container: HTMLElement, onSwitch: SwitchCallback<T>, t?: WorksheetT);
     add(name: string, columns?: ColumnDef<T>[], data?: T[]): void;
     remove(name: string): void;
     rename(oldName: string, newName: string): void;

package/dist/types/core/detail/DetailGlyph.d.ts

@@ -12,6 +12,8 @@
  * 렌더 배선(GridRenderer expander 셀)이 이 모듈의 순수 함수/상수를 소비해 실제 DOM 속성을 채운다.
  * 이 파일은 DOM 을 만들지 않는다 — 문자열/속성 값만 생성.
  */
+/** i18n: 글리프 aria/툴팁 로케일 해석기(주입 없으면 전역 t). / i18n: glyph aria/tooltip resolver (global t when not injected). */
+export type DetailGlyphT = (key: string, params?: Record<string, string | number>) => string;
 /** 트리 셰브론(▸/▾)과 충돌하지 않는 전용 글리프(C10 기본값). */
 export declare const DETAIL_GLYPH_COLLAPSED = "\u2295";
 export declare const DETAIL_GLYPH_EXPANDED = "\u2296";
@@ -32,7 +34,7 @@ export interface DetailGlyphInfo {
  * 펼침 여부에 따른 글리프/aria-label/title 조합을 반환한다. 트리 셰브론과 절대 겹치지 않는
  * 문자셋만 사용(C10 R-DETAIL-GLYPH 하드 룰).
  */
-export declare function getDetailGlyph(expanded: boolean): DetailGlyphInfo;
+export declare function getDetailGlyph(expanded: boolean, t?: DetailGlyphT): DetailGlyphInfo;
 /** NFR-5(1): 마스터 행 `aria-expanded` 값(문자열 — DOM setAttribute 그대로 사용). */
 export declare function getMasterRowAriaExpanded(expanded: boolean): 'true' | 'false';
 /**

package/dist/types/core/i18n/interpolate.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `{name}` 명명 파라미터를 치환한다. `{{`→`{`, `}}`→`}` 이스케이프. 누락 파라미터는 플레이스홀더 유지.
+ * / Substitute `{name}` params. Escapes `{{`→`{`, `}}`→`}`. Missing params keep the placeholder.
+ */
+export declare function interpolate(template: string, params?: Readonly<Record<string, string | number>>): string;

package/dist/types/core/i18n/locales/en.d.ts

@@ -0,0 +1,166 @@
+import { LocaleMeta } from '../types.js';
+/** en 메시지 카탈로그. / en message catalog. */
+export declare const EN_MESSAGES: {
+    contextMenu: {
+        sortAsc: string;
+        sortDesc: string;
+        find: string;
+        exportExcel: string;
+        exportCsv: string;
+        print: string;
+    };
+    filter: {
+        title: string;
+        opContains: string;
+        opEq: string;
+        opNe: string;
+        opStartsWith: string;
+        opEndsWith: string;
+        opGt: string;
+        opLt: string;
+        opGte: string;
+        opLte: string;
+        valuePlaceholder: string;
+        clear: string;
+        apply: string;
+        legend: string;
+        clearAria: string;
+        all: string;
+    };
+    findBar: {
+        label: string;
+        placeholder: string;
+        searchAria: string;
+        closeAria: string;
+        countBadge: (p: Readonly<Record<string, string | number>>) => string;
+    };
+    pagination: {
+        rowsPerPage: string;
+        rangeBadge: string;
+        empty: string;
+    };
+    drag: {
+        rowCount: (p: Readonly<Record<string, string | number>>) => string;
+    };
+    crossGrid: {
+        overlayAria: string;
+        title: string;
+        desc1: string;
+        desc2: string;
+        emptyOption: string;
+        scriptTitle: string;
+        copy: string;
+        copied: string;
+        copyFailed: string;
+        cancel: string;
+        applyMove: string;
+        scriptComment: string;
+    };
+    shuttle: {
+        toRight: string;
+        toLeft: string;
+        allRight: string;
+        allLeft: string;
+    };
+    tree: {
+        collapse: string;
+        expand: string;
+    };
+    detail: {
+        glyphLabel: string;
+        glyphTooltip: string;
+        expandAria: string;
+        collapseAria: string;
+        expandedAnnounce: string;
+        collapsedAnnounce: string;
+        collapsedAllAnnounce: string;
+        depthLimitOpen: string;
+        depthLimitSubgrid: string;
+    };
+    worksheet: {
+        addAria: string;
+    };
+    editor: {
+        datePick: string;
+        select: string;
+        cellPositionAnnounce: string;
+    };
+    cell: {
+        emptyValue: string;
+        revealTooltip: string;
+        revealAria: string;
+        radioAria: string;
+        barcodeAria: string;
+    };
+    row: {
+        selectAllAria: string;
+        selectAria: string;
+        moveAnnounce: string;
+    };
+    group: {
+        badge: string;
+        nullLabel: string;
+    };
+    pivot: {
+        totalLabel: string;
+    };
+    data: {
+        loadedAnnounce: (p: Readonly<Record<string, string | number>>) => string;
+        skippedCellsAnnounce: (p: Readonly<Record<string, string | number>>) => string;
+    };
+    range: {
+        selectionAnnounce: string;
+        formulaPreserved: (p: Readonly<Record<string, string | number>>) => string;
+        fillSkipped: (p: Readonly<Record<string, string | number>>) => string;
+        fillHandleAria: string;
+    };
+    sort: {
+        asc: string;
+        desc: string;
+        none: string;
+        announce: string;
+    };
+    chart: {
+        defaultTitle: string;
+        badgeSampled: string;
+        badgeAggregated: string;
+        badgePieFirstSeries: string;
+        badgeNegativesAbs: string;
+        badgeRangeFallback: string;
+        badgeEngineFallback: string;
+        announcePrefix: string;
+        a11ySummary: string;
+        a11ySummaryNoTitle: string;
+        a11yAltText: string;
+        a11yNoData: string;
+        tooltipEmpty: string;
+        canvasDefault: string;
+    };
+    formulaError: {
+        err: string;
+        ref: string;
+        cycle: string;
+        div0: string;
+        name: string;
+        value: string;
+        num: string;
+        fallback: string;
+    };
+    formula: {
+        cellErrorAnnounce: string;
+        ariaError: string;
+        ariaValue: string;
+        approxSuffix: string;
+    };
+    grid: {
+        containerAria: string;
+        emptyMessage: string;
+        filterTooltip: string;
+        detailRegion: string;
+    };
+    export: {
+        printSummary: string;
+    };
+};
+/** en 포맷 메타. / en format meta. */
+export declare const EN_META: LocaleMeta;

package/dist/types/core/i18n/locales/ko.d.ts

@@ -0,0 +1,166 @@
+import { LocaleMeta } from '../types.js';
+/** ko 메시지 카탈로그. `satisfies` 로 키 완전성 컴파일 강제. / ko message catalog. `satisfies` enforces key completeness at compile time. */
+export declare const KO_MESSAGES: {
+    contextMenu: {
+        sortAsc: string;
+        sortDesc: string;
+        find: string;
+        exportExcel: string;
+        exportCsv: string;
+        print: string;
+    };
+    filter: {
+        title: string;
+        opContains: string;
+        opEq: string;
+        opNe: string;
+        opStartsWith: string;
+        opEndsWith: string;
+        opGt: string;
+        opLt: string;
+        opGte: string;
+        opLte: string;
+        valuePlaceholder: string;
+        clear: string;
+        apply: string;
+        legend: string;
+        clearAria: string;
+        all: string;
+    };
+    findBar: {
+        label: string;
+        placeholder: string;
+        searchAria: string;
+        closeAria: string;
+        countBadge: string;
+    };
+    pagination: {
+        rowsPerPage: string;
+        rangeBadge: string;
+        empty: string;
+    };
+    drag: {
+        rowCount: string;
+    };
+    crossGrid: {
+        overlayAria: string;
+        title: string;
+        desc1: string;
+        desc2: string;
+        emptyOption: string;
+        scriptTitle: string;
+        copy: string;
+        copied: string;
+        copyFailed: string;
+        cancel: string;
+        applyMove: string;
+        scriptComment: string;
+    };
+    shuttle: {
+        toRight: string;
+        toLeft: string;
+        allRight: string;
+        allLeft: string;
+    };
+    tree: {
+        collapse: string;
+        expand: string;
+    };
+    detail: {
+        glyphLabel: string;
+        glyphTooltip: string;
+        expandAria: string;
+        collapseAria: string;
+        expandedAnnounce: string;
+        collapsedAnnounce: string;
+        collapsedAllAnnounce: string;
+        depthLimitOpen: string;
+        depthLimitSubgrid: string;
+    };
+    worksheet: {
+        addAria: string;
+    };
+    editor: {
+        datePick: string;
+        select: string;
+        cellPositionAnnounce: string;
+    };
+    cell: {
+        emptyValue: string;
+        revealTooltip: string;
+        revealAria: string;
+        radioAria: string;
+        barcodeAria: string;
+    };
+    row: {
+        selectAllAria: string;
+        selectAria: string;
+        moveAnnounce: string;
+    };
+    group: {
+        badge: string;
+        nullLabel: string;
+    };
+    pivot: {
+        totalLabel: string;
+    };
+    data: {
+        loadedAnnounce: string;
+        skippedCellsAnnounce: string;
+    };
+    range: {
+        selectionAnnounce: string;
+        formulaPreserved: string;
+        fillSkipped: string;
+        fillHandleAria: string;
+    };
+    sort: {
+        asc: string;
+        desc: string;
+        none: string;
+        announce: string;
+    };
+    chart: {
+        defaultTitle: string;
+        badgeSampled: string;
+        badgeAggregated: string;
+        badgePieFirstSeries: string;
+        badgeNegativesAbs: string;
+        badgeRangeFallback: string;
+        badgeEngineFallback: string;
+        announcePrefix: string;
+        a11ySummary: string;
+        a11ySummaryNoTitle: string;
+        a11yAltText: string;
+        a11yNoData: string;
+        tooltipEmpty: string;
+        canvasDefault: string;
+    };
+    formulaError: {
+        err: string;
+        ref: string;
+        cycle: string;
+        div0: string;
+        name: string;
+        value: string;
+        num: string;
+        fallback: string;
+    };
+    formula: {
+        cellErrorAnnounce: string;
+        ariaError: string;
+        ariaValue: string;
+        approxSuffix: string;
+    };
+    grid: {
+        containerAria: string;
+        emptyMessage: string;
+        filterTooltip: string;
+        detailRegion: string;
+    };
+    export: {
+        printSummary: string;
+    };
+};
+/** ko 포맷 메타(Intl 태그·방향·수출 폰트). / ko format meta (Intl tag, direction, export font). */
+export declare const KO_META: LocaleMeta;

package/dist/types/core/i18n/types.d.ts

@@ -0,0 +1,249 @@
+/** 보간 파라미터. 명명 파라미터만(위치 파라미터 금지 — 어순이 언어마다 다름). / Interpolation params. Named only (positional forbidden — word order differs per language). */
+export type MessageParams = Readonly<Record<string, string | number>>;
+/**
+ * 메시지 값: 평문 문자열('{name}' 보간) 또는 함수(복수형·조사 등 "문법이 데이터인" 케이스의 탈출구).
+ * ICU/CLDR 복수 엔진은 zero-dependency 정체성 때문에 도입하지 않는다(규칙은 로케일 파일에 둔다).
+ * / A message value: a plain string ('{name}' interpolation) or a function (escape hatch for
+ *   plurals/particles where "grammar is data"). No ICU/CLDR plural engine (zero-dependency).
+ */
+export type MessageValue = string | ((params: MessageParams) => string);
+/**
+ * 로케일 메시지 카탈로그(2단 중첩, 최상위 섹션 = 소비 UI 표면). 파라미터를 받는 값만 `MessageValue`
+ * (함수형 복수 허용), 정적 라벨은 `string`. 내장 ko 가 SSOT 이며 en 은 동일 키 집합을 갖는다.
+ * / The locale message catalog (2-level nested, top-level section = consuming UI surface). Only
+ *   parameterized entries are `MessageValue` (allowing plural functions); static labels are
+ *   `string`. Built-in ko is the SSOT; en carries the same key set.
+ */
+export interface LocaleMessages {
+    /** 우클릭 컨텍스트 메뉴 라벨. / Right-click context-menu labels. */
+    contextMenu: {
+        sortAsc: string;
+        sortDesc: string;
+        find: string;
+        exportExcel: string;
+        exportCsv: string;
+        print: string;
+    };
+    /** 필터 패널·필터 셀렉트 라벨. / Filter panel & filter-select labels. */
+    filter: {
+        title: string;
+        opContains: string;
+        opEq: string;
+        opNe: string;
+        opStartsWith: string;
+        opEndsWith: string;
+        opGt: string;
+        opLt: string;
+        opGte: string;
+        opLte: string;
+        valuePlaceholder: string;
+        clear: string;
+        apply: string;
+        legend: string;
+        clearAria: string;
+        all: string;
+    };
+    /** 찾기 바 라벨/placeholder/aria/카운트 배지. / Find-bar label/placeholder/aria/count badge. */
+    findBar: {
+        label: string;
+        placeholder: string;
+        searchAria: string;
+        closeAria: string;
+        /** 결과 개수 배지. 파라미터 {n}. / Result count badge. Param {n}. */
+        countBadge: MessageValue;
+    };
+    /** 페이지네이션 라벨/범위 배지/빈 상태. / Pagination labels/range badge/empty state. */
+    pagination: {
+        rowsPerPage: string;
+        /** 현재 범위 배지. 파라미터 {from} {to} {total}. / Current range badge. Params {from} {to} {total}. */
+        rangeBadge: MessageValue;
+        empty: string;
+    };
+    /** 행 드래그 고스트 라벨. / Row-drag ghost label. */
+    drag: {
+        /** 드래그 중 행 개수. 파라미터 {count}. / Rows being dragged. Param {count}. */
+        rowCount: MessageValue;
+    };
+    /** 크로스그리드 매핑 다이얼로그(디자인타임 헬퍼). / Cross-grid mapping dialog (design-time helper). */
+    crossGrid: {
+        overlayAria: string;
+        title: string;
+        desc1: string;
+        desc2: string;
+        emptyOption: string;
+        scriptTitle: string;
+        copy: string;
+        copied: string;
+        copyFailed: string;
+        cancel: string;
+        applyMove: string;
+        scriptComment: string;
+    };
+    /** 그리드↔그리드 셔틀 버튼 aria/tooltip. / Grid-to-grid shuttle button aria/tooltip. */
+    shuttle: {
+        toRight: string;
+        toLeft: string;
+        allRight: string;
+        allLeft: string;
+    };
+    /** 트리 노드 확장/접기 aria. / Tree node expand/collapse aria. */
+    tree: {
+        collapse: string;
+        expand: string;
+    };
+    /** 마스터/디테일 글리프·announce. / Master/detail glyph & announce. */
+    detail: {
+        glyphLabel: string;
+        glyphTooltip: string;
+        expandAria: string;
+        collapseAria: string;
+        expandedAnnounce: string;
+        collapsedAnnounce: string;
+        collapsedAllAnnounce: string;
+        /** 상세 패널 깊이 한계. 파라미터 {max}. / Detail depth limit. Param {max}. */
+        depthLimitOpen: MessageValue;
+        /** 서브그리드 깊이 한계. 파라미터 {max}. / Subgrid depth limit. Param {max}. */
+        depthLimitSubgrid: MessageValue;
+    };
+    /** 워크시트 탭 UI. / Worksheet tab UI. */
+    worksheet: {
+        addAria: string;
+    };
+    /** 인라인 에디터 aria/announce. / Inline editor aria/announce. */
+    editor: {
+        datePick: string;
+        select: string;
+        /** 편집 셀 위치 announce. 파라미터 {row} {col} {header} {value}. / Edited-cell position announce. Params {row} {col} {header} {value}. */
+        cellPositionAnnounce: MessageValue;
+    };
+    /** 셀 렌더러(마스킹·라디오·바코드·수식 빈값). / Cell renderer (masking/radio/barcode/formula empty). */
+    cell: {
+        emptyValue: string;
+        revealTooltip: string;
+        revealAria: string;
+        radioAria: string;
+        /** 바코드 셀 aria. 파라미터 {value}. / Barcode cell aria. Param {value}. */
+        barcodeAria: MessageValue;
+    };
+    /** 행 선택 aria + 행 이동 announce. / Row selection aria + row-move announce. */
+    row: {
+        selectAllAria: string;
+        /** 행 체크박스 aria. 파라미터 {n}. / Row checkbox aria. Param {n}. */
+        selectAria: MessageValue;
+        /** 행 이동 announce. 파라미터 {from} {to}. / Row-move announce. Params {from} {to}. */
+        moveAnnounce: MessageValue;
+    };
+    /** 그룹 행 배지/null 라벨. / Group-row badge / null label. */
+    group: {
+        /** 그룹 배지. 파라미터 {label} {count}. / Group badge. Params {label} {count}. */
+        badge: MessageValue;
+        nullLabel: string;
+    };
+    /** 피벗 총계 행. / Pivot total row. */
+    pivot: {
+        totalLabel: string;
+    };
+    /** 데이터 로드/스킵 announce. / Data load/skip announce. */
+    data: {
+        /** 데이터 로드 announce. 파라미터 {count}. / Data-loaded announce. Param {count}. */
+        loadedAnnounce: MessageValue;
+        /** 쓰기 대상 아닌 셀 스킵 announce. 파라미터 {count}. / Non-writable cells skipped announce. Param {count}. */
+        skippedCellsAnnounce: MessageValue;
+    };
+    /** 범위 선택 + 채우기 announce/aria. / Range selection + fill announce/aria. */
+    range: {
+        /** 범위 선택 announce. 파라미터 {r1} {c1} {r2} {c2} {n}. / Range selection announce. Params {r1} {c1} {r2} {c2} {n}. */
+        selectionAnnounce: MessageValue;
+        /** 수식 셀 보존 announce. 파라미터 {count}. / Formula cells preserved announce. Param {count}. */
+        formulaPreserved: MessageValue;
+        /** 채우기 스킵 announce. 파라미터 {count}. / Fill-skipped announce. Param {count}. */
+        fillSkipped: MessageValue;
+        fillHandleAria: string;
+    };
+    /** 정렬 상태어 + announce. / Sort state words + announce. */
+    sort: {
+        asc: string;
+        desc: string;
+        none: string;
+        /** 정렬 announce. 파라미터 {field} {dir}. / Sort announce. Params {field} {dir}. */
+        announce: MessageValue;
+    };
+    /** F4 차트 배지·announce·접근성 요약. / F4 chart badges/announce/a11y summary. */
+    chart: {
+        defaultTitle: string;
+        /** 샘플링 배지. 파라미터 {to} {from}. / Sampled badge. Params {to} {from}. */
+        badgeSampled: MessageValue;
+        /** 집계 배지. 파라미터 {op}. / Aggregated badge. Param {op}. */
+        badgeAggregated: MessageValue;
+        badgePieFirstSeries: string;
+        badgeNegativesAbs: string;
+        badgeRangeFallback: string;
+        /** 엔진 폴백 배지. 파라미터 {engine}. / Engine-fallback badge. Param {engine}. */
+        badgeEngineFallback: MessageValue;
+        /** 배지 announce 접두. 파라미터 {badges}. / Badge announce prefix. Param {badges}. */
+        announcePrefix: MessageValue;
+        /** 접근성 요약. 파라미터 {title} {categories} {series}. / A11y summary. Params {title} {categories} {series}. */
+        a11ySummary: MessageValue;
+        /** 무제목 접근성 요약. 파라미터 {categories} {series}. / Titleless a11y summary. Params {categories} {series}. */
+        a11ySummaryNoTitle: MessageValue;
+        /** 캔버스 대체 텍스트. 파라미터 {title} {categories} {series}. / Canvas alt text. Params {title} {categories} {series}. */
+        a11yAltText: MessageValue;
+        a11yNoData: string;
+        tooltipEmpty: string;
+        canvasDefault: string;
+    };
+    /** 사용자 노출 수식 오류 셀 라벨. / User-facing formula error cell labels. */
+    formulaError: {
+        err: string;
+        ref: string;
+        cycle: string;
+        div0: string;
+        name: string;
+        value: string;
+        num: string;
+        fallback: string;
+    };
+    /** 수식 셀 announce/aria(파라미터형). / Formula cell announce/aria (parameterized). */
+    formula: {
+        /** 셀 오류 announce. 파라미터 {field} {message}. / Cell error announce. Params {field} {message}. */
+        cellErrorAnnounce: MessageValue;
+        /** 수식 오류 셀 aria. 파라미터 {src} {message}. / Formula error cell aria. Params {src} {message}. */
+        ariaError: MessageValue;
+        /** 수식 값 셀 aria. 파라미터 {src} {value} {approx}. / Formula value cell aria. Params {src} {value} {approx}. */
+        ariaValue: MessageValue;
+        approxSuffix: string;
+    };
+    /** 컨테이너·빈 상태·헤더 필터 아이콘·디테일 영역 aria/tooltip. / Container/empty/header-filter/detail-region aria & tooltip. */
+    grid: {
+        containerAria: string;
+        emptyMessage: string;
+        filterTooltip: string;
+        detailRegion: string;
+    };
+    /** 인쇄/내보내기 문서 문구(포맷 파라미터형). / Print/export document strings (parameterized). */
+    export: {
+        /** 인쇄 요약행. 파라미터 {rows} {cols} {date}. / Print summary row. Params {rows} {cols} {date}. */
+        printSummary: MessageValue;
+    };
+}
+/** 부분 오버라이드(2단 딥머지, 카탈로그 위). / Partial override (2-level deep-merge over the catalog). */
+export type PartialLocaleMessages = {
+    [S in keyof LocaleMessages]?: Partial<LocaleMessages[S]>;
+};
+/** dot-key 유니온(`'filter.apply'` 등) — 오타를 컴파일 에러화. / Dot-key union (e.g. `'filter.apply'`) — typos become compile errors. */
+export type LocaleMessageKey = {
+    [S in keyof LocaleMessages]: `${S & string}.${keyof LocaleMessages[S] & string}`;
+}[keyof LocaleMessages];
+/** 로케일 포맷 파라미터(문자열 아님): Intl 태그·방향·수출 폰트. / Locale format params (non-string): Intl tag, direction, export font. */
+export interface LocaleMeta {
+    /** BCP-47 태그(toLocaleString/lang/인쇄 템플릿용). 예 'ko-KR'. / BCP-47 tag (for toLocaleString/lang/print template). e.g. 'ko-KR'. */
+    readonly intlLocale: string;
+    /** 텍스트 방향(현 코어는 ltr 검증). / Text direction (core validated for ltr). */
+    readonly dir?: 'ltr' | 'rtl';
+    /** Excel 내보내기 기본 폰트. / Default font for Excel export. */
+    readonly exportFont?: string;
+}
+/** register() 결과 — 누락 키 정직 신호(막지 않음). / register() result — honest missing-key signal (never blocks). */
+export interface LocaleRegisterResult {
+    readonly missingKeys: string[];
+}

package/dist/types/core/renderers/CellRenderer.d.ts

@@ -1,4 +1,7 @@
 import { ColumnDef, RendererDef } from '../types.js';
+/** i18n: 렌더 컨텍스트 로케일 해석기(주입 없으면 전역 t). 인스턴스 로케일이 전역보다 우선.
+ *  / i18n: render-context locale resolver (global t when not injected). Instance locale wins over global. */
+export declare function ctxT(ctx: RenderContext, key: string, params?: Record<string, string | number>): string;
 export interface RenderContext<T = any> {
     value: any;
     row: T;
@@ -7,6 +10,8 @@ export interface RenderContext<T = any> {
     colIndex: number;
     isSelected: boolean;
     rowState: 'none' | 'added' | 'edited' | 'removed';
+    /** i18n: 인스턴스 로케일 해석기(GridRenderer/CellEditManager 가 주입, 미주입 시 전역 t 폴백). / i18n: instance locale resolver (injected; global-t fallback). */
+    t?: (key: string, params?: Record<string, string | number>) => string;
     displayValue?: string | null;
     /** R1b: per-instance displayFormatter 전략(값·필드·행 → 표시문자열|null). Number/Date 렌더러가
      *  ctx.value 위에 적용한다(모듈전역 없이 멀티그리드 격리). null 반환/미설정 시 기본 포맷 폴백.