libmodulor 0.24.0 → 0.25.0

package/dist/esm/std/FSManager.js

@@ -1,6 +1,5 @@
-export var FSManagerItemInfoType;
-(function (FSManagerItemInfoType) {
-    FSManagerItemInfoType["DIR"] = "DIR";
-    FSManagerItemInfoType["FILE"] = "FILE";
-    FSManagerItemInfoType["OTHER"] = "OTHER";
-})(FSManagerItemInfoType || (FSManagerItemInfoType = {}));
+export const FSManagerItemInfoType = {
+    DIR: 'DIR',
+    FILE: 'FILE',
+    OTHER: 'OTHER',
+};

package/dist/esm/std/FormDataBuilder.d.ts

@@ -1,5 +1,6 @@
-import type { FileMimeType, FilePath } from '../dt/index.js';
+import type { FileMimeType, FileName, FilePath } from '../dt/index.js';
 export interface BlobLike {
+    name: FileName;
     type: FileMimeType;
     uri: FilePath;
 }

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

@@ -94,15 +94,16 @@ let NodeFSManager = class NodeFSManager {
         }
         switch (source) {
             case 'path': {
-                const { base: name, mimeType: type } = await this.info(path);
+                const { base: name, mimeType: type, size, } = await this.info(path);
                 if (!type) {
                     return [];
                 }
                 return [
                     {
                         name,
-                        path,
+                        size,
                         type,
+                        uri: path,
                     },
                 ];
             }

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

@@ -18,6 +18,7 @@ export interface StyleContextT {
     formField?: StyleDef | undefined;
     formFieldControl?: Record<SelectiveStyleDefKey, StyleDef | undefined>;
     formFieldDesc?: StyleDef | undefined;
+    formFieldHelp?: StyleDef | undefined;
     formFieldErr?: StyleDef | undefined;
     formFieldLabel?: StyleDef | undefined;
     formSubmitControl?: StyleDef | undefined;

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

@@ -18,7 +18,7 @@ export interface UCFormFieldErrProps {
 export interface UCFormFieldLabelProps<T extends DataType> {
     f: UCInputField<T>;
 }
-export declare const UC_FORM_FIELD_ELEMENTS: readonly ["control", "desc", "err", "label"];
+export declare const UC_FORM_FIELD_ELEMENTS: readonly ["control", "desc", "err", "help", "label"];
 export type UCFormFieldElement = (typeof UC_FORM_FIELD_ELEMENTS)[number];
 export type UCFormFieldProps<T extends DataType> = Omit<UCFormFieldControlProps<T>, 'onChange'> & {
     only?: UCFormFieldElement[];

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

@@ -3,6 +3,7 @@ export const UC_FORM_FIELD_ELEMENTS = [
     'control',
     'desc',
     'err',
+    'help',
     'label',
 ];
 export function validateFormField(i18nManager, f) {

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

@@ -1,5 +1,5 @@
 import type { ErrorMessage, UIntDuration } from '../../../dt/index.js';
-import type { UCExecRes, UCExecState } from '../../../uc/index.js';
+import { UCExecRes, UCExecState } from '../../../uc/index.js';
 export type UseActionAction = () => Promise<void>;
 export type UseActionConfirm = () => Promise<boolean>;
 export type UseActionExec = () => Promise<UCExecRes>;

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-express/funcs.js

@@ -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/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/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/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;

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

@@ -0,0 +1,10 @@
+export function pre(val) {
+    if (!val) {
+        return '-';
+    }
+    return `\`${val}\``;
+}
+export function thead(cols) {
+    return `|#|${cols.join('|')}|
+|---|${cols.map(() => '---').join('|')}|`;
+}

package/dist/esm/testing/impl/SimpleAppDocsEmitter/sequence-diagram.d.ts

@@ -0,0 +1,2 @@
+import type { OutputItem } from '../../UCDefASTParser.js';
+export declare function ucSequenceDiagram(item: OutputItem): string;

package/dist/esm/testing/impl/SimpleAppDocsEmitter/sequence-diagram.js

@@ -0,0 +1,92 @@
+import { UC_MAIN_STEP_PREFIX_REGULAR } from '../../../convention.js';
+const CHECK_POLICY = '🔐 Check policy';
+const CHECK_POLICY_COND = 'when any validation fails';
+const CHECK_POLICY_COND_ACTION = 'show failure';
+const CLIENT_CONFIRM_N_COND = 'when does not confirm';
+const CLIENT_CONFIRM_N_COND_ACTION = 'stop everything';
+const CLIENT_CONFIRM_Q = '❓ Sure';
+const CLIENT_CONFIRM_Y = 'Yes';
+const FILL = '✏️ Fill';
+const LB = '<br/>';
+const OK = '👍 OK';
+const SEND = '📤 Send';
+const SUBMIT = '↩️ Submit';
+const TRIGGER = '⤴️ Trigger';
+export function ucSequenceDiagram(item) {
+    // Debugger : https://mermaid.live/edit
+    // Messages : https://mermaid.js.org/syntax/sequenceDiagram.html#messages
+    const client = 'Client';
+    const server = 'Server';
+    const user = 'User';
+    const lines = [`actor ${user}`];
+    const { ioIFields, ioOPI0Fields, ioOPI1Fields, lifecycleClientPolicy, lifecycleClientSteps, lifecycleServerPolicy, lifecycleServerSteps, metadataSensitive, } = item;
+    let req = TRIGGER;
+    if (ioIFields && ioIFields.length > 0) {
+        // TODO : Include only fields to fill manually ?
+        // Not sure though, as for CLI for example (i.e. noContext), one needs to provide all of them
+        req = `${FILL}${LB}${fields(item.ioIFields)}`;
+    }
+    lines.push(`${user}->>+${client}: ${req}`);
+    lines.push(`${user}->>${client}: ${SUBMIT}`);
+    if (metadataSensitive?.value) {
+        lines.push(...clientConfirm(client, user));
+    }
+    if (lifecycleClientPolicy) {
+        lines.push(...policy(client, user, lifecycleClientPolicy));
+    }
+    if (lifecycleClientSteps) {
+        lines.push(...mainSteps(client, lifecycleClientSteps));
+    }
+    // This is an approximation. Might need to improve it.
+    const hasServer = item.lifecycleServerPolicy?.value;
+    if (hasServer) {
+        req = SEND;
+        if (ioIFields && ioIFields.length > 0) {
+            req = `${req}${LB}${fields(item.ioIFields)}`;
+        }
+        lines.push(`${client}->>+${server}: ${req}`);
+        if (lifecycleServerPolicy) {
+            lines.push(...policy(server, user, lifecycleServerPolicy));
+        }
+        if (lifecycleServerSteps) {
+            lines.push(...mainSteps(server, lifecycleServerSteps));
+        }
+        let res = '';
+        if (ioOPI0Fields && ioOPI0Fields.length > 0) {
+            res += `${res}${LB}${fields(item.ioOPI0Fields)}`;
+        }
+        if (ioOPI1Fields && ioOPI1Fields?.length > 0) {
+            res += `${res}${LB}${fields(item.ioOPI1Fields)}`;
+        }
+        lines.push(`${server}-->>-${client}: ${OK}${res}`);
+    }
+    lines.push(`${client}-->>-${user}: ${OK}`);
+    return `\`\`\`mermaid
+sequenceDiagram
+    ${lines.join('\n    ')}
+\`\`\``;
+}
+function clientConfirm(participant, caller) {
+    return [
+        `${participant}->>${caller}: ${CLIENT_CONFIRM_Q}`,
+        `${caller}->>${participant}: ${CLIENT_CONFIRM_Y}`,
+        `break ${CLIENT_CONFIRM_N_COND}`,
+        `    ${participant}-->${caller}: ${CLIENT_CONFIRM_N_COND_ACTION}`,
+        'end',
+    ];
+}
+function fields(fields) {
+    return (fields?.map((f) => `${f.value.name}: ${f.value.dataType}`).join(LB) ||
+        '');
+}
+function mainSteps(participant, field) {
+    return field.map((f) => `${participant}->>${participant}: ${f.value.replace(UC_MAIN_STEP_PREFIX_REGULAR, '').trim()}`);
+}
+function policy(participant, caller, lifecyclePolicyField) {
+    return [
+        `${participant}->>${participant}: ${CHECK_POLICY} "${lifecyclePolicyField.value}"`,
+        `break ${CHECK_POLICY_COND}`,
+        `    ${participant}-->${caller}: ${CHECK_POLICY_COND_ACTION}`,
+        'end',
+    ];
+}

package/dist/esm/testing/impl/SimpleAppDocsEmitter/tech-summary.d.ts

@@ -0,0 +1,2 @@
+import { type OutputItem } from '../../UCDefASTParser.js';
+export declare function techSummary(items: OutputItem[]): string;

package/dist/esm/testing/impl/SimpleAppDocsEmitter/tech-summary.js

@@ -0,0 +1,27 @@
+import { OUTPUT_ITEM_FIELDS, } from '../../UCDefASTParser.js';
+import { thead } from './markdown.js';
+export function techSummary(items) {
+    return `${thead(OUTPUT_ITEM_FIELDS)}
+${items
+        .map((item, idx) => ['', idx + 1, ...OUTPUT_ITEM_FIELDS.map((f) => val(item[f])), ''].join('|'))
+        .join('\n')}`;
+}
+function val(value) {
+    if (!value) {
+        return '';
+    }
+    const values = Array.isArray(value) ? value : [value];
+    // NOTE : <br> won't work for every markdown renderer.
+    // See https://stackoverflow.com/questions/11700487/how-do-i-add-a-newline-in-a-markdown-table
+    return values.map(fmtVal).join('<br>');
+}
+function fmtVal(field) {
+    const { err, value } = field;
+    let res = (typeof value === 'string' ? value : value.raw) ?? '';
+    if (err) {
+        res += `❌ ${err}`;
+    }
+    res = res.replace(/[\u00A0-\u9999<>&]/g, (i) => `&#${i.charCodeAt(0)};`); // TS generics considered as HTML
+    res = res.replaceAll('|', '\\|'); // TS intersection vs Markdown table column
+    return res;
+}

package/dist/esm/testing/impl/SimpleAppDocsEmitter/uc-summary.d.ts

@@ -0,0 +1,2 @@
+import type { OutputItem } from '../../UCDefASTParser.js';
+export declare function ucSummary(item: OutputItem): string;

package/dist/esm/testing/impl/SimpleAppDocsEmitter/uc-summary.js

@@ -0,0 +1,63 @@
+import { humanize } from '../../../utils/index.js';
+import { pre, thead } from './markdown.js';
+import { ucSequenceDiagram } from './sequence-diagram.js';
+export function ucSummary(item) {
+    return `### ${item.metadataName?.value}
+
+${lifecycle(item)}
+
+${fields(item)}
+
+#### Sequence Diagram
+
+${ucSequenceDiagram(item)}`;
+}
+const UC_FIELDS_TABLES_COLS = ['name', 'humanized', 'dataType'];
+function fields(item) {
+    const { ioIFields, ioOPI0Fields, ioOPI1Fields } = item;
+    return `#### Input (I)
+
+${ucFieldsTable(ioIFields)}
+
+#### Output (O)
+
+##### Part 0 (OPI0)
+
+${ucFieldsTable(ioOPI0Fields)}
+
+##### Part 1 (OPI1)
+
+${ucFieldsTable(ioOPI1Fields)}`;
+}
+function ucFieldsTable(fields) {
+    if (!fields || fields.length === 0) {
+        return 'None';
+    }
+    return `${thead(UC_FIELDS_TABLES_COLS)}
+${fields
+        ?.map(({ value: { dataType, name } }, idx) => [
+        '',
+        idx + 1,
+        pre(name),
+        name ? humanize(name) : '',
+        pre(dataType),
+        '',
+    ].join('|'))
+        .join('\n')}`;
+}
+function lifecycle(item) {
+    const { lifecycleClientPolicy, lifecycleServerPolicy } = item;
+    return `- **Type** : ${pre(lifecycleType(item))}
+- **Client Policy** : ${pre(lifecycleClientPolicy?.value)}
+- **Server Policy** : ${pre(lifecycleServerPolicy?.value)}`;
+}
+function lifecycleType(item) {
+    const { lifecycleClientPolicy, lifecycleServerPolicy } = item;
+    if (lifecycleClientPolicy && lifecycleServerPolicy) {
+        return 'Client / Server';
+    }
+    if (lifecycleClientPolicy) {
+        return 'Client only';
+    }
+    return 'Server only';
+}

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

@@ -10,7 +10,7 @@ import { bindNodeCore } from '../../utils/ioc/bindNodeCore.js';
 import { bindServer } from '../../utils/ioc/bindServer.js';
 import { AppTester } from '../AppTester.js';
 import { optsAllSet } from '../opts.js';
-import { SimpleAppDocsEmitter } from './SimpleAppDocsEmitter.js';
+import { SimpleAppDocsEmitter } from './SimpleAppDocsEmitter/SimpleAppDocsEmitter.js';
 import { TypeScriptLibUCDefASTParser } from './TypeScriptLibUCDefASTParser.js';
 export async function newNodeAppTester(serverPortRangeStart, idx, args) {
     const { configurator } = args;