@uniai-fe/uds-primitives 0.2.3 → 0.2.5

package/src/components/input/utils/file.ts

@@ -0,0 +1,103 @@
+import type {
+  InputFileEntry,
+  InputFileFormDataOptions,
+  InputFileMeta,
+} from "../types";
+
+/**
+ * Input Utils; File Upload 확장자 추출 유틸
+ * @param {File} file 파일 객체
+ * @returns {string} 소문자 확장자
+ */
+export const resolveInputFileExtension = (file: File): string => {
+  const fileName = file.name ?? "";
+  const dotIndex = fileName.lastIndexOf(".");
+  if (dotIndex < 0 || dotIndex === fileName.length - 1) {
+    return "";
+  }
+  return fileName.slice(dotIndex + 1).toLowerCase();
+};
+
+/**
+ * Input Utils; File Upload 제목 추출 유틸
+ * @param {File} file 파일 객체
+ * @returns {string} 확장자를 제외한 파일 제목
+ */
+export const resolveInputFileTitle = (file: File): string => {
+  const fileName = file.name ?? "";
+  const dotIndex = fileName.lastIndexOf(".");
+  if (dotIndex <= 0) {
+    return fileName;
+  }
+  return fileName.slice(0, dotIndex);
+};
+
+/**
+ * Input Utils; File Upload 포맷 추출 유틸
+ * @param {File} file 파일 객체
+ * @returns {string} MIME type 또는 확장자 기반 fallback
+ */
+export const resolveInputFileFormat = (file: File): string => {
+  if (file.type.length > 0) {
+    return file.type;
+  }
+  const extension = resolveInputFileExtension(file);
+  return extension.length > 0 ? extension : "unknown";
+};
+
+/**
+ * Input Utils; File Upload 용량 포맷 유틸
+ * @param {number} size 파일 크기(Byte)
+ * @returns {string} 사람이 읽기 쉬운 용량 문자열
+ */
+export const formatInputFileSize = (size: number): string => {
+  if (size < 1024) {
+    return `${size} B`;
+  }
+  if (size < 1024 * 1024) {
+    return `${(size / 1024).toFixed(1)} KB`;
+  }
+  return `${(size / (1024 * 1024)).toFixed(1)} MB`;
+};
+
+/**
+ * Input Utils; File Upload 메타데이터 생성 유틸
+ * @param {InputFileEntry} entry 파일 엔트리
+ * @returns {InputFileMeta} 파일 메타데이터
+ */
+export const createInputFileMeta = (entry: InputFileEntry): InputFileMeta => {
+  const { file, id } = entry;
+  return {
+    id,
+    title: resolveInputFileTitle(file),
+    name: file.name,
+    size: file.size,
+    sizeLabel: formatInputFileSize(file.size),
+    format: resolveInputFileFormat(file),
+    extension: resolveInputFileExtension(file),
+    lastModified: file.lastModified,
+  };
+};
+
+/**
+ * Input Utils; File Upload FormData 직렬화 유틸
+ * @param {File[]} files 원본 파일 목록
+ * @param {InputFileFormDataOptions} [options] FormData 직렬화 옵션
+ * @param {string} [options.fieldName="files"] FormData append 필드명
+ * @returns {FormData} 파일이 append된 FormData
+ * @example
+ * const formData = createInputFileFormData(fileContext.files, {
+ *   fieldName: "attach_files",
+ * });
+ */
+export const createInputFileFormData = (
+  files: File[],
+  options?: InputFileFormDataOptions,
+): FormData => {
+  const formData = new FormData();
+  const fieldName = options?.fieldName ?? "files";
+  files.forEach(file => {
+    formData.append(fieldName, file);
+  });
+  return formData;
+};

package/src/components/input/utils/index.tsx

@@ -1,3 +1,4 @@
 export * from "./verification";
 export * from "./date";
 export * from "./address";
+export * from "./file";