office-oxide 0.1.0 → 0.1.1

package/lib/index.cjs

@@ -60,6 +60,28 @@ const n = {
   extractText: lib.func('HeapStr office_extract_text(const char* path, _Out_ int* error_code)'),
   toMarkdown: lib.func('HeapStr office_to_markdown(const char* path, _Out_ int* error_code)'),
   toHtml: lib.func('HeapStr office_to_html(const char* path, _Out_ int* error_code)'),
+
+  // XLSX writer
+  xlsxWriterNew: lib.func('void* office_xlsx_writer_new()'),
+  xlsxWriterFree: lib.func('void office_xlsx_writer_free(void* handle)'),
+  xlsxWriterAddSheet: lib.func('uint32_t office_xlsx_writer_add_sheet(void* handle, const char* name)'),
+  xlsxSheetSetCell: lib.func('void office_xlsx_sheet_set_cell(void* handle, uint32_t sheet, uint32_t row, uint32_t col, int32_t value_type, const char* value_str, double value_num)'),
+  xlsxSheetSetCellStyled: lib.func('void office_xlsx_sheet_set_cell_styled(void* handle, uint32_t sheet, uint32_t row, uint32_t col, int32_t value_type, const char* value_str, double value_num, bool bold, const char* bg_color)'),
+  xlsxSheetMergeCells: lib.func('void office_xlsx_sheet_merge_cells(void* handle, uint32_t sheet, uint32_t row, uint32_t col, uint32_t row_span, uint32_t col_span)'),
+  xlsxSheetSetColumnWidth: lib.func('void office_xlsx_sheet_set_column_width(void* handle, uint32_t sheet, uint32_t col, double width)'),
+  xlsxWriterSave: lib.func('int32_t office_xlsx_writer_save(void* handle, const char* path, _Out_ int* error_code)'),
+  xlsxWriterToBytes: lib.func('uint8_t* office_xlsx_writer_to_bytes(void* handle, _Out_ size_t* out_len, _Out_ int* error_code)'),
+
+  // PPTX writer
+  pptxWriterNew: lib.func('void* office_pptx_writer_new()'),
+  pptxWriterFree: lib.func('void office_pptx_writer_free(void* handle)'),
+  pptxWriterSetPresentationSize: lib.func('void office_pptx_writer_set_presentation_size(void* handle, uint64_t cx, uint64_t cy)'),
+  pptxWriterAddSlide: lib.func('uint32_t office_pptx_writer_add_slide(void* handle)'),
+  pptxSlideSetTitle: lib.func('void office_pptx_slide_set_title(void* handle, uint32_t slide, const char* title)'),
+  pptxSlideAddText: lib.func('void office_pptx_slide_add_text(void* handle, uint32_t slide, const char* text)'),
+  pptxSlideAddImage: lib.func('void office_pptx_slide_add_image(void* handle, uint32_t slide, const uint8_t* data, size_t len, const char* format, int64_t x, int64_t y, uint64_t cx, uint64_t cy)'),
+  pptxWriterSave: lib.func('int32_t office_pptx_writer_save(void* handle, const char* path, _Out_ int* error_code)'),
+  pptxWriterToBytes: lib.func('uint8_t* office_pptx_writer_to_bytes(void* handle, _Out_ size_t* out_len, _Out_ int* error_code)'),
 };
 
 class OfficeOxideError extends Error {
@@ -159,7 +181,114 @@ function extractText(p) { return oneShot(n.extractText, 'extractText', p); }
 function toMarkdown(p) { return oneShot(n.toMarkdown, 'toMarkdown', p); }
 function toHtml(p) { return oneShot(n.toHtml, 'toHtml', p); }
 
+class XlsxWriter {
+  constructor() {
+    this._h = n.xlsxWriterNew();
+    if (!this._h) throw new OfficeOxideError(5, 'XlsxWriter.new');
+  }
+  _ensure() { if (!this._h) throw new Error('XlsxWriter is closed'); }
+  addSheet(name) {
+    this._ensure();
+    return n.xlsxWriterAddSheet(this._h, name);
+  }
+  setCell(sheet, row, col, value) {
+    this._ensure();
+    let t, s = null, num = 0;
+    if (value === null || value === undefined) t = 0;
+    else if (typeof value === 'string') { t = 1; s = value; }
+    else if (typeof value === 'number') { t = 2; num = value; }
+    else if (typeof value === 'boolean') { t = 2; num = value ? 1 : 0; }
+    else { t = 1; s = String(value); }
+    n.xlsxSheetSetCell(this._h, sheet, row, col, t, s, num);
+  }
+  setCellStyled(sheet, row, col, value, bold, bgColor) {
+    this._ensure();
+    let t, s = null, num = 0;
+    if (value === null || value === undefined) t = 0;
+    else if (typeof value === 'string') { t = 1; s = value; }
+    else if (typeof value === 'number') { t = 2; num = value; }
+    else { t = 1; s = String(value); }
+    n.xlsxSheetSetCellStyled(this._h, sheet, row, col, t, s, num, bold, bgColor || null);
+  }
+  mergeCells(sheet, row, col, rowSpan, colSpan) {
+    this._ensure();
+    n.xlsxSheetMergeCells(this._h, sheet, row, col, rowSpan, colSpan);
+  }
+  setColumnWidth(sheet, col, width) {
+    this._ensure();
+    n.xlsxSheetSetColumnWidth(this._h, sheet, col, width);
+  }
+  save(path) {
+    this._ensure();
+    const e = [0];
+    const rc = n.xlsxWriterSave(this._h, path, e);
+    if (rc !== 0) throw new OfficeOxideError(e[0], 'XlsxWriter.save');
+  }
+  toBytes() {
+    this._ensure();
+    const outLen = [0]; const e = [0];
+    const ptr = n.xlsxWriterToBytes(this._h, outLen, e);
+    if (!ptr) throw new OfficeOxideError(e[0], 'XlsxWriter.toBytes');
+    try {
+      return Buffer.from(koffi.decode(ptr, 'uint8_t', outLen[0]));
+    } finally {
+      freeBytesRaw(ptr, outLen[0]);
+    }
+  }
+  close() { if (this._h) { n.xlsxWriterFree(this._h); this._h = null; } }
+  [Symbol.dispose]() { this.close(); }
+}
+
+class PptxWriter {
+  constructor() {
+    this._h = n.pptxWriterNew();
+    if (!this._h) throw new OfficeOxideError(5, 'PptxWriter.new');
+  }
+  _ensure() { if (!this._h) throw new Error('PptxWriter is closed'); }
+  setPresentationSize(cx, cy) {
+    this._ensure();
+    n.pptxWriterSetPresentationSize(this._h, BigInt(cx), BigInt(cy));
+  }
+  addSlide() {
+    this._ensure();
+    return n.pptxWriterAddSlide(this._h);
+  }
+  setSlideTitle(slide, title) {
+    this._ensure();
+    n.pptxSlideSetTitle(this._h, slide, title);
+  }
+  addSlideText(slide, text) {
+    this._ensure();
+    n.pptxSlideAddText(this._h, slide, text);
+  }
+  addSlideImage(slide, data, format, x, y, cx, cy) {
+    this._ensure();
+    const buf = data instanceof Uint8Array ? data : new Uint8Array(data);
+    n.pptxSlideAddImage(this._h, slide, buf, buf.length, format, BigInt(x), BigInt(y), BigInt(cx), BigInt(cy));
+  }
+  save(path) {
+    this._ensure();
+    const e = [0];
+    const rc = n.pptxWriterSave(this._h, path, e);
+    if (rc !== 0) throw new OfficeOxideError(e[0], 'PptxWriter.save');
+  }
+  toBytes() {
+    this._ensure();
+    const outLen = [0]; const e = [0];
+    const ptr = n.pptxWriterToBytes(this._h, outLen, e);
+    if (!ptr) throw new OfficeOxideError(e[0], 'PptxWriter.toBytes');
+    try {
+      return Buffer.from(koffi.decode(ptr, 'uint8_t', outLen[0]));
+    } finally {
+      freeBytesRaw(ptr, outLen[0]);
+    }
+  }
+  close() { if (this._h) { n.pptxWriterFree(this._h); this._h = null; } }
+  [Symbol.dispose]() { this.close(); }
+}
+
 module.exports = {
   OfficeOxideError, Document, EditableDocument,
+  XlsxWriter, PptxWriter,
   version, detectFormat, extractText, toMarkdown, toHtml,
 };

package/lib/index.d.ts

@@ -35,3 +35,31 @@ export function detectFormat(path: string): DocumentFormat | null;
 export function extractText(path: string): string;
 export function toMarkdown(path: string): string;
 export function toHtml(path: string): string;
+
+export type ImageFormat = 'png' | 'jpeg' | 'jpg' | 'gif';
+
+export class XlsxWriter implements Disposable {
+  constructor();
+  addSheet(name: string): number;
+  setCell(sheet: number, row: number, col: number, value: CellValue): void;
+  setCellStyled(sheet: number, row: number, col: number, value: CellValue, bold: boolean, bgColor?: string | null): void;
+  mergeCells(sheet: number, row: number, col: number, rowSpan: number, colSpan: number): void;
+  setColumnWidth(sheet: number, col: number, width: number): void;
+  save(path: string): void;
+  toBytes(): Buffer;
+  close(): void;
+  [Symbol.dispose](): void;
+}
+
+export class PptxWriter implements Disposable {
+  constructor();
+  setPresentationSize(cx: number | bigint, cy: number | bigint): void;
+  addSlide(): number;
+  setSlideTitle(slide: number, title: string): void;
+  addSlideText(slide: number, text: string): void;
+  addSlideImage(slide: number, data: Uint8Array | Buffer, format: ImageFormat, x: number | bigint, y: number | bigint, cx: number | bigint, cy: number | bigint): void;
+  save(path: string): void;
+  toBytes(): Buffer;
+  close(): void;
+  [Symbol.dispose](): void;
+}

package/lib/index.js

@@ -5,6 +5,7 @@
 // (decoded and auto-freed via the `HeapStr` disposable type registered in
 // native.js). Errors surface as null returns + a non-zero error code.
 
+import koffi from 'koffi';
 import { native } from './native.js';
 
 export class OfficeOxideError extends Error {
@@ -171,3 +172,163 @@ export function createFromMarkdown(markdown, format, path) {
   const rc = native.createFromMarkdown(markdown, format, path, err);
   if (rc !== 0) throw new OfficeOxideError(err[0], 'createFromMarkdown');
 }
+
+export class XlsxWriter {
+  #handle;
+
+  constructor() {
+    this.#handle = native.xlsxWriterNew();
+    if (!this.#handle) throw new OfficeOxideError(5, 'XlsxWriter.new');
+  }
+
+  #ensure() {
+    if (!this.#handle) throw new Error('XlsxWriter is closed');
+  }
+
+  /** Add a worksheet; returns its 0-based index. */
+  addSheet(name) {
+    this.#ensure();
+    return native.xlsxWriterAddSheet(this.#handle, name);
+  }
+
+  /** Set a cell value. value: null | string | number | boolean */
+  setCell(sheet, row, col, value) {
+    this.#ensure();
+    let t, s = null, n = 0;
+    if (value === null || value === undefined) t = 0;
+    else if (typeof value === 'string') { t = 1; s = value; }
+    else if (typeof value === 'number') { t = 2; n = value; }
+    else if (typeof value === 'boolean') { t = 2; n = value ? 1 : 0; }
+    else { t = 1; s = String(value); }
+    native.xlsxSheetSetCell(this.#handle, sheet, row, col, t, s, n);
+  }
+
+  /** Set a cell with styling. bgColor: 6-char hex string or null. */
+  setCellStyled(sheet, row, col, value, bold, bgColor = null) {
+    this.#ensure();
+    let t, s = null, n = 0;
+    if (value === null || value === undefined) t = 0;
+    else if (typeof value === 'string') { t = 1; s = value; }
+    else if (typeof value === 'number') { t = 2; n = value; }
+    else { t = 1; s = String(value); }
+    native.xlsxSheetSetCellStyled(this.#handle, sheet, row, col, t, s, n, bold, bgColor);
+  }
+
+  /** Merge a rectangular range. rowSpan and colSpan must be >= 1. */
+  mergeCells(sheet, row, col, rowSpan, colSpan) {
+    this.#ensure();
+    native.xlsxSheetMergeCells(this.#handle, sheet, row, col, rowSpan, colSpan);
+  }
+
+  /** Set column width in Excel character units (e.g. 20.0). */
+  setColumnWidth(sheet, col, width) {
+    this.#ensure();
+    native.xlsxSheetSetColumnWidth(this.#handle, sheet, col, width);
+  }
+
+  save(path) {
+    this.#ensure();
+    const err = [0];
+    const rc = native.xlsxWriterSave(this.#handle, path, err);
+    if (rc !== 0) throw new OfficeOxideError(err[0], 'XlsxWriter.save');
+  }
+
+  toBytes() {
+    this.#ensure();
+    const outLen = [0];
+    const err = [0];
+    const ptr = native.xlsxWriterToBytes(this.#handle, outLen, err);
+    if (!ptr) throw new OfficeOxideError(err[0], 'XlsxWriter.toBytes');
+    try {
+      return Buffer.from(koffi.decode(ptr, 'uint8_t', outLen[0]));
+    } finally {
+      native.freeBytes(ptr, outLen[0]);
+    }
+  }
+
+  close() {
+    if (this.#handle) {
+      native.xlsxWriterFree(this.#handle);
+      this.#handle = null;
+    }
+  }
+
+  [Symbol.dispose]() { this.close(); }
+}
+
+export class PptxWriter {
+  #handle;
+
+  constructor() {
+    this.#handle = native.pptxWriterNew();
+    if (!this.#handle) throw new OfficeOxideError(5, 'PptxWriter.new');
+  }
+
+  #ensure() {
+    if (!this.#handle) throw new Error('PptxWriter is closed');
+  }
+
+  /** Override canvas size. 914400 EMU = 1 inch. */
+  setPresentationSize(cx, cy) {
+    this.#ensure();
+    native.pptxWriterSetPresentationSize(this.#handle, BigInt(cx), BigInt(cy));
+  }
+
+  /** Add a slide; returns its 0-based index. */
+  addSlide() {
+    this.#ensure();
+    return native.pptxWriterAddSlide(this.#handle);
+  }
+
+  /** Set the title of a slide. */
+  setSlideTitle(slide, title) {
+    this.#ensure();
+    native.pptxSlideSetTitle(this.#handle, slide, title);
+  }
+
+  /** Add a plain text paragraph to the slide body. */
+  addSlideText(slide, text) {
+    this.#ensure();
+    native.pptxSlideAddText(this.#handle, slide, text);
+  }
+
+  /**
+   * Embed an image on a slide.
+   * data: Buffer or Uint8Array; format: "png" | "jpeg" | "gif"
+   * x, y, cx, cy: EMU coordinates (914400 = 1 inch)
+   */
+  addSlideImage(slide, data, format, x, y, cx, cy) {
+    this.#ensure();
+    const buf = data instanceof Uint8Array ? data : new Uint8Array(data);
+    native.pptxSlideAddImage(this.#handle, slide, buf, buf.length, format, BigInt(x), BigInt(y), BigInt(cx), BigInt(cy));
+  }
+
+  save(path) {
+    this.#ensure();
+    const err = [0];
+    const rc = native.pptxWriterSave(this.#handle, path, err);
+    if (rc !== 0) throw new OfficeOxideError(err[0], 'PptxWriter.save');
+  }
+
+  toBytes() {
+    this.#ensure();
+    const outLen = [0];
+    const err = [0];
+    const ptr = native.pptxWriterToBytes(this.#handle, outLen, err);
+    if (!ptr) throw new OfficeOxideError(err[0], 'PptxWriter.toBytes');
+    try {
+      return Buffer.from(koffi.decode(ptr, 'uint8_t', outLen[0]));
+    } finally {
+      native.freeBytes(ptr, outLen[0]);
+    }
+  }
+
+  close() {
+    if (this.#handle) {
+      native.pptxWriterFree(this.#handle);
+      this.#handle = null;
+    }
+  }
+
+  [Symbol.dispose]() { this.close(); }
+}

package/lib/native.js

@@ -78,4 +78,26 @@ export const native = {
   toMarkdown: lib.func('HeapStr office_to_markdown(const char* path, _Out_ int* error_code)'),
   toHtml: lib.func('HeapStr office_to_html(const char* path, _Out_ int* error_code)'),
   createFromMarkdown: lib.func('int32_t office_create_from_markdown(const char* markdown, const char* format, const char* path, _Out_ int* error_code)'),
+
+  // XLSX writer
+  xlsxWriterNew: lib.func('void* office_xlsx_writer_new()'),
+  xlsxWriterFree: lib.func('void office_xlsx_writer_free(void* handle)'),
+  xlsxWriterAddSheet: lib.func('uint32_t office_xlsx_writer_add_sheet(void* handle, const char* name)'),
+  xlsxSheetSetCell: lib.func('void office_xlsx_sheet_set_cell(void* handle, uint32_t sheet, uint32_t row, uint32_t col, int32_t value_type, const char* value_str, double value_num)'),
+  xlsxSheetSetCellStyled: lib.func('void office_xlsx_sheet_set_cell_styled(void* handle, uint32_t sheet, uint32_t row, uint32_t col, int32_t value_type, const char* value_str, double value_num, bool bold, const char* bg_color)'),
+  xlsxSheetMergeCells: lib.func('void office_xlsx_sheet_merge_cells(void* handle, uint32_t sheet, uint32_t row, uint32_t col, uint32_t row_span, uint32_t col_span)'),
+  xlsxSheetSetColumnWidth: lib.func('void office_xlsx_sheet_set_column_width(void* handle, uint32_t sheet, uint32_t col, double width)'),
+  xlsxWriterSave: lib.func('int32_t office_xlsx_writer_save(void* handle, const char* path, _Out_ int* error_code)'),
+  xlsxWriterToBytes: lib.func('uint8_t* office_xlsx_writer_to_bytes(void* handle, _Out_ size_t* out_len, _Out_ int* error_code)'),
+
+  // PPTX writer
+  pptxWriterNew: lib.func('void* office_pptx_writer_new()'),
+  pptxWriterFree: lib.func('void office_pptx_writer_free(void* handle)'),
+  pptxWriterSetPresentationSize: lib.func('void office_pptx_writer_set_presentation_size(void* handle, uint64_t cx, uint64_t cy)'),
+  pptxWriterAddSlide: lib.func('uint32_t office_pptx_writer_add_slide(void* handle)'),
+  pptxSlideSetTitle: lib.func('void office_pptx_slide_set_title(void* handle, uint32_t slide, const char* title)'),
+  pptxSlideAddText: lib.func('void office_pptx_slide_add_text(void* handle, uint32_t slide, const char* text)'),
+  pptxSlideAddImage: lib.func('void office_pptx_slide_add_image(void* handle, uint32_t slide, const uint8_t* data, size_t len, const char* format, int64_t x, int64_t y, uint64_t cx, uint64_t cy)'),
+  pptxWriterSave: lib.func('int32_t office_pptx_writer_save(void* handle, const char* path, _Out_ int* error_code)'),
+  pptxWriterToBytes: lib.func('uint8_t* office_pptx_writer_to_bytes(void* handle, _Out_ size_t* out_len, _Out_ int* error_code)'),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "office-oxide",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Fast Office document processing (DOCX/XLSX/PPTX/DOC/XLS/PPT) for Node.js — native bindings backed by the Rust office_oxide library.",
   "license": "MIT OR Apache-2.0",
   "author": "Yury Fedoseev",