open-grid 1.1.1 → 1.2.1

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/range/RangeQuery.d.ts

@@ -1,16 +1,38 @@
 import { CellRange } from './types.js';
+/** 범위 질의 컨텍스트(그리드 접근 seam). / Range-query context (grid access seam). */
 export interface RangeQueryContext {
+    /** 컬럼 인덱스 → field 명. / Column index → field name. */
     fieldAt(ci: number): string | undefined;
+    /** (행 인덱스, field) 셀 값 조회. / Read the cell value at (row index, field). */
     getCellValue(ri: number, field: string): any;
 }
-/** rect 값 2D 배열(FR-6). */
+/**
+ * rect 범위의 값 2D 배열을 반환(FR-6). / Return the 2D value array for a rect range (FR-6).
+ *
+ * @param rect - 대상 셀 범위 / Target cell range
+ * @param ctx - 범위 질의 컨텍스트 / Range-query context
+ * @returns 행×열 값 2D 배열 / Row×column 2D value array
+ */
 export declare function getRangeValues(rect: CellRange, ctx: RangeQueryContext): any[][];
+/** 범위 통계 결과(OGDecimal 문자열). / Range statistics result (OGDecimal strings). */
 export interface RangeStats {
+    /** 합계. / Sum. */
     sum: string;
+    /** 평균. / Average. */
     avg: string;
+    /** 숫자 셀 개수. / Count of numeric cells. */
     count: number;
+    /** 최솟값. / Minimum. */
     min: string;
+    /** 최댓값. / Maximum. */
     max: string;
 }
-/** 숫자 셀에 대해 OGDecimal 기반 sum/avg/count/min/max(FR-6). 숫자 셀이 없으면 null. */
+/**
+ * 숫자 셀에 대해 OGDecimal 기반 sum/avg/count/min/max(FR-6). 숫자 셀이 없으면 null.
+ * / OGDecimal-based sum/avg/count/min/max over numeric cells (FR-6); null when there are no numeric cells.
+ *
+ * @param rect - 대상 셀 범위 / Target cell range
+ * @param ctx - 범위 질의 컨텍스트 / Range-query context
+ * @returns 통계 결과 또는 null / Statistics result, or null
+ */
 export declare function getRangeStats(rect: CellRange, ctx: RangeQueryContext): RangeStats | null;