open-grid 1.1.0 → 1.2.0

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/icons/bootstrap-icons.d.ts

@@ -0,0 +1,9 @@
+/** 모든 큐레이션 글리프 공통 viewBox(Bootstrap Icons 16px 그리드). */
+export declare const ICON_VIEWBOX = "0 0 16 16";
+/**
+ * symbolId → SVG 내부 마크업(<path>/<g>). Bootstrap Icons v1.13.1(MIT)에서 큐레이션.
+ * `eye-reveal` 는 예외(기존 마스킹 셀 커스텀 글리프, 행동 보존용).
+ */
+export declare const BOOTSTRAP_ICONS: Readonly<Record<string, string>>;
+/** 큐레이션에 포함된 symbol 개수(테스트/디버깅용). `eye-reveal`(커스텀 1) 포함. */
+export declare const BOOTSTRAP_ICON_COUNT: number;

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

@@ -1,4 +1,7 @@
-import { ColumnDef } from '../types.js';
+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,14 +10,29 @@ 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 반환/미설정 시 기본 포맷 폴백.
+     *  ※ getDisplayValue override(text 경로의 ctx.displayValue)와 달리 **전략만** 적용 — 숫자/날짜의
+     *    기본 포맷(천단위·통화·정밀도)을 보존하고 그룹모드 인덱스 불일치를 피한다. */
+    displayFormatter?: ((value: any, field: string, row: any) => string | null) | null;
     /** C7(15_cross_contracts.md/F3-R14): 이 셀에 F3 셀 수식이 있으면 true — ColumnDef.formula 재평가를 skip. */
     hasCellFormula?: boolean;
 }
 export interface CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
-export declare function setDisplayFormatterResolver(resolver: ((value: any, field: string, row: any) => string | null) | null): void;
+/**
+ * R1(OOP 리팩터, DIP 수정): 과거엔 formatNumber/formatDate 가 host 참조가 없어 **모듈 전역**
+ * resolver 로 displayFormatter 슬롯에 도달했다. 그 전역은 매 OpenGrid 생성자가 덮어써,
+ * 한 페이지에 그리드가 여럿이면 마지막 그리드의 포매터가 전 그리드에 새는 P0 정합성 결함이었다.
+ * → 전역을 제거했다. 이제 displayFormatter 는 **per-instance 안전 경로 하나**로만 흐른다:
+ *   OpenGrid.getDisplayValue(슬롯 읽기) → GridRenderer 가 RenderContext.displayValue 로 주입
+ *   → 각 셀 렌더러(Text/Number/Date)가 ctx.displayValue 를 우선 사용.
+ * formatNumber/formatDate 는 전역 상태 0 의 순수 포맷 함수로 환원했다(출력 동일, 회귀 0).
+ */
 /**
  * 컬럼에 formula가 있으면 OGDecimal로 평가해 표시값(string)을 반환.
  * formula가 없으면 null 반환 → 기존 ctx.value 사용.
@@ -62,6 +80,10 @@ export declare class CheckboxRenderer implements CellRenderer {
 export interface ButtonRendererDef {
     type: 'button';
     label?: string | ((value: any, row: any) => string);
+    /** R12c: 라벨과 함께 표시할 아이콘 role/key(renderIcon). 미지정 시 라벨만(기존과 동일). */
+    icon?: string;
+    /** 아이콘 위치(기본 'left'). */
+    iconPos?: 'left' | 'right';
     buttonClass?: string;
     style?: string;
 }
@@ -149,4 +171,23 @@ export declare class HtmlRenderer implements CellRenderer {
 export declare class BarcodeRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
+/**
+ * R10(§6-R10, §2.5 R-4c, §3.1 C11): `createRenderer` 이중 switch 를 `Map<typeName, factory>`
+ * 레지스트리로 대체한다. 내장 타입은 모듈 로드시 부트스트랩 등록(아래 switch 와 동일 매핑),
+ * `createRenderer` 는 레지스트리로 해석하고 미등록 타입은 기존과 동일하게 TextRenderer 로 폴백한다.
+ * `registerRenderer(typeName, factory)` 로 코어 편집 없이 커스텀 렌더러를 추가할 수 있다(OCP).
+ *
+ * 등록은 **프로세스 전역**(내장은 불변에 가깝고, 커스텀 등록은 defaultOverride 와 동형의 전역 정책).
+ * 인스턴스별 스코핑은 R11/R12(ExtensionPointRegistry)의 후속 작업으로 남긴다.
+ *
+ * 팩토리는 `(col, def)` 를 받는다. `def` 는 RendererDef 객체 경로에서만 채워지며(문자열/col.type
+ * 경로에서는 undefined), 원 switch 의 세 컨텍스트(col.type / 문자열 / 객체) 동작을 정확히 보존한다:
+ *  - image/progress/sparkline/rating/template 은 def(설정 객체) 없이는 원래 TextRenderer 로 떨어졌으므로
+ *    def 유무로 게이트한다(문자열 렌더러명만 준 미완성 설정 = 기존과 동일 폴백).
+ */
+export type RendererFactory = (col: ColumnDef, def?: RendererDef) => CellRenderer;
+/** 커스텀 셀 렌더러 타입을 코어 편집 없이 등록(OCP). 프로세스 전역. */
+export declare function registerRenderer(typeName: string, factory: RendererFactory): void;
+/** 등록 여부 조회(내부/테스트용). */
+export declare function hasRenderer(typeName: string): boolean;
 export declare function createRenderer(col: ColumnDef): CellRenderer;