@ticatec/batch-data-uploader 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 henryfeng
+
+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,154 @@
+# Excel Batch Data Upload Component
+
+[[中文文档](./README_CN.md)]
+
+This component is designed to batch import data from Excel files and handle uploads. It supports upload status management, exporting error rows, multilingual adaptation, data preprocessing, and more. By defining template classes and using a unified UI dialog component, it enables quick adaptation for various types of Excel data upload needs.
+
+## Features
+
+* Parse `.xls` / `.xlsx` files
+* Custom column mapping and formatting
+* Batch upload with configurable batch size
+* Extensible data preprocessing logic (e.g., merging, grouping)
+* Upload status display: Pending, Uploading, Success, Failed
+* Export error rows to Excel
+* Multilingual support (based on `@ticatec/i18n`)
+
+---
+
+## Usage
+
+### Installation
+
+```bash
+npm i @ticatec/batch-data-uploader
+```
+
+### 1. Define a Template Class
+
+Extend `BaseTemplate`, provide field definitions and upload logic, and optionally override `consolidateData` to process data.
+
+```ts
+import BaseTemplate from '$lib/BaseTemplate';
+import type DataColumn from './DataColumn';
+
+class MyDataTemplate extends BaseTemplate {
+  constructor(uploadFun: UploadFun) {
+    const columns: DataColumn[] = [
+      { text: 'Name', field: 'name', pos: 0 },
+      { text: 'Email', field: 'email', pos: 1 },
+      { text: 'Age', field: 'age', pos: 2, parser: val => parseInt(val) },
+    ];
+    super(columns, uploadFun, 50);
+  }
+
+  // Optional: Override to implement merge/group logic
+  protected consolidateData(rows: Array<any>) {
+    return super.consolidateData(rows);
+  }
+}
+```
+
+### 2. Use the Upload Dialog Component
+
+```svelte
+<script lang="ts">
+  import UploadDialog from './UploadDialog.svelte';
+  import { MyDataTemplate } from './MyDataTemplate';
+
+  let showDialog = false;
+
+  function doUpload(rows: any[]): Promise<void> {
+    const dataChunk = rows.map(row => row.data);
+    return fetch('/api/upload', {
+      method: 'POST',
+      body: JSON.stringify(dataChunk),
+    }).then(res => {
+      if (!res.ok) throw new Error('Upload failed');
+      // After upload, write result info to row.error if needed
+    });
+  }
+
+  const template = new MyDataTemplate(doUpload);
+  
+  const showUploadDialog = () => {
+    window.Dialog.showModal(UploadDialog, {
+      title: 'Batch Add Employees',
+      template,
+    });
+  }
+</script>
+
+<button on:click={() => showUploadDialog()}>Import Data</button>
+```
+
+---
+
+## Parameter Reference
+
+### `BaseTemplate` Constructor Parameters
+
+| Name        | Type                            | Description                                  |
+| ----------- | ------------------------------- | -------------------------------------------- |
+| `columns`   | `DataColumn[]`                  | Defines column position and format           |
+| `uploadFun` | `(arr: any[]) => Promise<void>` | Upload function, called in batches           |
+| `batchSize` | `number` (default: 50)          | Number of rows per upload batch              |
+| `rowOffset` | `number` (default: 1)           | Row offset for data start (e.g. skip header) |
+
+### `DataColumn` Interface
+
+```ts
+interface DataColumn {
+  text: string;                // Column display text
+  field: string;               // Data field path (supports nesting)
+  pos: number;                 // Excel column index (starting from 0)
+  parser?: (val: any) => any;  // Optional parser function for cell values
+}
+```
+
+---
+
+## Upload Workflow
+
+1. User selects an Excel file
+2. Call `BaseTemplate.parseExcelFile(file)` to parse data
+3. Display preview data table with `Pending` status
+4. User clicks upload, system calls `uploadFun` in batches
+5. Mark successful items, retain `error` info for failed items
+6. Failed rows can be exported to Excel
+
+---
+
+## Exporting Error Data
+
+Use `BaseTemplate.exportErrorRowsToExcel(filename: string)` to export rows with errors as an Excel file, including original columns and error messages.
+
+---
+
+## Customization Options
+
+* **Custom Column Display**: Define column fields and formatting functions
+* **Custom Status Field**: Built-in `status` column, can be customized per business needs
+* **Data Cleaning & Validation**: Implement in `consolidateData()` method
+* **Multilingual Text**: Use `getI18nText` from `@ticatec/i18n`
+
+---
+
+## Dependencies
+
+* [`xlsx`](https://www.npmjs.com/package/xlsx)
+* [`@ticatec/uniface-element`](https://www.npmjs.com/package/@ticatec/uniface-element)
+* [`@ticatec/i18n`](https://www.npmjs.com/package/@ticatec/i18n)
+
+---
+
+## License
+
+MIT License.
+
+---
+
+## Author
+
+Henry Feng
+[huili.f@gmail.com](mailto:huili.f@gmail.com)

package/dist/BaseTemplate.d.ts

@@ -0,0 +1,54 @@
+import type DataColumn from "./DataColumn";
+import type { DataColumn as TableColumn } from "@ticatec/uniface-element/DataTable";
+export type UploadFun = (arr: Array<any>) => Promise<void>;
+export type UpdateProgressStatus = () => void;
+export default abstract class BaseTemplate {
+    protected readonly _columns: Array<DataColumn>;
+    protected readonly rowOffset: number;
+    protected _list: Array<any>;
+    protected uploadFun: UploadFun;
+    protected batchSize: number;
+    protected updateProgressStatus: UpdateProgressStatus | null;
+    /**
+     *
+     * @param columns
+     * @param uploadFun
+     * @param batchSize
+     * @param rowOffset
+     * @protected
+     */
+    protected constructor(columns: Array<DataColumn>, uploadFun: UploadFun, batchSize?: number, rowOffset?: number);
+    /**
+     * 状态更新的监听器
+     * @param value
+     */
+    setProgressStatusListener(value: UpdateProgressStatus): void;
+    /**
+     * 整理数据，在子类可以通过重载完成数据的二次处理
+     * @param rows
+     * @protected
+     */
+    protected consolidateData(rows: Array<any>): Array<any>;
+    /**
+     * 解析一个excel文件
+     * @param file
+     */
+    parseExcelFile(file: File): Promise<void>;
+    /**
+     * 上传数据
+     */
+    upload(): Promise<void>;
+    /**
+     * 获取表格的列定义
+     */
+    get columns(): Array<TableColumn>;
+    /**
+     * 获取数据
+     */
+    get list(): Array<any>;
+    /**
+     * 导出处理异常的数据
+     * @param filename
+     */
+    exportErrorRowsToExcel(filename: string): void;
+}

package/dist/BaseTemplate.js

@@ -0,0 +1,149 @@
+import * as XLSX from 'xlsx';
+import utils from "./utils";
+import { getI18nText } from "@ticatec/i18n";
+import i18nKeys from "./i18n_resources/i18nKeys";
+const statusColumn = {
+    text: "status",
+    width: 150,
+    resizable: true,
+    formatter: row => {
+        if (row.status == 'P') {
+            return getI18nText(i18nKeys.status.pending);
+        }
+        else if (row.status == 'U') {
+            return getI18nText(i18nKeys.status.uploading);
+        }
+        else {
+            if (row.error) {
+                return row.errorText;
+            }
+            else {
+                return getI18nText(i18nKeys.status.successful);
+            }
+        }
+    }
+};
+export default class BaseTemplate {
+    _columns;
+    rowOffset;
+    _list = [];
+    uploadFun;
+    batchSize;
+    updateProgressStatus = null;
+    /**
+     *
+     * @param columns
+     * @param uploadFun
+     * @param batchSize
+     * @param rowOffset
+     * @protected
+     */
+    constructor(columns, uploadFun, batchSize = 50, rowOffset = 1) {
+        this._columns = columns;
+        this.rowOffset = rowOffset;
+        this.uploadFun = uploadFun;
+        this.batchSize = batchSize;
+    }
+    /**
+     * 状态更新的监听器
+     * @param value
+     */
+    setProgressStatusListener(value) {
+        this.updateProgressStatus = value;
+    }
+    /**
+     * 整理数据，在子类可以通过重载完成数据的二次处理
+     * @param rows
+     * @protected
+     */
+    consolidateData(rows) {
+        return rows;
+    }
+    /**
+     * 解析一个excel文件
+     * @param file
+     */
+    async parseExcelFile(file) {
+        const buffer = await file.arrayBuffer();
+        const workbook = XLSX.read(buffer, { type: 'array' });
+        const sheet = workbook.Sheets[workbook.SheetNames[0]];
+        const range = XLSX.utils.decode_range(sheet['!ref'] || ''); // 获取范围
+        const rows = [];
+        for (let rowIndex = range.s.r + 1 + this.rowOffset; rowIndex <= range.e.r; rowIndex++) {
+            const rowObject = {};
+            for (const colDef of this._columns) {
+                const cellAddress = { r: rowIndex, c: colDef.pos };
+                const cellRef = XLSX.utils.encode_cell(cellAddress);
+                const cell = sheet[cellRef];
+                const rawValue = cell?.v;
+                const formattedValue = colDef.parser ? colDef.parser(rawValue) : rawValue;
+                utils.setNestedValue(rowObject, colDef.field, formattedValue);
+            }
+            rows.push({ data: rowObject, status: 'P' });
+        }
+        this._list = this.consolidateData(rows);
+    }
+    /**
+     * 上传数据
+     */
+    async upload() {
+        for (let i = 0; i < this.list.length; i += this.batchSize) {
+            const chunk = this.list.slice(i, i + this.batchSize);
+            chunk.forEach(item => item.status = 'U');
+            this.updateProgressStatus?.();
+            await this.uploadFun(chunk);
+            chunk.forEach(item => item.status = 'D');
+            this.updateProgressStatus?.();
+        }
+    }
+    /**
+     * 获取表格的列定义
+     */
+    get columns() {
+        let columns = this._columns.map(col => ({ ...col, field: `data.${col.field}` }));
+        return [...columns, statusColumn];
+    }
+    /**
+     * 获取数据
+     */
+    get list() {
+        return [...this._list];
+    }
+    /**
+     * 导出处理异常的数据
+     * @param filename
+     */
+    exportErrorRowsToExcel(filename) {
+        // 筛选出有错误的行
+        const errorRows = this._list.filter(row => row.error != null);
+        // 生成 Excel 数据（第一行为标题）
+        const header = [...this._columns.map(col => col.text), getI18nText(i18nKeys.errorTitle)];
+        const data = errorRows.map(row => {
+            const values = this._columns.map(col => {
+                return utils.getNestedValue(row.data, col.field);
+            });
+            return [...values, row.error];
+        });
+        const worksheetData = [header, ...data];
+        const worksheet = XLSX.utils.aoa_to_sheet(worksheetData);
+        const workbook = XLSX.utils.book_new();
+        XLSX.utils.book_append_sheet(workbook, worksheet, getI18nText(i18nKeys.sheetName));
+        const wbout = XLSX.write(workbook, {
+            bookType: 'xlsx',
+            type: 'array'
+        });
+        // 创建 Blob 并触发下载
+        const blob = new Blob([wbout], {
+            type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+        });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = filename;
+        a.style.display = 'none';
+        document.body.appendChild(a);
+        a.click();
+        document.body.removeChild(a);
+        URL.revokeObjectURL(url);
+    }
+}

package/dist/DataColumn.d.ts

@@ -0,0 +1,16 @@
+import type { DataColumn as TableColumn } from "@ticatec/uniface-element/DataTable";
+export type ParserText = (text: string) => any;
+export default interface DataColumn extends TableColumn {
+    /**
+     * 在excel中的列号
+     */
+    pos: number;
+    /**
+     * 对于的字段名
+     */
+    field: string;
+    /**
+     * 解析函数
+     */
+    parser?: ParserText;
+}

package/dist/DataColumn.js

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

package/dist/FileUploadWizard.svelte

@@ -0,0 +1,136 @@
+<script lang="ts">
+    import Dialog from "@ticatec/uniface-element/Dialog";
+    import type {ButtonAction, ButtonActions} from "@ticatec/uniface-element/ActionBar";
+    import DataTable, {type IndicatorColumn} from "@ticatec/uniface-element/DataTable";
+    import i18n, {getI18nText} from "@ticatec/i18n";
+    import Box from "@ticatec/uniface-element/Box"
+    import {onMount} from "svelte";
+    import type BaseTemplate from "./BaseTemplate";
+    import type DataColumn from "@ticatec/uniface-element/DataTable";
+    import i18nKeys from "./i18n_resources/i18nKeys";
+
+    export let title: string;
+
+    export let width: string = "800px";
+    export let height: string = "600px"
+
+    export let closeHandler: any;
+    export let template: BaseTemplate;
+
+    type ProcessStatus = 'Init' | 'Pending' | 'Uploading' | 'Done';  //初始状态，待上传，上传中，处理完成
+
+    let status: ProcessStatus = 'Init';
+
+
+    const btnChoose: ButtonAction = {
+        label: getI18nText(i18nKeys.button.open),
+        type: 'primary',
+        handler: () => {
+            uploadField.click();
+        }
+    }
+
+    const btnUpload: ButtonAction = {
+        label: getI18nText(i18nKeys.button.upload),
+        type: 'primary',
+        handler: async ()=> {
+            status = 'Uploading';
+            try {
+                await template.upload();
+            } finally {
+                status = 'Done';
+            }
+        }
+    }
+
+    const btnSave: ButtonAction = {
+        label: getI18nText(i18nKeys.button.save),
+        type: 'primary',
+        handler: async ()=> {
+            template.exportErrorRowsToExcel(`error-${filename}`);
+        }
+    }
+
+    let actions: ButtonActions = [btnChoose];
+    let uploadField: any;
+    let list: Array<any> = [];
+    let filename: string;
+
+    const parseExcelFile = async (excelFile: File) => {
+        filename = excelFile.name;
+        window.Indicator.show(getI18nText(i18nKeys.parsing));
+        try {
+            await template.parseExcelFile(excelFile);
+            list = template.list;
+            status = list.length > 0 ? 'Pending' : 'Init';
+        } catch (ex) {
+            window.Toast.show(getI18nText(i18nKeys.parseFailure, {name: excelFile.name}));
+        } finally {
+            window.Indicator.hide();
+        }
+    }
+
+
+    let columns: Array<DataColumn>;
+
+    onMount(async () => {
+        columns = template.columns;
+        template.setProgressStatusListener(()=> {
+            list = template.list;
+        })
+    });
+
+
+
+    const indicatorColumn: IndicatorColumn = {
+        width: 60,
+        selectable: false,
+        displayNo: true
+    }
+
+
+    $: {
+        switch (status) {
+            case 'Init':
+                actions = [btnChoose];
+                break;
+            case 'Pending':
+                actions = [btnUpload, btnChoose];
+                break;
+            case 'Uploading':
+                btnUpload.disabled = true;
+                btnChoose.disabled = true;
+                actions = [...actions];
+                break;
+            case 'Done':
+                btnUpload.disabled = false;
+                btnChoose.disabled = false;
+                const hasError = list.filter(item => item.error == null).length != list.length;
+                actions = hasError ? [btnSave, btnChoose] : [btnChoose];
+                break;
+        }
+    }
+
+
+    const confirmCloseDialog = async ():Promise<boolean> => {
+        if (status == 'Uploading') {
+            window.Toast.show(getI18nText(i18nKeys.waitUploading));
+            return false;
+        } else {
+            return true;
+        }
+    }
+
+</script>
+
+<Dialog {title} {closeHandler} {actions} closeConfirm={confirmCloseDialog}
+        content$style="width: {width}; height: {height}; padding: 12px;">
+    <Box style="border: 1px solid var(--uniface-editor-border-color, #F8FAFC); width: 100%; height: 100%; cursor: {status == 'Uploading' ? 'progress' : 'default'}" round>
+        <DataTable style="width: 100%; height: 100%" {list} {indicatorColumn} {columns}>
+
+        </DataTable>
+    </Box>
+    <input type="file" bind:this={uploadField} on:change={(e) => parseExcelFile(e.target.files?.[0])} style="display: none"
+           accept=".xls,.xlsx,application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet">
+
+</Dialog>

package/dist/FileUploadWizard.svelte.d.ts

@@ -0,0 +1,25 @@
+import type BaseTemplate from "./BaseTemplate";
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: Props & {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const FileUploadWizard: $$__sveltets_2_IsomorphicComponent<{
+    title: string;
+    width?: string;
+    height?: string;
+    closeHandler: any;
+    template: BaseTemplate;
+}, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type FileUploadWizard = InstanceType<typeof FileUploadWizard>;
+export default FileUploadWizard;

package/dist/i18n_resources/batch_cn_resource.d.ts

@@ -0,0 +1,21 @@
+declare const langRes: {
+    batchUploading: {
+        status: {
+            pending: string;
+            uploading: string;
+            successful: string;
+            fail: string;
+        };
+        parsing: string;
+        parseFailure: string;
+        waitUploading: string;
+        button: {
+            upload: string;
+            save: string;
+            open: string;
+        };
+        errorTitle: string;
+        sheetName: string;
+    };
+};
+export default langRes;

package/dist/i18n_resources/batch_cn_resource.js

@@ -0,0 +1,21 @@
+const langRes = {
+    batchUploading: {
+        status: {
+            pending: '待上传',
+            uploading: "上传中...",
+            successful: '处理成功',
+            fail: '处理失败'
+        },
+        parsing: '解析文件...',
+        parseFailure: '无法解析文件{{name}}',
+        waitUploading: '上传过程中无法退出!',
+        button: {
+            upload: '上传',
+            save: '导出异常',
+            open: '文件'
+        },
+        errorTitle: '异常原因',
+        sheetName: '错误数据'
+    }
+};
+export default langRes;

package/dist/i18n_resources/batch_en_resource.d.ts

@@ -0,0 +1,21 @@
+declare const langRes: {
+    batchUploading: {
+        status: {
+            pending: string;
+            uploading: string;
+            successful: string;
+            fail: string;
+        };
+        parsing: string;
+        parseFailure: string;
+        waitUploading: string;
+        button: {
+            upload: string;
+            save: string;
+            open: string;
+        };
+        errorTitle: string;
+        sheetName: string;
+    };
+};
+export default langRes;

package/dist/i18n_resources/batch_en_resource.js

@@ -0,0 +1,21 @@
+const langRes = {
+    batchUploading: {
+        status: {
+            pending: 'To upload',
+            uploading: "Uploading...",
+            successful: 'Success',
+            fail: 'Failure'
+        },
+        parsing: 'Parsing file...',
+        parseFailure: 'Cannot parse file: {{name}}',
+        waitUploading: 'Cannot exit on uploading!',
+        button: {
+            upload: 'Upload',
+            save: 'Error data',
+            open: 'File'
+        },
+        errorTitle: 'Error',
+        sheetName: 'Abnormal data'
+    }
+};
+export default langRes;

package/dist/i18n_resources/i18nKeys.d.ts

@@ -0,0 +1,55 @@
+declare const i18nKeys: {
+    status: {
+        pending: {
+            key: string;
+            text: string;
+        };
+        uploading: {
+            key: string;
+            text: string;
+        };
+        successful: {
+            key: string;
+            text: string;
+        };
+        fail: {
+            key: string;
+            text: string;
+        };
+    };
+    parsing: {
+        key: string;
+        text: string;
+    };
+    parseFailure: {
+        key: string;
+        text: string;
+    };
+    waitUploading: {
+        key: string;
+        text: string;
+    };
+    button: {
+        upload: {
+            key: string;
+            text: string;
+        };
+        save: {
+            key: string;
+            text: string;
+        };
+        open: {
+            key: string;
+            text: string;
+        };
+    };
+    errorTitle: {
+        key: string;
+        text: string;
+    };
+    sheetName: {
+        key: string;
+        text: string;
+    };
+};
+export default i18nKeys;

package/dist/i18n_resources/i18nKeys.js

@@ -0,0 +1,56 @@
+import langRes from "./batch_en_resource";
+const i18nKeys = {
+    status: {
+        pending: {
+            key: "batchUploading.status.pending",
+            text: langRes.batchUploading.status.pending
+        },
+        uploading: {
+            key: "batchUploading.status.uploading",
+            text: langRes.batchUploading.status.uploading
+        },
+        successful: {
+            key: "batchUploading.status.successful",
+            text: langRes.batchUploading.status.successful
+        },
+        fail: {
+            key: "batchUploading.status.fail",
+            text: langRes.batchUploading.status.fail
+        }
+    },
+    parsing: {
+        key: 'batchUploading.parsing',
+        text: langRes.batchUploading.parsing
+    },
+    parseFailure: {
+        key: 'batchUploading.parseFailure',
+        text: langRes.batchUploading.parseFailure
+    },
+    waitUploading: {
+        key: 'batchUploading.waitUploading',
+        text: langRes.batchUploading.waitUploading
+    },
+    button: {
+        upload: {
+            key: 'batchUploading.button.upload',
+            text: langRes.batchUploading.button.upload
+        },
+        save: {
+            key: 'batchUploading.button.save',
+            text: langRes.batchUploading.button.save
+        },
+        open: {
+            key: 'batchUploading.button.open',
+            text: langRes.batchUploading.button.open
+        }
+    },
+    errorTitle: {
+        key: 'batchUploading.errorTitle',
+        text: langRes.batchUploading.errorTitle
+    },
+    sheetName: {
+        key: 'batchUploading.sheetName',
+        text: langRes.batchUploading.sheetName
+    }
+};
+export default i18nKeys;

package/dist/i18n_resources/index.d.ts

@@ -0,0 +1,3 @@
+import cn_resource from "./batch_cn_resource";
+import en_resource from "./batch_en_resource";
+export { cn_resource, en_resource };

package/dist/i18n_resources/index.js

@@ -0,0 +1,3 @@
+import cn_resource from "./batch_cn_resource";
+import en_resource from "./batch_en_resource";
+export { cn_resource, en_resource };

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import FileUploadWizard from "./FileUploadWizard.svelte";
+export default FileUploadWizard;

package/dist/index.js

@@ -0,0 +1,2 @@
+import FileUploadWizard from "./FileUploadWizard.svelte";
+export default FileUploadWizard;

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    setNestedValue: (obj: any, path: string, value: any) => void;
+    getNestedValue: (obj: any, path: string) => any;
+};
+export default _default;

package/dist/utils.js

@@ -0,0 +1,22 @@
+const setNestedValue = (obj, path, value) => {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        if (!current[keys[i]])
+            current[keys[i]] = {};
+        current = current[keys[i]];
+    }
+    current[keys[keys.length - 1]] = value;
+};
+/**
+ * 获取嵌套属性的值
+ * @param obj
+ * @param path
+ */
+const getNestedValue = (obj, path) => {
+    return path.split('.').reduce((acc, key) => acc?.[key], obj);
+};
+export default {
+    setNestedValue,
+    getNestedValue
+};

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@ticatec/batch-data-uploader",
+  "version": "0.0.1",
+  "description": "A reusable Svelte component for batch uploading Excel data with support for error handling, multi-language, and preprocessing.",
+  "scripts": {
+    "dev": "vite dev",
+    "build": "svelte-kit sync && svelte-package",
+    "package": "svelte-kit sync && svelte-package && publint",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+    "publish:public": "npm run build && npm publish --access public"
+  },
+  "keywords": [
+    "excel",
+    "upload",
+    "svelte",
+    "component",
+    "batch",
+    "uploader",
+    "xlsx",
+    "i18n"
+  ],
+  "files": [
+    "dist",
+    "!dist/**/*.scss",
+    "!dist/**/*.test.*",
+    "!dist/**/*.spec.*"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "main": "dist/index.js",
+  "svelte": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./BaseTemplate": {
+      "types": "./dist/BaseTemplate.d.ts",
+      "import": "./dist/BaseTemplate.js"
+    },
+    "./DataColumn": {
+      "types": "./dist/DataColumn.d.ts",
+      "import": "./dist/DataColumn.js"
+    },
+    "./FileUploadWizard.svelte": {
+      "types": "./dist/FileUploadWizard.svelte.d.ts",
+      "import": "./dist/FileUploadWizard.svelte"
+    }
+  },
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "devDependencies": {
+    "@sveltejs/adapter-auto": "^4.0.0",
+    "@sveltejs/adapter-static": "^3.0.8",
+    "@sveltejs/kit": "^2.0.0",
+    "@sveltejs/package": "^2.0.0",
+    "@sveltejs/vite-plugin-svelte": "^4.0.0",
+    "@ticatec/i18n": "^0.0.8",
+    "@ticatec/uniface-element": "^0.1.52",
+    "@ticatec/uniface-google-material-icons": "^0.1.2",
+    "dayjs": "^1.11.10",
+    "publint": "^0.3.2",
+    "sass": "^1.57.1",
+    "svelte": "^5.0.0",
+    "svelte-check": "^4.0.0",
+    "svelte-portal": "^2.2.1",
+    "svelte-preprocess": "^6.0.3",
+    "tslib": "^2.3.1",
+    "typescript": "^5.7.3",
+    "vite": "^5.4.11"
+  },
+  "author": "Henry Feng",
+  "license": "MIT",
+  "private": false,
+  "dependencies": {
+    "xlsx": "^0.18.5"
+  }
+}