sheetra 1.0.0

package/dist/types/types/workbook.types.d.ts

@@ -0,0 +1,500 @@
+import { CellData, CellStyle, DataValidation, ConditionalFormatRule } from './cell.types';
+/**
+ * Row properties
+ */
+export interface RowProperties {
+    /** Row height in points */
+    height?: number;
+    /** Hidden row */
+    hidden?: boolean;
+    /** Outline level (for grouping) */
+    outlineLevel?: number;
+    /** Collapsed state */
+    collapsed?: boolean;
+    /** Custom row style */
+    style?: CellStyle;
+    /** Row page break */
+    pageBreak?: boolean;
+    /** Phonetic (for Asian languages) */
+    phonetic?: boolean;
+}
+/**
+ * Row data structure
+ */
+export interface RowData extends RowProperties {
+    /** Cells in the row */
+    cells: CellData[];
+}
+/**
+ * Column properties
+ */
+export interface ColumnProperties {
+    /** Column width in characters */
+    width?: number;
+    /** Hidden column */
+    hidden?: boolean;
+    /** Outline level (for grouping) */
+    outlineLevel?: number;
+    /** Collapsed state */
+    collapsed?: boolean;
+    /** Custom column style */
+    style?: CellStyle;
+    /** Column page break */
+    pageBreak?: boolean;
+    /** Best fit width */
+    bestFit?: boolean;
+    /** Phonetic (for Asian languages) */
+    phonetic?: boolean;
+}
+/**
+ * Column data structure
+ */
+export interface ColumnData extends ColumnProperties {
+    /** Column index */
+    index?: number;
+}
+/**
+ * Merged cell range
+ */
+export interface MergeCell {
+    /** Start row index (0-based) */
+    startRow: number;
+    /** Start column index (0-based) */
+    startCol: number;
+    /** End row index (0-based) */
+    endRow: number;
+    /** End column index (0-based) */
+    endCol: number;
+}
+/**
+ * Frozen pane configuration
+ */
+export interface FreezePane {
+    /** Number of frozen rows */
+    rows?: number;
+    /** Number of frozen columns */
+    columns?: number;
+    /** Active cell in the unfrozen area */
+    activeCell?: string;
+}
+/**
+ * Sheet view settings
+ */
+export interface SheetView {
+    /** Right-to-left mode */
+    rightToLeft?: boolean;
+    /** Show grid lines */
+    showGridLines?: boolean;
+    /** Show row and column headers */
+    showRowColHeaders?: boolean;
+    /** Show zero values */
+    showZeros?: boolean;
+    /** Zoom scale percentage */
+    zoomScale?: number;
+    /** Zoom scale for page layout view */
+    zoomScaleNormal?: number;
+    /** Zoom scale for page break preview */
+    zoomScalePageBreakPreview?: number;
+    /** Zoom scale for page layout view */
+    zoomScaleSheetLayoutView?: number;
+    /** View type */
+    view?: 'normal' | 'pageBreakPreview' | 'pageLayout';
+    /** Top-left visible cell */
+    topLeftCell?: string;
+    /** Split state */
+    split?: {
+        xSplit?: number;
+        ySplit?: number;
+        activePane?: 'bottomRight' | 'topRight' | 'bottomLeft' | 'topLeft';
+    };
+}
+/**
+ * Print options for worksheet
+ */
+export interface PrintOptions {
+    /** Orientation */
+    orientation?: 'portrait' | 'landscape';
+    /** Fit to page */
+    fitToPage?: boolean;
+    /** Fit to width (in pages) */
+    fitToWidth?: number;
+    /** Fit to height (in pages) */
+    fitToHeight?: number;
+    /** Paper size */
+    paperSize?: string | number;
+    /** Scale percentage */
+    scale?: number;
+    /** Print area range */
+    printArea?: string;
+    /** Print titles (rows to repeat) */
+    printTitles?: {
+        rows?: string;
+        columns?: string;
+    };
+    /** Center on page */
+    center?: {
+        horizontal?: boolean;
+        vertical?: boolean;
+    };
+    /** Print grid lines */
+    printGridLines?: boolean;
+    /** Print row and column headers */
+    printHeadings?: boolean;
+    /** Black and white */
+    blackAndWhite?: boolean;
+    /** Draft quality */
+    draft?: boolean;
+    /** Page order */
+    pageOrder?: 'downThenOver' | 'overThenDown';
+    /** Comments display */
+    comments?: 'none' | 'asDisplayed' | 'atEnd';
+    /** Errors display */
+    errors?: 'displayed' | 'blank' | 'dash' | 'NA';
+    /** First page number */
+    firstPageNumber?: number;
+    /** Horizontal DPI */
+    horizontalDpi?: number;
+    /** Vertical DPI */
+    verticalDpi?: number;
+    /** Header margin */
+    headerMargin?: number;
+    /** Footer margin */
+    footerMargin?: number;
+    /** Top margin */
+    topMargin?: number;
+    /** Bottom margin */
+    bottomMargin?: number;
+    /** Left margin */
+    leftMargin?: number;
+    /** Right margin */
+    rightMargin?: number;
+}
+/**
+ * Header/Footer configuration
+ */
+export interface HeaderFooter {
+    /** Different first page */
+    differentFirst?: boolean;
+    /** Different odd and even pages */
+    differentOddEven?: boolean;
+    /** Scale with document */
+    scaleWithDoc?: boolean;
+    /** Align with margins */
+    alignWithMargins?: boolean;
+    /** Odd page header */
+    oddHeader?: string;
+    /** Odd page footer */
+    oddFooter?: string;
+    /** Even page header */
+    evenHeader?: string;
+    /** Even page footer */
+    evenFooter?: string;
+    /** First page header */
+    firstHeader?: string;
+    /** First page footer */
+    firstFooter?: string;
+}
+/**
+ * Auto-filter configuration
+ */
+export interface AutoFilter {
+    /** Filter range */
+    range: string;
+    /** Filter columns */
+    columns?: Record<number, {
+        /** Filter criteria */
+        criteria?: any;
+        /** Custom filters */
+        customFilters?: any[];
+        /** Dynamic filter */
+        dynamicFilter?: string;
+        /** Top 10 filter */
+        top10?: {
+            top?: boolean;
+            percent?: boolean;
+            val?: number;
+        };
+        /** Color filter */
+        colorFilter?: string;
+        /** Icon filter */
+        iconFilter?: string;
+    }>;
+}
+/**
+ * Table configuration
+ */
+export interface TableConfig {
+    /** Table name */
+    name: string;
+    /** Table range */
+    range: string;
+    /** Table style */
+    style?: string;
+    /** Header row */
+    headerRow?: boolean;
+    /** Total row */
+    totalRow?: boolean;
+    /** Banded rows */
+    bandedRows?: boolean;
+    /** Banded columns */
+    bandedColumns?: boolean;
+    /** First column */
+    firstColumn?: boolean;
+    /** Last column */
+    lastColumn?: boolean;
+    /** Show auto-filter */
+    showFilter?: boolean;
+    /** Table columns */
+    columns?: Array<{
+        name: string;
+        totalsRowFunction?: 'none' | 'sum' | 'min' | 'max' | 'average' | 'count' | 'countNums' | 'stdDev' | 'var' | 'custom';
+        totalsRowLabel?: string;
+        totalsRowFormula?: string;
+    }>;
+}
+/**
+ * Pivot table configuration
+ */
+export interface PivotTableConfig {
+    /** Pivot table name */
+    name: string;
+    /** Source data range */
+    source: string;
+    /** Destination cell */
+    destination: string;
+    /** Row fields */
+    rows?: Array<{
+        name: string;
+        axis?: 'row' | 'column' | 'page' | 'data';
+        sort?: 'ascending' | 'descending' | 'manual';
+        position?: number;
+    }>;
+    /** Column fields */
+    columns?: Array<{
+        name: string;
+        axis?: 'row' | 'column' | 'page' | 'data';
+        sort?: 'ascending' | 'descending' | 'manual';
+        position?: number;
+    }>;
+    /** Data fields */
+    data?: Array<{
+        name: string;
+        summarize?: 'sum' | 'count' | 'average' | 'max' | 'min' | 'product' | 'countNums' | 'stdDev' | 'stdDevp' | 'var' | 'varp';
+        numberFormat?: string;
+    }>;
+    /** Page fields */
+    pages?: Array<{
+        name: string;
+        axis?: 'row' | 'column' | 'page' | 'data';
+        sort?: 'ascending' | 'descending' | 'manual';
+        position?: number;
+    }>;
+    /** Filter fields */
+    filters?: Array<{
+        name: string;
+        axis?: 'row' | 'column' | 'page' | 'data';
+        sort?: 'ascending' | 'descending' | 'manual';
+        position?: number;
+    }>;
+    /** Style */
+    style?: string;
+    /** Grand total columns */
+    grandTotalColumns?: boolean;
+    /** Grand total rows */
+    grandTotalRows?: boolean;
+    /** Show row headers */
+    showRowHeaders?: boolean;
+    /** Show column headers */
+    showColumnHeaders?: boolean;
+    /** Compact form */
+    compact?: boolean;
+    /** Outline form */
+    outline?: boolean;
+    /** Tabular form */
+    tabular?: boolean;
+}
+/**
+ * Chart configuration
+ */
+export interface ChartConfig {
+    /** Chart title */
+    title?: string;
+    /** Chart type */
+    type: 'area' | 'bar' | 'column' | 'line' | 'pie' | 'doughnut' | 'radar' | 'scatter' | 'stock' | 'surface' | 'bubble';
+    /** Data range */
+    dataRange: string;
+    /** X-axis range (for scatter) */
+    xAxisRange?: string;
+    /** Legend position */
+    legend?: 'top' | 'bottom' | 'left' | 'right' | 'corner' | 'none';
+    /** Chart size */
+    size?: {
+        width: number;
+        height: number;
+    };
+    /** Chart position */
+    position?: {
+        x: number;
+        y: number;
+    };
+    /** Chart style */
+    style?: number;
+    /** Show data labels */
+    showDataLabels?: boolean;
+    /** Show gridlines */
+    showGridlines?: boolean;
+    /** 3D */
+    threeD?: boolean;
+}
+/**
+ * Complete worksheet data structure
+ */
+export interface WorksheetData {
+    /** Sheet name */
+    name: string;
+    /** Rows in the sheet */
+    rows: RowData[];
+    /** Column definitions */
+    columns?: ColumnData[];
+    /** Merged cells */
+    mergeCells?: MergeCell[];
+    /** Frozen panes */
+    freezePane?: FreezePane;
+    /** Print options */
+    printOptions?: PrintOptions;
+    /** Sheet view settings */
+    sheetView?: SheetView;
+    /** Header/Footer */
+    headerFooter?: HeaderFooter;
+    /** Auto-filter */
+    autoFilter?: AutoFilter;
+    /** Tables */
+    tables?: TableConfig[];
+    /** Pivot tables */
+    pivotTables?: PivotTableConfig[];
+    /** Charts */
+    charts?: ChartConfig[];
+    /** Data validations */
+    dataValidations?: Record<string, DataValidation>;
+    /** Conditional formatting */
+    conditionalFormats?: Record<string, ConditionalFormatRule[]>;
+    /** Sheet protection password */
+    protection?: {
+        password?: string;
+        sheet?: boolean;
+        objects?: boolean;
+        scenarios?: boolean;
+        formatCells?: boolean;
+        formatColumns?: boolean;
+        formatRows?: boolean;
+        insertColumns?: boolean;
+        insertRows?: boolean;
+        insertHyperlinks?: boolean;
+        deleteColumns?: boolean;
+        deleteRows?: boolean;
+        sort?: boolean;
+        autoFilter?: boolean;
+        pivotTables?: boolean;
+    };
+    /** Sheet tab color */
+    tabColor?: string;
+    /** Sheet state (visible, hidden, veryHidden) */
+    state?: 'visible' | 'hidden' | 'veryHidden';
+    /** Background image */
+    background?: string;
+}
+/**
+ * Workbook properties
+ */
+export interface WorkbookProperties {
+    /** Creator name */
+    creator?: string;
+    /** Last modified by */
+    lastModifiedBy?: string;
+    /** Creation date */
+    created?: Date;
+    /** Last modified date */
+    modified?: Date;
+    /** Company name */
+    company?: string;
+    /** Manager name */
+    manager?: string;
+    /** Title */
+    title?: string;
+    /** Subject */
+    subject?: string;
+    /** Keywords */
+    keywords?: string;
+    /** Category */
+    category?: string;
+    /** Description */
+    description?: string;
+    /** Status */
+    status?: string;
+    /** Custom properties */
+    custom?: Record<string, string | number | boolean | Date>;
+}
+/**
+ * Workbook calculation properties
+ */
+export interface CalculationProperties {
+    /** Calculation mode */
+    calcMode?: 'auto' | 'autoNoTable' | 'manual';
+    /** Full calculation on load */
+    fullCalcOnLoad?: boolean;
+    /** Force full calculation */
+    forceFullCalc?: boolean;
+    /** Iteration */
+    iteration?: boolean;
+    /** Max iterations */
+    maxIterations?: number;
+    /** Max change */
+    maxChange?: number;
+    /** Reference style (A1 or R1C1) */
+    refMode?: 'A1' | 'R1C1';
+}
+/**
+ * Complete workbook data structure
+ */
+export interface WorkbookData {
+    /** Worksheets in the workbook */
+    sheets: WorksheetData[];
+    /** Workbook properties */
+    properties?: WorkbookProperties;
+    /** Calculation properties */
+    calculation?: CalculationProperties;
+    /** Named ranges */
+    namedRanges?: Record<string, {
+        range: string;
+        localSheet?: number;
+        comment?: string;
+        hidden?: boolean;
+    }>;
+    /** External references */
+    externalReferences?: Array<{
+        name: string;
+        path: string;
+        type: 'dde' | 'ole' | 'external';
+    }>;
+    /** Active sheet index */
+    activeSheet?: number;
+    /** Selected tabs */
+    selectedTabs?: number[];
+    /** Tab ratio */
+    tabRatio?: number;
+    /** First visible tab */
+    firstVisibleTab?: number;
+    /** Workbook views */
+    views?: Array<{
+        activeTab?: number;
+        firstSheet?: number;
+        showHorizontalScroll?: boolean;
+        showVerticalScroll?: boolean;
+        showSheetTabs?: boolean;
+        xWindow?: number;
+        yWindow?: number;
+        windowWidth?: number;
+        windowHeight?: number;
+        tabRatio?: number;
+    }>;
+}

