open-grid 1.1.1 → 1.2.0

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

@@ -8,10 +8,14 @@ export interface ContextMenuActions {
     onCsv: () => void;
     onPrint: () => void;
 }
+/** i18n: 메시지 해석기 시그니처. / i18n: message resolver signature. */
+export type ContextMenuT = (key: string, params?: Record<string, string | number>) => string;
+/** 기본 메뉴 항목(ko 라벨) — i18n 미주입 폴백 + 구조 계약(테스트/공개 표면). / Default items (ko labels) — i18n fallback + structural contract. */
 export declare const DEFAULT_CONTEXT_ITEMS: ContextMenuItem[];
 export declare class ContextMenuManager {
     private readonly _anchor;
     private readonly _actions;
+    private readonly _t?;
     private _el;
     private _docClick;
     private _docKey;
@@ -22,7 +26,7 @@ export declare class ContextMenuManager {
      * @param _anchor  그리드 컨테이너 엘리먼트 — CSS 변수 상속 기준점
      * @param _actions 기본 액션 핸들러 (OpenGrid에서 주입)
      */
-    constructor(_anchor: HTMLElement, _actions: ContextMenuActions);
+    constructor(_anchor: HTMLElement, _actions: ContextMenuActions, _t?: ContextMenuT | undefined);
     open(e: MouseEvent, customItems?: ContextMenuItem[]): void;
     close(): void;
     destroy(): void;

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

@@ -19,6 +19,8 @@ export interface DetailManagerDeps<T extends Record<string, any> = any> {
     doRenderFull: (n: number) => void;
     emit: (ev: string, payload: any) => void;
     announce: (msg: string) => void;
+    /** i18n: 깊이 한계/펼침·접힘 announce 메시지 해석. / i18n: resolve depth-limit & expand/collapse announces. */
+    t: (key: string, params?: Record<string, string | number>) => string;
     /** 이 그리드 인스턴스의 중첩 깊이(0=최상위, 부모가 자식 생성 시 depth+1 주입). */
     getDepth: () => number;
     /** masterDetail.renderer 의 DetailRenderApi.grid 에 실어줄 인스턴스. */

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

@@ -11,6 +11,13 @@ export interface ExportDeps<T extends Record<string, any>> {
     getWsManager: () => WorksheetManager<T> | null;
     /** Phase 2: OverrideKernel.getStrategy 주입(슬롯 cellSerializer 도달용). */
     getStrategy?: <F extends Function>(slot: string, fallback: F) => F;
+    /** i18n: 인쇄 요약행 해석(미주입 시 ko 폴백). / i18n: resolve print summary row (ko fallback when absent). */
+    t?: (key: string, params?: Record<string, string | number>) => string;
+    /** i18n: 로케일 포맷 메타(인쇄 lang·날짜 로케일·Excel 폰트). / i18n: locale format meta (print lang, date locale, Excel font). */
+    getMeta?: () => {
+        intlLocale: string;
+        exportFont?: string;
+    };
 }
 export declare class ExportManager<T extends Record<string, any> = any> {
     private _d;

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

@@ -1,6 +1,8 @@
 import { FilterItem } from './types.js';
 export type FilterApplyFn = (field: string, items: FilterItem[]) => void;
 export type FilterClearFn = (field: string) => void;
+/** i18n: 필터 라벨 로케일 해석기(주입 없으면 전역 t). / i18n: filter-label resolver (global t when not injected). */
+export type FilterPanelT = (key: string, params?: Record<string, string | number>) => string;
 /**
  * 컬럼 헤더 필터 드롭다운 패널.
  * 단일 인스턴스를 재사용(열릴 때 위치 재계산).
@@ -10,8 +12,9 @@ export declare class FilterPanel {
     private _field;
     private _onApply;
     private _onClear;
+    private _t;
     private _outsideHandler;
-    constructor(container: HTMLElement, onApply: FilterApplyFn, onClear: FilterClearFn);
+    constructor(container: HTMLElement, onApply: FilterApplyFn, onClear: FilterClearFn, t?: FilterPanelT);
     open(field: string, anchorEl: HTMLElement, currentFilters: FilterItem[]): void;
     close(): void;
     get isOpen(): boolean;

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

@@ -1,4 +1,6 @@
 import { FilterItem } from './types.js';
+/** i18n: 필터 셀렉트 라벨 해석기(주입 없으면 전역 t). / i18n: filter-select label resolver (global t when not injected). */
+export type FilterSelectT = (key: string, params?: Record<string, string | number>) => string;
 export interface FilterSelectOption {
     value: string;
     text: string;
@@ -74,7 +76,8 @@ export declare class FilterSelectPanel {
     private _config;
     private _onFilter;
     private _onReset;
-    constructor(container: HTMLElement, config: FilterSelectConfig, onFilter: FilterFn, onReset: ResetFn, gridId?: string);
+    private _t;
+    constructor(container: HTMLElement, config: FilterSelectConfig, onFilter: FilterFn, onReset: ResetFn, gridId?: string, t?: FilterSelectT);
     /**
      * 컬럼의 옵션 목록을 계산한다.
      *

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

@@ -9,16 +9,22 @@ export interface FindBarDeps<T extends Record<string, any>> {
     getVs: () => VirtualScroll | null;
     getPagination: () => Pagination | null;
     doRender: () => void;
+    /** i18n: 메시지 해석(라벨/placeholder/aria/카운트 배지). / i18n: resolve labels/placeholder/aria/count badge. */
+    t: (key: string, params?: Record<string, string | number>) => string;
 }
 export declare class FindBarManager<T extends Record<string, any> = any> {
     private _bar;
     private _input;
     private _count;
+    private _lbl;
+    private _close;
     private _filter;
     private _d;
     constructor(deps: FindBarDeps<T>);
     get findFilter(): string;
     init(container: HTMLElement): void;
+    /** i18n: 상주 크롬 라벨을 활성 로케일로 다시 그린다(setLocale 경로). / i18n: repaint resident chrome labels in the active locale (setLocale path). */
+    refreshLabels(): void;
     open(): void;
     close(): void;
     private _apply;

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

@@ -30,6 +30,8 @@ export interface FormulaControllerDeps<T extends Record<string, any> = any> {
     emit: (event: string, payload?: any) => void;
     /** aria-live announce(C8.1 공용 인프라). */
     announce: (msg: string) => void;
+    /** i18n: 수식 오류 announce/셀 라벨 해석(formulaError.* 통합 키). / i18n: resolve formula error announce/labels. */
+    t: (key: string, params?: Record<string, string | number>) => string;
     /** 현재 가시 범위 렌더(this._doRender(...this._visRange())). afterRecalc 가 !skipRender 시 유발. */
     doRenderWindow: () => void;
 }

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

@@ -16,6 +16,7 @@ import { GroupTreeManager } from './GroupTreeManager.js';
 import { DetailManager } from './DetailManager.js';
 import { ChartManager } from './ChartManager.js';
 import { OverrideKernel } from './OverrideKernel.js';
+import { LocaleRegistry } from './i18n/LocaleRegistry.js';
 import { GridRenderer } from './GridRenderer.js';
 import { VirtualScroll } from './VirtualScroll.js';
 import { Pagination } from './Pagination.js';
@@ -50,6 +51,8 @@ export interface ComposerHost<T extends Record<string, any> = any> {
     _detailMgr: DetailManager<T>;
     _chartMgr: ChartManager;
     _ovk: OverrideKernel;
+    /** i18n: per-instance 로케일 오버라이드 child(전역 localeRegistry 의 child). 미지정 시 null → 전역 직행. */
+    _locales: LocaleRegistry | null;
     _renderer: GridRenderer | null;
     _vs: VirtualScroll | null;
     _pagination: Pagination | null;
@@ -60,6 +63,8 @@ export interface ComposerHost<T extends Record<string, any> = any> {
     on(event: string, cb: (...args: any[]) => void): any;
     off(event: string, cb: (...args: any[]) => void): any;
     _announce(msg: string): void;
+    /** i18n: 메시지 해석(인스턴스 오버라이드 우선 → 활성 로케일 → ko → 키). / i18n: resolve a message. */
+    t(key: string, params?: Record<string, string | number>): string;
     _doRender(startIndex: number, endIndex: number): void;
     _visRange(): [number, number];
     _renderHeader(): void;

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

@@ -61,6 +61,7 @@ export interface RendererCallbacks {
         error: string | null;
         approx: boolean;
     } | null;
+    t?: (key: string, params?: Record<string, string | number>) => string;
 }
 /**
  * F2(11_design_F2_v2.md §4/§5, C6/C10): renderBody 가 detail head/filler 분기·expander 셀을
@@ -92,6 +93,8 @@ export declare class GridRenderer {
     private _ap;
     private _cellMap;
     get bodyWrapper(): HTMLElement;
+    /** i18n: 렌더 로케일 해석기 — cbs.t(인스턴스 로케일) 우선, 미주입 시 전역 t. / i18n: cbs.t (instance locale) first, global t otherwise. */
+    private _t;
     constructor(root: HTMLElement, opts: RenderOptions, cbs: RendererCallbacks, appearance?: AppearanceResolver);
     updateSize(totalHeight: number, headerHeight: number): void;
     /** 현재 렌더된 헤더 영역의 실제 높이(px). 헤더 줄바꿈으로 늘어난 높이를 레이아웃에 반영할 때 사용. */

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

@@ -24,6 +24,8 @@ export interface KeyboardDeps<T extends Record<string, any>> {
     handleRowDrop: (from: number, to: number) => void;
     doRender: () => void;
     announce: (msg: string) => void;
+    /** i18n: 행 이동 announce 해석. / i18n: resolve row-move announce. */
+    t: (key: string, params?: Record<string, string | number>) => string;
     emit: (event: string, ...args: any[]) => void;
     visRange: () => [number, number];
     handleCellKeyEvt: (eventName: 'cellKeyDown' | 'cellKeyUp' | 'cellKeyPress', e: KeyboardEvent) => void;

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

@@ -66,6 +66,8 @@ export interface MutationServiceDeps<T extends Record<string, any> = any> {
     emit: (event: string, payload?: any) => void;
     /** aria-live announce (C8.1 공용 인프라). */
     announce: (msg: string) => void;
+    /** i18n: 데이터 로드/스킵 announce 해석. / i18n: resolve data load/skip announces. */
+    t: (key: string, params?: Record<string, string | number>) => string;
     /** sort/filter 재적용(setData). */
     applyFilters: () => void;
     /** writeCell/endBatch 커밋 emit 직전 수식 dirty seed 소비. */