kordoc 4.7.3 → 4.8.0

package/dist/index.d.cts

@@ -274,11 +274,29 @@ interface ParseSuccess extends ParseResultBase {
     warnings?: ParseWarning[];
     /** 추출된 이미지 목록 — 마크다운에서 파일명으로 참조됨 */
     images?: ExtractedImage[];
+    /**
+     * 페이지별 마크다운 (#68) — `blocks` 의 `pageNumber` 로 갈라 페이지마다 다시
+     * 마크다운을 만든 것. 페이지 경계의 신뢰도는 `metadata.pageMode` 를 따른다
+     * ("layout" = 실제 페이지, "section" = 섹션 근사). `pages` 옵션으로 범위를
+     * 줄이면 그 범위만 담긴다. 페이지 번호를 매기지 않는 포맷(DOCX 등)에서는 없고,
+     * XLSX 는 `pageCount` 와 같은 의미로 시트 한 장이 한 쪽이다.
+     *
+     * 여러 페이지에 걸친 표는 시작 페이지 한 블록이라, 표가 이어지는 중간
+     * 페이지의 `markdown` 은 빈 문자열일 수 있다 (현 IR 구조의 한계).
+     */
+    pages?: PageMarkdown[];
     /** 페이지별 텍스트 품질 신호 — PDF에서만 제공 */
     pageQuality?: PageQuality[];
     /** 문서 단위 품질 요약 — PDF에서만 제공 */
     qualitySummary?: DocumentQualitySummary;
 }
