@heripo/model 0.1.48 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ko.md CHANGED
@@ -68,7 +68,7 @@ import type { DoclingDocument } from '@heripo/model';
68
68
  - `texts`, `pictures`, `tables`: 추출된 content node
69
69
  - `pages`: 페이지 metadata와 렌더링된 페이지 이미지 참조
70
70
 
71
- `DoclingReference.$ref`와 각 노드의 `self_ref`로 원천 노드를 연결합니다. `DoclingProv.page_no`와 처리 모델의 `pdfPageNo`는 1부터 시작하지만 렌더링 파일은 `pages/page_0.png`부터 시작합니다. `Chapter.pageNo`와 `PageRange`는 인쇄된 문서의 논리 페이지 번호이므로 PDF 페이지 번호와 구분하세요. `DoclingBBox.coord_origin`을 확인한 뒤 좌표를 해석해야 합니다.
71
+ `DoclingReference.$ref`와 각 노드의 `self_ref`로 원천 노드를 연결합니다. `DoclingProv.page_no`와 처리 모델의 `pdfPageNo`는 1부터 시작하지만 렌더링 파일은 `pages/page_0.png`부터 시작합니다. `Chapter.pageNo`와 `PageRange`는 본문 1쪽 기준의 논리 페이지 번호이므로 PDF 페이지 번호와 구분하세요. `DoclingBBox.coord_origin`을 확인한 뒤 좌표를 해석해야 합니다.
72
72
 
73
73
  ### ProcessedDocument
74
74
 
@@ -215,6 +215,8 @@ interface Caption {
215
215
 
216
216
  PDF 페이지와 문서 페이지 매핑입니다.
217
217
 
218
+ PDF 물리 페이지는 1부터 시작합니다. 논리 페이지는 본문 1쪽을 기준으로 앞쪽도 연속해서 매기므로 `-2, -1, 0, 1` 같은 모든 정수를 허용합니다. `Chapter.pageNo`도 같은 논리 번호를 사용하며, 범위는 `startPageNo <= endPageNo`여야 합니다.
219
+
218
220
  ```typescript
219
221
  import type { PageRange } from '@heripo/model';
220
222
 
package/README.md CHANGED
@@ -215,6 +215,8 @@ interface Caption {
215
215
 
216
216
  PDF page to document page mapping.
217
217
 
218
+ Physical PDF pages start at 1. Logical pages count continuously relative to body page 1, so signed integers such as `-2, -1, 0, 1` are valid. `Chapter.pageNo` uses the same logical numbering, and ranges must satisfy `startPageNo <= endPageNo`.
219
+
218
220
  ```typescript
219
221
  import type { PageRange } from '@heripo/model';
220
222
 
package/dist/index.d.cts CHANGED
@@ -181,12 +181,12 @@ interface Caption {
181
181
  */
182
182
  interface PageRange {
183
183
  /**
184
- * Starting page number in the actual document (inclusive)
184
+ * Starting logical page number (inclusive). Signed integers count from body page 1.
185
185
  * @type {number}
186
186
  */
187
187
  startPageNo: number;
188
188
  /**
189
- * Ending page number in the actual document (inclusive)
189
+ * Ending logical page number (inclusive). Zero and negative values identify front matter.
190
190
  * @type {number}
191
191
  */
192
192
  endPageNo: number;
@@ -280,7 +280,7 @@ interface Chapter {
280
280
  */
281
281
  title: string;
282
282
  /**
283
- * Page number in the actual document (page where this chapter starts)
283
+ * Signed logical page number where this chapter starts, relative to body page 1
284
284
  * @type {number}
285
285
  */
286
286
  pageNo: number;
package/dist/index.d.ts CHANGED
@@ -181,12 +181,12 @@ interface Caption {
181
181
  */
182
182
  interface PageRange {
183
183
  /**
184
- * Starting page number in the actual document (inclusive)
184
+ * Starting logical page number (inclusive). Signed integers count from body page 1.
185
185
  * @type {number}
186
186
  */
187
187
  startPageNo: number;
188
188
  /**
189
- * Ending page number in the actual document (inclusive)
189
+ * Ending logical page number (inclusive). Zero and negative values identify front matter.
190
190
  * @type {number}
191
191
  */
192
192
  endPageNo: number;
@@ -280,7 +280,7 @@ interface Chapter {
280
280
  */
281
281
  title: string;
282
282
  /**
283
- * Page number in the actual document (page where this chapter starts)
283
+ * Signed logical page number where this chapter starts, relative to body page 1
284
284
  * @type {number}
285
285
  */
286
286
  pageNo: number;
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@heripo/model",
3
3
  "private": false,
4
4
  "type": "module",
5
- "version": "0.1.48",
5
+ "version": "0.2.1",
6
6
  "description": "Document models and type definitions for heripo engine",
7
7
  "main": "dist/index.cjs",
8
8
  "module": "dist/index.js",