libmodulor 0.19.0 → 0.21.0

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.19.0",
+    "version": "0.21.0",
     "license": "LGPL-3.0",
     "author": "Chafik H'nini <chafik.hnini@gmail.com>",
     "homepage": "https://libmodulor.c100k.eu",
@@ -81,30 +81,30 @@
         "lint:ci": "biome check"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.0.0"
+        "@biomejs/biome": "^2.2.0"
     },
     "peerDependencies": {
-        "@hono/node-server": "^1.14.4",
-        "@modelcontextprotocol/sdk": "^1.13.0",
-        "@stricli/core": "^1.1.2",
+        "@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",
         "express": "^5.1.0",
-        "express-fileupload": "^1.5.1",
-        "fast-check": "^4.1.1",
+        "express-fileupload": "^1.5.2",
+        "fast-check": "^4.2.0",
         "helmet": "^8.1.0",
-        "hono": "^4.8.1",
-        "inversify": "^7.5.2",
-        "jose": "^6.0.11",
+        "hono": "^4.9.2",
+        "inversify": "^7.8.1",
+        "jose": "^6.0.12",
         "knex": "^3.1.0",
-        "next": "^15.3.4",
-        "pg": "^8.16.2",
-        "react": "^19.1.0",
-        "react-dom": "^19.1.0",
-        "react-native": "^0.79.4",
+        "next": "^15.4.7",
+        "pg": "^8.16.3",
+        "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"
     },

package/pnpm-workspace.yaml

@@ -1,6 +1,6 @@
 packages:
-  - docs-fd
   - examples/basic
+  - examples/standalone
   - examples/supertrader
 onlyBuiltDependencies:
   - '@biomejs/biome'

package/tsconfig.json

@@ -28,7 +28,6 @@
     },
     "exclude": [
         "dist",
-        "docs-fd",
         "examples/**/dist",
         "examples/**/node_modules",
         "node_modules"