libmodulor 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # CHANGELOG
 
+## v0.25.0 (2025-12-21)
+
+**Highlights**
+
+- Added use case summary in the auto-generated app docs : In addition to the existing mermaid diagram, there is now a summary of the lifecyle, input and output in a dedicated table
+    - Example : https://github.com/c100k/libmodulor/tree/42fd11307cdd9f8cdec19b4de75d4959bc9f9a9e/examples/apps/Spotify#createalbum
+- Improved the `File` data type
+    - Changed the property `path` to `uri` to conform to the `FormData` spec (this is a breaking change)
+    - Simplified the declaration by inlining the accepted types via `accept` instead of `type.allowed` (this is also a breaking change)
+    - Added `maxSizeInBytes` and `minSizeInBytes` for size validation
+- Added `getConstraintsForHuman` to format constraints for the end user in the targets. For instance :
+    - For `FreeTextShort`, it displays `Max length: 150` 🇬🇧 when present
+    - For `File`, it displays `Max size: 8MB - Accepted types: application/png, application/jpg` 🇬🇧 when present
+    - Applied to the `react-native-pure` and `react-native-web` targets (see `UCFormFieldHelp.tsx`)
+
+See all the changes here : https://github.com/c100k/libmodulor/compare/v0.24.0...master
+
 ## v0.24.0 (2025-12-07)
 
 **Highlights**

package/README.md

