open-grid 1.0.8 → 1.1.1

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

@@ -11,6 +11,19 @@ export interface GroupTreeDeps<T extends Record<string, any>> {
     doRender: () => void;
     /** Phase 2: OverrideKernel.getStrategy 주입(슬롯 groupKeyFn 도달용). */
     getStrategy?: <F extends Function>(slot: string, fallback: F) => F;
+    /**
+     * Phase 0(C0.3): FlatRowModel 의 baseline backing 등록점. group/tree 진입 시 자기
+     * flat 배열(`_groupFlatRows`/`_treeFlatRows`)로 교체하고, 해제 시 null(plain 복귀)로 되돌린다.
+     */
+    setFlatBacking: (provider: (() => Array<any>) | null) => void;
+    /**
+     * F2(11_design_F2_v2.md §3.2 R3 "flat 소유 경합" 해소): setFlatBacking 직후 이 값을 조회해
+     * VirtualScroll.setTotalRows/doRenderFull 에 넘긴다. FlatRowModel.count() 는 방금 교체한
+     * backing 위에 DetailManager 가 등록한 detail splice 까지 합성한 "최종" 총 행수이므로,
+     * GroupTreeManager 는 자기 배열 길이(`_groupFlatRows.length` 등)를 직접 쓰지 않는다
+     * (detail 활성 시 그 값은 실제보다 작아 스크롤/렌더 범위가 잘린다).
+     */
+    getFlatCount: () => number;
 }
 export declare class GroupTreeManager<T extends Record<string, any> = any> {
     private _groupFields;

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

@@ -0,0 +1,55 @@
+/** render() 옵션. size 미지정 시 svg 는 viewBox/CSS 로 크기를 상속(width/height 속성 생략). */
+export interface IconRenderOptions {
+    /** px 정사각 크기(width=height). 미지정 시 속성 생략(CSS/컨테이너가 결정). */
+    size?: number;
+    /** 접근성 제목. 지정 시 <title> + role="img" 추가(스크린리더). 미지정 시 장식용(부모가 aria 담당). */
+    title?: string;
+    /** true → SVGElement(DOMParser) 반환. 기본 false → SVG 마크업 문자열. */
+    el?: boolean;
+}
+/**
+ * 시맨틱 ROLE → 아이콘 key(`BOOTSTRAP_ICONS` 의 symbolId) 기본 매핑.
+ * 렌더 코드는 이 역할 이름만 참조한다. key 교체는 이 표(혹은 register/setIcon)만 고치면 된다.
+ * 참고 스왑: `row.delete`→`trash3`(Bootstrap 의 표준 휴지통, task 의 'trash' 동족), `chart.line`→`graph-up`.
+ */
+export declare const DEFAULT_ICON_ROLES: Readonly<Record<string, string>>;
+/**
+ * IconRegistry — role → 글리프 본문(inner SVG markup) 해석 + svg 래핑.
+ *
+ * 저장 단위는 **글리프 본문 문자열**(<path>/<g> 마크업). register(role, svgOrKey) 는
+ *   - svgOrKey 가 `BOOTSTRAP_ICONS` 의 알려진 key 면 그 본문으로,
+ *   - 아니면 **원시 SVG 본문**(사용자 커스텀 <path…>)으로 저장한다.
+ * 부모 체인(_parent)으로 per-instance 오버라이드 레지스트리를 전역 위에 얹는다(멀티그리드 격리).
+ */
+export declare class IconRegistry {
+    private _roles;
+    private _parent;
+    constructor(seed?: Readonly<Record<string, string>>, parent?: IconRegistry);
+    /**
+     * role 에 글리프를 등록/교체. svgOrKey 가 알려진 아이콘 key 면 그 본문을, 아니면 원시 SVG
+     * 본문 마크업으로 간주한다(코어 편집 없이 아이콘 교체 — OCP).
+     */
+    register(role: string, svgOrKey: string): this;
+    /** role 이 (자신 또는 부모 체인에) 등록돼 있는가. */
+    has(role: string): boolean;
+    /** role → 글리프 본문(inner markup). 미등록이면 null(부모 체인까지 조회). */
+    resolveBody(role: string): string | null;
+    /** 이 레지스트리를 부모로 하는 자식(per-instance 오버라이드용) 생성. */
+    child(): IconRegistry;
+    /**
+     * role 을 `<svg viewBox=ICON_VIEWBOX>` 로 렌더. 기본 반환은 SVG 마크업 문자열(innerHTML 용);
+     * opts.el 이면 SVGElement. 미지원 role 은 빈 svg 폴백(never throw).
+     * 스킨 토큰: fill=currentColor(presentation attr) + stroke-linejoin=var(--og-icon-corner,miter).
+     */
+    render(role: string, opts?: IconRenderOptions): string | SVGElement;
+    /** 등록된 role 목록(자신만, 디버깅/테스트용). */
+    roles(): string[];
+}
+/**
+ * 프로세스 공유 기본 아이콘 레지스트리(시맨틱 role 시드 완료).
+ * CellRenderer 등 팩토리 생성 렌더러(인스턴스 컨텍스트 없음)가 이 초크포인트로 아이콘을 얻는다.
+ * per-instance 교체는 `grid.setIcon()`(이 레지스트리의 child) 로, 전역 확장은 `defineIconSet()` 로.
+ */
+export declare const iconRegistry: IconRegistry;
+/** 편의 정적 render — 공유 기본 레지스트리로 위임(`IconRegistry.render(role, opts)`). */
+export declare function renderIcon(role: string, opts?: IconRenderOptions): string | SVGElement;

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

@@ -2,6 +2,18 @@ import { DataLayer } from './DataLayer.js';
 import { ColumnLayout } from './ColumnLayout.js';
 import { CellEditManager } from './CellEditManager.js';
 import { RowManager } from './RowManager.js';
+/** F1 범위 선택 배선 훅(M-3/M-4/M-5) — RangeSelectionManager 가 그대로 구현한다. */
+export interface RangeKeyboardHooks {
+    isEnabled(): boolean;
+    hasSelection(): boolean;
+    extendFocus(dir: 'up' | 'down' | 'left' | 'right'): void;
+    ctrlFill(axis: 'down' | 'right'): void;
+    clear(): void;
+    /** 범위 없으면 null(호출측이 기존 focusCell/selectedRows 경로로 폴백) */
+    copyText(): string | null;
+    /** true = 배치 경유로 처리함, false = 범위 없음(폴백) */
+    pasteText(text: string): boolean;
+}
 export interface KeyboardDeps<T extends Record<string, any>> {
     getEditMgr: () => CellEditManager<T>;
     getRowMgr: () => RowManager<T>;
@@ -15,6 +27,13 @@ export interface KeyboardDeps<T extends Record<string, any>> {
     emit: (event: string, ...args: any[]) => void;
     visRange: () => [number, number];
     handleCellKeyEvt: (eventName: 'cellKeyDown' | 'cellKeyUp' | 'cellKeyPress', e: KeyboardEvent) => void;
+    /** M-4: 붙여넣기 쓰기 퍼널을 writeCell(배치)로 교체(CON-2, 의도적 동작 변경) */
+    writeCells?: (patches: Array<{
+        rowIndex: number;
+        field: string;
+        value: any;
+    }>) => number;
+    getRangeHooks?: () => RangeKeyboardHooks | null;
 }
 export declare class KeyboardManager<T extends Record<string, any> = any> {
     private _d;

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

@@ -0,0 +1,126 @@
+import { DataLayer } from './DataLayer.js';
+import { FlatRowModel } from './FlatRowModel.js';
+import { VirtualScroll } from './VirtualScroll.js';
+import { Pagination } from './Pagination.js';
+import { ColumnLayout } from './ColumnLayout.js';
+import { RowManager } from './RowManager.js';
+import { GroupTreeManager } from './GroupTreeManager.js';
+import { TriggerManager } from './TriggerManager.js';
+import { GridOptions, Position } from './types.js';
+/**
+ * R4(§3.4, R-9a/R-9b): 모든 데이터 변경의 mutate→render→emit 꼬리를 단일 초크포인트
+ * `commit(spec)` 로 수렴시키기 위한 명시 데이터계약(CommitSpec DTO). 각 mutator 의
+ * **관측 가능한 발화 순서 차이는 정규화 대상이 아니라 이 필드들로 인코딩**한다
+ * (R-9c 회귀0: R0 골든 `mutation-event-sequence.test.ts` 순서 보존).
+ *
+ * - `totals`  : VS/Pagination 행수 갱신. 'count'=현재 행수(insert/delete/push/unshift),
+ *               'zero'=0(clearData). 생략=미갱신(writeCell/setData — 행수 불변 or 인라인 처리).
+ * - `renderMode` : 'sync-window'=`_doRender(...visRange)`(insert/delete/write/endBatch),
+ *               'full'=`_doRender(0,-1)`(clearData),
+ *               'async-vs'=명령형 렌더 없음. setData 는 setTotalRows/rebuild 로 VS 가
+ *               rAF 스케줄(비동기)하므로 `commit` 은 동기 `_doRender` 를 **하지 않는다**.
+ * - `emitBeforeRender` : true=emit 을 render 앞에(writeCell/endBatch — 현행 순서), 기본 false=render 먼저(insert/delete).
+ * - `emitPayload` : `emit('dataChange', …)` 페이로드 지연 평가(thunk). getData() 시점을
+ *               현행과 동일(render 뒤 or 앞)하게 유지 + 명시 onDataChange 재호출 시 2회 평가 보존.
+ * - `fireOnDataChangeExplicitly` : true=`_options.onDataChange?.()` 를 **명시 재호출**(bound listener 와 합쳐 DOUBLE-fire).
+ *               row mutator=true, setData/clearData=false(bound listener 로 ONCE).
+ * - `flushFormula` : true=emit 전에 `_flushFormulaRecalc()`(writeCell/endBatch).
+ * - `preRender` : render 직전 훅(deleteRow 의 removedRowId invalidate 루프).
+ * - `coalescable` : true 인 커밋만 배치 개구 중 render/emit 을 no-op 하고 `_batchDirty` 를 세운다.
+ *               **writeCell 만 원래 배치를 감지**했으므로 나머지 mutator(coalescable 생략)는
+ *               배치 안에서도 즉시 렌더(현행 보존 — 배치 게이트를 전 mutator 로 확대하지 않는다).
+ */
+export interface CommitSpec {
+    totals?: 'count' | 'zero';
+    renderMode: 'sync-window' | 'full' | 'async-vs';
+    emitBeforeRender?: boolean;
+    emitPayload: () => any;
+    fireOnDataChangeExplicitly?: boolean;
+    flushFormula?: boolean;
+    preRender?: () => void;
+    coalescable?: boolean;
+}
+/**
+ * R6(§3.1 C5, §6-R6): 데이터 변경 표면(setData/insert/push/delete/writeCell/writeCells + 배치 API)
+ * 와 R4 가 도입한 단일 커밋 초크포인트 `commit(CommitSpec)` 를 `OpenGrid` God object 에서
+ * **동작 불변**으로 옮긴 것. `OpenGrid` 는 얇은 위임 공개 메서드만 남긴다(공개 API 불변).
+ *
+ * 스트랭글러 원칙(A2): DataLayer 는 여전히 `OpenGrid` 가 소유하며, 여기에는 `*Deps`
+ * 클로저 역전 패턴으로 **주입**만 된다. **서비스는 렌더를 직접 모른다**(Yourdon I/O 분리):
+ * render 는 주입된 `doRenderWindow`/`doRenderFull` 콜백으로만 유발한다. 값(vs/pagination/recalc
+ * 등)은 늦은-null / 재할당(worksheet 전환)을 견디도록 전부 getter 클로저로 읽는다.
+ * 배치 코얼레싱(`_batchDepth`/`_batchDirty`) 시맨틱은 R4 와 1:1 동일하다(회귀 0).
+ */
+export interface MutationServiceDeps<T extends Record<string, any> = any> {
+    getData: () => DataLayer<T>;
+    getVs: () => VirtualScroll | null;
+    getPagination: () => Pagination | null;
+    getFlatModel: () => FlatRowModel;
+    getColLayout: () => ColumnLayout<T>;
+    getContainer: () => HTMLElement;
+    getTrigMgr: () => TriggerManager;
+    getRowMgr: () => RowManager<T>;
+    getGrpMgr: () => GroupTreeManager<T>;
+    getOptions: () => Required<GridOptions<T>>;
+    /** EventEmitter fan (this.emit) — 'dataChange'/'editEnd'/'writeCellsSkip'. */
+    emit: (event: string, payload?: any) => void;
+    /** aria-live announce (C8.1 공용 인프라). */
+    announce: (msg: string) => void;
+    /** sort/filter 재적용(setData). */
+    applyFilters: () => void;
+    /** writeCell/endBatch 커밋 emit 직전 수식 dirty seed 소비. */
+    flushFormula: () => void;
+    /** 현재 가시 범위 렌더(this._doRender(...this._visRange())). 서비스는 렌더 내부를 모른다. */
+    doRenderWindow: () => void;
+    /** 전체 렌더(this._doRender(0, -1)) — clearData full 모드. */
+    doRenderFull: () => void;
+    /** setData: 수식 dirty seed clear + RecalcCoordinator 재생성(rowId 재발급 대응). */
+    resetFormulaState: () => void;
+    /** writeCell: 값이 바뀐 셀을 수식 dirty seed 로 적립(kind==='data' 일 때만). */
+    seedFormulaDirty: (rowIndex: number, field: string) => void;
+    /** deleteRow: 제거된 rowId 를 deps 로 갖는 수식들을 #REF 로 무효화(preRender). */
+    invalidateRemovedRows: (rowIds: string[]) => void;
+    /** deleteRow: 제거 전 flat index 의 안정 rowId 확보. */
+    getRowIdAt: (rowIndex: number) => string | undefined;
+}
+export declare class MutationService<T extends Record<string, any> = any> {
+    private _deps;
+    /** reentrant 카운터. 0 초과면 배치 중(writeCell 이 render/dataChange 를 지연). */
+    private _batchDepth;
+    /** 배치 구간 중 실제 쓰기가 1건이라도 있었는지(빈 배치는 endBatch 에서 아무 것도 안 함). */
+    private _batchDirty;
+    constructor(deps: MutationServiceDeps<T>);
+    /**
+     * R4(§3.4, R-9a): 단일 커밋 초크포인트. mutate 완료 후의 totals→(preRender)→flush→render/emit
+     * 꼬리를 여기로 수렴. **관측 순서는 spec 필드로 인코딩**(정규화 아님 — R0 골든 diff=0).
+     * 배치 코얼레싱을 내재화: `coalescable` 커밋은 배치 개구 중 render/emit 을 지연하고
+     * `_batchDirty` 만 세운다(가장 바깥 endBatch 에서 1회 flush).
+     */
+    commit(spec: CommitSpec): void;
+    setData(data: T[]): void;
+    insertRow(item: Partial<T>, position?: Position): void;
+    pushRow(items: Partial<T> | Partial<T>[]): void;
+    deleteRow(rowIndex: number | number[]): void;
+    writeCell(rowIndex: number, field: string, value: any): void;
+    /**
+     * 배치 쓰기 시작(C2.1). 이후 writeCell 호출들은 render/dataChange 를 지연·coalesce 한다.
+     * 중첩 호출은 카운팅(reentrant) — 가장 바깥 endBatch 에서만 실제로 flush 된다.
+     */
+    beginBatch(): void;
+    /**
+     * 배치 종료(C2.1). 카운터가 0 이 되는 시점에 한해 배치 중 발생한 쓰기가 있으면
+     * _doRender 1회 + dataChange 1회를 발생시킨다(둘 다 0회 또는 1회 — 폭주 차단).
+     */
+    endBatch(): void;
+    /**
+     * beginBatch+루프+endBatch 래퍼(C2.1). patches 의 rowIndex 는 flat index — 대상이
+     * FlatRowModel.resolveFlatRow 로 해소해 kind!=='data' (group/tree/detail 의사행)이면
+     * 쓰기 전에 skip 한다(C0.3 쓰기 안전, filler 에 writeCell 절대 금지).
+     * 건너뛴 셀 수를 반환하고, 1건이라도 있으면 announce + 'writeCellsSkip' 이벤트로 표면화한다.
+     */
+    writeCells(patches: Array<{
+        rowIndex: number;
+        field: string;
+        value: any;
+    }>): number;
+}

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

@@ -1,8 +1,15 @@
 import { EventEmitter } from './EventEmitter.js';
+import { SkinTokenDelta, GridOptions, OpenGridInstance, ColumnDef, SortItem, FilterItem, ExportOptions, Position, TriggerHandler, TriggerEvent, OverrideApi, OverrideCallOptions, CellRange, RangeStats } from './types.js';
 import { FilterSelectConfig } from './FilterSelect.js';
 import { MergeCell } from './MergeEngine.js';
+import { RendererFactory } from './renderers/CellRenderer.js';
+import { EditorFactory } from './editors/CellEditor.js';
+import { FlatRowModel } from './FlatRowModel.js';
+import { ChartInstance } from './ChartManager.js';
+import { ChartConfig } from './chart/types.js';
 import { OverrideLayer } from './OverrideKernel.js';
-import { GridOptions, OpenGridInstance, ColumnDef, SortItem, FilterItem, ExportOptions, Position, TriggerHandler, TriggerEvent, OverrideApi, OverrideCallOptions } from './types.js';
+import { ExtensionPointRegistry } from './ExtensionPointRegistry.js';
+import { FormulaErrorCode } from './formula/types.js';
 export declare class OpenGrid<T extends Record<string, any> = any> extends EventEmitter implements OpenGridInstance<T> {
     private _container;
     private _options;
@@ -11,12 +18,22 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     private _vs;
     private _ro;
     private _renderer;
+    private _appearance;
+    /** R12c: per-instance 아이콘 오버라이드 레지스트리(전역 iconRegistry 의 child). 첫 setIcon 때 지연 생성. */
+    private _icons;
     private _sfMgr;
     private _rowMgr;
     private _editMgr;
     private _trigMgr;
     private _destroyed;
-    private _autoHeightWarned;
+    /** R5(§3.1 C4): 렌더 루프 컨트롤러. `_mount` 에서 renderer/vs 배선 초입에 생성. */
+    private _render;
+    /** R6(§3.1 C5): 데이터 변경 서비스(setData/insert/push/delete/writeCell/writeCells + batch + commit). */
+    private _mutation;
+    /** R7(§3.1 C9): F3 수식 컨트롤러(accessor 조립·recalc flush·에러 표현 + 공개 수식 API). */
+    private _formula;
+    /** R7(§3.1 C8): 크로스그리드 컨트롤러(moveRowsTo/매핑/3단계 드롭 발화). */
+    private _cross;
     private _colWidths;
     /** 사용자가 헤더 드래그로 직접 조절한 컬럼 폭 (field 기준). _recalcWidths 가 덮어쓰지 않도록 보존 */
     private _userWidths;
@@ -36,9 +53,25 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     private _findMgr;
     private _grpMgr;
     private _cellEvt;
+    /** F1: 범위 선택 + 채우기 핸들 배선 관리자(11_design_F1_v2.md). */
+    private _rangeMgr;
+    /** F2: 마스터/디테일 배선(11_design_F2_v2.md). 헤드리스 코어(core/detail/*)를 소비. */
+    private _detailMgr;
+    /** F4: 그리드 데이터 통합 차트 오케스트레이터(11_design_F4_v2.md). 헤드리스 chart/* 소비. */
+    private _chartMgr;
+    /** Phase 0(C0.3): flat/visual index ↔ data 리졸버. 어떤 기능도 켜지지 않아도 항상 존재. */
+    private _flatModel;
+    /** F3: 셀 수식 헤드리스 오케스트레이터(core/formula/* 소비, 재구현 아님). 항상 존재(헤드리스라 유휴 비용 0). */
+    private _recalc;
+    /** F3(C2): writeCell 단건 쓰기가 쌓아두는 dirty seed. endBatch/즉시 flush 시 onValuesChanged 1회로 소비. */
+    private _formulaDirtySeeds;
     private _ovk;
     /** 공개 override API (호출가능 + .strategy). 생성자 말미에 부착. */
     override: OverrideApi<T>;
+    /** R11(§3.1 C7): 커널 위 타입드 확장점 레지스트리. _mount 초입에 생성(커널 준비 후). */
+    private _extensions;
+    /** R11: 타입드 확장점 레지스트리 정면(렌더훅 등록·strategy/override 타입드 카탈로그·MutationHook·catalog). */
+    get extensions(): ExtensionPointRegistry<T>;
     /** 정적 전역 override 레이어 (모든 신규 인스턴스에 생성자 말미 적용). */
     private static _defaultOverrides;
     /** 정적 전역 strategy 슬롯. */
@@ -49,6 +82,31 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     static defaults: {
         strategy(slot: string, fn: Function): typeof OpenGrid;
     };
+    /**
+     * 커스텀 셀 렌더러 타입을 코어 편집 없이 등록. `col.type`/`col.renderer`(문자열 또는 `{type}`)가
+     * `typeName` 과 일치하면 등록 팩토리가 렌더러를 생성한다. 프로세스 전역(모든 그리드 인스턴스 공유).
+     */
+    static registerRenderer(typeName: string, factory: RendererFactory): typeof OpenGrid;
+    /** 커스텀 셀 에디터 타입을 코어 편집 없이 등록(OCP). 프로세스 전역. */
+    static registerEditor(typeName: string, factory: EditorFactory): typeof OpenGrid;
+    /**
+     * R12b(item3 §6.2): 커스텀 스킨을 코어 편집 없이 등록(defaultOverride 와 동형의 전역 정책).
+     * FORM-only 검증(색 리터럴 거부 = 색⊥형태 직교성) + HANMS 접근성 가드레일(포커스 <2px/none 클램프)
+     * 적용 후, 런타임 `<style>` 로 `.og-container[data-og-skin="name"]` 블록을 주입한다. 이후 어떤
+     * 인스턴스도 `grid.setSkin(name)` 으로 사용. 색값이 델타에 있으면 **throw**.
+     *
+     * 예) Neumorph 는 기본 카탈로그에서 컷(HANMS §1.3)됐으나 여기서 레시피로 재현 가능:
+     *   OpenGrid.defineSkin('neumorph', { '--og-radius-md':'14px', '--og-elevation-inset':'inset -4px -4px 8px', … })
+     */
+    static defineSkin(name: string, delta: SkinTokenDelta): typeof OpenGrid;
+    /**
+     * R12c(item3 §5.1, 계약 C13): 시맨틱 아이콘 role 세트를 코어 편집 없이 **전역** 등록/교체
+     * (defineSkin/registerRenderer 와 동형의 프로세스 전역 정책). 값은 알려진 아이콘 key(`BOOTSTRAP_ICONS`)
+     * 이거나 원시 SVG 본문 마크업. 이후 모든 인스턴스의 아이콘 해석에 반영된다. per-instance 교체는
+     * `grid.setIcon(role, svg)` 참조.
+     *   예) OpenGrid.defineIconSet({ 'sort.asc': 'arrow-up', 'row.delete': '<path d="…"/>' })
+     */
+    static defineIconSet(map: Record<string, string>): typeof OpenGrid;
     constructor(container: string | HTMLElement, options: GridOptions<T>);
     restore(name: string): this;
     restoreAll(): this;
@@ -78,19 +136,15 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     getWorksheet(name: string): import('./types').WorksheetState<T> | undefined;
     getWorksheetNames(): string[];
     exportSheetsExcel(filename?: string): void;
-    private _paginationHeight;
     private _onResize;
     private _recalcWidths;
     private _renderHeader;
-    /**
-     * 렌더된 헤더의 실제 높이를 측정해 본문(bodyWrap) 높이와 뷰포트 높이에 반영한다.
-     * 줄바꿈이 없는 헤더는 측정 높이가 headerHeight 이하라 기존 고정 동작과 동일하다.
-     */
     private _syncHeaderLayout;
     private _doRender;
+    /** F2(§4.5/§6.1): masterDetail.enabled 아니면 undefined(GridRenderer 는 기존 경로 그대로). */
+    private _buildDetailRenderContext;
     private _handleGroupToggle;
     private _visRange;
-    private _visCount;
     private _handleSortClick;
     private _isToggleCol;
     private _handleCellClick;
@@ -109,27 +163,13 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     _crossBodyEl(): HTMLElement;
     /** fromIndex 를 잡고 드래그할 때 함께 이동할 행 집합 (다중선택에 포함되면 선택 전체) */
     private _dragRowSet;
-    /** 드래그 드롭 어댑터 → 공개 moveRowsTo 로 위임 */
-    private _handleCrossGridDrop;
     /**
      * 이 그리드의 행들을 다른 그리드로 이동(move)한다. 드래그·화살표 셔틀 공통 경로.
      * 3단계 이벤트(before→after→complete)와 crossGridMapping(필드 매핑)을 적용한다.
-     * @param targetGrid  대상 그리드
-     * @param sourceIndexes 이동할 (표시)행 인덱스들
-     * @param targetIndex 대상에서 삽입 위치 (생략 시 맨 끝에 추가)
-     * @returns 이동 성공 true, 취소/무효 false
      */
     moveRowsTo(target: OpenGridInstance<T>, sourceIndexes: number[], targetIndex?: number): Promise<boolean>;
     /** 체크된 행을 다른 그리드로 이동 (화살표 셔틀용). 체크 없으면 무시. */
     moveCheckedTo(target: OpenGridInstance<T>): Promise<boolean>;
-    /**
-     * 크로스그리드 이동의 행 변환 함수를 결정한다.
-     * 반환: null=변환 불필요(그대로) / 함수=변환 적용 / false=매핑 모달 취소(이동 중단)
-     */
-    private _resolveCrossTransform;
-    private _fireGridDropBefore;
-    private _fireGridDropAfter;
-    private _fireGridDropComplete;
     /** 행을 드롭으로 이동할 때 실행된다 */
     /** ???꾩튂 ?대룞 */
     reorderRow(fromIndex: number, toIndex: number): void;
@@ -152,11 +192,57 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     /** @deprecated 하위호환 alias → unshiftRow */
     prependRows(items: Partial<T> | Partial<T>[]): void;
     deleteRow(rowIndex: number | number[]): void;
+    /**
+     * @deprecated no-op stub — id 기반 삭제는 미구현(본문 없음). 인덱스로 지우려면 `deleteRow(rowIndex)`
+     *   를, id→인덱스 변환은 `getFlatRowModel()`/`getData()` 조회 후 `deleteRow` 를 사용.
+     */
     deleteById(_ids: string[]): void;
     readCell(rowIndex: number, field: string): any;
     getDisplayValue(rowIndex: number, field: string): string;
     writeCell(rowIndex: number, field: string, value: any): void;
     getRowAt(rowIndex: number): T;
+    /** flat/visual index ↔ data 리졸버(C0.3). F1/F3/F4 는 이 모델만 경유해야 한다. */
+    getFlatRowModel(): FlatRowModel;
+    beginBatch(): void;
+    endBatch(): void;
+    setCellFormula(rowIndex: number, field: string, formula: string): void;
+    getCellFormula(rowIndex: number, field: string): string | null;
+    hasCellFormula(rowIndex: number, field: string): boolean;
+    clearCellFormula(rowIndex: number, field: string): void;
+    getCellError(rowIndex: number, field: string): FormulaErrorCode | null;
+    getDependents(rowIndex: number, field: string): Array<{
+        rowIndex: number;
+        field: string;
+    }>;
+    getPrecedents(rowIndex: number, field: string): Array<{
+        rowIndex: number;
+        field: string;
+    }>;
+    recalculate(): void;
+    recalculateCell(rowIndex: number, field: string): void;
+    /** C3(F1 fill 전용): srcRowId/srcField 수식의 상대축만 dRow/dCol 오프셋한 새 수식 원문. */
+    offsetFormula(srcRowId: string, srcField: string, dRow: number, dCol: number): string;
+    /**
+     * beginBatch+루프+endBatch 래퍼(C2.1). patches 의 rowIndex 는 flat index — 대상이
+     * FlatRowModel.resolveFlatRow 로 해소해 kind!=='data' (group/tree/detail 의사행)이면
+     * 쓰기 전에 skip 한다(C0.3 쓰기 안전, filler 에 writeCell 절대 금지).
+     * 건너뛴 셀 수를 반환하고, 1건이라도 있으면 announce + 'writeCellsSkip' 이벤트로 표면화한다.
+     */
+    writeCells(patches: Array<{
+        rowIndex: number;
+        field: string;
+        value: any;
+    }>): number;
+    getRangeSelection(): CellRange[];
+    getActiveRange(): CellRange | null;
+    setRangeSelection(range: CellRange | CellRange[]): void;
+    clearRangeSelection(): void;
+    getRangeValues(): any[][];
+    getRangeStats(): RangeStats | null;
+    fillRange(source: CellRange, target: CellRange, mode?: 'copy' | 'series'): void;
+    createChart(config: ChartConfig): ChartInstance;
+    getCharts(): ChartInstance[];
+    destroyCharts(): void;
     getChanges(): {
         added: T[];
         edited: T[];
@@ -177,8 +263,12 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     getRemovedRows(): T[];
     getOriginalRow(rowIndex: number): T | undefined;
     getRowsWithState(stateField: string): T[];
+    /** @deprecated no-op stub — undo/redo 히스토리는 미구현. 변이 가드는 TriggerManager `before:*` 훅,
+     *   변경 추적은 `getChanges()`/`getOriginalRow()` 를 사용. */
     undo(): void;
+    /** @deprecated no-op stub — undo/redo 히스토리 미구현(위 `undo()` 참조). */
     redo(): void;
+    /** @deprecated no-op stub — undo/redo 히스토리 자체가 없어 비울 것도 없음(위 `undo()` 참조). */
     clearHistory(): void;
     getColumnDefs(): ColumnDef<T>[];
     getAllColumnDefs(): ColumnDef<T>[];
@@ -193,7 +283,10 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     getFieldAt(idx: number): string;
     getColValues(field: string, _all?: boolean): any[];
     getUniqueValues(field: string, all?: boolean): any[];
+    /** @deprecated no-op stub — 컬럼 폭 일괄 설정 미구현. 폭은 `ColumnDef.width` 또는 헤더 드래그로
+     *   지정하며 내부 `_recalcWidths` 가 자동 배분한다. */
     setColWidths(_widths: number[]): void;
+    /** @deprecated no-op stub — 항상 빈 배열 반환(폭 계산 미구현). 자동 배분은 내부 `_recalcWidths` 담당. */
     calcColWidths(_fitToGrid?: boolean): number[];
     getSelections(): T[];
     getActiveRow(): number;
@@ -204,15 +297,20 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
         rowIndex: number;
     }>;
     getAllChecked(): T[];
+    /** @deprecated no-op stub — id 기반 체크 미구현. 값 기준 체크는 `checkByValue(field, values)` 사용. */
     checkById(_ids: string[]): void;
+    /** @deprecated no-op stub — id 기반 체크 추가 미구현(위 `checkById()` 참조). `checkByValue` 사용. */
     addCheckById(_ids: string[]): void;
     checkByValue(field: string, values: any[]): void;
+    /** @deprecated no-op stub — id 기반 체크 해제 미구현. 전체 해제는 `uncheckAll()` 사용. */
     uncheckById(_ids: string[]): void;
     uncheckAll(): void;
     orderBy(fieldOrList: string | SortItem[], dir?: 'asc' | 'desc'): void;
     resetOrder(): void;
     setFilter(field: string, filterItems: FilterItem[]): void;
     resetFilter(field?: string): void;
+    /** F3-R13/MCCONNELL-03(P0): 정렬/필터 후 범위-보유(hasRangeRef) 수식 전부 dirty(§3.5). */
+    private _recalcRangeBearingFormulas;
     getFilterState(): Record<string, FilterItem[]>;
     restoreFilter(state: Record<string, FilterItem[]>): void;
     private _applyFilters;
@@ -224,6 +322,7 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     autoMerge(fields: string[]): void;
     /** 蹂묓빀 ?댁젣 */
     clearMerge(): void;
+    /** @deprecated no-op stub — 행 고정(freeze rows) 미구현. 컬럼 고정만 지원하며 `freeze(n)` 사용. */
     freezeRows(_n: number): void;
     groupBy(fields: string[]): void;
     clearGroup(): void;
@@ -234,6 +333,25 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     expandNodes(ids: any | any[], open?: boolean): void;
     expandAllNodes(): void;
     collapseAllNodes(): void;
+    expandRow(rowRef: number | {
+        id: string;
+    }): void;
+    collapseRow(rowRef: number | {
+        id: string;
+    }): void;
+    toggleRow(rowRef: number | {
+        id: string;
+    }): void;
+    isRowExpanded(rowRef: number | {
+        id: string;
+    }): boolean;
+    collapseAllDetails(): void;
+    getDetailInstance<D = any>(rowRef: number | {
+        id: string;
+    }): D | undefined;
+    resyncPanelWidths(): void;
+    /** @deprecated no-op stub — 부모 지정 트리행 삽입 미구현. 평면 삽입은 `insertRow(item, pos)`,
+     *   트리 구성은 `enableTree()`/`groupBy(fields)` 사용. */
     addTreeRow(_item: Partial<T>, _pid: string, _pos?: Position): void;
     exportExcel(options?: ExportOptions | string): void;
     exportCsv(options?: ExportOptions | string): void;
@@ -244,6 +362,7 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     }): void;
     toArray(keyValue?: boolean): any[];
     jumpToRow(rowIndex: number): void;
+    /** @deprecated no-op stub — 특정 컬럼으로 가로 스크롤 이동 미구현. 행 이동은 `jumpToRow(rowIndex)` 사용. */
     jumpToCol(_field: string): void;
     getScrollPos(): {
         x: number;
@@ -256,6 +375,32 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
     resize(w?: number, h?: number): void;
     setTheme(theme: string): void;
     setThemeVar(k: string, v: string): void;
+    /**
+     * R12b: 스킨(FORM 축) 전환. data-og-skin 설정 + resolver 컨텍스트 교체 + 인라인 form 사이트 재해석.
+     * 색 테마와 직교(색 토큰 무변경). default→named 전환 시 인라인 보더가 리터럴→var() 로 승격되므로
+     * 헤더/본문을 한 번 재렌더한다(opt-in 비용). named→named/…→default 도 동일 경로로 안전.
+     */
+    setSkin(skin: string): void;
+    /** R12b: 현재 스킨 id('default' = 오늘). */
+    getSkin(): string;
+    /**
+     * R12c(계약 C13): 이 그리드 인스턴스에 한해 시맨틱 아이콘 role 을 교체(멀티그리드 격리 —
+     * 전역 iconRegistry 를 부모로 하는 child 에만 기록). svgOrKey 는 알려진 아이콘 key 또는 원시 SVG 본문.
+     * R11 확장점과의 연결: 오버라이드를 `extensions.iconResolver` strategy 슬롯으로도 표면화해 발견가능하게 한다.
+     * 반환은 this(체이닝). 미지정 role/글리프는 안전 폴백(never throw).
+     */
+    setIcon(role: string, svgOrKey: string): this;
+    /** R12c: 이 인스턴스의 아이콘 role 해석(오버라이드 우선, 없으면 전역). 렌더 마크업/SVGElement. */
+    renderIcon(role: string, opts?: {
+        size?: number;
+        title?: string;
+        el?: boolean;
+    }): string | SVGElement;
+    /**
+     * R12b: FORM 축 단일 토큰 런타임 오버라이드(setThemeVar 의 형태-축 형제). 컨테이너 인라인이라
+     * 스타일시트를 항상 이긴다. 색⊥형태 직교성 보호를 위해 색 값은 거부한다.
+     */
+    setSkinVar(k: string, v: string): void;
     addTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
     removeTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
     clearTriggers(event?: TriggerEvent | string): this;

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;