open-grid 1.1.0 → 1.2.0

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

@@ -25,6 +25,8 @@ export declare class OrgChart {
     constructor(selector: string | HTMLElement, opts: OrgChartOptions);
     setData(data: Record<string, any>[]): void;
     setTheme(theme: string): void;
+    /** R12b: FORM(스킨) 축 — data-og-skin 을 자기 컨테이너에 설정(setTheme 과 동형, 색과 직교). */
+    setSkin(skin: string): void;
     expandAll(): void;
     collapseAll(): void;
     private _toggle;

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

@@ -0,0 +1,65 @@
+import { GridRenderer, DetailRenderContext } from './GridRenderer.js';
+import { VirtualScroll } from './VirtualScroll.js';
+import { Pagination } from './Pagination.js';
+import { ColumnLayout } from './ColumnLayout.js';
+import { DataLayer } from './DataLayer.js';
+import { FlatRowModel } from './FlatRowModel.js';
+import { MergeEngine } from './MergeEngine.js';
+import { SortFilterManager } from './SortFilterManager.js';
+import { RowManager } from './RowManager.js';
+import { CellEditManager } from './CellEditManager.js';
+import { GroupTreeManager } from './GroupTreeManager.js';
+import { DetailManager } from './DetailManager.js';
+import { RangeSelectionManager } from './RangeSelectionManager.js';
+import { GridOptions } from './types.js';
+/**
+ * R5(§3.1 C4, §6-R5): 렌더 루프의 유일 진입점. `OpenGrid` God object 에서
+ * `_onResize`/`_recalcWidths`/`_renderHeader`/`_syncHeaderLayout`/`_doRender`/`_visRange`
+ * (+ 전용 헬퍼 `_visCount`/`_paginationHeight`)를 **동작 불변**으로 옮긴 것.
+ *
+ * 스트랭글러 원칙(A2): 협력자(GridRenderer/VirtualScroll/Pagination 등)는 여전히
+ * `OpenGrid._mount` 가 생성·소유하며, 여기에는 `*Deps` 클로저 역전 패턴으로 **주입**만 된다.
+ * 값(컬럼폭·옵션 등)은 늦은-null / 재할당(worksheet 전환 시 colLayout 교체)을 견디도록
+ * 전부 getter 클로저로 읽는다. `fallbackViewportHeight` 클램프 시맨틱과 RenderFrame 구성은
+ * 원본과 1:1 동일하다(회귀 0).
+ */
+export interface RenderControllerDeps<T extends Record<string, any> = any> {
+    getContainer: () => HTMLElement;
+    getOptions: () => Required<GridOptions<T>>;
+    getRenderer: () => GridRenderer | null;
+    getVs: () => VirtualScroll | null;
+    getPagination: () => Pagination | null;
+    getData: () => DataLayer<T>;
+    getColLayout: () => ColumnLayout<T>;
+    getFlatModel: () => FlatRowModel;
+    getMergeEngine: () => MergeEngine;
+    getColWidths: () => number[];
+    setColWidths: (widths: number[]) => void;
+    getUserWidths: () => Map<string, number>;
+    getSfMgr: () => SortFilterManager<T>;
+    getRowMgr: () => RowManager<T>;
+    getEditMgr: () => CellEditManager<T>;
+    getGrpMgr: () => GroupTreeManager<T>;
+    getDetailMgr: () => DetailManager<T>;
+    getRangeMgr: () => RangeSelectionManager<T>;
+    buildDetailRenderContext: () => DetailRenderContext | undefined;
+    renderFooterEl: () => void;
+}
+export declare class RenderController<T extends Record<string, any> = any> {
+    private _deps;
+    private _autoHeightWarned;
+    constructor(deps: RenderControllerDeps<T>);
+    private _paginationHeight;
+    onResize(): void;
+    recalcWidths(totalWidth: number): void;
+    renderHeader(): void;
+    /**
+     * 렌더된 헤더의 실제 높이를 측정해 본문(bodyWrap) 높이와 뷰포트 높이에 반영한다.
+     * 줄바꿈이 없는 헤더는 측정 높이가 headerHeight 이하라 기존 고정 동작과 동일하다.
+     * (public: OpenGrid 가 `_syncHeaderLayout` 위임으로 노출 — 특성화 테스트가 직접 호출한다.)
+     */
+    syncHeaderLayout(): void;
+    doRender(startIndex: number, endIndex: number): void;
+    visRange(): [number, number];
+    private _visCount;
+}

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

@@ -0,0 +1,53 @@
+import { SkinTokenDelta } from './types.js';
+export interface SkinDefineResult {
+    /** 실제 등록된(가드레일 클램프가 반영된) 델타. */
+    readonly delta: SkinTokenDelta;
+    /** 접근성 가드레일이 조정한 토큰 경고(있으면 콘솔에도 출력). */
+    readonly warnings: string[];
+}
+/** 스킨 델타가 색 리터럴을 담고 있는지 검사하고, 위반 시 던진다(FORM-only, Rule 2). */
+export declare function assertFormOnly(id: string, delta: SkinTokenDelta): void;
+/**
+ * HANMS 접근성 가드레일(불변식) 적용 — 정의 시점 클램프(§6.4, HANMS P0-4).
+ *  - focus-width < 2px → 2px 로 클램프(가시 포커스 비협상).
+ *  - focus-style: none → solid.
+ * 반환은 조정된 델타 + 경고 목록(silent override 아님 — 무엇을 클램프했는지 알린다).
+ */
+export declare function applyGuardrails(id: string, delta: SkinTokenDelta): SkinDefineResult;
+/**
+ * 프로세스 전역 스킨 등록소. defineSkin(사용자) 는 검증+가드레일+`<style>` 주입,
+ * registerBuiltin(내장) 은 검증+가드레일만(CSS 는 skins.css 정적 번들 소유).
+ */
+export declare class SkinRegistry {
+    private _skins;
+    private _styleEl;
+    /** 내장 스킨 등록(주입 없음 — CSS 는 skins.css 가 전달). 검증/가드레일은 동일 적용. */
+    registerBuiltin(id: string, delta: SkinTokenDelta): void;
+    /**
+     * 사용자 스킨 등록. FORM-only 검증 + 가드레일 클램프 후 런타임 `<style>` 로
+     * `.og-container[data-og-skin="id"]` 블록을 주입(브라우저 환경). 반환은 조정 결과.
+     */
+    define(id: string, delta: SkinTokenDelta): SkinDefineResult;
+    has(id: string): boolean;
+    get(id: string): SkinTokenDelta | undefined;
+    /** 등록된 모든 스킨 id(내장 + 사용자). */
+    list(): string[];
+    /** 런타임 `<style>` 주입(테스트/SSR 등 document 없으면 no-op). 같은 태그를 누적 사용. */
+    private _inject;
+}
+/** Sharp/Gothic — 엔터프라이즈 고밀도·각짐(§3.1). HANMS: APPROVE-WITH-GUARDRAIL(G-S1). */
+export declare const SKIN_SHARP: SkinTokenDelta;
+/** Rounded — 소비자 SaaS 소프트(§3.2). HANMS: APPROVE. */
+export declare const SKIN_ROUNDED: SkinTokenDelta;
+/** Stitch — 핸드크래프트(§3.3). HANMS: APPROVE-WITH-GUARDRAIL(G-ST1~3). 색(리넨/자수)은 theme 축. */
+export declare const SKIN_STITCH: SkinTokenDelta;
+/** Flat/Minimal — 플랫 2.0(§3.5). HANMS: APPROVE-WITH-GUARDRAIL(G-F1: 플로팅 표면 1px 보더). */
+export declare const SKIN_FLAT: SkinTokenDelta;
+/** High-Contrast — 접근성 우선·레퍼런스(§3.6). HANMS: APPROVE(안전 폴백). */
+export declare const SKIN_HIGH_CONTRAST: SkinTokenDelta;
+/** Material/Elevated — Neumorph 대체(HANMS §3): 중간 반경 + 정직한 그림자 엘리베이션. APPROVE. */
+export declare const SKIN_MATERIAL: SkinTokenDelta;
+/** 내장 스킨 카탈로그(HANMS 확정 6종, Neumorph 제외). id → 델타. */
+export declare const BUILTIN_SKINS: ReadonlyArray<readonly [string, SkinTokenDelta]>;
+/** 프로세스 전역 기본 레지스트리 — 내장 스킨을 부트스트랩 등록(주입 없음, CSS=skins.css). */
+export declare const skinRegistry: SkinRegistry;

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/editors/CellEditor.d.ts

@@ -1,4 +1,4 @@
-import { ColumnDef } from '../types.js';
+import { ColumnDef, EditorDef } from '../types.js';
 import { RenderContext } from '../renderers/CellRenderer.js';
 export { DateEditor } from './DateEditor.js';
 export { SelectEditor } from './SelectEditor.js';
@@ -51,4 +51,20 @@ export declare class CheckboxEditor implements CellEditor {
     focus(): void;
     destroy(): void;
 }
+/**
+ * R10(§6-R10, §2.5 R-4c, §3.1 C12): `createEditor` 삼중 switch 를 `Map<typeName, factory>`
+ * 레지스트리로 대체한다. 내장 타입은 모듈 로드시 부트스트랩 등록, 미등록 타입은 기존과 동일하게
+ * TextEditor 로 폴백한다. `registerEditor(typeName, factory)` 로 코어 편집 없이 커스텀 에디터를
+ * 추가할 수 있다(OCP). 등록은 렌더러와 동일하게 **프로세스 전역**.
+ *
+ * 팩토리는 `(col, def)` 를 받는다. `def`(EditorDef 객체)는 객체 경로에서만 채워지며, 원 switch 의
+ * 세 컨텍스트(col.type / 문자열 / 객체) 동작을 정확히 보존한다:
+ *  - number 는 def 가 있으면 min/max/step 을 옵션으로, 없으면 기본 NumberEditor.
+ *  - select 는 def 가 있으면 def.options, 없으면 col.options 를 쓴다(원 switch 와 동일).
+ */
+export type EditorFactory = (col: ColumnDef, def?: EditorDef) => CellEditor;
+/** 커스텀 셀 에디터 타입을 코어 편집 없이 등록(OCP). 프로세스 전역. */
+export declare function registerEditor(typeName: string, factory: EditorFactory): void;
+/** 등록 여부 조회(내부/테스트용). */
+export declare function hasEditor(typeName: string): boolean;
 export declare function createEditor(col: ColumnDef): CellEditor;

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;