@devmm/puredocs-excel-react 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TVE
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,111 @@
+'use strict';
+
+var react = require('react');
+var puredocsExcel = require('@devmm/puredocs-excel');
+
+// src/use-workbook.ts
+var XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+function useWorkbook() {
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const createWorkbook = react.useCallback(
+    async (builder) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const wb = puredocsExcel.Workbook.create();
+        await builder(wb);
+        return wb.saveAsBuffer();
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    []
+  );
+  const loadWorkbook = react.useCallback(
+    async (source) => {
+      setLoading(true);
+      setError(null);
+      try {
+        if (source instanceof ArrayBuffer || source instanceof Uint8Array) {
+          return puredocsExcel.Workbook.fromBuffer(source);
+        }
+        return puredocsExcel.Workbook.fromBuffer(await source.arrayBuffer());
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    []
+  );
+  const downloadBlob = react.useCallback((buffer, filename = "export.xlsx") => {
+    const url = URL.createObjectURL(new Blob([buffer], { type: XLSX_MIME }));
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+  }, []);
+  const toObjectUrl = react.useCallback(
+    (buffer) => URL.createObjectURL(new Blob([buffer], { type: XLSX_MIME })),
+    []
+  );
+  return { createWorkbook, loadWorkbook, downloadBlob, toObjectUrl, loading, error };
+}
+var EMPTY = { rows: [], rowCount: 0, colCount: 0 };
+function useWorksheet(sheetIndex = 0) {
+  const [workbook, setWorkbook] = react.useState(null);
+  const [sheet, setSheet] = react.useState(null);
+  const [state, setState] = react.useState(EMPTY);
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const load = react.useCallback(
+    async (source, idx = sheetIndex) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const buf = source instanceof File ? await source.arrayBuffer() : source;
+        const wb = puredocsExcel.Workbook.fromBuffer(buf);
+        const ws = wb.worksheets[idx];
+        if (!ws) throw new Error(`Sheet index ${idx} not found`);
+        setWorkbook(wb);
+        setSheet(ws);
+        const { rowCount, columnCount } = ws.usedBounds;
+        const rows = Array.from(
+          { length: rowCount },
+          (_, r) => Array.from(
+            { length: columnCount },
+            (_2, c) => ws.tryGetCell(puredocsExcel.cellRefFromRowCol(r + 1, c + 1))?.getValue() ?? null
+          )
+        );
+        setState({ rows, rowCount, colCount: columnCount });
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [sheetIndex]
+  );
+  const getCell = react.useCallback(
+    (row, col) => state.rows[row - 1]?.[col - 1] ?? null,
+    [state]
+  );
+  return { workbook, sheet, state, load, getCell, loading, error };
+}
+
+exports.useWorkbook = useWorkbook;
+exports.useWorksheet = useWorksheet;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-workbook.ts","../src/use-worksheet.ts"],"names":["useState","useCallback","Workbook","_","cellRefFromRowCol"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * React hooks for @devmm/puredocs-excel.\n *\n * React is a peerDependency — install `react` (and `@types/react`) in your app.\n */\nimport { useState, useCallback } from 'react';\nimport { Workbook } from '@devmm/puredocs-excel';\n\nexport type UseWorkbookReturn = {\n  /** Build a new workbook via callback and return its buffer. */\n  createWorkbook: (builder: (wb: Workbook) => void | Promise<void>) => Promise<Uint8Array>;\n  /** Load an existing xlsx from a File, ArrayBuffer or Uint8Array. */\n  loadWorkbook: (source: File | ArrayBuffer | Uint8Array) => Promise<Workbook>;\n  /** Trigger a browser download for the given buffer. */\n  downloadBlob: (buffer: Uint8Array, filename?: string) => void;\n  /** Convert a buffer to an object URL (caller must revoke it). */\n  toObjectUrl: (buffer: Uint8Array) => string;\n  /** True while an async operation is running. */\n  loading: boolean;\n  /** Last error, if any. */\n  error: Error | null;\n};\n\nconst XLSX_MIME =\n  'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';\n\nexport function useWorkbook(): UseWorkbookReturn {\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const createWorkbook = useCallback(\n    async (builder: (wb: Workbook) => void | Promise<void>): Promise<Uint8Array> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const wb = Workbook.create();\n        await builder(wb);\n        return wb.saveAsBuffer();\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [],\n  );\n\n  const loadWorkbook = useCallback(\n    async (source: File | ArrayBuffer | Uint8Array): Promise<Workbook> => {\n      setLoading(true);\n      setError(null);\n      try {\n        if (source instanceof ArrayBuffer || source instanceof Uint8Array) {\n          return Workbook.fromBuffer(source);\n        }\n        return Workbook.fromBuffer(await source.arrayBuffer());\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [],\n  );\n\n  const downloadBlob = useCallback((buffer: Uint8Array, filename = 'export.xlsx'): void => {\n    const url = URL.createObjectURL(new Blob([buffer as BlobPart], { type: XLSX_MIME }));\n    const a = document.createElement('a');\n    a.href = url;\n    a.download = filename;\n    document.body.appendChild(a);\n    a.click();\n    document.body.removeChild(a);\n    URL.revokeObjectURL(url);\n  }, []);\n\n  const toObjectUrl = useCallback(\n    (buffer: Uint8Array): string =>\n      URL.createObjectURL(new Blob([buffer as BlobPart], { type: XLSX_MIME })),\n    [],\n  );\n\n  return { createWorkbook, loadWorkbook, downloadBlob, toObjectUrl, loading, error };\n}\n","import { useState, useCallback } from 'react';\nimport {\n  Workbook,\n  cellRefFromRowCol,\n  type Worksheet,\n  type CellValue,\n} from '@devmm/puredocs-excel';\n\nexport type WorksheetState = {\n  rows: CellValue[][];\n  rowCount: number;\n  colCount: number;\n};\n\nexport type UseWorksheetReturn = {\n  workbook: Workbook | null;\n  sheet: Worksheet | null;\n  state: WorksheetState;\n  load: (source: File | ArrayBuffer | Uint8Array, sheetIndex?: number) => Promise<void>;\n  getCell: (row: number, col: number) => CellValue;\n  loading: boolean;\n  error: Error | null;\n};\n\nconst EMPTY: WorksheetState = { rows: [], rowCount: 0, colCount: 0 };\n\nexport function useWorksheet(sheetIndex = 0): UseWorksheetReturn {\n  const [workbook, setWorkbook] = useState<Workbook | null>(null);\n  const [sheet, setSheet] = useState<Worksheet | null>(null);\n  const [state, setState] = useState<WorksheetState>(EMPTY);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const load = useCallback(\n    async (source: File | ArrayBuffer | Uint8Array, idx = sheetIndex): Promise<void> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const buf: ArrayBuffer | Uint8Array =\n          source instanceof File ? await source.arrayBuffer() : source;\n        const wb = Workbook.fromBuffer(buf);\n        const ws = wb.worksheets[idx];\n        if (!ws) throw new Error(`Sheet index ${idx} not found`);\n\n        setWorkbook(wb);\n        setSheet(ws);\n\n        // Snapshot into a dense 2D array for rendering, using only public API.\n        const { rowCount, columnCount } = ws.usedBounds;\n        const rows: CellValue[][] = Array.from({ length: rowCount }, (_, r) =>\n          Array.from({ length: columnCount }, (_, c) =>\n            ws.tryGetCell(cellRefFromRowCol(r + 1, c + 1))?.getValue() ?? null,\n          ),\n        );\n\n        setState({ rows, rowCount, colCount: columnCount });\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [sheetIndex],\n  );\n\n  const getCell = useCallback(\n    (row: number, col: number): CellValue => state.rows[row - 1]?.[col - 1] ?? null,\n    [state],\n  );\n\n  return { workbook, sheet, state, load, getCell, loading, error };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,35 @@
+import { Workbook, Worksheet, CellValue } from '@devmm/puredocs-excel';
+
+type UseWorkbookReturn = {
+    /** Build a new workbook via callback and return its buffer. */
+    createWorkbook: (builder: (wb: Workbook) => void | Promise<void>) => Promise<Uint8Array>;
+    /** Load an existing xlsx from a File, ArrayBuffer or Uint8Array. */
+    loadWorkbook: (source: File | ArrayBuffer | Uint8Array) => Promise<Workbook>;
+    /** Trigger a browser download for the given buffer. */
+    downloadBlob: (buffer: Uint8Array, filename?: string) => void;
+    /** Convert a buffer to an object URL (caller must revoke it). */
+    toObjectUrl: (buffer: Uint8Array) => string;
+    /** True while an async operation is running. */
+    loading: boolean;
+    /** Last error, if any. */
+    error: Error | null;
+};
+declare function useWorkbook(): UseWorkbookReturn;
+
+type WorksheetState = {
+    rows: CellValue[][];
+    rowCount: number;
+    colCount: number;
+};
+type UseWorksheetReturn = {
+    workbook: Workbook | null;
+    sheet: Worksheet | null;
+    state: WorksheetState;
+    load: (source: File | ArrayBuffer | Uint8Array, sheetIndex?: number) => Promise<void>;
+    getCell: (row: number, col: number) => CellValue;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useWorksheet(sheetIndex?: number): UseWorksheetReturn;
+
+export { type UseWorkbookReturn, type UseWorksheetReturn, type WorksheetState, useWorkbook, useWorksheet };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { Workbook, Worksheet, CellValue } from '@devmm/puredocs-excel';
+
+type UseWorkbookReturn = {
+    /** Build a new workbook via callback and return its buffer. */
+    createWorkbook: (builder: (wb: Workbook) => void | Promise<void>) => Promise<Uint8Array>;
+    /** Load an existing xlsx from a File, ArrayBuffer or Uint8Array. */
+    loadWorkbook: (source: File | ArrayBuffer | Uint8Array) => Promise<Workbook>;
+    /** Trigger a browser download for the given buffer. */
+    downloadBlob: (buffer: Uint8Array, filename?: string) => void;
+    /** Convert a buffer to an object URL (caller must revoke it). */
+    toObjectUrl: (buffer: Uint8Array) => string;
+    /** True while an async operation is running. */
+    loading: boolean;
+    /** Last error, if any. */
+    error: Error | null;
+};
+declare function useWorkbook(): UseWorkbookReturn;
+
+type WorksheetState = {
+    rows: CellValue[][];
+    rowCount: number;
+    colCount: number;
+};
+type UseWorksheetReturn = {
+    workbook: Workbook | null;
+    sheet: Worksheet | null;
+    state: WorksheetState;
+    load: (source: File | ArrayBuffer | Uint8Array, sheetIndex?: number) => Promise<void>;
+    getCell: (row: number, col: number) => CellValue;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useWorksheet(sheetIndex?: number): UseWorksheetReturn;
+
+export { type UseWorkbookReturn, type UseWorksheetReturn, type WorksheetState, useWorkbook, useWorksheet };

package/dist/index.js

@@ -0,0 +1,108 @@
+import { useState, useCallback } from 'react';
+import { Workbook, cellRefFromRowCol } from '@devmm/puredocs-excel';
+
+// src/use-workbook.ts
+var XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+function useWorkbook() {
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const createWorkbook = useCallback(
+    async (builder) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const wb = Workbook.create();
+        await builder(wb);
+        return wb.saveAsBuffer();
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    []
+  );
+  const loadWorkbook = useCallback(
+    async (source) => {
+      setLoading(true);
+      setError(null);
+      try {
+        if (source instanceof ArrayBuffer || source instanceof Uint8Array) {
+          return Workbook.fromBuffer(source);
+        }
+        return Workbook.fromBuffer(await source.arrayBuffer());
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    []
+  );
+  const downloadBlob = useCallback((buffer, filename = "export.xlsx") => {
+    const url = URL.createObjectURL(new Blob([buffer], { type: XLSX_MIME }));
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+  }, []);
+  const toObjectUrl = useCallback(
+    (buffer) => URL.createObjectURL(new Blob([buffer], { type: XLSX_MIME })),
+    []
+  );
+  return { createWorkbook, loadWorkbook, downloadBlob, toObjectUrl, loading, error };
+}
+var EMPTY = { rows: [], rowCount: 0, colCount: 0 };
+function useWorksheet(sheetIndex = 0) {
+  const [workbook, setWorkbook] = useState(null);
+  const [sheet, setSheet] = useState(null);
+  const [state, setState] = useState(EMPTY);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const load = useCallback(
+    async (source, idx = sheetIndex) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const buf = source instanceof File ? await source.arrayBuffer() : source;
+        const wb = Workbook.fromBuffer(buf);
+        const ws = wb.worksheets[idx];
+        if (!ws) throw new Error(`Sheet index ${idx} not found`);
+        setWorkbook(wb);
+        setSheet(ws);
+        const { rowCount, columnCount } = ws.usedBounds;
+        const rows = Array.from(
+          { length: rowCount },
+          (_, r) => Array.from(
+            { length: columnCount },
+            (_2, c) => ws.tryGetCell(cellRefFromRowCol(r + 1, c + 1))?.getValue() ?? null
+          )
+        );
+        setState({ rows, rowCount, colCount: columnCount });
+      } catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        setError(err);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [sheetIndex]
+  );
+  const getCell = useCallback(
+    (row, col) => state.rows[row - 1]?.[col - 1] ?? null,
+    [state]
+  );
+  return { workbook, sheet, state, load, getCell, loading, error };
+}
+
+export { useWorkbook, useWorksheet };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-workbook.ts","../src/use-worksheet.ts"],"names":["useState","useCallback","Workbook","_"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * React hooks for @devmm/puredocs-excel.\n *\n * React is a peerDependency — install `react` (and `@types/react`) in your app.\n */\nimport { useState, useCallback } from 'react';\nimport { Workbook } from '@devmm/puredocs-excel';\n\nexport type UseWorkbookReturn = {\n  /** Build a new workbook via callback and return its buffer. */\n  createWorkbook: (builder: (wb: Workbook) => void | Promise<void>) => Promise<Uint8Array>;\n  /** Load an existing xlsx from a File, ArrayBuffer or Uint8Array. */\n  loadWorkbook: (source: File | ArrayBuffer | Uint8Array) => Promise<Workbook>;\n  /** Trigger a browser download for the given buffer. */\n  downloadBlob: (buffer: Uint8Array, filename?: string) => void;\n  /** Convert a buffer to an object URL (caller must revoke it). */\n  toObjectUrl: (buffer: Uint8Array) => string;\n  /** True while an async operation is running. */\n  loading: boolean;\n  /** Last error, if any. */\n  error: Error | null;\n};\n\nconst XLSX_MIME =\n  'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';\n\nexport function useWorkbook(): UseWorkbookReturn {\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const createWorkbook = useCallback(\n    async (builder: (wb: Workbook) => void | Promise<void>): Promise<Uint8Array> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const wb = Workbook.create();\n        await builder(wb);\n        return wb.saveAsBuffer();\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [],\n  );\n\n  const loadWorkbook = useCallback(\n    async (source: File | ArrayBuffer | Uint8Array): Promise<Workbook> => {\n      setLoading(true);\n      setError(null);\n      try {\n        if (source instanceof ArrayBuffer || source instanceof Uint8Array) {\n          return Workbook.fromBuffer(source);\n        }\n        return Workbook.fromBuffer(await source.arrayBuffer());\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [],\n  );\n\n  const downloadBlob = useCallback((buffer: Uint8Array, filename = 'export.xlsx'): void => {\n    const url = URL.createObjectURL(new Blob([buffer as BlobPart], { type: XLSX_MIME }));\n    const a = document.createElement('a');\n    a.href = url;\n    a.download = filename;\n    document.body.appendChild(a);\n    a.click();\n    document.body.removeChild(a);\n    URL.revokeObjectURL(url);\n  }, []);\n\n  const toObjectUrl = useCallback(\n    (buffer: Uint8Array): string =>\n      URL.createObjectURL(new Blob([buffer as BlobPart], { type: XLSX_MIME })),\n    [],\n  );\n\n  return { createWorkbook, loadWorkbook, downloadBlob, toObjectUrl, loading, error };\n}\n","import { useState, useCallback } from 'react';\nimport {\n  Workbook,\n  cellRefFromRowCol,\n  type Worksheet,\n  type CellValue,\n} from '@devmm/puredocs-excel';\n\nexport type WorksheetState = {\n  rows: CellValue[][];\n  rowCount: number;\n  colCount: number;\n};\n\nexport type UseWorksheetReturn = {\n  workbook: Workbook | null;\n  sheet: Worksheet | null;\n  state: WorksheetState;\n  load: (source: File | ArrayBuffer | Uint8Array, sheetIndex?: number) => Promise<void>;\n  getCell: (row: number, col: number) => CellValue;\n  loading: boolean;\n  error: Error | null;\n};\n\nconst EMPTY: WorksheetState = { rows: [], rowCount: 0, colCount: 0 };\n\nexport function useWorksheet(sheetIndex = 0): UseWorksheetReturn {\n  const [workbook, setWorkbook] = useState<Workbook | null>(null);\n  const [sheet, setSheet] = useState<Worksheet | null>(null);\n  const [state, setState] = useState<WorksheetState>(EMPTY);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const load = useCallback(\n    async (source: File | ArrayBuffer | Uint8Array, idx = sheetIndex): Promise<void> => {\n      setLoading(true);\n      setError(null);\n      try {\n        const buf: ArrayBuffer | Uint8Array =\n          source instanceof File ? await source.arrayBuffer() : source;\n        const wb = Workbook.fromBuffer(buf);\n        const ws = wb.worksheets[idx];\n        if (!ws) throw new Error(`Sheet index ${idx} not found`);\n\n        setWorkbook(wb);\n        setSheet(ws);\n\n        // Snapshot into a dense 2D array for rendering, using only public API.\n        const { rowCount, columnCount } = ws.usedBounds;\n        const rows: CellValue[][] = Array.from({ length: rowCount }, (_, r) =>\n          Array.from({ length: columnCount }, (_, c) =>\n            ws.tryGetCell(cellRefFromRowCol(r + 1, c + 1))?.getValue() ?? null,\n          ),\n        );\n\n        setState({ rows, rowCount, colCount: columnCount });\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e));\n        setError(err);\n        throw err;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [sheetIndex],\n  );\n\n  const getCell = useCallback(\n    (row: number, col: number): CellValue => state.rows[row - 1]?.[col - 1] ?? null,\n    [state],\n  );\n\n  return { workbook, sheet, state, load, getCell, loading, error };\n}\n"]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@devmm/puredocs-excel-react",
+  "version": "1.0.0",
+  "description": "React hooks for @devmm/puredocs-excel",
+  "license": "MIT",
+  "author": "TVE",
+  "keywords": [
+    "excel",
+    "xlsx",
+    "react",
+    "hooks"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quangtrungsoft/puredocs-excel.git",
+    "directory": "packages/react"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "@devmm/puredocs-excel": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "tsup": "^8.0.0",
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "@devmm/puredocs-excel": "1.0.0"
+  },
+  "bugs": {
+    "url": "https://github.com/quangtrungsoft/puredocs-excel/issues"
+  },
+  "homepage": "https://github.com/quangtrungsoft/puredocs-excel/tree/main/packages/react#readme",
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}