libmodulor 0.23.0 → 0.25.0

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

@@ -1,54 +1,55 @@
 import { useEffect, useState } from 'react';
+import { UCExecRes, UCExecState } from '../../../uc/index.js';
 import { sleep } from '../../../utils/index.js';
 export function useAction({ action, autoExec = false, confirm, onError, onInit, onStart, sleepInMs, }) {
     const [errMsg, setErrMsg] = useState(null);
     const [execRes, setExecRes] = useState(null);
-    const [execState, setExecState] = useState(onInit ? 'initializing' : 'idle');
+    const [execState, setExecState] = useState(onInit ? UCExecState.INITIALIZING : UCExecState.IDLE);
     // biome-ignore lint/correctness/useExhaustiveDependencies : must run only once
     useEffect(() => {
         (async () => {
-            if (execState === 'initializing') {
+            if (execState === UCExecState.INITIALIZING) {
                 await onInit?.();
             }
             if (autoExec) {
                 await exec();
             }
             else {
-                setExecState('idle');
+                setExecState(UCExecState.IDLE);
             }
         })();
     }, []);
     const exec = async () => {
         setErrMsg(null);
         setExecRes(null);
-        setExecState('submitting');
+        setExecState(UCExecState.SUBMITTING);
         await onStart?.();
         const confirmed = confirm ? await confirm?.() : true;
         if (!confirmed) {
-            setExecState('idle');
-            setExecRes('aborted');
-            return 'aborted';
+            setExecState(UCExecState.IDLE);
+            setExecRes(UCExecRes.ABORTED);
+            return UCExecRes.ABORTED;
         }
         if (sleepInMs !== undefined) {
             await sleep(sleepInMs);
         }
         try {
             await action();
-            setExecRes('succeeded');
-            return 'succeeded';
+            setExecRes(UCExecRes.SUCCEEDED);
+            return UCExecRes.SUCCEEDED;
         }
         catch (err) {
-            setExecRes('failed');
+            setExecRes(UCExecRes.FAILED);
             if (onError) {
                 await onError?.(err);
             }
             else {
                 setErrMsg(err.message);
             }
-            return 'failed';
+            return UCExecRes.FAILED;
         }
         finally {
-            setExecState('idle');
+            setExecState(UCExecState.IDLE);
         }
     };
     return { errMsg, exec, execRes, execState };

package/dist/esm/target/lib/server/AuthenticationChecker.js

@@ -80,7 +80,7 @@ let AuthenticationChecker = class AuthenticationChecker {
                     }
                     break;
                 default:
-                    ((_) => { })(authType);
+                    authType;
             }
             uc.auth = output.auth;
             const { allowed } = await policy.exec({ uc });

package/dist/esm/target/lib/server/PublicApiKeyChecker.js

@@ -39,7 +39,7 @@ let PublicApiKeyChecker = class PublicApiKeyChecker {
                 }
                 break;
             default:
-                ((_) => { })(checkType);
+                checkType;
         }
         if (!allowed) {
             throw new UnauthorizedError();

package/dist/esm/target/lib/server/ServerRequestHandler.js

@@ -127,7 +127,7 @@ let ServerRequestHandler = class ServerRequestHandler {
                 uc.fill((await req.bodyFromQueryParams()));
                 break;
             default:
-                ((_) => { })(envelope);
+                envelope;
         }
     }
     async applySideEffects(res, ucd, output) {
@@ -154,7 +154,7 @@ let ServerRequestHandler = class ServerRequestHandler {
                     await this.applySetAuthSideEffect(res, item);
                     break;
                 default:
-                    ((_) => { })(type);
+                    (type);
             }
         }
         return { status: undefined };

package/dist/esm/target/lib/server-express/funcs.js

@@ -38,7 +38,7 @@ export function buildHandler(appManifest, ucd, contract, serverRequestHandler, u
                 break;
             }
             default:
-                ((_) => { })(transportType);
+                transportType;
         }
         const { body, status } = await serverRequestHandler.exec({
             appManifest,
@@ -67,7 +67,7 @@ export function buildHandler(appManifest, ucd, contract, serverRequestHandler, u
                 return;
             }
             default:
-                ((_) => { })(transportType);
+                transportType;
         }
     };
     return handler;
