@openforis/arena-core 2.3.42 → 2.4.0

package/dist/esm/record/_records/recordCompletion.js

@@ -14,17 +14,17 @@ const getAttributeCompletionStats = (params) => {
         const minCount = Nodes.getChildrenMinCount({ parentNode: entity, nodeDef });
         if (Number.isNaN(minCount) || minCount <= 0)
             return emptyStats();
-        const filledNodesCount = getChildren(entity, nodeDef.uuid)(record).filter(Nodes.isValueNotBlank).length;
+        const filledNodesCount = getChildren({ parentNode: entity, childDefUuid: nodeDef.uuid })(record).filter(Nodes.isValueNotBlank).length;
         return { total: minCount, filled: Math.min(filledNodesCount, minCount) };
     }
     if (!NodeDefs.isRequired(nodeDef) && !NodeDefs.isKey(nodeDef))
         return emptyStats();
-    const node = getChildren(entity, nodeDef.uuid)(record)[0];
+    const node = getChildren({ parentNode: entity, childDefUuid: nodeDef.uuid })(record)[0];
     return { total: 1, filled: node && Nodes.isValueNotBlank(node) ? 1 : 0 };
 };
 const getChildEntityCompletionStats = (params) => {
     const { survey, record, parentEntity, nodeDef } = params;
-    const childEntities = getChildren(parentEntity, nodeDef.uuid)(record);
+    const childEntities = getChildren({ parentNode: parentEntity, childDefUuid: nodeDef.uuid })(record);
     if (NodeDefs.isSingle(nodeDef)) {
         const childEntity = childEntities[0];
         return childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : emptyStats();

package/dist/esm/record/_records/recordCompletion.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordCompletion.js","sourceRoot":"","sources":["../../../../src/record/_records/recordCompletion.ts"],"names":[],"mappings":"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","sourcesContent":["import { ArenaRecordNode, Nodes } from '../../node'\nimport { NodeDef, NodeDefProps, NodeDefs, NodeDefType } from '../../nodeDef'\nimport { Survey, Surveys } from '../../survey'\nimport { Numbers } from '../../utils'\nimport { ArenaRecord } from '../record'\nimport { getChildren, getRoot } from './recordGetters'\n\nexport interface EntityCompletionStats {\n  total: number\n  filled: number\n}\n\nconst emptyStats = (): EntityCompletionStats => ({ total: 0, filled: 0 })\n\nconst addStats = (statsAcc: EntityCompletionStats, statsToAdd: EntityCompletionStats): void => {\n  statsAcc.total += statsToAdd.total\n  statsAcc.filled += statsToAdd.filled\n}\n\nconst getAttributeCompletionStats = (params: {\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { record, entity, nodeDef } = params\n\n  if (NodeDefs.isMultiple(nodeDef)) {\n    const minCount = Nodes.getChildrenMinCount({ parentNode: entity, nodeDef })\n    if (Number.isNaN(minCount) || minCount <= 0) return emptyStats()\n\n    const filledNodesCount = getChildren(entity, nodeDef.uuid)(record).filter(Nodes.isValueNotBlank).length\n\n    return { total: minCount, filled: Math.min(filledNodesCount, minCount) }\n  }\n\n  if (!NodeDefs.isRequired(nodeDef) && !NodeDefs.isKey(nodeDef)) return emptyStats()\n\n  const node = getChildren(entity, nodeDef.uuid)(record)[0]\n  return { total: 1, filled: node && Nodes.isValueNotBlank(node) ? 1 : 0 }\n}\n\nconst getChildEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  parentEntity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { survey, record, parentEntity, nodeDef } = params\n  const childEntities = getChildren(parentEntity, nodeDef.uuid)(record)\n\n  if (NodeDefs.isSingle(nodeDef)) {\n    const childEntity = childEntities[0]\n    return childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : emptyStats()\n  }\n\n  const minCountRaw = Nodes.getChildrenMinCount({ parentNode: parentEntity, nodeDef })\n  const minCount = Number.isNaN(minCountRaw) ? 0 : Math.max(minCountRaw, 0)\n  // entities added beyond the min count are still expected to be complete\n  const expectedCount = Math.max(minCount, childEntities.length)\n  if (expectedCount === 0) return emptyStats()\n\n  const stats = emptyStats()\n  for (let index = 0; index < expectedCount; index++) {\n    const childEntity = childEntities[index]\n    // a missing repetition (below the min count) counts as a single incomplete unit\n    addStats(\n      stats,\n      childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : { total: 1, filled: 0 }\n    )\n  }\n  return stats\n}\n\nexport const getEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  includeNestedEntities?: boolean\n}): EntityCompletionStats => {\n  const { survey, record, entity, includeNestedEntities = true } = params\n  const entityDef = Surveys.getNodeDefByUuid({ survey, uuid: entity.nodeDefUuid })\n  const childDefs = Surveys.getNodeDefChildren({ survey, nodeDef: entityDef })\n\n  const stats = emptyStats()\n  for (const childDef of childDefs) {\n    if (!Nodes.isChildApplicable(entity, childDef.uuid)) continue\n\n    if (NodeDefs.isEntity(childDef)) {\n      if (!includeNestedEntities) continue\n      addStats(stats, getChildEntityCompletionStats({ survey, record, parentEntity: entity, nodeDef: childDef }))\n    } else {\n      addStats(stats, getAttributeCompletionStats({ record, entity, nodeDef: childDef }))\n    }\n  }\n  return stats\n}\n\nconst toCompletionPercent = (stats: EntityCompletionStats): number => {\n  const { total, filled } = stats\n  if (total <= 0) return 100\n  return Numbers.roundToPrecision((filled / total) * 100, 2)\n}\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering every descendant recursively.\n * A required or key attribute is considered filled when it has a non empty value; multiple attributes and\n * entities are considered filled based on their min count (see Nodes.getChildrenMinCount).\n */\nexport const getEntityCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats(params))\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering only its own attributes\n * (nested entities are ignored).\n */\nexport const getEntityOwnCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats({ ...params, includeNestedEntities: false }))\n\n/**\n * Returns the percentage of completion of the given record (0-100), i.e. the completion of its root entity.\n */\nexport const getRecordCompletionPercent = (params: { survey: Survey; record: ArenaRecord }): number => {\n  const { survey, record } = params\n  const rootEntity = getRoot(record)\n  return rootEntity ? getEntityCompletionPercent({ survey, record, entity: rootEntity }) : 0\n}\n"]}
+{"version":3,"file":"recordCompletion.js","sourceRoot":"","sources":["../../../../src/record/_records/recordCompletion.ts"],"names":[],"mappings":"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","sourcesContent":["import { ArenaRecordNode, Nodes } from '../../node'\nimport { NodeDef, NodeDefProps, NodeDefs, NodeDefType } from '../../nodeDef'\nimport { Survey, Surveys } from '../../survey'\nimport { Numbers } from '../../utils'\nimport { ArenaRecord } from '../record'\nimport { getChildren, getRoot } from './recordGetters'\n\nexport interface EntityCompletionStats {\n  total: number\n  filled: number\n}\n\nconst emptyStats = (): EntityCompletionStats => ({ total: 0, filled: 0 })\n\nconst addStats = (statsAcc: EntityCompletionStats, statsToAdd: EntityCompletionStats): void => {\n  statsAcc.total += statsToAdd.total\n  statsAcc.filled += statsToAdd.filled\n}\n\nconst getAttributeCompletionStats = (params: {\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { record, entity, nodeDef } = params\n\n  if (NodeDefs.isMultiple(nodeDef)) {\n    const minCount = Nodes.getChildrenMinCount({ parentNode: entity, nodeDef })\n    if (Number.isNaN(minCount) || minCount <= 0) return emptyStats()\n\n    const filledNodesCount = getChildren({ parentNode: entity, childDefUuid: nodeDef.uuid })(record).filter(\n      Nodes.isValueNotBlank\n    ).length\n\n    return { total: minCount, filled: Math.min(filledNodesCount, minCount) }\n  }\n\n  if (!NodeDefs.isRequired(nodeDef) && !NodeDefs.isKey(nodeDef)) return emptyStats()\n\n  const node = getChildren({ parentNode: entity, childDefUuid: nodeDef.uuid })(record)[0]\n  return { total: 1, filled: node && Nodes.isValueNotBlank(node) ? 1 : 0 }\n}\n\nconst getChildEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  parentEntity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { survey, record, parentEntity, nodeDef } = params\n  const childEntities = getChildren({ parentNode: parentEntity, childDefUuid: nodeDef.uuid })(record)\n\n  if (NodeDefs.isSingle(nodeDef)) {\n    const childEntity = childEntities[0]\n    return childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : emptyStats()\n  }\n\n  const minCountRaw = Nodes.getChildrenMinCount({ parentNode: parentEntity, nodeDef })\n  const minCount = Number.isNaN(minCountRaw) ? 0 : Math.max(minCountRaw, 0)\n  // entities added beyond the min count are still expected to be complete\n  const expectedCount = Math.max(minCount, childEntities.length)\n  if (expectedCount === 0) return emptyStats()\n\n  const stats = emptyStats()\n  for (let index = 0; index < expectedCount; index++) {\n    const childEntity = childEntities[index]\n    // a missing repetition (below the min count) counts as a single incomplete unit\n    addStats(\n      stats,\n      childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : { total: 1, filled: 0 }\n    )\n  }\n  return stats\n}\n\nexport const getEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  includeNestedEntities?: boolean\n}): EntityCompletionStats => {\n  const { survey, record, entity, includeNestedEntities = true } = params\n  const entityDef = Surveys.getNodeDefByUuid({ survey, uuid: entity.nodeDefUuid })\n  const childDefs = Surveys.getNodeDefChildren({ survey, nodeDef: entityDef })\n\n  const stats = emptyStats()\n  for (const childDef of childDefs) {\n    if (!Nodes.isChildApplicable(entity, childDef.uuid)) continue\n\n    if (NodeDefs.isEntity(childDef)) {\n      if (!includeNestedEntities) continue\n      addStats(stats, getChildEntityCompletionStats({ survey, record, parentEntity: entity, nodeDef: childDef }))\n    } else {\n      addStats(stats, getAttributeCompletionStats({ record, entity, nodeDef: childDef }))\n    }\n  }\n  return stats\n}\n\nconst toCompletionPercent = (stats: EntityCompletionStats): number => {\n  const { total, filled } = stats\n  if (total <= 0) return 100\n  return Numbers.roundToPrecision((filled / total) * 100, 2)\n}\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering every descendant recursively.\n * A required or key attribute is considered filled when it has a non empty value; multiple attributes and\n * entities are considered filled based on their min count (see Nodes.getChildrenMinCount).\n */\nexport const getEntityCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats(params))\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering only its own attributes\n * (nested entities are ignored).\n */\nexport const getEntityOwnCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats({ ...params, includeNestedEntities: false }))\n\n/**\n * Returns the percentage of completion of the given record (0-100), i.e. the completion of its root entity.\n */\nexport const getRecordCompletionPercent = (params: { survey: Survey; record: ArenaRecord }): number => {\n  const { survey, record } = params\n  const rootEntity = getRoot(record)\n  return rootEntity ? getEntityCompletionPercent({ survey, record, entity: rootEntity }) : 0\n}\n"]}

package/dist/esm/record/_records/recordGetters.js

@@ -1,3 +1,14 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { TraverseMethod } from '../../common';
 import { SystemError } from '../../error';
 import { Nodes } from '../../node';
@@ -9,52 +20,89 @@ import { RECORD_STEP_DEFAULT } from '../record';
 import { RecordStepAnalysisCode } from '../recordStep';
 import { RecordNodesIndexReader } from './recordNodesIndexReader';
 import { NodeDefSelfReferences } from './nodeDefSelfReferences';
+const isRecordParams = (params) => 'record' in params;
+const recordGetter = (getter) => ((params) => isRecordParams(params)
+    ? getter(params)
+    : (record) => getter(Object.assign(Object.assign({}, params), { record })));
+const positionalRecordGetter = (params) => {
+    const { getter, isPositional, toParams } = params;
+    return ((...args) => {
+        const getterParams = isPositional(args[0]) ? toParams(...args) : args[0];
+        return (record) => getter(Object.assign(Object.assign({}, getterParams), { record }));
+    });
+};
+const isRecordNode = (arg) => typeof arg === 'object' && arg !== null && 'uuid' in arg && 'nodeDefUuid' in arg;
+const isString = (arg) => typeof arg === 'string';
 export const getCycle = (record) => { var _a; return (_a = record.cycle) !== null && _a !== void 0 ? _a : defaultCycle; };
 export const getNodes = (record) => { var _a; return (_a = record.nodes) !== null && _a !== void 0 ? _a : {}; };
 export const getNodesArray = (record) => Object.values(getNodes(record));
-export const getNodeByUuid = (uuid) => (record) => { var _a; return (_a = record.nodes) === null || _a === void 0 ? void 0 : _a[uuid]; };
-export const getNodesByUuids = (uuids) => (record) => uuids.map((uuid) => getNodeByUuid(uuid)(record));
+export const getNodeByUuid = positionalRecordGetter({
+    getter: ({ record, uuid }) => { var _a; return (_a = record.nodes) === null || _a === void 0 ? void 0 : _a[uuid]; },
+    isPositional: isString,
+    toParams: (uuid) => ({ uuid }),
+});
+export const getNodesByUuids = positionalRecordGetter({
+    getter: ({ record, uuids }) => uuids.map((uuid) => { var _a; return (_a = record.nodes) === null || _a === void 0 ? void 0 : _a[uuid]; }),
+    isPositional: Array.isArray,
+    toParams: (uuids) => ({ uuids }),
+});
 export const getRoot = (record) => {
     const rootUuid = record._nodesIndex ? RecordNodesIndexReader.getNodeRootUuid(record._nodesIndex) : null;
     if (rootUuid) {
-        return getNodeByUuid(rootUuid)(record);
+        return getNodeByUuid({ uuid: rootUuid })(record);
     }
     return getNodesArray(record).find((node) => !node.parentUuid);
 };
-export const getChildren = (parentNode, childDefUuid) => (record) => {
-    if (record._nodesIndex) {
-        const childrenUuids = childDefUuid
-            ? RecordNodesIndexReader.getNodeUuidsByParentAndChildDef({
-                parentNodeUuid: parentNode.uuid,
-                childDefUuid,
-            })(record._nodesIndex)
-            : RecordNodesIndexReader.getNodeUuidsByParent(parentNode.uuid)(record._nodesIndex);
-        return getNodesByUuids(childrenUuids)(record);
-    }
-    return getNodesArray(record).filter((node) => node.parentUuid === parentNode.uuid && (!childDefUuid || node.nodeDefUuid == childDefUuid));
-};
-export const getChild = (parentNode, childDefUuid) => (record) => {
-    const children = getChildren(parentNode, childDefUuid)(record);
-    const errorParams = { childDefUuid, parentNodeUuid: parentNode.uuid, recordUuid: record.uuid };
-    if (children.length === 1) {
-        return children[0];
-    }
-    if (children.length > 1) {
-        throw new SystemError('systemError.record.multipleNodesFound', errorParams);
-    }
-    throw new SystemError('systemError.record.childNotFound', errorParams);
-};
-export const getParent = (node) => (record) => node.parentUuid ? getNodeByUuid(node.parentUuid)(record) : undefined;
-export const getNodesByDefUuid = (nodeDefUuid) => (record) => {
-    if (record._nodesIndex) {
-        const nodeUuids = RecordNodesIndexReader.getNodeUuidsByDef(nodeDefUuid)(record._nodesIndex);
-        return getNodesByUuids(nodeUuids)(record);
-    }
-    return getNodesArray(record).filter((node) => node.nodeDefUuid === nodeDefUuid);
-};
-const isNodeFlagTrue = (isChildFlagTrue) => (params) => {
+export const getChildren = positionalRecordGetter({
+    getter: ({ record, parentNode, childDefUuid, }) => {
+        if (record._nodesIndex) {
+            const childrenUuids = childDefUuid
+                ? RecordNodesIndexReader.getNodeUuidsByParentAndChildDef({
+                    parentNodeUuid: parentNode.uuid,
+                    childDefUuid,
+                })(record._nodesIndex)
+                : RecordNodesIndexReader.getNodeUuidsByParent(parentNode.uuid)(record._nodesIndex);
+            return getNodesByUuids({ uuids: childrenUuids })(record);
+        }
+        return getNodesArray(record).filter((node) => node.parentUuid === parentNode.uuid && (!childDefUuid || node.nodeDefUuid == childDefUuid));
+    },
+    isPositional: isRecordNode,
+    toParams: (parentNode, childDefUuid) => ({ parentNode, childDefUuid }),
+});
+export const getChild = positionalRecordGetter({
+    getter: ({ record, parentNode, childDefUuid, }) => {
+        const children = getChildren({ parentNode, childDefUuid })(record);
+        const errorParams = { childDefUuid, parentNodeUuid: parentNode.uuid, recordUuid: record.uuid };
+        if (children.length === 1) {
+            return children[0];
+        }
+        if (children.length > 1) {
+            throw new SystemError('systemError.record.multipleNodesFound', errorParams);
+        }
+        throw new SystemError('systemError.record.childNotFound', errorParams);
+    },
+    isPositional: isRecordNode,
+    toParams: (parentNode, childDefUuid) => ({ parentNode, childDefUuid }),
+});
+export const getParent = positionalRecordGetter({
+    getter: ({ record, node }) => node.parentUuid ? getNodeByUuid({ uuid: node.parentUuid })(record) : undefined,
+    isPositional: isRecordNode,
+    toParams: (node) => ({ node }),
+});
+export const getNodesByDefUuid = positionalRecordGetter({
+    getter: ({ record, nodeDefUuid }) => {
+        if (record._nodesIndex) {
+            const nodeUuids = RecordNodesIndexReader.getNodeUuidsByDef(nodeDefUuid)(record._nodesIndex);
+            return getNodesByUuids({ uuids: nodeUuids })(record);
+        }
+        return getNodesArray(record).filter((node) => node.nodeDefUuid === nodeDefUuid);
+    },
+    isPositional: isString,
+    toParams: (nodeDefUuid) => ({ nodeDefUuid }),
+});
+const isNodeFlagTrue = (isChildFlagTrue) => recordGetter((params) => {
     const { record, node } = params;
-    const ancestorsAndSelf = getAncestorsAndSelf({ record, node });
+    const ancestorsAndSelf = getAncestorsAndSelf({ node })(record);
     for (let i = 0; i < ancestorsAndSelf.length - 1; i++) {
         const child = ancestorsAndSelf[i];
         const parent = ancestorsAndSelf[i + 1];
@@ -62,25 +110,29 @@ const isNodeFlagTrue = (isChildFlagTrue) => (params) => {
             return false;
     }
     return true;
-};
+});
 export const isNodeApplicable = isNodeFlagTrue((parent, nodeDefUuid) => Nodes.isChildApplicable(parent, nodeDefUuid));
 export const isNodeEditable = isNodeFlagTrue((parent, nodeDefUuid) => Nodes.isChildEditable(parent, nodeDefUuid));
 export const isNodeVisible = isNodeFlagTrue((parent, nodeDefUuid) => Nodes.isChildVisible(parent, nodeDefUuid));
-export const getDependentCodeAttributes = (node) => (record) => {
-    if (record._nodesIndex) {
-        const nodeUuids = RecordNodesIndexReader.getNodeCodeDependentUuids(node.uuid)(record._nodesIndex);
-        return getNodesByUuids(nodeUuids)(record);
-    }
-    throw new SystemError('record.nodesIndexNotInitialized');
-};
+export const getDependentCodeAttributes = positionalRecordGetter({
+    getter: ({ record, node }) => {
+        if (record._nodesIndex) {
+            const nodeUuids = RecordNodesIndexReader.getNodeCodeDependentUuids(node.uuid)(record._nodesIndex);
+            return getNodesByUuids({ uuids: nodeUuids })(record);
+        }
+        throw new SystemError('record.nodesIndexNotInitialized');
+    },
+    isPositional: isRecordNode,
+    toParams: (node) => ({ node }),
+});
 export const getParentCodeAttribute = (params) => (record) => {
     const { parentNode, nodeDef } = params;
     const parentCodeDefUuid = NodeDefs.getParentCodeDefUuid(nodeDef);
     if (!parentCodeDefUuid)
         return undefined;
-    const ancestors = getAncestorsAndSelf({ record, node: parentNode });
+    const ancestors = getAncestorsAndSelf({ node: parentNode })(record);
     for (const ancestor of ancestors) {
-        const children = getChildren(ancestor, parentCodeDefUuid)(record);
+        const children = getChildren({ parentNode: ancestor, childDefUuid: parentCodeDefUuid })(record);
         if (children.length === 1) {
             return children[0];
         }
@@ -88,47 +140,72 @@ export const getParentCodeAttribute = (params) => (record) => {
     return undefined;
 };
 // ancestors
-export const visitAncestorsAndSelf = (node, visitor, stopIfFn) => (record) => {
-    let currentNode = node;
-    while (currentNode) {
-        visitor(currentNode);
-        if (stopIfFn === null || stopIfFn === void 0 ? void 0 : stopIfFn())
-            break;
-        currentNode = getParent(currentNode)(record);
-    }
-};
-export const findAncestor = (node, predicate) => (record) => {
-    let result = undefined;
-    visitAncestorsAndSelf(node, (visitedNode) => {
-        if (predicate(visitedNode)) {
-            result = visitedNode;
+/**
+ * Visits the specified node and its ancestors, from the node up to the root: the visit stops when the visitor returns true.
+ */
+export const visitAncestorsAndSelf = positionalRecordGetter({
+    getter: ({ record, node, visitor, }) => {
+        let currentNode = node;
+        while (currentNode) {
+            if (visitor(currentNode))
+                return;
+            currentNode = getParent({ node: currentNode })(record);
         }
-    }, () => !!result)(record);
+    },
+    isPositional: isRecordNode,
+    // deprecated form: the visit stops when stopIfFn returns true
+    toParams: (node, visitor, stopIfFn) => ({
+        node,
+        visitor: (visitedNode) => {
+            visitor(visitedNode);
+            return !!(stopIfFn === null || stopIfFn === void 0 ? void 0 : stopIfFn());
+        },
+    }),
+});
+/**
+ * Returns the first node satisfying the predicate among the specified node and its ancestors (from the node up to the root).
+ */
+export const findAncestor = (params) => (record) => {
+    const { node, predicate } = params;
+    let result = undefined;
+    visitAncestorsAndSelf({
+        node,
+        visitor: (visitedNode) => {
+            if (predicate(visitedNode)) {
+                result = visitedNode;
+                return true;
+            }
+            return false;
+        },
+    })(record);
     return result;
 };
-export const getAncestor = (params) => {
+export const getAncestor = recordGetter((params) => {
     const { record, node, ancestorDefUuid } = params;
     if (node.nodeDefUuid === ancestorDefUuid)
         return node;
-    let ancestor = getParent(node)(record);
+    let ancestor = getParent({ node })(record);
     while (ancestor && ancestor.nodeDefUuid !== ancestorDefUuid) {
-        ancestor = getParent(ancestor)(record);
+        ancestor = getParent({ node: ancestor })(record);
     }
     return ancestor;
-};
+});
 /**
  * Returns the list of ancestors from the given node to the root entity
  */
-export const getAncestorsAndSelf = (params) => {
+export const getAncestorsAndSelf = recordGetter((params) => {
     const { record, node } = params;
     const ancestors = [];
-    visitAncestorsAndSelf(node, (currentNode) => {
-        ancestors.push(currentNode);
+    visitAncestorsAndSelf({
+        node,
+        visitor: (currentNode) => {
+            ancestors.push(currentNode);
+        },
     })(record);
     return ancestors;
-};
+});
 // descendants
-export const getDescendantsOrSelf = (params) => {
+export const getDescendantsOrSelf = recordGetter((params) => {
     const { record, node, nodeDefDescendant } = params;
     if (nodeDefDescendant.uuid === node.nodeDefUuid)
         return [node];
@@ -140,22 +217,22 @@ export const getDescendantsOrSelf = (params) => {
     let currentDescendants = [];
     for (const currentDescendantDefUuid of descendantNodeDefUuids) {
         for (const currentAncestor of currentAncestors) {
-            currentDescendants.push(...getChildren(currentAncestor, currentDescendantDefUuid)(record));
+            currentDescendants.push(...getChildren({ parentNode: currentAncestor, childDefUuid: currentDescendantDefUuid })(record));
         }
         currentAncestors = currentDescendants;
         currentDescendants = [];
     }
     return currentAncestors; // currentAncestors is equal to the currentDescendants of the last level
-};
-export const getDescendant = (params) => {
+});
+export const getDescendant = recordGetter((params) => {
     const { record, node, nodeDefDescendant } = params;
-    return getDescendantsOrSelf({ record, node, nodeDefDescendant })[0];
-};
+    return getDescendantsOrSelf({ node, nodeDefDescendant })(record)[0];
+});
 export const isDescendantOf = (params) => {
     const { node, ancestor } = params;
     return Nodes.getHierarchy(node).includes(ancestor.uuid);
 };
-export const visitDescendantsAndSelf = (params) => {
+export const visitDescendantsAndSelf = recordGetter((params) => {
     const { record, node, visitor, traverseMethod = TraverseMethod.bfs } = params;
     if (traverseMethod === TraverseMethod.bfs) {
         const queue = new Queue();
@@ -179,7 +256,7 @@ export const visitDescendantsAndSelf = (params) => {
                 // stop if visitor returns true
                 return;
             }
-            const children = getChildren(visitedNode)(record);
+            const children = getChildren({ parentNode: visitedNode })(record);
             // add children to stack in reverse order
             for (let index = children.length - 1; index >= 0; index--) {
                 const child = children[index];
@@ -187,11 +264,11 @@ export const visitDescendantsAndSelf = (params) => {
             }
         }
     }
-};
-export const findDescendantOrSelf = (node, predicate) => (record) => {
+});
+export const findDescendantOrSelf = (params) => (record) => {
+    const { node, predicate } = params;
     let found = undefined;
     visitDescendantsAndSelf({
-        record,
         node,
         visitor: (currentNode) => {
             if (predicate(currentNode)) {
@@ -200,10 +277,10 @@ export const findDescendantOrSelf = (node, predicate) => (record) => {
             }
             return false;
         },
-    });
+    })(record);
     return found;
 };
-const getClosestAncestorNode = (params) => {
+const getClosestAncestorNode = recordGetter((params) => {
     const { record, node, nodeDef, dependentDef, dependencyType } = params;
     // 1a if dependent def is the same as node def, potentially all nodes with
     // nodeDefUuid === dependentDef.uuid in record could be dependent of nodeDef;
@@ -211,7 +288,7 @@ const getClosestAncestorNode = (params) => {
     // unless the node def references itself only among the children of its parent entity (e.g. validation "dbh > 0")
     if (nodeDef.uuid === dependentDef.uuid) {
         return NodeDefSelfReferences.isSelfReferenceLocal({ nodeDef, dependencyType })
-            ? getParent(node)(record)
+            ? getParent({ node })(record)
             : getRoot(record);
     }
     // 1 find common ancestor def
@@ -219,69 +296,71 @@ const getClosestAncestorNode = (params) => {
     if (!commonAncestorDefUuid)
         return undefined;
     // 2 get ancestor node with common parent def
-    return getAncestor({ record, node, ancestorDefUuid: commonAncestorDefUuid });
-};
-export const getEntityKeyNodesByDefUuid = (params) => {
+    return getAncestor({ node, ancestorDefUuid: commonAncestorDefUuid })(record);
+});
+export const getEntityKeyNodesByDefUuid = recordGetter((params) => {
     const { survey, cycle, record, entity, keyDefs } = params;
     const nodeDef = Surveys.getNodeDefByUuid({ survey, uuid: entity.nodeDefUuid });
     const nodeDefKeys = keyDefs !== null && keyDefs !== void 0 ? keyDefs : Surveys.getNodeDefKeys({ survey, cycle, nodeDef });
     return nodeDefKeys.reduce((acc, nodeDefKey) => {
-        const nodeKey = getDescendant({ record, node: entity, nodeDefDescendant: nodeDefKey });
+        const nodeKey = getDescendant({ node: entity, nodeDefDescendant: nodeDefKey })(record);
         acc[nodeDefKey.uuid] = nodeKey;
         return acc;
     }, {});
-};
-export const getEntityKeyNodes = (params) => Object.values(getEntityKeyNodesByDefUuid(params));
-export const getEntityKeyValuesByDefUuid = (params) => {
-    const keyNodesByDefUuid = getEntityKeyNodesByDefUuid(params);
+});
+export const getEntityKeyNodes = recordGetter((_a) => {
+    var { record } = _a, otherParams = __rest(_a, ["record"]);
+    return Object.values(getEntityKeyNodesByDefUuid(otherParams)(record));
+});
+export const getEntityKeyValuesByDefUuid = recordGetter((params) => {
+    const { record } = params, otherParams = __rest(params, ["record"]);
+    const keyNodesByDefUuid = getEntityKeyNodesByDefUuid(otherParams)(record);
     return Object.entries(keyNodesByDefUuid).reduce((acc, [uuid, keyNode]) => {
         acc[uuid] = keyNode === null || keyNode === void 0 ? void 0 : keyNode.value;
         return acc;
     }, {});
-};
-export const getEntityKeyValues = (params) => Object.values(getEntityKeyValuesByDefUuid(params));
-export const getEntitySiblings = (params) => {
+});
+export const getEntityKeyValues = recordGetter((_a) => {
+    var { record } = _a, otherParams = __rest(_a, ["record"]);
+    return Object.values(getEntityKeyValuesByDefUuid(otherParams)(record));
+});
+export const getEntitySiblings = recordGetter((params) => {
     const { record, entity, includeSelf = false } = params;
-    const parentEntity = getParent(entity)(record);
+    const parentEntity = getParent({ node: entity })(record);
     if (!parentEntity)
         return [];
-    const siblingEntities = getChildren(parentEntity, entity.nodeDefUuid)(record);
+    const siblingEntities = getChildren({ parentNode: parentEntity, childDefUuid: entity.nodeDefUuid })(record);
     return includeSelf ? siblingEntities : siblingEntities.filter((sibling) => !Nodes.areEqual(sibling, entity));
-};
-export const getAttributeSiblings = (params) => {
+});
+export const getAttributeSiblings = recordGetter((params) => {
     const { record, node, nodeDef } = params;
-    const parentEntity = getParent(node)(record);
+    const parentEntity = getParent({ node })(record);
     if (!parentEntity)
         return [];
-    const siblingParentEntities = getEntitySiblings({ record, entity: parentEntity });
+    const siblingParentEntities = getEntitySiblings({ entity: parentEntity })(record);
     return siblingParentEntities.reduce((siblingsAcc, siblingEntity) => {
-        siblingsAcc.push(...getChildren(siblingEntity, nodeDef.uuid)(record));
+        siblingsAcc.push(...getChildren({ parentNode: siblingEntity, childDefUuid: nodeDef.uuid })(record));
         return siblingsAcc;
     }, []);
-};
-export const getNodeIndex = (params) => {
+});
+export const getNodeIndex = recordGetter((params) => {
     const { record, node } = params;
-    const parentEntity = getParent(node)(record);
+    const parentEntity = getParent({ node })(record);
     if (!parentEntity)
         return 0; // root entity
-    const siblings = getChildren(parentEntity, node.nodeDefUuid)(record);
+    const siblings = getChildren({ parentNode: parentEntity, childDefUuid: node.nodeDefUuid })(record);
     return siblings.indexOf(node);
-};
-export const findEntityByKeyValues = (params) => {
+});
+export const findEntityByKeyValues = recordGetter((params) => {
     const { survey, cycle, record, parentEntity, entityDefUuid, keyValuesByDefUuid } = params;
     const entityDef = Surveys.getNodeDefByUuid({ survey, uuid: entityDefUuid });
-    const siblingEntities = getChildren(parentEntity, entityDefUuid)(record);
+    const siblingEntities = getChildren({ parentNode: parentEntity, childDefUuid: entityDefUuid })(record);
     if (NodeDefs.isSingle(entityDef)) {
         return siblingEntities[0];
     }
     const keyDefs = Surveys.getNodeDefKeys({ survey, cycle, nodeDef: entityDef });
     return siblingEntities.find((siblingEntity) => {
-        const siblingEntityKeyValuesByDefUuid = getEntityKeyValuesByDefUuid({
-            survey,
-            record,
-            entity: siblingEntity,
-            keyDefs,
-        });
+        const siblingEntityKeyValuesByDefUuid = getEntityKeyValuesByDefUuid({ survey, entity: siblingEntity, keyDefs })(record);
         return keyDefs.every((keyDef) => {
             const keyValue = siblingEntityKeyValuesByDefUuid[keyDef.uuid];
             const keyValueSearch = keyValuesByDefUuid[keyDef.uuid];
@@ -293,26 +372,19 @@ export const findEntityByKeyValues = (params) => {
             });
         });
     });
-};
-export const findEntityWithSameKeysInAnotherRecord = (params) => {
+});
+export const findEntityWithSameKeysInAnotherRecord = recordGetter((params) => {
     const { survey, cycle, entityUuid, record, recordOther } = params;
-    const entity = getNodeByUuid(entityUuid)(record);
+    const entity = getNodeByUuid({ uuid: entityUuid })(record);
     if (!entity)
         return undefined;
     let otherRecordCurrentParentEntity = getRoot(recordOther);
     if (!otherRecordCurrentParentEntity)
         return undefined;
-    const entityAncestorsAndSelf = getAncestorsAndSelf({
-        record,
-        node: entity,
-    });
+    const entityAncestorsAndSelf = getAncestorsAndSelf({ node: entity })(record);
     const ancestorDefUuidsAndKeys = entityAncestorsAndSelf.map((ancestor) => ({
         entityDefUuid: ancestor.nodeDefUuid,
-        keyValuesByDefUuid: getEntityKeyValuesByDefUuid({
-            survey,
-            record,
-            entity: ancestor,
-        }),
+        keyValuesByDefUuid: getEntityKeyValuesByDefUuid({ survey, entity: ancestor })(record),
     }));
     const ancestorDefUuidsAndKeysToVisit = [...ancestorDefUuidsAndKeys].reverse();
     for (let index = 1; otherRecordCurrentParentEntity && index < ancestorDefUuidsAndKeysToVisit.length; index++) {
@@ -320,15 +392,14 @@ export const findEntityWithSameKeysInAnotherRecord = (params) => {
         otherRecordCurrentParentEntity = findEntityByKeyValues({
             survey,
             cycle,
-            record: recordOther,
             parentEntity: otherRecordCurrentParentEntity,
             entityDefUuid,
             keyValuesByDefUuid,
-        });
+        })(recordOther);
     }
     return otherRecordCurrentParentEntity;
-};
-export const getDependentNodePointers = (params) => {
+});
+export const getDependentNodePointers = recordGetter((params) => {
     const { survey, record, node, dependencyType, includeSelf = false, filterFn = null } = params;
     const nodeDefUuid = node.nodeDefUuid;
     const nodeDef = Surveys.getNodeDefByUuid({ survey, uuid: nodeDefUuid });
@@ -341,7 +412,7 @@ export const getDependentNodePointers = (params) => {
     };
     for (const dependentDef of dependentDefs) {
         // 1 find common ancestor node
-        const commonAncestorNode = getClosestAncestorNode({ record, node, nodeDef, dependentDef, dependencyType });
+        const commonAncestorNode = getClosestAncestorNode({ node, nodeDef, dependentDef, dependencyType })(record);
         if (!commonAncestorNode)
             continue;
         const nodeDefDependentParent = Surveys.getNodeDefParent({ survey, nodeDef: dependentDef });
@@ -349,10 +420,9 @@ export const getDependentNodePointers = (params) => {
             throw new SystemError('record.nodes.dependents.dependencyOnRootFound');
         // 2 find descendant nodes of common parent node with nodeDefUuid = dependentDef uuid
         const dependentContextNodes = getDescendantsOrSelf({
-            record,
             node: commonAncestorNode,
             nodeDefDescendant: nodeDefDependentParent,
-        });
+        })(record);
         for (const dependentContextNode of dependentContextNodes) {
             addToNodePointers({
                 nodeCtx: dependentContextNode,
@@ -361,7 +431,7 @@ export const getDependentNodePointers = (params) => {
         }
     }
     if (includeSelf) {
-        const parentNode = getParent(node)(record);
+        const parentNode = getParent({ node })(record);
         if (parentNode) {
             addToNodePointers({
                 nodeCtx: parentNode,
@@ -370,8 +440,8 @@ export const getDependentNodePointers = (params) => {
         }
     }
     return nodePointers;
-};
-export const getAncestorCodePath = (params) => {
+});
+export const getAncestorCodePath = recordGetter((params) => {
     const { record, parentNode, nodeDef, survey } = params;
     const getCodeAttributeItemCode = (codeAttribute) => {
         var _a;
@@ -393,19 +463,27 @@ export const getAncestorCodePath = (params) => {
         currentParentCodeAttribute = getParentCodeAttribute({ parentNode, nodeDef: ancestorCodeDef })(record);
     }
     return codePaths;
-};
-export const getCategoryItemUuid = (params) => {
+});
+export const getCategoryItemUuid = recordGetter((params) => {
     const { survey, nodeDef, record, parentNode, code } = params;
     const categoryUuid = nodeDef.props.categoryUuid;
-    const codePaths = [...getAncestorCodePath({ survey, record, parentNode, nodeDef }), code];
+    const codePaths = [...getAncestorCodePath({ survey, parentNode, nodeDef })(record), code];
     const item = Surveys.getCategoryItemByCodePaths({ survey, categoryUuid, codePaths });
     return item === null || item === void 0 ? void 0 : item.uuid;
-};
-export const isNodeFilledByUser = (node) => (record) => !!findDescendantOrSelf(node, (visitedNode) => Nodes.hasUserInputValue(visitedNode))(record);
-export const isNodeEmpty = (node) => (record) => !isNodeFilledByUser(node)(record);
+});
+export const isNodeFilledByUser = positionalRecordGetter({
+    getter: ({ record, node }) => !!findDescendantOrSelf({ node, predicate: (visitedNode) => Nodes.hasUserInputValue(visitedNode) })(record),
+    isPositional: isRecordNode,
+    toParams: (node) => ({ node }),
+});
+export const isNodeEmpty = positionalRecordGetter({
+    getter: ({ record, node }) => !isNodeFilledByUser({ node })(record),
+    isPositional: isRecordNode,
+    toParams: (node) => ({ node }),
+});
 export const isEmpty = (record) => {
     const rootNode = getRoot(record);
-    return rootNode ? isNodeEmpty(rootNode)(record) : true;
+    return rootNode ? isNodeEmpty({ node: rootNode })(record) : true;
 };
 export const getStep = (record) => { var _a; return (_a = record.step) !== null && _a !== void 0 ? _a : RECORD_STEP_DEFAULT; };
 export const isInAnalysisStep = (record) => getStep(record) === RecordStepAnalysisCode;