kordoc 4.12.2 → 4.12.3

package/dist/index.d.cts

@@ -781,6 +781,15 @@ type GongmunNumbering = "standard" | "report" | "gaejosik";
 type GongmunFont = "myeongjo" | "gothic";
 /** 프리셋 입력값 — 영문 키 또는 한글 별칭(기안문·보고서·계획서·통지·회의록 등) */
 type GongmunPresetInput = GongmunPreset | "기안문" | "시행문" | "공문" | "공문서" | "보고서" | "계획서" | "계획" | "통지" | "알림" | "안내" | "회의록" | "개조식" | "개조식보고서" | "정부보고서" | "정부표준개조식보고서" | "보도자료";
+/** 항목부호 단계 하나의 타이포 — 셋 다 선택(미지정=본문 계열 유지) */
+interface GongmunLevelStyle {
+    /** 글꼴명 (예: HY견고딕·한컴돋움·휴먼명조) */
+    font?: string;
+    /** 글자 크기 pt (6~60) */
+    pt?: number;
+    /** 굵게 */
+    bold?: boolean;
+}
 /** 공문서 모드 옵션 (전부 선택 — 프리셋 기본값을 개별 override) */
 interface GongmunOptions {
     /** 문서 종류 프리셋(영문 키 또는 한글 별칭). 기본 'official'(일반 기안문) */
@@ -834,6 +843,14 @@ interface GongmunOptions {
     };
     /** 개조식 요소별 글자 크기(pt) 오버라이드 — 미지정 요소는 bodyPt 비례 기본값 */
     sizes?: GaejosikSizeOverrides;
+    /**
+     * 항목부호 단계별 위계 타이포(v4.12.3) — depth(0~7)마다 글꼴·크기(pt)·굵기를 지정한다.
+     * 실측(실결재 기안문 206 + 보고서 337건): 법정 8단계(1. 가. 1))는 본문과 동일이 90%라 기본은
+     * 무변경, □/ㅇ/- 계열 전자결재 기안문은 □=HY견고딕 +2~3pt bold·ㅇ=한컴돋움 bold·-=휴먼명조가
+     * 지배 관행이다(docs/gongmunseo-reference.md 2.7). 지정한 단계만 바뀌고 나머지는 본문 계열.
+     * 개조식·보고서의 실측 □(HY헤드라인M)·보도자료 각주보다 우선한다(명시 옵션).
+     */
+    levels?: Record<number | string, GongmunLevelStyle>;
     /** 쪽번호(하단 중앙 "- 1 -", 표지·목차는 카운트 제외). 기본: 개조식·보고서·계획서 켜짐 */
     pageNumbers?: boolean;
     /** 본문 끝 2타+"끝." 표시(행정업무규정). 기본: 기안문(official)만 켜짐 */

package/dist/index.d.ts

@@ -781,6 +781,15 @@ type GongmunNumbering = "standard" | "report" | "gaejosik";
 type GongmunFont = "myeongjo" | "gothic";
 /** 프리셋 입력값 — 영문 키 또는 한글 별칭(기안문·보고서·계획서·통지·회의록 등) */
 type GongmunPresetInput = GongmunPreset | "기안문" | "시행문" | "공문" | "공문서" | "보고서" | "계획서" | "계획" | "통지" | "알림" | "안내" | "회의록" | "개조식" | "개조식보고서" | "정부보고서" | "정부표준개조식보고서" | "보도자료";
+/** 항목부호 단계 하나의 타이포 — 셋 다 선택(미지정=본문 계열 유지) */
+interface GongmunLevelStyle {
+    /** 글꼴명 (예: HY견고딕·한컴돋움·휴먼명조) */
+    font?: string;
+    /** 글자 크기 pt (6~60) */
+    pt?: number;
+    /** 굵게 */
+    bold?: boolean;
+}
 /** 공문서 모드 옵션 (전부 선택 — 프리셋 기본값을 개별 override) */
 interface GongmunOptions {
     /** 문서 종류 프리셋(영문 키 또는 한글 별칭). 기본 'official'(일반 기안문) */
@@ -834,6 +843,14 @@ interface GongmunOptions {
     };
     /** 개조식 요소별 글자 크기(pt) 오버라이드 — 미지정 요소는 bodyPt 비례 기본값 */
     sizes?: GaejosikSizeOverrides;
+    /**
+     * 항목부호 단계별 위계 타이포(v4.12.3) — depth(0~7)마다 글꼴·크기(pt)·굵기를 지정한다.
+     * 실측(실결재 기안문 206 + 보고서 337건): 법정 8단계(1. 가. 1))는 본문과 동일이 90%라 기본은
+     * 무변경, □/ㅇ/- 계열 전자결재 기안문은 □=HY견고딕 +2~3pt bold·ㅇ=한컴돋움 bold·-=휴먼명조가
+     * 지배 관행이다(docs/gongmunseo-reference.md 2.7). 지정한 단계만 바뀌고 나머지는 본문 계열.
+     * 개조식·보고서의 실측 □(HY헤드라인M)·보도자료 각주보다 우선한다(명시 옵션).
+     */
+    levels?: Record<number | string, GongmunLevelStyle>;
     /** 쪽번호(하단 중앙 "- 1 -", 표지·목차는 카운트 제외). 기본: 개조식·보고서·계획서 켜짐 */
     pageNumbers?: boolean;
     /** 본문 끝 2타+"끝." 표시(행정업무규정). 기본: 기안문(official)만 켜짐 */

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   flattenLayoutTables,
   inlineImagesIntoMarkdown,
   mapPuaText
-} from "./chunk-2B7OIEJJ.js";
+} from "./chunk-HB56YANA.js";
 import {
   parsePageRange
 } from "./chunk-GE43BE46.js";
