@svadmin/core 0.30.0 → 0.32.0

package/src/data-transfer.svelte.ts

@@ -1,6 +1,10 @@
-import { getDataProviderForResource } from './context.svelte';
+import { captureAdminContext } from './context.svelte';
 import { useParsed } from './useParsed.svelte';
 import type { Sort, Filter, BaseRecord } from './types';
+import { downloadData } from './export-format';
+import type { ExportFormat } from './export-format';
+export { downloadData, toCsv, toJson, toXlsx, escapeCsvField } from './export-format';
+export type { ExportFormat } from './export-format';
 
 export interface UseExportOptions<TData extends BaseRecord = BaseRecord> {
   resource?: string;
@@ -10,16 +14,19 @@ export interface UseExportOptions<TData extends BaseRecord = BaseRecord> {
   maxItemCount?: number;
   pageSize?: number;
   download?: boolean;
+  /** 导出格式，默认 csv（兼容旧版） */
+  format?: ExportFormat;
   meta?: Record<string, unknown>;
   dataProviderName?: string;
   onError?: (error: Error) => void;
 }
 
 /**
- * useExport — export records from a resource as CSV download
+ * useExport — export records from a resource as CSV/JSON/XLSX download
  * Supports mapData, sorters, filters, maxItemCount, pageSize
  */
 export function useExport<TData extends BaseRecord = BaseRecord>(options: UseExportOptions<TData> = {}) {
+  const adminContext = captureAdminContext();
   const parsed = useParsed();
   const resource = $derived(options.resource ?? parsed.resource ?? '');
   let isLoading = $state(false);
@@ -29,7 +36,7 @@ export function useExport<TData extends BaseRecord = BaseRecord>(options: UseExp
     isLoading = true;
 
     try {
-      const provider = getDataProviderForResource(exportResource, options.dataProviderName);
+      const provider = adminContext.getDataProviderForResource(exportResource, options.dataProviderName);
       const batchSize = options.pageSize ?? 20;
       const maxItems = options.maxItemCount ?? Infinity;
       let allRecords: TData[] = [];
@@ -57,29 +64,7 @@ export function useExport<TData extends BaseRecord = BaseRecord>(options: UseExp
         : allRecords.map(r => r as unknown as Record<string, unknown>);
 
       if (options.download !== false && typeof document !== 'undefined') {
-        const fields = Object.keys(mapped[0]);
-        const escapeCsvField = (s: string) => {
-          let val = s;
-          if (/^[=+@\t\r]/.test(val)) val = "'" + val;
-          return val.includes(',') || val.includes('"') || val.includes('\n') || val.includes('\r') ? `"${val.replace(/"/g, '""')}"` : val;
-        };
-        const header = fields.map(escapeCsvField).join(',');
-        const rows = mapped.map(record =>
-          fields.map(f => {
-            const val = record[f];
-            const str = val === null || val === undefined ? '' : typeof val === 'object' ? JSON.stringify(val) : String(val);
-            return escapeCsvField(str);
-          }).join(',')
-        );
-
-        const csv = [header, ...rows].join('\n');
-        const blob = new Blob(['\uFEFF' + csv], { type: 'text/csv;charset=utf-8;' });
-        const url = URL.createObjectURL(blob);
-        const a = document.createElement('a');
-        a.href = url;
-        a.download = `${exportResource}_export.csv`;
-        a.click();
-        setTimeout(() => URL.revokeObjectURL(url), 10000);
+        downloadData(mapped, exportResource, options.format ?? 'csv');
       }
 
       return allRecords;
@@ -99,6 +84,8 @@ export function useExport<TData extends BaseRecord = BaseRecord>(options: UseExp
 
 export interface UseImportOptions<TData = Record<string, unknown>> {
   resource?: string;
+  /** 指定导入文件格式；默认 auto = 根据文件扩展名推断。注意：import 仅支持 csv 和 json，不支持 xlsx 解析 */
+  format?: 'auto' | 'csv' | 'json';
   mapData?: (item: Record<string, unknown>) => TData;
   batchSize?: number;
   onFinish?: (result: { succeeded: unknown[]; errored: { request: unknown; error: unknown }[] }) => void;
@@ -112,6 +99,7 @@ export interface UseImportOptions<TData = Record<string, unknown>> {
  * Supports mapData, batchSize, onFinish, onProgress, meta
  */
 export function useImport<TData = Record<string, unknown>>(options: UseImportOptions<TData> = {}) {
+  const adminContext = captureAdminContext();
   const parsed = useParsed();
   const resource = $derived(options.resource ?? parsed.resource ?? '');
   let isLoading = $state(false);
@@ -124,28 +112,47 @@ export function useImport<TData = Record<string, unknown>>(options: UseImportOpt
     const errored: { request: unknown; error: unknown }[] = [];
 
     try {
-      const provider = getDataProviderForResource(importResource, options.dataProviderName);
+      const provider = adminContext.getDataProviderForResource(importResource, options.dataProviderName);
       let text = await info.file.text();
       // Strip BOM
       if (text.charCodeAt(0) === 0xFEFF) {
         text = text.slice(1);
       }
 
-      const rows = parseCSV(text);
-      if (rows.length < 2) {
-        mutationResult = { succeeded: [], errored: [] };
-        options.onFinish?.({ succeeded: [], errored: [] });
-        return;
-      }
+      // 自动检测或使用指定格式
+      const format = options.format ?? 'auto';
+      const isJson = format === 'json' || (format === 'auto' && info.file.name.toLowerCase().endsWith('.json'));
 
-      const headers = rows[0];
-      const records: Record<string, unknown>[] = [];
+      let records: Record<string, unknown>[];
 
-      for (let i = 1; i < rows.length; i++) {
-        const values = rows[i];
-        const record: Record<string, unknown> = {};
-        headers.forEach((h, idx) => { record[h] = values[idx] ?? ''; });
-        records.push(options.mapData ? (options.mapData(record) as unknown as Record<string, unknown>) : record);
+      if (isJson) {
+        // JSON 格式：期望数组对象
+        const parsed = JSON.parse(text);
+        if (!Array.isArray(parsed)) {
+          mutationResult = { succeeded: [], errored: [{ request: null, error: new Error('JSON import requires an array of objects') }] };
+          options.onFinish?.(mutationResult);
+          return;
+        }
+        records = parsed.map((item: unknown) =>
+          options.mapData ? (options.mapData(item as Record<string, unknown>) as unknown as Record<string, unknown>) : (item as Record<string, unknown>)
+        );
+      } else {
+        // CSV 格式
+        const rows = parseCSV(text);
+        if (rows.length < 2) {
+          mutationResult = { succeeded: [], errored: [] };
+          options.onFinish?.({ succeeded: [], errored: [] });
+          return;
+        }
+
+        const headers = rows[0];
+        records = [];
+        for (let i = 1; i < rows.length; i++) {
+          const values = rows[i];
+          const record: Record<string, unknown> = {};
+          headers.forEach((h, idx) => { record[h] = values[idx] ?? ''; });
+          records.push(options.mapData ? (options.mapData(record) as unknown as Record<string, unknown>) : record);
+        }
       }
 
       const batchSize = options.batchSize ?? 1;
@@ -198,13 +205,16 @@ export function useImport<TData = Record<string, unknown>>(options: UseImportOpt
   }
 
   return {
-    inputProps: { type: 'file' as const, accept: '.csv' },
+    inputProps: { type: 'file' as const, accept: '.csv,.json' },
     handleChange,
     get isLoading() { return isLoading; },
     get mutationResult() { return mutationResult; },
   };
 }
 
+
+// ─── 解析工具 ────────────────────────────────────────────────────
+
 /** Parse full CSV text respecting quoted multi-line fields */
 function parseCSV(text: string): string[][] {
   const rows: string[][] = [];

package/src/export-format.ts

@@ -0,0 +1,115 @@
+// 纯函数导出格式化工具 — 不依赖 Svelte runes 或浏览器 API（downloadData 除外）
+// 可被 bun:test 直接测试
+
+/** 支持的导出/导入格式 */
+export type ExportFormat = 'csv' | 'json' | 'xlsx';
+
+/** CSV 转义，含公式注入防护 */
+export function escapeCsvField(s: string): string {
+  let val = s;
+  if (/^[=+@\t\r]/.test(val)) val = "'" + val;
+  return val.includes(',') || val.includes('"') || val.includes('\n') || val.includes('\r')
+    ? `"${val.replace(/"/g, '""')}"`
+    : val;
+}
+
+/** 将记录数组转为 CSV 字符串 */
+export function toCsv(records: Record<string, unknown>[]): string {
+  if (records.length === 0) return '';
+  const fields = Object.keys(records[0]);
+  const header = fields.map(escapeCsvField).join(',');
+  const rows = records.map(record =>
+    fields.map(f => {
+      const val = record[f];
+      const str = val === null || val === undefined ? '' : typeof val === 'object' ? JSON.stringify(val) : String(val);
+      return escapeCsvField(str);
+    }).join(',')
+  );
+  return [header, ...rows].join('\n');
+}
+
+/** 将记录数组转为格式化的 JSON 字符串 */
+export function toJson(records: Record<string, unknown>[]): string {
+  return JSON.stringify(records, null, 2);
+}
+
+/** 转义 XML 特殊字符 */
+export function escapeXml(s: string): string {
+  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+
+/**
+ * 生成最小可用的 XLSX（SpreadsheetML）——零依赖。
+ */
+export function toXlsx(records: Record<string, unknown>[]): string {
+  if (records.length === 0) return '';
+  const fields = Object.keys(records[0]);
+
+  const headerCells = fields.map(f => `<Cell><Data ss:Type="String">${escapeXml(f)}</Data></Cell>`).join('');
+  const dataRows = records.map(record =>
+    `<Row>${fields.map(f => {
+      const val = record[f];
+      if (val === null || val === undefined) return '<Cell><Data ss:Type="String"></Data></Cell>';
+      if (typeof val === 'number') return `<Cell><Data ss:Type="Number">${val}</Data></Cell>`;
+      if (typeof val === 'boolean') return `<Cell><Data ss:Type="Boolean">${val ? 1 : 0}</Data></Cell>`;
+      const str = typeof val === 'object' ? JSON.stringify(val) : String(val);
+      return `<Cell><Data ss:Type="String">${escapeXml(str)}</Data></Cell>`;
+    }).join('')}</Row>`
+  ).join('\n');
+
+  return `<?xml version="1.0"?>
+<?mso-application progid="Excel.Sheet"?>
+<Workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
+ xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet">
+ <Worksheet ss:Name="Export">
+  <Table>
+   <Row>${headerCells}</Row>
+${dataRows}
+  </Table>
+ </Worksheet>
+</Workbook>`;
+}
+
+/**
+ * 将记录以指定格式下载为文件。
+ * 依赖浏览器 document API；在 Node/bun:test 中需 mock。
+ */
+export function downloadData(
+  records: Record<string, unknown>[],
+  resource: string,
+  format: ExportFormat = 'csv',
+): void {
+  if (records.length === 0) return;
+  if (typeof document === 'undefined') return;
+
+  let content: string;
+  let mimeType: string;
+  let ext: string;
+
+  switch (format) {
+    case 'json':
+      content = toJson(records);
+      mimeType = 'application/json;charset=utf-8;';
+      ext = 'json';
+      break;
+    case 'xlsx':
+      content = toXlsx(records);
+      mimeType = 'application/vnd.ms-excel;charset=utf-8;';
+      ext = 'xls';
+      break;
+    case 'csv':
+    default:
+      content = toCsv(records);
+      mimeType = 'text/csv;charset=utf-8;';
+      ext = 'csv';
+      break;
+  }
+
+  const blob = new Blob(['\uFEFF' + content], { type: mimeType });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url;
+  a.download = `${resource}_export.${ext}`;
+  a.click();
+  setTimeout(() => URL.revokeObjectURL(url), 10000);
+}