open-grid 1.2.0 → 1.2.1

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

@@ -1,48 +1,100 @@
 import { OGDecimal } from '../OGDecimal.js';
+/** 셀 키 문자열 `${rowId}:${field}`(내부 전용 포맷). / Cell key string `${rowId}:${field}` (internal format). */
 export type CellKey = string;
+/**
+ * rowId·field 로 셀 키를 만든다. / Build a cell key from rowId and field.
+ *
+ * @param rowId - 행 stable id / Row stable id
+ * @param field - 컬럼 field 명 / Column field name
+ * @returns `${rowId}:${field}` 형태의 키 / A `${rowId}:${field}` key
+ */
 export declare function cellKey(rowId: string, field: string): CellKey;
+/**
+ * 셀 키를 rowId·field 로 분해한다. / Split a cell key back into rowId and field.
+ *
+ * @param key - 셀 키 문자열 / Cell key string
+ * @returns { rowId, field }
+ */
 export declare function parseCellKey(key: CellKey): {
     rowId: string;
     field: string;
 };
+/**
+ * 수식 에러 코드. / Formula error code.
+ *
+ * `#ERR`(일반), `#REF`(참조 무효), `#CYCLE`(순환), `#DIV0`(0 나눗셈), `#NAME`(미정의 이름),
+ * `#VALUE`(비수치), `#NUM`(수치 범위).
+ * / `#ERR` (general), `#REF` (invalid ref), `#CYCLE` (cyclic), `#DIV0` (divide by zero),
+ * `#NAME` (undefined name), `#VALUE` (non-numeric), `#NUM` (numeric range).
+ */
 export type FormulaErrorCode = '#ERR' | '#REF' | '#CYCLE' | '#DIV0' | '#NAME' | '#VALUE' | '#NUM';
+/** 전체 에러 코드 집합(런타임 판별용). / Set of all error codes (for runtime checks). */
 export declare const FORMULA_ERROR_CODES: ReadonlySet<string>;
-/** 값이 이미 다른 수식의 에러 결과(문자열)인지 판별 — 에러 전파(§6 EVANS/DEMARCO 규칙)용. */
+/**
+ * 값이 이미 다른 수식의 에러 결과(문자열)인지 판별 — 에러 전파용. / Detect whether a value is already another formula's error result (string) — for error propagation.
+ *
+ * @param v - 검사할 값 / Value to inspect
+ * @returns 에러 코드 또는 null / The error code, or null
+ */
 export declare function isErrorToken(v: unknown): FormulaErrorCode | null;
+/** 수식 셀의 계산 결과 값 타입. / Computed result value type of a formula cell. */
 export type CellValue = OGDecimal | string | boolean | null;
+/** 참조 정규화 모드: 'stable'(rowId 앵커) | 'relative'(행 오프셋). / Reference normalization mode: 'stable' (rowId anchor) | 'relative' (row offset). */
 export type RefMode = 'stable' | 'relative';
+/** 정규화된 절대 참조(rowId 앵커). / Normalized absolute reference (rowId anchor). */
 export interface CanonicalAbsRef {
     kind: 'abs';
+    /** 앵커 행 stable id. / Anchor row stable id. */
     rowId: string;
+    /** 컬럼 field 명. / Column field name. */
     field: string;
+    /** 원문에 '$' 행 고정이 있었는지. / Whether the source had a '$' row lock. */
     dollarRow: boolean;
+    /** 원문에 '$' 열 고정이 있었는지. / Whether the source had a '$' column lock. */
     dollarCol: boolean;
 }
+/** 정규화된 상대 참조(행 오프셋). / Normalized relative reference (row offset). */
 export interface CanonicalRelRef {
     kind: 'rel';
+    /** 현재 셀 기준 행 오프셋 (refMode:'relative' 전용, §2.3). / Row offset from the current cell (refMode:'relative' only, §2.3). */
     dRow: number;
+    /** 컬럼 field 명. / Column field name. */
     field: string;
+    /** rel 인데 dollarRow=true 인 경우는 없음(구조상 dollarRow=true 면 abs). / Never true for rel (a '$' row lock structurally implies abs). */
     dollarRow: boolean;
+    /** 열 고정 여부. / Whether the column is locked. */
     dollarCol: boolean;
 }