+/** 페이지 한 장의 마크다운 (#68). ParseSuccess.pages 항목. */
+interface PageMarkdown {
+    /** 원본 페이지 번호 (1-based) */
+    pageNumber: number;
+    /** 그 페이지 블록만으로 만든 마크다운. 블록이 없으면 빈 문자열 */
+    markdown: string;
+}
 /** 페이지별 텍스트 품질 신호 (PDF 전용). 자세한 설명은 src/pdf/quality.ts */
 interface PageQuality {
     page: number;
@@ -1749,6 +1767,29 @@ declare function detectZipFormat(buffer: ArrayBuffer): Promise<"hwpx" | "xlsx" |
 
 declare function blocksToMarkdown(blocks: IRBlock[]): string;
 
+/**
+ * 페이지별 마크다운 사영 (#68)
+ *
+ * 문서를 다시 파싱하지 않고 이미 만들어진 `IRBlock.pageNumber` 로만 블록을 갈라
+ * 페이지마다 `blocksToMarkdown()` 을 돌린다. 페이지 번호의 신뢰도는 파서가
+ * 정하는 것이고(`metadata.pageMode` — "layout" 은 실제 페이지, "section" 은
+ * 섹션 근사), 여기서는 그 값을 그대로 존중한다.
+ */
+
+/**
+ * 블록을 페이지 번호로 묶어 페이지별 마크다운을 만든다.
+ *
+ * - 어떤 블록에도 페이지 번호가 없으면 `undefined` — 페이지 개념이 없는 포맷에
+ *   "전부 1페이지" 같은 없는 사실을 만들어 내지 않는다.
+ * - 번호가 없는 블록은 **직전 블록의 페이지로 이어붙인다.** 블록은 읽기 순서라
+ *   이게 원문 위치에 가장 가깝고, 무엇보다 어느 페이지에도 안 실려 조용히
+ *   사라지는 블록이 생기지 않는다. 선두의 번호 없는 블록은 첫 실번호 페이지로.
+ * - 관측된 최소~최대 페이지 사이의 빈 페이지도 항목으로 낸다. 여러 페이지에
+ *   걸친 표는 시작 페이지 한 블록이라 중간 페이지가 실제로 비어 있고, 이때
+ *   항목을 빼면 소비자가 배열 길이로 페이지 수를 셀 수 없다.
+ */
+declare function blocksToPages(blocks: IRBlock[]): PageMarkdown[] | undefined;
+
 /** kordoc 공용 유틸리티 */
 declare const VERSION: string;
 
@@ -1822,4 +1863,4 @@ interface FillFormOutput {
  */
 declare function fillForm(input: string | ArrayBuffer | Buffer, values: Record<string, FillInput>, outputFormat?: FillOutputFormat): Promise<FillFormOutput>;
 
-export { BUILTIN_TEMPLATES, type BlockCapability, type BlockCapabilityInfo, type BlockDiff, type BlockEdit, type BlockSourceRef, type BorderDef, type BorderFillDef, type BoundingBox, type BuiltinTemplate, type CellCapability, type CellContext, type CellDiff, type CellProfile, type CharPrDef, type ChunkOptions, type ClickHereField, DEFAULT_REDACT_RULES, type DiffChangeType, type DiffResult, type DocChunk, 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 PageOptions, 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 RedactHit, type RedactOptions, type RedactRule, type RedactTextResult, 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, blocksToChunks, blocksToMarkdown, blocksToPdf, buildParagraphSplices, buildRangeSplices, charWidthEm1000, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractClickHereFields, extractFormFields, extractFormSchema, fillForm, fillFormFields, fillHwpx, fillWithUniqueGuard, fitRatioForFewerLines, formatFillValue, gongmunLintWarnings, hwpxToProfile, incompatibleGongmunWarnings, inferFieldType, isHwpxFile, isKnownFont, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, lintGongmunText, markdownToHwpx, markdownToPdf, measureTextWidth, normalizeGongmunPreset, openHwpxDocument, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parseImage, parsePdf, parseXls, parseXlsx, patchHwp, patchHwpx, patchHwpxBlocks, placeSealHwpx, readBuiltinTemplate, readBuiltinTemplateSample, redactMarkdown, redactText, renderHtml, renderHwpxToSvg, resolveBuiltinTemplate, scanSectionXml, simulateWrap, simulateWrapKeepWord, unknownFontWarnings, validateHwpx };
+export { BUILTIN_TEMPLATES, type BlockCapability, type BlockCapabilityInfo, type BlockDiff, type BlockEdit, type BlockSourceRef, type BorderDef, type BorderFillDef, type BoundingBox, type BuiltinTemplate, type CellCapability, type CellContext, type CellDiff, type CellProfile, type CharPrDef, type ChunkOptions, type ClickHereField, DEFAULT_REDACT_RULES, type DiffChangeType, type DiffResult, type DocChunk, 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 PageMarkdown, type PageOptions, 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 RedactHit, type RedactOptions, type RedactRule, type RedactTextResult, 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, blocksToChunks, blocksToMarkdown, blocksToPages, blocksToPdf, buildParagraphSplices, buildRangeSplices, charWidthEm1000, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractClickHereFields, extractFormFields, extractFormSchema, fillForm, fillFormFields, fillHwpx, fillWithUniqueGuard, fitRatioForFewerLines, formatFillValue, gongmunLintWarnings, hwpxToProfile, incompatibleGongmunWarnings, inferFieldType, isHwpxFile, isKnownFont, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, lintGongmunText, markdownToHwpx, markdownToPdf, measureTextWidth, normalizeGongmunPreset, openHwpxDocument, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parseImage, parsePdf, parseXls, parseXlsx, patchHwp, patchHwpx, patchHwpxBlocks, placeSealHwpx, readBuiltinTemplate, readBuiltinTemplateSample, redactMarkdown, redactText, renderHtml, renderHwpxToSvg, resolveBuiltinTemplate, scanSectionXml, simulateWrap, simulateWrapKeepWord, unknownFontWarnings, validateHwpx };

package/dist/index.d.ts

@@ -274,11 +274,29 @@ interface ParseSuccess extends ParseResultBase {
     warnings?: ParseWarning[];
     /** 추출된 이미지 목록 — 마크다운에서 파일명으로 참조됨 */
     images?: ExtractedImage[];
+    /**
+     * 페이지별 마크다운 (#68) — `blocks` 의 `pageNumber` 로 갈라 페이지마다 다시
+     * 마크다운을 만든 것. 페이지 경계의 신뢰도는 `metadata.pageMode` 를 따른다
+     * ("layout" = 실제 페이지, "section" = 섹션 근사). `pages` 옵션으로 범위를
+     * 줄이면 그 범위만 담긴다. 페이지 번호를 매기지 않는 포맷(DOCX 등)에서는 없고,
+     * XLSX 는 `pageCount` 와 같은 의미로 시트 한 장이 한 쪽이다.
+     *
+     * 여러 페이지에 걸친 표는 시작 페이지 한 블록이라, 표가 이어지는 중간
+     * 페이지의 `markdown` 은 빈 문자열일 수 있다 (현 IR 구조의 한계).
+     */
+    pages?: PageMarkdown[];
     /** 페이지별 텍스트 품질 신호 — PDF에서만 제공 */
     pageQuality?: PageQuality[];
     /** 문서 단위 품질 요약 — PDF에서만 제공 */
     qualitySummary?: DocumentQualitySummary;
 }
+/** 페이지 한 장의 마크다운 (#68). ParseSuccess.pages 항목. */
+interface PageMarkdown {
+    /** 원본 페이지 번호 (1-based) */
+    pageNumber: number;
+    /** 그 페이지 블록만으로 만든 마크다운. 블록이 없으면 빈 문자열 */
+    markdown: string;
+}
 /** 페이지별 텍스트 품질 신호 (PDF 전용). 자세한 설명은 src/pdf/quality.ts */
 interface PageQuality {
     page: number;
@@ -1749,6 +1767,29 @@ declare function detectZipFormat(buffer: ArrayBuffer): Promise<"hwpx" | "xlsx" |
 
 declare function blocksToMarkdown(blocks: IRBlock[]): string;
 
+/**
+ * 페이지별 마크다운 사영 (#68)
+ *
+ * 문서를 다시 파싱하지 않고 이미 만들어진 `IRBlock.pageNumber` 로만 블록을 갈라
+ * 페이지마다 `blocksToMarkdown()` 을 돌린다. 페이지 번호의 신뢰도는 파서가
+ * 정하는 것이고(`metadata.pageMode` — "layout" 은 실제 페이지, "section" 은
+ * 섹션 근사), 여기서는 그 값을 그대로 존중한다.
+ */
+
+/**
+ * 블록을 페이지 번호로 묶어 페이지별 마크다운을 만든다.
+ *
+ * - 어떤 블록에도 페이지 번호가 없으면 `undefined` — 페이지 개념이 없는 포맷에
+ *   "전부 1페이지" 같은 없는 사실을 만들어 내지 않는다.
+ * - 번호가 없는 블록은 **직전 블록의 페이지로 이어붙인다.** 블록은 읽기 순서라
+ *   이게 원문 위치에 가장 가깝고, 무엇보다 어느 페이지에도 안 실려 조용히
+ *   사라지는 블록이 생기지 않는다. 선두의 번호 없는 블록은 첫 실번호 페이지로.
+ * - 관측된 최소~최대 페이지 사이의 빈 페이지도 항목으로 낸다. 여러 페이지에
+ *   걸친 표는 시작 페이지 한 블록이라 중간 페이지가 실제로 비어 있고, 이때
+ *   항목을 빼면 소비자가 배열 길이로 페이지 수를 셀 수 없다.
+ */
+declare function blocksToPages(blocks: IRBlock[]): PageMarkdown[] | undefined;
+
 /** kordoc 공용 유틸리티 */
 declare const VERSION: string;
 
@@ -1822,4 +1863,4 @@ interface FillFormOutput {
  */
 declare function fillForm(input: string | ArrayBuffer | Buffer, values: Record<string, FillInput>, outputFormat?: FillOutputFormat): Promise<FillFormOutput>;
 
-export { BUILTIN_TEMPLATES, type BlockCapability, type BlockCapabilityInfo, type BlockDiff, type BlockEdit, type BlockSourceRef, type BorderDef, type BorderFillDef, type BoundingBox, type BuiltinTemplate, type CellCapability, type CellContext, type CellDiff, type CellProfile, type CharPrDef, type ChunkOptions, type ClickHereField, DEFAULT_REDACT_RULES, type DiffChangeType, type DiffResult, type DocChunk, 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 PageOptions, 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 RedactHit, type RedactOptions, type RedactRule, type RedactTextResult, 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, blocksToChunks, blocksToMarkdown, blocksToPdf, buildParagraphSplices, buildRangeSplices, charWidthEm1000, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractClickHereFields, extractFormFields, extractFormSchema, fillForm, fillFormFields, fillHwpx, fillWithUniqueGuard, fitRatioForFewerLines, formatFillValue, gongmunLintWarnings, hwpxToProfile, incompatibleGongmunWarnings, inferFieldType, isHwpxFile, isKnownFont, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, lintGongmunText, markdownToHwpx, markdownToPdf, measureTextWidth, normalizeGongmunPreset, openHwpxDocument, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parseImage, parsePdf, parseXls, parseXlsx, patchHwp, patchHwpx, patchHwpxBlocks, placeSealHwpx, readBuiltinTemplate, readBuiltinTemplateSample, redactMarkdown, redactText, renderHtml, renderHwpxToSvg, resolveBuiltinTemplate, scanSectionXml, simulateWrap, simulateWrapKeepWord, unknownFontWarnings, validateHwpx };
+export { BUILTIN_TEMPLATES, type BlockCapability, type BlockCapabilityInfo, type BlockDiff, type BlockEdit, type BlockSourceRef, type BorderDef, type BorderFillDef, type BoundingBox, type BuiltinTemplate, type CellCapability, type CellContext, type CellDiff, type CellProfile, type CharPrDef, type ChunkOptions, type ClickHereField, DEFAULT_REDACT_RULES, type DiffChangeType, type DiffResult, type DocChunk, 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 PageMarkdown, type PageOptions, 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 RedactHit, type RedactOptions, type RedactRule, type RedactTextResult, 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, blocksToChunks, blocksToMarkdown, blocksToPages, blocksToPdf, buildParagraphSplices, buildRangeSplices, charWidthEm1000, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractClickHereFields, extractFormFields, extractFormSchema, fillForm, fillFormFields, fillHwpx, fillWithUniqueGuard, fitRatioForFewerLines, formatFillValue, gongmunLintWarnings, hwpxToProfile, incompatibleGongmunWarnings, inferFieldType, isHwpxFile, isKnownFont, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, lintGongmunText, markdownToHwpx, markdownToPdf, measureTextWidth, normalizeGongmunPreset, openHwpxDocument, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parseImage, parsePdf, parseXls, parseXlsx, patchHwp, patchHwpx, patchHwpxBlocks, placeSealHwpx, readBuiltinTemplate, readBuiltinTemplateSample, redactMarkdown, redactText, renderHtml, renderHwpxToSvg, resolveBuiltinTemplate, scanSectionXml, simulateWrap, simulateWrapKeepWord, unknownFontWarnings, validateHwpx };

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   flattenLayoutTables,
   inlineImagesIntoMarkdown,
   mapPuaText
-} from "./chunk-P663PYWV.js";
+} from "./chunk-NFCQ5XNT.js";
 import {
   parsePageRange
 } from "./chunk-GE43BE46.js";
@@ -16,7 +16,7 @@ import {
   HEADING_RATIO_H1,
   HEADING_RATIO_H2,
   HEADING_RATIO_H3
-} from "./chunk-KSATSTC5.js";
+} from "./chunk-BN33O25L.js";
 import {
   KordocError,
   VERSION,
@@ -29,7 +29,7 @@ import {
   sanitizeHref,
   stripDtd,
   toArrayBuffer
-} from "./chunk-46F5RMU7.js";
+} from "./chunk-S4SMUQAT.js";
 
 // src/index.ts
 import { readFile } from "fs/promises";
@@ -22205,6 +22205,29 @@ async function fillHwpx(hwpxBuffer, values, blockedLabels) {
   };
 }
 
