hwpkit-dev 0.0.2 → 0.0.3

package/src/core/BaseDecoder.ts

@@ -0,0 +1,118 @@
+/**
+ * BaseDecoder - 모든 디코더의 기본 클래스
+ *
+ * 공통 로직을 제공하여 각 포맷별 디코더가 포맷 특유의 로직만 구현하도록 합니다.
+ */
+
+import type { Decoder } from '../contract/decoder';
+import type { Outcome } from '../contract/result';
+import type { DocRoot } from '../model/doc-tree';
+import { TextKit } from '../toolkit/TextKit';
+import { ArchiveKit } from '../toolkit/ArchiveKit';
+
+// ─── BaseDecoder ───────────────────────────────────
+
+export abstract class BaseDecoder implements Decoder {
+  readonly format: string = this.getFormat();
+  readonly aliases: string[] = this.getAliases();
+
+  /** 포맷 이름 반환 (하위 클래스에서 오버라이드) */
+  protected abstract getFormat(): string;
+
+  /** 별칭 목록 반환 (하위 클래스에서 필요 시 오버라이드) */
+  protected getAliases(): string[] { return []; }
+
+  /** 데이터 디코딩 (하위 클래스에서 오버라이드) */
+  abstract decode(data: Uint8Array): Promise<Outcome<DocRoot>>;
+
+  // ─── 공통 유틸리티 메서드 ──────────────────────────
+
+  /** 바이트를 UTF-8 문자열로 변환 */
+  protected bytesToString(data: Uint8Array): string {
+    return TextKit.decode(data);
+  }
+
+  /** 문자열을 UTF-8 바이트로 변환 */
+  protected stringToBytes(s: string): Uint8Array {
+    return TextKit.encode(s);
+  }
+
+  /** XML 이스케이프 */
+  protected escapeXml(s: string): string {
+    return TextKit.escapeXml(s);
+  }
+
+  /** XML 언이스케이프 */
+  protected unescapeXml(s: string): string {
+    return TextKit.unescapeXml(s);
+  }
+
+  /** base64 문자열을 Uint8Array 로 변환 */
+  protected base64ToBytes(b64: string): Uint8Array {
+    return TextKit.base64Decode(b64);
+  }
+
+  /** Uint8Array 를 base64 문자열로 변환 */
+  protected bytesToBase64(data: Uint8Array): string {
+    return TextKit.base64Encode(data);
+  }
+
+  /** ZIP 해제 */
+  protected async unzip(data: Uint8Array): Promise<Map<string, Uint8Array>> {
+    return ArchiveKit.unzip(data);
+  }
+
+  /** ZIP 압축 */
+  protected async zip(entries: { name: string; data: Uint8Array }[]): Promise<Uint8Array> {
+    return ArchiveKit.zip(entries);
+  }
+
+  /** inflate 해제 */
+  protected async inflate(data: Uint8Array): Promise<Uint8Array> {
+    return ArchiveKit.inflate(data);
+  }
+
+  /** deflate 압축 */
+  protected async deflate(data: Uint8Array): Promise<Uint8Array> {
+    return ArchiveKit.deflate(data);
+  }
+
+  /** 제어 문자 제거 */
+  protected stripControl(s: string): string {
+    return TextKit.stripControl(s);
+  }
+
+  /** 공백 정규화 */
+  protected normalizeWhitespace(s: string): string {
+    return TextKit.normalizeWhitespace(s);
+  }
+
+  /** XML 파싱 (DOMParser 사용) */
+  protected parseXml(xmlString: string): Document {
+    const parser = new DOMParser();
+    return parser.parseFromString(xmlString, 'text/xml');
+  }
+
+  /** XML 요소에서 텍스트 내용 추출 */
+  protected getTextContent(element: Element | null | undefined): string {
+    if (!element) return '';
+    return element.textContent ?? '';
+  }
+
+  /** XML 요소의 속성 값 추출 */
+  protected getAttr(element: Element | null | undefined, name: string): string | null {
+    return element?.getAttribute(name) ?? null;
+  }
+
+  /** XML 요소의 자식 요소 찾기 */
+  protected getChild(element: Element | null | undefined, tagName: string): Element | null {
+    if (!element) return null;
+    return element.querySelector(`>${tagName}`) ?? null;
+  }
+
+  /** XML 요소의 모든 자식 요소 찾기 */
+  protected getChildren(element: Element | null | undefined, tagName: string): Element[] {
+    if (!element) return [];
+    return Array.from(element.querySelectorAll(`>${tagName}`));
+  }
+}

package/src/core/BaseEncoder.ts

