@inseefr/lunatic 3.6.14 → 3.6.15-rc.1

package/esm/utils/getArticulationState.js

@@ -0,0 +1,82 @@
+import { reducerInitializer } from '../use-lunatic/reducer/reducerInitializer';
+import { times } from './array';
+import { forceInt } from './number';
+export var ArticulationState;
+(function (ArticulationState) {
+    ArticulationState[ArticulationState["COMPLETED"] = 1] = "COMPLETED";
+    ArticulationState[ArticulationState["STARTED"] = 0] = "STARTED";
+    ArticulationState[ArticulationState["NOT_STARTED"] = -1] = "NOT_STARTED";
+})(ArticulationState || (ArticulationState = {}));
+/**
+ * Retrieve the articulation state
+ *
+ * The goal of this function is to provide insights about a roundabout using extra information inserted in the JSON source
+ * provided to Lunatic.
+ *
+ * For instance
+ *
+ * ```
+ *  "articulation": {
+ *    "source": "roundabout",
+ *    "items": [
+ *      {
+ *        "label": "Prénom",
+ *        "value": "PRENOMS"
+ *      },
+ *      {
+ *        "label": "Sexe",
+ *        "value": "if SEXE = \"H\" then \"Homme\" else \"Femme\""
+ *      },
+ *      {
+ *        "label": "Age",
+ *        "value": "cast(AGE, string) || \" ans\""
+ *      }
+ *    ]
+ *  },
+ * ```
+ *
+ * - source is the ID of the roundabout component
+ * - items define the field to extract from the roundabout data
+ */
+export function getArticulationState(source, data) {
+    var _a;
+    const roundabout = findComponentById(source.components, source.articulation.source);
+    const { variables } = reducerInitializer({ source, data });
+    const iterations = forceInt(variables.run((_a = roundabout === null || roundabout === void 0 ? void 0 : roundabout.iterations.value) !== null && _a !== void 0 ? _a : '0'));
+    const rows = times(iterations, (k) => source.articulation.items.map((item) => ({
+        label: item.label,
+        value: variables.run(item.value, { iteration: [k] }),
+    })));
+    if (!roundabout) {
+        return {
+            items: [],
+        };
+    }
+    return {
+        items: rows.map((row, k) => {
+            var _a;
+            return ({
+                cells: row,
+                progress: forceInt((_a = variables.get(roundabout.progressVariable, [k])) !== null && _a !== void 0 ? _a : ArticulationState.NOT_STARTED),
+                page: (roundabout.page
+                    ? `${roundabout.page}.1#${k + 1}`
+                    : '1'),
+            });
+        }),
+    };
+}
+export function findComponentById(components, id) {
+    for (const c of components) {
+        if ('id' in c && c.id === id && c.componentType === 'Roundabout') {
+            return c;
+        }
+        if ('components' in c) {
+            const child = findComponentById(c.components, id);
+            if (child) {
+                return child;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=getArticulationState.js.map

package/esm/utils/getArticulationState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getArticulationState.js","sourceRoot":"","sources":["../../src/utils/getArticulationState.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE/E,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC5B,mEAAa,CAAA;IACb,+DAAW,CAAA;IACX,wEAAgB,CAAA;AACjB,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,oBAAoB,CACnC,MAAsD,EACtD,IAAiB;;IAEjB,MAAM,UAAU,GAAG,iBAAiB,CACnC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,YAAY,CAAC,MAAM,CAC1B,CAAC;IACF,MAAM,EAAE,SAAS,EAAE,GAAG,kBAAkB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,QAAQ,CAC1B,SAAS,CAAC,GAAG,CAAC,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,UAAU,CAAC,KAAK,mCAAI,GAAG,CAAC,CAClD,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CACpC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAc;KACjE,CAAC,CAAC,CACH,CAAC;IAEF,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO;YACN,KAAK,EAAE,EAAE;SACT,CAAC;IACH,CAAC;IAED,OAAO;QACN,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;;YAAC,OAAA,CAAC;gBAC5B,KAAK,EAAE,GAAG;gBACV,QAAQ,EAAE,QAAQ,CACjB,MAAA,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,mCAC9C,iBAAiB,CAAC,WAAW,CAC9B;gBACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI;oBACrB,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE;oBACjC,CAAC,CAAC,GAAG,CAAY;aAClB,CAAC,CAAA;SAAA,CAAC;KACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,UAAiC,EACjC,EAAU;IAEV,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,aAAa,KAAK,YAAY,EAAE,CAAC;YAClE,OAAO,CAAC,CAAC;QACV,CAAC;QACD,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAClD,IAAI,KAAK,EAAE,CAAC;gBACX,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/hooks/useMultimode.d.ts

@@ -0,0 +1,49 @@
+import type { LunaticVariablesStore } from '../use-lunatic/commons/variables/lunatic-variables-store';
+import type { LunaticSource } from '../type.source';
+/**
+ * Retrieve the multimode state
+ *
+ * ## Why this hook
+ *
+ * The goal of this hook is to provide insights about a roundabout using extra information inserted in the JSON source
+ * provided to Lunatic.
+ *
+ * For instance
+ *
+ * ```
+ * {
+ *    "multimode": {
+ *         "questionnaire": {
+ *             "rules": {
+ *                 "IS_MOVED": {
+ *                     "type": "VTL",
+ *                     "value": "nvl(HABITEZ_VOUS_ICI, true)"
+ *                 },
+ *             }
+ *         },
+ *         "leaf": {
+ *             "source": "id-roundabout-in-questionnaire",
+ *             "rules": {
+ *                 "IS_MOVED": {
+ *                     "type": "VTL",
+ *                     "value": "nvl(PRENOM_HABITE_PLUS_LA, false)"
+ *                 },
+ *             }
+ *         }
+ *     },
+ * }
+ * ```
+ *
+ * Run the expression to check if rules are true or false. A rule is considered as true if at least one expression is evaluated to true
+ *
+ * ```
+ * {
+ * 		"IS_MOVED": true
+ * }
+ * ```
+ */
+export declare function useMultimode(source: LunaticSource, store: LunaticVariablesStore): {
+    getMultimode: () => {
+        [k: string]: boolean;
+    };
+};

package/hooks/useMultimode.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useMultimode = useMultimode;
+const react_1 = require("react");
+const getArticulationState_1 = require("../utils/getArticulationState");
+const number_1 = require("../utils/number");
+/**
+ * Retrieve the multimode state
+ *
+ * ## Why this hook
+ *
+ * The goal of this hook is to provide insights about a roundabout using extra information inserted in the JSON source
+ * provided to Lunatic.
+ *
+ * For instance
+ *
+ * ```
+ * {
+ *    "multimode": {
+ *         "questionnaire": {
+ *             "rules": {
+ *                 "IS_MOVED": {
+ *                     "type": "VTL",
+ *                     "value": "nvl(HABITEZ_VOUS_ICI, true)"
+ *                 },
+ *             }
+ *         },
+ *         "leaf": {
+ *             "source": "id-roundabout-in-questionnaire",
+ *             "rules": {
+ *                 "IS_MOVED": {
+ *                     "type": "VTL",
+ *                     "value": "nvl(PRENOM_HABITE_PLUS_LA, false)"
+ *                 },
+ *             }
+ *         }
+ *     },
+ * }
+ * ```
+ *
+ * Run the expression to check if rules are true or false. A rule is considered as true if at least one expression is evaluated to true
+ *
+ * ```
+ * {
+ * 		"IS_MOVED": true
+ * }
+ * ```
+ */
+function useMultimode(source, store) {
+    const getMultimode = (0, react_1.useCallback)(() => {
+        if (!source.multimode) {
+            return {};
+        }
+        const roundabout = (0, getArticulationState_1.findComponentById)(source.components, source.multimode.leaf.source);
+        const keys = new Set([
+            ...Object.keys(source.multimode.questionnaire.rules),
+            ...Object.keys(source.multimode.leaf.rules),
+        ]);
+        const iterations = (0, number_1.forceInt)(store.run(roundabout?.iterations.value ?? '0'));
+        return Object.fromEntries(Array.from(keys).map((key) => {
+            // Check the value at questionnaire level
+            const questionnaireExpression = source.multimode?.questionnaire.rules[key];
+            if (questionnaireExpression &&
+                store.run(questionnaireExpression.value)) {
+                return [key, true];
+            }
+            const leafExpression = source.multimode?.leaf.rules[key];
+            // There is no expression for the leaf
+            if (!leafExpression) {
+                return [key, false];
+            }
+            for (let i = 0; i < iterations; i++) {
+                if (store.run(leafExpression.value, { iteration: [i] })) {
+                    return [key, true];
+                }
+            }
+            return [key, false];
+        }));
+    }, [source, store]);
+    return {
+        getMultimode,
+    };
+}
+//# sourceMappingURL=useMultimode.js.map

package/hooks/useMultimode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMultimode.js","sourceRoot":"","sources":["../src/hooks/useMultimode.ts"],"names":[],"mappings":";;AAgDA,oCAqDC;AAnGD,iCAAoC;AACpC,wEAAkE;AAClE,4CAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,SAAgB,YAAY,CAC3B,MAAqB,EACrB,KAA4B;IAE5B,MAAM,YAAY,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QACrC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,UAAU,GAAG,IAAA,wCAAiB,EACnC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAC5B,CAAC;QAEF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC;YACpB,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC;YACpD,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;SAC3C,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,IAAA,iBAAQ,EAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC;QAE5E,OAAO,MAAM,CAAC,WAAW,CACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC5B,yCAAyC;YACzC,MAAM,uBAAuB,GAC5B,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC5C,IACC,uBAAuB;gBACvB,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,CAAC,EACvC,CAAC;gBACF,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpB,CAAC;YAED,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAEzD,sCAAsC;YACtC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACrB,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,IAAI,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;oBACzD,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACpB,CAAC;YACF,CAAC;YAED,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CACF,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAEpB,OAAO;QACN,YAAY;KACZ,CAAC;AACH,CAAC"}

package/index.d.ts

@@ -7,6 +7,7 @@ export { ModalControls } from './components/shared/ModalControls/ModalControls';
 export { Button } from './components/shared/Button/Button';
 export { LunaticComponents } from './components/LunaticComponents';
 export { useLunatic } from './use-lunatic/use-lunatic';
+export { getArticulationState } from './utils/getArticulationState';
 export { MDLabel } from './components/shared/MDLabel/MDLabel';
 export type { LunaticComponentDefinition, LunaticControl, LunaticData, LunaticValues, LunaticError, LunaticExpression, LunaticVariable, LunaticCollectedValue, LunaticStateVariable, LunaticState, LunaticPager, LunaticOptions, LunaticChangesHandler, } from './use-lunatic/type';
 export type { LunaticComponentProps, LunaticExtraProps, } from './components/type';

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VTLInterpretationError = exports.VTLMissingDependency = exports.VTLExpressionError = exports.VTLMissingDependencies = exports.MDLabel = exports.useLunatic = exports.LunaticComponents = exports.Button = exports.ModalControls = exports.components = void 0;
+exports.VTLInterpretationError = exports.VTLMissingDependency = exports.VTLExpressionError = exports.VTLMissingDependencies = exports.MDLabel = exports.getArticulationState = exports.useLunatic = exports.LunaticComponents = exports.Button = exports.ModalControls = exports.components = void 0;
 /**
  * We should remove this export to avoid `import * as lunatic from "@inseefr/lunatic"` in orchestrators
  *  but this is a breaking change
@@ -15,6 +15,8 @@ var LunaticComponents_1 = require("./components/LunaticComponents");
 Object.defineProperty(exports, "LunaticComponents", { enumerable: true, get: function () { return LunaticComponents_1.LunaticComponents; } });
 var use_lunatic_1 = require("./use-lunatic/use-lunatic");
 Object.defineProperty(exports, "useLunatic", { enumerable: true, get: function () { return use_lunatic_1.useLunatic; } });
+var getArticulationState_1 = require("./utils/getArticulationState");
+Object.defineProperty(exports, "getArticulationState", { enumerable: true, get: function () { return getArticulationState_1.getArticulationState; } });
 var MDLabel_1 = require("./components/shared/MDLabel/MDLabel");
 Object.defineProperty(exports, "MDLabel", { enumerable: true, get: function () { return MDLabel_1.MDLabel; } });
 // Export errors (useful for typeof)

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,gDAA6D;AAApD,qGAAA,OAAO,OAAc;AAC9B,iFAAgF;AAAvE,8GAAA,aAAa,OAAA;AACtB,4DAA2D;AAAlD,gGAAA,MAAM,OAAA;AAEf,oEAAmE;AAA1D,sHAAA,iBAAiB,OAAA;AAC1B,yDAAuD;AAA9C,yGAAA,UAAU,OAAA;AAEnB,+DAA8D;AAArD,kGAAA,OAAO,OAAA;AAyBhB,oCAAoC;AACpC,iEAKgD;AAJ/C,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,8GAAA,oBAAoB,OAAA;AACpB,gHAAA,sBAAsB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,gDAA6D;AAApD,qGAAA,OAAO,OAAc;AAC9B,iFAAgF;AAAvE,8GAAA,aAAa,OAAA;AACtB,4DAA2D;AAAlD,gGAAA,MAAM,OAAA;AAEf,oEAAmE;AAA1D,sHAAA,iBAAiB,OAAA;AAC1B,yDAAuD;AAA9C,yGAAA,UAAU,OAAA;AACnB,qEAAoE;AAA3D,4HAAA,oBAAoB,OAAA;AAE7B,+DAA8D;AAArD,kGAAA,OAAO,OAAA;AAyBhB,oCAAoC;AACpC,iEAKgD;AAJ/C,gHAAA,sBAAsB,OAAA;AACtB,4GAAA,kBAAkB,OAAA;AAClB,8GAAA,oBAAoB,OAAA;AACpB,gHAAA,sBAAsB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@inseefr/lunatic",
-    "version": "3.6.14",
+    "version": "3.6.15-rc.1",
     "description": "Library of questionnaire components",
     "repository": {
         "type": "git",
@@ -225,6 +225,7 @@
         "src/hooks/useKeyboardKey.ts",
         "src/hooks/useListKeyboardHandler.ts",
         "src/hooks/useLocalStorage.ts",
+        "src/hooks/useMultimode.ts",
         "src/hooks/useRefSync.ts",
         "src/i18n/build-dictionary.ts",
         "src/i18n/dictionary.ts",
@@ -235,6 +236,9 @@
         "src/json.d.ts",
         "src/stories/accordion/accordion.stories.tsx",
         "src/stories/accordion/source.json",
+        "src/stories/behaviour/articulation/articulation.stories.tsx",
+        "src/stories/behaviour/articulation/multimode.stories.tsx",
+        "src/stories/behaviour/articulation/roundabout.json",
         "src/stories/behaviour/cleaning/cleaning.stories.tsx",
         "src/stories/behaviour/cleaning/source-loop-scopes.json",
         "src/stories/behaviour/cleaning/source-loop.json",
@@ -431,6 +435,7 @@
         "src/utils/dom.ts",
         "src/utils/env.ts",
         "src/utils/function.ts",
+        "src/utils/getArticulationState.ts",
         "src/utils/is-element.ts",
         "src/utils/logger.ts",
         "src/utils/number.spec.ts",
@@ -1323,6 +1328,9 @@
         "esm/hooks/useLocalStorage.d.ts",
         "esm/hooks/useLocalStorage.js",
         "esm/hooks/useLocalStorage.js.map",
+        "esm/hooks/useMultimode.d.ts",
+        "esm/hooks/useMultimode.js",
+        "esm/hooks/useMultimode.js.map",
         "esm/hooks/useRefSync.d.ts",
         "esm/hooks/useRefSync.js",
         "esm/hooks/useRefSync.js.map",
@@ -1577,6 +1585,9 @@
         "esm/utils/function.d.ts",
         "esm/utils/function.js",
         "esm/utils/function.js.map",
+        "esm/utils/getArticulationState.d.ts",
+        "esm/utils/getArticulationState.js",
+        "esm/utils/getArticulationState.js.map",
         "esm/utils/is-element.d.ts",
         "esm/utils/is-element.js",
         "esm/utils/is-element.js.map",
@@ -1649,6 +1660,9 @@
         "hooks/useLocalStorage.d.ts",
         "hooks/useLocalStorage.js",
         "hooks/useLocalStorage.js.map",
+        "hooks/useMultimode.d.ts",
+        "hooks/useMultimode.js",
+        "hooks/useMultimode.js.map",
         "hooks/useRefSync.d.ts",
         "hooks/useRefSync.js",
         "hooks/useRefSync.js.map",
@@ -1904,6 +1918,9 @@
         "utils/function.d.ts",
         "utils/function.js",
         "utils/function.js.map",
+        "utils/getArticulationState.d.ts",
+        "utils/getArticulationState.js",
+        "utils/getArticulationState.js.map",
         "utils/is-element.d.ts",
         "utils/is-element.js",
         "utils/is-element.js.map",

package/src/components/Roundabout/Roundabout.tsx

@@ -1,6 +1,7 @@
 import { CustomRoundabout } from './CustomRoundabout';
 import type { LunaticComponentProps } from '../type';
 import { getComponentErrors } from '../shared/ComponentErrors/ComponentErrors';
+import { ArticulationState } from '../../utils/getArticulationState';
 
 /**
  * Roundabout is a special loop component where the user can select the iteration to go to
@@ -8,11 +9,15 @@ import { getComponentErrors } from '../shared/ComponentErrors/ComponentErrors';
 export function Roundabout(props: LunaticComponentProps<'Roundabout'>) {
 	const goToIteration = (iteration: number) => {
 		if (
-			props.items[iteration].progress !== 1 &&
-			props.items[iteration].progress !== 0
+			props.items[iteration].progress !== ArticulationState.COMPLETED &&
+			props.items[iteration].progress !== ArticulationState.STARTED
 		) {
 			props.handleChanges([
-				{ name: props.progressVariable, value: 0, iteration: [iteration] },
+				{
+					name: props.progressVariable,
+					value: ArticulationState.STARTED,
+					iteration: [iteration],
+				},
 			]);
 		}
 		props.goToPage({

package/src/hooks/useMultimode.ts

@@ -0,0 +1,102 @@
+import type { LunaticVariablesStore } from '../use-lunatic/commons/variables/lunatic-variables-store';
+import type { LunaticSource } from '../type.source';
+import { useCallback } from 'react';
+import { findComponentById } from '../utils/getArticulationState';
+import { forceInt } from '../utils/number';
+
+/**
+ * Retrieve the multimode state
+ *
+ * ## Why this hook
+ *
+ * The goal of this hook is to provide insights about a roundabout using extra information inserted in the JSON source
+ * provided to Lunatic.
+ *
+ * For instance
+ *
+ * ```
+ * {
+ *    "multimode": {
+ *         "questionnaire": {
+ *             "rules": {
+ *                 "IS_MOVED": {
+ *                     "type": "VTL",
+ *                     "value": "nvl(HABITEZ_VOUS_ICI, true)"
+ *                 },
+ *             }
+ *         },
+ *         "leaf": {
+ *             "source": "id-roundabout-in-questionnaire",
+ *             "rules": {
+ *                 "IS_MOVED": {
+ *                     "type": "VTL",
+ *                     "value": "nvl(PRENOM_HABITE_PLUS_LA, false)"
+ *                 },
+ *             }
+ *         }
+ *     },
+ * }
+ * ```
+ *
+ * Run the expression to check if rules are true or false. A rule is considered as true if at least one expression is evaluated to true
+ *
+ * ```
+ * {
+ * 		"IS_MOVED": true
+ * }
+ * ```
+ */
+export function useMultimode(
+	source: LunaticSource,
+	store: LunaticVariablesStore
+) {
+	const getMultimode = useCallback(() => {
+		if (!source.multimode) {
+			return {};
+		}
+
+		const roundabout = findComponentById(
+			source.components,
+			source.multimode.leaf.source
+		);
+
+		const keys = new Set([
+			...Object.keys(source.multimode.questionnaire.rules),
+			...Object.keys(source.multimode.leaf.rules),
+		]);
+		const iterations = forceInt(store.run(roundabout?.iterations.value ?? '0'));
+
+		return Object.fromEntries(
+			Array.from(keys).map((key) => {
+				// Check the value at questionnaire level
+				const questionnaireExpression =
+					source.multimode?.questionnaire.rules[key];
+				if (
+					questionnaireExpression &&
+					store.run(questionnaireExpression.value)
+				) {
+					return [key, true];
+				}
+
+				const leafExpression = source.multimode?.leaf.rules[key];
+
+				// There is no expression for the leaf
+				if (!leafExpression) {
+					return [key, false];
+				}
+
+				for (let i = 0; i < iterations; i++) {
+					if (store.run(leafExpression.value, { iteration: [i] })) {
+						return [key, true];
+					}
+				}
+
+				return [key, false];
+			})
+		);
+	}, [source, store]);
+
+	return {
+		getMultimode,
+	};
+}

package/src/index.ts

@@ -8,6 +8,7 @@ export { Button } from './components/shared/Button/Button';
 
 export { LunaticComponents } from './components/LunaticComponents';
 export { useLunatic } from './use-lunatic/use-lunatic';
+export { getArticulationState } from './utils/getArticulationState';
 
 export { MDLabel } from './components/shared/MDLabel/MDLabel';
 

package/src/stories/behaviour/articulation/articulation.stories.tsx

@@ -0,0 +1,90 @@
+import source from './roundabout.json';
+import type { Meta, StoryObj } from '@storybook/react';
+import { useMemo, useState } from 'react';
+import { getArticulationState } from '../../../utils/getArticulationState';
+import { Orchestrator } from '../../utils/Orchestrator';
+
+type Source = Parameters<typeof getArticulationState>[0];
+type Data = Parameters<typeof getArticulationState>[1];
+
+type Props = {
+	source: Source;
+	data: Data;
+};
+
+function StoryComponent({ source, data }: Props) {
+	const [page, setPage] = useState(null as null | string);
+	const gotoNav = () => setPage(null);
+	const { items } = useMemo(
+		() => getArticulationState(source, data),
+		[source, data]
+	);
+
+	if (page) {
+		return (
+			<div>
+				{page}
+				<button onClick={gotoNav}>&lt; Revenir à l'articulation</button>
+				{/* eslint-disable-next-line @typescript-eslint/ban-ts-comment */}
+				{/*/ @ts-ignore */}
+				<Orchestrator source={source} data={data} initialPage={page} />
+			</div>
+		);
+	}
+
+	const progressLabel = (n: number) => {
+		if (n === -1) {
+			return 'Commencer';
+		}
+		if (n === 0) {
+			return 'Continuer';
+		}
+		return 'Complété';
+	};
+
+	return (
+		<div className="space-y-4">
+			<h2 className="font-bold text-2xl">Articulation</h2>
+			<table className="table">
+				<thead>
+					<tr>
+						{items[0].cells.map((cell, k) => (
+							<th key={k}>{cell.label}</th>
+						))}
+						<th>Actions</th>
+					</tr>
+				</thead>
+				<tbody>
+					{items.map((item, k) => (
+						<tr key={k}>
+							{item.cells.map((cell, kk) => (
+								<td key={kk}>{cell.value}</td>
+							))}
+							<td>
+								<button onClick={() => console.log('ToDo')} className="btn">
+									{progressLabel(item.progress)}
+								</button>
+							</td>
+						</tr>
+					))}
+				</tbody>
+			</table>
+		</div>
+	);
+}
+
+const meta: Meta<typeof StoryComponent> = {
+	title: 'Behaviour/Articulation',
+	component: StoryComponent,
+};
+
+export default meta;
+
+type Story = StoryObj<typeof StoryComponent>;
+
+export const Basic: Story = {
+	args: {
+		source: source as Source,
+		data: {},
+	},
+};

package/src/stories/behaviour/articulation/multimode.stories.tsx

@@ -0,0 +1,19 @@
+import source from './roundabout.json';
+
+import { Meta, StoryObj } from '@storybook/react';
+import { Orchestrator } from '../../utils/Orchestrator';
+
+const meta: Meta<typeof Orchestrator> = {
+	title: 'Behaviour/Articulation/MultiMode',
+	component: Orchestrator,
+};
+
+export default meta;
+type Story = StoryObj<typeof Orchestrator>;
+
+export const Default: Story = {
+	args: {
+		source,
+		multiMode: true,
+	},
+};