@@ -97,8 +97,9 @@ export function mountHandler(contract, express, handler) {
 export function toFile(f) {
     return {
         name: f.name,
-        path: f.tempFilePath,
+        size: f.size,
         type: f.mimetype,
+        uri: f.tempFilePath,
     };
 }
 export function toReq(req) {

package/dist/esm/target/lib/server-hono/funcs.js

@@ -51,7 +51,7 @@ export function buildHandler(appManifest, ucd, contract, serverRequestHandler, u
                 break;
             }
             default:
-                ((_) => { })(transportType);
+                transportType;
         }
         const { body, status } = await serverRequestHandler.exec({
             appManifest,
@@ -80,7 +80,7 @@ export function buildHandler(appManifest, ucd, contract, serverRequestHandler, u
                 });
             }
             default:
-                ((_) => { })(transportType);
+                transportType;
         }
         return c.json(body, status);
     };

package/dist/esm/target/lib/server-node/funcs.js

@@ -23,7 +23,7 @@ export async function stop(server, settingsManager) {
             case 'patient':
                 break;
             default:
-                ((_) => { })(mode);
+                mode;
         }
         server.close((err) => {
             if (err) {

package/dist/esm/target/lib/web/input.d.ts

@@ -34,6 +34,7 @@ export interface HTMLInputDef {
      * @see node_modules/@types/react/index.d.ts `InputHTMLAttributes`
      */
     spec?: {
+        accept?: string | undefined;
         'aria-errormessage'?: string | undefined;
         'aria-invalid'?: boolean | undefined;
         disabled?: boolean | undefined;

package/dist/esm/target/lib/web/input.js

@@ -1,4 +1,4 @@
-import { TBoolean, TNumber, TString, } from '../../../dt/index.js';
+import { TBoolean, TFile, TNumber, TString, } from '../../../dt/index.js';
 import { ucifHint, ucifId, ucifIsMandatory, } from '../../../uc/index.js';
 export function htmlInputDef(field, disabled, errMsg) {
     const def = {
@@ -34,6 +34,10 @@ export function htmlInputDef(field, disabled, errMsg) {
     else if (fType instanceof TBoolean) {
         def.internal.checked = fType.getInitialValue() === true;
     }
+    else if (fType instanceof TFile) {
+        const constraints = fType.getFileConstraints();
+        def.spec.accept = constraints.accept.join(',');
+    }
     if (!(fType instanceof TBoolean)) {
         def.internal.value = fType.getInitialValue()?.toString() || '';
     }

package/dist/esm/target/node-stricli-cli/NodeStricliCLIManager.d.ts

@@ -0,0 +1,12 @@
+import { WordingManager } from '../../i18n/index.js';
+import { type ProductManifest, ProductUCsLoader } from '../../product/index.js';
+import type { CLIManager, Input, Output } from '../lib/cli/CLIManager.js';
+import { CommandExecutor } from '../lib/cli/CommandExecutor.js';
+export declare class NodeStricliCLIManager implements CLIManager {
+    private commandExecutor;
+    private productManifest;
+    private productUCsLoader;
+    private wordingManager;
+    constructor(commandExecutor: CommandExecutor, productManifest: ProductManifest, productUCsLoader: ProductUCsLoader, wordingManager: WordingManager);
+    handleCommand({ appsRootPath, srcImporter, }: Input): Promise<Output>;
+}

package/dist/esm/target/node-stricli-cli/NodeStricliCLIManager.js

@@ -0,0 +1,118 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { buildApplication, buildCommand, buildRouteMap, run, } from '@stricli/core';
+import { inject, injectable } from 'inversify';
+import { WordingManager } from '../../i18n/index.js';
+import { ProductUCsLoader } from '../../product/index.js';
+import { ucifHint, ucifIsMandatory, ucifRepeatability, ucMountingPoint, } from '../../uc/index.js';
+import { CommandExecutor } from '../lib/cli/CommandExecutor.js';
+let NodeStricliCLIManager = class NodeStricliCLIManager {
+    commandExecutor;
+    productManifest;
+    productUCsLoader;
+    wordingManager;
+    constructor(commandExecutor, productManifest, productUCsLoader, wordingManager) {
+        this.commandExecutor = commandExecutor;
+        this.productManifest = productManifest;
+        this.productUCsLoader = productUCsLoader;
+        this.wordingManager = wordingManager;
+    }
+    async handleCommand({ appsRootPath, srcImporter, }) {
+        const ucs = await this.productUCsLoader.exec({
+            appsRootPath,
+            srcImporter,
+        });
+        const routes = {};
+        for (const uc of ucs) {
+            const mountingPoint = uc.def.ext?.cmd?.mountAt ?? ucMountingPoint(uc);
+            routes[mountingPoint] = buildCommand({
+                docs: {
+                    brief: this.wordingManager.uc(uc.def).desc ?? '',
+                },
+                func: async (flags) => {
+                    uc.fill(flags);
+                    await this.commandExecutor.exec({ uc });
+                },
+                parameters: {
+                    flags: {},
+                },
+            });
+            const { flags } = routes[mountingPoint].parameters;
+            if (!flags) {
+                throw new Error('Init the flags first');
+            }
+            for (const f of this.commandExecutor.fieldsForFlags(uc)) {
+                const { def } = f;
+                const { desc, label } = this.wordingManager.ucif(f);
+                const brief = desc ?? label;
+                const defaultValue = def.type.getDefaultValue();
+                const [isRepeatable, _max] = ucifRepeatability(def);
+                const options = def.type.getOptions();
+                const hasOptions = options && options.length > 0;
+                const hint = ucifHint(def);
+                const common = {
+                    brief,
+                    default: defaultValue,
+                    optional: !ucifIsMandatory(def),
+                    placeholder: hint ?? '',
+                    variadic: isRepeatable,
+                };
+                if (hasOptions) {
+                    flags[f.key] = {
+                        ...common,
+                        kind: 'enum',
+                        values: options?.map((o) => o.value),
+                    };
+                }
+                else {
+                    flags[f.key] = {
+                        ...common,
+                        kind: 'parsed',
+                        parse: (raw) => {
+                            def.type.assign(raw);
+                            const val = def.type.val();
+                            def.type.clear();
+                            return val;
+                        },
+                    };
+                }
+            }
+        }
+        const { desc, slogan } = this.wordingManager.p();
+        const root = buildRouteMap({
+            docs: {
+                brief: desc ?? slogan ?? '',
+            },
+            routes,
+        });
+        const app = buildApplication(root, {
+            name: this.productManifest.name,
+            versionInfo: {
+                currentVersion: await this.commandExecutor.version(),
+            },
+        });
+        await run(app, process.argv.slice(2), {
+            process: process,
+        });
+    }
+};
+NodeStricliCLIManager = __decorate([
+    injectable(),
+    __param(0, inject(CommandExecutor)),
+    __param(1, inject('ProductManifest')),
+    __param(2, inject(ProductUCsLoader)),
+    __param(3, inject(WordingManager)),
+    __metadata("design:paramtypes", [CommandExecutor, Object, ProductUCsLoader,
+        WordingManager])
+], NodeStricliCLIManager);
+export { NodeStricliCLIManager };

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

@@ -7,6 +7,7 @@ import { useStyleContext } from '../lib/react/StyleContextProvider.js';
 import { UCFormFieldControl } from './UCFormFieldControl.js';
 import { UCFormFieldDesc } from './UCFormFieldDesc.js';
 import { UCFormFieldErr } from './UCFormFieldErr.js';
+import { UCFormFieldHelp } from './UCFormFieldHelp.js';
 import { UCFormFieldLabel } from './UCFormFieldLabel.js';
 export function UCFormField({ disabled, execState, f, only, }) {
     const { i18nManager } = useDIContext();
@@ -16,5 +17,5 @@ export function UCFormField({ disabled, execState, f, only, }) {
         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 })] }));
+    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('desc') && _jsx(UCFormFieldDesc, { f: f }), elements.includes('help') && _jsx(UCFormFieldHelp, { f: f }), elements.includes('err') && _jsx(UCFormFieldErr, { errMsg: errMsg })] }));
 }

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