package/dist/types/utils/constants.d.ts

@@ -0,0 +1,10 @@
+declare const constants: {
+    APP_NAME: string;
+    VERSION: string;
+    SUPPORTED_FORMATS: string[];
+    DEFAULT_EXPORT_OPTIONS: {
+        includeHeaders: boolean;
+        sheetName: string;
+    };
+};
+export default constants;

package/dist/types/utils/helpers.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Format currency values
+ */
+export declare const formatCurrency: (value: number) => string;
+/**
+ * Format date values
+ */
+export declare const formatDate: (date: string | Date) => string;
+/**
+ * Format number with commas
+ */
+export declare const formatNumber: (num: number) => string;
+/**
+ * Truncate text with ellipsis
+ */
+export declare const truncateText: (text: string, maxLength: number) => string;
+/**
+ * Generate random ID
+ */
+export declare const generateId: () => string;
+/**
+ * Debounce function
+ */
+export declare const debounce: <T extends (...args: any[]) => any>(func: T, wait: number) => ((...args: Parameters<T>) => void);
+/**
+ * Group array by key
+ */
+export declare const groupBy: <T>(array: T[], key: keyof T) => Record<string, T[]>;
+/**
+ * Calculate percentage
+ */
+export declare const calculatePercentage: (value: number, total: number) => number;
+/**
+ * Download file
+ */
+export declare const downloadFile: (content: string, filename: string, type: string) => void;

