libmodulor 0.24.0 → 0.25.0

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

@@ -1,5 +1,6 @@
-import { TFile } from '../dt/index.js';
+import { TFile, TFilePath } from '../dt/index.js';
 import { ucifIsMandatory, ucifMustBeFilledManually, ucifRepeatability, } from '../uc/index.js';
+import { range } from '../utils/index.js';
 export const DEFAULT_UC_INPUT_FILLERS = [
     'ALL_WITH_EXAMPLES',
     'ONLY_MANDATORY_WITH_EXAMPLES',
@@ -39,7 +40,9 @@ function fillWithExample(f) {
     if (type instanceof TFile) {
         const example = type.getExamples()?.[0] ?? type.example();
         // TODO : Consider building a real file with real data (e.g. image, pdf, txt, etc.)
-        const val = new File(['01010101010101010101010101010101'], example.path, {
+        // A fake file filled with 0s and 1s
+        const blob = range(TFilePath.FILE_SIZE).map((i) => (i % 2).toString());
+        const val = new File(blob, example.uri, {
             type: example.type,
         });
         const [isRepeatable] = ucifRepeatability(f.def);

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

@@ -1,38 +1,59 @@
+import type { EnumOf } from '../utils/index.js';
 /**
  * Mode of execution of a use case
- *
- * Unlike all the other enums, the values are lowercased for compatibility reasons.
- * Indeed, this value is persisted in the database so we need to support all existing deployments.
  */
-export declare enum UCExecMode {
+export declare const UCExecMode: {
     /**
      * The use case has been executed programmatically
      */
-    AUTO = "auto",
+    readonly AUTO: "auto";
     /**
      * The use case has been executed explicitly by a user
      */
-    USER = "user"
-}
+    readonly USER: "user";
+};
+export type UCExecMode = EnumOf<typeof UCExecMode>;
 /**
  * Result of execution of a use case
- *
- * - `aborted`      : The user aborted the exec (e.g. by not confirming)
- * - `failed`       : The exec failed
- * - `succeeded`    : The exec succeeded
  */
-export type UCExecRes = 'aborted' | 'failed' | 'succeeded';
+export declare const UCExecRes: {
+    /**
+     * The user aborted the exec (e.g. by not confirming)
+     */
+    readonly ABORTED: "aborted";
+    /**
+     * The execution failed
+     */
+    readonly FAILED: "failed";
+    /**
+     * The execution succeeded
+     */
+    readonly SUCCEEDED: "succeeded";
+};
+export type UCExecRes = EnumOf<typeof UCExecRes>;
 /**
  * State of execution of a use case
- *
- * - `changing`     : An action triggered a change, fields should be disabled
- * - `idle`         : It can be touched and filled by the user
- * - `initializing` : It's initializing in some way, fields should be disabled
- * - `submitting`   : It's submitting, fields should be disabled and some indicator should show the processing
- *
  * It applies to a form, but it can be applied and generalized to any other interaction mechanism (i.e. cli, voice...).
  */
-export type UCExecState = 'changing' | 'idle' | 'initializing' | 'submitting';
+export declare const UCExecState: {
+    /**
+     * An action triggered a change, fields should be disabled
+     */
+    readonly CHANGING: "changing";
+    /**
+     * It can be touched and filled by the user
+     */
+    readonly IDLE: "idle";
+    /**
+     * It's initializing in some way, fields should be disabled
+     */
+    readonly INITIALIZING: "initializing";
+    /**
+     * It's submitting, fields should be disabled and some indicator should show the processing
+     */
+    readonly SUBMITTING: "submitting";
+};
+export type UCExecState = EnumOf<typeof UCExecState>;
 /**
  * Check whether the execution corresponds to a "disabled" state
  *
@@ -45,8 +66,8 @@ export declare function ucIsDisabled(execState: UCExecState): boolean;
 /**
  * Check whether the execution corresponds to a "loading" state
  *
- * Typically, this is used to show a `loading` indicator. Thus, it's `true` when `execState === 'submitting'`.
- * Note that it's not for `changing` or `initializing` because these are not triggered by the user per sé.
+ * Typically, this is used to show a `loading` indicator. Thus, it's `true` when `execState === UCExecState.SUBMITTING`.
+ * Note that it's not for `UCExecState.CHANGING` or `UCExecState.INITIALIZING` because these are not triggered by the user per sé.
  *
  * @param execState
  * @returns

package/dist/esm/uc/exec.js

@@ -1,20 +1,55 @@
 /**
  * Mode of execution of a use case
- *
- * Unlike all the other enums, the values are lowercased for compatibility reasons.
- * Indeed, this value is persisted in the database so we need to support all existing deployments.
  */
-export var UCExecMode;
-(function (UCExecMode) {
+export const UCExecMode = {
     /**
      * The use case has been executed programmatically
      */
-    UCExecMode["AUTO"] = "auto";
+    AUTO: 'auto',
     /**
      * The use case has been executed explicitly by a user
      */
-    UCExecMode["USER"] = "user";
-})(UCExecMode || (UCExecMode = {}));
+    USER: 'user',
+};
+/**
+ * Result of execution of a use case
+ */
+export const UCExecRes = {
+    /**
+     * The user aborted the exec (e.g. by not confirming)
+     */
+    ABORTED: 'aborted',
+    /**
+     * The execution failed
+     */
+    FAILED: 'failed',
+    /**
+     * The execution succeeded
+     */
+    SUCCEEDED: 'succeeded',
+};
+/**
+ * State of execution of a use case
+ * It applies to a form, but it can be applied and generalized to any other interaction mechanism (i.e. cli, voice...).
+ */
+export const UCExecState = {
+    /**
+     * An action triggered a change, fields should be disabled
+     */
+    CHANGING: 'changing',
+    /**
+     * It can be touched and filled by the user
+     */
+    IDLE: 'idle',
+    /**
+     * It's initializing in some way, fields should be disabled
+     */
+    INITIALIZING: 'initializing',
+    /**
+     * It's submitting, fields should be disabled and some indicator should show the processing
+     */
+    SUBMITTING: 'submitting',
+};
 /**
  * Check whether the execution corresponds to a "disabled" state
  *
@@ -24,19 +59,19 @@ export var UCExecMode;
  * @returns
  */
 export function ucIsDisabled(execState) {
-    return execState !== 'idle';
+    return execState !== UCExecState.IDLE;
 }
 /**
  * Check whether the execution corresponds to a "loading" state
  *
- * Typically, this is used to show a `loading` indicator. Thus, it's `true` when `execState === 'submitting'`.
- * Note that it's not for `changing` or `initializing` because these are not triggered by the user per sé.
+ * Typically, this is used to show a `loading` indicator. Thus, it's `true` when `execState === UCExecState.SUBMITTING`.
+ * Note that it's not for `UCExecState.CHANGING` or `UCExecState.INITIALIZING` because these are not triggered by the user per sé.
  *
  * @param execState
  * @returns
  */
 export function ucIsLoading(execState) {
-    return execState === 'submitting';
+    return execState === UCExecState.SUBMITTING;
 }
 /**
  * Check whether the execution corresponds to an "error" result
@@ -45,5 +80,5 @@ export function ucIsLoading(execState) {
  * @returns
  */
 export function ucIsOnErr(execRes) {
-    return execRes === 'failed';
+    return execRes === UCExecRes.FAILED;
 }

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

@@ -1,16 +1,18 @@
 import type { DataType, TBase, UIntQuantity } from '../dt/index.js';
+import type { EnumOf } from '../utils/index.js';
 import type { UCFieldKey } from './def.js';
 import type { Value } from './value.js';
-export declare enum UCInputFieldFillingMode {
+export declare const UCInputFieldFillingMode: {
     /**
      * Set programmatically on behalf of the user (e.g. a foreign key id for a given object)
      */
-    AUTO_PRE = "AUTO_PRE",
+    readonly AUTO_PRE: "AUTO_PRE";
     /**
      * Set manually by the user (e.g. a form field, a cli flag, etc.)
      */
-    MANUAL = "MANUAL"
-}
+    readonly MANUAL: "MANUAL";
+};
+export type UCInputFieldFillingMode = EnumOf<typeof UCInputFieldFillingMode>;
 export interface UCInputFieldDefCardinality {
     max?: UIntQuantity;
     min?: UIntQuantity;

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

@@ -1,14 +1,13 @@
-export var UCInputFieldFillingMode;
-(function (UCInputFieldFillingMode) {
+export const UCInputFieldFillingMode = {
     /**
      * Set programmatically on behalf of the user (e.g. a foreign key id for a given object)
      */
-    UCInputFieldFillingMode["AUTO_PRE"] = "AUTO_PRE";
+    AUTO_PRE: 'AUTO_PRE',
     /**
      * Set manually by the user (e.g. a form field, a cli flag, etc.)
      */
-    UCInputFieldFillingMode["MANUAL"] = "MANUAL";
-})(UCInputFieldFillingMode || (UCInputFieldFillingMode = {}));
+    MANUAL: 'MANUAL',
+};
 export function ucifExamples(def) {
     const { type } = def;
     const examples = type.getExamples();

package/dist/esm/uc/side-effect.d.ts

@@ -1,8 +1,9 @@
-export declare enum UCOutputSideEffectType {
+import type { EnumOf } from '../utils/index.js';
+export declare const UCOutputSideEffectType: {
     /**
      * Trigger a clearing of the auth on the calling system (e.g. `SignOut`).
      */
-    CLEAR_AUTH = "CLEAR_AUTH",
+    readonly CLEAR_AUTH: "CLEAR_AUTH";
     /**
      * Trigger a redirect on the calling system (e.g. after the final round of an OAuth1 flow)
      *
@@ -11,18 +12,19 @@ export declare enum UCOutputSideEffectType {
      *
      * It expects a field `redirect: URL` in `output.parts._0.items[0]`.
      */
-    REDIRECT = "REDIRECT",
+    readonly REDIRECT: "REDIRECT";
     /**
      * Trigger a setting of the auth on the calling system (e.g. `SignIn` / `SignUp`).
      *
      * It expects a field `jwt: JWT` in `output.parts._0.items[0]`.
      */
-    SET_AUTH = "SET_AUTH"
-}
+    readonly SET_AUTH: "SET_AUTH";
+};
+export type UCOutputSideEffectType = EnumOf<typeof UCOutputSideEffectType>;
 export type UCOutputSideEffect = {
-    type: UCOutputSideEffectType.CLEAR_AUTH;
+    type: typeof UCOutputSideEffectType.CLEAR_AUTH;
 } | {
-    type: UCOutputSideEffectType.REDIRECT;
+    type: typeof UCOutputSideEffectType.REDIRECT;
 } | {
-    type: UCOutputSideEffectType.SET_AUTH;
+    type: typeof UCOutputSideEffectType.SET_AUTH;
 };

package/dist/esm/uc/side-effect.js

@@ -1,9 +1,8 @@
-export var UCOutputSideEffectType;
-(function (UCOutputSideEffectType) {
+export const UCOutputSideEffectType = {
     /**
      * Trigger a clearing of the auth on the calling system (e.g. `SignOut`).
      */
-    UCOutputSideEffectType["CLEAR_AUTH"] = "CLEAR_AUTH";
+    CLEAR_AUTH: 'CLEAR_AUTH',
     /**
      * Trigger a redirect on the calling system (e.g. after the final round of an OAuth1 flow)
      *
@@ -12,11 +11,11 @@ export var UCOutputSideEffectType;
      *
      * It expects a field `redirect: URL` in `output.parts._0.items[0]`.
      */
-    UCOutputSideEffectType["REDIRECT"] = "REDIRECT";
+    REDIRECT: 'REDIRECT',
     /**
      * Trigger a setting of the auth on the calling system (e.g. `SignIn` / `SignUp`).
      *
      * It expects a field `jwt: JWT` in `output.parts._0.items[0]`.
      */
-    UCOutputSideEffectType["SET_AUTH"] = "SET_AUTH";
-})(UCOutputSideEffectType || (UCOutputSideEffectType = {}));
+    SET_AUTH: 'SET_AUTH',
+};

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

@@ -66,9 +66,9 @@ let UCInputFilesProcessor = class UCInputFilesProcessor {
             await this.fsManager.touch(destPath, await file.arrayBuffer());
         }
         else {
-            const { path } = file;
-            await this.fsManager.cp(path, destPath);
-            await this.fsManager.rm(path);
+            const { uri } = file;
+            await this.fsManager.cp(uri, destPath);
+            await this.fsManager.rm(uri);
         }
         return fileNameRef;
     }

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

@@ -34,7 +34,8 @@ let UCInputValidator = class UCInputValidator {
         let message = this.i18nManager.t(key, { vars: { expected } });
         if (field) {
             const { label } = this.wordingManager.ucif(field);
-            message = `${label} ${message ? message.toLowerCase() : ''}`.trim();
+            message = `${message.charAt(0).toLowerCase()}${message.slice(1)}`;
+            message = `${label} ${message}`.trim();
         }
         throw new IllegalArgumentError(message);
     }

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

@@ -44,7 +44,7 @@ let UCOutputFilesProcessor = class UCOutputFilesProcessor {
                 filePath = this.fsManager.path(this.s().uc_files_directory_path, fileName); // => /path/to/files/20230110143732-155eb8d3-9af5-430e-b856-248007859df1.jpg
             }
             else {
-                filePath = fileNameRef.path;
+                filePath = fileNameRef.uri;
             }
             if (keepOnlyFileName) {
                 const { base } = await this.fsManager.info(filePath);

package/dist/esm/utils/bundling/webpack/loader.js

@@ -1,7 +1,7 @@
 import { assertTransformedCorrectly, isFileEligible, } from '../funcs.js';
 import { transform } from '../typescript.js';
 export default function loader(source) {
-    // @ts-expect-error -- magically made available by Webpack at execution
+    // @ts-expect-error : magically made available by Webpack at execution
     const fileName = this.resourcePath;
     if (!isFileEligible(fileName, ['ts'])) {
         return source;

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

@@ -23,4 +23,4 @@ export { humanize } from './strings/humanize.js';
 export { truncate } from './strings/truncate.js';
 export { fmtBold, fmtCommand, fmtPadEndFor, fmtSection, } from './terminal/fmt.js';
 export { assertIsDefined, isBlank, range, sample, tupleOf, } from './types/funcs.js';
-export type { ExtractStrict, RecursiveNonNullable, StringKeys, } from './types/utility-types.js';
+export type { EnumOf, ExtractStrict, RecursiveNonNullable, StringKeys, } from './types/utility-types.js';

package/dist/esm/utils/types/utility-types.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Get an enum-like type with the keys of the object
+ */
+export type EnumOf<T extends object> = T[keyof T];
 /**
  * Extract a subset of a union type in a strict manner
  *

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "libmodulor",
     "description": "A TypeScript library to create platform-agnostic applications",
-    "version": "0.24.0",
+    "version": "0.25.0",
     "license": "LGPL-3.0",
     "author": "Chafik H'nini <chafik.hnini@gmail.com>",
     "homepage": "https://libmodulor.c100k.eu",
@@ -96,33 +96,35 @@
         "lint:ci": "biome check"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.3.8",
+        "@biomejs/biome": "^2.3.10",
         "@react-native-community/slider": "^4.5.7",
         "@types/react": "^19.2.7",
         "@types/react-dom": "^19.2.3",
         "babel-plugin-parameter-decorator": "^1.0.16",
         "babel-plugin-transform-typescript-metadata": "^0.3.2",
-        "expo": "^54.0.25",
-        "wrangler": "^4.51.0"
+        "expo": "^54.0.29",
+        "expo-document-picker": "~14.0.8",
+        "expo-image-picker": "^17.0.10",
+        "wrangler": "^4.55.0"
     },
     "peerDependencies": {
-        "@hono/node-server": "^1.19.6",
-        "@modelcontextprotocol/sdk": "^1.23.0",
+        "@hono/node-server": "^1.19.7",
+        "@modelcontextprotocol/sdk": "^1.25.1",
         "@stricli/core": "^1.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",
-        "hono": "^4.10.7",
-        "inversify": "^7.10.4",
-        "jose": "^6.1.2",
+        "hono": "^4.11.1",
+        "inversify": "^7.10.7",
+        "jose": "^6.1.3",
         "knex": "^3.1.0",
-        "next": "^15.5.7",
+        "next": "^15.5.9",
         "pg": "^8.16.3",
-        "react": "^19.2.1",
-        "react-dom": "^19.2.1",
+        "react": "^19.2.3",
+        "react-dom": "^19.2.3",
         "react-native": "^0.81.5",
         "reflect-metadata": "^0.2.2",
         "sqlite3": "^5.1.7",