+/** 정규화된 단일 참조(절대 | 상대). / Normalized single reference (absolute | relative). */
 export type CanonicalRef = CanonicalAbsRef | CanonicalRelRef;
+/** 정규화된 범위 참조(두 코너). / Normalized range reference (two corners). */
 export interface CanonicalRangeRef {
+    /** 코너1 (원문 좌측/상단 그대로, 정렬은 evaluate-time §3.5). / Corner 1 (kept as source left/top; ordering happens at evaluate-time §3.5). */
     a: CanonicalRef;
+    /** 코너2. / Corner 2. */
     b: CanonicalRef;
 }
+/** 파서 원시 셀 참조 노드(정규화 전). / Raw parser cell-reference node (pre-normalization). */
 export interface RawCellRefNode {
     t: 'rawRef';
+    /** A1 열문자. / A1 column letters. */
     colLetters: string;
+    /** 1-based 행 번호. / 1-based row number. */
     row: number;
+    /** 열 '$' 고정. / Column '$' lock. */
     dollarCol: boolean;
+    /** 행 '$' 고정. / Row '$' lock. */
     dollarRow: boolean;
 }
+/** 파서 원시 범위 참조 노드(정규화 전). / Raw parser range-reference node (pre-normalization). */
 export interface RawRangeRefNode {
     t: 'rawRange';
     a: RawCellRefNode;
     b: RawCellRefNode;
 }
+/** 수식 이항 연산자. / Formula binary operator. */
 export type BinOp = '+' | '-' | '*' | '/' | '%' | '^' | '&' | '=' | '<>' | '<' | '<=' | '>' | '>=';