@@ -1,7 +1,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 { TBoolean, TFile } from '../../dt/index.js';
 import { ucifRepeatability } from '../../uc/index.js';
 import { isBlank } from '../../utils/index.js';
 import { styleDef, useStyleContext, } from '../lib/react/StyleContextProvider.js';
@@ -11,7 +11,7 @@ const MULTIPLE_VALUES_SEPARATOR = ',';
 export function UCFormFieldControl({ disabled, errMsg = null, execState, f, onChange: onChangeBase, }) {
     const { colors, formFieldControl, renderFormFieldControl } = useStyleContext();
     const [internalValue, setInternalValue] = useState(f.getValue());
-    // biome-ignore lint/correctness/useExhaustiveDependencies: false positive : It is actually necessary (only `f` does not trigger the effect)
+    // biome-ignore lint/correctness/useExhaustiveDependencies: It is actually necessary because only `f` or `f.getValue` does not trigger the effect
     useEffect(() => {
         setInternalValue(f.getValue());
     }, [f.getValue()]);
@@ -25,6 +25,10 @@ export function UCFormFieldControl({ disabled, errMsg = null, execState, f, onCh
     if (component) {
         return component;
     }
+    const { type } = f.def;
+    if (type instanceof TFile) {
+        return (_jsx(Text, { style: { color: 'red' }, children: "Generic file picker not available in RN" }));
+    }
     const onChangeText = (value) => {
         const [isRepeatable] = ucifRepeatability(f.def);
         if (isRepeatable && typeof value === 'string') {
@@ -58,7 +62,6 @@ export function UCFormFieldControl({ disabled, errMsg = null, execState, f, onCh
         setInternalValue(value);
     };
     const attrs = rnInputDef(f, disabled, errMsg);
-    const { type } = f.def;
     const options = type.getOptions();
     if (options) {
         // TODO : Handle type.hasStrictOptions() => display an input text alongside the options
@@ -72,7 +75,6 @@ export function UCFormFieldControl({ disabled, errMsg = null, execState, f, onCh
                     },
                 ], children: _jsx(Text, { children: item.label }) })), showsHorizontalScrollIndicator: false, style: styles.select }));
     }
