@sia-ui/utils 0.1.0

package/dist/file.cjs

@@ -0,0 +1,141 @@
+'use strict';
+
+// src/file.ts
+var UNITS = ["o", "ko", "Mo", "Go", "To"];
+function formatBytes(bytes, options = {}) {
+  const { decimals = 1, locale = "fr-FR" } = options;
+  if (!Number.isFinite(bytes) || bytes <= 0) return "0 o";
+  const exponent = Math.min(
+    Math.floor(Math.log(bytes) / Math.log(1024)),
+    UNITS.length - 1
+  );
+  const value = bytes / 1024 ** exponent;
+  return `${value.toLocaleString(locale, {
+    // Les octets n'ont pas de décimale : « 1 024,0 o » n'a pas de sens.
+    maximumFractionDigits: exponent === 0 ? 0 : decimals
+  })} ${UNITS[exponent]}`;
+}
+function extension(name) {
+  const index = name.lastIndexOf(".");
+  if (index <= 0 || index === name.length - 1) return "";
+  return name.slice(index + 1).toLowerCase();
+}
+function baseName(name) {
+  const index = name.lastIndexOf(".");
+  return index <= 0 ? name : name.slice(0, index);
+}
+var BY_EXTENSION = {
+  jpg: "image",
+  jpeg: "image",
+  png: "image",
+  gif: "image",
+  webp: "image",
+  avif: "image",
+  svg: "image",
+  bmp: "image",
+  heic: "image",
+  mp4: "video",
+  webm: "video",
+  mov: "video",
+  avi: "video",
+  mkv: "video",
+  mp3: "audio",
+  wav: "audio",
+  ogg: "audio",
+  m4a: "audio",
+  flac: "audio",
+  pdf: "pdf",
+  zip: "archive",
+  rar: "archive",
+  "7z": "archive",
+  tar: "archive",
+  gz: "archive",
+  xls: "spreadsheet",
+  xlsx: "spreadsheet",
+  csv: "spreadsheet",
+  ods: "spreadsheet",
+  doc: "document",
+  docx: "document",
+  odt: "document",
+  txt: "document",
+  rtf: "document",
+  md: "document"
+};
+function fileKind(file) {
+  if (typeof file !== "string" && file.type) {
+    const [group] = file.type.split("/");
+    if (group === "image") return "image";
+    if (group === "video") return "video";
+    if (group === "audio") return "audio";
+    if (file.type === "application/pdf") return "pdf";
+  }
+  const name = typeof file === "string" ? file : file.name;
+  return BY_EXTENSION[extension(name)] ?? "other";
+}
+function isImage(file) {
+  return fileKind(file) === "image";
+}
+function exceedsSize(file, maxMegabytes) {
+  return file.size > maxMegabytes * 1024 * 1024;
+}
+function matchesAccept(file, accept) {
+  const rules = accept.split(",").map((rule) => rule.trim().toLowerCase()).filter(Boolean);
+  if (rules.length === 0) return true;
+  const type = file.type.toLowerCase();
+  const ext = `.${extension(file.name)}`;
+  return rules.some((rule) => {
+    if (rule.startsWith(".")) return rule === ext;
+    if (rule.endsWith("/*")) return type.startsWith(rule.slice(0, -1));
+    return rule === type;
+  });
+}
+function requireBrowser(what) {
+  if (typeof window === "undefined") {
+    throw new Error(`${what} n'est disponible que dans un navigateur.`);
+  }
+}
+function readAsDataUrl(file) {
+  requireBrowser("readAsDataUrl");
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(String(reader.result));
+    reader.onerror = () => reject(reader.error ?? new Error("Lecture \xE9chou\xE9e"));
+    reader.readAsDataURL(file);
+  });
+}
+function readAsText(file, encoding = "utf-8") {
+  requireBrowser("readAsText");
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(String(reader.result));
+    reader.onerror = () => reject(reader.error ?? new Error("Lecture \xE9chou\xE9e"));
+    reader.readAsText(file, encoding);
+  });
+}
+function downloadBlob(blob, filename) {
+  requireBrowser("downloadBlob");
+  const url = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = filename;
+  document.body.appendChild(link);
+  link.click();
+  link.remove();
+  URL.revokeObjectURL(url);
+}
+function downloadText(content, filename, type = "text/plain;charset=utf-8") {
+  const prefix = type.startsWith("text/csv") ? "\uFEFF" : "";
+  downloadBlob(new Blob([prefix + content], { type }), filename);
+}
+
+exports.baseName = baseName;
+exports.downloadBlob = downloadBlob;
+exports.downloadText = downloadText;
+exports.exceedsSize = exceedsSize;
+exports.extension = extension;
+exports.fileKind = fileKind;
+exports.formatBytes = formatBytes;
+exports.isImage = isImage;
+exports.matchesAccept = matchesAccept;
+exports.readAsDataUrl = readAsDataUrl;
+exports.readAsText = readAsText;

package/dist/file.d.cts

