@sia-ui/utils 0.1.0

package/dist/string.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+// src/string.ts
+function removeDiacritics(value) {
+  return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+}
+function truncate(text, maxLength) {
+  if (maxLength <= 0) return "";
+  if (text.length <= maxLength) return text;
+  if (maxLength <= 3) return ".".repeat(maxLength);
+  return `${text.slice(0, maxLength - 3)}...`;
+}
+function capitalize(text) {
+  if (!text) return "";
+  return text.charAt(0).toUpperCase() + text.slice(1).toLowerCase();
+}
+function titleCase(text) {
+  return normalizeSpaces(text).split(" ").filter(Boolean).map(capitalize).join(" ");
+}
+function initials(text) {
+  return normalizeSpaces(text).split(" ").filter(Boolean).slice(0, 2).map((part) => part[0]?.toUpperCase() ?? "").join("");
+}
+function slugify(text) {
+  return removeDiacritics(text).toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function normalizeSpaces(text) {
+  return text.trim().replace(/\s+/g, " ");
+}
+function normalizeIdentifier(text, maxLength = 120) {
+  return removeDiacritics(text).toLowerCase().trim().replace(/[^a-z0-9_-]+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "").slice(0, maxLength);
+}
+function maskMiddle(text, options = {}) {
+  const { visibleStart = 2, visibleEnd = 2, maskChar = "*" } = options;
+  if (text.length <= visibleStart + visibleEnd) return text;
+  const maskedLength = text.length - visibleStart - visibleEnd;
+  return `${text.slice(0, visibleStart)}${maskChar.repeat(maskedLength)}${text.slice(text.length - visibleEnd)}`;
+}
+function isBlank(value) {
+  return !value || normalizeSpaces(value).length === 0;
+}
+
+exports.capitalize = capitalize;
+exports.initials = initials;
+exports.isBlank = isBlank;
+exports.maskMiddle = maskMiddle;
+exports.normalizeIdentifier = normalizeIdentifier;
+exports.normalizeSpaces = normalizeSpaces;
+exports.slugify = slugify;
+exports.titleCase = titleCase;
+exports.truncate = truncate;

package/dist/string.d.cts

@@ -0,0 +1,15 @@
+declare function truncate(text: string, maxLength: number): string;
+declare function capitalize(text: string): string;
+declare function titleCase(text: string): string;
+declare function initials(text: string): string;
+declare function slugify(text: string): string;
+declare function normalizeSpaces(text: string): string;
+declare function normalizeIdentifier(text: string, maxLength?: number): string;
+declare function maskMiddle(text: string, options?: {
+    visibleStart?: number;
+    visibleEnd?: number;
+    maskChar?: string;
+}): string;
+declare function isBlank(value: string | null | undefined): boolean;
+
+export { capitalize, initials, isBlank, maskMiddle, normalizeIdentifier, normalizeSpaces, slugify, titleCase, truncate };

package/dist/string.d.ts

@@ -0,0 +1,15 @@
+declare function truncate(text: string, maxLength: number): string;
+declare function capitalize(text: string): string;
+declare function titleCase(text: string): string;
+declare function initials(text: string): string;
+declare function slugify(text: string): string;
+declare function normalizeSpaces(text: string): string;
+declare function normalizeIdentifier(text: string, maxLength?: number): string;
+declare function maskMiddle(text: string, options?: {
+    visibleStart?: number;
+    visibleEnd?: number;
+    maskChar?: string;
+}): string;
+declare function isBlank(value: string | null | undefined): boolean;
+
+export { capitalize, initials, isBlank, maskMiddle, normalizeIdentifier, normalizeSpaces, slugify, titleCase, truncate };

package/dist/string.js

@@ -0,0 +1 @@
+export { capitalize, initials, isBlank, maskMiddle, normalizeIdentifier, normalizeSpaces, slugify, titleCase, truncate } from './chunk-PTNHOSWH.js';

package/dist/validation.cjs

@@ -0,0 +1,123 @@
+'use strict';
+
+// src/validation.ts
+var patterns = {
+  // Volontairement permissive : la seule validation d'adresse qui compte est
+  // le courriel de confirmation. Une expression stricte rejette des adresses
+  // valides, ce qui est pire que d'en accepter une fausse.
+  email: /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/,
+  url: /^https?:\/\/[^\s]+$/i,
+  slug: /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
+  hexColor: /^#(?:[0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,
+  digits: /^\d+$/,
+  /** Numéro international : un `+` facultatif, puis 8 à 15 chiffres. */
+  phone: /^\+?\d{8,15}$/
+};
+function text(value) {
+  return typeof value === "string" ? value : String(value ?? "");
+}
+function isEmail(value) {
+  return patterns.email.test(text(value).trim());
+}
+function isUrl(value) {
+  return patterns.url.test(text(value).trim());
+}
+function isPhone(value) {
+  return patterns.phone.test(text(value).replace(/[\s.\-()]/g, ""));
+}
+function isSlug(value) {
+  return patterns.slug.test(text(value));
+}
+function isHexColor(value) {
+  return patterns.hexColor.test(text(value).trim());
+}
+function isValidDate(value) {
+  if (value instanceof Date) return !Number.isNaN(value.getTime());
+  if (typeof value !== "string" && typeof value !== "number") return false;
+  return !Number.isNaN(new Date(value).getTime());
+}
+function required(message = "Ce champ est obligatoire") {
+  const rule = (value) => {
+    if (value === null || value === void 0) return message;
+    if (typeof value === "string" && value.trim() === "") return message;
+    if (Array.isArray(value) && value.length === 0) return message;
+    if (value === false) return message;
+    return void 0;
+  };
+  rule.judgesEmpty = true;
+  return rule;
+}
+function minLength(min2, message) {
+  return (value) => text(value).length < min2 ? message ?? `Au moins ${min2} caract\xE8res` : void 0;
+}
+function maxLength(max2, message) {
+  return (value) => text(value).length > max2 ? message ?? `Au plus ${max2} caract\xE8res` : void 0;
+}
+function min(bound, message) {
+  return (value) => Number(value) < bound ? message ?? `Minimum ${bound}` : void 0;
+}
+function max(bound, message) {
+  return (value) => Number(value) > bound ? message ?? `Maximum ${bound}` : void 0;
+}
+function matches(pattern, message = "Format invalide") {
+  return (value) => pattern.test(text(value)) ? void 0 : message;
+}
+function email(message = "Adresse e-mail invalide") {
+  return (value) => isEmail(value) ? void 0 : message;
+}
+function url(message = "Adresse web invalide") {
+  return (value) => isUrl(value) ? void 0 : message;
+}
+function phone(message = "Num\xE9ro de t\xE9l\xE9phone invalide") {
+  return (value) => isPhone(value) ? void 0 : message;
+}
+function oneOf(values, message = "Valeur inattendue") {
+  return (value) => values.includes(value) ? void 0 : message;
+}
+function sameAs(values, field, message = "Les valeurs ne correspondent pas") {
+  return (value) => value === values[field] ? void 0 : message;
+}
+function all(...rules) {
+  return (value) => {
+    const empty = value === null || value === void 0 || typeof value === "string" && value.trim() === "";
+    for (const rule of rules) {
+      if (empty && !rule.judgesEmpty) continue;
+      const message = rule(value);
+      if (message) return message;
+    }
+    return void 0;
+  };
+}
+function createValidator(schema) {
+  return (values) => {
+    const errors = {};
+    for (const key of Object.keys(schema)) {
+      const rules = schema[key];
+      if (!rules || rules.length === 0) continue;
+      const message = all(...rules)(values[key]);
+      if (message) errors[key] = message;
+    }
+    return errors;
+  };
+}
+
+exports.all = all;
+exports.createValidator = createValidator;
+exports.email = email;
+exports.isEmail = isEmail;
+exports.isHexColor = isHexColor;
+exports.isPhone = isPhone;
+exports.isSlug = isSlug;
+exports.isUrl = isUrl;
+exports.isValidDate = isValidDate;
+exports.matches = matches;
+exports.max = max;
+exports.maxLength = maxLength;
+exports.min = min;
+exports.minLength = minLength;
+exports.oneOf = oneOf;
+exports.patterns = patterns;
+exports.phone = phone;
+exports.required = required;
+exports.sameAs = sameAs;
+exports.url = url;

package/dist/validation.d.cts

@@ -0,0 +1,77 @@
+/**
+ * Validation, sans schéma.
+ *
+ * Ce n'est pas un remplaçant de Zod : pas d'inférence de types, pas de
+ * transformation, pas de validation imbriquée. C'est le nécessaire pour un
+ * formulaire d'application de gestion, sous la forme exacte que
+ * `useLocalForm` attend — une fonction qui rend des messages par champ.
+ *
+ * Un projet qui a déjà Zod branche son schéma et n'utilise rien d'ici.
+ */
+/** Une règle rend un message d'erreur, ou `undefined` si la valeur passe. */
+interface Rule<T = unknown> {
+    (value: T): string | undefined;
+    /**
+     * Vrai pour la règle qui juge une valeur vide — `required`, et elle seule.
+     * Un marqueur plutôt qu'une comparaison de nom, qui disparaît à la
+     * minification.
+     */
+    judgesEmpty?: boolean;
+}
+declare const patterns: {
+    readonly email: RegExp;
+    readonly url: RegExp;
+    readonly slug: RegExp;
+    readonly hexColor: RegExp;
+    readonly digits: RegExp;
+    /** Numéro international : un `+` facultatif, puis 8 à 15 chiffres. */
+    readonly phone: RegExp;
+};
+declare function isEmail(value: unknown): boolean;
+declare function isUrl(value: unknown): boolean;
+/** Accepte les espaces et les points de séparation, qu'elle retire. */
+declare function isPhone(value: unknown): boolean;
+declare function isSlug(value: unknown): boolean;
+declare function isHexColor(value: unknown): boolean;
+/** Vrai pour une date réelle. `new Date("2026-02-30")` ne l'est pas. */
+declare function isValidDate(value: unknown): boolean;
+declare function required(message?: string): Rule;
+declare function minLength(min: number, message?: string): Rule;
+declare function maxLength(max: number, message?: string): Rule;
+declare function min(bound: number, message?: string): Rule;
+declare function max(bound: number, message?: string): Rule;
+declare function matches(pattern: RegExp, message?: string): Rule;
+declare function email(message?: string): Rule;
+declare function url(message?: string): Rule;
+declare function phone(message?: string): Rule;
+declare function oneOf<T>(values: readonly T[], message?: string): Rule<T>;
+/** Compare à un autre champ — la confirmation d'un mot de passe. */
+declare function sameAs<T extends Record<string, unknown>>(values: T, field: keyof T & string, message?: string): Rule;
+/**
+ * Enchaîne des règles. La première qui échoue l'emporte.
+ *
+ * Un champ vide facultatif passe : seule la règle marquée `judgesEmpty` —
+ * `required` — s'intéresse au vide. Afficher « au moins huit caractères » sur
+ * un champ qu'on n'a pas encore rempli n'apprend rien à personne.
+ */
+declare function all<T>(...rules: Array<Rule<T>>): Rule<T>;
+/**
+ * Assemble un validateur de formulaire.
+ *
+ * Ce que rend cette fonction se passe directement à `useLocalForm` : c'est le
+ * point de rencontre entre ce module et le contrat de formulaire, sans que
+ * l'un importe l'autre.
+ *
+ * ```ts
+ * const validate = createValidator<Valeurs>({
+ *   nom: [required()],
+ *   email: [required(), email()],
+ *   montant: [required(), min(0)],
+ * });
+ * ```
+ */
+declare function createValidator<T extends Record<string, unknown>>(schema: {
+    [K in keyof T]?: Array<Rule<T[K]>>;
+}): (values: T) => { [K in keyof T]?: string; };
+
+export { type Rule, all, createValidator, email, isEmail, isHexColor, isPhone, isSlug, isUrl, isValidDate, matches, max, maxLength, min, minLength, oneOf, patterns, phone, required, sameAs, url };

package/dist/validation.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Validation, sans schéma.
+ *
+ * Ce n'est pas un remplaçant de Zod : pas d'inférence de types, pas de
+ * transformation, pas de validation imbriquée. C'est le nécessaire pour un
+ * formulaire d'application de gestion, sous la forme exacte que
+ * `useLocalForm` attend — une fonction qui rend des messages par champ.
+ *
+ * Un projet qui a déjà Zod branche son schéma et n'utilise rien d'ici.
+ */
+/** Une règle rend un message d'erreur, ou `undefined` si la valeur passe. */
+interface Rule<T = unknown> {
+    (value: T): string | undefined;
+    /**
+     * Vrai pour la règle qui juge une valeur vide — `required`, et elle seule.
+     * Un marqueur plutôt qu'une comparaison de nom, qui disparaît à la
+     * minification.
+     */
+    judgesEmpty?: boolean;
+}
+declare const patterns: {
+    readonly email: RegExp;
+    readonly url: RegExp;
+    readonly slug: RegExp;
+    readonly hexColor: RegExp;
+    readonly digits: RegExp;
+    /** Numéro international : un `+` facultatif, puis 8 à 15 chiffres. */
+    readonly phone: RegExp;
+};
+declare function isEmail(value: unknown): boolean;
+declare function isUrl(value: unknown): boolean;
+/** Accepte les espaces et les points de séparation, qu'elle retire. */
+declare function isPhone(value: unknown): boolean;
+declare function isSlug(value: unknown): boolean;
+declare function isHexColor(value: unknown): boolean;
+/** Vrai pour une date réelle. `new Date("2026-02-30")` ne l'est pas. */
+declare function isValidDate(value: unknown): boolean;
+declare function required(message?: string): Rule;
+declare function minLength(min: number, message?: string): Rule;
+declare function maxLength(max: number, message?: string): Rule;
+declare function min(bound: number, message?: string): Rule;
+declare function max(bound: number, message?: string): Rule;
+declare function matches(pattern: RegExp, message?: string): Rule;
+declare function email(message?: string): Rule;
+declare function url(message?: string): Rule;
+declare function phone(message?: string): Rule;
+declare function oneOf<T>(values: readonly T[], message?: string): Rule<T>;
+/** Compare à un autre champ — la confirmation d'un mot de passe. */
+declare function sameAs<T extends Record<string, unknown>>(values: T, field: keyof T & string, message?: string): Rule;
+/**
+ * Enchaîne des règles. La première qui échoue l'emporte.
+ *
+ * Un champ vide facultatif passe : seule la règle marquée `judgesEmpty` —
+ * `required` — s'intéresse au vide. Afficher « au moins huit caractères » sur
+ * un champ qu'on n'a pas encore rempli n'apprend rien à personne.
+ */
+declare function all<T>(...rules: Array<Rule<T>>): Rule<T>;
+/**
+ * Assemble un validateur de formulaire.
+ *
+ * Ce que rend cette fonction se passe directement à `useLocalForm` : c'est le
+ * point de rencontre entre ce module et le contrat de formulaire, sans que
+ * l'un importe l'autre.
+ *
+ * ```ts
+ * const validate = createValidator<Valeurs>({
+ *   nom: [required()],
+ *   email: [required(), email()],
+ *   montant: [required(), min(0)],
+ * });
+ * ```
+ */
+declare function createValidator<T extends Record<string, unknown>>(schema: {
+    [K in keyof T]?: Array<Rule<T[K]>>;
+}): (values: T) => { [K in keyof T]?: string; };
+
+export { type Rule, all, createValidator, email, isEmail, isHexColor, isPhone, isSlug, isUrl, isValidDate, matches, max, maxLength, min, minLength, oneOf, patterns, phone, required, sameAs, url };

package/dist/validation.js

@@ -0,0 +1,102 @@
+// src/validation.ts
+var patterns = {
+  // Volontairement permissive : la seule validation d'adresse qui compte est
+  // le courriel de confirmation. Une expression stricte rejette des adresses
+  // valides, ce qui est pire que d'en accepter une fausse.
+  email: /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/,
+  url: /^https?:\/\/[^\s]+$/i,
+  slug: /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
+  hexColor: /^#(?:[0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,
+  digits: /^\d+$/,
+  /** Numéro international : un `+` facultatif, puis 8 à 15 chiffres. */
+  phone: /^\+?\d{8,15}$/
+};
+function text(value) {
+  return typeof value === "string" ? value : String(value ?? "");
+}
+function isEmail(value) {
+  return patterns.email.test(text(value).trim());
+}
+function isUrl(value) {
+  return patterns.url.test(text(value).trim());
+}
+function isPhone(value) {
+  return patterns.phone.test(text(value).replace(/[\s.\-()]/g, ""));
+}
+function isSlug(value) {
+  return patterns.slug.test(text(value));
+}
+function isHexColor(value) {
+  return patterns.hexColor.test(text(value).trim());
+}
+function isValidDate(value) {
+  if (value instanceof Date) return !Number.isNaN(value.getTime());
+  if (typeof value !== "string" && typeof value !== "number") return false;
+  return !Number.isNaN(new Date(value).getTime());
+}
+function required(message = "Ce champ est obligatoire") {
+  const rule = (value) => {
+    if (value === null || value === void 0) return message;
+    if (typeof value === "string" && value.trim() === "") return message;
+    if (Array.isArray(value) && value.length === 0) return message;
+    if (value === false) return message;
+    return void 0;
+  };
+  rule.judgesEmpty = true;
+  return rule;
+}
+function minLength(min2, message) {
+  return (value) => text(value).length < min2 ? message ?? `Au moins ${min2} caract\xE8res` : void 0;
+}
+function maxLength(max2, message) {
+  return (value) => text(value).length > max2 ? message ?? `Au plus ${max2} caract\xE8res` : void 0;
+}
+function min(bound, message) {
+  return (value) => Number(value) < bound ? message ?? `Minimum ${bound}` : void 0;
+}
+function max(bound, message) {
+  return (value) => Number(value) > bound ? message ?? `Maximum ${bound}` : void 0;
+}
+function matches(pattern, message = "Format invalide") {
+  return (value) => pattern.test(text(value)) ? void 0 : message;
+}
+function email(message = "Adresse e-mail invalide") {
+  return (value) => isEmail(value) ? void 0 : message;
+}
+function url(message = "Adresse web invalide") {
+  return (value) => isUrl(value) ? void 0 : message;
+}
+function phone(message = "Num\xE9ro de t\xE9l\xE9phone invalide") {
+  return (value) => isPhone(value) ? void 0 : message;
+}
+function oneOf(values, message = "Valeur inattendue") {
+  return (value) => values.includes(value) ? void 0 : message;
+}
+function sameAs(values, field, message = "Les valeurs ne correspondent pas") {
+  return (value) => value === values[field] ? void 0 : message;
+}
+function all(...rules) {
+  return (value) => {
+    const empty = value === null || value === void 0 || typeof value === "string" && value.trim() === "";
+    for (const rule of rules) {
+      if (empty && !rule.judgesEmpty) continue;
+      const message = rule(value);
+      if (message) return message;
+    }
+    return void 0;
+  };
+}
+function createValidator(schema) {
+  return (values) => {
+    const errors = {};
+    for (const key of Object.keys(schema)) {
+      const rules = schema[key];
+      if (!rules || rules.length === 0) continue;
+      const message = all(...rules)(values[key]);
+      if (message) errors[key] = message;
+    }
+    return errors;
+  };
+}
+
+export { all, createValidator, email, isEmail, isHexColor, isPhone, isSlug, isUrl, isValidDate, matches, max, maxLength, min, minLength, oneOf, patterns, phone, required, sameAs, url };

package/package.json

@@ -0,0 +1,127 @@
+{
+  "name": "@sia-ui/utils",
+  "version": "0.1.0",
+  "description": "Shared utility modules for SIA UI applications.",
+  "keywords": [
+    "sia-ui",
+    "utils",
+    "currency",
+    "date",
+    "xof",
+    "xaf",
+    "intl"
+  ],
+  "license": "MIT",
+  "author": "Ivan Mbella",
+  "homepage": "https://github.com/BeatJo/sia-ui#readme",
+  "bugs": {
+    "url": "https://github.com/BeatJo/sia-ui/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BeatJo/sia-ui.git",
+    "directory": "packages/utils"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./async": {
+      "types": "./dist/async.d.ts",
+      "import": "./dist/async.js",
+      "require": "./dist/async.cjs"
+    },
+    "./classname": {
+      "types": "./dist/classname.d.ts",
+      "import": "./dist/classname.js",
+      "require": "./dist/classname.cjs"
+    },
+    "./clipboard": {
+      "types": "./dist/clipboard.d.ts",
+      "import": "./dist/clipboard.js",
+      "require": "./dist/clipboard.cjs"
+    },
+    "./collection": {
+      "types": "./dist/collection.d.ts",
+      "import": "./dist/collection.js",
+      "require": "./dist/collection.cjs"
+    },
+    "./currency": {
+      "types": "./dist/currency.d.ts",
+      "import": "./dist/currency.js",
+      "require": "./dist/currency.cjs"
+    },
+    "./date": {
+      "types": "./dist/date.d.ts",
+      "import": "./dist/date.js",
+      "require": "./dist/date.cjs"
+    },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js",
+      "require": "./dist/events.cjs"
+    },
+    "./file": {
+      "types": "./dist/file.d.ts",
+      "import": "./dist/file.js",
+      "require": "./dist/file.cjs"
+    },
+    "./locale": {
+      "types": "./dist/locale.d.ts",
+      "import": "./dist/locale.js",
+      "require": "./dist/locale.cjs"
+    },
+    "./number": {
+      "types": "./dist/number.d.ts",
+      "import": "./dist/number.js",
+      "require": "./dist/number.cjs"
+    },
+    "./object": {
+      "types": "./dist/object.d.ts",
+      "import": "./dist/object.js",
+      "require": "./dist/object.cjs"
+    },
+    "./query": {
+      "types": "./dist/query.d.ts",
+      "import": "./dist/query.js",
+      "require": "./dist/query.cjs"
+    },
+    "./string": {
+      "types": "./dist/string.d.ts",
+      "import": "./dist/string.js",
+      "require": "./dist/string.cjs"
+    },
+    "./validation": {
+      "types": "./dist/validation.d.ts",
+      "import": "./dist/validation.js",
+      "require": "./dist/validation.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}