libmodulor 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # CHANGELOG
 
+## v0.21.0 (2025-08-19)
+
+**BREAKING**
+
+- Infer UC input field type without explicit generic when using `UC` methods like `inputField`, `reqVal0`, `rVal0`, `rValArr` : simply fix the TypeScript errors by removing the generic (e.g `uc.reqVal<DateISO8601>('from')` => `uc.reqVal('from')`)
+- Change `UCInputField.setValue` to `UCInputField.setVal`, `UCInputField.addVal`, `UCInputField.rmVal` : simply fix the TypeScript errors by replacing `setValue` to  the appropriate method. Also, `UCInputFieldChangeOperator` has been removed as it became useless. If you created custom `UCForm` field controls, you need to call the appropriate method to set the value in the field.
+
+**Added**
+
+- Add overrides to `rVal0` to avoid non null assertion
+
+**Fixed**
+
+- Display expected falsy values in violation
+
+**Misc**
+
+- Expose `TGitSSHURLConstraints`
+
 ## v0.20.0 (2025-07-26)
 
 **Added**

package/README.md

@@ -17,4 +17,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.20.0/LICENSE)
+[LGPL-3.0](https://github.com/c100k/libmodulor/blob/v0.21.0/LICENSE)

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

@@ -81,13 +81,13 @@ export const PACKAGE_JSON = (name) => `{
         "test": "tsc && vitest run --passWithNoTests"
     },
     "dependencies": {
-        "inversify": "^7.6.1",
+        "inversify": "^7.8.1",
         "libmodulor": "latest",
         "reflect-metadata": "^0.2.2"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.1.2",
-        "@types/node": "^22.16.5",
+        "@biomejs/biome": "^2.2.0",
+        "@types/node": "^22.17.2",
         "@vitest/coverage-v8": "^3.2.4",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
@@ -96,7 +96,7 @@ export const PACKAGE_JSON = (name) => `{
         "fast-check": "^4.2.0",
         "helmet": "^8.1.0",
         "jose": "^6.0.12",
-        "typescript": "^5.8.3",
+        "typescript": "^5.9.2",
         "vite": "^6.3.5",
         "vitest": "^3.2.4"
     }

package/dist/esm/dt/Validation.js

@@ -15,7 +15,7 @@ export class Validation {
             return null;
         }
         const key = this.violationAsI18nable(violation);
-        const expected = (violation.expected || '').toString();
+        const expected = (violation.expected ?? '').toString();
         return [key, expected];
     }
     getViolations() {

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

@@ -1,11 +1,12 @@
 import type { TName } from '../base/TBase.js';
 import { TString, type TStringConstraints } from '../base/TString.js';
 export type GitSSHURL = string;
+export interface TGitSSHURLConstraints extends TStringConstraints<'GitSSHURL'> {
+    domainName?: string | undefined;
+}
 export declare class TGitSSHURL extends TString<GitSSHURL> {
     private static DEFAULT_DOMAIN_NAME;
-    constructor(constraints?: TStringConstraints & {
-        domainName: string;
-    });
+    constructor(constraints?: TGitSSHURLConstraints);
     tName(): TName;
     example(): GitSSHURL;
 }

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

@@ -2,7 +2,7 @@ import { TString } from '../base/TString.js';
 export class TGitSSHURL extends TString {
     static DEFAULT_DOMAIN_NAME = 'github.com';
     constructor(constraints) {
-        const format = new RegExp(`^git@${constraints?.domainName ?? TGitSSHURL.DEFAULT_DOMAIN_NAME}:([A-Za-z0-9-_]+)\/([A-Za-z0-9-_]+)\.git$`);
+        const format = new RegExp(`^git@${constraints?.domainName ?? TGitSSHURL.DEFAULT_DOMAIN_NAME}:([A-Za-z0-9-_]+)/([A-Za-z0-9-_]+).git$`);
         super({
             ...constraints,
             format: { f: 'GitSSHURL', regexp: format },

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

@@ -1,9 +1,7 @@
 import { TString } from '../base/TString.js';
 export const SSHPrivatekKeyTypes = ['OPENSSH', 'RSA'];
 export class TSSHPrivateKey extends TString {
-    static FORMAT = 
-    // @ts-ignore
-    /^-----BEGIN (OPENSSH|RSA) PRIVATE KEY-----\n(.+)?\n-----END (OPENSSH|RSA) PRIVATE KEY-----$/is;
+    static FORMAT = /^-----BEGIN (OPENSSH|RSA) PRIVATE KEY-----\n(.+)?\n-----END (OPENSSH|RSA) PRIVATE KEY-----$/is;
     constructor(constraints) {
         super({
             ...constraints,

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

@@ -68,8 +68,8 @@ let ConsoleLogger = class ConsoleLogger {
         console.warn(`${this.t()} [warn] ${message}`, ...meta);
     }
     shouldLog(level) {
-        const configLevelIndex = ConsoleLogger_1.LEVELS.findIndex((l) => l === this.s().logger_level);
-        const levelIndex = ConsoleLogger_1.LEVELS.findIndex((l) => l === level);
+        const configLevelIndex = ConsoleLogger_1.LEVELS.indexOf(this.s().logger_level);
+        const levelIndex = ConsoleLogger_1.LEVELS.indexOf(level);
         return levelIndex >= configLevelIndex;
     }
     t() {

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

@@ -17,7 +17,7 @@ import { injectable } from 'inversify';
 let FetchHTTPAPICallExecutor = class FetchHTTPAPICallExecutor {
     fn() {
         // The generalization in HTTPAPICallExecutor is not exactly the same as the actual implementation
-        // @ts-ignore
+        // @ts-expect-error
         return fetch;
     }
 };

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

@@ -19,7 +19,9 @@ let NodeFormDataBuilder = class NodeFormDataBuilder {
                     chunks.push(chunk);
                 });
                 rs.on('end', () => {
-                    fd.append(key, new Blob(chunks, { type: val.type }), basename(val.uri));
+                    fd.append(key, 
+                    // @ts-expect-error
+                    new Blob(chunks, { type: val.type }), basename(val.uri));
                     resolve(null);
                 });
                 rs.on('error', (err) => {

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

@@ -177,7 +177,7 @@ let SimpleHTTPAPICaller = class SimpleHTTPAPICaller {
                 payload = {};
                 // TODO : Find a better way to do this (without adding any external dependency because the code must be portable)
                 new URL(`http://localhost?${asText}`).searchParams.forEach((v, k) => {
-                    // @ts-ignore
+                    // @ts-expect-error
                     payload[k] = v;
                 });
             }

package/dist/esm/target/lib/cli/CommandExecutor.js

@@ -14,7 +14,7 @@ var CommandExecutor_1;
 import { inject, injectable } from 'inversify';
 import { WordingManager } from '../../../i18n/index.js';
 import { FSManagerItemInfoType, } from '../../../std/index.js';
-import { UCInputFieldChangeOperator, ucifMustBeFilledManually, } from '../../../uc/index.js';
+import { ucifMustBeFilledManually, } from '../../../uc/index.js';
 import { print, printError } from './renderer.js';
 let CommandExecutor = class CommandExecutor {
     static { CommandExecutor_1 = this; }
@@ -89,7 +89,7 @@ let CommandExecutor = class CommandExecutor {
             const invite = `${label}${help}`;
             await this.promptManager.prompt(invite, {
                 validate: async (v) => {
-                    f.setValue(UCInputFieldChangeOperator.SET, v);
+                    f.setVal(v);
                     const validation = f.validate();
                     const violation = validation.get();
                     if (!violation) {

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

@@ -27,9 +27,6 @@ export function UCPanel({ autoExec = false, clearAfterExec = true, onDone, onErr
         },
         sleepInMs,
     });
-    const onChange = (f, op, v) => {
-        f.setValue(op, v);
-    };
     const clear = () => {
         if (!clearAfterExec) {
             return;
@@ -46,7 +43,6 @@ export function UCPanel({ autoExec = false, clearAfterExec = true, onDone, onErr
     return (_jsxs(UCContainer, { uc: uc, children: [autoExec && ctx.disabled && renderAutoExecLoader(), !autoExec && (_jsxs(_Fragment, { children: [needsInputFilling &&
                         renderForm({
                             ...ctx,
-                            onChange,
                             onSubmit: exec,
                         }), !needsInputFilling &&
                         renderExecTouchable({

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

@@ -1,13 +1,13 @@
 import type { ReactElement } from 'react';
 import type { DataType, ErrorMessage } from '../../../dt/index.js';
 import type { I18nManager } from '../../../std/index.js';
-import type { UCInput, UCInputField, UCInputFieldChangeOperator, UCInputFieldValue, UCOPIBase } from '../../../uc/index.js';
+import type { UCInput, UCInputField, UCOPIBase } from '../../../uc/index.js';
 import type { UCPanelCtx, UCPanelOnSubmit, UCPanelState } from './panel.js';
-export type UCFormFieldControlOnChange<T extends DataType = DataType> = (f: UCInputField<T>, op: UCInputFieldChangeOperator, v: UCInputFieldValue<T>) => void;
+export type UCFormFieldControlOnChange = () => void;
 export type UCFormFieldControlProps<T extends DataType> = UCPanelState & {
     errMsg?: ErrorMessage | null;
     f: UCInputField<T>;
-    onChange: UCFormFieldControlOnChange<T>;
+    onChange: UCFormFieldControlOnChange;
 };
 export interface UCFormFieldDescProps<T extends DataType> {
     f: UCInputField<T>;
@@ -20,15 +20,14 @@ export interface UCFormFieldLabelProps<T extends DataType> {
 }
 export declare const UC_FORM_FIELD_ELEMENTS: readonly ["control", "desc", "err", "label"];
 export type UCFormFieldElement = (typeof UC_FORM_FIELD_ELEMENTS)[number];
-export type UCFormFieldProps<T extends DataType> = UCFormFieldControlProps<T> & {
+export type UCFormFieldProps<T extends DataType> = Omit<UCFormFieldControlProps<T>, 'onChange'> & {
     only?: UCFormFieldElement[];
 };
 export type UCFormProps<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> = UCPanelCtx<I, OPI0, OPI1> & {
-    onChange: UCFormFieldControlOnChange;
     onSubmit: UCPanelOnSubmit;
 };
 export type UCFormSubmitControlProps<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> = UCPanelCtx<I, OPI0, OPI1> & {
     onPress?: () => Promise<void>;
 };
 export type RenderUCForm<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> = (props: UCFormProps<I, OPI0, OPI1>) => ReactElement;
-export declare function validateFormField<T extends DataType = DataType>(i18nManager: I18nManager, f: UCInputField<T>, v: UCInputFieldValue<T>): ErrorMessage | null;
+export declare function validateFormField<T extends DataType = DataType>(i18nManager: I18nManager, f: UCInputField<T>): ErrorMessage | null;

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

@@ -5,18 +5,15 @@ export const UC_FORM_FIELD_ELEMENTS = [
     'err',
     'label',
 ];
-export function validateFormField(i18nManager, f, v) {
-    if (isBlank(v)) {
+export function validateFormField(i18nManager, f) {
+    if (isBlank(f.getValue())) {
         return null;
     }
-    const vArr = Array.isArray(v) ? v : [v];
-    for (const vv of vArr) {
-        const validation = f.def.type.assign(vv).validate();
-        const violation = validation.get();
-        if (violation) {
-            const [key, expected] = violation;
-            return i18nManager.t(key, { vars: { expected } });
-        }
+    const validation = f.validate();
+    const violation = validation.get();
+    if (violation) {
+        const [key, expected] = violation;
+        return i18nManager.t(key, { vars: { expected } });
     }
     return null;
 }

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

@@ -1,7 +1,7 @@
-import { type ArgsRecord, UC, type UCDef, type UCInput, type UCOPIBase } from '../../../uc/index.js';
-export type CloneFunc<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> = (i: Partial<I>) => UC<I, OPI0, OPI1>;
+import { type ArgsRecord, UC, type UCDef, type UCInput, type UCInputPartial, type UCOPIBase } from '../../../uc/index.js';
+export type CloneFunc<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined> = (i: UCInputPartial<I>) => UC<I, OPI0, OPI1>;
 export type DivertFunc<II extends UCInput | undefined = undefined, OOPI0 extends UCOPIBase | undefined = undefined, OOPI1 extends UCOPIBase | undefined = undefined> = (siblingUCD: UCDef) => UC<II, OOPI0, OOPI1>;
-export type RefillFunc<I extends UCInput | undefined = undefined> = (i: Partial<I>) => void;
+export type RefillFunc<I extends UCInput | undefined = undefined> = (i: UCInputPartial<I>) => void;
 /**
  * This hook provides utilities to init a use case and perform actions on it in a React way
  * @param appManifest
@@ -11,7 +11,7 @@ export type RefillFunc<I extends UCInput | undefined = undefined> = (i: Partial<
  * @returns
  */
 export declare function useUC<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(appManifest: ArgsRecord<I, OPI0, OPI1>['appManifest'], def: ArgsRecord<I, OPI0, OPI1>['def'], auth: ArgsRecord<I, OPI0, OPI1>['auth'], opts?: {
-    fillWith: Partial<I>;
+    fillWith: UCInputPartial<I>;
 }): [
     UC<I, OPI0, OPI1>,
     {

package/dist/esm/target/node-mcp-server/NodeLocalStdioMCPServerManager.js

@@ -125,6 +125,7 @@ let NodeLocalStdioMCPServerManager = class NodeLocalStdioMCPServerManager {
                 def: ucd,
             });
             if (args) {
+                // biome-ignore lint/suspicious/noExplicitAny: can be anything
                 uc.fill(args);
             }
             const confirmed = await this.ucManager.confirmClient(uc);

package/dist/esm/target/react-native-pure/UCForm.d.ts

@@ -1,4 +1,4 @@
 import type { ReactElement } from 'react';
 import type { UCInput, UCOPIBase } from '../../uc/index.js';
 import type { UCFormProps } from '../lib/react/form.js';
-export declare function UCForm<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>({ disabled, execState, onChange, onSubmit, uc, }: UCFormProps<I, OPI0, OPI1>): ReactElement;
+export declare function UCForm<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>({ disabled, execState, onSubmit, uc, }: UCFormProps<I, OPI0, OPI1>): ReactElement;

package/dist/esm/target/react-native-pure/UCForm.js

@@ -3,10 +3,10 @@ import { View } from 'react-native';
 import { useStyleContext } from '../lib/react/StyleContextProvider.js';
 import { UCFormField } from './UCFormField.js';
 import { UCFormSubmitControl } from './UCFormSubmitControl.js';
-export function UCForm({ disabled, execState, onChange, onSubmit, uc, }) {
+export function UCForm({ disabled, execState, onSubmit, uc, }) {
     const { form } = useStyleContext();
     const onPress = async () => {
         await onSubmit();
     };
-    return (_jsxs(View, { style: form?.style, children: [uc.inputFieldsForForm().map((f) => (_jsx(UCFormField, { disabled: disabled, execState: execState, f: f, onChange: onChange }, f.key))), _jsx(UCFormSubmitControl, { disabled: disabled, execState: execState, onPress: onPress, uc: uc })] }));
+    return (_jsxs(View, { style: form?.style, children: [uc.inputFieldsForForm().map((f) => (_jsx(UCFormField, { disabled: disabled, execState: execState, f: f }, f.key))), _jsx(UCFormSubmitControl, { disabled: disabled, execState: execState, onPress: onPress, uc: uc })] }));
 }

package/dist/esm/target/react-native-pure/UCFormField.d.ts

@@ -1,4 +1,4 @@
 import { type ReactElement } from 'react';
 import type { DataType } from '../../dt/index.js';
 import { type UCFormFieldProps } from '../lib/react/form.js';
-export declare function UCFormField<T extends DataType>({ disabled, execState, f, onChange: onChangeBase, only, }: UCFormFieldProps<T>): ReactElement;
+export declare function UCFormField<T extends DataType>({ disabled, execState, f, only, }: UCFormFieldProps<T>): ReactElement;

package/dist/esm/target/react-native-pure/UCFormField.js

@@ -8,13 +8,12 @@ import { UCFormFieldControl } from './UCFormFieldControl.js';
 import { UCFormFieldDesc } from './UCFormFieldDesc.js';
 import { UCFormFieldErr } from './UCFormFieldErr.js';
 import { UCFormFieldLabel } from './UCFormFieldLabel.js';
-export function UCFormField({ disabled, execState, f, onChange: onChangeBase, only, }) {
+export function UCFormField({ disabled, execState, f, only, }) {
     const { i18nManager } = useDIContext();
     const { formField } = useStyleContext();
     const [errMsg, setErrMsg] = useState(null);
-    const onChange = (f, op, v) => {
-        setErrMsg(validateFormField(i18nManager, f, v));
-        onChangeBase(f, op, v);
+    const onChange = () => {
+        setErrMsg(validateFormField(i18nManager, f));
     };
     const elements = only ?? UC_FORM_FIELD_ELEMENTS;
     return (_jsxs(View, { style: formField?.style, children: [elements.includes('label') && _jsx(UCFormFieldLabel, { f: f }), elements.includes('control') && (_jsx(UCFormFieldControl, { disabled: disabled, execState: execState, f: f, onChange: onChange })), elements.includes('err') && errMsg && (_jsx(UCFormFieldErr, { errMsg: errMsg })), elements.includes('desc') && _jsx(UCFormFieldDesc, { f: f })] }));

package/dist/esm/target/react-native-pure/UCFormFieldControl.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useState } from 'react';
 import { FlatList, Pressable, StyleSheet, Switch, Text, TextInput, } from 'react-native';
 import { TBoolean } from '../../dt/index.js';
-import { UCInputFieldChangeOperator, ucifRepeatability, } from '../../uc/index.js';
+import { ucifRepeatability } from '../../uc/index.js';
 import { isBlank } from '../../utils/index.js';
 import { styleDef, useStyleContext, } from '../lib/react/StyleContextProvider.js';
 import { rnInputDef } from '../lib/rn/input.js';
@@ -31,24 +31,30 @@ export function UCFormFieldControl({ disabled, errMsg = null, execState, f, onCh
             const valueArr = value
                 .split(MULTIPLE_VALUES_SEPARATOR)
                 .map((v) => v.trim());
-            onChangeBase(f, UCInputFieldChangeOperator.SET, valueArr);
+            f.setVal(valueArr);
+            onChangeBase();
+            setInternalValue(valueArr);
         }
         else {
-            onChangeBase(f, UCInputFieldChangeOperator.SET, value);
+            f.setVal(value);
+            onChangeBase();
+            setInternalValue(value);
         }
-        setInternalValue(value);
     };
     const onSelect = (value) => {
         if (internalValue === value) {
-            onChangeBase(f, UCInputFieldChangeOperator.RESET, null);
+            f.clear();
+            onChangeBase();
             setInternalValue(null);
             return;
         }
-        onChangeBase(f, UCInputFieldChangeOperator.SET, value);
+        f.setVal(value);
+        onChangeBase();
         setInternalValue(value);
     };
     const onValueChange = (value) => {
-        onChangeBase(f, UCInputFieldChangeOperator.SET, value);
+        f.setVal(value);
+        onChangeBase();
         setInternalValue(value);
     };
     const attrs = rnInputDef(f, disabled, errMsg);

package/dist/esm/target/react-web-pure/UCForm.d.ts

@@ -1,4 +1,4 @@
 import { type ReactElement } from 'react';
 import type { UCInput, UCOPIBase } from '../../uc/index.js';
 import type { UCFormProps } from '../lib/react/form.js';
-export declare function UCForm<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>({ clearAfterExec, disabled, execState, onChange, onSubmit: onSubmitBase, uc, }: UCFormProps<I, OPI0, OPI1>): ReactElement;
+export declare function UCForm<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>({ clearAfterExec, disabled, execState, onSubmit: onSubmitBase, uc, }: UCFormProps<I, OPI0, OPI1>): ReactElement;

package/dist/esm/target/react-web-pure/UCForm.js

@@ -3,7 +3,7 @@ import { useRef } from 'react';
 import { useStyleContext } from '../lib/react/StyleContextProvider.js';
 import { UCFormField } from './UCFormField.js';
 import { UCFormSubmitControl } from './UCFormSubmitControl.js';
-export function UCForm({ clearAfterExec, disabled, execState, onChange, onSubmit: onSubmitBase, uc, }) {
+export function UCForm({ clearAfterExec, disabled, execState, onSubmit: onSubmitBase, uc, }) {
     const { form } = useStyleContext();
     const formRef = useRef(null);
     const onSubmit = async (e) => {
@@ -13,5 +13,5 @@ export function UCForm({ clearAfterExec, disabled, execState, onChange, onSubmit
             formRef.current?.reset();
         }
     };
-    return (_jsxs("form", { className: form?.className, onSubmit: onSubmit, ref: formRef, style: form?.style, children: [uc.inputFieldsForForm().map((f) => (_jsx(UCFormField, { disabled: disabled, execState: execState, f: f, onChange: onChange }, f.key))), _jsx(UCFormSubmitControl, { disabled: disabled, execState: execState, uc: uc })] }));
+    return (_jsxs("form", { className: form?.className, onSubmit: onSubmit, ref: formRef, style: form?.style, children: [uc.inputFieldsForForm().map((f) => (_jsx(UCFormField, { disabled: disabled, execState: execState, f: f }, f.key))), _jsx(UCFormSubmitControl, { disabled: disabled, execState: execState, uc: uc })] }));
 }

package/dist/esm/target/react-web-pure/UCFormField.d.ts

@@ -1,4 +1,4 @@
 import { type ReactElement } from 'react';
 import type { DataType } from '../../dt/index.js';
 import { type UCFormFieldProps } from '../lib/react/form.js';
-export declare function UCFormField<T extends DataType>({ disabled, execState, f, onChange: onChangeBase, only, }: UCFormFieldProps<T>): ReactElement;
+export declare function UCFormField<T extends DataType>({ disabled, execState, f, only, }: UCFormFieldProps<T>): ReactElement;

package/dist/esm/target/react-web-pure/UCFormField.js

@@ -7,13 +7,12 @@ import { UCFormFieldControl } from './UCFormFieldControl.js';
 import { UCFormFieldDesc } from './UCFormFieldDesc.js';
 import { UCFormFieldErr } from './UCFormFieldErr.js';
 import { UCFormFieldLabel } from './UCFormFieldLabel.js';
-export function UCFormField({ disabled, execState, f, onChange: onChangeBase, only, }) {
+export function UCFormField({ disabled, execState, f, only, }) {
     const { i18nManager } = useDIContext();
     const { formField } = useStyleContext();
     const [errMsg, setErrMsg] = useState(null);
-    const onChange = (f, op, v) => {
-        setErrMsg(validateFormField(i18nManager, f, v));
-        onChangeBase(f, op, v);
+    const onChange = () => {
+        setErrMsg(validateFormField(i18nManager, f));
     };
     const elements = only ?? UC_FORM_FIELD_ELEMENTS;
     return (_jsxs("div", { className: formField?.className, style: formField?.style, children: [elements.includes('label') && _jsx(UCFormFieldLabel, { f: f }), elements.includes('control') && (_jsx(UCFormFieldControl, { disabled: disabled, execState: execState, f: f, onChange: onChange })), elements.includes('err') && errMsg && (_jsx(UCFormFieldErr, { errMsg: errMsg })), elements.includes('desc') && _jsx(UCFormFieldDesc, { f: f })] }));

package/dist/esm/target/react-web-pure/UCFormFieldControl.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { TBoolean } from '../../dt/index.js';
-import { UCInputFieldChangeOperator, ucifRepeatability, } from '../../uc/index.js';
+import { ucifRepeatability } from '../../uc/index.js';
 import { styleDef, useStyleContext, } from '../lib/react/StyleContextProvider.js';
 import { htmlInputDef } from '../lib/web/input.js';
 const CHECKED_FIELD_TYPES = ['checkbox', 'radio'];
@@ -27,7 +27,8 @@ export function UCFormFieldControl({ disabled, errMsg = null, execState, f, onCh
         if (target.localName === 'select' && !value) {
             // Prevent the value from being '' when we set/unset the select
             // Otherwise it sets '' as value and prevents the form for being valid
-            onChangeBase(f, UCInputFieldChangeOperator.RESET, value);
+            f.clear();
+            onChangeBase();
             return;
         }
         if (CHECKED_FIELD_TYPES.includes(type) && 'checked' in target) {
@@ -41,10 +42,12 @@ export function UCFormFieldControl({ disabled, errMsg = null, execState, f, onCh
             const valueArr = value
                 .split(MULTIPLE_VALUES_SEPARATOR)
                 .map((v) => v.trim());
-            onChangeBase(f, UCInputFieldChangeOperator.SET, valueArr);
+            f.setVal(valueArr);
+            onChangeBase();
         }
         else {
-            onChangeBase(f, UCInputFieldChangeOperator.SET, value);
+            f.setVal(value);
+            onChangeBase();
         }
     };
     const defaultChecked = attrs.internal?.checked;

package/dist/esm/testing/AppTester.d.ts

@@ -62,7 +62,7 @@ export declare class AppTester {
     checkUCDSources(): Promise<void>;
     checkUC(ucdRef: AppTesterUCDRef): Promise<void>;
     execFlow(flow: AppTesterFlow): Promise<AppTesterFlowExecOutput>;
-    execMonkeyTest<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(ucd: UCDef<I, OPI0, OPI1>, input: I): Promise<UCExecutorExecOutput<I, OPI0, OPI1>>;
+    execMonkeyTest<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(ucd: UCDef<I, OPI0, OPI1>, input: NonNullable<I>): Promise<UCExecutorExecOutput<I, OPI0, OPI1>>;
     execUC<I extends UCInput | undefined = undefined, OPI0 extends UCOPIBase | undefined = undefined, OPI1 extends UCOPIBase | undefined = undefined>(input: Omit<UCExecutorInput<I, OPI0, OPI1>, 'appManifest'>, flow?: AppTesterFlow): Promise<AppTestSuiteTestResult<I, OPI0, OPI1>>;
     finalize(): Promise<void>;
     getCtx(): AppTesterCtx;

package/dist/esm/testing/AppTester.js

@@ -13,7 +13,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { inject, injectable } from 'inversify';
 import { I18nEN } from '../i18n/locales/en.js';
 import { I18nFR } from '../i18n/locales/fr.js';
-import { FAKE_USER_ADMIN, UCBuilder, UCInputFieldChangeOperator, ucHTTPContract, } from '../uc/index.js';
+import { FAKE_USER_ADMIN, UCBuilder, ucHTTPContract, } from '../uc/index.js';
 // We inject directly the implementation because we'll generate all the reports and not only the one that is bound to the interface.
 // We can plan a setting à la Vitest where we specify the types of reports to generate though.
 import { SimpleHTMLAppTestReportEmitter } from './impl/SimpleHTMLAppTestReportEmitter.js';
@@ -137,7 +137,8 @@ let AppTester = class AppTester {
                 if (inputOverride) {
                     const inputOverrides = inputOverride(output);
                     for (const [k, v] of Object.entries(inputOverrides)) {
-                        uc.inputField(k).setValue(UCInputFieldChangeOperator.SET, v);
+                        // @ts-expect-error
+                        uc.inputField(k).setVal(v);
                     }
                 }
             };

package/dist/esm/testing/impl/SimpleHTMLAppTestReportEmitter.js

@@ -140,7 +140,7 @@ const template = (appPath, testResults, testSummary) => `<!DOCTYPE html>
                 const search = new URLSearchParams(window.location.search);
                 const status = search.get('status');
                 if (status) {
-                    document.querySelectorAll(\`table tbody tr:not(.\${status\})\`).forEach((n) => n.remove());
+                    document.querySelectorAll(\`table tbody tr:not(.\${status})\`).forEach((n) => n.remove());
                 }
             </script>
         </table>

package/dist/esm/testing/impl/TypeScriptLibUCDefASTParser.js

@@ -92,9 +92,9 @@ let TypeScriptLibUCDefASTParser = class TypeScriptLibUCDefASTParser {
                 target)],
         };
         this.compilerOptions.incremental = false; // Otherwise it triggers the following error : Option '--incremental' can only be specified using tsconfig, emitting to single file or when option '--tsBuildInfoFile' is specified.
-        // @ts-ignore
+        // @ts-expect-error
         this.compilerOptions.jsx = undefined; // Otherwise it triggers the following error since TS 5.5 : jsx is a string value; tsconfig JSON must be parsed with parseJsonSourceFileConfigFileContent or getParsedCommandLineOfConfigFile before passing to createProgram
-        // @ts-ignore
+        // @ts-expect-error
         this.compilerOptions.lib = undefined; // Otherwise it triggers errors saying it does not find them
     }
     getTypeFields(node) {

package/dist/esm/testing/impl/VitestAppTestSuiteEmitter.js

@@ -186,7 +186,7 @@ describe('Run', async () => {
                         expect(out).toSatisfy(assertion);
                     } else {
                         expect({ out, sideEffects }).toMatchSnapshot(
-                            \`hash = \${hash\}\`,
+                            \`hash = \${hash}\`,
                         );
                     }
                 },
@@ -209,7 +209,10 @@ describe('Run', async () => {
                     }
 
                     public async run(_m: Model, _r: RealSystem): Promise<void> {
-                        const out = await runner.execMonkeyTest(ucd, this.input);
+                        const out = await runner.execMonkeyTest(
+                            ucd,
+                            this.input,
+                        );
 
                         if (out.err !== null) {
                             if (!(out.err instanceof CustomError)) {
@@ -220,7 +223,7 @@ describe('Run', async () => {
                     }
 
                     public toString(): string {
-                        return \`\${ucd.metadata.name\}(\${JSON.stringify(this.input)\})\`;
+                        return \`\${ucd.metadata.name}(\${JSON.stringify(this.input)})\`;
                     }
                 }
 

package/dist/esm/testing/uc-input.js

@@ -1,5 +1,5 @@
 import { TFile } from '../dt/index.js';
-import { UCInputFieldChangeOperator, ucifIsMandatory, ucifMustBeFilledManually, ucifRepeatability, } from '../uc/index.js';
+import { ucifIsMandatory, ucifMustBeFilledManually, ucifRepeatability, } from '../uc/index.js';
 export const DEFAULT_UC_INPUT_FILLERS = [
     'ALL_WITH_EXAMPLES',
     'ONLY_MANDATORY_WITH_EXAMPLES',
@@ -36,19 +36,20 @@ export function onlySetProgrammaticallyWithExamples(uc) {
 // biome-ignore lint/suspicious/noExplicitAny: can be anything
 function fillWithExample(f) {
     const { type } = f.def;
-    let val = type.getExamples()?.[0] ?? type.example();
     if (type instanceof TFile) {
-        const file = val;
+        const example = type.getExamples()?.[0] ?? type.example();
         // TODO : Consider building a real file with real data (e.g. image, pdf, txt, etc.)
-        val = new File(['01010101010101010101010101010101'], file.path, {
-            type: file.type,
+        const val = new File(['01010101010101010101010101010101'], example.path, {
+            type: example.type,
         });
+        const [isRepeatable] = ucifRepeatability(f.def);
+        if (isRepeatable) {
+            f.addVal(val);
+        }
+        else {
+            f.setVal(val);
+        }
+        return;
     }
-    const [isRepeatable] = ucifRepeatability(f.def);
-    if (isRepeatable) {
-        f.setValue(UCInputFieldChangeOperator.ADD, val);
-    }
-    else {
-        f.setValue(UCInputFieldChangeOperator.SET, val);
-    }
+    f.fillWithExample();
 }

package/dist/esm/testing/workers/UCExecutor.js

@@ -92,13 +92,13 @@ let UCExecutor = class UCExecutor {
             if (Array.isArray(v)) {
                 v.forEach((vv, idx) => {
                     if (vv instanceof File) {
-                        // @ts-ignore
+                        // @ts-expect-error
                         input[k][idx] = this.derandomizeInputFile(vv);
                     }
                 });
             }
             else if (v instanceof File) {
-                // @ts-ignore
+                // @ts-expect-error
                 input[k] = this.derandomizeInputFile(v);
             }
         }

package/dist/esm/uc/UC.d.ts

@@ -2,7 +2,7 @@ import type { AppManifest } from '../app/index.js';
 import { type DataType, Validation } from '../dt/index.js';
 import type { UCAuth } from './auth.js';
 import type { UCDef, UCFieldKey } from './def.js';
-import type { UCInput } from './input.js';
+import type { UCInput, UCInputKey, UCInputKeyDataType, UCInputPartial } from './input.js';
 import type { UCOPIBase } from './opi.js';
 import { UCInputField } from './UCInputField.js';
 import type { reqVal0, rVal0, rValArr } from './utils/rVal.js';
@@ -16,15 +16,15 @@ export declare class UC<I extends UCInput | undefined = undefined, OPI0 extends
     appManifest: AppManifest;
     def: UCDef<I, OPI0, OPI1>;
     auth: UCAuth | null;
-    inputFields: UCInputField<any>[];
+    inputFields: UCInputField<DataType>[];
     constructor(appManifest: AppManifest, def: UCDef<I, OPI0, OPI1>, auth: UCAuth | null);
     clear(): void;
     clearSensitiveInputFields(): void;
-    fill(input: Partial<I>): this;
+    fill(input: UCInputPartial<I>): this;
     hasInputField(key: UCFieldKey): boolean;
     hasMediaInInput(): boolean;
     hasOutputParts(): boolean;
-    inputField<T extends DataType>(key: keyof NonNullable<I>): UCInputField<T>;
+    inputField<K extends UCInputKey<I>>(key: K): UCInputField<UCInputKeyDataType<I, K>>;
     inputFieldsForForm(): UCInputField<any>[];
     inputFieldsOrdered(): UCInputField<any>[];
     inputFieldsInsensitive(): UCInputField<any>[];
@@ -32,8 +32,8 @@ export declare class UC<I extends UCInput | undefined = undefined, OPI0 extends
     needsInputFilling(): boolean;
     needsOutputDisplay(): boolean;
     operatesOnAggregate(): boolean;
-    rVal0<T extends DataType>(key: keyof I): ReturnType<typeof rVal0<T>>;
-    reqVal0<T extends DataType>(key: keyof I): ReturnType<typeof reqVal0<T>>;
-    rValArr<T extends DataType>(key: keyof I): ReturnType<typeof rValArr<T>>;
+    rVal0<K extends UCInputKey<I>>(key: K): ReturnType<typeof rVal0<UCInputKeyDataType<I, K>>>;
+    reqVal0<K extends UCInputKey<I>>(key: K): ReturnType<typeof reqVal0<UCInputKeyDataType<I, K>>>;
+    rValArr<K extends UCInputKey<I>>(key: K): ReturnType<typeof rValArr<UCInputKeyDataType<I, K>>>;
     validate(): [UCInputField<any> | null, Validation] | null;
 }

package/dist/esm/uc/UC.js

@@ -1,6 +1,6 @@
 import { TFile, Validation } from '../dt/index.js';
 import { isBlank } from '../utils/index.js';
-import { UCInputFieldChangeOperator, ucifIsMandatory, ucifIsSensitive, ucifMustBeFilledManually, } from './input-field.js';
+import { ucifIsMandatory, ucifIsSensitive, ucifMustBeFilledManually, } from './input-field.js';
 import { AggregateInputDef } from './io/input/AggregateInput.js';
 import { ListInputDef } from './io/input/ListInput.js';
 import { UCInputField } from './UCInputField.js';
@@ -8,7 +8,6 @@ export class UC {
     appManifest;
     def;
     auth;
-    // biome-ignore lint/suspicious/noExplicitAny: can be anything
     inputFields;
     constructor(appManifest, def, auth) {
         this.appManifest = appManifest;
@@ -40,7 +39,8 @@ export class UC {
     }
     fill(input) {
         for (const f of this.inputFields) {
-            f.setValue(UCInputFieldChangeOperator.SET, input[f.key]);
+            const val = input[f.key];
+            f.setVal(val);
         }
         return this;
     }
@@ -58,6 +58,7 @@ export class UC {
         if (!field) {
             throw new Error(`Input field ${key.toString()} does not exist`);
         }
+        // @ts-expect-error
         return field;
     }
     // biome-ignore lint/suspicious/noExplicitAny: can be anything

package/dist/esm/uc/UCInputField.d.ts

@@ -1,6 +1,6 @@
 import { type DataType, Validation } from '../dt/index.js';
 import type { UCFieldKey, UCWording } from './def.js';
-import { UCInputFieldChangeOperator, type UCInputFieldDef, type UCInputFieldValue } from './input-field.js';
+import { type UCInputFieldDef, type UCInputFieldValue } from './input-field.js';
 import { type reqVal0, rVal0, rValArr } from './utils/rVal.js';
 export declare class UCInputField<T extends DataType> {
     key: UCFieldKey;
@@ -13,7 +13,9 @@ export declare class UCInputField<T extends DataType> {
     private dynamicWording;
     private value;
     constructor(key: UCFieldKey, def: UCInputFieldDef<T>);
+    addVal(value: UCInputFieldValue<T>): void;
     clear(): void;
+    fillWithExample(): void;
     getDynamicWording(): Partial<UCWording> | undefined;
     getValue(): UCInputFieldValue<T>;
     /**
@@ -35,14 +37,15 @@ export declare class UCInputField<T extends DataType> {
      */
     reqVal0(): ReturnType<typeof reqVal0<T>>;
     /**
-     * Require the value as an array
+     * Read the value as an array
      *
      * Unlink the standalone {@link rValArr}, it returns the default value in an array if present.
      *
      * @returns
      */
     rValArr(): ReturnType<typeof rValArr<T>>;
-    setValue(op: UCInputFieldChangeOperator, value: UCInputFieldValue<T>): void;
+    rmVal(value: UCInputFieldValue<T>): void;
+    setVal(value: UCInputFieldValue<T>): void;
     updateDef(def: UCInputFieldDef<T>): void;
     updateDynamicWording(dynamicWording: Partial<UCWording> | undefined): void;
     updateType(type: UCInputFieldDef<T>['type']): void;

package/dist/esm/uc/UCInputField.js

@@ -1,8 +1,7 @@
 import { Validation } from '../dt/index.js';
 import { isBlank } from '../utils/index.js';
-import { UCInputFieldChangeOperator, ucifIsMandatory, ucifMustBeFilledManually, ucifRepeatability, } from './input-field.js';
+import { ucifIsMandatory, ucifMustBeFilledManually, ucifRepeatability, } from './input-field.js';
 import { rVal0, rValArr } from './utils/rVal.js';
-import { ucifcoIsForArray } from './utils/ucifcoIsForArray.js';
 export class UCInputField {
     key;
     def;
@@ -21,6 +20,18 @@ export class UCInputField {
             this.value = initialValue;
         }
     }
+    addVal(value) {
+        const { type } = this.def;
+        type.assign(value);
+        const val = type.val();
+        if (val === undefined) {
+            // The value is invalid for T (we might want to throw an error here)
+            return;
+        }
+        const current = Array.isArray(this.value) ? this.value : [];
+        // We are not really forced to use immutability here, to be reconsidered
+        this.value = current.concat([val]);
+    }
     clear() {
         this.value = undefined;
         const initialValue = this.def.type.getInitialValue();
@@ -28,6 +39,18 @@ export class UCInputField {
             this.value = initialValue;
         }
     }
+    fillWithExample() {
+        this.clear();
+        const [isRepeatable] = ucifRepeatability(this.def);
+        const { type } = this.def;
+        const val = type.getExamples()?.[0] ?? type.example();
+        if (isRepeatable) {
+            this.addVal(val);
+        }
+        else {
+            this.setVal(val);
+        }
+    }
     getDynamicWording() {
         return this.dynamicWording;
     }
@@ -77,7 +100,7 @@ export class UCInputField {
         throw new Error(`${this.key.toString()} is not set and has no default value. Do not require it.`);
     }
     /**
-     * Require the value as an array
+     * Read the value as an array
      *
      * Unlink the standalone {@link rValArr}, it returns the default value in an array if present.
      *
@@ -100,40 +123,27 @@ export class UCInputField {
         // Otherwise, we could not get the value of an optional repeatable field (see remark above on the defaultValue).
         return [];
     }
-    setValue(op, value) {
-        if (op === UCInputFieldChangeOperator.RESET) {
-            this.clear();
-            return;
-        }
+    rmVal(value) {
         const { type } = this.def;
         type.assign(value);
         const val = type.val();
         if (val === undefined) {
-            return;
-        }
-        if (!ucifcoIsForArray(op)) {
-            // Using a switch, even for just one case, to have it trigger an error if we miss to handle an enum value
-            switch (op) {
-                case UCInputFieldChangeOperator.SET:
-                    this.value = val;
-                    break;
-                default:
-                    ((_) => { })(op);
-            }
+            // The value is invalid for T (we might want to throw an error here)
             return;
         }
         const current = Array.isArray(this.value) ? this.value : [];
-        switch (op) {
-            // We are not really forced to use immutability here, but it's better for consistency
-            case UCInputFieldChangeOperator.ADD:
-                this.value = current.concat([val]);
-                break;
-            case UCInputFieldChangeOperator.REMOVE:
-                this.value = current.filter((v) => v !== val);
-                break;
-            default:
-                ((_) => { })(op);
+        // We are not really forced to use immutability here, to be reconsidered
+        this.value = current.filter((v) => v !== val);
+    }
+    setVal(value) {
+        const { type } = this.def;
+        type.assign(value);
+        const val = type.val();
+        if (val === undefined) {
+            // The value is invalid for T (we might want to throw an error here)
+            return;
         }
+        this.value = val;
     }
     updateDef(def) {
         this.def = def;

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

@@ -50,7 +50,6 @@ export * from './utils/rInput.js';
 export * from './utils/rVal.js';
 export * from './utils/stripUCDLifecycleServer.js';
 export * from './utils/ucHTTPContract.js';
-export * from './utils/ucifcoIsForArray.js';
 export * from './utils/ucMountingPoint.js';
 export * from './value.js';
 export * from './workers/SimpleAggregateFinder.js';

package/dist/esm/uc/index.js

@@ -50,7 +50,6 @@ export * from './utils/rInput.js';
 export * from './utils/rVal.js';
 export * from './utils/stripUCDLifecycleServer.js';
 export * from './utils/ucHTTPContract.js';
-export * from './utils/ucifcoIsForArray.js';
 export * from './utils/ucMountingPoint.js';
 export * from './value.js';
 export * from './workers/SimpleAggregateFinder.js';

package/dist/esm/uc/input-field.d.ts

@@ -1,24 +1,6 @@
 import type { DataType, TBase, UIntQuantity } from '../dt/index.js';
 import type { UCFieldKey } from './def.js';
 import type { Value } from './value.js';
-export declare enum UCInputFieldChangeOperator {
-    /**
-     * Considering the cardinality of the field (min > 1), add a new value
-     */
-    ADD = "ADD",
-    /**
-     * Considering the cardinality of the field (min > 1), remove a value
-     */
-    REMOVE = "REMOVE",
-    /**
-     * Reset the value of the field
-     */
-    RESET = "RESET",
-    /**
-     * Considering the cardinality of the field (max <= 1), set the value
-     */
-    SET = "SET"
-}
 export declare enum UCInputFieldFillingMode {
     /**
      * Set programmatically on behalf of the user (e.g. a foreign key id for a given object)
@@ -72,7 +54,8 @@ export interface UCInputFieldDef<T extends DataType> {
     transient?: boolean;
     type: TBase<T>;
 }
-export type UCInputFieldValue<T extends DataType> = Value<T>;
+export type UCInputFieldValue<T> = Value<T>;
+export type UCInputFieldValueUnwrapped<T> = T extends UCInputFieldValue<infer U> ? U : never;
 export declare function ucifExamples<T extends DataType>(def: UCInputFieldDef<T>): T[] | undefined;
 export declare function ucifHint<T extends DataType>(def: UCInputFieldDef<T>): string | undefined;
 /**

package/dist/esm/uc/input-field.js

@@ -1,22 +1,3 @@
-export var UCInputFieldChangeOperator;
-(function (UCInputFieldChangeOperator) {
-    /**
-     * Considering the cardinality of the field (min > 1), add a new value
-     */
-    UCInputFieldChangeOperator["ADD"] = "ADD";
-    /**
-     * Considering the cardinality of the field (min > 1), remove a value
-     */
-    UCInputFieldChangeOperator["REMOVE"] = "REMOVE";
-    /**
-     * Reset the value of the field
-     */
-    UCInputFieldChangeOperator["RESET"] = "RESET";
-    /**
-     * Considering the cardinality of the field (max <= 1), set the value
-     */
-    UCInputFieldChangeOperator["SET"] = "SET";
-})(UCInputFieldChangeOperator || (UCInputFieldChangeOperator = {}));
 export var UCInputFieldFillingMode;
 (function (UCInputFieldFillingMode) {
     /**

package/dist/esm/uc/input.d.ts

@@ -1,10 +1,16 @@
+import type { DataType } from '../dt/index.js';
 import type { StringKeys } from '../utils/index.js';
-import type { UCInputFieldDef } from './input-field.js';
+import type { UCInputFieldDef, UCInputFieldValue, UCInputFieldValueUnwrapped } from './input-field.js';
 /**
  * Base interface all the use case input interfaces must extend
  */
-export interface UCInput {
-}
+export type UCInput = {};
+export type UCInputUnwrapped<I extends UCInput | undefined> = {
+    [K in keyof I]: UCInputFieldValueUnwrapped<I[K]>;
+};
+export type UCInputKey<I extends UCInput | undefined> = StringKeys<UCInputUnwrapped<I>>;
+export type UCInputPartial<I extends UCInput | undefined> = Partial<Record<UCInputKey<I>, UCInputFieldValue<DataType>>>;
+export type UCInputKeyDataType<I extends UCInput | undefined, K extends UCInputKey<I>> = NonNullable<UCInputUnwrapped<I>[K]>;
 /**
  * Definition of a use case input
  */
@@ -12,11 +18,11 @@ export interface UCInputDef<I extends UCInput> {
     /**
      * This is useful when you want to render a given field only after its dependent fields have been set.
      */
-    dependencies?: Partial<Record<StringKeys<I>, StringKeys<I>[]>>;
+    dependencies?: Partial<Record<UCInputKey<I>, UCInputKey<I>[]>>;
     /**
      * It must follow strictly the shape of the corresponding {@link UCInput} with fields sorted alphabetically.
      */
-    fields: Record<StringKeys<I>, UCInputFieldDef<any>>;
+    fields: Record<UCInputKey<I>, UCInputFieldDef<any>>;
     /**
      * By default, the fields are displayed in the same order as in {@link fields} (i.e. alphabetically).
      *
@@ -24,13 +30,13 @@ export interface UCInputDef<I extends UCInput> {
      *
      * For example, when rendering a form, this is used.
      */
-    order?: StringKeys<I>[];
+    order?: UCInputKey<I>[];
     /**
      * Cross-field validation rules
      *
      * For example, if you want the user to provide `a` OR `b` but not both.
      */
     validation?: {
-        or?: StringKeys<I>[];
+        or?: UCInputKey<I>[];
     };
 }

package/dist/esm/uc/utils/rInput.js

@@ -1,5 +1,5 @@
 import { TBoolean } from '../../dt/index.js';
-import { UCInputFieldChangeOperator, ucifIsMandatory, ucifRepeatability, } from '../input-field.js';
+import { ucifIsMandatory, ucifRepeatability } from '../input-field.js';
 const DEFAULT_OPTS = {
     forceArrayAsEmpty: false,
     forceBooleanAsFalse: true,
@@ -24,18 +24,19 @@ export function rInput(uc, opts) {
             ucifIsMandatory(f.def) &&
             (value === null || value === undefined)) {
             value = false;
-            f.setValue(UCInputFieldChangeOperator.SET, value);
+            f.setVal(value);
         }
         const [isRepeatable] = ucifRepeatability(f.def);
         if (forceArrayAsEmpty &&
             isRepeatable &&
             (value === null || value === undefined)) {
             value = [];
-            f.setValue(UCInputFieldChangeOperator.SET, value);
+            f.setVal(value);
         }
         if (!ignoreUndefined || (ignoreUndefined && value !== undefined)) {
             // Useful when we get the input before persisting for example.
             // Otherwise it will persist `undefined` as a string in the database, for nothing.
+            // @ts-expect-error
             input[f.key] = value;
         }
     }

package/dist/esm/uc/utils/rVal.d.ts

@@ -1,4 +1,3 @@
-import type { DataType } from '../../dt/index.js';
 import type { Value } from '../value.js';
 /**
  * Read the value as a primitive
@@ -9,7 +8,8 @@ import type { Value } from '../value.js';
  * @param or
  * @returns
  */
-export declare function rVal0<T extends DataType>(value: Value<T>, or?: T): T | null;
+export declare function rVal0<T>(value: Value<T>, or: T): T;
+export declare function rVal0<T>(value: Value<T>, or?: undefined): T | null;
 /**
  * Require the value as a primitive
  *
@@ -18,13 +18,13 @@ export declare function rVal0<T extends DataType>(value: Value<T>, or?: T): T |
  * @param value
  * @returns
  */
-export declare function reqVal0<T extends DataType>(value: Value<T>): T;
+export declare function reqVal0<T>(value: Value<T>): T;
 /**
- * Get the value as an array
+ * Read the value as an array
  *
  * To be used when the field has a 0..* cardinality.
  *
  * @param value
  * @returns
  */
-export declare function rValArr<T extends DataType>(value: Value<T>): T[];
+export declare function rValArr<T>(value: Value<T>): T[];

package/dist/esm/uc/utils/rVal.js

@@ -1,15 +1,4 @@
 import { isBlank } from '../../utils/index.js';
-// NOTE : the "r" prefix stands for "read" and the "req" prefix stands for "require"
-/**
- * Read the value as a primitive
- *
- * To be used when the field has a 0..1 cardinality.
- *
- * @param value
- * @param or
- * @returns
- */
-// TODO : Find a way to return `T` when `or` is set (function override does not work)
 export function rVal0(value, or) {
     if (isBlank(value)) {
         return or ?? null;
@@ -32,7 +21,7 @@ export function reqVal0(value) {
     return val;
 }
 /**
- * Get the value as an array
+ * Read the value as an array
  *
  * To be used when the field has a 0..* cardinality.
  *

package/dist/esm/uc/value.d.ts

@@ -1,2 +1 @@
-import type { DataType } from '../dt/index.js';
-export type Value<T extends DataType> = T | T[] | null | undefined;
+export type Value<T> = T | T[] | null | undefined;

package/dist/esm/uc/workers/UCInputFilesProcessor.js

@@ -12,7 +12,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { inject, injectable } from 'inversify';
 import { TFile } from '../../dt/index.js';
-import { UCInputFieldChangeOperator, ucifRepeatability, } from '../input-field.js';
+import { ucifRepeatability } from '../input-field.js';
 import { rVal0, rValArr } from '../utils/rVal.js';
 let UCInputFilesProcessor = class UCInputFilesProcessor {
     clockManager;
@@ -45,13 +45,13 @@ let UCInputFilesProcessor = class UCInputFilesProcessor {
                 // Although the field is a file, here we fill it with the refs (for persistence)
                 // TODO : Improve the mgmt of FileNameRef vs actual File at the use case level
                 // I think we need to introduce another value, something like `setValueSerialized` or similar.
-                field.setValue(UCInputFieldChangeOperator.SET, fileNameRefs);
+                field.setVal(fileNameRefs);
             }
             else {
                 const file = rVal0(field.getValue());
                 if (file) {
                     const fileNameRef = await this.processFile(file);
-                    field.setValue(UCInputFieldChangeOperator.SET, fileNameRef);
+                    field.setVal(fileNameRef);
                 }
             }
         }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "libmodulor",
     "description": "A TypeScript library to create platform-agnostic applications",
-    "version": "0.20.0",
+    "version": "0.21.0",
     "license": "LGPL-3.0",
     "author": "Chafik H'nini <chafik.hnini@gmail.com>",
     "homepage": "https://libmodulor.c100k.eu",
@@ -81,11 +81,11 @@
         "lint:ci": "biome check"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.1.2"
+        "@biomejs/biome": "^2.2.0"
     },
     "peerDependencies": {
-        "@hono/node-server": "^1.17.1",
-        "@modelcontextprotocol/sdk": "^1.16.0",
+        "@hono/node-server": "^1.19.0",
+        "@modelcontextprotocol/sdk": "^1.17.3",
         "@stricli/core": "^1.2.0",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
@@ -93,18 +93,18 @@
         "express-fileupload": "^1.5.2",
         "fast-check": "^4.2.0",
         "helmet": "^8.1.0",
-        "hono": "^4.8.5",
-        "inversify": "^7.6.1",
+        "hono": "^4.9.2",
+        "inversify": "^7.8.1",
         "jose": "^6.0.12",
         "knex": "^3.1.0",
-        "next": "^15.4.2",
+        "next": "^15.4.7",
         "pg": "^8.16.3",
-        "react": "^19.1.0",
-        "react-dom": "^19.1.0",
-        "react-native": "^0.79.5",
+        "react": "^19.1.1",
+        "react-dom": "^19.1.1",
+        "react-native": "^0.79.6",
         "reflect-metadata": "^0.2.2",
         "sqlite3": "^5.1.7",
-        "typescript": "^5.8.3",
+        "typescript": "^5.9.2",
         "vite": "^6.3.5",
         "vitest": "^3.2.4"
     },