@wakastellar/ui 3.5.0 → 4.0.0-dev.0

package/dist/{useDataTableImport-T7ddpN5k.js → useDataTableImport-DNU1m8NO.js}

@@ -1,7 +1,7 @@
-const e=require(`./chunk-14q5BKub.js`);let t=require(`react`);function n({data:n,columns:r,exportConfig:i}){let a=(0,t.useMemo)(()=>({formats:[`csv`,`xlsx`,`json`],filename:`export`,includeHeaders:!0,...i}),[i]),o=(0,t.useCallback)((e,t)=>{if(!e.length)return;let n=[r.filter(e=>e.accessorKey||e.id).map(e=>e.header||e.accessorKey||e.id).join(`,`),...e.map(e=>r.filter(e=>e.accessorKey||e.id).map(t=>{let n=t.accessorKey?e[t.accessorKey]:e[t.id],r=t.formatter?t.formatter(n):n,i=String(r||``);return i.includes(`,`)||i.includes(`"`)||i.includes(`
+"use client";const e=require(`./chunk-FDd1SASZ.js`);let t=require(`react`);function n({data:n,columns:r,exportConfig:i}){let a=(0,t.useMemo)(()=>({formats:[`csv`,`xlsx`,`json`],filename:`export`,includeHeaders:!0,...i}),[i]),o=(0,t.useCallback)((e,t)=>{if(!e.length)return;let n=[r.filter(e=>e.accessorKey||e.id).map(e=>e.header||e.accessorKey||e.id).join(`,`),...e.map(e=>r.filter(e=>e.accessorKey||e.id).map(t=>{let n=t.accessorKey?e[t.accessorKey]:e[t.id],r=t.formatter?t.formatter(n):n,i=String(r||``);return i.includes(`,`)||i.includes(`"`)||i.includes(`
 `)?`"${i.replace(/"/g,`""`)}"`:i}).join(`,`))].join(`
-`),i=new Blob([n],{type:`text/csv;charset=utf-8;`}),o=document.createElement(`a`);o.href=URL.createObjectURL(i),o.download=`${t||a.filename}.csv`,o.click(),URL.revokeObjectURL(o.href)},[r,a.filename]),s=(0,t.useCallback)((e,t)=>{let n=JSON.stringify(e,null,2),r=new Blob([n],{type:`application/json`}),i=document.createElement(`a`);i.href=URL.createObjectURL(r),i.download=`${t||a.filename}.json`,i.click(),URL.revokeObjectURL(i.href)},[a.filename]),c=(0,t.useCallback)(async(t,n)=>{try{if(typeof window>`u`)throw Error(`XLSX export not available in server environment`);let i=new(await(Promise.resolve().then(()=>e.a(require(`./exceljs.min-qeIfSCbF.js`).default)))).Workbook,o=i.addWorksheet(a.options?.xlsx?.sheetName||`Sheet1`),s=r.filter(e=>e.accessorKey||e.id).map(e=>e.header||e.accessorKey||e.id);o.addRow(s),t.forEach(e=>{let t=r.filter(e=>e.accessorKey||e.id).map(t=>{let n=t.accessorKey?e[t.accessorKey]:e[t.id];return t.formatter?t.formatter(n):n});o.addRow(t)});let c=await i.xlsx.writeBuffer(),l=new Blob([c],{type:`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`}),u=document.createElement(`a`);u.href=URL.createObjectURL(l),u.download=`${n||a.filename}.xlsx`,u.click(),URL.revokeObjectURL(u.href)}catch(e){throw console.error(`Erreur lors de l'export XLSX:`,e),Error(`La librairie exceljs n'est pas disponible. Installez-la avec: pnpm add exceljs`)}},[r,a.filename,a.options?.xlsx?.sheetName]),l=(0,t.useCallback)(async(e,t)=>{try{if(typeof window>`u`)throw Error(`PDF export not available in server environment`);let n=await import(`jspdf`),i=await import(`jspdf-autotable`),o=new(n.default||n.jsPDF),s=i.default||i.autoTable,c=r.filter(e=>e.accessorKey||e.id).map(e=>e.header||e.accessorKey||e.id),l=e.map(e=>r.filter(e=>e.accessorKey||e.id).map(t=>{let n=t.accessorKey?e[t.accessorKey]:e[t.id];return t.formatter?t.formatter(n):n}));s(o,{head:[c],body:l,startY:20,styles:{fontSize:8},headStyles:{fillColor:[66,139,202]}}),o.save(`${t||a.filename}.pdf`)}catch(e){throw console.error(`Erreur lors de l'export PDF:`,e),Error(`Les librairies jsPDF et jspdf-autotable ne sont pas disponibles`)}},[r,a.filename]),u=(0,t.useCallback)((e,t)=>{let n=r.filter(e=>e.accessorKey||e.id).map(e=>e.accessorKey||e.id),i=`<?xml version="1.0" encoding="UTF-8"?>
+`),i=new Blob([n],{type:`text/csv;charset=utf-8;`}),o=document.createElement(`a`);o.href=URL.createObjectURL(i),o.download=`${t||a.filename}.csv`,o.click(),URL.revokeObjectURL(o.href)},[r,a.filename]),s=(0,t.useCallback)((e,t)=>{let n=JSON.stringify(e,null,2),r=new Blob([n],{type:`application/json`}),i=document.createElement(`a`);i.href=URL.createObjectURL(r),i.download=`${t||a.filename}.json`,i.click(),URL.revokeObjectURL(i.href)},[a.filename]),c=(0,t.useCallback)(async(t,n)=>{try{if(typeof window>`u`)throw Error(`XLSX export not available in server environment`);let i=new(await(Promise.resolve().then(()=>e.r(require(`./exceljs.min-BQi0sACt.js`).default)))).Workbook,o=i.addWorksheet(a.options?.xlsx?.sheetName||`Sheet1`),s=r.filter(e=>e.accessorKey||e.id).map(e=>e.header||e.accessorKey||e.id);o.addRow(s),t.forEach(e=>{let t=r.filter(e=>e.accessorKey||e.id).map(t=>{let n=t.accessorKey?e[t.accessorKey]:e[t.id];return t.formatter?t.formatter(n):n});o.addRow(t)});let c=await i.xlsx.writeBuffer(),l=new Blob([c],{type:`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`}),u=document.createElement(`a`);u.href=URL.createObjectURL(l),u.download=`${n||a.filename}.xlsx`,u.click(),URL.revokeObjectURL(u.href)}catch(e){throw console.error(`Erreur lors de l'export XLSX:`,e),Error(`La librairie exceljs n'est pas disponible. Installez-la avec: pnpm add exceljs`)}},[r,a.filename,a.options?.xlsx?.sheetName]),l=(0,t.useCallback)(async(e,t)=>{try{if(typeof window>`u`)throw Error(`PDF export not available in server environment`);let n=await import(`jspdf`),i=await import(`jspdf-autotable`),o=new(n.default||n.jsPDF),s=i.default||i.autoTable,c=r.filter(e=>e.accessorKey||e.id).map(e=>e.header||e.accessorKey||e.id),l=e.map(e=>r.filter(e=>e.accessorKey||e.id).map(t=>{let n=t.accessorKey?e[t.accessorKey]:e[t.id];return t.formatter?t.formatter(n):n}));s(o,{head:[c],body:l,startY:20,styles:{fontSize:8},headStyles:{fillColor:[66,139,202]}}),o.save(`${t||a.filename}.pdf`)}catch(e){throw console.error(`Erreur lors de l'export PDF:`,e),Error(`Les librairies jsPDF et jspdf-autotable ne sont pas disponibles`)}},[r,a.filename]),u=(0,t.useCallback)((e,t)=>{let n=r.filter(e=>e.accessorKey||e.id).map(e=>e.accessorKey||e.id),i=`<?xml version="1.0" encoding="UTF-8"?>
 <data>
 `;e.forEach((e,t)=>{i+=`  <row id="${t}">\n`,n.forEach(t=>{let n=e[t],r=String(n||``).replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`);i+=`    <${t}>${r}</${t}>\n`}),i+=`  </row>
 `}),i+=`</data>`;let o=new Blob([i],{type:`application/xml`}),s=document.createElement(`a`);s.href=URL.createObjectURL(o),s.download=`${t||a.filename}.xml`,s.click(),URL.revokeObjectURL(s.href)},[r,a.filename]),d=(0,t.useCallback)(async(e,t,r)=>{let i=t||n,d=r||a.filename;if(a.onExport){a.onExport(i,e);return}switch(e.toLowerCase()){case`csv`:o(i,d);break;case`json`:s(i,d);break;case`xlsx`:await c(i,d);break;case`pdf`:await l(i,d);break;case`xml`:u(i,d);break;default:throw Error(`Format d'export non supporté: ${e}`)}},[n,a,o,s,c,l,u]);return{exportData:d,exportAll:(0,t.useCallback)(async e=>d(e),[d]),exportSelected:(0,t.useCallback)(async(e,t)=>d(e,t),[d]),supportedFormats:a.formats,isExportSupported:e=>a.formats.includes(e)}}function r({importConfig:n}){let r=(0,t.useMemo)(()=>({accept:`.csv,.xlsx,.json,.xml`,...n}),[n]),i=(0,t.useCallback)((e,t=`,`)=>{let n=e.split(`
-`).filter(e=>e.trim());if(n.length===0)return[];let r=n[0].split(t).map(e=>e.trim().replace(/"/g,``));return n.slice(1).map(e=>{let n=e.split(t).map(e=>e.trim().replace(/"/g,``)),i={};return r.forEach((e,t)=>{i[e]=n[t]||``}),i})},[]),a=(0,t.useCallback)(e=>{try{let t=JSON.parse(e);return Array.isArray(t)?t:[t]}catch{throw Error(`Format JSON invalide`)}},[]),o=(0,t.useCallback)(e=>{try{let t=new DOMParser().parseFromString(e,`text/xml`).querySelectorAll(`row`);return Array.from(t).map(e=>{let t={};return Array.from(e.children).forEach(e=>{t[e.tagName]=e.textContent||``}),t})}catch{throw Error(`Format XML invalide`)}},[]),s=(0,t.useCallback)(async t=>{try{if(typeof window>`u`)throw Error(`XLSX parsing not available in server environment`);let n=await Promise.resolve().then(()=>e.a(require(`./exceljs.min-qeIfSCbF.js`).default)),i=await t.arrayBuffer(),a=new n.Workbook;await a.xlsx.load(i);let o=r.parseOptions?.xlsx?.sheetIndex??0,s=r.parseOptions?.xlsx?.headerRow??1,c=a.worksheets[o];if(!c||c.rowCount===0)return[];let l=[];c.getRow(s).eachCell((e,t)=>{l[t-1]=String(e.value||``)});let u=[];for(let e=s+1;e<=c.rowCount;e++){let t=c.getRow(e),n={};l.forEach((e,r)=>{n[e]=t.getCell(r+1).value??``}),u.push(n)}return u}catch{throw Error(`Erreur lors du parsing du fichier XLSX. Verifiez que exceljs est installe: pnpm add exceljs`)}},[r.parseOptions?.xlsx?.sheetIndex,r.parseOptions?.xlsx?.headerRow]),c=(0,t.useCallback)(e=>r.validate?r.validate(e):Array.isArray(e)?e.length===0?{valid:!1,errors:[`Aucune donnée trouvée`]}:{valid:!0,errors:[]}:{valid:!1,errors:[`Les données doivent être un tableau`]},[r.validate]),l=(0,t.useCallback)(e=>r.columnMapping?e.map(e=>{let t={};return Object.entries(r.columnMapping).forEach(([n,r])=>{e[n]!==void 0&&(t[r]=e[n])}),t}):e,[r.columnMapping]),u=(0,t.useCallback)(async e=>{let t=e.name.split(`.`).pop()?.toLowerCase(),n=[];try{let u=await e.text();switch(t){case`csv`:n=i(u,r.parseOptions?.csv?.delimiter);break;case`json`:n=a(u);break;case`xml`:n=o(u);break;case`xlsx`:n=await s(e);break;default:throw Error(`Format de fichier non supporté: ${t}`)}let d=c(n);if(!d.valid)throw Error(`Données invalides: ${d.errors.join(`, `)}`);let f=l(n);return r.onImport&&r.onImport(f),f}catch(e){throw Error(`Erreur lors de l'import: ${e instanceof Error?e.message:`Erreur inconnue`}`)}},[r,i,a,o,s,c,l]),d=(0,t.useCallback)(()=>{let e=document.createElement(`input`);return e.type=`file`,e.accept=r.accept,e.multiple=!1,e},[r.accept]);return{importData:u,importWithUI:(0,t.useCallback)(()=>new Promise((e,t)=>{let n=d();n.onchange=async n=>{let r=n.target.files?.[0];if(!r){t(Error(`Aucun fichier sélectionné`));return}try{e(await u(r))}catch(e){t(e)}},n.click()}),[d,u]),supportedFormats:r.accept?.split(`,`)||[],isFormatSupported:e=>{let t=e.split(`.`).pop()?.toLowerCase();return r.accept?.includes(t||``)||!1}}}Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return r}});
+`).filter(e=>e.trim());if(n.length===0)return[];let r=n[0].split(t).map(e=>e.trim().replace(/"/g,``));return n.slice(1).map(e=>{let n=e.split(t).map(e=>e.trim().replace(/"/g,``)),i={};return r.forEach((e,t)=>{i[e]=n[t]||``}),i})},[]),a=(0,t.useCallback)(e=>{try{let t=JSON.parse(e);return Array.isArray(t)?t:[t]}catch{throw Error(`Format JSON invalide`)}},[]),o=(0,t.useCallback)(e=>{try{let t=new DOMParser().parseFromString(e,`text/xml`).querySelectorAll(`row`);return Array.from(t).map(e=>{let t={};return Array.from(e.children).forEach(e=>{t[e.tagName]=e.textContent||``}),t})}catch{throw Error(`Format XML invalide`)}},[]),s=(0,t.useCallback)(async t=>{try{if(typeof window>`u`)throw Error(`XLSX parsing not available in server environment`);let n=await Promise.resolve().then(()=>e.r(require(`./exceljs.min-BQi0sACt.js`).default)),i=await t.arrayBuffer(),a=new n.Workbook;await a.xlsx.load(i);let o=r.parseOptions?.xlsx?.sheetIndex??0,s=r.parseOptions?.xlsx?.headerRow??1,c=a.worksheets[o];if(!c||c.rowCount===0)return[];let l=[];c.getRow(s).eachCell((e,t)=>{l[t-1]=String(e.value||``)});let u=[];for(let e=s+1;e<=c.rowCount;e++){let t=c.getRow(e),n={};l.forEach((e,r)=>{n[e]=t.getCell(r+1).value??``}),u.push(n)}return u}catch{throw Error(`Erreur lors du parsing du fichier XLSX. Verifiez que exceljs est installe: pnpm add exceljs`)}},[r.parseOptions?.xlsx?.sheetIndex,r.parseOptions?.xlsx?.headerRow]),c=(0,t.useCallback)(e=>r.validate?r.validate(e):Array.isArray(e)?e.length===0?{valid:!1,errors:[`Aucune donnée trouvée`]}:{valid:!0,errors:[]}:{valid:!1,errors:[`Les données doivent être un tableau`]},[r.validate]),l=(0,t.useCallback)(e=>r.columnMapping?e.map(e=>{let t={};return Object.entries(r.columnMapping).forEach(([n,r])=>{e[n]!==void 0&&(t[r]=e[n])}),t}):e,[r.columnMapping]),u=(0,t.useCallback)(async e=>{let t=e.name.split(`.`).pop()?.toLowerCase(),n=[];try{let u=await e.text();switch(t){case`csv`:n=i(u,r.parseOptions?.csv?.delimiter);break;case`json`:n=a(u);break;case`xml`:n=o(u);break;case`xlsx`:n=await s(e);break;default:throw Error(`Format de fichier non supporté: ${t}`)}let d=c(n);if(!d.valid)throw Error(`Données invalides: ${d.errors.join(`, `)}`);let f=l(n);return r.onImport&&r.onImport(f),f}catch(e){throw Error(`Erreur lors de l'import: ${e instanceof Error?e.message:`Erreur inconnue`}`)}},[r,i,a,o,s,c,l]),d=(0,t.useCallback)(()=>{let e=document.createElement(`input`);return e.type=`file`,e.accept=r.accept,e.multiple=!1,e},[r.accept]);return{importData:u,importWithUI:(0,t.useCallback)(()=>new Promise((e,t)=>{let n=d();n.onchange=async n=>{let r=n.target.files?.[0];if(!r){t(Error(`Aucun fichier sélectionné`));return}try{e(await u(r))}catch(e){t(e)}},n.click()}),[d,u]),supportedFormats:r.accept?.split(`,`)||[],isFormatSupported:e=>{let t=e.split(`.`).pop()?.toLowerCase();return r.accept?.includes(t||``)||!1}}}Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return r}});

