@cj-tech-master/excelts 0.1.0-canary.20251025023400.dff1908

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2014-2019 Guyon Roche
+
+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/README.md

@@ -0,0 +1,232 @@
+# ExcelTS
+
+[![Build Status](https://github.com/cjnoname/excelts/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/cjnoname/excelts/actions/workflows/ci.yml)
+
+Modern TypeScript Excel Workbook Manager - Read, manipulate and write spreadsheet data and styles to XLSX and JSON.
+
+## About This Project
+
+ExcelTS is a modernized fork of [ExcelJS](https://github.com/exceljs/exceljs) with:
+
+- ✅ **Full TypeScript Support** - Complete type definitions and modern TypeScript patterns
+- ✅ **Updated Dependencies** - All dependencies upgraded to latest stable versions
+- ✅ **Modern Build System** - Using Rolldown for faster builds
+- ✅ **Enhanced Testing** - Migrated to Vitest with browser testing support
+- ✅ **ESM First** - Native ES Module support with CommonJS compatibility
+- ✅ **Node 20+** - Optimized for modern Node.js versions
+- ✅ **Named Exports** - All exports are named for better tree-shaking
+
+## Translations
+
+- [中文文档](README_zh.md)
+
+## Installation
+
+````bash
+npm install @cj-tech-master/excelts
+
+## Quick Start
+
+### Creating a Workbook
+
+```javascript
+import { Workbook } from "@cj-tech-master/excelts";
+
+const workbook = new Workbook();
+const sheet = workbook.addWorksheet("My Sheet");
+
+// Add data
+sheet.addRow(["Name", "Age", "Email"]);
+sheet.addRow(["John Doe", 30, "john@example.com"]);
+sheet.addRow(["Jane Smith", 25, "jane@example.com"]);
+
+// Save to file
+await workbook.xlsx.writeFile("output.xlsx");
+````
+
+### Reading a Workbook
+
+```javascript
+import { Workbook } from "@cj-tech-master/excelts";
+
+const workbook = new Workbook();
+await workbook.xlsx.readFile("input.xlsx");
+
+const worksheet = workbook.getWorksheet(1);
+worksheet.eachRow((row, rowNumber) => {
+  console.log("Row " + rowNumber + " = " + JSON.stringify(row.values));
+});
+```
+
+### Styling Cells
+
+```javascript
+// Set cell value and style
+const cell = worksheet.getCell("A1");
+cell.value = "Hello";
+cell.font = {
+  name: "Arial",
+  size: 16,
+  bold: true,
+  color: { argb: "FFFF0000" }
+};
+cell.fill = {
+  type: "pattern",
+  pattern: "solid",
+  fgColor: { argb: "FFFFFF00" }
+};
+```
+
+## Features
+
+- **Excel Operations**
+  - Create, read, and modify XLSX files
+  - Multiple worksheet support
+  - Cell styling (fonts, colors, borders, fills)
+  - Cell merging and formatting
+  - Row and column properties
+  - Freeze panes and split views
+
+- **Data Handling**
+  - Rich text support
+  - Formulas and calculated values
+  - Data validation
+  - Conditional formatting
+  - Images and charts
+  - Hyperlinks
+  - Pivot tables
+
+- **Advanced Features**
+  - Streaming for large files
+  - CSV import/export
+  - Tables with auto-filters
+  - Page setup and printing options
+  - Data protection
+  - Comments and notes
+
+## Browser Support
+
+ExcelTS supports both Node.js and browser environments:
+
+```javascript
+// Browser usage
+import { Workbook } from "@cj-tech-master/excelts/browser";
+
+const workbook = new Workbook();
+// ... use workbook API
+```
+
+## Requirements
+
+### Node.js
+
+- **Node.js >= 18.0.0** (ES2020 native support)
+- Recommended: Node.js >= 20.0.0 for best performance
+
+### Browsers (No Polyfills Required)
+
+- **Chrome >= 85** (August 2020)
+- **Edge >= 85** (August 2020)
+- **Firefox >= 79** (July 2020)
+- **Safari >= 14** (September 2020)
+- **Opera >= 71** (September 2020)
+
+All ES2020 features (optional chaining `?.`, nullish coalescing `??`, Promise.allSettled, etc.) are natively supported in these versions.
+
+## Maintainer
+
+This project is actively maintained by [CJ (@cjnoname)](https://github.com/cjnoname).
+
+### Maintenance Status
+
+**Active Maintenance** - This project is actively maintained with a focus on:
+
+- 🔒 **Security Updates** - Timely security patches and dependency updates
+- 🐛 **Bug Fixes** - Critical bug fixes and stability improvements
+- 📦 **Dependency Management** - Keeping dependencies up-to-date and secure
+- 🔍 **Code Review** - Reviewing and merging community contributions
+
+### Contributing
+
+While I may not have the bandwidth to develop new features regularly, **community contributions are highly valued and encouraged!**
+
+- 💡 **Pull Requests Welcome** - I will review and merge quality PRs promptly
+- 🚀 **Feature Proposals** - Open an issue to discuss new features before implementing
+- 🐛 **Bug Reports** - Please report bugs with reproducible examples
+- 📖 **Documentation** - Improvements to documentation are always appreciated
+
+## API Documentation
+
+For detailed API documentation, please refer to the comprehensive documentation sections:
+
+- Workbook Management
+- Worksheets
+- Cells and Values
+- Styling
+- Formulas
+- Data Validation
+- Conditional Formatting
+- File I/O
+
+The API remains largely compatible with the original ExcelJS.
+
+## Contributing Guidelines
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+### Before Submitting a PR
+
+1. **Bug Fixes**: Add a unit-test or integration-test (in the `src/__test__` folder) that reproduces the issue
+2. **New Features**: Open an issue first to discuss the feature and implementation approach
+3. **Documentation**: Update relevant documentation and type definitions
+4. **Code Style**: Follow the existing code style and pass all linters (`npm run lint`)
+5. **Tests**: Ensure all tests pass (`npm test`) and add tests for new functionality
+
+### Important Notes
+
+- **Version Numbers**: Please do not modify package version in PRs. Versions are managed through releases.
+- **License**: All contributions will be included under the project's MIT license
+- **Commit Messages**: Write clear, descriptive commit messages
+
+### Getting Help
+
+If you need help or have questions:
+
+- 📖 Check existing [issues](https://github.com/cjnoname/excelts/issues) and [documentation](https://github.com/cjnoname/excelts)
+- 💬 Open a [new issue](https://github.com/cjnoname/excelts/issues/new) for discussion
+- 🐛 Use issue templates for bug reports
+
+## License
+
+MIT License
+
+Based on [ExcelJS](https://github.com/exceljs/exceljs) by [Guyon Roche](https://github.com/guyonroche)
+
+## Credits
+
+This project is a fork of ExcelJS with modernization improvements. All credit for the original implementation goes to:
+
+- **Guyon Roche** - Original author of ExcelJS
+- All [ExcelJS contributors](https://github.com/exceljs/exceljs/graphs/contributors)
+
+## Links
+
+- [GitHub Repository](https://github.com/cjnoname/exceljs)
+- [Original ExcelJS](https://github.com/exceljs/exceljs)
+- [Issue Tracker](https://github.com/cjnoname/exceljs/issues)
+
+## Changelog
+
+### 0.1.0 (2025-10-24)
+
+- Initial release of ExcelTS
+- Full TypeScript rewrite with strict typing
+- All default exports converted to named exports
+- Updated all dependencies to latest versions
+- Migrated to Vitest for testing
+- Switched to Rolldown for bundling
+- Modern ES Module support
+- Node 20+ support
+- Enhanced type safety with proper access modifiers
+- Browser testing support
+- Performance optimizations

package/README_zh.md

@@ -0,0 +1,233 @@
+# ExcelTS
+
+[![Build Status](https://github.com/cjnoname/excelts/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/cjnoname/excelts/actions/workflows/ci.yml)
+
+现代化的 TypeScript Excel 工作簿管理器 - 读取、操作和写入电子表格数据和样式到 XLSX 和 JSON。
+
+## 关于本项目
+
+ExcelTS 是 [ExcelJS](https://github.com/exceljs/exceljs) 的现代化版本，具有以下特性:
+
+- ✅ **完整的 TypeScript 支持** - 完整的类型定义和现代 TypeScript 模式
+- ✅ **升级的依赖** - 所有依赖项升级到最新稳定版本
+- ✅ **现代构建系统** - 使用 Rolldown 进行更快的构建
+- ✅ **增强的测试** - 迁移到 Vitest 并支持浏览器测试
+- ✅ **ESM 优先** - 原生 ES Module 支持，兼容 CommonJS
+- ✅ **Node 20+** - 针对现代 Node.js 版本优化
+- ✅ **命名导出** - 所有导出都是命名导出，更好的 tree-shaking
+
+## 翻译
+
+- [English Documentation](README.md)
+
+## 安装
+
+````bash
+npm install @cj-tech-master/excelts
+
+## 快速开始
+
+### 创建工作簿
+
+```javascript
+import { Workbook } from "@cj-tech-master/excelts";
+
+const workbook = new Workbook();
+const sheet = workbook.addWorksheet("我的工作表");
+
+// 添加数据
+sheet.addRow(["姓名", "年龄", "邮箱"]);
+sheet.addRow(["张三", 30, "zhang@example.com"]);
+sheet.addRow(["李四", 25, "li@example.com"]);
+
+// 保存文件
+await workbook.xlsx.writeFile("output.xlsx");
+````
+
+### 读取工作簿
+
+```javascript
+import { Workbook } from "@cj-tech-master/excelts";
+
+const workbook = new Workbook();
+await workbook.xlsx.readFile("input.xlsx");
+
+const worksheet = workbook.getWorksheet(1);
+worksheet.eachRow((row, rowNumber) => {
+  console.log("第 " + rowNumber + " 行 = " + JSON.stringify(row.values));
+});
+```
+
+### 单元格样式
+
+```javascript
+// 设置单元格值和样式
+const cell = worksheet.getCell("A1");
+cell.value = "你好";
+cell.font = {
+  name: "Arial",
+  size: 16,
+  bold: true,
+  color: { argb: "FFFF0000" }
+};
+cell.fill = {
+  type: "pattern",
+  pattern: "solid",
+  fgColor: { argb: "FFFFFF00" }
+};
+```
+
+## 功能特性
+
+- **Excel 操作**
+  - 创建、读取和修改 XLSX 文件
+  - 多工作表支持
+  - 单元格样式（字体、颜色、边框、填充）
+  - 单元格合并和格式化
+  - 行和列属性
+  - 冻结窗格和拆分视图
+
+- **数据处理**
+  - 富文本支持
+  - 公式和计算值
+  - 数据验证
+  - 条件格式
+  - 图片和图表
+  - 超链接
+  - 数据透视表
+
+- **高级功能**
+  - 大文件流式处理
+  - CSV 导入/导出
+  - 带自动筛选的表格
+  - 页面设置和打印选项
+  - 数据保护
+  - 注释和批注
+
+## 浏览器支持
+
+ExcelTS 同时支持 Node.js 和浏览器环境：
+
+````javascript
+```javascript
+// 浏览器使用
+import { Workbook } from "@cj-tech-master/excelts/browser";
+
+const workbook = new Workbook();
+// ... 使用 workbook API
+````
+
+## 系统要求
+
+### Node.js
+
+- **Node.js >= 18.0.0**（原生支持 ES2020）
+- 推荐：Node.js >= 20.0.0 以获得最佳性能
+
+### 浏览器（无需 Polyfills）
+
+- **Chrome >= 85**（2020年8月）
+- **Edge >= 85**（2020年8月）
+- **Firefox >= 79**（2020年7月）
+- **Safari >= 14**（2020年9月）
+- **Opera >= 71**（2020年9月）
+
+所有 ES2020 特性（可选链 `?.`、空值合并 `??`、Promise.allSettled 等）在这些版本中都原生支持。
+
+## 维护者
+
+本项目由 [CJ (@cjnoname)](https://github.com/cjnoname) 积极维护。
+
+### 维护状态
+
+**积极维护中** - 本项目处于积极维护状态，重点关注：
+
+- 🔒 **安全更新** - 及时的安全补丁和依赖项更新
+- 🐛 **Bug 修复** - 关键 Bug 修复和稳定性改进
+- 📦 **依赖管理** - 保持依赖项最新且安全
+- 🔍 **代码审查** - 审查和合并社区贡献
+
+### 贡献
+
+虽然我可能没有足够的时间定期开发新功能，但**非常重视和欢迎社区贡献！**
+
+- 💡 **欢迎 Pull Request** - 我会及时审查并合并高质量的 PR
+- 🚀 **功能提议** - 在实现前请先开 issue 讨论新功能
+- 🐛 **Bug 报告** - 请提供可重现的示例报告 Bug
+- 📖 **文档改进** - 始终欢迎文档改进
+
+## API 文档
+
+详细的 API 文档，请参考以下综合文档部分：
+
+- 工作簿管理
+- 工作表
+- 单元格和值
+- 样式
+- 公式
+- 数据验证
+- 条件格式
+- 文件输入输出
+
+API 与原始 ExcelJS 保持高度兼容。
+
+## 贡献指南
+
+欢迎贡献！请随时提交 Pull Request。
+
+### 提交 PR 前
+
+1. **Bug 修复**：在 `src/__test__` 文件夹中添加能重现问题的单元测试或集成测试
+2. **新功能**：先开 issue 讨论功能和实现方案
+3. **文档**：更新相关文档和类型定义
+4. **代码风格**：遵循现有代码风格并通过所有代码检查（`npm run lint`）
+5. **测试**：确保所有测试通过（`npm test`）并为新功能添加测试
+
+### 重要说明
+
+- **版本号**：请不要在 PR 中修改 package 版本。版本通过发布管理。
+- **许可证**：所有贡献都将包含在项目的 MIT 许可证下
+- **提交信息**：编写清晰、描述性的提交信息
+
+### 获取帮助
+
+如果需要帮助或有疑问：
+
+- 📖 查看现有的 [issues](https://github.com/cjnoname/excelts/issues) 和[文档](https://github.com/cjnoname/excelts)
+- 💬 开一个[新 issue](https://github.com/cjnoname/excelts/issues/new) 讨论
+- 🐛 使用 issue 模板报告 Bug
+
+## 许可证
+
+MIT License
+
+基于 [ExcelJS](https://github.com/exceljs/exceljs) 由 [Guyon Roche](https://github.com/guyonroche) 创建
+
+## 致谢
+
+本项目是 ExcelJS 的现代化分支。原始实现的所有功劳归于：
+
+- **Guyon Roche** - ExcelJS 原作者
+- 所有 [ExcelJS 贡献者](https://github.com/exceljs/exceljs/graphs/contributors)
+
+## 链接
+
+- [GitHub 仓库](https://github.com/cjnoname/exceljs)
+- [原始 ExcelJS](https://github.com/exceljs/exceljs)
+- [问题跟踪](https://github.com/cjnoname/exceljs/issues)
+
+## 更新日志
+
+### 0.1.0 (2025-10-24)
+
+- ExcelTS 首次发布
+- 完整的 TypeScript 重写，严格类型检查
+- 所有默认导出转换为命名导出
+- 所有依赖项更新到最新版本
+- 迁移到 Vitest 进行测试
+- 切换到 Rolldown 进行打包
+- 现代 ES Module 支持
+- Node 20+ 支持
+- 使用适当的访问修饰符增强类型安全
+- 浏览器测试支持
+- 性能优化

package/dist/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2014-2019 Guyon Roche
+
+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.
+