design-zystem 1.0.256 → 1.0.257

package/dist/index.d.mts

@@ -1035,4 +1035,67 @@ interface OptimizeImageOptions {
 }
 declare const optimizeImage: (file: File | null | undefined, desiredBaseName: string, opts?: OptimizeImageOptions) => Promise<OptimizeImageResult>;
 
-export { Accordion, type AccordionItem, Avatar, Box, Bubble, Bulk, Button, CardSkeleton, Checkbox, Col, Collapse, ColorPicker, DatePicker, Divider, Drawer, EmptyState, FileUploadZone, type FloatingAction, FloatingButton, type FloatingButtonProps, Grid, Icon, IconTabs, Image, Input, Link, List, ListItem, MetricCard, Modal, ModalConfirmation, MultiSelect, NewModal, Options, PageContainer, Pagination, Popover, ProgressBar, Radio, Row, Select, type SelectOption, type SelectProps, SkeletonRow, SliderInput, type SortOrder, Spinner, Stepper, Switch, Table, TableBody, TableCell, TableFooter, TableFooterCell, TableFooterRow, TableHeader, TableHeaderCell, type TableHeaderCellProps, TableHeaderRow, TableRow, Tabs, TagBubble, Text, Timeline, type TimelineItem, Tooltip, colors, formatDate, formatDistance, formatDuration, formatEuro, formatName, optimizeImage, truncateFileName, truncateText };
+declare const getRelativeTime: (date: Date | string) => string;
+
+declare const formatTime: (time: string | null | undefined) => string;
+
+declare const easterDate: (year: number) => Date;
+
+declare const isHoliday: (date: Date) => boolean;
+
+declare const addBusinessDays: (originalDate: Date, numDaysToAdd: number) => Date;
+
+declare const formatAddress: (address: string | null | undefined) => string | null;
+
+declare const formatLocality: (locality: string | null | undefined) => string | null;
+
+declare const formatRegionCode: (postalCode: string | null | undefined) => string;
+
+declare const formatCityFromFormattedAddress: (address: string | null | undefined) => string;
+
+declare const formatPostalCodeFromFormattedAddress: (address: string | null | undefined) => string;
+
+declare const isolateCity: (addr: string | null | undefined) => string;
+
+declare const formatPhoneNumber: (phone: string | null | undefined) => string | null;
+
+declare const formatPlate: (plate: string | null | undefined) => string | null;
+
+declare const formatPlateWithoutDashes: (plate: string | null | undefined) => string | null;
+
+declare const capitalizeFirstLetter: (str: string | null | undefined) => string | null;
+
+declare const generateHexColor: (firstName?: string, lastName?: string) => string;
+
+interface AuthorLike {
+    first_name?: string | null;
+    firstname?: string | null;
+    firstName?: string | null;
+    last_name?: string | null;
+    lastname?: string | null;
+    lastName?: string | null;
+    name?: string | null;
+    display_name?: string | null;
+    email?: string | null;
+}
+declare const getInitials: (author: AuthorLike | null | undefined) => string;
+
+declare const getAvatarColor: (key: string) => string;
+
+declare const getFileNameFromUrl: (url: string | null | undefined, fallback?: string) => string;
+
+declare const getFileKind: (url: string | null | undefined) => "image" | "pdf" | "other";
+
+declare const appendQueryParam: (url: string, key: string, value: string) => string;
+
+declare const appendCacheBuster: (url: string) => string;
+
+declare const getMimeCategory: (mimeType: string | null | undefined) => string;
+
+declare const getCleanFileName: (fileName: string | null | undefined) => string;
+
+declare const formatVin: (vin: string | null | undefined) => string;
+
+declare const formatKM: (value: string | number | null | undefined) => string;
+
+export { Accordion, type AccordionItem, Avatar, Box, Bubble, Bulk, Button, CardSkeleton, Checkbox, Col, Collapse, ColorPicker, DatePicker, Divider, Drawer, EmptyState, FileUploadZone, type FloatingAction, FloatingButton, type FloatingButtonProps, Grid, Icon, IconTabs, Image, Input, Link, List, ListItem, MetricCard, Modal, ModalConfirmation, MultiSelect, NewModal, Options, PageContainer, Pagination, Popover, ProgressBar, Radio, Row, Select, type SelectOption, type SelectProps, SkeletonRow, SliderInput, type SortOrder, Spinner, Stepper, Switch, Table, TableBody, TableCell, TableFooter, TableFooterCell, TableFooterRow, TableHeader, TableHeaderCell, type TableHeaderCellProps, TableHeaderRow, TableRow, Tabs, TagBubble, Text, Timeline, type TimelineItem, Tooltip, addBusinessDays, appendCacheBuster, appendQueryParam, capitalizeFirstLetter, colors, easterDate, formatAddress, formatCityFromFormattedAddress, formatDate, formatDistance, formatDuration, formatEuro, formatKM, formatLocality, formatName, formatPhoneNumber, formatPlate, formatPlateWithoutDashes, formatPostalCodeFromFormattedAddress, formatRegionCode, formatTime, formatVin, generateHexColor, getAvatarColor, getCleanFileName, getFileKind, getFileNameFromUrl, getInitials, getMimeCategory, getRelativeTime, isHoliday, isolateCity, optimizeImage, truncateFileName, truncateText };

package/dist/index.d.ts

