react-native-nitro-xlsx 0.1.1

package/nitrogen/generated/shared/c++/HybridXlsxWorksheetSpec.cpp

@@ -0,0 +1,69 @@
+///
+/// HybridXlsxWorksheetSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#include "HybridXlsxWorksheetSpec.hpp"
+
+namespace margelo::nitro::xlsx {
+
+  void HybridXlsxWorksheetSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("writeString", &HybridXlsxWorksheetSpec::writeString);
+      prototype.registerHybridMethod("writeNumber", &HybridXlsxWorksheetSpec::writeNumber);
+      prototype.registerHybridMethod("writeBoolean", &HybridXlsxWorksheetSpec::writeBoolean);
+      prototype.registerHybridMethod("writeBlank", &HybridXlsxWorksheetSpec::writeBlank);
+      prototype.registerHybridMethod("writeFormula", &HybridXlsxWorksheetSpec::writeFormula);
+      prototype.registerHybridMethod("writeFormulaNum", &HybridXlsxWorksheetSpec::writeFormulaNum);
+      prototype.registerHybridMethod("writeFormulaString", &HybridXlsxWorksheetSpec::writeFormulaString);
+      prototype.registerHybridMethod("writeFormulaBoolean", &HybridXlsxWorksheetSpec::writeFormulaBoolean);
+      prototype.registerHybridMethod("writeArrayFormula", &HybridXlsxWorksheetSpec::writeArrayFormula);
+      prototype.registerHybridMethod("writeDatetime", &HybridXlsxWorksheetSpec::writeDatetime);
+      prototype.registerHybridMethod("writeURL", &HybridXlsxWorksheetSpec::writeURL);
+      prototype.registerHybridMethod("setColumn", &HybridXlsxWorksheetSpec::setColumn);
+      prototype.registerHybridMethod("setRow", &HybridXlsxWorksheetSpec::setRow);
+      prototype.registerHybridMethod("mergeRange", &HybridXlsxWorksheetSpec::mergeRange);
+      prototype.registerHybridMethod("mergeRangeNum", &HybridXlsxWorksheetSpec::mergeRangeNum);
+      prototype.registerHybridMethod("insertImage", &HybridXlsxWorksheetSpec::insertImage);
+      prototype.registerHybridMethod("insertImageBuffer", &HybridXlsxWorksheetSpec::insertImageBuffer);
+      prototype.registerHybridMethod("autofilter", &HybridXlsxWorksheetSpec::autofilter);
+      prototype.registerHybridMethod("freezePanes", &HybridXlsxWorksheetSpec::freezePanes);
+      prototype.registerHybridMethod("splitPanes", &HybridXlsxWorksheetSpec::splitPanes);
+      prototype.registerHybridMethod("setTabColor", &HybridXlsxWorksheetSpec::setTabColor);
+      prototype.registerHybridMethod("hide", &HybridXlsxWorksheetSpec::hide);
+      prototype.registerHybridMethod("activate", &HybridXlsxWorksheetSpec::activate);
+      prototype.registerHybridMethod("setFirstSheet", &HybridXlsxWorksheetSpec::setFirstSheet);
+      prototype.registerHybridMethod("protect", &HybridXlsxWorksheetSpec::protect);
+      prototype.registerHybridMethod("setPortrait", &HybridXlsxWorksheetSpec::setPortrait);
+      prototype.registerHybridMethod("setLandscape", &HybridXlsxWorksheetSpec::setLandscape);
+      prototype.registerHybridMethod("setPaper", &HybridXlsxWorksheetSpec::setPaper);
+      prototype.registerHybridMethod("setHeader", &HybridXlsxWorksheetSpec::setHeader);
+      prototype.registerHybridMethod("setFooter", &HybridXlsxWorksheetSpec::setFooter);
+      prototype.registerHybridMethod("setPrintArea", &HybridXlsxWorksheetSpec::setPrintArea);
+      prototype.registerHybridMethod("fitToPages", &HybridXlsxWorksheetSpec::fitToPages);
+      prototype.registerHybridMethod("setZoom", &HybridXlsxWorksheetSpec::setZoom);
+      prototype.registerHybridMethod("setGridlines", &HybridXlsxWorksheetSpec::setGridlines);
+      prototype.registerHybridMethod("centerHorizontally", &HybridXlsxWorksheetSpec::centerHorizontally);
+      prototype.registerHybridMethod("centerVertically", &HybridXlsxWorksheetSpec::centerVertically);
+      prototype.registerHybridMethod("setOutline", &HybridXlsxWorksheetSpec::setOutline);
+      prototype.registerHybridMethod("setColumnHidden", &HybridXlsxWorksheetSpec::setColumnHidden);
+      prototype.registerHybridMethod("setRowHidden", &HybridXlsxWorksheetSpec::setRowHidden);
+      prototype.registerHybridMethod("getCellValue", &HybridXlsxWorksheetSpec::getCellValue);
+      prototype.registerHybridMethod("getCellString", &HybridXlsxWorksheetSpec::getCellString);
+      prototype.registerHybridMethod("getCellRawValue", &HybridXlsxWorksheetSpec::getCellRawValue);
+      prototype.registerHybridMethod("getCellType", &HybridXlsxWorksheetSpec::getCellType);
+      prototype.registerHybridMethod("getCellFormat", &HybridXlsxWorksheetSpec::getCellFormat);
+      prototype.registerHybridMethod("getRowCount", &HybridXlsxWorksheetSpec::getRowCount);
+      prototype.registerHybridMethod("getColumnCount", &HybridXlsxWorksheetSpec::getColumnCount);
+      prototype.registerHybridMethod("getLastRow", &HybridXlsxWorksheetSpec::getLastRow);
+      prototype.registerHybridMethod("getLastColumn", &HybridXlsxWorksheetSpec::getLastColumn);
+      prototype.registerHybridMethod("getName", &HybridXlsxWorksheetSpec::getName);
+    });
+  }
+
+} // namespace margelo::nitro::xlsx

