nolo-cli 0.1.26 → 0.1.29

package/app/utils/excelToSlate.ts

@@ -0,0 +1,430 @@
+//  app/utils/fileUtils.ts
+
+import { EditorContent } from "../../create/editor/utils/slateUtils";
+
+// --- 类型定义 ---
+
+/**
+ * 从 XLSX.utils.sheet_to_json 生成的每一行数据。
+ * key 为列标题（字符串），值为任意类型（字符串、数字、日期等）。
+ */
+export type ExcelRow = Record<string, any>;
+
+/**
+ * 转换配置：用于控制日期格式、本地化等。
+ */
+export interface ConvertExcelToSlateOptions {
+  /**
+   * 国际化 locale，如 "zh-CN" / "en-US"。
+   * 如果不传，则优先尝试浏览器语言，否则回退到 "en-US"。
+   */
+  locale?: string;
+
+  /**
+   * 用来识别“哪些表头看起来是日期列”的关键字（不区分大小写，使用 includes 匹配）。
+   * 例如：["date", "交期", "交货", "发货", "ETD", "ETA"]。
+   * 如果未传，将使用 DEFAULT_DATE_KEYWORDS。
+   */
+  dateKeywords?: string[];
+
+  /**
+   * 自定义“某个表头是否是日期列”的判断函数。
+   * 如果提供，将优先于 dateKeywords / 默认关键字。
+   */
+  isDateHeader?: (header: string) => boolean;
+
+  /**
+   * 对应 excelData 的“格式化显示数据”（通常来自 sheet_to_json(raw: false)）。
+   * - 用来保留百分比 / 货币 / 时间等 Excel 的显示文本。
+   * - 数组长度、每行的 key 应该与 excelData 对齐。
+   */
+  displayData?: ExcelRow[];
+}
+
+// --- 工具函数 ---
+
+/**
+ * 生成一段「文件为空 / 无有效列」的 Slate 内容。
+ */
+const buildSimpleInfoContent = (
+  fileName: string,
+  message: string
+): EditorContent => [
+    { type: "heading-one", children: [{ text: fileName }] },
+    {
+      type: "paragraph",
+      children: [{ text: message }],
+    },
+  ];
+
+/**
+ * 默认用于识别「日期列」的关键字（不区分大小写，使用 includes 匹配）。
+ * 注意：这是启发式规则，只是帮助在用户不配置时尽可能识别常见日期列。
+ */
+const DEFAULT_DATE_KEYWORDS = [
+  "交期",
+  "日期",
+  "交货",
+  "下单",
+  "发货",
+  "收货",
+  "到货",
+  "date",
+  "delivery",
+  "ship",
+  "etd",
+  "eta",
+  "due",
+];
+
+/**
+ * 对某些列，我们「不信任 Excel 的格式化结果（displayValue）」，
+ * 而是强制以原始数值 rawValue 为准。
+ *
+ * 当前只包含「定金」，后续有需要可以在这里扩展。
+ */
+const FORCE_RAW_HEADERS = ["定金"];
+const PERCENT_RATIO_HEADER_KEYWORDS = [
+  "%",
+  "％",
+  "百分比",
+  "比例",
+  "占比",
+  "比率",
+  "率",
+  "percent",
+  "percentage",
+  "ratio",
+  "rate",
+];
+
+const shouldForceUseRawValue = (header: string): boolean => {
+  const normalized = (header ?? "").trim();
+  if (!normalized) return false;
+
+  // 使用 includes 以兼容「定金(%)」「定金比例」等表头形式
+  return FORCE_RAW_HEADERS.some((name) => normalized.includes(name));
+};
+
+const isPercentRatioHeader = (header: string): boolean => {
+  const normalized = (header ?? "").trim().toLowerCase();
+  if (!normalized) return false;
+  return PERCENT_RATIO_HEADER_KEYWORDS.some((keyword) =>
+    normalized.includes(keyword)
+  );
+};
+
+/**
+ * 根据一组关键字，创建一个默认的“表头是否为日期列”的判断函数。
+ * 匹配规则：header.toLowerCase() 中包含任意一个关键字（includes）。
+ */
+const createIsDateHeaderFromKeywords = (keywords: string[]) => {
+  const loweredKeywords = keywords
+    .filter(Boolean)
+    .map((k) => k.toLowerCase().trim())
+    .filter((k) => k.length > 0);
+
+  return (header: string): boolean => {
+    const lower = (header ?? "").toLowerCase().trim();
+    if (!lower) return false;
+    return loweredKeywords.some((k) => lower.includes(k));
+  };
+};
+
+/**
+ * 是否是「看起来像 Excel 日期序列号」的数字。
+ * Excel 的日期序列号大致在 20000 ~ 60000 之间（对应 1950~2130 年）。
+ */
+const isLikelyExcelDateNumber = (value: number): boolean =>
+  value > 20000 && value < 60000;
+
+/**
+ * 将 Excel 序列号转换成 JS Date。
+ * 这里用 1899-12-30 作为基准（SheetJS / 常见实现的写法），
+ * 可以满足一般业务场景。
+ */
+const excelSerialToDate = (serial: number): Date => {
+  const millis = (serial - 25569) * 86400 * 1000; // 25569 为 1970-01-01 相对 1899-12-30 的天数
+  return new Date(millis);
+};
+
+/**
+ * 获取默认 locale：优先使用浏览器语言，其次 en-US。
+ */
+const getDefaultLocale = (): string => {
+  if (typeof navigator !== "undefined" && navigator.language) {
+    return navigator.language;
+  }
+  return "en-US";
+};
+
+/**
+ * 对「日期列」的值进行格式化。
+ * - 输入为原始值（Date / Excel 序列号 / string）
+ * - 输出为 locale 对应的日期字符串
+ */
+const formatDateLikeCellValue = (value: any, locale: string): string | null => {
+  if (value == null) return null;
+
+  let date: Date | null = null;
+
+  if (value instanceof Date) {
+    date = value;
+  } else if (typeof value === "number" && isLikelyExcelDateNumber(value)) {
+    // Excel 日期序列号
+    date = excelSerialToDate(value);
+  } else if (typeof value === "string") {
+    const parsed = new Date(value);
+    if (!Number.isNaN(parsed.getTime())) {
+      date = parsed;
+    }
+  }
+
+  if (!date) return null;
+
+  const formatter = new Intl.DateTimeFormat(locale, {
+    year: "numeric",
+    month: "long", // 中文: “12月”；英文: “December”
+    day: "numeric",
+  });
+  return formatter.format(date);
+};
+
+/**
+ * 将比例数值转成「百分比字符串」，尽量保留有效小数，而不是固定两位。
+ * 例如：
+ *   0.3443   -> "34.43%"
+ *   0.1      -> "10%"
+ *   0.123456789 -> "12.3456789%"
+ *
+ * 为了避免 JS 浮点误差，内部用较高精度 toFixed 再去掉多余 0。
+ */
+const formatRatioAsPercent = (ratio: number): string => {
+  const percent = ratio * 100;
+
+  // 整数直接输出，例如 0.1 -> 10%
+  if (Number.isInteger(percent)) {
+    return `${percent}%`;
+  }
+
+  // 这里给一个较大的上限，例如 12 位小数，基本够实际业务使用
+  const MAX_DECIMALS = 12;
+  let str = percent.toFixed(MAX_DECIMALS);
+
+  // 去掉多余的 0 和可能残留的小数点
+  str = str.replace(/\.?0+$/, "");
+
+  return `${str}%`;
+};
+
+/**
+ * 非日期列的值格式化逻辑：
+ * - 对某些「强制使用原始值」的列（如「定金」），用 rawValue 当作比例并转为百分比字符串；
+ *   例如 rawValue = 0.3443 -> "34.43%"，不截断到两位。
+ * - 对其他列：
+ *   - 如果提供了 displayValue（来自 raw:false 的 sheet_to_json），优先使用它：
+ *     这样可以保留百分比 / 货币 / 时间 等 Excel 的显示样式。
+ *   - 否则退回到 String(rawValue)。
+ */
+const formatNonDateCellValue = (
+  header: string,
+  rawValue: any,
+  displayValue: any
+): string => {
+  // 1. 对特殊列（例如「定金」），强制使用原始数值，并按比例转为百分比
+  if (shouldForceUseRawValue(header)) {
+    if (rawValue == null) return "";
+
+    if (typeof rawValue === "number") {
+      const n = rawValue;
+
+      // 约定：在 [0,1] 范围内的数当作比例，转成百分比
+      if (n >= 0 && n <= 1) {
+        return formatRatioAsPercent(n);
+      }
+
+      // 不在 [0,1]，按普通数值展示（比如定金金额，不是比例）
+      return String(n);
+    }
+
+    // 非 number 的情况，保底转字符串
+    return String(rawValue);
+  }
+
+  // 2. 其他列：优先采用 Excel 的显示文本（displayValue）
+  if (displayValue != null && displayValue !== "") {
+    return String(displayValue);
+  }
+
+  if (
+    typeof rawValue === "number" &&
+    rawValue >= 0 &&
+    rawValue <= 1 &&
+    isPercentRatioHeader(header)
+  ) {
+    return formatRatioAsPercent(rawValue);
+  }
+
+  if (rawValue == null) return "";
+  return String(rawValue);
+};
+
+/**
+ * 将单元格的值格式化为字符串。
+ * - 日期列：用 Intl.DateTimeFormat 按 locale 输出。
+ * - 其他列：优先用 displayValue（Excel 的格式化结果），
+ *   但对某些特殊列（如「定金」）强制使用 rawValue 并转为百分比。
+ */
+const formatCellValue = (
+  header: string,
+  rawValue: any,
+  displayValue: any,
+  locale: string,
+  isDateHeader: (header: string) => boolean
+): string => {
+  // 完全空值
+  if (rawValue == null && (displayValue == null || displayValue === "")) {
+    return "";
+  }
+
+  const headerIsDate = isDateHeader(header);
+
+  // 1. 日期列：优先尝试把各种类型统一转成 Date，再用 locale 格式化
+  if (headerIsDate) {
+    const formattedDate = formatDateLikeCellValue(rawValue, locale);
+    if (formattedDate != null) return formattedDate;
+
+    // 原始值无法解析成日期时，退回「非日期列」逻辑
+    return formatNonDateCellValue(header, rawValue, displayValue);
+  }
+
+  // 2. 非日期列：Excel 显示文本 + 特殊列强制 raw
+  return formatNonDateCellValue(header, rawValue, displayValue);
+};
+
+/**
+ * 从 excel 行数据中收集所有表头。
+ */
+const collectHeaders = (excelData: ExcelRow[]): string[] => {
+  const headerSet = new Set<string>();
+
+  excelData.forEach((row) => {
+    if (row && typeof row === "object") {
+      Object.keys(row).forEach((key) => headerSet.add(key));
+    }
+  });
+
+  return Array.from(headerSet);
+};
+
+/**
+ * 构建表头行节点。
+ */
+const buildHeaderRow = (headers: string[]) => ({
+  type: "table-row",
+  children: headers.map((header) => ({
+    type: "table-cell",
+    isHeader: true,
+    children: [{ text: header || "" }],
+  })),
+});
+
+/**
+ * 构建数据行节点。
+ */
+const buildDataRows = (
+  excelData: ExcelRow[],
+  headers: string[],
+  locale: string,
+  isDateHeader: (header: string) => boolean,
+  displayData?: ExcelRow[]
+) =>
+  excelData.map((row, rowIndex) => {
+    const displayRow = displayData?.[rowIndex];
+
+    return {
+      type: "table-row",
+      children: headers.map((header) => {
+        const rawValue =
+          row && typeof row === "object" ? (row as any)[header] : undefined;
+        const displayValue =
+          displayRow && typeof displayRow === "object"
+            ? (displayRow as any)[header]
+            : undefined;
+
+        const text = formatCellValue(
+          header,
+          rawValue,
+          displayValue,
+          locale,
+          isDateHeader
+        );
+
+        return {
+          type: "table-cell",
+          children: [{ text }],
+        };
+      }),
+    };
+  });
+
+// --- 主函数 ---
+
+/**
+ * 将 Excel/CSV 解析后的 JSON 行数据转换为 Slate.js 格式。
+ *
+ * @param excelData  - 由 XLSX.utils.sheet_to_json(raw: true) 生成的行数据数组。
+ * @param fileName   - 原始文件名，用作标题。
+ * @param options    - 配置项，用于控制 locale / 日期列等；
+ *                     其中 options.displayData 一般来自 sheet_to_json(raw: false)。
+ *
+ * @returns 符合 Slate.js 规范的 EditorContent 数组。
+ */
+export const convertExcelToSlate = (
+  excelData: ExcelRow[],
+  fileName: string,
+  options: ConvertExcelToSlateOptions = {}
+): EditorContent => {
+  const locale = options.locale ?? getDefaultLocale();
+
+  // 先从配置或默认关键字生成一个「日期列判断函数」
+  const keywords = options.dateKeywords ?? DEFAULT_DATE_KEYWORDS;
+  const defaultIsDateHeader = createIsDateHeaderFromKeywords(keywords);
+
+  // 如果用户传入了 isDateHeader，则优先使用；否则用默认关键字规则
+  const isDateHeader = options.isDateHeader ?? defaultIsDateHeader;
+
+  // 1. 早返回：无效或空数据
+  if (!excelData || !Array.isArray(excelData) || excelData.length === 0) {
+    return buildSimpleInfoContent(fileName, "表格文件为空或无法解析内容。");
+  }
+
+  // 2. 收集所有可能出现过的列头，避免丢失列
+  const headers = collectHeaders(excelData);
+
+  // 如果没有任何有效表头（例如所有行都是 {}），也视为无效内容
+  if (headers.length === 0) {
+    return buildSimpleInfoContent(fileName, "表格文件中没有找到有效的列标题。");
+  }
+
+  // 3. 构建表头行
+  const headerRow = buildHeaderRow(headers);
+
+  // 4. 构建数据行（这里会用到 raw + displayData）
+  const dataRows = buildDataRows(
+    excelData,
+    headers,
+    locale,
+    isDateHeader,
+    options.displayData
+  );
+
+  // 5. 返回最终的 Slate 内容：标题 + 表格
+  return [
+    { type: "heading-one", children: [{ text: fileName }] },
+    {
+      type: "table",
+      children: [headerRow, ...dataRows],
+    },
+  ];
+};