@@ -1035,4 +1035,67 @@ interface OptimizeImageOptions {
 }
 declare const optimizeImage: (file: File | null | undefined, desiredBaseName: string, opts?: OptimizeImageOptions) => Promise<OptimizeImageResult>;
 
-export { Accordion, type AccordionItem, Avatar, Box, Bubble, Bulk, Button, CardSkeleton, Checkbox, Col, Collapse, ColorPicker, DatePicker, Divider, Drawer, EmptyState, FileUploadZone, type FloatingAction, FloatingButton, type FloatingButtonProps, Grid, Icon, IconTabs, Image, Input, Link, List, ListItem, MetricCard, Modal, ModalConfirmation, MultiSelect, NewModal, Options, PageContainer, Pagination, Popover, ProgressBar, Radio, Row, Select, type SelectOption, type SelectProps, SkeletonRow, SliderInput, type SortOrder, Spinner, Stepper, Switch, Table, TableBody, TableCell, TableFooter, TableFooterCell, TableFooterRow, TableHeader, TableHeaderCell, type TableHeaderCellProps, TableHeaderRow, TableRow, Tabs, TagBubble, Text, Timeline, type TimelineItem, Tooltip, colors, formatDate, formatDistance, formatDuration, formatEuro, formatName, optimizeImage, truncateFileName, truncateText };
+declare const getRelativeTime: (date: Date | string) => string;
+
+declare const formatTime: (time: string | null | undefined) => string;
+
+declare const easterDate: (year: number) => Date;
+
+declare const isHoliday: (date: Date) => boolean;
+
+declare const addBusinessDays: (originalDate: Date, numDaysToAdd: number) => Date;
+
+declare const formatAddress: (address: string | null | undefined) => string | null;
+
+declare const formatLocality: (locality: string | null | undefined) => string | null;
+
+declare const formatRegionCode: (postalCode: string | null | undefined) => string;
+
+declare const formatCityFromFormattedAddress: (address: string | null | undefined) => string;
+
+declare const formatPostalCodeFromFormattedAddress: (address: string | null | undefined) => string;
+
+declare const isolateCity: (addr: string | null | undefined) => string;
+
+declare const formatPhoneNumber: (phone: string | null | undefined) => string | null;
+
+declare const formatPlate: (plate: string | null | undefined) => string | null;
+
+declare const formatPlateWithoutDashes: (plate: string | null | undefined) => string | null;
+
+declare const capitalizeFirstLetter: (str: string | null | undefined) => string | null;
+
+declare const generateHexColor: (firstName?: string, lastName?: string) => string;
+
+interface AuthorLike {
+    first_name?: string | null;
+    firstname?: string | null;
+    firstName?: string | null;
+    last_name?: string | null;
+    lastname?: string | null;
+    lastName?: string | null;
+    name?: string | null;
+    display_name?: string | null;
+    email?: string | null;
+}
+declare const getInitials: (author: AuthorLike | null | undefined) => string;
+
+declare const getAvatarColor: (key: string) => string;
+
+declare const getFileNameFromUrl: (url: string | null | undefined, fallback?: string) => string;
+
+declare const getFileKind: (url: string | null | undefined) => "image" | "pdf" | "other";
+
+declare const appendQueryParam: (url: string, key: string, value: string) => string;
+
+declare const appendCacheBuster: (url: string) => string;
+
+declare const getMimeCategory: (mimeType: string | null | undefined) => string;
+
+declare const getCleanFileName: (fileName: string | null | undefined) => string;
+
+declare const formatVin: (vin: string | null | undefined) => string;
+
+declare const formatKM: (value: string | number | null | undefined) => string;
+
+export { Accordion, type AccordionItem, Avatar, Box, Bubble, Bulk, Button, CardSkeleton, Checkbox, Col, Collapse, ColorPicker, DatePicker, Divider, Drawer, EmptyState, FileUploadZone, type FloatingAction, FloatingButton, type FloatingButtonProps, Grid, Icon, IconTabs, Image, Input, Link, List, ListItem, MetricCard, Modal, ModalConfirmation, MultiSelect, NewModal, Options, PageContainer, Pagination, Popover, ProgressBar, Radio, Row, Select, type SelectOption, type SelectProps, SkeletonRow, SliderInput, type SortOrder, Spinner, Stepper, Switch, Table, TableBody, TableCell, TableFooter, TableFooterCell, TableFooterRow, TableHeader, TableHeaderCell, type TableHeaderCellProps, TableHeaderRow, TableRow, Tabs, TagBubble, Text, Timeline, type TimelineItem, Tooltip, addBusinessDays, appendCacheBuster, appendQueryParam, capitalizeFirstLetter, colors, easterDate, formatAddress, formatCityFromFormattedAddress, formatDate, formatDistance, formatDuration, formatEuro, formatKM, formatLocality, formatName, formatPhoneNumber, formatPlate, formatPlateWithoutDashes, formatPostalCodeFromFormattedAddress, formatRegionCode, formatTime, formatVin, generateHexColor, getAvatarColor, getCleanFileName, getFileKind, getFileNameFromUrl, getInitials, getMimeCategory, getRelativeTime, isHoliday, isolateCity, optimizeImage, truncateFileName, truncateText };

package/dist/index.js