@@ -169,4 +169,4 @@ If you think you can help in any way, feel free to contact me (cf. `author` in `
 
 ## ⚖️ License
 
-[LGPL-3.0](https://github.com/c100k/libmodulor/blob/v0.24.0/LICENSE)
+[LGPL-3.0](https://github.com/c100k/libmodulor/blob/v0.25.0/LICENSE)

package/dist/esm/apps/Helper/src/lib/project.js

@@ -81,21 +81,21 @@ export const PACKAGE_JSON = (name) => `{
         "test": "tsc && vitest run --passWithNoTests"
     },
     "dependencies": {
-        "inversify": "^7.10.4",
+        "inversify": "^7.10.7",
         "libmodulor": "latest",
         "reflect-metadata": "^0.2.2"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.3.8",
-        "@types/node": "^24.10.1",
+        "@biomejs/biome": "^2.3.10",
+        "@types/node": "^25.0.3",
         "@vitest/coverage-v8": "^3.2.4",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
-        "express": "^5.1.0",
+        "express": "^5.2.1",
         "express-fileupload": "^1.5.2",
-        "fast-check": "^4.3.0",
+        "fast-check": "^4.4.0",
         "helmet": "^8.1.0",
-        "jose": "^6.1.2",
+        "jose": "^6.1.3",
         "typescript": "^5.9.3",
         "vite": "^6.4.1",
         "vitest": "^3.2.4"

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

@@ -1,13 +1,13 @@
 import type { I18nTranslation } from '../i18n/index.js';
 import type { NumIndex } from './final/TNumIndex.js';
-type ViolationConstraint = 'fieldsOr' | 'format' | 'mandatory' | 'max' | 'maxCount' | 'maxLength' | 'min' | 'minCount' | 'minLength' | 'oneOf' | 'shape' | 'type';
+type ViolationConstraint = 'fieldsOr' | 'format' | 'mandatory' | 'max' | 'maxCount' | 'maxLength' | 'maxSize' | 'min' | 'minCount' | 'minLength' | 'minSize' | 'oneOf' | 'shape' | 'type';
 type ViolationBase<C extends ViolationConstraint, EV> = {
     constraint: C;
     expected: EV;
 };
 export type ViolationFormat = 'ColorRGBA' | 'DateISO8601' | 'DirPath' | 'DomainName' | 'Email' | 'FilePath' | 'GitSSHURL' | 'IPv4' | 'IPv6' | 'JSON' | 'JWT' | 'PersonFirstname' | 'PersonFullname' | 'PersonInitials' | 'PersonLastname' | 'QRCode' | 'SemVerVersion' | 'Slug' | 'SSHPrivateKey' | 'SSHPublicKey' | 'Time' | 'URL' | 'UUID';
 export type ViolationType = 'array' | 'boolean' | 'int' | 'number' | 'object' | 'scalar' | 'string';
-export type Violation<T = unknown> = ViolationBase<'fieldsOr', string> | ViolationBase<'format', ViolationFormat> | ViolationBase<'format', string> | ViolationBase<'mandatory', undefined> | ViolationBase<'max', number> | ViolationBase<'maxCount', number> | ViolationBase<'maxLength', number> | ViolationBase<'min', number> | ViolationBase<'minCount', number> | ViolationBase<'minLength', number> | ViolationBase<'oneOf', T[]> | ViolationBase<'shape', object> | ViolationBase<'type', ViolationType>;
+export type Violation<T = unknown> = ViolationBase<'fieldsOr', string> | ViolationBase<'format', ViolationFormat> | ViolationBase<'format', string> | ViolationBase<'mandatory', undefined> | ViolationBase<'max', number> | ViolationBase<'maxCount', number> | ViolationBase<'maxLength', number> | ViolationBase<'maxSize', string> | ViolationBase<'min', number> | ViolationBase<'minCount', number> | ViolationBase<'minLength', number> | ViolationBase<'minSize', string> | ViolationBase<'oneOf', T[]> | ViolationBase<'shape', object> | ViolationBase<'type', ViolationType>;
 type ViolationI18nableSimple = Exclude<ViolationConstraint, 'format' | 'type'>;
 export type ViolationI18nable = `validation_${ViolationI18nableSimple}` | `validation_format_${ViolationFormat}` | `validation_type_${ViolationType}`;
 export type ViolationI18n = Record<ViolationI18nable, I18nTranslation>;

package/dist/esm/dt/base/TBase.d.ts

@@ -26,6 +26,7 @@ export interface OptionsOpts {
     shouldTranslateLabels?: boolean;
     strict?: boolean;
 }
+export type ConstraintsForHuman = Record<string, string>;
 export declare abstract class TBase<T extends DataType> {
     static DEFAULT_OPTIONS: Required<OptionsOpts>;
     protected defaultValue: T | undefined;
@@ -44,6 +45,7 @@ export declare abstract class TBase<T extends DataType> {
     fmt(ifNullOrUndefined?: string): string;
     getDefaultValue(): T | undefined;
     getExamples(): T[] | undefined;
+    getConstraintsForHuman(): ConstraintsForHuman | null;
     getInitialValue(): T | undefined;
     getOptions(): Option<T>[] | undefined;
     getSemanticsMapping(): SemanticsMapping | undefined;

package/dist/esm/dt/base/TBase.js

@@ -39,6 +39,9 @@ export class TBase {
     getExamples() {
         return this.examples;
     }
+    getConstraintsForHuman() {
+        return null;
+    }
     getInitialValue() {
         return this.initialValue;
     }

package/dist/esm/dt/base/TObject.d.ts

@@ -1,6 +1,7 @@
+import type { EnumOf } from '../../utils/index.js';
 import type { Validation } from '../Validation.js';
 import { TBase, type TName } from './TBase.js';
-export declare enum TObjectShapeValidationStrategy {
+export declare const TObjectShapeValidationStrategy: {
     /**
      * No shape validation is performed
      *
@@ -8,14 +9,15 @@ export declare enum TObjectShapeValidationStrategy {
      *
      * Otherwise, you can still override {@link validate} in the `T*` class and do your own validation.
      */
-    NONE = "NONE",
+    readonly NONE: "NONE";
     /**
      * Validate against the {@link TObject.example()}
      *
      * It checks that the keys of the value, sorted alphabetically, are the same as the example's keys.
      */
-    SAME_AS_EXAMPLE = "SAME_AS_EXAMPLE"
-}
+    readonly SAME_AS_EXAMPLE: "SAME_AS_EXAMPLE";
+};
+export type TObjectShapeValidationStrategy = EnumOf<typeof TObjectShapeValidationStrategy>;
 export interface TObjectConstraints {
     /**
      * @defaultValue {@link TObjectShapeValidationStrategy.SAME_AS_EXAMPLE}

package/dist/esm/dt/base/TObject.js

@@ -1,6 +1,5 @@
 import { TBase } from './TBase.js';
-export var TObjectShapeValidationStrategy;
-(function (TObjectShapeValidationStrategy) {
+export const TObjectShapeValidationStrategy = {
     /**
      * No shape validation is performed
      *
@@ -8,14 +7,14 @@ export var TObjectShapeValidationStrategy;
      *
      * Otherwise, you can still override {@link validate} in the `T*` class and do your own validation.
      */
-    TObjectShapeValidationStrategy["NONE"] = "NONE";
+    NONE: 'NONE',
     /**
      * Validate against the {@link TObject.example()}
      *
      * It checks that the keys of the value, sorted alphabetically, are the same as the example's keys.
      */
-    TObjectShapeValidationStrategy["SAME_AS_EXAMPLE"] = "SAME_AS_EXAMPLE";
-})(TObjectShapeValidationStrategy || (TObjectShapeValidationStrategy = {}));
+    SAME_AS_EXAMPLE: 'SAME_AS_EXAMPLE',
+};
 export class TObject extends TBase {
     constraints;
     constructor(constraints = {

package/dist/esm/dt/base/TString.d.ts

@@ -1,5 +1,5 @@
 import type { Validation, ViolationFormat } from '../Validation.js';
-import { TBase, type TName } from './TBase.js';
+import { type ConstraintsForHuman, TBase, type TName } from './TBase.js';
 export interface TStringConstraints<VF extends ViolationFormat | (string & {}) = ViolationFormat> {
     format?: {
         f: VF;
@@ -15,6 +15,7 @@ export declare class TString<T extends string = string, VF extends ViolationForm
     constructor(constraints?: TStringConstraints<VF> | undefined);
     tName(): TName;
     example(): T;
+    getConstraintsForHuman(): ConstraintsForHuman | null;
     getConstraints(): TStringConstraints<VF> | undefined;
     isPotentiallyLong(): boolean;
     protected removeFormatConstraint(): void;

package/dist/esm/dt/base/TString.js

@@ -13,6 +13,28 @@ export class TString extends TBase {
     example() {
         return 'Miami';
     }
+    getConstraintsForHuman() {
+        if (!this.constraints) {
+            return null;
+        }
+        const c = {};
+        const { format, maxLength, minLength } = this.constraints;
+        if (minLength) {
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['minLength'] = minLength.toString();
+        }
+        if (maxLength) {
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['maxLength'] = maxLength.toString();
+        }
+        if (format) {
+            // Are regexes really "human" ?
+            // TODO : Find a more human way of displaying regexes
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['format'] = format.regexp.toString();
+        }
+        return c;
+    }
     getConstraints() {
         return this.constraints;
     }

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

@@ -1,23 +1,32 @@
-import type { TName } from '../base/TBase.js';
+import type { ConstraintsForHuman, TName } from '../base/TBase.js';
 import { TObject } from '../base/TObject.js';
 import type { HTMLInputType } from '../targets/web.js';
 import type { Validation } from '../Validation.js';
-import { type FileMimeType, type TFileMimeTypeConstraints } from './TFileMimeType.js';
+import { type FileMimeType } from './TFileMimeType.js';
 import { type FileName } from './TFileName.js';
 import { type FilePath } from './TFilePath.js';
+import type { UIntQuantity } from './TUIntQuantity.js';
 export type File = {
     name: FileName;
-    path: FilePath;
+    size: UIntQuantity;
     type: FileMimeType;
+    uri: FilePath;
 };
 export interface TFileConstraints {
-    type: TFileMimeTypeConstraints;
+    accept: FileMimeType[];
+    maxSizeInBytes?: UIntQuantity;
+    minSizeInBytes?: UIntQuantity;
 }
 export declare class TFile extends TObject<File> {
     protected fileConstraints: TFileConstraints;
+    static readonly UNITS: string[];
     constructor(fileConstraints: TFileConstraints);
     tName(): TName;
     example(): File;
+    getConstraintsForHuman(): ConstraintsForHuman | null;
     htmlInputType(): HTMLInputType;
     validate(): Validation;
+    getFileConstraints(): TFileConstraints;
+    fmtBytes(bytes: number, decimals?: number): string;
+    withOneExample(name: File['name']): this;
 }

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

@@ -1,9 +1,21 @@
 import { TObject, TObjectShapeValidationStrategy } from '../base/TObject.js';
-import { TFileMimeType, } from './TFileMimeType.js';
+import { TFileMimeType } from './TFileMimeType.js';
 import { TFileName } from './TFileName.js';
 import { TFilePath } from './TFilePath.js';
 export class TFile extends TObject {
     fileConstraints;
+    // We consider them generic enough to not having to be translated
+    static UNITS = [
+        'B',
+        'KB',
+        'MB',
+        'GB',
+        'TB',
+        'PB',
+        'EB',
+        'ZB',
+        'YB',
+    ];
     constructor(fileConstraints) {
         super({
             // We usually process instances of https://developer.mozilla.org/fr/docs/Web/API/File
@@ -17,11 +29,27 @@ export class TFile extends TObject {
     }
     example() {
         return {
-            name: 'picture.png',
-            path: '/Users/dexter/Desktop/picture.png',
-            type: 'image/png',
+            name: TFilePath.FILE_NAME,
+            size: TFilePath.FILE_SIZE,
+            type: TFilePath.MIME_TYPE,
+            uri: `${TFilePath.ABS_PATH}/${TFilePath.FILE_NAME}`,
         };
     }
+    getConstraintsForHuman() {
+        const c = {};
+        const { accept, maxSizeInBytes, minSizeInBytes } = this.fileConstraints;
+        if (minSizeInBytes) {
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['minSizeInBytes'] = this.fmtBytes(minSizeInBytes);
+        }
+        if (maxSizeInBytes) {
+            // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+            c['maxSizeInBytes'] = this.fmtBytes(maxSizeInBytes);
+        }
+        // biome-ignore lint/complexity/useLiteralKeys: typescript disagrees
+        c['accept'] = accept.join(', ');
+        return c;
+    }
     htmlInputType() {
         return 'file';
     }
@@ -32,13 +60,47 @@ export class TFile extends TObject {
         }
         const val = this.raw;
         validation.concat(new TFileName().assign(val.name).validate());
+        const { accept, maxSizeInBytes, minSizeInBytes } = this.fileConstraints;
+        const { size, type, uri } = val;
         if (!(val instanceof File)) {
-            validation.concat(new TFilePath().assign(val.path).validate());
+            validation.concat(new TFilePath().assign(uri).validate());
         }
-        validation.concat(new TFileMimeType(this.fileConstraints.type)
-            .assign(val.type)
+        validation.concat(new TFileMimeType()
+            .setOptions(accept.map((a) => ({ label: a, value: a })))
+            .assign(type)
             .validate());
-        // TODO : Add validation on file size
+        if (minSizeInBytes && size < minSizeInBytes) {
+            validation.add({
+                constraint: 'minSize',
+                expected: this.fmtBytes(minSizeInBytes),
+            });
+        }
+        if (maxSizeInBytes && size > maxSizeInBytes) {
+            validation.add({
+                constraint: 'maxSize',
+                expected: this.fmtBytes(maxSizeInBytes),
+            });
+        }
         return validation;
     }
+    getFileConstraints() {
+        return this.fileConstraints;
+    }
+    fmtBytes(bytes, decimals = 2) {
+        const k = 1024;
+        const dm = decimals < 0 ? 0 : decimals;
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return `${Number.parseFloat((bytes / k ** i).toFixed(dm))} ${TFile.UNITS[i]}`;
+    }
+    withOneExample(name) {
+        this.setExamples([
+            {
+                name,
+                size: TFilePath.FILE_SIZE,
+                type: this.fileConstraints.accept[0] ?? TFilePath.MIME_TYPE,
+                uri: `${TFilePath.ABS_PATH}/${name}`,
+            },
+        ]);
+        return this;
+    }
 }

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

@@ -3,7 +3,7 @@ import { TString, type TStringConstraints } from '../base/TString.js';
 type ImageExtension = 'gif' | 'heic' | 'jpg' | 'png';
 type VideoExtension = 'mov' | 'mp4';
 type XMLExtension = 'gpx' | 'xml';
-export type FileExtension = ImageExtension | VideoExtension | XMLExtension;
+export type FileExtension = ImageExtension | VideoExtension | XMLExtension | (string & {});
 export interface TFileExtensionConstraints extends TStringConstraints {
     allowed: FileExtension[];
 }

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

@@ -1,11 +1,7 @@
 import type { TName } from '../base/TBase.js';
-import { TString, type TStringConstraints } from '../base/TString.js';
-export type FileMimeType = 'text/plain' | 'audio/aac' | 'application/x-abiword' | 'application/octet-stream' | 'video/x-msvideo' | 'application/vnd.amazon.ebook' | 'image/bmp' | 'application/x-bzip' | 'application/x-bzip2' | 'application/x-csh' | 'text/css' | 'text/csv' | 'application/msword' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.ms-fontobject' | 'application/epub+zip' | 'image/gif' | 'text/html' | 'image/x-icon' | 'text/calendar' | 'application/java-archive' | 'image/jpeg' | 'image/jpg' | 'application/javascript' | 'application/json' | 'audio/midi' | 'video/mpeg' | 'application/vnd.apple.installer+xml' | 'application/vnd.oasis.opendocument.presentation' | 'application/vnd.oasis.opendocument.spreadsheet' | 'application/vnd.oasis.opendocument.text' | 'audio/ogg' | 'video/ogg' | 'application/ogg' | 'font/otf' | 'image/png' | 'application/pdf' | 'application/vnd.ms-powerpoint' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/x-rar-compressed' | 'application/rtf' | 'application/x-sh' | 'image/svg+xml' | 'application/x-shockwave-flash' | 'application/x-tar' | 'image/tiff' | 'application/typescript' | 'font/ttf' | 'application/vnd.visio' | 'audio/x-wav' | 'audio/webm' | 'video/webm' | 'image/webp' | 'font/woff' | 'font/woff2' | 'application/xhtml+xml' | 'application/vnd.ms-excel' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/xml' | 'application/vnd.mozilla.xul+xml' | 'application/zip' | 'video/3gpp audio/3gpp' | 'video/3gpp2 audio/3gpp2' | 'application/x-7z-compressed';
-export interface TFileMimeTypeConstraints extends TStringConstraints {
-    allowed: FileMimeType[];
-}
+import { TString } from '../base/TString.js';
+export type FileMimeType = 'text/plain' | 'audio/aac' | 'application/x-abiword' | 'application/octet-stream' | 'video/x-msvideo' | 'application/vnd.amazon.ebook' | 'image/bmp' | 'application/x-bzip' | 'application/x-bzip2' | 'application/x-csh' | 'text/css' | 'text/csv' | 'application/msword' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.ms-fontobject' | 'application/epub+zip' | 'image/gif' | 'text/html' | 'image/x-icon' | 'text/calendar' | 'application/java-archive' | 'image/jpeg' | 'image/jpg' | 'application/javascript' | 'application/json' | 'audio/midi' | 'video/mpeg' | 'application/vnd.apple.installer+xml' | 'application/vnd.oasis.opendocument.presentation' | 'application/vnd.oasis.opendocument.spreadsheet' | 'application/vnd.oasis.opendocument.text' | 'audio/ogg' | 'video/ogg' | 'application/ogg' | 'font/otf' | 'image/png' | 'application/pdf' | 'application/vnd.ms-powerpoint' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/x-rar-compressed' | 'application/rtf' | 'application/x-sh' | 'image/svg+xml' | 'application/x-shockwave-flash' | 'application/x-tar' | 'image/tiff' | 'application/typescript' | 'font/ttf' | 'application/vnd.visio' | 'audio/x-wav' | 'audio/webm' | 'video/webm' | 'image/webp' | 'font/woff' | 'font/woff2' | 'application/xhtml+xml' | 'application/vnd.ms-excel' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/xml' | 'application/vnd.mozilla.xul+xml' | 'application/zip' | 'video/3gpp audio/3gpp' | 'video/3gpp2 audio/3gpp2' | 'application/x-7z-compressed' | (string & {});
 export declare class TFileMimeType extends TString<FileMimeType> {
-    constructor(constraints?: TFileMimeTypeConstraints);
     tName(): TName;
     example(): FileMimeType;
 }

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

@@ -1,11 +1,5 @@
 import { TString } from '../base/TString.js';
 export class TFileMimeType extends TString {
-    constructor(constraints) {
-        super(constraints);
-        if (constraints?.allowed) {
-            this.setOptions(constraints?.allowed.map((v) => ({ label: v, value: v })));
-        }
-    }
     tName() {
         return 'FileMimeType';
     }

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/locales/de.js

@@ -1,4 +1,10 @@
 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: '',
@@ -39,9 +45,11 @@ export const I18nDE = {
     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',

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.js

@@ -1,4 +1,10 @@
 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: '',
@@ -39,9 +45,11 @@ export const I18nES = {
     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',

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,4 +1,4 @@
-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 = 'de' | 'en' | 'es' | 'fr';
 /**
@@ -8,7 +8,7 @@ export type I18nLanguageCode = 'de' | 'en' | 'es' | '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 = {

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;