kordoc 3.16.0 → 3.16.1

package/dist/index.d.cts

@@ -365,8 +365,9 @@ declare class ValueCursor {
 declare function fillWithUniqueGuard<R extends {
     filled: Array<{
         key?: string;
+        label: string;
     }>;
-}>(values: Record<string, FillInput>, run: (vals: Record<string, FillInput>) => R | Promise<R>): Promise<R & {
+}>(values: Record<string, FillInput>, run: (vals: Record<string, FillInput>, blockedLabels?: Set<string>) => R | Promise<R>): Promise<R & {
     rejected: string[];
 }>;
 
@@ -443,7 +444,9 @@ interface FillResult {
  * })
  * ```
  */
-declare function fillFormFields(blocks: IRBlock[], values: Record<string, FillInput>): FillResult;
+declare function fillFormFields(blocks: IRBlock[], values: Record<string, FillInput>, 
+/** require_unique 2차에서 거부된 라벨 셀 차단 (sfill-2) — hwpx 경로와 동일 계약 */
+blockedLabels?: Set<string>): FillResult;
 
 /**
  * HWPX 원본 서식 유지 채우기 — section XML 오프셋 splice (v3.1, 바이트 보존)
@@ -486,7 +489,10 @@ interface HwpxFillResult {
  *   문자열이면 기존처럼 모든 등장에 동일값.
  * @returns HwpxFillResult
  */
-declare function fillHwpx(hwpxBuffer: ArrayBuffer, values: Record<string, FillInput>): Promise<HwpxFillResult>;
+declare function fillHwpx(hwpxBuffer: ArrayBuffer, values: Record<string, FillInput>, 
+/** 이 정규화 라벨의 셀은 어떤 키로도 채우지 않음 — require_unique 2차에서 거부된
+ *  라벨 셀이 접두사 매칭으로 남의 값에 오염되는 것을 차단 (sfill-2) */
+blockedLabels?: Set<string>): Promise<HwpxFillResult>;
 
 /**
  * place_seal — 도장/서명 이미지를 앵커 문구("(인)"·"서명 또는 인" 등) 위에
@@ -538,6 +544,8 @@ interface SealPlacement {
     sizeMm: number;
     /** ZIP에 추가된 이미지 파트 경로 (BinData/imageN.ext) */
     entry: string;
+    /** 근사 한계 경고 — 탭·줄바꿈 문단(seal-8), 중첩표(seal-2), 글상자(seal-3). 실측 전 근사. */
+    warnings?: string[];
 }
 interface PlaceSealResult {
     buffer: ArrayBuffer;

package/dist/index.d.ts

@@ -365,8 +365,9 @@ declare class ValueCursor {
 declare function fillWithUniqueGuard<R extends {
     filled: Array<{
         key?: string;
+        label: string;
     }>;
-}>(values: Record<string, FillInput>, run: (vals: Record<string, FillInput>) => R | Promise<R>): Promise<R & {
+}>(values: Record<string, FillInput>, run: (vals: Record<string, FillInput>, blockedLabels?: Set<string>) => R | Promise<R>): Promise<R & {
     rejected: string[];
 }>;
 
@@ -443,7 +444,9 @@ interface FillResult {
  * })
  * ```
  */
-declare function fillFormFields(blocks: IRBlock[], values: Record<string, FillInput>): FillResult;
+declare function fillFormFields(blocks: IRBlock[], values: Record<string, FillInput>, 
+/** require_unique 2차에서 거부된 라벨 셀 차단 (sfill-2) — hwpx 경로와 동일 계약 */
+blockedLabels?: Set<string>): FillResult;
 
 /**
  * HWPX 원본 서식 유지 채우기 — section XML 오프셋 splice (v3.1, 바이트 보존)
@@ -486,7 +489,10 @@ interface HwpxFillResult {
  *   문자열이면 기존처럼 모든 등장에 동일값.
  * @returns HwpxFillResult
  */
-declare function fillHwpx(hwpxBuffer: ArrayBuffer, values: Record<string, FillInput>): Promise<HwpxFillResult>;
+declare function fillHwpx(hwpxBuffer: ArrayBuffer, values: Record<string, FillInput>, 
+/** 이 정규화 라벨의 셀은 어떤 키로도 채우지 않음 — require_unique 2차에서 거부된
+ *  라벨 셀이 접두사 매칭으로 남의 값에 오염되는 것을 차단 (sfill-2) */
+blockedLabels?: Set<string>): Promise<HwpxFillResult>;
 
 /**
  * place_seal — 도장/서명 이미지를 앵커 문구("(인)"·"서명 또는 인" 등) 위에
@@ -538,6 +544,8 @@ interface SealPlacement {
     sizeMm: number;
     /** ZIP에 추가된 이미지 파트 경로 (BinData/imageN.ext) */
     entry: string;
+    /** 근사 한계 경고 — 탭·줄바꿈 문단(seal-8), 중첩표(seal-2), 글상자(seal-3). 실측 전 근사. */
+    warnings?: string[];
 }
 interface PlaceSealResult {
     buffer: ArrayBuffer;