package/dist/{useDataTableImport-BWUFesPi.mjs → useDataTableImport-z5avsB21.mjs}

@@ -1,4 +1,5 @@
-import { o as e } from "./chunk-Cr9pTUWm.mjs";
+"use client";
+import { i as e } from "./chunk-BJivcVNn.mjs";
 import { useCallback as t, useMemo as n } from "react";
 //#region src/components/DataTable/hooks/useDataTableExport.ts
 function r({ data: r, columns: i, exportConfig: a }) {
@@ -24,7 +25,7 @@ function r({ data: r, columns: i, exportConfig: a }) {
 	}, [o.filename]), l = t(async (t, n) => {
 		try {
 			if (typeof window > "u") throw Error("XLSX export not available in server environment");
-			let r = new (await (import("./exceljs.min-DL1XYDll.mjs").then((t) => /* @__PURE__ */ e(t.default)))).Workbook(), a = r.addWorksheet(o.options?.xlsx?.sheetName || "Sheet1"), s = i.filter((e) => e.accessorKey || e.id).map((e) => e.header || e.accessorKey || e.id);
+			let r = new (await (import("./exceljs.min-M0HhQgNK.mjs").then((t) => /* @__PURE__ */ e(t.default)))).Workbook(), a = r.addWorksheet(o.options?.xlsx?.sheetName || "Sheet1"), s = i.filter((e) => e.accessorKey || e.id).map((e) => e.header || e.accessorKey || e.id);
 			a.addRow(s), t.forEach((e) => {
 				let t = i.filter((e) => e.accessorKey || e.id).map((t) => {
 					let n = t.accessorKey ? e[t.accessorKey] : e[t.id];
@@ -151,7 +152,7 @@ function i({ importConfig: r }) {
 	}, []), c = t(async (t) => {
 		try {
 			if (typeof window > "u") throw Error("XLSX parsing not available in server environment");
-			let n = await import("./exceljs.min-DL1XYDll.mjs").then((t) => /* @__PURE__ */ e(t.default)), r = await t.arrayBuffer(), a = new n.Workbook();
+			let n = await import("./exceljs.min-M0HhQgNK.mjs").then((t) => /* @__PURE__ */ e(t.default)), r = await t.arrayBuffer(), a = new n.Workbook();
 			await a.xlsx.load(r);
 			let o = i.parseOptions?.xlsx?.sheetIndex ?? 0, s = i.parseOptions?.xlsx?.headerRow ?? 1, c = a.worksheets[o];
 			if (!c || c.rowCount === 0) return [];

package/dist/utils/cn.d.ts

@@ -0,0 +1 @@
+export declare const cn: (...inputs: any[]) => string;

package/dist/utils/datetime-helpers.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Utilities et helpers pour WakaDateTimePicker
+ *
+ * Fonctions utilitaires pour :
+ * - Création de presets
+ * - Validation de dates
+ * - Formatage
+ * - Comparaison de dates
+ * - Calculs de ranges
+ */
+import type { DatePreset, DateRange } from "../components/waka-datetime-picker";
+/**
+ * Créer des presets de dates courantes
+ */
+export declare const createCommonPresets: (locale?: import("date-fns").Locale) => DatePreset[];
+/**
+ * Créer des presets pour les 7, 30, 90 derniers jours
+ */
+export declare const createLastDaysPresets: () => DatePreset[];
+/**
+ * Créer des presets pour les N prochains jours
+ */
+export declare const createNextDaysPresets: (days: number[]) => DatePreset[];
+/**
+ * Créer un preset personnalisé
+ */
+export declare const createCustomPreset: (label: string, dateOrRange: Date | DateRange | (() => Date) | (() => DateRange)) => DatePreset;
+/**
+ * Validation : date dans le futur
+ */
+export declare const isFutureDate: (date: Date) => boolean;
+/**
+ * Validation : date dans le passé
+ */
+export declare const isPastDate: (date: Date) => boolean;
+/**
+ * Validation : date est aujourd'hui
+ */
+export declare const isToday: (date: Date) => boolean;
+/**
+ * Validation : date est un jour de semaine (lundi-vendredi)
+ */
+export declare const isWeekday: (date: Date) => boolean;
+/**
+ * Validation : date est un weekend (samedi-dimanche)
+ */
+export declare const isWeekend: (date: Date) => boolean;
+/**
+ * Validation : date est dans une liste de jours fériés
+ */
+export declare const isHoliday: (date: Date, holidays: Date[]) => boolean;
+/**
+ * Validation : date est dans un intervalle
+ */
+export declare const isDateInRange: (date: Date, start: Date, end: Date) => boolean;
+/**
+ * Validation : âge minimum
+ */
+export declare const createMinAgeValidator: (minAge: number) => (birthdate: Date) => boolean | string;
+/**
+ * Validation : âge maximum
+ */
+export declare const createMaxAgeValidator: (maxAge: number) => (birthdate: Date) => boolean | string;
+/**
+ * Validation : date d'expiration
+ */
+export declare const isNotExpired: (date: Date) => boolean | string;
+/**
+ * Calculer la durée entre deux dates
+ */
+export declare const calculateDuration: (from: Date, to: Date) => {
+    days: number;
+    weeks: number;
+    months: number;
+};
+/**
+ * Formater une range de dates
+ */
+export declare const formatDateRange: (range: DateRange, formatStr?: string, locale?: import("date-fns").Locale) => string;
+/**
+ * Obtenir les jours fériés français pour une année
+ */
+export declare const getFrenchHolidays: (year: number) => Date[];
+/**
+ * Obtenir les dates d'un mois
+ */
+export declare const getDatesInMonth: (year: number, month: number) => Date[];
+/**
+ * Obtenir tous les weekends d'un mois
+ */
+export declare const getWeekendsInMonth: (year: number, month: number) => Date[];
+/**
+ * Obtenir tous les jours de semaine d'un mois
+ */
+export declare const getWeekdaysInMonth: (year: number, month: number) => Date[];
+/**
+ * Créer un validateur de date d'expiration de carte bancaire
+ */
+export declare const createCardExpiryValidator: () => (date: Date) => boolean | string;
+/**
+ * Créer un validateur de date de réservation (X jours d'avance minimum)
+ */
+export declare const createBookingDateValidator: (minDaysInAdvance: number) => (date: Date) => boolean | string;
+/**
+ * Créer un validateur de plage de dates maximum
+ */
+export declare const createMaxRangeDaysValidator: (maxDays: number) => (range: DateRange) => boolean | string;
+/**
+ * Vérifier si deux dates sont le même jour
+ */
+export declare const isSameDay: (date1: Date, date2: Date) => boolean;
+/**
+ * Obtenir le nombre de jours ouvrés entre deux dates
+ */
+export declare const getWorkingDays: (from: Date, to: Date, holidays?: Date[]) => number;
+/**
+ * Créer des presets pour les trimestres
+ */
+export declare const createQuarterPresets: (year?: number) => DatePreset[];
+/**
+ * Créer des presets pour les mois de l'année
+ */
+export declare const createMonthlyPresets: (year?: number, locale?: import("date-fns").Locale) => DatePreset[];
+/**
+ * Convertir une date en timestamp
+ */
+export declare const dateToTimestamp: (date: Date) => number;
+/**
+ * Convertir un timestamp en date
+ */
+export declare const timestampToDate: (timestamp: number) => Date;
+/**
+ * Normaliser une date (début de journée)
+ */
+export declare const normalizeDate: (date: Date) => Date;
+/**
+ * Comparer deux ranges de dates
+ */
+export declare const compareRanges: (range1: DateRange, range2: DateRange) => boolean;
+/**
+ * Merger deux ranges de dates
+ */
+export declare const mergeRanges: (range1: DateRange, range2: DateRange) => DateRange | null;
+/**
+ * Vérifier si deux ranges se chevauchent
+ */
+export declare const rangesOverlap: (range1: DateRange, range2: DateRange) => boolean;

package/dist/utils/error-handling.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Unified Error Handling System for @wakastart/ui
+ *
+ * Provides consistent error handling patterns across all components.
+ *
+ * @module error-handling
+ * @example
+ * ```tsx
+ * import { WakaError, tryCatch, tryCatchAsync, handleError } from '@wakastellar/ui'
+ *
+ * // Sync operations
+ * const result = tryCatch(() => parseJSON(data), {
+ *   context: 'DataTable.parseConfig',
+ *   fallback: defaultConfig,
+ * })
+ *
+ * // Async operations
+ * const data = await tryCatchAsync(() => fetchData(), {
+ *   context: 'DataTable.fetchData',
+ *   onError: (err) => showToast(err.message),
+ * })
+ * ```
+ */
+/**
+ * Error codes for @wakastart/ui
+ */
+export declare const ErrorCode: {
+    readonly UNKNOWN: "WAKA_UNKNOWN";
+    readonly VALIDATION: "WAKA_VALIDATION";
+    readonly NETWORK: "WAKA_NETWORK";
+    readonly TIMEOUT: "WAKA_TIMEOUT";
+    readonly THEME_LOAD_FAILED: "WAKA_THEME_LOAD_FAILED";
+    readonly THEME_PARSE_FAILED: "WAKA_THEME_PARSE_FAILED";
+    readonly THEME_APPLY_FAILED: "WAKA_THEME_APPLY_FAILED";
+    readonly LANG_LOAD_FAILED: "WAKA_LANG_LOAD_FAILED";
+    readonly LANG_PARSE_FAILED: "WAKA_LANG_PARSE_FAILED";
+    readonly TRANSLATION_MISSING: "WAKA_TRANSLATION_MISSING";
+    readonly DATATABLE_EXPORT_FAILED: "WAKA_DATATABLE_EXPORT_FAILED";
+    readonly DATATABLE_IMPORT_FAILED: "WAKA_DATATABLE_IMPORT_FAILED";
+    readonly DATATABLE_PARSE_FAILED: "WAKA_DATATABLE_PARSE_FAILED";
+    readonly COMPONENT_RENDER_FAILED: "WAKA_COMPONENT_RENDER_FAILED";
+    readonly COMPONENT_INIT_FAILED: "WAKA_COMPONENT_INIT_FAILED";
+    readonly PROVIDER_MISSING: "WAKA_PROVIDER_MISSING";
+    readonly PROVIDER_CONFIG_INVALID: "WAKA_PROVIDER_CONFIG_INVALID";
+};
+export type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Custom error class for @wakastart/ui
+ */
+export declare class WakaError extends Error {
+    /** Error code for programmatic handling */
+    readonly code: ErrorCodeType;
+    /** Context where the error occurred */
+    readonly context?: string;
+    /** Original error if wrapped */
+    readonly cause?: Error;
+    /** Additional metadata */
+    readonly metadata?: Record<string, unknown>;
+    /** Timestamp when error occurred */
+    readonly timestamp: Date;
+    constructor(message: string, options?: {
+        code?: ErrorCodeType;
+        context?: string;
+        cause?: Error;
+        metadata?: Record<string, unknown>;
+    });
+    /**
+     * Create a WakaError from any error type
+     */
+    static from(error: unknown, options?: {
+        code?: ErrorCodeType;
+        context?: string;
+        metadata?: Record<string, unknown>;
+    }): WakaError;
+    /**
+     * Serialize error for logging or transmission
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Options for error handling utilities
+ */
+export interface ErrorHandlerOptions<T> {
+    /** Context identifier for logging */
+    context?: string;
+    /** Error code to use */
+    code?: ErrorCodeType;
+    /** Callback when error occurs */
+    onError?: (error: WakaError) => void;
+    /** Fallback value to return on error */
+    fallback?: T;
+    /** Whether to rethrow the error after handling */
+    rethrow?: boolean;
+    /** Additional metadata to attach to error */
+    metadata?: Record<string, unknown>;
+    /** Whether to suppress logging (default: false) */
+    silent?: boolean;
+}
+/**
+ * Handle an error with consistent logging and callbacks
+ */
+export declare function handleError(error: unknown, options?: Omit<ErrorHandlerOptions<unknown>, "fallback">): WakaError;
+/**
+ * Wrap a synchronous operation with error handling
+ *
+ * @example
+ * ```ts
+ * const config = tryCatch(
+ *   () => JSON.parse(jsonString),
+ *   { context: 'parseConfig', fallback: {} }
+ * )
+ * ```
+ */
+export declare function tryCatch<T>(fn: () => T, options?: ErrorHandlerOptions<T>): T | undefined;
+/**
+ * Wrap an async operation with error handling
+ *
+ * @example
+ * ```ts
+ * const data = await tryCatchAsync(
+ *   () => fetch('/api/data').then(r => r.json()),
+ *   { context: 'fetchData', onError: showError }
+ * )
+ * ```
+ */
+export declare function tryCatchAsync<T>(fn: () => Promise<T>, options?: ErrorHandlerOptions<T>): Promise<T | undefined>;
+/**
+ * Create a wrapped version of an async function with error handling
+ *
+ * @example
+ * ```ts
+ * const safeFetch = withErrorHandling(
+ *   fetchUserData,
+ *   { context: 'UserService.fetchData' }
+ * )
+ * ```
+ */
+export declare function withErrorHandling<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => Promise<TReturn>, options?: Omit<ErrorHandlerOptions<TReturn>, "fallback">): (...args: TArgs) => Promise<TReturn>;
+/**
+ * Assert a condition, throwing a WakaError if false
+ *
+ * @example
+ * ```ts
+ * assertCondition(user != null, 'User must be authenticated', {
+ *   code: ErrorCode.VALIDATION,
+ *   context: 'UserProfile',
+ * })
+ * ```
+ */
+export declare function assertCondition(condition: boolean, message: string, options?: {
+    code?: ErrorCodeType;
+    context?: string;
+    metadata?: Record<string, unknown>;
+}): asserts condition;
+/**
+ * Type guard to check if an error is a WakaError
+ */
+export declare function isWakaError(error: unknown): error is WakaError;
+/**
+ * Check if error matches a specific code
+ */
+export declare function isErrorCode(error: unknown, code: ErrorCodeType): error is WakaError;
+/**
+ * Create error factories for specific contexts
+ *
+ * @example
+ * ```ts
+ * const createDataTableError = createErrorFactory('DataTable')
+ * throw createDataTableError('Export failed', ErrorCode.DATATABLE_EXPORT_FAILED)
+ * ```
+ */
+export declare function createErrorFactory(context: string): (message: string, code?: ErrorCodeType, metadata?: Record<string, unknown>) => WakaError;
+/**
+ * Retry an async operation with exponential backoff
+ *
+ * @example
+ * ```ts
+ * const data = await retryAsync(
+ *   () => fetchWithTimeout('/api/data'),
+ *   { maxRetries: 3, context: 'fetchData' }
+ * )
+ * ```
+ */
+export declare function retryAsync<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+    context?: string;
+    onRetry?: (attempt: number, error: WakaError) => void;
+}): Promise<T>;

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+export { cn } from "./cn";
+export { tweak, type VariantProps } from "./tweak";
+export * from "./datetime-helpers";
+export { ThemeLoader, initThemeLoader, getThemeLoader, loadTheme, applyTheme, useThemeLoader } from "./theme-loader";
+export type { ThemeLoaderConfig } from "./theme-loader";
+export { logger, type Logger } from "./logger";

package/dist/utils/logger.d.ts

@@ -0,0 +1,9 @@
+type LogArgs = unknown[];
+export declare const logger: {
+    info: (...args: LogArgs) => void;
+    warn: (...args: LogArgs) => void;
+    error: (...args: LogArgs) => void;
+    log: (...args: LogArgs) => void;
+};
+export type Logger = typeof logger;
+export {};

package/dist/utils/security.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Security utilities for sanitizing user input and preventing XSS/injection attacks.
+ *
+ * @module security
+ */
+/**
+ * Validates and sanitizes a URL to prevent javascript: protocol attacks.
+ *
+ * @param url - The URL to validate
+ * @returns The sanitized URL if safe, or undefined if potentially malicious
+ *
+ * @example
+ * ```ts
+ * const safeUrl = sanitizeUrl("https://example.com") // "https://example.com"
+ * const blocked = sanitizeUrl("javascript:alert(1)") // undefined
+ * ```
+ *
+ * @security
+ * This function blocks:
+ * - javascript: protocol URLs
+ * - data: protocol URLs (except data:image for specific use cases)
+ * - vbscript: protocol URLs
+ * - URLs with encoded dangerous protocols
+ */
+export declare function sanitizeUrl(url: string | undefined | null): string | undefined;
+/**
+ * Safely navigates to a URL after validation.
+ * Use this instead of directly assigning to window.location.href.
+ *
+ * @param url - The URL to navigate to
+ * @returns true if navigation was performed, false if blocked
+ *
+ * @example
+ * ```ts
+ * // Safe navigation
+ * safeNavigate("https://example.com") // navigates
+ * safeNavigate("javascript:alert(1)") // blocked, returns false
+ * ```
+ */
+export declare function safeNavigate(url: string | undefined | null): boolean;
+/**
+ * Escapes special regex characters in a string.
+ * Use this when creating RegExp from user input to prevent ReDoS attacks.
+ *
+ * @param str - The string to escape
+ * @returns The escaped string safe for use in RegExp
+ *
+ * @example
+ * ```ts
+ * const pattern = escapeRegex("user.name") // "user\\.name"
+ * const regex = new RegExp(pattern, "i")
+ * ```
+ *
+ * @security
+ * This prevents:
+ * - ReDoS (Regular Expression Denial of Service) attacks
+ * - Unintended regex matching due to special characters
+ */
+export declare function escapeRegex(str: string): string;
+/**
+ * Creates a safe RegExp from user input by escaping special characters.
+ *
+ * @param pattern - The pattern string (will be escaped)
+ * @param flags - Optional regex flags
+ * @returns A safe RegExp instance
+ *
+ * @example
+ * ```ts
+ * const regex = createSafeRegex("search.term", "gi")
+ * // Matches literal "search.term" not "search" + any char + "term"
+ * ```
+ */
+export declare function createSafeRegex(pattern: string, flags?: string): RegExp;
+/**
+ * Creates a RegExp for highlighting text in search results.
+ * Escapes the search term and wraps in capture group for splitting.
+ *
+ * @param searchTerm - The term to highlight
+ * @returns A case-insensitive RegExp for highlighting
+ *
+ * @example
+ * ```ts
+ * const regex = createHighlightRegex("search")
+ * const parts = "Search results".split(regex)
+ * // ["", "Search", " results"]
+ * ```
+ */
+export declare function createHighlightRegex(searchTerm: string): RegExp;
+/**
+ * Sanitizes HTML content by escaping dangerous characters.
+ * Use when displaying user-generated content.
+ *
+ * @param html - The HTML string to sanitize
+ * @returns Escaped HTML safe for display
+ */
+export declare function escapeHtml(html: string): string;

package/dist/utils/theme-loader.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Theme Loader pour charger dynamiquement les thèmes depuis S3 ou toute URL
+ *
+ * Supporte tous les formats de couleurs (hex, rgb, hsl, oklch, etc.)
+ * grâce au système TweakCN avec @theme inline
+ */
+export interface ThemeLoaderConfig {
+    /**
+     * URL de base où les thèmes sont stockés (S3, CDN, etc.)
+     */
+    baseUrl: string;
+    /**
+     * Cache les thèmes déjà chargés pour éviter les requêtes répétées
+     */
+    cache?: boolean;
+    /**
+     * Timeout en millisecondes pour le chargement d'un thème
+     */
+    timeout?: number;
+    /**
+     * Callback appelé en cas d'erreur de chargement
+     */
+    onError?: (error: Error, themeName: string) => void;
+    /**
+     * Callback appelé une fois le thème chargé avec succès
+     */
+    onSuccess?: (themeName: string) => void;
+}
+declare class ThemeLoader {
+    private config;
+    private loadedThemes;
+    private styleElements;
+    constructor(config: ThemeLoaderConfig);
+    /**
+     * Charge un thème depuis une URL
+     */
+    loadTheme(themeName: string): Promise<void>;
+    /**
+     * Applique un thème déjà chargé
+     */
+    applyTheme(themeName: string): void;
+    /**
+     * Récupère le thème actuellement appliqué
+     */
+    getCurrentTheme(): string | null;
+    /**
+     * Charge le dernier thème utilisé depuis localStorage
+     */
+    loadSavedTheme(): string | null;
+    /**
+     * Précharge plusieurs thèmes en parallèle
+     */
+    preloadThemes(themeNames: string[]): Promise<void>;
+    /**
+     * Supprime un thème du cache et du DOM
+     */
+    unloadTheme(themeName: string): void;
+    /**
+     * Vide complètement le cache
+     */
+    clearCache(): void;
+    /**
+     * Liste tous les thèmes chargés
+     */
+    getLoadedThemes(): string[];
+    /**
+     * Construit l'URL complète d'un thème
+     */
+    private buildThemeUrl;
+    /**
+     * Injecte les styles d'un thème dans le document
+     */
+    private injectThemeStyles;
+}
+/**
+ * Initialise le theme loader avec une configuration
+ */
+export declare function initThemeLoader(config: ThemeLoaderConfig): ThemeLoader;
+/**
+ * Récupère l'instance globale du theme loader
+ */
+export declare function getThemeLoader(): ThemeLoader;
+/**
+ * Charge un thème depuis l'instance globale
+ */
+export declare function loadTheme(themeName: string): Promise<void>;
+/**
+ * Applique un thème depuis l'instance globale
+ */
+export declare function applyTheme(themeName: string): void;
+/**
+ * Hook React pour charger des thèmes dynamiquement
+ */
+export declare function useThemeLoader(config?: Partial<ThemeLoaderConfig>): {
+    loadTheme: (themeName: string) => Promise<void>;
+    applyTheme: (themeName: string) => void;
+    currentTheme: string;
+    loadedThemes: string[];
+    isLoading: boolean;
+};
+export { ThemeLoader };

package/dist/utils/tweak.d.ts

@@ -0,0 +1,18 @@
+import { type ClassValue } from "clsx";
+import { type VariantProps } from "class-variance-authority";
+export type ConfigVariants<T> = T extends Record<string, Record<string, string>> ? {
+    [K in keyof T]?: keyof T[K];
+} : never;
+export type ClassProp = {
+    class?: ClassValue;
+    className?: ClassValue;
+};
+export declare function tweak(...inputs: ClassValue[]): string;
+export declare namespace tweak {
+    var variants: <T extends Record<string, Record<string, string>>, Defaults extends Partial<Record<keyof T, string>> = {}>(config: {
+        base?: string;
+        variants?: T;
+        defaultVariants?: Defaults;
+    }) => (options?: (ConfigVariants<T> & ClassProp)) => string;
+}
+export type { VariantProps };