@@ -117,12 +117,38 @@ __export(index_exports, {
   Text: () => Text,
   Timeline: () => Timeline,
   Tooltip: () => Tooltip,
+  addBusinessDays: () => addBusinessDays,
+  appendCacheBuster: () => appendCacheBuster,
+  appendQueryParam: () => appendQueryParam,
+  capitalizeFirstLetter: () => capitalizeFirstLetter,
   colors: () => colors,
+  easterDate: () => easterDate,
+  formatAddress: () => formatAddress,
+  formatCityFromFormattedAddress: () => formatCityFromFormattedAddress,
   formatDate: () => formatDate,
   formatDistance: () => formatDistance,
   formatDuration: () => formatDuration,
   formatEuro: () => formatEuro,
+  formatKM: () => formatKM,
+  formatLocality: () => formatLocality,
   formatName: () => formatName,
+  formatPhoneNumber: () => formatPhoneNumber,
+  formatPlate: () => formatPlate,
+  formatPlateWithoutDashes: () => formatPlateWithoutDashes,
+  formatPostalCodeFromFormattedAddress: () => formatPostalCodeFromFormattedAddress,
+  formatRegionCode: () => formatRegionCode,
+  formatTime: () => formatTime,
+  formatVin: () => formatVin,
+  generateHexColor: () => generateHexColor,
+  getAvatarColor: () => getAvatarColor,
+  getCleanFileName: () => getCleanFileName,
+  getFileKind: () => getFileKind,
+  getFileNameFromUrl: () => getFileNameFromUrl,
+  getInitials: () => getInitials2,
+  getMimeCategory: () => getMimeCategory,
+  getRelativeTime: () => getRelativeTime,
+  isHoliday: () => isHoliday,
+  isolateCity: () => isolateCity,
   optimizeImage: () => optimizeImage_default,
   truncateFileName: () => truncateFileName,
   truncateText: () => truncateText
@@ -5550,7 +5576,7 @@ var formatDate = (dateString, type = "date", language = "en") => {
   const baseLang = typeof language === "string" ? language.split("-")[0] : "en";
   const locale = localeMap[language] || localeMap[baseLang] || language || "en-GB";
   const format = (options) => new Intl.DateTimeFormat(locale, options).format(date);
-  const formatTime = () => new Intl.DateTimeFormat(locale, {
+  const formatTime2 = () => new Intl.DateTimeFormat(locale, {
     hour: "2-digit",
     minute: "2-digit",
     hourCycle: "h23"
@@ -5564,7 +5590,7 @@ var formatDate = (dateString, type = "date", language = "en") => {
         month: "2-digit",
         year: "numeric"
       });
-      return `${dayPart} ${formatTime()}`;
+      return `${dayPart} ${formatTime2()}`;
     }
     case "dateISO": {
       const year = date.getFullYear();
@@ -5596,7 +5622,7 @@ var formatDate = (dateString, type = "date", language = "en") => {
         day: "numeric",
         month: "short"
       });
-      return `${dayPart} ${formatTime()}`;
+      return `${dayPart} ${formatTime2()}`;
     }
     case "longDate":
       return format({ day: "numeric", month: "long", year: "numeric" });
@@ -5788,6 +5814,320 @@ var optimizeImage = async (file, desiredBaseName, opts = {}) => {
   }
 };
 var optimizeImage_default = optimizeImage;
+
+// src/utils/date/getRelativeTime.ts
+var UNITS = [
+  { name: "ann\xE9e", seconds: 31536e3, pluralize: true },
+  { name: "mois", seconds: 2592e3, pluralize: false },
+  { name: "jour", seconds: 86400, pluralize: true },
+  { name: "heure", seconds: 3600, pluralize: true },
+  { name: "minute", seconds: 60, pluralize: true },
+  { name: "seconde", seconds: 1, pluralize: true }
+];
+var getRelativeTime = (date) => {
+  const diffInSeconds = Math.floor(
+    (Date.now() - new Date(date).getTime()) / 1e3
+  );
+  for (const unit of UNITS) {
+    const interval = Math.floor(diffInSeconds / unit.seconds);
+    if (interval >= 1) {
+      const suffix = unit.pluralize && interval > 1 ? "s" : "";
+      return `il y a ${interval} ${unit.name}${suffix}`;
+    }
+  }
+  return "\xE0 l'instant";
+};
+
+// src/utils/date/formatTime.ts
+var formatTime = (time) => {
+  if (!time) return "";
+  const [hours, minutes] = time.split(":");
+  return minutes !== "00" ? `${hours}h${minutes}` : `${hours}h`;
+};
+
+// src/utils/date/easterDate.ts
+var easterDate = (year) => {
+  const f = Math.floor;
+  const a = year % 19;
+  const b = f(year / 100);
+  const c = year % 100;
+  const d = f(b / 4);
+  const e = b % 4;
+  const f1 = f((b + 8) / 25);
+  const g = f((b - f1 + 1) / 3);
+  const h = (19 * a + b - d - g + 15) % 30;
+  const i = f(c / 4);
+  const k = c % 4;
+  const l = (32 + 2 * e + 2 * i - h - k) % 7;
+  const m = f((a + 11 * h + 22 * l) / 451);
+  const month = f((h + l - 7 * m + 114) / 31);
+  const day = (h + l - 7 * m + 114) % 31 + 1;
+  return new Date(year, month - 1, day);
+};
+
+// src/utils/date/isHoliday.ts
+var isHoliday = (date) => {
+  const year = date.getFullYear();
+  const easter = easterDate(year);
+  const ascension = new Date(easter.getTime());
+  ascension.setDate(easter.getDate() + 39);
+  const pentecost = new Date(easter.getTime());
+  pentecost.setDate(easter.getDate() + 50);
+  const easterMonday = new Date(easter.getTime());
+  easterMonday.setDate(easter.getDate() + 1);
+  const holidays = {
+    "1/1": "Nouvel An",
+    "1/5": "F\xEAte du Travail",
+    "8/5": "Victoire 1945",
+    "14/7": "F\xEAte Nationale",
+    "15/8": "Assomption",
+    "1/11": "Toussaint",
+    "11/11": "Armistice",
+    "25/12": "No\xEBl",
+    [`${easterMonday.getDate()}/${easterMonday.getMonth() + 1}`]: "Lundi de P\xE2ques",
+    [`${ascension.getDate()}/${ascension.getMonth() + 1}`]: "Ascension",
+    [`${pentecost.getDate()}/${pentecost.getMonth() + 1}`]: "Pentec\xF4te"
+  };
+  const key = `${date.getDate()}/${date.getMonth() + 1}`;
+  return Object.prototype.hasOwnProperty.call(holidays, key);
+};
+
+// src/utils/date/addBusinessDays.ts
+var addBusinessDays = (originalDate, numDaysToAdd) => {
+  let daysAdded = 0;
+  const newDate = new Date(originalDate.getTime());
+  while (daysAdded < numDaysToAdd) {
+    newDate.setDate(newDate.getDate() + 1);
+    const dayOfWeek = newDate.getDay();
+    if (dayOfWeek !== 0 && dayOfWeek !== 6 && !isHoliday(newDate)) {
+      daysAdded++;
+    }
+  }
+  return newDate;
+};
+
+// src/utils/address/formatAddress.ts
+var formatAddress = (address) => {
+  if (!address) return null;
+  const match = address.match(/(\b\d{5}\b)\s+([\p{L}\s'-]+)/u);
+  if (match) return `${match[1]} ${match[2].trim()}`;
+  return address;
+};
+
+// src/utils/address/formatLocality.ts
+var formatLocality = (locality) => {
+  if (!locality) return null;
+  const parts = locality.split(",").map((p) => p.trim());
+  if (parts.length >= 4) {
+    const city = parts[1];
+    const department = parts[3].slice(0, 2);
+    return `${city} (${department})`;
+  }
+  return null;
+};
+
+// src/utils/address/formatRegionCode.ts
+var formatRegionCode = (postalCode) => {
+  if (!postalCode) return "";
+  const cleaned = postalCode.replace(/\D/g, "");
+  return cleaned.length >= 2 ? cleaned.slice(0, 2) : cleaned;
+};
+
+// src/utils/address/formatCityFromFormattedAddress.ts
+var formatCityFromFormattedAddress = (address) => {
+  if (!address) return "";
+  const parts = address.split(",");
+  if (parts.length < 2) return "";
+  const localityPart = parts[parts.length - 2].trim();
+  const locality = localityPart.split(" ").slice(1).join(" ");
+  return locality.charAt(0).toUpperCase() + locality.slice(1);
+};
+
+// src/utils/address/formatPostalCodeFromFormattedAddress.ts
+var formatPostalCodeFromFormattedAddress = (address) => {
+  if (!address) return "";
+  const parts = address.split(",");
+  if (parts.length < 2) return "";
+  const postalCodePart = parts[parts.length - 2].trim();
+  return postalCodePart.split(" ")[0];
+};
+
+// src/utils/address/isolateCity.ts
+var isolateCity = (addr) => {
+  var _a, _b, _c;
+  const cityWithPostalCode = (_c = (_b = (_a = addr == null ? void 0 : addr.split(",")) == null ? void 0 : _a.pop()) == null ? void 0 : _b.trim()) != null ? _c : "";
+  const postalCode = cityWithPostalCode.slice(0, 5).trim();
+  const city = cityWithPostalCode.slice(6).trim();
+  const dept = postalCode ? postalCode.slice(0, 2) : "";
+  return city ? `${city}${dept ? ` (${dept})` : ""}` : "\u2014";
+};
+
+// src/utils/phone/formatPhoneNumber.ts
+var formatPhoneNumber = (phone) => {
+  if (!phone) return null;
+  let cleaned = phone.replace(/\D/g, "");
+  if (cleaned.startsWith("33")) cleaned = "+" + cleaned;
+  else if (cleaned.startsWith("0")) cleaned = "+33" + cleaned.substring(1);
+  else if (!cleaned.startsWith("+33")) cleaned = "+33" + cleaned;
+  const match = cleaned.match(/^(\+33)(\d{1})(\d{2})(\d{2})(\d{2})(\d{2})$/);
+  if (match)
+    return `${match[1]} ${match[2]} ${match[3]} ${match[4]} ${match[5]} ${match[6]}`;
+  return phone;
+};
+
+// src/utils/plate/formatPlate.ts
+var formatPlate = (plate) => {
+  if (!plate) return null;
+  if (plate.length === 7) {
+    return `${plate.substring(0, 2).toUpperCase()}-${plate.substring(2, 5).toUpperCase()}-${plate.substring(5).toUpperCase()}`;
+  }
+  if (plate.length === 6) {
+    return `${plate.substring(0, 1).toUpperCase()}-${plate.substring(1, 4).toUpperCase()}-${plate.substring(4).toUpperCase()}`;
+  }
+  if (plate.length === 9 && plate.includes("-")) return plate.toUpperCase();
+  return plate;
+};
+
+// src/utils/plate/formatPlateWithoutDashes.ts
+var formatPlateWithoutDashes = (plate) => {
+  if (!plate) return null;
+  return plate.replace(/-/g, "").toUpperCase();
+};
+
+// src/utils/string/capitalizeFirstLetter.ts
+var capitalizeFirstLetter = (str) => {
+  if (!str) return null;
+  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+};
+
+// src/utils/string/generateHexColor.ts
+var generateHexColor = (firstName = "", lastName = "") => {
+  const fullName = firstName.trim().toLowerCase() + lastName.trim().toLowerCase();
+  let hash = 0;
+  for (let i = 0; i < fullName.length; i++) {
+    hash = fullName.charCodeAt(i) + ((hash << 5) - hash);
+  }
+  let color = "#";
+  for (let i = 0; i < 3; i++) {
+    const value = hash >> i * 8 & 255;
+    color += ("00" + value.toString(16)).slice(-2);
+  }
+  return color;
+};
+
+// src/utils/string/getInitials.ts
+var firstLetter = (s) => {
+  var _a, _b;
+  if (!s) return "";
+  const token = String(s).trim().split(/[\s-]+/)[0];
+  return (_b = (_a = token[0]) == null ? void 0 : _a.toUpperCase()) != null ? _b : "";
+};
+var getInitials2 = (author) => {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  if (!author) return "?";
+  const f = (_c = (_b = (_a = author.first_name) != null ? _a : author.firstname) != null ? _b : author.firstName) != null ? _c : "";
+  const l = (_f = (_e = (_d = author.last_name) != null ? _d : author.lastname) != null ? _e : author.lastName) != null ? _f : "";
+  let initials = firstLetter(f) + firstLetter(l);
+  if (!initials) {
+    const name = (_i = (_h = (_g = author.name) != null ? _g : author.display_name) != null ? _h : author.email) != null ? _i : "";
+    const parts = String(name).trim().split(/[\s.]+/).filter(Boolean);
+    if (parts.length >= 2)
+      initials = firstLetter(parts[0]) + firstLetter(parts[1]);
+    else if (parts.length === 1) initials = parts[0].slice(0, 2).toUpperCase();
+  }
+  return initials || "?";
+};
+
+// src/utils/string/getAvatarColor.ts
+var AVATAR_COLORS = [
+  "#12638B",
+  "#0B6E40",
+  "#6D28D9",
+  "#DC2626",
+  "#0EA5E9",
+  "#16A34A",
+  "#F59E0B",
+  "#059669",
+  "#EF4444",
+  "#3B82F6",
+  "#9333EA",
+  "#EA580C"
+];
+var hashString = (str = "") => {
+  let h = 0;
+  for (let i = 0; i < str.length; i++) {
+    h = h * 31 + str.charCodeAt(i) | 0;
+  }
+  return Math.abs(h);
+};
+var getAvatarColor = (key) => {
+  return AVATAR_COLORS[hashString(key) % AVATAR_COLORS.length];
+};
+
+// src/utils/file/getFileNameFromUrl.ts
+var getFileNameFromUrl = (url, fallback = "") => {
+  if (!url) return fallback;
+  return url.split("/").pop() || fallback;
+};
+
+// src/utils/file/getFileKind.ts
+var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
+  "jpg",
+  "jpeg",
+  "png",
+  "gif",
+  "webp",
+  "svg",
+  "bmp",
+  "avif"
+]);
+var getFileKind = (url) => {
+  var _a, _b;
+  if (!url) return "other";
+  const ext = (_b = (_a = url.split("?")[0].split(".").pop()) == null ? void 0 : _a.toLowerCase()) != null ? _b : "";
+  if (ext === "pdf") return "pdf";
+  if (IMAGE_EXTENSIONS.has(ext)) return "image";
+  return "other";
+};
+
+// src/utils/file/appendQueryParam.ts
+var appendQueryParam = (url, key, value) => {
+  const separator = url.includes("?") ? "&" : "?";
+  return `${url}${separator}${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
+};
+
+// src/utils/file/appendCacheBuster.ts
+var appendCacheBuster = (url) => {
+  return appendQueryParam(url, "hash", Date.now().toString());
+};
+
+// src/utils/file/getMimeCategory.ts
+var getMimeCategory = (mimeType) => {
+  if (!mimeType) return "";
+  return mimeType.split("/")[0];
+};
+
+// src/utils/file/getCleanFileName.ts
+var getCleanFileName = (fileName) => {
+  if (!fileName) return "";
+  const parts = fileName.split("_");
+  if (/^\d{13}$/.test(parts[0])) return parts.slice(1).join("_");
+  return fileName;
+};
+
+// src/utils/vehicle/formatVin.ts
+var formatVin = (vin) => {
+  if (!vin) return "";
+  return vin.length > 7 ? vin.slice(-7) : vin;
+};
+
+// src/utils/vehicle/formatKM.ts
+var formatKM = (value) => {
+  if (value === null || value === void 0 || value === "") return "";
+  const parsed = parseInt(String(value), 10);
+  if (isNaN(parsed) || parsed < 0) return "";
+  return `${parsed} km`;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Accordion,
@@ -5848,12 +6188,38 @@ var optimizeImage_default = optimizeImage;
   Text,
   Timeline,
   Tooltip,
+  addBusinessDays,
+  appendCacheBuster,
+  appendQueryParam,
+  capitalizeFirstLetter,
   colors,
+  easterDate,
+  formatAddress,
+  formatCityFromFormattedAddress,
   formatDate,
   formatDistance,
   formatDuration,
   formatEuro,
+  formatKM,
+  formatLocality,
   formatName,
+  formatPhoneNumber,
+  formatPlate,
+  formatPlateWithoutDashes,
+  formatPostalCodeFromFormattedAddress,
+  formatRegionCode,
+  formatTime,
+  formatVin,
+  generateHexColor,
+  getAvatarColor,
+  getCleanFileName,
+  getFileKind,
+  getFileNameFromUrl,
+  getInitials,
+  getMimeCategory,
+  getRelativeTime,
+  isHoliday,
+  isolateCity,
   optimizeImage,
   truncateFileName,
   truncateText

package/dist/index.mjs

@@ -5471,7 +5471,7 @@ var formatDate = (dateString, type = "date", language = "en") => {
   const baseLang = typeof language === "string" ? language.split("-")[0] : "en";
   const locale = localeMap[language] || localeMap[baseLang] || language || "en-GB";
   const format = (options) => new Intl.DateTimeFormat(locale, options).format(date);
-  const formatTime = () => new Intl.DateTimeFormat(locale, {
+  const formatTime2 = () => new Intl.DateTimeFormat(locale, {
     hour: "2-digit",
     minute: "2-digit",
     hourCycle: "h23"
@@ -5485,7 +5485,7 @@ var formatDate = (dateString, type = "date", language = "en") => {
         month: "2-digit",
         year: "numeric"
       });
-      return `${dayPart} ${formatTime()}`;
+      return `${dayPart} ${formatTime2()}`;
     }
     case "dateISO": {
       const year = date.getFullYear();
@@ -5517,7 +5517,7 @@ var formatDate = (dateString, type = "date", language = "en") => {
         day: "numeric",
         month: "short"
       });
-      return `${dayPart} ${formatTime()}`;
+      return `${dayPart} ${formatTime2()}`;
     }
     case "longDate":
       return format({ day: "numeric", month: "long", year: "numeric" });
@@ -5709,6 +5709,320 @@ var optimizeImage = async (file, desiredBaseName, opts = {}) => {
   }
 };
 var optimizeImage_default = optimizeImage;
+
+// src/utils/date/getRelativeTime.ts
+var UNITS = [
+  { name: "ann\xE9e", seconds: 31536e3, pluralize: true },
+  { name: "mois", seconds: 2592e3, pluralize: false },
+  { name: "jour", seconds: 86400, pluralize: true },
+  { name: "heure", seconds: 3600, pluralize: true },
+  { name: "minute", seconds: 60, pluralize: true },
+  { name: "seconde", seconds: 1, pluralize: true }
+];
+var getRelativeTime = (date) => {
+  const diffInSeconds = Math.floor(
+    (Date.now() - new Date(date).getTime()) / 1e3
+  );
+  for (const unit of UNITS) {
+    const interval = Math.floor(diffInSeconds / unit.seconds);
+    if (interval >= 1) {
+      const suffix = unit.pluralize && interval > 1 ? "s" : "";
+      return `il y a ${interval} ${unit.name}${suffix}`;
+    }
+  }
+  return "\xE0 l'instant";
+};
+
+// src/utils/date/formatTime.ts
+var formatTime = (time) => {
+  if (!time) return "";
+  const [hours, minutes] = time.split(":");
+  return minutes !== "00" ? `${hours}h${minutes}` : `${hours}h`;
+};
+
+// src/utils/date/easterDate.ts
+var easterDate = (year) => {
+  const f = Math.floor;
+  const a = year % 19;
+  const b = f(year / 100);
+  const c = year % 100;
+  const d = f(b / 4);
+  const e = b % 4;
+  const f1 = f((b + 8) / 25);
+  const g = f((b - f1 + 1) / 3);
+  const h = (19 * a + b - d - g + 15) % 30;
+  const i = f(c / 4);
+  const k = c % 4;
+  const l = (32 + 2 * e + 2 * i - h - k) % 7;
+  const m = f((a + 11 * h + 22 * l) / 451);
+  const month = f((h + l - 7 * m + 114) / 31);
+  const day = (h + l - 7 * m + 114) % 31 + 1;
+  return new Date(year, month - 1, day);
+};
+
+// src/utils/date/isHoliday.ts
+var isHoliday = (date) => {
+  const year = date.getFullYear();
+  const easter = easterDate(year);
+  const ascension = new Date(easter.getTime());
+  ascension.setDate(easter.getDate() + 39);
+  const pentecost = new Date(easter.getTime());
+  pentecost.setDate(easter.getDate() + 50);
+  const easterMonday = new Date(easter.getTime());
+  easterMonday.setDate(easter.getDate() + 1);
+  const holidays = {
+    "1/1": "Nouvel An",
+    "1/5": "F\xEAte du Travail",
+    "8/5": "Victoire 1945",
+    "14/7": "F\xEAte Nationale",
+    "15/8": "Assomption",
+    "1/11": "Toussaint",
+    "11/11": "Armistice",
+    "25/12": "No\xEBl",
+    [`${easterMonday.getDate()}/${easterMonday.getMonth() + 1}`]: "Lundi de P\xE2ques",
+    [`${ascension.getDate()}/${ascension.getMonth() + 1}`]: "Ascension",
+    [`${pentecost.getDate()}/${pentecost.getMonth() + 1}`]: "Pentec\xF4te"
+  };
+  const key = `${date.getDate()}/${date.getMonth() + 1}`;
+  return Object.prototype.hasOwnProperty.call(holidays, key);
+};
+
+// src/utils/date/addBusinessDays.ts
+var addBusinessDays = (originalDate, numDaysToAdd) => {
+  let daysAdded = 0;
+  const newDate = new Date(originalDate.getTime());
+  while (daysAdded < numDaysToAdd) {
+    newDate.setDate(newDate.getDate() + 1);
+    const dayOfWeek = newDate.getDay();
+    if (dayOfWeek !== 0 && dayOfWeek !== 6 && !isHoliday(newDate)) {
+      daysAdded++;
+    }
+  }
+  return newDate;
+};
+
+// src/utils/address/formatAddress.ts
+var formatAddress = (address) => {
+  if (!address) return null;
+  const match = address.match(/(\b\d{5}\b)\s+([\p{L}\s'-]+)/u);
+  if (match) return `${match[1]} ${match[2].trim()}`;
+  return address;
+};
+
+// src/utils/address/formatLocality.ts
+var formatLocality = (locality) => {
+  if (!locality) return null;
+  const parts = locality.split(",").map((p) => p.trim());
+  if (parts.length >= 4) {
+    const city = parts[1];
+    const department = parts[3].slice(0, 2);
+    return `${city} (${department})`;
+  }
+  return null;
+};
+
+// src/utils/address/formatRegionCode.ts
+var formatRegionCode = (postalCode) => {
+  if (!postalCode) return "";
+  const cleaned = postalCode.replace(/\D/g, "");
+  return cleaned.length >= 2 ? cleaned.slice(0, 2) : cleaned;
+};
+
+// src/utils/address/formatCityFromFormattedAddress.ts
+var formatCityFromFormattedAddress = (address) => {
+  if (!address) return "";
+  const parts = address.split(",");
+  if (parts.length < 2) return "";
+  const localityPart = parts[parts.length - 2].trim();
+  const locality = localityPart.split(" ").slice(1).join(" ");
+  return locality.charAt(0).toUpperCase() + locality.slice(1);
+};
+
+// src/utils/address/formatPostalCodeFromFormattedAddress.ts
+var formatPostalCodeFromFormattedAddress = (address) => {
+  if (!address) return "";
+  const parts = address.split(",");
+  if (parts.length < 2) return "";
+  const postalCodePart = parts[parts.length - 2].trim();
+  return postalCodePart.split(" ")[0];
+};
+
+// src/utils/address/isolateCity.ts
+var isolateCity = (addr) => {
+  var _a, _b, _c;
+  const cityWithPostalCode = (_c = (_b = (_a = addr == null ? void 0 : addr.split(",")) == null ? void 0 : _a.pop()) == null ? void 0 : _b.trim()) != null ? _c : "";
+  const postalCode = cityWithPostalCode.slice(0, 5).trim();
+  const city = cityWithPostalCode.slice(6).trim();
+  const dept = postalCode ? postalCode.slice(0, 2) : "";
+  return city ? `${city}${dept ? ` (${dept})` : ""}` : "\u2014";
+};
+
+// src/utils/phone/formatPhoneNumber.ts
+var formatPhoneNumber = (phone) => {
+  if (!phone) return null;
+  let cleaned = phone.replace(/\D/g, "");
+  if (cleaned.startsWith("33")) cleaned = "+" + cleaned;
+  else if (cleaned.startsWith("0")) cleaned = "+33" + cleaned.substring(1);
+  else if (!cleaned.startsWith("+33")) cleaned = "+33" + cleaned;
+  const match = cleaned.match(/^(\+33)(\d{1})(\d{2})(\d{2})(\d{2})(\d{2})$/);
+  if (match)
+    return `${match[1]} ${match[2]} ${match[3]} ${match[4]} ${match[5]} ${match[6]}`;
+  return phone;
+};
+
+// src/utils/plate/formatPlate.ts
+var formatPlate = (plate) => {
+  if (!plate) return null;
+  if (plate.length === 7) {
+    return `${plate.substring(0, 2).toUpperCase()}-${plate.substring(2, 5).toUpperCase()}-${plate.substring(5).toUpperCase()}`;
+  }
+  if (plate.length === 6) {
+    return `${plate.substring(0, 1).toUpperCase()}-${plate.substring(1, 4).toUpperCase()}-${plate.substring(4).toUpperCase()}`;
+  }
+  if (plate.length === 9 && plate.includes("-")) return plate.toUpperCase();
+  return plate;
+};
+
+// src/utils/plate/formatPlateWithoutDashes.ts
+var formatPlateWithoutDashes = (plate) => {
+  if (!plate) return null;
+  return plate.replace(/-/g, "").toUpperCase();
+};
+
+// src/utils/string/capitalizeFirstLetter.ts
+var capitalizeFirstLetter = (str) => {
+  if (!str) return null;
+  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+};
+
+// src/utils/string/generateHexColor.ts
+var generateHexColor = (firstName = "", lastName = "") => {
+  const fullName = firstName.trim().toLowerCase() + lastName.trim().toLowerCase();
+  let hash = 0;
+  for (let i = 0; i < fullName.length; i++) {
+    hash = fullName.charCodeAt(i) + ((hash << 5) - hash);
+  }
+  let color = "#";
+  for (let i = 0; i < 3; i++) {
+    const value = hash >> i * 8 & 255;
+    color += ("00" + value.toString(16)).slice(-2);
+  }
+  return color;
+};
+
+// src/utils/string/getInitials.ts
+var firstLetter = (s) => {
+  var _a, _b;
+  if (!s) return "";
+  const token = String(s).trim().split(/[\s-]+/)[0];
+  return (_b = (_a = token[0]) == null ? void 0 : _a.toUpperCase()) != null ? _b : "";
+};
+var getInitials2 = (author) => {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  if (!author) return "?";
+  const f = (_c = (_b = (_a = author.first_name) != null ? _a : author.firstname) != null ? _b : author.firstName) != null ? _c : "";
+  const l = (_f = (_e = (_d = author.last_name) != null ? _d : author.lastname) != null ? _e : author.lastName) != null ? _f : "";
+  let initials = firstLetter(f) + firstLetter(l);
+  if (!initials) {
+    const name = (_i = (_h = (_g = author.name) != null ? _g : author.display_name) != null ? _h : author.email) != null ? _i : "";
+    const parts = String(name).trim().split(/[\s.]+/).filter(Boolean);
+    if (parts.length >= 2)
+      initials = firstLetter(parts[0]) + firstLetter(parts[1]);
+    else if (parts.length === 1) initials = parts[0].slice(0, 2).toUpperCase();
+  }
+  return initials || "?";
+};
+
+// src/utils/string/getAvatarColor.ts
+var AVATAR_COLORS = [
+  "#12638B",
+  "#0B6E40",
+  "#6D28D9",
+  "#DC2626",
+  "#0EA5E9",
+  "#16A34A",
+  "#F59E0B",
+  "#059669",
+  "#EF4444",
+  "#3B82F6",
+  "#9333EA",
+  "#EA580C"
+];
+var hashString = (str = "") => {
+  let h = 0;
+  for (let i = 0; i < str.length; i++) {
+    h = h * 31 + str.charCodeAt(i) | 0;
+  }
+  return Math.abs(h);
+};
+var getAvatarColor = (key) => {
+  return AVATAR_COLORS[hashString(key) % AVATAR_COLORS.length];
+};
+
+// src/utils/file/getFileNameFromUrl.ts
+var getFileNameFromUrl = (url, fallback = "") => {
+  if (!url) return fallback;
+  return url.split("/").pop() || fallback;
+};
+
+// src/utils/file/getFileKind.ts
+var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
+  "jpg",
+  "jpeg",
+  "png",
+  "gif",
+  "webp",
+  "svg",
+  "bmp",
+  "avif"
+]);
+var getFileKind = (url) => {
+  var _a, _b;
+  if (!url) return "other";
+  const ext = (_b = (_a = url.split("?")[0].split(".").pop()) == null ? void 0 : _a.toLowerCase()) != null ? _b : "";
+  if (ext === "pdf") return "pdf";
+  if (IMAGE_EXTENSIONS.has(ext)) return "image";
+  return "other";
+};
+
+// src/utils/file/appendQueryParam.ts
+var appendQueryParam = (url, key, value) => {
+  const separator = url.includes("?") ? "&" : "?";
+  return `${url}${separator}${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
+};
+
+// src/utils/file/appendCacheBuster.ts
+var appendCacheBuster = (url) => {
+  return appendQueryParam(url, "hash", Date.now().toString());
+};
+
+// src/utils/file/getMimeCategory.ts
+var getMimeCategory = (mimeType) => {
+  if (!mimeType) return "";
+  return mimeType.split("/")[0];
+};
+
+// src/utils/file/getCleanFileName.ts
+var getCleanFileName = (fileName) => {
+  if (!fileName) return "";
+  const parts = fileName.split("_");
+  if (/^\d{13}$/.test(parts[0])) return parts.slice(1).join("_");
+  return fileName;
+};
+
+// src/utils/vehicle/formatVin.ts
+var formatVin = (vin) => {
+  if (!vin) return "";
+  return vin.length > 7 ? vin.slice(-7) : vin;
+};
+
+// src/utils/vehicle/formatKM.ts
+var formatKM = (value) => {
+  if (value === null || value === void 0 || value === "") return "";
+  const parsed = parseInt(String(value), 10);
+  if (isNaN(parsed) || parsed < 0) return "";
+  return `${parsed} km`;
+};
 export {
   Accordion,
   Avatar,
@@ -5768,12 +6082,38 @@ export {
   Text,
   Timeline,
   Tooltip,
+  addBusinessDays,
+  appendCacheBuster,
+  appendQueryParam,
+  capitalizeFirstLetter,
   colors,
+  easterDate,
+  formatAddress,
+  formatCityFromFormattedAddress,
   formatDate,
   formatDistance,
   formatDuration,
   formatEuro,
+  formatKM,
+  formatLocality,
   formatName,
+  formatPhoneNumber,
+  formatPlate,
+  formatPlateWithoutDashes,
+  formatPostalCodeFromFormattedAddress,
+  formatRegionCode,
+  formatTime,
+  formatVin,
+  generateHexColor,
+  getAvatarColor,
+  getCleanFileName,
+  getFileKind,
+  getFileNameFromUrl,
+  getInitials2 as getInitials,
+  getMimeCategory,
+  getRelativeTime,
+  isHoliday,
+  isolateCity,
   optimizeImage_default as optimizeImage,
   truncateFileName,
   truncateText

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "design-zystem",
-  "version": "1.0.256",
+  "version": "1.0.257",
   "description": "A React design system of importable components",
   "main": "dist/index.js",
   "module": "dist/index.mjs",