libmodulor 0.23.0 → 0.25.0

package/dist/esm/dt/final/TFilePath.d.ts

@@ -1,7 +1,14 @@
 import type { TName } from '../base/TBase.js';
 import { TString, type TStringConstraints } from '../base/TString.js';
+import type { FileMimeType } from './TFileMimeType.js';
+import type { FileName } from './TFileName.js';
+import type { UIntQuantity } from './TUIntQuantity.js';
 export type FilePath = string;
 export declare class TFilePath extends TString<FilePath> {
+    static readonly ABS_PATH: FilePath;
+    static readonly FILE_NAME: FileName;
+    static readonly FILE_SIZE: UIntQuantity;
+    static readonly MIME_TYPE: FileMimeType;
     static readonly FORMAT: RegExp;
     constructor(constraints?: TStringConstraints);
     tName(): TName;

package/dist/esm/dt/final/TFilePath.js

@@ -1,5 +1,9 @@
 import { TString } from '../base/TString.js';
 export class TFilePath extends TString {
+    static ABS_PATH = '/Users/dexter/Desktop';
+    static FILE_NAME = 'picture.png';
+    static FILE_SIZE = 32;
+    static MIME_TYPE = 'image/png';
     static FORMAT = /^[a-z0-9_/.][a-z0-9-_/.]+/i;
     constructor(constraints) {
         super({
@@ -11,6 +15,6 @@ export class TFilePath extends TString {
         return 'FilePath';
     }
     example() {
-        return '/Users/dexter/Desktop/picture.png';
+        return `${TFilePath.ABS_PATH}/${TFilePath.FILE_NAME}`;
     }
 }

package/dist/esm/dt/index.d.ts

@@ -27,7 +27,7 @@ export { type Emoji, TEmoji } from './final/TEmoji.js';
 export { type EncryptionKey, TEncryptionKey } from './final/TEncryptionKey.js';
 export { type ErrorMessage, TErrorMessage } from './final/TErrorMessage.js';
 export { type ExternalServiceId, TExternalServiceId, } from './final/TExternalServiceId.js';
-export { type File, TFile } from './final/TFile.js';
+export { type File, TFile, type TFileConstraints } from './final/TFile.js';
 export { type FileExtension, TFileExtension } from './final/TFileExtension.js';
 export { type FileMimeType, TFileMimeType } from './final/TFileMimeType.js';
 export { type FileName, TFileName } from './final/TFileName.js';

package/dist/esm/i18n/WordingManager.d.ts

@@ -18,11 +18,12 @@ import type { UCClientConfirmConfig, UCDef, UCExecState, UCFieldKey, UCInput, UC
  * One might argue that a label can be different for "name" in "CreateX" and "CreateY".
  * In this case, we consider that the input field shouldn't be named "name" in both places.
  */
-export type WordingManagerKey = `dt_${TName}_${string}_${keyof UCWording}` | `p_${keyof ProductWording}` | `uc_${UCName}_${keyof UCWording}` | `uc_${UCName}_client_confirm_${keyof UCClientConfirmConfig}` | `uc_${UCName}_i_submit_${UCExecState}` | `uc_${UCName}_op_${UCOutputPartIdx}_${keyof UCOutputPartWording}` | `ucif_${UCFieldKey}_${keyof UCWording}` | `ucof_${UCFieldKey}_${keyof UCWording}`;
+export type WordingManagerKey = `dt_${TName}_constr_${string}` | `dt_${TName}_${string}_${keyof UCWording}` | `p_${keyof ProductWording}` | `uc_${UCName}_${keyof UCWording}` | `uc_${UCName}_client_confirm_${keyof UCClientConfirmConfig}` | `uc_${UCName}_i_submit_${UCExecState}` | `uc_${UCName}_op_${UCOutputPartIdx}_${keyof UCOutputPartWording}` | `ucif_${UCFieldKey}_${keyof UCWording}` | `ucof_${UCFieldKey}_${keyof UCWording}`;
 export declare class WordingManager {
     private i18nManager;
     constructor(i18nManager: I18nManager);
     dt<DT extends DataType>(type: TBase<DT>): UCWording;
+    dtConstr<DT extends DataType>(type: TBase<DT>): string[] | null;
     p(): ProductWording;
     uc<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(def: UCDef<I, OPI0, OPI1>): UCWording;
     ucClientConfirm<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(def: UCDef<I, OPI0, OPI1>): UCClientConfirmConfig;

package/dist/esm/i18n/WordingManager.js

@@ -39,6 +39,24 @@ let WordingManager = class WordingManager {
         }
         return { desc, label };
     }
+    dtConstr(type) {
+        const constraints = type.getConstraintsForHuman();
+        if (!constraints) {
+            return null;
+        }
+        const entries = Object.entries(constraints);
+        if (entries.length === 0) {
+            return null;
+        }
+        const parts = [];
+        for (const [k, v] of Object.entries(constraints)) {
+            parts.push(
+            // TODO : Consider moving up the type hierarchy to fetch the constr of the parent when missing
+            // e.g. TFreeTextShort > TString
+            this.t(`dt_${type.tName()}_constr_${k}`, undefined, v));
+        }
+        return parts;
+    }
     p() {
         return {
             desc: this.tOrNull('p_desc'),
@@ -87,8 +105,11 @@ let WordingManager = class WordingManager {
             label: this.tOrNull(`uc_${name}_op_${idx}_label`),
         };
     }
-    t(key, fallback = undefined) {
-        return this.i18nManager.t(key, { fallback });
+    t(key, fallback = undefined, expected = undefined) {
+        return this.i18nManager.t(key, {
+            fallback,
+            vars: expected ? { expected } : {},
+        });
     }
     tOr(key, fallbackKey) {
         let val = this.tOrNull(key);

package/dist/esm/i18n/index.d.ts

@@ -1,3 +1,3 @@
 export { I18N_DEFAULT_LANG } from './consts.js';
-export type { I18n, I18nCoreKey, I18nCoreTranslations, I18nLanguageCode, I18nSource, I18nSourceSafe, I18nTranslation, I18nTranslationKey, } from './types.js';
+export type { I18n, I18nCoreKey, I18nCoreTranslations, I18nEntry, I18nLanguageCode, I18nSource, I18nSourceSafe, I18nTranslation, I18nTranslationKey, } from './types.js';
 export { WordingManager, type WordingManagerKey } from './WordingManager.js';

package/dist/esm/i18n/locales/de.d.ts

@@ -0,0 +1,2 @@
+import type { I18nCoreTranslations } from '../types.js';
+export declare const I18nDE: I18nCoreTranslations;

package/dist/esm/i18n/locales/de.js

@@ -0,0 +1,62 @@
+export const I18nDE = {
+    dt_File_constr_accept: 'Akzeptierte Typen: {{expected}}',
+    dt_File_constr_maxSizeInBytes: 'Maximale Größe: {{expected}}',
+    dt_File_constr_minSizeInBytes: 'Minimale Größe: {{expected}}',
+    dt_FreeTextShort_constr_format: 'Format: {{expected}}',
+    dt_FreeTextShort_constr_maxLength: 'Maximale Länge: {{expected}}',
+    dt_FreeTextShort_constr_minLength: 'Minimale Länge: {{expected}}',
+    dt_YesNo_N_desc: '',
+    dt_YesNo_N_label: 'Nein',
+    dt_YesNo_Y_desc: '',
+    dt_YesNo_Y_label: 'Ja',
+    uc_client_confirm_cancel: 'Abbrechen',
+    uc_client_confirm_confirm: 'Ja',
+    uc_client_confirm_message: '',
+    uc_client_confirm_title: 'Sind Sie sicher?',
+    uc_i_submit_changing: 'Laden',
+    uc_i_submit_idle: 'Speichern',
+    uc_i_submit_initializing: 'Laden',
+    uc_i_submit_submitting: 'Speichern',
+    validation_fieldsOr: 'Mindestens eines dieser Felder muss ausgefüllt werden: {{expected}}',
+    validation_format_ColorRGBA: 'Muss eine gültige RGBA-Farbe sein',
+    validation_format_DateISO8601: 'Muss ein gültiges Datum im ISO8601-Format sein',
+    validation_format_DirPath: 'Muss ein gültiger Verzeichnispfad sein',
+    validation_format_DomainName: 'Muss ein gültiger Domainname sein',
+    validation_format_Email: 'Muss eine gültige E-Mail-Adresse sein',
+    validation_format_FilePath: 'Muss ein gültiger Dateipfad sein',
+    validation_format_GitSSHURL: 'Muss eine gültige Git-SSH-URL sein',
+    validation_format_IPv4: 'Muss eine gültige IPv4-Adresse sein',
+    validation_format_IPv6: 'Muss eine gültige IPv6-Adresse sein',
+    validation_format_JSON: 'Muss ein gültiger JSON-String sein',
+    validation_format_JWT: 'Muss ein gültiges JWT sein',
+    validation_format_PersonFirstname: 'Muss ein gültiger Vorname sein, beginnend mit einem Großbuchstaben',
+    validation_format_PersonFullname: 'Muss ein gültiger vollständiger Name sein, beginnend mit einem Großbuchstaben',
+    validation_format_PersonInitials: 'Muss gültige Initialen aus Großbuchstaben enthalten',
+    validation_format_PersonLastname: 'Muss ein gültiger Nachname sein, beginnend mit einem Großbuchstaben',
+    validation_format_QRCode: 'Muss ein gültiger QR-Code im Base64-Format sein',
+    validation_format_SemVerVersion: 'Muss eine gültige SemVer-Version sein (X.X.X)',
+    validation_format_Slug: 'Darf nur Kleinbuchstaben, Ziffern und Bindestriche (-) enthalten',
+    validation_format_SSHPrivateKey: 'Muss ein gültiger privater SSH-Schlüssel sein',
+    validation_format_SSHPublicKey: 'Muss ein gültiger öffentlicher SSH-Schlüssel sein',
+    validation_format_Time: 'Muss eine gültige Uhrzeit sein',
+    validation_format_URL: 'Muss eine gültige URL sein',
+    validation_format_UUID: 'Muss eine gültige UUID sein',
+    validation_mandatory: 'Muss ausgefüllt werden',
+    validation_max: 'Muss kleiner oder gleich {{expected}} sein',
+    validation_maxCount: 'Darf höchstens {{expected}} Element(e) enthalten',
+    validation_maxLength: 'Darf höchstens {{expected}} Zeichen enthalten',
+    validation_maxSize: 'Muss eine maximale Größe von {{expected}} haben',
+    validation_min: 'Muss größer oder gleich {{expected}} sein',
+    validation_minCount: 'Muss mindestens {{expected}} Element(e) enthalten',
+    validation_minLength: 'Muss mindestens {{expected}} Zeichen enthalten',
+    validation_minSize: 'Muss eine minimale Größe von {{expected}} haben',
+    validation_oneOf: 'Muss eines der Elemente der Liste sein',
+    validation_shape: 'Muss der erwarteten Objektstruktur entsprechen',
+    validation_type_array: 'Muss ein Array sein',
+    validation_type_boolean: 'Muss ein Boolescher Wert sein',
+    validation_type_int: 'Muss eine ganze Zahl sein',
+    validation_type_number: 'Muss eine Zahl sein',
+    validation_type_object: 'Muss ein Objekt sein',
+    validation_type_scalar: 'Muss ein Skalar sein',
+    validation_type_string: 'Muss ein String sein',
+};

package/dist/esm/i18n/locales/en.js

@@ -1,4 +1,10 @@
 export const I18nEN = {
+    dt_File_constr_accept: 'Accepted types: {{expected}}',
+    dt_File_constr_maxSizeInBytes: 'Max size: {{expected}}',
+    dt_File_constr_minSizeInBytes: 'Min size: {{expected}}',
+    dt_FreeTextShort_constr_format: 'Format : {{expected}}',
+    dt_FreeTextShort_constr_maxLength: 'Max length : {{expected}}',
+    dt_FreeTextShort_constr_minLength: 'Min length : {{expected}}',
     dt_YesNo_N_desc: '',
     dt_YesNo_N_label: 'No',
     dt_YesNo_Y_desc: '',
@@ -39,9 +45,11 @@ export const I18nEN = {
     validation_max: 'Must be lower than or equal to {{expected}}',
     validation_maxCount: 'Must contain at most {{expected}} item(s)',
     validation_maxLength: 'Must contain at most {{expected}} character(s)',
+    validation_maxSize: 'Must have a max size of {{expected}}',
     validation_min: 'Must be greater than or equal to {{expected}}',
     validation_minCount: 'Must contain at least {{expected}} item(s)',
     validation_minLength: 'Must contain at least {{expected}} character(s)',
+    validation_minSize: 'Must have a min size of {{expected}}',
     validation_oneOf: 'Must be one of the elements of the list',
     validation_shape: 'Must respect the expected object shape',
     validation_type_array: 'Must be an array',

package/dist/esm/i18n/locales/es.d.ts

@@ -0,0 +1,2 @@
+import type { I18nCoreTranslations } from '../types.js';
+export declare const I18nES: I18nCoreTranslations;

package/dist/esm/i18n/locales/es.js

@@ -0,0 +1,62 @@
+export const I18nES = {
+    dt_File_constr_accept: 'Tipos aceptados: {{expected}}',
+    dt_File_constr_maxSizeInBytes: 'Tamaño máximo: {{expected}}',
+    dt_File_constr_minSizeInBytes: 'Tamaño mínimo: {{expected}}',
+    dt_FreeTextShort_constr_format: 'Formato: {{expected}}',
+    dt_FreeTextShort_constr_maxLength: 'Longitud máxima: {{expected}}',
+    dt_FreeTextShort_constr_minLength: 'Longitud mínima: {{expected}}',
+    dt_YesNo_N_desc: '',
+    dt_YesNo_N_label: 'No',
+    dt_YesNo_Y_desc: '',
+    dt_YesNo_Y_label: 'Sí',
+    uc_client_confirm_cancel: 'Cancelar',
+    uc_client_confirm_confirm: 'Sí',
+    uc_client_confirm_message: '',
+    uc_client_confirm_title: '¿Estás seguro?',
+    uc_i_submit_changing: 'Cargando',
+    uc_i_submit_idle: 'Guardar',
+    uc_i_submit_initializing: 'Cargando',
+    uc_i_submit_submitting: 'Guardando',
+    validation_fieldsOr: 'Al menos uno de estos campos debe estar completado: {{expected}}',
+    validation_format_ColorRGBA: 'Debe ser un color RGBA válido',
+    validation_format_DateISO8601: 'Debe ser una fecha válida con formato ISO8601',
+    validation_format_DirPath: 'Debe ser una ruta de directorio válida',
+    validation_format_DomainName: 'Debe ser un nombre de dominio válido',
+    validation_format_Email: 'Debe ser una dirección de correo válida',
+    validation_format_FilePath: 'Debe ser una ruta de archivo válida',
+    validation_format_GitSSHURL: 'Debe ser una URL SSH de Git válida',
+    validation_format_IPv4: 'Debe ser una dirección IPv4 válida',
+    validation_format_IPv6: 'Debe ser una dirección IPv6 válida',
+    validation_format_JSON: 'Debe ser una cadena JSON válida',
+    validation_format_JWT: 'Debe ser un JWT válido',
+    validation_format_PersonFirstname: 'Debe ser un nombre válido comenzando con mayúscula',
+    validation_format_PersonFullname: 'Debe ser un nombre completo válido comenzando con mayúscula',
+    validation_format_PersonInitials: 'Debe contener iniciales válidas compuestas por letras mayúsculas',
+    validation_format_PersonLastname: 'Debe ser un apellido válido comenzando con mayúscula',
+    validation_format_QRCode: 'Debe ser un código QR válido en formato base64',
+    validation_format_SemVerVersion: 'Debe ser una versión SemVer válida (X.X.X)',
+    validation_format_Slug: 'Debe contener solo letras minúsculas, dígitos y guiones (-)',
+    validation_format_SSHPrivateKey: 'Debe ser una clave privada SSH válida',
+    validation_format_SSHPublicKey: 'Debe ser una clave pública SSH válida',
+    validation_format_Time: 'Debe ser una hora válida',
+    validation_format_URL: 'Debe ser una URL válida',
+    validation_format_UUID: 'Debe ser un UUID válido',
+    validation_mandatory: 'Debe completarse',
+    validation_max: 'Debe ser menor o igual que {{expected}}',
+    validation_maxCount: 'Debe contener como máximo {{expected}} elemento(s)',
+    validation_maxLength: 'Debe contener como máximo {{expected}} carácter(es)',
+    validation_maxSize: 'Debe tener un tamaño máximo de {{expected}}',
+    validation_min: 'Debe ser mayor o igual que {{expected}}',
+    validation_minCount: 'Debe contener al menos {{expected}} elemento(s)',
+    validation_minLength: 'Debe contener al menos {{expected}} carácter(es)',
+    validation_minSize: 'Debe tener un tamaño mínimo de {{expected}}',
+    validation_oneOf: 'Debe ser uno de los elementos de la lista',
+    validation_shape: 'Debe respetar la estructura esperada del objeto',
+    validation_type_array: 'Debe ser un array',
+    validation_type_boolean: 'Debe ser un valor booleano',
+    validation_type_int: 'Debe ser un número entero',
+    validation_type_number: 'Debe ser un número',
+    validation_type_object: 'Debe ser un objeto',
+    validation_type_scalar: 'Debe ser un escalar',
+    validation_type_string: 'Debe ser una cadena',
+};

package/dist/esm/i18n/locales/fr.js

@@ -1,4 +1,10 @@
 export const I18nFR = {
+    dt_File_constr_accept: 'Types acceptés : {{expected}}',
+    dt_File_constr_maxSizeInBytes: 'Taille max : {{expected}}',
+    dt_File_constr_minSizeInBytes: 'Taille min : {{expected}}',
+    dt_FreeTextShort_constr_format: 'Format : {{expected}}',
+    dt_FreeTextShort_constr_maxLength: 'Longueur max : {{expected}}',
+    dt_FreeTextShort_constr_minLength: 'Longueur min : {{expected}}',
     dt_YesNo_N_desc: '',
     dt_YesNo_N_label: 'Non',
     dt_YesNo_Y_desc: '',
@@ -39,9 +45,11 @@ export const I18nFR = {
     validation_max: 'Doit être inférieur ou égal à {{expected}}',
     validation_maxCount: 'Doit contenir au maximim {{expected}} élément(s)',
     validation_maxLength: 'Doit contenir au maximum {{expected}} caractère(s)',
+    validation_maxSize: 'Doit avoir une taille maximum de {{expected}}',
     validation_min: 'Doit être supérieur ou égal à {{expected}}',
     validation_minCount: 'Doit contenir au minimum {{expected}} élément(s)',
     validation_minLength: 'Doit contenir au minimum {{expected}} caractère(s)',
+    validation_minSize: 'Doit avoir une taille minimum de {{expected}}',
     validation_oneOf: 'Doit être un des éléments de la liste',
     validation_shape: "Doit respecter la forme de l'objet attendue",
     validation_type_array: 'Doît être un tableau',

package/dist/esm/i18n/types.d.ts

@@ -1,6 +1,6 @@
-import type { ViolationI18nable, YesNo } from '../dt/index.js';
+import type { TFileConstraints, TStringConstraints, ViolationI18nable, YesNo } from '../dt/index.js';
 import type { UCClientConfirmConfig, UCExecState, UCWording } from '../uc/index.js';
-export type I18nLanguageCode = 'en' | 'fr';
+export type I18nLanguageCode = 'de' | 'en' | 'es' | 'fr';
 /**
  * A translation value
  *
@@ -8,12 +8,13 @@ export type I18nLanguageCode = 'en' | 'fr';
  */
 export type I18nTranslation = string;
 export type I18nTranslationKey = string;
-export type I18nCoreKey = ViolationI18nable | `dt_YesNo_${YesNo}_${keyof UCWording}` | `uc_client_confirm_${keyof UCClientConfirmConfig}` | `uc_i_submit_${UCExecState}`;
+export type I18nCoreKey = ViolationI18nable | `dt_FreeTextShort_constr_${keyof TStringConstraints}` | `dt_File_constr_${keyof TFileConstraints}` | `dt_YesNo_${YesNo}_${keyof UCWording}` | `uc_client_confirm_${keyof UCClientConfirmConfig}` | `uc_i_submit_${UCExecState}`;
 export type I18nCoreTranslations = Record<I18nCoreKey, I18nTranslation>;
 export type I18nSource = any;
 export type I18nSourceSafe = {
     I18n: I18n;
 };
+export type I18nEntry = Record<I18nTranslationKey, I18nTranslation>;
 export type I18n = {
-    [key in I18nLanguageCode]?: Record<I18nTranslationKey, I18nTranslation>;
+    [key in I18nLanguageCode]?: I18nEntry;
 };

package/dist/esm/index.babel.d.ts

@@ -0,0 +1 @@
+export { Plugin } from './utils/bundling/babel/plugin.js';

package/dist/esm/index.babel.js

@@ -0,0 +1 @@
+export { Plugin } from './utils/bundling/babel/plugin.js';

package/dist/esm/index.node-stricli-cli.d.ts

@@ -0,0 +1,2 @@
+export { NodeStricliCLIManager } from './target/node-stricli-cli/NodeStricliCLIManager.js';
+export { bindNodeCLI } from './utils/ioc/bindNodeCLI.js';

package/dist/esm/index.node-stricli-cli.js

@@ -0,0 +1,2 @@
+export { NodeStricliCLIManager } from './target/node-stricli-cli/NodeStricliCLIManager.js';
+export { bindNodeCLI } from './utils/ioc/bindNodeCLI.js';

package/dist/esm/index.vite.d.ts

@@ -1 +1 @@
-export { StripUCDLifecycleServerPlugin } from './utils/bundling/vite/StripUCDLifecycleServerPlugin.js';
+export { Plugin } from './utils/bundling/vite/plugin.js';

package/dist/esm/index.vite.js

@@ -1 +1 @@
-export { StripUCDLifecycleServerPlugin } from './utils/bundling/vite/StripUCDLifecycleServerPlugin.js';
+export { Plugin } from './utils/bundling/vite/plugin.js';

package/dist/esm/index.webpack.d.ts

@@ -0,0 +1 @@
+export { default } from './utils/bundling/webpack/loader.js';

package/dist/esm/index.webpack.js

@@ -0,0 +1 @@
+export { default } from './utils/bundling/webpack/loader.js';

package/dist/esm/std/FSManager.d.ts

@@ -1,4 +1,5 @@
 import type { DateISO8601, DirPath, File, FileExtension, FileMimeType, FileName, FilePath, UIntQuantity } from '../dt/index.js';
+import type { EnumOf } from '../utils/index.js';
 export type FSManagerChmodMode = number | string;
 export interface FSManagerCatOpts {
     encoding?: FSManagerEncoding;
@@ -9,11 +10,12 @@ export interface FSManagerFilePickerOpts {
     path?: FilePath;
 }
 export type FSManagerFilePickerSource = 'camera' | 'library' | 'path';
-export declare enum FSManagerItemInfoType {
-    DIR = "DIR",
-    FILE = "FILE",
-    OTHER = "OTHER"
-}
+export declare const FSManagerItemInfoType: {
+    readonly DIR: "DIR";
+    readonly FILE: "FILE";
+    readonly OTHER: "OTHER";
+};
+export type FSManagerItemInfoType = EnumOf<typeof FSManagerItemInfoType>;
 export interface FSManagerItemInfo {
     base: string;
     birthtime: DateISO8601;

package/dist/esm/std/FSManager.js

@@ -1,6 +1,5 @@
-export var FSManagerItemInfoType;
-(function (FSManagerItemInfoType) {
-    FSManagerItemInfoType["DIR"] = "DIR";
-    FSManagerItemInfoType["FILE"] = "FILE";
-    FSManagerItemInfoType["OTHER"] = "OTHER";
-})(FSManagerItemInfoType || (FSManagerItemInfoType = {}));
+export const FSManagerItemInfoType = {
+    DIR: 'DIR',
+    FILE: 'FILE',
+    OTHER: 'OTHER',
+};

package/dist/esm/std/FormDataBuilder.d.ts

@@ -1,5 +1,6 @@
-import type { FileMimeType, FilePath } from '../dt/index.js';
+import type { FileMimeType, FileName, FilePath } from '../dt/index.js';
 export interface BlobLike {
+    name: FileName;
     type: FileMimeType;
     uri: FilePath;
 }

package/dist/esm/std/I18nManager.d.ts

@@ -16,6 +16,18 @@ export interface I18nManager extends Initializable {
      * @param value
      */
     add<K extends I18nTranslationKey>(key: K, value: string): Promise<void>;
+    /**
+     * Get the list of available languages
+     */
+    availableLangs(): I18nLanguageCode[];
+    /**
+     * Change the current language
+     *
+     * It might not work for all the implementations, depending on how langs are managed.
+     *
+     * @param lang
+     */
+    changeLang(lang: I18nLanguageCode): Promise<void>;
     /**
      * Get the current lang code
      */

package/dist/esm/std/impl/NodeFSManager.js

@@ -94,15 +94,16 @@ let NodeFSManager = class NodeFSManager {
         }
         switch (source) {
             case 'path': {
-                const { base: name, mimeType: type } = await this.info(path);
+                const { base: name, mimeType: type, size, } = await this.info(path);
                 if (!type) {
                     return [];
                 }
                 return [
                     {
                         name,
-                        path,
+                        size,
                         type,
+                        uri: path,
                     },
                 ];
             }
@@ -110,7 +111,7 @@ let NodeFSManager = class NodeFSManager {
             case 'library':
                 return [];
             default:
-                ((_) => { })(source);
+                source;
                 return [];
         }
     }

package/dist/esm/std/impl/SimpleMapI18nManager.d.ts

@@ -1,18 +1,23 @@
-import { type I18n, type I18nLanguageCode, type I18nTranslationKey } from '../../i18n/index.js';
+import type { I18n, I18nLanguageCode, I18nTranslationKey } from '../../i18n/index.js';
 import type { I18nManager, I18nManagerTOpts } from '../I18nManager.js';
 import type { Logger } from '../Logger.js';
 export declare class SimpleMapI18nManager implements I18nManager {
     private i18n;
     private logger;
     private static PLACEHOLDERS_REGEX;
+    private langs;
     private entries;
+    private currentLang;
     constructor(i18n: I18n, logger: Logger);
     add<K extends I18nTranslationKey>(key: K, value: string): Promise<void>;
+    availableLangs(): I18nLanguageCode[];
+    changeLang(lang: I18nLanguageCode): Promise<void>;
     init(): Promise<void>;
     initSync(): void;
     l(): I18nLanguageCode;
     t<K extends I18nTranslationKey>(key: K, opts?: I18nManagerTOpts): string;
     private initCommon;
     tOrNull<K extends I18nTranslationKey>(key: K, _opts?: I18nManagerTOpts): string | null;
+    private current;
     private replacePlaceholders;
 }

package/dist/esm/std/impl/SimpleMapI18nManager.js

@@ -12,20 +12,34 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 var SimpleMapI18nManager_1;
 import { inject, injectable } from 'inversify';
-import { I18N_DEFAULT_LANG, } from '../../i18n/index.js';
 let SimpleMapI18nManager = class SimpleMapI18nManager {
     static { SimpleMapI18nManager_1 = this; }
     i18n;
     logger;
     static PLACEHOLDERS_REGEX = /{{([A-Z-a-z0-9]+)}}/g; // Note the 'g' so it can be used with `matchAll`
+    langs;
     entries;
+    currentLang;
     constructor(i18n, logger) {
         this.i18n = i18n;
         this.logger = logger;
+        this.langs = Object.keys(i18n);
+        if (this.langs.length === 0) {
+            throw new Error('I18n must define at least one lang');
+        }
         this.entries = new Map();
+        // biome-ignore lint/style/noNonNullAssertion: we want it
+        this.currentLang = this.langs[0];
     }
     async add(key, value) {
-        this.entries.set(key, value);
+        this.current().set(key, value);
+    }
+    availableLangs() {
+        return this.langs;
+    }
+    async changeLang(lang) {
+        this.currentLang = lang;
+        this.initCommon();
     }
     async init() {
         this.initCommon();
@@ -34,10 +48,10 @@ let SimpleMapI18nManager = class SimpleMapI18nManager {
         this.initCommon();
     }
     l() {
-        return I18N_DEFAULT_LANG;
+        return this.currentLang;
     }
     t(key, opts) {
-        const v = this.entries.get(key);
+        const v = this.current().get(key);
         if (v) {
             return this.replacePlaceholders(v, opts);
         }
@@ -47,17 +61,32 @@ let SimpleMapI18nManager = class SimpleMapI18nManager {
         return key; // Mimic the behavior of some common libraries like i18next
     }
     initCommon() {
-        const translations = this.i18n[this.l()];
-        this.logger.trace('Initializing I18nManager', { translations });
-        if (!translations) {
-            return;
-        }
-        for (const [k, v] of Object.entries(translations)) {
-            this.entries.set(k, v);
+        for (const lang of this.langs) {
+            const translations = this.i18n[lang];
+            this.logger.trace('Initializing I18nManager', {
+                lang,
+                translations,
+            });
+            if (!translations) {
+                return;
+            }
+            if (!this.entries.has(lang)) {
+                this.entries.set(lang, new Map());
+            }
+            for (const [k, v] of Object.entries(translations)) {
+                this.entries.get(lang)?.set(k, v);
+            }
         }
     }
     tOrNull(key, _opts) {
-        return this.entries.get(key) || null;
+        return this.current().get(key) || null;
+    }
+    current() {
+        const entry = this.entries.get(this.currentLang);
+        if (!entry) {
+            throw new Error(`I18nManager must contain an entry for lang : ${this.currentLang}`);
+        }
+        return entry;
     }
     replacePlaceholders(v, opts) {
         // DO NOT USE THIS IN PRODUCTION

package/dist/esm/target/lib/react/StyleContextProvider.d.ts

@@ -18,6 +18,7 @@ export interface StyleContextT {
     formField?: StyleDef | undefined;
     formFieldControl?: Record<SelectiveStyleDefKey, StyleDef | undefined>;
     formFieldDesc?: StyleDef | undefined;
+    formFieldHelp?: StyleDef | undefined;
     formFieldErr?: StyleDef | undefined;
     formFieldLabel?: StyleDef | undefined;
     formSubmitControl?: StyleDef | undefined;

package/dist/esm/target/lib/react/form.d.ts

@@ -18,7 +18,7 @@ export interface UCFormFieldErrProps {
 export interface UCFormFieldLabelProps<T extends DataType> {
     f: UCInputField<T>;
 }
-export declare const UC_FORM_FIELD_ELEMENTS: readonly ["control", "desc", "err", "label"];
+export declare const UC_FORM_FIELD_ELEMENTS: readonly ["control", "desc", "err", "help", "label"];
 export type UCFormFieldElement = (typeof UC_FORM_FIELD_ELEMENTS)[number];
 export type UCFormFieldProps<T extends DataType> = Omit<UCFormFieldControlProps<T>, 'onChange'> & {
     only?: UCFormFieldElement[];

package/dist/esm/target/lib/react/form.js

@@ -3,6 +3,7 @@ export const UC_FORM_FIELD_ELEMENTS = [
     'control',
     'desc',
     'err',
+    'help',
     'label',
 ];
 export function validateFormField(i18nManager, f) {

package/dist/esm/target/lib/react/useAction.d.ts

@@ -1,5 +1,5 @@
 import type { ErrorMessage, UIntDuration } from '../../../dt/index.js';
-import type { UCExecRes, UCExecState } from '../../../uc/index.js';
+import { UCExecRes, UCExecState } from '../../../uc/index.js';
 export type UseActionAction = () => Promise<void>;
 export type UseActionConfirm = () => Promise<boolean>;
 export type UseActionExec = () => Promise<UCExecRes>;