-    // TODO : Implement picker for TFile (requires a dependency...)
     if (type instanceof TBoolean) {
         const { style } = styleDef(formFieldControl, 'Switch');
         return (_jsx(Switch, { disabled: !attrs.spec?.editable, onValueChange: onValueChange, style: style, trackColor: { true: colors?.primary }, value: internalValue }));

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

@@ -1,3 +1,3 @@
 import type { ReactElement } from 'react';
 import type { UCFormFieldErrProps } from '../lib/react/form.js';
-export declare function UCFormFieldErr({ errMsg }: UCFormFieldErrProps): ReactElement;
+export declare function UCFormFieldErr({ errMsg, }: UCFormFieldErrProps): ReactElement | null;

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

@@ -1,7 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Text } from 'react-native';
 import { useStyleContext } from '../lib/react/StyleContextProvider.js';
-export function UCFormFieldErr({ errMsg }) {
+export function UCFormFieldErr({ errMsg, }) {
     const { formFieldErr } = useStyleContext();
+    if (!errMsg) {
+        return null;
+    }
     return _jsx(Text, { style: formFieldErr?.style, children: errMsg });
 }

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

@@ -0,0 +1,4 @@
+import type { ReactElement } from 'react';
+import type { DataType } from '../../dt/index.js';
+import type { UCFormFieldDescProps } from '../lib/react/form.js';
+export declare function UCFormFieldHelp<T extends DataType>({ f, }: UCFormFieldDescProps<T>): ReactElement | null;

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

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from 'react-native';
+import { useDIContext } from '../../index.react.js';
+import { useStyleContext } from '../lib/react/StyleContextProvider.js';
+export function UCFormFieldHelp({ f, }) {
+    const { wordingManager } = useDIContext();
+    const { formFieldHelp } = useStyleContext();
+    const { def: { type }, } = f;
+    const parts = wordingManager.dtConstr(type);
+    if (!parts) {
+        return null;
+    }
+    const text = parts.join(' - ');
+    return _jsx(Text, { style: formFieldHelp?.style, children: text });
+}

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

@@ -6,6 +6,7 @@ import { useStyleContext } from '../lib/react/StyleContextProvider.js';
 import { UCFormFieldControl } from './UCFormFieldControl.js';
 import { UCFormFieldDesc } from './UCFormFieldDesc.js';
 import { UCFormFieldErr } from './UCFormFieldErr.js';
+import { UCFormFieldHelp } from './UCFormFieldHelp.js';
 import { UCFormFieldLabel } from './UCFormFieldLabel.js';
 export function UCFormField({ disabled, execState, f, only, }) {
     const { i18nManager } = useDIContext();
@@ -15,5 +16,5 @@ export function UCFormField({ disabled, execState, f, only, }) {
         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 })] }));
