nolo-cli 0.1.30 → 0.1.32

package/app/utils/excelToSlate.ts

@@ -1,430 +0,0 @@
-//  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

@@ -1,12 +0,0 @@
-// 文件路径: 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

@@ -1,229 +0,0 @@
-// 文件路径: 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 [];
-}