@@ -29,7 +29,7 @@ import {
   sanitizeHref,
   stripDtd,
   toArrayBuffer
-} from "./chunk-MUYU4JI5.js";
+} from "./chunk-KRE2SREV.js";
 
 // src/index.ts
 import { readFile } from "fs/promises";
@@ -2785,8 +2785,9 @@ function appendParaText(state, data, resolveControl) {
       case CHAR_PARA:
         break;
       // 문단 끝
+      // 하이픈(24)은 한컴이 그리지 않는다 — 한컴 PDF·rhwp export-hwpx 모두 "60g/㎡"(licbyl2 17855137,
+      // 전 코퍼스 유일 출현). 실렌더가 진실이므로 방출하지 않는다 (v4.12.3, 종전 "-")
       case CHAR_HYPHEN:
-        result += "-";
         break;
       case CHAR_NBSP:
         result += "\xA0";
@@ -23055,6 +23056,36 @@ function validateGongmunOptions(opts) {
   if (opts.approval && opts.approval.length > 6) {
     throw new KordocError("approval must contain at most 6 labels");
   }
+  if (opts.levels) {
+    for (const [key, st] of Object.entries(opts.levels)) {
+      const depth = Number(key);
+      if (!Number.isInteger(depth) || depth < 0 || depth >= GONGMUN_LEVEL_COUNT) {
+        throw new KordocError(`levels: depth must be an integer between 0 and ${GONGMUN_LEVEL_COUNT - 1} (got "${key}")`);
+      }
+      if (!st || typeof st !== "object") throw new KordocError(`levels.${key} must be an object {font, pt, bold}`);
+      if (st.pt !== void 0) assertFiniteRange(`levels.${key}.pt`, st.pt, 6, 60);
+      if (st.font !== void 0 && (typeof st.font !== "string" || !st.font.trim())) {
+        throw new KordocError(`levels.${key}.font must be a non-empty string`);
+      }
+    }
+  }
+}
+var GONGMUN_LEVEL_COUNT = 8;
+function resolveLevels(levels, bodyHeight) {
+  if (!levels) return null;
+  const out = {};
+  for (const [key, st] of Object.entries(levels)) {
+    if (st.font === void 0 && st.pt === void 0 && st.bold === void 0) continue;
+    out[Number(key)] = {
+      font: st.font?.trim() || null,
+      height: st.pt !== void 0 ? Math.round(st.pt * 100) : bodyHeight,
+      bold: !!st.bold
+    };
+  }
+  return Object.keys(out).length > 0 ? out : null;
+}
+function levelMarkerHeight(g, depth) {
+  return g.levels?.[depth]?.height ?? g.bodyHeight;
 }
 function incompatibleGongmunWarnings(opts) {
   const warns = [];
@@ -23099,6 +23130,7 @@ function resolveGongmun(opts) {
     toc: preset !== "press" && (opts.toc ?? gaejosik),
     fonts: opts.fonts ?? {},
     sizes: opts.sizes ?? {},
+    levels: resolveLevels(opts.levels, Math.round(bodyPt * 100)),
     // 쪽번호 — 보고서 계열 관행(실측: 2_보고서 양식·추진계획·공고문 전부 하단 중앙)
     pageNumbers: opts.pageNumbers ?? (gaejosik || preset === "report" || preset === "plan"),
     // 머리말·꼬리말 — 실측: 보고서 계열 15mm(GT3·t2·춘천·브라더), 공고·보도 10mm,
@@ -23157,10 +23189,10 @@ function markerWidth(marker, bodyHeight) {
   for (const c of marker) em += charWidthEm1000(c.codePointAt(0));
   return Math.round(em / 1e3 * bodyHeight);
 }
-function levelIndent(depth, bodyHeight, numbering, sizes = {}, bullet2 = "\u25CB", asteriskThird = false) {
+function levelIndent(depth, bodyHeight, numbering, sizes = {}, bullet2 = "\u25CB", asteriskThird = false, markerHeight = bodyHeight) {
   if (numbering === "gaejosik") return gaejosikLevelIndent(depth, bodyHeight, sizes, bullet2);
   const marker = numbering === "report" ? reportMarker(depth, bullet2, asteriskThird) : standardMarker(depth, 0);
-  return { left: Math.round(depth * bodyHeight), indent: -markerWidth(marker, bodyHeight) };
+  return { left: Math.round(depth * bodyHeight), indent: -markerWidth(marker, markerHeight) };
 }
 function computeSuppression(depths) {
   const counts = /* @__PURE__ */ new Map();
@@ -23253,13 +23285,13 @@ function headingCharPrId(level) {
   if (level === 3) return CHAR_H3;
   return CHAR_H4;
 }
-function charPr(id, height, bold, italic, fontId = 0, textColor = DEFAULT_TEXT_COLOR, ratioPct = 100) {
+function charPr(id, height, bold, italic, fontId = 0, textColor = DEFAULT_TEXT_COLOR, ratioPct = 100, restFont = fontId) {
   const boldAttr = bold ? ` bold="1"` : "";
   const italicAttr = italic ? ` italic="1"` : "";
   const effFont = fontId;
   const boldEl = bold ? `<hh:bold/>` : "";
   return `      <hh:charPr id="${id}" height="${height}" textColor="${escapeXml(textColor)}" shadeColor="none" useFontSpace="0" useKerning="0" symMark="NONE" borderFillIDRef="1"${boldAttr}${italicAttr}>
-        <hh:fontRef hangul="${effFont}" latin="${effFont}" hanja="${effFont}" japanese="${effFont}" other="${effFont}" symbol="${effFont}" user="${effFont}"/>
+        <hh:fontRef hangul="${effFont}" latin="${effFont}" hanja="${restFont}" japanese="${restFont}" other="${restFont}" symbol="${restFont}" user="${restFont}"/>
         <hh:ratio hangul="${ratioPct}" latin="${ratioPct}" hanja="${ratioPct}" japanese="100" other="100" symbol="100" user="100"/>
         <hh:spacing hangul="0" latin="0" hanja="0" japanese="0" other="0" symbol="0" user="0"/>
         <hh:relSz hangul="100" latin="100" hanja="100" japanese="100" other="100" symbol="100" user="100"/>
@@ -23975,7 +24007,7 @@ ${base2.join("\n")}
   ];
   const listAlign = gongmun.numbering === "gaejosik" || gongmun.numbering === "report" ? "LEFT" : "JUSTIFY";
   for (let d = 0; d < GONGMUN_LIST_LEVELS; d++) {
-    const { left, indent } = levelIndent(d, gongmun.bodyHeight, gongmun.numbering, gongmun.sizes, gongmun.bullet2, usesAsteriskThird(gongmun.preset));
+    const { left, indent } = levelIndent(d, gongmun.bodyHeight, gongmun.numbering, gongmun.sizes, gongmun.bullet2, usesAsteriskThird(gongmun.preset), levelMarkerHeight(gongmun, d));
     const sectionGap = gongmun.numbering === "gaejosik" || gongmun.numbering === "report" ? gaejosikSpaceBefore(d, gongmun.bodyHeight) : 0;
     const keepNext = (gongmun.numbering === "gaejosik" || gongmun.numbering === "report") && d === 0;
     base.push(paraPr(GONGMUN_LIST_BASE + d, { align: listAlign, lineSpacing: ls, left, indent, spaceBefore: sectionGap, keepWord: true, keepWithNext: keepNext }));
@@ -24404,6 +24436,7 @@ function computeGongmunFitPlan(blocks, gongmun, gongmunList) {
     if (block.type === "list_item" && gongmunList.items.has(i)) {
       const { marker, depth, indentVariant } = gongmunList.items.get(i);
       if (gongmun.numbering === "gaejosik" && (depth === 0 || (block.text || "").trimStart().startsWith("\u203B"))) continue;
+      if (gongmun.levels?.[depth]) continue;
       const content = plainRenderText(block.text || "");
       text = marker ? `${marker} ${content}` : content;
       const li = levelIndent(depth, gongmun.bodyHeight, gongmun.numbering, gongmun.sizes, gongmun.bullet2, usesAsteriskThird(gongmun.preset));
@@ -24469,8 +24502,9 @@ function precomputeGongmunList(blocks, gongmun) {
   const variantIdx = /* @__PURE__ */ new Map();
   const variantOf = (marker, depth) => {
     if (!marker || gongmun.numbering !== "standard") return void 0;
-    const w = markerWidth(marker, gongmun.bodyHeight);
-    const rep = -levelIndent(depth, gongmun.bodyHeight, gongmun.numbering, gongmun.sizes, gongmun.bullet2, usesAsteriskThird(gongmun.preset)).indent;
+    const h = levelMarkerHeight(gongmun, depth);
+    const w = markerWidth(marker, h);
+    const rep = -levelIndent(depth, gongmun.bodyHeight, gongmun.numbering, gongmun.sizes, gongmun.bullet2, usesAsteriskThird(gongmun.preset), h).indent;
     if (w === rep) return void 0;
     const key = `${depth}:${w}`;
     let vi = variantIdx.get(key);
@@ -26649,6 +26683,11 @@ function renderListItem(block, blockIdx, ctx) {
         mapId = void 0;
       }
     }
+    const lv = ctx.levelIds?.[depth];
+    if (lv) {
+      listCharPr = lv.normal;
+      mapId = (id) => id === CHAR_BOLD ? lv.bold : id === CHAR_NORMAL ? lv.normal : id;
+    }
     return generateParagraph(text, listParaPr, listCharPr, mapId);
   }
   const indent = block.indent || 0;
@@ -26709,7 +26748,7 @@ function appendPostamble(blocks, ctx) {
     paraXmls.push(...buildPressContact(gongmun, dfIds, tableStyle.totalWidth, bfReg));
   }
 }
-function blocksToSectionXml(blocks, theme, gongmun, gongmunList = gongmun ? precomputeGongmunList(blocks, gongmun) : null, fit = null, chartParts = null, bfReg = null, remap = null, dfIds = null, images = null, page = null) {
+function blocksToSectionXml(blocks, theme, gongmun, gongmunList = gongmun ? precomputeGongmunList(blocks, gongmun) : null, fit = null, chartParts = null, bfReg = null, remap = null, dfIds = null, images = null, page = null, levelIds = null) {
   resetTableIds();
   resetGjTableIds();
   resetExtraTableIds();
@@ -26725,6 +26764,7 @@ function blocksToSectionXml(blocks, theme, gongmun, gongmunList = gongmun ? prec
     remap,
     dfIds,
     images,
+    levelIds,
     gaejosik: gongmun?.preset === "gaejosik",
     measured,
     richAssets,
@@ -26829,6 +26869,41 @@ function blocksToSectionXml(blocks, theme, gongmun, gongmunList = gongmun ? prec
 </hs:sec>`;
 }
 
+// src/hwpx/gen-levels.ts
+function levelDepths(g) {
+  return g.levels ? Object.keys(g.levels).map(Number).sort((a, b) => a - b) : [];
+}
+function levelFontFaces(g) {
+  const out = [];
+  for (const d of levelDepths(g)) {
+    const f = g.levels[d].font;
+    if (f && !out.includes(f)) out.push(f);
+  }
+  return out;
+}
+function levelCharIds(g, base) {
+  const depths = levelDepths(g);
+  if (depths.length === 0) return null;
+  const ids = {};
+  depths.forEach((d, i) => {
+    ids[d] = { normal: base + i * 2, bold: base + i * 2 + 1 };
+  });
+  return ids;
+}
+function levelCharPrXmls(g, base, fontBase, bodyFontId) {
+  const ids = levelCharIds(g, base);
+  if (!ids) return [];
+  const faces = levelFontFaces(g);
+  const out = [];
+  for (const d of levelDepths(g)) {
+    const st = g.levels[d];
+    const fontId = st.font ? fontBase + faces.indexOf(st.font) : bodyFontId;
+    out.push(charPr(ids[d].normal, st.height, st.bold, false, fontId, void 0, GONGMUN_BODY_RATIO, bodyFontId));
+    out.push(charPr(ids[d].bold, st.height, true, false, fontId, void 0, GONGMUN_BODY_RATIO, bodyFontId));
+  }
+  return out;
+}
+
 // src/hwpx/generator.ts
 async function markdownToHwpx(markdown, options) {
   const theme = resolveTheme(options?.theme);
@@ -26848,10 +26923,15 @@ async function markdownToHwpx(markdown, options) {
     const dfActive = !!gongmun && docframeActive(gongmun);
     const dfBase = charVariantBase(richAssets, !!gongmun) + (fit?.variants?.length ?? 0) * 4 + (remap?.charPrXmls.length ?? 0);
     const dfIds = dfActive ? docframeIds(dfBase) : null;
+    const dfXmls = dfActive ? docframeCharPrXmls(dfBase, richAssets) : [];
+    const lvBase = dfBase + dfXmls.length;
+    const lvIds = gongmun ? levelCharIds(gongmun, lvBase) : null;
+    const lvFonts = gongmun ? levelFontFaces(gongmun) : [];
+    const lvXmls = gongmun ? levelCharPrXmls(gongmun, lvBase, staticFontNext(gongmun) + (remap?.fontFaces.length ?? 0), richAssets ? 4 : 0) : [];
     const chartParts = [];
     const supplied = options?.images ? new Map(Object.entries(options.images).map(([k, v]) => [k, v instanceof Uint8Array ? v : new Uint8Array(v)])) : void 0;
     const images = new ImageRegistry(supplied);
-    const sectionXml = blocksToSectionXml(blocks, theme, gongmun, gongmunList, fit, chartParts, bfReg, remap, dfIds, images, page);
+    const sectionXml = blocksToSectionXml(blocks, theme, gongmun, gongmunList, fit, chartParts, bfReg, remap, dfIds, images, page, lvIds);
     if (remap && remap.tables.length > 0) {
       const unused = remap.tables.filter((t) => !t.used).length;
       if (unused === remap.tables.length) {
@@ -26869,9 +26949,9 @@ async function markdownToHwpx(markdown, options) {
       gongmun,
       fit?.variants ?? [],
       extraBorderFills,
-      [...remap?.charPrXmls ?? [], ...dfActive ? docframeCharPrXmls(dfBase, richAssets) : []],
+      [...remap?.charPrXmls ?? [], ...dfXmls, ...lvXmls],
       gongmunList?.indentVariants ?? [],
-      remap?.fontFaces ?? []
+      [...remap?.fontFaces ?? [], ...lvFonts]
     ));
     zip.file("Contents/section0.xml", sectionXml);
     for (const part of chartParts) zip.file(part.name, part.xml);
@@ -28023,10 +28103,12 @@ var DISCRIM_FIXES = [
 var DISCRIM_RE = new RegExp(DISCRIM_FIXES.map(([w]) => w).sort((a, b) => b.length - a.length).join("|"), "g");
 var RULES = [
   // 날짜 ─ 온점 뒤 한 칸, 0 패딩 금지, 연도 4자리, 끝 마침표
+  // 법령 연혁 표기 `<개정 2012.2.14>`·`삭제 <2016.2.29.>`·`[시행일:2017.9.8.]` 는 법제처 정본 형식(별지서식 표제) —
+  // 편람 날짜 규칙 대상이 아니다 (v4.12.3: 서식 595건 DATE 156건 전부 이 꼴, 기안문 0건)
   {
     code: "DATE_NO_SPACE",
     severity: "error",
-    pattern: /\b\d{4}\.\d{1,2}\.\d{1,2}\.?/g,
+    pattern: /(?<!<(?:개정|신설|전문개정|전부개정|일부개정|제정)\s*)(?<!삭제\s*<)(?<!시행일\s*:\s*)\b\d{4}\.\d{1,2}\.\d{1,2}\.?/g,
     message: "\uB0A0\uC9DC \uC628\uC810 \uB4A4\uC5D0 \uD55C \uCE78\uC529 \uB744\uC6CC\uC57C \uD568",
     suggest: "\uC608) 2025. 1. 6."
   },
@@ -28112,10 +28194,15 @@ var RULES = [
     suggest: "\uC608) \uC5C5\uBB34 \uD611\uC57D(MOU)"
   },
   // 쌍점 — URL(https:// 등)·시각(13:20)은 제외
+  // 편람: 쌍점은 앞말에 붙이고 뒤는 1타(원장: 김갑동). 표 셀은 제외(skipTable) — 법정 별지서식
+  // 자체가 "성 명 :"·"주 소 :" 라벨 셀을 쓰므로 서식 라벨은 이 규칙의 대상이 아니다(v4.12.3 실측:
+  // 서식 595건의 표 셀 801건 전부 라벨, 기안문 206건은 본문 414건이 "일 시 : 값" 꼴 — 편람상 위반).
+  // 뒤 글자에서 `<`(HTML 태그)·`*`·`_`(마크다운 강조 닫힘)는 제외 — "성명:</td>"·"과정:** 붙임" 오탐
   {
     code: "COLON_SPACE",
     severity: "warning",
-    pattern: /\S\s+:(?!\/\/)|\S:(?!\/\/)[^\s\d]/g,
+    skipTable: true,
+    pattern: /\S\s+:(?!\/\/)|\S:(?!\/\/)[^\s\d<*_]/g,
     message: "\uC30D\uC810\uC740 \uC55E\uB9D0\uC5D0 \uBD99\uC774\uACE0 \uB4A4\uB294 \uD55C \uCE78 \uB744\uC6C0",
     suggest: "\uC608) \uC6D0\uC7A5: \uAE40\uAC11\uB3D9"
   },
@@ -28195,7 +28282,9 @@ function lintGongmunText(text, opts) {
       continue;
     }
     if (fenceMarker !== null) continue;
+    const tableLine = /^\s*\|/.test(line) || /<t[dhr][\s>]/i.test(line);
     for (const r of RULES) {
+      if (r.skipTable && tableLine) continue;
       r.pattern.lastIndex = 0;
       for (const m of line.matchAll(r.pattern)) {
         findings.push({
@@ -32474,7 +32563,7 @@ async function dispatch(format, buffer, opts) {
 }
 async function parseImage(buffer, options) {
   try {
-    const { parseImageDocument } = await import("./image-ocr-CAVU2TNZ.js");
+    const { parseImageDocument } = await import("./image-ocr-OLTSKQWD.js");
     const { blocks, warnings } = await parseImageDocument(buffer, options);
     return {
       success: true,
@@ -32533,7 +32622,7 @@ async function parseHwp(buffer, options) {
 async function parsePdf(buffer, options) {
   let parsePdfDocument;
   try {
-    const mod = await import("./parser-GIREMEPD.js");
+    const mod = await import("./parser-JRT3B6OK.js");
     parsePdfDocument = mod.parsePdfDocument;
   } catch {
     return {