package/app/utils/fileReaders.ts

@@ -0,0 +1,12 @@
+// 文件路径: app/utils/fileReaders.ts
+export function readFileAsDataURL(file: File): Promise<string> {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onloadend = () => {
+            if (typeof reader.result === "string") resolve(reader.result);
+            else reject(new Error("Failed to read file as data URL"));
+        };
+        reader.onerror = () => reject(reader.error || new Error("File read error"));
+        reader.readAsDataURL(file);
+    });
+}

package/app/utils/fileUtils.ts

@@ -0,0 +1,229 @@
+// 文件路径: app/utils/fileUtils.ts
+
+import type { FileCategory } from "../types";
+
+const fileConstructor =
+  typeof globalThis !== "undefined" && typeof globalThis.File === "function"
+    ? globalThis.File
+    : undefined;
+
+export const isImageMimeType = (value: unknown): value is string =>
+  typeof value === "string" && value.toLowerCase().startsWith("image/");
+
+const IMAGE_FILE_NAME_RE = /\.(avif|bmp|gif|heic|heif|ico|jpe?g|png|svg|tiff?|webp)$/i;
+const VIDEO_FILE_NAME_RE = /\.(avi|m4v|mkv|mov|mp4|mpeg|mpg|webm)$/i;
+const AUDIO_FILE_NAME_RE = /\.(aac|flac|m4a|mp3|ogg|wav|weba)$/i;
+const DOCUMENT_FILE_NAME_RE =
+  /\.(csv|doc|docx|md|odt|pdf|ppt|pptx|rtf|txt|xls|xlsx)$/i;
+
+export const isImageFileName = (value: unknown): value is string =>
+  typeof value === "string" && IMAGE_FILE_NAME_RE.test(value.trim());
+
+export const formatFileSize = (bytes: number): string => {
+  if (!Number.isFinite(bytes) || bytes < 0) return "";
+  if (bytes === 0) return "0 B";
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  const unitIndex = Math.min(
+    Math.floor(Math.log(bytes) / Math.log(1024)),
+    units.length - 1
+  );
+  const value = bytes / Math.pow(1024, unitIndex);
+  const digits = value >= 10 || unitIndex === 0 ? 0 : 1;
+  return `${value.toFixed(digits)} ${units[unitIndex]}`;
+};
+
+const MIME_FORMAT_LABELS: Record<string, string> = {
+  "application/pdf": "PDF",
+  "application/msword": "DOC",
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "DOCX",
+  "application/vnd.ms-powerpoint": "PPT",
+  "application/vnd.openxmlformats-officedocument.presentationml.presentation": "PPTX",
+  "application/vnd.ms-excel": "XLS",
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "XLSX",
+  "text/plain": "TXT",
+  "text/markdown": "MD",
+  "image/jpeg": "JPG",
+  "image/png": "PNG",
+  "image/webp": "WEBP",
+  "image/gif": "GIF",
+  "video/mp4": "MP4",
+  "video/quicktime": "MOV",
+  "audio/mpeg": "MP3",
+  "audio/wav": "WAV",
+  "audio/x-wav": "WAV",
+  "audio/mp4": "M4A",
+};
+
+export const resolveFileFormatLabel = ({
+  fileName,
+  mimeType,
+}: {
+  fileName?: unknown;
+  mimeType?: unknown;
+}): string | null => {
+  if (typeof fileName === "string") {
+    const normalizedName = fileName.trim();
+    const ext = normalizedName.includes(".")
+      ? normalizedName.split(".").pop()?.trim().toUpperCase()
+      : "";
+    if (ext) return ext;
+  }
+
+  if (typeof mimeType === "string") {
+    const normalizedMimeType = mimeType.trim().toLowerCase();
+    if (MIME_FORMAT_LABELS[normalizedMimeType]) {
+      return MIME_FORMAT_LABELS[normalizedMimeType];
+    }
+    const [, subtype] = normalizedMimeType.split("/");
+    if (subtype) {
+      return subtype.split("+")[0]?.split(".").pop()?.toUpperCase() ?? null;
+    }
+  }
+
+  return null;
+};
+
+export const getCompactFileMetaLabel = ({
+  fileName,
+  mimeType,
+  fileSize,
+}: {
+  fileName?: unknown;
+  mimeType?: unknown;
+  fileSize?: unknown;
+}): string | null => {
+  const formatLabel = resolveFileFormatLabel({ fileName, mimeType });
+  const sizeLabel =
+    typeof fileSize === "number" && Number.isFinite(fileSize)
+      ? formatFileSize(fileSize)
+      : null;
+
+  if (formatLabel && sizeLabel) return `${formatLabel} · ${sizeLabel}`;
+  return formatLabel ?? sizeLabel;
+};
+
+export const isVideoMimeType = (value: unknown): value is string =>
+  typeof value === "string" && value.toLowerCase().startsWith("video/");
+
+export const isAudioMimeType = (value: unknown): value is string =>
+  typeof value === "string" && value.toLowerCase().startsWith("audio/");
+
+export const isPdfMimeType = (value: unknown): value is string =>
+  typeof value === "string" && value.toLowerCase() === "application/pdf";
+
+export const isDocumentMimeType = (value: unknown): value is string => {
+  if (typeof value !== "string") return false;
+  const normalized = value.toLowerCase();
+  return (
+    isPdfMimeType(normalized) ||
+    normalized === "text/plain" ||
+    normalized === "text/markdown" ||
+    normalized === "text/csv" ||
+    normalized === "application/msword" ||
+    normalized ===
+      "application/vnd.openxmlformats-officedocument.wordprocessingml.document" ||
+    normalized === "application/vnd.ms-powerpoint" ||
+    normalized ===
+      "application/vnd.openxmlformats-officedocument.presentationml.presentation" ||
+    normalized === "application/vnd.ms-excel" ||
+    normalized ===
+      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" ||
+    normalized === "application/rtf" ||
+    normalized === "application/vnd.oasis.opendocument.text"
+  );
+};
+
+export const resolveFileCategory = ({
+  mimeType,
+  fileName,
+}: {
+  mimeType?: unknown;
+  fileName?: unknown;
+}): FileCategory => {
+  if (isImageMimeType(mimeType) || isImageFileName(fileName)) return "image";
+  if (isVideoMimeType(mimeType) || (typeof fileName === "string" && VIDEO_FILE_NAME_RE.test(fileName.trim()))) {
+    return "video";
+  }
+  if (isAudioMimeType(mimeType) || (typeof fileName === "string" && AUDIO_FILE_NAME_RE.test(fileName.trim()))) {
+    return "audio";
+  }
+  if (isDocumentMimeType(mimeType) || (typeof fileName === "string" && DOCUMENT_FILE_NAME_RE.test(fileName.trim()))) {
+    return "document";
+  }
+  return "other";
+};
+
+export const isImageResourceLike = ({
+  kind,
+  mimeType,
+  fileName,
+  fileCategory,
+}: {
+  kind?: unknown;
+  mimeType?: unknown;
+  fileName?: unknown;
+  fileCategory?: unknown;
+}): boolean => {
+  if (fileCategory === "image") return true;
+  if (typeof kind === "string") {
+    const normalizedKind = kind.toLowerCase();
+    if (normalizedKind === "image" || isImageMimeType(normalizedKind)) {
+      return true;
+    }
+  }
+
+  return isImageMimeType(mimeType) || isImageFileName(fileName);
+};
+
+export const isBrowserFile = (value: unknown): value is File =>
+  !!fileConstructor && value instanceof fileConstructor;
+
+export const isImageFile = (value: unknown): value is File =>
+  isBrowserFile(value) && isImageMimeType(value.type);
+
+export const filterImageFiles = (values: Iterable<unknown>): File[] =>
+  Array.from(values).filter(isImageFile);
+
+/**
+ * 按是否为图片拆分文件数组:
+ * - 第 0 个数组是图片
+ * - 第 1 个数组是非图片
+ */
+export function splitFiles(files: File[]): [File[], File[]] {
+    return files.reduce(
+        (acc, file) => {
+            const index = isImageFile(file) ? 0 : 1;
+            acc[index].push(file);
+            return acc;
+        },
+        [[], []] as [File[], File[]]
+    );
+}
+
+/**
+ * 从 DataTransfer 中安全提取文件列表
+ * 兼容 dt.items 和 dt.files 两种情况
+ */
+export function extractFilesFromDataTransfer(
+    dt: DataTransfer | null
+): File[] {
+    if (!dt) return [];
+
+    const files: File[] = [];
+
+    if (dt.items && dt.items.length > 0) {
+        for (const item of Array.from(dt.items)) {
+            if (item.kind === "file") {
+                const file = item.getAsFile();
+                if (file) files.push(file);
+            }
+        }
+        if (files.length > 0) return files;
+    }
+
+    if (dt.files && dt.files.length > 0) {
+        return Array.from(dt.files);
+    }
+
+    return [];
+}