+/** 수식 AST 노드(원시 참조 + 정규화 후 노드 공존 유니온). / Formula AST node (union of raw refs and normalized nodes). */
 export type AstNode = {
     t: 'num';
     v: string;
@@ -78,27 +130,38 @@ export type AstNode = {
     left: AstNode;
     right: AstNode;
 };
+/** 수식 셀 사이드카 저장 단위(§3.4/§4.1). / Formula-cell sidecar storage unit (§3.4/§4.1). */
 export interface FormulaCell {
+    /** 원문 "=A1+B2"(편집 표시용, §4.3). / Source text "=A1+B2" (for edit display, §4.3). */
     src: string;
+    /** 정규화된 AST. / Normalized AST. */
     ast: AstNode;
+    /** 범위 참조 포함 여부 → applySort/applyFilter dirty 대상(§3.5 P0). / Whether a range ref is present → dirtied by applySort/applyFilter (§3.5 P0). */
     hasRangeRef: boolean;
+    /** 캐시된 계산 결과. / Cached computed result. */
     value: CellValue;
+    /** 에러 코드(없으면 null). / Error code (null if none). */
     error: FormulaErrorCode | null;
+    /** 근사(SQRT 등) 포함 여부 → ≈ 표식(C11). / Whether approximation (e.g. SQRT) is involved → ≈ marker (C11). */
     approx?: boolean;
 }
+/**
+ * 수식 엔진이 그리드/데이터를 보는 유일한 인터페이스(주입, 의존성 역전 C0/C0.3/C1).
+ * / The sole interface through which the formula engine views the grid/data (injected, dependency inversion C0/C0.3/C1).
+ */
 export interface FormulaGridAccessor {
-    /** A1 열문자 매핑 기준 — visibleLeaves(숨김 제외) 순서의 field 배열(§3.1/C1). */
+    /** A1 열문자 매핑 기준 — visibleLeaves(숨김 제외) 순서의 field 배열(§3.1/C1). / A1 column-letter basis — field array in visibleLeaves order (hidden excluded) (§3.1/C1). */
     visibleFields(): string[];
-    /** flat index(0-based) → rowId. kind!=='data' 이거나 범위 밖이면 null(§C0.3). */
+    /** flat index(0-based) → rowId. kind!=='data' 이거나 범위 밖이면 null(§C0.3). / flat index (0-based) → rowId; null when kind!=='data' or out of range (§C0.3). */
     rowIdAtFlat(flatIndex: number): string | null;
-    /** rowId → 현재 flat index(0-based). 없음/필터아웃/접힘이면 -1. */
+    /** rowId → 현재 flat index(0-based). 없음/필터아웃/접힘이면 -1. / rowId → current flat index (0-based); -1 when absent/filtered-out/collapsed. */
     flatIndexOfRowId(rowId: string): number;
-    /** 현재 표시(필터 통과) 순서의 rowId 배열 — 범위 evaluate-time 멤버십 해소용(§3.5). */
+    /** 현재 표시(필터 통과) 순서의 rowId 배열 — 범위 evaluate-time 멤버십 해소용(§3.5). / rowId array in current display (filtered) order — for evaluate-time range membership (§3.5). */
     displayedRowIds(): string[];
-    /** (rowId, field) 셀의 원시 값(비수식, 이미 계산된 값 포함) 조회. */
+    /** (rowId, field) 셀의 원시 값(비수식, 이미 계산된 값 포함) 조회. / Read the raw value at (rowId, field) (non-formula; includes already-computed values). */
     getCellValue(rowId: string, field: string): unknown;
-    /** rowId 존재 여부(행 삭제 감지, F3-R28). */
+    /** rowId 존재 여부(행 삭제 감지, F3-R28). / Whether a rowId exists (row-deletion detection, F3-R28). */
     hasRow(rowId: string): boolean;
-    /** field 존재 여부(열 삭제 감지, F3-R28). */
+    /** field 존재 여부(열 삭제 감지, F3-R28). / Whether a field exists (column-deletion detection, F3-R28). */
     hasField(field: string): boolean;
 }

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;

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

@@ -2,13 +2,25 @@ 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;
+/**
+ * 셀 렌더러/에디터에 전달되는 렌더 컨텍스트. / Render context passed to cell renderers/editors.
+ *
+ * @typeParam T - 행 데이터 타입 / Row data type
+ */
 export interface RenderContext<T = any> {
+    /** 셀 원시 값. / Raw cell value. */
     value: any;
+    /** 행 데이터. / Row data. */
     row: T;
+    /** flat 행 인덱스. / Flat row index. */
     rowIndex: number;
+    /** 컬럼 정의. / Column definition. */
     column: ColumnDef<T>;
+    /** 컬럼 인덱스. / Column index. */
     colIndex: number;
+    /** 선택 여부. / Whether selected. */
     isSelected: boolean;
+    /** 행 변경 상태. / Row mutation state. */
     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;
@@ -21,7 +33,9 @@ export interface RenderContext<T = any> {
     /** C7(15_cross_contracts.md/F3-R14): 이 셀에 F3 셀 수식이 있으면 true — ColumnDef.formula 재평가를 skip. */
     hasCellFormula?: boolean;
 }
+/** 셀 렌더러 인터페이스 — ctx 로 셀 엘리먼트를 만든다. / Cell renderer interface — builds a cell element from ctx. */
 export interface CellRenderer {
+    /** 셀 엘리먼트를 렌더한다. / Render the cell element. */
     render(ctx: RenderContext): HTMLElement;
 }
 /**
@@ -34,13 +48,25 @@ export interface CellRenderer {
  * formatNumber/formatDate 는 전역 상태 0 의 순수 포맷 함수로 환원했다(출력 동일, 회귀 0).
  */
 /**
- * 컬럼에 formula가 있으면 OGDecimal로 평가해 표시값(string)을 반환.
- * formula가 없으면 null 반환 → 기존 ctx.value 사용.
+ * 컬럼에 formula 가 있으면 OGDecimal 로 평가해 표시값(string)을 반환. 없으면 null(→ 기존 ctx.value 사용).
+ * / If the column has a formula, evaluate it via OGDecimal and return the display string; null otherwise (→ use ctx.value).
+ *
+ * @param ctx - 렌더 컨텍스트 / Render context
+ * @returns 표시 문자열, 또는 formula 없음/skip 시 null / Display string, or null when no formula / skipped
  */
 export declare function resolveFormula(ctx: RenderContext): string | null;
 /**
- * 숫자 포맷.
- *  format 문자열:
+ * 숫자 포맷. / Format a number.
+ *
+ * @param value - 포맷할 값 / Value to format
+ * @param format - 포맷 문자열(아래 참조) / Format string (see below)
+ * @param precision - 소수 자리수(있으면 반올림) / Decimal precision (rounds if set)
+ * @param currency - ISO 통화코드 지정 시 Intl 로케일 통화 포맷 우선 / When an ISO currency code is set, Intl locale currency format takes priority
+ * @param field - 컬럼 field(선택) / Column field (optional)
+ * @param row - 행 데이터(선택) / Row data (optional)
+ * @returns 포맷된 문자열 / Formatted string
+ *
+ *  format 문자열 / format string:
  *   '#,##0'          천단위 콤마, 정수
  *   '#,##0.00'       천단위 콤마, 소수 2자리
  *   '₩#,##0'         통화 접두 (₩1,234)
@@ -50,10 +76,21 @@ export declare function resolveFormula(ctx: RenderContext): string | null;
  *  currency: ISO 통화코드('KRW'|'USD'|'EUR'…) 지정 시 Intl.NumberFormat 로케일 통화 포맷 우선.
  */
 export declare function formatNumber(value: any, format?: string, precision?: number, currency?: string, field?: string, row?: any): string;
+/**
+ * 날짜 포맷(yyyy/MM/dd 토큰 치환). / Format a date (replaces yyyy/MM/dd tokens).
+ *
+ * @param value - Date 또는 파싱 가능한 값 / A Date or a parseable value
+ * @param format - 포맷 문자열(기본 'yyyy-MM-dd') / Format string (default 'yyyy-MM-dd') @defaultValue 'yyyy-MM-dd'
+ * @param field - 컬럼 field(선택) / Column field (optional)
+ * @param row - 행 데이터(선택) / Row data (optional)
+ * @returns 포맷된 문자열 / Formatted string
+ */
 export declare function formatDate(value: any, format?: string, field?: string, row?: any): string;
+/** 기본 텍스트 렌더러(formula/displayValue/valueMap/마스킹 처리 포함). / Default text renderer (handles formula/displayValue/valueMap/masking). */
 export declare class TextRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
+/** 셀렉트 값→라벨 매핑 렌더러(옵션 배열 또는 행별 옵션 함수). / Select value→label renderer (option array or per-row options function). */
 export declare class SelectRenderer implements CellRenderer {
     private _opts;
     private _fn;
@@ -68,106 +105,145 @@ export declare class SelectRenderer implements CellRenderer {
     }>);
     render(ctx: RenderContext): HTMLElement;
 }
+/** 숫자 렌더러(formula/displayFormatter/통화·포맷 처리, 우측 정렬). / Number renderer (formula/displayFormatter/currency·format, right-aligned). */
 export declare class NumberRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
+/** 날짜 렌더러(displayFormatter 우선, 없으면 formatDate). / Date renderer (displayFormatter first, else formatDate). */
 export declare class DateRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
+/** 체크박스 렌더러(표시 전용, 클릭은 셀 이벤트가 처리). / Checkbox renderer (display-only; clicks handled by cell events). */
 export declare class CheckboxRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
+/** 버튼 렌더러 설정. / Button renderer definition. */
 export interface ButtonRendererDef {
     type: 'button';
+    /** 버튼 라벨(문자열 또는 (값,행)→문자열). / Button label (string or (value,row)→string). */
     label?: string | ((value: any, row: any) => string);
-    /** R12c: 라벨과 함께 표시할 아이콘 role/key(renderIcon). 미지정 시 라벨만(기존과 동일). */
+    /** R12c: 라벨과 함께 표시할 아이콘 role/key(renderIcon). 미지정 시 라벨만. / Icon role/key shown with the label (renderIcon); label-only when unset. */
     icon?: string;
-    /** 아이콘 위치(기본 'left'). */
+    /** 아이콘 위치. 기본 'left'. / Icon position. Default 'left'. @defaultValue 'left' */
     iconPos?: 'left' | 'right';
+    /** 버튼에 추가할 CSS 클래스. / Extra CSS class for the button. */
     buttonClass?: string;
+    /** 인라인 스타일. / Inline style. */
     style?: string;
 }
+/** 버튼 렌더러(라벨±아이콘). / Button renderer (label ± icon). */
 export declare class ButtonRenderer implements CellRenderer {
     private def?;
     constructor(def?: ButtonRendererDef | undefined);
     render(ctx: RenderContext): HTMLElement;
 }
+/** 배지 렌더러(상태/태그 색상 표시). / Badge renderer (colored status/tag pill). */
 export declare class BadgeRenderer implements CellRenderer {
     private colorMap?;
     private labelMap?;
     constructor(colorMap?: Record<string, string> | undefined, labelMap?: Record<string, string> | undefined);
     render(ctx: RenderContext): HTMLElement;
 }
+/** 링크(a) 렌더러(hrefFn·target 지원). / Link (a) renderer (supports hrefFn·target). */
 export declare class LinkRenderer implements CellRenderer {
     private hrefFn?;
     private target?;
     constructor(hrefFn?: ((value: any, row: any) => string) | undefined, target?: string | undefined);
     render(ctx: RenderContext): HTMLElement;
 }
+/** 템플릿 렌더러(사용자 함수가 HTML 문자열 생성). / Template renderer (user function produces an HTML string). */
 export declare class TemplateRenderer implements CellRenderer {
     private templateFn;
     constructor(templateFn: (value: any, row: any, rowIndex: number) => string);
     render(ctx: RenderContext): HTMLElement;
 }
+/** 이미지 렌더러 설정. / Image renderer definition. */
 export interface ImageRendererDef {
     type: 'image';
+    /** 너비(px). 기본 28. / Width in px. Default 28. @defaultValue 28 */
     width?: number;
+    /** 높이(px). 기본 28. / Height in px. Default 28. @defaultValue 28 */
     height?: number;
+    /** 모서리 반경(px). 기본 4. / Corner radius in px. Default 4. @defaultValue 4 */
     radius?: number;
+    /** 값→src URL 함수. / Value→src URL function. */
     srcFn?: (value: any, row: any) => string;
+    /** alt 텍스트 또는 함수. / alt text or function. */
     alt?: string | ((value: any, row: any) => string);
 }
+/** 이미지(썸네일) 렌더러. / Image (thumbnail) renderer. */
 export declare class ImageRenderer implements CellRenderer {
     private def?;
     constructor(def?: ImageRendererDef | undefined);
     render(ctx: RenderContext): HTMLElement;
 }
+/** 진행바 렌더러 설정. / Progress-bar renderer definition. */
 export interface ProgressRendererDef {
     type: 'progress';
+    /** 최댓값. 기본 100. / Max value. Default 100. @defaultValue 100 */
     max?: number;
+    /** 채움 색. / Fill color. */
     color?: string;
+    /** 퍼센트 라벨 표시(기본 true). / Show percent label (default true). @defaultValue true */
     showLabel?: boolean;
+    /** 값→색 함수(color 오버라이드). / Value→color function (overrides color). */
     colorFn?: (value: number) => string;
 }
+/** 진행바 렌더러. / Progress-bar renderer. */
 export declare class ProgressRenderer implements CellRenderer {
     private def?;
     constructor(def?: ProgressRendererDef | undefined);
     render(ctx: RenderContext): HTMLElement;
 }
+/** 스파크라인 렌더러 설정(값 배열 → 미니 차트). / Sparkline renderer definition (value array → mini chart). */
 export interface SparklineRendererDef {
     type: 'sparkline';
+    /** 캔버스 너비(px). 기본 80. / Canvas width in px. Default 80. @defaultValue 80 */
     width?: number;
+    /** 캔버스 높이(px). 기본 22. / Canvas height in px. Default 22. @defaultValue 22 */
     height?: number;
+    /** 선/바 색. / Line/bar color. */
     color?: string;
+    /** 미니 차트 종류(기본 'bar'). / Mini chart type (default 'bar'). @defaultValue 'bar' */
     chartType?: 'bar' | 'line' | 'area';
 }
+/** 스파크라인(인라인 미니 차트) 렌더러. / Sparkline (inline mini chart) renderer. */
 export declare class SparklineRenderer implements CellRenderer {
     private def?;
     constructor(def?: SparklineRendererDef | undefined);
     render(ctx: RenderContext): HTMLElement;
 }
+/** 토글 스위치 렌더러(표시 전용). / Toggle-switch renderer (display-only). */
 export declare class SwitchRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
+/** 별점 렌더러 설정. / Rating (stars) renderer definition. */
 export interface RatingRendererDef {
     type: 'rating';
+    /** 최대 별 수. 기본 5. / Max stars. Default 5. @defaultValue 5 */
     max?: number;
+    /** 채워진 별 색. / Filled-star color. */
     color?: string;
 }
+/** 별점 렌더러. / Rating (stars) renderer. */
 export declare class RatingRenderer implements CellRenderer {
     private def?;
     constructor(def?: RatingRendererDef | undefined);
     render(ctx: RenderContext): HTMLElement;
 }
+/** 라디오 렌더러(표시 전용, group 지원). / Radio renderer (display-only, supports group). */
 export declare class RadioRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
+/** 단순 이미지 렌더러(셀 값 = 이미지 URL). / Simple image renderer (cell value = image URL). */
 export declare class ImgRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
+/** HTML 렌더러(기본 sanitize; column.sanitize=false 로 해제 가능). / HTML renderer (sanitizes by default; disable via column.sanitize=false). */
 export declare class HtmlRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
+/** 바코드 렌더러(Code128B, SVG + 하단 텍스트). / Barcode renderer (Code128B, SVG plus caption text). */
 export declare class BarcodeRenderer implements CellRenderer {
     render(ctx: RenderContext): HTMLElement;
 }
@@ -185,9 +261,25 @@ export declare class BarcodeRenderer implements CellRenderer {
  *  - image/progress/sparkline/rating/template 은 def(설정 객체) 없이는 원래 TextRenderer 로 떨어졌으므로
  *    def 유무로 게이트한다(문자열 렌더러명만 준 미완성 설정 = 기존과 동일 폴백).
  */
+/** 셀 렌더러 팩토리 시그니처 `(col, def?) => CellRenderer`. / Cell-renderer factory signature `(col, def?) => CellRenderer`. */
 export type RendererFactory = (col: ColumnDef, def?: RendererDef) => CellRenderer;
-/** 커스텀 셀 렌더러 타입을 코어 편집 없이 등록(OCP). 프로세스 전역. */
+/**
+ * 커스텀 셀 렌더러 타입을 코어 편집 없이 등록(OCP). 프로세스 전역.
+ * / Register a custom cell-renderer type without editing core (OCP). Process-global.
+ *
+ * @param typeName - 렌더러 타입 이름(예: 'sparkline') / Renderer type name (e.g. 'sparkline')
+ * @param factory - 렌더러 팩토리 / Renderer factory
+ * @example
+ * registerRenderer('stars', (col, def) => new RatingRenderer(def as any));
+ */
 export declare function registerRenderer(typeName: string, factory: RendererFactory): void;
-/** 등록 여부 조회(내부/테스트용). */
+/** 렌더러 타입 등록 여부 조회(내부/테스트용). / Whether a renderer type is registered (internal/test use). */
 export declare function hasRenderer(typeName: string): boolean;
+/**
+ * 컬럼 정의로부터 셀 렌더러를 생성한다(레지스트리 해석, 미등록 시 TextRenderer 폴백).
+ * / Create a cell renderer from a column definition (registry resolution; falls back to TextRenderer when unregistered).
+ *
+ * @param col - 컬럼 정의 / Column definition
+ * @returns 셀 렌더러 / A cell renderer
+ */
 export declare function createRenderer(col: ColumnDef): CellRenderer;