+    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('desc') && _jsx(UCFormFieldDesc, { f: f }), elements.includes('help') && _jsx(UCFormFieldHelp, { f: f }), elements.includes('err') && _jsx(UCFormFieldErr, { errMsg: errMsg })] }));
 }

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

@@ -1,3 +1,3 @@
 import type { ReactElement } from 'react';
 import type { UCFormFieldErrProps } from '../lib/react/form.js';
-export declare function UCFormFieldErr({ errMsg }: UCFormFieldErrProps): ReactElement;
+export declare function UCFormFieldErr({ errMsg, }: UCFormFieldErrProps): ReactElement | null;

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

@@ -1,6 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useStyleContext } from '../lib/react/StyleContextProvider.js';
-export function UCFormFieldErr({ errMsg }) {
+export function UCFormFieldErr({ errMsg, }) {
     const { formFieldErr } = useStyleContext();
+    if (!errMsg) {
+        return null;
+    }
     return (_jsx("div", { className: formFieldErr?.className, style: formFieldErr?.style, children: errMsg }));
 }

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

@@ -0,0 +1,4 @@
+import type { ReactElement } from 'react';
+import type { DataType } from '../../dt/index.js';
+import type { UCFormFieldDescProps } from '../lib/react/form.js';
+export declare function UCFormFieldHelp<T extends DataType>({ f, }: UCFormFieldDescProps<T>): ReactElement | null;

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

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useDIContext } from '../../index.react.js';
+import { useStyleContext } from '../lib/react/StyleContextProvider.js';
+export function UCFormFieldHelp({ f, }) {
+    const { wordingManager } = useDIContext();
+    const { formFieldHelp } = useStyleContext();
+    const { def: { type }, } = f;
+    const parts = wordingManager.dtConstr(type);
+    if (!parts) {
+        return null;
+    }
+    const text = parts.join(' - ');
+    return (_jsx("div", { className: formFieldHelp?.className, style: formFieldHelp?.style, children: text }));
+}

package/dist/esm/testing/AppTester.js

