@openframe-org/criteria-set-protocol 2.7.10 → 2.7.12

package/dist/v1/utils.d.ts

@@ -1,4 +1,4 @@
-import { Color, CriteriaTree, CriteriaTreeElement, Theme, Criterion, Task, TaskGroup, TaskItem, CertificationDefinition, TaskItemValueReference, TaskItemData, ElementData, TreeResult, CriteriaTreeElementType } from "./types";
+import { Color, CriteriaTree, CriteriaTreeElement, Theme, Criterion, Task, TaskGroup, TaskItem, CertificationDefinition, TaskItemValueReference, TaskItemData, ElementData, TreeResult, CriteriaTreeElementType, TaskItemDefinition } from "./types";
 interface ApplyBreadcrumbTextFormattingPlaceholdersFunction {
     (options: {
         breadcrumbTextFormat: string | undefined;
@@ -73,7 +73,7 @@ export declare const isNil: (value: unknown) => value is null | undefined;
 /**
  * Given a list of certification definitions, return the ones for which the given value is valid
  */
-export declare const getCertificationsByValue: (certificationDefinitions: CertificationDefinition[], value?: TaskItemValueReference) => CertificationDefinition[] | undefined;
+export declare const getCertificationsByValue: (certificationDefinitions: CertificationDefinition[], value?: number | boolean | null) => CertificationDefinition[] | undefined;
 /**
  * Given a tree element or a data object, validate that it contains valid data. If it is a tree element,
  * extract the data object from it and validate it:
@@ -86,4 +86,5 @@ export declare const getCertificationsByValue: (certificationDefinitions: Certif
 export declare function validateData(data: TaskItemData | ElementData | TreeResult, dataType: Exclude<CriteriaTreeElementType, "task-group" | "task-item">): data is ElementData;
 export declare function validateData(data: TaskItemData | ElementData | TreeResult, dataType: Extract<CriteriaTreeElementType, "task-item">): data is TaskItemData;
 export declare function validateData(data: TaskItemData | ElementData | TreeResult, dataType: "tree-result"): data is TreeResult;
+export declare const resolveTaskItemValue: (taskItemDefinition: TaskItemDefinition, valueReference: TaskItemValueReference) => number | boolean | null;
 export {};

package/dist/v1/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCertificationsByValue = exports.isNil = exports.applyReportTitleTextFormatFormattingPlaceholders = exports.applyCriteriaTreeElementTextFormatFormattingPlaceholders = exports.applyDocumentTreeFolderTextFormattingPlaceholders = exports.applyBreadcrumbTextFormattingPlaceholders = exports.findInTree = exports.toColorHexString = exports.isTaskItem = exports.isTask = exports.isTaskGroup = exports.isCriterion = exports.isTheme = void 0;
+exports.resolveTaskItemValue = exports.getCertificationsByValue = exports.isNil = exports.applyReportTitleTextFormatFormattingPlaceholders = exports.applyCriteriaTreeElementTextFormatFormattingPlaceholders = exports.applyDocumentTreeFolderTextFormattingPlaceholders = exports.applyBreadcrumbTextFormattingPlaceholders = exports.findInTree = exports.toColorHexString = exports.isTaskItem = exports.isTask = exports.isTaskGroup = exports.isCriterion = exports.isTheme = void 0;
 exports.validateData = validateData;
 const isTheme = (element) => element.type === "theme";
 exports.isTheme = isTheme;
@@ -46,14 +46,14 @@ exports.findInTree = findInTree;
 /**
  * Apply the text formatting used in document tree folder naming
  */
-const applyBreadcrumbTextFormattingPlaceholders = ({ breadcrumbTextFormat = ':code:' }, { title, code }) => breadcrumbTextFormat
+const applyBreadcrumbTextFormattingPlaceholders = ({ breadcrumbTextFormat = ":code:" }, { title, code }) => breadcrumbTextFormat
     .replace(/:code:/g, code)
     .replace(/:title:/g, title);
 exports.applyBreadcrumbTextFormattingPlaceholders = applyBreadcrumbTextFormattingPlaceholders;
 /**
  * Apply the text formatting used in the document tree
  */
-const applyDocumentTreeFolderTextFormattingPlaceholders = ({ documentTreeFolderTextFormat = ':code:' }, { title, code }) => documentTreeFolderTextFormat
+const applyDocumentTreeFolderTextFormattingPlaceholders = ({ documentTreeFolderTextFormat = ":code:" }, { title, code }) => documentTreeFolderTextFormat
     .replace(/:code:/g, code)
     .replace(/:title:/g, title);
 exports.applyDocumentTreeFolderTextFormattingPlaceholders = applyDocumentTreeFolderTextFormattingPlaceholders;
@@ -67,7 +67,7 @@ exports.applyCriteriaTreeElementTextFormatFormattingPlaceholders = applyCriteria
 /**
  * Apply the text formatting used in the report title
  */
-const applyReportTitleTextFormatFormattingPlaceholders = ({ reportTitleTextFormat = ':title:' }, { title, code }) => reportTitleTextFormat
+const applyReportTitleTextFormatFormattingPlaceholders = ({ reportTitleTextFormat = ":title:" }, { title, code }) => reportTitleTextFormat
     .replace(/:code:/g, code)
     .replace(/:title:/g, title);
 exports.applyReportTitleTextFormatFormattingPlaceholders = applyReportTitleTextFormatFormattingPlaceholders;
@@ -127,10 +127,54 @@ function validateData(data, dataType) {
         default:
             throw new Error(`Data has an invalid 'type' property: ${data.type}`);
     }
-    if (dataType === 'task-item') {
+    if (dataType === "task-item") {
         if (!("readOnly" in data)) {
             throw new Error("Data is missing 'readOnly' property");
         }
     }
     return true;
 }
+const resolveTaskItemValue = (taskItemDefinition, valueReference) => {
+    const toFiniteNumberOrNull = (rawValue) => {
+        if ((0, exports.isNil)(rawValue)) {
+            return null;
+        }
+        const numericValue = Number(rawValue);
+        return Number.isFinite(numericValue) ? numericValue : null;
+    };
+    const resolveSingleOptionValue = (optionOrValueReference) => {
+        var _a, _b;
+        if (taskItemDefinition.type !== "select-single" && taskItemDefinition.type !== "select-multiple") {
+            return null;
+        }
+        if (typeof optionOrValueReference === "number") {
+            return optionOrValueReference;
+        }
+        const foundValue = (_b = (_a = taskItemDefinition.options.find((option) => option.id === optionOrValueReference)) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : null;
+        return toFiniteNumberOrNull(foundValue);
+    };
+    switch (taskItemDefinition.type) {
+        case "number":
+            return toFiniteNumberOrNull(valueReference);
+        case "boolean":
+            return valueReference === "true" || valueReference === "1" || valueReference === true || valueReference === 1;
+        case "select-single": {
+            return resolveSingleOptionValue(valueReference);
+        }
+        case "select-multiple": {
+            const optionIds = Array.isArray(valueReference) ? valueReference : [valueReference];
+            let resolvedValue = null;
+            for (const optionId of optionIds) {
+                const resolvedOptionValue = resolveSingleOptionValue(optionId);
+                if (!(0, exports.isNil)(resolvedOptionValue)) {
+                    resolvedValue !== null && resolvedValue !== void 0 ? resolvedValue : (resolvedValue = 0);
+                    resolvedValue += resolvedOptionValue;
+                }
+            }
+            return resolvedValue;
+        }
+        default:
+            throw new Error(`Unsupported task item type: ${taskItemDefinition.type}`);
+    }
+};
+exports.resolveTaskItemValue = resolveTaskItemValue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openframe-org/criteria-set-protocol",
-  "version": "2.7.10",
+  "version": "2.7.12",
   "description": "A protocol and tools for defining and working with criteria sets",
   "private": false,
   "author": "Andrés Angulo <aa@openframe.org>",