package/nitrogen/generated/shared/c++/HybridXlsxWorksheetSpec.hpp

@@ -0,0 +1,120 @@
+///
+/// HybridXlsxWorksheetSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `HybridXlsxCellFormatSpec` to properly resolve imports.
+namespace margelo::nitro::xlsx { class HybridXlsxCellFormatSpec; }
+// Forward declaration of `CellType` to properly resolve imports.
+namespace margelo::nitro::xlsx { enum class CellType; }
+
+#include <string>
+#include <memory>
+#include "HybridXlsxCellFormatSpec.hpp"
+#include <optional>
+#include <NitroModules/ArrayBuffer.hpp>
+#include <NitroModules/Null.hpp>
+#include <variant>
+#include "CellType.hpp"
+
+namespace margelo::nitro::xlsx {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `XlsxWorksheet`
+   * Inherit this class to create instances of `HybridXlsxWorksheetSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridXlsxWorksheet: public HybridXlsxWorksheetSpec {
+   * public:
+   *   HybridXlsxWorksheet(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridXlsxWorksheetSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridXlsxWorksheetSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridXlsxWorksheetSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual void writeString(double row, double col, const std::string& value, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeNumber(double row, double col, double value, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeBoolean(double row, double col, bool value, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeBlank(double row, double col, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeFormula(double row, double col, const std::string& formula, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeFormulaNum(double row, double col, const std::string& formula, double number, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeFormulaString(double row, double col, const std::string& formula, const std::string& str, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeFormulaBoolean(double row, double col, const std::string& formula, bool boolVal, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeArrayFormula(double firstRow, double firstCol, double lastRow, double lastCol, const std::string& formula, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeDatetime(double row, double col, double datetime, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void writeURL(double row, double col, const std::string& url, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void setColumn(double firstCol, double lastCol, double width, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void setRow(double row, double height, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void mergeRange(double firstRow, double firstCol, double lastRow, double lastCol, const std::string& value, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void mergeRangeNum(double firstRow, double firstCol, double lastRow, double lastCol, double value, const std::optional<std::shared_ptr<HybridXlsxCellFormatSpec>>& format) = 0;
+      virtual void insertImage(double row, double col, const std::string& path, std::optional<double> xOffset, std::optional<double> yOffset, std::optional<double> xScale, std::optional<double> yScale) = 0;
+      virtual void insertImageBuffer(double row, double col, const std::shared_ptr<ArrayBuffer>& buffer, const std::string& extension, std::optional<double> xOffset, std::optional<double> yOffset, std::optional<double> xScale, std::optional<double> yScale) = 0;
+      virtual void autofilter(double firstRow, double firstCol, double lastRow, double lastCol) = 0;
+      virtual void freezePanes(double row, double col) = 0;
+      virtual void splitPanes(double row, double col) = 0;
+      virtual void setTabColor(double color) = 0;
+      virtual void hide() = 0;
+      virtual void activate() = 0;
+      virtual void setFirstSheet() = 0;
+      virtual void protect(const std::optional<std::string>& password) = 0;
+      virtual void setPortrait() = 0;
+      virtual void setLandscape() = 0;
+      virtual void setPaper(double paperType) = 0;
+      virtual void setHeader(const std::string& header) = 0;
+      virtual void setFooter(const std::string& footer) = 0;
+      virtual void setPrintArea(double firstRow, double firstCol, double lastRow, double lastCol) = 0;
+      virtual void fitToPages(double width, double height) = 0;
+      virtual void setZoom(double scale) = 0;
+      virtual void setGridlines(double option) = 0;
+      virtual void centerHorizontally() = 0;
+      virtual void centerVertically() = 0;
+      virtual void setOutline(double level) = 0;
+      virtual void setColumnHidden(double firstCol, double lastCol, bool hidden) = 0;
+      virtual void setRowHidden(double row, bool hidden) = 0;
+      virtual std::variant<bool, nitro::NullType, std::string, double> getCellValue(double row, double col) = 0;
+      virtual std::string getCellString(double row, double col) = 0;
+      virtual std::string getCellRawValue(double row, double col) = 0;
+      virtual CellType getCellType(double row, double col) = 0;
+      virtual std::shared_ptr<HybridXlsxCellFormatSpec> getCellFormat(double row, double col) = 0;
+      virtual double getRowCount() = 0;
+      virtual double getColumnCount() = 0;
+      virtual double getLastRow() = 0;
+      virtual double getLastColumn() = 0;
+      virtual std::string getName() = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "XlsxWorksheet";
+  };
+
+} // namespace margelo::nitro::xlsx

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "react-native-nitro-xlsx",
+  "version": "0.1.1",
+  "description": "Fast XLSX file reading and writing for React Native using OpenXLSX and Nitro Modules",
+  "license": "MIT",
+  "homepage": "https://github.com/zydbkqf/react-native-nitro-xlsx",
+  "author": "Denis Cheung (https://github.com/zydbkqf)",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "source": "src/index.ts",
+  "scripts": {
+    "specs": "nitrogen",
+    "test": "jest",
+    "test:cpp": "cd cpp/tests && [ -n \"$OPENXLSX_PATH\" ] || OPENXLSX_PATH=$HOME/OpenXLSX; cmake -B build -DOPENXLSX_PATH=$OPENXLSX_PATH && cmake --build build && cd build && ctest --output-on-failure",
+    "test:cpp:clean": "rm -rf cpp/tests/build"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": ">=0.78.0",
+    "react-native-nitro-modules": ">=0.35.8"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.4.2",
+    "nitrogen": "*",
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": ">=0.35.8",
+    "ts-jest": "^29.4.11",
+    "typescript": "5.4.5"
+  },
+  "files": [
+    "src",
+    "cpp",
+    "!cpp/tests",
+    "android",
+    "ios",
+    "nitro.json",
+    "nitrogen",
+    "NitroXlsx.podspec",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "packageManager": "yarn@4.17.1"
+}

package/src/__mocks__/react-native-nitro-modules.ts

@@ -0,0 +1,28 @@
+export type HybridObject<T> = object;
+
+export interface ArrayBuffer {
+  data(): Uint8Array;
+  size(): number;
+}
+
+export interface Promise<T> {
+  then<R>(onFulfilled: (value: T) => R): Promise<R>;
+  catch<R>(onRejected: (reason: any) => R): Promise<R>;
+  resolve(value: T): Promise<T>;
+  reject(reason: any): Promise<T>;
+  create(): Promise<T>;
+}
+
+export namespace margelo {
+  export namespace nitro {
+    export class HybridObject<T> {}
+  }
+}
+
+export const NitroModules = {
+  createHybridObject: <T>(name: string) => ({
+    createWorkbook: jest.fn(),
+    openWorkbook: jest.fn(),
+    openWorkbookFromBuffer: jest.fn(),
+  }),
+};

package/src/__mocks__/react-native.ts

@@ -0,0 +1 @@
+export {};

package/src/__tests__/index.test.ts

@@ -0,0 +1,141 @@
+import {
+  NitroXlsx,
+  Align,
+  VAlign,
+  Border,
+  Underline,
+  Script,
+  Pattern,
+  Paper,
+  Gridlines,
+  Colors,
+  NumFormat,
+  ImagePosition,
+} from '../index';
+
+describe('NitroXlsx', () => {
+  it('should export NitroXlsx object', () => {
+    expect(NitroXlsx).toBeDefined();
+    expect(typeof NitroXlsx).toBe('object');
+  });
+
+  it('should have createWorkbook method', () => {
+    expect(NitroXlsx.createWorkbook).toBeDefined();
+    expect(typeof NitroXlsx.createWorkbook).toBe('function');
+  });
+
+  it('should have openWorkbook method', () => {
+    expect(NitroXlsx.openWorkbook).toBeDefined();
+    expect(typeof NitroXlsx.openWorkbook).toBe('function');
+  });
+
+  it('should have openWorkbookFromBuffer method', () => {
+    expect(NitroXlsx.openWorkbookFromBuffer).toBeDefined();
+    expect(typeof NitroXlsx.openWorkbookFromBuffer).toBe('function');
+  });
+});
+
+describe('Constants', () => {
+  describe('Align', () => {
+    it('should export Align constants', () => {
+      expect(Align).toBeDefined();
+      expect(Align.GENERAL).toBe(0);
+      expect(Align.LEFT).toBe(1);
+      expect(Align.RIGHT).toBe(2);
+      expect(Align.CENTER).toBe(3);
+    });
+  });
+
+  describe('VAlign', () => {
+    it('should export VAlign constants', () => {
+      expect(VAlign).toBeDefined();
+      expect(VAlign.TOP).toBe(4);
+      expect(VAlign.CENTER).toBe(3);
+      expect(VAlign.BOTTOM).toBe(5);
+    });
+  });
+
+  describe('Border', () => {
+    it('should export Border constants', () => {
+      expect(Border).toBeDefined();
+      expect(Border.NONE).toBe(0);
+      expect(Border.THIN).toBe(1);
+      expect(Border.MEDIUM).toBe(2);
+      expect(Border.THICK).toBe(5);
+    });
+  });
+
+  describe('Underline', () => {
+    it('should export Underline constants', () => {
+      expect(Underline).toBeDefined();
+      expect(Underline.NONE).toBe(0);
+      expect(Underline.SINGLE).toBe(1);
+      expect(Underline.DOUBLE).toBe(2);
+    });
+  });
+
+  describe('Script', () => {
+    it('should export Script constants', () => {
+      expect(Script).toBeDefined();
+      expect(Script.BASELINE).toBe(0);
+      expect(Script.SUBSCRIPT).toBe(1);
+      expect(Script.SUPERSCRIPT).toBe(2);
+    });
+  });
+
+  describe('Pattern', () => {
+    it('should export Pattern constants', () => {
+      expect(Pattern).toBeDefined();
+      expect(Pattern.NONE).toBe(0);
+      expect(Pattern.SOLID).toBe(1);
+    });
+  });
+
+  describe('Paper', () => {
+    it('should export Paper constants', () => {
+      expect(Paper).toBeDefined();
+      expect(Paper.LETTER).toBe(1);
+      expect(Paper.A4).toBe(9);
+    });
+  });
+
+  describe('Gridlines', () => {
+    it('should export Gridlines constants', () => {
+      expect(Gridlines).toBeDefined();
+      expect(Gridlines.HIDE_ALL).toBe(0);
+      expect(Gridlines.SHOW_ALL).toBe(1);
+    });
+  });
+
+  describe('Colors', () => {
+    it('should export Colors constants', () => {
+      expect(Colors).toBeDefined();
+      expect(Colors.BLACK).toBe(0x000000);
+      expect(Colors.WHITE).toBe(0xFFFFFF);
+      expect(Colors.RED).toBe(0xFF0000);
+      expect(Colors.GREEN).toBe(0x00FF00);
+      expect(Colors.BLUE).toBe(0x0000FF);
+    });
+  });
+
+  describe('NumFormat', () => {
+    it('should export NumFormat constants', () => {
+      expect(NumFormat).toBeDefined();
+      expect(NumFormat.GENERAL).toBe(0);
+      expect(NumFormat.NUMBER).toBe(1);
+      expect(NumFormat.CURRENCY).toBe(5);
+      expect(NumFormat.PERCENT).toBe(9);
+      expect(NumFormat.DATE_1).toBe(15);
+      expect(NumFormat.TEXT).toBe(49);
+    });
+  });
+
+  describe('ImagePosition', () => {
+    it('should export ImagePosition constants', () => {
+      expect(ImagePosition).toBeDefined();
+      expect(ImagePosition.MOVE_AND_SIZE).toBe(1);
+      expect(ImagePosition.MOVE_DONT_SIZE).toBe(2);
+      expect(ImagePosition.DONT_MOVE_DONT_SIZE).toBe(3);
+    });
+  });
+});

package/src/index.ts

@@ -0,0 +1,195 @@
+import { NitroModules } from 'react-native-nitro-modules'
+import type { NitroXlsx as NitroXlsxSpec } from './specs/NitroXlsx.nitro'
+
+export const NitroXlsx = NitroModules.createHybridObject<NitroXlsxSpec>('NitroXlsx')
+
+export type { XlsxWorkbook, XlsxWorksheet, XlsxCellFormat } from './specs/NitroXlsx.nitro'
+
+// Cell alignment (based on OpenXLSX XLAlignmentStyle)
+export const Align = {
+  GENERAL: 0,
+  LEFT: 1,
+  RIGHT: 2,
+  CENTER: 3,
+  FILL: 6,
+  JUSTIFY: 7,
+  CENTER_CONTINUOUS: 8,
+  DISTRIBUTED: 9,
+} as const
+
+export const VAlign = {
+  TOP: 4,
+  CENTER: 3,
+  BOTTOM: 5,
+  JUSTIFY: 7,
+  DISTRIBUTED: 9,
+} as const
+
+// Border styles (based on OpenXLSX XLLineStyle)
+export const Border = {
+  NONE: 0,
+  THIN: 1,
+  MEDIUM: 2,
+  DASHED: 3,
+  DOTTED: 4,
+  THICK: 5,
+  DOUBLE: 6,
+  HAIR: 7,
+  MEDIUM_DASHED: 8,
+  DASH_DOT: 9,
+  MEDIUM_DASH_DOT: 10,
+  DASH_DOT_DOT: 11,
+  MEDIUM_DASH_DOT_DOT: 12,
+  SLANT_DASH_DOT: 13,
+} as const
+
+// Underline styles (based on OpenXLSX XLUnderlineStyle)
+export const Underline = {
+  NONE: 0,
+  SINGLE: 1,
+  DOUBLE: 2,
+} as const
+
+// Script styles (based on OpenXLSX XLVerticalAlignRunStyle)
+export const Script = {
+  BASELINE: 0,
+  SUBSCRIPT: 1,
+  SUPERSCRIPT: 2,
+} as const
+
+// Pattern fill styles (based on OpenXLSX XLPatternType)
+export const Pattern = {
+  NONE: 0,
+  SOLID: 1,
+  MEDIUM_GRAY: 2,
+  DARK_GRAY: 3,
+  LIGHT_GRAY: 4,
+  DARK_HORIZONTAL: 5,
+  DARK_VERTICAL: 6,
+  DARK_DOWN: 7,
+  DARK_UP: 8,
+  DARK_GRID: 9,
+  DARK_TRELLIS: 10,
+  LIGHT_HORIZONTAL: 11,
+  LIGHT_VERTICAL: 12,
+  LIGHT_DOWN: 13,
+  LIGHT_UP: 14,
+  LIGHT_GRID: 15,
+  LIGHT_TRELLIS: 16,
+  GRAY_125: 17,
+  GRAY_0625: 18,
+} as const
+
+// Paper types
+export const Paper = {
+  DEFAULT: 0,
+  LETTER: 1,
+  LETTER_SMALL: 2,
+  TABLOID: 3,
+  LEDGER: 4,
+  LEGAL: 5,
+  STATEMENT: 6,
+  EXECUTIVE: 7,
+  A3: 8,
+  A4: 9,
+  A4_SMALL: 10,
+  A5: 11,
+  B4: 12,
+  B5: 13,
+  FOLIO: 14,
+  QUARTO: 15,
+  SIZE10x14: 16,
+  SIZE11x17: 17,
+  NOTE: 18,
+  ENV_9: 19,
+  ENV_10: 20,
+  ENV_11: 21,
+  ENV_12: 22,
+  ENV_14: 23,
+  ENV_DL: 27,
+  ENV_C5: 28,
+  ENV_C3: 29,
+  ENV_C4: 30,
+  ENV_C6: 31,
+  ENV_C65: 32,
+  ENV_B4: 33,
+  ENV_B5: 34,
+  ENV_B6: 35,
+  ENV_ITALY: 36,
+  ENV_MONARCH: 37,
+  ENV_PERSONAL: 38,
+  ENV_US9: 39,
+  ENV_US10: 40,
+  ENV_US11: 41,
+  ENV_US12: 42,
+} as const
+
+// Gridline options
+export const Gridlines = {
+  HIDE_ALL: 0,
+  SHOW_ALL: 1,
+  SHOW_PRINT: 2,
+} as const
+
+// Common colors
+export const Colors = {
+  BLACK: 0x000000,
+  WHITE: 0xFFFFFF,
+  RED: 0xFF0000,
+  GREEN: 0x00FF00,
+  BLUE: 0x0000FF,
+  YELLOW: 0xFFFF00,
+  CYAN: 0x00FFFF,
+  MAGENTA: 0xFF00FF,
+  GRAY: 0x808080,
+  GREY: 0x808080,
+  ORANGE: 0xFFA500,
+  PURPLE: 0x800080,
+  PINK: 0xFFC0CB,
+  BROWN: 0xA52A2A,
+  LIME: 0x00FF00,
+  NAVY: 0x000080,
+  TEAL: 0x008080,
+  MAROON: 0x800000,
+  OLIVE: 0x808000,
+  SILVER: 0xC0C0C0,
+  AQUA: 0x00FFFF,
+  FUCHSIA: 0xFF00FF,
+} as const
+
+// Built-in number format indices
+export const NumFormat = {
+  GENERAL: 0,
+  NUMBER: 1,
+  NUMBER_2: 2,
+  NUMBER_SEP: 3,
+  NUMBER_SEP_2: 4,
+  CURRENCY: 5,
+  CURRENCY_2: 6,
+  CURRENCY_SYMBOL: 7,
+  CURRENCY_SYMBOL_2: 8,
+  PERCENT: 9,
+  PERCENT_2: 10,
+  SCIENTIFIC: 11,
+  SCIENTIFIC_2: 12,
+  FRACTION_1: 13,
+  FRACTION_2: 14,
+  DATE_1: 15,
+  DATE_2: 16,
+  DATE_3: 17,
+  DATE_4: 18,
+  DATE_5: 19,
+  TIME_1: 20,
+  TIME_2: 21,
+  TIME_3: 22,
+  TIME_4: 23,
+  DATETIME: 22,
+  TEXT: 49,
+} as const
+
+// Image object position
+export const ImagePosition = {
+  MOVE_AND_SIZE: 1,
+  MOVE_DONT_SIZE: 2,
+  DONT_MOVE_DONT_SIZE: 3,
+} as const