@@ -12,7 +12,6 @@ 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, 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.
@@ -88,9 +87,13 @@ let AppTester = class AppTester {
         }
     }
     async checkAppI18n() {
+        if (!this.ucDefSourcesCheckerOutput) {
+            throw new Error('checkUCDSources must be called before checkAppI18n');
+        }
         const { errors } = await this.appI18nChecker.exec({
             appI18n: this.ctx.appI18n,
             appManifest: this.ctx.appManifest,
+            ucDefSourcesCheckerOutput: this.ucDefSourcesCheckerOutput,
         });
         if (errors.length > 0) {
             throw new Error(errors[0]);
@@ -302,15 +305,11 @@ let AppTester = class AppTester {
         const appLangCodes = Object.keys(appI18n);
         const coreI18n = {
             en: I18nEN,
-            fr: I18nFR,
         };
         const productI18n = {
             en: {
                 ...I18nEN,
             },
-            fr: {
-                ...I18nFR,
-            },
         };
         for (const l of appLangCodes) {
             if (!(l in coreI18n)) {

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

@@ -1,21 +1,39 @@
 import type { ErrorMessage, FilePath } from '../dt/index.js';
 import type { UCDefLifecycle, UCMetadata, UCOutputPartIdx } from '../uc/index.js';
 import type { AppTesterOptsAllSet } from './opts.js';
-export interface OutputItemField<T extends string = string> {
+export interface OutputItemField<T = string> {
     err: ErrorMessage | null;
     value: T;
 }
+export type OutputItemFieldIOField = OutputItemField<{
+    /**
+     * @example `FreeTextShort`
+     */
+    dataType: string | null;
+    /**
+     * @example `name`
+     */
+    name: string | null;
+    /**
+     * @example `name: UCInputField<FreeTextShort>`
+     */
+    raw: string | null;
+    /**
+     * @example `UCInputField<FreeTextShort>`
+     */
+    type: string | null;
+}>;
 export interface OutputItem {
     constName: OutputItemField | null;
     externalImports: OutputItemField[] | null;
     filePath: OutputItemField | null;
     internalImports: OutputItemField[] | null;
     ioI: OutputItemField | null;
-    ioIFields: OutputItemField[] | null;
+    ioIFields: OutputItemFieldIOField[] | null;
     ioOPI0: OutputItemField | null;
-    ioOPI0Fields: OutputItemField[] | null;
+    ioOPI0Fields: OutputItemFieldIOField[] | null;
     ioOPI1: OutputItemField | null;
-    ioOPI1Fields: OutputItemField[] | null;
+    ioOPI1Fields: OutputItemFieldIOField[] | null;
     lifecycleClientPolicy: OutputItemField | null;
     lifecycleClientSteps: OutputItemField[] | null;
     lifecycleServerPolicy: OutputItemField | null;
@@ -29,10 +47,10 @@ export interface OutputItem {
 }
 export declare const OUTPUT_ITEM_FIELDS: (keyof OutputItem)[];
 export type OnImport = (name: string) => void;
-export type OnInputType = (name: string, fields: OutputItemField[]) => void;
+export type OnInputType = (name: string, fields: OutputItemFieldIOField[]) => void;
 export type OnMainStep = (lifecycle: UCDefLifecycle, step: string) => void;
 export type OnMetadata = (metadata: UCMetadata) => void;
-export type OnOPIType = (name: string, fields: OutputItemField[], idx: UCOutputPartIdx) => void;
+export type OnOPIType = (name: string, fields: OutputItemFieldIOField[], idx: UCOutputPartIdx) => void;
 export type OnPolicy = (lifecycle: UCDefLifecycle, name: string) => void;
 export type OnVariable = (name: string) => void;
 export interface UCDefASTParser {

package/dist/esm/testing/impl/SimpleAppDocsEmitter/SimpleAppDocsEmitter.d.ts

@@ -0,0 +1,7 @@
+import type { FSManager } from '../../../std/index.js';
+import type { AppDocsEmitter, Input, Output } from '../../workers/AppDocsEmitter.js';
+export declare class SimpleAppDocsEmitter implements AppDocsEmitter {
+    private fsManager;
+    constructor(fsManager: FSManager);
+    exec({ appPath, ucDefSourcesCheckerOutput, }: Input): Promise<Output>;
+}

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

@@ -0,0 +1,59 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from 'inversify';
+import { APP_DOCS_FILE_NAME } from '../../../convention.js';
+import { techSummary } from './tech-summary.js';
+import { ucSummary } from './uc-summary.js';
+let SimpleAppDocsEmitter = class SimpleAppDocsEmitter {
+    fsManager;
+    constructor(fsManager) {
+        this.fsManager = fsManager;
+    }
+    async exec({ appPath, ucDefSourcesCheckerOutput, }) {
+        const outPath = this.fsManager.path(appPath, APP_DOCS_FILE_NAME);
+        const tpl = template(ucDefSourcesCheckerOutput.items);
+        await this.fsManager.touch(outPath, tpl);
+        return {
+            outPath,
+        };
+    }
+};
+SimpleAppDocsEmitter = __decorate([
+    injectable(),
+    __param(0, inject('FSManager')),
+    __metadata("design:paramtypes", [Object])
+], SimpleAppDocsEmitter);
+export { SimpleAppDocsEmitter };
+// For now, we can have it here. When it becomes harder to maintain, we can introduce some kind of template engine.
+// Be aware that this will introduce complexities on building the lib.
+// We'll need to include these templates in the build and make them accessible via package.json "exports" or any other mechanism.
+// Hence the choice to keep it simple for now.
+// Defined it as function in case we need to pass args.
+// Using --- for the comment to make it compatible with pandoc
+// See https://stackoverflow.com/a/4829998/1259118
+const template = (items) => `<!---
+    All this code has been auto generated.
+    DO NOT EDIT.
+    Or be prepared to see all your changes erased at the next generation.
+-->
+
+# App
+
+## Use Cases
+
+${items.map(ucSummary).join('\n\n')}
+
+## Technical Summary
+
+${techSummary(items)}
+`;

package/dist/esm/testing/impl/SimpleAppDocsEmitter/markdown.d.ts

@@ -0,0 +1,2 @@
+export declare function pre(val: string | null | undefined): string;
+export declare function thead(cols: string[]): string;