hwpkit-dev 0.0.2 → 0.0.5

package/ .npmignore

@@ -9,4 +9,7 @@ dist
 tests
 data
 playground
-CLAUDE.*
+CLAUDE.*
+.c
+Tester.so.c
+*.hwp

package/README.md

@@ -23,13 +23,14 @@
 
 ## 변환 지원 현황
 
-| 입력 \ 출력 | HWPX | DOCX | Markdown |
-|------------|:----:|:----:|:--------:|
-| **HWPX**   | -    | O    | O        |
-| **HWP**    | O    | O    | O        |
-| **DOCX**   | O    | -    | O        |
-| **Markdown** | O  | O    | -        |
-
+| 입력 \ 출력 | HWPX | HWP | DOCX |
+|------------|:----:|:----:|:------:|
+| **HWPX**   |  O   |   X   |   O   |
+| **HWP**    |  O   |   X   |   O   |
+| **DOCX**   |  O   |   X   |   O   |
+| **Markdown** |O   |   X   |   △  |
+
+> 한글 2022기준 hwpx는 정상적으로 열림
 ---
 
 ## 설치
@@ -113,6 +114,42 @@ const doc = buildRoot({ title: '제목' }, [
 ]);
 ```
 
+### 스타일 적용
+
+```typescript
+// 텍스트 스타일
+buildSpan('스타일 적용 텍스트', {
+  font: 'Malgun Gothic',  // 글꼴
+  pt: 14,                 // 글자 크기 (pt)
+  b: true,                // 볼드
+  i: true,                // 이탤릭
+  u: true,                // 밑줄
+  s: true,                // 취소선
+  color: 'FF0000',        // 글색 (hex, BGR)
+  bg: 'FFFF00'           // 형광펜 (hex, BGR)
+});
+
+// 표 정렬 및 선 스타일
+buildGrid(rows, {
+  align: 'center',        // 표 정렬: 'left' | 'center' | 'right'
+  defaultStroke: {        // 기본 선 스타일
+    kind: 'solid',        // 선 종류: 'solid' | 'double' | 'dash' | 'dot'
+    pt: 1,                // 선 굵기 (pt)
+    color: '000000'       // 선 색상 (hex, BGR)
+  },
+  colWidths: [100, 100]   // 열 너비 (pt)
+});
+
+// 개별 셀의 선 스타일
+buildCell(content, {
+  top: { kind: 'double', pt: 2, color: '0000FF' },  // 상단 선
+  bot: { kind: 'dash', pt: 1.5, color: 'FF0000' },  // 하단 선
+  left: { kind: 'dot', pt: 1, color: '00FF00' },    // 좌측 선
+  right: { kind: 'solid', pt: 3, color: 'FFFF00' }, // 우측 선
+  bg: 'FFFFFF'                                        // 셀 배경색
+});
+```
+
 ### 트리 순회
 
 ```typescript

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-type Align = 'left' | 'center' | 'right' | 'justify';
-type ImgWrap = 'inline' | 'square' | 'tight' | 'through' | 'none' | 'behind' | 'front';
+type Align = 'left' | 'center' | 'right' | 'justify' | 'distribute' | 'distribute_space';
+type ImgWrap = 'inline' | 'square' | 'tight' | 'through' | 'none' | 'behind' | 'front' | 'topAndBottom';
 type ImgHorzAlign = 'left' | 'center' | 'right';
 type ImgVertAlign = 'top' | 'center' | 'bottom';
 type ImgHorzRelTo = 'margin' | 'column' | 'page' | 'para';
@@ -21,7 +21,7 @@ interface ImgLayout {
 }
 type VAlign = 'top' | 'mid' | 'bot';
 type Heading = 1 | 2 | 3 | 4 | 5 | 6;