@@ -0,0 +1,146 @@
+/**
+ * BaseEncoder - 모든 인코더의 기본 클래스
+ *
+ * 공통 로직을 제공하여 각 포맷별 인코더가 포맷 특유의 로직만 구현하도록 합니다.
+ */
+
+import type { Encoder } from '../contract/encoder';
+import type { Outcome } from '../contract/result';
+import type { DocRoot, AnyNode, ImgNode } from '../model/doc-tree';
+import { TextKit } from '../toolkit/TextKit';
+import { ArchiveKit } from '../toolkit/ArchiveKit';
+
+// ─── 타입 정의 ───────────────────────────────────
+
+export interface ImageData {
+  node: ImgNode;
+  path: string;
+  data: Uint8Array;
+}
+
+export interface ZipEntry {
+  name: string;
+  data: Uint8Array;
+}
+
+// ─── BaseEncoder ───────────────────────────────
+
+export abstract class BaseEncoder implements Encoder {
+  readonly format: string = this.getFormat();
+  readonly aliases: string[] = this.getAliases();
+
+  /** 포맷 이름 반환 (하위 클래스에서 오버라이드) */
+  protected abstract getFormat(): string;
+
+  /** 별칭 목록 반환 (하위 클래스에서 필요 시 오버라이드) */
+  protected getAliases(): string[] { return []; }
+
+  /** 문서 인코딩 (하위 클래스에서 오버라이드) */
+  abstract encode(doc: DocRoot): Promise<Outcome<Uint8Array>>;
+
+  // ─── 공통 유틸리티 메서드 ───────────────────────────
+
+  /** 문서 내 모든 이미지 노드 수집 */
+  protected collectImages(doc: DocRoot): ImgNode[] {
+    const images: ImgNode[] = [];
+    this.collectImagesRecursive(doc, images);
+    return images;
+  }
+
+  /** 재귀적으로 이미지 수집 */
+  private collectImagesRecursive(node: AnyNode, images: ImgNode[]): void {
+    if (node.tag === 'img') {
+      images.push(node);
+      return;
+    }
+
+    const children = this.getChildren(node);
+    for (const child of children) {
+      this.collectImagesRecursive(child, images);
+    }
+  }
+
+  /** 노드의 자식 노드 반환 */
+  private getChildren(node: AnyNode): AnyNode[] {
+    switch (node.tag) {
+      case 'root':
+        return node.kids;
+      case 'sheet':
+        return [...node.kids, ...(node.headers?.default ?? []), ...(node.footers?.default ?? [])];
+      case 'para':
+        return node.kids;
+      case 'span':
+        return node.kids;
+      case 'link':
+        return node.kids;
+      case 'row':
+        return node.kids;
+      case 'cell':
+        return node.kids;
+      case 'grid':
+        return node.kids;
+      default:
+        return [];
+    }
+  }
+
+  /** base64 문자열을 Uint8Array 로 변환 */
+  protected base64ToBytes(b64: string): Uint8Array {
+    return TextKit.base64Decode(b64);
+  }
+
+  /** Uint8Array 를 base64 문자열로 변환 */
+  protected bytesToBase64(data: Uint8Array): string {
+    return TextKit.base64Encode(data);
+  }
+
+  /** XML 이스케이프 */
+  protected escapeXml(s: string): string {
+    return TextKit.escapeXml(s);
+  }
+
+  /** XML 언이스케이프 */
+  protected unescapeXml(s: string): string {
+    return TextKit.unescapeXml(s);
+  }
+
+  /** 문자열을 UTF-8 바이트로 변환 */
+  protected stringToBytes(s: string): Uint8Array {
+    return TextKit.encode(s);
+  }
+
+  /** 바이트를 UTF-8 문자열로 변환 */
+  protected bytesToString(data: Uint8Array): string {
+    return TextKit.decode(data);
+  }
+
+  /** ZIP 압축 */
+  protected async zip(entries: ZipEntry[]): Promise<Uint8Array> {
+    return ArchiveKit.zip(entries);
+  }
+
+  /** ZIP 해제 */
+  protected async unzip(data: Uint8Array): Promise<Map<string, Uint8Array>> {
+    return ArchiveKit.unzip(data);
+  }
+
+  /** deflate 압축 */
+  protected async deflate(data: Uint8Array): Promise<Uint8Array> {
+    return ArchiveKit.deflate(data);
+  }
+
+  /** inflate 해제 */
+  protected async inflate(data: Uint8Array): Promise<Uint8Array> {
+    return ArchiveKit.inflate(data);
+  }
+
+  /** 제어 문자 제거 */
+  protected stripControl(s: string): string {
+    return TextKit.stripControl(s);
+  }
+
+  /** 공백 정규화 */
+  protected normalizeWhitespace(s: string): string {
+    return TextKit.normalizeWhitespace(s);
+  }
+}