package/dist/types/utils/validators.d.ts

@@ -0,0 +1,3 @@
+declare function validateEmail(email: string): boolean;
+declare function validatePhoneNumber(phone: string): boolean;
+export { validateEmail, validatePhoneNumber };

package/dist/types/writers/csv-writer.d.ts

@@ -0,0 +1,6 @@
+import { Workbook } from '../core/workbook';
+import { ExportOptions } from '../types';
+export declare class CSVWriter {
+    static write(workbook: Workbook, _options: ExportOptions): Promise<Blob>;
+    private static generateCSVData;
+}

package/dist/types/writers/excel-writer.d.ts

@@ -0,0 +1,16 @@
+import { Workbook } from '../core/workbook';
+import { ExportOptions } from '../types';
+export declare class ExcelWriter {
+    static write(workbook: Workbook, _options: ExportOptions): Promise<Blob>;
+    private static generateExcelData;
+    private static generateSheetData;
+    private static getSheetRange;
+    private static columnToLetter;
+    private static createExcelFile;
+    private static generateWorkbookXML;
+}
+export declare class ExportBuilder {
+    private workbook;
+    constructor(workbook: Workbook);
+    download(options?: ExportOptions): void;
+}

package/dist/types/writers/index.d.ts

@@ -0,0 +1,4 @@
+export { ExcelWriter } from './excel-writer';
+export { CSVWriter } from './csv-writer';
+export { JSONWriter } from './json-writer';
+export { Workbook } from '../core/workbook';

