kordoc 3.18.1 → 4.0.1

package/dist/index.d.cts

@@ -579,6 +579,20 @@ interface PlaceSealResult {
  */
 declare function placeSealHwpx(hwpxBuffer: ArrayBuffer, ops: SealOp[]): Promise<PlaceSealResult>;
 
+/** 요소별 글자 크기(pt) 오버라이드 — 미지정 요소는 bodyHeight 비례 기본값 */
+type GaejosikSizeOverrides = Partial<{
+    dae: number;
+    cham: number;
+    chapter: number;
+    coverTitle: number;
+    coverSub: number;
+    tocLabel: number;
+    tocRoman: number;
+    tocItem: number;
+    table: number;
+    bodyTitle: number;
+}>;
+
 /**
  * 공문서(公文書) 모드 — 한국 행정 공문서 표준 서식 렌더링 로직
  *
@@ -589,11 +603,12 @@ declare function placeSealHwpx(hwpxBuffer: ArrayBuffer, ops: SealOp[]): Promise<
  * 이 모듈은 **순수 로직**만 담는다(항목부호 시퀀스 생성, 단계별 들여쓰기 계산,
  * 프리셋 해석). 실제 XML 조립은 generator.ts가 한다.
  */
-type GongmunPreset = "official" | "report" | "plan" | "notice" | "minutes";
-type GongmunNumbering = "standard" | "report";
+
+type GongmunPreset = "official" | "report" | "plan" | "notice" | "minutes" | "gaejosik";
+type GongmunNumbering = "standard" | "report" | "gaejosik";
 type GongmunFont = "myeongjo" | "gothic";
 /** 프리셋 입력값 — 영문 키 또는 한글 별칭(기안문·보고서·계획서·통지·회의록 등) */
-type GongmunPresetInput = GongmunPreset | "기안문" | "시행문" | "공문" | "공문서" | "보고서" | "계획서" | "계획" | "통지" | "알림" | "안내" | "회의록";
+type GongmunPresetInput = GongmunPreset | "기안문" | "시행문" | "공문" | "공문서" | "보고서" | "계획서" | "계획" | "통지" | "알림" | "안내" | "회의록" | "개조식" | "개조식보고서" | "정부보고서" | "정부표준개조식보고서";
 /** 공문서 모드 옵션 (전부 선택 — 프리셋 기본값을 개별 override) */
 interface GongmunOptions {
     /** 문서 종류 프리셋(영문 키 또는 한글 별칭). 기본 'official'(일반 기안문) */
@@ -604,8 +619,18 @@ interface GongmunOptions {
     bodyPt?: number;
     /** 본문 줄간격(%). 기본 160 (회의록 130) */
     lineSpacing?: number;
-    /** 항목부호 체계. 'standard'=법정 8단계(1. 가. 1) …) / 'report'=보고서 불릿(□ ○ - ㆍ) */
+    /** 항목부호 체계. 'standard'=법정 8단계(1. 가. 1) …) / 'report'=보고서 불릿(□ ○ - ㆍ) / 'gaejosik'=개조식(□ ○ - ㆍ + 부호별 폰트) */
     numbering?: GongmunNumbering;
+    /**
+     * 표지 페이지(개조식 프리셋 기본 켜짐) — 첫 h1을 제목으로, 파랑 장식 바 + 날짜 + 기관명.
+     * false로 끄거나 {date, org}로 날짜(기본 오늘, 'YYYY. M. D.')·기관명(기본 생략) 지정.
+     */
+    cover?: boolean | {
+        date?: string;
+        org?: string;
+    };
+    /** 목차 페이지(개조식 프리셋 기본 켜짐) — h2 목록을 Ⅰ Ⅱ Ⅲ…로 자동 생성. false로 끔 */
+    toc?: boolean;
     /** 용지 여백(mm). 기본 공식값 위20/아래10/좌20/우20 */
     margins?: {
         top: number;
@@ -623,6 +648,34 @@ interface GongmunOptions {
     autoFit?: boolean | {
         minRatio?: number;
     };
+    /**
+     * 요소별 글꼴 오버라이드 — 기관 표준 폰트 적용이나 미설치 폰트 대체용.
+     * body=본문(개조식 ○·-) / heading=제목 계열(□·장헤더·표지·목차) / ref=※ 참고 / table=표 셀.
+     * 실측 폰트 프리셋(개조식·보고서·계획서)은 네 역할 전부, 그 외 프리셋은 body만
+     * 적용된다 (bodyFont보다 우선).
+     */
+    fonts?: {
+        body?: string;
+        heading?: string;
+        ref?: string;
+        table?: string;
+    };
+    /** 개조식 요소별 글자 크기(pt) 오버라이드 — 미지정 요소는 bodyPt 비례 기본값 */
+    sizes?: GaejosikSizeOverrides;
+    /** 쪽번호(하단 중앙 "- 1 -", 표지·목차는 카운트 제외). 기본: 개조식·보고서·계획서 켜짐 */
+    pageNumbers?: boolean;
+    /** 본문 끝 2타+"끝." 표시(행정업무규정). 기본: 기안문(official)만 켜짐 */
+    endMark?: boolean;
+    /** 결재란 — 직위 라벨 배열(예: ["담당","팀장","과장"]). 문서 최상단 우측 배치 */
+    approval?: string[];
+    /** 본문 첫 페이지 제목 박스(개조식) — 목차 뒤 본문 시작에 제목 반복(실측 관행). 기본: 표지 있으면 켜짐 */
+    bodyTitleBox?: boolean;
+    /**
+     * h2 섹션 제목 말머리 (비개조식 — 개조식 h2는 로마숫자 장 헤더가 대체).
+     * 'box'=□ 대항목(실측 보고서 양식 관행) / 'number'=아라비아 번호(1. 2. — 공고문 관행)
+     * / 'none'=말머리 없음. 기본: 보고서·계획서 'box', 그 외 'none'.
+     */
+    h2Marker?: "box" | "number" | "none";
 }
 /** 프리셋 별칭(한글/영문) → 내부 preset 키. CLI·라이브러리 공용 */
 declare const PRESET_ALIAS: Record<string, GongmunPreset>;
@@ -744,7 +797,9 @@ interface FormatProfile {
  *   gen-header.ts     — container/manifest/head.xml 생성
  *   gen-gongmun-fit.ts — 공문 자동장평 계획 + 리스트 항목부호 선계산
  *   gen-table.ts      — GFM/HTML(병합) 표 XML
+ *   gen-table-bf.ts   — 표 셀 위치별 borderFill 동적 레지스트리 (실측 테두리 위계)
  *   gen-section.ts    — secPr + 본문 section0.xml 조립
+ *   gen-profile.ts    — 서식 프로필(#41) id 리맵·표 매칭
  */
 
 /** markdownToHwpx 옵션 */
@@ -760,7 +815,7 @@ interface MarkdownToHwpxOptions {
      * 서식 프로필 — 표의 borderFill(테두리·음영)·열 너비·셀 글꼴을 원본 문서 없이
      * 재현한다(이슈 #41). `hwpxToProfile()`로 추출하거나 직접 작성한 프로필을 넘기면,
      * 문서 내 표 등장 순서(table_index)로 매칭해 셀 좌표별 서식을 적용한다.
-     * 미지정 시 기존 기본 서식(단일 SOLID 테두리·균등 열폭) 그대로.
+     * 미지정 시 기본 서식 — 공문서 모드는 실측 정부 표 문법, 그 외 단일 SOLID 테두리.
      */
     profile?: FormatProfile;
 }
@@ -787,6 +842,50 @@ declare function markdownToHwpx(markdown: string, options?: MarkdownToHwpxOption
  */
 declare function hwpxToProfile(input: ArrayBuffer | Buffer): Promise<FormatProfile>;
 
+/**
+ * 폰트 카탈로그 — fonts 오버라이드 오타·미설치 경고용 (A2).
+ *
+ * 생성은 항상 진행하고 경고만 낸다: HWPX는 폰트명을 문자열로 참조하므로
+ * 미설치 폰트를 지정해도 파일은 유효하지만, 한컴이 무경고로 기본 폰트로
+ * 대체 렌더해 "지정한 폰트가 안 먹는" 원인 파악이 어렵다.
+ * 여기 목록은 한컴오피스 번들 + Windows 한글판 기본 + 통상 설치 무료 폰트.
+ * 목록에 없다고 오류는 아니다 — 경고 문구도 그렇게 안내한다.
+ */
+/** 카탈로그에 있는 폰트인가 */
+declare function isKnownFont(name: string): boolean;
+/**
+ * fonts 오버라이드 경고 목록 — 카탈로그에 없는 폰트명마다 경고 1건.
+ * 빈 배열이면 전부 알려진 폰트. 경고는 생성을 막지 않는다.
+ */
+declare function unknownFontWarnings(fonts: Record<string, string | undefined>): string[];
+
+/**
+ * 공문서 표기법 검수기 — 「행정업무의 운영 및 혁신에 관한 규정」 시행규칙 및
+ * 행정안전부 행정업무운영 편람의 날짜·시간·금액·기호 표기법을 정규식으로 검사.
+ *
+ * 원전: jkf87/hwpx-skill gonmun_lint.py(2025 편람 기준 13룰)를 kordoc에 맞게 이식
+ * (v4.0.1). URL 쌍점 오탐 가드 등 일부 보강. 검사는 조언용이다 — 생성은 막지 않고
+ * 경고만 낸다 (A2 폰트경고와 같은 원칙). 별도 CLI `kordoc lint`는 error 시 exit 1.
+ */
+interface GongmunLintFinding {
+    /** 1-based 줄 번호 */
+    line: number;
+    /** 걸린 원문 조각 */
+    match: string;
+    /** 규칙 코드 (DATE_NO_SPACE 등) */
+    rule: string;
+    severity: "error" | "warning";
+    message: string;
+    suggest?: string;
+}
+/**
+ * 텍스트(마크다운 포함) 표기법 검수. 마크다운 펜스 코드블록(``` ~ ```) 안은
+ * 건너뛴다 — 코드·URL이 날짜/쌍점 규칙에 오탐되는 것 방지.
+ */
+declare function lintGongmunText(text: string): GongmunLintFinding[];
+/** 검수 결과를 사람이 읽는 경고 문자열 배열로 — generate 경고 채널(A2와 동일)용 */
+declare function gongmunLintWarnings(text: string, limit?: number): string[];
+
 /**
  * 한글 조판 텍스트 폭 계산 — 함초롬바탕(HCR Batang) 실측 advance 테이블
  *
@@ -832,8 +931,8 @@ interface WrapResult {
 }
 /**
  * 문단 줄바꿈 시뮬레이션.
- * mode 'keep' = breakNonLatinWord=KEEP_WORD(어절 단위, 공문서 모드·Windows 한글),
- * mode 'charAll' = 글자 단위(BREAK_WORD·macOS 한글·전자결재 변환기의 실동작).
+ * mode 'keep' = 어절 단위(공문서 모드 — 저장 속성 breakNonLatinWord="BREAK_WORD", 이름 역전 주의),
+ * mode 'charAll' = 글자 단위(breakNonLatinWord="KEEP_WORD" — 한글 기본값·전자결재 변환기).
  * 한 어절이 줄보다 길면 keep에서도 글자 단위로 강제 분해(한컴 동일).
  *
  * @param text        문단 전체 텍스트(항목 부호 포함)
@@ -1224,7 +1323,9 @@ interface RenderSvgOptions {
     /** Tier-2 reflow — 조판 캐시(linesegarray) 없는 파일도 순수 TS 조판으로 렌더.
      *  캐시가 있으면 무시(한컴본은 캐시 재생). 기본 false(캐시 없으면 KordocError). */
     reflow?: boolean;
-    /** reflow 줄바꿈 모드 — 'keep'(어절, Windows 한글·공문서) / 'charAll'(글자, macOS·전자결재) */
+    /** reflow 줄바꿈 폴백 모드 — 'keep'(어절) / 'charAll'(글자). 문단 paraPr에
+     *  breakSetting 선언이 있으면 그 값이 우선하며(BREAK_WORD=어절, KEEP_WORD=글자 —
+     *  이름 역전 주의), 이 옵션은 선언 없는 문단에만 적용된다. */
     reflowMode?: WrapMode;
 }
 interface RenderSvgResult {
@@ -1349,4 +1450,4 @@ interface FillFormOutput {
  */
 declare function fillForm(input: string | ArrayBuffer | Buffer, values: Record<string, FillInput>, outputFormat?: FillOutputFormat): Promise<FillFormOutput>;
 
-export { type BlockCapability, type BlockCapabilityInfo, type BlockDiff, type BlockEdit, type BlockSourceRef, type BorderDef, type BorderFillDef, type BoundingBox, type CellCapability, type CellContext, type CellDiff, type CellProfile, type CharPrDef, type DiffChangeType, type DiffResult, type DocumentMetadata, type DocumentQualitySummary, type ErrorCode, type ExtractedImage, type FileType, type FillFormOutput, type FillInput, type FillOutputFormat, type FillResult, type FillValue, type FormField, type FormFieldSchema, type FormFieldType, type FormResult, type FormSchemaResult, type FormatProfile, type GongmunFont, type GongmunNumbering, type GongmunOptions, type GongmunPreset, type GongmunPresetInput, type HwpxFillResult, HwpxSession, type HwpxTheme, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type MarkdownToHwpxOptions, type MeasureOptions, type OcrProvider, type OutlineItem, PRESET_ALIAS, type PageMargin, type PageQuality, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type PatchOptions, type PatchResult, type PatchSkip, type PlaceSealResult, type PrintOptions, type PrintPreset, type RenderSvgOptions, type RenderSvgResult, SPACE_EM_FIXED, SPACE_EM_FONT, type ScanCell, type ScanParaKind, type ScanParagraph, type ScanTable, type SealOp, type SealPlacement, type SectionScan, type SpliceEdit, type TRange, type TableProfile, VERSION, type ValidateIssue, type ValidateResult, ValueCursor, type WarningCode, type WatchOptions, type WrapMode, type WrapResult, applySplices, blocksToMarkdown, blocksToPdf, buildParagraphSplices, buildRangeSplices, charWidthEm1000, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractFormFields, extractFormSchema, fillForm, fillFormFields, fillHwpx, fillWithUniqueGuard, fitRatioForFewerLines, formatFillValue, hwpxToProfile, inferFieldType, isHwpxFile, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, markdownToPdf, measureTextWidth, normalizeGongmunPreset, openHwpxDocument, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parsePdf, parseXls, parseXlsx, patchHwp, patchHwpx, patchHwpxBlocks, placeSealHwpx, renderHtml, renderHwpxToSvg, scanSectionXml, simulateWrap, simulateWrapKeepWord, validateHwpx };
+export { type BlockCapability, type BlockCapabilityInfo, type BlockDiff, type BlockEdit, type BlockSourceRef, type BorderDef, type BorderFillDef, type BoundingBox, type CellCapability, type CellContext, type CellDiff, type CellProfile, type CharPrDef, type DiffChangeType, type DiffResult, type DocumentMetadata, type DocumentQualitySummary, type ErrorCode, type ExtractedImage, type FileType, type FillFormOutput, type FillInput, type FillOutputFormat, type FillResult, type FillValue, type FormField, type FormFieldSchema, type FormFieldType, type FormResult, type FormSchemaResult, type FormatProfile, type GongmunFont, type GongmunLintFinding, type GongmunNumbering, type GongmunOptions, type GongmunPreset, type GongmunPresetInput, type HwpxFillResult, HwpxSession, type HwpxTheme, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type MarkdownToHwpxOptions, type MeasureOptions, type OcrProvider, type OutlineItem, PRESET_ALIAS, type PageMargin, type PageQuality, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type PatchOptions, type PatchResult, type PatchSkip, type PlaceSealResult, type PrintOptions, type PrintPreset, type RenderSvgOptions, type RenderSvgResult, SPACE_EM_FIXED, SPACE_EM_FONT, type ScanCell, type ScanParaKind, type ScanParagraph, type ScanTable, type SealOp, type SealPlacement, type SectionScan, type SpliceEdit, type TRange, type TableProfile, VERSION, type ValidateIssue, type ValidateResult, ValueCursor, type WarningCode, type WatchOptions, type WrapMode, type WrapResult, applySplices, blocksToMarkdown, blocksToPdf, buildParagraphSplices, buildRangeSplices, charWidthEm1000, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractFormFields, extractFormSchema, fillForm, fillFormFields, fillHwpx, fillWithUniqueGuard, fitRatioForFewerLines, formatFillValue, gongmunLintWarnings, hwpxToProfile, inferFieldType, isHwpxFile, isKnownFont, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, lintGongmunText, markdownToHwpx, markdownToPdf, measureTextWidth, normalizeGongmunPreset, openHwpxDocument, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parsePdf, parseXls, parseXlsx, patchHwp, patchHwpx, patchHwpxBlocks, placeSealHwpx, renderHtml, renderHwpxToSvg, scanSectionXml, simulateWrap, simulateWrapKeepWord, unknownFontWarnings, validateHwpx };

package/dist/index.d.ts

@@ -579,6 +579,20 @@ interface PlaceSealResult {
  */
 declare function placeSealHwpx(hwpxBuffer: ArrayBuffer, ops: SealOp[]): Promise<PlaceSealResult>;
 
+/** 요소별 글자 크기(pt) 오버라이드 — 미지정 요소는 bodyHeight 비례 기본값 */
+type GaejosikSizeOverrides = Partial<{
+    dae: number;
+    cham: number;
+    chapter: number;
+    coverTitle: number;
+    coverSub: number;
+    tocLabel: number;
+    tocRoman: number;
+    tocItem: number;
+    table: number;
+    bodyTitle: number;
+}>;
+
 /**
  * 공문서(公文書) 모드 — 한국 행정 공문서 표준 서식 렌더링 로직
  *
@@ -589,11 +603,12 @@ declare function placeSealHwpx(hwpxBuffer: ArrayBuffer, ops: SealOp[]): Promise<
  * 이 모듈은 **순수 로직**만 담는다(항목부호 시퀀스 생성, 단계별 들여쓰기 계산,
  * 프리셋 해석). 실제 XML 조립은 generator.ts가 한다.
  */
-type GongmunPreset = "official" | "report" | "plan" | "notice" | "minutes";
-type GongmunNumbering = "standard" | "report";
+
+type GongmunPreset = "official" | "report" | "plan" | "notice" | "minutes" | "gaejosik";
+type GongmunNumbering = "standard" | "report" | "gaejosik";
 type GongmunFont = "myeongjo" | "gothic";
 /** 프리셋 입력값 — 영문 키 또는 한글 별칭(기안문·보고서·계획서·통지·회의록 등) */
-type GongmunPresetInput = GongmunPreset | "기안문" | "시행문" | "공문" | "공문서" | "보고서" | "계획서" | "계획" | "통지" | "알림" | "안내" | "회의록";
+type GongmunPresetInput = GongmunPreset | "기안문" | "시행문" | "공문" | "공문서" | "보고서" | "계획서" | "계획" | "통지" | "알림" | "안내" | "회의록" | "개조식" | "개조식보고서" | "정부보고서" | "정부표준개조식보고서";
 /** 공문서 모드 옵션 (전부 선택 — 프리셋 기본값을 개별 override) */
 interface GongmunOptions {
     /** 문서 종류 프리셋(영문 키 또는 한글 별칭). 기본 'official'(일반 기안문) */
@@ -604,8 +619,18 @@ interface GongmunOptions {
     bodyPt?: number;
     /** 본문 줄간격(%). 기본 160 (회의록 130) */
     lineSpacing?: number;
-    /** 항목부호 체계. 'standard'=법정 8단계(1. 가. 1) …) / 'report'=보고서 불릿(□ ○ - ㆍ) */
+    /** 항목부호 체계. 'standard'=법정 8단계(1. 가. 1) …) / 'report'=보고서 불릿(□ ○ - ㆍ) / 'gaejosik'=개조식(□ ○ - ㆍ + 부호별 폰트) */
     numbering?: GongmunNumbering;
+    /**
+     * 표지 페이지(개조식 프리셋 기본 켜짐) — 첫 h1을 제목으로, 파랑 장식 바 + 날짜 + 기관명.
+     * false로 끄거나 {date, org}로 날짜(기본 오늘, 'YYYY. M. D.')·기관명(기본 생략) 지정.
+     */
+    cover?: boolean | {
+        date?: string;
+        org?: string;
+    };
+    /** 목차 페이지(개조식 프리셋 기본 켜짐) — h2 목록을 Ⅰ Ⅱ Ⅲ…로 자동 생성. false로 끔 */
+    toc?: boolean;
     /** 용지 여백(mm). 기본 공식값 위20/아래10/좌20/우20 */
     margins?: {
         top: number;
@@ -623,6 +648,34 @@ interface GongmunOptions {
     autoFit?: boolean | {
         minRatio?: number;
     };
+    /**
+     * 요소별 글꼴 오버라이드 — 기관 표준 폰트 적용이나 미설치 폰트 대체용.
+     * body=본문(개조식 ○·-) / heading=제목 계열(□·장헤더·표지·목차) / ref=※ 참고 / table=표 셀.
+     * 실측 폰트 프리셋(개조식·보고서·계획서)은 네 역할 전부, 그 외 프리셋은 body만
+     * 적용된다 (bodyFont보다 우선).
+     */
+    fonts?: {
+        body?: string;
+        heading?: string;
+        ref?: string;
+        table?: string;
+    };
+    /** 개조식 요소별 글자 크기(pt) 오버라이드 — 미지정 요소는 bodyPt 비례 기본값 */
+    sizes?: GaejosikSizeOverrides;
+    /** 쪽번호(하단 중앙 "- 1 -", 표지·목차는 카운트 제외). 기본: 개조식·보고서·계획서 켜짐 */
+    pageNumbers?: boolean;
+    /** 본문 끝 2타+"끝." 표시(행정업무규정). 기본: 기안문(official)만 켜짐 */
+    endMark?: boolean;
+    /** 결재란 — 직위 라벨 배열(예: ["담당","팀장","과장"]). 문서 최상단 우측 배치 */
+    approval?: string[];
+    /** 본문 첫 페이지 제목 박스(개조식) — 목차 뒤 본문 시작에 제목 반복(실측 관행). 기본: 표지 있으면 켜짐 */
+    bodyTitleBox?: boolean;
+    /**
+     * h2 섹션 제목 말머리 (비개조식 — 개조식 h2는 로마숫자 장 헤더가 대체).
+     * 'box'=□ 대항목(실측 보고서 양식 관행) / 'number'=아라비아 번호(1. 2. — 공고문 관행)
+     * / 'none'=말머리 없음. 기본: 보고서·계획서 'box', 그 외 'none'.
+     */
+    h2Marker?: "box" | "number" | "none";
 }
 /** 프리셋 별칭(한글/영문) → 내부 preset 키. CLI·라이브러리 공용 */
 declare const PRESET_ALIAS: Record<string, GongmunPreset>;
@@ -744,7 +797,9 @@ interface FormatProfile {
  *   gen-header.ts     — container/manifest/head.xml 생성
  *   gen-gongmun-fit.ts — 공문 자동장평 계획 + 리스트 항목부호 선계산
  *   gen-table.ts      — GFM/HTML(병합) 표 XML
+ *   gen-table-bf.ts   — 표 셀 위치별 borderFill 동적 레지스트리 (실측 테두리 위계)
  *   gen-section.ts    — secPr + 본문 section0.xml 조립
+ *   gen-profile.ts    — 서식 프로필(#41) id 리맵·표 매칭
  */
 
 /** markdownToHwpx 옵션 */
@@ -760,7 +815,7 @@ interface MarkdownToHwpxOptions {
      * 서식 프로필 — 표의 borderFill(테두리·음영)·열 너비·셀 글꼴을 원본 문서 없이
      * 재현한다(이슈 #41). `hwpxToProfile()`로 추출하거나 직접 작성한 프로필을 넘기면,
      * 문서 내 표 등장 순서(table_index)로 매칭해 셀 좌표별 서식을 적용한다.
-     * 미지정 시 기존 기본 서식(단일 SOLID 테두리·균등 열폭) 그대로.
+     * 미지정 시 기본 서식 — 공문서 모드는 실측 정부 표 문법, 그 외 단일 SOLID 테두리.
      */
     profile?: FormatProfile;
 }
@@ -787,6 +842,50 @@ declare function markdownToHwpx(markdown: string, options?: MarkdownToHwpxOption
  */
 declare function hwpxToProfile(input: ArrayBuffer | Buffer): Promise<FormatProfile>;
 
+/**
+ * 폰트 카탈로그 — fonts 오버라이드 오타·미설치 경고용 (A2).
+ *
+ * 생성은 항상 진행하고 경고만 낸다: HWPX는 폰트명을 문자열로 참조하므로
+ * 미설치 폰트를 지정해도 파일은 유효하지만, 한컴이 무경고로 기본 폰트로
+ * 대체 렌더해 "지정한 폰트가 안 먹는" 원인 파악이 어렵다.
+ * 여기 목록은 한컴오피스 번들 + Windows 한글판 기본 + 통상 설치 무료 폰트.
+ * 목록에 없다고 오류는 아니다 — 경고 문구도 그렇게 안내한다.
+ */
+/** 카탈로그에 있는 폰트인가 */
+declare function isKnownFont(name: string): boolean;
+/**
+ * fonts 오버라이드 경고 목록 — 카탈로그에 없는 폰트명마다 경고 1건.
+ * 빈 배열이면 전부 알려진 폰트. 경고는 생성을 막지 않는다.
+ */
+declare function unknownFontWarnings(fonts: Record<string, string | undefined>): string[];
+
+/**
+ * 공문서 표기법 검수기 — 「행정업무의 운영 및 혁신에 관한 규정」 시행규칙 및
+ * 행정안전부 행정업무운영 편람의 날짜·시간·금액·기호 표기법을 정규식으로 검사.
+ *
+ * 원전: jkf87/hwpx-skill gonmun_lint.py(2025 편람 기준 13룰)를 kordoc에 맞게 이식
+ * (v4.0.1). URL 쌍점 오탐 가드 등 일부 보강. 검사는 조언용이다 — 생성은 막지 않고
+ * 경고만 낸다 (A2 폰트경고와 같은 원칙). 별도 CLI `kordoc lint`는 error 시 exit 1.
+ */
+interface GongmunLintFinding {
+    /** 1-based 줄 번호 */
+    line: number;
+    /** 걸린 원문 조각 */
+    match: string;
+    /** 규칙 코드 (DATE_NO_SPACE 등) */
+    rule: string;
+    severity: "error" | "warning";
+    message: string;
+    suggest?: string;
+}
+/**
+ * 텍스트(마크다운 포함) 표기법 검수. 마크다운 펜스 코드블록(``` ~ ```) 안은
+ * 건너뛴다 — 코드·URL이 날짜/쌍점 규칙에 오탐되는 것 방지.
+ */
+declare function lintGongmunText(text: string): GongmunLintFinding[];
+/** 검수 결과를 사람이 읽는 경고 문자열 배열로 — generate 경고 채널(A2와 동일)용 */
+declare function gongmunLintWarnings(text: string, limit?: number): string[];
+
 /**
  * 한글 조판 텍스트 폭 계산 — 함초롬바탕(HCR Batang) 실측 advance 테이블
  *
@@ -832,8 +931,8 @@ interface WrapResult {
 }
 /**
  * 문단 줄바꿈 시뮬레이션.
- * mode 'keep' = breakNonLatinWord=KEEP_WORD(어절 단위, 공문서 모드·Windows 한글),
- * mode 'charAll' = 글자 단위(BREAK_WORD·macOS 한글·전자결재 변환기의 실동작).
+ * mode 'keep' = 어절 단위(공문서 모드 — 저장 속성 breakNonLatinWord="BREAK_WORD", 이름 역전 주의),
+ * mode 'charAll' = 글자 단위(breakNonLatinWord="KEEP_WORD" — 한글 기본값·전자결재 변환기).
  * 한 어절이 줄보다 길면 keep에서도 글자 단위로 강제 분해(한컴 동일).
  *
  * @param text        문단 전체 텍스트(항목 부호 포함)
@@ -1224,7 +1323,9 @@ interface RenderSvgOptions {
     /** Tier-2 reflow — 조판 캐시(linesegarray) 없는 파일도 순수 TS 조판으로 렌더.
      *  캐시가 있으면 무시(한컴본은 캐시 재생). 기본 false(캐시 없으면 KordocError). */
     reflow?: boolean;
-    /** reflow 줄바꿈 모드 — 'keep'(어절, Windows 한글·공문서) / 'charAll'(글자, macOS·전자결재) */
+    /** reflow 줄바꿈 폴백 모드 — 'keep'(어절) / 'charAll'(글자). 문단 paraPr에
+     *  breakSetting 선언이 있으면 그 값이 우선하며(BREAK_WORD=어절, KEEP_WORD=글자 —
+     *  이름 역전 주의), 이 옵션은 선언 없는 문단에만 적용된다. */
     reflowMode?: WrapMode;
 }
 interface RenderSvgResult {
@@ -1349,4 +1450,4 @@ interface FillFormOutput {
  */
 declare function fillForm(input: string | ArrayBuffer | Buffer, values: Record<string, FillInput>, outputFormat?: FillOutputFormat): Promise<FillFormOutput>;
 
-export { type BlockCapability, type BlockCapabilityInfo, type BlockDiff, type BlockEdit, type BlockSourceRef, type BorderDef, type BorderFillDef, type BoundingBox, type CellCapability, type CellContext, type CellDiff, type CellProfile, type CharPrDef, type DiffChangeType, type DiffResult, type DocumentMetadata, type DocumentQualitySummary, type ErrorCode, type ExtractedImage, type FileType, type FillFormOutput, type FillInput, type FillOutputFormat, type FillResult, type FillValue, type FormField, type FormFieldSchema, type FormFieldType, type FormResult, type FormSchemaResult, type FormatProfile, type GongmunFont, type GongmunNumbering, type GongmunOptions, type GongmunPreset, type GongmunPresetInput, type HwpxFillResult, HwpxSession, type HwpxTheme, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type MarkdownToHwpxOptions, type MeasureOptions, type OcrProvider, type OutlineItem, PRESET_ALIAS, type PageMargin, type PageQuality, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type PatchOptions, type PatchResult, type PatchSkip, type PlaceSealResult, type PrintOptions, type PrintPreset, type RenderSvgOptions, type RenderSvgResult, SPACE_EM_FIXED, SPACE_EM_FONT, type ScanCell, type ScanParaKind, type ScanParagraph, type ScanTable, type SealOp, type SealPlacement, type SectionScan, type SpliceEdit, type TRange, type TableProfile, VERSION, type ValidateIssue, type ValidateResult, ValueCursor, type WarningCode, type WatchOptions, type WrapMode, type WrapResult, applySplices, blocksToMarkdown, blocksToPdf, buildParagraphSplices, buildRangeSplices, charWidthEm1000, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractFormFields, extractFormSchema, fillForm, fillFormFields, fillHwpx, fillWithUniqueGuard, fitRatioForFewerLines, formatFillValue, hwpxToProfile, inferFieldType, isHwpxFile, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, markdownToPdf, measureTextWidth, normalizeGongmunPreset, openHwpxDocument, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parsePdf, parseXls, parseXlsx, patchHwp, patchHwpx, patchHwpxBlocks, placeSealHwpx, renderHtml, renderHwpxToSvg, scanSectionXml, simulateWrap, simulateWrapKeepWord, validateHwpx };
+export { type BlockCapability, type BlockCapabilityInfo, type BlockDiff, type BlockEdit, type BlockSourceRef, type BorderDef, type BorderFillDef, type BoundingBox, type CellCapability, type CellContext, type CellDiff, type CellProfile, type CharPrDef, type DiffChangeType, type DiffResult, type DocumentMetadata, type DocumentQualitySummary, type ErrorCode, type ExtractedImage, type FileType, type FillFormOutput, type FillInput, type FillOutputFormat, type FillResult, type FillValue, type FormField, type FormFieldSchema, type FormFieldType, type FormResult, type FormSchemaResult, type FormatProfile, type GongmunFont, type GongmunLintFinding, type GongmunNumbering, type GongmunOptions, type GongmunPreset, type GongmunPresetInput, type HwpxFillResult, HwpxSession, type HwpxTheme, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type MarkdownToHwpxOptions, type MeasureOptions, type OcrProvider, type OutlineItem, PRESET_ALIAS, type PageMargin, type PageQuality, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type PatchOptions, type PatchResult, type PatchSkip, type PlaceSealResult, type PrintOptions, type PrintPreset, type RenderSvgOptions, type RenderSvgResult, SPACE_EM_FIXED, SPACE_EM_FONT, type ScanCell, type ScanParaKind, type ScanParagraph, type ScanTable, type SealOp, type SealPlacement, type SectionScan, type SpliceEdit, type TRange, type TableProfile, VERSION, type ValidateIssue, type ValidateResult, ValueCursor, type WarningCode, type WatchOptions, type WrapMode, type WrapResult, applySplices, blocksToMarkdown, blocksToPdf, buildParagraphSplices, buildRangeSplices, charWidthEm1000, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractFormFields, extractFormSchema, fillForm, fillFormFields, fillHwpx, fillWithUniqueGuard, fitRatioForFewerLines, formatFillValue, gongmunLintWarnings, hwpxToProfile, inferFieldType, isHwpxFile, isKnownFont, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, lintGongmunText, markdownToHwpx, markdownToPdf, measureTextWidth, normalizeGongmunPreset, openHwpxDocument, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parsePdf, parseXls, parseXlsx, patchHwp, patchHwpx, patchHwpxBlocks, placeSealHwpx, renderHtml, renderHwpxToSvg, scanSectionXml, simulateWrap, simulateWrapKeepWord, unknownFontWarnings, validateHwpx };