+// src/page-markdown.ts
+function blocksToPages(blocks) {
+  const firstNumbered = blocks.find((b) => typeof b.pageNumber === "number")?.pageNumber;
+  if (firstNumbered === void 0) return void 0;
+  const byPage = /* @__PURE__ */ new Map();
+  let current = firstNumbered;
+  for (const block of blocks) {
+    if (typeof block.pageNumber === "number") current = block.pageNumber;
+    const bucket = byPage.get(current);
+    if (bucket) bucket.push(block);
+    else byPage.set(current, [block]);
+  }
+  const numbers = [...byPage.keys()];
+  const min = Math.min(...numbers);
+  const max = Math.max(...numbers);
+  const pages = [];
+  for (let pageNumber = min; pageNumber <= max; pageNumber++) {
+    const pageBlocks = byPage.get(pageNumber);
+    pages.push({ pageNumber, markdown: pageBlocks ? blocksToMarkdown(pageBlocks) : "" });
+  }
+  return pages;
+}
+
 // src/hwpx/generator.ts
 import JSZip8 from "jszip";
 
@@ -31611,6 +31634,14 @@ async function parse(input, options) {
     return { success: false, fileType: "unknown", error: "\uBE48 \uBC84\uD37C\uC774\uAC70\uB098 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uC785\uB825\uC785\uB2C8\uB2E4.", code: "EMPTY_INPUT" };
   }
   const format = detectFormat(buffer);