-type StrokeKind = 'solid' | 'dash' | 'dot' | 'double' | 'none';
+type StrokeKind = 'solid' | 'dash' | 'dot' | 'double' | 'none' | 'dashDot' | 'dashDotDot' | 'wave';
 interface TextProps {
     b?: boolean;
     i?: boolean;
@@ -37,13 +37,21 @@ interface TextProps {
 interface ParaProps {
     align?: Align;
     heading?: Heading;
+    styleId?: string;
+    hwpStyleId?: number;
     indentPt?: number;
+    indentRightPt?: number;
+    firstLineIndentPt?: number;
+    leftMargin?: number;
     spaceBefore?: number;
     spaceAfter?: number;
     lineHeight?: number;
+    lineHeightFixed?: number;
     listLv?: number;
     listOrd?: boolean;
     listMark?: string;
+    verAlign?: 'baseline' | 'top' | 'center' | 'bottom';
+    lineWrap?: 'break' | 'squeeze' | 'keep';
 }
 interface Stroke {
     kind: StrokeKind;
@@ -57,6 +65,10 @@ interface CellProps {
     right?: Stroke;
     bg?: string;
     padPt?: number;
+    padT?: number;
+    padB?: number;
+    padL?: number;
+    padR?: number;
     align?: Align;
     va?: VAlign;
     isHeader?: boolean;
@@ -75,6 +87,7 @@ interface GridProps {
     defaultStroke?: Stroke;
     look?: TableLook;
     headerRow?: boolean;
+    align?: Align;
 }
 interface PageDims {
     wPt: number;
@@ -84,6 +97,8 @@ interface PageDims {
     ml: number;
     mr: number;
     orient?: 'portrait' | 'landscape';
+    headerPt?: number;
+    footerPt?: number;
 }
 interface DocMeta {
     title?: string;
@@ -93,6 +108,8 @@ interface DocMeta {
     keywords?: string;
     created?: string;
     modified?: string;
+    zoom?: number;
+    viewMode?: string;
 }
 declare const A4: PageDims;
 declare const A4_LANDSCAPE: PageDims;
@@ -117,7 +134,7 @@ interface PbNode {
 }
 interface PageNumNode {
     tag: 'pagenum';
-    format?: 'decimal' | 'roman' | 'romanCaps';
+    format?: 'decimal' | 'roman' | 'romanCaps' | 'total';
 }
 interface ImgNode {
     tag: 'img';
@@ -141,14 +158,14 @@ interface LinkNode {
 interface ParaNode {
     tag: 'para';
     props: ParaProps;
-    kids: (SpanNode | ImgNode | LinkNode)[];
+    kids: (SpanNode | ImgNode | LinkNode | GridNode | PageNumNode)[];
 }
 interface CellNode {
     tag: 'cell';
     cs: number;
     rs: number;
     props: CellProps;
-    kids: ParaNode[];
+    kids: (ParaNode | GridNode)[];
 }
 interface RowNode {
     tag: 'row';
@@ -165,8 +182,16 @@ interface SheetNode {
     tag: 'sheet';
     dims: PageDims;
     kids: ContentNode[];
-    header?: ParaNode[];
-    footer?: ParaNode[];
+    headers?: {
+        default?: ParaNode[];
+        first?: ParaNode[];
+        even?: ParaNode[];
+    };
+    footers?: {
+        default?: ParaNode[];
+        first?: ParaNode[];
+        even?: ParaNode[];
+    };
 }
 interface DocRoot {
     tag: 'root';
@@ -189,14 +214,19 @@ interface Fail {
 declare function succeed<T>(data: T, warns?: string[]): Ok<T>;
 declare function fail(error: string, warns?: string[]): Fail;
 
-interface Decoder {
+interface EncoderOptions {
+    [key: string]: any;
+}
+interface Encoder {
     readonly format: string;
-    decode(data: Uint8Array): Promise<Outcome<DocRoot>>;
+    readonly aliases?: string[];
+    encode(doc: DocRoot, options?: EncoderOptions): Promise<Outcome<Uint8Array>>;
 }
 
-interface Encoder {
+interface Decoder {
     readonly format: string;
-    encode(doc: DocRoot): Promise<Outcome<Uint8Array>>;
+    readonly aliases?: string[];
+    decode(data: Uint8Array): Promise<Outcome<DocRoot>>;
 }
 
 declare class Pipeline {
@@ -208,7 +238,7 @@ declare class Pipeline {
     /** File/Blob 비동기 입력 */
     static openAsync(input: File | Blob | Uint8Array | string, fmt?: string): Promise<Pipeline>;
     /** 목표 포맷으로 변환 */
-    to(targetFmt: string): Promise<Outcome<Uint8Array>>;
+    to(targetFmt: string, options?: EncoderOptions): Promise<Outcome<Uint8Array>>;
     /** DocRoot만 추출 (인코딩 없이) */
     inspect(): Promise<Outcome<DocRoot>>;
 }
@@ -227,8 +257,8 @@ declare const registry: FormatRegistry;
 
 declare function buildRoot(meta?: DocMeta, kids?: SheetNode[]): DocRoot;
 declare function buildSheet(kids?: ContentNode[], dims?: PageDims, opts?: {
-    header?: ParaNode[];
-    footer?: ParaNode[];
+    headers?: SheetNode["headers"];
+    footers?: SheetNode["footers"];
 }): SheetNode;
 declare function buildPageNum(format?: PageNumNode['format']): PageNumNode;
 declare function buildBr(): BrNode;
@@ -238,7 +268,7 @@ declare function buildSpan(content: string, props?: TextProps): SpanNode;
 declare function buildImg(b64: string, mime: ImgNode['mime'], w: number, h: number, alt?: string, layout?: ImgLayout): ImgNode;
 declare function buildGrid(kids: RowNode[], props?: GridProps): GridNode;
 declare function buildRow(kids: CellNode[], heightPt?: number): RowNode;
-declare function buildCell(kids: ParaNode[], opts?: {
+declare function buildCell(kids: (ParaNode | GridNode)[], opts?: {
     cs?: number;
     rs?: number;
     props?: CellProps;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-type Align = 'left' | 'center' | 'right' | 'justify';
-type ImgWrap = 'inline' | 'square' | 'tight' | 'through' | 'none' | 'behind' | 'front';
+type Align = 'left' | 'center' | 'right' | 'justify' | 'distribute' | 'distribute_space';
+type ImgWrap = 'inline' | 'square' | 'tight' | 'through' | 'none' | 'behind' | 'front' | 'topAndBottom';
 type ImgHorzAlign = 'left' | 'center' | 'right';
 type ImgVertAlign = 'top' | 'center' | 'bottom';
 type ImgHorzRelTo = 'margin' | 'column' | 'page' | 'para';
@@ -21,7 +21,7 @@ interface ImgLayout {
 }
 type VAlign = 'top' | 'mid' | 'bot';
 type Heading = 1 | 2 | 3 | 4 | 5 | 6;
-type StrokeKind = 'solid' | 'dash' | 'dot' | 'double' | 'none';
+type StrokeKind = 'solid' | 'dash' | 'dot' | 'double' | 'none' | 'dashDot' | 'dashDotDot' | 'wave';
 interface TextProps {
     b?: boolean;
     i?: boolean;
@@ -37,13 +37,21 @@ interface TextProps {
 interface ParaProps {
     align?: Align;
     heading?: Heading;
+    styleId?: string;
+    hwpStyleId?: number;
     indentPt?: number;
+    indentRightPt?: number;
+    firstLineIndentPt?: number;
+    leftMargin?: number;
     spaceBefore?: number;
     spaceAfter?: number;
     lineHeight?: number;
+    lineHeightFixed?: number;
     listLv?: number;
     listOrd?: boolean;
     listMark?: string;
+    verAlign?: 'baseline' | 'top' | 'center' | 'bottom';
+    lineWrap?: 'break' | 'squeeze' | 'keep';
 }
 interface Stroke {
     kind: StrokeKind;
@@ -57,6 +65,10 @@ interface CellProps {
     right?: Stroke;
     bg?: string;
     padPt?: number;
+    padT?: number;
+    padB?: number;
+    padL?: number;
+    padR?: number;
     align?: Align;
     va?: VAlign;
     isHeader?: boolean;
@@ -75,6 +87,7 @@ interface GridProps {
     defaultStroke?: Stroke;
     look?: TableLook;
     headerRow?: boolean;
+    align?: Align;
 }
 interface PageDims {
     wPt: number;
@@ -84,6 +97,8 @@ interface PageDims {
     ml: number;
     mr: number;
     orient?: 'portrait' | 'landscape';
+    headerPt?: number;
+    footerPt?: number;
 }
 interface DocMeta {
     title?: string;
@@ -93,6 +108,8 @@ interface DocMeta {
     keywords?: string;
     created?: string;
     modified?: string;
+    zoom?: number;
+    viewMode?: string;
 }
 declare const A4: PageDims;
 declare const A4_LANDSCAPE: PageDims;
@@ -117,7 +134,7 @@ interface PbNode {
 }
 interface PageNumNode {
     tag: 'pagenum';
-    format?: 'decimal' | 'roman' | 'romanCaps';
+    format?: 'decimal' | 'roman' | 'romanCaps' | 'total';
 }
 interface ImgNode {
     tag: 'img';
@@ -141,14 +158,14 @@ interface LinkNode {
 interface ParaNode {
     tag: 'para';
     props: ParaProps;
-    kids: (SpanNode | ImgNode | LinkNode)[];
+    kids: (SpanNode | ImgNode | LinkNode | GridNode | PageNumNode)[];
 }
 interface CellNode {
     tag: 'cell';
     cs: number;
     rs: number;
     props: CellProps;
-    kids: ParaNode[];
+    kids: (ParaNode | GridNode)[];
 }
 interface RowNode {
     tag: 'row';
@@ -165,8 +182,16 @@ interface SheetNode {
     tag: 'sheet';
     dims: PageDims;
     kids: ContentNode[];
-    header?: ParaNode[];
-    footer?: ParaNode[];
+    headers?: {
+        default?: ParaNode[];
+        first?: ParaNode[];
+        even?: ParaNode[];
+    };
+    footers?: {
+        default?: ParaNode[];
+        first?: ParaNode[];
+        even?: ParaNode[];
+    };
 }
 interface DocRoot {
     tag: 'root';
@@ -189,14 +214,19 @@ interface Fail {
 declare function succeed<T>(data: T, warns?: string[]): Ok<T>;
 declare function fail(error: string, warns?: string[]): Fail;
 
-interface Decoder {
+interface EncoderOptions {
+    [key: string]: any;
+}
+interface Encoder {
     readonly format: string;
-    decode(data: Uint8Array): Promise<Outcome<DocRoot>>;
+    readonly aliases?: string[];
+    encode(doc: DocRoot, options?: EncoderOptions): Promise<Outcome<Uint8Array>>;
 }
 
-interface Encoder {
+interface Decoder {
     readonly format: string;
-    encode(doc: DocRoot): Promise<Outcome<Uint8Array>>;
+    readonly aliases?: string[];
+    decode(data: Uint8Array): Promise<Outcome<DocRoot>>;
 }
 
 declare class Pipeline {
@@ -208,7 +238,7 @@ declare class Pipeline {
     /** File/Blob 비동기 입력 */
     static openAsync(input: File | Blob | Uint8Array | string, fmt?: string): Promise<Pipeline>;
     /** 목표 포맷으로 변환 */
-    to(targetFmt: string): Promise<Outcome<Uint8Array>>;
+    to(targetFmt: string, options?: EncoderOptions): Promise<Outcome<Uint8Array>>;
     /** DocRoot만 추출 (인코딩 없이) */
     inspect(): Promise<Outcome<DocRoot>>;
 }
@@ -227,8 +257,8 @@ declare const registry: FormatRegistry;
 
 declare function buildRoot(meta?: DocMeta, kids?: SheetNode[]): DocRoot;
 declare function buildSheet(kids?: ContentNode[], dims?: PageDims, opts?: {
-    header?: ParaNode[];
-    footer?: ParaNode[];
+    headers?: SheetNode["headers"];
+    footers?: SheetNode["footers"];
 }): SheetNode;
 declare function buildPageNum(format?: PageNumNode['format']): PageNumNode;
 declare function buildBr(): BrNode;
@@ -238,7 +268,7 @@ declare function buildSpan(content: string, props?: TextProps): SpanNode;
 declare function buildImg(b64: string, mime: ImgNode['mime'], w: number, h: number, alt?: string, layout?: ImgLayout): ImgNode;
 declare function buildGrid(kids: RowNode[], props?: GridProps): GridNode;
 declare function buildRow(kids: CellNode[], heightPt?: number): RowNode;
-declare function buildCell(kids: ParaNode[], opts?: {
+declare function buildCell(kids: (ParaNode | GridNode)[], opts?: {
     cs?: number;
     rs?: number;
     props?: CellProps;