@@ -0,0 +1,58 @@
+/**
+ * Fichiers.
+ *
+ * Trois de ces fonctions touchent le navigateur — `FileReader`, `document`.
+ * Elles lèvent une erreur explicite côté serveur plutôt que de planter sur un
+ * `document is not defined` incompréhensible dans une trace de rendu serveur.
+ */
+interface FormatBytesOptions {
+    decimals?: number;
+    locale?: string;
+}
+/**
+ * Une taille lisible : `1,4 Mo`.
+ *
+ * Base 1024, unités décimales — la convention de tous les systèmes de
+ * fichiers grand public. Les puristes écrivent `Mio`; personne ne le lit.
+ */
+declare function formatBytes(bytes: number, options?: FormatBytesOptions): string;
+/** L'extension, en minuscules, sans le point. Vide s'il n'y en a pas. */
+declare function extension(name: string): string;
+/** Le nom sans son extension. */
+declare function baseName(name: string): string;
+type FileKind = "image" | "video" | "audio" | "pdf" | "archive" | "spreadsheet" | "document" | "other";
+/**
+ * Le genre d'un fichier.
+ *
+ * Le type MIME est consulté en premier quand il est là — il vient du système
+ * —, l'extension sert de repli. Un `.csv` arrive régulièrement en
+ * `application/vnd.ms-excel`, d'où la double lecture.
+ */
+declare function fileKind(file: File | string): FileKind;
+declare function isImage(file: File | string): boolean;
+/** Vrai si le fichier dépasse la limite, exprimée en mégaoctets. */
+declare function exceedsSize(file: File, maxMegabytes: number): boolean;
+/**
+ * Vrai si le fichier correspond à la liste d'acceptation d'un `<input>`.
+ *
+ * Même grammaire que l'attribut `accept` : `image/*`, `.pdf`,
+ * `application/pdf`. Le navigateur filtre déjà à la sélection, mais pas au
+ * glisser-déposer — c'est là que cette fonction sert.
+ */
+declare function matchesAccept(file: File, accept: string): boolean;
+/** Lit un fichier en `data:` URL — un aperçu d'image avant téléversement. */
+declare function readAsDataUrl(file: Blob): Promise<string>;
+/** Lit un fichier en texte — un CSV, un JSON déposé. */
+declare function readAsText(file: Blob, encoding?: string): Promise<string>;
+/**
+ * Propose un téléchargement.
+ *
+ * L'URL objet est révoquée après coup : sans cela, le contenu reste en
+ * mémoire jusqu'au rechargement de la page — ce qui se voit sur un export de
+ * plusieurs mégaoctets répété.
+ */
+declare function downloadBlob(blob: Blob, filename: string): void;
+/** Télécharge du texte — un CSV construit côté client. */
+declare function downloadText(content: string, filename: string, type?: string): void;
+
+export { type FileKind, type FormatBytesOptions, baseName, downloadBlob, downloadText, exceedsSize, extension, fileKind, formatBytes, isImage, matchesAccept, readAsDataUrl, readAsText };

package/dist/file.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Fichiers.
+ *
+ * Trois de ces fonctions touchent le navigateur — `FileReader`, `document`.
+ * Elles lèvent une erreur explicite côté serveur plutôt que de planter sur un
+ * `document is not defined` incompréhensible dans une trace de rendu serveur.
+ */
+interface FormatBytesOptions {
+    decimals?: number;
+    locale?: string;
+}
+/**
+ * Une taille lisible : `1,4 Mo`.
+ *
+ * Base 1024, unités décimales — la convention de tous les systèmes de
+ * fichiers grand public. Les puristes écrivent `Mio`; personne ne le lit.
+ */
+declare function formatBytes(bytes: number, options?: FormatBytesOptions): string;
+/** L'extension, en minuscules, sans le point. Vide s'il n'y en a pas. */
+declare function extension(name: string): string;
+/** Le nom sans son extension. */
+declare function baseName(name: string): string;
+type FileKind = "image" | "video" | "audio" | "pdf" | "archive" | "spreadsheet" | "document" | "other";
+/**
+ * Le genre d'un fichier.
+ *
+ * Le type MIME est consulté en premier quand il est là — il vient du système
+ * —, l'extension sert de repli. Un `.csv` arrive régulièrement en
+ * `application/vnd.ms-excel`, d'où la double lecture.
+ */
+declare function fileKind(file: File | string): FileKind;
+declare function isImage(file: File | string): boolean;
+/** Vrai si le fichier dépasse la limite, exprimée en mégaoctets. */
+declare function exceedsSize(file: File, maxMegabytes: number): boolean;
+/**
+ * Vrai si le fichier correspond à la liste d'acceptation d'un `<input>`.
+ *
+ * Même grammaire que l'attribut `accept` : `image/*`, `.pdf`,
+ * `application/pdf`. Le navigateur filtre déjà à la sélection, mais pas au
+ * glisser-déposer — c'est là que cette fonction sert.
+ */
+declare function matchesAccept(file: File, accept: string): boolean;
+/** Lit un fichier en `data:` URL — un aperçu d'image avant téléversement. */
+declare function readAsDataUrl(file: Blob): Promise<string>;
+/** Lit un fichier en texte — un CSV, un JSON déposé. */
+declare function readAsText(file: Blob, encoding?: string): Promise<string>;
+/**
+ * Propose un téléchargement.
+ *
+ * L'URL objet est révoquée après coup : sans cela, le contenu reste en
+ * mémoire jusqu'au rechargement de la page — ce qui se voit sur un export de
+ * plusieurs mégaoctets répété.
+ */
+declare function downloadBlob(blob: Blob, filename: string): void;
+/** Télécharge du texte — un CSV construit côté client. */
+declare function downloadText(content: string, filename: string, type?: string): void;
+
+export { type FileKind, type FormatBytesOptions, baseName, downloadBlob, downloadText, exceedsSize, extension, fileKind, formatBytes, isImage, matchesAccept, readAsDataUrl, readAsText };

package/dist/file.js

@@ -0,0 +1 @@
+export { baseName, downloadBlob, downloadText, exceedsSize, extension, fileKind, formatBytes, isImage, matchesAccept, readAsDataUrl, readAsText } from './chunk-ETJDEEF5.js';