+  const result = await dispatch(format, buffer, opts);
+  if (result.success && !result.pages) {
+    const pages = blocksToPages(result.blocks);
+    if (pages) return { ...result, pages };
+  }
+  return result;
+}
+async function dispatch(format, buffer, opts) {
   switch (format) {
     case "hwpx": {
       const zipFormat = await detectZipFormat(buffer);
@@ -31637,7 +31668,7 @@ async function parse(input, options) {
 }
 async function parseImage(buffer, options) {
   try {
-    const { parseImageDocument } = await import("./image-ocr-XHBZONFZ.js");
+    const { parseImageDocument } = await import("./image-ocr-XRVXVYKO.js");
     const { blocks, warnings } = await parseImageDocument(buffer, options);
     return {
       success: true,
@@ -31696,7 +31727,7 @@ async function parseHwp(buffer, options) {
 async function parsePdf(buffer, options) {
   let parsePdfDocument;
   try {
-    const mod = await import("./parser-Z36MZUHS.js");
+    const mod = await import("./parser-5MLJHSRX.js");
     parsePdfDocument = mod.parsePdfDocument;
   } catch {
     return {
@@ -31797,6 +31828,7 @@ export {
   applySplices,
   blocksToChunks,
   blocksToMarkdown,
+  blocksToPages,
   blocksToPdf,
   buildParagraphSplices,
   buildRangeSplices,