@inseefr/lunatic 3.0.0-rc.9 → 3.0.1-rc.0

package/lib/use-lunatic/type.d.ts

@@ -0,0 +1,165 @@
+import type { FunctionComponent, PropsWithChildren, ReactNode } from 'react';
+import type { ComponentDefinition, ControlDefinition, LunaticSource, SuggesterDefinition, Variable, VTLExpression, VTLScalarExpression } from '../type.source';
+import type { LunaticVariablesStore } from './commons/variables/lunatic-variables-store';
+import type { IndexEntry } from '../utils/search/SearchInterface';
+import type { InterpretedLunaticOverviewItem } from './hooks/useOverview';
+import type { LunaticComponentProps } from '../components/type';
+export type { LunaticSource } from '../type.source';
+export type LunaticComponentDefinition<T extends string = string> = ComponentDefinition & {
+    componentType: T;
+    page?: string;
+};
+export type LunaticControl = ControlDefinition;
+export type LunaticOverviewItem = {
+    id: string;
+    pageTag: string;
+    page: number;
+    label: LunaticExpression;
+    description: LunaticExpression | undefined;
+    type: string;
+    conditionFilter?: LunaticExpression;
+    iterations?: LunaticExpression;
+};
+export type LunaticSuggester = SuggesterDefinition;
+export type LunaticData = Partial<Record<Exclude<VariableType, 'COLLECTED'>, Record<string, unknown>> & {
+    COLLECTED: Record<string, LunaticCollectedValue>;
+}>;
+export type LunaticValues = {
+    [variableName: string]: unknown;
+};
+export type LunaticError = Pick<ControlDefinition, 'id' | 'criticality' | 'typeOfControl'> & {
+    errorMessage: ReactNode;
+};
+export type VariableType = 'COLLECTED' | 'EXTERNAL' | 'CALCULATED';
+export type LunaticExpression = VTLExpression | VTLScalarExpression;
+export type PageTag = `${number}.${number}#${number}` | `${number}`;
+export type LunaticVariable = Variable;
+export type LunaticCollectedValue = Partial<{
+    COLLECTED: unknown;
+    EDITED: unknown;
+    FORCED: unknown;
+    INPUTTED: unknown;
+    PREVIOUS: unknown;
+}>;
+export type LunaticStateVariable = {
+    [key in LunaticVariable['variableType']]: {
+        type: key;
+        value: unknown;
+        variable: LunaticVariable & {
+            variableType: key;
+        };
+        CalculatedLinked?: LunaticVariable[];
+    };
+}[LunaticVariable['variableType']];
+export type LunaticPager = {
+    lastReachedPage?: PageTag;
+    maxPage: number;
+    nbSubPages?: number;
+    page: number;
+    subPage?: number;
+    iteration?: number;
+    nbIterations?: number;
+    shallowIteration?: number;
+    linksIterations?: number[];
+};
+export type LunaticReducerState = {
+    variables: LunaticVariablesStore;
+    overview: LunaticOverviewItem[];
+    pager: LunaticPager;
+    pages: {
+        [key: number | string]: {
+            components: LunaticSource['components'];
+            isLoop: false;
+            iterations?: undefined;
+            loopDependencies?: undefined;
+            subPages?: undefined;
+        } | {
+            components: LunaticSource['components'];
+            isLoop: true;
+            iterations: VTLScalarExpression;
+            loopDependencies: string[];
+            subPages: string[];
+        };
+    };
+    executeExpression: <T extends unknown = unknown>(expression: VTLExpression, args?: {
+        iteration?: number | number[];
+        bindingDependencies?: string[];
+        deps?: string[];
+    }) => T;
+    isInLoop: boolean;
+    updatedAt: number;
+    updateBindings: (variableName: string, value: unknown, options: {
+        iteration?: number[];
+    }) => unknown;
+};
+export type LunaticOptions = {
+    features?: ('MD' | 'VTL')[];
+    preferences?: ['COLLECTED'];
+    savingType?: 'COLLECTED';
+    onChange?: LunaticChangesHandler;
+    management?: boolean;
+    shortcut?: boolean;
+    initialPage?: PageTag;
+    lastReachedPage?: PageTag;
+    autoSuggesterLoading?: boolean;
+    getReferentiel?: (name: string) => Promise<Array<IndexEntry>>;
+    activeControls?: boolean;
+    withOverview?: boolean;
+    missing?: boolean;
+    missingStrategy?: () => void;
+    missingShortcut?: {
+        dontKnow: string;
+        refused: string;
+    };
+    dontKnowButton?: string;
+    refusedButton?: string;
+    trackChanges?: boolean;
+};
+export type LunaticState = {
+    pager: LunaticPager;
+    overview: InterpretedLunaticOverviewItem[];
+    pageTag: PageTag;
+    updatedAt: number;
+    Provider: FunctionComponent<PropsWithChildren>;
+    isInLoop: boolean;
+    loopVariables: string[];
+    isFirstPage: boolean;
+    isLastPage: boolean;
+    errors?: {
+        [page: string]: {
+            [id: string]: LunaticError[];
+        };
+    };
+    currentErrors?: {
+        [id: string]: LunaticError[];
+    };
+    modalErrors?: Record<string, LunaticError[]>;
+    goToPage: (page: {
+        page: PageTag | number;
+        iteration?: number;
+        nbIterations?: number;
+        subPage?: number;
+    }) => void;
+    goNextPage: () => void;
+    goPreviousPage: () => void;
+    compileControls: () => {
+        currentErrors: Record<string, LunaticError[]> | undefined;
+        isCritical: boolean;
+    };
+    getComponents: (params?: {
+        only?: LunaticComponentProps['componentType'];
+        except?: LunaticComponentProps['componentType'];
+    }) => LunaticComponentProps[];
+    getData: (withRefreshedCalculated: boolean, variableNames?: string[]) => LunaticData;
+    getChangedData: (reset: boolean) => LunaticData;
+    resetChangedData: () => void;
+    hasPageResponse: () => boolean;
+    testing: {
+        handleChanges: LunaticChangesHandler;
+    };
+};
+export type LunaticChangesHandler = (args: {
+    name: string;
+    value: any;
+    iteration?: number[];
+}[]) => void;