package/dist/types/writers/json-writer.d.ts

@@ -0,0 +1,6 @@
+import { Workbook } from '../core/workbook';
+import { ExportOptions } from '../types';
+export declare class JSONWriter {
+    static write(workbook: Workbook, _options: ExportOptions): Promise<Blob>;
+    private static generateJSONData;
+}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "sheetra",
+  "version": "1.0.0",
+  "description": "Powerful Excel/CSV/JSON export library with zero dependencies",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/types/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "excel",
+    "csv",
+    "json",
+    "export",
+    "spreadsheet",
+    "xlsx",
+    "data-export",
+    "zero-dependencies"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": "",
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "devDependencies": {
+    "@jest/types": "^30.2.0",
+    "@rollup/plugin-commonjs": "^24.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@types/jest": "^29.0.0",
+    "@types/node": "^18.0.0",
+    "@typescript-eslint/eslint-plugin": "^5.0.0",
+    "@typescript-eslint/parser": "^5.0.0",
+    "eslint": "^8.0.0",
+    "eslint-config-prettier": "^8.0.0",
+    "eslint-plugin-prettier": "^4.0.0",
+    "jest": "^29.0.0",
+    "prettier": "^2.0.0",
+    "rollup": "^3.0.0",
+    "rollup-plugin-dts": "^5.0.0",
+    "rollup-plugin-terser": "^7.0.0",
+    "ts-jest": "^29.0.0",
+    "ts-node": "^10.9.2",
+    "tslib": "^2.0.0",
+    "typescript": "^5.0.0"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:ci": "jest --ci --coverage --maxWorkers=2",
+    "test:unit": "jest test/unit",
+    "test:integration": "jest test/integration",
+    "test:performance": "jest test/performance --runInBand",
+    "test:core": "jest test/unit/core",
+    "test:builders": "jest test/unit/builders",
+    "test:writers": "jest test/unit/writers",
+    "test:formatters": "jest test/unit/formatters",
+    "test:utils": "jest test/unit/utils",
+    "test:changed": "jest --onlyChanged",
+    "test:related": "jest --findRelatedTests",
+    "test:verbose": "jest --verbose",
+    "test:debug": "node --inspect-brk node_modules/.bin/jest --runInBand",
+    "test:clear": "jest --clearCache",
+    "test:updateSnapshot": "jest --updateSnapshot",
+    "test:coverage:html": "jest --coverage && open coverage/index.html",
+    "test:ci:coverage": "jest --ci --coverage --coverageReporters=text-lcov | coveralls",
+    "test:badges": "jest --coverage && jest-coverage-badges output ./coverage",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "preversion": "npm run lint",
+    "version": "npm run format && git add -A src",
+    "postversion": "git push && git push --tags"
+  }
+}