package/lib/use-lunatic/type.js

@@ -1,5 +1,2 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
+export {};
+//# sourceMappingURL=type.js.map

package/lib/use-lunatic/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/use-lunatic/type.ts"],"names":[],"mappings":""}

package/lib/use-lunatic/use-lunatic.d.ts

@@ -0,0 +1,56 @@
+/// <reference types="react" />
+import type { LunaticChangesHandler, LunaticData, LunaticOptions, PageTag } from './type';
+import type { LunaticSource } from './type';
+declare function useLunatic(source: LunaticSource, data?: LunaticData, argOptions?: LunaticOptions): {
+    pageTag: PageTag;
+    isFirstPage: boolean;
+    isLastPage: boolean;
+    updatedAt: number;
+    pager: import("./type").LunaticPager;
+    isInLoop: boolean;
+    overview: import("./hooks/useOverview").InterpretedLunaticOverviewItem[];
+    loopVariables: string[];
+    getComponents: (params?: {
+        only?: "Input" | "Textarea" | "Sequence" | "Subsequence" | "Roundabout" | "Loop" | "RosterForLoop" | "Table" | "InputNumber" | "Duration" | "Datepicker" | "CheckboxGroup" | "CheckboxBoolean" | "Radio" | "Dropdown" | "Question" | "CheckboxOne" | "Suggester" | "PairwiseLinks" | "Summary" | "Text" | "Switch" | "FilterDescription" | undefined;
+        except?: "Input" | "Textarea" | "Sequence" | "Subsequence" | "Roundabout" | "Loop" | "RosterForLoop" | "Table" | "InputNumber" | "Duration" | "Datepicker" | "CheckboxGroup" | "CheckboxBoolean" | "Radio" | "Dropdown" | "Question" | "CheckboxOne" | "Suggester" | "PairwiseLinks" | "Summary" | "Text" | "Switch" | "FilterDescription" | undefined;
+    } | undefined) => import("..").LunaticComponentProps[];
+    goPreviousPage: () => void;
+    goNextPage: () => void;
+    goToPage: (page: {
+        page: number | PageTag;
+        iteration?: number | undefined;
+        nbIterations?: number | undefined;
+        subPage?: number | undefined;
+    }) => void;
+    compileControls: () => {
+        currentErrors: Record<string, import("./type").LunaticError[]> | undefined;
+        isCritical: boolean;
+    };
+    getData: (withRefreshedCalculated: boolean, variableNames?: string[] | undefined) => Partial<Record<"EXTERNAL" | "CALCULATED", Record<string, unknown>> & {
+        COLLECTED: Record<string, Partial<{
+            COLLECTED: unknown;
+            EDITED: unknown;
+            FORCED: unknown;
+            INPUTTED: unknown;
+            PREVIOUS: unknown;
+        }>>;
+    }>;
+    getChangedData: (reset?: boolean) => Partial<Record<"EXTERNAL" | "CALCULATED", Record<string, unknown>> & {
+        COLLECTED: Record<string, Partial<{
+            COLLECTED: unknown;
+            EDITED: unknown;
+            FORCED: unknown;
+            INPUTTED: unknown;
+            PREVIOUS: unknown;
+        }>>;
+    }>;
+    resetChangedData: () => void;
+    hasPageResponse: () => boolean;
+    Provider: import("react").FunctionComponent<{
+        children?: import("react").ReactNode;
+    }>;
+    testing: {
+        handleChanges: LunaticChangesHandler;
+    };
+};
+export default useLunatic;

package/lib/use-lunatic/use-lunatic.js

@@ -1,217 +1,138 @@
-"use strict";
-
-function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
-var _react = require("react");
-var actions = _interopRequireWildcard(require("./actions"));
-var _commons = require("./commons");
-var _i18n = _interopRequireDefault(require("../i18n"));
-var _constants = require("../utils/constants");
-var _initialState = _interopRequireDefault(require("./initial-state"));
-var _lunaticContext = require("./lunatic-context");
-var _compileControls = require("./commons/compile-controls");
-var _getOverview = require("./commons/getOverview");
-var _useLoopVariables = require("./hooks/use-loop-variables");
-var _reducer = _interopRequireDefault(require("./reducer"));
-var _useSuggesters = require("./use-suggesters");
-var _getQuestionnaireData = require("./commons/variables/get-questionnaire-data");
-var _useTrackChanges2 = require("../hooks/use-track-changes");
-var _usePageHasResponse = require("./hooks/use-page-has-response");
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { "default": e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n["default"] = e, t && t.set(e, n), n; }
-function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
-function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
-function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
-var empty = {}; // Keep the same empty object (to avoid problem with useEffect dependencies)
-var emptyFn = function emptyFn() {};
-var DEFAULT_DATA = empty;
-var DEFAULT_FEATURES = ['VTL', 'MD'];
-var DEFAULT_PREFERENCES = [_constants.COLLECTED];
-var DEFAULT_SHORTCUT = {
-  dontKnow: '',
-  refused: ''
+import { useCallback, useMemo, useReducer } from 'react';
+import { goToPageAction, goNextPageAction, goPreviousPageAction, handleChangesAction, } from './actions';
+import { getPageTag, isFirstLastPage } from './commons';
+import D from '../i18n';
+import { COLLECTED } from '../utils/constants';
+import { createLunaticProvider } from './lunatic-context';
+import { compileControls as compileControlsLib } from './commons/compile-controls';
+import { useLoopVariables } from './hooks/use-loop-variables';
+import { getQuestionnaireData } from './commons/variables/get-questionnaire-data';
+import { useTrackChanges } from '../hooks/use-track-changes';
+import { usePageHasResponse } from './hooks/use-page-has-response';
+import { useOverview } from './hooks/useOverview';
+import { reducerInitializer } from './reducer/reducerInitializer';
+import { getComponentsFromState } from './commons/get-components-from-state';
+import { fillComponents } from './commons/fill-components/fill-components';
+import { reducer } from './reducer/reducer';
+import { mergeDefault } from '../utils/object';
+const empty = {}; // Keep the same empty object (to avoid problem with useEffect dependencies)
+const DEFAULT_DATA = empty;
+const DEFAULT_FEATURES = ['VTL', 'MD'];
+const DEFAULT_PREFERENCES = [COLLECTED];
+const DEFAULT_SHORTCUT = { dontKnow: '', refused: '' };
+const DEFAULT_DONT_KNOW = D.DK;
+const DEFAULT_REFUSED = D.RF;
+const defaultOptions = {
+    features: DEFAULT_FEATURES,
+    preferences: DEFAULT_PREFERENCES,
+    savingType: COLLECTED,
+    onChange: () => { },
+    management: false,
+    shortcut: false,
+    initialPage: '1',
+    lastReachedPage: undefined,
+    autoSuggesterLoading: false,
+    activeControls: false,
+    // Calculate an overview of every sequence (will be exposed as "overview")
+    withOverview: false,
+    missing: false,
+    missingStrategy: () => { },
+    missingShortcut: DEFAULT_SHORTCUT,
+    dontKnowButton: DEFAULT_DONT_KNOW,
+    refusedButton: DEFAULT_REFUSED,
+    trackChanges: false,
 };
-var DEFAULT_DONT_KNOW = _i18n["default"].DK;
-var DEFAULT_REFUSED = _i18n["default"].RF;
-var nothing = function nothing() {};
-function useLunatic(source) {
-  var data = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : DEFAULT_DATA;
-  var _ref = arguments.length > 2 ? arguments[2] : undefined,
-    _ref$features = _ref.features,
-    features = _ref$features === void 0 ? DEFAULT_FEATURES : _ref$features,
-    _ref$preferences = _ref.preferences,
-    preferences = _ref$preferences === void 0 ? DEFAULT_PREFERENCES : _ref$preferences,
-    _ref$savingType = _ref.savingType,
-    savingType = _ref$savingType === void 0 ? _constants.COLLECTED : _ref$savingType,
-    _ref$onChange = _ref.onChange,
-    onChange = _ref$onChange === void 0 ? nothing : _ref$onChange,
-    _ref$management = _ref.management,
-    management = _ref$management === void 0 ? false : _ref$management,
-    _ref$shortcut = _ref.shortcut,
-    shortcut = _ref$shortcut === void 0 ? false : _ref$shortcut,
-    _ref$initialPage = _ref.initialPage,
-    initialPage = _ref$initialPage === void 0 ? '1' : _ref$initialPage,
-    _ref$lastReachedPage = _ref.lastReachedPage,
-    lastReachedPage = _ref$lastReachedPage === void 0 ? undefined : _ref$lastReachedPage,
-    _ref$autoSuggesterLoa = _ref.autoSuggesterLoading,
-    autoSuggesterLoading = _ref$autoSuggesterLoa === void 0 ? false : _ref$autoSuggesterLoa,
-    _ref$activeControls = _ref.activeControls,
-    activeControls = _ref$activeControls === void 0 ? false : _ref$activeControls,
-    getReferentiel = _ref.getReferentiel,
-    _ref$withOverview = _ref.withOverview,
-    withOverview = _ref$withOverview === void 0 ? false : _ref$withOverview,
-    _ref$missing = _ref.missing,
-    missing = _ref$missing === void 0 ? false : _ref$missing,
-    _ref$missingStrategy = _ref.missingStrategy,
-    missingStrategy = _ref$missingStrategy === void 0 ? emptyFn : _ref$missingStrategy,
-    _ref$missingShortcut = _ref.missingShortcut,
-    missingShortcut = _ref$missingShortcut === void 0 ? DEFAULT_SHORTCUT : _ref$missingShortcut,
-    _ref$dontKnowButton = _ref.dontKnowButton,
-    dontKnowButton = _ref$dontKnowButton === void 0 ? DEFAULT_DONT_KNOW : _ref$dontKnowButton,
-    _ref$refusedButton = _ref.refusedButton,
-    refusedButton = _ref$refusedButton === void 0 ? DEFAULT_REFUSED : _ref$refusedButton,
-    _ref$workersBasePath = _ref.workersBasePath,
-    workersBasePath = _ref$workersBasePath === void 0 ? undefined : _ref$workersBasePath,
-    _ref$trackChanges = _ref.trackChanges,
-    trackChanges = _ref$trackChanges === void 0 ? false : _ref$trackChanges;
-  var _useReducer = (0, _react.useReducer)(_reducer["default"], _initialState["default"]),
-    _useReducer2 = _slicedToArray(_useReducer, 2),
-    state = _useReducer2[0],
-    dispatch = _useReducer2[1];
-  var pager = state.pager,
-    waiting = state.waiting,
-    overview = state.overview,
-    pages = state.pages,
-    executeExpression = state.executeExpression,
-    isInLoop = state.isInLoop;
-  var components = (0, _commons.useComponentsFromState)(state);
-  var suggesters = source.suggesters;
-
-  // Required context provider: cleaner than prop drilling through every component
-  var Provider = (0, _react.useMemo)(function () {
-    return (0, _lunaticContext.createLunaticProvider)({
-      management: management,
-      missing: missing,
-      missingStrategy: missingStrategy,
-      shortcut: shortcut,
-      missingShortcut: missingShortcut,
-      dontKnowButton: dontKnowButton,
-      refusedButton: refusedButton
+function useLunatic(source, data = DEFAULT_DATA, argOptions = empty) {
+    const options = mergeDefault(argOptions, defaultOptions);
+    const { management, missing, missingStrategy, shortcut, missingShortcut, dontKnowButton, refusedButton, onChange, trackChanges, preferences, } = options;
+    const [state, dispatch] = useReducer(reducer, { ...options, source, data }, reducerInitializer);
+    // Required context provider: cleaner than prop drilling through every component
+    const Provider = useMemo(() => createLunaticProvider({
+        management,
+        missing,
+        missingStrategy,
+        shortcut,
+        missingShortcut,
+        dontKnowButton,
+        refusedButton,
+    }), [
+        management,
+        missing,
+        missingStrategy,
+        shortcut,
+        missingShortcut,
+        dontKnowButton,
+        refusedButton,
+    ]);
+    const compileControls = () => {
+        return compileControlsLib(state);
+    };
+    const goPreviousPage = useCallback(function () {
+        dispatch(goPreviousPageAction());
+    }, [dispatch]);
+    const goNextPage = useCallback(function (payload = {}) {
+        dispatch(goNextPageAction(payload));
+    }, [dispatch]);
+    const goToPage = useCallback(function (payload) {
+        dispatch(goToPageAction(payload));
+    }, [dispatch]);
+    const handleChanges = useCallback((responses) => {
+        dispatch(handleChangesAction(responses));
+        onChange(responses);
+    }, [dispatch, onChange]);
+    const getData = (withRefreshedCalculated, variableNames) => {
+        return getQuestionnaireData(state.variables, source.variables, withRefreshedCalculated, variableNames);
+    };
+    const { resetChangedData, getChangedData } = useTrackChanges(trackChanges, state.variables, (variableNames) => getData(false, variableNames));
+    const pageTag = getPageTag(state.pager);
+    const { isFirstPage, isLastPage } = isFirstLastPage(state.pager);
+    const components = fillComponents(getComponentsFromState(state), {
+        handleChanges,
+        preferences,
+        goToPage,
+        shortcut,
+        goNextPage,
+        goPreviousPage,
+        management,
+        ...state,
     });
-  }, [management, missing, missingStrategy, shortcut, missingShortcut, dontKnowButton, refusedButton]);
-  var getSuggesterStatus = (0, _useSuggesters.useSuggesters)({
-    auto: autoSuggesterLoading,
-    getReferentiel: getReferentiel,
-    suggesters: suggesters,
-    workersBasePath: workersBasePath
-  });
-  var compileControls = (0, _react.useCallback)(function () {
-    return (0, _compileControls.compileControls)({
-      pager: pager,
-      pages: pages,
-      isInLoop: isInLoop,
-      executeExpression: executeExpression
-    });
-  }, [pager, pages, isInLoop, executeExpression]);
-  var goPreviousPage = (0, _react.useCallback)(function () {
-    dispatch(actions.goPreviousPage());
-  }, [dispatch]);
-  var goNextPage = (0, _react.useCallback)(function () {
-    var payload = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-    dispatch(actions.goNextPage(payload));
-  }, [dispatch]);
-  var goToPage = (0, _react.useCallback)(function (payload) {
-    dispatch(actions.goToPage(payload));
-  }, [dispatch]);
-  var getComponents = (0, _react.useCallback)(function () {
-    var _ref2 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
-      only = _ref2.only,
-      except = _ref2.except;
-    if (only && except) {
-      throw new Error('"only" and "except" cannot be used together in getComponents()');
-    }
-    if (only) {
-      return components.filter(function (c) {
-        return only.includes(c.componentType);
-      });
-    }
-    if (except) {
-      return components.filter(function (c) {
-        return !except.includes(c.componentType);
-      });
-    }
-    return components;
-  }, [components]);
-  var handleChange = (0, _react.useCallback)(function (response, value, args) {
-    dispatch(actions.handleChange(typeof response === 'string' ? response : response.name, value, args === null || args === void 0 ? void 0 : args.iteration));
-    onChange(response, value, args);
-  }, [dispatch, onChange]);
-  var getData = function getData(withRefreshedCalculated, variableNames) {
-    return (0, _getQuestionnaireData.getQuestionnaireData)(state.variables, source.variables, withRefreshedCalculated, variableNames);
-  };
-  var _useTrackChanges = (0, _useTrackChanges2.useTrackChanges)(trackChanges, state.variables, function (variableNames) {
-      return getData(false, variableNames);
-    }),
-    resetChangedData = _useTrackChanges.resetChangedData,
-    getChangedData = _useTrackChanges.getChangedData;
-  var buildedOverview = (0, _react.useMemo)(function () {
-    return (0, _getOverview.overviewWithChildren)(overview);
-  }, [overview]);
-  var pageTag = (0, _commons.getPageTag)(pager);
-  var _isFirstLastPage = (0, _commons.isFirstLastPage)(pager),
-    isFirstPage = _isFirstLastPage.isFirstPage,
-    isLastPage = _isFirstLastPage.isLastPage;
-  (0, _react.useEffect)(function () {
-    dispatch(actions.onInit({
-      source: source,
-      data: data,
-      initialPage: initialPage,
-      lastReachedPage: lastReachedPage,
-      features: features,
-      preferences: preferences,
-      savingType: savingType,
-      management: management,
-      shortcut: shortcut,
-      handleChange: handleChange,
-      activeControls: activeControls,
-      goToPage: goToPage,
-      goNextPage: goNextPage,
-      goPreviousPage: goPreviousPage,
-      withOverview: withOverview,
-      workersBasePath: workersBasePath
-    }));
-  }, [source, data, initialPage, features, preferences, savingType, management, shortcut, handleChange, activeControls, withOverview, goToPage, goNextPage, goPreviousPage, lastReachedPage, workersBasePath]);
-  (0, _react.useEffect)(function () {
-    dispatch(actions.updateState({
-      getSuggesterStatus: getSuggesterStatus
-    }));
-  }, [getSuggesterStatus]);
-  return {
-    getComponents: getComponents,
-    goPreviousPage: goPreviousPage,
-    goNextPage: goNextPage,
-    goToPage: goToPage,
-    compileControls: compileControls,
-    pageTag: pageTag,
-    isFirstPage: isFirstPage,
-    isLastPage: isLastPage,
-    pager: pager,
-    waiting: waiting,
-    getData: getData,
-    Provider: Provider,
-    onChange: handleChange,
-    overview: buildedOverview,
-    loopVariables: (0, _useLoopVariables.useLoopVariables)(pager, state.pages),
-    getChangedData: getChangedData,
-    resetChangedData: resetChangedData,
-    hasPageResponse: (0, _usePageHasResponse.usePageHasResponse)(components, executeExpression)
-  };
+    const getComponents = ({ only, except, } = {}) => {
+        if (only && except) {
+            throw new Error('"only" and "except" cannot be used together in getComponents()');
+        }
+        if (only) {
+            return components.filter((c) => only.includes(c.componentType ?? ''));
+        }
+        if (except) {
+            return components.filter((c) => !except.includes(c.componentType ?? ''));
+        }
+        return components;
+    };
+    return {
+        pageTag,
+        isFirstPage,
+        isLastPage,
+        updatedAt: state.updatedAt,
+        pager: state.pager,
+        isInLoop: state.isInLoop,
+        overview: useOverview(state, [pageTag]),
+        loopVariables: useLoopVariables(state.pager, state.pages),
+        // Methods
+        getComponents,
+        goPreviousPage,
+        goNextPage,
+        goToPage,
+        compileControls,
+        getData,
+        getChangedData,
+        resetChangedData,
+        hasPageResponse: usePageHasResponse(components, state.executeExpression),
+        // Components
+        Provider,
+        testing: {
+            handleChanges,
+        },
+    };
 }
-var _default = exports["default"] = useLunatic;
+export default useLunatic;
+//# sourceMappingURL=use-lunatic.js.map

package/lib/use-lunatic/use-lunatic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-lunatic.js","sourceRoot":"","sources":["../../src/use-lunatic/use-lunatic.ts"],"names":[],"mappings":"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"}

package/lib/utils/array.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Call a callback x times
+ */
+export declare function times<T>(n: number, cb: (k: number) => T): T[];
+/**
+ * Update an item in an array without mutating the array
+ */
+export declare function setAtIndex<T>(arr: T, index: number | number[], newValue: unknown): T;
+/**
+ * Get a value inside an array
+ */
+export declare function getAtIndex(arr: unknown, indexes: number[]): unknown;
+export declare function resizeArray<T = unknown>(array: unknown, newLength: number, defaultValue?: T): T[];
+/**
+ * Return the first non-null/undefined value of an array
+ */
+export declare function firstValueItem<T = unknown>(items: T | T[]): T | undefined;
+/**
+ * Return a list of partial array
+ *
+ * Example :
+ * - subArray([1, 2, 3]) // [[1], [1, 2], [1, 2, 3]]
+ */
+export declare function subArrays<T = unknown>(items: T[] | T): T[][];
+/**
+ * Calculates the depth of an array
+ */
+export declare function depth(arr: unknown, base?: number): number;